From f9db4bb249d151b4681379911989b67590d1f43a Mon Sep 17 00:00:00 2001
From: KevinOConnor <KevinOConnor@users.noreply.github.com>
Date: Tue, 7 Feb 2023 00:38:08 +0000
Subject: [PATCH] =?UTF-8?q?Deploying=20to=20gh-pages=20from=20@=20Klipper3?=
 =?UTF-8?q?d/klipper@5644481590a16ac5b3d8c20874f0477d5d51a963=20?=
 =?UTF-8?q?=F0=9F=9A=80?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../__pycache__/mkdocs_hooks.cpython-38.pyc   | Bin 983 -> 983 bytes
 fr/404.html                                   |   8 +-
 fr/API_Server.html                            |   8 +-
 fr/BLTouch.html                               |   8 +-
 fr/Beaglebone.html                            |   8 +-
 fr/Bed_Level.html                             |   8 +-
 fr/Bed_Mesh.html                              |   8 +-
 fr/Benchmarks.html                            |   8 +-
 fr/Bootloaders.html                           |   8 +-
 fr/CANBUS.html                                |   8 +-
 fr/CANBUS_protocol.html                       |   8 +-
 fr/CONTRIBUTING.html                          |   8 +-
 fr/Code_Overview.html                         |   8 +-
 fr/Command_Templates.html                     |   8 +-
 fr/Config_Changes.html                        |   8 +-
 fr/Config_Reference.html                      |   8 +-
 fr/Config_checks.html                         |   8 +-
 fr/Contact.html                               |   8 +-
 fr/Debugging.html                             |   8 +-
 fr/Delta_Calibrate.html                       |   8 +-
 fr/Endstop_Phase.html                         |  12 +--
 fr/Example_Configs.html                       |   8 +-
 fr/Exclude_Object.html                        |   8 +-
 fr/FAQ.html                                   |   8 +-
 fr/Features.html                              |   8 +-
 fr/G-Codes.html                               |   8 +-
 fr/Hall_Filament_Width_Sensor.html            |   8 +-
 fr/Installation.html                          |   8 +-
 fr/Kinematics.html                            |   8 +-
 fr/MCU_Commands.html                          |   8 +-
 fr/Manual_Level.html                          |   8 +-
 fr/Measuring_Resonances.html                  |  12 +--
 fr/Multi_MCU_Homing.html                      |   8 +-
 fr/Navigation.html                            |  10 +-
 fr/Overview.html                              |   8 +-
 fr/Packaging.html                             |   8 +-
 fr/Pressure_Advance.html                      |   8 +-
 fr/Probe_Calibrate.html                       |   8 +-
 fr/Protocol.html                              |   8 +-
 fr/RPi_microcontroller.html                   |   8 +-
 fr/Releases.html                              |   8 +-
 fr/Resonance_Compensation.html                |  92 ++++++++--------
 fr/Rotation_Distance.html                     |   8 +-
 fr/SDCard_Updates.html                        |   8 +-
 fr/Skew_Correction.html                       |   8 +-
 fr/Slicers.html                               |   8 +-
 fr/Sponsors.html                              |   8 +-
 fr/Status_Reference.html                      |   8 +-
 fr/TMC_Drivers.html                           |   8 +-
 fr/TSL1401CL_Filament_Width_Sensor.html       |   8 +-
 fr/Using_PWM_Tools.html                       |   8 +-
 .../__pycache__/mkdocs_hooks.cpython-38.pyc   | Bin 983 -> 983 bytes
 fr/_klipper3d/mkdocs-lang-fr.yml              |   2 +-
 fr/index.html                                 |   8 +-
 fr/search/search_index.json                   |   2 +-
 fr/sitemap.xml                                | 100 +++++++++---------
 fr/sitemap.xml.gz                             | Bin 226 -> 226 bytes
 .../__pycache__/mkdocs_hooks.cpython-38.pyc   | Bin 983 -> 983 bytes
 hu/sitemap.xml                                | 100 +++++++++---------
 hu/sitemap.xml.gz                             | Bin 226 -> 226 bytes
 it/Bed_Mesh.html                              |  14 +--
 it/Config_Changes.html                        |   6 +-
 it/G-Codes.html                               |   4 +-
 .../__pycache__/mkdocs_hooks.cpython-38.pyc   | Bin 983 -> 983 bytes
 it/search/search_index.json                   |   2 +-
 it/sitemap.xml                                | 100 +++++++++---------
 it/sitemap.xml.gz                             | Bin 226 -> 226 bytes
 sitemap.xml                                   |  98 ++++++++---------
 sitemap.xml.gz                                | Bin 225 -> 225 bytes
 .../__pycache__/mkdocs_hooks.cpython-38.pyc   | Bin 983 -> 983 bytes
 zh-Hant/sitemap.xml                           | 100 +++++++++---------
 zh-Hant/sitemap.xml.gz                        | Bin 226 -> 226 bytes
 .../__pycache__/mkdocs_hooks.cpython-38.pyc   | Bin 983 -> 983 bytes
 zh/sitemap.xml                                | 100 +++++++++---------
 zh/sitemap.xml.gz                             | Bin 226 -> 226 bytes
 75 files changed, 565 insertions(+), 565 deletions(-)

diff --git a/_klipper3d/__pycache__/mkdocs_hooks.cpython-38.pyc b/_klipper3d/__pycache__/mkdocs_hooks.cpython-38.pyc
index 5da67cbb5f7b316a897b1f45ea74add26d185cdc..406a5b31d8ec56dfda96532a8fe45345f0518786 100644
GIT binary patch
delta 20
acmcc4ex02=l$V!_0SH3pKHSKCh8X}iVg;W7

delta 20
acmcc4ex02=l$V!_0SIn6KiJ59h8X}j<ORt9

diff --git a/fr/404.html b/fr/404.html
index 8599834a7..50e83c631 100644
--- a/fr/404.html
+++ b/fr/404.html
@@ -633,14 +633,14 @@
       
       
         <label class="md-nav__link" for="__nav_7_5">
-          Compensation de résonance
+          Compensation de la résonance
           <span class="md-nav__icon md-icon"></span>
         </label>
       
-      <nav class="md-nav" aria-label="Compensation de résonance" data-md-level="2">
+      <nav class="md-nav" aria-label="Compensation de la résonance" data-md-level="2">
         <label class="md-nav__title" for="__nav_7_5">
           <span class="md-nav__icon md-icon"></span>
-          Compensation de résonance
+          Compensation de la résonance
         </label>
         <ul class="md-nav__list" data-md-scrollfix>
           
@@ -651,7 +651,7 @@
   
     <li class="md-nav__item">
       <a href="/Resonance_Compensation.html" class="md-nav__link">
-        Compensation de résonance
+        Compensation de la résonance
       </a>
     </li>
   
diff --git a/fr/API_Server.html b/fr/API_Server.html
index b843a8e21..f34133e88 100644
--- a/fr/API_Server.html
+++ b/fr/API_Server.html
@@ -638,14 +638,14 @@
       
       
         <label class="md-nav__link" for="__nav_7_5">
-          Compensation de résonance
+          Compensation de la résonance
           <span class="md-nav__icon md-icon"></span>
         </label>
       
-      <nav class="md-nav" aria-label="Compensation de résonance" data-md-level="2">
+      <nav class="md-nav" aria-label="Compensation de la résonance" data-md-level="2">
         <label class="md-nav__title" for="__nav_7_5">
           <span class="md-nav__icon md-icon"></span>
-          Compensation de résonance
+          Compensation de la résonance
         </label>
         <ul class="md-nav__list" data-md-scrollfix>
           
@@ -656,7 +656,7 @@
   
     <li class="md-nav__item">
       <a href="Resonance_Compensation.html" class="md-nav__link">
-        Compensation de résonance
+        Compensation de la résonance
       </a>
     </li>
   
diff --git a/fr/BLTouch.html b/fr/BLTouch.html
index 0d734e42c..2c62e55aa 100644
--- a/fr/BLTouch.html
+++ b/fr/BLTouch.html
@@ -732,14 +732,14 @@
       
       
         <label class="md-nav__link" for="__nav_7_5">
-          Compensation de résonance
+          Compensation de la résonance
           <span class="md-nav__icon md-icon"></span>
         </label>
       
-      <nav class="md-nav" aria-label="Compensation de résonance" data-md-level="2">
+      <nav class="md-nav" aria-label="Compensation de la résonance" data-md-level="2">
         <label class="md-nav__title" for="__nav_7_5">
           <span class="md-nav__icon md-icon"></span>
-          Compensation de résonance
+          Compensation de la résonance
         </label>
         <ul class="md-nav__list" data-md-scrollfix>
           
@@ -750,7 +750,7 @@
   
     <li class="md-nav__item">
       <a href="Resonance_Compensation.html" class="md-nav__link">
-        Compensation de résonance
+        Compensation de la résonance
       </a>
     </li>
   
diff --git a/fr/Beaglebone.html b/fr/Beaglebone.html
index 4c8a79045..0c1463117 100644
--- a/fr/Beaglebone.html
+++ b/fr/Beaglebone.html
@@ -638,14 +638,14 @@
       
       
         <label class="md-nav__link" for="__nav_7_5">
-          Compensation de résonance
+          Compensation de la résonance
           <span class="md-nav__icon md-icon"></span>
         </label>
       
-      <nav class="md-nav" aria-label="Compensation de résonance" data-md-level="2">
+      <nav class="md-nav" aria-label="Compensation de la résonance" data-md-level="2">
         <label class="md-nav__title" for="__nav_7_5">
           <span class="md-nav__icon md-icon"></span>
-          Compensation de résonance
+          Compensation de la résonance
         </label>
         <ul class="md-nav__list" data-md-scrollfix>
           
@@ -656,7 +656,7 @@
   
     <li class="md-nav__item">
       <a href="Resonance_Compensation.html" class="md-nav__link">
-        Compensation de résonance
+        Compensation de la résonance
       </a>
     </li>
   
diff --git a/fr/Bed_Level.html b/fr/Bed_Level.html
index ffa9fbdd0..0a02b5b7d 100644
--- a/fr/Bed_Level.html
+++ b/fr/Bed_Level.html
@@ -697,14 +697,14 @@
       
       
         <label class="md-nav__link" for="__nav_7_5">
-          Compensation de résonance
+          Compensation de la résonance
           <span class="md-nav__icon md-icon"></span>
         </label>
       
-      <nav class="md-nav" aria-label="Compensation de résonance" data-md-level="2">
+      <nav class="md-nav" aria-label="Compensation de la résonance" data-md-level="2">
         <label class="md-nav__title" for="__nav_7_5">
           <span class="md-nav__icon md-icon"></span>
-          Compensation de résonance
+          Compensation de la résonance
         </label>
         <ul class="md-nav__list" data-md-scrollfix>
           
@@ -715,7 +715,7 @@
   
     <li class="md-nav__item">
       <a href="Resonance_Compensation.html" class="md-nav__link">
-        Compensation de résonance
+        Compensation de la résonance
       </a>
     </li>
   
diff --git a/fr/Bed_Mesh.html b/fr/Bed_Mesh.html
index c771b7d58..c8a8fb207 100644
--- a/fr/Bed_Mesh.html
+++ b/fr/Bed_Mesh.html
@@ -812,14 +812,14 @@
       
       
         <label class="md-nav__link" for="__nav_7_5">
-          Compensation de résonance
+          Compensation de la résonance
           <span class="md-nav__icon md-icon"></span>
         </label>
       
-      <nav class="md-nav" aria-label="Compensation de résonance" data-md-level="2">
+      <nav class="md-nav" aria-label="Compensation de la résonance" data-md-level="2">
         <label class="md-nav__title" for="__nav_7_5">
           <span class="md-nav__icon md-icon"></span>
-          Compensation de résonance
+          Compensation de la résonance
         </label>
         <ul class="md-nav__list" data-md-scrollfix>
           
@@ -830,7 +830,7 @@
   
     <li class="md-nav__item">
       <a href="Resonance_Compensation.html" class="md-nav__link">
-        Compensation de résonance
+        Compensation de la résonance
       </a>
     </li>
   
diff --git a/fr/Benchmarks.html b/fr/Benchmarks.html
index da5f8d17e..19632b6b2 100644
--- a/fr/Benchmarks.html
+++ b/fr/Benchmarks.html
@@ -638,14 +638,14 @@
       
       
         <label class="md-nav__link" for="__nav_7_5">
-          Compensation de résonance
+          Compensation de la résonance
           <span class="md-nav__icon md-icon"></span>
         </label>
       
-      <nav class="md-nav" aria-label="Compensation de résonance" data-md-level="2">
+      <nav class="md-nav" aria-label="Compensation de la résonance" data-md-level="2">
         <label class="md-nav__title" for="__nav_7_5">
           <span class="md-nav__icon md-icon"></span>
-          Compensation de résonance
+          Compensation de la résonance
         </label>
         <ul class="md-nav__list" data-md-scrollfix>
           
@@ -656,7 +656,7 @@
   
     <li class="md-nav__item">
       <a href="Resonance_Compensation.html" class="md-nav__link">
-        Compensation de résonance
+        Compensation de la résonance
       </a>
     </li>
   
diff --git a/fr/Bootloaders.html b/fr/Bootloaders.html
index decd3376d..9c5df4bc5 100644
--- a/fr/Bootloaders.html
+++ b/fr/Bootloaders.html
@@ -638,14 +638,14 @@
       
       
         <label class="md-nav__link" for="__nav_7_5">
-          Compensation de résonance
+          Compensation de la résonance
           <span class="md-nav__icon md-icon"></span>
         </label>
       
-      <nav class="md-nav" aria-label="Compensation de résonance" data-md-level="2">
+      <nav class="md-nav" aria-label="Compensation de la résonance" data-md-level="2">
         <label class="md-nav__title" for="__nav_7_5">
           <span class="md-nav__icon md-icon"></span>
-          Compensation de résonance
+          Compensation de la résonance
         </label>
         <ul class="md-nav__list" data-md-scrollfix>
           
@@ -656,7 +656,7 @@
   
     <li class="md-nav__item">
       <a href="Resonance_Compensation.html" class="md-nav__link">
-        Compensation de résonance
+        Compensation de la résonance
       </a>
     </li>
   
diff --git a/fr/CANBUS.html b/fr/CANBUS.html
index 1efee47b7..494cf0f08 100644
--- a/fr/CANBUS.html
+++ b/fr/CANBUS.html
@@ -638,14 +638,14 @@
       
       
         <label class="md-nav__link" for="__nav_7_5">
-          Compensation de résonance
+          Compensation de la résonance
           <span class="md-nav__icon md-icon"></span>
         </label>
       
-      <nav class="md-nav" aria-label="Compensation de résonance" data-md-level="2">
+      <nav class="md-nav" aria-label="Compensation de la résonance" data-md-level="2">
         <label class="md-nav__title" for="__nav_7_5">
           <span class="md-nav__icon md-icon"></span>
-          Compensation de résonance
+          Compensation de la résonance
         </label>
         <ul class="md-nav__list" data-md-scrollfix>
           
@@ -656,7 +656,7 @@
   
     <li class="md-nav__item">
       <a href="Resonance_Compensation.html" class="md-nav__link">
-        Compensation de résonance
+        Compensation de la résonance
       </a>
     </li>
   
diff --git a/fr/CANBUS_protocol.html b/fr/CANBUS_protocol.html
index 182ce2894..00f58e941 100644
--- a/fr/CANBUS_protocol.html
+++ b/fr/CANBUS_protocol.html
@@ -638,14 +638,14 @@
       
       
         <label class="md-nav__link" for="__nav_7_5">
-          Compensation de résonance
+          Compensation de la résonance
           <span class="md-nav__icon md-icon"></span>
         </label>
       
-      <nav class="md-nav" aria-label="Compensation de résonance" data-md-level="2">
+      <nav class="md-nav" aria-label="Compensation de la résonance" data-md-level="2">
         <label class="md-nav__title" for="__nav_7_5">
           <span class="md-nav__icon md-icon"></span>
-          Compensation de résonance
+          Compensation de la résonance
         </label>
         <ul class="md-nav__list" data-md-scrollfix>
           
@@ -656,7 +656,7 @@
   
     <li class="md-nav__item">
       <a href="Resonance_Compensation.html" class="md-nav__link">
-        Compensation de résonance
+        Compensation de la résonance
       </a>
     </li>
   
diff --git a/fr/CONTRIBUTING.html b/fr/CONTRIBUTING.html
index 03a4d2eb4..a359d5315 100644
--- a/fr/CONTRIBUTING.html
+++ b/fr/CONTRIBUTING.html
@@ -638,14 +638,14 @@
       
       
         <label class="md-nav__link" for="__nav_7_5">
-          Compensation de résonance
+          Compensation de la résonance
           <span class="md-nav__icon md-icon"></span>
         </label>
       
-      <nav class="md-nav" aria-label="Compensation de résonance" data-md-level="2">
+      <nav class="md-nav" aria-label="Compensation de la résonance" data-md-level="2">
         <label class="md-nav__title" for="__nav_7_5">
           <span class="md-nav__icon md-icon"></span>
-          Compensation de résonance
+          Compensation de la résonance
         </label>
         <ul class="md-nav__list" data-md-scrollfix>
           
@@ -656,7 +656,7 @@
   
     <li class="md-nav__item">
       <a href="Resonance_Compensation.html" class="md-nav__link">
-        Compensation de résonance
+        Compensation de la résonance
       </a>
     </li>
   
diff --git a/fr/Code_Overview.html b/fr/Code_Overview.html
index be2604a43..dff782dc9 100644
--- a/fr/Code_Overview.html
+++ b/fr/Code_Overview.html
@@ -638,14 +638,14 @@
       
       
         <label class="md-nav__link" for="__nav_7_5">
-          Compensation de résonance
+          Compensation de la résonance
           <span class="md-nav__icon md-icon"></span>
         </label>
       
-      <nav class="md-nav" aria-label="Compensation de résonance" data-md-level="2">
+      <nav class="md-nav" aria-label="Compensation de la résonance" data-md-level="2">
         <label class="md-nav__title" for="__nav_7_5">
           <span class="md-nav__icon md-icon"></span>
-          Compensation de résonance
+          Compensation de la résonance
         </label>
         <ul class="md-nav__list" data-md-scrollfix>
           
@@ -656,7 +656,7 @@
   
     <li class="md-nav__item">
       <a href="Resonance_Compensation.html" class="md-nav__link">
-        Compensation de résonance
+        Compensation de la résonance
       </a>
     </li>
   
diff --git a/fr/Command_Templates.html b/fr/Command_Templates.html
index 93454eb82..d16009935 100644
--- a/fr/Command_Templates.html
+++ b/fr/Command_Templates.html
@@ -640,14 +640,14 @@
       
       
         <label class="md-nav__link" for="__nav_7_5">
-          Compensation de résonance
+          Compensation de la résonance
           <span class="md-nav__icon md-icon"></span>
         </label>
       
-      <nav class="md-nav" aria-label="Compensation de résonance" data-md-level="2">
+      <nav class="md-nav" aria-label="Compensation de la résonance" data-md-level="2">
         <label class="md-nav__title" for="__nav_7_5">
           <span class="md-nav__icon md-icon"></span>
-          Compensation de résonance
+          Compensation de la résonance
         </label>
         <ul class="md-nav__list" data-md-scrollfix>
           
@@ -658,7 +658,7 @@
   
     <li class="md-nav__item">
       <a href="Resonance_Compensation.html" class="md-nav__link">
-        Compensation de résonance
+        Compensation de la résonance
       </a>
     </li>
   
diff --git a/fr/Config_Changes.html b/fr/Config_Changes.html
index ae34a874e..2aa487459 100644
--- a/fr/Config_Changes.html
+++ b/fr/Config_Changes.html
@@ -679,14 +679,14 @@
       
       
         <label class="md-nav__link" for="__nav_7_5">
-          Compensation de résonance
+          Compensation de la résonance
           <span class="md-nav__icon md-icon"></span>
         </label>
       
-      <nav class="md-nav" aria-label="Compensation de résonance" data-md-level="2">
+      <nav class="md-nav" aria-label="Compensation de la résonance" data-md-level="2">
         <label class="md-nav__title" for="__nav_7_5">
           <span class="md-nav__icon md-icon"></span>
-          Compensation de résonance
+          Compensation de la résonance
         </label>
         <ul class="md-nav__list" data-md-scrollfix>
           
@@ -697,7 +697,7 @@
   
     <li class="md-nav__item">
       <a href="Resonance_Compensation.html" class="md-nav__link">
-        Compensation de résonance
+        Compensation de la résonance
       </a>
     </li>
   
diff --git a/fr/Config_Reference.html b/fr/Config_Reference.html
index 8833e4947..481c252b0 100644
--- a/fr/Config_Reference.html
+++ b/fr/Config_Reference.html
@@ -1821,14 +1821,14 @@
       
       
         <label class="md-nav__link" for="__nav_7_5">
-          Compensation de résonance
+          Compensation de la résonance
           <span class="md-nav__icon md-icon"></span>
         </label>
       
-      <nav class="md-nav" aria-label="Compensation de résonance" data-md-level="2">
+      <nav class="md-nav" aria-label="Compensation de la résonance" data-md-level="2">
         <label class="md-nav__title" for="__nav_7_5">
           <span class="md-nav__icon md-icon"></span>
-          Compensation de résonance
+          Compensation de la résonance
         </label>
         <ul class="md-nav__list" data-md-scrollfix>
           
@@ -1839,7 +1839,7 @@
   
     <li class="md-nav__item">
       <a href="Resonance_Compensation.html" class="md-nav__link">
-        Compensation de résonance
+        Compensation de la résonance
       </a>
     </li>
   
diff --git a/fr/Config_checks.html b/fr/Config_checks.html
index 0decc7f91..cf552c4be 100644
--- a/fr/Config_checks.html
+++ b/fr/Config_checks.html
@@ -737,14 +737,14 @@
       
       
         <label class="md-nav__link" for="__nav_7_5">
-          Compensation de résonance
+          Compensation de la résonance
           <span class="md-nav__icon md-icon"></span>
         </label>
       
-      <nav class="md-nav" aria-label="Compensation de résonance" data-md-level="2">
+      <nav class="md-nav" aria-label="Compensation de la résonance" data-md-level="2">
         <label class="md-nav__title" for="__nav_7_5">
           <span class="md-nav__icon md-icon"></span>
-          Compensation de résonance
+          Compensation de la résonance
         </label>
         <ul class="md-nav__list" data-md-scrollfix>
           
@@ -755,7 +755,7 @@
   
     <li class="md-nav__item">
       <a href="Resonance_Compensation.html" class="md-nav__link">
-        Compensation de résonance
+        Compensation de la résonance
       </a>
     </li>
   
diff --git a/fr/Contact.html b/fr/Contact.html
index cdb34a428..ca41a5234 100644
--- a/fr/Contact.html
+++ b/fr/Contact.html
@@ -728,14 +728,14 @@
       
       
         <label class="md-nav__link" for="__nav_7_5">
-          Compensation de résonance
+          Compensation de la résonance
           <span class="md-nav__icon md-icon"></span>
         </label>
       
-      <nav class="md-nav" aria-label="Compensation de résonance" data-md-level="2">
+      <nav class="md-nav" aria-label="Compensation de la résonance" data-md-level="2">
         <label class="md-nav__title" for="__nav_7_5">
           <span class="md-nav__icon md-icon"></span>
-          Compensation de résonance
+          Compensation de la résonance
         </label>
         <ul class="md-nav__list" data-md-scrollfix>
           
@@ -746,7 +746,7 @@
   
     <li class="md-nav__item">
       <a href="Resonance_Compensation.html" class="md-nav__link">
-        Compensation de résonance
+        Compensation de la résonance
       </a>
     </li>
   
diff --git a/fr/Debugging.html b/fr/Debugging.html
index ad7a793da..d32317ec8 100644
--- a/fr/Debugging.html
+++ b/fr/Debugging.html
@@ -638,14 +638,14 @@
       
       
         <label class="md-nav__link" for="__nav_7_5">
-          Compensation de résonance
+          Compensation de la résonance
           <span class="md-nav__icon md-icon"></span>
         </label>
       
-      <nav class="md-nav" aria-label="Compensation de résonance" data-md-level="2">
+      <nav class="md-nav" aria-label="Compensation de la résonance" data-md-level="2">
         <label class="md-nav__title" for="__nav_7_5">
           <span class="md-nav__icon md-icon"></span>
-          Compensation de résonance
+          Compensation de la résonance
         </label>
         <ul class="md-nav__list" data-md-scrollfix>
           
@@ -656,7 +656,7 @@
   
     <li class="md-nav__item">
       <a href="Resonance_Compensation.html" class="md-nav__link">
-        Compensation de résonance
+        Compensation de la résonance
       </a>
     </li>
   
diff --git a/fr/Delta_Calibrate.html b/fr/Delta_Calibrate.html
index 546d0aa05..ff3134161 100644
--- a/fr/Delta_Calibrate.html
+++ b/fr/Delta_Calibrate.html
@@ -717,14 +717,14 @@
       
       
         <label class="md-nav__link" for="__nav_7_5">
-          Compensation de résonance
+          Compensation de la résonance
           <span class="md-nav__icon md-icon"></span>
         </label>
       
-      <nav class="md-nav" aria-label="Compensation de résonance" data-md-level="2">
+      <nav class="md-nav" aria-label="Compensation de la résonance" data-md-level="2">
         <label class="md-nav__title" for="__nav_7_5">
           <span class="md-nav__icon md-icon"></span>
-          Compensation de résonance
+          Compensation de la résonance
         </label>
         <ul class="md-nav__list" data-md-scrollfix>
           
@@ -735,7 +735,7 @@
   
     <li class="md-nav__item">
       <a href="Resonance_Compensation.html" class="md-nav__link">
-        Compensation de résonance
+        Compensation de la résonance
       </a>
     </li>
   
diff --git a/fr/Endstop_Phase.html b/fr/Endstop_Phase.html
index a4210f6d6..5d2b1b104 100644
--- a/fr/Endstop_Phase.html
+++ b/fr/Endstop_Phase.html
@@ -696,14 +696,14 @@
       
       
         <label class="md-nav__link" for="__nav_7_5">
-          Compensation de résonance
+          Compensation de la résonance
           <span class="md-nav__icon md-icon"></span>
         </label>
       
-      <nav class="md-nav" aria-label="Compensation de résonance" data-md-level="2">
+      <nav class="md-nav" aria-label="Compensation de la résonance" data-md-level="2">
         <label class="md-nav__title" for="__nav_7_5">
           <span class="md-nav__icon md-icon"></span>
-          Compensation de résonance
+          Compensation de la résonance
         </label>
         <ul class="md-nav__list" data-md-scrollfix>
           
@@ -714,7 +714,7 @@
   
     <li class="md-nav__item">
       <a href="Resonance_Compensation.html" class="md-nav__link">
-        Compensation de résonance
+        Compensation de la résonance
       </a>
     </li>
   
@@ -1381,13 +1381,13 @@
       
       
         
-        <a href="Resonance_Compensation.html" class="md-footer__link md-footer__link--next" aria-label="Suivant: Compensation de résonance" rel="next">
+        <a href="Resonance_Compensation.html" class="md-footer__link md-footer__link--next" aria-label="Suivant: Compensation de la résonance" rel="next">
           <div class="md-footer__title">
             <div class="md-ellipsis">
               <span class="md-footer__direction">
                 Suivant
               </span>
-              Compensation de résonance
+              Compensation de la résonance
             </div>
           </div>
           <div class="md-footer__button md-icon">
diff --git a/fr/Example_Configs.html b/fr/Example_Configs.html
index 6b8c054a0..4b39ade8f 100644
--- a/fr/Example_Configs.html
+++ b/fr/Example_Configs.html
@@ -638,14 +638,14 @@
       
       
         <label class="md-nav__link" for="__nav_7_5">
-          Compensation de résonance
+          Compensation de la résonance
           <span class="md-nav__icon md-icon"></span>
         </label>
       
-      <nav class="md-nav" aria-label="Compensation de résonance" data-md-level="2">
+      <nav class="md-nav" aria-label="Compensation de la résonance" data-md-level="2">
         <label class="md-nav__title" for="__nav_7_5">
           <span class="md-nav__icon md-icon"></span>
-          Compensation de résonance
+          Compensation de la résonance
         </label>
         <ul class="md-nav__list" data-md-scrollfix>
           
@@ -656,7 +656,7 @@
   
     <li class="md-nav__item">
       <a href="Resonance_Compensation.html" class="md-nav__link">
-        Compensation de résonance
+        Compensation de la résonance
       </a>
     </li>
   
diff --git a/fr/Exclude_Object.html b/fr/Exclude_Object.html
index 0f261943f..560456ced 100644
--- a/fr/Exclude_Object.html
+++ b/fr/Exclude_Object.html
@@ -640,14 +640,14 @@
       
       
         <label class="md-nav__link" for="__nav_7_5">
-          Compensation de résonance
+          Compensation de la résonance
           <span class="md-nav__icon md-icon"></span>
         </label>
       
-      <nav class="md-nav" aria-label="Compensation de résonance" data-md-level="2">
+      <nav class="md-nav" aria-label="Compensation de la résonance" data-md-level="2">
         <label class="md-nav__title" for="__nav_7_5">
           <span class="md-nav__icon md-icon"></span>
-          Compensation de résonance
+          Compensation de la résonance
         </label>
         <ul class="md-nav__list" data-md-scrollfix>
           
@@ -658,7 +658,7 @@
   
     <li class="md-nav__item">
       <a href="Resonance_Compensation.html" class="md-nav__link">
-        Compensation de résonance
+        Compensation de la résonance
       </a>
     </li>
   
diff --git a/fr/FAQ.html b/fr/FAQ.html
index 1fe5aa9ab..63ca51aa7 100644
--- a/fr/FAQ.html
+++ b/fr/FAQ.html
@@ -840,14 +840,14 @@
       
       
         <label class="md-nav__link" for="__nav_7_5">
-          Compensation de résonance
+          Compensation de la résonance
           <span class="md-nav__icon md-icon"></span>
         </label>
       
-      <nav class="md-nav" aria-label="Compensation de résonance" data-md-level="2">
+      <nav class="md-nav" aria-label="Compensation de la résonance" data-md-level="2">
         <label class="md-nav__title" for="__nav_7_5">
           <span class="md-nav__icon md-icon"></span>
-          Compensation de résonance
+          Compensation de la résonance
         </label>
         <ul class="md-nav__list" data-md-scrollfix>
           
@@ -858,7 +858,7 @@
   
     <li class="md-nav__item">
       <a href="Resonance_Compensation.html" class="md-nav__link">
-        Compensation de résonance
+        Compensation de la résonance
       </a>
     </li>
   
diff --git a/fr/Features.html b/fr/Features.html
index f938e1e0e..e6706d3bd 100644
--- a/fr/Features.html
+++ b/fr/Features.html
@@ -686,14 +686,14 @@
       
       
         <label class="md-nav__link" for="__nav_7_5">
-          Compensation de résonance
+          Compensation de la résonance
           <span class="md-nav__icon md-icon"></span>
         </label>
       
-      <nav class="md-nav" aria-label="Compensation de résonance" data-md-level="2">
+      <nav class="md-nav" aria-label="Compensation de la résonance" data-md-level="2">
         <label class="md-nav__title" for="__nav_7_5">
           <span class="md-nav__icon md-icon"></span>
-          Compensation de résonance
+          Compensation de la résonance
         </label>
         <ul class="md-nav__list" data-md-scrollfix>
           
@@ -704,7 +704,7 @@
   
     <li class="md-nav__item">
       <a href="Resonance_Compensation.html" class="md-nav__link">
-        Compensation de résonance
+        Compensation de la résonance
       </a>
     </li>
   
diff --git a/fr/G-Codes.html b/fr/G-Codes.html
index 0ebe6abc9..4990996aa 100644
--- a/fr/G-Codes.html
+++ b/fr/G-Codes.html
@@ -640,14 +640,14 @@
       
       
         <label class="md-nav__link" for="__nav_7_5">
-          Compensation de résonance
+          Compensation de la résonance
           <span class="md-nav__icon md-icon"></span>
         </label>
       
-      <nav class="md-nav" aria-label="Compensation de résonance" data-md-level="2">
+      <nav class="md-nav" aria-label="Compensation de la résonance" data-md-level="2">
         <label class="md-nav__title" for="__nav_7_5">
           <span class="md-nav__icon md-icon"></span>
-          Compensation de résonance
+          Compensation de la résonance
         </label>
         <ul class="md-nav__list" data-md-scrollfix>
           
@@ -658,7 +658,7 @@
   
     <li class="md-nav__item">
       <a href="Resonance_Compensation.html" class="md-nav__link">
-        Compensation de résonance
+        Compensation de la résonance
       </a>
     </li>
   
diff --git a/fr/Hall_Filament_Width_Sensor.html b/fr/Hall_Filament_Width_Sensor.html
index 0c1a479e7..25f4645f5 100644
--- a/fr/Hall_Filament_Width_Sensor.html
+++ b/fr/Hall_Filament_Width_Sensor.html
@@ -638,14 +638,14 @@
       
       
         <label class="md-nav__link" for="__nav_7_5">
-          Compensation de résonance
+          Compensation de la résonance
           <span class="md-nav__icon md-icon"></span>
         </label>
       
-      <nav class="md-nav" aria-label="Compensation de résonance" data-md-level="2">
+      <nav class="md-nav" aria-label="Compensation de la résonance" data-md-level="2">
         <label class="md-nav__title" for="__nav_7_5">
           <span class="md-nav__icon md-icon"></span>
-          Compensation de résonance
+          Compensation de la résonance
         </label>
         <ul class="md-nav__list" data-md-scrollfix>
           
@@ -656,7 +656,7 @@
   
     <li class="md-nav__item">
       <a href="Resonance_Compensation.html" class="md-nav__link">
-        Compensation de résonance
+        Compensation de la résonance
       </a>
     </li>
   
diff --git a/fr/Installation.html b/fr/Installation.html
index b8b1d5cd2..4f6e1ec92 100644
--- a/fr/Installation.html
+++ b/fr/Installation.html
@@ -709,14 +709,14 @@
       
       
         <label class="md-nav__link" for="__nav_7_5">
-          Compensation de résonance
+          Compensation de la résonance
           <span class="md-nav__icon md-icon"></span>
         </label>
       
-      <nav class="md-nav" aria-label="Compensation de résonance" data-md-level="2">
+      <nav class="md-nav" aria-label="Compensation de la résonance" data-md-level="2">
         <label class="md-nav__title" for="__nav_7_5">
           <span class="md-nav__icon md-icon"></span>
-          Compensation de résonance
+          Compensation de la résonance
         </label>
         <ul class="md-nav__list" data-md-scrollfix>
           
@@ -727,7 +727,7 @@
   
     <li class="md-nav__item">
       <a href="Resonance_Compensation.html" class="md-nav__link">
-        Compensation de résonance
+        Compensation de la résonance
       </a>
     </li>
   
diff --git a/fr/Kinematics.html b/fr/Kinematics.html
index f90a4adb3..2c79c7de4 100644
--- a/fr/Kinematics.html
+++ b/fr/Kinematics.html
@@ -638,14 +638,14 @@
       
       
         <label class="md-nav__link" for="__nav_7_5">
-          Compensation de résonance
+          Compensation de la résonance
           <span class="md-nav__icon md-icon"></span>
         </label>
       
-      <nav class="md-nav" aria-label="Compensation de résonance" data-md-level="2">
+      <nav class="md-nav" aria-label="Compensation de la résonance" data-md-level="2">
         <label class="md-nav__title" for="__nav_7_5">
           <span class="md-nav__icon md-icon"></span>
-          Compensation de résonance
+          Compensation de la résonance
         </label>
         <ul class="md-nav__list" data-md-scrollfix>
           
@@ -656,7 +656,7 @@
   
     <li class="md-nav__item">
       <a href="Resonance_Compensation.html" class="md-nav__link">
-        Compensation de résonance
+        Compensation de la résonance
       </a>
     </li>
   
diff --git a/fr/MCU_Commands.html b/fr/MCU_Commands.html
index 9b3163d33..c38dc263d 100644
--- a/fr/MCU_Commands.html
+++ b/fr/MCU_Commands.html
@@ -638,14 +638,14 @@
       
       
         <label class="md-nav__link" for="__nav_7_5">
-          Compensation de résonance
+          Compensation de la résonance
           <span class="md-nav__icon md-icon"></span>
         </label>
       
-      <nav class="md-nav" aria-label="Compensation de résonance" data-md-level="2">
+      <nav class="md-nav" aria-label="Compensation de la résonance" data-md-level="2">
         <label class="md-nav__title" for="__nav_7_5">
           <span class="md-nav__icon md-icon"></span>
-          Compensation de résonance
+          Compensation de la résonance
         </label>
         <ul class="md-nav__list" data-md-scrollfix>
           
@@ -656,7 +656,7 @@
   
     <li class="md-nav__item">
       <a href="Resonance_Compensation.html" class="md-nav__link">
-        Compensation de résonance
+        Compensation de la résonance
       </a>
     </li>
   
diff --git a/fr/Manual_Level.html b/fr/Manual_Level.html
index e7e6493ea..08ad529f0 100644
--- a/fr/Manual_Level.html
+++ b/fr/Manual_Level.html
@@ -710,14 +710,14 @@
       
       
         <label class="md-nav__link" for="__nav_7_5">
-          Compensation de résonance
+          Compensation de la résonance
           <span class="md-nav__icon md-icon"></span>
         </label>
       
-      <nav class="md-nav" aria-label="Compensation de résonance" data-md-level="2">
+      <nav class="md-nav" aria-label="Compensation de la résonance" data-md-level="2">
         <label class="md-nav__title" for="__nav_7_5">
           <span class="md-nav__icon md-icon"></span>
-          Compensation de résonance
+          Compensation de la résonance
         </label>
         <ul class="md-nav__list" data-md-scrollfix>
           
@@ -728,7 +728,7 @@
   
     <li class="md-nav__item">
       <a href="Resonance_Compensation.html" class="md-nav__link">
-        Compensation de résonance
+        Compensation de la résonance
       </a>
     </li>
   
diff --git a/fr/Measuring_Resonances.html b/fr/Measuring_Resonances.html
index 3c391f751..9fbd33b60 100644
--- a/fr/Measuring_Resonances.html
+++ b/fr/Measuring_Resonances.html
@@ -642,14 +642,14 @@
       
       
         <label class="md-nav__link" for="__nav_7_5">
-          Compensation de résonance
+          Compensation de la résonance
           <span class="md-nav__icon md-icon"></span>
         </label>
       
-      <nav class="md-nav" aria-label="Compensation de résonance" data-md-level="2">
+      <nav class="md-nav" aria-label="Compensation de la résonance" data-md-level="2">
         <label class="md-nav__title" for="__nav_7_5">
           <span class="md-nav__icon md-icon"></span>
-          Compensation de résonance
+          Compensation de la résonance
         </label>
         <ul class="md-nav__list" data-md-scrollfix>
           
@@ -660,7 +660,7 @@
   
     <li class="md-nav__item">
       <a href="Resonance_Compensation.html" class="md-nav__link">
-        Compensation de résonance
+        Compensation de la résonance
       </a>
     </li>
   
@@ -2099,7 +2099,7 @@ TEST_RESONANCES AXIS=X OUTPUT=raw_data
     <nav class="md-footer__inner md-grid" aria-label="Pied de page">
       
         
-        <a href="Resonance_Compensation.html" class="md-footer__link md-footer__link--prev" aria-label="Précédent: Compensation de résonance" rel="prev">
+        <a href="Resonance_Compensation.html" class="md-footer__link md-footer__link--prev" aria-label="Précédent: Compensation de la résonance" rel="prev">
           <div class="md-footer__button md-icon">
             <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12z"/></svg>
           </div>
@@ -2108,7 +2108,7 @@ TEST_RESONANCES AXIS=X OUTPUT=raw_data
               <span class="md-footer__direction">
                 Précédent
               </span>
-              Compensation de résonance
+              Compensation de la résonance
             </div>
           </div>
         </a>
diff --git a/fr/Multi_MCU_Homing.html b/fr/Multi_MCU_Homing.html
index 8d08465bc..87920fdc0 100644
--- a/fr/Multi_MCU_Homing.html
+++ b/fr/Multi_MCU_Homing.html
@@ -640,14 +640,14 @@
       
       
         <label class="md-nav__link" for="__nav_7_5">
-          Compensation de résonance
+          Compensation de la résonance
           <span class="md-nav__icon md-icon"></span>
         </label>
       
-      <nav class="md-nav" aria-label="Compensation de résonance" data-md-level="2">
+      <nav class="md-nav" aria-label="Compensation de la résonance" data-md-level="2">
         <label class="md-nav__title" for="__nav_7_5">
           <span class="md-nav__icon md-icon"></span>
-          Compensation de résonance
+          Compensation de la résonance
         </label>
         <ul class="md-nav__list" data-md-scrollfix>
           
@@ -658,7 +658,7 @@
   
     <li class="md-nav__item">
       <a href="Resonance_Compensation.html" class="md-nav__link">
-        Compensation de résonance
+        Compensation de la résonance
       </a>
     </li>
   
diff --git a/fr/Navigation.html b/fr/Navigation.html
index 1f0a306a4..dbf890dfb 100644
--- a/fr/Navigation.html
+++ b/fr/Navigation.html
@@ -633,14 +633,14 @@
       
       
         <label class="md-nav__link" for="__nav_7_5">
-          Compensation de résonance
+          Compensation de la résonance
           <span class="md-nav__icon md-icon"></span>
         </label>
       
-      <nav class="md-nav" aria-label="Compensation de résonance" data-md-level="2">
+      <nav class="md-nav" aria-label="Compensation de la résonance" data-md-level="2">
         <label class="md-nav__title" for="__nav_7_5">
           <span class="md-nav__icon md-icon"></span>
-          Compensation de résonance
+          Compensation de la résonance
         </label>
         <ul class="md-nav__list" data-md-scrollfix>
           
@@ -651,7 +651,7 @@
   
     <li class="md-nav__item">
       <a href="Resonance_Compensation.html" class="md-nav__link">
-        Compensation de résonance
+        Compensation de la résonance
       </a>
     </li>
   
@@ -1216,7 +1216,7 @@
 <p>Installation et configuration</p>
 <p>Référence de configuration</p>
 <p>Nivellement du lit</p>
-<p>Compensation de résonance</p>
+<p>Compensation de la résonance</p>
 <p>Modèles de commandes</p>
 <p>Documentation pour les développeurs</p>
 <p>Documents spécifiques à certains appareils</p>
diff --git a/fr/Overview.html b/fr/Overview.html
index 3f4d76b9a..ad6c89200 100644
--- a/fr/Overview.html
+++ b/fr/Overview.html
@@ -700,14 +700,14 @@
       
       
         <label class="md-nav__link" for="__nav_7_5">
-          Compensation de résonance
+          Compensation de la résonance
           <span class="md-nav__icon md-icon"></span>
         </label>
       
-      <nav class="md-nav" aria-label="Compensation de résonance" data-md-level="2">
+      <nav class="md-nav" aria-label="Compensation de la résonance" data-md-level="2">
         <label class="md-nav__title" for="__nav_7_5">
           <span class="md-nav__icon md-icon"></span>
-          Compensation de résonance
+          Compensation de la résonance
         </label>
         <ul class="md-nav__list" data-md-scrollfix>
           
@@ -718,7 +718,7 @@
   
     <li class="md-nav__item">
       <a href="Resonance_Compensation.html" class="md-nav__link">
-        Compensation de résonance
+        Compensation de la résonance
       </a>
     </li>
   
diff --git a/fr/Packaging.html b/fr/Packaging.html
index 6db1e2717..92db9b579 100644
--- a/fr/Packaging.html
+++ b/fr/Packaging.html
@@ -638,14 +638,14 @@
       
       
         <label class="md-nav__link" for="__nav_7_5">
-          Compensation de résonance
+          Compensation de la résonance
           <span class="md-nav__icon md-icon"></span>
         </label>
       
-      <nav class="md-nav" aria-label="Compensation de résonance" data-md-level="2">
+      <nav class="md-nav" aria-label="Compensation de la résonance" data-md-level="2">
         <label class="md-nav__title" for="__nav_7_5">
           <span class="md-nav__icon md-icon"></span>
-          Compensation de résonance
+          Compensation de la résonance
         </label>
         <ul class="md-nav__list" data-md-scrollfix>
           
@@ -656,7 +656,7 @@
   
     <li class="md-nav__item">
       <a href="Resonance_Compensation.html" class="md-nav__link">
-        Compensation de résonance
+        Compensation de la résonance
       </a>
     </li>
   
diff --git a/fr/Pressure_Advance.html b/fr/Pressure_Advance.html
index c41c33d94..ea4d9c7f9 100644
--- a/fr/Pressure_Advance.html
+++ b/fr/Pressure_Advance.html
@@ -640,14 +640,14 @@
       
       
         <label class="md-nav__link" for="__nav_7_5">
-          Compensation de résonance
+          Compensation de la résonance
           <span class="md-nav__icon md-icon"></span>
         </label>
       
-      <nav class="md-nav" aria-label="Compensation de résonance" data-md-level="2">
+      <nav class="md-nav" aria-label="Compensation de la résonance" data-md-level="2">
         <label class="md-nav__title" for="__nav_7_5">
           <span class="md-nav__icon md-icon"></span>
-          Compensation de résonance
+          Compensation de la résonance
         </label>
         <ul class="md-nav__list" data-md-scrollfix>
           
@@ -658,7 +658,7 @@
   
     <li class="md-nav__item">
       <a href="Resonance_Compensation.html" class="md-nav__link">
-        Compensation de résonance
+        Compensation de la résonance
       </a>
     </li>
   
diff --git a/fr/Probe_Calibrate.html b/fr/Probe_Calibrate.html
index 872cb6fd2..cc5351c12 100644
--- a/fr/Probe_Calibrate.html
+++ b/fr/Probe_Calibrate.html
@@ -711,14 +711,14 @@
       
       
         <label class="md-nav__link" for="__nav_7_5">
-          Compensation de résonance
+          Compensation de la résonance
           <span class="md-nav__icon md-icon"></span>
         </label>
       
-      <nav class="md-nav" aria-label="Compensation de résonance" data-md-level="2">
+      <nav class="md-nav" aria-label="Compensation de la résonance" data-md-level="2">
         <label class="md-nav__title" for="__nav_7_5">
           <span class="md-nav__icon md-icon"></span>
-          Compensation de résonance
+          Compensation de la résonance
         </label>
         <ul class="md-nav__list" data-md-scrollfix>
           
@@ -729,7 +729,7 @@
   
     <li class="md-nav__item">
       <a href="Resonance_Compensation.html" class="md-nav__link">
-        Compensation de résonance
+        Compensation de la résonance
       </a>
     </li>
   
diff --git a/fr/Protocol.html b/fr/Protocol.html
index 7cd238fe3..d0df746a6 100644
--- a/fr/Protocol.html
+++ b/fr/Protocol.html
@@ -638,14 +638,14 @@
       
       
         <label class="md-nav__link" for="__nav_7_5">
-          Compensation de résonance
+          Compensation de la résonance
           <span class="md-nav__icon md-icon"></span>
         </label>
       
-      <nav class="md-nav" aria-label="Compensation de résonance" data-md-level="2">
+      <nav class="md-nav" aria-label="Compensation de la résonance" data-md-level="2">
         <label class="md-nav__title" for="__nav_7_5">
           <span class="md-nav__icon md-icon"></span>
-          Compensation de résonance
+          Compensation de la résonance
         </label>
         <ul class="md-nav__list" data-md-scrollfix>
           
@@ -656,7 +656,7 @@
   
     <li class="md-nav__item">
       <a href="Resonance_Compensation.html" class="md-nav__link">
-        Compensation de résonance
+        Compensation de la résonance
       </a>
     </li>
   
diff --git a/fr/RPi_microcontroller.html b/fr/RPi_microcontroller.html
index e4ab8ce99..2401022f7 100644
--- a/fr/RPi_microcontroller.html
+++ b/fr/RPi_microcontroller.html
@@ -638,14 +638,14 @@
       
       
         <label class="md-nav__link" for="__nav_7_5">
-          Compensation de résonance
+          Compensation de la résonance
           <span class="md-nav__icon md-icon"></span>
         </label>
       
-      <nav class="md-nav" aria-label="Compensation de résonance" data-md-level="2">
+      <nav class="md-nav" aria-label="Compensation de la résonance" data-md-level="2">
         <label class="md-nav__title" for="__nav_7_5">
           <span class="md-nav__icon md-icon"></span>
-          Compensation de résonance
+          Compensation de la résonance
         </label>
         <ul class="md-nav__list" data-md-scrollfix>
           
@@ -656,7 +656,7 @@
   
     <li class="md-nav__item">
       <a href="Resonance_Compensation.html" class="md-nav__link">
-        Compensation de résonance
+        Compensation de la résonance
       </a>
     </li>
   
diff --git a/fr/Releases.html b/fr/Releases.html
index 375ceb5a5..10f57e6fc 100644
--- a/fr/Releases.html
+++ b/fr/Releases.html
@@ -755,14 +755,14 @@
       
       
         <label class="md-nav__link" for="__nav_7_5">
-          Compensation de résonance
+          Compensation de la résonance
           <span class="md-nav__icon md-icon"></span>
         </label>
       
-      <nav class="md-nav" aria-label="Compensation de résonance" data-md-level="2">
+      <nav class="md-nav" aria-label="Compensation de la résonance" data-md-level="2">
         <label class="md-nav__title" for="__nav_7_5">
           <span class="md-nav__icon md-icon"></span>
-          Compensation de résonance
+          Compensation de la résonance
         </label>
         <ul class="md-nav__list" data-md-scrollfix>
           
@@ -773,7 +773,7 @@
   
     <li class="md-nav__item">
       <a href="Resonance_Compensation.html" class="md-nav__link">
-        Compensation de résonance
+        Compensation de la résonance
       </a>
     </li>
   
diff --git a/fr/Resonance_Compensation.html b/fr/Resonance_Compensation.html
index 8b3a58224..05990fa28 100644
--- a/fr/Resonance_Compensation.html
+++ b/fr/Resonance_Compensation.html
@@ -13,7 +13,7 @@
     
     
       
-        <title>Compensation de résonance - Documentation Klipper</title>
+        <title>Compensation de la résonance - Documentation Klipper</title>
       
     
     
@@ -74,7 +74,7 @@
     <div data-md-component="skip">
       
         
-        <a href="#compensation-de-resonance" class="md-skip">
+        <a href="#compensation-de-la-resonance" class="md-skip">
           Aller au contenu
         </a>
       
@@ -106,7 +106,7 @@
         <div class="md-header__topic" data-md-component="header-topic">
           <span class="md-ellipsis">
             
-              Compensation de résonance
+              Compensation de la résonance
             
           </span>
         </div>
@@ -642,14 +642,14 @@
       
       
         <label class="md-nav__link" for="__nav_7_5">
-          Compensation de résonance
+          Compensation de la résonance
           <span class="md-nav__icon md-icon"></span>
         </label>
       
-      <nav class="md-nav" aria-label="Compensation de résonance" data-md-level="2">
+      <nav class="md-nav" aria-label="Compensation de la résonance" data-md-level="2">
         <label class="md-nav__title" for="__nav_7_5">
           <span class="md-nav__icon md-icon"></span>
-          Compensation de résonance
+          Compensation de la résonance
         </label>
         <ul class="md-nav__list" data-md-scrollfix>
           
@@ -669,12 +669,12 @@
       
       
         <label class="md-nav__link md-nav__link--active" for="__toc">
-          Compensation de résonance
+          Compensation de la résonance
           <span class="md-nav__icon md-icon"></span>
         </label>
       
       <a href="Resonance_Compensation.html" class="md-nav__link md-nav__link--active">
-        Compensation de résonance
+        Compensation de la résonance
       </a>
       
         
@@ -709,14 +709,14 @@
         
           <li class="md-nav__item">
   <a href="#configuration-de-linput-shaper" class="md-nav__link">
-    Configuration de l'"input shaper"
+    Configuration de l'input shaper
   </a>
   
 </li>
         
           <li class="md-nav__item">
   <a href="#choix-de-linput-shaper" class="md-nav__link">
-    Choix de l'"input shaper"
+    Choix de l'input shaper
   </a>
   
 </li>
@@ -1409,14 +1409,14 @@
         
           <li class="md-nav__item">
   <a href="#configuration-de-linput-shaper" class="md-nav__link">
-    Configuration de l'"input shaper"
+    Configuration de l'input shaper
   </a>
   
 </li>
         
           <li class="md-nav__item">
   <a href="#choix-de-linput-shaper" class="md-nav__link">
-    Choix de l'"input shaper"
+    Choix de l'input shaper
   </a>
   
 </li>
@@ -1539,46 +1539,46 @@
 </a>
 
 
-<h1 id="compensation-de-resonance">Compensation de résonance<a class="headerlink" href="#compensation-de-resonance" title="Permanent link">&para;</a></h1>
-<p>Klipper prend en charge la mise en forme de l'entrée, une technique utilisée pour réduire l'effet de résonance (également connu sous le nom d'écho, d'image fantôme ou d'ondulation) dans les impressions. La résonance est un défaut d'impression de surface lorsque des éléments tels que des bords se répètent sur une surface imprimée sous forme d'un "écho" subtil :</p>
+<h1 id="compensation-de-la-resonance">Compensation de la résonance<a class="headerlink" href="#compensation-de-la-resonance" title="Permanent link">&para;</a></h1>
+<p>Klipper prend en charge l'input shaper, une technique utilisée pour réduire l'effet de la résonance (également connu sous le nom d'écho, d'image fantôme - "ghosting" - ou d'ondulation - "ringing") dans les impressions. La résonance est un défaut d'impression de la surface lorsque des éléments tels que des bords se répètent sous la forme d'un léger "écho" :</p>
 <p>|<img alt="Test de résonance" src="img/ringing-test.jpg" />|<img alt="3D Benchy" src="img/ringing-3dbenchy.jpg" />|</p>
-<p>La résonance est causée par des vibrations mécaniques dans l'imprimante dues à des changements rapides de direction durant une impression. Notez que la résonance a généralement des origines mécaniques : cadre de l'imprimante insuffisamment rigide, courroies non tendues ou trop élastiques, problèmes d'alignement des pièces mécaniques, masse mobile importante, etc. Ces problèmes doivent être vérifiés et corrigés en premier lieu, si possible.</p>
-<p>La <a href="https://en.wikipedia.org/wiki/Input_shaping">mise en forme de l'entrée</a> est une technique de contrôle en boucle ouverte qui crée un signal de commande annulant ses propres vibrations. La mise en forme de l'entrée nécessite quelques réglages et mesures avant de pouvoir être activée. Outre la résonance, la mise en forme de l'entrée réduit généralement les vibrations et les secousses de l'imprimante en général, et peut également améliorer la fiabilité du mode stealthChop des pilotes Trinamic.</p>
+<p>La résonance est causée par des vibrations mécaniques dans l'imprimante dues à des changements rapides de direction pendant l'impression. La résonance a généralement des origines mécaniques : cadre de l'imprimante insuffisamment rigide, courroies non tendues ou trop élastiques, problèmes d'alignement des pièces mécaniques, masse mobile importante, etc. Ces problèmes doivent être vérifiés et corrigés en premier lieu, si possible.</p>
+<p>L' <a href="https://en.wikipedia.org/wiki/Input_shaping">input shaping</a> est une technique de contrôle en boucle ouverte qui crée un signal de commande annulant ses propres vibrations. L'input shaping nécessite quelques réglages et mesures avant de pouvoir être activée. Outre la résonance, l'input shaping réduit aussi les vibrations et les secousses de l'imprimante en général, et peut également améliorer la fiabilité du mode stealthChop des pilotes Trinamic.</p>
 <h2 id="reglages">Réglages<a class="headerlink" href="#reglages" title="Permanent link">&para;</a></h2>
 <p>Le réglage de base nécessite de mesurer les fréquences de résonance de l'imprimante en imprimant un modèle de test.</p>
-<p>Tranchez le modèle de test de résonance, qui se trouve dans <a href="prints/ringing_tower.stl">docs/prints/ringing_tower.stl</a>, dans le trancheur :</p>
+<p>Tranchez le modèle de test de résonance, qui se trouve dans <a href="prints/ringing_tower.stl">docs/prints/ringing_tower.stl</a>, avec votre trancheur :</p>
 <ul>
-<li>La hauteur de couche suggérée est de 0,2 ou 0,25 mm.</li>
-<li>Les couches de remplissage et de finition peuvent être réglées sur 0.</li>
-<li>Utilisez 1-2 périmètres, ou mieux encore le mode vase avec 1-2 mm de base.</li>
-<li>Utilisez une vitesse suffisamment élevée, environ 80-100 mm/s, pour les périmètres <strong>externes</strong>.</li>
-<li>Veillez à ce que le temps de pause minimum soit <strong>au maximum</strong> de 3 secondes.</li>
-<li>Assurez-vous que le "contrôle d'accélération" est désactivé dans le trancheur.</li>
-<li>Ne tournez pas le modèle. Le modèle comporte des marques X et Y à l'arrière du modèle. Notez l'emplacement inhabituel des marques par rapport aux axes de l'imprimante - il ne s'agit pas d'une erreur. Les marques peuvent être utilisées plus tard dans le processus de réglage comme référence, car elles indiquent à quel axe correspondent les mesures.</li>
+<li>La hauteur de couche recommandée est de 0,2 ou 0,25 mm.</li>
+<li>Le remplissage et le nombre de couches supérieures peuvent être réglés sur 0.</li>
+<li>Utilisez 1 ou 2 parois, ou mieux encore le mode vase avec 1 ou 2 mm de base.</li>
+<li>Utilisez une vitesse suffisamment élevée, entre 80 et 100 mm/s, pour les parois <strong>externes</strong>.</li>
+<li>Veillez à ce que le temps minimum par couche soit <strong>au maximum</strong> de 3 secondes.</li>
+<li>Assurez-vous que toutes les options de "contrôle d'accélération" soient bien désactivées dans le trancheur.</li>
+<li>Ne tournez pas le modèle. Le modèle comporte des marques X et Y à l'arrière du modèle. L'emplacement inhabituel des marques par rapport aux axes de l'imprimante n'est pas une erreur. Ces marques pourront être utilisées plus tard - comme référence - dans le processus de réglage, car elles indiquent à quel axe correspondent les mesures.</li>
 </ul>
 <h3 id="frequence-de-resonance">Fréquence de résonance<a class="headerlink" href="#frequence-de-resonance" title="Permanent link">&para;</a></h3>
-<p>Tout d'abord, mesurez la <strong>fréquence de résonance</strong>.</p>
+<p>En premier lieu, mesurez la <strong>fréquence de résonance</strong>.</p>
 <ol>
 <li>Si le paramètre <code>square_corner_velocity</code> a été modifié, remettez-le à 5.0. Il n'est pas conseillé de l'augmenter lors de l'utilisation de l'input shaper car cela peut provoquer plus de lissage dans les pièces - il est préférable d'utiliser une valeur d'accélération plus élevée à la place.</li>
 <li>Augmentez <code>max_accel_to_decel</code> en lançant la commande suivante : <code>SET_VELOCITY_LIMIT ACCEL_TO_DECEL=7000</code></li>
 <li>Désactivez l'avance de pression : <code>SET_PRESSURE_ADVANCE ADVANCE=0</code></li>
-<li>Si vous avez déjà ajouté la section <code>[input_shaper]</code> au printer.cfg, exécutez la commande <code>SET_INPUT_SHAPER SHAPER_FREQ_X=0 SHAPER_FREQ_Y=0</code>. Si vous obtenez l'erreur "Unknown command", vous pouvez l'ignorer à ce stade et continuer les mesures.</li>
+<li>Si vous avez déjà ajouté la section <code>[input_shaper]</code> au fichier printer.cfg, exécutez la commande <code>SET_INPUT_SHAPER SHAPER_FREQ_X=0 SHAPER_FREQ_Y=0</code>. Si vous obtenez l'erreur "Unknown command", vous pouvez l'ignorer - pour le moment - et continuer les mesures.</li>
 <li>Exécutez la commande : <code>TUNING_TOWER COMMAND=SET_VELOCITY_LIMIT PARAMETER=ACCEL START=1500 STEP_DELTA=500 STEP_HEIGHT=5</code> Dans la pratique, nous essayons de rendre la résonance plus prononcée en définissant différentes valeurs élevées pour l'accélération. Cette commande augmentera l'accélération tous les 5 mm à partir de 1500 mm/sec² : 1500 mm/sec², 2000 mm/sec², 2500 mm/sec² et ainsi de suite jusqu'à 7000 mm/sec² pour la dernière bande.</li>
-<li>Imprimez le modèle de test tranché avec les paramètres suggérés.</li>
+<li>Imprimez le modèle de test tranché avec les paramètres indiqués.</li>
 <li>
-<p>Vous pouvez arrêter l'impression plus tôt si la résonance est clairement visible et si vous constatez que l'accélération devient trop forte pour votre imprimante (par exemple, l'imprimante tremble trop ou commence à sauter des pas).</p>
+<p>Vous pouvez arrêter l'impression avant la fin si la résonance est clairement visible et si vous constatez que l'accélération devient trop forte pour votre imprimante (par exemple, l'imprimante tremble trop ou commence à sauter des pas).</p>
 <ol>
-<li>Utilisez les marques X et Y à l'arrière du modèle comme référence. Les mesures du côté avec la marque X doivent être utilisées pour la <em>configuration</em> de l'axe X, et la marque Y - pour la configuration de l'axe Y. Mesurez la distance <em>D</em> (en mm) entre plusieurs oscillations sur la pièce avec la marque X, près des encoches, en sautant de préférence la ou les deux premières oscillations. Pour mesurer plus facilement la distance entre les oscillations, marquez d'abord les oscillations, puis mesurez la distance entre les marques avec une règle ou un pied à coulisse :|<img alt="Marques de résonances" src="img/ringing-mark.jpg" />|<img alt="Mesure de la résonance" src="img/ringing-measure.jpg" />|</li>
+<li>Utilisez les marques X et Y à l'arrière du modèle comme référence. Les mesures du côté avec la marque X doivent être utilisées pour la <em>configuration</em> de l'axe X, et les mesures du côté avec la marque Y pour la configuration de l'axe Y. Mesurez la distance <em>D</em> (en mm) entre plusieurs oscillations sur la partie de la pièce avec la marque X, près des encoches et en sautant de préférence la ou les deux premières oscillations. Pour mesurer plus facilement la distance entre les oscillations, marquez d'abord les oscillations, puis mesurez la distance entre les marques avec une règle ou un pied à coulisse :|<img alt="Marques de résonances" src="img/ringing-mark.jpg" />|<img alt="Mesure de la résonance" src="img/ringing-measure.jpg" />|</li>
 <li>Comptez le nombre d'oscillations <em>N</em> correspondant à la distance mesurée <em>D</em>. Si vous ne savez pas comment compter les oscillations, reportez-vous à l'image ci-dessus, qui montre <em>N</em> = 6 oscillations.</li>
-<li>Calculer la fréquence de résonance de l'axe X comme <em>V</em> &middot; <em>N</em> / <em>D</em> (Hz), où <em>V</em> est la vitesse des périmètres extérieurs (mm/s). Pour l'exemple ci-dessus, nous avons marqué 6 oscillations, et le test a été imprimé à une vitesse de 100 mm/s, donc la fréquence est 100 * 6 / 12,14 ≈ 49,4 Hz.</li>
+<li>Calculez la fréquence de résonance de l'axe X : <em>V</em> &middot; <em>N</em> / <em>D</em> (Hz), où <em>V</em> est la vitesse des périmètres extérieurs (mm/s). Pour l'exemple ci-dessus, nous avons marqué 6 oscillations (N) sur une distance de 12,14 mm (D), et le test a été imprimé à une vitesse de 100 mm/s (V), donc la fréquence est 100 * 6 / 12,14 ≈ 49,4 Hz.</li>
 <li>Faites (8) - (10) pour la marque Y également.</li>
 </ol>
 </li>
 </ol>
-<p>Notez que la résonanc sur l'impression de test devrait correspondre au modèle des encoches courbes, comme dans l'image ci-dessus. Si ce n'est pas le cas, alors ce défaut n'est pas vraiment une résonance et a probablement une origine différente - soit mécanique, soit un problème d'extrudeuse. Ce problème doit être résolu avant d'activer et de régler les façonneurs d'entrée.</p>
-<p>Si les mesures ne sont pas fiables parce que, par exemple, la distance entre les oscillations n'est pas stable, cela peut signifier que l'imprimante a plusieurs fréquences de résonance sur le même axe. On peut essayer de suivre le processus de réglage décrit dans la section <a href="#unreliable-measurements-of-ringing-frequencies">Mesures peu fiables des fréquences de résonance</a> à la place et obtenir quand même quelque chose de la technique de mise en forme de l'entrée.</p>
-<p>La fréquence de résonance peut dépendre de la position du modèle sur la plaque de construction et de la hauteur Z, <em>surtout sur les imprimantes delta</em> ; vous pouvez vérifier si vous observez des différences de fréquences à différentes positions le long des côtés du modèle de test et à différentes hauteurs. Vous pouvez calculer les fréquences de résonance moyennes sur les axes X et Y si c'est le cas.</p>
-<p>Si la fréquence de résonance mesurée est très basse (inférieure à 20-25 Hz environ), il peut être judicieux d'investir dans le raidissement de l'imprimante ou la réduction de la masse mobile - selon ce qui est applicable dans votre cas - avant de poursuivre le réglage de la mise en forme de l'entrée et de mesurer à nouveau les fréquences par la suite. Pour de nombreux modèles d'imprimantes populaires, il existe souvent des solutions déjà disponibles.</p>
+<p>Notez que la résonance sur l'impression de test devrait suivre les encoches courbées de la pièce, comme dans l'image ci-dessus. Si ce n'est pas le cas, alors ce défaut n'est pas vraiment une résonance et a probablement une origine différente - soit mécanique, soit un problème d'extrudeuse. Ce problème doit être résolu avant d'activer et de régler les input shapers.</p>
+<p>Si les mesures ne sont pas fiables parce que, par exemple, la distance entre les oscillations n'est pas régulière, cela peut signifier que l'imprimante a plusieurs fréquences de résonance sur le même axe. On peut essayer de suivre le processus de réglage décrit dans la section <a href="#unreliable-measurements-of-ringing-frequencies">Mesures peu fiables des fréquences de résonance</a> à la place et obtenir quand même une amélioration grâce à l'input shaping.</p>
+<p>La fréquence de résonance peut dépendre de la position du modèle sur le plateau et de la hauteur Z, <em>surtout sur les imprimantes delta</em> ; vous pouvez vérifier si vous observez des différences de fréquences à différentes positions le long des côtés du modèle de test et à différentes hauteurs. Si c'est le cas, vous pouvez calculer les fréquences de résonance moyennes sur les axes X et Y.</p>
+<p>Si la fréquence de résonance mesurée est très basse (inférieure à 20-25 Hz), il peut être judicieux de penser à rigidifier la structure de l'imprimante ou à réduire la masse mobile - dans la mesure du possible - avant de poursuivre le réglage de l'input shaping et de mesurer à nouveau les fréquences. Pour de nombreux modèles d'imprimantes populaires, il existe souvent des solutions déjà disponibles.</p>
 <p>Les fréquences de résonance peuvent changer si des modifications sont apportées à l'imprimante qui affectent la masse en mouvement ou modifient la rigidité du système, par exemple :</p>
 <ul>
 <li>Si la tête d'impression est modifiée, par ex. changement de moteur pas à pas (plus lourd ou plus léger) pour une extrusion directe, remplacement de la tête de l'outil (plus ou moins lourde), ajout d'un ventilateur plus lourd, etc.</li>
@@ -1586,18 +1586,18 @@
 <li>Des pièces conçues pour augmenter la rigidité du cadre sont installées.</li>
 <li>Un plateau différent est installé sur une imprimante à lit mobile, ou une plaque de verre est ajoutée, etc.</li>
 </ul>
-<p>Si de tels changements sont apportés, Il est conseillé de mesurer au moins les fréquences de résonance pour vérifier s'il y a eu un changement ou pas.</p>
-<h3 id="configuration-de-linput-shaper">Configuration de l'"input shaper"<a class="headerlink" href="#configuration-de-linput-shaper" title="Permanent link">&para;</a></h3>
-<p>Une fois les fréquences de résonance des axes X et Y mesurées, vous pouvez ajouter la section suivante à votre <code>printer.cfg</code> :</p>
+<p>Si de telles modifications sont apportées, Il est conseillé - au minimum - de mesurer les fréquences de résonance pour vérifier s'il elles ont changées (ou pas).</p>
+<h3 id="configuration-de-linput-shaper">Configuration de l'input shaper<a class="headerlink" href="#configuration-de-linput-shaper" title="Permanent link">&para;</a></h3>
+<p>Une fois les fréquences de résonance des axes X et Y mesurées, vous pouvez ajouter la section suivante à votre fichier <code>printer.cfg</code> :</p>
 <div class="highlight"><pre><span></span><code>[input_shaper]
 shaper_freq_x: ...    # frequence pour la marque X sur le modèle de test
 shaper_freq_y: ...    # frequence pour la marque Y sur le modèle de test
 </code></pre></div>
 
 <p>Pour l'exemple ci-dessus, nous obtenons shaper_freq_x/y = 49,4.</p>
-<h3 id="choix-de-linput-shaper">Choix de l'"input shaper"<a class="headerlink" href="#choix-de-linput-shaper" title="Permanent link">&para;</a></h3>
+<h3 id="choix-de-linput-shaper">Choix de l'input shaper<a class="headerlink" href="#choix-de-linput-shaper" title="Permanent link">&para;</a></h3>
 <p>Klipper prend en charge plusieurs type d'"input shaper". Ils diffèrent par leur sensibilité aux erreurs déterminant la fréquence de résonance et le degré de lissage qu'ils provoquent dans les pièces imprimées. De plus, certains de ces "input shaper" comme 2HUMP_EI et 3HUMP_EI ne doivent généralement pas être utilisés avec shaper_freq = fréquence de résonance - ils sont configurés à partir de différentes considérations pour réduire plusieurs résonances à la fois (ndt : le 2HUMP_EI est à utiliser lorsque deux pics de résonance sont détectés, le 3HUMP_EI est à utiliser lorsque trois pics de résonance sont détectés).</p>
-<p>Pour la plupart des imprimantes, les shapers MZV ou EI peuvent être recommandés. Cette section décrit un processus de test pour choisir entre eux et déterminer quelques autres paramètres connexes.</p>
+<p>Pour la plupart des imprimantes, les types MZV ou EI sont recommandés. Cette section décrit un processus de test pour choisir entre eux et déterminer quelques autres paramètres connexes.</p>
 <p>Imprimez le modèle de test de résonance comme suit :</p>
 <ol>
 <li>Redémarrez le micrologiciel : <code>RESTART</code></li>
@@ -1605,12 +1605,12 @@ shaper_freq_y: ...    # frequence pour la marque Y sur le modèle de test
 <li>Désactivez l'avance de pression : <code>SET_PRESSURE_ADVANCE ADVANCE=0</code></li>
 <li>Exécutez : <code>SET_INPUT_SHAPER SHAPER_TYPE=MZV</code></li>
 <li>Exécutez la commande : <code>TUNING_TOWER COMMAND=SET_VELOCITY_LIMIT PARAMETER=ACCEL START=1500 STEP_DELTA=500 STEP_HEIGHT=5</code></li>
-<li>Imprimez le modèle de test tranché avec les paramètres suggérés.</li>
+<li>Imprimez le modèle de test tranché avec les paramètres indiqués.</li>
 </ol>
-<p>Si vous ne voyez pas de résonance à ce stade, l'utilisation de l'"input shaper" MZV peut être recommandée.</p>
+<p>Si vous ne voyez pas de résonance à ce stade, l'utilisation du type MZV peut être recommandée.</p>
 <p>Si vous voyez une résonance, mesurez à nouveau les fréquences en suivant les étapes (8) à (10) décrites dans la section <a href="#ringing-frequency">Fréquence de résonance</a>. Si les fréquences diffèrent considérablement des valeurs obtenues précédemment, une configuration d'input shaper plus complexe est nécessaire. Vous pouvez vous référer aux détails techniques de la section <a href="#input-shapers">Input shapers</a>. Sinon, passez à l'étape suivante.</p>
 <p>Essayez l'input shaper EI. Pour l'essayer, répétez les étapes (1) à (6) ci-dessus, mais en exécutant à l'étape 4 la commande suivante à la place : <code>SET_INPUT_SHAPER SHAPER_TYPE=EI</code>.</p>
-<p>Comparez deux impressions avec les input shaper MZV et EI. Si EI montre des résultats sensiblement meilleurs que MZV, utilisez EI, sinon préférez MZV. Notez que le input shaper EI provoquera plus de lissage dans les pièces imprimées (voir la section suivante pour plus de détails). Ajoutez le paramètre <code>shaper_type: mzv</code> (ou ei) à la section [input_shaper], par exemple :</p>
+<p>Comparez deux impressions avec les types MZV et EI. Si EI montre des résultats sensiblement meilleurs que MZV, utilisez EI, sinon préférez MZV. Notez que le type EI provoquera plus de lissage dans les pièces imprimées (voir la section suivante pour plus de détails). Ajoutez le paramètre <code>shaper_type: mzv</code> (ou ei) à la section [input_shaper], par exemple :</p>
 <div class="highlight"><pre><span></span><code>[input_shaper]
 shaper_freq_x: ...
 shaper_freq_y: ...
@@ -1619,18 +1619,18 @@ shaper_type: mzv
 
 <p>Quelques notes sur le choix de l'input shaper :</p>
 <ul>
-<li>L' input shaper EI peut être plus adapté aux imprimantes à lit mobile (si la fréquence de résonance et le lissage résultant le permettent) : plus le filament est déposé sur le lit en mouvement, plus la masse du lit augmente et la fréquence de résonance diminue. Étant donné que le input shaper EI est plus robuste aux changements de fréquence de résonance, il peut mieux fonctionner lors de l'impression de grandes pièces.</li>
-<li>En raison de la nature de la cinématique delta, les fréquences de résonance peuvent différer considérablement dans différentes parties du volume de construction. Par conséquent, l'input shaper EI peut être mieux adapté aux imprimantes delta plutôt que MZV ou ZV. Si la fréquence de résonance est suffisamment grande (plus de 50-60 Hz), alors on peut même essayer de tester 2HUMP_EI (en exécutant le test suggéré ci-dessus avec <code>SET_INPUT_SHAPER SHAPER_TYPE=2HUMP_EI</code>), mais vérifiez les considérations dans la <a href="#selecting-max_accel">section ci-dessous</a> avant de l'activer.</li>
+<li>Le type EI peut être plus adapté aux imprimantes à lit mobile (si la fréquence de résonance et le lissage résultant le permettent) : plus le filament est déposé sur le lit en mouvement, plus la masse du lit augmente et la fréquence de résonance diminue. Étant donné que le type EI est plus robuste aux changements de fréquence de résonance, il peut être plus efficace lors de l'impression de grandes pièces.</li>
+<li>En raison de la nature de la cinématique delta, les fréquences de résonance peuvent différer considérablement dans différentes parties du volume de construction. Par conséquent, le type EI peut être mieux adapté aux imprimantes delta plutôt que MZV ou ZV. Si la fréquence de résonance est suffisamment grande (plus de 50-60 Hz), alors on peut même essayer de tester 2HUMP_EI (en exécutant le test suggéré ci-dessus avec <code>SET_INPUT_SHAPER SHAPER_TYPE=2HUMP_EI</code>), mais vérifiez les considérations dans la <a href="#selecting-max_accel">section ci-dessous</a> avant de l'activer.</li>
 </ul>
 <h3 id="selection-de-max_accel">Sélection de max_accel<a class="headerlink" href="#selection-de-max_accel" title="Permanent link">&para;</a></h3>
 <p>Vous devriez obtenir le test imprimé avec l'input shaper choisi à l'étape précédente (si vous ne le faites pas, imprimez le modèle de test découpé avec les <a href="#tuning">paramètres suggérés</a> avec l'avance de pression désactivée <code>SET_PRESSURE_ADVANCE ADVANCE=0</code> et avec la tour de réglage activée comme <code>TUNING_TOWER COMMAND=SET_VELOCITY_LIMIT PARAMETER=ACCEL START=1500 STEP_DELTA=500 STEP_HEIGHT=5</code>). Notez qu'à des accélérations très élevées, selon la fréquence de résonance et l'input shaper choisi (par exemple, le shaper EI crée plus de lissage que MZV), cela peut provoquer trop de lissage et d'arrondi des pièces. Ainsi, max_accel doit être choisi de manière à l'éviter. Un autre paramètre ayant un impact sur le lissage est <code>square_corner_velocity</code>, il n'est donc pas conseillé de l'augmenter au-dessus de la valeur par défaut de 5 mm/s pour éviter un lissage accru.</p>
-<p>Afin de sélectionner une valeur max_accel appropriée, inspectez le modèle pour l'input shaper choisi. Tout d'abord, notez à quelle accélération la résonance est encore faible - convenant également à l'imprimante.</p>
+<p>Afin de sélectionner une valeur correcte pour max_accel, inspectez le modèle imprimé pour l'input shaper choisi. Tout d'abord, notez à quelle accélération la résonance reste imperceptible.</p>
 <p>Ensuite, vérifiez le lissage. Pour vous aider, le modèle de test a un petit espace dans la paroi (0,15 mm) :</p>
 <p><img alt="Ecart de test" src="img/smoothing-test.png" /></p>
 <p>À mesure que l'accélération augmente, le lissage augmente également et l'espacement réel dans l'impression s'élargit :</p>
 <p><img alt="Lissage de l'input shaper" src="img/shaper-smoothing.jpg" /></p>
 <p>Sur cette image, l'accélération augmente de gauche à droite, et l'écart commence à croître à partir de 3500 mm/s² (5ème bande à partir de la gauche). Dans ce cas, la valeur pour max_accel = 3000 (mm/s²) permet d'éviter un lissage excessif.</p>
-<p>Notez l'accélération lorsque l'écart est encore très faible dans votre test d'impression. Si vous voyez des renflements, mais aucun espace dans le mur, même à des accélérations élevées, cela peut être dû à une avance de pression (PA) désactivée, en particulier sur les extrudeurs de type Bowden. Si tel est le cas, vous devrez peut-être répéter l'impression avec le PA activé. Cela peut également être le résultat d'un flux de filament mal calibré (trop élevé), il faut donc vérifier cela aussi.</p>
+<p>Notez l'accélération lorsque l'écart est encore très faible dans votre test d'impression. Si vous voyez des renflements, mais aucun espace dans le mur, même à des accélérations élevées, cela peut être dû à une avance de pression (PA) désactivée, en particulier sur les extrudeurs de type Bowden. Si tel est le cas, vous devrez peut-être relancer l'impression avec le PA activé. Cela peut également être le résultat d'un extrudeur mal calibré (trop élevé), il faut donc vérifier cela aussi.</p>
 <p>Choisissez la valeur minimale des deux valeurs d'accélération (de la résonance et du lissage) et affectez-là à <code>max_accel</code> dans printer.cfg.</p>
 <p>Notez qu'il peut arriver - en particulier à des fréquences de résonance basses - que l'input shaper EI provoque trop de lissage, même à des accélérations faibles. Dans ce cas, MZV peut être un meilleur choix, car il peut permettre des valeurs d'accélération plus élevées.</p>
 <p>À des fréquences de résonance très basses (~ 25 Hz et moins), même l'input shaper MZV peut créer trop de lissage. Si tel est le cas, vous pouvez également essayer de répéter les étapes de la section <a href="#choosing-input-shaper">Choix de l'input shaper</a> avec l'input shaper ZV, en utilisant la commande <code>SET_INPUT_SHAPER SHAPER_TYPE=ZV</code> à la place. L'input shaper ZV devrait montrer encore moins de lissage que MZV, mais il est plus sensible aux erreurs de mesure des fréquences de résonance.</p>
diff --git a/fr/Rotation_Distance.html b/fr/Rotation_Distance.html
index d646db0e5..0908629f6 100644
--- a/fr/Rotation_Distance.html
+++ b/fr/Rotation_Distance.html
@@ -731,14 +731,14 @@
       
       
         <label class="md-nav__link" for="__nav_7_5">
-          Compensation de résonance
+          Compensation de la résonance
           <span class="md-nav__icon md-icon"></span>
         </label>
       
-      <nav class="md-nav" aria-label="Compensation de résonance" data-md-level="2">
+      <nav class="md-nav" aria-label="Compensation de la résonance" data-md-level="2">
         <label class="md-nav__title" for="__nav_7_5">
           <span class="md-nav__icon md-icon"></span>
-          Compensation de résonance
+          Compensation de la résonance
         </label>
         <ul class="md-nav__list" data-md-scrollfix>
           
@@ -749,7 +749,7 @@
   
     <li class="md-nav__item">
       <a href="Resonance_Compensation.html" class="md-nav__link">
-        Compensation de résonance
+        Compensation de la résonance
       </a>
     </li>
   
diff --git a/fr/SDCard_Updates.html b/fr/SDCard_Updates.html
index 6d3aeb4d4..e9b5a6b0d 100644
--- a/fr/SDCard_Updates.html
+++ b/fr/SDCard_Updates.html
@@ -638,14 +638,14 @@
       
       
         <label class="md-nav__link" for="__nav_7_5">
-          Compensation de résonance
+          Compensation de la résonance
           <span class="md-nav__icon md-icon"></span>
         </label>
       
-      <nav class="md-nav" aria-label="Compensation de résonance" data-md-level="2">
+      <nav class="md-nav" aria-label="Compensation de la résonance" data-md-level="2">
         <label class="md-nav__title" for="__nav_7_5">
           <span class="md-nav__icon md-icon"></span>
-          Compensation de résonance
+          Compensation de la résonance
         </label>
         <ul class="md-nav__list" data-md-scrollfix>
           
@@ -656,7 +656,7 @@
   
     <li class="md-nav__item">
       <a href="Resonance_Compensation.html" class="md-nav__link">
-        Compensation de résonance
+        Compensation de la résonance
       </a>
     </li>
   
diff --git a/fr/Skew_Correction.html b/fr/Skew_Correction.html
index f535aa1c1..2f973076c 100644
--- a/fr/Skew_Correction.html
+++ b/fr/Skew_Correction.html
@@ -640,14 +640,14 @@
       
       
         <label class="md-nav__link" for="__nav_7_5">
-          Compensation de résonance
+          Compensation de la résonance
           <span class="md-nav__icon md-icon"></span>
         </label>
       
-      <nav class="md-nav" aria-label="Compensation de résonance" data-md-level="2">
+      <nav class="md-nav" aria-label="Compensation de la résonance" data-md-level="2">
         <label class="md-nav__title" for="__nav_7_5">
           <span class="md-nav__icon md-icon"></span>
-          Compensation de résonance
+          Compensation de la résonance
         </label>
         <ul class="md-nav__list" data-md-scrollfix>
           
@@ -658,7 +658,7 @@
   
     <li class="md-nav__item">
       <a href="Resonance_Compensation.html" class="md-nav__link">
-        Compensation de résonance
+        Compensation de la résonance
       </a>
     </li>
   
diff --git a/fr/Slicers.html b/fr/Slicers.html
index 607986aa1..f3af3167b 100644
--- a/fr/Slicers.html
+++ b/fr/Slicers.html
@@ -640,14 +640,14 @@
       
       
         <label class="md-nav__link" for="__nav_7_5">
-          Compensation de résonance
+          Compensation de la résonance
           <span class="md-nav__icon md-icon"></span>
         </label>
       
-      <nav class="md-nav" aria-label="Compensation de résonance" data-md-level="2">
+      <nav class="md-nav" aria-label="Compensation de la résonance" data-md-level="2">
         <label class="md-nav__title" for="__nav_7_5">
           <span class="md-nav__icon md-icon"></span>
-          Compensation de résonance
+          Compensation de la résonance
         </label>
         <ul class="md-nav__list" data-md-scrollfix>
           
@@ -658,7 +658,7 @@
   
     <li class="md-nav__item">
       <a href="Resonance_Compensation.html" class="md-nav__link">
-        Compensation de résonance
+        Compensation de la résonance
       </a>
     </li>
   
diff --git a/fr/Sponsors.html b/fr/Sponsors.html
index 577b4c186..e6332df1d 100644
--- a/fr/Sponsors.html
+++ b/fr/Sponsors.html
@@ -638,14 +638,14 @@
       
       
         <label class="md-nav__link" for="__nav_7_5">
-          Compensation de résonance
+          Compensation de la résonance
           <span class="md-nav__icon md-icon"></span>
         </label>
       
-      <nav class="md-nav" aria-label="Compensation de résonance" data-md-level="2">
+      <nav class="md-nav" aria-label="Compensation de la résonance" data-md-level="2">
         <label class="md-nav__title" for="__nav_7_5">
           <span class="md-nav__icon md-icon"></span>
-          Compensation de résonance
+          Compensation de la résonance
         </label>
         <ul class="md-nav__list" data-md-scrollfix>
           
@@ -656,7 +656,7 @@
   
     <li class="md-nav__item">
       <a href="Resonance_Compensation.html" class="md-nav__link">
-        Compensation de résonance
+        Compensation de la résonance
       </a>
     </li>
   
diff --git a/fr/Status_Reference.html b/fr/Status_Reference.html
index 66c56fafd..d77c327c8 100644
--- a/fr/Status_Reference.html
+++ b/fr/Status_Reference.html
@@ -640,14 +640,14 @@
       
       
         <label class="md-nav__link" for="__nav_7_5">
-          Compensation de résonance
+          Compensation de la résonance
           <span class="md-nav__icon md-icon"></span>
         </label>
       
-      <nav class="md-nav" aria-label="Compensation de résonance" data-md-level="2">
+      <nav class="md-nav" aria-label="Compensation de la résonance" data-md-level="2">
         <label class="md-nav__title" for="__nav_7_5">
           <span class="md-nav__icon md-icon"></span>
-          Compensation de résonance
+          Compensation de la résonance
         </label>
         <ul class="md-nav__list" data-md-scrollfix>
           
@@ -658,7 +658,7 @@
   
     <li class="md-nav__item">
       <a href="Resonance_Compensation.html" class="md-nav__link">
-        Compensation de résonance
+        Compensation de la résonance
       </a>
     </li>
   
diff --git a/fr/TMC_Drivers.html b/fr/TMC_Drivers.html
index b18154627..66ff43b07 100644
--- a/fr/TMC_Drivers.html
+++ b/fr/TMC_Drivers.html
@@ -640,14 +640,14 @@
       
       
         <label class="md-nav__link" for="__nav_7_5">
-          Compensation de résonance
+          Compensation de la résonance
           <span class="md-nav__icon md-icon"></span>
         </label>
       
-      <nav class="md-nav" aria-label="Compensation de résonance" data-md-level="2">
+      <nav class="md-nav" aria-label="Compensation de la résonance" data-md-level="2">
         <label class="md-nav__title" for="__nav_7_5">
           <span class="md-nav__icon md-icon"></span>
-          Compensation de résonance
+          Compensation de la résonance
         </label>
         <ul class="md-nav__list" data-md-scrollfix>
           
@@ -658,7 +658,7 @@
   
     <li class="md-nav__item">
       <a href="Resonance_Compensation.html" class="md-nav__link">
-        Compensation de résonance
+        Compensation de la résonance
       </a>
     </li>
   
diff --git a/fr/TSL1401CL_Filament_Width_Sensor.html b/fr/TSL1401CL_Filament_Width_Sensor.html
index 8fc0c0a00..4e00bac22 100644
--- a/fr/TSL1401CL_Filament_Width_Sensor.html
+++ b/fr/TSL1401CL_Filament_Width_Sensor.html
@@ -638,14 +638,14 @@
       
       
         <label class="md-nav__link" for="__nav_7_5">
-          Compensation de résonance
+          Compensation de la résonance
           <span class="md-nav__icon md-icon"></span>
         </label>
       
-      <nav class="md-nav" aria-label="Compensation de résonance" data-md-level="2">
+      <nav class="md-nav" aria-label="Compensation de la résonance" data-md-level="2">
         <label class="md-nav__title" for="__nav_7_5">
           <span class="md-nav__icon md-icon"></span>
-          Compensation de résonance
+          Compensation de la résonance
         </label>
         <ul class="md-nav__list" data-md-scrollfix>
           
@@ -656,7 +656,7 @@
   
     <li class="md-nav__item">
       <a href="Resonance_Compensation.html" class="md-nav__link">
-        Compensation de résonance
+        Compensation de la résonance
       </a>
     </li>
   
diff --git a/fr/Using_PWM_Tools.html b/fr/Using_PWM_Tools.html
index 2c0bc8472..ce42a3328 100644
--- a/fr/Using_PWM_Tools.html
+++ b/fr/Using_PWM_Tools.html
@@ -640,14 +640,14 @@
       
       
         <label class="md-nav__link" for="__nav_7_5">
-          Compensation de résonance
+          Compensation de la résonance
           <span class="md-nav__icon md-icon"></span>
         </label>
       
-      <nav class="md-nav" aria-label="Compensation de résonance" data-md-level="2">
+      <nav class="md-nav" aria-label="Compensation de la résonance" data-md-level="2">
         <label class="md-nav__title" for="__nav_7_5">
           <span class="md-nav__icon md-icon"></span>
-          Compensation de résonance
+          Compensation de la résonance
         </label>
         <ul class="md-nav__list" data-md-scrollfix>
           
@@ -658,7 +658,7 @@
   
     <li class="md-nav__item">
       <a href="Resonance_Compensation.html" class="md-nav__link">
-        Compensation de résonance
+        Compensation de la résonance
       </a>
     </li>
   
diff --git a/fr/_klipper3d/__pycache__/mkdocs_hooks.cpython-38.pyc b/fr/_klipper3d/__pycache__/mkdocs_hooks.cpython-38.pyc
index 5da67cbb5f7b316a897b1f45ea74add26d185cdc..406a5b31d8ec56dfda96532a8fe45345f0518786 100644
GIT binary patch
delta 20
acmcc4ex02=l$V!_0SH3pKHSKCh8X}iVg;W7

delta 20
acmcc4ex02=l$V!_0SIn6KiJ59h8X}j<ORt9

diff --git a/fr/_klipper3d/mkdocs-lang-fr.yml b/fr/_klipper3d/mkdocs-lang-fr.yml
index 52879899f..a5d34e6d9 100644
--- a/fr/_klipper3d/mkdocs-lang-fr.yml
+++ b/fr/_klipper3d/mkdocs-lang-fr.yml
@@ -116,7 +116,7 @@ nav:
       - Manual_Level.md
       - Bed_Mesh.md
       - Endstop_Phase.md
-    - Compensation de résonance:
+    - Compensation de la résonance:
       - Resonance_Compensation.md
       - Measuring_Resonances.md
     - Pressure_Advance.md
diff --git a/fr/index.html b/fr/index.html
index 98ac27b57..9d7a58d8c 100644
--- a/fr/index.html
+++ b/fr/index.html
@@ -633,14 +633,14 @@
       
       
         <label class="md-nav__link" for="__nav_7_5">
-          Compensation de résonance
+          Compensation de la résonance
           <span class="md-nav__icon md-icon"></span>
         </label>
       
-      <nav class="md-nav" aria-label="Compensation de résonance" data-md-level="2">
+      <nav class="md-nav" aria-label="Compensation de la résonance" data-md-level="2">
         <label class="md-nav__title" for="__nav_7_5">
           <span class="md-nav__icon md-icon"></span>
-          Compensation de résonance
+          Compensation de la résonance
         </label>
         <ul class="md-nav__list" data-md-scrollfix>
           
@@ -651,7 +651,7 @@
   
     <li class="md-nav__item">
       <a href="Resonance_Compensation.html" class="md-nav__link">
-        Compensation de résonance
+        Compensation de la résonance
       </a>
     </li>
   
diff --git a/fr/search/search_index.json b/fr/search/search_index.json
index 01b34f688..93b95d7f6 100644
--- a/fr/search/search_index.json
+++ b/fr/search/search_index.json
@@ -1 +1 @@
-{"config":{"indexing":"full","lang":["fr"],"min_search_length":3,"prebuild_index":false,"separator":"[\\s\\-]+"},"docs":[{"location":"index.html","text":"hide: toc title: Bienvenue Klipper est un microprogramme pour imprimante 3D. Il combine la puissance d'un ordinateur classique avec un ou plusieurs microcontr\u00f4leurs. Consultez le document Fonctionnalit\u00e9s pour plus d'informations sur les raisons pour lesquelles vous devriez utiliser Klipper. Pour commencer \u00e0 utiliser Klipper, commencez par effectuer l' installation . Klipper est un logiciel libre. Lisez sa documentation ou consultez le code de Klipper sur github . Nous d\u00e9pendons du soutien g\u00e9n\u00e9reux de nos sponsors .","title":"Home"},{"location":"API_Server.html","text":"Serveur API \u00b6 Ce document d\u00e9crit l'Interface de Programmation d'Applications (API) de Klipper. Cette interface permet \u00e0 des applications externes d'interroger et de contr\u00f4ler Klipper. Activer le socket API \u00b6 Pour pouvoir utiliser les Serveur API, le logiciel h\u00f4te klippy.py doit \u00eatre d\u00e9marr\u00e9 avec le param\u00e8tre -a . Par exemple : ~/klippy-env/bin/python ~/klipper/klippy/klippy.py ~/printer.cfg -a /tmp/klippy_uds -l /tmp/klippy.log Cela force le logiciel h\u00f4te \u00e0 cr\u00e9er un socket de domaine Unix. Un client peut alors ouvrir une connexion sur ce socket et envoyer des commandes \u00e0 Klipper. Voir le projet Moonraker pour un outil populaire qui peut transf\u00e9rer les requ\u00eates HTTP vers le socket du serveur d'API de Klipper. Format de la demande \u00b6 Les messages envoy\u00e9s et re\u00e7us sur le socket sont des cha\u00eenes au format JSON et termin\u00e9es par le caract\u00e8re ASCII 0x03 : <json_object_1><0x03><json_object_2><0x03>... Klipper contiens un outil scripts/whconsole.py qui peut effectuer la mise en forme du message ci-dessus. Par exemple : ~/klipper/scripts/whconsole.py /tmp/klippy_uds Cet outil peut lire une s\u00e9rie de commandes JSON \u00e0 partir de l'entr\u00e9e standard stdin, les envoyer \u00e0 Klipper et afficher les r\u00e9sultats. Cet outil s'attend \u00e0 avoir une commande JSON par ligne et il ajoute automatiquement le terminateur 0x03 avant d'envoyer les requ\u00eates. (Le serveur d'API de Klipper ne attend pas un saut de ligne.) Protocole de l'API \u00b6 Le protocole de commande utilis\u00e9 sur le socket de communications est inspir\u00e9 par json-rpc . Une requ\u00eate pourrait ressembler \u00e0 \u00e7a : {\"id\": 123, \"method\": \"info\", \"params\": {}} et une r\u00e9ponse pourrait ressembler \u00e0 \u00e7a : {\"id\": 123, \"result\": {\"state_message\": \"Printer is ready\", \"klipper_path\": \"/home/pi/klipper\", \"config_file\": \"/home/pi/printer.cfg\", \"software_version\": \"v0.8.0-823-g883b1cb6\", \"hostname\": \"octopi\", \"cpu_info\": \"4 core ARMv7 Processor rev 4 (v7l)\", \"state\": \"ready\", \"python_path\": \"/home/pi/klippy-env/bin/python\", \"log_file\": \"/tmp/klippy.log\"}} Toutes les requ\u00eates doivent \u00eatre un dictionnaire JSON. (Ce document utilise le terme Python 'dictionary' pour d\u00e9crire un objet JSON - une affectation de paires Cl\u00e9/Valeur comprises en deux parenth\u00e8ses {} .) le dictionnaire de requ\u00eate doit contenir un param\u00e8tre \"m\u00e9thode\" disponible dans les \"points de terminaison\" de Klipper. Le dictionnaire de requ\u00eate peut contenir un param\u00e8tre \"params\" qui doit \u00eatre de type dictionnaire. Les \"params\" fournissent des informations de param\u00e8tre suppl\u00e9mentaires au \"endpoint\" Klipper qui traite la demande. Son contenu est sp\u00e9cifique au \"endpoint\". Le dictionnaire de requ\u00eate peut contenir un param\u00e8tre \"id\" qui peut \u00eatre de n'importe quel type JSON. Si \"id\" est pr\u00e9sent, alors Klipper r\u00e9pondra \u00e0 la demande avec une r\u00e9ponse contenant cet \"id\". Si \"id\" est omis (ou d\u00e9fini sur une valeur JSON \"null\"), Klipper ne fournira aucune r\u00e9ponse \u00e0 la requ\u00eate. Un message de r\u00e9ponse est un dictionnaire JSON contenant \"id\" et \"result\". Le \"r\u00e9sultat\" est toujours un dictionnaire - son contenu est sp\u00e9cifique au \"endpoint\" traitant la demande. Si le traitement d'un requ\u00eate est en erreur, le message de r\u00e9ponse contiendra un champ \"error\" au lieu de \"result\". Par exemple, la requ\u00eate : {\"id\": 123, \"method\": \"gcode/script\", \"params\": {\"script\": \"G1 X200\"}} pourrait retourner une erreur telle que :: {\"id\": 123, \"error\": {\"message\": \"Must home axis first: 200.000 0.000 0.000 [0.000]\", \"error\": \"WebRequestError\"}} Klipper traite toujours les demandes dans l'ordre de leur r\u00e9ception. Cependant, certaines requ\u00eates peuvent ne pas se terminer imm\u00e9diatement, ce qui peut entra\u00eener l'envoi de la r\u00e9ponse associ\u00e9e dans le d\u00e9sordre par rapport aux r\u00e9ponses d'autres requ\u00eates. Une requ\u00eate JSON ne suspend jamais le traitement des requ\u00eates JSON suivantes. Abonnements \u00b6 Certains \"endpoint\" de Klipper autorisent un \"abonnement\" pour de futurs messages asynchrone de mise \u00e0 jour. Par exemple : {\"id\": 123, \"method\": \"gcode/subscribe_output\", \"params\": {\"response_template\":{\"key\": 345}}} Peut r\u00e9pondre dans un premier temps : {\"id\": 123, \"result\": {}} et faire en sorte que Klipper envoie de futurs messages similaires \u00e0 : {\"params\": {\"response\": \"ok B:22.8 /0.0 T0:22.4 /0.0\"}, \"key\": 345} Une demande d'abonnement accepte un dictionnaire \"response_template\" dans le champ \"params\" de la demande. Ce dictionnaire \"response_template\" est utilis\u00e9 comme mod\u00e8le pour les futurs messages asynchrones - il peut contenir des paires cl\u00e9/valeur arbitraires. Lors de l'envoi de ces futurs messages asynchrones, Klipper ajoutera un champ \"params\" contenant un dictionnaire avec un contenu sp\u00e9cifique \"endpoint\" au mod\u00e8le de r\u00e9ponse, puis enverra ce mod\u00e8le. Si un champ \"response_template\" n'est pas fourni, il s'agit par d\u00e9faut d'un dictionnaire vide ( {} ). \"endpoints\" disponibles \u00b6 Par convention, les \"endpoints\" de Klipper sont de la forme <module_name>/<some_name> . Lors d'une demande \u00e0 un \"endpoint\", le nom complet doit \u00eatre d\u00e9fini dans le param\u00e8tre \"method\" du dictionnaire de requ\u00eate (par exemple, {\"method\"=\"gcode/restart\"} ). Info \u00b6 Le point de terminaison \"info\" est utilis\u00e9 pour obtenir des informations sur le syst\u00e8me et la version de Klipper. Il est \u00e9galement utilis\u00e9 pour fournir les informations de version du client \u00e0 Klipper. Par exemple : {\"id\": 123, \"method\": \"info\", \"params\": { \"client_info\": { \"version\": \"v1\"}}} S'il est pr\u00e9sent, le param\u00e8tre \"client_info\" doit \u00eatre un dictionnaire, mais ce dictionnaire peut avoir un contenu arbitraire. Les clients sont encourag\u00e9s \u00e0 fournir le nom du client et sa version logicielle lors de la premi\u00e8re connexion au serveur API Klipper. arr\u00eat d'urgence \u00b6 Le point de terminaison \"emergency_stop\" est utilis\u00e9 pour demander \u00e0 Klipper de passer \u00e0 un \u00e9tat \"shutdown\". Il se comporte de la m\u00eame mani\u00e8re que la commande G-Code M112 . Par exemple : {\"id\": 123, \"method\": \"emergency_stop\"} register_remote_method \u00b6 Ce point de terminaison permet aux clients d'enregistrer des m\u00e9thodes pouvant \u00eatre appel\u00e9es depuis klipper. Il renverra un objet vide en cas de succ\u00e8s. Par exemple : {\"id\": 123, \"method\": \"register_remote_method\", \"params\": {\"response_template\": {\"action\": \"run_paneldue_beep\"}, \"remote_method\": \"paneldue_beep\"}} renverra : }` La m\u00e9thode distante paneldue_beep peut d\u00e9sormais \u00eatre appel\u00e9e depuis Klipper. Notez que si la m\u00e9thode prend des param\u00e8tres, ils doivent \u00eatre fournis en tant qu'arguments de mots cl\u00e9s. Voici un exemple de la fa\u00e7on dont il peut \u00eatre appel\u00e9 \u00e0 partir d'un gcode_macro : [gcode_macro PANELDUE_BEEP] gcode: {action_call_remote_method(\"paneldue_beep\", frequency=300, duration=1.0)} Lorsque la macro gcode PANELDUE_BEEP est ex\u00e9cut\u00e9e, Klipper enverra ce qui suit sur le socket : {\"action\": \"run_paneldue_beep\", \"params\": {\"frequency\": 300, \"duration\": 1.0}} objects/list \u00b6 Ce point de terminaison remonte la liste des \"objets\" disponibles de l'imprimante que l'on peut interroger (via le point de terminaison \"objects/query\"). Par exemple : {\"id\": 123, \"method\": \"objects/list\"} peut renvoyer : {\"id\": 123, \"result\": {\"objects\": [\" webhooks\", \"configfile\", \"heaters\", \"gcode_move\", \"query_endstops\", \"idle_timeout\", \"toolhead\", \"extruder\"]}} objects/query \u00b6 Ce point de terminaison permet de retrouver des informations \u00e0 partir d'objets de l'imprimante. Par exemple : {\"id\": 123, \"method\": \"objects/query\", \"params\": {\"objects\": {\"toolhead\": [\"position\"], \"webhooks\": null}} } peut renvoyer : {\"id\": 123, \"result\": {\"status\": {\"webhooks\": {\"state\": \"ready\", \"state_message\": \"L'imprimante est pr\u00eate\"} , \"toolhead\": {\"position\": [0.0, 0.0, 0.0, 0.0]}}, \"eventtime\": 3051555.377933684}} Le param\u00e8tre \"objects\" dans la requ\u00eate doit \u00eatre un dictionnaire contenant des objets de l'imprimante \u00e0 interroger - la cl\u00e9 contient le nom de l'objet imprimante et la valeur est soit \"null\" (pour interroger tous les champs) soit une liste de noms de champs. Le message de r\u00e9ponse contiendra un champ \"statut\" contenant un dictionnaire avec les informations demand\u00e9es - la cl\u00e9 contient le nom de l'objet imprimante et la valeur est un dictionnaire contenant ses champs. Le message de r\u00e9ponse contiendra \u00e9galement un champ \"eventtime\" contenant l'horodatage \u00e0 partir duquel la requ\u00eate a \u00e9t\u00e9 prise. Les champs disponibles sont document\u00e9s dans le document R\u00e9f\u00e9rence des \u00e9tats . objects/subscribe \u00b6 Ce point de terminaison permet d'interroger puis de s'abonner \u00e0 des informations provenant d'objets de l'imprimante. La demande et la r\u00e9ponse du point de terminaison sont identiques au point de terminaison \"objects/query\". Par exemple : {\"id\": 123, \"method\": \"objects/subscribe\", \"params\": {\"objects\":{\"toolhead\": [\"position\"], \"webhooks\": [\"state \"]}, \"response_template\":{}}} peut renvoyer : {\"id\": 123, \"result\": {\"status\": {\"webhooks\": {\"state\": \"pr\u00eat\" }, \"toolhead\": {\"position\": [0.0, 0.0, 0.0, 0.0]}}, \"eventtime\": 3052153.382083195}} et entra\u00eener des messages asynchrones ult\u00e9rieurs tels que : {\"params\": {\"status\": {\"webhooks\": {\"state\": \"shutdown\"}}, \"eventtime\": 3052165.418815847}} gcode/help \u00b6 Ce point de terminaison permet de retrouver les commandes G-Code disponibles qui ont une cha\u00eene d'aide d\u00e9finie. Par exemple : {\"id\": 123, \"method\": \"gcode/help\"} peut renvoyer : {\"id\": 123, \"result\": {\"RESTORE_GCODE_STATE\": \"Restaurer un \u00e9tat G-Code pr\u00e9c\u00e9demment enregistr\u00e9\", \"PID_CALIBRATE\": \"Ex\u00e9cuter le test d'\u00e9talonnage PID\", \"QUERY_ADC\": \"Rapport de la derni\u00e8re valeur d'une broche analogique\", ...}} gcode/script \u00b6 Ce point de terminaison permet d'ex\u00e9cuter une s\u00e9rie de commandes G-Code. Par exemple : {\"id\": 123, \"method\": \"gcode/script\", \"params\": {\"script\": \"G90\"}} Si le script G-Code fourni g\u00e9n\u00e8re une erreur, une r\u00e9ponse d'erreur est g\u00e9n\u00e9r\u00e9e. Cependant, si la commande G-Code produit une sortie vers le terminal, cette sortie n'est pas remont\u00e9e dans la r\u00e9ponse. (Utilisez le point de terminaison \"gcode/subscribe_output\" pour obtenir la remont\u00e9e des sortie du terminal G-Code.) Si une commande G-Code est en cours de traitement lorsque cette demande est re\u00e7ue, le script re\u00e7u sera mis en file d'attente. Ce d\u00e9lai peut \u00eatre important (par exemple, si une commande d'attente de temp\u00e9rature de code G est en cours). Le message de r\u00e9ponse JSON est envoy\u00e9 lorsque le traitement du script est enti\u00e8rement termin\u00e9. gcode/restart \u00b6 Ce point de terminaison permet de demander un red\u00e9marrage - il est similaire \u00e0 l'ex\u00e9cution de la commande G-Code \"RESTART\". Par exemple : {\"id\": 123, \"method\": \"gcode/restart\"} Comme pour le point de terminaison \"gcode/script\", ce point de terminaison ne se termine qu'apr\u00e8s la fin de toutes les commandes G-Code en attente. gcode/firmware_restart \u00b6 Ceci est similaire au point de terminaison \"gcode/restart\" - il impl\u00e9mente la commande G-Code \"FIRMWARE_RESTART\". Par exemple : {\"id\": 123, \"method\": \"gcode/firmware_restart\"} Comme pour le point de terminaison \"gcode/script\", ce point de terminaison ne se termine qu'apr\u00e8s la fin de toutes les commandes G-Code en attente. gcode/subscribe_output \u00b6 Ce point de terminaison est utilis\u00e9 pour s'abonner aux messages du terminal G-Code de Klipper. Par exemple : {\"id\": 123, \"method\": \"gcode/subscribe_output\", \"params\": {\"response_template\":{}}} peut ult\u00e9rieurement produire des messages asynchrones tels que : {\"params\": {\"response\": \"// \u00c9tat de Klipper : Arr\u00eat\"}} Ce point de terminaison est destin\u00e9 \u00e0 prendre en charge l'interaction humaine via une interface \"fen\u00eatre de terminal\". L'analyse du contenu de la sortie du terminal G-Code est d\u00e9conseill\u00e9e. Utilisez le point de terminaison \"objects/subscribe\" pour obtenir des mises \u00e0 jour sur l'\u00e9tat de Klipper. motion_report/dump_stepper \u00b6 Ce point de terminaison est utilis\u00e9 pour s'abonner au flux de commandes interne stepper queue_step de Klipper pour un stepper. L'obtention de ces mises \u00e0 jour de mouvement de bas niveau peut \u00eatre utile \u00e0 des fins de diagnostic et de d\u00e9bogage. L'utilisation de ce point de terminaison peut augmenter la charge syst\u00e8me de Klipper. Une requ\u00eate peut ressembler \u00e0 : {\"id\": 123, \"method\":\"motion_report/dump_stepper\", \"params\": {\"name\": \"stepper_x\", \"response_template\": {}}} et peut renvoyer : {\"id\": 123, \"result\": {\"header\": [\"interval\", \"count\", \"add\"]}} et peut produire ult\u00e9rieurement des messages asynchrones tels que : {\"params\": {\"first_clock\": 179601081, \"first_time\": 8.98, \"first_position\": 0, \"last_clock\": 219686097, \"last_time\": 10.984, \"data\": [[179601081, 1, 0 ], [29573, 2, -8685], [16230, 4, -1525], [10559, 6, -160], [10000, 976, 0], [10000, 1000, 0], [10000, 1000, 0], [10000, 1000, 0], [9855, 5, 187], [11632, 4, 1534], [20756, 2, 9442]]}} Le champ \"en-t\u00eate\" dans la r\u00e9ponse initiale \u00e0 la requ\u00eate est utilis\u00e9 pour d\u00e9crire les champs pr\u00e9sents dans les r\u00e9ponses \"donn\u00e9es\" ult\u00e9rieures. motion_report/dump_trapq \u00b6 Ce point de terminaison est utilis\u00e9 pour s'abonner \u00e0 la \"file d'attente de mouvements trap\u00e9zo\u00efdaux\" interne de Klipper. L'obtention de ces mises \u00e0 jour de mouvement de bas niveau peut \u00eatre utile \u00e0 des fins de diagnostic et de d\u00e9bogage. L'utilisation de ce point de terminaison peut augmenter la charge syst\u00e8me de Klipper. Une requ\u00eate peut ressembler \u00e0 : {\"id\": 123, \"method\": \"motion_report/dump_trapq\", \"params\": {\"name\": \"toolhead\", \"response_template\":{}}} et peut renvoyer : {\"id\": 1, \"result\": {\"header\": [\"time\", \"duration\", \"start_velocity\", \"acceleration\", \"start_position\", \"direction\"]}} et peut produire ult\u00e9rieurement des messages asynchrones tels que : {\"params\": {\"data\": [[4.05, 1.0, 0.0, 0.0, [300.0, 0.0, 0.0], [0.0, 0.0, 0.0] ], [5.054, 0.001, 0.0, 3000.0, [300.0, 0.0, 0.0], [-1.0, 0.0, 0.0]]]}} Le champ \"en-t\u00eate\" dans la r\u00e9ponse initiale \u00e0 la requ\u00eate est utilis\u00e9 pour d\u00e9crire les champs pr\u00e9sents dans les r\u00e9ponses \"donn\u00e9es\" ult\u00e9rieures. adxl345/dump_adxl345 \u00b6 Ce point de terminaison est utilis\u00e9 pour s'abonner aux donn\u00e9es de l'acc\u00e9l\u00e9rom\u00e8tre ADXL345. L'obtention de ces mises \u00e0 jour de mouvement de bas niveau peut \u00eatre utile \u00e0 des fins de diagnostic et de d\u00e9bogage. L'utilisation de ce point de terminaison peut augmenter la charge syst\u00e8me de Klipper. Une requ\u00eate peut ressembler \u00e0 : {\"id\": 123, \"method\":\"adxl345/dump_adxl345\", \"params\": {\"sensor\": \"adxl345\", \"response_template\": {}}} et pourrait renvoyer : {\"id\": 123,\"result\":{\"header\":[\"time\",\"x_acceleration\",\"y_acceleration\", \"z_acceleration\"]}} et pourrait plus tard produire des messages asynchrones messages tels que : {\"params\":{\"overflows\":0,\"data\":[[3292.432935,-535.44309,-1529.8374,9561.4], [3292.433256,-382.45935,-1606.32927,9561.48375]]}} Le champ \"en-t\u00eate\" dans la r\u00e9ponse initiale \u00e0 la requ\u00eate est utilis\u00e9 pour d\u00e9crire les champs pr\u00e9sents dans les r\u00e9ponses \"donn\u00e9es\" ult\u00e9rieures. angle/dump_angle \u00b6 Ce point de terminaison est utilis\u00e9 pour s'abonner aux donn\u00e9es du capteur d'angle . L'obtention de ces mises \u00e0 jour de mouvement de bas niveau peut \u00eatre utile \u00e0 des fins de diagnostic et de d\u00e9bogage. L'utilisation de ce point de terminaison peut augmenter la charge syst\u00e8me de Klipper. Une requ\u00eate peut ressembler \u00e0 : {\"id\": 123, \"method\":\"angle/dump_angle\", \"params\": {\"sensor\": \"my_angle_sensor\", \"response_template\": {}}} et peut renvoyer : {\"id\": 123,\"result\":{\"header\":[\"time\",\"angle\"]}} et peut produire ult\u00e9rieurement des messages asynchrones tels que : { \"params\":{\"position_offset\":3.151562,\"errors\":0, \"data\":[[1290.951905,-5063],[1290.952321,-5065]]}} Le champ \"en-t\u00eate\" dans la r\u00e9ponse initiale \u00e0 la requ\u00eate est utilis\u00e9 pour d\u00e9crire les champs pr\u00e9sents dans les r\u00e9ponses \"donn\u00e9es\" ult\u00e9rieures. pause_resume/cancel \u00b6 Ce point final est similaire \u00e0 l'ex\u00e9cution de la commande G-Code \"PRINT_CANCEL\". Par exemple : {\"id\": 123, \"method\": \"pause_resume/cancel\"} Comme pour le point de terminaison \"gcode/script\", ce point de terminaison ne se termine qu'apr\u00e8s la fin de toutes les commandes G-Code en attente. pause_resume/pause \u00b6 Ce point d'entr\u00e9e est similaire \u00e0 l'ex\u00e9cution de la commande G-Code \"PAUSE\". Par exemple : {\"id\": 123, \"method\": \"pause_resume/pause\"} Comme pour le point de terminaison \"gcode/script\", ce point de terminaison ne se termine qu'apr\u00e8s la fin de toutes les commandes G-Code en attente. pause_resume/resume \u00b6 Ce point de terminaison est similaire \u00e0 l'ex\u00e9cution de la commande G-Code \"RESUME\". Par exemple : {\"id\": 123, \"method\": \"pause_resume/resume\"} Comme pour le point de terminaison \"gcode/script\", ce point de terminaison ne se termine qu'apr\u00e8s la fin de toutes les commandes G-Code en attente. query_endstops/status \u00b6 Ce point de terminaison interrogera les fins de course actifs et renverra leur \u00e9tat. Par exemple : {\"id\": 123, \"method\": \"query_endstops/status\"} peut renvoyer : {\"id\": 123, \"result\": {\"y\": \"open \", \"x\": \"open\", \"z\": \"TRIGGERED\"}} Comme pour le point de terminaison \"gcode/script\", ce point de terminaison ne se termine qu'apr\u00e8s la fin de toutes les commandes G-Code en attente.","title":"Serveur API"},{"location":"API_Server.html#serveur-api","text":"Ce document d\u00e9crit l'Interface de Programmation d'Applications (API) de Klipper. Cette interface permet \u00e0 des applications externes d'interroger et de contr\u00f4ler Klipper.","title":"Serveur API"},{"location":"API_Server.html#activer-le-socket-api","text":"Pour pouvoir utiliser les Serveur API, le logiciel h\u00f4te klippy.py doit \u00eatre d\u00e9marr\u00e9 avec le param\u00e8tre -a . Par exemple : ~/klippy-env/bin/python ~/klipper/klippy/klippy.py ~/printer.cfg -a /tmp/klippy_uds -l /tmp/klippy.log Cela force le logiciel h\u00f4te \u00e0 cr\u00e9er un socket de domaine Unix. Un client peut alors ouvrir une connexion sur ce socket et envoyer des commandes \u00e0 Klipper. Voir le projet Moonraker pour un outil populaire qui peut transf\u00e9rer les requ\u00eates HTTP vers le socket du serveur d'API de Klipper.","title":"Activer le socket API"},{"location":"API_Server.html#format-de-la-demande","text":"Les messages envoy\u00e9s et re\u00e7us sur le socket sont des cha\u00eenes au format JSON et termin\u00e9es par le caract\u00e8re ASCII 0x03 : <json_object_1><0x03><json_object_2><0x03>... Klipper contiens un outil scripts/whconsole.py qui peut effectuer la mise en forme du message ci-dessus. Par exemple : ~/klipper/scripts/whconsole.py /tmp/klippy_uds Cet outil peut lire une s\u00e9rie de commandes JSON \u00e0 partir de l'entr\u00e9e standard stdin, les envoyer \u00e0 Klipper et afficher les r\u00e9sultats. Cet outil s'attend \u00e0 avoir une commande JSON par ligne et il ajoute automatiquement le terminateur 0x03 avant d'envoyer les requ\u00eates. (Le serveur d'API de Klipper ne attend pas un saut de ligne.)","title":"Format de la demande"},{"location":"API_Server.html#protocole-de-lapi","text":"Le protocole de commande utilis\u00e9 sur le socket de communications est inspir\u00e9 par json-rpc . Une requ\u00eate pourrait ressembler \u00e0 \u00e7a : {\"id\": 123, \"method\": \"info\", \"params\": {}} et une r\u00e9ponse pourrait ressembler \u00e0 \u00e7a : {\"id\": 123, \"result\": {\"state_message\": \"Printer is ready\", \"klipper_path\": \"/home/pi/klipper\", \"config_file\": \"/home/pi/printer.cfg\", \"software_version\": \"v0.8.0-823-g883b1cb6\", \"hostname\": \"octopi\", \"cpu_info\": \"4 core ARMv7 Processor rev 4 (v7l)\", \"state\": \"ready\", \"python_path\": \"/home/pi/klippy-env/bin/python\", \"log_file\": \"/tmp/klippy.log\"}} Toutes les requ\u00eates doivent \u00eatre un dictionnaire JSON. (Ce document utilise le terme Python 'dictionary' pour d\u00e9crire un objet JSON - une affectation de paires Cl\u00e9/Valeur comprises en deux parenth\u00e8ses {} .) le dictionnaire de requ\u00eate doit contenir un param\u00e8tre \"m\u00e9thode\" disponible dans les \"points de terminaison\" de Klipper. Le dictionnaire de requ\u00eate peut contenir un param\u00e8tre \"params\" qui doit \u00eatre de type dictionnaire. Les \"params\" fournissent des informations de param\u00e8tre suppl\u00e9mentaires au \"endpoint\" Klipper qui traite la demande. Son contenu est sp\u00e9cifique au \"endpoint\". Le dictionnaire de requ\u00eate peut contenir un param\u00e8tre \"id\" qui peut \u00eatre de n'importe quel type JSON. Si \"id\" est pr\u00e9sent, alors Klipper r\u00e9pondra \u00e0 la demande avec une r\u00e9ponse contenant cet \"id\". Si \"id\" est omis (ou d\u00e9fini sur une valeur JSON \"null\"), Klipper ne fournira aucune r\u00e9ponse \u00e0 la requ\u00eate. Un message de r\u00e9ponse est un dictionnaire JSON contenant \"id\" et \"result\". Le \"r\u00e9sultat\" est toujours un dictionnaire - son contenu est sp\u00e9cifique au \"endpoint\" traitant la demande. Si le traitement d'un requ\u00eate est en erreur, le message de r\u00e9ponse contiendra un champ \"error\" au lieu de \"result\". Par exemple, la requ\u00eate : {\"id\": 123, \"method\": \"gcode/script\", \"params\": {\"script\": \"G1 X200\"}} pourrait retourner une erreur telle que :: {\"id\": 123, \"error\": {\"message\": \"Must home axis first: 200.000 0.000 0.000 [0.000]\", \"error\": \"WebRequestError\"}} Klipper traite toujours les demandes dans l'ordre de leur r\u00e9ception. Cependant, certaines requ\u00eates peuvent ne pas se terminer imm\u00e9diatement, ce qui peut entra\u00eener l'envoi de la r\u00e9ponse associ\u00e9e dans le d\u00e9sordre par rapport aux r\u00e9ponses d'autres requ\u00eates. Une requ\u00eate JSON ne suspend jamais le traitement des requ\u00eates JSON suivantes.","title":"Protocole de l'API"},{"location":"API_Server.html#abonnements","text":"Certains \"endpoint\" de Klipper autorisent un \"abonnement\" pour de futurs messages asynchrone de mise \u00e0 jour. Par exemple : {\"id\": 123, \"method\": \"gcode/subscribe_output\", \"params\": {\"response_template\":{\"key\": 345}}} Peut r\u00e9pondre dans un premier temps : {\"id\": 123, \"result\": {}} et faire en sorte que Klipper envoie de futurs messages similaires \u00e0 : {\"params\": {\"response\": \"ok B:22.8 /0.0 T0:22.4 /0.0\"}, \"key\": 345} Une demande d'abonnement accepte un dictionnaire \"response_template\" dans le champ \"params\" de la demande. Ce dictionnaire \"response_template\" est utilis\u00e9 comme mod\u00e8le pour les futurs messages asynchrones - il peut contenir des paires cl\u00e9/valeur arbitraires. Lors de l'envoi de ces futurs messages asynchrones, Klipper ajoutera un champ \"params\" contenant un dictionnaire avec un contenu sp\u00e9cifique \"endpoint\" au mod\u00e8le de r\u00e9ponse, puis enverra ce mod\u00e8le. Si un champ \"response_template\" n'est pas fourni, il s'agit par d\u00e9faut d'un dictionnaire vide ( {} ).","title":"Abonnements"},{"location":"API_Server.html#endpoints-disponibles","text":"Par convention, les \"endpoints\" de Klipper sont de la forme <module_name>/<some_name> . Lors d'une demande \u00e0 un \"endpoint\", le nom complet doit \u00eatre d\u00e9fini dans le param\u00e8tre \"method\" du dictionnaire de requ\u00eate (par exemple, {\"method\"=\"gcode/restart\"} ).","title":"\"endpoints\" disponibles"},{"location":"API_Server.html#info","text":"Le point de terminaison \"info\" est utilis\u00e9 pour obtenir des informations sur le syst\u00e8me et la version de Klipper. Il est \u00e9galement utilis\u00e9 pour fournir les informations de version du client \u00e0 Klipper. Par exemple : {\"id\": 123, \"method\": \"info\", \"params\": { \"client_info\": { \"version\": \"v1\"}}} S'il est pr\u00e9sent, le param\u00e8tre \"client_info\" doit \u00eatre un dictionnaire, mais ce dictionnaire peut avoir un contenu arbitraire. Les clients sont encourag\u00e9s \u00e0 fournir le nom du client et sa version logicielle lors de la premi\u00e8re connexion au serveur API Klipper.","title":"Info"},{"location":"API_Server.html#arret-durgence","text":"Le point de terminaison \"emergency_stop\" est utilis\u00e9 pour demander \u00e0 Klipper de passer \u00e0 un \u00e9tat \"shutdown\". Il se comporte de la m\u00eame mani\u00e8re que la commande G-Code M112 . Par exemple : {\"id\": 123, \"method\": \"emergency_stop\"}","title":"arr\u00eat d'urgence"},{"location":"API_Server.html#register_remote_method","text":"Ce point de terminaison permet aux clients d'enregistrer des m\u00e9thodes pouvant \u00eatre appel\u00e9es depuis klipper. Il renverra un objet vide en cas de succ\u00e8s. Par exemple : {\"id\": 123, \"method\": \"register_remote_method\", \"params\": {\"response_template\": {\"action\": \"run_paneldue_beep\"}, \"remote_method\": \"paneldue_beep\"}} renverra : }` La m\u00e9thode distante paneldue_beep peut d\u00e9sormais \u00eatre appel\u00e9e depuis Klipper. Notez que si la m\u00e9thode prend des param\u00e8tres, ils doivent \u00eatre fournis en tant qu'arguments de mots cl\u00e9s. Voici un exemple de la fa\u00e7on dont il peut \u00eatre appel\u00e9 \u00e0 partir d'un gcode_macro : [gcode_macro PANELDUE_BEEP] gcode: {action_call_remote_method(\"paneldue_beep\", frequency=300, duration=1.0)} Lorsque la macro gcode PANELDUE_BEEP est ex\u00e9cut\u00e9e, Klipper enverra ce qui suit sur le socket : {\"action\": \"run_paneldue_beep\", \"params\": {\"frequency\": 300, \"duration\": 1.0}}","title":"register_remote_method"},{"location":"API_Server.html#objectslist","text":"Ce point de terminaison remonte la liste des \"objets\" disponibles de l'imprimante que l'on peut interroger (via le point de terminaison \"objects/query\"). Par exemple : {\"id\": 123, \"method\": \"objects/list\"} peut renvoyer : {\"id\": 123, \"result\": {\"objects\": [\" webhooks\", \"configfile\", \"heaters\", \"gcode_move\", \"query_endstops\", \"idle_timeout\", \"toolhead\", \"extruder\"]}}","title":"objects/list"},{"location":"API_Server.html#objectsquery","text":"Ce point de terminaison permet de retrouver des informations \u00e0 partir d'objets de l'imprimante. Par exemple : {\"id\": 123, \"method\": \"objects/query\", \"params\": {\"objects\": {\"toolhead\": [\"position\"], \"webhooks\": null}} } peut renvoyer : {\"id\": 123, \"result\": {\"status\": {\"webhooks\": {\"state\": \"ready\", \"state_message\": \"L'imprimante est pr\u00eate\"} , \"toolhead\": {\"position\": [0.0, 0.0, 0.0, 0.0]}}, \"eventtime\": 3051555.377933684}} Le param\u00e8tre \"objects\" dans la requ\u00eate doit \u00eatre un dictionnaire contenant des objets de l'imprimante \u00e0 interroger - la cl\u00e9 contient le nom de l'objet imprimante et la valeur est soit \"null\" (pour interroger tous les champs) soit une liste de noms de champs. Le message de r\u00e9ponse contiendra un champ \"statut\" contenant un dictionnaire avec les informations demand\u00e9es - la cl\u00e9 contient le nom de l'objet imprimante et la valeur est un dictionnaire contenant ses champs. Le message de r\u00e9ponse contiendra \u00e9galement un champ \"eventtime\" contenant l'horodatage \u00e0 partir duquel la requ\u00eate a \u00e9t\u00e9 prise. Les champs disponibles sont document\u00e9s dans le document R\u00e9f\u00e9rence des \u00e9tats .","title":"objects/query"},{"location":"API_Server.html#objectssubscribe","text":"Ce point de terminaison permet d'interroger puis de s'abonner \u00e0 des informations provenant d'objets de l'imprimante. La demande et la r\u00e9ponse du point de terminaison sont identiques au point de terminaison \"objects/query\". Par exemple : {\"id\": 123, \"method\": \"objects/subscribe\", \"params\": {\"objects\":{\"toolhead\": [\"position\"], \"webhooks\": [\"state \"]}, \"response_template\":{}}} peut renvoyer : {\"id\": 123, \"result\": {\"status\": {\"webhooks\": {\"state\": \"pr\u00eat\" }, \"toolhead\": {\"position\": [0.0, 0.0, 0.0, 0.0]}}, \"eventtime\": 3052153.382083195}} et entra\u00eener des messages asynchrones ult\u00e9rieurs tels que : {\"params\": {\"status\": {\"webhooks\": {\"state\": \"shutdown\"}}, \"eventtime\": 3052165.418815847}}","title":"objects/subscribe"},{"location":"API_Server.html#gcodehelp","text":"Ce point de terminaison permet de retrouver les commandes G-Code disponibles qui ont une cha\u00eene d'aide d\u00e9finie. Par exemple : {\"id\": 123, \"method\": \"gcode/help\"} peut renvoyer : {\"id\": 123, \"result\": {\"RESTORE_GCODE_STATE\": \"Restaurer un \u00e9tat G-Code pr\u00e9c\u00e9demment enregistr\u00e9\", \"PID_CALIBRATE\": \"Ex\u00e9cuter le test d'\u00e9talonnage PID\", \"QUERY_ADC\": \"Rapport de la derni\u00e8re valeur d'une broche analogique\", ...}}","title":"gcode/help"},{"location":"API_Server.html#gcodescript","text":"Ce point de terminaison permet d'ex\u00e9cuter une s\u00e9rie de commandes G-Code. Par exemple : {\"id\": 123, \"method\": \"gcode/script\", \"params\": {\"script\": \"G90\"}} Si le script G-Code fourni g\u00e9n\u00e8re une erreur, une r\u00e9ponse d'erreur est g\u00e9n\u00e9r\u00e9e. Cependant, si la commande G-Code produit une sortie vers le terminal, cette sortie n'est pas remont\u00e9e dans la r\u00e9ponse. (Utilisez le point de terminaison \"gcode/subscribe_output\" pour obtenir la remont\u00e9e des sortie du terminal G-Code.) Si une commande G-Code est en cours de traitement lorsque cette demande est re\u00e7ue, le script re\u00e7u sera mis en file d'attente. Ce d\u00e9lai peut \u00eatre important (par exemple, si une commande d'attente de temp\u00e9rature de code G est en cours). Le message de r\u00e9ponse JSON est envoy\u00e9 lorsque le traitement du script est enti\u00e8rement termin\u00e9.","title":"gcode/script"},{"location":"API_Server.html#gcoderestart","text":"Ce point de terminaison permet de demander un red\u00e9marrage - il est similaire \u00e0 l'ex\u00e9cution de la commande G-Code \"RESTART\". Par exemple : {\"id\": 123, \"method\": \"gcode/restart\"} Comme pour le point de terminaison \"gcode/script\", ce point de terminaison ne se termine qu'apr\u00e8s la fin de toutes les commandes G-Code en attente.","title":"gcode/restart"},{"location":"API_Server.html#gcodefirmware_restart","text":"Ceci est similaire au point de terminaison \"gcode/restart\" - il impl\u00e9mente la commande G-Code \"FIRMWARE_RESTART\". Par exemple : {\"id\": 123, \"method\": \"gcode/firmware_restart\"} Comme pour le point de terminaison \"gcode/script\", ce point de terminaison ne se termine qu'apr\u00e8s la fin de toutes les commandes G-Code en attente.","title":"gcode/firmware_restart"},{"location":"API_Server.html#gcodesubscribe_output","text":"Ce point de terminaison est utilis\u00e9 pour s'abonner aux messages du terminal G-Code de Klipper. Par exemple : {\"id\": 123, \"method\": \"gcode/subscribe_output\", \"params\": {\"response_template\":{}}} peut ult\u00e9rieurement produire des messages asynchrones tels que : {\"params\": {\"response\": \"// \u00c9tat de Klipper : Arr\u00eat\"}} Ce point de terminaison est destin\u00e9 \u00e0 prendre en charge l'interaction humaine via une interface \"fen\u00eatre de terminal\". L'analyse du contenu de la sortie du terminal G-Code est d\u00e9conseill\u00e9e. Utilisez le point de terminaison \"objects/subscribe\" pour obtenir des mises \u00e0 jour sur l'\u00e9tat de Klipper.","title":"gcode/subscribe_output"},{"location":"API_Server.html#motion_reportdump_stepper","text":"Ce point de terminaison est utilis\u00e9 pour s'abonner au flux de commandes interne stepper queue_step de Klipper pour un stepper. L'obtention de ces mises \u00e0 jour de mouvement de bas niveau peut \u00eatre utile \u00e0 des fins de diagnostic et de d\u00e9bogage. L'utilisation de ce point de terminaison peut augmenter la charge syst\u00e8me de Klipper. Une requ\u00eate peut ressembler \u00e0 : {\"id\": 123, \"method\":\"motion_report/dump_stepper\", \"params\": {\"name\": \"stepper_x\", \"response_template\": {}}} et peut renvoyer : {\"id\": 123, \"result\": {\"header\": [\"interval\", \"count\", \"add\"]}} et peut produire ult\u00e9rieurement des messages asynchrones tels que : {\"params\": {\"first_clock\": 179601081, \"first_time\": 8.98, \"first_position\": 0, \"last_clock\": 219686097, \"last_time\": 10.984, \"data\": [[179601081, 1, 0 ], [29573, 2, -8685], [16230, 4, -1525], [10559, 6, -160], [10000, 976, 0], [10000, 1000, 0], [10000, 1000, 0], [10000, 1000, 0], [9855, 5, 187], [11632, 4, 1534], [20756, 2, 9442]]}} Le champ \"en-t\u00eate\" dans la r\u00e9ponse initiale \u00e0 la requ\u00eate est utilis\u00e9 pour d\u00e9crire les champs pr\u00e9sents dans les r\u00e9ponses \"donn\u00e9es\" ult\u00e9rieures.","title":"motion_report/dump_stepper"},{"location":"API_Server.html#motion_reportdump_trapq","text":"Ce point de terminaison est utilis\u00e9 pour s'abonner \u00e0 la \"file d'attente de mouvements trap\u00e9zo\u00efdaux\" interne de Klipper. L'obtention de ces mises \u00e0 jour de mouvement de bas niveau peut \u00eatre utile \u00e0 des fins de diagnostic et de d\u00e9bogage. L'utilisation de ce point de terminaison peut augmenter la charge syst\u00e8me de Klipper. Une requ\u00eate peut ressembler \u00e0 : {\"id\": 123, \"method\": \"motion_report/dump_trapq\", \"params\": {\"name\": \"toolhead\", \"response_template\":{}}} et peut renvoyer : {\"id\": 1, \"result\": {\"header\": [\"time\", \"duration\", \"start_velocity\", \"acceleration\", \"start_position\", \"direction\"]}} et peut produire ult\u00e9rieurement des messages asynchrones tels que : {\"params\": {\"data\": [[4.05, 1.0, 0.0, 0.0, [300.0, 0.0, 0.0], [0.0, 0.0, 0.0] ], [5.054, 0.001, 0.0, 3000.0, [300.0, 0.0, 0.0], [-1.0, 0.0, 0.0]]]}} Le champ \"en-t\u00eate\" dans la r\u00e9ponse initiale \u00e0 la requ\u00eate est utilis\u00e9 pour d\u00e9crire les champs pr\u00e9sents dans les r\u00e9ponses \"donn\u00e9es\" ult\u00e9rieures.","title":"motion_report/dump_trapq"},{"location":"API_Server.html#adxl345dump_adxl345","text":"Ce point de terminaison est utilis\u00e9 pour s'abonner aux donn\u00e9es de l'acc\u00e9l\u00e9rom\u00e8tre ADXL345. L'obtention de ces mises \u00e0 jour de mouvement de bas niveau peut \u00eatre utile \u00e0 des fins de diagnostic et de d\u00e9bogage. L'utilisation de ce point de terminaison peut augmenter la charge syst\u00e8me de Klipper. Une requ\u00eate peut ressembler \u00e0 : {\"id\": 123, \"method\":\"adxl345/dump_adxl345\", \"params\": {\"sensor\": \"adxl345\", \"response_template\": {}}} et pourrait renvoyer : {\"id\": 123,\"result\":{\"header\":[\"time\",\"x_acceleration\",\"y_acceleration\", \"z_acceleration\"]}} et pourrait plus tard produire des messages asynchrones messages tels que : {\"params\":{\"overflows\":0,\"data\":[[3292.432935,-535.44309,-1529.8374,9561.4], [3292.433256,-382.45935,-1606.32927,9561.48375]]}} Le champ \"en-t\u00eate\" dans la r\u00e9ponse initiale \u00e0 la requ\u00eate est utilis\u00e9 pour d\u00e9crire les champs pr\u00e9sents dans les r\u00e9ponses \"donn\u00e9es\" ult\u00e9rieures.","title":"adxl345/dump_adxl345"},{"location":"API_Server.html#angledump_angle","text":"Ce point de terminaison est utilis\u00e9 pour s'abonner aux donn\u00e9es du capteur d'angle . L'obtention de ces mises \u00e0 jour de mouvement de bas niveau peut \u00eatre utile \u00e0 des fins de diagnostic et de d\u00e9bogage. L'utilisation de ce point de terminaison peut augmenter la charge syst\u00e8me de Klipper. Une requ\u00eate peut ressembler \u00e0 : {\"id\": 123, \"method\":\"angle/dump_angle\", \"params\": {\"sensor\": \"my_angle_sensor\", \"response_template\": {}}} et peut renvoyer : {\"id\": 123,\"result\":{\"header\":[\"time\",\"angle\"]}} et peut produire ult\u00e9rieurement des messages asynchrones tels que : { \"params\":{\"position_offset\":3.151562,\"errors\":0, \"data\":[[1290.951905,-5063],[1290.952321,-5065]]}} Le champ \"en-t\u00eate\" dans la r\u00e9ponse initiale \u00e0 la requ\u00eate est utilis\u00e9 pour d\u00e9crire les champs pr\u00e9sents dans les r\u00e9ponses \"donn\u00e9es\" ult\u00e9rieures.","title":"angle/dump_angle"},{"location":"API_Server.html#pause_resumecancel","text":"Ce point final est similaire \u00e0 l'ex\u00e9cution de la commande G-Code \"PRINT_CANCEL\". Par exemple : {\"id\": 123, \"method\": \"pause_resume/cancel\"} Comme pour le point de terminaison \"gcode/script\", ce point de terminaison ne se termine qu'apr\u00e8s la fin de toutes les commandes G-Code en attente.","title":"pause_resume/cancel"},{"location":"API_Server.html#pause_resumepause","text":"Ce point d'entr\u00e9e est similaire \u00e0 l'ex\u00e9cution de la commande G-Code \"PAUSE\". Par exemple : {\"id\": 123, \"method\": \"pause_resume/pause\"} Comme pour le point de terminaison \"gcode/script\", ce point de terminaison ne se termine qu'apr\u00e8s la fin de toutes les commandes G-Code en attente.","title":"pause_resume/pause"},{"location":"API_Server.html#pause_resumeresume","text":"Ce point de terminaison est similaire \u00e0 l'ex\u00e9cution de la commande G-Code \"RESUME\". Par exemple : {\"id\": 123, \"method\": \"pause_resume/resume\"} Comme pour le point de terminaison \"gcode/script\", ce point de terminaison ne se termine qu'apr\u00e8s la fin de toutes les commandes G-Code en attente.","title":"pause_resume/resume"},{"location":"API_Server.html#query_endstopsstatus","text":"Ce point de terminaison interrogera les fins de course actifs et renverra leur \u00e9tat. Par exemple : {\"id\": 123, \"method\": \"query_endstops/status\"} peut renvoyer : {\"id\": 123, \"result\": {\"y\": \"open \", \"x\": \"open\", \"z\": \"TRIGGERED\"}} Comme pour le point de terminaison \"gcode/script\", ce point de terminaison ne se termine qu'apr\u00e8s la fin de toutes les commandes G-Code en attente.","title":"query_endstops/status"},{"location":"BLTouch.html","text":"BL-Touch \u00b6 Connexion du BL-Touch \u00b6 Un avertissement avant de commencer : \u00c9vitez de toucher la broche BL-Touch avec vos doigts nus, car elle est tr\u00e8s sensible \u00e0 la graisse des doigts. Et si vous la touchez, soyez tr\u00e8s doux, afin de ne pas plier ou pousser quoi que ce soit. Connectez le connecteur \"servo\" de la BL-Touch \u00e0 une control_pin selon la documentation de la BL-Touch ou celle de votre MCU. En utilisant le c\u00e2blage originel, le fil jaune du c\u00e2blage triple est la control_pin et le fil blanc du c\u00e2blage double est la sensor_pin . Vous devez configurer ces broches en fonction de votre c\u00e2blage. La plupart des dispositifs BL-Touch n\u00e9cessitent un pullup sur la broche du capteur (pr\u00e9fixez le nom de la broche par \"^\"). Par exemple : [bltouch] sensor_pin: ^P1.24 control_pin: P1.26 Si le BL-Touch est utilis\u00e9 pour amener l'axe Z \u00e0 l'origine, r\u00e9glez endstop_pin : probe:z_virtual_endstop et supprimez position_endstop dans la section de configuration [stepper_z] , puis ajoutez une section de configuration [safe_z_home] pour lever l'axe z, ramener les axes xy \u00e0 la position d'origine, se d\u00e9placer au centre du lit et ramener l'axe z \u00e0 la position d'origine. Par exemple : [safe_z_home] home_xy_position: 100, 100 # Change coordinates to the center of your print bed speed: 50 z_hop: 10 # Move up 10mm z_hop_speed: 5 Il est important que le mouvement z_hop dans safe_z_home soit suffisamment \u00e9lev\u00e9 pour que la sonde ne heurte rien, m\u00eame si la broche de la sonde se trouve dans son \u00e9tat le plus bas. Tests initiaux \u00b6 Avant de poursuivre, v\u00e9rifiez que la BL-Touch est mont\u00e9e \u00e0 la bonne hauteur, la tige doit se trouver \u00e0 environ 2 mm au-dessus de la buse lorsqu'elle est r\u00e9tract\u00e9e Lorsque vous mettez l'imprimante sous tension, la sonde BL-Touch doit effectuer un auto-test en sortant et r\u00e9tractant le pointeau plusieurs Une fois l'auto-test termin\u00e9, le pointeau doit \u00eatre r\u00e9tract\u00e9 et le voyant rouge de la sonde doit \u00eatre allum\u00e9. En cas d'erreur, par exemple si la sonde clignote en rouge ou si le pointeau est en bas au lieu d'\u00eatre en haut, veuillez \u00e9teindre l'imprimante et v\u00e9rifier le c\u00e2blage et la configuration. Si tout ce qui pr\u00e9c\u00e8de semble bon, il est temps de tester que la broche de contr\u00f4le fonctionne correctement. Ex\u00e9cutez d'abord BLTOUCH_DEBUG COMMAND=pin_down dans votre terminal d'imprimante. V\u00e9rifiez que le pointeau se d\u00e9place vers le bas et que la LED rouge de la sonde s'\u00e9teint. Si ce n'est pas le cas, v\u00e9rifiez \u00e0 nouveau votre c\u00e2blage et votre configuration. Ensuite, lancez une commande BLTOUCH_DEBUG COMMAND=pin_up , v\u00e9rifiez que le pointeau se r\u00e9tracte et que la lumi\u00e8re rouge s'allume \u00e0 nouveau. Si elle clignote, il y a un probl\u00e8me. L'\u00e9tape suivante consiste \u00e0 confirmer que la tige du capteur fonctionne correctement. Ex\u00e9cutez BLTOUCH_DEBUG COMMAND=pin_down , v\u00e9rifiez que le pointeau se d\u00e9place vers le bas, ex\u00e9cutez BLTOUCH_DEBUG COMMAND=touch_mode , ex\u00e9cutez QUERY_PROBE , et v\u00e9rifiez que la commande rapporte \"probe : open\". Ensuite, tout en poussant l\u00e9g\u00e8rement le pointeau vers le haut avec l'ongle de votre doigt, ex\u00e9cutez \u00e0 nouveau QUERY_PROBE . V\u00e9rifiez que la commande rapporte \"probe : TRIGGERED\". Si l'une ou l'autre des requ\u00eates ne donne pas le bon message, cela indique g\u00e9n\u00e9ralement un c\u00e2blage ou une configuration incorrecte (certains clones peuvent n\u00e9cessiter une manipulation sp\u00e9ciale). A la fin de ce test, ex\u00e9cutez BLTOUCH_DEBUG COMMAND=pin_up et v\u00e9rifiez que le pointeau se d\u00e9place vers le haut. Apr\u00e8s avoir effectu\u00e9 les tests de la broche de contr\u00f4le et de la broche de d\u00e9tection du BL-Touch, il est maintenant temps de tester le palpage, mais avec une petite astuce. Au lieu de laisser le pointeau de la sonde toucher le lit d'impression, laissez-le toucher l'ongle de votre doigt. Positionnez la t\u00eate d'impression loin du lit, \u00e9mettez un G28 (ou PROBE si vous n'utilisez pas probe:z_virtual_endstop), attendez que la t\u00eate d'impression commence \u00e0 descendre, et arr\u00eatez le mouvement en touchant tr\u00e8s doucement le pointeau avec votre ongle. Il se peut que vous deviez le faire deux fois, car la configuration par d\u00e9faut de l'autoguidage sonde deux fois. Pr\u00e9parez-vous \u00e0 \u00e9teindre l'imprimante si elle ne s'arr\u00eate pas lorsque vous touchez le pointeau. Si ce test a r\u00e9ussi, faites un autre G28 (ou PROBE ) mais cette fois-ci laissez-le toucher le lit comme il se doit. BL-Touch d\u00e9faillant \u00b6 Une fois que le BL-Touch est dans un \u00e9tat incoh\u00e9rent, il se met \u00e0 clignoter en rouge. Vous pouvez le forcer \u00e0 quitter cet \u00e9tat en \u00e9mettant : BLTOUCH_DEBUG COMMAND=reset Cela peut se produire si son \u00e9talonnage est interrompu par un blocage de l'extraction du pointeau. Cependant, il se peut \u00e9galement que le BL-Touch ne soit plus capable de se calibrer lui-m\u00eame. Cela se produit si la vis situ\u00e9e sur le dessus est mal positionn\u00e9e ou si le noyau magn\u00e9tique \u00e0 l'int\u00e9rieur de la tige du pointeau a boug\u00e9. S'il s'est d\u00e9plac\u00e9 vers le haut au point de coller \u00e0 la vis, il se peut que le BL-Touch ne soit plus capable de lib\u00e9rer sa tige. Dans ce cas, vous devez ouvrir la vis et utiliser un stylo \u00e0 bille pour le remettre doucement en place. R\u00e9introduisez la tige dans le BL-Touch de fa\u00e7on \u00e0 ce qu'elle tombe dans la position extraite. R\u00e9ajustez d\u00e9licatement la vis sans t\u00eate du dessus. Vous devez trouver la juste position pour qu'elle soit capable d'abaisser et de relever la tige et que la lumi\u00e8re rouge s'allume et s'\u00e9teigne. Utilisez les commandes reset , pin_up et pin_down pour y parvenir. \"Clones\" du BL-Touch \u00b6 De nombreux \"clones\" BL-Touch fonctionnent correctement avec Klipper en utilisant la configuration par d\u00e9faut. Cependant, certains \"clones\" peuvent ne pas supporter la commande QUERY_PROBE et certains autres \"clones\" peuvent n\u00e9cessiter la configuration de pin_up_reports_not_triggered ou pin_up_touch_mode_reports_triggered . Important ! Ne configurez pas pin_up_reports_not_triggered ou pin_up_touch_mode_reports_triggered \u00e0 False sans suivre ces instructions. Ne configurez pas l'une ou l'autre de ces options sur False sur un v\u00e9ritable BL-Touch. Une configuration incorrecte de ces param\u00e8tres sur False peut augmenter le temps de palpage et peut augmenter le risque d'endommager l'imprimante. Certains \"clones\" ne supportent pas le touch_mode et par cons\u00e9quent la commande QUERY_PROBE ne fonctionne pas. Malgr\u00e9 cela, il est possible d'effectuer un palpage et une mise \u00e0 l'origine avec ces dispositifs. Sur ces dispositifs, la commande QUERY_PROBE pendant les tests initiaux n'aboutira pas, mais le test suivant G28 (ou PROBE ) aboutira. Il est possible d'utiliser ces \"clones\" avec Klipper tant que l'on n'utilise pas la commande QUERY_PROBE et que l'on n'active pas la fonction probe_with_touch_mode . Certains \"clones\" sont incapables d'effectuer le test de v\u00e9rification du capteur interne de Klipper. Sur ces appareils, les tentatives de mise \u00e0 l'origine ou de palpage peuvent entra\u00eener le signalement par Klipper de l'erreur \"BLTouch failed to verify sensor state\". Si cela se produit, ex\u00e9cutez manuellement les \u00e9tapes pour confirmer que la broche du capteur fonctionne comme d\u00e9crit dans la section tests initiaux . Si les commandes QUERY_PROBE de ce test produisent toujours les r\u00e9sultats attendus et que l'erreur \"BLTouch failed to verify sensor state\" se produit toujours, il peut \u00eatre n\u00e9cessaire de mettre pin_up_touch_mode_reports_triggered \u00e0 False dans le fichier de configuration de Klipper. Un nombre rare d'anciens \"clones\" sont incapables de signaler qu'ils ont r\u00e9ussi \u00e0 relever leur pointeau. Sur ces appareils, Klipper signalera une erreur \"BLTouch failed to raise probe\" apr\u00e8s chaque tentative de retour \u00e0 l'origine ou de palpage. On peut tester ces appareils - \u00e9loigner la t\u00eate du lit, ex\u00e9cuter BLTOUCH_DEBUG COMMAND=pin_down , v\u00e9rifier que le pointeau s'est d\u00e9plac\u00e9 vers le bas, ex\u00e9cuter QUERY_PROBE , v\u00e9rifier que la commande rapporte \"probe : open\", ex\u00e9cuter BLTOUCH_DEBUG COMMAND=pin_up , v\u00e9rifier que le pointeau s'est d\u00e9plac\u00e9 vers le haut, et ex\u00e9cuter QUERY_PROBE . Si la broche reste en haut, que le dispositif n'entre pas dans un \u00e9tat d'erreur, et que la premi\u00e8re requ\u00eate rapporte \"probe : open\" alors que la seconde rapporte \"probe : TRIGGERED\" alors cela indique que pin_up_reports_not_triggered doit \u00eatre mis \u00e0 False dans le fichier de configuration de Klipper. BL-Touch v3 \u00b6 Certains BL-Touch v3.0 et BL-Touch 3.1 peuvent n\u00e9cessiter la configuration de probe_with_touch_mode dans le fichier de configuration de l'imprimante. Si le fil de signal du BL-Touch v3.0 est connect\u00e9 \u00e0 une broche d'arr\u00eat (avec un condensateur de filtrage du bruit), il se peut que le BL-Touch v3.0 ne soit pas capable d'envoyer un signal de mani\u00e8re constante pendant la recherche de l'origine et le palpage. Si les commandes QUERY_PROBE dans la section des tests initiaux produisent toujours les r\u00e9sultats attendus, mais que la t\u00eate de l'outil ne s'arr\u00eate toujours pas pendant les commandes G28/PROBE, alors cela indique ce probl\u00e8me. Une solution de contournement est de d\u00e9finir probe_with_touch_mode : True dans le fichier de configuration. Le BL-Touch v3.1 peut entrer incorrectement dans un \u00e9tat d'erreur apr\u00e8s une tentative de sondage r\u00e9ussie. Les sympt\u00f4mes sont une lumi\u00e8re clignotante occasionnelle sur le BL-Touch v3.1 qui dure quelques secondes apr\u00e8s qu'il ait r\u00e9ussi \u00e0 entrer en contact avec le lit. Klipper devrait effacer cette erreur automatiquement et elle est g\u00e9n\u00e9ralement inoffensive. Cependant, on peut d\u00e9finir probe_with_touch_mode dans le fichier de configuration pour \u00e9viter ce probl\u00e8me. Important ! Certains \"clones\" ainsi que le BL-Touch v2.0 (et ant\u00e9rieur) peuvent avoir une pr\u00e9cision r\u00e9duite lorsque probe_with_touch_mode est r\u00e9gl\u00e9 sur True. Le r\u00e9glage de cette valeur sur True augmente \u00e9galement le temps n\u00e9cessaire au d\u00e9ploiement de la sonde. Si vous configurez cette valeur sur un dispositif BL-Touch \"clone\" ou plus ancien, assurez-vous de tester la pr\u00e9cision de la sonde avant et apr\u00e8s avoir d\u00e9fini cette valeur (utilisez la commande PROBE_ACCURACY pour tester). Multi-palpages sans r\u00e9traction du pointeau \u00b6 Par d\u00e9faut, Klipper d\u00e9ploie le pointeau au d\u00e9but de chaque tentative de mesure et le r\u00e9tracte ensuite. Ce d\u00e9ploiement et cette r\u00e9traction r\u00e9p\u00e9titifs du pointeau peuvent augmenter la dur\u00e9e totale des s\u00e9quences d'\u00e9talonnage impliquant de nombreuses mesures du plateau. Klipper permet de laisser le pointeau d\u00e9ploy\u00e9 entre deux mesures cons\u00e9cutives, ce qui peut r\u00e9duire la dur\u00e9e totale des mesures. Ce mode est activ\u00e9 en configurant stow_on_each_sample \u00e0 False dans le fichier de configuration. Important ! Si vous r\u00e9glez la valeur Stow_on_each_sample sur False, Klipper peut effectuer des mouvements horizontaux de la t\u00eate de l'outil durant le d\u00e9ploiement du palpeur. Assurez-vous que toutes les op\u00e9rations de palpage ont un d\u00e9gagement Z suffisant avant de r\u00e9gler cette valeur sur False. Si l'espace est insuffisant, un mouvement horizontal peut faire en sorte que le pointeau s'accroche \u00e0 une obstruction et endommager l'imprimante. Important ! Il est recommand\u00e9 d'utiliser probe_with_touch_mode configur\u00e9 \u00e0 True lorsque vous utilisez stow_on_each_sample configur\u00e9 \u00e0 False. Certains \"clones\" peuvent ne pas d\u00e9tecter un contact ult\u00e9rieur du lit si probe_with_touch_mode n'est pas configur\u00e9. Sur tous les dispositifs, l'utilisation de la combinaison de ces deux param\u00e8tres simplifie la signalisation de l'appareil, am\u00e9liorant la stabilit\u00e9 globale. Notez cependant que certains \"clones\" ainsi que le BL-Touch v2.0 (et ant\u00e9rieurs) peuvent avoir une pr\u00e9cision r\u00e9duite lorsque probe_with_touch_mode est r\u00e9gl\u00e9 sur True. Sur ces appareils, c'est une bonne id\u00e9e de tester la pr\u00e9cision de la sonde avant et apr\u00e8s avoir r\u00e9gl\u00e9 probe_with_touch_mode (utilisez la commande PROBE_ACCURACY pour tester). \u00c9talonnage des d\u00e9calages du BL-Touch \u00b6 Suivez les instructions du guide Calibration de la sonde pour d\u00e9finir les param\u00e8tres de configuration x_offset, y_offset et z_offset. C'est une bonne id\u00e9e de v\u00e9rifier que le d\u00e9calage Z est proche de 1mm. Si ce n'est pas le cas, vous devrez probablement d\u00e9placer le dispositif vers le haut ou vers le bas pour r\u00e9soudre ce probl\u00e8me. Vous voulez qu'il se d\u00e9clenche bien avant que la buse ne touche le lit, afin qu'un \u00e9ventuel filament coinc\u00e9 ou un lit d\u00e9form\u00e9 n'affecte pas l'action du BL-Touch. Mais en m\u00eame temps, vous voulez que la position r\u00e9tract\u00e9e soit aussi loin que possible au-dessus de la buse pour \u00e9viter qu'elle ne touche les pi\u00e8ces imprim\u00e9es. Si un ajustement est effectu\u00e9 sur la position du BL-Touch, recommencez les \u00e9tapes d'\u00e9talonnage de celui-ci. Mode de sortie du BL-Touch \u00b6 Un BL-Touch V3.0 accepte le r\u00e9glage d'un mode de sortie 5V ou OPEN-DRAIN, un BL-Touch V3.1 le supporte aussi et peut \u00e9galement le stocker dans son EEPROM interne. Si votre carte contr\u00f4leur a besoin du niveau logique haut de 5V du mode 5V, vous pouvez r\u00e9gler le param\u00e8tre 'set_output_mode' dans la section [bltouch] du fichier de configuration de l'imprimante sur \"5V\". N'utilisez le mode 5V que si la ligne d'entr\u00e9e de votre carte contr\u00f4leur est tol\u00e9rante \u00e0 cette tension (5V). C'est pourquoi la configuration par d\u00e9faut de ces versions de BL-Touch est le mode OPEN-DRAIN. Vous pourriez potentiellement endommager le CPU de votre carte contr\u00f4leur En r\u00e9sum\u00e9 : Si une carte contr\u00f4leur a besoin d'un mode 5V ET qu'elle est tol\u00e9rante \u00e0 5V sur sa ligne de signal d'entr\u00e9e ET si vous avez un BL-Touch Smart V3.0, vous devez utiliser le param\u00e8tre 'set_output_mode : 5V' pour assurer ce r\u00e9glage \u00e0 chaque d\u00e9marrage, puisque la sonde ne peut pas se souvenir du r\u00e9glage n\u00e9cessaire. vous avez un BL-Touch Smart V3.1, vous avez le choix d'utiliser 'set_output_mode : 5V' ou de m\u00e9moriser le mode une fois pour toutes en utilisant une commande 'BLTOUCH_STORE MODE=5V' manuellement et sans plus utiliser le param\u00e8tre 'set_output_mode:'. vous avez une autre sonde : Certaines sondes ont une trace sur la carte de circuit imprim\u00e9 \u00e0 couper ou un cavalier \u00e0 r\u00e9gler afin de d\u00e9finir (de fa\u00e7on permanente) le mode de sortie. Dans ce cas, omettez compl\u00e8tement le param\u00e8tre 'set_output_mode'. Si vous avez une version V3.1, n'automatisez pas ou ne r\u00e9p\u00e9tez pas la m\u00e9morisation du mode de sortie afin d'\u00e9viter d'user l'EEPROM de la sonde. L'EEPROM du BLTouch permet environ 100.000 mises \u00e0 jour. 100 mises \u00e0 jour par jour repr\u00e9sentent environ 3 ans de fonctionnement avant l'usure de la m\u00e9moire. Ainsi, le stockage du mode de sortie dans la V3.1 est con\u00e7u par le vendeur pour \u00eatre une op\u00e9ration compliqu\u00e9e (le d\u00e9faut d'usine \u00e9tant un mode s\u00fbr OPEN DRAIN) et n'est pas adapt\u00e9 pour \u00eatre \u00e9mis de mani\u00e8re r\u00e9p\u00e9t\u00e9e par un trancheur, une macro ou autre, il est pr\u00e9f\u00e9rable de ne l'utiliser que lors de la premi\u00e8re int\u00e9gration de la sonde dans l'\u00e9lectronique de l'imprimante.","title":"BL-Touch"},{"location":"BLTouch.html#bl-touch","text":"","title":"BL-Touch"},{"location":"BLTouch.html#connexion-du-bl-touch","text":"Un avertissement avant de commencer : \u00c9vitez de toucher la broche BL-Touch avec vos doigts nus, car elle est tr\u00e8s sensible \u00e0 la graisse des doigts. Et si vous la touchez, soyez tr\u00e8s doux, afin de ne pas plier ou pousser quoi que ce soit. Connectez le connecteur \"servo\" de la BL-Touch \u00e0 une control_pin selon la documentation de la BL-Touch ou celle de votre MCU. En utilisant le c\u00e2blage originel, le fil jaune du c\u00e2blage triple est la control_pin et le fil blanc du c\u00e2blage double est la sensor_pin . Vous devez configurer ces broches en fonction de votre c\u00e2blage. La plupart des dispositifs BL-Touch n\u00e9cessitent un pullup sur la broche du capteur (pr\u00e9fixez le nom de la broche par \"^\"). Par exemple : [bltouch] sensor_pin: ^P1.24 control_pin: P1.26 Si le BL-Touch est utilis\u00e9 pour amener l'axe Z \u00e0 l'origine, r\u00e9glez endstop_pin : probe:z_virtual_endstop et supprimez position_endstop dans la section de configuration [stepper_z] , puis ajoutez une section de configuration [safe_z_home] pour lever l'axe z, ramener les axes xy \u00e0 la position d'origine, se d\u00e9placer au centre du lit et ramener l'axe z \u00e0 la position d'origine. Par exemple : [safe_z_home] home_xy_position: 100, 100 # Change coordinates to the center of your print bed speed: 50 z_hop: 10 # Move up 10mm z_hop_speed: 5 Il est important que le mouvement z_hop dans safe_z_home soit suffisamment \u00e9lev\u00e9 pour que la sonde ne heurte rien, m\u00eame si la broche de la sonde se trouve dans son \u00e9tat le plus bas.","title":"Connexion du BL-Touch"},{"location":"BLTouch.html#tests-initiaux","text":"Avant de poursuivre, v\u00e9rifiez que la BL-Touch est mont\u00e9e \u00e0 la bonne hauteur, la tige doit se trouver \u00e0 environ 2 mm au-dessus de la buse lorsqu'elle est r\u00e9tract\u00e9e Lorsque vous mettez l'imprimante sous tension, la sonde BL-Touch doit effectuer un auto-test en sortant et r\u00e9tractant le pointeau plusieurs Une fois l'auto-test termin\u00e9, le pointeau doit \u00eatre r\u00e9tract\u00e9 et le voyant rouge de la sonde doit \u00eatre allum\u00e9. En cas d'erreur, par exemple si la sonde clignote en rouge ou si le pointeau est en bas au lieu d'\u00eatre en haut, veuillez \u00e9teindre l'imprimante et v\u00e9rifier le c\u00e2blage et la configuration. Si tout ce qui pr\u00e9c\u00e8de semble bon, il est temps de tester que la broche de contr\u00f4le fonctionne correctement. Ex\u00e9cutez d'abord BLTOUCH_DEBUG COMMAND=pin_down dans votre terminal d'imprimante. V\u00e9rifiez que le pointeau se d\u00e9place vers le bas et que la LED rouge de la sonde s'\u00e9teint. Si ce n'est pas le cas, v\u00e9rifiez \u00e0 nouveau votre c\u00e2blage et votre configuration. Ensuite, lancez une commande BLTOUCH_DEBUG COMMAND=pin_up , v\u00e9rifiez que le pointeau se r\u00e9tracte et que la lumi\u00e8re rouge s'allume \u00e0 nouveau. Si elle clignote, il y a un probl\u00e8me. L'\u00e9tape suivante consiste \u00e0 confirmer que la tige du capteur fonctionne correctement. Ex\u00e9cutez BLTOUCH_DEBUG COMMAND=pin_down , v\u00e9rifiez que le pointeau se d\u00e9place vers le bas, ex\u00e9cutez BLTOUCH_DEBUG COMMAND=touch_mode , ex\u00e9cutez QUERY_PROBE , et v\u00e9rifiez que la commande rapporte \"probe : open\". Ensuite, tout en poussant l\u00e9g\u00e8rement le pointeau vers le haut avec l'ongle de votre doigt, ex\u00e9cutez \u00e0 nouveau QUERY_PROBE . V\u00e9rifiez que la commande rapporte \"probe : TRIGGERED\". Si l'une ou l'autre des requ\u00eates ne donne pas le bon message, cela indique g\u00e9n\u00e9ralement un c\u00e2blage ou une configuration incorrecte (certains clones peuvent n\u00e9cessiter une manipulation sp\u00e9ciale). A la fin de ce test, ex\u00e9cutez BLTOUCH_DEBUG COMMAND=pin_up et v\u00e9rifiez que le pointeau se d\u00e9place vers le haut. Apr\u00e8s avoir effectu\u00e9 les tests de la broche de contr\u00f4le et de la broche de d\u00e9tection du BL-Touch, il est maintenant temps de tester le palpage, mais avec une petite astuce. Au lieu de laisser le pointeau de la sonde toucher le lit d'impression, laissez-le toucher l'ongle de votre doigt. Positionnez la t\u00eate d'impression loin du lit, \u00e9mettez un G28 (ou PROBE si vous n'utilisez pas probe:z_virtual_endstop), attendez que la t\u00eate d'impression commence \u00e0 descendre, et arr\u00eatez le mouvement en touchant tr\u00e8s doucement le pointeau avec votre ongle. Il se peut que vous deviez le faire deux fois, car la configuration par d\u00e9faut de l'autoguidage sonde deux fois. Pr\u00e9parez-vous \u00e0 \u00e9teindre l'imprimante si elle ne s'arr\u00eate pas lorsque vous touchez le pointeau. Si ce test a r\u00e9ussi, faites un autre G28 (ou PROBE ) mais cette fois-ci laissez-le toucher le lit comme il se doit.","title":"Tests initiaux"},{"location":"BLTouch.html#bl-touch-defaillant","text":"Une fois que le BL-Touch est dans un \u00e9tat incoh\u00e9rent, il se met \u00e0 clignoter en rouge. Vous pouvez le forcer \u00e0 quitter cet \u00e9tat en \u00e9mettant : BLTOUCH_DEBUG COMMAND=reset Cela peut se produire si son \u00e9talonnage est interrompu par un blocage de l'extraction du pointeau. Cependant, il se peut \u00e9galement que le BL-Touch ne soit plus capable de se calibrer lui-m\u00eame. Cela se produit si la vis situ\u00e9e sur le dessus est mal positionn\u00e9e ou si le noyau magn\u00e9tique \u00e0 l'int\u00e9rieur de la tige du pointeau a boug\u00e9. S'il s'est d\u00e9plac\u00e9 vers le haut au point de coller \u00e0 la vis, il se peut que le BL-Touch ne soit plus capable de lib\u00e9rer sa tige. Dans ce cas, vous devez ouvrir la vis et utiliser un stylo \u00e0 bille pour le remettre doucement en place. R\u00e9introduisez la tige dans le BL-Touch de fa\u00e7on \u00e0 ce qu'elle tombe dans la position extraite. R\u00e9ajustez d\u00e9licatement la vis sans t\u00eate du dessus. Vous devez trouver la juste position pour qu'elle soit capable d'abaisser et de relever la tige et que la lumi\u00e8re rouge s'allume et s'\u00e9teigne. Utilisez les commandes reset , pin_up et pin_down pour y parvenir.","title":"BL-Touch d\u00e9faillant"},{"location":"BLTouch.html#clones-du-bl-touch","text":"De nombreux \"clones\" BL-Touch fonctionnent correctement avec Klipper en utilisant la configuration par d\u00e9faut. Cependant, certains \"clones\" peuvent ne pas supporter la commande QUERY_PROBE et certains autres \"clones\" peuvent n\u00e9cessiter la configuration de pin_up_reports_not_triggered ou pin_up_touch_mode_reports_triggered . Important ! Ne configurez pas pin_up_reports_not_triggered ou pin_up_touch_mode_reports_triggered \u00e0 False sans suivre ces instructions. Ne configurez pas l'une ou l'autre de ces options sur False sur un v\u00e9ritable BL-Touch. Une configuration incorrecte de ces param\u00e8tres sur False peut augmenter le temps de palpage et peut augmenter le risque d'endommager l'imprimante. Certains \"clones\" ne supportent pas le touch_mode et par cons\u00e9quent la commande QUERY_PROBE ne fonctionne pas. Malgr\u00e9 cela, il est possible d'effectuer un palpage et une mise \u00e0 l'origine avec ces dispositifs. Sur ces dispositifs, la commande QUERY_PROBE pendant les tests initiaux n'aboutira pas, mais le test suivant G28 (ou PROBE ) aboutira. Il est possible d'utiliser ces \"clones\" avec Klipper tant que l'on n'utilise pas la commande QUERY_PROBE et que l'on n'active pas la fonction probe_with_touch_mode . Certains \"clones\" sont incapables d'effectuer le test de v\u00e9rification du capteur interne de Klipper. Sur ces appareils, les tentatives de mise \u00e0 l'origine ou de palpage peuvent entra\u00eener le signalement par Klipper de l'erreur \"BLTouch failed to verify sensor state\". Si cela se produit, ex\u00e9cutez manuellement les \u00e9tapes pour confirmer que la broche du capteur fonctionne comme d\u00e9crit dans la section tests initiaux . Si les commandes QUERY_PROBE de ce test produisent toujours les r\u00e9sultats attendus et que l'erreur \"BLTouch failed to verify sensor state\" se produit toujours, il peut \u00eatre n\u00e9cessaire de mettre pin_up_touch_mode_reports_triggered \u00e0 False dans le fichier de configuration de Klipper. Un nombre rare d'anciens \"clones\" sont incapables de signaler qu'ils ont r\u00e9ussi \u00e0 relever leur pointeau. Sur ces appareils, Klipper signalera une erreur \"BLTouch failed to raise probe\" apr\u00e8s chaque tentative de retour \u00e0 l'origine ou de palpage. On peut tester ces appareils - \u00e9loigner la t\u00eate du lit, ex\u00e9cuter BLTOUCH_DEBUG COMMAND=pin_down , v\u00e9rifier que le pointeau s'est d\u00e9plac\u00e9 vers le bas, ex\u00e9cuter QUERY_PROBE , v\u00e9rifier que la commande rapporte \"probe : open\", ex\u00e9cuter BLTOUCH_DEBUG COMMAND=pin_up , v\u00e9rifier que le pointeau s'est d\u00e9plac\u00e9 vers le haut, et ex\u00e9cuter QUERY_PROBE . Si la broche reste en haut, que le dispositif n'entre pas dans un \u00e9tat d'erreur, et que la premi\u00e8re requ\u00eate rapporte \"probe : open\" alors que la seconde rapporte \"probe : TRIGGERED\" alors cela indique que pin_up_reports_not_triggered doit \u00eatre mis \u00e0 False dans le fichier de configuration de Klipper.","title":"\"Clones\" du BL-Touch"},{"location":"BLTouch.html#bl-touch-v3","text":"Certains BL-Touch v3.0 et BL-Touch 3.1 peuvent n\u00e9cessiter la configuration de probe_with_touch_mode dans le fichier de configuration de l'imprimante. Si le fil de signal du BL-Touch v3.0 est connect\u00e9 \u00e0 une broche d'arr\u00eat (avec un condensateur de filtrage du bruit), il se peut que le BL-Touch v3.0 ne soit pas capable d'envoyer un signal de mani\u00e8re constante pendant la recherche de l'origine et le palpage. Si les commandes QUERY_PROBE dans la section des tests initiaux produisent toujours les r\u00e9sultats attendus, mais que la t\u00eate de l'outil ne s'arr\u00eate toujours pas pendant les commandes G28/PROBE, alors cela indique ce probl\u00e8me. Une solution de contournement est de d\u00e9finir probe_with_touch_mode : True dans le fichier de configuration. Le BL-Touch v3.1 peut entrer incorrectement dans un \u00e9tat d'erreur apr\u00e8s une tentative de sondage r\u00e9ussie. Les sympt\u00f4mes sont une lumi\u00e8re clignotante occasionnelle sur le BL-Touch v3.1 qui dure quelques secondes apr\u00e8s qu'il ait r\u00e9ussi \u00e0 entrer en contact avec le lit. Klipper devrait effacer cette erreur automatiquement et elle est g\u00e9n\u00e9ralement inoffensive. Cependant, on peut d\u00e9finir probe_with_touch_mode dans le fichier de configuration pour \u00e9viter ce probl\u00e8me. Important ! Certains \"clones\" ainsi que le BL-Touch v2.0 (et ant\u00e9rieur) peuvent avoir une pr\u00e9cision r\u00e9duite lorsque probe_with_touch_mode est r\u00e9gl\u00e9 sur True. Le r\u00e9glage de cette valeur sur True augmente \u00e9galement le temps n\u00e9cessaire au d\u00e9ploiement de la sonde. Si vous configurez cette valeur sur un dispositif BL-Touch \"clone\" ou plus ancien, assurez-vous de tester la pr\u00e9cision de la sonde avant et apr\u00e8s avoir d\u00e9fini cette valeur (utilisez la commande PROBE_ACCURACY pour tester).","title":"BL-Touch v3"},{"location":"BLTouch.html#multi-palpages-sans-retraction-du-pointeau","text":"Par d\u00e9faut, Klipper d\u00e9ploie le pointeau au d\u00e9but de chaque tentative de mesure et le r\u00e9tracte ensuite. Ce d\u00e9ploiement et cette r\u00e9traction r\u00e9p\u00e9titifs du pointeau peuvent augmenter la dur\u00e9e totale des s\u00e9quences d'\u00e9talonnage impliquant de nombreuses mesures du plateau. Klipper permet de laisser le pointeau d\u00e9ploy\u00e9 entre deux mesures cons\u00e9cutives, ce qui peut r\u00e9duire la dur\u00e9e totale des mesures. Ce mode est activ\u00e9 en configurant stow_on_each_sample \u00e0 False dans le fichier de configuration. Important ! Si vous r\u00e9glez la valeur Stow_on_each_sample sur False, Klipper peut effectuer des mouvements horizontaux de la t\u00eate de l'outil durant le d\u00e9ploiement du palpeur. Assurez-vous que toutes les op\u00e9rations de palpage ont un d\u00e9gagement Z suffisant avant de r\u00e9gler cette valeur sur False. Si l'espace est insuffisant, un mouvement horizontal peut faire en sorte que le pointeau s'accroche \u00e0 une obstruction et endommager l'imprimante. Important ! Il est recommand\u00e9 d'utiliser probe_with_touch_mode configur\u00e9 \u00e0 True lorsque vous utilisez stow_on_each_sample configur\u00e9 \u00e0 False. Certains \"clones\" peuvent ne pas d\u00e9tecter un contact ult\u00e9rieur du lit si probe_with_touch_mode n'est pas configur\u00e9. Sur tous les dispositifs, l'utilisation de la combinaison de ces deux param\u00e8tres simplifie la signalisation de l'appareil, am\u00e9liorant la stabilit\u00e9 globale. Notez cependant que certains \"clones\" ainsi que le BL-Touch v2.0 (et ant\u00e9rieurs) peuvent avoir une pr\u00e9cision r\u00e9duite lorsque probe_with_touch_mode est r\u00e9gl\u00e9 sur True. Sur ces appareils, c'est une bonne id\u00e9e de tester la pr\u00e9cision de la sonde avant et apr\u00e8s avoir r\u00e9gl\u00e9 probe_with_touch_mode (utilisez la commande PROBE_ACCURACY pour tester).","title":"Multi-palpages sans r\u00e9traction du pointeau"},{"location":"BLTouch.html#etalonnage-des-decalages-du-bl-touch","text":"Suivez les instructions du guide Calibration de la sonde pour d\u00e9finir les param\u00e8tres de configuration x_offset, y_offset et z_offset. C'est une bonne id\u00e9e de v\u00e9rifier que le d\u00e9calage Z est proche de 1mm. Si ce n'est pas le cas, vous devrez probablement d\u00e9placer le dispositif vers le haut ou vers le bas pour r\u00e9soudre ce probl\u00e8me. Vous voulez qu'il se d\u00e9clenche bien avant que la buse ne touche le lit, afin qu'un \u00e9ventuel filament coinc\u00e9 ou un lit d\u00e9form\u00e9 n'affecte pas l'action du BL-Touch. Mais en m\u00eame temps, vous voulez que la position r\u00e9tract\u00e9e soit aussi loin que possible au-dessus de la buse pour \u00e9viter qu'elle ne touche les pi\u00e8ces imprim\u00e9es. Si un ajustement est effectu\u00e9 sur la position du BL-Touch, recommencez les \u00e9tapes d'\u00e9talonnage de celui-ci.","title":"\u00c9talonnage des d\u00e9calages du BL-Touch"},{"location":"BLTouch.html#mode-de-sortie-du-bl-touch","text":"Un BL-Touch V3.0 accepte le r\u00e9glage d'un mode de sortie 5V ou OPEN-DRAIN, un BL-Touch V3.1 le supporte aussi et peut \u00e9galement le stocker dans son EEPROM interne. Si votre carte contr\u00f4leur a besoin du niveau logique haut de 5V du mode 5V, vous pouvez r\u00e9gler le param\u00e8tre 'set_output_mode' dans la section [bltouch] du fichier de configuration de l'imprimante sur \"5V\". N'utilisez le mode 5V que si la ligne d'entr\u00e9e de votre carte contr\u00f4leur est tol\u00e9rante \u00e0 cette tension (5V). C'est pourquoi la configuration par d\u00e9faut de ces versions de BL-Touch est le mode OPEN-DRAIN. Vous pourriez potentiellement endommager le CPU de votre carte contr\u00f4leur En r\u00e9sum\u00e9 : Si une carte contr\u00f4leur a besoin d'un mode 5V ET qu'elle est tol\u00e9rante \u00e0 5V sur sa ligne de signal d'entr\u00e9e ET si vous avez un BL-Touch Smart V3.0, vous devez utiliser le param\u00e8tre 'set_output_mode : 5V' pour assurer ce r\u00e9glage \u00e0 chaque d\u00e9marrage, puisque la sonde ne peut pas se souvenir du r\u00e9glage n\u00e9cessaire. vous avez un BL-Touch Smart V3.1, vous avez le choix d'utiliser 'set_output_mode : 5V' ou de m\u00e9moriser le mode une fois pour toutes en utilisant une commande 'BLTOUCH_STORE MODE=5V' manuellement et sans plus utiliser le param\u00e8tre 'set_output_mode:'. vous avez une autre sonde : Certaines sondes ont une trace sur la carte de circuit imprim\u00e9 \u00e0 couper ou un cavalier \u00e0 r\u00e9gler afin de d\u00e9finir (de fa\u00e7on permanente) le mode de sortie. Dans ce cas, omettez compl\u00e8tement le param\u00e8tre 'set_output_mode'. Si vous avez une version V3.1, n'automatisez pas ou ne r\u00e9p\u00e9tez pas la m\u00e9morisation du mode de sortie afin d'\u00e9viter d'user l'EEPROM de la sonde. L'EEPROM du BLTouch permet environ 100.000 mises \u00e0 jour. 100 mises \u00e0 jour par jour repr\u00e9sentent environ 3 ans de fonctionnement avant l'usure de la m\u00e9moire. Ainsi, le stockage du mode de sortie dans la V3.1 est con\u00e7u par le vendeur pour \u00eatre une op\u00e9ration compliqu\u00e9e (le d\u00e9faut d'usine \u00e9tant un mode s\u00fbr OPEN DRAIN) et n'est pas adapt\u00e9 pour \u00eatre \u00e9mis de mani\u00e8re r\u00e9p\u00e9t\u00e9e par un trancheur, une macro ou autre, il est pr\u00e9f\u00e9rable de ne l'utiliser que lors de la premi\u00e8re int\u00e9gration de la sonde dans l'\u00e9lectronique de l'imprimante.","title":"Mode de sortie du BL-Touch"},{"location":"Beaglebone.html","text":"Beaglebone \u00b6 Ce document d\u00e9crit le processus d'ex\u00e9cution de Klipper sur un Beaglebone PRU. Construire l'image de l'OS \u00b6 Commencez par installer l'image Debian 9.9 2019-08-03 4GB SD IoT . Vous pouvez ex\u00e9cuter l'image \u00e0 partir d'une carte micro-SD ou de la carte eMMC int\u00e9gr\u00e9e. Si vous utilisez l'eMMC, installez-la sur l'eMMC maintenant en suivant les instructions du lien ci-dessus. Ensuite, connectez-vous \u00e0 la machine Beaglebone ( ssh debian@beaglebone -- le mot de passe est temppwd ) et installez Klipper en ex\u00e9cutant les commandes suivantes : git clone https://github.com/Klipper3d/klipper ./klipper/scripts/install-beaglebone.sh Installer Octoprint \u00b6 On peut ensuite installer Octoprint : git clone https://github.com/foosel/OctoPrint.git cd OctoPrint/ virtualenv venv ./venv/bin/python setup.py install Et configurer OctoPrint pour qu'il d\u00e9marre au d\u00e9marrage : sudo cp ~/OctoPrint/scripts/octoprint.init /etc/init.d/octoprint sudo chmod +x /etc/init.d/octoprint sudo cp ~/OctoPrint/scripts/octoprint.default /etc/default/octoprint sudo update-rc.d octoprint defaults Il est n\u00e9cessaire de modifier le fichier de configuration d'OctoPrint /etc/default/octoprint . Il faut changer l'utilisateur OCTOPRINT_USER en debian , changer NICELEVEL en 0 , d\u00e9commenter les param\u00e8tres BASEDIR , CONFIGFILE , et DAEMON et changer les r\u00e9f\u00e9rences de /home/pi/ en /home/debian/ : sudo nano /etc/default/octoprint D\u00e9marrez ensuite le service Octoprint : sudo systemctl start octoprint Assurez-vous que le serveur web OctoPrint est accessible - il devrait se trouver \u00e0 l'adresse suivante : http://beaglebone:5000/ Construire le code du microcontr\u00f4leur \u00b6 Pour compiler le code du microcontr\u00f4leur Klipper, commencez par le configurer pour le \"Beaglebone PRU\" : cd ~/klipper/ make menuconfig Pour compiler et installer le nouveau code du microcontr\u00f4leur, ex\u00e9cutez : sudo service klipper stop make flash sudo service klipper start Il est \u00e9galement n\u00e9cessaire de compiler et d'installer le code du microcontr\u00f4leur pour un processus h\u00f4te Linux. Configurez-le une seconde fois pour un \"processus Linux\" : make menuconfig Puis installez \u00e9galement ce code de micro-contr\u00f4leur : sudo service klipper stop make flash sudo service klipper start Configuration restante \u00b6 Terminez l'installation en configurant Klipper et Octoprint en suivant les instructions du document principal Installation . Imprimer avec le Beaglebone \u00b6 Malheureusement, le processeur du Beaglebone peut parfois avoir du mal \u00e0 faire fonctionner OctoPrint correctement. Des blocages d'impression sont connus pour se produire sur des impressions complexes (l'imprimante peut se d\u00e9placer plus rapidement qu'OctoPrint ne peut envoyer de commandes de mouvement). Si cela se produit, envisagez d'utiliser la fonctionnalit\u00e9 \"virtual_sdcard\" (voir R\u00e9f\u00e9rence des configurations pour plus de d\u00e9tails) pour imprimer directement depuis Klipper.","title":"Beaglebone"},{"location":"Beaglebone.html#beaglebone","text":"Ce document d\u00e9crit le processus d'ex\u00e9cution de Klipper sur un Beaglebone PRU.","title":"Beaglebone"},{"location":"Beaglebone.html#construire-limage-de-los","text":"Commencez par installer l'image Debian 9.9 2019-08-03 4GB SD IoT . Vous pouvez ex\u00e9cuter l'image \u00e0 partir d'une carte micro-SD ou de la carte eMMC int\u00e9gr\u00e9e. Si vous utilisez l'eMMC, installez-la sur l'eMMC maintenant en suivant les instructions du lien ci-dessus. Ensuite, connectez-vous \u00e0 la machine Beaglebone ( ssh debian@beaglebone -- le mot de passe est temppwd ) et installez Klipper en ex\u00e9cutant les commandes suivantes : git clone https://github.com/Klipper3d/klipper ./klipper/scripts/install-beaglebone.sh","title":"Construire l'image de l'OS"},{"location":"Beaglebone.html#installer-octoprint","text":"On peut ensuite installer Octoprint : git clone https://github.com/foosel/OctoPrint.git cd OctoPrint/ virtualenv venv ./venv/bin/python setup.py install Et configurer OctoPrint pour qu'il d\u00e9marre au d\u00e9marrage : sudo cp ~/OctoPrint/scripts/octoprint.init /etc/init.d/octoprint sudo chmod +x /etc/init.d/octoprint sudo cp ~/OctoPrint/scripts/octoprint.default /etc/default/octoprint sudo update-rc.d octoprint defaults Il est n\u00e9cessaire de modifier le fichier de configuration d'OctoPrint /etc/default/octoprint . Il faut changer l'utilisateur OCTOPRINT_USER en debian , changer NICELEVEL en 0 , d\u00e9commenter les param\u00e8tres BASEDIR , CONFIGFILE , et DAEMON et changer les r\u00e9f\u00e9rences de /home/pi/ en /home/debian/ : sudo nano /etc/default/octoprint D\u00e9marrez ensuite le service Octoprint : sudo systemctl start octoprint Assurez-vous que le serveur web OctoPrint est accessible - il devrait se trouver \u00e0 l'adresse suivante : http://beaglebone:5000/","title":"Installer Octoprint"},{"location":"Beaglebone.html#construire-le-code-du-microcontroleur","text":"Pour compiler le code du microcontr\u00f4leur Klipper, commencez par le configurer pour le \"Beaglebone PRU\" : cd ~/klipper/ make menuconfig Pour compiler et installer le nouveau code du microcontr\u00f4leur, ex\u00e9cutez : sudo service klipper stop make flash sudo service klipper start Il est \u00e9galement n\u00e9cessaire de compiler et d'installer le code du microcontr\u00f4leur pour un processus h\u00f4te Linux. Configurez-le une seconde fois pour un \"processus Linux\" : make menuconfig Puis installez \u00e9galement ce code de micro-contr\u00f4leur : sudo service klipper stop make flash sudo service klipper start","title":"Construire le code du microcontr\u00f4leur"},{"location":"Beaglebone.html#configuration-restante","text":"Terminez l'installation en configurant Klipper et Octoprint en suivant les instructions du document principal Installation .","title":"Configuration restante"},{"location":"Beaglebone.html#imprimer-avec-le-beaglebone","text":"Malheureusement, le processeur du Beaglebone peut parfois avoir du mal \u00e0 faire fonctionner OctoPrint correctement. Des blocages d'impression sont connus pour se produire sur des impressions complexes (l'imprimante peut se d\u00e9placer plus rapidement qu'OctoPrint ne peut envoyer de commandes de mouvement). Si cela se produit, envisagez d'utiliser la fonctionnalit\u00e9 \"virtual_sdcard\" (voir R\u00e9f\u00e9rence des configurations pour plus de d\u00e9tails) pour imprimer directement depuis Klipper.","title":"Imprimer avec le Beaglebone"},{"location":"Bed_Level.html","text":"Nivellement du lit \u00b6 Le nivellement du lit (parfois aussi appel\u00e9 \u00ab tramage du lit \u00bb) est essentiel pour obtenir des impressions de haute qualit\u00e9. Si un lit n'est pas correctement \"nivel\u00e9\", cela peut entra\u00eener une mauvaise adh\u00e9rence du lit, un \"gauchissement\" et des probl\u00e8mes subtils tout au long de l'impression. Ce document sert de guide pour effectuer le nivellement du lit dans Klipper. Il est important de comprendre l'objectif du nivellement du lit. Si l'imprimante doit aller \u00e0 la position X0 Y0 Z10 pendant une impression, alors l'objectif est que la buse de l'imprimante soit exactement \u00e0 10 mm du lit de l'imprimante. De plus, si l'imprimante doit ensuite aller \u00e0 la position \"X50 Z10\", l'objectif est que la buse maintienne une distance exacte de 10 mm du lit pendant tout ce mouvement horizontal. Afin d'obtenir des impressions de bonne qualit\u00e9, l'imprimante doit \u00eatre calibr\u00e9e de sorte que les distances Z soient pr\u00e9cises \u00e0 environ 25 microns (0,025 mm). Il s'agit d'une petite distance - nettement inf\u00e9rieure \u00e0 la largeur d'un cheveu humain. Cette \u00e9chelle ne peut pas \u00eatre mesur\u00e9e \"\u00e0 l'\u0153il\". Des effets subtils (tels que la dilatation thermique) ont un impact sur les mesures \u00e0 cette \u00e9chelle. Le secret pour obtenir une grande pr\u00e9cision est d'utiliser un processus reproductible et d'utiliser une m\u00e9thode de mise \u00e0 niveau qui tire parti de la haute pr\u00e9cision du propre syst\u00e8me de mouvement de l'imprimante. Choisissez le m\u00e9canisme d'\u00e9talonnage appropri\u00e9 \u00b6 Diff\u00e9rents types d'imprimantes utilisent diff\u00e9rentes m\u00e9thodes pour effectuer le nivellement du lit. A la fin toutes les m\u00e9thodes d\u00e9pendent du \"test du papier\" (d\u00e9crit ci-dessous). Cependant, le processus pour un type particulier d'imprimante est d\u00e9crit dans les autres documents. Avant d'ex\u00e9cuter l'un de ces outils d'\u00e9talonnage, assurez-vous d'ex\u00e9cuter les v\u00e9rifications d\u00e9crites dans le document de v\u00e9rification de la configuration . Il est n\u00e9cessaire de v\u00e9rifier les mouvements de base de l'imprimante avant d'effectuer le nivellement du lit. Pour les imprimantes avec une sonde Z automatique, assurez-vous de calibrer la sonde en suivant les instructions du document R\u00e9glages de la sonde . Pour les imprimantes delta, consultez le document R\u00e9glage des deltas . Pour les imprimantes avec un lit r\u00e9glable par vis et des fin de course Z traditionnels, consultez le document Nivellement manuel . Pendant le calibrage, il peut \u00eatre n\u00e9cessaire de d\u00e9finir la position_min du Z de l'imprimante sur un nombre n\u00e9gatif (par exemple, position_min = -2 ). L'imprimante effectue des v\u00e9rifications des limites m\u00eame pendant les routines d'\u00e9talonnage. La d\u00e9finition d'un nombre n\u00e9gatif permet \u00e0 l'imprimante de se d\u00e9placer en dessous de la position nominale du lit, ce qui peut aider \u00e0 d\u00e9terminer la position r\u00e9elle du lit. Le \"Test du papier\" \u00b6 Le principal m\u00e9canisme d'\u00e9talonnage du lit est le \"test du papier\". Il s'agit de placer un morceau r\u00e9gulier de \"papier pour photocopieuse\" entre le lit et la buse de l'imprimante, puis de d\u00e9placer la buse \u00e0 diff\u00e9rentes hauteurs Z jusqu'\u00e0 ce que l'on ressente une petite friction lorsque l'on pousse le papier d'avant en arri\u00e8re. Il est important de bien comprendre le \"test papier\" m\u00eame si l'on dispose d'une \"sonde Z automatique\". La sonde elle-m\u00eame doit souvent \u00eatre calibr\u00e9e pour obtenir de bons r\u00e9sultats. Cet \u00e9talonnage de la sonde est effectu\u00e9 \u00e0 l'aide de ce \"test papier\". Afin d'effectuer le test du papier, coupez un petit morceau de papier rectangulaire \u00e0 l'aide d'une paire de ciseaux (par exemple, 5x3 cm). Le papier a g\u00e9n\u00e9ralement une \u00e9paisseur d'environ 100 microns (0,100 mm). (L'\u00e9paisseur exacte du papier n'est pas cruciale.) La premi\u00e8re \u00e9tape du test du papier consiste \u00e0 inspecter la buse et le lit de l'imprimante. Assurez-vous qu'il n'y a pas de plastique (ou d'autres d\u00e9bris) sur la buse ou le lit. Inspectez la buse et le lit pour vous assurer qu'il n'y a pas de plastique ! Si l'on imprime toujours sur une bande adh\u00e9sive ou une surface d'impression particuli\u00e8re, on peut alors effectuer le test papier avec cette bande/surface en place. Cependant, notez que le ruban lui-m\u00eame a une \u00e9paisseur et que diff\u00e9rents rubans (ou toute autre surface d'impression) auront un impact sur les mesures Z. Assurez-vous de relancer le test du papier pour mesurer chaque type de surface utilis\u00e9. S'il y a du plastique sur la buse, chauffez la buse et utilisez une pince \u00e0 \u00e9piler en m\u00e9tal pour retirer ce plastique. Attendez que la buse refroidisse compl\u00e8tement \u00e0 temp\u00e9rature ambiante avant de continuer avec le test papier. Pendant que la buse refroidit, utilisez la pince \u00e0 \u00e9piler en m\u00e9tal pour retirer tout plastique susceptible de suinter. Effectuez toujours le test du papier lorsque la buse et le lit sont \u00e0 temp\u00e9rature ambiante ! Lorsque la buse est chauff\u00e9e, sa position (par rapport au lit) change en raison de la dilatation thermique. Cette dilatation thermique est g\u00e9n\u00e9ralement d'environ 100 microns, ce qui correspond \u00e0 peu pr\u00e8s \u00e0 la m\u00eame \u00e9paisseur qu'un morceau de papier d'imprimante typique. La quantit\u00e9 exacte de dilatation thermique n'est pas cruciale, tout comme l'\u00e9paisseur exacte du papier n'est pas cruciale. Commencez par l'hypoth\u00e8se que les deux sont \u00e9gaux (voir ci-dessous pour une m\u00e9thode de d\u00e9termination de la diff\u00e9rence entre les deux distances). Il peut sembler \u00e9tonnant de calibrer la distance \u00e0 temp\u00e9rature ambiante alors que l'objectif est d'avoir une distance constante lorsqu'il est chauff\u00e9. Cependant, si l'on calibre lorsque la buse est chauff\u00e9e, elle a tendance \u00e0 laisser couler de petites quantit\u00e9s de plastique fondu sur le papier, ce qui modifie la quantit\u00e9 de frottement ressenti. Cela complique l'obtention d'un bon calibrage. Le calibrage alors que le lit/la buse est chaud augmente \u00e9galement consid\u00e9rablement le risque de se br\u00fbler. La dilatation thermique est stable, elle est donc facilement prise en compte plus tard dans le processus d'\u00e9talonnage. Utilisez un outil automatique pour d\u00e9terminer des hauteurs Z pr\u00e9cises ! Klipper a de nombreux scripts d'aide disponibles (par exemple, MANUAL_PROBE, Z_ENDSTOP_CALIBRATE, PROBE_CALIBRATE, DELTA_CALIBRATE). Lisez les documents d\u00e9crits ci-dessus pour en choisir un. Ex\u00e9cutez la commande choisie dans la fen\u00eatre du terminal OctoPrint. Le script demandera une action de l'utilisateur dans la sortie du terminal OctoPrint. Cela ressemblera \u00e0 quelque chose comme : Recv: // Starting manual Z probe. Use TESTZ to adjust position. Recv: // Finish with ACCEPT or ABORT command. Recv: // Z position: ?????? --> 5.000 <-- ?????? La hauteur actuelle de la buse (telle que l'imprimante la calcule) est indiqu\u00e9e entre \"--> <--\". Le nombre \u00e0 droite est la hauteur du dernier essai de sondage juste sup\u00e9rieure \u00e0 la hauteur actuelle, et \u00e0 gauche c'est la hauteur du dernier essai de sondage inf\u00e9rieur \u00e0 la hauteur actuelle (ou ?????? si aucune tentative n'a \u00e9t\u00e9 effectu\u00e9e). Placez le papier entre la buse et le lit. Il peut \u00eatre utile de plier un coin du papier pour qu'il soit plus facile \u00e0 saisir. (Essayez de ne pas appuyer sur le lit lorsque vous d\u00e9placez le papier d'avant en arri\u00e8re.) Utilisez la commande TESTZ pour demander \u00e0 la buse de se rapprocher du papier. Par exemple : TESTZ Z=-0.1 La commande TESTZ d\u00e9placera la buse \u00e0 une distance relative de la position actuelle de la buse. (Ainsi, Z = -0.1 demande \u00e0 la buse de se rapprocher du lit de 0,1 mm.) Une fois que la buse a cess\u00e9 de bouger, poussez le papier d'avant en arri\u00e8re pour v\u00e9rifier si la buse est en contact avec le papier et pour sentir la quantit\u00e9 de frottement. Continuez \u00e0 \u00e9mettre des commandes TESTZ jusqu'\u00e0 ce que vous ressentiez une l\u00e9g\u00e8re friction lors du test avec le papier. Si il y a trop de frottement, on peut utiliser une valeur Z positive pour d\u00e9placer la buse vers le haut. Il est \u00e9galement possible d'utiliser TESTZ Z=+ ou TESTZ Z=- pour \"dichotomiser\" la derni\u00e8re position - c'est-\u00e0-dire se d\u00e9placer vers une position \u00e0 mi-chemin entre deux positions. Par exemple, si l'on re\u00e7oit l'invite suivante d'une commande TESTZ : Recv: // Z position: 0.130 --> 0.230 <-- 0.280 Ensuite, un 'TESTZ Z=-' d\u00e9placerait la buse vers une position Z de 0,180 (\u00e0 mi-chemin entre 0,130 et 0,230). On peut utiliser cette fonctionnalit\u00e9 pour aider \u00e0 r\u00e9duire rapidement \u00e0 un frottement constant. Il est \u00e9galement possible d'utiliser Z=++ et Z=-- pour revenir directement \u00e0 une mesure pass\u00e9e - par exemple, apr\u00e8s l'invite ci-dessus, une commande TESTZ Z=-- d\u00e9placerait la buse vers un Z position de 0,130. Apr\u00e8s r\u00e9gl\u00e9 la l\u00e9g\u00e8re force de friction, ex\u00e9cutez la commande ACCEPT : ACCEPT Cela validera la hauteur Z donn\u00e9e et enregistrera la valeur d'\u00e9talonnage. La force de friction ressentie n'est pas cruciale, tout comme la quantit\u00e9 de dilatation thermique et la largeur exacte du papier ne sont pas cruciales. Essayez simplement d'obtenir la m\u00eame quantit\u00e9 de frottement \u00e0 chaque fois que vous ex\u00e9cutez le test. Si quelque chose ne va pas pendant le test, on peut utiliser la commande ABORT pour quitter l'outil d'\u00e9talonnage. D\u00e9termination de la dilatation thermique \u00b6 Apr\u00e8s avoir effectu\u00e9 le nivellement du lit, on peut continuer \u00e0 calculer une valeur plus pr\u00e9cise pour compenser \u00abl'expansion thermique\u00bb, \u00abl'\u00e9paisseur du papier\u00bb et la \u00abquantit\u00e9 de frottement ressentie pendant le test du papier\u00bb. Ce type de calcul n'est g\u00e9n\u00e9ralement pas n\u00e9cessaire car la plupart des utilisateurs trouvent que le simple \"test papier\" donne de bons r\u00e9sultats. La fa\u00e7on la plus simple de faire ce calcul est d'imprimer un objet de test qui a des parois droites de tous les c\u00f4t\u00e9s. Le grand carr\u00e9 creux trouv\u00e9 dans docs/prints/square.stl peut \u00eatre utilis\u00e9 pour cela. Lors du d\u00e9coupage de l'objet, assurez-vous que le segment utilise la m\u00eame hauteur de couche et la m\u00eame largeur d'extrusion pour le premier niveau et pour toutes les couches suivantes. Utilisez une hauteur de couche grossi\u00e8re (la hauteur de couche doit \u00eatre d'environ 75 % du diam\u00e8tre de la buse) et n'utilisez pas de bordure ou de radeau. Imprimez l'objet \u00e0 tester, attendez qu'il refroidisse et retirez-le du lit. Inspectez la couche la plus basse de l'objet. (Il peut \u00e9galement \u00eatre utile de passer un doigt ou un ongle le long du bord inf\u00e9rieur.) Si l'on constate que la couche inf\u00e9rieure est l\u00e9g\u00e8rement bomb\u00e9e le long de tous les c\u00f4t\u00e9s de l'objet, cela indique que la buse \u00e9tait l\u00e9g\u00e8rement plus proche du lit qu'elle ne l'aurait d\u00fb. On peut \u00e9mettre une commande SET_GCODE_OFFSET Z=+.010 pour augmenter la hauteur. Dans les impressions suivantes, on peut inspecter ce comportement et effectuer d'autres ajustements si n\u00e9cessaire. Les ajustements de ce type se font g\u00e9n\u00e9ralement en dizaines de microns (0,010 mm). Si la couche inf\u00e9rieure appara\u00eet syst\u00e9matiquement plus \u00e9troite que les couches suivantes, vous pouvez utiliser la commande SET_GCODE_OFFSET pour effectuer un ajustement Z n\u00e9gatif. En cas de doute, on peut diminuer le r\u00e9glage Z jusqu'\u00e0 ce que la couche inf\u00e9rieure des impressions pr\u00e9sente un petit renflement, puis reculer jusqu'\u00e0 ce qu'il disparaisse. Le moyen le plus simple d'appliquer l'ajustement Z souhait\u00e9 consiste \u00e0 cr\u00e9er une macro de g-code START_PRINT et \u00e0 faire en sorte que le slicer appelle cette macro au d\u00e9but de chaque impression et \u00e0 ajouter une commande SET_GCODE_OFFSET \u00e0 cette macro. Voir le document trancheurs pour plus de d\u00e9tails.","title":"Nivellement du lit"},{"location":"Bed_Level.html#nivellement-du-lit","text":"Le nivellement du lit (parfois aussi appel\u00e9 \u00ab tramage du lit \u00bb) est essentiel pour obtenir des impressions de haute qualit\u00e9. Si un lit n'est pas correctement \"nivel\u00e9\", cela peut entra\u00eener une mauvaise adh\u00e9rence du lit, un \"gauchissement\" et des probl\u00e8mes subtils tout au long de l'impression. Ce document sert de guide pour effectuer le nivellement du lit dans Klipper. Il est important de comprendre l'objectif du nivellement du lit. Si l'imprimante doit aller \u00e0 la position X0 Y0 Z10 pendant une impression, alors l'objectif est que la buse de l'imprimante soit exactement \u00e0 10 mm du lit de l'imprimante. De plus, si l'imprimante doit ensuite aller \u00e0 la position \"X50 Z10\", l'objectif est que la buse maintienne une distance exacte de 10 mm du lit pendant tout ce mouvement horizontal. Afin d'obtenir des impressions de bonne qualit\u00e9, l'imprimante doit \u00eatre calibr\u00e9e de sorte que les distances Z soient pr\u00e9cises \u00e0 environ 25 microns (0,025 mm). Il s'agit d'une petite distance - nettement inf\u00e9rieure \u00e0 la largeur d'un cheveu humain. Cette \u00e9chelle ne peut pas \u00eatre mesur\u00e9e \"\u00e0 l'\u0153il\". Des effets subtils (tels que la dilatation thermique) ont un impact sur les mesures \u00e0 cette \u00e9chelle. Le secret pour obtenir une grande pr\u00e9cision est d'utiliser un processus reproductible et d'utiliser une m\u00e9thode de mise \u00e0 niveau qui tire parti de la haute pr\u00e9cision du propre syst\u00e8me de mouvement de l'imprimante.","title":"Nivellement du lit"},{"location":"Bed_Level.html#choisissez-le-mecanisme-detalonnage-approprie","text":"Diff\u00e9rents types d'imprimantes utilisent diff\u00e9rentes m\u00e9thodes pour effectuer le nivellement du lit. A la fin toutes les m\u00e9thodes d\u00e9pendent du \"test du papier\" (d\u00e9crit ci-dessous). Cependant, le processus pour un type particulier d'imprimante est d\u00e9crit dans les autres documents. Avant d'ex\u00e9cuter l'un de ces outils d'\u00e9talonnage, assurez-vous d'ex\u00e9cuter les v\u00e9rifications d\u00e9crites dans le document de v\u00e9rification de la configuration . Il est n\u00e9cessaire de v\u00e9rifier les mouvements de base de l'imprimante avant d'effectuer le nivellement du lit. Pour les imprimantes avec une sonde Z automatique, assurez-vous de calibrer la sonde en suivant les instructions du document R\u00e9glages de la sonde . Pour les imprimantes delta, consultez le document R\u00e9glage des deltas . Pour les imprimantes avec un lit r\u00e9glable par vis et des fin de course Z traditionnels, consultez le document Nivellement manuel . Pendant le calibrage, il peut \u00eatre n\u00e9cessaire de d\u00e9finir la position_min du Z de l'imprimante sur un nombre n\u00e9gatif (par exemple, position_min = -2 ). L'imprimante effectue des v\u00e9rifications des limites m\u00eame pendant les routines d'\u00e9talonnage. La d\u00e9finition d'un nombre n\u00e9gatif permet \u00e0 l'imprimante de se d\u00e9placer en dessous de la position nominale du lit, ce qui peut aider \u00e0 d\u00e9terminer la position r\u00e9elle du lit.","title":"Choisissez le m\u00e9canisme d'\u00e9talonnage appropri\u00e9"},{"location":"Bed_Level.html#le-test-du-papier","text":"Le principal m\u00e9canisme d'\u00e9talonnage du lit est le \"test du papier\". Il s'agit de placer un morceau r\u00e9gulier de \"papier pour photocopieuse\" entre le lit et la buse de l'imprimante, puis de d\u00e9placer la buse \u00e0 diff\u00e9rentes hauteurs Z jusqu'\u00e0 ce que l'on ressente une petite friction lorsque l'on pousse le papier d'avant en arri\u00e8re. Il est important de bien comprendre le \"test papier\" m\u00eame si l'on dispose d'une \"sonde Z automatique\". La sonde elle-m\u00eame doit souvent \u00eatre calibr\u00e9e pour obtenir de bons r\u00e9sultats. Cet \u00e9talonnage de la sonde est effectu\u00e9 \u00e0 l'aide de ce \"test papier\". Afin d'effectuer le test du papier, coupez un petit morceau de papier rectangulaire \u00e0 l'aide d'une paire de ciseaux (par exemple, 5x3 cm). Le papier a g\u00e9n\u00e9ralement une \u00e9paisseur d'environ 100 microns (0,100 mm). (L'\u00e9paisseur exacte du papier n'est pas cruciale.) La premi\u00e8re \u00e9tape du test du papier consiste \u00e0 inspecter la buse et le lit de l'imprimante. Assurez-vous qu'il n'y a pas de plastique (ou d'autres d\u00e9bris) sur la buse ou le lit. Inspectez la buse et le lit pour vous assurer qu'il n'y a pas de plastique ! Si l'on imprime toujours sur une bande adh\u00e9sive ou une surface d'impression particuli\u00e8re, on peut alors effectuer le test papier avec cette bande/surface en place. Cependant, notez que le ruban lui-m\u00eame a une \u00e9paisseur et que diff\u00e9rents rubans (ou toute autre surface d'impression) auront un impact sur les mesures Z. Assurez-vous de relancer le test du papier pour mesurer chaque type de surface utilis\u00e9. S'il y a du plastique sur la buse, chauffez la buse et utilisez une pince \u00e0 \u00e9piler en m\u00e9tal pour retirer ce plastique. Attendez que la buse refroidisse compl\u00e8tement \u00e0 temp\u00e9rature ambiante avant de continuer avec le test papier. Pendant que la buse refroidit, utilisez la pince \u00e0 \u00e9piler en m\u00e9tal pour retirer tout plastique susceptible de suinter. Effectuez toujours le test du papier lorsque la buse et le lit sont \u00e0 temp\u00e9rature ambiante ! Lorsque la buse est chauff\u00e9e, sa position (par rapport au lit) change en raison de la dilatation thermique. Cette dilatation thermique est g\u00e9n\u00e9ralement d'environ 100 microns, ce qui correspond \u00e0 peu pr\u00e8s \u00e0 la m\u00eame \u00e9paisseur qu'un morceau de papier d'imprimante typique. La quantit\u00e9 exacte de dilatation thermique n'est pas cruciale, tout comme l'\u00e9paisseur exacte du papier n'est pas cruciale. Commencez par l'hypoth\u00e8se que les deux sont \u00e9gaux (voir ci-dessous pour une m\u00e9thode de d\u00e9termination de la diff\u00e9rence entre les deux distances). Il peut sembler \u00e9tonnant de calibrer la distance \u00e0 temp\u00e9rature ambiante alors que l'objectif est d'avoir une distance constante lorsqu'il est chauff\u00e9. Cependant, si l'on calibre lorsque la buse est chauff\u00e9e, elle a tendance \u00e0 laisser couler de petites quantit\u00e9s de plastique fondu sur le papier, ce qui modifie la quantit\u00e9 de frottement ressenti. Cela complique l'obtention d'un bon calibrage. Le calibrage alors que le lit/la buse est chaud augmente \u00e9galement consid\u00e9rablement le risque de se br\u00fbler. La dilatation thermique est stable, elle est donc facilement prise en compte plus tard dans le processus d'\u00e9talonnage. Utilisez un outil automatique pour d\u00e9terminer des hauteurs Z pr\u00e9cises ! Klipper a de nombreux scripts d'aide disponibles (par exemple, MANUAL_PROBE, Z_ENDSTOP_CALIBRATE, PROBE_CALIBRATE, DELTA_CALIBRATE). Lisez les documents d\u00e9crits ci-dessus pour en choisir un. Ex\u00e9cutez la commande choisie dans la fen\u00eatre du terminal OctoPrint. Le script demandera une action de l'utilisateur dans la sortie du terminal OctoPrint. Cela ressemblera \u00e0 quelque chose comme : Recv: // Starting manual Z probe. Use TESTZ to adjust position. Recv: // Finish with ACCEPT or ABORT command. Recv: // Z position: ?????? --> 5.000 <-- ?????? La hauteur actuelle de la buse (telle que l'imprimante la calcule) est indiqu\u00e9e entre \"--> <--\". Le nombre \u00e0 droite est la hauteur du dernier essai de sondage juste sup\u00e9rieure \u00e0 la hauteur actuelle, et \u00e0 gauche c'est la hauteur du dernier essai de sondage inf\u00e9rieur \u00e0 la hauteur actuelle (ou ?????? si aucune tentative n'a \u00e9t\u00e9 effectu\u00e9e). Placez le papier entre la buse et le lit. Il peut \u00eatre utile de plier un coin du papier pour qu'il soit plus facile \u00e0 saisir. (Essayez de ne pas appuyer sur le lit lorsque vous d\u00e9placez le papier d'avant en arri\u00e8re.) Utilisez la commande TESTZ pour demander \u00e0 la buse de se rapprocher du papier. Par exemple : TESTZ Z=-0.1 La commande TESTZ d\u00e9placera la buse \u00e0 une distance relative de la position actuelle de la buse. (Ainsi, Z = -0.1 demande \u00e0 la buse de se rapprocher du lit de 0,1 mm.) Une fois que la buse a cess\u00e9 de bouger, poussez le papier d'avant en arri\u00e8re pour v\u00e9rifier si la buse est en contact avec le papier et pour sentir la quantit\u00e9 de frottement. Continuez \u00e0 \u00e9mettre des commandes TESTZ jusqu'\u00e0 ce que vous ressentiez une l\u00e9g\u00e8re friction lors du test avec le papier. Si il y a trop de frottement, on peut utiliser une valeur Z positive pour d\u00e9placer la buse vers le haut. Il est \u00e9galement possible d'utiliser TESTZ Z=+ ou TESTZ Z=- pour \"dichotomiser\" la derni\u00e8re position - c'est-\u00e0-dire se d\u00e9placer vers une position \u00e0 mi-chemin entre deux positions. Par exemple, si l'on re\u00e7oit l'invite suivante d'une commande TESTZ : Recv: // Z position: 0.130 --> 0.230 <-- 0.280 Ensuite, un 'TESTZ Z=-' d\u00e9placerait la buse vers une position Z de 0,180 (\u00e0 mi-chemin entre 0,130 et 0,230). On peut utiliser cette fonctionnalit\u00e9 pour aider \u00e0 r\u00e9duire rapidement \u00e0 un frottement constant. Il est \u00e9galement possible d'utiliser Z=++ et Z=-- pour revenir directement \u00e0 une mesure pass\u00e9e - par exemple, apr\u00e8s l'invite ci-dessus, une commande TESTZ Z=-- d\u00e9placerait la buse vers un Z position de 0,130. Apr\u00e8s r\u00e9gl\u00e9 la l\u00e9g\u00e8re force de friction, ex\u00e9cutez la commande ACCEPT : ACCEPT Cela validera la hauteur Z donn\u00e9e et enregistrera la valeur d'\u00e9talonnage. La force de friction ressentie n'est pas cruciale, tout comme la quantit\u00e9 de dilatation thermique et la largeur exacte du papier ne sont pas cruciales. Essayez simplement d'obtenir la m\u00eame quantit\u00e9 de frottement \u00e0 chaque fois que vous ex\u00e9cutez le test. Si quelque chose ne va pas pendant le test, on peut utiliser la commande ABORT pour quitter l'outil d'\u00e9talonnage.","title":"Le \"Test du papier\""},{"location":"Bed_Level.html#determination-de-la-dilatation-thermique","text":"Apr\u00e8s avoir effectu\u00e9 le nivellement du lit, on peut continuer \u00e0 calculer une valeur plus pr\u00e9cise pour compenser \u00abl'expansion thermique\u00bb, \u00abl'\u00e9paisseur du papier\u00bb et la \u00abquantit\u00e9 de frottement ressentie pendant le test du papier\u00bb. Ce type de calcul n'est g\u00e9n\u00e9ralement pas n\u00e9cessaire car la plupart des utilisateurs trouvent que le simple \"test papier\" donne de bons r\u00e9sultats. La fa\u00e7on la plus simple de faire ce calcul est d'imprimer un objet de test qui a des parois droites de tous les c\u00f4t\u00e9s. Le grand carr\u00e9 creux trouv\u00e9 dans docs/prints/square.stl peut \u00eatre utilis\u00e9 pour cela. Lors du d\u00e9coupage de l'objet, assurez-vous que le segment utilise la m\u00eame hauteur de couche et la m\u00eame largeur d'extrusion pour le premier niveau et pour toutes les couches suivantes. Utilisez une hauteur de couche grossi\u00e8re (la hauteur de couche doit \u00eatre d'environ 75 % du diam\u00e8tre de la buse) et n'utilisez pas de bordure ou de radeau. Imprimez l'objet \u00e0 tester, attendez qu'il refroidisse et retirez-le du lit. Inspectez la couche la plus basse de l'objet. (Il peut \u00e9galement \u00eatre utile de passer un doigt ou un ongle le long du bord inf\u00e9rieur.) Si l'on constate que la couche inf\u00e9rieure est l\u00e9g\u00e8rement bomb\u00e9e le long de tous les c\u00f4t\u00e9s de l'objet, cela indique que la buse \u00e9tait l\u00e9g\u00e8rement plus proche du lit qu'elle ne l'aurait d\u00fb. On peut \u00e9mettre une commande SET_GCODE_OFFSET Z=+.010 pour augmenter la hauteur. Dans les impressions suivantes, on peut inspecter ce comportement et effectuer d'autres ajustements si n\u00e9cessaire. Les ajustements de ce type se font g\u00e9n\u00e9ralement en dizaines de microns (0,010 mm). Si la couche inf\u00e9rieure appara\u00eet syst\u00e9matiquement plus \u00e9troite que les couches suivantes, vous pouvez utiliser la commande SET_GCODE_OFFSET pour effectuer un ajustement Z n\u00e9gatif. En cas de doute, on peut diminuer le r\u00e9glage Z jusqu'\u00e0 ce que la couche inf\u00e9rieure des impressions pr\u00e9sente un petit renflement, puis reculer jusqu'\u00e0 ce qu'il disparaisse. Le moyen le plus simple d'appliquer l'ajustement Z souhait\u00e9 consiste \u00e0 cr\u00e9er une macro de g-code START_PRINT et \u00e0 faire en sorte que le slicer appelle cette macro au d\u00e9but de chaque impression et \u00e0 ajouter une commande SET_GCODE_OFFSET \u00e0 cette macro. Voir le document trancheurs pour plus de d\u00e9tails.","title":"D\u00e9termination de la dilatation thermique"},{"location":"Bed_Mesh.html","text":"Maillage du Bed \u00b6 Le module Maillage du lit peut \u00eatre utilis\u00e9 pour compenser les irr\u00e9gularit\u00e9s de la surface du lit afin d'obtenir une meilleure premi\u00e8re couche sur l'ensemble du lit. Il convient de noter que la correction logicielle ne permet pas d'obtenir de r\u00e9sultats parfaits, elle ne peut qu'approximer la forme du lit. Le maillage du lit ne peut pas non plus compenser les probl\u00e8mes m\u00e9caniques et \u00e9lectriques. Si un axe est de travers ou si un palpeur n'est pas pr\u00e9cis, le module bed_mesh n'obtiendra pas de r\u00e9sultats pr\u00e9cis lors du processus de palpage. Avant de proc\u00e9der \u00e0 l'\u00e9talonnage du maillage, vous devez vous assurer que l'offset Z de votre sonde est r\u00e9gl\u00e9. Si vous utilisez une but\u00e9e de fin de course pour la mise \u00e0 l'origine en Z, elle doit \u00e9galement \u00eatre r\u00e9gl\u00e9e. Voir Calibration de la sonde et Z_ENDSTOP_CALIBRATE dans Nivelage manuel pour plus d'informations. Configuration de base \u00b6 Lits rectangulaires \u00b6 Cet exemple suppose une imprimante avec un lit rectangulaire de 250 mm x 220 mm et une sonde avec un d\u00e9calage x de 24 mm et un d\u00e9calage y de 5 mm. [bed_mesh] speed: 120 horizontal_move_z: 5 mesh_min: 35, 6 mesh_max: 240, 198 probe_count: 5, 3 speed : 120 Valeur par d\u00e9faut : 50 La vitesse \u00e0 laquelle l'outil se d\u00e9place entre les points palp\u00e9s. horizontal_move_z : 5 Valeur par d\u00e9faut : 5 La coordonn\u00e9e Z \u00e0 laquelle la sonde s'\u00e9l\u00e8ve avant de se d\u00e9placer entre les points. mesh_min : 35, 6 Requis La premi\u00e8re coordonn\u00e9e palp\u00e9e, la plus proche de l'origine. Cette coordonn\u00e9e est relative \u00e0 l'emplacement de la sonde. mesh_max : 240, 198 Requis La coordonn\u00e9e palp\u00e9e la plus \u00e9loign\u00e9e de l'origine. Ce n'est pas n\u00e9cessairement le dernier point palp\u00e9, car le processus de palpage se d\u00e9roule en zig-zag. Comme pour mesh_min , cette coordonn\u00e9e est relative \u00e0 l'emplacement de la sonde. probe_count : 5, 3 Valeur par d\u00e9faut : 3, 3 Le nombre de points \u00e0 palper sur chaque axe, sp\u00e9cifi\u00e9 sous forme de valeurs enti\u00e8res X, Y. Dans cet exemple, 5 points seront palp\u00e9s le long de l'axe X, avec 3 points le long de l'axe Y, pour un total de 15 points palp\u00e9s. Notez que si vous voulez une grille carr\u00e9e, par exemple 3x3, il est possible de n'utiliser qu'une seule valeur enti\u00e8re pour les deux axes, par exemple probe_count : 3 . Notez qu'un maillage n\u00e9cessite un nombre minimum de 3 points de sondage sur chaque axe. L'illustration ci-dessous montre comment les options mesh_min , mesh_max , et probe_count sont utilis\u00e9es pour g\u00e9n\u00e9rer des points de palpage. Les fl\u00e8ches indiquent la direction de la proc\u00e9dure de palpage, commen\u00e7ant en mesh_min . Pour r\u00e9f\u00e9rence, lorsque la sonde est \u00e0 mesh_min , la buse sera \u00e0 (11, 1), et lorsque la sonde est \u00e0 mesh_max , la buse sera \u00e0 (206, 193). Lits circulaires \u00b6 Cet exemple suppose une imprimante \u00e9quip\u00e9e d'un lit circulaire de 100 mm de rayon. Nous utiliserons les m\u00eames d\u00e9calages de sonde que dans l'exemple rectangulaire, 24 mm sur X et 5 mm sur Y. [bed_mesh] speed: 120 horizontal_move_z: 5 mesh_radius: 75 mesh_origin: 0, 0 round_probe_count: 5 mesh_radius : 75 Requis Le rayon du maillage palp\u00e9 en mm, par rapport \u00e0 mesh_origin . Notez que les d\u00e9calages de la sonde limitent la taille du rayon du maillage. Dans cet exemple, un rayon sup\u00e9rieur \u00e0 76 d\u00e9placerait la t\u00eate de l'outil en dehors des limites physiques de l'imprimante. mesh_origin : 0, 0 Valeur par d\u00e9faut : 0, 0 Le point central du maillage. Cette coordonn\u00e9e est relative \u00e0 l'emplacement de la sonde. Bien que la valeur par d\u00e9faut soit 0, 0, il peut \u00eatre utile d'ajuster l'origine dans le but de sonder une plus grande partie du lit. Voir l'illustration ci-dessous. round_probe_count : 5 Valeur par d\u00e9faut : 5 C'est une valeur enti\u00e8re d\u00e9finissant le nombre maximum de points palp\u00e9s le long des axes X et Y. Par \"maximum\", nous entendons le nombre de points palp\u00e9s le long de l'origine du maillage. Cette valeur doit \u00eatre un nombre impair, car il est n\u00e9cessaire que le centre du maillage soit palp\u00e9. L'illustration ci-dessous montre comment les points palp\u00e9s sont g\u00e9n\u00e9r\u00e9s. Comme vous pouvez le voir, le r\u00e9glage de mesh_origin \u00e0 (-10, 0) nous permet de sp\u00e9cifier un rayon de maillage plus grand de 85. Configuration avanc\u00e9e \u00b6 Les options de configuration plus avanc\u00e9es sont expliqu\u00e9es en d\u00e9tail ci-dessous. Chaque exemple s'appuie sur la configuration de base du lit rectangulaire pr\u00e9sent\u00e9e ci-dessus. Chacune des options avanc\u00e9es s'applique de la m\u00eame mani\u00e8re aux lits circulaires. Interpolation du maillage \u00b6 Bien qu'il soit possible d'\u00e9chantillonner directement la matrice palp\u00e9e en utilisant une simple interpolation bilin\u00e9aire afin de d\u00e9terminer les valeurs Z entre les points palp\u00e9s, il est souvent utile d'interpoler des points suppl\u00e9mentaires en utilisant des algorithmes d'interpolation plus avanc\u00e9s pour augmenter la densit\u00e9 du maillage. Ces algorithmes ajoutent une courbure au maillage, en essayant de simuler les propri\u00e9t\u00e9s mat\u00e9rielles du lit. Le maillage du lit offre l'interpolation de lagrange et bicubique pour accomplir ceci. [bed_mesh] speed: 120 horizontal_move_z: 5 mesh_min: 35, 6 mesh_max: 240, 198 probe_count: 5, 3 mesh_pps: 2, 3 algorithm: bicubic bicubic_tension: 0.2 mesh_pps : 2, 3 Valeur par d\u00e9faut : 2, 2 L'option mesh_pps est l'abr\u00e9viation de Mesh Points Per Segment. Cette option indique le nombre de points \u00e0 interpoler pour chaque segment le long des axes X et Y. Un 'segment' est l'espace entre chaque point palp\u00e9. Comme pour probe_count , mesh_pps est sp\u00e9cifi\u00e9 en tant que paire de nombres entiers X, Y mais peut aussi \u00eatre sp\u00e9cifi\u00e9 comme un seul nombre entier en ce cas appliqu\u00e9 aux deux axes. Dans cet exemple, il y a 4 segments le long de l'axe X et 2 segments le long de l'axe Y. Cela r\u00e9sulte en 8 points interpol\u00e9s le long de l'axe X et 6 points interpol\u00e9s le long de l'axe Y, ce qui donne un maillage de 13x8. Notez que si mesh_pps est d\u00e9fini \u00e0 0, l'interpolation de maillage est d\u00e9sactiv\u00e9e et la matrice sond\u00e9e sera \u00e9chantillonn\u00e9e directement. algorithm : lagrange Valeur par d\u00e9faut : lagrange L'algorithme utilis\u00e9 pour interpoler le maillage. Peut \u00eatre lagrange ou bicubique . L'interpolation de Lagrange est plafonn\u00e9e \u00e0 6 points palp\u00e9s car une oscillation tend \u00e0 se produire avec un plus grand nombre d'\u00e9chantillons. L'interpolation bicubique requiert un minimum de 4 points le long de chaque axe, si moins de 4 points sont sp\u00e9cifi\u00e9s, l'\u00e9chantillonnage de Lagrange est forc\u00e9. Si mesh_pps est d\u00e9fini \u00e0 0 alors cette valeur est ignor\u00e9e car aucune interpolation de maille n'est faite. bicubic_tension : 0.2 Valeur par d\u00e9faut : 0.2 Si l'option algorithm est d\u00e9finie sur bicubique, il est possible d'indiquer une valeur de tension. Plus la tension est \u00e9lev\u00e9e, plus la pente est interpol\u00e9e. Soyez prudent lorsque vous ajustez cette valeur, car des valeurs plus \u00e9lev\u00e9es cr\u00e9ent \u00e9galement plus de d\u00e9passement, ce qui entra\u00eenera des valeurs interpol\u00e9es plus \u00e9lev\u00e9es ou plus basses que vos points palp\u00e9s. L'illustration ci-dessous montre comment les options ci-dessus sont utilis\u00e9es pour g\u00e9n\u00e9rer un maillage interpol\u00e9. Fractionnement des d\u00e9placements \u00b6 Le maillage du lit fonctionne en interceptant les commandes de d\u00e9placement du gcode et en appliquant une transformation \u00e0 leur coordonn\u00e9e Z. Les longs d\u00e9placements doivent \u00eatre divis\u00e9s en d\u00e9placements plus petits pour suivre correctement la forme du lit. Les options ci-dessous contr\u00f4lent le comportement du fractionnement. [bed_mesh] speed: 120 horizontal_move_z: 5 mesh_min: 35, 6 mesh_max: 240, 198 probe_count: 5, 3 move_check_distance: 5 split_delta_z: .025 move_check_distance : 5 Valeur par d\u00e9faut : 5 La distance minimale de v\u00e9rification de changement de Z souhait\u00e9 avant d'effectuer un fractionnemeny. Dans cet exemple, un mouvement de plus de 5mm sera travers\u00e9 par l'algorithme. Tous les 5 mm, une recherche de maille Z sera effectu\u00e9e, en la comparant \u00e0 la valeur Z du mouvement pr\u00e9c\u00e9dent. Si le delta atteint le seuil fix\u00e9 par split_delta_z , le mouvement sera divis\u00e9 et la travers\u00e9e continuera. Ce processus se r\u00e9p\u00e8te jusqu'\u00e0 ce que la fin du d\u00e9placement soit atteinte, o\u00f9 un ajustement final sera appliqu\u00e9. Les d\u00e9placements plus courts que la move_check_distance ont l'ajustement Z correct appliqu\u00e9 directement au d\u00e9placement sans travers\u00e9e ou division. split_delta_z : .025 Valeur par d\u00e9faut : .025 Comme mentionn\u00e9 ci-dessus, il s'agit de l'\u00e9cart minimum requis pour d\u00e9clencher un fractionnement du mouvement. Dans cet exemple, toute valeur Z avec un \u00e9cart de +/- 0,025 mm d\u00e9clenchera un fractionnement. G\u00e9n\u00e9ralement les valeurs par d\u00e9faut de ces options sont suffisantes, en fait la valeur par d\u00e9faut de 5mm pour la move_check_distance est probablement exag\u00e9r\u00e9e. Cependant, un utilisateur avanc\u00e9 peut souhaiter exp\u00e9rimenter avec ces options dans le but d'obtenir une premi\u00e8re couche optimale. Att\u00e9nuation du maillage \u00b6 Lorsque l'option \"fondu\" est activ\u00e9e, l'ajustement du Z est r\u00e9duit progressivement sur une distance d\u00e9finie par la configuration. Ceci est r\u00e9alis\u00e9 en appliquant de petits ajustements \u00e0 la hauteur de la couche, en augmentant ou en diminuant selon la forme du lit. Lorsque le fondu est termin\u00e9, l'ajustement Z n'est plus appliqu\u00e9, ce qui permet au sommet de l'impression d'\u00eatre plat plut\u00f4t que de refl\u00e9ter la forme du lit. Le fondu peut \u00e9galement pr\u00e9senter quelques caract\u00e9ristiques ind\u00e9sirables, si le fondu est effectu\u00e9 trop rapidement, il peut entra\u00eener des artefacts visibles sur l'impression. De plus, si votre lit est sensiblement d\u00e9form\u00e9, le fondu peut r\u00e9tr\u00e9cir ou \u00e9tirer la hauteur Z de l'impression. C'est pourquoi le fondu est d\u00e9sactiv\u00e9 par d\u00e9faut. [bed_mesh] speed: 120 horizontal_move_z: 5 mesh_min: 35, 6 mesh_max: 240, 198 probe_count: 5, 3 fade_start: 1 fade_end: 10 fade_target: 0 fade_start: 1 Valeur par d\u00e9faut : 1 La hauteur Z \u00e0 laquelle il faut commencer l'att\u00e9nuation progressive de l'ajustement. C'est une bonne id\u00e9e d'avoir quelques couches d\u00e9j\u00e0 d\u00e9pos\u00e9es avant de commencer le processus de fondu. fade_end : 10 Valeur par d\u00e9faut : 0 La hauteur Z \u00e0 laquelle le fondu doit s'arr\u00eater. Si cette valeur est inf\u00e9rieure \u00e0 fade_start , le fondu est d\u00e9sactiv\u00e9. Cette valeur peut \u00eatre ajust\u00e9e en fonction de la d\u00e9formation de la surface d'impression. Une surface fortement d\u00e9form\u00e9e devrait s'estomper sur une plus grande distance. Une surface presque plate peut \u00eatre capable de r\u00e9duire cette valeur pour s'estomper plus rapidement. 10mm est une valeur raisonnable pour commencer si vous utilisez la valeur par d\u00e9faut de 1 pour fade_start . fade_target : 0 Valeur par d\u00e9faut : La valeur Z moyenne du maillage Le fade_target peut \u00eatre consid\u00e9r\u00e9 comme un d\u00e9calage Z suppl\u00e9mentaire appliqu\u00e9 \u00e0 l'ensemble du lit apr\u00e8s la fin du fondu. En g\u00e9n\u00e9ral, nous aimerions que cette valeur soit \u00e9gale \u00e0 0, mais il y a des circonstances o\u00f9 elle ne devrait pas l'\u00eatre. Par exemple, supposons que votre position d'origine sur le lit est aberrante, elle est inf\u00e9rieure de 0,2 mm \u00e0 la hauteur moyenne palp\u00e9e du lit. Si le fade_target est 0, le fondu va r\u00e9tr\u00e9cir l'impression d'une moyenne de 0,2 mm \u00e0 travers le lit. En r\u00e9glant la fade_target sur .2, la zone d'origine sera agrandie de .2 mm, mais le reste du lit aura une taille pr\u00e9cise. En g\u00e9n\u00e9ral, c'est une bonne id\u00e9e de laisser fade_target en dehors de la configuration afin que la hauteur moyenne du maillage soit utilis\u00e9e, cependant il peut \u00eatre souhaitable d'ajuster manuellement la cible du fondu si l'on ne veut imprimer que sur une partie sp\u00e9cifique du lit. L'indice de r\u00e9f\u00e9rence relatif \u00b6 La plupart des sondes sont sensibles \u00e0 une d\u00e9rive, c'est-\u00e0-dire \u00e0 des inexactitudes dans le palpage introduites par la chaleur ou des interf\u00e9rences. Cela peut rendre difficile le calcul du d\u00e9calage en Z de la sonde, en particulier \u00e0 diff\u00e9rentes temp\u00e9ratures du lit. C'est pourquoi certaines imprimantes utilisent \u00e0 la fois une but\u00e9e pour la mise \u00e0 l'origine de l'axe Z et une sonde pour r\u00e9aliser le maillage. Ces imprimantes peuvent b\u00e9n\u00e9ficier de la configuration de l'index de r\u00e9f\u00e9rence relatif. [bed_mesh] speed: 120 horizontal_move_z: 5 mesh_min: 35, 6 mesh_max: 240, 198 probe_count: 5, 3 relative_reference_index: 7 relative_reference_index : 7 Valeur par d\u00e9faut : None (d\u00e9sactiv\u00e9) Lorsque les points palp\u00e9s sont g\u00e9n\u00e9r\u00e9s, un index leur est attribu\u00e9. Vous pouvez consulter cet index dans klippy.log ou en utilisant BED_MESH_OUTPUT (voir la section sur les GCodes de maillage de lit ci-dessous pour plus d'informations). Si vous assignez un index \u00e0 l'option relative_reference_index , la valeur palp\u00e9e \u00e0 cette coordonn\u00e9e remplacera le z_offset de la sonde. Ce qui fait de cette coordonn\u00e9e la r\u00e9f\u00e9rence \"z\u00e9ro\" pour le maillage. Lorsque vous utilisez l'indice de r\u00e9f\u00e9rence relatif, vous devez choisir l'indice le plus proche de l'endroit du lit o\u00f9 le calibrage de la but\u00e9e Z a \u00e9t\u00e9 effectu\u00e9. Notez que lorsque vous recherchez l'indice en utilisant le journal ou BED_MESH_OUTPUT, vous devez utiliser les coordonn\u00e9es list\u00e9es sous l'en-t\u00eate \"Probe\" pour trouver l'indice correct. R\u00e9gions d\u00e9fectueuses \u00b6 Il est possible que certaines zones d'un lit donnent des r\u00e9sultats inexacts lors du palpage en raison d'un \"d\u00e9faut\" \u00e0 des endroits particuliers. Le meilleur exemple de ce ph\u00e9nom\u00e8ne est celui des lits comportant une s\u00e9rie d'aimants int\u00e9gr\u00e9s utilis\u00e9s pour retenir les t\u00f4les d'acier amovibles. Le champ magn\u00e9tique au niveau et autour de ces aimants peut faire qu'une sonde inductive se d\u00e9clenche \u00e0 une distance plus \u00e9lev\u00e9e ou plus basse qu'elle ne le ferait autrement, ce qui donne un maillage ne repr\u00e9sentant pas pr\u00e9cis\u00e9ment la surface \u00e0 ces endroits. Remarque : Il ne faut pas confondre ce ph\u00e9nom\u00e8ne avec le biais de l'emplacement de la sonde, qui produit des r\u00e9sultats inexacts sur l'ensemble du lit. Les options faulty_region peuvent \u00eatre configur\u00e9es pour compenser cet effet. Si un point g\u00e9n\u00e9r\u00e9 se trouve dans une r\u00e9gion d\u00e9fectueuse, le maillage du lit tentera de palper jusqu'\u00e0 4 points aux limites de cette r\u00e9gion. Ces valeurs palp\u00e9es seront moyenn\u00e9es et ins\u00e9r\u00e9es dans le maillage comme valeur Z \u00e0 la coordonn\u00e9e (X, Y) g\u00e9n\u00e9r\u00e9e. [bed_mesh] speed: 120 horizontal_move_z: 5 mesh_min: 35, 6 mesh_max: 240, 198 probe_count: 5, 3 faulty_region_1_min: 130.0, 0.0 faulty_region_1_max: 145.0, 40.0 faulty_region_2_min: 225.0, 0.0 faulty_region_2_max: 250.0, 25.0 faulty_region_3_min: 165.0, 95.0 faulty_region_3_max: 205.0, 110.0 faulty_region_4_min: 30.0, 170.0 faulty_region_4_max: 45.0, 210.0 faulty_region_{1...99}_min faulty_region_{1..99}_max Valeur par d\u00e9faut : None (d\u00e9sactiv\u00e9) Les r\u00e9gions d\u00e9fectueuses sont d\u00e9finies d'une mani\u00e8re similaire \u00e0 celle du maillage lui-m\u00eame, o\u00f9 les coordonn\u00e9es minimum et maximum (X, Y) doivent \u00eatre infiqu\u00e9es pour chaque r\u00e9gion. Une r\u00e9gion d\u00e9fectueuse peut s'\u00e9tendre \u00e0 l'ext\u00e9rieur d'un maillage, mais les points alternatifs g\u00e9n\u00e9r\u00e9s seront toujours \u00e0 l'int\u00e9rieur des limites du maillage. Deux r\u00e9gions ne peuvent pas se chevaucher. L'image ci-dessous illustre comment les points de remplacement sont g\u00e9n\u00e9r\u00e9s lorsqu'un point g\u00e9n\u00e9r\u00e9 se trouve dans une r\u00e9gion d\u00e9fectueuse. Les r\u00e9gions repr\u00e9sent\u00e9es correspondent \u00e0 celles de l'exemple de configuration ci-dessus. Les points de remplacement et leurs coordonn\u00e9es sont identifi\u00e9s en vert. Gcodes de maillage du lit \u00b6 Calibration \u00b6 BED_MESH_CALIBRATE PROFILE=<name> METHOD=[manual | automatic] [<probe_parameter>=<value>] [<mesh_parameter>=<value>] Profil par d\u00e9faut : default M\u00e9thode par d\u00e9faut : automatique si une sonde est d\u00e9tect\u00e9e, sinon manuelle Lance la proc\u00e9dure de palpage de l'\u00e9talonnage du maillage du lit. Le maillage sera sauvegard\u00e9 dans un profil indiqu\u00e9 par le param\u00e8tre PROFILE , ou default si non pr\u00e9cis\u00e9. Si METHOD=manual est s\u00e9lectionn\u00e9, un palpage manuel sera effectu\u00e9. Lorsque vous passez du mode automatique au mode manuel, les points de maillage g\u00e9n\u00e9r\u00e9s seront automatiquement ajust\u00e9s. Il est possible de sp\u00e9cifier des param\u00e8tres de maillage pour modifier la zone palp\u00e9e. Les param\u00e8tres suivants sont disponibles : Lits rectangulaires (cart\u00e9siens) : MESH_MIN MESH_MAX PROBE_COUNT Lits circulaires (delta) : MESH_RADIUS MESH_ORIGIN ROUND_PROBE_COUNT Tous les lits : RELATIVE_REFERNCE_INDEX ALGORITHM Consultez la documentation de configuration ci-dessus pour plus de d\u00e9tails sur la fa\u00e7on dont chaque param\u00e8tre s'applique au maillage. Profils \u00b6 BED_MESH_PROFILE SAVE=<name> LOAD=<name> REMOVE=<name> Apr\u00e8s avoir r\u00e9alis\u00e9 un BED_MESH_CALIBRATE, il est possible de sauvegarder l'\u00e9tat actuel du maillage dans un profil nomm\u00e9. Cela permet de charger un maillage sans re-palper le lit. Apr\u00e8s qu'un profil ait \u00e9t\u00e9 enregistr\u00e9 en utilisant BED_MESH_PROFILE SAVE=<name> , le gcode SAVE_CONFIG peut \u00eatre ex\u00e9cut\u00e9 pour \u00e9crire le profil dans printer.cfg. Les profils peuvent \u00eatre charg\u00e9s en ex\u00e9cutant BED_MESH_PROFILE LOAD=<name> . Il convient de noter que chaque fois qu'un BED_MESH_CALIBRATE est produit, l'\u00e9tat actuel est automatiquement enregistr\u00e9 dans le profil par d\u00e9faut . Si ce profil existe, il est automatiquement charg\u00e9 au d\u00e9marrage de Klipper. Si ce comportement n'est pas souhaitable, le profil par d\u00e9faut peut \u00eatre supprim\u00e9 comme suit : BED_MESH_PROFILE REMOVE=default Tout autre profil enregistr\u00e9 peut \u00eatre supprim\u00e9 de la m\u00eame mani\u00e8re, en rempla\u00e7ant default par le nom du profil que vous souhaitez supprimer. Loading the default profile \u00b6 Previous versions of bed_mesh always loaded the profile named default on startup if it was present. This behavior has been removed in favor of allowing the user to determine when a profile is loaded. If a user wishes to load the default profile it is recommended to add BED_MESH_PROFILE LOAD=default to either their START_PRINT macro or their slicer's \"Start G-Code\" configuration, whichever is applicable. Alternatively the old behavior of loading a profile at startup can be restored with a [delayed_gcode] : [delayed_gcode bed_mesh_init] initial_duration : .01 gcode : BED_MESH_PROFILE LOAD = default Sortie \u00b6 BED_MESH_OUTPUT PGP=[0 | 1] Affiche l'\u00e9tat actuel du maillage dans le terminal. Notez que le maillage lui-m\u00eame est affich\u00e9 Le param\u00e8tre PGP est l'abr\u00e9viation de \"Print Generated Points\". Si PGP=1 est d\u00e9fini, les points palp\u00e9s g\u00e9n\u00e9r\u00e9s seront affich\u00e9s sur le terminal : // bed_mesh: generated points // Index | Tool Adjusted | Probe // 0 | (11.0, 1.0) | (35.0, 6.0) // 1 | (62.2, 1.0) | (86.2, 6.0) // 2 | (113.5, 1.0) | (137.5, 6.0) // 3 | (164.8, 1.0) | (188.8, 6.0) // 4 | (216.0, 1.0) | (240.0, 6.0) // 5 | (216.0, 97.0) | (240.0, 102.0) // 6 | (164.8, 97.0) | (188.8, 102.0) // 7 | (113.5, 97.0) | (137.5, 102.0) // 8 | (62.2, 97.0) | (86.2, 102.0) // 9 | (11.0, 97.0) | (35.0, 102.0) // 10 | (11.0, 193.0) | (35.0, 198.0) // 11 | (62.2, 193.0) | (86.2, 198.0) // 12 | (113.5, 193.0) | (137.5, 198.0) // 13 | (164.8, 193.0) | (188.8, 198.0) // 14 | (216.0, 193.0) | (240.0, 198.0) Les points de la colonne \"Tool Adjusted\" font r\u00e9f\u00e9rence \u00e0 l'emplacement de la buse, et les points de la colonne \"Probe\" font r\u00e9f\u00e9rence \u00e0 l'emplacement du palpeur. Notez que lors d'un palpage manuel, les points \"Probe\" se r\u00e9f\u00e8rent \u00e0 la fois \u00e0 l'emplacement de l'outil et de la buse. Effacer l'\u00e9tat du maillage \u00b6 BED_MESH_CLEAR Ce G-Code peut \u00eatre utilis\u00e9 pour effacer l'\u00e9tat interne du maillage. Appliquer les d\u00e9calages X/Y \u00b6 BED_MESH_OFFSET [X=<value>] [Y=<value>] Ceci est utile pour les imprimantes avec plusieurs extrudeuses ind\u00e9pendantes, car un d\u00e9calage est n\u00e9cessaire pour produire un ajustement Z correct apr\u00e8s un changement d'outil. Les d\u00e9calages doivent \u00eatre indiqu\u00e9s par rapport \u00e0 l'extrudeuse primaire. C'est-\u00e0-dire qu'un d\u00e9calage X positif doit \u00eatre indiqu\u00e9 si l'extrudeuse secondaire est mont\u00e9e \u00e0 droite de l'extrudeuse primaire, et un d\u00e9calage Y positif doit \u00eatre indiqu\u00e9 si l'extrudeuse secondaire est mont\u00e9e \"derri\u00e8re\" l'extrudeuse primaire.","title":"Maillage du Bed"},{"location":"Bed_Mesh.html#maillage-du-bed","text":"Le module Maillage du lit peut \u00eatre utilis\u00e9 pour compenser les irr\u00e9gularit\u00e9s de la surface du lit afin d'obtenir une meilleure premi\u00e8re couche sur l'ensemble du lit. Il convient de noter que la correction logicielle ne permet pas d'obtenir de r\u00e9sultats parfaits, elle ne peut qu'approximer la forme du lit. Le maillage du lit ne peut pas non plus compenser les probl\u00e8mes m\u00e9caniques et \u00e9lectriques. Si un axe est de travers ou si un palpeur n'est pas pr\u00e9cis, le module bed_mesh n'obtiendra pas de r\u00e9sultats pr\u00e9cis lors du processus de palpage. Avant de proc\u00e9der \u00e0 l'\u00e9talonnage du maillage, vous devez vous assurer que l'offset Z de votre sonde est r\u00e9gl\u00e9. Si vous utilisez une but\u00e9e de fin de course pour la mise \u00e0 l'origine en Z, elle doit \u00e9galement \u00eatre r\u00e9gl\u00e9e. Voir Calibration de la sonde et Z_ENDSTOP_CALIBRATE dans Nivelage manuel pour plus d'informations.","title":"Maillage du Bed"},{"location":"Bed_Mesh.html#configuration-de-base","text":"","title":"Configuration de base"},{"location":"Bed_Mesh.html#lits-rectangulaires","text":"Cet exemple suppose une imprimante avec un lit rectangulaire de 250 mm x 220 mm et une sonde avec un d\u00e9calage x de 24 mm et un d\u00e9calage y de 5 mm. [bed_mesh] speed: 120 horizontal_move_z: 5 mesh_min: 35, 6 mesh_max: 240, 198 probe_count: 5, 3 speed : 120 Valeur par d\u00e9faut : 50 La vitesse \u00e0 laquelle l'outil se d\u00e9place entre les points palp\u00e9s. horizontal_move_z : 5 Valeur par d\u00e9faut : 5 La coordonn\u00e9e Z \u00e0 laquelle la sonde s'\u00e9l\u00e8ve avant de se d\u00e9placer entre les points. mesh_min : 35, 6 Requis La premi\u00e8re coordonn\u00e9e palp\u00e9e, la plus proche de l'origine. Cette coordonn\u00e9e est relative \u00e0 l'emplacement de la sonde. mesh_max : 240, 198 Requis La coordonn\u00e9e palp\u00e9e la plus \u00e9loign\u00e9e de l'origine. Ce n'est pas n\u00e9cessairement le dernier point palp\u00e9, car le processus de palpage se d\u00e9roule en zig-zag. Comme pour mesh_min , cette coordonn\u00e9e est relative \u00e0 l'emplacement de la sonde. probe_count : 5, 3 Valeur par d\u00e9faut : 3, 3 Le nombre de points \u00e0 palper sur chaque axe, sp\u00e9cifi\u00e9 sous forme de valeurs enti\u00e8res X, Y. Dans cet exemple, 5 points seront palp\u00e9s le long de l'axe X, avec 3 points le long de l'axe Y, pour un total de 15 points palp\u00e9s. Notez que si vous voulez une grille carr\u00e9e, par exemple 3x3, il est possible de n'utiliser qu'une seule valeur enti\u00e8re pour les deux axes, par exemple probe_count : 3 . Notez qu'un maillage n\u00e9cessite un nombre minimum de 3 points de sondage sur chaque axe. L'illustration ci-dessous montre comment les options mesh_min , mesh_max , et probe_count sont utilis\u00e9es pour g\u00e9n\u00e9rer des points de palpage. Les fl\u00e8ches indiquent la direction de la proc\u00e9dure de palpage, commen\u00e7ant en mesh_min . Pour r\u00e9f\u00e9rence, lorsque la sonde est \u00e0 mesh_min , la buse sera \u00e0 (11, 1), et lorsque la sonde est \u00e0 mesh_max , la buse sera \u00e0 (206, 193).","title":"Lits rectangulaires"},{"location":"Bed_Mesh.html#lits-circulaires","text":"Cet exemple suppose une imprimante \u00e9quip\u00e9e d'un lit circulaire de 100 mm de rayon. Nous utiliserons les m\u00eames d\u00e9calages de sonde que dans l'exemple rectangulaire, 24 mm sur X et 5 mm sur Y. [bed_mesh] speed: 120 horizontal_move_z: 5 mesh_radius: 75 mesh_origin: 0, 0 round_probe_count: 5 mesh_radius : 75 Requis Le rayon du maillage palp\u00e9 en mm, par rapport \u00e0 mesh_origin . Notez que les d\u00e9calages de la sonde limitent la taille du rayon du maillage. Dans cet exemple, un rayon sup\u00e9rieur \u00e0 76 d\u00e9placerait la t\u00eate de l'outil en dehors des limites physiques de l'imprimante. mesh_origin : 0, 0 Valeur par d\u00e9faut : 0, 0 Le point central du maillage. Cette coordonn\u00e9e est relative \u00e0 l'emplacement de la sonde. Bien que la valeur par d\u00e9faut soit 0, 0, il peut \u00eatre utile d'ajuster l'origine dans le but de sonder une plus grande partie du lit. Voir l'illustration ci-dessous. round_probe_count : 5 Valeur par d\u00e9faut : 5 C'est une valeur enti\u00e8re d\u00e9finissant le nombre maximum de points palp\u00e9s le long des axes X et Y. Par \"maximum\", nous entendons le nombre de points palp\u00e9s le long de l'origine du maillage. Cette valeur doit \u00eatre un nombre impair, car il est n\u00e9cessaire que le centre du maillage soit palp\u00e9. L'illustration ci-dessous montre comment les points palp\u00e9s sont g\u00e9n\u00e9r\u00e9s. Comme vous pouvez le voir, le r\u00e9glage de mesh_origin \u00e0 (-10, 0) nous permet de sp\u00e9cifier un rayon de maillage plus grand de 85.","title":"Lits circulaires"},{"location":"Bed_Mesh.html#configuration-avancee","text":"Les options de configuration plus avanc\u00e9es sont expliqu\u00e9es en d\u00e9tail ci-dessous. Chaque exemple s'appuie sur la configuration de base du lit rectangulaire pr\u00e9sent\u00e9e ci-dessus. Chacune des options avanc\u00e9es s'applique de la m\u00eame mani\u00e8re aux lits circulaires.","title":"Configuration avanc\u00e9e"},{"location":"Bed_Mesh.html#interpolation-du-maillage","text":"Bien qu'il soit possible d'\u00e9chantillonner directement la matrice palp\u00e9e en utilisant une simple interpolation bilin\u00e9aire afin de d\u00e9terminer les valeurs Z entre les points palp\u00e9s, il est souvent utile d'interpoler des points suppl\u00e9mentaires en utilisant des algorithmes d'interpolation plus avanc\u00e9s pour augmenter la densit\u00e9 du maillage. Ces algorithmes ajoutent une courbure au maillage, en essayant de simuler les propri\u00e9t\u00e9s mat\u00e9rielles du lit. Le maillage du lit offre l'interpolation de lagrange et bicubique pour accomplir ceci. [bed_mesh] speed: 120 horizontal_move_z: 5 mesh_min: 35, 6 mesh_max: 240, 198 probe_count: 5, 3 mesh_pps: 2, 3 algorithm: bicubic bicubic_tension: 0.2 mesh_pps : 2, 3 Valeur par d\u00e9faut : 2, 2 L'option mesh_pps est l'abr\u00e9viation de Mesh Points Per Segment. Cette option indique le nombre de points \u00e0 interpoler pour chaque segment le long des axes X et Y. Un 'segment' est l'espace entre chaque point palp\u00e9. Comme pour probe_count , mesh_pps est sp\u00e9cifi\u00e9 en tant que paire de nombres entiers X, Y mais peut aussi \u00eatre sp\u00e9cifi\u00e9 comme un seul nombre entier en ce cas appliqu\u00e9 aux deux axes. Dans cet exemple, il y a 4 segments le long de l'axe X et 2 segments le long de l'axe Y. Cela r\u00e9sulte en 8 points interpol\u00e9s le long de l'axe X et 6 points interpol\u00e9s le long de l'axe Y, ce qui donne un maillage de 13x8. Notez que si mesh_pps est d\u00e9fini \u00e0 0, l'interpolation de maillage est d\u00e9sactiv\u00e9e et la matrice sond\u00e9e sera \u00e9chantillonn\u00e9e directement. algorithm : lagrange Valeur par d\u00e9faut : lagrange L'algorithme utilis\u00e9 pour interpoler le maillage. Peut \u00eatre lagrange ou bicubique . L'interpolation de Lagrange est plafonn\u00e9e \u00e0 6 points palp\u00e9s car une oscillation tend \u00e0 se produire avec un plus grand nombre d'\u00e9chantillons. L'interpolation bicubique requiert un minimum de 4 points le long de chaque axe, si moins de 4 points sont sp\u00e9cifi\u00e9s, l'\u00e9chantillonnage de Lagrange est forc\u00e9. Si mesh_pps est d\u00e9fini \u00e0 0 alors cette valeur est ignor\u00e9e car aucune interpolation de maille n'est faite. bicubic_tension : 0.2 Valeur par d\u00e9faut : 0.2 Si l'option algorithm est d\u00e9finie sur bicubique, il est possible d'indiquer une valeur de tension. Plus la tension est \u00e9lev\u00e9e, plus la pente est interpol\u00e9e. Soyez prudent lorsque vous ajustez cette valeur, car des valeurs plus \u00e9lev\u00e9es cr\u00e9ent \u00e9galement plus de d\u00e9passement, ce qui entra\u00eenera des valeurs interpol\u00e9es plus \u00e9lev\u00e9es ou plus basses que vos points palp\u00e9s. L'illustration ci-dessous montre comment les options ci-dessus sont utilis\u00e9es pour g\u00e9n\u00e9rer un maillage interpol\u00e9.","title":"Interpolation du maillage"},{"location":"Bed_Mesh.html#fractionnement-des-deplacements","text":"Le maillage du lit fonctionne en interceptant les commandes de d\u00e9placement du gcode et en appliquant une transformation \u00e0 leur coordonn\u00e9e Z. Les longs d\u00e9placements doivent \u00eatre divis\u00e9s en d\u00e9placements plus petits pour suivre correctement la forme du lit. Les options ci-dessous contr\u00f4lent le comportement du fractionnement. [bed_mesh] speed: 120 horizontal_move_z: 5 mesh_min: 35, 6 mesh_max: 240, 198 probe_count: 5, 3 move_check_distance: 5 split_delta_z: .025 move_check_distance : 5 Valeur par d\u00e9faut : 5 La distance minimale de v\u00e9rification de changement de Z souhait\u00e9 avant d'effectuer un fractionnemeny. Dans cet exemple, un mouvement de plus de 5mm sera travers\u00e9 par l'algorithme. Tous les 5 mm, une recherche de maille Z sera effectu\u00e9e, en la comparant \u00e0 la valeur Z du mouvement pr\u00e9c\u00e9dent. Si le delta atteint le seuil fix\u00e9 par split_delta_z , le mouvement sera divis\u00e9 et la travers\u00e9e continuera. Ce processus se r\u00e9p\u00e8te jusqu'\u00e0 ce que la fin du d\u00e9placement soit atteinte, o\u00f9 un ajustement final sera appliqu\u00e9. Les d\u00e9placements plus courts que la move_check_distance ont l'ajustement Z correct appliqu\u00e9 directement au d\u00e9placement sans travers\u00e9e ou division. split_delta_z : .025 Valeur par d\u00e9faut : .025 Comme mentionn\u00e9 ci-dessus, il s'agit de l'\u00e9cart minimum requis pour d\u00e9clencher un fractionnement du mouvement. Dans cet exemple, toute valeur Z avec un \u00e9cart de +/- 0,025 mm d\u00e9clenchera un fractionnement. G\u00e9n\u00e9ralement les valeurs par d\u00e9faut de ces options sont suffisantes, en fait la valeur par d\u00e9faut de 5mm pour la move_check_distance est probablement exag\u00e9r\u00e9e. Cependant, un utilisateur avanc\u00e9 peut souhaiter exp\u00e9rimenter avec ces options dans le but d'obtenir une premi\u00e8re couche optimale.","title":"Fractionnement des d\u00e9placements"},{"location":"Bed_Mesh.html#attenuation-du-maillage","text":"Lorsque l'option \"fondu\" est activ\u00e9e, l'ajustement du Z est r\u00e9duit progressivement sur une distance d\u00e9finie par la configuration. Ceci est r\u00e9alis\u00e9 en appliquant de petits ajustements \u00e0 la hauteur de la couche, en augmentant ou en diminuant selon la forme du lit. Lorsque le fondu est termin\u00e9, l'ajustement Z n'est plus appliqu\u00e9, ce qui permet au sommet de l'impression d'\u00eatre plat plut\u00f4t que de refl\u00e9ter la forme du lit. Le fondu peut \u00e9galement pr\u00e9senter quelques caract\u00e9ristiques ind\u00e9sirables, si le fondu est effectu\u00e9 trop rapidement, il peut entra\u00eener des artefacts visibles sur l'impression. De plus, si votre lit est sensiblement d\u00e9form\u00e9, le fondu peut r\u00e9tr\u00e9cir ou \u00e9tirer la hauteur Z de l'impression. C'est pourquoi le fondu est d\u00e9sactiv\u00e9 par d\u00e9faut. [bed_mesh] speed: 120 horizontal_move_z: 5 mesh_min: 35, 6 mesh_max: 240, 198 probe_count: 5, 3 fade_start: 1 fade_end: 10 fade_target: 0 fade_start: 1 Valeur par d\u00e9faut : 1 La hauteur Z \u00e0 laquelle il faut commencer l'att\u00e9nuation progressive de l'ajustement. C'est une bonne id\u00e9e d'avoir quelques couches d\u00e9j\u00e0 d\u00e9pos\u00e9es avant de commencer le processus de fondu. fade_end : 10 Valeur par d\u00e9faut : 0 La hauteur Z \u00e0 laquelle le fondu doit s'arr\u00eater. Si cette valeur est inf\u00e9rieure \u00e0 fade_start , le fondu est d\u00e9sactiv\u00e9. Cette valeur peut \u00eatre ajust\u00e9e en fonction de la d\u00e9formation de la surface d'impression. Une surface fortement d\u00e9form\u00e9e devrait s'estomper sur une plus grande distance. Une surface presque plate peut \u00eatre capable de r\u00e9duire cette valeur pour s'estomper plus rapidement. 10mm est une valeur raisonnable pour commencer si vous utilisez la valeur par d\u00e9faut de 1 pour fade_start . fade_target : 0 Valeur par d\u00e9faut : La valeur Z moyenne du maillage Le fade_target peut \u00eatre consid\u00e9r\u00e9 comme un d\u00e9calage Z suppl\u00e9mentaire appliqu\u00e9 \u00e0 l'ensemble du lit apr\u00e8s la fin du fondu. En g\u00e9n\u00e9ral, nous aimerions que cette valeur soit \u00e9gale \u00e0 0, mais il y a des circonstances o\u00f9 elle ne devrait pas l'\u00eatre. Par exemple, supposons que votre position d'origine sur le lit est aberrante, elle est inf\u00e9rieure de 0,2 mm \u00e0 la hauteur moyenne palp\u00e9e du lit. Si le fade_target est 0, le fondu va r\u00e9tr\u00e9cir l'impression d'une moyenne de 0,2 mm \u00e0 travers le lit. En r\u00e9glant la fade_target sur .2, la zone d'origine sera agrandie de .2 mm, mais le reste du lit aura une taille pr\u00e9cise. En g\u00e9n\u00e9ral, c'est une bonne id\u00e9e de laisser fade_target en dehors de la configuration afin que la hauteur moyenne du maillage soit utilis\u00e9e, cependant il peut \u00eatre souhaitable d'ajuster manuellement la cible du fondu si l'on ne veut imprimer que sur une partie sp\u00e9cifique du lit.","title":"Att\u00e9nuation du maillage"},{"location":"Bed_Mesh.html#lindice-de-reference-relatif","text":"La plupart des sondes sont sensibles \u00e0 une d\u00e9rive, c'est-\u00e0-dire \u00e0 des inexactitudes dans le palpage introduites par la chaleur ou des interf\u00e9rences. Cela peut rendre difficile le calcul du d\u00e9calage en Z de la sonde, en particulier \u00e0 diff\u00e9rentes temp\u00e9ratures du lit. C'est pourquoi certaines imprimantes utilisent \u00e0 la fois une but\u00e9e pour la mise \u00e0 l'origine de l'axe Z et une sonde pour r\u00e9aliser le maillage. Ces imprimantes peuvent b\u00e9n\u00e9ficier de la configuration de l'index de r\u00e9f\u00e9rence relatif. [bed_mesh] speed: 120 horizontal_move_z: 5 mesh_min: 35, 6 mesh_max: 240, 198 probe_count: 5, 3 relative_reference_index: 7 relative_reference_index : 7 Valeur par d\u00e9faut : None (d\u00e9sactiv\u00e9) Lorsque les points palp\u00e9s sont g\u00e9n\u00e9r\u00e9s, un index leur est attribu\u00e9. Vous pouvez consulter cet index dans klippy.log ou en utilisant BED_MESH_OUTPUT (voir la section sur les GCodes de maillage de lit ci-dessous pour plus d'informations). Si vous assignez un index \u00e0 l'option relative_reference_index , la valeur palp\u00e9e \u00e0 cette coordonn\u00e9e remplacera le z_offset de la sonde. Ce qui fait de cette coordonn\u00e9e la r\u00e9f\u00e9rence \"z\u00e9ro\" pour le maillage. Lorsque vous utilisez l'indice de r\u00e9f\u00e9rence relatif, vous devez choisir l'indice le plus proche de l'endroit du lit o\u00f9 le calibrage de la but\u00e9e Z a \u00e9t\u00e9 effectu\u00e9. Notez que lorsque vous recherchez l'indice en utilisant le journal ou BED_MESH_OUTPUT, vous devez utiliser les coordonn\u00e9es list\u00e9es sous l'en-t\u00eate \"Probe\" pour trouver l'indice correct.","title":"L'indice de r\u00e9f\u00e9rence relatif"},{"location":"Bed_Mesh.html#regions-defectueuses","text":"Il est possible que certaines zones d'un lit donnent des r\u00e9sultats inexacts lors du palpage en raison d'un \"d\u00e9faut\" \u00e0 des endroits particuliers. Le meilleur exemple de ce ph\u00e9nom\u00e8ne est celui des lits comportant une s\u00e9rie d'aimants int\u00e9gr\u00e9s utilis\u00e9s pour retenir les t\u00f4les d'acier amovibles. Le champ magn\u00e9tique au niveau et autour de ces aimants peut faire qu'une sonde inductive se d\u00e9clenche \u00e0 une distance plus \u00e9lev\u00e9e ou plus basse qu'elle ne le ferait autrement, ce qui donne un maillage ne repr\u00e9sentant pas pr\u00e9cis\u00e9ment la surface \u00e0 ces endroits. Remarque : Il ne faut pas confondre ce ph\u00e9nom\u00e8ne avec le biais de l'emplacement de la sonde, qui produit des r\u00e9sultats inexacts sur l'ensemble du lit. Les options faulty_region peuvent \u00eatre configur\u00e9es pour compenser cet effet. Si un point g\u00e9n\u00e9r\u00e9 se trouve dans une r\u00e9gion d\u00e9fectueuse, le maillage du lit tentera de palper jusqu'\u00e0 4 points aux limites de cette r\u00e9gion. Ces valeurs palp\u00e9es seront moyenn\u00e9es et ins\u00e9r\u00e9es dans le maillage comme valeur Z \u00e0 la coordonn\u00e9e (X, Y) g\u00e9n\u00e9r\u00e9e. [bed_mesh] speed: 120 horizontal_move_z: 5 mesh_min: 35, 6 mesh_max: 240, 198 probe_count: 5, 3 faulty_region_1_min: 130.0, 0.0 faulty_region_1_max: 145.0, 40.0 faulty_region_2_min: 225.0, 0.0 faulty_region_2_max: 250.0, 25.0 faulty_region_3_min: 165.0, 95.0 faulty_region_3_max: 205.0, 110.0 faulty_region_4_min: 30.0, 170.0 faulty_region_4_max: 45.0, 210.0 faulty_region_{1...99}_min faulty_region_{1..99}_max Valeur par d\u00e9faut : None (d\u00e9sactiv\u00e9) Les r\u00e9gions d\u00e9fectueuses sont d\u00e9finies d'une mani\u00e8re similaire \u00e0 celle du maillage lui-m\u00eame, o\u00f9 les coordonn\u00e9es minimum et maximum (X, Y) doivent \u00eatre infiqu\u00e9es pour chaque r\u00e9gion. Une r\u00e9gion d\u00e9fectueuse peut s'\u00e9tendre \u00e0 l'ext\u00e9rieur d'un maillage, mais les points alternatifs g\u00e9n\u00e9r\u00e9s seront toujours \u00e0 l'int\u00e9rieur des limites du maillage. Deux r\u00e9gions ne peuvent pas se chevaucher. L'image ci-dessous illustre comment les points de remplacement sont g\u00e9n\u00e9r\u00e9s lorsqu'un point g\u00e9n\u00e9r\u00e9 se trouve dans une r\u00e9gion d\u00e9fectueuse. Les r\u00e9gions repr\u00e9sent\u00e9es correspondent \u00e0 celles de l'exemple de configuration ci-dessus. Les points de remplacement et leurs coordonn\u00e9es sont identifi\u00e9s en vert.","title":"R\u00e9gions d\u00e9fectueuses"},{"location":"Bed_Mesh.html#gcodes-de-maillage-du-lit","text":"","title":"Gcodes de maillage du lit"},{"location":"Bed_Mesh.html#calibration","text":"BED_MESH_CALIBRATE PROFILE=<name> METHOD=[manual | automatic] [<probe_parameter>=<value>] [<mesh_parameter>=<value>] Profil par d\u00e9faut : default M\u00e9thode par d\u00e9faut : automatique si une sonde est d\u00e9tect\u00e9e, sinon manuelle Lance la proc\u00e9dure de palpage de l'\u00e9talonnage du maillage du lit. Le maillage sera sauvegard\u00e9 dans un profil indiqu\u00e9 par le param\u00e8tre PROFILE , ou default si non pr\u00e9cis\u00e9. Si METHOD=manual est s\u00e9lectionn\u00e9, un palpage manuel sera effectu\u00e9. Lorsque vous passez du mode automatique au mode manuel, les points de maillage g\u00e9n\u00e9r\u00e9s seront automatiquement ajust\u00e9s. Il est possible de sp\u00e9cifier des param\u00e8tres de maillage pour modifier la zone palp\u00e9e. Les param\u00e8tres suivants sont disponibles : Lits rectangulaires (cart\u00e9siens) : MESH_MIN MESH_MAX PROBE_COUNT Lits circulaires (delta) : MESH_RADIUS MESH_ORIGIN ROUND_PROBE_COUNT Tous les lits : RELATIVE_REFERNCE_INDEX ALGORITHM Consultez la documentation de configuration ci-dessus pour plus de d\u00e9tails sur la fa\u00e7on dont chaque param\u00e8tre s'applique au maillage.","title":"Calibration"},{"location":"Bed_Mesh.html#profils","text":"BED_MESH_PROFILE SAVE=<name> LOAD=<name> REMOVE=<name> Apr\u00e8s avoir r\u00e9alis\u00e9 un BED_MESH_CALIBRATE, il est possible de sauvegarder l'\u00e9tat actuel du maillage dans un profil nomm\u00e9. Cela permet de charger un maillage sans re-palper le lit. Apr\u00e8s qu'un profil ait \u00e9t\u00e9 enregistr\u00e9 en utilisant BED_MESH_PROFILE SAVE=<name> , le gcode SAVE_CONFIG peut \u00eatre ex\u00e9cut\u00e9 pour \u00e9crire le profil dans printer.cfg. Les profils peuvent \u00eatre charg\u00e9s en ex\u00e9cutant BED_MESH_PROFILE LOAD=<name> . Il convient de noter que chaque fois qu'un BED_MESH_CALIBRATE est produit, l'\u00e9tat actuel est automatiquement enregistr\u00e9 dans le profil par d\u00e9faut . Si ce profil existe, il est automatiquement charg\u00e9 au d\u00e9marrage de Klipper. Si ce comportement n'est pas souhaitable, le profil par d\u00e9faut peut \u00eatre supprim\u00e9 comme suit : BED_MESH_PROFILE REMOVE=default Tout autre profil enregistr\u00e9 peut \u00eatre supprim\u00e9 de la m\u00eame mani\u00e8re, en rempla\u00e7ant default par le nom du profil que vous souhaitez supprimer.","title":"Profils"},{"location":"Bed_Mesh.html#loading-the-default-profile","text":"Previous versions of bed_mesh always loaded the profile named default on startup if it was present. This behavior has been removed in favor of allowing the user to determine when a profile is loaded. If a user wishes to load the default profile it is recommended to add BED_MESH_PROFILE LOAD=default to either their START_PRINT macro or their slicer's \"Start G-Code\" configuration, whichever is applicable. Alternatively the old behavior of loading a profile at startup can be restored with a [delayed_gcode] : [delayed_gcode bed_mesh_init] initial_duration : .01 gcode : BED_MESH_PROFILE LOAD = default","title":"Loading the default profile"},{"location":"Bed_Mesh.html#sortie","text":"BED_MESH_OUTPUT PGP=[0 | 1] Affiche l'\u00e9tat actuel du maillage dans le terminal. Notez que le maillage lui-m\u00eame est affich\u00e9 Le param\u00e8tre PGP est l'abr\u00e9viation de \"Print Generated Points\". Si PGP=1 est d\u00e9fini, les points palp\u00e9s g\u00e9n\u00e9r\u00e9s seront affich\u00e9s sur le terminal : // bed_mesh: generated points // Index | Tool Adjusted | Probe // 0 | (11.0, 1.0) | (35.0, 6.0) // 1 | (62.2, 1.0) | (86.2, 6.0) // 2 | (113.5, 1.0) | (137.5, 6.0) // 3 | (164.8, 1.0) | (188.8, 6.0) // 4 | (216.0, 1.0) | (240.0, 6.0) // 5 | (216.0, 97.0) | (240.0, 102.0) // 6 | (164.8, 97.0) | (188.8, 102.0) // 7 | (113.5, 97.0) | (137.5, 102.0) // 8 | (62.2, 97.0) | (86.2, 102.0) // 9 | (11.0, 97.0) | (35.0, 102.0) // 10 | (11.0, 193.0) | (35.0, 198.0) // 11 | (62.2, 193.0) | (86.2, 198.0) // 12 | (113.5, 193.0) | (137.5, 198.0) // 13 | (164.8, 193.0) | (188.8, 198.0) // 14 | (216.0, 193.0) | (240.0, 198.0) Les points de la colonne \"Tool Adjusted\" font r\u00e9f\u00e9rence \u00e0 l'emplacement de la buse, et les points de la colonne \"Probe\" font r\u00e9f\u00e9rence \u00e0 l'emplacement du palpeur. Notez que lors d'un palpage manuel, les points \"Probe\" se r\u00e9f\u00e8rent \u00e0 la fois \u00e0 l'emplacement de l'outil et de la buse.","title":"Sortie"},{"location":"Bed_Mesh.html#effacer-letat-du-maillage","text":"BED_MESH_CLEAR Ce G-Code peut \u00eatre utilis\u00e9 pour effacer l'\u00e9tat interne du maillage.","title":"Effacer l'\u00e9tat du maillage"},{"location":"Bed_Mesh.html#appliquer-les-decalages-xy","text":"BED_MESH_OFFSET [X=<value>] [Y=<value>] Ceci est utile pour les imprimantes avec plusieurs extrudeuses ind\u00e9pendantes, car un d\u00e9calage est n\u00e9cessaire pour produire un ajustement Z correct apr\u00e8s un changement d'outil. Les d\u00e9calages doivent \u00eatre indiqu\u00e9s par rapport \u00e0 l'extrudeuse primaire. C'est-\u00e0-dire qu'un d\u00e9calage X positif doit \u00eatre indiqu\u00e9 si l'extrudeuse secondaire est mont\u00e9e \u00e0 droite de l'extrudeuse primaire, et un d\u00e9calage Y positif doit \u00eatre indiqu\u00e9 si l'extrudeuse secondaire est mont\u00e9e \"derri\u00e8re\" l'extrudeuse primaire.","title":"Appliquer les d\u00e9calages X/Y"},{"location":"Benchmarks.html","text":"Tests \u00b6 Ce document d\u00e9crit les benchmarks Klipper. Bancs d'essai des microcontr\u00f4leurs \u00b6 Cette section d\u00e9crit le m\u00e9canisme utilis\u00e9 pour g\u00e9n\u00e9rer les bancs d'essais (benchmarks) de fr\u00e9quence de pas du microcontr\u00f4leur Klipper. L'objectif principal des bancs d'essais est de fournir un m\u00e9canisme coh\u00e9rent pour mesurer l'impact des changements de codage dans le logiciel. Un objectif secondaire est de fournir des mesures de haut niveau pour comparer les performances entre puces et entre plateformes logicielles. Le test de vitesse des moteurs pas \u00e0 pas est con\u00e7u pour trouver la fr\u00e9quence de pas maximale que le mat\u00e9riel et le logiciel peuvent atteindre. Ce taux de pas de r\u00e9f\u00e9rence n'est pas r\u00e9alisable dans une utilisation normale de Klipper car il doit effectuer d'autres t\u00e2ches (par exemple, la communication mcu/h\u00f4te, la lecture de la temp\u00e9rature, la v\u00e9rification des fin de course). En g\u00e9n\u00e9ral, les broches pour les tests sont choisies pour faire clignoter des LED ou d'autres actions inoffensives. V\u00e9rifiez toujours qu'il est s\u00fbr de commander les broches configur\u00e9es avant d'ex\u00e9cuter un test. Il n'est pas recommand\u00e9 de piloter un moteur pas \u00e0 pas lors d'un benchmark. Test du taux de pas \u00b6 Le test est effectu\u00e9 \u00e0 l'aide de l'outil console.py (d\u00e9crit dans ). Le microcontr\u00f4leur est configur\u00e9 pour la plate-forme mat\u00e9rielle (voir ci-dessous), puis ce qui suit est copi\u00e9-coll\u00e9 dans la fen\u00eatre du terminal console.py : SET start_clock {clock+freq} SET ticks 1000 reset_step_clock oid=0 clock={start_clock} set_next_step_dir oid=0 dir=0 queue_step oid=0 interval={ticks} count=60000 add=0 set_next_step_dir oid=0 dir=1 queue_step oid=0 interval=3000 count=1 add=0 reset_step_clock oid=1 clock={start_clock} set_next_step_dir oid=1 dir=0 queue_step oid=1 interval={ticks} count=60000 add=0 set_next_step_dir oid=1 dir=1 queue_step oid=1 interval=3000 count=1 add=0 reset_step_clock oid=2 clock={start_clock} set_next_step_dir oid=2 dir=0 queue_step oid=2 interval={ticks} count=60000 add=0 set_next_step_dir oid=2 dir=1 queue_step oid=2 interval=3000 count=1 add=0 Ces tests simule le d\u00e9placement de trois moteurs pas \u00e0 pas simultan\u00e9ment. Si son ex\u00e9cution entra\u00eene une erreur \"Rescheduled timer in the past\" or \"Stepper too far in past\", cela indique que le param\u00e8tre ticks est trop faible (il en r\u00e9sulte une vitesse de pas trop rapide) . L'objectif est de trouver le r\u00e9glage le plus bas du param\u00e8tre ticks qui aboutit de mani\u00e8re fiable \u00e0 la r\u00e9ussite du test. Il devrait \u00eatre possible de rechercher par dichotomie le param\u00e8tre ticks jusqu'\u00e0 ce qu'une valeur stable soit trouv\u00e9e. En cas d'\u00e9chec, on peut copier-coller ce qui suit pour effacer l'erreur en vue du prochain test : clear_shutdown Pour obtenir les tests de moteurs pas \u00e0 pas, la m\u00eame s\u00e9quence de configuration est utilis\u00e9e, mais seul le premier bloc du test ci-dessus est copi\u00e9-coll\u00e9 dans la fen\u00eatre console.py. Pour produire les tests trouv\u00e9s dans le document Fonctionnalit\u00e9s , le nombre total de pas par seconde est calcul\u00e9 en multipliant le nombre de steppers actifs par la fr\u00e9quence mcu nominale et en divisant par le param\u00e8tre final ticks. Les r\u00e9sultats sont arrondis au K le plus proche. Par exemple, avec trois steppers actifs : ECHO Test result is: {\"%.0fK\" % (3. * freq / ticks / 1000.)} Les tests sont ex\u00e9cut\u00e9s avec des param\u00e8tres adapt\u00e9s aux pilotes TMC. Pour les microcontr\u00f4leurs prenant en charge STEPPER_BOTH_EDGE=1 (comme indiqu\u00e9 dans la ligne MCU config au premier d\u00e9marrage de console.py), utilisez step_pulse_duration=0 et invert_step=-1 pour permettre un pas optimis\u00e9 sur les deux fronts de l'impulsion de pas. Pour les autres microcontr\u00f4leurs utiliser un step_pulse_duration correspondant \u00e0 100ns. Test du taux de pas sur AVR \u00b6 La s\u00e9quence de configuration suivante est utilis\u00e9e sur les puces AVR : allocate_oids count=3 config_stepper oid=0 step_pin=PA5 dir_pin=PA4 invert_step=0 step_pulse_ticks=32 config_stepper oid=1 step_pin=PA3 dir_pin=PA2 invert_step=0 step_pulse_ticks=32 config_stepper oid=2 step_pin=PC7 dir_pin=PC6 invert_step=0 step_pulse_ticks=32 finalize_config crc=0 Le test a \u00e9t\u00e9 ex\u00e9cut\u00e9 pour la derni\u00e8re fois sur le commit 59314d99 avec la version gcc avr-gcc (GCC) 5.4.0 . Les tests 16Mhz et 20Mhz ont \u00e9t\u00e9 ex\u00e9cut\u00e9s \u00e0 l'aide d'un simulavr configur\u00e9 pour un atmega644p (les tests pr\u00e9c\u00e9dents ont confirm\u00e9 que les r\u00e9sultats du simulavr correspondent aux tests sur un 16Mhz at90usb et un 16Mhz atmega2560). avr ticks 1 moteur pas \u00e0 pas 102 3 moteurs pas \u00e0 pas 486 Test du taux de pas sur Arduino Due \u00b6 La s\u00e9quence de configuration suivante est utilis\u00e9e sur le Due : allocate_oids count=3 config_stepper oid=0 step_pin=PB27 dir_pin=PA21 invert_step=-1 step_pulse_ticks=0 config_stepper oid=1 step_pin=PB26 dir_pin=PC30 invert_step=-1 step_pulse_ticks=0 config_stepper oid=2 step_pin=PA21 dir_pin=PC30 invert_step=-1 step_pulse_ticks=0 finalize_config crc=0 Le test a \u00e9t\u00e9 ex\u00e9cut\u00e9 pour la derni\u00e8re fois sur le commit 59314d99 avec la version de gcc arm-none-eabi-gcc (Fedora 10.2.0-4.fc34) 10.2.0 . sam3x8e ticks 1 moteur pas \u00e0 pas 66 3 moteurs pas \u00e0 pas 257 Test du taux de pas sur Duet Maestro \u00b6 La s\u00e9quence de configuration suivante est utilis\u00e9e sur le Duet Maestro : allocate_oids count=3 config_stepper oid=0 step_pin=PC26 dir_pin=PC18 invert_step=-1 step_pulse_ticks=0 config_stepper oid=1 step_pin=PC26 dir_pin=PA8 invert_step=-1 step_pulse_ticks=0 config_stepper oid=2 step_pin=PC26 dir_pin=PB4 invert_step=-1 step_pulse_ticks=0 finalize_config crc=0 Le test a \u00e9t\u00e9 ex\u00e9cut\u00e9 pour la derni\u00e8re fois sur le commit 59314d99 avec la version de gcc arm-none-eabi-gcc (Fedora 10.2.0-4.fc34) 10.2.0 . sam4s8c ticks 1 moteur pas \u00e0 pas 71 3 moteurs pas \u00e0 pas 260 Test du taux de pas sur Duet Wifi \u00b6 La s\u00e9quence de configuration suivante est utilis\u00e9e sur le Duet Wifi : allocate_oids count=3 config_stepper oid=0 step_pin=PD6 dir_pin=PD11 invert_step=-1 step_pulse_ticks=0 config_stepper oid=1 step_pin=PD7 dir_pin=PD12 invert_step=-1 step_pulse_ticks=0 config_stepper oid=2 step_pin=PD8 dir_pin=PD13 invert_step=-1 step_pulse_ticks=0 finalize_config crc=0 Le test a \u00e9t\u00e9 ex\u00e9cut\u00e9 pour la derni\u00e8re fois sur la validation 59314d99 avec la version gcc gcc version 10.3.1 20210621 (version) (GNU Arm Embedded Toolchain 10.3-2021.07) . sam4e8e ticks 1 moteur pas \u00e0 pas 48 3 moteurs pas \u00e0 pas 215 Test du taux de pas sur Beaglebone PRU \u00b6 La s\u00e9quence de configuration suivante est utilis\u00e9e sur le PRU : allocate_oids count=3 config_stepper oid=0 step_pin=gpio0_23 dir_pin=gpio1_12 invert_step=0 step_pulse_ticks=20 config_stepper oid=1 step_pin=gpio1_15 dir_pin=gpio0_26 invert_step=0 step_pulse_ticks=20 config_stepper oid=2 step_pin=gpio0_22 dir_pin=gpio2_1 invert_step=0 step_pulse_ticks=20 finalize_config crc=0 Le test a \u00e9t\u00e9 ex\u00e9cut\u00e9 pour la derni\u00e8re fois sur le commit 59314d99 avec la version de gcc pru-gcc (GCC) 8.0.0 20170530 (exp\u00e9rimental) . pru ticks 1 moteur pas \u00e0 pas 231 3 moteurs pas \u00e0 pas 847 Test du taux de pas STM32F042 \u00b6 La s\u00e9quence de configuration suivante est utilis\u00e9e sur le STM32F042 : allocate_oids count=3 config_stepper oid=0 step_pin=PA1 dir_pin=PA2 invert_step=-1 step_pulse_ticks=0 config_stepper oid=1 step_pin=PA3 dir_pin=PA2 invert_step=-1 step_pulse_ticks=0 config_stepper oid=2 step_pin=PB8 dir_pin=PA2 invert_step=-1 step_pulse_ticks=0 finalize_config crc=0 Le test a \u00e9t\u00e9 ex\u00e9cut\u00e9 pour la derni\u00e8re fois sur le commit 59314d99 avec la version de gcc arm-none-eabi-gcc (Fedora 10.2.0-4.fc34) 10.2.0 . stm32f042 ticks 1 moteur pas \u00e0 pas 59 3 moteurs pas \u00e0 pas 249 Test du taux de pas sur STM32F103 \u00b6 La s\u00e9quence de configuration suivante est utilis\u00e9e sur le STM32F103 : allocate_oids count=3 config_stepper oid=0 step_pin=PC13 dir_pin=PB5 invert_step=-1 step_pulse_ticks=0 config_stepper oid=1 step_pin=PB3 dir_pin=PB6 invert_step=-1 step_pulse_ticks=0 config_stepper oid=2 step_pin=PA4 dir_pin=PB7 invert_step=-1 step_pulse_ticks=0 finalize_config crc=0 Le test a \u00e9t\u00e9 ex\u00e9cut\u00e9 pour la derni\u00e8re fois sur le commit 59314d99 avec la version de gcc arm-none-eabi-gcc (Fedora 10.2.0-4.fc34) 10.2.0 . stm32f103 ticks 1 moteur pas \u00e0 pas 61 3 moteurs pas \u00e0 pas 264 Test du taux de pas sur STM32F4 \u00b6 La s\u00e9quence de configuration suivante est utilis\u00e9e sur le STM32F4 : allocate_oids count=3 config_stepper oid=0 step_pin=PA5 dir_pin=PB5 invert_step=-1 step_pulse_ticks=0 config_stepper oid=1 step_pin=PB2 dir_pin=PB6 invert_step=-1 step_pulse_ticks=0 config_stepper oid=2 step_pin=PB3 dir_pin=PB7 invert_step=-1 step_pulse_ticks=0 finalize_config crc=0 Le test a \u00e9t\u00e9 ex\u00e9cut\u00e9 pour la derni\u00e8re fois sur le commit 59314d99 avec la version de gcc arm-none-eabi-gcc (Fedora 10.2.0-4.fc34) 10.2.0 . Les r\u00e9sultats STM32F407 ont \u00e9t\u00e9 obtenus en ex\u00e9cutant un binaire STM32F407 sur un STM32F446 (et donc en utilisant une horloge de 168 MHz). stm32f446 ticks 1 moteur pas \u00e0 pas 46 3 moteurs pas \u00e0 pas 205 stm32f407 ticks 1 moteur pas \u00e0 pas 46 3 moteurs pas \u00e0 pas 205 Test du taux de pas sur STM32H7 \u00b6 La s\u00e9quence de configuration suivante est utilis\u00e9e sur un STM32H743VIT6 : allocate_oids count=3 config_stepper oid=0 step_pin=PD4 dir_pin=PD3 invert_step=-1 step_pulse_ticks=0 config_stepper oid=1 step_pin=PA15 dir_pin=PA8 invert_step=-1 step_pulse_ticks=0 config_stepper oid=2 step_pin=PE2 dir_pin=PE3 invert_step=-1 step_pulse_ticks=0 finalize_config crc=0 Le test a \u00e9t\u00e9 ex\u00e9cut\u00e9 pour la derni\u00e8re fois sur le commit 00191b5c avec la version de gcc arm-none-eabi-gcc (15:8-2019-q3-1+b1) 8.3.1 20190703 (release) [gcc- 8 branches r\u00e9vision 273027] . stm32h7 ticks 1 moteur pas \u00e0 pas 44 3 moteurs pas \u00e0 pas 198 Test du taux de pas sur STM32G0B1 \u00b6 La s\u00e9quence de configuration suivante est utilis\u00e9e sur le STM32G0B1 : allocate_oids count=3 config_stepper oid=0 step_pin=PB13 dir_pin=PB12 invert_step=-1 step_pulse_ticks=0 config_stepper oid=1 step_pin=PB10 dir_pin=PB2 invert_step=-1 step_pulse_ticks=0 config_stepper oid=2 step_pin=PB0 dir_pin=PC5 invert_step=-1 step_pulse_ticks=0 finalize_config crc=0 Le test a \u00e9t\u00e9 ex\u00e9cut\u00e9 pour la derni\u00e8re fois sur le commit 247cd753 avec la version gcc arm-none-eabi-gcc (Fedora 10.2.0-4.fc34) 10.2.0 . stm32g0b1 ticks 1 moteur pas \u00e0 pas 58 3 moteurs pas \u00e0 pas 243 Test du taux de pas sur LPC176x \u00b6 La s\u00e9quence de configuration suivante est utilis\u00e9e sur le LPC176x : allocate_oids count=3 config_stepper oid=0 step_pin=P1.20 dir_pin=P1.18 invert_step=-1 step_pulse_ticks=0 config_stepper oid=1 step_pin=P1.21 dir_pin=P1.18 invert_step=-1 step_pulse_ticks=0 config_stepper oid=2 step_pin=P1.23 dir_pin=P1.18 invert_step=-1 step_pulse_ticks=0 finalize_config crc=0 Le test a \u00e9t\u00e9 ex\u00e9cut\u00e9 pour la derni\u00e8re fois sur le commit 59314d99 avec la version de gcc arm-none-eabi-gcc (Fedora 10.2.0-4.fc34) 10.2.0 . Les r\u00e9sultats du LPC1769 \u00e0 120Mhz ont \u00e9t\u00e9 obtenus en overclockant un LPC1768 \u00e0 120Mhz. lpc1768 ticks 1 moteur pas \u00e0 pas 52 3 moteurs pas \u00e0 pas 222 lpc1769 ticks 1 moteur pas \u00e0 pas 51 3 moteurs pas \u00e0 pas 222 Test du taux de pas sur SAMD21 \u00b6 La s\u00e9quence de configuration suivante est utilis\u00e9e sur le SAMD21 : allocate_oids count=3 config_stepper oid=0 step_pin=PA27 dir_pin=PA20 invert_step=-1 step_pulse_ticks=0 config_stepper oid=1 step_pin=PB3 dir_pin=PA21 invert_step=-1 step_pulse_ticks=0 config_stepper oid=2 step_pin=PA17 dir_pin=PA21 invert_step=-1 step_pulse_ticks=0 finalize_config crc=0 Le test a \u00e9t\u00e9 ex\u00e9cut\u00e9 pour la derni\u00e8re fois sur le commit 59314d99 avec la version de gcc arm-none-eabi-gcc (Fedora 10.2.0-4.fc34) 10.2.0 sur un microcontr\u00f4leur SAMD21G18. samd21 ticks 1 moteur pas \u00e0 pas 70 3 moteurs pas \u00e0 pas 306 Test du taux de pas sur SAMD51 \u00b6 La s\u00e9quence de configuration suivante est utilis\u00e9e sur le SAMD51 : allocate_oids count=3 config_stepper oid=0 step_pin=PA22 dir_pin=PA20 invert_step=-1 step_pulse_ticks=0 config_stepper oid=1 step_pin=PA22 dir_pin=PA21 invert_step=-1 step_pulse_ticks=0 config_stepper oid=2 step_pin=PA22 dir_pin=PA19 invert_step=-1 step_pulse_ticks=0 finalize_config crc=0 Le test a \u00e9t\u00e9 ex\u00e9cut\u00e9 pour la derni\u00e8re fois sur le commit 59314d99 avec la version gcc arm-none-eabi-gcc (Fedora 10.2.0-4.fc34) 10.2.0 sur un microcontr\u00f4leur SAMD51J19A. samd51 ticks 1 moteur pas \u00e0 pas 39 3 moteurs pas \u00e0 pas 191 1 moteur pas \u00e0 pas (200Mhz) 39 3 moteurs pas \u00e0 pas (200Mhz) 181 Test du taux de pas sur RP2040 \u00b6 La s\u00e9quence de configuration suivante est utilis\u00e9e sur le RP2040 : allocate_oids count=3 config_stepper oid=0 step_pin=gpio25 dir_pin=gpio3 invert_step=-1 step_pulse_ticks=0 config_stepper oid=1 step_pin=gpio26 dir_pin=gpio4 invert_step=-1 step_pulse_ticks=0 config_stepper oid=2 step_pin=gpio27 dir_pin=gpio5 invert_step=-1 step_pulse_ticks=0 finalize_config crc=0 Le test a \u00e9t\u00e9 ex\u00e9cut\u00e9 pour la derni\u00e8re fois sur le commit 59314d99 avec la version gcc arm-none-eabi-gcc (Fedora 10.2.0-4.fc34) 10.2.0 sur une carte Raspberry Pi Pico. rp2040 ticks 1 moteur pas \u00e0 pas 5 3 moteurs pas \u00e0 pas 22 Test du taux de pas pour le MCU Linux \u00b6 La s\u00e9quence de configuration suivante est utilis\u00e9e sur un Raspberry Pi : allocate_oids count=3 config_stepper oid=0 step_pin=gpio2 dir_pin=gpio3 invert_step=0 step_pulse_ticks=5 config_stepper oid=1 step_pin=gpio4 dir_pin=gpio5 invert_step=0 step_pulse_ticks=5 config_stepper oid=2 step_pin=gpio6 dir_pin=gpio17 invert_step=0 step_pulse_ticks=5 finalize_config crc=0 Le test a \u00e9t\u00e9 ex\u00e9cut\u00e9 pour la derni\u00e8re fois sur le commit 59314d99 avec la version gcc gcc (Raspbian 8.3.0-6+rpi1) 8.3.0 sur un Raspberry Pi 3 (r\u00e9vision a02082). Il \u00e9tait difficile d'obtenir des r\u00e9sultats stables dans ce benchmark. Linux (RPi3) ticks 1 moteur pas \u00e0 pas 160 3 moteurs pas \u00e0 pas 380 Test de r\u00e9partition des commandes \u00b6 Le test de r\u00e9partition des commandes teste le nombre de commandes \"factices\" que le microcontr\u00f4leur peut traiter. Il s'agit principalement d'un test du m\u00e9canisme de communication mat\u00e9riel. Le test est ex\u00e9cut\u00e9 \u00e0 l'aide de l'outil console.py (d\u00e9crit dans ). Ce qui suit est copi\u00e9-coll\u00e9 dans la fen\u00eatre du terminal console.py : DELAY {clock + 2*freq} get_uptime FLOOD 100000 0.0 debug_nop get_uptime Une fois le test termin\u00e9, d\u00e9terminez la diff\u00e9rence entre les horloges signal\u00e9es dans les deux messages de r\u00e9ponse \"uptime\". Le nombre total de commandes par seconde est alors 100000 * mcu_frequency / clock_diff . Notez que ce test peut saturer la capacit\u00e9 USB/CPU d'un Raspberry Pi. En cas d'ex\u00e9cution sur un Raspberry Pi, Beaglebone ou un ordinateur h\u00f4te similaire, augmentez le d\u00e9lai (par exemple, DELAY {clock + 20*freq} get_uptime ). Le cas \u00e9ch\u00e9ant, les tests de performances ci-dessous concernent console.py ex\u00e9cut\u00e9 sur une machine de bureau avec l'appareil connect\u00e9 via un concentrateur \u00e0 haut d\u00e9bit. MCU Fr\u00e9quence Version Compilateur stm32f042 (CAN) 18K c105adc8 arm-none-eabi-gcc (GNU Tools 7-2018-q3-update) 7.3.1 atmega2560 (serial) 23K b161a69e avr-gcc (GCC) 4.8.1 sam3x8e (serial) 23K b161a69e arm-none-eabi-gcc (Fedora 7.1.0-5.fc27) 7.1.0 at90usb1286 (USB) 75K 01d2183f avr-gcc (GCC) 5.4.0 samd21 (USB) 223K 01d2183f arm-none-eabi-gcc (Fedora 7.4.0-1.fc30) 7.4.0 pru (m\u00e9moire partag\u00e9e) 260K c5968a08 pru-gcc (GCC) 8.0.0 20170530 (exp\u00e9rimental) stm32f103 (USB) 355K 01d2183f arm-none-eabi-gcc (Fedora 7.4.0-1.fc30) 7.4.0 sam3x8e (USB) 418K 01d2183f arm-none-eabi-gcc (Fedora 7.4.0-1.fc30) 7.4.0 lpc1768 (USB) 534K 01d2183f arm-none-eabi-gcc (Fedora 7.4.0-1.fc30) 7.4.0 lpc1769 (USB) 628K 01d2183f arm-none-eabi-gcc (Fedora 7.4.0-1.fc30) 7.4.0 sam4s8c (USB) 650K 8d4a5c16 arm-none-eabi-gcc (Fedora 7.4.0-1.fc30) 7.4.0 samd51 (USB) 864K 01d2183f arm-none-eabi-gcc (Fedora 7.4.0-1.fc30) 7.4.0 stm32f446 (USB) 870K 01d2183f arm-none-eabi-gcc (Fedora 7.4.0-1.fc30) 7.4.0 rp2040 (USB) 873K c5667193 arm-none-eabi-gcc (Fedora 10.2.0-4.fc34) 10.2.0 Tests de l'h\u00f4te \u00b6 Il est possible d'ex\u00e9cuter des tests de temporisation sur le logiciel h\u00f4te en utilisant le m\u00e9canisme de traitement \"mode batch\" (d\u00e9crit dans ). Cela se fait g\u00e9n\u00e9ralement en choisissant un fichier G-Code volumineux et complexe et en chronom\u00e9trant le temps n\u00e9cessaire au logiciel h\u00f4te pour le traiter. Par example\u202f: time ~/klippy-env/bin/python ./klippy/klippy.py config/example-cartesian.cfg -i something_complex.gcode -o /dev/null -d out/klipper.dict","title":"Tests"},{"location":"Benchmarks.html#tests","text":"Ce document d\u00e9crit les benchmarks Klipper.","title":"Tests"},{"location":"Benchmarks.html#bancs-dessai-des-microcontroleurs","text":"Cette section d\u00e9crit le m\u00e9canisme utilis\u00e9 pour g\u00e9n\u00e9rer les bancs d'essais (benchmarks) de fr\u00e9quence de pas du microcontr\u00f4leur Klipper. L'objectif principal des bancs d'essais est de fournir un m\u00e9canisme coh\u00e9rent pour mesurer l'impact des changements de codage dans le logiciel. Un objectif secondaire est de fournir des mesures de haut niveau pour comparer les performances entre puces et entre plateformes logicielles. Le test de vitesse des moteurs pas \u00e0 pas est con\u00e7u pour trouver la fr\u00e9quence de pas maximale que le mat\u00e9riel et le logiciel peuvent atteindre. Ce taux de pas de r\u00e9f\u00e9rence n'est pas r\u00e9alisable dans une utilisation normale de Klipper car il doit effectuer d'autres t\u00e2ches (par exemple, la communication mcu/h\u00f4te, la lecture de la temp\u00e9rature, la v\u00e9rification des fin de course). En g\u00e9n\u00e9ral, les broches pour les tests sont choisies pour faire clignoter des LED ou d'autres actions inoffensives. V\u00e9rifiez toujours qu'il est s\u00fbr de commander les broches configur\u00e9es avant d'ex\u00e9cuter un test. Il n'est pas recommand\u00e9 de piloter un moteur pas \u00e0 pas lors d'un benchmark.","title":"Bancs d'essai des microcontr\u00f4leurs"},{"location":"Benchmarks.html#test-du-taux-de-pas","text":"Le test est effectu\u00e9 \u00e0 l'aide de l'outil console.py (d\u00e9crit dans ). Le microcontr\u00f4leur est configur\u00e9 pour la plate-forme mat\u00e9rielle (voir ci-dessous), puis ce qui suit est copi\u00e9-coll\u00e9 dans la fen\u00eatre du terminal console.py : SET start_clock {clock+freq} SET ticks 1000 reset_step_clock oid=0 clock={start_clock} set_next_step_dir oid=0 dir=0 queue_step oid=0 interval={ticks} count=60000 add=0 set_next_step_dir oid=0 dir=1 queue_step oid=0 interval=3000 count=1 add=0 reset_step_clock oid=1 clock={start_clock} set_next_step_dir oid=1 dir=0 queue_step oid=1 interval={ticks} count=60000 add=0 set_next_step_dir oid=1 dir=1 queue_step oid=1 interval=3000 count=1 add=0 reset_step_clock oid=2 clock={start_clock} set_next_step_dir oid=2 dir=0 queue_step oid=2 interval={ticks} count=60000 add=0 set_next_step_dir oid=2 dir=1 queue_step oid=2 interval=3000 count=1 add=0 Ces tests simule le d\u00e9placement de trois moteurs pas \u00e0 pas simultan\u00e9ment. Si son ex\u00e9cution entra\u00eene une erreur \"Rescheduled timer in the past\" or \"Stepper too far in past\", cela indique que le param\u00e8tre ticks est trop faible (il en r\u00e9sulte une vitesse de pas trop rapide) . L'objectif est de trouver le r\u00e9glage le plus bas du param\u00e8tre ticks qui aboutit de mani\u00e8re fiable \u00e0 la r\u00e9ussite du test. Il devrait \u00eatre possible de rechercher par dichotomie le param\u00e8tre ticks jusqu'\u00e0 ce qu'une valeur stable soit trouv\u00e9e. En cas d'\u00e9chec, on peut copier-coller ce qui suit pour effacer l'erreur en vue du prochain test : clear_shutdown Pour obtenir les tests de moteurs pas \u00e0 pas, la m\u00eame s\u00e9quence de configuration est utilis\u00e9e, mais seul le premier bloc du test ci-dessus est copi\u00e9-coll\u00e9 dans la fen\u00eatre console.py. Pour produire les tests trouv\u00e9s dans le document Fonctionnalit\u00e9s , le nombre total de pas par seconde est calcul\u00e9 en multipliant le nombre de steppers actifs par la fr\u00e9quence mcu nominale et en divisant par le param\u00e8tre final ticks. Les r\u00e9sultats sont arrondis au K le plus proche. Par exemple, avec trois steppers actifs : ECHO Test result is: {\"%.0fK\" % (3. * freq / ticks / 1000.)} Les tests sont ex\u00e9cut\u00e9s avec des param\u00e8tres adapt\u00e9s aux pilotes TMC. Pour les microcontr\u00f4leurs prenant en charge STEPPER_BOTH_EDGE=1 (comme indiqu\u00e9 dans la ligne MCU config au premier d\u00e9marrage de console.py), utilisez step_pulse_duration=0 et invert_step=-1 pour permettre un pas optimis\u00e9 sur les deux fronts de l'impulsion de pas. Pour les autres microcontr\u00f4leurs utiliser un step_pulse_duration correspondant \u00e0 100ns.","title":"Test du taux de pas"},{"location":"Benchmarks.html#test-du-taux-de-pas-sur-avr","text":"La s\u00e9quence de configuration suivante est utilis\u00e9e sur les puces AVR : allocate_oids count=3 config_stepper oid=0 step_pin=PA5 dir_pin=PA4 invert_step=0 step_pulse_ticks=32 config_stepper oid=1 step_pin=PA3 dir_pin=PA2 invert_step=0 step_pulse_ticks=32 config_stepper oid=2 step_pin=PC7 dir_pin=PC6 invert_step=0 step_pulse_ticks=32 finalize_config crc=0 Le test a \u00e9t\u00e9 ex\u00e9cut\u00e9 pour la derni\u00e8re fois sur le commit 59314d99 avec la version gcc avr-gcc (GCC) 5.4.0 . Les tests 16Mhz et 20Mhz ont \u00e9t\u00e9 ex\u00e9cut\u00e9s \u00e0 l'aide d'un simulavr configur\u00e9 pour un atmega644p (les tests pr\u00e9c\u00e9dents ont confirm\u00e9 que les r\u00e9sultats du simulavr correspondent aux tests sur un 16Mhz at90usb et un 16Mhz atmega2560). avr ticks 1 moteur pas \u00e0 pas 102 3 moteurs pas \u00e0 pas 486","title":"Test du taux de pas sur AVR"},{"location":"Benchmarks.html#test-du-taux-de-pas-sur-arduino-due","text":"La s\u00e9quence de configuration suivante est utilis\u00e9e sur le Due : allocate_oids count=3 config_stepper oid=0 step_pin=PB27 dir_pin=PA21 invert_step=-1 step_pulse_ticks=0 config_stepper oid=1 step_pin=PB26 dir_pin=PC30 invert_step=-1 step_pulse_ticks=0 config_stepper oid=2 step_pin=PA21 dir_pin=PC30 invert_step=-1 step_pulse_ticks=0 finalize_config crc=0 Le test a \u00e9t\u00e9 ex\u00e9cut\u00e9 pour la derni\u00e8re fois sur le commit 59314d99 avec la version de gcc arm-none-eabi-gcc (Fedora 10.2.0-4.fc34) 10.2.0 . sam3x8e ticks 1 moteur pas \u00e0 pas 66 3 moteurs pas \u00e0 pas 257","title":"Test du taux de pas sur Arduino Due"},{"location":"Benchmarks.html#test-du-taux-de-pas-sur-duet-maestro","text":"La s\u00e9quence de configuration suivante est utilis\u00e9e sur le Duet Maestro : allocate_oids count=3 config_stepper oid=0 step_pin=PC26 dir_pin=PC18 invert_step=-1 step_pulse_ticks=0 config_stepper oid=1 step_pin=PC26 dir_pin=PA8 invert_step=-1 step_pulse_ticks=0 config_stepper oid=2 step_pin=PC26 dir_pin=PB4 invert_step=-1 step_pulse_ticks=0 finalize_config crc=0 Le test a \u00e9t\u00e9 ex\u00e9cut\u00e9 pour la derni\u00e8re fois sur le commit 59314d99 avec la version de gcc arm-none-eabi-gcc (Fedora 10.2.0-4.fc34) 10.2.0 . sam4s8c ticks 1 moteur pas \u00e0 pas 71 3 moteurs pas \u00e0 pas 260","title":"Test du taux de pas sur Duet Maestro"},{"location":"Benchmarks.html#test-du-taux-de-pas-sur-duet-wifi","text":"La s\u00e9quence de configuration suivante est utilis\u00e9e sur le Duet Wifi : allocate_oids count=3 config_stepper oid=0 step_pin=PD6 dir_pin=PD11 invert_step=-1 step_pulse_ticks=0 config_stepper oid=1 step_pin=PD7 dir_pin=PD12 invert_step=-1 step_pulse_ticks=0 config_stepper oid=2 step_pin=PD8 dir_pin=PD13 invert_step=-1 step_pulse_ticks=0 finalize_config crc=0 Le test a \u00e9t\u00e9 ex\u00e9cut\u00e9 pour la derni\u00e8re fois sur la validation 59314d99 avec la version gcc gcc version 10.3.1 20210621 (version) (GNU Arm Embedded Toolchain 10.3-2021.07) . sam4e8e ticks 1 moteur pas \u00e0 pas 48 3 moteurs pas \u00e0 pas 215","title":"Test du taux de pas sur Duet Wifi"},{"location":"Benchmarks.html#test-du-taux-de-pas-sur-beaglebone-pru","text":"La s\u00e9quence de configuration suivante est utilis\u00e9e sur le PRU : allocate_oids count=3 config_stepper oid=0 step_pin=gpio0_23 dir_pin=gpio1_12 invert_step=0 step_pulse_ticks=20 config_stepper oid=1 step_pin=gpio1_15 dir_pin=gpio0_26 invert_step=0 step_pulse_ticks=20 config_stepper oid=2 step_pin=gpio0_22 dir_pin=gpio2_1 invert_step=0 step_pulse_ticks=20 finalize_config crc=0 Le test a \u00e9t\u00e9 ex\u00e9cut\u00e9 pour la derni\u00e8re fois sur le commit 59314d99 avec la version de gcc pru-gcc (GCC) 8.0.0 20170530 (exp\u00e9rimental) . pru ticks 1 moteur pas \u00e0 pas 231 3 moteurs pas \u00e0 pas 847","title":"Test du taux de pas sur Beaglebone PRU"},{"location":"Benchmarks.html#test-du-taux-de-pas-stm32f042","text":"La s\u00e9quence de configuration suivante est utilis\u00e9e sur le STM32F042 : allocate_oids count=3 config_stepper oid=0 step_pin=PA1 dir_pin=PA2 invert_step=-1 step_pulse_ticks=0 config_stepper oid=1 step_pin=PA3 dir_pin=PA2 invert_step=-1 step_pulse_ticks=0 config_stepper oid=2 step_pin=PB8 dir_pin=PA2 invert_step=-1 step_pulse_ticks=0 finalize_config crc=0 Le test a \u00e9t\u00e9 ex\u00e9cut\u00e9 pour la derni\u00e8re fois sur le commit 59314d99 avec la version de gcc arm-none-eabi-gcc (Fedora 10.2.0-4.fc34) 10.2.0 . stm32f042 ticks 1 moteur pas \u00e0 pas 59 3 moteurs pas \u00e0 pas 249","title":"Test du taux de pas STM32F042"},{"location":"Benchmarks.html#test-du-taux-de-pas-sur-stm32f103","text":"La s\u00e9quence de configuration suivante est utilis\u00e9e sur le STM32F103 : allocate_oids count=3 config_stepper oid=0 step_pin=PC13 dir_pin=PB5 invert_step=-1 step_pulse_ticks=0 config_stepper oid=1 step_pin=PB3 dir_pin=PB6 invert_step=-1 step_pulse_ticks=0 config_stepper oid=2 step_pin=PA4 dir_pin=PB7 invert_step=-1 step_pulse_ticks=0 finalize_config crc=0 Le test a \u00e9t\u00e9 ex\u00e9cut\u00e9 pour la derni\u00e8re fois sur le commit 59314d99 avec la version de gcc arm-none-eabi-gcc (Fedora 10.2.0-4.fc34) 10.2.0 . stm32f103 ticks 1 moteur pas \u00e0 pas 61 3 moteurs pas \u00e0 pas 264","title":"Test du taux de pas sur STM32F103"},{"location":"Benchmarks.html#test-du-taux-de-pas-sur-stm32f4","text":"La s\u00e9quence de configuration suivante est utilis\u00e9e sur le STM32F4 : allocate_oids count=3 config_stepper oid=0 step_pin=PA5 dir_pin=PB5 invert_step=-1 step_pulse_ticks=0 config_stepper oid=1 step_pin=PB2 dir_pin=PB6 invert_step=-1 step_pulse_ticks=0 config_stepper oid=2 step_pin=PB3 dir_pin=PB7 invert_step=-1 step_pulse_ticks=0 finalize_config crc=0 Le test a \u00e9t\u00e9 ex\u00e9cut\u00e9 pour la derni\u00e8re fois sur le commit 59314d99 avec la version de gcc arm-none-eabi-gcc (Fedora 10.2.0-4.fc34) 10.2.0 . Les r\u00e9sultats STM32F407 ont \u00e9t\u00e9 obtenus en ex\u00e9cutant un binaire STM32F407 sur un STM32F446 (et donc en utilisant une horloge de 168 MHz). stm32f446 ticks 1 moteur pas \u00e0 pas 46 3 moteurs pas \u00e0 pas 205 stm32f407 ticks 1 moteur pas \u00e0 pas 46 3 moteurs pas \u00e0 pas 205","title":"Test du taux de pas sur STM32F4"},{"location":"Benchmarks.html#test-du-taux-de-pas-sur-stm32h7","text":"La s\u00e9quence de configuration suivante est utilis\u00e9e sur un STM32H743VIT6 : allocate_oids count=3 config_stepper oid=0 step_pin=PD4 dir_pin=PD3 invert_step=-1 step_pulse_ticks=0 config_stepper oid=1 step_pin=PA15 dir_pin=PA8 invert_step=-1 step_pulse_ticks=0 config_stepper oid=2 step_pin=PE2 dir_pin=PE3 invert_step=-1 step_pulse_ticks=0 finalize_config crc=0 Le test a \u00e9t\u00e9 ex\u00e9cut\u00e9 pour la derni\u00e8re fois sur le commit 00191b5c avec la version de gcc arm-none-eabi-gcc (15:8-2019-q3-1+b1) 8.3.1 20190703 (release) [gcc- 8 branches r\u00e9vision 273027] . stm32h7 ticks 1 moteur pas \u00e0 pas 44 3 moteurs pas \u00e0 pas 198","title":"Test du taux de pas sur STM32H7"},{"location":"Benchmarks.html#test-du-taux-de-pas-sur-stm32g0b1","text":"La s\u00e9quence de configuration suivante est utilis\u00e9e sur le STM32G0B1 : allocate_oids count=3 config_stepper oid=0 step_pin=PB13 dir_pin=PB12 invert_step=-1 step_pulse_ticks=0 config_stepper oid=1 step_pin=PB10 dir_pin=PB2 invert_step=-1 step_pulse_ticks=0 config_stepper oid=2 step_pin=PB0 dir_pin=PC5 invert_step=-1 step_pulse_ticks=0 finalize_config crc=0 Le test a \u00e9t\u00e9 ex\u00e9cut\u00e9 pour la derni\u00e8re fois sur le commit 247cd753 avec la version gcc arm-none-eabi-gcc (Fedora 10.2.0-4.fc34) 10.2.0 . stm32g0b1 ticks 1 moteur pas \u00e0 pas 58 3 moteurs pas \u00e0 pas 243","title":"Test du taux de pas sur STM32G0B1"},{"location":"Benchmarks.html#test-du-taux-de-pas-sur-lpc176x","text":"La s\u00e9quence de configuration suivante est utilis\u00e9e sur le LPC176x : allocate_oids count=3 config_stepper oid=0 step_pin=P1.20 dir_pin=P1.18 invert_step=-1 step_pulse_ticks=0 config_stepper oid=1 step_pin=P1.21 dir_pin=P1.18 invert_step=-1 step_pulse_ticks=0 config_stepper oid=2 step_pin=P1.23 dir_pin=P1.18 invert_step=-1 step_pulse_ticks=0 finalize_config crc=0 Le test a \u00e9t\u00e9 ex\u00e9cut\u00e9 pour la derni\u00e8re fois sur le commit 59314d99 avec la version de gcc arm-none-eabi-gcc (Fedora 10.2.0-4.fc34) 10.2.0 . Les r\u00e9sultats du LPC1769 \u00e0 120Mhz ont \u00e9t\u00e9 obtenus en overclockant un LPC1768 \u00e0 120Mhz. lpc1768 ticks 1 moteur pas \u00e0 pas 52 3 moteurs pas \u00e0 pas 222 lpc1769 ticks 1 moteur pas \u00e0 pas 51 3 moteurs pas \u00e0 pas 222","title":"Test du taux de pas sur LPC176x"},{"location":"Benchmarks.html#test-du-taux-de-pas-sur-samd21","text":"La s\u00e9quence de configuration suivante est utilis\u00e9e sur le SAMD21 : allocate_oids count=3 config_stepper oid=0 step_pin=PA27 dir_pin=PA20 invert_step=-1 step_pulse_ticks=0 config_stepper oid=1 step_pin=PB3 dir_pin=PA21 invert_step=-1 step_pulse_ticks=0 config_stepper oid=2 step_pin=PA17 dir_pin=PA21 invert_step=-1 step_pulse_ticks=0 finalize_config crc=0 Le test a \u00e9t\u00e9 ex\u00e9cut\u00e9 pour la derni\u00e8re fois sur le commit 59314d99 avec la version de gcc arm-none-eabi-gcc (Fedora 10.2.0-4.fc34) 10.2.0 sur un microcontr\u00f4leur SAMD21G18. samd21 ticks 1 moteur pas \u00e0 pas 70 3 moteurs pas \u00e0 pas 306","title":"Test du taux de pas sur SAMD21"},{"location":"Benchmarks.html#test-du-taux-de-pas-sur-samd51","text":"La s\u00e9quence de configuration suivante est utilis\u00e9e sur le SAMD51 : allocate_oids count=3 config_stepper oid=0 step_pin=PA22 dir_pin=PA20 invert_step=-1 step_pulse_ticks=0 config_stepper oid=1 step_pin=PA22 dir_pin=PA21 invert_step=-1 step_pulse_ticks=0 config_stepper oid=2 step_pin=PA22 dir_pin=PA19 invert_step=-1 step_pulse_ticks=0 finalize_config crc=0 Le test a \u00e9t\u00e9 ex\u00e9cut\u00e9 pour la derni\u00e8re fois sur le commit 59314d99 avec la version gcc arm-none-eabi-gcc (Fedora 10.2.0-4.fc34) 10.2.0 sur un microcontr\u00f4leur SAMD51J19A. samd51 ticks 1 moteur pas \u00e0 pas 39 3 moteurs pas \u00e0 pas 191 1 moteur pas \u00e0 pas (200Mhz) 39 3 moteurs pas \u00e0 pas (200Mhz) 181","title":"Test du taux de pas sur SAMD51"},{"location":"Benchmarks.html#test-du-taux-de-pas-sur-rp2040","text":"La s\u00e9quence de configuration suivante est utilis\u00e9e sur le RP2040 : allocate_oids count=3 config_stepper oid=0 step_pin=gpio25 dir_pin=gpio3 invert_step=-1 step_pulse_ticks=0 config_stepper oid=1 step_pin=gpio26 dir_pin=gpio4 invert_step=-1 step_pulse_ticks=0 config_stepper oid=2 step_pin=gpio27 dir_pin=gpio5 invert_step=-1 step_pulse_ticks=0 finalize_config crc=0 Le test a \u00e9t\u00e9 ex\u00e9cut\u00e9 pour la derni\u00e8re fois sur le commit 59314d99 avec la version gcc arm-none-eabi-gcc (Fedora 10.2.0-4.fc34) 10.2.0 sur une carte Raspberry Pi Pico. rp2040 ticks 1 moteur pas \u00e0 pas 5 3 moteurs pas \u00e0 pas 22","title":"Test du taux de pas sur RP2040"},{"location":"Benchmarks.html#test-du-taux-de-pas-pour-le-mcu-linux","text":"La s\u00e9quence de configuration suivante est utilis\u00e9e sur un Raspberry Pi : allocate_oids count=3 config_stepper oid=0 step_pin=gpio2 dir_pin=gpio3 invert_step=0 step_pulse_ticks=5 config_stepper oid=1 step_pin=gpio4 dir_pin=gpio5 invert_step=0 step_pulse_ticks=5 config_stepper oid=2 step_pin=gpio6 dir_pin=gpio17 invert_step=0 step_pulse_ticks=5 finalize_config crc=0 Le test a \u00e9t\u00e9 ex\u00e9cut\u00e9 pour la derni\u00e8re fois sur le commit 59314d99 avec la version gcc gcc (Raspbian 8.3.0-6+rpi1) 8.3.0 sur un Raspberry Pi 3 (r\u00e9vision a02082). Il \u00e9tait difficile d'obtenir des r\u00e9sultats stables dans ce benchmark. Linux (RPi3) ticks 1 moteur pas \u00e0 pas 160 3 moteurs pas \u00e0 pas 380","title":"Test du taux de pas pour le MCU Linux"},{"location":"Benchmarks.html#test-de-repartition-des-commandes","text":"Le test de r\u00e9partition des commandes teste le nombre de commandes \"factices\" que le microcontr\u00f4leur peut traiter. Il s'agit principalement d'un test du m\u00e9canisme de communication mat\u00e9riel. Le test est ex\u00e9cut\u00e9 \u00e0 l'aide de l'outil console.py (d\u00e9crit dans ). Ce qui suit est copi\u00e9-coll\u00e9 dans la fen\u00eatre du terminal console.py : DELAY {clock + 2*freq} get_uptime FLOOD 100000 0.0 debug_nop get_uptime Une fois le test termin\u00e9, d\u00e9terminez la diff\u00e9rence entre les horloges signal\u00e9es dans les deux messages de r\u00e9ponse \"uptime\". Le nombre total de commandes par seconde est alors 100000 * mcu_frequency / clock_diff . Notez que ce test peut saturer la capacit\u00e9 USB/CPU d'un Raspberry Pi. En cas d'ex\u00e9cution sur un Raspberry Pi, Beaglebone ou un ordinateur h\u00f4te similaire, augmentez le d\u00e9lai (par exemple, DELAY {clock + 20*freq} get_uptime ). Le cas \u00e9ch\u00e9ant, les tests de performances ci-dessous concernent console.py ex\u00e9cut\u00e9 sur une machine de bureau avec l'appareil connect\u00e9 via un concentrateur \u00e0 haut d\u00e9bit. MCU Fr\u00e9quence Version Compilateur stm32f042 (CAN) 18K c105adc8 arm-none-eabi-gcc (GNU Tools 7-2018-q3-update) 7.3.1 atmega2560 (serial) 23K b161a69e avr-gcc (GCC) 4.8.1 sam3x8e (serial) 23K b161a69e arm-none-eabi-gcc (Fedora 7.1.0-5.fc27) 7.1.0 at90usb1286 (USB) 75K 01d2183f avr-gcc (GCC) 5.4.0 samd21 (USB) 223K 01d2183f arm-none-eabi-gcc (Fedora 7.4.0-1.fc30) 7.4.0 pru (m\u00e9moire partag\u00e9e) 260K c5968a08 pru-gcc (GCC) 8.0.0 20170530 (exp\u00e9rimental) stm32f103 (USB) 355K 01d2183f arm-none-eabi-gcc (Fedora 7.4.0-1.fc30) 7.4.0 sam3x8e (USB) 418K 01d2183f arm-none-eabi-gcc (Fedora 7.4.0-1.fc30) 7.4.0 lpc1768 (USB) 534K 01d2183f arm-none-eabi-gcc (Fedora 7.4.0-1.fc30) 7.4.0 lpc1769 (USB) 628K 01d2183f arm-none-eabi-gcc (Fedora 7.4.0-1.fc30) 7.4.0 sam4s8c (USB) 650K 8d4a5c16 arm-none-eabi-gcc (Fedora 7.4.0-1.fc30) 7.4.0 samd51 (USB) 864K 01d2183f arm-none-eabi-gcc (Fedora 7.4.0-1.fc30) 7.4.0 stm32f446 (USB) 870K 01d2183f arm-none-eabi-gcc (Fedora 7.4.0-1.fc30) 7.4.0 rp2040 (USB) 873K c5667193 arm-none-eabi-gcc (Fedora 10.2.0-4.fc34) 10.2.0","title":"Test de r\u00e9partition des commandes"},{"location":"Benchmarks.html#tests-de-lhote","text":"Il est possible d'ex\u00e9cuter des tests de temporisation sur le logiciel h\u00f4te en utilisant le m\u00e9canisme de traitement \"mode batch\" (d\u00e9crit dans ). Cela se fait g\u00e9n\u00e9ralement en choisissant un fichier G-Code volumineux et complexe et en chronom\u00e9trant le temps n\u00e9cessaire au logiciel h\u00f4te pour le traiter. Par example\u202f: time ~/klippy-env/bin/python ./klippy/klippy.py config/example-cartesian.cfg -i something_complex.gcode -o /dev/null -d out/klipper.dict","title":"Tests de l'h\u00f4te"},{"location":"Bootloaders.html","text":"Chargeurs de d\u00e9marrage \u00b6 Ce document fournit des informations sur les \"chargeurs de d\u00e9marrage\" ou \"Bootloaders\" courants trouv\u00e9s sur les microcontr\u00f4leurs pris en charge par Klipper. Le chargeur de d\u00e9marrage est un logiciel tiers qui s'ex\u00e9cute sur le microcontr\u00f4leur lors de sa premi\u00e8re mise sous tension. Il est g\u00e9n\u00e9ralement utilis\u00e9 pour flasher une nouvelle application (par exemple, Klipper) sur le microcontr\u00f4leur sans n\u00e9cessiter de mat\u00e9riel sp\u00e9cialis\u00e9. Malheureusement, il n'existe pas de norme \u00e0 l'\u00e9chelle de l'industrie pour flasher un microcontr\u00f4leur, ni de chargeur de d\u00e9marrage standard qui fonctionne sur tous les microcontr\u00f4leurs. Pire encore, il est courant que chaque chargeur de d\u00e9marrage n\u00e9cessite un ensemble d'\u00e9tapes diff\u00e9rent pour flasher une application. Si l'on peut flasher un chargeur de d\u00e9marrage sur un microcontr\u00f4leur, on peut g\u00e9n\u00e9ralement \u00e9galement utiliser ce m\u00e9canisme pour flasher une application, mais il faut faire attention en faisant cela car on peut supprimer le chargeur de d\u00e9marrage par inadvertance. En revanche, un chargeur de d\u00e9marrage permettra g\u00e9n\u00e9ralement \u00e0 un utilisateur de flasher une application. Il est donc recommand\u00e9 d'utiliser le chargeur de d\u00e9marrage pour flasher une application lorsque cela est possible. Ce document tente de d\u00e9crire les chargeurs de d\u00e9marrage courants, les \u00e9tapes n\u00e9cessaires pour flasher un chargeur de d\u00e9marrage et les \u00e9tapes n\u00e9cessaires pour flasher une application. Ce document n'est pas une r\u00e9f\u00e9rence faisant autorit\u00e9 ; il est con\u00e7u comme une collection d'informations utiles que les d\u00e9veloppeurs de Klipper ont accumul\u00e9es. Micro-contr\u00f4leurs AVR \u00b6 De mani\u00e8re g\u00e9n\u00e9rale, le projet Arduino est une bonne r\u00e9f\u00e9rence pour les chargeurs de d\u00e9marrage et les proc\u00e9dures de flashage sur les microcontr\u00f4leurs Atmel Atmega 8 bits. En particulier, le fichier \"boards.txt\" : https://github.com/arduino/Arduino/blob/1.8.5/hardware/arduino/avr/boards.txt est une r\u00e9f\u00e9rence utile. Pour flasher le chargeur de d\u00e9marrage, les puces AVR n\u00e9cessitent un outil de flashage mat\u00e9riel externe (qui communique avec la puce \u00e0 l'aide de SPI). Cet outil peut \u00eatre achet\u00e9 (par exemple, effectuez une recherche sur le Web pour \"avr isp\", \"arduino isp\" ou \"usb tiny isp\"). Il est \u00e9galement possible d'utiliser un autre Arduino ou Raspberry Pi pour flasher un chargeur de d\u00e9marrage AVR (par exemple, faites une recherche sur le Web pour \"programmer un avr \u00e0 l'aide de raspberry pi\"). Les exemples ci-dessous sont \u00e9crits en supposant qu'un appareil de type \"AVR ISP Mk2\" est utilis\u00e9. Le logiciel \"avrdude\" est l'outil le plus utilis\u00e9 pour flasher les puces atmega (\u00e0 la fois pour flasher le chargeur de d\u00e9marrage et l'application). Atmega2560 \u00b6 Cette puce se trouve g\u00e9n\u00e9ralement dans les \"Arduino Mega\" qui sont tr\u00e8s courante parmi les cartes d'imprimante 3d. Pour flasher le chargeur de d\u00e9marrage lui-m\u00eame, utilisez quelque chose comme : wget 'https://github.com/arduino/Arduino/raw/1.8.5/hardware/arduino/avr/bootloaders/stk500v2/stk500boot_v2_mega2560.hex' avrdude -cavrispv2 -patmega2560 -P/dev/ttyACM0 -b115200 -e -u -U lock:w:0x3F:m -U efuse:w:0xFD:m -U hfuse:w:0xD8:m -U lfuse:w:0xFF:m avrdude -cavrispv2 -patmega2560 -P/dev/ttyACM0 -b115200 -U flash:w:stk500boot_v2_mega2560.hex avrdude -cavrispv2 -patmega2560 -P/dev/ttyACM0 -b115200 -U lock:w:0x0F:m Pour flasher une application, utilisez quelque chose comme : avrdude -cwiring -patmega2560 -P/dev/ttyACM0 -b115200 -D -Uflash:w:out/klipper.elf.hex:i Atmega1280 \u00b6 Cette puce se trouve g\u00e9n\u00e9ralement dans les anciennes versions de \"l'Arduino Mega\". Pour flasher le chargeur de d\u00e9marrage lui-m\u00eame, utilisez quelque chose comme : wget 'https://github.com/arduino/Arduino/raw/1.8.5/hardware/arduino/avr/bootloaders/atmega/ATmegaBOOT_168_atmega1280.hex' avrdude -cavrispv2 -patmega1280 -P/dev/ttyACM0 -b115200 -e -u -U lock:w:0x3F:m -U efuse:w:0xF5:m -U hfuse:w:0xDA:m -U lfuse:w:0xFF:m avrdude -cavrispv2 -patmega1280 -P/dev/ttyACM0 -b115200 -U flash:w:ATmegaBOOT_168_atmega1280.hex avrdude -cavrispv2 -patmega1280 -P/dev/ttyACM0 -b115200 -U lock:w:0x0F:m Pour flasher une application, utilisez quelque chose comme : avrdude -carduino -patmega1280 -P/dev/ttyACM0 -b57600 -D -Uflash:w:out/klipper.elf.hex:i Atmega1284p \u00b6 Cette puce se trouve couramment dans les cartes d'imprimante 3d de style \"Melzi\". Pour flasher le chargeur de d\u00e9marrage lui-m\u00eame, utilisez quelque chose comme : wget 'https://github.com/Lauszus/Sanguino/raw/1.0.2/bootloaders/optiboot/optiboot_atmega1284p.hex' avrdude -cavrispv2 -patmega1284p -P/dev/ttyACM0 -b115200 -e -u -U lock:w:0x3F:m -U efuse:w:0xFD:m -U hfuse:w:0xDE:m -U lfuse:w:0xFF:m avrdude -cavrispv2 -patmega1284p -P/dev/ttyACM0 -b115200 -U flash:w:optiboot_atmega1284p.hex avrdude -cavrispv2 -patmega1284p -P/dev/ttyACM0 -b115200 -U lock:w:0x0F:m Pour flasher une application, utilisez quelque chose comme : avrdude -carduino -patmega1284p -P/dev/ttyACM0 -b115200 -D -Uflash:w:out/klipper.elf.hex:i Notez qu'un certain nombre de cartes de style \"Melzi\" sont pr\u00e9install\u00e9es avec un chargeur de d\u00e9marrage qui utilise un d\u00e9bit de 57600 bauds. Dans ce cas, pour flasher une application, utilisez plut\u00f4t quelque chose comme ceci : avrdude -carduino -patmega1284p -P/dev/ttyACM0 -b57600 -D -Uflash:w:out/klipper.elf.hex:i At90usb1286 \u00b6 Ce document ne couvre pas la m\u00e9thode pour flasher un chargeur de d\u00e9marrage sur l'At90usb1286 ni le flashage g\u00e9n\u00e9ral des applications sur cet appareil. L'appareil Teensy++ de pjrc.com est livr\u00e9 avec un chargeur de d\u00e9marrage propri\u00e9taire. Il n\u00e9cessite un outil de flash personnalis\u00e9 de https://github.com/PaulStoffregen/teensy_loader_cli . On peut flasher une application avec en utilisant quelque chose comme : teensy_loader_cli --mcu=at90usb1286 out/klipper.elf.hex -v Atmega168 \u00b6 L'atmega168 a un espace flash limit\u00e9. Si vous utilisez un chargeur de d\u00e9marrage, il est recommand\u00e9 d'utiliser le chargeur de d\u00e9marrage Optiboot. Pour flasher ce chargeur de d\u00e9marrage, utilisez quelque chose comme : wget 'https://github.com/arduino/Arduino/raw/1.8.5/hardware/arduino/avr/bootloaders/optiboot/optiboot_atmega168.hex' avrdude -cavrispv2 -patmega168 -P/dev/ttyACM0 -b115200 -e -u -U lock:w:0x3F:m -U efuse:w:0x04:m -U hfuse:w:0xDD:m -U lfuse:w:0xFF:m avrdude -cavrispv2 -patmega168 -P/dev/ttyACM0 -b115200 -U flash:w:optiboot_atmega168.hex avrdude -cavrispv2 -patmega168 -P/dev/ttyACM0 -b115200 -U lock:w:0x0F:m Pour flasher une application via le chargeur de d\u00e9marrage Optiboot, utilisez quelque chose comme : avrdude -carduino -patmega168 -P/dev/ttyACM0 -b115200 -D -Uflash:w:out/klipper.elf.hex:i Micro-contr\u00f4leurs SAM3 (Arduino Due) \u00b6 Il n'est pas courant d'utiliser un chargeur de d\u00e9marrage avec le mcu SAM3. La puce elle-m\u00eame poss\u00e8de une ROM qui permet de programmer le flash \u00e0 partir du port s\u00e9rie 3,3 V ou de l'USB. Pour activer la ROM, la broche \"effacement\" est maintenue haute pendant une r\u00e9initialisation, ce qui efface le contenu flash et provoque l'ex\u00e9cution de la ROM. Sur un Arduino Due, cette s\u00e9quence peut \u00eatre accomplie en d\u00e9finissant un d\u00e9bit en bauds de 1200 sur le \"port usb de programmation\" (le port USB le plus proche de l'alimentation). Le code sur https://github.com/shumatech/BOSSA peut \u00eatre utilis\u00e9 pour programmer le SAM3. Il est recommand\u00e9 d'utiliser la version 1.9 ou ult\u00e9rieure. Pour flasher une application, utilisez quelque chose comme : bossac -U -p /dev/ttyACM0 -a -e -w out/klipper.bin -v -b bossac -U -p /dev/ttyACM0 -R Micro-contr\u00f4leurs SAM4 (Duet Wifi) \u00b6 Il n'est pas courant d'utiliser un bootloader avec le mcu SAM4. La puce elle-m\u00eame poss\u00e8de une ROM qui permet de programmer le flash \u00e0 partir du port s\u00e9rie 3,3 V ou de l'USB. Pour activer la ROM, la broche \"effacement\" est maintenue haute pendant une r\u00e9initialisation, ce qui efface le contenu flash et provoque l'ex\u00e9cution de la ROM. Le code sur https://github.com/shumatech/BOSSA peut \u00eatre utilis\u00e9 pour programmer le SAM4. Il est n\u00e9cessaire d'utiliser la version 1.8.0 ou sup\u00e9rieure. Pour flasher une application, utilisez quelque chose comme : bossac --port=/dev/ttyACM0 -b -U -e -w -v -R out/klipper.bin Micro-contr\u00f4leurs SAMD21 (Arduino Zero) \u00b6 Le chargeur de d\u00e9marrage SAMD21 est flash\u00e9 via l'interface ARM Serial Wire Debug (SWD). Cela se fait g\u00e9n\u00e9ralement avec un dongle mat\u00e9riel SWD d\u00e9di\u00e9. Alternativement, on peut utiliser un Raspberry Pi avec OpenOCD . Pour flasher un chargeur de d\u00e9marrage avec OpenOCD, utilisez la configuration de puce suivante : source [find target/at91samdXX.cfg] Procurez-vous un bootloader - par exemple : wget 'https://github.com/arduino/ArduinoCore-samd/raw/1.8.3/bootloaders/zero/samd21_sam_ba.bin' Flashez avec des commandes OpenOCD similaires \u00e0 : at91samd bootloader 0 program samd21_sam_ba.bin verify Le chargeur de d\u00e9marrage le plus courant sur le SAMD21 est celui que l'on trouve sur le \"Arduino Zero\". Il utilise un chargeur de d\u00e9marrage de 8 Ko (l'application doit \u00eatre compil\u00e9e avec une adresse de d\u00e9marrage de 8 Ko). On peut entrer dans ce chargeur de d\u00e9marrage en double-cliquant sur le bouton de r\u00e9initialisation. Pour flasher une application, utilisez quelque chose comme : bossac -U -p /dev/ttyACM0 --offset=0x2000 -w out/klipper.bin -v -b -R En revanche, \"l'Arduino M0\" utilise un bootloader de 16KiB (l'application doit \u00eatre compil\u00e9e avec une adresse de d\u00e9marrage de 16KiB). Pour flasher une application sur ce chargeur de d\u00e9marrage, r\u00e9initialisez le microcontr\u00f4leur et ex\u00e9cutez la commande flash dans les premi\u00e8res secondes du d\u00e9marrage - quelque chose comme : avrdude -c stk500v2 -p atmega2560 -P /dev/ttyACM0 -u -Uflash:w:out/klipper.elf.hex:i Micro-contr\u00f4leurs SAMD51 (Adafruit Metro-M4 et similaires) \u00b6 Comme le SAMD21, le chargeur de d\u00e9marrage SAMD51 est flash\u00e9 via l'interface ARM Serial Wire Debug (SWD). Pour flasher un chargeur de d\u00e9marrage avec OpenOCD sur un Raspberry Pi utilisez la configuration de puce suivante : source [find target/atsame5x.cfg] Obtenir un Chargeur de D\u00e9marrage - De nombreux Chargeurs de d\u00e9marrage sont disponibles sur https://github.com/adafruit/uf2-samdx1/releases/latest . Par exemple\u202f: wget 'https://github.com/adafruit/uf2-samdx1/releases/download/v3.7.0/bootloader-itsybitsy_m4-v3.7.0.bin' Flashez avec des commandes OpenOCD similaires \u00e0 : at91samd bootloader 0 program bootloader-itsybitsy_m4-v3.7.0.bin verify at91samd bootloader 16384 Le SAMD51 utilise un chargeur de d\u00e9marrage de 16 Ko (l'application doit \u00eatre compil\u00e9e avec une adresse de d\u00e9marrage de 16 Ko). Pour flasher une application, utilisez quelque chose comme : bossac -U -p /dev/ttyACM0 --offset=0x4000 -w out/klipper.bin -v -b -R Microcontr\u00f4leurs STM32F103 (dispositifs Blue Pill) \u00b6 Les appareils STM32F103 ont une ROM qui peut flasher un chargeur de d\u00e9marrage ou une application via un port s\u00e9rie 3,3 V. En r\u00e8gle g\u00e9n\u00e9rale, on c\u00e2blerait les broches PA10 (MCU Rx) et PA9 (MCU Tx) \u00e0 un adaptateur UART 3,3 V. Pour acc\u00e9der \u00e0 la ROM, il faut connecter la broche \"boot 0\" au niveau haut et la broche \"boot 1\" au niveau bas, puis r\u00e9initialiser l'appareil. Le package \"stm32flash\" peut ensuite \u00eatre utilis\u00e9 pour flasher l'appareil en utilisant quelque chose comme : stm32flash -w out/klipper.bin -v -g 0 /dev/ttyAMA0 Notez que si l'on utilise un Raspberry Pi pour le port s\u00e9rie 3.3V, le protocole stm32flash utilise un mode de parit\u00e9 s\u00e9rie que le \"mini UART\" du Raspberry Pi ne prend pas en charge. Voir https://www.raspberrypi.com/documentation/computers/configuration.html#configuring-uarts pour plus de d\u00e9tails sur l'activation de l'uart complet sur les broches GPIO du Raspberry Pi. Apr\u00e8s avoir flash\u00e9, r\u00e9glez \u00e0 la fois \"boot 0\" et \"boot 1\" sur bas afin que les futures r\u00e9initialisations d\u00e9marrent \u00e0 partir du flash. STM32F103 avec chargeur de d\u00e9marrage stm32duino \u00b6 Le projet \"stm32duino\" a un chargeur de d\u00e9marrage compatible USB - voir : https://github.com/rogerclarkmelbourne/STM32duino-bootloader Ce chargeur de d\u00e9marrage peut \u00eatre flash\u00e9 via un port s\u00e9rie 3,3 V avec quelque chose comme : wget 'https://github.com/rogerclarkmelbourne/STM32duino-bootloader/raw/master/binaries/generic_boot20_pc13.bin' stm32flash -w generic_boot20_pc13.bin -v -g 0 /dev/ttyAMA0 Ce chargeur de d\u00e9marrage utilise 8 Ko d'espace flash (l'application doit \u00eatre compil\u00e9e avec une adresse de d\u00e9marrage de 8 Ko). Flashez une application avec quelque chose comme : dfu-util -d 1eaf:0003 -a 2 -R -D out/klipper.bin Le chargeur de d\u00e9marrage ne s'ex\u00e9cute g\u00e9n\u00e9ralement que pendant une courte p\u00e9riode apr\u00e8s le d\u00e9marrage. Il peut \u00eatre n\u00e9cessaire de chronom\u00e9trer la commande ci-dessus pour qu'elle s'ex\u00e9cute pendant que le chargeur de d\u00e9marrage est toujours actif (le chargeur de d\u00e9marrage fait clignoter une LED de la carte pendant son ex\u00e9cution). Vous pouvez \u00e9galement d\u00e9finir la broche \"boot 0\" sur low et la broche \"boot 1\" sur high pour rester en mode chargeur de d\u00e9marrage apr\u00e8s une r\u00e9initialisation. STM32F103 avec chargeur de d\u00e9marrage HID \u00b6 Le chargeur de d\u00e9marrage HID est un chargeur de d\u00e9marrage compact et sans pilote capable de flasher via USB. Un fork avec des builds sp\u00e9cifiques au SKR Mini E3 1.2 est \u00e9galement disponible. Pour les cartes STM32F103 g\u00e9n\u00e9riques telles que la blue pill, il est possible de flasher le chargeur de d\u00e9marrage via un port s\u00e9rie 3.3v en utilisant stm32flash comme indiqu\u00e9 dans la section stm32duino ci-dessus, en rempla\u00e7ant le nom de fichier par le binaire du chargeur de d\u00e9marrage souhait\u00e9 (c'est-\u00e0-dire\u202f: hid_generic_pc13.bin pour la blue pill). Il n'est pas possible d'utiliser stm32flash pour le SKR Mini E3 car la broche boot0 est directement li\u00e9e \u00e0 la terre et non connect\u00e9e via des broches d'en-t\u00eate. Il est recommand\u00e9 d'utiliser un STLink V2 avec le programmeur STM32Cube pour flasher le bootloader. Si vous n'avez pas acc\u00e8s \u00e0 un STLink, il est \u00e9galement possible d'utiliser un Raspberry Pi et OpenOCD avec la configuration de puce suivante : source [find target/stm32f1x.cfg] Si vous le souhaitez, vous pouvez faire une sauvegarde du flash actuel avec la commande suivante. Notez que cela peut prendre un certain temps : flash read_bank 0 btt_skr_mini_e3_backup.bin vous pouvez flasher avec des commandes similaires \u00e0 : stm32f1x mass_erase 0 program hid_btt_skr_mini_e3.bin verify 0x08000000 NOTES\u202f: L'exemple ci-dessus efface la puce puis programme le bootloader. Quelle que soit la m\u00e9thode choisie pour flasher, il est recommand\u00e9 d'effacer la puce avant de flasher. Avant de flasher le SKR Mini E3 avec ce chargeur de d\u00e9marrage, vous devez savoir que vous ne pourrez plus mettre \u00e0 jour le firmware via la carte SD. You may need to hold down the reset button on the board while launching OpenOCD. It should display something like: Open On-Chip Debugger 0.10.0+dev-01204-gc60252ac-dirty (2020-04-27-16:00) Licensed under GNU GPL v2 For bug reports, read http://openocd.org/doc/doxygen/bugs.html DEPRECATED! use 'adapter speed' not 'adapter_khz' Info : BCM2835 GPIO JTAG/SWD bitbang driver Info : JTAG and SWD modes enabled Info : clock speed 40 kHz Info : SWD DPIDR 0x1ba01477 Info : stm32f1x.cpu: hardware has 6 breakpoints, 4 watchpoints Info : stm32f1x.cpu: external reset detected Info : starting gdb server for stm32f1x.cpu on 3333 Info : Listening on port 3333 for gdb connections Apr\u00e8s quoi, vous pouvez rel\u00e2cher le bouton de r\u00e9initialisation. Ce chargeur de d\u00e9marrage n\u00e9cessite 2 Ko d'espace flash (l'application doit \u00eatre compil\u00e9e avec une adresse de d\u00e9marrage de 2 Ko). Le programme hid-flash est utilis\u00e9 pour t\u00e9l\u00e9charger un binaire sur le bootloader. Vous pouvez installer ce logiciel avec les commandes suivantes : sudo apt install libusb-1.0 cd ~/klipper/lib/hidflash make Si le chargeur de d\u00e9marrage est en cours d'ex\u00e9cution, vous pouvez flasher avec quelque chose comme : ~/klipper/lib/hidflash/hid-flash ~/klipper/out/klipper.bin Vous pouvez aussi utiliser make flash pour flasher directement klipper : make flash FLASH_DEVICE=1209:BEBA OU si klipper a d\u00e9j\u00e0 \u00e9t\u00e9 flash\u00e9 : make flash FLASH_DEVICE=/dev/ttyACM0 Il peut \u00eatre n\u00e9cessaire d'entrer manuellement dans le chargeur de d\u00e9marrage, cela peut \u00eatre fait en d\u00e9finissant \"boot 0\" au niveau bas et \"boot 1\" au niveau haut. Sur le SKR Mini E3 \"Boot 1\" n'est pas disponible, vous pouvez donc le faire en mettant la broche PA2 au niveau bas si vous avez flash\u00e9 \"hid_btt_skr_mini_e3.bin\". Cette broche est \u00e9tiquet\u00e9e \"TX0\" sur l'en-t\u00eate TFT dans le document \"PIN\" du SKR Mini E3. Il y a une broche de terre \u00e0 c\u00f4t\u00e9 de PA2 que vous pouvez utiliser pour mettre PA2 \u00e0 0. STM32F103/STM32F072 avec chargeur de d\u00e9marrage MSC \u00b6 Le chargeur de d\u00e9marrage MSC est un chargeur de d\u00e9marrage sans pilote capable de flasher via USB. Il est possible de flasher le chargeur de d\u00e9marrage via un port s\u00e9rie 3.3v en utilisant stm32flash comme indiqu\u00e9 dans la section stm32duino ci-dessus, en rempla\u00e7ant le nom de fichier par le binaire du chargeur de d\u00e9marrage MSC souhait\u00e9 (c'est-\u00e0-dire : MSCboot-Bluepill.bin pour la blue pill). Pour les cartes STM32F072, il est \u00e9galement possible de flasher le bootloader via USB (via DFU) avec quelque chose comme : dfu-util -d 0483:df11 -a 0 -R -D MSCboot-STM32F072.bin -s0x08000000:leave Ce chargeur de d\u00e9marrage utilise 8 Ko ou 16 Ko d'espace flash, voir la description du chargeur de d\u00e9marrage (l'application doit \u00eatre compil\u00e9e avec l'adresse de d\u00e9marrage correspondante). Le chargeur de d\u00e9marrage peut \u00eatre activ\u00e9 en appuyant deux fois sur le bouton de r\u00e9initialisation de la carte. D\u00e8s que le chargeur de d\u00e9marrage est activ\u00e9, la carte appara\u00eet comme une cl\u00e9 USB sur laquelle le fichier klipper.bin peut \u00eatre copi\u00e9. STM32F103/STM32F0x2 avec chargeur de d\u00e9marrage CanBoot \u00b6 Le chargeur de d\u00e9marrage CanBoot offre une option pour t\u00e9l\u00e9charger le micrologiciel Klipper via le CANBUS. Le chargeur de d\u00e9marrage lui-m\u00eame est d\u00e9riv\u00e9 du code source de Klipper. Actuellement, CanBoot prend en charge les mod\u00e8les STM32F103, STM32F042 et STM32F072. Il est recommand\u00e9 d'utiliser un programmeur ST-Link pour flasher CanBoot, mais il devrait \u00eatre possible de flasher en utilisant stm32flash sur les appareils STM32F103 et dfu-util sur les appareils STM32F042/STM32F072. Consultez les sections pr\u00e9c\u00e9dentes de ce document pour obtenir des instructions sur ces m\u00e9thodes de flash, en rempla\u00e7ant canboot.bin par le nom de fichier, le cas \u00e9ch\u00e9ant. Le lien CanBoot ci-dessus fournit des instructions pour cr\u00e9er le chargeur de d\u00e9marrage. La premi\u00e8re fois que CanBoot a \u00e9t\u00e9 flash\u00e9, il devrait d\u00e9tecter qu'aucune application n'est pr\u00e9sente et entrer dans le chargeur de d\u00e9marrage. Si cela ne se produit pas, il est possible d'entrer dans le chargeur de d\u00e9marrage en appuyant deux fois de suite sur le bouton de r\u00e9initialisation. L'utilitaire flash_can.py fourni dans le dossier lib/canboot peut \u00eatre utilis\u00e9 pour t\u00e9l\u00e9charger le firmware Klipper. L'UUID de l'appareil doit clignoter. Si vous n'avez pas d'UUID, il est possible d'interroger les n\u0153uds ex\u00e9cutant actuellement le chargeur de d\u00e9marrage : python3 flash_can.py -q Cela renverra les UUID pour tous les n\u0153uds connect\u00e9s et qui n'avaient pas d'UUID attribu\u00e9. Cela devrait inclure tous les n\u0153uds actuellement dans le chargeur de d\u00e9marrage. Une fois que vous avez un UUID, vous pouvez t\u00e9l\u00e9charger le firmware avec la commande suivante : python3 flash_can.py -i can0 -f ~/klipper/out/klipper.bin -u aabbccddeeff O\u00f9 aabbccddeeff est remplac\u00e9 par votre UUID. Notez que les options -i et -f peuvent \u00eatre omises, elles sont par d\u00e9faut sur can0 et ~/klipper/out/klipper.bin . Lors de la cr\u00e9ation de Klipper pour une utilisation avec CanBoot, s\u00e9lectionnez l'option 8 KiB Bootloader. Micro-contr\u00f4leurs STM32F4 (SKR Pro 1.1) \u00b6 Les microcontr\u00f4leurs STM32F4 sont \u00e9quip\u00e9s d'un chargeur de d\u00e9marrage syst\u00e8me int\u00e9gr\u00e9 capable de flasher via USB (via DFU), s\u00e9rie 3,3 V et diverses autres m\u00e9thodes (voir le document STM AN2606 pour plus d'informations). Certaines cartes STM32F4, telles que le SKR Pro 1.1, ne peuvent pas entrer dans le chargeur de d\u00e9marrage DFU. Le chargeur de d\u00e9marrage HID est disponible pour les cartes bas\u00e9es sur STM32F405/407 si l'utilisateur pr\u00e9f\u00e8re flasher sur USB plut\u00f4t que d'utiliser la carte SD. Notez que vous devrez peut-\u00eatre configurer et construire une version sp\u00e9cifique \u00e0 votre carte, une version pour le SKR Pro 1.1 est disponible ici . \u00c0 moins que votre carte ne soit compatible DFU, la m\u00e9thode de flash la plus accessible est probablement via un port s\u00e9rie 3.3v, qui suit la m\u00eame proc\u00e9dure que flasher le STM32F103 avec stm32flash . Par exemple\u202f: wget https://github.com/Arksine/STM32_HID_Bootloader/releases/download/v0.5-beta/hid_bootloader_SKR_PRO.bin stm32flash -w hid_bootloader_SKR_PRO.bin -v -g 0 /dev/ttyAMA0 Ce chargeur de d\u00e9marrage n\u00e9cessite 16 Ko d'espace flash sur le STM32F4 (l'application doit \u00eatre compil\u00e9e avec une adresse de d\u00e9marrage de 16 Ko). Comme avec le STM32F1, le STM32F4 utilise l'outil hid-flash pour t\u00e9l\u00e9charger des fichiers binaires sur le MCU. Voir les instructions ci-dessus pour plus de d\u00e9tails sur la fa\u00e7on de construire et d'utiliser hid-flash. Il peut \u00eatre n\u00e9cessaire d'entrer manuellement dans le chargeur de d\u00e9marrage, cela peut \u00eatre fait en d\u00e9finissant \"boot 0\" au niveau bas, \"boot 1\" au niveau haut et en branchant l'appareil. Une fois la programmation termin\u00e9e, d\u00e9branchez l'appareil et re-r\u00e9glez \"boot 1\" au niveau bas pour que l'application soit charg\u00e9e. Micro-contr\u00f4leurs LPC176x (Smoothieboards) \u00b6 Ce document ne d\u00e9crit pas la m\u00e9thode pour flasher le Chargeur de d\u00e9marrage lui-m\u00eame - voir : http://smoothieware.org/flashing-the-bootloader pour plus d'informations sur ce sujet. Il est courant que les Smoothieboards soient livr\u00e9s avec un chargeur de d\u00e9marrage de : https://github.com/triffid/LPC17xx-DFU-Bootloader . Lors de l'utilisation de ce chargeur de d\u00e9marrage, l'application doit \u00eatre compil\u00e9e avec une adresse de d\u00e9marrage de 16 Ko. Le moyen le plus simple de flasher une application avec ce chargeur de d\u00e9marrage est de copier le fichier d'application (par exemple, out/klipper.bin ) dans un fichier nomm\u00e9 firmware.bin sur une carte SD, et puis de red\u00e9marrer le microcontr\u00f4leur avec cette carte SD. Ex\u00e9cuter OpenOCD sur le Raspberry PI \u00b6 OpenOCD est un logiciel qui peut effectuer un flashage et un d\u00e9bogage de puce de bas niveau. Il peut utiliser les broches GPIO d'un Raspberry Pi pour communiquer avec une vari\u00e9t\u00e9 de puces ARM. Cette section d\u00e9crit comment installer et lancer OpenOCD. Elle d\u00e9rive des instructions disponibles sur : https://learn.adafruit.com/programming-microcontrollers-using-openocd-on-raspberry-pi Commencez par t\u00e9l\u00e9charger et compiler le logiciel (chaque \u00e9tape peut prendre plusieurs minutes et l'\u00e9tape \"make\" peut prendre plus de 30 minutes) : sudo apt-get update sudo apt-get install autoconf libtool telnet mkdir ~/openocd cd ~/openocd/ git clone http://openocd.zylin.com/openocd cd openocd ./bootstrap ./configure --enable-sysfsgpio --enable-bcm2835gpio --prefix=/home/pi/openocd/install make make install Configurer OpenOCD \u00b6 Cr\u00e9ez un fichier de configuration OpenOCD : nano ~/openocd/openocd.cfg Utilisez une configuration similaire \u00e0 la suivante : # Utilise les pins du RPI: GPIO25 pour SWDCLK, GPIO24 pour SWDIO, GPIO18 pour nRST source [find interface/raspberrypi2-native.cfg] bcm2835gpio_swd_nums 25 24 bcm2835gpio_srst_num 18 transport select swd # Utilise le reset c\u00e2bl\u00e9 pour la raz de la puce reset_config srst_only adapter_nsrst_delay 100 adapter_nsrst_assert_width 100 # Specification du type de puce source [find target/atsame5x.cfg] # D\u00e9finir la vitesse de l'adaptateur adapter_khz 40 # Connexion \u00e0 la puce init targets reset halt C\u00e2blez le Raspberry Pi sur la puce cible \u00b6 \u00c9teignez \u00e0 la fois le Raspberry Pi et la puce cible avant le c\u00e2blage ! V\u00e9rifiez que la puce cible utilise bien du 3,3 V avant de la connecter au Raspberry Pi ! Connectez GND, SWDCLK, SWDIO et RST sur la puce cible \u00e0 GND, GPIO25, GPIO24 et GPIO18 sur le Raspberry Pi. Mettez ensuite le Raspberry Pi sous tension et alimentez la puce cible. Ex\u00e9cutez OpenOCD \u00b6 Ex\u00e9cutez OpenOCD : cd ~/openocd/ sudo ~/openocd/install/bin/openocd -f ~/openocd/openocd.cfg Ce qui pr\u00e9c\u00e8de devrait amener OpenOCD \u00e0 \u00e9mettre des messages texte, puis \u00e0 attendre (il ne doit pas imm\u00e9diatement revenir \u00e0 l'invite du shell). Si OpenOCD se ferme tout seul ou s'il continue \u00e0 \u00e9mettre des messages texte, v\u00e9rifiez \u00e0 nouveau le c\u00e2blage. Une fois OpenOCD en cours d'ex\u00e9cution et stable, on peut lui envoyer des commandes via telnet. Ouvrez une autre session SSH et ex\u00e9cutez ce qui suit : telnet 127.0.0.1 4444 (Vous pouvez quitter telnet en appuyant sur ctrl+] puis en ex\u00e9cutant la commande \"quit\".) OpenOCD et gdb \u00b6 Il est possible d'utiliser OpenOCD avec gdb pour d\u00e9boguer Klipper. Les commandes suivantes supposent que l'on ex\u00e9cute gdb sur une machine de bureau. Ajoutez ce qui suit au fichier de configuration OpenOCD : bindto 0.0.0.0 gdb_port 44444 Red\u00e9marrez OpenOCD sur le Raspberry Pi, puis ex\u00e9cutez la commande Unix suivante sur la machine de bureau : cd /path/to/klipper/ gdb out/klipper.elf Dans gdb, ex\u00e9cutez : target remote octopi:44444 (Remplacez \"octopi\" par le nom d'h\u00f4te du Raspberry Pi.) Une fois que gdb est en cours d'ex\u00e9cution, il est possible de d\u00e9finir des points d'arr\u00eat et d'inspecter les registres.","title":"Chargeurs de d\u00e9marrage"},{"location":"Bootloaders.html#chargeurs-de-demarrage","text":"Ce document fournit des informations sur les \"chargeurs de d\u00e9marrage\" ou \"Bootloaders\" courants trouv\u00e9s sur les microcontr\u00f4leurs pris en charge par Klipper. Le chargeur de d\u00e9marrage est un logiciel tiers qui s'ex\u00e9cute sur le microcontr\u00f4leur lors de sa premi\u00e8re mise sous tension. Il est g\u00e9n\u00e9ralement utilis\u00e9 pour flasher une nouvelle application (par exemple, Klipper) sur le microcontr\u00f4leur sans n\u00e9cessiter de mat\u00e9riel sp\u00e9cialis\u00e9. Malheureusement, il n'existe pas de norme \u00e0 l'\u00e9chelle de l'industrie pour flasher un microcontr\u00f4leur, ni de chargeur de d\u00e9marrage standard qui fonctionne sur tous les microcontr\u00f4leurs. Pire encore, il est courant que chaque chargeur de d\u00e9marrage n\u00e9cessite un ensemble d'\u00e9tapes diff\u00e9rent pour flasher une application. Si l'on peut flasher un chargeur de d\u00e9marrage sur un microcontr\u00f4leur, on peut g\u00e9n\u00e9ralement \u00e9galement utiliser ce m\u00e9canisme pour flasher une application, mais il faut faire attention en faisant cela car on peut supprimer le chargeur de d\u00e9marrage par inadvertance. En revanche, un chargeur de d\u00e9marrage permettra g\u00e9n\u00e9ralement \u00e0 un utilisateur de flasher une application. Il est donc recommand\u00e9 d'utiliser le chargeur de d\u00e9marrage pour flasher une application lorsque cela est possible. Ce document tente de d\u00e9crire les chargeurs de d\u00e9marrage courants, les \u00e9tapes n\u00e9cessaires pour flasher un chargeur de d\u00e9marrage et les \u00e9tapes n\u00e9cessaires pour flasher une application. Ce document n'est pas une r\u00e9f\u00e9rence faisant autorit\u00e9 ; il est con\u00e7u comme une collection d'informations utiles que les d\u00e9veloppeurs de Klipper ont accumul\u00e9es.","title":"Chargeurs de d\u00e9marrage"},{"location":"Bootloaders.html#micro-controleurs-avr","text":"De mani\u00e8re g\u00e9n\u00e9rale, le projet Arduino est une bonne r\u00e9f\u00e9rence pour les chargeurs de d\u00e9marrage et les proc\u00e9dures de flashage sur les microcontr\u00f4leurs Atmel Atmega 8 bits. En particulier, le fichier \"boards.txt\" : https://github.com/arduino/Arduino/blob/1.8.5/hardware/arduino/avr/boards.txt est une r\u00e9f\u00e9rence utile. Pour flasher le chargeur de d\u00e9marrage, les puces AVR n\u00e9cessitent un outil de flashage mat\u00e9riel externe (qui communique avec la puce \u00e0 l'aide de SPI). Cet outil peut \u00eatre achet\u00e9 (par exemple, effectuez une recherche sur le Web pour \"avr isp\", \"arduino isp\" ou \"usb tiny isp\"). Il est \u00e9galement possible d'utiliser un autre Arduino ou Raspberry Pi pour flasher un chargeur de d\u00e9marrage AVR (par exemple, faites une recherche sur le Web pour \"programmer un avr \u00e0 l'aide de raspberry pi\"). Les exemples ci-dessous sont \u00e9crits en supposant qu'un appareil de type \"AVR ISP Mk2\" est utilis\u00e9. Le logiciel \"avrdude\" est l'outil le plus utilis\u00e9 pour flasher les puces atmega (\u00e0 la fois pour flasher le chargeur de d\u00e9marrage et l'application).","title":"Micro-contr\u00f4leurs AVR"},{"location":"Bootloaders.html#atmega2560","text":"Cette puce se trouve g\u00e9n\u00e9ralement dans les \"Arduino Mega\" qui sont tr\u00e8s courante parmi les cartes d'imprimante 3d. Pour flasher le chargeur de d\u00e9marrage lui-m\u00eame, utilisez quelque chose comme : wget 'https://github.com/arduino/Arduino/raw/1.8.5/hardware/arduino/avr/bootloaders/stk500v2/stk500boot_v2_mega2560.hex' avrdude -cavrispv2 -patmega2560 -P/dev/ttyACM0 -b115200 -e -u -U lock:w:0x3F:m -U efuse:w:0xFD:m -U hfuse:w:0xD8:m -U lfuse:w:0xFF:m avrdude -cavrispv2 -patmega2560 -P/dev/ttyACM0 -b115200 -U flash:w:stk500boot_v2_mega2560.hex avrdude -cavrispv2 -patmega2560 -P/dev/ttyACM0 -b115200 -U lock:w:0x0F:m Pour flasher une application, utilisez quelque chose comme : avrdude -cwiring -patmega2560 -P/dev/ttyACM0 -b115200 -D -Uflash:w:out/klipper.elf.hex:i","title":"Atmega2560"},{"location":"Bootloaders.html#atmega1280","text":"Cette puce se trouve g\u00e9n\u00e9ralement dans les anciennes versions de \"l'Arduino Mega\". Pour flasher le chargeur de d\u00e9marrage lui-m\u00eame, utilisez quelque chose comme : wget 'https://github.com/arduino/Arduino/raw/1.8.5/hardware/arduino/avr/bootloaders/atmega/ATmegaBOOT_168_atmega1280.hex' avrdude -cavrispv2 -patmega1280 -P/dev/ttyACM0 -b115200 -e -u -U lock:w:0x3F:m -U efuse:w:0xF5:m -U hfuse:w:0xDA:m -U lfuse:w:0xFF:m avrdude -cavrispv2 -patmega1280 -P/dev/ttyACM0 -b115200 -U flash:w:ATmegaBOOT_168_atmega1280.hex avrdude -cavrispv2 -patmega1280 -P/dev/ttyACM0 -b115200 -U lock:w:0x0F:m Pour flasher une application, utilisez quelque chose comme : avrdude -carduino -patmega1280 -P/dev/ttyACM0 -b57600 -D -Uflash:w:out/klipper.elf.hex:i","title":"Atmega1280"},{"location":"Bootloaders.html#atmega1284p","text":"Cette puce se trouve couramment dans les cartes d'imprimante 3d de style \"Melzi\". Pour flasher le chargeur de d\u00e9marrage lui-m\u00eame, utilisez quelque chose comme : wget 'https://github.com/Lauszus/Sanguino/raw/1.0.2/bootloaders/optiboot/optiboot_atmega1284p.hex' avrdude -cavrispv2 -patmega1284p -P/dev/ttyACM0 -b115200 -e -u -U lock:w:0x3F:m -U efuse:w:0xFD:m -U hfuse:w:0xDE:m -U lfuse:w:0xFF:m avrdude -cavrispv2 -patmega1284p -P/dev/ttyACM0 -b115200 -U flash:w:optiboot_atmega1284p.hex avrdude -cavrispv2 -patmega1284p -P/dev/ttyACM0 -b115200 -U lock:w:0x0F:m Pour flasher une application, utilisez quelque chose comme : avrdude -carduino -patmega1284p -P/dev/ttyACM0 -b115200 -D -Uflash:w:out/klipper.elf.hex:i Notez qu'un certain nombre de cartes de style \"Melzi\" sont pr\u00e9install\u00e9es avec un chargeur de d\u00e9marrage qui utilise un d\u00e9bit de 57600 bauds. Dans ce cas, pour flasher une application, utilisez plut\u00f4t quelque chose comme ceci : avrdude -carduino -patmega1284p -P/dev/ttyACM0 -b57600 -D -Uflash:w:out/klipper.elf.hex:i","title":"Atmega1284p"},{"location":"Bootloaders.html#at90usb1286","text":"Ce document ne couvre pas la m\u00e9thode pour flasher un chargeur de d\u00e9marrage sur l'At90usb1286 ni le flashage g\u00e9n\u00e9ral des applications sur cet appareil. L'appareil Teensy++ de pjrc.com est livr\u00e9 avec un chargeur de d\u00e9marrage propri\u00e9taire. Il n\u00e9cessite un outil de flash personnalis\u00e9 de https://github.com/PaulStoffregen/teensy_loader_cli . On peut flasher une application avec en utilisant quelque chose comme : teensy_loader_cli --mcu=at90usb1286 out/klipper.elf.hex -v","title":"At90usb1286"},{"location":"Bootloaders.html#atmega168","text":"L'atmega168 a un espace flash limit\u00e9. Si vous utilisez un chargeur de d\u00e9marrage, il est recommand\u00e9 d'utiliser le chargeur de d\u00e9marrage Optiboot. Pour flasher ce chargeur de d\u00e9marrage, utilisez quelque chose comme : wget 'https://github.com/arduino/Arduino/raw/1.8.5/hardware/arduino/avr/bootloaders/optiboot/optiboot_atmega168.hex' avrdude -cavrispv2 -patmega168 -P/dev/ttyACM0 -b115200 -e -u -U lock:w:0x3F:m -U efuse:w:0x04:m -U hfuse:w:0xDD:m -U lfuse:w:0xFF:m avrdude -cavrispv2 -patmega168 -P/dev/ttyACM0 -b115200 -U flash:w:optiboot_atmega168.hex avrdude -cavrispv2 -patmega168 -P/dev/ttyACM0 -b115200 -U lock:w:0x0F:m Pour flasher une application via le chargeur de d\u00e9marrage Optiboot, utilisez quelque chose comme : avrdude -carduino -patmega168 -P/dev/ttyACM0 -b115200 -D -Uflash:w:out/klipper.elf.hex:i","title":"Atmega168"},{"location":"Bootloaders.html#micro-controleurs-sam3-arduino-due","text":"Il n'est pas courant d'utiliser un chargeur de d\u00e9marrage avec le mcu SAM3. La puce elle-m\u00eame poss\u00e8de une ROM qui permet de programmer le flash \u00e0 partir du port s\u00e9rie 3,3 V ou de l'USB. Pour activer la ROM, la broche \"effacement\" est maintenue haute pendant une r\u00e9initialisation, ce qui efface le contenu flash et provoque l'ex\u00e9cution de la ROM. Sur un Arduino Due, cette s\u00e9quence peut \u00eatre accomplie en d\u00e9finissant un d\u00e9bit en bauds de 1200 sur le \"port usb de programmation\" (le port USB le plus proche de l'alimentation). Le code sur https://github.com/shumatech/BOSSA peut \u00eatre utilis\u00e9 pour programmer le SAM3. Il est recommand\u00e9 d'utiliser la version 1.9 ou ult\u00e9rieure. Pour flasher une application, utilisez quelque chose comme : bossac -U -p /dev/ttyACM0 -a -e -w out/klipper.bin -v -b bossac -U -p /dev/ttyACM0 -R","title":"Micro-contr\u00f4leurs SAM3 (Arduino Due)"},{"location":"Bootloaders.html#micro-controleurs-sam4-duet-wifi","text":"Il n'est pas courant d'utiliser un bootloader avec le mcu SAM4. La puce elle-m\u00eame poss\u00e8de une ROM qui permet de programmer le flash \u00e0 partir du port s\u00e9rie 3,3 V ou de l'USB. Pour activer la ROM, la broche \"effacement\" est maintenue haute pendant une r\u00e9initialisation, ce qui efface le contenu flash et provoque l'ex\u00e9cution de la ROM. Le code sur https://github.com/shumatech/BOSSA peut \u00eatre utilis\u00e9 pour programmer le SAM4. Il est n\u00e9cessaire d'utiliser la version 1.8.0 ou sup\u00e9rieure. Pour flasher une application, utilisez quelque chose comme : bossac --port=/dev/ttyACM0 -b -U -e -w -v -R out/klipper.bin","title":"Micro-contr\u00f4leurs SAM4 (Duet Wifi)"},{"location":"Bootloaders.html#micro-controleurs-samd21-arduino-zero","text":"Le chargeur de d\u00e9marrage SAMD21 est flash\u00e9 via l'interface ARM Serial Wire Debug (SWD). Cela se fait g\u00e9n\u00e9ralement avec un dongle mat\u00e9riel SWD d\u00e9di\u00e9. Alternativement, on peut utiliser un Raspberry Pi avec OpenOCD . Pour flasher un chargeur de d\u00e9marrage avec OpenOCD, utilisez la configuration de puce suivante : source [find target/at91samdXX.cfg] Procurez-vous un bootloader - par exemple : wget 'https://github.com/arduino/ArduinoCore-samd/raw/1.8.3/bootloaders/zero/samd21_sam_ba.bin' Flashez avec des commandes OpenOCD similaires \u00e0 : at91samd bootloader 0 program samd21_sam_ba.bin verify Le chargeur de d\u00e9marrage le plus courant sur le SAMD21 est celui que l'on trouve sur le \"Arduino Zero\". Il utilise un chargeur de d\u00e9marrage de 8 Ko (l'application doit \u00eatre compil\u00e9e avec une adresse de d\u00e9marrage de 8 Ko). On peut entrer dans ce chargeur de d\u00e9marrage en double-cliquant sur le bouton de r\u00e9initialisation. Pour flasher une application, utilisez quelque chose comme : bossac -U -p /dev/ttyACM0 --offset=0x2000 -w out/klipper.bin -v -b -R En revanche, \"l'Arduino M0\" utilise un bootloader de 16KiB (l'application doit \u00eatre compil\u00e9e avec une adresse de d\u00e9marrage de 16KiB). Pour flasher une application sur ce chargeur de d\u00e9marrage, r\u00e9initialisez le microcontr\u00f4leur et ex\u00e9cutez la commande flash dans les premi\u00e8res secondes du d\u00e9marrage - quelque chose comme : avrdude -c stk500v2 -p atmega2560 -P /dev/ttyACM0 -u -Uflash:w:out/klipper.elf.hex:i","title":"Micro-contr\u00f4leurs SAMD21 (Arduino Zero)"},{"location":"Bootloaders.html#micro-controleurs-samd51-adafruit-metro-m4-et-similaires","text":"Comme le SAMD21, le chargeur de d\u00e9marrage SAMD51 est flash\u00e9 via l'interface ARM Serial Wire Debug (SWD). Pour flasher un chargeur de d\u00e9marrage avec OpenOCD sur un Raspberry Pi utilisez la configuration de puce suivante : source [find target/atsame5x.cfg] Obtenir un Chargeur de D\u00e9marrage - De nombreux Chargeurs de d\u00e9marrage sont disponibles sur https://github.com/adafruit/uf2-samdx1/releases/latest . Par exemple\u202f: wget 'https://github.com/adafruit/uf2-samdx1/releases/download/v3.7.0/bootloader-itsybitsy_m4-v3.7.0.bin' Flashez avec des commandes OpenOCD similaires \u00e0 : at91samd bootloader 0 program bootloader-itsybitsy_m4-v3.7.0.bin verify at91samd bootloader 16384 Le SAMD51 utilise un chargeur de d\u00e9marrage de 16 Ko (l'application doit \u00eatre compil\u00e9e avec une adresse de d\u00e9marrage de 16 Ko). Pour flasher une application, utilisez quelque chose comme : bossac -U -p /dev/ttyACM0 --offset=0x4000 -w out/klipper.bin -v -b -R","title":"Micro-contr\u00f4leurs SAMD51 (Adafruit Metro-M4 et similaires)"},{"location":"Bootloaders.html#microcontroleurs-stm32f103-dispositifs-blue-pill","text":"Les appareils STM32F103 ont une ROM qui peut flasher un chargeur de d\u00e9marrage ou une application via un port s\u00e9rie 3,3 V. En r\u00e8gle g\u00e9n\u00e9rale, on c\u00e2blerait les broches PA10 (MCU Rx) et PA9 (MCU Tx) \u00e0 un adaptateur UART 3,3 V. Pour acc\u00e9der \u00e0 la ROM, il faut connecter la broche \"boot 0\" au niveau haut et la broche \"boot 1\" au niveau bas, puis r\u00e9initialiser l'appareil. Le package \"stm32flash\" peut ensuite \u00eatre utilis\u00e9 pour flasher l'appareil en utilisant quelque chose comme : stm32flash -w out/klipper.bin -v -g 0 /dev/ttyAMA0 Notez que si l'on utilise un Raspberry Pi pour le port s\u00e9rie 3.3V, le protocole stm32flash utilise un mode de parit\u00e9 s\u00e9rie que le \"mini UART\" du Raspberry Pi ne prend pas en charge. Voir https://www.raspberrypi.com/documentation/computers/configuration.html#configuring-uarts pour plus de d\u00e9tails sur l'activation de l'uart complet sur les broches GPIO du Raspberry Pi. Apr\u00e8s avoir flash\u00e9, r\u00e9glez \u00e0 la fois \"boot 0\" et \"boot 1\" sur bas afin que les futures r\u00e9initialisations d\u00e9marrent \u00e0 partir du flash.","title":"Microcontr\u00f4leurs STM32F103 (dispositifs Blue Pill)"},{"location":"Bootloaders.html#stm32f103-avec-chargeur-de-demarrage-stm32duino","text":"Le projet \"stm32duino\" a un chargeur de d\u00e9marrage compatible USB - voir : https://github.com/rogerclarkmelbourne/STM32duino-bootloader Ce chargeur de d\u00e9marrage peut \u00eatre flash\u00e9 via un port s\u00e9rie 3,3 V avec quelque chose comme : wget 'https://github.com/rogerclarkmelbourne/STM32duino-bootloader/raw/master/binaries/generic_boot20_pc13.bin' stm32flash -w generic_boot20_pc13.bin -v -g 0 /dev/ttyAMA0 Ce chargeur de d\u00e9marrage utilise 8 Ko d'espace flash (l'application doit \u00eatre compil\u00e9e avec une adresse de d\u00e9marrage de 8 Ko). Flashez une application avec quelque chose comme : dfu-util -d 1eaf:0003 -a 2 -R -D out/klipper.bin Le chargeur de d\u00e9marrage ne s'ex\u00e9cute g\u00e9n\u00e9ralement que pendant une courte p\u00e9riode apr\u00e8s le d\u00e9marrage. Il peut \u00eatre n\u00e9cessaire de chronom\u00e9trer la commande ci-dessus pour qu'elle s'ex\u00e9cute pendant que le chargeur de d\u00e9marrage est toujours actif (le chargeur de d\u00e9marrage fait clignoter une LED de la carte pendant son ex\u00e9cution). Vous pouvez \u00e9galement d\u00e9finir la broche \"boot 0\" sur low et la broche \"boot 1\" sur high pour rester en mode chargeur de d\u00e9marrage apr\u00e8s une r\u00e9initialisation.","title":"STM32F103 avec chargeur de d\u00e9marrage stm32duino"},{"location":"Bootloaders.html#stm32f103-avec-chargeur-de-demarrage-hid","text":"Le chargeur de d\u00e9marrage HID est un chargeur de d\u00e9marrage compact et sans pilote capable de flasher via USB. Un fork avec des builds sp\u00e9cifiques au SKR Mini E3 1.2 est \u00e9galement disponible. Pour les cartes STM32F103 g\u00e9n\u00e9riques telles que la blue pill, il est possible de flasher le chargeur de d\u00e9marrage via un port s\u00e9rie 3.3v en utilisant stm32flash comme indiqu\u00e9 dans la section stm32duino ci-dessus, en rempla\u00e7ant le nom de fichier par le binaire du chargeur de d\u00e9marrage souhait\u00e9 (c'est-\u00e0-dire\u202f: hid_generic_pc13.bin pour la blue pill). Il n'est pas possible d'utiliser stm32flash pour le SKR Mini E3 car la broche boot0 est directement li\u00e9e \u00e0 la terre et non connect\u00e9e via des broches d'en-t\u00eate. Il est recommand\u00e9 d'utiliser un STLink V2 avec le programmeur STM32Cube pour flasher le bootloader. Si vous n'avez pas acc\u00e8s \u00e0 un STLink, il est \u00e9galement possible d'utiliser un Raspberry Pi et OpenOCD avec la configuration de puce suivante : source [find target/stm32f1x.cfg] Si vous le souhaitez, vous pouvez faire une sauvegarde du flash actuel avec la commande suivante. Notez que cela peut prendre un certain temps : flash read_bank 0 btt_skr_mini_e3_backup.bin vous pouvez flasher avec des commandes similaires \u00e0 : stm32f1x mass_erase 0 program hid_btt_skr_mini_e3.bin verify 0x08000000 NOTES\u202f: L'exemple ci-dessus efface la puce puis programme le bootloader. Quelle que soit la m\u00e9thode choisie pour flasher, il est recommand\u00e9 d'effacer la puce avant de flasher. Avant de flasher le SKR Mini E3 avec ce chargeur de d\u00e9marrage, vous devez savoir que vous ne pourrez plus mettre \u00e0 jour le firmware via la carte SD. You may need to hold down the reset button on the board while launching OpenOCD. It should display something like: Open On-Chip Debugger 0.10.0+dev-01204-gc60252ac-dirty (2020-04-27-16:00) Licensed under GNU GPL v2 For bug reports, read http://openocd.org/doc/doxygen/bugs.html DEPRECATED! use 'adapter speed' not 'adapter_khz' Info : BCM2835 GPIO JTAG/SWD bitbang driver Info : JTAG and SWD modes enabled Info : clock speed 40 kHz Info : SWD DPIDR 0x1ba01477 Info : stm32f1x.cpu: hardware has 6 breakpoints, 4 watchpoints Info : stm32f1x.cpu: external reset detected Info : starting gdb server for stm32f1x.cpu on 3333 Info : Listening on port 3333 for gdb connections Apr\u00e8s quoi, vous pouvez rel\u00e2cher le bouton de r\u00e9initialisation. Ce chargeur de d\u00e9marrage n\u00e9cessite 2 Ko d'espace flash (l'application doit \u00eatre compil\u00e9e avec une adresse de d\u00e9marrage de 2 Ko). Le programme hid-flash est utilis\u00e9 pour t\u00e9l\u00e9charger un binaire sur le bootloader. Vous pouvez installer ce logiciel avec les commandes suivantes : sudo apt install libusb-1.0 cd ~/klipper/lib/hidflash make Si le chargeur de d\u00e9marrage est en cours d'ex\u00e9cution, vous pouvez flasher avec quelque chose comme : ~/klipper/lib/hidflash/hid-flash ~/klipper/out/klipper.bin Vous pouvez aussi utiliser make flash pour flasher directement klipper : make flash FLASH_DEVICE=1209:BEBA OU si klipper a d\u00e9j\u00e0 \u00e9t\u00e9 flash\u00e9 : make flash FLASH_DEVICE=/dev/ttyACM0 Il peut \u00eatre n\u00e9cessaire d'entrer manuellement dans le chargeur de d\u00e9marrage, cela peut \u00eatre fait en d\u00e9finissant \"boot 0\" au niveau bas et \"boot 1\" au niveau haut. Sur le SKR Mini E3 \"Boot 1\" n'est pas disponible, vous pouvez donc le faire en mettant la broche PA2 au niveau bas si vous avez flash\u00e9 \"hid_btt_skr_mini_e3.bin\". Cette broche est \u00e9tiquet\u00e9e \"TX0\" sur l'en-t\u00eate TFT dans le document \"PIN\" du SKR Mini E3. Il y a une broche de terre \u00e0 c\u00f4t\u00e9 de PA2 que vous pouvez utiliser pour mettre PA2 \u00e0 0.","title":"STM32F103 avec chargeur de d\u00e9marrage HID"},{"location":"Bootloaders.html#stm32f103stm32f072-avec-chargeur-de-demarrage-msc","text":"Le chargeur de d\u00e9marrage MSC est un chargeur de d\u00e9marrage sans pilote capable de flasher via USB. Il est possible de flasher le chargeur de d\u00e9marrage via un port s\u00e9rie 3.3v en utilisant stm32flash comme indiqu\u00e9 dans la section stm32duino ci-dessus, en rempla\u00e7ant le nom de fichier par le binaire du chargeur de d\u00e9marrage MSC souhait\u00e9 (c'est-\u00e0-dire : MSCboot-Bluepill.bin pour la blue pill). Pour les cartes STM32F072, il est \u00e9galement possible de flasher le bootloader via USB (via DFU) avec quelque chose comme : dfu-util -d 0483:df11 -a 0 -R -D MSCboot-STM32F072.bin -s0x08000000:leave Ce chargeur de d\u00e9marrage utilise 8 Ko ou 16 Ko d'espace flash, voir la description du chargeur de d\u00e9marrage (l'application doit \u00eatre compil\u00e9e avec l'adresse de d\u00e9marrage correspondante). Le chargeur de d\u00e9marrage peut \u00eatre activ\u00e9 en appuyant deux fois sur le bouton de r\u00e9initialisation de la carte. D\u00e8s que le chargeur de d\u00e9marrage est activ\u00e9, la carte appara\u00eet comme une cl\u00e9 USB sur laquelle le fichier klipper.bin peut \u00eatre copi\u00e9.","title":"STM32F103/STM32F072 avec chargeur de d\u00e9marrage MSC"},{"location":"Bootloaders.html#stm32f103stm32f0x2-avec-chargeur-de-demarrage-canboot","text":"Le chargeur de d\u00e9marrage CanBoot offre une option pour t\u00e9l\u00e9charger le micrologiciel Klipper via le CANBUS. Le chargeur de d\u00e9marrage lui-m\u00eame est d\u00e9riv\u00e9 du code source de Klipper. Actuellement, CanBoot prend en charge les mod\u00e8les STM32F103, STM32F042 et STM32F072. Il est recommand\u00e9 d'utiliser un programmeur ST-Link pour flasher CanBoot, mais il devrait \u00eatre possible de flasher en utilisant stm32flash sur les appareils STM32F103 et dfu-util sur les appareils STM32F042/STM32F072. Consultez les sections pr\u00e9c\u00e9dentes de ce document pour obtenir des instructions sur ces m\u00e9thodes de flash, en rempla\u00e7ant canboot.bin par le nom de fichier, le cas \u00e9ch\u00e9ant. Le lien CanBoot ci-dessus fournit des instructions pour cr\u00e9er le chargeur de d\u00e9marrage. La premi\u00e8re fois que CanBoot a \u00e9t\u00e9 flash\u00e9, il devrait d\u00e9tecter qu'aucune application n'est pr\u00e9sente et entrer dans le chargeur de d\u00e9marrage. Si cela ne se produit pas, il est possible d'entrer dans le chargeur de d\u00e9marrage en appuyant deux fois de suite sur le bouton de r\u00e9initialisation. L'utilitaire flash_can.py fourni dans le dossier lib/canboot peut \u00eatre utilis\u00e9 pour t\u00e9l\u00e9charger le firmware Klipper. L'UUID de l'appareil doit clignoter. Si vous n'avez pas d'UUID, il est possible d'interroger les n\u0153uds ex\u00e9cutant actuellement le chargeur de d\u00e9marrage : python3 flash_can.py -q Cela renverra les UUID pour tous les n\u0153uds connect\u00e9s et qui n'avaient pas d'UUID attribu\u00e9. Cela devrait inclure tous les n\u0153uds actuellement dans le chargeur de d\u00e9marrage. Une fois que vous avez un UUID, vous pouvez t\u00e9l\u00e9charger le firmware avec la commande suivante : python3 flash_can.py -i can0 -f ~/klipper/out/klipper.bin -u aabbccddeeff O\u00f9 aabbccddeeff est remplac\u00e9 par votre UUID. Notez que les options -i et -f peuvent \u00eatre omises, elles sont par d\u00e9faut sur can0 et ~/klipper/out/klipper.bin . Lors de la cr\u00e9ation de Klipper pour une utilisation avec CanBoot, s\u00e9lectionnez l'option 8 KiB Bootloader.","title":"STM32F103/STM32F0x2 avec chargeur de d\u00e9marrage CanBoot"},{"location":"Bootloaders.html#micro-controleurs-stm32f4-skr-pro-11","text":"Les microcontr\u00f4leurs STM32F4 sont \u00e9quip\u00e9s d'un chargeur de d\u00e9marrage syst\u00e8me int\u00e9gr\u00e9 capable de flasher via USB (via DFU), s\u00e9rie 3,3 V et diverses autres m\u00e9thodes (voir le document STM AN2606 pour plus d'informations). Certaines cartes STM32F4, telles que le SKR Pro 1.1, ne peuvent pas entrer dans le chargeur de d\u00e9marrage DFU. Le chargeur de d\u00e9marrage HID est disponible pour les cartes bas\u00e9es sur STM32F405/407 si l'utilisateur pr\u00e9f\u00e8re flasher sur USB plut\u00f4t que d'utiliser la carte SD. Notez que vous devrez peut-\u00eatre configurer et construire une version sp\u00e9cifique \u00e0 votre carte, une version pour le SKR Pro 1.1 est disponible ici . \u00c0 moins que votre carte ne soit compatible DFU, la m\u00e9thode de flash la plus accessible est probablement via un port s\u00e9rie 3.3v, qui suit la m\u00eame proc\u00e9dure que flasher le STM32F103 avec stm32flash . Par exemple\u202f: wget https://github.com/Arksine/STM32_HID_Bootloader/releases/download/v0.5-beta/hid_bootloader_SKR_PRO.bin stm32flash -w hid_bootloader_SKR_PRO.bin -v -g 0 /dev/ttyAMA0 Ce chargeur de d\u00e9marrage n\u00e9cessite 16 Ko d'espace flash sur le STM32F4 (l'application doit \u00eatre compil\u00e9e avec une adresse de d\u00e9marrage de 16 Ko). Comme avec le STM32F1, le STM32F4 utilise l'outil hid-flash pour t\u00e9l\u00e9charger des fichiers binaires sur le MCU. Voir les instructions ci-dessus pour plus de d\u00e9tails sur la fa\u00e7on de construire et d'utiliser hid-flash. Il peut \u00eatre n\u00e9cessaire d'entrer manuellement dans le chargeur de d\u00e9marrage, cela peut \u00eatre fait en d\u00e9finissant \"boot 0\" au niveau bas, \"boot 1\" au niveau haut et en branchant l'appareil. Une fois la programmation termin\u00e9e, d\u00e9branchez l'appareil et re-r\u00e9glez \"boot 1\" au niveau bas pour que l'application soit charg\u00e9e.","title":"Micro-contr\u00f4leurs STM32F4 (SKR Pro 1.1)"},{"location":"Bootloaders.html#micro-controleurs-lpc176x-smoothieboards","text":"Ce document ne d\u00e9crit pas la m\u00e9thode pour flasher le Chargeur de d\u00e9marrage lui-m\u00eame - voir : http://smoothieware.org/flashing-the-bootloader pour plus d'informations sur ce sujet. Il est courant que les Smoothieboards soient livr\u00e9s avec un chargeur de d\u00e9marrage de : https://github.com/triffid/LPC17xx-DFU-Bootloader . Lors de l'utilisation de ce chargeur de d\u00e9marrage, l'application doit \u00eatre compil\u00e9e avec une adresse de d\u00e9marrage de 16 Ko. Le moyen le plus simple de flasher une application avec ce chargeur de d\u00e9marrage est de copier le fichier d'application (par exemple, out/klipper.bin ) dans un fichier nomm\u00e9 firmware.bin sur une carte SD, et puis de red\u00e9marrer le microcontr\u00f4leur avec cette carte SD.","title":"Micro-contr\u00f4leurs LPC176x (Smoothieboards)"},{"location":"Bootloaders.html#executer-openocd-sur-le-raspberry-pi","text":"OpenOCD est un logiciel qui peut effectuer un flashage et un d\u00e9bogage de puce de bas niveau. Il peut utiliser les broches GPIO d'un Raspberry Pi pour communiquer avec une vari\u00e9t\u00e9 de puces ARM. Cette section d\u00e9crit comment installer et lancer OpenOCD. Elle d\u00e9rive des instructions disponibles sur : https://learn.adafruit.com/programming-microcontrollers-using-openocd-on-raspberry-pi Commencez par t\u00e9l\u00e9charger et compiler le logiciel (chaque \u00e9tape peut prendre plusieurs minutes et l'\u00e9tape \"make\" peut prendre plus de 30 minutes) : sudo apt-get update sudo apt-get install autoconf libtool telnet mkdir ~/openocd cd ~/openocd/ git clone http://openocd.zylin.com/openocd cd openocd ./bootstrap ./configure --enable-sysfsgpio --enable-bcm2835gpio --prefix=/home/pi/openocd/install make make install","title":"Ex\u00e9cuter OpenOCD sur le Raspberry PI"},{"location":"Bootloaders.html#configurer-openocd","text":"Cr\u00e9ez un fichier de configuration OpenOCD : nano ~/openocd/openocd.cfg Utilisez une configuration similaire \u00e0 la suivante : # Utilise les pins du RPI: GPIO25 pour SWDCLK, GPIO24 pour SWDIO, GPIO18 pour nRST source [find interface/raspberrypi2-native.cfg] bcm2835gpio_swd_nums 25 24 bcm2835gpio_srst_num 18 transport select swd # Utilise le reset c\u00e2bl\u00e9 pour la raz de la puce reset_config srst_only adapter_nsrst_delay 100 adapter_nsrst_assert_width 100 # Specification du type de puce source [find target/atsame5x.cfg] # D\u00e9finir la vitesse de l'adaptateur adapter_khz 40 # Connexion \u00e0 la puce init targets reset halt","title":"Configurer OpenOCD"},{"location":"Bootloaders.html#cablez-le-raspberry-pi-sur-la-puce-cible","text":"\u00c9teignez \u00e0 la fois le Raspberry Pi et la puce cible avant le c\u00e2blage ! V\u00e9rifiez que la puce cible utilise bien du 3,3 V avant de la connecter au Raspberry Pi ! Connectez GND, SWDCLK, SWDIO et RST sur la puce cible \u00e0 GND, GPIO25, GPIO24 et GPIO18 sur le Raspberry Pi. Mettez ensuite le Raspberry Pi sous tension et alimentez la puce cible.","title":"C\u00e2blez le Raspberry Pi sur la puce cible"},{"location":"Bootloaders.html#executez-openocd","text":"Ex\u00e9cutez OpenOCD : cd ~/openocd/ sudo ~/openocd/install/bin/openocd -f ~/openocd/openocd.cfg Ce qui pr\u00e9c\u00e8de devrait amener OpenOCD \u00e0 \u00e9mettre des messages texte, puis \u00e0 attendre (il ne doit pas imm\u00e9diatement revenir \u00e0 l'invite du shell). Si OpenOCD se ferme tout seul ou s'il continue \u00e0 \u00e9mettre des messages texte, v\u00e9rifiez \u00e0 nouveau le c\u00e2blage. Une fois OpenOCD en cours d'ex\u00e9cution et stable, on peut lui envoyer des commandes via telnet. Ouvrez une autre session SSH et ex\u00e9cutez ce qui suit : telnet 127.0.0.1 4444 (Vous pouvez quitter telnet en appuyant sur ctrl+] puis en ex\u00e9cutant la commande \"quit\".)","title":"Ex\u00e9cutez OpenOCD"},{"location":"Bootloaders.html#openocd-et-gdb","text":"Il est possible d'utiliser OpenOCD avec gdb pour d\u00e9boguer Klipper. Les commandes suivantes supposent que l'on ex\u00e9cute gdb sur une machine de bureau. Ajoutez ce qui suit au fichier de configuration OpenOCD : bindto 0.0.0.0 gdb_port 44444 Red\u00e9marrez OpenOCD sur le Raspberry Pi, puis ex\u00e9cutez la commande Unix suivante sur la machine de bureau : cd /path/to/klipper/ gdb out/klipper.elf Dans gdb, ex\u00e9cutez : target remote octopi:44444 (Remplacez \"octopi\" par le nom d'h\u00f4te du Raspberry Pi.) Une fois que gdb est en cours d'ex\u00e9cution, il est possible de d\u00e9finir des points d'arr\u00eat et d'inspecter les registres.","title":"OpenOCD et gdb"},{"location":"CANBUS.html","text":"CANBUS \u00b6 Ce document d\u00e9crit la prise en charge du CAN bus de Klipper. Mat\u00e9riel de l'appareil \u00b6 Klipper ne prend actuellement en charge CAN que sur les puces stm32, same5x et rp2040. De plus, la puce du microcontr\u00f4leur doit se trouver sur une carte dot\u00e9e d'un \u00e9metteur-r\u00e9cepteur CAN. Pour compiler le firmware de votre mat\u00e9riel canbus, ex\u00e9cutez make menuconfig et s\u00e9lectionnez \u00ab CAN bus \u00bb comme interface de communication. Enfin, compilez le code du microcontr\u00f4leur et flashez-le sur la carte cible. Mat\u00e9riel de l'h\u00f4te \u00b6 Pour utiliser un bus CAN, il est n\u00e9cessaire d'avoir un adaptateur h\u00f4te. Il existe actuellement deux solutions : Utilisez une Carte fille Waveshare Raspberry Pi CAN ou l'un de ses nombreux clones. Utilisez un adaptateur USB CAN (par exemple https://hacker-gadgets.com/product/cantact-usb-can-adapter/ ). Il existe de nombreux adaptateurs USB vers CAN diff\u00e9rents - lorsque vous en choisissez un, nous vous recommandons de v\u00e9rifier qu'il peut ex\u00e9cuter le micrologiciel Candlelight . (Malheureusement, nous avons constat\u00e9 que certains adaptateurs USB ex\u00e9cutent un micrologiciel d\u00e9fectueux et sont bloqu\u00e9s, v\u00e9rifiez avant d'acheter.) Il faut aussi configurer le syst\u00e8me d'exploitation h\u00f4te pour utiliser l'adaptateur. Cela se fait g\u00e9n\u00e9ralement en cr\u00e9ant un nouveau fichier nomm\u00e9 /etc/network/interfaces.d/can0 avec le contenu suivant : auto can0 iface can0 can static bitrate 500000 up ifconfig $IFACE txqueuelen 128 Notez que la \"Carte Fille Raspberry Pi CAN hat\" n\u00e9cessite \u00e9galement modifications de config.txt . R\u00e9sistances de terminaison \u00b6 Un bus CAN doit avoir deux r\u00e9sistances de 120 ohms entre les fils CANH et CANL. Id\u00e9alement, une r\u00e9sistance situ\u00e9e \u00e0 chaque extr\u00e9mit\u00e9 du bus. Notez que certains appareils ont une r\u00e9sistance int\u00e9gr\u00e9e de 120 ohms (par exemple, le \"Waveshare Raspberry Pi CAN hat\" a une r\u00e9sistance soud\u00e9e qui ne peut pas \u00eatre facilement retir\u00e9e). Certains appareils n'incluent pas de r\u00e9sistance du tout. D'autres appareils ont un m\u00e9canisme pour s\u00e9lectionner la r\u00e9sistance (g\u00e9n\u00e9ralement en connectant un ou plusieurs \"cavalier\"). V\u00e9rifiez les sch\u00e9mas de tous les appareils sur le bus CAN pour v\u00e9rifier qu'il y a deux et seulement deux r\u00e9sistances de 120 ohms sur le bus. Pour tester que les r\u00e9sistances sont correctes, on peut couper l'alimentation de l'imprimante et utiliser un multim\u00e8tre pour v\u00e9rifier la r\u00e9sistance entre les fils CANH et CANL - la r\u00e9sistance doit \u00eatre d'environ 60 ohms sur un bus CAN correctement c\u00e2bl\u00e9. Trouver le canbus_uuid pour les nouveaux microcontr\u00f4leurs \u00b6 Chaque microcontr\u00f4leur sur le bus CAN se voit attribuer un identifiant unique bas\u00e9 sur un identifiant de puce cod\u00e9 en usine dans chaque microcontr\u00f4leur. Pour trouver les identifiant canbus des microcontr\u00f4leurs, assurez-vous que le mat\u00e9riel est correctement aliment\u00e9 et c\u00e2bl\u00e9, puis ex\u00e9cutez : ~/klippy-env/bin/python ~/klipper/scripts/canbus_query.py can0 Si des p\u00e9riph\u00e9riques CAN non initialis\u00e9s sont d\u00e9tect\u00e9s, la commande ci-dessus remontera des lignes comme celles-ci : Found canbus_uuid=11aa22bb33cc, Application: Klipper Chaque appareil aura un identifiant unique. Dans l'exemple ci-dessus, 11aa22bb33cc est le \"canbus_uuid\" du microcontr\u00f4leur. Notez que l'outil canbus_query.py ne signalera que les appareils non initialis\u00e9s - si Klipper (ou un outil similaire) configure l'appareil, il n'appara\u00eetra plus dans la liste. Configuration de Klipper \u00b6 Mettez \u00e0 jour la configuration de Klipper configuration mcu afin d'utiliser le bus CAN pour communiquer avec l'appareil - par exemple : [mcu my_can_mcu] canbus_uuid: 11aa22bb33cc Mode pont USB vers bus CAN \u00b6 Certains microcontr\u00f4leurs prennent en charge la s\u00e9lection du mode \"pont USB vers bus CAN\" pendant \"make menuconfig\". Ce mode peut permettre d'utiliser un microcontr\u00f4leur \u00e0 la fois comme \"adaptateur de bus USB vers CAN\" et comme n\u0153ud Klipper. Lorsque Klipper utilise ce mode, le microcontr\u00f4leur appara\u00eet comme un \"adaptateur de bus USB CAN\" sous Linux. Le \"Klipper bridge mcu\" lui-m\u00eame appara\u00eetra comme s'il se trouvait sur ce bus CAN - il peut \u00eatre identifi\u00e9 via canbus_query.py et configur\u00e9 comme les autres n\u0153uds Klipper du bus CAN. Il appara\u00eetra \u00e0 c\u00f4t\u00e9 d'autres appareils qui sont en fait sur le bus CAN. Quelques remarques importantes lors de l'utilisation de ce mode : Le \"bridge mcu\" n'est pas r\u00e9ellement sur le bus CAN. Les messages entrants et sortants ne consomment pas de bande passante sur le bus CAN. Le mcu ne peut pas \u00eatre vu par les autres adaptateurs qui sont sur le bus CAN. Il est n\u00e9cessaire de configurer l'interface can0 (ou similaire) sous Linux afin de communiquer avec le bus. Cependant, la vitesse du bus CAN Linux et les options de synchronisation des bits du bus CAN sont ignor\u00e9es par Klipper. Actuellement, la fr\u00e9quence du bus CAN est sp\u00e9cifi\u00e9e lors de \"make menuconfig\" et la vitesse du bus sp\u00e9cifi\u00e9e dans Linux est ignor\u00e9e. Chaque fois que le \"bridge mcu\" est r\u00e9initialis\u00e9, Linux d\u00e9sactive l'interface can0 correspondante. Pour assurer une bonne gestion des commandes FIRMWARE_RESTART et RESTART, il est recommand\u00e9 de remplacer auto par allow-hotplug dans le fichier /etc/network/interfaces.d/can0 dossier. Par exemple\u202f: allow-hotplug can0 iface can0 can static bitrate 500000 up ifconfig $IFACE txqueuelen 128","title":"CANBUS"},{"location":"CANBUS.html#canbus","text":"Ce document d\u00e9crit la prise en charge du CAN bus de Klipper.","title":"CANBUS"},{"location":"CANBUS.html#materiel-de-lappareil","text":"Klipper ne prend actuellement en charge CAN que sur les puces stm32, same5x et rp2040. De plus, la puce du microcontr\u00f4leur doit se trouver sur une carte dot\u00e9e d'un \u00e9metteur-r\u00e9cepteur CAN. Pour compiler le firmware de votre mat\u00e9riel canbus, ex\u00e9cutez make menuconfig et s\u00e9lectionnez \u00ab CAN bus \u00bb comme interface de communication. Enfin, compilez le code du microcontr\u00f4leur et flashez-le sur la carte cible.","title":"Mat\u00e9riel de l'appareil"},{"location":"CANBUS.html#materiel-de-lhote","text":"Pour utiliser un bus CAN, il est n\u00e9cessaire d'avoir un adaptateur h\u00f4te. Il existe actuellement deux solutions : Utilisez une Carte fille Waveshare Raspberry Pi CAN ou l'un de ses nombreux clones. Utilisez un adaptateur USB CAN (par exemple https://hacker-gadgets.com/product/cantact-usb-can-adapter/ ). Il existe de nombreux adaptateurs USB vers CAN diff\u00e9rents - lorsque vous en choisissez un, nous vous recommandons de v\u00e9rifier qu'il peut ex\u00e9cuter le micrologiciel Candlelight . (Malheureusement, nous avons constat\u00e9 que certains adaptateurs USB ex\u00e9cutent un micrologiciel d\u00e9fectueux et sont bloqu\u00e9s, v\u00e9rifiez avant d'acheter.) Il faut aussi configurer le syst\u00e8me d'exploitation h\u00f4te pour utiliser l'adaptateur. Cela se fait g\u00e9n\u00e9ralement en cr\u00e9ant un nouveau fichier nomm\u00e9 /etc/network/interfaces.d/can0 avec le contenu suivant : auto can0 iface can0 can static bitrate 500000 up ifconfig $IFACE txqueuelen 128 Notez que la \"Carte Fille Raspberry Pi CAN hat\" n\u00e9cessite \u00e9galement modifications de config.txt .","title":"Mat\u00e9riel de l'h\u00f4te"},{"location":"CANBUS.html#resistances-de-terminaison","text":"Un bus CAN doit avoir deux r\u00e9sistances de 120 ohms entre les fils CANH et CANL. Id\u00e9alement, une r\u00e9sistance situ\u00e9e \u00e0 chaque extr\u00e9mit\u00e9 du bus. Notez que certains appareils ont une r\u00e9sistance int\u00e9gr\u00e9e de 120 ohms (par exemple, le \"Waveshare Raspberry Pi CAN hat\" a une r\u00e9sistance soud\u00e9e qui ne peut pas \u00eatre facilement retir\u00e9e). Certains appareils n'incluent pas de r\u00e9sistance du tout. D'autres appareils ont un m\u00e9canisme pour s\u00e9lectionner la r\u00e9sistance (g\u00e9n\u00e9ralement en connectant un ou plusieurs \"cavalier\"). V\u00e9rifiez les sch\u00e9mas de tous les appareils sur le bus CAN pour v\u00e9rifier qu'il y a deux et seulement deux r\u00e9sistances de 120 ohms sur le bus. Pour tester que les r\u00e9sistances sont correctes, on peut couper l'alimentation de l'imprimante et utiliser un multim\u00e8tre pour v\u00e9rifier la r\u00e9sistance entre les fils CANH et CANL - la r\u00e9sistance doit \u00eatre d'environ 60 ohms sur un bus CAN correctement c\u00e2bl\u00e9.","title":"R\u00e9sistances de terminaison"},{"location":"CANBUS.html#trouver-le-canbus_uuid-pour-les-nouveaux-microcontroleurs","text":"Chaque microcontr\u00f4leur sur le bus CAN se voit attribuer un identifiant unique bas\u00e9 sur un identifiant de puce cod\u00e9 en usine dans chaque microcontr\u00f4leur. Pour trouver les identifiant canbus des microcontr\u00f4leurs, assurez-vous que le mat\u00e9riel est correctement aliment\u00e9 et c\u00e2bl\u00e9, puis ex\u00e9cutez : ~/klippy-env/bin/python ~/klipper/scripts/canbus_query.py can0 Si des p\u00e9riph\u00e9riques CAN non initialis\u00e9s sont d\u00e9tect\u00e9s, la commande ci-dessus remontera des lignes comme celles-ci : Found canbus_uuid=11aa22bb33cc, Application: Klipper Chaque appareil aura un identifiant unique. Dans l'exemple ci-dessus, 11aa22bb33cc est le \"canbus_uuid\" du microcontr\u00f4leur. Notez que l'outil canbus_query.py ne signalera que les appareils non initialis\u00e9s - si Klipper (ou un outil similaire) configure l'appareil, il n'appara\u00eetra plus dans la liste.","title":"Trouver le canbus_uuid pour les nouveaux microcontr\u00f4leurs"},{"location":"CANBUS.html#configuration-de-klipper","text":"Mettez \u00e0 jour la configuration de Klipper configuration mcu afin d'utiliser le bus CAN pour communiquer avec l'appareil - par exemple : [mcu my_can_mcu] canbus_uuid: 11aa22bb33cc","title":"Configuration de Klipper"},{"location":"CANBUS.html#mode-pont-usb-vers-bus-can","text":"Certains microcontr\u00f4leurs prennent en charge la s\u00e9lection du mode \"pont USB vers bus CAN\" pendant \"make menuconfig\". Ce mode peut permettre d'utiliser un microcontr\u00f4leur \u00e0 la fois comme \"adaptateur de bus USB vers CAN\" et comme n\u0153ud Klipper. Lorsque Klipper utilise ce mode, le microcontr\u00f4leur appara\u00eet comme un \"adaptateur de bus USB CAN\" sous Linux. Le \"Klipper bridge mcu\" lui-m\u00eame appara\u00eetra comme s'il se trouvait sur ce bus CAN - il peut \u00eatre identifi\u00e9 via canbus_query.py et configur\u00e9 comme les autres n\u0153uds Klipper du bus CAN. Il appara\u00eetra \u00e0 c\u00f4t\u00e9 d'autres appareils qui sont en fait sur le bus CAN. Quelques remarques importantes lors de l'utilisation de ce mode : Le \"bridge mcu\" n'est pas r\u00e9ellement sur le bus CAN. Les messages entrants et sortants ne consomment pas de bande passante sur le bus CAN. Le mcu ne peut pas \u00eatre vu par les autres adaptateurs qui sont sur le bus CAN. Il est n\u00e9cessaire de configurer l'interface can0 (ou similaire) sous Linux afin de communiquer avec le bus. Cependant, la vitesse du bus CAN Linux et les options de synchronisation des bits du bus CAN sont ignor\u00e9es par Klipper. Actuellement, la fr\u00e9quence du bus CAN est sp\u00e9cifi\u00e9e lors de \"make menuconfig\" et la vitesse du bus sp\u00e9cifi\u00e9e dans Linux est ignor\u00e9e. Chaque fois que le \"bridge mcu\" est r\u00e9initialis\u00e9, Linux d\u00e9sactive l'interface can0 correspondante. Pour assurer une bonne gestion des commandes FIRMWARE_RESTART et RESTART, il est recommand\u00e9 de remplacer auto par allow-hotplug dans le fichier /etc/network/interfaces.d/can0 dossier. Par exemple\u202f: allow-hotplug can0 iface can0 can static bitrate 500000 up ifconfig $IFACE txqueuelen 128","title":"Mode pont USB vers bus CAN"},{"location":"CANBUS_protocol.html","text":"Protocole CANBUS \u00b6 Ce document d\u00e9crit le protocole qu'utilise Klipper pour communiquer sur la couche CAN bus . Voir pour plus d'informations sur la configuration de canbus avec Klipper. Assignation de l'identifiant du micro-contr\u00f4leur \u00b6 Klipper utilise uniquement les paquets CAN bus 2.0A de taille standard, limit\u00e9s \u00e0 8 octets de donn\u00e9es et \u00e0 un identificateur de bus CAN de 11 bits. Afin de permettre des communications efficaces, un identifiant ( canbus_nodeid ) de 1 octet est affect\u00e9 \u00e0 chaque microcontr\u00f4leur pour g\u00e9rer les commandes et r\u00e9ponses Klipper. Les commandes Klipper \u00e9mises du microcontr\u00f4leur vers l'h\u00f4te utilisent l'id du bus CAN canbus_nodeid * 2 + 256 , tandis que les messages de retour du microcontr\u00f4leur vers l'h\u00f4te utilisent canbus_nodeid' *2 + 256 + 1 . Chaque microcontr\u00f4leur poss\u00e8de un identifiant unique attribu\u00e9 en usine qui est utilis\u00e9 lors de l'attribution de l'id. Cet identifiant pout d\u00e9passer la taille d'un paquet CAN, un fonction de hash est utilis\u00e9e pour g\u00e9nerer un id unique de 6 octets ( canbus_uuid ) \u00e0 partir de l'id 'usine'. Messages 'Admin' \u00b6 Les messages 'administratifs' sont utilis\u00e9s pour l'attribution des id. Ces messages envoy\u00e9s de l'h\u00f4te vers le microcontr\u00f4leur utilisent l'id 0x3f0\u0300 et les messages envoy\u00e9s du microcontr\u00f4leur vers l'h\u00f4te utilisent l'id 0x3f1 . Tous les microcontr\u00f4leurs \u00e9coutent les messages en provenance de 0x3f0 . Cet id peut \u00eatre consid\u00e9r\u00e9 comme une adresse de multidiffusion. Message CMD_QUERY_UNASSIGNED \u00b6 Cette commande interroge tous les microcontr\u00f4leurs pour lesquels aucun canbus_nodeid n'a \u00e9t\u00e9 assign\u00e9. Ces microcontr\u00f4leurs non assign\u00e9s, retournent un message RESP_NEED_NODEID. Le format du message CMD_QUERY_UNASSIGNED est : <1-octet pour le message_id = 0x00> Message CMD_SET_KLIPPER_NODEID \u00b6 Cette commande attribue un canbus_nodeid \u00e0 partir du canbus_uuid du microcontr\u00f4leur. Le format du message CMD_SET_KLIPPER_NODEID est : <1 octet pour le message_id = 0x01><6 octets pour le canbus_uuid><1 octet pour le canbus_nodeid> Message RESP_NEED_NODEID \u00b6 Le format du message RESP_NODE_NODEID est : <1 octet pour le message_id = 0x20><6 octets pour le canbus_uuid><1 octet pour le set_klipper_nodeid=0x01> Paquets de donn\u00e9es \u00b6 Un microcont\u00f4leur ayant re\u00e7u un nodeid par la commande CMD_SET_KLIPPER_NODEID peut envoyer et recevoir des paquets de donn\u00e9es. Les donn\u00e9es des paquets des messages utilisant l'identifiant de r\u00e9ception du bus CAN du n\u0153ud ( canbus_nodeid * 2 + 256 )' sont simplement ajout\u00e9s \u00e0 la fin du tampon et lorsque un mcu protocol message complet est trouv\u00e9 son contenu est analys\u00e9 et trait\u00e9. Les donn\u00e9es sont trait\u00e9es comme un flux d'octets - il n'est pas n\u00e9cessaire que le d\u00e9but d'un bloc de message Klipper soit align\u00e9 avec le d\u00e9but d'un paquet CAN bus. De la m\u00eame mani\u00e8re, les r\u00e9ponses sont renvoy\u00e9es du micrcontr\u00f4leur \u00e0 l'h\u00f4te en copiant les donn\u00e9es du message dans un ou plusieurs paquets avec l'identifiant canbus ( canbus_nodeid * 2 + 256 + 1 ).","title":"Protocole CANBUS"},{"location":"CANBUS_protocol.html#protocole-canbus","text":"Ce document d\u00e9crit le protocole qu'utilise Klipper pour communiquer sur la couche CAN bus . Voir pour plus d'informations sur la configuration de canbus avec Klipper.","title":"Protocole CANBUS"},{"location":"CANBUS_protocol.html#assignation-de-lidentifiant-du-micro-controleur","text":"Klipper utilise uniquement les paquets CAN bus 2.0A de taille standard, limit\u00e9s \u00e0 8 octets de donn\u00e9es et \u00e0 un identificateur de bus CAN de 11 bits. Afin de permettre des communications efficaces, un identifiant ( canbus_nodeid ) de 1 octet est affect\u00e9 \u00e0 chaque microcontr\u00f4leur pour g\u00e9rer les commandes et r\u00e9ponses Klipper. Les commandes Klipper \u00e9mises du microcontr\u00f4leur vers l'h\u00f4te utilisent l'id du bus CAN canbus_nodeid * 2 + 256 , tandis que les messages de retour du microcontr\u00f4leur vers l'h\u00f4te utilisent canbus_nodeid' *2 + 256 + 1 . Chaque microcontr\u00f4leur poss\u00e8de un identifiant unique attribu\u00e9 en usine qui est utilis\u00e9 lors de l'attribution de l'id. Cet identifiant pout d\u00e9passer la taille d'un paquet CAN, un fonction de hash est utilis\u00e9e pour g\u00e9nerer un id unique de 6 octets ( canbus_uuid ) \u00e0 partir de l'id 'usine'.","title":"Assignation de l'identifiant du micro-contr\u00f4leur"},{"location":"CANBUS_protocol.html#messages-admin","text":"Les messages 'administratifs' sont utilis\u00e9s pour l'attribution des id. Ces messages envoy\u00e9s de l'h\u00f4te vers le microcontr\u00f4leur utilisent l'id 0x3f0\u0300 et les messages envoy\u00e9s du microcontr\u00f4leur vers l'h\u00f4te utilisent l'id 0x3f1 . Tous les microcontr\u00f4leurs \u00e9coutent les messages en provenance de 0x3f0 . Cet id peut \u00eatre consid\u00e9r\u00e9 comme une adresse de multidiffusion.","title":"Messages 'Admin'"},{"location":"CANBUS_protocol.html#message-cmd_query_unassigned","text":"Cette commande interroge tous les microcontr\u00f4leurs pour lesquels aucun canbus_nodeid n'a \u00e9t\u00e9 assign\u00e9. Ces microcontr\u00f4leurs non assign\u00e9s, retournent un message RESP_NEED_NODEID. Le format du message CMD_QUERY_UNASSIGNED est : <1-octet pour le message_id = 0x00>","title":"Message CMD_QUERY_UNASSIGNED"},{"location":"CANBUS_protocol.html#message-cmd_set_klipper_nodeid","text":"Cette commande attribue un canbus_nodeid \u00e0 partir du canbus_uuid du microcontr\u00f4leur. Le format du message CMD_SET_KLIPPER_NODEID est : <1 octet pour le message_id = 0x01><6 octets pour le canbus_uuid><1 octet pour le canbus_nodeid>","title":"Message CMD_SET_KLIPPER_NODEID"},{"location":"CANBUS_protocol.html#message-resp_need_nodeid","text":"Le format du message RESP_NODE_NODEID est : <1 octet pour le message_id = 0x20><6 octets pour le canbus_uuid><1 octet pour le set_klipper_nodeid=0x01>","title":"Message RESP_NEED_NODEID"},{"location":"CANBUS_protocol.html#paquets-de-donnees","text":"Un microcont\u00f4leur ayant re\u00e7u un nodeid par la commande CMD_SET_KLIPPER_NODEID peut envoyer et recevoir des paquets de donn\u00e9es. Les donn\u00e9es des paquets des messages utilisant l'identifiant de r\u00e9ception du bus CAN du n\u0153ud ( canbus_nodeid * 2 + 256 )' sont simplement ajout\u00e9s \u00e0 la fin du tampon et lorsque un mcu protocol message complet est trouv\u00e9 son contenu est analys\u00e9 et trait\u00e9. Les donn\u00e9es sont trait\u00e9es comme un flux d'octets - il n'est pas n\u00e9cessaire que le d\u00e9but d'un bloc de message Klipper soit align\u00e9 avec le d\u00e9but d'un paquet CAN bus. De la m\u00eame mani\u00e8re, les r\u00e9ponses sont renvoy\u00e9es du micrcontr\u00f4leur \u00e0 l'h\u00f4te en copiant les donn\u00e9es du message dans un ou plusieurs paquets avec l'identifiant canbus ( canbus_nodeid * 2 + 256 + 1 ).","title":"Paquets de donn\u00e9es"},{"location":"CONTRIBUTING.html","text":"Contribuer \u00e0 Klipper \u00b6 Merci de contribuer \u00e0 Klipper ! Ce document d\u00e9crit la proc\u00e9dure \u00e0 suivre pour apporter des modifications \u00e0 Klipper. Veuillez consulter la page de contact pour obtenir des informations sur le signalement d'un probl\u00e8me ou pour obtenir des d\u00e9tails sur la mani\u00e8re de contacter les d\u00e9veloppeurs. Aper\u00e7u de la proc\u00e9dure de contribution \u00b6 Les contributions \u00e0 Klipper suivent g\u00e9n\u00e9ralement un processus de haut niveau : Un soumissionnaire commence par cr\u00e9er une GitHub Pull Request lorsqu'une soumission est pr\u00eate \u00e0 \u00eatre d\u00e9ploy\u00e9e \u00e0 grande \u00e9chelle. Lorsqu'un relecteur est disponible pour r\u00e9viser la soumission, il s'attribuera la Pull Request sur GitHub. L'objectif de la r\u00e9vision est de rechercher les d\u00e9fauts et de v\u00e9rifier que la soumission suit les directives document\u00e9es. Apr\u00e8s une r\u00e9vision r\u00e9ussie, le relecteur \"approuve la r\u00e9vision\" sur GitHub et un mainteneur commet la modification dans la branche principale de Klipper. Lorsque vous travaillez sur des am\u00e9liorations, pensez \u00e0 lancer (ou \u00e0 contribuer \u00e0) un sujet sur Klipper Discourse . Une discussion continue sur le forum peut am\u00e9liorer la visibilit\u00e9 du travail de d\u00e9veloppement et peut attirer d'autres personnes int\u00e9ress\u00e9es \u00e0 tester le nouveau travail. A quoi s'attendre lors d'une r\u00e9vision \u00b6 Les contributions \u00e0 Klipper sont examin\u00e9es avant d'\u00eatre fusionn\u00e9es. L'objectif principal du processus de r\u00e9vision est de v\u00e9rifier l'absence de d\u00e9fauts et de s'assurer que la soumission respecte les directives sp\u00e9cifi\u00e9es dans la documentation de Klipper. Il est entendu qu'il existe de nombreuses fa\u00e7ons d'accomplir une t\u00e2che ; l'objectif de la r\u00e9vision n'est pas de discuter de la \"meilleure\" mise en \u0153uvre. Dans la mesure du possible, il est pr\u00e9f\u00e9rable que les discussions de la r\u00e9vision soient ax\u00e9es sur les faits et les mesures. La majorit\u00e9 des soumissions donneront lieu \u00e0 un retour d'information. Soyez pr\u00eat \u00e0 obtenir un retour, \u00e0 fournir des d\u00e9tails suppl\u00e9mentaires et \u00e0 mettre \u00e0 jour la soumission si n\u00e9cessaire. Ce que le relecteur recherche le plus souvent : La soumission est-elle exempte de d\u00e9fauts et est-elle pr\u00eate \u00e0 \u00eatre d\u00e9ploy\u00e9e \u00e0 grande \u00e9chelle ?Les soumissionnaires sont cens\u00e9s tester leurs modifications avant de les soumettre. Les relecteurs recherchent les erreurs, mais ne testent pas, en g\u00e9n\u00e9ral, les soumissions. Une soumission accept\u00e9e est souvent d\u00e9ploy\u00e9e sur des milliers d'imprimantes dans les quelques semaines qui suivent son acceptation. La qualit\u00e9 des soumissions est donc consid\u00e9r\u00e9e comme une priorit\u00e9. Le d\u00e9p\u00f4t GitHub principal de Klipper3d/klipper n'accepte pas les travaux exp\u00e9rimentaux. Les auteurs doivent effectuer les exp\u00e9rimentations, le d\u00e9bogage et les tests dans leurs propres d\u00e9p\u00f4ts. Le serveur Klipper Discourse est un bon endroit pour faire conna\u00eetre les nouveaux travaux et trouver des utilisateurs d\u00e9sireux de fournir des commentaires concrets. Les soumissions doivent r\u00e9ussir tous les tests de r\u00e9gression . Lorsqu'ils corrigent un d\u00e9faut dans le code, les soumissionnaires doivent avoir une compr\u00e9hension g\u00e9n\u00e9rale de la cause fondamentale de ce d\u00e9faut, et la correction doit cibler cette seule cause fondamentale. Les soumissions de code ne doivent pas contenir de code de d\u00e9bogage excessif, d'options de d\u00e9bogage, ni d'enregistrement de d\u00e9bogage \u00e0 l'ex\u00e9cution. Les commentaires dans les soumissions de code doivent se concentrer sur l'am\u00e9lioration de la maintenance du code. Les soumissions ne doivent pas contenir de \"code comment\u00e9\" ni de commentaires excessifs d\u00e9crivant des impl\u00e9mentations pass\u00e9es. Il ne doit pas y avoir de commentaires excessifs de type \"todo\". Les mises \u00e0 jour de la documentation ne doivent pas indiquer qu'il s'agit d'un \"travail en cours\". La demande apporte-t-elle un avantage \"\u00e0 fort impact\" \u00e0 des utilisateurs du monde r\u00e9el effectuant des t\u00e2ches du monde r\u00e9el ?Les relecteurs doivent identifier, au moins dans leur propre esprit, \u00e0 peu pr\u00e8s \"qui est le public cible\", une \u00e9chelle approximative de \"la taille de ce public\", le \"b\u00e9n\u00e9fice\" qu'ils obtiendront, comment le \"b\u00e9n\u00e9fice est mesur\u00e9\", et les \"r\u00e9sultats de ces tests de mesure\". Dans la plupart des cas, ces \u00e9l\u00e9ments sont \u00e9vidents pour l'auteur et l'examinateur, et ne sont pas explicitement mentionn\u00e9s lors d'un examen. Les soumissions \u00e0 la branche principale de Klipper doivent avoir un public cible important. En r\u00e8gle g\u00e9n\u00e9rale, les soumissions doivent cibler une base d'au moins 100 utilisateurs du monde r\u00e9el. Si un relecteur demande des d\u00e9tails sur les \"avantages\" d'une proposition, ne consid\u00e9rez pas cela comme une critique. \u00catre capable de comprendre les avantages concrets d'un changement est une partie naturelle d'un examen. Lorsque l'on discute des avantages, il est pr\u00e9f\u00e9rable de parler de \"faits et de mesures\". En g\u00e9n\u00e9ral, les \u00e9valuateurs ne cherchent pas des r\u00e9ponses du type \"quelqu'un pourrait trouver l'option X utile\", ni des r\u00e9ponses du type \"cette soumission ajoute une fonctionnalit\u00e9 que le micrologiciel X met en \u0153uvre\". Au lieu de cela, il est g\u00e9n\u00e9ralement pr\u00e9f\u00e9rable de discuter des d\u00e9tails sur la fa\u00e7on dont l'am\u00e9lioration de la qualit\u00e9 a \u00e9t\u00e9 mesur\u00e9e et quels \u00e9taient les r\u00e9sultats de ces mesures - par exemple, \"les tests sur les imprimantes Acme X1000 montrent des coins am\u00e9lior\u00e9s comme on le voit sur l'image ...\", ou par exemple \"le temps d'impression de l'objet X du monde r\u00e9el sur une imprimante Foomatic X900 est pass\u00e9 de 4 heures \u00e0 3,5 heures\". Il est entendu que les tests de ce type peuvent prendre beaucoup de temps et d'efforts. Certaines des fonctionnalit\u00e9s les plus remarquables de Klipper ont n\u00e9cessit\u00e9 des mois de discussion, de re-travail, de tests et de documentation avant d'\u00eatre int\u00e9gr\u00e9es dans la branche principale. Tous les nouveaux modules, options de configuration, commandes, param\u00e8tres de commande et documents doivent avoir un \"impact \u00e9lev\u00e9\". Nous ne voulons pas imposer aux utilisateurs des options qu'ils ne peuvent raisonnablement pas configurer, ni des options qui n'apportent aucun avantage notable. Un relecteur peut demander des \u00e9claircissements sur la mani\u00e8re dont un utilisateur doit configurer une option - une r\u00e9ponse id\u00e9ale contiendra des d\u00e9tails sur le processus - par exemple, \"les utilisateurs du MegaX500 doivent r\u00e9gler l'option X sur 99,3 tandis que les utilisateurs du Elite100Y doivent calibrer l'option X en utilisant la proc\u00e9dure ...\". Si le but d'une option est de rendre le code plus modulaire, il est pr\u00e9f\u00e9rable d'utiliser des constantes de code plut\u00f4t que des options de configuration pour l'utilisateur. Les nouveaux modules, les nouvelles options et les nouveaux param\u00e8tres ne doivent pas offrir des fonctionnalit\u00e9s similaires \u00e0 celles des modules existants - si les diff\u00e9rences sont arbitraires, il est pr\u00e9f\u00e9rable d'utiliser le syst\u00e8me existant ou de remanier le code existant. Le droit d'auteur de la soumission est-il clair, non gracieux et compatible ?Les nouveaux fichiers C et Python doivent comporter une d\u00e9claration de copyright sans ambigu\u00eft\u00e9. Voir les fichiers existants pour le format pr\u00e9f\u00e9r\u00e9. Il est d\u00e9conseill\u00e9 de d\u00e9clarer un droit d'auteur sur un fichier existant lorsque l'on apporte des modifications mineures \u00e0 ce fichier. Le code provenant de sources tierces doit \u00eatre compatible avec la licence Klipper (GNU GPLv3). Les ajouts importants de code tiers doivent \u00eatre ajout\u00e9s au r\u00e9pertoire lib/ (et suivre le format d\u00e9crit dans lib/README ). Les soumissionnaires doivent fournir une ligne Signed-off-by en utilisant leur nom r\u00e9el complet. Elle indique que le soumissionnaire est d'accord avec le certificat d'origine du d\u00e9veloppeur . La soumission suit-elle les directives sp\u00e9cifi\u00e9es dans la documentation de Klipper ?En particulier, le code doit suivre les directives de et les fichiers de configuration doivent suivre les directives de . La documentation de Klipper est-elle mise \u00e0 jour pour refl\u00e9ter les nouveaux changements ?Au minimum, la documentation de r\u00e9f\u00e9rence doit \u00eatre mise \u00e0 jour avec les modifications correspondantes du code : Toutes les commandes et tous les param\u00e8tres de commande doivent \u00eatre document\u00e9s dans . Tous les modules destin\u00e9s aux utilisateurs et leurs param\u00e8tres de configuration doivent \u00eatre document\u00e9s dans . Toutes les \"variables d'\u00e9tat\" export\u00e9es doivent \u00eatre document\u00e9es dans . Tous les nouveaux \"webhooks\" et leurs param\u00e8tres doivent \u00eatre document\u00e9s dans . Toute modification qui apporte un changement non r\u00e9trocompatible \u00e0 une commande ou \u00e0 un param\u00e8tre du fichier de configuration doit \u00eatre document\u00e9e dans . Les nouveaux documents doivent \u00eatre ajout\u00e9s \u00e0 et \u00eatre ajout\u00e9s \u00e0 l'index du site web docs/_klipper3d/mkdocs.yml . Les commits sont-ils bien form\u00e9s, abordent-ils un seul sujet par commit, et sont-ils ind\u00e9pendants ?Les messages de validation doivent suivre le format pr\u00e9f\u00e9r\u00e9 . Les commits ne doivent pas avoir de conflit de fusion. Les nouveaux ajouts \u00e0 la branche ma\u00eetresse de Klipper sont toujours effectu\u00e9s via un \"rebase\" ou un \"squash and rebase\". Il n'est g\u00e9n\u00e9ralement pas n\u00e9cessaire pour les soumissionnaires de fusionner \u00e0 nouveau leur soumission \u00e0 chaque mise \u00e0 jour du d\u00e9p\u00f4t ma\u00eetre de Klipper. Cependant, s'il y a un conflit de fusion, il est recommand\u00e9 aux soumissionnaires d'utiliser git rebase pour r\u00e9soudre le conflit. Chaque validation doit porter sur un seul changement de haut niveau. Les changements importants doivent \u00eatre d\u00e9compos\u00e9s en plusieurs commits ind\u00e9pendants. Chaque livraison doit se suffire \u00e0 elle-m\u00eame pour que des outils comme git bisect et git revert fonctionnent de mani\u00e8re fiable. Les modifications des espaces blancs ne doivent pas \u00eatre m\u00e9lang\u00e9es avec les modifications fonctionnelles. En g\u00e9n\u00e9ral, les changements gratuits d'espace blanc ne sont pas accept\u00e9s, sauf s'ils proviennent du \"propri\u00e9taire\" \u00e9tabli du code en cours de modification. Klipper ne met pas en \u0153uvre un \"guide de style de codage\" strict, mais les modifications apport\u00e9es au code existant doivent respecter le flux de code de haut niveau, le style d'indentation du code et le format de ce code existant. Les soumissions de nouveaux modules et syst\u00e8mes b\u00e9n\u00e9ficient d'une plus grande souplesse en mati\u00e8re de style de codage, mais il est pr\u00e9f\u00e9rable que ce nouveau code suive un style coh\u00e9rent en interne et respecte g\u00e9n\u00e9ralement les normes de codage en vigueur dans le secteur. L'objectif d'une r\u00e9vision n'est pas de discuter de \"meilleures mises en \u0153uvre\". Cependant, si un relecteur a du mal \u00e0 comprendre l'impl\u00e9mentation d'une soumission, il peut demander des changements pour rendre l'impl\u00e9mentation plus transparente. En particulier, si les relecteurs ne peuvent pas se convaincre qu'une soumission est exempte de d\u00e9fauts, des changements peuvent \u00eatre n\u00e9cessaires. Dans le cadre d'une r\u00e9vision, un r\u00e9viseur peut cr\u00e9er une Pull Request alternative pour un sujet. Cela peut \u00eatre fait pour \u00e9viter un \"va-et-vient\" excessif sur des \u00e9l\u00e9ments de proc\u00e9dure mineurs et ainsi rationaliser le processus de soumission. Cela peut \u00e9galement \u00eatre fait parce que la discussion inspire un r\u00e9viseur \u00e0 construire une impl\u00e9mentation alternative. Ces deux situations sont le r\u00e9sultat normal d'une r\u00e9vision et ne doivent pas \u00eatre consid\u00e9r\u00e9es comme une critique de la soumission originale. Aider \u00e0 la r\u00e9vision \u00b6 Nous appr\u00e9cions l'aide pour les \u00e9valuations ! Il n'est pas n\u00e9cessaire d'\u00eatre un reviewer list\u00e9 pour effectuer une r\u00e9vision. Les auteurs de Pull Requests GitHub sont \u00e9galement encourag\u00e9s \u00e0 r\u00e9viser leurs propres soumissions. Pour faciliter la r\u00e9vision, suivez les \u00e9tapes d\u00e9crites dans \u00e0 quoi s'attendre lors d'une r\u00e9vision pour v\u00e9rifier la soumission. Une fois la r\u00e9vision termin\u00e9e, ajoutez un commentaire \u00e0 la Pull Request GitHub avec vos conclusions. Si la soumission passe la r\u00e9vision, veuillez l'indiquer explicitement dans le commentaire - par exemple quelque chose comme \"J'ai revu cette modification selon les \u00e9tapes du document CONTRIBUTING et tout me semble correct\". Si vous n'avez pas pu effectuer certaines \u00e9tapes de la r\u00e9vision, veuillez indiquer explicitement quelles \u00e9tapes ont \u00e9t\u00e9 r\u00e9vis\u00e9es et quelles \u00e9tapes ne l'ont pas \u00e9t\u00e9 - par exemple quelque chose comme \"Je n'ai pas v\u00e9rifi\u00e9 les d\u00e9fauts du code, mais j'ai revu tout le reste dans le document CONTRIBUTING et tout semble bon\". Nous appr\u00e9cions \u00e9galement les tests des soumissions. Si le code a \u00e9t\u00e9 test\u00e9, veuillez ajouter un commentaire \u00e0 la Pull Request GitHub avec les r\u00e9sultats de votre test - succ\u00e8s ou \u00e9chec. Veuillez indiquer explicitement que le code a \u00e9t\u00e9 test\u00e9 et les r\u00e9sultats - par exemple quelque chose comme \"J'ai test\u00e9 ce code sur mon imprimante Acme900Z avec une impression de vase et les r\u00e9sultats \u00e9taient bons\". R\u00e9viseurs \u00b6 Les \"r\u00e9viseurs\" de Klipper sont : Nom Id GitHub Domaines d'int\u00e9r\u00eat Dmitry Butyugin @dmbutyugin Input shaping, test de r\u00e9sonance, cin\u00e9matiques Eric Callahan @Arksine Nivellement du lit, flashage du MCU Kevin O'Connor @KevinOConnor Syst\u00e8me de mouvement de base, code du microcontr\u00f4leur Paul McGowan @mental405 Fichiers de configuration, documentation Veuillez ne pas envoyer de \"ping\" \u00e0 l'un des \u00e9valuateurs et ne pas leur adresser de soumissions. Tous les \u00e9valuateurs surveillent les forums et les PR, et prennent en charge les \u00e9valuations quand ils en ont le temps. Les \"mainteneurs\" de Klipper sont : Nom Nom GitHub Kevin O'Connor @KevinOConnor Format des messages de commit \u00b6 Chaque livraison doit avoir un message de livraison format\u00e9 de la mani\u00e8re suivante : module : R\u00e9sum\u00e9 en majuscules, court (50 caract\u00e8res ou moins) Texte explicatif plus d\u00e9taill\u00e9, si n\u00e9cessaire. Limitez-le \u00e0 environ 75 caract\u00e8res ou plus. Dans certains contextes, la premi\u00e8re ligne est consid\u00e9r\u00e9e comme l'objet d'un courriel et le reste du texte comme le corps. sujet d'un message \u00e9lectronique et le reste du texte comme le corps du message. La ligne vierge s\u00e9parant le r\u00e9sum\u00e9 du corps est essentielle (\u00e0 moins que vous n'omettiez enti\u00e8rement le corps). le corps enti\u00e8rement) ; des outils comme rebase peuvent \u00eatre confondus si vous ex\u00e9cutez les les deux ensemble. Les autres paragraphes viennent apr\u00e8s les lignes vides.. Sign\u00e9 par : Mon nom <myemail@example.org> Dans l'exemple ci-dessus, module doit \u00eatre le nom d'un fichier ou d'un r\u00e9pertoire dans le r\u00e9f\u00e9rentiel (sans extension de fichier). Par exemple, clocksync : Corriger une faute de frappe dans l'appel pause() au moment de la connexion . Le but de sp\u00e9cifier un nom de module dans le message de livraison est d'aider \u00e0 fournir un contexte pour les commentaires de livraison. Il est important d'avoir une ligne \"Signed-off-by\" sur chaque commit - elle certifie que vous acceptez le certificat d'origine du d\u00e9veloppeur . Cette ligne doit contenir votre vrai nom (d\u00e9sol\u00e9, pas de pseudonymes ou de contributions anonymes) et une adresse \u00e9lectronique valide. Contribuer aux traductions de Klipper \u00b6 Projet de traduction de Klipper est le projet d\u00e9di\u00e9 \u00e0 la traduction de Klipper dans diff\u00e9rentes langues. Weblate h\u00e9berge toutes les cha\u00eenes Gettext pour la traduction et la r\u00e9vision. Les localisations peuvent \u00eatre affich\u00e9es sur klipper3d.org d\u00e8s lors qu'elles satisfont aux exigences suivantes : 75% Couverture totale Tous les titres (H1) sont traduits Une PR (Pull Request) hi\u00e9rarchis\u00e9e de navigation mise \u00e0 jour dans klipper-translations. Afin de r\u00e9duire la frustration li\u00e9e \u00e0 la traduction de termes sp\u00e9cifiques \u00e0 un domaine et de prendre connaissance des traductions en cours, vous pouvez soumettre une PR modifiant le Projet Klipper-translations readme.md . D\u00e8s qu'une traduction est pr\u00eate, la modification correspondante du projet Klipper peut \u00eatre effectu\u00e9e. Si une traduction existe d\u00e9j\u00e0 dans le r\u00e9f\u00e9rentiel Klipper et ne r\u00e9pond plus \u00e0 la liste de contr\u00f4le ci-dessus, elle sera marqu\u00e9e comme obsol\u00e8te apr\u00e8s un mois sans mise \u00e0 jour. Une fois que les conditions sont remplies, vous devez : mettre \u00e0 jour le fichier active_translations du d\u00e9p\u00f4t de klipper-tranlations Facultatif : ajouter un fichier manual-index.md dans le dossier docs\\locals\\<lang> du d\u00e9p\u00f4t klipper-translations pour remplacer l'index.md sp\u00e9cifique \u00e0 la langue (l'index.md g\u00e9n\u00e9r\u00e9 ne s'affiche pas correctement). Probl\u00e8mes connus : Actuellement, il n'existe pas de m\u00e9thode permettant de traduire correctement les images dans la documentation Il est impossible de traduire les titres dans mkdocs.yml.","title":"Contribuer \u00e0 Klipper"},{"location":"CONTRIBUTING.html#contribuer-a-klipper","text":"Merci de contribuer \u00e0 Klipper ! Ce document d\u00e9crit la proc\u00e9dure \u00e0 suivre pour apporter des modifications \u00e0 Klipper. Veuillez consulter la page de contact pour obtenir des informations sur le signalement d'un probl\u00e8me ou pour obtenir des d\u00e9tails sur la mani\u00e8re de contacter les d\u00e9veloppeurs.","title":"Contribuer \u00e0 Klipper"},{"location":"CONTRIBUTING.html#apercu-de-la-procedure-de-contribution","text":"Les contributions \u00e0 Klipper suivent g\u00e9n\u00e9ralement un processus de haut niveau : Un soumissionnaire commence par cr\u00e9er une GitHub Pull Request lorsqu'une soumission est pr\u00eate \u00e0 \u00eatre d\u00e9ploy\u00e9e \u00e0 grande \u00e9chelle. Lorsqu'un relecteur est disponible pour r\u00e9viser la soumission, il s'attribuera la Pull Request sur GitHub. L'objectif de la r\u00e9vision est de rechercher les d\u00e9fauts et de v\u00e9rifier que la soumission suit les directives document\u00e9es. Apr\u00e8s une r\u00e9vision r\u00e9ussie, le relecteur \"approuve la r\u00e9vision\" sur GitHub et un mainteneur commet la modification dans la branche principale de Klipper. Lorsque vous travaillez sur des am\u00e9liorations, pensez \u00e0 lancer (ou \u00e0 contribuer \u00e0) un sujet sur Klipper Discourse . Une discussion continue sur le forum peut am\u00e9liorer la visibilit\u00e9 du travail de d\u00e9veloppement et peut attirer d'autres personnes int\u00e9ress\u00e9es \u00e0 tester le nouveau travail.","title":"Aper\u00e7u de la proc\u00e9dure de contribution"},{"location":"CONTRIBUTING.html#a-quoi-sattendre-lors-dune-revision","text":"Les contributions \u00e0 Klipper sont examin\u00e9es avant d'\u00eatre fusionn\u00e9es. L'objectif principal du processus de r\u00e9vision est de v\u00e9rifier l'absence de d\u00e9fauts et de s'assurer que la soumission respecte les directives sp\u00e9cifi\u00e9es dans la documentation de Klipper. Il est entendu qu'il existe de nombreuses fa\u00e7ons d'accomplir une t\u00e2che ; l'objectif de la r\u00e9vision n'est pas de discuter de la \"meilleure\" mise en \u0153uvre. Dans la mesure du possible, il est pr\u00e9f\u00e9rable que les discussions de la r\u00e9vision soient ax\u00e9es sur les faits et les mesures. La majorit\u00e9 des soumissions donneront lieu \u00e0 un retour d'information. Soyez pr\u00eat \u00e0 obtenir un retour, \u00e0 fournir des d\u00e9tails suppl\u00e9mentaires et \u00e0 mettre \u00e0 jour la soumission si n\u00e9cessaire. Ce que le relecteur recherche le plus souvent : La soumission est-elle exempte de d\u00e9fauts et est-elle pr\u00eate \u00e0 \u00eatre d\u00e9ploy\u00e9e \u00e0 grande \u00e9chelle ?Les soumissionnaires sont cens\u00e9s tester leurs modifications avant de les soumettre. Les relecteurs recherchent les erreurs, mais ne testent pas, en g\u00e9n\u00e9ral, les soumissions. Une soumission accept\u00e9e est souvent d\u00e9ploy\u00e9e sur des milliers d'imprimantes dans les quelques semaines qui suivent son acceptation. La qualit\u00e9 des soumissions est donc consid\u00e9r\u00e9e comme une priorit\u00e9. Le d\u00e9p\u00f4t GitHub principal de Klipper3d/klipper n'accepte pas les travaux exp\u00e9rimentaux. Les auteurs doivent effectuer les exp\u00e9rimentations, le d\u00e9bogage et les tests dans leurs propres d\u00e9p\u00f4ts. Le serveur Klipper Discourse est un bon endroit pour faire conna\u00eetre les nouveaux travaux et trouver des utilisateurs d\u00e9sireux de fournir des commentaires concrets. Les soumissions doivent r\u00e9ussir tous les tests de r\u00e9gression . Lorsqu'ils corrigent un d\u00e9faut dans le code, les soumissionnaires doivent avoir une compr\u00e9hension g\u00e9n\u00e9rale de la cause fondamentale de ce d\u00e9faut, et la correction doit cibler cette seule cause fondamentale. Les soumissions de code ne doivent pas contenir de code de d\u00e9bogage excessif, d'options de d\u00e9bogage, ni d'enregistrement de d\u00e9bogage \u00e0 l'ex\u00e9cution. Les commentaires dans les soumissions de code doivent se concentrer sur l'am\u00e9lioration de la maintenance du code. Les soumissions ne doivent pas contenir de \"code comment\u00e9\" ni de commentaires excessifs d\u00e9crivant des impl\u00e9mentations pass\u00e9es. Il ne doit pas y avoir de commentaires excessifs de type \"todo\". Les mises \u00e0 jour de la documentation ne doivent pas indiquer qu'il s'agit d'un \"travail en cours\". La demande apporte-t-elle un avantage \"\u00e0 fort impact\" \u00e0 des utilisateurs du monde r\u00e9el effectuant des t\u00e2ches du monde r\u00e9el ?Les relecteurs doivent identifier, au moins dans leur propre esprit, \u00e0 peu pr\u00e8s \"qui est le public cible\", une \u00e9chelle approximative de \"la taille de ce public\", le \"b\u00e9n\u00e9fice\" qu'ils obtiendront, comment le \"b\u00e9n\u00e9fice est mesur\u00e9\", et les \"r\u00e9sultats de ces tests de mesure\". Dans la plupart des cas, ces \u00e9l\u00e9ments sont \u00e9vidents pour l'auteur et l'examinateur, et ne sont pas explicitement mentionn\u00e9s lors d'un examen. Les soumissions \u00e0 la branche principale de Klipper doivent avoir un public cible important. En r\u00e8gle g\u00e9n\u00e9rale, les soumissions doivent cibler une base d'au moins 100 utilisateurs du monde r\u00e9el. Si un relecteur demande des d\u00e9tails sur les \"avantages\" d'une proposition, ne consid\u00e9rez pas cela comme une critique. \u00catre capable de comprendre les avantages concrets d'un changement est une partie naturelle d'un examen. Lorsque l'on discute des avantages, il est pr\u00e9f\u00e9rable de parler de \"faits et de mesures\". En g\u00e9n\u00e9ral, les \u00e9valuateurs ne cherchent pas des r\u00e9ponses du type \"quelqu'un pourrait trouver l'option X utile\", ni des r\u00e9ponses du type \"cette soumission ajoute une fonctionnalit\u00e9 que le micrologiciel X met en \u0153uvre\". Au lieu de cela, il est g\u00e9n\u00e9ralement pr\u00e9f\u00e9rable de discuter des d\u00e9tails sur la fa\u00e7on dont l'am\u00e9lioration de la qualit\u00e9 a \u00e9t\u00e9 mesur\u00e9e et quels \u00e9taient les r\u00e9sultats de ces mesures - par exemple, \"les tests sur les imprimantes Acme X1000 montrent des coins am\u00e9lior\u00e9s comme on le voit sur l'image ...\", ou par exemple \"le temps d'impression de l'objet X du monde r\u00e9el sur une imprimante Foomatic X900 est pass\u00e9 de 4 heures \u00e0 3,5 heures\". Il est entendu que les tests de ce type peuvent prendre beaucoup de temps et d'efforts. Certaines des fonctionnalit\u00e9s les plus remarquables de Klipper ont n\u00e9cessit\u00e9 des mois de discussion, de re-travail, de tests et de documentation avant d'\u00eatre int\u00e9gr\u00e9es dans la branche principale. Tous les nouveaux modules, options de configuration, commandes, param\u00e8tres de commande et documents doivent avoir un \"impact \u00e9lev\u00e9\". Nous ne voulons pas imposer aux utilisateurs des options qu'ils ne peuvent raisonnablement pas configurer, ni des options qui n'apportent aucun avantage notable. Un relecteur peut demander des \u00e9claircissements sur la mani\u00e8re dont un utilisateur doit configurer une option - une r\u00e9ponse id\u00e9ale contiendra des d\u00e9tails sur le processus - par exemple, \"les utilisateurs du MegaX500 doivent r\u00e9gler l'option X sur 99,3 tandis que les utilisateurs du Elite100Y doivent calibrer l'option X en utilisant la proc\u00e9dure ...\". Si le but d'une option est de rendre le code plus modulaire, il est pr\u00e9f\u00e9rable d'utiliser des constantes de code plut\u00f4t que des options de configuration pour l'utilisateur. Les nouveaux modules, les nouvelles options et les nouveaux param\u00e8tres ne doivent pas offrir des fonctionnalit\u00e9s similaires \u00e0 celles des modules existants - si les diff\u00e9rences sont arbitraires, il est pr\u00e9f\u00e9rable d'utiliser le syst\u00e8me existant ou de remanier le code existant. Le droit d'auteur de la soumission est-il clair, non gracieux et compatible ?Les nouveaux fichiers C et Python doivent comporter une d\u00e9claration de copyright sans ambigu\u00eft\u00e9. Voir les fichiers existants pour le format pr\u00e9f\u00e9r\u00e9. Il est d\u00e9conseill\u00e9 de d\u00e9clarer un droit d'auteur sur un fichier existant lorsque l'on apporte des modifications mineures \u00e0 ce fichier. Le code provenant de sources tierces doit \u00eatre compatible avec la licence Klipper (GNU GPLv3). Les ajouts importants de code tiers doivent \u00eatre ajout\u00e9s au r\u00e9pertoire lib/ (et suivre le format d\u00e9crit dans lib/README ). Les soumissionnaires doivent fournir une ligne Signed-off-by en utilisant leur nom r\u00e9el complet. Elle indique que le soumissionnaire est d'accord avec le certificat d'origine du d\u00e9veloppeur . La soumission suit-elle les directives sp\u00e9cifi\u00e9es dans la documentation de Klipper ?En particulier, le code doit suivre les directives de et les fichiers de configuration doivent suivre les directives de . La documentation de Klipper est-elle mise \u00e0 jour pour refl\u00e9ter les nouveaux changements ?Au minimum, la documentation de r\u00e9f\u00e9rence doit \u00eatre mise \u00e0 jour avec les modifications correspondantes du code : Toutes les commandes et tous les param\u00e8tres de commande doivent \u00eatre document\u00e9s dans . Tous les modules destin\u00e9s aux utilisateurs et leurs param\u00e8tres de configuration doivent \u00eatre document\u00e9s dans . Toutes les \"variables d'\u00e9tat\" export\u00e9es doivent \u00eatre document\u00e9es dans . Tous les nouveaux \"webhooks\" et leurs param\u00e8tres doivent \u00eatre document\u00e9s dans . Toute modification qui apporte un changement non r\u00e9trocompatible \u00e0 une commande ou \u00e0 un param\u00e8tre du fichier de configuration doit \u00eatre document\u00e9e dans . Les nouveaux documents doivent \u00eatre ajout\u00e9s \u00e0 et \u00eatre ajout\u00e9s \u00e0 l'index du site web docs/_klipper3d/mkdocs.yml . Les commits sont-ils bien form\u00e9s, abordent-ils un seul sujet par commit, et sont-ils ind\u00e9pendants ?Les messages de validation doivent suivre le format pr\u00e9f\u00e9r\u00e9 . Les commits ne doivent pas avoir de conflit de fusion. Les nouveaux ajouts \u00e0 la branche ma\u00eetresse de Klipper sont toujours effectu\u00e9s via un \"rebase\" ou un \"squash and rebase\". Il n'est g\u00e9n\u00e9ralement pas n\u00e9cessaire pour les soumissionnaires de fusionner \u00e0 nouveau leur soumission \u00e0 chaque mise \u00e0 jour du d\u00e9p\u00f4t ma\u00eetre de Klipper. Cependant, s'il y a un conflit de fusion, il est recommand\u00e9 aux soumissionnaires d'utiliser git rebase pour r\u00e9soudre le conflit. Chaque validation doit porter sur un seul changement de haut niveau. Les changements importants doivent \u00eatre d\u00e9compos\u00e9s en plusieurs commits ind\u00e9pendants. Chaque livraison doit se suffire \u00e0 elle-m\u00eame pour que des outils comme git bisect et git revert fonctionnent de mani\u00e8re fiable. Les modifications des espaces blancs ne doivent pas \u00eatre m\u00e9lang\u00e9es avec les modifications fonctionnelles. En g\u00e9n\u00e9ral, les changements gratuits d'espace blanc ne sont pas accept\u00e9s, sauf s'ils proviennent du \"propri\u00e9taire\" \u00e9tabli du code en cours de modification. Klipper ne met pas en \u0153uvre un \"guide de style de codage\" strict, mais les modifications apport\u00e9es au code existant doivent respecter le flux de code de haut niveau, le style d'indentation du code et le format de ce code existant. Les soumissions de nouveaux modules et syst\u00e8mes b\u00e9n\u00e9ficient d'une plus grande souplesse en mati\u00e8re de style de codage, mais il est pr\u00e9f\u00e9rable que ce nouveau code suive un style coh\u00e9rent en interne et respecte g\u00e9n\u00e9ralement les normes de codage en vigueur dans le secteur. L'objectif d'une r\u00e9vision n'est pas de discuter de \"meilleures mises en \u0153uvre\". Cependant, si un relecteur a du mal \u00e0 comprendre l'impl\u00e9mentation d'une soumission, il peut demander des changements pour rendre l'impl\u00e9mentation plus transparente. En particulier, si les relecteurs ne peuvent pas se convaincre qu'une soumission est exempte de d\u00e9fauts, des changements peuvent \u00eatre n\u00e9cessaires. Dans le cadre d'une r\u00e9vision, un r\u00e9viseur peut cr\u00e9er une Pull Request alternative pour un sujet. Cela peut \u00eatre fait pour \u00e9viter un \"va-et-vient\" excessif sur des \u00e9l\u00e9ments de proc\u00e9dure mineurs et ainsi rationaliser le processus de soumission. Cela peut \u00e9galement \u00eatre fait parce que la discussion inspire un r\u00e9viseur \u00e0 construire une impl\u00e9mentation alternative. Ces deux situations sont le r\u00e9sultat normal d'une r\u00e9vision et ne doivent pas \u00eatre consid\u00e9r\u00e9es comme une critique de la soumission originale.","title":"A quoi s'attendre lors d'une r\u00e9vision"},{"location":"CONTRIBUTING.html#aider-a-la-revision","text":"Nous appr\u00e9cions l'aide pour les \u00e9valuations ! Il n'est pas n\u00e9cessaire d'\u00eatre un reviewer list\u00e9 pour effectuer une r\u00e9vision. Les auteurs de Pull Requests GitHub sont \u00e9galement encourag\u00e9s \u00e0 r\u00e9viser leurs propres soumissions. Pour faciliter la r\u00e9vision, suivez les \u00e9tapes d\u00e9crites dans \u00e0 quoi s'attendre lors d'une r\u00e9vision pour v\u00e9rifier la soumission. Une fois la r\u00e9vision termin\u00e9e, ajoutez un commentaire \u00e0 la Pull Request GitHub avec vos conclusions. Si la soumission passe la r\u00e9vision, veuillez l'indiquer explicitement dans le commentaire - par exemple quelque chose comme \"J'ai revu cette modification selon les \u00e9tapes du document CONTRIBUTING et tout me semble correct\". Si vous n'avez pas pu effectuer certaines \u00e9tapes de la r\u00e9vision, veuillez indiquer explicitement quelles \u00e9tapes ont \u00e9t\u00e9 r\u00e9vis\u00e9es et quelles \u00e9tapes ne l'ont pas \u00e9t\u00e9 - par exemple quelque chose comme \"Je n'ai pas v\u00e9rifi\u00e9 les d\u00e9fauts du code, mais j'ai revu tout le reste dans le document CONTRIBUTING et tout semble bon\". Nous appr\u00e9cions \u00e9galement les tests des soumissions. Si le code a \u00e9t\u00e9 test\u00e9, veuillez ajouter un commentaire \u00e0 la Pull Request GitHub avec les r\u00e9sultats de votre test - succ\u00e8s ou \u00e9chec. Veuillez indiquer explicitement que le code a \u00e9t\u00e9 test\u00e9 et les r\u00e9sultats - par exemple quelque chose comme \"J'ai test\u00e9 ce code sur mon imprimante Acme900Z avec une impression de vase et les r\u00e9sultats \u00e9taient bons\".","title":"Aider \u00e0 la r\u00e9vision"},{"location":"CONTRIBUTING.html#reviseurs","text":"Les \"r\u00e9viseurs\" de Klipper sont : Nom Id GitHub Domaines d'int\u00e9r\u00eat Dmitry Butyugin @dmbutyugin Input shaping, test de r\u00e9sonance, cin\u00e9matiques Eric Callahan @Arksine Nivellement du lit, flashage du MCU Kevin O'Connor @KevinOConnor Syst\u00e8me de mouvement de base, code du microcontr\u00f4leur Paul McGowan @mental405 Fichiers de configuration, documentation Veuillez ne pas envoyer de \"ping\" \u00e0 l'un des \u00e9valuateurs et ne pas leur adresser de soumissions. Tous les \u00e9valuateurs surveillent les forums et les PR, et prennent en charge les \u00e9valuations quand ils en ont le temps. Les \"mainteneurs\" de Klipper sont : Nom Nom GitHub Kevin O'Connor @KevinOConnor","title":"R\u00e9viseurs"},{"location":"CONTRIBUTING.html#format-des-messages-de-commit","text":"Chaque livraison doit avoir un message de livraison format\u00e9 de la mani\u00e8re suivante : module : R\u00e9sum\u00e9 en majuscules, court (50 caract\u00e8res ou moins) Texte explicatif plus d\u00e9taill\u00e9, si n\u00e9cessaire. Limitez-le \u00e0 environ 75 caract\u00e8res ou plus. Dans certains contextes, la premi\u00e8re ligne est consid\u00e9r\u00e9e comme l'objet d'un courriel et le reste du texte comme le corps. sujet d'un message \u00e9lectronique et le reste du texte comme le corps du message. La ligne vierge s\u00e9parant le r\u00e9sum\u00e9 du corps est essentielle (\u00e0 moins que vous n'omettiez enti\u00e8rement le corps). le corps enti\u00e8rement) ; des outils comme rebase peuvent \u00eatre confondus si vous ex\u00e9cutez les les deux ensemble. Les autres paragraphes viennent apr\u00e8s les lignes vides.. Sign\u00e9 par : Mon nom <myemail@example.org> Dans l'exemple ci-dessus, module doit \u00eatre le nom d'un fichier ou d'un r\u00e9pertoire dans le r\u00e9f\u00e9rentiel (sans extension de fichier). Par exemple, clocksync : Corriger une faute de frappe dans l'appel pause() au moment de la connexion . Le but de sp\u00e9cifier un nom de module dans le message de livraison est d'aider \u00e0 fournir un contexte pour les commentaires de livraison. Il est important d'avoir une ligne \"Signed-off-by\" sur chaque commit - elle certifie que vous acceptez le certificat d'origine du d\u00e9veloppeur . Cette ligne doit contenir votre vrai nom (d\u00e9sol\u00e9, pas de pseudonymes ou de contributions anonymes) et une adresse \u00e9lectronique valide.","title":"Format des messages de commit"},{"location":"CONTRIBUTING.html#contribuer-aux-traductions-de-klipper","text":"Projet de traduction de Klipper est le projet d\u00e9di\u00e9 \u00e0 la traduction de Klipper dans diff\u00e9rentes langues. Weblate h\u00e9berge toutes les cha\u00eenes Gettext pour la traduction et la r\u00e9vision. Les localisations peuvent \u00eatre affich\u00e9es sur klipper3d.org d\u00e8s lors qu'elles satisfont aux exigences suivantes : 75% Couverture totale Tous les titres (H1) sont traduits Une PR (Pull Request) hi\u00e9rarchis\u00e9e de navigation mise \u00e0 jour dans klipper-translations. Afin de r\u00e9duire la frustration li\u00e9e \u00e0 la traduction de termes sp\u00e9cifiques \u00e0 un domaine et de prendre connaissance des traductions en cours, vous pouvez soumettre une PR modifiant le Projet Klipper-translations readme.md . D\u00e8s qu'une traduction est pr\u00eate, la modification correspondante du projet Klipper peut \u00eatre effectu\u00e9e. Si une traduction existe d\u00e9j\u00e0 dans le r\u00e9f\u00e9rentiel Klipper et ne r\u00e9pond plus \u00e0 la liste de contr\u00f4le ci-dessus, elle sera marqu\u00e9e comme obsol\u00e8te apr\u00e8s un mois sans mise \u00e0 jour. Une fois que les conditions sont remplies, vous devez : mettre \u00e0 jour le fichier active_translations du d\u00e9p\u00f4t de klipper-tranlations Facultatif : ajouter un fichier manual-index.md dans le dossier docs\\locals\\<lang> du d\u00e9p\u00f4t klipper-translations pour remplacer l'index.md sp\u00e9cifique \u00e0 la langue (l'index.md g\u00e9n\u00e9r\u00e9 ne s'affiche pas correctement). Probl\u00e8mes connus : Actuellement, il n'existe pas de m\u00e9thode permettant de traduire correctement les images dans la documentation Il est impossible de traduire les titres dans mkdocs.yml.","title":"Contribuer aux traductions de Klipper"},{"location":"Code_Overview.html","text":"Aper\u00e7u du code \u00b6 Ce document d\u00e9crit la disposition g\u00e9n\u00e9rale du code et le flux de code principal de Klipper. Disposition du r\u00e9pertoire \u00b6 Le r\u00e9pertoire src/ contient les sources C du code du micro-contr\u00f4leur. Les r\u00e9pertoires src/atsam/ , src/atsamd/ , src/avr/ , src/linux/ , src/lpc176x/ , src/pru/ , et src/stm32/ contiennent le code du micro-contr\u00f4leur sp\u00e9cifique \u00e0 chaque architecture. Le r\u00e9pertoire src/simulator/ contient des \u00e9l\u00e9ments de remplacement de code permettant de tester la compilation du micro-contr\u00f4leur sur d'autres architectures. Le r\u00e9pertoire src/generic/ contient du code d'assistance utile sur diff\u00e9rentes architectures. La compilation fait en sorte que les inclusions de \"board/somefile.h\" soient d'abord recherch\u00e9es dans le r\u00e9pertoire de l'architecture courante (par exemple, src/avr/somefile.h) et ensuite dans le r\u00e9pertoire g\u00e9n\u00e9rique (par exemple, src/generic/somefile.h). Le r\u00e9pertoire klippy/ contient le logiciel h\u00f4te. La majorit\u00e9 du logiciel h\u00f4te est \u00e9crit en Python, cependant le r\u00e9pertoire klippy/chelper/ contient quelques assistants en code C. Le r\u00e9pertoire klippy/kinematics/ contient le code li\u00e9 \u00e0 la cin\u00e9matique du robot. Le r\u00e9pertoire klippy/extras/ contient les \"modules\" extensibles du code h\u00f4te. Le r\u00e9pertoire lib/ contient du code de biblioth\u00e8que externe de tierce partie n\u00e9cessaire \u00e0 la construction de certaines cibles. Le r\u00e9pertoire config/ contient des exemples de fichiers de configuration d'imprimante. Le r\u00e9pertoire scripts/ contient des scripts de construction utiles \u00e0 la compilation du code du micro-contr\u00f4leur. Le r\u00e9pertoire test/ contient des cas de tests automatis\u00e9s. Pendant la compilation, le constructeur peut cr\u00e9er un r\u00e9pertoire out/ . Celui-ci contient des objets temporaires de compilation. L'objet micro-contr\u00f4leur final qui est construit est out/klipper.elf.hex sur AVR et out/klipper.bin sur ARM. Flux de code du micro-contr\u00f4leur \u00b6 L'ex\u00e9cution du code du microcontr\u00f4leur d\u00e9bute dans le code sp\u00e9cifique \u00e0 l'architecture (par exemple, src/avr/main.c ) qui appelle finalement sched_main() situ\u00e9 dans src/sched.c . Le code sched_main() commence par ex\u00e9cuter toutes les fonctions marqu\u00e9es avec la macro DECL_INIT(). Il ex\u00e9cute ensuite de mani\u00e8re r\u00e9p\u00e9t\u00e9e toutes les fonctions marqu\u00e9es par la macro DECL_TASK(). L'une des principales fonctions de la t\u00e2che est command_dispatch() situ\u00e9e dans src/command.c . Cette fonction est appel\u00e9e \u00e0 partir du code d'entr\u00e9e/sortie sp\u00e9cifique \u00e0 la carte (par exemple, src/avr/serial.c , src/generic/serial_irq.c ) et elle ex\u00e9cute les fonctions de commande associ\u00e9es aux commandes trouv\u00e9es dans le flux d'entr\u00e9e. Les fonctions de commande sont d\u00e9clar\u00e9es \u00e0 l'aide de la macro DECL_COMMAND() (voir le document protocole pour plus d'informations). Les fonctions de t\u00e2che, d'initialisation et de commande s'ex\u00e9cutent toujours avec les interruptions activ\u00e9es (toutefois, elles peuvent d\u00e9sactiver temporairement les interruptions si n\u00e9cessaire). Ces fonctions doivent \u00e9viter les longues pauses, les retards, ou effectuer un travail qui dure un temps significatif. (Les longs retards de ces fonctions \"t\u00e2ches\" entra\u00eenent une gigue de programmation pour d'autres \"t\u00e2ches\" - les retards de plus de 100us peuvent devenir perceptibles, les retards de plus de 500us peuvent entra\u00eener des retransmissions de commandes, les retards de plus de 100ms peuvent entra\u00eener des red\u00e9marrages du chien de garde). Ces fonctions planifient le travail \u00e0 des moments pr\u00e9cis en programmant des minuteries. Les fonctions de temporisation sont programm\u00e9es en appelant sched_add_timer() (situ\u00e9 dans src/sched.c ). Le code du planificateur s'arrangera pour que la fonction donn\u00e9e soit appel\u00e9e au moment demand\u00e9. Les interruptions de temporisation sont initialement trait\u00e9es dans un gestionnaire d'interruption sp\u00e9cifique \u00e0 l'architecture (par exemple, src/avr/timer.c ) qui appelle sched_timer_dispatch() situ\u00e9 dans src/sched.c . L'interruption de la temporisation entra\u00eene l'ex\u00e9cution des fonctions de temporisation planifi\u00e9es. Les fonctions de temporisation sont toujours ex\u00e9cut\u00e9es avec des interruptions d\u00e9sactiv\u00e9es. Les fonctions de temporisation devraient toujours se terminer en quelques microsecondes. \u00c0 la fin de l'\u00e9v\u00e9nement de temporisation, la fonction peut choisir de se reprogrammer. En cas de d\u00e9tection d'erreur, le code peut invoquer shutdown() (une macro qui appelle sched_shutdown() situ\u00e9e dans src/sched.c ). L'appel \u00e0 shutdown() entra\u00eene l'ex\u00e9cution de toutes les fonctions marqu\u00e9es par la macro DECL_SHUTDOWN(). Les fonctions d'arr\u00eat s'ex\u00e9cutent toujours avec des interruptions d\u00e9sactiv\u00e9es. Une grande partie des fonctionnalit\u00e9s du micro-contr\u00f4leur implique de travailler avec des broches d'entr\u00e9e/sortie \u00e0 usage g\u00e9n\u00e9ral (GPIO). Afin de s\u00e9parer le code de bas niveau sp\u00e9cifique \u00e0 l'architecture du code de haut niveau de la t\u00e2che, tous les \u00e9v\u00e9nements GPIO sont impl\u00e9ment\u00e9s dans des emballages sp\u00e9cifiques \u00e0 l'architecture (par exemple, src/avr/gpio.c ). Le code est compil\u00e9 avec l'optimisation \"-flto -fwhole-program\" de gcc qui fait un excellent travail d'int\u00e9gration des fonctions \u00e0 travers les unit\u00e9s de compilation, ainsi la plupart de ces minuscules fonctions gpio sont int\u00e9gr\u00e9es \u00e0 leurs appelants, et il n'y a aucun co\u00fbt d'ex\u00e9cution \u00e0 les utiliser. Aper\u00e7u du code Klippy \u00b6 Le code h\u00f4te (Klippy) est destin\u00e9 \u00e0 fonctionner sur un ordinateur \u00e0 petit prix (tel qu'un Raspberry Pi) associ\u00e9 au microcontr\u00f4leur. Le code est principalement \u00e9crit en Python, cependant il utilise CFFI pour impl\u00e9menter certaines fonctionnalit\u00e9s en code C. L'ex\u00e9cution initiale commence dans klippy/klippy.py . Ceci lit les arguments de la ligne de commande, ouvre le fichier de configuration de l'imprimante, instancie les principaux objets de l'imprimante et lance la connexion s\u00e9rie. L'ex\u00e9cution principale des commandes G-code se fait dans la m\u00e9thode process_commands() de klippy/gcode.py . Ce code traduit les commandes G-code en appels d'objets d'imprimante fr\u00e9quemment traduis en commandes d'actions \u00e0 ex\u00e9cuter sur le micro-contr\u00f4leur (tel que d\u00e9clar\u00e9 via la macro DECL_COMMAND dans le code du micro-contr\u00f4leur). Il y a quatre threads dans le code h\u00f4te de Klippy. Le thread principal g\u00e8re les commandes gcode entrantes. Un deuxi\u00e8me thread (r\u00e9sidant enti\u00e8rement dans le code C klippy/chelper/serialqueue.c ) g\u00e8re les entr\u00e9es/sorties de bas niveau avec le port s\u00e9rie. Le troisi\u00e8me thread est utilis\u00e9 pour traiter les messages de r\u00e9ponse du micro-contr\u00f4leur dans le code Python (voir klippy/serialhdl.py ). Le quatri\u00e8me thread \u00e9crit les messages de d\u00e9bogage dans le journal (voir klippy/queuelogger.py ) afin que les autres threads ne bloquent jamais les \u00e9critures dans le journal. Flux du code d'une commande de d\u00e9placement \u00b6 Un mouvement typique de l'imprimante commence lorsqu'une commande \"G1\" est envoy\u00e9e \u00e0 l'h\u00f4te Klippy et se termine lorsque les impulsions de pas correspondantes sont produites sur le micro-contr\u00f4leur. Cette section d\u00e9crit le flux du code d'une commande de d\u00e9placement typique. Le document cin\u00e9matiques fournit des informations suppl\u00e9mentaires sur la m\u00e9canique des mouvements. Le traitement d'une commande de d\u00e9placement commence dans gcode.py. Le but de gcode.py est de traduire le G-code en appels internes. Une commande G1 invoquera cmd_G1() dans klippy/extras/gcode_move.py. Le code gcode_move.py g\u00e8re les changements d'origine (par exemple, G92), les changements de positions relatives et absolues (par exemple, G90), et les changements d'unit\u00e9s (par exemple, F6000=100mm/s). Le chemin du code pour un d\u00e9placement est : _process_data() -> _process_commands() -> cmd_G1() . Finalement, la classe ToolHead est invoqu\u00e9e pour ex\u00e9cuter la demande r\u00e9elle : cmd_G1() -> ToolHead.move() La classe ToolHead (dans toolhead.py) g\u00e8re le \"look-ahead\" et suit la temporisation des actions d'impression. Le chemin du code principal pour un d\u00e9placement est : ToolHead.move() -> MoveQueue.add_move() -> MoveQueue.flush() -> Move.set_junction() -> ToolHead._process_moves() . ToolHead.move() cr\u00e9e un objet Move() avec les param\u00e8tres du d\u00e9placement (dans l'espace cart\u00e9sien et en unit\u00e9s de secondes et de millim\u00e8tres). La classe cin\u00e9matique a la possibilit\u00e9 de v\u00e9rifier chaque mouvement ( ToolHead.move() -> kin.check_move() ). Les classes cin\u00e9matiques sont situ\u00e9es dans le r\u00e9pertoire klippy/kinematics/. Le code check_move() peut lever une erreur si le d\u00e9placement n'est pas valide. Si check_move() se termine avec succ\u00e8s, alors la cin\u00e9matique sous-jacente doit \u00eatre capable de g\u00e9rer le d\u00e9placement. MoveQueue.add_move() place l'objet move dans la file d'attente \"look-ahead\". MoveQueue.flush() d\u00e9termine les vitesses de d\u00e9but et de fin de chaque mouvement. Move.set_junction() impl\u00e9mente le \"g\u00e9n\u00e9rateur de trap\u00e8ze\" sur un mouvement. Le \"g\u00e9n\u00e9rateur de trap\u00e8ze\" divise chaque mouvement en trois parties : une phase d'acc\u00e9l\u00e9ration constante, suivie d'une phase de vitesse constante, puis d'une phase de d\u00e9c\u00e9l\u00e9ration constante. Chaque d\u00e9placement contient ces trois phases dans cet ordre, certaines phases pouvant \u00eatre de dur\u00e9e nulle. Lorsque ToolHead._process_moves() est appel\u00e9, tout ce qui concerne le d\u00e9placement est connu : sa position de d\u00e9part, sa position d'arriv\u00e9e, son acc\u00e9l\u00e9ration, sa vitesse de d\u00e9part/de croisi\u00e8re/de fin, et la distance parcourue pendant l'acc\u00e9l\u00e9ration/la croisi\u00e8re/la d\u00e9c\u00e9l\u00e9ration. Toutes ces informations sont stock\u00e9es dans la classe Move() et sont dans l'espace cart\u00e9sien en unit\u00e9s de millim\u00e8tres et de secondes. Klipper utilise un solveur it\u00e9ratif afin de g\u00e9n\u00e9rer les d\u00e9lais des pas pour chaque moteur pas \u00e0 pas. Pour des raisons d'efficacit\u00e9, les d\u00e9lais d'impulsion des pas sont g\u00e9n\u00e9r\u00e9s en code C. Les mouvements sont d'abord plac\u00e9s dans une \"file d'attente de mouvements trap\u00e9zo\u00efdaux\" : ToolHead._process_moves() -> trapq_append() (dans klippy/chelper/trapq.c). Les d\u00e9lais de pas sont ensuite g\u00e9n\u00e9r\u00e9s : ToolHead._process_moves() -> ToolHead._update_move_time() -> MCU_Stepper.generate_steps() -> itersolve_generate_steps() -> itersolve_gen_steps_range() (dans klippy/chelper/itersolve.c). Le but du solveur it\u00e9ratif est de trouver les d\u00e9lais de pas \u00e0 partir d'une fonction calculant la position du moteur \u00e0 partir du temps. Ceci est fait en \"devinant\" de mani\u00e8re r\u00e9p\u00e9t\u00e9e plusieurs d\u00e9lais jusqu'\u00e0 ce que la formule de position du pas renvoie la position d\u00e9sir\u00e9e du pas suivant sur le moteur. Le retour d'information produit par chaque estimation est utilis\u00e9 afin d'am\u00e9liorer les estimations futures, de sorte que le processus converge rapidement vers le d\u00e9lai souhait\u00e9. Les formules de position cin\u00e9matique du moteur sont situ\u00e9es dans le r\u00e9pertoire klippy/chelper/ (par exemple, kin_cart.c, kin_corexy.c, kin_delta.c, kin_extruder.c). Notez que l'extrudeuse est g\u00e9r\u00e9e dans sa propre classe cin\u00e9matique : ToolHead._process_moves() -> PrinterExtruder.move() . Puisque la classe Move() sp\u00e9cifie le d\u00e9lai exact du mouvement et que les impulsions de pas sont envoy\u00e9es au micro-contr\u00f4leur avec un timing sp\u00e9cifique, les mouvements du moteur produits par la classe de l'extrudeuse seront synchronis\u00e9s avec le mouvement de la t\u00eate m\u00eame si le code est s\u00e9par\u00e9. Apr\u00e8s que le solveur it\u00e9ratif ait calcul\u00e9 les d\u00e9lais de pas, ils sont ajout\u00e9s \u00e0 un tableau : itersolve_gen_steps_range() -> stepcompress_append() (dans klippy/chelper/stepcompress.c). Le tableau (struct stepcompress.queue) stocke les dur\u00e9es correspondantes du compteur d'horloge du micro-contr\u00f4leur pour chaque \u00e9tape. Ici, la valeur du \"compteur d'horloge du micro-contr\u00f4leur\" correspond directement au compteur mat\u00e9riel du micro-contr\u00f4leur - elle est relative \u00e0 la derni\u00e8re mise sous tension du micro-contr\u00f4leur. La prochaine \u00e9tape majeure est de compresser les \u00e9tapes : stepcompress_flush() -> compress_bisect_add() (dans klippy/chelper/stepcompress.c). Ce code g\u00e9n\u00e8re et encode une s\u00e9rie de commandes \"queue_step\" du micro-contr\u00f4leur correspondant \u00e0 la liste des dur\u00e9es de pas du moteur construite \u00e0 l'\u00e9tape pr\u00e9c\u00e9dente. Ces commandes \"queue_step\" sont ensuite mises en file d'attente, hi\u00e9rarchis\u00e9es et envoy\u00e9es au micro-contr\u00f4leur (via stepcompress.c:steppersync et serialqueue.c:serialqueue). Le traitement des commandes queue_step sur le micro-contr\u00f4leur commence dans src/command.c qui analyse la commande et appelle command_queue_step() . Le code command_queue_step() (dans src/stepper.c) ajoute simplement les param\u00e8tres de chaque commande queue_step \u00e0 une file d'attente par moteur. En fonctionnement normal, la commande queue_step est analys\u00e9e et mise en file d'attente au moins 100ms avant le moment de son premier pas. Enfin, la g\u00e9n\u00e9ration des \u00e9v\u00e9nements de pas du moteur est faite dans stepper_event() . Elle est appel\u00e9e depuis l'interruption du compteur mat\u00e9riel \u00e0 l'heure pr\u00e9vue du premier pas. Le code stepper_event() g\u00e9n\u00e8re une impulsion de pas et se reprogramme ensuite pour s'ex\u00e9cuter au moment de l'impulsion de pas suivante pour les param\u00e8tres queue_step donn\u00e9s. Les param\u00e8tres pour chaque commande queue_step sont \"interval\", \"count\", et \"add\". A un haut niveau, stepper_event() ex\u00e9cute la commande suivante, 'count' fois : do_step() ; next_wake_time = last_wake_time + interval ; interval += add; Ce qui pr\u00e9c\u00e8de peut sembler beaucoup de complexit\u00e9 pour l'ex\u00e9cution d'un mouvement. Cependant, les seules parties vraiment int\u00e9ressantes se trouvent dans les classes ToolHead et kinematic. C'est cette partie du code qui pr\u00e9cise les mouvements et leurs dur\u00e9es. Les autres parties du traitement sont essentiellement de la communication et de la plomberie. Ajout d'un module h\u00f4te \u00b6 Le code h\u00f4te de Klippy a une capacit\u00e9 de chargement dynamique de modules. Si une section de configuration nomm\u00e9e \"[mon_module]\" est trouv\u00e9e dans le fichier de configuration de l'imprimante, le logiciel tentera automatiquement de charger le module python klippy/extras/mon_module.py . Ce syst\u00e8me de modules est la m\u00e9thode pr\u00e9f\u00e9r\u00e9e pour ajouter de nouvelles fonctionnalit\u00e9s \u00e0 Klipper. La fa\u00e7on la plus simple d'ajouter un nouveau module est d'utiliser un module existant comme r\u00e9f\u00e9rence - voir klippy/extras/servo.py comme exemple. Les \u00e9l\u00e9ments suivants peuvent \u00e9galement \u00eatre utiles : L'ex\u00e9cution du module commence dans la fonction load_config() au niveau du module (pour les sections de configuration de la forme [mon_module]) ou dans load_config_prefix() (pour les sections de configuration de la forme [mon_module mon_nom]). On passe \u00e0 cette fonction un objet \"config\" et elle doit retourner un nouvel \"objet imprimante\" associ\u00e9 \u00e0 la section de configuration donn\u00e9e. Durant le processus d'instanciation d'un nouvel objet imprimante, l'objet config peut \u00eatre utilis\u00e9 pour lire les param\u00e8tres de la section config donn\u00e9e. Ceci est fait en utilisant les m\u00e9thodes config.get() , config.getfloat() , config.getint() , etc. Assurez-vous de lire toutes les valeurs de la configuration pendant la construction de l'objet imprimante - si l'utilisateur sp\u00e9cifie un param\u00e8tre de configuration qui n'est pas lu pendant cette phase, il sera suppos\u00e9 qu'il s'agit d'une faute de frappe dans la configuration et une erreur sera lev\u00e9e. Utilisez la m\u00e9thode config.get_printer() pour obtenir une r\u00e9f\u00e9rence \u00e0 la classe principale \"printer\". Cette classe \"printer\" stocke les r\u00e9f\u00e9rences de tous les \"objets imprimante\" instanci\u00e9s. Utilisez la m\u00e9thode printer.lookup_object() pour trouver des r\u00e9f\u00e9rences \u00e0 d'autres objets imprimante. Presque toutes les fonctionnalit\u00e9s (m\u00eame les modules cin\u00e9matiques de base) sont encapsul\u00e9es dans un de ces objets imprimante. Notez, cependant, que lorsqu'un nouveau module est instanci\u00e9, tous les autres objets d'impression n'auront pas encore \u00e9t\u00e9 instanci\u00e9s. Les modules \"gcode\" et \"pins\" seront toujours disponibles, mais pour les autres modules, il est pr\u00e9f\u00e9rable de diff\u00e9rer la recherche. Enregistrez les gestionnaires d'\u00e9v\u00e9nements en utilisant la m\u00e9thode printer.register_event_handler() si le code doit \u00eatre appel\u00e9 lors d'\"\u00e9v\u00e9nements\" d\u00e9clench\u00e9s par d'autres objets imprimante. Chaque nom d'\u00e9v\u00e9nement est une cha\u00eene de caract\u00e8res, et par convention, c'est le nom du module source principal d\u00e9clenchant l'\u00e9v\u00e9nement avec un nom court pour l'action produite (par exemple, \"klippy:connect\"). Les param\u00e8tres pass\u00e9s \u00e0 chaque gestionnaire d'\u00e9v\u00e9nement sont sp\u00e9cifiques \u00e0 l'\u00e9v\u00e9nement en question (tout comme le traitement des exceptions et le contexte d'ex\u00e9cution). Deux \u00e9v\u00e9nements de d\u00e9marrage courants sont : klippy:connect - Cet \u00e9v\u00e9nement est g\u00e9n\u00e9r\u00e9 apr\u00e8s l'instanciation de tous les objets imprimante. Il est couramment utilis\u00e9 pour rechercher d'autres objets imprimante, pour v\u00e9rifier les param\u00e8tres de configuration et pour effectuer une premi\u00e8re \"prise de contact\" avec le mat\u00e9riel de l'imprimante. klippy:ready - Cet \u00e9v\u00e9nement est g\u00e9n\u00e9r\u00e9 apr\u00e8s que tous les gestionnaires de connexion se soient termin\u00e9s avec succ\u00e8s. Il indique que l'imprimante est en train de passer \u00e0 l'\u00e9tat pr\u00eat \u00e0 g\u00e9rer les op\u00e9rations normales. Ne d\u00e9clenchez pas d'erreur dans ce rappel. S'il y a une erreur dans la configuration de l'utilisateur, assurez-vous de la signaler pendant les phases load_config() ou \"connect event\". Utilisez soit raise config.error(\"mon erreur\") soit raise printer.config_error(\"mon erreur\") pour signaler l'erreur. Utilisez le module \"pins\" pour configurer une broche sur un micro-contr\u00f4leur. Ceci est typiquement fait avec quelque chose de similaire \u00e0 printer.lookup_object(\"pins\").setup_pin(\"pwm\", config.get(\"my_pin\")) . L'objet retourn\u00e9 peut alors \u00eatre command\u00e9 au moment de l'ex\u00e9cution. Si l'objet imprimante d\u00e9finit une m\u00e9thode get_status() , le module peut exporter des informations d'\u00e9tat via des macros et via le serveur API . La m\u00e9thode get_status() doit retourner un dictionnaire Python dont les cl\u00e9s sont des cha\u00eenes de caract\u00e8res et les valeurs des entiers, des flottants, des cha\u00eenes de caract\u00e8res, des listes, des dictionnaires, True, False ou None. Les tuples (et les tuples nomm\u00e9s) peuvent \u00e9galement \u00eatre utilis\u00e9s (ils apparaissent comme des listes lorsqu'on y acc\u00e8de via le serveur API). Les listes et les dictionnaires export\u00e9s doivent \u00eatre trait\u00e9s comme \"immuables\" - si leur contenu change, un nouvel objet doit \u00eatre renvoy\u00e9 par get_status() , sinon le serveur API ne d\u00e9tectera pas ces changements. Si le module doit acc\u00e9der \u00e0 la temporisation du syst\u00e8me ou \u00e0 des descripteurs de fichiers externes, utilisez printer.get_reactor() pour obtenir l'acc\u00e8s \u00e0 la classe globale \"event reactor\". Cette classe de r\u00e9acteur permet de programmer des temporisations, d'attendre des entr\u00e9es sur des descripteurs de fichiers, et d'\"endormir\" le code h\u00f4te. N'utilisez pas de variables globales. Tous les \u00e9tats doivent \u00eatre stock\u00e9s dans l'objet imprimante renvoy\u00e9 par la fonction load_config() . Ceci est important car sinon la commande RESTART pourrait ne pas fonctionner comme pr\u00e9vu. De m\u00eame, pour des raisons similaires, si des fichiers externes (ou des sockets) sont ouverts, assurez-vous d'enregistrer un gestionnaire d'\u00e9v\u00e9nement \"klippy:disconnect\" et de les fermer \u00e0 partir de ce rappel. \u00c9vitez d'acc\u00e9der aux variables membres internes (ou d'appeler les m\u00e9thodes commen\u00e7ant par un trait de soulignement) d'autres objets imprimante. Le respect de cette convention facilite la gestion des modifications futures. Il est recommand\u00e9 d'attribuer une valeur \u00e0 toutes les variables membres dans le constructeur Python des classes Python. (Et donc d'\u00e9viter d'utiliser la capacit\u00e9 de Python \u00e0 cr\u00e9er dynamiquement de nouvelles variables membres.) Si une variable Python doit stocker une valeur en virgule flottante, il est recommand\u00e9 de toujours affecter et manipuler cette variable avec des constantes en virgule flottante (et de ne jamais utiliser de constantes enti\u00e8res). Par exemple, pr\u00e9f\u00e9rez self.speed = 1. \u00e0 self.speed = 1 , et pr\u00e9f\u00e9rez self.speed = 2. * x plut\u00f4t que self.speed = 2 * x . L'utilisation coh\u00e9rente des valeurs \u00e0 virgule flottante peut \u00e9viter des bizarreries difficiles \u00e0 d\u00e9boguer dans les conversions de types Python. Si vous soumettez le module pour qu'il soit inclus dans le code principal de Klipper, veillez \u00e0 placer un avis de copyright en haut du module. Consultez les modules existants pour conna\u00eetre le format pr\u00e9f\u00e9r\u00e9. Ajout de nouvelles cin\u00e9matiques \u00b6 Cette section fournit quelques conseils pour ajouter le support \u00e0 Klipper de types suppl\u00e9mentaires de cin\u00e9matiques d'imprimante. Ce type d'activit\u00e9 n\u00e9cessite une excellente compr\u00e9hension des formules math\u00e9matiques de la cin\u00e9matique cible. Elle requiert \u00e9galement des comp\u00e9tences en mati\u00e8re de d\u00e9veloppement de logiciels, m\u00eame s'il suffit de mettre \u00e0 jour le logiciel h\u00f4te. Les \u00e9tapes utiles : Commencez par \u00e9tudier la section \" code de flux d'un mouvement \" et le document cin\u00e9matiques . Passez en revue les classes cin\u00e9matiques existantes dans le r\u00e9pertoire klippy/kinematics/. Les classes cin\u00e9matiques sont charg\u00e9es de convertir le mouvement en coordonn\u00e9es cart\u00e9siennes en un mouvement sur chaque moteur. On devrait \u00eatre capable de copier un de ces fichiers comme point de d\u00e9part. Impl\u00e9mentez les fonctions de position cin\u00e9matique du moteur en C pour chaque moteur si elles ne sont pas d\u00e9j\u00e0 disponibles (voir kin_cart.c, kin_corexy.c, et kin_delta.c dans klippy/chelper/). La fonction doit appeler move_get_coord() pour convertir une dur\u00e9e de d\u00e9placement donn\u00e9e (en secondes) en coordonn\u00e9es cart\u00e9siennes (en millim\u00e8tres), et ensuite calculer la position souhait\u00e9e du moteur (en millim\u00e8tres) \u00e0 partir de ces coordonn\u00e9es cart\u00e9siennes. Impl\u00e9mentez la m\u00e9thode calc_position() dans la nouvelle classe cin\u00e9matique. Cette m\u00e9thode calcule la position de la t\u00eate de l'outil en coordonn\u00e9es cart\u00e9siennes \u00e0 partir de la position de chaque moteur. Elle n'a pas besoin d'\u00eatre efficace car elle n'est typiquement appel\u00e9e que pendant les op\u00e9rations de mise \u00e0 l'origine et de palpage. Autres m\u00e9thodes. Impl\u00e9mentez les m\u00e9thodes check_move() , get_status() , get_steppers() , home() , et set_position() . Ces fonctions sont typiquement utilis\u00e9es pour fournir des v\u00e9rifications sp\u00e9cifiques \u00e0 la cin\u00e9matique. Cependant, au d\u00e9but du d\u00e9veloppement, on peut utiliser du code passe-partout ici. Impl\u00e9menter des cas de test. Cr\u00e9ez un fichier g-code avec une s\u00e9rie de mouvements pouvant tester des cas importants pour la cin\u00e9matique donn\u00e9e. Suivez la documentation de d\u00e9bogage pour convertir ce fichier g-code en commandes de micro-contr\u00f4leur. Ceci est utile pour tester les cas extr\u00eames et v\u00e9rifier les r\u00e9gressions. Portage sur un nouveau microcontr\u00f4leur \u00b6 Cette section fournit quelques conseils sur le portage du code du microcontr\u00f4leur de Klipper vers une nouvelle architecture. Ce type d'activit\u00e9 n\u00e9cessite une bonne connaissance du d\u00e9veloppement embarqu\u00e9 et un acc\u00e8s pratique au microcontr\u00f4leur cible. Les \u00e9tapes utiles : Commencez par identifier toutes les biblioth\u00e8ques tierces qui seront utilis\u00e9es pendant le portage. Les exemples courants incluent les wrappers \"CMSIS\" et les biblioth\u00e8ques \"HAL\" des fabricants. Tout code tiers doit \u00eatre compatible avec la licence GNU GPLv3. Le code tiers doit \u00eatre livr\u00e9 dans le r\u00e9pertoire Klipper lib/. Mettez \u00e0 jour le fichier lib/README en indiquant o\u00f9 et quand la biblioth\u00e8que a \u00e9t\u00e9 obtenue. Il est pr\u00e9f\u00e9rable de copier le code dans le d\u00e9p\u00f4t Klipper sans modification, mais si des modifications sont n\u00e9cessaires, elles doivent \u00eatre indiqu\u00e9es explicitement dans le fichier lib/README. Cr\u00e9er un nouveau sous-r\u00e9pertoire d'architecture dans le r\u00e9pertoire src/ et ajouter le support initial de Kconfig et Makefile. Utilisez les architectures existantes comme guide. Le simulateur src/simulator fournit un exemple de base pour un point de d\u00e9part minimal. La premi\u00e8re t\u00e2che principale de codage est d'apporter le support de communication \u00e0 la carte cible. C'est l'\u00e9tape la plus difficile dans un nouveau portage. Une fois que la communication de base fonctionne, les autres \u00e9tapes ont tendance \u00e0 \u00eatre beaucoup plus faciles. Il est typique d'utiliser un dispositif s\u00e9rie de type UART pendant le d\u00e9veloppement initial car ces types de dispositifs mat\u00e9riels sont g\u00e9n\u00e9ralement plus faciles \u00e0 activer et \u00e0 contr\u00f4ler. Pendant cette phase, faites un usage lib\u00e9ral du code d'aide du r\u00e9pertoire src/generic/ (v\u00e9rifiez comment src/simulator/Makefile inclut le code C g\u00e9n\u00e9rique dans la compilation). Il est \u00e9galement n\u00e9cessaire de d\u00e9finir timer_read_time() (qui renvoie l'horloge syst\u00e8me actuelle) dans cette phase, mais il n'est pas n\u00e9cessaire de supporter compl\u00e8tement la gestion des irq des timers. Familiarisez-vous avec l'outil console.py (comme d\u00e9crit dans le document de d\u00e9bogage ) et v\u00e9rifiez la connectivit\u00e9 au microcontr\u00f4leur avec cet outil. Cet outil traduit le protocole de communication de bas niveau du microcontr\u00f4leur en une forme lisible par l'homme. Ajouter le support pour la distribution des timers \u00e0 partir des interruptions mat\u00e9rielles. Voir Klipper commit 970831ee comme exemple des \u00e9tapes 1-5 r\u00e9alis\u00e9es pour l'architecture LPC176x. Apporter le support de base des entr\u00e9es et sorties GPIO. Voir Klipper commit c78b9076 comme exemple. Faire appara\u00eetre des p\u00e9riph\u00e9riques suppl\u00e9mentaires - par exemple, voir Klipper commit 65613aed , c812a40a , et c381d03a . Cr\u00e9ez un exemple de fichier de configuration Klipper dans le r\u00e9pertoire config/. Testez le micro-contr\u00f4leur avec le programme principal klippy.py. Pensez \u00e0 ajouter des cas de test de construction dans le r\u00e9pertoire test/. Conseils suppl\u00e9mentaires pour le codage : \u00c9vitez d'utiliser des \"champs de bits C\" pour acc\u00e9der aux registres d'E/S ; pr\u00e9f\u00e9rez les op\u00e9rations directes de lecture et d'\u00e9criture d'entiers de 32, 16 ou 8 bits. Les sp\u00e9cifications du langage C ne pr\u00e9cisent pas clairement comment le compilateur doit impl\u00e9menter les champs de bits C (par exemple, l'endianness et la disposition des bits), et il est difficile de d\u00e9terminer quelles op\u00e9rations d'E/S se produiront lors de la lecture ou de l'\u00e9criture d'un champ de bits C. Pr\u00e9f\u00e9rez l'\u00e9criture de valeurs explicites dans les registres d'E/S \u00e0 l'utilisation d'op\u00e9rations de lecture-modification-\u00e9criture. Autrement dit, si l'on met \u00e0 jour un champ dans un registre d'E/S dont les autres champs ont des valeurs connues, il est pr\u00e9f\u00e9rable d'\u00e9crire explicitement le contenu complet du registre. Les \u00e9critures explicites produisent un code plus petit, plus rapide et plus facile \u00e0 d\u00e9boguer. Les syst\u00e8mes de coordonn\u00e9es \u00b6 En interne, Klipper suit principalement la position de la t\u00eate de l'outil en coordonn\u00e9es cart\u00e9siennes relatives au syst\u00e8me de coordonn\u00e9es sp\u00e9cifi\u00e9 dans le fichier de configuration. C'est-\u00e0-dire que la plupart du code de Klipper ne conna\u00eetra jamais de changement de syst\u00e8me de coordonn\u00e9es. Si l'utilisateur fait une demande pour changer l'origine (par exemple, une commande G92 ) alors cet effet est obtenu en traduisant les commandes futures vers le syst\u00e8me de coordonn\u00e9es primaires. Cependant, dans certains cas, il est utile d'obtenir la position de la t\u00eate de l'outil dans un autre syst\u00e8me de coordonn\u00e9es et Klipper dispose de plusieurs outils pour faciliter cela. Vous pouvez le constater en ex\u00e9cutant la commande GET_POSITION. Par exemple : Send: GET_POSITION Recv: // mcu: stepper_a:-2060 stepper_b:-1169 stepper_c:-1613 Recv: // stepper: stepper_a:457.254159 stepper_b:466.085669 stepper_c:465.382132 Recv: // kinematic: X:8.339144 Y:-3.131558 Z:233.347121 Recv: // toolhead: X:8.338078 Y:-3.123175 Z:233.347878 E:0.000000 Recv: // gcode: X:8.338078 Y:-3.123175 Z:233.347878 E:0.000000 Recv: // gcode base: X:0.000000 Y:0.000000 Z:0.000000 E:0.000000 Recv: // gcode homing: X:0.000000 Y:0.000000 Z:0.000000 La position \"mcu\" ( stepper.get_mcu_position() dans le code) est le nombre total de pas que le micro-contr\u00f4leur a \u00e9mis dans un sens positif moins le nombre de pas \u00e9mis dans un sens n\u00e9gatif depuis la derni\u00e8re r\u00e9initialisation du micro-contr\u00f4leur. Si le robot est en mouvement lorsque la requ\u00eate est \u00e9mise, la valeur rapport\u00e9e inclut les mouvements mis en m\u00e9moire tampon dans le microcontr\u00f4leur, mais pas les mouvements de la file d'attente de surveillance. La position \"stepper\" ( stepper.get_commanded_position() ) est la position du moteur donn\u00e9 telle qu'elle est suivie par le code cin\u00e9matique. Cela correspond g\u00e9n\u00e9ralement \u00e0 la position (en mm) du chariot le long de son rail, par rapport \u00e0 la position_endstop indiqu\u00e9e dans le fichier de configuration. (Si le robot est en mouvement lorsque la requ\u00eate est \u00e9mise, la valeur rapport\u00e9e inclut les mouvements mis en m\u00e9moire tampon sur le micro-contr\u00f4leur, mais n'inclut pas les mouvements de la file d'attente look-ahead. On peut utiliser les appels toolhead.flush_step_generation() ou toolhead.wait_moves() pour vider compl\u00e8tement les codes de look-ahead et de g\u00e9n\u00e9ration de pas. La position \"kinematic\" ( kin.calc_position() ) est la position cart\u00e9sienne de la t\u00eate de l'outil telle que d\u00e9riv\u00e9e des positions \"pas \u00e0 pas\" et est relative au syst\u00e8me de coordonn\u00e9es sp\u00e9cifi\u00e9 dans le fichier de configuration. Cela peut diff\u00e9rer de la position cart\u00e9sienne demand\u00e9e en raison de la granularit\u00e9 des moteurs pas \u00e0 pas. Si le robot est en mouvement lorsque les positions \"stepper\" sont prises, la valeur rapport\u00e9e inclut les mouvements mis en m\u00e9moire tampon sur le micro-contr\u00f4leur, mais n'inclut pas les mouvements de la file d'attente look-ahead. On peut utiliser les appels toolhead.flush_step_generation() ou toolhead.wait_moves() pour vider compl\u00e8tement le code de look-ahead et de g\u00e9n\u00e9ration de pas. La position de la t\u00eate d'outil ( toolhead.get_position() ) est la derni\u00e8re position demand\u00e9e de la t\u00eate d'outil en coordonn\u00e9es cart\u00e9siennes par rapport au syst\u00e8me de coordonn\u00e9es sp\u00e9cifi\u00e9 dans le fichier de configuration. Si le robot est en mouvement lorsque la requ\u00eate est \u00e9mise, la valeur rapport\u00e9e inclut tous les d\u00e9placements demand\u00e9s (m\u00eame ceux dans les tampons en attente d'\u00eatre \u00e9mis vers les pilotes de moteurs pas \u00e0 pas). La position \"gcode\" est la derni\u00e8re position demand\u00e9e par une commande G1 (ou G0 ) en coordonn\u00e9es cart\u00e9siennes par rapport au syst\u00e8me de coordonn\u00e9es sp\u00e9cifi\u00e9 dans le fichier de configuration. Elle peut diff\u00e9rer de la position \"toolhead\" si une transformation g-code (par exemple, bed_mesh, bed_tilt, skew_correction) est en cours. Cela peut diff\u00e9rer des coordonn\u00e9es r\u00e9elles sp\u00e9cifi\u00e9es dans la derni\u00e8re commande G1 si l'origine du gcode a \u00e9t\u00e9 modifi\u00e9e (par exemple, G92 , SET_GCODE_OFFSET , M221 ). La commande M114 ( gcode_move.get_status()['gcode_position'] ) indiquera la derni\u00e8re position du g-code par rapport au syst\u00e8me de coordonn\u00e9es actuel du g-code. La \"base gcode\" est l'emplacement de l'origine du g-code en coordonn\u00e9es cart\u00e9siennes par rapport au syst\u00e8me de coordonn\u00e9es sp\u00e9cifi\u00e9 dans le fichier de configuration. Les commandes telles que G92 , SET_GCODE_OFFSET , et M221 modifient cette valeur. Le \"gcode homing\" est l'emplacement \u00e0 utiliser pour l'origine du g-code (en coordonn\u00e9es cart\u00e9siennes par rapport au syst\u00e8me de coordonn\u00e9es sp\u00e9cifi\u00e9 dans le fichier de configuration) apr\u00e8s une commande de mise \u00e0 l'origine G28 . La commande SET_GCODE_OFFSET peut modifier cette valeur. Temporisation \u00b6 La manipulation des horloges, des dur\u00e9es et des horodatages est fondamentale pour le fonctionnement de Klipper. Celui-ci ex\u00e9cute des actions sur l'imprimante en programmant des \u00e9v\u00e9nements qui se produiront dans un avenir proche. Par exemple, pour allumer un ventilateur, le code peut programmer un changement sur une broche GPIO dans 100 ms. Il est rare que le code tente d'effectuer une action instantan\u00e9e. Ainsi, la gestion du temps dans Klipper est essentielle pour un fonctionnement correct. Il existe trois types de temporisations suivis en interne dans le logiciel h\u00f4te Klipper : Heure du syst\u00e8me. L'heure syst\u00e8me utilise l'horloge du syst\u00e8me - c'est un nombre \u00e0 virgule flottante stock\u00e9 sous forme de secondes (g\u00e9n\u00e9ralement) relatif \u00e0 la date du dernier d\u00e9marrage de l'ordinateur h\u00f4te. Les temps syst\u00e8me ont un usage limit\u00e9 dans le logiciel - ils sont principalement utilis\u00e9s lors de l'interaction avec le syst\u00e8me d'exploitation. Dans le code h\u00f4te, les heures syst\u00e8me sont souvent stock\u00e9es dans des variables nomm\u00e9es eventtime ou curtime . Temps d'impression. Le temps d'impression est synchronis\u00e9 avec l'horloge du micro-contr\u00f4leur principal (le micro-contr\u00f4leur d\u00e9fini dans la section \"[mcu]\" de la configuration). C'est un nombre \u00e0 virgule flottante stock\u00e9 en secondes relatif \u00e0 la date du dernier red\u00e9marrage du micro-contr\u00f4leur principal. Il est possible de convertir un \"temps d'impression\" en horloge mat\u00e9rielle du micro-contr\u00f4leur principal en multipliant le temps d'impression par le taux de fr\u00e9quence du mcu configur\u00e9 statiquement. Le code h\u00f4te de haut niveau utilise les temps d'impression pour calculer presque toutes les actions physiques (par exemple, le mouvement de la t\u00eate, les changements de chauffage, etc.) Dans le code h\u00f4te, les temps d'impression sont g\u00e9n\u00e9ralement stock\u00e9s dans des variables nomm\u00e9es print_time ou move_time . Horloge MCU. Il s'agit du compteur d'horloge mat\u00e9riel de chaque micro-contr\u00f4leur. Il est stock\u00e9 sous forme d'un nombre entier et son taux de mise \u00e0 jour est relatif \u00e0 la fr\u00e9quence du micro-contr\u00f4leur donn\u00e9. Le logiciel h\u00f4te convertit ses temps internes en horloges avant de les transmettre \u00e0 l'unit\u00e9 centrale. Le code de l'unit\u00e9 centrale de traitement ne suit jamais le temps qu'en ticks d'horloge. Dans le code h\u00f4te, les valeurs d'horloge sont suivies sous forme d'entiers de 64 bits, alors que le code de l'unit\u00e9 centrale utilise des entiers de 32 bits. Dans le code h\u00f4te, les horloges sont g\u00e9n\u00e9ralement stock\u00e9es dans des variables dont les noms contiennent clock ou ticks . La conversion entre les diff\u00e9rents formats de temps est principalement impl\u00e9ment\u00e9e dans le code klippy/clocksync.py . Quelques \u00e9l\u00e9ments \u00e0 prendre en compte lors de la r\u00e9vision du code : Horloges 32bit et 64bit : Pour r\u00e9duire la bande passante et am\u00e9liorer l'efficacit\u00e9 du micro-contr\u00f4leur, les horloges sur le micro-contr\u00f4leur sont suivies comme des entiers 32bit. Lors de la comparaison de deux horloges dans le code mcu, la fonction timer_is_before() doit toujours \u00eatre utilis\u00e9e pour s'assurer que les renversements d'entiers sont trait\u00e9s correctement. Le logiciel h\u00f4te convertit les horloges 32bit en horloges 64bit en ajoutant les bits de poids fort du dernier timestamp mcu qu'il a re\u00e7u - aucun message du mcu n'est jamais plus de 2^31 ticks d'horloge dans le futur ou le pass\u00e9, donc cette conversion n'est jamais ambigu\u00eb. L'h\u00f4te convertit les horloges de 64 bits en horloges de 32 bits en tronquant simplement les bits de poids fort. Pour s'assurer qu'il n'y a pas d'ambigu\u00eft\u00e9 dans cette conversion, le code klippy/chelper/serialqueue.c mettra en m\u00e9moire tampon les messages jusqu'\u00e0 ce qu'ils soient dans les 2^31 ticks d'horloge de leur temps cible. Microcontr\u00f4leurs multiples : Le logiciel h\u00f4te permet d'utiliser plusieurs microcontr\u00f4leurs sur une seule imprimante. Dans ce cas, l'\"horloge MCU\" de chaque microcontr\u00f4leur est suivie s\u00e9par\u00e9ment. Le code clocksync.py g\u00e8re la d\u00e9rive de l'horloge entre les micro-contr\u00f4leurs en modifiant la fa\u00e7on dont il convertit le \"temps d'impression\" en \"horloge MCU\". Sur les mcus secondaires, la fr\u00e9quence du mcu utilis\u00e9e dans cette conversion est r\u00e9guli\u00e8rement mise \u00e0 jour pour tenir compte de la d\u00e9rive mesur\u00e9e.","title":"Aper\u00e7u du code"},{"location":"Code_Overview.html#apercu-du-code","text":"Ce document d\u00e9crit la disposition g\u00e9n\u00e9rale du code et le flux de code principal de Klipper.","title":"Aper\u00e7u du code"},{"location":"Code_Overview.html#disposition-du-repertoire","text":"Le r\u00e9pertoire src/ contient les sources C du code du micro-contr\u00f4leur. Les r\u00e9pertoires src/atsam/ , src/atsamd/ , src/avr/ , src/linux/ , src/lpc176x/ , src/pru/ , et src/stm32/ contiennent le code du micro-contr\u00f4leur sp\u00e9cifique \u00e0 chaque architecture. Le r\u00e9pertoire src/simulator/ contient des \u00e9l\u00e9ments de remplacement de code permettant de tester la compilation du micro-contr\u00f4leur sur d'autres architectures. Le r\u00e9pertoire src/generic/ contient du code d'assistance utile sur diff\u00e9rentes architectures. La compilation fait en sorte que les inclusions de \"board/somefile.h\" soient d'abord recherch\u00e9es dans le r\u00e9pertoire de l'architecture courante (par exemple, src/avr/somefile.h) et ensuite dans le r\u00e9pertoire g\u00e9n\u00e9rique (par exemple, src/generic/somefile.h). Le r\u00e9pertoire klippy/ contient le logiciel h\u00f4te. La majorit\u00e9 du logiciel h\u00f4te est \u00e9crit en Python, cependant le r\u00e9pertoire klippy/chelper/ contient quelques assistants en code C. Le r\u00e9pertoire klippy/kinematics/ contient le code li\u00e9 \u00e0 la cin\u00e9matique du robot. Le r\u00e9pertoire klippy/extras/ contient les \"modules\" extensibles du code h\u00f4te. Le r\u00e9pertoire lib/ contient du code de biblioth\u00e8que externe de tierce partie n\u00e9cessaire \u00e0 la construction de certaines cibles. Le r\u00e9pertoire config/ contient des exemples de fichiers de configuration d'imprimante. Le r\u00e9pertoire scripts/ contient des scripts de construction utiles \u00e0 la compilation du code du micro-contr\u00f4leur. Le r\u00e9pertoire test/ contient des cas de tests automatis\u00e9s. Pendant la compilation, le constructeur peut cr\u00e9er un r\u00e9pertoire out/ . Celui-ci contient des objets temporaires de compilation. L'objet micro-contr\u00f4leur final qui est construit est out/klipper.elf.hex sur AVR et out/klipper.bin sur ARM.","title":"Disposition du r\u00e9pertoire"},{"location":"Code_Overview.html#flux-de-code-du-micro-controleur","text":"L'ex\u00e9cution du code du microcontr\u00f4leur d\u00e9bute dans le code sp\u00e9cifique \u00e0 l'architecture (par exemple, src/avr/main.c ) qui appelle finalement sched_main() situ\u00e9 dans src/sched.c . Le code sched_main() commence par ex\u00e9cuter toutes les fonctions marqu\u00e9es avec la macro DECL_INIT(). Il ex\u00e9cute ensuite de mani\u00e8re r\u00e9p\u00e9t\u00e9e toutes les fonctions marqu\u00e9es par la macro DECL_TASK(). L'une des principales fonctions de la t\u00e2che est command_dispatch() situ\u00e9e dans src/command.c . Cette fonction est appel\u00e9e \u00e0 partir du code d'entr\u00e9e/sortie sp\u00e9cifique \u00e0 la carte (par exemple, src/avr/serial.c , src/generic/serial_irq.c ) et elle ex\u00e9cute les fonctions de commande associ\u00e9es aux commandes trouv\u00e9es dans le flux d'entr\u00e9e. Les fonctions de commande sont d\u00e9clar\u00e9es \u00e0 l'aide de la macro DECL_COMMAND() (voir le document protocole pour plus d'informations). Les fonctions de t\u00e2che, d'initialisation et de commande s'ex\u00e9cutent toujours avec les interruptions activ\u00e9es (toutefois, elles peuvent d\u00e9sactiver temporairement les interruptions si n\u00e9cessaire). Ces fonctions doivent \u00e9viter les longues pauses, les retards, ou effectuer un travail qui dure un temps significatif. (Les longs retards de ces fonctions \"t\u00e2ches\" entra\u00eenent une gigue de programmation pour d'autres \"t\u00e2ches\" - les retards de plus de 100us peuvent devenir perceptibles, les retards de plus de 500us peuvent entra\u00eener des retransmissions de commandes, les retards de plus de 100ms peuvent entra\u00eener des red\u00e9marrages du chien de garde). Ces fonctions planifient le travail \u00e0 des moments pr\u00e9cis en programmant des minuteries. Les fonctions de temporisation sont programm\u00e9es en appelant sched_add_timer() (situ\u00e9 dans src/sched.c ). Le code du planificateur s'arrangera pour que la fonction donn\u00e9e soit appel\u00e9e au moment demand\u00e9. Les interruptions de temporisation sont initialement trait\u00e9es dans un gestionnaire d'interruption sp\u00e9cifique \u00e0 l'architecture (par exemple, src/avr/timer.c ) qui appelle sched_timer_dispatch() situ\u00e9 dans src/sched.c . L'interruption de la temporisation entra\u00eene l'ex\u00e9cution des fonctions de temporisation planifi\u00e9es. Les fonctions de temporisation sont toujours ex\u00e9cut\u00e9es avec des interruptions d\u00e9sactiv\u00e9es. Les fonctions de temporisation devraient toujours se terminer en quelques microsecondes. \u00c0 la fin de l'\u00e9v\u00e9nement de temporisation, la fonction peut choisir de se reprogrammer. En cas de d\u00e9tection d'erreur, le code peut invoquer shutdown() (une macro qui appelle sched_shutdown() situ\u00e9e dans src/sched.c ). L'appel \u00e0 shutdown() entra\u00eene l'ex\u00e9cution de toutes les fonctions marqu\u00e9es par la macro DECL_SHUTDOWN(). Les fonctions d'arr\u00eat s'ex\u00e9cutent toujours avec des interruptions d\u00e9sactiv\u00e9es. Une grande partie des fonctionnalit\u00e9s du micro-contr\u00f4leur implique de travailler avec des broches d'entr\u00e9e/sortie \u00e0 usage g\u00e9n\u00e9ral (GPIO). Afin de s\u00e9parer le code de bas niveau sp\u00e9cifique \u00e0 l'architecture du code de haut niveau de la t\u00e2che, tous les \u00e9v\u00e9nements GPIO sont impl\u00e9ment\u00e9s dans des emballages sp\u00e9cifiques \u00e0 l'architecture (par exemple, src/avr/gpio.c ). Le code est compil\u00e9 avec l'optimisation \"-flto -fwhole-program\" de gcc qui fait un excellent travail d'int\u00e9gration des fonctions \u00e0 travers les unit\u00e9s de compilation, ainsi la plupart de ces minuscules fonctions gpio sont int\u00e9gr\u00e9es \u00e0 leurs appelants, et il n'y a aucun co\u00fbt d'ex\u00e9cution \u00e0 les utiliser.","title":"Flux de code du micro-contr\u00f4leur"},{"location":"Code_Overview.html#apercu-du-code-klippy","text":"Le code h\u00f4te (Klippy) est destin\u00e9 \u00e0 fonctionner sur un ordinateur \u00e0 petit prix (tel qu'un Raspberry Pi) associ\u00e9 au microcontr\u00f4leur. Le code est principalement \u00e9crit en Python, cependant il utilise CFFI pour impl\u00e9menter certaines fonctionnalit\u00e9s en code C. L'ex\u00e9cution initiale commence dans klippy/klippy.py . Ceci lit les arguments de la ligne de commande, ouvre le fichier de configuration de l'imprimante, instancie les principaux objets de l'imprimante et lance la connexion s\u00e9rie. L'ex\u00e9cution principale des commandes G-code se fait dans la m\u00e9thode process_commands() de klippy/gcode.py . Ce code traduit les commandes G-code en appels d'objets d'imprimante fr\u00e9quemment traduis en commandes d'actions \u00e0 ex\u00e9cuter sur le micro-contr\u00f4leur (tel que d\u00e9clar\u00e9 via la macro DECL_COMMAND dans le code du micro-contr\u00f4leur). Il y a quatre threads dans le code h\u00f4te de Klippy. Le thread principal g\u00e8re les commandes gcode entrantes. Un deuxi\u00e8me thread (r\u00e9sidant enti\u00e8rement dans le code C klippy/chelper/serialqueue.c ) g\u00e8re les entr\u00e9es/sorties de bas niveau avec le port s\u00e9rie. Le troisi\u00e8me thread est utilis\u00e9 pour traiter les messages de r\u00e9ponse du micro-contr\u00f4leur dans le code Python (voir klippy/serialhdl.py ). Le quatri\u00e8me thread \u00e9crit les messages de d\u00e9bogage dans le journal (voir klippy/queuelogger.py ) afin que les autres threads ne bloquent jamais les \u00e9critures dans le journal.","title":"Aper\u00e7u du code Klippy"},{"location":"Code_Overview.html#flux-du-code-dune-commande-de-deplacement","text":"Un mouvement typique de l'imprimante commence lorsqu'une commande \"G1\" est envoy\u00e9e \u00e0 l'h\u00f4te Klippy et se termine lorsque les impulsions de pas correspondantes sont produites sur le micro-contr\u00f4leur. Cette section d\u00e9crit le flux du code d'une commande de d\u00e9placement typique. Le document cin\u00e9matiques fournit des informations suppl\u00e9mentaires sur la m\u00e9canique des mouvements. Le traitement d'une commande de d\u00e9placement commence dans gcode.py. Le but de gcode.py est de traduire le G-code en appels internes. Une commande G1 invoquera cmd_G1() dans klippy/extras/gcode_move.py. Le code gcode_move.py g\u00e8re les changements d'origine (par exemple, G92), les changements de positions relatives et absolues (par exemple, G90), et les changements d'unit\u00e9s (par exemple, F6000=100mm/s). Le chemin du code pour un d\u00e9placement est : _process_data() -> _process_commands() -> cmd_G1() . Finalement, la classe ToolHead est invoqu\u00e9e pour ex\u00e9cuter la demande r\u00e9elle : cmd_G1() -> ToolHead.move() La classe ToolHead (dans toolhead.py) g\u00e8re le \"look-ahead\" et suit la temporisation des actions d'impression. Le chemin du code principal pour un d\u00e9placement est : ToolHead.move() -> MoveQueue.add_move() -> MoveQueue.flush() -> Move.set_junction() -> ToolHead._process_moves() . ToolHead.move() cr\u00e9e un objet Move() avec les param\u00e8tres du d\u00e9placement (dans l'espace cart\u00e9sien et en unit\u00e9s de secondes et de millim\u00e8tres). La classe cin\u00e9matique a la possibilit\u00e9 de v\u00e9rifier chaque mouvement ( ToolHead.move() -> kin.check_move() ). Les classes cin\u00e9matiques sont situ\u00e9es dans le r\u00e9pertoire klippy/kinematics/. Le code check_move() peut lever une erreur si le d\u00e9placement n'est pas valide. Si check_move() se termine avec succ\u00e8s, alors la cin\u00e9matique sous-jacente doit \u00eatre capable de g\u00e9rer le d\u00e9placement. MoveQueue.add_move() place l'objet move dans la file d'attente \"look-ahead\". MoveQueue.flush() d\u00e9termine les vitesses de d\u00e9but et de fin de chaque mouvement. Move.set_junction() impl\u00e9mente le \"g\u00e9n\u00e9rateur de trap\u00e8ze\" sur un mouvement. Le \"g\u00e9n\u00e9rateur de trap\u00e8ze\" divise chaque mouvement en trois parties : une phase d'acc\u00e9l\u00e9ration constante, suivie d'une phase de vitesse constante, puis d'une phase de d\u00e9c\u00e9l\u00e9ration constante. Chaque d\u00e9placement contient ces trois phases dans cet ordre, certaines phases pouvant \u00eatre de dur\u00e9e nulle. Lorsque ToolHead._process_moves() est appel\u00e9, tout ce qui concerne le d\u00e9placement est connu : sa position de d\u00e9part, sa position d'arriv\u00e9e, son acc\u00e9l\u00e9ration, sa vitesse de d\u00e9part/de croisi\u00e8re/de fin, et la distance parcourue pendant l'acc\u00e9l\u00e9ration/la croisi\u00e8re/la d\u00e9c\u00e9l\u00e9ration. Toutes ces informations sont stock\u00e9es dans la classe Move() et sont dans l'espace cart\u00e9sien en unit\u00e9s de millim\u00e8tres et de secondes. Klipper utilise un solveur it\u00e9ratif afin de g\u00e9n\u00e9rer les d\u00e9lais des pas pour chaque moteur pas \u00e0 pas. Pour des raisons d'efficacit\u00e9, les d\u00e9lais d'impulsion des pas sont g\u00e9n\u00e9r\u00e9s en code C. Les mouvements sont d'abord plac\u00e9s dans une \"file d'attente de mouvements trap\u00e9zo\u00efdaux\" : ToolHead._process_moves() -> trapq_append() (dans klippy/chelper/trapq.c). Les d\u00e9lais de pas sont ensuite g\u00e9n\u00e9r\u00e9s : ToolHead._process_moves() -> ToolHead._update_move_time() -> MCU_Stepper.generate_steps() -> itersolve_generate_steps() -> itersolve_gen_steps_range() (dans klippy/chelper/itersolve.c). Le but du solveur it\u00e9ratif est de trouver les d\u00e9lais de pas \u00e0 partir d'une fonction calculant la position du moteur \u00e0 partir du temps. Ceci est fait en \"devinant\" de mani\u00e8re r\u00e9p\u00e9t\u00e9e plusieurs d\u00e9lais jusqu'\u00e0 ce que la formule de position du pas renvoie la position d\u00e9sir\u00e9e du pas suivant sur le moteur. Le retour d'information produit par chaque estimation est utilis\u00e9 afin d'am\u00e9liorer les estimations futures, de sorte que le processus converge rapidement vers le d\u00e9lai souhait\u00e9. Les formules de position cin\u00e9matique du moteur sont situ\u00e9es dans le r\u00e9pertoire klippy/chelper/ (par exemple, kin_cart.c, kin_corexy.c, kin_delta.c, kin_extruder.c). Notez que l'extrudeuse est g\u00e9r\u00e9e dans sa propre classe cin\u00e9matique : ToolHead._process_moves() -> PrinterExtruder.move() . Puisque la classe Move() sp\u00e9cifie le d\u00e9lai exact du mouvement et que les impulsions de pas sont envoy\u00e9es au micro-contr\u00f4leur avec un timing sp\u00e9cifique, les mouvements du moteur produits par la classe de l'extrudeuse seront synchronis\u00e9s avec le mouvement de la t\u00eate m\u00eame si le code est s\u00e9par\u00e9. Apr\u00e8s que le solveur it\u00e9ratif ait calcul\u00e9 les d\u00e9lais de pas, ils sont ajout\u00e9s \u00e0 un tableau : itersolve_gen_steps_range() -> stepcompress_append() (dans klippy/chelper/stepcompress.c). Le tableau (struct stepcompress.queue) stocke les dur\u00e9es correspondantes du compteur d'horloge du micro-contr\u00f4leur pour chaque \u00e9tape. Ici, la valeur du \"compteur d'horloge du micro-contr\u00f4leur\" correspond directement au compteur mat\u00e9riel du micro-contr\u00f4leur - elle est relative \u00e0 la derni\u00e8re mise sous tension du micro-contr\u00f4leur. La prochaine \u00e9tape majeure est de compresser les \u00e9tapes : stepcompress_flush() -> compress_bisect_add() (dans klippy/chelper/stepcompress.c). Ce code g\u00e9n\u00e8re et encode une s\u00e9rie de commandes \"queue_step\" du micro-contr\u00f4leur correspondant \u00e0 la liste des dur\u00e9es de pas du moteur construite \u00e0 l'\u00e9tape pr\u00e9c\u00e9dente. Ces commandes \"queue_step\" sont ensuite mises en file d'attente, hi\u00e9rarchis\u00e9es et envoy\u00e9es au micro-contr\u00f4leur (via stepcompress.c:steppersync et serialqueue.c:serialqueue). Le traitement des commandes queue_step sur le micro-contr\u00f4leur commence dans src/command.c qui analyse la commande et appelle command_queue_step() . Le code command_queue_step() (dans src/stepper.c) ajoute simplement les param\u00e8tres de chaque commande queue_step \u00e0 une file d'attente par moteur. En fonctionnement normal, la commande queue_step est analys\u00e9e et mise en file d'attente au moins 100ms avant le moment de son premier pas. Enfin, la g\u00e9n\u00e9ration des \u00e9v\u00e9nements de pas du moteur est faite dans stepper_event() . Elle est appel\u00e9e depuis l'interruption du compteur mat\u00e9riel \u00e0 l'heure pr\u00e9vue du premier pas. Le code stepper_event() g\u00e9n\u00e8re une impulsion de pas et se reprogramme ensuite pour s'ex\u00e9cuter au moment de l'impulsion de pas suivante pour les param\u00e8tres queue_step donn\u00e9s. Les param\u00e8tres pour chaque commande queue_step sont \"interval\", \"count\", et \"add\". A un haut niveau, stepper_event() ex\u00e9cute la commande suivante, 'count' fois : do_step() ; next_wake_time = last_wake_time + interval ; interval += add; Ce qui pr\u00e9c\u00e8de peut sembler beaucoup de complexit\u00e9 pour l'ex\u00e9cution d'un mouvement. Cependant, les seules parties vraiment int\u00e9ressantes se trouvent dans les classes ToolHead et kinematic. C'est cette partie du code qui pr\u00e9cise les mouvements et leurs dur\u00e9es. Les autres parties du traitement sont essentiellement de la communication et de la plomberie.","title":"Flux du code d'une commande de d\u00e9placement"},{"location":"Code_Overview.html#ajout-dun-module-hote","text":"Le code h\u00f4te de Klippy a une capacit\u00e9 de chargement dynamique de modules. Si une section de configuration nomm\u00e9e \"[mon_module]\" est trouv\u00e9e dans le fichier de configuration de l'imprimante, le logiciel tentera automatiquement de charger le module python klippy/extras/mon_module.py . Ce syst\u00e8me de modules est la m\u00e9thode pr\u00e9f\u00e9r\u00e9e pour ajouter de nouvelles fonctionnalit\u00e9s \u00e0 Klipper. La fa\u00e7on la plus simple d'ajouter un nouveau module est d'utiliser un module existant comme r\u00e9f\u00e9rence - voir klippy/extras/servo.py comme exemple. Les \u00e9l\u00e9ments suivants peuvent \u00e9galement \u00eatre utiles : L'ex\u00e9cution du module commence dans la fonction load_config() au niveau du module (pour les sections de configuration de la forme [mon_module]) ou dans load_config_prefix() (pour les sections de configuration de la forme [mon_module mon_nom]). On passe \u00e0 cette fonction un objet \"config\" et elle doit retourner un nouvel \"objet imprimante\" associ\u00e9 \u00e0 la section de configuration donn\u00e9e. Durant le processus d'instanciation d'un nouvel objet imprimante, l'objet config peut \u00eatre utilis\u00e9 pour lire les param\u00e8tres de la section config donn\u00e9e. Ceci est fait en utilisant les m\u00e9thodes config.get() , config.getfloat() , config.getint() , etc. Assurez-vous de lire toutes les valeurs de la configuration pendant la construction de l'objet imprimante - si l'utilisateur sp\u00e9cifie un param\u00e8tre de configuration qui n'est pas lu pendant cette phase, il sera suppos\u00e9 qu'il s'agit d'une faute de frappe dans la configuration et une erreur sera lev\u00e9e. Utilisez la m\u00e9thode config.get_printer() pour obtenir une r\u00e9f\u00e9rence \u00e0 la classe principale \"printer\". Cette classe \"printer\" stocke les r\u00e9f\u00e9rences de tous les \"objets imprimante\" instanci\u00e9s. Utilisez la m\u00e9thode printer.lookup_object() pour trouver des r\u00e9f\u00e9rences \u00e0 d'autres objets imprimante. Presque toutes les fonctionnalit\u00e9s (m\u00eame les modules cin\u00e9matiques de base) sont encapsul\u00e9es dans un de ces objets imprimante. Notez, cependant, que lorsqu'un nouveau module est instanci\u00e9, tous les autres objets d'impression n'auront pas encore \u00e9t\u00e9 instanci\u00e9s. Les modules \"gcode\" et \"pins\" seront toujours disponibles, mais pour les autres modules, il est pr\u00e9f\u00e9rable de diff\u00e9rer la recherche. Enregistrez les gestionnaires d'\u00e9v\u00e9nements en utilisant la m\u00e9thode printer.register_event_handler() si le code doit \u00eatre appel\u00e9 lors d'\"\u00e9v\u00e9nements\" d\u00e9clench\u00e9s par d'autres objets imprimante. Chaque nom d'\u00e9v\u00e9nement est une cha\u00eene de caract\u00e8res, et par convention, c'est le nom du module source principal d\u00e9clenchant l'\u00e9v\u00e9nement avec un nom court pour l'action produite (par exemple, \"klippy:connect\"). Les param\u00e8tres pass\u00e9s \u00e0 chaque gestionnaire d'\u00e9v\u00e9nement sont sp\u00e9cifiques \u00e0 l'\u00e9v\u00e9nement en question (tout comme le traitement des exceptions et le contexte d'ex\u00e9cution). Deux \u00e9v\u00e9nements de d\u00e9marrage courants sont : klippy:connect - Cet \u00e9v\u00e9nement est g\u00e9n\u00e9r\u00e9 apr\u00e8s l'instanciation de tous les objets imprimante. Il est couramment utilis\u00e9 pour rechercher d'autres objets imprimante, pour v\u00e9rifier les param\u00e8tres de configuration et pour effectuer une premi\u00e8re \"prise de contact\" avec le mat\u00e9riel de l'imprimante. klippy:ready - Cet \u00e9v\u00e9nement est g\u00e9n\u00e9r\u00e9 apr\u00e8s que tous les gestionnaires de connexion se soient termin\u00e9s avec succ\u00e8s. Il indique que l'imprimante est en train de passer \u00e0 l'\u00e9tat pr\u00eat \u00e0 g\u00e9rer les op\u00e9rations normales. Ne d\u00e9clenchez pas d'erreur dans ce rappel. S'il y a une erreur dans la configuration de l'utilisateur, assurez-vous de la signaler pendant les phases load_config() ou \"connect event\". Utilisez soit raise config.error(\"mon erreur\") soit raise printer.config_error(\"mon erreur\") pour signaler l'erreur. Utilisez le module \"pins\" pour configurer une broche sur un micro-contr\u00f4leur. Ceci est typiquement fait avec quelque chose de similaire \u00e0 printer.lookup_object(\"pins\").setup_pin(\"pwm\", config.get(\"my_pin\")) . L'objet retourn\u00e9 peut alors \u00eatre command\u00e9 au moment de l'ex\u00e9cution. Si l'objet imprimante d\u00e9finit une m\u00e9thode get_status() , le module peut exporter des informations d'\u00e9tat via des macros et via le serveur API . La m\u00e9thode get_status() doit retourner un dictionnaire Python dont les cl\u00e9s sont des cha\u00eenes de caract\u00e8res et les valeurs des entiers, des flottants, des cha\u00eenes de caract\u00e8res, des listes, des dictionnaires, True, False ou None. Les tuples (et les tuples nomm\u00e9s) peuvent \u00e9galement \u00eatre utilis\u00e9s (ils apparaissent comme des listes lorsqu'on y acc\u00e8de via le serveur API). Les listes et les dictionnaires export\u00e9s doivent \u00eatre trait\u00e9s comme \"immuables\" - si leur contenu change, un nouvel objet doit \u00eatre renvoy\u00e9 par get_status() , sinon le serveur API ne d\u00e9tectera pas ces changements. Si le module doit acc\u00e9der \u00e0 la temporisation du syst\u00e8me ou \u00e0 des descripteurs de fichiers externes, utilisez printer.get_reactor() pour obtenir l'acc\u00e8s \u00e0 la classe globale \"event reactor\". Cette classe de r\u00e9acteur permet de programmer des temporisations, d'attendre des entr\u00e9es sur des descripteurs de fichiers, et d'\"endormir\" le code h\u00f4te. N'utilisez pas de variables globales. Tous les \u00e9tats doivent \u00eatre stock\u00e9s dans l'objet imprimante renvoy\u00e9 par la fonction load_config() . Ceci est important car sinon la commande RESTART pourrait ne pas fonctionner comme pr\u00e9vu. De m\u00eame, pour des raisons similaires, si des fichiers externes (ou des sockets) sont ouverts, assurez-vous d'enregistrer un gestionnaire d'\u00e9v\u00e9nement \"klippy:disconnect\" et de les fermer \u00e0 partir de ce rappel. \u00c9vitez d'acc\u00e9der aux variables membres internes (ou d'appeler les m\u00e9thodes commen\u00e7ant par un trait de soulignement) d'autres objets imprimante. Le respect de cette convention facilite la gestion des modifications futures. Il est recommand\u00e9 d'attribuer une valeur \u00e0 toutes les variables membres dans le constructeur Python des classes Python. (Et donc d'\u00e9viter d'utiliser la capacit\u00e9 de Python \u00e0 cr\u00e9er dynamiquement de nouvelles variables membres.) Si une variable Python doit stocker une valeur en virgule flottante, il est recommand\u00e9 de toujours affecter et manipuler cette variable avec des constantes en virgule flottante (et de ne jamais utiliser de constantes enti\u00e8res). Par exemple, pr\u00e9f\u00e9rez self.speed = 1. \u00e0 self.speed = 1 , et pr\u00e9f\u00e9rez self.speed = 2. * x plut\u00f4t que self.speed = 2 * x . L'utilisation coh\u00e9rente des valeurs \u00e0 virgule flottante peut \u00e9viter des bizarreries difficiles \u00e0 d\u00e9boguer dans les conversions de types Python. Si vous soumettez le module pour qu'il soit inclus dans le code principal de Klipper, veillez \u00e0 placer un avis de copyright en haut du module. Consultez les modules existants pour conna\u00eetre le format pr\u00e9f\u00e9r\u00e9.","title":"Ajout d'un module h\u00f4te"},{"location":"Code_Overview.html#ajout-de-nouvelles-cinematiques","text":"Cette section fournit quelques conseils pour ajouter le support \u00e0 Klipper de types suppl\u00e9mentaires de cin\u00e9matiques d'imprimante. Ce type d'activit\u00e9 n\u00e9cessite une excellente compr\u00e9hension des formules math\u00e9matiques de la cin\u00e9matique cible. Elle requiert \u00e9galement des comp\u00e9tences en mati\u00e8re de d\u00e9veloppement de logiciels, m\u00eame s'il suffit de mettre \u00e0 jour le logiciel h\u00f4te. Les \u00e9tapes utiles : Commencez par \u00e9tudier la section \" code de flux d'un mouvement \" et le document cin\u00e9matiques . Passez en revue les classes cin\u00e9matiques existantes dans le r\u00e9pertoire klippy/kinematics/. Les classes cin\u00e9matiques sont charg\u00e9es de convertir le mouvement en coordonn\u00e9es cart\u00e9siennes en un mouvement sur chaque moteur. On devrait \u00eatre capable de copier un de ces fichiers comme point de d\u00e9part. Impl\u00e9mentez les fonctions de position cin\u00e9matique du moteur en C pour chaque moteur si elles ne sont pas d\u00e9j\u00e0 disponibles (voir kin_cart.c, kin_corexy.c, et kin_delta.c dans klippy/chelper/). La fonction doit appeler move_get_coord() pour convertir une dur\u00e9e de d\u00e9placement donn\u00e9e (en secondes) en coordonn\u00e9es cart\u00e9siennes (en millim\u00e8tres), et ensuite calculer la position souhait\u00e9e du moteur (en millim\u00e8tres) \u00e0 partir de ces coordonn\u00e9es cart\u00e9siennes. Impl\u00e9mentez la m\u00e9thode calc_position() dans la nouvelle classe cin\u00e9matique. Cette m\u00e9thode calcule la position de la t\u00eate de l'outil en coordonn\u00e9es cart\u00e9siennes \u00e0 partir de la position de chaque moteur. Elle n'a pas besoin d'\u00eatre efficace car elle n'est typiquement appel\u00e9e que pendant les op\u00e9rations de mise \u00e0 l'origine et de palpage. Autres m\u00e9thodes. Impl\u00e9mentez les m\u00e9thodes check_move() , get_status() , get_steppers() , home() , et set_position() . Ces fonctions sont typiquement utilis\u00e9es pour fournir des v\u00e9rifications sp\u00e9cifiques \u00e0 la cin\u00e9matique. Cependant, au d\u00e9but du d\u00e9veloppement, on peut utiliser du code passe-partout ici. Impl\u00e9menter des cas de test. Cr\u00e9ez un fichier g-code avec une s\u00e9rie de mouvements pouvant tester des cas importants pour la cin\u00e9matique donn\u00e9e. Suivez la documentation de d\u00e9bogage pour convertir ce fichier g-code en commandes de micro-contr\u00f4leur. Ceci est utile pour tester les cas extr\u00eames et v\u00e9rifier les r\u00e9gressions.","title":"Ajout de nouvelles cin\u00e9matiques"},{"location":"Code_Overview.html#portage-sur-un-nouveau-microcontroleur","text":"Cette section fournit quelques conseils sur le portage du code du microcontr\u00f4leur de Klipper vers une nouvelle architecture. Ce type d'activit\u00e9 n\u00e9cessite une bonne connaissance du d\u00e9veloppement embarqu\u00e9 et un acc\u00e8s pratique au microcontr\u00f4leur cible. Les \u00e9tapes utiles : Commencez par identifier toutes les biblioth\u00e8ques tierces qui seront utilis\u00e9es pendant le portage. Les exemples courants incluent les wrappers \"CMSIS\" et les biblioth\u00e8ques \"HAL\" des fabricants. Tout code tiers doit \u00eatre compatible avec la licence GNU GPLv3. Le code tiers doit \u00eatre livr\u00e9 dans le r\u00e9pertoire Klipper lib/. Mettez \u00e0 jour le fichier lib/README en indiquant o\u00f9 et quand la biblioth\u00e8que a \u00e9t\u00e9 obtenue. Il est pr\u00e9f\u00e9rable de copier le code dans le d\u00e9p\u00f4t Klipper sans modification, mais si des modifications sont n\u00e9cessaires, elles doivent \u00eatre indiqu\u00e9es explicitement dans le fichier lib/README. Cr\u00e9er un nouveau sous-r\u00e9pertoire d'architecture dans le r\u00e9pertoire src/ et ajouter le support initial de Kconfig et Makefile. Utilisez les architectures existantes comme guide. Le simulateur src/simulator fournit un exemple de base pour un point de d\u00e9part minimal. La premi\u00e8re t\u00e2che principale de codage est d'apporter le support de communication \u00e0 la carte cible. C'est l'\u00e9tape la plus difficile dans un nouveau portage. Une fois que la communication de base fonctionne, les autres \u00e9tapes ont tendance \u00e0 \u00eatre beaucoup plus faciles. Il est typique d'utiliser un dispositif s\u00e9rie de type UART pendant le d\u00e9veloppement initial car ces types de dispositifs mat\u00e9riels sont g\u00e9n\u00e9ralement plus faciles \u00e0 activer et \u00e0 contr\u00f4ler. Pendant cette phase, faites un usage lib\u00e9ral du code d'aide du r\u00e9pertoire src/generic/ (v\u00e9rifiez comment src/simulator/Makefile inclut le code C g\u00e9n\u00e9rique dans la compilation). Il est \u00e9galement n\u00e9cessaire de d\u00e9finir timer_read_time() (qui renvoie l'horloge syst\u00e8me actuelle) dans cette phase, mais il n'est pas n\u00e9cessaire de supporter compl\u00e8tement la gestion des irq des timers. Familiarisez-vous avec l'outil console.py (comme d\u00e9crit dans le document de d\u00e9bogage ) et v\u00e9rifiez la connectivit\u00e9 au microcontr\u00f4leur avec cet outil. Cet outil traduit le protocole de communication de bas niveau du microcontr\u00f4leur en une forme lisible par l'homme. Ajouter le support pour la distribution des timers \u00e0 partir des interruptions mat\u00e9rielles. Voir Klipper commit 970831ee comme exemple des \u00e9tapes 1-5 r\u00e9alis\u00e9es pour l'architecture LPC176x. Apporter le support de base des entr\u00e9es et sorties GPIO. Voir Klipper commit c78b9076 comme exemple. Faire appara\u00eetre des p\u00e9riph\u00e9riques suppl\u00e9mentaires - par exemple, voir Klipper commit 65613aed , c812a40a , et c381d03a . Cr\u00e9ez un exemple de fichier de configuration Klipper dans le r\u00e9pertoire config/. Testez le micro-contr\u00f4leur avec le programme principal klippy.py. Pensez \u00e0 ajouter des cas de test de construction dans le r\u00e9pertoire test/. Conseils suppl\u00e9mentaires pour le codage : \u00c9vitez d'utiliser des \"champs de bits C\" pour acc\u00e9der aux registres d'E/S ; pr\u00e9f\u00e9rez les op\u00e9rations directes de lecture et d'\u00e9criture d'entiers de 32, 16 ou 8 bits. Les sp\u00e9cifications du langage C ne pr\u00e9cisent pas clairement comment le compilateur doit impl\u00e9menter les champs de bits C (par exemple, l'endianness et la disposition des bits), et il est difficile de d\u00e9terminer quelles op\u00e9rations d'E/S se produiront lors de la lecture ou de l'\u00e9criture d'un champ de bits C. Pr\u00e9f\u00e9rez l'\u00e9criture de valeurs explicites dans les registres d'E/S \u00e0 l'utilisation d'op\u00e9rations de lecture-modification-\u00e9criture. Autrement dit, si l'on met \u00e0 jour un champ dans un registre d'E/S dont les autres champs ont des valeurs connues, il est pr\u00e9f\u00e9rable d'\u00e9crire explicitement le contenu complet du registre. Les \u00e9critures explicites produisent un code plus petit, plus rapide et plus facile \u00e0 d\u00e9boguer.","title":"Portage sur un nouveau microcontr\u00f4leur"},{"location":"Code_Overview.html#les-systemes-de-coordonnees","text":"En interne, Klipper suit principalement la position de la t\u00eate de l'outil en coordonn\u00e9es cart\u00e9siennes relatives au syst\u00e8me de coordonn\u00e9es sp\u00e9cifi\u00e9 dans le fichier de configuration. C'est-\u00e0-dire que la plupart du code de Klipper ne conna\u00eetra jamais de changement de syst\u00e8me de coordonn\u00e9es. Si l'utilisateur fait une demande pour changer l'origine (par exemple, une commande G92 ) alors cet effet est obtenu en traduisant les commandes futures vers le syst\u00e8me de coordonn\u00e9es primaires. Cependant, dans certains cas, il est utile d'obtenir la position de la t\u00eate de l'outil dans un autre syst\u00e8me de coordonn\u00e9es et Klipper dispose de plusieurs outils pour faciliter cela. Vous pouvez le constater en ex\u00e9cutant la commande GET_POSITION. Par exemple : Send: GET_POSITION Recv: // mcu: stepper_a:-2060 stepper_b:-1169 stepper_c:-1613 Recv: // stepper: stepper_a:457.254159 stepper_b:466.085669 stepper_c:465.382132 Recv: // kinematic: X:8.339144 Y:-3.131558 Z:233.347121 Recv: // toolhead: X:8.338078 Y:-3.123175 Z:233.347878 E:0.000000 Recv: // gcode: X:8.338078 Y:-3.123175 Z:233.347878 E:0.000000 Recv: // gcode base: X:0.000000 Y:0.000000 Z:0.000000 E:0.000000 Recv: // gcode homing: X:0.000000 Y:0.000000 Z:0.000000 La position \"mcu\" ( stepper.get_mcu_position() dans le code) est le nombre total de pas que le micro-contr\u00f4leur a \u00e9mis dans un sens positif moins le nombre de pas \u00e9mis dans un sens n\u00e9gatif depuis la derni\u00e8re r\u00e9initialisation du micro-contr\u00f4leur. Si le robot est en mouvement lorsque la requ\u00eate est \u00e9mise, la valeur rapport\u00e9e inclut les mouvements mis en m\u00e9moire tampon dans le microcontr\u00f4leur, mais pas les mouvements de la file d'attente de surveillance. La position \"stepper\" ( stepper.get_commanded_position() ) est la position du moteur donn\u00e9 telle qu'elle est suivie par le code cin\u00e9matique. Cela correspond g\u00e9n\u00e9ralement \u00e0 la position (en mm) du chariot le long de son rail, par rapport \u00e0 la position_endstop indiqu\u00e9e dans le fichier de configuration. (Si le robot est en mouvement lorsque la requ\u00eate est \u00e9mise, la valeur rapport\u00e9e inclut les mouvements mis en m\u00e9moire tampon sur le micro-contr\u00f4leur, mais n'inclut pas les mouvements de la file d'attente look-ahead. On peut utiliser les appels toolhead.flush_step_generation() ou toolhead.wait_moves() pour vider compl\u00e8tement les codes de look-ahead et de g\u00e9n\u00e9ration de pas. La position \"kinematic\" ( kin.calc_position() ) est la position cart\u00e9sienne de la t\u00eate de l'outil telle que d\u00e9riv\u00e9e des positions \"pas \u00e0 pas\" et est relative au syst\u00e8me de coordonn\u00e9es sp\u00e9cifi\u00e9 dans le fichier de configuration. Cela peut diff\u00e9rer de la position cart\u00e9sienne demand\u00e9e en raison de la granularit\u00e9 des moteurs pas \u00e0 pas. Si le robot est en mouvement lorsque les positions \"stepper\" sont prises, la valeur rapport\u00e9e inclut les mouvements mis en m\u00e9moire tampon sur le micro-contr\u00f4leur, mais n'inclut pas les mouvements de la file d'attente look-ahead. On peut utiliser les appels toolhead.flush_step_generation() ou toolhead.wait_moves() pour vider compl\u00e8tement le code de look-ahead et de g\u00e9n\u00e9ration de pas. La position de la t\u00eate d'outil ( toolhead.get_position() ) est la derni\u00e8re position demand\u00e9e de la t\u00eate d'outil en coordonn\u00e9es cart\u00e9siennes par rapport au syst\u00e8me de coordonn\u00e9es sp\u00e9cifi\u00e9 dans le fichier de configuration. Si le robot est en mouvement lorsque la requ\u00eate est \u00e9mise, la valeur rapport\u00e9e inclut tous les d\u00e9placements demand\u00e9s (m\u00eame ceux dans les tampons en attente d'\u00eatre \u00e9mis vers les pilotes de moteurs pas \u00e0 pas). La position \"gcode\" est la derni\u00e8re position demand\u00e9e par une commande G1 (ou G0 ) en coordonn\u00e9es cart\u00e9siennes par rapport au syst\u00e8me de coordonn\u00e9es sp\u00e9cifi\u00e9 dans le fichier de configuration. Elle peut diff\u00e9rer de la position \"toolhead\" si une transformation g-code (par exemple, bed_mesh, bed_tilt, skew_correction) est en cours. Cela peut diff\u00e9rer des coordonn\u00e9es r\u00e9elles sp\u00e9cifi\u00e9es dans la derni\u00e8re commande G1 si l'origine du gcode a \u00e9t\u00e9 modifi\u00e9e (par exemple, G92 , SET_GCODE_OFFSET , M221 ). La commande M114 ( gcode_move.get_status()['gcode_position'] ) indiquera la derni\u00e8re position du g-code par rapport au syst\u00e8me de coordonn\u00e9es actuel du g-code. La \"base gcode\" est l'emplacement de l'origine du g-code en coordonn\u00e9es cart\u00e9siennes par rapport au syst\u00e8me de coordonn\u00e9es sp\u00e9cifi\u00e9 dans le fichier de configuration. Les commandes telles que G92 , SET_GCODE_OFFSET , et M221 modifient cette valeur. Le \"gcode homing\" est l'emplacement \u00e0 utiliser pour l'origine du g-code (en coordonn\u00e9es cart\u00e9siennes par rapport au syst\u00e8me de coordonn\u00e9es sp\u00e9cifi\u00e9 dans le fichier de configuration) apr\u00e8s une commande de mise \u00e0 l'origine G28 . La commande SET_GCODE_OFFSET peut modifier cette valeur.","title":"Les syst\u00e8mes de coordonn\u00e9es"},{"location":"Code_Overview.html#temporisation","text":"La manipulation des horloges, des dur\u00e9es et des horodatages est fondamentale pour le fonctionnement de Klipper. Celui-ci ex\u00e9cute des actions sur l'imprimante en programmant des \u00e9v\u00e9nements qui se produiront dans un avenir proche. Par exemple, pour allumer un ventilateur, le code peut programmer un changement sur une broche GPIO dans 100 ms. Il est rare que le code tente d'effectuer une action instantan\u00e9e. Ainsi, la gestion du temps dans Klipper est essentielle pour un fonctionnement correct. Il existe trois types de temporisations suivis en interne dans le logiciel h\u00f4te Klipper : Heure du syst\u00e8me. L'heure syst\u00e8me utilise l'horloge du syst\u00e8me - c'est un nombre \u00e0 virgule flottante stock\u00e9 sous forme de secondes (g\u00e9n\u00e9ralement) relatif \u00e0 la date du dernier d\u00e9marrage de l'ordinateur h\u00f4te. Les temps syst\u00e8me ont un usage limit\u00e9 dans le logiciel - ils sont principalement utilis\u00e9s lors de l'interaction avec le syst\u00e8me d'exploitation. Dans le code h\u00f4te, les heures syst\u00e8me sont souvent stock\u00e9es dans des variables nomm\u00e9es eventtime ou curtime . Temps d'impression. Le temps d'impression est synchronis\u00e9 avec l'horloge du micro-contr\u00f4leur principal (le micro-contr\u00f4leur d\u00e9fini dans la section \"[mcu]\" de la configuration). C'est un nombre \u00e0 virgule flottante stock\u00e9 en secondes relatif \u00e0 la date du dernier red\u00e9marrage du micro-contr\u00f4leur principal. Il est possible de convertir un \"temps d'impression\" en horloge mat\u00e9rielle du micro-contr\u00f4leur principal en multipliant le temps d'impression par le taux de fr\u00e9quence du mcu configur\u00e9 statiquement. Le code h\u00f4te de haut niveau utilise les temps d'impression pour calculer presque toutes les actions physiques (par exemple, le mouvement de la t\u00eate, les changements de chauffage, etc.) Dans le code h\u00f4te, les temps d'impression sont g\u00e9n\u00e9ralement stock\u00e9s dans des variables nomm\u00e9es print_time ou move_time . Horloge MCU. Il s'agit du compteur d'horloge mat\u00e9riel de chaque micro-contr\u00f4leur. Il est stock\u00e9 sous forme d'un nombre entier et son taux de mise \u00e0 jour est relatif \u00e0 la fr\u00e9quence du micro-contr\u00f4leur donn\u00e9. Le logiciel h\u00f4te convertit ses temps internes en horloges avant de les transmettre \u00e0 l'unit\u00e9 centrale. Le code de l'unit\u00e9 centrale de traitement ne suit jamais le temps qu'en ticks d'horloge. Dans le code h\u00f4te, les valeurs d'horloge sont suivies sous forme d'entiers de 64 bits, alors que le code de l'unit\u00e9 centrale utilise des entiers de 32 bits. Dans le code h\u00f4te, les horloges sont g\u00e9n\u00e9ralement stock\u00e9es dans des variables dont les noms contiennent clock ou ticks . La conversion entre les diff\u00e9rents formats de temps est principalement impl\u00e9ment\u00e9e dans le code klippy/clocksync.py . Quelques \u00e9l\u00e9ments \u00e0 prendre en compte lors de la r\u00e9vision du code : Horloges 32bit et 64bit : Pour r\u00e9duire la bande passante et am\u00e9liorer l'efficacit\u00e9 du micro-contr\u00f4leur, les horloges sur le micro-contr\u00f4leur sont suivies comme des entiers 32bit. Lors de la comparaison de deux horloges dans le code mcu, la fonction timer_is_before() doit toujours \u00eatre utilis\u00e9e pour s'assurer que les renversements d'entiers sont trait\u00e9s correctement. Le logiciel h\u00f4te convertit les horloges 32bit en horloges 64bit en ajoutant les bits de poids fort du dernier timestamp mcu qu'il a re\u00e7u - aucun message du mcu n'est jamais plus de 2^31 ticks d'horloge dans le futur ou le pass\u00e9, donc cette conversion n'est jamais ambigu\u00eb. L'h\u00f4te convertit les horloges de 64 bits en horloges de 32 bits en tronquant simplement les bits de poids fort. Pour s'assurer qu'il n'y a pas d'ambigu\u00eft\u00e9 dans cette conversion, le code klippy/chelper/serialqueue.c mettra en m\u00e9moire tampon les messages jusqu'\u00e0 ce qu'ils soient dans les 2^31 ticks d'horloge de leur temps cible. Microcontr\u00f4leurs multiples : Le logiciel h\u00f4te permet d'utiliser plusieurs microcontr\u00f4leurs sur une seule imprimante. Dans ce cas, l'\"horloge MCU\" de chaque microcontr\u00f4leur est suivie s\u00e9par\u00e9ment. Le code clocksync.py g\u00e8re la d\u00e9rive de l'horloge entre les micro-contr\u00f4leurs en modifiant la fa\u00e7on dont il convertit le \"temps d'impression\" en \"horloge MCU\". Sur les mcus secondaires, la fr\u00e9quence du mcu utilis\u00e9e dans cette conversion est r\u00e9guli\u00e8rement mise \u00e0 jour pour tenir compte de la d\u00e9rive mesur\u00e9e.","title":"Temporisation"},{"location":"Command_Templates.html","text":"Mod\u00e8les de commandes \u00b6 Ce document fournit des informations sur l'impl\u00e9mentation des s\u00e9quences de commandes G-Code dans les sections de configuration gcode_macro (et similaires). Nommage des macros de G-code \u00b6 La casse n'est pas importante pour le nom de la macro G-Code - MA_MACRO et ma_macro \u00e9valueront la m\u00eame chose et peuvent \u00eatre appel\u00e9es en majuscules ou en minuscules. Si des nombres sont utilis\u00e9s dans le nom de la macro, ils doivent tous se trouver \u00e0 la fin du nom (par exemple, TEST_MACRO25 est valide, mais MACRO25_TEST3 ne l'est pas). Formatage du G-Code dans la config \u00b6 L'indentation est importante lors de la d\u00e9finition d'une macro dans le fichier de configuration. Pour sp\u00e9cifier une s\u00e9quence G-Code multiligne, il est important que chaque ligne ait une indentation appropri\u00e9e. Par exemple\u202f: [gcode_macro blink_led] gcode: SET_PIN PIN=my_led VALUE=1 G4 P2000 SET_PIN PIN=my_led VALUE=0 L'option de configuration gcode: commence toujours au d\u00e9but de la ligne et les lignes suivantes de la macro G-Code ne commencent jamais au d\u00e9but. Ajouter une description \u00e0 votre macro \u00b6 Pour vous aider \u00e0 identifier la fonctionnalit\u00e9, une courte description peut \u00eatre ajout\u00e9e. Ajoutez description\u202f: avec un texte court pour d\u00e9crire la fonctionnalit\u00e9. La valeur par d\u00e9faut est \"Macro G-Code\". Par exemple\u202f: [gcode_macro blink_led] description: Blink my_led one time gcode: SET_PIN PIN=my_led VALUE=1 G4 P2000 SET_PIN PIN=my_led VALUE=0 Le terminal affichera la description lorsque vous utiliserez la commande HELP ou la fonction de saisie semi-automatique. Enregistrer/Restaurer l'\u00e9tat pour les d\u00e9placements G-Code \u00b6 Le langage de commande G-Code peut \u00eatre difficile \u00e0 utiliser. Le m\u00e9canisme standard pour d\u00e9placer la t\u00eate d'outil se fait via la commande G1 (la commande G0 est un alias pour G1 et elle peut \u00eatre utilis\u00e9e \u00e0 la place de G1 et inversement). Cependant, cette commande repose sur la configuration \"G-Code parsing state\" d\u00e9finie par M82 , M83 , G90 , G91 , G92 et les commandes pr\u00e9c\u00e9dentes G1 . Lors de la cr\u00e9ation d'une macro G-Code, il est conseill\u00e9 de toujours d\u00e9finir explicitement l'\u00e9tat d'analyse du G-Code avant d'\u00e9mettre une commande G1 . (Sinon, il y a un risque que la commande G1 fasse une demande ind\u00e9sirable.) Une fa\u00e7on courante d'y parvenir consiste \u00e0 encapsuler les mouvements G1 avec SAVE_GCODE_STATE , G91 et RESTORE_GCODE_STATE . Par exemple\u202f: [gcode_macro MOVE_UP] gcode: SAVE_GCODE_STATE NAME=my_move_up_state G91 G1 Z10 F300 RESTORE_GCODE_STATE NAME=my_move_up_state La commande G91 place l'\u00e9tat d'analyse du G-Code en \"mode de d\u00e9placement relatif\" et la commande RESTORE_GCODE_STATE restaure l'\u00e9tat tel qu'il \u00e9tait avant d'entrer dans la macro. Veillez \u00e0 sp\u00e9cifier une vitesse explicite (via le param\u00e8tre F ) sur la premi\u00e8re commande G1 . Extension du mod\u00e8le \u00b6 La section de configuration gcode_macro gcode: est \u00e9valu\u00e9e \u00e0 l'aide du langage Jinja2. On peut \u00e9valuer des expressions au moment de l'ex\u00e9cution en les entourant des caract\u00e8res { } ou utiliser des instructions conditionnelles avec des commande entour\u00e9es par {% %} . Voir la documentation Jinja2 pour plus d'informations sur la syntaxe. Un exemple de macro complexe : [gcode_macro clean_nozzle] gcode: {% set wipe_count = 8 %} SAVE_GCODE_STATE NAME=clean_nozzle_state G90 G0 Z15 F300 {% for wipe in range(wipe_count) %} {% for coordinate in [(275, 4),(235, 4)] %} G0 X{coordinate[0]} Y{coordinate[1] + 0.25 * wipe} Z9.7 F12000 {% endfor %} {% endfor %} RESTORE_GCODE_STATE NAME=clean_nozzle_state Param\u00e8tres de macro \u00b6 Il est souvent utile d'inspecter les param\u00e8tres pass\u00e9s \u00e0 la macro lorsqu'elle est appel\u00e9e. Ces param\u00e8tres sont disponibles via la pseudo-variable params . Par exemple, si la macro : [gcode_macro SET_PERCENT] gcode: M117 Now at { params.VALUE|float * 100 }% a \u00e9t\u00e9 appel\u00e9 avec SET_PERCENT VALUE=.2 , il sera \u00e9valu\u00e9 \u00e0 M117 Maintenant \u00e0 20 % . Les noms de param\u00e8tres sont toujours en majuscules lorsqu'ils sont \u00e9valu\u00e9s dans la macro et sont toujours transmis sous forme de cha\u00eenes. Si vous effectuez des calculs, ils doivent \u00eatre explicitement convertis en nombres entiers ou flottants. Il est courant d'utiliser la directive Jinja2 set pour affecter un param\u00e8tre \u00e0 une variable locale. Par exemple\u202f: [gcode_macro SET_BED_TEMPERATURE] gcode: {% set bed_temp = params.TEMPERATURE|default(40)|float %} M140 S{bed_temp} La variable \"rawparams\" \u00b6 Les param\u00e8tres complets non analys\u00e9s pour la macro en cours d'ex\u00e9cution sont accessibles via la pseudo-variable rawparams . Notez que cela inclura tous les commentaires qui faisaient partie de la commande d'origine. Voir le fichier sample-macros.cfg pour un exemple montrant comment remplacer la commande M117 \u00e0 l'aide de rawparams . La variable \"printer\" \u00b6 Il est possible d'inspecter (et de modifier) l'\u00e9tat actuel de l'imprimante via la pseudo-variable printer . Par exemple\u202f: [gcode_macro slow_fan] gcode: M106 S{ printer.fan.speed * 0.9 * 255} Les champs disponibles sont d\u00e9finis dans le document Status Reference . Important\u202f! Les macros sont d'abord \u00e9valu\u00e9es dans leur int\u00e9gralit\u00e9 et ce n'est qu'ensuite que les commandes r\u00e9sultantes sont ex\u00e9cut\u00e9es. Si une macro \u00e9met une commande qui modifie l'\u00e9tat de l'imprimante, les r\u00e9sultats de ce changement d'\u00e9tat ne seront pas visibles lors de l'\u00e9valuation de la macro. Cela peut \u00e9galement entra\u00eener un comportement subtil lorsqu'une macro g\u00e9n\u00e8re des commandes qui appellent d'autres macros, car la macro appel\u00e9e est \u00e9valu\u00e9e lorsqu'elle est invoqu\u00e9e (c'est-\u00e0-dire apr\u00e8s l'\u00e9valuation compl\u00e8te de la macro appelante). Par convention, le nom suivant imm\u00e9diatement printer est le nom d'une section de configuration. Ainsi, par exemple, printer.fan fait r\u00e9f\u00e9rence \u00e0 l'objet ventilateur cr\u00e9\u00e9 par la section de configuration [fan] . Il existe quelques exceptions \u00e0 cette r\u00e8gle, notamment les objets gcode_move et toolhead . Si la section de configuration contient des espaces, on peut y acc\u00e9der via l'accesseur [ ] - par exemple : printer[\"generic_heater my_chamber_heater\"].temperature . Notez que la directive Jinja2 set permet d'affecter un objet dans la hi\u00e9rarchie printer \u00e0 une variable locale. Cela peut rendre les macros plus lisibles et r\u00e9duire la saisie. Par exemple\u202f: [gcode_macro QUERY_HTU21D] gcode: {% set sensor = printer[\"htu21d my_sensor\"] %} M117 Temp:{sensor.temperature} Humidity:{sensor.humidity} Actions \u00b6 Certaines commandes disponibles peuvent modifier l'\u00e9tat de l'imprimante. Par exemple, { action_emergency_stop() } entra\u00eenera l'arr\u00eat de l'imprimante. Ces actions sont execut\u00e9es au moment o\u00f9 la macro est \u00e9valu\u00e9e, ce qui peut prendre beaucoup de temps avant que les commandes g-code g\u00e9n\u00e9r\u00e9es ne soient ex\u00e9cut\u00e9es. Commandes \"action\" disponibles : action_respond_info(msg) : affiche le msg donn\u00e9 dans le pseudo-terminal /tmp/printer. Chaque ligne de msg sera envoy\u00e9e avec un pr\u00e9fixe \"//\". action_raise_error(msg) : termine la macro actuelle (et toutes les macros appelantes) et \u00e9crit le msg donn\u00e9 sur le pseudo-terminal /tmp/printer. La premi\u00e8re ligne de msg sera envoy\u00e9e avec un pr\u00e9fixe \"!!\" et les lignes suivantes auront un pr\u00e9fixe \"//\". action_emergency_stop(msg) : Arr\u00eate l'imprimante. Le param\u00e8tre msg est facultatif, il peut \u00eatre utile de d\u00e9crire la raison de l'arr\u00eat. action_call_remote_method(method_name) : appelle une m\u00e9thode enregistr\u00e9e par un client distant. Si la m\u00e9thode prend des param\u00e8tres, ils doivent \u00eatre fournis via des arguments de mots-cl\u00e9s, c\u2019est-\u00e0-dire : action_call_remote_method(\u00ab print_stuff \u00bb, my_arg=\"hello_world \u00bb) Variables \u00b6 La commande SET_GCODE_VARIABLE peut \u00eatre utile pour enregistrer l'\u00e9tat entre les appels de macro. Les noms de variables ne doivent pas contenir de caract\u00e8res majuscules. Par exemple\u202f: [gcode_macro start_probe] variable_bed_temp: 0 gcode: # Save target temperature to bed_temp variable SET_GCODE_VARIABLE MACRO=start_probe VARIABLE=bed_temp VALUE={printer.heater_bed.target} # Disable bed heater M140 # Perform probe PROBE # Call finish_probe macro at completion of probe finish_probe [gcode_macro finish_probe] gcode: # Restore temperature M140 S{printer[\"gcode_macro start_probe\"].bed_temp} Assurez-vous de prendre en compte le moment de l'\u00e9valuation de la macro et de l'ex\u00e9cution de la commande lors de l'utilisation de SET_GCODE_VARIABLE. Gcodes retard\u00e9s \u00b6 L'option de configuration [delayed_gcode] peut \u00eatre utilis\u00e9e pour ex\u00e9cuter une s\u00e9quence gcode retard\u00e9e : [delayed_gcode clear_display] gcode: M117 [gcode_macro load_filament] gcode: G91 G1 E50 G90 M400 M117 Load Complete! UPDATE_DELAYED_GCODE ID=clear_display DURATION=10 Lorsque la macro load_filament ci-dessus s'ex\u00e9cute, elle affiche un message \"Load Complete!\" une fois l'extrusion termin\u00e9e. La derni\u00e8re ligne de gcode active le delay_gcode \"clear_display\", configur\u00e9 pour s'ex\u00e9cuter en 10 secondes. L'option de configuration initial_duration peut \u00eatre d\u00e9finie pour ex\u00e9cuter le delay_gcode au d\u00e9marrage de l'imprimante. Le compte \u00e0 rebours commence lorsque l'imprimante passe \u00e0 l'\u00e9tat \"pr\u00eat\". Par exemple, le delay_gcode ci-dessous s'ex\u00e9cutera 5 secondes apr\u00e8s que l'imprimante soit pr\u00eate, initialisant l'affichage avec \"Welcome!\" : [delayed_gcode welcome] initial_duration: 5. gcode: M117 Welcome! Il est possible qu'un gcode retard\u00e9 se r\u00e9p\u00e8te en le mettant \u00e0 jour dans l'option gcode : [delayed_gcode report_temp] initial_duration: 2. gcode: {action_respond_info(\"Extruder Temp: %.1f\" % (printer.extruder0.temperature))} UPDATE_DELAYED_GCODE ID=report_temp DURATION=2 Le delay_gcode ci-dessus enverra \"// Extruder Temp\u202f: [ex0_temp]\" \u00e0 Octoprint toutes les 2 secondes. Cela peut \u00eatre annul\u00e9 avec le gcode suivant\u202f: UPDATE_DELAYED_GCODE ID=report_temp DURATION=0 Mod\u00e8les de menus \u00b6 Si une section display_config est activ\u00e9e, il est alors possible de personnaliser le menu avec les sections de configuration menu . Les attributs en lecture seule suivants sont disponibles dans les mod\u00e8les de menu : menu.width - largeur de l\u2019\u00e9l\u00e9ment (nombre de colonnes d\u2019affichage) menu.ns - espace de noms de l'\u00e9l\u00e9ment menu.event - nom de l'\u00e9v\u00e9nement qui a d\u00e9clench\u00e9 le script menu.input - valeur d'entr\u00e9e, uniquement disponible dans le contexte du script d'entr\u00e9e Les actions suivantes sont disponibles dans les mod\u00e8les de menu : menu.back(force, update) : ex\u00e9cutera la commande de retour du menu, param\u00e8tres bool\u00e9ens facultatifs <force> et <update> . Lorsque <force> est d\u00e9fini sur True, l'\u00e9dition s'arr\u00eate \u00e9galement. La valeur par d\u00e9faut est False. Lorsque <update> est d\u00e9fini sur False, les \u00e9l\u00e9ments de conteneur parent ne sont pas mis \u00e0 jour. La valeur par d\u00e9faut est True. menu.exit(force) - ex\u00e9cutera la commande de sortie du menu, param\u00e8tre bool\u00e9en facultatif <force> valeur par d\u00e9faut False. Lorsque <force> est d\u00e9fini sur True, l'\u00e9dition s'arr\u00eate \u00e9galement. La valeur par d\u00e9faut est False. Enregistrer les variables sur le disque \u00b6 Si une section de configuration save_variables a \u00e9t\u00e9 activ\u00e9e, SAVE_VARIABLE VARIABLE=<name> VALUE=<value> peut \u00eatre utilis\u00e9 pour enregistrer la variable sur le disque afin qu'elle puisse \u00eatre utilis\u00e9e \u00e0 travers les red\u00e9marrages. Toutes les variables stock\u00e9es sont charg\u00e9es dans le dictionnaire printer.save_variables.variables au d\u00e9marrage et peuvent \u00eatre utilis\u00e9es dans les macros gcode. pour \u00e9viter les lignes trop longues, vous pouvez ajouter ce qui suit en haut de la macro : {% set svv = printer.save_variables.variables %} Par exemple, il pourrait \u00eatre utilis\u00e9 pour enregistrer l'\u00e9tat d'un extrudeur cyclope lors du d\u00e9marrage d'une impression, assurez-vous que l'extrudeuse active est utilis\u00e9e, au lieu de T0 : [gcode_macro T1] gcode: ACTIVATE_EXTRUDER extruder=extruder1 SAVE_VARIABLE VARIABLE=currentextruder VALUE='\"extruder1\"' [gcode_macro T0] gcode: ACTIVATE_EXTRUDER extruder=extruder SAVE_VARIABLE VARIABLE=currentextruder VALUE='\"extruder\"' [gcode_macro START_GCODE] gcode: {% set svv = printer.save_variables.variables %} ACTIVATE_EXTRUDER extruder={svv.currentextruder}","title":"Mod\u00e8les de commandes"},{"location":"Command_Templates.html#modeles-de-commandes","text":"Ce document fournit des informations sur l'impl\u00e9mentation des s\u00e9quences de commandes G-Code dans les sections de configuration gcode_macro (et similaires).","title":"Mod\u00e8les de commandes"},{"location":"Command_Templates.html#nommage-des-macros-de-g-code","text":"La casse n'est pas importante pour le nom de la macro G-Code - MA_MACRO et ma_macro \u00e9valueront la m\u00eame chose et peuvent \u00eatre appel\u00e9es en majuscules ou en minuscules. Si des nombres sont utilis\u00e9s dans le nom de la macro, ils doivent tous se trouver \u00e0 la fin du nom (par exemple, TEST_MACRO25 est valide, mais MACRO25_TEST3 ne l'est pas).","title":"Nommage des macros de G-code"},{"location":"Command_Templates.html#formatage-du-g-code-dans-la-config","text":"L'indentation est importante lors de la d\u00e9finition d'une macro dans le fichier de configuration. Pour sp\u00e9cifier une s\u00e9quence G-Code multiligne, il est important que chaque ligne ait une indentation appropri\u00e9e. Par exemple\u202f: [gcode_macro blink_led] gcode: SET_PIN PIN=my_led VALUE=1 G4 P2000 SET_PIN PIN=my_led VALUE=0 L'option de configuration gcode: commence toujours au d\u00e9but de la ligne et les lignes suivantes de la macro G-Code ne commencent jamais au d\u00e9but.","title":"Formatage du G-Code dans la config"},{"location":"Command_Templates.html#ajouter-une-description-a-votre-macro","text":"Pour vous aider \u00e0 identifier la fonctionnalit\u00e9, une courte description peut \u00eatre ajout\u00e9e. Ajoutez description\u202f: avec un texte court pour d\u00e9crire la fonctionnalit\u00e9. La valeur par d\u00e9faut est \"Macro G-Code\". Par exemple\u202f: [gcode_macro blink_led] description: Blink my_led one time gcode: SET_PIN PIN=my_led VALUE=1 G4 P2000 SET_PIN PIN=my_led VALUE=0 Le terminal affichera la description lorsque vous utiliserez la commande HELP ou la fonction de saisie semi-automatique.","title":"Ajouter une description \u00e0 votre macro"},{"location":"Command_Templates.html#enregistrerrestaurer-letat-pour-les-deplacements-g-code","text":"Le langage de commande G-Code peut \u00eatre difficile \u00e0 utiliser. Le m\u00e9canisme standard pour d\u00e9placer la t\u00eate d'outil se fait via la commande G1 (la commande G0 est un alias pour G1 et elle peut \u00eatre utilis\u00e9e \u00e0 la place de G1 et inversement). Cependant, cette commande repose sur la configuration \"G-Code parsing state\" d\u00e9finie par M82 , M83 , G90 , G91 , G92 et les commandes pr\u00e9c\u00e9dentes G1 . Lors de la cr\u00e9ation d'une macro G-Code, il est conseill\u00e9 de toujours d\u00e9finir explicitement l'\u00e9tat d'analyse du G-Code avant d'\u00e9mettre une commande G1 . (Sinon, il y a un risque que la commande G1 fasse une demande ind\u00e9sirable.) Une fa\u00e7on courante d'y parvenir consiste \u00e0 encapsuler les mouvements G1 avec SAVE_GCODE_STATE , G91 et RESTORE_GCODE_STATE . Par exemple\u202f: [gcode_macro MOVE_UP] gcode: SAVE_GCODE_STATE NAME=my_move_up_state G91 G1 Z10 F300 RESTORE_GCODE_STATE NAME=my_move_up_state La commande G91 place l'\u00e9tat d'analyse du G-Code en \"mode de d\u00e9placement relatif\" et la commande RESTORE_GCODE_STATE restaure l'\u00e9tat tel qu'il \u00e9tait avant d'entrer dans la macro. Veillez \u00e0 sp\u00e9cifier une vitesse explicite (via le param\u00e8tre F ) sur la premi\u00e8re commande G1 .","title":"Enregistrer/Restaurer l'\u00e9tat pour les d\u00e9placements G-Code"},{"location":"Command_Templates.html#extension-du-modele","text":"La section de configuration gcode_macro gcode: est \u00e9valu\u00e9e \u00e0 l'aide du langage Jinja2. On peut \u00e9valuer des expressions au moment de l'ex\u00e9cution en les entourant des caract\u00e8res { } ou utiliser des instructions conditionnelles avec des commande entour\u00e9es par {% %} . Voir la documentation Jinja2 pour plus d'informations sur la syntaxe. Un exemple de macro complexe : [gcode_macro clean_nozzle] gcode: {% set wipe_count = 8 %} SAVE_GCODE_STATE NAME=clean_nozzle_state G90 G0 Z15 F300 {% for wipe in range(wipe_count) %} {% for coordinate in [(275, 4),(235, 4)] %} G0 X{coordinate[0]} Y{coordinate[1] + 0.25 * wipe} Z9.7 F12000 {% endfor %} {% endfor %} RESTORE_GCODE_STATE NAME=clean_nozzle_state","title":"Extension du mod\u00e8le"},{"location":"Command_Templates.html#parametres-de-macro","text":"Il est souvent utile d'inspecter les param\u00e8tres pass\u00e9s \u00e0 la macro lorsqu'elle est appel\u00e9e. Ces param\u00e8tres sont disponibles via la pseudo-variable params . Par exemple, si la macro : [gcode_macro SET_PERCENT] gcode: M117 Now at { params.VALUE|float * 100 }% a \u00e9t\u00e9 appel\u00e9 avec SET_PERCENT VALUE=.2 , il sera \u00e9valu\u00e9 \u00e0 M117 Maintenant \u00e0 20 % . Les noms de param\u00e8tres sont toujours en majuscules lorsqu'ils sont \u00e9valu\u00e9s dans la macro et sont toujours transmis sous forme de cha\u00eenes. Si vous effectuez des calculs, ils doivent \u00eatre explicitement convertis en nombres entiers ou flottants. Il est courant d'utiliser la directive Jinja2 set pour affecter un param\u00e8tre \u00e0 une variable locale. Par exemple\u202f: [gcode_macro SET_BED_TEMPERATURE] gcode: {% set bed_temp = params.TEMPERATURE|default(40)|float %} M140 S{bed_temp}","title":"Param\u00e8tres de macro"},{"location":"Command_Templates.html#la-variable-rawparams","text":"Les param\u00e8tres complets non analys\u00e9s pour la macro en cours d'ex\u00e9cution sont accessibles via la pseudo-variable rawparams . Notez que cela inclura tous les commentaires qui faisaient partie de la commande d'origine. Voir le fichier sample-macros.cfg pour un exemple montrant comment remplacer la commande M117 \u00e0 l'aide de rawparams .","title":"La variable \"rawparams\""},{"location":"Command_Templates.html#la-variable-printer","text":"Il est possible d'inspecter (et de modifier) l'\u00e9tat actuel de l'imprimante via la pseudo-variable printer . Par exemple\u202f: [gcode_macro slow_fan] gcode: M106 S{ printer.fan.speed * 0.9 * 255} Les champs disponibles sont d\u00e9finis dans le document Status Reference . Important\u202f! Les macros sont d'abord \u00e9valu\u00e9es dans leur int\u00e9gralit\u00e9 et ce n'est qu'ensuite que les commandes r\u00e9sultantes sont ex\u00e9cut\u00e9es. Si une macro \u00e9met une commande qui modifie l'\u00e9tat de l'imprimante, les r\u00e9sultats de ce changement d'\u00e9tat ne seront pas visibles lors de l'\u00e9valuation de la macro. Cela peut \u00e9galement entra\u00eener un comportement subtil lorsqu'une macro g\u00e9n\u00e8re des commandes qui appellent d'autres macros, car la macro appel\u00e9e est \u00e9valu\u00e9e lorsqu'elle est invoqu\u00e9e (c'est-\u00e0-dire apr\u00e8s l'\u00e9valuation compl\u00e8te de la macro appelante). Par convention, le nom suivant imm\u00e9diatement printer est le nom d'une section de configuration. Ainsi, par exemple, printer.fan fait r\u00e9f\u00e9rence \u00e0 l'objet ventilateur cr\u00e9\u00e9 par la section de configuration [fan] . Il existe quelques exceptions \u00e0 cette r\u00e8gle, notamment les objets gcode_move et toolhead . Si la section de configuration contient des espaces, on peut y acc\u00e9der via l'accesseur [ ] - par exemple : printer[\"generic_heater my_chamber_heater\"].temperature . Notez que la directive Jinja2 set permet d'affecter un objet dans la hi\u00e9rarchie printer \u00e0 une variable locale. Cela peut rendre les macros plus lisibles et r\u00e9duire la saisie. Par exemple\u202f: [gcode_macro QUERY_HTU21D] gcode: {% set sensor = printer[\"htu21d my_sensor\"] %} M117 Temp:{sensor.temperature} Humidity:{sensor.humidity}","title":"La variable \"printer\""},{"location":"Command_Templates.html#actions","text":"Certaines commandes disponibles peuvent modifier l'\u00e9tat de l'imprimante. Par exemple, { action_emergency_stop() } entra\u00eenera l'arr\u00eat de l'imprimante. Ces actions sont execut\u00e9es au moment o\u00f9 la macro est \u00e9valu\u00e9e, ce qui peut prendre beaucoup de temps avant que les commandes g-code g\u00e9n\u00e9r\u00e9es ne soient ex\u00e9cut\u00e9es. Commandes \"action\" disponibles : action_respond_info(msg) : affiche le msg donn\u00e9 dans le pseudo-terminal /tmp/printer. Chaque ligne de msg sera envoy\u00e9e avec un pr\u00e9fixe \"//\". action_raise_error(msg) : termine la macro actuelle (et toutes les macros appelantes) et \u00e9crit le msg donn\u00e9 sur le pseudo-terminal /tmp/printer. La premi\u00e8re ligne de msg sera envoy\u00e9e avec un pr\u00e9fixe \"!!\" et les lignes suivantes auront un pr\u00e9fixe \"//\". action_emergency_stop(msg) : Arr\u00eate l'imprimante. Le param\u00e8tre msg est facultatif, il peut \u00eatre utile de d\u00e9crire la raison de l'arr\u00eat. action_call_remote_method(method_name) : appelle une m\u00e9thode enregistr\u00e9e par un client distant. Si la m\u00e9thode prend des param\u00e8tres, ils doivent \u00eatre fournis via des arguments de mots-cl\u00e9s, c\u2019est-\u00e0-dire : action_call_remote_method(\u00ab print_stuff \u00bb, my_arg=\"hello_world \u00bb)","title":"Actions"},{"location":"Command_Templates.html#variables","text":"La commande SET_GCODE_VARIABLE peut \u00eatre utile pour enregistrer l'\u00e9tat entre les appels de macro. Les noms de variables ne doivent pas contenir de caract\u00e8res majuscules. Par exemple\u202f: [gcode_macro start_probe] variable_bed_temp: 0 gcode: # Save target temperature to bed_temp variable SET_GCODE_VARIABLE MACRO=start_probe VARIABLE=bed_temp VALUE={printer.heater_bed.target} # Disable bed heater M140 # Perform probe PROBE # Call finish_probe macro at completion of probe finish_probe [gcode_macro finish_probe] gcode: # Restore temperature M140 S{printer[\"gcode_macro start_probe\"].bed_temp} Assurez-vous de prendre en compte le moment de l'\u00e9valuation de la macro et de l'ex\u00e9cution de la commande lors de l'utilisation de SET_GCODE_VARIABLE.","title":"Variables"},{"location":"Command_Templates.html#gcodes-retardes","text":"L'option de configuration [delayed_gcode] peut \u00eatre utilis\u00e9e pour ex\u00e9cuter une s\u00e9quence gcode retard\u00e9e : [delayed_gcode clear_display] gcode: M117 [gcode_macro load_filament] gcode: G91 G1 E50 G90 M400 M117 Load Complete! UPDATE_DELAYED_GCODE ID=clear_display DURATION=10 Lorsque la macro load_filament ci-dessus s'ex\u00e9cute, elle affiche un message \"Load Complete!\" une fois l'extrusion termin\u00e9e. La derni\u00e8re ligne de gcode active le delay_gcode \"clear_display\", configur\u00e9 pour s'ex\u00e9cuter en 10 secondes. L'option de configuration initial_duration peut \u00eatre d\u00e9finie pour ex\u00e9cuter le delay_gcode au d\u00e9marrage de l'imprimante. Le compte \u00e0 rebours commence lorsque l'imprimante passe \u00e0 l'\u00e9tat \"pr\u00eat\". Par exemple, le delay_gcode ci-dessous s'ex\u00e9cutera 5 secondes apr\u00e8s que l'imprimante soit pr\u00eate, initialisant l'affichage avec \"Welcome!\" : [delayed_gcode welcome] initial_duration: 5. gcode: M117 Welcome! Il est possible qu'un gcode retard\u00e9 se r\u00e9p\u00e8te en le mettant \u00e0 jour dans l'option gcode : [delayed_gcode report_temp] initial_duration: 2. gcode: {action_respond_info(\"Extruder Temp: %.1f\" % (printer.extruder0.temperature))} UPDATE_DELAYED_GCODE ID=report_temp DURATION=2 Le delay_gcode ci-dessus enverra \"// Extruder Temp\u202f: [ex0_temp]\" \u00e0 Octoprint toutes les 2 secondes. Cela peut \u00eatre annul\u00e9 avec le gcode suivant\u202f: UPDATE_DELAYED_GCODE ID=report_temp DURATION=0","title":"Gcodes retard\u00e9s"},{"location":"Command_Templates.html#modeles-de-menus","text":"Si une section display_config est activ\u00e9e, il est alors possible de personnaliser le menu avec les sections de configuration menu . Les attributs en lecture seule suivants sont disponibles dans les mod\u00e8les de menu : menu.width - largeur de l\u2019\u00e9l\u00e9ment (nombre de colonnes d\u2019affichage) menu.ns - espace de noms de l'\u00e9l\u00e9ment menu.event - nom de l'\u00e9v\u00e9nement qui a d\u00e9clench\u00e9 le script menu.input - valeur d'entr\u00e9e, uniquement disponible dans le contexte du script d'entr\u00e9e Les actions suivantes sont disponibles dans les mod\u00e8les de menu : menu.back(force, update) : ex\u00e9cutera la commande de retour du menu, param\u00e8tres bool\u00e9ens facultatifs <force> et <update> . Lorsque <force> est d\u00e9fini sur True, l'\u00e9dition s'arr\u00eate \u00e9galement. La valeur par d\u00e9faut est False. Lorsque <update> est d\u00e9fini sur False, les \u00e9l\u00e9ments de conteneur parent ne sont pas mis \u00e0 jour. La valeur par d\u00e9faut est True. menu.exit(force) - ex\u00e9cutera la commande de sortie du menu, param\u00e8tre bool\u00e9en facultatif <force> valeur par d\u00e9faut False. Lorsque <force> est d\u00e9fini sur True, l'\u00e9dition s'arr\u00eate \u00e9galement. La valeur par d\u00e9faut est False.","title":"Mod\u00e8les de menus"},{"location":"Command_Templates.html#enregistrer-les-variables-sur-le-disque","text":"Si une section de configuration save_variables a \u00e9t\u00e9 activ\u00e9e, SAVE_VARIABLE VARIABLE=<name> VALUE=<value> peut \u00eatre utilis\u00e9 pour enregistrer la variable sur le disque afin qu'elle puisse \u00eatre utilis\u00e9e \u00e0 travers les red\u00e9marrages. Toutes les variables stock\u00e9es sont charg\u00e9es dans le dictionnaire printer.save_variables.variables au d\u00e9marrage et peuvent \u00eatre utilis\u00e9es dans les macros gcode. pour \u00e9viter les lignes trop longues, vous pouvez ajouter ce qui suit en haut de la macro : {% set svv = printer.save_variables.variables %} Par exemple, il pourrait \u00eatre utilis\u00e9 pour enregistrer l'\u00e9tat d'un extrudeur cyclope lors du d\u00e9marrage d'une impression, assurez-vous que l'extrudeuse active est utilis\u00e9e, au lieu de T0 : [gcode_macro T1] gcode: ACTIVATE_EXTRUDER extruder=extruder1 SAVE_VARIABLE VARIABLE=currentextruder VALUE='\"extruder1\"' [gcode_macro T0] gcode: ACTIVATE_EXTRUDER extruder=extruder SAVE_VARIABLE VARIABLE=currentextruder VALUE='\"extruder\"' [gcode_macro START_GCODE] gcode: {% set svv = printer.save_variables.variables %} ACTIVATE_EXTRUDER extruder={svv.currentextruder}","title":"Enregistrer les variables sur le disque"},{"location":"Config_Changes.html","text":"Changements de configuration \u00b6 Ce document couvre les modifications logicielles apport\u00e9es au fichier de configuration qui ne sont pas r\u00e9tro compatibles. Il est conseill\u00e9 de consulter ce document lors de la mise \u00e0 jour du logiciel Klipper. Toutes les dates de ce document sont approximatives. Changements \u00b6 20230201: The [bed_mesh] module no longer loads the default profile on startup. It is recommended that users who use the default profile add BED_MESH_PROFILE LOAD=default to their START_PRINT macro (or to their slicer's \"Start G-Code\" configuration when applicable). 20230103: It is now possible with the flash-sdcard.sh script to flash both variants of the Bigtreetech SKR-2, STM32F407 and STM32F429. This means that the original tag of btt-skr2 now has changed to either btt-skr-2-f407 or btt-skr-2-f429. 20221128: Klipper v0.11.0 released. 20221122 : Auparavant, avec safe_z_home, il \u00e9tait possible que le z_hop apr\u00e8s la mise \u00e0 l'origine g28 aille dans une direction z n\u00e9gative. Maintenant, un saut en z n'est effectu\u00e9 apr\u00e8s g28 que s'il r\u00e9sulte en un saut positif, refl\u00e9tant le comportement du saut en z se produisant avant la mise \u00e0 l'origine g28. 20220616 : Il \u00e9tait auparavant possible de flasher un rp2040 en mode bootloader en ex\u00e9cutant make flash FLASH_DEVICE=first . La commande \u00e9quivalente est maintenant make flash FLASH_DEVICE=2e8a:0003 . 20220612 : Le micro-contr\u00f4leur rp2040 a maintenant une solution de contournement pour l'errata USB \"rp2040-e5\". Cela devrait rendre les premi\u00e8res connexions USB plus fiables. Cependant, cela peut entra\u00eener un changement de comportement de la broche gpio15. Il est peu probable que le changement de comportement de la gpio15 soit perceptible. 20220407 : L'option de configuration pid_integral_max de temperature_fan a \u00e9t\u00e9 supprim\u00e9e (elle \u00e9tait obsol\u00e8te depuis 20210612). 20220407 : L'ordre des couleurs par d\u00e9faut pour les LEDs pca9632 est maintenant \"RGBW\". Ajoutez un param\u00e8tre explicite color_order : RBGW \u00e0 la section pca9632 config pour obtenir le comportement pr\u00e9c\u00e9dent. 20220330 : Le format des informations d'\u00e9tat printer.neopixel.color_data des modules neopixel et dotstar a chang\u00e9. L'information est maintenant stock\u00e9e comme une liste de listes de couleurs (au lieu d'une liste de dictionnaires). Voir la r\u00e9f\u00e9rence d'\u00e9tat pour plus de d\u00e9tails. 20220307 : M73 ne mettra plus la progression de l'impression \u00e0 0 si P est absent. 20220304 : Il n'y a plus de valeur par d\u00e9faut pour le param\u00e8tre extruder des sections de configuration extruder_stepper . Si vous le souhaitez, sp\u00e9cifiez explicitement extruder : extruder pour associer le moteur pas \u00e0 pas \u00e0 la file d'attente de mouvement \"extruder\" au d\u00e9marrage. 20220210 : La commande SYNC_STEPPER_TO_EXTRUDER est obsol\u00e8te ; la commande SET_EXTRUDER_STEP_DISTANCE est obsol\u00e8te ; l'option de configuration shared_heater de l' extrudeuse est obsol\u00e8te. Ces fonctionnalit\u00e9s seront supprim\u00e9es dans un futur proche. Remplacez SET_EXTRUDER_STEP_DISTANCE par SET_EXTRUDER_ROTATION_DISTANCE . Remplacez SYNC_STEPPER_TO_EXTRUDER par SYNC_EXTRUDER_MOTION . Remplacez les sections de configuration de l'extrudeuse utilisant shared_heater par les sections de configuration extruder_stepper et mettez \u00e0 jour toutes les macros d'activation pour utiliser SYNC_EXTRUDER_MOTION . 20220116 : Le code de calcul run_current des tmc2130, tmc2208, tmc2209, et tmc2660 a chang\u00e9. Pour certains param\u00e8tres run_current les pilotes peuvent maintenant \u00eatre configur\u00e9s diff\u00e9remment. Cette nouvelle configuration devrait \u00eatre plus pr\u00e9cise, mais elle peut invalider les r\u00e9glages pr\u00e9c\u00e9dents des pilotes tmc. 20211230 : Les scripts pour ajuster le fa\u00e7onneur d'entr\u00e9e ( scripts/calibrate_shaper.py et scripts/graph_accelerometer.py ) ont \u00e9t\u00e9 migr\u00e9s pour utiliser Python3 par d\u00e9faut. Par cons\u00e9quent, les utilisateurs doivent installer les versions Python3 de certains paquets (par exemple, sudo apt install python3-numpy python3-matplotlib ) pour continuer \u00e0 utiliser ces scripts. Pour plus de d\u00e9tails, reportez-vous \u00e0 Installation du logiciel . Alternativement, les utilisateurs peuvent temporairement forcer l'ex\u00e9cution de ces scripts sous Python 2 en appelant explicitement l'interpr\u00e9teur Python2 dans la console : python2 ~/klipper/scripts/calibrate_shaper.py ... 20211110 : Le capteur de temp\u00e9rature \"NTC 100K beta 3950\" est d\u00e9pr\u00e9ci\u00e9. Ce capteur sera supprim\u00e9 dans un avenir proche. La plupart des utilisateurs trouveront le capteur de temp\u00e9rature \"Generic 3950\" plus pr\u00e9cis. Pour continuer \u00e0 utiliser l'ancienne d\u00e9finition (g\u00e9n\u00e9ralement moins pr\u00e9cise), d\u00e9finissez une thermistance personnalis\u00e9e avec temp\u00e9rature1 : 25 , r\u00e9sistance1 : 100000 , et beta : 3950 . 20211104 : L'option \"step pulse duration\" dans \"make menuconfig\" a \u00e9t\u00e9 supprim\u00e9e. La dur\u00e9e d'impulsion par d\u00e9faut pour les pilotes TMC configur\u00e9s en mode UART ou SPI est maintenant de 100ns. Un nouveau param\u00e8tre step_pulse_duration dans la section configuration des moteurs doit \u00eatre d\u00e9fini pour tous les moteurs n\u00e9cessitant une dur\u00e9e d'impulsion personnalis\u00e9e. 20211102 : Plusieurs fonctionnalit\u00e9s obsol\u00e8tes ont \u00e9t\u00e9 supprim\u00e9es. L'option step_distance du stepper a \u00e9t\u00e9 supprim\u00e9e (obsol\u00e8te depuis 20201222). L'alias du capteur rpi_temperature a \u00e9t\u00e9 supprim\u00e9 (obsol\u00e8te depuis 20210219). L'option mcu pin_map a \u00e9t\u00e9 supprim\u00e9e (obsol\u00e8te depuis 20210325). L'option gcode_macro default_parameter_<name> et l'acc\u00e8s aux param\u00e8tres de commande par la macro autrement que par la pseudo-variable params ont \u00e9t\u00e9 supprim\u00e9s (obsol\u00e8te depuis 20210503). L'option heater pid_integral_max a \u00e9t\u00e9 supprim\u00e9e (obsol\u00e8te le 20210612). 20210929 : Sortie de Klipper v0.10.0. 20210903 : La valeur par d\u00e9faut de smooth_time pour les \u00e9l\u00e9ments chauffants est pass\u00e9e \u00e0 1 seconde (au lieu de 2 secondes). Pour la plupart des imprimantes, cela permettra un contr\u00f4le plus stable de la temp\u00e9rature. 20210830 : Le nom par d\u00e9faut de adxl345 est maintenant \"adxl345\". Le param\u00e8tre CHIP par d\u00e9faut pour les fonctions ACCELEROMETER_MEASURE et ACCELEROMETER_QUERY est maintenant aussi \"adxl345\". 20210830 : La commande adxl345 ACCELEROMETER_MEASURE ne prend plus en charge un param\u00e8tre RATE. Pour modifier le taux d'interrogation, mettez \u00e0 jour le fichier printer.cfg et lancez une commande RESTART. 20210821 : Plusieurs param\u00e8tres de configuration dans printer.configfile.settings seront maintenant rapport\u00e9s sous forme de listes au lieu de cha\u00eenes brutes. Si vous souhaitez obtenir une cha\u00eene de caract\u00e8res brute, utilisez printer.configfile.config \u00e0 la place. 20210819 : Dans certains cas, un mouvement de retour \u00e0 l'origine G28 peut se terminer dans une position qui est nominalement en dehors de la plage de mouvement valide. Dans de rares situations, cela peut entra\u00eener des erreurs d\u00e9routantes \"Move out of range\" apr\u00e8s le retour \u00e0 la position initiale. Si cela se produit, modifiez vos scripts de d\u00e9marrage pour d\u00e9placer la t\u00eate d'outil vers une position valide imm\u00e9diatement apr\u00e8s le retour \u00e0 la position initiale. 20210814 : Les pseudo-pins analogiques sur l'atmega168 et l'atmega328 ont \u00e9t\u00e9 renomm\u00e9s de PE0/PE1 \u00e0 PE2/PE3. 20210720 : Une section controller_fan surveille maintenant tous les moteurs pas \u00e0 pas par d\u00e9faut (pas seulement les moteurs pas \u00e0 pas cin\u00e9matiques). Si le comportement pr\u00e9c\u00e9dent est souhait\u00e9, voir l'option de configuration stepper dans la r\u00e9f\u00e9rence de configuration . 20210703 : Une section de configuration samd_sercom doit maintenant sp\u00e9cifier le bus sercom qu'elle configure via l'option sercom . 20210612 : l'option de configuration pid_integral_max dans les sections heater et temperature_fan est obsol\u00e8te. Cette option sera supprim\u00e9e dans les prochaines versions. 20210503: The gcode_macro default_parameter_<name> config option is deprecated. Use the params pseudo-variable to access macro parameters. Other methods for accessing macro parameters will be removed in the near future. Most users can replace a default_parameter_NAME: VALUE config option with a line like the following in the start of the macro: {% set NAME = params.NAME|default(VALUE)|float %} . See the Command Templates document for examples. 20210430 : la commande SET_VELOCITY_LIMIT (et M204) peuvent maintenant d\u00e9finir une \"velocity\", \"acceleration\", et \"square_corner_velocity\" sup\u00e9rieurs aux valeurs sp\u00e9cifi\u00e9es dans le fichier de configuration. 20210325 : La prise en charge de l'option de configuration pin_map est obsol\u00e8te. Utilisez le fichier sample-aliases.cfg pour traduire les noms des broches r\u00e9elles du microcontr\u00f4leur. L'option de configuration pin_map sera supprim\u00e9e dans les prochaines version. 20210313 : La prise en charge de Klipper pour les microcontr\u00f4leurs CAN bus a \u00e9t\u00e9 modifi\u00e9e. Si vous utilisez CANBus, tous les microcontr\u00f4leurs doivent \u00eatre reflash\u00e9s et le fichier de configuration de Klipper doit \u00eatre mise \u00e0 jour . 20210310 : la valeur par d\u00e9faut de driver_SFILT pour les TMC2660 a \u00e9t\u00e9 modifi\u00e9e : passage de 1 \u00e0 0 par d\u00e9faut. 20210227 : Les pilotes de moteur pas \u00e0 pas TMC en mode UART ou SPI sont d\u00e9sormais interrog\u00e9s une fois par seconde si ils sont activ\u00e9s - si le pilote ne peut pas \u00eatre contact\u00e9 ou si le pilote signale une erreur, alors Klipper passera \u00e0 un \u00e9tat d'arr\u00eat. 20210219 : Le module rpi_temperature a \u00e9t\u00e9 renomm\u00e9 en temperature_host . Remplacez toutes les occurrences de sensor_type : rpi_temperature par sensor_type : temperature_host . Le chemin vers le fichier de temp\u00e9rature peut \u00eatre sp\u00e9cifi\u00e9 dans la variable de configuration sensor_path . Le nom rpi_temperature est obsol\u00e8te et sera supprim\u00e9 dans les prochaines versions. 20210201: La commande TEST_RESONANCES va maintenant d\u00e9sactiver la mise en forme des entr\u00e9es si elle \u00e9tait pr\u00e9c\u00e9demment activ\u00e9e (et la r\u00e9activer apr\u00e8s le test). Afin d'outrepasser ce comportement et de garder la mise en forme de l'entr\u00e9e activ\u00e9e, on peut passer un param\u00e8tre suppl\u00e9mentaire INPUT_SHAPING=1 \u00e0 la commande. 20210201 : La commande ACCELEROMETER_MEASURE ajoutera d\u00e9sormais le nom de la puce acc\u00e9l\u00e9rom\u00e8tre au nom du fichier de sortie si un nom a \u00e9t\u00e9 donn\u00e9 \u00e0 la puce dans la section adxl345 correspondante du printer.cfg. 20201222 : Le param\u00e8tre step_distance dans les sections de configuration de moteur est obsol\u00e8te. Il est conseill\u00e9 de mettre \u00e0 jour la configuration pour utiliser le param\u00e8tre rotation_distance . Le support de step_distance sera supprim\u00e9 dans un futur proche. 20201218 : Le param\u00e8tre endstop_phase du module endstop_phase a \u00e9t\u00e9 remplac\u00e9 par trigger_phase . Si vous utilisez le module endstop phases, il sera n\u00e9cessaire de convertir en rotation_distance et de recalibrer les phases endstop en ex\u00e9cutant la commande ENDSTOP_PHASE_CALIBRATE. 20201218 : Les imprimantes rotatives delta et polaires doivent maintenant sp\u00e9cifier un gear_ratio pour leurs moteurs rotatifs, et elles ne peuvent plus sp\u00e9cifier un param\u00e8tre step_distance . Voir la r\u00e9f\u00e9rence de configuration pour le format du nouveau param\u00e8tre gear_ratio. 20201213 : Il n'est pas valide de sp\u00e9cifier un Z \"position_endstop\" lors de l'utilisation de \"probe:z_virtual_endstop\". Une erreur sera maintenant soulev\u00e9e si un Z \"position_endstop\" est sp\u00e9cifi\u00e9 avec \"probe:z_virtual_endstop\". Supprimez la d\u00e9finition de Z \"position_endstop\" pour corriger l'erreur. 20201120 : La section de configuration [board_pins] sp\u00e9cifie maintenant le nom du mcu dans un param\u00e8tre explicite mcu: . Si vous utilisez board_pins pour un mcu secondaire, alors la config doit \u00eatre mise \u00e0 jour pour sp\u00e9cifier ce nom. Voir la r\u00e9f\u00e9rence config pour plus de d\u00e9tails. 20201112 : La dur\u00e9e rapport\u00e9e par print_stats.print_duration a chang\u00e9. La dur\u00e9e pr\u00e9c\u00e9dant la premi\u00e8re extrusion d\u00e9tect\u00e9e est maintenant exclue. 20201029 : L'option de configuration neopixel color_order_GRB a \u00e9t\u00e9 supprim\u00e9e. Si n\u00e9cessaire, mettez \u00e0 jour la configuration pour d\u00e9finir la nouvelle option color_order sur RGB, GRB, RGBW, ou GRBW. 20201029 : L'option serial dans la section mcu config ne prend plus par d\u00e9faut /dev/ttyS0. Dans la rare situation o\u00f9 /dev/ttyS0 est le port s\u00e9rie d\u00e9sir\u00e9, il doit \u00eatre indiqu\u00e9 explicitement. 20201020 : Sortie de Klipper v0.9.0. 20200902 : Le calcul de la r\u00e9sistance \u00e0 la temp\u00e9rature des RTD des convertisseurs MAX31865 a \u00e9t\u00e9 corrig\u00e9 pour ne pas lire une valeur basse. Si vous utilisez un tel dispositif, vous devez recalibrer votre temp\u00e9rature d'impression et vos param\u00e8tres PID. 20200816 : L'objet macro gcode printer.gcode a \u00e9t\u00e9 renomm\u00e9 en printer.gcode_move . Plusieurs variables non document\u00e9es dans printer.toolhead et printer.gcode ont \u00e9t\u00e9 supprim\u00e9es. Voir docs/Command_Templates.md pour une liste des variables de mod\u00e8les disponibles. 20200816 : Le syst\u00e8me de macro gcode \"action_\" a chang\u00e9. Remplacez tout appel \u00e0 printer.gcode.action_emergency_stop() par action_emergency_stop() , printer.gcode.action_respond_info() par action_respond_info() , et printer.gcode.action_respond_error() par action_raise_error() . 20200809 : Le syst\u00e8me de menu a \u00e9t\u00e9 r\u00e9\u00e9crit. Si le menu a \u00e9t\u00e9 personnalis\u00e9, il sera n\u00e9cessaire de le mettre \u00e0 jour avec la nouvelle configuration. Voir config/example-menu.cfg pour les d\u00e9tails de la configuration et voir klippy/extras/display/menu.cfg pour les exemples. 20200731 : Le comportement de l'attribut progress rapport\u00e9 par l'objet imprimante virtual_sdcard a chang\u00e9. La progression n'est plus remise \u00e0 0 lorsqu'une impression est mise en pause. La progression est maintenant toujours bas\u00e9e sur la position interne du fichier, ou 0 si aucun fichier n'est charg\u00e9. 20200725 : Le param\u00e8tre de configuration enable du servo et le param\u00e8tre SET_SERVO ENABLE ont \u00e9t\u00e9 supprim\u00e9s. Mettez \u00e0 jour toutes les macros pour utiliser SET_SERVO SERVO=my_servo WIDTH=0 pour d\u00e9sactiver un servo. 20200608 : Le support de l'affichage LCD a chang\u00e9 le nom de certains \"glyphes\" internes. Si une disposition d'affichage personnalis\u00e9e a \u00e9t\u00e9 impl\u00e9ment\u00e9e, il peut \u00eatre n\u00e9cessaire d'actualiser avec les noms actuels de glyphes (voir klippy/extras/display/display.cfg pour une liste des glyphes disponibles). 20200606 : Les noms des broches sur linux mcu ont chang\u00e9. Les broches ont maintenant des noms de la forme gpiochip<chipid>/gpio<gpio> . Pour gpiochip0 vous pouvez aussi utiliser un court gpio<gpio> . Par exemple, ce qui \u00e9tait pr\u00e9c\u00e9demment appel\u00e9 P20 devient maintenant gpio20 ou `gpiochip0/gpio20``. 20200603 : La disposition par d\u00e9faut de l'\u00e9cran LCD 16x4 n'affiche plus le temps estim\u00e9 restant pour une impression. (Seul le temps \u00e9coul\u00e9 sera affich\u00e9.) Si l'on souhaite conserver l'ancien comportement, on peut personnaliser l'affichage du menu avec cette information (voir la description de display_data dans config/example-extras.cfg pour plus de d\u00e9tails). 20200531 : L'id par d\u00e9faut du vendeur/produit USB est maintenant 0x1d50/0x614e. Ces nouveaux identifiants sont r\u00e9serv\u00e9s \u00e0 Klipper (gr\u00e2ce au projet openmoko). Ce changement ne devrait pas n\u00e9cessiter de modification de la configuration, mais les nouveaux identifiants peuvent appara\u00eetre dans les journaux syst\u00e8me. 20200524 : La valeur par d\u00e9faut du champ pwm_freq du tmc5160 est maintenant z\u00e9ro (au lieu de un). 20200425 : La variable du mod\u00e8le de commande gcode_macro printer.heater a \u00e9t\u00e9 renomm\u00e9e en printer.heaters . 20200313 : La disposition par d\u00e9faut de l'\u00e9cran pour les imprimantes multi-extrudeurs avec un \u00e9cran 16x4 a chang\u00e9. La disposition de l'\u00e9cran pour un seul extrudeur est maintenant la disposition par d\u00e9faut et elle montrera l'extrudeur actuellement actif. Pour utiliser la disposition d'\u00e9cran pr\u00e9c\u00e9dente, d\u00e9finissez \"display_group : _multiextruder_16x4\" dans la section [display] du fichier printer.cfg. 20200308 : L'\u00e9l\u00e9ment de menu par d\u00e9faut __test a \u00e9t\u00e9 supprim\u00e9. Si le fichier de configuration a un menu personnalis\u00e9, assurez-vous de supprimer toutes les r\u00e9f\u00e9rences \u00e0 cet \u00e9l\u00e9ment de menu __test . 20200308 : Les options \"deck\" et \"card\" du menu ont \u00e9t\u00e9 supprim\u00e9es. Pour personnaliser la disposition d'un \u00e9cran lcd, utilisez les nouvelles sections de configuration display_data (voir config/example-extras.cfg pour les d\u00e9tails). 20200109 : Le module bed_mesh fait d\u00e9sormais r\u00e9f\u00e9rence \u00e0 l'emplacement de la sonde pour la configuration du maillage. Ainsi, certaines options de configuration ont \u00e9t\u00e9 renomm\u00e9es pour mieux refl\u00e9ter leur fonctionnalit\u00e9. Pour les lits rectangulaires, min_point et max_point ont \u00e9t\u00e9 renomm\u00e9s en mesh_min et mesh_max respectivement. Pour les lits ronds, bed_radius a \u00e9t\u00e9 renomm\u00e9 en mesh_radius . Une nouvelle option mesh_origin a \u00e9galement \u00e9t\u00e9 ajout\u00e9e pour les lits ronds. Notez que ces changements sont \u00e9galement incompatibles avec les profils de maillage pr\u00e9c\u00e9demment enregistr\u00e9s. Si un profil incompatible est d\u00e9tect\u00e9, il sera ignor\u00e9 et sa suppression sera programm\u00e9e. Le processus de suppression peut \u00eatre achev\u00e9 en lan\u00e7ant la commande SAVE_CONFIG. L'utilisateur devra recalibrer chaque profil. 20191218 : La section de configuration de l'affichage ne prend plus en charge \"lcd_type : st7567\". Utilisez le type d'affichage \"uc1701\" \u00e0 la place - d\u00e9finissez \"lcd_type : uc1701\" et changez \"rs_pin : some_pin\" en \"rst_pin : some_pin\". Il peut \u00e9galement \u00eatre n\u00e9cessaire d'ajouter un param\u00e8tre de configuration \"contrast : 60\". 20191210 : Les commandes int\u00e9gr\u00e9es T0, T1, T2, ... ont \u00e9t\u00e9 supprim\u00e9es. Les options de configuration activate_gcode et deactivate_gcode de l'extrudeuse ont \u00e9t\u00e9 supprim\u00e9es. Si ces commandes (et scripts) sont n\u00e9cessaires, d\u00e9finissez des macros individuelles de type [gcode_macro T0] qui appellent la commande ACTIVATE_EXTRUDER. Voir les fichiers config/sample-idex.cfg et sample-multi-extruder.cfg pour des exemples. 20191210 : La prise en charge de la commande M206 a \u00e9t\u00e9 supprim\u00e9e. Remplacer par des appels \u00e0 SET_GCODE_OFFSET. Si le support de M206 est n\u00e9cessaire, ajoutez une section de configuration [gcode_macro M206] qui appelle SET_GCODE_OFFSET. (Par exemple \"SET_GCODE_OFFSET Z=-{params.Z}\".) 20191202 : La prise en charge du param\u00e8tre non document\u00e9 \"S\" de la commande \"G4\" a \u00e9t\u00e9 supprim\u00e9e. Remplacez toutes les occurrences de S par le param\u00e8tre standard \"P\" (le d\u00e9lai sp\u00e9cifi\u00e9 en millisecondes). 20191126 : Les noms USB ont chang\u00e9 sur les micro-contr\u00f4leurs avec un support USB natif. Ils utilisent d\u00e9sormais un identifiant de puce unique par d\u00e9faut (lorsqu'il est disponible). Si une section de configuration \"mcu\" utilise un param\u00e8tre \"serial\" qui commence par \"/dev/serial/by-id/\", il peut \u00eatre n\u00e9cessaire de mettre \u00e0 jour la configuration. Ex\u00e9cutez \"ls /dev/serial/by-id/*\" dans un terminal ssh pour d\u00e9terminer le nouvel identifiant. 20191121 : Le param\u00e8tre pressure_advance_lookahead_time a \u00e9t\u00e9 supprim\u00e9. Voir example.cfg pour d'autres param\u00e8tres de configuration. 20191112 : La capacit\u00e9 d'activation virtuelle du pilote de pas \u00e0 pas tmc est d\u00e9sormais automatiquement activ\u00e9e si le moteur pas \u00e0 pas ne poss\u00e8de pas de broche d'activation d\u00e9di\u00e9e. Supprimez les r\u00e9f\u00e9rences \u00e0 tmcXXXX:virtual_enable de la configuration. La possibilit\u00e9 de contr\u00f4ler plusieurs broches dans la configuration enable_pin du moteur a \u00e9t\u00e9 supprim\u00e9e. Si plusieurs broches sont n\u00e9cessaires, utilisez une section de configuration multi_pin. 20191107 : La section de configuration de l'extrudeur primaire doit \u00eatre sp\u00e9cifi\u00e9e comme \"extruder\" et ne peut plus \u00eatre sp\u00e9cifi\u00e9e comme \"extruder0\". Les mod\u00e8les de commande Gcode qui interrogent le statut de l'extrudeur sont d\u00e9sormais accessibles via \"{printer.extruder}\". 20191021 : Sortie de Klipper v0.8.0 20191003 : L'option move_to_previous de [safe_z_homing] a d\u00e9sormais la valeur par d\u00e9faut False. (Elle \u00e9tait effectivement False avant 20190918.) 20190918 : L'option zhop de [safe_z_homing] est toujours r\u00e9appliqu\u00e9e apr\u00e8s la fin du homing sur l'axe Z. Cela peut obliger les utilisateurs \u00e0 mettre \u00e0 jour les scripts personnalis\u00e9s bas\u00e9s sur ce module. 20190806 : La commande SET_NEOPIXEL a \u00e9t\u00e9 renomm\u00e9e SET_LED. 20190726 : Le code num\u00e9rique-analogique du mcp4728 a \u00e9t\u00e9 modifi\u00e9. L'adresse i2c_address par d\u00e9faut est maintenant 0x60 et la r\u00e9f\u00e9rence de tension est maintenant relative \u00e0 la r\u00e9f\u00e9rence interne de 2,048 volts du mcp4728. 20190710 : L'option z_hop a \u00e9t\u00e9 supprim\u00e9e de la section de configuration [firmware_retract]. La prise en charge de z_hop \u00e9tait incompl\u00e8te et pouvait provoquer un comportement incorrect avec plusieurs trancheurs courants. 20190710 : Les param\u00e8tres optionnels de la commande PROBE_ACCURACY ont \u00e9t\u00e9 modifi\u00e9s. Il peut \u00eatre n\u00e9cessaire de mettre \u00e0 jour les macros ou les scripts qui utilisent cette commande. 20190628 : Toutes les options de configuration ont \u00e9t\u00e9 supprim\u00e9es de la section [skew_correction]. La configuration de la correction d'obliquit\u00e9 se fait d\u00e9sormais via le gcode SET_SKEW. Voir Correction de l'obliquit\u00e9 pour l'utilisation recommand\u00e9e. 20190607 : Les param\u00e8tres \"variable_X\" de gcode_macro (ainsi que le param\u00e8tre VALUE de SET_GCODE_VARIABLE) sont maintenant analys\u00e9s comme des litt\u00e9raux Python. Si une valeur doit \u00eatre assign\u00e9e \u00e0 une cha\u00eene de caract\u00e8res, mettez-la entre guillemets pour qu'elle soit \u00e9valu\u00e9e comme une cha\u00eene de caract\u00e8res. 20190606 : Les options de configuration \"samples\", \"samples_result\" et \"sample_retract_dist\" ont \u00e9t\u00e9 d\u00e9plac\u00e9es vers la section de configuration \"probe\". Ces options ne sont plus support\u00e9es dans les sections de configuration \"delta_calibrate\", \"bed_tilt\", \"bed_mesh\", \"screws_tilt_adjust\", \"z_tilt\", ou \"quad_gantry_level\". 20190528 : La variable magique \"status\" dans l'\u00e9valuation du mod\u00e8le gcode_macro a \u00e9t\u00e9 renomm\u00e9e en \"printer\". 20190520 : La commande SET_GCODE_OFFSET a \u00e9t\u00e9 modifi\u00e9e ; mettez \u00e0 jour vos macros de code G en cons\u00e9quence. La commande n'appliquera plus le d\u00e9calage demand\u00e9 \u00e0 la prochaine commande G1. L'ancien comportement peut \u00eatre approch\u00e9 en utilisant le nouveau param\u00e8tre \"MOVE=1\". 20190404 : Les paquets du logiciel h\u00f4te Python ont \u00e9t\u00e9 mis \u00e0 jour. Les utilisateurs devront r\u00e9ex\u00e9cuter le script ~/klipper/scripts/install-octopi.sh (ou mettre \u00e0 jour les d\u00e9pendances python s'ils n'utilisent pas une installation OctoPi standard). 20190404 : Les param\u00e8tres i2c_bus et spi_bus (dans diverses sections de configuration) prennent d\u00e9sormais un nom de bus au lieu d'un num\u00e9ro. 20190404 : Les param\u00e8tres de configuration du sx1509 ont chang\u00e9. Le param\u00e8tre 'adresse' est maintenant 'i2c_address' et doit \u00eatre sp\u00e9cifi\u00e9 comme un nombre d\u00e9cimal. L\u00e0 o\u00f9 0x3E \u00e9tait pr\u00e9c\u00e9demment utilis\u00e9, sp\u00e9cifiez 62. 20190328 : La valeur min_speed dans la configuration [temperature_fan] sera d\u00e9sormais respect\u00e9e et le ventilateur fonctionnera toujours \u00e0 cette vitesse ou plus en mode PID. 20190322 : La valeur par d\u00e9faut de \"driver_HEND\" dans les sections de configuration [tmc2660] a \u00e9t\u00e9 modifi\u00e9e de 6 \u00e0 3. Le champ \"driver_VSENSE\" a \u00e9t\u00e9 supprim\u00e9 (il est d\u00e9sormais calcul\u00e9 automatiquement \u00e0 partir de run_current). 20190310 : La section de configuration [controller_fan] prend d\u00e9sormais toujours un nom (tel que [controller_fan my_controller_fan]). 20190308 : Le champ \"driver_BLANK_TIME_SELECT\" dans les sections de configuration [tmc2130] et [tmc2208] a \u00e9t\u00e9 renomm\u00e9 \"driver_TBL\". 20190308 : La section config [tmc2660] a \u00e9t\u00e9 modifi\u00e9e. Un nouveau param\u00e8tre de configuration sense_resistor doit maintenant \u00eatre fourni. La signification de plusieurs des param\u00e8tres driver_XXX a \u00e9t\u00e9 modifi\u00e9e. 20190228 : Les utilisateurs de SPI ou I2C sur les cartes SAMD21 doivent maintenant sp\u00e9cifier les broches du bus via une section de configuration [samd_sercom]. 20190224 : L'option bed_shape a \u00e9t\u00e9 supprim\u00e9e de bed_mesh. L'option radius a \u00e9t\u00e9 renomm\u00e9e bed_radius. Les utilisateurs avec des lits ronds doivent fournir les options bed_radius et round_probe_count. 20190107 : Le param\u00e8tre i2c_address de la section config du mcp4451 a \u00e9t\u00e9 modifi\u00e9. Il s'agit d'un param\u00e8tre courant sur les Smoothieboards. La nouvelle valeur est la moiti\u00e9 de l'ancienne valeur (88 doit \u00eatre chang\u00e9 en 44, et 90 doit \u00eatre chang\u00e9 en 45). 20181220 : Sortie de Klipper v0.7.0","title":"Changements de configuration"},{"location":"Config_Changes.html#changements-de-configuration","text":"Ce document couvre les modifications logicielles apport\u00e9es au fichier de configuration qui ne sont pas r\u00e9tro compatibles. Il est conseill\u00e9 de consulter ce document lors de la mise \u00e0 jour du logiciel Klipper. Toutes les dates de ce document sont approximatives.","title":"Changements de configuration"},{"location":"Config_Changes.html#changements","text":"20230201: The [bed_mesh] module no longer loads the default profile on startup. It is recommended that users who use the default profile add BED_MESH_PROFILE LOAD=default to their START_PRINT macro (or to their slicer's \"Start G-Code\" configuration when applicable). 20230103: It is now possible with the flash-sdcard.sh script to flash both variants of the Bigtreetech SKR-2, STM32F407 and STM32F429. This means that the original tag of btt-skr2 now has changed to either btt-skr-2-f407 or btt-skr-2-f429. 20221128: Klipper v0.11.0 released. 20221122 : Auparavant, avec safe_z_home, il \u00e9tait possible que le z_hop apr\u00e8s la mise \u00e0 l'origine g28 aille dans une direction z n\u00e9gative. Maintenant, un saut en z n'est effectu\u00e9 apr\u00e8s g28 que s'il r\u00e9sulte en un saut positif, refl\u00e9tant le comportement du saut en z se produisant avant la mise \u00e0 l'origine g28. 20220616 : Il \u00e9tait auparavant possible de flasher un rp2040 en mode bootloader en ex\u00e9cutant make flash FLASH_DEVICE=first . La commande \u00e9quivalente est maintenant make flash FLASH_DEVICE=2e8a:0003 . 20220612 : Le micro-contr\u00f4leur rp2040 a maintenant une solution de contournement pour l'errata USB \"rp2040-e5\". Cela devrait rendre les premi\u00e8res connexions USB plus fiables. Cependant, cela peut entra\u00eener un changement de comportement de la broche gpio15. Il est peu probable que le changement de comportement de la gpio15 soit perceptible. 20220407 : L'option de configuration pid_integral_max de temperature_fan a \u00e9t\u00e9 supprim\u00e9e (elle \u00e9tait obsol\u00e8te depuis 20210612). 20220407 : L'ordre des couleurs par d\u00e9faut pour les LEDs pca9632 est maintenant \"RGBW\". Ajoutez un param\u00e8tre explicite color_order : RBGW \u00e0 la section pca9632 config pour obtenir le comportement pr\u00e9c\u00e9dent. 20220330 : Le format des informations d'\u00e9tat printer.neopixel.color_data des modules neopixel et dotstar a chang\u00e9. L'information est maintenant stock\u00e9e comme une liste de listes de couleurs (au lieu d'une liste de dictionnaires). Voir la r\u00e9f\u00e9rence d'\u00e9tat pour plus de d\u00e9tails. 20220307 : M73 ne mettra plus la progression de l'impression \u00e0 0 si P est absent. 20220304 : Il n'y a plus de valeur par d\u00e9faut pour le param\u00e8tre extruder des sections de configuration extruder_stepper . Si vous le souhaitez, sp\u00e9cifiez explicitement extruder : extruder pour associer le moteur pas \u00e0 pas \u00e0 la file d'attente de mouvement \"extruder\" au d\u00e9marrage. 20220210 : La commande SYNC_STEPPER_TO_EXTRUDER est obsol\u00e8te ; la commande SET_EXTRUDER_STEP_DISTANCE est obsol\u00e8te ; l'option de configuration shared_heater de l' extrudeuse est obsol\u00e8te. Ces fonctionnalit\u00e9s seront supprim\u00e9es dans un futur proche. Remplacez SET_EXTRUDER_STEP_DISTANCE par SET_EXTRUDER_ROTATION_DISTANCE . Remplacez SYNC_STEPPER_TO_EXTRUDER par SYNC_EXTRUDER_MOTION . Remplacez les sections de configuration de l'extrudeuse utilisant shared_heater par les sections de configuration extruder_stepper et mettez \u00e0 jour toutes les macros d'activation pour utiliser SYNC_EXTRUDER_MOTION . 20220116 : Le code de calcul run_current des tmc2130, tmc2208, tmc2209, et tmc2660 a chang\u00e9. Pour certains param\u00e8tres run_current les pilotes peuvent maintenant \u00eatre configur\u00e9s diff\u00e9remment. Cette nouvelle configuration devrait \u00eatre plus pr\u00e9cise, mais elle peut invalider les r\u00e9glages pr\u00e9c\u00e9dents des pilotes tmc. 20211230 : Les scripts pour ajuster le fa\u00e7onneur d'entr\u00e9e ( scripts/calibrate_shaper.py et scripts/graph_accelerometer.py ) ont \u00e9t\u00e9 migr\u00e9s pour utiliser Python3 par d\u00e9faut. Par cons\u00e9quent, les utilisateurs doivent installer les versions Python3 de certains paquets (par exemple, sudo apt install python3-numpy python3-matplotlib ) pour continuer \u00e0 utiliser ces scripts. Pour plus de d\u00e9tails, reportez-vous \u00e0 Installation du logiciel . Alternativement, les utilisateurs peuvent temporairement forcer l'ex\u00e9cution de ces scripts sous Python 2 en appelant explicitement l'interpr\u00e9teur Python2 dans la console : python2 ~/klipper/scripts/calibrate_shaper.py ... 20211110 : Le capteur de temp\u00e9rature \"NTC 100K beta 3950\" est d\u00e9pr\u00e9ci\u00e9. Ce capteur sera supprim\u00e9 dans un avenir proche. La plupart des utilisateurs trouveront le capteur de temp\u00e9rature \"Generic 3950\" plus pr\u00e9cis. Pour continuer \u00e0 utiliser l'ancienne d\u00e9finition (g\u00e9n\u00e9ralement moins pr\u00e9cise), d\u00e9finissez une thermistance personnalis\u00e9e avec temp\u00e9rature1 : 25 , r\u00e9sistance1 : 100000 , et beta : 3950 . 20211104 : L'option \"step pulse duration\" dans \"make menuconfig\" a \u00e9t\u00e9 supprim\u00e9e. La dur\u00e9e d'impulsion par d\u00e9faut pour les pilotes TMC configur\u00e9s en mode UART ou SPI est maintenant de 100ns. Un nouveau param\u00e8tre step_pulse_duration dans la section configuration des moteurs doit \u00eatre d\u00e9fini pour tous les moteurs n\u00e9cessitant une dur\u00e9e d'impulsion personnalis\u00e9e. 20211102 : Plusieurs fonctionnalit\u00e9s obsol\u00e8tes ont \u00e9t\u00e9 supprim\u00e9es. L'option step_distance du stepper a \u00e9t\u00e9 supprim\u00e9e (obsol\u00e8te depuis 20201222). L'alias du capteur rpi_temperature a \u00e9t\u00e9 supprim\u00e9 (obsol\u00e8te depuis 20210219). L'option mcu pin_map a \u00e9t\u00e9 supprim\u00e9e (obsol\u00e8te depuis 20210325). L'option gcode_macro default_parameter_<name> et l'acc\u00e8s aux param\u00e8tres de commande par la macro autrement que par la pseudo-variable params ont \u00e9t\u00e9 supprim\u00e9s (obsol\u00e8te depuis 20210503). L'option heater pid_integral_max a \u00e9t\u00e9 supprim\u00e9e (obsol\u00e8te le 20210612). 20210929 : Sortie de Klipper v0.10.0. 20210903 : La valeur par d\u00e9faut de smooth_time pour les \u00e9l\u00e9ments chauffants est pass\u00e9e \u00e0 1 seconde (au lieu de 2 secondes). Pour la plupart des imprimantes, cela permettra un contr\u00f4le plus stable de la temp\u00e9rature. 20210830 : Le nom par d\u00e9faut de adxl345 est maintenant \"adxl345\". Le param\u00e8tre CHIP par d\u00e9faut pour les fonctions ACCELEROMETER_MEASURE et ACCELEROMETER_QUERY est maintenant aussi \"adxl345\". 20210830 : La commande adxl345 ACCELEROMETER_MEASURE ne prend plus en charge un param\u00e8tre RATE. Pour modifier le taux d'interrogation, mettez \u00e0 jour le fichier printer.cfg et lancez une commande RESTART. 20210821 : Plusieurs param\u00e8tres de configuration dans printer.configfile.settings seront maintenant rapport\u00e9s sous forme de listes au lieu de cha\u00eenes brutes. Si vous souhaitez obtenir une cha\u00eene de caract\u00e8res brute, utilisez printer.configfile.config \u00e0 la place. 20210819 : Dans certains cas, un mouvement de retour \u00e0 l'origine G28 peut se terminer dans une position qui est nominalement en dehors de la plage de mouvement valide. Dans de rares situations, cela peut entra\u00eener des erreurs d\u00e9routantes \"Move out of range\" apr\u00e8s le retour \u00e0 la position initiale. Si cela se produit, modifiez vos scripts de d\u00e9marrage pour d\u00e9placer la t\u00eate d'outil vers une position valide imm\u00e9diatement apr\u00e8s le retour \u00e0 la position initiale. 20210814 : Les pseudo-pins analogiques sur l'atmega168 et l'atmega328 ont \u00e9t\u00e9 renomm\u00e9s de PE0/PE1 \u00e0 PE2/PE3. 20210720 : Une section controller_fan surveille maintenant tous les moteurs pas \u00e0 pas par d\u00e9faut (pas seulement les moteurs pas \u00e0 pas cin\u00e9matiques). Si le comportement pr\u00e9c\u00e9dent est souhait\u00e9, voir l'option de configuration stepper dans la r\u00e9f\u00e9rence de configuration . 20210703 : Une section de configuration samd_sercom doit maintenant sp\u00e9cifier le bus sercom qu'elle configure via l'option sercom . 20210612 : l'option de configuration pid_integral_max dans les sections heater et temperature_fan est obsol\u00e8te. Cette option sera supprim\u00e9e dans les prochaines versions. 20210503: The gcode_macro default_parameter_<name> config option is deprecated. Use the params pseudo-variable to access macro parameters. Other methods for accessing macro parameters will be removed in the near future. Most users can replace a default_parameter_NAME: VALUE config option with a line like the following in the start of the macro: {% set NAME = params.NAME|default(VALUE)|float %} . See the Command Templates document for examples. 20210430 : la commande SET_VELOCITY_LIMIT (et M204) peuvent maintenant d\u00e9finir une \"velocity\", \"acceleration\", et \"square_corner_velocity\" sup\u00e9rieurs aux valeurs sp\u00e9cifi\u00e9es dans le fichier de configuration. 20210325 : La prise en charge de l'option de configuration pin_map est obsol\u00e8te. Utilisez le fichier sample-aliases.cfg pour traduire les noms des broches r\u00e9elles du microcontr\u00f4leur. L'option de configuration pin_map sera supprim\u00e9e dans les prochaines version. 20210313 : La prise en charge de Klipper pour les microcontr\u00f4leurs CAN bus a \u00e9t\u00e9 modifi\u00e9e. Si vous utilisez CANBus, tous les microcontr\u00f4leurs doivent \u00eatre reflash\u00e9s et le fichier de configuration de Klipper doit \u00eatre mise \u00e0 jour . 20210310 : la valeur par d\u00e9faut de driver_SFILT pour les TMC2660 a \u00e9t\u00e9 modifi\u00e9e : passage de 1 \u00e0 0 par d\u00e9faut. 20210227 : Les pilotes de moteur pas \u00e0 pas TMC en mode UART ou SPI sont d\u00e9sormais interrog\u00e9s une fois par seconde si ils sont activ\u00e9s - si le pilote ne peut pas \u00eatre contact\u00e9 ou si le pilote signale une erreur, alors Klipper passera \u00e0 un \u00e9tat d'arr\u00eat. 20210219 : Le module rpi_temperature a \u00e9t\u00e9 renomm\u00e9 en temperature_host . Remplacez toutes les occurrences de sensor_type : rpi_temperature par sensor_type : temperature_host . Le chemin vers le fichier de temp\u00e9rature peut \u00eatre sp\u00e9cifi\u00e9 dans la variable de configuration sensor_path . Le nom rpi_temperature est obsol\u00e8te et sera supprim\u00e9 dans les prochaines versions. 20210201: La commande TEST_RESONANCES va maintenant d\u00e9sactiver la mise en forme des entr\u00e9es si elle \u00e9tait pr\u00e9c\u00e9demment activ\u00e9e (et la r\u00e9activer apr\u00e8s le test). Afin d'outrepasser ce comportement et de garder la mise en forme de l'entr\u00e9e activ\u00e9e, on peut passer un param\u00e8tre suppl\u00e9mentaire INPUT_SHAPING=1 \u00e0 la commande. 20210201 : La commande ACCELEROMETER_MEASURE ajoutera d\u00e9sormais le nom de la puce acc\u00e9l\u00e9rom\u00e8tre au nom du fichier de sortie si un nom a \u00e9t\u00e9 donn\u00e9 \u00e0 la puce dans la section adxl345 correspondante du printer.cfg. 20201222 : Le param\u00e8tre step_distance dans les sections de configuration de moteur est obsol\u00e8te. Il est conseill\u00e9 de mettre \u00e0 jour la configuration pour utiliser le param\u00e8tre rotation_distance . Le support de step_distance sera supprim\u00e9 dans un futur proche. 20201218 : Le param\u00e8tre endstop_phase du module endstop_phase a \u00e9t\u00e9 remplac\u00e9 par trigger_phase . Si vous utilisez le module endstop phases, il sera n\u00e9cessaire de convertir en rotation_distance et de recalibrer les phases endstop en ex\u00e9cutant la commande ENDSTOP_PHASE_CALIBRATE. 20201218 : Les imprimantes rotatives delta et polaires doivent maintenant sp\u00e9cifier un gear_ratio pour leurs moteurs rotatifs, et elles ne peuvent plus sp\u00e9cifier un param\u00e8tre step_distance . Voir la r\u00e9f\u00e9rence de configuration pour le format du nouveau param\u00e8tre gear_ratio. 20201213 : Il n'est pas valide de sp\u00e9cifier un Z \"position_endstop\" lors de l'utilisation de \"probe:z_virtual_endstop\". Une erreur sera maintenant soulev\u00e9e si un Z \"position_endstop\" est sp\u00e9cifi\u00e9 avec \"probe:z_virtual_endstop\". Supprimez la d\u00e9finition de Z \"position_endstop\" pour corriger l'erreur. 20201120 : La section de configuration [board_pins] sp\u00e9cifie maintenant le nom du mcu dans un param\u00e8tre explicite mcu: . Si vous utilisez board_pins pour un mcu secondaire, alors la config doit \u00eatre mise \u00e0 jour pour sp\u00e9cifier ce nom. Voir la r\u00e9f\u00e9rence config pour plus de d\u00e9tails. 20201112 : La dur\u00e9e rapport\u00e9e par print_stats.print_duration a chang\u00e9. La dur\u00e9e pr\u00e9c\u00e9dant la premi\u00e8re extrusion d\u00e9tect\u00e9e est maintenant exclue. 20201029 : L'option de configuration neopixel color_order_GRB a \u00e9t\u00e9 supprim\u00e9e. Si n\u00e9cessaire, mettez \u00e0 jour la configuration pour d\u00e9finir la nouvelle option color_order sur RGB, GRB, RGBW, ou GRBW. 20201029 : L'option serial dans la section mcu config ne prend plus par d\u00e9faut /dev/ttyS0. Dans la rare situation o\u00f9 /dev/ttyS0 est le port s\u00e9rie d\u00e9sir\u00e9, il doit \u00eatre indiqu\u00e9 explicitement. 20201020 : Sortie de Klipper v0.9.0. 20200902 : Le calcul de la r\u00e9sistance \u00e0 la temp\u00e9rature des RTD des convertisseurs MAX31865 a \u00e9t\u00e9 corrig\u00e9 pour ne pas lire une valeur basse. Si vous utilisez un tel dispositif, vous devez recalibrer votre temp\u00e9rature d'impression et vos param\u00e8tres PID. 20200816 : L'objet macro gcode printer.gcode a \u00e9t\u00e9 renomm\u00e9 en printer.gcode_move . Plusieurs variables non document\u00e9es dans printer.toolhead et printer.gcode ont \u00e9t\u00e9 supprim\u00e9es. Voir docs/Command_Templates.md pour une liste des variables de mod\u00e8les disponibles. 20200816 : Le syst\u00e8me de macro gcode \"action_\" a chang\u00e9. Remplacez tout appel \u00e0 printer.gcode.action_emergency_stop() par action_emergency_stop() , printer.gcode.action_respond_info() par action_respond_info() , et printer.gcode.action_respond_error() par action_raise_error() . 20200809 : Le syst\u00e8me de menu a \u00e9t\u00e9 r\u00e9\u00e9crit. Si le menu a \u00e9t\u00e9 personnalis\u00e9, il sera n\u00e9cessaire de le mettre \u00e0 jour avec la nouvelle configuration. Voir config/example-menu.cfg pour les d\u00e9tails de la configuration et voir klippy/extras/display/menu.cfg pour les exemples. 20200731 : Le comportement de l'attribut progress rapport\u00e9 par l'objet imprimante virtual_sdcard a chang\u00e9. La progression n'est plus remise \u00e0 0 lorsqu'une impression est mise en pause. La progression est maintenant toujours bas\u00e9e sur la position interne du fichier, ou 0 si aucun fichier n'est charg\u00e9. 20200725 : Le param\u00e8tre de configuration enable du servo et le param\u00e8tre SET_SERVO ENABLE ont \u00e9t\u00e9 supprim\u00e9s. Mettez \u00e0 jour toutes les macros pour utiliser SET_SERVO SERVO=my_servo WIDTH=0 pour d\u00e9sactiver un servo. 20200608 : Le support de l'affichage LCD a chang\u00e9 le nom de certains \"glyphes\" internes. Si une disposition d'affichage personnalis\u00e9e a \u00e9t\u00e9 impl\u00e9ment\u00e9e, il peut \u00eatre n\u00e9cessaire d'actualiser avec les noms actuels de glyphes (voir klippy/extras/display/display.cfg pour une liste des glyphes disponibles). 20200606 : Les noms des broches sur linux mcu ont chang\u00e9. Les broches ont maintenant des noms de la forme gpiochip<chipid>/gpio<gpio> . Pour gpiochip0 vous pouvez aussi utiliser un court gpio<gpio> . Par exemple, ce qui \u00e9tait pr\u00e9c\u00e9demment appel\u00e9 P20 devient maintenant gpio20 ou `gpiochip0/gpio20``. 20200603 : La disposition par d\u00e9faut de l'\u00e9cran LCD 16x4 n'affiche plus le temps estim\u00e9 restant pour une impression. (Seul le temps \u00e9coul\u00e9 sera affich\u00e9.) Si l'on souhaite conserver l'ancien comportement, on peut personnaliser l'affichage du menu avec cette information (voir la description de display_data dans config/example-extras.cfg pour plus de d\u00e9tails). 20200531 : L'id par d\u00e9faut du vendeur/produit USB est maintenant 0x1d50/0x614e. Ces nouveaux identifiants sont r\u00e9serv\u00e9s \u00e0 Klipper (gr\u00e2ce au projet openmoko). Ce changement ne devrait pas n\u00e9cessiter de modification de la configuration, mais les nouveaux identifiants peuvent appara\u00eetre dans les journaux syst\u00e8me. 20200524 : La valeur par d\u00e9faut du champ pwm_freq du tmc5160 est maintenant z\u00e9ro (au lieu de un). 20200425 : La variable du mod\u00e8le de commande gcode_macro printer.heater a \u00e9t\u00e9 renomm\u00e9e en printer.heaters . 20200313 : La disposition par d\u00e9faut de l'\u00e9cran pour les imprimantes multi-extrudeurs avec un \u00e9cran 16x4 a chang\u00e9. La disposition de l'\u00e9cran pour un seul extrudeur est maintenant la disposition par d\u00e9faut et elle montrera l'extrudeur actuellement actif. Pour utiliser la disposition d'\u00e9cran pr\u00e9c\u00e9dente, d\u00e9finissez \"display_group : _multiextruder_16x4\" dans la section [display] du fichier printer.cfg. 20200308 : L'\u00e9l\u00e9ment de menu par d\u00e9faut __test a \u00e9t\u00e9 supprim\u00e9. Si le fichier de configuration a un menu personnalis\u00e9, assurez-vous de supprimer toutes les r\u00e9f\u00e9rences \u00e0 cet \u00e9l\u00e9ment de menu __test . 20200308 : Les options \"deck\" et \"card\" du menu ont \u00e9t\u00e9 supprim\u00e9es. Pour personnaliser la disposition d'un \u00e9cran lcd, utilisez les nouvelles sections de configuration display_data (voir config/example-extras.cfg pour les d\u00e9tails). 20200109 : Le module bed_mesh fait d\u00e9sormais r\u00e9f\u00e9rence \u00e0 l'emplacement de la sonde pour la configuration du maillage. Ainsi, certaines options de configuration ont \u00e9t\u00e9 renomm\u00e9es pour mieux refl\u00e9ter leur fonctionnalit\u00e9. Pour les lits rectangulaires, min_point et max_point ont \u00e9t\u00e9 renomm\u00e9s en mesh_min et mesh_max respectivement. Pour les lits ronds, bed_radius a \u00e9t\u00e9 renomm\u00e9 en mesh_radius . Une nouvelle option mesh_origin a \u00e9galement \u00e9t\u00e9 ajout\u00e9e pour les lits ronds. Notez que ces changements sont \u00e9galement incompatibles avec les profils de maillage pr\u00e9c\u00e9demment enregistr\u00e9s. Si un profil incompatible est d\u00e9tect\u00e9, il sera ignor\u00e9 et sa suppression sera programm\u00e9e. Le processus de suppression peut \u00eatre achev\u00e9 en lan\u00e7ant la commande SAVE_CONFIG. L'utilisateur devra recalibrer chaque profil. 20191218 : La section de configuration de l'affichage ne prend plus en charge \"lcd_type : st7567\". Utilisez le type d'affichage \"uc1701\" \u00e0 la place - d\u00e9finissez \"lcd_type : uc1701\" et changez \"rs_pin : some_pin\" en \"rst_pin : some_pin\". Il peut \u00e9galement \u00eatre n\u00e9cessaire d'ajouter un param\u00e8tre de configuration \"contrast : 60\". 20191210 : Les commandes int\u00e9gr\u00e9es T0, T1, T2, ... ont \u00e9t\u00e9 supprim\u00e9es. Les options de configuration activate_gcode et deactivate_gcode de l'extrudeuse ont \u00e9t\u00e9 supprim\u00e9es. Si ces commandes (et scripts) sont n\u00e9cessaires, d\u00e9finissez des macros individuelles de type [gcode_macro T0] qui appellent la commande ACTIVATE_EXTRUDER. Voir les fichiers config/sample-idex.cfg et sample-multi-extruder.cfg pour des exemples. 20191210 : La prise en charge de la commande M206 a \u00e9t\u00e9 supprim\u00e9e. Remplacer par des appels \u00e0 SET_GCODE_OFFSET. Si le support de M206 est n\u00e9cessaire, ajoutez une section de configuration [gcode_macro M206] qui appelle SET_GCODE_OFFSET. (Par exemple \"SET_GCODE_OFFSET Z=-{params.Z}\".) 20191202 : La prise en charge du param\u00e8tre non document\u00e9 \"S\" de la commande \"G4\" a \u00e9t\u00e9 supprim\u00e9e. Remplacez toutes les occurrences de S par le param\u00e8tre standard \"P\" (le d\u00e9lai sp\u00e9cifi\u00e9 en millisecondes). 20191126 : Les noms USB ont chang\u00e9 sur les micro-contr\u00f4leurs avec un support USB natif. Ils utilisent d\u00e9sormais un identifiant de puce unique par d\u00e9faut (lorsqu'il est disponible). Si une section de configuration \"mcu\" utilise un param\u00e8tre \"serial\" qui commence par \"/dev/serial/by-id/\", il peut \u00eatre n\u00e9cessaire de mettre \u00e0 jour la configuration. Ex\u00e9cutez \"ls /dev/serial/by-id/*\" dans un terminal ssh pour d\u00e9terminer le nouvel identifiant. 20191121 : Le param\u00e8tre pressure_advance_lookahead_time a \u00e9t\u00e9 supprim\u00e9. Voir example.cfg pour d'autres param\u00e8tres de configuration. 20191112 : La capacit\u00e9 d'activation virtuelle du pilote de pas \u00e0 pas tmc est d\u00e9sormais automatiquement activ\u00e9e si le moteur pas \u00e0 pas ne poss\u00e8de pas de broche d'activation d\u00e9di\u00e9e. Supprimez les r\u00e9f\u00e9rences \u00e0 tmcXXXX:virtual_enable de la configuration. La possibilit\u00e9 de contr\u00f4ler plusieurs broches dans la configuration enable_pin du moteur a \u00e9t\u00e9 supprim\u00e9e. Si plusieurs broches sont n\u00e9cessaires, utilisez une section de configuration multi_pin. 20191107 : La section de configuration de l'extrudeur primaire doit \u00eatre sp\u00e9cifi\u00e9e comme \"extruder\" et ne peut plus \u00eatre sp\u00e9cifi\u00e9e comme \"extruder0\". Les mod\u00e8les de commande Gcode qui interrogent le statut de l'extrudeur sont d\u00e9sormais accessibles via \"{printer.extruder}\". 20191021 : Sortie de Klipper v0.8.0 20191003 : L'option move_to_previous de [safe_z_homing] a d\u00e9sormais la valeur par d\u00e9faut False. (Elle \u00e9tait effectivement False avant 20190918.) 20190918 : L'option zhop de [safe_z_homing] est toujours r\u00e9appliqu\u00e9e apr\u00e8s la fin du homing sur l'axe Z. Cela peut obliger les utilisateurs \u00e0 mettre \u00e0 jour les scripts personnalis\u00e9s bas\u00e9s sur ce module. 20190806 : La commande SET_NEOPIXEL a \u00e9t\u00e9 renomm\u00e9e SET_LED. 20190726 : Le code num\u00e9rique-analogique du mcp4728 a \u00e9t\u00e9 modifi\u00e9. L'adresse i2c_address par d\u00e9faut est maintenant 0x60 et la r\u00e9f\u00e9rence de tension est maintenant relative \u00e0 la r\u00e9f\u00e9rence interne de 2,048 volts du mcp4728. 20190710 : L'option z_hop a \u00e9t\u00e9 supprim\u00e9e de la section de configuration [firmware_retract]. La prise en charge de z_hop \u00e9tait incompl\u00e8te et pouvait provoquer un comportement incorrect avec plusieurs trancheurs courants. 20190710 : Les param\u00e8tres optionnels de la commande PROBE_ACCURACY ont \u00e9t\u00e9 modifi\u00e9s. Il peut \u00eatre n\u00e9cessaire de mettre \u00e0 jour les macros ou les scripts qui utilisent cette commande. 20190628 : Toutes les options de configuration ont \u00e9t\u00e9 supprim\u00e9es de la section [skew_correction]. La configuration de la correction d'obliquit\u00e9 se fait d\u00e9sormais via le gcode SET_SKEW. Voir Correction de l'obliquit\u00e9 pour l'utilisation recommand\u00e9e. 20190607 : Les param\u00e8tres \"variable_X\" de gcode_macro (ainsi que le param\u00e8tre VALUE de SET_GCODE_VARIABLE) sont maintenant analys\u00e9s comme des litt\u00e9raux Python. Si une valeur doit \u00eatre assign\u00e9e \u00e0 une cha\u00eene de caract\u00e8res, mettez-la entre guillemets pour qu'elle soit \u00e9valu\u00e9e comme une cha\u00eene de caract\u00e8res. 20190606 : Les options de configuration \"samples\", \"samples_result\" et \"sample_retract_dist\" ont \u00e9t\u00e9 d\u00e9plac\u00e9es vers la section de configuration \"probe\". Ces options ne sont plus support\u00e9es dans les sections de configuration \"delta_calibrate\", \"bed_tilt\", \"bed_mesh\", \"screws_tilt_adjust\", \"z_tilt\", ou \"quad_gantry_level\". 20190528 : La variable magique \"status\" dans l'\u00e9valuation du mod\u00e8le gcode_macro a \u00e9t\u00e9 renomm\u00e9e en \"printer\". 20190520 : La commande SET_GCODE_OFFSET a \u00e9t\u00e9 modifi\u00e9e ; mettez \u00e0 jour vos macros de code G en cons\u00e9quence. La commande n'appliquera plus le d\u00e9calage demand\u00e9 \u00e0 la prochaine commande G1. L'ancien comportement peut \u00eatre approch\u00e9 en utilisant le nouveau param\u00e8tre \"MOVE=1\". 20190404 : Les paquets du logiciel h\u00f4te Python ont \u00e9t\u00e9 mis \u00e0 jour. Les utilisateurs devront r\u00e9ex\u00e9cuter le script ~/klipper/scripts/install-octopi.sh (ou mettre \u00e0 jour les d\u00e9pendances python s'ils n'utilisent pas une installation OctoPi standard). 20190404 : Les param\u00e8tres i2c_bus et spi_bus (dans diverses sections de configuration) prennent d\u00e9sormais un nom de bus au lieu d'un num\u00e9ro. 20190404 : Les param\u00e8tres de configuration du sx1509 ont chang\u00e9. Le param\u00e8tre 'adresse' est maintenant 'i2c_address' et doit \u00eatre sp\u00e9cifi\u00e9 comme un nombre d\u00e9cimal. L\u00e0 o\u00f9 0x3E \u00e9tait pr\u00e9c\u00e9demment utilis\u00e9, sp\u00e9cifiez 62. 20190328 : La valeur min_speed dans la configuration [temperature_fan] sera d\u00e9sormais respect\u00e9e et le ventilateur fonctionnera toujours \u00e0 cette vitesse ou plus en mode PID. 20190322 : La valeur par d\u00e9faut de \"driver_HEND\" dans les sections de configuration [tmc2660] a \u00e9t\u00e9 modifi\u00e9e de 6 \u00e0 3. Le champ \"driver_VSENSE\" a \u00e9t\u00e9 supprim\u00e9 (il est d\u00e9sormais calcul\u00e9 automatiquement \u00e0 partir de run_current). 20190310 : La section de configuration [controller_fan] prend d\u00e9sormais toujours un nom (tel que [controller_fan my_controller_fan]). 20190308 : Le champ \"driver_BLANK_TIME_SELECT\" dans les sections de configuration [tmc2130] et [tmc2208] a \u00e9t\u00e9 renomm\u00e9 \"driver_TBL\". 20190308 : La section config [tmc2660] a \u00e9t\u00e9 modifi\u00e9e. Un nouveau param\u00e8tre de configuration sense_resistor doit maintenant \u00eatre fourni. La signification de plusieurs des param\u00e8tres driver_XXX a \u00e9t\u00e9 modifi\u00e9e. 20190228 : Les utilisateurs de SPI ou I2C sur les cartes SAMD21 doivent maintenant sp\u00e9cifier les broches du bus via une section de configuration [samd_sercom]. 20190224 : L'option bed_shape a \u00e9t\u00e9 supprim\u00e9e de bed_mesh. L'option radius a \u00e9t\u00e9 renomm\u00e9e bed_radius. Les utilisateurs avec des lits ronds doivent fournir les options bed_radius et round_probe_count. 20190107 : Le param\u00e8tre i2c_address de la section config du mcp4451 a \u00e9t\u00e9 modifi\u00e9. Il s'agit d'un param\u00e8tre courant sur les Smoothieboards. La nouvelle valeur est la moiti\u00e9 de l'ancienne valeur (88 doit \u00eatre chang\u00e9 en 44, et 90 doit \u00eatre chang\u00e9 en 45). 20181220 : Sortie de Klipper v0.7.0","title":"Changements"},{"location":"Config_Reference.html","text":"R\u00e9f\u00e9rence de configuration \u00b6 Ce document est la r\u00e9f\u00e9rence des options disponibles dans le fichier de configuration de Klipper. Les descriptions de ce document sont format\u00e9es de mani\u00e8re \u00e0 ce qu'il soit possible de les copier-coller dans un fichier de configuration d'imprimante. Consultez le document d'installation pour obtenir des informations sur la configuration de Klipper et le choix d'un fichier de configuration initial. Configuration du microcontr\u00f4leur \u00b6 Format du nom des broches du microcontr\u00f4leur \u00b6 De nombreuses options de configuration n\u00e9cessitent le nom d'une broche du micro-contr\u00f4leur. Klipper utilise les noms mat\u00e9riel pour ces broches - par exemple PA4 . Les noms des broches peuvent \u00eatre pr\u00e9c\u00e9d\u00e9s de ! pour indiquer qu'une polarit\u00e9 inverse doit \u00eatre utilis\u00e9e (par exemple, d\u00e9clencher sur le niveau bas au lieu du niveau haut). Les broches d'entr\u00e9e peuvent \u00eatre pr\u00e9c\u00e9d\u00e9es de ^ pour indiquer qu'une r\u00e9sistance pull-up mat\u00e9rielle doit \u00eatre activ\u00e9e pour cette broche. Si le micro-contr\u00f4leur supporte les r\u00e9sistances pull-down, une broche d'entr\u00e9e peut \u00e9galement \u00eatre pr\u00e9c\u00e9d\u00e9e de ~ . Notez que certaines sections de configuration peuvent \"cr\u00e9er\" des broches suppl\u00e9mentaires. Lorsque cela se produit, la section de configuration d\u00e9finissant ces broches doit \u00eatre r\u00e9pertori\u00e9e dans le fichier de configuration avant toute section utilisant celles-ci. [mcu| \u00b6 Configuration du microcontr\u00f4leur primaire. [mcu] serial: # Le port s\u00e9rie \u00e0 connecter \u00e0 l'unit\u00e9 MCU. Si vous n'\u00eates pas s\u00fbr (ou s'il # change) consultez la section \"O\u00f9 est mon port s\u00e9rie ?\" de la FAQ. # Ce param\u00e8tre doit \u00eatre fourni lors de l'utilisation d'un port s\u00e9rie. #baud: 250000 # Le d\u00e9bit en bauds \u00e0 utiliser. La valeur par d\u00e9faut est 250000. #canbus_uuid: # Si vous utilisez un dispositif connect\u00e9 \u00e0 un bus CAN, ceci d\u00e9finit l'identifiant # unique de la puce \u00e0 laquelle se connecter. Cette valeur doit \u00eatre fournie lorsque l'on utilise # le bus CAN pour la communication. #canbus_interface: # Si vous utilisez un dispositif connect\u00e9 \u00e0 un bus CAN, ceci d\u00e9finit l'interface r\u00e9seau CAN # \u00e0 utiliser. La valeur par d\u00e9faut est 'can0'. #restart_method: # Ceci contr\u00f4le le m\u00e9canisme que l'h\u00f4te utilisera pour r\u00e9initialiser le microcontr\u00f4leur. # Les choix sont 'arduino', 'cheetah', 'rpi_usb', et 'command'. La m\u00e9thode 'arduino' # (basculer DTR) est courante sur les cartes et clones Arduino. # La m\u00e9thode 'cheetah' est une m\u00e9thode particuli\u00e8re n\u00e9cessaire pour certaines cartes # Fysetc Cheetah. La m\u00e9thode 'rpi_usb' est utile sur les cartes Raspberry Pi avec des # micro-contr\u00f4leurs aliment\u00e9s par USB - elle d\u00e9sactive bri\u00e8vement l'alimentation de tous # les ports USB pour effectuer une r\u00e9initialisation du microcontr\u00f4leur. # La m\u00e9thode 'command' implique l'envoi d'une commande Klipper au microcontr\u00f4leur # afin qu'il puisse # se r\u00e9initialiser. # La valeur par d\u00e9faut est 'arduino' si le micro-contr\u00f4leur communique via un port s\u00e9rie, # 'command' sinon. [mcu my_extra_mcu] \u00b6 Microcontr\u00f4leurs suppl\u00e9mentaires (on peut d\u00e9finir un nombre quelconque de sections avec un pr\u00e9fixe \"mcu\"). Les microcontr\u00f4leurs suppl\u00e9mentaires introduisent des broches additionnelles pouvant \u00eatre configur\u00e9es comme des \u00e9l\u00e9ments de chauffage, des pilotes moteurs, des ventilateurs, etc. Par exemple, si une section \"[mcu extra_mcu]\" est ajout\u00e9e, des broches telles que \"extra_mcu:ar9\" pourront \u00eatre utilis\u00e9es ailleurs dans la configuration (o\u00f9 \"ar9\" est un nom de broche mat\u00e9rielle ou un nom d'alias sur le mcu donn\u00e9). [mcu my_extra_mcu] # Voir la section \"mcu\" pour les param\u00e8tres de configuration. Param\u00e8tres cin\u00e9matiques courants \u00b6 [printer] \u00b6 La section imprimante contr\u00f4le les param\u00e8tres de haut niveau de l'imprimante. [printer] kinematics: # Le type d'imprimante utilis\u00e9e. Cette option peut \u00eatre l'une des suivantes : cart\u00e9sienne, # corexy, corexz, hybrid_corexy, hybrid_corexz, rotary_delta, delta, deltesian, polar, winch, # ou none. Ce param\u00e8tre doit \u00eatre sp\u00e9cifi\u00e9. max_velocity: # Vitesse maximale (en mm/s) de la t\u00eate d'outil (par rapport \u00e0 l'impression). # Ce param\u00e8tre doit \u00eatre sp\u00e9cifi\u00e9. max_accel: # Acc\u00e9l\u00e9ration maximale (en mm/s^2) de la t\u00eate de l'outil (par rapport \u00e0 l'impression). # Ce param\u00e8tre doit \u00eatre sp\u00e9cifi\u00e9. #max_accel_to_decel: # Une pseudo-acc\u00e9l\u00e9ration (en mm/s^2) contr\u00f4lant la vitesse \u00e0 laquelle la t\u00eate de l'outil peut # passer de l'acc\u00e9l\u00e9ration \u00e0 la d\u00e9c\u00e9l\u00e9ration. Elle est utilis\u00e9e pour r\u00e9duire la vitesse maximale # des courts mouvements en zigzag (et donc r\u00e9duire les vibrations de l'imprimante dues \u00e0 ces # mouvements). La valeur par d\u00e9faut est la moiti\u00e9 de max_accel. #square_corner_velocity: 5.0 # La vitesse maximale (en mm/s) \u00e0 laquelle la t\u00eate d'outil peut parcourir un angle de 90 degr\u00e9s. # Une valeur non nulle peut r\u00e9duire les changements dans les d\u00e9bits de l'extrudeuse en # permettant des changements de vitesse instantan\u00e9s de la t\u00eate d'outil pendant les virages. # Cette valeur configure l'algorithme interne de prise de virage \u00e0 vitesse centrip\u00e8te ; les virages # dont l'angle est sup\u00e9rieur \u00e0 90 degr\u00e9s auront une vitesse de prise de virage plus \u00e9lev\u00e9e tandis # que ceux d'angles inf\u00e9rieurs \u00e0 90 degr\u00e9s auront une vitesse de virage plus faible. # Si ce param\u00e8tre est d\u00e9fini sur z\u00e9ro, la t\u00eate d'outil d\u00e9c\u00e9l\u00e9rera jusqu'\u00e0 z\u00e9ro \u00e0 chaque coin. # La valeur par d\u00e9faut est 5mm/s. [stepper] \u00b6 D\u00e9finitions des pilotes de moteurs pas \u00e0 pas. Diff\u00e9rents types d'imprimantes (comme sp\u00e9cifi\u00e9 par l'option \"kinematics\" dans la section [printer]) requi\u00e8rent diff\u00e9rents noms pour le moteur pas \u00e0 pas (par exemple, stepper_x vs stepper_a ). Ci-dessous, vous trouverez les d\u00e9finitions les plus courantes. Voir le document distance de rotation pour des informations sur le calcul du param\u00e8tre rotation_distance . Voir le document Multi-MCU homing pour des informations sur l'utilisation de plusieurs microcontr\u00f4leurs lors d'une mise \u00e0 l'origine. [stepper_x] step_pin: # Broche GPIO du moteur (d\u00e9clench\u00e9e \u00e0 l'\u00e9tat haut). Ce param\u00e8tre doit \u00eatre fourni. dir_pin: # Broche GPIO de direction (le niveau haut indique une direction positive). Ce param\u00e8tre # doit \u00eatre fourni. enable_pin: # Broche d'activation (par d\u00e9faut, enable est haut ; utilisez ! pour indiquer enable # bas). Si ce param\u00e8tre n'est pas fourni, le pilote du moteur pas \u00e0 pas doit toujours # \u00eatre activ\u00e9. rotation_distance: # Distance (en mm) parcourue par l'axe lors d'une rotation compl\u00e8te du moteur pas \u00e0 pas # (ou de l'engrenage final si le rapport de vitesse est sp\u00e9cifi\u00e9). # Ce param\u00e8tre doit \u00eatre fourni. microsteps: # Le nombre de micropas utilis\u00e9s par le pilote du moteur pas \u00e0 pas. Ce param\u00e8tre # doit \u00eatre fourni. #full_steps_per_rotation: 200 # Nombre de pas complets pour une rotation compl\u00e8te du moteur pas \u00e0 pas. # R\u00e9glez ce param\u00e8tre sur 200 pour un moteur pas \u00e0 pas de 1,8 degr\u00e9 ou sur 400 pour # un moteur de 0,9 degr\u00e9. La valeur par d\u00e9faut est 200. #gear_ratio: # Le rapport d'engrenage si le moteur pas \u00e0 pas est reli\u00e9 \u00e0 l'axe via une d\u00e9multiplication. # Par exemple, on peut sp\u00e9cifier \"5:1\" si un r\u00e9ducteur de 5 pour 1 est utilis\u00e9. # Si l'axe a plusieurs d\u00e9multiplications, on peut sp\u00e9cifier une liste de rapports s\u00e9par\u00e9s par # des virgules (par exemple, \"57:11, 2:1\"). Si un rapport de vitesse est sp\u00e9cifi\u00e9, alors # rotation_distance sp\u00e9cifie la distance parcourue par l'axe pour une rotation compl\u00e8te # de l'engrenage final. # La valeur par d\u00e9faut est de ne pas utiliser de rapport de vitesse. #step_pulse_duration: # Le temps minimum entre le front du signal d'impulsion de pas et le front du signal \"unstep\" suivant. # Ceci est \u00e9galement utilis\u00e9 pour d\u00e9finir le temps minimum entre une impulsion de pas et un signal # de changement de direction. # La valeur par d\u00e9faut est 0,000000100 (100ns) pour les pilotes TMC configur\u00e9s en mode UART ou SPI, # sinon la valeur par d\u00e9faut est de 0,000002 (2us) pour tous les autres pilotes. endstop_pin: # Broche de d\u00e9tection de l'interrupteur de fin de course. Si cette broche est sur un mcu diff\u00e9rent de # celui du moteur pas \u00e0 pas, cela active le \"multi-mcu\". Ce param\u00e8tre doit \u00eatre fourni pour les moteurs # pas \u00e0 pas X, Y, et Z sur les imprimantes de style cart\u00e9sien. #position_min: 0 # Distance minimale valide (en mm) vers laquelle l'utilisateur peut commander le moteur pas \u00e0 pas. # La valeur par d\u00e9faut est 0mm. position_endstop: # Emplacement de la but\u00e9e (en mm). Ce param\u00e8tre doit \u00eatre fourni pour les moteurs X, Y et Z # des imprimantes de style cart\u00e9sien. position_max: # Distance maximale valide (en mm) vers laquelle l'utilisateur peut ordonner au moteur de se d\u00e9placer. # Ce param\u00e8tre doit \u00eatre fourni pour les moteurs X, Y, et Z des imprimantes de type cart\u00e9sien. #homing_speed: 5.0 # Vitesse maximale (en mm/s) du moteur pas \u00e0 pas lors de la mise \u00e0 l'origine. La valeur par d\u00e9faut # est de 5mm/s. #homing_retract_dist: 5.0 # Distance de recul (en mm) avant le retour au point d'origine une seconde fois. # R\u00e9glez cette valeur \u00e0 z\u00e9ro pour d\u00e9sactiver le second retour \u00e0 l'origine. La valeur par d\u00e9faut # est de 5 mm. #homing_retract_speed: # Vitesse \u00e0 utiliser pour le mouvement de recul apr\u00e8s le retour \u00e0 l'origine au cas o\u00f9 elle soit # diff\u00e9rente de la vitesse de mise \u00e0 l'origine qui est la valeur par d\u00e9faut de ce param\u00e8tre. #second_homing_speed: # Vitesse (en mm/s) du moteur pas \u00e0 pas lors du second retour \u00e0 l'origine. # La valeur par d\u00e9faut est homing_speed/2. #homing_positive_dir: # Si la valeur est vraie (true), le retour au point d'origine entra\u00eenera le d\u00e9placement de la commande pas # \u00e0 pas dans une direction positive (en s'\u00e9loignant de z\u00e9ro) ; si elle est fausse (false), le retour \u00e0 l'origine # se fera vers z\u00e9ro. Il est pr\u00e9f\u00e9rable d'utiliser la valeur par d\u00e9faut que de sp\u00e9cifier ce param\u00e8tre. La valeur # par d\u00e9faut est true si position_endstop est proche de position_max et false si elle est proche de # la position_min. Cin\u00e9matique cart\u00e9sienne \u00b6 Voir example-cartesian.cfg pour un exemple de fichier de configuration de cin\u00e9matique cart\u00e9sienne. Seuls les param\u00e8tres sp\u00e9cifiques aux imprimantes cart\u00e9siennes sont d\u00e9crits ici - voir param\u00e8tres cin\u00e9matiques communs pour les param\u00e8tres disponibles. [printer] kinematics: cartesian max_z_velocity: # Ceci d\u00e9finit la vitesse maximale (en mm/s) du mouvement le long de l'axe z # Ce param\u00e8tre peut \u00eatre utilis\u00e9 pour limiter la vitesse maximale du moteur pas \u00e0 pas z. # La valeur par d\u00e9faut est l'utilisation de max_velocity pour # max_z_velocity. max_z_accel: # Ce param\u00e8tre d\u00e9finit l'acc\u00e9l\u00e9ration maximale (en mm/s^2) du mouvement sur l'axe z. # Cela limite l'acc\u00e9l\u00e9ration du moteur pas \u00e0 pas z. La valeur par d\u00e9faut est # d'utiliser max_accel pour max_z_accel. # La section stepper_x est utilis\u00e9e pour d\u00e9crire le moteur pas \u00e0 pas contr\u00f4lant # l'axe X dans un robot cart\u00e9sien. [stepper_x] # La section stepper_y est utilis\u00e9e pour d\u00e9crire le moteur pas \u00e0 pas contr\u00f4lant # l'axe Y d'un robot cart\u00e9sien. [stepper_y] # La section stepper_z est utilis\u00e9e pour d\u00e9crire le moteur pas \u00e0 pas contr\u00f4lant # l'axe Z d'un robot cart\u00e9sien. [stepper_z] Cin\u00e9matique Delta lin\u00e9aire \u00b6 Voir example-delta.cfg pour un exemple de fichier de configuration de cin\u00e9matique delta lin\u00e9aire. Voir le guide de calibration delta pour des informations sur la calibration. Seuls les param\u00e8tres sp\u00e9cifiques aux imprimantes delta lin\u00e9aires sont d\u00e9crits ici - voir param\u00e8tres cin\u00e9matiques communs pour les param\u00e8tres disponibles. [printer] kinematics: delta max_z_velocity: # Pour les imprimantes delta, cela limite la vitesse maximale (en mm/s) des # mouvements de l'axe z. Ce param\u00e8tre peut \u00eatre utilis\u00e9 pour r\u00e9duire la # vitesse maximale des d\u00e9placements vers le haut/bas (n\u00e9cessitent une vitesse # de pas plus \u00e9lev\u00e9e que les autres mouvements sur une imprimante delta). La # valeur par d\u00e9faut est d'utiliser max_velocity pour max_z_velocity. #max_z_accel: # Ceci d\u00e9finit l'acc\u00e9l\u00e9ration maximale (en mm/s^2) du mouvement le long de l'axe z. # Ce param\u00e8tre peut \u00eatre utile si l'imprimante peut atteindre une plus grande # acc\u00e9l\u00e9ration sur les mouvements XY que sur les mouvements Z (par exemple, lors # de l'utilisation de la compensation de r\u00e9sonance). # La valeur par d\u00e9faut est d'utiliser max_accel pour max_z_accel. #minimum_z_position: 0 # Position Z minimale \u00e0 laquelle l'utilisateur peut ordonner \u00e0 la t\u00eate de se d\u00e9placer. # La valeur par d\u00e9faut est 0. delta_radius: # Rayon (en mm) du cercle horizontal form\u00e9 par les trois colonnes d'axe lin\u00e9aire. # Ce param\u00e8tre peut \u00e9galement \u00eatre calcul\u00e9 comme suit : # delta_radius = smooth_rod_offset - effector_offset - carriage_offset. # Ce param\u00e8tre doit \u00eatre fourni. #print_radius: # Le rayon (en mm) des coordonn\u00e9es XY valides de la t\u00eate d'extrusion. On peut utiliser # ce param\u00e8tre pour personnaliser la v\u00e9rification de la plage de mouvements de la t\u00eate. # Si une grande valeur est sp\u00e9cifi\u00e9e ici, il peut \u00eatre possible de faire entrer la t\u00eate en collision # avec une colonne. La valeur par d\u00e9faut est d'utiliser delta_radius pour print_radius (ce qui # emp\u00eachera normalement une collision avec une colonne). # La section stepper_a d\u00e9crit le moteur pas \u00e0 pas contr\u00f4lant la colonne avant gauche (\u00e0 210 # degr\u00e9s). Cette section contr\u00f4le \u00e9galement les param\u00e8tres de la mise \u00e0 l'origine # (homing_speed, homing_retract_dist) pour toutes les colonnes. [stepper_a] position_endstop: # Distance (en mm) entre la buse et le lit lorsque la buse se trouve au centre de la zone de # construction et que la fin de course se d\u00e9clenche. Ce param\u00e8tre doit \u00eatre fourni pour le # stepper_a ; pour les stepper_b et stepper_c, ce param\u00e8tre prend par d\u00e9faut la valeur # sp\u00e9cifi\u00e9e pour stepper_a. arm_length: # Longueur (en mm) du bras reliant cette colonne \u00e0 la t\u00eate d'impression. # Ce param\u00e8tre doit \u00eatre fourni pour stepper_a ; pour stepper_b et stepper_c, ce param\u00e8tre # prend par d\u00e9faut la valeur sp\u00e9cifi\u00e9e pour stepper_a. #angle: # Cette option sp\u00e9cifie l'angle (en degr\u00e9s) o\u00f9 se trouve positionn\u00e9e la colonne. # La valeur par d\u00e9faut est 210 pour stepper_a, 330 pour stepper_b, et 90 # pour stepper_c. # La section stepper_b d\u00e9crit le moteur pas \u00e0 pas contr\u00f4lant la colonne avant droite (\u00e0 330 degr\u00e9s). [stepper_b] # La section stepper_c d\u00e9crit le moteur pas \u00e0 pas contr\u00f4lant la colonne arri\u00e8re droite (\u00e0 90 degr\u00e9s). [stepper_c] # La section delta_calibrate active une commande G-code \u00e9tendue DELTA_CALIBRATE permettant # de calibrer la position des interrupteurs de fin de course ainsi que les angles des colonnes. [delta_calibrate] radius: # Rayon (en mm) de la zone palpable. Il s'agit du rayon des coordonn\u00e9es de la buse \u00e0 sonder ; si # vous utilisez un palpeur automatique avec un d\u00e9calage XY, choisissez un rayon suffisamment # petit pour que la sonde reste toujours au-dessus du lit. # Ce param\u00e8tre doit \u00eatre fourni. #speed: 50 # La vitesse (en mm/s) des mouvements sans palpage pendant l'\u00e9talonnage. # La valeur par d\u00e9faut est 50. #horizontal_move_z: 5 # La hauteur (en mm) \u00e0 laquelle la t\u00eate doit \u00eatre relev\u00e9e pour se d\u00e9placer # juste avant de lancer une op\u00e9ration de palpage. La valeur par d\u00e9faut est 5. Cin\u00e9matique deltesienne \u00b6 Voir example-deltesian.cfg pour un exemple de fichier de configuration de cin\u00e9matique deltesienne. Seuls les param\u00e8tres sp\u00e9cifiques aux imprimantes deltesiennes sont d\u00e9crits ici - voir param\u00e8tres cin\u00e9matiques communs pour les param\u00e8tres disponibles. [printer] kinematics: deltesian max_z_velocity: # Pour les imprimantes deltesiennes, ceci limite la vitesse maximale (en mm/s) des # d\u00e9placements avec un mouvement sur l'axe z. Ce param\u00e8tre peut \u00eatre utilis\u00e9 pour # r\u00e9duire la vitesse maximale des d\u00e9placements vers le haut/bas (qui n\u00e9cessitent un # taux de pas plus \u00e9lev\u00e9 que les autres mouvements sur une imprimante deltesienne). # La valeur par d\u00e9faut est d'utiliser max_velocity pour max_z_velocity. #max_z_accel: # Ceci d\u00e9finit l'acc\u00e9l\u00e9ration maximale (en mm/s^2) du mouvement le long de l'axe z. # Ce param\u00e8tre peut \u00eatre utile si l'imprimante peut atteindre une plus grande # acc\u00e9l\u00e9ration sur les mouvements XY que sur les mouvements Z (par exemple, lors # de l'utilisation de la compensation de la r\u00e9sonance). # La valeur par d\u00e9faut est d'utiliser max_accel pour max_z_accel. #minimum_z_position : 0 # Position Z minimale \u00e0 laquelle l'utilisateur peut ordonner \u00e0 la t\u00eate de se d\u00e9placer. # La valeur par d\u00e9faut est 0. #min_angle: 5 # Ceci repr\u00e9sente l'angle minimum (en degr\u00e9s) par rapport \u00e0 l'horizontale que les bras # deltesiens sont autoris\u00e9s \u00e0 atteindre. Ce param\u00e8tre est destin\u00e9 \u00e0 emp\u00eacher les bras de # devenir compl\u00e8tement horizontaux, ce qui risquerait de provoquer une inversion # accidentelle de l'axe XZ. # La valeur par d\u00e9faut est 5. #print_width: # La distance (en mm) des coordonn\u00e9es X valides de la t\u00eate de l'outil. On peut utiliser ce # param\u00e8tre pour personnaliser la v\u00e9rification de la plage des mouvements de la t\u00eate de # l'outil. Si une grande valeur est sp\u00e9cifi\u00e9e ici, il peut \u00eatre possible de faire entrer la t\u00eate # de l'outil en collision avec une colonne. Ce param\u00e8tre correspond g\u00e9n\u00e9ralement \u00e0 la # largeur du banc (en mm). #slow_ratio: 3 # Rapport utilis\u00e9 pour limiter la vitesse et l'acc\u00e9l\u00e9ration des mouvements proches des # extr\u00eames de l'axe X. Si la distance verticale divis\u00e9e par la distance horizontale d\u00e9passe # la valeur de slow_ratio, la vitesse et l'acc\u00e9l\u00e9ration sont limit\u00e9es \u00e0 la moiti\u00e9 de leur valeur # nominale. Si la distance verticale divis\u00e9e par la distance horizontale d\u00e9passe de deux fois # la valeur de slow_ratio, alors la vitesse et l'acc\u00e9l\u00e9ration sont limit\u00e9es \u00e0 un quart de leur # valeur nominale. La valeur par d\u00e9faut est 3. # La section stepper_left est utilis\u00e9e pour d\u00e9crire le moteur pas \u00e0 pas contr\u00f4lant la colonne # gauche. Cette section contr\u00f4le \u00e9galement les param\u00e8tres d'orientation (homing_speed, # homing_retract_dist) pour toutes les colonnes. [stepper_left] position_endstop: # Distance (en mm) entre la buse et le lit lorsque la buse se trouve au centre de la zone de # construction. Ce param\u00e8tre doit \u00eatre fourni pour stepper_left ; pour le param\u00e8tre stepper_right # ce param\u00e8tre prend par d\u00e9faut la valeur sp\u00e9cifi\u00e9e pour stepper_left. arm_length: # Longueur (en mm) de la tige diagonale reliant le chariot de la colonne \u00e0 la t\u00eate d'impression. # Ce param\u00e8tre doit \u00eatre fourni pour stepper_left. Pour le param\u00e8tre stepper_right, ce param\u00e8tre # prend par d\u00e9faut la valeur sp\u00e9cifi\u00e9e pour stepper_left. arm_x_length: # Distance horizontale entre la t\u00eate d'impression et la colonne lorsque l'imprimante est mise \u00e0 # l'origine. Ce param\u00e8tre doit \u00eatre fourni pour stepper_left ; pour stepper_right, ce param\u00e8tre # prend par d\u00e9faut la valeur sp\u00e9cifi\u00e9e pour stepper_left. # La section stepper_right est utilis\u00e9e pour d\u00e9crire le moteur pas \u00e0 pas contr\u00f4lant la colonne de droite. [stepper_right] # La section stepper_y est utilis\u00e9e pour d\u00e9crire le moteur pas \u00e0 pas contr\u00f4lant l'axe Y d'un robot deltesien. [stepper_y] Cin\u00e9matique CoreXY \u00b6 Voir example-corexy.cfg pour un exemple de fichier cin\u00e9matique corexy (et h-bot). Seuls les param\u00e8tres sp\u00e9cifiques aux imprimantes corexy sont d\u00e9crits ici - voir param\u00e8tres cin\u00e9matiques communs pour les param\u00e8tres disponibles. [printer] kinematics: corexy max_z_velocity: # Ceci d\u00e9finit la vitesse maximale (en mm/s) du mouvement le long de l'axe z # Ce param\u00e8tre peut \u00eatre utilis\u00e9 pour limiter la vitesse maximale du moteur pas \u00e0 pas z. # La valeur par d\u00e9faut est l'utilisation de max_velocity pour max_z_velocity. max_z_accel: # Ce param\u00e8tre d\u00e9finit l'acc\u00e9l\u00e9ration maximale (en mm/s^2) du mouvement sur l'axe z. # Cela limite l'acc\u00e9l\u00e9ration du moteur pas \u00e0 pas z. La valeur par d\u00e9faut est # d'utiliser max_accel pour max_z_accel. # La section stepper_x est utilis\u00e9e pour d\u00e9crire l'axe X ainsi que le moteur pas \u00e0 pas # contr\u00f4lant le mouvement X+Y. [stepper_x] # La section stepper_y est utilis\u00e9e pour d\u00e9crire l'axe Y ainsi que le moteur pas \u00e0 pas # contr\u00f4lant le mouvement X-Y. [stepper_y] # La section stepper_z est utilis\u00e9e pour d\u00e9crire le moteur pas \u00e0 pas contr\u00f4lant l'axe Z. [stepper_z] Cin\u00e9matique CoreXZ \u00b6 Voir example-corexz.cfg pour un exemple de fichier de configuration de cin\u00e9matique corexz. Seuls les param\u00e8tres sp\u00e9cifiques aux imprimantes corexz sont d\u00e9crits ici - voir param\u00e8tres cin\u00e9matiques communs pour les param\u00e8tres disponibles. [printer] kinematics: corexz max_z_velocity: # Ceci d\u00e9finit la vitesse maximale (en mm/s) du mouvement le long de l'axe z. # La valeur par d\u00e9faut est d'utiliser max_velocity pour max_z_velocity. max_z_accel: # Ceci d\u00e9finit l'acc\u00e9l\u00e9ration maximale (en mm/s^2) du mouvement le long de l'axe z. # La valeur par d\u00e9faut est d'utiliser max_accel pour max_z_accel. # La section stepper_x est utilis\u00e9e pour d\u00e9crire l'axe X ainsi que le moteur pas \u00e0 pas # contr\u00f4lant le mouvement X+Z. [stepper_x] # La section stepper_y est utilis\u00e9e pour d\u00e9crire le moteur pas \u00e0 pas contr\u00f4lant l'axe Y. [stepper_y] # La section stepper_z est utilis\u00e9e pour d\u00e9crire l'axe Z ainsi que le moteur pas \u00e0 pas # contr\u00f4lant le mouvement X-Z. [stepper_z] Cin\u00e9matique Hybride-CoreXY \u00b6 Voir example-hybrid-corexy.cfg pour un exemple de fichier de configuration de cin\u00e9matique hybride corexy. Cette cin\u00e9matique est \u00e9galement connue sous le nom de cin\u00e9matique Markforged. Seuls les param\u00e8tres sp\u00e9cifiques aux imprimantes hybrides corexy sont d\u00e9crits ici ; voir param\u00e8tres cin\u00e9matiques communs pour les param\u00e8tres disponibles. [printer] kinematics: hybrid_corexy max_z_velocity: # Ceci d\u00e9finit la vitesse maximale (en mm/s) du mouvement le long de l'axe z # La valeur par d\u00e9faut est d'utiliser max_velocity pour max_z_velocity. max_z_acce : # Ceci d\u00e9finit l'acc\u00e9l\u00e9ration maximale (en mm/s^2) du mouvement le long de l'axe z. # La valeur par d\u00e9faut est d'utiliser max_accel pour max_z_accel. # La section stepper_x est utilis\u00e9e pour d\u00e9crire l'axe X ainsi que le moteur pas \u00e0 pas # contr\u00f4lant le mouvement X-Y. [stepper_x] # La section stepper_y est utilis\u00e9e pour d\u00e9crire le moteur pas \u00e0 pas contr\u00f4lant # l'axe Y. [stepper_y] # La section stepper_z est utilis\u00e9e pour d\u00e9crire le moteur pas \u00e0 pas contr\u00f4lant # l'axe Z. [stepper_z] Cin\u00e9matique Hybride-CoreXZ \u00b6 Voir example-hybrid-corexz.cfg pour un exemple de fichier de configuration de cin\u00e9matique hybride corexz. Cette cin\u00e9matique est \u00e9galement connue sous le nom de cin\u00e9matique Markforged. Seuls les param\u00e8tres sp\u00e9cifiques aux imprimantes hybrides corexy sont d\u00e9crits ici ; voir param\u00e8tres cin\u00e9matiques communs pour les param\u00e8tres disponibles. [printer] kinematics: hybrid_corexz max_z_velocity: # Ceci d\u00e9finit la vitesse maximale (en mm/s) du mouvement le long de l'axe z # La valeur par d\u00e9faut est d'utiliser max_velocity pour max_z_velocity. max_z_accel: # Ceci d\u00e9finit l'acc\u00e9l\u00e9ration maximale (en mm/s^2) du mouvement le long de # l'axe z. La valeur par d\u00e9faut est d'utiliser max_accel pour max_z_accel. # La section stepper_x est utilis\u00e9e pour d\u00e9crire l'axe X ainsi que le moteur pas \u00e0 pas # contr\u00f4lant le mouvement X-Z. [stepper_x] # La section stepper_y est utilis\u00e9e pour d\u00e9crire le moteur pas \u00e0 pas contr\u00f4lant # l'axe Y. [stepper_y] # La section stepper_z est utilis\u00e9e pour d\u00e9crire le moteur pas \u00e0 pas contr\u00f4lant # l'axe Z. [stepper_z] Cin\u00e9matique polaire \u00b6 Voir example-polar.cfg pour un exemple de fichier de configuration de cin\u00e9matique polaire. Seuls les param\u00e8tres sp\u00e9cifiques aux imprimantes polaires sont d\u00e9crits ici - voir param\u00e8tres cin\u00e9matiques communs pour les param\u00e8tres disponibles. LA CIN\u00c9MATIQUE POLAIRE EST UN TRAVAIL EN COURS. Les d\u00e9placements autour de la position 0, 0 sont connus pour ne pas fonctionner correctement. [printer] kinematics: polar max_z_velocity: # Ceci d\u00e9finit la vitesse maximale (en mm/s) du mouvement le long de l'axe z # Ce param\u00e8tre peut \u00eatre utilis\u00e9 pour limiter la vitesse maximale du moteur z. # La valeur par d\u00e9faut est d'utiliser max_velocity pour max_z_velocity. max_z_accel: # Ce param\u00e8tre d\u00e9finit l'acc\u00e9l\u00e9ration maximale (en mm/s^2) du mouvement sur l'axe z. # Cela limite l'acc\u00e9l\u00e9ration du moteur pas \u00e0 pas z. La valeur par d\u00e9faut est d'utiliser # max_accel pour max_z_accel. # La section stepper_bed est utilis\u00e9e pour d\u00e9crire le moteur pas \u00e0 pas contr\u00f4lant # le lit. [stepper_bed] gear_ratio: # Un rapport de vitesse doit \u00eatre sp\u00e9cifi\u00e9 et la distance de rotation ne peut pas \u00eatre # sp\u00e9cifi\u00e9e. Par exemple, si le lit est \u00e9quip\u00e9 d'une poulie \u00e0 80 dents entra\u00een\u00e9e par un # moteur dont l'axe est muni d'une poulie \u00e0 16 dents, il faut sp\u00e9cifier le rapport # d'engrenage de \"80:16\". Ce param\u00e8tre doit \u00eatre fourni. # La section stepper_arm est utilis\u00e9e pour d\u00e9crire le moteur pas \u00e0 pas contr\u00f4lant # le chariot sur le bras. [stepper_arm] # La section stepper_z permet de d\u00e9crire le moteur pas \u00e0 pas contr\u00f4lant l'axe Z. [stepper_z] Cin\u00e9matique rotative delta \u00b6 Voir example-rotary-delta.cfg pour un exemple de fichier de configuration de cin\u00e9matique rotative delta. Seuls les param\u00e8tres sp\u00e9cifiques aux imprimantes rotatives delta sont d\u00e9crits ici - voir param\u00e8tres cin\u00e9matiques communs pour les param\u00e8tres disponibles. LA CIN\u00c9MATIQUE ROTATIVE DELTA EST UN TRAVAIL EN COURS. Les mouvements d'orientation peuvent d\u00e9passer le temps imparti et certains contr\u00f4les de limites ne sont pas impl\u00e9ment\u00e9s. [printer] kinematics: rotary_delta max_z_velocity: # Pour les imprimantes delta, ceci limite la vitesse maximale (en mm/s) des d\u00e9placements avec # mouvement de l'axe z. Ce param\u00e8tre peut \u00eatre utilis\u00e9 pour r\u00e9duire la vitesse maximale des # mouvements de mont\u00e9e/descente (n\u00e9cessitant un taux de pas plus \u00e9lev\u00e9 que les autres mouvements # sur une imprimante delta). La valeur par d\u00e9faut est d'utiliser max_velocity pour max_z_velocity. #minimum_z_position: 0 # La position Z minimale \u00e0 laquelle l'utilisateur peut ordonner \u00e0 la t\u00eate de se d\u00e9placer. # La valeur par d\u00e9faut est 0. shoulder_radius: # Rayon (en mm) du cercle horizontal form\u00e9 par les trois articulations de l'effecteur, moins le rayon # du cercle form\u00e9 par l'articulation de l'effecteur. # Ce param\u00e8tre peut \u00e9galement \u00eatre calcul\u00e9 comme suit # shoulder_radius = (delta_f - delta_e) / sqrt(12) # Ce param\u00e8tre doit \u00eatre fourni. shoulder_height: # Distance (en mm) des joints de l'effecteur par rapport au lit, moins la hauteur de la t\u00eate de l'outil # sur l'effecteur. Ce param\u00e8tre doit \u00eatre fourni. # La section stepper_a d\u00e9crit le moteur pas \u00e0 pas contr\u00f4lant le bras arri\u00e8re droit (\u00e0 30 degr\u00e9s). # Cette section contr\u00f4le \u00e9galement les param\u00e8tres de la mise \u00e0 l'origine (homing_speed, # homing_retract_dist) pour tous les bras. [stepper_a] gear_ratio: # Un rapport de vitesse doit \u00eatre sp\u00e9cifi\u00e9 et la rotation_distance ne peut pas \u00eatre sp\u00e9cifi\u00e9e. # Par exemple, si le bras a une poulie de 80 dents entra\u00een\u00e9e par une poulie de 16 dents, \u00e0 son # tour reli\u00e9e \u00e0 une poulie de 60 dents entra\u00een\u00e9e par un moteur dont l'arbre est muni d'une poulie # \u00e0 16 dents, alors on sp\u00e9cifierait un rapport de vitesse de \"80:16, 60:16\". # Ce param\u00e8tre doit \u00eatre fourni. position_endstop: # Distance (en mm) entre la buse et le lit lorsque la buse se trouve au centre de la zone de construction # et que la but\u00e9e se d\u00e9clenche. Ce param\u00e8tre doit \u00eatre fourni pour le stepper_a ; pour le stepper_b et # le stepper_c, ce param\u00e8tre prend par d\u00e9faut la valeur sp\u00e9cifi\u00e9e pour stepper_a. upper_arm_length: # Longueur (en mm) du bras reliant l'\"articulation de l'effecteur\" \u00e0 l'\"articulation du coude\". # Ce param\u00e8tre doit \u00eatre fourni pour stepper_a ; pour stepper_b et stepper_c, ce param\u00e8tre prend par # d\u00e9faut la valeur sp\u00e9cifi\u00e9e pour stepper_a. lower_arm_length: # Longueur (en mm) du bras reliant l'\"articulation du coude\" \u00e0 l'\"articulation de l'effecteur\". # Ce param\u00e8tre doit \u00eatre fourni pour stepper_a ; pour stepper_b et stepper_c, ce param\u00e8tre prend # par d\u00e9faut la valeur sp\u00e9cifi\u00e9e pour stepper_a. #angle: # Cette option sp\u00e9cifie l'angle (en degr\u00e9s) auquel se trouve le bras. # La valeur par d\u00e9faut est 30 pour stepper_a, 150 pour stepper_b et 270 pour stepper_c. # La section stepper_b d\u00e9crit le moteur pas \u00e0 pas contr\u00f4lant le bras arri\u00e8re gauche (\u00e0 150 degr\u00e9s). [stepper_b] # La section stepper_c d\u00e9crit le moteur pas \u00e0 pas contr\u00f4lant le bras avant (\u00e0 270 degr\u00e9s). [stepper_c] # La section delta_calibrate active une commande G-code \u00e9tendue DELTA_CALIBRATE permettant # de calibrer les positions de la but\u00e9e de l'effecteur. [delta_calibrate] radius: # Rayon (en mm) de la zone pouvant \u00eatre palp\u00e9e. Il s'agit du rayon des coordonn\u00e9es de palpage # de la buse; si vous utilisez un palpeur automatique avec un d\u00e9calage XY, choisissez un rayon # suffisamment petit pour que la sonde s'adapte toujours au lit. Ce param\u00e8tre doit \u00eatre fourni. #speed: 50 # La vitesse (en mm/s) des mouvements sans palpage pendant l'\u00e9talonnage. # La valeur par d\u00e9faut est 50. #horizontal_move_z: 5 # La hauteur (en mm) \u00e0 laquelle la t\u00eate doit \u00eatre remont\u00e9e pour se d\u00e9placer juste avant de lancer # une op\u00e9ration de palpage. La valeur par d\u00e9faut est 5. Cin\u00e9matique du treuil \u00e0 c\u00e2ble \u00b6 Voir le fichier example-winch.cfg pour un exemple de fichier de configuration cin\u00e9matique d'un treuil \u00e0 c\u00e2ble. Seuls les param\u00e8tres sp\u00e9cifiques aux imprimantes \u00e0 treuil sont d\u00e9crits ici - voir param\u00e8tres cin\u00e9matiques communs pour les param\u00e8tres disponibles. LE SUPPORT DU TREUIL \u00c0 C\u00c2BLE EST EXP\u00c9RIMENTAL. La mise \u00e0 l'origine n'est pas impl\u00e9ment\u00e9e dans la cin\u00e9matique du treuil \u00e0 c\u00e2ble. Pour ramener l'imprimante \u00e0 l'origine, envoyez des commandes manuelles de mouvements jusqu'\u00e0 ce que la t\u00eate de l'outil soit \u00e0 0, 0, 0, puis envoyez la commande G28 . [printer] kinematics: winch # La section stepper_a d\u00e9crit le moteur pas \u00e0 pas connect\u00e9 au premier treuil \u00e0 c\u00e2ble. # Un minimum de 3 et un maximum de 26 treuils \u00e0 c\u00e2ble peuvent \u00eatre d\u00e9finis # (stepper_a \u00e0 stepper_z) bien qu'il soit courant d'en d\u00e9finir 4. [stepper_a] rotation_distance: # La rotation_distance est la distance nominale (en mm) \u00e0 laquelle la t\u00eate de l'outil # se d\u00e9place vers le treuil de c\u00e2ble pour chaque rotation compl\u00e8te du moteur pas # \u00e0 pas. Ce param\u00e8tre doit \u00eatre fourni. anchor_x: anchor_y: anchor_z: # Les positions X, Y et Z du treuil \u00e0 c\u00e2ble dans l'espace cart\u00e9sien. # Ces param\u00e8tres doivent \u00eatre fournis. Aucune cin\u00e9matique \u00b6 Il est possible de d\u00e9finir une cin\u00e9matique particuli\u00e8re \"aucune (none)\" pour d\u00e9sactiver le support cin\u00e9matique dans Klipper. Cela peut \u00eatre utile pour contr\u00f4ler des p\u00e9riph\u00e9riques qui ne sont pas des imprimantes 3D typiques ou encore \u00e0 des fins de d\u00e9bogage. [printer] kinematics: none max_velocity: 1 max_accel: 1 # Les param\u00e8tres max_velocity et max_accel doivent \u00eatre d\u00e9finis. Les # valeurs par d\u00e9faut ne sont pas utilis\u00e9es pour la cin\u00e9matique \"none\". Extrudeur commun et support du lit chauffant \u00b6 [extruder] \u00b6 La section de l'extrudeuse est utilis\u00e9e pour d\u00e9crire les param\u00e8tres de chauffe de la buse ainsi que pour les commandes pas \u00e0 pas de l'extrudeuse. Voir la r\u00e9f\u00e9rence de commande pour plus d'informations. Voir le guide d'avance de pression pour des informations sur le r\u00e9glage de l'avance de pression. [extruder] step_pin: dir_pin: enable_pin: microsteps: rotation_distance: #full_steps_per_rotation: #gear_ratio: # Voir la section \"stepper\" pour une description des param\u00e8tres ci-dessus. # Si aucun des param\u00e8tres ci-dessus n'est sp\u00e9cifi\u00e9, alors aucun pilote ne # sera associ\u00e9 \u00e0 la buse (bien qu'une commande SYNC_EXTRUDER_MOTION # puisse en associer un au moment de l'ex\u00e9cution). nozzle_diameter: # Diam\u00e8tre de l'orifice de la buse (en mm). Ce param\u00e8tre doit \u00eatre # fourni. filament_diameter: # Diam\u00e8tre moyen du filament (en mm) lorsqu'il entre dans l'extrudeuse. # Ce param\u00e8tre doit \u00eatre fourni. #max_extrude_cross_section: # Surface maximale (en mm^2) d'une section transversale d'extrusion (ex: # largeur de l'extrusion multipli\u00e9e par la hauteur de la couche). Ce param\u00e8tre # permet d'\u00e9viter d'extruder des quantit\u00e9s excessives durant de petits d\u00e9placements # XY. Si un d\u00e9placement demande une quantit\u00e9 d'extrusion sup\u00e9rieure \u00e0 cette valeur, # une erreur sera renvoy\u00e9e. La valeur par d\u00e9faut est 4.0 *diam\u00e8tre_buse^2 #instantaneous_corner_velocity: 1.000 # La variation instantan\u00e9e maximale de la vitesse (en mm/s) de l'extrudeuse # pendant la jonction de deux mouvements. La valeur par d\u00e9faut est 1mm/s. #max_extrude_only_distance: 50.0 # Longueur maximale (en mm de filament) qu'un mouvement de r\u00e9traction ou d'extrusion # peut fournir. Si un mouvement de r\u00e9traction ou d'extrusion unique demande une # distance sup\u00e9rieure \u00e0 cette valeur, une erreur sera renvoy\u00e9e. # La valeur par d\u00e9faut est 50mm. #max_extrude_only_velocity: #max_extrude_only_accel: # Vitesse maximale (en mm/s) et acc\u00e9l\u00e9ration (en mm/s^2) du moteur de l'extrudeuse # pour les r\u00e9tractions et les mouvements d'extrusion seuls. Ces param\u00e8tres n'ont aucun # impact sur les mouvements d'impression normaux. S'ils ne sont pas sp\u00e9cifi\u00e9s, ils sont # calcul\u00e9s pour correspondre \u00e0 la limite d'un mouvement qu'une impression de # section transversale de 4.0*diam\u00e8tre_buse^2 aurait. #pressure_advance: 0.0 # La quantit\u00e9 de filament \u00e0 pousser dans l'extrudeuse durant l'acc\u00e9l\u00e9ration de celle-ci. # Une quantit\u00e9 \u00e9gale de filament est r\u00e9tract\u00e9e durant la d\u00e9c\u00e9l\u00e9ration. Elle est mesur\u00e9e # en millim\u00e8tre/seconde. La valeur par d\u00e9faut est 0, ce qui d\u00e9sactive la fonctionnalit\u00e9 # d'avance de pression. #pressure_advance_smooth_time: 0.040 # Une dur\u00e9e (en secondes) \u00e0 utiliser lors du calcul de la vitesse moyenne de l'extrudeuse # pour l'avance de pression. Une valeur plus grande donne lieu \u00e0 des mouvements # d'extrusion plus lisses. Ce param\u00e8tre ne doit pas d\u00e9passer 200ms. # Ce param\u00e8tre ne s'applique que si pressure_advance est diff\u00e9rent de z\u00e9ro. La valeur # par d\u00e9faut est 0.040 (40 millisecondes). # # Les variables restantes d\u00e9crivent la chauffe de l'extrudeuse. heater_pin: # Broche de sortie PWM contr\u00f4lant le chauffage. Ce param\u00e8tre doit \u00eatre # fourni. #max_power: 1.0 # La puissance maximale (exprim\u00e9e sous la forme d'une valeur comprise entre 0,0 et 1,0) # de r\u00e9glage du heater_pin . La valeur 1.0 permet \u00e0 la broche d'\u00eatre r\u00e9gl\u00e9e comme toujours # activ\u00e9e durant des p\u00e9riodes prolong\u00e9es, tandis qu'une valeur de 0,5 permet \u00e0 la broche # de n'\u00eatre activ\u00e9e durant au plus la moiti\u00e9 du temps. # Ce r\u00e9glage peut \u00eatre utilis\u00e9 pour limiter la puissance totale de sortie (sur de longues # p\u00e9riodes) de l'\u00e9l\u00e9ment de chauffe. La valeur par d\u00e9faut est 1.0. sensor_type: # Type de capteur - les thermistances courantes sont \"EPCOS 100K B57560G104F\", # \"ATC Semitec 104GT-2\", \"ATC Semitec 104NT-4-R025H42G\", \"Generic # 3950\", \"Honeywell 100K 135-104LAG-J01\", \"NTC 100K MGB18-104F39050L32\", # \"SliceEngineering 450\", et \"TDK NTCG104LH104JT1\". Voir la section \"Capteurs de # temp\u00e9rature\" pour d'autres capteurs. # Ce param\u00e8tre doit \u00eatre fourni. sensor_pin: # Broche d'entr\u00e9e analogique connect\u00e9e au capteur. Ce param\u00e8tre doit \u00eatre # fourni. #pullup_resistor: 4700 # La r\u00e9sistance (en ohms) du pullup reli\u00e9 \u00e0 la thermistance. # Ce param\u00e8tre n'est valable que si le capteur est une thermistance. La valeur par # d\u00e9faut est 4700 ohms. #smooth_time: 1.0 # Une dur\u00e9e (en secondes) sur laquelle les mesures de temp\u00e9rature seront # liss\u00e9es pour r\u00e9duire l'impact du bruit de la mesure. La valeur par d\u00e9faut # est de 1 seconde. control: # Algorithme de contr\u00f4le (soit pid, soit filigrane (watermark)). Ce param\u00e8tre doit # \u00eatre fourni. pid_Kp: pid_Ki: pid_Kd: # Les param\u00e8tres proportionnels (pid_Kp), int\u00e9graux (pid_Ki) et d\u00e9riv\u00e9s (pid_Kd) du syst\u00e8me de # contr\u00f4le de r\u00e9troaction PID. Klipper \u00e9value les param\u00e8tres PID avec la formule g\u00e9n\u00e9rale suivante : # heater_pwm = (Kp*erreur + Ki*int\u00e9grale(erreur) - Kd*d\u00e9riv\u00e9e(erreur)) / 255 # O\u00f9 \"erreur\" est le r\u00e9sultat de \"requested_temperature - measured_temperature\" et # \"heater_pwm\" est le taux de chauffage demand\u00e9, 0.0 \u00e9tant compl\u00e8tement \u00e9teint et 1.0 \u00e9tant # compl\u00e8tement allum\u00e9. Pensez \u00e0 utiliser la commande PID_CALIBRATE pour obtenir ces param\u00e8tres. # Les param\u00e8tres pid_Kp, pid_Ki, et pid_Kd doivent \u00eatre fournis pour les \u00e9l\u00e9ments de chauffe PID. #max_delta: 2.0 # Sur les \u00e9l\u00e9ments de chauffe contr\u00f4l\u00e9s par un filigrane (watermark), il s'agit du nombre de degr\u00e9s en # Celsius au-dessus de la temp\u00e9rature cible avant de d\u00e9sactiver le chauffage ainsi que le nombre de # degr\u00e9s en dessous de la temp\u00e9rature cible avant la r\u00e9activation du chauffage. La valeur par d\u00e9faut # est de 2 degr\u00e9s Celsius. #pwm_cycle_time: 0.100 # Dur\u00e9e en secondes de chaque cycle PWM logiciel du chauffage. Il n'est # pas recommand\u00e9 de d\u00e9finir cette valeur, sauf s'il existe une exigence # \u00e9lectrique pour commuter le chauffage plus rapidement que 10 fois par seconde. # La valeur par d\u00e9faut est 0,100 seconde. #min_extrude_temp: 170 # La temp\u00e9rature minimale (en Celsius) au-dessus de laquelle les commandes de d\u00e9placement de # l'extrudeuse peuvent \u00eatre \u00e9mises. La valeur par d\u00e9faut est 170 Celsius. min_temp: max_temp: # La plage maximale de temp\u00e9ratures valides (en Celsius) dans laquelle l'\u00e9l\u00e9ment de chauffe doit rester. # Ceci contr\u00f4le une fonction de s\u00e9curit\u00e9 impl\u00e9ment\u00e9e dans le code du micro-contr\u00f4leur - si la temp\u00e9rature # mesur\u00e9e sort de cette plage, le microcontr\u00f4leur se met en \u00e9tat d'arr\u00eat. # Ce contr\u00f4le peut aider \u00e0 d\u00e9tecter certaines d\u00e9faillances mat\u00e9rielles de l'\u00e9l\u00e9ment chauffant et/ou du capteur. # D\u00e9finissez cette plage suffisamment large pour que des temp\u00e9ratures raisonnables n'entra\u00eenent pas d'erreur. # Ces param\u00e8tres doivent \u00eatre fournis. [heater_bed] \u00b6 La section heater_bed concerne le lit chauffant. Elle utilise les m\u00eames param\u00e8tres de mise en chauffe que ceux d\u00e9crits dans la section \"extrudeuse\". [heater_bed] heater_pin: sensor_type: sensor_pin: control: min_temp: max_temp: # Voir la section \"extruder\" pour une description des param\u00e8tres ci-dessus. Support du nivelage du lit \u00b6 [bed_mesh] \u00b6 Nivelage du maillage du lit. On peut d\u00e9finir une section de configuration bed_mesh pour activer les transformations de d\u00e9placement qui d\u00e9calent l'axe z en fonction d'un maillage g\u00e9n\u00e9r\u00e9 \u00e0 partir de points palp\u00e9s. Lorsqu'on utilise une sonde pour d\u00e9finir l'origine de l'axe z, il est recommand\u00e9 de d\u00e9finir une section safe_z_home dans printer.cfg pour r\u00e9aliser cette mise \u00e0 l'origine au centre de la zone d'impression. Consultez le guide du maillage du lit et la r\u00e9f\u00e9rence de la commande pour plus d'informations. Exemples visuels : lit rectangulaire, probe_count = 3, 3: x---x---x (max_point) | x---x---x | (min_point) x---x---x lit circulaire, round_probe_count = 5, bed_radius = r: x (0, r) fin / x---x---x \\ (-r, 0) x---x---x---x---x (r, 0) \\ x---x---x / x (0, -r) d\u00e9but [bed_mesh] #speed: 50 # La vitesse (en mm/s) des d\u00e9placements entre les points de palpage # durant l'\u00e9talonnage. # La valeur par d\u00e9faut est 50. #horizontal_move_z: 5 # La hauteur (en mm) \u00e0 laquelle la t\u00eate doit \u00eatre relev\u00e9e juste avant de # lancer une op\u00e9ration de palpage. La valeur par d\u00e9faut est 5. #mesh_radius: # D\u00e9finit le rayon de la maille \u00e0 palper pour les lits circulaires. Notez que # le rayon est relatif aux coordonn\u00e9es sp\u00e9cifi\u00e9es par l'option # mesh_origin. Ce param\u00e8tre doit \u00eatre fourni pour des lits circulaires # et omis pour des lits rectangulaires. #mesh_origin: # D\u00e9finit les coordonn\u00e9es X, Y du centre du maillage des lits circulaires. Ces # coordonn\u00e9es sont relatives \u00e0 l'emplacement de la sonde. Il peut \u00eatre utile # d'ajuster l'origine du maillage afin de maximiser la taille du rayon du maillage. # La valeur par d\u00e9faut est 0, 0. Ce param\u00e8tre doit \u00eatre omis pour des lits rectangulaires. #mesh_min: # D\u00e9finit les coordonn\u00e9es X, Y minimales du maillage pour les lits rectangulaires. # Ces coordonn\u00e9es sont relatives \u00e0 l'emplacement de la sonde. Cette position # sera le premier point sond\u00e9, le plus proche de l'origine. Ce param\u00e8tre doit # \u00eatre fourni pour des lits rectangulaires. #mesh_max: # D\u00e9finit les coordonn\u00e9es X, Y maximales du maillage pour les lits rectangulaires. # Le principe est le m\u00eame que pour mesh_min, mais ce sera le point le plus \u00e9loign\u00e9 # atteignable par rapport \u00e0 l'origine du lit. Ce param\u00e8tre doit \u00eatre fourni pour # des lits rectangulaires. #probe_count: 3, 3 # Pour les lits rectangulaires, il s'agit d'une paire d'entiers X, Y s\u00e9par\u00e9s par des virgules, # d\u00e9finissant le nombre de points \u00e0 palper le long de chaque axe. # Une valeur seule est \u00e9galement valide, auquel cas cette valeur sera appliqu\u00e9e aux # deux axes. La valeur par d\u00e9faut est 3, 3. #round_probe_count: 5 # Pour les lits circulaires, cette valeur enti\u00e8re d\u00e9finit le nombre maximum de points # \u00e0 palper le long de chaque axe. Cette valeur doit \u00eatre un nombre impair. # La valeur par d\u00e9faut est 5. #fade_start: 1.0 # La position z du gcode \u00e0 partir de laquelle il faut commencer \u00e0 \u00e9liminer progressivement # l'ajustement z lorsque la compensation est activ\u00e9e. La valeur par d\u00e9faut est 1.0. #fade_end: 0.0 # La position z du gcode \u00e0 partir de laquelle la compensation se termine. Lorsqu'elle est # d\u00e9finie \u00e0 une valeur inf\u00e9rieure \u00e0 fade_start, la compensation est d\u00e9sactiv\u00e9e. Notez que # la compensation peut ajouter une mise \u00e0 l'\u00e9chelle ind\u00e9sirable le long de l'axe z d'une impression. # Si un utilisateur souhaite activer la compensation, une valeur de 10.0 est recommand\u00e9e. # La valeur par d\u00e9faut est 0.0, ce qui d\u00e9sactive la compensation. #fade_target: # La position z vers laquelle la compensation doit converger. Lorsque cette valeur est # d\u00e9finie \u00e0 une valeur non nulle, elle doit se situer dans la plage des valeurs z du maillage. # Les utilisateurs qui souhaitent converger vers la position de mise \u00e0 l'origine du Z # doivent r\u00e9gler cette valeur \u00e0 0. # La valeur par d\u00e9faut est la valeur z moyenne du maillage. #split_delta_z: .025 # Le delta de diff\u00e9rence de Z (en mm) le long d'un mouvement qui d\u00e9clenchera une s\u00e9paration. # La valeur par d\u00e9faut est de 0,025. #move_check_distance: 5.0 # La distance (en mm) le long d'un mouvement pour v\u00e9rifier le split_delta_z. # C'est \u00e9galement la longueur minimale pour laquelle un mouvement peut \u00eatre divis\u00e9. # La valeur par d\u00e9faut est 5.0. #mesh_pps: 2, 2 # Une paire de nombres entiers X, Y s\u00e9par\u00e9s par des virgules, d\u00e9finissant le nombre de # points par segment \u00e0 interpoler dans le maillage le long de chaque axe. Un \"segment\" # \u00e9tant d\u00e9fini comme l'espace entre chaque point palp\u00e9. # L'utilisateur peut saisir une seule valeur qui sera appliqu\u00e9e aux deux axes. # La valeur par d\u00e9faut est 2, 2. #algorithme: lagrange # L'algorithme d'interpolation \u00e0 utiliser. Soit \"lagrange\", soit \"bicubic\". Cette option # n'affecte pas les grilles 3x3 forc\u00e9es d'utiliser l'\u00e9chantillonnage de lagrange. # La valeur par d\u00e9faut est lagrange. #bicubic_tension: .2 # Lors de l'utilisation de l'algorithme bicubic, le param\u00e8tre de tension ci-dessus peut # \u00eatre appliqu\u00e9 pour modifier la quantit\u00e9 de pente interpol\u00e9e. # Des nombres plus grands augmenteront la quantit\u00e9 de pente entra\u00eenant une plus grande # courbure du maillage. La valeur par d\u00e9faut est 0,2. #relative_reference_index: # Un index de points dans le maillage auquel r\u00e9f\u00e9rencer toutes les valeurs z. En activant # ce param\u00e8tre, on produit un maillage relatif \u00e0 la position z palp\u00e9e de l'indice fourni. #faulty_region_1_min: #faulty_region_1_max: # Points optionnels d\u00e9finissant une r\u00e9gion d\u00e9fectueuse. Voir docs/Bed_Mesh.md pour # plus de d\u00e9tails sur les r\u00e9gions d\u00e9fectueuses. Jusqu'\u00e0 99 r\u00e9gions d\u00e9fectueuses peuvent # \u00eatre ajout\u00e9es. # Par d\u00e9faut, aucune r\u00e9gion d\u00e9fectueuse n'est d\u00e9finie. [bed_tilt] \u00b6 Compensation de l'inclinaison du lit. On peut d\u00e9finir une section de configuration bed_tilt pour activer les transformations de d\u00e9placement tenant compte d'un lit inclin\u00e9. Notez que bed_mesh et bed_tilt sont incompatibles ; les deux ne peuvent pas \u00eatre d\u00e9finis en m\u00eame temps. Voir la r\u00e9f\u00e9rence des commandes pour plus d'informations. [bed_tilt] #x_adjust: 0 # Quantit\u00e9 \u00e0 ajouter \u00e0 la hauteur Z de chaque mouvement pour chaque mm sur l'axe X. # La valeur par d\u00e9faut est 0. #y_adjust: 0 # Quantit\u00e9 \u00e0 ajouter \u00e0 la hauteur Z de chaque mouvement pour chaque mm sur l'axe Y. # La valeur par d\u00e9faut est 0. #z_adjust: 0 # Quantit\u00e9 \u00e0 ajouter \u00e0 la hauteur Z lorsque la buse est nominalement \u00e0 0, 0. # La valeur par d\u00e9faut est 0. # Les param\u00e8tres suivants contr\u00f4lent la commande g-code \u00e9tendue BED_TILT_CALIBRATE # utilis\u00e9e pour calibrer les param\u00e8tres de r\u00e9glage x et y appropri\u00e9s. #points: # Une liste de coordonn\u00e9es X, Y (une par ligne ; les lignes suivantes indent\u00e9es) devant # \u00eatre palp\u00e9es pendant une commande BED_TILT_CALIBRATE # Sp\u00e9cifiez les coordonn\u00e9es de la buse et assurez-vous que la sonde est au-dessus du lit # aux coordonn\u00e9es donn\u00e9es de la buse. # La valeur par d\u00e9faut est de ne pas activer la commande. #speed: 50 # Vitesse (en mm/s) des mouvements de d\u00e9placements hors palpage pendant l'\u00e9talonnage. # La valeur par d\u00e9faut est 50. #horizontal_move_z: 5 # Hauteur (en mm) \u00e0 laquelle la t\u00eate doit \u00eatre relev\u00e9e lors du d\u00e9placement juste avant # de lancer une op\u00e9ration de palpage. La valeur par d\u00e9faut est 5. [bed_screws] \u00b6 Outil d'aide au r\u00e9glage des vis de nivellement du lit. On peut d\u00e9finir une section de configuration [bed_screws] pour activer une commande g-code BED_SCREWS_ADJUST. Consultez le guide de nivelage et la r\u00e9f\u00e9rence des commandes pour plus d'informations. [bed_screws] #screw1: # Coordonn\u00e9es X, Y de la premi\u00e8re vis de r\u00e9glage du niveau du lit. Il s'agit de la # position vers laquelle d\u00e9placer la buse afin qu'elle soit plac\u00e9e au-dessus de cette # vis de r\u00e9glage (ou aussi proche que possible tout en \u00e9tant au-dessus du lit). # Ce param\u00e8tre doit \u00eatre fourni. #screw1_name: # Un nom arbitraire pour la vis donn\u00e9e. Ce nom est affich\u00e9 lors de # l'ex\u00e9cution du script d'aide. Par d\u00e9faut, le nom utilis\u00e9 est bas\u00e9 sur # la position XY de la vis. #screw1_fine_adjust : # Coordonn\u00e9es X, Y pour commander la buse afin de pouvoir affiner le r\u00e9glage de la vis de mise # \u00e0 niveau du lit. Par d\u00e9faut, il n'y a pas de r\u00e9glage fin sur la vis de mise \u00e0 niveau du lit. #screw2: #screw2_name: #screw2_fine_adjust: #... # Vis suppl\u00e9mentaires de mise \u00e0 niveau du lit. Au moins trois vis doivent \u00eatre # d\u00e9finies. #horizontal_move_z: 5 # Hauteur (en mm) \u00e0 laquelle la t\u00eate doit \u00eatre relev\u00e9e pour se d\u00e9placer # lors du passage d'une vis \u00e0 la suivante. La valeur par d\u00e9faut est 5. #probe_height: 0 # Hauteur de la sonde (en mm) apr\u00e8s ajustement d\u00fb \u00e0 la dilatation thermique # du lit et de la buse. La valeur par d\u00e9faut est z\u00e9ro. #speed: 50 # Vitesse (en mm/s) des d\u00e9placements entre les palpages pendant l'\u00e9talonnage. # La valeur par d\u00e9faut est 50. #probe_speed: 5 # Vitesse (en mm/s) lors du d\u00e9placement d'une position horizontal_move_z # \u00e0 la position probe_height. La valeur par d\u00e9faut est 5. [screws_tilt_adjust] \u00b6 Outil d'assistance au nivellement du lit avec les vis de r\u00e9glage et l'aide du palpeur Z. On peut d\u00e9finir une section de configuration screws_tilt_adjust pour activer une commande g-code SCREWS_TILT_CALCULATE. Voir le guide de nivelage et la r\u00e9f\u00e9rence des commandes pour des informations suppl\u00e9mentaires. [screws_tilt_adjust] #screw1: # Les coordonn\u00e9es (X, Y) de la premi\u00e8re vis de mise \u00e0 niveau du lit. Il s'agit d'une # position \u00e0 laquelle d\u00e9placer la buse de mani\u00e8re \u00e0 ce que la sonde soit directement # au-dessus de la vis de mise \u00e0 niveau du lit (ou aussi pr\u00e8s que possible tout en \u00e9tant # encore au-dessus du lit). Il s'agit de la vis de base utilis\u00e9e dans les calculs. # Ce param\u00e8tre doit \u00eatre fourni. #screw1_name: # Un nom arbitraire pour la vis donn\u00e9e. Ce nom est affich\u00e9 lorsque le script d'aide # s'ex\u00e9cute. Par d\u00e9faut, le nom utilis\u00e9 est bas\u00e9 sur la position XY de la vis. #screw2: #screw2_name: #... # Vis suppl\u00e9mentaires de mise \u00e0 niveau du lit. Au moins deux vis doivent \u00eatre # d\u00e9finies. #speed: 50 # La vitesse (en mm/s) des d\u00e9placements sans palpage pendant l'\u00e9talonnage. # La valeur par d\u00e9faut est 50. #horizontal_move_z: 5 # La hauteur (en mm) \u00e0 laquelle la t\u00eate doit \u00eatre lev\u00e9e pour se d\u00e9placer juste # avant de lancer une op\u00e9ration de palpage. La valeur par d\u00e9faut est 5. #screw_thread: CW-M3 # Le type de vis utilis\u00e9e pour le niveau du lit, M3, M4 ou M5 et la direction de la molette # utilis\u00e9e pour le nivelage du lit, diminution dans le sens des aiguilles d'une montre, # augmentation dans le sens inverse des aiguilles d'une montre. # Valeurs accept\u00e9es : CW-M3, CCW-M3, CW-M4, CCW-M4, CW-M5, CCW-M5. # La valeur par d\u00e9faut est CW-M3. De nombreuses imprimantes utilisent une vis M3, # un tour de molette dans le sens des aiguilles d'une montre diminue la distance. [z_tilt] \u00b6 R\u00e9glage multiples de l'inclinaison de moteurs pas \u00e0 pas de l'axe Z. Cette fonction permet d'ajuster de mani\u00e8re ind\u00e9pendante l'inclinaison de plusieurs moteurs Z (voir la section \"stepper_z1\"). Si cette section est pr\u00e9sente, une commande G-Code \u00e9tendue Z_TILT_ADJUST devient disponible. [z_tilt] #z_positions: # Une liste de coordonn\u00e9es X, Y (une par ligne ; les lignes subs\u00e9quentes # indent\u00e9es) d\u00e9crivant l'emplacement de chaque \"point de pivot\" du lit. # Le \"point de pivot\" est le point o\u00f9 le lit s'attache \u00e0 l'\u00e9l\u00e9ment Z # donn\u00e9. Il est d\u00e9crit \u00e0 l'aide des coordonn\u00e9es de la buse (la position X, Y # de la buse si elle pouvait se d\u00e9placer directement au-dessus du point). La # premi\u00e8re entr\u00e9e correspond \u00e0 stepper_z, la deuxi\u00e8me \u00e0 stepper_z1, # la troisi\u00e8me \u00e0 stepper_z2, etc. Ce param\u00e8tre doit \u00eatre fourni. #points: # Une liste de coordonn\u00e9es X, Y (une par ligne ; les lignes ult\u00e9rieures # indent\u00e9es) qui doivent \u00eatre palp\u00e9es pendant une commande Z_TILT_ADJUST. # Sp\u00e9cifiez les coordonn\u00e9es de la buse et assurez-vous que le palpeur est # au-dessus du lit aux coordonn\u00e9es donn\u00e9es de la buse. # Ce param\u00e8tre doit \u00eatre fourni. #speed: 50 # La vitesse (en mm/s) des mouvements de d\u00e9placements hors palpage # pendant l'\u00e9talonnage. La valeur par d\u00e9faut est 50. #horizontal_move_z: 5 # Hauteur (en mm) \u00e0 laquelle la t\u00eate doit \u00eatre relev\u00e9e pour se d\u00e9placer juste # avant de lancer une op\u00e9ration de palpage. La valeur par d\u00e9faut est 5. #retries: 0 # Nombre de tentatives \u00e0 effectuer si les points palp\u00e9s ne sont pas dans la # tol\u00e9rance. #retry_tolerance: 0 # Si les r\u00e9-essais sont activ\u00e9s, r\u00e9essayer si les points sond\u00e9s les plus grands et # les plus petits diff\u00e8rent plus que la tol\u00e9rance retry_tolerance. Notez que la # plus petite unit\u00e9 de changement ici serait un seul pas. Cependant, si vous # sondez plus de points que de moteurs, il est probable que vous aurez une # valeur minimale fixe pour la plage de points sond\u00e9s. Vous pouvez en # apprendre plus en observant la sortie de la commande. [quad_gantry_level] \u00b6 Mise \u00e0 niveau du portique mobile \u00e0 l'aide de 4 moteurs Z contr\u00f4l\u00e9s ind\u00e9pendamment. Corrige les effets de paraboles hyperboliques (chips de pommes de terre) sur un portique mobile qui est plus flexible. AVERTISSEMENT : l'utilisation de cette section sur un lit mobile peut conduire \u00e0 des r\u00e9sultats ind\u00e9sirables. Si cette section est pr\u00e9sente, une commande G-Code \u00e9tendue QUAD_GANTRY_LEVEL devient disponible. Cette routine suppose la configuration suivante des moteurs Z : ---------------- |Z1 Z2| | --------- | | | | | | | | | | x-------- | |Z Z3| ---------------- O\u00f9 x est la position 0, 0 sur le lit [quad_gantry_level] #gantry_corners: # Une liste de coordonn\u00e9es X, Y, s\u00e9par\u00e9es par des retours \u00e0 la ligne, d\u00e9crivant les deux # coins oppos\u00e9s du portique. La premi\u00e8re entr\u00e9e correspond \u00e0 Z, la seconde \u00e0 Z2. # Ce param\u00e8tre doit \u00eatre fourni. #points: # Une liste, s\u00e9par\u00e9e par des retours \u00e0 la ligne, de quatre points X, Y devant \u00eatre palp\u00e9s # pendant une commande QUAD_GANTRY_LEVEL. L'ordre des emplacements est # important, il doit correspondre aux emplacements Z, Z1, Z2 et Z3 dans l'ordre. # Ce param\u00e8tre doit \u00eatre fourni. Pour une pr\u00e9cision maximale, assurez-vous que les # d\u00e9calages de votre sonde sont configur\u00e9s. #speed: 50 # La vitesse (en mm/s) des mouvements sans palpage pendant l'\u00e9talonnage. # La valeur par d\u00e9faut est 50. #horizontal_move_z: 5 # La hauteur (en mm) \u00e0 laquelle la t\u00eate doit \u00eatre relev\u00e9e pour se d\u00e9placer juste # avant de lancer une op\u00e9ration de palpage. La valeur par d\u00e9faut est 5. #max_adjust: 4 # Limite de s\u00e9curit\u00e9 quand un ajustement sup\u00e9rieur \u00e0 cette valeur est demand\u00e9. # quad_gantry_level abandonnera. #retries: 0 # Nombre de tentatives si les points palp\u00e9s ne sont pas dans la tol\u00e9rance. #retry_tolerance: 0 # Si les re-tentatives (retries) sont activ\u00e9es, r\u00e9essayer si les points palp\u00e9s les plus grands # et les plus petits diff\u00e8rent plus que la tol\u00e9rance de re-tentative (retry_tolerance). [skew_correction] \u00b6 Correction de l'inclinaison de l'imprimante. Il est possible de corriger l'inclinaison de l'imprimante logiciellement sur 3 plans, xy, xz, yz. Pour ce faire, on imprime un mod\u00e8le d'\u00e9talonnage le long d'un plan et on mesure trois longueurs. En raison de la nature de la correction d'inclinaison, ces longueurs sont d\u00e9finies via le gcode. Voir Correction d'inclinaison et R\u00e9f\u00e9rence des commandes pour plus de d\u00e9tails. [skew_correction] [z_thermal_adjust] \u00b6 Ajustement de la position Z de la t\u00eate d'impression en fonction de la temp\u00e9rature. Compenser le mouvement vertical de la t\u00eate d'impression caus\u00e9 par la dilatation thermique du ch\u00e2ssis de l'imprimante en temps r\u00e9el \u00e0 l'aide d'un capteur de temp\u00e9rature (g\u00e9n\u00e9ralement coupl\u00e9 \u00e0 une section verticale du ch\u00e2ssis). Voir aussi : commandes de code G \u00e9tendues . [z_thermal_adjust] #temp_coeff: # Le coefficient de dilatation thermique, en mm/\u00b0C. Par exemple, un # temp_coeff de 0,01 mm/\u00b0C d\u00e9placera l'axe Z vers le bas de 0,01 mm pour # chaque degr\u00e9 Celsius d'augmentation du capteur de temp\u00e9rature. La # valeur par d\u00e9faut, 0,0 mm/\u00b0C, n'applique aucun ajustement. #smooth_time: # Fen\u00eatre de lissage appliqu\u00e9e au capteur de temp\u00e9rature, en secondes. # Peut r\u00e9duire le bruit du moteur d\u00fb \u00e0 de petites corrections excessives en # r\u00e9ponse au bruit du capteur. La valeur par d\u00e9faut est de 2,0 secondes. #z_adjust_off_above: # D\u00e9sactive les ajustements au-dessus de cette hauteur Z [mm]. La derni\u00e8re # correction calcul\u00e9e restera appliqu\u00e9e jusqu'\u00e0 ce que la t\u00eate de l'outil passe # \u00e0 nouveau en dessous de la hauteur Z sp\u00e9cifi\u00e9e. La valeur par d\u00e9faut est # 99999999.0 mm (toujours actif). #max_z_adjustment: # Ajustement absolu maximal pouvant \u00eatre appliqu\u00e9 \u00e0 l'axe Z [mm]. # La valeur par d\u00e9faut est 99999999.0 mm (illimit\u00e9). #sensor_type: #sensor_pin: #min_temp: #max_temp: # Configuration du capteur de temp\u00e9rature. # Voir la section \"extrudeuse\" pour la d\u00e9finition des param\u00e8tres ci-dessus. #gcode_id: # Voir la section \"heater_generic\" pour la d\u00e9finition de ce # param\u00e8tre. Mise \u00e0 l'origine personnalis\u00e9e \u00b6 [safe_z_home] \u00b6 Mise \u00e0 l'origine s\u00fbre de l'axe Z. On peut utiliser ce m\u00e9canisme pour centrer l'axe Z sur des coordonn\u00e9es X, Y sp\u00e9cifiques. Ceci est utile si la t\u00eate de l'outil, par exemple, doit se d\u00e9placer vers le centre du lit avant que l'axe Z puisse \u00eatre mis \u00e0 l'origine. [safe_z_home] home_xy_position: # Une coordonn\u00e9e X, Y (par exemple 100, 100) o\u00f9 la mise \u00e0 l'origine Z doit \u00eatre # effectu\u00e9e. Ce param\u00e8tre doit \u00eatre fourni. #speed: 50.0 # Vitesse \u00e0 laquelle la t\u00eate de l'outil est d\u00e9plac\u00e9e vers la position de r\u00e9f\u00e9rence Z s\u00fbre. # La valeur par d\u00e9faut est 50 mm/s #z_hop: # Distance (en mm) pour lever l'axe Z avant le retour au point d'origine. Cette valeur est # appliqu\u00e9e \u00e0 toute commande d'initialisation, m\u00eame si elle n'initialise pas l'axe Z. # Si l'axe Z est d\u00e9j\u00e0 ramen\u00e9 \u00e0 la position de base et que la position Z actuelle est inf\u00e9rieure # \u00e0 z_hop, alors ceci l\u00e8vera la t\u00eate \u00e0 une hauteur de z_hop. Si l'axe Z n'est pas d\u00e9j\u00e0 centr\u00e9, # la t\u00eate est relev\u00e9e de z_hop. # La valeur par d\u00e9faut est de ne pas impl\u00e9menter le relevage en Z. #z_hop_speed: 15.0 # Vitesse (en mm/s) \u00e0 laquelle l'axe Z est relev\u00e9 avant le retour \u00e0 la position initiale. # La valeur par d\u00e9faut est de 15 mm/s. #move_to_previous: False # Lorsqu'il a la valeur True, les axes X et Y sont r\u00e9initialis\u00e9s \u00e0 leurs positions pr\u00e9c\u00e9dentes apr\u00e8s # retour \u00e0 la position initiale de l'axe Z. La valeur par d\u00e9faut est False. [homing_override] \u00b6 Homing override. On peut utiliser ce m\u00e9canisme pour ex\u00e9cuter une s\u00e9rie de commandes g-code \u00e0 la place d'un G28 trouv\u00e9 dans l'entr\u00e9e g-code normale. Cela peut \u00eatre utile sur les imprimantes qui n\u00e9cessitent une proc\u00e9dure sp\u00e9cifique du retour au point d'origine de la machine. [homing_override] gcode: # Une liste de commandes G-Code \u00e0 ex\u00e9cuter \u00e0 la place des commandes G28 # trouv\u00e9es dans l'entr\u00e9e g-code normale. Voir docs/Command_Templates.md # pour le format G-Code. Si un G28 est contenu dans cette liste de commandes # alors la proc\u00e9dure de mise \u00e0 l'origine de l'imprimante sera invoqu\u00e9e. # Les commandes \u00e9num\u00e9r\u00e9es ici doivent ramener tous les axes \u00e0 la position initiale. # Ce param\u00e8tre doit \u00eatre fourni. #axes: xyz # Les axes \u00e0 remplacer. Par exemple, si ce param\u00e8tre est d\u00e9fini sur \"z\", alors le script # d'annulation ne sera ex\u00e9cut\u00e9 que lorsque l'axe z est mis \u00e0 l'origine (par ex. # une commande \"G28\" ou \"G28 Z\"). Remarque : le script de neutralisation doit # toujours g\u00e9rer tous les axes. La valeur par d\u00e9faut est \"xyz\" ce qui fait que le script # de remplacement sera ex\u00e9cut\u00e9 \u00e0 la place de toutes les commandes G28. #set_position_x: #set_position_y: #set_position_z: # Si sp\u00e9cifi\u00e9, l'imprimante supposera que l'axe est \u00e0 la position sp\u00e9cifi\u00e9e avant # d'ex\u00e9cuter les commandes g-code ci-dessus. Le fait de d\u00e9finir ceci d\u00e9sactive les # contr\u00f4les d'orientation pour cet axe. Cela peut \u00eatre utile si la t\u00eate doit se d\u00e9placer # avant d'invoquer le m\u00e9canisme G28 normal d'un axe. # La valeur par d\u00e9faut est de ne pas forcer une position pour un axe. [endstop_phase] \u00b6 Interrupteurs de fin de course ajust\u00e9s \u00e0 la phase du moteur pas \u00e0 pas. Pour utiliser cette fonction, d\u00e9finissez une section de configuration avec un pr\u00e9fixe \"endstop_phase\" suivi du nom de la section de configuration du moteur pas \u00e0 pas correspondante (par exemple, \"[endstop_phase stepper_z]\"). Cette fonctionnalit\u00e9 peut am\u00e9liorer la pr\u00e9cision des interrupteurs de fin de course. Ajoutez une d\u00e9claration nue \"[endstop_phase]\" pour activer la commande ENDSTOP_PHASE_CALIBRATE. Voir le guide de d\u00e9tecteurs de fin de course et la r\u00e9f\u00e9rence des commandes pour plus d'informations. [endstop_phase stepper_z] #endstop_accuracy: # D\u00e9finit la pr\u00e9cision attendue (en mm) de la but\u00e9e. Cela repr\u00e9sente la distance d'erreur # maximale que la but\u00e9e peut d\u00e9clencher (par exemple, si une but\u00e9e peut occasionnellement # se d\u00e9clencher 100um en avance ou jusqu'\u00e0 100um en retard alors r\u00e9glez cette valeur # sur 0.200 pour 200um). La valeur par d\u00e9faut est 4*rotation_distance/full_steps_per_rotation. #trigger_phase: # Sp\u00e9cifie la phase du pilote du moteur pas \u00e0 pas \u00e0 attendre lorsque l'on atteint la but\u00e9e. # Compos\u00e9 de deux nombres s\u00e9par\u00e9s par une barre oblique - la phase et le nombre total # de phases (par exemple, \"7/64\"). Ne d\u00e9finissez cette valeur que si vous \u00eates s\u00fbr que le # pilote du moteur pas \u00e0 pas est r\u00e9initialis\u00e9 \u00e0 chaque fois que le mcu est r\u00e9initialis\u00e9. # Si cette valeur n'est pas d\u00e9finie, alors la phase du moteur pas \u00e0 pas sera d\u00e9tect\u00e9e \u00e0 la # premi\u00e8re mise \u00e0 l'origine et cette phase sera utilis\u00e9e sur toutes les origines suivantes. #endstop_align_zero: False # Si vrai, la position_endstop de l'axe sera effectivement modifi\u00e9e de mani\u00e8re \u00e0 ce que la # position z\u00e9ro de l'axe se produise sur un pas complet du moteur pas \u00e0 pas. (Si utilis\u00e9 sur # l'axe Z et que la hauteur de la couche d'impression est un multiple de la distance parcourue # par un pas complet, alors chaque couche se produira sur un pas complet). # La valeur par d\u00e9faut est False. Macros et \u00e9v\u00e9nements G-Code \u00b6 [gcode_macro] \u00b6 Macros G-Code (on peut d\u00e9finir un nombre quelconque de sections avec le pr\u00e9fixe \"gcode_macro\"). Voir le guide des mod\u00e8les de commande pour plus d'informations. [gcode_macro my_cmd] #gcode: # Une liste de commandes G-Code \u00e0 ex\u00e9cuter \u00e0 la place de \"my_cmd\". Voir # docs/Command_Templates.md pour le format G-Code. Ce param\u00e8tre doit # \u00eatre fourni. #variable_<name>: # On peut sp\u00e9cifier un nombre quelconque d'options avec le pr\u00e9fixe \"variable_\". # Le nom de variable donn\u00e9 se verra attribu\u00e9 la valeur donn\u00e9e (analys\u00e9e en tant # que litt\u00e9ral par Python) et sera disponible pendant l'expansion de la macro. # Par exemple, une configuration avec \"variable_fan_speed = 75\" pourrait avoir # des commandes gcode contenant \"M106 S{ fan_speed * 255 }\". Ces variables # peuvent alors \u00eatre modifi\u00e9es au moment de l'ex\u00e9cution en utilisant la commande # SET_GCODE_VARIABLE (voir docs/Command_Templates.md pour plus de d\u00e9tails). # Les noms de variables peuvent ne pas utiliser de caract\u00e8res majuscules. #rename_existing: # Cette option permet \u00e0 la macro de remplacer une commande G-Code existante # et fournira la d\u00e9finition pr\u00e9c\u00e9dente de la commande via le nom fourni ici. Ceci # peut \u00eatre utilis\u00e9 pour remplacer les commandes G-Code originelles. Il convient # d'\u00eatre prudent lorsque l'on remplace des commandes, cela pouvant provoquer # des r\u00e9sultats complexes et inattendus. La valeur par d\u00e9faut est de ne pas # remplacer une commande G-Code existante. #description: Macro G-Code # Ceci ajoutera une courte description utilis\u00e9e \u00e0 la commande HELP ou lors de # l'utilisation de la fonction de compl\u00e9tion automatique. # Par d\u00e9faut : \"G-Code macro\". [delayed_gcode] \u00b6 Ex\u00e9cute un gcode sur un d\u00e9lai d\u00e9fini. Voir le guide des mod\u00e8les de commande et la r\u00e9f\u00e9rence des commandes pour plus d'informations. [delayed_gcode my_delayed_gcode] gcode: # Une liste de commandes G-Code \u00e0 ex\u00e9cuter lorsque la dur\u00e9e du d\u00e9lai est \u00e9coul\u00e9e. # Les mod\u00e8les G-Code sont support\u00e9s. Ce param\u00e8tre doit \u00eatre fourni. #initial_duration: 0.0 # Dur\u00e9e du d\u00e9lai initial (en secondes). Si elle est d\u00e9finie \u00e0 une valeur non nulle, le gcode # diff\u00e9r\u00e9 s'ex\u00e9cutera le nombre de secondes sp\u00e9cifi\u00e9 apr\u00e8s que l'imprimante passe \u00e0 # l'\u00e9tat \"pr\u00eat\". Ceci peut \u00eatre utile pour les proc\u00e9dures d'initialisation ou lors d'une # r\u00e9p\u00e9tition de delayed_gcode. Si la valeur est 0, le delayed_gcode ne sera pas ex\u00e9cut\u00e9 # au d\u00e9marrage. # La valeur par d\u00e9faut est 0. [save_variables] \u00b6 Prise en charge de l'enregistrement des variables sur le disque afin qu'elles soient conserv\u00e9es lors des red\u00e9marrages. Voir mod\u00e8les de commande et r\u00e9f\u00e9rence G-code pour plus d'informations. [save_variables] filename: # Obligatoire - fournir un nom de fichier utilis\u00e9 pour enregistrer les variables # sur le disque, par exemple ~/variables.cfg. [idle_timeout] \u00b6 D\u00e9lai d'inactivit\u00e9. Un d\u00e9lai d'inactivit\u00e9 est automatiquement activ\u00e9 - ajoutez une section de configuration idle_timeout explicite pour modifier les param\u00e8tres par d\u00e9faut. [idle_timeout] #gcode: # Une liste de commandes G-Code \u00e0 ex\u00e9cuter lors d'un d\u00e9lai d'inactivit\u00e9. Voir # docs/Command_Templates.md pour le format G-Code. La valeur par d\u00e9faut # est d'ex\u00e9cuter \"TURN_OFF_HEATERS\" et \"M84\". #timeout: 600 # Dur\u00e9e d'attente (en secondes) avant d'ex\u00e9cuter les commandes G-Code ci-dessus. # La valeur par d\u00e9faut est de 600 secondes. Fonctionnalit\u00e9s optionnelles du G-code \u00b6 [virtual_sdcard] \u00b6 Une carte SD virtuelle peut \u00eatre utile si la machine h\u00f4te n'est pas assez rapide pour faire fonctionner OctoPrint correctement. Elle permet au logiciel h\u00f4te Klipper d'imprimer directement les fichiers gcode stock\u00e9s dans un r\u00e9pertoire sur l'h\u00f4te en utilisant les commandes G-Code standard de la carte SD (par exemple, M24). [virtual_sdcard] path: # Le chemin d'acc\u00e8s au r\u00e9pertoire local sur la machine h\u00f4te de recherche # des fichiers g-code. Il s'agit d'un r\u00e9pertoire en lecture seule (les \u00e9critures # de fichiers sur une carte SD ne sont pas support\u00e9es). On peut le faire pointer # vers le r\u00e9pertoire de t\u00e9l\u00e9chargement d'OctoPrint (g\u00e9n\u00e9ralement # ~/.octoprint/uploads/ ). Ce param\u00e8tre doit \u00eatre fourni. #on_error_gcode: # Une liste de commandes G-Code \u00e0 ex\u00e9cuter lorsqu'une erreur est signal\u00e9e. [sdcard_loop] \u00b6 Certaines imprimantes dot\u00e9es de fonctions d'\u00e9jections des pi\u00e8ces imprim\u00e9es, comme un \u00e9jecteur de pi\u00e8ces ou une imprimante \u00e0 courroie, peuvent trouver une utilit\u00e9 dans la mise en boucle de sections du fichier de la carte SD (par exemple, pour imprimer la m\u00eame pi\u00e8ce encore et encore, ou r\u00e9p\u00e9ter une section d'une pi\u00e8ce pour une cha\u00eene ou un autre motif r\u00e9p\u00e9t\u00e9). Voir la r\u00e9f\u00e9rence des commandes pour les commandes prises en charge. Voir le fichier sample-macros.cfg pour une macro G-Code compatible avec le M808 de Marlin. [sdcard_loop] [force_move] \u00b6 Support des d\u00e9placements manuels des moteurs pas \u00e0 pas \u00e0 des fins de diagnostic. Remarque : l'utilisation de cette fonction peut placer l'imprimante dans un \u00e9tat invalide - consultez la r\u00e9f\u00e9rence de la commande pour obtenir des d\u00e9tails importants. [force_move] #enable_force_move: False # D\u00e9fini \u00e0 true pour activer les commandes G-Code \u00e9tendues FORCE_MOVE et # SET_KINEMATIC_POSITION # La valeur par d\u00e9faut est false. [pause_resume] \u00b6 Fonctionnalit\u00e9 Pause/Reprise avec prise en charge de la capture et de la restauration de position. Voir la r\u00e9f\u00e9rence de la commande pour plus d'informations. [pause_resume] #recover_velocity: 50. # Lorsque la capture/restauration est activ\u00e9e, la vitesse \u00e0 laquelle retourner \u00e0 # la position captur\u00e9e (en mm/s). La valeur par d\u00e9faut est 50,0 mm/s. [firmware_retraction] \u00b6 R\u00e9traction du filament par le firmware. Cela permet d'activer les commandes GCODE G10 (r\u00e9traction) et G11 (d\u00e9-r\u00e9traction) \u00e9mises par de nombreux trancheurs. Les param\u00e8tres ci-dessous fournissent des valeurs par d\u00e9faut au d\u00e9marrage, ces valeurs peuvent \u00eatre ajust\u00e9es via la commande SET_RETRACTION , ce qui permet des r\u00e9glages par filament et des ajustements en cours d'impression. [firmware_retraction] #retract_length: 0 # La longueur du filament (en mm) \u00e0 r\u00e9tracter lorsque G10 est activ\u00e9, et \u00e0 fournir # lorsque G11 est activ\u00e9 (voir unretract_extra_length ci-dessous). # La valeur par d\u00e9faut est 0 mm. #retract_speed: 20 # La vitesse de r\u00e9traction, en mm/s. La valeur par d\u00e9faut est 20 mm/s. #unretract_extra_length: 0 # Longueur (en mm) de filament *suppl\u00e9mentaire* \u00e0 ajouter lors de la d\u00e9-r\u00e9traction. #unretract_speed: 10 # La vitesse de d\u00e9-r\u00e9traction, en mm/s. La valeur par d\u00e9faut est 10 mm/s. [gcode_arcs] \u00b6 Support des commandes gcode de courbes (arc) (G2/G3). [gcode_arcs] #resolution: 1.0 # Un arc sera divis\u00e9 en segments. La longueur de chaque segment sera \u00e9gale \u00e0 # la r\u00e9solution en mm d\u00e9finie ci-dessus. Des valeurs plus faibles produiront un # arc plus fin, mais \u00e9galement plus de travail de votre machine. Les arcs plus # petits que la valeur configur\u00e9e deviendront des lignes droites. La valeur par # d\u00e9faut est 1 mm. [respond] \u00b6 Active les commandes \u00e9tendues \"M118\" et \"RESPOND\" . [respond] #default_type: echo # D\u00e9finit le pr\u00e9fixe par d\u00e9faut de la sortie \"M118\" et \"RESPOND\" \u00e0 l'un des # \u00e9l\u00e9ments suivants : # echo: \"echo : \" (C'est la valeur par d\u00e9faut) # command: \"// \" # error: \" !! \" #default_prefix: echo: # D\u00e9finit directement le pr\u00e9fixe par d\u00e9faut. Si elle est pr\u00e9sente, cette valeur # remplacera celle de \"default_type\". [exclude_object] \u00b6 Permet de prendre en charge l'exclusion ou l'annulation d'objets individuels pendant le processus d'impression. Voir le guide des objets exclus et la r\u00e9f\u00e9rence des commandes pour plus d'informations. Voir le fichier sample-macros.cfg pour une macro G-Code M486 compatible avec Marlin/RepRapFirmware. [exclude_object] Compensation de la r\u00e9sonance \u00b6 [input_shaper] \u00b6 Active la compensation de r\u00e9sonance . Voir \u00e9galement la r\u00e9f\u00e9rence des commandes . [input_shaper] #shaper_freq_x: 0 # Fr\u00e9quence (en Hz) de la mise en forme de l'entr\u00e9e pour l'axe X. Il s'agit g\u00e9n\u00e9ralement # d'une fr\u00e9quence de r\u00e9sonance de l'axe X que la mise en forme de l'entr\u00e9e doit supprimer. # Pour les mises en forme plus complexes, comme les mises en forme \u00e0 2 ou 3 bosses EI # (2hump/3hump), ce param\u00e8tre peut \u00eatre d\u00e9fini \u00e0 partir de diff\u00e9rentes consid\u00e9rations. # La valeur par d\u00e9faut est 0, ce qui d\u00e9sactive la mise en forme de l'entr\u00e9e pour l'axe X. #shaper_freq_y: 0 # Fr\u00e9quence (en Hz) de la mise en forme de l'entr\u00e9e pour l'axe Y. Il s'agit g\u00e9n\u00e9ralement # d'une fr\u00e9quence de r\u00e9sonance de l'axe Y que la mise en forme de l'entr\u00e9e doit supprimer. # Pour les mises en forme plus complexes, comme les mises en forme \u00e0 2 ou 3 bosses EI # (2hump/3hump), ce param\u00e8tre peut \u00eatre d\u00e9fini \u00e0 partir de diff\u00e9rentes consid\u00e9rations. # La valeur par d\u00e9faut est 0, ce qui d\u00e9sactive la mise en forme de l'entr\u00e9e pour l'axe Y. #shaper_type: mzv # Le type de mise en forme de l'entr\u00e9e \u00e0 utiliser pour les axes X et Y. Les types support\u00e9s # sont zv, mzv, zvd, ei, 2hump_ei, et 3hump_ei. # La valeur par d\u00e9faut est la compensation de r\u00e9sonance mzv. #shaper_type_x: #shaper_type_y: # Si shaper_type n'est pas d\u00e9fini, ces deux param\u00e8tres peuvent \u00eatre utilis\u00e9s pour configurer # des formes d'entr\u00e9e diff\u00e9rentes pour les axes X et Y. Les valeurs support\u00e9es sont les # m\u00eames que celles du param\u00e8tre shaper_type. #damping_ratio_x: 0.1 #damping_ratio_y: 0.1 # Taux d'amortissement des vibrations des axes X et Y utilis\u00e9s par les dispositifs de mise # en forme de l'entr\u00e9e afin d'am\u00e9liorer la suppression des vibrations. La valeur par d\u00e9faut est # 0.1 ce qui est une bonne valeur g\u00e9n\u00e9rale pour la plupart des imprimantes. Dans la plupart # des cas, ce param\u00e8tre ne n\u00e9cessite aucun r\u00e9glage et ne doit pas \u00eatre modifi\u00e9. [adxl345] \u00b6 Support des acc\u00e9l\u00e9rom\u00e8tres ADXL345. Ce support permet d'interroger les mesures de l'acc\u00e9l\u00e9rom\u00e8tre \u00e0 partir du capteur. Cela active une commande ACCELEROMETER_MEASURE (voir G-Codes pour plus d'informations). Le nom de la puce par d\u00e9faut est \"default\", mais on peut sp\u00e9cifier un nom explicite (par exemple, [adxl345 my_chip_name]). [adxl345] cs_pin: # La broche d'activation SPI du capteur. Ce param\u00e8tre doit \u00eatre fourni. #spi_speed: 5000000 # La vitesse SPI (en hz) \u00e0 utiliser lors de la communication avec la puce. # La valeur par d\u00e9faut est 5000000. #spi_bus: #spi_software_sclk_pin: #spi_software_mosi_pin: #spi_software_miso_pin: # Voir la section \"param\u00e8tres SPI communs\" pour une description des # param\u00e8tres ci-dessus. #axes_map : x, y, z # L'axe de l'acc\u00e9l\u00e9rom\u00e8tre de chacun des axes X, Y et Z de l'imprimante. # Ceci peut \u00eatre utile si l'acc\u00e9l\u00e9rom\u00e8tre est mont\u00e9 dans une orientation # qui ne correspond pas \u00e0 celle de l'imprimante. Par exemple, on peut # r\u00e9gler cette option sur \"y, x, z\" pour permuter les axes X et Y. # Il est \u00e9galement possible d'inverser un axe si la direction de l'acc\u00e9l\u00e9rom\u00e8tre # est invers\u00e9e (par exemple, \"x, z, -y\"). La valeur par d\u00e9faut est \"x, y, z\". #Rate: 3200 # D\u00e9bit de donn\u00e9es de sortie pour ADXL345. ADXL345 prend en charge les d\u00e9bits # de donn\u00e9es suivants : 3200, 1600, 800, 400, 200, 100, 50, et 25. Notez qu'il n'est # pas recommand\u00e9 de changer ce d\u00e9bit par rapport au d\u00e9bit par d\u00e9faut de 3200, # les d\u00e9bits inf\u00e9rieurs \u00e0 800 affecteront consid\u00e9rablement la qualit\u00e9 des mesures # de r\u00e9sonance. [mpu9250] \u00b6 Support for MPU-9250, MPU-9255, MPU-6515, MPU-6050, and MPU-6500 accelerometers (one may define any number of sections with an \"mpu9250\" prefix). [mpu9250 my_accelerometer] #i2c_address: # La valeur par d\u00e9faut est 104 (0x68). Si AD0 est \u00e9lev\u00e9, ce sera 0x69 \u00e0 la place. #i2c_mcu: #i2c_bus: #i2c_speed: 400000 # Voir la section \"param\u00e8tres I2C communs\" pour une description des # param\u00e8tres ci-dessus. La valeur par d\u00e9faut de \"i2c_speed\" est 400000. #axes_map: x, y, z # Voir la section \"adxl345\" pour des informations sur ce param\u00e8tre. [resonance_tester] \u00b6 Prise en charge du test de r\u00e9sonance et du calibrage automatique du fa\u00e7onneur d'entr\u00e9e (input shaper). Pour utiliser la plupart des fonctionnalit\u00e9s de ce module, des d\u00e9pendances logicielles suppl\u00e9mentaires doivent \u00eatre install\u00e9es ; reportez-vous \u00e0 Mesurer les r\u00e9sonances et \u00e0 la r\u00e9f\u00e9rence de commande pour plus d'informations. Voir la section Adoucissement Max du guide de mesure des r\u00e9sonances pour plus d'informations sur le param\u00e8tre max_smoothing et son utilisation. [resonance_tester] #probe_points: # Une liste de coordonn\u00e9es X, Y, Z de points (un point par ligne) \u00e0 tester. # Au moins un point est requis. Assurez-vous que tous les points avec une certaine marge # de s\u00e9curit\u00e9 dans le plan XY (~ quelques centim\u00e8tres) sont accessibles par la t\u00eate de l'outil. #accel_chip: # Nom de la puce d'acc\u00e9l\u00e9rom\u00e8tre \u00e0 utiliser pour les mesures. Si la puce adxl345 a \u00e9t\u00e9 d\u00e9finie # sans un nom explicite, ce param\u00e8tre peut simplement la r\u00e9f\u00e9rencer en tant que # \"accel_chip : adxl345\", sinon un nom explicite doit \u00eatre fourni, par exemple # \"accel_chip : adxl345 my_chip_name\". Soit ce param\u00e8tre seul, soit les deux param\u00e8tres # suivants doivent \u00eatre d\u00e9finis. #accel_chip_x: #accel_chip_y: # Noms des puces d'acc\u00e9l\u00e9rom\u00e8tre \u00e0 utiliser pour les mesures de chaque axe. # Peut \u00eatre utile, par exemple, sur une imprimante de type \"bed slinger\", si deux acc\u00e9l\u00e9rom\u00e8tres # s\u00e9par\u00e9s sont mont\u00e9s, un sur le lit (pour l'axe Y), l'autre sur la t\u00eate de l'outil (pour l'axe X). # Ces param\u00e8tres ont le m\u00eame format que le param\u00e8tre 'accel_chip'. Soit le param\u00e8tre # 'accel_chip' soit ces deux param\u00e8tres doivent \u00eatre fournis. #max_smoothing: # Lissage maximal du fa\u00e7onneur (shaper) d'entr\u00e9e \u00e0 autoriser pour chaque axe pendant # l'auto-calibration (avec la commande 'SHAPER_CALIBRATE'). Par d\u00e9faut, aucun lissage # maximal n'est sp\u00e9cifi\u00e9. Reportez-vous au guide Measuring_Resonances pour plus de d\u00e9tails # sur l'utilisation de cette fonction. #min_freq: 5 # Fr\u00e9quence minimale de test des r\u00e9sonances. La valeur par d\u00e9faut est 5 Hz. #max_freq: 133.33 # Fr\u00e9quence maximale de test des r\u00e9sonances. La valeur par d\u00e9faut est 133,33 Hz. #accel_per_hz: 75 # Ce param\u00e8tre permet de d\u00e9terminer l'acc\u00e9l\u00e9ration \u00e0 utiliser pour tester une fr\u00e9quence # sp\u00e9cifique: accel = accel_per_hz * freq. Plus haute est cette valeur, plus l'\u00e9nergie des # oscillations est \u00e9lev\u00e9e. Peut \u00eatre fix\u00e9 \u00e0 une valeur inf\u00e9rieure \u00e0 celle par d\u00e9faut si les # r\u00e9sonances deviennent trop fortes sur l'imprimante. Cependant, des valeurs plus faibles # rendent les mesures des r\u00e9sonances \u00e0 haute fr\u00e9quence moins pr\u00e9cises. La valeur par # d\u00e9faut est de 75 (mm/sec). #hz_per_sec: 1 # D\u00e9termine la vitesse de l'essai. Lors du test de toutes les fr\u00e9quences dans la plage [min_freq, # max_freq], chaque seconde, la fr\u00e9quence augmente de hz_per_sec. # De faibles valeurs rendent le test lent, de grandes valeurs diminueront la pr\u00e9cision du test. # La valeur par d\u00e9faut est 1.0 (Hz/sec == sec^-2). Assistants de fichiers de configuration \u00b6 [board_pins] \u00b6 Alias des broches de la carte (on peut d\u00e9finir un nombre quelconque de sections avec le pr\u00e9fixe \"board_pins\"). Utilisez ceci pour d\u00e9finir des alias de broches d'un micro-contr\u00f4leur. [board_pins my_aliases] mcu: mcu # Une liste de micro-contr\u00f4leurs s\u00e9par\u00e9s par des virgules pouvant utiliser les # alias. La valeur par d\u00e9faut est d'appliquer les alias au \"mcu\" principal. alias: aliases_<nom>: # Une liste s\u00e9par\u00e9e par des virgules d'alias \"nom=valeur\" \u00e0 cr\u00e9er pour le micro- # contr\u00f4leur donn\u00e9. Par exemple, \"EXP1_1=PE6\" cr\u00e9era un alias \"EXP1_1\" pour la # broche \"PE6\". Cependant, si la \"valeur\" est incluse dans \"<>\", alors \"nom\" est cr\u00e9\u00e9 # comme une broche r\u00e9serv\u00e9e (par exemple, \"EXP1_9=<GND>\" r\u00e9serverait \"EXP1_9\"). # Un nombre quelconque d'options commen\u00e7ant par \"alias_\" peuvent \u00eatre sp\u00e9cifi\u00e9es. [include] \u00b6 Prise en charge de l'inclusion de fichiers. On peut inclure des fichiers de configuration suppl\u00e9mentaires \u00e0 partir du fichier de configuration principal de l'imprimante. Les caract\u00e8res g\u00e9n\u00e9riques peuvent \u00e9galement \u00eatre utilis\u00e9s (par exemple, \"configs/*.cfg\"). [include my_other_config.cfg] [duplicate_pin_override] \u00b6 Cet outil permet de d\u00e9finir plusieurs fois une m\u00eame broche de microcontr\u00f4leur dans un fichier de configuration sans v\u00e9rification normale des erreurs. Ceci est destin\u00e9 \u00e0 des fins de diagnostic et de d\u00e9bogage. Cette section n'est pas n\u00e9cessaire lorsque Klipper prend en charge l'utilisation de la m\u00eame broche plusieurs fois, et l'utilisation de cette d\u00e9rogation peut entra\u00eener des r\u00e9sultats confus et inattendus. [duplicate_pin_override] pins: # Une liste de broches s\u00e9par\u00e9es par des virgules pouvant \u00eatre utilis\u00e9es plusieurs fois dans # un fichier de configuration sans contr\u00f4les d'erreurs normaux. Ce param\u00e8tre doit \u00eatre # fourni. Mat\u00e9riel de nivelage du lit \u00b6 [probe] \u00b6 Sonde de hauteur Z. On peut d\u00e9finir cette section pour activer le mat\u00e9riel de nivellement de l'axe Z. Lorsque cette section est activ\u00e9e, les commandes g-code \u00e9tendus PROBE et QUERY_PROBE deviennent disponibles. Consultez \u00e9galement le guide d'\u00e9talonnage des sondes . La section probe cr\u00e9e \u00e9galement une broche virtuelle \"probe:z_virtual_endstop\". Il est possible de d\u00e9finir la broche du stepper_z, endstop_pin, sur cette broche virtuelle pour les imprimantes de style cart\u00e9sien qui utilisent la sonde \u00e0 la place d'un interrupteur de fin de course Z. Si vous utilisez \"probe:z_virtual_endstop\", ne d\u00e9finissez pas de position_endstop dans la configuration de la section stepper_z. [probe] pin: # Broche de d\u00e9tection de la sonde. Si la broche se trouve sur un microcontr\u00f4leur diff\u00e9rent # de celui des moteurs de l'axe Z alors elle active le \"multi-mcu homing\". Ce param\u00e8tre # doit \u00eatre fourni. #deactivate_on_each_sample: True # Ceci d\u00e9termine si Klipper doit ex\u00e9cuter le gcode de d\u00e9sactivation entre chaque tentative # de palpage lors d'une s\u00e9quence de palpages multiples. # La valeur par d\u00e9faut est True. #x_offset: 0.0 # La distance (en mm) entre la sonde et la buse le long de l'axe x. # La valeur par d\u00e9faut est 0. #y_offset: 0.0 # La distance (en mm) entre la sonde et la buse le long de l'axe y. # La valeur par d\u00e9faut est 0. z_offset: # La distance (en mm) entre le lit et la buse lorsque la sonde se d\u00e9clenche. # Ce param\u00e8tre doit \u00eatre fourni. #speed: 5.0 # Vitesse (en mm/s) de l'axe Z lors du palpage. La valeur par d\u00e9faut est 5mm/s. #samples: 1 # Le nombre de fois o\u00f9 il faut palper chaque point. Les valeurs z palp\u00e9es seront # moyenn\u00e9es. La valeur par d\u00e9faut est de palper 1 fois. #sample_retract_dist: 2.0 # Distance (en mm) \u00e0 parcourir pour relever la t\u00eate de l'outil entre chaque palpage # (en cas d'\u00e9chantillonnage multiple). La valeur par d\u00e9faut est 2mm. #lift_speed: # Vitesse (en mm/s) de l'axe Z lors du levage de la sonde entre les \u00e9chantillons. # La valeur par d\u00e9faut est la m\u00eame que celle du param\u00e8tre 'speed'. #samples_result: average # La m\u00e9thode de calcul lorsque l'on \u00e9chantillonne plusieurs fois - soit \"m\u00e9diane\" # (median) ou \"moyenne\" (average). La valeur par d\u00e9faut est \"moyenne\". #samples_tolerance: 0.100 # La distance Z maximale (en mm) \u00e0 laquelle un \u00e9chantillon peut diff\u00e9rer des autres # \u00e9chantillons. Si cette tol\u00e9rance est d\u00e9pass\u00e9e, soit une erreur est signal\u00e9e soit une # tentative de palpage est recommenc\u00e9e (cf. samples_tolerance_retries). # La valeur par d\u00e9faut est 0.100mm. #samples_tolerance_retries: 0 # Le nombre de fois qu'il faut r\u00e9essayer quand un palpage d\u00e9passe la tol\u00e9rance des # \u00e9chantillons. Lors d'une nouvelle tentative, tous les \u00e9chantillons en cours sont rejet\u00e9s # et une tentative de palpa est relanc\u00e9e. Si un ensemble valide d'\u00e9chantillons n'est pas # obtenu dans le nombre de tentatives donn\u00e9, une erreur est signal\u00e9e. La valeur par d\u00e9faut # est z\u00e9ro, ce qui entra\u00eene le signalement d'une erreur d\u00e8s le premier \u00e9chantillon d\u00e9passant # la tol\u00e9rance de samples_tolerance. #activate_gcode: # Une liste de commandes G-Code \u00e0 ex\u00e9cuter avant chaque tentative de palpage. # Voir docs/Command_Templates.md pour le format G-Code. Cela peut \u00eatre utile si la sonde # doit \u00eatre activ\u00e9e d'une mani\u00e8re particuli\u00e8re. Ne pas envoyer ici de commandes d\u00e9pla\u00e7ant # la t\u00eate de l'outil (par exemple, G1). La valeur par d\u00e9faut est de ne pas ex\u00e9cuter de commandes # G-code sp\u00e9ciales lors de l'activation. #deactivate_gcode: # Une liste de commandes G-Code \u00e0 ex\u00e9cuter apr\u00e8s la fin de chaque tentative de palpage # termin\u00e9e. Voir docs/Command_Templates.md pour le format G-Code. Ne pas envoyer ici # de commandes d\u00e9pla\u00e7ant la t\u00eate de l'outil. La valeur par d\u00e9faut est de ne pas ex\u00e9cuter de # commandes G-code sp\u00e9ciales lors de la d\u00e9sactivation. [bltouch] \u00b6 Sonde BLTouch. On peut d\u00e9finir cette section (au lieu d'une section probe) pour activer une sonde BLTouch. Voir Guide BL-Touch et R\u00e9f\u00e9rence des commandes pour plus d'informations. Une broche virtuelle \"probe:z_virtual_endstop\" est \u00e9galement cr\u00e9\u00e9e (voir la section \"probe\" pour les d\u00e9tails). [bltouch] sensor_pin: # Broche connect\u00e9e \u00e0 la broche du capteur (sensor) BLTouch. La plupart des BLTouch # exigent un pullup sur la broche du capteur (pr\u00e9fixez le nom de la broche par \"^\"). # Ce param\u00e8tre doit \u00eatre fourni. control_pin: # Broche connect\u00e9e \u00e0 la broche de commande du BLTouch. # Ce param\u00e8tre doit \u00eatre fourni. #pin_move_time: 0.680 # Dur\u00e9e d'attente (en secondes) pour que la broche BLTouch se d\u00e9place vers # le haut ou le bas. La valeur par d\u00e9faut est de 0,680 seconde. #stow_on_each_sample: True # D\u00e9termine si Klipper doit ordonner \u00e0 la broche de se d\u00e9placer vers le haut entre # chaque palpage lors d'une s\u00e9quence de palpages multiples. # Lisez les instructions dans docs/BLTouch.md avant de r\u00e9gler ce param\u00e8tre \u00e0 False. # La valeur par d\u00e9faut est True. #probe_with_touch_mode: False # Si ce param\u00e8tre est d\u00e9fini sur True, Klipper palpera avec le p\u00e9riph\u00e9rique en # \"touch_mode\". La valeur par d\u00e9faut est False (palpage en mode \"pin_down\"). #pin_up_reports_not_triggered: True # D\u00e9finit si le BLTouch rapporte syst\u00e9matiquement le palpeur dans un \u00e9tat \"non # d\u00e9clench\u00e9\" apr\u00e8s une commande \"pin_up\" r\u00e9ussie. Ceci devrait \u00eatre True pour # tous les BLTouch authentiques. Lisez les instructions de docs/BLTouch.md avant # de r\u00e9gler cette valeur \u00e0 False. La valeur par d\u00e9faut est True. #pin_up_touch_mode_reports_triggered: True # D\u00e9finit si le BLTouch rapporte syst\u00e9matiquement un \u00e9tat \"d\u00e9clench\u00e9\" apr\u00e8s la # commande \"pin_up_mode_reports_triggered\". Ceci devrait \u00eatre True pour tous les # BLTouch authentiques. Lisez les instructions de docs/BLTouch.md avant de r\u00e9gler # cette valeur \u00e0 False. La valeur par d\u00e9faut est True. #set_output_mode: # Demande un mode de sortie particulier de la broche du capteur sur un BLTouch V3.0 # (et ult\u00e9rieurs). Ce param\u00e8tre ne doit pas \u00eatre utilis\u00e9 sur d'autres types de sondes. # R\u00e9glez sur \"5V\" pour demander une sortie de 5 Volts de la broche du capteur (\u00e0 n'utiliser # que si la carte contr\u00f4leur n\u00e9cessite le mode 5V et est tol\u00e9rante \u00e0 5V sur sa ligne de signal # d'entr\u00e9e). R\u00e9glez sur \"OD\" pour demander l'utilisation de la sortie de la broche du capteur # en mode drain ouvert. La valeur par d\u00e9faut est de ne pas demander de mode de sortie. #x_offset: #y_offset: #z_offset: #speed: #lift_speed: #samples: #sample_retract_dist: #samples_result: #samples_tolerance: #samples_tolerance_retries: # Voir la section \"probe\" pour des informations sur ces param\u00e8tres. [smart_effector] \u00b6 Le \"Smart Effector\" de Duet3d impl\u00e9mente une sonde Z utilisant un capteur de force. On peut d\u00e9finir cette section \u00e0 la place de [probe] pour activer les fonctionnalit\u00e9s sp\u00e9cifiques du Smart Effector. Cela permet \u00e9galement d'activer les commandes d'ex\u00e9cution afin d'ajuster les param\u00e8tres du Smart Effector au moment de son ex\u00e9cution. [smart_effector] pin: # Broche connect\u00e9e \u00e0 la broche de sortie de la sonde Z de Smart Effector (broche 5). Notez qu' une # r\u00e9sistance de tirage (pullup) sur la carte n'est g\u00e9n\u00e9ralement pas n\u00e9cessaire. Cependant, si la broche # de sortie est connect\u00e9e \u00e0 la broche de la carte \u00e0 l'aide d'une r\u00e9sistance de tirage, cette r\u00e9sistance doit # \u00eatre de valeur \u00e9lev\u00e9e (par ex. 10K Ohm ou plus). Certaines cartes ont une r\u00e9sistance de tirage de faible # valeur sur l'entr\u00e9e de la sonde Z, ce qui entra\u00eenera probablement un \u00e9tat de sonde toujours d\u00e9clench\u00e9. # Dans ce cas, connectez le Smart Effector \u00e0 une autre broche sur la carte. Ce param\u00e8tre est n\u00e9cessaire. #control_pin: # Broche connect\u00e9e \u00e0 la broche d'entr\u00e9e de contr\u00f4le du Smart Effector (broche 7). Si elle est fournie, # les commandes de programmation de la sensibilit\u00e9 du Smart Effector deviennent disponibles. #probe_accel: # Si elle est d\u00e9finie, limite l'acc\u00e9l\u00e9ration des mouvements de palpage (en mm/sec^2). # Une grande acc\u00e9l\u00e9ration soudaine au d\u00e9but du mouvement de palpage peut provoquer des # d\u00e9clenchements intempestifs de la sonde, surtout si la t\u00eate de l'outil est lourde. # Pour \u00e9viter cela, il peut \u00eatre n\u00e9cessaire de r\u00e9duire l'acc\u00e9l\u00e9ration des mouvements de palpage # via ce param\u00e8tre. #recovery_time: 0.4 # D\u00e9lai entre les mouvements de d\u00e9placement et les mouvements de palpage en secondes. Un # d\u00e9placement rapide avant le palpage peut entra\u00eener un d\u00e9clenchement intempestif de celui-ci. # Cela peut provoquer des erreurs 'Probe triggered prior to movement' si aucun d\u00e9lai n'est d\u00e9fini. # La valeur 0 d\u00e9sactive le d\u00e9lai de r\u00e9cup\u00e9ration. # La valeur par d\u00e9faut est 0,4. #x_offset: #y_offset: # Doivent \u00eatre laiss\u00e9s non d\u00e9finis (ou d\u00e9finis \u00e0 0). z_offset: # Hauteur de d\u00e9clenchement de la sonde. Commencez avec -0,1 (mm), et ajustez plus tard en # utilisant la commande `PROBE_CALIBRATE`. Ce param\u00e8tre doit \u00eatre fourni. #speed: # Vitesse (en mm/s) de l'axe Z lors du palpage. Il est recommand\u00e9 de commencer avec une # vitesse de palpage de 20 mm/s et d'ajuster si n\u00e9cessaire pour am\u00e9liorer la pr\u00e9cision et la # r\u00e9p\u00e9tabilit\u00e9 du d\u00e9clenchement du palpeur. #samples: #sample_retract_dist: #samples_result: #samples_tolerance: #samples_tolerance_retries: #activate_gcode: #deactivate_gcode: #deactivate_on_each_sample: # Voir la section \"sonde\" (probe) pour plus d'informations sur les param\u00e8tres ci-dessus. Moteurs pas \u00e0 pas et extrudeurs additionnels \u00b6 [stepper_z1] \u00b6 Axes \u00e0 moteurs pas \u00e0 pas multiples. Sur une imprimante de style cart\u00e9sien, le pilote moteur contr\u00f4lant un axe donn\u00e9 peut avoir des blocs de configuration suppl\u00e9mentaires d\u00e9finissant les pilotes moteurs qui doivent \u00eatre mis en marche de concert avec le pilote principal. On peut d\u00e9finir un nombre quelconque de sections avec un suffixe num\u00e9rique commen\u00e7ant \u00e0 1 (par exemple, \"stepper_z1\", \"stepper_z2\", etc.). [stepper_z1] #step_pin: #dir_pin: #enable_pin: #microsteps: #rotation_distanc : # Voir la section \"stepper\" pour la d\u00e9finition des param\u00e8tres ci-dessus. #endstop_pin: # Si une endstop_pin est d\u00e9finie pour le moteur suppl\u00e9mentaire, alors le moteur # se d\u00e9placera \u00e0 l'origine jusqu'\u00e0 ce que la fin de course soit d\u00e9clench\u00e9e. Sinon, le # moteur se d\u00e9placera jusqu'\u00e0 ce que la fin de course du moteur principal de l'axe # soit d\u00e9clench\u00e9e. [extruder1] \u00b6 Dans une imprimante multi-extrudeurs, ajoutez une section d'extrudeur suppl\u00e9mentaire pour chaque extrudeur suppl\u00e9mentaire. Les sections d'extrudeur suppl\u00e9mentaires doivent \u00eatre nomm\u00e9es \"extruder1\", \"extruder2\", \"extruder3\", et ainsi de suite. Voir la section \"extruder\" pour une description des param\u00e8tres disponibles. Voir sample-multi-extruder.cfg pour un exemple de configuration. [extruder1] #step_pin: #dir_pin: #... # Voir la section \"extruder\" pour les param\u00e8tres disponibles pour le pilote de moteur # pas \u00e0 pas et l'\u00e9l\u00e9ment de chauffe. #shared_heater: # Cette option est obsol\u00e8te et ne doit plus \u00eatre utilis\u00e9e. [dual_carriage] \u00b6 Prise en charge des imprimantes cart\u00e9siennes avec deux chariots sur un seul axe. Le chariot actif est d\u00e9fini par la commande g-code \u00e9tendue SET_DUAL_CARRIAGE. La commande \"SET_DUAL_CARRIAGE CARRIAGE=1\" active le chariot d\u00e9fini dans cette section (CARRIAGE=0 ram\u00e8ne l'activation au chariot principal). Le support du double chariot est g\u00e9n\u00e9ralement combin\u00e9 avec des extrudeuses suppl\u00e9mentaires - la commande SET_DUAL_CARRIAGE est souvent appel\u00e9e en m\u00eame temps que la commande ACTIVATE_EXTRUDER. Veillez \u00e0 garer les chariots pendant la d\u00e9sactivation. Voir sample-idex.cfg pour un exemple de configuration. [dual_carriage] axis: # L'axe sur lequel se trouve ce chariot suppl\u00e9mentaire (soit x, soit y). Ce param\u00e8tre # doit \u00eatre fourni. #step_pin: #dir_pin: #enable_pin: #microsteps: #rotation_distance: #endstop_pin: #position_endstop: #position_min: #position_max: # Voir la section \"stepper\" pour la d\u00e9finition des param\u00e8tres ci-dessus. [extruder_stepper] \u00b6 Support pour des moteurs suppl\u00e9mentaires synchronis\u00e9s avec le mouvement d'une extrudeuse (on peut d\u00e9finir un nombre quelconque de sections avec un pr\u00e9fixe \"extruder_stepper\"). Voir la r\u00e9f\u00e9rence des commandes pour plus d'informations. [extrudeur_stepper my_extra_stepper] extruder: # L'extrudeur sur lequel ce pilote moteur est synchronis\u00e9. Si ce param\u00e8tre est # d\u00e9fini sur une cha\u00eene vide, le pilote ne sera pas synchronis\u00e9 avec un extrudeur. # Ce param\u00e8tre doit \u00eatre fourni. #step_pin: #dir_pin: #enable_pin: #microsteps: #rotation_distance: # Voir la section \"stepper\" pour la d\u00e9finition des param\u00e8tres # ci-dessus. [manual_stepper] \u00b6 Pilotes de moteur manuels (on peut d\u00e9finir un nombre quelconque de sections avec le pr\u00e9fixe \"manual_stepper\"). Ce sont des pilotes de moteur contr\u00f4l\u00e9s par la commande g-code MANUAL_STEPPER. Par exemple \"MANUAL_STEPPER STEPPER=my_stepper MOVE=10 SPEED=5\". Voir le fichier G-Codes pour une description de la commande MANUAL_STEPPER. Les pilotes de moteur ne sont pas connect\u00e9s \u00e0 la cin\u00e9matique normale de l'imprimante. [manual_stepper my_stepper] #step_pin: #dir_pin: #enable_pin: #microsteps: #rotation_distance: # Voir la section \"stepper\" pour une description de ces param\u00e8tres. #velocity: # D\u00e9finit la vitesse par d\u00e9faut (en mm/s) pour le pilote moteur. Cette valeur # sera utilis\u00e9e si une commande MANUAL_STEPPER ne sp\u00e9cifie pas de param\u00e8tre SPEED # La valeur par d\u00e9faut est 5mm/s. #accel # D\u00e9finit l'acc\u00e9l\u00e9ration par d\u00e9faut (en mm/s^2) pour le pilote moteur Une # acc\u00e9l\u00e9ration de z\u00e9ro n'entra\u00eenera aucune acc\u00e9l\u00e9ration. Cette valeur # sera utilis\u00e9e si une commande MANUAL_STEPPER ne sp\u00e9cifie pas de # param\u00e8tre ACCEL. La valeur par d\u00e9faut est z\u00e9ro. #endstop_pin: # Broche de d\u00e9tection de l'interrupteur de fin de course. Si elle est sp\u00e9cifi\u00e9e, on peut effectuer # des \"mouvements de retour \u00e0 l'origine\" en ajoutant un param\u00e8tre STOP_ON_ENDSTOP aux # commandes de mouvement MANUAL_STEPPER. \u00c9l\u00e9ments chauffants et capteurs personnalis\u00e9s \u00b6 [verify_heater] \u00b6 V\u00e9rification de l'\u00e9l\u00e9ment chauffant et du capteur de temp\u00e9rature. La v\u00e9rification des \u00e9l\u00e9ments de chauffage est automatiquement activ\u00e9e pour chaque mat\u00e9riel de chauffage configur\u00e9 sur l'imprimante. Utilisez les sections verify_heater pour modifier les param\u00e8tres par d\u00e9faut. [verify_heater heater_config_name] #max_error: 120 # L'erreur de temp\u00e9rature cumul\u00e9e maximale avant de d\u00e9clencher une erreur. # Des valeurs plus petites entra\u00eenent une v\u00e9rification plus stricte et des valeurs # plus grandes permettent un d\u00e9lai plus long avant qu'une erreur ne soit signal\u00e9e. # Plus pr\u00e9cis\u00e9ment, la temp\u00e9rature est inspect\u00e9e une fois par seconde et si elle # est proche de la temp\u00e9rature cible, un \"compteur d'erreurs\" interne est remis # \u00e0 z\u00e9ro; sinon, si la temp\u00e9rature est inf\u00e9rieure \u00e0 la plage cible, le compteur est # augment\u00e9 de la quantit\u00e9 de temp\u00e9rature rapport\u00e9e diff\u00e9rant de cette plage. Si # le compteur d\u00e9passe ce \"max_error\", une erreur est signal\u00e9e. La valeur par # d\u00e9faut est 120. #check_gain_time: # Ceci contr\u00f4le la v\u00e9rification du chauffage durant la chauffe initiale. Des valeurs # plus petites entra\u00eenent une v\u00e9rification plus stricte et des valeurs plus grandes # autorisent un d\u00e9lai plus grand avant qu'une erreur ne soit signal\u00e9e. Sp\u00e9cifiquement, # pendant la chauffe initiale, tant que la temp\u00e9rature de l'\u00e9l\u00e9ment chauffant augmente # durant ce laps de temps (sp\u00e9cifi\u00e9 en secondes), le \"compteur d'erreurs\" interne est # remis \u00e0 z\u00e9ro. La valeur par d\u00e9faut est de 20 secondes pour les extrudeuses et 60 # secondes pour le lit chauffant. #hysteresis: 5 # La diff\u00e9rence de temp\u00e9rature maximale (en Celsius) par rapport \u00e0 une temp\u00e9rature # cible consid\u00e9r\u00e9e comme situ\u00e9e dans la plage de la cible. Ceci contr\u00f4le la v\u00e9rification # de la plage du param\u00e8tre max_error. Il est rare de personnaliser cette valeur. # La valeur par d\u00e9faut est 5. #heating_gain: 2 # La temp\u00e9rature minimale (en Celsius) pour laquelle le chauffage doit progresser # pendant la p\u00e9riode de check_gain_time. Il est rare de personnaliser cette valeur. # La valeur par d\u00e9faut est 2. [homing_heaters] \u00b6 Outil de d\u00e9sactivation des \u00e9l\u00e9ments chauffants lors de la prise d'origine ou du palpage d'un axe. [homing_heaters] #steppers: # Une liste de pilotes moteurs s\u00e9par\u00e9s par des virgules qui devraient d\u00e9sactiver les chauffages. # La valeur par d\u00e9faut est de d\u00e9sactiver les chauffages pour tout d\u00e9placement (mise \u00e0 # l'origine / palpage). # Exemple typique : stepper_z #heaters: # Une liste, s\u00e9par\u00e9e par des virgules, d'\u00e9l\u00e9ments chauffants \u00e0 d\u00e9sactiver pendant les d\u00e9placements # (mise \u00e0 l'origine / palpage). La valeur par d\u00e9faut est de d\u00e9sactiver tous les \u00e9l\u00e9ments chauffants. # Exemple typique : extruder, heater_bed [thermistor] \u00b6 Thermistances personnalis\u00e9es (on peut d\u00e9finir un nombre quelconque de sections avec le pr\u00e9fixe \"thermistor\"). Une thermistance personnalis\u00e9e peut \u00eatre utilis\u00e9e dans le champ sensor_type d'une section de configuration de chauffage. (Par exemple, si l'on d\u00e9finit une section \"[thermistor my_thermistor]\", on peut utiliser un \"sensor_type: my_thermistor\" lors de la d\u00e9finition d'un \u00e9l\u00e9ment de chauffe). Veillez \u00e0 placer la section thermistor dans le fichier de configuration avant sa premi\u00e8re utilisation dans une section de chauffage. [thermistor ma_thermistance] #temperature1: #resistance1: #temperature2: #resistance2: #temperature3: #resistance3: # Trois mesures de r\u00e9sistance (en Ohms) aux temp\u00e9ratures donn\u00e9es # (en Celsius). Ces trois mesures seront utilis\u00e9es pour calculer les # coefficients de Steinhart-Hart pour la thermistance. Ces param\u00e8tres # doivent \u00eatre fournis lors de l'utilisation de Steinhart-Hart pour d\u00e9finir la # thermistance. #beta: # Alternativement, on peut d\u00e9finir temp\u00e9rature1, r\u00e9sistance1, et beta # pour d\u00e9finir les param\u00e8tres de la thermistance. Ce param\u00e8tre doit \u00eatre # fourni lorsque l'on utilise \"beta\" pour d\u00e9finir la thermistance. [adc_temperature] \u00b6 Capteurs de temp\u00e9rature ADC personnalis\u00e9s (on peut d\u00e9finir un nombre quelconque de sections avec un pr\u00e9fixe \"adc_temperature\"). Cela permet de d\u00e9finir un capteur de temp\u00e9rature personnalis\u00e9 mesurant une tension sur une broche de convertisseur analogique-num\u00e9rique (ADC) et utilise une interpolation lin\u00e9aire entre un ensemble de mesures configur\u00e9es de temp\u00e9rature/tension (ou de temp\u00e9rature/r\u00e9sistance) pour d\u00e9terminer la temp\u00e9rature. Le capteur r\u00e9sultant peut \u00eatre utilis\u00e9 comme un type de capteur dans une section de chauffage. (Par exemple, si l'on d\u00e9finit une section \"[adc_temperature my_sensor]\", on peut utiliser un \"sensor_type : my_sensor\" lors de la d\u00e9finition d'un \u00e9l\u00e9ment chauffant). Veillez \u00e0 placer la section du capteur dans le fichier de configuration avant sa premi\u00e8re utilisation dans une section de chauffage. [adc_temperature mon_capteur] #temperature1: #voltage1: #temperature2: #voltage2: #... # Un ensemble de temp\u00e9ratures (en Celsius) et de tensions (en Volts) \u00e0 utiliser comme # r\u00e9f\u00e9rence lors de la conversion d'une temp\u00e9rature. Une section de chauffage utilisant # ce capteur peut \u00e9galement sp\u00e9cifier les param\u00e8tres adc_voltage et voltage_offset # pour d\u00e9finir la tension ADC (voir la section \"Amplificateurs communs de temp\u00e9rature\" # pour plus de d\u00e9tails). Au moins deux mesures doivent \u00eatre fournies. #temperature1: #resistance1: #temperature2: #resistance2: #... # Alternativement, on peut indiquer un ensemble de temp\u00e9ratures (en Celsius) # et de r\u00e9sistance (en Ohms) \u00e0 utiliser comme r\u00e9f\u00e9rence lors de la conversion d'une # temp\u00e9rature. Une section de chauffage utilisant ce capteur peut \u00e9galement sp\u00e9cifier un # param\u00e8tre pullup_resistor (voir la section \"extrudeuse\" pour plus de d\u00e9tails). Au # moins deux mesures doivent \u00eatre fournies. [heater_generic] \u00b6 \u00c9l\u00e9ments de chauffe g\u00e9n\u00e9riques (on peut d\u00e9finir un nombre quelconque de sections avec le pr\u00e9fixe \"heater_generic\"). Ces \u00e9l\u00e9ments de chauffe se comportent de la m\u00eame mani\u00e8re que les \u00e9l\u00e9ments de chauffe standards (extrudeuses, lits chauffants). Utilisez la commande SET_HEATER_TEMPERATURE (voir G-Codes pour plus de d\u00e9tails) pour d\u00e9finir la temp\u00e9rature cible. [heater_generic my_generic_heater] #gcode_id: # L'identifiant \u00e0 utiliser pour signaler la temp\u00e9rature dans la commande M105. # Ce param\u00e8tre doit \u00eatre fourni. #heater_pin: #max_power: #sensor_type: #sensor_pin: #smooth_time: #control: #pid_Kp: #pid_Ki: #pid_Kd: #pwm_cycle_time: #min_temp: #max_temp: # Voir la section \"extruder\" pour la d\u00e9finition des param\u00e8tres # ci-dessus. [temperature_sensor] \u00b6 Capteurs de temp\u00e9rature g\u00e9n\u00e9riques. On peut d\u00e9finir un nombre quelconque de capteurs de temp\u00e9rature suppl\u00e9mentaires signal\u00e9s par la commande M105. [temperature_sensor my_sensor] #sensor_type: #sensor_pin: #min_temp: #max_temp: # Voir la section \"extrudeuse\" pour la d\u00e9finition des param\u00e8tres # ci-dessus. #gcode_id: # Voir la section \"heater_generic\" pour la d\u00e9finition de ce # param\u00e8tre. Capteurs de temp\u00e9rature \u00b6 Klipper inclut les d\u00e9finitions de nombreux types de capteurs de temp\u00e9rature. Ces capteurs peuvent \u00eatre utilis\u00e9s dans n'importe quelle section de la configuration n\u00e9cessitant un capteur de temp\u00e9rature (comme une section [extruder] ou [heater_bed] ). Thermistances communes \u00b6 Thermistances communes. Les param\u00e8tres suivants sont disponibles dans les sections de chauffage utilisant l'un de ces capteurs. sensor_type: # Un parmi \"EPCOS 100K B57560G104F\", \"ATC Semitec 104GT-2\", # \"ATC Semitec 104NT-4-R025H42G\", \"Generic 3950\", # \"Honeywell 100K 135-104LAG-J01\", \"NTC 100K MGB18-104F39050L32\", # \"SliceEngineering 450\", ou \"TDK NTCG104LH104JT1\". sensor_pin: # Broche d'entr\u00e9e analogique connect\u00e9e \u00e0 la thermistance. Ce param\u00e8tre doit # \u00eatre fourni. #pullup_resistor: 4700 # La r\u00e9sistance (en ohms) de tirage (pullup) reli\u00e9e \u00e0 la thermistance. # La valeur par d\u00e9faut est 4700 ohms. #inline_resistor: 0 # La r\u00e9sistance (en ohms) d'une r\u00e9sistance suppl\u00e9mentaire (ne variant pas en fonction de # la chaleur) plac\u00e9e en ligne avec la thermistance. Il est rare de la d\u00e9finir. # La valeur par d\u00e9faut est 0 ohms. Amplificateurs de temp\u00e9rature courants \u00b6 Amplificateurs de temp\u00e9rature courants. Les param\u00e8tres suivants sont disponibles dans les sections de chauffage utilisant l'un de ces capteurs. sensor_type: # Un parmi \"PT100 INA826\", \"AD595\", \"AD597\", \"AD8494\", \"AD8495\", # \"AD8496\", ou \"AD8497\". sensor_pin: # Broche d'entr\u00e9e analogique connect\u00e9e au capteur. Ce param\u00e8tre doit \u00eatre # fourni. #adc_voltage: 5.0 # La tension de comparaison ADC (en Volts). La valeur par d\u00e9faut est de 5 volts. #voltage_offset: 0 # D\u00e9calage de la tension de l'ADC (en Volts). La valeur par d\u00e9faut est 0. Capteur PT1000 directement connect\u00e9 \u00b6 Capteur PT1000 connect\u00e9 en direct. Les param\u00e8tres suivants sont disponibles dans les sections chauffage utilisant ces capteurs. sensor_type : PT1000 sensor_pin: # Broche d'entr\u00e9e analogique connect\u00e9e au capteur. Ce param\u00e8tre doit \u00eatre # fourni. #pullup_resistor: 4700 # La r\u00e9sistance (en ohms) de tirage (pullup) reli\u00e9e au capteur. La valeur par # d\u00e9faut est 4700 ohms. Capteurs de temp\u00e9rature MAXxxxxx \u00b6 Capteurs MAXxxxxx \u00e0 interface p\u00e9riph\u00e9rique s\u00e9rie (SPI) bas\u00e9s sur la temp\u00e9rature. Les param\u00e8tres suivants sont disponibles dans les sections de chauffage qui utilisent l'un de ces types de capteurs. sensor_type : # Un parmi les types suivants : \"MAX6675\", \"MAX31855\", \"MAX31856\" ou \"MAX31865\". sensor_pin: # La broche de s\u00e9lection de puce pour la puce du capteur. Ce param\u00e8tre doit \u00eatre # fourni. #spi_speed: 4000000 # La vitesse SPI (en hz) \u00e0 utiliser lors de la communication avec la puce. # La valeur par d\u00e9faut est 4000000. #spi_bus: #spi_software_sclk_pin: #spi_software_mosi_pin: #spi_software_miso_pin: # Voir la section \"param\u00e8tres SPI communs\" pour une description des # param\u00e8tres ci-dessus. #tc_type: K #tc_use_50Hz_filter: False #tc_averaging_count: 1 # Les param\u00e8tres ci-dessus contr\u00f4lent les param\u00e8tres des capteurs des puces MAX31856 # Les valeurs par d\u00e9faut de chaque param\u00e8tre sont indiqu\u00e9es \u00e0 c\u00f4t\u00e9 du nom du param\u00e8tre # dans la liste ci-dessus. #rtd_nominal_r: 100 #rtd_reference_r: 430 #rtd_num_of_wires: 2 #rtd_use_50Hz_filter: False # Les param\u00e8tres ci-dessus contr\u00f4lent les param\u00e8tres des capteurs des puces MAX31865 # Les valeurs par d\u00e9faut de chaque param\u00e8tre sont indiqu\u00e9es \u00e0 c\u00f4t\u00e9 du nom du param\u00e8tre # dans la liste ci-dessus. Capteurs de temp\u00e9rature BMP280/BME280/BME680 \u00b6 Capteurs environnementaux BMP280/BME280/BME680 \u00e0 interface \u00e0 deux fils (I2C). Notez que ces capteurs ne sont pas destin\u00e9s \u00e0 \u00eatre utilis\u00e9s avec des extrudeurs et des lits chauffants, mais plut\u00f4t pour surveiller la temp\u00e9rature ambiante (C), la pression (hPa), l'humidit\u00e9 relative et, dans le cas du BME680, le niveau de gaz. Voir sample-macros.cfg pour un gcode_macro pouvant \u00eatre utilis\u00e9 pour signaler la pression et l'humidit\u00e9 en plus de la temp\u00e9rature. sensor_type: BME280 #i2c_address: # La valeur par d\u00e9faut est 118 (0x76). Certains capteurs BME280 ont une adresse de 119 # (0x77). #i2c_mcu: #i2c_bus: #i2c_speed: # Voir la section \"param\u00e8tres I2C communs\" pour une description des # param\u00e8tres ci-dessus. Capteur HTU21D \u00b6 Capteur d'environnement de la famille HTU21D \u00e0 interface \u00e0 deux fils (I2C). Notez que ce capteur n'est pas destin\u00e9 \u00e0 \u00eatre utilis\u00e9 avec les extrudeuses et les lits chauffants, mais plut\u00f4t \u00e0 surveiller la temp\u00e9rature ambiante (C) et l'humidit\u00e9 relative. Voir sample-macros.cfg pour un gcode_macro utilisable permettant d'indiquer l'humidit\u00e9 en plus de la temp\u00e9rature. sensor_type: # Doit \u00eatre \"HTU21D\" , \"SI7013\", \"SI7020\", \"SI7021\" ou \"SHT21\". #i2c_address: # La valeur par d\u00e9faut est 64 (0x40). #i2c_mcu: #i2c_bus: #i2c_speed: # Voir la section \"param\u00e8tres I2C communs\" pour une description des # param\u00e8tres ci-dessus. #htu21d_hold_master: # Si le capteur peut maintenir le tampon I2C durant la lecture. Si True, aucune autre # communication par bus ne peut \u00eatre effectu\u00e9e durant la lecture en cours. # La valeur par d\u00e9faut est False. #htu21d_resolution: # La r\u00e9solution de lecture de la temp\u00e9rature et de l'humidit\u00e9. # Les valeurs valides sont : # 'TEMP14_HUM12' -> 14 bits pour la temp\u00e9rature et 12 bits pour l'humidit\u00e9. # 'TEMP13_HUM10' -> 13 bits pour la temp\u00e9rature et 10 bits pour l'humidit\u00e9. # 'TEMP12_HUM08' -> 12 bits pour la temp\u00e9rature et 08 bits pour l'humidit\u00e9 # 'TEMP11_HUM11' -> 11 bits pour la temp\u00e9rature et 11 bits pour l'humidit\u00e9 # La valeur par d\u00e9faut est \"TEMP11_HUM11\" #htu21d_report_time: # Intervalle en secondes entre les lectures. La valeur par d\u00e9faut est 30 Capteur de temp\u00e9rature LM75 \u00b6 Capteurs de temp\u00e9rature LM75/LM75A connect\u00e9s en deux fils (I2C). Ces capteurs ont une gamme de -55~125 \u00b0C, et sont donc utilisables par exemple pour la surveillance de la temp\u00e9rature d'une chambre. Ils peuvent aussi fonctionner comme de simples contr\u00f4leurs de ventilateurs/\u00e9l\u00e9ments chauffants. sensor_type: LM75 #i2c_address: # La valeur par d\u00e9faut est 72 (0x48). La plage normale est 72-79 (0x48-0x4F), les 3 # bits de poids faible de l'adresse sont configur\u00e9s via des broches sur la puce # (g\u00e9n\u00e9ralement avec des cavaliers ou c\u00e2bl\u00e9s). #i2c_mcu: #i2c_bus: #i2c_speed: # Voir la section \"param\u00e8tres I2C communs\" pour une description des # param\u00e8tres ci-dessus. #lm75_report_time: # Intervalle en secondes entre les lectures. La valeur par d\u00e9faut est 0.8, avec un # minimum de 0.5. Capteur de temp\u00e9rature int\u00e9gr\u00e9 au microcontr\u00f4leur \u00b6 Les micro-contr\u00f4leurs atsam, atsamd, et stm32 poss\u00e8dent un capteur de temp\u00e9rature interne. On peut utiliser le capteur \"temperature_mcu\" pour surveiller ces temp\u00e9ratures. sensor_type: temperature_mcu #sensor_mcu: mcu # Le micro-contr\u00f4leur \u00e0 lire. La valeur par d\u00e9faut est \"mcu\". #sensor_temperature1: #sensor_adc1: # Sp\u00e9cifiez les deux param\u00e8tres ci-dessus (une temp\u00e9rature en Celsius et une valeur d' ADC sous # forme de flottant entre 0,0 et 1,0) pour calibrer la temp\u00e9rature du microcontr\u00f4leur. Cela peut # am\u00e9liorer la pr\u00e9cision de la temp\u00e9rature rapport\u00e9e sur certaines puces. Une fa\u00e7on typique d'obtenir # ces informations d'\u00e9talonnage est de couper compl\u00e8tement l'alimentation de l'imprimante pendant # quelques heures (afin de s'assurer qu'elle est \u00e0 la temp\u00e9rature ambiante), puis de la remettre sous # tension et d'utiliser la fonction QUERY_ADC pour obtenir une mesure ADC. # Utilisez un autre capteur de temp\u00e9rature sur l'imprimante pour trouver la temp\u00e9rature ambiante # correspondante. La valeur par d\u00e9faut est d'utiliser les donn\u00e9es d'\u00e9talonnage d'usine du microcontr\u00f4leur # (le cas \u00e9ch\u00e9ant) ou les valeurs nominales de la sp\u00e9cification du microcontr\u00f4leur. #sensor_temperature2: #sensor_adc2: # Si sensor_temperature1/sensor_adc1 est sp\u00e9cifi\u00e9, on peut \u00e9galement sp\u00e9cifier les donn\u00e9es # d'\u00e9talonnage de sensor_temperature2/sensor_adc2. En proc\u00e9dant ainsi on peut fournir des # informations calibr\u00e9es sur la \"pente de temp\u00e9rature\". La valeur par d\u00e9faut est d'utiliser les donn\u00e9es # d'\u00e9talonnage d'usine sur le microcontr\u00f4leur (le cas \u00e9ch\u00e9ant) ou les valeurs nominales de la # sp\u00e9cification du microcontr\u00f4leur. Capteur de temp\u00e9rature de l'h\u00f4te \u00b6 Temp\u00e9rature de la machine (par exemple Raspberry Pi) ex\u00e9cutant le logiciel h\u00f4te. sensor_type: temperature_host #sensor_path: # Le chemin d'acc\u00e8s au fichier syst\u00e8me de temp\u00e9rature. La valeur par d\u00e9faut est # \" /sys/class/thermal/thermal_zone0/temp \" qui est le fichier syst\u00e8me de # temp\u00e9rature sur un ordinateur Raspberry Pi. Capteur de temp\u00e9rature DS18B20 \u00b6 Le DS18B20 est un capteur de temp\u00e9rature num\u00e9rique \u00e0 1 fil (w1). Notez que ce capteur n'est pas destin\u00e9 \u00e0 \u00eatre utilis\u00e9 avec les extrudeurs et les lits chauffants, mais plut\u00f4t pour surveiller la temp\u00e9rature ambiante (C). Ces capteurs ont une port\u00e9e allant jusqu'\u00e0 125 \u00b0C et sont donc utilisables pour la surveillance de la temp\u00e9rature d'un caisson par exemple. Ils peuvent \u00e9galement fonctionner comme de simples contr\u00f4leurs de ventilateurs/\u00e9l\u00e9ments chauffants. Les capteurs DS18B20 ne sont support\u00e9s que par un \"mcu h\u00f4te\", par exemple le Raspberry Pi. Le module w1-gpio du noyau Linux doit \u00eatre install\u00e9. sensor_type: DS18B20 serial_no: # Chaque dispositif \u00e0 1-wire poss\u00e8de un num\u00e9ro de s\u00e9rie unique utilis\u00e9 pour l'identifier, # g\u00e9n\u00e9ralement au format 28-031674b175ff. Ce param\u00e8tre doit \u00eatre fourni. # Les p\u00e9riph\u00e9riques 1-wire connect\u00e9s peuvent \u00eatre list\u00e9s \u00e0 l'aide de la commande Linux suivante : # ls /sys/bus/w1/devices/ #ds18_report_time: # Intervalle en secondes entre les lectures. La valeur par d\u00e9faut est de 3,0, avec un minimum de 1,0. #sensor_mcu: # Le micro-contr\u00f4leur \u00e0 lire. Doit \u00eatre le host_mcu Ventilateurs \u00b6 [fan] \u00b6 Ventilateur de refroidissement de la pi\u00e8ce. [fan] pin: # Broche de sortie contr\u00f4lant le ventilateur. Ce param\u00e8tre doit \u00eatre fourni. #max_power: 1.0 # La puissance maximale (exprim\u00e9e en tant que valeur comprise entre 0,0 et 1,0) \u00e0 laquelle # r\u00e9gler la broche. La valeur 1.0 permet de r\u00e9gler la broche enti\u00e8rement activ\u00e9e pendant de # longues p\u00e9riodes, tandis qu'une valeur de 0,5 permet \u00e0 la broche de n'\u00eatre activ\u00e9e que # durant la moiti\u00e9 du temps au maximum. Ce param\u00e8tre peut \u00eatre utilis\u00e9 pour limiter la # puissance totale de sortie (sur des p\u00e9riodes prolong\u00e9es) du ventilateur. # Si cette valeur est inf\u00e9rieure \u00e0 1,0, les demandes de vitesse du ventilateur seront mises \u00e0 # l'\u00e9chelle entre z\u00e9ro et max_power (par exemple, si la puissance maximale est de 0,9 et # qu'une vitesse de 80 % est demand\u00e9e, la puissance du ventilateur sera r\u00e9gl\u00e9e \u00e0 72 %. # La valeur par d\u00e9faut est 1.0. #shutdown_speed: 0 # La vitesse souhait\u00e9e du ventilateur (exprim\u00e9e comme une valeur de 0,0 \u00e0 1,0) si # le logiciel du microcontr\u00f4leur passe dans un \u00e9tat d'erreur. La valeur par d\u00e9faut # est 0. #cycle_time: 0.010 # La dur\u00e9e (en secondes) de chaque cycle d'alimentation PWM du ventilateur. Il est # recommand\u00e9 que cette dur\u00e9e soit de 10 millisecondes ou plus si vous utilisez un PWM logiciel. # La valeur par d\u00e9faut est de 0,010 seconde. #hardware_pwm: False # Activez ceci pour utiliser le PWM mat\u00e9riel au lieu du PWM logiciel. La plupart des ventilateurs # ne fonctionnent pas correctement avec le PWM mat\u00e9riel, il n'est donc pas recommand\u00e9 # d'activer cette option \u00e0 moins qu'il n'y ait une exigence \u00e9lectrique pour obtenir une tr\u00e8s haute # vitesse. Lorsque vous utilisez le PWM mat\u00e9riel, le temps de cycle r\u00e9el est contraint par la mise # en \u0153uvre et peut \u00eatre significativement diff\u00e9rent du temps de cycle demand\u00e9. # La valeur par d\u00e9faut est False. #kick_start_time: 0.100 # Dur\u00e9e (en secondes) de fonctionnement du ventilateur \u00e0 pleine vitesse, soit lors de sa premi\u00e8re # activation soit lors d'une augmentation de plus de 50% (pour faire tourner le ventilateur). # La valeur par d\u00e9faut est de 0,100 seconde. #off_below: 0.0 # La vitesse d'entr\u00e9e minimale qui alimentera le ventilateur (exprim\u00e9e comme une valeur # comprise entre 0,0 et 1,0). Quand une vitesse inf\u00e9rieure \u00e0 off_below est demand\u00e9e le ventilateur # sera d\u00e9sactiv\u00e9. Ce r\u00e9glage peut \u00eatre utilis\u00e9 pour \u00e9viter que le ventilateur ne cale et pour # garantir que les d\u00e9marrages sont efficaces. # La valeur par d\u00e9faut est 0.0. # # Ce param\u00e8tre doit \u00eatre recalibr\u00e9 chaque fois que max_power est ajust\u00e9. # Pour calibrer ce param\u00e8tre, commencez avec off_below r\u00e9gl\u00e9 sur 0.0 et ventilateur tournant. Diminuez # progressivement la vitesse du ventilateur afin de d\u00e9terminer la vitesse d'entr\u00e9e la plus faible entra\u00eenant # le ventilateur de mani\u00e8re fiable sans d\u00e9crochage. R\u00e9glez off_below au rapport cyclique correspondant # \u00e0 cette valeur (par exemple, 12% -> 0,12) ou l\u00e9g\u00e8rement plus. #tachometer_pin: # Broche d'entr\u00e9e tachym\u00e9trique de surveillance de la vitesse du ventilateur. Un pullup est g\u00e9n\u00e9ralement # n\u00e9cessaire. Ce param\u00e8tre est facultatif. #tachometer_ppr: 2 # Lorsque tachometer_pin est sp\u00e9cifi\u00e9, il s'agit du nombre d'impulsions par r\u00e9volution du signal # tachym\u00e9trique. Pour un ventilateur BLDC, c'est normalement la moiti\u00e9 du nombre de p\u00f4les. # La valeur par d\u00e9faut est 2. #tachometer_poll_interval: 0.0015 # Lorsque tachometer_pin est sp\u00e9cifi\u00e9, il s'agit de la p\u00e9riode d'interrogation de la broche tachym\u00e9trique, # en secondes. La valeur par d\u00e9faut est 0.0015, ce qui est suffisamment rapide pour des ventilateurs de # moins de 10000 RPM \u00e0 2 PPR. Cette valeur doit \u00eatre inf\u00e9rieure \u00e0 30/(tachometer_ppr*rpm), avec une # certaine marge, o\u00f9 rpm est la vitesse maximale (en RPM) du ventilateur. #enable_pin: # Broche optionnelle pour d'activation de l'alimentation du ventilateur. Cela peut \u00eatre utile pour les # ventilateurs avec des entr\u00e9es PWM d\u00e9di\u00e9es. Certains de ces ventilateurs restent allum\u00e9s m\u00eame \u00e0 0 % # de PWM. Dans ce cas, la broche PWM peut \u00eatre utilis\u00e9e normalement et, par exemple, un FET commut\u00e9 # \u00e0 la masse (broche de ventilateur standard) peut \u00eatre utilis\u00e9 pour contr\u00f4ler l'alimentation du ventilateur. [heater_fan] \u00b6 Ventilateurs de chauffage (on peut d\u00e9finir un nombre quelconque de sections avec le pr\u00e9fixe \"heater_fan\"). Un \"ventilateur de chauffage\" est un ventilateur activ\u00e9 lorsque le chauffage qui lui est associ\u00e9 est actif. Par d\u00e9faut, un heater_fan a une vitesse d'arr\u00eat \u00e9gale \u00e0 la puissance maximale. [heater_fan my_nozzle_fan] #pin: #max_power: #shutdown_speed: #cycle_time: #hardware_pwm: #kick_start_time: #off_below: #tachometer_pin: #tachometer_ppr: #tachometer_poll_interval: #enable_pin: # Voir la section \"fan\" pour une description des param\u00e8tres ci-dessus. #heater: extruder # Nom de la section de configuration d\u00e9finissant le chauffage auquel ce ventilateur est associ\u00e9. # Si une liste de noms d'\u00e9l\u00e9ments chauffants s\u00e9par\u00e9s par des virgules est fournie ici, le # ventilateur sera activ\u00e9 lorsque l'un des chauffages donn\u00e9s est activ\u00e9. # La valeur par d\u00e9faut est \"extruder\". #heater_temp: 50.0 # Temp\u00e9rature (en Celsius) en dessous de laquelle l'\u00e9l\u00e9ment chauffant doit descendre pour que # le ventilateur soit d\u00e9sactiv\u00e9. La valeur par d\u00e9faut est 50 \u00b0C. #fan_speed: 1.0 # La vitesse du ventilateur (exprim\u00e9e sous la forme d'une valeur comprise entre 0,0 et 1,0) \u00e0 # laquelle le ventilateur sera r\u00e9gl\u00e9 lorsque l'\u00e9l\u00e9ment chauffant qui lui est associ\u00e9 est activ\u00e9. # La valeur par d\u00e9faut est 1.0 [controller_fan] \u00b6 Ventilateur de refroidissement du contr\u00f4leur (on peut d\u00e9finir un nombre quelconque de sections avec le pr\u00e9fixe \"controller_fan\"). Un \"ventilateur de contr\u00f4leur\" est un ventilateur activ\u00e9 chaque fois que l'\u00e9l\u00e9ment chauffant ou le pilote pas \u00e0 pas qui lui est associ\u00e9 est actif. Le ventilateur s'arr\u00eatera chaque fois qu'un idle_timeout sera atteint afin de garantir qu'aucune surchauffe ne se produise apr\u00e8s la d\u00e9sactivation d'un composant surveill\u00e9. [controller_fan my_controller_fan] #pin: #max_power: #shutdown_speed: #cycle_time: #hardware_pwm: #kick_start_time: #off_below: #tachometer_pin: #tachometer_ppr: #tachometer_poll_interval: #enable_pin: # Voir la section \"fan\" pour une description des param\u00e8tres ci-dessus. #fan_speed: 1.0 # Vitesse du ventilateur (exprim\u00e9e comme une valeur de 0,0 \u00e0 1,0) \u00e0 laquelle celui-ci # sera r\u00e9gl\u00e9 lorsqu'un chauffage ou un pilote pas \u00e0 pas est actif. # La valeur par d\u00e9faut est 1.0 #idle_timeout: # Dur\u00e9e (en secondes) apr\u00e8s activit\u00e9 d'un pilote pas \u00e0 pas ou d'un \u00e9l\u00e9ment chauffant # pour laquelle le ventilateur doit continuer de fonctionner. La valeur par d\u00e9faut # est de 30 secondes. #idle_speed: # Vitesse du ventilateur (exprim\u00e9e comme une valeur de 0,0 et 1,0) \u00e0 laquelle le r\u00e9gler # lors de l'activit\u00e9 d'une chauffe ou d'un pilote pas \u00e0 pas avant que le d\u00e9lai d'attente # idle_timeout ne soit atteint. La valeur par d\u00e9faut est fan_speed. #heater: #stepper : # Nom de la section de configuration d\u00e9finissant l'\u00e9l\u00e9ment chauffant/pilote auquel ce ventilateur # est associ\u00e9. Si une liste s\u00e9par\u00e9e par des virgules de noms d'\u00e9l\u00e9ments chauffants/pilotes est # fournie ici, le ventilateur s'activera lorsque l'un des \u00e9l\u00e9ments chauffants/pilotes donn\u00e9s est activ\u00e9. # Le chauffage par d\u00e9faut est \"extruder\", le pilote par d\u00e9faut est tous. [temperature_fan] \u00b6 Ventilateurs de refroidissement d\u00e9clench\u00e9s en fonction de la temp\u00e9rature (on peut d\u00e9finir un nombre quelconque de sections avec le pr\u00e9fixe \"temperature_fan\"). Un \"ventilateur de temp\u00e9rature\" est un ventilateur activ\u00e9 lorsque le capteur qui lui est associ\u00e9 est au-dessus d'une temp\u00e9rature d\u00e9finie. Par d\u00e9faut, un ventilateur de temp\u00e9rature a une vitesse d'arr\u00eat \u00e9gale \u00e0 la puissance maximale. Voir la r\u00e9f\u00e9rence des commandes pour plus d'informations. [temperature_fan my_temp_fan] #pin: #max_power: #shutdown_speed: #cycle_time: #hardware_pwm: #kick_start_time: #off_below: #tachometer_pin: #tachometer_ppr: #tachometer_poll_interval: #enable_pin: # Voir la section \"ventilateur\" pour une description des param\u00e8tres ci-dessus. #sensor_type: #sensor_pin: #control: #max_delta: #min_temp: #max_temp: # Voir la section \"extrudeuse\" pour une description des param\u00e8tres ci-dessus. #pid_Kp: #pid_Ki: #pid_Kd: # Les param\u00e8tres proportionnels (pid_Kp), int\u00e9graux (pid_Ki), et d\u00e9riv\u00e9s (pid_Ki) # du syst\u00e8me de contr\u00f4le par r\u00e9troaction PID. Klipper \u00e9value les param\u00e8tres PID # avec la formule g\u00e9n\u00e9rale suivante : # fan_pwm = max_power - (Kp*e + Ki*integral(e) - Kd*derivative(e)) / 255 # O\u00f9 \"e\" est \"temp\u00e9rature_cible - temp\u00e9rature_mesur\u00e9e\" et # \"fan_pwm\" est le d\u00e9bit du ventilateur demand\u00e9, 0,0 correspondant \u00e0 un arr\u00eat complet # et 1,0 correspond \u00e0 un fonctionnement \u00e0 plein r\u00e9gime. Les param\u00e8tres pid_Kp, pid_Ki, # et pid_Kd doivent \u00eatre fournis lorsque l'algorithme de contr\u00f4le PID est activ\u00e9. #pid_deriv_time: 2.0 # Une dur\u00e9e (en secondes) sur laquelle lisser les mesures de temp\u00e9rature lors de # l'utilisation de l'algorithme de contr\u00f4le PID. Cela peut r\u00e9duire l'impact du bruit de # mesure. La valeur par d\u00e9faut est de 2 secondes. #target_temp: 40.0 # Une temp\u00e9rature (en Celsius) qui sera la temp\u00e9rature cible. # La valeur par d\u00e9faut est 40 degr\u00e9s. #max_speed: 1.0 # La vitesse du ventilateur (exprim\u00e9e comme une valeur de 0,0 \u00e0 1,0) \u00e0 laquelle r\u00e9gler # le ventilateur lorsque la temp\u00e9rature du capteur d\u00e9passera la valeur d\u00e9finie. # La valeur par d\u00e9faut est 1.0. #min_speed: 0.3 # Vitesse minimale du ventilateur (exprim\u00e9e sous forme d'une valeur comprise entre 0,0 # et 1,0) \u00e0 laquelle r\u00e9gler le ventilateur pour les ventilateurs \u00e0 temp\u00e9rature PID. # La valeur par d\u00e9faut est 0,3. #gcode_id: # S'il est d\u00e9fini, la temp\u00e9rature sera signal\u00e9e dans les requ\u00eates M105 en utilisant l'identifiant # d'id donn\u00e9. La valeur par d\u00e9faut est de ne pas rapporter la temp\u00e9rature via M105. [fan_generic] \u00b6 Ventilateur command\u00e9 manuellement (on peut d\u00e9finir un nombre quelconque de sections avec le pr\u00e9fixe \"fan_generic\"). La vitesse d'un ventilateur command\u00e9 manuellement est r\u00e9gl\u00e9e avec la commande SET_FAN_SPEED commandes G-Code . [fan_generic extruder_partfan] #pin: #max_power: #shutdown_speed: #cycle_time: #hardware_pwm: #kick_start_time: #off_below: #tachometer_pin: #tachometer_ppr: #tachometer_poll_interval: #enable_pin: # Voir la section \"ventilateur\" pour une description des param\u00e8tres ci-dessus. LEDs \u00b6 [led] \u00b6 Prise en charge des LEDs (et des bandes de LEDs) contr\u00f4l\u00e9es par les broches PWM du microcontr\u00f4leur (on peut d\u00e9finir un nombre quelconque de sections avec le pr\u00e9fixe \"led\"). Voir la r\u00e9f\u00e9rence de la commande pour plus d'informations. [led my_led] #red_pin: #green_pin: #blue_pin: #white_pin: # La broche contr\u00f4lant la couleur de la LED donn\u00e9e. Au moins un des param\u00e8tres ci-dessus # doit \u00eatre fourni. #cycle_time: 0.010 # Dur\u00e9e (en secondes) par cycle PWM. Il est recommand\u00e9 # que ce soit 10 millisecondes ou plus lorsque l'on utilise un PWM logiciel. # La valeur par d\u00e9faut est de 0,010 seconde. #hardware_pwm: False # Activez ceci pour utiliser le PWM mat\u00e9riel au lieu du PWM logiciel. Lors de # l'utilisation du PWM mat\u00e9riel, le temps de cycle r\u00e9el est contraint par # l'impl\u00e9mentation et peut \u00eatre significativement diff\u00e9rent du # cycle_time demand\u00e9. La valeur par d\u00e9faut est False. #initial_RED: 0.0 #initial_GREEN: 0.0 #initial_BLUE: 0.0 #initial_WHITE: 0.0 # D\u00e9finit la couleur initiale de la LED. Chaque valeur doit \u00eatre comprise entre 0.0 et # 1.0. La valeur par d\u00e9faut pour chaque couleur est 0. [neopixel] \u00b6 Prise en charge des LED neopixel (alias WS2812) (on peut d\u00e9finir un nombre quelconque de sections avec le pr\u00e9fixe \"neopixel\"). Voir la r\u00e9f\u00e9rence de commande pour plus d'informations. Notez que l'impl\u00e9mentation du mcu linux ne supporte pas actuellement les neopixels directement connect\u00e9s. La conception actuelle utilisant l'interface du noyau Linux ne permet pas ce sc\u00e9nario car l'interface GPIO du noyau n'est pas assez rapide pour fournir les taux d'impulsion requis. [neopixel my_neopixel] pin: # La broche connect\u00e9e au neopixel. Ce param\u00e8tre doit \u00eatre # fourni. #chain_count: # Le nombre de puces Neopixel connect\u00e9es en \"cha\u00eene\" \u00e0 la broche fournie. # La valeur par d\u00e9faut est 1 (ce qui indique qu'un seul Neopixel est connect\u00e9 \u00e0 la broche). #color_order: GRB # D\u00e9finit l'ordre des pixels requis par le mat\u00e9riel LED (en utilisant une cha\u00eene # contenant les lettres R, G, B, W avec W en option). Alternativement, il peut s'agir d'une liste # d'ordres de pixels s\u00e9par\u00e9s par des virgules - un pour chaque LED de la cha\u00eene. # La valeur par d\u00e9faut est GRB. #initial_RED: 0.0 #initial_GREEN: 0.0 #initial_BLUE: 0.0 #initial_WHITE: 0.0 # Voir la section \"led\" pour des informations sur ces param\u00e8tres. [dotstar] \u00b6 Prise en charge des LEDs Dotstar (alias APA102) (on peut d\u00e9finir un nombre quelconque de sections avec le pr\u00e9fixe \"dotstar\"). Voir la r\u00e9f\u00e9rence de commande pour plus d'informations. [dotstar my_dotstar] data_pin: # La broche connect\u00e9e \u00e0 la ligne de donn\u00e9es du dotstar. Ce param\u00e8tre # doit \u00eatre fourni. clock_pin: # La broche connect\u00e9e \u00e0 la ligne d'horloge du dotstar. Ce param\u00e8tre # doit \u00eatre fourni. #chain_count: # Voir la section \"neopixel\" pour des informations sur ce param\u00e8tre. #initial_RED: 0.0 #initial_GREEN: 0.0 #initial_BLUE: 0.0 # Voir la section \"led\" pour des informations sur ces param\u00e8tres. [pca9533] \u00b6 Support de la LED PCA9533. Le PCA9533 est utilis\u00e9 sur la mightyboard. [pca9533 my_pca9533] #i2c_address : 98 # L'adresse i2c que la puce utilise sur le bus i2c. Utilisez 98 pour # le PCA9533/1, 99 pour le PCA9533/2. La valeur par d\u00e9faut est 98. #i2c_mcu: #i2c_bus: #i2c_speed: # Voir la section \"param\u00e8tres I2C communs\" pour une description des # param\u00e8tres ci-dessus. #initial_RED: 0.0 #initial_GREEN: 0.0 #initial_BLUE: 0.0 #initial_WHITE: 0.0 # Voir la section \"led\" pour des informations sur ces param\u00e8tres. [pca9632] \u00b6 Support des LEDs du PCA9632. Le PCA9632 est utilis\u00e9 sur le FlashForge Dreamer. [pca9632 my_pca9632] #i2c_address 98 # L'adresse i2c que la puce utilise sur le bus i2c. Cela peut \u00eatre # 96, 97, 98, ou 99. La valeur par d\u00e9faut est 98. #i2c_mcu: #i2c_bus: #i2c_speed: # Voir la section \"param\u00e8tres I2C communs\" pour une description des # param\u00e8tres ci-dessus. #scl_pin: #sda_pin: # Alternativement, si le pca9632 n'est pas connect\u00e9 \u00e0 un bus mat\u00e9riel I2C # il est possible de sp\u00e9cifier les broches \"clock\" (scl_pin) et \"data\" (sda_pin). # Le d\u00e9faut est d'utiliser l'I2C mat\u00e9riel. #color_order : RGBW # D\u00e9finit l'ordre des pixels de la LED (en utilisant une cha\u00eene contenant les lettres # R, G, B, W). La valeur par d\u00e9faut est RGBW. #initial_RED: 0.0 #initial_GREEN: 0.0 #initial_BLUE: 0.0 #initial_WHITE: 0.0 # Voir la section \"led\" pour des informations sur ces param\u00e8tres. Servos suppl\u00e9mentaires, boutons et autres broches \u00b6 [servo] \u00b6 Servos (on peut d\u00e9finir un nombre quelconque de sections avec le pr\u00e9fixe \"servo\"). Les servos peuvent \u00eatre contr\u00f4l\u00e9s en utilisant la commande SET_SERVO g-code . Par exemple : SET_SERVO SERVO=my_servo ANGLE=180 [servo my_servo] pin: # Broche de sortie PWM contr\u00f4lant le servo. Ce param\u00e8tre doit \u00eatre # fourni. #maximum_servo_angle: 180 # L'angle maximum (en degr\u00e9s) auquel ce servo peut \u00eatre r\u00e9gl\u00e9. La valeur # par d\u00e9faut est de 180 degr\u00e9s. #minimum_pulse_width: 0.001 # La dur\u00e9e minimale de la largeur d'impulsion (en secondes). Cela devrait correspondre # avec un angle de 0 degr\u00e9. La valeur par d\u00e9faut est de 0,001 seconde. #maximum_pulse_width: 0.002 # La dur\u00e9e maximale de la largeur d'impulsion (en secondes). Cela devrait correspondre # avec l'angle de maximum_servo_angle. La valeur par d\u00e9faut est 0.002 secondes. #initial_angle: # Angle initial (en degr\u00e9s) sur lequel r\u00e9gler le servo. La valeur par d\u00e9faut est de # ne pas envoyer de signal au d\u00e9marrage. #initial_pulse_width: # Dur\u00e9e initiale de la largeur d'impulsion (en secondes) \u00e0 laquelle le servo doit \u00eatre r\u00e9gl\u00e9. (Ceci # n'est valable que si initial_angle n'est pas d\u00e9fini). La valeur par d\u00e9faut est de n'envoyer # aucun signal au d\u00e9marrage. [gcode_button] \u00b6 Ex\u00e9cute le gcode quand un bouton est press\u00e9 ou rel\u00e2ch\u00e9 (ou quand une broche change d'\u00e9tat). Vous pouvez v\u00e9rifier l'\u00e9tat du bouton en utilisant QUERY_BUTTON button=my_gcode_button . [gcode_button my_gcode_button] pin: # La broche sur laquelle le bouton est connect\u00e9. Ce param\u00e8tre doit \u00eatre # fourni. #analog_range: # Deux r\u00e9sistances s\u00e9par\u00e9es par des virgules (en Ohms) sp\u00e9cifiant la plage de # r\u00e9sistance minimale et maximale de la r\u00e9sistance du bouton. Si le param\u00e8tre # analog_range est fourni, la broche doit \u00eatre une broche \u00e0 capacit\u00e9 analogique. # La valeur par d\u00e9faut est d'utiliser un gpio num\u00e9rique pour le bouton. #analog_pullup_resistor: # La r\u00e9sistance d'excursion (en Ohms) lorsque la gamme analogique est sp\u00e9cifi\u00e9e. # La valeur par d\u00e9faut est 4700 ohms. #press_gcode: # Une liste de commandes G-Code \u00e0 ex\u00e9cuter lorsque le bouton est press\u00e9. # Les mod\u00e8les G-Code sont pris en charge. Ce param\u00e8tre doit \u00eatre fourni. #release_gcode: # Une liste de commandes G-code \u00e0 ex\u00e9cuter lorsque le bouton est rel\u00e2ch\u00e9. # Les mod\u00e8les G-Code sont support\u00e9s. La valeur par d\u00e9faut est de ne pas ex\u00e9cuter # de commandes lors du rel\u00e2chement d'un bouton. [output_pin] \u00b6 Broches de sortie configurables \u00e0 l'ex\u00e9cution (on peut d\u00e9finir un nombre quelconque de sections avec un pr\u00e9fixe \"output_pin\"). Les broches configur\u00e9es ici seront param\u00e9tr\u00e9es comme des broches de sortie modifiables au moment de l'ex\u00e9cution en utilisant des commandes g-code \u00e9tendues de type \"SET_PIN PIN=my_pin VALUE=.1\" [output_pin my_pin] pin: # La broche \u00e0 configurer comme une sortie. Ce param\u00e8tre doit \u00eatre # fourni. #pwm: False # D\u00e9finit si la broche de sortie doit \u00eatre capable de modulation de largeur d'impulsion. # Si ce param\u00e8tre est vrai, les champs de valeur doivent \u00eatre compris entre 0 et 1. # La valeur par d\u00e9faut est False. #static_value: # Si cette valeur est d\u00e9finie, la broche est affect\u00e9e \u00e0 cette valeur au d\u00e9marrage et # la broche ne peut pas \u00eatre modifi\u00e9e pendant l'ex\u00e9cution. Une broche statique utilise # l\u00e9g\u00e8rement moins de RAM dans le micro-contr\u00f4leur. Le d\u00e9faut est d'utiliser # la configuration des broches param\u00e9tr\u00e9es lors du d\u00e9marrage. #value: # La valeur \u00e0 donner initialement \u00e0 la broche pendant la configuration du MCU. # La valeur par d\u00e9faut est 0 (pour une tension basse). #shutdown_value: # La valeur \u00e0 donner \u00e0 la broche lors d'un \u00e9v\u00e9nement d'arr\u00eat du MCU. La valeur par # d\u00e9faut est 0 (pour une tension basse). #maximum_mcu_duration: # La dur\u00e9e maximale pendant laquelle une valeur de non-arr\u00eat peut \u00eatre pilot\u00e9e par # le MCUsans un accus\u00e9 de r\u00e9ception de l'h\u00f4te. # Si l'h\u00f4te ne peut pas suivre une mise \u00e0 jour, le MCU s'\u00e9teindra et mettra # toutes les broches \u00e0 leurs valeurs d'arr\u00eat respectives. # D\u00e9faut : 0 (d\u00e9sactiv\u00e9) # Les valeurs habituelles sont d'environ 5 secondes. #cycle_time: 0.100 # La dur\u00e9e (en secondes) par cycle PWM. Il est recommand\u00e9 que ce soit # 10 millisecondes ou plus lorsque vous utilisez un PWM logiciel. # La valeur par d\u00e9faut est de 0.100 secondes pour les broches PWM. #hardware_pwm: False # Activez pour utiliser le PWM mat\u00e9riel au lieu du PWM logiciel. Lors de # l'utilisation d'un PWM mat\u00e9riel, le temps de cycle r\u00e9el est limit\u00e9 par # l'impl\u00e9mentation et peut \u00eatre significativement diff\u00e9rent du # cycle_time demand\u00e9. La valeur par d\u00e9faut est False. #scale : # Ce param\u00e8tre peut \u00eatre utilis\u00e9 pour modifier la fa\u00e7on dont les param\u00e8tres 'value' # et 'shutdown_value' sont interpr\u00e9t\u00e9s pour les broches pwm. Si fourni, alors # le param\u00e8tre 'value' doit \u00eatre compris entre 0.0 et 'scale'. Cela peut \u00eatre utile # lors de la configuration d'une broche PWM contr\u00f4lant une r\u00e9f\u00e9rence de tension # d'un moteur pas \u00e0 pas. L''\u00e9chelle' peut \u00eatre d\u00e9finie sur l'intensit\u00e9 du moteur pas # \u00e0 pas \u00e9quivalent si le PWM \u00e9tait enti\u00e8rement activ\u00e9, et puis le param\u00e8tre 'value' # peut \u00eatre sp\u00e9cifi\u00e9 en utilisant l'intensit\u00e9 souhait\u00e9e pour le moteur pas \u00e0 pas. La # valeur par d\u00e9faut est de ne pas mettre \u00e0 l'\u00e9chelle le param\u00e8tre 'value'. [static_digital_output] \u00b6 Broches de sortie num\u00e9rique configur\u00e9es statiquement (on peut d\u00e9finir un nombre quelconque de sections avec un pr\u00e9fixe \"static_digital_output\"). Les broches configur\u00e9es ici seront configur\u00e9es comme une sortie GPIO pendant la configuration du MCU. Elles ne peuvent pas \u00eatre modifi\u00e9es en cours d'ex\u00e9cution. [static_digital_output my_output_pins] pins: # Une liste de broches s\u00e9par\u00e9es par des virgules \u00e0 d\u00e9finir comme broches de sortie GPIO. La broche # sera d\u00e9finie \u00e0 un niveau haut, sauf si le nom de la broche est pr\u00e9c\u00e9d\u00e9 de \"!\". # Ce param\u00e8tre doit \u00eatre fourni. [multi_pin] \u00b6 Sorties \u00e0 broches multiples (on peut d\u00e9finir un nombre quelconque de sections avec le pr\u00e9fixe \"multi_pin\"). Une sortie multi_pin cr\u00e9e un alias de broche interne pouvant modifier plusieurs broches de sortie chaque fois que la broche alias est d\u00e9finie. Par exemple, on peut d\u00e9finir un objet \"[multi_pin my_fan]\" contenant deux broches et ensuite d\u00e9finir \"pin=multi_pin:my_fan\" dans la section \"[fan]\" - \u00e0 chaque changement du ventilateur, les deux broches de sortie seront mises \u00e0 jour. Ces alias ne peuvent pas \u00eatre utilis\u00e9s avec des broches de moteur pas \u00e0 pas. [multi_pin my_multi_pin] pins: # Une liste s\u00e9par\u00e9e par des virgules des broches associ\u00e9es \u00e0 cet alias. Ce param\u00e8tre # doit \u00eatre fourni. Configuration des pilotes pas \u00e0 pas TMC \u00b6 Configuration des pilotes de moteurs pas \u00e0 pas Trinamic en mode UART/SPI. Des informations suppl\u00e9mentaires sont disponibles dans le guide des pilotes TMC et dans la r\u00e9f\u00e9rence des commandes . [tmc2130] \u00b6 Configuration d' un pilote de moteur pas \u00e0 pas TMC2130 via le bus SPI. Pour utiliser cette fonctionnalit\u00e9, d\u00e9finissez une section de configuration avec un pr\u00e9fixe \"tmc2130\" suivi du nom de la section de configuration du moteur pas \u00e0 pas correspondant (par exemple, \"[tmc2130 stepper_x]\"). [tmc2130 stepper_x] cs_pin: # The pin corresponding to the TMC2130 chip select line. This pin # will be set to low at the start of SPI messages and raised to high # after the message completes. This parameter must be provided. #spi_speed: #spi_bus: #spi_software_sclk_pin: #spi_software_mosi_pin: #spi_software_miso_pin: # See the \"common SPI settings\" section for a description of the # above parameters. #chain_position: #chain_length: # These parameters configure an SPI daisy chain. The two parameters # define the stepper position in the chain and the total chain length. # Position 1 corresponds to the stepper that connects to the MOSI signal. # The default is to not use an SPI daisy chain. #interpolate: True # If true, enable step interpolation (the driver will internally # step at a rate of 256 micro-steps). This interpolation does # introduce a small systemic positional deviation - see # TMC_Drivers.md for details. The default is True. run_current: # The amount of current (in amps RMS) to configure the driver to use # during stepper movement. This parameter must be provided. #hold_current: # The amount of current (in amps RMS) to configure the driver to use # when the stepper is not moving. Setting a hold_current is not # recommended (see TMC_Drivers.md for details). The default is to # not reduce the current. #sense_resistor: 0.110 # The resistance (in ohms) of the motor sense resistor. The default # is 0.110 ohms. #stealthchop_threshold: 0 # The velocity (in mm/s) to set the \"stealthChop\" threshold to. When # set, \"stealthChop\" mode will be enabled if the stepper motor # velocity is below this value. The default is 0, which disables # \"stealthChop\" mode. #driver_MSLUT0: 2863314260 #driver_MSLUT1: 1251300522 #driver_MSLUT2: 608774441 #driver_MSLUT3: 269500962 #driver_MSLUT4: 4227858431 #driver_MSLUT5: 3048961917 #driver_MSLUT6: 1227445590 #driver_MSLUT7: 4211234 #driver_W0: 2 #driver_W1: 1 #driver_W2: 1 #driver_W3: 1 #driver_X1: 128 #driver_X2: 255 #driver_X3: 255 #driver_START_SIN: 0 #driver_START_SIN90: 247 # These fields control the Microstep Table registers directly. The optimal # wave table is specific to each motor and might vary with current. An # optimal configuration will have minimal print artifacts caused by # non-linear stepper movement. The values specified above are the default # values used by the driver. The value must be specified as a decimal integer # (hex form is not supported). In order to compute the wave table fields, # see the tmc2130 \"Calculation Sheet\" from the Trinamic website. #driver_IHOLDDELAY: 8 #driver_TPOWERDOWN: 0 #driver_TBL: 1 #driver_TOFF: 4 #driver_HEND: 7 #driver_HSTRT: 0 #driver_PWM_AUTOSCALE: True #driver_PWM_FREQ: 1 #driver_PWM_GRAD: 4 #driver_PWM_AMPL: 128 #driver_SGT: 0 # Set the given register during the configuration of the TMC2130 # chip. This may be used to set custom motor parameters. The # defaults for each parameter are next to the parameter name in the # above list. #diag0_pin: #diag1_pin: # The micro-controller pin attached to one of the DIAG lines of the # TMC2130 chip. Only a single diag pin should be specified. The pin # is \"active low\" and is thus normally prefaced with \"^!\". Setting # this creates a \"tmc2130_stepper_x:virtual_endstop\" virtual pin # which may be used as the stepper's endstop_pin. Doing this enables # \"sensorless homing\". (Be sure to also set driver_SGT to an # appropriate sensitivity value.) The default is to not enable # sensorless homing. [tmc2208] \u00b6 Configuration d'un pilote de moteur pas \u00e0 pas TMC2208 (ou TMC2224) via un UART \u00e0 fil unique. Pour utiliser cette fonctionnalit\u00e9, d\u00e9finissez une section de configuration avec un pr\u00e9fixe \"tmc2208\" suivi du nom de la section de configuration du moteur pas \u00e0 pas correspondant (par exemple, \"[tmc2208 stepper_x]\"). [tmc2208 stepper_x] uart_pin: # La broche connect\u00e9e \u00e0 la ligne PDN_UART de la TMC2208. Ce param\u00e8tre # doit \u00eatre fourni. #tx_pin: # Si vous utilisez des lignes de r\u00e9ception et de transmission s\u00e9par\u00e9es pour communiquer # avec le pilote, r\u00e9glez uart_pin sur la broche de r\u00e9ception et tx_pin sur la broche # d'\u00e9mission. La valeur par d\u00e9faut est d'utiliser uart_pin pour la lecture et l'\u00e9criture. #select_pins: # Une liste de broches, s\u00e9par\u00e9es par des virgules, \u00e0 d\u00e9finir avant d'acc\u00e9der \u00e0 l'UART du # tmc2208. Ceci peut \u00eatre utile pour configurer un mux analogique pour la communication # UART. La valeur par d\u00e9faut est de ne pas configurer de broches. #interpolate: True # Si true, active l'interpolation de pas (le pilote fera un pas interne \u00e0 un taux de 256 # micro-pas). Cette interpolation introduit une petite d\u00e9viation syst\u00e9mique de la position - # voir TMC_Drivers.md pour plus de d\u00e9tails. La valeur par d\u00e9faut est True. run_current: # La quantit\u00e9 de courant (en amp\u00e8res RMS) \u00e0 configurer que le pilote doit utiliser # pendant le mouvement du pas. Ce param\u00e8tre doit \u00eatre fourni. #hold_current: # La quantit\u00e9 de courant (en amp\u00e8res RMS) \u00e0 configurer que le pilote doit utiliser quand # le moteur pas \u00e0 pas n'est pas en mouvement. La d\u00e9finition d'un hold_current n'est pas # recommand\u00e9e (voir TMC_Drivers.md pour plus de d\u00e9tails). La valeur par d\u00e9faut est de # ne pas r\u00e9duire le courant. #sense_resistor: 0.110 # La r\u00e9sistance (en ohms) de la r\u00e9sistance de d\u00e9tection du moteur (Vr\u00e9f). La valeur par # d\u00e9faut est de 0.110 ohms. #stealthchop_threshold: 0 # La vitesse (en mm/s) \u00e0 laquelle le seuil \"stealthChop\" doit \u00eatre fix\u00e9. Lorsque d\u00e9fini, # le mode \"stealthChop\" sera activ\u00e9 si la vitesse du moteur pas \u00e0 pas est inf\u00e9rieure \u00e0 # cette valeur. La valeur par d\u00e9faut est 0, ce qui d\u00e9sactive le mode \"stealthChop\". #driver_IHOLDDELAY: 8 #driver_TPOWERDOWN: 20 #driver_TBL: 2 #driver_TOFF: 3 #driver_HEND: 0 #driver_HSTRT: 5 #driver_PWM_AUTOGRAD: True #driver_PWM_AUTOSCALE: True #driver_PWM_LIM: 12 #driver_PWM_REG: 8 #driver_PWM_FREQ: 1 #driver_PWM_GRAD: 14 #driver_PWM_OFS: 36 # D\u00e9finissez le registre donn\u00e9 pendant la configuration de la puce TMC2208. Ceci peut \u00eatre # utilis\u00e9 pour d\u00e9finir les param\u00e8tres personnalis\u00e9s du moteur. Les valeurs par d\u00e9faut de # chaque param\u00e8tre sont indiqu\u00e9es \u00e0 c\u00f4t\u00e9 du nom du param\u00e8tre dans la liste ci-dessus. [tmc2209] \u00b6 Configuration d'un pilote de moteur pas \u00e0 pas TMC2209 via un UART \u00e0 fil unique. Pour utiliser cette fonctionnalit\u00e9, d\u00e9finissez une section de configuration avec un pr\u00e9fixe \"tmc2209\" suivi du nom de la section de configuration du moteur pas \u00e0 pas correspondant (par exemple, \"[tmc2209 stepper_x]\"). [tmc2209 stepper_x] uart_pin: #tx_pin #select_pins: #interpolate: True run_current: #hold_current: #sense_resistor: 0.110 #stealthchop_threshold: 0 # Voir la section \"tmc2208\" pour la d\u00e9finition de ces param\u00e8tres. #uart_address: # L'adresse de la puce TMC2209 pour les messages UART (un entier entre 0 et 3). # Ce param\u00e8tre est g\u00e9n\u00e9ralement utilis\u00e9 lorsque plusieurs puces TMC2209 sont # connect\u00e9es \u00e0 la m\u00eame broche UART. La valeur par d\u00e9faut est z\u00e9ro. #driver_IHOLDDELAY: 8 #driver_TPOWERDOWN: 20 #driver_TBL: 2 #driver_TOFF: 3 #driver_HEND: 0 #driver_HSTRT: 5 #driver_PWM_AUTOGRAD: True #driver_PWM_AUTOSCALE: True #driver_PWM_LIM: 12 #driver_PWM_REG: 8 #driver_PWM_FREQ: 1 #driver_PWM_GRAD: 14 #driver_PWM_OFS: 36 #driver_SGTHRS: 0 # D\u00e9finit le registre donn\u00e9 pendant la configuration de la puce TMC2209. Ceci peut \u00eatre # utilis\u00e9 pour d\u00e9finir les param\u00e8tres personnalis\u00e9s du moteur. Les valeurs par d\u00e9faut de # chaque param\u00e8tre sont indiqu\u00e9es \u00e0 c\u00f4t\u00e9 du nom du param\u00e8tre dans la liste ci-dessus. #diag_pin: # La broche du microcontr\u00f4leur reli\u00e9e \u00e0 la ligne DIAG de la puce TMC2209. La broche est # normalement pr\u00e9c\u00e9d\u00e9e de \"^\" pour activer un pullup. Le param\u00e9trage de cette broche # cr\u00e9e une broche virtuelle \"tmc2209_stepper_x:virtual_endstop\" pouvant \u00eatre utilis\u00e9e # comme broche d'arr\u00eat du moteur. Ainsi cela active le \"sensorless homing\". (Assurez- # vous de d\u00e9finir \u00e9galement driver_SGTHRS \u00e0 une valeur de sensibilit\u00e9 appropri\u00e9e). # La valeur par d\u00e9faut est de ne pas activer la recherche d'origine sans capteur. [tmc2660] \u00b6 Configuration d'un pilote de moteur pas \u00e0 pas TMC2660 via le bus SPI. Pour utiliser cette fonctionnalit\u00e9, d\u00e9finissez une section de configuration avec un pr\u00e9fixe \"tmc2660\" suivi du nom de la section de configuration du moteur pas \u00e0 pas correspondant (par exemple, \"[tmc2660 stepper_x]\"). [tmc2660 stepper_x] cs_pin: # La broche correspondant \u00e0 la ligne de s\u00e9lection de la puce TMC2660. Cette # broche sera mise \u00e0 l'\u00e9tat bas au d\u00e9but des messages SPI et passera \u00e0 l'\u00e9tat # haut apr\u00e8s la fin du transfert du message. Ce param\u00e8tre doit \u00eatre fourni. #spi_speed: 4000000 # Fr\u00e9quence du bus SPI utilis\u00e9e pour communiquer avec le pilote de pas \u00e0 pas # TMC2660. La valeur par d\u00e9faut est 4000000. #spi_bus: #spi_software_sclk_pin: #spi_software_mosi_pin: #spi_software_miso_pin: # Voir la section \"param\u00e8tres SPI communs\" pour une description des # param\u00e8tres ci-dessus. #interpolate: True # Si vrai, active l'interpolation par pas (le pilote fera un pas interne \u00e0 un taux # de 256 micro-pas). Cela ne fonctionne que si les micro-pas sont fix\u00e9s \u00e0 16. # L'interpolation introduit une petite d\u00e9viation de position syst\u00e9mique - voir # TMC_Drivers.md pour plus de d\u00e9tails. La valeur par d\u00e9faut est True. run_current: # La quantit\u00e9 de courant (en amp\u00e8res RMS) utilis\u00e9e par le pilote pendant le # d\u00e9placement du moteur pas \u00e0 pas. Ce param\u00e8tre doit \u00eatre fourni. #sense_resistor: # La r\u00e9sistance (en ohms) de la r\u00e9sistance de d\u00e9tection du moteur (Vr\u00e9f). Ce # param\u00e8tre doit \u00eatre fourni. #idle_current_percent 100 # Le pourcentage du courant de fonctionnement auquel le pilote pas \u00e0 pas # sera abaiss\u00e9 quand le d\u00e9lai d'inactivit\u00e9 expirera (vous devez configurer le # d\u00e9lai \u00e0 l'aide d'une section de configuration [idle_timeout]). Le courant sera # remont\u00e9 d\u00e8s que le moteur devra \u00e0 nouveau se d\u00e9placer. Assurez-vous de # d\u00e9finir une valeur suffisamment \u00e9lev\u00e9e pour que les moteurs ne perdent pas # leur position. Il y a \u00e9galement un petit d\u00e9lai avant que le courant ne soit remis, # il faut donc en tenir compte lors de demandes de mouvements rapides alors # que le pilote est inactif. La valeur par d\u00e9faut est 100 (aucune r\u00e9duction). #driver_TBL: 2 #driver_RNDTF: 0 #driver_HDEC: 0 #driver_CHM: 0 #driver_HEND: 3 #driver_HSTRT: 3 #driver_TOFF: 4 #driver_SEIMIN: 0 #driver_SEDN: 0 #driver_SEMAX: 0 #driver_SEUP: 0 #driver_SEMIN: 0 #driver_SFILT: 0 #driver_SGT: 0 #driver_SLPH: 0 #driver_SLPL: 0 #driver_DISS2G: 0 #driver_TS2G: 3 # D\u00e9finit les param\u00e8tres \u00e0 utiliser pendant la configuration de la puce TMC2660. # Ceci peut \u00eatre utilis\u00e9 pour d\u00e9finir des param\u00e8tres de pilote personnalis\u00e9s. Les # valeurs par d\u00e9faut de chaque param\u00e8tre sont indiqu\u00e9es \u00e0 c\u00f4t\u00e9 du nom du param\u00e8tre # dans la liste ci-dessus. Consultez la fiche technique du TMC2660 pour conna\u00eetre la # fonction de chaque param\u00e8tre ainsi que les restrictions sur les combinaisons de # param\u00e8tres. Soyez particuli\u00e8rement attentif au registre CHOPCONF, o\u00f9 le fait de # r\u00e9gler CHM \u00e0 soit z\u00e9ro, soit un, entra\u00eene des modifications de la disposition (le # premier bit de HDEC est interpr\u00e9t\u00e9 comme le MSB de HSTRT dans ce cas). [tmc5160] \u00b6 Configuration d'un pilote de moteur pas \u00e0 pas TMC5160 via le bus SPI. Pour utiliser cette fonctionnalit\u00e9, d\u00e9finissez une section de configuration avec un pr\u00e9fixe \"tmc5160\" suivi du nom de la section de configuration du moteur pas \u00e0 pas correspondant (par exemple, \"[tmc5160 stepper_x]\"). [tmc5160 stepper_x] cs_pin: # The pin corresponding to the TMC5160 chip select line. This pin # will be set to low at the start of SPI messages and raised to high # after the message completes. This parameter must be provided. #spi_speed: #spi_bus: #spi_software_sclk_pin: #spi_software_mosi_pin: #spi_software_miso_pin: # See the \"common SPI settings\" section for a description of the # above parameters. #chain_position: #chain_length: # These parameters configure an SPI daisy chain. The two parameters # define the stepper position in the chain and the total chain length. # Position 1 corresponds to the stepper that connects to the MOSI signal. # The default is to not use an SPI daisy chain. #interpolate: True # If true, enable step interpolation (the driver will internally # step at a rate of 256 micro-steps). The default is True. run_current: # The amount of current (in amps RMS) to configure the driver to use # during stepper movement. This parameter must be provided. #hold_current: # The amount of current (in amps RMS) to configure the driver to use # when the stepper is not moving. Setting a hold_current is not # recommended (see TMC_Drivers.md for details). The default is to # not reduce the current. #sense_resistor: 0.075 # The resistance (in ohms) of the motor sense resistor. The default # is 0.075 ohms. #stealthchop_threshold: 0 # The velocity (in mm/s) to set the \"stealthChop\" threshold to. When # set, \"stealthChop\" mode will be enabled if the stepper motor # velocity is below this value. The default is 0, which disables # \"stealthChop\" mode. #driver_MSLUT0: 2863314260 #driver_MSLUT1: 1251300522 #driver_MSLUT2: 608774441 #driver_MSLUT3: 269500962 #driver_MSLUT4: 4227858431 #driver_MSLUT5: 3048961917 #driver_MSLUT6: 1227445590 #driver_MSLUT7: 4211234 #driver_W0: 2 #driver_W1: 1 #driver_W2: 1 #driver_W3: 1 #driver_X1: 128 #driver_X2: 255 #driver_X3: 255 #driver_START_SIN: 0 #driver_START_SIN90: 247 # These fields control the Microstep Table registers directly. The optimal # wave table is specific to each motor and might vary with current. An # optimal configuration will have minimal print artifacts caused by # non-linear stepper movement. The values specified above are the default # values used by the driver. The value must be specified as a decimal integer # (hex form is not supported). In order to compute the wave table fields, # see the tmc2130 \"Calculation Sheet\" from the Trinamic website. #driver_IHOLDDELAY: 6 #driver_TPOWERDOWN: 10 #driver_TBL: 2 #driver_TOFF: 3 #driver_HEND: 2 #driver_HSTRT: 5 #driver_FD3: 0 #driver_TPFD: 4 #driver_CHM: 0 #driver_VHIGHFS: 0 #driver_VHIGHCHM: 0 #driver_DISS2G: 0 #driver_DISS2VS: 0 #driver_PWM_AUTOSCALE: True #driver_PWM_AUTOGRAD: True #driver_PWM_FREQ: 0 #driver_FREEWHEEL: 0 #driver_PWM_GRAD: 0 #driver_PWM_OFS: 30 #driver_PWM_REG: 4 #driver_PWM_LIM: 12 #driver_SGT: 0 #driver_SEMIN: 0 #driver_SEUP: 0 #driver_SEMAX: 0 #driver_SEDN: 0 #driver_SEIMIN: 0 #driver_SFILT: 0 # Set the given register during the configuration of the TMC5160 # chip. This may be used to set custom motor parameters. The # defaults for each parameter are next to the parameter name in the # above list. #diag0_pin: #diag1_pin: # The micro-controller pin attached to one of the DIAG lines of the # TMC5160 chip. Only a single diag pin should be specified. The pin # is \"active low\" and is thus normally prefaced with \"^!\". Setting # this creates a \"tmc5160_stepper_x:virtual_endstop\" virtual pin # which may be used as the stepper's endstop_pin. Doing this enables # \"sensorless homing\". (Be sure to also set driver_SGT to an # appropriate sensitivity value.) The default is to not enable # sensorless homing. Configuration du courant du moteur pas \u00e0 pas en temps r\u00e9el \u00b6 [ad5206] \u00b6 Digipots AD5206 configur\u00e9s statiquement et connect\u00e9s via un bus SPI (on peut d\u00e9finir un nombre quelconque de sections avec un pr\u00e9fixe \"ad5206\"). [ad5206 my_digipot] enable_pin: # La broche correspondant \u00e0 la ligne de s\u00e9lection de la puce AD5206. Cette broche # sera r\u00e9gl\u00e9e \u00e0 un niveau bas au d\u00e9but des messages SPI et sera relev\u00e9e \u00e0 un niveau \u00e9lev\u00e9 # apr\u00e8s la fin du message. Ce param\u00e8tre doit \u00eatre fourni. #spi_speed: #spi_bus: #spi_software_sclk_pin: #spi_software_mosi_pin: #spi_software_miso_pin: # Voir la section \"param\u00e8tres communs SPI\" pour une description des param\u00e8tres ci-dessus. # #channel_1: #channel_2: #channel_3: #channel_4: #channel_5: #channel_6: # La valeur pour d\u00e9finir statiquement le canal AD5206 donn\u00e9. Cette valeur est # g\u00e9n\u00e9ralement d\u00e9finie sur un nombre compris entre 0,0 et 1,0. 1,0 \u00e9tant la r\u00e9sistance # la plus \u00e9lev\u00e9e et 0,0 la r\u00e9sistance la plus faible. Cependant, la plage peut \u00eatre # modifi\u00e9e \u00e0 l'aide du param\u00e8tre 'scale' (voir ci-dessous). # Si un canal n'est pas sp\u00e9cifi\u00e9, il n'est pas configur\u00e9. # scale: # Ce param\u00e8tre peut \u00eatre utilis\u00e9 pour modifier l'interpr\u00e9tation des param\u00e8tres 'channel_x'. # S'il est fourni, alors les param\u00e8tres 'channel_x' doivent \u00eatre compris entre 0.0 et 'scale'. # Cela peut \u00eatre utile lorsque le AD5206 est utilis\u00e9 pour d\u00e9finir des r\u00e9f\u00e9rences de tension # pas \u00e0 pas. L''\u00e9chelle' peut \u00eatre r\u00e9gl\u00e9e sur l'intensit\u00e9 \u00e9quivalente de la commande pas \u00e0 pas # si l'AD5206 \u00e9tait \u00e0 sa r\u00e9sistance la plus \u00e9lev\u00e9e, puis les param\u00e8tres 'channel_x' peuvent \u00eatre # sp\u00e9cifi\u00e9s en utilisant la valeur d'intensit\u00e9 d\u00e9sir\u00e9e pour le pilote pas \u00e0 pas. La configuration # par d\u00e9faut est de ne pas mettre \u00e0 l'\u00e9chelle les param\u00e8tres 'channel_x'. [mcp4451] \u00b6 Digipot MCP4451 configur\u00e9 statiquement et connect\u00e9 via le bus I2C (on peut d\u00e9finir un nombre quelconque de sections avec un pr\u00e9fixe \"mcp4451\"). [mcp4451 mon_digipot] i2c_address: # L'adresse i2c que la puce utilise sur le bus i2c. Ce param\u00e8tre # doit \u00eatre fourni. #i2c_mcu: #i2c_bus: #i2c_speed: # Voir la section \"param\u00e8tres I2C communs\" pour une description des # param\u00e8tres ci-dessus. #wiper_0: #wiper_1: #wiper_2: #wiper_3: # La valeur pour d\u00e9finir statiquement le \"wiper\" MCP4451 donn\u00e9. Cette valeur est # g\u00e9n\u00e9ralement r\u00e9gl\u00e9e sur un nombre compris entre 0.0 et 1.0, 1.0 \u00e9tant la r\u00e9sistance # la plus \u00e9lev\u00e9e et 0.0 la r\u00e9sistance la plus faible. Cependant, la plage peut \u00eatre modifi\u00e9e # \u00e0 l'aide du param\u00e8tre 'scale' (voir ci-dessous). Si un wiper n'est pas sp\u00e9cifi\u00e9, il n'est # pas configur\u00e9. #scale: # Ce param\u00e8tre peut \u00eatre utilis\u00e9 pour modifier l'interpr\u00e9tation des param\u00e8tres 'wiper_x'. # S'il est fourni, alors les param\u00e8tres 'wiper_x' doivent \u00eatre compris entre 0,0 et 'scale'. # Ceci peut \u00eatre utile lorsque le MCP4451 est utilis\u00e9 pour d\u00e9finir des r\u00e9f\u00e9rences de tension # du pilote pas \u00e0 pas.L''\u00e9chelle' peut \u00eatre r\u00e9gl\u00e9e sur l'intensit\u00e9 du pilote pas \u00e0 pas \u00e9quivalent # si le MCP4451 \u00e9tait \u00e0 sa r\u00e9sistance la plus \u00e9lev\u00e9e, puis les param\u00e8tres 'wiper_x' peuvent # \u00eatre sp\u00e9cifi\u00e9s en utilisant la valeur d'intensit\u00e9 d\u00e9sir\u00e9e pour le pilote pas \u00e0 pas. La valeur # par d\u00e9faut est de ne pas mettre \u00e0 l'\u00e9chelle les param\u00e8tres 'wiper_x'. [mcp4728] \u00b6 Convertisseur num\u00e9rique-analogique MCP4728 configur\u00e9 statiquement et connect\u00e9 via le bus I2C (on peut d\u00e9finir un nombre quelconque de sections avec un pr\u00e9fixe \"mcp4728\"). [mcp4728 my_dac] #i2c_address: 96 # L'adresse i2c que la puce utilise sur le bus i2c. La valeur par d\u00e9faut # est 96. #i2c_mcu: #i2c_bus: #i2c_speed: # Voir la section \"param\u00e8tres I2C communs\" pour une description des # param\u00e8tres ci-dessus. #channel_a: #channel_b: #channel_c: #channel_d: # La valeur pour d\u00e9finir statiquement le canal MCP4728 donn\u00e9. Ceci est # g\u00e9n\u00e9ralement d\u00e9finie par un nombre compris entre 0.0 et 1.0, 1.0 repr\u00e9sentant # la tension la plus \u00e9lev\u00e9e (2.048V) et 0.0 la tension la plus basse. # Cependant, la plage peut \u00eatre modifi\u00e9e \u00e0 l'aide du param\u00e8tre 'scale' (cf. # ci-dessous). Si un canal n'est pas sp\u00e9cifi\u00e9, il n'est pas configur\u00e9. #scale: # Ce param\u00e8tre peut \u00eatre utilis\u00e9 pour modifier l'interpr\u00e9tation des param\u00e8tres 'channel_x'. # S'il est fourni, le param\u00e8tre 'channel_x' doit \u00eatre compris entre 0,0 et 'scale'. # Cela peut \u00eatre utile lorsque le MCP4728 est utilis\u00e9 pour d\u00e9finir des r\u00e9f\u00e9rences de tension # de moteur pas \u00e0 pas. L''\u00e9chelle' peut \u00eatre r\u00e9gl\u00e9e sur l'intensit\u00e9 \u00e9quivalente de la commande # de moteur pas \u00e0 pas si le MCP4728 \u00e9tait \u00e0 sa tension la plus \u00e9lev\u00e9e (2.048V), et ensuite les # param\u00e8tres 'channel_x' peuvent \u00eatre sp\u00e9cifi\u00e9s en utilisant l'intensit\u00e9 d\u00e9sir\u00e9e pour le # moteur pas \u00e0 pas. La valeur par d\u00e9faut est de ne pas mettre \u00e0 l'\u00e9chelle les # param\u00e8tres 'channel_x'. [mcp4018] \u00b6 Digipot MCP4018 configur\u00e9 statiquement et connect\u00e9 via deux broches gpio \"bit banging\" (on peut d\u00e9finir un nombre quelconque de sections avec un pr\u00e9fixe \"mcp4018\"). [mcp4018 my_digipot] scl_pin: # La broche d'horloge SCL. Ce param\u00e8tre doit \u00eatre fourni. sda_pin: # La broche de \"donn\u00e9es\" SDA. Ce param\u00e8tre doit \u00eatre fourni. wiper: # La valeur \u00e0 laquelle d\u00e9finir statiquement le \"wiper\" MCP4018 donn\u00e9. Ce param\u00e8tre est # g\u00e9n\u00e9ralement r\u00e9gl\u00e9e sur un nombre compris entre 0,0 et 1,0, 1,0 \u00e9tant la r\u00e9sistance # la plus \u00e9lev\u00e9e et 0.0 la r\u00e9sistance la plus faible. Cependant, la plage peut \u00eatre modifi\u00e9e \u00e0 # l'aide du param\u00e8tre 'scale' (voir ci-dessous). Ce param\u00e8tre doit \u00eatre fourni. #scale: # Ce param\u00e8tre peut \u00eatre utilis\u00e9 pour modifier l'interpr\u00e9tation du param\u00e8tre 'wiper'. # S'il est fourni, le param\u00e8tre 'wiper' doit se situer entre 0,0 et 'scale'. Ceci peut \u00eatre utile # lorsque le MCP4018 est utilis\u00e9 pour d\u00e9finir des r\u00e9f\u00e9rences de tension pas \u00e0 pas. # L''\u00e9chelle' peut \u00eatre r\u00e9gl\u00e9e sur l'intensit\u00e9 du pilote pas \u00e0 pas \u00e9quivalent si le MCP4018 # est \u00e0 sa plus grande# r\u00e9sistance la plus \u00e9lev\u00e9e, puis le param\u00e8tre 'wiper' peut \u00eatre sp\u00e9cifi\u00e9 # en utilisant la valeur d'intensit\u00e9 d\u00e9sir\u00e9e pour le pilote pas \u00e0 pas. La valeur par d\u00e9faut est # de ne pas mettre \u00e0 l'\u00e9chelle le param\u00e8tre 'wiper'. Prise en charge de l'affichage \u00b6 [display] \u00b6 Prise en charge d'un \u00e9cran reli\u00e9 au microcontr\u00f4leur. [display] lcd_type: # Le type de puce LCD utilis\u00e9. Cela peut \u00eatre \"hd44780\", \"hd44780_spi\", \"st7920\", # \"emulated_st7920\", \"uc1701\", \"ssd1306\", ou \"sh1106\". # Voir les sections d'affichage ci-dessous pour plus d'informations sur chaque type # et les param\u00e8tres suppl\u00e9mentaires qu'ils fournissent. Ce param\u00e8tre doit \u00eatre # fourni. #display_group: # Le nom du groupe de donn\u00e9es \u00e0 afficher sur l'\u00e9cran. Cela contr\u00f4le le contenu de # l'\u00e9cran (voir la section \"display_data\" pour plus d'informations). La valeur par # d\u00e9faut est _default_20x4 pour les \u00e9crans hd44780 et _default_16x4 pour les # autres affichages. #menu_timeout: # D\u00e9lai d'attente pour le menu. Le fait d'\u00eatre inactif pendant ce nombre de secondes # d\u00e9clenchera la sortie du menu ou le retour au menu racine si l'autorun est activ\u00e9. # La valeur par d\u00e9faut est 0 seconde (d\u00e9sactiv\u00e9) #menu_root: # Nom de la section du menu principal \u00e0 afficher lorsque vous cliquez sur l'encodeur # de l'\u00e9cran d'accueil. La valeur par d\u00e9faut est __main, et cela affiche les menus par # d\u00e9faut tels que d\u00e9finis dans klippy/extras/display/menu.cfg #menu_reverse_navigation: # Lorsque activ\u00e9, inverse les directions vers le haut et vers le bas de la liste. # La valeur par d\u00e9faut est False. Ce param\u00e8tre est optionnel. #encoder_pins: # Les broches connect\u00e9es \u00e0 l'encodeur. 2 broches doivent \u00eatre fournies lorsque vous # utilisez l'encodeur. Ce param\u00e8tre doit \u00eatre fourni lors de l'utilisation du menu. #encoder_steps_per_detent: # Combien de pas l'encodeur \u00e9met par cran (\"clic\"). Si l'encodeur prend deux crans pour # se d\u00e9placer entre les entr\u00e9es ou d\u00e9place deux entr\u00e9es \u00e0 partir d'un seul cran, essayez de # modifier cette valeur. Les valeurs autoris\u00e9es sont 2 (demi-step) ou 4 (full-step). # La valeur par d\u00e9faut est 4. #click_pin: # La broche connect\u00e9e au bouton 'entr\u00e9e' ou au 'clic' de l'encodeur. Ce param\u00e8tre doit # \u00eatre fourni lors de l'utilisation du menu. La pr\u00e9sence d'un param\u00e8tre de configuration # 'analog_range_click_pin' fait passer ce param\u00e8tre de num\u00e9rique \u00e0 analogique. #back_pin: # La broche connect\u00e9e au bouton 'retour'. Ce param\u00e8tre est facultatif, le menu peut \u00eatre utilis\u00e9 # sans lui. La pr\u00e9sence d'un param\u00e8tre de configuration 'analog_range_back_pin' transforme # ce param\u00e8tre de num\u00e9rique \u00e0 analogique. #up_pin: # La broche connect\u00e9e au bouton 'haut'. Ce param\u00e8tre doit \u00eatre fourni lorsque vous utilisez un # menu sans encodeur. La pr\u00e9sence d'un param\u00e8tre de configuration 'analog_range_up_pin' # transforme ce param\u00e8tre de num\u00e9rique \u00e0 analogique. #down_pin: # La broche connect\u00e9e au bouton 'bas'. Ce param\u00e8tre doit \u00eatre fourni lorsque vous utilisez un # menu sans encodeur. La pr\u00e9sence d'un param\u00e8tre de configuration 'analog_range_down_pin' # transforme ce param\u00e8tre de num\u00e9rique \u00e0 analogique. #kill_pin: # La broche connect\u00e9e au bouton 'kill'. Ce bouton appellera l'arr\u00eat d'urgence. La pr\u00e9sence d'un # param\u00e8tre 'analog_range_kill_pin' fait passer ce param\u00e8tre de num\u00e9rique \u00e0 analogique. #analog_pullup_resistor: 4700 # La r\u00e9sistance (en ohms) du pullup attach\u00e9 au bouton analogique. # La valeur par d\u00e9faut est de 4700 ohms. #analog_range_click_pin: # La plage de r\u00e9sistances du bouton 'entr\u00e9e'. Les valeurs minimale et maximale de la plage # s\u00e9par\u00e9es par des virgules doivent \u00eatre fournies lors de l'utilisation du bouton analogique. #analog_range_back_pin: # La plage de r\u00e9sistances du bouton 'retour'. Les valeurs minimale et maximale de la plage # s\u00e9par\u00e9es par des virgules doivent \u00eatre fournies lors de l'utilisation du bouton analogique. #analog_range_up_pin: # La plage de r\u00e9sistances du bouton 'haut'. Les valeurs minimale et maximale de la plage # s\u00e9par\u00e9es par des virgules doivent \u00eatre fournies lors de l'utilisation du bouton analogique. #analog_range_down_pin: # La plage de r\u00e9sistances du bouton 'bas'. Les valeurs minimale et maximale de la plage # s\u00e9par\u00e9es par des virgules doivent \u00eatre fournies lors de l'utilisation du bouton analogique. #analog_range_kill_pin: # La plage de r\u00e9sistances du bouton 'kill'. Les valeurs minimale et maximale de la plage # s\u00e9par\u00e9es par des virgules doivent \u00eatre fournies lors de l'utilisation du bouton analogique. \u00e9cran hd44780 \u00b6 Informations de configuration des \u00e9crans hd44780 (utilis\u00e9s dans les \u00e9crans de type \"RepRapDiscount 2004 Smart Controller\"). [display] lcd_type: hd44780 # D\u00e9finir \u00e0 \"hd44780\" pour les \u00e9crans hd44780. rs_pin: e_pin: d4_pin: d5_pin: d6_pin: d7_pin: # Broches connect\u00e9es \u00e0 un lcd de type hd44780. Ces param\u00e8tres doivent # \u00eatre fournis. #hd44780_protocol_init: True # Effectuer l'initialisation du protocole 8-bit/4-bit sur un \u00e9cran hd44780. # Ceci est n\u00e9cessaire sur les vrais dispositifs hd44780. Cependant, on peut avoir besoin # de le d\u00e9sactiver avec certains p\u00e9riph\u00e9riques \"clones\". La valeur par d\u00e9faut est True. #line_length: # D\u00e9finit le nombre de caract\u00e8res par ligne pour un lcd de type hd44780. # Les valeurs possibles sont 20 (par d\u00e9faut) et 16. Le nombre de lignes est # fix\u00e9 \u00e0 4. ... \u00e9cran hd44780_spi \u00b6 Informations de configuration d'un \u00e9cran hd44780_spi - un \u00e9cran 20x04 contr\u00f4l\u00e9 par un \"registre \u00e0 d\u00e9calage (shift register)\" mat\u00e9riel (utilis\u00e9 dans les imprimantes bas\u00e9es sur mightyboard). [display] lcd_type: hd44780_spi # D\u00e9finir \u00e0 \"hd44780_spi\" pour les \u00e9crans hd44780_spi. latch_pin: spi_software_sclk_pin: spi_software_mosi_pin: spi_software_miso_pin: # Broches connect\u00e9es au registre \u00e0 d\u00e9calage contr\u00f4lant l'affichage. # La broche spi_software_miso_pin doit \u00eatre d\u00e9finie sur une broche inutilis\u00e9e # de la carte m\u00e8re de l'imprimante, car le registre \u00e0 d\u00e9calage contr\u00f4lant l'affichage # n'a pas de broche MISO, mais l'impl\u00e9mentation logicielle de spi n\u00e9cessite que # cette broche soit configur\u00e9e. #hd44780_protocol_init: True # Effectue l'initialisation du protocole 8-bit/4-bit sur un \u00e9cran hd44780. # Ceci est n\u00e9cessaire sur les vrais dispositifs hd44780. Cependant, on peut avoir besoin # de le d\u00e9sactiver avec certains p\u00e9riph\u00e9riques \"clones\". La valeur par d\u00e9faut est True. #line_length: # D\u00e9finit le nombre de caract\u00e8res par ligne pour un lcd de type hd44780. # Les valeurs possibles sont 20 (par d\u00e9faut) et 16. Le nombre de lignes est # fix\u00e9 \u00e0 4. ... \u00e9cran st7920 \u00b6 Informations de configuration des \u00e9crans st7920 (utilis\u00e9s dans les \u00e9crans de type \"RepRapDiscount 12864 Full Graphic Smart Controller\"). [display] lcd_type: st7920 # D\u00e9finir \u00e0 \"st7920\" pour les \u00e9crans st7920. cs_pin: sclk_pin: sid_pin: # Les broches connect\u00e9es \u00e0 un lcd de type st7920. Ces param\u00e8tres doivent \u00eatre # fournis. ... \u00e9cran emulated_st7920 \u00b6 Informations de configuration d'un \u00e9cran st7920 \u00e9mul\u00e9 - que l'on trouve dans certains \"\u00e9crans tactiles de 2,4 pouces\" et similaires. [display] lcd_type: emulated_st7920 # D\u00e9finir \u00e0 \"emulated_st7920\" pour les \u00e9crans emulated_st7920. en_pin: spi_software_sclk_pin: spi_software_mosi_pin: spi_software_miso_pin: # Les broches connect\u00e9es \u00e0 un lcd de type emulated_st7920. L'en_pin # correspond \u00e0 la cs_pin du lcd de type st7920, # spi_software_sclk_pin correspond \u00e0 sclk_pin et # spi_software_mosi_pin correspond \u00e0 sid_pin. La broche # spi_software_miso_pin doit \u00eatre r\u00e9gl\u00e9e sur une broche non utilis\u00e9e de la carte # m\u00e8re de l'imprimante car le st7920 n'a pas de broche MISO mais l'impl\u00e9mentation # logicielle spi n\u00e9cessite que cette broche soit configur\u00e9e. ... \u00e9cran uc1701 \u00b6 Informations de configuration des \u00e9crans uc1701 (utilis\u00e9s dans les \u00e9crans de type \"MKS Mini 12864\"). [display] lcd_type: uc1701 # D\u00e9finir \u00e0 \"uc1701\" pour les \u00e9crans uc1701. cs_pin: a0_pin: # Les broches connect\u00e9es \u00e0 un lcd de type uc1701. Ces param\u00e8tres doivent \u00eatre # fournis. #rst_pin: # La broche connect\u00e9e \u00e0 la broche \"rst\" du lcd. Si elle n'est pas sp\u00e9cifi\u00e9e, # le mat\u00e9riel doit avoir un pull-up sur la ligne lcd correspondante. #contrast: # Le contraste \u00e0 d\u00e9finir. La valeur peut aller de 0 \u00e0 63 , la valeur par # d\u00e9faut est 40. ... \u00e9crans ssd1306 et sh1106 \u00b6 Les informations de configuration des \u00e9crans ssd1306 et sh1106. [display] lcd_type: # D\u00e9finir \u00e0 \"ssd1306\" ou \"sh1106\" pour le type d'affichage donn\u00e9. #i2c_mcu: #i2c_bus: #i2c_speed: # Param\u00e8tres optionnels disponibles pour des \u00e9crans connect\u00e9s via un bus i2c. # Voir la section \"Param\u00e8tres I2C communs\" pour une description des # param\u00e8tres ci-dessus. #cs_pin: #dc_pin: #spi_speed: #spi_bus: #spi_software_sclk_pin: #spi_software_mosi_pin: #spi_software_miso_pin: # Les broches connect\u00e9es au lcd en mode spi \"4-wire\". Voir la section # \"param\u00e8tres SPI communs\" pour une description des param\u00e8tres # commen\u00e7ant par \"spi_\". Le d\u00e9faut est d'utiliser le mode i2c pour l'\u00e9cran # d'affichage. #reset_pin: # Une broche de r\u00e9initialisation peut \u00eatre sp\u00e9cifi\u00e9e sur l'affichage. Si elle # n'est pas sp\u00e9cifi\u00e9e, le mat\u00e9riel doit avoir un pull-up sur la ligne # lcd correspondante. #contrast: # Le contraste \u00e0 d\u00e9finir. La valeur peut aller de 0 \u00e0 256 , la valeur par # d\u00e9faut est 239. #vcomh: 0 # D\u00e9finit la valeur Vcomh sur l'\u00e9cran. Cette valeur est associ\u00e9e \u00e0 un effet # de \"bavure\" sur certains \u00e9crans OLED. La valeur peut \u00eatre comprise # de 0 \u00e0 63. La valeur par d\u00e9faut est 0. #invert: False # TRUE inverse les pixels sur certains \u00e9crans OLED. La valeur par d\u00e9faut est # False. #x_offset: 0 # D\u00e9finit la valeur du d\u00e9calage horizontal sur les \u00e9crans SH1106. La valeur par # d\u00e9faut est 0. ... [display_data] \u00b6 Support pour l'affichage de donn\u00e9es personnalis\u00e9es sur un \u00e9cran lcd. On peut cr\u00e9er un nombre quelconque de groupes d'affichage et un nombre quelconque d'\u00e9l\u00e9ments de donn\u00e9es sous ces groupes. L'\u00e9cran affichera tous les \u00e9l\u00e9ments de donn\u00e9es d'un groupe donn\u00e9 si l'option display_group de la section [display] est d\u00e9finie sur le nom du groupe en question. Un ensemble par d\u00e9faut de groupes d'affichage est automatiquement cr\u00e9\u00e9. On peut remplacer ou \u00e9tendre ces \u00e9l\u00e9ments display_data en rempla\u00e7ant les valeurs par d\u00e9faut dans le fichier de configuration principal printer.cfg. [display_data my_group_name my_data_name] position: # Ligne et colonne s\u00e9par\u00e9es par des virgules de la position de l'affichage \u00e0 # utiliser pour afficher l'information. Ce param\u00e8tre doit \u00eatre fourni. text: # Le texte \u00e0 afficher \u00e0 la position donn\u00e9e. Ce champ est \u00e9valu\u00e9 en utilisant les # mod\u00e8les de commande (voir docs/Command_Templates.md). # Ce param\u00e8tre doit \u00eatre fourni. [display_template] \u00b6 Les \"macros\" de texte des donn\u00e9es d'affichage (on peut d\u00e9finir un nombre quelconque de sections avec un pr\u00e9fixe display_template). Voir le document mod\u00e8les de commande pour des informations sur l'\u00e9valuation des mod\u00e8les. Cette fonctionnalit\u00e9 permet de r\u00e9duire les d\u00e9finitions r\u00e9p\u00e9titives dans les sections display_data. On peut utiliser la fonction int\u00e9gr\u00e9e render() dans les sections display_data pour \u00e9valuer un mod\u00e8le. Par exemple, si l'on d\u00e9finit \"[display_template my_template] \", on peut alors utiliser \"{ render('my_template') } dans une section display_data. Cette fonctionnalit\u00e9 peut \u00e9galement \u00eatre utilis\u00e9e pour des mises \u00e0 jour continues des LEDs \u00e0 l'aide de la commande SET_LED_TEMPLATE . [display_template my_template_name] #param_<name>: # On peut sp\u00e9cifier un nombre quelconque d'options avec le pr\u00e9fixe \"param_\". Le nom # donn\u00e9 se verra attribuer la valeur donn\u00e9e (analys\u00e9e comme un litt\u00e9ral Python) et # sera disponible pendant l'expansion de la macro. Si le param\u00e8tre est pass\u00e9 dans # l'appel \u00e0 render(), alors cette valeur sera utilis\u00e9e pendant l'expansion de la macro. # Par exemple, une configuration avec \"param_speed = 75\" pourrait avoir un appelant # avec \"render('my_template_name', param_speed=80)\". Les noms de param\u00e8tres # peuvent ne pas utiliser de caract\u00e8res majuscules. text: # Le texte \u00e0 renvoyer lors du rendu de ce mod\u00e8le. Ce champ est \u00e9valu\u00e9 \u00e0 l'aide de # mod\u00e8les de commande (voir docs/Command_Templates.md). # Ce param\u00e8tre doit \u00eatre fourni. [display_glyph] \u00b6 Affiche un glyphe personnalis\u00e9 sur les \u00e9crans le supportant. Le nom donn\u00e9 se verra attribu\u00e9 les donn\u00e9es d'affichage, donn\u00e9es qui pourront ensuite \u00eatre r\u00e9f\u00e9renc\u00e9es dans les mod\u00e8les d'affichage par leur nom entour\u00e9 de deux symboles \"tilde\", par exemple ~my_display_glyph~ Voir sample-glyphs.cfg pour quelques exemples. [display_glyph my_display_glyph] #data: # Les donn\u00e9es d'affichage, stock\u00e9es sous forme de 16 lignes compos\u00e9es de 16 bits (1 par # pixel) o\u00f9 '.' est un pixel vide et '*' est un pixel actif (par ex, \"****************\" pour afficher # une ligne horizontale pleine). # On peut \u00e9galement utiliser '0' pour un pixel vide et '1' pour un pixel actif. # Placez chaque ligne d'affichage sur une ligne de configuration distincte. Le glyphe doit \u00eatre # compos\u00e9 d'exactement 16 lignes de 16 bits chacune. Ce param\u00e8tre est facultatif. #hd44780_data: # Glyphe \u00e0 utiliser sur les \u00e9crans 20x4 hd44780. Le glyphe doit \u00eatre compos\u00e9 d'exactement # 8 lignes de 5 bits chacune. Ce param\u00e8tre est facultatif. #hd44780_slot: # L'index mat\u00e9riel hd44780 (0..7) pour stocker le glyphe. Si plusieurs images distinctes # utilisent le m\u00eame slot, assurez-vous de n'utiliser qu'une seule de ces images dans un # \u00e9cran donn\u00e9. Ce param\u00e8tre est requis si hd44780_data est sp\u00e9cifi\u00e9. [display my_extra_display] \u00b6 Si une section principale [display] a \u00e9t\u00e9 d\u00e9finie dans printer.cfg comme indiqu\u00e9 ci-dessus, il est possible de d\u00e9finir plusieurs affichages auxiliaires. Notez que les affichages auxiliaires ne supportent pas actuellement la fonctionnalit\u00e9 de menus, ils ne supportent donc pas les options \"menu\" ou la configuration de boutons. [display my_extra_display] # Voir la section \"affichage\" (display) pour les param\u00e8tres disponibles. [menu] \u00b6 Menus de l'\u00e9cran LCD personnalisables. Un ensemble de menus par d\u00e9faut est automatiquement cr\u00e9\u00e9. On peut remplacer ou \u00e9tendre le menu en rempla\u00e7ant les valeurs par d\u00e9faut dans le fichier de configuration principal printer.cfg. Consultez le document sur les mod\u00e8les de commande pour obtenir des informations sur les attributs de menu disponibles lors du rendu du mod\u00e8le. # Param\u00e8tres communs disponibles pour toutes les sections de configuration de menu. #[menu __some_list __some_name] #type: disabled # \u00c9l\u00e9ment de menu d\u00e9sactiv\u00e9 de fa\u00e7on permanente, le seul attribut requis est 'type'. # Vous permet de d\u00e9sactiver/masquer facilement des \u00e9l\u00e9ments de menu existants. #[menu some_name] #type: # Un \u00e9l\u00e9ment parmi command, input, list, text : # command - \u00e9l\u00e9ment de menu de base avec divers d\u00e9clencheurs de script. # input - m\u00eame chose que 'command' mais avec des capacit\u00e9s de changement de valeur. # Pressez pour d\u00e9marrer/arr\u00eater le mode d'\u00e9dition. # list - permet de regrouper les \u00e9l\u00e9ments du menu dans une liste d\u00e9roulante. # Ajoutez \u00e0 la liste en cr\u00e9ant des configurations de menu en utilisant # \"some_list\" comme pr\u00e9fixe - par exemple : # [menu some_list some_item_in_the_list]. # vsdlist - identique \u00e0 'list' mais ajoutera les fichiers de la carte SD virtuelle # (sera supprim\u00e9 dans le futur) #name: # Nom de l'\u00e9l\u00e9ment de menu - \u00e9valu\u00e9 comme un mod\u00e8le. #enable: # Mod\u00e8le \u00e9valu\u00e9 \u00e0 True ou False. #index: # Position o\u00f9 l'\u00e9l\u00e9ment doit \u00eatre ins\u00e9r\u00e9 dans la liste. Par d\u00e9faut # l'\u00e9l\u00e9ment est ajout\u00e9 \u00e0 la fin. #[menu some_list] #type: list #name: #enable: # Voir ci-dessus pour une description de ces param\u00e8tres. #[menu some_list some_command] #type: command #name: #enable: # Voir ci-dessus pour une description de ces param\u00e8tres. #gcode: # Script \u00e0 ex\u00e9cuter lors d'un clic sur un bouton ou un clic long. \u00c9valu\u00e9 comme un # mod\u00e8le. #[menu some_list some_input] #type: input #name: #enable: # Voir ci-dessus pour une description de ces param\u00e8tres. #input: # Valeur initiale \u00e0 utiliser lors de l'\u00e9dition - \u00e9valu\u00e9e comme un mod\u00e8le. # Le r\u00e9sultat doit \u00eatre de type flottant. #input_min: # Valeur minimale de l''intervalle - \u00e9valu\u00e9e comme un mod\u00e8le. Par d\u00e9faut -99999. #input_max: # Valeur maximale de l'intervalle - \u00e9valu\u00e9e comme un mod\u00e8le. Par d\u00e9faut 99999. #input_step: # Pas d'\u00e9dition - Doit \u00eatre un nombre entier positif ou une valeur flottante. Poss\u00e8de # un pas de vitesse rapide interne. Lorsque \"(input_max - input_min) / input_step > 100\" # alors le pas de vitesse rapide est 10 * input_step sinon le pas de vitesse rapide # est le m\u00eame que celui de l'input_step. #realtime: # Cet attribut accepte une valeur bool\u00e9enne statique. Lorsqu'il est activ\u00e9, alors le script # gcode est ex\u00e9cut\u00e9 apr\u00e8s chaque changement de valeur. La valeur par d\u00e9faut est False. #gcode: # Script \u00e0 ex\u00e9cuter lors d'un clic sur un bouton, d'un clic long ou d'un changement de valeur. # \u00c9valu\u00e9 comme un mod\u00e8le. Le clic sur le bouton d\u00e9clenchera le d\u00e9but ou fin du mode d'\u00e9dition. Capteurs de filaments \u00b6 [filament_switch_sensor] \u00b6 Capteur de commutation de filament. Prise en charge de la d\u00e9tection de l'insertion et du d\u00e9placement du filament \u00e0 l'aide d'un capteur de commutation, tel qu'un interrupteur de fin de course. Voir la r\u00e9f\u00e9rence des commandes pour plus d'informations. [filament_switch_sensor my_sensor] #pause_on_runout: True # Lorsque d\u00e9fini sur True, une PAUSE sera ex\u00e9cut\u00e9e imm\u00e9diatement apr\u00e8s qu'un runout # soit d\u00e9tect\u00e9. Notez que si pause_on_runout est False et que le runout_gcode est omis, # la d\u00e9tection du runout est d\u00e9sactiv\u00e9e. Par d\u00e9faut, est True. #runout_gcode: # Une liste de commandes G-Code \u00e0 ex\u00e9cuter apr\u00e8s la d\u00e9tection d'une fin de filament. # Voir docs/Command_Templates.md pour le format G-Code. Si pause_on_runout est # r\u00e9gl\u00e9 sur True, ce G-code sera ex\u00e9cut\u00e9 apr\u00e8s la fin de la PAUSE. Par d\u00e9faut, aucune # commande G-Code n'est ex\u00e9cut\u00e9e. #insert_gcode: # Une liste de commandes G-Code \u00e0 ex\u00e9cuter apr\u00e8s qu'une insertion de filament soit d\u00e9tect\u00e9e. # Voir docs/Command_Templates.md pour le format G-Code. La valeur par d\u00e9faut est de # n'ex\u00e9cuter aucune commande G-Code, ce qui d\u00e9sactive la d\u00e9tection de l'insertion. #event_delay 3.0 # La dur\u00e9e minimale en secondes \u00e0 attendre entre les \u00e9v\u00e9nements. # Des \u00e9v\u00e9nements d\u00e9clench\u00e9s durant cette p\u00e9riode seront silencieusement ignor\u00e9s. # La valeur par d\u00e9faut est de 3 secondes. #pause_delay: 0.5 # Le d\u00e9lai, en secondes, entre l'envoi de la commande de pause et l'ex\u00e9cution du runout_gcode. # Il peut \u00eatre utile d'augmenter ce d\u00e9lai si OctoPrint pr\u00e9sente un comportement \u00e9trange lors de # la pause. La valeur par d\u00e9faut est 0.5 secondes. #switch_pin: # La broche sur laquelle l'interrupteur est connect\u00e9. # Ce param\u00e8tre doit \u00eatre fourni. [filament_motion_sensor] \u00b6 Capteur de mouvement de filament. Prise en charge de la d\u00e9tection de pr\u00e9sence et d\u00e9placement du filament \u00e0 l'aide d'un encodeur basculant la broche de sortie pendant le mouvement du filament dans le capteur. Voir la r\u00e9f\u00e9rence des commandes pour plus d'informations. [filament_motion_sensor my_sensor] detection_length: 7.0 # La longueur minimale du filament tir\u00e9 \u00e0 travers le capteur d\u00e9clenchant # un changement d'\u00e9tat sur la broche de commutation. # La valeur par d\u00e9faut est 7 mm. extruder: # Le nom de la section de l'extrudeuse \u00e0 laquelle ce capteur est associ\u00e9. # Ce param\u00e8tre doit \u00eatre fourni. switch_pin: #pause_on_runout: #runout_gcode: #insert_gcode: #event_delay: #pause_delay: # Voir la section \"filament_switch_sensor\" pour une description des # param\u00e8tres ci-dessus. [tsl1401cl_filament_width_sensor] \u00b6 Capteur de largeur de filament bas\u00e9 sur le TSLl401CL. Voir ce guide pour plus d'informations. [tsl1401cl_filament_width_sensor] #pin: #default_nominal_filament_diameter: 1.75 # (mm) # Diff\u00e9rence maximale de diam\u00e8tre de filament autoris\u00e9e en mm. #max_diff\u00e9rence: 0.2 # La distance entre le capteur et la chambre de fusion en mm. #measurement_delay: 100 [hall_filament_width_sensor] \u00b6 Capteur Hall de largeur de filament (voir Capteur Hall de largeur de filament ). [hall_filament_width_sensor] adc1: adc2: # Broches d'entr\u00e9e analogiques connect\u00e9es au capteur. Ces param\u00e8tres doivent # \u00eatre fournis. #cal_dia1: 1.50 #cal_dia2: 2.00 # Les valeurs d'\u00e9talonnage (en mm) pour les capteurs. La valeur par d\u00e9faut est # 1,50 pour cal_dia1 et 2,00 pour cal_dia2. #raw_dia1: 9500 #raw_dia2: 10500 # Les valeurs brutes d'\u00e9talonnage des capteurs. La valeur par d\u00e9faut est 9500 # pour raw_dia1 et 10500 pour raw_dia2. #default_nominal_filament_diameter: 1.75 # Le diam\u00e8tre nominal du filament. Ce param\u00e8tre doit \u00eatre fourni. #max_difference: 0.200 # Diff\u00e9rence maximale autoris\u00e9e de diam\u00e8tre du filament en millim\u00e8tres (mm). # Si la diff\u00e9rence entre le diam\u00e8tre nominal du filament et la sortie du capteur # est sup\u00e9rieure \u00e0 +- max_difference, le multiplicateur d'extrusion est ramen\u00e9 \u00e0 # \u00e0 %100. La valeur par d\u00e9faut est de 0,200. #measurement_delay: 70 # La distance entre le capteur et la chambre de fusion/la buse en # millim\u00e8tres (mm). Le filament situ\u00e9 entre le capteur et la buse # sera trait\u00e9 comme le default_nominal_filament_diameter. # Ce module h\u00f4te fonctionne avec une logique FIFO. Il conserve chaque valeur # de capteur dans un tableau et les remet (POP) dans la bonne position. Ce # param\u00e8tre doit \u00eatre fourni. #enable: False # Capteur activ\u00e9 ou d\u00e9sactiv\u00e9 apr\u00e8s la mise sous tension. La valeur par d\u00e9faut est # d\u00e9sactiv\u00e9. #measurement_interval: 10 # La distance approximative (en mm) entre les lectures du capteur. La valeur # par d\u00e9faut est de 10mm. #logging: False # Le diam\u00e8tre de sortie vers le terminal et vers klipper.log peut \u00eatre activ\u00e9 par # ce param\u00e8tre. #min_diameter: 1.0 # Diam\u00e8tre minimal pour d\u00e9clencher le capteur virtuel filament_switch_sensor. #use_current_dia_while_delay: False # Utiliser le diam\u00e8tre actuel au lieu du diam\u00e8tre nominal pendant que le d\u00e9lai # de mesure n'est pas \u00e9coul\u00e9. #pause_on_runout: #runout_gcode: #insert_gcode: #event_delay: #pause_delay: # Voir la section \"filament_switch_sensor\" pour une description des # param\u00e8tres ci-dessus. Support mat\u00e9riel sp\u00e9cifique \u00e0 une carte \u00b6 [sx1509] \u00b6 Configuration d'un expandeur SX1509 I2C vers GPIO. En raison du d\u00e9lai encouru par la communication I2C, vous ne devez PAS utiliser les broches du SX1509 comme activation du moteur pas \u00e0 pas, pas ou direction ou toute autre broche n\u00e9cessitant un changement de bit rapide. Il est pr\u00e9f\u00e9rable de les utiliser comme sorties num\u00e9riques statiques ou contr\u00f4l\u00e9es par gcode ou comme broches hardware-pwm pour des ventilateurs par exemple. On peut d\u00e9finir un nombre quelconque de sections avec un pr\u00e9fixe \"sx1509\". Chaque expandeur fournit un ensemble de 16 broches (sx1509_my_sx1509:PIN_0 \u00e0 sx1509_my_sx1509:PIN_15) pouvant \u00eatre utilis\u00e9es dans la configuration de l'imprimante. Voir le fichier generic-duet2-duex.cfg pour un exemple. [sx1509 my_sx1509] i2c_address: # Adresse I2C utilis\u00e9e par cet expandeur. Selon le mat\u00e9riel # il s'agit de l'une des adresses suivantes : 62 63 112 113. # Ce param\u00e8tre doit \u00eatre fourni. #i2c_mcu: #i2c_bus: #i2c_speed: # Voir la section \"param\u00e8tres I2C communs\" pour une description des # param\u00e8tres ci-dessus. #i2c_bus: # Si l'impl\u00e9mentation I2C de votre micro-contr\u00f4leur prend en charge # plusieurs bus I2C, vous pouvez sp\u00e9cifier le nom du bus ici. La valeur # par d\u00e9faut est d'utiliser le bus i2c par d\u00e9faut du micro-contr\u00f4leur. [samd_sercom] \u00b6 Configuration de SAMD SERCOM pour indiquer les broches \u00e0 utiliser sur un mat\u00e9riel SERCOM. On peut d\u00e9finir un nombre quelconque de sections avec le pr\u00e9fixe \"samd_sercom\". Chaque SERCOM doit \u00eatre configur\u00e9 avant de pouvoir \u00eatre utilis\u00e9 comme p\u00e9riph\u00e9rique SPI ou I2C. Placez cette section de configuration au-dessus de toute autre section qui utilise les bus SPI ou I2C. [samd_sercom my_sercom] sercom: # Le nom du bus sercom \u00e0 configurer dans le micro-contr\u00f4leur. # Les noms disponibles sont \"sercom0\", \"sercom1\", etc. # Ce param\u00e8tredoit \u00eatre fourni. tx_pin: # Broche MOSI pour la communication SPI, ou broche SDA (donn\u00e9es) pour la communication I2C. # La broche doit avoir une configuration pinmux valide pour le p\u00e9riph\u00e9rique SERCOM donn\u00e9. # Ce param\u00e8tre doit \u00eatre fourni. #rx_pin: # Broche MISO pour la communication SPI. Cette broche n'est pas utilis\u00e9e pour la communication I2C # (I2C utilise tx_pin pour l'envoi et la r\u00e9ception). # La broche doit avoir une configuration pinmux valide pour le p\u00e9riph\u00e9rique SERCOM donn\u00e9. # Ce param\u00e8tre est optionnel. clk_pin: # La broche CLK pour la communication SPI, ou la broche SCL (horloge) pour la communication I2C. # La broche doit avoir une configuration pinmux valide pour le p\u00e9riph\u00e9rique SERCOM donn\u00e9. # Ce param\u00e8tre doit \u00eatre fourni [adc_scaled] \u00b6 Mise \u00e0 l'\u00e9chelle analogique du Duet2 Maestro par lectures vref et vssa. D\u00e9finir une section adc_scaled permet d'activer des broches adc virtuelles (telles que \"my_name:PB0\") qui seront automatiquement ajust\u00e9es par les broches de surveillance vref et vssa de la carte. Assurez-vous de d\u00e9finir cette section de configuration au-dessus de toute section de configuration utilisant l'une de ces broches virtuelles. Voir le fichier generic-duet2-maestro.cfg pour un exemple. [adc_scaled my_name] vref_pin : # La broche ADC \u00e0 utiliser pour le contr\u00f4le de VREF. Ce param\u00e8tre doit \u00eatre # fourni. vssa_pin : # La broche ADC \u00e0 utiliser pour la surveillance VSSA. Ce param\u00e8tre doit \u00eatre # fourni. #smooth_time : 2.0 # Une dur\u00e9e (en secondes) durant laquelle les mesures de vref et vssa # seront liss\u00e9es pour r\u00e9duire l'impact du bruit des mesures. # La valeur par d\u00e9faut est de 2 secondes. [replicape] \u00b6 Support de Replicape - voir le guide beaglebone et le fichier generic-replicape.cfg pour un exemple. # La section de configuration \"replicape\" ajoute \"replicape:stepper_x_enable\" pour # l'activation de broches virtuelles de moteur (pour les moteurs X, Y, Z, E et H) et # \"replicape:power_x\" des broches de sortie PWM (pour les pilotes, e, h, fan0, fan1, # fan2, et fan3) utilisables ailleurs dans le fichier de configuration. [replicape] revision: # La r\u00e9vision du mat\u00e9riel replicape. Actuellement, seule la r\u00e9vision \"B3\" est # support\u00e9e. Ce param\u00e8tre doit \u00eatre fourni. #enable_pin: !gpio0_20 # La broche d'activation globale de la replicape. La valeur par d\u00e9faut est !gpio0_20 # (aka P9_41). host_mcu : # Le nom de la section de configuration mcu communiquant avec la section de # l'instance mcu du \"processus linux\" de Klipper. Ce param\u00e8tre doit \u00eatre # fourni. #standstill_power_down: False # Ce param\u00e8tre contr\u00f4le la ligne CFG6_ENN sur tous les moteurs pas \u00e0 pas. # True r\u00e8gle les lignes d'activation sur \"ouvert\". La valeur par d\u00e9faut est # False. #stepper_x_microstep_mode: #stepper_y_microstep_mode: #stepper_z_microstep_mode: #stepper_e_microstep_mode: #stepper_h_microstep_mode: # Ce param\u00e8tre contr\u00f4le les broches CFG1 et CFG2 du pilote de moteur donn\u00e9. # Les options disponibles sont : disable, 1, 2, spread2, 4, 16, spread4, spread16, # stealth4, et stealth16. La valeur par d\u00e9faut est disable. #stepper_x_current: #stepper_y_current: #stepper_z_current: #stepper_e_current: #stepper_h_current: # Le courant maximum configur\u00e9 (en Amp\u00e8res) du moteur pas \u00e0 pas. # Ce param\u00e8tre doit \u00eatre fourni si le moteur pas \u00e0 pas n'est pas dans un # mode d\u00e9sactiv\u00e9. #stepper_x_chopper_off_time_high: #stepper_y_chopper_off_time_high: #stepper_z_chopper_off_time_high: #stepper_e_chopper_off_time_high: #stepper_h_chopper_off_time_high: # Ce param\u00e8tre contr\u00f4le la broche CFG0 du pilote du moteur pas \u00e0 pas. # (True place CFG0 en haut, False le place en bas). La valeur par d\u00e9faut est False. #stepper_x_chopper_hysteresis_high: #stepper_y_chopper_hysteresis_high: #stepper_z_chopper_hysteresis_high: #stepper_e_chopper_hysteresis_high: #stepper_h_chopper_hysteresis_high: # Ce param\u00e8tre contr\u00f4le la broche CFG4 du pilote du moteur pas \u00e0 pas. # (True place CFG4 en haut, False le place en bas). La valeur par d\u00e9faut est False. #stepper_x_chopper_blank_time_high: #stepper_y_chopper_blank_time_high: #stepper_z_chopper_blank_time_high: #stepper_e_chopper_blank_time_high: #stepper_h_chopper_blank_time_high: # Ce param\u00e8tre contr\u00f4le la broche CFG5 du pilote du moteur pas \u00e0 pas. # (True place CFG5 en haut, False le place en bas). La valeur par d\u00e9faut est True. Autres modules sp\u00e9cifiques \u00b6 [palette2] \u00b6 Prise en charge des multimat\u00e9riaux de la Palette 2 - assure une int\u00e9gration plus \u00e9troite de la prise en charge des p\u00e9riph\u00e9riques de la Palette 2 en mode connect\u00e9. Ce module n\u00e9cessite \u00e9galement [virtual_sdcard] et [pause_resume] pour une fonctionnalit\u00e9 compl\u00e8te. Si vous utilisez ce module, n'utilisez pas le plugin Palette 2 pour Octoprint car ils entreront en conflit, et le module ne pourra pas s'initialiser correctement, ce qui fera \u00e9chouer votre impression. Si vous utilisez Octoprint et que vous diffusez du gcode sur le port s\u00e9rie au lieu d'imprimer \u00e0 partir de virtual_sd, alors supprimez M1 et M0 de Commandes de pause dans Param\u00e8tres > Connexion s\u00e9rie > Firmware & protocole \u00e9vitera d'avoir \u00e0 lancer l'impression sur la Palette 2 et de devoir lever la pause dans Octoprint pour que l'impression commence. [palette2] serial: # Le port s\u00e9rie \u00e0 connecter \u00e0 la Palette 2. #baud: 115200 # Le d\u00e9bit en bauds \u00e0 utiliser. La valeur par d\u00e9faut est 115200. #feedrate_splice: 0.8 # Le taux d'avance \u00e0 utiliser lors de l'\u00e9pissage, la valeur par d\u00e9faut est 0.8. #feedrate_normal: 1.0 # L'avance \u00e0 utiliser apr\u00e8s l'\u00e9pissage, la valeur par d\u00e9faut est 1.0. #auto_load_speed: 2 # Vitesse d'extrusion lors du chargement automatique, par d\u00e9faut 2 (mm/s). #auto_cancel_variation: 0.1 # Annulation automatique de l'impression lorsque la variation du ping est sup\u00e9rieure \u00e0 ce seuil. [angle] \u00b6 Prise en charge du capteur d'angle Hall magn\u00e9tique pour la lecture des mesures de l'angle de l'arbre du moteur pas \u00e0 pas \u00e0 l'aide des puces SPI a1333, as5047d ou tle5012b. Les mesures sont disponibles via le serveur API et l' outil d'analyse de mouvement . Voir la r\u00e9f\u00e9rence G-Code pour les commandes disponibles. [angle my_angle_sensor] sensor_type: # Le type de la puce du capteur magn\u00e9tique \u00e0 effet Hall. Les choix disponibles # sont \"a1333\", \"as5047d\" et \"tle5012b\". Ce param\u00e8tre doit \u00eatre sp\u00e9cifi\u00e9. #sample_period: 0.000400 # La p\u00e9riode de requ\u00eate (en secondes) \u00e0 utiliser lors des mesures. La valeur par # d\u00e9faut est de 0.000400 (ce qui correspond \u00e0 2500 \u00e9chantillons par seconde). #stepper: # Le nom du pilote moteur pas \u00e0 pas auquel le capteur d'angle est attach\u00e9 (ex, # \"stepper_x\"). La d\u00e9finition de cette valeur active un \u00e9talonnage d'angle. # Pour utiliser cette fonction, le paquet Python \"numpy\" doit \u00eatre install\u00e9. # Par d\u00e9faut, l'\u00e9talonnage d'angle n'est pas activ\u00e9 pour un capteur d'angle. cs_pin: # La broche d'activation SPI du capteur. Ce param\u00e8tre doit \u00eatre fourni. #spi_speed: #spi_bus: #spi_software_sclk_pin: #spi_software_mosi_pin: #spi_software_miso_pin: # Voir la section \"param\u00e8tres SPI communs\" pour une description des # param\u00e8tres ci-dessus. Param\u00e8tres communs aux bus \u00b6 Param\u00e8tres SPI communs \u00b6 Les param\u00e8tres suivants sont g\u00e9n\u00e9ralement disponibles pour les dispositifs utilisant un bus SPI. #spi_speed: # La vitesse SPI (en hz) \u00e0 utiliser lors de la communication avec le p\u00e9riph\u00e9rique. # La valeur par d\u00e9faut d\u00e9pend du type de p\u00e9riph\u00e9rique. #spi_bus: # Si le micro-contr\u00f4leur supporte plusieurs bus SPI alors on peut sp\u00e9cifier le nom # du bus du micro-contr\u00f4leur ici. La valeur par d\u00e9faut d\u00e9pend du type de # micro-contr\u00f4leur. #spi_software_sclk_pin: #spi_software_mosi_pin: #spi_software_miso_pin: # Sp\u00e9cifiez les param\u00e8tres ci-dessus pour utiliser le \"SPI logiciel\". Ce mode ne # n\u00e9cessite pas le support mat\u00e9riel du micro-contr\u00f4leur (typiquement n'importe # quelle broche d'usage g\u00e9n\u00e9ral peut \u00eatre utilis\u00e9e). La valeur par d\u00e9faut est de # ne pas utiliser le \"spi logiciel\". Param\u00e8tres I2C communs \u00b6 Les param\u00e8tres suivants sont g\u00e9n\u00e9ralement disponibles pour les dispositifs utilisant un bus I2C. Notez que le support actuel des micro-contr\u00f4leurs de Klipper pour i2c n'est g\u00e9n\u00e9ralement pas tol\u00e9rant au bruit sur la ligne. Des erreurs inattendues sur les fils i2c peuvent entra\u00eener une erreur d'ex\u00e9cution de Klipper. Le support de Klipper de r\u00e9cup\u00e9ration des erreurs varie selon le type de micro-contr\u00f4leur. Il est g\u00e9n\u00e9ralement recommand\u00e9 de n'utiliser que des dispositifs i2c se trouvant sur la m\u00eame carte de circuit imprim\u00e9 que le microcontr\u00f4leur. La plupart des impl\u00e9mentations de micro-contr\u00f4leurs Klipper ne supportent qu'une i2c_speed de 100000. Le micro-contr\u00f4leur Klipper \"linux\" supporte une vitesse de 400000, mais elle doit \u00eatre d\u00e9finie dans le syst\u00e8me d'exploitation sinon le param\u00e8tre i2c_speed est ignor\u00e9. Le micro-contr\u00f4leur Klipper \"rp2040\" supporte un taux de 400000 via le param\u00e8tre i2c_speed . Tous les autres micro-contr\u00f4leurs Klipper utilisent un taux de 100000 et ignorent le param\u00e8tre i2c_speed . #i2c_address: # L'adresse i2c du p\u00e9riph\u00e9rique. Elle doit \u00eatre sp\u00e9cifi\u00e9e sous la forme d'un nombre d\u00e9cimal # (pas en hexad\u00e9cimal). La valeur par d\u00e9faut d\u00e9pend du type de p\u00e9riph\u00e9rique. #i2c_mcu: # Le nom du micro-contr\u00f4leur auquel la puce est connect\u00e9e. # La valeur par d\u00e9faut est \"mcu\". #i2c_bus: # Si le micro-contr\u00f4leur supporte plusieurs bus I2C, on peut sp\u00e9cifier le bus du micro-contr\u00f4leur. # La valeur par d\u00e9faut d\u00e9pend du type de micro-contr\u00f4leur. #i2c_speed: # La vitesse I2C (en Hz) \u00e0 utiliser lors de la communication avec le p\u00e9riph\u00e9rique. # L'impl\u00e9mentation de Klipper pour la plupart des micro-contr\u00f4leurs est cod\u00e9e en dur \u00e0 100000, # modifier cette valeur n'a aucun effet. La valeur par d\u00e9faut est 100000.","title":"R\u00e9f\u00e9rence de configuration"},{"location":"Config_Reference.html#reference-de-configuration","text":"Ce document est la r\u00e9f\u00e9rence des options disponibles dans le fichier de configuration de Klipper. Les descriptions de ce document sont format\u00e9es de mani\u00e8re \u00e0 ce qu'il soit possible de les copier-coller dans un fichier de configuration d'imprimante. Consultez le document d'installation pour obtenir des informations sur la configuration de Klipper et le choix d'un fichier de configuration initial.","title":"R\u00e9f\u00e9rence de configuration"},{"location":"Config_Reference.html#configuration-du-microcontroleur","text":"","title":"Configuration du microcontr\u00f4leur"},{"location":"Config_Reference.html#format-du-nom-des-broches-du-microcontroleur","text":"De nombreuses options de configuration n\u00e9cessitent le nom d'une broche du micro-contr\u00f4leur. Klipper utilise les noms mat\u00e9riel pour ces broches - par exemple PA4 . Les noms des broches peuvent \u00eatre pr\u00e9c\u00e9d\u00e9s de ! pour indiquer qu'une polarit\u00e9 inverse doit \u00eatre utilis\u00e9e (par exemple, d\u00e9clencher sur le niveau bas au lieu du niveau haut). Les broches d'entr\u00e9e peuvent \u00eatre pr\u00e9c\u00e9d\u00e9es de ^ pour indiquer qu'une r\u00e9sistance pull-up mat\u00e9rielle doit \u00eatre activ\u00e9e pour cette broche. Si le micro-contr\u00f4leur supporte les r\u00e9sistances pull-down, une broche d'entr\u00e9e peut \u00e9galement \u00eatre pr\u00e9c\u00e9d\u00e9e de ~ . Notez que certaines sections de configuration peuvent \"cr\u00e9er\" des broches suppl\u00e9mentaires. Lorsque cela se produit, la section de configuration d\u00e9finissant ces broches doit \u00eatre r\u00e9pertori\u00e9e dans le fichier de configuration avant toute section utilisant celles-ci.","title":"Format du nom des broches du microcontr\u00f4leur"},{"location":"Config_Reference.html#mcu","text":"Configuration du microcontr\u00f4leur primaire. [mcu] serial: # Le port s\u00e9rie \u00e0 connecter \u00e0 l'unit\u00e9 MCU. Si vous n'\u00eates pas s\u00fbr (ou s'il # change) consultez la section \"O\u00f9 est mon port s\u00e9rie ?\" de la FAQ. # Ce param\u00e8tre doit \u00eatre fourni lors de l'utilisation d'un port s\u00e9rie. #baud: 250000 # Le d\u00e9bit en bauds \u00e0 utiliser. La valeur par d\u00e9faut est 250000. #canbus_uuid: # Si vous utilisez un dispositif connect\u00e9 \u00e0 un bus CAN, ceci d\u00e9finit l'identifiant # unique de la puce \u00e0 laquelle se connecter. Cette valeur doit \u00eatre fournie lorsque l'on utilise # le bus CAN pour la communication. #canbus_interface: # Si vous utilisez un dispositif connect\u00e9 \u00e0 un bus CAN, ceci d\u00e9finit l'interface r\u00e9seau CAN # \u00e0 utiliser. La valeur par d\u00e9faut est 'can0'. #restart_method: # Ceci contr\u00f4le le m\u00e9canisme que l'h\u00f4te utilisera pour r\u00e9initialiser le microcontr\u00f4leur. # Les choix sont 'arduino', 'cheetah', 'rpi_usb', et 'command'. La m\u00e9thode 'arduino' # (basculer DTR) est courante sur les cartes et clones Arduino. # La m\u00e9thode 'cheetah' est une m\u00e9thode particuli\u00e8re n\u00e9cessaire pour certaines cartes # Fysetc Cheetah. La m\u00e9thode 'rpi_usb' est utile sur les cartes Raspberry Pi avec des # micro-contr\u00f4leurs aliment\u00e9s par USB - elle d\u00e9sactive bri\u00e8vement l'alimentation de tous # les ports USB pour effectuer une r\u00e9initialisation du microcontr\u00f4leur. # La m\u00e9thode 'command' implique l'envoi d'une commande Klipper au microcontr\u00f4leur # afin qu'il puisse # se r\u00e9initialiser. # La valeur par d\u00e9faut est 'arduino' si le micro-contr\u00f4leur communique via un port s\u00e9rie, # 'command' sinon.","title":"[mcu|"},{"location":"Config_Reference.html#mcu-my_extra_mcu","text":"Microcontr\u00f4leurs suppl\u00e9mentaires (on peut d\u00e9finir un nombre quelconque de sections avec un pr\u00e9fixe \"mcu\"). Les microcontr\u00f4leurs suppl\u00e9mentaires introduisent des broches additionnelles pouvant \u00eatre configur\u00e9es comme des \u00e9l\u00e9ments de chauffage, des pilotes moteurs, des ventilateurs, etc. Par exemple, si une section \"[mcu extra_mcu]\" est ajout\u00e9e, des broches telles que \"extra_mcu:ar9\" pourront \u00eatre utilis\u00e9es ailleurs dans la configuration (o\u00f9 \"ar9\" est un nom de broche mat\u00e9rielle ou un nom d'alias sur le mcu donn\u00e9). [mcu my_extra_mcu] # Voir la section \"mcu\" pour les param\u00e8tres de configuration.","title":"[mcu my_extra_mcu]"},{"location":"Config_Reference.html#parametres-cinematiques-courants","text":"","title":"Param\u00e8tres cin\u00e9matiques courants"},{"location":"Config_Reference.html#printer","text":"La section imprimante contr\u00f4le les param\u00e8tres de haut niveau de l'imprimante. [printer] kinematics: # Le type d'imprimante utilis\u00e9e. Cette option peut \u00eatre l'une des suivantes : cart\u00e9sienne, # corexy, corexz, hybrid_corexy, hybrid_corexz, rotary_delta, delta, deltesian, polar, winch, # ou none. Ce param\u00e8tre doit \u00eatre sp\u00e9cifi\u00e9. max_velocity: # Vitesse maximale (en mm/s) de la t\u00eate d'outil (par rapport \u00e0 l'impression). # Ce param\u00e8tre doit \u00eatre sp\u00e9cifi\u00e9. max_accel: # Acc\u00e9l\u00e9ration maximale (en mm/s^2) de la t\u00eate de l'outil (par rapport \u00e0 l'impression). # Ce param\u00e8tre doit \u00eatre sp\u00e9cifi\u00e9. #max_accel_to_decel: # Une pseudo-acc\u00e9l\u00e9ration (en mm/s^2) contr\u00f4lant la vitesse \u00e0 laquelle la t\u00eate de l'outil peut # passer de l'acc\u00e9l\u00e9ration \u00e0 la d\u00e9c\u00e9l\u00e9ration. Elle est utilis\u00e9e pour r\u00e9duire la vitesse maximale # des courts mouvements en zigzag (et donc r\u00e9duire les vibrations de l'imprimante dues \u00e0 ces # mouvements). La valeur par d\u00e9faut est la moiti\u00e9 de max_accel. #square_corner_velocity: 5.0 # La vitesse maximale (en mm/s) \u00e0 laquelle la t\u00eate d'outil peut parcourir un angle de 90 degr\u00e9s. # Une valeur non nulle peut r\u00e9duire les changements dans les d\u00e9bits de l'extrudeuse en # permettant des changements de vitesse instantan\u00e9s de la t\u00eate d'outil pendant les virages. # Cette valeur configure l'algorithme interne de prise de virage \u00e0 vitesse centrip\u00e8te ; les virages # dont l'angle est sup\u00e9rieur \u00e0 90 degr\u00e9s auront une vitesse de prise de virage plus \u00e9lev\u00e9e tandis # que ceux d'angles inf\u00e9rieurs \u00e0 90 degr\u00e9s auront une vitesse de virage plus faible. # Si ce param\u00e8tre est d\u00e9fini sur z\u00e9ro, la t\u00eate d'outil d\u00e9c\u00e9l\u00e9rera jusqu'\u00e0 z\u00e9ro \u00e0 chaque coin. # La valeur par d\u00e9faut est 5mm/s.","title":"[printer]"},{"location":"Config_Reference.html#stepper","text":"D\u00e9finitions des pilotes de moteurs pas \u00e0 pas. Diff\u00e9rents types d'imprimantes (comme sp\u00e9cifi\u00e9 par l'option \"kinematics\" dans la section [printer]) requi\u00e8rent diff\u00e9rents noms pour le moteur pas \u00e0 pas (par exemple, stepper_x vs stepper_a ). Ci-dessous, vous trouverez les d\u00e9finitions les plus courantes. Voir le document distance de rotation pour des informations sur le calcul du param\u00e8tre rotation_distance . Voir le document Multi-MCU homing pour des informations sur l'utilisation de plusieurs microcontr\u00f4leurs lors d'une mise \u00e0 l'origine. [stepper_x] step_pin: # Broche GPIO du moteur (d\u00e9clench\u00e9e \u00e0 l'\u00e9tat haut). Ce param\u00e8tre doit \u00eatre fourni. dir_pin: # Broche GPIO de direction (le niveau haut indique une direction positive). Ce param\u00e8tre # doit \u00eatre fourni. enable_pin: # Broche d'activation (par d\u00e9faut, enable est haut ; utilisez ! pour indiquer enable # bas). Si ce param\u00e8tre n'est pas fourni, le pilote du moteur pas \u00e0 pas doit toujours # \u00eatre activ\u00e9. rotation_distance: # Distance (en mm) parcourue par l'axe lors d'une rotation compl\u00e8te du moteur pas \u00e0 pas # (ou de l'engrenage final si le rapport de vitesse est sp\u00e9cifi\u00e9). # Ce param\u00e8tre doit \u00eatre fourni. microsteps: # Le nombre de micropas utilis\u00e9s par le pilote du moteur pas \u00e0 pas. Ce param\u00e8tre # doit \u00eatre fourni. #full_steps_per_rotation: 200 # Nombre de pas complets pour une rotation compl\u00e8te du moteur pas \u00e0 pas. # R\u00e9glez ce param\u00e8tre sur 200 pour un moteur pas \u00e0 pas de 1,8 degr\u00e9 ou sur 400 pour # un moteur de 0,9 degr\u00e9. La valeur par d\u00e9faut est 200. #gear_ratio: # Le rapport d'engrenage si le moteur pas \u00e0 pas est reli\u00e9 \u00e0 l'axe via une d\u00e9multiplication. # Par exemple, on peut sp\u00e9cifier \"5:1\" si un r\u00e9ducteur de 5 pour 1 est utilis\u00e9. # Si l'axe a plusieurs d\u00e9multiplications, on peut sp\u00e9cifier une liste de rapports s\u00e9par\u00e9s par # des virgules (par exemple, \"57:11, 2:1\"). Si un rapport de vitesse est sp\u00e9cifi\u00e9, alors # rotation_distance sp\u00e9cifie la distance parcourue par l'axe pour une rotation compl\u00e8te # de l'engrenage final. # La valeur par d\u00e9faut est de ne pas utiliser de rapport de vitesse. #step_pulse_duration: # Le temps minimum entre le front du signal d'impulsion de pas et le front du signal \"unstep\" suivant. # Ceci est \u00e9galement utilis\u00e9 pour d\u00e9finir le temps minimum entre une impulsion de pas et un signal # de changement de direction. # La valeur par d\u00e9faut est 0,000000100 (100ns) pour les pilotes TMC configur\u00e9s en mode UART ou SPI, # sinon la valeur par d\u00e9faut est de 0,000002 (2us) pour tous les autres pilotes. endstop_pin: # Broche de d\u00e9tection de l'interrupteur de fin de course. Si cette broche est sur un mcu diff\u00e9rent de # celui du moteur pas \u00e0 pas, cela active le \"multi-mcu\". Ce param\u00e8tre doit \u00eatre fourni pour les moteurs # pas \u00e0 pas X, Y, et Z sur les imprimantes de style cart\u00e9sien. #position_min: 0 # Distance minimale valide (en mm) vers laquelle l'utilisateur peut commander le moteur pas \u00e0 pas. # La valeur par d\u00e9faut est 0mm. position_endstop: # Emplacement de la but\u00e9e (en mm). Ce param\u00e8tre doit \u00eatre fourni pour les moteurs X, Y et Z # des imprimantes de style cart\u00e9sien. position_max: # Distance maximale valide (en mm) vers laquelle l'utilisateur peut ordonner au moteur de se d\u00e9placer. # Ce param\u00e8tre doit \u00eatre fourni pour les moteurs X, Y, et Z des imprimantes de type cart\u00e9sien. #homing_speed: 5.0 # Vitesse maximale (en mm/s) du moteur pas \u00e0 pas lors de la mise \u00e0 l'origine. La valeur par d\u00e9faut # est de 5mm/s. #homing_retract_dist: 5.0 # Distance de recul (en mm) avant le retour au point d'origine une seconde fois. # R\u00e9glez cette valeur \u00e0 z\u00e9ro pour d\u00e9sactiver le second retour \u00e0 l'origine. La valeur par d\u00e9faut # est de 5 mm. #homing_retract_speed: # Vitesse \u00e0 utiliser pour le mouvement de recul apr\u00e8s le retour \u00e0 l'origine au cas o\u00f9 elle soit # diff\u00e9rente de la vitesse de mise \u00e0 l'origine qui est la valeur par d\u00e9faut de ce param\u00e8tre. #second_homing_speed: # Vitesse (en mm/s) du moteur pas \u00e0 pas lors du second retour \u00e0 l'origine. # La valeur par d\u00e9faut est homing_speed/2. #homing_positive_dir: # Si la valeur est vraie (true), le retour au point d'origine entra\u00eenera le d\u00e9placement de la commande pas # \u00e0 pas dans une direction positive (en s'\u00e9loignant de z\u00e9ro) ; si elle est fausse (false), le retour \u00e0 l'origine # se fera vers z\u00e9ro. Il est pr\u00e9f\u00e9rable d'utiliser la valeur par d\u00e9faut que de sp\u00e9cifier ce param\u00e8tre. La valeur # par d\u00e9faut est true si position_endstop est proche de position_max et false si elle est proche de # la position_min.","title":"[stepper]"},{"location":"Config_Reference.html#cinematique-cartesienne","text":"Voir example-cartesian.cfg pour un exemple de fichier de configuration de cin\u00e9matique cart\u00e9sienne. Seuls les param\u00e8tres sp\u00e9cifiques aux imprimantes cart\u00e9siennes sont d\u00e9crits ici - voir param\u00e8tres cin\u00e9matiques communs pour les param\u00e8tres disponibles. [printer] kinematics: cartesian max_z_velocity: # Ceci d\u00e9finit la vitesse maximale (en mm/s) du mouvement le long de l'axe z # Ce param\u00e8tre peut \u00eatre utilis\u00e9 pour limiter la vitesse maximale du moteur pas \u00e0 pas z. # La valeur par d\u00e9faut est l'utilisation de max_velocity pour # max_z_velocity. max_z_accel: # Ce param\u00e8tre d\u00e9finit l'acc\u00e9l\u00e9ration maximale (en mm/s^2) du mouvement sur l'axe z. # Cela limite l'acc\u00e9l\u00e9ration du moteur pas \u00e0 pas z. La valeur par d\u00e9faut est # d'utiliser max_accel pour max_z_accel. # La section stepper_x est utilis\u00e9e pour d\u00e9crire le moteur pas \u00e0 pas contr\u00f4lant # l'axe X dans un robot cart\u00e9sien. [stepper_x] # La section stepper_y est utilis\u00e9e pour d\u00e9crire le moteur pas \u00e0 pas contr\u00f4lant # l'axe Y d'un robot cart\u00e9sien. [stepper_y] # La section stepper_z est utilis\u00e9e pour d\u00e9crire le moteur pas \u00e0 pas contr\u00f4lant # l'axe Z d'un robot cart\u00e9sien. [stepper_z]","title":"Cin\u00e9matique cart\u00e9sienne"},{"location":"Config_Reference.html#cinematique-delta-lineaire","text":"Voir example-delta.cfg pour un exemple de fichier de configuration de cin\u00e9matique delta lin\u00e9aire. Voir le guide de calibration delta pour des informations sur la calibration. Seuls les param\u00e8tres sp\u00e9cifiques aux imprimantes delta lin\u00e9aires sont d\u00e9crits ici - voir param\u00e8tres cin\u00e9matiques communs pour les param\u00e8tres disponibles. [printer] kinematics: delta max_z_velocity: # Pour les imprimantes delta, cela limite la vitesse maximale (en mm/s) des # mouvements de l'axe z. Ce param\u00e8tre peut \u00eatre utilis\u00e9 pour r\u00e9duire la # vitesse maximale des d\u00e9placements vers le haut/bas (n\u00e9cessitent une vitesse # de pas plus \u00e9lev\u00e9e que les autres mouvements sur une imprimante delta). La # valeur par d\u00e9faut est d'utiliser max_velocity pour max_z_velocity. #max_z_accel: # Ceci d\u00e9finit l'acc\u00e9l\u00e9ration maximale (en mm/s^2) du mouvement le long de l'axe z. # Ce param\u00e8tre peut \u00eatre utile si l'imprimante peut atteindre une plus grande # acc\u00e9l\u00e9ration sur les mouvements XY que sur les mouvements Z (par exemple, lors # de l'utilisation de la compensation de r\u00e9sonance). # La valeur par d\u00e9faut est d'utiliser max_accel pour max_z_accel. #minimum_z_position: 0 # Position Z minimale \u00e0 laquelle l'utilisateur peut ordonner \u00e0 la t\u00eate de se d\u00e9placer. # La valeur par d\u00e9faut est 0. delta_radius: # Rayon (en mm) du cercle horizontal form\u00e9 par les trois colonnes d'axe lin\u00e9aire. # Ce param\u00e8tre peut \u00e9galement \u00eatre calcul\u00e9 comme suit : # delta_radius = smooth_rod_offset - effector_offset - carriage_offset. # Ce param\u00e8tre doit \u00eatre fourni. #print_radius: # Le rayon (en mm) des coordonn\u00e9es XY valides de la t\u00eate d'extrusion. On peut utiliser # ce param\u00e8tre pour personnaliser la v\u00e9rification de la plage de mouvements de la t\u00eate. # Si une grande valeur est sp\u00e9cifi\u00e9e ici, il peut \u00eatre possible de faire entrer la t\u00eate en collision # avec une colonne. La valeur par d\u00e9faut est d'utiliser delta_radius pour print_radius (ce qui # emp\u00eachera normalement une collision avec une colonne). # La section stepper_a d\u00e9crit le moteur pas \u00e0 pas contr\u00f4lant la colonne avant gauche (\u00e0 210 # degr\u00e9s). Cette section contr\u00f4le \u00e9galement les param\u00e8tres de la mise \u00e0 l'origine # (homing_speed, homing_retract_dist) pour toutes les colonnes. [stepper_a] position_endstop: # Distance (en mm) entre la buse et le lit lorsque la buse se trouve au centre de la zone de # construction et que la fin de course se d\u00e9clenche. Ce param\u00e8tre doit \u00eatre fourni pour le # stepper_a ; pour les stepper_b et stepper_c, ce param\u00e8tre prend par d\u00e9faut la valeur # sp\u00e9cifi\u00e9e pour stepper_a. arm_length: # Longueur (en mm) du bras reliant cette colonne \u00e0 la t\u00eate d'impression. # Ce param\u00e8tre doit \u00eatre fourni pour stepper_a ; pour stepper_b et stepper_c, ce param\u00e8tre # prend par d\u00e9faut la valeur sp\u00e9cifi\u00e9e pour stepper_a. #angle: # Cette option sp\u00e9cifie l'angle (en degr\u00e9s) o\u00f9 se trouve positionn\u00e9e la colonne. # La valeur par d\u00e9faut est 210 pour stepper_a, 330 pour stepper_b, et 90 # pour stepper_c. # La section stepper_b d\u00e9crit le moteur pas \u00e0 pas contr\u00f4lant la colonne avant droite (\u00e0 330 degr\u00e9s). [stepper_b] # La section stepper_c d\u00e9crit le moteur pas \u00e0 pas contr\u00f4lant la colonne arri\u00e8re droite (\u00e0 90 degr\u00e9s). [stepper_c] # La section delta_calibrate active une commande G-code \u00e9tendue DELTA_CALIBRATE permettant # de calibrer la position des interrupteurs de fin de course ainsi que les angles des colonnes. [delta_calibrate] radius: # Rayon (en mm) de la zone palpable. Il s'agit du rayon des coordonn\u00e9es de la buse \u00e0 sonder ; si # vous utilisez un palpeur automatique avec un d\u00e9calage XY, choisissez un rayon suffisamment # petit pour que la sonde reste toujours au-dessus du lit. # Ce param\u00e8tre doit \u00eatre fourni. #speed: 50 # La vitesse (en mm/s) des mouvements sans palpage pendant l'\u00e9talonnage. # La valeur par d\u00e9faut est 50. #horizontal_move_z: 5 # La hauteur (en mm) \u00e0 laquelle la t\u00eate doit \u00eatre relev\u00e9e pour se d\u00e9placer # juste avant de lancer une op\u00e9ration de palpage. La valeur par d\u00e9faut est 5.","title":"Cin\u00e9matique Delta lin\u00e9aire"},{"location":"Config_Reference.html#cinematique-deltesienne","text":"Voir example-deltesian.cfg pour un exemple de fichier de configuration de cin\u00e9matique deltesienne. Seuls les param\u00e8tres sp\u00e9cifiques aux imprimantes deltesiennes sont d\u00e9crits ici - voir param\u00e8tres cin\u00e9matiques communs pour les param\u00e8tres disponibles. [printer] kinematics: deltesian max_z_velocity: # Pour les imprimantes deltesiennes, ceci limite la vitesse maximale (en mm/s) des # d\u00e9placements avec un mouvement sur l'axe z. Ce param\u00e8tre peut \u00eatre utilis\u00e9 pour # r\u00e9duire la vitesse maximale des d\u00e9placements vers le haut/bas (qui n\u00e9cessitent un # taux de pas plus \u00e9lev\u00e9 que les autres mouvements sur une imprimante deltesienne). # La valeur par d\u00e9faut est d'utiliser max_velocity pour max_z_velocity. #max_z_accel: # Ceci d\u00e9finit l'acc\u00e9l\u00e9ration maximale (en mm/s^2) du mouvement le long de l'axe z. # Ce param\u00e8tre peut \u00eatre utile si l'imprimante peut atteindre une plus grande # acc\u00e9l\u00e9ration sur les mouvements XY que sur les mouvements Z (par exemple, lors # de l'utilisation de la compensation de la r\u00e9sonance). # La valeur par d\u00e9faut est d'utiliser max_accel pour max_z_accel. #minimum_z_position : 0 # Position Z minimale \u00e0 laquelle l'utilisateur peut ordonner \u00e0 la t\u00eate de se d\u00e9placer. # La valeur par d\u00e9faut est 0. #min_angle: 5 # Ceci repr\u00e9sente l'angle minimum (en degr\u00e9s) par rapport \u00e0 l'horizontale que les bras # deltesiens sont autoris\u00e9s \u00e0 atteindre. Ce param\u00e8tre est destin\u00e9 \u00e0 emp\u00eacher les bras de # devenir compl\u00e8tement horizontaux, ce qui risquerait de provoquer une inversion # accidentelle de l'axe XZ. # La valeur par d\u00e9faut est 5. #print_width: # La distance (en mm) des coordonn\u00e9es X valides de la t\u00eate de l'outil. On peut utiliser ce # param\u00e8tre pour personnaliser la v\u00e9rification de la plage des mouvements de la t\u00eate de # l'outil. Si une grande valeur est sp\u00e9cifi\u00e9e ici, il peut \u00eatre possible de faire entrer la t\u00eate # de l'outil en collision avec une colonne. Ce param\u00e8tre correspond g\u00e9n\u00e9ralement \u00e0 la # largeur du banc (en mm). #slow_ratio: 3 # Rapport utilis\u00e9 pour limiter la vitesse et l'acc\u00e9l\u00e9ration des mouvements proches des # extr\u00eames de l'axe X. Si la distance verticale divis\u00e9e par la distance horizontale d\u00e9passe # la valeur de slow_ratio, la vitesse et l'acc\u00e9l\u00e9ration sont limit\u00e9es \u00e0 la moiti\u00e9 de leur valeur # nominale. Si la distance verticale divis\u00e9e par la distance horizontale d\u00e9passe de deux fois # la valeur de slow_ratio, alors la vitesse et l'acc\u00e9l\u00e9ration sont limit\u00e9es \u00e0 un quart de leur # valeur nominale. La valeur par d\u00e9faut est 3. # La section stepper_left est utilis\u00e9e pour d\u00e9crire le moteur pas \u00e0 pas contr\u00f4lant la colonne # gauche. Cette section contr\u00f4le \u00e9galement les param\u00e8tres d'orientation (homing_speed, # homing_retract_dist) pour toutes les colonnes. [stepper_left] position_endstop: # Distance (en mm) entre la buse et le lit lorsque la buse se trouve au centre de la zone de # construction. Ce param\u00e8tre doit \u00eatre fourni pour stepper_left ; pour le param\u00e8tre stepper_right # ce param\u00e8tre prend par d\u00e9faut la valeur sp\u00e9cifi\u00e9e pour stepper_left. arm_length: # Longueur (en mm) de la tige diagonale reliant le chariot de la colonne \u00e0 la t\u00eate d'impression. # Ce param\u00e8tre doit \u00eatre fourni pour stepper_left. Pour le param\u00e8tre stepper_right, ce param\u00e8tre # prend par d\u00e9faut la valeur sp\u00e9cifi\u00e9e pour stepper_left. arm_x_length: # Distance horizontale entre la t\u00eate d'impression et la colonne lorsque l'imprimante est mise \u00e0 # l'origine. Ce param\u00e8tre doit \u00eatre fourni pour stepper_left ; pour stepper_right, ce param\u00e8tre # prend par d\u00e9faut la valeur sp\u00e9cifi\u00e9e pour stepper_left. # La section stepper_right est utilis\u00e9e pour d\u00e9crire le moteur pas \u00e0 pas contr\u00f4lant la colonne de droite. [stepper_right] # La section stepper_y est utilis\u00e9e pour d\u00e9crire le moteur pas \u00e0 pas contr\u00f4lant l'axe Y d'un robot deltesien. [stepper_y]","title":"Cin\u00e9matique deltesienne"},{"location":"Config_Reference.html#cinematique-corexy","text":"Voir example-corexy.cfg pour un exemple de fichier cin\u00e9matique corexy (et h-bot). Seuls les param\u00e8tres sp\u00e9cifiques aux imprimantes corexy sont d\u00e9crits ici - voir param\u00e8tres cin\u00e9matiques communs pour les param\u00e8tres disponibles. [printer] kinematics: corexy max_z_velocity: # Ceci d\u00e9finit la vitesse maximale (en mm/s) du mouvement le long de l'axe z # Ce param\u00e8tre peut \u00eatre utilis\u00e9 pour limiter la vitesse maximale du moteur pas \u00e0 pas z. # La valeur par d\u00e9faut est l'utilisation de max_velocity pour max_z_velocity. max_z_accel: # Ce param\u00e8tre d\u00e9finit l'acc\u00e9l\u00e9ration maximale (en mm/s^2) du mouvement sur l'axe z. # Cela limite l'acc\u00e9l\u00e9ration du moteur pas \u00e0 pas z. La valeur par d\u00e9faut est # d'utiliser max_accel pour max_z_accel. # La section stepper_x est utilis\u00e9e pour d\u00e9crire l'axe X ainsi que le moteur pas \u00e0 pas # contr\u00f4lant le mouvement X+Y. [stepper_x] # La section stepper_y est utilis\u00e9e pour d\u00e9crire l'axe Y ainsi que le moteur pas \u00e0 pas # contr\u00f4lant le mouvement X-Y. [stepper_y] # La section stepper_z est utilis\u00e9e pour d\u00e9crire le moteur pas \u00e0 pas contr\u00f4lant l'axe Z. [stepper_z]","title":"Cin\u00e9matique CoreXY"},{"location":"Config_Reference.html#cinematique-corexz","text":"Voir example-corexz.cfg pour un exemple de fichier de configuration de cin\u00e9matique corexz. Seuls les param\u00e8tres sp\u00e9cifiques aux imprimantes corexz sont d\u00e9crits ici - voir param\u00e8tres cin\u00e9matiques communs pour les param\u00e8tres disponibles. [printer] kinematics: corexz max_z_velocity: # Ceci d\u00e9finit la vitesse maximale (en mm/s) du mouvement le long de l'axe z. # La valeur par d\u00e9faut est d'utiliser max_velocity pour max_z_velocity. max_z_accel: # Ceci d\u00e9finit l'acc\u00e9l\u00e9ration maximale (en mm/s^2) du mouvement le long de l'axe z. # La valeur par d\u00e9faut est d'utiliser max_accel pour max_z_accel. # La section stepper_x est utilis\u00e9e pour d\u00e9crire l'axe X ainsi que le moteur pas \u00e0 pas # contr\u00f4lant le mouvement X+Z. [stepper_x] # La section stepper_y est utilis\u00e9e pour d\u00e9crire le moteur pas \u00e0 pas contr\u00f4lant l'axe Y. [stepper_y] # La section stepper_z est utilis\u00e9e pour d\u00e9crire l'axe Z ainsi que le moteur pas \u00e0 pas # contr\u00f4lant le mouvement X-Z. [stepper_z]","title":"Cin\u00e9matique CoreXZ"},{"location":"Config_Reference.html#cinematique-hybride-corexy","text":"Voir example-hybrid-corexy.cfg pour un exemple de fichier de configuration de cin\u00e9matique hybride corexy. Cette cin\u00e9matique est \u00e9galement connue sous le nom de cin\u00e9matique Markforged. Seuls les param\u00e8tres sp\u00e9cifiques aux imprimantes hybrides corexy sont d\u00e9crits ici ; voir param\u00e8tres cin\u00e9matiques communs pour les param\u00e8tres disponibles. [printer] kinematics: hybrid_corexy max_z_velocity: # Ceci d\u00e9finit la vitesse maximale (en mm/s) du mouvement le long de l'axe z # La valeur par d\u00e9faut est d'utiliser max_velocity pour max_z_velocity. max_z_acce : # Ceci d\u00e9finit l'acc\u00e9l\u00e9ration maximale (en mm/s^2) du mouvement le long de l'axe z. # La valeur par d\u00e9faut est d'utiliser max_accel pour max_z_accel. # La section stepper_x est utilis\u00e9e pour d\u00e9crire l'axe X ainsi que le moteur pas \u00e0 pas # contr\u00f4lant le mouvement X-Y. [stepper_x] # La section stepper_y est utilis\u00e9e pour d\u00e9crire le moteur pas \u00e0 pas contr\u00f4lant # l'axe Y. [stepper_y] # La section stepper_z est utilis\u00e9e pour d\u00e9crire le moteur pas \u00e0 pas contr\u00f4lant # l'axe Z. [stepper_z]","title":"Cin\u00e9matique Hybride-CoreXY"},{"location":"Config_Reference.html#cinematique-hybride-corexz","text":"Voir example-hybrid-corexz.cfg pour un exemple de fichier de configuration de cin\u00e9matique hybride corexz. Cette cin\u00e9matique est \u00e9galement connue sous le nom de cin\u00e9matique Markforged. Seuls les param\u00e8tres sp\u00e9cifiques aux imprimantes hybrides corexy sont d\u00e9crits ici ; voir param\u00e8tres cin\u00e9matiques communs pour les param\u00e8tres disponibles. [printer] kinematics: hybrid_corexz max_z_velocity: # Ceci d\u00e9finit la vitesse maximale (en mm/s) du mouvement le long de l'axe z # La valeur par d\u00e9faut est d'utiliser max_velocity pour max_z_velocity. max_z_accel: # Ceci d\u00e9finit l'acc\u00e9l\u00e9ration maximale (en mm/s^2) du mouvement le long de # l'axe z. La valeur par d\u00e9faut est d'utiliser max_accel pour max_z_accel. # La section stepper_x est utilis\u00e9e pour d\u00e9crire l'axe X ainsi que le moteur pas \u00e0 pas # contr\u00f4lant le mouvement X-Z. [stepper_x] # La section stepper_y est utilis\u00e9e pour d\u00e9crire le moteur pas \u00e0 pas contr\u00f4lant # l'axe Y. [stepper_y] # La section stepper_z est utilis\u00e9e pour d\u00e9crire le moteur pas \u00e0 pas contr\u00f4lant # l'axe Z. [stepper_z]","title":"Cin\u00e9matique Hybride-CoreXZ"},{"location":"Config_Reference.html#cinematique-polaire","text":"Voir example-polar.cfg pour un exemple de fichier de configuration de cin\u00e9matique polaire. Seuls les param\u00e8tres sp\u00e9cifiques aux imprimantes polaires sont d\u00e9crits ici - voir param\u00e8tres cin\u00e9matiques communs pour les param\u00e8tres disponibles. LA CIN\u00c9MATIQUE POLAIRE EST UN TRAVAIL EN COURS. Les d\u00e9placements autour de la position 0, 0 sont connus pour ne pas fonctionner correctement. [printer] kinematics: polar max_z_velocity: # Ceci d\u00e9finit la vitesse maximale (en mm/s) du mouvement le long de l'axe z # Ce param\u00e8tre peut \u00eatre utilis\u00e9 pour limiter la vitesse maximale du moteur z. # La valeur par d\u00e9faut est d'utiliser max_velocity pour max_z_velocity. max_z_accel: # Ce param\u00e8tre d\u00e9finit l'acc\u00e9l\u00e9ration maximale (en mm/s^2) du mouvement sur l'axe z. # Cela limite l'acc\u00e9l\u00e9ration du moteur pas \u00e0 pas z. La valeur par d\u00e9faut est d'utiliser # max_accel pour max_z_accel. # La section stepper_bed est utilis\u00e9e pour d\u00e9crire le moteur pas \u00e0 pas contr\u00f4lant # le lit. [stepper_bed] gear_ratio: # Un rapport de vitesse doit \u00eatre sp\u00e9cifi\u00e9 et la distance de rotation ne peut pas \u00eatre # sp\u00e9cifi\u00e9e. Par exemple, si le lit est \u00e9quip\u00e9 d'une poulie \u00e0 80 dents entra\u00een\u00e9e par un # moteur dont l'axe est muni d'une poulie \u00e0 16 dents, il faut sp\u00e9cifier le rapport # d'engrenage de \"80:16\". Ce param\u00e8tre doit \u00eatre fourni. # La section stepper_arm est utilis\u00e9e pour d\u00e9crire le moteur pas \u00e0 pas contr\u00f4lant # le chariot sur le bras. [stepper_arm] # La section stepper_z permet de d\u00e9crire le moteur pas \u00e0 pas contr\u00f4lant l'axe Z. [stepper_z]","title":"Cin\u00e9matique polaire"},{"location":"Config_Reference.html#cinematique-rotative-delta","text":"Voir example-rotary-delta.cfg pour un exemple de fichier de configuration de cin\u00e9matique rotative delta. Seuls les param\u00e8tres sp\u00e9cifiques aux imprimantes rotatives delta sont d\u00e9crits ici - voir param\u00e8tres cin\u00e9matiques communs pour les param\u00e8tres disponibles. LA CIN\u00c9MATIQUE ROTATIVE DELTA EST UN TRAVAIL EN COURS. Les mouvements d'orientation peuvent d\u00e9passer le temps imparti et certains contr\u00f4les de limites ne sont pas impl\u00e9ment\u00e9s. [printer] kinematics: rotary_delta max_z_velocity: # Pour les imprimantes delta, ceci limite la vitesse maximale (en mm/s) des d\u00e9placements avec # mouvement de l'axe z. Ce param\u00e8tre peut \u00eatre utilis\u00e9 pour r\u00e9duire la vitesse maximale des # mouvements de mont\u00e9e/descente (n\u00e9cessitant un taux de pas plus \u00e9lev\u00e9 que les autres mouvements # sur une imprimante delta). La valeur par d\u00e9faut est d'utiliser max_velocity pour max_z_velocity. #minimum_z_position: 0 # La position Z minimale \u00e0 laquelle l'utilisateur peut ordonner \u00e0 la t\u00eate de se d\u00e9placer. # La valeur par d\u00e9faut est 0. shoulder_radius: # Rayon (en mm) du cercle horizontal form\u00e9 par les trois articulations de l'effecteur, moins le rayon # du cercle form\u00e9 par l'articulation de l'effecteur. # Ce param\u00e8tre peut \u00e9galement \u00eatre calcul\u00e9 comme suit # shoulder_radius = (delta_f - delta_e) / sqrt(12) # Ce param\u00e8tre doit \u00eatre fourni. shoulder_height: # Distance (en mm) des joints de l'effecteur par rapport au lit, moins la hauteur de la t\u00eate de l'outil # sur l'effecteur. Ce param\u00e8tre doit \u00eatre fourni. # La section stepper_a d\u00e9crit le moteur pas \u00e0 pas contr\u00f4lant le bras arri\u00e8re droit (\u00e0 30 degr\u00e9s). # Cette section contr\u00f4le \u00e9galement les param\u00e8tres de la mise \u00e0 l'origine (homing_speed, # homing_retract_dist) pour tous les bras. [stepper_a] gear_ratio: # Un rapport de vitesse doit \u00eatre sp\u00e9cifi\u00e9 et la rotation_distance ne peut pas \u00eatre sp\u00e9cifi\u00e9e. # Par exemple, si le bras a une poulie de 80 dents entra\u00een\u00e9e par une poulie de 16 dents, \u00e0 son # tour reli\u00e9e \u00e0 une poulie de 60 dents entra\u00een\u00e9e par un moteur dont l'arbre est muni d'une poulie # \u00e0 16 dents, alors on sp\u00e9cifierait un rapport de vitesse de \"80:16, 60:16\". # Ce param\u00e8tre doit \u00eatre fourni. position_endstop: # Distance (en mm) entre la buse et le lit lorsque la buse se trouve au centre de la zone de construction # et que la but\u00e9e se d\u00e9clenche. Ce param\u00e8tre doit \u00eatre fourni pour le stepper_a ; pour le stepper_b et # le stepper_c, ce param\u00e8tre prend par d\u00e9faut la valeur sp\u00e9cifi\u00e9e pour stepper_a. upper_arm_length: # Longueur (en mm) du bras reliant l'\"articulation de l'effecteur\" \u00e0 l'\"articulation du coude\". # Ce param\u00e8tre doit \u00eatre fourni pour stepper_a ; pour stepper_b et stepper_c, ce param\u00e8tre prend par # d\u00e9faut la valeur sp\u00e9cifi\u00e9e pour stepper_a. lower_arm_length: # Longueur (en mm) du bras reliant l'\"articulation du coude\" \u00e0 l'\"articulation de l'effecteur\". # Ce param\u00e8tre doit \u00eatre fourni pour stepper_a ; pour stepper_b et stepper_c, ce param\u00e8tre prend # par d\u00e9faut la valeur sp\u00e9cifi\u00e9e pour stepper_a. #angle: # Cette option sp\u00e9cifie l'angle (en degr\u00e9s) auquel se trouve le bras. # La valeur par d\u00e9faut est 30 pour stepper_a, 150 pour stepper_b et 270 pour stepper_c. # La section stepper_b d\u00e9crit le moteur pas \u00e0 pas contr\u00f4lant le bras arri\u00e8re gauche (\u00e0 150 degr\u00e9s). [stepper_b] # La section stepper_c d\u00e9crit le moteur pas \u00e0 pas contr\u00f4lant le bras avant (\u00e0 270 degr\u00e9s). [stepper_c] # La section delta_calibrate active une commande G-code \u00e9tendue DELTA_CALIBRATE permettant # de calibrer les positions de la but\u00e9e de l'effecteur. [delta_calibrate] radius: # Rayon (en mm) de la zone pouvant \u00eatre palp\u00e9e. Il s'agit du rayon des coordonn\u00e9es de palpage # de la buse; si vous utilisez un palpeur automatique avec un d\u00e9calage XY, choisissez un rayon # suffisamment petit pour que la sonde s'adapte toujours au lit. Ce param\u00e8tre doit \u00eatre fourni. #speed: 50 # La vitesse (en mm/s) des mouvements sans palpage pendant l'\u00e9talonnage. # La valeur par d\u00e9faut est 50. #horizontal_move_z: 5 # La hauteur (en mm) \u00e0 laquelle la t\u00eate doit \u00eatre remont\u00e9e pour se d\u00e9placer juste avant de lancer # une op\u00e9ration de palpage. La valeur par d\u00e9faut est 5.","title":"Cin\u00e9matique rotative delta"},{"location":"Config_Reference.html#cinematique-du-treuil-a-cable","text":"Voir le fichier example-winch.cfg pour un exemple de fichier de configuration cin\u00e9matique d'un treuil \u00e0 c\u00e2ble. Seuls les param\u00e8tres sp\u00e9cifiques aux imprimantes \u00e0 treuil sont d\u00e9crits ici - voir param\u00e8tres cin\u00e9matiques communs pour les param\u00e8tres disponibles. LE SUPPORT DU TREUIL \u00c0 C\u00c2BLE EST EXP\u00c9RIMENTAL. La mise \u00e0 l'origine n'est pas impl\u00e9ment\u00e9e dans la cin\u00e9matique du treuil \u00e0 c\u00e2ble. Pour ramener l'imprimante \u00e0 l'origine, envoyez des commandes manuelles de mouvements jusqu'\u00e0 ce que la t\u00eate de l'outil soit \u00e0 0, 0, 0, puis envoyez la commande G28 . [printer] kinematics: winch # La section stepper_a d\u00e9crit le moteur pas \u00e0 pas connect\u00e9 au premier treuil \u00e0 c\u00e2ble. # Un minimum de 3 et un maximum de 26 treuils \u00e0 c\u00e2ble peuvent \u00eatre d\u00e9finis # (stepper_a \u00e0 stepper_z) bien qu'il soit courant d'en d\u00e9finir 4. [stepper_a] rotation_distance: # La rotation_distance est la distance nominale (en mm) \u00e0 laquelle la t\u00eate de l'outil # se d\u00e9place vers le treuil de c\u00e2ble pour chaque rotation compl\u00e8te du moteur pas # \u00e0 pas. Ce param\u00e8tre doit \u00eatre fourni. anchor_x: anchor_y: anchor_z: # Les positions X, Y et Z du treuil \u00e0 c\u00e2ble dans l'espace cart\u00e9sien. # Ces param\u00e8tres doivent \u00eatre fournis.","title":"Cin\u00e9matique du treuil \u00e0 c\u00e2ble"},{"location":"Config_Reference.html#aucune-cinematique","text":"Il est possible de d\u00e9finir une cin\u00e9matique particuli\u00e8re \"aucune (none)\" pour d\u00e9sactiver le support cin\u00e9matique dans Klipper. Cela peut \u00eatre utile pour contr\u00f4ler des p\u00e9riph\u00e9riques qui ne sont pas des imprimantes 3D typiques ou encore \u00e0 des fins de d\u00e9bogage. [printer] kinematics: none max_velocity: 1 max_accel: 1 # Les param\u00e8tres max_velocity et max_accel doivent \u00eatre d\u00e9finis. Les # valeurs par d\u00e9faut ne sont pas utilis\u00e9es pour la cin\u00e9matique \"none\".","title":"Aucune cin\u00e9matique"},{"location":"Config_Reference.html#extrudeur-commun-et-support-du-lit-chauffant","text":"","title":"Extrudeur commun et support du lit chauffant"},{"location":"Config_Reference.html#extruder","text":"La section de l'extrudeuse est utilis\u00e9e pour d\u00e9crire les param\u00e8tres de chauffe de la buse ainsi que pour les commandes pas \u00e0 pas de l'extrudeuse. Voir la r\u00e9f\u00e9rence de commande pour plus d'informations. Voir le guide d'avance de pression pour des informations sur le r\u00e9glage de l'avance de pression. [extruder] step_pin: dir_pin: enable_pin: microsteps: rotation_distance: #full_steps_per_rotation: #gear_ratio: # Voir la section \"stepper\" pour une description des param\u00e8tres ci-dessus. # Si aucun des param\u00e8tres ci-dessus n'est sp\u00e9cifi\u00e9, alors aucun pilote ne # sera associ\u00e9 \u00e0 la buse (bien qu'une commande SYNC_EXTRUDER_MOTION # puisse en associer un au moment de l'ex\u00e9cution). nozzle_diameter: # Diam\u00e8tre de l'orifice de la buse (en mm). Ce param\u00e8tre doit \u00eatre # fourni. filament_diameter: # Diam\u00e8tre moyen du filament (en mm) lorsqu'il entre dans l'extrudeuse. # Ce param\u00e8tre doit \u00eatre fourni. #max_extrude_cross_section: # Surface maximale (en mm^2) d'une section transversale d'extrusion (ex: # largeur de l'extrusion multipli\u00e9e par la hauteur de la couche). Ce param\u00e8tre # permet d'\u00e9viter d'extruder des quantit\u00e9s excessives durant de petits d\u00e9placements # XY. Si un d\u00e9placement demande une quantit\u00e9 d'extrusion sup\u00e9rieure \u00e0 cette valeur, # une erreur sera renvoy\u00e9e. La valeur par d\u00e9faut est 4.0 *diam\u00e8tre_buse^2 #instantaneous_corner_velocity: 1.000 # La variation instantan\u00e9e maximale de la vitesse (en mm/s) de l'extrudeuse # pendant la jonction de deux mouvements. La valeur par d\u00e9faut est 1mm/s. #max_extrude_only_distance: 50.0 # Longueur maximale (en mm de filament) qu'un mouvement de r\u00e9traction ou d'extrusion # peut fournir. Si un mouvement de r\u00e9traction ou d'extrusion unique demande une # distance sup\u00e9rieure \u00e0 cette valeur, une erreur sera renvoy\u00e9e. # La valeur par d\u00e9faut est 50mm. #max_extrude_only_velocity: #max_extrude_only_accel: # Vitesse maximale (en mm/s) et acc\u00e9l\u00e9ration (en mm/s^2) du moteur de l'extrudeuse # pour les r\u00e9tractions et les mouvements d'extrusion seuls. Ces param\u00e8tres n'ont aucun # impact sur les mouvements d'impression normaux. S'ils ne sont pas sp\u00e9cifi\u00e9s, ils sont # calcul\u00e9s pour correspondre \u00e0 la limite d'un mouvement qu'une impression de # section transversale de 4.0*diam\u00e8tre_buse^2 aurait. #pressure_advance: 0.0 # La quantit\u00e9 de filament \u00e0 pousser dans l'extrudeuse durant l'acc\u00e9l\u00e9ration de celle-ci. # Une quantit\u00e9 \u00e9gale de filament est r\u00e9tract\u00e9e durant la d\u00e9c\u00e9l\u00e9ration. Elle est mesur\u00e9e # en millim\u00e8tre/seconde. La valeur par d\u00e9faut est 0, ce qui d\u00e9sactive la fonctionnalit\u00e9 # d'avance de pression. #pressure_advance_smooth_time: 0.040 # Une dur\u00e9e (en secondes) \u00e0 utiliser lors du calcul de la vitesse moyenne de l'extrudeuse # pour l'avance de pression. Une valeur plus grande donne lieu \u00e0 des mouvements # d'extrusion plus lisses. Ce param\u00e8tre ne doit pas d\u00e9passer 200ms. # Ce param\u00e8tre ne s'applique que si pressure_advance est diff\u00e9rent de z\u00e9ro. La valeur # par d\u00e9faut est 0.040 (40 millisecondes). # # Les variables restantes d\u00e9crivent la chauffe de l'extrudeuse. heater_pin: # Broche de sortie PWM contr\u00f4lant le chauffage. Ce param\u00e8tre doit \u00eatre # fourni. #max_power: 1.0 # La puissance maximale (exprim\u00e9e sous la forme d'une valeur comprise entre 0,0 et 1,0) # de r\u00e9glage du heater_pin . La valeur 1.0 permet \u00e0 la broche d'\u00eatre r\u00e9gl\u00e9e comme toujours # activ\u00e9e durant des p\u00e9riodes prolong\u00e9es, tandis qu'une valeur de 0,5 permet \u00e0 la broche # de n'\u00eatre activ\u00e9e durant au plus la moiti\u00e9 du temps. # Ce r\u00e9glage peut \u00eatre utilis\u00e9 pour limiter la puissance totale de sortie (sur de longues # p\u00e9riodes) de l'\u00e9l\u00e9ment de chauffe. La valeur par d\u00e9faut est 1.0. sensor_type: # Type de capteur - les thermistances courantes sont \"EPCOS 100K B57560G104F\", # \"ATC Semitec 104GT-2\", \"ATC Semitec 104NT-4-R025H42G\", \"Generic # 3950\", \"Honeywell 100K 135-104LAG-J01\", \"NTC 100K MGB18-104F39050L32\", # \"SliceEngineering 450\", et \"TDK NTCG104LH104JT1\". Voir la section \"Capteurs de # temp\u00e9rature\" pour d'autres capteurs. # Ce param\u00e8tre doit \u00eatre fourni. sensor_pin: # Broche d'entr\u00e9e analogique connect\u00e9e au capteur. Ce param\u00e8tre doit \u00eatre # fourni. #pullup_resistor: 4700 # La r\u00e9sistance (en ohms) du pullup reli\u00e9 \u00e0 la thermistance. # Ce param\u00e8tre n'est valable que si le capteur est une thermistance. La valeur par # d\u00e9faut est 4700 ohms. #smooth_time: 1.0 # Une dur\u00e9e (en secondes) sur laquelle les mesures de temp\u00e9rature seront # liss\u00e9es pour r\u00e9duire l'impact du bruit de la mesure. La valeur par d\u00e9faut # est de 1 seconde. control: # Algorithme de contr\u00f4le (soit pid, soit filigrane (watermark)). Ce param\u00e8tre doit # \u00eatre fourni. pid_Kp: pid_Ki: pid_Kd: # Les param\u00e8tres proportionnels (pid_Kp), int\u00e9graux (pid_Ki) et d\u00e9riv\u00e9s (pid_Kd) du syst\u00e8me de # contr\u00f4le de r\u00e9troaction PID. Klipper \u00e9value les param\u00e8tres PID avec la formule g\u00e9n\u00e9rale suivante : # heater_pwm = (Kp*erreur + Ki*int\u00e9grale(erreur) - Kd*d\u00e9riv\u00e9e(erreur)) / 255 # O\u00f9 \"erreur\" est le r\u00e9sultat de \"requested_temperature - measured_temperature\" et # \"heater_pwm\" est le taux de chauffage demand\u00e9, 0.0 \u00e9tant compl\u00e8tement \u00e9teint et 1.0 \u00e9tant # compl\u00e8tement allum\u00e9. Pensez \u00e0 utiliser la commande PID_CALIBRATE pour obtenir ces param\u00e8tres. # Les param\u00e8tres pid_Kp, pid_Ki, et pid_Kd doivent \u00eatre fournis pour les \u00e9l\u00e9ments de chauffe PID. #max_delta: 2.0 # Sur les \u00e9l\u00e9ments de chauffe contr\u00f4l\u00e9s par un filigrane (watermark), il s'agit du nombre de degr\u00e9s en # Celsius au-dessus de la temp\u00e9rature cible avant de d\u00e9sactiver le chauffage ainsi que le nombre de # degr\u00e9s en dessous de la temp\u00e9rature cible avant la r\u00e9activation du chauffage. La valeur par d\u00e9faut # est de 2 degr\u00e9s Celsius. #pwm_cycle_time: 0.100 # Dur\u00e9e en secondes de chaque cycle PWM logiciel du chauffage. Il n'est # pas recommand\u00e9 de d\u00e9finir cette valeur, sauf s'il existe une exigence # \u00e9lectrique pour commuter le chauffage plus rapidement que 10 fois par seconde. # La valeur par d\u00e9faut est 0,100 seconde. #min_extrude_temp: 170 # La temp\u00e9rature minimale (en Celsius) au-dessus de laquelle les commandes de d\u00e9placement de # l'extrudeuse peuvent \u00eatre \u00e9mises. La valeur par d\u00e9faut est 170 Celsius. min_temp: max_temp: # La plage maximale de temp\u00e9ratures valides (en Celsius) dans laquelle l'\u00e9l\u00e9ment de chauffe doit rester. # Ceci contr\u00f4le une fonction de s\u00e9curit\u00e9 impl\u00e9ment\u00e9e dans le code du micro-contr\u00f4leur - si la temp\u00e9rature # mesur\u00e9e sort de cette plage, le microcontr\u00f4leur se met en \u00e9tat d'arr\u00eat. # Ce contr\u00f4le peut aider \u00e0 d\u00e9tecter certaines d\u00e9faillances mat\u00e9rielles de l'\u00e9l\u00e9ment chauffant et/ou du capteur. # D\u00e9finissez cette plage suffisamment large pour que des temp\u00e9ratures raisonnables n'entra\u00eenent pas d'erreur. # Ces param\u00e8tres doivent \u00eatre fournis.","title":"[extruder]"},{"location":"Config_Reference.html#heater_bed","text":"La section heater_bed concerne le lit chauffant. Elle utilise les m\u00eames param\u00e8tres de mise en chauffe que ceux d\u00e9crits dans la section \"extrudeuse\". [heater_bed] heater_pin: sensor_type: sensor_pin: control: min_temp: max_temp: # Voir la section \"extruder\" pour une description des param\u00e8tres ci-dessus.","title":"[heater_bed]"},{"location":"Config_Reference.html#support-du-nivelage-du-lit","text":"","title":"Support du nivelage du lit"},{"location":"Config_Reference.html#bed_mesh","text":"Nivelage du maillage du lit. On peut d\u00e9finir une section de configuration bed_mesh pour activer les transformations de d\u00e9placement qui d\u00e9calent l'axe z en fonction d'un maillage g\u00e9n\u00e9r\u00e9 \u00e0 partir de points palp\u00e9s. Lorsqu'on utilise une sonde pour d\u00e9finir l'origine de l'axe z, il est recommand\u00e9 de d\u00e9finir une section safe_z_home dans printer.cfg pour r\u00e9aliser cette mise \u00e0 l'origine au centre de la zone d'impression. Consultez le guide du maillage du lit et la r\u00e9f\u00e9rence de la commande pour plus d'informations. Exemples visuels : lit rectangulaire, probe_count = 3, 3: x---x---x (max_point) | x---x---x | (min_point) x---x---x lit circulaire, round_probe_count = 5, bed_radius = r: x (0, r) fin / x---x---x \\ (-r, 0) x---x---x---x---x (r, 0) \\ x---x---x / x (0, -r) d\u00e9but [bed_mesh] #speed: 50 # La vitesse (en mm/s) des d\u00e9placements entre les points de palpage # durant l'\u00e9talonnage. # La valeur par d\u00e9faut est 50. #horizontal_move_z: 5 # La hauteur (en mm) \u00e0 laquelle la t\u00eate doit \u00eatre relev\u00e9e juste avant de # lancer une op\u00e9ration de palpage. La valeur par d\u00e9faut est 5. #mesh_radius: # D\u00e9finit le rayon de la maille \u00e0 palper pour les lits circulaires. Notez que # le rayon est relatif aux coordonn\u00e9es sp\u00e9cifi\u00e9es par l'option # mesh_origin. Ce param\u00e8tre doit \u00eatre fourni pour des lits circulaires # et omis pour des lits rectangulaires. #mesh_origin: # D\u00e9finit les coordonn\u00e9es X, Y du centre du maillage des lits circulaires. Ces # coordonn\u00e9es sont relatives \u00e0 l'emplacement de la sonde. Il peut \u00eatre utile # d'ajuster l'origine du maillage afin de maximiser la taille du rayon du maillage. # La valeur par d\u00e9faut est 0, 0. Ce param\u00e8tre doit \u00eatre omis pour des lits rectangulaires. #mesh_min: # D\u00e9finit les coordonn\u00e9es X, Y minimales du maillage pour les lits rectangulaires. # Ces coordonn\u00e9es sont relatives \u00e0 l'emplacement de la sonde. Cette position # sera le premier point sond\u00e9, le plus proche de l'origine. Ce param\u00e8tre doit # \u00eatre fourni pour des lits rectangulaires. #mesh_max: # D\u00e9finit les coordonn\u00e9es X, Y maximales du maillage pour les lits rectangulaires. # Le principe est le m\u00eame que pour mesh_min, mais ce sera le point le plus \u00e9loign\u00e9 # atteignable par rapport \u00e0 l'origine du lit. Ce param\u00e8tre doit \u00eatre fourni pour # des lits rectangulaires. #probe_count: 3, 3 # Pour les lits rectangulaires, il s'agit d'une paire d'entiers X, Y s\u00e9par\u00e9s par des virgules, # d\u00e9finissant le nombre de points \u00e0 palper le long de chaque axe. # Une valeur seule est \u00e9galement valide, auquel cas cette valeur sera appliqu\u00e9e aux # deux axes. La valeur par d\u00e9faut est 3, 3. #round_probe_count: 5 # Pour les lits circulaires, cette valeur enti\u00e8re d\u00e9finit le nombre maximum de points # \u00e0 palper le long de chaque axe. Cette valeur doit \u00eatre un nombre impair. # La valeur par d\u00e9faut est 5. #fade_start: 1.0 # La position z du gcode \u00e0 partir de laquelle il faut commencer \u00e0 \u00e9liminer progressivement # l'ajustement z lorsque la compensation est activ\u00e9e. La valeur par d\u00e9faut est 1.0. #fade_end: 0.0 # La position z du gcode \u00e0 partir de laquelle la compensation se termine. Lorsqu'elle est # d\u00e9finie \u00e0 une valeur inf\u00e9rieure \u00e0 fade_start, la compensation est d\u00e9sactiv\u00e9e. Notez que # la compensation peut ajouter une mise \u00e0 l'\u00e9chelle ind\u00e9sirable le long de l'axe z d'une impression. # Si un utilisateur souhaite activer la compensation, une valeur de 10.0 est recommand\u00e9e. # La valeur par d\u00e9faut est 0.0, ce qui d\u00e9sactive la compensation. #fade_target: # La position z vers laquelle la compensation doit converger. Lorsque cette valeur est # d\u00e9finie \u00e0 une valeur non nulle, elle doit se situer dans la plage des valeurs z du maillage. # Les utilisateurs qui souhaitent converger vers la position de mise \u00e0 l'origine du Z # doivent r\u00e9gler cette valeur \u00e0 0. # La valeur par d\u00e9faut est la valeur z moyenne du maillage. #split_delta_z: .025 # Le delta de diff\u00e9rence de Z (en mm) le long d'un mouvement qui d\u00e9clenchera une s\u00e9paration. # La valeur par d\u00e9faut est de 0,025. #move_check_distance: 5.0 # La distance (en mm) le long d'un mouvement pour v\u00e9rifier le split_delta_z. # C'est \u00e9galement la longueur minimale pour laquelle un mouvement peut \u00eatre divis\u00e9. # La valeur par d\u00e9faut est 5.0. #mesh_pps: 2, 2 # Une paire de nombres entiers X, Y s\u00e9par\u00e9s par des virgules, d\u00e9finissant le nombre de # points par segment \u00e0 interpoler dans le maillage le long de chaque axe. Un \"segment\" # \u00e9tant d\u00e9fini comme l'espace entre chaque point palp\u00e9. # L'utilisateur peut saisir une seule valeur qui sera appliqu\u00e9e aux deux axes. # La valeur par d\u00e9faut est 2, 2. #algorithme: lagrange # L'algorithme d'interpolation \u00e0 utiliser. Soit \"lagrange\", soit \"bicubic\". Cette option # n'affecte pas les grilles 3x3 forc\u00e9es d'utiliser l'\u00e9chantillonnage de lagrange. # La valeur par d\u00e9faut est lagrange. #bicubic_tension: .2 # Lors de l'utilisation de l'algorithme bicubic, le param\u00e8tre de tension ci-dessus peut # \u00eatre appliqu\u00e9 pour modifier la quantit\u00e9 de pente interpol\u00e9e. # Des nombres plus grands augmenteront la quantit\u00e9 de pente entra\u00eenant une plus grande # courbure du maillage. La valeur par d\u00e9faut est 0,2. #relative_reference_index: # Un index de points dans le maillage auquel r\u00e9f\u00e9rencer toutes les valeurs z. En activant # ce param\u00e8tre, on produit un maillage relatif \u00e0 la position z palp\u00e9e de l'indice fourni. #faulty_region_1_min: #faulty_region_1_max: # Points optionnels d\u00e9finissant une r\u00e9gion d\u00e9fectueuse. Voir docs/Bed_Mesh.md pour # plus de d\u00e9tails sur les r\u00e9gions d\u00e9fectueuses. Jusqu'\u00e0 99 r\u00e9gions d\u00e9fectueuses peuvent # \u00eatre ajout\u00e9es. # Par d\u00e9faut, aucune r\u00e9gion d\u00e9fectueuse n'est d\u00e9finie.","title":"[bed_mesh]"},{"location":"Config_Reference.html#bed_tilt","text":"Compensation de l'inclinaison du lit. On peut d\u00e9finir une section de configuration bed_tilt pour activer les transformations de d\u00e9placement tenant compte d'un lit inclin\u00e9. Notez que bed_mesh et bed_tilt sont incompatibles ; les deux ne peuvent pas \u00eatre d\u00e9finis en m\u00eame temps. Voir la r\u00e9f\u00e9rence des commandes pour plus d'informations. [bed_tilt] #x_adjust: 0 # Quantit\u00e9 \u00e0 ajouter \u00e0 la hauteur Z de chaque mouvement pour chaque mm sur l'axe X. # La valeur par d\u00e9faut est 0. #y_adjust: 0 # Quantit\u00e9 \u00e0 ajouter \u00e0 la hauteur Z de chaque mouvement pour chaque mm sur l'axe Y. # La valeur par d\u00e9faut est 0. #z_adjust: 0 # Quantit\u00e9 \u00e0 ajouter \u00e0 la hauteur Z lorsque la buse est nominalement \u00e0 0, 0. # La valeur par d\u00e9faut est 0. # Les param\u00e8tres suivants contr\u00f4lent la commande g-code \u00e9tendue BED_TILT_CALIBRATE # utilis\u00e9e pour calibrer les param\u00e8tres de r\u00e9glage x et y appropri\u00e9s. #points: # Une liste de coordonn\u00e9es X, Y (une par ligne ; les lignes suivantes indent\u00e9es) devant # \u00eatre palp\u00e9es pendant une commande BED_TILT_CALIBRATE # Sp\u00e9cifiez les coordonn\u00e9es de la buse et assurez-vous que la sonde est au-dessus du lit # aux coordonn\u00e9es donn\u00e9es de la buse. # La valeur par d\u00e9faut est de ne pas activer la commande. #speed: 50 # Vitesse (en mm/s) des mouvements de d\u00e9placements hors palpage pendant l'\u00e9talonnage. # La valeur par d\u00e9faut est 50. #horizontal_move_z: 5 # Hauteur (en mm) \u00e0 laquelle la t\u00eate doit \u00eatre relev\u00e9e lors du d\u00e9placement juste avant # de lancer une op\u00e9ration de palpage. La valeur par d\u00e9faut est 5.","title":"[bed_tilt]"},{"location":"Config_Reference.html#bed_screws","text":"Outil d'aide au r\u00e9glage des vis de nivellement du lit. On peut d\u00e9finir une section de configuration [bed_screws] pour activer une commande g-code BED_SCREWS_ADJUST. Consultez le guide de nivelage et la r\u00e9f\u00e9rence des commandes pour plus d'informations. [bed_screws] #screw1: # Coordonn\u00e9es X, Y de la premi\u00e8re vis de r\u00e9glage du niveau du lit. Il s'agit de la # position vers laquelle d\u00e9placer la buse afin qu'elle soit plac\u00e9e au-dessus de cette # vis de r\u00e9glage (ou aussi proche que possible tout en \u00e9tant au-dessus du lit). # Ce param\u00e8tre doit \u00eatre fourni. #screw1_name: # Un nom arbitraire pour la vis donn\u00e9e. Ce nom est affich\u00e9 lors de # l'ex\u00e9cution du script d'aide. Par d\u00e9faut, le nom utilis\u00e9 est bas\u00e9 sur # la position XY de la vis. #screw1_fine_adjust : # Coordonn\u00e9es X, Y pour commander la buse afin de pouvoir affiner le r\u00e9glage de la vis de mise # \u00e0 niveau du lit. Par d\u00e9faut, il n'y a pas de r\u00e9glage fin sur la vis de mise \u00e0 niveau du lit. #screw2: #screw2_name: #screw2_fine_adjust: #... # Vis suppl\u00e9mentaires de mise \u00e0 niveau du lit. Au moins trois vis doivent \u00eatre # d\u00e9finies. #horizontal_move_z: 5 # Hauteur (en mm) \u00e0 laquelle la t\u00eate doit \u00eatre relev\u00e9e pour se d\u00e9placer # lors du passage d'une vis \u00e0 la suivante. La valeur par d\u00e9faut est 5. #probe_height: 0 # Hauteur de la sonde (en mm) apr\u00e8s ajustement d\u00fb \u00e0 la dilatation thermique # du lit et de la buse. La valeur par d\u00e9faut est z\u00e9ro. #speed: 50 # Vitesse (en mm/s) des d\u00e9placements entre les palpages pendant l'\u00e9talonnage. # La valeur par d\u00e9faut est 50. #probe_speed: 5 # Vitesse (en mm/s) lors du d\u00e9placement d'une position horizontal_move_z # \u00e0 la position probe_height. La valeur par d\u00e9faut est 5.","title":"[bed_screws]"},{"location":"Config_Reference.html#screws_tilt_adjust","text":"Outil d'assistance au nivellement du lit avec les vis de r\u00e9glage et l'aide du palpeur Z. On peut d\u00e9finir une section de configuration screws_tilt_adjust pour activer une commande g-code SCREWS_TILT_CALCULATE. Voir le guide de nivelage et la r\u00e9f\u00e9rence des commandes pour des informations suppl\u00e9mentaires. [screws_tilt_adjust] #screw1: # Les coordonn\u00e9es (X, Y) de la premi\u00e8re vis de mise \u00e0 niveau du lit. Il s'agit d'une # position \u00e0 laquelle d\u00e9placer la buse de mani\u00e8re \u00e0 ce que la sonde soit directement # au-dessus de la vis de mise \u00e0 niveau du lit (ou aussi pr\u00e8s que possible tout en \u00e9tant # encore au-dessus du lit). Il s'agit de la vis de base utilis\u00e9e dans les calculs. # Ce param\u00e8tre doit \u00eatre fourni. #screw1_name: # Un nom arbitraire pour la vis donn\u00e9e. Ce nom est affich\u00e9 lorsque le script d'aide # s'ex\u00e9cute. Par d\u00e9faut, le nom utilis\u00e9 est bas\u00e9 sur la position XY de la vis. #screw2: #screw2_name: #... # Vis suppl\u00e9mentaires de mise \u00e0 niveau du lit. Au moins deux vis doivent \u00eatre # d\u00e9finies. #speed: 50 # La vitesse (en mm/s) des d\u00e9placements sans palpage pendant l'\u00e9talonnage. # La valeur par d\u00e9faut est 50. #horizontal_move_z: 5 # La hauteur (en mm) \u00e0 laquelle la t\u00eate doit \u00eatre lev\u00e9e pour se d\u00e9placer juste # avant de lancer une op\u00e9ration de palpage. La valeur par d\u00e9faut est 5. #screw_thread: CW-M3 # Le type de vis utilis\u00e9e pour le niveau du lit, M3, M4 ou M5 et la direction de la molette # utilis\u00e9e pour le nivelage du lit, diminution dans le sens des aiguilles d'une montre, # augmentation dans le sens inverse des aiguilles d'une montre. # Valeurs accept\u00e9es : CW-M3, CCW-M3, CW-M4, CCW-M4, CW-M5, CCW-M5. # La valeur par d\u00e9faut est CW-M3. De nombreuses imprimantes utilisent une vis M3, # un tour de molette dans le sens des aiguilles d'une montre diminue la distance.","title":"[screws_tilt_adjust]"},{"location":"Config_Reference.html#z_tilt","text":"R\u00e9glage multiples de l'inclinaison de moteurs pas \u00e0 pas de l'axe Z. Cette fonction permet d'ajuster de mani\u00e8re ind\u00e9pendante l'inclinaison de plusieurs moteurs Z (voir la section \"stepper_z1\"). Si cette section est pr\u00e9sente, une commande G-Code \u00e9tendue Z_TILT_ADJUST devient disponible. [z_tilt] #z_positions: # Une liste de coordonn\u00e9es X, Y (une par ligne ; les lignes subs\u00e9quentes # indent\u00e9es) d\u00e9crivant l'emplacement de chaque \"point de pivot\" du lit. # Le \"point de pivot\" est le point o\u00f9 le lit s'attache \u00e0 l'\u00e9l\u00e9ment Z # donn\u00e9. Il est d\u00e9crit \u00e0 l'aide des coordonn\u00e9es de la buse (la position X, Y # de la buse si elle pouvait se d\u00e9placer directement au-dessus du point). La # premi\u00e8re entr\u00e9e correspond \u00e0 stepper_z, la deuxi\u00e8me \u00e0 stepper_z1, # la troisi\u00e8me \u00e0 stepper_z2, etc. Ce param\u00e8tre doit \u00eatre fourni. #points: # Une liste de coordonn\u00e9es X, Y (une par ligne ; les lignes ult\u00e9rieures # indent\u00e9es) qui doivent \u00eatre palp\u00e9es pendant une commande Z_TILT_ADJUST. # Sp\u00e9cifiez les coordonn\u00e9es de la buse et assurez-vous que le palpeur est # au-dessus du lit aux coordonn\u00e9es donn\u00e9es de la buse. # Ce param\u00e8tre doit \u00eatre fourni. #speed: 50 # La vitesse (en mm/s) des mouvements de d\u00e9placements hors palpage # pendant l'\u00e9talonnage. La valeur par d\u00e9faut est 50. #horizontal_move_z: 5 # Hauteur (en mm) \u00e0 laquelle la t\u00eate doit \u00eatre relev\u00e9e pour se d\u00e9placer juste # avant de lancer une op\u00e9ration de palpage. La valeur par d\u00e9faut est 5. #retries: 0 # Nombre de tentatives \u00e0 effectuer si les points palp\u00e9s ne sont pas dans la # tol\u00e9rance. #retry_tolerance: 0 # Si les r\u00e9-essais sont activ\u00e9s, r\u00e9essayer si les points sond\u00e9s les plus grands et # les plus petits diff\u00e8rent plus que la tol\u00e9rance retry_tolerance. Notez que la # plus petite unit\u00e9 de changement ici serait un seul pas. Cependant, si vous # sondez plus de points que de moteurs, il est probable que vous aurez une # valeur minimale fixe pour la plage de points sond\u00e9s. Vous pouvez en # apprendre plus en observant la sortie de la commande.","title":"[z_tilt]"},{"location":"Config_Reference.html#quad_gantry_level","text":"Mise \u00e0 niveau du portique mobile \u00e0 l'aide de 4 moteurs Z contr\u00f4l\u00e9s ind\u00e9pendamment. Corrige les effets de paraboles hyperboliques (chips de pommes de terre) sur un portique mobile qui est plus flexible. AVERTISSEMENT : l'utilisation de cette section sur un lit mobile peut conduire \u00e0 des r\u00e9sultats ind\u00e9sirables. Si cette section est pr\u00e9sente, une commande G-Code \u00e9tendue QUAD_GANTRY_LEVEL devient disponible. Cette routine suppose la configuration suivante des moteurs Z : ---------------- |Z1 Z2| | --------- | | | | | | | | | | x-------- | |Z Z3| ---------------- O\u00f9 x est la position 0, 0 sur le lit [quad_gantry_level] #gantry_corners: # Une liste de coordonn\u00e9es X, Y, s\u00e9par\u00e9es par des retours \u00e0 la ligne, d\u00e9crivant les deux # coins oppos\u00e9s du portique. La premi\u00e8re entr\u00e9e correspond \u00e0 Z, la seconde \u00e0 Z2. # Ce param\u00e8tre doit \u00eatre fourni. #points: # Une liste, s\u00e9par\u00e9e par des retours \u00e0 la ligne, de quatre points X, Y devant \u00eatre palp\u00e9s # pendant une commande QUAD_GANTRY_LEVEL. L'ordre des emplacements est # important, il doit correspondre aux emplacements Z, Z1, Z2 et Z3 dans l'ordre. # Ce param\u00e8tre doit \u00eatre fourni. Pour une pr\u00e9cision maximale, assurez-vous que les # d\u00e9calages de votre sonde sont configur\u00e9s. #speed: 50 # La vitesse (en mm/s) des mouvements sans palpage pendant l'\u00e9talonnage. # La valeur par d\u00e9faut est 50. #horizontal_move_z: 5 # La hauteur (en mm) \u00e0 laquelle la t\u00eate doit \u00eatre relev\u00e9e pour se d\u00e9placer juste # avant de lancer une op\u00e9ration de palpage. La valeur par d\u00e9faut est 5. #max_adjust: 4 # Limite de s\u00e9curit\u00e9 quand un ajustement sup\u00e9rieur \u00e0 cette valeur est demand\u00e9. # quad_gantry_level abandonnera. #retries: 0 # Nombre de tentatives si les points palp\u00e9s ne sont pas dans la tol\u00e9rance. #retry_tolerance: 0 # Si les re-tentatives (retries) sont activ\u00e9es, r\u00e9essayer si les points palp\u00e9s les plus grands # et les plus petits diff\u00e8rent plus que la tol\u00e9rance de re-tentative (retry_tolerance).","title":"[quad_gantry_level]"},{"location":"Config_Reference.html#skew_correction","text":"Correction de l'inclinaison de l'imprimante. Il est possible de corriger l'inclinaison de l'imprimante logiciellement sur 3 plans, xy, xz, yz. Pour ce faire, on imprime un mod\u00e8le d'\u00e9talonnage le long d'un plan et on mesure trois longueurs. En raison de la nature de la correction d'inclinaison, ces longueurs sont d\u00e9finies via le gcode. Voir Correction d'inclinaison et R\u00e9f\u00e9rence des commandes pour plus de d\u00e9tails. [skew_correction]","title":"[skew_correction]"},{"location":"Config_Reference.html#z_thermal_adjust","text":"Ajustement de la position Z de la t\u00eate d'impression en fonction de la temp\u00e9rature. Compenser le mouvement vertical de la t\u00eate d'impression caus\u00e9 par la dilatation thermique du ch\u00e2ssis de l'imprimante en temps r\u00e9el \u00e0 l'aide d'un capteur de temp\u00e9rature (g\u00e9n\u00e9ralement coupl\u00e9 \u00e0 une section verticale du ch\u00e2ssis). Voir aussi : commandes de code G \u00e9tendues . [z_thermal_adjust] #temp_coeff: # Le coefficient de dilatation thermique, en mm/\u00b0C. Par exemple, un # temp_coeff de 0,01 mm/\u00b0C d\u00e9placera l'axe Z vers le bas de 0,01 mm pour # chaque degr\u00e9 Celsius d'augmentation du capteur de temp\u00e9rature. La # valeur par d\u00e9faut, 0,0 mm/\u00b0C, n'applique aucun ajustement. #smooth_time: # Fen\u00eatre de lissage appliqu\u00e9e au capteur de temp\u00e9rature, en secondes. # Peut r\u00e9duire le bruit du moteur d\u00fb \u00e0 de petites corrections excessives en # r\u00e9ponse au bruit du capteur. La valeur par d\u00e9faut est de 2,0 secondes. #z_adjust_off_above: # D\u00e9sactive les ajustements au-dessus de cette hauteur Z [mm]. La derni\u00e8re # correction calcul\u00e9e restera appliqu\u00e9e jusqu'\u00e0 ce que la t\u00eate de l'outil passe # \u00e0 nouveau en dessous de la hauteur Z sp\u00e9cifi\u00e9e. La valeur par d\u00e9faut est # 99999999.0 mm (toujours actif). #max_z_adjustment: # Ajustement absolu maximal pouvant \u00eatre appliqu\u00e9 \u00e0 l'axe Z [mm]. # La valeur par d\u00e9faut est 99999999.0 mm (illimit\u00e9). #sensor_type: #sensor_pin: #min_temp: #max_temp: # Configuration du capteur de temp\u00e9rature. # Voir la section \"extrudeuse\" pour la d\u00e9finition des param\u00e8tres ci-dessus. #gcode_id: # Voir la section \"heater_generic\" pour la d\u00e9finition de ce # param\u00e8tre.","title":"[z_thermal_adjust]"},{"location":"Config_Reference.html#mise-a-lorigine-personnalisee","text":"","title":"Mise \u00e0 l'origine personnalis\u00e9e"},{"location":"Config_Reference.html#safe_z_home","text":"Mise \u00e0 l'origine s\u00fbre de l'axe Z. On peut utiliser ce m\u00e9canisme pour centrer l'axe Z sur des coordonn\u00e9es X, Y sp\u00e9cifiques. Ceci est utile si la t\u00eate de l'outil, par exemple, doit se d\u00e9placer vers le centre du lit avant que l'axe Z puisse \u00eatre mis \u00e0 l'origine. [safe_z_home] home_xy_position: # Une coordonn\u00e9e X, Y (par exemple 100, 100) o\u00f9 la mise \u00e0 l'origine Z doit \u00eatre # effectu\u00e9e. Ce param\u00e8tre doit \u00eatre fourni. #speed: 50.0 # Vitesse \u00e0 laquelle la t\u00eate de l'outil est d\u00e9plac\u00e9e vers la position de r\u00e9f\u00e9rence Z s\u00fbre. # La valeur par d\u00e9faut est 50 mm/s #z_hop: # Distance (en mm) pour lever l'axe Z avant le retour au point d'origine. Cette valeur est # appliqu\u00e9e \u00e0 toute commande d'initialisation, m\u00eame si elle n'initialise pas l'axe Z. # Si l'axe Z est d\u00e9j\u00e0 ramen\u00e9 \u00e0 la position de base et que la position Z actuelle est inf\u00e9rieure # \u00e0 z_hop, alors ceci l\u00e8vera la t\u00eate \u00e0 une hauteur de z_hop. Si l'axe Z n'est pas d\u00e9j\u00e0 centr\u00e9, # la t\u00eate est relev\u00e9e de z_hop. # La valeur par d\u00e9faut est de ne pas impl\u00e9menter le relevage en Z. #z_hop_speed: 15.0 # Vitesse (en mm/s) \u00e0 laquelle l'axe Z est relev\u00e9 avant le retour \u00e0 la position initiale. # La valeur par d\u00e9faut est de 15 mm/s. #move_to_previous: False # Lorsqu'il a la valeur True, les axes X et Y sont r\u00e9initialis\u00e9s \u00e0 leurs positions pr\u00e9c\u00e9dentes apr\u00e8s # retour \u00e0 la position initiale de l'axe Z. La valeur par d\u00e9faut est False.","title":"[safe_z_home]"},{"location":"Config_Reference.html#homing_override","text":"Homing override. On peut utiliser ce m\u00e9canisme pour ex\u00e9cuter une s\u00e9rie de commandes g-code \u00e0 la place d'un G28 trouv\u00e9 dans l'entr\u00e9e g-code normale. Cela peut \u00eatre utile sur les imprimantes qui n\u00e9cessitent une proc\u00e9dure sp\u00e9cifique du retour au point d'origine de la machine. [homing_override] gcode: # Une liste de commandes G-Code \u00e0 ex\u00e9cuter \u00e0 la place des commandes G28 # trouv\u00e9es dans l'entr\u00e9e g-code normale. Voir docs/Command_Templates.md # pour le format G-Code. Si un G28 est contenu dans cette liste de commandes # alors la proc\u00e9dure de mise \u00e0 l'origine de l'imprimante sera invoqu\u00e9e. # Les commandes \u00e9num\u00e9r\u00e9es ici doivent ramener tous les axes \u00e0 la position initiale. # Ce param\u00e8tre doit \u00eatre fourni. #axes: xyz # Les axes \u00e0 remplacer. Par exemple, si ce param\u00e8tre est d\u00e9fini sur \"z\", alors le script # d'annulation ne sera ex\u00e9cut\u00e9 que lorsque l'axe z est mis \u00e0 l'origine (par ex. # une commande \"G28\" ou \"G28 Z\"). Remarque : le script de neutralisation doit # toujours g\u00e9rer tous les axes. La valeur par d\u00e9faut est \"xyz\" ce qui fait que le script # de remplacement sera ex\u00e9cut\u00e9 \u00e0 la place de toutes les commandes G28. #set_position_x: #set_position_y: #set_position_z: # Si sp\u00e9cifi\u00e9, l'imprimante supposera que l'axe est \u00e0 la position sp\u00e9cifi\u00e9e avant # d'ex\u00e9cuter les commandes g-code ci-dessus. Le fait de d\u00e9finir ceci d\u00e9sactive les # contr\u00f4les d'orientation pour cet axe. Cela peut \u00eatre utile si la t\u00eate doit se d\u00e9placer # avant d'invoquer le m\u00e9canisme G28 normal d'un axe. # La valeur par d\u00e9faut est de ne pas forcer une position pour un axe.","title":"[homing_override]"},{"location":"Config_Reference.html#endstop_phase","text":"Interrupteurs de fin de course ajust\u00e9s \u00e0 la phase du moteur pas \u00e0 pas. Pour utiliser cette fonction, d\u00e9finissez une section de configuration avec un pr\u00e9fixe \"endstop_phase\" suivi du nom de la section de configuration du moteur pas \u00e0 pas correspondante (par exemple, \"[endstop_phase stepper_z]\"). Cette fonctionnalit\u00e9 peut am\u00e9liorer la pr\u00e9cision des interrupteurs de fin de course. Ajoutez une d\u00e9claration nue \"[endstop_phase]\" pour activer la commande ENDSTOP_PHASE_CALIBRATE. Voir le guide de d\u00e9tecteurs de fin de course et la r\u00e9f\u00e9rence des commandes pour plus d'informations. [endstop_phase stepper_z] #endstop_accuracy: # D\u00e9finit la pr\u00e9cision attendue (en mm) de la but\u00e9e. Cela repr\u00e9sente la distance d'erreur # maximale que la but\u00e9e peut d\u00e9clencher (par exemple, si une but\u00e9e peut occasionnellement # se d\u00e9clencher 100um en avance ou jusqu'\u00e0 100um en retard alors r\u00e9glez cette valeur # sur 0.200 pour 200um). La valeur par d\u00e9faut est 4*rotation_distance/full_steps_per_rotation. #trigger_phase: # Sp\u00e9cifie la phase du pilote du moteur pas \u00e0 pas \u00e0 attendre lorsque l'on atteint la but\u00e9e. # Compos\u00e9 de deux nombres s\u00e9par\u00e9s par une barre oblique - la phase et le nombre total # de phases (par exemple, \"7/64\"). Ne d\u00e9finissez cette valeur que si vous \u00eates s\u00fbr que le # pilote du moteur pas \u00e0 pas est r\u00e9initialis\u00e9 \u00e0 chaque fois que le mcu est r\u00e9initialis\u00e9. # Si cette valeur n'est pas d\u00e9finie, alors la phase du moteur pas \u00e0 pas sera d\u00e9tect\u00e9e \u00e0 la # premi\u00e8re mise \u00e0 l'origine et cette phase sera utilis\u00e9e sur toutes les origines suivantes. #endstop_align_zero: False # Si vrai, la position_endstop de l'axe sera effectivement modifi\u00e9e de mani\u00e8re \u00e0 ce que la # position z\u00e9ro de l'axe se produise sur un pas complet du moteur pas \u00e0 pas. (Si utilis\u00e9 sur # l'axe Z et que la hauteur de la couche d'impression est un multiple de la distance parcourue # par un pas complet, alors chaque couche se produira sur un pas complet). # La valeur par d\u00e9faut est False.","title":"[endstop_phase]"},{"location":"Config_Reference.html#macros-et-evenements-g-code","text":"","title":"Macros et \u00e9v\u00e9nements G-Code"},{"location":"Config_Reference.html#gcode_macro","text":"Macros G-Code (on peut d\u00e9finir un nombre quelconque de sections avec le pr\u00e9fixe \"gcode_macro\"). Voir le guide des mod\u00e8les de commande pour plus d'informations. [gcode_macro my_cmd] #gcode: # Une liste de commandes G-Code \u00e0 ex\u00e9cuter \u00e0 la place de \"my_cmd\". Voir # docs/Command_Templates.md pour le format G-Code. Ce param\u00e8tre doit # \u00eatre fourni. #variable_<name>: # On peut sp\u00e9cifier un nombre quelconque d'options avec le pr\u00e9fixe \"variable_\". # Le nom de variable donn\u00e9 se verra attribu\u00e9 la valeur donn\u00e9e (analys\u00e9e en tant # que litt\u00e9ral par Python) et sera disponible pendant l'expansion de la macro. # Par exemple, une configuration avec \"variable_fan_speed = 75\" pourrait avoir # des commandes gcode contenant \"M106 S{ fan_speed * 255 }\". Ces variables # peuvent alors \u00eatre modifi\u00e9es au moment de l'ex\u00e9cution en utilisant la commande # SET_GCODE_VARIABLE (voir docs/Command_Templates.md pour plus de d\u00e9tails). # Les noms de variables peuvent ne pas utiliser de caract\u00e8res majuscules. #rename_existing: # Cette option permet \u00e0 la macro de remplacer une commande G-Code existante # et fournira la d\u00e9finition pr\u00e9c\u00e9dente de la commande via le nom fourni ici. Ceci # peut \u00eatre utilis\u00e9 pour remplacer les commandes G-Code originelles. Il convient # d'\u00eatre prudent lorsque l'on remplace des commandes, cela pouvant provoquer # des r\u00e9sultats complexes et inattendus. La valeur par d\u00e9faut est de ne pas # remplacer une commande G-Code existante. #description: Macro G-Code # Ceci ajoutera une courte description utilis\u00e9e \u00e0 la commande HELP ou lors de # l'utilisation de la fonction de compl\u00e9tion automatique. # Par d\u00e9faut : \"G-Code macro\".","title":"[gcode_macro]"},{"location":"Config_Reference.html#delayed_gcode","text":"Ex\u00e9cute un gcode sur un d\u00e9lai d\u00e9fini. Voir le guide des mod\u00e8les de commande et la r\u00e9f\u00e9rence des commandes pour plus d'informations. [delayed_gcode my_delayed_gcode] gcode: # Une liste de commandes G-Code \u00e0 ex\u00e9cuter lorsque la dur\u00e9e du d\u00e9lai est \u00e9coul\u00e9e. # Les mod\u00e8les G-Code sont support\u00e9s. Ce param\u00e8tre doit \u00eatre fourni. #initial_duration: 0.0 # Dur\u00e9e du d\u00e9lai initial (en secondes). Si elle est d\u00e9finie \u00e0 une valeur non nulle, le gcode # diff\u00e9r\u00e9 s'ex\u00e9cutera le nombre de secondes sp\u00e9cifi\u00e9 apr\u00e8s que l'imprimante passe \u00e0 # l'\u00e9tat \"pr\u00eat\". Ceci peut \u00eatre utile pour les proc\u00e9dures d'initialisation ou lors d'une # r\u00e9p\u00e9tition de delayed_gcode. Si la valeur est 0, le delayed_gcode ne sera pas ex\u00e9cut\u00e9 # au d\u00e9marrage. # La valeur par d\u00e9faut est 0.","title":"[delayed_gcode]"},{"location":"Config_Reference.html#save_variables","text":"Prise en charge de l'enregistrement des variables sur le disque afin qu'elles soient conserv\u00e9es lors des red\u00e9marrages. Voir mod\u00e8les de commande et r\u00e9f\u00e9rence G-code pour plus d'informations. [save_variables] filename: # Obligatoire - fournir un nom de fichier utilis\u00e9 pour enregistrer les variables # sur le disque, par exemple ~/variables.cfg.","title":"[save_variables]"},{"location":"Config_Reference.html#idle_timeout","text":"D\u00e9lai d'inactivit\u00e9. Un d\u00e9lai d'inactivit\u00e9 est automatiquement activ\u00e9 - ajoutez une section de configuration idle_timeout explicite pour modifier les param\u00e8tres par d\u00e9faut. [idle_timeout] #gcode: # Une liste de commandes G-Code \u00e0 ex\u00e9cuter lors d'un d\u00e9lai d'inactivit\u00e9. Voir # docs/Command_Templates.md pour le format G-Code. La valeur par d\u00e9faut # est d'ex\u00e9cuter \"TURN_OFF_HEATERS\" et \"M84\". #timeout: 600 # Dur\u00e9e d'attente (en secondes) avant d'ex\u00e9cuter les commandes G-Code ci-dessus. # La valeur par d\u00e9faut est de 600 secondes.","title":"[idle_timeout]"},{"location":"Config_Reference.html#fonctionnalites-optionnelles-du-g-code","text":"","title":"Fonctionnalit\u00e9s optionnelles du G-code"},{"location":"Config_Reference.html#virtual_sdcard","text":"Une carte SD virtuelle peut \u00eatre utile si la machine h\u00f4te n'est pas assez rapide pour faire fonctionner OctoPrint correctement. Elle permet au logiciel h\u00f4te Klipper d'imprimer directement les fichiers gcode stock\u00e9s dans un r\u00e9pertoire sur l'h\u00f4te en utilisant les commandes G-Code standard de la carte SD (par exemple, M24). [virtual_sdcard] path: # Le chemin d'acc\u00e8s au r\u00e9pertoire local sur la machine h\u00f4te de recherche # des fichiers g-code. Il s'agit d'un r\u00e9pertoire en lecture seule (les \u00e9critures # de fichiers sur une carte SD ne sont pas support\u00e9es). On peut le faire pointer # vers le r\u00e9pertoire de t\u00e9l\u00e9chargement d'OctoPrint (g\u00e9n\u00e9ralement # ~/.octoprint/uploads/ ). Ce param\u00e8tre doit \u00eatre fourni. #on_error_gcode: # Une liste de commandes G-Code \u00e0 ex\u00e9cuter lorsqu'une erreur est signal\u00e9e.","title":"[virtual_sdcard]"},{"location":"Config_Reference.html#sdcard_loop","text":"Certaines imprimantes dot\u00e9es de fonctions d'\u00e9jections des pi\u00e8ces imprim\u00e9es, comme un \u00e9jecteur de pi\u00e8ces ou une imprimante \u00e0 courroie, peuvent trouver une utilit\u00e9 dans la mise en boucle de sections du fichier de la carte SD (par exemple, pour imprimer la m\u00eame pi\u00e8ce encore et encore, ou r\u00e9p\u00e9ter une section d'une pi\u00e8ce pour une cha\u00eene ou un autre motif r\u00e9p\u00e9t\u00e9). Voir la r\u00e9f\u00e9rence des commandes pour les commandes prises en charge. Voir le fichier sample-macros.cfg pour une macro G-Code compatible avec le M808 de Marlin. [sdcard_loop]","title":"[sdcard_loop]"},{"location":"Config_Reference.html#force_move","text":"Support des d\u00e9placements manuels des moteurs pas \u00e0 pas \u00e0 des fins de diagnostic. Remarque : l'utilisation de cette fonction peut placer l'imprimante dans un \u00e9tat invalide - consultez la r\u00e9f\u00e9rence de la commande pour obtenir des d\u00e9tails importants. [force_move] #enable_force_move: False # D\u00e9fini \u00e0 true pour activer les commandes G-Code \u00e9tendues FORCE_MOVE et # SET_KINEMATIC_POSITION # La valeur par d\u00e9faut est false.","title":"[force_move]"},{"location":"Config_Reference.html#pause_resume","text":"Fonctionnalit\u00e9 Pause/Reprise avec prise en charge de la capture et de la restauration de position. Voir la r\u00e9f\u00e9rence de la commande pour plus d'informations. [pause_resume] #recover_velocity: 50. # Lorsque la capture/restauration est activ\u00e9e, la vitesse \u00e0 laquelle retourner \u00e0 # la position captur\u00e9e (en mm/s). La valeur par d\u00e9faut est 50,0 mm/s.","title":"[pause_resume]"},{"location":"Config_Reference.html#firmware_retraction","text":"R\u00e9traction du filament par le firmware. Cela permet d'activer les commandes GCODE G10 (r\u00e9traction) et G11 (d\u00e9-r\u00e9traction) \u00e9mises par de nombreux trancheurs. Les param\u00e8tres ci-dessous fournissent des valeurs par d\u00e9faut au d\u00e9marrage, ces valeurs peuvent \u00eatre ajust\u00e9es via la commande SET_RETRACTION , ce qui permet des r\u00e9glages par filament et des ajustements en cours d'impression. [firmware_retraction] #retract_length: 0 # La longueur du filament (en mm) \u00e0 r\u00e9tracter lorsque G10 est activ\u00e9, et \u00e0 fournir # lorsque G11 est activ\u00e9 (voir unretract_extra_length ci-dessous). # La valeur par d\u00e9faut est 0 mm. #retract_speed: 20 # La vitesse de r\u00e9traction, en mm/s. La valeur par d\u00e9faut est 20 mm/s. #unretract_extra_length: 0 # Longueur (en mm) de filament *suppl\u00e9mentaire* \u00e0 ajouter lors de la d\u00e9-r\u00e9traction. #unretract_speed: 10 # La vitesse de d\u00e9-r\u00e9traction, en mm/s. La valeur par d\u00e9faut est 10 mm/s.","title":"[firmware_retraction]"},{"location":"Config_Reference.html#gcode_arcs","text":"Support des commandes gcode de courbes (arc) (G2/G3). [gcode_arcs] #resolution: 1.0 # Un arc sera divis\u00e9 en segments. La longueur de chaque segment sera \u00e9gale \u00e0 # la r\u00e9solution en mm d\u00e9finie ci-dessus. Des valeurs plus faibles produiront un # arc plus fin, mais \u00e9galement plus de travail de votre machine. Les arcs plus # petits que la valeur configur\u00e9e deviendront des lignes droites. La valeur par # d\u00e9faut est 1 mm.","title":"[gcode_arcs]"},{"location":"Config_Reference.html#respond","text":"Active les commandes \u00e9tendues \"M118\" et \"RESPOND\" . [respond] #default_type: echo # D\u00e9finit le pr\u00e9fixe par d\u00e9faut de la sortie \"M118\" et \"RESPOND\" \u00e0 l'un des # \u00e9l\u00e9ments suivants : # echo: \"echo : \" (C'est la valeur par d\u00e9faut) # command: \"// \" # error: \" !! \" #default_prefix: echo: # D\u00e9finit directement le pr\u00e9fixe par d\u00e9faut. Si elle est pr\u00e9sente, cette valeur # remplacera celle de \"default_type\".","title":"[respond]"},{"location":"Config_Reference.html#exclude_object","text":"Permet de prendre en charge l'exclusion ou l'annulation d'objets individuels pendant le processus d'impression. Voir le guide des objets exclus et la r\u00e9f\u00e9rence des commandes pour plus d'informations. Voir le fichier sample-macros.cfg pour une macro G-Code M486 compatible avec Marlin/RepRapFirmware. [exclude_object]","title":"[exclude_object]"},{"location":"Config_Reference.html#compensation-de-la-resonance","text":"","title":"Compensation de la r\u00e9sonance"},{"location":"Config_Reference.html#input_shaper","text":"Active la compensation de r\u00e9sonance . Voir \u00e9galement la r\u00e9f\u00e9rence des commandes . [input_shaper] #shaper_freq_x: 0 # Fr\u00e9quence (en Hz) de la mise en forme de l'entr\u00e9e pour l'axe X. Il s'agit g\u00e9n\u00e9ralement # d'une fr\u00e9quence de r\u00e9sonance de l'axe X que la mise en forme de l'entr\u00e9e doit supprimer. # Pour les mises en forme plus complexes, comme les mises en forme \u00e0 2 ou 3 bosses EI # (2hump/3hump), ce param\u00e8tre peut \u00eatre d\u00e9fini \u00e0 partir de diff\u00e9rentes consid\u00e9rations. # La valeur par d\u00e9faut est 0, ce qui d\u00e9sactive la mise en forme de l'entr\u00e9e pour l'axe X. #shaper_freq_y: 0 # Fr\u00e9quence (en Hz) de la mise en forme de l'entr\u00e9e pour l'axe Y. Il s'agit g\u00e9n\u00e9ralement # d'une fr\u00e9quence de r\u00e9sonance de l'axe Y que la mise en forme de l'entr\u00e9e doit supprimer. # Pour les mises en forme plus complexes, comme les mises en forme \u00e0 2 ou 3 bosses EI # (2hump/3hump), ce param\u00e8tre peut \u00eatre d\u00e9fini \u00e0 partir de diff\u00e9rentes consid\u00e9rations. # La valeur par d\u00e9faut est 0, ce qui d\u00e9sactive la mise en forme de l'entr\u00e9e pour l'axe Y. #shaper_type: mzv # Le type de mise en forme de l'entr\u00e9e \u00e0 utiliser pour les axes X et Y. Les types support\u00e9s # sont zv, mzv, zvd, ei, 2hump_ei, et 3hump_ei. # La valeur par d\u00e9faut est la compensation de r\u00e9sonance mzv. #shaper_type_x: #shaper_type_y: # Si shaper_type n'est pas d\u00e9fini, ces deux param\u00e8tres peuvent \u00eatre utilis\u00e9s pour configurer # des formes d'entr\u00e9e diff\u00e9rentes pour les axes X et Y. Les valeurs support\u00e9es sont les # m\u00eames que celles du param\u00e8tre shaper_type. #damping_ratio_x: 0.1 #damping_ratio_y: 0.1 # Taux d'amortissement des vibrations des axes X et Y utilis\u00e9s par les dispositifs de mise # en forme de l'entr\u00e9e afin d'am\u00e9liorer la suppression des vibrations. La valeur par d\u00e9faut est # 0.1 ce qui est une bonne valeur g\u00e9n\u00e9rale pour la plupart des imprimantes. Dans la plupart # des cas, ce param\u00e8tre ne n\u00e9cessite aucun r\u00e9glage et ne doit pas \u00eatre modifi\u00e9.","title":"[input_shaper]"},{"location":"Config_Reference.html#adxl345","text":"Support des acc\u00e9l\u00e9rom\u00e8tres ADXL345. Ce support permet d'interroger les mesures de l'acc\u00e9l\u00e9rom\u00e8tre \u00e0 partir du capteur. Cela active une commande ACCELEROMETER_MEASURE (voir G-Codes pour plus d'informations). Le nom de la puce par d\u00e9faut est \"default\", mais on peut sp\u00e9cifier un nom explicite (par exemple, [adxl345 my_chip_name]). [adxl345] cs_pin: # La broche d'activation SPI du capteur. Ce param\u00e8tre doit \u00eatre fourni. #spi_speed: 5000000 # La vitesse SPI (en hz) \u00e0 utiliser lors de la communication avec la puce. # La valeur par d\u00e9faut est 5000000. #spi_bus: #spi_software_sclk_pin: #spi_software_mosi_pin: #spi_software_miso_pin: # Voir la section \"param\u00e8tres SPI communs\" pour une description des # param\u00e8tres ci-dessus. #axes_map : x, y, z # L'axe de l'acc\u00e9l\u00e9rom\u00e8tre de chacun des axes X, Y et Z de l'imprimante. # Ceci peut \u00eatre utile si l'acc\u00e9l\u00e9rom\u00e8tre est mont\u00e9 dans une orientation # qui ne correspond pas \u00e0 celle de l'imprimante. Par exemple, on peut # r\u00e9gler cette option sur \"y, x, z\" pour permuter les axes X et Y. # Il est \u00e9galement possible d'inverser un axe si la direction de l'acc\u00e9l\u00e9rom\u00e8tre # est invers\u00e9e (par exemple, \"x, z, -y\"). La valeur par d\u00e9faut est \"x, y, z\". #Rate: 3200 # D\u00e9bit de donn\u00e9es de sortie pour ADXL345. ADXL345 prend en charge les d\u00e9bits # de donn\u00e9es suivants : 3200, 1600, 800, 400, 200, 100, 50, et 25. Notez qu'il n'est # pas recommand\u00e9 de changer ce d\u00e9bit par rapport au d\u00e9bit par d\u00e9faut de 3200, # les d\u00e9bits inf\u00e9rieurs \u00e0 800 affecteront consid\u00e9rablement la qualit\u00e9 des mesures # de r\u00e9sonance.","title":"[adxl345]"},{"location":"Config_Reference.html#mpu9250","text":"Support for MPU-9250, MPU-9255, MPU-6515, MPU-6050, and MPU-6500 accelerometers (one may define any number of sections with an \"mpu9250\" prefix). [mpu9250 my_accelerometer] #i2c_address: # La valeur par d\u00e9faut est 104 (0x68). Si AD0 est \u00e9lev\u00e9, ce sera 0x69 \u00e0 la place. #i2c_mcu: #i2c_bus: #i2c_speed: 400000 # Voir la section \"param\u00e8tres I2C communs\" pour une description des # param\u00e8tres ci-dessus. La valeur par d\u00e9faut de \"i2c_speed\" est 400000. #axes_map: x, y, z # Voir la section \"adxl345\" pour des informations sur ce param\u00e8tre.","title":"[mpu9250]"},{"location":"Config_Reference.html#resonance_tester","text":"Prise en charge du test de r\u00e9sonance et du calibrage automatique du fa\u00e7onneur d'entr\u00e9e (input shaper). Pour utiliser la plupart des fonctionnalit\u00e9s de ce module, des d\u00e9pendances logicielles suppl\u00e9mentaires doivent \u00eatre install\u00e9es ; reportez-vous \u00e0 Mesurer les r\u00e9sonances et \u00e0 la r\u00e9f\u00e9rence de commande pour plus d'informations. Voir la section Adoucissement Max du guide de mesure des r\u00e9sonances pour plus d'informations sur le param\u00e8tre max_smoothing et son utilisation. [resonance_tester] #probe_points: # Une liste de coordonn\u00e9es X, Y, Z de points (un point par ligne) \u00e0 tester. # Au moins un point est requis. Assurez-vous que tous les points avec une certaine marge # de s\u00e9curit\u00e9 dans le plan XY (~ quelques centim\u00e8tres) sont accessibles par la t\u00eate de l'outil. #accel_chip: # Nom de la puce d'acc\u00e9l\u00e9rom\u00e8tre \u00e0 utiliser pour les mesures. Si la puce adxl345 a \u00e9t\u00e9 d\u00e9finie # sans un nom explicite, ce param\u00e8tre peut simplement la r\u00e9f\u00e9rencer en tant que # \"accel_chip : adxl345\", sinon un nom explicite doit \u00eatre fourni, par exemple # \"accel_chip : adxl345 my_chip_name\". Soit ce param\u00e8tre seul, soit les deux param\u00e8tres # suivants doivent \u00eatre d\u00e9finis. #accel_chip_x: #accel_chip_y: # Noms des puces d'acc\u00e9l\u00e9rom\u00e8tre \u00e0 utiliser pour les mesures de chaque axe. # Peut \u00eatre utile, par exemple, sur une imprimante de type \"bed slinger\", si deux acc\u00e9l\u00e9rom\u00e8tres # s\u00e9par\u00e9s sont mont\u00e9s, un sur le lit (pour l'axe Y), l'autre sur la t\u00eate de l'outil (pour l'axe X). # Ces param\u00e8tres ont le m\u00eame format que le param\u00e8tre 'accel_chip'. Soit le param\u00e8tre # 'accel_chip' soit ces deux param\u00e8tres doivent \u00eatre fournis. #max_smoothing: # Lissage maximal du fa\u00e7onneur (shaper) d'entr\u00e9e \u00e0 autoriser pour chaque axe pendant # l'auto-calibration (avec la commande 'SHAPER_CALIBRATE'). Par d\u00e9faut, aucun lissage # maximal n'est sp\u00e9cifi\u00e9. Reportez-vous au guide Measuring_Resonances pour plus de d\u00e9tails # sur l'utilisation de cette fonction. #min_freq: 5 # Fr\u00e9quence minimale de test des r\u00e9sonances. La valeur par d\u00e9faut est 5 Hz. #max_freq: 133.33 # Fr\u00e9quence maximale de test des r\u00e9sonances. La valeur par d\u00e9faut est 133,33 Hz. #accel_per_hz: 75 # Ce param\u00e8tre permet de d\u00e9terminer l'acc\u00e9l\u00e9ration \u00e0 utiliser pour tester une fr\u00e9quence # sp\u00e9cifique: accel = accel_per_hz * freq. Plus haute est cette valeur, plus l'\u00e9nergie des # oscillations est \u00e9lev\u00e9e. Peut \u00eatre fix\u00e9 \u00e0 une valeur inf\u00e9rieure \u00e0 celle par d\u00e9faut si les # r\u00e9sonances deviennent trop fortes sur l'imprimante. Cependant, des valeurs plus faibles # rendent les mesures des r\u00e9sonances \u00e0 haute fr\u00e9quence moins pr\u00e9cises. La valeur par # d\u00e9faut est de 75 (mm/sec). #hz_per_sec: 1 # D\u00e9termine la vitesse de l'essai. Lors du test de toutes les fr\u00e9quences dans la plage [min_freq, # max_freq], chaque seconde, la fr\u00e9quence augmente de hz_per_sec. # De faibles valeurs rendent le test lent, de grandes valeurs diminueront la pr\u00e9cision du test. # La valeur par d\u00e9faut est 1.0 (Hz/sec == sec^-2).","title":"[resonance_tester]"},{"location":"Config_Reference.html#assistants-de-fichiers-de-configuration","text":"","title":"Assistants de fichiers de configuration"},{"location":"Config_Reference.html#board_pins","text":"Alias des broches de la carte (on peut d\u00e9finir un nombre quelconque de sections avec le pr\u00e9fixe \"board_pins\"). Utilisez ceci pour d\u00e9finir des alias de broches d'un micro-contr\u00f4leur. [board_pins my_aliases] mcu: mcu # Une liste de micro-contr\u00f4leurs s\u00e9par\u00e9s par des virgules pouvant utiliser les # alias. La valeur par d\u00e9faut est d'appliquer les alias au \"mcu\" principal. alias: aliases_<nom>: # Une liste s\u00e9par\u00e9e par des virgules d'alias \"nom=valeur\" \u00e0 cr\u00e9er pour le micro- # contr\u00f4leur donn\u00e9. Par exemple, \"EXP1_1=PE6\" cr\u00e9era un alias \"EXP1_1\" pour la # broche \"PE6\". Cependant, si la \"valeur\" est incluse dans \"<>\", alors \"nom\" est cr\u00e9\u00e9 # comme une broche r\u00e9serv\u00e9e (par exemple, \"EXP1_9=<GND>\" r\u00e9serverait \"EXP1_9\"). # Un nombre quelconque d'options commen\u00e7ant par \"alias_\" peuvent \u00eatre sp\u00e9cifi\u00e9es.","title":"[board_pins]"},{"location":"Config_Reference.html#include","text":"Prise en charge de l'inclusion de fichiers. On peut inclure des fichiers de configuration suppl\u00e9mentaires \u00e0 partir du fichier de configuration principal de l'imprimante. Les caract\u00e8res g\u00e9n\u00e9riques peuvent \u00e9galement \u00eatre utilis\u00e9s (par exemple, \"configs/*.cfg\"). [include my_other_config.cfg]","title":"[include]"},{"location":"Config_Reference.html#duplicate_pin_override","text":"Cet outil permet de d\u00e9finir plusieurs fois une m\u00eame broche de microcontr\u00f4leur dans un fichier de configuration sans v\u00e9rification normale des erreurs. Ceci est destin\u00e9 \u00e0 des fins de diagnostic et de d\u00e9bogage. Cette section n'est pas n\u00e9cessaire lorsque Klipper prend en charge l'utilisation de la m\u00eame broche plusieurs fois, et l'utilisation de cette d\u00e9rogation peut entra\u00eener des r\u00e9sultats confus et inattendus. [duplicate_pin_override] pins: # Une liste de broches s\u00e9par\u00e9es par des virgules pouvant \u00eatre utilis\u00e9es plusieurs fois dans # un fichier de configuration sans contr\u00f4les d'erreurs normaux. Ce param\u00e8tre doit \u00eatre # fourni.","title":"[duplicate_pin_override]"},{"location":"Config_Reference.html#materiel-de-nivelage-du-lit","text":"","title":"Mat\u00e9riel de nivelage du lit"},{"location":"Config_Reference.html#probe","text":"Sonde de hauteur Z. On peut d\u00e9finir cette section pour activer le mat\u00e9riel de nivellement de l'axe Z. Lorsque cette section est activ\u00e9e, les commandes g-code \u00e9tendus PROBE et QUERY_PROBE deviennent disponibles. Consultez \u00e9galement le guide d'\u00e9talonnage des sondes . La section probe cr\u00e9e \u00e9galement une broche virtuelle \"probe:z_virtual_endstop\". Il est possible de d\u00e9finir la broche du stepper_z, endstop_pin, sur cette broche virtuelle pour les imprimantes de style cart\u00e9sien qui utilisent la sonde \u00e0 la place d'un interrupteur de fin de course Z. Si vous utilisez \"probe:z_virtual_endstop\", ne d\u00e9finissez pas de position_endstop dans la configuration de la section stepper_z. [probe] pin: # Broche de d\u00e9tection de la sonde. Si la broche se trouve sur un microcontr\u00f4leur diff\u00e9rent # de celui des moteurs de l'axe Z alors elle active le \"multi-mcu homing\". Ce param\u00e8tre # doit \u00eatre fourni. #deactivate_on_each_sample: True # Ceci d\u00e9termine si Klipper doit ex\u00e9cuter le gcode de d\u00e9sactivation entre chaque tentative # de palpage lors d'une s\u00e9quence de palpages multiples. # La valeur par d\u00e9faut est True. #x_offset: 0.0 # La distance (en mm) entre la sonde et la buse le long de l'axe x. # La valeur par d\u00e9faut est 0. #y_offset: 0.0 # La distance (en mm) entre la sonde et la buse le long de l'axe y. # La valeur par d\u00e9faut est 0. z_offset: # La distance (en mm) entre le lit et la buse lorsque la sonde se d\u00e9clenche. # Ce param\u00e8tre doit \u00eatre fourni. #speed: 5.0 # Vitesse (en mm/s) de l'axe Z lors du palpage. La valeur par d\u00e9faut est 5mm/s. #samples: 1 # Le nombre de fois o\u00f9 il faut palper chaque point. Les valeurs z palp\u00e9es seront # moyenn\u00e9es. La valeur par d\u00e9faut est de palper 1 fois. #sample_retract_dist: 2.0 # Distance (en mm) \u00e0 parcourir pour relever la t\u00eate de l'outil entre chaque palpage # (en cas d'\u00e9chantillonnage multiple). La valeur par d\u00e9faut est 2mm. #lift_speed: # Vitesse (en mm/s) de l'axe Z lors du levage de la sonde entre les \u00e9chantillons. # La valeur par d\u00e9faut est la m\u00eame que celle du param\u00e8tre 'speed'. #samples_result: average # La m\u00e9thode de calcul lorsque l'on \u00e9chantillonne plusieurs fois - soit \"m\u00e9diane\" # (median) ou \"moyenne\" (average). La valeur par d\u00e9faut est \"moyenne\". #samples_tolerance: 0.100 # La distance Z maximale (en mm) \u00e0 laquelle un \u00e9chantillon peut diff\u00e9rer des autres # \u00e9chantillons. Si cette tol\u00e9rance est d\u00e9pass\u00e9e, soit une erreur est signal\u00e9e soit une # tentative de palpage est recommenc\u00e9e (cf. samples_tolerance_retries). # La valeur par d\u00e9faut est 0.100mm. #samples_tolerance_retries: 0 # Le nombre de fois qu'il faut r\u00e9essayer quand un palpage d\u00e9passe la tol\u00e9rance des # \u00e9chantillons. Lors d'une nouvelle tentative, tous les \u00e9chantillons en cours sont rejet\u00e9s # et une tentative de palpa est relanc\u00e9e. Si un ensemble valide d'\u00e9chantillons n'est pas # obtenu dans le nombre de tentatives donn\u00e9, une erreur est signal\u00e9e. La valeur par d\u00e9faut # est z\u00e9ro, ce qui entra\u00eene le signalement d'une erreur d\u00e8s le premier \u00e9chantillon d\u00e9passant # la tol\u00e9rance de samples_tolerance. #activate_gcode: # Une liste de commandes G-Code \u00e0 ex\u00e9cuter avant chaque tentative de palpage. # Voir docs/Command_Templates.md pour le format G-Code. Cela peut \u00eatre utile si la sonde # doit \u00eatre activ\u00e9e d'une mani\u00e8re particuli\u00e8re. Ne pas envoyer ici de commandes d\u00e9pla\u00e7ant # la t\u00eate de l'outil (par exemple, G1). La valeur par d\u00e9faut est de ne pas ex\u00e9cuter de commandes # G-code sp\u00e9ciales lors de l'activation. #deactivate_gcode: # Une liste de commandes G-Code \u00e0 ex\u00e9cuter apr\u00e8s la fin de chaque tentative de palpage # termin\u00e9e. Voir docs/Command_Templates.md pour le format G-Code. Ne pas envoyer ici # de commandes d\u00e9pla\u00e7ant la t\u00eate de l'outil. La valeur par d\u00e9faut est de ne pas ex\u00e9cuter de # commandes G-code sp\u00e9ciales lors de la d\u00e9sactivation.","title":"[probe]"},{"location":"Config_Reference.html#bltouch","text":"Sonde BLTouch. On peut d\u00e9finir cette section (au lieu d'une section probe) pour activer une sonde BLTouch. Voir Guide BL-Touch et R\u00e9f\u00e9rence des commandes pour plus d'informations. Une broche virtuelle \"probe:z_virtual_endstop\" est \u00e9galement cr\u00e9\u00e9e (voir la section \"probe\" pour les d\u00e9tails). [bltouch] sensor_pin: # Broche connect\u00e9e \u00e0 la broche du capteur (sensor) BLTouch. La plupart des BLTouch # exigent un pullup sur la broche du capteur (pr\u00e9fixez le nom de la broche par \"^\"). # Ce param\u00e8tre doit \u00eatre fourni. control_pin: # Broche connect\u00e9e \u00e0 la broche de commande du BLTouch. # Ce param\u00e8tre doit \u00eatre fourni. #pin_move_time: 0.680 # Dur\u00e9e d'attente (en secondes) pour que la broche BLTouch se d\u00e9place vers # le haut ou le bas. La valeur par d\u00e9faut est de 0,680 seconde. #stow_on_each_sample: True # D\u00e9termine si Klipper doit ordonner \u00e0 la broche de se d\u00e9placer vers le haut entre # chaque palpage lors d'une s\u00e9quence de palpages multiples. # Lisez les instructions dans docs/BLTouch.md avant de r\u00e9gler ce param\u00e8tre \u00e0 False. # La valeur par d\u00e9faut est True. #probe_with_touch_mode: False # Si ce param\u00e8tre est d\u00e9fini sur True, Klipper palpera avec le p\u00e9riph\u00e9rique en # \"touch_mode\". La valeur par d\u00e9faut est False (palpage en mode \"pin_down\"). #pin_up_reports_not_triggered: True # D\u00e9finit si le BLTouch rapporte syst\u00e9matiquement le palpeur dans un \u00e9tat \"non # d\u00e9clench\u00e9\" apr\u00e8s une commande \"pin_up\" r\u00e9ussie. Ceci devrait \u00eatre True pour # tous les BLTouch authentiques. Lisez les instructions de docs/BLTouch.md avant # de r\u00e9gler cette valeur \u00e0 False. La valeur par d\u00e9faut est True. #pin_up_touch_mode_reports_triggered: True # D\u00e9finit si le BLTouch rapporte syst\u00e9matiquement un \u00e9tat \"d\u00e9clench\u00e9\" apr\u00e8s la # commande \"pin_up_mode_reports_triggered\". Ceci devrait \u00eatre True pour tous les # BLTouch authentiques. Lisez les instructions de docs/BLTouch.md avant de r\u00e9gler # cette valeur \u00e0 False. La valeur par d\u00e9faut est True. #set_output_mode: # Demande un mode de sortie particulier de la broche du capteur sur un BLTouch V3.0 # (et ult\u00e9rieurs). Ce param\u00e8tre ne doit pas \u00eatre utilis\u00e9 sur d'autres types de sondes. # R\u00e9glez sur \"5V\" pour demander une sortie de 5 Volts de la broche du capteur (\u00e0 n'utiliser # que si la carte contr\u00f4leur n\u00e9cessite le mode 5V et est tol\u00e9rante \u00e0 5V sur sa ligne de signal # d'entr\u00e9e). R\u00e9glez sur \"OD\" pour demander l'utilisation de la sortie de la broche du capteur # en mode drain ouvert. La valeur par d\u00e9faut est de ne pas demander de mode de sortie. #x_offset: #y_offset: #z_offset: #speed: #lift_speed: #samples: #sample_retract_dist: #samples_result: #samples_tolerance: #samples_tolerance_retries: # Voir la section \"probe\" pour des informations sur ces param\u00e8tres.","title":"[bltouch]"},{"location":"Config_Reference.html#smart_effector","text":"Le \"Smart Effector\" de Duet3d impl\u00e9mente une sonde Z utilisant un capteur de force. On peut d\u00e9finir cette section \u00e0 la place de [probe] pour activer les fonctionnalit\u00e9s sp\u00e9cifiques du Smart Effector. Cela permet \u00e9galement d'activer les commandes d'ex\u00e9cution afin d'ajuster les param\u00e8tres du Smart Effector au moment de son ex\u00e9cution. [smart_effector] pin: # Broche connect\u00e9e \u00e0 la broche de sortie de la sonde Z de Smart Effector (broche 5). Notez qu' une # r\u00e9sistance de tirage (pullup) sur la carte n'est g\u00e9n\u00e9ralement pas n\u00e9cessaire. Cependant, si la broche # de sortie est connect\u00e9e \u00e0 la broche de la carte \u00e0 l'aide d'une r\u00e9sistance de tirage, cette r\u00e9sistance doit # \u00eatre de valeur \u00e9lev\u00e9e (par ex. 10K Ohm ou plus). Certaines cartes ont une r\u00e9sistance de tirage de faible # valeur sur l'entr\u00e9e de la sonde Z, ce qui entra\u00eenera probablement un \u00e9tat de sonde toujours d\u00e9clench\u00e9. # Dans ce cas, connectez le Smart Effector \u00e0 une autre broche sur la carte. Ce param\u00e8tre est n\u00e9cessaire. #control_pin: # Broche connect\u00e9e \u00e0 la broche d'entr\u00e9e de contr\u00f4le du Smart Effector (broche 7). Si elle est fournie, # les commandes de programmation de la sensibilit\u00e9 du Smart Effector deviennent disponibles. #probe_accel: # Si elle est d\u00e9finie, limite l'acc\u00e9l\u00e9ration des mouvements de palpage (en mm/sec^2). # Une grande acc\u00e9l\u00e9ration soudaine au d\u00e9but du mouvement de palpage peut provoquer des # d\u00e9clenchements intempestifs de la sonde, surtout si la t\u00eate de l'outil est lourde. # Pour \u00e9viter cela, il peut \u00eatre n\u00e9cessaire de r\u00e9duire l'acc\u00e9l\u00e9ration des mouvements de palpage # via ce param\u00e8tre. #recovery_time: 0.4 # D\u00e9lai entre les mouvements de d\u00e9placement et les mouvements de palpage en secondes. Un # d\u00e9placement rapide avant le palpage peut entra\u00eener un d\u00e9clenchement intempestif de celui-ci. # Cela peut provoquer des erreurs 'Probe triggered prior to movement' si aucun d\u00e9lai n'est d\u00e9fini. # La valeur 0 d\u00e9sactive le d\u00e9lai de r\u00e9cup\u00e9ration. # La valeur par d\u00e9faut est 0,4. #x_offset: #y_offset: # Doivent \u00eatre laiss\u00e9s non d\u00e9finis (ou d\u00e9finis \u00e0 0). z_offset: # Hauteur de d\u00e9clenchement de la sonde. Commencez avec -0,1 (mm), et ajustez plus tard en # utilisant la commande `PROBE_CALIBRATE`. Ce param\u00e8tre doit \u00eatre fourni. #speed: # Vitesse (en mm/s) de l'axe Z lors du palpage. Il est recommand\u00e9 de commencer avec une # vitesse de palpage de 20 mm/s et d'ajuster si n\u00e9cessaire pour am\u00e9liorer la pr\u00e9cision et la # r\u00e9p\u00e9tabilit\u00e9 du d\u00e9clenchement du palpeur. #samples: #sample_retract_dist: #samples_result: #samples_tolerance: #samples_tolerance_retries: #activate_gcode: #deactivate_gcode: #deactivate_on_each_sample: # Voir la section \"sonde\" (probe) pour plus d'informations sur les param\u00e8tres ci-dessus.","title":"[smart_effector]"},{"location":"Config_Reference.html#moteurs-pas-a-pas-et-extrudeurs-additionnels","text":"","title":"Moteurs pas \u00e0 pas et extrudeurs additionnels"},{"location":"Config_Reference.html#stepper_z1","text":"Axes \u00e0 moteurs pas \u00e0 pas multiples. Sur une imprimante de style cart\u00e9sien, le pilote moteur contr\u00f4lant un axe donn\u00e9 peut avoir des blocs de configuration suppl\u00e9mentaires d\u00e9finissant les pilotes moteurs qui doivent \u00eatre mis en marche de concert avec le pilote principal. On peut d\u00e9finir un nombre quelconque de sections avec un suffixe num\u00e9rique commen\u00e7ant \u00e0 1 (par exemple, \"stepper_z1\", \"stepper_z2\", etc.). [stepper_z1] #step_pin: #dir_pin: #enable_pin: #microsteps: #rotation_distanc : # Voir la section \"stepper\" pour la d\u00e9finition des param\u00e8tres ci-dessus. #endstop_pin: # Si une endstop_pin est d\u00e9finie pour le moteur suppl\u00e9mentaire, alors le moteur # se d\u00e9placera \u00e0 l'origine jusqu'\u00e0 ce que la fin de course soit d\u00e9clench\u00e9e. Sinon, le # moteur se d\u00e9placera jusqu'\u00e0 ce que la fin de course du moteur principal de l'axe # soit d\u00e9clench\u00e9e.","title":"[stepper_z1]"},{"location":"Config_Reference.html#extruder1","text":"Dans une imprimante multi-extrudeurs, ajoutez une section d'extrudeur suppl\u00e9mentaire pour chaque extrudeur suppl\u00e9mentaire. Les sections d'extrudeur suppl\u00e9mentaires doivent \u00eatre nomm\u00e9es \"extruder1\", \"extruder2\", \"extruder3\", et ainsi de suite. Voir la section \"extruder\" pour une description des param\u00e8tres disponibles. Voir sample-multi-extruder.cfg pour un exemple de configuration. [extruder1] #step_pin: #dir_pin: #... # Voir la section \"extruder\" pour les param\u00e8tres disponibles pour le pilote de moteur # pas \u00e0 pas et l'\u00e9l\u00e9ment de chauffe. #shared_heater: # Cette option est obsol\u00e8te et ne doit plus \u00eatre utilis\u00e9e.","title":"[extruder1]"},{"location":"Config_Reference.html#dual_carriage","text":"Prise en charge des imprimantes cart\u00e9siennes avec deux chariots sur un seul axe. Le chariot actif est d\u00e9fini par la commande g-code \u00e9tendue SET_DUAL_CARRIAGE. La commande \"SET_DUAL_CARRIAGE CARRIAGE=1\" active le chariot d\u00e9fini dans cette section (CARRIAGE=0 ram\u00e8ne l'activation au chariot principal). Le support du double chariot est g\u00e9n\u00e9ralement combin\u00e9 avec des extrudeuses suppl\u00e9mentaires - la commande SET_DUAL_CARRIAGE est souvent appel\u00e9e en m\u00eame temps que la commande ACTIVATE_EXTRUDER. Veillez \u00e0 garer les chariots pendant la d\u00e9sactivation. Voir sample-idex.cfg pour un exemple de configuration. [dual_carriage] axis: # L'axe sur lequel se trouve ce chariot suppl\u00e9mentaire (soit x, soit y). Ce param\u00e8tre # doit \u00eatre fourni. #step_pin: #dir_pin: #enable_pin: #microsteps: #rotation_distance: #endstop_pin: #position_endstop: #position_min: #position_max: # Voir la section \"stepper\" pour la d\u00e9finition des param\u00e8tres ci-dessus.","title":"[dual_carriage]"},{"location":"Config_Reference.html#extruder_stepper","text":"Support pour des moteurs suppl\u00e9mentaires synchronis\u00e9s avec le mouvement d'une extrudeuse (on peut d\u00e9finir un nombre quelconque de sections avec un pr\u00e9fixe \"extruder_stepper\"). Voir la r\u00e9f\u00e9rence des commandes pour plus d'informations. [extrudeur_stepper my_extra_stepper] extruder: # L'extrudeur sur lequel ce pilote moteur est synchronis\u00e9. Si ce param\u00e8tre est # d\u00e9fini sur une cha\u00eene vide, le pilote ne sera pas synchronis\u00e9 avec un extrudeur. # Ce param\u00e8tre doit \u00eatre fourni. #step_pin: #dir_pin: #enable_pin: #microsteps: #rotation_distance: # Voir la section \"stepper\" pour la d\u00e9finition des param\u00e8tres # ci-dessus.","title":"[extruder_stepper]"},{"location":"Config_Reference.html#manual_stepper","text":"Pilotes de moteur manuels (on peut d\u00e9finir un nombre quelconque de sections avec le pr\u00e9fixe \"manual_stepper\"). Ce sont des pilotes de moteur contr\u00f4l\u00e9s par la commande g-code MANUAL_STEPPER. Par exemple \"MANUAL_STEPPER STEPPER=my_stepper MOVE=10 SPEED=5\". Voir le fichier G-Codes pour une description de la commande MANUAL_STEPPER. Les pilotes de moteur ne sont pas connect\u00e9s \u00e0 la cin\u00e9matique normale de l'imprimante. [manual_stepper my_stepper] #step_pin: #dir_pin: #enable_pin: #microsteps: #rotation_distance: # Voir la section \"stepper\" pour une description de ces param\u00e8tres. #velocity: # D\u00e9finit la vitesse par d\u00e9faut (en mm/s) pour le pilote moteur. Cette valeur # sera utilis\u00e9e si une commande MANUAL_STEPPER ne sp\u00e9cifie pas de param\u00e8tre SPEED # La valeur par d\u00e9faut est 5mm/s. #accel # D\u00e9finit l'acc\u00e9l\u00e9ration par d\u00e9faut (en mm/s^2) pour le pilote moteur Une # acc\u00e9l\u00e9ration de z\u00e9ro n'entra\u00eenera aucune acc\u00e9l\u00e9ration. Cette valeur # sera utilis\u00e9e si une commande MANUAL_STEPPER ne sp\u00e9cifie pas de # param\u00e8tre ACCEL. La valeur par d\u00e9faut est z\u00e9ro. #endstop_pin: # Broche de d\u00e9tection de l'interrupteur de fin de course. Si elle est sp\u00e9cifi\u00e9e, on peut effectuer # des \"mouvements de retour \u00e0 l'origine\" en ajoutant un param\u00e8tre STOP_ON_ENDSTOP aux # commandes de mouvement MANUAL_STEPPER.","title":"[manual_stepper]"},{"location":"Config_Reference.html#elements-chauffants-et-capteurs-personnalises","text":"","title":"\u00c9l\u00e9ments chauffants et capteurs personnalis\u00e9s"},{"location":"Config_Reference.html#verify_heater","text":"V\u00e9rification de l'\u00e9l\u00e9ment chauffant et du capteur de temp\u00e9rature. La v\u00e9rification des \u00e9l\u00e9ments de chauffage est automatiquement activ\u00e9e pour chaque mat\u00e9riel de chauffage configur\u00e9 sur l'imprimante. Utilisez les sections verify_heater pour modifier les param\u00e8tres par d\u00e9faut. [verify_heater heater_config_name] #max_error: 120 # L'erreur de temp\u00e9rature cumul\u00e9e maximale avant de d\u00e9clencher une erreur. # Des valeurs plus petites entra\u00eenent une v\u00e9rification plus stricte et des valeurs # plus grandes permettent un d\u00e9lai plus long avant qu'une erreur ne soit signal\u00e9e. # Plus pr\u00e9cis\u00e9ment, la temp\u00e9rature est inspect\u00e9e une fois par seconde et si elle # est proche de la temp\u00e9rature cible, un \"compteur d'erreurs\" interne est remis # \u00e0 z\u00e9ro; sinon, si la temp\u00e9rature est inf\u00e9rieure \u00e0 la plage cible, le compteur est # augment\u00e9 de la quantit\u00e9 de temp\u00e9rature rapport\u00e9e diff\u00e9rant de cette plage. Si # le compteur d\u00e9passe ce \"max_error\", une erreur est signal\u00e9e. La valeur par # d\u00e9faut est 120. #check_gain_time: # Ceci contr\u00f4le la v\u00e9rification du chauffage durant la chauffe initiale. Des valeurs # plus petites entra\u00eenent une v\u00e9rification plus stricte et des valeurs plus grandes # autorisent un d\u00e9lai plus grand avant qu'une erreur ne soit signal\u00e9e. Sp\u00e9cifiquement, # pendant la chauffe initiale, tant que la temp\u00e9rature de l'\u00e9l\u00e9ment chauffant augmente # durant ce laps de temps (sp\u00e9cifi\u00e9 en secondes), le \"compteur d'erreurs\" interne est # remis \u00e0 z\u00e9ro. La valeur par d\u00e9faut est de 20 secondes pour les extrudeuses et 60 # secondes pour le lit chauffant. #hysteresis: 5 # La diff\u00e9rence de temp\u00e9rature maximale (en Celsius) par rapport \u00e0 une temp\u00e9rature # cible consid\u00e9r\u00e9e comme situ\u00e9e dans la plage de la cible. Ceci contr\u00f4le la v\u00e9rification # de la plage du param\u00e8tre max_error. Il est rare de personnaliser cette valeur. # La valeur par d\u00e9faut est 5. #heating_gain: 2 # La temp\u00e9rature minimale (en Celsius) pour laquelle le chauffage doit progresser # pendant la p\u00e9riode de check_gain_time. Il est rare de personnaliser cette valeur. # La valeur par d\u00e9faut est 2.","title":"[verify_heater]"},{"location":"Config_Reference.html#homing_heaters","text":"Outil de d\u00e9sactivation des \u00e9l\u00e9ments chauffants lors de la prise d'origine ou du palpage d'un axe. [homing_heaters] #steppers: # Une liste de pilotes moteurs s\u00e9par\u00e9s par des virgules qui devraient d\u00e9sactiver les chauffages. # La valeur par d\u00e9faut est de d\u00e9sactiver les chauffages pour tout d\u00e9placement (mise \u00e0 # l'origine / palpage). # Exemple typique : stepper_z #heaters: # Une liste, s\u00e9par\u00e9e par des virgules, d'\u00e9l\u00e9ments chauffants \u00e0 d\u00e9sactiver pendant les d\u00e9placements # (mise \u00e0 l'origine / palpage). La valeur par d\u00e9faut est de d\u00e9sactiver tous les \u00e9l\u00e9ments chauffants. # Exemple typique : extruder, heater_bed","title":"[homing_heaters]"},{"location":"Config_Reference.html#thermistor","text":"Thermistances personnalis\u00e9es (on peut d\u00e9finir un nombre quelconque de sections avec le pr\u00e9fixe \"thermistor\"). Une thermistance personnalis\u00e9e peut \u00eatre utilis\u00e9e dans le champ sensor_type d'une section de configuration de chauffage. (Par exemple, si l'on d\u00e9finit une section \"[thermistor my_thermistor]\", on peut utiliser un \"sensor_type: my_thermistor\" lors de la d\u00e9finition d'un \u00e9l\u00e9ment de chauffe). Veillez \u00e0 placer la section thermistor dans le fichier de configuration avant sa premi\u00e8re utilisation dans une section de chauffage. [thermistor ma_thermistance] #temperature1: #resistance1: #temperature2: #resistance2: #temperature3: #resistance3: # Trois mesures de r\u00e9sistance (en Ohms) aux temp\u00e9ratures donn\u00e9es # (en Celsius). Ces trois mesures seront utilis\u00e9es pour calculer les # coefficients de Steinhart-Hart pour la thermistance. Ces param\u00e8tres # doivent \u00eatre fournis lors de l'utilisation de Steinhart-Hart pour d\u00e9finir la # thermistance. #beta: # Alternativement, on peut d\u00e9finir temp\u00e9rature1, r\u00e9sistance1, et beta # pour d\u00e9finir les param\u00e8tres de la thermistance. Ce param\u00e8tre doit \u00eatre # fourni lorsque l'on utilise \"beta\" pour d\u00e9finir la thermistance.","title":"[thermistor]"},{"location":"Config_Reference.html#adc_temperature","text":"Capteurs de temp\u00e9rature ADC personnalis\u00e9s (on peut d\u00e9finir un nombre quelconque de sections avec un pr\u00e9fixe \"adc_temperature\"). Cela permet de d\u00e9finir un capteur de temp\u00e9rature personnalis\u00e9 mesurant une tension sur une broche de convertisseur analogique-num\u00e9rique (ADC) et utilise une interpolation lin\u00e9aire entre un ensemble de mesures configur\u00e9es de temp\u00e9rature/tension (ou de temp\u00e9rature/r\u00e9sistance) pour d\u00e9terminer la temp\u00e9rature. Le capteur r\u00e9sultant peut \u00eatre utilis\u00e9 comme un type de capteur dans une section de chauffage. (Par exemple, si l'on d\u00e9finit une section \"[adc_temperature my_sensor]\", on peut utiliser un \"sensor_type : my_sensor\" lors de la d\u00e9finition d'un \u00e9l\u00e9ment chauffant). Veillez \u00e0 placer la section du capteur dans le fichier de configuration avant sa premi\u00e8re utilisation dans une section de chauffage. [adc_temperature mon_capteur] #temperature1: #voltage1: #temperature2: #voltage2: #... # Un ensemble de temp\u00e9ratures (en Celsius) et de tensions (en Volts) \u00e0 utiliser comme # r\u00e9f\u00e9rence lors de la conversion d'une temp\u00e9rature. Une section de chauffage utilisant # ce capteur peut \u00e9galement sp\u00e9cifier les param\u00e8tres adc_voltage et voltage_offset # pour d\u00e9finir la tension ADC (voir la section \"Amplificateurs communs de temp\u00e9rature\" # pour plus de d\u00e9tails). Au moins deux mesures doivent \u00eatre fournies. #temperature1: #resistance1: #temperature2: #resistance2: #... # Alternativement, on peut indiquer un ensemble de temp\u00e9ratures (en Celsius) # et de r\u00e9sistance (en Ohms) \u00e0 utiliser comme r\u00e9f\u00e9rence lors de la conversion d'une # temp\u00e9rature. Une section de chauffage utilisant ce capteur peut \u00e9galement sp\u00e9cifier un # param\u00e8tre pullup_resistor (voir la section \"extrudeuse\" pour plus de d\u00e9tails). Au # moins deux mesures doivent \u00eatre fournies.","title":"[adc_temperature]"},{"location":"Config_Reference.html#heater_generic","text":"\u00c9l\u00e9ments de chauffe g\u00e9n\u00e9riques (on peut d\u00e9finir un nombre quelconque de sections avec le pr\u00e9fixe \"heater_generic\"). Ces \u00e9l\u00e9ments de chauffe se comportent de la m\u00eame mani\u00e8re que les \u00e9l\u00e9ments de chauffe standards (extrudeuses, lits chauffants). Utilisez la commande SET_HEATER_TEMPERATURE (voir G-Codes pour plus de d\u00e9tails) pour d\u00e9finir la temp\u00e9rature cible. [heater_generic my_generic_heater] #gcode_id: # L'identifiant \u00e0 utiliser pour signaler la temp\u00e9rature dans la commande M105. # Ce param\u00e8tre doit \u00eatre fourni. #heater_pin: #max_power: #sensor_type: #sensor_pin: #smooth_time: #control: #pid_Kp: #pid_Ki: #pid_Kd: #pwm_cycle_time: #min_temp: #max_temp: # Voir la section \"extruder\" pour la d\u00e9finition des param\u00e8tres # ci-dessus.","title":"[heater_generic]"},{"location":"Config_Reference.html#temperature_sensor","text":"Capteurs de temp\u00e9rature g\u00e9n\u00e9riques. On peut d\u00e9finir un nombre quelconque de capteurs de temp\u00e9rature suppl\u00e9mentaires signal\u00e9s par la commande M105. [temperature_sensor my_sensor] #sensor_type: #sensor_pin: #min_temp: #max_temp: # Voir la section \"extrudeuse\" pour la d\u00e9finition des param\u00e8tres # ci-dessus. #gcode_id: # Voir la section \"heater_generic\" pour la d\u00e9finition de ce # param\u00e8tre.","title":"[temperature_sensor]"},{"location":"Config_Reference.html#capteurs-de-temperature","text":"Klipper inclut les d\u00e9finitions de nombreux types de capteurs de temp\u00e9rature. Ces capteurs peuvent \u00eatre utilis\u00e9s dans n'importe quelle section de la configuration n\u00e9cessitant un capteur de temp\u00e9rature (comme une section [extruder] ou [heater_bed] ).","title":"Capteurs de temp\u00e9rature"},{"location":"Config_Reference.html#thermistances-communes","text":"Thermistances communes. Les param\u00e8tres suivants sont disponibles dans les sections de chauffage utilisant l'un de ces capteurs. sensor_type: # Un parmi \"EPCOS 100K B57560G104F\", \"ATC Semitec 104GT-2\", # \"ATC Semitec 104NT-4-R025H42G\", \"Generic 3950\", # \"Honeywell 100K 135-104LAG-J01\", \"NTC 100K MGB18-104F39050L32\", # \"SliceEngineering 450\", ou \"TDK NTCG104LH104JT1\". sensor_pin: # Broche d'entr\u00e9e analogique connect\u00e9e \u00e0 la thermistance. Ce param\u00e8tre doit # \u00eatre fourni. #pullup_resistor: 4700 # La r\u00e9sistance (en ohms) de tirage (pullup) reli\u00e9e \u00e0 la thermistance. # La valeur par d\u00e9faut est 4700 ohms. #inline_resistor: 0 # La r\u00e9sistance (en ohms) d'une r\u00e9sistance suppl\u00e9mentaire (ne variant pas en fonction de # la chaleur) plac\u00e9e en ligne avec la thermistance. Il est rare de la d\u00e9finir. # La valeur par d\u00e9faut est 0 ohms.","title":"Thermistances communes"},{"location":"Config_Reference.html#amplificateurs-de-temperature-courants","text":"Amplificateurs de temp\u00e9rature courants. Les param\u00e8tres suivants sont disponibles dans les sections de chauffage utilisant l'un de ces capteurs. sensor_type: # Un parmi \"PT100 INA826\", \"AD595\", \"AD597\", \"AD8494\", \"AD8495\", # \"AD8496\", ou \"AD8497\". sensor_pin: # Broche d'entr\u00e9e analogique connect\u00e9e au capteur. Ce param\u00e8tre doit \u00eatre # fourni. #adc_voltage: 5.0 # La tension de comparaison ADC (en Volts). La valeur par d\u00e9faut est de 5 volts. #voltage_offset: 0 # D\u00e9calage de la tension de l'ADC (en Volts). La valeur par d\u00e9faut est 0.","title":"Amplificateurs de temp\u00e9rature courants"},{"location":"Config_Reference.html#capteur-pt1000-directement-connecte","text":"Capteur PT1000 connect\u00e9 en direct. Les param\u00e8tres suivants sont disponibles dans les sections chauffage utilisant ces capteurs. sensor_type : PT1000 sensor_pin: # Broche d'entr\u00e9e analogique connect\u00e9e au capteur. Ce param\u00e8tre doit \u00eatre # fourni. #pullup_resistor: 4700 # La r\u00e9sistance (en ohms) de tirage (pullup) reli\u00e9e au capteur. La valeur par # d\u00e9faut est 4700 ohms.","title":"Capteur PT1000 directement connect\u00e9"},{"location":"Config_Reference.html#capteurs-de-temperature-maxxxxxx","text":"Capteurs MAXxxxxx \u00e0 interface p\u00e9riph\u00e9rique s\u00e9rie (SPI) bas\u00e9s sur la temp\u00e9rature. Les param\u00e8tres suivants sont disponibles dans les sections de chauffage qui utilisent l'un de ces types de capteurs. sensor_type : # Un parmi les types suivants : \"MAX6675\", \"MAX31855\", \"MAX31856\" ou \"MAX31865\". sensor_pin: # La broche de s\u00e9lection de puce pour la puce du capteur. Ce param\u00e8tre doit \u00eatre # fourni. #spi_speed: 4000000 # La vitesse SPI (en hz) \u00e0 utiliser lors de la communication avec la puce. # La valeur par d\u00e9faut est 4000000. #spi_bus: #spi_software_sclk_pin: #spi_software_mosi_pin: #spi_software_miso_pin: # Voir la section \"param\u00e8tres SPI communs\" pour une description des # param\u00e8tres ci-dessus. #tc_type: K #tc_use_50Hz_filter: False #tc_averaging_count: 1 # Les param\u00e8tres ci-dessus contr\u00f4lent les param\u00e8tres des capteurs des puces MAX31856 # Les valeurs par d\u00e9faut de chaque param\u00e8tre sont indiqu\u00e9es \u00e0 c\u00f4t\u00e9 du nom du param\u00e8tre # dans la liste ci-dessus. #rtd_nominal_r: 100 #rtd_reference_r: 430 #rtd_num_of_wires: 2 #rtd_use_50Hz_filter: False # Les param\u00e8tres ci-dessus contr\u00f4lent les param\u00e8tres des capteurs des puces MAX31865 # Les valeurs par d\u00e9faut de chaque param\u00e8tre sont indiqu\u00e9es \u00e0 c\u00f4t\u00e9 du nom du param\u00e8tre # dans la liste ci-dessus.","title":"Capteurs de temp\u00e9rature MAXxxxxx"},{"location":"Config_Reference.html#capteurs-de-temperature-bmp280bme280bme680","text":"Capteurs environnementaux BMP280/BME280/BME680 \u00e0 interface \u00e0 deux fils (I2C). Notez que ces capteurs ne sont pas destin\u00e9s \u00e0 \u00eatre utilis\u00e9s avec des extrudeurs et des lits chauffants, mais plut\u00f4t pour surveiller la temp\u00e9rature ambiante (C), la pression (hPa), l'humidit\u00e9 relative et, dans le cas du BME680, le niveau de gaz. Voir sample-macros.cfg pour un gcode_macro pouvant \u00eatre utilis\u00e9 pour signaler la pression et l'humidit\u00e9 en plus de la temp\u00e9rature. sensor_type: BME280 #i2c_address: # La valeur par d\u00e9faut est 118 (0x76). Certains capteurs BME280 ont une adresse de 119 # (0x77). #i2c_mcu: #i2c_bus: #i2c_speed: # Voir la section \"param\u00e8tres I2C communs\" pour une description des # param\u00e8tres ci-dessus.","title":"Capteurs de temp\u00e9rature BMP280/BME280/BME680"},{"location":"Config_Reference.html#capteur-htu21d","text":"Capteur d'environnement de la famille HTU21D \u00e0 interface \u00e0 deux fils (I2C). Notez que ce capteur n'est pas destin\u00e9 \u00e0 \u00eatre utilis\u00e9 avec les extrudeuses et les lits chauffants, mais plut\u00f4t \u00e0 surveiller la temp\u00e9rature ambiante (C) et l'humidit\u00e9 relative. Voir sample-macros.cfg pour un gcode_macro utilisable permettant d'indiquer l'humidit\u00e9 en plus de la temp\u00e9rature. sensor_type: # Doit \u00eatre \"HTU21D\" , \"SI7013\", \"SI7020\", \"SI7021\" ou \"SHT21\". #i2c_address: # La valeur par d\u00e9faut est 64 (0x40). #i2c_mcu: #i2c_bus: #i2c_speed: # Voir la section \"param\u00e8tres I2C communs\" pour une description des # param\u00e8tres ci-dessus. #htu21d_hold_master: # Si le capteur peut maintenir le tampon I2C durant la lecture. Si True, aucune autre # communication par bus ne peut \u00eatre effectu\u00e9e durant la lecture en cours. # La valeur par d\u00e9faut est False. #htu21d_resolution: # La r\u00e9solution de lecture de la temp\u00e9rature et de l'humidit\u00e9. # Les valeurs valides sont : # 'TEMP14_HUM12' -> 14 bits pour la temp\u00e9rature et 12 bits pour l'humidit\u00e9. # 'TEMP13_HUM10' -> 13 bits pour la temp\u00e9rature et 10 bits pour l'humidit\u00e9. # 'TEMP12_HUM08' -> 12 bits pour la temp\u00e9rature et 08 bits pour l'humidit\u00e9 # 'TEMP11_HUM11' -> 11 bits pour la temp\u00e9rature et 11 bits pour l'humidit\u00e9 # La valeur par d\u00e9faut est \"TEMP11_HUM11\" #htu21d_report_time: # Intervalle en secondes entre les lectures. La valeur par d\u00e9faut est 30","title":"Capteur HTU21D"},{"location":"Config_Reference.html#capteur-de-temperature-lm75","text":"Capteurs de temp\u00e9rature LM75/LM75A connect\u00e9s en deux fils (I2C). Ces capteurs ont une gamme de -55~125 \u00b0C, et sont donc utilisables par exemple pour la surveillance de la temp\u00e9rature d'une chambre. Ils peuvent aussi fonctionner comme de simples contr\u00f4leurs de ventilateurs/\u00e9l\u00e9ments chauffants. sensor_type: LM75 #i2c_address: # La valeur par d\u00e9faut est 72 (0x48). La plage normale est 72-79 (0x48-0x4F), les 3 # bits de poids faible de l'adresse sont configur\u00e9s via des broches sur la puce # (g\u00e9n\u00e9ralement avec des cavaliers ou c\u00e2bl\u00e9s). #i2c_mcu: #i2c_bus: #i2c_speed: # Voir la section \"param\u00e8tres I2C communs\" pour une description des # param\u00e8tres ci-dessus. #lm75_report_time: # Intervalle en secondes entre les lectures. La valeur par d\u00e9faut est 0.8, avec un # minimum de 0.5.","title":"Capteur de temp\u00e9rature LM75"},{"location":"Config_Reference.html#capteur-de-temperature-integre-au-microcontroleur","text":"Les micro-contr\u00f4leurs atsam, atsamd, et stm32 poss\u00e8dent un capteur de temp\u00e9rature interne. On peut utiliser le capteur \"temperature_mcu\" pour surveiller ces temp\u00e9ratures. sensor_type: temperature_mcu #sensor_mcu: mcu # Le micro-contr\u00f4leur \u00e0 lire. La valeur par d\u00e9faut est \"mcu\". #sensor_temperature1: #sensor_adc1: # Sp\u00e9cifiez les deux param\u00e8tres ci-dessus (une temp\u00e9rature en Celsius et une valeur d' ADC sous # forme de flottant entre 0,0 et 1,0) pour calibrer la temp\u00e9rature du microcontr\u00f4leur. Cela peut # am\u00e9liorer la pr\u00e9cision de la temp\u00e9rature rapport\u00e9e sur certaines puces. Une fa\u00e7on typique d'obtenir # ces informations d'\u00e9talonnage est de couper compl\u00e8tement l'alimentation de l'imprimante pendant # quelques heures (afin de s'assurer qu'elle est \u00e0 la temp\u00e9rature ambiante), puis de la remettre sous # tension et d'utiliser la fonction QUERY_ADC pour obtenir une mesure ADC. # Utilisez un autre capteur de temp\u00e9rature sur l'imprimante pour trouver la temp\u00e9rature ambiante # correspondante. La valeur par d\u00e9faut est d'utiliser les donn\u00e9es d'\u00e9talonnage d'usine du microcontr\u00f4leur # (le cas \u00e9ch\u00e9ant) ou les valeurs nominales de la sp\u00e9cification du microcontr\u00f4leur. #sensor_temperature2: #sensor_adc2: # Si sensor_temperature1/sensor_adc1 est sp\u00e9cifi\u00e9, on peut \u00e9galement sp\u00e9cifier les donn\u00e9es # d'\u00e9talonnage de sensor_temperature2/sensor_adc2. En proc\u00e9dant ainsi on peut fournir des # informations calibr\u00e9es sur la \"pente de temp\u00e9rature\". La valeur par d\u00e9faut est d'utiliser les donn\u00e9es # d'\u00e9talonnage d'usine sur le microcontr\u00f4leur (le cas \u00e9ch\u00e9ant) ou les valeurs nominales de la # sp\u00e9cification du microcontr\u00f4leur.","title":"Capteur de temp\u00e9rature int\u00e9gr\u00e9 au microcontr\u00f4leur"},{"location":"Config_Reference.html#capteur-de-temperature-de-lhote","text":"Temp\u00e9rature de la machine (par exemple Raspberry Pi) ex\u00e9cutant le logiciel h\u00f4te. sensor_type: temperature_host #sensor_path: # Le chemin d'acc\u00e8s au fichier syst\u00e8me de temp\u00e9rature. La valeur par d\u00e9faut est # \" /sys/class/thermal/thermal_zone0/temp \" qui est le fichier syst\u00e8me de # temp\u00e9rature sur un ordinateur Raspberry Pi.","title":"Capteur de temp\u00e9rature de l'h\u00f4te"},{"location":"Config_Reference.html#capteur-de-temperature-ds18b20","text":"Le DS18B20 est un capteur de temp\u00e9rature num\u00e9rique \u00e0 1 fil (w1). Notez que ce capteur n'est pas destin\u00e9 \u00e0 \u00eatre utilis\u00e9 avec les extrudeurs et les lits chauffants, mais plut\u00f4t pour surveiller la temp\u00e9rature ambiante (C). Ces capteurs ont une port\u00e9e allant jusqu'\u00e0 125 \u00b0C et sont donc utilisables pour la surveillance de la temp\u00e9rature d'un caisson par exemple. Ils peuvent \u00e9galement fonctionner comme de simples contr\u00f4leurs de ventilateurs/\u00e9l\u00e9ments chauffants. Les capteurs DS18B20 ne sont support\u00e9s que par un \"mcu h\u00f4te\", par exemple le Raspberry Pi. Le module w1-gpio du noyau Linux doit \u00eatre install\u00e9. sensor_type: DS18B20 serial_no: # Chaque dispositif \u00e0 1-wire poss\u00e8de un num\u00e9ro de s\u00e9rie unique utilis\u00e9 pour l'identifier, # g\u00e9n\u00e9ralement au format 28-031674b175ff. Ce param\u00e8tre doit \u00eatre fourni. # Les p\u00e9riph\u00e9riques 1-wire connect\u00e9s peuvent \u00eatre list\u00e9s \u00e0 l'aide de la commande Linux suivante : # ls /sys/bus/w1/devices/ #ds18_report_time: # Intervalle en secondes entre les lectures. La valeur par d\u00e9faut est de 3,0, avec un minimum de 1,0. #sensor_mcu: # Le micro-contr\u00f4leur \u00e0 lire. Doit \u00eatre le host_mcu","title":"Capteur de temp\u00e9rature DS18B20"},{"location":"Config_Reference.html#ventilateurs","text":"","title":"Ventilateurs"},{"location":"Config_Reference.html#fan","text":"Ventilateur de refroidissement de la pi\u00e8ce. [fan] pin: # Broche de sortie contr\u00f4lant le ventilateur. Ce param\u00e8tre doit \u00eatre fourni. #max_power: 1.0 # La puissance maximale (exprim\u00e9e en tant que valeur comprise entre 0,0 et 1,0) \u00e0 laquelle # r\u00e9gler la broche. La valeur 1.0 permet de r\u00e9gler la broche enti\u00e8rement activ\u00e9e pendant de # longues p\u00e9riodes, tandis qu'une valeur de 0,5 permet \u00e0 la broche de n'\u00eatre activ\u00e9e que # durant la moiti\u00e9 du temps au maximum. Ce param\u00e8tre peut \u00eatre utilis\u00e9 pour limiter la # puissance totale de sortie (sur des p\u00e9riodes prolong\u00e9es) du ventilateur. # Si cette valeur est inf\u00e9rieure \u00e0 1,0, les demandes de vitesse du ventilateur seront mises \u00e0 # l'\u00e9chelle entre z\u00e9ro et max_power (par exemple, si la puissance maximale est de 0,9 et # qu'une vitesse de 80 % est demand\u00e9e, la puissance du ventilateur sera r\u00e9gl\u00e9e \u00e0 72 %. # La valeur par d\u00e9faut est 1.0. #shutdown_speed: 0 # La vitesse souhait\u00e9e du ventilateur (exprim\u00e9e comme une valeur de 0,0 \u00e0 1,0) si # le logiciel du microcontr\u00f4leur passe dans un \u00e9tat d'erreur. La valeur par d\u00e9faut # est 0. #cycle_time: 0.010 # La dur\u00e9e (en secondes) de chaque cycle d'alimentation PWM du ventilateur. Il est # recommand\u00e9 que cette dur\u00e9e soit de 10 millisecondes ou plus si vous utilisez un PWM logiciel. # La valeur par d\u00e9faut est de 0,010 seconde. #hardware_pwm: False # Activez ceci pour utiliser le PWM mat\u00e9riel au lieu du PWM logiciel. La plupart des ventilateurs # ne fonctionnent pas correctement avec le PWM mat\u00e9riel, il n'est donc pas recommand\u00e9 # d'activer cette option \u00e0 moins qu'il n'y ait une exigence \u00e9lectrique pour obtenir une tr\u00e8s haute # vitesse. Lorsque vous utilisez le PWM mat\u00e9riel, le temps de cycle r\u00e9el est contraint par la mise # en \u0153uvre et peut \u00eatre significativement diff\u00e9rent du temps de cycle demand\u00e9. # La valeur par d\u00e9faut est False. #kick_start_time: 0.100 # Dur\u00e9e (en secondes) de fonctionnement du ventilateur \u00e0 pleine vitesse, soit lors de sa premi\u00e8re # activation soit lors d'une augmentation de plus de 50% (pour faire tourner le ventilateur). # La valeur par d\u00e9faut est de 0,100 seconde. #off_below: 0.0 # La vitesse d'entr\u00e9e minimale qui alimentera le ventilateur (exprim\u00e9e comme une valeur # comprise entre 0,0 et 1,0). Quand une vitesse inf\u00e9rieure \u00e0 off_below est demand\u00e9e le ventilateur # sera d\u00e9sactiv\u00e9. Ce r\u00e9glage peut \u00eatre utilis\u00e9 pour \u00e9viter que le ventilateur ne cale et pour # garantir que les d\u00e9marrages sont efficaces. # La valeur par d\u00e9faut est 0.0. # # Ce param\u00e8tre doit \u00eatre recalibr\u00e9 chaque fois que max_power est ajust\u00e9. # Pour calibrer ce param\u00e8tre, commencez avec off_below r\u00e9gl\u00e9 sur 0.0 et ventilateur tournant. Diminuez # progressivement la vitesse du ventilateur afin de d\u00e9terminer la vitesse d'entr\u00e9e la plus faible entra\u00eenant # le ventilateur de mani\u00e8re fiable sans d\u00e9crochage. R\u00e9glez off_below au rapport cyclique correspondant # \u00e0 cette valeur (par exemple, 12% -> 0,12) ou l\u00e9g\u00e8rement plus. #tachometer_pin: # Broche d'entr\u00e9e tachym\u00e9trique de surveillance de la vitesse du ventilateur. Un pullup est g\u00e9n\u00e9ralement # n\u00e9cessaire. Ce param\u00e8tre est facultatif. #tachometer_ppr: 2 # Lorsque tachometer_pin est sp\u00e9cifi\u00e9, il s'agit du nombre d'impulsions par r\u00e9volution du signal # tachym\u00e9trique. Pour un ventilateur BLDC, c'est normalement la moiti\u00e9 du nombre de p\u00f4les. # La valeur par d\u00e9faut est 2. #tachometer_poll_interval: 0.0015 # Lorsque tachometer_pin est sp\u00e9cifi\u00e9, il s'agit de la p\u00e9riode d'interrogation de la broche tachym\u00e9trique, # en secondes. La valeur par d\u00e9faut est 0.0015, ce qui est suffisamment rapide pour des ventilateurs de # moins de 10000 RPM \u00e0 2 PPR. Cette valeur doit \u00eatre inf\u00e9rieure \u00e0 30/(tachometer_ppr*rpm), avec une # certaine marge, o\u00f9 rpm est la vitesse maximale (en RPM) du ventilateur. #enable_pin: # Broche optionnelle pour d'activation de l'alimentation du ventilateur. Cela peut \u00eatre utile pour les # ventilateurs avec des entr\u00e9es PWM d\u00e9di\u00e9es. Certains de ces ventilateurs restent allum\u00e9s m\u00eame \u00e0 0 % # de PWM. Dans ce cas, la broche PWM peut \u00eatre utilis\u00e9e normalement et, par exemple, un FET commut\u00e9 # \u00e0 la masse (broche de ventilateur standard) peut \u00eatre utilis\u00e9 pour contr\u00f4ler l'alimentation du ventilateur.","title":"[fan]"},{"location":"Config_Reference.html#heater_fan","text":"Ventilateurs de chauffage (on peut d\u00e9finir un nombre quelconque de sections avec le pr\u00e9fixe \"heater_fan\"). Un \"ventilateur de chauffage\" est un ventilateur activ\u00e9 lorsque le chauffage qui lui est associ\u00e9 est actif. Par d\u00e9faut, un heater_fan a une vitesse d'arr\u00eat \u00e9gale \u00e0 la puissance maximale. [heater_fan my_nozzle_fan] #pin: #max_power: #shutdown_speed: #cycle_time: #hardware_pwm: #kick_start_time: #off_below: #tachometer_pin: #tachometer_ppr: #tachometer_poll_interval: #enable_pin: # Voir la section \"fan\" pour une description des param\u00e8tres ci-dessus. #heater: extruder # Nom de la section de configuration d\u00e9finissant le chauffage auquel ce ventilateur est associ\u00e9. # Si une liste de noms d'\u00e9l\u00e9ments chauffants s\u00e9par\u00e9s par des virgules est fournie ici, le # ventilateur sera activ\u00e9 lorsque l'un des chauffages donn\u00e9s est activ\u00e9. # La valeur par d\u00e9faut est \"extruder\". #heater_temp: 50.0 # Temp\u00e9rature (en Celsius) en dessous de laquelle l'\u00e9l\u00e9ment chauffant doit descendre pour que # le ventilateur soit d\u00e9sactiv\u00e9. La valeur par d\u00e9faut est 50 \u00b0C. #fan_speed: 1.0 # La vitesse du ventilateur (exprim\u00e9e sous la forme d'une valeur comprise entre 0,0 et 1,0) \u00e0 # laquelle le ventilateur sera r\u00e9gl\u00e9 lorsque l'\u00e9l\u00e9ment chauffant qui lui est associ\u00e9 est activ\u00e9. # La valeur par d\u00e9faut est 1.0","title":"[heater_fan]"},{"location":"Config_Reference.html#controller_fan","text":"Ventilateur de refroidissement du contr\u00f4leur (on peut d\u00e9finir un nombre quelconque de sections avec le pr\u00e9fixe \"controller_fan\"). Un \"ventilateur de contr\u00f4leur\" est un ventilateur activ\u00e9 chaque fois que l'\u00e9l\u00e9ment chauffant ou le pilote pas \u00e0 pas qui lui est associ\u00e9 est actif. Le ventilateur s'arr\u00eatera chaque fois qu'un idle_timeout sera atteint afin de garantir qu'aucune surchauffe ne se produise apr\u00e8s la d\u00e9sactivation d'un composant surveill\u00e9. [controller_fan my_controller_fan] #pin: #max_power: #shutdown_speed: #cycle_time: #hardware_pwm: #kick_start_time: #off_below: #tachometer_pin: #tachometer_ppr: #tachometer_poll_interval: #enable_pin: # Voir la section \"fan\" pour une description des param\u00e8tres ci-dessus. #fan_speed: 1.0 # Vitesse du ventilateur (exprim\u00e9e comme une valeur de 0,0 \u00e0 1,0) \u00e0 laquelle celui-ci # sera r\u00e9gl\u00e9 lorsqu'un chauffage ou un pilote pas \u00e0 pas est actif. # La valeur par d\u00e9faut est 1.0 #idle_timeout: # Dur\u00e9e (en secondes) apr\u00e8s activit\u00e9 d'un pilote pas \u00e0 pas ou d'un \u00e9l\u00e9ment chauffant # pour laquelle le ventilateur doit continuer de fonctionner. La valeur par d\u00e9faut # est de 30 secondes. #idle_speed: # Vitesse du ventilateur (exprim\u00e9e comme une valeur de 0,0 et 1,0) \u00e0 laquelle le r\u00e9gler # lors de l'activit\u00e9 d'une chauffe ou d'un pilote pas \u00e0 pas avant que le d\u00e9lai d'attente # idle_timeout ne soit atteint. La valeur par d\u00e9faut est fan_speed. #heater: #stepper : # Nom de la section de configuration d\u00e9finissant l'\u00e9l\u00e9ment chauffant/pilote auquel ce ventilateur # est associ\u00e9. Si une liste s\u00e9par\u00e9e par des virgules de noms d'\u00e9l\u00e9ments chauffants/pilotes est # fournie ici, le ventilateur s'activera lorsque l'un des \u00e9l\u00e9ments chauffants/pilotes donn\u00e9s est activ\u00e9. # Le chauffage par d\u00e9faut est \"extruder\", le pilote par d\u00e9faut est tous.","title":"[controller_fan]"},{"location":"Config_Reference.html#temperature_fan","text":"Ventilateurs de refroidissement d\u00e9clench\u00e9s en fonction de la temp\u00e9rature (on peut d\u00e9finir un nombre quelconque de sections avec le pr\u00e9fixe \"temperature_fan\"). Un \"ventilateur de temp\u00e9rature\" est un ventilateur activ\u00e9 lorsque le capteur qui lui est associ\u00e9 est au-dessus d'une temp\u00e9rature d\u00e9finie. Par d\u00e9faut, un ventilateur de temp\u00e9rature a une vitesse d'arr\u00eat \u00e9gale \u00e0 la puissance maximale. Voir la r\u00e9f\u00e9rence des commandes pour plus d'informations. [temperature_fan my_temp_fan] #pin: #max_power: #shutdown_speed: #cycle_time: #hardware_pwm: #kick_start_time: #off_below: #tachometer_pin: #tachometer_ppr: #tachometer_poll_interval: #enable_pin: # Voir la section \"ventilateur\" pour une description des param\u00e8tres ci-dessus. #sensor_type: #sensor_pin: #control: #max_delta: #min_temp: #max_temp: # Voir la section \"extrudeuse\" pour une description des param\u00e8tres ci-dessus. #pid_Kp: #pid_Ki: #pid_Kd: # Les param\u00e8tres proportionnels (pid_Kp), int\u00e9graux (pid_Ki), et d\u00e9riv\u00e9s (pid_Ki) # du syst\u00e8me de contr\u00f4le par r\u00e9troaction PID. Klipper \u00e9value les param\u00e8tres PID # avec la formule g\u00e9n\u00e9rale suivante : # fan_pwm = max_power - (Kp*e + Ki*integral(e) - Kd*derivative(e)) / 255 # O\u00f9 \"e\" est \"temp\u00e9rature_cible - temp\u00e9rature_mesur\u00e9e\" et # \"fan_pwm\" est le d\u00e9bit du ventilateur demand\u00e9, 0,0 correspondant \u00e0 un arr\u00eat complet # et 1,0 correspond \u00e0 un fonctionnement \u00e0 plein r\u00e9gime. Les param\u00e8tres pid_Kp, pid_Ki, # et pid_Kd doivent \u00eatre fournis lorsque l'algorithme de contr\u00f4le PID est activ\u00e9. #pid_deriv_time: 2.0 # Une dur\u00e9e (en secondes) sur laquelle lisser les mesures de temp\u00e9rature lors de # l'utilisation de l'algorithme de contr\u00f4le PID. Cela peut r\u00e9duire l'impact du bruit de # mesure. La valeur par d\u00e9faut est de 2 secondes. #target_temp: 40.0 # Une temp\u00e9rature (en Celsius) qui sera la temp\u00e9rature cible. # La valeur par d\u00e9faut est 40 degr\u00e9s. #max_speed: 1.0 # La vitesse du ventilateur (exprim\u00e9e comme une valeur de 0,0 \u00e0 1,0) \u00e0 laquelle r\u00e9gler # le ventilateur lorsque la temp\u00e9rature du capteur d\u00e9passera la valeur d\u00e9finie. # La valeur par d\u00e9faut est 1.0. #min_speed: 0.3 # Vitesse minimale du ventilateur (exprim\u00e9e sous forme d'une valeur comprise entre 0,0 # et 1,0) \u00e0 laquelle r\u00e9gler le ventilateur pour les ventilateurs \u00e0 temp\u00e9rature PID. # La valeur par d\u00e9faut est 0,3. #gcode_id: # S'il est d\u00e9fini, la temp\u00e9rature sera signal\u00e9e dans les requ\u00eates M105 en utilisant l'identifiant # d'id donn\u00e9. La valeur par d\u00e9faut est de ne pas rapporter la temp\u00e9rature via M105.","title":"[temperature_fan]"},{"location":"Config_Reference.html#fan_generic","text":"Ventilateur command\u00e9 manuellement (on peut d\u00e9finir un nombre quelconque de sections avec le pr\u00e9fixe \"fan_generic\"). La vitesse d'un ventilateur command\u00e9 manuellement est r\u00e9gl\u00e9e avec la commande SET_FAN_SPEED commandes G-Code . [fan_generic extruder_partfan] #pin: #max_power: #shutdown_speed: #cycle_time: #hardware_pwm: #kick_start_time: #off_below: #tachometer_pin: #tachometer_ppr: #tachometer_poll_interval: #enable_pin: # Voir la section \"ventilateur\" pour une description des param\u00e8tres ci-dessus.","title":"[fan_generic]"},{"location":"Config_Reference.html#leds","text":"","title":"LEDs"},{"location":"Config_Reference.html#led","text":"Prise en charge des LEDs (et des bandes de LEDs) contr\u00f4l\u00e9es par les broches PWM du microcontr\u00f4leur (on peut d\u00e9finir un nombre quelconque de sections avec le pr\u00e9fixe \"led\"). Voir la r\u00e9f\u00e9rence de la commande pour plus d'informations. [led my_led] #red_pin: #green_pin: #blue_pin: #white_pin: # La broche contr\u00f4lant la couleur de la LED donn\u00e9e. Au moins un des param\u00e8tres ci-dessus # doit \u00eatre fourni. #cycle_time: 0.010 # Dur\u00e9e (en secondes) par cycle PWM. Il est recommand\u00e9 # que ce soit 10 millisecondes ou plus lorsque l'on utilise un PWM logiciel. # La valeur par d\u00e9faut est de 0,010 seconde. #hardware_pwm: False # Activez ceci pour utiliser le PWM mat\u00e9riel au lieu du PWM logiciel. Lors de # l'utilisation du PWM mat\u00e9riel, le temps de cycle r\u00e9el est contraint par # l'impl\u00e9mentation et peut \u00eatre significativement diff\u00e9rent du # cycle_time demand\u00e9. La valeur par d\u00e9faut est False. #initial_RED: 0.0 #initial_GREEN: 0.0 #initial_BLUE: 0.0 #initial_WHITE: 0.0 # D\u00e9finit la couleur initiale de la LED. Chaque valeur doit \u00eatre comprise entre 0.0 et # 1.0. La valeur par d\u00e9faut pour chaque couleur est 0.","title":"[led]"},{"location":"Config_Reference.html#neopixel","text":"Prise en charge des LED neopixel (alias WS2812) (on peut d\u00e9finir un nombre quelconque de sections avec le pr\u00e9fixe \"neopixel\"). Voir la r\u00e9f\u00e9rence de commande pour plus d'informations. Notez que l'impl\u00e9mentation du mcu linux ne supporte pas actuellement les neopixels directement connect\u00e9s. La conception actuelle utilisant l'interface du noyau Linux ne permet pas ce sc\u00e9nario car l'interface GPIO du noyau n'est pas assez rapide pour fournir les taux d'impulsion requis. [neopixel my_neopixel] pin: # La broche connect\u00e9e au neopixel. Ce param\u00e8tre doit \u00eatre # fourni. #chain_count: # Le nombre de puces Neopixel connect\u00e9es en \"cha\u00eene\" \u00e0 la broche fournie. # La valeur par d\u00e9faut est 1 (ce qui indique qu'un seul Neopixel est connect\u00e9 \u00e0 la broche). #color_order: GRB # D\u00e9finit l'ordre des pixels requis par le mat\u00e9riel LED (en utilisant une cha\u00eene # contenant les lettres R, G, B, W avec W en option). Alternativement, il peut s'agir d'une liste # d'ordres de pixels s\u00e9par\u00e9s par des virgules - un pour chaque LED de la cha\u00eene. # La valeur par d\u00e9faut est GRB. #initial_RED: 0.0 #initial_GREEN: 0.0 #initial_BLUE: 0.0 #initial_WHITE: 0.0 # Voir la section \"led\" pour des informations sur ces param\u00e8tres.","title":"[neopixel]"},{"location":"Config_Reference.html#dotstar","text":"Prise en charge des LEDs Dotstar (alias APA102) (on peut d\u00e9finir un nombre quelconque de sections avec le pr\u00e9fixe \"dotstar\"). Voir la r\u00e9f\u00e9rence de commande pour plus d'informations. [dotstar my_dotstar] data_pin: # La broche connect\u00e9e \u00e0 la ligne de donn\u00e9es du dotstar. Ce param\u00e8tre # doit \u00eatre fourni. clock_pin: # La broche connect\u00e9e \u00e0 la ligne d'horloge du dotstar. Ce param\u00e8tre # doit \u00eatre fourni. #chain_count: # Voir la section \"neopixel\" pour des informations sur ce param\u00e8tre. #initial_RED: 0.0 #initial_GREEN: 0.0 #initial_BLUE: 0.0 # Voir la section \"led\" pour des informations sur ces param\u00e8tres.","title":"[dotstar]"},{"location":"Config_Reference.html#pca9533","text":"Support de la LED PCA9533. Le PCA9533 est utilis\u00e9 sur la mightyboard. [pca9533 my_pca9533] #i2c_address : 98 # L'adresse i2c que la puce utilise sur le bus i2c. Utilisez 98 pour # le PCA9533/1, 99 pour le PCA9533/2. La valeur par d\u00e9faut est 98. #i2c_mcu: #i2c_bus: #i2c_speed: # Voir la section \"param\u00e8tres I2C communs\" pour une description des # param\u00e8tres ci-dessus. #initial_RED: 0.0 #initial_GREEN: 0.0 #initial_BLUE: 0.0 #initial_WHITE: 0.0 # Voir la section \"led\" pour des informations sur ces param\u00e8tres.","title":"[pca9533]"},{"location":"Config_Reference.html#pca9632","text":"Support des LEDs du PCA9632. Le PCA9632 est utilis\u00e9 sur le FlashForge Dreamer. [pca9632 my_pca9632] #i2c_address 98 # L'adresse i2c que la puce utilise sur le bus i2c. Cela peut \u00eatre # 96, 97, 98, ou 99. La valeur par d\u00e9faut est 98. #i2c_mcu: #i2c_bus: #i2c_speed: # Voir la section \"param\u00e8tres I2C communs\" pour une description des # param\u00e8tres ci-dessus. #scl_pin: #sda_pin: # Alternativement, si le pca9632 n'est pas connect\u00e9 \u00e0 un bus mat\u00e9riel I2C # il est possible de sp\u00e9cifier les broches \"clock\" (scl_pin) et \"data\" (sda_pin). # Le d\u00e9faut est d'utiliser l'I2C mat\u00e9riel. #color_order : RGBW # D\u00e9finit l'ordre des pixels de la LED (en utilisant une cha\u00eene contenant les lettres # R, G, B, W). La valeur par d\u00e9faut est RGBW. #initial_RED: 0.0 #initial_GREEN: 0.0 #initial_BLUE: 0.0 #initial_WHITE: 0.0 # Voir la section \"led\" pour des informations sur ces param\u00e8tres.","title":"[pca9632]"},{"location":"Config_Reference.html#servos-supplementaires-boutons-et-autres-broches","text":"","title":"Servos suppl\u00e9mentaires, boutons et autres broches"},{"location":"Config_Reference.html#servo","text":"Servos (on peut d\u00e9finir un nombre quelconque de sections avec le pr\u00e9fixe \"servo\"). Les servos peuvent \u00eatre contr\u00f4l\u00e9s en utilisant la commande SET_SERVO g-code . Par exemple : SET_SERVO SERVO=my_servo ANGLE=180 [servo my_servo] pin: # Broche de sortie PWM contr\u00f4lant le servo. Ce param\u00e8tre doit \u00eatre # fourni. #maximum_servo_angle: 180 # L'angle maximum (en degr\u00e9s) auquel ce servo peut \u00eatre r\u00e9gl\u00e9. La valeur # par d\u00e9faut est de 180 degr\u00e9s. #minimum_pulse_width: 0.001 # La dur\u00e9e minimale de la largeur d'impulsion (en secondes). Cela devrait correspondre # avec un angle de 0 degr\u00e9. La valeur par d\u00e9faut est de 0,001 seconde. #maximum_pulse_width: 0.002 # La dur\u00e9e maximale de la largeur d'impulsion (en secondes). Cela devrait correspondre # avec l'angle de maximum_servo_angle. La valeur par d\u00e9faut est 0.002 secondes. #initial_angle: # Angle initial (en degr\u00e9s) sur lequel r\u00e9gler le servo. La valeur par d\u00e9faut est de # ne pas envoyer de signal au d\u00e9marrage. #initial_pulse_width: # Dur\u00e9e initiale de la largeur d'impulsion (en secondes) \u00e0 laquelle le servo doit \u00eatre r\u00e9gl\u00e9. (Ceci # n'est valable que si initial_angle n'est pas d\u00e9fini). La valeur par d\u00e9faut est de n'envoyer # aucun signal au d\u00e9marrage.","title":"[servo]"},{"location":"Config_Reference.html#gcode_button","text":"Ex\u00e9cute le gcode quand un bouton est press\u00e9 ou rel\u00e2ch\u00e9 (ou quand une broche change d'\u00e9tat). Vous pouvez v\u00e9rifier l'\u00e9tat du bouton en utilisant QUERY_BUTTON button=my_gcode_button . [gcode_button my_gcode_button] pin: # La broche sur laquelle le bouton est connect\u00e9. Ce param\u00e8tre doit \u00eatre # fourni. #analog_range: # Deux r\u00e9sistances s\u00e9par\u00e9es par des virgules (en Ohms) sp\u00e9cifiant la plage de # r\u00e9sistance minimale et maximale de la r\u00e9sistance du bouton. Si le param\u00e8tre # analog_range est fourni, la broche doit \u00eatre une broche \u00e0 capacit\u00e9 analogique. # La valeur par d\u00e9faut est d'utiliser un gpio num\u00e9rique pour le bouton. #analog_pullup_resistor: # La r\u00e9sistance d'excursion (en Ohms) lorsque la gamme analogique est sp\u00e9cifi\u00e9e. # La valeur par d\u00e9faut est 4700 ohms. #press_gcode: # Une liste de commandes G-Code \u00e0 ex\u00e9cuter lorsque le bouton est press\u00e9. # Les mod\u00e8les G-Code sont pris en charge. Ce param\u00e8tre doit \u00eatre fourni. #release_gcode: # Une liste de commandes G-code \u00e0 ex\u00e9cuter lorsque le bouton est rel\u00e2ch\u00e9. # Les mod\u00e8les G-Code sont support\u00e9s. La valeur par d\u00e9faut est de ne pas ex\u00e9cuter # de commandes lors du rel\u00e2chement d'un bouton.","title":"[gcode_button]"},{"location":"Config_Reference.html#output_pin","text":"Broches de sortie configurables \u00e0 l'ex\u00e9cution (on peut d\u00e9finir un nombre quelconque de sections avec un pr\u00e9fixe \"output_pin\"). Les broches configur\u00e9es ici seront param\u00e9tr\u00e9es comme des broches de sortie modifiables au moment de l'ex\u00e9cution en utilisant des commandes g-code \u00e9tendues de type \"SET_PIN PIN=my_pin VALUE=.1\" [output_pin my_pin] pin: # La broche \u00e0 configurer comme une sortie. Ce param\u00e8tre doit \u00eatre # fourni. #pwm: False # D\u00e9finit si la broche de sortie doit \u00eatre capable de modulation de largeur d'impulsion. # Si ce param\u00e8tre est vrai, les champs de valeur doivent \u00eatre compris entre 0 et 1. # La valeur par d\u00e9faut est False. #static_value: # Si cette valeur est d\u00e9finie, la broche est affect\u00e9e \u00e0 cette valeur au d\u00e9marrage et # la broche ne peut pas \u00eatre modifi\u00e9e pendant l'ex\u00e9cution. Une broche statique utilise # l\u00e9g\u00e8rement moins de RAM dans le micro-contr\u00f4leur. Le d\u00e9faut est d'utiliser # la configuration des broches param\u00e9tr\u00e9es lors du d\u00e9marrage. #value: # La valeur \u00e0 donner initialement \u00e0 la broche pendant la configuration du MCU. # La valeur par d\u00e9faut est 0 (pour une tension basse). #shutdown_value: # La valeur \u00e0 donner \u00e0 la broche lors d'un \u00e9v\u00e9nement d'arr\u00eat du MCU. La valeur par # d\u00e9faut est 0 (pour une tension basse). #maximum_mcu_duration: # La dur\u00e9e maximale pendant laquelle une valeur de non-arr\u00eat peut \u00eatre pilot\u00e9e par # le MCUsans un accus\u00e9 de r\u00e9ception de l'h\u00f4te. # Si l'h\u00f4te ne peut pas suivre une mise \u00e0 jour, le MCU s'\u00e9teindra et mettra # toutes les broches \u00e0 leurs valeurs d'arr\u00eat respectives. # D\u00e9faut : 0 (d\u00e9sactiv\u00e9) # Les valeurs habituelles sont d'environ 5 secondes. #cycle_time: 0.100 # La dur\u00e9e (en secondes) par cycle PWM. Il est recommand\u00e9 que ce soit # 10 millisecondes ou plus lorsque vous utilisez un PWM logiciel. # La valeur par d\u00e9faut est de 0.100 secondes pour les broches PWM. #hardware_pwm: False # Activez pour utiliser le PWM mat\u00e9riel au lieu du PWM logiciel. Lors de # l'utilisation d'un PWM mat\u00e9riel, le temps de cycle r\u00e9el est limit\u00e9 par # l'impl\u00e9mentation et peut \u00eatre significativement diff\u00e9rent du # cycle_time demand\u00e9. La valeur par d\u00e9faut est False. #scale : # Ce param\u00e8tre peut \u00eatre utilis\u00e9 pour modifier la fa\u00e7on dont les param\u00e8tres 'value' # et 'shutdown_value' sont interpr\u00e9t\u00e9s pour les broches pwm. Si fourni, alors # le param\u00e8tre 'value' doit \u00eatre compris entre 0.0 et 'scale'. Cela peut \u00eatre utile # lors de la configuration d'une broche PWM contr\u00f4lant une r\u00e9f\u00e9rence de tension # d'un moteur pas \u00e0 pas. L''\u00e9chelle' peut \u00eatre d\u00e9finie sur l'intensit\u00e9 du moteur pas # \u00e0 pas \u00e9quivalent si le PWM \u00e9tait enti\u00e8rement activ\u00e9, et puis le param\u00e8tre 'value' # peut \u00eatre sp\u00e9cifi\u00e9 en utilisant l'intensit\u00e9 souhait\u00e9e pour le moteur pas \u00e0 pas. La # valeur par d\u00e9faut est de ne pas mettre \u00e0 l'\u00e9chelle le param\u00e8tre 'value'.","title":"[output_pin]"},{"location":"Config_Reference.html#static_digital_output","text":"Broches de sortie num\u00e9rique configur\u00e9es statiquement (on peut d\u00e9finir un nombre quelconque de sections avec un pr\u00e9fixe \"static_digital_output\"). Les broches configur\u00e9es ici seront configur\u00e9es comme une sortie GPIO pendant la configuration du MCU. Elles ne peuvent pas \u00eatre modifi\u00e9es en cours d'ex\u00e9cution. [static_digital_output my_output_pins] pins: # Une liste de broches s\u00e9par\u00e9es par des virgules \u00e0 d\u00e9finir comme broches de sortie GPIO. La broche # sera d\u00e9finie \u00e0 un niveau haut, sauf si le nom de la broche est pr\u00e9c\u00e9d\u00e9 de \"!\". # Ce param\u00e8tre doit \u00eatre fourni.","title":"[static_digital_output]"},{"location":"Config_Reference.html#multi_pin","text":"Sorties \u00e0 broches multiples (on peut d\u00e9finir un nombre quelconque de sections avec le pr\u00e9fixe \"multi_pin\"). Une sortie multi_pin cr\u00e9e un alias de broche interne pouvant modifier plusieurs broches de sortie chaque fois que la broche alias est d\u00e9finie. Par exemple, on peut d\u00e9finir un objet \"[multi_pin my_fan]\" contenant deux broches et ensuite d\u00e9finir \"pin=multi_pin:my_fan\" dans la section \"[fan]\" - \u00e0 chaque changement du ventilateur, les deux broches de sortie seront mises \u00e0 jour. Ces alias ne peuvent pas \u00eatre utilis\u00e9s avec des broches de moteur pas \u00e0 pas. [multi_pin my_multi_pin] pins: # Une liste s\u00e9par\u00e9e par des virgules des broches associ\u00e9es \u00e0 cet alias. Ce param\u00e8tre # doit \u00eatre fourni.","title":"[multi_pin]"},{"location":"Config_Reference.html#configuration-des-pilotes-pas-a-pas-tmc","text":"Configuration des pilotes de moteurs pas \u00e0 pas Trinamic en mode UART/SPI. Des informations suppl\u00e9mentaires sont disponibles dans le guide des pilotes TMC et dans la r\u00e9f\u00e9rence des commandes .","title":"Configuration des pilotes pas \u00e0 pas TMC"},{"location":"Config_Reference.html#tmc2130","text":"Configuration d' un pilote de moteur pas \u00e0 pas TMC2130 via le bus SPI. Pour utiliser cette fonctionnalit\u00e9, d\u00e9finissez une section de configuration avec un pr\u00e9fixe \"tmc2130\" suivi du nom de la section de configuration du moteur pas \u00e0 pas correspondant (par exemple, \"[tmc2130 stepper_x]\"). [tmc2130 stepper_x] cs_pin: # The pin corresponding to the TMC2130 chip select line. This pin # will be set to low at the start of SPI messages and raised to high # after the message completes. This parameter must be provided. #spi_speed: #spi_bus: #spi_software_sclk_pin: #spi_software_mosi_pin: #spi_software_miso_pin: # See the \"common SPI settings\" section for a description of the # above parameters. #chain_position: #chain_length: # These parameters configure an SPI daisy chain. The two parameters # define the stepper position in the chain and the total chain length. # Position 1 corresponds to the stepper that connects to the MOSI signal. # The default is to not use an SPI daisy chain. #interpolate: True # If true, enable step interpolation (the driver will internally # step at a rate of 256 micro-steps). This interpolation does # introduce a small systemic positional deviation - see # TMC_Drivers.md for details. The default is True. run_current: # The amount of current (in amps RMS) to configure the driver to use # during stepper movement. This parameter must be provided. #hold_current: # The amount of current (in amps RMS) to configure the driver to use # when the stepper is not moving. Setting a hold_current is not # recommended (see TMC_Drivers.md for details). The default is to # not reduce the current. #sense_resistor: 0.110 # The resistance (in ohms) of the motor sense resistor. The default # is 0.110 ohms. #stealthchop_threshold: 0 # The velocity (in mm/s) to set the \"stealthChop\" threshold to. When # set, \"stealthChop\" mode will be enabled if the stepper motor # velocity is below this value. The default is 0, which disables # \"stealthChop\" mode. #driver_MSLUT0: 2863314260 #driver_MSLUT1: 1251300522 #driver_MSLUT2: 608774441 #driver_MSLUT3: 269500962 #driver_MSLUT4: 4227858431 #driver_MSLUT5: 3048961917 #driver_MSLUT6: 1227445590 #driver_MSLUT7: 4211234 #driver_W0: 2 #driver_W1: 1 #driver_W2: 1 #driver_W3: 1 #driver_X1: 128 #driver_X2: 255 #driver_X3: 255 #driver_START_SIN: 0 #driver_START_SIN90: 247 # These fields control the Microstep Table registers directly. The optimal # wave table is specific to each motor and might vary with current. An # optimal configuration will have minimal print artifacts caused by # non-linear stepper movement. The values specified above are the default # values used by the driver. The value must be specified as a decimal integer # (hex form is not supported). In order to compute the wave table fields, # see the tmc2130 \"Calculation Sheet\" from the Trinamic website. #driver_IHOLDDELAY: 8 #driver_TPOWERDOWN: 0 #driver_TBL: 1 #driver_TOFF: 4 #driver_HEND: 7 #driver_HSTRT: 0 #driver_PWM_AUTOSCALE: True #driver_PWM_FREQ: 1 #driver_PWM_GRAD: 4 #driver_PWM_AMPL: 128 #driver_SGT: 0 # Set the given register during the configuration of the TMC2130 # chip. This may be used to set custom motor parameters. The # defaults for each parameter are next to the parameter name in the # above list. #diag0_pin: #diag1_pin: # The micro-controller pin attached to one of the DIAG lines of the # TMC2130 chip. Only a single diag pin should be specified. The pin # is \"active low\" and is thus normally prefaced with \"^!\". Setting # this creates a \"tmc2130_stepper_x:virtual_endstop\" virtual pin # which may be used as the stepper's endstop_pin. Doing this enables # \"sensorless homing\". (Be sure to also set driver_SGT to an # appropriate sensitivity value.) The default is to not enable # sensorless homing.","title":"[tmc2130]"},{"location":"Config_Reference.html#tmc2208","text":"Configuration d'un pilote de moteur pas \u00e0 pas TMC2208 (ou TMC2224) via un UART \u00e0 fil unique. Pour utiliser cette fonctionnalit\u00e9, d\u00e9finissez une section de configuration avec un pr\u00e9fixe \"tmc2208\" suivi du nom de la section de configuration du moteur pas \u00e0 pas correspondant (par exemple, \"[tmc2208 stepper_x]\"). [tmc2208 stepper_x] uart_pin: # La broche connect\u00e9e \u00e0 la ligne PDN_UART de la TMC2208. Ce param\u00e8tre # doit \u00eatre fourni. #tx_pin: # Si vous utilisez des lignes de r\u00e9ception et de transmission s\u00e9par\u00e9es pour communiquer # avec le pilote, r\u00e9glez uart_pin sur la broche de r\u00e9ception et tx_pin sur la broche # d'\u00e9mission. La valeur par d\u00e9faut est d'utiliser uart_pin pour la lecture et l'\u00e9criture. #select_pins: # Une liste de broches, s\u00e9par\u00e9es par des virgules, \u00e0 d\u00e9finir avant d'acc\u00e9der \u00e0 l'UART du # tmc2208. Ceci peut \u00eatre utile pour configurer un mux analogique pour la communication # UART. La valeur par d\u00e9faut est de ne pas configurer de broches. #interpolate: True # Si true, active l'interpolation de pas (le pilote fera un pas interne \u00e0 un taux de 256 # micro-pas). Cette interpolation introduit une petite d\u00e9viation syst\u00e9mique de la position - # voir TMC_Drivers.md pour plus de d\u00e9tails. La valeur par d\u00e9faut est True. run_current: # La quantit\u00e9 de courant (en amp\u00e8res RMS) \u00e0 configurer que le pilote doit utiliser # pendant le mouvement du pas. Ce param\u00e8tre doit \u00eatre fourni. #hold_current: # La quantit\u00e9 de courant (en amp\u00e8res RMS) \u00e0 configurer que le pilote doit utiliser quand # le moteur pas \u00e0 pas n'est pas en mouvement. La d\u00e9finition d'un hold_current n'est pas # recommand\u00e9e (voir TMC_Drivers.md pour plus de d\u00e9tails). La valeur par d\u00e9faut est de # ne pas r\u00e9duire le courant. #sense_resistor: 0.110 # La r\u00e9sistance (en ohms) de la r\u00e9sistance de d\u00e9tection du moteur (Vr\u00e9f). La valeur par # d\u00e9faut est de 0.110 ohms. #stealthchop_threshold: 0 # La vitesse (en mm/s) \u00e0 laquelle le seuil \"stealthChop\" doit \u00eatre fix\u00e9. Lorsque d\u00e9fini, # le mode \"stealthChop\" sera activ\u00e9 si la vitesse du moteur pas \u00e0 pas est inf\u00e9rieure \u00e0 # cette valeur. La valeur par d\u00e9faut est 0, ce qui d\u00e9sactive le mode \"stealthChop\". #driver_IHOLDDELAY: 8 #driver_TPOWERDOWN: 20 #driver_TBL: 2 #driver_TOFF: 3 #driver_HEND: 0 #driver_HSTRT: 5 #driver_PWM_AUTOGRAD: True #driver_PWM_AUTOSCALE: True #driver_PWM_LIM: 12 #driver_PWM_REG: 8 #driver_PWM_FREQ: 1 #driver_PWM_GRAD: 14 #driver_PWM_OFS: 36 # D\u00e9finissez le registre donn\u00e9 pendant la configuration de la puce TMC2208. Ceci peut \u00eatre # utilis\u00e9 pour d\u00e9finir les param\u00e8tres personnalis\u00e9s du moteur. Les valeurs par d\u00e9faut de # chaque param\u00e8tre sont indiqu\u00e9es \u00e0 c\u00f4t\u00e9 du nom du param\u00e8tre dans la liste ci-dessus.","title":"[tmc2208]"},{"location":"Config_Reference.html#tmc2209","text":"Configuration d'un pilote de moteur pas \u00e0 pas TMC2209 via un UART \u00e0 fil unique. Pour utiliser cette fonctionnalit\u00e9, d\u00e9finissez une section de configuration avec un pr\u00e9fixe \"tmc2209\" suivi du nom de la section de configuration du moteur pas \u00e0 pas correspondant (par exemple, \"[tmc2209 stepper_x]\"). [tmc2209 stepper_x] uart_pin: #tx_pin #select_pins: #interpolate: True run_current: #hold_current: #sense_resistor: 0.110 #stealthchop_threshold: 0 # Voir la section \"tmc2208\" pour la d\u00e9finition de ces param\u00e8tres. #uart_address: # L'adresse de la puce TMC2209 pour les messages UART (un entier entre 0 et 3). # Ce param\u00e8tre est g\u00e9n\u00e9ralement utilis\u00e9 lorsque plusieurs puces TMC2209 sont # connect\u00e9es \u00e0 la m\u00eame broche UART. La valeur par d\u00e9faut est z\u00e9ro. #driver_IHOLDDELAY: 8 #driver_TPOWERDOWN: 20 #driver_TBL: 2 #driver_TOFF: 3 #driver_HEND: 0 #driver_HSTRT: 5 #driver_PWM_AUTOGRAD: True #driver_PWM_AUTOSCALE: True #driver_PWM_LIM: 12 #driver_PWM_REG: 8 #driver_PWM_FREQ: 1 #driver_PWM_GRAD: 14 #driver_PWM_OFS: 36 #driver_SGTHRS: 0 # D\u00e9finit le registre donn\u00e9 pendant la configuration de la puce TMC2209. Ceci peut \u00eatre # utilis\u00e9 pour d\u00e9finir les param\u00e8tres personnalis\u00e9s du moteur. Les valeurs par d\u00e9faut de # chaque param\u00e8tre sont indiqu\u00e9es \u00e0 c\u00f4t\u00e9 du nom du param\u00e8tre dans la liste ci-dessus. #diag_pin: # La broche du microcontr\u00f4leur reli\u00e9e \u00e0 la ligne DIAG de la puce TMC2209. La broche est # normalement pr\u00e9c\u00e9d\u00e9e de \"^\" pour activer un pullup. Le param\u00e9trage de cette broche # cr\u00e9e une broche virtuelle \"tmc2209_stepper_x:virtual_endstop\" pouvant \u00eatre utilis\u00e9e # comme broche d'arr\u00eat du moteur. Ainsi cela active le \"sensorless homing\". (Assurez- # vous de d\u00e9finir \u00e9galement driver_SGTHRS \u00e0 une valeur de sensibilit\u00e9 appropri\u00e9e). # La valeur par d\u00e9faut est de ne pas activer la recherche d'origine sans capteur.","title":"[tmc2209]"},{"location":"Config_Reference.html#tmc2660","text":"Configuration d'un pilote de moteur pas \u00e0 pas TMC2660 via le bus SPI. Pour utiliser cette fonctionnalit\u00e9, d\u00e9finissez une section de configuration avec un pr\u00e9fixe \"tmc2660\" suivi du nom de la section de configuration du moteur pas \u00e0 pas correspondant (par exemple, \"[tmc2660 stepper_x]\"). [tmc2660 stepper_x] cs_pin: # La broche correspondant \u00e0 la ligne de s\u00e9lection de la puce TMC2660. Cette # broche sera mise \u00e0 l'\u00e9tat bas au d\u00e9but des messages SPI et passera \u00e0 l'\u00e9tat # haut apr\u00e8s la fin du transfert du message. Ce param\u00e8tre doit \u00eatre fourni. #spi_speed: 4000000 # Fr\u00e9quence du bus SPI utilis\u00e9e pour communiquer avec le pilote de pas \u00e0 pas # TMC2660. La valeur par d\u00e9faut est 4000000. #spi_bus: #spi_software_sclk_pin: #spi_software_mosi_pin: #spi_software_miso_pin: # Voir la section \"param\u00e8tres SPI communs\" pour une description des # param\u00e8tres ci-dessus. #interpolate: True # Si vrai, active l'interpolation par pas (le pilote fera un pas interne \u00e0 un taux # de 256 micro-pas). Cela ne fonctionne que si les micro-pas sont fix\u00e9s \u00e0 16. # L'interpolation introduit une petite d\u00e9viation de position syst\u00e9mique - voir # TMC_Drivers.md pour plus de d\u00e9tails. La valeur par d\u00e9faut est True. run_current: # La quantit\u00e9 de courant (en amp\u00e8res RMS) utilis\u00e9e par le pilote pendant le # d\u00e9placement du moteur pas \u00e0 pas. Ce param\u00e8tre doit \u00eatre fourni. #sense_resistor: # La r\u00e9sistance (en ohms) de la r\u00e9sistance de d\u00e9tection du moteur (Vr\u00e9f). Ce # param\u00e8tre doit \u00eatre fourni. #idle_current_percent 100 # Le pourcentage du courant de fonctionnement auquel le pilote pas \u00e0 pas # sera abaiss\u00e9 quand le d\u00e9lai d'inactivit\u00e9 expirera (vous devez configurer le # d\u00e9lai \u00e0 l'aide d'une section de configuration [idle_timeout]). Le courant sera # remont\u00e9 d\u00e8s que le moteur devra \u00e0 nouveau se d\u00e9placer. Assurez-vous de # d\u00e9finir une valeur suffisamment \u00e9lev\u00e9e pour que les moteurs ne perdent pas # leur position. Il y a \u00e9galement un petit d\u00e9lai avant que le courant ne soit remis, # il faut donc en tenir compte lors de demandes de mouvements rapides alors # que le pilote est inactif. La valeur par d\u00e9faut est 100 (aucune r\u00e9duction). #driver_TBL: 2 #driver_RNDTF: 0 #driver_HDEC: 0 #driver_CHM: 0 #driver_HEND: 3 #driver_HSTRT: 3 #driver_TOFF: 4 #driver_SEIMIN: 0 #driver_SEDN: 0 #driver_SEMAX: 0 #driver_SEUP: 0 #driver_SEMIN: 0 #driver_SFILT: 0 #driver_SGT: 0 #driver_SLPH: 0 #driver_SLPL: 0 #driver_DISS2G: 0 #driver_TS2G: 3 # D\u00e9finit les param\u00e8tres \u00e0 utiliser pendant la configuration de la puce TMC2660. # Ceci peut \u00eatre utilis\u00e9 pour d\u00e9finir des param\u00e8tres de pilote personnalis\u00e9s. Les # valeurs par d\u00e9faut de chaque param\u00e8tre sont indiqu\u00e9es \u00e0 c\u00f4t\u00e9 du nom du param\u00e8tre # dans la liste ci-dessus. Consultez la fiche technique du TMC2660 pour conna\u00eetre la # fonction de chaque param\u00e8tre ainsi que les restrictions sur les combinaisons de # param\u00e8tres. Soyez particuli\u00e8rement attentif au registre CHOPCONF, o\u00f9 le fait de # r\u00e9gler CHM \u00e0 soit z\u00e9ro, soit un, entra\u00eene des modifications de la disposition (le # premier bit de HDEC est interpr\u00e9t\u00e9 comme le MSB de HSTRT dans ce cas).","title":"[tmc2660]"},{"location":"Config_Reference.html#tmc5160","text":"Configuration d'un pilote de moteur pas \u00e0 pas TMC5160 via le bus SPI. Pour utiliser cette fonctionnalit\u00e9, d\u00e9finissez une section de configuration avec un pr\u00e9fixe \"tmc5160\" suivi du nom de la section de configuration du moteur pas \u00e0 pas correspondant (par exemple, \"[tmc5160 stepper_x]\"). [tmc5160 stepper_x] cs_pin: # The pin corresponding to the TMC5160 chip select line. This pin # will be set to low at the start of SPI messages and raised to high # after the message completes. This parameter must be provided. #spi_speed: #spi_bus: #spi_software_sclk_pin: #spi_software_mosi_pin: #spi_software_miso_pin: # See the \"common SPI settings\" section for a description of the # above parameters. #chain_position: #chain_length: # These parameters configure an SPI daisy chain. The two parameters # define the stepper position in the chain and the total chain length. # Position 1 corresponds to the stepper that connects to the MOSI signal. # The default is to not use an SPI daisy chain. #interpolate: True # If true, enable step interpolation (the driver will internally # step at a rate of 256 micro-steps). The default is True. run_current: # The amount of current (in amps RMS) to configure the driver to use # during stepper movement. This parameter must be provided. #hold_current: # The amount of current (in amps RMS) to configure the driver to use # when the stepper is not moving. Setting a hold_current is not # recommended (see TMC_Drivers.md for details). The default is to # not reduce the current. #sense_resistor: 0.075 # The resistance (in ohms) of the motor sense resistor. The default # is 0.075 ohms. #stealthchop_threshold: 0 # The velocity (in mm/s) to set the \"stealthChop\" threshold to. When # set, \"stealthChop\" mode will be enabled if the stepper motor # velocity is below this value. The default is 0, which disables # \"stealthChop\" mode. #driver_MSLUT0: 2863314260 #driver_MSLUT1: 1251300522 #driver_MSLUT2: 608774441 #driver_MSLUT3: 269500962 #driver_MSLUT4: 4227858431 #driver_MSLUT5: 3048961917 #driver_MSLUT6: 1227445590 #driver_MSLUT7: 4211234 #driver_W0: 2 #driver_W1: 1 #driver_W2: 1 #driver_W3: 1 #driver_X1: 128 #driver_X2: 255 #driver_X3: 255 #driver_START_SIN: 0 #driver_START_SIN90: 247 # These fields control the Microstep Table registers directly. The optimal # wave table is specific to each motor and might vary with current. An # optimal configuration will have minimal print artifacts caused by # non-linear stepper movement. The values specified above are the default # values used by the driver. The value must be specified as a decimal integer # (hex form is not supported). In order to compute the wave table fields, # see the tmc2130 \"Calculation Sheet\" from the Trinamic website. #driver_IHOLDDELAY: 6 #driver_TPOWERDOWN: 10 #driver_TBL: 2 #driver_TOFF: 3 #driver_HEND: 2 #driver_HSTRT: 5 #driver_FD3: 0 #driver_TPFD: 4 #driver_CHM: 0 #driver_VHIGHFS: 0 #driver_VHIGHCHM: 0 #driver_DISS2G: 0 #driver_DISS2VS: 0 #driver_PWM_AUTOSCALE: True #driver_PWM_AUTOGRAD: True #driver_PWM_FREQ: 0 #driver_FREEWHEEL: 0 #driver_PWM_GRAD: 0 #driver_PWM_OFS: 30 #driver_PWM_REG: 4 #driver_PWM_LIM: 12 #driver_SGT: 0 #driver_SEMIN: 0 #driver_SEUP: 0 #driver_SEMAX: 0 #driver_SEDN: 0 #driver_SEIMIN: 0 #driver_SFILT: 0 # Set the given register during the configuration of the TMC5160 # chip. This may be used to set custom motor parameters. The # defaults for each parameter are next to the parameter name in the # above list. #diag0_pin: #diag1_pin: # The micro-controller pin attached to one of the DIAG lines of the # TMC5160 chip. Only a single diag pin should be specified. The pin # is \"active low\" and is thus normally prefaced with \"^!\". Setting # this creates a \"tmc5160_stepper_x:virtual_endstop\" virtual pin # which may be used as the stepper's endstop_pin. Doing this enables # \"sensorless homing\". (Be sure to also set driver_SGT to an # appropriate sensitivity value.) The default is to not enable # sensorless homing.","title":"[tmc5160]"},{"location":"Config_Reference.html#configuration-du-courant-du-moteur-pas-a-pas-en-temps-reel","text":"","title":"Configuration du courant du moteur pas \u00e0 pas en temps r\u00e9el"},{"location":"Config_Reference.html#ad5206","text":"Digipots AD5206 configur\u00e9s statiquement et connect\u00e9s via un bus SPI (on peut d\u00e9finir un nombre quelconque de sections avec un pr\u00e9fixe \"ad5206\"). [ad5206 my_digipot] enable_pin: # La broche correspondant \u00e0 la ligne de s\u00e9lection de la puce AD5206. Cette broche # sera r\u00e9gl\u00e9e \u00e0 un niveau bas au d\u00e9but des messages SPI et sera relev\u00e9e \u00e0 un niveau \u00e9lev\u00e9 # apr\u00e8s la fin du message. Ce param\u00e8tre doit \u00eatre fourni. #spi_speed: #spi_bus: #spi_software_sclk_pin: #spi_software_mosi_pin: #spi_software_miso_pin: # Voir la section \"param\u00e8tres communs SPI\" pour une description des param\u00e8tres ci-dessus. # #channel_1: #channel_2: #channel_3: #channel_4: #channel_5: #channel_6: # La valeur pour d\u00e9finir statiquement le canal AD5206 donn\u00e9. Cette valeur est # g\u00e9n\u00e9ralement d\u00e9finie sur un nombre compris entre 0,0 et 1,0. 1,0 \u00e9tant la r\u00e9sistance # la plus \u00e9lev\u00e9e et 0,0 la r\u00e9sistance la plus faible. Cependant, la plage peut \u00eatre # modifi\u00e9e \u00e0 l'aide du param\u00e8tre 'scale' (voir ci-dessous). # Si un canal n'est pas sp\u00e9cifi\u00e9, il n'est pas configur\u00e9. # scale: # Ce param\u00e8tre peut \u00eatre utilis\u00e9 pour modifier l'interpr\u00e9tation des param\u00e8tres 'channel_x'. # S'il est fourni, alors les param\u00e8tres 'channel_x' doivent \u00eatre compris entre 0.0 et 'scale'. # Cela peut \u00eatre utile lorsque le AD5206 est utilis\u00e9 pour d\u00e9finir des r\u00e9f\u00e9rences de tension # pas \u00e0 pas. L''\u00e9chelle' peut \u00eatre r\u00e9gl\u00e9e sur l'intensit\u00e9 \u00e9quivalente de la commande pas \u00e0 pas # si l'AD5206 \u00e9tait \u00e0 sa r\u00e9sistance la plus \u00e9lev\u00e9e, puis les param\u00e8tres 'channel_x' peuvent \u00eatre # sp\u00e9cifi\u00e9s en utilisant la valeur d'intensit\u00e9 d\u00e9sir\u00e9e pour le pilote pas \u00e0 pas. La configuration # par d\u00e9faut est de ne pas mettre \u00e0 l'\u00e9chelle les param\u00e8tres 'channel_x'.","title":"[ad5206]"},{"location":"Config_Reference.html#mcp4451","text":"Digipot MCP4451 configur\u00e9 statiquement et connect\u00e9 via le bus I2C (on peut d\u00e9finir un nombre quelconque de sections avec un pr\u00e9fixe \"mcp4451\"). [mcp4451 mon_digipot] i2c_address: # L'adresse i2c que la puce utilise sur le bus i2c. Ce param\u00e8tre # doit \u00eatre fourni. #i2c_mcu: #i2c_bus: #i2c_speed: # Voir la section \"param\u00e8tres I2C communs\" pour une description des # param\u00e8tres ci-dessus. #wiper_0: #wiper_1: #wiper_2: #wiper_3: # La valeur pour d\u00e9finir statiquement le \"wiper\" MCP4451 donn\u00e9. Cette valeur est # g\u00e9n\u00e9ralement r\u00e9gl\u00e9e sur un nombre compris entre 0.0 et 1.0, 1.0 \u00e9tant la r\u00e9sistance # la plus \u00e9lev\u00e9e et 0.0 la r\u00e9sistance la plus faible. Cependant, la plage peut \u00eatre modifi\u00e9e # \u00e0 l'aide du param\u00e8tre 'scale' (voir ci-dessous). Si un wiper n'est pas sp\u00e9cifi\u00e9, il n'est # pas configur\u00e9. #scale: # Ce param\u00e8tre peut \u00eatre utilis\u00e9 pour modifier l'interpr\u00e9tation des param\u00e8tres 'wiper_x'. # S'il est fourni, alors les param\u00e8tres 'wiper_x' doivent \u00eatre compris entre 0,0 et 'scale'. # Ceci peut \u00eatre utile lorsque le MCP4451 est utilis\u00e9 pour d\u00e9finir des r\u00e9f\u00e9rences de tension # du pilote pas \u00e0 pas.L''\u00e9chelle' peut \u00eatre r\u00e9gl\u00e9e sur l'intensit\u00e9 du pilote pas \u00e0 pas \u00e9quivalent # si le MCP4451 \u00e9tait \u00e0 sa r\u00e9sistance la plus \u00e9lev\u00e9e, puis les param\u00e8tres 'wiper_x' peuvent # \u00eatre sp\u00e9cifi\u00e9s en utilisant la valeur d'intensit\u00e9 d\u00e9sir\u00e9e pour le pilote pas \u00e0 pas. La valeur # par d\u00e9faut est de ne pas mettre \u00e0 l'\u00e9chelle les param\u00e8tres 'wiper_x'.","title":"[mcp4451]"},{"location":"Config_Reference.html#mcp4728","text":"Convertisseur num\u00e9rique-analogique MCP4728 configur\u00e9 statiquement et connect\u00e9 via le bus I2C (on peut d\u00e9finir un nombre quelconque de sections avec un pr\u00e9fixe \"mcp4728\"). [mcp4728 my_dac] #i2c_address: 96 # L'adresse i2c que la puce utilise sur le bus i2c. La valeur par d\u00e9faut # est 96. #i2c_mcu: #i2c_bus: #i2c_speed: # Voir la section \"param\u00e8tres I2C communs\" pour une description des # param\u00e8tres ci-dessus. #channel_a: #channel_b: #channel_c: #channel_d: # La valeur pour d\u00e9finir statiquement le canal MCP4728 donn\u00e9. Ceci est # g\u00e9n\u00e9ralement d\u00e9finie par un nombre compris entre 0.0 et 1.0, 1.0 repr\u00e9sentant # la tension la plus \u00e9lev\u00e9e (2.048V) et 0.0 la tension la plus basse. # Cependant, la plage peut \u00eatre modifi\u00e9e \u00e0 l'aide du param\u00e8tre 'scale' (cf. # ci-dessous). Si un canal n'est pas sp\u00e9cifi\u00e9, il n'est pas configur\u00e9. #scale: # Ce param\u00e8tre peut \u00eatre utilis\u00e9 pour modifier l'interpr\u00e9tation des param\u00e8tres 'channel_x'. # S'il est fourni, le param\u00e8tre 'channel_x' doit \u00eatre compris entre 0,0 et 'scale'. # Cela peut \u00eatre utile lorsque le MCP4728 est utilis\u00e9 pour d\u00e9finir des r\u00e9f\u00e9rences de tension # de moteur pas \u00e0 pas. L''\u00e9chelle' peut \u00eatre r\u00e9gl\u00e9e sur l'intensit\u00e9 \u00e9quivalente de la commande # de moteur pas \u00e0 pas si le MCP4728 \u00e9tait \u00e0 sa tension la plus \u00e9lev\u00e9e (2.048V), et ensuite les # param\u00e8tres 'channel_x' peuvent \u00eatre sp\u00e9cifi\u00e9s en utilisant l'intensit\u00e9 d\u00e9sir\u00e9e pour le # moteur pas \u00e0 pas. La valeur par d\u00e9faut est de ne pas mettre \u00e0 l'\u00e9chelle les # param\u00e8tres 'channel_x'.","title":"[mcp4728]"},{"location":"Config_Reference.html#mcp4018","text":"Digipot MCP4018 configur\u00e9 statiquement et connect\u00e9 via deux broches gpio \"bit banging\" (on peut d\u00e9finir un nombre quelconque de sections avec un pr\u00e9fixe \"mcp4018\"). [mcp4018 my_digipot] scl_pin: # La broche d'horloge SCL. Ce param\u00e8tre doit \u00eatre fourni. sda_pin: # La broche de \"donn\u00e9es\" SDA. Ce param\u00e8tre doit \u00eatre fourni. wiper: # La valeur \u00e0 laquelle d\u00e9finir statiquement le \"wiper\" MCP4018 donn\u00e9. Ce param\u00e8tre est # g\u00e9n\u00e9ralement r\u00e9gl\u00e9e sur un nombre compris entre 0,0 et 1,0, 1,0 \u00e9tant la r\u00e9sistance # la plus \u00e9lev\u00e9e et 0.0 la r\u00e9sistance la plus faible. Cependant, la plage peut \u00eatre modifi\u00e9e \u00e0 # l'aide du param\u00e8tre 'scale' (voir ci-dessous). Ce param\u00e8tre doit \u00eatre fourni. #scale: # Ce param\u00e8tre peut \u00eatre utilis\u00e9 pour modifier l'interpr\u00e9tation du param\u00e8tre 'wiper'. # S'il est fourni, le param\u00e8tre 'wiper' doit se situer entre 0,0 et 'scale'. Ceci peut \u00eatre utile # lorsque le MCP4018 est utilis\u00e9 pour d\u00e9finir des r\u00e9f\u00e9rences de tension pas \u00e0 pas. # L''\u00e9chelle' peut \u00eatre r\u00e9gl\u00e9e sur l'intensit\u00e9 du pilote pas \u00e0 pas \u00e9quivalent si le MCP4018 # est \u00e0 sa plus grande# r\u00e9sistance la plus \u00e9lev\u00e9e, puis le param\u00e8tre 'wiper' peut \u00eatre sp\u00e9cifi\u00e9 # en utilisant la valeur d'intensit\u00e9 d\u00e9sir\u00e9e pour le pilote pas \u00e0 pas. La valeur par d\u00e9faut est # de ne pas mettre \u00e0 l'\u00e9chelle le param\u00e8tre 'wiper'.","title":"[mcp4018]"},{"location":"Config_Reference.html#prise-en-charge-de-laffichage","text":"","title":"Prise en charge de l'affichage"},{"location":"Config_Reference.html#display","text":"Prise en charge d'un \u00e9cran reli\u00e9 au microcontr\u00f4leur. [display] lcd_type: # Le type de puce LCD utilis\u00e9. Cela peut \u00eatre \"hd44780\", \"hd44780_spi\", \"st7920\", # \"emulated_st7920\", \"uc1701\", \"ssd1306\", ou \"sh1106\". # Voir les sections d'affichage ci-dessous pour plus d'informations sur chaque type # et les param\u00e8tres suppl\u00e9mentaires qu'ils fournissent. Ce param\u00e8tre doit \u00eatre # fourni. #display_group: # Le nom du groupe de donn\u00e9es \u00e0 afficher sur l'\u00e9cran. Cela contr\u00f4le le contenu de # l'\u00e9cran (voir la section \"display_data\" pour plus d'informations). La valeur par # d\u00e9faut est _default_20x4 pour les \u00e9crans hd44780 et _default_16x4 pour les # autres affichages. #menu_timeout: # D\u00e9lai d'attente pour le menu. Le fait d'\u00eatre inactif pendant ce nombre de secondes # d\u00e9clenchera la sortie du menu ou le retour au menu racine si l'autorun est activ\u00e9. # La valeur par d\u00e9faut est 0 seconde (d\u00e9sactiv\u00e9) #menu_root: # Nom de la section du menu principal \u00e0 afficher lorsque vous cliquez sur l'encodeur # de l'\u00e9cran d'accueil. La valeur par d\u00e9faut est __main, et cela affiche les menus par # d\u00e9faut tels que d\u00e9finis dans klippy/extras/display/menu.cfg #menu_reverse_navigation: # Lorsque activ\u00e9, inverse les directions vers le haut et vers le bas de la liste. # La valeur par d\u00e9faut est False. Ce param\u00e8tre est optionnel. #encoder_pins: # Les broches connect\u00e9es \u00e0 l'encodeur. 2 broches doivent \u00eatre fournies lorsque vous # utilisez l'encodeur. Ce param\u00e8tre doit \u00eatre fourni lors de l'utilisation du menu. #encoder_steps_per_detent: # Combien de pas l'encodeur \u00e9met par cran (\"clic\"). Si l'encodeur prend deux crans pour # se d\u00e9placer entre les entr\u00e9es ou d\u00e9place deux entr\u00e9es \u00e0 partir d'un seul cran, essayez de # modifier cette valeur. Les valeurs autoris\u00e9es sont 2 (demi-step) ou 4 (full-step). # La valeur par d\u00e9faut est 4. #click_pin: # La broche connect\u00e9e au bouton 'entr\u00e9e' ou au 'clic' de l'encodeur. Ce param\u00e8tre doit # \u00eatre fourni lors de l'utilisation du menu. La pr\u00e9sence d'un param\u00e8tre de configuration # 'analog_range_click_pin' fait passer ce param\u00e8tre de num\u00e9rique \u00e0 analogique. #back_pin: # La broche connect\u00e9e au bouton 'retour'. Ce param\u00e8tre est facultatif, le menu peut \u00eatre utilis\u00e9 # sans lui. La pr\u00e9sence d'un param\u00e8tre de configuration 'analog_range_back_pin' transforme # ce param\u00e8tre de num\u00e9rique \u00e0 analogique. #up_pin: # La broche connect\u00e9e au bouton 'haut'. Ce param\u00e8tre doit \u00eatre fourni lorsque vous utilisez un # menu sans encodeur. La pr\u00e9sence d'un param\u00e8tre de configuration 'analog_range_up_pin' # transforme ce param\u00e8tre de num\u00e9rique \u00e0 analogique. #down_pin: # La broche connect\u00e9e au bouton 'bas'. Ce param\u00e8tre doit \u00eatre fourni lorsque vous utilisez un # menu sans encodeur. La pr\u00e9sence d'un param\u00e8tre de configuration 'analog_range_down_pin' # transforme ce param\u00e8tre de num\u00e9rique \u00e0 analogique. #kill_pin: # La broche connect\u00e9e au bouton 'kill'. Ce bouton appellera l'arr\u00eat d'urgence. La pr\u00e9sence d'un # param\u00e8tre 'analog_range_kill_pin' fait passer ce param\u00e8tre de num\u00e9rique \u00e0 analogique. #analog_pullup_resistor: 4700 # La r\u00e9sistance (en ohms) du pullup attach\u00e9 au bouton analogique. # La valeur par d\u00e9faut est de 4700 ohms. #analog_range_click_pin: # La plage de r\u00e9sistances du bouton 'entr\u00e9e'. Les valeurs minimale et maximale de la plage # s\u00e9par\u00e9es par des virgules doivent \u00eatre fournies lors de l'utilisation du bouton analogique. #analog_range_back_pin: # La plage de r\u00e9sistances du bouton 'retour'. Les valeurs minimale et maximale de la plage # s\u00e9par\u00e9es par des virgules doivent \u00eatre fournies lors de l'utilisation du bouton analogique. #analog_range_up_pin: # La plage de r\u00e9sistances du bouton 'haut'. Les valeurs minimale et maximale de la plage # s\u00e9par\u00e9es par des virgules doivent \u00eatre fournies lors de l'utilisation du bouton analogique. #analog_range_down_pin: # La plage de r\u00e9sistances du bouton 'bas'. Les valeurs minimale et maximale de la plage # s\u00e9par\u00e9es par des virgules doivent \u00eatre fournies lors de l'utilisation du bouton analogique. #analog_range_kill_pin: # La plage de r\u00e9sistances du bouton 'kill'. Les valeurs minimale et maximale de la plage # s\u00e9par\u00e9es par des virgules doivent \u00eatre fournies lors de l'utilisation du bouton analogique.","title":"[display]"},{"location":"Config_Reference.html#ecran-hd44780","text":"Informations de configuration des \u00e9crans hd44780 (utilis\u00e9s dans les \u00e9crans de type \"RepRapDiscount 2004 Smart Controller\"). [display] lcd_type: hd44780 # D\u00e9finir \u00e0 \"hd44780\" pour les \u00e9crans hd44780. rs_pin: e_pin: d4_pin: d5_pin: d6_pin: d7_pin: # Broches connect\u00e9es \u00e0 un lcd de type hd44780. Ces param\u00e8tres doivent # \u00eatre fournis. #hd44780_protocol_init: True # Effectuer l'initialisation du protocole 8-bit/4-bit sur un \u00e9cran hd44780. # Ceci est n\u00e9cessaire sur les vrais dispositifs hd44780. Cependant, on peut avoir besoin # de le d\u00e9sactiver avec certains p\u00e9riph\u00e9riques \"clones\". La valeur par d\u00e9faut est True. #line_length: # D\u00e9finit le nombre de caract\u00e8res par ligne pour un lcd de type hd44780. # Les valeurs possibles sont 20 (par d\u00e9faut) et 16. Le nombre de lignes est # fix\u00e9 \u00e0 4. ...","title":"\u00e9cran hd44780"},{"location":"Config_Reference.html#ecran-hd44780_spi","text":"Informations de configuration d'un \u00e9cran hd44780_spi - un \u00e9cran 20x04 contr\u00f4l\u00e9 par un \"registre \u00e0 d\u00e9calage (shift register)\" mat\u00e9riel (utilis\u00e9 dans les imprimantes bas\u00e9es sur mightyboard). [display] lcd_type: hd44780_spi # D\u00e9finir \u00e0 \"hd44780_spi\" pour les \u00e9crans hd44780_spi. latch_pin: spi_software_sclk_pin: spi_software_mosi_pin: spi_software_miso_pin: # Broches connect\u00e9es au registre \u00e0 d\u00e9calage contr\u00f4lant l'affichage. # La broche spi_software_miso_pin doit \u00eatre d\u00e9finie sur une broche inutilis\u00e9e # de la carte m\u00e8re de l'imprimante, car le registre \u00e0 d\u00e9calage contr\u00f4lant l'affichage # n'a pas de broche MISO, mais l'impl\u00e9mentation logicielle de spi n\u00e9cessite que # cette broche soit configur\u00e9e. #hd44780_protocol_init: True # Effectue l'initialisation du protocole 8-bit/4-bit sur un \u00e9cran hd44780. # Ceci est n\u00e9cessaire sur les vrais dispositifs hd44780. Cependant, on peut avoir besoin # de le d\u00e9sactiver avec certains p\u00e9riph\u00e9riques \"clones\". La valeur par d\u00e9faut est True. #line_length: # D\u00e9finit le nombre de caract\u00e8res par ligne pour un lcd de type hd44780. # Les valeurs possibles sont 20 (par d\u00e9faut) et 16. Le nombre de lignes est # fix\u00e9 \u00e0 4. ...","title":"\u00e9cran hd44780_spi"},{"location":"Config_Reference.html#ecran-st7920","text":"Informations de configuration des \u00e9crans st7920 (utilis\u00e9s dans les \u00e9crans de type \"RepRapDiscount 12864 Full Graphic Smart Controller\"). [display] lcd_type: st7920 # D\u00e9finir \u00e0 \"st7920\" pour les \u00e9crans st7920. cs_pin: sclk_pin: sid_pin: # Les broches connect\u00e9es \u00e0 un lcd de type st7920. Ces param\u00e8tres doivent \u00eatre # fournis. ...","title":"\u00e9cran st7920"},{"location":"Config_Reference.html#ecran-emulated_st7920","text":"Informations de configuration d'un \u00e9cran st7920 \u00e9mul\u00e9 - que l'on trouve dans certains \"\u00e9crans tactiles de 2,4 pouces\" et similaires. [display] lcd_type: emulated_st7920 # D\u00e9finir \u00e0 \"emulated_st7920\" pour les \u00e9crans emulated_st7920. en_pin: spi_software_sclk_pin: spi_software_mosi_pin: spi_software_miso_pin: # Les broches connect\u00e9es \u00e0 un lcd de type emulated_st7920. L'en_pin # correspond \u00e0 la cs_pin du lcd de type st7920, # spi_software_sclk_pin correspond \u00e0 sclk_pin et # spi_software_mosi_pin correspond \u00e0 sid_pin. La broche # spi_software_miso_pin doit \u00eatre r\u00e9gl\u00e9e sur une broche non utilis\u00e9e de la carte # m\u00e8re de l'imprimante car le st7920 n'a pas de broche MISO mais l'impl\u00e9mentation # logicielle spi n\u00e9cessite que cette broche soit configur\u00e9e. ...","title":"\u00e9cran emulated_st7920"},{"location":"Config_Reference.html#ecran-uc1701","text":"Informations de configuration des \u00e9crans uc1701 (utilis\u00e9s dans les \u00e9crans de type \"MKS Mini 12864\"). [display] lcd_type: uc1701 # D\u00e9finir \u00e0 \"uc1701\" pour les \u00e9crans uc1701. cs_pin: a0_pin: # Les broches connect\u00e9es \u00e0 un lcd de type uc1701. Ces param\u00e8tres doivent \u00eatre # fournis. #rst_pin: # La broche connect\u00e9e \u00e0 la broche \"rst\" du lcd. Si elle n'est pas sp\u00e9cifi\u00e9e, # le mat\u00e9riel doit avoir un pull-up sur la ligne lcd correspondante. #contrast: # Le contraste \u00e0 d\u00e9finir. La valeur peut aller de 0 \u00e0 63 , la valeur par # d\u00e9faut est 40. ...","title":"\u00e9cran uc1701"},{"location":"Config_Reference.html#ecrans-ssd1306-et-sh1106","text":"Les informations de configuration des \u00e9crans ssd1306 et sh1106. [display] lcd_type: # D\u00e9finir \u00e0 \"ssd1306\" ou \"sh1106\" pour le type d'affichage donn\u00e9. #i2c_mcu: #i2c_bus: #i2c_speed: # Param\u00e8tres optionnels disponibles pour des \u00e9crans connect\u00e9s via un bus i2c. # Voir la section \"Param\u00e8tres I2C communs\" pour une description des # param\u00e8tres ci-dessus. #cs_pin: #dc_pin: #spi_speed: #spi_bus: #spi_software_sclk_pin: #spi_software_mosi_pin: #spi_software_miso_pin: # Les broches connect\u00e9es au lcd en mode spi \"4-wire\". Voir la section # \"param\u00e8tres SPI communs\" pour une description des param\u00e8tres # commen\u00e7ant par \"spi_\". Le d\u00e9faut est d'utiliser le mode i2c pour l'\u00e9cran # d'affichage. #reset_pin: # Une broche de r\u00e9initialisation peut \u00eatre sp\u00e9cifi\u00e9e sur l'affichage. Si elle # n'est pas sp\u00e9cifi\u00e9e, le mat\u00e9riel doit avoir un pull-up sur la ligne # lcd correspondante. #contrast: # Le contraste \u00e0 d\u00e9finir. La valeur peut aller de 0 \u00e0 256 , la valeur par # d\u00e9faut est 239. #vcomh: 0 # D\u00e9finit la valeur Vcomh sur l'\u00e9cran. Cette valeur est associ\u00e9e \u00e0 un effet # de \"bavure\" sur certains \u00e9crans OLED. La valeur peut \u00eatre comprise # de 0 \u00e0 63. La valeur par d\u00e9faut est 0. #invert: False # TRUE inverse les pixels sur certains \u00e9crans OLED. La valeur par d\u00e9faut est # False. #x_offset: 0 # D\u00e9finit la valeur du d\u00e9calage horizontal sur les \u00e9crans SH1106. La valeur par # d\u00e9faut est 0. ...","title":"\u00e9crans ssd1306 et sh1106"},{"location":"Config_Reference.html#display_data","text":"Support pour l'affichage de donn\u00e9es personnalis\u00e9es sur un \u00e9cran lcd. On peut cr\u00e9er un nombre quelconque de groupes d'affichage et un nombre quelconque d'\u00e9l\u00e9ments de donn\u00e9es sous ces groupes. L'\u00e9cran affichera tous les \u00e9l\u00e9ments de donn\u00e9es d'un groupe donn\u00e9 si l'option display_group de la section [display] est d\u00e9finie sur le nom du groupe en question. Un ensemble par d\u00e9faut de groupes d'affichage est automatiquement cr\u00e9\u00e9. On peut remplacer ou \u00e9tendre ces \u00e9l\u00e9ments display_data en rempla\u00e7ant les valeurs par d\u00e9faut dans le fichier de configuration principal printer.cfg. [display_data my_group_name my_data_name] position: # Ligne et colonne s\u00e9par\u00e9es par des virgules de la position de l'affichage \u00e0 # utiliser pour afficher l'information. Ce param\u00e8tre doit \u00eatre fourni. text: # Le texte \u00e0 afficher \u00e0 la position donn\u00e9e. Ce champ est \u00e9valu\u00e9 en utilisant les # mod\u00e8les de commande (voir docs/Command_Templates.md). # Ce param\u00e8tre doit \u00eatre fourni.","title":"[display_data]"},{"location":"Config_Reference.html#display_template","text":"Les \"macros\" de texte des donn\u00e9es d'affichage (on peut d\u00e9finir un nombre quelconque de sections avec un pr\u00e9fixe display_template). Voir le document mod\u00e8les de commande pour des informations sur l'\u00e9valuation des mod\u00e8les. Cette fonctionnalit\u00e9 permet de r\u00e9duire les d\u00e9finitions r\u00e9p\u00e9titives dans les sections display_data. On peut utiliser la fonction int\u00e9gr\u00e9e render() dans les sections display_data pour \u00e9valuer un mod\u00e8le. Par exemple, si l'on d\u00e9finit \"[display_template my_template] \", on peut alors utiliser \"{ render('my_template') } dans une section display_data. Cette fonctionnalit\u00e9 peut \u00e9galement \u00eatre utilis\u00e9e pour des mises \u00e0 jour continues des LEDs \u00e0 l'aide de la commande SET_LED_TEMPLATE . [display_template my_template_name] #param_<name>: # On peut sp\u00e9cifier un nombre quelconque d'options avec le pr\u00e9fixe \"param_\". Le nom # donn\u00e9 se verra attribuer la valeur donn\u00e9e (analys\u00e9e comme un litt\u00e9ral Python) et # sera disponible pendant l'expansion de la macro. Si le param\u00e8tre est pass\u00e9 dans # l'appel \u00e0 render(), alors cette valeur sera utilis\u00e9e pendant l'expansion de la macro. # Par exemple, une configuration avec \"param_speed = 75\" pourrait avoir un appelant # avec \"render('my_template_name', param_speed=80)\". Les noms de param\u00e8tres # peuvent ne pas utiliser de caract\u00e8res majuscules. text: # Le texte \u00e0 renvoyer lors du rendu de ce mod\u00e8le. Ce champ est \u00e9valu\u00e9 \u00e0 l'aide de # mod\u00e8les de commande (voir docs/Command_Templates.md). # Ce param\u00e8tre doit \u00eatre fourni.","title":"[display_template]"},{"location":"Config_Reference.html#display_glyph","text":"Affiche un glyphe personnalis\u00e9 sur les \u00e9crans le supportant. Le nom donn\u00e9 se verra attribu\u00e9 les donn\u00e9es d'affichage, donn\u00e9es qui pourront ensuite \u00eatre r\u00e9f\u00e9renc\u00e9es dans les mod\u00e8les d'affichage par leur nom entour\u00e9 de deux symboles \"tilde\", par exemple ~my_display_glyph~ Voir sample-glyphs.cfg pour quelques exemples. [display_glyph my_display_glyph] #data: # Les donn\u00e9es d'affichage, stock\u00e9es sous forme de 16 lignes compos\u00e9es de 16 bits (1 par # pixel) o\u00f9 '.' est un pixel vide et '*' est un pixel actif (par ex, \"****************\" pour afficher # une ligne horizontale pleine). # On peut \u00e9galement utiliser '0' pour un pixel vide et '1' pour un pixel actif. # Placez chaque ligne d'affichage sur une ligne de configuration distincte. Le glyphe doit \u00eatre # compos\u00e9 d'exactement 16 lignes de 16 bits chacune. Ce param\u00e8tre est facultatif. #hd44780_data: # Glyphe \u00e0 utiliser sur les \u00e9crans 20x4 hd44780. Le glyphe doit \u00eatre compos\u00e9 d'exactement # 8 lignes de 5 bits chacune. Ce param\u00e8tre est facultatif. #hd44780_slot: # L'index mat\u00e9riel hd44780 (0..7) pour stocker le glyphe. Si plusieurs images distinctes # utilisent le m\u00eame slot, assurez-vous de n'utiliser qu'une seule de ces images dans un # \u00e9cran donn\u00e9. Ce param\u00e8tre est requis si hd44780_data est sp\u00e9cifi\u00e9.","title":"[display_glyph]"},{"location":"Config_Reference.html#display-my_extra_display","text":"Si une section principale [display] a \u00e9t\u00e9 d\u00e9finie dans printer.cfg comme indiqu\u00e9 ci-dessus, il est possible de d\u00e9finir plusieurs affichages auxiliaires. Notez que les affichages auxiliaires ne supportent pas actuellement la fonctionnalit\u00e9 de menus, ils ne supportent donc pas les options \"menu\" ou la configuration de boutons. [display my_extra_display] # Voir la section \"affichage\" (display) pour les param\u00e8tres disponibles.","title":"[display my_extra_display]"},{"location":"Config_Reference.html#menu","text":"Menus de l'\u00e9cran LCD personnalisables. Un ensemble de menus par d\u00e9faut est automatiquement cr\u00e9\u00e9. On peut remplacer ou \u00e9tendre le menu en rempla\u00e7ant les valeurs par d\u00e9faut dans le fichier de configuration principal printer.cfg. Consultez le document sur les mod\u00e8les de commande pour obtenir des informations sur les attributs de menu disponibles lors du rendu du mod\u00e8le. # Param\u00e8tres communs disponibles pour toutes les sections de configuration de menu. #[menu __some_list __some_name] #type: disabled # \u00c9l\u00e9ment de menu d\u00e9sactiv\u00e9 de fa\u00e7on permanente, le seul attribut requis est 'type'. # Vous permet de d\u00e9sactiver/masquer facilement des \u00e9l\u00e9ments de menu existants. #[menu some_name] #type: # Un \u00e9l\u00e9ment parmi command, input, list, text : # command - \u00e9l\u00e9ment de menu de base avec divers d\u00e9clencheurs de script. # input - m\u00eame chose que 'command' mais avec des capacit\u00e9s de changement de valeur. # Pressez pour d\u00e9marrer/arr\u00eater le mode d'\u00e9dition. # list - permet de regrouper les \u00e9l\u00e9ments du menu dans une liste d\u00e9roulante. # Ajoutez \u00e0 la liste en cr\u00e9ant des configurations de menu en utilisant # \"some_list\" comme pr\u00e9fixe - par exemple : # [menu some_list some_item_in_the_list]. # vsdlist - identique \u00e0 'list' mais ajoutera les fichiers de la carte SD virtuelle # (sera supprim\u00e9 dans le futur) #name: # Nom de l'\u00e9l\u00e9ment de menu - \u00e9valu\u00e9 comme un mod\u00e8le. #enable: # Mod\u00e8le \u00e9valu\u00e9 \u00e0 True ou False. #index: # Position o\u00f9 l'\u00e9l\u00e9ment doit \u00eatre ins\u00e9r\u00e9 dans la liste. Par d\u00e9faut # l'\u00e9l\u00e9ment est ajout\u00e9 \u00e0 la fin. #[menu some_list] #type: list #name: #enable: # Voir ci-dessus pour une description de ces param\u00e8tres. #[menu some_list some_command] #type: command #name: #enable: # Voir ci-dessus pour une description de ces param\u00e8tres. #gcode: # Script \u00e0 ex\u00e9cuter lors d'un clic sur un bouton ou un clic long. \u00c9valu\u00e9 comme un # mod\u00e8le. #[menu some_list some_input] #type: input #name: #enable: # Voir ci-dessus pour une description de ces param\u00e8tres. #input: # Valeur initiale \u00e0 utiliser lors de l'\u00e9dition - \u00e9valu\u00e9e comme un mod\u00e8le. # Le r\u00e9sultat doit \u00eatre de type flottant. #input_min: # Valeur minimale de l''intervalle - \u00e9valu\u00e9e comme un mod\u00e8le. Par d\u00e9faut -99999. #input_max: # Valeur maximale de l'intervalle - \u00e9valu\u00e9e comme un mod\u00e8le. Par d\u00e9faut 99999. #input_step: # Pas d'\u00e9dition - Doit \u00eatre un nombre entier positif ou une valeur flottante. Poss\u00e8de # un pas de vitesse rapide interne. Lorsque \"(input_max - input_min) / input_step > 100\" # alors le pas de vitesse rapide est 10 * input_step sinon le pas de vitesse rapide # est le m\u00eame que celui de l'input_step. #realtime: # Cet attribut accepte une valeur bool\u00e9enne statique. Lorsqu'il est activ\u00e9, alors le script # gcode est ex\u00e9cut\u00e9 apr\u00e8s chaque changement de valeur. La valeur par d\u00e9faut est False. #gcode: # Script \u00e0 ex\u00e9cuter lors d'un clic sur un bouton, d'un clic long ou d'un changement de valeur. # \u00c9valu\u00e9 comme un mod\u00e8le. Le clic sur le bouton d\u00e9clenchera le d\u00e9but ou fin du mode d'\u00e9dition.","title":"[menu]"},{"location":"Config_Reference.html#capteurs-de-filaments","text":"","title":"Capteurs de filaments"},{"location":"Config_Reference.html#filament_switch_sensor","text":"Capteur de commutation de filament. Prise en charge de la d\u00e9tection de l'insertion et du d\u00e9placement du filament \u00e0 l'aide d'un capteur de commutation, tel qu'un interrupteur de fin de course. Voir la r\u00e9f\u00e9rence des commandes pour plus d'informations. [filament_switch_sensor my_sensor] #pause_on_runout: True # Lorsque d\u00e9fini sur True, une PAUSE sera ex\u00e9cut\u00e9e imm\u00e9diatement apr\u00e8s qu'un runout # soit d\u00e9tect\u00e9. Notez que si pause_on_runout est False et que le runout_gcode est omis, # la d\u00e9tection du runout est d\u00e9sactiv\u00e9e. Par d\u00e9faut, est True. #runout_gcode: # Une liste de commandes G-Code \u00e0 ex\u00e9cuter apr\u00e8s la d\u00e9tection d'une fin de filament. # Voir docs/Command_Templates.md pour le format G-Code. Si pause_on_runout est # r\u00e9gl\u00e9 sur True, ce G-code sera ex\u00e9cut\u00e9 apr\u00e8s la fin de la PAUSE. Par d\u00e9faut, aucune # commande G-Code n'est ex\u00e9cut\u00e9e. #insert_gcode: # Une liste de commandes G-Code \u00e0 ex\u00e9cuter apr\u00e8s qu'une insertion de filament soit d\u00e9tect\u00e9e. # Voir docs/Command_Templates.md pour le format G-Code. La valeur par d\u00e9faut est de # n'ex\u00e9cuter aucune commande G-Code, ce qui d\u00e9sactive la d\u00e9tection de l'insertion. #event_delay 3.0 # La dur\u00e9e minimale en secondes \u00e0 attendre entre les \u00e9v\u00e9nements. # Des \u00e9v\u00e9nements d\u00e9clench\u00e9s durant cette p\u00e9riode seront silencieusement ignor\u00e9s. # La valeur par d\u00e9faut est de 3 secondes. #pause_delay: 0.5 # Le d\u00e9lai, en secondes, entre l'envoi de la commande de pause et l'ex\u00e9cution du runout_gcode. # Il peut \u00eatre utile d'augmenter ce d\u00e9lai si OctoPrint pr\u00e9sente un comportement \u00e9trange lors de # la pause. La valeur par d\u00e9faut est 0.5 secondes. #switch_pin: # La broche sur laquelle l'interrupteur est connect\u00e9. # Ce param\u00e8tre doit \u00eatre fourni.","title":"[filament_switch_sensor]"},{"location":"Config_Reference.html#filament_motion_sensor","text":"Capteur de mouvement de filament. Prise en charge de la d\u00e9tection de pr\u00e9sence et d\u00e9placement du filament \u00e0 l'aide d'un encodeur basculant la broche de sortie pendant le mouvement du filament dans le capteur. Voir la r\u00e9f\u00e9rence des commandes pour plus d'informations. [filament_motion_sensor my_sensor] detection_length: 7.0 # La longueur minimale du filament tir\u00e9 \u00e0 travers le capteur d\u00e9clenchant # un changement d'\u00e9tat sur la broche de commutation. # La valeur par d\u00e9faut est 7 mm. extruder: # Le nom de la section de l'extrudeuse \u00e0 laquelle ce capteur est associ\u00e9. # Ce param\u00e8tre doit \u00eatre fourni. switch_pin: #pause_on_runout: #runout_gcode: #insert_gcode: #event_delay: #pause_delay: # Voir la section \"filament_switch_sensor\" pour une description des # param\u00e8tres ci-dessus.","title":"[filament_motion_sensor]"},{"location":"Config_Reference.html#tsl1401cl_filament_width_sensor","text":"Capteur de largeur de filament bas\u00e9 sur le TSLl401CL. Voir ce guide pour plus d'informations. [tsl1401cl_filament_width_sensor] #pin: #default_nominal_filament_diameter: 1.75 # (mm) # Diff\u00e9rence maximale de diam\u00e8tre de filament autoris\u00e9e en mm. #max_diff\u00e9rence: 0.2 # La distance entre le capteur et la chambre de fusion en mm. #measurement_delay: 100","title":"[tsl1401cl_filament_width_sensor]"},{"location":"Config_Reference.html#hall_filament_width_sensor","text":"Capteur Hall de largeur de filament (voir Capteur Hall de largeur de filament ). [hall_filament_width_sensor] adc1: adc2: # Broches d'entr\u00e9e analogiques connect\u00e9es au capteur. Ces param\u00e8tres doivent # \u00eatre fournis. #cal_dia1: 1.50 #cal_dia2: 2.00 # Les valeurs d'\u00e9talonnage (en mm) pour les capteurs. La valeur par d\u00e9faut est # 1,50 pour cal_dia1 et 2,00 pour cal_dia2. #raw_dia1: 9500 #raw_dia2: 10500 # Les valeurs brutes d'\u00e9talonnage des capteurs. La valeur par d\u00e9faut est 9500 # pour raw_dia1 et 10500 pour raw_dia2. #default_nominal_filament_diameter: 1.75 # Le diam\u00e8tre nominal du filament. Ce param\u00e8tre doit \u00eatre fourni. #max_difference: 0.200 # Diff\u00e9rence maximale autoris\u00e9e de diam\u00e8tre du filament en millim\u00e8tres (mm). # Si la diff\u00e9rence entre le diam\u00e8tre nominal du filament et la sortie du capteur # est sup\u00e9rieure \u00e0 +- max_difference, le multiplicateur d'extrusion est ramen\u00e9 \u00e0 # \u00e0 %100. La valeur par d\u00e9faut est de 0,200. #measurement_delay: 70 # La distance entre le capteur et la chambre de fusion/la buse en # millim\u00e8tres (mm). Le filament situ\u00e9 entre le capteur et la buse # sera trait\u00e9 comme le default_nominal_filament_diameter. # Ce module h\u00f4te fonctionne avec une logique FIFO. Il conserve chaque valeur # de capteur dans un tableau et les remet (POP) dans la bonne position. Ce # param\u00e8tre doit \u00eatre fourni. #enable: False # Capteur activ\u00e9 ou d\u00e9sactiv\u00e9 apr\u00e8s la mise sous tension. La valeur par d\u00e9faut est # d\u00e9sactiv\u00e9. #measurement_interval: 10 # La distance approximative (en mm) entre les lectures du capteur. La valeur # par d\u00e9faut est de 10mm. #logging: False # Le diam\u00e8tre de sortie vers le terminal et vers klipper.log peut \u00eatre activ\u00e9 par # ce param\u00e8tre. #min_diameter: 1.0 # Diam\u00e8tre minimal pour d\u00e9clencher le capteur virtuel filament_switch_sensor. #use_current_dia_while_delay: False # Utiliser le diam\u00e8tre actuel au lieu du diam\u00e8tre nominal pendant que le d\u00e9lai # de mesure n'est pas \u00e9coul\u00e9. #pause_on_runout: #runout_gcode: #insert_gcode: #event_delay: #pause_delay: # Voir la section \"filament_switch_sensor\" pour une description des # param\u00e8tres ci-dessus.","title":"[hall_filament_width_sensor]"},{"location":"Config_Reference.html#support-materiel-specifique-a-une-carte","text":"","title":"Support mat\u00e9riel sp\u00e9cifique \u00e0 une carte"},{"location":"Config_Reference.html#sx1509","text":"Configuration d'un expandeur SX1509 I2C vers GPIO. En raison du d\u00e9lai encouru par la communication I2C, vous ne devez PAS utiliser les broches du SX1509 comme activation du moteur pas \u00e0 pas, pas ou direction ou toute autre broche n\u00e9cessitant un changement de bit rapide. Il est pr\u00e9f\u00e9rable de les utiliser comme sorties num\u00e9riques statiques ou contr\u00f4l\u00e9es par gcode ou comme broches hardware-pwm pour des ventilateurs par exemple. On peut d\u00e9finir un nombre quelconque de sections avec un pr\u00e9fixe \"sx1509\". Chaque expandeur fournit un ensemble de 16 broches (sx1509_my_sx1509:PIN_0 \u00e0 sx1509_my_sx1509:PIN_15) pouvant \u00eatre utilis\u00e9es dans la configuration de l'imprimante. Voir le fichier generic-duet2-duex.cfg pour un exemple. [sx1509 my_sx1509] i2c_address: # Adresse I2C utilis\u00e9e par cet expandeur. Selon le mat\u00e9riel # il s'agit de l'une des adresses suivantes : 62 63 112 113. # Ce param\u00e8tre doit \u00eatre fourni. #i2c_mcu: #i2c_bus: #i2c_speed: # Voir la section \"param\u00e8tres I2C communs\" pour une description des # param\u00e8tres ci-dessus. #i2c_bus: # Si l'impl\u00e9mentation I2C de votre micro-contr\u00f4leur prend en charge # plusieurs bus I2C, vous pouvez sp\u00e9cifier le nom du bus ici. La valeur # par d\u00e9faut est d'utiliser le bus i2c par d\u00e9faut du micro-contr\u00f4leur.","title":"[sx1509]"},{"location":"Config_Reference.html#samd_sercom","text":"Configuration de SAMD SERCOM pour indiquer les broches \u00e0 utiliser sur un mat\u00e9riel SERCOM. On peut d\u00e9finir un nombre quelconque de sections avec le pr\u00e9fixe \"samd_sercom\". Chaque SERCOM doit \u00eatre configur\u00e9 avant de pouvoir \u00eatre utilis\u00e9 comme p\u00e9riph\u00e9rique SPI ou I2C. Placez cette section de configuration au-dessus de toute autre section qui utilise les bus SPI ou I2C. [samd_sercom my_sercom] sercom: # Le nom du bus sercom \u00e0 configurer dans le micro-contr\u00f4leur. # Les noms disponibles sont \"sercom0\", \"sercom1\", etc. # Ce param\u00e8tredoit \u00eatre fourni. tx_pin: # Broche MOSI pour la communication SPI, ou broche SDA (donn\u00e9es) pour la communication I2C. # La broche doit avoir une configuration pinmux valide pour le p\u00e9riph\u00e9rique SERCOM donn\u00e9. # Ce param\u00e8tre doit \u00eatre fourni. #rx_pin: # Broche MISO pour la communication SPI. Cette broche n'est pas utilis\u00e9e pour la communication I2C # (I2C utilise tx_pin pour l'envoi et la r\u00e9ception). # La broche doit avoir une configuration pinmux valide pour le p\u00e9riph\u00e9rique SERCOM donn\u00e9. # Ce param\u00e8tre est optionnel. clk_pin: # La broche CLK pour la communication SPI, ou la broche SCL (horloge) pour la communication I2C. # La broche doit avoir une configuration pinmux valide pour le p\u00e9riph\u00e9rique SERCOM donn\u00e9. # Ce param\u00e8tre doit \u00eatre fourni","title":"[samd_sercom]"},{"location":"Config_Reference.html#adc_scaled","text":"Mise \u00e0 l'\u00e9chelle analogique du Duet2 Maestro par lectures vref et vssa. D\u00e9finir une section adc_scaled permet d'activer des broches adc virtuelles (telles que \"my_name:PB0\") qui seront automatiquement ajust\u00e9es par les broches de surveillance vref et vssa de la carte. Assurez-vous de d\u00e9finir cette section de configuration au-dessus de toute section de configuration utilisant l'une de ces broches virtuelles. Voir le fichier generic-duet2-maestro.cfg pour un exemple. [adc_scaled my_name] vref_pin : # La broche ADC \u00e0 utiliser pour le contr\u00f4le de VREF. Ce param\u00e8tre doit \u00eatre # fourni. vssa_pin : # La broche ADC \u00e0 utiliser pour la surveillance VSSA. Ce param\u00e8tre doit \u00eatre # fourni. #smooth_time : 2.0 # Une dur\u00e9e (en secondes) durant laquelle les mesures de vref et vssa # seront liss\u00e9es pour r\u00e9duire l'impact du bruit des mesures. # La valeur par d\u00e9faut est de 2 secondes.","title":"[adc_scaled]"},{"location":"Config_Reference.html#replicape","text":"Support de Replicape - voir le guide beaglebone et le fichier generic-replicape.cfg pour un exemple. # La section de configuration \"replicape\" ajoute \"replicape:stepper_x_enable\" pour # l'activation de broches virtuelles de moteur (pour les moteurs X, Y, Z, E et H) et # \"replicape:power_x\" des broches de sortie PWM (pour les pilotes, e, h, fan0, fan1, # fan2, et fan3) utilisables ailleurs dans le fichier de configuration. [replicape] revision: # La r\u00e9vision du mat\u00e9riel replicape. Actuellement, seule la r\u00e9vision \"B3\" est # support\u00e9e. Ce param\u00e8tre doit \u00eatre fourni. #enable_pin: !gpio0_20 # La broche d'activation globale de la replicape. La valeur par d\u00e9faut est !gpio0_20 # (aka P9_41). host_mcu : # Le nom de la section de configuration mcu communiquant avec la section de # l'instance mcu du \"processus linux\" de Klipper. Ce param\u00e8tre doit \u00eatre # fourni. #standstill_power_down: False # Ce param\u00e8tre contr\u00f4le la ligne CFG6_ENN sur tous les moteurs pas \u00e0 pas. # True r\u00e8gle les lignes d'activation sur \"ouvert\". La valeur par d\u00e9faut est # False. #stepper_x_microstep_mode: #stepper_y_microstep_mode: #stepper_z_microstep_mode: #stepper_e_microstep_mode: #stepper_h_microstep_mode: # Ce param\u00e8tre contr\u00f4le les broches CFG1 et CFG2 du pilote de moteur donn\u00e9. # Les options disponibles sont : disable, 1, 2, spread2, 4, 16, spread4, spread16, # stealth4, et stealth16. La valeur par d\u00e9faut est disable. #stepper_x_current: #stepper_y_current: #stepper_z_current: #stepper_e_current: #stepper_h_current: # Le courant maximum configur\u00e9 (en Amp\u00e8res) du moteur pas \u00e0 pas. # Ce param\u00e8tre doit \u00eatre fourni si le moteur pas \u00e0 pas n'est pas dans un # mode d\u00e9sactiv\u00e9. #stepper_x_chopper_off_time_high: #stepper_y_chopper_off_time_high: #stepper_z_chopper_off_time_high: #stepper_e_chopper_off_time_high: #stepper_h_chopper_off_time_high: # Ce param\u00e8tre contr\u00f4le la broche CFG0 du pilote du moteur pas \u00e0 pas. # (True place CFG0 en haut, False le place en bas). La valeur par d\u00e9faut est False. #stepper_x_chopper_hysteresis_high: #stepper_y_chopper_hysteresis_high: #stepper_z_chopper_hysteresis_high: #stepper_e_chopper_hysteresis_high: #stepper_h_chopper_hysteresis_high: # Ce param\u00e8tre contr\u00f4le la broche CFG4 du pilote du moteur pas \u00e0 pas. # (True place CFG4 en haut, False le place en bas). La valeur par d\u00e9faut est False. #stepper_x_chopper_blank_time_high: #stepper_y_chopper_blank_time_high: #stepper_z_chopper_blank_time_high: #stepper_e_chopper_blank_time_high: #stepper_h_chopper_blank_time_high: # Ce param\u00e8tre contr\u00f4le la broche CFG5 du pilote du moteur pas \u00e0 pas. # (True place CFG5 en haut, False le place en bas). La valeur par d\u00e9faut est True.","title":"[replicape]"},{"location":"Config_Reference.html#autres-modules-specifiques","text":"","title":"Autres modules sp\u00e9cifiques"},{"location":"Config_Reference.html#palette2","text":"Prise en charge des multimat\u00e9riaux de la Palette 2 - assure une int\u00e9gration plus \u00e9troite de la prise en charge des p\u00e9riph\u00e9riques de la Palette 2 en mode connect\u00e9. Ce module n\u00e9cessite \u00e9galement [virtual_sdcard] et [pause_resume] pour une fonctionnalit\u00e9 compl\u00e8te. Si vous utilisez ce module, n'utilisez pas le plugin Palette 2 pour Octoprint car ils entreront en conflit, et le module ne pourra pas s'initialiser correctement, ce qui fera \u00e9chouer votre impression. Si vous utilisez Octoprint et que vous diffusez du gcode sur le port s\u00e9rie au lieu d'imprimer \u00e0 partir de virtual_sd, alors supprimez M1 et M0 de Commandes de pause dans Param\u00e8tres > Connexion s\u00e9rie > Firmware & protocole \u00e9vitera d'avoir \u00e0 lancer l'impression sur la Palette 2 et de devoir lever la pause dans Octoprint pour que l'impression commence. [palette2] serial: # Le port s\u00e9rie \u00e0 connecter \u00e0 la Palette 2. #baud: 115200 # Le d\u00e9bit en bauds \u00e0 utiliser. La valeur par d\u00e9faut est 115200. #feedrate_splice: 0.8 # Le taux d'avance \u00e0 utiliser lors de l'\u00e9pissage, la valeur par d\u00e9faut est 0.8. #feedrate_normal: 1.0 # L'avance \u00e0 utiliser apr\u00e8s l'\u00e9pissage, la valeur par d\u00e9faut est 1.0. #auto_load_speed: 2 # Vitesse d'extrusion lors du chargement automatique, par d\u00e9faut 2 (mm/s). #auto_cancel_variation: 0.1 # Annulation automatique de l'impression lorsque la variation du ping est sup\u00e9rieure \u00e0 ce seuil.","title":"[palette2]"},{"location":"Config_Reference.html#angle","text":"Prise en charge du capteur d'angle Hall magn\u00e9tique pour la lecture des mesures de l'angle de l'arbre du moteur pas \u00e0 pas \u00e0 l'aide des puces SPI a1333, as5047d ou tle5012b. Les mesures sont disponibles via le serveur API et l' outil d'analyse de mouvement . Voir la r\u00e9f\u00e9rence G-Code pour les commandes disponibles. [angle my_angle_sensor] sensor_type: # Le type de la puce du capteur magn\u00e9tique \u00e0 effet Hall. Les choix disponibles # sont \"a1333\", \"as5047d\" et \"tle5012b\". Ce param\u00e8tre doit \u00eatre sp\u00e9cifi\u00e9. #sample_period: 0.000400 # La p\u00e9riode de requ\u00eate (en secondes) \u00e0 utiliser lors des mesures. La valeur par # d\u00e9faut est de 0.000400 (ce qui correspond \u00e0 2500 \u00e9chantillons par seconde). #stepper: # Le nom du pilote moteur pas \u00e0 pas auquel le capteur d'angle est attach\u00e9 (ex, # \"stepper_x\"). La d\u00e9finition de cette valeur active un \u00e9talonnage d'angle. # Pour utiliser cette fonction, le paquet Python \"numpy\" doit \u00eatre install\u00e9. # Par d\u00e9faut, l'\u00e9talonnage d'angle n'est pas activ\u00e9 pour un capteur d'angle. cs_pin: # La broche d'activation SPI du capteur. Ce param\u00e8tre doit \u00eatre fourni. #spi_speed: #spi_bus: #spi_software_sclk_pin: #spi_software_mosi_pin: #spi_software_miso_pin: # Voir la section \"param\u00e8tres SPI communs\" pour une description des # param\u00e8tres ci-dessus.","title":"[angle]"},{"location":"Config_Reference.html#parametres-communs-aux-bus","text":"","title":"Param\u00e8tres communs aux bus"},{"location":"Config_Reference.html#parametres-spi-communs","text":"Les param\u00e8tres suivants sont g\u00e9n\u00e9ralement disponibles pour les dispositifs utilisant un bus SPI. #spi_speed: # La vitesse SPI (en hz) \u00e0 utiliser lors de la communication avec le p\u00e9riph\u00e9rique. # La valeur par d\u00e9faut d\u00e9pend du type de p\u00e9riph\u00e9rique. #spi_bus: # Si le micro-contr\u00f4leur supporte plusieurs bus SPI alors on peut sp\u00e9cifier le nom # du bus du micro-contr\u00f4leur ici. La valeur par d\u00e9faut d\u00e9pend du type de # micro-contr\u00f4leur. #spi_software_sclk_pin: #spi_software_mosi_pin: #spi_software_miso_pin: # Sp\u00e9cifiez les param\u00e8tres ci-dessus pour utiliser le \"SPI logiciel\". Ce mode ne # n\u00e9cessite pas le support mat\u00e9riel du micro-contr\u00f4leur (typiquement n'importe # quelle broche d'usage g\u00e9n\u00e9ral peut \u00eatre utilis\u00e9e). La valeur par d\u00e9faut est de # ne pas utiliser le \"spi logiciel\".","title":"Param\u00e8tres SPI communs"},{"location":"Config_Reference.html#parametres-i2c-communs","text":"Les param\u00e8tres suivants sont g\u00e9n\u00e9ralement disponibles pour les dispositifs utilisant un bus I2C. Notez que le support actuel des micro-contr\u00f4leurs de Klipper pour i2c n'est g\u00e9n\u00e9ralement pas tol\u00e9rant au bruit sur la ligne. Des erreurs inattendues sur les fils i2c peuvent entra\u00eener une erreur d'ex\u00e9cution de Klipper. Le support de Klipper de r\u00e9cup\u00e9ration des erreurs varie selon le type de micro-contr\u00f4leur. Il est g\u00e9n\u00e9ralement recommand\u00e9 de n'utiliser que des dispositifs i2c se trouvant sur la m\u00eame carte de circuit imprim\u00e9 que le microcontr\u00f4leur. La plupart des impl\u00e9mentations de micro-contr\u00f4leurs Klipper ne supportent qu'une i2c_speed de 100000. Le micro-contr\u00f4leur Klipper \"linux\" supporte une vitesse de 400000, mais elle doit \u00eatre d\u00e9finie dans le syst\u00e8me d'exploitation sinon le param\u00e8tre i2c_speed est ignor\u00e9. Le micro-contr\u00f4leur Klipper \"rp2040\" supporte un taux de 400000 via le param\u00e8tre i2c_speed . Tous les autres micro-contr\u00f4leurs Klipper utilisent un taux de 100000 et ignorent le param\u00e8tre i2c_speed . #i2c_address: # L'adresse i2c du p\u00e9riph\u00e9rique. Elle doit \u00eatre sp\u00e9cifi\u00e9e sous la forme d'un nombre d\u00e9cimal # (pas en hexad\u00e9cimal). La valeur par d\u00e9faut d\u00e9pend du type de p\u00e9riph\u00e9rique. #i2c_mcu: # Le nom du micro-contr\u00f4leur auquel la puce est connect\u00e9e. # La valeur par d\u00e9faut est \"mcu\". #i2c_bus: # Si le micro-contr\u00f4leur supporte plusieurs bus I2C, on peut sp\u00e9cifier le bus du micro-contr\u00f4leur. # La valeur par d\u00e9faut d\u00e9pend du type de micro-contr\u00f4leur. #i2c_speed: # La vitesse I2C (en Hz) \u00e0 utiliser lors de la communication avec le p\u00e9riph\u00e9rique. # L'impl\u00e9mentation de Klipper pour la plupart des micro-contr\u00f4leurs est cod\u00e9e en dur \u00e0 100000, # modifier cette valeur n'a aucun effet. La valeur par d\u00e9faut est 100000.","title":"Param\u00e8tres I2C communs"},{"location":"Config_checks.html","text":"Contr\u00f4les de la configuration \u00b6 Ce document fournit une liste des \u00e9tapes permettant de v\u00e9rifier les affectations des broches dans le fichier printer.cfg de Klipper. Il est conseill\u00e9 d'ex\u00e9cuter ces \u00e9tapes apr\u00e8s avoir suivi les \u00e9tapes du document d'installation . Pendant ce guide, il peut \u00eatre n\u00e9cessaire d'apporter des modifications au fichier de configuration de Klipper. Veillez \u00e0 \u00e9mettre une commande RESTART apr\u00e8s chaque modification du fichier de configuration pour vous assurer que la modification prend effet (tapez \"restart\" dans l'onglet du terminal Octoprint et cliquez ensuite sur \"Send\"). C'est aussi une bonne id\u00e9e d'envoyer une commande STATUS apr\u00e8s chaque RESTART pour v\u00e9rifier que le fichier de configuration a \u00e9t\u00e9 charg\u00e9 avec succ\u00e8s. V\u00e9rifier la temp\u00e9rature \u00b6 Commencez par v\u00e9rifier que les temp\u00e9ratures sont correctement rapport\u00e9es. Naviguez vers l'onglet temp\u00e9rature d'Octoprint. V\u00e9rifiez que la temp\u00e9rature de la buse et du plateau chauffant (le cas \u00e9ch\u00e9ant) est pr\u00e9sente et n'augmente pas. Si elle augmente, mettez l'imprimante hors tension. Si les temp\u00e9ratures ne sont pas pr\u00e9cises, v\u00e9rifiez les param\u00e8tres \"sensor_type\" et \"sensor_pin\" pour la buse et/ou le plateau chauffant. V\u00e9rifier M112 \u00b6 Naviguez vers l'onglet du terminal Octoprint et lancez une commande M112 dans la bo\u00eete du terminal. Cette commande demande \u00e0 Klipper de se mettre dans un \u00e9tat \"d'arr\u00eat\". Octoprint se d\u00e9connectera de Klipper - naviguez vers la zone de connexion et cliquez sur \"Connecter\" pour reconnecter Octoprint. Ensuite, naviguez vers l'onglet temp\u00e9rature d'Octoprint et v\u00e9rifiez que les temp\u00e9ratures continuent \u00e0 se mettre \u00e0 jour et qu'elles n'augmentent pas. Si les temp\u00e9ratures augmentent, coupez l'alimentation de l'imprimante. La commande M112 fait passer Klipper dans un \u00e9tat \"d'arr\u00eat\". Pour effacer cet \u00e9tat, lancez la commande FIRMWARE_RESTART dans l'onglet du terminal Octoprint. V\u00e9rifier la cartouche chauffante \u00b6 Naviguez jusqu'\u00e0 l'onglet temp\u00e9rature d'Octoprint et tapez 50 suivi d'une entr\u00e9e dans la bo\u00eete de temp\u00e9rature \"Tool\". La temp\u00e9rature de l'extrudeuse dans le graphique devrait commencer \u00e0 augmenter (dans les 30 secondes environ). Ensuite, allez dans la bo\u00eete d\u00e9roulante de la temp\u00e9rature de l'outil et s\u00e9lectionnez \"Off\". Apr\u00e8s plusieurs minutes, la temp\u00e9rature devrait commencer \u00e0 revenir \u00e0 sa valeur initiale de temp\u00e9rature ambiante. Si la temp\u00e9rature n'augmente pas, v\u00e9rifiez le param\u00e8tre \"heater_pin\" dans la configuration. Si l'imprimante est \u00e9quip\u00e9e d'un plateau chauffant, effectuez \u00e0 nouveau le test ci-dessus avec le plateau. V\u00e9rifier l'activation du moteur pas \u00e0 pas \u00b6 V\u00e9rifiez que tous les axes de l'imprimante peuvent se d\u00e9placer librement manuellement (les moteurs pas \u00e0 pas sont d\u00e9sactiv\u00e9s). Si ce n'est pas le cas, lancez une commande M84 pour d\u00e9sactiver les moteurs. Si l'un des axes ne peut toujours pas se d\u00e9placer librement, v\u00e9rifiez la configuration de la \"broche d'activation\" du moteur pas \u00e0 pas pour l'axe en question. Sur la plupart des pilotes de moteurs pas \u00e0 pas, la broche d'activation du moteur est \"active basse\" et la broche d'activation doit donc \u00eatre pr\u00e9c\u00e9d\u00e9e d'un \" !\" (par exemple, \"enable_pin : !ar38\"). V\u00e9rifier les capteurs de fin de course \u00b6 D\u00e9placez manuellement tous les axes de l'imprimante afin qu'aucun d'entre eux ne soit en contact avec une but\u00e9e. Envoyez une commande QUERY_ENDSTOPS via l'onglet du terminal Octoprint. L'imprimante devrait r\u00e9pondre avec l'\u00e9tat actuel de toutes les but\u00e9es configur\u00e9es et elles devraient toutes rapporter un \u00e9tat \"ouvert\". Pour chacun des arr\u00eats, r\u00e9ex\u00e9cutez la commande QUERY_ENDSTOPS en d\u00e9clenchant manuellement l'arr\u00eat. La commande QUERY_ENDSTOPS doit indiquer que la fin de course est \"TRIGGERED\". Si la fin de course semble invers\u00e9e (elle signale qu'elle est \"ouverte\" lorsqu'elle est d\u00e9clench\u00e9e et vice-versa), ajoutez un \" !\" \u00e0 la d\u00e9finition de la broche (par exemple, \"endstop_pin : ^!ar3\"), ou supprimez le \" !\" s'il est d\u00e9j\u00e0 pr\u00e9sent. Si la fin de course ne change pas du tout, cela indique g\u00e9n\u00e9ralement que la fin de course est connect\u00e9e \u00e0 une autre broche. Cependant, cela peut \u00e9galement n\u00e9cessiter une modification du param\u00e8tre de pullup de la broche (le '^' au d\u00e9but du nom endstop_pin - la plupart des imprimantes utilisent une r\u00e9sistance pullup et le '^' doit \u00eatre pr\u00e9sent). V\u00e9rifier les moteurs pas \u00e0 pas \u00b6 Utilisez la commande STEPPER_BUZZ pour v\u00e9rifier la connectivit\u00e9 de chaque moteur pas \u00e0 pas. Commencez par positionner manuellement l'axe donn\u00e9 \u00e0 un point m\u00e9dian, puis ex\u00e9cutez la commande STEPPER_BUZZ STEPPER=stepper_x . La commande STEPPER_BUZZ fera en sorte que le moteur pas \u00e0 pas donn\u00e9 se d\u00e9place d'un millim\u00e8tre dans une direction positive, puis il reviendra \u00e0 sa position de d\u00e9part. (Si la fin de course est d\u00e9finie \u00e0 position_endstop=0, alors au d\u00e9but de chaque mouvement, le stepper s'\u00e9loignera de la fin de course). Il effectuera cette oscillation dix fois. Si le moteur pas \u00e0 pas ne bouge pas du tout, v\u00e9rifiez les r\u00e9glages \"enable_pin\" et \"step_pin\" du moteur pas \u00e0 pas. Si le moteur pas \u00e0 pas se d\u00e9place mais ne revient pas \u00e0 sa position initiale, v\u00e9rifiez le r\u00e9glage \"dir_pin\". Si le moteur pas \u00e0 pas oscille dans une direction incorrecte, cela indique g\u00e9n\u00e9ralement que le param\u00e8tre \"dir_pin\" de l'axe doit \u00eatre invers\u00e9. Pour ce faire, il suffit d'ajouter un \" !\" au param\u00e8tre \"dir_pin\" dans le fichier de configuration de l'imprimante (ou de le supprimer s'il y en a d\u00e9j\u00e0 un). Si le moteur se d\u00e9place de mani\u00e8re significativement sup\u00e9rieure ou inf\u00e9rieure \u00e0 un millim\u00e8tre, v\u00e9rifiez le param\u00e8tre \"rotation_distance\". Ex\u00e9cutez le test ci-dessus pour chaque moteur pas \u00e0 pas d\u00e9fini dans le fichier de configuration. (D\u00e9finissez le param\u00e8tre STEPPER de la commande STEPPER_BUZZ au nom de la section de la configuration qui doit \u00eatre test\u00e9e). S'il n'y a pas de filament dans l'extrudeur, on peut utiliser STEPPER_BUZZ pour v\u00e9rifier la connectivit\u00e9 du moteur de l'extrudeur (utilisez STEPPER=extrudeur). Sinon, il est pr\u00e9f\u00e9rable de tester le moteur de l'extrudeur s\u00e9par\u00e9ment (voir la section suivante). Apr\u00e8s avoir v\u00e9rifi\u00e9 tous les arr\u00eats et tous les moteurs pas \u00e0 pas, le m\u00e9canisme d'auto-home doit \u00eatre test\u00e9. Envoyez une commande G28 pour ramener tous les axes \u00e0 leur position initiale. Coupez l'alimentation de l'imprimante si elle ne se positionne pas correctement. R\u00e9p\u00e9tez les \u00e9tapes de v\u00e9rification des fins de course et des moteurs pas \u00e0 pas si n\u00e9cessaire. V\u00e9rifier le moteur de l'extrudeur \u00b6 Pour tester le moteur de l'extrudeur, il sera n\u00e9cessaire de chauffer l'extrudeur \u00e0 une temp\u00e9rature d'impression. Naviguez vers l'onglet temp\u00e9rature d'Octoprint et s\u00e9lectionnez une temp\u00e9rature cible dans la bo\u00eete d\u00e9roulante de temp\u00e9rature (ou entrez manuellement une temp\u00e9rature appropri\u00e9e). Attendez que l'imprimante atteigne la temp\u00e9rature d\u00e9sir\u00e9e. Naviguez ensuite vers l'onglet de contr\u00f4le Octoprint et cliquez sur le bouton \"Extrude\". V\u00e9rifiez que le moteur de l'extrudeur tourne dans la bonne direction. Si ce n'est pas le cas, consultez les conseils de d\u00e9pannage de la section pr\u00e9c\u00e9dente pour confirmer les param\u00e8tres \"enable_pin\", \"step_pin\" et \"dir_pin\" de l'extrudeur. Calibrer les param\u00e8tres PID \u00b6 Klipper prend en charge le r\u00e9gulateur PID pour l'extrudeuse et le chauffage du lit. Afin d'utiliser ce m\u00e9canisme de contr\u00f4le, il est n\u00e9cessaire de calibrer les param\u00e8tres PID sur chaque imprimante (les param\u00e8tres PID trouv\u00e9s dans d'autres micrologiciels ou dans les fichiers de configuration d'exemple fonctionnent souvent mal). Pour calibrer l'extrudeur, naviguez dans l'onglet du terminal OctoPrint et ex\u00e9cutez la commande PID_CALIBRATE. Par exemple : PID_CALIBRATE HEATER=extruder TARGET=170 A la fin du test de r\u00e9glage, ex\u00e9cutez SAVE_CONFIG pour mettre \u00e0 jour le fichier printer.cfg avec les nouveaux param\u00e8tres PID. Si l'imprimante est \u00e9quip\u00e9e d'un lit chauffant et qu'elle peut \u00eatre pilot\u00e9e par PWM (Pulse Width Modulation), il est recommand\u00e9 d'utiliser la commande PID pour le plateau (lorsque le chauffage du lit est contr\u00f4l\u00e9 \u00e0 l'aide de l'algorithme PID, il peut s'allumer et s'\u00e9teindre dix fois par seconde, ce qui peut ne pas convenir aux chauffages utilisant un interrupteur m\u00e9canique). Une commande typique de calibrage PID du plateau est : PID_CALIBRATE HEATER=heater_bed TARGET=60 Prochaines \u00e9tapes \u00b6 Ce guide a pour but d'aider \u00e0 la v\u00e9rification de base des param\u00e8tres des broches dans le fichier de configuration de Klipper. Veillez \u00e0 lire le guide bed leveling . Consultez \u00e9galement le document Slicers pour obtenir des informations sur la configuration d'un trancheur avec Klipper. Apr\u00e8s avoir v\u00e9rifi\u00e9 que l'impression de base fonctionne, il est bon d'envisager de calibrer l'avance de pression . Il peut \u00eatre n\u00e9cessaire d'effectuer d'autres types de calibrage d\u00e9taill\u00e9 de l'imprimante - un certain nombre de guides sont disponibles en ligne pour vous aider (par exemple, faites une recherche sur le Web pour \"3d printer calibration\"). Par exemple, si vous rencontrez un effet appel\u00e9 \"ringing\", vous pouvez essayer de suivre le guide de r\u00e9glage de la compensation de r\u00e9sonance .","title":"Contr\u00f4les de la configuration"},{"location":"Config_checks.html#controles-de-la-configuration","text":"Ce document fournit une liste des \u00e9tapes permettant de v\u00e9rifier les affectations des broches dans le fichier printer.cfg de Klipper. Il est conseill\u00e9 d'ex\u00e9cuter ces \u00e9tapes apr\u00e8s avoir suivi les \u00e9tapes du document d'installation . Pendant ce guide, il peut \u00eatre n\u00e9cessaire d'apporter des modifications au fichier de configuration de Klipper. Veillez \u00e0 \u00e9mettre une commande RESTART apr\u00e8s chaque modification du fichier de configuration pour vous assurer que la modification prend effet (tapez \"restart\" dans l'onglet du terminal Octoprint et cliquez ensuite sur \"Send\"). C'est aussi une bonne id\u00e9e d'envoyer une commande STATUS apr\u00e8s chaque RESTART pour v\u00e9rifier que le fichier de configuration a \u00e9t\u00e9 charg\u00e9 avec succ\u00e8s.","title":"Contr\u00f4les de la configuration"},{"location":"Config_checks.html#verifier-la-temperature","text":"Commencez par v\u00e9rifier que les temp\u00e9ratures sont correctement rapport\u00e9es. Naviguez vers l'onglet temp\u00e9rature d'Octoprint. V\u00e9rifiez que la temp\u00e9rature de la buse et du plateau chauffant (le cas \u00e9ch\u00e9ant) est pr\u00e9sente et n'augmente pas. Si elle augmente, mettez l'imprimante hors tension. Si les temp\u00e9ratures ne sont pas pr\u00e9cises, v\u00e9rifiez les param\u00e8tres \"sensor_type\" et \"sensor_pin\" pour la buse et/ou le plateau chauffant.","title":"V\u00e9rifier la temp\u00e9rature"},{"location":"Config_checks.html#verifier-m112","text":"Naviguez vers l'onglet du terminal Octoprint et lancez une commande M112 dans la bo\u00eete du terminal. Cette commande demande \u00e0 Klipper de se mettre dans un \u00e9tat \"d'arr\u00eat\". Octoprint se d\u00e9connectera de Klipper - naviguez vers la zone de connexion et cliquez sur \"Connecter\" pour reconnecter Octoprint. Ensuite, naviguez vers l'onglet temp\u00e9rature d'Octoprint et v\u00e9rifiez que les temp\u00e9ratures continuent \u00e0 se mettre \u00e0 jour et qu'elles n'augmentent pas. Si les temp\u00e9ratures augmentent, coupez l'alimentation de l'imprimante. La commande M112 fait passer Klipper dans un \u00e9tat \"d'arr\u00eat\". Pour effacer cet \u00e9tat, lancez la commande FIRMWARE_RESTART dans l'onglet du terminal Octoprint.","title":"V\u00e9rifier M112"},{"location":"Config_checks.html#verifier-la-cartouche-chauffante","text":"Naviguez jusqu'\u00e0 l'onglet temp\u00e9rature d'Octoprint et tapez 50 suivi d'une entr\u00e9e dans la bo\u00eete de temp\u00e9rature \"Tool\". La temp\u00e9rature de l'extrudeuse dans le graphique devrait commencer \u00e0 augmenter (dans les 30 secondes environ). Ensuite, allez dans la bo\u00eete d\u00e9roulante de la temp\u00e9rature de l'outil et s\u00e9lectionnez \"Off\". Apr\u00e8s plusieurs minutes, la temp\u00e9rature devrait commencer \u00e0 revenir \u00e0 sa valeur initiale de temp\u00e9rature ambiante. Si la temp\u00e9rature n'augmente pas, v\u00e9rifiez le param\u00e8tre \"heater_pin\" dans la configuration. Si l'imprimante est \u00e9quip\u00e9e d'un plateau chauffant, effectuez \u00e0 nouveau le test ci-dessus avec le plateau.","title":"V\u00e9rifier la cartouche chauffante"},{"location":"Config_checks.html#verifier-lactivation-du-moteur-pas-a-pas","text":"V\u00e9rifiez que tous les axes de l'imprimante peuvent se d\u00e9placer librement manuellement (les moteurs pas \u00e0 pas sont d\u00e9sactiv\u00e9s). Si ce n'est pas le cas, lancez une commande M84 pour d\u00e9sactiver les moteurs. Si l'un des axes ne peut toujours pas se d\u00e9placer librement, v\u00e9rifiez la configuration de la \"broche d'activation\" du moteur pas \u00e0 pas pour l'axe en question. Sur la plupart des pilotes de moteurs pas \u00e0 pas, la broche d'activation du moteur est \"active basse\" et la broche d'activation doit donc \u00eatre pr\u00e9c\u00e9d\u00e9e d'un \" !\" (par exemple, \"enable_pin : !ar38\").","title":"V\u00e9rifier l'activation du moteur pas \u00e0 pas"},{"location":"Config_checks.html#verifier-les-capteurs-de-fin-de-course","text":"D\u00e9placez manuellement tous les axes de l'imprimante afin qu'aucun d'entre eux ne soit en contact avec une but\u00e9e. Envoyez une commande QUERY_ENDSTOPS via l'onglet du terminal Octoprint. L'imprimante devrait r\u00e9pondre avec l'\u00e9tat actuel de toutes les but\u00e9es configur\u00e9es et elles devraient toutes rapporter un \u00e9tat \"ouvert\". Pour chacun des arr\u00eats, r\u00e9ex\u00e9cutez la commande QUERY_ENDSTOPS en d\u00e9clenchant manuellement l'arr\u00eat. La commande QUERY_ENDSTOPS doit indiquer que la fin de course est \"TRIGGERED\". Si la fin de course semble invers\u00e9e (elle signale qu'elle est \"ouverte\" lorsqu'elle est d\u00e9clench\u00e9e et vice-versa), ajoutez un \" !\" \u00e0 la d\u00e9finition de la broche (par exemple, \"endstop_pin : ^!ar3\"), ou supprimez le \" !\" s'il est d\u00e9j\u00e0 pr\u00e9sent. Si la fin de course ne change pas du tout, cela indique g\u00e9n\u00e9ralement que la fin de course est connect\u00e9e \u00e0 une autre broche. Cependant, cela peut \u00e9galement n\u00e9cessiter une modification du param\u00e8tre de pullup de la broche (le '^' au d\u00e9but du nom endstop_pin - la plupart des imprimantes utilisent une r\u00e9sistance pullup et le '^' doit \u00eatre pr\u00e9sent).","title":"V\u00e9rifier les capteurs de fin de course"},{"location":"Config_checks.html#verifier-les-moteurs-pas-a-pas","text":"Utilisez la commande STEPPER_BUZZ pour v\u00e9rifier la connectivit\u00e9 de chaque moteur pas \u00e0 pas. Commencez par positionner manuellement l'axe donn\u00e9 \u00e0 un point m\u00e9dian, puis ex\u00e9cutez la commande STEPPER_BUZZ STEPPER=stepper_x . La commande STEPPER_BUZZ fera en sorte que le moteur pas \u00e0 pas donn\u00e9 se d\u00e9place d'un millim\u00e8tre dans une direction positive, puis il reviendra \u00e0 sa position de d\u00e9part. (Si la fin de course est d\u00e9finie \u00e0 position_endstop=0, alors au d\u00e9but de chaque mouvement, le stepper s'\u00e9loignera de la fin de course). Il effectuera cette oscillation dix fois. Si le moteur pas \u00e0 pas ne bouge pas du tout, v\u00e9rifiez les r\u00e9glages \"enable_pin\" et \"step_pin\" du moteur pas \u00e0 pas. Si le moteur pas \u00e0 pas se d\u00e9place mais ne revient pas \u00e0 sa position initiale, v\u00e9rifiez le r\u00e9glage \"dir_pin\". Si le moteur pas \u00e0 pas oscille dans une direction incorrecte, cela indique g\u00e9n\u00e9ralement que le param\u00e8tre \"dir_pin\" de l'axe doit \u00eatre invers\u00e9. Pour ce faire, il suffit d'ajouter un \" !\" au param\u00e8tre \"dir_pin\" dans le fichier de configuration de l'imprimante (ou de le supprimer s'il y en a d\u00e9j\u00e0 un). Si le moteur se d\u00e9place de mani\u00e8re significativement sup\u00e9rieure ou inf\u00e9rieure \u00e0 un millim\u00e8tre, v\u00e9rifiez le param\u00e8tre \"rotation_distance\". Ex\u00e9cutez le test ci-dessus pour chaque moteur pas \u00e0 pas d\u00e9fini dans le fichier de configuration. (D\u00e9finissez le param\u00e8tre STEPPER de la commande STEPPER_BUZZ au nom de la section de la configuration qui doit \u00eatre test\u00e9e). S'il n'y a pas de filament dans l'extrudeur, on peut utiliser STEPPER_BUZZ pour v\u00e9rifier la connectivit\u00e9 du moteur de l'extrudeur (utilisez STEPPER=extrudeur). Sinon, il est pr\u00e9f\u00e9rable de tester le moteur de l'extrudeur s\u00e9par\u00e9ment (voir la section suivante). Apr\u00e8s avoir v\u00e9rifi\u00e9 tous les arr\u00eats et tous les moteurs pas \u00e0 pas, le m\u00e9canisme d'auto-home doit \u00eatre test\u00e9. Envoyez une commande G28 pour ramener tous les axes \u00e0 leur position initiale. Coupez l'alimentation de l'imprimante si elle ne se positionne pas correctement. R\u00e9p\u00e9tez les \u00e9tapes de v\u00e9rification des fins de course et des moteurs pas \u00e0 pas si n\u00e9cessaire.","title":"V\u00e9rifier les moteurs pas \u00e0 pas"},{"location":"Config_checks.html#verifier-le-moteur-de-lextrudeur","text":"Pour tester le moteur de l'extrudeur, il sera n\u00e9cessaire de chauffer l'extrudeur \u00e0 une temp\u00e9rature d'impression. Naviguez vers l'onglet temp\u00e9rature d'Octoprint et s\u00e9lectionnez une temp\u00e9rature cible dans la bo\u00eete d\u00e9roulante de temp\u00e9rature (ou entrez manuellement une temp\u00e9rature appropri\u00e9e). Attendez que l'imprimante atteigne la temp\u00e9rature d\u00e9sir\u00e9e. Naviguez ensuite vers l'onglet de contr\u00f4le Octoprint et cliquez sur le bouton \"Extrude\". V\u00e9rifiez que le moteur de l'extrudeur tourne dans la bonne direction. Si ce n'est pas le cas, consultez les conseils de d\u00e9pannage de la section pr\u00e9c\u00e9dente pour confirmer les param\u00e8tres \"enable_pin\", \"step_pin\" et \"dir_pin\" de l'extrudeur.","title":"V\u00e9rifier le moteur de l'extrudeur"},{"location":"Config_checks.html#calibrer-les-parametres-pid","text":"Klipper prend en charge le r\u00e9gulateur PID pour l'extrudeuse et le chauffage du lit. Afin d'utiliser ce m\u00e9canisme de contr\u00f4le, il est n\u00e9cessaire de calibrer les param\u00e8tres PID sur chaque imprimante (les param\u00e8tres PID trouv\u00e9s dans d'autres micrologiciels ou dans les fichiers de configuration d'exemple fonctionnent souvent mal). Pour calibrer l'extrudeur, naviguez dans l'onglet du terminal OctoPrint et ex\u00e9cutez la commande PID_CALIBRATE. Par exemple : PID_CALIBRATE HEATER=extruder TARGET=170 A la fin du test de r\u00e9glage, ex\u00e9cutez SAVE_CONFIG pour mettre \u00e0 jour le fichier printer.cfg avec les nouveaux param\u00e8tres PID. Si l'imprimante est \u00e9quip\u00e9e d'un lit chauffant et qu'elle peut \u00eatre pilot\u00e9e par PWM (Pulse Width Modulation), il est recommand\u00e9 d'utiliser la commande PID pour le plateau (lorsque le chauffage du lit est contr\u00f4l\u00e9 \u00e0 l'aide de l'algorithme PID, il peut s'allumer et s'\u00e9teindre dix fois par seconde, ce qui peut ne pas convenir aux chauffages utilisant un interrupteur m\u00e9canique). Une commande typique de calibrage PID du plateau est : PID_CALIBRATE HEATER=heater_bed TARGET=60","title":"Calibrer les param\u00e8tres PID"},{"location":"Config_checks.html#prochaines-etapes","text":"Ce guide a pour but d'aider \u00e0 la v\u00e9rification de base des param\u00e8tres des broches dans le fichier de configuration de Klipper. Veillez \u00e0 lire le guide bed leveling . Consultez \u00e9galement le document Slicers pour obtenir des informations sur la configuration d'un trancheur avec Klipper. Apr\u00e8s avoir v\u00e9rifi\u00e9 que l'impression de base fonctionne, il est bon d'envisager de calibrer l'avance de pression . Il peut \u00eatre n\u00e9cessaire d'effectuer d'autres types de calibrage d\u00e9taill\u00e9 de l'imprimante - un certain nombre de guides sont disponibles en ligne pour vous aider (par exemple, faites une recherche sur le Web pour \"3d printer calibration\"). Par exemple, si vous rencontrez un effet appel\u00e9 \"ringing\", vous pouvez essayer de suivre le guide de r\u00e9glage de la compensation de r\u00e9sonance .","title":"Prochaines \u00e9tapes"},{"location":"Contact.html","text":"Contact \u00b6 Ce document fourni les informations de contact pour Klipper. Forum de la Communaut\u00e9 Salon Discord J'ai une question au sujet de Klipper J'ai une demande d'ajout de fonctionnalit\u00e9 A l'aide ! Ca ne fonctionne pas ! J'ai trouv\u00e9 un bug dans le logiciel Klipper J\u2019apporte des modifications que j\u2019aimerais inclure dans Klipper Github Klipper Forum de la communaut\u00e9 \u00b6 Il y a un Serveur Communautaire Discourse Klipper pour les discussions sur Klipper. Salon Discord \u00b6 Un serveur Discord d\u00e9di\u00e9 \u00e0 Klipper est l\u00e0 : https://discord.klipper3d.org . Ce serveur, g\u00e9r\u00e9 par une communaut\u00e9 de passionn\u00e9s de Klipper, est d\u00e9di\u00e9 aux discussions sur Klipper. Il permet aux utilisateurs de discuter en temps r\u00e9el. J'ai une question sur Klipper \u00b6 La plupart des questions que nous recevons ont d\u00e9j\u00e0 une r\u00e9ponse dans la documentation de Klipper . Assurez-vous de bien la lire et de suivre les instructions qui y sont fournies. Il est \u00e9galement possible de rechercher des questions similaires sur le Forum de la communaut\u00e9 Klipper . Si vous souhaitez partager vos connaissances et votre exp\u00e9rience avec d'autres utilisateurs de Klipper, vous pouvez rejoindre le Forum de la communaut\u00e9 Klipper ou encore le Salon Discord Klipper . Il s'agit de deux communaut\u00e9s o\u00f9 les utilisateurs de Klipper peuvent discuter du logiciel avec d'autres. De nombreuses questions que nous recevons sont relatives \u00e0 l'impression 3D en g\u00e9n\u00e9ral et ne sont pas sp\u00e9cifiques \u00e0 Klipper. Si vous avez une question ou si vous rencontrez des probl\u00e8mes d'impression en g\u00e9n\u00e9ral, vous obtiendrez probablement une meilleure r\u00e9ponse en la posant sur un forum consacr\u00e9 \u00e0 l'impression 3D dans la globalit\u00e9 ou bien sur un d\u00e9di\u00e9 au mat\u00e9riel de votre imprimante. J'ai une demande d'ajout de fonctionnalit\u00e9 \u00b6 Toute nouvelle fonctionnalit\u00e9 n\u00e9cessite d'avoir une personne int\u00e9ress\u00e9e et en capacit\u00e9 de la mettre en oeuvre. Si vous souhaitez aider \u00e0 impl\u00e9menter ou tester une fonctionnalit\u00e9, nous pouvez consulter les d\u00e9veloppements en cours sur le Forum de la Communaut\u00e9 Klipper . Le Salon Discord Klipper est \u00e9galement l\u00e0 pour les discussions entre contributeurs. A l'aide ! Ca ne fonctionne pas ! \u00b6 Malheureusement, nous recevons beaucoup plus de demandes d'aide que nous ne pouvons en traiter. La majorit\u00e9 des rapports d'anomalie que nous recevons sont g\u00e9n\u00e9ralement li\u00e9s \u00e0 : Des erreurs subtiles dans le mat\u00e9riel, ou Ne pas avoir suivi toutes les \u00e9tapes d\u00e9crites dans la documentation de Klipper. Si vous rencontrez des soucis, nous vous recommandons de lire attentivement la documentation de Klipper et de v\u00e9rifier que toutes les \u00e9tapes ont \u00e9t\u00e9 suivies. Si vous rencontrez des soucis d'impression, nous vous recommandons d'inspecter minutieusement votre imprimante pour voir s'il n'y a pas d'anomalies (joints, vis, fils, etc). Nous avons remarqu\u00e9 que la plupart des anomalies ne sont pas sp\u00e9cifiquement li\u00e9es \u00e0 Klipper. Si vous avez un probl\u00e8me avec votre imprimante, vous obtiendrez s\u00fbrement une meilleure r\u00e9ponse en recherchant sur un forum d\u00e9di\u00e9 \u00e0 l'impression 3D en g\u00e9n\u00e9ral ou bien sur un consacr\u00e9 au mat\u00e9riel de votre imprimante. Il est \u00e9galement possible de rechercher des questions similaires sur le Forum de la communaut\u00e9 Klipper . Si vous souhaitez partager vos connaissances et votre exp\u00e9rience avec d'autres utilisateurs de Klipper, vous pouvez rejoindre le Forum de la communaut\u00e9 Klipper ou encore le Salon Discord Klipper . Il s'agit de deux communaut\u00e9s o\u00f9 les utilisateurs de Klipper peuvent discuter du logiciel avec d'autres. J'ai trouv\u00e9 un bug dans le logiciel Klipper \u00b6 Klipper est un projet open-source et nous appr\u00e9cions quand des contributeurs diagnostiquent des erreurs dans le logiciel. Les probl\u00e8mes devraient \u00eatre signal\u00e9s dans le Forum communautaire Klipper . Il y a des informations importantes qui sont n\u00e9cessaires pour pouvoir corriger un bug. Veuillez suivre ces \u00e9tapes : Assurez-vous que vous ex\u00e9cutez le code non modifi\u00e9 de https://github.com/Klipper3d/klipper . Si le code a \u00e9t\u00e9 modifi\u00e9 ou provient d'une autre source, vous devez reproduire le probl\u00e8me sur le code non modifi\u00e9 de https://github.com/Klipper3d/klipper avant de le signaler. Si possible, ex\u00e9cutez une commande M112 imm\u00e9diatement apr\u00e8s que l'\u00e9v\u00e9nement ind\u00e9sirable se soit produit. Klipper se met alors dans un \"\u00e9tat d'arr\u00eat\" et des informations de d\u00e9bogage suppl\u00e9mentaires sont \u00e9crites dans le fichier journal. R\u00e9cup\u00e9rez l'\u00e9v\u00e9nement depuis le fichier journal Klipper. Ce journal a \u00e9t\u00e9 con\u00e7u pour r\u00e9pondre aux questions courantes que les d\u00e9veloppeurs de Klipper se posent sur le logiciel et son environnement (version du logiciel, type de mat\u00e9riel, configuration, \u00e0 quel moment l'anomalie eu lieu, et des centaines d'autres questions). Le fichier journal de Klipper est situ\u00e9 dans /tmp/klippy.log sur l'ordinateur \"h\u00f4te\" de Klipper (le Raspberry Pi). Un utilitaire comme \"scp\" ou \"sftp\" est n\u00e9cessaire pour copier ce fichier journal sur votre ordinateur. L'utilitaire \"scp\" est fourni en standard avec les syst\u00e8mes Linux et MacOS. Il existe des utilitaires scp disponibles gratuitement pour d'autres syst\u00e8mes (par exemple, WinSCP). Si vous utilisez un utilitaire scp graphique qui ne peut pas copier directement /tmp/klippy.log , cliquez plusieurs fois sur ... ou dossier parent jusqu'\u00e0 ce que vous arriviez au r\u00e9pertoire racine, cliquez ensuite sur le dossier tmp , puis s\u00e9lectionnez le fichier klippy.log . Copiez le fichier journal sur votre bureau afin de le joindre au rapport d'anomalie. Ne modifiez pas le fichier journal de quelque fa\u00e7on que ce soit ; ne fournissez pas un extrait non plus. Seul le fichier journal complet sans alt\u00e9ration fournira les informations n\u00e9cessaires. C'est une bonne id\u00e9e de compresser le fichier journal avec zip ou gzip. Ouvrez un nouveau sujet sur le Forum communautaire Klipper et fournissez une description claire du probl\u00e8me. Les autres contributeurs de Klipper devront comprendre quelles mesures ont \u00e9t\u00e9 prises, quel \u00e9tait le r\u00e9sultat souhait\u00e9 et quel r\u00e9sultat s'est effectivement produit. Le fichier journal Klipper compress\u00e9 doit \u00eatre joint \u00e0 ce sujet. J\u2019apporte des modifications que j\u2019aimerais inclure dans Klipper \u00b6 Klipper est un logiciel libre et nous appr\u00e9cions les nouvelles contributions. Les nouvelles contributions (que ce soit pour le code ou pour la documentation) sont soumises au moyen de Pull Requests Github. R\u00e9f\u00e9rez-vous au document CONTRIBUTIONS pour conna\u00eetre les informations importantes \u00e0 ce sujet. Il existe plusieurs documents pour les d\u00e9veloppeurs . Si vous avez des questions sur le code, vous pouvez \u00e9galement les poser sur le Forum de la communaut\u00e9 Klipper ou sur le Discord de la communaut\u00e9 Klipper . GitHub Klipper \u00b6 Le GitHub de Klipper peut \u00eatre utilis\u00e9 par les contributeurs pour partager l'\u00e9tat de leur travail pour am\u00e9liorer Klipper. On s'attend \u00e0 ce que la personne qui ouvre un ticket github travaille activement sur la t\u00e2che donn\u00e9e et soit celle qui effectue tout le travail n\u00e9cessaire pour l'accomplir. Le GitHub de Klipper n'est pas utilis\u00e9 pour les demandes, ni pour signaler des bogues, ni pour poser des questions. Utilisez plut\u00f4t le Forum communautaire Klipper ou le Discord communautaire Klipper .","title":"Contact"},{"location":"Contact.html#contact","text":"Ce document fourni les informations de contact pour Klipper. Forum de la Communaut\u00e9 Salon Discord J'ai une question au sujet de Klipper J'ai une demande d'ajout de fonctionnalit\u00e9 A l'aide ! Ca ne fonctionne pas ! J'ai trouv\u00e9 un bug dans le logiciel Klipper J\u2019apporte des modifications que j\u2019aimerais inclure dans Klipper Github Klipper","title":"Contact"},{"location":"Contact.html#forum-de-la-communaute","text":"Il y a un Serveur Communautaire Discourse Klipper pour les discussions sur Klipper.","title":"Forum de la communaut\u00e9"},{"location":"Contact.html#salon-discord","text":"Un serveur Discord d\u00e9di\u00e9 \u00e0 Klipper est l\u00e0 : https://discord.klipper3d.org . Ce serveur, g\u00e9r\u00e9 par une communaut\u00e9 de passionn\u00e9s de Klipper, est d\u00e9di\u00e9 aux discussions sur Klipper. Il permet aux utilisateurs de discuter en temps r\u00e9el.","title":"Salon Discord"},{"location":"Contact.html#jai-une-question-sur-klipper","text":"La plupart des questions que nous recevons ont d\u00e9j\u00e0 une r\u00e9ponse dans la documentation de Klipper . Assurez-vous de bien la lire et de suivre les instructions qui y sont fournies. Il est \u00e9galement possible de rechercher des questions similaires sur le Forum de la communaut\u00e9 Klipper . Si vous souhaitez partager vos connaissances et votre exp\u00e9rience avec d'autres utilisateurs de Klipper, vous pouvez rejoindre le Forum de la communaut\u00e9 Klipper ou encore le Salon Discord Klipper . Il s'agit de deux communaut\u00e9s o\u00f9 les utilisateurs de Klipper peuvent discuter du logiciel avec d'autres. De nombreuses questions que nous recevons sont relatives \u00e0 l'impression 3D en g\u00e9n\u00e9ral et ne sont pas sp\u00e9cifiques \u00e0 Klipper. Si vous avez une question ou si vous rencontrez des probl\u00e8mes d'impression en g\u00e9n\u00e9ral, vous obtiendrez probablement une meilleure r\u00e9ponse en la posant sur un forum consacr\u00e9 \u00e0 l'impression 3D dans la globalit\u00e9 ou bien sur un d\u00e9di\u00e9 au mat\u00e9riel de votre imprimante.","title":"J'ai une question sur Klipper"},{"location":"Contact.html#jai-une-demande-dajout-de-fonctionnalite","text":"Toute nouvelle fonctionnalit\u00e9 n\u00e9cessite d'avoir une personne int\u00e9ress\u00e9e et en capacit\u00e9 de la mettre en oeuvre. Si vous souhaitez aider \u00e0 impl\u00e9menter ou tester une fonctionnalit\u00e9, nous pouvez consulter les d\u00e9veloppements en cours sur le Forum de la Communaut\u00e9 Klipper . Le Salon Discord Klipper est \u00e9galement l\u00e0 pour les discussions entre contributeurs.","title":"J'ai une demande d'ajout de fonctionnalit\u00e9"},{"location":"Contact.html#a-laide-ca-ne-fonctionne-pas","text":"Malheureusement, nous recevons beaucoup plus de demandes d'aide que nous ne pouvons en traiter. La majorit\u00e9 des rapports d'anomalie que nous recevons sont g\u00e9n\u00e9ralement li\u00e9s \u00e0 : Des erreurs subtiles dans le mat\u00e9riel, ou Ne pas avoir suivi toutes les \u00e9tapes d\u00e9crites dans la documentation de Klipper. Si vous rencontrez des soucis, nous vous recommandons de lire attentivement la documentation de Klipper et de v\u00e9rifier que toutes les \u00e9tapes ont \u00e9t\u00e9 suivies. Si vous rencontrez des soucis d'impression, nous vous recommandons d'inspecter minutieusement votre imprimante pour voir s'il n'y a pas d'anomalies (joints, vis, fils, etc). Nous avons remarqu\u00e9 que la plupart des anomalies ne sont pas sp\u00e9cifiquement li\u00e9es \u00e0 Klipper. Si vous avez un probl\u00e8me avec votre imprimante, vous obtiendrez s\u00fbrement une meilleure r\u00e9ponse en recherchant sur un forum d\u00e9di\u00e9 \u00e0 l'impression 3D en g\u00e9n\u00e9ral ou bien sur un consacr\u00e9 au mat\u00e9riel de votre imprimante. Il est \u00e9galement possible de rechercher des questions similaires sur le Forum de la communaut\u00e9 Klipper . Si vous souhaitez partager vos connaissances et votre exp\u00e9rience avec d'autres utilisateurs de Klipper, vous pouvez rejoindre le Forum de la communaut\u00e9 Klipper ou encore le Salon Discord Klipper . Il s'agit de deux communaut\u00e9s o\u00f9 les utilisateurs de Klipper peuvent discuter du logiciel avec d'autres.","title":"A l'aide ! Ca ne fonctionne pas !"},{"location":"Contact.html#jai-trouve-un-bug-dans-le-logiciel-klipper","text":"Klipper est un projet open-source et nous appr\u00e9cions quand des contributeurs diagnostiquent des erreurs dans le logiciel. Les probl\u00e8mes devraient \u00eatre signal\u00e9s dans le Forum communautaire Klipper . Il y a des informations importantes qui sont n\u00e9cessaires pour pouvoir corriger un bug. Veuillez suivre ces \u00e9tapes : Assurez-vous que vous ex\u00e9cutez le code non modifi\u00e9 de https://github.com/Klipper3d/klipper . Si le code a \u00e9t\u00e9 modifi\u00e9 ou provient d'une autre source, vous devez reproduire le probl\u00e8me sur le code non modifi\u00e9 de https://github.com/Klipper3d/klipper avant de le signaler. Si possible, ex\u00e9cutez une commande M112 imm\u00e9diatement apr\u00e8s que l'\u00e9v\u00e9nement ind\u00e9sirable se soit produit. Klipper se met alors dans un \"\u00e9tat d'arr\u00eat\" et des informations de d\u00e9bogage suppl\u00e9mentaires sont \u00e9crites dans le fichier journal. R\u00e9cup\u00e9rez l'\u00e9v\u00e9nement depuis le fichier journal Klipper. Ce journal a \u00e9t\u00e9 con\u00e7u pour r\u00e9pondre aux questions courantes que les d\u00e9veloppeurs de Klipper se posent sur le logiciel et son environnement (version du logiciel, type de mat\u00e9riel, configuration, \u00e0 quel moment l'anomalie eu lieu, et des centaines d'autres questions). Le fichier journal de Klipper est situ\u00e9 dans /tmp/klippy.log sur l'ordinateur \"h\u00f4te\" de Klipper (le Raspberry Pi). Un utilitaire comme \"scp\" ou \"sftp\" est n\u00e9cessaire pour copier ce fichier journal sur votre ordinateur. L'utilitaire \"scp\" est fourni en standard avec les syst\u00e8mes Linux et MacOS. Il existe des utilitaires scp disponibles gratuitement pour d'autres syst\u00e8mes (par exemple, WinSCP). Si vous utilisez un utilitaire scp graphique qui ne peut pas copier directement /tmp/klippy.log , cliquez plusieurs fois sur ... ou dossier parent jusqu'\u00e0 ce que vous arriviez au r\u00e9pertoire racine, cliquez ensuite sur le dossier tmp , puis s\u00e9lectionnez le fichier klippy.log . Copiez le fichier journal sur votre bureau afin de le joindre au rapport d'anomalie. Ne modifiez pas le fichier journal de quelque fa\u00e7on que ce soit ; ne fournissez pas un extrait non plus. Seul le fichier journal complet sans alt\u00e9ration fournira les informations n\u00e9cessaires. C'est une bonne id\u00e9e de compresser le fichier journal avec zip ou gzip. Ouvrez un nouveau sujet sur le Forum communautaire Klipper et fournissez une description claire du probl\u00e8me. Les autres contributeurs de Klipper devront comprendre quelles mesures ont \u00e9t\u00e9 prises, quel \u00e9tait le r\u00e9sultat souhait\u00e9 et quel r\u00e9sultat s'est effectivement produit. Le fichier journal Klipper compress\u00e9 doit \u00eatre joint \u00e0 ce sujet.","title":"J'ai trouv\u00e9 un bug dans le logiciel Klipper"},{"location":"Contact.html#japporte-des-modifications-que-jaimerais-inclure-dans-klipper","text":"Klipper est un logiciel libre et nous appr\u00e9cions les nouvelles contributions. Les nouvelles contributions (que ce soit pour le code ou pour la documentation) sont soumises au moyen de Pull Requests Github. R\u00e9f\u00e9rez-vous au document CONTRIBUTIONS pour conna\u00eetre les informations importantes \u00e0 ce sujet. Il existe plusieurs documents pour les d\u00e9veloppeurs . Si vous avez des questions sur le code, vous pouvez \u00e9galement les poser sur le Forum de la communaut\u00e9 Klipper ou sur le Discord de la communaut\u00e9 Klipper .","title":"J\u2019apporte des modifications que j\u2019aimerais inclure dans Klipper"},{"location":"Contact.html#github-klipper","text":"Le GitHub de Klipper peut \u00eatre utilis\u00e9 par les contributeurs pour partager l'\u00e9tat de leur travail pour am\u00e9liorer Klipper. On s'attend \u00e0 ce que la personne qui ouvre un ticket github travaille activement sur la t\u00e2che donn\u00e9e et soit celle qui effectue tout le travail n\u00e9cessaire pour l'accomplir. Le GitHub de Klipper n'est pas utilis\u00e9 pour les demandes, ni pour signaler des bogues, ni pour poser des questions. Utilisez plut\u00f4t le Forum communautaire Klipper ou le Discord communautaire Klipper .","title":"GitHub Klipper"},{"location":"Debugging.html","text":"D\u00e9bogage \u00b6 Ce document d\u00e9crit certains des outils de d\u00e9bogage de Klipper. Ex\u00e9cution des tests de non-r\u00e9gression \u00b6 Le r\u00e9f\u00e9rentiel principal Klipper GitHub utilise des \"github actions\" pour ex\u00e9cuter une s\u00e9rie de tests de non-r\u00e9gression. Il peut \u00eatre utile d'ex\u00e9cuter certains de ces tests localement. La \"v\u00e9rification des espaces\" dans le code source peut \u00eatre ex\u00e9cut\u00e9e avec : ./scripts/check_whitespace.sh La suite de tests de non-r\u00e9gression Klippy n\u00e9cessite les \"dictionnaires de donn\u00e9es\" de nombreuses plates-formes. Le moyen le plus simple de les obtenir est de les t\u00e9l\u00e9charger depuis github . Une fois les dictionnaires de donn\u00e9es t\u00e9l\u00e9charg\u00e9s, utilisez les \u00e9l\u00e9ments suivants pour ex\u00e9cuter la suite de tests de non-r\u00e9gression : tar xfz klipper-dict-20??????.tar.gz ~/klippy-env/bin/python ~/klipper/scripts/test_klippy.py -d dict/ ~/klipper/test/klippy/*.test Envoi manuel de commandes au microcontr\u00f4leur \u00b6 Normalement, le processus h\u00f4te klippy.py est utilis\u00e9 pour traduire les commandes gcode en commandes de microcontr\u00f4leur Klipper. Cependant, il est \u00e9galement possible d'envoyer manuellement ces commandes MCU (fonctions marqu\u00e9es avec la macro DECL_COMMAND() dans le code source de Klipper). Pour ce faire, ex\u00e9cutez : ~/klippy-env/bin/python ./klippy/console.py /tmp/pseudoserial Voir la commande \"AIDE\" dans l'outil pour plus d'informations sur sa fonctionnalit\u00e9. Certaines options en ligne de commande sont disponibles. Pour plus d'informations, ex\u00e9cutez : ~/klippy-env/bin/python ./klippy/console.py --help Traduction des fichiers G-Code en commandes de microcontr\u00f4leur \u00b6 Le code h\u00f4te Klippy peut s'ex\u00e9cuter en mode batch pour produire les commandes de microcontr\u00f4leur de bas niveau associ\u00e9es \u00e0 un fichier gcode. L'inspection de ces commandes de bas niveau est utile lorsque vous essayez de comprendre les actions du mat\u00e9riel de bas niveau. Il peut \u00e9galement \u00eatre utile de comparer la diff\u00e9rence des commandes du microcontr\u00f4leur apr\u00e8s un changement de code. Pour ex\u00e9cuter Klippy dans ce mode batch, il y a une seule \u00e9tape n\u00e9cessaire pour g\u00e9n\u00e9rer le \"dictionnaire de donn\u00e9es\" du microcontr\u00f4leur. Cela se fait en compilant le code du micro-contr\u00f4leur pour obtenir le fichier out/klipper.dict : make menuconfig make Une fois que ce qui pr\u00e9c\u00e8de est fait, il est possible d'ex\u00e9cuter Klipper en mode batch (voir installation pour les \u00e9tapes n\u00e9cessaires pour construire l'environnement virtuel python et un fichier printer.cfg) : ~/klippy-env/bin/python ./klippy/klippy.py ~/printer.cfg -i test.gcode -o test.serial -v -d out/klipper.dict Ce qui pr\u00e9c\u00e8de produira un fichier test.serial avec la sortie s\u00e9rie binaire. Cette sortie peut \u00eatre traduite en texte lisible avec : ~/klippy-env/bin/python ./klippy/parsedump.py out/klipper.dict test.serial > test.txt Le fichier r\u00e9sultant test.txt contient une liste lisible des commandes du microcontr\u00f4leur. Le mode batch d\u00e9sactive certaines commandes de r\u00e9ponse/requ\u00eate pour fonctionner. Par cons\u00e9quent, il y aura des diff\u00e9rences entre les commandes r\u00e9elles et la sortie ci-dessus. Les donn\u00e9es g\u00e9n\u00e9r\u00e9es sont utiles pour les tests et l'inspection ; elles ne sont pas utiles en fonctionnement normale (vers un vrai microcontr\u00f4leur). Analyse de mouvements et enregistrement de donn\u00e9es \u00b6 Klipper prend en charge la journalisation de l'historique des mouvement, qui peut \u00eatre analys\u00e9 ult\u00e9rieurement. Pour utiliser cette fonctionnalit\u00e9, Klipper doit \u00eatre d\u00e9marr\u00e9 avec le Serveur API activ\u00e9. L'enregistrement des donn\u00e9es est activ\u00e9 avec l'outil data_logger.py . Par example\u202f: ~/klipper/scripts/motan/data_logger.py /tmp/klippy_uds mylog Cette commande se connectera au serveur API de Klipper, s'abonnera aux informations d'\u00e9tat et de mouvement et consignera les r\u00e9sultats. Deux fichiers sont g\u00e9n\u00e9r\u00e9s : un fichier de donn\u00e9es compress\u00e9es et un fichier d'index (par exemple, mylog.json.gz et mylog.index.gz ). Apr\u00e8s avoir d\u00e9marr\u00e9 la journalisation, il est possible d'effectuer des impressions et d'autres actions - la journalisation se poursuivra en arri\u00e8re-plan. Une fois la journalisation termin\u00e9e, appuyez sur ctrl-c pour quitter l'outil data_logger.py . Les fichiers r\u00e9sultants peuvent \u00eatre lus et repr\u00e9sent\u00e9s graphiquement \u00e0 l'aide de l'outil motan_graph.py . Pour g\u00e9n\u00e9rer des graphiques sur un Raspberry Pi, une seule \u00e9tape est n\u00e9cessaire pour installer le package \"matplotlib\"\u202f: sudo apt-get update sudo apt-get install python-matplotlib Cependant, il peut \u00eatre plus pratique de copier les fichiers de donn\u00e9es sur une machine de bureau avec le code Python dans le r\u00e9pertoire scripts/motan/ . Les scripts d'analyse de mouvement doivent s'ex\u00e9cuter sur n'importe quelle machine sur laquelle une version r\u00e9cente de Python et Matplotlib est install\u00e9e. Les graphiques peuvent \u00eatre g\u00e9n\u00e9r\u00e9s avec une commande comme celle-ci : ~/klipper/scripts/motan/motan_graph.py mylog -o mygraph.png On peut utiliser l'option -g pour sp\u00e9cifier les jeux de donn\u00e9es \u00e0 repr\u00e9senter graphiquement (il faut un litt\u00e9ral Python contenant une liste de listes). Par exemple\u202f: ~/klipper/scripts/motan/motan_graph.py mylog -g '[[\"trapq(toolhead,velocity)\"], [\"trapq(toolhead,accel)\"]]' La liste des ensembles de donn\u00e9es disponibles peut \u00eatre trouv\u00e9e en utilisant l'option -l - par exemple : ~/klipper/scripts/motan/motan_graph.py -l Il est \u00e9galement possible de sp\u00e9cifier les options de trac\u00e9 matplotlib pour chaque jeu de donn\u00e9es : ~/klipper/scripts/motan/motan_graph.py mylog -g '[[\"trapq(toolhead,velocity)?color=red&alpha=0.4\"]]' De nombreuses options matplotlib sont disponibles ; quelques exemples sont \"color\", \"label\", \"alpha\" et \"linestyle\". L'outil motan_graph.py prend en charge plusieurs autres options de ligne de commande - utilisez l'option --help pour afficher une liste. Il peut \u00e9galement \u00eatre pratique de visualiser/modifier le script motan_graph.py lui-m\u00eame. Les journaux de donn\u00e9es brutes produits par l'outil data_logger.py suivent le format d\u00e9crit dans Serveur API . Il peut \u00eatre utile d'inspecter les donn\u00e9es avec une commande Unix comme celle-ci : gunzip < mylog.json.gz | tr '\\03' '\\n' | moins G\u00e9n\u00e9ration de graphiques de charge \u00b6 Le fichier journal Klippy (/tmp/klippy.log) stocke des statistiques sur la bande passante utilis\u00e9e, la charge du microcontr\u00f4leur et la charge du tampon h\u00f4te. Il peut \u00eatre utile de repr\u00e9senter graphiquement ces statistiques apr\u00e8s une impression. Pour g\u00e9n\u00e9rer un graphique, une seule \u00e9tape est n\u00e9cessaire pour installer le package \"matplotlib\"\u202f: sudo apt-get update sudo apt-get install python-matplotlib Ensuite, les graphiques peuvent \u00eatre produits avec\u202f: ~/klipper/scripts/graphstats.py /tmp/klippy.log -o loadgraph.png On peut alors visualiser le fichier loadgraph.png r\u00e9sultant. Diff\u00e9rents graphiques peuvent \u00eatre produits. Pour plus d'informations, ex\u00e9cutez : ~/klipper/scripts/graphstats.py --help Extraire des informations du fichier klippy.log \u00b6 Le fichier journal Klippy (/tmp/klippy.log) contient \u00e9galement des informations de d\u00e9bogage. Il existe un script logextract.py qui peut \u00eatre utile lors de l'analyse d'un arr\u00eat de microcontr\u00f4leur ou d'un probl\u00e8me similaire. Il est g\u00e9n\u00e9ralement ex\u00e9cut\u00e9 avec quelque chose comme : mkdir work_directory cd work_directory cp /tmp/klippy.log . ~/klipper/scripts/logextract.py ./klippy.log Le script extrait le fichier de configuration de l'imprimante et extrait les informations d'arr\u00eat du MCU. Les vidages d'informations d'un arr\u00eat de MCU (le cas \u00e9ch\u00e9ant) sont r\u00e9organis\u00e9s par horodatage pour faciliter le diagnostic des sc\u00e9narios de cause \u00e0 effet. Tester avec simulavr \u00b6 L'outil simulavr permet de simuler un microcontr\u00f4leur Atmel ATmega. Cette section d\u00e9crit comment ex\u00e9cuter des fichiers gcode de test via simulavr. Il est recommand\u00e9 de l'ex\u00e9cuter sur une machine de bureau (pas un Raspberry Pi) car il n\u00e9cessite un processeur important pour fonctionner efficacement. Pour utiliser simulavr, t\u00e9l\u00e9chargez le package simulavr et compilez avec le support python. Notez que le syst\u00e8me de construction peut n\u00e9cessiter l'installation de certains packages (tels que swig) afin de construire le module python. git clone git://git.savannah.nongnu.org/simulavr.git cd simulavr make python make build Assurez-vous qu'un fichier ./build/pysimulavr/_pysimulavr.*.so est pr\u00e9sent apr\u00e8s la compilation ci-dessus : ls ./build/pysimulavr/_pysimulavr.*.so Cette commande doit signaler un fichier sp\u00e9cifique (par exemple ./build/pysimulavr/_pysimulavr.cpython-39-x86_64-linux-gnu.so ) et non une erreur. Si vous \u00eates sur un syst\u00e8me bas\u00e9 sur Debian (Debian, Ubuntu, etc.), vous pouvez installer les packages suivants et g\u00e9n\u00e9rer des fichiers *.deb pour une installation de simulavr \u00e0 l'\u00e9chelle du syst\u00e8me : sudo apt update sudo apt install g++ make cmake swig rst2pdf help2man texinfo make cfgclean python debian sudo dpkg -i build/debian/python3-simulavr*.deb Pour compiler Klipper pour une utilisation dans simulavr, ex\u00e9cutez : cd /path/to/klipper make menuconfig et compilez le logiciel du microcontr\u00f4leur pour un AVR atmega644p et s\u00e9lectionnez le support d'\u00e9mulation du logiciel SIMULAVR. Ensuite on peut compiler Klipper (lancer make ) puis lancer la simulation avec : PYTHONPATH=/path/to/simulavr/build/pysimulavr/ ./scripts/avrsim.py out/klipper.elf Si vous avez install\u00e9 python3-simulavr au niveau syst\u00e8me, vous n'avez pas besoin de d\u00e9finir PYTHONPATH , et vous pouvez simplement ex\u00e9cuter le simulateur comme ./scripts/avrsim.py out/klipper.elf Ensuite, avec simulavr en cours d\u2019ex\u00e9cution dans une autre fen\u00eatre, on peut ex\u00e9cuter ce qui suit pour lire le gcode d\u2019un fichier (par exemple, \u00ab test.gcode \u00bb), le traiter avec Klippy, et l\u2019envoyer \u00e0 Klipper ex\u00e9cut\u00e9 dans simulavr (voir installation pour les \u00e9tapes n\u00e9cessaires \u00e0 la construction de l\u2019environnement virtuel python)\u202f: ~/klippy-env/bin/python ./klippy/klippy.py config/generic-simulavr.cfg -i test.gcode -v Utiliser simulavr avec gtkwave \u00b6 Une fonctionnalit\u00e9 utile de simulavr est sa capacit\u00e9 \u00e0 cr\u00e9er des fichiers de g\u00e9n\u00e9ration d'ondes avec la synchronisation exacte des \u00e9v\u00e9nements. Pour ce faire, suivez les instructions ci-dessus, mais ex\u00e9cutez avrsim.py avec une ligne de commande comme celle-ci : PYTHONPATH=/path/to/simulavr/src/python/ ./scripts/avrsim.py out/klipper.elf -t PORTA.PORT,PORTC.PORT Ce qui pr\u00e9c\u00e8de cr\u00e9era un fichier avrsim.vcd avec des informations sur chaque modification des GPIO sur PORTA et PORTB. Ce fichier pourra ensuite \u00eatre visualis\u00e9 en utilisant gtkwave avec : gtkwave avrsim.vcd","title":"D\u00e9bogage"},{"location":"Debugging.html#debogage","text":"Ce document d\u00e9crit certains des outils de d\u00e9bogage de Klipper.","title":"D\u00e9bogage"},{"location":"Debugging.html#execution-des-tests-de-non-regression","text":"Le r\u00e9f\u00e9rentiel principal Klipper GitHub utilise des \"github actions\" pour ex\u00e9cuter une s\u00e9rie de tests de non-r\u00e9gression. Il peut \u00eatre utile d'ex\u00e9cuter certains de ces tests localement. La \"v\u00e9rification des espaces\" dans le code source peut \u00eatre ex\u00e9cut\u00e9e avec : ./scripts/check_whitespace.sh La suite de tests de non-r\u00e9gression Klippy n\u00e9cessite les \"dictionnaires de donn\u00e9es\" de nombreuses plates-formes. Le moyen le plus simple de les obtenir est de les t\u00e9l\u00e9charger depuis github . Une fois les dictionnaires de donn\u00e9es t\u00e9l\u00e9charg\u00e9s, utilisez les \u00e9l\u00e9ments suivants pour ex\u00e9cuter la suite de tests de non-r\u00e9gression : tar xfz klipper-dict-20??????.tar.gz ~/klippy-env/bin/python ~/klipper/scripts/test_klippy.py -d dict/ ~/klipper/test/klippy/*.test","title":"Ex\u00e9cution des tests de non-r\u00e9gression"},{"location":"Debugging.html#envoi-manuel-de-commandes-au-microcontroleur","text":"Normalement, le processus h\u00f4te klippy.py est utilis\u00e9 pour traduire les commandes gcode en commandes de microcontr\u00f4leur Klipper. Cependant, il est \u00e9galement possible d'envoyer manuellement ces commandes MCU (fonctions marqu\u00e9es avec la macro DECL_COMMAND() dans le code source de Klipper). Pour ce faire, ex\u00e9cutez : ~/klippy-env/bin/python ./klippy/console.py /tmp/pseudoserial Voir la commande \"AIDE\" dans l'outil pour plus d'informations sur sa fonctionnalit\u00e9. Certaines options en ligne de commande sont disponibles. Pour plus d'informations, ex\u00e9cutez : ~/klippy-env/bin/python ./klippy/console.py --help","title":"Envoi manuel de commandes au microcontr\u00f4leur"},{"location":"Debugging.html#traduction-des-fichiers-g-code-en-commandes-de-microcontroleur","text":"Le code h\u00f4te Klippy peut s'ex\u00e9cuter en mode batch pour produire les commandes de microcontr\u00f4leur de bas niveau associ\u00e9es \u00e0 un fichier gcode. L'inspection de ces commandes de bas niveau est utile lorsque vous essayez de comprendre les actions du mat\u00e9riel de bas niveau. Il peut \u00e9galement \u00eatre utile de comparer la diff\u00e9rence des commandes du microcontr\u00f4leur apr\u00e8s un changement de code. Pour ex\u00e9cuter Klippy dans ce mode batch, il y a une seule \u00e9tape n\u00e9cessaire pour g\u00e9n\u00e9rer le \"dictionnaire de donn\u00e9es\" du microcontr\u00f4leur. Cela se fait en compilant le code du micro-contr\u00f4leur pour obtenir le fichier out/klipper.dict : make menuconfig make Une fois que ce qui pr\u00e9c\u00e8de est fait, il est possible d'ex\u00e9cuter Klipper en mode batch (voir installation pour les \u00e9tapes n\u00e9cessaires pour construire l'environnement virtuel python et un fichier printer.cfg) : ~/klippy-env/bin/python ./klippy/klippy.py ~/printer.cfg -i test.gcode -o test.serial -v -d out/klipper.dict Ce qui pr\u00e9c\u00e8de produira un fichier test.serial avec la sortie s\u00e9rie binaire. Cette sortie peut \u00eatre traduite en texte lisible avec : ~/klippy-env/bin/python ./klippy/parsedump.py out/klipper.dict test.serial > test.txt Le fichier r\u00e9sultant test.txt contient une liste lisible des commandes du microcontr\u00f4leur. Le mode batch d\u00e9sactive certaines commandes de r\u00e9ponse/requ\u00eate pour fonctionner. Par cons\u00e9quent, il y aura des diff\u00e9rences entre les commandes r\u00e9elles et la sortie ci-dessus. Les donn\u00e9es g\u00e9n\u00e9r\u00e9es sont utiles pour les tests et l'inspection ; elles ne sont pas utiles en fonctionnement normale (vers un vrai microcontr\u00f4leur).","title":"Traduction des fichiers G-Code en commandes de microcontr\u00f4leur"},{"location":"Debugging.html#analyse-de-mouvements-et-enregistrement-de-donnees","text":"Klipper prend en charge la journalisation de l'historique des mouvement, qui peut \u00eatre analys\u00e9 ult\u00e9rieurement. Pour utiliser cette fonctionnalit\u00e9, Klipper doit \u00eatre d\u00e9marr\u00e9 avec le Serveur API activ\u00e9. L'enregistrement des donn\u00e9es est activ\u00e9 avec l'outil data_logger.py . Par example\u202f: ~/klipper/scripts/motan/data_logger.py /tmp/klippy_uds mylog Cette commande se connectera au serveur API de Klipper, s'abonnera aux informations d'\u00e9tat et de mouvement et consignera les r\u00e9sultats. Deux fichiers sont g\u00e9n\u00e9r\u00e9s : un fichier de donn\u00e9es compress\u00e9es et un fichier d'index (par exemple, mylog.json.gz et mylog.index.gz ). Apr\u00e8s avoir d\u00e9marr\u00e9 la journalisation, il est possible d'effectuer des impressions et d'autres actions - la journalisation se poursuivra en arri\u00e8re-plan. Une fois la journalisation termin\u00e9e, appuyez sur ctrl-c pour quitter l'outil data_logger.py . Les fichiers r\u00e9sultants peuvent \u00eatre lus et repr\u00e9sent\u00e9s graphiquement \u00e0 l'aide de l'outil motan_graph.py . Pour g\u00e9n\u00e9rer des graphiques sur un Raspberry Pi, une seule \u00e9tape est n\u00e9cessaire pour installer le package \"matplotlib\"\u202f: sudo apt-get update sudo apt-get install python-matplotlib Cependant, il peut \u00eatre plus pratique de copier les fichiers de donn\u00e9es sur une machine de bureau avec le code Python dans le r\u00e9pertoire scripts/motan/ . Les scripts d'analyse de mouvement doivent s'ex\u00e9cuter sur n'importe quelle machine sur laquelle une version r\u00e9cente de Python et Matplotlib est install\u00e9e. Les graphiques peuvent \u00eatre g\u00e9n\u00e9r\u00e9s avec une commande comme celle-ci : ~/klipper/scripts/motan/motan_graph.py mylog -o mygraph.png On peut utiliser l'option -g pour sp\u00e9cifier les jeux de donn\u00e9es \u00e0 repr\u00e9senter graphiquement (il faut un litt\u00e9ral Python contenant une liste de listes). Par exemple\u202f: ~/klipper/scripts/motan/motan_graph.py mylog -g '[[\"trapq(toolhead,velocity)\"], [\"trapq(toolhead,accel)\"]]' La liste des ensembles de donn\u00e9es disponibles peut \u00eatre trouv\u00e9e en utilisant l'option -l - par exemple : ~/klipper/scripts/motan/motan_graph.py -l Il est \u00e9galement possible de sp\u00e9cifier les options de trac\u00e9 matplotlib pour chaque jeu de donn\u00e9es : ~/klipper/scripts/motan/motan_graph.py mylog -g '[[\"trapq(toolhead,velocity)?color=red&alpha=0.4\"]]' De nombreuses options matplotlib sont disponibles ; quelques exemples sont \"color\", \"label\", \"alpha\" et \"linestyle\". L'outil motan_graph.py prend en charge plusieurs autres options de ligne de commande - utilisez l'option --help pour afficher une liste. Il peut \u00e9galement \u00eatre pratique de visualiser/modifier le script motan_graph.py lui-m\u00eame. Les journaux de donn\u00e9es brutes produits par l'outil data_logger.py suivent le format d\u00e9crit dans Serveur API . Il peut \u00eatre utile d'inspecter les donn\u00e9es avec une commande Unix comme celle-ci : gunzip < mylog.json.gz | tr '\\03' '\\n' | moins","title":"Analyse de mouvements et enregistrement de donn\u00e9es"},{"location":"Debugging.html#generation-de-graphiques-de-charge","text":"Le fichier journal Klippy (/tmp/klippy.log) stocke des statistiques sur la bande passante utilis\u00e9e, la charge du microcontr\u00f4leur et la charge du tampon h\u00f4te. Il peut \u00eatre utile de repr\u00e9senter graphiquement ces statistiques apr\u00e8s une impression. Pour g\u00e9n\u00e9rer un graphique, une seule \u00e9tape est n\u00e9cessaire pour installer le package \"matplotlib\"\u202f: sudo apt-get update sudo apt-get install python-matplotlib Ensuite, les graphiques peuvent \u00eatre produits avec\u202f: ~/klipper/scripts/graphstats.py /tmp/klippy.log -o loadgraph.png On peut alors visualiser le fichier loadgraph.png r\u00e9sultant. Diff\u00e9rents graphiques peuvent \u00eatre produits. Pour plus d'informations, ex\u00e9cutez : ~/klipper/scripts/graphstats.py --help","title":"G\u00e9n\u00e9ration de graphiques de charge"},{"location":"Debugging.html#extraire-des-informations-du-fichier-klippylog","text":"Le fichier journal Klippy (/tmp/klippy.log) contient \u00e9galement des informations de d\u00e9bogage. Il existe un script logextract.py qui peut \u00eatre utile lors de l'analyse d'un arr\u00eat de microcontr\u00f4leur ou d'un probl\u00e8me similaire. Il est g\u00e9n\u00e9ralement ex\u00e9cut\u00e9 avec quelque chose comme : mkdir work_directory cd work_directory cp /tmp/klippy.log . ~/klipper/scripts/logextract.py ./klippy.log Le script extrait le fichier de configuration de l'imprimante et extrait les informations d'arr\u00eat du MCU. Les vidages d'informations d'un arr\u00eat de MCU (le cas \u00e9ch\u00e9ant) sont r\u00e9organis\u00e9s par horodatage pour faciliter le diagnostic des sc\u00e9narios de cause \u00e0 effet.","title":"Extraire des informations du fichier klippy.log"},{"location":"Debugging.html#tester-avec-simulavr","text":"L'outil simulavr permet de simuler un microcontr\u00f4leur Atmel ATmega. Cette section d\u00e9crit comment ex\u00e9cuter des fichiers gcode de test via simulavr. Il est recommand\u00e9 de l'ex\u00e9cuter sur une machine de bureau (pas un Raspberry Pi) car il n\u00e9cessite un processeur important pour fonctionner efficacement. Pour utiliser simulavr, t\u00e9l\u00e9chargez le package simulavr et compilez avec le support python. Notez que le syst\u00e8me de construction peut n\u00e9cessiter l'installation de certains packages (tels que swig) afin de construire le module python. git clone git://git.savannah.nongnu.org/simulavr.git cd simulavr make python make build Assurez-vous qu'un fichier ./build/pysimulavr/_pysimulavr.*.so est pr\u00e9sent apr\u00e8s la compilation ci-dessus : ls ./build/pysimulavr/_pysimulavr.*.so Cette commande doit signaler un fichier sp\u00e9cifique (par exemple ./build/pysimulavr/_pysimulavr.cpython-39-x86_64-linux-gnu.so ) et non une erreur. Si vous \u00eates sur un syst\u00e8me bas\u00e9 sur Debian (Debian, Ubuntu, etc.), vous pouvez installer les packages suivants et g\u00e9n\u00e9rer des fichiers *.deb pour une installation de simulavr \u00e0 l'\u00e9chelle du syst\u00e8me : sudo apt update sudo apt install g++ make cmake swig rst2pdf help2man texinfo make cfgclean python debian sudo dpkg -i build/debian/python3-simulavr*.deb Pour compiler Klipper pour une utilisation dans simulavr, ex\u00e9cutez : cd /path/to/klipper make menuconfig et compilez le logiciel du microcontr\u00f4leur pour un AVR atmega644p et s\u00e9lectionnez le support d'\u00e9mulation du logiciel SIMULAVR. Ensuite on peut compiler Klipper (lancer make ) puis lancer la simulation avec : PYTHONPATH=/path/to/simulavr/build/pysimulavr/ ./scripts/avrsim.py out/klipper.elf Si vous avez install\u00e9 python3-simulavr au niveau syst\u00e8me, vous n'avez pas besoin de d\u00e9finir PYTHONPATH , et vous pouvez simplement ex\u00e9cuter le simulateur comme ./scripts/avrsim.py out/klipper.elf Ensuite, avec simulavr en cours d\u2019ex\u00e9cution dans une autre fen\u00eatre, on peut ex\u00e9cuter ce qui suit pour lire le gcode d\u2019un fichier (par exemple, \u00ab test.gcode \u00bb), le traiter avec Klippy, et l\u2019envoyer \u00e0 Klipper ex\u00e9cut\u00e9 dans simulavr (voir installation pour les \u00e9tapes n\u00e9cessaires \u00e0 la construction de l\u2019environnement virtuel python)\u202f: ~/klippy-env/bin/python ./klippy/klippy.py config/generic-simulavr.cfg -i test.gcode -v","title":"Tester avec simulavr"},{"location":"Debugging.html#utiliser-simulavr-avec-gtkwave","text":"Une fonctionnalit\u00e9 utile de simulavr est sa capacit\u00e9 \u00e0 cr\u00e9er des fichiers de g\u00e9n\u00e9ration d'ondes avec la synchronisation exacte des \u00e9v\u00e9nements. Pour ce faire, suivez les instructions ci-dessus, mais ex\u00e9cutez avrsim.py avec une ligne de commande comme celle-ci : PYTHONPATH=/path/to/simulavr/src/python/ ./scripts/avrsim.py out/klipper.elf -t PORTA.PORT,PORTC.PORT Ce qui pr\u00e9c\u00e8de cr\u00e9era un fichier avrsim.vcd avec des informations sur chaque modification des GPIO sur PORTA et PORTB. Ce fichier pourra ensuite \u00eatre visualis\u00e9 en utilisant gtkwave avec : gtkwave avrsim.vcd","title":"Utiliser simulavr avec gtkwave"},{"location":"Delta_Calibrate.html","text":"\u00c9talonnage Delta \u00b6 Ce document d\u00e9crit le syst\u00e8me de calibration automatique de Klipper pour les imprimantes de type \"delta\". L'\u00e9talonnage Delta consiste \u00e0 trouver les positions pour les but\u00e9es de tour, les angles de tour, le rayon Delta et les longueurs de bras Delta. Ces param\u00e8tres contr\u00f4lent le mouvement de l'imprimante sur une imprimante Delta. Chacun de ces param\u00e8tres a un impact non lin\u00e9aire et il est difficile de les calibrer manuellement. En revanche, le code d'\u00e9talonnage logiciel peut fournir d'excellents r\u00e9sultats en quelques minutes seulement. Aucun mat\u00e9riel sp\u00e9cial n'est n\u00e9cessaire. L'\u00e9talonnage Delta d\u00e9pend de la pr\u00e9cision des interrupteurs de fin de course de chaque tour. Si l'on utilise des pilotes de moteur pas \u00e0 pas Trinamic, envisagez d'activer la d\u00e9tection de phase d'arr\u00eat pour am\u00e9liorer la pr\u00e9cision de ces commutateurs. Sondage automatique vs manuel \u00b6 Klipper prend en charge l'\u00e9talonnage des param\u00e8tres delta via une m\u00e9thode de sondage manuelle ou via une sonde Z automatique. Un certain nombre de kits d'imprimantes delta sont livr\u00e9s avec des sondes Z automatiques qui ne sont pas suffisamment pr\u00e9cises (en particulier, de petites diff\u00e9rences de longueur de bras peuvent provoquer une inclinaison de l'effecteur qui peut fausser une sonde automatique). Si vous utilisez une sonde automatique, \u00e9talonnez d'abord la sonde , puis recherchez un le biais d'emplacement de la sonde . Si la sonde automatique a un biais de plus de 25 microns (0,025 mm), utilisez plut\u00f4t une sonde manuelle. Le sondage manuel ne prend que quelques minutes et \u00e9limine les erreurs introduites par la sonde. Si vous utilisez une sonde mont\u00e9e sur le c\u00f4t\u00e9 de l'extr\u00e9mit\u00e9 chaude (c'est-\u00e0-dire qu'elle a un d\u00e9calage X ou Y), notez que l'ex\u00e9cution de l'\u00e9talonnage delta invalidera les r\u00e9sultats de l'\u00e9talonnage de la sonde. Ces types de sondes sont rarement adapt\u00e9s \u00e0 une utilisation sur une delta (car une inclinaison mineure de l'effecteur entra\u00eenera un biais de localisation de la sonde). Si vous utilisez quand m\u00eame la sonde, assurez-vous de relancer l'\u00e9talonnage de la sonde apr\u00e8s tout \u00e9talonnage delta. \u00c9talonnage Delta de base \u00b6 Klipper a une commande DELTA_CALIBRATE qui peut effectuer un \u00e9talonnage Delta de base. Cette commande sonde sept points diff\u00e9rents sur le lit et calcule de nouvelles valeurs pour les angles de la tour, les but\u00e9es de la tour et le rayon delta. Afin d'effectuer cet \u00e9talonnage, les param\u00e8tres delta initiaux (longueurs de bras, rayon et positions de but\u00e9e) doivent \u00eatre fournis et ils doivent avoir une pr\u00e9cision de quelques millim\u00e8tres. La plupart des kits d'imprimante delta fournissent ces param\u00e8tres - configurez l'imprimante avec ces valeurs par d\u00e9faut, puis ex\u00e9cutez la commande DELTA_CALIBRATE comme d\u00e9crit ci-dessous. Si aucune valeur par d\u00e9faut n'est disponible, recherchez en ligne un guide d'\u00e9talonnage delta qui peut fournir un point de d\u00e9part de base. Au cours du processus d'\u00e9talonnage Delta, il peut \u00eatre n\u00e9cessaire que l'imprimante sonde 'en dessous' de ce qui serait autrement consid\u00e9r\u00e9 comme le plan du lit. Il est courant d'autoriser cela lors de l'\u00e9talonnage en mettant \u00e0 jour la configuration de sorte que la position minimum_z_position=-5 de l'imprimante. (Une fois l'\u00e9talonnage termin\u00e9, on peut supprimer ce param\u00e8tre de la configuration.) Il existe deux fa\u00e7ons d'effectuer le sondage : le sondage manuel ( DELTA_CALIBRATE METHOD=manual ) et le sondage automatique ( DELTA_CALIBRATE ). La m\u00e9thode de sondage manuel d\u00e9placera la t\u00eate pr\u00e8s du lit, puis attendra que l'utilisateur suive les \u00e9tapes d\u00e9crites dans \"the paper test\" pour d\u00e9terminer la distance r\u00e9elle entre la buse et lit \u00e0 l'endroit indiqu\u00e9. Pour effectuer le sondage initial, assurez-vous que la configuration a une section [delta_calibrate] d\u00e9finie, puis ex\u00e9cutez l'outil : G28 DELTA_CALIBRATE METHOD=manual Apr\u00e8s avoir sond\u00e9 les sept points, de nouveaux param\u00e8tres Delta seront calcul\u00e9s. Enregistrez et appliquez ces param\u00e8tres en ex\u00e9cutant : SAVE_CONFIG L'\u00e9talonnage initial doit fournir des param\u00e8tres Delta suffisamment pr\u00e9cis pour une impression. S'il s'agit d'une nouvelle imprimante, c'est le bon moment pour imprimer certains objets simples et v\u00e9rifier son bon fonctionnement. \u00c9talonnage Delta avanc\u00e9 \u00b6 L'\u00e9talonnage Delta de base fait g\u00e9n\u00e9ralement un bon travail de calcul des param\u00e8tres delta de sorte que la buse soit \u00e0 la bonne distance du lit. Cependant, il n'essaye pas de calibrer la pr\u00e9cision dimensionnelle X et Y. L'\u00e9talonnage delta am\u00e9lior\u00e9 permet de v\u00e9rifier la pr\u00e9cision dimensionnelle. Cette proc\u00e9dure d'\u00e9talonnage n\u00e9cessite l'impression d'un objet de test et la mesure de parties de cet objet de test avec un pied \u00e0 coulisse. Avant d'ex\u00e9cuter un \u00e9talonnage delta avanc\u00e9, il faut ex\u00e9cuter l'\u00e9talonnage delta de base (via la commande DELTA_CALIBRATE) et enregistrer les r\u00e9sultats (via la commande SAVE_CONFIG). Assurez-vous qu'il n'y a eu aucun changement notable dans la configuration de l'imprimante ni dans le mat\u00e9riel depuis le dernier \u00e9talonnage delta de base (en cas de doute, r\u00e9ex\u00e9cutez l' \u00e9talonnage delta de base , y compris SAVE_CONFIG, juste avant l'impression l'objet de test d\u00e9crit ci-dessous.) Utilisez un trancheur pour g\u00e9n\u00e9rer le G-Code \u00e0 partir du fichier docs/prints/calibrate_size.stl . Tranchez l'objet en utilisant une vitesse lente (par exemple, 40 mm/s). Si possible, utilisez un plastique rigide (comme le PLA) pour l'objet. L'objet a un diam\u00e8tre de 140 mm. Si c'est trop grand pour l'imprimante, il est possible de le r\u00e9duire (mais assurez-vous de mettre uniform\u00e9ment \u00e0 l'\u00e9chelle les axes X et Y). Si l'imprimante prend en charge des impressions beaucoup plus grandes, cet objet peut \u00e9galement \u00eatre agrandi. Une taille plus grande peut am\u00e9liorer la pr\u00e9cision de la mesure, mais une bonne adh\u00e9rence de l'impression est plus importante qu'une taille d'impression plus grande. Imprimez l'objet \u00e0 tester et attendez qu'il refroidisse compl\u00e8tement. Les commandes d\u00e9crites ci-dessous doivent \u00eatre ex\u00e9cut\u00e9es avec les m\u00eames param\u00e8tres d'imprimante que ceux utilis\u00e9s pour imprimer l'objet de calibrage (ne pas ex\u00e9cuter DELTA_CALIBRATE entre l'impression et la mesure, ou faire quelque chose d'autre qui changerait la configuration de l'imprimante). Si possible, effectuez les mesures d\u00e9crites ci-dessous pendant que l'objet est toujours attach\u00e9 au lit d'impression, mais ne vous inqui\u00e9tez pas si la pi\u00e8ce se d\u00e9tache du lit - essayez simplement d'\u00e9viter de tordre l'objet lors de l'ex\u00e9cution des mesures. Commencez par mesurer la distance entre le pilier central et le pilier \u00e0 c\u00f4t\u00e9 de l'\u00e9tiquette \"A\" (qui doit \u00e9galement pointer vers la tour \"A\"). Ensuite, allez dans le sens inverse des aiguilles d'une montre et mesurez les distances entre le pilier central et les autres piliers (distance du centre au pilier en face de l'\u00e9tiquette C, distance du centre au pilier avec l'\u00e9tiquette B, etc.). Entrez ces param\u00e8tres dans Klipper avec une liste de nombres r\u00e9els (/!\\ utilisez le point comme s\u00e9parateur d\u00e9cimal) s\u00e9par\u00e9s par des virgules : DELTA_ANALYZE CENTER_DISTS=<a_dist>,<far_c_dist>,<b_dist>,<far_a_dist>,<c_dist>,<far_b_dist> Fournissez les valeurs sans espaces entre chaque valeurs. Mesurez ensuite la distance entre le pilier A et le pilier en face de l'\u00e9tiquette C. Ensuite, dans le sens antihoraire, mesurez la distance entre le pilier en face de C et le pilier B, la distance entre le pilier B et le pilier en face de A, et ainsi de suite. Saisissez ces param\u00e8tres dans Klipper : DELTA_ANALYZE OUTER_DISTS=<a_to_far_c>,<far_c_to_b>,<b_to_far_a>,<far_a_to_c>,<c_to_far_b>,<far_b_to_a> \u00c0 ce stade, vous pouvez retirer l'objet du lit. Les mesures finales concernent les piliers eux-m\u00eames. Mesurez la taille du pilier central le long du rayon A, puis du rayon B, puis du rayon C. Saisissez-les dans Klipper : DELTA_ANALYZE CENTER_PILLAR_WIDTHS=<a>,<b>,<c> Les mesures finales concernent les piliers ext\u00e9rieurs. Commencez par mesurer la distance du pilier A le long de la ligne allant de A au pilier en face de C. Ensuite, dans le sens antihoraire, mesurez les piliers ext\u00e9rieurs restants (pilier en face de C le long de la ligne vers B, pilier B le long de la ligne vers le pilier en face de A, etc.). Et entrez-les dans Klipper : DELTA_ANALYZE OUTER_PILLAR_WIDTHS=<a>,<far_c>,<b>,<far_a>,<c>,<far_b> Si l'objet a \u00e9t\u00e9 mis \u00e0 l'\u00e9chelle \u00e0 une taille plus petite ou plus grande, indiquez le facteur d'\u00e9chelle utilis\u00e9 lors du d\u00e9coupage de l'objet : DELTA_ANALYZE SCALE=1.0 (Une valeur d'\u00e9chelle de 2,0 signifierait que l'objet est deux fois sa taille d'origine, 0,5 serait la moiti\u00e9 de sa taille d'origine.) Enfin, effectuez l'\u00e9talonnage delta am\u00e9lior\u00e9 en ex\u00e9cutant : DELTA_ANALYZE CALIBRATE=extended Cette commande peut prendre plusieurs minutes. Une fois termin\u00e9, elle calculera les param\u00e8tres delta mis \u00e0 jour (rayon delta, angles de tour, positions de but\u00e9e et longueurs de bras). Utilisez la commande SAVE_CONFIG pour enregistrer et appliquer les param\u00e8tres : SAVE_CONFIG La commande SAVE_CONFIG enregistre \u00e0 la fois les param\u00e8tres delta mis \u00e0 jour et les informations des mesures de distance. Les futures commandes DELTA_CALIBRATE utiliseront \u00e9galement ces informations de distance. N'essayez pas de ressaisir les mesures de distance brutes apr\u00e8s avoir ex\u00e9cut\u00e9 SAVE_CONFIG, car cette commande modifie la configuration de l'imprimante et les mesures brutes ne s'appliquent plus. Notes compl\u00e9mentaires \u00b6 Si l'imprimante Delta a une bonne pr\u00e9cision dimensionnelle, la distance entre deux piliers doit \u00eatre d'environ 74 mm et la largeur de chaque pilier doit \u00eatre d'environ 9 mm. (Plus pr\u00e9cis\u00e9ment, l'objectif est que la distance entre deux piliers moins la largeur de l'un des piliers soit exactement de 65 mm.) S'il y a une inexactitude dimensionnelle dans la pi\u00e8ce, la routine DELTA_ANALYZE calculera de nouveaux param\u00e8tres delta en utilisant \u00e0 la fois les mesures de distance et les mesures de hauteur pr\u00e9c\u00e9dentes de la derni\u00e8re commande DELTA_CALIBRATE. DELTA_ANALYZE peut g\u00e9nerer des param\u00e8tres delta surprenants. Par exemple, il peut sugg\u00e9rer des longueurs de bras qui ne correspondent pas aux longueurs de bras r\u00e9elles de l'imprimante. Malgr\u00e9 cela, les tests ont montr\u00e9 que DELTA_ANALYZE produit souvent de bons r\u00e9sultats. Les param\u00e8tres delta calcul\u00e9s sont capables de tenir compte de l\u00e9g\u00e8res erreurs ailleurs dans le mat\u00e9riel. Par exemple, de petites diff\u00e9rences de longueur de bras peuvent entra\u00eener une inclinaison de l'effecteur et une partie de cette inclinaison peut \u00eatre prise en compte en ajustant les param\u00e8tres de longueur de bras. Utilisation d'un maillage du lit sur une Delta \u00b6 Il est possible d'utiliser le maillage du lit sur une Delta. Cependant, il est important d'obtenir un bon \u00e9talonnage Delta avant d'activer un maillage du lit. L'ex\u00e9cution d'un maillage du lit avec un mauvais calibrage delta entra\u00eenera des r\u00e9sultats m\u00e9diocres. Notez que l'ex\u00e9cution de l'\u00e9talonnage delta invalidera tout maillage de lit pr\u00e9c\u00e9demment obtenu. Apr\u00e8s avoir effectu\u00e9 un nouvel \u00e9talonnage delta, assurez-vous de relancer BED_MESH_CALIBRATE.","title":"\u00c9talonnage Delta"},{"location":"Delta_Calibrate.html#etalonnage-delta","text":"Ce document d\u00e9crit le syst\u00e8me de calibration automatique de Klipper pour les imprimantes de type \"delta\". L'\u00e9talonnage Delta consiste \u00e0 trouver les positions pour les but\u00e9es de tour, les angles de tour, le rayon Delta et les longueurs de bras Delta. Ces param\u00e8tres contr\u00f4lent le mouvement de l'imprimante sur une imprimante Delta. Chacun de ces param\u00e8tres a un impact non lin\u00e9aire et il est difficile de les calibrer manuellement. En revanche, le code d'\u00e9talonnage logiciel peut fournir d'excellents r\u00e9sultats en quelques minutes seulement. Aucun mat\u00e9riel sp\u00e9cial n'est n\u00e9cessaire. L'\u00e9talonnage Delta d\u00e9pend de la pr\u00e9cision des interrupteurs de fin de course de chaque tour. Si l'on utilise des pilotes de moteur pas \u00e0 pas Trinamic, envisagez d'activer la d\u00e9tection de phase d'arr\u00eat pour am\u00e9liorer la pr\u00e9cision de ces commutateurs.","title":"\u00c9talonnage Delta"},{"location":"Delta_Calibrate.html#sondage-automatique-vs-manuel","text":"Klipper prend en charge l'\u00e9talonnage des param\u00e8tres delta via une m\u00e9thode de sondage manuelle ou via une sonde Z automatique. Un certain nombre de kits d'imprimantes delta sont livr\u00e9s avec des sondes Z automatiques qui ne sont pas suffisamment pr\u00e9cises (en particulier, de petites diff\u00e9rences de longueur de bras peuvent provoquer une inclinaison de l'effecteur qui peut fausser une sonde automatique). Si vous utilisez une sonde automatique, \u00e9talonnez d'abord la sonde , puis recherchez un le biais d'emplacement de la sonde . Si la sonde automatique a un biais de plus de 25 microns (0,025 mm), utilisez plut\u00f4t une sonde manuelle. Le sondage manuel ne prend que quelques minutes et \u00e9limine les erreurs introduites par la sonde. Si vous utilisez une sonde mont\u00e9e sur le c\u00f4t\u00e9 de l'extr\u00e9mit\u00e9 chaude (c'est-\u00e0-dire qu'elle a un d\u00e9calage X ou Y), notez que l'ex\u00e9cution de l'\u00e9talonnage delta invalidera les r\u00e9sultats de l'\u00e9talonnage de la sonde. Ces types de sondes sont rarement adapt\u00e9s \u00e0 une utilisation sur une delta (car une inclinaison mineure de l'effecteur entra\u00eenera un biais de localisation de la sonde). Si vous utilisez quand m\u00eame la sonde, assurez-vous de relancer l'\u00e9talonnage de la sonde apr\u00e8s tout \u00e9talonnage delta.","title":"Sondage automatique vs manuel"},{"location":"Delta_Calibrate.html#etalonnage-delta-de-base","text":"Klipper a une commande DELTA_CALIBRATE qui peut effectuer un \u00e9talonnage Delta de base. Cette commande sonde sept points diff\u00e9rents sur le lit et calcule de nouvelles valeurs pour les angles de la tour, les but\u00e9es de la tour et le rayon delta. Afin d'effectuer cet \u00e9talonnage, les param\u00e8tres delta initiaux (longueurs de bras, rayon et positions de but\u00e9e) doivent \u00eatre fournis et ils doivent avoir une pr\u00e9cision de quelques millim\u00e8tres. La plupart des kits d'imprimante delta fournissent ces param\u00e8tres - configurez l'imprimante avec ces valeurs par d\u00e9faut, puis ex\u00e9cutez la commande DELTA_CALIBRATE comme d\u00e9crit ci-dessous. Si aucune valeur par d\u00e9faut n'est disponible, recherchez en ligne un guide d'\u00e9talonnage delta qui peut fournir un point de d\u00e9part de base. Au cours du processus d'\u00e9talonnage Delta, il peut \u00eatre n\u00e9cessaire que l'imprimante sonde 'en dessous' de ce qui serait autrement consid\u00e9r\u00e9 comme le plan du lit. Il est courant d'autoriser cela lors de l'\u00e9talonnage en mettant \u00e0 jour la configuration de sorte que la position minimum_z_position=-5 de l'imprimante. (Une fois l'\u00e9talonnage termin\u00e9, on peut supprimer ce param\u00e8tre de la configuration.) Il existe deux fa\u00e7ons d'effectuer le sondage : le sondage manuel ( DELTA_CALIBRATE METHOD=manual ) et le sondage automatique ( DELTA_CALIBRATE ). La m\u00e9thode de sondage manuel d\u00e9placera la t\u00eate pr\u00e8s du lit, puis attendra que l'utilisateur suive les \u00e9tapes d\u00e9crites dans \"the paper test\" pour d\u00e9terminer la distance r\u00e9elle entre la buse et lit \u00e0 l'endroit indiqu\u00e9. Pour effectuer le sondage initial, assurez-vous que la configuration a une section [delta_calibrate] d\u00e9finie, puis ex\u00e9cutez l'outil : G28 DELTA_CALIBRATE METHOD=manual Apr\u00e8s avoir sond\u00e9 les sept points, de nouveaux param\u00e8tres Delta seront calcul\u00e9s. Enregistrez et appliquez ces param\u00e8tres en ex\u00e9cutant : SAVE_CONFIG L'\u00e9talonnage initial doit fournir des param\u00e8tres Delta suffisamment pr\u00e9cis pour une impression. S'il s'agit d'une nouvelle imprimante, c'est le bon moment pour imprimer certains objets simples et v\u00e9rifier son bon fonctionnement.","title":"\u00c9talonnage Delta de base"},{"location":"Delta_Calibrate.html#etalonnage-delta-avance","text":"L'\u00e9talonnage Delta de base fait g\u00e9n\u00e9ralement un bon travail de calcul des param\u00e8tres delta de sorte que la buse soit \u00e0 la bonne distance du lit. Cependant, il n'essaye pas de calibrer la pr\u00e9cision dimensionnelle X et Y. L'\u00e9talonnage delta am\u00e9lior\u00e9 permet de v\u00e9rifier la pr\u00e9cision dimensionnelle. Cette proc\u00e9dure d'\u00e9talonnage n\u00e9cessite l'impression d'un objet de test et la mesure de parties de cet objet de test avec un pied \u00e0 coulisse. Avant d'ex\u00e9cuter un \u00e9talonnage delta avanc\u00e9, il faut ex\u00e9cuter l'\u00e9talonnage delta de base (via la commande DELTA_CALIBRATE) et enregistrer les r\u00e9sultats (via la commande SAVE_CONFIG). Assurez-vous qu'il n'y a eu aucun changement notable dans la configuration de l'imprimante ni dans le mat\u00e9riel depuis le dernier \u00e9talonnage delta de base (en cas de doute, r\u00e9ex\u00e9cutez l' \u00e9talonnage delta de base , y compris SAVE_CONFIG, juste avant l'impression l'objet de test d\u00e9crit ci-dessous.) Utilisez un trancheur pour g\u00e9n\u00e9rer le G-Code \u00e0 partir du fichier docs/prints/calibrate_size.stl . Tranchez l'objet en utilisant une vitesse lente (par exemple, 40 mm/s). Si possible, utilisez un plastique rigide (comme le PLA) pour l'objet. L'objet a un diam\u00e8tre de 140 mm. Si c'est trop grand pour l'imprimante, il est possible de le r\u00e9duire (mais assurez-vous de mettre uniform\u00e9ment \u00e0 l'\u00e9chelle les axes X et Y). Si l'imprimante prend en charge des impressions beaucoup plus grandes, cet objet peut \u00e9galement \u00eatre agrandi. Une taille plus grande peut am\u00e9liorer la pr\u00e9cision de la mesure, mais une bonne adh\u00e9rence de l'impression est plus importante qu'une taille d'impression plus grande. Imprimez l'objet \u00e0 tester et attendez qu'il refroidisse compl\u00e8tement. Les commandes d\u00e9crites ci-dessous doivent \u00eatre ex\u00e9cut\u00e9es avec les m\u00eames param\u00e8tres d'imprimante que ceux utilis\u00e9s pour imprimer l'objet de calibrage (ne pas ex\u00e9cuter DELTA_CALIBRATE entre l'impression et la mesure, ou faire quelque chose d'autre qui changerait la configuration de l'imprimante). Si possible, effectuez les mesures d\u00e9crites ci-dessous pendant que l'objet est toujours attach\u00e9 au lit d'impression, mais ne vous inqui\u00e9tez pas si la pi\u00e8ce se d\u00e9tache du lit - essayez simplement d'\u00e9viter de tordre l'objet lors de l'ex\u00e9cution des mesures. Commencez par mesurer la distance entre le pilier central et le pilier \u00e0 c\u00f4t\u00e9 de l'\u00e9tiquette \"A\" (qui doit \u00e9galement pointer vers la tour \"A\"). Ensuite, allez dans le sens inverse des aiguilles d'une montre et mesurez les distances entre le pilier central et les autres piliers (distance du centre au pilier en face de l'\u00e9tiquette C, distance du centre au pilier avec l'\u00e9tiquette B, etc.). Entrez ces param\u00e8tres dans Klipper avec une liste de nombres r\u00e9els (/!\\ utilisez le point comme s\u00e9parateur d\u00e9cimal) s\u00e9par\u00e9s par des virgules : DELTA_ANALYZE CENTER_DISTS=<a_dist>,<far_c_dist>,<b_dist>,<far_a_dist>,<c_dist>,<far_b_dist> Fournissez les valeurs sans espaces entre chaque valeurs. Mesurez ensuite la distance entre le pilier A et le pilier en face de l'\u00e9tiquette C. Ensuite, dans le sens antihoraire, mesurez la distance entre le pilier en face de C et le pilier B, la distance entre le pilier B et le pilier en face de A, et ainsi de suite. Saisissez ces param\u00e8tres dans Klipper : DELTA_ANALYZE OUTER_DISTS=<a_to_far_c>,<far_c_to_b>,<b_to_far_a>,<far_a_to_c>,<c_to_far_b>,<far_b_to_a> \u00c0 ce stade, vous pouvez retirer l'objet du lit. Les mesures finales concernent les piliers eux-m\u00eames. Mesurez la taille du pilier central le long du rayon A, puis du rayon B, puis du rayon C. Saisissez-les dans Klipper : DELTA_ANALYZE CENTER_PILLAR_WIDTHS=<a>,<b>,<c> Les mesures finales concernent les piliers ext\u00e9rieurs. Commencez par mesurer la distance du pilier A le long de la ligne allant de A au pilier en face de C. Ensuite, dans le sens antihoraire, mesurez les piliers ext\u00e9rieurs restants (pilier en face de C le long de la ligne vers B, pilier B le long de la ligne vers le pilier en face de A, etc.). Et entrez-les dans Klipper : DELTA_ANALYZE OUTER_PILLAR_WIDTHS=<a>,<far_c>,<b>,<far_a>,<c>,<far_b> Si l'objet a \u00e9t\u00e9 mis \u00e0 l'\u00e9chelle \u00e0 une taille plus petite ou plus grande, indiquez le facteur d'\u00e9chelle utilis\u00e9 lors du d\u00e9coupage de l'objet : DELTA_ANALYZE SCALE=1.0 (Une valeur d'\u00e9chelle de 2,0 signifierait que l'objet est deux fois sa taille d'origine, 0,5 serait la moiti\u00e9 de sa taille d'origine.) Enfin, effectuez l'\u00e9talonnage delta am\u00e9lior\u00e9 en ex\u00e9cutant : DELTA_ANALYZE CALIBRATE=extended Cette commande peut prendre plusieurs minutes. Une fois termin\u00e9, elle calculera les param\u00e8tres delta mis \u00e0 jour (rayon delta, angles de tour, positions de but\u00e9e et longueurs de bras). Utilisez la commande SAVE_CONFIG pour enregistrer et appliquer les param\u00e8tres : SAVE_CONFIG La commande SAVE_CONFIG enregistre \u00e0 la fois les param\u00e8tres delta mis \u00e0 jour et les informations des mesures de distance. Les futures commandes DELTA_CALIBRATE utiliseront \u00e9galement ces informations de distance. N'essayez pas de ressaisir les mesures de distance brutes apr\u00e8s avoir ex\u00e9cut\u00e9 SAVE_CONFIG, car cette commande modifie la configuration de l'imprimante et les mesures brutes ne s'appliquent plus.","title":"\u00c9talonnage Delta avanc\u00e9"},{"location":"Delta_Calibrate.html#notes-complementaires","text":"Si l'imprimante Delta a une bonne pr\u00e9cision dimensionnelle, la distance entre deux piliers doit \u00eatre d'environ 74 mm et la largeur de chaque pilier doit \u00eatre d'environ 9 mm. (Plus pr\u00e9cis\u00e9ment, l'objectif est que la distance entre deux piliers moins la largeur de l'un des piliers soit exactement de 65 mm.) S'il y a une inexactitude dimensionnelle dans la pi\u00e8ce, la routine DELTA_ANALYZE calculera de nouveaux param\u00e8tres delta en utilisant \u00e0 la fois les mesures de distance et les mesures de hauteur pr\u00e9c\u00e9dentes de la derni\u00e8re commande DELTA_CALIBRATE. DELTA_ANALYZE peut g\u00e9nerer des param\u00e8tres delta surprenants. Par exemple, il peut sugg\u00e9rer des longueurs de bras qui ne correspondent pas aux longueurs de bras r\u00e9elles de l'imprimante. Malgr\u00e9 cela, les tests ont montr\u00e9 que DELTA_ANALYZE produit souvent de bons r\u00e9sultats. Les param\u00e8tres delta calcul\u00e9s sont capables de tenir compte de l\u00e9g\u00e8res erreurs ailleurs dans le mat\u00e9riel. Par exemple, de petites diff\u00e9rences de longueur de bras peuvent entra\u00eener une inclinaison de l'effecteur et une partie de cette inclinaison peut \u00eatre prise en compte en ajustant les param\u00e8tres de longueur de bras.","title":"Notes compl\u00e9mentaires"},{"location":"Delta_Calibrate.html#utilisation-dun-maillage-du-lit-sur-une-delta","text":"Il est possible d'utiliser le maillage du lit sur une Delta. Cependant, il est important d'obtenir un bon \u00e9talonnage Delta avant d'activer un maillage du lit. L'ex\u00e9cution d'un maillage du lit avec un mauvais calibrage delta entra\u00eenera des r\u00e9sultats m\u00e9diocres. Notez que l'ex\u00e9cution de l'\u00e9talonnage delta invalidera tout maillage de lit pr\u00e9c\u00e9demment obtenu. Apr\u00e8s avoir effectu\u00e9 un nouvel \u00e9talonnage delta, assurez-vous de relancer BED_MESH_CALIBRATE.","title":"Utilisation d'un maillage du lit sur une Delta"},{"location":"Endstop_Phase.html","text":"Phase de fin de course \u00b6 Ce document d\u00e9crit le syst\u00e8me de but\u00e9e ajust\u00e9e en phase pas \u00e0 pas de Klipper. Cette fonctionnalit\u00e9 peut am\u00e9liorer la pr\u00e9cision des interrupteurs de fin de course traditionnels. Il est particuli\u00e8rement utile lors de l'utilisation d'un pilote de moteur pas \u00e0 pas Trinamic dot\u00e9 d'une configuration d'ex\u00e9cution. Un interrupteur de fin de course standard a une pr\u00e9cision d'environ 100 microns. (Chaque fois qu'un axe est r\u00e9f\u00e9renc\u00e9, le commutateur peut se d\u00e9clencher l\u00e9g\u00e8rement plus t\u00f4t ou l\u00e9g\u00e8rement plus tard.) Bien qu'il s'agisse d'une erreur relativement petite, elle peut entra\u00eener des artefacts ind\u00e9sirables. En particulier, cet \u00e9cart de position peut \u00eatre perceptible lors de l'impression de la premi\u00e8re couche d'un objet. En revanche, les moteurs pas \u00e0 pas standard peuvent obtenir une pr\u00e9cision nettement sup\u00e9rieure. Le m\u00e9canisme de but\u00e9e \u00e0 ajustement de phase peut utiliser la pr\u00e9cision des moteurs pas \u00e0 pas pour am\u00e9liorer la pr\u00e9cision des interrupteurs de but\u00e9e. Un moteur pas \u00e0 pas se d\u00e9place en suivant une s\u00e9rie de phase jusqu'\u00e0 ce qu'il effectue quatre \"\u00e9tapes compl\u00e8tes\". Ainsi, un moteur pas \u00e0 pas utilisant 16 micro-pas aura 64 phases et lorsqu'il se d\u00e9place dans le sens positif, il passera par phases : 0, 1, 2, ... 61, 62, 63, 0, 1, 2, etc. Surtout, lorsque le moteur pas \u00e0 pas se trouve \u00e0 une position particuli\u00e8re sur un rail lin\u00e9aire, il doit toujours \u00eatre \u00e0 la m\u00eame phase. Ainsi, lorsqu'un chariot d\u00e9clenche l'interrupteur de fin de course, le moteur pas \u00e0 pas contr\u00f4lant ce chariot doit toujours \u00eatre \u00e0 la m\u00eame phase du moteur pas \u00e0 pas. Le syst\u00e8me de phase d'arr\u00eat final de Klipper combine la phase pas \u00e0 pas avec le d\u00e9clencheur d'arr\u00eat final pour am\u00e9liorer la pr\u00e9cision de l'arr\u00eat final. Pour utiliser cette fonctionnalit\u00e9, il est n\u00e9cessaire de pouvoir identifier la phase du moteur pas \u00e0 pas. Si l'on utilise les pilotes Trinamic TMC2130, TMC2208, TMC2224 ou TMC2660 en mode de configuration d'ex\u00e9cution (c'est-\u00e0-dire pas en mode autonome - \"standalone\"), Klipper peut interroger la phase pas \u00e0 pas du pilote. (Il est \u00e9galement possible d'utiliser ce syst\u00e8me sur des pilotes pas \u00e0 pas traditionnels si l'on peut r\u00e9initialiser de mani\u00e8re fiable ces pilotes pas \u00e0 pas - voir ci-dessous pour plus de d\u00e9tails.) \u00c9talonnage des phases de fin de course \u00b6 Si vous utilisez des pilotes de moteur pas \u00e0 pas Trinamic avec une configuration d'ex\u00e9cution, vous pouvez calibrer les phases de fin de course \u00e0 l'aide de la commande ENDSTOP_PHASE_CALIBRATE. Commencez par ajouter les \u00e9l\u00e9ments suivants au fichier de configuration : [endstop_phase] Red\u00e9marrez ensuite l'imprimante et ex\u00e9cutez une commande G28 suivie d'une commande ENDSTOP_PHASE_CALIBRATE . D\u00e9placez ensuite la t\u00eate d'outil vers un nouvel emplacement et ex\u00e9cutez \u00e0 nouveau G28 . Essayez de d\u00e9placer la t\u00eate d'outil \u00e0 plusieurs endroits diff\u00e9rents et r\u00e9ex\u00e9cutez G28 \u00e0 partir de chaque position. Ex\u00e9cutez au moins cinq commandes G28 . Apr\u00e8s avoir effectu\u00e9 ce qui pr\u00e9c\u00e8de, la commande ENDSTOP_PHASE_CALIBRATE signalera souvent la m\u00eame (ou presque la m\u00eame) phase pour le stepper. Cette phase peut \u00eatre enregistr\u00e9e dans le fichier de configuration afin que toutes les futures commandes G28 utilisent cette phase. (Ainsi, dans les futures op\u00e9rations de prise d'origine, Klipper obtiendra la m\u00eame position m\u00eame si la but\u00e9e se d\u00e9clenche un peu plus t\u00f4t ou un peu plus tard.) Pour enregistrer la phase d'arr\u00eat final d'un moteur pas \u00e0 pas particulier, ex\u00e9cutez quelque chose comme ceci : ENDSTOP_PHASE_CALIBRATE STEPPER=stepper_z Ex\u00e9cutez ce qui pr\u00e9c\u00e8de pour tous les steppers que vous souhaitez enregistrer. En r\u00e8gle g\u00e9n\u00e9rale, on l'utiliserait sur stepper_z pour les imprimantes cart\u00e9siennes et corexy, et pour stepper_a, stepper_b et stepper_c sur les imprimantes delta. Enfin, ex\u00e9cutez la commande suivante pour mettre \u00e0 jour le fichier de configuration avec les donn\u00e9es : SAVE_CONFIG Notes compl\u00e9mentaires \u00b6 Cette fonctionnalit\u00e9 est particuli\u00e8rement utile sur les imprimantes delta et sur la but\u00e9e Z des imprimantes cart\u00e9siennes/corexy. Il est possible d'utiliser cette fonctionnalit\u00e9 sur les but\u00e9es XY des imprimantes cart\u00e9siennes, mais cela n'est pas particuli\u00e8rement utile car une erreur mineure dans la position de la but\u00e9e X/Y n'aura probablement pas d'impact sur la qualit\u00e9 d'impression. Il n'est pas valide d'utiliser cette fonctionnalit\u00e9 sur les but\u00e9es XY des imprimantes corexy (car la position XY n'est pas d\u00e9termin\u00e9e par un seul stepper sur la cin\u00e9matique corexy). Il n'est pas valide d'utiliser cette fonctionnalit\u00e9 sur une imprimante utilisant une but\u00e9e Z \"probe:z_virtual_endstop\" (car la phase pas \u00e0 pas n'est stable que si la but\u00e9e se trouve \u00e0 un emplacement statique sur un rail). Apr\u00e8s avoir calibr\u00e9 la phase de but\u00e9e, si la but\u00e9e est d\u00e9plac\u00e9e ou ajust\u00e9e ult\u00e9rieurement, il sera n\u00e9cessaire de recalibrer la but\u00e9e. Supprimez les donn\u00e9es d'\u00e9talonnage du fichier de configuration et r\u00e9ex\u00e9cutez les \u00e9tapes ci-dessus. Pour utiliser ce syst\u00e8me, la but\u00e9e doit \u00eatre suffisamment pr\u00e9cise pour identifier la position du stepper en deux \"pas complets\". Ainsi, par exemple, si un stepper utilise 16 micro-pas avec une distance de pas de 0,005 mm, la but\u00e9e doit avoir une pr\u00e9cision d'au moins 0,160 mm. Si l'on obtient des messages d'erreur de type \"Endstop stepper_z incorrect phase\", cela peut \u00eatre d\u00fb \u00e0 un endstop qui n'est pas suffisamment pr\u00e9cis. Si le recalibrage n'aide pas, d\u00e9sactivez les ajustements de phase de but\u00e9e en les supprimant du fichier de configuration. Si l'on utilise un axe Z traditionnel contr\u00f4l\u00e9 par pas \u00e0 pas (comme sur une imprimante cart\u00e9sienne ou corexy) avec des vis de nivellement de lit traditionnelles, il est \u00e9galement possible d'utiliser ce syst\u00e8me pour faire en sorte que chaque couche d'impression soit effectu\u00e9e sur une limite \"pas complet\" . Pour activer cette fonctionnalit\u00e9, assurez-vous que le slicer G-Code est configur\u00e9 avec une hauteur de couche qui est un multiple d'un \"pas complet\", activez manuellement l'option endstop_align_zero dans la section de configuration endstop_phase (voir reference de configuration pour plus de d\u00e9tails), puis remettez \u00e0 niveau les vis du lit. Il est possible d'utiliser ce syst\u00e8me avec des pilotes de moteurs pas \u00e0 pas traditionnels (non Trinamic). Cependant, cela n\u00e9cessite de s'assurer que les pilotes du moteur pas \u00e0 pas sont r\u00e9initialis\u00e9s \u00e0 chaque fois que le microcontr\u00f4leur est r\u00e9initialis\u00e9. (Si les deux sont toujours r\u00e9initialis\u00e9s ensemble, Klipper peut d\u00e9terminer la phase du moteur pas \u00e0 pas en suivant le nombre total de pas qu'il a command\u00e9 au moteur pas \u00e0 pas.) Actuellement, la seule fa\u00e7on de le faire de mani\u00e8re fiable est que le microcontr\u00f4leur et le moteur pas \u00e0 pas les pilotes soient aliment\u00e9s uniquement par USB et que l'alimentation USB soit fournie par un h\u00f4te fonctionnant sur un Raspberry Pi. Dans cette situation, on peut sp\u00e9cifier une configuration mcu avec \"restart_method\u202f: rpi_usb\" - cette option fera en sorte que le microcontr\u00f4leur soit toujours r\u00e9initialis\u00e9 via une r\u00e9initialisation de l'alimentation USB, ce qui permettrait \u00e0 la fois au microcontr\u00f4leur et aux pilotes de moteur pas \u00e0 pas d'\u00eatre r\u00e9initialiser ensemble. Si vous utilisez ce m\u00e9canisme, vous devrez alors configurer manuellement les sections de configuration \"trigger_phase\" (voir config reference pour les d\u00e9tails).","title":"Phase de fin de course"},{"location":"Endstop_Phase.html#phase-de-fin-de-course","text":"Ce document d\u00e9crit le syst\u00e8me de but\u00e9e ajust\u00e9e en phase pas \u00e0 pas de Klipper. Cette fonctionnalit\u00e9 peut am\u00e9liorer la pr\u00e9cision des interrupteurs de fin de course traditionnels. Il est particuli\u00e8rement utile lors de l'utilisation d'un pilote de moteur pas \u00e0 pas Trinamic dot\u00e9 d'une configuration d'ex\u00e9cution. Un interrupteur de fin de course standard a une pr\u00e9cision d'environ 100 microns. (Chaque fois qu'un axe est r\u00e9f\u00e9renc\u00e9, le commutateur peut se d\u00e9clencher l\u00e9g\u00e8rement plus t\u00f4t ou l\u00e9g\u00e8rement plus tard.) Bien qu'il s'agisse d'une erreur relativement petite, elle peut entra\u00eener des artefacts ind\u00e9sirables. En particulier, cet \u00e9cart de position peut \u00eatre perceptible lors de l'impression de la premi\u00e8re couche d'un objet. En revanche, les moteurs pas \u00e0 pas standard peuvent obtenir une pr\u00e9cision nettement sup\u00e9rieure. Le m\u00e9canisme de but\u00e9e \u00e0 ajustement de phase peut utiliser la pr\u00e9cision des moteurs pas \u00e0 pas pour am\u00e9liorer la pr\u00e9cision des interrupteurs de but\u00e9e. Un moteur pas \u00e0 pas se d\u00e9place en suivant une s\u00e9rie de phase jusqu'\u00e0 ce qu'il effectue quatre \"\u00e9tapes compl\u00e8tes\". Ainsi, un moteur pas \u00e0 pas utilisant 16 micro-pas aura 64 phases et lorsqu'il se d\u00e9place dans le sens positif, il passera par phases : 0, 1, 2, ... 61, 62, 63, 0, 1, 2, etc. Surtout, lorsque le moteur pas \u00e0 pas se trouve \u00e0 une position particuli\u00e8re sur un rail lin\u00e9aire, il doit toujours \u00eatre \u00e0 la m\u00eame phase. Ainsi, lorsqu'un chariot d\u00e9clenche l'interrupteur de fin de course, le moteur pas \u00e0 pas contr\u00f4lant ce chariot doit toujours \u00eatre \u00e0 la m\u00eame phase du moteur pas \u00e0 pas. Le syst\u00e8me de phase d'arr\u00eat final de Klipper combine la phase pas \u00e0 pas avec le d\u00e9clencheur d'arr\u00eat final pour am\u00e9liorer la pr\u00e9cision de l'arr\u00eat final. Pour utiliser cette fonctionnalit\u00e9, il est n\u00e9cessaire de pouvoir identifier la phase du moteur pas \u00e0 pas. Si l'on utilise les pilotes Trinamic TMC2130, TMC2208, TMC2224 ou TMC2660 en mode de configuration d'ex\u00e9cution (c'est-\u00e0-dire pas en mode autonome - \"standalone\"), Klipper peut interroger la phase pas \u00e0 pas du pilote. (Il est \u00e9galement possible d'utiliser ce syst\u00e8me sur des pilotes pas \u00e0 pas traditionnels si l'on peut r\u00e9initialiser de mani\u00e8re fiable ces pilotes pas \u00e0 pas - voir ci-dessous pour plus de d\u00e9tails.)","title":"Phase de fin de course"},{"location":"Endstop_Phase.html#etalonnage-des-phases-de-fin-de-course","text":"Si vous utilisez des pilotes de moteur pas \u00e0 pas Trinamic avec une configuration d'ex\u00e9cution, vous pouvez calibrer les phases de fin de course \u00e0 l'aide de la commande ENDSTOP_PHASE_CALIBRATE. Commencez par ajouter les \u00e9l\u00e9ments suivants au fichier de configuration : [endstop_phase] Red\u00e9marrez ensuite l'imprimante et ex\u00e9cutez une commande G28 suivie d'une commande ENDSTOP_PHASE_CALIBRATE . D\u00e9placez ensuite la t\u00eate d'outil vers un nouvel emplacement et ex\u00e9cutez \u00e0 nouveau G28 . Essayez de d\u00e9placer la t\u00eate d'outil \u00e0 plusieurs endroits diff\u00e9rents et r\u00e9ex\u00e9cutez G28 \u00e0 partir de chaque position. Ex\u00e9cutez au moins cinq commandes G28 . Apr\u00e8s avoir effectu\u00e9 ce qui pr\u00e9c\u00e8de, la commande ENDSTOP_PHASE_CALIBRATE signalera souvent la m\u00eame (ou presque la m\u00eame) phase pour le stepper. Cette phase peut \u00eatre enregistr\u00e9e dans le fichier de configuration afin que toutes les futures commandes G28 utilisent cette phase. (Ainsi, dans les futures op\u00e9rations de prise d'origine, Klipper obtiendra la m\u00eame position m\u00eame si la but\u00e9e se d\u00e9clenche un peu plus t\u00f4t ou un peu plus tard.) Pour enregistrer la phase d'arr\u00eat final d'un moteur pas \u00e0 pas particulier, ex\u00e9cutez quelque chose comme ceci : ENDSTOP_PHASE_CALIBRATE STEPPER=stepper_z Ex\u00e9cutez ce qui pr\u00e9c\u00e8de pour tous les steppers que vous souhaitez enregistrer. En r\u00e8gle g\u00e9n\u00e9rale, on l'utiliserait sur stepper_z pour les imprimantes cart\u00e9siennes et corexy, et pour stepper_a, stepper_b et stepper_c sur les imprimantes delta. Enfin, ex\u00e9cutez la commande suivante pour mettre \u00e0 jour le fichier de configuration avec les donn\u00e9es : SAVE_CONFIG","title":"\u00c9talonnage des phases de fin de course"},{"location":"Endstop_Phase.html#notes-complementaires","text":"Cette fonctionnalit\u00e9 est particuli\u00e8rement utile sur les imprimantes delta et sur la but\u00e9e Z des imprimantes cart\u00e9siennes/corexy. Il est possible d'utiliser cette fonctionnalit\u00e9 sur les but\u00e9es XY des imprimantes cart\u00e9siennes, mais cela n'est pas particuli\u00e8rement utile car une erreur mineure dans la position de la but\u00e9e X/Y n'aura probablement pas d'impact sur la qualit\u00e9 d'impression. Il n'est pas valide d'utiliser cette fonctionnalit\u00e9 sur les but\u00e9es XY des imprimantes corexy (car la position XY n'est pas d\u00e9termin\u00e9e par un seul stepper sur la cin\u00e9matique corexy). Il n'est pas valide d'utiliser cette fonctionnalit\u00e9 sur une imprimante utilisant une but\u00e9e Z \"probe:z_virtual_endstop\" (car la phase pas \u00e0 pas n'est stable que si la but\u00e9e se trouve \u00e0 un emplacement statique sur un rail). Apr\u00e8s avoir calibr\u00e9 la phase de but\u00e9e, si la but\u00e9e est d\u00e9plac\u00e9e ou ajust\u00e9e ult\u00e9rieurement, il sera n\u00e9cessaire de recalibrer la but\u00e9e. Supprimez les donn\u00e9es d'\u00e9talonnage du fichier de configuration et r\u00e9ex\u00e9cutez les \u00e9tapes ci-dessus. Pour utiliser ce syst\u00e8me, la but\u00e9e doit \u00eatre suffisamment pr\u00e9cise pour identifier la position du stepper en deux \"pas complets\". Ainsi, par exemple, si un stepper utilise 16 micro-pas avec une distance de pas de 0,005 mm, la but\u00e9e doit avoir une pr\u00e9cision d'au moins 0,160 mm. Si l'on obtient des messages d'erreur de type \"Endstop stepper_z incorrect phase\", cela peut \u00eatre d\u00fb \u00e0 un endstop qui n'est pas suffisamment pr\u00e9cis. Si le recalibrage n'aide pas, d\u00e9sactivez les ajustements de phase de but\u00e9e en les supprimant du fichier de configuration. Si l'on utilise un axe Z traditionnel contr\u00f4l\u00e9 par pas \u00e0 pas (comme sur une imprimante cart\u00e9sienne ou corexy) avec des vis de nivellement de lit traditionnelles, il est \u00e9galement possible d'utiliser ce syst\u00e8me pour faire en sorte que chaque couche d'impression soit effectu\u00e9e sur une limite \"pas complet\" . Pour activer cette fonctionnalit\u00e9, assurez-vous que le slicer G-Code est configur\u00e9 avec une hauteur de couche qui est un multiple d'un \"pas complet\", activez manuellement l'option endstop_align_zero dans la section de configuration endstop_phase (voir reference de configuration pour plus de d\u00e9tails), puis remettez \u00e0 niveau les vis du lit. Il est possible d'utiliser ce syst\u00e8me avec des pilotes de moteurs pas \u00e0 pas traditionnels (non Trinamic). Cependant, cela n\u00e9cessite de s'assurer que les pilotes du moteur pas \u00e0 pas sont r\u00e9initialis\u00e9s \u00e0 chaque fois que le microcontr\u00f4leur est r\u00e9initialis\u00e9. (Si les deux sont toujours r\u00e9initialis\u00e9s ensemble, Klipper peut d\u00e9terminer la phase du moteur pas \u00e0 pas en suivant le nombre total de pas qu'il a command\u00e9 au moteur pas \u00e0 pas.) Actuellement, la seule fa\u00e7on de le faire de mani\u00e8re fiable est que le microcontr\u00f4leur et le moteur pas \u00e0 pas les pilotes soient aliment\u00e9s uniquement par USB et que l'alimentation USB soit fournie par un h\u00f4te fonctionnant sur un Raspberry Pi. Dans cette situation, on peut sp\u00e9cifier une configuration mcu avec \"restart_method\u202f: rpi_usb\" - cette option fera en sorte que le microcontr\u00f4leur soit toujours r\u00e9initialis\u00e9 via une r\u00e9initialisation de l'alimentation USB, ce qui permettrait \u00e0 la fois au microcontr\u00f4leur et aux pilotes de moteur pas \u00e0 pas d'\u00eatre r\u00e9initialiser ensemble. Si vous utilisez ce m\u00e9canisme, vous devrez alors configurer manuellement les sections de configuration \"trigger_phase\" (voir config reference pour les d\u00e9tails).","title":"Notes compl\u00e9mentaires"},{"location":"Example_Configs.html","text":"Exemples de configurations \u00b6 Ce document contient des directives pour contribuer \u00e0 un exemple de configuration Klipper dans le d\u00e9p\u00f4t github de Klipper (situ\u00e9 dans le r\u00e9pertoire config ). Notez que le serveur discord communautaire de Klipper est une ressource utile pour trouver et partager des fichiers de configuration. Lignes directives \u00b6 S\u00e9lectionnez le pr\u00e9fixe de nom de fichier de configuration appropri\u00e9 : Le pr\u00e9fixe printer est utilis\u00e9 pour les imprimantes de stock vendues par un fabricant grand public. Le pr\u00e9fixe generic est utilis\u00e9 pour une carte m\u00e8re d'imprimante 3d qui peut \u00eatre utilis\u00e9e dans de nombreux types d'imprimantes. Le pr\u00e9fixe kit est destin\u00e9 aux imprimantes 3D assembl\u00e9es selon une sp\u00e9cification largement utilis\u00e9e. Ces imprimantes en \u00ab kit \u00bb sont g\u00e9n\u00e9ralement distinctes des \u00ab imprimantes \u00bb normales en ce sens qu\u2019elles ne sont pas vendues par un fabricant. Le pr\u00e9fixe sample est utilis\u00e9 pour des \"extraits\" de configuration que l'on peut copier-coller dans le fichier de configuration principal. Le pr\u00e9fixe example est utilis\u00e9 pour d\u00e9crire la cin\u00e9matique de l\u2019imprimante. Ce type de configuration n\u2019est g\u00e9n\u00e9ralement ajout\u00e9 qu\u2019avec le code d\u2019un nouveau type de cin\u00e9matique d\u2019imprimante. Tous les fichiers de configuration doivent se terminer par un suffixe .cfg . Les fichiers de configuration printer doivent se terminer par une ann\u00e9e suivie de .cfg (par exemple, -2019.cfg ). Dans ce cas, l'ann\u00e9e est une ann\u00e9e approximative o\u00f9 l'imprimante donn\u00e9e a \u00e9t\u00e9 vendue. N'utilisez pas d'espaces ou de caract\u00e8res sp\u00e9ciaux dans le nom du fichier de configuration. Le nom du fichier doit contenir uniquement les caract\u00e8res A-Z , a-z , 0-9 , - , et . . Klipper doit \u00eatre capable de d\u00e9marrer les fichiers de configuration d'exemple printer , generic , et kit sans erreur. Ces fichiers de configuration doivent \u00eatre ajout\u00e9s au sc\u00e9nario de test de r\u00e9gression test/klippy/printers.test . Ajoutez les nouveaux fichiers de configuration \u00e0 ce sc\u00e9nario de test dans la section appropri\u00e9e et par ordre alphab\u00e9tique dans cette section. L'exemple de configuration doit correspondre \u00e0 la configuration \"standard\" de l'imprimante. (Il existe trop de configurations \"personnalis\u00e9es\" pour \u00eatre suivies dans le r\u00e9f\u00e9rentiel principal de Klipper). De m\u00eame, nous n'ajoutons de fichiers de configuration d'exemple que pour les imprimantes, les kits et les cartes contr\u00f4leur qui ont une popularit\u00e9 grand public (par exemple, il devrait y en avoir au moins une centaine en utilisation active). Pensez \u00e0 utiliser le Serveur communautaire Discourse de Klipper pour les autres configurations. Only specify those devices present on the given printer or board. Do not specify settings specific to your particular setup. For generic config files, only those devices on the mainboard should be described. For example, it would not make sense to add a display config section to a \"generic\" config as there is no way to know if the board will be attached to that type of display. If the board has a specific hardware port to facilitate an optional peripheral (eg, a bltouch port) then one can add a \"commented out\" config section for the given device. Ne sp\u00e9cifiez pas pressure_advance dans un exemple de configuration, car cette valeur est sp\u00e9cifique au filament, et non au mat\u00e9riel de l'imprimante. De m\u00eame, ne sp\u00e9cifiez pas les param\u00e8tres max_extrude_only_velocity et max_extrude_only_accel . Ne sp\u00e9cifiez pas une section de configuration contenant un chemin d'acc\u00e8s \u00e0 l'h\u00f4te ou un mat\u00e9riel h\u00f4te. Par exemple, ne sp\u00e9cifiez pas les sections de configuration [virtual_sdcard] et [temperature_host] . Ne d\u00e9finissez que les macros qui utilisent une fonctionnalit\u00e9 sp\u00e9cifique \u00e0 l'imprimante donn\u00e9e ou pour d\u00e9finir les codes g g\u00e9n\u00e9ralement \u00e9mis par les trancheurs configur\u00e9s pour l'imprimante donn\u00e9e. Where possible, it is best to use the same wording, phrasing, indentation, and section ordering as the existing config files. The top of each config file should list the type of micro-controller the user should select during \"make menuconfig\". It should also have a reference to \"docs/Config_Reference.md\". Ne copiez pas la documentation du champ dans les fichiers de configuration d'exemple. (Faire cela cr\u00e9e une charge de maintenance car une mise \u00e0 jour de la documentation n\u00e9cessiterait alors de la modifier \u00e0 de nombreux endroits.) Les exemples de fichiers de configuration ne doivent pas contenir de section \"SAVE_CONFIG\". Si n\u00e9cessaire, copiez les champs pertinents de la section SAVE_CONFIG dans la section appropri\u00e9e de la zone de configuration principale. Utilisez la syntaxe field: value au lieu de field=value . Lorsque vous ajoutez une rotation_distance pour une extrudeuse, il est pr\u00e9f\u00e9rable de sp\u00e9cifier un gear_ratio si l'extrudeuse a un m\u00e9canisme d'engrenage. Nous nous attendons \u00e0 ce que la distance de rotation dans les exemples de configuration corresponde \u00e0 la circonf\u00e9rence de l'engrenage dent\u00e9 dans l'extrudeuse - elle est normalement comprise entre 20 et 35 mm. Lorsque vous sp\u00e9cifiez un gear_ratio , il est pr\u00e9f\u00e9rable de sp\u00e9cifier les engrenages r\u00e9els du m\u00e9canisme (par exemple, pr\u00e9f\u00e9rez gear_ratio : 80:20 \u00e0 gear_ratio : 4:1 ). Voir le document sur la distance de rotation pour plus d'informations. \u00c9vitez de d\u00e9finir des valeurs de champ fix\u00e9es \u00e0 leur valeur par d\u00e9faut. Par exemple, il est inutile de sp\u00e9cifier min_extrude_temp : 170 car c'est d\u00e9j\u00e0 la valeur par d\u00e9faut. Dans la mesure du possible, les lignes ne devraient pas d\u00e9passer 80 colonnes. \u00c9vitez d'ajouter des messages d'attribution ou de r\u00e9vision dans les fichiers de configuration. (Par exemple, \u00e9vitez d'ajouter des lignes telles que \"ce fichier a \u00e9t\u00e9 cr\u00e9\u00e9 par ...\".) Placez l'attribution et l'historique des modifications dans le message git commit. N'utilisez pas de fonctionnalit\u00e9s obsol\u00e8tes dans le fichier de configuration d'exemple. Ne pas d\u00e9sactiver un syst\u00e8me de s\u00e9curit\u00e9 par d\u00e9faut dans un fichier de configuration d'exemple. Par exemple, une configuration ne doit pas sp\u00e9cifier un max_extrude_cross_section personnalis\u00e9. N'activez pas les fonctions de d\u00e9bogage. Par exemple, il ne doit pas y avoir de section de configuration force_move . Toutes les cartes connues que Klipper prend en charge peuvent utiliser la vitesse de transmission s\u00e9rie par d\u00e9faut de 250000. Ne recommandez pas un d\u00e9bit en bauds diff\u00e9rent dans un fichier de configuration d'exemple. Les exemples de fichiers de configuration sont soumis en cr\u00e9ant une \"pull request\" sur github. Veuillez \u00e9galement suivre les instructions du document de contribution .","title":"Exemples de configurations"},{"location":"Example_Configs.html#exemples-de-configurations","text":"Ce document contient des directives pour contribuer \u00e0 un exemple de configuration Klipper dans le d\u00e9p\u00f4t github de Klipper (situ\u00e9 dans le r\u00e9pertoire config ). Notez que le serveur discord communautaire de Klipper est une ressource utile pour trouver et partager des fichiers de configuration.","title":"Exemples de configurations"},{"location":"Example_Configs.html#lignes-directives","text":"S\u00e9lectionnez le pr\u00e9fixe de nom de fichier de configuration appropri\u00e9 : Le pr\u00e9fixe printer est utilis\u00e9 pour les imprimantes de stock vendues par un fabricant grand public. Le pr\u00e9fixe generic est utilis\u00e9 pour une carte m\u00e8re d'imprimante 3d qui peut \u00eatre utilis\u00e9e dans de nombreux types d'imprimantes. Le pr\u00e9fixe kit est destin\u00e9 aux imprimantes 3D assembl\u00e9es selon une sp\u00e9cification largement utilis\u00e9e. Ces imprimantes en \u00ab kit \u00bb sont g\u00e9n\u00e9ralement distinctes des \u00ab imprimantes \u00bb normales en ce sens qu\u2019elles ne sont pas vendues par un fabricant. Le pr\u00e9fixe sample est utilis\u00e9 pour des \"extraits\" de configuration que l'on peut copier-coller dans le fichier de configuration principal. Le pr\u00e9fixe example est utilis\u00e9 pour d\u00e9crire la cin\u00e9matique de l\u2019imprimante. Ce type de configuration n\u2019est g\u00e9n\u00e9ralement ajout\u00e9 qu\u2019avec le code d\u2019un nouveau type de cin\u00e9matique d\u2019imprimante. Tous les fichiers de configuration doivent se terminer par un suffixe .cfg . Les fichiers de configuration printer doivent se terminer par une ann\u00e9e suivie de .cfg (par exemple, -2019.cfg ). Dans ce cas, l'ann\u00e9e est une ann\u00e9e approximative o\u00f9 l'imprimante donn\u00e9e a \u00e9t\u00e9 vendue. N'utilisez pas d'espaces ou de caract\u00e8res sp\u00e9ciaux dans le nom du fichier de configuration. Le nom du fichier doit contenir uniquement les caract\u00e8res A-Z , a-z , 0-9 , - , et . . Klipper doit \u00eatre capable de d\u00e9marrer les fichiers de configuration d'exemple printer , generic , et kit sans erreur. Ces fichiers de configuration doivent \u00eatre ajout\u00e9s au sc\u00e9nario de test de r\u00e9gression test/klippy/printers.test . Ajoutez les nouveaux fichiers de configuration \u00e0 ce sc\u00e9nario de test dans la section appropri\u00e9e et par ordre alphab\u00e9tique dans cette section. L'exemple de configuration doit correspondre \u00e0 la configuration \"standard\" de l'imprimante. (Il existe trop de configurations \"personnalis\u00e9es\" pour \u00eatre suivies dans le r\u00e9f\u00e9rentiel principal de Klipper). De m\u00eame, nous n'ajoutons de fichiers de configuration d'exemple que pour les imprimantes, les kits et les cartes contr\u00f4leur qui ont une popularit\u00e9 grand public (par exemple, il devrait y en avoir au moins une centaine en utilisation active). Pensez \u00e0 utiliser le Serveur communautaire Discourse de Klipper pour les autres configurations. Only specify those devices present on the given printer or board. Do not specify settings specific to your particular setup. For generic config files, only those devices on the mainboard should be described. For example, it would not make sense to add a display config section to a \"generic\" config as there is no way to know if the board will be attached to that type of display. If the board has a specific hardware port to facilitate an optional peripheral (eg, a bltouch port) then one can add a \"commented out\" config section for the given device. Ne sp\u00e9cifiez pas pressure_advance dans un exemple de configuration, car cette valeur est sp\u00e9cifique au filament, et non au mat\u00e9riel de l'imprimante. De m\u00eame, ne sp\u00e9cifiez pas les param\u00e8tres max_extrude_only_velocity et max_extrude_only_accel . Ne sp\u00e9cifiez pas une section de configuration contenant un chemin d'acc\u00e8s \u00e0 l'h\u00f4te ou un mat\u00e9riel h\u00f4te. Par exemple, ne sp\u00e9cifiez pas les sections de configuration [virtual_sdcard] et [temperature_host] . Ne d\u00e9finissez que les macros qui utilisent une fonctionnalit\u00e9 sp\u00e9cifique \u00e0 l'imprimante donn\u00e9e ou pour d\u00e9finir les codes g g\u00e9n\u00e9ralement \u00e9mis par les trancheurs configur\u00e9s pour l'imprimante donn\u00e9e. Where possible, it is best to use the same wording, phrasing, indentation, and section ordering as the existing config files. The top of each config file should list the type of micro-controller the user should select during \"make menuconfig\". It should also have a reference to \"docs/Config_Reference.md\". Ne copiez pas la documentation du champ dans les fichiers de configuration d'exemple. (Faire cela cr\u00e9e une charge de maintenance car une mise \u00e0 jour de la documentation n\u00e9cessiterait alors de la modifier \u00e0 de nombreux endroits.) Les exemples de fichiers de configuration ne doivent pas contenir de section \"SAVE_CONFIG\". Si n\u00e9cessaire, copiez les champs pertinents de la section SAVE_CONFIG dans la section appropri\u00e9e de la zone de configuration principale. Utilisez la syntaxe field: value au lieu de field=value . Lorsque vous ajoutez une rotation_distance pour une extrudeuse, il est pr\u00e9f\u00e9rable de sp\u00e9cifier un gear_ratio si l'extrudeuse a un m\u00e9canisme d'engrenage. Nous nous attendons \u00e0 ce que la distance de rotation dans les exemples de configuration corresponde \u00e0 la circonf\u00e9rence de l'engrenage dent\u00e9 dans l'extrudeuse - elle est normalement comprise entre 20 et 35 mm. Lorsque vous sp\u00e9cifiez un gear_ratio , il est pr\u00e9f\u00e9rable de sp\u00e9cifier les engrenages r\u00e9els du m\u00e9canisme (par exemple, pr\u00e9f\u00e9rez gear_ratio : 80:20 \u00e0 gear_ratio : 4:1 ). Voir le document sur la distance de rotation pour plus d'informations. \u00c9vitez de d\u00e9finir des valeurs de champ fix\u00e9es \u00e0 leur valeur par d\u00e9faut. Par exemple, il est inutile de sp\u00e9cifier min_extrude_temp : 170 car c'est d\u00e9j\u00e0 la valeur par d\u00e9faut. Dans la mesure du possible, les lignes ne devraient pas d\u00e9passer 80 colonnes. \u00c9vitez d'ajouter des messages d'attribution ou de r\u00e9vision dans les fichiers de configuration. (Par exemple, \u00e9vitez d'ajouter des lignes telles que \"ce fichier a \u00e9t\u00e9 cr\u00e9\u00e9 par ...\".) Placez l'attribution et l'historique des modifications dans le message git commit. N'utilisez pas de fonctionnalit\u00e9s obsol\u00e8tes dans le fichier de configuration d'exemple. Ne pas d\u00e9sactiver un syst\u00e8me de s\u00e9curit\u00e9 par d\u00e9faut dans un fichier de configuration d'exemple. Par exemple, une configuration ne doit pas sp\u00e9cifier un max_extrude_cross_section personnalis\u00e9. N'activez pas les fonctions de d\u00e9bogage. Par exemple, il ne doit pas y avoir de section de configuration force_move . Toutes les cartes connues que Klipper prend en charge peuvent utiliser la vitesse de transmission s\u00e9rie par d\u00e9faut de 250000. Ne recommandez pas un d\u00e9bit en bauds diff\u00e9rent dans un fichier de configuration d'exemple. Les exemples de fichiers de configuration sont soumis en cr\u00e9ant une \"pull request\" sur github. Veuillez \u00e9galement suivre les instructions du document de contribution .","title":"Lignes directives"},{"location":"Exclude_Object.html","text":"Exclure des objets \u00b6 The [exclude_object] module allows Klipper to exclude objects while a print is in progress. To enable this feature include an exclude_object config section (also see the command reference and sample-macros.cfg file for a Marlin/RepRapFirmware compatible M486 G-Code macro.) Contrairement \u00e0 d'autres options de micrologiciel d'imprimante 3D, une imprimante ex\u00e9cutant Klipper utilise une suite de composants et les utilisateurs ont le choix de nombreuses options. Par cons\u00e9quent, afin de fournir une exp\u00e9rience utilisateur coh\u00e9rente, le module [exclude_object] \u00e9tablira un contrat ou une sorte d'API. Le contrat couvre le contenu du fichier gcode, la fa\u00e7on dont l'\u00e9tat interne du module est contr\u00f4l\u00e9, et la fa\u00e7on dont cet \u00e9tat est fourni aux clients. Aper\u00e7u du flux de travail \u00b6 Le flux de travail typique de l'impression d'un fichier peut ressembler \u00e0 ceci : Le tranchage est termin\u00e9 et le fichier a \u00e9t\u00e9 t\u00e9l\u00e9charg\u00e9 pour \u00eatre imprim\u00e9. Pendant le t\u00e9l\u00e9chargement, le fichier est trait\u00e9 et des marqueurs [exclude_object] sont ajout\u00e9s au fichier. Alternativement, les trancheurs peuvent \u00eatre configur\u00e9s pour pr\u00e9parer les marqueurs d'exclusion d'objets de mani\u00e8re native ou dans leur propre \u00e9tape de pr\u00e9traitement. Lorsque l'impression d\u00e9marre, Klipper r\u00e9initialise l' \u00e9tat de [exclude_object] . Lorsque Klipper traite le bloc EXCLUDE_OBJECT_DEFINE , il met \u00e0 jour l'\u00e9tat avec les objets connus et le transmet aux clients. Le client peut utiliser ces informations pour pr\u00e9senter une interface \u00e0 l'utilisateur afin de suivre la progression. Klipper mettra \u00e0 jour l'\u00e9tat pour inclure l'objet en cours d'impression que le client peut utiliser \u00e0 des fins d'affichage. Si l'utilisateur demande l'annulation d'un objet, le client envoie une commande EXCLUDE_OBJECT NAME=<name> \u00e0 Klipper. Lorsque Klipper traite la commande, il ajoute l'objet \u00e0 la liste des objets exclus et met \u00e0 jour le statut du client. Le client recevra l'\u00e9tat mis \u00e0 jour de Klipper et pourra utiliser cette information pour refl\u00e9ter l'\u00e9tat de l'objet dans l'interface utilisateur. Une fois l'impression termin\u00e9e, l'\u00e9tat [exclude_object] continuera \u00e0 \u00eatre disponible jusqu'\u00e0 ce qu'une autre action le r\u00e9initialise. Le fichier GCode \u00b6 Le traitement particulier du gcode n\u00e9cessaire \u00e0 la prise en charge des objets exclus ne correspond pas aux caract\u00e9ristiques de conception de d\u00e9part de Klipper. Par cons\u00e9quent, ce module exige que le fichier soit trait\u00e9 avant d'\u00eatre envoy\u00e9 \u00e0 Klipper pour l'impression. L'utilisation d'un script de post-traitement dans le trancheur ou le traitement du fichier par un logiciel interm\u00e9diaire lors du t\u00e9l\u00e9chargement sont deux possibilit\u00e9s pour pr\u00e9parer le fichier pour Klipper. Un script de post-traitement de r\u00e9f\u00e9rence est disponible \u00e0 la fois comme ex\u00e9cutable et comme biblioth\u00e8que python, voir cancelobject-preprocessor . D\u00e9finitions des objets \u00b6 La commande EXCLUDE_OBJECT_DEFINE est utilis\u00e9e pour fournir un r\u00e9sum\u00e9 de chaque objet du fichier gcode \u00e0 imprimer. Elle fournit le r\u00e9sum\u00e9 d'un objet dans le fichier. Les objets n'ont pas besoin d'\u00eatre d\u00e9finis pour \u00eatre r\u00e9f\u00e9renc\u00e9s par d'autres commandes. Le but principal de cette commande est de fournir des informations \u00e0 l'interface utilisateur sans avoir \u00e0 analyser le fichier gcode en entier. Les d\u00e9finitions d'objets sont nomm\u00e9es, pour permettre aux utilisateurs de s\u00e9lectionner facilement un objet \u00e0 exclure, et des m\u00e9tadonn\u00e9es suppl\u00e9mentaires peuvent \u00eatre fournies pour permettre des affichages graphiques d'annulation. Les m\u00e9tadonn\u00e9es actuellement d\u00e9finies comprennent une coordonn\u00e9e X,Y CENTER , et une liste POLYGON de points X,Y repr\u00e9sentant un contour minimal de l'objet. Il peut s'agir d'une simple bo\u00eete englobante ou d'une coque complexe permettant de visualiser les objets imprim\u00e9s de mani\u00e8re plus d\u00e9taill\u00e9e. En particulier, lorsque les fichiers gcode comprennent plusieurs parties avec des r\u00e9gions limites qui se chevauchent, les points centraux deviennent difficiles \u00e0 distinguer visuellement. POLYGONS doit \u00eatre un tableau compatible json de points [X,Y] ( tuples) sans espace. Les param\u00e8tres suppl\u00e9mentaires seront enregistr\u00e9s sous forme de cha\u00eenes de caract\u00e8res dans la d\u00e9finition de l'objet et fournis dans les mises \u00e0 jour de l'\u00e9tat. EXCLUDE_OBJECT_DEFINE NAME=calibration_pyramid CENTER=50,50 POLYGON=[[40,40],[50,60],[60,40]] All available G-Code commands are documented in the G-Code Reference Informations sur le statut \u00b6 The state of this module is provided to clients by the exclude_object status . L'\u00e9tat est r\u00e9initialis\u00e9 lorsque : Le microprogramme Klipper est red\u00e9marr\u00e9. Il y a une r\u00e9initialisation de la [virtual_sdcard] . Notamment, ceci est remis \u00e0 z\u00e9ro par Klipper au d\u00e9but d'une impression. Lorsqu'une commande EXCLUDE_OBJECT_DEFINE RESET=1 est \u00e9mise. La liste des objets d\u00e9finis est repr\u00e9sent\u00e9e dans le champ d'\u00e9tat exclude_object.objects . Dans un fichier gcode bien d\u00e9fini, cela sera fait avec les commandes EXCLUDE_OBJECT_DEFINE au d\u00e9but du fichier. Cela fournira aux clients les noms et les coordonn\u00e9es des objets afin que l'interface utilisateur puisse fournir une repr\u00e9sentation graphique des objets si n\u00e9cessaire. Au fur et \u00e0 mesure de l'impression, le champ d'\u00e9tat exclude_object.current_object sera mis \u00e0 jour lorsque Klipper traitera les commandes EXCLUDE_OBJECT_START et EXCLUDE_OBJECT_END . Le champ current_object sera activ\u00e9 m\u00eame si l'objet a \u00e9t\u00e9 exclu. Les objets non d\u00e9finis marqu\u00e9s d'un EXCLUDE_OBJECT_START seront ajout\u00e9s aux objets connus pour aider \u00e0 la mise en place de l'interface utilisateur, sans m\u00e9tadonn\u00e9es suppl\u00e9mentaires. Lorsque les commandes EXCLUDE_OBJECT sont \u00e9mises, la liste des objets exclus est fournie dans le tableau exclude_object.excluded_objects . Comme Klipper anticipe le traitement du gcode \u00e0 venir, il peut y avoir un d\u00e9lai entre le moment o\u00f9 la commande est \u00e9mise et celui o\u00f9 le statut est mis \u00e0 jour.","title":"Exclure des objets"},{"location":"Exclude_Object.html#exclure-des-objets","text":"The [exclude_object] module allows Klipper to exclude objects while a print is in progress. To enable this feature include an exclude_object config section (also see the command reference and sample-macros.cfg file for a Marlin/RepRapFirmware compatible M486 G-Code macro.) Contrairement \u00e0 d'autres options de micrologiciel d'imprimante 3D, une imprimante ex\u00e9cutant Klipper utilise une suite de composants et les utilisateurs ont le choix de nombreuses options. Par cons\u00e9quent, afin de fournir une exp\u00e9rience utilisateur coh\u00e9rente, le module [exclude_object] \u00e9tablira un contrat ou une sorte d'API. Le contrat couvre le contenu du fichier gcode, la fa\u00e7on dont l'\u00e9tat interne du module est contr\u00f4l\u00e9, et la fa\u00e7on dont cet \u00e9tat est fourni aux clients.","title":"Exclure des objets"},{"location":"Exclude_Object.html#apercu-du-flux-de-travail","text":"Le flux de travail typique de l'impression d'un fichier peut ressembler \u00e0 ceci : Le tranchage est termin\u00e9 et le fichier a \u00e9t\u00e9 t\u00e9l\u00e9charg\u00e9 pour \u00eatre imprim\u00e9. Pendant le t\u00e9l\u00e9chargement, le fichier est trait\u00e9 et des marqueurs [exclude_object] sont ajout\u00e9s au fichier. Alternativement, les trancheurs peuvent \u00eatre configur\u00e9s pour pr\u00e9parer les marqueurs d'exclusion d'objets de mani\u00e8re native ou dans leur propre \u00e9tape de pr\u00e9traitement. Lorsque l'impression d\u00e9marre, Klipper r\u00e9initialise l' \u00e9tat de [exclude_object] . Lorsque Klipper traite le bloc EXCLUDE_OBJECT_DEFINE , il met \u00e0 jour l'\u00e9tat avec les objets connus et le transmet aux clients. Le client peut utiliser ces informations pour pr\u00e9senter une interface \u00e0 l'utilisateur afin de suivre la progression. Klipper mettra \u00e0 jour l'\u00e9tat pour inclure l'objet en cours d'impression que le client peut utiliser \u00e0 des fins d'affichage. Si l'utilisateur demande l'annulation d'un objet, le client envoie une commande EXCLUDE_OBJECT NAME=<name> \u00e0 Klipper. Lorsque Klipper traite la commande, il ajoute l'objet \u00e0 la liste des objets exclus et met \u00e0 jour le statut du client. Le client recevra l'\u00e9tat mis \u00e0 jour de Klipper et pourra utiliser cette information pour refl\u00e9ter l'\u00e9tat de l'objet dans l'interface utilisateur. Une fois l'impression termin\u00e9e, l'\u00e9tat [exclude_object] continuera \u00e0 \u00eatre disponible jusqu'\u00e0 ce qu'une autre action le r\u00e9initialise.","title":"Aper\u00e7u du flux de travail"},{"location":"Exclude_Object.html#le-fichier-gcode","text":"Le traitement particulier du gcode n\u00e9cessaire \u00e0 la prise en charge des objets exclus ne correspond pas aux caract\u00e9ristiques de conception de d\u00e9part de Klipper. Par cons\u00e9quent, ce module exige que le fichier soit trait\u00e9 avant d'\u00eatre envoy\u00e9 \u00e0 Klipper pour l'impression. L'utilisation d'un script de post-traitement dans le trancheur ou le traitement du fichier par un logiciel interm\u00e9diaire lors du t\u00e9l\u00e9chargement sont deux possibilit\u00e9s pour pr\u00e9parer le fichier pour Klipper. Un script de post-traitement de r\u00e9f\u00e9rence est disponible \u00e0 la fois comme ex\u00e9cutable et comme biblioth\u00e8que python, voir cancelobject-preprocessor .","title":"Le fichier GCode"},{"location":"Exclude_Object.html#definitions-des-objets","text":"La commande EXCLUDE_OBJECT_DEFINE est utilis\u00e9e pour fournir un r\u00e9sum\u00e9 de chaque objet du fichier gcode \u00e0 imprimer. Elle fournit le r\u00e9sum\u00e9 d'un objet dans le fichier. Les objets n'ont pas besoin d'\u00eatre d\u00e9finis pour \u00eatre r\u00e9f\u00e9renc\u00e9s par d'autres commandes. Le but principal de cette commande est de fournir des informations \u00e0 l'interface utilisateur sans avoir \u00e0 analyser le fichier gcode en entier. Les d\u00e9finitions d'objets sont nomm\u00e9es, pour permettre aux utilisateurs de s\u00e9lectionner facilement un objet \u00e0 exclure, et des m\u00e9tadonn\u00e9es suppl\u00e9mentaires peuvent \u00eatre fournies pour permettre des affichages graphiques d'annulation. Les m\u00e9tadonn\u00e9es actuellement d\u00e9finies comprennent une coordonn\u00e9e X,Y CENTER , et une liste POLYGON de points X,Y repr\u00e9sentant un contour minimal de l'objet. Il peut s'agir d'une simple bo\u00eete englobante ou d'une coque complexe permettant de visualiser les objets imprim\u00e9s de mani\u00e8re plus d\u00e9taill\u00e9e. En particulier, lorsque les fichiers gcode comprennent plusieurs parties avec des r\u00e9gions limites qui se chevauchent, les points centraux deviennent difficiles \u00e0 distinguer visuellement. POLYGONS doit \u00eatre un tableau compatible json de points [X,Y] ( tuples) sans espace. Les param\u00e8tres suppl\u00e9mentaires seront enregistr\u00e9s sous forme de cha\u00eenes de caract\u00e8res dans la d\u00e9finition de l'objet et fournis dans les mises \u00e0 jour de l'\u00e9tat. EXCLUDE_OBJECT_DEFINE NAME=calibration_pyramid CENTER=50,50 POLYGON=[[40,40],[50,60],[60,40]] All available G-Code commands are documented in the G-Code Reference","title":"D\u00e9finitions des objets"},{"location":"Exclude_Object.html#informations-sur-le-statut","text":"The state of this module is provided to clients by the exclude_object status . L'\u00e9tat est r\u00e9initialis\u00e9 lorsque : Le microprogramme Klipper est red\u00e9marr\u00e9. Il y a une r\u00e9initialisation de la [virtual_sdcard] . Notamment, ceci est remis \u00e0 z\u00e9ro par Klipper au d\u00e9but d'une impression. Lorsqu'une commande EXCLUDE_OBJECT_DEFINE RESET=1 est \u00e9mise. La liste des objets d\u00e9finis est repr\u00e9sent\u00e9e dans le champ d'\u00e9tat exclude_object.objects . Dans un fichier gcode bien d\u00e9fini, cela sera fait avec les commandes EXCLUDE_OBJECT_DEFINE au d\u00e9but du fichier. Cela fournira aux clients les noms et les coordonn\u00e9es des objets afin que l'interface utilisateur puisse fournir une repr\u00e9sentation graphique des objets si n\u00e9cessaire. Au fur et \u00e0 mesure de l'impression, le champ d'\u00e9tat exclude_object.current_object sera mis \u00e0 jour lorsque Klipper traitera les commandes EXCLUDE_OBJECT_START et EXCLUDE_OBJECT_END . Le champ current_object sera activ\u00e9 m\u00eame si l'objet a \u00e9t\u00e9 exclu. Les objets non d\u00e9finis marqu\u00e9s d'un EXCLUDE_OBJECT_START seront ajout\u00e9s aux objets connus pour aider \u00e0 la mise en place de l'interface utilisateur, sans m\u00e9tadonn\u00e9es suppl\u00e9mentaires. Lorsque les commandes EXCLUDE_OBJECT sont \u00e9mises, la liste des objets exclus est fournie dans le tableau exclude_object.excluded_objects . Comme Klipper anticipe le traitement du gcode \u00e0 venir, il peut y avoir un d\u00e9lai entre le moment o\u00f9 la commande est \u00e9mise et celui o\u00f9 le statut est mis \u00e0 jour.","title":"Informations sur le statut"},{"location":"FAQ.html","text":"Foire Aux Questions \u00b6 Comment puis-je faire un don au projet ? \u00b6 Merci de votre soutien. Voir la page Sponsors pour plus d'informations. Comment calculer le param\u00e8tre de configuration rotation_distance ? \u00b6 Voir le document sur la distance de rotation . O\u00f9 est mon port s\u00e9rie ? \u00b6 De mani\u00e8re g\u00e9n\u00e9rale, on ex\u00e9cute la commande ls /dev/serial/by-id/* \u00e0 partir d'un terminal ssh sur la machine h\u00f4te pour trouver un port s\u00e9rie USB. Cette commande produira s\u00fbrement un r\u00e9sultat similaire \u00e0 celui-ci : /dev/serial/by-id/usb-1a86_USB2.0-Serial-if00-port0 Le nom retourn\u00e9 par la commande ci-dessus est constant, il est donc possible de l'utiliser dans le fichier de configuration et lors du flashage du microcontr\u00f4leur. Par exemple, une commande de flash peur ressembler \u00e0 : sudo service klipper stop make flash FLASH_DEVICE=/dev/serial/by-id/usb-1a86_USB2.0-Serial-if00-port0 sudo service klipper start et la configuration mise \u00e0 jour devrait ressembler \u00e0 : [mcu] serial: /dev/serial/by-id/usb-1a86_USB2.0-Serial-if00-port0 Veillez \u00e0 copier-coller le nom retourn\u00e9 par la commande \"ls\" que vous avez ex\u00e9cut\u00e9e ci-avant, car le nom sera diff\u00e9rent pour chaque imprimante. Si vous utilisez plusieurs microcontr\u00f4leurs et qu'ils n'ont pas d'identifiant unique (fr\u00e9quent avec les cartes utilisant une puce USB CH340), suivez les instructions ci-dessus en utilisant la commande ls /dev/serial/by-path/* \u00e0 la place. Lorsque le microcontr\u00f4leur red\u00e9marre, le p\u00e9riph\u00e9rique passe \u00e0 /dev/ttyUSB1 \u00b6 Suivez les instructions de la section \" O\u00f9 est mon port s\u00e9rie ? \" pour \u00e9viter que cela ne se produise. La commande \"make flash\" ne fonctionne pas \u00b6 Le code tente de flasher le dispositif en utilisant la m\u00e9thode la plus courante pour chaque plateforme. Malheureusement, il y a beaucoup de variations dans les m\u00e9thodes de flashage, donc la commande \"make flash\" peut ne pas fonctionner avec toutes les cartes. Si vous rencontrez une erreur intermittente ou si votre configuration est standard, v\u00e9rifiez que Klipper est arr\u00eat\u00e9 pendant le flashage (sudo service klipper stop), assurez-vous qu'OctoPrint n'essaye pas de se connecter directement \u00e0 l'appareil (ouvrez l'onglet Connexion de la page web et cliquez sur D\u00e9connecter si le port s\u00e9rie de la carte est s\u00e9lectionn\u00e9), et assurez-vous que FLASH_DEVICE est correctement d\u00e9fini pour votre carte (voir la question ci-dessus ). Toutefois si \"make flash\" ne fonctionne pas pour votre carte, vous devrez flasher manuellement. V\u00e9rifiez s'il existe un fichier de configuration dans le r\u00e9pertoire config avec des instructions sp\u00e9cifiques pour flasher la carte. V\u00e9rifiez \u00e9galement la documentation du fabricant de la carte pour voir si elle d\u00e9crit comment la flasher. Enfin, il peut \u00eatre possible de flasher manuellement la carte en utilisant des outils tels que \"avrdude\" ou \"bossac\" - voir le document sur les booloaders pour plus d'informations. Comment changer la vitesse de communication(baud rate) du port s\u00e9rie ? \u00b6 Le baud rate (taux bit/s) recommand\u00e9 pour Klipper est de 250000. Ce baud rate fonctionne bien sur toutes les cartes microcontr\u00f4leurs que Klipper prend en charge. Si vous avez trouv\u00e9 un guide en ligne recommandant un baud rate diff\u00e9rent, ignorez cette partie du guide et continuez avec la valeur par d\u00e9faut de 250000. Si vous voulez quand m\u00eame changer le baud rate, le nouveau taux devra \u00eatre configur\u00e9e dans le microcontr\u00f4leur (pendant make menuconfig ) et ce code mis \u00e0 jour devra \u00eatre compil\u00e9 et flash\u00e9 dans le microcontr\u00f4leur. Le fichier printer.cfg de Klipper devra \u00e9galement \u00eatre mis \u00e0 jour pour correspondre \u00e0 ce baud rate (voir le document de r\u00e9f\u00e9rence des configurations pour plus de d\u00e9tails). Par exemple : [mcu] baud: 250000 Le baud rate (taux bit/s) indiqu\u00e9 sur la page Web d'OctoPrint n'a aucun impact sur la vitesse de transmission du microcontr\u00f4leur interne de Klipper. R\u00e9glez toujours le taux de bit/s d'OctoPrint sur 250000 lorsque vous utilisez Klipper. Le baud rate utilis\u00e9 avec Klipper n'est pas li\u00e9e au baud rate du bootloader du microcontr\u00f4leur. Voir le document sur les bootloaders pour plus d'informations sur les bootloaders. Puis-je faire fonctionner Klipper sur autre chose qu'un Raspberry Pi 3 ? \u00b6 Le mat\u00e9riel recommand\u00e9 est un Raspberry Pi 2, Raspberry Pi 3 ou Raspberry Pi 4. Klipper fonctionne sur un Raspberry Pi 1 et sur le Raspberry Pi Zero, mais ces cartes n'ont pas assez de puissance de traitement pour faire fonctionner OctoPrint correctement. Il est fr\u00e9quent que l'impression se fasse par \u00e0-coup avec ces machines plus lentes lorsqu'on imprime directement depuis OctoPrint. (L'imprimante peut chercher \u00e0 imprimer plus rapidement que la vitesse \u00e0 laquelle OctoPrint peut envoyer les commandes de mouvement.) Si vous souhaitez quand m\u00eame utiliser une de ces cartes plus lentes, pensez \u00e0 utiliser la fonctionnalit\u00e9 \"virtual_sdcard\" lors de l'impression (voir le document de r\u00e9f\u00e9rence des configurations pour plus de d\u00e9tails). Pour l'ex\u00e9cution sur le Beaglebone, voir les instructions d'installation sp\u00e9cifiques au Beaglebone . Klipper a \u00e9t\u00e9 ex\u00e9cut\u00e9 sur d'autres machines. Le logiciel h\u00f4te de Klipper ne n\u00e9cessite que l'ex\u00e9cution de Python sur un ordinateur Linux (ou similaire). Cependant, si vous souhaitez l'ex\u00e9cuter sur une autre machine, vous aurez besoin de connaissances d'administrateur Linux pour installer les pr\u00e9requis du syst\u00e8me pour cette machine particuli\u00e8re. Consultez le script install-octopi.sh pour plus d'informations sur les \u00e9tapes n\u00e9cessaires \u00e0 l'administration de Linux. Si vous souhaitez ex\u00e9cuter le logiciel h\u00f4te Klipper sur une puce bas de gamme, sachez qu'il faut au minimum une machine dot\u00e9e d'un mat\u00e9riel \u00e0 \"double pr\u00e9cision en virgule flottante\". Si vous souhaitez ex\u00e9cuter le logiciel h\u00f4te Klipper sur un ordinateur de bureau ou un serveur polyvalent partag\u00e9, notez que Klipper a des exigences en mati\u00e8re de programmation en temps r\u00e9el. Si, au cours d'une impression, l'ordinateur h\u00f4te ex\u00e9cute \u00e9galement une t\u00e2che informatique intensive (comme la d\u00e9fragmentation d'un disque dur, un rendu 3D, une forte utilisation du fichier d'\u00e9change, etc.), Klipper pourrait signaler des erreurs d'impression. Note : Si vous n'utilisez pas une image OctoPi, sachez que de nombreuses distributions Linux activent un paquet \"ModemManager\" (ou similaire) pouvant perturber la communication s\u00e9rie. (Ce qui peut amener Klipper \u00e0 rapporter des erreurs apparemment al\u00e9atoires \"Lost communication with MCU\"). Si vous installez Klipper sur une de ces distributions, vous devrez peut-\u00eatre d\u00e9sactiver ce paquet. Puis-je ex\u00e9cuter plusieurs instances de Klipper sur la m\u00eame machine h\u00f4te ? \u00b6 Il est possible d'ex\u00e9cuter plusieurs instances du logiciel h\u00f4te Klipper, mais cela n\u00e9cessite des connaissances en administration Linux. Les scripts d'installation de Klipper entra\u00eenent finalement l'ex\u00e9cution de la commande Unix suivante : ~/klippy-env/bin/python ~/klipper/klippy/klippy.py ~/printer.cfg -l /tmp/klippy.log On peut ex\u00e9cuter plusieurs instances de la commande ci-dessus \u00e0 condition que chaque instance ait son propre fichier de configuration d'imprimante, son propre fichier journal et son propre pseudo-tty. Par exemple : ~/klippy-env/bin/python ~/klipper/klippy/klippy.py ~/printer2.cfg -l /tmp/klippy2.log -I /tmp/printer2 Si vous choisissez de le faire, vous devrez impl\u00e9menter les scripts de d\u00e9marrage, d'arr\u00eat et d'installation n\u00e9cessaires (le cas \u00e9ch\u00e9ant). Le script install-octopi.sh et le script klipper-start.sh peuvent \u00eatre utiles comme exemples. Suis-je oblig\u00e9 d'utiliser Octoprint ? \u00b6 Le logiciel Klipper n'est pas d\u00e9pendant d'OctoPrint. Il est possible d'utiliser un autre logiciel pour envoyer des commandes \u00e0 Klipper, mais cela n\u00e9cessite des connaissances en administration Linux. Klipper cr\u00e9e un \"port s\u00e9rie virtuel\" via le fichier \"/tmp/printer\" qui \u00e9mule une interface s\u00e9rie classique d'imprimante 3d via ce fichier. En g\u00e9n\u00e9ral, les logiciels alternatifs peuvent fonctionner avec Klipper tant qu'ils peuvent \u00eatre configur\u00e9s pour utiliser \"/tmp/printer\" pour le port s\u00e9rie de l'imprimante. Pourquoi ne puis-je pas lancer un d\u00e9placement avant de prendre l'origine ? \u00b6 Le code fait cela pour r\u00e9duire le risque de d\u00e9placer accidentellement la t\u00eate dans le lit ou dans un mur. Une fois que la prise d'origine est effectu\u00e9e, le logiciel v\u00e9rifie que chaque mouvement se situe dans les limites de position_min/max d\u00e9finies dans le fichier de configuration. Si les moteurs sont d\u00e9sactiv\u00e9s (via une commande M84 ou M18), les moteurs devront reprendre l'origine avant tout mouvement. Si vous souhaitez d\u00e9placer la t\u00eate apr\u00e8s avoir annul\u00e9 une impression via OctoPrint, pensez \u00e0 modifier la s\u00e9quence d'annulation d'OctoPrint pour qu'elle le fasse pour vous. Depuis un navigateur web, elle est configur\u00e9e dans OctoPrint sous : Param\u00e8tres->Scripts GCODE Si vous souhaitez d\u00e9placer la t\u00eate apr\u00e8s la fin d'une impression, pensez \u00e0 ajouter le mouvement souhait\u00e9 \u00e0 la section \"G-Code personnalis\u00e9\" de votre slicer. Si l'imprimante n\u00e9cessite un mouvement suppl\u00e9mentaire dans le cadre du processus de mise \u00e0 l'origine (ou si elle n'a pas de processus de mise \u00e0 l'origine), envisagez d'utiliser une section safe_z_home ou homing_override dans le fichier de configuration. Si vous devez d\u00e9placer un moteur \u00e0 des fins de diagnostic ou de d\u00e9bogage, pensez \u00e0 ajouter une section force_move dans le fichier de configuration. Voir r\u00e9f\u00e9rence de configuration pour plus de d\u00e9tails sur ces options. Pourquoi le param\u00e8tre position_endstop de l'axe Z est-il d\u00e9fini \u00e0 0.5 dans les configurations par d\u00e9faut ? \u00b6 Pour les imprimantes de style cart\u00e9sien, la position Z_endstop indique la distance entre la buse et le lit au moment du d\u00e9clenchement de la fin de course. Si possible, il est recommand\u00e9 d'utiliser une but\u00e9e de fin de course Z-max et de s'\u00e9loigner du lit (car cela r\u00e9duit le risque de collision avec le lit). Cependant, si l'on doit se rapprocher du lit, il est recommand\u00e9 de positionner la but\u00e9e de mani\u00e8re \u00e0 ce qu'elle se d\u00e9clenche lorsque la buse est encore \u00e0 une petite distance du lit. De cette fa\u00e7on, lorsque l'axe se dirige vers le lit, il s'arr\u00eate avant que la buse ne touche le lit. Voir le document niveau du lit pour plus d'informations. J'ai converti ma configuration depuis Marlin et les axes X/Y fonctionnent bien, mais j'obtiens un bruit strident lors de l'orientation de l'axe Z \u00b6 R\u00e9ponse courte : Tout d'abord, assurez-vous d'avoir v\u00e9rifi\u00e9 la configuration du moteur comme d\u00e9crit dans le document de v\u00e9rification de la configuration . Si le probl\u00e8me persiste, essayez de r\u00e9duire le param\u00e8tre max_z_velocity dans la configuration de l'imprimante. R\u00e9ponse longue : En pratique, Marlin ne peut se d\u00e9placer qu'\u00e0 une vitesse d'environ 10000 pas par seconde. Si on lui demande de se d\u00e9placer \u00e0 une vitesse n\u00e9cessitant un taux de pas plus \u00e9lev\u00e9, Marlin se contentera g\u00e9n\u00e9ralement de faire des pas aussi rapides qu'il le peut. Klipper est capable d'atteindre des taux de pas beaucoup plus \u00e9lev\u00e9s, mais le moteur pas \u00e0 pas peut ne pas avoir de couple suffisant pour se d\u00e9placer \u00e0 une vitesse plus \u00e9lev\u00e9e. Ainsi, pour un axe Z avec un rapport d'engrenage \u00e9lev\u00e9 ou un r\u00e9glage de micropas \u00e9lev\u00e9, la vitesse max_z_obtenue peut \u00eatre inf\u00e9rieure \u00e0 ce qui est configur\u00e9 dans Marlin. Mes pilotes de moteur TMC s'arr\u00eatent en plein milieu d'une impression \u00b6 Si vous utilisez le pilote TMC2208 (ou TMC2224) en \"mode autonome\", assurez-vous d'utiliser la derni\u00e8re version de Klipper . Une solution de contournement pour un probl\u00e8me avec les pilotes TMC2208 \"stealthchop\" a \u00e9t\u00e9 ajout\u00e9e \u00e0 Klipper \u00e0 la mi-mars 2020. J'ai des erreurs al\u00e9atoires \"Lost communication with MCU\" (communication perdue avec le microcontr\u00f4leur) \u00b6 Ce probl\u00e8me est g\u00e9n\u00e9ralement caus\u00e9 par des erreurs mat\u00e9rielles sur la connexion USB entre la machine h\u00f4te et le microcontr\u00f4leur. Les choses \u00e0 rechercher : Utilisez un c\u00e2ble USB de qualit\u00e9 entre la machine h\u00f4te et le microcontr\u00f4leur. Assurez-vous que les fiches sont bien fix\u00e9es. Si vous utilisez un Raspberry Pi, utilisez une alimentation de bonne qualit\u00e9 pour le Raspberry Pi et utilisez un c\u00e2ble USB de bonne qualit\u00e9 pour connecter cette alimentation au Pi. Si OctoPrint vous avertit que vous \u00eates sous tension, cela est li\u00e9 \u00e0 l'alimentation \u00e9lectrique et doit \u00eatre r\u00e9par\u00e9. Assurez-vous que l'alimentation \u00e9lectrique de l'imprimante n'est pas surcharg\u00e9e. (Les fluctuations d'alimentation de la puce USB du microcontr\u00f4leur peuvent entra\u00eener une r\u00e9initialisation de cette puce.) V\u00e9rifiez que les fils de l'imprimante (pastille, \u00e9l\u00e9ment chauffant et autres) sont bien sertis et pas effiloch\u00e9s. (Le mouvement de l'imprimante peut exercer une contrainte sur un c\u00e2blage d\u00e9fectueux entra\u00eenant une perte de contact, un court-circuit bref ou la production d'un bruit excessif.) Des signalements ont fait \u00e9tat d'un bruit USB \u00e9lev\u00e9 lorsque l'alimentation de l'imprimante et l'alimentation 5V de l'h\u00f4te sont m\u00e9lang\u00e9es. (Si vous constatez que le microcontr\u00f4leur s'allume lorsque l'alimentation de l'imprimante est sous tension ou que le c\u00e2ble USB est branch\u00e9, cela indique que les alimentations 5V sont m\u00e9lang\u00e9es). Il peut \u00eatre utile de configurer le micro-contr\u00f4leur pour qu'il utilise l'alimentation d'une seule source. (Alternativement, si la carte du micro-contr\u00f4leur ne peut pas configurer sa source d'alimentation, on peut modifier un c\u00e2ble USB pour qu'il ne transporte pas de tension de 5V entre l'h\u00f4te et le micro-contr\u00f4leur.) Mon Raspberry Pi red\u00e9marre pendant les impressions \u00b6 Cela est tr\u00e8s probablement d\u00fb \u00e0 des fluctuations de tension. Suivez les m\u00eames \u00e9tapes de d\u00e9pannage que pour une erreur \u00ab Communication perdue avec le MCU \u00bb . Lorsque j'ai d\u00e9fini restart_method=command , mon appareil AVR se bloque lors d'un red\u00e9marrage \u00b6 Certaines anciennes versions du bootloader AVR ont un bogue connu dans la gestion des \u00e9v\u00e9nements de chien de garde. Cela se manifeste typiquement lorsque le param\u00e8tre restart_method est d\u00e9fini sur \"command\" dans le fichier printer.cfg. Lorsque le bogue se produit, le dispositif AVR ne r\u00e9pond pas jusqu'\u00e0 ce que l'alimentation de la carte soit coup\u00e9e puis remise (les DEL d'alimentation ou d'\u00e9tat peuvent \u00e9galement clignoter de mani\u00e8re r\u00e9p\u00e9t\u00e9e jusqu'\u00e0 ce que l'alimentation soit retir\u00e9e). La solution est d'utiliser un restart_method autre que \"command\" ou de flasher un bootloader r\u00e9cent sur le dispositif AVR. Le flashage d'un nouveau bootloader est une \u00e9tape particuli\u00e8re qui n\u00e9cessite g\u00e9n\u00e9ralement un programmateur externe - voir Bootloaders pour plus de d\u00e9tails. Est-ce que les \u00e9l\u00e9ments chauffants restent allum\u00e9s si le Raspberry Pi plante ? \u00b6 Le logiciel a \u00e9t\u00e9 con\u00e7u pour \u00e9viter cela. Une fois que l'h\u00f4te a activ\u00e9 un \u00e9l\u00e9ment chauffant, le logiciel h\u00f4te doit confirmer cette activation toutes les 5 secondes. Si le microcontr\u00f4leur ne re\u00e7oit pas de confirmation toutes les 5 secondes, il passe dans un status \"arr\u00eat\u00e9\" con\u00e7u pour \u00e9teindre tous les \u00e9l\u00e9ments chauffants et les moteurs pas \u00e0 pas. Voir la commande \"config_digital_out\" dans le documentation des commandes MCU pour plus de d\u00e9tails. En outre, le logiciel du microcontr\u00f4leur est configur\u00e9 avec une plage de temp\u00e9rature minimale et maximale pour chaque \u00e9l\u00e9ment chauffant au d\u00e9marrage (voir les param\u00e8tres min_temp et max_temp dans le document de r\u00e9f\u00e9rences des configurations pour plus de d\u00e9tails). Si le microcontr\u00f4leur d\u00e9tecte que la temp\u00e9rature est en dehors de cette plage, il passe \u00e9galement au status \"arr\u00eat\u00e9\". S\u00e9par\u00e9ment, le logiciel h\u00f4te impl\u00e9mente \u00e9galement un code pour v\u00e9rifier que les \u00e9l\u00e9ments chauffants et les capteurs de temp\u00e9rature fonctionnent correctement. Voir le document de r\u00e9f\u00e9rence des configurations pour plus de d\u00e9tails. Comment puis-je convertir les noms de broches de Marlin \u00e0 Klipper ? \u00b6 R\u00e9ponse courte : un mappage est disponible dans le fichier sample-aliases.cfg . Utilisez ce fichier comme guide pour trouver les noms des broches du microcontr\u00f4leur. (Il est \u00e9galement possible de copier la section de configuration board_pins correspondante dans votre fichier de configuration et d'utiliser les alias dans votre configuration, mais il est pr\u00e9f\u00e9rable de traduire et d'utiliser les noms r\u00e9els des broches du microcontr\u00f4leur). Notez que le fichier sample-aliases.cfg utilise des noms de broches qui commencent par le pr\u00e9fixe \"ar\" au lieu de \"D\" (par exemple, la broche Arduino D23 est l'alias Klipper ar23 ) et le pr\u00e9fixe \"analog\" au lieu de \"A\" (par exemple, la broche Arduino A14 est l'alias Klipper analog14 ). R\u00e9ponse longue : Klipper utilise les noms de broches standard d\u00e9finis par le microcontr\u00f4leur. Sur les puces Atmega, ces broches mat\u00e9rielles ont des noms tels que PA4 , PC7 , ou PD2 . Il y a longtemps, le projet Arduino a d\u00e9cid\u00e9 d'\u00e9viter d'utiliser les noms standards du mat\u00e9riel en faveur de leurs propres noms de broches bas\u00e9s sur des nombres incr\u00e9ment\u00e9s - ces noms Arduino ressemblent g\u00e9n\u00e9ralement \u00e0 D23 ou A14 . Il s'agit d'un choix malheureux qui peut pr\u00eater \u00e0 confusion. En particulier parce que les num\u00e9ros de broches Arduino ne correspondent pas syst\u00e9matiquement aux m\u00eames noms mat\u00e9riels. Par exemple, D21 correspond \u00e0 PD0 sur certaines cartes Arduino et \u00e0 PC7 sur d'autres. Pour \u00e9viter cette confusion, le code source de Klipper utilise les noms de broches standard d\u00e9finis par le microcontr\u00f4leur. Dois-je connecter mon appareil \u00e0 un type sp\u00e9cifique de broche de microcontr\u00f4leur ? \u00b6 Cela d\u00e9pend du type d'appareil et du type de broche : Broches ADC (ou broches analogiques) : pour les thermistances et autres capteurs \"analogiques\", l'\u00e9l\u00e9ment doit \u00eatre c\u00e2bl\u00e9 \u00e0 une broche \"analogique\" ou \"ADC\" du microcontr\u00f4leur. Si vous configurez Klipper pour utiliser une broche qui n'est pas capable de fonctionner en analogique, Klipper signalera une erreur \"Not a valid ADC pin\". Broches PWM (ou broches de timer) : Klipper n'utilise pas de PWM mat\u00e9riel par d\u00e9faut pour aucun \u00e9l\u00e9ment. Donc on peut c\u00e2bler des \u00e9l\u00e9ments chauffants, des ventilateurs et des dispositifs similaires \u00e0 n'importe quelle broche d'E/S d'usage g\u00e9n\u00e9ral. Cependant, les ventilateurs et les \u00e9l\u00e9ments param\u00e9tr\u00e9s en output_pin peuvent \u00eatre \u00e9ventuellement configur\u00e9s pour utiliser hardware_pwm : True , auquel cas le micro-contr\u00f4leur doit supporter le PWM mat\u00e9riel sur la broche (sinon, Klipper signalera une erreur \"Not a valid PWM pin\"). Broches IRQ (ou broches d'interruption) : Klipper n'utilise pas d'interruptions mat\u00e9rielles sur les broches d'E/S, il n'est donc jamais n\u00e9cessaire de connecter un p\u00e9riph\u00e9rique \u00e0 l'une de ces broches du microcontr\u00f4leur. Broches SPI : Lors de l'utilisation du SPI mat\u00e9riel, il est n\u00e9cessaire de connecter l\u2019\u00e9l\u00e9ment aux broches SPI du micro-contr\u00f4leur. Toutefois, la plupart des \u00e9l\u00e9ments peuvent \u00eatre configur\u00e9s pour utiliser le \"SPI logiciel\", auquel cas n'importe quelle broche d'E/S d'usage g\u00e9n\u00e9ral peut \u00eatre utilis\u00e9e. Broches I2C : lors de l'utilisation d'I2C, il est n\u00e9cessaire de c\u00e2bler les broches aux broches compatibles I2C du microcontr\u00f4leur. D\u2019autres \u00e9l\u00e9ments peuvent \u00eatre c\u00e2bl\u00e9s \u00e0 n\u2019importe quelle broche d\u2019E/S \u00e0 usage g\u00e9n\u00e9ral. Par exemple, les steppers, les \u00e9l\u00e9ments chauffants, les ventilateurs, les sondes Z, les servos, les LED, les \u00e9crans LCD hd44780 /st7920 courants, le c\u00e2ble de communication UART des pilotes Trinamic peut \u00eatre raccord\u00e9 \u00e0 n\u2019importe quelle broche d'E/S. Comment annuler une commande M109/M190 \u00ab attendre la temp\u00e9rature \u00bb ? \u00b6 Allez dans l'onglet terminal d'OctoPrint et envoyez une commande M112 dans la console. La commande M112 fera entrer Klipper dans un \u00e9tat \"d'arr\u00eat\" et d\u00e9connectera OctoPrint de Klipper. Dans le bloc de connexion d'OctoPrint, cliquez sur \"Connecter\" pour que OctoPrint se reconnecte. Revenez \u00e0 l'onglet du terminal et lancez une commande FIRMWARE_RESTART pour effacer le status en erreur de Klipper. Apr\u00e8s avoir effectu\u00e9 cette s\u00e9quence, la demande de chauffage pr\u00e9c\u00e9dente sera annul\u00e9e et une nouvelle impression pourra \u00eatre lanc\u00e9e. Comment savoir si l'imprimante a perdu des pas ? \u00b6 D'une certaine mani\u00e8re, oui. Effectuez la prise d'origine (homing), lancez la commande GET_POSITION , d\u00e9marrez votre impression, refaite la prise d'origine et lancez \u00e0 nouveau la commande GET_POSITION . Comparez ensuite les valeurs de la ligne mcu : . Cela peut \u00eatre utile pour r\u00e9gler des param\u00e8tres tels que les courants, les acc\u00e9l\u00e9rations et les vitesses des moteurs pas \u00e0 pas sans avoir besoin d'imprimer quelque chose et de gaspiller du filament : il suffit d'ex\u00e9cuter quelques mouvements \u00e0 grande vitesse entre des commandes GET_POSITION . Notez que les interrupteurs de fin de course eux-m\u00eames ont tendance \u00e0 se d\u00e9clencher \u00e0 des positions l\u00e9g\u00e8rement diff\u00e9rentes, de sorte qu'une diff\u00e9rence de quelques micro-pas est probablement caus\u00e9 par l'impr\u00e9cision de la fin de course. Un moteur pas \u00e0 pas ne peut perdre des pas que par incr\u00e9ments de 4 pas complets. (Ainsi, si l'on utilise 16 micropas, un pas r\u00e9ellement perdu par le moteur se traduirait par une diff\u00e9rence multiple de 64 micropas avec le compteur de pas \"mcu :\") Pourquoi Klipper signale-t-il des erreurs ? J\u2019ai rat\u00e9 mon impression ! \u00b6 R\u00e9ponse courte : Nous voulons savoir si nos imprimantes rencontre un probl\u00e8me afin qu'il puisse \u00eatre r\u00e9solu et que nous puissions obtenir des impressions de grande qualit\u00e9. Nous ne voulons surtout pas que nos imprimantes produisent sans le signaler, des impressions de mauvaise qualit\u00e9. R\u00e9ponse longue : Klipper a \u00e9t\u00e9 con\u00e7u pour contourner automatiquement de nombreux probl\u00e8mes passagers. Par exemple, il d\u00e9tecte automatiquement les erreurs de communication et retransmet les donn\u00e9es ; il planifie les actions \u00e0 l'avance et met en m\u00e9moire tampon les commandes \u00e0 plusieurs niveaux pour permettre une synchronisation pr\u00e9cise, m\u00eame en cas d'interf\u00e9rences intermittentes. Toutefois, si le logiciel d\u00e9tecte une erreur dont il ne peut corriger, s'il re\u00e7oit l'ordre d'effectuer une action non valide ou s'il constate qu'il est d\u00e9sesp\u00e9r\u00e9ment incapable d'ex\u00e9cuter la t\u00e2che qui lui est demand\u00e9e, Klipper signalera une erreur. Dans ces situations, le risque est grand de produire une impression de mauvaise qualit\u00e9 (ou pire). Nous esp\u00e9rons que le fait d'alerter l'utilisateur lui permettra de r\u00e9soudre le probl\u00e8me sous-jacent et d'am\u00e9liorer la qualit\u00e9 globale de ses impressions. Il y a quelques questions connexes : Pourquoi Klipper ne met-il pas plut\u00f4t l'impression en pause ? Ne signale-t-il pas plut\u00f4t un avertissement ? Ne v\u00e9rifie-t-il pas les erreurs avant l'impression ? N'ignore-t-il pas les erreurs dans les commandes saisies par l'utilisateur ? etc. Actuellement, Klipper lit les commandes en utilisant le protocole G-Code, et malheureusement le protocole de commande G-Code n'est pas assez flexible pour rendre ces alternatives praticables aujourd'hui. Il y a un int\u00e9r\u00eat certain \u00e0 am\u00e9liorer l'exp\u00e9rience utilisateur pour la gestion de ces \u00e9v\u00e8nements anormaux mais cela n\u00e9cessite un travail notable sur l'infrastructure (incluant de d\u00e9tourner le G-Code). Comment mettre \u00e0 jour vers la derni\u00e8re version du logiciel ? \u00b6 La premi\u00e8re \u00e9tape de la mise \u00e0 jour du logiciel consiste \u00e0 consulter le document le plus r\u00e9cent des changements de configuration . Il arrive que des modifications soient apport\u00e9es au logiciel et que les utilisateurs doivent mettre \u00e0 jour leurs param\u00e8tres dans le cadre d'une mise \u00e0 niveau logicielle. Il est conseill\u00e9 de consulter ce document avant de proc\u00e9der \u00e0 la mise \u00e0 niveau. Lorsque vous \u00eates pr\u00eat \u00e0 mettre \u00e0 jour, la m\u00e9thode g\u00e9n\u00e9rale consiste \u00e0 se connecter au Raspberry Pi et \u00e0 ex\u00e9cuter : cd ~/klipper git pull ~/klipper/scripts/install-octopi.sh On peut ensuite recompiler et flasher le code du microcontr\u00f4leur. Par exemple : make menuconfig make clean make sudo service klipper stop make flash FLASH_DEVICE=/dev/ttyACM0 sudo service klipper start Cependant, il arrive parfois que seul le logiciel h\u00f4te change. Dans ce cas, on peut mettre \u00e0 jour et red\u00e9marrer uniquement le logiciel h\u00f4te avec : cd ~/klipper git pull sudo service klipper restart Si, apr\u00e8s avoir utilis\u00e9 ce raccourci, le logiciel vous avertit qu'il faut reflasher le microcontr\u00f4leur ou qu'une autre erreur inhabituelle se produit, suivez les \u00e9tapes compl\u00e8tes de mise \u00e0 jour d\u00e9crites ci-dessus. Si des erreurs persistent, v\u00e9rifiez le document modifications de configuration , car vous devrez peut-\u00eatre modifier la configuration de l\u2019imprimante. Notez que les commandes G-Code RESTART et FIRMWARE_RESTART ne rechargent pas le logiciel - les commandes \"sudo service klipper restart\" et \"make flash\" ci-dessus sont n\u00e9cessaires pour que les modifications du logiciel prennent effet. Comment d\u00e9sinstaller Klipper ? \u00b6 Pour ce qui est du firmware, il n'y a rien de sp\u00e9cial \u00e0 faire. Suivez simplement les instructions de flashage du nouveau firmware. Du c\u00f4t\u00e9 Raspberry Pi, un script de d\u00e9sinstallation est disponible dans scripts/klipper-uninstall.sh . Par exemple : sudo ~/klipper/scripts/klipper-uninstall.sh rm -rf ~/klippy-env ~/klipper","title":"Foire Aux Questions"},{"location":"FAQ.html#foire-aux-questions","text":"","title":"Foire Aux Questions"},{"location":"FAQ.html#comment-puis-je-faire-un-don-au-projet","text":"Merci de votre soutien. Voir la page Sponsors pour plus d'informations.","title":"Comment puis-je faire un don au projet ?"},{"location":"FAQ.html#comment-calculer-le-parametre-de-configuration-rotation_distance","text":"Voir le document sur la distance de rotation .","title":"Comment calculer le param\u00e8tre de configuration rotation_distance ?"},{"location":"FAQ.html#ou-est-mon-port-serie","text":"De mani\u00e8re g\u00e9n\u00e9rale, on ex\u00e9cute la commande ls /dev/serial/by-id/* \u00e0 partir d'un terminal ssh sur la machine h\u00f4te pour trouver un port s\u00e9rie USB. Cette commande produira s\u00fbrement un r\u00e9sultat similaire \u00e0 celui-ci : /dev/serial/by-id/usb-1a86_USB2.0-Serial-if00-port0 Le nom retourn\u00e9 par la commande ci-dessus est constant, il est donc possible de l'utiliser dans le fichier de configuration et lors du flashage du microcontr\u00f4leur. Par exemple, une commande de flash peur ressembler \u00e0 : sudo service klipper stop make flash FLASH_DEVICE=/dev/serial/by-id/usb-1a86_USB2.0-Serial-if00-port0 sudo service klipper start et la configuration mise \u00e0 jour devrait ressembler \u00e0 : [mcu] serial: /dev/serial/by-id/usb-1a86_USB2.0-Serial-if00-port0 Veillez \u00e0 copier-coller le nom retourn\u00e9 par la commande \"ls\" que vous avez ex\u00e9cut\u00e9e ci-avant, car le nom sera diff\u00e9rent pour chaque imprimante. Si vous utilisez plusieurs microcontr\u00f4leurs et qu'ils n'ont pas d'identifiant unique (fr\u00e9quent avec les cartes utilisant une puce USB CH340), suivez les instructions ci-dessus en utilisant la commande ls /dev/serial/by-path/* \u00e0 la place.","title":"O\u00f9 est mon port s\u00e9rie ?"},{"location":"FAQ.html#lorsque-le-microcontroleur-redemarre-le-peripherique-passe-a-devttyusb1","text":"Suivez les instructions de la section \" O\u00f9 est mon port s\u00e9rie ? \" pour \u00e9viter que cela ne se produise.","title":"Lorsque le microcontr\u00f4leur red\u00e9marre, le p\u00e9riph\u00e9rique passe \u00e0 /dev/ttyUSB1"},{"location":"FAQ.html#la-commande-make-flash-ne-fonctionne-pas","text":"Le code tente de flasher le dispositif en utilisant la m\u00e9thode la plus courante pour chaque plateforme. Malheureusement, il y a beaucoup de variations dans les m\u00e9thodes de flashage, donc la commande \"make flash\" peut ne pas fonctionner avec toutes les cartes. Si vous rencontrez une erreur intermittente ou si votre configuration est standard, v\u00e9rifiez que Klipper est arr\u00eat\u00e9 pendant le flashage (sudo service klipper stop), assurez-vous qu'OctoPrint n'essaye pas de se connecter directement \u00e0 l'appareil (ouvrez l'onglet Connexion de la page web et cliquez sur D\u00e9connecter si le port s\u00e9rie de la carte est s\u00e9lectionn\u00e9), et assurez-vous que FLASH_DEVICE est correctement d\u00e9fini pour votre carte (voir la question ci-dessus ). Toutefois si \"make flash\" ne fonctionne pas pour votre carte, vous devrez flasher manuellement. V\u00e9rifiez s'il existe un fichier de configuration dans le r\u00e9pertoire config avec des instructions sp\u00e9cifiques pour flasher la carte. V\u00e9rifiez \u00e9galement la documentation du fabricant de la carte pour voir si elle d\u00e9crit comment la flasher. Enfin, il peut \u00eatre possible de flasher manuellement la carte en utilisant des outils tels que \"avrdude\" ou \"bossac\" - voir le document sur les booloaders pour plus d'informations.","title":"La commande \"make flash\" ne fonctionne pas"},{"location":"FAQ.html#comment-changer-la-vitesse-de-communicationbaud-rate-du-port-serie","text":"Le baud rate (taux bit/s) recommand\u00e9 pour Klipper est de 250000. Ce baud rate fonctionne bien sur toutes les cartes microcontr\u00f4leurs que Klipper prend en charge. Si vous avez trouv\u00e9 un guide en ligne recommandant un baud rate diff\u00e9rent, ignorez cette partie du guide et continuez avec la valeur par d\u00e9faut de 250000. Si vous voulez quand m\u00eame changer le baud rate, le nouveau taux devra \u00eatre configur\u00e9e dans le microcontr\u00f4leur (pendant make menuconfig ) et ce code mis \u00e0 jour devra \u00eatre compil\u00e9 et flash\u00e9 dans le microcontr\u00f4leur. Le fichier printer.cfg de Klipper devra \u00e9galement \u00eatre mis \u00e0 jour pour correspondre \u00e0 ce baud rate (voir le document de r\u00e9f\u00e9rence des configurations pour plus de d\u00e9tails). Par exemple : [mcu] baud: 250000 Le baud rate (taux bit/s) indiqu\u00e9 sur la page Web d'OctoPrint n'a aucun impact sur la vitesse de transmission du microcontr\u00f4leur interne de Klipper. R\u00e9glez toujours le taux de bit/s d'OctoPrint sur 250000 lorsque vous utilisez Klipper. Le baud rate utilis\u00e9 avec Klipper n'est pas li\u00e9e au baud rate du bootloader du microcontr\u00f4leur. Voir le document sur les bootloaders pour plus d'informations sur les bootloaders.","title":"Comment changer la vitesse de communication(baud rate) du port s\u00e9rie ?"},{"location":"FAQ.html#puis-je-faire-fonctionner-klipper-sur-autre-chose-quun-raspberry-pi-3","text":"Le mat\u00e9riel recommand\u00e9 est un Raspberry Pi 2, Raspberry Pi 3 ou Raspberry Pi 4. Klipper fonctionne sur un Raspberry Pi 1 et sur le Raspberry Pi Zero, mais ces cartes n'ont pas assez de puissance de traitement pour faire fonctionner OctoPrint correctement. Il est fr\u00e9quent que l'impression se fasse par \u00e0-coup avec ces machines plus lentes lorsqu'on imprime directement depuis OctoPrint. (L'imprimante peut chercher \u00e0 imprimer plus rapidement que la vitesse \u00e0 laquelle OctoPrint peut envoyer les commandes de mouvement.) Si vous souhaitez quand m\u00eame utiliser une de ces cartes plus lentes, pensez \u00e0 utiliser la fonctionnalit\u00e9 \"virtual_sdcard\" lors de l'impression (voir le document de r\u00e9f\u00e9rence des configurations pour plus de d\u00e9tails). Pour l'ex\u00e9cution sur le Beaglebone, voir les instructions d'installation sp\u00e9cifiques au Beaglebone . Klipper a \u00e9t\u00e9 ex\u00e9cut\u00e9 sur d'autres machines. Le logiciel h\u00f4te de Klipper ne n\u00e9cessite que l'ex\u00e9cution de Python sur un ordinateur Linux (ou similaire). Cependant, si vous souhaitez l'ex\u00e9cuter sur une autre machine, vous aurez besoin de connaissances d'administrateur Linux pour installer les pr\u00e9requis du syst\u00e8me pour cette machine particuli\u00e8re. Consultez le script install-octopi.sh pour plus d'informations sur les \u00e9tapes n\u00e9cessaires \u00e0 l'administration de Linux. Si vous souhaitez ex\u00e9cuter le logiciel h\u00f4te Klipper sur une puce bas de gamme, sachez qu'il faut au minimum une machine dot\u00e9e d'un mat\u00e9riel \u00e0 \"double pr\u00e9cision en virgule flottante\". Si vous souhaitez ex\u00e9cuter le logiciel h\u00f4te Klipper sur un ordinateur de bureau ou un serveur polyvalent partag\u00e9, notez que Klipper a des exigences en mati\u00e8re de programmation en temps r\u00e9el. Si, au cours d'une impression, l'ordinateur h\u00f4te ex\u00e9cute \u00e9galement une t\u00e2che informatique intensive (comme la d\u00e9fragmentation d'un disque dur, un rendu 3D, une forte utilisation du fichier d'\u00e9change, etc.), Klipper pourrait signaler des erreurs d'impression. Note : Si vous n'utilisez pas une image OctoPi, sachez que de nombreuses distributions Linux activent un paquet \"ModemManager\" (ou similaire) pouvant perturber la communication s\u00e9rie. (Ce qui peut amener Klipper \u00e0 rapporter des erreurs apparemment al\u00e9atoires \"Lost communication with MCU\"). Si vous installez Klipper sur une de ces distributions, vous devrez peut-\u00eatre d\u00e9sactiver ce paquet.","title":"Puis-je faire fonctionner Klipper sur autre chose qu'un Raspberry Pi 3 ?"},{"location":"FAQ.html#puis-je-executer-plusieurs-instances-de-klipper-sur-la-meme-machine-hote","text":"Il est possible d'ex\u00e9cuter plusieurs instances du logiciel h\u00f4te Klipper, mais cela n\u00e9cessite des connaissances en administration Linux. Les scripts d'installation de Klipper entra\u00eenent finalement l'ex\u00e9cution de la commande Unix suivante : ~/klippy-env/bin/python ~/klipper/klippy/klippy.py ~/printer.cfg -l /tmp/klippy.log On peut ex\u00e9cuter plusieurs instances de la commande ci-dessus \u00e0 condition que chaque instance ait son propre fichier de configuration d'imprimante, son propre fichier journal et son propre pseudo-tty. Par exemple : ~/klippy-env/bin/python ~/klipper/klippy/klippy.py ~/printer2.cfg -l /tmp/klippy2.log -I /tmp/printer2 Si vous choisissez de le faire, vous devrez impl\u00e9menter les scripts de d\u00e9marrage, d'arr\u00eat et d'installation n\u00e9cessaires (le cas \u00e9ch\u00e9ant). Le script install-octopi.sh et le script klipper-start.sh peuvent \u00eatre utiles comme exemples.","title":"Puis-je ex\u00e9cuter plusieurs instances de Klipper sur la m\u00eame machine h\u00f4te ?"},{"location":"FAQ.html#suis-je-oblige-dutiliser-octoprint","text":"Le logiciel Klipper n'est pas d\u00e9pendant d'OctoPrint. Il est possible d'utiliser un autre logiciel pour envoyer des commandes \u00e0 Klipper, mais cela n\u00e9cessite des connaissances en administration Linux. Klipper cr\u00e9e un \"port s\u00e9rie virtuel\" via le fichier \"/tmp/printer\" qui \u00e9mule une interface s\u00e9rie classique d'imprimante 3d via ce fichier. En g\u00e9n\u00e9ral, les logiciels alternatifs peuvent fonctionner avec Klipper tant qu'ils peuvent \u00eatre configur\u00e9s pour utiliser \"/tmp/printer\" pour le port s\u00e9rie de l'imprimante.","title":"Suis-je oblig\u00e9 d'utiliser Octoprint ?"},{"location":"FAQ.html#pourquoi-ne-puis-je-pas-lancer-un-deplacement-avant-de-prendre-lorigine","text":"Le code fait cela pour r\u00e9duire le risque de d\u00e9placer accidentellement la t\u00eate dans le lit ou dans un mur. Une fois que la prise d'origine est effectu\u00e9e, le logiciel v\u00e9rifie que chaque mouvement se situe dans les limites de position_min/max d\u00e9finies dans le fichier de configuration. Si les moteurs sont d\u00e9sactiv\u00e9s (via une commande M84 ou M18), les moteurs devront reprendre l'origine avant tout mouvement. Si vous souhaitez d\u00e9placer la t\u00eate apr\u00e8s avoir annul\u00e9 une impression via OctoPrint, pensez \u00e0 modifier la s\u00e9quence d'annulation d'OctoPrint pour qu'elle le fasse pour vous. Depuis un navigateur web, elle est configur\u00e9e dans OctoPrint sous : Param\u00e8tres->Scripts GCODE Si vous souhaitez d\u00e9placer la t\u00eate apr\u00e8s la fin d'une impression, pensez \u00e0 ajouter le mouvement souhait\u00e9 \u00e0 la section \"G-Code personnalis\u00e9\" de votre slicer. Si l'imprimante n\u00e9cessite un mouvement suppl\u00e9mentaire dans le cadre du processus de mise \u00e0 l'origine (ou si elle n'a pas de processus de mise \u00e0 l'origine), envisagez d'utiliser une section safe_z_home ou homing_override dans le fichier de configuration. Si vous devez d\u00e9placer un moteur \u00e0 des fins de diagnostic ou de d\u00e9bogage, pensez \u00e0 ajouter une section force_move dans le fichier de configuration. Voir r\u00e9f\u00e9rence de configuration pour plus de d\u00e9tails sur ces options.","title":"Pourquoi ne puis-je pas lancer un d\u00e9placement avant de prendre l'origine ?"},{"location":"FAQ.html#pourquoi-le-parametre-position_endstop-de-laxe-z-est-il-defini-a-05-dans-les-configurations-par-defaut","text":"Pour les imprimantes de style cart\u00e9sien, la position Z_endstop indique la distance entre la buse et le lit au moment du d\u00e9clenchement de la fin de course. Si possible, il est recommand\u00e9 d'utiliser une but\u00e9e de fin de course Z-max et de s'\u00e9loigner du lit (car cela r\u00e9duit le risque de collision avec le lit). Cependant, si l'on doit se rapprocher du lit, il est recommand\u00e9 de positionner la but\u00e9e de mani\u00e8re \u00e0 ce qu'elle se d\u00e9clenche lorsque la buse est encore \u00e0 une petite distance du lit. De cette fa\u00e7on, lorsque l'axe se dirige vers le lit, il s'arr\u00eate avant que la buse ne touche le lit. Voir le document niveau du lit pour plus d'informations.","title":"Pourquoi le param\u00e8tre position_endstop de l'axe Z est-il d\u00e9fini \u00e0 0.5 dans les configurations par d\u00e9faut ?"},{"location":"FAQ.html#jai-converti-ma-configuration-depuis-marlin-et-les-axes-xy-fonctionnent-bien-mais-jobtiens-un-bruit-strident-lors-de-lorientation-de-laxe-z","text":"R\u00e9ponse courte : Tout d'abord, assurez-vous d'avoir v\u00e9rifi\u00e9 la configuration du moteur comme d\u00e9crit dans le document de v\u00e9rification de la configuration . Si le probl\u00e8me persiste, essayez de r\u00e9duire le param\u00e8tre max_z_velocity dans la configuration de l'imprimante. R\u00e9ponse longue : En pratique, Marlin ne peut se d\u00e9placer qu'\u00e0 une vitesse d'environ 10000 pas par seconde. Si on lui demande de se d\u00e9placer \u00e0 une vitesse n\u00e9cessitant un taux de pas plus \u00e9lev\u00e9, Marlin se contentera g\u00e9n\u00e9ralement de faire des pas aussi rapides qu'il le peut. Klipper est capable d'atteindre des taux de pas beaucoup plus \u00e9lev\u00e9s, mais le moteur pas \u00e0 pas peut ne pas avoir de couple suffisant pour se d\u00e9placer \u00e0 une vitesse plus \u00e9lev\u00e9e. Ainsi, pour un axe Z avec un rapport d'engrenage \u00e9lev\u00e9 ou un r\u00e9glage de micropas \u00e9lev\u00e9, la vitesse max_z_obtenue peut \u00eatre inf\u00e9rieure \u00e0 ce qui est configur\u00e9 dans Marlin.","title":"J'ai converti ma configuration depuis Marlin et les axes X/Y fonctionnent bien, mais j'obtiens un bruit strident lors de l'orientation de l'axe Z"},{"location":"FAQ.html#mes-pilotes-de-moteur-tmc-sarretent-en-plein-milieu-dune-impression","text":"Si vous utilisez le pilote TMC2208 (ou TMC2224) en \"mode autonome\", assurez-vous d'utiliser la derni\u00e8re version de Klipper . Une solution de contournement pour un probl\u00e8me avec les pilotes TMC2208 \"stealthchop\" a \u00e9t\u00e9 ajout\u00e9e \u00e0 Klipper \u00e0 la mi-mars 2020.","title":"Mes pilotes de moteur TMC s'arr\u00eatent en plein milieu d'une impression"},{"location":"FAQ.html#jai-des-erreurs-aleatoires-lost-communication-with-mcu-communication-perdue-avec-le-microcontroleur","text":"Ce probl\u00e8me est g\u00e9n\u00e9ralement caus\u00e9 par des erreurs mat\u00e9rielles sur la connexion USB entre la machine h\u00f4te et le microcontr\u00f4leur. Les choses \u00e0 rechercher : Utilisez un c\u00e2ble USB de qualit\u00e9 entre la machine h\u00f4te et le microcontr\u00f4leur. Assurez-vous que les fiches sont bien fix\u00e9es. Si vous utilisez un Raspberry Pi, utilisez une alimentation de bonne qualit\u00e9 pour le Raspberry Pi et utilisez un c\u00e2ble USB de bonne qualit\u00e9 pour connecter cette alimentation au Pi. Si OctoPrint vous avertit que vous \u00eates sous tension, cela est li\u00e9 \u00e0 l'alimentation \u00e9lectrique et doit \u00eatre r\u00e9par\u00e9. Assurez-vous que l'alimentation \u00e9lectrique de l'imprimante n'est pas surcharg\u00e9e. (Les fluctuations d'alimentation de la puce USB du microcontr\u00f4leur peuvent entra\u00eener une r\u00e9initialisation de cette puce.) V\u00e9rifiez que les fils de l'imprimante (pastille, \u00e9l\u00e9ment chauffant et autres) sont bien sertis et pas effiloch\u00e9s. (Le mouvement de l'imprimante peut exercer une contrainte sur un c\u00e2blage d\u00e9fectueux entra\u00eenant une perte de contact, un court-circuit bref ou la production d'un bruit excessif.) Des signalements ont fait \u00e9tat d'un bruit USB \u00e9lev\u00e9 lorsque l'alimentation de l'imprimante et l'alimentation 5V de l'h\u00f4te sont m\u00e9lang\u00e9es. (Si vous constatez que le microcontr\u00f4leur s'allume lorsque l'alimentation de l'imprimante est sous tension ou que le c\u00e2ble USB est branch\u00e9, cela indique que les alimentations 5V sont m\u00e9lang\u00e9es). Il peut \u00eatre utile de configurer le micro-contr\u00f4leur pour qu'il utilise l'alimentation d'une seule source. (Alternativement, si la carte du micro-contr\u00f4leur ne peut pas configurer sa source d'alimentation, on peut modifier un c\u00e2ble USB pour qu'il ne transporte pas de tension de 5V entre l'h\u00f4te et le micro-contr\u00f4leur.)","title":"J'ai des erreurs al\u00e9atoires \"Lost communication with MCU\" (communication perdue avec le microcontr\u00f4leur)"},{"location":"FAQ.html#mon-raspberry-pi-redemarre-pendant-les-impressions","text":"Cela est tr\u00e8s probablement d\u00fb \u00e0 des fluctuations de tension. Suivez les m\u00eames \u00e9tapes de d\u00e9pannage que pour une erreur \u00ab Communication perdue avec le MCU \u00bb .","title":"Mon Raspberry Pi red\u00e9marre pendant les impressions"},{"location":"FAQ.html#lorsque-jai-defini-restart_methodcommand-mon-appareil-avr-se-bloque-lors-dun-redemarrage","text":"Certaines anciennes versions du bootloader AVR ont un bogue connu dans la gestion des \u00e9v\u00e9nements de chien de garde. Cela se manifeste typiquement lorsque le param\u00e8tre restart_method est d\u00e9fini sur \"command\" dans le fichier printer.cfg. Lorsque le bogue se produit, le dispositif AVR ne r\u00e9pond pas jusqu'\u00e0 ce que l'alimentation de la carte soit coup\u00e9e puis remise (les DEL d'alimentation ou d'\u00e9tat peuvent \u00e9galement clignoter de mani\u00e8re r\u00e9p\u00e9t\u00e9e jusqu'\u00e0 ce que l'alimentation soit retir\u00e9e). La solution est d'utiliser un restart_method autre que \"command\" ou de flasher un bootloader r\u00e9cent sur le dispositif AVR. Le flashage d'un nouveau bootloader est une \u00e9tape particuli\u00e8re qui n\u00e9cessite g\u00e9n\u00e9ralement un programmateur externe - voir Bootloaders pour plus de d\u00e9tails.","title":"Lorsque j'ai d\u00e9fini restart_method=command, mon appareil AVR se bloque lors d'un red\u00e9marrage"},{"location":"FAQ.html#est-ce-que-les-elements-chauffants-restent-allumes-si-le-raspberry-pi-plante","text":"Le logiciel a \u00e9t\u00e9 con\u00e7u pour \u00e9viter cela. Une fois que l'h\u00f4te a activ\u00e9 un \u00e9l\u00e9ment chauffant, le logiciel h\u00f4te doit confirmer cette activation toutes les 5 secondes. Si le microcontr\u00f4leur ne re\u00e7oit pas de confirmation toutes les 5 secondes, il passe dans un status \"arr\u00eat\u00e9\" con\u00e7u pour \u00e9teindre tous les \u00e9l\u00e9ments chauffants et les moteurs pas \u00e0 pas. Voir la commande \"config_digital_out\" dans le documentation des commandes MCU pour plus de d\u00e9tails. En outre, le logiciel du microcontr\u00f4leur est configur\u00e9 avec une plage de temp\u00e9rature minimale et maximale pour chaque \u00e9l\u00e9ment chauffant au d\u00e9marrage (voir les param\u00e8tres min_temp et max_temp dans le document de r\u00e9f\u00e9rences des configurations pour plus de d\u00e9tails). Si le microcontr\u00f4leur d\u00e9tecte que la temp\u00e9rature est en dehors de cette plage, il passe \u00e9galement au status \"arr\u00eat\u00e9\". S\u00e9par\u00e9ment, le logiciel h\u00f4te impl\u00e9mente \u00e9galement un code pour v\u00e9rifier que les \u00e9l\u00e9ments chauffants et les capteurs de temp\u00e9rature fonctionnent correctement. Voir le document de r\u00e9f\u00e9rence des configurations pour plus de d\u00e9tails.","title":"Est-ce que les \u00e9l\u00e9ments chauffants restent allum\u00e9s si le Raspberry Pi plante ?"},{"location":"FAQ.html#comment-puis-je-convertir-les-noms-de-broches-de-marlin-a-klipper","text":"R\u00e9ponse courte : un mappage est disponible dans le fichier sample-aliases.cfg . Utilisez ce fichier comme guide pour trouver les noms des broches du microcontr\u00f4leur. (Il est \u00e9galement possible de copier la section de configuration board_pins correspondante dans votre fichier de configuration et d'utiliser les alias dans votre configuration, mais il est pr\u00e9f\u00e9rable de traduire et d'utiliser les noms r\u00e9els des broches du microcontr\u00f4leur). Notez que le fichier sample-aliases.cfg utilise des noms de broches qui commencent par le pr\u00e9fixe \"ar\" au lieu de \"D\" (par exemple, la broche Arduino D23 est l'alias Klipper ar23 ) et le pr\u00e9fixe \"analog\" au lieu de \"A\" (par exemple, la broche Arduino A14 est l'alias Klipper analog14 ). R\u00e9ponse longue : Klipper utilise les noms de broches standard d\u00e9finis par le microcontr\u00f4leur. Sur les puces Atmega, ces broches mat\u00e9rielles ont des noms tels que PA4 , PC7 , ou PD2 . Il y a longtemps, le projet Arduino a d\u00e9cid\u00e9 d'\u00e9viter d'utiliser les noms standards du mat\u00e9riel en faveur de leurs propres noms de broches bas\u00e9s sur des nombres incr\u00e9ment\u00e9s - ces noms Arduino ressemblent g\u00e9n\u00e9ralement \u00e0 D23 ou A14 . Il s'agit d'un choix malheureux qui peut pr\u00eater \u00e0 confusion. En particulier parce que les num\u00e9ros de broches Arduino ne correspondent pas syst\u00e9matiquement aux m\u00eames noms mat\u00e9riels. Par exemple, D21 correspond \u00e0 PD0 sur certaines cartes Arduino et \u00e0 PC7 sur d'autres. Pour \u00e9viter cette confusion, le code source de Klipper utilise les noms de broches standard d\u00e9finis par le microcontr\u00f4leur.","title":"Comment puis-je convertir les noms de broches de Marlin \u00e0 Klipper ?"},{"location":"FAQ.html#dois-je-connecter-mon-appareil-a-un-type-specifique-de-broche-de-microcontroleur","text":"Cela d\u00e9pend du type d'appareil et du type de broche : Broches ADC (ou broches analogiques) : pour les thermistances et autres capteurs \"analogiques\", l'\u00e9l\u00e9ment doit \u00eatre c\u00e2bl\u00e9 \u00e0 une broche \"analogique\" ou \"ADC\" du microcontr\u00f4leur. Si vous configurez Klipper pour utiliser une broche qui n'est pas capable de fonctionner en analogique, Klipper signalera une erreur \"Not a valid ADC pin\". Broches PWM (ou broches de timer) : Klipper n'utilise pas de PWM mat\u00e9riel par d\u00e9faut pour aucun \u00e9l\u00e9ment. Donc on peut c\u00e2bler des \u00e9l\u00e9ments chauffants, des ventilateurs et des dispositifs similaires \u00e0 n'importe quelle broche d'E/S d'usage g\u00e9n\u00e9ral. Cependant, les ventilateurs et les \u00e9l\u00e9ments param\u00e9tr\u00e9s en output_pin peuvent \u00eatre \u00e9ventuellement configur\u00e9s pour utiliser hardware_pwm : True , auquel cas le micro-contr\u00f4leur doit supporter le PWM mat\u00e9riel sur la broche (sinon, Klipper signalera une erreur \"Not a valid PWM pin\"). Broches IRQ (ou broches d'interruption) : Klipper n'utilise pas d'interruptions mat\u00e9rielles sur les broches d'E/S, il n'est donc jamais n\u00e9cessaire de connecter un p\u00e9riph\u00e9rique \u00e0 l'une de ces broches du microcontr\u00f4leur. Broches SPI : Lors de l'utilisation du SPI mat\u00e9riel, il est n\u00e9cessaire de connecter l\u2019\u00e9l\u00e9ment aux broches SPI du micro-contr\u00f4leur. Toutefois, la plupart des \u00e9l\u00e9ments peuvent \u00eatre configur\u00e9s pour utiliser le \"SPI logiciel\", auquel cas n'importe quelle broche d'E/S d'usage g\u00e9n\u00e9ral peut \u00eatre utilis\u00e9e. Broches I2C : lors de l'utilisation d'I2C, il est n\u00e9cessaire de c\u00e2bler les broches aux broches compatibles I2C du microcontr\u00f4leur. D\u2019autres \u00e9l\u00e9ments peuvent \u00eatre c\u00e2bl\u00e9s \u00e0 n\u2019importe quelle broche d\u2019E/S \u00e0 usage g\u00e9n\u00e9ral. Par exemple, les steppers, les \u00e9l\u00e9ments chauffants, les ventilateurs, les sondes Z, les servos, les LED, les \u00e9crans LCD hd44780 /st7920 courants, le c\u00e2ble de communication UART des pilotes Trinamic peut \u00eatre raccord\u00e9 \u00e0 n\u2019importe quelle broche d'E/S.","title":"Dois-je connecter mon appareil \u00e0 un type sp\u00e9cifique de broche de microcontr\u00f4leur ?"},{"location":"FAQ.html#comment-annuler-une-commande-m109m190-attendre-la-temperature","text":"Allez dans l'onglet terminal d'OctoPrint et envoyez une commande M112 dans la console. La commande M112 fera entrer Klipper dans un \u00e9tat \"d'arr\u00eat\" et d\u00e9connectera OctoPrint de Klipper. Dans le bloc de connexion d'OctoPrint, cliquez sur \"Connecter\" pour que OctoPrint se reconnecte. Revenez \u00e0 l'onglet du terminal et lancez une commande FIRMWARE_RESTART pour effacer le status en erreur de Klipper. Apr\u00e8s avoir effectu\u00e9 cette s\u00e9quence, la demande de chauffage pr\u00e9c\u00e9dente sera annul\u00e9e et une nouvelle impression pourra \u00eatre lanc\u00e9e.","title":"Comment annuler une commande M109/M190 \u00ab attendre la temp\u00e9rature \u00bb ?"},{"location":"FAQ.html#comment-savoir-si-limprimante-a-perdu-des-pas","text":"D'une certaine mani\u00e8re, oui. Effectuez la prise d'origine (homing), lancez la commande GET_POSITION , d\u00e9marrez votre impression, refaite la prise d'origine et lancez \u00e0 nouveau la commande GET_POSITION . Comparez ensuite les valeurs de la ligne mcu : . Cela peut \u00eatre utile pour r\u00e9gler des param\u00e8tres tels que les courants, les acc\u00e9l\u00e9rations et les vitesses des moteurs pas \u00e0 pas sans avoir besoin d'imprimer quelque chose et de gaspiller du filament : il suffit d'ex\u00e9cuter quelques mouvements \u00e0 grande vitesse entre des commandes GET_POSITION . Notez que les interrupteurs de fin de course eux-m\u00eames ont tendance \u00e0 se d\u00e9clencher \u00e0 des positions l\u00e9g\u00e8rement diff\u00e9rentes, de sorte qu'une diff\u00e9rence de quelques micro-pas est probablement caus\u00e9 par l'impr\u00e9cision de la fin de course. Un moteur pas \u00e0 pas ne peut perdre des pas que par incr\u00e9ments de 4 pas complets. (Ainsi, si l'on utilise 16 micropas, un pas r\u00e9ellement perdu par le moteur se traduirait par une diff\u00e9rence multiple de 64 micropas avec le compteur de pas \"mcu :\")","title":"Comment savoir si l'imprimante a perdu des pas ?"},{"location":"FAQ.html#pourquoi-klipper-signale-t-il-des-erreurs-jai-rate-mon-impression","text":"R\u00e9ponse courte : Nous voulons savoir si nos imprimantes rencontre un probl\u00e8me afin qu'il puisse \u00eatre r\u00e9solu et que nous puissions obtenir des impressions de grande qualit\u00e9. Nous ne voulons surtout pas que nos imprimantes produisent sans le signaler, des impressions de mauvaise qualit\u00e9. R\u00e9ponse longue : Klipper a \u00e9t\u00e9 con\u00e7u pour contourner automatiquement de nombreux probl\u00e8mes passagers. Par exemple, il d\u00e9tecte automatiquement les erreurs de communication et retransmet les donn\u00e9es ; il planifie les actions \u00e0 l'avance et met en m\u00e9moire tampon les commandes \u00e0 plusieurs niveaux pour permettre une synchronisation pr\u00e9cise, m\u00eame en cas d'interf\u00e9rences intermittentes. Toutefois, si le logiciel d\u00e9tecte une erreur dont il ne peut corriger, s'il re\u00e7oit l'ordre d'effectuer une action non valide ou s'il constate qu'il est d\u00e9sesp\u00e9r\u00e9ment incapable d'ex\u00e9cuter la t\u00e2che qui lui est demand\u00e9e, Klipper signalera une erreur. Dans ces situations, le risque est grand de produire une impression de mauvaise qualit\u00e9 (ou pire). Nous esp\u00e9rons que le fait d'alerter l'utilisateur lui permettra de r\u00e9soudre le probl\u00e8me sous-jacent et d'am\u00e9liorer la qualit\u00e9 globale de ses impressions. Il y a quelques questions connexes : Pourquoi Klipper ne met-il pas plut\u00f4t l'impression en pause ? Ne signale-t-il pas plut\u00f4t un avertissement ? Ne v\u00e9rifie-t-il pas les erreurs avant l'impression ? N'ignore-t-il pas les erreurs dans les commandes saisies par l'utilisateur ? etc. Actuellement, Klipper lit les commandes en utilisant le protocole G-Code, et malheureusement le protocole de commande G-Code n'est pas assez flexible pour rendre ces alternatives praticables aujourd'hui. Il y a un int\u00e9r\u00eat certain \u00e0 am\u00e9liorer l'exp\u00e9rience utilisateur pour la gestion de ces \u00e9v\u00e8nements anormaux mais cela n\u00e9cessite un travail notable sur l'infrastructure (incluant de d\u00e9tourner le G-Code).","title":"Pourquoi Klipper signale-t-il des erreurs ? J\u2019ai rat\u00e9 mon impression !"},{"location":"FAQ.html#comment-mettre-a-jour-vers-la-derniere-version-du-logiciel","text":"La premi\u00e8re \u00e9tape de la mise \u00e0 jour du logiciel consiste \u00e0 consulter le document le plus r\u00e9cent des changements de configuration . Il arrive que des modifications soient apport\u00e9es au logiciel et que les utilisateurs doivent mettre \u00e0 jour leurs param\u00e8tres dans le cadre d'une mise \u00e0 niveau logicielle. Il est conseill\u00e9 de consulter ce document avant de proc\u00e9der \u00e0 la mise \u00e0 niveau. Lorsque vous \u00eates pr\u00eat \u00e0 mettre \u00e0 jour, la m\u00e9thode g\u00e9n\u00e9rale consiste \u00e0 se connecter au Raspberry Pi et \u00e0 ex\u00e9cuter : cd ~/klipper git pull ~/klipper/scripts/install-octopi.sh On peut ensuite recompiler et flasher le code du microcontr\u00f4leur. Par exemple : make menuconfig make clean make sudo service klipper stop make flash FLASH_DEVICE=/dev/ttyACM0 sudo service klipper start Cependant, il arrive parfois que seul le logiciel h\u00f4te change. Dans ce cas, on peut mettre \u00e0 jour et red\u00e9marrer uniquement le logiciel h\u00f4te avec : cd ~/klipper git pull sudo service klipper restart Si, apr\u00e8s avoir utilis\u00e9 ce raccourci, le logiciel vous avertit qu'il faut reflasher le microcontr\u00f4leur ou qu'une autre erreur inhabituelle se produit, suivez les \u00e9tapes compl\u00e8tes de mise \u00e0 jour d\u00e9crites ci-dessus. Si des erreurs persistent, v\u00e9rifiez le document modifications de configuration , car vous devrez peut-\u00eatre modifier la configuration de l\u2019imprimante. Notez que les commandes G-Code RESTART et FIRMWARE_RESTART ne rechargent pas le logiciel - les commandes \"sudo service klipper restart\" et \"make flash\" ci-dessus sont n\u00e9cessaires pour que les modifications du logiciel prennent effet.","title":"Comment mettre \u00e0 jour vers la derni\u00e8re version du logiciel ?"},{"location":"FAQ.html#comment-desinstaller-klipper","text":"Pour ce qui est du firmware, il n'y a rien de sp\u00e9cial \u00e0 faire. Suivez simplement les instructions de flashage du nouveau firmware. Du c\u00f4t\u00e9 Raspberry Pi, un script de d\u00e9sinstallation est disponible dans scripts/klipper-uninstall.sh . Par exemple : sudo ~/klipper/scripts/klipper-uninstall.sh rm -rf ~/klippy-env ~/klipper","title":"Comment d\u00e9sinstaller Klipper ?"},{"location":"Features.html","text":"Caract\u00e9ristiques \u00b6 Klipper propose plusieurs caract\u00e9ristiques int\u00e9ressantes : Mouvements pas \u00e0 pas de haute pr\u00e9cision. Klipper utilise un processeur d'application (tel qu'un Raspberry Pi \u00e0 bas prix) pour calculer les mouvements de l'imprimante. Ce processeur d'application d\u00e9termine le moment o\u00f9 il faut faire marcher chaque moteur pas \u00e0 pas, compresse ces \u00e9v\u00e9nements, les transmet au microcontr\u00f4leur pour que celui-ci ex\u00e9cute chaque \u00e9v\u00e9nement au moment demand\u00e9. Chaque \u00e9v\u00e9nement du moteur pas \u00e0 pas est programm\u00e9 avec une pr\u00e9cision de 25 microsecondes ou mieux. Le logiciel n'utilise pas d'estimations cin\u00e9matiques (telles que l'algorithme de Bresenham), au lieu de cela, il calcule des dur\u00e9es de pas pr\u00e9cises bas\u00e9es sur les physiques de l'acc\u00e9l\u00e9ration et de la cin\u00e9matique de la machine. Un mouvement plus pr\u00e9cis des pas permet un fonctionnement plus silencieux et plus stable de l'imprimante. Meilleures performances de sa cat\u00e9gorie. Klipper est capable d'atteindre des taux de pas \u00e9lev\u00e9s sur les micro-contr\u00f4leurs nouveaux et anciens. M\u00eame les anciens microcontr\u00f4leurs 8 bits peuvent obtenir des taux sup\u00e9rieurs \u00e0 175 000 pas par seconde. Sur les micro-contr\u00f4leurs plus r\u00e9cents, plusieurs millions de pas par seconde sont possibles. Des taux de pas plus \u00e9lev\u00e9s permettent des vitesses d'impression plus \u00e9lev\u00e9es. La synchronisation des \u00e9v\u00e9nements du pas \u00e0 pas reste pr\u00e9cise m\u00eame \u00e0 des vitesses \u00e9lev\u00e9es, ce qui am\u00e9liore la stabilit\u00e9 globale. Klipper prend en charge les imprimantes dot\u00e9es de plusieurs microcontr\u00f4leurs. Par exemple, un microcontr\u00f4leur peut \u00eatre utilis\u00e9 pour contr\u00f4ler l'extrudeur, tandis qu'un autre contr\u00f4le les pi\u00e8ces chauffantes de l'imprimante, et un troisi\u00e8me s'occupe du reste de l'imprimante. Le logiciel Klipper met en \u0153uvre la synchronisation de l'horloge pour tenir compte de la d\u00e9rive entre les microcontr\u00f4leurs. Il n'y a pas besoin de code particulier pour activer plusieurs microcontr\u00f4leurs - il suffit de quelques lignes suppl\u00e9mentaires dans le fichier de configuration. Configuration gr\u00e2ce \u00e0 un fichier de configuration unique. Il n'est pas n\u00e9cessaire de reflasher le microcontr\u00f4leur pour modifier un param\u00e8tre. Toute la configuration de Klipper est stock\u00e9e dans un fichier de configuration standard qui peut \u00eatre facilement modifi\u00e9. Cela facilite la configuration et la maintenance du mat\u00e9riel. Klipper prend en charge la fonction \"Smooth Pressure Advance\", un m\u00e9canisme permettant de prendre en compte les effets de la pression dans un extrudeur. Cela r\u00e9duit le \"suintement\" de l'extrudeur et am\u00e9liore la qualit\u00e9 des d'impression des coins. L'impl\u00e9mentation de Klipper n'introduit pas de changements instantan\u00e9s de la vitesse de l'extrudeur, ce qui am\u00e9liore la stabilit\u00e9 et la robustesse g\u00e9n\u00e9rales. Klipper prend en charge la fonction \"Input Shaping\" pour r\u00e9duire l'impact des vibrations sur la qualit\u00e9 d'impression. Cela peut r\u00e9duire ou \u00e9liminer le \"ringing\" (\u00e9galement appel\u00e9 \"ghosting\", \"echoing\" ou \"rippling\") des impressions. Cela peut \u00e9galement permettre d'obtenir des vitesses d'impression plus rapides tout en maintenant une qualit\u00e9 d'impression \u00e9lev\u00e9e. Klipper utilise un \"solveur it\u00e9ratif\" pour calculer des temps de pas pr\u00e9cis \u00e0 partir d'\u00e9quations cin\u00e9matiques simples. Cela facilite le portage de Klipper sur de nouveaux types de robots et permet de conserver un timing pr\u00e9cis m\u00eame avec une cin\u00e9matique complexe (aucune \"segmentation de ligne\" n'est n\u00e9cessaire). Klipper est agnostique vis-\u00e0-vis du mat\u00e9riel. On doit obtenir le m\u00eame timing pr\u00e9cis ind\u00e9pendamment du mat\u00e9riel \u00e9lectronique de bas niveau. Le code du microcontr\u00f4leur de Klipper est con\u00e7u pour suivre fid\u00e8lement l\u2019ordonnancement fourni par le logiciel h\u00f4te de Klipper (ou pour alerter l'utilisateur de mani\u00e8re \u00e9vidente s'il n'y parvient pas). Il est ainsi plus facile d'utiliser le mat\u00e9riel disponible, de mettre \u00e0 niveau vers un nouveau mat\u00e9riel et d'\u00eatre confiant dans ce mat\u00e9riel. Code portable. Klipper fonctionne sur les micro-contr\u00f4leurs bas\u00e9s sur ARM, AVR et PRU. Les imprimantes existantes de type \"reprap\" peuvent utiliser Klipper sans modification mat\u00e9rielle - il suffit d'ajouter un Raspberry Pi. La conception interne du code de Klipper facilite le support d'autres architectures de micro-contr\u00f4leurs. Un code plus simple. Klipper utilise un langage de tr\u00e8s haut niveau (Python) pour la plupart du code. Les algorithmes cin\u00e9matiques, l'analyse du code G, les algorithmes de chauffage et de thermistance, etc. sont tous \u00e9crits en Python. Il est donc plus facile de d\u00e9velopper de nouvelles fonctionnalit\u00e9s. Macros programmables personnalis\u00e9es. De nouvelles commandes G-Code peuvent \u00eatre d\u00e9finies dans le fichier de configuration de l'imprimante (aucune modification du code n'est alors n\u00e9cessaire). Ces commandes sont programmables - ce qui leur permet de produire diff\u00e9rentes actions selon l'\u00e9tat de l'imprimante. Serveur d\u2019API int\u00e9gr\u00e9. En plus de l\u2019interface G-Code standard, Klipper prend en charge une interface d\u2019application en JSON. Cela permet aux programmeurs de cr\u00e9er des applications externes avec un contr\u00f4le pr\u00e9cis de l\u2019imprimante. Caract\u00e9ristiques suppl\u00e9mentaires \u00b6 Klipper prend en charge de nombreuses fonctionnalit\u00e9s standard des imprimantes 3d : Plusieurs interfaces web disponibles. Fonctionne avec Mainsail, Fluidd, OctoPrint et d'autres. Cela permet de contr\u00f4ler l'imprimante \u00e0 l'aide d'un navigateur web ordinaire. Le m\u00eame Raspberry Pi qui fait fonctionner Klipper peut \u00e9galement faire fonctionner l'interface web. Prise en charge du G-Code standard. Les commandes de g-code courantes produites par les \"trancheurs\" (slicers) typiques (SuperSlicer, Cura, PrusaSlicer, etc.) sont prises en charge. Prise en charge de l'extrusion multiple. Les extrudeurs avec r\u00e9chauffeurs partag\u00e9s et les extrudeurs sur chariots ind\u00e9pendants (IDEX) sont \u00e9galement prises en charge. Prise en charge des imprimantes cart\u00e9siennes, delta, corexy, corexz, hybrides-corexy, hybrides-corexz, deltesiennes, rotatives delta, polaires et \u00e0 treuil. Support du nivellement automatique du bed. Klipper peut \u00eatre configur\u00e9 pour une d\u00e9tection de base de l'inclinaison du bed ou pour une mise \u00e0 niveau compl\u00e8te de celui-ci. Si le bed utilise plusieurs steppers Z, Klipper peut \u00e9galement le mettre \u00e0 niveau en manipulant ind\u00e9pendamment les steppers Z. La plupart des capteurs de hauteur Z sont prises en charge, y compris les sondes BL-Touch et les sondes activ\u00e9es par servomoteur. Prise en charge du calibrage delta automatique. L'outil d'\u00e9talonnage peut effectuer un \u00e9talonnage de base de la hauteur ainsi qu'un avanc\u00e9 des dimensions X et Y. L'\u00e9talonnage peut \u00eatre effectu\u00e9 avec un palpeur de l'axe Z ou manuellement. Prise en charge de l'option \"exclure un objet\" lors de l'impression. Lorsqu'il est configur\u00e9, ce module peut faciliter l'annulation d'un seul objet dans une impression en plusieurs parties. Prise en charge des capteurs de temp\u00e9rature courants (par exemple, les thermistances courantes, AD595, AD597, AD849x, PT100, PT1000, MAX6675, MAX31855, MAX31856, MAX31865, BME280, HTU21D, DS18B20 et LM75). Des thermistances et des capteurs de temp\u00e9rature analogiques personnalis\u00e9s peuvent \u00e9galement \u00eatre configur\u00e9s. On peut surveiller le capteur de temp\u00e9rature interne du microcontr\u00f4leur et le capteur de temp\u00e9rature interne d'un Raspberry Pi. Protection thermique basique de l'appareil activ\u00e9e par d\u00e9faut. Prise en charge des ventilateurs standard, des ventilateurs de buses et des ventilateurs \u00e0 temp\u00e9rature contr\u00f4l\u00e9e. Il n'est pas n\u00e9cessaire de faire tourner les ventilateurs lorsque l'imprimante est inactive. La vitesse du ventilateur peut \u00eatre contr\u00f4l\u00e9e sur les ventilateurs dot\u00e9s d'un tachym\u00e8tre. Prise en charge de la configuration en temps r\u00e9el des pilotes de moteurs pas \u00e0 pas TMC2130, TMC2208/TMC2224, TMC2209, TMC2660 et TMC5160. Il existe \u00e9galement un support pour le contr\u00f4le du courant des pilotes de moteurs pas \u00e0 pas traditionnels via AD5206, DAC084S085, MCP4451, MCP4728, MCP4018, et les broches PWM. Prise en charge des \u00e9crans LCD courants fix\u00e9s directement \u00e0 l'imprimante. Un menu par d\u00e9faut est \u00e9galement disponible. Le contenu de l'\u00e9cran et du menu peut \u00eatre enti\u00e8rement personnalis\u00e9 via le fichier de configuration. Acc\u00e9l\u00e9ration constante et prise en charge du \"look-ahead\". Tous les mouvements de l'imprimante s'acc\u00e9l\u00e8rent progressivement de l'arr\u00eat \u00e0 la vitesse de croisi\u00e8re, puis d\u00e9c\u00e9l\u00e8rent pour revenir \u00e0 l'arr\u00eat. Le flux entrant de commandes de mouvement en G-Code est mis en file d'attente et analys\u00e9 - l'acc\u00e9l\u00e9ration entre les mouvements dans une direction similaire sera optimis\u00e9e pour r\u00e9duire les blocages d'impression et am\u00e9liorer le temps d'impression global. Klipper met en \u0153uvre un algorithme de \"fin de phase pas \u00e0 pas\" qui peut am\u00e9liorer la pr\u00e9cision des interrupteurs de but\u00e9e. Lorsqu'il est correctement r\u00e9gl\u00e9, il peut am\u00e9liorer l'adh\u00e9rence de la premi\u00e8re couche d'une impression. Prise en charge des capteurs de pr\u00e9sence de filaments, des capteurs de mouvement de filaments et des capteurs de largeur de filaments. Prise en charge de la mesure et l'enregistrement de l'acc\u00e9l\u00e9ration \u00e0 l'aide d'un acc\u00e9l\u00e9rom\u00e8tre adxl345, mpu9250 et mpu6050. Prise en charge de la limitation de la vitesse maximale des mouvements courts en \"zigzag\" pour r\u00e9duire les vibrations et le bruit de l'imprimante. Voir le document Cin\u00e9matiques pour plus d'informations. Des exemples de fichiers de configuration sont disponibles pour de nombreuses imprimantes courantes. Consultez le r\u00e9pertoire des configurations pour en obtenir la liste. Pour commencer avec Klipper, lisez le guide d' installation . Tests de performance du stepper \u00b6 Ci-apr\u00e8s les r\u00e9sultats des tests de performance du stepper. Les chiffres indiqu\u00e9s repr\u00e9sentent le nombre total de pas par seconde sur le micro-contr\u00f4leur. Microcontr\u00f4leur 1 stepper actif 3 steppers actifs AVR 16Mhz 157K 99K AVR 20Mhz 196K 123K SAMD21 686K 471K STM32F042 814K 578K PRU Beaglebone 866K 708K STM32G0B1 1103K 790K STM32F103 1180K 818K SAM3X8E 1273K 981K SAM4S8C 1690K 1385K LPC1768 1923K 1351K LPC1769 2353K 1622K RP2040 2400K 1636K SAM4E8E 2500K 1674K SAMD51 3077K 1885K STM32F407 3652K 2459K STM32F446 3913K 2634K STM32H743 9091K 6061K Si vous n'\u00eates pas s\u00fbr du microcontr\u00f4leur d'une carte particuli\u00e8re, trouvez le fichier de configuration appropri\u00e9 , et cherchez le nom du microcontr\u00f4leur dans les commentaires en haut de ce fichier. De plus amples d\u00e9tails sur les bancs d'essais sont disponibles dans le document des bancs d'essais .","title":"Caract\u00e9ristiques"},{"location":"Features.html#caracteristiques","text":"Klipper propose plusieurs caract\u00e9ristiques int\u00e9ressantes : Mouvements pas \u00e0 pas de haute pr\u00e9cision. Klipper utilise un processeur d'application (tel qu'un Raspberry Pi \u00e0 bas prix) pour calculer les mouvements de l'imprimante. Ce processeur d'application d\u00e9termine le moment o\u00f9 il faut faire marcher chaque moteur pas \u00e0 pas, compresse ces \u00e9v\u00e9nements, les transmet au microcontr\u00f4leur pour que celui-ci ex\u00e9cute chaque \u00e9v\u00e9nement au moment demand\u00e9. Chaque \u00e9v\u00e9nement du moteur pas \u00e0 pas est programm\u00e9 avec une pr\u00e9cision de 25 microsecondes ou mieux. Le logiciel n'utilise pas d'estimations cin\u00e9matiques (telles que l'algorithme de Bresenham), au lieu de cela, il calcule des dur\u00e9es de pas pr\u00e9cises bas\u00e9es sur les physiques de l'acc\u00e9l\u00e9ration et de la cin\u00e9matique de la machine. Un mouvement plus pr\u00e9cis des pas permet un fonctionnement plus silencieux et plus stable de l'imprimante. Meilleures performances de sa cat\u00e9gorie. Klipper est capable d'atteindre des taux de pas \u00e9lev\u00e9s sur les micro-contr\u00f4leurs nouveaux et anciens. M\u00eame les anciens microcontr\u00f4leurs 8 bits peuvent obtenir des taux sup\u00e9rieurs \u00e0 175 000 pas par seconde. Sur les micro-contr\u00f4leurs plus r\u00e9cents, plusieurs millions de pas par seconde sont possibles. Des taux de pas plus \u00e9lev\u00e9s permettent des vitesses d'impression plus \u00e9lev\u00e9es. La synchronisation des \u00e9v\u00e9nements du pas \u00e0 pas reste pr\u00e9cise m\u00eame \u00e0 des vitesses \u00e9lev\u00e9es, ce qui am\u00e9liore la stabilit\u00e9 globale. Klipper prend en charge les imprimantes dot\u00e9es de plusieurs microcontr\u00f4leurs. Par exemple, un microcontr\u00f4leur peut \u00eatre utilis\u00e9 pour contr\u00f4ler l'extrudeur, tandis qu'un autre contr\u00f4le les pi\u00e8ces chauffantes de l'imprimante, et un troisi\u00e8me s'occupe du reste de l'imprimante. Le logiciel Klipper met en \u0153uvre la synchronisation de l'horloge pour tenir compte de la d\u00e9rive entre les microcontr\u00f4leurs. Il n'y a pas besoin de code particulier pour activer plusieurs microcontr\u00f4leurs - il suffit de quelques lignes suppl\u00e9mentaires dans le fichier de configuration. Configuration gr\u00e2ce \u00e0 un fichier de configuration unique. Il n'est pas n\u00e9cessaire de reflasher le microcontr\u00f4leur pour modifier un param\u00e8tre. Toute la configuration de Klipper est stock\u00e9e dans un fichier de configuration standard qui peut \u00eatre facilement modifi\u00e9. Cela facilite la configuration et la maintenance du mat\u00e9riel. Klipper prend en charge la fonction \"Smooth Pressure Advance\", un m\u00e9canisme permettant de prendre en compte les effets de la pression dans un extrudeur. Cela r\u00e9duit le \"suintement\" de l'extrudeur et am\u00e9liore la qualit\u00e9 des d'impression des coins. L'impl\u00e9mentation de Klipper n'introduit pas de changements instantan\u00e9s de la vitesse de l'extrudeur, ce qui am\u00e9liore la stabilit\u00e9 et la robustesse g\u00e9n\u00e9rales. Klipper prend en charge la fonction \"Input Shaping\" pour r\u00e9duire l'impact des vibrations sur la qualit\u00e9 d'impression. Cela peut r\u00e9duire ou \u00e9liminer le \"ringing\" (\u00e9galement appel\u00e9 \"ghosting\", \"echoing\" ou \"rippling\") des impressions. Cela peut \u00e9galement permettre d'obtenir des vitesses d'impression plus rapides tout en maintenant une qualit\u00e9 d'impression \u00e9lev\u00e9e. Klipper utilise un \"solveur it\u00e9ratif\" pour calculer des temps de pas pr\u00e9cis \u00e0 partir d'\u00e9quations cin\u00e9matiques simples. Cela facilite le portage de Klipper sur de nouveaux types de robots et permet de conserver un timing pr\u00e9cis m\u00eame avec une cin\u00e9matique complexe (aucune \"segmentation de ligne\" n'est n\u00e9cessaire). Klipper est agnostique vis-\u00e0-vis du mat\u00e9riel. On doit obtenir le m\u00eame timing pr\u00e9cis ind\u00e9pendamment du mat\u00e9riel \u00e9lectronique de bas niveau. Le code du microcontr\u00f4leur de Klipper est con\u00e7u pour suivre fid\u00e8lement l\u2019ordonnancement fourni par le logiciel h\u00f4te de Klipper (ou pour alerter l'utilisateur de mani\u00e8re \u00e9vidente s'il n'y parvient pas). Il est ainsi plus facile d'utiliser le mat\u00e9riel disponible, de mettre \u00e0 niveau vers un nouveau mat\u00e9riel et d'\u00eatre confiant dans ce mat\u00e9riel. Code portable. Klipper fonctionne sur les micro-contr\u00f4leurs bas\u00e9s sur ARM, AVR et PRU. Les imprimantes existantes de type \"reprap\" peuvent utiliser Klipper sans modification mat\u00e9rielle - il suffit d'ajouter un Raspberry Pi. La conception interne du code de Klipper facilite le support d'autres architectures de micro-contr\u00f4leurs. Un code plus simple. Klipper utilise un langage de tr\u00e8s haut niveau (Python) pour la plupart du code. Les algorithmes cin\u00e9matiques, l'analyse du code G, les algorithmes de chauffage et de thermistance, etc. sont tous \u00e9crits en Python. Il est donc plus facile de d\u00e9velopper de nouvelles fonctionnalit\u00e9s. Macros programmables personnalis\u00e9es. De nouvelles commandes G-Code peuvent \u00eatre d\u00e9finies dans le fichier de configuration de l'imprimante (aucune modification du code n'est alors n\u00e9cessaire). Ces commandes sont programmables - ce qui leur permet de produire diff\u00e9rentes actions selon l'\u00e9tat de l'imprimante. Serveur d\u2019API int\u00e9gr\u00e9. En plus de l\u2019interface G-Code standard, Klipper prend en charge une interface d\u2019application en JSON. Cela permet aux programmeurs de cr\u00e9er des applications externes avec un contr\u00f4le pr\u00e9cis de l\u2019imprimante.","title":"Caract\u00e9ristiques"},{"location":"Features.html#caracteristiques-supplementaires","text":"Klipper prend en charge de nombreuses fonctionnalit\u00e9s standard des imprimantes 3d : Plusieurs interfaces web disponibles. Fonctionne avec Mainsail, Fluidd, OctoPrint et d'autres. Cela permet de contr\u00f4ler l'imprimante \u00e0 l'aide d'un navigateur web ordinaire. Le m\u00eame Raspberry Pi qui fait fonctionner Klipper peut \u00e9galement faire fonctionner l'interface web. Prise en charge du G-Code standard. Les commandes de g-code courantes produites par les \"trancheurs\" (slicers) typiques (SuperSlicer, Cura, PrusaSlicer, etc.) sont prises en charge. Prise en charge de l'extrusion multiple. Les extrudeurs avec r\u00e9chauffeurs partag\u00e9s et les extrudeurs sur chariots ind\u00e9pendants (IDEX) sont \u00e9galement prises en charge. Prise en charge des imprimantes cart\u00e9siennes, delta, corexy, corexz, hybrides-corexy, hybrides-corexz, deltesiennes, rotatives delta, polaires et \u00e0 treuil. Support du nivellement automatique du bed. Klipper peut \u00eatre configur\u00e9 pour une d\u00e9tection de base de l'inclinaison du bed ou pour une mise \u00e0 niveau compl\u00e8te de celui-ci. Si le bed utilise plusieurs steppers Z, Klipper peut \u00e9galement le mettre \u00e0 niveau en manipulant ind\u00e9pendamment les steppers Z. La plupart des capteurs de hauteur Z sont prises en charge, y compris les sondes BL-Touch et les sondes activ\u00e9es par servomoteur. Prise en charge du calibrage delta automatique. L'outil d'\u00e9talonnage peut effectuer un \u00e9talonnage de base de la hauteur ainsi qu'un avanc\u00e9 des dimensions X et Y. L'\u00e9talonnage peut \u00eatre effectu\u00e9 avec un palpeur de l'axe Z ou manuellement. Prise en charge de l'option \"exclure un objet\" lors de l'impression. Lorsqu'il est configur\u00e9, ce module peut faciliter l'annulation d'un seul objet dans une impression en plusieurs parties. Prise en charge des capteurs de temp\u00e9rature courants (par exemple, les thermistances courantes, AD595, AD597, AD849x, PT100, PT1000, MAX6675, MAX31855, MAX31856, MAX31865, BME280, HTU21D, DS18B20 et LM75). Des thermistances et des capteurs de temp\u00e9rature analogiques personnalis\u00e9s peuvent \u00e9galement \u00eatre configur\u00e9s. On peut surveiller le capteur de temp\u00e9rature interne du microcontr\u00f4leur et le capteur de temp\u00e9rature interne d'un Raspberry Pi. Protection thermique basique de l'appareil activ\u00e9e par d\u00e9faut. Prise en charge des ventilateurs standard, des ventilateurs de buses et des ventilateurs \u00e0 temp\u00e9rature contr\u00f4l\u00e9e. Il n'est pas n\u00e9cessaire de faire tourner les ventilateurs lorsque l'imprimante est inactive. La vitesse du ventilateur peut \u00eatre contr\u00f4l\u00e9e sur les ventilateurs dot\u00e9s d'un tachym\u00e8tre. Prise en charge de la configuration en temps r\u00e9el des pilotes de moteurs pas \u00e0 pas TMC2130, TMC2208/TMC2224, TMC2209, TMC2660 et TMC5160. Il existe \u00e9galement un support pour le contr\u00f4le du courant des pilotes de moteurs pas \u00e0 pas traditionnels via AD5206, DAC084S085, MCP4451, MCP4728, MCP4018, et les broches PWM. Prise en charge des \u00e9crans LCD courants fix\u00e9s directement \u00e0 l'imprimante. Un menu par d\u00e9faut est \u00e9galement disponible. Le contenu de l'\u00e9cran et du menu peut \u00eatre enti\u00e8rement personnalis\u00e9 via le fichier de configuration. Acc\u00e9l\u00e9ration constante et prise en charge du \"look-ahead\". Tous les mouvements de l'imprimante s'acc\u00e9l\u00e8rent progressivement de l'arr\u00eat \u00e0 la vitesse de croisi\u00e8re, puis d\u00e9c\u00e9l\u00e8rent pour revenir \u00e0 l'arr\u00eat. Le flux entrant de commandes de mouvement en G-Code est mis en file d'attente et analys\u00e9 - l'acc\u00e9l\u00e9ration entre les mouvements dans une direction similaire sera optimis\u00e9e pour r\u00e9duire les blocages d'impression et am\u00e9liorer le temps d'impression global. Klipper met en \u0153uvre un algorithme de \"fin de phase pas \u00e0 pas\" qui peut am\u00e9liorer la pr\u00e9cision des interrupteurs de but\u00e9e. Lorsqu'il est correctement r\u00e9gl\u00e9, il peut am\u00e9liorer l'adh\u00e9rence de la premi\u00e8re couche d'une impression. Prise en charge des capteurs de pr\u00e9sence de filaments, des capteurs de mouvement de filaments et des capteurs de largeur de filaments. Prise en charge de la mesure et l'enregistrement de l'acc\u00e9l\u00e9ration \u00e0 l'aide d'un acc\u00e9l\u00e9rom\u00e8tre adxl345, mpu9250 et mpu6050. Prise en charge de la limitation de la vitesse maximale des mouvements courts en \"zigzag\" pour r\u00e9duire les vibrations et le bruit de l'imprimante. Voir le document Cin\u00e9matiques pour plus d'informations. Des exemples de fichiers de configuration sont disponibles pour de nombreuses imprimantes courantes. Consultez le r\u00e9pertoire des configurations pour en obtenir la liste. Pour commencer avec Klipper, lisez le guide d' installation .","title":"Caract\u00e9ristiques suppl\u00e9mentaires"},{"location":"Features.html#tests-de-performance-du-stepper","text":"Ci-apr\u00e8s les r\u00e9sultats des tests de performance du stepper. Les chiffres indiqu\u00e9s repr\u00e9sentent le nombre total de pas par seconde sur le micro-contr\u00f4leur. Microcontr\u00f4leur 1 stepper actif 3 steppers actifs AVR 16Mhz 157K 99K AVR 20Mhz 196K 123K SAMD21 686K 471K STM32F042 814K 578K PRU Beaglebone 866K 708K STM32G0B1 1103K 790K STM32F103 1180K 818K SAM3X8E 1273K 981K SAM4S8C 1690K 1385K LPC1768 1923K 1351K LPC1769 2353K 1622K RP2040 2400K 1636K SAM4E8E 2500K 1674K SAMD51 3077K 1885K STM32F407 3652K 2459K STM32F446 3913K 2634K STM32H743 9091K 6061K Si vous n'\u00eates pas s\u00fbr du microcontr\u00f4leur d'une carte particuli\u00e8re, trouvez le fichier de configuration appropri\u00e9 , et cherchez le nom du microcontr\u00f4leur dans les commentaires en haut de ce fichier. De plus amples d\u00e9tails sur les bancs d'essais sont disponibles dans le document des bancs d'essais .","title":"Tests de performance du stepper"},{"location":"G-Codes.html","text":"G-Codes \u00b6 Ce document d\u00e9crit les commandes que Klipper supporte. Il s'agit de commandes que l'on peut saisir dans l'onglet du terminal OctoPrint. Commandes G-Code \u00b6 Klipper prend en charge les commandes G-Code standard suivantes : Move (G0 ou G1): G1 [X<pos>] [Y<pos>] [Z<pos>] [E<pos>] [F<speed>] Temporisation : G4 P<millisecondes> D\u00e9placement vers l'origine : G28 [X] [Y] [Z] \u00c9teindre les moteurs : M18 ou M84 Attendre la fin des mouvements en cours : M400 Utiliser des distances absolues/relatives pour l'extrusion : M82 , M83 Utiliser des coordonn\u00e9es absolues/relatives : G90 , G91 D\u00e9finir la position : G92 [X<pos>] [Y<pos>] [Z<pos>] [E<pos>] D\u00e9finir le pourcentage de neutralisation du facteur de vitesse : M220 S<percent> D\u00e9finit le pourcentage d'annulation du facteur d'extrusion : M221 S<percent> R\u00e9gler l'acc\u00e9l\u00e9ration : M204 S<valeur> OU M204 P<valeur> T<valeur> Remarque : si S n'est pas sp\u00e9cifi\u00e9 et que P et T le sont, l'acc\u00e9l\u00e9ration sera r\u00e9gl\u00e9e sur le minimum de P et T. Si un seul P ou T est donn\u00e9, la commande n'aura aucun effet. Obtenir la temp\u00e9rature de l'extrudeur : M105 R\u00e9gler la temp\u00e9rature de l'extrudeur : M104 [T<index>] [S<temp\u00e9rature>] R\u00e9gler la temp\u00e9rature de l'extrudeur et attendre : M109 [T<index>] S<temp\u00e9rature> Note : M109 attendra toujours que la temp\u00e9rature se stabilise \u00e0 la valeur demand\u00e9e. R\u00e9gler la temp\u00e9rature du bed : M140 [S<temperature>] R\u00e9gler la temp\u00e9rature du bed et attendre : M190 S<temperature> Note : M190 attendra toujours que la temp\u00e9rature se stabilise \u00e0 la valeur demand\u00e9e. R\u00e9gler la vitesse du ventilateur : M106 S<valeur> D\u00e9sactiver le ventilateur : M107 Arr\u00eat d'urgence : M112 Obtenir la position actuelle : M114 Obtenir la version du firmware : M115 Pour plus de d\u00e9tails sur les commandes ci-dessus, voir la [documentation RepRap G-Code] ( http://reprap.org/wiki/G-code ). L'objectif de Klipper est de prendre en charge les commandes G-Code produites par les logiciels tiers courants (par exemple, OctoPrint, Printrun, Slic3r, Cura, etc.) dans leurs configurations standards. Le but n'est pas de prendre en charge toutes les commandes G-Code possibles. Au contraire, Klipper pr\u00e9f\u00e8re les [\"commandes G-Code \u00e9tendues\"] (#additional-commands) humainement lisibles. De la m\u00eame mani\u00e8re, la sortie du terminal G-Code est uniquement destin\u00e9e \u00e0 \u00eatre humainement lisible - voir le document du serveur API si vous contr\u00f4lez Klipper depuis un logiciel externe. Si vous avez besoin d'une commande G-Code moins courante, il est possible de l'impl\u00e9menter avec une section de configuration gcode_macro personnalis\u00e9e . Par exemple, on peut utiliser ceci pour impl\u00e9menter : G12 , G29 , G30 , G31 , M42 , M80 , M81 , T1 , etc. Commandes additionnelles \u00b6 Klipper utilise des commandes G-Code \"\u00e9tendues\" pour la configuration g\u00e9n\u00e9rale et l'\u00e9tat. Ces commandes \u00e9tendues suivent toutes un format similaire : elles commencent par le nom de la commande et peuvent \u00eatre suivies d'un ou plusieurs param\u00e8tres. Par exemple : SET_SERVO SERVO=myservo ANGLE=5.3 . Dans ce document, les commandes et les param\u00e8tres sont indiqu\u00e9s en majuscules, mais ils ne sont pas sensibles \u00e0 la casse. (Ainsi, \"SET_SERVO\" et \"set_servo\" ex\u00e9cuteront tous deux la m\u00eame commande). Cette section est organis\u00e9e par nom de module Klipper, en suivant g\u00e9n\u00e9ralement les noms de section sp\u00e9cifi\u00e9s dans le fichier de configuration de l'imprimante . Notez que certains modules sont automatiquement charg\u00e9s. [adxl345] \u00b6 Les commandes suivantes sont disponibles lorsqu'une section adxl345 config est activ\u00e9e. ACCELEROMETER_MEASURE \u00b6 ACCELEROMETER_MEASURE [CHIP=<nom_de_la_configuration>] [NAME=<valeur>] : D\u00e9marre les mesures de l'acc\u00e9l\u00e9rom\u00e8tre au nombre d'\u00e9chantillons par seconde demand\u00e9. Si CHIP n'est pas pr\u00e9cis\u00e9, la valeur par d\u00e9faut est \"adxl345\". La commande fonctionne en mode start-stop : ex\u00e9cut\u00e9e pour la premi\u00e8re fois, elle d\u00e9marre les mesures, l'ex\u00e9cution suivante les arr\u00eate. Les r\u00e9sultats des mesures sont \u00e9crits dans un fichier nomm\u00e9 /tmp/adxl345-<chip>-<nom>.csv o\u00f9 <chip> est le nom de la puce acc\u00e9l\u00e9rom\u00e8tre ( my_chip_name de [adxl345 my_chip_name] ) et <nom> est le param\u00e8tre optionnel NAME. Si le param\u00e8tre NOM n'est pas pr\u00e9cis\u00e9, l'heure actuelle est utilis\u00e9e par d\u00e9faut au format \"AAAAMMJJ_HHMMSS\". Si l'acc\u00e9l\u00e9rom\u00e8tre n'a pas de nom dans sa section de configuration (simplement [adxl345] ) alors la partie <chip> du nom n'est pas g\u00e9n\u00e9r\u00e9e. ACCELEROMETER_QUERY \u00b6 ACCELEROMETER_QUERY [CHIP=<nom_de_la_configuration>] [RATE=<valeur>] : interroge l'acc\u00e9l\u00e9rom\u00e8tre pour la valeur courante. Si CHIP n'est pas pr\u00e9cis\u00e9, la valeur par d\u00e9faut est \"adxl345\". Si RATE n'est pas pr\u00e9cis\u00e9, la valeur par d\u00e9faut est utilis\u00e9e. Cette commande permet de tester la connexion \u00e0 l'acc\u00e9l\u00e9rom\u00e8tre ADXL345 : une des valeurs retourn\u00e9es devrait \u00eatre une acc\u00e9l\u00e9ration en chute libre (+/- un certain bruit de la puce). ACCELEROMETER_DEBUG_READ \u00b6 ACCELEROMETER_DEBUG_READ [CHIP=<nom_de_la_configuration>] REG=<registre> : interroge le registre ADXL345 \"registre\" (par exemple 44 ou 0x2C). Peut \u00eatre utile \u00e0 des fins de d\u00e9bogage. ACCELEROMETER_DEBUG_WRITE \u00b6 ACCELEROMETER_DEBUG_WRITE [CHIP=<nom_de_la_configuration>] REG=<registre> VAL=<valeur> : Ecrit la \"valeur\" brute dans le registre \"registre\". La \"valeur\" et le \"registre\" peuvent \u00eatre des entiers d\u00e9cimaux ou hexad\u00e9cimaux. A utiliser avec pr\u00e9caution, et se r\u00e9f\u00e9rer \u00e0 la fiche technique de l'ADXL345 pour la r\u00e9f\u00e9rence. [angle] \u00b6 Les commandes suivantes sont disponibles lorsqu'une section angle config est activ\u00e9e. ANGLE_CALIBRATE \u00b6 ANGLE_CALIBRATE CHIP=<nom_de_la_puce> : Effectue une calibration d'angle sur le capteur donn\u00e9 (il doit y avoir une section de configuration [angle nom_de_la_puce] qui a indiqu\u00e9 un param\u00e8tre stepper ). IMPORTANT - cet outil commandera au moteur pas \u00e0 pas de se d\u00e9placer sans v\u00e9rifier les limites normales de la cin\u00e9matique. Id\u00e9alement, le moteur devrait \u00eatre d\u00e9connect\u00e9 de tout chariot d'imprimante avant d'effectuer le calibrage. Si le moteur pas \u00e0 pas ne peut pas \u00eatre d\u00e9connect\u00e9 de l'imprimante, assurez-vous que le chariot est proche du centre de son rail avant de commencer l'\u00e9talonnage. (Le moteur pas \u00e0 pas peut se d\u00e9placer vers l'avant ou l'arri\u00e8re de deux rotations compl\u00e8tes durant ce test). Apr\u00e8s avoir termin\u00e9 ce test, utilisez la commande SAVE_CONFIG pour sauvegarder les donn\u00e9es de calibration dans le fichier de configuration. Afin d'utiliser cet outil, le paquetage Python \"numpy\" doit \u00eatre install\u00e9 (voir le document mesurer les r\u00e9sonances pour plus d'informations). ANGLE_DEBUG_READ \u00b6 ANGLE_DEBUG_READ CHIP=<nom_de_la_configuration> REG=<registre> : Interroge le registre \"registre\" du capteur (par exemple 44 ou 0x2C). Peut \u00eatre utile \u00e0 des fins de d\u00e9bogage. Ceci n'est disponible que pour les puces tle5012b. ANGLE_DEBUG_WRITE \u00b6 ANGLE_DEBUG_WRITE CHIP=<nom_de_la_configuration> REG=<registre> VAL=<valeur> : \u00c9crit la \"valeur\" brute dans le registre \"registre\". La \"valeur\" et le \"registre\" peuvent \u00eatre des entiers d\u00e9cimaux ou hexad\u00e9cimaux. A utiliser avec pr\u00e9caution, et se r\u00e9f\u00e9rer \u00e0 la fiche technique du capteur pour la r\u00e9f\u00e9rence. Cette fonction n'est disponible que pour les puces tle5012b. [bed_mesh] \u00b6 Les commandes suivantes sont disponibles lorsque la section configuration de bed_mesh est activ\u00e9e (voir \u00e9galement le guide de bed_mesh ). BED_MESH_CALIBRATE \u00b6 BED_MESH_CALIBRATE [METHOD=manual] [<probe_parameter>=<value>] [<mesh_parameter>=<value>] : Cette commande palpe le bed en utilisant des points g\u00e9n\u00e9r\u00e9s sp\u00e9cifi\u00e9s par les param\u00e8tres de la config. Apr\u00e8s le test, un maillage est g\u00e9n\u00e9r\u00e9 et le d\u00e9placement de l'axe Z est ajust\u00e9 en fonction de celui-ci. R\u00e9f\u00e9rez-vous \u00e0 la commande PROBE pour plus de d\u00e9tails sur les param\u00e8tres optionnels. Si METHOD=manual est sp\u00e9cifi\u00e9, l'outil de palpage manuel est activ\u00e9 - voir la commande MANUAL_PROBE ci-dessus pour plus de d\u00e9tails sur les possibilit\u00e9s suppl\u00e9mentaires disponibles lorsque cet outil est utilis\u00e9. BED_MESH_OUTPUT \u00b6 BED_MESH_OUTPUT PGP=[<0:1>] : Cette commande \u00e9crit les valeurs z palp\u00e9es actuelles et les valeurs de maillage actuelles sur le terminal. Si PGP=1 est sp\u00e9cifi\u00e9, les coordonn\u00e9es X, Y g\u00e9n\u00e9r\u00e9es par bed_mesh, ainsi que leurs indices associ\u00e9s, seront envoy\u00e9s au terminal. BED_MESH_MAP \u00b6 BED_MESH_MAP : Comme pour BED_MESH_OUTPUT, cette commande affiche l'\u00e9tat actuel du maillage sur le terminal. L'\u00e9tat sera retourn\u00e9 au format json. Cela permet aux plugins octoprint de r\u00e9cup\u00e9rer facilement les donn\u00e9es et de g\u00e9n\u00e9rer des cartes d'altitude au plus proche de la surface du bed. BED_MESH_CLEAR \u00b6 BED_MESH_CLEAR : Cette commande efface le maillage actuel et supprime les ajustements de l'axe z. Il est recommand\u00e9 de mettre cette commande dans votre gcode de fin. BED_MESH_PROFILE \u00b6 BED_MESH_PROFILE LOAD=<nom> SAVE=<nom> REMOVE=<nom> : Cette commande fournit une gestion de profil pour l'\u00e9tat du maillage. LOAD restaurera l'\u00e9tat du maillage \u00e0 partir du profil correspondant au nom fourni. SAVE sauvegarde l'\u00e9tat du maillage actuel dans un profil correspondant au nom fourni. REMOVE supprimera le profil correspondant au nom fourni de la m\u00e9moire persistante. Notez qu'apr\u00e8s l'ex\u00e9cution des op\u00e9rations SAVE ou REMOVE, le gcode SAVE_CONFIG doit \u00eatre ex\u00e9cut\u00e9 pour rendre les changements de la m\u00e9moire persistante permanents. BED_MESH_OFFSET \u00b6 BED_MESH_OFFSET [X=<value>] [Y=<value>] : Applique des d\u00e9calages X et/ou Y pour l'\u00e9valuation du maillage. Ceci est utile pour les imprimantes avec extrudeurs ind\u00e9pendants, car un d\u00e9calage est n\u00e9cessaire pour obtenir un ajustement Z correct apr\u00e8s un changement d'outil. [bed_screws] \u00b6 Les commandes suivantes sont disponibles lorsque la section config bed_screws est activ\u00e9e (voir \u00e9galement le guide du nivelage manuel ). BED_SCREWS_ADJUST \u00b6 BED_SCREWS_ADJUST : Cette commande fait appel \u00e0 l'outil de r\u00e9glage des vis du bed. Elle commandera la buse \u00e0 diff\u00e9rents endroits (tels que d\u00e9finis dans le fichier de configuration) et permettra d'ajuster les vis du bed afin que celui-ci et la buse soient \u00e0 distance constante. [bed_tilt] \u00b6 Les commandes suivantes sont disponibles lorsque la section config bed_tilt est activ\u00e9e. BED_TILT_CALIBRATE \u00b6 BED_TILT_CALIBRATE [METHOD=manual] [<probe_parameter>=<value>] : Cette commande teste les points sp\u00e9cifi\u00e9s dans la configuration, puis recommande des ajustements d'inclinaison x et y mis \u00e0 jour. Voir la commande PROBE pour plus de d\u00e9tails sur les param\u00e8tres de palpage optionnels. Si METHOD=manual est sp\u00e9cifi\u00e9, l'outil de palpage manuel est activ\u00e9 - voir la commande MANUAL_PROBE ci-dessus pour plus de d\u00e9tails sur les commandes suppl\u00e9mentaires disponibles lorsque cet outil est actif. [bltouch] \u00b6 La commande suivante est disponible lorsqu'une section bltouch config est activ\u00e9e (voir \u00e9galement le Guide BL-Touch ). BLTOUCH_DEBUG \u00b6 BLTOUCH_DEBUG COMMAND=<commande> : Ceci envoie une commande au BLTouch. Elle peut \u00eatre utile pour le d\u00e9bogage. Les commandes disponibles sont : pin_down , touch_mode , pin_up , self_test , reset . Un BL-Touch V3.0 ou V3.1 accepte en plus les commandes set_5V_output_mode , set_OD_output_mode , output_mode_store . BLTOUCH_STORE \u00b6 BLTOUCH_STORE MODE=<output_mode> : Stocke un mode de sortie dans l'EEPROM d'un BLTouch V3.1 Les modes de sortie disponibles sont : 5V , OD [configfile] \u00b6 Le module configfile est automatiquement charg\u00e9. SAVE_CONFIG \u00b6 SAVE_CONFIG : Cette commande \u00e9crase le fichier de configuration principal de l'imprimante et red\u00e9marre le logiciel h\u00f4te. Cette commande est utilis\u00e9e conjointement avec d'autres commandes d'\u00e9talonnage pour enregistrer les r\u00e9sultats de ces tests. [delayed_gcode] \u00b6 La commande suivante est activ\u00e9e si une section de configuration delayed_gcode a \u00e9t\u00e9 activ\u00e9e (voir \u00e9galement le guide des mod\u00e8les ). UPDATE_DELAYED_GCODE \u00b6 UPDATE_DELAYED_GCODE [ID=<nom>] [DURATION=<secondes>] : Met \u00e0 jour la dur\u00e9e du retard du [delayed_gcode] identifi\u00e9 et d\u00e9marre le minuteur pour l'ex\u00e9cution du gcode. Une valeur de 0 annulera l'ex\u00e9cution d'un gcode retard\u00e9 en attente. [delta_calibrate] \u00b6 Les commandes suivantes sont disponibles lorsque la section delta_calibrate config est activ\u00e9e (voir \u00e9galement le guide delta calibrate ). DELTA_CALIBRATE \u00b6 DELTA_CALIBRATE [METHOD=manual] [<probe_parameter>=<value>] : Cette commande teste sept points sur le lit et recommande des positions de but\u00e9e, des angles de tour et des rayons mis \u00e0 jour. Voir la commande PROBE pour plus de d\u00e9tails sur les param\u00e8tres de palpage optionnels. Si METHOD=manual est sp\u00e9cifi\u00e9, l'outil de palpage manuel est activ\u00e9 - voir la commande MANUAL_PROBE ci-dessus pour plus de d\u00e9tails sur les commandes suppl\u00e9mentaires disponibles lorsque cet outil est actif. DELTA_ANALYZE \u00b6 DELTA_ANALYZE : Cette commande est utilis\u00e9e pendant l'\u00e9talonnage delta am\u00e9lior\u00e9. Voir Calibrage delta pour plus de d\u00e9tails. [display] \u00b6 La commande suivante est disponible lorsqu'une section display config est activ\u00e9e. SET_DISPLAY_GROUP \u00b6 SET_DISPLAY_GROUP [DISPLAY=<display>] GROUP=<group> : D\u00e9finit le groupe d'affichage actif d'un \u00e9cran LCD. Cela permet de d\u00e9finir plusieurs groupes de donn\u00e9es d'affichage dans la configuration, par exemple [display_data <group> <elementname>] et de passer de l'un \u00e0 l'autre en utilisant cette commande gcode \u00e9tendue. Si DISPLAY n'est pas sp\u00e9cifi\u00e9, la valeur par d\u00e9faut est \"display\" (l'affichage principal). [display_status] \u00b6 Le module display_status est automatiquement charg\u00e9 si une section display config est activ\u00e9e. Il fournit les commandes G-Code standard suivantes : Afficher un message : M117 <message> D\u00e9finir le pourcentage de g\u00e9n\u00e9ration : M73 P<pourcentage> La commande G-Code \u00e9tendue suivante est \u00e9galement fournie : SET_DISPLAY_TEXT MSG=<message> : Effectue l'\u00e9quivalent de M117, en d\u00e9finissant le MSG fourni comme le message d'affichage actuel. Si MSG est omis, l'affichage est effac\u00e9. [dual_carriage] \u00b6 La commande suivante est disponible lorsque la section config dual_carriage est activ\u00e9e. SET_DUAL_CARRIAGE \u00b6 SET_DUAL_CARRIAGE CARRIAGE=[0|1] : Cette commande d\u00e9finit le chariot actif. Elle est g\u00e9n\u00e9ralement appel\u00e9e \u00e0 partir des champs activate_gcode et deactivate_gcode dans une configuration \u00e0 extrudeurs multiples. [endstop_phase] \u00b6 Les commandes suivantes sont disponibles lorsqu'une section de configuration endstop_phase est activ\u00e9e (voir \u00e9galement le guide de la phase d'arr\u00eat ). ENDSTOP_PHASE_CALIBRATE \u00b6 ENDSTOP_PHASE_CALIBRATE [STEPPER=<config_name>] : Si aucun param\u00e8tre STEPPER n'est fourni, cette commande rapporte des statistiques sur les phases d'arr\u00eat du stepper pendant les pr\u00e9c\u00e9dentes op\u00e9rations de recherche d'origine. Lorsqu'un param\u00e8tre STEPPER est fourni, elle fait en sorte que le param\u00e8tre de phase de fin de course donn\u00e9 soit \u00e9crit dans le fichier de configuration (en lien avec la commande SAVE_CONFIG). [exclude_object] \u00b6 Les commandes suivantes sont disponibles lorsqu'une section de configuration exclude_object est activ\u00e9e (voir \u00e9galement le guide d'exclusion d'objet ) : EXCLUDE_OBJECT \u00b6 EXCLUDE_OBJECT [NAME=nom_objet] [CURRENT=1] [RESET=1] : Sans param\u00e8tres, cette commande renvoie une liste de tous les objets actuellement exclus. Lorsque le param\u00e8tre NAME est donn\u00e9, l'objet nomm\u00e9 sera exclu de l'impression. Lorsque le param\u00e8tre CURRENT est donn\u00e9, l'objet courant sera exclu de l'impression. Lorsque le param\u00e8tre RESET est donn\u00e9, la liste des objets exclus sera effac\u00e9e. De plus, inclure le param\u00e8tre NAME ne r\u00e9initialisera que l'objet nomm\u00e9. Cela peut provoquer des \u00e9checs d'impression, si des couches ont d\u00e9j\u00e0 \u00e9t\u00e9 omises. EXCLUDE_OBJECT_DEFINE \u00b6 EXCLUDE_OBJECT_DEFINE [NAME=nom_objet [CENTER=X,Y] [POLYGON=[[x,y],...]]] [RESET=1] [JSON=1] : Fournit le r\u00e9sum\u00e9 d'un objet dans le fichier. Sans param\u00e8tres fournis, ceci va lister les objets d\u00e9finis connus de Klipper. Retourne une liste de cha\u00eenes de caract\u00e8res, \u00e0 moins que le param\u00e8tre JSON soit donn\u00e9, auquel cas retournera les d\u00e9tails de l'objet au format json. Lorsque le param\u00e8tre NAME est inclus, cela d\u00e9finit un objet \u00e0 exclure. NAME : Ce param\u00e8tre est obligatoire. Il s'agit de l'identifiant utilis\u00e9 par les autres commandes de ce module. CENTER : Une coordonn\u00e9e X,Y pour l'objet. POLYGON : Un tableau de coordonn\u00e9es X,Y fournissant le contour d'un objet. Lorsque le param\u00e8tre RESET est fourni, tous les objets d\u00e9finis seront effac\u00e9s, et le module [exclude_object] sera r\u00e9initialis\u00e9. EXCLUDE_OBJECT_START \u00b6 EXCLUDE_OBJECT_START NAME=nom_objet : Cette commande prend un param\u00e8tre NAME et indique le d\u00e9but du gcode pour un objet sur la couche courante. EXCLUDE_OBJECT_END \u00b6 EXCLUDE_OBJECT_END [NAME=nom_objet] : Indique la fin du gcode de l'objet pour la couche. Il est associ\u00e9 \u00e0 EXCLUDE_OBJECT_START . Le param\u00e8tre NAME est optionnel, et n'avertira que si le nom fourni ne correspond au nom actuel. [extruder] \u00b6 Les commandes suivantes sont disponibles si une section configuration de l'extrudeuse est activ\u00e9e : ACTIVATE_EXTRUDER \u00b6 ACTIVATE_EXTRUDER EXTRUDER=<nom_de_la_configuration> : Dans une imprimante comportant plusieurs sections de configuration d' extrudeuse , cette commande s\u00e9lectionne la t\u00eate d'outil active. SET_PRESSURE_ADVANCE \u00b6 SET_PRESSURE_ADVANCE [EXTRUDER=<nom_de_la_configuration>] [ADVANCE=<avance_de_pression>] [SMOOTH_TIME=<dur\u00e9e_adoucissemt_avance_de_pression>] : D\u00e9finit les param\u00e8tres d'avance de pression du moteur d'extrudeuse (comme d\u00e9fini dans une section de configuration extrudeur ou extruder_stepper ). Si EXTRUDER n'est pas sp\u00e9cifi\u00e9, il s'agit par d\u00e9faut du stepper d\u00e9fini dans la t\u00eate d'outil active. SET_EXTRUDER_ROTATION_DISTANCE \u00b6 SET_EXTRUDER_ROTATION_DISTANCE EXTRUDER=<nom_config> [DISTANCE=<distance>] : D\u00e9finit une nouvelle valeur pour la \"distance de rotation\" du moteur de l'extrudeuse fournie (telle que d\u00e9finie dans une section de configuration extruder ou extruder_stepper ). Si la distance de rotation est un nombre n\u00e9gatif, le mouvement du moteur sera invers\u00e9 (par rapport \u00e0 la direction du moteur sp\u00e9cifi\u00e9e dans le fichier de configuration). Les param\u00e8tres modifi\u00e9s ne sont pas conserv\u00e9s lors de la r\u00e9initialisation de Klipper. Utilisez avec pr\u00e9caution car de petites modifications peuvent entra\u00eener une pression excessive entre l'extrudeuse et la t\u00eate de l'outil. Effectuez un calibrage correct avec le filament avant de l'utiliser. Si la valeur 'DISTANCE' n'est pas fournie, cette commande renvoie la distance de rotation actuelle. SYNC_EXTRUDER_MOTION \u00b6 SYNC_EXTRUDER_MOTION EXTRUDER=<nom> MOTION_QUEUE=<nom> : Cette commande permet de synchroniser le moteur d'entra\u00eenement sp\u00e9cifi\u00e9 par EXTRUDER (tel que d\u00e9fini dans la section de configuration extruder ou extruder_stepper avec le mouvement d'un extrudeur sp\u00e9cifi\u00e9 par MOTION_QUEUE (tel que d\u00e9fini dans la section de configuration extruder ). Si MOTION_QUEUE est une cha\u00eene vide, le stepper sera d\u00e9synchronis\u00e9 de tout mouvement d'extrudeuse. SET_EXTRUDER_STEP_DISTANCE \u00b6 Cette commande est obsol\u00e8te et sera supprim\u00e9e dans un avenir proche. SYNC_STEPPER_TO_EXTRUDER \u00b6 Cette commande est obsol\u00e8te et sera supprim\u00e9e dans un avenir proche. [fan_generic] \u00b6 La commande suivante est disponible lorsqu'une section fan_generic config est activ\u00e9e. SET_FAN_SPEED \u00b6 SET_FAN_SPEED FAN=nom_config SPEED=<vitesse> Cette commande d\u00e9finit la vitesse d'un ventilateur. La valeur de \"vitesse\" doit \u00eatre comprise entre 0,0 et 1,0. [filament_switch_sensor] \u00b6 La commande suivante est disponible lorsqu'une section de configuration filament_switch_sensor ou filament_motion_sensor est activ\u00e9e. QUERY_FILAMENT_SENSOR \u00b6 QUERY_FILAMENT_SENSOR SENSOR=<nom_du_capteur> : Interroge l'\u00e9tat actuel du capteur de filament. Les donn\u00e9es affich\u00e9es sur le terminal d\u00e9pendront du type de capteur d\u00e9fini dans la configuration. SET_FILAMENT_SENSOR \u00b6 SET_FILAMENT_SENSOR SENSOR=<nom_du_capteur> ENABLE=[0|1] : Active/d\u00e9sactive le d\u00e9tecteur de filament. Si ENABLE est r\u00e9gl\u00e9 sur 0, le d\u00e9tecteur de filament est d\u00e9sactiv\u00e9, s'il est r\u00e9gl\u00e9 sur 1, il est activ\u00e9. [firmware_retraction] \u00b6 Les commandes G-Code standard suivantes sont disponibles lorsque la section de configuration firmware_retraction est activ\u00e9e. Ces commandes vous permettent d'utiliser la fonction de r\u00e9traction du micrologiciel disponible dans de nombreux trancheurs, afin de r\u00e9duire le cordage pendant les d\u00e9placements sans extrusion d'une partie de l'impression \u00e0 une autre. Une configuration appropri\u00e9e de l'avance \u00e0 la pression r\u00e9duit la longueur de r\u00e9traction requise. G10 : R\u00e9tracte l'extrudeur en utilisant les param\u00e8tres actuellement configur\u00e9s. G11 : D\u00e9tache l'extrudeur en utilisant les param\u00e8tres actuellement configur\u00e9s. Les commandes suppl\u00e9mentaires suivantes sont \u00e9galement disponibles. SET_RETRACTION \u00b6 SET_RETRACTION [RETRACT_LENGTH=<mm>] [RETRACT_SPEED=<mm/s>] [UNRETRACT_EXTRA_LENGTH=<mm>] [UNRETRACT_SPEED=<mm/s>] : Ajuste les param\u00e8tres utilis\u00e9s par la r\u00e9traction du micrologiciel. RETRACT_LENGTH d\u00e9termine la longueur de filament \u00e0 r\u00e9tracter et \u00e0 d\u00e9r\u00e9tracter. La vitesse de r\u00e9traction est ajust\u00e9e via RETRACT_SPEED, et est g\u00e9n\u00e9ralement r\u00e9gl\u00e9e relativement haut. La vitesse de d\u00e9stratification est ajust\u00e9e via UNRETRACT_SPEED, et n'est pas particuli\u00e8rement critique, bien que souvent inf\u00e9rieure \u00e0 RETRACT_SPEED. Dans certains cas, il est utile d'ajouter une petite quantit\u00e9 de longueur suppl\u00e9mentaire lors de la d\u00e9r\u00e9traction, et ceci est r\u00e9gl\u00e9 via UNRETRACT_EXTRA_LENGTH. SET_RETRACTION est g\u00e9n\u00e9ralement d\u00e9fini dans le cadre de la configuration du slicer par filament, car les diff\u00e9rents filaments n\u00e9cessitent des param\u00e8tres diff\u00e9rents. GET_RETRACTION \u00b6 GET_RETRACTION : Interroge les param\u00e8tres actuellement utilis\u00e9s pour la r\u00e9traction du firmware et les affiche sur le terminal. [force_move] \u00b6 Le module force_move est automatiquement charg\u00e9, mais certaines commandes n\u00e9cessitent de d\u00e9finir enable_force_move dans la configuration de l'imprimante . STEPPER_BUZZ \u00b6 STEPPER_BUZZ STEPPER=<nom_de_la_configuration> : D\u00e9place le moteur donn\u00e9 en avant d'un mm puis en arri\u00e8re d'un mm, r\u00e9p\u00e9t\u00e9 10 fois. Il s'agit d'un outil de diagnostic permettant de v\u00e9rifier la connectivit\u00e9 du moteur. FORCE_MOVE \u00b6 FORCE_MOVE STEPPER=<nom_de_la_configuration> DISTANCE=<valeur> VELOCITE=<valeur> [ACCEL=<valeur>] : Cette commande forcera le d\u00e9placement du stepper donn\u00e9 sur la distance donn\u00e9e (en mm) \u00e0 la vitesse constante donn\u00e9e (en mm/s). Si ACCEL est sp\u00e9cifi\u00e9 et est sup\u00e9rieur \u00e0 z\u00e9ro, alors l'acc\u00e9l\u00e9ration donn\u00e9e (en mm/s^2) sera utilis\u00e9e ; sinon, aucune acc\u00e9l\u00e9ration n'est effectu\u00e9e. Aucune v\u00e9rification des limites n'est effectu\u00e9e ; aucune mise \u00e0 jour cin\u00e9matique n'est faite ; les autres steppers parall\u00e8les sur un axe ne seront pas d\u00e9plac\u00e9s. Soyez prudent car une commande incorrecte pourrait endommager le mat\u00e9riel ! L'utilisation de cette commande placera presque certainement la cin\u00e9matique de bas niveau dans un \u00e9tat incorrect ; \u00e9mettez ensuite un G28 pour r\u00e9initialiser la cin\u00e9matique. Cette commande est destin\u00e9e aux diagnostics de bas niveau et au d\u00e9bogage. SET_KINEMATIC_POSITION \u00b6 SET_KINEMATIC_POSITION [X=<value>] [Y=<value>] [Z=<value>] : Force le code cin\u00e9matique de bas niveau \u00e0 croire que la t\u00eate d'outil est \u00e0 la position cart\u00e9sienne donn\u00e9e. Il s'agit d'une commande de diagnostic et de d\u00e9bogage ; utilisez SET_GCODE_OFFSET et/ou G92 pour des transformations d'axe r\u00e9guli\u00e8res. Si un axe n'est pas sp\u00e9cifi\u00e9, la position par d\u00e9faut sera celle de la derni\u00e8re commande de la t\u00eate. La d\u00e9finition d'une position incorrecte ou invalide peut entra\u00eener des erreurs logicielles internes. Cette commande peut invalider les futures v\u00e9rifications de limites ; \u00e9mettez ensuite un G28 pour r\u00e9initialiser la cin\u00e9matique. [gcode] \u00b6 Le module gcode est automatiquement charg\u00e9. RESTART \u00b6 RESTART : Cette commande permet au logiciel h\u00f4te de recharger sa configuration et d'effectuer une r\u00e9initialisation interne. Cette commande n'efface pas l'\u00e9tat d'erreur du micro-contr\u00f4leur (voir FIRMWARE_RESTART) et ne charge pas de nouveau logiciel (voir la FAQ ). FIRMWARE_RESTART \u00b6 FIRMWARE_RESTART : Cette commande est similaire \u00e0 un RESTART, mais elle efface \u00e9galement tout \u00e9tat d'erreur du micro-contr\u00f4leur. STATUS \u00b6 STATUS : Indique l'\u00e9tat du logiciel de l'h\u00f4te Klipper. HELP \u00b6 HELP : Affiche la liste des commandes G-Code \u00e9tendues disponibles. [gcode_arcs] \u00b6 Les commandes G-Code standard suivantes sont disponibles si une section gcode_arcs config est activ\u00e9e : D\u00e9placement d'un arc dans le sens des aiguilles d'une montre (G2), d\u00e9placement d'un arc dans le sens inverse des aiguilles d'une montre (G3) : G2|G3 [X<pos>] [Y<pos>] [Z<pos>] [E<pos>] [F<speed>] I<value> J<value>|I<value> K<value>|J<value> K<value> S\u00e9lection du plan de l'arc : G17 (plan XY), G18 (plan XZ), G19 (plan YZ) [gcode_macro] \u00b6 La commande suivante est disponible lorsqu'une section de configuration gcode_macro est activ\u00e9e (voir \u00e9galement le guide des mod\u00e8les de commande ). SET_GCODE_VARIABLE \u00b6 SET_GCODE_VARIABLE MACRO=<macro_name> VARIABLE=<name> VALUE=<value> : Cette commande permet de changer la valeur d'une variable gcode_macro au moment de l'ex\u00e9cution. La valeur fournie est analys\u00e9e comme un litt\u00e9ral Python. [gcode_move] \u00b6 Le module gcode_move est automatiquement charg\u00e9. GET_POSITION \u00b6 GET_POSITION : Retourne les informations de l'emplacement actuel de la t\u00eate d'outil. Voir la documentation du d\u00e9veloppeur de restitution de GET_POSITION pour plus d'informations. SET_GCODE_OFFSET \u00b6 SET_GCODE_OFFSET [X=<pos>|X_ADJUST=<adjust>] [Y=<pos>|Y_ADJUST=<adjust>] [Z=<pos>|Z_ADJUST=<adjust>] [MOVE=1 [MOVE_SPEED=<speed>]] : D\u00e9finit un d\u00e9calage positionnel \u00e0 appliquer aux futures commandes G-Code. Ceci est g\u00e9n\u00e9ralement utilis\u00e9 pour changer virtuellement le d\u00e9calage Z du bed ou pour d\u00e9finir les d\u00e9calages XY des buses lors du changement d'extrudeur. Par exemple, si \"SET_GCODE_OFFSET Z=0.2\" est donn\u00e9, les prochains mouvements G-Code auront 0,2mm ajout\u00e9 \u00e0 leur hauteur Z. Si les param\u00e8tres de style X_ADJUST sont utilis\u00e9s, l'ajustement sera ajout\u00e9 \u00e0 tout d\u00e9calage existant (par exemple, \"SET_GCODE_OFFSET Z=-0.2\" suivi de \"SET_GCODE_OFFSET Z_ADJUST=0.3\" donnerait un d\u00e9calage Z total de 0.1). Si \"MOVE=1\" est sp\u00e9cifi\u00e9, un d\u00e9placement de la t\u00eate d'outil sera effectu\u00e9 pour appliquer le d\u00e9calage donn\u00e9 (sinon le d\u00e9calage prendra effet lors du prochain d\u00e9placement absolu en G-code qui sp\u00e9cifie l'axe donn\u00e9). Si \"MOVE_SPEED\" est sp\u00e9cifi\u00e9, le d\u00e9placement de la t\u00eate d'outil sera effectu\u00e9 avec la vitesse donn\u00e9e (en mm/s) ; sinon, le d\u00e9placement de la t\u00eate d'outil utilisera la derni\u00e8re vitesse G-Code sp\u00e9cifi\u00e9e. SAVE_GCODE_STATE \u00b6 SAVE_GCODE_STATE [NAME=<nom_de_l'\u00e9tat>] : Sauvegarde l'\u00e9tat actuel de l'analyse des coordonn\u00e9es du g-code. La sauvegarde et le r\u00e9tablissement de l'\u00e9tat du g-code sont utiles dans les scripts et les macros. Cette commande enregistre le mode actuel de coordonn\u00e9es absolues en g-code (G90/G91), le mode d'extrusion absolue (M82/M83), l'origine (G92), le d\u00e9calage (SET_GCODE_OFFSET), la priorit\u00e9 de vitesse (M220), la priorit\u00e9 d'extrusion (M221), la vitesse de d\u00e9placement, la position XYZ actuelle et la position relative de l'extrudeuse \"E\". Si NOM est fourni, cela permet de nommer l'\u00e9tat sauvegard\u00e9 avec la cha\u00eene de caract\u00e8res donn\u00e9e. Si le NOM n'est pas fourni, la valeur par d\u00e9faut est \"default\". RESTORE_GCODE_STATE \u00b6 RESTORE_GCODE_STATE [NAME=<nom_de_l'\u00e9tat>] [MOVE=1 [MOVE_SPEED=<speed>]] : Restaure un \u00e9tat pr\u00e9c\u00e9demment sauvegard\u00e9 via SAVE_GCODE_STATE. Si \"MOVE=1\" est sp\u00e9cifi\u00e9, un d\u00e9placement de la t\u00eate d'outil sera effectu\u00e9 pour revenir \u00e0 la position XYZ pr\u00e9c\u00e9dente. Si \"MOVE_SPEED\" est sp\u00e9cifi\u00e9, alors le d\u00e9placement de la t\u00eate d'outil sera effectu\u00e9 avec la vitesse donn\u00e9e (en mm/s) ; sinon, le d\u00e9placement de la t\u00eate d'outil utilisera la vitesse du G-Code restaur\u00e9. [hall_filament_width_sensor] \u00b6 Les commandes suivantes sont disponibles lorsque la section de configuration tsl1401cl filament width sensor ou hall filament width sensor est activ\u00e9e (voir \u00e9galement TSLl401CL Filament Width Sensor et Hall Filament Width Sensor ) : QUERY_FILAMENT_WIDTH \u00b6 QUERY_FILAMENT_WIDTH : Renvoie la largeur actuelle du filament mesur\u00e9. RESET_FILAMENT_WIDTH_SENSOR \u00b6 RESET_FILAMENT_WIDTH_SENSOR : Efface toutes les lectures du capteur. Utile apr\u00e8s un changement de filament. DISABLE_FILAMENT_WIDTH_SENSOR \u00b6 DISABLE_FILAMENT_WIDTH_SENSOR : D\u00e9sactiver le capteur de largeur de filament et arr\u00eater de l'utiliser pour le contr\u00f4le du flux. ENABLE_FILAMENT_WIDTH_SENSOR \u00b6 ENABLE_FILAMENT_WIDTH_SENSOR : Activez le capteur de largeur de filament et commencez \u00e0 l'utiliser pour le contr\u00f4le du flux. QUERY_RAW_FILAMENT_WIDTH \u00b6 QUERY_RAW_FILAMENT_WIDTH : Renvoie les lectures actuelles des canaux ADC et la valeur RAW du capteur des points de calibration. ENABLE_FILAMENT_WIDTH_LOG \u00b6 ENABLE_FILAMENT_WIDTH_LOG : Activer la journalisation du diam\u00e8tre. DISABLE_FILAMENT_WIDTH_LOG \u00b6 DISABLE_FILAMENT_WIDTH_LOG : D\u00e9sactiver la journalisation du diam\u00e8tre. [heaters] \u00b6 Le module chauffages est automatiquement charg\u00e9 si un chauffage est d\u00e9fini dans le fichier de configuration. TURN_OFF_HEATERS \u00b6 TURN_OFF_HEATERS : \u00c9teindre tous les chauffages. TEMPERATURE_WAIT \u00b6 TEMPERATURE_WAIT SENSOR=<nom_config> [MINIMUM=<cible>] [MAXIMUM=<cible>] : Attend jusqu'\u00e0 ce que le capteur de temp\u00e9rature donn\u00e9 soit \u00e0 ou au-dessus du MINIMUM fourni et/ou \u00e0 ou en dessous du MAXIMUM fourni. SET_HEATER_TEMPERATURE \u00b6 SET_HEATER_TEMPERATURE HEATER=<nom_du_chauffeur> [TARGET=<temp\u00e9rature_cible>] : D\u00e9finit la temp\u00e9rature cible d'un \u00e9l\u00e9ment chauffant. Si une temp\u00e9rature cible n'est pas fournie, la cible est 0. [idle_timeout] \u00b6 Le module idle_timeout est automatiquement charg\u00e9. SET_IDLE_TIMEOUT \u00b6 SET_IDLE_TIMEOUT [TIMEOUT=<timeout>] : Permet \u00e0 l'utilisateur de d\u00e9finir le d\u00e9lai d'inactivit\u00e9 (en secondes). [input_shaper] \u00b6 La commande suivante est activ\u00e9e si une section de configuration input_shaper a \u00e9t\u00e9 activ\u00e9e (voir \u00e9galement le guide de compensation de r\u00e9sonance ). SET_INPUT_SHAPER \u00b6 SET_INPUT_SHAPER [SHAPER_FREQ_X=<shaper_freq_x>] [SHAPER_FREQ_Y=<shaper_freq_y>] [DAMPING_RATIO_X=<damping_ratio_x>] [DAMPING_RATIO_Y=<damping_ratio_y>] [SHAPER_TYPE=<shaper>] [SHAPER_TYPE_X=<shaper_type_x>] [SHAPER_TYPE_Y=<shaper_type_y>] : Modifie les param\u00e8tres de mise en forme d'entr\u00e9e. Notez que le param\u00e8tre SHAPER_TYPE r\u00e9initialise le shaper d'entr\u00e9e pour les axes X et Y m\u00eame si diff\u00e9rents types de shaper ont \u00e9t\u00e9 configur\u00e9s dans la section [input_shaper]. SHAPER_TYPE ne peut pas \u00eatre utilis\u00e9 avec l'un des param\u00e8tres SHAPER_TYPE_X et SHAPER_TYPE_Y. Voir config reference pour plus de d\u00e9tails sur chacun de ces param\u00e8tres. [manual_probe] \u00b6 Le module manual_probe est automatiquement charg\u00e9. MANUAL_PROBE \u00b6 MANUAL_PROBE [SPEED=<speed>] : Ex\u00e9cute un script d'aide servant \u00e0 mesurer la hauteur de la buse \u00e0 un point donn\u00e9. Si SPEED est sp\u00e9cifi\u00e9, il d\u00e9finit la vitesse des commandes TESTZ (la valeur par d\u00e9faut est 5mm/s). Pendant un sondage manuel, les commandes suppl\u00e9mentaires suivantes sont disponibles : ACCEPT : Cette commande valide la position Z actuelle et met fin au sondage manuel. ABORT : Cette commande interrompt le sondage manuel. TESTZ Z=<valeur> : Cette commande d\u00e9place la buse vers le haut ou vers le bas de la quantit\u00e9 sp\u00e9cifi\u00e9e dans \"valeur\". Par exemple, TESTZ Z=-.1 d\u00e9placera la buse vers le bas de 0,1mm tandis que TESTZ Z=.1 d\u00e9placera la buse vers le haut de 0,1mm. La valeur peut \u00e9galement \u00eatre + , - , ++ , ou -- pour d\u00e9placer la buse vers le haut ou vers le bas d'une quantit\u00e9 relative aux tentatives pr\u00e9c\u00e9dentes. Z_ENDSTOP_CALIBRATE \u00b6 Z_ENDSTOP_CALIBRATE [SPEED=<vitesse>] : Ex\u00e9cute un script d'assistance utile pour calibrer un param\u00e8tre de configuration de la position Z_endstop. Voir la commande MANUAL_PROBE pour plus de d\u00e9tails sur les param\u00e8tres et les commandes suppl\u00e9mentaires disponibles lorsque l'outil est actif. Z_OFFSET_APPLY_ENDSTOP \u00b6 Z_OFFSET_APPLY_ENDSTOP : Prend le d\u00e9calage actuel du Gcode Z (alias, babystepping), et le soustrait de la position endstop_position d\u00e9finie dans stepper_z. Ceci permet de prendre une valeur de babystepping fr\u00e9quemment utilis\u00e9e, et de la rendre permanente. N\u00e9cessite un SAVE_CONFIG pour prendre effet. [manual_stepper] \u00b6 La commande suivante est disponible lorsqu'une section manual_stepper config est activ\u00e9e. MANUAL_STEPPER \u00b6 MANUAL_STEPPER STEPPER=nom_du_config [ENABLE=[0|1]]] [SET_POSITION=<pos>] [SPEED=<speed>] [ACCEL=<accel>] [MOVE=<pos> [STOP_ON_ENDSTOP=[1|2|-1|-2]] [SYNC=0]] : Cette commande modifie l'\u00e9tat du stepper. Utilisez le param\u00e8tre ENABLE pour activer/d\u00e9sactiver le stepper. Utilisez le param\u00e8tre SET_POSITION pour forcer le moteur pas \u00e0 pas \u00e0 penser qu'il se trouve \u00e0 la position donn\u00e9e. Utilisez le param\u00e8tre MOVE pour d\u00e9placer vers la position donn\u00e9e. Si SPEED et/ou ACCEL sont sp\u00e9cifi\u00e9s, les valeurs donn\u00e9es seront utilis\u00e9es \u00e0 la place de celles par d\u00e9faut issues du fichier de configuration. Si un ACCEL de z\u00e9ro est sp\u00e9cifi\u00e9, aucune acc\u00e9l\u00e9ration ne sera effectu\u00e9e. Si STOP_ON_ENDSTOP=1 est sp\u00e9cifi\u00e9, le d\u00e9placement se terminera pr\u00e9matur\u00e9ment si la fin de course est d\u00e9clench\u00e9e (utilisez STOP_ON_ENDSTOP=2 pour terminer le d\u00e9placement sans erreur m\u00eame si la fin de course n'est pas d\u00e9clench\u00e9e, utilisez -1 ou -2 pour s'arr\u00eater lorsque la fin de course n'est pas d\u00e9clench\u00e9e). Normalement, les futures commandes G-Code seront programm\u00e9es pour \u00eatre ex\u00e9cut\u00e9es apr\u00e8s la fin du d\u00e9placement de la commande de pas, mais si un d\u00e9placement manuel de la commande de pas utilise SYNC=0, les futures commandes de d\u00e9placement G-Code peuvent \u00eatre ex\u00e9cut\u00e9es en parall\u00e8le avec le d\u00e9placement de la commande de pas. [mcp4018] \u00b6 La commande suivante est disponible lorsqu'une section mcp4018 config est activ\u00e9e. SET_DIGIPOT \u00b6 SET_DIGIPOT DIGIPOT=config_name WIPER=<valeur> : Cette commande change la valeur actuelle du digipot. Cette valeur devrait typiquement \u00eatre comprise entre 0.0 et 1.0, \u00e0 moins qu'une '\u00e9chelle' soit d\u00e9finie dans la configuration. Lorsque 'scale' est d\u00e9fini, alors cette valeur doit \u00eatre comprise entre 0.0 et 'scale'. [led] \u00b6 La commande suivante est disponible lorsque l'une des sections led config est activ\u00e9e. SET_LED \u00b6 SET_LED LED=<nom_de_la_configuration> RED=<valeur> GREEN=<valeur> BLUE=<valeur> WHITE=<valeur> [INDEX=<index>] [TRANSMIT=0] [SYNC=1] : Ceci d\u00e9finit la sortie de la LED. Chaque <valeur> de couleur doit \u00eatre comprise entre 0.0 et 1.0. L'option WHITE n'est valable que pour les LEDs RGBW. Si la LED supporte plusieurs puces dans une cha\u00eene, on peut sp\u00e9cifier INDEX pour modifier la couleur de la seule puce donn\u00e9e (1 pour la premi\u00e8re puce, 2 pour la seconde, etc.). Si INDEX n'est pas sp\u00e9cifi\u00e9, alors toutes les LEDs de la cha\u00eene seront r\u00e9gl\u00e9es sur la couleur fournie. Si TRANSMIT=0 est sp\u00e9cifi\u00e9, le changement de couleur ne sera effectu\u00e9 que lors de la prochaine commande SET_LED qui ne sp\u00e9cifie pas TRANSMIT=0 ; cela peut \u00eatre utile en combinaison avec le param\u00e8tre INDEX pour effectuer plusieurs mises \u00e0 jour dans une cha\u00eene. Par d\u00e9faut, la commande SET_LED synchronisera ses changements avec les autres commandes gcode en cours. Cela peut conduire \u00e0 un comportement ind\u00e9sirable si les LEDs sont r\u00e9gl\u00e9es alors que l'imprimante n'imprime pas, car cela r\u00e9initialisera le d\u00e9lai d'inactivit\u00e9. Si un timing pr\u00e9cis n'est pas n\u00e9cessaire, le param\u00e8tre optionnel SYNC=0 peut \u00eatre sp\u00e9cifi\u00e9 pour appliquer les changements sans r\u00e9initialiser le d\u00e9lai d'inactivit\u00e9. SET_LED_TEMPLATE \u00b6 SET_LED_TEMPLATE LED=<nom_de_la_led> TEMPLATE=<nom_du_mod\u00e8le> [<param_x>=<literal>] [INDEX=<index>] : Attribue un mod\u00e8le d'affichage \u00e0 une LED donn\u00e9e. Par exemple, si l'on d\u00e9finit une section de configuration [display_template my_led_template] , on peut affecter TEMPLATE=my_led_template ici. Le mod\u00e8le d'affichage doit produire une cha\u00eene de caract\u00e8res s\u00e9par\u00e9e par des virgules contenant quatre nombres \u00e0 virgule flottante correspondant aux param\u00e8tres de couleur rouge, vert, bleu et blanc. Le mod\u00e8le sera continuellement \u00e9valu\u00e9 et la LED sera automatiquement r\u00e9gl\u00e9e sur les couleurs r\u00e9sultantes. On peut d\u00e9finir des param\u00e8tres display_template \u00e0 utiliser pendant l'\u00e9valuation du mod\u00e8le (les param\u00e8tres seront analys\u00e9s comme des litt\u00e9raux Python). Si INDEX n'est pas sp\u00e9cifi\u00e9, alors toutes les puces dans la cha\u00eene de la LED seront r\u00e9gl\u00e9es sur le mod\u00e8le, sinon seule la puce avec l'index donn\u00e9 sera mise \u00e0 jour. Si TEMPLATE est une cha\u00eene vide, cette commande effacera tout mod\u00e8le pr\u00e9c\u00e9dent assign\u00e9 \u00e0 la LED (on peut alors utiliser les commandes SET_LED pour g\u00e9rer les param\u00e8tres de couleur de la LED). [output_pin] \u00b6 La commande suivante est disponible lorsqu'une section output_pin config est activ\u00e9e. SET_PIN \u00b6 SET_PIN PIN=config_name VALUE=<value> [CYCLE_TIME=<cycle_time>] : Set the pin to the given output VALUE . VALUE should be 0 or 1 for \"digital\" output pins. For PWM pins, set to a value between 0.0 and 1.0, or between 0.0 and scale if a scale is configured in the output_pin config section. Some pins (currently only \"soft PWM\" pins) support setting an explicit cycle time using the CYCLE_TIME parameter (specified in seconds). Note that the CYCLE_TIME parameter is not stored between SET_PIN commands (any SET_PIN command without an explicit CYCLE_TIME parameter will use the cycle_time specified in the output_pin config section). [palette2] \u00b6 Les commandes suivantes sont disponibles lorsque la section palette2 config est activ\u00e9e. Les impressions avec Palette fonctionnent en int\u00e9grant des OCodes (Omega Codes) sp\u00e9ciaux dans le fichier GCode : O1 ... O32 : Ces codes sont lus \u00e0 partir du flux GCode, trait\u00e9s par ce module et transmis au dispositif Palette 2. Les commandes suppl\u00e9mentaires suivantes sont \u00e9galement disponibles. PALETTE_CONNECT \u00b6 PALETTE_CONNECT : Cette commande initie la connexion avec Palette 2. PALETTE_DISCONNECT \u00b6 PALETTE_DISCONNECT : Cette commande permet de se d\u00e9connecter de Palette 2. PALETTE_CLEAR \u00b6 PALETTE_CLEAR : Cette commande demande \u00e0 Palette 2 de purger le filament de tous les chemins d'entr\u00e9e et de sortie. PALETTE_CUT \u00b6 PALETTE_CUT : Cette commande demande \u00e0 Palette 2 de couper le filament actuellement charg\u00e9 dans le noyau de jonction. PALETTE_SMART_LOAD \u00b6 PALETTE_SMART_LOAD : cette commande initialise la s\u00e9quence de chargement intelligente sur Palette 2. Le filament est charg\u00e9 automatiquement en l\u2019extrudant sur la distance calibr\u00e9e sur l\u2019appareil pour l\u2019imprimante, et l'indique \u00e0 Palette 2 une fois le chargement termin\u00e9. Cette commande revient \u00e0 appuyer sur Smart Load directement sur l\u2019\u00e9cran Palette 2 une fois l'insertion du filament faite. [pid_calibrate] \u00b6 Le module pid_calibrate est automatiquement charg\u00e9 si un chauffage est d\u00e9fini dans le fichier de configuration. PID_CALIBRATE \u00b6 PID_CALIBRATE HEATER=<config_name> TARGET=<temperature> [WRITE_FILE=1] : Effectuer un test d\u2019\u00e9talonnage PID. Le chauffage demand\u00e9 sera activ\u00e9 jusqu\u2019\u00e0 ce que la temp\u00e9rature d\u00e9finie soit atteinte, il s'\u00e9teindra et se rallumera durant plusieurs cycles. Si le param\u00e8tre WRITE_FILE est activ\u00e9, le fichier /tmp/heattest.txt sera cr\u00e9\u00e9 avec un journal de tous les \u00e9chantillons de temp\u00e9rature mesur\u00e9s pendant le test. [pause_resume] \u00b6 Les commandes suivantes sont disponibles lorsque la section pause_resume config est activ\u00e9e : PAUSE \u00b6 PAUSE : suspend l\u2019impression en cours. La position actuelle est enregistr\u00e9e pour reprendre lorsque demand\u00e9. RESUME \u00b6 RESUME [VELOCITY=<value>] : Reprend l'impression \u00e0 la suite d'une pause, en r\u00e9tablissant d'abord la position captur\u00e9e pr\u00e9c\u00e9demment. Le param\u00e8tre VELOCITY d\u00e9termine la vitesse \u00e0 laquelle l'outil doit revenir \u00e0 la position captur\u00e9e d'origine. CLEAR_PAUSE \u00b6 CLEAR_PAUSE : Supprime la mise en pause actuelle sans reprendre l'impression. Ceci est utile si l'on d\u00e9cide d'interrompre une impression apr\u00e8s une PAUSE. Il est recommand\u00e9 d'ajouter ceci \u00e0 votre gcode de d\u00e9marrage pour s'assurer que l'\u00e9tat de pause est r\u00e9initialis\u00e9 pour chaque impression. CANCEL_PRINT \u00b6 CANCEL_PRINT : Annule l'impression en cours. [print_stats] \u00b6 Le module print_stats est automatiquement charg\u00e9. SET_PRINT_STATS_INFO \u00b6 SET_PRINT_STATS_INFO [TOTAL_LAYER=<nombre_total_de_couches>] [CURRENT_LAYER= <couche_actuelle>] : Passe les informations du trancheur comme le nombre total de couches et celle actuellement en cours \u00e0 Klipper. Ajoutez SET_PRINT_STATS_INFO [TOTAL_LAYER=<nombre_total_de_couches>] \u00e0 votre section gcode de d\u00e9but du trancheur et SET_PRINT_STATS_INFO [CURRENT_LAYER= <couche_actuelle>] \u00e0 la section gcode de changement de couche pour passer les informations de couche de votre trancheur \u00e0 Klipper. [probe] \u00b6 Les commandes suivantes sont disponibles lorsqu'une section probe config ou bltouch config est activ\u00e9e (voir \u00e9galement le guide d'\u00e9talonnage de la sonde ). PROBE \u00b6 PROBE [PROBE_SPEED=<mm/s>] [LIFT_SPEED=<mm/s>] [SAMPLES=<count>] [SAMPLE_RETRACT_DIST=<mm>] [SAMPLES_TOLERANCE=<mm>] [SAMPLES_TOLERANCE_RETRIES=<count>] [SAMPLES_RESULT=median|average] : D\u00e9place la buse vers le bas jusqu'\u00e0 ce que le palpeur se d\u00e9clenche. Si l'un des param\u00e8tres facultatifs est fourni, il remplace son param\u00e8tre \u00e9quivalent dans la section configuration de la sonde . QUERY_PROBE \u00b6 QUERY_PROBE : Retourne l'\u00e9tat actuel de la sonde (\"triggered\" ou \"open\"). PROBE_ACCURACY \u00b6 PROBE_ACCURACY [PROBE_SPEED=<mm/s>] [SAMPLES=<count>] [SAMPLE_RETRACT_DIST=<mm>] : Calculer le maximum, le minimum, la moyenne, la m\u00e9diane et l\u2019\u00e9cart type des \u00e9chantillons des multiples palpeurs. Par d\u00e9faut, 10 \u00c9CHANTILLONS sont pr\u00e9lev\u00e9s. Sinon, les param\u00e8tres optionnels peuvent \u00eatre d\u00e9finis dans la section de configuration du palpeur. PROBE_CALIBRATE \u00b6 PROBE_CALIBRATE [SPEED=<speed>] [<probe_parameter>=<value>] : Ex\u00e9cute l'assistant servant \u00e0 calibrer le z_offset du palpeur. Consultez la commande PROBE pour plus d\u2019informations sur les param\u00e8tres optionnels du palpeur. Reportez-vous \u00e0 la commande MANUAL_PROBE pour plus d\u2019informations sur le param\u00e8tre SPEED et les commandes suppl\u00e9mentaires disponibles lorsque l'assistant est actif. Veuillez noter que la commande PROBE_CALIBRATE utilise la variable de vitesse pour se d\u00e9placer dans la direction XY ainsi que dans Z. Z_OFFSET_APPLY_PROBE \u00b6 Z_OFFSET_APPLY_PROBE : Prend le d\u00e9calage actuel du Gcode Z (alias, babystepping), et le soustrait du z_offset de la sonde. Cela permet de prendre une valeur de babystepping fr\u00e9quemment utilis\u00e9e, et de la rendre permanente. N\u00e9cessite un SAVE_CONFIG pour prendre effet. [query_adc] \u00b6 Le module query_adc est automatiquement charg\u00e9. QUERY_ADC \u00b6 QUERY_ADC [NAME=<nom_de_la_configuration>] [PULLUP=<valeur>] : Rapporte la derni\u00e8re valeur analogique re\u00e7ue pour une broche analogique donn\u00e9e. Si NAME n'est pas fourni, la liste des noms d'adc disponibles est retourn\u00e9e. Si PULLUP est fourni (comme une valeur en Ohms), la valeur analogique brute ainsi que la r\u00e9sistance \u00e9quivalente relative \u00e0 ce pullup est retourn\u00e9e. [query_endstops] \u00b6 Le module query_endstops est automatiquement charg\u00e9. Les commandes G-Code standard suivantes sont actuellement disponibles, mais leur utilisation n'est pas recommand\u00e9e : Obtenir le statut Fin de course : M119 (Utilisez QUERY_ENDSTOPS \u00e0 la place.) QUERY_ENDSTOPS \u00b6 QUERY_ENDSTOPS : Teste les but\u00e9es d'axe et indique si elles sont \"d\u00e9clench\u00e9es\" ou dans un \u00e9tat \"ouvert\". Cette commande est g\u00e9n\u00e9ralement utilis\u00e9e pour v\u00e9rifier qu'un butoir de fin de course fonctionne correctement. [resonance_tester] \u00b6 Les commandes suivantes sont disponibles lorsqu'une section configuration du testeur de r\u00e9sonances est activ\u00e9e (voir \u00e9galement le guide de mesure des r\u00e9sonances ). MEASURE_AXES_NOISE \u00b6 MEASURE_AXES_NOISE : Mesure et affiche le bruit pour tous les axes de toutes les puces acc\u00e9l\u00e9rom\u00e9triques activ\u00e9es. TEST_RESONANCES \u00b6 TEST_RESONANCES AXE=<axe> OUTPUT=<resonances,raw_data> [NOM=<nom>] [FREQ_START=<freq_min>] [FREQ_END=<freq_max>] [HZ_PER_SEC=<hz_par_sec>] [CHIPS=<nom_puce_adxl345>] [POINT=x,y,z] [INPUT_SHAPING=[<0:1>]] : Ex\u00e9cute le test de r\u00e9sonance dans tous les points de sonde configur\u00e9s pour l'\"axe\" demand\u00e9 et mesure l'acc\u00e9l\u00e9ration en utilisant les puces acc\u00e9l\u00e9rom\u00e9tres configur\u00e9es pour l'axe respectif. L'\"axe\" peut \u00eatre X ou Y, ou sp\u00e9cifier une direction arbitraire comme AXIS=dx,dy , o\u00f9 dx et dy sont des nombres \u00e0 virgule flottante d\u00e9finissant un vecteur de direction (par exemple, AXIS=X , AXIS=Y , ou AXIS=1,-1 pour d\u00e9finir une direction diagonale). Notez que AXIS=dx,dy et AXIS=-dx,-dy sont \u00e9quivalents. nom_puce_adxl345 peut \u00eatre une ou plusieurs puces adxl345 configur\u00e9es, d\u00e9limit\u00e9es par des virgules, par exemple CHIPS=\"adxl345, adxl345 rpi\" . Notez que le terme adxl345 peut \u00eatre omis pour les puces adxl345 nomm\u00e9es. Si POINT est indiqu\u00e9, il remplacera le(s) point(s) configur\u00e9(s) dans [resonance_tester] . Si INPUT_SHAPING=0 ou non d\u00e9fini (par d\u00e9faut), d\u00e9sactive la mise en forme de l'entr\u00e9e pour le test de r\u00e9sonance, car il n'est pas valide d'ex\u00e9cuter le test de r\u00e9sonance avec la mise en forme de l'entr\u00e9e active. Le param\u00e8tre OUTPUT consiste en une liste s\u00e9par\u00e9e par des virgules des sorties qui seront \u00e9crites. Si raw_data est demand\u00e9, alors les donn\u00e9es brutes de l'acc\u00e9l\u00e9rom\u00e8tre sont \u00e9crites dans un fichier ou une s\u00e9rie de fichiers /tmp/raw_data_<axe>_[<nom_puce>_][<point>_]<nom>.csv avec (la partie <point>_ du nom g\u00e9n\u00e9r\u00e9e seulement si plus d'un point de sonde est configur\u00e9 ou si POINT est sp\u00e9cifi\u00e9). Si resonances est sp\u00e9cifi\u00e9, la r\u00e9ponse en fr\u00e9quence est calcul\u00e9e (\u00e0 travers tous les points de sonde) et \u00e9crite dans le fichier /tmp/resonances_<axe>_<nom>.csv . S'il n'est pas d\u00e9fini, OUTPUT prend par d\u00e9faut la valeur de resonances , et NAME prend par d\u00e9faut la valeur de l'heure actuelle au format \"AAAAMMJJ_HHMMSS\". SHAPER_CALIBRATE \u00b6 SHAPER_CALIBRATE [AXIS=<axe>] [NAME=<nom>] [FREQ_START=<freq_min>] [FREQ_END=<freq_max>] [HZ_PER_SEC=<hz_par_sec>] [MAX_SMOOTHING=<adoucissement_max>] : Comme TEST_RESONANCES , ex\u00e9cute le test de r\u00e9sonance tel que configur\u00e9, et essaie de trouver les param\u00e8tres optimaux pour le fa\u00e7onneur d'entr\u00e9e pour l'axe demand\u00e9 (ou les deux axes X et Y si le param\u00e8tre AXIS est d\u00e9sactiv\u00e9). Si MAX_SMOOTHING n'est pas d\u00e9fini, sa valeur est reprise de la section [resonance_tester] , la valeur par d\u00e9faut \u00e9tant non d\u00e9finie. Voir le Max smoothing du guide de la mesure des r\u00e9sonances pour plus d'informations sur l'utilisation de cette fonctionnalit\u00e9. Les r\u00e9sultats de l\u2019\u00e9talonnage sont imprim\u00e9s sur la console, les r\u00e9ponses en fr\u00e9quence et les diff\u00e9rentes valeurs des fa\u00e7onneurs d'entr\u00e9e sont \u00e9crites dans un ou plusieurs fichiers CSV /tmp/calibration_data_<axe>_<nom>.csv . Sauf si sp\u00e9cifi\u00e9, NOM est par d\u00e9faut l'heure actuelle au format \"AAAAMMJJ_HHMMSS\". Notez que les param\u00e8tres de mise en forme d'entr\u00e9e sugg\u00e9r\u00e9s peuvent \u00eatre conserv\u00e9s dans la configuration en \u00e9mettant la commande SAVE_CONFIG . [respond] \u00b6 Les commandes G-Code standard suivantes sont disponibles lorsque la section respond config est activ\u00e9e : M118 <message> : affiche le message pr\u00e9c\u00e9d\u00e9 du pr\u00e9fixe par d\u00e9faut configur\u00e9 (ou echo : si aucun pr\u00e9fixe n'est configur\u00e9). Les commandes suppl\u00e9mentaires suivantes sont \u00e9galement disponibles. RESPOND \u00b6 RESPOND MSG=\"<message>\" : Affiche le message pr\u00e9c\u00e9d\u00e9 du pr\u00e9fixe par d\u00e9faut configur\u00e9 (ou echo : si aucun pr\u00e9fixe n'est configur\u00e9). RESPOND TYPE=echo MSG=\"<message>\" : affiche le message pr\u00e9c\u00e9d\u00e9 par echo : . RESPOND TYPE=echo_no_space MSG=\"<message>\" : renvoie le message pr\u00e9c\u00e9d\u00e9 de echo: sans espace entre le pr\u00e9fixe et le message, utile pour la compatibilit\u00e9 avec certains plugins octoprint qui attendent un formatage tr\u00e8s sp\u00e9cifique. RESPOND TYPE=command MSG=\"<message>\" : renvoie le message pr\u00e9c\u00e9d\u00e9 de // . OctoPrint peut \u00eatre configur\u00e9 pour r\u00e9pondre \u00e0 ces messages (par exemple, RESPOND TYPE=command MSG=action:pause ). RESPOND TYPE=error MSG=\"<message>\" : affiche le message pr\u00e9c\u00e9d\u00e9 par !!! . RESPOND PREFIX=<prefix> MSG=\"<message>\" : renvoie le message pr\u00e9c\u00e9d\u00e9 de <prefix> . (Le param\u00e8tre PREFIX est prioritaire sur le param\u00e8tre TYPE ). [save_variables] \u00b6 La commande suivante est activ\u00e9e si une section save_variables config a \u00e9t\u00e9 activ\u00e9e. SAVE_VARIABLE \u00b6 SAVE_VARIABLE VARIABLE=<nom> VALUE=<valeur> : Enregistre la variable sur le disque afin qu'elle puisse \u00eatre utilis\u00e9e lors des red\u00e9marrages. Toutes les variables enregistr\u00e9es sont charg\u00e9es dans le dict printer.save_variables.variables au d\u00e9marrage et peuvent \u00eatre utilis\u00e9es dans des macros gcode. La VALEUR fournie est analys\u00e9e comme un litt\u00e9ral Python. [screws_tilt_adjust] \u00b6 Les commandes suivantes sont disponibles lorsque la section de configuration screws_tilt_adjust est activ\u00e9e (voir \u00e9galement le guide du nivelage manuel ). SCREWS_TILT_CALCULATE \u00b6 SCREWS_TILT_CALCULATE [DIRECTION=CW|CCW] [MAX_DEVIATION=<valeur>] [<probe_parameter>=<valeur>] : Cette commande invoquera l'outil de r\u00e9glage des vis du lit. Elle d\u00e9placera la buse \u00e0 diff\u00e9rents endroits (tels que d\u00e9finis dans le fichier de configuration) en palpant la hauteur z et calculera le nombre de tours de la molette de r\u00e9glage pour ajuster le niveau du lit. Si DIRECTION est sp\u00e9cifi\u00e9, les tours de la molette seront tous dans la m\u00eame direction, dans le sens des aiguilles d'une montre (CW) ou dans le sens inverse (CCW). Voir la commande PROBE pour plus de d\u00e9tails sur les param\u00e8tres optionnels de la sonde. IMPORTANT : Vous DEVEZ toujours effectuer un G28 avant d'utiliser cette commande. Si MAX_DEVIATION est sp\u00e9cifi\u00e9, la commande d\u00e9clenchera une erreur de gcode si une diff\u00e9rence de hauteur de vis par rapport \u00e0 la hauteur de vis de base est sup\u00e9rieure \u00e0 la valeur fournie. [sdcard_loop] \u00b6 Lorsque la section de configuration sdcard_loop est activ\u00e9e, les commandes \u00e9tendues suivantes sont disponibles. SDCARD_LOOP_BEGIN \u00b6 SDCARD_LOOP_BEGIN COUNT=<compte> : Commence une section boucl\u00e9e dans l'impression SD. Un compte de 0 indique que la section doit \u00eatre boucl\u00e9e ind\u00e9finiment. SDCARD_LOOP_END \u00b6 SDCARD_LOOP_END : Termine une section de boucle dans l'impression SD. SDCARD_LOOP_DESIST \u00b6 SDCARD_LOOP_DESIST : Termine les boucles existantes sans autres it\u00e9rations. [servo] \u00b6 Les commandes suivantes sont disponibles lorsqu'une section servo config est activ\u00e9e. SET_SERVO \u00b6 SET_SERVO SERVO=nom_config [ANGLE=<degr\u00e9s> | LARGEUR=<secondes>] : D\u00e9finit la position du servo \u00e0 l'angle (en degr\u00e9s) ou \u00e0 la largeur d'impulsion (en secondes) donn\u00e9s. Utilisez WIDTH=0 pour d\u00e9sactiver la sortie du servo. [skew_correction] \u00b6 Les commandes suivantes sont disponibles lorsque la section de configuration skew_correction est activ\u00e9e (voir \u00e9galement le guide Skew Correction ). SET_SKEW \u00b6 SET_SKEW [XY=<ac_length,bd_length,ad_length>] [XZ=<ac,bd,ad>] [YZ=<ac,bd,ad>] [CLEAR=<0|1>] : Configure le module [skew_correction] avec des mesures (en mm) prises \u00e0 partir d'une impression d'\u00e9talonnage. On peut entrer des mesures pour n'importe quelle combinaison de plans, les plans non entr\u00e9s conserveront leur valeur actuelle. Si CLEAR=1 est entr\u00e9, toute correction d'inclinaison sera d\u00e9sactiv\u00e9e. GET_CURRENT_SKEW \u00b6 GET_CURRENT_SKEW : Indique l'inclinaison actuelle de l'imprimante pour chaque plan en radians et en degr\u00e9s. L'inclinaison est calcul\u00e9e en fonction des param\u00e8tres fournis par le gcode SET_SKEW . CALC_MEASURED_SKEW \u00b6 CALC_MEASURED_SKEW [AC=<ac_length>] [BD=<bd_length>] [AD=<ad_length>] : Calcule et rapporte l'inclinaison (en radians et en degr\u00e9s) bas\u00e9e sur une impression mesur\u00e9e. Cela peut \u00eatre utile pour d\u00e9terminer l'inclinaison actuelle de l'imprimante apr\u00e8s l'application de la correction. Elle peut \u00e9galement \u00eatre utile avant l'application de la correction pour d\u00e9terminer si une correction de l'inclinaison est n\u00e9cessaire. Reportez-vous \u00e0 la section [Correction de l'obliquit\u00e9] (Skew_Correction.md) pour plus de d\u00e9tails sur les objets et les mesures de calibrage de l'obliquit\u00e9. SKEW_PROFILE \u00b6 SKEW_PROFILE [LOAD=<nom>] [SAVE=<nom>] [REMOVE=<nom>] : Gestion des profils pour la correction de l'obliquit\u00e9. LOAD restaurera l'\u00e9tat d'inclinaison \u00e0 partir du profil correspondant au nom fourni. SAVE sauvegardera l'\u00e9tat actuel d'inclinaison dans un profil correspondant au nom fourni. Remove supprimera le profil correspondant au nom fourni de la m\u00e9moire persistante. Notez qu'apr\u00e8s l'ex\u00e9cution des op\u00e9rations SAVE ou REMOVE, le gcode SAVE_CONFIG doit \u00eatre ex\u00e9cut\u00e9 pour que les modifications apport\u00e9es \u00e0 la m\u00e9moire permanente deviennent permanentes. [smart_effector] \u00b6 Plusieurs commandes sont disponibles lorsqu'une section de configuration smart_effector est activ\u00e9e. Assurez-vous de consulter la documentation officielle du Smart Effector sur le Duet3D Wiki avant de modifier les param\u00e8tres du Smart Effector. Consultez \u00e9galement le guide d'\u00e9talonnage de la sonde . SET_SMART_EFFECTOR \u00b6 SET_SMART_EFFECTOR [SENSITIVITY=<sensitivity>] [ACCEL=<accel>] [RECOVERY_TIME=<time>] : D\u00e9finit les param\u00e8tres du Smart Effector. Lorsque SENSITIVITY est sp\u00e9cifi\u00e9, la valeur respective est \u00e9crite dans l'EEPROM du SmartEffecteur (n\u00e9cessite que control_pin soit fourni). Les valeurs acceptables de <sensitivity> sont 0..255, la valeur par d\u00e9faut est 50. Des valeurs plus faibles n\u00e9cessitent moins de force de contact de la buse pour se d\u00e9clencher (mais il y a un plus grand risque de faux d\u00e9clenchement d\u00fb aux vibrations pendant le palpage), des valeurs plus \u00e9lev\u00e9es r\u00e9duisent les faux d\u00e9clenchements (mais n\u00e9cessitent une plus grande force de contact pour se d\u00e9clencher). Comme la sensibilit\u00e9 est \u00e9crite dans l'EEPROM, elle est conserv\u00e9e apr\u00e8s l'arr\u00eat, il n'est donc pas n\u00e9cessaire de la configurer \u00e0 chaque d\u00e9marrage de l'imprimante. ACCEL et RECOVERY_TIME permettent de modifier les param\u00e8tres correspondants lors de l'ex\u00e9cution, voir la section config de Smart Effector pour plus d'informations sur ces param\u00e8tres. RESET_SMART_EFFECTOR \u00b6 RESET_SMART_EFFECTOR : R\u00e9initialise la sensibilit\u00e9 du Smart Effector \u00e0 ses param\u00e8tres d'usine. N\u00e9cessite que control_pin soit fourni dans la section de configuration. [stepper_enable] \u00b6 Le module stepper_enable est automatiquement charg\u00e9. SET_STEPPER_ENABLE \u00b6 SET_STEPPER_ENABLE STEPPER=<nom_de_la_configuration> ENABLE=[0|1] : Active ou d\u00e9sactive uniquement le stepper donn\u00e9. Il s'agit d'un outil de diagnostic et de d\u00e9bogage qui doit donc \u00eatre utilis\u00e9 avec pr\u00e9caution. La d\u00e9sactivation d'un moteur d'axe ne r\u00e9initialise pas les informations d'orientation. Le d\u00e9placement manuel d'un moteur pas \u00e0 pas d\u00e9sactiv\u00e9 peut amener la machine \u00e0 faire fonctionner le moteur en dehors des limites de s\u00e9curit\u00e9. Cela peut entra\u00eener des dommages aux composants de l'axe, aux extr\u00e9mit\u00e9s chaudes et \u00e0 la surface d'impression. [temperature_fan] \u00b6 La commande suivante est disponible lorsqu'une section temperature_fan config est activ\u00e9e. SET_TEMPERATURE_FAN_TARGET \u00b6 SET_TEMPERATURE_FAN_TARGET temperature_fan=<nom_du_ventilateur_temp\u00e9rature> [target=<temp\u00e9rature_cible>] [min_speed=<vitesse_min>] [max_speed=<vitesse_max>] : D\u00e9finit la temp\u00e9rature cible d'un ventilateur_temp\u00e9rature. Si une cible n'est pas fournie, elle est fix\u00e9e \u00e0 la temp\u00e9rature sp\u00e9cifi\u00e9e dans le fichier de configuration. Si les vitesses ne sont pas fournies, aucun changement n'est appliqu\u00e9. [tmcXXXX] \u00b6 Les commandes suivantes sont disponibles lorsque l'une des sections tmcXXXX config est activ\u00e9e. DUMP_TMC \u00b6 DUMP_TMC STEPPER=<nom> : Cette commande lit les registres du pilote TMC et renvoie leurs valeurs. INIT_TMC \u00b6 INIT_TMC STEPPER=<nom> : Cette commande initialise les registres de la puce TMC. N\u00e9cessaire pour r\u00e9activer le pilote si l'alimentation de la puce est coup\u00e9e puis r\u00e9tablie. SET_TMC_CURRENT \u00b6 SET_TMC_CURRENT STEPPER=<nom> CURRENT=<amps> HOLDCURRENT=<amps> : Ceci ajustera les courants de marche et de maintien du pilote TMC. (HOLDCURRENT n'est pas applicable aux pilotes tmc2660). SET_TMC_FIELD \u00b6 SET_TMC_FIELD STEPPER=<nom> FIELD=<champ> VALUE=<valeur> : Cette commande modifie la valeur du champ de registre sp\u00e9cifi\u00e9 du pilote TMC. Cette commande est destin\u00e9e aux diagnostics de bas niveau et au d\u00e9bogage uniquement car la modification des champs pendant l'ex\u00e9cution peut entra\u00eener un comportement ind\u00e9sirable et potentiellement dangereux de votre imprimante. Les modifications permanentes doivent \u00eatre effectu\u00e9es \u00e0 l'aide du fichier de configuration de l'imprimante. Aucun contr\u00f4le d'int\u00e9grit\u00e9 n'est effectu\u00e9 pour les valeurs donn\u00e9es. [toolhead] \u00b6 Le module de t\u00eate d'outil est automatiquement charg\u00e9. SET_VELOCITY_LIMIT \u00b6 SET_VELOCITY_LIMIT [VELOCITY=<valeur>] [ACCEL=<valeur>] [ACCEL_TO_DECEL=<valeur>] [SQUARE_CORNER_VELOCITY=<valeur>] : Modifie les limites de v\u00e9locit\u00e9 de l'imprimante. [tuning_tower] \u00b6 Le module tuning_tower est automatiquement charg\u00e9. TUNING_TOWER \u00b6 TUNING_TOWER COMMAND=<commande> PARAMETER=<nom> START=<valeur> [SKIP=<valeur>] [FACTOR=<valeur> [BAND=<valeur>]]. | [STEP_DELTA=<valeur> STEP_HEIGHT=<valeur>] : Un outil pour affiner un param\u00e8tre sur chaque hauteur Z pendant une impression. L'outil ex\u00e9cutera la COMMANDE donn\u00e9e avec le PARAM\u00c8TRE donn\u00e9 assign\u00e9 \u00e0 une valeur qui varie avec Z selon une formule. Utilisez FACTOR si vous allez utiliser une r\u00e8gle ou un pied \u00e0 coulisse pour mesurer la hauteur Z de la valeur optimale, ou STEP_DELTA et STEP_HEIGHT si le mod\u00e8le de tour de r\u00e9glage a des bandes de valeurs discr\u00e8tes comme c'est le cas avec les tours de temp\u00e9rature. Si SKIP=<valeur> est sp\u00e9cifi\u00e9, le processus de r\u00e9glage ne commence pas avant que la hauteur Z <valeur> soit atteinte, et en dessous, la valeur sera mise \u00e0 START ; dans ce cas, la z_height utilis\u00e9e dans les formules ci-dessous est en fait max(z - skip, 0) . Il y a trois combinaisons possibles d'options : FACTOR : La valeur change \u00e0 un taux de factor par millim\u00e8tre. La formule utilis\u00e9e est : valeur = start + factor * z_height . Vous pouvez ins\u00e9rer la hauteur Z optimale directement dans la formule pour d\u00e9terminer la valeur optimale du param\u00e8tre. FACTOR and BAND : La valeur change \u00e0 un taux moyen de factor par millim\u00e8tre, mais dans des bandes discr\u00e8tes o\u00f9 l'ajustement ne sera fait que tous les BAND millim\u00e8tres de hauteur Z. La formule utilis\u00e9e est : valeur =start + factor * ((floor(z_height / band) + .5) * band) . STEP_DELTA et STEP_HEIGHT : La valeur change de STEP_DELTA tous les millim\u00e8tres de STEP_HEIGHT . La formule utilis\u00e9e est : valeur = start + step_delta * floor(z_height / step_height) . Vous pouvez simplement compter les bandes ou lire les \u00e9tiquettes des tours de r\u00e9glage pour d\u00e9terminer la valeur optimale. [virtual_sdcard] \u00b6 Klipper prend en charge les commandes G-Code standards suivantes si la section de configuration virtual_sdcard est activ\u00e9e : Liste des cartes SD : M20 Initialiser la carte SD : M21 S\u00e9lectionnez le fichier SD : M23 <nom du fichier> D\u00e9marrer/reprendre l'impression SD : M24 Suspendre l'impression depuis la SD : M25 D\u00e9finir la position SD : M26 S<d\u00e9calage> Afficher l'\u00e9tat d'impression depuis la carte SD : M27 En outre, les commandes \u00e9tendues suivantes sont disponibles lorsque la section de configuration \"virtual_sdcard\" est activ\u00e9e. SDCARD_PRINT_FILE \u00b6 SDCARD_PRINT_FILE FILENAME=<nom_fichier> : Charge un fichier et lance l'impression SD. SDCARD_RESET_FILE \u00b6 SDCARD_RESET_FILE : D\u00e9charge le fichier et efface l'\u00e9tat de la carte SD. [z_thermal_adjust] \u00b6 Les commandes suivantes sont disponibles lorsque la section z_thermal_adjust config est activ\u00e9e. SET_Z_THERMAL_ADJUST \u00b6 SET_Z_THERMAL_ADJUST [ENABLE=<0:1>] [TEMP_COEFF=<valeur>] [REF_TEMP=<valeur>] : Active ou d\u00e9sactive l'ajustement thermique Z avec ENABLE . La d\u00e9sactivation ne supprime pas l'ajustement d\u00e9j\u00e0 appliqu\u00e9, mais g\u00e8le la valeur d'ajustement actuelle - cela emp\u00eache un mouvement Z vers le bas potentiellement dangereux. La r\u00e9activation peut potentiellement causer un mouvement de l'outil vers le haut lorsque l'ajustement est mis \u00e0 jour et appliqu\u00e9. TEMP_COEFF permet de r\u00e9gler le coefficient de temp\u00e9rature de l'ajustement en cours d'ex\u00e9cution (c'est-\u00e0-dire le param\u00e8tre de configuration TEMP_COEFF ). Les valeurs de TEMP_COEFF ne sont pas sauvegard\u00e9es dans la config. REF_TEMP remplace manuellement la temp\u00e9rature de r\u00e9f\u00e9rence g\u00e9n\u00e9ralement r\u00e9gl\u00e9e pendant le retour \u00e0 l'origine (pour une utilisation dans des routines de retour \u00e0 l'origine non standard) - sera remis \u00e0 z\u00e9ro automatiquement lors du retour \u00e0 l'origine. [z_tilt] \u00b6 Les commandes suivantes sont disponibles lorsque la section z_tilt config est activ\u00e9e. Z_TILT_ADJUST \u00b6 Z_TILT_ADJUST [<probe_parameter>=<valeur>] : Cette commande palpe les points sp\u00e9cifi\u00e9s dans la configuration et effectue ensuite des ajustements ind\u00e9pendants pour chaque moteur Z afin de compenser l'inclinaison. Reportez-vous \u00e0 la commande PROBE pour plus de d\u00e9tails sur les param\u00e8tres de palpage optionnels.","title":"G-Codes"},{"location":"G-Codes.html#g-codes","text":"Ce document d\u00e9crit les commandes que Klipper supporte. Il s'agit de commandes que l'on peut saisir dans l'onglet du terminal OctoPrint.","title":"G-Codes"},{"location":"G-Codes.html#commandes-g-code","text":"Klipper prend en charge les commandes G-Code standard suivantes : Move (G0 ou G1): G1 [X<pos>] [Y<pos>] [Z<pos>] [E<pos>] [F<speed>] Temporisation : G4 P<millisecondes> D\u00e9placement vers l'origine : G28 [X] [Y] [Z] \u00c9teindre les moteurs : M18 ou M84 Attendre la fin des mouvements en cours : M400 Utiliser des distances absolues/relatives pour l'extrusion : M82 , M83 Utiliser des coordonn\u00e9es absolues/relatives : G90 , G91 D\u00e9finir la position : G92 [X<pos>] [Y<pos>] [Z<pos>] [E<pos>] D\u00e9finir le pourcentage de neutralisation du facteur de vitesse : M220 S<percent> D\u00e9finit le pourcentage d'annulation du facteur d'extrusion : M221 S<percent> R\u00e9gler l'acc\u00e9l\u00e9ration : M204 S<valeur> OU M204 P<valeur> T<valeur> Remarque : si S n'est pas sp\u00e9cifi\u00e9 et que P et T le sont, l'acc\u00e9l\u00e9ration sera r\u00e9gl\u00e9e sur le minimum de P et T. Si un seul P ou T est donn\u00e9, la commande n'aura aucun effet. Obtenir la temp\u00e9rature de l'extrudeur : M105 R\u00e9gler la temp\u00e9rature de l'extrudeur : M104 [T<index>] [S<temp\u00e9rature>] R\u00e9gler la temp\u00e9rature de l'extrudeur et attendre : M109 [T<index>] S<temp\u00e9rature> Note : M109 attendra toujours que la temp\u00e9rature se stabilise \u00e0 la valeur demand\u00e9e. R\u00e9gler la temp\u00e9rature du bed : M140 [S<temperature>] R\u00e9gler la temp\u00e9rature du bed et attendre : M190 S<temperature> Note : M190 attendra toujours que la temp\u00e9rature se stabilise \u00e0 la valeur demand\u00e9e. R\u00e9gler la vitesse du ventilateur : M106 S<valeur> D\u00e9sactiver le ventilateur : M107 Arr\u00eat d'urgence : M112 Obtenir la position actuelle : M114 Obtenir la version du firmware : M115 Pour plus de d\u00e9tails sur les commandes ci-dessus, voir la [documentation RepRap G-Code] ( http://reprap.org/wiki/G-code ). L'objectif de Klipper est de prendre en charge les commandes G-Code produites par les logiciels tiers courants (par exemple, OctoPrint, Printrun, Slic3r, Cura, etc.) dans leurs configurations standards. Le but n'est pas de prendre en charge toutes les commandes G-Code possibles. Au contraire, Klipper pr\u00e9f\u00e8re les [\"commandes G-Code \u00e9tendues\"] (#additional-commands) humainement lisibles. De la m\u00eame mani\u00e8re, la sortie du terminal G-Code est uniquement destin\u00e9e \u00e0 \u00eatre humainement lisible - voir le document du serveur API si vous contr\u00f4lez Klipper depuis un logiciel externe. Si vous avez besoin d'une commande G-Code moins courante, il est possible de l'impl\u00e9menter avec une section de configuration gcode_macro personnalis\u00e9e . Par exemple, on peut utiliser ceci pour impl\u00e9menter : G12 , G29 , G30 , G31 , M42 , M80 , M81 , T1 , etc.","title":"Commandes G-Code"},{"location":"G-Codes.html#commandes-additionnelles","text":"Klipper utilise des commandes G-Code \"\u00e9tendues\" pour la configuration g\u00e9n\u00e9rale et l'\u00e9tat. Ces commandes \u00e9tendues suivent toutes un format similaire : elles commencent par le nom de la commande et peuvent \u00eatre suivies d'un ou plusieurs param\u00e8tres. Par exemple : SET_SERVO SERVO=myservo ANGLE=5.3 . Dans ce document, les commandes et les param\u00e8tres sont indiqu\u00e9s en majuscules, mais ils ne sont pas sensibles \u00e0 la casse. (Ainsi, \"SET_SERVO\" et \"set_servo\" ex\u00e9cuteront tous deux la m\u00eame commande). Cette section est organis\u00e9e par nom de module Klipper, en suivant g\u00e9n\u00e9ralement les noms de section sp\u00e9cifi\u00e9s dans le fichier de configuration de l'imprimante . Notez que certains modules sont automatiquement charg\u00e9s.","title":"Commandes additionnelles"},{"location":"G-Codes.html#adxl345","text":"Les commandes suivantes sont disponibles lorsqu'une section adxl345 config est activ\u00e9e.","title":"[adxl345]"},{"location":"G-Codes.html#accelerometer_measure","text":"ACCELEROMETER_MEASURE [CHIP=<nom_de_la_configuration>] [NAME=<valeur>] : D\u00e9marre les mesures de l'acc\u00e9l\u00e9rom\u00e8tre au nombre d'\u00e9chantillons par seconde demand\u00e9. Si CHIP n'est pas pr\u00e9cis\u00e9, la valeur par d\u00e9faut est \"adxl345\". La commande fonctionne en mode start-stop : ex\u00e9cut\u00e9e pour la premi\u00e8re fois, elle d\u00e9marre les mesures, l'ex\u00e9cution suivante les arr\u00eate. Les r\u00e9sultats des mesures sont \u00e9crits dans un fichier nomm\u00e9 /tmp/adxl345-<chip>-<nom>.csv o\u00f9 <chip> est le nom de la puce acc\u00e9l\u00e9rom\u00e8tre ( my_chip_name de [adxl345 my_chip_name] ) et <nom> est le param\u00e8tre optionnel NAME. Si le param\u00e8tre NOM n'est pas pr\u00e9cis\u00e9, l'heure actuelle est utilis\u00e9e par d\u00e9faut au format \"AAAAMMJJ_HHMMSS\". Si l'acc\u00e9l\u00e9rom\u00e8tre n'a pas de nom dans sa section de configuration (simplement [adxl345] ) alors la partie <chip> du nom n'est pas g\u00e9n\u00e9r\u00e9e.","title":"ACCELEROMETER_MEASURE"},{"location":"G-Codes.html#accelerometer_query","text":"ACCELEROMETER_QUERY [CHIP=<nom_de_la_configuration>] [RATE=<valeur>] : interroge l'acc\u00e9l\u00e9rom\u00e8tre pour la valeur courante. Si CHIP n'est pas pr\u00e9cis\u00e9, la valeur par d\u00e9faut est \"adxl345\". Si RATE n'est pas pr\u00e9cis\u00e9, la valeur par d\u00e9faut est utilis\u00e9e. Cette commande permet de tester la connexion \u00e0 l'acc\u00e9l\u00e9rom\u00e8tre ADXL345 : une des valeurs retourn\u00e9es devrait \u00eatre une acc\u00e9l\u00e9ration en chute libre (+/- un certain bruit de la puce).","title":"ACCELEROMETER_QUERY"},{"location":"G-Codes.html#accelerometer_debug_read","text":"ACCELEROMETER_DEBUG_READ [CHIP=<nom_de_la_configuration>] REG=<registre> : interroge le registre ADXL345 \"registre\" (par exemple 44 ou 0x2C). Peut \u00eatre utile \u00e0 des fins de d\u00e9bogage.","title":"ACCELEROMETER_DEBUG_READ"},{"location":"G-Codes.html#accelerometer_debug_write","text":"ACCELEROMETER_DEBUG_WRITE [CHIP=<nom_de_la_configuration>] REG=<registre> VAL=<valeur> : Ecrit la \"valeur\" brute dans le registre \"registre\". La \"valeur\" et le \"registre\" peuvent \u00eatre des entiers d\u00e9cimaux ou hexad\u00e9cimaux. A utiliser avec pr\u00e9caution, et se r\u00e9f\u00e9rer \u00e0 la fiche technique de l'ADXL345 pour la r\u00e9f\u00e9rence.","title":"ACCELEROMETER_DEBUG_WRITE"},{"location":"G-Codes.html#angle","text":"Les commandes suivantes sont disponibles lorsqu'une section angle config est activ\u00e9e.","title":"[angle]"},{"location":"G-Codes.html#angle_calibrate","text":"ANGLE_CALIBRATE CHIP=<nom_de_la_puce> : Effectue une calibration d'angle sur le capteur donn\u00e9 (il doit y avoir une section de configuration [angle nom_de_la_puce] qui a indiqu\u00e9 un param\u00e8tre stepper ). IMPORTANT - cet outil commandera au moteur pas \u00e0 pas de se d\u00e9placer sans v\u00e9rifier les limites normales de la cin\u00e9matique. Id\u00e9alement, le moteur devrait \u00eatre d\u00e9connect\u00e9 de tout chariot d'imprimante avant d'effectuer le calibrage. Si le moteur pas \u00e0 pas ne peut pas \u00eatre d\u00e9connect\u00e9 de l'imprimante, assurez-vous que le chariot est proche du centre de son rail avant de commencer l'\u00e9talonnage. (Le moteur pas \u00e0 pas peut se d\u00e9placer vers l'avant ou l'arri\u00e8re de deux rotations compl\u00e8tes durant ce test). Apr\u00e8s avoir termin\u00e9 ce test, utilisez la commande SAVE_CONFIG pour sauvegarder les donn\u00e9es de calibration dans le fichier de configuration. Afin d'utiliser cet outil, le paquetage Python \"numpy\" doit \u00eatre install\u00e9 (voir le document mesurer les r\u00e9sonances pour plus d'informations).","title":"ANGLE_CALIBRATE"},{"location":"G-Codes.html#angle_debug_read","text":"ANGLE_DEBUG_READ CHIP=<nom_de_la_configuration> REG=<registre> : Interroge le registre \"registre\" du capteur (par exemple 44 ou 0x2C). Peut \u00eatre utile \u00e0 des fins de d\u00e9bogage. Ceci n'est disponible que pour les puces tle5012b.","title":"ANGLE_DEBUG_READ"},{"location":"G-Codes.html#angle_debug_write","text":"ANGLE_DEBUG_WRITE CHIP=<nom_de_la_configuration> REG=<registre> VAL=<valeur> : \u00c9crit la \"valeur\" brute dans le registre \"registre\". La \"valeur\" et le \"registre\" peuvent \u00eatre des entiers d\u00e9cimaux ou hexad\u00e9cimaux. A utiliser avec pr\u00e9caution, et se r\u00e9f\u00e9rer \u00e0 la fiche technique du capteur pour la r\u00e9f\u00e9rence. Cette fonction n'est disponible que pour les puces tle5012b.","title":"ANGLE_DEBUG_WRITE"},{"location":"G-Codes.html#bed_mesh","text":"Les commandes suivantes sont disponibles lorsque la section configuration de bed_mesh est activ\u00e9e (voir \u00e9galement le guide de bed_mesh ).","title":"[bed_mesh]"},{"location":"G-Codes.html#bed_mesh_calibrate","text":"BED_MESH_CALIBRATE [METHOD=manual] [<probe_parameter>=<value>] [<mesh_parameter>=<value>] : Cette commande palpe le bed en utilisant des points g\u00e9n\u00e9r\u00e9s sp\u00e9cifi\u00e9s par les param\u00e8tres de la config. Apr\u00e8s le test, un maillage est g\u00e9n\u00e9r\u00e9 et le d\u00e9placement de l'axe Z est ajust\u00e9 en fonction de celui-ci. R\u00e9f\u00e9rez-vous \u00e0 la commande PROBE pour plus de d\u00e9tails sur les param\u00e8tres optionnels. Si METHOD=manual est sp\u00e9cifi\u00e9, l'outil de palpage manuel est activ\u00e9 - voir la commande MANUAL_PROBE ci-dessus pour plus de d\u00e9tails sur les possibilit\u00e9s suppl\u00e9mentaires disponibles lorsque cet outil est utilis\u00e9.","title":"BED_MESH_CALIBRATE"},{"location":"G-Codes.html#bed_mesh_output","text":"BED_MESH_OUTPUT PGP=[<0:1>] : Cette commande \u00e9crit les valeurs z palp\u00e9es actuelles et les valeurs de maillage actuelles sur le terminal. Si PGP=1 est sp\u00e9cifi\u00e9, les coordonn\u00e9es X, Y g\u00e9n\u00e9r\u00e9es par bed_mesh, ainsi que leurs indices associ\u00e9s, seront envoy\u00e9s au terminal.","title":"BED_MESH_OUTPUT"},{"location":"G-Codes.html#bed_mesh_map","text":"BED_MESH_MAP : Comme pour BED_MESH_OUTPUT, cette commande affiche l'\u00e9tat actuel du maillage sur le terminal. L'\u00e9tat sera retourn\u00e9 au format json. Cela permet aux plugins octoprint de r\u00e9cup\u00e9rer facilement les donn\u00e9es et de g\u00e9n\u00e9rer des cartes d'altitude au plus proche de la surface du bed.","title":"BED_MESH_MAP"},{"location":"G-Codes.html#bed_mesh_clear","text":"BED_MESH_CLEAR : Cette commande efface le maillage actuel et supprime les ajustements de l'axe z. Il est recommand\u00e9 de mettre cette commande dans votre gcode de fin.","title":"BED_MESH_CLEAR"},{"location":"G-Codes.html#bed_mesh_profile","text":"BED_MESH_PROFILE LOAD=<nom> SAVE=<nom> REMOVE=<nom> : Cette commande fournit une gestion de profil pour l'\u00e9tat du maillage. LOAD restaurera l'\u00e9tat du maillage \u00e0 partir du profil correspondant au nom fourni. SAVE sauvegarde l'\u00e9tat du maillage actuel dans un profil correspondant au nom fourni. REMOVE supprimera le profil correspondant au nom fourni de la m\u00e9moire persistante. Notez qu'apr\u00e8s l'ex\u00e9cution des op\u00e9rations SAVE ou REMOVE, le gcode SAVE_CONFIG doit \u00eatre ex\u00e9cut\u00e9 pour rendre les changements de la m\u00e9moire persistante permanents.","title":"BED_MESH_PROFILE"},{"location":"G-Codes.html#bed_mesh_offset","text":"BED_MESH_OFFSET [X=<value>] [Y=<value>] : Applique des d\u00e9calages X et/ou Y pour l'\u00e9valuation du maillage. Ceci est utile pour les imprimantes avec extrudeurs ind\u00e9pendants, car un d\u00e9calage est n\u00e9cessaire pour obtenir un ajustement Z correct apr\u00e8s un changement d'outil.","title":"BED_MESH_OFFSET"},{"location":"G-Codes.html#bed_screws","text":"Les commandes suivantes sont disponibles lorsque la section config bed_screws est activ\u00e9e (voir \u00e9galement le guide du nivelage manuel ).","title":"[bed_screws]"},{"location":"G-Codes.html#bed_screws_adjust","text":"BED_SCREWS_ADJUST : Cette commande fait appel \u00e0 l'outil de r\u00e9glage des vis du bed. Elle commandera la buse \u00e0 diff\u00e9rents endroits (tels que d\u00e9finis dans le fichier de configuration) et permettra d'ajuster les vis du bed afin que celui-ci et la buse soient \u00e0 distance constante.","title":"BED_SCREWS_ADJUST"},{"location":"G-Codes.html#bed_tilt","text":"Les commandes suivantes sont disponibles lorsque la section config bed_tilt est activ\u00e9e.","title":"[bed_tilt]"},{"location":"G-Codes.html#bed_tilt_calibrate","text":"BED_TILT_CALIBRATE [METHOD=manual] [<probe_parameter>=<value>] : Cette commande teste les points sp\u00e9cifi\u00e9s dans la configuration, puis recommande des ajustements d'inclinaison x et y mis \u00e0 jour. Voir la commande PROBE pour plus de d\u00e9tails sur les param\u00e8tres de palpage optionnels. Si METHOD=manual est sp\u00e9cifi\u00e9, l'outil de palpage manuel est activ\u00e9 - voir la commande MANUAL_PROBE ci-dessus pour plus de d\u00e9tails sur les commandes suppl\u00e9mentaires disponibles lorsque cet outil est actif.","title":"BED_TILT_CALIBRATE"},{"location":"G-Codes.html#bltouch","text":"La commande suivante est disponible lorsqu'une section bltouch config est activ\u00e9e (voir \u00e9galement le Guide BL-Touch ).","title":"[bltouch]"},{"location":"G-Codes.html#bltouch_debug","text":"BLTOUCH_DEBUG COMMAND=<commande> : Ceci envoie une commande au BLTouch. Elle peut \u00eatre utile pour le d\u00e9bogage. Les commandes disponibles sont : pin_down , touch_mode , pin_up , self_test , reset . Un BL-Touch V3.0 ou V3.1 accepte en plus les commandes set_5V_output_mode , set_OD_output_mode , output_mode_store .","title":"BLTOUCH_DEBUG"},{"location":"G-Codes.html#bltouch_store","text":"BLTOUCH_STORE MODE=<output_mode> : Stocke un mode de sortie dans l'EEPROM d'un BLTouch V3.1 Les modes de sortie disponibles sont : 5V , OD","title":"BLTOUCH_STORE"},{"location":"G-Codes.html#configfile","text":"Le module configfile est automatiquement charg\u00e9.","title":"[configfile]"},{"location":"G-Codes.html#save_config","text":"SAVE_CONFIG : Cette commande \u00e9crase le fichier de configuration principal de l'imprimante et red\u00e9marre le logiciel h\u00f4te. Cette commande est utilis\u00e9e conjointement avec d'autres commandes d'\u00e9talonnage pour enregistrer les r\u00e9sultats de ces tests.","title":"SAVE_CONFIG"},{"location":"G-Codes.html#delayed_gcode","text":"La commande suivante est activ\u00e9e si une section de configuration delayed_gcode a \u00e9t\u00e9 activ\u00e9e (voir \u00e9galement le guide des mod\u00e8les ).","title":"[delayed_gcode]"},{"location":"G-Codes.html#update_delayed_gcode","text":"UPDATE_DELAYED_GCODE [ID=<nom>] [DURATION=<secondes>] : Met \u00e0 jour la dur\u00e9e du retard du [delayed_gcode] identifi\u00e9 et d\u00e9marre le minuteur pour l'ex\u00e9cution du gcode. Une valeur de 0 annulera l'ex\u00e9cution d'un gcode retard\u00e9 en attente.","title":"UPDATE_DELAYED_GCODE"},{"location":"G-Codes.html#delta_calibrate","text":"Les commandes suivantes sont disponibles lorsque la section delta_calibrate config est activ\u00e9e (voir \u00e9galement le guide delta calibrate ).","title":"[delta_calibrate]"},{"location":"G-Codes.html#delta_calibrate_1","text":"DELTA_CALIBRATE [METHOD=manual] [<probe_parameter>=<value>] : Cette commande teste sept points sur le lit et recommande des positions de but\u00e9e, des angles de tour et des rayons mis \u00e0 jour. Voir la commande PROBE pour plus de d\u00e9tails sur les param\u00e8tres de palpage optionnels. Si METHOD=manual est sp\u00e9cifi\u00e9, l'outil de palpage manuel est activ\u00e9 - voir la commande MANUAL_PROBE ci-dessus pour plus de d\u00e9tails sur les commandes suppl\u00e9mentaires disponibles lorsque cet outil est actif.","title":"DELTA_CALIBRATE"},{"location":"G-Codes.html#delta_analyze","text":"DELTA_ANALYZE : Cette commande est utilis\u00e9e pendant l'\u00e9talonnage delta am\u00e9lior\u00e9. Voir Calibrage delta pour plus de d\u00e9tails.","title":"DELTA_ANALYZE"},{"location":"G-Codes.html#display","text":"La commande suivante est disponible lorsqu'une section display config est activ\u00e9e.","title":"[display]"},{"location":"G-Codes.html#set_display_group","text":"SET_DISPLAY_GROUP [DISPLAY=<display>] GROUP=<group> : D\u00e9finit le groupe d'affichage actif d'un \u00e9cran LCD. Cela permet de d\u00e9finir plusieurs groupes de donn\u00e9es d'affichage dans la configuration, par exemple [display_data <group> <elementname>] et de passer de l'un \u00e0 l'autre en utilisant cette commande gcode \u00e9tendue. Si DISPLAY n'est pas sp\u00e9cifi\u00e9, la valeur par d\u00e9faut est \"display\" (l'affichage principal).","title":"SET_DISPLAY_GROUP"},{"location":"G-Codes.html#display_status","text":"Le module display_status est automatiquement charg\u00e9 si une section display config est activ\u00e9e. Il fournit les commandes G-Code standard suivantes : Afficher un message : M117 <message> D\u00e9finir le pourcentage de g\u00e9n\u00e9ration : M73 P<pourcentage> La commande G-Code \u00e9tendue suivante est \u00e9galement fournie : SET_DISPLAY_TEXT MSG=<message> : Effectue l'\u00e9quivalent de M117, en d\u00e9finissant le MSG fourni comme le message d'affichage actuel. Si MSG est omis, l'affichage est effac\u00e9.","title":"[display_status]"},{"location":"G-Codes.html#dual_carriage","text":"La commande suivante est disponible lorsque la section config dual_carriage est activ\u00e9e.","title":"[dual_carriage]"},{"location":"G-Codes.html#set_dual_carriage","text":"SET_DUAL_CARRIAGE CARRIAGE=[0|1] : Cette commande d\u00e9finit le chariot actif. Elle est g\u00e9n\u00e9ralement appel\u00e9e \u00e0 partir des champs activate_gcode et deactivate_gcode dans une configuration \u00e0 extrudeurs multiples.","title":"SET_DUAL_CARRIAGE"},{"location":"G-Codes.html#endstop_phase","text":"Les commandes suivantes sont disponibles lorsqu'une section de configuration endstop_phase est activ\u00e9e (voir \u00e9galement le guide de la phase d'arr\u00eat ).","title":"[endstop_phase]"},{"location":"G-Codes.html#endstop_phase_calibrate","text":"ENDSTOP_PHASE_CALIBRATE [STEPPER=<config_name>] : Si aucun param\u00e8tre STEPPER n'est fourni, cette commande rapporte des statistiques sur les phases d'arr\u00eat du stepper pendant les pr\u00e9c\u00e9dentes op\u00e9rations de recherche d'origine. Lorsqu'un param\u00e8tre STEPPER est fourni, elle fait en sorte que le param\u00e8tre de phase de fin de course donn\u00e9 soit \u00e9crit dans le fichier de configuration (en lien avec la commande SAVE_CONFIG).","title":"ENDSTOP_PHASE_CALIBRATE"},{"location":"G-Codes.html#exclude_object","text":"Les commandes suivantes sont disponibles lorsqu'une section de configuration exclude_object est activ\u00e9e (voir \u00e9galement le guide d'exclusion d'objet ) :","title":"[exclude_object]"},{"location":"G-Codes.html#exclude_object_1","text":"EXCLUDE_OBJECT [NAME=nom_objet] [CURRENT=1] [RESET=1] : Sans param\u00e8tres, cette commande renvoie une liste de tous les objets actuellement exclus. Lorsque le param\u00e8tre NAME est donn\u00e9, l'objet nomm\u00e9 sera exclu de l'impression. Lorsque le param\u00e8tre CURRENT est donn\u00e9, l'objet courant sera exclu de l'impression. Lorsque le param\u00e8tre RESET est donn\u00e9, la liste des objets exclus sera effac\u00e9e. De plus, inclure le param\u00e8tre NAME ne r\u00e9initialisera que l'objet nomm\u00e9. Cela peut provoquer des \u00e9checs d'impression, si des couches ont d\u00e9j\u00e0 \u00e9t\u00e9 omises.","title":"EXCLUDE_OBJECT"},{"location":"G-Codes.html#exclude_object_define","text":"EXCLUDE_OBJECT_DEFINE [NAME=nom_objet [CENTER=X,Y] [POLYGON=[[x,y],...]]] [RESET=1] [JSON=1] : Fournit le r\u00e9sum\u00e9 d'un objet dans le fichier. Sans param\u00e8tres fournis, ceci va lister les objets d\u00e9finis connus de Klipper. Retourne une liste de cha\u00eenes de caract\u00e8res, \u00e0 moins que le param\u00e8tre JSON soit donn\u00e9, auquel cas retournera les d\u00e9tails de l'objet au format json. Lorsque le param\u00e8tre NAME est inclus, cela d\u00e9finit un objet \u00e0 exclure. NAME : Ce param\u00e8tre est obligatoire. Il s'agit de l'identifiant utilis\u00e9 par les autres commandes de ce module. CENTER : Une coordonn\u00e9e X,Y pour l'objet. POLYGON : Un tableau de coordonn\u00e9es X,Y fournissant le contour d'un objet. Lorsque le param\u00e8tre RESET est fourni, tous les objets d\u00e9finis seront effac\u00e9s, et le module [exclude_object] sera r\u00e9initialis\u00e9.","title":"EXCLUDE_OBJECT_DEFINE"},{"location":"G-Codes.html#exclude_object_start","text":"EXCLUDE_OBJECT_START NAME=nom_objet : Cette commande prend un param\u00e8tre NAME et indique le d\u00e9but du gcode pour un objet sur la couche courante.","title":"EXCLUDE_OBJECT_START"},{"location":"G-Codes.html#exclude_object_end","text":"EXCLUDE_OBJECT_END [NAME=nom_objet] : Indique la fin du gcode de l'objet pour la couche. Il est associ\u00e9 \u00e0 EXCLUDE_OBJECT_START . Le param\u00e8tre NAME est optionnel, et n'avertira que si le nom fourni ne correspond au nom actuel.","title":"EXCLUDE_OBJECT_END"},{"location":"G-Codes.html#extruder","text":"Les commandes suivantes sont disponibles si une section configuration de l'extrudeuse est activ\u00e9e :","title":"[extruder]"},{"location":"G-Codes.html#activate_extruder","text":"ACTIVATE_EXTRUDER EXTRUDER=<nom_de_la_configuration> : Dans une imprimante comportant plusieurs sections de configuration d' extrudeuse , cette commande s\u00e9lectionne la t\u00eate d'outil active.","title":"ACTIVATE_EXTRUDER"},{"location":"G-Codes.html#set_pressure_advance","text":"SET_PRESSURE_ADVANCE [EXTRUDER=<nom_de_la_configuration>] [ADVANCE=<avance_de_pression>] [SMOOTH_TIME=<dur\u00e9e_adoucissemt_avance_de_pression>] : D\u00e9finit les param\u00e8tres d'avance de pression du moteur d'extrudeuse (comme d\u00e9fini dans une section de configuration extrudeur ou extruder_stepper ). Si EXTRUDER n'est pas sp\u00e9cifi\u00e9, il s'agit par d\u00e9faut du stepper d\u00e9fini dans la t\u00eate d'outil active.","title":"SET_PRESSURE_ADVANCE"},{"location":"G-Codes.html#set_extruder_rotation_distance","text":"SET_EXTRUDER_ROTATION_DISTANCE EXTRUDER=<nom_config> [DISTANCE=<distance>] : D\u00e9finit une nouvelle valeur pour la \"distance de rotation\" du moteur de l'extrudeuse fournie (telle que d\u00e9finie dans une section de configuration extruder ou extruder_stepper ). Si la distance de rotation est un nombre n\u00e9gatif, le mouvement du moteur sera invers\u00e9 (par rapport \u00e0 la direction du moteur sp\u00e9cifi\u00e9e dans le fichier de configuration). Les param\u00e8tres modifi\u00e9s ne sont pas conserv\u00e9s lors de la r\u00e9initialisation de Klipper. Utilisez avec pr\u00e9caution car de petites modifications peuvent entra\u00eener une pression excessive entre l'extrudeuse et la t\u00eate de l'outil. Effectuez un calibrage correct avec le filament avant de l'utiliser. Si la valeur 'DISTANCE' n'est pas fournie, cette commande renvoie la distance de rotation actuelle.","title":"SET_EXTRUDER_ROTATION_DISTANCE"},{"location":"G-Codes.html#sync_extruder_motion","text":"SYNC_EXTRUDER_MOTION EXTRUDER=<nom> MOTION_QUEUE=<nom> : Cette commande permet de synchroniser le moteur d'entra\u00eenement sp\u00e9cifi\u00e9 par EXTRUDER (tel que d\u00e9fini dans la section de configuration extruder ou extruder_stepper avec le mouvement d'un extrudeur sp\u00e9cifi\u00e9 par MOTION_QUEUE (tel que d\u00e9fini dans la section de configuration extruder ). Si MOTION_QUEUE est une cha\u00eene vide, le stepper sera d\u00e9synchronis\u00e9 de tout mouvement d'extrudeuse.","title":"SYNC_EXTRUDER_MOTION"},{"location":"G-Codes.html#set_extruder_step_distance","text":"Cette commande est obsol\u00e8te et sera supprim\u00e9e dans un avenir proche.","title":"SET_EXTRUDER_STEP_DISTANCE"},{"location":"G-Codes.html#sync_stepper_to_extruder","text":"Cette commande est obsol\u00e8te et sera supprim\u00e9e dans un avenir proche.","title":"SYNC_STEPPER_TO_EXTRUDER"},{"location":"G-Codes.html#fan_generic","text":"La commande suivante est disponible lorsqu'une section fan_generic config est activ\u00e9e.","title":"[fan_generic]"},{"location":"G-Codes.html#set_fan_speed","text":"SET_FAN_SPEED FAN=nom_config SPEED=<vitesse> Cette commande d\u00e9finit la vitesse d'un ventilateur. La valeur de \"vitesse\" doit \u00eatre comprise entre 0,0 et 1,0.","title":"SET_FAN_SPEED"},{"location":"G-Codes.html#filament_switch_sensor","text":"La commande suivante est disponible lorsqu'une section de configuration filament_switch_sensor ou filament_motion_sensor est activ\u00e9e.","title":"[filament_switch_sensor]"},{"location":"G-Codes.html#query_filament_sensor","text":"QUERY_FILAMENT_SENSOR SENSOR=<nom_du_capteur> : Interroge l'\u00e9tat actuel du capteur de filament. Les donn\u00e9es affich\u00e9es sur le terminal d\u00e9pendront du type de capteur d\u00e9fini dans la configuration.","title":"QUERY_FILAMENT_SENSOR"},{"location":"G-Codes.html#set_filament_sensor","text":"SET_FILAMENT_SENSOR SENSOR=<nom_du_capteur> ENABLE=[0|1] : Active/d\u00e9sactive le d\u00e9tecteur de filament. Si ENABLE est r\u00e9gl\u00e9 sur 0, le d\u00e9tecteur de filament est d\u00e9sactiv\u00e9, s'il est r\u00e9gl\u00e9 sur 1, il est activ\u00e9.","title":"SET_FILAMENT_SENSOR"},{"location":"G-Codes.html#firmware_retraction","text":"Les commandes G-Code standard suivantes sont disponibles lorsque la section de configuration firmware_retraction est activ\u00e9e. Ces commandes vous permettent d'utiliser la fonction de r\u00e9traction du micrologiciel disponible dans de nombreux trancheurs, afin de r\u00e9duire le cordage pendant les d\u00e9placements sans extrusion d'une partie de l'impression \u00e0 une autre. Une configuration appropri\u00e9e de l'avance \u00e0 la pression r\u00e9duit la longueur de r\u00e9traction requise. G10 : R\u00e9tracte l'extrudeur en utilisant les param\u00e8tres actuellement configur\u00e9s. G11 : D\u00e9tache l'extrudeur en utilisant les param\u00e8tres actuellement configur\u00e9s. Les commandes suppl\u00e9mentaires suivantes sont \u00e9galement disponibles.","title":"[firmware_retraction]"},{"location":"G-Codes.html#set_retraction","text":"SET_RETRACTION [RETRACT_LENGTH=<mm>] [RETRACT_SPEED=<mm/s>] [UNRETRACT_EXTRA_LENGTH=<mm>] [UNRETRACT_SPEED=<mm/s>] : Ajuste les param\u00e8tres utilis\u00e9s par la r\u00e9traction du micrologiciel. RETRACT_LENGTH d\u00e9termine la longueur de filament \u00e0 r\u00e9tracter et \u00e0 d\u00e9r\u00e9tracter. La vitesse de r\u00e9traction est ajust\u00e9e via RETRACT_SPEED, et est g\u00e9n\u00e9ralement r\u00e9gl\u00e9e relativement haut. La vitesse de d\u00e9stratification est ajust\u00e9e via UNRETRACT_SPEED, et n'est pas particuli\u00e8rement critique, bien que souvent inf\u00e9rieure \u00e0 RETRACT_SPEED. Dans certains cas, il est utile d'ajouter une petite quantit\u00e9 de longueur suppl\u00e9mentaire lors de la d\u00e9r\u00e9traction, et ceci est r\u00e9gl\u00e9 via UNRETRACT_EXTRA_LENGTH. SET_RETRACTION est g\u00e9n\u00e9ralement d\u00e9fini dans le cadre de la configuration du slicer par filament, car les diff\u00e9rents filaments n\u00e9cessitent des param\u00e8tres diff\u00e9rents.","title":"SET_RETRACTION"},{"location":"G-Codes.html#get_retraction","text":"GET_RETRACTION : Interroge les param\u00e8tres actuellement utilis\u00e9s pour la r\u00e9traction du firmware et les affiche sur le terminal.","title":"GET_RETRACTION"},{"location":"G-Codes.html#force_move","text":"Le module force_move est automatiquement charg\u00e9, mais certaines commandes n\u00e9cessitent de d\u00e9finir enable_force_move dans la configuration de l'imprimante .","title":"[force_move]"},{"location":"G-Codes.html#stepper_buzz","text":"STEPPER_BUZZ STEPPER=<nom_de_la_configuration> : D\u00e9place le moteur donn\u00e9 en avant d'un mm puis en arri\u00e8re d'un mm, r\u00e9p\u00e9t\u00e9 10 fois. Il s'agit d'un outil de diagnostic permettant de v\u00e9rifier la connectivit\u00e9 du moteur.","title":"STEPPER_BUZZ"},{"location":"G-Codes.html#force_move_1","text":"FORCE_MOVE STEPPER=<nom_de_la_configuration> DISTANCE=<valeur> VELOCITE=<valeur> [ACCEL=<valeur>] : Cette commande forcera le d\u00e9placement du stepper donn\u00e9 sur la distance donn\u00e9e (en mm) \u00e0 la vitesse constante donn\u00e9e (en mm/s). Si ACCEL est sp\u00e9cifi\u00e9 et est sup\u00e9rieur \u00e0 z\u00e9ro, alors l'acc\u00e9l\u00e9ration donn\u00e9e (en mm/s^2) sera utilis\u00e9e ; sinon, aucune acc\u00e9l\u00e9ration n'est effectu\u00e9e. Aucune v\u00e9rification des limites n'est effectu\u00e9e ; aucune mise \u00e0 jour cin\u00e9matique n'est faite ; les autres steppers parall\u00e8les sur un axe ne seront pas d\u00e9plac\u00e9s. Soyez prudent car une commande incorrecte pourrait endommager le mat\u00e9riel ! L'utilisation de cette commande placera presque certainement la cin\u00e9matique de bas niveau dans un \u00e9tat incorrect ; \u00e9mettez ensuite un G28 pour r\u00e9initialiser la cin\u00e9matique. Cette commande est destin\u00e9e aux diagnostics de bas niveau et au d\u00e9bogage.","title":"FORCE_MOVE"},{"location":"G-Codes.html#set_kinematic_position","text":"SET_KINEMATIC_POSITION [X=<value>] [Y=<value>] [Z=<value>] : Force le code cin\u00e9matique de bas niveau \u00e0 croire que la t\u00eate d'outil est \u00e0 la position cart\u00e9sienne donn\u00e9e. Il s'agit d'une commande de diagnostic et de d\u00e9bogage ; utilisez SET_GCODE_OFFSET et/ou G92 pour des transformations d'axe r\u00e9guli\u00e8res. Si un axe n'est pas sp\u00e9cifi\u00e9, la position par d\u00e9faut sera celle de la derni\u00e8re commande de la t\u00eate. La d\u00e9finition d'une position incorrecte ou invalide peut entra\u00eener des erreurs logicielles internes. Cette commande peut invalider les futures v\u00e9rifications de limites ; \u00e9mettez ensuite un G28 pour r\u00e9initialiser la cin\u00e9matique.","title":"SET_KINEMATIC_POSITION"},{"location":"G-Codes.html#gcode","text":"Le module gcode est automatiquement charg\u00e9.","title":"[gcode]"},{"location":"G-Codes.html#restart","text":"RESTART : Cette commande permet au logiciel h\u00f4te de recharger sa configuration et d'effectuer une r\u00e9initialisation interne. Cette commande n'efface pas l'\u00e9tat d'erreur du micro-contr\u00f4leur (voir FIRMWARE_RESTART) et ne charge pas de nouveau logiciel (voir la FAQ ).","title":"RESTART"},{"location":"G-Codes.html#firmware_restart","text":"FIRMWARE_RESTART : Cette commande est similaire \u00e0 un RESTART, mais elle efface \u00e9galement tout \u00e9tat d'erreur du micro-contr\u00f4leur.","title":"FIRMWARE_RESTART"},{"location":"G-Codes.html#status","text":"STATUS : Indique l'\u00e9tat du logiciel de l'h\u00f4te Klipper.","title":"STATUS"},{"location":"G-Codes.html#help","text":"HELP : Affiche la liste des commandes G-Code \u00e9tendues disponibles.","title":"HELP"},{"location":"G-Codes.html#gcode_arcs","text":"Les commandes G-Code standard suivantes sont disponibles si une section gcode_arcs config est activ\u00e9e : D\u00e9placement d'un arc dans le sens des aiguilles d'une montre (G2), d\u00e9placement d'un arc dans le sens inverse des aiguilles d'une montre (G3) : G2|G3 [X<pos>] [Y<pos>] [Z<pos>] [E<pos>] [F<speed>] I<value> J<value>|I<value> K<value>|J<value> K<value> S\u00e9lection du plan de l'arc : G17 (plan XY), G18 (plan XZ), G19 (plan YZ)","title":"[gcode_arcs]"},{"location":"G-Codes.html#gcode_macro","text":"La commande suivante est disponible lorsqu'une section de configuration gcode_macro est activ\u00e9e (voir \u00e9galement le guide des mod\u00e8les de commande ).","title":"[gcode_macro]"},{"location":"G-Codes.html#set_gcode_variable","text":"SET_GCODE_VARIABLE MACRO=<macro_name> VARIABLE=<name> VALUE=<value> : Cette commande permet de changer la valeur d'une variable gcode_macro au moment de l'ex\u00e9cution. La valeur fournie est analys\u00e9e comme un litt\u00e9ral Python.","title":"SET_GCODE_VARIABLE"},{"location":"G-Codes.html#gcode_move","text":"Le module gcode_move est automatiquement charg\u00e9.","title":"[gcode_move]"},{"location":"G-Codes.html#get_position","text":"GET_POSITION : Retourne les informations de l'emplacement actuel de la t\u00eate d'outil. Voir la documentation du d\u00e9veloppeur de restitution de GET_POSITION pour plus d'informations.","title":"GET_POSITION"},{"location":"G-Codes.html#set_gcode_offset","text":"SET_GCODE_OFFSET [X=<pos>|X_ADJUST=<adjust>] [Y=<pos>|Y_ADJUST=<adjust>] [Z=<pos>|Z_ADJUST=<adjust>] [MOVE=1 [MOVE_SPEED=<speed>]] : D\u00e9finit un d\u00e9calage positionnel \u00e0 appliquer aux futures commandes G-Code. Ceci est g\u00e9n\u00e9ralement utilis\u00e9 pour changer virtuellement le d\u00e9calage Z du bed ou pour d\u00e9finir les d\u00e9calages XY des buses lors du changement d'extrudeur. Par exemple, si \"SET_GCODE_OFFSET Z=0.2\" est donn\u00e9, les prochains mouvements G-Code auront 0,2mm ajout\u00e9 \u00e0 leur hauteur Z. Si les param\u00e8tres de style X_ADJUST sont utilis\u00e9s, l'ajustement sera ajout\u00e9 \u00e0 tout d\u00e9calage existant (par exemple, \"SET_GCODE_OFFSET Z=-0.2\" suivi de \"SET_GCODE_OFFSET Z_ADJUST=0.3\" donnerait un d\u00e9calage Z total de 0.1). Si \"MOVE=1\" est sp\u00e9cifi\u00e9, un d\u00e9placement de la t\u00eate d'outil sera effectu\u00e9 pour appliquer le d\u00e9calage donn\u00e9 (sinon le d\u00e9calage prendra effet lors du prochain d\u00e9placement absolu en G-code qui sp\u00e9cifie l'axe donn\u00e9). Si \"MOVE_SPEED\" est sp\u00e9cifi\u00e9, le d\u00e9placement de la t\u00eate d'outil sera effectu\u00e9 avec la vitesse donn\u00e9e (en mm/s) ; sinon, le d\u00e9placement de la t\u00eate d'outil utilisera la derni\u00e8re vitesse G-Code sp\u00e9cifi\u00e9e.","title":"SET_GCODE_OFFSET"},{"location":"G-Codes.html#save_gcode_state","text":"SAVE_GCODE_STATE [NAME=<nom_de_l'\u00e9tat>] : Sauvegarde l'\u00e9tat actuel de l'analyse des coordonn\u00e9es du g-code. La sauvegarde et le r\u00e9tablissement de l'\u00e9tat du g-code sont utiles dans les scripts et les macros. Cette commande enregistre le mode actuel de coordonn\u00e9es absolues en g-code (G90/G91), le mode d'extrusion absolue (M82/M83), l'origine (G92), le d\u00e9calage (SET_GCODE_OFFSET), la priorit\u00e9 de vitesse (M220), la priorit\u00e9 d'extrusion (M221), la vitesse de d\u00e9placement, la position XYZ actuelle et la position relative de l'extrudeuse \"E\". Si NOM est fourni, cela permet de nommer l'\u00e9tat sauvegard\u00e9 avec la cha\u00eene de caract\u00e8res donn\u00e9e. Si le NOM n'est pas fourni, la valeur par d\u00e9faut est \"default\".","title":"SAVE_GCODE_STATE"},{"location":"G-Codes.html#restore_gcode_state","text":"RESTORE_GCODE_STATE [NAME=<nom_de_l'\u00e9tat>] [MOVE=1 [MOVE_SPEED=<speed>]] : Restaure un \u00e9tat pr\u00e9c\u00e9demment sauvegard\u00e9 via SAVE_GCODE_STATE. Si \"MOVE=1\" est sp\u00e9cifi\u00e9, un d\u00e9placement de la t\u00eate d'outil sera effectu\u00e9 pour revenir \u00e0 la position XYZ pr\u00e9c\u00e9dente. Si \"MOVE_SPEED\" est sp\u00e9cifi\u00e9, alors le d\u00e9placement de la t\u00eate d'outil sera effectu\u00e9 avec la vitesse donn\u00e9e (en mm/s) ; sinon, le d\u00e9placement de la t\u00eate d'outil utilisera la vitesse du G-Code restaur\u00e9.","title":"RESTORE_GCODE_STATE"},{"location":"G-Codes.html#hall_filament_width_sensor","text":"Les commandes suivantes sont disponibles lorsque la section de configuration tsl1401cl filament width sensor ou hall filament width sensor est activ\u00e9e (voir \u00e9galement TSLl401CL Filament Width Sensor et Hall Filament Width Sensor ) :","title":"[hall_filament_width_sensor]"},{"location":"G-Codes.html#query_filament_width","text":"QUERY_FILAMENT_WIDTH : Renvoie la largeur actuelle du filament mesur\u00e9.","title":"QUERY_FILAMENT_WIDTH"},{"location":"G-Codes.html#reset_filament_width_sensor","text":"RESET_FILAMENT_WIDTH_SENSOR : Efface toutes les lectures du capteur. Utile apr\u00e8s un changement de filament.","title":"RESET_FILAMENT_WIDTH_SENSOR"},{"location":"G-Codes.html#disable_filament_width_sensor","text":"DISABLE_FILAMENT_WIDTH_SENSOR : D\u00e9sactiver le capteur de largeur de filament et arr\u00eater de l'utiliser pour le contr\u00f4le du flux.","title":"DISABLE_FILAMENT_WIDTH_SENSOR"},{"location":"G-Codes.html#enable_filament_width_sensor","text":"ENABLE_FILAMENT_WIDTH_SENSOR : Activez le capteur de largeur de filament et commencez \u00e0 l'utiliser pour le contr\u00f4le du flux.","title":"ENABLE_FILAMENT_WIDTH_SENSOR"},{"location":"G-Codes.html#query_raw_filament_width","text":"QUERY_RAW_FILAMENT_WIDTH : Renvoie les lectures actuelles des canaux ADC et la valeur RAW du capteur des points de calibration.","title":"QUERY_RAW_FILAMENT_WIDTH"},{"location":"G-Codes.html#enable_filament_width_log","text":"ENABLE_FILAMENT_WIDTH_LOG : Activer la journalisation du diam\u00e8tre.","title":"ENABLE_FILAMENT_WIDTH_LOG"},{"location":"G-Codes.html#disable_filament_width_log","text":"DISABLE_FILAMENT_WIDTH_LOG : D\u00e9sactiver la journalisation du diam\u00e8tre.","title":"DISABLE_FILAMENT_WIDTH_LOG"},{"location":"G-Codes.html#heaters","text":"Le module chauffages est automatiquement charg\u00e9 si un chauffage est d\u00e9fini dans le fichier de configuration.","title":"[heaters]"},{"location":"G-Codes.html#turn_off_heaters","text":"TURN_OFF_HEATERS : \u00c9teindre tous les chauffages.","title":"TURN_OFF_HEATERS"},{"location":"G-Codes.html#temperature_wait","text":"TEMPERATURE_WAIT SENSOR=<nom_config> [MINIMUM=<cible>] [MAXIMUM=<cible>] : Attend jusqu'\u00e0 ce que le capteur de temp\u00e9rature donn\u00e9 soit \u00e0 ou au-dessus du MINIMUM fourni et/ou \u00e0 ou en dessous du MAXIMUM fourni.","title":"TEMPERATURE_WAIT"},{"location":"G-Codes.html#set_heater_temperature","text":"SET_HEATER_TEMPERATURE HEATER=<nom_du_chauffeur> [TARGET=<temp\u00e9rature_cible>] : D\u00e9finit la temp\u00e9rature cible d'un \u00e9l\u00e9ment chauffant. Si une temp\u00e9rature cible n'est pas fournie, la cible est 0.","title":"SET_HEATER_TEMPERATURE"},{"location":"G-Codes.html#idle_timeout","text":"Le module idle_timeout est automatiquement charg\u00e9.","title":"[idle_timeout]"},{"location":"G-Codes.html#set_idle_timeout","text":"SET_IDLE_TIMEOUT [TIMEOUT=<timeout>] : Permet \u00e0 l'utilisateur de d\u00e9finir le d\u00e9lai d'inactivit\u00e9 (en secondes).","title":"SET_IDLE_TIMEOUT"},{"location":"G-Codes.html#input_shaper","text":"La commande suivante est activ\u00e9e si une section de configuration input_shaper a \u00e9t\u00e9 activ\u00e9e (voir \u00e9galement le guide de compensation de r\u00e9sonance ).","title":"[input_shaper]"},{"location":"G-Codes.html#set_input_shaper","text":"SET_INPUT_SHAPER [SHAPER_FREQ_X=<shaper_freq_x>] [SHAPER_FREQ_Y=<shaper_freq_y>] [DAMPING_RATIO_X=<damping_ratio_x>] [DAMPING_RATIO_Y=<damping_ratio_y>] [SHAPER_TYPE=<shaper>] [SHAPER_TYPE_X=<shaper_type_x>] [SHAPER_TYPE_Y=<shaper_type_y>] : Modifie les param\u00e8tres de mise en forme d'entr\u00e9e. Notez que le param\u00e8tre SHAPER_TYPE r\u00e9initialise le shaper d'entr\u00e9e pour les axes X et Y m\u00eame si diff\u00e9rents types de shaper ont \u00e9t\u00e9 configur\u00e9s dans la section [input_shaper]. SHAPER_TYPE ne peut pas \u00eatre utilis\u00e9 avec l'un des param\u00e8tres SHAPER_TYPE_X et SHAPER_TYPE_Y. Voir config reference pour plus de d\u00e9tails sur chacun de ces param\u00e8tres.","title":"SET_INPUT_SHAPER"},{"location":"G-Codes.html#manual_probe","text":"Le module manual_probe est automatiquement charg\u00e9.","title":"[manual_probe]"},{"location":"G-Codes.html#manual_probe_1","text":"MANUAL_PROBE [SPEED=<speed>] : Ex\u00e9cute un script d'aide servant \u00e0 mesurer la hauteur de la buse \u00e0 un point donn\u00e9. Si SPEED est sp\u00e9cifi\u00e9, il d\u00e9finit la vitesse des commandes TESTZ (la valeur par d\u00e9faut est 5mm/s). Pendant un sondage manuel, les commandes suppl\u00e9mentaires suivantes sont disponibles : ACCEPT : Cette commande valide la position Z actuelle et met fin au sondage manuel. ABORT : Cette commande interrompt le sondage manuel. TESTZ Z=<valeur> : Cette commande d\u00e9place la buse vers le haut ou vers le bas de la quantit\u00e9 sp\u00e9cifi\u00e9e dans \"valeur\". Par exemple, TESTZ Z=-.1 d\u00e9placera la buse vers le bas de 0,1mm tandis que TESTZ Z=.1 d\u00e9placera la buse vers le haut de 0,1mm. La valeur peut \u00e9galement \u00eatre + , - , ++ , ou -- pour d\u00e9placer la buse vers le haut ou vers le bas d'une quantit\u00e9 relative aux tentatives pr\u00e9c\u00e9dentes.","title":"MANUAL_PROBE"},{"location":"G-Codes.html#z_endstop_calibrate","text":"Z_ENDSTOP_CALIBRATE [SPEED=<vitesse>] : Ex\u00e9cute un script d'assistance utile pour calibrer un param\u00e8tre de configuration de la position Z_endstop. Voir la commande MANUAL_PROBE pour plus de d\u00e9tails sur les param\u00e8tres et les commandes suppl\u00e9mentaires disponibles lorsque l'outil est actif.","title":"Z_ENDSTOP_CALIBRATE"},{"location":"G-Codes.html#z_offset_apply_endstop","text":"Z_OFFSET_APPLY_ENDSTOP : Prend le d\u00e9calage actuel du Gcode Z (alias, babystepping), et le soustrait de la position endstop_position d\u00e9finie dans stepper_z. Ceci permet de prendre une valeur de babystepping fr\u00e9quemment utilis\u00e9e, et de la rendre permanente. N\u00e9cessite un SAVE_CONFIG pour prendre effet.","title":"Z_OFFSET_APPLY_ENDSTOP"},{"location":"G-Codes.html#manual_stepper","text":"La commande suivante est disponible lorsqu'une section manual_stepper config est activ\u00e9e.","title":"[manual_stepper]"},{"location":"G-Codes.html#manual_stepper_1","text":"MANUAL_STEPPER STEPPER=nom_du_config [ENABLE=[0|1]]] [SET_POSITION=<pos>] [SPEED=<speed>] [ACCEL=<accel>] [MOVE=<pos> [STOP_ON_ENDSTOP=[1|2|-1|-2]] [SYNC=0]] : Cette commande modifie l'\u00e9tat du stepper. Utilisez le param\u00e8tre ENABLE pour activer/d\u00e9sactiver le stepper. Utilisez le param\u00e8tre SET_POSITION pour forcer le moteur pas \u00e0 pas \u00e0 penser qu'il se trouve \u00e0 la position donn\u00e9e. Utilisez le param\u00e8tre MOVE pour d\u00e9placer vers la position donn\u00e9e. Si SPEED et/ou ACCEL sont sp\u00e9cifi\u00e9s, les valeurs donn\u00e9es seront utilis\u00e9es \u00e0 la place de celles par d\u00e9faut issues du fichier de configuration. Si un ACCEL de z\u00e9ro est sp\u00e9cifi\u00e9, aucune acc\u00e9l\u00e9ration ne sera effectu\u00e9e. Si STOP_ON_ENDSTOP=1 est sp\u00e9cifi\u00e9, le d\u00e9placement se terminera pr\u00e9matur\u00e9ment si la fin de course est d\u00e9clench\u00e9e (utilisez STOP_ON_ENDSTOP=2 pour terminer le d\u00e9placement sans erreur m\u00eame si la fin de course n'est pas d\u00e9clench\u00e9e, utilisez -1 ou -2 pour s'arr\u00eater lorsque la fin de course n'est pas d\u00e9clench\u00e9e). Normalement, les futures commandes G-Code seront programm\u00e9es pour \u00eatre ex\u00e9cut\u00e9es apr\u00e8s la fin du d\u00e9placement de la commande de pas, mais si un d\u00e9placement manuel de la commande de pas utilise SYNC=0, les futures commandes de d\u00e9placement G-Code peuvent \u00eatre ex\u00e9cut\u00e9es en parall\u00e8le avec le d\u00e9placement de la commande de pas.","title":"MANUAL_STEPPER"},{"location":"G-Codes.html#mcp4018","text":"La commande suivante est disponible lorsqu'une section mcp4018 config est activ\u00e9e.","title":"[mcp4018]"},{"location":"G-Codes.html#set_digipot","text":"SET_DIGIPOT DIGIPOT=config_name WIPER=<valeur> : Cette commande change la valeur actuelle du digipot. Cette valeur devrait typiquement \u00eatre comprise entre 0.0 et 1.0, \u00e0 moins qu'une '\u00e9chelle' soit d\u00e9finie dans la configuration. Lorsque 'scale' est d\u00e9fini, alors cette valeur doit \u00eatre comprise entre 0.0 et 'scale'.","title":"SET_DIGIPOT"},{"location":"G-Codes.html#led","text":"La commande suivante est disponible lorsque l'une des sections led config est activ\u00e9e.","title":"[led]"},{"location":"G-Codes.html#set_led","text":"SET_LED LED=<nom_de_la_configuration> RED=<valeur> GREEN=<valeur> BLUE=<valeur> WHITE=<valeur> [INDEX=<index>] [TRANSMIT=0] [SYNC=1] : Ceci d\u00e9finit la sortie de la LED. Chaque <valeur> de couleur doit \u00eatre comprise entre 0.0 et 1.0. L'option WHITE n'est valable que pour les LEDs RGBW. Si la LED supporte plusieurs puces dans une cha\u00eene, on peut sp\u00e9cifier INDEX pour modifier la couleur de la seule puce donn\u00e9e (1 pour la premi\u00e8re puce, 2 pour la seconde, etc.). Si INDEX n'est pas sp\u00e9cifi\u00e9, alors toutes les LEDs de la cha\u00eene seront r\u00e9gl\u00e9es sur la couleur fournie. Si TRANSMIT=0 est sp\u00e9cifi\u00e9, le changement de couleur ne sera effectu\u00e9 que lors de la prochaine commande SET_LED qui ne sp\u00e9cifie pas TRANSMIT=0 ; cela peut \u00eatre utile en combinaison avec le param\u00e8tre INDEX pour effectuer plusieurs mises \u00e0 jour dans une cha\u00eene. Par d\u00e9faut, la commande SET_LED synchronisera ses changements avec les autres commandes gcode en cours. Cela peut conduire \u00e0 un comportement ind\u00e9sirable si les LEDs sont r\u00e9gl\u00e9es alors que l'imprimante n'imprime pas, car cela r\u00e9initialisera le d\u00e9lai d'inactivit\u00e9. Si un timing pr\u00e9cis n'est pas n\u00e9cessaire, le param\u00e8tre optionnel SYNC=0 peut \u00eatre sp\u00e9cifi\u00e9 pour appliquer les changements sans r\u00e9initialiser le d\u00e9lai d'inactivit\u00e9.","title":"SET_LED"},{"location":"G-Codes.html#set_led_template","text":"SET_LED_TEMPLATE LED=<nom_de_la_led> TEMPLATE=<nom_du_mod\u00e8le> [<param_x>=<literal>] [INDEX=<index>] : Attribue un mod\u00e8le d'affichage \u00e0 une LED donn\u00e9e. Par exemple, si l'on d\u00e9finit une section de configuration [display_template my_led_template] , on peut affecter TEMPLATE=my_led_template ici. Le mod\u00e8le d'affichage doit produire une cha\u00eene de caract\u00e8res s\u00e9par\u00e9e par des virgules contenant quatre nombres \u00e0 virgule flottante correspondant aux param\u00e8tres de couleur rouge, vert, bleu et blanc. Le mod\u00e8le sera continuellement \u00e9valu\u00e9 et la LED sera automatiquement r\u00e9gl\u00e9e sur les couleurs r\u00e9sultantes. On peut d\u00e9finir des param\u00e8tres display_template \u00e0 utiliser pendant l'\u00e9valuation du mod\u00e8le (les param\u00e8tres seront analys\u00e9s comme des litt\u00e9raux Python). Si INDEX n'est pas sp\u00e9cifi\u00e9, alors toutes les puces dans la cha\u00eene de la LED seront r\u00e9gl\u00e9es sur le mod\u00e8le, sinon seule la puce avec l'index donn\u00e9 sera mise \u00e0 jour. Si TEMPLATE est une cha\u00eene vide, cette commande effacera tout mod\u00e8le pr\u00e9c\u00e9dent assign\u00e9 \u00e0 la LED (on peut alors utiliser les commandes SET_LED pour g\u00e9rer les param\u00e8tres de couleur de la LED).","title":"SET_LED_TEMPLATE"},{"location":"G-Codes.html#output_pin","text":"La commande suivante est disponible lorsqu'une section output_pin config est activ\u00e9e.","title":"[output_pin]"},{"location":"G-Codes.html#set_pin","text":"SET_PIN PIN=config_name VALUE=<value> [CYCLE_TIME=<cycle_time>] : Set the pin to the given output VALUE . VALUE should be 0 or 1 for \"digital\" output pins. For PWM pins, set to a value between 0.0 and 1.0, or between 0.0 and scale if a scale is configured in the output_pin config section. Some pins (currently only \"soft PWM\" pins) support setting an explicit cycle time using the CYCLE_TIME parameter (specified in seconds). Note that the CYCLE_TIME parameter is not stored between SET_PIN commands (any SET_PIN command without an explicit CYCLE_TIME parameter will use the cycle_time specified in the output_pin config section).","title":"SET_PIN"},{"location":"G-Codes.html#palette2","text":"Les commandes suivantes sont disponibles lorsque la section palette2 config est activ\u00e9e. Les impressions avec Palette fonctionnent en int\u00e9grant des OCodes (Omega Codes) sp\u00e9ciaux dans le fichier GCode : O1 ... O32 : Ces codes sont lus \u00e0 partir du flux GCode, trait\u00e9s par ce module et transmis au dispositif Palette 2. Les commandes suppl\u00e9mentaires suivantes sont \u00e9galement disponibles.","title":"[palette2]"},{"location":"G-Codes.html#palette_connect","text":"PALETTE_CONNECT : Cette commande initie la connexion avec Palette 2.","title":"PALETTE_CONNECT"},{"location":"G-Codes.html#palette_disconnect","text":"PALETTE_DISCONNECT : Cette commande permet de se d\u00e9connecter de Palette 2.","title":"PALETTE_DISCONNECT"},{"location":"G-Codes.html#palette_clear","text":"PALETTE_CLEAR : Cette commande demande \u00e0 Palette 2 de purger le filament de tous les chemins d'entr\u00e9e et de sortie.","title":"PALETTE_CLEAR"},{"location":"G-Codes.html#palette_cut","text":"PALETTE_CUT : Cette commande demande \u00e0 Palette 2 de couper le filament actuellement charg\u00e9 dans le noyau de jonction.","title":"PALETTE_CUT"},{"location":"G-Codes.html#palette_smart_load","text":"PALETTE_SMART_LOAD : cette commande initialise la s\u00e9quence de chargement intelligente sur Palette 2. Le filament est charg\u00e9 automatiquement en l\u2019extrudant sur la distance calibr\u00e9e sur l\u2019appareil pour l\u2019imprimante, et l'indique \u00e0 Palette 2 une fois le chargement termin\u00e9. Cette commande revient \u00e0 appuyer sur Smart Load directement sur l\u2019\u00e9cran Palette 2 une fois l'insertion du filament faite.","title":"PALETTE_SMART_LOAD"},{"location":"G-Codes.html#pid_calibrate","text":"Le module pid_calibrate est automatiquement charg\u00e9 si un chauffage est d\u00e9fini dans le fichier de configuration.","title":"[pid_calibrate]"},{"location":"G-Codes.html#pid_calibrate_1","text":"PID_CALIBRATE HEATER=<config_name> TARGET=<temperature> [WRITE_FILE=1] : Effectuer un test d\u2019\u00e9talonnage PID. Le chauffage demand\u00e9 sera activ\u00e9 jusqu\u2019\u00e0 ce que la temp\u00e9rature d\u00e9finie soit atteinte, il s'\u00e9teindra et se rallumera durant plusieurs cycles. Si le param\u00e8tre WRITE_FILE est activ\u00e9, le fichier /tmp/heattest.txt sera cr\u00e9\u00e9 avec un journal de tous les \u00e9chantillons de temp\u00e9rature mesur\u00e9s pendant le test.","title":"PID_CALIBRATE"},{"location":"G-Codes.html#pause_resume","text":"Les commandes suivantes sont disponibles lorsque la section pause_resume config est activ\u00e9e :","title":"[pause_resume]"},{"location":"G-Codes.html#pause","text":"PAUSE : suspend l\u2019impression en cours. La position actuelle est enregistr\u00e9e pour reprendre lorsque demand\u00e9.","title":"PAUSE"},{"location":"G-Codes.html#resume","text":"RESUME [VELOCITY=<value>] : Reprend l'impression \u00e0 la suite d'une pause, en r\u00e9tablissant d'abord la position captur\u00e9e pr\u00e9c\u00e9demment. Le param\u00e8tre VELOCITY d\u00e9termine la vitesse \u00e0 laquelle l'outil doit revenir \u00e0 la position captur\u00e9e d'origine.","title":"RESUME"},{"location":"G-Codes.html#clear_pause","text":"CLEAR_PAUSE : Supprime la mise en pause actuelle sans reprendre l'impression. Ceci est utile si l'on d\u00e9cide d'interrompre une impression apr\u00e8s une PAUSE. Il est recommand\u00e9 d'ajouter ceci \u00e0 votre gcode de d\u00e9marrage pour s'assurer que l'\u00e9tat de pause est r\u00e9initialis\u00e9 pour chaque impression.","title":"CLEAR_PAUSE"},{"location":"G-Codes.html#cancel_print","text":"CANCEL_PRINT : Annule l'impression en cours.","title":"CANCEL_PRINT"},{"location":"G-Codes.html#print_stats","text":"Le module print_stats est automatiquement charg\u00e9.","title":"[print_stats]"},{"location":"G-Codes.html#set_print_stats_info","text":"SET_PRINT_STATS_INFO [TOTAL_LAYER=<nombre_total_de_couches>] [CURRENT_LAYER= <couche_actuelle>] : Passe les informations du trancheur comme le nombre total de couches et celle actuellement en cours \u00e0 Klipper. Ajoutez SET_PRINT_STATS_INFO [TOTAL_LAYER=<nombre_total_de_couches>] \u00e0 votre section gcode de d\u00e9but du trancheur et SET_PRINT_STATS_INFO [CURRENT_LAYER= <couche_actuelle>] \u00e0 la section gcode de changement de couche pour passer les informations de couche de votre trancheur \u00e0 Klipper.","title":"SET_PRINT_STATS_INFO"},{"location":"G-Codes.html#probe","text":"Les commandes suivantes sont disponibles lorsqu'une section probe config ou bltouch config est activ\u00e9e (voir \u00e9galement le guide d'\u00e9talonnage de la sonde ).","title":"[probe]"},{"location":"G-Codes.html#probe_1","text":"PROBE [PROBE_SPEED=<mm/s>] [LIFT_SPEED=<mm/s>] [SAMPLES=<count>] [SAMPLE_RETRACT_DIST=<mm>] [SAMPLES_TOLERANCE=<mm>] [SAMPLES_TOLERANCE_RETRIES=<count>] [SAMPLES_RESULT=median|average] : D\u00e9place la buse vers le bas jusqu'\u00e0 ce que le palpeur se d\u00e9clenche. Si l'un des param\u00e8tres facultatifs est fourni, il remplace son param\u00e8tre \u00e9quivalent dans la section configuration de la sonde .","title":"PROBE"},{"location":"G-Codes.html#query_probe","text":"QUERY_PROBE : Retourne l'\u00e9tat actuel de la sonde (\"triggered\" ou \"open\").","title":"QUERY_PROBE"},{"location":"G-Codes.html#probe_accuracy","text":"PROBE_ACCURACY [PROBE_SPEED=<mm/s>] [SAMPLES=<count>] [SAMPLE_RETRACT_DIST=<mm>] : Calculer le maximum, le minimum, la moyenne, la m\u00e9diane et l\u2019\u00e9cart type des \u00e9chantillons des multiples palpeurs. Par d\u00e9faut, 10 \u00c9CHANTILLONS sont pr\u00e9lev\u00e9s. Sinon, les param\u00e8tres optionnels peuvent \u00eatre d\u00e9finis dans la section de configuration du palpeur.","title":"PROBE_ACCURACY"},{"location":"G-Codes.html#probe_calibrate","text":"PROBE_CALIBRATE [SPEED=<speed>] [<probe_parameter>=<value>] : Ex\u00e9cute l'assistant servant \u00e0 calibrer le z_offset du palpeur. Consultez la commande PROBE pour plus d\u2019informations sur les param\u00e8tres optionnels du palpeur. Reportez-vous \u00e0 la commande MANUAL_PROBE pour plus d\u2019informations sur le param\u00e8tre SPEED et les commandes suppl\u00e9mentaires disponibles lorsque l'assistant est actif. Veuillez noter que la commande PROBE_CALIBRATE utilise la variable de vitesse pour se d\u00e9placer dans la direction XY ainsi que dans Z.","title":"PROBE_CALIBRATE"},{"location":"G-Codes.html#z_offset_apply_probe","text":"Z_OFFSET_APPLY_PROBE : Prend le d\u00e9calage actuel du Gcode Z (alias, babystepping), et le soustrait du z_offset de la sonde. Cela permet de prendre une valeur de babystepping fr\u00e9quemment utilis\u00e9e, et de la rendre permanente. N\u00e9cessite un SAVE_CONFIG pour prendre effet.","title":"Z_OFFSET_APPLY_PROBE"},{"location":"G-Codes.html#query_adc","text":"Le module query_adc est automatiquement charg\u00e9.","title":"[query_adc]"},{"location":"G-Codes.html#query_adc_1","text":"QUERY_ADC [NAME=<nom_de_la_configuration>] [PULLUP=<valeur>] : Rapporte la derni\u00e8re valeur analogique re\u00e7ue pour une broche analogique donn\u00e9e. Si NAME n'est pas fourni, la liste des noms d'adc disponibles est retourn\u00e9e. Si PULLUP est fourni (comme une valeur en Ohms), la valeur analogique brute ainsi que la r\u00e9sistance \u00e9quivalente relative \u00e0 ce pullup est retourn\u00e9e.","title":"QUERY_ADC"},{"location":"G-Codes.html#query_endstops","text":"Le module query_endstops est automatiquement charg\u00e9. Les commandes G-Code standard suivantes sont actuellement disponibles, mais leur utilisation n'est pas recommand\u00e9e : Obtenir le statut Fin de course : M119 (Utilisez QUERY_ENDSTOPS \u00e0 la place.)","title":"[query_endstops]"},{"location":"G-Codes.html#query_endstops_1","text":"QUERY_ENDSTOPS : Teste les but\u00e9es d'axe et indique si elles sont \"d\u00e9clench\u00e9es\" ou dans un \u00e9tat \"ouvert\". Cette commande est g\u00e9n\u00e9ralement utilis\u00e9e pour v\u00e9rifier qu'un butoir de fin de course fonctionne correctement.","title":"QUERY_ENDSTOPS"},{"location":"G-Codes.html#resonance_tester","text":"Les commandes suivantes sont disponibles lorsqu'une section configuration du testeur de r\u00e9sonances est activ\u00e9e (voir \u00e9galement le guide de mesure des r\u00e9sonances ).","title":"[resonance_tester]"},{"location":"G-Codes.html#measure_axes_noise","text":"MEASURE_AXES_NOISE : Mesure et affiche le bruit pour tous les axes de toutes les puces acc\u00e9l\u00e9rom\u00e9triques activ\u00e9es.","title":"MEASURE_AXES_NOISE"},{"location":"G-Codes.html#test_resonances","text":"TEST_RESONANCES AXE=<axe> OUTPUT=<resonances,raw_data> [NOM=<nom>] [FREQ_START=<freq_min>] [FREQ_END=<freq_max>] [HZ_PER_SEC=<hz_par_sec>] [CHIPS=<nom_puce_adxl345>] [POINT=x,y,z] [INPUT_SHAPING=[<0:1>]] : Ex\u00e9cute le test de r\u00e9sonance dans tous les points de sonde configur\u00e9s pour l'\"axe\" demand\u00e9 et mesure l'acc\u00e9l\u00e9ration en utilisant les puces acc\u00e9l\u00e9rom\u00e9tres configur\u00e9es pour l'axe respectif. L'\"axe\" peut \u00eatre X ou Y, ou sp\u00e9cifier une direction arbitraire comme AXIS=dx,dy , o\u00f9 dx et dy sont des nombres \u00e0 virgule flottante d\u00e9finissant un vecteur de direction (par exemple, AXIS=X , AXIS=Y , ou AXIS=1,-1 pour d\u00e9finir une direction diagonale). Notez que AXIS=dx,dy et AXIS=-dx,-dy sont \u00e9quivalents. nom_puce_adxl345 peut \u00eatre une ou plusieurs puces adxl345 configur\u00e9es, d\u00e9limit\u00e9es par des virgules, par exemple CHIPS=\"adxl345, adxl345 rpi\" . Notez que le terme adxl345 peut \u00eatre omis pour les puces adxl345 nomm\u00e9es. Si POINT est indiqu\u00e9, il remplacera le(s) point(s) configur\u00e9(s) dans [resonance_tester] . Si INPUT_SHAPING=0 ou non d\u00e9fini (par d\u00e9faut), d\u00e9sactive la mise en forme de l'entr\u00e9e pour le test de r\u00e9sonance, car il n'est pas valide d'ex\u00e9cuter le test de r\u00e9sonance avec la mise en forme de l'entr\u00e9e active. Le param\u00e8tre OUTPUT consiste en une liste s\u00e9par\u00e9e par des virgules des sorties qui seront \u00e9crites. Si raw_data est demand\u00e9, alors les donn\u00e9es brutes de l'acc\u00e9l\u00e9rom\u00e8tre sont \u00e9crites dans un fichier ou une s\u00e9rie de fichiers /tmp/raw_data_<axe>_[<nom_puce>_][<point>_]<nom>.csv avec (la partie <point>_ du nom g\u00e9n\u00e9r\u00e9e seulement si plus d'un point de sonde est configur\u00e9 ou si POINT est sp\u00e9cifi\u00e9). Si resonances est sp\u00e9cifi\u00e9, la r\u00e9ponse en fr\u00e9quence est calcul\u00e9e (\u00e0 travers tous les points de sonde) et \u00e9crite dans le fichier /tmp/resonances_<axe>_<nom>.csv . S'il n'est pas d\u00e9fini, OUTPUT prend par d\u00e9faut la valeur de resonances , et NAME prend par d\u00e9faut la valeur de l'heure actuelle au format \"AAAAMMJJ_HHMMSS\".","title":"TEST_RESONANCES"},{"location":"G-Codes.html#shaper_calibrate","text":"SHAPER_CALIBRATE [AXIS=<axe>] [NAME=<nom>] [FREQ_START=<freq_min>] [FREQ_END=<freq_max>] [HZ_PER_SEC=<hz_par_sec>] [MAX_SMOOTHING=<adoucissement_max>] : Comme TEST_RESONANCES , ex\u00e9cute le test de r\u00e9sonance tel que configur\u00e9, et essaie de trouver les param\u00e8tres optimaux pour le fa\u00e7onneur d'entr\u00e9e pour l'axe demand\u00e9 (ou les deux axes X et Y si le param\u00e8tre AXIS est d\u00e9sactiv\u00e9). Si MAX_SMOOTHING n'est pas d\u00e9fini, sa valeur est reprise de la section [resonance_tester] , la valeur par d\u00e9faut \u00e9tant non d\u00e9finie. Voir le Max smoothing du guide de la mesure des r\u00e9sonances pour plus d'informations sur l'utilisation de cette fonctionnalit\u00e9. Les r\u00e9sultats de l\u2019\u00e9talonnage sont imprim\u00e9s sur la console, les r\u00e9ponses en fr\u00e9quence et les diff\u00e9rentes valeurs des fa\u00e7onneurs d'entr\u00e9e sont \u00e9crites dans un ou plusieurs fichiers CSV /tmp/calibration_data_<axe>_<nom>.csv . Sauf si sp\u00e9cifi\u00e9, NOM est par d\u00e9faut l'heure actuelle au format \"AAAAMMJJ_HHMMSS\". Notez que les param\u00e8tres de mise en forme d'entr\u00e9e sugg\u00e9r\u00e9s peuvent \u00eatre conserv\u00e9s dans la configuration en \u00e9mettant la commande SAVE_CONFIG .","title":"SHAPER_CALIBRATE"},{"location":"G-Codes.html#respond","text":"Les commandes G-Code standard suivantes sont disponibles lorsque la section respond config est activ\u00e9e : M118 <message> : affiche le message pr\u00e9c\u00e9d\u00e9 du pr\u00e9fixe par d\u00e9faut configur\u00e9 (ou echo : si aucun pr\u00e9fixe n'est configur\u00e9). Les commandes suppl\u00e9mentaires suivantes sont \u00e9galement disponibles.","title":"[respond]"},{"location":"G-Codes.html#respond_1","text":"RESPOND MSG=\"<message>\" : Affiche le message pr\u00e9c\u00e9d\u00e9 du pr\u00e9fixe par d\u00e9faut configur\u00e9 (ou echo : si aucun pr\u00e9fixe n'est configur\u00e9). RESPOND TYPE=echo MSG=\"<message>\" : affiche le message pr\u00e9c\u00e9d\u00e9 par echo : . RESPOND TYPE=echo_no_space MSG=\"<message>\" : renvoie le message pr\u00e9c\u00e9d\u00e9 de echo: sans espace entre le pr\u00e9fixe et le message, utile pour la compatibilit\u00e9 avec certains plugins octoprint qui attendent un formatage tr\u00e8s sp\u00e9cifique. RESPOND TYPE=command MSG=\"<message>\" : renvoie le message pr\u00e9c\u00e9d\u00e9 de // . OctoPrint peut \u00eatre configur\u00e9 pour r\u00e9pondre \u00e0 ces messages (par exemple, RESPOND TYPE=command MSG=action:pause ). RESPOND TYPE=error MSG=\"<message>\" : affiche le message pr\u00e9c\u00e9d\u00e9 par !!! . RESPOND PREFIX=<prefix> MSG=\"<message>\" : renvoie le message pr\u00e9c\u00e9d\u00e9 de <prefix> . (Le param\u00e8tre PREFIX est prioritaire sur le param\u00e8tre TYPE ).","title":"RESPOND"},{"location":"G-Codes.html#save_variables","text":"La commande suivante est activ\u00e9e si une section save_variables config a \u00e9t\u00e9 activ\u00e9e.","title":"[save_variables]"},{"location":"G-Codes.html#save_variable","text":"SAVE_VARIABLE VARIABLE=<nom> VALUE=<valeur> : Enregistre la variable sur le disque afin qu'elle puisse \u00eatre utilis\u00e9e lors des red\u00e9marrages. Toutes les variables enregistr\u00e9es sont charg\u00e9es dans le dict printer.save_variables.variables au d\u00e9marrage et peuvent \u00eatre utilis\u00e9es dans des macros gcode. La VALEUR fournie est analys\u00e9e comme un litt\u00e9ral Python.","title":"SAVE_VARIABLE"},{"location":"G-Codes.html#screws_tilt_adjust","text":"Les commandes suivantes sont disponibles lorsque la section de configuration screws_tilt_adjust est activ\u00e9e (voir \u00e9galement le guide du nivelage manuel ).","title":"[screws_tilt_adjust]"},{"location":"G-Codes.html#screws_tilt_calculate","text":"SCREWS_TILT_CALCULATE [DIRECTION=CW|CCW] [MAX_DEVIATION=<valeur>] [<probe_parameter>=<valeur>] : Cette commande invoquera l'outil de r\u00e9glage des vis du lit. Elle d\u00e9placera la buse \u00e0 diff\u00e9rents endroits (tels que d\u00e9finis dans le fichier de configuration) en palpant la hauteur z et calculera le nombre de tours de la molette de r\u00e9glage pour ajuster le niveau du lit. Si DIRECTION est sp\u00e9cifi\u00e9, les tours de la molette seront tous dans la m\u00eame direction, dans le sens des aiguilles d'une montre (CW) ou dans le sens inverse (CCW). Voir la commande PROBE pour plus de d\u00e9tails sur les param\u00e8tres optionnels de la sonde. IMPORTANT : Vous DEVEZ toujours effectuer un G28 avant d'utiliser cette commande. Si MAX_DEVIATION est sp\u00e9cifi\u00e9, la commande d\u00e9clenchera une erreur de gcode si une diff\u00e9rence de hauteur de vis par rapport \u00e0 la hauteur de vis de base est sup\u00e9rieure \u00e0 la valeur fournie.","title":"SCREWS_TILT_CALCULATE"},{"location":"G-Codes.html#sdcard_loop","text":"Lorsque la section de configuration sdcard_loop est activ\u00e9e, les commandes \u00e9tendues suivantes sont disponibles.","title":"[sdcard_loop]"},{"location":"G-Codes.html#sdcard_loop_begin","text":"SDCARD_LOOP_BEGIN COUNT=<compte> : Commence une section boucl\u00e9e dans l'impression SD. Un compte de 0 indique que la section doit \u00eatre boucl\u00e9e ind\u00e9finiment.","title":"SDCARD_LOOP_BEGIN"},{"location":"G-Codes.html#sdcard_loop_end","text":"SDCARD_LOOP_END : Termine une section de boucle dans l'impression SD.","title":"SDCARD_LOOP_END"},{"location":"G-Codes.html#sdcard_loop_desist","text":"SDCARD_LOOP_DESIST : Termine les boucles existantes sans autres it\u00e9rations.","title":"SDCARD_LOOP_DESIST"},{"location":"G-Codes.html#servo","text":"Les commandes suivantes sont disponibles lorsqu'une section servo config est activ\u00e9e.","title":"[servo]"},{"location":"G-Codes.html#set_servo","text":"SET_SERVO SERVO=nom_config [ANGLE=<degr\u00e9s> | LARGEUR=<secondes>] : D\u00e9finit la position du servo \u00e0 l'angle (en degr\u00e9s) ou \u00e0 la largeur d'impulsion (en secondes) donn\u00e9s. Utilisez WIDTH=0 pour d\u00e9sactiver la sortie du servo.","title":"SET_SERVO"},{"location":"G-Codes.html#skew_correction","text":"Les commandes suivantes sont disponibles lorsque la section de configuration skew_correction est activ\u00e9e (voir \u00e9galement le guide Skew Correction ).","title":"[skew_correction]"},{"location":"G-Codes.html#set_skew","text":"SET_SKEW [XY=<ac_length,bd_length,ad_length>] [XZ=<ac,bd,ad>] [YZ=<ac,bd,ad>] [CLEAR=<0|1>] : Configure le module [skew_correction] avec des mesures (en mm) prises \u00e0 partir d'une impression d'\u00e9talonnage. On peut entrer des mesures pour n'importe quelle combinaison de plans, les plans non entr\u00e9s conserveront leur valeur actuelle. Si CLEAR=1 est entr\u00e9, toute correction d'inclinaison sera d\u00e9sactiv\u00e9e.","title":"SET_SKEW"},{"location":"G-Codes.html#get_current_skew","text":"GET_CURRENT_SKEW : Indique l'inclinaison actuelle de l'imprimante pour chaque plan en radians et en degr\u00e9s. L'inclinaison est calcul\u00e9e en fonction des param\u00e8tres fournis par le gcode SET_SKEW .","title":"GET_CURRENT_SKEW"},{"location":"G-Codes.html#calc_measured_skew","text":"CALC_MEASURED_SKEW [AC=<ac_length>] [BD=<bd_length>] [AD=<ad_length>] : Calcule et rapporte l'inclinaison (en radians et en degr\u00e9s) bas\u00e9e sur une impression mesur\u00e9e. Cela peut \u00eatre utile pour d\u00e9terminer l'inclinaison actuelle de l'imprimante apr\u00e8s l'application de la correction. Elle peut \u00e9galement \u00eatre utile avant l'application de la correction pour d\u00e9terminer si une correction de l'inclinaison est n\u00e9cessaire. Reportez-vous \u00e0 la section [Correction de l'obliquit\u00e9] (Skew_Correction.md) pour plus de d\u00e9tails sur les objets et les mesures de calibrage de l'obliquit\u00e9.","title":"CALC_MEASURED_SKEW"},{"location":"G-Codes.html#skew_profile","text":"SKEW_PROFILE [LOAD=<nom>] [SAVE=<nom>] [REMOVE=<nom>] : Gestion des profils pour la correction de l'obliquit\u00e9. LOAD restaurera l'\u00e9tat d'inclinaison \u00e0 partir du profil correspondant au nom fourni. SAVE sauvegardera l'\u00e9tat actuel d'inclinaison dans un profil correspondant au nom fourni. Remove supprimera le profil correspondant au nom fourni de la m\u00e9moire persistante. Notez qu'apr\u00e8s l'ex\u00e9cution des op\u00e9rations SAVE ou REMOVE, le gcode SAVE_CONFIG doit \u00eatre ex\u00e9cut\u00e9 pour que les modifications apport\u00e9es \u00e0 la m\u00e9moire permanente deviennent permanentes.","title":"SKEW_PROFILE"},{"location":"G-Codes.html#smart_effector","text":"Plusieurs commandes sont disponibles lorsqu'une section de configuration smart_effector est activ\u00e9e. Assurez-vous de consulter la documentation officielle du Smart Effector sur le Duet3D Wiki avant de modifier les param\u00e8tres du Smart Effector. Consultez \u00e9galement le guide d'\u00e9talonnage de la sonde .","title":"[smart_effector]"},{"location":"G-Codes.html#set_smart_effector","text":"SET_SMART_EFFECTOR [SENSITIVITY=<sensitivity>] [ACCEL=<accel>] [RECOVERY_TIME=<time>] : D\u00e9finit les param\u00e8tres du Smart Effector. Lorsque SENSITIVITY est sp\u00e9cifi\u00e9, la valeur respective est \u00e9crite dans l'EEPROM du SmartEffecteur (n\u00e9cessite que control_pin soit fourni). Les valeurs acceptables de <sensitivity> sont 0..255, la valeur par d\u00e9faut est 50. Des valeurs plus faibles n\u00e9cessitent moins de force de contact de la buse pour se d\u00e9clencher (mais il y a un plus grand risque de faux d\u00e9clenchement d\u00fb aux vibrations pendant le palpage), des valeurs plus \u00e9lev\u00e9es r\u00e9duisent les faux d\u00e9clenchements (mais n\u00e9cessitent une plus grande force de contact pour se d\u00e9clencher). Comme la sensibilit\u00e9 est \u00e9crite dans l'EEPROM, elle est conserv\u00e9e apr\u00e8s l'arr\u00eat, il n'est donc pas n\u00e9cessaire de la configurer \u00e0 chaque d\u00e9marrage de l'imprimante. ACCEL et RECOVERY_TIME permettent de modifier les param\u00e8tres correspondants lors de l'ex\u00e9cution, voir la section config de Smart Effector pour plus d'informations sur ces param\u00e8tres.","title":"SET_SMART_EFFECTOR"},{"location":"G-Codes.html#reset_smart_effector","text":"RESET_SMART_EFFECTOR : R\u00e9initialise la sensibilit\u00e9 du Smart Effector \u00e0 ses param\u00e8tres d'usine. N\u00e9cessite que control_pin soit fourni dans la section de configuration.","title":"RESET_SMART_EFFECTOR"},{"location":"G-Codes.html#stepper_enable","text":"Le module stepper_enable est automatiquement charg\u00e9.","title":"[stepper_enable]"},{"location":"G-Codes.html#set_stepper_enable","text":"SET_STEPPER_ENABLE STEPPER=<nom_de_la_configuration> ENABLE=[0|1] : Active ou d\u00e9sactive uniquement le stepper donn\u00e9. Il s'agit d'un outil de diagnostic et de d\u00e9bogage qui doit donc \u00eatre utilis\u00e9 avec pr\u00e9caution. La d\u00e9sactivation d'un moteur d'axe ne r\u00e9initialise pas les informations d'orientation. Le d\u00e9placement manuel d'un moteur pas \u00e0 pas d\u00e9sactiv\u00e9 peut amener la machine \u00e0 faire fonctionner le moteur en dehors des limites de s\u00e9curit\u00e9. Cela peut entra\u00eener des dommages aux composants de l'axe, aux extr\u00e9mit\u00e9s chaudes et \u00e0 la surface d'impression.","title":"SET_STEPPER_ENABLE"},{"location":"G-Codes.html#temperature_fan","text":"La commande suivante est disponible lorsqu'une section temperature_fan config est activ\u00e9e.","title":"[temperature_fan]"},{"location":"G-Codes.html#set_temperature_fan_target","text":"SET_TEMPERATURE_FAN_TARGET temperature_fan=<nom_du_ventilateur_temp\u00e9rature> [target=<temp\u00e9rature_cible>] [min_speed=<vitesse_min>] [max_speed=<vitesse_max>] : D\u00e9finit la temp\u00e9rature cible d'un ventilateur_temp\u00e9rature. Si une cible n'est pas fournie, elle est fix\u00e9e \u00e0 la temp\u00e9rature sp\u00e9cifi\u00e9e dans le fichier de configuration. Si les vitesses ne sont pas fournies, aucun changement n'est appliqu\u00e9.","title":"SET_TEMPERATURE_FAN_TARGET"},{"location":"G-Codes.html#tmcxxxx","text":"Les commandes suivantes sont disponibles lorsque l'une des sections tmcXXXX config est activ\u00e9e.","title":"[tmcXXXX]"},{"location":"G-Codes.html#dump_tmc","text":"DUMP_TMC STEPPER=<nom> : Cette commande lit les registres du pilote TMC et renvoie leurs valeurs.","title":"DUMP_TMC"},{"location":"G-Codes.html#init_tmc","text":"INIT_TMC STEPPER=<nom> : Cette commande initialise les registres de la puce TMC. N\u00e9cessaire pour r\u00e9activer le pilote si l'alimentation de la puce est coup\u00e9e puis r\u00e9tablie.","title":"INIT_TMC"},{"location":"G-Codes.html#set_tmc_current","text":"SET_TMC_CURRENT STEPPER=<nom> CURRENT=<amps> HOLDCURRENT=<amps> : Ceci ajustera les courants de marche et de maintien du pilote TMC. (HOLDCURRENT n'est pas applicable aux pilotes tmc2660).","title":"SET_TMC_CURRENT"},{"location":"G-Codes.html#set_tmc_field","text":"SET_TMC_FIELD STEPPER=<nom> FIELD=<champ> VALUE=<valeur> : Cette commande modifie la valeur du champ de registre sp\u00e9cifi\u00e9 du pilote TMC. Cette commande est destin\u00e9e aux diagnostics de bas niveau et au d\u00e9bogage uniquement car la modification des champs pendant l'ex\u00e9cution peut entra\u00eener un comportement ind\u00e9sirable et potentiellement dangereux de votre imprimante. Les modifications permanentes doivent \u00eatre effectu\u00e9es \u00e0 l'aide du fichier de configuration de l'imprimante. Aucun contr\u00f4le d'int\u00e9grit\u00e9 n'est effectu\u00e9 pour les valeurs donn\u00e9es.","title":"SET_TMC_FIELD"},{"location":"G-Codes.html#toolhead","text":"Le module de t\u00eate d'outil est automatiquement charg\u00e9.","title":"[toolhead]"},{"location":"G-Codes.html#set_velocity_limit","text":"SET_VELOCITY_LIMIT [VELOCITY=<valeur>] [ACCEL=<valeur>] [ACCEL_TO_DECEL=<valeur>] [SQUARE_CORNER_VELOCITY=<valeur>] : Modifie les limites de v\u00e9locit\u00e9 de l'imprimante.","title":"SET_VELOCITY_LIMIT"},{"location":"G-Codes.html#tuning_tower","text":"Le module tuning_tower est automatiquement charg\u00e9.","title":"[tuning_tower]"},{"location":"G-Codes.html#tuning_tower_1","text":"TUNING_TOWER COMMAND=<commande> PARAMETER=<nom> START=<valeur> [SKIP=<valeur>] [FACTOR=<valeur> [BAND=<valeur>]]. | [STEP_DELTA=<valeur> STEP_HEIGHT=<valeur>] : Un outil pour affiner un param\u00e8tre sur chaque hauteur Z pendant une impression. L'outil ex\u00e9cutera la COMMANDE donn\u00e9e avec le PARAM\u00c8TRE donn\u00e9 assign\u00e9 \u00e0 une valeur qui varie avec Z selon une formule. Utilisez FACTOR si vous allez utiliser une r\u00e8gle ou un pied \u00e0 coulisse pour mesurer la hauteur Z de la valeur optimale, ou STEP_DELTA et STEP_HEIGHT si le mod\u00e8le de tour de r\u00e9glage a des bandes de valeurs discr\u00e8tes comme c'est le cas avec les tours de temp\u00e9rature. Si SKIP=<valeur> est sp\u00e9cifi\u00e9, le processus de r\u00e9glage ne commence pas avant que la hauteur Z <valeur> soit atteinte, et en dessous, la valeur sera mise \u00e0 START ; dans ce cas, la z_height utilis\u00e9e dans les formules ci-dessous est en fait max(z - skip, 0) . Il y a trois combinaisons possibles d'options : FACTOR : La valeur change \u00e0 un taux de factor par millim\u00e8tre. La formule utilis\u00e9e est : valeur = start + factor * z_height . Vous pouvez ins\u00e9rer la hauteur Z optimale directement dans la formule pour d\u00e9terminer la valeur optimale du param\u00e8tre. FACTOR and BAND : La valeur change \u00e0 un taux moyen de factor par millim\u00e8tre, mais dans des bandes discr\u00e8tes o\u00f9 l'ajustement ne sera fait que tous les BAND millim\u00e8tres de hauteur Z. La formule utilis\u00e9e est : valeur =start + factor * ((floor(z_height / band) + .5) * band) . STEP_DELTA et STEP_HEIGHT : La valeur change de STEP_DELTA tous les millim\u00e8tres de STEP_HEIGHT . La formule utilis\u00e9e est : valeur = start + step_delta * floor(z_height / step_height) . Vous pouvez simplement compter les bandes ou lire les \u00e9tiquettes des tours de r\u00e9glage pour d\u00e9terminer la valeur optimale.","title":"TUNING_TOWER"},{"location":"G-Codes.html#virtual_sdcard","text":"Klipper prend en charge les commandes G-Code standards suivantes si la section de configuration virtual_sdcard est activ\u00e9e : Liste des cartes SD : M20 Initialiser la carte SD : M21 S\u00e9lectionnez le fichier SD : M23 <nom du fichier> D\u00e9marrer/reprendre l'impression SD : M24 Suspendre l'impression depuis la SD : M25 D\u00e9finir la position SD : M26 S<d\u00e9calage> Afficher l'\u00e9tat d'impression depuis la carte SD : M27 En outre, les commandes \u00e9tendues suivantes sont disponibles lorsque la section de configuration \"virtual_sdcard\" est activ\u00e9e.","title":"[virtual_sdcard]"},{"location":"G-Codes.html#sdcard_print_file","text":"SDCARD_PRINT_FILE FILENAME=<nom_fichier> : Charge un fichier et lance l'impression SD.","title":"SDCARD_PRINT_FILE"},{"location":"G-Codes.html#sdcard_reset_file","text":"SDCARD_RESET_FILE : D\u00e9charge le fichier et efface l'\u00e9tat de la carte SD.","title":"SDCARD_RESET_FILE"},{"location":"G-Codes.html#z_thermal_adjust","text":"Les commandes suivantes sont disponibles lorsque la section z_thermal_adjust config est activ\u00e9e.","title":"[z_thermal_adjust]"},{"location":"G-Codes.html#set_z_thermal_adjust","text":"SET_Z_THERMAL_ADJUST [ENABLE=<0:1>] [TEMP_COEFF=<valeur>] [REF_TEMP=<valeur>] : Active ou d\u00e9sactive l'ajustement thermique Z avec ENABLE . La d\u00e9sactivation ne supprime pas l'ajustement d\u00e9j\u00e0 appliqu\u00e9, mais g\u00e8le la valeur d'ajustement actuelle - cela emp\u00eache un mouvement Z vers le bas potentiellement dangereux. La r\u00e9activation peut potentiellement causer un mouvement de l'outil vers le haut lorsque l'ajustement est mis \u00e0 jour et appliqu\u00e9. TEMP_COEFF permet de r\u00e9gler le coefficient de temp\u00e9rature de l'ajustement en cours d'ex\u00e9cution (c'est-\u00e0-dire le param\u00e8tre de configuration TEMP_COEFF ). Les valeurs de TEMP_COEFF ne sont pas sauvegard\u00e9es dans la config. REF_TEMP remplace manuellement la temp\u00e9rature de r\u00e9f\u00e9rence g\u00e9n\u00e9ralement r\u00e9gl\u00e9e pendant le retour \u00e0 l'origine (pour une utilisation dans des routines de retour \u00e0 l'origine non standard) - sera remis \u00e0 z\u00e9ro automatiquement lors du retour \u00e0 l'origine.","title":"SET_Z_THERMAL_ADJUST"},{"location":"G-Codes.html#z_tilt","text":"Les commandes suivantes sont disponibles lorsque la section z_tilt config est activ\u00e9e.","title":"[z_tilt]"},{"location":"G-Codes.html#z_tilt_adjust","text":"Z_TILT_ADJUST [<probe_parameter>=<valeur>] : Cette commande palpe les points sp\u00e9cifi\u00e9s dans la configuration et effectue ensuite des ajustements ind\u00e9pendants pour chaque moteur Z afin de compenser l'inclinaison. Reportez-vous \u00e0 la commande PROBE pour plus de d\u00e9tails sur les param\u00e8tres de palpage optionnels.","title":"Z_TILT_ADJUST"},{"location":"Hall_Filament_Width_Sensor.html","text":"D\u00e9tecteur de largeur de filament \u00e0 effet hall \u00b6 Ce document d\u00e9crit le module h\u00f4te du capteur de largeur de filament. Le mat\u00e9riel utilis\u00e9 pour d\u00e9velopper ce module h\u00f4te est bas\u00e9 sur deux capteurs lin\u00e9aires de type Hall (ss49e par exemple). Les capteurs dans le corps sont situ\u00e9s sur des c\u00f4t\u00e9s oppos\u00e9s. Principe de fonctionnement : deux capteurs Hall fonctionnent en mode diff\u00e9rentiel, la d\u00e9rive de temp\u00e9rature est la m\u00eame pour tous les capteurs. Une compensation sp\u00e9ciale de la temp\u00e9rature n'est donc pas n\u00e9cessaire. Vous trouverez les mod\u00e8les sur Thingiverse , une vid\u00e9o de montage est \u00e9galement disponible sur Youtube Pour utiliser le capteur de largeur de filament de Hall, consultez R\u00e9f\u00e9rence des configurations et documentation G-Code . Comment cela fonctionne-t-il ? \u00b6 Le capteur g\u00e9n\u00e8re deux sorties analogiques bas\u00e9es sur la largeur calcul\u00e9e du filament. La somme des tensions de sortie est toujours \u00e9gale \u00e0 la largeur de filament d\u00e9tect\u00e9e. Le module h\u00f4te surveille les changements de tension et ajuste le multiplicateur d'extrusion. J'utilise le connecteur aux2 sur les broches analogiques 11 et 12 d'une carte genre Ramps. Vous pouvez utiliser des broches diff\u00e9rentes et des cartes diff\u00e9rentes. Mod\u00e8le pour les variables du menu \u00b6 [menu __main __filament __width_current] type: command enable: {'hall_filament_width_sensor' in printer} name: Dia: {'%.2F' % printer.hall_filament_width_sensor.Diameter} index: 0 [menu __main __filament __raw_width_current] type: command enable: {'hall_filament_width_sensor' in printer} name: Raw: {'%4.0F' % printer.hall_filament_width_sensor.Raw} index: 1 Proc\u00e9dure d'\u00e9talonnage \u00b6 Pour obtenir la valeur brute du capteur, vous pouvez utiliser le menu ou la commande QUERY_RAW_FILAMENT_WIDTH dans le terminal. Ins\u00e9rer la premi\u00e8re tige d'\u00e9talonnage (taille 1,5 mm) pour obtenir la premi\u00e8re valeur brute du capteur Ins\u00e9rer une deuxi\u00e8me tige d'\u00e9talonnage (taille 2,0 mm) pour obtenir la deuxi\u00e8me valeur brute du capteur Enregistrer les valeurs brutes des capteurs dans les param\u00e8tres de configuration Raw_dia1 et Raw_dia2 Comment activer le capteur \u00b6 Par d\u00e9faut, le capteur est d\u00e9sactiv\u00e9 \u00e0 la mise sous tension. Pour activer le capteur, lancez la commande ENABLE_FILAMENT_WIDTH_SENSOR ou d\u00e9finissez le param\u00e8tre enable sur true . Journalisation \u00b6 Par d\u00e9faut, la journalisation du diam\u00e8tre est d\u00e9sactiv\u00e9e \u00e0 la mise sous tension. Envoyez la commande ENABLE_FILAMENT_WIDTH_LOG pour d\u00e9marrer la journalisation, envoyez la commande DISABLE_FILAMENT_WIDTH_LOG pour l'arr\u00eater. Pour activer la journalisation \u00e0 la mise sous tension, d\u00e9finissez le param\u00e8tre logging \u00e0 true . Le diam\u00e8tre du filament est enregistr\u00e9 \u00e0 chaque intervalle de mesure (10 mm par d\u00e9faut).","title":"D\u00e9tecteur de largeur de filament \u00e0 effet hall"},{"location":"Hall_Filament_Width_Sensor.html#detecteur-de-largeur-de-filament-a-effet-hall","text":"Ce document d\u00e9crit le module h\u00f4te du capteur de largeur de filament. Le mat\u00e9riel utilis\u00e9 pour d\u00e9velopper ce module h\u00f4te est bas\u00e9 sur deux capteurs lin\u00e9aires de type Hall (ss49e par exemple). Les capteurs dans le corps sont situ\u00e9s sur des c\u00f4t\u00e9s oppos\u00e9s. Principe de fonctionnement : deux capteurs Hall fonctionnent en mode diff\u00e9rentiel, la d\u00e9rive de temp\u00e9rature est la m\u00eame pour tous les capteurs. Une compensation sp\u00e9ciale de la temp\u00e9rature n'est donc pas n\u00e9cessaire. Vous trouverez les mod\u00e8les sur Thingiverse , une vid\u00e9o de montage est \u00e9galement disponible sur Youtube Pour utiliser le capteur de largeur de filament de Hall, consultez R\u00e9f\u00e9rence des configurations et documentation G-Code .","title":"D\u00e9tecteur de largeur de filament \u00e0 effet hall"},{"location":"Hall_Filament_Width_Sensor.html#comment-cela-fonctionne-t-il","text":"Le capteur g\u00e9n\u00e8re deux sorties analogiques bas\u00e9es sur la largeur calcul\u00e9e du filament. La somme des tensions de sortie est toujours \u00e9gale \u00e0 la largeur de filament d\u00e9tect\u00e9e. Le module h\u00f4te surveille les changements de tension et ajuste le multiplicateur d'extrusion. J'utilise le connecteur aux2 sur les broches analogiques 11 et 12 d'une carte genre Ramps. Vous pouvez utiliser des broches diff\u00e9rentes et des cartes diff\u00e9rentes.","title":"Comment cela fonctionne-t-il ?"},{"location":"Hall_Filament_Width_Sensor.html#modele-pour-les-variables-du-menu","text":"[menu __main __filament __width_current] type: command enable: {'hall_filament_width_sensor' in printer} name: Dia: {'%.2F' % printer.hall_filament_width_sensor.Diameter} index: 0 [menu __main __filament __raw_width_current] type: command enable: {'hall_filament_width_sensor' in printer} name: Raw: {'%4.0F' % printer.hall_filament_width_sensor.Raw} index: 1","title":"Mod\u00e8le pour les variables du menu"},{"location":"Hall_Filament_Width_Sensor.html#procedure-detalonnage","text":"Pour obtenir la valeur brute du capteur, vous pouvez utiliser le menu ou la commande QUERY_RAW_FILAMENT_WIDTH dans le terminal. Ins\u00e9rer la premi\u00e8re tige d'\u00e9talonnage (taille 1,5 mm) pour obtenir la premi\u00e8re valeur brute du capteur Ins\u00e9rer une deuxi\u00e8me tige d'\u00e9talonnage (taille 2,0 mm) pour obtenir la deuxi\u00e8me valeur brute du capteur Enregistrer les valeurs brutes des capteurs dans les param\u00e8tres de configuration Raw_dia1 et Raw_dia2","title":"Proc\u00e9dure d'\u00e9talonnage"},{"location":"Hall_Filament_Width_Sensor.html#comment-activer-le-capteur","text":"Par d\u00e9faut, le capteur est d\u00e9sactiv\u00e9 \u00e0 la mise sous tension. Pour activer le capteur, lancez la commande ENABLE_FILAMENT_WIDTH_SENSOR ou d\u00e9finissez le param\u00e8tre enable sur true .","title":"Comment activer le capteur"},{"location":"Hall_Filament_Width_Sensor.html#journalisation","text":"Par d\u00e9faut, la journalisation du diam\u00e8tre est d\u00e9sactiv\u00e9e \u00e0 la mise sous tension. Envoyez la commande ENABLE_FILAMENT_WIDTH_LOG pour d\u00e9marrer la journalisation, envoyez la commande DISABLE_FILAMENT_WIDTH_LOG pour l'arr\u00eater. Pour activer la journalisation \u00e0 la mise sous tension, d\u00e9finissez le param\u00e8tre logging \u00e0 true . Le diam\u00e8tre du filament est enregistr\u00e9 \u00e0 chaque intervalle de mesure (10 mm par d\u00e9faut).","title":"Journalisation"},{"location":"Installation.html","text":"Installation \u00b6 Ces instructions supposent que le logiciel fonctionnera sur un ordinateur Raspberry Pi en conjonction avec OctoPrint. Il est recommand\u00e9 d'utiliser un ordinateur Raspberry Pi 2, 3 ou 4 comme machine h\u00f4te (voir la FAQ pour les autres machines). Obtenir un fichier de configuration de Klipper \u00b6 La plupart des param\u00e8tres de Klipper sont d\u00e9termin\u00e9s par un \"fichier de configuration d'imprimante\" stock\u00e9 sur le Raspberry Pi. Un fichier de configuration appropri\u00e9 peut souvent \u00eatre trouv\u00e9 en recherchant dans le r\u00e9pertoire des configurations de Klipper, un fichier commen\u00e7ant par un pr\u00e9fixe \"printer-\" correspondant \u00e0 l'imprimante cible. Le fichier de configuration de Klipper contient des informations techniques sur l'imprimante n\u00e9cessaires pendant l'installation. S'il n'y a pas de fichier de configuration d'imprimante appropri\u00e9 dans le r\u00e9pertoire des configurations de Klipper, essayez de rechercher le site Web du fabricant de l'imprimante pour voir s'il y a un fichier de configuration Klipper appropri\u00e9. Si aucun fichier de configuration pour l'imprimante ne peut \u00eatre trouv\u00e9, mais que le type de carte de contr\u00f4le de l'imprimante est connu, recherchez un fichier de configuration appropri\u00e9 commen\u00e7ant par un pr\u00e9fixe \"generic-\". Ces exemples de fichiers de carte d'imprimante devraient permettre de r\u00e9aliser avec succ\u00e8s l'installation initiale, mais n\u00e9cessiteront une personnalisation afin d'obtenir la fonctionnalit\u00e9 compl\u00e8te de l'imprimante. Il est \u00e9galement possible de d\u00e9finir une nouvelle configuration d'imprimante en partant de z\u00e9ro. Toutefois, cela n\u00e9cessite des connaissances techniques importantes sur l'imprimante et son \u00e9lectronique. Il est recommand\u00e9 \u00e0 la plupart des utilisateurs de commencer par un fichier de configuration appropri\u00e9. Si vous cr\u00e9ez un nouveau fichier de configuration d'imprimante personnalis\u00e9, commencez par l'exemple d'un fichier de configuration proche et utilisez la r\u00e9f\u00e9rence de configuration de Klipper pour plus d'informations. Pr\u00e9paration de l'image du syst\u00e8me d'exploitation (OS) \u00b6 Commencez par installer OctoPi sur l'ordinateur Raspberry Pi. Utilisez OctoPi v0.17.0 ou plus r\u00e9cent - voir les OctoPi releases pour les informations de versions. Il faut v\u00e9rifier que OctoPi d\u00e9marre et que le serveur web OctoPrint fonctionne. Apr\u00e8s s'\u00eatre connect\u00e9 \u00e0 la page web d'OctoPrint, suivez les instructions pour mettre \u00e0 jour OctoPrint \u00e0 la version v1.4.2 ou ult\u00e9rieure. Apr\u00e8s avoir install\u00e9 OctoPi et mis \u00e0 jour OctoPrint, il sera n\u00e9cessaire de se connecter via ssh \u00e0 la machine cible pour ex\u00e9cuter quelques commandes syst\u00e8me. Si vous utilisez un bureau Linux ou MacOS, le logiciel \"ssh\" devrait d\u00e9j\u00e0 \u00eatre install\u00e9 sur le bureau. Il existe des clients ssh gratuits pour d'autres ordinateurs de bureau (par exemple, PuTTY ). Utilisez l'utilitaire ssh pour vous connecter au Raspberry Pi (ssh pi@octopi -- le mot de passe par d\u00e9faut est \"raspberry\") et ex\u00e9cutez les commandes suivantes : git clone https://github.com/Klipper3d/klipper ./klipper/scripts/install-octopi.sh L'op\u00e9ration ci-dessus permet de t\u00e9l\u00e9charger Klipper, d'installer certaines d\u00e9pendances du syst\u00e8me, de configurer Klipper pour qu'il soit ex\u00e9cut\u00e9 au d\u00e9marrage du syst\u00e8me et de lancer le logiciel h\u00f4te Klipper. Une connexion Internet est n\u00e9cessaire et l'op\u00e9ration peut prendre quelques minutes. Compilation et flashage du micro-contr\u00f4leur \u00b6 Pour compiler le code du microcontr\u00f4leur, commencez par ex\u00e9cuter ces commandes sur le Raspberry Pi : cd ~/klipper/ make menuconfig Les commentaires en haut du fichier de configuration de l'imprimante devraient d\u00e9crire les param\u00e8tres qui doivent \u00eatre d\u00e9finis pendant le \"make menuconfig\". Ouvrez le fichier dans un navigateur Web ou un \u00e9diteur de texte et recherchez ces instructions en haut du fichier. Une fois que les param\u00e8tres appropri\u00e9s de \"menuconfig\" ont \u00e9t\u00e9 configur\u00e9s, appuyez sur \"Q\" pour quitter, puis sur \"Y\" pour enregistrer. Ensuite, ex\u00e9cutez : make Si les commentaires au haut de printer configuration file d\u00e9crive des \u00e9tapes pour le \"flashing\" de l'image finale sur la carte de contr\u00f4le de l'imprimante alors suivez ces \u00e9tapes puis proc\u00e9dez \u00e0 configuring OctoPrint . Sinon, les \u00e9tapes suivantes sont souvent utilis\u00e9es pour le \"flash\" de la carte de contr\u00f4le de l'imprimante. D'abord, il est n\u00e9cessaire de d\u00e9terminer le port s\u00e9rie connect\u00e9 au micro-contr\u00f4leur. Lancez ceci : ls /dev/serial/by-id/* Il devrait retourner quelque chose de similaire \u00e0 ce qui suit : /dev/serial/by-id/usb-1a86_USB2.0-Serial-if00-port0 Il est courant que chaque imprimante ait son propre nom de port s\u00e9rie unique. Ce nom unique sera utilis\u00e9 lors du flashage du micro-contr\u00f4leur. Il est possible qu'il y ait plusieurs lignes dans la sortie ci-dessus - si c'est le cas, choisissez la ligne correspondant au micro-contr\u00f4leur (voir la FAQ pour plus d'informations). Pour les micro-contr\u00f4leurs courants, le code peut \u00eatre flash\u00e9 avec quelque chose de similaire : sudo service klipper stop make flash FLASH_DEVICE=/dev/serial/by-id/usb-1a86_USB2.0-Serial-if00-port0 sudo service klipper start Veillez \u00e0 mettre \u00e0 jour le FLASH_DEVICE avec le nom unique du port s\u00e9rie de l'imprimante. Lors du premier flashage, assurez-vous qu'OctoPrint n'est pas connect\u00e9 directement \u00e0 l'imprimante (\u00e0 partir de la page web d'OctoPrint, sous la section \"Connexion\", cliquez sur \"D\u00e9connecter\"). Configuration d'OctoPrint pour utiliser Klipper \u00b6 Le serveur web OctoPrint doit \u00eatre configur\u00e9 pour communiquer avec le logiciel h\u00f4te Klipper. \u00c0 l'aide d'un navigateur Web, connectez-vous \u00e0 la page Web d'OctoPrint, puis configurez les \u00e9l\u00e9ments suivants : Naviguez vers l'onglet \"Settings\" (l'ic\u00f4ne de la cl\u00e9 \u00e0 molette en haut de la page). Sous \"Serial Connection\" dans \"Additional serial ports\" ajoutez \"/tmp/printer\". Cliquez ensuite sur \"Save\". Entrez \u00e0 nouveau dans l'onglet Param\u00e8tres et, sous \"Connexion s\u00e9rie\", changez le param\u00e8tre \"Port s\u00e9rie\" en \"/tmp/printer\". Dans l'onglet \"Param\u00e8tres\", acc\u00e9dez au sous-onglet \"Behavior\" et s\u00e9lectionnez l'option \"Cancel any ongoing prints but stay connected to the printer\". Cliquez sur \"Enregistrer\". Sur la page principale, dans la section \"Connection\" (en haut \u00e0 gauche de la page), assurez-vous que le \"Serial Port\" est r\u00e9gl\u00e9 sur \"/tmp/printer\" et cliquez sur \"Connect\". (si \"/tmp/printer\" n'est pas une s\u00e9lection disponible, essayez de recharger la page.) Une fois connect\u00e9, naviguez vers l'onglet \"Terminal\" et tapez \"status\" (sans les guillemets) dans la bo\u00eete de saisie de la commande et cliquez sur \"Send\". La fen\u00eatre du terminal indiquera probablement qu'il y a une erreur dans l'ouverture du fichier de configuration - cela signifie qu'OctoPrint communique avec succ\u00e8s avec Klipper. Passez \u00e0 la section suivante. Configuration de Klipper \u00b6 La prochaine \u00e9tape est de copier le printer configuration file dans le Raspberry Pi. La fa\u00e7on la plus simple de d\u00e9finir le fichier de configuration de Klipper est d'utiliser un \u00e9diteur de bureau qui prend en charge l'\u00e9dition de fichiers via les protocoles \"scp\" et/ou \"sftp\". Il existe des outils disponibles gratuitement qui prenant en charge cette fonction (par exemple, Notepad++, WinSCP et Cyberduck). Chargez le fichier de configuration de l'imprimante dans l'\u00e9diteur, puis sauvegardez-le dans un fichier nomm\u00e9 \"printer.cfg\" dans le r\u00e9pertoire personnel de l'utilisateur pi (par exemple, /home/pi/printer.cfg). On peut \u00e9galement copier et modifier le fichier directement sur le Raspberry Pi via ssh. Cela peut ressembler \u00e0 ce qui suit (veillez \u00e0 mettre \u00e0 jour la commande pour utiliser le nom de fichier de configuration de l'imprimante appropri\u00e9) : cp ~/klipper/config/example-cartesian.cfg ~/printer.cfg nano ~/printer.cfg C'est classique pour chaque imprimante d'avoir son propre nom pour le micro-contr\u00f4leur. Le nom peut changer apr\u00e8s le flashing de Klipper, relancez donc ces \u00e9tapes \u00e0 nouveau m\u00eame si elles ont d\u00e9j\u00e0 \u00e9t\u00e9 faites lors du flashing. Lancez : ls /dev/serial/by-id/* Il devrait retourner quelque chose de similaire \u00e0 ce qui suit : /dev/serial/by-id/usb-1a86_USB2.0-Serial-if00-port0 Puis mettez \u00e0 jour le fichier de configuration avec un nom unique. Par exemple, mettez \u00e0 jour la section [mcu] pour ressembler \u00e0 quelque chose comme : [mcu] serial: /dev/serial/by-id/usb-1a86_USB2.0-Serial-if00-port0 Apr\u00e8s avoir cr\u00e9\u00e9 et \u00e9dit\u00e9 le fichier, il sera n\u00e9cessaire de lancer une commande \"restart\" dans le terminal web OctoPrint pour charger la configuration. Une commande \"status\" indiquera que l'imprimante est pr\u00eate si le fichier de configuration Klipper est lu avec succ\u00e8s et si le micro-contr\u00f4leur est trouv\u00e9 et configur\u00e9 avec succ\u00e8s. Lors de la personnalisation du fichier de configuration de l'imprimante, il n'est pas rare que Klipper signale une erreur de configuration. Si une erreur se produit, apportez les corrections n\u00e9cessaires au fichier de configuration de l'imprimante et lancez \"restart\" jusqu'\u00e0 ce que \"status\" indique que l'imprimante est pr\u00eate. Klipper rapporte les messages d'erreur via l'onglet du terminal OctoPrint. La commande \"status\" peut \u00eatre utilis\u00e9e pour rapporter \u00e0 nouveau les messages d'erreur. Le script de d\u00e9marrage par d\u00e9faut de Klipper place \u00e9galement un journal dans /tmp/klippy.log qui fournit des informations plus d\u00e9taill\u00e9es. Une fois que Klipper a signal\u00e9 que l'imprimante est pr\u00eate, passez au document de v\u00e9rification de la configuration pour effectuer les v\u00e9rifications de base sur les d\u00e9finitions du fichier de configuration. Pour plus d'informations, consultez la r\u00e9f\u00e9rence de documentation principale pour plus d'informations.","title":"Installation"},{"location":"Installation.html#installation","text":"Ces instructions supposent que le logiciel fonctionnera sur un ordinateur Raspberry Pi en conjonction avec OctoPrint. Il est recommand\u00e9 d'utiliser un ordinateur Raspberry Pi 2, 3 ou 4 comme machine h\u00f4te (voir la FAQ pour les autres machines).","title":"Installation"},{"location":"Installation.html#obtenir-un-fichier-de-configuration-de-klipper","text":"La plupart des param\u00e8tres de Klipper sont d\u00e9termin\u00e9s par un \"fichier de configuration d'imprimante\" stock\u00e9 sur le Raspberry Pi. Un fichier de configuration appropri\u00e9 peut souvent \u00eatre trouv\u00e9 en recherchant dans le r\u00e9pertoire des configurations de Klipper, un fichier commen\u00e7ant par un pr\u00e9fixe \"printer-\" correspondant \u00e0 l'imprimante cible. Le fichier de configuration de Klipper contient des informations techniques sur l'imprimante n\u00e9cessaires pendant l'installation. S'il n'y a pas de fichier de configuration d'imprimante appropri\u00e9 dans le r\u00e9pertoire des configurations de Klipper, essayez de rechercher le site Web du fabricant de l'imprimante pour voir s'il y a un fichier de configuration Klipper appropri\u00e9. Si aucun fichier de configuration pour l'imprimante ne peut \u00eatre trouv\u00e9, mais que le type de carte de contr\u00f4le de l'imprimante est connu, recherchez un fichier de configuration appropri\u00e9 commen\u00e7ant par un pr\u00e9fixe \"generic-\". Ces exemples de fichiers de carte d'imprimante devraient permettre de r\u00e9aliser avec succ\u00e8s l'installation initiale, mais n\u00e9cessiteront une personnalisation afin d'obtenir la fonctionnalit\u00e9 compl\u00e8te de l'imprimante. Il est \u00e9galement possible de d\u00e9finir une nouvelle configuration d'imprimante en partant de z\u00e9ro. Toutefois, cela n\u00e9cessite des connaissances techniques importantes sur l'imprimante et son \u00e9lectronique. Il est recommand\u00e9 \u00e0 la plupart des utilisateurs de commencer par un fichier de configuration appropri\u00e9. Si vous cr\u00e9ez un nouveau fichier de configuration d'imprimante personnalis\u00e9, commencez par l'exemple d'un fichier de configuration proche et utilisez la r\u00e9f\u00e9rence de configuration de Klipper pour plus d'informations.","title":"Obtenir un fichier de configuration de Klipper"},{"location":"Installation.html#preparation-de-limage-du-systeme-dexploitation-os","text":"Commencez par installer OctoPi sur l'ordinateur Raspberry Pi. Utilisez OctoPi v0.17.0 ou plus r\u00e9cent - voir les OctoPi releases pour les informations de versions. Il faut v\u00e9rifier que OctoPi d\u00e9marre et que le serveur web OctoPrint fonctionne. Apr\u00e8s s'\u00eatre connect\u00e9 \u00e0 la page web d'OctoPrint, suivez les instructions pour mettre \u00e0 jour OctoPrint \u00e0 la version v1.4.2 ou ult\u00e9rieure. Apr\u00e8s avoir install\u00e9 OctoPi et mis \u00e0 jour OctoPrint, il sera n\u00e9cessaire de se connecter via ssh \u00e0 la machine cible pour ex\u00e9cuter quelques commandes syst\u00e8me. Si vous utilisez un bureau Linux ou MacOS, le logiciel \"ssh\" devrait d\u00e9j\u00e0 \u00eatre install\u00e9 sur le bureau. Il existe des clients ssh gratuits pour d'autres ordinateurs de bureau (par exemple, PuTTY ). Utilisez l'utilitaire ssh pour vous connecter au Raspberry Pi (ssh pi@octopi -- le mot de passe par d\u00e9faut est \"raspberry\") et ex\u00e9cutez les commandes suivantes : git clone https://github.com/Klipper3d/klipper ./klipper/scripts/install-octopi.sh L'op\u00e9ration ci-dessus permet de t\u00e9l\u00e9charger Klipper, d'installer certaines d\u00e9pendances du syst\u00e8me, de configurer Klipper pour qu'il soit ex\u00e9cut\u00e9 au d\u00e9marrage du syst\u00e8me et de lancer le logiciel h\u00f4te Klipper. Une connexion Internet est n\u00e9cessaire et l'op\u00e9ration peut prendre quelques minutes.","title":"Pr\u00e9paration de l'image du syst\u00e8me d'exploitation (OS)"},{"location":"Installation.html#compilation-et-flashage-du-micro-controleur","text":"Pour compiler le code du microcontr\u00f4leur, commencez par ex\u00e9cuter ces commandes sur le Raspberry Pi : cd ~/klipper/ make menuconfig Les commentaires en haut du fichier de configuration de l'imprimante devraient d\u00e9crire les param\u00e8tres qui doivent \u00eatre d\u00e9finis pendant le \"make menuconfig\". Ouvrez le fichier dans un navigateur Web ou un \u00e9diteur de texte et recherchez ces instructions en haut du fichier. Une fois que les param\u00e8tres appropri\u00e9s de \"menuconfig\" ont \u00e9t\u00e9 configur\u00e9s, appuyez sur \"Q\" pour quitter, puis sur \"Y\" pour enregistrer. Ensuite, ex\u00e9cutez : make Si les commentaires au haut de printer configuration file d\u00e9crive des \u00e9tapes pour le \"flashing\" de l'image finale sur la carte de contr\u00f4le de l'imprimante alors suivez ces \u00e9tapes puis proc\u00e9dez \u00e0 configuring OctoPrint . Sinon, les \u00e9tapes suivantes sont souvent utilis\u00e9es pour le \"flash\" de la carte de contr\u00f4le de l'imprimante. D'abord, il est n\u00e9cessaire de d\u00e9terminer le port s\u00e9rie connect\u00e9 au micro-contr\u00f4leur. Lancez ceci : ls /dev/serial/by-id/* Il devrait retourner quelque chose de similaire \u00e0 ce qui suit : /dev/serial/by-id/usb-1a86_USB2.0-Serial-if00-port0 Il est courant que chaque imprimante ait son propre nom de port s\u00e9rie unique. Ce nom unique sera utilis\u00e9 lors du flashage du micro-contr\u00f4leur. Il est possible qu'il y ait plusieurs lignes dans la sortie ci-dessus - si c'est le cas, choisissez la ligne correspondant au micro-contr\u00f4leur (voir la FAQ pour plus d'informations). Pour les micro-contr\u00f4leurs courants, le code peut \u00eatre flash\u00e9 avec quelque chose de similaire : sudo service klipper stop make flash FLASH_DEVICE=/dev/serial/by-id/usb-1a86_USB2.0-Serial-if00-port0 sudo service klipper start Veillez \u00e0 mettre \u00e0 jour le FLASH_DEVICE avec le nom unique du port s\u00e9rie de l'imprimante. Lors du premier flashage, assurez-vous qu'OctoPrint n'est pas connect\u00e9 directement \u00e0 l'imprimante (\u00e0 partir de la page web d'OctoPrint, sous la section \"Connexion\", cliquez sur \"D\u00e9connecter\").","title":"Compilation et flashage du micro-contr\u00f4leur"},{"location":"Installation.html#configuration-doctoprint-pour-utiliser-klipper","text":"Le serveur web OctoPrint doit \u00eatre configur\u00e9 pour communiquer avec le logiciel h\u00f4te Klipper. \u00c0 l'aide d'un navigateur Web, connectez-vous \u00e0 la page Web d'OctoPrint, puis configurez les \u00e9l\u00e9ments suivants : Naviguez vers l'onglet \"Settings\" (l'ic\u00f4ne de la cl\u00e9 \u00e0 molette en haut de la page). Sous \"Serial Connection\" dans \"Additional serial ports\" ajoutez \"/tmp/printer\". Cliquez ensuite sur \"Save\". Entrez \u00e0 nouveau dans l'onglet Param\u00e8tres et, sous \"Connexion s\u00e9rie\", changez le param\u00e8tre \"Port s\u00e9rie\" en \"/tmp/printer\". Dans l'onglet \"Param\u00e8tres\", acc\u00e9dez au sous-onglet \"Behavior\" et s\u00e9lectionnez l'option \"Cancel any ongoing prints but stay connected to the printer\". Cliquez sur \"Enregistrer\". Sur la page principale, dans la section \"Connection\" (en haut \u00e0 gauche de la page), assurez-vous que le \"Serial Port\" est r\u00e9gl\u00e9 sur \"/tmp/printer\" et cliquez sur \"Connect\". (si \"/tmp/printer\" n'est pas une s\u00e9lection disponible, essayez de recharger la page.) Une fois connect\u00e9, naviguez vers l'onglet \"Terminal\" et tapez \"status\" (sans les guillemets) dans la bo\u00eete de saisie de la commande et cliquez sur \"Send\". La fen\u00eatre du terminal indiquera probablement qu'il y a une erreur dans l'ouverture du fichier de configuration - cela signifie qu'OctoPrint communique avec succ\u00e8s avec Klipper. Passez \u00e0 la section suivante.","title":"Configuration d'OctoPrint pour utiliser Klipper"},{"location":"Installation.html#configuration-de-klipper","text":"La prochaine \u00e9tape est de copier le printer configuration file dans le Raspberry Pi. La fa\u00e7on la plus simple de d\u00e9finir le fichier de configuration de Klipper est d'utiliser un \u00e9diteur de bureau qui prend en charge l'\u00e9dition de fichiers via les protocoles \"scp\" et/ou \"sftp\". Il existe des outils disponibles gratuitement qui prenant en charge cette fonction (par exemple, Notepad++, WinSCP et Cyberduck). Chargez le fichier de configuration de l'imprimante dans l'\u00e9diteur, puis sauvegardez-le dans un fichier nomm\u00e9 \"printer.cfg\" dans le r\u00e9pertoire personnel de l'utilisateur pi (par exemple, /home/pi/printer.cfg). On peut \u00e9galement copier et modifier le fichier directement sur le Raspberry Pi via ssh. Cela peut ressembler \u00e0 ce qui suit (veillez \u00e0 mettre \u00e0 jour la commande pour utiliser le nom de fichier de configuration de l'imprimante appropri\u00e9) : cp ~/klipper/config/example-cartesian.cfg ~/printer.cfg nano ~/printer.cfg C'est classique pour chaque imprimante d'avoir son propre nom pour le micro-contr\u00f4leur. Le nom peut changer apr\u00e8s le flashing de Klipper, relancez donc ces \u00e9tapes \u00e0 nouveau m\u00eame si elles ont d\u00e9j\u00e0 \u00e9t\u00e9 faites lors du flashing. Lancez : ls /dev/serial/by-id/* Il devrait retourner quelque chose de similaire \u00e0 ce qui suit : /dev/serial/by-id/usb-1a86_USB2.0-Serial-if00-port0 Puis mettez \u00e0 jour le fichier de configuration avec un nom unique. Par exemple, mettez \u00e0 jour la section [mcu] pour ressembler \u00e0 quelque chose comme : [mcu] serial: /dev/serial/by-id/usb-1a86_USB2.0-Serial-if00-port0 Apr\u00e8s avoir cr\u00e9\u00e9 et \u00e9dit\u00e9 le fichier, il sera n\u00e9cessaire de lancer une commande \"restart\" dans le terminal web OctoPrint pour charger la configuration. Une commande \"status\" indiquera que l'imprimante est pr\u00eate si le fichier de configuration Klipper est lu avec succ\u00e8s et si le micro-contr\u00f4leur est trouv\u00e9 et configur\u00e9 avec succ\u00e8s. Lors de la personnalisation du fichier de configuration de l'imprimante, il n'est pas rare que Klipper signale une erreur de configuration. Si une erreur se produit, apportez les corrections n\u00e9cessaires au fichier de configuration de l'imprimante et lancez \"restart\" jusqu'\u00e0 ce que \"status\" indique que l'imprimante est pr\u00eate. Klipper rapporte les messages d'erreur via l'onglet du terminal OctoPrint. La commande \"status\" peut \u00eatre utilis\u00e9e pour rapporter \u00e0 nouveau les messages d'erreur. Le script de d\u00e9marrage par d\u00e9faut de Klipper place \u00e9galement un journal dans /tmp/klippy.log qui fournit des informations plus d\u00e9taill\u00e9es. Une fois que Klipper a signal\u00e9 que l'imprimante est pr\u00eate, passez au document de v\u00e9rification de la configuration pour effectuer les v\u00e9rifications de base sur les d\u00e9finitions du fichier de configuration. Pour plus d'informations, consultez la r\u00e9f\u00e9rence de documentation principale pour plus d'informations.","title":"Configuration de Klipper"},{"location":"Kinematics.html","text":"Cin\u00e9matiques \u00b6 Ce document donne un aper\u00e7u de la fa\u00e7on dont Klipper impl\u00e9mente le mouvement du robot (sa cin\u00e9matique ). Ce contenu peut int\u00e9resser aussi bien les d\u00e9veloppeurs travaillant sur le logiciel Klipper que les utilisateurs int\u00e9ress\u00e9s \u00e0 mieux comprendre la m\u00e9canique de leurs machines. Acc\u00e9l\u00e9ration \u00b6 Klipper met en \u0153uvre un sch\u00e9ma d'acc\u00e9l\u00e9ration constante chaque fois que la t\u00eate d'impression change de vitesse - la vitesse est progressivement modifi\u00e9e pour atteindre la nouvelle vitesse au lieu d'\u00eatre brusquement atteinte. Klipper applique toujours l'acc\u00e9l\u00e9ration entre la t\u00eate de l'outil et l'impression. Le filament sortant de l'extrudeuse peut \u00eatre assez fragile - des secousses rapides et/ou des changements de d\u00e9bit de l'extrudeuse entra\u00eenent une qualit\u00e9 m\u00e9diocre et une mauvaise adh\u00e9rence du lit. M\u00eame en l'absence d'extrusion, si la t\u00eate d'impression se trouve au m\u00eame niveau que l'impression, des secousses rapides de la t\u00eate peuvent perturber le filament r\u00e9cemment d\u00e9pos\u00e9. Limiter les changements de vitesse de la t\u00eate d'impression (par rapport \u00e0 l'impression) r\u00e9duit les risques de perturbation de l'impression. Il est \u00e9galement important de limiter l'acc\u00e9l\u00e9ration afin que les moteurs pas \u00e0 pas ne perdent pas de pas et ne soumettent pas la machine \u00e0 des contraintes excessives. Klipper limite le couple de chaque moteur pas \u00e0 pas en limitant l'acc\u00e9l\u00e9ration de la t\u00eate d'impression. Le fait d'imposer une acc\u00e9l\u00e9ration \u00e0 la t\u00eate d'impression limite naturellement aussi le couple des moteurs pas \u00e0 pas qui d\u00e9placent la t\u00eate d'impression (l'inverse n'est pas toujours vrai). Klipper met en \u0153uvre une acc\u00e9l\u00e9ration constante. La formule cl\u00e9 de l'acc\u00e9l\u00e9ration constante est la suivante : velocity(time) = start_velocity + accel*time G\u00e9n\u00e9rateur de trap\u00e9zo\u00efdes \u00b6 Klipper utilise un \"g\u00e9n\u00e9rateur de trap\u00e8ze\" traditionnel pour mod\u00e9liser le mouvement de chaque d\u00e9placement - chaque d\u00e9placement a une vitesse de d\u00e9part, il acc\u00e9l\u00e8re jusqu'\u00e0 une vitesse de croisi\u00e8re \u00e0 une acc\u00e9l\u00e9ration constante, il se d\u00e9place \u00e0 une vitesse constante, puis d\u00e9c\u00e9l\u00e8re jusqu'\u00e0 la vitesse finale en utilisant une d\u00e9c\u00e9l\u00e9ration constante. On l'appelle \"g\u00e9n\u00e9rateur de trap\u00e8ze\" parce que le diagramme de vitesse du mouvement ressemble \u00e0 un trap\u00e8ze. La vitesse de croisi\u00e8re est toujours sup\u00e9rieure ou \u00e9gale \u00e0 la fois \u00e0 la vitesse de d\u00e9part et \u00e0 la vitesse d'arriv\u00e9e. La phase d'acc\u00e9l\u00e9ration peut \u00eatre de dur\u00e9e nulle (si la vitesse de d\u00e9part est \u00e9gale \u00e0 la vitesse de croisi\u00e8re), la phase de croisi\u00e8re peut \u00eatre de dur\u00e9e nulle (si le mouvement commence imm\u00e9diatement \u00e0 d\u00e9c\u00e9l\u00e9rer apr\u00e8s l'acc\u00e9l\u00e9ration), et/ou la phase de d\u00e9c\u00e9l\u00e9ration peut \u00eatre de dur\u00e9e nulle (si la vitesse finale est \u00e9gale \u00e0 la vitesse de croisi\u00e8re). Projection \u00b6 Le syst\u00e8me de projection \"look-ahead\" est utilis\u00e9 pour d\u00e9terminer les vitesses lors des virages entre les mouvements. Consid\u00e9rons les deux mouvements suivants contenus dans un plan XY : Dans la situation ci-dessus, il est possible de d\u00e9c\u00e9l\u00e9rer compl\u00e8tement apr\u00e8s le premier mouvement et d'acc\u00e9l\u00e9rer compl\u00e8tement au d\u00e9but du mouvement suivant, mais ce n'est pas id\u00e9al car toutes ces acc\u00e9l\u00e9rations et d\u00e9c\u00e9l\u00e9rations augmenteraient consid\u00e9rablement le temps d'impression et les changements fr\u00e9quents dans le flux de l'extrudeuse entra\u00eeneraient une mauvaise qualit\u00e9 d'impression. Pour r\u00e9soudre ce probl\u00e8me, le m\u00e9canisme de projection \"look-ahead\" met en file d'attente plusieurs mouvements entrants et analyse les angles entre les mouvements pour d\u00e9terminer une vitesse raisonnable pouvant \u00eatre obtenue pendant la \"jonction\" entre deux mouvements. Si le d\u00e9placement suivant est presque dans la m\u00eame direction, la t\u00eate ne doit ralentir que l\u00e9g\u00e8rement (voire pas du tout). Toutefois, si le mouvement suivant forme un angle aigu (la t\u00eate va se d\u00e9placer dans une direction presque inverse lors du mouvement suivant), seule une petite vitesse de jonction est autoris\u00e9e. Les vitesses de jonction sont d\u00e9termin\u00e9es en utilisant \"l'acc\u00e9l\u00e9ration centrip\u00e8te approximative\". Best d\u00e9crit par l'auteur . Cependant, dans Klipper, les vitesses de jonction sont configur\u00e9es en sp\u00e9cifiant la vitesse souhait\u00e9e pour un angle de 90\u00b0 (la \"vitesse de l'angle carr\u00e9\"), et les vitesses de jonction des autres angles en sont d\u00e9riv\u00e9es. Formule cl\u00e9 pour la projection : end_velocity^2 = start_velocity^2 + 2*accel*move_distance Lissage de la projection \u00b6 Klipper met \u00e9galement en \u0153uvre un m\u00e9canisme permettant de lisser les mouvements de courts d\u00e9placements en \"zigzag\". Consid\u00e9rons les mouvements suivants : Dans l'exemple ci-dessus, les passages fr\u00e9quents de l'acc\u00e9l\u00e9ration \u00e0 la d\u00e9c\u00e9l\u00e9ration peuvent faire vibrer la machine provoquant des contraintes sur la machine et augmentant le bruit. Pour r\u00e9duire ce ph\u00e9nom\u00e8ne, Klipper suit \u00e0 la fois l'acc\u00e9l\u00e9ration des mouvements r\u00e9guliers et un taux virtuel \"d'acc\u00e9l\u00e9ration \u00e0 d\u00e9c\u00e9l\u00e9ration\". Gr\u00e2ce \u00e0 ce syst\u00e8me, la vitesse maximale de ces courts mouvements en \"zigzag\" est limit\u00e9e pour lisser le mouvement de l'imprimante : Plus pr\u00e9cis\u00e9ment, le code calcule ce que serait la vitesse de chaque mouvement s'il \u00e9tait limit\u00e9 \u00e0 ce taux virtuel \"d'acc\u00e9l\u00e9ration \u00e0 d\u00e9c\u00e9l\u00e9ration\" (la moiti\u00e9 du taux d'acc\u00e9l\u00e9ration normal par d\u00e9faut). Dans l'image ci-dessus, les lignes grises en pointill\u00e9s repr\u00e9sentent ce taux d'acc\u00e9l\u00e9ration virtuel pour le premier d\u00e9placement. Si un d\u00e9placement ne peut atteindre sa vitesse de croisi\u00e8re maximale en utilisant ce taux d'acc\u00e9l\u00e9ration virtuel, sa vitesse maximale est r\u00e9duite \u00e0 la vitesse maximale obtenu avec ce taux d'acc\u00e9l\u00e9ration virtuel. Pour la plupart des mouvements, la limite sera \u00e9gale ou sup\u00e9rieure aux limites existantes du mouvement et aucun changement de comportement n'est induit. En revanche, pour les d\u00e9placements courts en zigzag, cette limite r\u00e9duit la vitesse maximale. Notez que cela ne modifie pas l'acc\u00e9l\u00e9ration r\u00e9elle du mouvement - le mouvement continue d'utiliser le sch\u00e9ma d'acc\u00e9l\u00e9ration normal jusqu'\u00e0 sa vitesse maximale ajust\u00e9e. \u00c9tapes de la g\u00e9n\u00e9ration \u00b6 Une fois le processus d'anticipation termin\u00e9, le mouvement de la t\u00eate d'impression du mouvement donn\u00e9 est enti\u00e8rement connu (temps, position de d\u00e9part, position finale, vitesse \u00e0 chaque point) et il est possible de g\u00e9n\u00e9rer les dur\u00e9es de pas du mouvement. Ce processus est effectu\u00e9 dans les \"classes cin\u00e9matiques\" du code Klipper. En dehors de ces classes cin\u00e9matiques, tout est suivi en millim\u00e8tres, en secondes et dans un espace de coordonn\u00e9es cart\u00e9siennes. C'est la t\u00e2che des classes cin\u00e9matiques de convertir ce syst\u00e8me de coordonn\u00e9es g\u00e9n\u00e9rique aux sp\u00e9cificit\u00e9s mat\u00e9rielles de l'imprimante particuli\u00e8re. Klipper utilise un solveur it\u00e9ratif pour g\u00e9n\u00e9rer les dur\u00e9s de pas pour chaque moteur. Le code contient les formules permettant de calculer les coordonn\u00e9es cart\u00e9siennes id\u00e9ales de la t\u00eate \u00e0 chaque instant, ainsi que les formules cin\u00e9matiques permettant de calculer les positions id\u00e9ales des moteurs \u00e0 partir de ces coordonn\u00e9es cart\u00e9siennes. Gr\u00e2ce \u00e0 ces formules, Klipper peut d\u00e9terminer le moment id\u00e9al o\u00f9 le moteur doit se trouver \u00e0 chaque position de pas. Les \u00e9tapes donn\u00e9es sont alors programm\u00e9es \u00e0 ces moments calcul\u00e9s. La formule cl\u00e9 d\u00e9terminant la distance qu'un mouvement doit parcourir sous une acc\u00e9l\u00e9ration constante est la suivante : move_distance = (start_velocity + .5 * accel * move_time) * move_time et la formule cl\u00e9 d'un mouvement \u00e0 vitesse constante est : move_distance = cruise_velocity * move_time Les formules cl\u00e9s permettant de d\u00e9terminer la coordonn\u00e9e cart\u00e9sienne d'un d\u00e9placement en fonction de la distance du d\u00e9placement sont les suivantes : cartesian_x_position = start_x + move_distance * total_x_movement / total_movement cartesian_y_position = start_y + move_distance * total_y_movement / total_movement cartesian_z_position = start_z + move_distance * total_z_movement / total_movement Robots cart\u00e9siens \u00b6 La g\u00e9n\u00e9ration de pas des imprimantes cart\u00e9siennes est le cas le plus simple. Le mouvement sur chaque axe est directement li\u00e9 au mouvement dans l'espace cart\u00e9sien. Formules cl\u00e9s : stepper_x_position = cartesian_x_position stepper_y_position = cartesian_y_position stepper_z_position = cartesian_z_position Robots CoreXY \u00b6 La g\u00e9n\u00e9ration de pas d'une machine CoreXY n'est qu'un peu plus complexe que les robots cart\u00e9siens de base. Les formules cl\u00e9s sont les suivantes : stepper_a_position = cartesian_x_position + cartesian_y_position stepper_b_position = cartesian_x_position - cartesian_y_position stepper_z_position = cartesian_z_position Robots Delta \u00b6 La g\u00e9n\u00e9ration de pas d'un robot delta est bas\u00e9e sur le th\u00e9or\u00e8me de Pythagore : stepper_position = (sqrt(arm_length^2 - (cartesian_x_position - tower_x_position)^2 - (cartesian_y_position - tower_y_position)^2) + cartesian_z_position) Limites d'acc\u00e9l\u00e9ration du moteur pas \u00e0 pas \u00b6 Avec la cin\u00e9matique delta, il est possible qu'un mouvement acc\u00e9l\u00e8rant dans l'espace cart\u00e9sien n\u00e9cessite une acc\u00e9l\u00e9ration sur un moteur pas \u00e0 pas particulier sup\u00e9rieure \u00e0 l'acc\u00e9l\u00e9ration du mouvement. Cela peut se produire lorsque le bras d'un moteur pas \u00e0 pas est plus horizontal que vertical et que la ligne de mouvement passe pr\u00e8s de la tour de ce moteur pas \u00e0 pas. Bien que ces mouvements puissent n\u00e9cessiter une acc\u00e9l\u00e9ration du moteur pas \u00e0 pas sup\u00e9rieure \u00e0 l'acc\u00e9l\u00e9ration maximale du mouvement configur\u00e9 de l'imprimante, la masse effective d\u00e9plac\u00e9e par ce moteur pas \u00e0 pas serait plus faible. Ainsi, l'acc\u00e9l\u00e9ration plus \u00e9lev\u00e9e du moteur pas \u00e0 pas n'entra\u00eene pas un couple beaucoup plus \u00e9lev\u00e9 et est donc consid\u00e9r\u00e9e comme inoffensive. Cependant, afin d'\u00e9viter les cas extr\u00eames, Klipper applique un plafond maximal \u00e0 l'acc\u00e9l\u00e9ration du moteur de trois fois l'acc\u00e9l\u00e9ration de d\u00e9placement maximale configur\u00e9e de l'imprimante. (De m\u00eame, la vitesse maximale du moteur est limit\u00e9e \u00e0 trois fois la vitesse de d\u00e9placement maximale). Afin de faire respecter cette limite, les mouvements situ\u00e9s \u00e0 l'extr\u00e9mit\u00e9 de l'enveloppe de construction (o\u00f9 le bras du stepper peut \u00eatre presque horizontal) auront une acc\u00e9l\u00e9ration et une vitesse maximales inf\u00e9rieures. Cin\u00e9matique de l'extrudeuse \u00b6 Klipper impl\u00e9mente le mouvement de l'extrudeuse dans sa propre classe cin\u00e9matique. Comme la dur\u00e9e et la vitesse de chaque mouvement de la t\u00eate d'impression sont enti\u00e8rement connus pour chaque mouvement, il est possible de calculer les dur\u00e9es de pas de l'extrudeuse ind\u00e9pendamment des calculs de dur\u00e9es de pas du mouvement de la t\u00eate d'impression. Le mouvement de base de l'extrudeuse est simple \u00e0 calculer. La g\u00e9n\u00e9ration de dur\u00e9e de pas utilise les m\u00eames formules que celles utilis\u00e9es par les robots cart\u00e9siens : stepper_position = requested_e_position Avance \u00e0 la pression \u00b6 L'exp\u00e9rimentation a montr\u00e9 qu'il est possible d'am\u00e9liorer la mod\u00e9lisation de l'extrudeuse au-del\u00e0 de la formule de base de l'extrudeuse. Dans le cas id\u00e9al, au fur et \u00e0 mesure qu'un mouvement d'extrusion progresse, le m\u00eame volume de filament devrait \u00eatre d\u00e9pos\u00e9 \u00e0 chaque point du mouvement et il ne devrait pas y avoir de volume extrud\u00e9 apr\u00e8s le mouvement. Malheureusement, il est courant de constater que les formules d'extrusion de base font que trop peu de filament sort de l'extrudeuse au d\u00e9but des mouvements d'extrusion et qu'un exc\u00e8s de filament est extrud\u00e9 apr\u00e8s la fin de l'extrusion. Ce ph\u00e9nom\u00e8ne est souvent appel\u00e9 \"suintement\". Le syst\u00e8me d'\"avance \u00e0 la pression\" tente de tenir compte de ce ph\u00e9nom\u00e8ne en utilisant un mod\u00e8le diff\u00e9rent pour l'extrudeuse. Au lieu de croire na\u00efvement que chaque mm^3 de filament introduit dans l'extrudeuse entra\u00eenera la sortie imm\u00e9diate de cette quantit\u00e9 de mm^3, est utilis\u00e9 un mod\u00e8le bas\u00e9 sur la pression. La pression augmente lorsque le filament est pouss\u00e9 dans l'extrudeuse (comme dans la loi de Hooke ) et la pression n\u00e9cessaire pour extruder est domin\u00e9e par le d\u00e9bit \u00e0 travers l'orifice de la buse (comme dans la loi de Poiseuille ). L'id\u00e9e principale est que la relation entre le filament, la pression et le d\u00e9bit peut \u00eatre mod\u00e9lis\u00e9e par un coefficient lin\u00e9aire : pa_position = nominal_position + pressure_advance_coefficient * nominal_velocity Voir le document avance \u00e0 la pression pour savoir comment d\u00e9terminer ce coefficient d'avance \u00e0 la pression. La formule de base de l'avance \u00e0 la pression peut entra\u00eener des changements brusques de la vitesse du moteur de l'extrudeuse. Klipper met en \u0153uvre un \"lissage\" du mouvement de l'extrudeuse pour \u00e9viter cela. Le graphique ci-dessus montre un exemple de deux mouvements d'extrusion avec une vitesse de virage non nulle entre eux. Notez que le syst\u00e8me d'avance \u00e0 la pression fait que du filament suppl\u00e9mentaire est pouss\u00e9 dans l'extrudeuse pendant l'acc\u00e9l\u00e9ration. Plus le d\u00e9bit de filament souhait\u00e9 est \u00e9lev\u00e9, plus il faut pousser de filament dans l'extrudeuse pendant l'acc\u00e9l\u00e9ration pour tenir compte de la pression. Pendant la d\u00e9c\u00e9l\u00e9ration de la t\u00eate, le filament suppl\u00e9mentaire est r\u00e9tract\u00e9 (l'extrudeuse aura une vitesse n\u00e9gative). Le \"lissage\" est impl\u00e9ment\u00e9 en utilisant une moyenne pond\u00e9r\u00e9e de la position de l'extrudeuse sur une tr\u00e8s courte p\u00e9riode de temps (comme sp\u00e9cifi\u00e9 par le param\u00e8tre de configuration pressure_advance_smooth_time ). Cette moyenne peut s'\u00e9tendre sur plusieurs mouvements du g-code. Notez comment le moteur de l'extrudeuse commencera \u00e0 bouger avant le d\u00e9but nominal du premier mouvement d'extrusion et continuera \u00e0 bouger apr\u00e8s la fin nominale du dernier mouvement d'extrusion. Formule cl\u00e9 pour \"l'avance \u00e0 la pression liss\u00e9e\" : smooth_pa_position(t) = ( definitive_integral(pa_position(x) * (smooth_time/2 - abs(t - x)) * dx, from=t-smooth_time/2, to=t+smooth_time/2) / (smooth_time/2)^2 )","title":"Cin\u00e9matiques"},{"location":"Kinematics.html#cinematiques","text":"Ce document donne un aper\u00e7u de la fa\u00e7on dont Klipper impl\u00e9mente le mouvement du robot (sa cin\u00e9matique ). Ce contenu peut int\u00e9resser aussi bien les d\u00e9veloppeurs travaillant sur le logiciel Klipper que les utilisateurs int\u00e9ress\u00e9s \u00e0 mieux comprendre la m\u00e9canique de leurs machines.","title":"Cin\u00e9matiques"},{"location":"Kinematics.html#acceleration","text":"Klipper met en \u0153uvre un sch\u00e9ma d'acc\u00e9l\u00e9ration constante chaque fois que la t\u00eate d'impression change de vitesse - la vitesse est progressivement modifi\u00e9e pour atteindre la nouvelle vitesse au lieu d'\u00eatre brusquement atteinte. Klipper applique toujours l'acc\u00e9l\u00e9ration entre la t\u00eate de l'outil et l'impression. Le filament sortant de l'extrudeuse peut \u00eatre assez fragile - des secousses rapides et/ou des changements de d\u00e9bit de l'extrudeuse entra\u00eenent une qualit\u00e9 m\u00e9diocre et une mauvaise adh\u00e9rence du lit. M\u00eame en l'absence d'extrusion, si la t\u00eate d'impression se trouve au m\u00eame niveau que l'impression, des secousses rapides de la t\u00eate peuvent perturber le filament r\u00e9cemment d\u00e9pos\u00e9. Limiter les changements de vitesse de la t\u00eate d'impression (par rapport \u00e0 l'impression) r\u00e9duit les risques de perturbation de l'impression. Il est \u00e9galement important de limiter l'acc\u00e9l\u00e9ration afin que les moteurs pas \u00e0 pas ne perdent pas de pas et ne soumettent pas la machine \u00e0 des contraintes excessives. Klipper limite le couple de chaque moteur pas \u00e0 pas en limitant l'acc\u00e9l\u00e9ration de la t\u00eate d'impression. Le fait d'imposer une acc\u00e9l\u00e9ration \u00e0 la t\u00eate d'impression limite naturellement aussi le couple des moteurs pas \u00e0 pas qui d\u00e9placent la t\u00eate d'impression (l'inverse n'est pas toujours vrai). Klipper met en \u0153uvre une acc\u00e9l\u00e9ration constante. La formule cl\u00e9 de l'acc\u00e9l\u00e9ration constante est la suivante : velocity(time) = start_velocity + accel*time","title":"Acc\u00e9l\u00e9ration"},{"location":"Kinematics.html#generateur-de-trapezoides","text":"Klipper utilise un \"g\u00e9n\u00e9rateur de trap\u00e8ze\" traditionnel pour mod\u00e9liser le mouvement de chaque d\u00e9placement - chaque d\u00e9placement a une vitesse de d\u00e9part, il acc\u00e9l\u00e8re jusqu'\u00e0 une vitesse de croisi\u00e8re \u00e0 une acc\u00e9l\u00e9ration constante, il se d\u00e9place \u00e0 une vitesse constante, puis d\u00e9c\u00e9l\u00e8re jusqu'\u00e0 la vitesse finale en utilisant une d\u00e9c\u00e9l\u00e9ration constante. On l'appelle \"g\u00e9n\u00e9rateur de trap\u00e8ze\" parce que le diagramme de vitesse du mouvement ressemble \u00e0 un trap\u00e8ze. La vitesse de croisi\u00e8re est toujours sup\u00e9rieure ou \u00e9gale \u00e0 la fois \u00e0 la vitesse de d\u00e9part et \u00e0 la vitesse d'arriv\u00e9e. La phase d'acc\u00e9l\u00e9ration peut \u00eatre de dur\u00e9e nulle (si la vitesse de d\u00e9part est \u00e9gale \u00e0 la vitesse de croisi\u00e8re), la phase de croisi\u00e8re peut \u00eatre de dur\u00e9e nulle (si le mouvement commence imm\u00e9diatement \u00e0 d\u00e9c\u00e9l\u00e9rer apr\u00e8s l'acc\u00e9l\u00e9ration), et/ou la phase de d\u00e9c\u00e9l\u00e9ration peut \u00eatre de dur\u00e9e nulle (si la vitesse finale est \u00e9gale \u00e0 la vitesse de croisi\u00e8re).","title":"G\u00e9n\u00e9rateur de trap\u00e9zo\u00efdes"},{"location":"Kinematics.html#projection","text":"Le syst\u00e8me de projection \"look-ahead\" est utilis\u00e9 pour d\u00e9terminer les vitesses lors des virages entre les mouvements. Consid\u00e9rons les deux mouvements suivants contenus dans un plan XY : Dans la situation ci-dessus, il est possible de d\u00e9c\u00e9l\u00e9rer compl\u00e8tement apr\u00e8s le premier mouvement et d'acc\u00e9l\u00e9rer compl\u00e8tement au d\u00e9but du mouvement suivant, mais ce n'est pas id\u00e9al car toutes ces acc\u00e9l\u00e9rations et d\u00e9c\u00e9l\u00e9rations augmenteraient consid\u00e9rablement le temps d'impression et les changements fr\u00e9quents dans le flux de l'extrudeuse entra\u00eeneraient une mauvaise qualit\u00e9 d'impression. Pour r\u00e9soudre ce probl\u00e8me, le m\u00e9canisme de projection \"look-ahead\" met en file d'attente plusieurs mouvements entrants et analyse les angles entre les mouvements pour d\u00e9terminer une vitesse raisonnable pouvant \u00eatre obtenue pendant la \"jonction\" entre deux mouvements. Si le d\u00e9placement suivant est presque dans la m\u00eame direction, la t\u00eate ne doit ralentir que l\u00e9g\u00e8rement (voire pas du tout). Toutefois, si le mouvement suivant forme un angle aigu (la t\u00eate va se d\u00e9placer dans une direction presque inverse lors du mouvement suivant), seule une petite vitesse de jonction est autoris\u00e9e. Les vitesses de jonction sont d\u00e9termin\u00e9es en utilisant \"l'acc\u00e9l\u00e9ration centrip\u00e8te approximative\". Best d\u00e9crit par l'auteur . Cependant, dans Klipper, les vitesses de jonction sont configur\u00e9es en sp\u00e9cifiant la vitesse souhait\u00e9e pour un angle de 90\u00b0 (la \"vitesse de l'angle carr\u00e9\"), et les vitesses de jonction des autres angles en sont d\u00e9riv\u00e9es. Formule cl\u00e9 pour la projection : end_velocity^2 = start_velocity^2 + 2*accel*move_distance","title":"Projection"},{"location":"Kinematics.html#lissage-de-la-projection","text":"Klipper met \u00e9galement en \u0153uvre un m\u00e9canisme permettant de lisser les mouvements de courts d\u00e9placements en \"zigzag\". Consid\u00e9rons les mouvements suivants : Dans l'exemple ci-dessus, les passages fr\u00e9quents de l'acc\u00e9l\u00e9ration \u00e0 la d\u00e9c\u00e9l\u00e9ration peuvent faire vibrer la machine provoquant des contraintes sur la machine et augmentant le bruit. Pour r\u00e9duire ce ph\u00e9nom\u00e8ne, Klipper suit \u00e0 la fois l'acc\u00e9l\u00e9ration des mouvements r\u00e9guliers et un taux virtuel \"d'acc\u00e9l\u00e9ration \u00e0 d\u00e9c\u00e9l\u00e9ration\". Gr\u00e2ce \u00e0 ce syst\u00e8me, la vitesse maximale de ces courts mouvements en \"zigzag\" est limit\u00e9e pour lisser le mouvement de l'imprimante : Plus pr\u00e9cis\u00e9ment, le code calcule ce que serait la vitesse de chaque mouvement s'il \u00e9tait limit\u00e9 \u00e0 ce taux virtuel \"d'acc\u00e9l\u00e9ration \u00e0 d\u00e9c\u00e9l\u00e9ration\" (la moiti\u00e9 du taux d'acc\u00e9l\u00e9ration normal par d\u00e9faut). Dans l'image ci-dessus, les lignes grises en pointill\u00e9s repr\u00e9sentent ce taux d'acc\u00e9l\u00e9ration virtuel pour le premier d\u00e9placement. Si un d\u00e9placement ne peut atteindre sa vitesse de croisi\u00e8re maximale en utilisant ce taux d'acc\u00e9l\u00e9ration virtuel, sa vitesse maximale est r\u00e9duite \u00e0 la vitesse maximale obtenu avec ce taux d'acc\u00e9l\u00e9ration virtuel. Pour la plupart des mouvements, la limite sera \u00e9gale ou sup\u00e9rieure aux limites existantes du mouvement et aucun changement de comportement n'est induit. En revanche, pour les d\u00e9placements courts en zigzag, cette limite r\u00e9duit la vitesse maximale. Notez que cela ne modifie pas l'acc\u00e9l\u00e9ration r\u00e9elle du mouvement - le mouvement continue d'utiliser le sch\u00e9ma d'acc\u00e9l\u00e9ration normal jusqu'\u00e0 sa vitesse maximale ajust\u00e9e.","title":"Lissage de la projection"},{"location":"Kinematics.html#etapes-de-la-generation","text":"Une fois le processus d'anticipation termin\u00e9, le mouvement de la t\u00eate d'impression du mouvement donn\u00e9 est enti\u00e8rement connu (temps, position de d\u00e9part, position finale, vitesse \u00e0 chaque point) et il est possible de g\u00e9n\u00e9rer les dur\u00e9es de pas du mouvement. Ce processus est effectu\u00e9 dans les \"classes cin\u00e9matiques\" du code Klipper. En dehors de ces classes cin\u00e9matiques, tout est suivi en millim\u00e8tres, en secondes et dans un espace de coordonn\u00e9es cart\u00e9siennes. C'est la t\u00e2che des classes cin\u00e9matiques de convertir ce syst\u00e8me de coordonn\u00e9es g\u00e9n\u00e9rique aux sp\u00e9cificit\u00e9s mat\u00e9rielles de l'imprimante particuli\u00e8re. Klipper utilise un solveur it\u00e9ratif pour g\u00e9n\u00e9rer les dur\u00e9s de pas pour chaque moteur. Le code contient les formules permettant de calculer les coordonn\u00e9es cart\u00e9siennes id\u00e9ales de la t\u00eate \u00e0 chaque instant, ainsi que les formules cin\u00e9matiques permettant de calculer les positions id\u00e9ales des moteurs \u00e0 partir de ces coordonn\u00e9es cart\u00e9siennes. Gr\u00e2ce \u00e0 ces formules, Klipper peut d\u00e9terminer le moment id\u00e9al o\u00f9 le moteur doit se trouver \u00e0 chaque position de pas. Les \u00e9tapes donn\u00e9es sont alors programm\u00e9es \u00e0 ces moments calcul\u00e9s. La formule cl\u00e9 d\u00e9terminant la distance qu'un mouvement doit parcourir sous une acc\u00e9l\u00e9ration constante est la suivante : move_distance = (start_velocity + .5 * accel * move_time) * move_time et la formule cl\u00e9 d'un mouvement \u00e0 vitesse constante est : move_distance = cruise_velocity * move_time Les formules cl\u00e9s permettant de d\u00e9terminer la coordonn\u00e9e cart\u00e9sienne d'un d\u00e9placement en fonction de la distance du d\u00e9placement sont les suivantes : cartesian_x_position = start_x + move_distance * total_x_movement / total_movement cartesian_y_position = start_y + move_distance * total_y_movement / total_movement cartesian_z_position = start_z + move_distance * total_z_movement / total_movement","title":"\u00c9tapes de la g\u00e9n\u00e9ration"},{"location":"Kinematics.html#robots-cartesiens","text":"La g\u00e9n\u00e9ration de pas des imprimantes cart\u00e9siennes est le cas le plus simple. Le mouvement sur chaque axe est directement li\u00e9 au mouvement dans l'espace cart\u00e9sien. Formules cl\u00e9s : stepper_x_position = cartesian_x_position stepper_y_position = cartesian_y_position stepper_z_position = cartesian_z_position","title":"Robots cart\u00e9siens"},{"location":"Kinematics.html#robots-corexy","text":"La g\u00e9n\u00e9ration de pas d'une machine CoreXY n'est qu'un peu plus complexe que les robots cart\u00e9siens de base. Les formules cl\u00e9s sont les suivantes : stepper_a_position = cartesian_x_position + cartesian_y_position stepper_b_position = cartesian_x_position - cartesian_y_position stepper_z_position = cartesian_z_position","title":"Robots CoreXY"},{"location":"Kinematics.html#robots-delta","text":"La g\u00e9n\u00e9ration de pas d'un robot delta est bas\u00e9e sur le th\u00e9or\u00e8me de Pythagore : stepper_position = (sqrt(arm_length^2 - (cartesian_x_position - tower_x_position)^2 - (cartesian_y_position - tower_y_position)^2) + cartesian_z_position)","title":"Robots Delta"},{"location":"Kinematics.html#limites-dacceleration-du-moteur-pas-a-pas","text":"Avec la cin\u00e9matique delta, il est possible qu'un mouvement acc\u00e9l\u00e8rant dans l'espace cart\u00e9sien n\u00e9cessite une acc\u00e9l\u00e9ration sur un moteur pas \u00e0 pas particulier sup\u00e9rieure \u00e0 l'acc\u00e9l\u00e9ration du mouvement. Cela peut se produire lorsque le bras d'un moteur pas \u00e0 pas est plus horizontal que vertical et que la ligne de mouvement passe pr\u00e8s de la tour de ce moteur pas \u00e0 pas. Bien que ces mouvements puissent n\u00e9cessiter une acc\u00e9l\u00e9ration du moteur pas \u00e0 pas sup\u00e9rieure \u00e0 l'acc\u00e9l\u00e9ration maximale du mouvement configur\u00e9 de l'imprimante, la masse effective d\u00e9plac\u00e9e par ce moteur pas \u00e0 pas serait plus faible. Ainsi, l'acc\u00e9l\u00e9ration plus \u00e9lev\u00e9e du moteur pas \u00e0 pas n'entra\u00eene pas un couple beaucoup plus \u00e9lev\u00e9 et est donc consid\u00e9r\u00e9e comme inoffensive. Cependant, afin d'\u00e9viter les cas extr\u00eames, Klipper applique un plafond maximal \u00e0 l'acc\u00e9l\u00e9ration du moteur de trois fois l'acc\u00e9l\u00e9ration de d\u00e9placement maximale configur\u00e9e de l'imprimante. (De m\u00eame, la vitesse maximale du moteur est limit\u00e9e \u00e0 trois fois la vitesse de d\u00e9placement maximale). Afin de faire respecter cette limite, les mouvements situ\u00e9s \u00e0 l'extr\u00e9mit\u00e9 de l'enveloppe de construction (o\u00f9 le bras du stepper peut \u00eatre presque horizontal) auront une acc\u00e9l\u00e9ration et une vitesse maximales inf\u00e9rieures.","title":"Limites d'acc\u00e9l\u00e9ration du moteur pas \u00e0 pas"},{"location":"Kinematics.html#cinematique-de-lextrudeuse","text":"Klipper impl\u00e9mente le mouvement de l'extrudeuse dans sa propre classe cin\u00e9matique. Comme la dur\u00e9e et la vitesse de chaque mouvement de la t\u00eate d'impression sont enti\u00e8rement connus pour chaque mouvement, il est possible de calculer les dur\u00e9es de pas de l'extrudeuse ind\u00e9pendamment des calculs de dur\u00e9es de pas du mouvement de la t\u00eate d'impression. Le mouvement de base de l'extrudeuse est simple \u00e0 calculer. La g\u00e9n\u00e9ration de dur\u00e9e de pas utilise les m\u00eames formules que celles utilis\u00e9es par les robots cart\u00e9siens : stepper_position = requested_e_position","title":"Cin\u00e9matique de l'extrudeuse"},{"location":"Kinematics.html#avance-a-la-pression","text":"L'exp\u00e9rimentation a montr\u00e9 qu'il est possible d'am\u00e9liorer la mod\u00e9lisation de l'extrudeuse au-del\u00e0 de la formule de base de l'extrudeuse. Dans le cas id\u00e9al, au fur et \u00e0 mesure qu'un mouvement d'extrusion progresse, le m\u00eame volume de filament devrait \u00eatre d\u00e9pos\u00e9 \u00e0 chaque point du mouvement et il ne devrait pas y avoir de volume extrud\u00e9 apr\u00e8s le mouvement. Malheureusement, il est courant de constater que les formules d'extrusion de base font que trop peu de filament sort de l'extrudeuse au d\u00e9but des mouvements d'extrusion et qu'un exc\u00e8s de filament est extrud\u00e9 apr\u00e8s la fin de l'extrusion. Ce ph\u00e9nom\u00e8ne est souvent appel\u00e9 \"suintement\". Le syst\u00e8me d'\"avance \u00e0 la pression\" tente de tenir compte de ce ph\u00e9nom\u00e8ne en utilisant un mod\u00e8le diff\u00e9rent pour l'extrudeuse. Au lieu de croire na\u00efvement que chaque mm^3 de filament introduit dans l'extrudeuse entra\u00eenera la sortie imm\u00e9diate de cette quantit\u00e9 de mm^3, est utilis\u00e9 un mod\u00e8le bas\u00e9 sur la pression. La pression augmente lorsque le filament est pouss\u00e9 dans l'extrudeuse (comme dans la loi de Hooke ) et la pression n\u00e9cessaire pour extruder est domin\u00e9e par le d\u00e9bit \u00e0 travers l'orifice de la buse (comme dans la loi de Poiseuille ). L'id\u00e9e principale est que la relation entre le filament, la pression et le d\u00e9bit peut \u00eatre mod\u00e9lis\u00e9e par un coefficient lin\u00e9aire : pa_position = nominal_position + pressure_advance_coefficient * nominal_velocity Voir le document avance \u00e0 la pression pour savoir comment d\u00e9terminer ce coefficient d'avance \u00e0 la pression. La formule de base de l'avance \u00e0 la pression peut entra\u00eener des changements brusques de la vitesse du moteur de l'extrudeuse. Klipper met en \u0153uvre un \"lissage\" du mouvement de l'extrudeuse pour \u00e9viter cela. Le graphique ci-dessus montre un exemple de deux mouvements d'extrusion avec une vitesse de virage non nulle entre eux. Notez que le syst\u00e8me d'avance \u00e0 la pression fait que du filament suppl\u00e9mentaire est pouss\u00e9 dans l'extrudeuse pendant l'acc\u00e9l\u00e9ration. Plus le d\u00e9bit de filament souhait\u00e9 est \u00e9lev\u00e9, plus il faut pousser de filament dans l'extrudeuse pendant l'acc\u00e9l\u00e9ration pour tenir compte de la pression. Pendant la d\u00e9c\u00e9l\u00e9ration de la t\u00eate, le filament suppl\u00e9mentaire est r\u00e9tract\u00e9 (l'extrudeuse aura une vitesse n\u00e9gative). Le \"lissage\" est impl\u00e9ment\u00e9 en utilisant une moyenne pond\u00e9r\u00e9e de la position de l'extrudeuse sur une tr\u00e8s courte p\u00e9riode de temps (comme sp\u00e9cifi\u00e9 par le param\u00e8tre de configuration pressure_advance_smooth_time ). Cette moyenne peut s'\u00e9tendre sur plusieurs mouvements du g-code. Notez comment le moteur de l'extrudeuse commencera \u00e0 bouger avant le d\u00e9but nominal du premier mouvement d'extrusion et continuera \u00e0 bouger apr\u00e8s la fin nominale du dernier mouvement d'extrusion. Formule cl\u00e9 pour \"l'avance \u00e0 la pression liss\u00e9e\" : smooth_pa_position(t) = ( definitive_integral(pa_position(x) * (smooth_time/2 - abs(t - x)) * dx, from=t-smooth_time/2, to=t+smooth_time/2) / (smooth_time/2)^2 )","title":"Avance \u00e0 la pression"},{"location":"MCU_Commands.html","text":"Commandes MCU \u00b6 Ce document fournit des informations sur les commandes de bas niveau du microcontr\u00f4leur qui sont envoy\u00e9es depuis le logiciel \"h\u00f4te\" Klipper et trait\u00e9es par le firmware Klipper du microcontr\u00f4leur. Ce document n'est pas une r\u00e9f\u00e9rence faisant autorit\u00e9 pour ces commandes, ni une liste exclusive de toutes les commandes disponibles. Ce document peut \u00eatre utile aux d\u00e9veloppeurs souhaitant comprendre les commandes de bas niveau du microcontr\u00f4leur. Voir le document protocole pour plus d'informations sur le format des commandes et leur transmission. Les commandes ici sont d\u00e9crites en utilisant une syntaxe de style \"printf\" - pour ceux qui ne connaissent pas ce format, notez simplement que lorsqu'une s\u00e9quence '%...' est vue, elle doit \u00eatre remplac\u00e9e par un entier r\u00e9el. Par exemple, une description avec \"count=%c\" pourrait \u00eatre remplac\u00e9e par le texte \"count=10\". Notez que les param\u00e8tres qui sont consid\u00e9r\u00e9s comme des \"\u00e9num\u00e9rations\" (voir le document de protocole ci-dessus) prennent une valeur de cha\u00eene qui est automatiquement convertie en une valeur enti\u00e8re pour le microcontr\u00f4leur. Ceci est courant avec les param\u00e8tres nomm\u00e9s \"pin\" (ou qui ont le suffixe \"_pin\"). Commandes de d\u00e9marrage \u00b6 Il peut \u00eatre n\u00e9cessaire d'effectuer des actions ponctuelles pour configurer le microcontr\u00f4leur et ses p\u00e9riph\u00e9riques. Cette section r\u00e9pertorie les commandes courantes disponibles \u00e0 cette effet. Contrairement \u00e0 la plupart des commandes de microcontr\u00f4leur, ces commandes s'ex\u00e9cutent d\u00e8s leur r\u00e9ception et ne n\u00e9cessitent aucune configuration particuli\u00e8re. Commandes de d\u00e9marrage courantes : set_digital_out pin=%u value=%c : Cette commande configure imm\u00e9diatement la broche donn\u00e9e en tant que sortie num\u00e9rique GPIO et la d\u00e9finit soit \u00e0 un niveau bas (valeur=0) soit \u00e0 un niveau haut (valeur=1 ). Cette commande peut \u00eatre utile pour configurer la valeur initiale des LED et pour configurer la valeur initiale des broches de micro-pas du pilote de moteur pas \u00e0 pas. set_pwm_out pin=%u cycle_ticks=%u value=%hu : Cette commande configurera la broche donn\u00e9e pour utiliser la modulation de largeur d'impulsion (PWM) bas\u00e9e sur le mat\u00e9riel avec le nombre donn\u00e9 de cycle_ticks. Le \"cycle_ticks\" est le nombre de ticks d'horloge du MCU que chaque cycle de mise sous tension et hors tension doit durer. Une valeur cycle_ticks de 1 peut \u00eatre utilis\u00e9e pour demander le temps de cycle le plus rapide possible. Le param\u00e8tre \"valeur\" est compris entre 0 et 255, 0 indiquant un \u00e9tat enti\u00e8rement d\u00e9sactiv\u00e9 et 255 indiquant un \u00e9tat enti\u00e8rement activ\u00e9. Cette commande peut \u00eatre utile pour activer les ventilateurs de refroidissement du processeur et des buses. Configuration bas niveau du microcontr\u00f4leur \u00b6 La plupart des commandes du microcontr\u00f4leur n\u00e9cessitent une configuration initiale avant de pouvoir \u00eatre appel\u00e9es. Cette section fournit une vue d'ensemble du processus de configuration. Cette section et les sections suivantes ne sont susceptibles d'int\u00e9resser que les d\u00e9veloppeurs int\u00e9ress\u00e9s par les d\u00e9tails internes de Klipper. Lorsque l'h\u00f4te se connecte pour la premi\u00e8re fois au microcontr\u00f4leur, il commence toujours par obtenir un dictionnaire de donn\u00e9es (voir protocole pour plus d'informations). Une fois le dictionnaire de donn\u00e9es obtenu, l'h\u00f4te v\u00e9rifie si le microcontr\u00f4leur est dans un \u00e9tat \"configur\u00e9\" et le configure si ce n'est pas le cas. La configuration comprend les phases suivantes : get_config : L'h\u00f4te commence par v\u00e9rifier si le micro-contr\u00f4leur est d\u00e9j\u00e0 configur\u00e9. Le microcontr\u00f4leur r\u00e9pond \u00e0 cette commande par un message de r\u00e9ponse \u00ab config \u00bb. Le logiciel du microcontr\u00f4leur d\u00e9marre toujours dans un \u00e9tat non configur\u00e9 \u00e0 la mise sous tension. Il reste dans cet \u00e9tat jusqu'\u00e0 ce que l'h\u00f4te termine les processus de configuration (en \u00e9mettant une commande finalize_config). Si le microcontr\u00f4leur est d\u00e9j\u00e0 configur\u00e9 \u00e0 partir d'une session pr\u00e9c\u00e9dente (et est configur\u00e9 avec les param\u00e8tres souhait\u00e9s), aucune autre action n'est requise de la part de l'h\u00f4te et le processus de configuration se termine avec succ\u00e8s. allocate_oids count=%c : cette commande est envoy\u00e9e pour informer le microcontr\u00f4leur du nombre maximal d'identifiants d'objet (oid) requis par l'h\u00f4te. Il n'e faut envoyer cette commande qu'une seule fois. Un oid est un identifiant entier allou\u00e9 \u00e0 chaque stepper, chaque fin de course et chaque broche gpio programmable. L'h\u00f4te d\u00e9termine \u00e0 l'avance le nombre d'oids dont il aura besoin pour faire fonctionner le mat\u00e9riel et le transmet au microcontr\u00f4leur afin qu'il puisse allouer suffisamment de m\u00e9moire pour stocker un mappage de l'oid \u00e0 l'objet interne. config_XXX oid=%c ... : Par convention toute commande commen\u00e7ant par le pr\u00e9fixe \"config_\" cr\u00e9e un nouvel objet microcontr\u00f4leur et lui affecte l'oid donn\u00e9. Par exemple, la commande config_digital_out configurera la broche sp\u00e9cifi\u00e9e en tant que GPIO de sortie num\u00e9rique et cr\u00e9era un objet interne que l'h\u00f4te peut utiliser pour planifier des modifications du GPIO donn\u00e9. Le param\u00e8tre oid pass\u00e9 dans la commande config est s\u00e9lectionn\u00e9 par l'h\u00f4te et doit \u00eatre compris entre z\u00e9ro et le nombre maximal fourni dans la commande allow_oids. Les commandes de configuration ne peuvent \u00eatre ex\u00e9cut\u00e9es que lorsque le microcontr\u00f4leur n'est pas dans un \u00e9tat configur\u00e9 (c'est-\u00e0-dire avant que l'h\u00f4te n'envoie finalize_config) et apr\u00e8s que la commande allow_oids a \u00e9t\u00e9 envoy\u00e9e. finalize_config crc=%u : La commande finalize_config fait passer le microcontr\u00f4leur d'un \u00e9tat non configur\u00e9 \u00e0 un \u00e9tat configur\u00e9. Le param\u00e8tre crc transmis au microcontr\u00f4leur est stock\u00e9 et renvoy\u00e9 \u00e0 l'h\u00f4te dans les messages de r\u00e9ponse \"config\". Par convention, l'h\u00f4te prend un CRC 32 bits de la configuration qu'il demandera et au d\u00e9but des sessions de communication suivantes, il v\u00e9rifie que le CRC stock\u00e9 dans le microcontr\u00f4leur correspond exactement \u00e0 son CRC souhait\u00e9. Si le CRC ne correspond pas, l'h\u00f4te saura que le microcontr\u00f4leur n'a pas \u00e9t\u00e9 configur\u00e9 correctement. Objets de base du microcontr\u00f4leur \u00b6 Cette section r\u00e9pertorie quelques commandes de configuration couramment utilis\u00e9es. config_digital_out oid=%c pin=%u value=%c default_value=%c max_duration=%u : cette commande cr\u00e9e un objet de microcontr\u00f4leur interne pour la \"broche\" GPIO donn\u00e9e. La broche sera configur\u00e9e en mode de sortie num\u00e9rique et d\u00e9finie sur une valeur initiale telle que sp\u00e9cifi\u00e9e par 'value' (0 pour bas, 1 pour haut). La cr\u00e9ation d'un objet digital_out permet \u00e0 l'h\u00f4te de programmer des mises \u00e0 jour GPIO pour la broche donn\u00e9e \u00e0 des heures sp\u00e9cifi\u00e9es (voir la commande queue_digital_out d\u00e9crite ci-dessous). Si le logiciel du microcontr\u00f4leur passe en mode d'arr\u00eat, tous les objets digital_out configur\u00e9s seront d\u00e9finis sur 'default_value'. Le param\u00e8tre 'max_duration' est utilis\u00e9 pour impl\u00e9menter un contr\u00f4le de s\u00e9curit\u00e9 - s'il est diff\u00e9rent de z\u00e9ro, il s'agit du nombre maximal de ticks d'horloge pendannt lesquels l'h\u00f4te peut d\u00e9finir le GPIO donn\u00e9 sur une valeur autre que celle par d\u00e9faut sans autres mises \u00e0 jour. Par exemple, si la default_value est z\u00e9ro et la max_duration est de 16000, alors si l'h\u00f4te d\u00e9finit le gpio sur une valeur de un, il doit planifier une autre mise \u00e0 jour de la broche gpio (\u00e0 z\u00e9ro ou \u00e0 un) dans les 16000 tics d'horloge. Cette fonction de s\u00e9curit\u00e9 peut \u00eatre utilis\u00e9e avec des broches de chauffage pour s'assurer que l'h\u00f4te n'active pas le chauffage puis se d\u00e9connecte en le laissant activ\u00e9. config_pwm_out oid=%c pin=%u cycle_ticks=%u value=%hu default_value=%hu max_duration=%u : cette commande cr\u00e9e un objet interne pour les broches PWM mat\u00e9rielles pour lesquelles l'h\u00f4te peut planifier des mises \u00e0 jour . Son utilisation est analogue \u00e0 config_digital_out - voir la description des commandes 'set_pwm_out' et 'config_digital_out' pour la description des param\u00e8tres. config_analog_in oid=%c pin=%u : Cette commande permet de configurer une broche en mode d'\u00e9chantillonnage d'entr\u00e9e analogique. Une fois configur\u00e9e, la broche peut \u00eatre \u00e9chantillonn\u00e9e \u00e0 intervalle r\u00e9gulier \u00e0 l'aide de la commande query_analog_in (voir ci-dessous). config_stepper oid=%c step_pin=%c dir_pin=%c invert_step=%c step_pulse_ticks=%u : Cette commande cr\u00e9e un objet \"moteur pas \u00e0 pas\" interne. Les param\u00e8tres 'step_pin' et 'dir_pin' sp\u00e9cifient respectivement les broches de pas et de direction ; cette commande les configurera en mode de sortie num\u00e9rique. Le param\u00e8tre 'invert_step' sp\u00e9cifie si une \u00e9tape se produit sur un front montant (invert_step=0) ou descendant (invert_step=1). Le param\u00e8tre 'step_pulse_ticks' sp\u00e9cifie la dur\u00e9e minimale de l'impulsion de pas. Si le mcu exporte la constante 'STEPPER_BOTH_EDGE=1', le r\u00e9glage step_pulse_ticks=0 et invert_step=-1 sera configur\u00e9 pour marcher sur les fronts montant et descendant de la broche de pas. config_endstop oid=%c pin=%c pull_up=%c stepper_count=%c : Cette commande cr\u00e9e un objet \"endstop\" interne. Il est utilis\u00e9 pour sp\u00e9cifier les broches d'arr\u00eat et pour activer les op\u00e9rations de \"homing\" (voir la commande endstop_home ci-dessous). La commande configurera la broche sp\u00e9cifi\u00e9e en mode d'entr\u00e9e num\u00e9rique. Le param\u00e8tre 'pull_up' d\u00e9termine si les r\u00e9sistances pullup fournies par le mat\u00e9riel pour la broche (si disponibles) seront activ\u00e9es. Le param\u00e8tre 'stepper_count' sp\u00e9cifie le nombre maximum de pas dont cette but\u00e9e peut avoir besoin pendant une op\u00e9ration de prise d'origine (voir endstop_home ci-dessous). config_spi oid=%c bus=%u pin=%u mode=%u rate=%u shutdown_msg=%*s : Cette commande cr\u00e9e un objet SPI interne. Il est utilis\u00e9 avec les commandes spi_transfer et spi_send (voir ci-dessous). Le param\u00e8tre \"bus\" identifie le bus SPI \u00e0 utiliser (si le microcontr\u00f4leur a plus d'un bus SPI disponible). Le param\u00e8tre \"broche\" sp\u00e9cifie la broche de s\u00e9lection de puce (CS) pour le p\u00e9riph\u00e9rique. Le param\u00e8tre \"mode\" est le mode SPI (doit \u00eatre compris entre 0 et 3). Le param\u00e8tre \"rate\" sp\u00e9cifie le d\u00e9bit du bus SPI (en cycles par seconde). Enfin, le param\u00e8tre \"shutdown_msg\" est une commande SPI \u00e0 envoyer \u00e0 l'appareil donn\u00e9 si le microcontr\u00f4leur passe en \u00e9tat d'arr\u00eat. config_spi_without_cs oid=%c bus=%u mode=%u rate=%u shutdown_msg=%*s : Cette commande est similaire \u00e0 config_spi, mais sans d\u00e9finition de la broche CS. Il est utile pour les appareils SPI qui n'ont pas de ligne de s\u00e9lection de puce. Commandes courantes \u00b6 Cette section r\u00e9pertorie les commandes les plus couramment utilis\u00e9es. Cela n'int\u00e9resse probablement que les d\u00e9veloppeurs qui cherchent \u00e0 mieux comprendre Klipper. set_digital_out_pwm_cycle oid=%c cycle_ticks=%u : cette commande configure une broche de sortie num\u00e9rique (telle que cr\u00e9\u00e9e par config_digital_out) pour utiliser le \"PWM logciel\". Le 'cycle_ticks' est le nombre de tics d'horloge pour le cycle PWM. \u00c9tant donn\u00e9 que la commutation de sortie est impl\u00e9ment\u00e9e dans le logiciel du microcontr\u00f4leur, il est recommand\u00e9 que 'cycle_ticks' corresponde \u00e0 un temps de 10 ms ou plus. queue_digital_out oid=%c clock=%u on_ticks=%u : Cette commande permet de planifier une changement d'\u00e9tat d'une broche GPIO de sortie num\u00e9rique au tick d'horloge donn\u00e9e. Pour utiliser cette commande, une commande 'config_digital_out' avec le m\u00eame param\u00e8tre 'oid' doit avoir \u00e9t\u00e9 \u00e9mise lors de la configuration du microcontr\u00f4leur. Si 'set_digital_out_pwm_cycle' a \u00e9t\u00e9 appel\u00e9, alors 'on_ticks' est la dur\u00e9e d'activation (en ticks d'horloge) pour le cycle pwm. Sinon, 'on_ticks' doit \u00eatre soit 0 (pour basse tension) soit 1 (pour haute tension). queue_pwm_out oid=%c clock=%u value=%hu : planifie un changement sur une broche de sortie PWM mat\u00e9rielle. Voir les commandes 'queue_digital_out' et 'config_pwm_out' pour plus d'informations. query_analog_in oid=%c clock=%u sample_ticks=%u sample_count=%c rest_ticks=%u min_value=%hu max_value=%hu : Cette commande d\u00e9finit une r\u00e9cup\u00e9ration r\u00e9currente d'\u00e9chantillons d'entr\u00e9e analogique. Pour utiliser cette commande, une commande 'config_analog_in' avec le m\u00eame param\u00e8tre 'oid' doit avoir \u00e9t\u00e9 \u00e9mise lors de la configuration du microcontr\u00f4leur. Les \u00e9chantillons commenceront \u00e0 partir de l'heure 'clock', et ils rapporteront la valeur obtenue \u00e0 chaque tic d'horloge 'rest_ticks', il sur\u00e9chantillonnera avec un nombre 'sample_count' d'\u00e9chantillons et il se mettra en pause pendant le nombre 'sample_ticks' de tic d'horloge entre chaque \u00e9chantillonnage. Les param\u00e8tres 'min_value' et 'max_value' impl\u00e9mentent une fonction de s\u00e9curit\u00e9 - le logiciel du microcontr\u00f4leur v\u00e9rifiera que la valeur \u00e9chantillonn\u00e9e se situe toujours dans la plage fournie. Ceci est destin\u00e9 \u00e0 \u00eatre utilis\u00e9 avec des broches rattach\u00e9es aux thermistances contr\u00f4lant les radiateurs - il peut \u00eatre utilis\u00e9 pour v\u00e9rifier qu'un radiateur se trouve dans une plage de temp\u00e9rature correcte. get_clock : Cette commande am\u00e8ne le microcontr\u00f4leur \u00e0 g\u00e9n\u00e9rer un message de r\u00e9ponse \"clock\". L'h\u00f4te envoie cette commande une fois par seconde pour obtenir la valeur de l'horloge du microcontr\u00f4leur et pour estimer la d\u00e9rive entre les horloges de l'h\u00f4te et du microcontr\u00f4leur. Il permet \u00e0 l'h\u00f4te d'estimer avec pr\u00e9cision l'horloge du microcontr\u00f4leur. Commandes de moteurs pas \u00e0 pas \u00b6 queue_step oid=%c interval=%u count=%hu add=%hi : cette commande planifie le nombre de pas 'count' pour le stepper donn\u00e9, avec un nombre 'd'intervalle' de ticks d'horloge entre chaque pas. La premi\u00e8re \u00e9tape sera le nombre \"d'intervalle\" de ticks d'horloge depuis la derni\u00e8re \u00e9tape planifi\u00e9e pour le stepper donn\u00e9. Si 'add' n'est pas nul, l'intervalle sera ajust\u00e9 du montant 'add' apr\u00e8s chaque pas. Cette commande ajoute la s\u00e9quence d'intervalle/compte/ajout donn\u00e9e \u00e0 une file d'attente des pas. Il peut y avoir des centaines de ces s\u00e9quences en file d'attente pendant le fonctionnement normal. Une nouvelle s\u00e9quence est ajout\u00e9e \u00e0 la fin de la file d'attente et lorsque chaque s\u00e9quence termine son nombre de pas, elle est retir\u00e9e du d\u00e9but de la file d'attente. Ce syst\u00e8me permet au microcontr\u00f4leur de mettre en file d'attente potentiellement des centaines de milliers d'\u00e9tapes, le tout avec des dur\u00e9es fiables et pr\u00e9visibles. set_next_step_dir oid=%c dir=%c : Cette commande sp\u00e9cifie la valeur du dir_pin que la prochaine commande queue_step utilisera. reset_step_clock oid=%c clock=%u : Normalement, la synchronisation des pas est relative au dernier pas pour un stepper donn\u00e9. Cette commande r\u00e9initialise l'horloge de sorte que l'\u00e9tape suivante soit relative \u00e0 l'heure \"horloge\" fournie. L'h\u00f4te n'envoie g\u00e9n\u00e9ralement cette commande qu'au d\u00e9but d'une impression. stepper_get_position oid=%c : Cette commande am\u00e8ne le microcontr\u00f4leur \u00e0 g\u00e9n\u00e9rer un message de r\u00e9ponse \"stepper_position\" avec la position actuelle du stepper. La position est le nombre total d'\u00e9tapes g\u00e9n\u00e9r\u00e9es avec dir=1 moins le nombre total d'\u00e9tapes g\u00e9n\u00e9r\u00e9es avec dir=0. endstop_home oid=%c clock=%u sample_ticks=%u sample_count=%c rest_ticks=%u pin_value=%c : Cette commande est utilis\u00e9e lors des op\u00e9rations de \"homing\" des moteurs pas \u00e0 pas. Pour utiliser cette commande, une commande 'config_endstop' avec le m\u00eame param\u00e8tre 'oid' doit avoir \u00e9t\u00e9 \u00e9mise lors de la configuration du microcontr\u00f4leur. Lorsque cette commande est invoqu\u00e9e, le microcontr\u00f4leur \u00e9chantillonnera la broche endstop \u00e0 chaque tic d'horloge 'rest_ticks' et v\u00e9rifiera si elle a une valeur \u00e9gale \u00e0 'pin_value'. Si la valeur correspond (et continue de correspondre pour 'sample_count' \u00e9chantillons suppl\u00e9mentaires r\u00e9partis 'sample_ticks'), alors la file d'attente de mouvement pour le stepper associ\u00e9 sera effac\u00e9e et le stepper s'arr\u00eatera imm\u00e9diatement. L'h\u00f4te utilise cette commande pour impl\u00e9menter la prise d'origine - l'h\u00f4te demande \u00e0 la but\u00e9e d'\u00e9chantillonner pour le d\u00e9clencheur de but\u00e9e, puis il \u00e9met une s\u00e9rie de commandes queue_step pour d\u00e9placer un stepper vers la but\u00e9e. Une fois que le stepper atteint la but\u00e9e, le d\u00e9clencheur sera d\u00e9tect\u00e9, le mouvement arr\u00eat\u00e9 et l'h\u00f4te notifi\u00e9. D\u00e9placer la file d'attente \u00b6 Chaque commande queue_step utilise une entr\u00e9e dans la \"file d'attente de d\u00e9placement\" du microcontr\u00f4leur. Cette file d'attente est allou\u00e9e lorsqu'elle re\u00e7oit la commande \"finalize_config\", et elle signale le nombre d'entr\u00e9es de file d'attente disponibles dans les messages de r\u00e9ponse \"config\". Il est de la responsabilit\u00e9 de l'h\u00f4te de s'assurer qu'il y a de l'espace disponible dans la file d'attente avant d'envoyer une commande queue_step. Pour ce faire, l'h\u00f4te calcule le moment o\u00f9 chaque commande queue_step se termine et planifie de nouvelles commandes queue_step en cons\u00e9quence. Commandes SPI \u00b6 spi_transfer oid=%c data=%*s : Cette commande am\u00e8ne le microcontr\u00f4leur \u00e0 envoyer des \"donn\u00e9es\" au p\u00e9riph\u00e9rique spi sp\u00e9cifi\u00e9 par \"oid\" et g\u00e9n\u00e8re un message de r\u00e9ponse \"spi_transfer_response\" avec les donn\u00e9es retourn\u00e9es par le p\u00e9riph\u00e9rique. spi_send oid=%c data=%*s : Cette commande est similaire \u00e0 \"spi_transfer\", mais elle ne g\u00e9n\u00e8re pas de message \"spi_transfer_response\".","title":"Commandes MCU"},{"location":"MCU_Commands.html#commandes-mcu","text":"Ce document fournit des informations sur les commandes de bas niveau du microcontr\u00f4leur qui sont envoy\u00e9es depuis le logiciel \"h\u00f4te\" Klipper et trait\u00e9es par le firmware Klipper du microcontr\u00f4leur. Ce document n'est pas une r\u00e9f\u00e9rence faisant autorit\u00e9 pour ces commandes, ni une liste exclusive de toutes les commandes disponibles. Ce document peut \u00eatre utile aux d\u00e9veloppeurs souhaitant comprendre les commandes de bas niveau du microcontr\u00f4leur. Voir le document protocole pour plus d'informations sur le format des commandes et leur transmission. Les commandes ici sont d\u00e9crites en utilisant une syntaxe de style \"printf\" - pour ceux qui ne connaissent pas ce format, notez simplement que lorsqu'une s\u00e9quence '%...' est vue, elle doit \u00eatre remplac\u00e9e par un entier r\u00e9el. Par exemple, une description avec \"count=%c\" pourrait \u00eatre remplac\u00e9e par le texte \"count=10\". Notez que les param\u00e8tres qui sont consid\u00e9r\u00e9s comme des \"\u00e9num\u00e9rations\" (voir le document de protocole ci-dessus) prennent une valeur de cha\u00eene qui est automatiquement convertie en une valeur enti\u00e8re pour le microcontr\u00f4leur. Ceci est courant avec les param\u00e8tres nomm\u00e9s \"pin\" (ou qui ont le suffixe \"_pin\").","title":"Commandes MCU"},{"location":"MCU_Commands.html#commandes-de-demarrage","text":"Il peut \u00eatre n\u00e9cessaire d'effectuer des actions ponctuelles pour configurer le microcontr\u00f4leur et ses p\u00e9riph\u00e9riques. Cette section r\u00e9pertorie les commandes courantes disponibles \u00e0 cette effet. Contrairement \u00e0 la plupart des commandes de microcontr\u00f4leur, ces commandes s'ex\u00e9cutent d\u00e8s leur r\u00e9ception et ne n\u00e9cessitent aucune configuration particuli\u00e8re. Commandes de d\u00e9marrage courantes : set_digital_out pin=%u value=%c : Cette commande configure imm\u00e9diatement la broche donn\u00e9e en tant que sortie num\u00e9rique GPIO et la d\u00e9finit soit \u00e0 un niveau bas (valeur=0) soit \u00e0 un niveau haut (valeur=1 ). Cette commande peut \u00eatre utile pour configurer la valeur initiale des LED et pour configurer la valeur initiale des broches de micro-pas du pilote de moteur pas \u00e0 pas. set_pwm_out pin=%u cycle_ticks=%u value=%hu : Cette commande configurera la broche donn\u00e9e pour utiliser la modulation de largeur d'impulsion (PWM) bas\u00e9e sur le mat\u00e9riel avec le nombre donn\u00e9 de cycle_ticks. Le \"cycle_ticks\" est le nombre de ticks d'horloge du MCU que chaque cycle de mise sous tension et hors tension doit durer. Une valeur cycle_ticks de 1 peut \u00eatre utilis\u00e9e pour demander le temps de cycle le plus rapide possible. Le param\u00e8tre \"valeur\" est compris entre 0 et 255, 0 indiquant un \u00e9tat enti\u00e8rement d\u00e9sactiv\u00e9 et 255 indiquant un \u00e9tat enti\u00e8rement activ\u00e9. Cette commande peut \u00eatre utile pour activer les ventilateurs de refroidissement du processeur et des buses.","title":"Commandes de d\u00e9marrage"},{"location":"MCU_Commands.html#configuration-bas-niveau-du-microcontroleur","text":"La plupart des commandes du microcontr\u00f4leur n\u00e9cessitent une configuration initiale avant de pouvoir \u00eatre appel\u00e9es. Cette section fournit une vue d'ensemble du processus de configuration. Cette section et les sections suivantes ne sont susceptibles d'int\u00e9resser que les d\u00e9veloppeurs int\u00e9ress\u00e9s par les d\u00e9tails internes de Klipper. Lorsque l'h\u00f4te se connecte pour la premi\u00e8re fois au microcontr\u00f4leur, il commence toujours par obtenir un dictionnaire de donn\u00e9es (voir protocole pour plus d'informations). Une fois le dictionnaire de donn\u00e9es obtenu, l'h\u00f4te v\u00e9rifie si le microcontr\u00f4leur est dans un \u00e9tat \"configur\u00e9\" et le configure si ce n'est pas le cas. La configuration comprend les phases suivantes : get_config : L'h\u00f4te commence par v\u00e9rifier si le micro-contr\u00f4leur est d\u00e9j\u00e0 configur\u00e9. Le microcontr\u00f4leur r\u00e9pond \u00e0 cette commande par un message de r\u00e9ponse \u00ab config \u00bb. Le logiciel du microcontr\u00f4leur d\u00e9marre toujours dans un \u00e9tat non configur\u00e9 \u00e0 la mise sous tension. Il reste dans cet \u00e9tat jusqu'\u00e0 ce que l'h\u00f4te termine les processus de configuration (en \u00e9mettant une commande finalize_config). Si le microcontr\u00f4leur est d\u00e9j\u00e0 configur\u00e9 \u00e0 partir d'une session pr\u00e9c\u00e9dente (et est configur\u00e9 avec les param\u00e8tres souhait\u00e9s), aucune autre action n'est requise de la part de l'h\u00f4te et le processus de configuration se termine avec succ\u00e8s. allocate_oids count=%c : cette commande est envoy\u00e9e pour informer le microcontr\u00f4leur du nombre maximal d'identifiants d'objet (oid) requis par l'h\u00f4te. Il n'e faut envoyer cette commande qu'une seule fois. Un oid est un identifiant entier allou\u00e9 \u00e0 chaque stepper, chaque fin de course et chaque broche gpio programmable. L'h\u00f4te d\u00e9termine \u00e0 l'avance le nombre d'oids dont il aura besoin pour faire fonctionner le mat\u00e9riel et le transmet au microcontr\u00f4leur afin qu'il puisse allouer suffisamment de m\u00e9moire pour stocker un mappage de l'oid \u00e0 l'objet interne. config_XXX oid=%c ... : Par convention toute commande commen\u00e7ant par le pr\u00e9fixe \"config_\" cr\u00e9e un nouvel objet microcontr\u00f4leur et lui affecte l'oid donn\u00e9. Par exemple, la commande config_digital_out configurera la broche sp\u00e9cifi\u00e9e en tant que GPIO de sortie num\u00e9rique et cr\u00e9era un objet interne que l'h\u00f4te peut utiliser pour planifier des modifications du GPIO donn\u00e9. Le param\u00e8tre oid pass\u00e9 dans la commande config est s\u00e9lectionn\u00e9 par l'h\u00f4te et doit \u00eatre compris entre z\u00e9ro et le nombre maximal fourni dans la commande allow_oids. Les commandes de configuration ne peuvent \u00eatre ex\u00e9cut\u00e9es que lorsque le microcontr\u00f4leur n'est pas dans un \u00e9tat configur\u00e9 (c'est-\u00e0-dire avant que l'h\u00f4te n'envoie finalize_config) et apr\u00e8s que la commande allow_oids a \u00e9t\u00e9 envoy\u00e9e. finalize_config crc=%u : La commande finalize_config fait passer le microcontr\u00f4leur d'un \u00e9tat non configur\u00e9 \u00e0 un \u00e9tat configur\u00e9. Le param\u00e8tre crc transmis au microcontr\u00f4leur est stock\u00e9 et renvoy\u00e9 \u00e0 l'h\u00f4te dans les messages de r\u00e9ponse \"config\". Par convention, l'h\u00f4te prend un CRC 32 bits de la configuration qu'il demandera et au d\u00e9but des sessions de communication suivantes, il v\u00e9rifie que le CRC stock\u00e9 dans le microcontr\u00f4leur correspond exactement \u00e0 son CRC souhait\u00e9. Si le CRC ne correspond pas, l'h\u00f4te saura que le microcontr\u00f4leur n'a pas \u00e9t\u00e9 configur\u00e9 correctement.","title":"Configuration bas niveau du microcontr\u00f4leur"},{"location":"MCU_Commands.html#objets-de-base-du-microcontroleur","text":"Cette section r\u00e9pertorie quelques commandes de configuration couramment utilis\u00e9es. config_digital_out oid=%c pin=%u value=%c default_value=%c max_duration=%u : cette commande cr\u00e9e un objet de microcontr\u00f4leur interne pour la \"broche\" GPIO donn\u00e9e. La broche sera configur\u00e9e en mode de sortie num\u00e9rique et d\u00e9finie sur une valeur initiale telle que sp\u00e9cifi\u00e9e par 'value' (0 pour bas, 1 pour haut). La cr\u00e9ation d'un objet digital_out permet \u00e0 l'h\u00f4te de programmer des mises \u00e0 jour GPIO pour la broche donn\u00e9e \u00e0 des heures sp\u00e9cifi\u00e9es (voir la commande queue_digital_out d\u00e9crite ci-dessous). Si le logiciel du microcontr\u00f4leur passe en mode d'arr\u00eat, tous les objets digital_out configur\u00e9s seront d\u00e9finis sur 'default_value'. Le param\u00e8tre 'max_duration' est utilis\u00e9 pour impl\u00e9menter un contr\u00f4le de s\u00e9curit\u00e9 - s'il est diff\u00e9rent de z\u00e9ro, il s'agit du nombre maximal de ticks d'horloge pendannt lesquels l'h\u00f4te peut d\u00e9finir le GPIO donn\u00e9 sur une valeur autre que celle par d\u00e9faut sans autres mises \u00e0 jour. Par exemple, si la default_value est z\u00e9ro et la max_duration est de 16000, alors si l'h\u00f4te d\u00e9finit le gpio sur une valeur de un, il doit planifier une autre mise \u00e0 jour de la broche gpio (\u00e0 z\u00e9ro ou \u00e0 un) dans les 16000 tics d'horloge. Cette fonction de s\u00e9curit\u00e9 peut \u00eatre utilis\u00e9e avec des broches de chauffage pour s'assurer que l'h\u00f4te n'active pas le chauffage puis se d\u00e9connecte en le laissant activ\u00e9. config_pwm_out oid=%c pin=%u cycle_ticks=%u value=%hu default_value=%hu max_duration=%u : cette commande cr\u00e9e un objet interne pour les broches PWM mat\u00e9rielles pour lesquelles l'h\u00f4te peut planifier des mises \u00e0 jour . Son utilisation est analogue \u00e0 config_digital_out - voir la description des commandes 'set_pwm_out' et 'config_digital_out' pour la description des param\u00e8tres. config_analog_in oid=%c pin=%u : Cette commande permet de configurer une broche en mode d'\u00e9chantillonnage d'entr\u00e9e analogique. Une fois configur\u00e9e, la broche peut \u00eatre \u00e9chantillonn\u00e9e \u00e0 intervalle r\u00e9gulier \u00e0 l'aide de la commande query_analog_in (voir ci-dessous). config_stepper oid=%c step_pin=%c dir_pin=%c invert_step=%c step_pulse_ticks=%u : Cette commande cr\u00e9e un objet \"moteur pas \u00e0 pas\" interne. Les param\u00e8tres 'step_pin' et 'dir_pin' sp\u00e9cifient respectivement les broches de pas et de direction ; cette commande les configurera en mode de sortie num\u00e9rique. Le param\u00e8tre 'invert_step' sp\u00e9cifie si une \u00e9tape se produit sur un front montant (invert_step=0) ou descendant (invert_step=1). Le param\u00e8tre 'step_pulse_ticks' sp\u00e9cifie la dur\u00e9e minimale de l'impulsion de pas. Si le mcu exporte la constante 'STEPPER_BOTH_EDGE=1', le r\u00e9glage step_pulse_ticks=0 et invert_step=-1 sera configur\u00e9 pour marcher sur les fronts montant et descendant de la broche de pas. config_endstop oid=%c pin=%c pull_up=%c stepper_count=%c : Cette commande cr\u00e9e un objet \"endstop\" interne. Il est utilis\u00e9 pour sp\u00e9cifier les broches d'arr\u00eat et pour activer les op\u00e9rations de \"homing\" (voir la commande endstop_home ci-dessous). La commande configurera la broche sp\u00e9cifi\u00e9e en mode d'entr\u00e9e num\u00e9rique. Le param\u00e8tre 'pull_up' d\u00e9termine si les r\u00e9sistances pullup fournies par le mat\u00e9riel pour la broche (si disponibles) seront activ\u00e9es. Le param\u00e8tre 'stepper_count' sp\u00e9cifie le nombre maximum de pas dont cette but\u00e9e peut avoir besoin pendant une op\u00e9ration de prise d'origine (voir endstop_home ci-dessous). config_spi oid=%c bus=%u pin=%u mode=%u rate=%u shutdown_msg=%*s : Cette commande cr\u00e9e un objet SPI interne. Il est utilis\u00e9 avec les commandes spi_transfer et spi_send (voir ci-dessous). Le param\u00e8tre \"bus\" identifie le bus SPI \u00e0 utiliser (si le microcontr\u00f4leur a plus d'un bus SPI disponible). Le param\u00e8tre \"broche\" sp\u00e9cifie la broche de s\u00e9lection de puce (CS) pour le p\u00e9riph\u00e9rique. Le param\u00e8tre \"mode\" est le mode SPI (doit \u00eatre compris entre 0 et 3). Le param\u00e8tre \"rate\" sp\u00e9cifie le d\u00e9bit du bus SPI (en cycles par seconde). Enfin, le param\u00e8tre \"shutdown_msg\" est une commande SPI \u00e0 envoyer \u00e0 l'appareil donn\u00e9 si le microcontr\u00f4leur passe en \u00e9tat d'arr\u00eat. config_spi_without_cs oid=%c bus=%u mode=%u rate=%u shutdown_msg=%*s : Cette commande est similaire \u00e0 config_spi, mais sans d\u00e9finition de la broche CS. Il est utile pour les appareils SPI qui n'ont pas de ligne de s\u00e9lection de puce.","title":"Objets de base du microcontr\u00f4leur"},{"location":"MCU_Commands.html#commandes-courantes","text":"Cette section r\u00e9pertorie les commandes les plus couramment utilis\u00e9es. Cela n'int\u00e9resse probablement que les d\u00e9veloppeurs qui cherchent \u00e0 mieux comprendre Klipper. set_digital_out_pwm_cycle oid=%c cycle_ticks=%u : cette commande configure une broche de sortie num\u00e9rique (telle que cr\u00e9\u00e9e par config_digital_out) pour utiliser le \"PWM logciel\". Le 'cycle_ticks' est le nombre de tics d'horloge pour le cycle PWM. \u00c9tant donn\u00e9 que la commutation de sortie est impl\u00e9ment\u00e9e dans le logiciel du microcontr\u00f4leur, il est recommand\u00e9 que 'cycle_ticks' corresponde \u00e0 un temps de 10 ms ou plus. queue_digital_out oid=%c clock=%u on_ticks=%u : Cette commande permet de planifier une changement d'\u00e9tat d'une broche GPIO de sortie num\u00e9rique au tick d'horloge donn\u00e9e. Pour utiliser cette commande, une commande 'config_digital_out' avec le m\u00eame param\u00e8tre 'oid' doit avoir \u00e9t\u00e9 \u00e9mise lors de la configuration du microcontr\u00f4leur. Si 'set_digital_out_pwm_cycle' a \u00e9t\u00e9 appel\u00e9, alors 'on_ticks' est la dur\u00e9e d'activation (en ticks d'horloge) pour le cycle pwm. Sinon, 'on_ticks' doit \u00eatre soit 0 (pour basse tension) soit 1 (pour haute tension). queue_pwm_out oid=%c clock=%u value=%hu : planifie un changement sur une broche de sortie PWM mat\u00e9rielle. Voir les commandes 'queue_digital_out' et 'config_pwm_out' pour plus d'informations. query_analog_in oid=%c clock=%u sample_ticks=%u sample_count=%c rest_ticks=%u min_value=%hu max_value=%hu : Cette commande d\u00e9finit une r\u00e9cup\u00e9ration r\u00e9currente d'\u00e9chantillons d'entr\u00e9e analogique. Pour utiliser cette commande, une commande 'config_analog_in' avec le m\u00eame param\u00e8tre 'oid' doit avoir \u00e9t\u00e9 \u00e9mise lors de la configuration du microcontr\u00f4leur. Les \u00e9chantillons commenceront \u00e0 partir de l'heure 'clock', et ils rapporteront la valeur obtenue \u00e0 chaque tic d'horloge 'rest_ticks', il sur\u00e9chantillonnera avec un nombre 'sample_count' d'\u00e9chantillons et il se mettra en pause pendant le nombre 'sample_ticks' de tic d'horloge entre chaque \u00e9chantillonnage. Les param\u00e8tres 'min_value' et 'max_value' impl\u00e9mentent une fonction de s\u00e9curit\u00e9 - le logiciel du microcontr\u00f4leur v\u00e9rifiera que la valeur \u00e9chantillonn\u00e9e se situe toujours dans la plage fournie. Ceci est destin\u00e9 \u00e0 \u00eatre utilis\u00e9 avec des broches rattach\u00e9es aux thermistances contr\u00f4lant les radiateurs - il peut \u00eatre utilis\u00e9 pour v\u00e9rifier qu'un radiateur se trouve dans une plage de temp\u00e9rature correcte. get_clock : Cette commande am\u00e8ne le microcontr\u00f4leur \u00e0 g\u00e9n\u00e9rer un message de r\u00e9ponse \"clock\". L'h\u00f4te envoie cette commande une fois par seconde pour obtenir la valeur de l'horloge du microcontr\u00f4leur et pour estimer la d\u00e9rive entre les horloges de l'h\u00f4te et du microcontr\u00f4leur. Il permet \u00e0 l'h\u00f4te d'estimer avec pr\u00e9cision l'horloge du microcontr\u00f4leur.","title":"Commandes courantes"},{"location":"MCU_Commands.html#commandes-de-moteurs-pas-a-pas","text":"queue_step oid=%c interval=%u count=%hu add=%hi : cette commande planifie le nombre de pas 'count' pour le stepper donn\u00e9, avec un nombre 'd'intervalle' de ticks d'horloge entre chaque pas. La premi\u00e8re \u00e9tape sera le nombre \"d'intervalle\" de ticks d'horloge depuis la derni\u00e8re \u00e9tape planifi\u00e9e pour le stepper donn\u00e9. Si 'add' n'est pas nul, l'intervalle sera ajust\u00e9 du montant 'add' apr\u00e8s chaque pas. Cette commande ajoute la s\u00e9quence d'intervalle/compte/ajout donn\u00e9e \u00e0 une file d'attente des pas. Il peut y avoir des centaines de ces s\u00e9quences en file d'attente pendant le fonctionnement normal. Une nouvelle s\u00e9quence est ajout\u00e9e \u00e0 la fin de la file d'attente et lorsque chaque s\u00e9quence termine son nombre de pas, elle est retir\u00e9e du d\u00e9but de la file d'attente. Ce syst\u00e8me permet au microcontr\u00f4leur de mettre en file d'attente potentiellement des centaines de milliers d'\u00e9tapes, le tout avec des dur\u00e9es fiables et pr\u00e9visibles. set_next_step_dir oid=%c dir=%c : Cette commande sp\u00e9cifie la valeur du dir_pin que la prochaine commande queue_step utilisera. reset_step_clock oid=%c clock=%u : Normalement, la synchronisation des pas est relative au dernier pas pour un stepper donn\u00e9. Cette commande r\u00e9initialise l'horloge de sorte que l'\u00e9tape suivante soit relative \u00e0 l'heure \"horloge\" fournie. L'h\u00f4te n'envoie g\u00e9n\u00e9ralement cette commande qu'au d\u00e9but d'une impression. stepper_get_position oid=%c : Cette commande am\u00e8ne le microcontr\u00f4leur \u00e0 g\u00e9n\u00e9rer un message de r\u00e9ponse \"stepper_position\" avec la position actuelle du stepper. La position est le nombre total d'\u00e9tapes g\u00e9n\u00e9r\u00e9es avec dir=1 moins le nombre total d'\u00e9tapes g\u00e9n\u00e9r\u00e9es avec dir=0. endstop_home oid=%c clock=%u sample_ticks=%u sample_count=%c rest_ticks=%u pin_value=%c : Cette commande est utilis\u00e9e lors des op\u00e9rations de \"homing\" des moteurs pas \u00e0 pas. Pour utiliser cette commande, une commande 'config_endstop' avec le m\u00eame param\u00e8tre 'oid' doit avoir \u00e9t\u00e9 \u00e9mise lors de la configuration du microcontr\u00f4leur. Lorsque cette commande est invoqu\u00e9e, le microcontr\u00f4leur \u00e9chantillonnera la broche endstop \u00e0 chaque tic d'horloge 'rest_ticks' et v\u00e9rifiera si elle a une valeur \u00e9gale \u00e0 'pin_value'. Si la valeur correspond (et continue de correspondre pour 'sample_count' \u00e9chantillons suppl\u00e9mentaires r\u00e9partis 'sample_ticks'), alors la file d'attente de mouvement pour le stepper associ\u00e9 sera effac\u00e9e et le stepper s'arr\u00eatera imm\u00e9diatement. L'h\u00f4te utilise cette commande pour impl\u00e9menter la prise d'origine - l'h\u00f4te demande \u00e0 la but\u00e9e d'\u00e9chantillonner pour le d\u00e9clencheur de but\u00e9e, puis il \u00e9met une s\u00e9rie de commandes queue_step pour d\u00e9placer un stepper vers la but\u00e9e. Une fois que le stepper atteint la but\u00e9e, le d\u00e9clencheur sera d\u00e9tect\u00e9, le mouvement arr\u00eat\u00e9 et l'h\u00f4te notifi\u00e9.","title":"Commandes de moteurs pas \u00e0 pas"},{"location":"MCU_Commands.html#deplacer-la-file-dattente","text":"Chaque commande queue_step utilise une entr\u00e9e dans la \"file d'attente de d\u00e9placement\" du microcontr\u00f4leur. Cette file d'attente est allou\u00e9e lorsqu'elle re\u00e7oit la commande \"finalize_config\", et elle signale le nombre d'entr\u00e9es de file d'attente disponibles dans les messages de r\u00e9ponse \"config\". Il est de la responsabilit\u00e9 de l'h\u00f4te de s'assurer qu'il y a de l'espace disponible dans la file d'attente avant d'envoyer une commande queue_step. Pour ce faire, l'h\u00f4te calcule le moment o\u00f9 chaque commande queue_step se termine et planifie de nouvelles commandes queue_step en cons\u00e9quence.","title":"D\u00e9placer la file d'attente"},{"location":"MCU_Commands.html#commandes-spi","text":"spi_transfer oid=%c data=%*s : Cette commande am\u00e8ne le microcontr\u00f4leur \u00e0 envoyer des \"donn\u00e9es\" au p\u00e9riph\u00e9rique spi sp\u00e9cifi\u00e9 par \"oid\" et g\u00e9n\u00e8re un message de r\u00e9ponse \"spi_transfer_response\" avec les donn\u00e9es retourn\u00e9es par le p\u00e9riph\u00e9rique. spi_send oid=%c data=%*s : Cette commande est similaire \u00e0 \"spi_transfer\", mais elle ne g\u00e9n\u00e8re pas de message \"spi_transfer_response\".","title":"Commandes SPI"},{"location":"Manual_Level.html","text":"Nivellement manuel \u00b6 Ce document d\u00e9crit les outils pour le r\u00e9glage de la fin de course Z et pour effectuer les r\u00e9glages sur les vis de mise \u00e0 niveau du lit. Calibrer la fin de course Z \u00b6 Une position pr\u00e9cise de la but\u00e9e Z est essentielle pour obtenir des impressions de haute qualit\u00e9. Notez que la pr\u00e9cision de l'interrupteur de fin de course Z lui-m\u00eame peut \u00eatre un facteur limitant. Si vous utilisez des pilotes de moteurs pas \u00e0 pas Trinamic, pensez \u00e0 activer la d\u00e9tection endstop phase pour am\u00e9liorer la pr\u00e9cision du commutateur. Pour effectuer un \u00e9talonnage de la fin de course Z, placez l'imprimante \u00e0 l'origine, d\u00e9placez la t\u00eate vers une position Z situ\u00e9e \u00e0 au moins cinq millim\u00e8tres au-dessus du lit (si ce n'est d\u00e9j\u00e0 fait), d\u00e9placez ensuite la t\u00eate vers une position XY pr\u00e8s du centre de le lit, puis acc\u00e9dez \u00e0 l'aide du terminal ex\u00e9cutez : Z_ENDSTOP_CALIBRATE Suivez ensuite les \u00e9tapes d\u00e9crites dans \"le test du papier\" pour d\u00e9terminer la distance r\u00e9elle entre la buse et le lit \u00e0 l'emplacement donn\u00e9. Une fois ces \u00e9tapes termin\u00e9es, on peut taper ACCEPT pour valider la position et enregistrer les r\u00e9sultats dans le fichier de configuration avec : SAVE_CONFIG Il est pr\u00e9f\u00e9rable d'utiliser un interrupteur de fin de course Z \u00e0 l'extr\u00e9mit\u00e9 de l'axe Z oppos\u00e9e au lit (il est plus s\u00e9curisant d'effectuer le retour au point d'origine loin du lit). Cependant, si l'on doit se diriger vers le lit, il est recommand\u00e9 de r\u00e9gler la but\u00e9e de fin de course de mani\u00e8re \u00e0 ce qu'elle se d\u00e9clenche \u00e0 une petite distance (par exemple, 0,5 mm) au-dessus du lit. Presque tous les interrupteurs de fin de course peuvent \u00eatre enfonc\u00e9s en toute s\u00e9curit\u00e9 \u00e0 une petite distance au-del\u00e0 de leur point de d\u00e9clenchement. Lorsque cela est fait, on devrait constater que la commande Z_ENDSTOP_CALIBRATE rapporte une petite valeur positive (par exemple, 0,5 mm) pour la position Z_endstop. D\u00e9clencher la but\u00e9e de fin de course alors qu'elle est encore \u00e0 une certaine distance du lit r\u00e9duit le risque d'\u00e9crasement involontaire de la buse sur le lit. Certaines imprimantes laissent la possibilit\u00e9 d'ajuster manuellement l'emplacement de l'interrupteur de fin de course. Cependant, il est recommand\u00e9 d'effectuer le positionnement de la but\u00e9e Z dans le logiciel avec Klipper - une fois que la but\u00e9e est bien positionn\u00e9, on peut faire d'autres ajustements en ex\u00e9cutant Z_ENDSTOP_CALIBRATE ou en mettant \u00e0 jour manuellement la position Z_endstop dans le fichier de configuration. R\u00e9glage des vis de mise \u00e0 niveau du lit \u00b6 Le secret pour obtenir un bon nivellement du lit avec les vis est d'utiliser le syst\u00e8me de mouvement de haute pr\u00e9cision de l'imprimante pendant le processus de nivellement du lit lui-m\u00eame. Cela se fait en commandant la buse \u00e0 une position proche de chaque vis de r\u00e9glage du lit, puis en ajustant cette vis jusqu'\u00e0 ce que le lit soit \u00e0 une distance d\u00e9finie de la buse. Klipper a un outil pour vous aider. Pour utiliser l'outil, il est n\u00e9cessaire de sp\u00e9cifier l'emplacement XY de chaque vis. Cela se fait en cr\u00e9ant une section de configuration [bed_screws] . Par exemple, cela pourrait ressembler \u00e0 : [bed_screws] screw1: 100, 50 screw2: 100, 150 screw3: 150, 100 Si la vis de r\u00e9glage se trouve sous le lit, sp\u00e9cifiez la position XY directement au-dessus de la vis. Si la vis est \u00e0 l'ext\u00e9rieur du lit, sp\u00e9cifiez une position XY la plus proche de la vis tout en restant dans les limites du lit. Une fois que le fichier de configuration est pr\u00eat, ex\u00e9cutez RESTART pour charger la nouvelle configuration, puis vous pouvez d\u00e9marrer l'outil en ex\u00e9cutant : BED_SCREWS_ADJUST Cet outil va d\u00e9placer la buse de l'imprimante vers chaque emplacement XY de vis, puis d\u00e9placera la buse \u00e0 une hauteur Z = 0. \u00c0 ce stade, on peut utiliser le \"test du papier\" pour ajuster la vis de r\u00e9glage directement sous la buse. Voir les informations d\u00e9crites dans \"le test du papier\" , mais ajustez la vis de r\u00e9glage au lieu de d\u00e9placer la buse \u00e0 diff\u00e9rentes hauteurs. Ajustez la vis de r\u00e9glage jusqu'\u00e0 ce qu'il y ait une petite friction lorsque vous poussez le papier d'avant en arri\u00e8re. Une fois la vis ajust\u00e9e de mani\u00e8re \u00e0 ressentir une l\u00e9g\u00e8re friction, ex\u00e9cutez la commande ACCEPT ou ADJUSTED . Utilisez la commande ADJUSTED si la vis du lit n\u00e9cessitait un ajustement (g\u00e9n\u00e9ralement plus d'environ 1/8 de tour de vis). Utilisez la commande ACCEPTER si aucun ajustement significatif n'est n\u00e9cessaire. Les deux commandes feront passer l'outil \u00e0 la vis suivante. (Lorsqu'une commande ADJUSTED est utilis\u00e9e, l'outil programme un cycle suppl\u00e9mentaire d'ajustements des vis\u202f; l'outil se termine avec succ\u00e8s lorsque toutes les vis d'assise sont v\u00e9rifi\u00e9es pour ne pas n\u00e9cessiter d'ajustements importants.) On peut utiliser la commande ABORT pour quitter l'outil plus t\u00f4t. Ce syst\u00e8me fonctionne mieux lorsque l'imprimante a une surface d'impression plate (telle que du verre) et des rails rectilignes. Une fois l'outil de nivellement du lit termin\u00e9 avec succ\u00e8s, le lit est pr\u00eat pour l'impression. R\u00e9glages fin des vis de nivellement \u00b6 Si l'imprimante utilise trois vis de r\u00e9glages et que les trois vis sont sous le lit, il est alors \u00eatre possible d'effectuer une deuxi\u00e8me \u00e9tape de mise \u00e0 niveau du lit de \u00ab haute pr\u00e9cision \u00bb. Cela se fait en d\u00e9pla\u00e7ant la buse vers les endroits les plus \u00e9loign\u00e9s des vis de r\u00e9glages. Par exemple, consid\u00e9rons un lit avec des vis aux emplacements A, B et C : Pour chaque r\u00e9glage effectu\u00e9 sur la vis du lit \u00e0 l'emplacement C, le lit oscillera le long d'un axe d\u00e9fini par les deux vis du lit restantes (repr\u00e9sent\u00e9es ici par une ligne verte). Dans cette situation, chaque r\u00e9glage de la vis du lit en C d\u00e9placera le lit en position D d'une plus grande distance que directement en C. Il est ainsi possible d'effectuer un r\u00e9glage am\u00e9lior\u00e9 de la vis C lorsque la buse est en position D. Pour activer cette fonctionnalit\u00e9, il faudra d\u00e9terminer les coordonn\u00e9es suppl\u00e9mentaires de la buse et les ajouter au fichier de configuration. Par exemple, cela pourrait ressembler \u00e0 : [bed_screws] screw1: 100, 50 screw1_fine_adjust: 0, 0 screw2: 100, 150 screw2_fine_adjust: 300, 300 screw3: 150, 100 screw3_fine_adjust: 0, 100 Lorsque cette fonctionnalit\u00e9 est activ\u00e9e, la commande BED_SCREWS_ADJUST demandera d'abord des ajustements grossiers directement au-dessus de chaque position de vis, et une fois ceux-ci accept\u00e9s, il demandera des ajustements fins aux emplacements suppl\u00e9mentaires. Continuez \u00e0 utiliser ACCEPT et ADJUSTED \u00e0 chaque position. R\u00e9glage des vis de mise \u00e0 niveau du lit \u00e0 l'aide de la sonde de lit \u00b6 C'est une autre fa\u00e7on de calibrer le niveau du lit avec la sonde de lit. Pour l'utiliser, vous devez disposer d'une sonde Z (BL Touch, capteur inductif, etc.). Pour activer cette fonctionnalit\u00e9, il faut d\u00e9terminer les coordonn\u00e9es de la buse de sorte que la sonde Z soit au-dessus des vis, puis les ajouter au fichier de configuration. Par exemple, cela pourrait ressembler \u00e0 : [screws_tilt_adjust] screw1: -5, 30 screw1_name: front left screw screw2: 155, 30 screw2_name: front right screw screw3: 155, 190 screw3_name: rear right screw screw4: -5, 190 screw4_name: rear left screw horizontal_move_z: 10. speed: 50. screw_thread: CW-M3 La vis1 est toujours le point de r\u00e9f\u00e9rence pour les autres, donc le syst\u00e8me suppose que la vis1 est \u00e0 la bonne hauteur. Ex\u00e9cutez toujours G28 en premier, puis ex\u00e9cutez SCREWS_TILT_CALCULATE - cela devrait produire une sortie similaire \u00e0 : Send: G28 Recv: ok Send: SCREWS_TILT_CALCULATE Recv: // 01:20 means 1 full turn and 20 minutes, CW=clockwise, CCW=counter-clockwise Recv: // front left screw (base) : x=-5.0, y=30.0, z=2.48750 Recv: // front right screw : x=155.0, y=30.0, z=2.36000 : adjust CW 01:15 Recv: // rear right screw : y=155.0, y=190.0, z=2.71500 : adjust CCW 00:50 Recv: // read left screw : x=-5.0, y=190.0, z=2.47250 : adjust CW 00:02 Recv: ok Cela signifie que : la vis avant gauche est le point de r\u00e9f\u00e9rence vous ne devez pas la changer. la vis avant droite doit \u00eatre tourn\u00e9e dans le sens des aiguilles d'une montre d'un tour complet et d'un quart de tour La vis arri\u00e8re droite doit \u00eatre tourn\u00e9e dans le sens inverse des aiguilles d\u2019une montre d'environ 50 minutes la vis arri\u00e8re gauche doit \u00eatre tourn\u00e9e dans le sens des aiguilles d'une montre d'un angle de 2 minutes (pas besoin c'est ok) Notez que \"minutes\" fait r\u00e9f\u00e9rence aux \"minutes d'un cadran d'horloge\". Ainsi, par exemple, 15 minutes correspondent \u00e0 un quart de tour complet. R\u00e9p\u00e9tez le processus plusieurs fois jusqu'\u00e0 ce que vous obteniez un bon niveau de lit - normalement lorsque tous les ajustements sont inf\u00e9rieurs \u00e0 une rotation de 6 minutes des vis de r\u00e9glage. Si vous utilisez une sonde mont\u00e9e sur le c\u00f4t\u00e9 de la hotend (c'est-\u00e0-dire qu'elle a un d\u00e9calage X ou Y), notez que le r\u00e9glage de l'inclinaison du lit rendra caduc l'\u00e9talonnage de sonde pr\u00e9c\u00e9demment effectu\u00e9 avec un lit inclin\u00e9. Assurez-vous d'ex\u00e9cuter \u00e9talonnage de la sonde apr\u00e8s avoir ajust\u00e9 les vis du lit. Le param\u00e8tre MAX_DEVIATION est utile lorsqu'un maillage de lit sauvegard\u00e9 est utilis\u00e9, pour s'assurer que le niveau du lit n'a pas trop d\u00e9riv\u00e9 de l'endroit o\u00f9 il se trouvait lorsque le maillage a \u00e9t\u00e9 cr\u00e9\u00e9. Par exemple, SCREWS_TILT_CALCULATE MAX_DEVIATION=0.01 peut \u00eatre ajout\u00e9 au gcode de d\u00e9marrage personnalis\u00e9 du trancheur avant le chargement du maillage. Il interrompra l'impression si la limite configur\u00e9e est d\u00e9pass\u00e9e (0,01 mm dans cet exemple), donnant \u00e0 l'utilisateur une chance d'ajuster les vis et de red\u00e9marrer l'impression. Le param\u00e8tre DIRECTION est utile si vous ne pouvez tourner les vis de r\u00e9glage de votre lit que dans un seul sens. Par exemple, vous pourriez avoir des vis qui commencent \u00e0 \u00eatre serr\u00e9es dans leur position la plus basse (ou la plus haute) possible, qui ne peuvent \u00eatre tourn\u00e9es que dans une seule direction, pour \u00e9lever (ou abaisser) le lit. Si vous ne pouvez tourner les vis que dans le sens des aiguilles d'une montre, ex\u00e9cutez SCREWS_TILT_CALCULATE DIRECTION=CW . Si vous ne pouvez les tourner que dans le sens antihoraire, ex\u00e9cutez SCREWS_TILT_CALCULATE DIRECTION=CCW . Un point de r\u00e9f\u00e9rence appropri\u00e9 sera choisi de sorte que le lit puisse \u00eatre nivel\u00e9 en tournant toutes les vis dans la direction donn\u00e9e.","title":"Nivellement manuel"},{"location":"Manual_Level.html#nivellement-manuel","text":"Ce document d\u00e9crit les outils pour le r\u00e9glage de la fin de course Z et pour effectuer les r\u00e9glages sur les vis de mise \u00e0 niveau du lit.","title":"Nivellement manuel"},{"location":"Manual_Level.html#calibrer-la-fin-de-course-z","text":"Une position pr\u00e9cise de la but\u00e9e Z est essentielle pour obtenir des impressions de haute qualit\u00e9. Notez que la pr\u00e9cision de l'interrupteur de fin de course Z lui-m\u00eame peut \u00eatre un facteur limitant. Si vous utilisez des pilotes de moteurs pas \u00e0 pas Trinamic, pensez \u00e0 activer la d\u00e9tection endstop phase pour am\u00e9liorer la pr\u00e9cision du commutateur. Pour effectuer un \u00e9talonnage de la fin de course Z, placez l'imprimante \u00e0 l'origine, d\u00e9placez la t\u00eate vers une position Z situ\u00e9e \u00e0 au moins cinq millim\u00e8tres au-dessus du lit (si ce n'est d\u00e9j\u00e0 fait), d\u00e9placez ensuite la t\u00eate vers une position XY pr\u00e8s du centre de le lit, puis acc\u00e9dez \u00e0 l'aide du terminal ex\u00e9cutez : Z_ENDSTOP_CALIBRATE Suivez ensuite les \u00e9tapes d\u00e9crites dans \"le test du papier\" pour d\u00e9terminer la distance r\u00e9elle entre la buse et le lit \u00e0 l'emplacement donn\u00e9. Une fois ces \u00e9tapes termin\u00e9es, on peut taper ACCEPT pour valider la position et enregistrer les r\u00e9sultats dans le fichier de configuration avec : SAVE_CONFIG Il est pr\u00e9f\u00e9rable d'utiliser un interrupteur de fin de course Z \u00e0 l'extr\u00e9mit\u00e9 de l'axe Z oppos\u00e9e au lit (il est plus s\u00e9curisant d'effectuer le retour au point d'origine loin du lit). Cependant, si l'on doit se diriger vers le lit, il est recommand\u00e9 de r\u00e9gler la but\u00e9e de fin de course de mani\u00e8re \u00e0 ce qu'elle se d\u00e9clenche \u00e0 une petite distance (par exemple, 0,5 mm) au-dessus du lit. Presque tous les interrupteurs de fin de course peuvent \u00eatre enfonc\u00e9s en toute s\u00e9curit\u00e9 \u00e0 une petite distance au-del\u00e0 de leur point de d\u00e9clenchement. Lorsque cela est fait, on devrait constater que la commande Z_ENDSTOP_CALIBRATE rapporte une petite valeur positive (par exemple, 0,5 mm) pour la position Z_endstop. D\u00e9clencher la but\u00e9e de fin de course alors qu'elle est encore \u00e0 une certaine distance du lit r\u00e9duit le risque d'\u00e9crasement involontaire de la buse sur le lit. Certaines imprimantes laissent la possibilit\u00e9 d'ajuster manuellement l'emplacement de l'interrupteur de fin de course. Cependant, il est recommand\u00e9 d'effectuer le positionnement de la but\u00e9e Z dans le logiciel avec Klipper - une fois que la but\u00e9e est bien positionn\u00e9, on peut faire d'autres ajustements en ex\u00e9cutant Z_ENDSTOP_CALIBRATE ou en mettant \u00e0 jour manuellement la position Z_endstop dans le fichier de configuration.","title":"Calibrer la fin de course Z"},{"location":"Manual_Level.html#reglage-des-vis-de-mise-a-niveau-du-lit","text":"Le secret pour obtenir un bon nivellement du lit avec les vis est d'utiliser le syst\u00e8me de mouvement de haute pr\u00e9cision de l'imprimante pendant le processus de nivellement du lit lui-m\u00eame. Cela se fait en commandant la buse \u00e0 une position proche de chaque vis de r\u00e9glage du lit, puis en ajustant cette vis jusqu'\u00e0 ce que le lit soit \u00e0 une distance d\u00e9finie de la buse. Klipper a un outil pour vous aider. Pour utiliser l'outil, il est n\u00e9cessaire de sp\u00e9cifier l'emplacement XY de chaque vis. Cela se fait en cr\u00e9ant une section de configuration [bed_screws] . Par exemple, cela pourrait ressembler \u00e0 : [bed_screws] screw1: 100, 50 screw2: 100, 150 screw3: 150, 100 Si la vis de r\u00e9glage se trouve sous le lit, sp\u00e9cifiez la position XY directement au-dessus de la vis. Si la vis est \u00e0 l'ext\u00e9rieur du lit, sp\u00e9cifiez une position XY la plus proche de la vis tout en restant dans les limites du lit. Une fois que le fichier de configuration est pr\u00eat, ex\u00e9cutez RESTART pour charger la nouvelle configuration, puis vous pouvez d\u00e9marrer l'outil en ex\u00e9cutant : BED_SCREWS_ADJUST Cet outil va d\u00e9placer la buse de l'imprimante vers chaque emplacement XY de vis, puis d\u00e9placera la buse \u00e0 une hauteur Z = 0. \u00c0 ce stade, on peut utiliser le \"test du papier\" pour ajuster la vis de r\u00e9glage directement sous la buse. Voir les informations d\u00e9crites dans \"le test du papier\" , mais ajustez la vis de r\u00e9glage au lieu de d\u00e9placer la buse \u00e0 diff\u00e9rentes hauteurs. Ajustez la vis de r\u00e9glage jusqu'\u00e0 ce qu'il y ait une petite friction lorsque vous poussez le papier d'avant en arri\u00e8re. Une fois la vis ajust\u00e9e de mani\u00e8re \u00e0 ressentir une l\u00e9g\u00e8re friction, ex\u00e9cutez la commande ACCEPT ou ADJUSTED . Utilisez la commande ADJUSTED si la vis du lit n\u00e9cessitait un ajustement (g\u00e9n\u00e9ralement plus d'environ 1/8 de tour de vis). Utilisez la commande ACCEPTER si aucun ajustement significatif n'est n\u00e9cessaire. Les deux commandes feront passer l'outil \u00e0 la vis suivante. (Lorsqu'une commande ADJUSTED est utilis\u00e9e, l'outil programme un cycle suppl\u00e9mentaire d'ajustements des vis\u202f; l'outil se termine avec succ\u00e8s lorsque toutes les vis d'assise sont v\u00e9rifi\u00e9es pour ne pas n\u00e9cessiter d'ajustements importants.) On peut utiliser la commande ABORT pour quitter l'outil plus t\u00f4t. Ce syst\u00e8me fonctionne mieux lorsque l'imprimante a une surface d'impression plate (telle que du verre) et des rails rectilignes. Une fois l'outil de nivellement du lit termin\u00e9 avec succ\u00e8s, le lit est pr\u00eat pour l'impression.","title":"R\u00e9glage des vis de mise \u00e0 niveau du lit"},{"location":"Manual_Level.html#reglages-fin-des-vis-de-nivellement","text":"Si l'imprimante utilise trois vis de r\u00e9glages et que les trois vis sont sous le lit, il est alors \u00eatre possible d'effectuer une deuxi\u00e8me \u00e9tape de mise \u00e0 niveau du lit de \u00ab haute pr\u00e9cision \u00bb. Cela se fait en d\u00e9pla\u00e7ant la buse vers les endroits les plus \u00e9loign\u00e9s des vis de r\u00e9glages. Par exemple, consid\u00e9rons un lit avec des vis aux emplacements A, B et C : Pour chaque r\u00e9glage effectu\u00e9 sur la vis du lit \u00e0 l'emplacement C, le lit oscillera le long d'un axe d\u00e9fini par les deux vis du lit restantes (repr\u00e9sent\u00e9es ici par une ligne verte). Dans cette situation, chaque r\u00e9glage de la vis du lit en C d\u00e9placera le lit en position D d'une plus grande distance que directement en C. Il est ainsi possible d'effectuer un r\u00e9glage am\u00e9lior\u00e9 de la vis C lorsque la buse est en position D. Pour activer cette fonctionnalit\u00e9, il faudra d\u00e9terminer les coordonn\u00e9es suppl\u00e9mentaires de la buse et les ajouter au fichier de configuration. Par exemple, cela pourrait ressembler \u00e0 : [bed_screws] screw1: 100, 50 screw1_fine_adjust: 0, 0 screw2: 100, 150 screw2_fine_adjust: 300, 300 screw3: 150, 100 screw3_fine_adjust: 0, 100 Lorsque cette fonctionnalit\u00e9 est activ\u00e9e, la commande BED_SCREWS_ADJUST demandera d'abord des ajustements grossiers directement au-dessus de chaque position de vis, et une fois ceux-ci accept\u00e9s, il demandera des ajustements fins aux emplacements suppl\u00e9mentaires. Continuez \u00e0 utiliser ACCEPT et ADJUSTED \u00e0 chaque position.","title":"R\u00e9glages fin des vis de nivellement"},{"location":"Manual_Level.html#reglage-des-vis-de-mise-a-niveau-du-lit-a-laide-de-la-sonde-de-lit","text":"C'est une autre fa\u00e7on de calibrer le niveau du lit avec la sonde de lit. Pour l'utiliser, vous devez disposer d'une sonde Z (BL Touch, capteur inductif, etc.). Pour activer cette fonctionnalit\u00e9, il faut d\u00e9terminer les coordonn\u00e9es de la buse de sorte que la sonde Z soit au-dessus des vis, puis les ajouter au fichier de configuration. Par exemple, cela pourrait ressembler \u00e0 : [screws_tilt_adjust] screw1: -5, 30 screw1_name: front left screw screw2: 155, 30 screw2_name: front right screw screw3: 155, 190 screw3_name: rear right screw screw4: -5, 190 screw4_name: rear left screw horizontal_move_z: 10. speed: 50. screw_thread: CW-M3 La vis1 est toujours le point de r\u00e9f\u00e9rence pour les autres, donc le syst\u00e8me suppose que la vis1 est \u00e0 la bonne hauteur. Ex\u00e9cutez toujours G28 en premier, puis ex\u00e9cutez SCREWS_TILT_CALCULATE - cela devrait produire une sortie similaire \u00e0 : Send: G28 Recv: ok Send: SCREWS_TILT_CALCULATE Recv: // 01:20 means 1 full turn and 20 minutes, CW=clockwise, CCW=counter-clockwise Recv: // front left screw (base) : x=-5.0, y=30.0, z=2.48750 Recv: // front right screw : x=155.0, y=30.0, z=2.36000 : adjust CW 01:15 Recv: // rear right screw : y=155.0, y=190.0, z=2.71500 : adjust CCW 00:50 Recv: // read left screw : x=-5.0, y=190.0, z=2.47250 : adjust CW 00:02 Recv: ok Cela signifie que : la vis avant gauche est le point de r\u00e9f\u00e9rence vous ne devez pas la changer. la vis avant droite doit \u00eatre tourn\u00e9e dans le sens des aiguilles d'une montre d'un tour complet et d'un quart de tour La vis arri\u00e8re droite doit \u00eatre tourn\u00e9e dans le sens inverse des aiguilles d\u2019une montre d'environ 50 minutes la vis arri\u00e8re gauche doit \u00eatre tourn\u00e9e dans le sens des aiguilles d'une montre d'un angle de 2 minutes (pas besoin c'est ok) Notez que \"minutes\" fait r\u00e9f\u00e9rence aux \"minutes d'un cadran d'horloge\". Ainsi, par exemple, 15 minutes correspondent \u00e0 un quart de tour complet. R\u00e9p\u00e9tez le processus plusieurs fois jusqu'\u00e0 ce que vous obteniez un bon niveau de lit - normalement lorsque tous les ajustements sont inf\u00e9rieurs \u00e0 une rotation de 6 minutes des vis de r\u00e9glage. Si vous utilisez une sonde mont\u00e9e sur le c\u00f4t\u00e9 de la hotend (c'est-\u00e0-dire qu'elle a un d\u00e9calage X ou Y), notez que le r\u00e9glage de l'inclinaison du lit rendra caduc l'\u00e9talonnage de sonde pr\u00e9c\u00e9demment effectu\u00e9 avec un lit inclin\u00e9. Assurez-vous d'ex\u00e9cuter \u00e9talonnage de la sonde apr\u00e8s avoir ajust\u00e9 les vis du lit. Le param\u00e8tre MAX_DEVIATION est utile lorsqu'un maillage de lit sauvegard\u00e9 est utilis\u00e9, pour s'assurer que le niveau du lit n'a pas trop d\u00e9riv\u00e9 de l'endroit o\u00f9 il se trouvait lorsque le maillage a \u00e9t\u00e9 cr\u00e9\u00e9. Par exemple, SCREWS_TILT_CALCULATE MAX_DEVIATION=0.01 peut \u00eatre ajout\u00e9 au gcode de d\u00e9marrage personnalis\u00e9 du trancheur avant le chargement du maillage. Il interrompra l'impression si la limite configur\u00e9e est d\u00e9pass\u00e9e (0,01 mm dans cet exemple), donnant \u00e0 l'utilisateur une chance d'ajuster les vis et de red\u00e9marrer l'impression. Le param\u00e8tre DIRECTION est utile si vous ne pouvez tourner les vis de r\u00e9glage de votre lit que dans un seul sens. Par exemple, vous pourriez avoir des vis qui commencent \u00e0 \u00eatre serr\u00e9es dans leur position la plus basse (ou la plus haute) possible, qui ne peuvent \u00eatre tourn\u00e9es que dans une seule direction, pour \u00e9lever (ou abaisser) le lit. Si vous ne pouvez tourner les vis que dans le sens des aiguilles d'une montre, ex\u00e9cutez SCREWS_TILT_CALCULATE DIRECTION=CW . Si vous ne pouvez les tourner que dans le sens antihoraire, ex\u00e9cutez SCREWS_TILT_CALCULATE DIRECTION=CCW . Un point de r\u00e9f\u00e9rence appropri\u00e9 sera choisi de sorte que le lit puisse \u00eatre nivel\u00e9 en tournant toutes les vis dans la direction donn\u00e9e.","title":"R\u00e9glage des vis de mise \u00e0 niveau du lit \u00e0 l'aide de la sonde de lit"},{"location":"Measuring_Resonances.html","text":"Mesurer la r\u00e9sonance \u00b6 Klipper prend en charge l\u2019acc\u00e9l\u00e9rom\u00e8tre ADXL345, utilis\u00e9 pour mesurer les fr\u00e9quences de r\u00e9sonance de l\u2019imprimante sur diff\u00e9rents axes ainsi que le r\u00e9glage automatique des formateurs d'entr\u00e9e ( aka input shapers) pour limiter les r\u00e9sonances. Notez que l\u2019utilisation de l\u2019ADXL345 n\u00e9cessite un peu de soudure et de sertissage. L\u2019ADXL345 peut \u00eatre connect\u00e9 directement \u00e0 un Raspberry Pi, ou \u00e0 une interface SPI d\u2019une carte MCU (qui devra \u00eatre rapide). Lors de l\u2019approvisionnement en ADXL345, sachez qu\u2019il existe une vari\u00e9t\u00e9 de conceptions de cartes PCB diff\u00e9rentes et diff\u00e9rents clones. Assurez-vous que la carte prend en charge le mode SPI (un petit nombre de cartes semble \u00eatre configur\u00e9e en dur pour I2C avec SDO raccord\u00e9 au GND) et, si elle doit \u00eatre connect\u00e9e \u00e0 un microcontr\u00f4leur d\u2019imprimante 5V, qu\u2019elle dispose d\u2019un r\u00e9gulateur de tension et d\u2019un d\u00e9calage de niveau. Instructions d\u2019installation \u00b6 C\u00e2blage \u00b6 Un c\u00e2ble Ethernet \u00e0 paires torsad\u00e9es blind\u00e9es (cat5e ou sup\u00e9rieur) est recommand\u00e9 pour la qualit\u00e9 du signal sur une longue distance. Si vous rencontrez toujours des probl\u00e8mes de qualit\u00e9 du signal (erreurs SPI/I2C), raccourcissez le c\u00e2ble. Connectez le blindage du c\u00e2ble Ethernet \u00e0 la terre de la carte contr\u00f4leur/RPI. V\u00e9rifiez votre c\u00e2blage avant de mettre sous tension pour \u00e9viter d'endommager votre MCU/Raspberry Pi ou l'acc\u00e9l\u00e9rom\u00e8tre ou les deux. Acc\u00e9l\u00e9rom\u00e8tres SPI \u00b6 Suggestions d'utilisation des paires torsad\u00e9es : GND+MISO 3.3V+MOSI SCLK+CS ADXL345 \u00b6 Remarque : de nombreux microcontr\u00f4leurs fonctionnent avec un ADXL345 en mode SPI (par exemple, Pi Pico), le c\u00e2blage et la configuration varient en fonction de votre carte ADXL et des broches disponibles. sur votre MCU Vous devez connecter votre ADXL345 \u00e0 votre Raspberry Pi via SPI. Notez que la connexion I2C, sugg\u00e9r\u00e9e par la documentation ADXL345, poss\u00e8de un d\u00e9bit trop faible et ne fonctionnera pas . Le sch\u00e9ma de connexion recommand\u00e9 : Brochage de l'ADXL345 Brochage du RPI Nom des broches du RPI 3,3 V (ou VCC) 01 Alimentation 3.3v continu GND 06 Terre CS 24 GPIO08 (SPI0_CE0_N) SDO 21 GPIO09 (SPI0_MISO) SDA 19 GPIO10 (SPI0_MOSI) SCL 23 GPIO11 (SPI0_SCLK) Sch\u00e9mas de c\u00e2blage de Fritzing pour certaines des cartes ADXL345 : Acc\u00e9l\u00e9rom\u00e8tres I2C \u00b6 Suggestions d'utilisation des paires torsad\u00e9es : 3.3V+SDA GND+SCL MPU-9250/MPU-9255/MPU-6515/MPU-6050/MPU-6500 \u00b6 Les alternatives \u00e0 l'ADXL345 sont MPU-9250, MPU-9255, MPU-6515, MPU-6050 ou MPU-6500. Ces acc\u00e9l\u00e9rom\u00e8tres ont \u00e9t\u00e9 test\u00e9s pour fonctionner sur I2C avec un RPi ou un RP2040(pico) \u00e0 400kbaud. Sch\u00e9ma de connexion recommand\u00e9 pour I2C sur le Raspberry Pi : brochage du MPU-9250 Brochage du RPI Nom des broches du RPI VCC 01 Alimentation 3.3v continu GND 09 Terre SDA 03 GPIO02 (SDA1) SCL 05 GPIO03 (SCL1) Sch\u00e9ma de connexion recommand\u00e9 pour I2C(i2c0a) connect\u00e9 au RP2040 : brochage du MPU-9250 Broche du RP2040 Nom des broches du RPI VCC 39 3v3 GND 38 Terre SDA 01 GP0 (I2C0 SDA) SCL 02 GP1 (I2C0 SCL) Montage de l\u2019acc\u00e9l\u00e9rom\u00e8tre \u00b6 L\u2019acc\u00e9l\u00e9rom\u00e8tre doit \u00eatre fix\u00e9 sur la t\u00eate d'impression. Il faut concevoir un support appropri\u00e9 et adapt\u00e9 \u00e0 l'imprimante 3D. Il est pr\u00e9f\u00e9rable d\u2019aligner les axes de l\u2019acc\u00e9l\u00e9rom\u00e8tre avec les axes de l\u2019imprimante (mais ce n'est pas obligatoire - c\u2019est-\u00e0-dire pas besoin d\u2019aligner l\u2019axe X avec X et ainsi de suite - cela devrait \u00eatre correct m\u00eame si l\u2019axe Z de l\u2019acc\u00e9l\u00e9rom\u00e8tre est l\u2019axe X de l\u2019imprimante, etc.). Exemple de montage d\u2019ADXL345 sur le SmartEffector : Notez que sur une imprimante cart\u00e9sienne, il faut concevoir 2 supports : un pour la t\u00eate et un pour le lit, et ex\u00e9cuter les mesures deux fois. Voir la section correspondante pour plus de d\u00e9tails. Attention : assurez-vous que l\u2019acc\u00e9l\u00e9rom\u00e8tre et les vis qui le maintiennent en place ne touchent aucune partie m\u00e9tallique de l\u2019imprimante. Fondamentalement, le support doit \u00eatre con\u00e7u de mani\u00e8re \u00e0 assurer l\u2019isolation \u00e9lectrique de l\u2019acc\u00e9l\u00e9rom\u00e8tre du ch\u00e2ssis de l\u2019imprimante. Ne pas s\u2019assurer de cette isolation peut cr\u00e9er une boucle de masse dans le syst\u00e8me conduisant \u00e0 l'endommagement de l\u2019\u00e9lectronique. Installation logicielle \u00b6 Notez que les mesures de r\u00e9sonance et l\u2019auto-\u00e9talonnage de l'input shaper n\u00e9cessitent des d\u00e9pendances logicielles suppl\u00e9mentaires non install\u00e9es par d\u00e9faut. Tout d\u2019abord, ex\u00e9cutez sur votre Raspberry Pi les commandes suivantes\u202f: sudo apt update sudo apt install python3-numpy python3-matplotlib libatlas-base-dev Ensuite, pour installer NumPy dans l\u2019environnement Klipper, ex\u00e9cutez la commande\u202f: ~/klippy-env/bin/pip install -v numpy Selon les performances du processeur, cette op\u00e9ration peut prendre jusqu\u2019\u00e0 20 minutes. Soyez patient et attendez la fin de l\u2019installation. Dans certains cas, si la carte a trop peu de m\u00e9moire, l\u2019installation peut \u00e9chouer et vous devrez activer le fichier d\u2019\u00e9change. V\u00e9rifiez et suivez les instructions dans le document du Microcontr\u00f4leur RPi pour configurer le \u00ab mcu linux \u00bb sur le Raspberry Pi. Configurer l'ADXL345 avec le RPi \u00b6 Assurez-vous que le pilote SPI Linux est activ\u00e9 en ex\u00e9cutant sudo raspi-config et en activant SPI dans le menu \u00ab Options d\u2019interface \u00bb. Ajoutez les lignes suivantes au fichier printer.cfg : [mcu rpi] serial: /tmp/klipper_host_mcu [adxl345] cs_pin: rpi:None [resonance_tester] accel_chip: adxl345 probe_points: 100, 100, 20 # valeur exemple Il est conseill\u00e9 de commencer par 1 point de test, au milieu du lit d\u2019impression, l\u00e9g\u00e8rement au-dessus. Configurer les s\u00e9ries MPU-6000/9000 avec le RPi \u00b6 Assurez-vous que le pilote Linux I2C est activ\u00e9 et que le d\u00e9bit en bauds est d\u00e9fini sur 400 000 (voir la section Activation d'I2C pour plus de d\u00e9tails). Ensuite, ajoutez ce qui suit au fichier printer.cfg : [mcu rpi] serial: /tmp/klipper_host_mcu [mpu9250] i2c_mcu: rpi i2c_bus: i2c.1 [resonance_tester] accel_chip: mpu9250 probe_points: 100, 100, 20 # valeurs exemple Configurer les s\u00e9ries MPU-6000/9000 avec le PICO \u00b6 Sur le PICO I2C est r\u00e9gl\u00e9 sur 400000 par d\u00e9faut. Ajoutez simplement ce qui suit au fichier printer.cfg : [mcu pico] serial\u202f: /dev/serial/by-id/<le serial id du PICO> [mpu9250] i2c_mcu\u202f: pico i2c_bus\u202f: i2c1a [resonance_tester] accel_chip\u202f: mpu9250 probe_points\u202f: 100, 100, 20 # un exemple [static_digital_output pico_3V3pwm] # Am\u00e9lioration de la stabilit\u00e9 de l'alimentation pin\u202f: pico\u202f:gpio23 Red\u00e9marrez Klipper avec la commande RESTART . Mesurer les r\u00e9sonances \u00b6 V\u00e9rification de la configuration \u00b6 Vous pouvez maintenant tester la connexion. Pour les imprimantes non cart\u00e9siennes (celles avec une seul acc\u00e9l\u00e9rom\u00e8tre), dans Octoprint, entrez ACCELEROMETER_QUERY Pour les imprimante cart\u00e9siennes (plus d\u2019un acc\u00e9l\u00e9rom\u00e8tre), entrez ACCELEROMETER_QUERY CHIP=<chip> o\u00f9 <chip> est le nom de la puce tel qu\u2019il a \u00e9t\u00e9 entr\u00e9, par exemple CHIP=bed (voir\u202f: bed-slinger ) faites-le pour tous les acc\u00e9l\u00e9rom\u00e8tre install\u00e9s. Vous devriez voir les mesures actuelles de l\u2019acc\u00e9l\u00e9rom\u00e8tre, y compris l\u2019acc\u00e9l\u00e9ration en chute libre. Recv: // adxl345 values (x, y, z)\u202f: 470.719200, 941.438400, 9728.196800 Si vous obtenez une erreur comme Invalid adxl345 id (got xx vs e5) , o\u00f9 xx est un autre ID, cela indique un probl\u00e8me de connexion avec l'ADXL345, ou un capteur d\u00e9fectueux. V\u00e9rifiez l\u2019alimentation, le c\u00e2blage (correspondance avec les sch\u00e9mas, aucun fil coup\u00e9 ou desserr\u00e9, etc.) et la qualit\u00e9 des soudures. Si vous utilisez un acc\u00e9l\u00e9rom\u00e8tre de la s\u00e9rie MPU-6000/9000 et qu'il s'affiche comme \"mpu-unknown\", utilisez-le avec prudence ! Ce sont probablement des puces reconditionn\u00e9es ! Ensuite, essayez d\u2019ex\u00e9cuter MEASURE_AXES_NOISE dans Octoprint, vous devriez obtenir des chiffres de base pour le bruit de fond de l\u2019acc\u00e9l\u00e9rom\u00e8tre sur les axes (devraient se situer entre 1 et 100). Un bruit de fond d\u2019axe trop \u00e9lev\u00e9 (par exemple 1000 et plus) peut indiquer des probl\u00e8mes de capteur, des probl\u00e8mes de puissance ou des ventilateurs d\u00e9s\u00e9quilibr\u00e9s entrainant trop de vibrations sur l'imprimante 3D. Mesurer les r\u00e9sonances \u00b6 Vous pouvez maintenant ex\u00e9cuter les tests r\u00e9els. Ex\u00e9cutez la commande suivante : TEST_RESONANCES AXIS=X Notez que cela cr\u00e9era des vibrations sur l\u2019axe X. Ce test d\u00e9sactivera les valeurs du formateur d'entr\u00e9e (aka input shapper) d\u00e9j\u00e0 param\u00e9tr\u00e9es. Le test de r\u00e9sonance ne peut pas \u00eatre fait avec le formateur d'entr\u00e9e d\u00e9j\u00e0 activ\u00e9. Attention\u202f! Gardez un \u0153il sur l\u2019imprimante la premi\u00e8re fois, pour vous assurer que les vibrations ne deviennent pas trop violentes (la commande M112 peut \u00eatre utilis\u00e9e pour interrompre le test en cas d\u2019urgence - en esp\u00e9rant ne pas avoir \u00e0 l'utiliser). Si les vibrations deviennent trop fortes, vous pouvez sp\u00e9cifier une valeur inf\u00e9rieure \u00e0 la valeur par d\u00e9faut du param\u00e8tre accel_per_hz dans la section [resonance_tester] . [resonance_tester] accel_chip: adxl345 accel_per_hz: 50 # default is 75 probe_points: ... Si cela fonctionne pour l\u2019axe X, ex\u00e9cutez ensuite la commande pour l\u2019axe Y : TEST_RESONANCES AXIS=Y Cela g\u00e9n\u00e9rera 2 fichiers CSV ( /tmp/resonances_x_*.csv et /tmp/resonances_y_*.csv ). Ces fichiers peuvent \u00eatre trait\u00e9s avec le script autonome sur un Raspberry Pi. Pour ce faire, ex\u00e9cutez les commandes suivantes : ~/klipper/scripts/calibrate_shaper.py /tmp/resonances_x_*.csv -o /tmp/shaper_calibrate_x.png ~/klipper/scripts/calibrate_shaper.py /tmp/resonances_y_*.csv -o /tmp/shaper_calibrate_y.png Ce script g\u00e9n\u00e9rera les graphiques /tmp/shaper_calibrate_x.png et /tmp/shaper_calibrate_y.png avec les r\u00e9ponses en fr\u00e9quence. Vous obtiendrez \u00e9galement les fr\u00e9quences sugg\u00e9r\u00e9es pour chaque mode du formateur d'entr\u00e9e (input shapper), ainsi que la valeur recommand\u00e9e pour votre configuration. Par exemple : Fitted shaper 'zv' frequency = 34.4 Hz (vibrations = 4.0%, smoothing ~= 0.132) To avoid too much smoothing with 'zv', suggested max_accel <= 4500 mm/sec^2 Fitted shaper 'mzv' frequency = 34.6 Hz (vibrations = 0.0%, smoothing ~= 0.170) To avoid too much smoothing with 'mzv', suggested max_accel <= 3500 mm/sec^2 Fitted shaper 'ei' frequency = 41.4 Hz (vibrations = 0.0%, smoothing ~= 0.188) To avoid too much smoothing with 'ei', suggested max_accel <= 3200 mm/sec^2 Fitted shaper '2hump_ei' frequency = 51.8 Hz (vibrations = 0.0%, smoothing ~= 0.201) To avoid too much smoothing with '2hump_ei', suggested max_accel <= 3000 mm/sec^2 Fitted shaper '3hump_ei' frequency = 61.8 Hz (vibrations = 0.0%, smoothing ~= 0.215) To avoid too much smoothing with '3hump_ei', suggested max_accel <= 2800 mm/sec^2 Recommended shaper is mzv @ 34.6 Hz La configuration sugg\u00e9r\u00e9e peut \u00eatre ajout\u00e9e \u00e0 la section [input_shaper] de printer.cfg , par exemple : [input_shaper] shaper_freq_x: ... shaper_type_x: ... shaper_freq_y: 34.6 shaper_type_y: mzv [printer] max_accel: 3000 # Ne devrait pas d\u00e9passer les valeurs estim\u00e9es d'acc\u00e9l\u00e9ration calcul\u00e9es pour les axes X et Y Ou vous pouvez choisir vous-m\u00eame une autre configuration en fonction des graphiques g\u00e9n\u00e9r\u00e9s\u202f: les pics de densit\u00e9 spectrale de puissance sur les graphiques correspondent aux fr\u00e9quences de r\u00e9sonance de l\u2019imprimante. Notez que vous pouvez \u00e9galement ex\u00e9cuter l\u2019auto-\u00e9talonnage du formateur d'entr\u00e9e (input shapper) \u00e0 partir de Klipper directement , pratique, par exemple, pour la recalibration du formateur d'entr\u00e9e. Imprimantes cart\u00e9siennes \u00e0 lit mobile \u00b6 Si votre imprimante est une imprimante cart\u00e9sienne dont le plateau est mobile sur l'axe Y, vous devrez changer l\u2019emplacement de l\u2019acc\u00e9l\u00e9rom\u00e8tre entre les mesures des axes X et Y : mesurez les r\u00e9sonances de l\u2019axe X avec l\u2019acc\u00e9l\u00e9rom\u00e8tre fix\u00e9 \u00e0 la t\u00eate et les r\u00e9sonances de l\u2019axe Y - au lit (la configuration habituelle des imprimantes cart\u00e9siennes). Cependant, vous pouvez \u00e9galement connecter les deux acc\u00e9l\u00e9rom\u00e8tres simultan\u00e9ment, bien qu'ils doivent \u00eatre connect\u00e9s \u00e0 des cartes diff\u00e9rentes (par exemple, \u00e0 une carte RPi et au MCU de l'imprimante), ou \u00e0 deux interfaces SPI physiques diff\u00e9rentes sur la m\u00eame carte (rarement disponibles). Ensuite, ils peuvent \u00eatre configur\u00e9s de la mani\u00e8re suivante : [adxl345 hotend] # En consid\u00e9rant que l'adxl de la t\u00eate connect\u00e9e au RPI cs_pin: rpi:None [adxl345 bed] # En consid\u00e9rant que l'adxl du lit est connect\u00e9 au MCU cs_pin: ... # Printer board SPI chip select (CS) pin [resonance_tester] # En consid\u00e9rant un montage standard pour une imprimante cart\u00e9sienne accel_chip_x: adxl345 hotend accel_chip_y: adxl345 bed probe_points: ... Ensuite, les commandes TEST_RESONANCES AXIS=X et TEST_RESONANCES AXIS=Y utiliseront le bon acc\u00e9l\u00e9rom\u00e8tre pour chaque axe. Lissage maximum \u00b6 Gardez \u00e0 l'esprit que le formateur d'entr\u00e9e (input shapper) peut cr\u00e9er un lissage sur certaines parties de l'impression. Le r\u00e9glage automatique du formateur d'entr\u00e9e effectu\u00e9 par le script calibrate_shaper.py ou la commande SHAPER_CALIBRATE essaie de limiter le lissage, mais il essaie aussi de minimiser les vibrations r\u00e9sultantes. Cela peut conduire parfois, \u00e0 un choix peu optimis\u00e9 de la fr\u00e9quence du formateur d'entr\u00e9e ou peut-\u00eatre pr\u00e9f\u00e9rez-vous simplement avoir moins de lissage dans certaines parties de l'impression au d\u00e9triment des vibrations restantes. Dans ces cas, vous pouvez demander de limiter le lissage maximal \u00e0 partir du formateur d'entr\u00e9e. Regardons les r\u00e9sultats suivants du r\u00e9glage automatique : Fitted shaper 'zv' frequency = 57.8 Hz (vibrations = 20.3%, smoothing ~= 0.053) To avoid too much smoothing with 'zv', suggested max_accel <= 13000 mm/sec^2 Fitted shaper 'mzv' frequency = 34.8 Hz (vibrations = 3.6%, smoothing ~= 0.168) To avoid too much smoothing with 'mzv', suggested max_accel <= 3600 mm/sec^2 Fitted shaper 'ei' frequency = 48.8 Hz (vibrations = 4.9%, smoothing ~= 0.135) To avoid too much smoothing with 'ei', suggested max_accel <= 4400 mm/sec^2 Fitted shaper '2hump_ei' frequency = 45.2 Hz (vibrations = 0.1%, smoothing ~= 0.264) To avoid too much smoothing with '2hump_ei', suggested max_accel <= 2200 mm/sec^2 Fitted shaper '3hump_ei' frequency = 48.0 Hz (vibrations = 0.0%, smoothing ~= 0.356) To avoid too much smoothing with '3hump_ei', suggested max_accel <= 1500 mm/sec^2 Recommended shaper is 2hump_ei @ 45.2 Hz Notez que les valeurs rapport\u00e9es smoothing sont des valeurs projet\u00e9es abstraites. Ces valeurs peuvent \u00eatre utilis\u00e9es pour comparer diff\u00e9rentes configurations : plus la valeur est \u00e9lev\u00e9e, plus le formateur d'entr\u00e9e cr\u00e9era de lissage. Cependant, ces scores de lissage ne repr\u00e9sentent aucune mesure r\u00e9elle du lissage, car le lissage r\u00e9el d\u00e9pend des param\u00e8tres max_accel et square_corner_velocity . Par cons\u00e9quent, vous devrez faire des impressions de test pour voir exactement le lissage cr\u00e9\u00e9 par la configuration choisie. Dans l'exemple ci-dessus, les param\u00e8tres de mise en forme sugg\u00e9r\u00e9s ne sont pas mauvais, mais que se passe-t-il si vous souhaitez obtenir moins de lissage sur l'axe X ? Vous pouvez essayer de limiter le lissage maximal du formateur d'entr\u00e9e \u00e0 l'aide de la commande suivante : ~/klipper/scripts/calibrate_shaper.py /tmp/resonances_x_*.csv -o /tmp/shaper_calibrate_x.png --max_smoothing=0.2 ce qui limite le lissage \u00e0 un score de 0,2. Vous pouvez maintenant obtenir le r\u00e9sultat suivant : Fitted shaper 'zv' frequency = 55.4 Hz (vibrations = 19.7%, smoothing ~= 0.057) To avoid too much smoothing with 'zv', suggested max_accel <= 12000 mm/sec^2 Fitted shaper 'mzv' frequency = 34.6 Hz (vibrations = 3.6%, smoothing ~= 0.170) To avoid too much smoothing with 'mzv', suggested max_accel <= 3500 mm/sec^2 Fitted shaper 'ei' frequency = 48.2 Hz (vibrations = 4.8%, smoothing ~= 0.139) To avoid too much smoothing with 'ei', suggested max_accel <= 4300 mm/sec^2 Fitted shaper '2hump_ei' frequency = 52.0 Hz (vibrations = 2.7%, smoothing ~= 0.200) To avoid too much smoothing with '2hump_ei', suggested max_accel <= 3000 mm/sec^2 Fitted shaper '3hump_ei' frequency = 72.6 Hz (vibrations = 1.4%, smoothing ~= 0.155) To avoid too much smoothing with '3hump_ei', suggested max_accel <= 3900 mm/sec^2 Recommended shaper is 3hump_ei @ 72.6 Hz Si vous comparez avec les pr\u00e9c\u00e9dents param\u00e8tres sugg\u00e9r\u00e9s, les vibrations sont un peu plus importantes, mais le lissage est nettement plus faible qu'auparavant, ce qui permet une acc\u00e9l\u00e9ration maximale plus importante. Lorsque vous choisissez le param\u00e8tre max_smoothing , vous pouvez utiliser une approche par essais et erreurs. Essayez quelques valeurs diff\u00e9rentes et voyez quels r\u00e9sultats vous obtenez. Notez que le lissage r\u00e9el produit par le formateur d'entr\u00e9e d\u00e9pend principalement de la fr\u00e9quence de r\u00e9sonance la plus basse de l'imprimante : plus la fr\u00e9quence de r\u00e9sonance la plus basse est \u00e9lev\u00e9e, plus le lissage est faible. Par cons\u00e9quent, si vous demandez au script de trouver une configuration du formateur d'entr\u00e9e avec un lissage irr\u00e9aliste, cela se fera au d\u00e9triment d'une r\u00e9sonance accrue aux fr\u00e9quences les plus basses (g\u00e9n\u00e9ralement, les plus visibles dans les impressions). V\u00e9rifiez donc toujours les vibrations restantes projet\u00e9es signal\u00e9es par le script et assurez-vous qu'elles ne sont pas trop \u00e9lev\u00e9es. Notez que si vous avez trouv\u00e9 une bonne valeur de max_smoothing pour vos deux axes, vous pouvez la stocker dans printer.cfg comme [resonance_tester] accel_chip: ... probe_points: ... max_smoothing: 0.25 # valeur exemple Ensuite, si vous r\u00e9ex\u00e9cutez le r\u00e9glage automatique du formateur d'entr\u00e9e \u00e0 l'aide de la commande SHAPER_CALIBRATE , c'est cette valeur stock\u00e9e max_smoothing qui sera prise comme r\u00e9f\u00e9rence. S\u00e9lection de max_accel \u00b6 \u00c9tant donn\u00e9 que le formateur d'entr\u00e9e peut cr\u00e9er un certain lissage dans les pi\u00e8ces, en particulier avec des acc\u00e9l\u00e9rations \u00e9lev\u00e9es, vous devrez toujours choisir une valeur max_accel ne cr\u00e9ant pas trop de lissage dans les pi\u00e8ces imprim\u00e9es. Un script d'\u00e9talonnage fournit une estimation du param\u00e8tre max_accel qui ne devrait pas cr\u00e9er trop de lissage. Notez que le max_accel tel qu'affich\u00e9 par le script de calibrage n'est qu'un maximum th\u00e9orique auquel le formateur d'entr\u00e9e est encore capable de travailler sans produire trop de lissage. Il ne s'agit en aucun cas d'une recommandation pour d\u00e9finir cette acc\u00e9l\u00e9ration sur vos impressions. L'acc\u00e9l\u00e9ration maximale support\u00e9e par votre imprimante d\u00e9pend de ses propri\u00e9t\u00e9s m\u00e9caniques et du couple maximal des moteurs pas \u00e0 pas utilis\u00e9s. Par cons\u00e9quent, il est sugg\u00e9r\u00e9 de d\u00e9finir un max_accel dans la section [printer] qui ne d\u00e9passe pas les valeurs estim\u00e9es pour les axes X et Y, probablement avec une marge de s\u00e9curit\u00e9. Vous pouvez \u00e9galement suivre cette partie du guide de r\u00e9glage du formateur d'entr\u00e9e et imprimer un mod\u00e8le de test pour choisir le param\u00e8tre max_accel de mani\u00e8re exp\u00e9rimentale. M\u00eame remarque pour l' auto-calibration du formateur d'entr\u00e9e avec la commande SHAPER_CALIBRATE : il faut encore choisir la bonne valeur max_accel apr\u00e8s l'auto-calibrage, notez que les limites d'acc\u00e9l\u00e9rations sugg\u00e9r\u00e9es ne sont pas appliqu\u00e9es automatiquement. Si vous effectuez un r\u00e9-\u00e9talonnage du formateur d'entr\u00e9e et que le lissage indiqu\u00e9 pour la configuration de formateur sugg\u00e9r\u00e9e est pratiquement le m\u00eame que celui obtenu lors du calibrage pr\u00e9c\u00e9dent, cette \u00e9tape peut \u00eatre ignor\u00e9e. Test des axes personnalis\u00e9s \u00b6 la commande TEST_RESONANCES prend en charge les axes personnalis\u00e9s. Bien que cela ne soit pas vraiment utile pour l\u2019\u00e9talonnage des input shaper, cela peut \u00eatre utilis\u00e9 pour \u00e9tudier en profondeur les r\u00e9sonances de l\u2019imprimante et v\u00e9rifier, par exemple, la tension de la courroie. Pour v\u00e9rifier la tension de la courroie sur les imprimantes CoreXY, ex\u00e9cutez TEST_RESONANCES AXIS=1,1 OUTPUT=raw_data TEST_RESONANCES AXIS=1,-1 OUTPUT=raw_data et utilisez graph_accelerometer.py pour traiter les fichiers g\u00e9n\u00e9r\u00e9s. ~/klipper/scripts/graph_accelerometer.py -c /tmp/raw_data_axis*.csv -o /tmp/resonances.png qui g\u00e9n\u00e9rera /tmp/r\u00e9sonances.png en comparant les r\u00e9sonances. Pour les imprimantes Delta avec le placement des tours par d\u00e9faut (tour A ~= 210 degr\u00e9s, B ~= 330 degr\u00e9s et C ~= 90 degr\u00e9s), ex\u00e9cutez TEST_RESONANCES AXIS=0,1 OUTPUT=raw_data TEST_RESONANCES AXIS=-0.866025404,-0.5 OUTPUT=raw_data TEST_RESONANCES AXIS=0.866025404,-0.5 OUTPUT=raw_data puis utilisez la m\u00eame commande ~/klipper/scripts/graph_accelerometer.py -c /tmp/raw_data_axis*.csv -o /tmp/resonances.png pour g\u00e9n\u00e9rer le fichier de comparaison des r\u00e9sonnances /tmp/r\u00e9sonances.png . Calibrage automatique du formateur d'entr\u00e9e \u00b6 En plus de choisir manuellement les param\u00e8tres appropri\u00e9s pour la fonction de formateur d'entr\u00e9e, il est \u00e9galement possible d'ex\u00e9cuter le r\u00e9glage automatique du formateur d'entr\u00e9e directement \u00e0 partir de Klipper. Ex\u00e9cutez la commande suivante via le terminal Octoprint : SHAPER_CALIBRATE Cela ex\u00e9cutera le test complet pour les deux axes et g\u00e9n\u00e9rera la sortie csv ( /tmp/calibration_data_*.csv par d\u00e9faut) pour la r\u00e9ponse en fr\u00e9quence et les formateurs d'entr\u00e9e sugg\u00e9r\u00e9s. Vous obtiendrez \u00e9galement les fr\u00e9quences sugg\u00e9r\u00e9es pour chaque formateur, ainsi que le mod\u00e8le de formateur d'entr\u00e9e recommand\u00e9 pour votre configuration, sur la console Octoprint. Par exemple\u202f: Calculating the best input shaper parameters for y axis Fitted shaper 'zv' frequency = 39.0 Hz (vibrations = 13.2%, smoothing ~= 0.105) To avoid too much smoothing with 'zv', suggested max_accel <= 5900 mm/sec^2 Fitted shaper 'mzv' frequency = 36.8 Hz (vibrations = 1.7%, smoothing ~= 0.150) To avoid too much smoothing with 'mzv', suggested max_accel <= 4000 mm/sec^2 Fitted shaper 'ei' frequency = 36.6 Hz (vibrations = 2.2%, smoothing ~= 0.240) To avoid too much smoothing with 'ei', suggested max_accel <= 2500 mm/sec^2 Fitted shaper '2hump_ei' frequency = 48.0 Hz (vibrations = 0.0%, smoothing ~= 0.234) To avoid too much smoothing with '2hump_ei', suggested max_accel <= 2500 mm/sec^2 Fitted shaper '3hump_ei' frequency = 59.0 Hz (vibrations = 0.0%, smoothing ~= 0.235) To avoid too much smoothing with '3hump_ei', suggested max_accel <= 2500 mm/sec^2 Recommended shaper_type_y = mzv, shaper_freq_y = 36.8 Hz Si vous \u00eates d'accord avec les param\u00e8tres sugg\u00e9r\u00e9s, vous pouvez ex\u00e9cuter SAVE_CONFIG maintenant pour les enregistrer et red\u00e9marrer Klipper. Notez que cela ne mettra pas \u00e0 jour la valeur max_accel dans la section [printer] . Vous devrez la mettre \u00e0 jour manuellement en suivant les recommandations de la section Choisir l'acc\u00e9l\u00e9ration maximale . Si votre imprimante est une imprimante cart\u00e9sienne, vous pouvez pr\u00e9ciser l'axe \u00e0 tester, afin de pouvoir modifier le point de montage de l'acc\u00e9l\u00e9rom\u00e8tre entre les tests (par d\u00e9faut, le test est effectu\u00e9 pour les deux axes) : SHAPER_CALIBRATE AXIS=Y Vous pouvez ex\u00e9cuter SAVE_CONFIG deux fois - apr\u00e8s avoir calibr\u00e9 chaque axe. Cependant, si vous avez connect\u00e9 deux acc\u00e9l\u00e9rom\u00e8tres simultan\u00e9ment, vous pouvez ex\u00e9cutez simplement SHAPER_CALIBRATE sans sp\u00e9cifier d'axe pour calibrer les formateurs d'entr\u00e9e des deux axes en une seule fois. R\u00e9-\u00e9talonnage du formateur d'entr\u00e9e (aka input shapper) \u00b6 La commande SHAPER_CALIBRATE peut \u00e9galement \u00eatre utilis\u00e9e pour recalibrer le formateur d'entr\u00e9e ult\u00e9rieurement, en particulier si des modifications de l'imprimante pouvant affecter sa cin\u00e9matique sont apport\u00e9es. On peut soit relancer l'\u00e9talonnage complet \u00e0 l'aide de la commande SHAPER_CALIBRATE , soit restreindre l'auto-\u00e9talonnage \u00e0 un seul axe en fournissant le param\u00e8tre AXIS= , comme SHAPER_CALIBRATE AXIS=X Attention ! Il est d\u00e9conseill\u00e9 d'ex\u00e9cuter l'autocalibrage de l'input shaper tr\u00e8s fr\u00e9quemment (par exemple, avant chaque impression ou tous les jours). Afin de d\u00e9terminer les fr\u00e9quences de r\u00e9sonance, l'autocalibrage cr\u00e9e des vibrations intenses sur chacun des axes. Les imprimantes 3D ne sont pas con\u00e7ues pour r\u00e9sister \u00e0 une exposition prolong\u00e9e \u00e0 des vibrations proches des fr\u00e9quences de r\u00e9sonance. Cela pourrait augmenter l'usure des composants de l'imprimante et r\u00e9duire leur dur\u00e9e de vie. Il existe \u00e9galement un risque accru que certaines pi\u00e8ces se d\u00e9vissent ou se desserrent. V\u00e9rifiez toujours que toutes les pi\u00e8ces de l'imprimante (y compris celles qui ne peuvent normalement pas bouger) sont solidement fix\u00e9es en place apr\u00e8s chaque r\u00e9glage automatique. De plus, en raison d'un certain bruit dans les mesures, il est possible que les r\u00e9sultats de r\u00e9glage soient l\u00e9g\u00e8rement diff\u00e9rents d'un calibrage \u00e0 l'autre. Ce bruit ne devrait pas trop affecter la qualit\u00e9 d'impression. Cependant, il est conseill\u00e9 de rev\u00e9rifier les param\u00e8tres sugg\u00e9r\u00e9s et d'imprimer des tests d'impression avant de les utiliser pour confirmer qu'ils sont corrects. Traitement hors ligne des donn\u00e9es de l\u2019acc\u00e9l\u00e9rom\u00e8tre \u00b6 Il est possible de g\u00e9n\u00e9rer les donn\u00e9es brutes de l\u2019acc\u00e9l\u00e9rom\u00e8tre et de les traiter hors ligne (par exemple sur une machine h\u00f4te), par exemple pour trouver des r\u00e9sonances. Pour ce faire, ex\u00e9cutez les commandes suivantes via le terminal Octoprint : SET_INPUT_SHAPER SHAPER_FREQ_X=0 SHAPER_FREQ_Y=0 TEST_RESONANCES AXIS=X OUTPUT=raw_data ignorez toute erreur pour la commande SET_INPUT_SHAPER . Pour la commande TEST_RESONANCES , sp\u00e9cifiez l\u2019axe de test souhait\u00e9. Les donn\u00e9es brutes seront \u00e9crites dans le r\u00e9pertoire /tmp sur le RPi. Les donn\u00e9es brutes peuvent \u00e9galement \u00eatre obtenues en ex\u00e9cutant la commande ACCELEROMETER_MEASURE deux fois - d\u2019abord pour d\u00e9marrer les mesures, puis pour les arr\u00eater et \u00e9crire le fichier de sortie. Reportez-vous \u00e0 G-Codes pour plus de d\u00e9tails. Les donn\u00e9es peuvent \u00eatre trait\u00e9es ult\u00e9rieurement avec les scripts suivants : scripts/graph_accelerometer.py et scripts/calibrate_shaper.py . Les deux acceptent un ou plusieurs fichiers csv bruts comme entr\u00e9e en fonction du mode. Le script graph_accelerometer.py prend en charge plusieurs modes de fonctionnement : pour le tra\u00e7age des donn\u00e9es brutes de l\u2019acc\u00e9l\u00e9rom\u00e8tre (utilisez le param\u00e8tre -r ), seule 1 entr\u00e9e est prise en charge\u202f; tracer une r\u00e9ponse en fr\u00e9quence (aucun param\u00e8tre suppl\u00e9mentaire n'est requis), si plusieurs entr\u00e9es sont sp\u00e9cifi\u00e9es, la r\u00e9ponse en fr\u00e9quence moyenne est calcul\u00e9e ; comparaison de la r\u00e9ponse en fr\u00e9quence entre plusieurs entr\u00e9es (utiliser le param\u00e8tre -c ) ; vous pouvez \u00e9galement sp\u00e9cifier l\u2019axe de l\u2019acc\u00e9l\u00e9rom\u00e8tre \u00e0 prendre en compte via le param\u00e8tre -a x , -a y ou -a z (si aucun n\u2019est sp\u00e9cifi\u00e9, la somme des vibrations pour tous les axes est utilis\u00e9e) ; tra\u00e7age du spectrogramme (utiliser le param\u00e8tre -s ), seule 1 entr\u00e9e est prise en charge\u202f; vous pouvez \u00e9galement sp\u00e9cifier l\u2019axe de l\u2019acc\u00e9l\u00e9rom\u00e8tre \u00e0 prendre en compte via le param\u00e8tre -a x , -a y ou -a z (si aucun n\u2019est sp\u00e9cifi\u00e9, la somme des vibrations pour tous les axes est utilis\u00e9e). Notez que graph_accelerometer.py script ne prend en charge que les fichiers raw_data*.csv et non les fichiers resonances*.csv ou calibration_data*.csv. Par exemple, ~/klipper/scripts/graph_accelerometer.py /tmp/raw_data_x_*.csv -o /tmp/resonances_x.png -c -a z tracera la comparaison de plusieurs fichiers /tmp/raw_data_x_*.csv pour l\u2019axe Z dans le fichier /tmp/resonances_x.png . Le script shaper_calibrate.py accepte 1 ou plusieurs entr\u00e9es et peut ex\u00e9cuter le r\u00e9glage automatique de l'input shaper et sugg\u00e9rer les meilleurs param\u00e8tres pour les entr\u00e9es fournies. Il affiche les param\u00e8tres sugg\u00e9r\u00e9s sur la console et peut en outre g\u00e9n\u00e9rer un graphique si le param\u00e8tre -o output.png est fourni, ou un fichier CSV si le param\u00e8tre -c output.csv est sp\u00e9cifi\u00e9. Fournir plusieurs entr\u00e9es \u00e0 shaper_calibrate.py script peut \u00eatre utile si vous ex\u00e9cutez un r\u00e9glage avanc\u00e9 de l'input shaper, par exemple : Ex\u00e9cutez TEST_RESONANCES AXIS=X OUTPUT=raw_data (et Y axe) pour un seul axe deux fois sur une imprimante cart\u00e9sienne avec l\u2019acc\u00e9l\u00e9rom\u00e8tre fix\u00e9 \u00e0 la t\u00eate d\u2019outil la premi\u00e8re fois, et l\u2019acc\u00e9l\u00e9rom\u00e8tre fix\u00e9 au lit la deuxi\u00e8me fois afin de d\u00e9tecter les r\u00e9sonances crois\u00e9es des axes et de tenter de les annuler avec l'input shaper. Ex\u00e9cutez TEST_RESONANCES AXIS=Y OUTPUT=raw_data deux fois sur le lit avec un lit en verre et une surface magn\u00e9tique (plus l\u00e9g\u00e8re) pour trouver les param\u00e8tres d'input shaper qui fonctionnent bien pour n\u2019importe quelle configuration de surface d\u2019impression. Combinaison des donn\u00e9es de r\u00e9sonance de plusieurs points de test. Combinaison des donn\u00e9es de r\u00e9sonance \u00e0 partir de 2 axes (par exemple, sur une imprimante cart\u00e9sienne pour configurer les input_shaper de l\u2019axe X \u00e0 partir des r\u00e9sonances des axes X et Y pour annuler les vibrations du lit * * au cas o\u00f9 la buse \u00ab attraperait \u00bb une impression lors du d\u00e9placement dans la direction de l\u2019axe X).","title":"Mesurer la r\u00e9sonance"},{"location":"Measuring_Resonances.html#mesurer-la-resonance","text":"Klipper prend en charge l\u2019acc\u00e9l\u00e9rom\u00e8tre ADXL345, utilis\u00e9 pour mesurer les fr\u00e9quences de r\u00e9sonance de l\u2019imprimante sur diff\u00e9rents axes ainsi que le r\u00e9glage automatique des formateurs d'entr\u00e9e ( aka input shapers) pour limiter les r\u00e9sonances. Notez que l\u2019utilisation de l\u2019ADXL345 n\u00e9cessite un peu de soudure et de sertissage. L\u2019ADXL345 peut \u00eatre connect\u00e9 directement \u00e0 un Raspberry Pi, ou \u00e0 une interface SPI d\u2019une carte MCU (qui devra \u00eatre rapide). Lors de l\u2019approvisionnement en ADXL345, sachez qu\u2019il existe une vari\u00e9t\u00e9 de conceptions de cartes PCB diff\u00e9rentes et diff\u00e9rents clones. Assurez-vous que la carte prend en charge le mode SPI (un petit nombre de cartes semble \u00eatre configur\u00e9e en dur pour I2C avec SDO raccord\u00e9 au GND) et, si elle doit \u00eatre connect\u00e9e \u00e0 un microcontr\u00f4leur d\u2019imprimante 5V, qu\u2019elle dispose d\u2019un r\u00e9gulateur de tension et d\u2019un d\u00e9calage de niveau.","title":"Mesurer la r\u00e9sonance"},{"location":"Measuring_Resonances.html#instructions-dinstallation","text":"","title":"Instructions d\u2019installation"},{"location":"Measuring_Resonances.html#cablage","text":"Un c\u00e2ble Ethernet \u00e0 paires torsad\u00e9es blind\u00e9es (cat5e ou sup\u00e9rieur) est recommand\u00e9 pour la qualit\u00e9 du signal sur une longue distance. Si vous rencontrez toujours des probl\u00e8mes de qualit\u00e9 du signal (erreurs SPI/I2C), raccourcissez le c\u00e2ble. Connectez le blindage du c\u00e2ble Ethernet \u00e0 la terre de la carte contr\u00f4leur/RPI. V\u00e9rifiez votre c\u00e2blage avant de mettre sous tension pour \u00e9viter d'endommager votre MCU/Raspberry Pi ou l'acc\u00e9l\u00e9rom\u00e8tre ou les deux.","title":"C\u00e2blage"},{"location":"Measuring_Resonances.html#accelerometres-spi","text":"Suggestions d'utilisation des paires torsad\u00e9es : GND+MISO 3.3V+MOSI SCLK+CS","title":"Acc\u00e9l\u00e9rom\u00e8tres SPI"},{"location":"Measuring_Resonances.html#adxl345","text":"Remarque : de nombreux microcontr\u00f4leurs fonctionnent avec un ADXL345 en mode SPI (par exemple, Pi Pico), le c\u00e2blage et la configuration varient en fonction de votre carte ADXL et des broches disponibles. sur votre MCU Vous devez connecter votre ADXL345 \u00e0 votre Raspberry Pi via SPI. Notez que la connexion I2C, sugg\u00e9r\u00e9e par la documentation ADXL345, poss\u00e8de un d\u00e9bit trop faible et ne fonctionnera pas . Le sch\u00e9ma de connexion recommand\u00e9 : Brochage de l'ADXL345 Brochage du RPI Nom des broches du RPI 3,3 V (ou VCC) 01 Alimentation 3.3v continu GND 06 Terre CS 24 GPIO08 (SPI0_CE0_N) SDO 21 GPIO09 (SPI0_MISO) SDA 19 GPIO10 (SPI0_MOSI) SCL 23 GPIO11 (SPI0_SCLK) Sch\u00e9mas de c\u00e2blage de Fritzing pour certaines des cartes ADXL345 :","title":"ADXL345"},{"location":"Measuring_Resonances.html#accelerometres-i2c","text":"Suggestions d'utilisation des paires torsad\u00e9es : 3.3V+SDA GND+SCL","title":"Acc\u00e9l\u00e9rom\u00e8tres I2C"},{"location":"Measuring_Resonances.html#mpu-9250mpu-9255mpu-6515mpu-6050mpu-6500","text":"Les alternatives \u00e0 l'ADXL345 sont MPU-9250, MPU-9255, MPU-6515, MPU-6050 ou MPU-6500. Ces acc\u00e9l\u00e9rom\u00e8tres ont \u00e9t\u00e9 test\u00e9s pour fonctionner sur I2C avec un RPi ou un RP2040(pico) \u00e0 400kbaud. Sch\u00e9ma de connexion recommand\u00e9 pour I2C sur le Raspberry Pi : brochage du MPU-9250 Brochage du RPI Nom des broches du RPI VCC 01 Alimentation 3.3v continu GND 09 Terre SDA 03 GPIO02 (SDA1) SCL 05 GPIO03 (SCL1) Sch\u00e9ma de connexion recommand\u00e9 pour I2C(i2c0a) connect\u00e9 au RP2040 : brochage du MPU-9250 Broche du RP2040 Nom des broches du RPI VCC 39 3v3 GND 38 Terre SDA 01 GP0 (I2C0 SDA) SCL 02 GP1 (I2C0 SCL)","title":"MPU-9250/MPU-9255/MPU-6515/MPU-6050/MPU-6500"},{"location":"Measuring_Resonances.html#montage-de-laccelerometre","text":"L\u2019acc\u00e9l\u00e9rom\u00e8tre doit \u00eatre fix\u00e9 sur la t\u00eate d'impression. Il faut concevoir un support appropri\u00e9 et adapt\u00e9 \u00e0 l'imprimante 3D. Il est pr\u00e9f\u00e9rable d\u2019aligner les axes de l\u2019acc\u00e9l\u00e9rom\u00e8tre avec les axes de l\u2019imprimante (mais ce n'est pas obligatoire - c\u2019est-\u00e0-dire pas besoin d\u2019aligner l\u2019axe X avec X et ainsi de suite - cela devrait \u00eatre correct m\u00eame si l\u2019axe Z de l\u2019acc\u00e9l\u00e9rom\u00e8tre est l\u2019axe X de l\u2019imprimante, etc.). Exemple de montage d\u2019ADXL345 sur le SmartEffector : Notez que sur une imprimante cart\u00e9sienne, il faut concevoir 2 supports : un pour la t\u00eate et un pour le lit, et ex\u00e9cuter les mesures deux fois. Voir la section correspondante pour plus de d\u00e9tails. Attention : assurez-vous que l\u2019acc\u00e9l\u00e9rom\u00e8tre et les vis qui le maintiennent en place ne touchent aucune partie m\u00e9tallique de l\u2019imprimante. Fondamentalement, le support doit \u00eatre con\u00e7u de mani\u00e8re \u00e0 assurer l\u2019isolation \u00e9lectrique de l\u2019acc\u00e9l\u00e9rom\u00e8tre du ch\u00e2ssis de l\u2019imprimante. Ne pas s\u2019assurer de cette isolation peut cr\u00e9er une boucle de masse dans le syst\u00e8me conduisant \u00e0 l'endommagement de l\u2019\u00e9lectronique.","title":"Montage de l\u2019acc\u00e9l\u00e9rom\u00e8tre"},{"location":"Measuring_Resonances.html#installation-logicielle","text":"Notez que les mesures de r\u00e9sonance et l\u2019auto-\u00e9talonnage de l'input shaper n\u00e9cessitent des d\u00e9pendances logicielles suppl\u00e9mentaires non install\u00e9es par d\u00e9faut. Tout d\u2019abord, ex\u00e9cutez sur votre Raspberry Pi les commandes suivantes\u202f: sudo apt update sudo apt install python3-numpy python3-matplotlib libatlas-base-dev Ensuite, pour installer NumPy dans l\u2019environnement Klipper, ex\u00e9cutez la commande\u202f: ~/klippy-env/bin/pip install -v numpy Selon les performances du processeur, cette op\u00e9ration peut prendre jusqu\u2019\u00e0 20 minutes. Soyez patient et attendez la fin de l\u2019installation. Dans certains cas, si la carte a trop peu de m\u00e9moire, l\u2019installation peut \u00e9chouer et vous devrez activer le fichier d\u2019\u00e9change. V\u00e9rifiez et suivez les instructions dans le document du Microcontr\u00f4leur RPi pour configurer le \u00ab mcu linux \u00bb sur le Raspberry Pi.","title":"Installation logicielle"},{"location":"Measuring_Resonances.html#configurer-ladxl345-avec-le-rpi","text":"Assurez-vous que le pilote SPI Linux est activ\u00e9 en ex\u00e9cutant sudo raspi-config et en activant SPI dans le menu \u00ab Options d\u2019interface \u00bb. Ajoutez les lignes suivantes au fichier printer.cfg : [mcu rpi] serial: /tmp/klipper_host_mcu [adxl345] cs_pin: rpi:None [resonance_tester] accel_chip: adxl345 probe_points: 100, 100, 20 # valeur exemple Il est conseill\u00e9 de commencer par 1 point de test, au milieu du lit d\u2019impression, l\u00e9g\u00e8rement au-dessus.","title":"Configurer l'ADXL345 avec le RPi"},{"location":"Measuring_Resonances.html#configurer-les-series-mpu-60009000-avec-le-rpi","text":"Assurez-vous que le pilote Linux I2C est activ\u00e9 et que le d\u00e9bit en bauds est d\u00e9fini sur 400 000 (voir la section Activation d'I2C pour plus de d\u00e9tails). Ensuite, ajoutez ce qui suit au fichier printer.cfg : [mcu rpi] serial: /tmp/klipper_host_mcu [mpu9250] i2c_mcu: rpi i2c_bus: i2c.1 [resonance_tester] accel_chip: mpu9250 probe_points: 100, 100, 20 # valeurs exemple","title":"Configurer les s\u00e9ries MPU-6000/9000 avec le RPi"},{"location":"Measuring_Resonances.html#configurer-les-series-mpu-60009000-avec-le-pico","text":"Sur le PICO I2C est r\u00e9gl\u00e9 sur 400000 par d\u00e9faut. Ajoutez simplement ce qui suit au fichier printer.cfg : [mcu pico] serial\u202f: /dev/serial/by-id/<le serial id du PICO> [mpu9250] i2c_mcu\u202f: pico i2c_bus\u202f: i2c1a [resonance_tester] accel_chip\u202f: mpu9250 probe_points\u202f: 100, 100, 20 # un exemple [static_digital_output pico_3V3pwm] # Am\u00e9lioration de la stabilit\u00e9 de l'alimentation pin\u202f: pico\u202f:gpio23 Red\u00e9marrez Klipper avec la commande RESTART .","title":"Configurer les s\u00e9ries MPU-6000/9000 avec le PICO"},{"location":"Measuring_Resonances.html#mesurer-les-resonances","text":"","title":"Mesurer les r\u00e9sonances"},{"location":"Measuring_Resonances.html#verification-de-la-configuration","text":"Vous pouvez maintenant tester la connexion. Pour les imprimantes non cart\u00e9siennes (celles avec une seul acc\u00e9l\u00e9rom\u00e8tre), dans Octoprint, entrez ACCELEROMETER_QUERY Pour les imprimante cart\u00e9siennes (plus d\u2019un acc\u00e9l\u00e9rom\u00e8tre), entrez ACCELEROMETER_QUERY CHIP=<chip> o\u00f9 <chip> est le nom de la puce tel qu\u2019il a \u00e9t\u00e9 entr\u00e9, par exemple CHIP=bed (voir\u202f: bed-slinger ) faites-le pour tous les acc\u00e9l\u00e9rom\u00e8tre install\u00e9s. Vous devriez voir les mesures actuelles de l\u2019acc\u00e9l\u00e9rom\u00e8tre, y compris l\u2019acc\u00e9l\u00e9ration en chute libre. Recv: // adxl345 values (x, y, z)\u202f: 470.719200, 941.438400, 9728.196800 Si vous obtenez une erreur comme Invalid adxl345 id (got xx vs e5) , o\u00f9 xx est un autre ID, cela indique un probl\u00e8me de connexion avec l'ADXL345, ou un capteur d\u00e9fectueux. V\u00e9rifiez l\u2019alimentation, le c\u00e2blage (correspondance avec les sch\u00e9mas, aucun fil coup\u00e9 ou desserr\u00e9, etc.) et la qualit\u00e9 des soudures. Si vous utilisez un acc\u00e9l\u00e9rom\u00e8tre de la s\u00e9rie MPU-6000/9000 et qu'il s'affiche comme \"mpu-unknown\", utilisez-le avec prudence ! Ce sont probablement des puces reconditionn\u00e9es ! Ensuite, essayez d\u2019ex\u00e9cuter MEASURE_AXES_NOISE dans Octoprint, vous devriez obtenir des chiffres de base pour le bruit de fond de l\u2019acc\u00e9l\u00e9rom\u00e8tre sur les axes (devraient se situer entre 1 et 100). Un bruit de fond d\u2019axe trop \u00e9lev\u00e9 (par exemple 1000 et plus) peut indiquer des probl\u00e8mes de capteur, des probl\u00e8mes de puissance ou des ventilateurs d\u00e9s\u00e9quilibr\u00e9s entrainant trop de vibrations sur l'imprimante 3D.","title":"V\u00e9rification de la configuration"},{"location":"Measuring_Resonances.html#mesurer-les-resonances_1","text":"Vous pouvez maintenant ex\u00e9cuter les tests r\u00e9els. Ex\u00e9cutez la commande suivante : TEST_RESONANCES AXIS=X Notez que cela cr\u00e9era des vibrations sur l\u2019axe X. Ce test d\u00e9sactivera les valeurs du formateur d'entr\u00e9e (aka input shapper) d\u00e9j\u00e0 param\u00e9tr\u00e9es. Le test de r\u00e9sonance ne peut pas \u00eatre fait avec le formateur d'entr\u00e9e d\u00e9j\u00e0 activ\u00e9. Attention\u202f! Gardez un \u0153il sur l\u2019imprimante la premi\u00e8re fois, pour vous assurer que les vibrations ne deviennent pas trop violentes (la commande M112 peut \u00eatre utilis\u00e9e pour interrompre le test en cas d\u2019urgence - en esp\u00e9rant ne pas avoir \u00e0 l'utiliser). Si les vibrations deviennent trop fortes, vous pouvez sp\u00e9cifier une valeur inf\u00e9rieure \u00e0 la valeur par d\u00e9faut du param\u00e8tre accel_per_hz dans la section [resonance_tester] . [resonance_tester] accel_chip: adxl345 accel_per_hz: 50 # default is 75 probe_points: ... Si cela fonctionne pour l\u2019axe X, ex\u00e9cutez ensuite la commande pour l\u2019axe Y : TEST_RESONANCES AXIS=Y Cela g\u00e9n\u00e9rera 2 fichiers CSV ( /tmp/resonances_x_*.csv et /tmp/resonances_y_*.csv ). Ces fichiers peuvent \u00eatre trait\u00e9s avec le script autonome sur un Raspberry Pi. Pour ce faire, ex\u00e9cutez les commandes suivantes : ~/klipper/scripts/calibrate_shaper.py /tmp/resonances_x_*.csv -o /tmp/shaper_calibrate_x.png ~/klipper/scripts/calibrate_shaper.py /tmp/resonances_y_*.csv -o /tmp/shaper_calibrate_y.png Ce script g\u00e9n\u00e9rera les graphiques /tmp/shaper_calibrate_x.png et /tmp/shaper_calibrate_y.png avec les r\u00e9ponses en fr\u00e9quence. Vous obtiendrez \u00e9galement les fr\u00e9quences sugg\u00e9r\u00e9es pour chaque mode du formateur d'entr\u00e9e (input shapper), ainsi que la valeur recommand\u00e9e pour votre configuration. Par exemple : Fitted shaper 'zv' frequency = 34.4 Hz (vibrations = 4.0%, smoothing ~= 0.132) To avoid too much smoothing with 'zv', suggested max_accel <= 4500 mm/sec^2 Fitted shaper 'mzv' frequency = 34.6 Hz (vibrations = 0.0%, smoothing ~= 0.170) To avoid too much smoothing with 'mzv', suggested max_accel <= 3500 mm/sec^2 Fitted shaper 'ei' frequency = 41.4 Hz (vibrations = 0.0%, smoothing ~= 0.188) To avoid too much smoothing with 'ei', suggested max_accel <= 3200 mm/sec^2 Fitted shaper '2hump_ei' frequency = 51.8 Hz (vibrations = 0.0%, smoothing ~= 0.201) To avoid too much smoothing with '2hump_ei', suggested max_accel <= 3000 mm/sec^2 Fitted shaper '3hump_ei' frequency = 61.8 Hz (vibrations = 0.0%, smoothing ~= 0.215) To avoid too much smoothing with '3hump_ei', suggested max_accel <= 2800 mm/sec^2 Recommended shaper is mzv @ 34.6 Hz La configuration sugg\u00e9r\u00e9e peut \u00eatre ajout\u00e9e \u00e0 la section [input_shaper] de printer.cfg , par exemple : [input_shaper] shaper_freq_x: ... shaper_type_x: ... shaper_freq_y: 34.6 shaper_type_y: mzv [printer] max_accel: 3000 # Ne devrait pas d\u00e9passer les valeurs estim\u00e9es d'acc\u00e9l\u00e9ration calcul\u00e9es pour les axes X et Y Ou vous pouvez choisir vous-m\u00eame une autre configuration en fonction des graphiques g\u00e9n\u00e9r\u00e9s\u202f: les pics de densit\u00e9 spectrale de puissance sur les graphiques correspondent aux fr\u00e9quences de r\u00e9sonance de l\u2019imprimante. Notez que vous pouvez \u00e9galement ex\u00e9cuter l\u2019auto-\u00e9talonnage du formateur d'entr\u00e9e (input shapper) \u00e0 partir de Klipper directement , pratique, par exemple, pour la recalibration du formateur d'entr\u00e9e.","title":"Mesurer les r\u00e9sonances"},{"location":"Measuring_Resonances.html#imprimantes-cartesiennes-a-lit-mobile","text":"Si votre imprimante est une imprimante cart\u00e9sienne dont le plateau est mobile sur l'axe Y, vous devrez changer l\u2019emplacement de l\u2019acc\u00e9l\u00e9rom\u00e8tre entre les mesures des axes X et Y : mesurez les r\u00e9sonances de l\u2019axe X avec l\u2019acc\u00e9l\u00e9rom\u00e8tre fix\u00e9 \u00e0 la t\u00eate et les r\u00e9sonances de l\u2019axe Y - au lit (la configuration habituelle des imprimantes cart\u00e9siennes). Cependant, vous pouvez \u00e9galement connecter les deux acc\u00e9l\u00e9rom\u00e8tres simultan\u00e9ment, bien qu'ils doivent \u00eatre connect\u00e9s \u00e0 des cartes diff\u00e9rentes (par exemple, \u00e0 une carte RPi et au MCU de l'imprimante), ou \u00e0 deux interfaces SPI physiques diff\u00e9rentes sur la m\u00eame carte (rarement disponibles). Ensuite, ils peuvent \u00eatre configur\u00e9s de la mani\u00e8re suivante : [adxl345 hotend] # En consid\u00e9rant que l'adxl de la t\u00eate connect\u00e9e au RPI cs_pin: rpi:None [adxl345 bed] # En consid\u00e9rant que l'adxl du lit est connect\u00e9 au MCU cs_pin: ... # Printer board SPI chip select (CS) pin [resonance_tester] # En consid\u00e9rant un montage standard pour une imprimante cart\u00e9sienne accel_chip_x: adxl345 hotend accel_chip_y: adxl345 bed probe_points: ... Ensuite, les commandes TEST_RESONANCES AXIS=X et TEST_RESONANCES AXIS=Y utiliseront le bon acc\u00e9l\u00e9rom\u00e8tre pour chaque axe.","title":"Imprimantes cart\u00e9siennes \u00e0 lit mobile"},{"location":"Measuring_Resonances.html#lissage-maximum","text":"Gardez \u00e0 l'esprit que le formateur d'entr\u00e9e (input shapper) peut cr\u00e9er un lissage sur certaines parties de l'impression. Le r\u00e9glage automatique du formateur d'entr\u00e9e effectu\u00e9 par le script calibrate_shaper.py ou la commande SHAPER_CALIBRATE essaie de limiter le lissage, mais il essaie aussi de minimiser les vibrations r\u00e9sultantes. Cela peut conduire parfois, \u00e0 un choix peu optimis\u00e9 de la fr\u00e9quence du formateur d'entr\u00e9e ou peut-\u00eatre pr\u00e9f\u00e9rez-vous simplement avoir moins de lissage dans certaines parties de l'impression au d\u00e9triment des vibrations restantes. Dans ces cas, vous pouvez demander de limiter le lissage maximal \u00e0 partir du formateur d'entr\u00e9e. Regardons les r\u00e9sultats suivants du r\u00e9glage automatique : Fitted shaper 'zv' frequency = 57.8 Hz (vibrations = 20.3%, smoothing ~= 0.053) To avoid too much smoothing with 'zv', suggested max_accel <= 13000 mm/sec^2 Fitted shaper 'mzv' frequency = 34.8 Hz (vibrations = 3.6%, smoothing ~= 0.168) To avoid too much smoothing with 'mzv', suggested max_accel <= 3600 mm/sec^2 Fitted shaper 'ei' frequency = 48.8 Hz (vibrations = 4.9%, smoothing ~= 0.135) To avoid too much smoothing with 'ei', suggested max_accel <= 4400 mm/sec^2 Fitted shaper '2hump_ei' frequency = 45.2 Hz (vibrations = 0.1%, smoothing ~= 0.264) To avoid too much smoothing with '2hump_ei', suggested max_accel <= 2200 mm/sec^2 Fitted shaper '3hump_ei' frequency = 48.0 Hz (vibrations = 0.0%, smoothing ~= 0.356) To avoid too much smoothing with '3hump_ei', suggested max_accel <= 1500 mm/sec^2 Recommended shaper is 2hump_ei @ 45.2 Hz Notez que les valeurs rapport\u00e9es smoothing sont des valeurs projet\u00e9es abstraites. Ces valeurs peuvent \u00eatre utilis\u00e9es pour comparer diff\u00e9rentes configurations : plus la valeur est \u00e9lev\u00e9e, plus le formateur d'entr\u00e9e cr\u00e9era de lissage. Cependant, ces scores de lissage ne repr\u00e9sentent aucune mesure r\u00e9elle du lissage, car le lissage r\u00e9el d\u00e9pend des param\u00e8tres max_accel et square_corner_velocity . Par cons\u00e9quent, vous devrez faire des impressions de test pour voir exactement le lissage cr\u00e9\u00e9 par la configuration choisie. Dans l'exemple ci-dessus, les param\u00e8tres de mise en forme sugg\u00e9r\u00e9s ne sont pas mauvais, mais que se passe-t-il si vous souhaitez obtenir moins de lissage sur l'axe X ? Vous pouvez essayer de limiter le lissage maximal du formateur d'entr\u00e9e \u00e0 l'aide de la commande suivante : ~/klipper/scripts/calibrate_shaper.py /tmp/resonances_x_*.csv -o /tmp/shaper_calibrate_x.png --max_smoothing=0.2 ce qui limite le lissage \u00e0 un score de 0,2. Vous pouvez maintenant obtenir le r\u00e9sultat suivant : Fitted shaper 'zv' frequency = 55.4 Hz (vibrations = 19.7%, smoothing ~= 0.057) To avoid too much smoothing with 'zv', suggested max_accel <= 12000 mm/sec^2 Fitted shaper 'mzv' frequency = 34.6 Hz (vibrations = 3.6%, smoothing ~= 0.170) To avoid too much smoothing with 'mzv', suggested max_accel <= 3500 mm/sec^2 Fitted shaper 'ei' frequency = 48.2 Hz (vibrations = 4.8%, smoothing ~= 0.139) To avoid too much smoothing with 'ei', suggested max_accel <= 4300 mm/sec^2 Fitted shaper '2hump_ei' frequency = 52.0 Hz (vibrations = 2.7%, smoothing ~= 0.200) To avoid too much smoothing with '2hump_ei', suggested max_accel <= 3000 mm/sec^2 Fitted shaper '3hump_ei' frequency = 72.6 Hz (vibrations = 1.4%, smoothing ~= 0.155) To avoid too much smoothing with '3hump_ei', suggested max_accel <= 3900 mm/sec^2 Recommended shaper is 3hump_ei @ 72.6 Hz Si vous comparez avec les pr\u00e9c\u00e9dents param\u00e8tres sugg\u00e9r\u00e9s, les vibrations sont un peu plus importantes, mais le lissage est nettement plus faible qu'auparavant, ce qui permet une acc\u00e9l\u00e9ration maximale plus importante. Lorsque vous choisissez le param\u00e8tre max_smoothing , vous pouvez utiliser une approche par essais et erreurs. Essayez quelques valeurs diff\u00e9rentes et voyez quels r\u00e9sultats vous obtenez. Notez que le lissage r\u00e9el produit par le formateur d'entr\u00e9e d\u00e9pend principalement de la fr\u00e9quence de r\u00e9sonance la plus basse de l'imprimante : plus la fr\u00e9quence de r\u00e9sonance la plus basse est \u00e9lev\u00e9e, plus le lissage est faible. Par cons\u00e9quent, si vous demandez au script de trouver une configuration du formateur d'entr\u00e9e avec un lissage irr\u00e9aliste, cela se fera au d\u00e9triment d'une r\u00e9sonance accrue aux fr\u00e9quences les plus basses (g\u00e9n\u00e9ralement, les plus visibles dans les impressions). V\u00e9rifiez donc toujours les vibrations restantes projet\u00e9es signal\u00e9es par le script et assurez-vous qu'elles ne sont pas trop \u00e9lev\u00e9es. Notez que si vous avez trouv\u00e9 une bonne valeur de max_smoothing pour vos deux axes, vous pouvez la stocker dans printer.cfg comme [resonance_tester] accel_chip: ... probe_points: ... max_smoothing: 0.25 # valeur exemple Ensuite, si vous r\u00e9ex\u00e9cutez le r\u00e9glage automatique du formateur d'entr\u00e9e \u00e0 l'aide de la commande SHAPER_CALIBRATE , c'est cette valeur stock\u00e9e max_smoothing qui sera prise comme r\u00e9f\u00e9rence.","title":"Lissage maximum"},{"location":"Measuring_Resonances.html#selection-de-max_accel","text":"\u00c9tant donn\u00e9 que le formateur d'entr\u00e9e peut cr\u00e9er un certain lissage dans les pi\u00e8ces, en particulier avec des acc\u00e9l\u00e9rations \u00e9lev\u00e9es, vous devrez toujours choisir une valeur max_accel ne cr\u00e9ant pas trop de lissage dans les pi\u00e8ces imprim\u00e9es. Un script d'\u00e9talonnage fournit une estimation du param\u00e8tre max_accel qui ne devrait pas cr\u00e9er trop de lissage. Notez que le max_accel tel qu'affich\u00e9 par le script de calibrage n'est qu'un maximum th\u00e9orique auquel le formateur d'entr\u00e9e est encore capable de travailler sans produire trop de lissage. Il ne s'agit en aucun cas d'une recommandation pour d\u00e9finir cette acc\u00e9l\u00e9ration sur vos impressions. L'acc\u00e9l\u00e9ration maximale support\u00e9e par votre imprimante d\u00e9pend de ses propri\u00e9t\u00e9s m\u00e9caniques et du couple maximal des moteurs pas \u00e0 pas utilis\u00e9s. Par cons\u00e9quent, il est sugg\u00e9r\u00e9 de d\u00e9finir un max_accel dans la section [printer] qui ne d\u00e9passe pas les valeurs estim\u00e9es pour les axes X et Y, probablement avec une marge de s\u00e9curit\u00e9. Vous pouvez \u00e9galement suivre cette partie du guide de r\u00e9glage du formateur d'entr\u00e9e et imprimer un mod\u00e8le de test pour choisir le param\u00e8tre max_accel de mani\u00e8re exp\u00e9rimentale. M\u00eame remarque pour l' auto-calibration du formateur d'entr\u00e9e avec la commande SHAPER_CALIBRATE : il faut encore choisir la bonne valeur max_accel apr\u00e8s l'auto-calibrage, notez que les limites d'acc\u00e9l\u00e9rations sugg\u00e9r\u00e9es ne sont pas appliqu\u00e9es automatiquement. Si vous effectuez un r\u00e9-\u00e9talonnage du formateur d'entr\u00e9e et que le lissage indiqu\u00e9 pour la configuration de formateur sugg\u00e9r\u00e9e est pratiquement le m\u00eame que celui obtenu lors du calibrage pr\u00e9c\u00e9dent, cette \u00e9tape peut \u00eatre ignor\u00e9e.","title":"S\u00e9lection de max_accel"},{"location":"Measuring_Resonances.html#test-des-axes-personnalises","text":"la commande TEST_RESONANCES prend en charge les axes personnalis\u00e9s. Bien que cela ne soit pas vraiment utile pour l\u2019\u00e9talonnage des input shaper, cela peut \u00eatre utilis\u00e9 pour \u00e9tudier en profondeur les r\u00e9sonances de l\u2019imprimante et v\u00e9rifier, par exemple, la tension de la courroie. Pour v\u00e9rifier la tension de la courroie sur les imprimantes CoreXY, ex\u00e9cutez TEST_RESONANCES AXIS=1,1 OUTPUT=raw_data TEST_RESONANCES AXIS=1,-1 OUTPUT=raw_data et utilisez graph_accelerometer.py pour traiter les fichiers g\u00e9n\u00e9r\u00e9s. ~/klipper/scripts/graph_accelerometer.py -c /tmp/raw_data_axis*.csv -o /tmp/resonances.png qui g\u00e9n\u00e9rera /tmp/r\u00e9sonances.png en comparant les r\u00e9sonances. Pour les imprimantes Delta avec le placement des tours par d\u00e9faut (tour A ~= 210 degr\u00e9s, B ~= 330 degr\u00e9s et C ~= 90 degr\u00e9s), ex\u00e9cutez TEST_RESONANCES AXIS=0,1 OUTPUT=raw_data TEST_RESONANCES AXIS=-0.866025404,-0.5 OUTPUT=raw_data TEST_RESONANCES AXIS=0.866025404,-0.5 OUTPUT=raw_data puis utilisez la m\u00eame commande ~/klipper/scripts/graph_accelerometer.py -c /tmp/raw_data_axis*.csv -o /tmp/resonances.png pour g\u00e9n\u00e9rer le fichier de comparaison des r\u00e9sonnances /tmp/r\u00e9sonances.png .","title":"Test des axes personnalis\u00e9s"},{"location":"Measuring_Resonances.html#calibrage-automatique-du-formateur-dentree","text":"En plus de choisir manuellement les param\u00e8tres appropri\u00e9s pour la fonction de formateur d'entr\u00e9e, il est \u00e9galement possible d'ex\u00e9cuter le r\u00e9glage automatique du formateur d'entr\u00e9e directement \u00e0 partir de Klipper. Ex\u00e9cutez la commande suivante via le terminal Octoprint : SHAPER_CALIBRATE Cela ex\u00e9cutera le test complet pour les deux axes et g\u00e9n\u00e9rera la sortie csv ( /tmp/calibration_data_*.csv par d\u00e9faut) pour la r\u00e9ponse en fr\u00e9quence et les formateurs d'entr\u00e9e sugg\u00e9r\u00e9s. Vous obtiendrez \u00e9galement les fr\u00e9quences sugg\u00e9r\u00e9es pour chaque formateur, ainsi que le mod\u00e8le de formateur d'entr\u00e9e recommand\u00e9 pour votre configuration, sur la console Octoprint. Par exemple\u202f: Calculating the best input shaper parameters for y axis Fitted shaper 'zv' frequency = 39.0 Hz (vibrations = 13.2%, smoothing ~= 0.105) To avoid too much smoothing with 'zv', suggested max_accel <= 5900 mm/sec^2 Fitted shaper 'mzv' frequency = 36.8 Hz (vibrations = 1.7%, smoothing ~= 0.150) To avoid too much smoothing with 'mzv', suggested max_accel <= 4000 mm/sec^2 Fitted shaper 'ei' frequency = 36.6 Hz (vibrations = 2.2%, smoothing ~= 0.240) To avoid too much smoothing with 'ei', suggested max_accel <= 2500 mm/sec^2 Fitted shaper '2hump_ei' frequency = 48.0 Hz (vibrations = 0.0%, smoothing ~= 0.234) To avoid too much smoothing with '2hump_ei', suggested max_accel <= 2500 mm/sec^2 Fitted shaper '3hump_ei' frequency = 59.0 Hz (vibrations = 0.0%, smoothing ~= 0.235) To avoid too much smoothing with '3hump_ei', suggested max_accel <= 2500 mm/sec^2 Recommended shaper_type_y = mzv, shaper_freq_y = 36.8 Hz Si vous \u00eates d'accord avec les param\u00e8tres sugg\u00e9r\u00e9s, vous pouvez ex\u00e9cuter SAVE_CONFIG maintenant pour les enregistrer et red\u00e9marrer Klipper. Notez que cela ne mettra pas \u00e0 jour la valeur max_accel dans la section [printer] . Vous devrez la mettre \u00e0 jour manuellement en suivant les recommandations de la section Choisir l'acc\u00e9l\u00e9ration maximale . Si votre imprimante est une imprimante cart\u00e9sienne, vous pouvez pr\u00e9ciser l'axe \u00e0 tester, afin de pouvoir modifier le point de montage de l'acc\u00e9l\u00e9rom\u00e8tre entre les tests (par d\u00e9faut, le test est effectu\u00e9 pour les deux axes) : SHAPER_CALIBRATE AXIS=Y Vous pouvez ex\u00e9cuter SAVE_CONFIG deux fois - apr\u00e8s avoir calibr\u00e9 chaque axe. Cependant, si vous avez connect\u00e9 deux acc\u00e9l\u00e9rom\u00e8tres simultan\u00e9ment, vous pouvez ex\u00e9cutez simplement SHAPER_CALIBRATE sans sp\u00e9cifier d'axe pour calibrer les formateurs d'entr\u00e9e des deux axes en une seule fois.","title":"Calibrage automatique du formateur d'entr\u00e9e"},{"location":"Measuring_Resonances.html#re-etalonnage-du-formateur-dentree-aka-input-shapper","text":"La commande SHAPER_CALIBRATE peut \u00e9galement \u00eatre utilis\u00e9e pour recalibrer le formateur d'entr\u00e9e ult\u00e9rieurement, en particulier si des modifications de l'imprimante pouvant affecter sa cin\u00e9matique sont apport\u00e9es. On peut soit relancer l'\u00e9talonnage complet \u00e0 l'aide de la commande SHAPER_CALIBRATE , soit restreindre l'auto-\u00e9talonnage \u00e0 un seul axe en fournissant le param\u00e8tre AXIS= , comme SHAPER_CALIBRATE AXIS=X Attention ! Il est d\u00e9conseill\u00e9 d'ex\u00e9cuter l'autocalibrage de l'input shaper tr\u00e8s fr\u00e9quemment (par exemple, avant chaque impression ou tous les jours). Afin de d\u00e9terminer les fr\u00e9quences de r\u00e9sonance, l'autocalibrage cr\u00e9e des vibrations intenses sur chacun des axes. Les imprimantes 3D ne sont pas con\u00e7ues pour r\u00e9sister \u00e0 une exposition prolong\u00e9e \u00e0 des vibrations proches des fr\u00e9quences de r\u00e9sonance. Cela pourrait augmenter l'usure des composants de l'imprimante et r\u00e9duire leur dur\u00e9e de vie. Il existe \u00e9galement un risque accru que certaines pi\u00e8ces se d\u00e9vissent ou se desserrent. V\u00e9rifiez toujours que toutes les pi\u00e8ces de l'imprimante (y compris celles qui ne peuvent normalement pas bouger) sont solidement fix\u00e9es en place apr\u00e8s chaque r\u00e9glage automatique. De plus, en raison d'un certain bruit dans les mesures, il est possible que les r\u00e9sultats de r\u00e9glage soient l\u00e9g\u00e8rement diff\u00e9rents d'un calibrage \u00e0 l'autre. Ce bruit ne devrait pas trop affecter la qualit\u00e9 d'impression. Cependant, il est conseill\u00e9 de rev\u00e9rifier les param\u00e8tres sugg\u00e9r\u00e9s et d'imprimer des tests d'impression avant de les utiliser pour confirmer qu'ils sont corrects.","title":"R\u00e9-\u00e9talonnage du formateur d'entr\u00e9e (aka input shapper)"},{"location":"Measuring_Resonances.html#traitement-hors-ligne-des-donnees-de-laccelerometre","text":"Il est possible de g\u00e9n\u00e9rer les donn\u00e9es brutes de l\u2019acc\u00e9l\u00e9rom\u00e8tre et de les traiter hors ligne (par exemple sur une machine h\u00f4te), par exemple pour trouver des r\u00e9sonances. Pour ce faire, ex\u00e9cutez les commandes suivantes via le terminal Octoprint : SET_INPUT_SHAPER SHAPER_FREQ_X=0 SHAPER_FREQ_Y=0 TEST_RESONANCES AXIS=X OUTPUT=raw_data ignorez toute erreur pour la commande SET_INPUT_SHAPER . Pour la commande TEST_RESONANCES , sp\u00e9cifiez l\u2019axe de test souhait\u00e9. Les donn\u00e9es brutes seront \u00e9crites dans le r\u00e9pertoire /tmp sur le RPi. Les donn\u00e9es brutes peuvent \u00e9galement \u00eatre obtenues en ex\u00e9cutant la commande ACCELEROMETER_MEASURE deux fois - d\u2019abord pour d\u00e9marrer les mesures, puis pour les arr\u00eater et \u00e9crire le fichier de sortie. Reportez-vous \u00e0 G-Codes pour plus de d\u00e9tails. Les donn\u00e9es peuvent \u00eatre trait\u00e9es ult\u00e9rieurement avec les scripts suivants : scripts/graph_accelerometer.py et scripts/calibrate_shaper.py . Les deux acceptent un ou plusieurs fichiers csv bruts comme entr\u00e9e en fonction du mode. Le script graph_accelerometer.py prend en charge plusieurs modes de fonctionnement : pour le tra\u00e7age des donn\u00e9es brutes de l\u2019acc\u00e9l\u00e9rom\u00e8tre (utilisez le param\u00e8tre -r ), seule 1 entr\u00e9e est prise en charge\u202f; tracer une r\u00e9ponse en fr\u00e9quence (aucun param\u00e8tre suppl\u00e9mentaire n'est requis), si plusieurs entr\u00e9es sont sp\u00e9cifi\u00e9es, la r\u00e9ponse en fr\u00e9quence moyenne est calcul\u00e9e ; comparaison de la r\u00e9ponse en fr\u00e9quence entre plusieurs entr\u00e9es (utiliser le param\u00e8tre -c ) ; vous pouvez \u00e9galement sp\u00e9cifier l\u2019axe de l\u2019acc\u00e9l\u00e9rom\u00e8tre \u00e0 prendre en compte via le param\u00e8tre -a x , -a y ou -a z (si aucun n\u2019est sp\u00e9cifi\u00e9, la somme des vibrations pour tous les axes est utilis\u00e9e) ; tra\u00e7age du spectrogramme (utiliser le param\u00e8tre -s ), seule 1 entr\u00e9e est prise en charge\u202f; vous pouvez \u00e9galement sp\u00e9cifier l\u2019axe de l\u2019acc\u00e9l\u00e9rom\u00e8tre \u00e0 prendre en compte via le param\u00e8tre -a x , -a y ou -a z (si aucun n\u2019est sp\u00e9cifi\u00e9, la somme des vibrations pour tous les axes est utilis\u00e9e). Notez que graph_accelerometer.py script ne prend en charge que les fichiers raw_data*.csv et non les fichiers resonances*.csv ou calibration_data*.csv. Par exemple, ~/klipper/scripts/graph_accelerometer.py /tmp/raw_data_x_*.csv -o /tmp/resonances_x.png -c -a z tracera la comparaison de plusieurs fichiers /tmp/raw_data_x_*.csv pour l\u2019axe Z dans le fichier /tmp/resonances_x.png . Le script shaper_calibrate.py accepte 1 ou plusieurs entr\u00e9es et peut ex\u00e9cuter le r\u00e9glage automatique de l'input shaper et sugg\u00e9rer les meilleurs param\u00e8tres pour les entr\u00e9es fournies. Il affiche les param\u00e8tres sugg\u00e9r\u00e9s sur la console et peut en outre g\u00e9n\u00e9rer un graphique si le param\u00e8tre -o output.png est fourni, ou un fichier CSV si le param\u00e8tre -c output.csv est sp\u00e9cifi\u00e9. Fournir plusieurs entr\u00e9es \u00e0 shaper_calibrate.py script peut \u00eatre utile si vous ex\u00e9cutez un r\u00e9glage avanc\u00e9 de l'input shaper, par exemple : Ex\u00e9cutez TEST_RESONANCES AXIS=X OUTPUT=raw_data (et Y axe) pour un seul axe deux fois sur une imprimante cart\u00e9sienne avec l\u2019acc\u00e9l\u00e9rom\u00e8tre fix\u00e9 \u00e0 la t\u00eate d\u2019outil la premi\u00e8re fois, et l\u2019acc\u00e9l\u00e9rom\u00e8tre fix\u00e9 au lit la deuxi\u00e8me fois afin de d\u00e9tecter les r\u00e9sonances crois\u00e9es des axes et de tenter de les annuler avec l'input shaper. Ex\u00e9cutez TEST_RESONANCES AXIS=Y OUTPUT=raw_data deux fois sur le lit avec un lit en verre et une surface magn\u00e9tique (plus l\u00e9g\u00e8re) pour trouver les param\u00e8tres d'input shaper qui fonctionnent bien pour n\u2019importe quelle configuration de surface d\u2019impression. Combinaison des donn\u00e9es de r\u00e9sonance de plusieurs points de test. Combinaison des donn\u00e9es de r\u00e9sonance \u00e0 partir de 2 axes (par exemple, sur une imprimante cart\u00e9sienne pour configurer les input_shaper de l\u2019axe X \u00e0 partir des r\u00e9sonances des axes X et Y pour annuler les vibrations du lit * * au cas o\u00f9 la buse \u00ab attraperait \u00bb une impression lors du d\u00e9placement dans la direction de l\u2019axe X).","title":"Traitement hors ligne des donn\u00e9es de l\u2019acc\u00e9l\u00e9rom\u00e8tre"},{"location":"Multi_MCU_Homing.html","text":"Mise \u00e0 l'origine et Palpage multi contr\u00f4leurs \u00b6 Klipper poss\u00e8de un m\u00e9canisme pour la mise \u00e0 l'origine avec une fin de course raccord\u00e9e \u00e0 un microcontr\u00f4leur et des moteurs pas \u00e0 pas raccord\u00e9s \u00e0 un autre microcontr\u00f4leur. Ce m\u00e9canisme est connu sous le nom de \"multi-mcu homing\". Cette fonctionnalit\u00e9 est aussi utilis\u00e9e si la sonde de palpage Z est raccord\u00e9e \u00e0 un microcontr\u00f4leur diff\u00e9rent de celui des moteurs Z. Cette fonctionnalit\u00e9 peut \u00eatre utile pour simplifier le c\u00e2blage : il peut \u00eatre plus simple de raccorder un fin de course ou une sonde au microcontr\u00f4leur le plus proche. Cependant, l'utilisation de cette fonctionnalit\u00e9 peut provoquer un \"d\u00e9passement\" des moteurs pas \u00e0 pas pendant les op\u00e9ration de mise \u00e0 l'origine ou de palpage. Cette possibilit\u00e9 de \"d\u00e9passement\" peut arriver \u00e0 cause des d\u00e9lais de transmission entre le microcontr\u00f4leur des endstop et le microcontr\u00f4leur qui d\u00e9plce les moteurs pas \u00e0 pas. Le code de Klipper a \u00e9t\u00e9 con\u00e7u pour limiter ce d\u00e9lai a moins de 25 ms. (Quand la mise \u00e0 l'origine multi contr\u00f4leurs est active, les microcontr\u00f4leurs envoient des messages d'\u00e9tat p\u00e9riodiquement et il y a une v\u00e9rification que ces messages sont bien re\u00e7us dans la limite des 25 ms.) Donc, par exemple, si l'on fait une mise \u00e0 l'origine \u00e0 10 mm/s, il est alors possible de d\u00e9passer de 0.250 mm maximum (10 mm/s * 0.25 s = 0.250 mm).Il faut bien faire attention \u00e0 cette possibilit\u00e9 de \"d\u00e9passement\" lors de la configuration d'une mise \u00e0 l'origine avec multiples contr\u00f4leurs. Une mise \u00e0 l'origine ou un palpage plus lent peut r\u00e9duite le \"d\u00e9passement\". Ce d\u00e9passement des moteurs pas \u00e0 pas ne nuit pas \u00e0 la pr\u00e9cision de la proc\u00e9dure de mise \u00e0 l'origine et de palpage. Le code de Klipper d\u00e9tectera le d\u00e9passement et en tiendra compte dans ses calculs. Cependant, il est important que la conception mat\u00e9rielle soit capable de g\u00e9rer les d\u00e9passements sans endommager la machine. Si Klipper d\u00e9tecte un probl\u00e8me de communication entre les microcontr\u00f4leurs lors de la mise \u00e0 l'origine multi-mcu, il d\u00e9clenchera une erreur \"D\u00e9lai de communication pendant la mise \u00e0 l'origine\". Notez qu'un axe avec plusieurs steppers (par exemple, stepper_z et stepper_z1 ) doit avoir tous les meteeurs pas \u00e0 pas sur le m\u00eame microcontr\u00f4leur afin d'utiliser le r\u00e9f\u00e9rencement multi-mcu. Par exemple, si une fin de course est sur un microcontr\u00f4leur distinct de stepper_z alors stepper_z1 doit \u00eatre sur le m\u00eame microcontr\u00f4leur que stepper_z .","title":"Mise \u00e0 l'origine et Palpage multi contr\u00f4leurs"},{"location":"Multi_MCU_Homing.html#mise-a-lorigine-et-palpage-multi-controleurs","text":"Klipper poss\u00e8de un m\u00e9canisme pour la mise \u00e0 l'origine avec une fin de course raccord\u00e9e \u00e0 un microcontr\u00f4leur et des moteurs pas \u00e0 pas raccord\u00e9s \u00e0 un autre microcontr\u00f4leur. Ce m\u00e9canisme est connu sous le nom de \"multi-mcu homing\". Cette fonctionnalit\u00e9 est aussi utilis\u00e9e si la sonde de palpage Z est raccord\u00e9e \u00e0 un microcontr\u00f4leur diff\u00e9rent de celui des moteurs Z. Cette fonctionnalit\u00e9 peut \u00eatre utile pour simplifier le c\u00e2blage : il peut \u00eatre plus simple de raccorder un fin de course ou une sonde au microcontr\u00f4leur le plus proche. Cependant, l'utilisation de cette fonctionnalit\u00e9 peut provoquer un \"d\u00e9passement\" des moteurs pas \u00e0 pas pendant les op\u00e9ration de mise \u00e0 l'origine ou de palpage. Cette possibilit\u00e9 de \"d\u00e9passement\" peut arriver \u00e0 cause des d\u00e9lais de transmission entre le microcontr\u00f4leur des endstop et le microcontr\u00f4leur qui d\u00e9plce les moteurs pas \u00e0 pas. Le code de Klipper a \u00e9t\u00e9 con\u00e7u pour limiter ce d\u00e9lai a moins de 25 ms. (Quand la mise \u00e0 l'origine multi contr\u00f4leurs est active, les microcontr\u00f4leurs envoient des messages d'\u00e9tat p\u00e9riodiquement et il y a une v\u00e9rification que ces messages sont bien re\u00e7us dans la limite des 25 ms.) Donc, par exemple, si l'on fait une mise \u00e0 l'origine \u00e0 10 mm/s, il est alors possible de d\u00e9passer de 0.250 mm maximum (10 mm/s * 0.25 s = 0.250 mm).Il faut bien faire attention \u00e0 cette possibilit\u00e9 de \"d\u00e9passement\" lors de la configuration d'une mise \u00e0 l'origine avec multiples contr\u00f4leurs. Une mise \u00e0 l'origine ou un palpage plus lent peut r\u00e9duite le \"d\u00e9passement\". Ce d\u00e9passement des moteurs pas \u00e0 pas ne nuit pas \u00e0 la pr\u00e9cision de la proc\u00e9dure de mise \u00e0 l'origine et de palpage. Le code de Klipper d\u00e9tectera le d\u00e9passement et en tiendra compte dans ses calculs. Cependant, il est important que la conception mat\u00e9rielle soit capable de g\u00e9rer les d\u00e9passements sans endommager la machine. Si Klipper d\u00e9tecte un probl\u00e8me de communication entre les microcontr\u00f4leurs lors de la mise \u00e0 l'origine multi-mcu, il d\u00e9clenchera une erreur \"D\u00e9lai de communication pendant la mise \u00e0 l'origine\". Notez qu'un axe avec plusieurs steppers (par exemple, stepper_z et stepper_z1 ) doit avoir tous les meteeurs pas \u00e0 pas sur le m\u00eame microcontr\u00f4leur afin d'utiliser le r\u00e9f\u00e9rencement multi-mcu. Par exemple, si une fin de course est sur un microcontr\u00f4leur distinct de stepper_z alors stepper_z1 doit \u00eatre sur le m\u00eame microcontr\u00f4leur que stepper_z .","title":"Mise \u00e0 l'origine et Palpage multi contr\u00f4leurs"},{"location":"Navigation.html","text":"Documentation Klipper Installation et configuration R\u00e9f\u00e9rence de configuration Nivellement du lit Compensation de r\u00e9sonance Mod\u00e8les de commandes Documentation pour les d\u00e9veloppeurs Documents sp\u00e9cifiques \u00e0 certains appareils","title":"Navigation"},{"location":"Overview.html","text":"Vue d'ensemble \u00b6 Bienvenue dans la documentation de Klipper. Si vous d\u00e9butez avec Klipper, commencez par les sections fonctionnalit\u00e9s et installation . Informations g\u00e9n\u00e9rales \u00b6 Fonctionnalit\u00e9s : Une liste avanc\u00e9e des fonctionnalit\u00e9s de Klipper. FAQ \u202f: Foire aux questions. Versions : L'historique des versions de Klipper. Modifications de configuration \u202f: Modifications r\u00e9centes du logiciel pouvant n\u00e9cessiter que les utilisateurs mettent \u00e0 jour la configuration de leur imprimante. Contact \u202f: Informations sur les rapports d'anomalies et communication g\u00e9n\u00e9rale avec les d\u00e9veloppeurs de Klipper. Installation et configuration \u00b6 Installation \u202f: Guide d'installation de Klipper. R\u00e9f\u00e9rence de la configuration : Description de tous les param\u00e8tres de configuration. Distance de rotation : Calcul du param\u00e8tre rotation_distance du moteur. V\u00e9rifications de la configuration : V\u00e9rification des param\u00e8tres de base des broches du fichier de configuration. Nivelage du lit : Informations sur le \"nivelage du lit\" dans Klipper. Calibration delta : Calibration de la cin\u00e9matique Delta. Calibration de la sonde : Calibration automatique des sondes Z. BL-Touch : Configuration d'une sonde \"BL-Touch\". Nivelage manuel : Calibration des but\u00e9es Z (et similaires). Maillage du lit : Correction de la hauteur du lit bas\u00e9e sur les emplacements XY. Phase de fin de course : Positionnement de la but\u00e9e Z assist\u00e9 par moteur. Compensation de la r\u00e9sonance : Un outil permettant de r\u00e9duire la r\u00e9sonance durant les impressions. Mesure des r\u00e9sonances : Informations sur l'utilisation d'un acc\u00e9l\u00e9rom\u00e8tre adxl345 pour mesurer les r\u00e9sonances. Avance \u00e0 la pression : Calibration de la pression dans l'extrudeur. G-Codes : Informations sur les instructions prises en charge par Klipper. Mod\u00e8les de commande : Macros G-Code et \u00e9valuation conditionnelle. R\u00e9f\u00e9rence des \u00e9tats : Informations disponibles pour les macros (et similaires). Pilotes TMC : Utilisation des pilotes de moteurs pas \u00e0 pas Trinamic avec Klipper. Prise origine multi-MCU : Mise \u00e0 l'origine et palpage utilisant plusieurs micro-contr\u00f4leurs. Trancheurs : Configuration d'un logiciel de \"tranchage\" pour Klipper. Correction d'obliquit\u00e9 : Ajustements des axes qui ne sont pas parfaitement d'\u00e9querre. Outils PWM : Guide sur l'utilisation des outils contr\u00f4l\u00e9s par PWM tels que les lasers ou les broches. Exclusion d'objets : Le guide de l'impl\u00e9mentation de l'exclusion d'objets. Documentation pour les d\u00e9veloppeurs \u00b6 Aper\u00e7u du code : Les d\u00e9veloppeurs devraient lire ceci en premier. Cin\u00e9matiques : D\u00e9tails techniques sur la fa\u00e7on dont Klipper met en \u0153uvre les mouvements. Protocole : Informations sur le protocole de messagerie de bas niveau entre l'h\u00f4te et le microcontr\u00f4leur. API du serveur : Informations sur l'API de commande et de contr\u00f4le de Klipper. Commandes MCU : Une description des commandes de bas niveau impl\u00e9ment\u00e9es dans le logiciel du micro-contr\u00f4leur. Protocole du bus CAN : Format de messages du bus CAN de Klipper. D\u00e9bogage : Informations sur la fa\u00e7on de tester et d\u00e9boguer Klipper. Tests de charge : Informations sur la m\u00e9thode de tests de charge de Klipper. Contribuer : Comment proposer des am\u00e9liorations pour Klipper. Packaging : Informations sur la construction de paquets de syst\u00e8me d'exploitation. Documents sp\u00e9cifiques \u00e0 certains appareils \u00b6 Exemples de configurations : Informations sur l'ajout d'un exemple de fichier de configuration \u00e0 Klipper. Mises \u00e0 jour par carte SD : Flasher le micro-contr\u00f4leur en copiant un binaire sur une carte SD. Raspberry Pi en tant que micro-contr\u00f4leur : D\u00e9tails pour contr\u00f4ler les appareils connect\u00e9s aux broches GPIO d'un Raspberry Pi. Beaglebone : D\u00e9tails pour l'ex\u00e9cution de Klipper sur le SBC Beaglebone. Bootloaders : Informations pour les d\u00e9veloppeurs sur le flashage des microcontr\u00f4leurs. Bus CAN : Informations sur l'utilisation du bus CAN avec Klipper. Capteur de largeur de filament TSL1401CL D\u00e9tecteur de largeur de filament \u00e0 effet hall","title":"Vue d'ensemble"},{"location":"Overview.html#vue-densemble","text":"Bienvenue dans la documentation de Klipper. Si vous d\u00e9butez avec Klipper, commencez par les sections fonctionnalit\u00e9s et installation .","title":"Vue d'ensemble"},{"location":"Overview.html#informations-generales","text":"Fonctionnalit\u00e9s : Une liste avanc\u00e9e des fonctionnalit\u00e9s de Klipper. FAQ \u202f: Foire aux questions. Versions : L'historique des versions de Klipper. Modifications de configuration \u202f: Modifications r\u00e9centes du logiciel pouvant n\u00e9cessiter que les utilisateurs mettent \u00e0 jour la configuration de leur imprimante. Contact \u202f: Informations sur les rapports d'anomalies et communication g\u00e9n\u00e9rale avec les d\u00e9veloppeurs de Klipper.","title":"Informations g\u00e9n\u00e9rales"},{"location":"Overview.html#installation-et-configuration","text":"Installation \u202f: Guide d'installation de Klipper. R\u00e9f\u00e9rence de la configuration : Description de tous les param\u00e8tres de configuration. Distance de rotation : Calcul du param\u00e8tre rotation_distance du moteur. V\u00e9rifications de la configuration : V\u00e9rification des param\u00e8tres de base des broches du fichier de configuration. Nivelage du lit : Informations sur le \"nivelage du lit\" dans Klipper. Calibration delta : Calibration de la cin\u00e9matique Delta. Calibration de la sonde : Calibration automatique des sondes Z. BL-Touch : Configuration d'une sonde \"BL-Touch\". Nivelage manuel : Calibration des but\u00e9es Z (et similaires). Maillage du lit : Correction de la hauteur du lit bas\u00e9e sur les emplacements XY. Phase de fin de course : Positionnement de la but\u00e9e Z assist\u00e9 par moteur. Compensation de la r\u00e9sonance : Un outil permettant de r\u00e9duire la r\u00e9sonance durant les impressions. Mesure des r\u00e9sonances : Informations sur l'utilisation d'un acc\u00e9l\u00e9rom\u00e8tre adxl345 pour mesurer les r\u00e9sonances. Avance \u00e0 la pression : Calibration de la pression dans l'extrudeur. G-Codes : Informations sur les instructions prises en charge par Klipper. Mod\u00e8les de commande : Macros G-Code et \u00e9valuation conditionnelle. R\u00e9f\u00e9rence des \u00e9tats : Informations disponibles pour les macros (et similaires). Pilotes TMC : Utilisation des pilotes de moteurs pas \u00e0 pas Trinamic avec Klipper. Prise origine multi-MCU : Mise \u00e0 l'origine et palpage utilisant plusieurs micro-contr\u00f4leurs. Trancheurs : Configuration d'un logiciel de \"tranchage\" pour Klipper. Correction d'obliquit\u00e9 : Ajustements des axes qui ne sont pas parfaitement d'\u00e9querre. Outils PWM : Guide sur l'utilisation des outils contr\u00f4l\u00e9s par PWM tels que les lasers ou les broches. Exclusion d'objets : Le guide de l'impl\u00e9mentation de l'exclusion d'objets.","title":"Installation et configuration"},{"location":"Overview.html#documentation-pour-les-developpeurs","text":"Aper\u00e7u du code : Les d\u00e9veloppeurs devraient lire ceci en premier. Cin\u00e9matiques : D\u00e9tails techniques sur la fa\u00e7on dont Klipper met en \u0153uvre les mouvements. Protocole : Informations sur le protocole de messagerie de bas niveau entre l'h\u00f4te et le microcontr\u00f4leur. API du serveur : Informations sur l'API de commande et de contr\u00f4le de Klipper. Commandes MCU : Une description des commandes de bas niveau impl\u00e9ment\u00e9es dans le logiciel du micro-contr\u00f4leur. Protocole du bus CAN : Format de messages du bus CAN de Klipper. D\u00e9bogage : Informations sur la fa\u00e7on de tester et d\u00e9boguer Klipper. Tests de charge : Informations sur la m\u00e9thode de tests de charge de Klipper. Contribuer : Comment proposer des am\u00e9liorations pour Klipper. Packaging : Informations sur la construction de paquets de syst\u00e8me d'exploitation.","title":"Documentation pour les d\u00e9veloppeurs"},{"location":"Overview.html#documents-specifiques-a-certains-appareils","text":"Exemples de configurations : Informations sur l'ajout d'un exemple de fichier de configuration \u00e0 Klipper. Mises \u00e0 jour par carte SD : Flasher le micro-contr\u00f4leur en copiant un binaire sur une carte SD. Raspberry Pi en tant que micro-contr\u00f4leur : D\u00e9tails pour contr\u00f4ler les appareils connect\u00e9s aux broches GPIO d'un Raspberry Pi. Beaglebone : D\u00e9tails pour l'ex\u00e9cution de Klipper sur le SBC Beaglebone. Bootloaders : Informations pour les d\u00e9veloppeurs sur le flashage des microcontr\u00f4leurs. Bus CAN : Informations sur l'utilisation du bus CAN avec Klipper. Capteur de largeur de filament TSL1401CL D\u00e9tecteur de largeur de filament \u00e0 effet hall","title":"Documents sp\u00e9cifiques \u00e0 certains appareils"},{"location":"Packaging.html","text":"Packager Klipper \u00b6 Klipper est en quelque sorte comme une anomalie de packaging au sein des programmes Python, car il ne requiert pas d'outils de configuration pour \u00eatre construit et install\u00e9. Quelques notes en ce qui concerne comment package au mieux sont : Modules C \u00b6 Klipper utilise un module en langage C pour g\u00e9rer plus rapidement certains calculs cin\u00e9matiques. Ce module doit \u00eatre compil\u00e9 au moment de l'empaquetage pour \u00e9viter d'introduire une d\u00e9pendance d'ex\u00e9cution sur un compilateur. Pour compiler le module C, ex\u00e9cutez python2 klippy/chelper/__init__.py . Compiler du code python \u00b6 De nombreuses distributions compilent tout le code python avant de l'empaqueter pour am\u00e9liorer le temps de d\u00e9marrage. Vous pouvez le faire en ex\u00e9cutant python2 -m compileall klippy . Versionnage \u00b6 Si vous construisez un paquet de Klipper \u00e0 partir de git, il est d'usage de ne pas envoyer de r\u00e9pertoire .git, donc la gestion des versions doit \u00eatre g\u00e9r\u00e9e sans git. Pour ce faire, utilisez le script fourni dans scripts/make_version.py qui doit \u00eatre ex\u00e9cut\u00e9 comme suit : python2 scripts/make_version.py YOURDISTRONAME > klippy/.version . Exemple de script de pr\u00e9compilation \u00b6 klipper-git is packaged for Arch Linux, and has a PKGBUILD (package build script) available at Arch User Repositiory .","title":"Packager Klipper"},{"location":"Packaging.html#packager-klipper","text":"Klipper est en quelque sorte comme une anomalie de packaging au sein des programmes Python, car il ne requiert pas d'outils de configuration pour \u00eatre construit et install\u00e9. Quelques notes en ce qui concerne comment package au mieux sont :","title":"Packager Klipper"},{"location":"Packaging.html#modules-c","text":"Klipper utilise un module en langage C pour g\u00e9rer plus rapidement certains calculs cin\u00e9matiques. Ce module doit \u00eatre compil\u00e9 au moment de l'empaquetage pour \u00e9viter d'introduire une d\u00e9pendance d'ex\u00e9cution sur un compilateur. Pour compiler le module C, ex\u00e9cutez python2 klippy/chelper/__init__.py .","title":"Modules C"},{"location":"Packaging.html#compiler-du-code-python","text":"De nombreuses distributions compilent tout le code python avant de l'empaqueter pour am\u00e9liorer le temps de d\u00e9marrage. Vous pouvez le faire en ex\u00e9cutant python2 -m compileall klippy .","title":"Compiler du code python"},{"location":"Packaging.html#versionnage","text":"Si vous construisez un paquet de Klipper \u00e0 partir de git, il est d'usage de ne pas envoyer de r\u00e9pertoire .git, donc la gestion des versions doit \u00eatre g\u00e9r\u00e9e sans git. Pour ce faire, utilisez le script fourni dans scripts/make_version.py qui doit \u00eatre ex\u00e9cut\u00e9 comme suit : python2 scripts/make_version.py YOURDISTRONAME > klippy/.version .","title":"Versionnage"},{"location":"Packaging.html#exemple-de-script-de-precompilation","text":"klipper-git is packaged for Arch Linux, and has a PKGBUILD (package build script) available at Arch User Repositiory .","title":"Exemple de script de pr\u00e9compilation"},{"location":"Pressure_Advance.html","text":"Avance \u00e0 la pression \u00b6 Ce document fournit des informations sur les r\u00e9glages de la variable \"pressure advance\" pour une buse et un filament donn\u00e9. La fonctionnalit\u00e9 pressure advance peut aider \u00e0 r\u00e9duire le suintement. Pour plus d'informations sur l'impl\u00e9mentation du pressure advance, vous pouvez lire le document kinematics . R\u00e9glage du pressure advance \u00b6 Pressure advance permet deux choses importantes - r\u00e9duire le suintement pendant les d\u00e9placements sans extrusion et r\u00e9duire les bavures dans les coins. Ce guide utilise la r\u00e9duction des bavures dans les angles comme base de r\u00e9glage. Pour r\u00e9gler le pressure advance, l'imprimante doit \u00eatre configur\u00e9e et en \u00e9tat de marche le test n\u00e9cessitant une impression et une inspection de l'objet imprim\u00e9. Il est conseill\u00e9 de lire ce document en int\u00e9gralit\u00e9 avant de lancer les tests. Utilisez un trancheur pour g\u00e9n\u00e9rer le g-code du grand carr\u00e9 creux disponible dans docs/prints/square_tower.stl . Utilisez un vitesse rapide (ex 100mm/s), pas de remplissage et une hauteur de couche grossi\u00e8re (la hauteur de couche devrait \u00eatre dans les 75% du diam\u00e8tre de la buse). Pensez \u00e0 d\u00e9sactiver toutes les contr\u00f4le d'\"acc\u00e9l\u00e9ration dynamique\" dans le trancheur. Pr\u00e9parez le test en ex\u00e9cutant la commande G-Code suivante : SET_VELOCITY_LIMIT SQUARE_CORNER_VELOCITY=1 ACCEL=500 Cette commande ralentit le d\u00e9placement de la buse dans les angles pour maximiser les effets de la pression de l'extrudeur. Pour les imprimantes munies de direct drive ex\u00e9cutez cette commande : TUNING_TOWER COMMAND=SET_PRESSURE_ADVANCE PARAMETER=ADVANCE START=0 FACTOR=.005 Pour les longs extrudeurs bowden , utilisez : TUNING_TOWER COMMAND=SET_PRESSURE_ADVANCE PARAMETER=ADVANCE START=0 FACTOR=.020 Puis imprimez la pi\u00e8ce. Une fois l'impression termin\u00e9e, l'objet ressemble \u00e0 : La commande TUNING_TOWER ci-dessus demande \u00e0 Klipper de modifier le param\u00e8tre pressure_advance apr\u00e8s chaque couche de l'impression. Les couches sup\u00e9rieures de l'impression auront une valeur de pressure_advance plus \u00e9lev\u00e9e. Les couches en dessous du r\u00e9glage de pressure_advance optimal auront des bavures dans les angles et celles au-dessus du r\u00e9glage id\u00e9ale pourront avoir des coins arrondis ou une mauvaise extrusion dans les angles. Vous pouvez arr\u00eater l'impression si vous observez que les angles ne s'impriment plus correctement. (cela permet d'\u00e9viter d'imprimer les couches qui sont au-dessus de la valeur id\u00e9ale pour le pressure_advance). Inspectez l'impression et utilisez un pied \u00e0 coulisse digital pour trouver la hauteur \u00e0 laquelle les angles sont de bonne qualit\u00e9. En cas de doute, choisissez une hauteur inf\u00e9rieure. La valeur du pressure_advance peut \u00eatre calcul\u00e9e de la mani\u00e8re suivante pressure_advance = <d\u00e9but> + <hauteur_mesur\u00e9e> * <facteur> . (Par exemple, 0 + 12.90 *0 .020 donnera 0.258 .) Il est possible de choisir des valeurs personnalis\u00e9es pour START et FACTOR si cela permet d'identifier le meilleur r\u00e9glage de pressure advance. Si vous utilisez des valeurs personnalis\u00e9es, assurez-vous d'envoyer la commande TUNING_TOWER au d\u00e9but de chaque impression. Les valeurs d\u2019avance de pression moyennes se situent entre 0,050 et 1,000 (le haut de la fourchette est g\u00e9n\u00e9ralement pour les extrudeurs Bowden). S\u2019il n\u2019y a pas d\u2019am\u00e9lioration significative avec une avance de pression jusqu\u2019\u00e0 1.000, il est peu probable que l\u2019avance de pression am\u00e9liore la qualit\u00e9 des impressions. Revenez \u00e0 une configuration par d\u00e9faut avec l\u2019avance de pression d\u00e9sactiv\u00e9e. Bien que cet exercice de r\u00e9glage am\u00e9liore directement la qualit\u00e9 des coins, il convient de rappeler qu\u2019une bonne configuration d\u2019avance de pression r\u00e9duit \u00e9galement le suintement tout au long de l\u2019impression. \u00c0 la fin de ce test, d\u00e9finissez pressure_advance = <calculated_value> dans la section [extruder]` du fichier de configuration et ex\u00e9cutez une commande RESTART. La commande RESTART effacera l\u2019\u00e9tat de test et r\u00e9tablira les param\u00e8tres de vitesse \u00e0 leur valeurs normales. Informations importantes \u00b6 La valeur d\u2019avance de pression d\u00e9pend de l\u2019extrudeur, de la buse et du filament. Il est courant que les filaments de diff\u00e9rents fabricants ou avec diff\u00e9rents pigments n\u00e9cessitent des valeurs d\u2019avance de pression significativement diff\u00e9rentes. Par cons\u00e9quent, il faut calibrer l\u2019avance de pression sur chaque imprimante et avec chaque bobine de filament. La temp\u00e9rature d\u2019impression et les taux d\u2019extrusion peuvent avoir un impact sur l\u2019avancement de la pression. Assurez-vous de r\u00e9gler la rotation_distance de l'extrudeur et temp\u00e9rature de la buse avant de r\u00e9gler l'avance de pression. L\u2019impression de test est con\u00e7ue pour fonctionner avec un d\u00e9bit d\u2019extrudeur \u00e9lev\u00e9, mais avec des r\u00e9glages de trancheur \u00ab normaux \u00bb. Un d\u00e9bit \u00e9lev\u00e9 est obtenu en utilisant une vitesse d\u2019impression \u00e9lev\u00e9e (par exemple, 100 mm/s) et une hauteur de couche grossi\u00e8re (g\u00e9n\u00e9ralement 75% du diam\u00e8tre de la buse). Les autres param\u00e8tres du segment doivent \u00eatre similaires \u00e0 leurs valeurs par d\u00e9faut (par exemple, p\u00e9rim\u00e8tres de 2 ou 3 lignes, distance de r\u00e9traction normale). Il peut \u00eatre utile de d\u00e9finir la vitesse du p\u00e9rim\u00e8tre externe pour qu\u2019elle soit la m\u00eame que le reste de l\u2019impression, mais ce n\u2019est pas une exigence. Il est fr\u00e9quent que l\u2019impression de test montre un comportement diff\u00e9rent \u00e0 chaque coin. Souvent, le trancheur s\u2019arrange pour changer les couches dans un coin, ce qui peut entra\u00eener une diff\u00e9rence significative entre ce coin et les trois coins restants. Si cela se produit, ignorez ce coin et r\u00e9glez l\u2019avance de pression en utilisant les trois autres coins. Il est \u00e9galement courant que les coins restants varient l\u00e9g\u00e8rement. (Cela peut se produire en raison de petites diff\u00e9rences dans la fa\u00e7on dont le cadre de l\u2019imprimante r\u00e9agit aux virages dans certaines directions.) Essayez de choisir une valeur qui fonctionne bien pour tous les coins restants. En cas de doute, pr\u00e9f\u00e9rez une valeur d\u2019avance de pression inf\u00e9rieure. Si une valeur d'avance de pression \u00e9lev\u00e9e (par exemple sup\u00e9rieure \u00e0 0,200) est utilis\u00e9e, il est possible que l'extrudeur saute lors du retour \u00e0 l'acc\u00e9l\u00e9ration normale de l'imprimante. Le syst\u00e8me d'avance de pression tient compte de la pression en poussant un peu plus de filament pendant l'acc\u00e9l\u00e9ration et en r\u00e9tractant ce filament pendant la d\u00e9c\u00e9l\u00e9ration. Avec une acc\u00e9l\u00e9ration \u00e9lev\u00e9e et une avance \u00e0 haute pression, l'extrudeur peut ne pas avoir assez de couple pour pousser la quantit\u00e9 de filament requise. Si cela se produit, utilisez une valeur d'acc\u00e9l\u00e9ration inf\u00e9rieure ou d\u00e9sactivez l'avance de pression. Une fois que l'avance de pression est r\u00e9gl\u00e9e dans Klipper, il peut toujours \u00eatre utile de configurer une petite valeur de r\u00e9traction dans le trancheur (par exemple, 0,75 mm) et d'utiliser l'option \"essuyer lors de la r\u00e9traction\" du trancheur si elle est disponible. Ces r\u00e9glages du trancheur peuvent aider \u00e0 contrecarrer le suintement caus\u00e9 par la coh\u00e9sion du filament (filament retir\u00e9 de la buse en raison de l'adh\u00e9rence du plastique). Il est recommand\u00e9 de d\u00e9sactiver l'option \"relever le Z lors de la r\u00e9traction\" du trancheur. Le syst\u00e8me d'avance de pression ne modifie pas la synchronisation ou la trajectoire de la t\u00eate. Une impression avec l'avance de pression activ\u00e9e prendra le m\u00eame temps qu'une impression sans avance de pression. L'avance de pression ne modifie pas non plus la quantit\u00e9 totale de filament extrud\u00e9 lors d'une impression. L'avance de pression entra\u00eene un mouvement suppl\u00e9mentaire de l'extrudeur pendant l'acc\u00e9l\u00e9ration et la d\u00e9c\u00e9l\u00e9ration du mouvement. Un r\u00e9glage d'avance de pression tr\u00e8s \u00e9lev\u00e9 entra\u00eenera une tr\u00e8s grande quantit\u00e9 de mouvement de l'extrudeur pendant l'acc\u00e9l\u00e9ration et la d\u00e9c\u00e9l\u00e9ration, et aucun r\u00e9glage de configuration ne limite la quantit\u00e9 de ce mouvement.","title":"Avance \u00e0 la pression"},{"location":"Pressure_Advance.html#avance-a-la-pression","text":"Ce document fournit des informations sur les r\u00e9glages de la variable \"pressure advance\" pour une buse et un filament donn\u00e9. La fonctionnalit\u00e9 pressure advance peut aider \u00e0 r\u00e9duire le suintement. Pour plus d'informations sur l'impl\u00e9mentation du pressure advance, vous pouvez lire le document kinematics .","title":"Avance \u00e0 la pression"},{"location":"Pressure_Advance.html#reglage-du-pressure-advance","text":"Pressure advance permet deux choses importantes - r\u00e9duire le suintement pendant les d\u00e9placements sans extrusion et r\u00e9duire les bavures dans les coins. Ce guide utilise la r\u00e9duction des bavures dans les angles comme base de r\u00e9glage. Pour r\u00e9gler le pressure advance, l'imprimante doit \u00eatre configur\u00e9e et en \u00e9tat de marche le test n\u00e9cessitant une impression et une inspection de l'objet imprim\u00e9. Il est conseill\u00e9 de lire ce document en int\u00e9gralit\u00e9 avant de lancer les tests. Utilisez un trancheur pour g\u00e9n\u00e9rer le g-code du grand carr\u00e9 creux disponible dans docs/prints/square_tower.stl . Utilisez un vitesse rapide (ex 100mm/s), pas de remplissage et une hauteur de couche grossi\u00e8re (la hauteur de couche devrait \u00eatre dans les 75% du diam\u00e8tre de la buse). Pensez \u00e0 d\u00e9sactiver toutes les contr\u00f4le d'\"acc\u00e9l\u00e9ration dynamique\" dans le trancheur. Pr\u00e9parez le test en ex\u00e9cutant la commande G-Code suivante : SET_VELOCITY_LIMIT SQUARE_CORNER_VELOCITY=1 ACCEL=500 Cette commande ralentit le d\u00e9placement de la buse dans les angles pour maximiser les effets de la pression de l'extrudeur. Pour les imprimantes munies de direct drive ex\u00e9cutez cette commande : TUNING_TOWER COMMAND=SET_PRESSURE_ADVANCE PARAMETER=ADVANCE START=0 FACTOR=.005 Pour les longs extrudeurs bowden , utilisez : TUNING_TOWER COMMAND=SET_PRESSURE_ADVANCE PARAMETER=ADVANCE START=0 FACTOR=.020 Puis imprimez la pi\u00e8ce. Une fois l'impression termin\u00e9e, l'objet ressemble \u00e0 : La commande TUNING_TOWER ci-dessus demande \u00e0 Klipper de modifier le param\u00e8tre pressure_advance apr\u00e8s chaque couche de l'impression. Les couches sup\u00e9rieures de l'impression auront une valeur de pressure_advance plus \u00e9lev\u00e9e. Les couches en dessous du r\u00e9glage de pressure_advance optimal auront des bavures dans les angles et celles au-dessus du r\u00e9glage id\u00e9ale pourront avoir des coins arrondis ou une mauvaise extrusion dans les angles. Vous pouvez arr\u00eater l'impression si vous observez que les angles ne s'impriment plus correctement. (cela permet d'\u00e9viter d'imprimer les couches qui sont au-dessus de la valeur id\u00e9ale pour le pressure_advance). Inspectez l'impression et utilisez un pied \u00e0 coulisse digital pour trouver la hauteur \u00e0 laquelle les angles sont de bonne qualit\u00e9. En cas de doute, choisissez une hauteur inf\u00e9rieure. La valeur du pressure_advance peut \u00eatre calcul\u00e9e de la mani\u00e8re suivante pressure_advance = <d\u00e9but> + <hauteur_mesur\u00e9e> * <facteur> . (Par exemple, 0 + 12.90 *0 .020 donnera 0.258 .) Il est possible de choisir des valeurs personnalis\u00e9es pour START et FACTOR si cela permet d'identifier le meilleur r\u00e9glage de pressure advance. Si vous utilisez des valeurs personnalis\u00e9es, assurez-vous d'envoyer la commande TUNING_TOWER au d\u00e9but de chaque impression. Les valeurs d\u2019avance de pression moyennes se situent entre 0,050 et 1,000 (le haut de la fourchette est g\u00e9n\u00e9ralement pour les extrudeurs Bowden). S\u2019il n\u2019y a pas d\u2019am\u00e9lioration significative avec une avance de pression jusqu\u2019\u00e0 1.000, il est peu probable que l\u2019avance de pression am\u00e9liore la qualit\u00e9 des impressions. Revenez \u00e0 une configuration par d\u00e9faut avec l\u2019avance de pression d\u00e9sactiv\u00e9e. Bien que cet exercice de r\u00e9glage am\u00e9liore directement la qualit\u00e9 des coins, il convient de rappeler qu\u2019une bonne configuration d\u2019avance de pression r\u00e9duit \u00e9galement le suintement tout au long de l\u2019impression. \u00c0 la fin de ce test, d\u00e9finissez pressure_advance = <calculated_value> dans la section [extruder]` du fichier de configuration et ex\u00e9cutez une commande RESTART. La commande RESTART effacera l\u2019\u00e9tat de test et r\u00e9tablira les param\u00e8tres de vitesse \u00e0 leur valeurs normales.","title":"R\u00e9glage du pressure advance"},{"location":"Pressure_Advance.html#informations-importantes","text":"La valeur d\u2019avance de pression d\u00e9pend de l\u2019extrudeur, de la buse et du filament. Il est courant que les filaments de diff\u00e9rents fabricants ou avec diff\u00e9rents pigments n\u00e9cessitent des valeurs d\u2019avance de pression significativement diff\u00e9rentes. Par cons\u00e9quent, il faut calibrer l\u2019avance de pression sur chaque imprimante et avec chaque bobine de filament. La temp\u00e9rature d\u2019impression et les taux d\u2019extrusion peuvent avoir un impact sur l\u2019avancement de la pression. Assurez-vous de r\u00e9gler la rotation_distance de l'extrudeur et temp\u00e9rature de la buse avant de r\u00e9gler l'avance de pression. L\u2019impression de test est con\u00e7ue pour fonctionner avec un d\u00e9bit d\u2019extrudeur \u00e9lev\u00e9, mais avec des r\u00e9glages de trancheur \u00ab normaux \u00bb. Un d\u00e9bit \u00e9lev\u00e9 est obtenu en utilisant une vitesse d\u2019impression \u00e9lev\u00e9e (par exemple, 100 mm/s) et une hauteur de couche grossi\u00e8re (g\u00e9n\u00e9ralement 75% du diam\u00e8tre de la buse). Les autres param\u00e8tres du segment doivent \u00eatre similaires \u00e0 leurs valeurs par d\u00e9faut (par exemple, p\u00e9rim\u00e8tres de 2 ou 3 lignes, distance de r\u00e9traction normale). Il peut \u00eatre utile de d\u00e9finir la vitesse du p\u00e9rim\u00e8tre externe pour qu\u2019elle soit la m\u00eame que le reste de l\u2019impression, mais ce n\u2019est pas une exigence. Il est fr\u00e9quent que l\u2019impression de test montre un comportement diff\u00e9rent \u00e0 chaque coin. Souvent, le trancheur s\u2019arrange pour changer les couches dans un coin, ce qui peut entra\u00eener une diff\u00e9rence significative entre ce coin et les trois coins restants. Si cela se produit, ignorez ce coin et r\u00e9glez l\u2019avance de pression en utilisant les trois autres coins. Il est \u00e9galement courant que les coins restants varient l\u00e9g\u00e8rement. (Cela peut se produire en raison de petites diff\u00e9rences dans la fa\u00e7on dont le cadre de l\u2019imprimante r\u00e9agit aux virages dans certaines directions.) Essayez de choisir une valeur qui fonctionne bien pour tous les coins restants. En cas de doute, pr\u00e9f\u00e9rez une valeur d\u2019avance de pression inf\u00e9rieure. Si une valeur d'avance de pression \u00e9lev\u00e9e (par exemple sup\u00e9rieure \u00e0 0,200) est utilis\u00e9e, il est possible que l'extrudeur saute lors du retour \u00e0 l'acc\u00e9l\u00e9ration normale de l'imprimante. Le syst\u00e8me d'avance de pression tient compte de la pression en poussant un peu plus de filament pendant l'acc\u00e9l\u00e9ration et en r\u00e9tractant ce filament pendant la d\u00e9c\u00e9l\u00e9ration. Avec une acc\u00e9l\u00e9ration \u00e9lev\u00e9e et une avance \u00e0 haute pression, l'extrudeur peut ne pas avoir assez de couple pour pousser la quantit\u00e9 de filament requise. Si cela se produit, utilisez une valeur d'acc\u00e9l\u00e9ration inf\u00e9rieure ou d\u00e9sactivez l'avance de pression. Une fois que l'avance de pression est r\u00e9gl\u00e9e dans Klipper, il peut toujours \u00eatre utile de configurer une petite valeur de r\u00e9traction dans le trancheur (par exemple, 0,75 mm) et d'utiliser l'option \"essuyer lors de la r\u00e9traction\" du trancheur si elle est disponible. Ces r\u00e9glages du trancheur peuvent aider \u00e0 contrecarrer le suintement caus\u00e9 par la coh\u00e9sion du filament (filament retir\u00e9 de la buse en raison de l'adh\u00e9rence du plastique). Il est recommand\u00e9 de d\u00e9sactiver l'option \"relever le Z lors de la r\u00e9traction\" du trancheur. Le syst\u00e8me d'avance de pression ne modifie pas la synchronisation ou la trajectoire de la t\u00eate. Une impression avec l'avance de pression activ\u00e9e prendra le m\u00eame temps qu'une impression sans avance de pression. L'avance de pression ne modifie pas non plus la quantit\u00e9 totale de filament extrud\u00e9 lors d'une impression. L'avance de pression entra\u00eene un mouvement suppl\u00e9mentaire de l'extrudeur pendant l'acc\u00e9l\u00e9ration et la d\u00e9c\u00e9l\u00e9ration du mouvement. Un r\u00e9glage d'avance de pression tr\u00e8s \u00e9lev\u00e9 entra\u00eenera une tr\u00e8s grande quantit\u00e9 de mouvement de l'extrudeur pendant l'acc\u00e9l\u00e9ration et la d\u00e9c\u00e9l\u00e9ration, et aucun r\u00e9glage de configuration ne limite la quantit\u00e9 de ce mouvement.","title":"Informations importantes"},{"location":"Probe_Calibrate.html","text":"\u00c9talonnage de la sonde \u00b6 Ce document d\u00e9crit la m\u00e9thode de r\u00e9glage des d\u00e9calages X, Y et Z d'une \"sonde z automatique\" dans Klipper. Ceci est utile pour les utilisateurs qui ont une section [probe] ou [bltouch] dans leur fichier de configuration. \u00c9talonnage des d\u00e9calages X et Y de la sonde \u00b6 Pour calibrer le d\u00e9calage X et Y, acc\u00e9dez \u00e0 l'onglet \"Contr\u00f4le\" d'OctoPrint, placez l'imprimante \u00e0 l'origine, puis utilisez les fl\u00e8ches de d\u00e9placement pour amener la t\u00eate vers une position proche du centre du lit. Placez un morceau de ruban adh\u00e9sif bleu (ou similaire) sur le lit sous la sonde. Acc\u00e9dez \u00e0 l'onglet \"Terminal\" d'OctoPrint et lancez une commande PROBE : SONDE Placez une marque sur le ruban directement sous l'endroit o\u00f9 se trouve la sonde (ou utilisez une m\u00e9thode similaire pour noter l'emplacement sur le lit). Ex\u00e9cutez une commande GET_POSITION et enregistrez l'emplacement XY de la t\u00eate d'outil signal\u00e9 par cette commande. Par exemple si l'on voit : Recv: // toolhead: X:46.500000 Y:27.000000 Z:15.000000 E:0.000000 La position d l a sonde serait de 46,5 en X et de 27 en Y. Apr\u00e8s avoir enregistr\u00e9 la position de la sonde, lancez une s\u00e9rie de commandes G1 jusqu'\u00e0 ce que la buse soit directement au-dessus de la marque sur le lit. Par exemple, on pourrait lancer : G1 F300 X57 Y30 Z15 pour d\u00e9placer la buse vers une position X de 57 et Y de 30. Une fois que l'on a trouv\u00e9 la position directement au-dessus de la marque, utilisez la commande GET_POSITION pour afficher cette position. C'est la position de la buse. Le x_offset est alors la nozzle_x_position - probe_x_position et y_offset est de m\u00eame la nozzle_y_position - probe_y_position . Mettez \u00e0 jour le fichier printer.cfg avec les valeurs donn\u00e9es, retirez la bande/les marques du lit, puis \u00e9mettez une commande RESTART afin que les nouvelles valeurs prennent effet. \u00c9talonnage de l'offset Z de la sonde \u00b6 Avoir un z offset pr\u00e9cis est essentiel pour obtenir des impressions de haute qualit\u00e9. Le z_offset est la distance entre la buse et le lit lorsque la sonde se d\u00e9clenche. L'outil Klipper PROBE_CALIBRATE peut \u00eatre utilis\u00e9 pour obtenir cette valeur - il ex\u00e9cutera un sondage automatique pour mesurer la position de d\u00e9clenchement Z de la sonde, puis d\u00e9marrera un sondage manuel pour obtenir la hauteur Z de la buse. Le z_offset sera alors calcul\u00e9e \u00e0 partir de ces mesures. Commencez par mettre l'imprimante \u00e0 l'origine, puis d\u00e9placez la t\u00eate vers une position proche du centre du lit. Acc\u00e9dez \u00e0 l'onglet du terminal OctoPrint et ex\u00e9cutez la commande PROBE_CALIBRATE pour d\u00e9marrer l'outil. Cet outil effectuera un sondage automatique, puis soul\u00e8vera la t\u00eate, d\u00e9placera la buse sur l'emplacement du point de sonde et d\u00e9marrera l'outil de sondage manuel. Si la buse ne se d\u00e9place pas vers une position au-dessus du point de sonde automatique, tapez ABORT pour annuler le sondage manuel et effectuez l'\u00e9talonnage de d\u00e9calage de sonde XY d\u00e9crit ci-dessus. Une fois que l'outil de sondage manuel d\u00e9marre, suivez les \u00e9tapes d\u00e9crites dans \"le test du papier\" ) pour d\u00e9terminer la distance r\u00e9elle entre la buse et le lit \u00e0 l'emplacement donn\u00e9. Une fois ces \u00e9tapes termin\u00e9es, vous pouvez taper ACCEPT pour enregistrer les r\u00e9sultats dans le fichier de configuration avec : SAVE_CONFIG Notez que si une modification est apport\u00e9e au syst\u00e8me de mouvement de l'imprimante, \u00e0 la position de la hotend ou \u00e0 l'emplacement de la sonde, cela invalidera les r\u00e9sultats de PROBE_CALIBRATE. Si la sonde a un d\u00e9calage X ou Y et que l'inclinaison du lit est modifi\u00e9e (par exemple, en ajustant les vis du lit, en ex\u00e9cutant DELTA_CALIBRATE, en ex\u00e9cutant Z_TILT_ADJUST, en ex\u00e9cutant QUAD_GANTRY_LEVEL, ou similaire), les r\u00e9sultats de PROBE_CALIBRATE seront invalid\u00e9s. Apr\u00e8s avoir effectu\u00e9 l'un des ajustements ci-dessus, il sera n\u00e9cessaire d'ex\u00e9cuter \u00e0 nouveau PROBE_CALIBRATE. Si les r\u00e9sultats de PROBE_CALIBRATE sont invalid\u00e9s, tous les r\u00e9sultats pr\u00e9c\u00e9dents bed mesh qui ont \u00e9t\u00e9 obtenus \u00e0 l'aide de la sonde sont \u00e9galement invalid\u00e9s - il sera n\u00e9cessaire de r\u00e9ex\u00e9cuter BED_MESH_CALIBRATE apr\u00e8s avoir recalibr\u00e9 la sonde. Contr\u00f4le de r\u00e9p\u00e9tabilit\u00e9 \u00b6 Apr\u00e8s avoir calibr\u00e9 les d\u00e9calages X, Y et Z de la sonde, il est conseill\u00e9 de v\u00e9rifier que la sonde fournit des r\u00e9sultats reproductibles. Commencez par mettre l'imprimante \u00e0 l'origine, puis d\u00e9placez la t\u00eate vers une position proche du centre du lit. Acc\u00e9dez \u00e0 l'onglet du terminal OctoPrint et ex\u00e9cutez la commande PROBE_ACCURACY . Cette commande ex\u00e9cutera le sondage dix fois et produira une sortie semblable \u00e0 la suivante : Recv: // probe accuracy: at X:0.000 Y:0.000 Z:10.000 Recv: // and read 10 times with speed of 5 mm/s Recv: // probe at -0.003,0.005 is z=2.506948 Recv: // probe at -0.003,0.005 is z=2.519448 Recv: // probe at -0.003,0.005 is z=2.519448 Recv: // probe at -0.003,0.005 is z=2.506948 Recv: // probe at -0.003,0.005 is z=2.519448 Recv: // probe at -0.003,0.005 is z=2.519448 Recv: // probe at -0.003,0.005 is z=2.506948 Recv: // probe at -0.003,0.005 is z=2.506948 Recv: // probe at -0.003,0.005 is z=2.519448 Recv: // probe at -0.003,0.005 is z=2.506948 Recv: // probe accuracy results: maximum 2.519448, minimum 2.506948, range 0.012500, average 2.513198, median 2.513198, standard deviation 0.006250 Id\u00e9alement, l'outil rapportera une valeur maximale et minimale identique. (C'est-\u00e0-dire que, id\u00e9alement, la sonde obtient un r\u00e9sultat identique sur les dix sondes.) Cependant, il est normal que les valeurs minimale et maximale diff\u00e8rent d'une \"distance de pas\" Z ou jusqu'\u00e0 5 microns (0,005 mm). Une \"distance de pas\" est distance_rotation/(full_steps_per_rotation*microsteps) . La distance entre la valeur minimale et la valeur maximale s'appelle la plage. Ainsi, dans l'exemple ci-dessus, \u00e9tant donn\u00e9 que l'imprimante utilise une distance de pas Z de 0,0125, une plage de 0,012500 serait consid\u00e9r\u00e9e comme normale. Si les r\u00e9sultats du test indiquent une plage de valeur sup\u00e9rieure \u00e0 25 microns (0,025 mm), la sonde n'a pas une pr\u00e9cision suffisante pour les proc\u00e9dures de nivellement de lit typiques. Il peut \u00eatre possible de r\u00e9gler la vitesse de la sonde et/ou la hauteur de d\u00e9part de la sonde pour am\u00e9liorer la r\u00e9p\u00e9tabilit\u00e9 de la sonde. La commande PROBE_ACCURACY permet d'ex\u00e9cuter des tests avec diff\u00e9rents param\u00e8tres pour voir leur impact - voir le document G-Codes pour plus de d\u00e9tails. Si la sonde obtient g\u00e9n\u00e9ralement des r\u00e9sultats reproductibles mais pr\u00e9sente une valeur aberrante occasionnelle, il peut \u00eatre possible d'en tenir compte en utilisant plusieurs \u00e9chantillons sur chaque sonde - lisez la description des param\u00e8tres de configuration de la sonde samples dans la r\u00e9f\u00e9rence de configuration pour plus de d\u00e9tails. Si une nouvelle vitesse de sondage, un nouveau nombre d'\u00e9chantillons ou d'autres param\u00e8tres sont n\u00e9cessaires, mettez \u00e0 jour le fichier printer.cfg et lancez une commande RESTART . Si c'est le cas, c'est une bonne id\u00e9e de calibrer le z_offset \u00e0 nouveau. Si des r\u00e9sultats reproductibles ne peuvent pas \u00eatre obtenus, n'utilisez pas la sonde pour le nivellement du lit. Klipper dispose de plusieurs outils de sondage manuels qui peuvent \u00eatre utilis\u00e9s \u00e0 la place - voir le Mise \u00e0 niveau du lit pour plus de d\u00e9tails. V\u00e9rification des erreurs de localisation \u00b6 Certaines sondes peuvent avoir une erreur syst\u00e9mique qui corrompt les r\u00e9sultats de la sonde \u00e0 certains emplacements de la t\u00eate d'outil. Par exemple, si le support de la sonde s'incline l\u00e9g\u00e8rement lorsqu'il se d\u00e9place le long de l'axe Y, la sonde peut alors signaler des r\u00e9sultats fauss\u00e9s \u00e0 diff\u00e9rentes positions Y. Il s'agit d'un probl\u00e8me courant avec les sondes sur les imprimantes delta, mais il peut se produire sur toutes les imprimantes. On peut v\u00e9rifier une erreur d'emplacement en utilisant la commande PROBE_CALIBRATE pour mesurer le d\u00e9calage z_offset de la sonde \u00e0 divers emplacements X et Y. Id\u00e9alement, le z_offset serait une valeur constante \u00e0 chaque emplacement d'imprimante. Pour les imprimantes delta, essayez de mesurer le z_offset \u00e0 une position proche de la tour A, \u00e0 une position proche de la tour B et \u00e0 une position proche de la tour C. Pour les imprimantes cart\u00e9siennes, corexy et similaires, essayez de mesurer le z_offset \u00e0 des positions proches des quatre coins du lit. Avant de commencer ce test, calibrez d'abord les d\u00e9calages X, Y et Z de la sonde comme d\u00e9crit au d\u00e9but de ce document. Remettez ensuite l'imprimante \u00e0 l'origine et naviguez jusqu'\u00e0 la premi\u00e8re position XY. Suivez les \u00e9tapes de calibrer le d\u00e9calage en Z de la sonde en ex\u00e9cutant la commande PROBE_CALIBRATE , les commandes TESTZ et la commande ACCEPT . , mais n'ex\u00e9cutez pas SAVE_CONFIG . Notez le rapport z_offset trouv\u00e9. Naviguez ensuite vers les autres positions XY, r\u00e9p\u00e9tez ces \u00e9tapes PROBE_CALIBRATE et notez le d\u00e9calage z signal\u00e9. Si la diff\u00e9rence entre le d\u00e9calage z_offset minimum signal\u00e9 et le d\u00e9calage z_maximum signal\u00e9 est sup\u00e9rieure \u00e0 25 microns (0,025 mm), la sonde n'est pas adapt\u00e9e aux proc\u00e9dures de nivellement de lit typiques. Voir le document mise \u00e0 niveau du lit pour les alternatives de sonde manuelle. Erreurs de temp\u00e9rature \u00b6 De nombreuses sondes ont une erreur syst\u00e9mique lorsqu'elles sondent \u00e0 diff\u00e9rentes temp\u00e9ratures. Par exemple, la sonde peut se d\u00e9clencher syst\u00e9matiquement \u00e0 une hauteur inf\u00e9rieure lorsque la sonde est \u00e0 une temp\u00e9rature plus \u00e9lev\u00e9e. Il est recommand\u00e9 de faire fonctionner les outils de nivellement du lit \u00e0 une temp\u00e9rature constante pour tenir compte de cette erreur. Par exemple, ex\u00e9cutez toujours les outils lorsque l'imprimante est \u00e0 temp\u00e9rature ambiante ou ex\u00e9cutez toujours les outils une fois que l'imprimante a obtenu une temp\u00e9rature d'impression constante. Dans les deux cas, c'est une bonne id\u00e9e d'attendre plusieurs minutes apr\u00e8s que la temp\u00e9rature souhait\u00e9e est atteinte, de sorte que l'appareil d'impression soit constamment \u00e0 la temp\u00e9rature souhait\u00e9e. Pour v\u00e9rifier une erreur de temp\u00e9rature, commencez avec l'imprimante \u00e0 temp\u00e9rature ambiante, puis mettez l'imprimante \u00e0 l'origine, d\u00e9placez la t\u00eate vers une position proche du centre du lit et ex\u00e9cutez la commande PROBE_ACCURACY . Notez les r\u00e9sultats. Ensuite, sans mise \u00e0 l'origine ou d\u00e9sactiver les moteurs pas \u00e0 pas, chauffez la buse et le lit de l'imprimante \u00e0 la temp\u00e9rature d'impression, puis ex\u00e9cutez \u00e0 nouveau la commande PROBE_ACCURACY . Id\u00e9alement, la commande rapportera des r\u00e9sultats identiques. Comme ci-dessus, si la sonde a un d\u00e9calage en temp\u00e9rature, veillez \u00e0 toujours utiliser la sonde \u00e0 une temp\u00e9rature constante.","title":"\u00c9talonnage de la sonde"},{"location":"Probe_Calibrate.html#etalonnage-de-la-sonde","text":"Ce document d\u00e9crit la m\u00e9thode de r\u00e9glage des d\u00e9calages X, Y et Z d'une \"sonde z automatique\" dans Klipper. Ceci est utile pour les utilisateurs qui ont une section [probe] ou [bltouch] dans leur fichier de configuration.","title":"\u00c9talonnage de la sonde"},{"location":"Probe_Calibrate.html#etalonnage-des-decalages-x-et-y-de-la-sonde","text":"Pour calibrer le d\u00e9calage X et Y, acc\u00e9dez \u00e0 l'onglet \"Contr\u00f4le\" d'OctoPrint, placez l'imprimante \u00e0 l'origine, puis utilisez les fl\u00e8ches de d\u00e9placement pour amener la t\u00eate vers une position proche du centre du lit. Placez un morceau de ruban adh\u00e9sif bleu (ou similaire) sur le lit sous la sonde. Acc\u00e9dez \u00e0 l'onglet \"Terminal\" d'OctoPrint et lancez une commande PROBE : SONDE Placez une marque sur le ruban directement sous l'endroit o\u00f9 se trouve la sonde (ou utilisez une m\u00e9thode similaire pour noter l'emplacement sur le lit). Ex\u00e9cutez une commande GET_POSITION et enregistrez l'emplacement XY de la t\u00eate d'outil signal\u00e9 par cette commande. Par exemple si l'on voit : Recv: // toolhead: X:46.500000 Y:27.000000 Z:15.000000 E:0.000000 La position d l a sonde serait de 46,5 en X et de 27 en Y. Apr\u00e8s avoir enregistr\u00e9 la position de la sonde, lancez une s\u00e9rie de commandes G1 jusqu'\u00e0 ce que la buse soit directement au-dessus de la marque sur le lit. Par exemple, on pourrait lancer : G1 F300 X57 Y30 Z15 pour d\u00e9placer la buse vers une position X de 57 et Y de 30. Une fois que l'on a trouv\u00e9 la position directement au-dessus de la marque, utilisez la commande GET_POSITION pour afficher cette position. C'est la position de la buse. Le x_offset est alors la nozzle_x_position - probe_x_position et y_offset est de m\u00eame la nozzle_y_position - probe_y_position . Mettez \u00e0 jour le fichier printer.cfg avec les valeurs donn\u00e9es, retirez la bande/les marques du lit, puis \u00e9mettez une commande RESTART afin que les nouvelles valeurs prennent effet.","title":"\u00c9talonnage des d\u00e9calages X et Y de la sonde"},{"location":"Probe_Calibrate.html#etalonnage-de-loffset-z-de-la-sonde","text":"Avoir un z offset pr\u00e9cis est essentiel pour obtenir des impressions de haute qualit\u00e9. Le z_offset est la distance entre la buse et le lit lorsque la sonde se d\u00e9clenche. L'outil Klipper PROBE_CALIBRATE peut \u00eatre utilis\u00e9 pour obtenir cette valeur - il ex\u00e9cutera un sondage automatique pour mesurer la position de d\u00e9clenchement Z de la sonde, puis d\u00e9marrera un sondage manuel pour obtenir la hauteur Z de la buse. Le z_offset sera alors calcul\u00e9e \u00e0 partir de ces mesures. Commencez par mettre l'imprimante \u00e0 l'origine, puis d\u00e9placez la t\u00eate vers une position proche du centre du lit. Acc\u00e9dez \u00e0 l'onglet du terminal OctoPrint et ex\u00e9cutez la commande PROBE_CALIBRATE pour d\u00e9marrer l'outil. Cet outil effectuera un sondage automatique, puis soul\u00e8vera la t\u00eate, d\u00e9placera la buse sur l'emplacement du point de sonde et d\u00e9marrera l'outil de sondage manuel. Si la buse ne se d\u00e9place pas vers une position au-dessus du point de sonde automatique, tapez ABORT pour annuler le sondage manuel et effectuez l'\u00e9talonnage de d\u00e9calage de sonde XY d\u00e9crit ci-dessus. Une fois que l'outil de sondage manuel d\u00e9marre, suivez les \u00e9tapes d\u00e9crites dans \"le test du papier\" ) pour d\u00e9terminer la distance r\u00e9elle entre la buse et le lit \u00e0 l'emplacement donn\u00e9. Une fois ces \u00e9tapes termin\u00e9es, vous pouvez taper ACCEPT pour enregistrer les r\u00e9sultats dans le fichier de configuration avec : SAVE_CONFIG Notez que si une modification est apport\u00e9e au syst\u00e8me de mouvement de l'imprimante, \u00e0 la position de la hotend ou \u00e0 l'emplacement de la sonde, cela invalidera les r\u00e9sultats de PROBE_CALIBRATE. Si la sonde a un d\u00e9calage X ou Y et que l'inclinaison du lit est modifi\u00e9e (par exemple, en ajustant les vis du lit, en ex\u00e9cutant DELTA_CALIBRATE, en ex\u00e9cutant Z_TILT_ADJUST, en ex\u00e9cutant QUAD_GANTRY_LEVEL, ou similaire), les r\u00e9sultats de PROBE_CALIBRATE seront invalid\u00e9s. Apr\u00e8s avoir effectu\u00e9 l'un des ajustements ci-dessus, il sera n\u00e9cessaire d'ex\u00e9cuter \u00e0 nouveau PROBE_CALIBRATE. Si les r\u00e9sultats de PROBE_CALIBRATE sont invalid\u00e9s, tous les r\u00e9sultats pr\u00e9c\u00e9dents bed mesh qui ont \u00e9t\u00e9 obtenus \u00e0 l'aide de la sonde sont \u00e9galement invalid\u00e9s - il sera n\u00e9cessaire de r\u00e9ex\u00e9cuter BED_MESH_CALIBRATE apr\u00e8s avoir recalibr\u00e9 la sonde.","title":"\u00c9talonnage de l'offset Z de la sonde"},{"location":"Probe_Calibrate.html#controle-de-repetabilite","text":"Apr\u00e8s avoir calibr\u00e9 les d\u00e9calages X, Y et Z de la sonde, il est conseill\u00e9 de v\u00e9rifier que la sonde fournit des r\u00e9sultats reproductibles. Commencez par mettre l'imprimante \u00e0 l'origine, puis d\u00e9placez la t\u00eate vers une position proche du centre du lit. Acc\u00e9dez \u00e0 l'onglet du terminal OctoPrint et ex\u00e9cutez la commande PROBE_ACCURACY . Cette commande ex\u00e9cutera le sondage dix fois et produira une sortie semblable \u00e0 la suivante : Recv: // probe accuracy: at X:0.000 Y:0.000 Z:10.000 Recv: // and read 10 times with speed of 5 mm/s Recv: // probe at -0.003,0.005 is z=2.506948 Recv: // probe at -0.003,0.005 is z=2.519448 Recv: // probe at -0.003,0.005 is z=2.519448 Recv: // probe at -0.003,0.005 is z=2.506948 Recv: // probe at -0.003,0.005 is z=2.519448 Recv: // probe at -0.003,0.005 is z=2.519448 Recv: // probe at -0.003,0.005 is z=2.506948 Recv: // probe at -0.003,0.005 is z=2.506948 Recv: // probe at -0.003,0.005 is z=2.519448 Recv: // probe at -0.003,0.005 is z=2.506948 Recv: // probe accuracy results: maximum 2.519448, minimum 2.506948, range 0.012500, average 2.513198, median 2.513198, standard deviation 0.006250 Id\u00e9alement, l'outil rapportera une valeur maximale et minimale identique. (C'est-\u00e0-dire que, id\u00e9alement, la sonde obtient un r\u00e9sultat identique sur les dix sondes.) Cependant, il est normal que les valeurs minimale et maximale diff\u00e8rent d'une \"distance de pas\" Z ou jusqu'\u00e0 5 microns (0,005 mm). Une \"distance de pas\" est distance_rotation/(full_steps_per_rotation*microsteps) . La distance entre la valeur minimale et la valeur maximale s'appelle la plage. Ainsi, dans l'exemple ci-dessus, \u00e9tant donn\u00e9 que l'imprimante utilise une distance de pas Z de 0,0125, une plage de 0,012500 serait consid\u00e9r\u00e9e comme normale. Si les r\u00e9sultats du test indiquent une plage de valeur sup\u00e9rieure \u00e0 25 microns (0,025 mm), la sonde n'a pas une pr\u00e9cision suffisante pour les proc\u00e9dures de nivellement de lit typiques. Il peut \u00eatre possible de r\u00e9gler la vitesse de la sonde et/ou la hauteur de d\u00e9part de la sonde pour am\u00e9liorer la r\u00e9p\u00e9tabilit\u00e9 de la sonde. La commande PROBE_ACCURACY permet d'ex\u00e9cuter des tests avec diff\u00e9rents param\u00e8tres pour voir leur impact - voir le document G-Codes pour plus de d\u00e9tails. Si la sonde obtient g\u00e9n\u00e9ralement des r\u00e9sultats reproductibles mais pr\u00e9sente une valeur aberrante occasionnelle, il peut \u00eatre possible d'en tenir compte en utilisant plusieurs \u00e9chantillons sur chaque sonde - lisez la description des param\u00e8tres de configuration de la sonde samples dans la r\u00e9f\u00e9rence de configuration pour plus de d\u00e9tails. Si une nouvelle vitesse de sondage, un nouveau nombre d'\u00e9chantillons ou d'autres param\u00e8tres sont n\u00e9cessaires, mettez \u00e0 jour le fichier printer.cfg et lancez une commande RESTART . Si c'est le cas, c'est une bonne id\u00e9e de calibrer le z_offset \u00e0 nouveau. Si des r\u00e9sultats reproductibles ne peuvent pas \u00eatre obtenus, n'utilisez pas la sonde pour le nivellement du lit. Klipper dispose de plusieurs outils de sondage manuels qui peuvent \u00eatre utilis\u00e9s \u00e0 la place - voir le Mise \u00e0 niveau du lit pour plus de d\u00e9tails.","title":"Contr\u00f4le de r\u00e9p\u00e9tabilit\u00e9"},{"location":"Probe_Calibrate.html#verification-des-erreurs-de-localisation","text":"Certaines sondes peuvent avoir une erreur syst\u00e9mique qui corrompt les r\u00e9sultats de la sonde \u00e0 certains emplacements de la t\u00eate d'outil. Par exemple, si le support de la sonde s'incline l\u00e9g\u00e8rement lorsqu'il se d\u00e9place le long de l'axe Y, la sonde peut alors signaler des r\u00e9sultats fauss\u00e9s \u00e0 diff\u00e9rentes positions Y. Il s'agit d'un probl\u00e8me courant avec les sondes sur les imprimantes delta, mais il peut se produire sur toutes les imprimantes. On peut v\u00e9rifier une erreur d'emplacement en utilisant la commande PROBE_CALIBRATE pour mesurer le d\u00e9calage z_offset de la sonde \u00e0 divers emplacements X et Y. Id\u00e9alement, le z_offset serait une valeur constante \u00e0 chaque emplacement d'imprimante. Pour les imprimantes delta, essayez de mesurer le z_offset \u00e0 une position proche de la tour A, \u00e0 une position proche de la tour B et \u00e0 une position proche de la tour C. Pour les imprimantes cart\u00e9siennes, corexy et similaires, essayez de mesurer le z_offset \u00e0 des positions proches des quatre coins du lit. Avant de commencer ce test, calibrez d'abord les d\u00e9calages X, Y et Z de la sonde comme d\u00e9crit au d\u00e9but de ce document. Remettez ensuite l'imprimante \u00e0 l'origine et naviguez jusqu'\u00e0 la premi\u00e8re position XY. Suivez les \u00e9tapes de calibrer le d\u00e9calage en Z de la sonde en ex\u00e9cutant la commande PROBE_CALIBRATE , les commandes TESTZ et la commande ACCEPT . , mais n'ex\u00e9cutez pas SAVE_CONFIG . Notez le rapport z_offset trouv\u00e9. Naviguez ensuite vers les autres positions XY, r\u00e9p\u00e9tez ces \u00e9tapes PROBE_CALIBRATE et notez le d\u00e9calage z signal\u00e9. Si la diff\u00e9rence entre le d\u00e9calage z_offset minimum signal\u00e9 et le d\u00e9calage z_maximum signal\u00e9 est sup\u00e9rieure \u00e0 25 microns (0,025 mm), la sonde n'est pas adapt\u00e9e aux proc\u00e9dures de nivellement de lit typiques. Voir le document mise \u00e0 niveau du lit pour les alternatives de sonde manuelle.","title":"V\u00e9rification des erreurs de localisation"},{"location":"Probe_Calibrate.html#erreurs-de-temperature","text":"De nombreuses sondes ont une erreur syst\u00e9mique lorsqu'elles sondent \u00e0 diff\u00e9rentes temp\u00e9ratures. Par exemple, la sonde peut se d\u00e9clencher syst\u00e9matiquement \u00e0 une hauteur inf\u00e9rieure lorsque la sonde est \u00e0 une temp\u00e9rature plus \u00e9lev\u00e9e. Il est recommand\u00e9 de faire fonctionner les outils de nivellement du lit \u00e0 une temp\u00e9rature constante pour tenir compte de cette erreur. Par exemple, ex\u00e9cutez toujours les outils lorsque l'imprimante est \u00e0 temp\u00e9rature ambiante ou ex\u00e9cutez toujours les outils une fois que l'imprimante a obtenu une temp\u00e9rature d'impression constante. Dans les deux cas, c'est une bonne id\u00e9e d'attendre plusieurs minutes apr\u00e8s que la temp\u00e9rature souhait\u00e9e est atteinte, de sorte que l'appareil d'impression soit constamment \u00e0 la temp\u00e9rature souhait\u00e9e. Pour v\u00e9rifier une erreur de temp\u00e9rature, commencez avec l'imprimante \u00e0 temp\u00e9rature ambiante, puis mettez l'imprimante \u00e0 l'origine, d\u00e9placez la t\u00eate vers une position proche du centre du lit et ex\u00e9cutez la commande PROBE_ACCURACY . Notez les r\u00e9sultats. Ensuite, sans mise \u00e0 l'origine ou d\u00e9sactiver les moteurs pas \u00e0 pas, chauffez la buse et le lit de l'imprimante \u00e0 la temp\u00e9rature d'impression, puis ex\u00e9cutez \u00e0 nouveau la commande PROBE_ACCURACY . Id\u00e9alement, la commande rapportera des r\u00e9sultats identiques. Comme ci-dessus, si la sonde a un d\u00e9calage en temp\u00e9rature, veillez \u00e0 toujours utiliser la sonde \u00e0 une temp\u00e9rature constante.","title":"Erreurs de temp\u00e9rature"},{"location":"Protocol.html","text":"Protocole \u00b6 Le protocole de messagerie Klipper est utilis\u00e9 pour la communication de bas niveau entre le logiciel h\u00f4te Klipper et le logiciel du microcontr\u00f4leur Klipper. \u00c0 un niveau \u00e9lev\u00e9, le protocole peut \u00eatre consid\u00e9r\u00e9 comme une s\u00e9rie de cha\u00eenes de commandes et de r\u00e9ponses qui sont compress\u00e9es, transmises, puis trait\u00e9es du c\u00f4t\u00e9 r\u00e9ception. Un exemple d'une s\u00e9ries de commandes dans un format non compress\u00e9 lisible par l'homme pourrait ressembler \u00e0 : set_digital_out pin=PA3 value=1 set_digital_out pin=PA7 value=1 schedule_digital_out oid=8 clock=4000000 value=0 queue_step oid=7 interval=7458 count=10 add=331 queue_step oid=7 interval=11717 count=4 add=1281 Consultez le document commandes mcu pour plus d'informations sur les commandes disponibles. Voir le document deboguage pour plus d'informations sur la fa\u00e7on de traduire un fichier G-Code en commandes de microcontr\u00f4leur lisibles. Cette page fournit une description de haut niveau du protocole de communication de Klipper lui-m\u00eame. Il d\u00e9crit comment les messages sont d\u00e9clar\u00e9s, cod\u00e9s au format binaire (le sch\u00e9ma de \"compression\") et transmis. L'objectif du protocole est de permettre un canal de communication sans erreur entre l'h\u00f4te et le microcontr\u00f4leur qui soit \u00e0 faible latence, \u00e0 faible bande passante et \u00e0 faible complexit\u00e9 pour le microcontr\u00f4leur. Interface du micro-contr\u00f4leur \u00b6 Le protocole de transmission Klipper peut \u00eatre consid\u00e9r\u00e9 comme un m\u00e9canisme Appel de proc\u00e9dure \u00e0 distance entre le micro-contr\u00f4leur et l'h\u00f4te. Le logiciel du microcontr\u00f4leur d\u00e9clare les commandes que l'h\u00f4te peut invoquer ainsi que les messages de r\u00e9ponse qu'il peut g\u00e9n\u00e9rer. L'h\u00f4te utilise ces informations pour ordonner au microcontr\u00f4leur d'effectuer des actions et d'interpr\u00e9ter les r\u00e9sultats. D\u00e9claration des commandes \u00b6 Le logiciel du microcontr\u00f4leur d\u00e9clare une \"commande\" en utilisant la macro DECL_COMMAND() dans le code C. Par exemple\u202f: DECL_COMMAND(command_update_digital_out, \"update_digital_out oid=%c value=%c\"); Ce qui pr\u00e9c\u00e8de d\u00e9clare une commande nomm\u00e9e \"update_digital_out\". Cela permet \u00e0 l'h\u00f4te \"d'appeler\" cette commande qui entra\u00eenerait l'ex\u00e9cution de la fonction C command_update_digital_out() dans le microcontr\u00f4leur. Ce qui pr\u00e9c\u00e8de indique \u00e9galement que la commande prend deux param\u00e8tres entiers. Lorsque le code C command_update_digital_out() est ex\u00e9cut\u00e9, un tableau contenant ces deux entiers lui sera transmis - le premier correspondant \u00e0 'oid' et le second correspondant \u00e0 'value'. En g\u00e9n\u00e9ral, les param\u00e8tres sont d\u00e9crits avec une syntaxe de style printf() (par exemple, \"%u\"). Le formatage correspond directement \u00e0 une vue \"lisible\" des commandes (par exemple, \"update_digital_out oid=7 value=1\"). Dans l'exemple ci-dessus, \"value=\" est un nom de param\u00e8tre et \"%c\" indique que le param\u00e8tre est un entier. En interne, le nom du param\u00e8tre n'est utilis\u00e9 que comme documentation. Dans cet exemple, le \"%c\" est \u00e9galement utilis\u00e9 comme documentation pour indiquer que l'entier attendu a une taille de 1 octet (la taille de l'entier d\u00e9clar\u00e9 n'a pas d'impact sur l'analyse ou l'encodage). La construction du micrologiciel du microcontr\u00f4leur collectera toutes les commandes d\u00e9clar\u00e9es avec DECL_COMMAND(), d\u00e9terminera leurs param\u00e8tres et s'arrangera pour qu'elles soient appelables. D\u00e9claration des r\u00e9ponses \u00b6 Pour envoyer des informations du microcontr\u00f4leur \u00e0 l'h\u00f4te, des \"r\u00e9ponses\" sont g\u00e9n\u00e9r\u00e9es. Celles-ci sont \u00e0 la fois d\u00e9clar\u00e9es et transmises \u00e0 l'aide de la macro C sendf(). Par example\u202f: sendf(\"status clock=%u status=%c\", sched_read_time(), sched_is_shutdown()); Ce qui pr\u00e9c\u00e8de transmet un message de r\u00e9ponse \"status\" qui contient deux param\u00e8tres entiers (\"clock\" et \"status\"). La construction du microcontr\u00f4leur trouve automatiquement tous les appels sendf() et g\u00e9n\u00e8re des encodeurs pour eux. Le premier param\u00e8tre de la fonction sendf() d\u00e9crit la r\u00e9ponse et il est dans le m\u00eame format que les d\u00e9clarations de commande. L'h\u00f4te peut enregistrer une fonction de rappel pour chaque r\u00e9ponse. Ainsi, les commandes permettent \u00e0 l'h\u00f4te d'invoquer des fonctions C dans le microcontr\u00f4leur et les r\u00e9ponses permettent au logiciel du microcontr\u00f4leur d'invoquer du code dans l'h\u00f4te. La macro sendf() ne doit \u00eatre appel\u00e9e qu'\u00e0 partir de commandes ou de gestionnaires de t\u00e2ches, et elle ne doit pas \u00eatre appel\u00e9e \u00e0 partir d'interruptions ou de timers. Le code n'a pas besoin d'\u00e9mettre un sendf() en r\u00e9ponse \u00e0 une commande re\u00e7ue, le nombre d'appels \u00e0 sendf() n'est pas limi\u00e9, et il est possible d'appeler sendf() \u00e0 tout moment \u00e0 partir d'un gestionnaire de t\u00e2ches. R\u00e9ponses de sortie \u00b6 Pour simplifier le d\u00e9bogage, il existe \u00e9galement une fonction C output(). Par exemple\u202f: output(\"La valeur de %u est %s avec une taille de %u.\", x, buf, buf_len); La fonction output() est similaire \u00e0 printf() - elle est destin\u00e9e \u00e0 g\u00e9n\u00e9rer et formater des messages de d\u00e9bogage avec un affichage dans un format compr\u00e9hensible (ndt : par un humain normalement constitu\u00e9 :-)). D\u00e9clarer des \u00e9num\u00e9rations \u00b6 Les \u00e9num\u00e9rations permettent au code h\u00f4te d'utiliser des identificateurs de type cha\u00eene pour des param\u00e8tres que le microcontr\u00f4leur g\u00e8re comme des entiers. Ils sont d\u00e9clar\u00e9s dans le code du microcontr\u00f4leur - par exemple : DECL_ENUMERATION(\"spi_bus\", \"spi\", 0); DECL_ENUMERATION_RANGE(\"pin\", \"PC0\", 16, 8); Dans le premier exemple, la macro DECL_ENUMERATION() d\u00e9finit une \u00e9num\u00e9ration pour les messages de commande/r\u00e9ponse avec un nom de param\u00e8tre \"spi_bus\" ou un nom de param\u00e8tre avec un suffixe \"_spi_bus\". Pour ces param\u00e8tres, la cha\u00eene \"spi\" sera une valeur valide et elle sera transmise comme une valeur enti\u00e8re \u00e9gale \u00e0 z\u00e9ro. Il est \u00e9galement possible de d\u00e9clarer une plage d'\u00e9num\u00e9ration. Dans le deuxi\u00e8me exemple, un param\u00e8tre \"pin\" (ou tout param\u00e8tre avec le suffixe \"_pin\") accepterait PC0, PC1, PC2, ..., PC7 comme valeurs valides. Les cha\u00eenes seront transmises comme des entiers 16, 17, 18, ..., 23. D\u00e9claration de constantes \u00b6 Les constantes peuvent \u00eatre export\u00e9es. Par exemple, les \u00e9l\u00e9ments suivants : DECL_CONSTANT(\"SERIAL_BAUD\", 250000); exporterait une constante nomm\u00e9e \"SERIAL_BAUD\" avec une valeur de 250000 du microcontr\u00f4leur vers l'h\u00f4te. Il est \u00e9galement possible de d\u00e9clarer une constante de type cha\u00eene - par exemple : DECL_CONSTANT_STR(\"MCU\", \"pru\"); Encodage des message de bas niveau \u00b6 Pour accomplir le m\u00e9canisme \"RPC\" ci-dessus, chaque commandes et r\u00e9ponses sont cod\u00e9es dans un format binaire pour la transmission. Cette section d\u00e9crit le syst\u00e8me de transmission. Blocs de message \u00b6 Toutes les donn\u00e9es envoy\u00e9es de l'h\u00f4te au microcontr\u00f4leur et vice-versa sont contenues dans des \"blocs de message\". Un bloc de message a un en-t\u00eate de deux octets et une fin de trois octets. Le format d'un bloc de message est : <1 byte length><1 byte sequence><n-byte content><2 byte crc><1 byte sync> L'octet de longueur contient le nombre d'octets dans le bloc de message, y compris les octets d'en-t\u00eate et de fin (la longueur minimale du message est donc de 5 octets). La longueur maximale d'un bloc de message est de 64 octets. L'octet de s\u00e9quence contient un num\u00e9ro de s\u00e9quence de 4 bits dans les bits de poids faible et les bits de poids fort contiennent toujours 0x10 (les bits de poids fort sont r\u00e9serv\u00e9s pour une utilisation future). Les octets de contenu contiennent les donn\u00e9es du message et leur format est d\u00e9crit dans la section suivante. Les octets crc contiennent un CCITT CRC 16 bits du bloc de message incluant les octets d'en-t\u00eate mais excluant les octets de fin. L'octet de synchronisation est 0x7e. Le format du bloc de message est inspir\u00e9 des trames de message HDLC . Comme dans HDLC, le bloc de message peut \u00e9ventuellement contenir un caract\u00e8re de synchronisation suppl\u00e9mentaire au d\u00e9but du bloc. Contrairement \u00e0 HDLC, un caract\u00e8re de synchronisation n'est pas propre au header et peut \u00eatre pr\u00e9sent dans le contenu du bloc de message. Contenu du bloc de message \u00b6 Chaque bloc de message envoy\u00e9 de l'h\u00f4te au microcontr\u00f4leur contient une s\u00e9rie de z\u00e9ro ou plusieurs commandes de message dans son contenu. Chaque commande commence par une Quantit\u00e9 de longueur variable (VLQ) encod\u00e9 entier command-id suivi de z\u00e9ro ou plusieurs param\u00e8tres VLQ pour la commande donn\u00e9e. Par exemple, les quatre commandes suivantes peuvent \u00eatre plac\u00e9es dans un seul bloc de message : update_digital_out oid=6 value=1 update_digital_out oid=5 value=0 get_config get_clock et cod\u00e9 dans les huit entiers VLQ suivants : <id_update_digital_out><6><1><id_update_digital_out><5><0><id_get_config><id_get_clock> Afin d'encoder et d'analyser le contenu du message, l'h\u00f4te et le microcontr\u00f4leur doivent s'accorder sur les identifiants de commande et le nombre de param\u00e8tres de chaque commande. Ainsi, dans l'exemple ci-dessus, l'h\u00f4te et le microcontr\u00f4leur savent que \"id_update_digital_out\" est toujours suivi de deux param\u00e8tres, et \"id_get_config\" et \"id_get_clock\" n'ont aucun param\u00e8tre. L'h\u00f4te et le microcontr\u00f4leur partagent un \"dictionnaire de donn\u00e9es\" qui mappe les descriptions de commande (par exemple, \"update_digital_out oid=%c value=%c\") \u00e0 leurs identifiants de commande \"entiers\". Lors du traitement des donn\u00e9es, l'analyseur saura s'attendre \u00e0 un nombre sp\u00e9cifique de param\u00e8tres cod\u00e9s VLQ apr\u00e8s un identifiant de commande donn\u00e9. Le contenu des messages pour les blocs envoy\u00e9s du microcontr\u00f4leur \u00e0 l'h\u00f4te suit le m\u00eame format. Les identifiants de ces messages sont des \"identifiants de r\u00e9ponse\", mais ils ont le m\u00eame objectif et suivent les m\u00eames r\u00e8gles de codage. En pratique, les blocs de message envoy\u00e9s du microcontr\u00f4leur \u00e0 l'h\u00f4te ne contiennent jamais plus d'une r\u00e9ponse dans le contenu du bloc de message. Quantit\u00e9s de longueur variable \u00b6 Voir l' article wikipedia sur les VLQ pour plus d'informations sur le format g\u00e9n\u00e9ral des entiers cod\u00e9s VLQ. Klipper utilise un sch\u00e9ma de codage qui prend en charge les entiers positifs et n\u00e9gatifs. Les entiers proches de z\u00e9ro utilisent moins d'octets pour coder et les entiers positifs cod\u00e9s utilisent moins d'octets - en g\u00e9n\u00e9ral - que les entiers n\u00e9gatifs. Le tableau suivant indique le nombre d'octets n\u00e9cessaires \u00e0 l'encodage de chaque entier : Integer Taille encod\u00e9e -32 .. 95 1 -4096 .. 12287 2 -524288 .. 1572863 3 -67108864 .. 201326591 4 -2147483648 .. 4294967295 5 Cha\u00eenes de longueur variable \u00b6 Une exception aux r\u00e8gles de codage ci-dessus, si le param\u00e8tre d'une commande ou d'une r\u00e9ponse est une cha\u00eene dynamique, le param\u00e8tre n'est pas cod\u00e9 comme un simple entier VLQ. Au lieu de cela, il est cod\u00e9 en transmettant la longueur sous la forme d'un entier cod\u00e9 VLQ suivi du contenu de la cha\u00eene lui-m\u00eame : <VLQ encoded length><n-byte contents> Les descriptions de commande trouv\u00e9es dans le dictionnaire de donn\u00e9es permettent \u00e0 la fois \u00e0 l'h\u00f4te et au microcontr\u00f4leur de savoir quels param\u00e8tres de commande utilisent un codage VLQ simple et quels param\u00e8tres utilisent un codage de cha\u00eene. Dictionnaire de donn\u00e9es \u00b6 Pour que des communications significatives soient \u00e9tablies entre le microcontr\u00f4leur et l'h\u00f4te, les deux parties doivent s'entendre sur un \"dictionnaire de donn\u00e9es\". Ce dictionnaire de donn\u00e9es contient les identificateurs entiers des commandes et des r\u00e9ponses ainsi que leurs descriptions. La construction du micrologiciel du microcontr\u00f4leur utilise le contenu des macros DECL_COMMAND() et sendf() pour g\u00e9n\u00e9rer le dictionnaire de donn\u00e9es. La construction attribue automatiquement des identifiants uniques \u00e0 chaque commande et r\u00e9ponse. Ce syst\u00e8me permet \u00e0 la fois au code h\u00f4te et au code du microcontr\u00f4leur d'utiliser de mani\u00e8re transparente des noms descriptifs lisibles par l'homme tout en utilisant une bande passante minimale. L'h\u00f4te interroge le dictionnaire de donn\u00e9es lors de sa premi\u00e8re connexion au microcontr\u00f4leur. Une fois que l'h\u00f4te a t\u00e9l\u00e9charg\u00e9 le dictionnaire de donn\u00e9es du microcontr\u00f4leur, il utilise ce dictionnaire de donn\u00e9es pour coder toutes les commandes et analyser toutes les r\u00e9ponses du microcontr\u00f4leur. L'h\u00f4te doit donc g\u00e9rer un dictionnaire de donn\u00e9es dynamique. Cependant, pour garder le logiciel du microcontr\u00f4leur simple, le microcontr\u00f4leur utilise - lui - toujours son dictionnaire de donn\u00e9es statique (compil\u00e9). Le dictionnaire de donn\u00e9es est demand\u00e9 en envoyant des commandes \"identify\" au microcontr\u00f4leur. Le microcontr\u00f4leur r\u00e9pond \u00e0 chaque commande d'identification par un message \"identifier_response\". \u00c9tant donn\u00e9 que ces deux commandes sont n\u00e9cessaires avant d'obtenir le dictionnaire de donn\u00e9es, leurs identifiants entiers et leurs types de param\u00e8tres sont cod\u00e9s en dur \u00e0 la fois dans le microcontr\u00f4leur et dans l'h\u00f4te. L'identifiant de r\u00e9ponse \"identifier_response\" est 0, l'identifiant de commande \"identify\" est 1. En plus d'avoir des identifiants cod\u00e9s en dur, la commande d'identification et sa r\u00e9ponse sont d\u00e9clar\u00e9es et transmises de la m\u00eame mani\u00e8re que les autres commandes et r\u00e9ponses. Aucune autre commande ou r\u00e9ponse n'est cod\u00e9e en dur. Le format du dictionnaire de donn\u00e9es transmis est une cha\u00eene JSON compress\u00e9e zlib. Le processus de construction du microcontr\u00f4leur g\u00e9n\u00e8re la cha\u00eene, la comprime et la stocke dans la section texte du flash du microcontr\u00f4leur. Le dictionnaire de donn\u00e9es peut \u00eatre beaucoup plus grand que la taille maximale du bloc de message - l'h\u00f4te le t\u00e9l\u00e9charge en envoyant plusieurs commandes d'identification demandant des blocs progressifs du dictionnaire de donn\u00e9es. Une fois que tous les morceaux sont obtenus, l'h\u00f4te r\u00e9assemble les morceaux, d\u00e9compresse les donn\u00e9es et analyse le contenu. En plus des informations sur le protocole de communication, le dictionnaire de donn\u00e9es contient \u00e9galement la version du logiciel, les \u00e9num\u00e9rations (telles que d\u00e9finies par DECL_ENUMERATION) et les constantes (telles que d\u00e9finies par DECL_CONSTANT). Flux de messages \u00b6 Les message de commande envoy\u00e9es de l'h\u00f4te au microcontr\u00f4leur sont cens\u00e9es \u00eatre sans erreur. Le microcontr\u00f4leur v\u00e9rifiera le CRC et les num\u00e9ros de s\u00e9quence dans chaque bloc de message pour s'assurer que les commandes sont exactes et dans l'ordre. Le microcontr\u00f4leur traite toujours les blocs de message dans l'ordre - s'il re\u00e7oit un bloc dans le d\u00e9sordre, il le rejettera ainsi que tout autre bloc dans le d\u00e9sordre jusqu'\u00e0 ce qu'il re\u00e7oive des blocs avec le bon s\u00e9quencement. Le code de bas niveau de l'h\u00f4te impl\u00e9mente un syst\u00e8me de retransmission automatique des blocs de messages perdus ou corrompus envoy\u00e9s au microcontr\u00f4leur. Pour faciliter cela, le microcontr\u00f4leur transmet un \"bloc de message ack\" apr\u00e8s chaque bloc de message re\u00e7u avec succ\u00e8s. L'h\u00f4te planifie un d\u00e9lai apr\u00e8s l'envoi de chaque bloc et il retransmettra si le d\u00e9lai expire sans recevoir de \"ack\" correspondant. De plus, si le microcontr\u00f4leur d\u00e9tecte un bloc corrompu ou dans le d\u00e9sordre, il peut transmettre un \"bloc de message nak\" pour faciliter une retransmission rapide. Un \"ack\" est un bloc de message avec un contenu vide (c'est-\u00e0-dire un bloc de message de 5 octets) et un num\u00e9ro de s\u00e9quence sup\u00e9rieur au dernier num\u00e9ro de s\u00e9quence d'h\u00f4te re\u00e7u. Un \"nak\" est un bloc de message avec un contenu vide et un num\u00e9ro de s\u00e9quence inf\u00e9rieur au dernier num\u00e9ro de s\u00e9quence d'h\u00f4te re\u00e7u. Le protocole facilite un syst\u00e8me de transmission \"fen\u00eatr\u00e9\" : l'h\u00f4te peut avoir de nombreux blocs de messages en cours \u00e0 la fois. (Ceci s'ajoute aux nombreuses commandes qui peuvent \u00eatre pr\u00e9sentes dans un bloc de message.) Cela permet une utilisation maximale de la bande passante m\u00eame en cas de latence de transmission. Les m\u00e9canismes de temporisation, de retransmission, de fen\u00eatrage et d'accus\u00e9 de r\u00e9ception sont inspir\u00e9s de m\u00e9canismes similaires de TCP . Dans l'autre sens, les blocs de messages envoy\u00e9s du microcontr\u00f4leur \u00e0 l'h\u00f4te sont aussi con\u00e7us pour \u00eatre sans erreur, mais ils n'ont pas de validation de transmission. (Les r\u00e9ponses ne doivent pas \u00eatre corrompues, mais elles peuvent dispara\u00eetre.) Cette conception a \u00e9t\u00e9 choisie pour garder une mise en \u0153uvre simple dans le microcontr\u00f4leur. Il n'y a pas de syst\u00e8me de retransmission automatique des r\u00e9ponses - le code de haut niveau devrait \u00eatre capable de g\u00e9rer une r\u00e9ponse manquante occasionnelle (g\u00e9n\u00e9ralement en redemandant le contenu ou en \u00e9tablissant un calendrier r\u00e9current de transmission des r\u00e9ponses). Le champ du num\u00e9ro de s\u00e9quence dans les blocs de message envoy\u00e9s \u00e0 l'h\u00f4te est toujours sup\u00e9rieur d'une unit\u00e9 au dernier num\u00e9ro de s\u00e9quence envoy\u00e9 par l'h\u00f4te. Il n'est pas utilis\u00e9 pour suivre les s\u00e9quences de blocs de message de r\u00e9ponse.","title":"Protocole"},{"location":"Protocol.html#protocole","text":"Le protocole de messagerie Klipper est utilis\u00e9 pour la communication de bas niveau entre le logiciel h\u00f4te Klipper et le logiciel du microcontr\u00f4leur Klipper. \u00c0 un niveau \u00e9lev\u00e9, le protocole peut \u00eatre consid\u00e9r\u00e9 comme une s\u00e9rie de cha\u00eenes de commandes et de r\u00e9ponses qui sont compress\u00e9es, transmises, puis trait\u00e9es du c\u00f4t\u00e9 r\u00e9ception. Un exemple d'une s\u00e9ries de commandes dans un format non compress\u00e9 lisible par l'homme pourrait ressembler \u00e0 : set_digital_out pin=PA3 value=1 set_digital_out pin=PA7 value=1 schedule_digital_out oid=8 clock=4000000 value=0 queue_step oid=7 interval=7458 count=10 add=331 queue_step oid=7 interval=11717 count=4 add=1281 Consultez le document commandes mcu pour plus d'informations sur les commandes disponibles. Voir le document deboguage pour plus d'informations sur la fa\u00e7on de traduire un fichier G-Code en commandes de microcontr\u00f4leur lisibles. Cette page fournit une description de haut niveau du protocole de communication de Klipper lui-m\u00eame. Il d\u00e9crit comment les messages sont d\u00e9clar\u00e9s, cod\u00e9s au format binaire (le sch\u00e9ma de \"compression\") et transmis. L'objectif du protocole est de permettre un canal de communication sans erreur entre l'h\u00f4te et le microcontr\u00f4leur qui soit \u00e0 faible latence, \u00e0 faible bande passante et \u00e0 faible complexit\u00e9 pour le microcontr\u00f4leur.","title":"Protocole"},{"location":"Protocol.html#interface-du-micro-controleur","text":"Le protocole de transmission Klipper peut \u00eatre consid\u00e9r\u00e9 comme un m\u00e9canisme Appel de proc\u00e9dure \u00e0 distance entre le micro-contr\u00f4leur et l'h\u00f4te. Le logiciel du microcontr\u00f4leur d\u00e9clare les commandes que l'h\u00f4te peut invoquer ainsi que les messages de r\u00e9ponse qu'il peut g\u00e9n\u00e9rer. L'h\u00f4te utilise ces informations pour ordonner au microcontr\u00f4leur d'effectuer des actions et d'interpr\u00e9ter les r\u00e9sultats.","title":"Interface du micro-contr\u00f4leur"},{"location":"Protocol.html#declaration-des-commandes","text":"Le logiciel du microcontr\u00f4leur d\u00e9clare une \"commande\" en utilisant la macro DECL_COMMAND() dans le code C. Par exemple\u202f: DECL_COMMAND(command_update_digital_out, \"update_digital_out oid=%c value=%c\"); Ce qui pr\u00e9c\u00e8de d\u00e9clare une commande nomm\u00e9e \"update_digital_out\". Cela permet \u00e0 l'h\u00f4te \"d'appeler\" cette commande qui entra\u00eenerait l'ex\u00e9cution de la fonction C command_update_digital_out() dans le microcontr\u00f4leur. Ce qui pr\u00e9c\u00e8de indique \u00e9galement que la commande prend deux param\u00e8tres entiers. Lorsque le code C command_update_digital_out() est ex\u00e9cut\u00e9, un tableau contenant ces deux entiers lui sera transmis - le premier correspondant \u00e0 'oid' et le second correspondant \u00e0 'value'. En g\u00e9n\u00e9ral, les param\u00e8tres sont d\u00e9crits avec une syntaxe de style printf() (par exemple, \"%u\"). Le formatage correspond directement \u00e0 une vue \"lisible\" des commandes (par exemple, \"update_digital_out oid=7 value=1\"). Dans l'exemple ci-dessus, \"value=\" est un nom de param\u00e8tre et \"%c\" indique que le param\u00e8tre est un entier. En interne, le nom du param\u00e8tre n'est utilis\u00e9 que comme documentation. Dans cet exemple, le \"%c\" est \u00e9galement utilis\u00e9 comme documentation pour indiquer que l'entier attendu a une taille de 1 octet (la taille de l'entier d\u00e9clar\u00e9 n'a pas d'impact sur l'analyse ou l'encodage). La construction du micrologiciel du microcontr\u00f4leur collectera toutes les commandes d\u00e9clar\u00e9es avec DECL_COMMAND(), d\u00e9terminera leurs param\u00e8tres et s'arrangera pour qu'elles soient appelables.","title":"D\u00e9claration des commandes"},{"location":"Protocol.html#declaration-des-reponses","text":"Pour envoyer des informations du microcontr\u00f4leur \u00e0 l'h\u00f4te, des \"r\u00e9ponses\" sont g\u00e9n\u00e9r\u00e9es. Celles-ci sont \u00e0 la fois d\u00e9clar\u00e9es et transmises \u00e0 l'aide de la macro C sendf(). Par example\u202f: sendf(\"status clock=%u status=%c\", sched_read_time(), sched_is_shutdown()); Ce qui pr\u00e9c\u00e8de transmet un message de r\u00e9ponse \"status\" qui contient deux param\u00e8tres entiers (\"clock\" et \"status\"). La construction du microcontr\u00f4leur trouve automatiquement tous les appels sendf() et g\u00e9n\u00e8re des encodeurs pour eux. Le premier param\u00e8tre de la fonction sendf() d\u00e9crit la r\u00e9ponse et il est dans le m\u00eame format que les d\u00e9clarations de commande. L'h\u00f4te peut enregistrer une fonction de rappel pour chaque r\u00e9ponse. Ainsi, les commandes permettent \u00e0 l'h\u00f4te d'invoquer des fonctions C dans le microcontr\u00f4leur et les r\u00e9ponses permettent au logiciel du microcontr\u00f4leur d'invoquer du code dans l'h\u00f4te. La macro sendf() ne doit \u00eatre appel\u00e9e qu'\u00e0 partir de commandes ou de gestionnaires de t\u00e2ches, et elle ne doit pas \u00eatre appel\u00e9e \u00e0 partir d'interruptions ou de timers. Le code n'a pas besoin d'\u00e9mettre un sendf() en r\u00e9ponse \u00e0 une commande re\u00e7ue, le nombre d'appels \u00e0 sendf() n'est pas limi\u00e9, et il est possible d'appeler sendf() \u00e0 tout moment \u00e0 partir d'un gestionnaire de t\u00e2ches.","title":"D\u00e9claration des r\u00e9ponses"},{"location":"Protocol.html#reponses-de-sortie","text":"Pour simplifier le d\u00e9bogage, il existe \u00e9galement une fonction C output(). Par exemple\u202f: output(\"La valeur de %u est %s avec une taille de %u.\", x, buf, buf_len); La fonction output() est similaire \u00e0 printf() - elle est destin\u00e9e \u00e0 g\u00e9n\u00e9rer et formater des messages de d\u00e9bogage avec un affichage dans un format compr\u00e9hensible (ndt : par un humain normalement constitu\u00e9 :-)).","title":"R\u00e9ponses de sortie"},{"location":"Protocol.html#declarer-des-enumerations","text":"Les \u00e9num\u00e9rations permettent au code h\u00f4te d'utiliser des identificateurs de type cha\u00eene pour des param\u00e8tres que le microcontr\u00f4leur g\u00e8re comme des entiers. Ils sont d\u00e9clar\u00e9s dans le code du microcontr\u00f4leur - par exemple : DECL_ENUMERATION(\"spi_bus\", \"spi\", 0); DECL_ENUMERATION_RANGE(\"pin\", \"PC0\", 16, 8); Dans le premier exemple, la macro DECL_ENUMERATION() d\u00e9finit une \u00e9num\u00e9ration pour les messages de commande/r\u00e9ponse avec un nom de param\u00e8tre \"spi_bus\" ou un nom de param\u00e8tre avec un suffixe \"_spi_bus\". Pour ces param\u00e8tres, la cha\u00eene \"spi\" sera une valeur valide et elle sera transmise comme une valeur enti\u00e8re \u00e9gale \u00e0 z\u00e9ro. Il est \u00e9galement possible de d\u00e9clarer une plage d'\u00e9num\u00e9ration. Dans le deuxi\u00e8me exemple, un param\u00e8tre \"pin\" (ou tout param\u00e8tre avec le suffixe \"_pin\") accepterait PC0, PC1, PC2, ..., PC7 comme valeurs valides. Les cha\u00eenes seront transmises comme des entiers 16, 17, 18, ..., 23.","title":"D\u00e9clarer des \u00e9num\u00e9rations"},{"location":"Protocol.html#declaration-de-constantes","text":"Les constantes peuvent \u00eatre export\u00e9es. Par exemple, les \u00e9l\u00e9ments suivants : DECL_CONSTANT(\"SERIAL_BAUD\", 250000); exporterait une constante nomm\u00e9e \"SERIAL_BAUD\" avec une valeur de 250000 du microcontr\u00f4leur vers l'h\u00f4te. Il est \u00e9galement possible de d\u00e9clarer une constante de type cha\u00eene - par exemple : DECL_CONSTANT_STR(\"MCU\", \"pru\");","title":"D\u00e9claration de constantes"},{"location":"Protocol.html#encodage-des-message-de-bas-niveau","text":"Pour accomplir le m\u00e9canisme \"RPC\" ci-dessus, chaque commandes et r\u00e9ponses sont cod\u00e9es dans un format binaire pour la transmission. Cette section d\u00e9crit le syst\u00e8me de transmission.","title":"Encodage des message de bas niveau"},{"location":"Protocol.html#blocs-de-message","text":"Toutes les donn\u00e9es envoy\u00e9es de l'h\u00f4te au microcontr\u00f4leur et vice-versa sont contenues dans des \"blocs de message\". Un bloc de message a un en-t\u00eate de deux octets et une fin de trois octets. Le format d'un bloc de message est : <1 byte length><1 byte sequence><n-byte content><2 byte crc><1 byte sync> L'octet de longueur contient le nombre d'octets dans le bloc de message, y compris les octets d'en-t\u00eate et de fin (la longueur minimale du message est donc de 5 octets). La longueur maximale d'un bloc de message est de 64 octets. L'octet de s\u00e9quence contient un num\u00e9ro de s\u00e9quence de 4 bits dans les bits de poids faible et les bits de poids fort contiennent toujours 0x10 (les bits de poids fort sont r\u00e9serv\u00e9s pour une utilisation future). Les octets de contenu contiennent les donn\u00e9es du message et leur format est d\u00e9crit dans la section suivante. Les octets crc contiennent un CCITT CRC 16 bits du bloc de message incluant les octets d'en-t\u00eate mais excluant les octets de fin. L'octet de synchronisation est 0x7e. Le format du bloc de message est inspir\u00e9 des trames de message HDLC . Comme dans HDLC, le bloc de message peut \u00e9ventuellement contenir un caract\u00e8re de synchronisation suppl\u00e9mentaire au d\u00e9but du bloc. Contrairement \u00e0 HDLC, un caract\u00e8re de synchronisation n'est pas propre au header et peut \u00eatre pr\u00e9sent dans le contenu du bloc de message.","title":"Blocs de message"},{"location":"Protocol.html#contenu-du-bloc-de-message","text":"Chaque bloc de message envoy\u00e9 de l'h\u00f4te au microcontr\u00f4leur contient une s\u00e9rie de z\u00e9ro ou plusieurs commandes de message dans son contenu. Chaque commande commence par une Quantit\u00e9 de longueur variable (VLQ) encod\u00e9 entier command-id suivi de z\u00e9ro ou plusieurs param\u00e8tres VLQ pour la commande donn\u00e9e. Par exemple, les quatre commandes suivantes peuvent \u00eatre plac\u00e9es dans un seul bloc de message : update_digital_out oid=6 value=1 update_digital_out oid=5 value=0 get_config get_clock et cod\u00e9 dans les huit entiers VLQ suivants : <id_update_digital_out><6><1><id_update_digital_out><5><0><id_get_config><id_get_clock> Afin d'encoder et d'analyser le contenu du message, l'h\u00f4te et le microcontr\u00f4leur doivent s'accorder sur les identifiants de commande et le nombre de param\u00e8tres de chaque commande. Ainsi, dans l'exemple ci-dessus, l'h\u00f4te et le microcontr\u00f4leur savent que \"id_update_digital_out\" est toujours suivi de deux param\u00e8tres, et \"id_get_config\" et \"id_get_clock\" n'ont aucun param\u00e8tre. L'h\u00f4te et le microcontr\u00f4leur partagent un \"dictionnaire de donn\u00e9es\" qui mappe les descriptions de commande (par exemple, \"update_digital_out oid=%c value=%c\") \u00e0 leurs identifiants de commande \"entiers\". Lors du traitement des donn\u00e9es, l'analyseur saura s'attendre \u00e0 un nombre sp\u00e9cifique de param\u00e8tres cod\u00e9s VLQ apr\u00e8s un identifiant de commande donn\u00e9. Le contenu des messages pour les blocs envoy\u00e9s du microcontr\u00f4leur \u00e0 l'h\u00f4te suit le m\u00eame format. Les identifiants de ces messages sont des \"identifiants de r\u00e9ponse\", mais ils ont le m\u00eame objectif et suivent les m\u00eames r\u00e8gles de codage. En pratique, les blocs de message envoy\u00e9s du microcontr\u00f4leur \u00e0 l'h\u00f4te ne contiennent jamais plus d'une r\u00e9ponse dans le contenu du bloc de message.","title":"Contenu du bloc de message"},{"location":"Protocol.html#quantites-de-longueur-variable","text":"Voir l' article wikipedia sur les VLQ pour plus d'informations sur le format g\u00e9n\u00e9ral des entiers cod\u00e9s VLQ. Klipper utilise un sch\u00e9ma de codage qui prend en charge les entiers positifs et n\u00e9gatifs. Les entiers proches de z\u00e9ro utilisent moins d'octets pour coder et les entiers positifs cod\u00e9s utilisent moins d'octets - en g\u00e9n\u00e9ral - que les entiers n\u00e9gatifs. Le tableau suivant indique le nombre d'octets n\u00e9cessaires \u00e0 l'encodage de chaque entier : Integer Taille encod\u00e9e -32 .. 95 1 -4096 .. 12287 2 -524288 .. 1572863 3 -67108864 .. 201326591 4 -2147483648 .. 4294967295 5","title":"Quantit\u00e9s de longueur variable"},{"location":"Protocol.html#chaines-de-longueur-variable","text":"Une exception aux r\u00e8gles de codage ci-dessus, si le param\u00e8tre d'une commande ou d'une r\u00e9ponse est une cha\u00eene dynamique, le param\u00e8tre n'est pas cod\u00e9 comme un simple entier VLQ. Au lieu de cela, il est cod\u00e9 en transmettant la longueur sous la forme d'un entier cod\u00e9 VLQ suivi du contenu de la cha\u00eene lui-m\u00eame : <VLQ encoded length><n-byte contents> Les descriptions de commande trouv\u00e9es dans le dictionnaire de donn\u00e9es permettent \u00e0 la fois \u00e0 l'h\u00f4te et au microcontr\u00f4leur de savoir quels param\u00e8tres de commande utilisent un codage VLQ simple et quels param\u00e8tres utilisent un codage de cha\u00eene.","title":"Cha\u00eenes de longueur variable"},{"location":"Protocol.html#dictionnaire-de-donnees","text":"Pour que des communications significatives soient \u00e9tablies entre le microcontr\u00f4leur et l'h\u00f4te, les deux parties doivent s'entendre sur un \"dictionnaire de donn\u00e9es\". Ce dictionnaire de donn\u00e9es contient les identificateurs entiers des commandes et des r\u00e9ponses ainsi que leurs descriptions. La construction du micrologiciel du microcontr\u00f4leur utilise le contenu des macros DECL_COMMAND() et sendf() pour g\u00e9n\u00e9rer le dictionnaire de donn\u00e9es. La construction attribue automatiquement des identifiants uniques \u00e0 chaque commande et r\u00e9ponse. Ce syst\u00e8me permet \u00e0 la fois au code h\u00f4te et au code du microcontr\u00f4leur d'utiliser de mani\u00e8re transparente des noms descriptifs lisibles par l'homme tout en utilisant une bande passante minimale. L'h\u00f4te interroge le dictionnaire de donn\u00e9es lors de sa premi\u00e8re connexion au microcontr\u00f4leur. Une fois que l'h\u00f4te a t\u00e9l\u00e9charg\u00e9 le dictionnaire de donn\u00e9es du microcontr\u00f4leur, il utilise ce dictionnaire de donn\u00e9es pour coder toutes les commandes et analyser toutes les r\u00e9ponses du microcontr\u00f4leur. L'h\u00f4te doit donc g\u00e9rer un dictionnaire de donn\u00e9es dynamique. Cependant, pour garder le logiciel du microcontr\u00f4leur simple, le microcontr\u00f4leur utilise - lui - toujours son dictionnaire de donn\u00e9es statique (compil\u00e9). Le dictionnaire de donn\u00e9es est demand\u00e9 en envoyant des commandes \"identify\" au microcontr\u00f4leur. Le microcontr\u00f4leur r\u00e9pond \u00e0 chaque commande d'identification par un message \"identifier_response\". \u00c9tant donn\u00e9 que ces deux commandes sont n\u00e9cessaires avant d'obtenir le dictionnaire de donn\u00e9es, leurs identifiants entiers et leurs types de param\u00e8tres sont cod\u00e9s en dur \u00e0 la fois dans le microcontr\u00f4leur et dans l'h\u00f4te. L'identifiant de r\u00e9ponse \"identifier_response\" est 0, l'identifiant de commande \"identify\" est 1. En plus d'avoir des identifiants cod\u00e9s en dur, la commande d'identification et sa r\u00e9ponse sont d\u00e9clar\u00e9es et transmises de la m\u00eame mani\u00e8re que les autres commandes et r\u00e9ponses. Aucune autre commande ou r\u00e9ponse n'est cod\u00e9e en dur. Le format du dictionnaire de donn\u00e9es transmis est une cha\u00eene JSON compress\u00e9e zlib. Le processus de construction du microcontr\u00f4leur g\u00e9n\u00e8re la cha\u00eene, la comprime et la stocke dans la section texte du flash du microcontr\u00f4leur. Le dictionnaire de donn\u00e9es peut \u00eatre beaucoup plus grand que la taille maximale du bloc de message - l'h\u00f4te le t\u00e9l\u00e9charge en envoyant plusieurs commandes d'identification demandant des blocs progressifs du dictionnaire de donn\u00e9es. Une fois que tous les morceaux sont obtenus, l'h\u00f4te r\u00e9assemble les morceaux, d\u00e9compresse les donn\u00e9es et analyse le contenu. En plus des informations sur le protocole de communication, le dictionnaire de donn\u00e9es contient \u00e9galement la version du logiciel, les \u00e9num\u00e9rations (telles que d\u00e9finies par DECL_ENUMERATION) et les constantes (telles que d\u00e9finies par DECL_CONSTANT).","title":"Dictionnaire de donn\u00e9es"},{"location":"Protocol.html#flux-de-messages","text":"Les message de commande envoy\u00e9es de l'h\u00f4te au microcontr\u00f4leur sont cens\u00e9es \u00eatre sans erreur. Le microcontr\u00f4leur v\u00e9rifiera le CRC et les num\u00e9ros de s\u00e9quence dans chaque bloc de message pour s'assurer que les commandes sont exactes et dans l'ordre. Le microcontr\u00f4leur traite toujours les blocs de message dans l'ordre - s'il re\u00e7oit un bloc dans le d\u00e9sordre, il le rejettera ainsi que tout autre bloc dans le d\u00e9sordre jusqu'\u00e0 ce qu'il re\u00e7oive des blocs avec le bon s\u00e9quencement. Le code de bas niveau de l'h\u00f4te impl\u00e9mente un syst\u00e8me de retransmission automatique des blocs de messages perdus ou corrompus envoy\u00e9s au microcontr\u00f4leur. Pour faciliter cela, le microcontr\u00f4leur transmet un \"bloc de message ack\" apr\u00e8s chaque bloc de message re\u00e7u avec succ\u00e8s. L'h\u00f4te planifie un d\u00e9lai apr\u00e8s l'envoi de chaque bloc et il retransmettra si le d\u00e9lai expire sans recevoir de \"ack\" correspondant. De plus, si le microcontr\u00f4leur d\u00e9tecte un bloc corrompu ou dans le d\u00e9sordre, il peut transmettre un \"bloc de message nak\" pour faciliter une retransmission rapide. Un \"ack\" est un bloc de message avec un contenu vide (c'est-\u00e0-dire un bloc de message de 5 octets) et un num\u00e9ro de s\u00e9quence sup\u00e9rieur au dernier num\u00e9ro de s\u00e9quence d'h\u00f4te re\u00e7u. Un \"nak\" est un bloc de message avec un contenu vide et un num\u00e9ro de s\u00e9quence inf\u00e9rieur au dernier num\u00e9ro de s\u00e9quence d'h\u00f4te re\u00e7u. Le protocole facilite un syst\u00e8me de transmission \"fen\u00eatr\u00e9\" : l'h\u00f4te peut avoir de nombreux blocs de messages en cours \u00e0 la fois. (Ceci s'ajoute aux nombreuses commandes qui peuvent \u00eatre pr\u00e9sentes dans un bloc de message.) Cela permet une utilisation maximale de la bande passante m\u00eame en cas de latence de transmission. Les m\u00e9canismes de temporisation, de retransmission, de fen\u00eatrage et d'accus\u00e9 de r\u00e9ception sont inspir\u00e9s de m\u00e9canismes similaires de TCP . Dans l'autre sens, les blocs de messages envoy\u00e9s du microcontr\u00f4leur \u00e0 l'h\u00f4te sont aussi con\u00e7us pour \u00eatre sans erreur, mais ils n'ont pas de validation de transmission. (Les r\u00e9ponses ne doivent pas \u00eatre corrompues, mais elles peuvent dispara\u00eetre.) Cette conception a \u00e9t\u00e9 choisie pour garder une mise en \u0153uvre simple dans le microcontr\u00f4leur. Il n'y a pas de syst\u00e8me de retransmission automatique des r\u00e9ponses - le code de haut niveau devrait \u00eatre capable de g\u00e9rer une r\u00e9ponse manquante occasionnelle (g\u00e9n\u00e9ralement en redemandant le contenu ou en \u00e9tablissant un calendrier r\u00e9current de transmission des r\u00e9ponses). Le champ du num\u00e9ro de s\u00e9quence dans les blocs de message envoy\u00e9s \u00e0 l'h\u00f4te est toujours sup\u00e9rieur d'une unit\u00e9 au dernier num\u00e9ro de s\u00e9quence envoy\u00e9 par l'h\u00f4te. Il n'est pas utilis\u00e9 pour suivre les s\u00e9quences de blocs de message de r\u00e9ponse.","title":"Flux de messages"},{"location":"RPi_microcontroller.html","text":"Microcontr\u00f4leur RPi \u00b6 Ce document d\u00e9crit le processus via lequel il est possible de lancer Klipper sur un Raspberry Pi et d'utiliser le m\u00eame Raspberry Pi comme mcu secondaire. Pourquoi utiliser un RPi comme microcontr\u00f4leur secondaire ? \u00b6 Souvent les microcontr\u00f4leurs d\u00e9di\u00e9s au contr\u00f4le des imprimantes 3D disposent d'un nombre limit\u00e9 et pr\u00e9-configur\u00e9 de broches expos\u00e9es pour g\u00e9rer les principales fonctions d'impression (r\u00e9sistances thermiques, extrudeuses, steppers...). L'utilisation du RPi o\u00f9 Klipper est install\u00e9 en tant que MCU secondaire donne la possibilit\u00e9 d'utiliser directement les GPIO et les bus (i2c, spi) du RPi \u00e0 l'int\u00e9rieur de klipper sans utiliser de plugins Octoprint (le cas \u00e9ch\u00e9ant) ou de programmes externes donnant la possibilit\u00e9 de tout contr\u00f4ler \u00e0 l'int\u00e9rieur l'impression GCODE. Avertissement : Si votre plate-forme est un Beaglebone et que vous avez correctement suivi les \u00e9tapes d'installation, le mcu linux est d\u00e9j\u00e0 install\u00e9 et configur\u00e9 pour votre syst\u00e8me. Installer le script rc \u00b6 Si vous souhaitez utiliser l'h\u00f4te comme MCU secondaire, le processus klipper_mcu doit s'ex\u00e9cuter avant le processus klippy. Apr\u00e8s avoir install\u00e9 Klipper, installez le script. Executez : cd ~/klipper/ sudo cp ./scripts/klipper-mcu.service /etc/systemd/system/ sudo systemctl enable klipper-mcu.service Construire le code du microcontr\u00f4leur \u00b6 Pour compiler le code du micro-contr\u00f4leur Klipper, commencez par le configurer pour le \"Linux process\"\u202f: cd ~/klipper/ make menuconfig Dans le menu, d\u00e9finissez \"Architecture du microcontr\u00f4leur\" sur \"Processus Linux\", puis enregistrez et quittez. Pour compiler et installer le nouveau code du microcontr\u00f4leur, ex\u00e9cutez : sudo service klipper stop make flash sudo service klipper start Si klippy.log signale une erreur \"Autorisation refus\u00e9e\" lors de la tentative de connexion \u00e0 /tmp/klipper_host_mcu , vous devez ajouter votre utilisateur au groupe tty. La commande suivante ajoutera l'utilisateur \"pi\" au groupe tty : sudo usermod -a -G tty pi Configuration restante \u00b6 Terminez l'installation en configurant le MCU secondaire de Klipper en suivant les instructions dans RaspberryPi exemlple de configuration et Exemples de configuration Multi MCU . Facultatif : Activer SPI \u00b6 Assurez-vous que le pilote SPI Linux est activ\u00e9 en ex\u00e9cutant sudo raspi-config et en activant SPI dans le menu \u00ab Options d\u2019interface \u00bb. Facultatif : Activer I2C \u00b6 Assurez-vous que le pilote Linux I2C est activ\u00e9 en ex\u00e9cutant sudo raspi-config et en activant I2C dans le menu \"Interfacing options\". Si vous pr\u00e9voyez d'utiliser I2C pour l'acc\u00e9l\u00e9rom\u00e8tre MPU, il est \u00e9galement n\u00e9cessaire de d\u00e9finir le d\u00e9bit en bauds sur 400 000 en : ajoutant/d\u00e9commentant dtparam=i2c_arm=on,i2c_arm_baudrate=400000 dans /boot/config. txt (ou /boot/firmware/config.txt dans certaines distributions). Facultatif : identifiez la bonne puce gpio \u00b6 Sur Raspberry Pi et sur de nombreux clones, les broches disponibles sur le connecteur GPIO appartiennent \u00e0 la premi\u00e8re puce gpio. Ils peuvent donc \u00eatre utilis\u00e9s sur klipper simplement en les r\u00e9f\u00e9ren\u00e7ant avec le nom gpio0..n . Cependant, il existe des cas dans lesquels les broches disponibles appartiennent \u00e0 des puces gpio autres que la premi\u00e8re. Par exemple dans le cas de certains mod\u00e8les OrangePi ou si un \"Port Expander\" est utilis\u00e9. Dans ces cas, il est utile d'utiliser les commandes pour acc\u00e9der au P\u00e9riph\u00e9rique de caract\u00e8res GPIO Linux pour v\u00e9rifier la configuration. Pour installer le p\u00e9riph\u00e9rique de caract\u00e8res *Linux GPIO - binaire * sur une distribution bas\u00e9e sur Debian comme Octopi, ex\u00e9cutez : sudo apt-get install gpiod Pour v\u00e9rifier la puce gpio disponible ex\u00e9cutez : gpiodetect Pour v\u00e9rifier la num\u00e9rotation des broches du connecteur GPIO et leur disponibilit\u00e9, ex\u00e9cutez : gpioinfo La broche choisie peut donc \u00eatre utilis\u00e9e dans la configuration comme gpiochip<n>/gpio<o> o\u00f9 n est le num\u00e9ro de puce tel qu'il est vu par la commande gpiodetect et o est le num\u00e9ro de ligne vu par la commande gpioinfo . Avertissement : seul les broches gpio marqu\u00e9es comme inutilis\u00e9es peuvent \u00eatre utilis\u00e9es. Il n'est pas possible qu'une ligne soit utilis\u00e9e par plusieurs processus simultan\u00e9ment. Par exemple sur un RPi 3B+ o\u00f9 klipper utilise le GPIO20 comme un interrupteur : $ gpiodetect gpiochip0 [pinctrl-bcm2835] (54 lines) gpiochip1 [raspberrypi-exp-gpio] (8 lines) $ gpioinfo gpiochip0 - 54 lines: line 0: unnamed unused input active-high line 1: unnamed unused input active-high line 2: unnamed unused input active-high line 3: unnamed unused input active-high line 4: unnamed unused input active-high line 5: unnamed unused input active-high line 6: unnamed unused input active-high line 7: unnamed unused input active-high line 8: unnamed unused input active-high line 9: unnamed unused input active-high line 10: unnamed unused input active-high line 11: unnamed unused input active-high line 12: unnamed unused input active-high line 13: unnamed unused input active-high line 14: unnamed unused input active-high line 15: unnamed unused input active-high line 16: unnamed unused input active-high line 17: unnamed unused input active-high line 18: unnamed unused input active-high line 19: unnamed unused input active-high line 20: unnamed \"klipper\" output active-high [used] line 21: unnamed unused input active-high line 22: unnamed unused input active-high line 23: unnamed unused input active-high line 24: unnamed unused input active-high line 25: unnamed unused input active-high line 26: unnamed unused input active-high line 27: unnamed unused input active-high line 28: unnamed unused input active-high line 29: unnamed \"led0\" output active-high [used] line 30: unnamed unused input active-high line 31: unnamed unused input active-high line 32: unnamed unused input active-high line 33: unnamed unused input active-high line 34: unnamed unused input active-high line 35: unnamed unused input active-high line 36: unnamed unused input active-high line 37: unnamed unused input active-high line 38: unnamed unused input active-high line 39: unnamed unused input active-high line 40: unnamed unused input active-high line 41: unnamed unused input active-high line 42: unnamed unused input active-high line 43: unnamed unused input active-high line 44: unnamed unused input active-high line 45: unnamed unused input active-high line 46: unnamed unused input active-high line 47: unnamed unused input active-high line 48: unnamed unused input active-high line 49: unnamed unused input active-high line 50: unnamed unused input active-high line 51: unnamed unused input active-high line 52: unnamed unused input active-high line 53: unnamed unused input active-high gpiochip1 - 8 lines: line 0: unnamed unused input active-high line 1: unnamed unused input active-high line 2: unnamed \"led1\" output active-low [used] line 3: unnamed unused input active-high line 4: unnamed unused input active-high line 5: unnamed unused input active-high line 6: unnamed unused input active-high line 7: unnamed unused input active-high Facultatif : PWM mat\u00e9riel \u00b6 Les Raspberry Pi ont deux canaux PWM (PWM0 et PWM1) qui sont disponibles sur le connecteur ou, sinon, peuvent \u00eatre redirig\u00e9s vers des broches gpio existantes. Le service mcu Linux utilise l'interface pwmchip sysfs pour contr\u00f4ler les p\u00e9riph\u00e9riques mat\u00e9riels pwm sur les h\u00f4tes Linux. L'interface pwm sysfs n'est pas disponible par d\u00e9faut sur un Raspberry et peut \u00eatre activ\u00e9e en ajoutant une ligne \u00e0 /boot/config.txt : # Activer l'interface pwmchip sysfs dtoverlay=pwm,pin=12,func=4 Cet exemple active uniquement PWM0 et l'achemine vers gpio12. Si les deux canaux PWM doivent \u00eatre activ\u00e9s, vous pouvez utiliser pwm-2chan . La superposition n'expose pas la ligne pwm sur sysfs au d\u00e9marrage et doit \u00eatre redirig\u00e9e en renvoyant le num\u00e9ro du canal pwm vers /sys/class/pwm/pwmchip0/export : echo 0 > /sys/class/pwm/pwmchip0/export Cela cr\u00e9era le p\u00e9riph\u00e9rique /sys/class/pwm/pwmchip0/pwm0 dans le syst\u00e8me de fichiers. La fa\u00e7on la plus simple de le faire est d'ajouter ceci \u00e0 /etc/rc.local avant la ligne exit 0 . Avec le sysfs en place, vous pouvez maintenant utiliser l'un ou l'autre des canaux pwm en ajoutant la configuration suivante \u00e0 votre printer.cfg : [output_pin caselight] pin: host:pwmchip0/pwm0 pwm: True hardware_pwm: True cycle_time: 0.000001 Cela ajoutera un contr\u00f4le pwm mat\u00e9riel \u00e0 gpio12 sur le Pi (car la superposition a \u00e9t\u00e9 configur\u00e9e pour acheminer pwm0 vers la broche = 12). PWM0 peut \u00eatre redirig\u00e9 vers gpio12 et gpio18, PWM1 peut \u00eatre redirig\u00e9 vers gpio13 et gpio19 : PWM (Modulation en Largeur d'Impulsion) Broche gpio Func 0 12 4 0 18 2 1 13 4 1 19 2","title":"Microcontr\u00f4leur RPi"},{"location":"RPi_microcontroller.html#microcontroleur-rpi","text":"Ce document d\u00e9crit le processus via lequel il est possible de lancer Klipper sur un Raspberry Pi et d'utiliser le m\u00eame Raspberry Pi comme mcu secondaire.","title":"Microcontr\u00f4leur RPi"},{"location":"RPi_microcontroller.html#pourquoi-utiliser-un-rpi-comme-microcontroleur-secondaire","text":"Souvent les microcontr\u00f4leurs d\u00e9di\u00e9s au contr\u00f4le des imprimantes 3D disposent d'un nombre limit\u00e9 et pr\u00e9-configur\u00e9 de broches expos\u00e9es pour g\u00e9rer les principales fonctions d'impression (r\u00e9sistances thermiques, extrudeuses, steppers...). L'utilisation du RPi o\u00f9 Klipper est install\u00e9 en tant que MCU secondaire donne la possibilit\u00e9 d'utiliser directement les GPIO et les bus (i2c, spi) du RPi \u00e0 l'int\u00e9rieur de klipper sans utiliser de plugins Octoprint (le cas \u00e9ch\u00e9ant) ou de programmes externes donnant la possibilit\u00e9 de tout contr\u00f4ler \u00e0 l'int\u00e9rieur l'impression GCODE. Avertissement : Si votre plate-forme est un Beaglebone et que vous avez correctement suivi les \u00e9tapes d'installation, le mcu linux est d\u00e9j\u00e0 install\u00e9 et configur\u00e9 pour votre syst\u00e8me.","title":"Pourquoi utiliser un RPi comme microcontr\u00f4leur secondaire ?"},{"location":"RPi_microcontroller.html#installer-le-script-rc","text":"Si vous souhaitez utiliser l'h\u00f4te comme MCU secondaire, le processus klipper_mcu doit s'ex\u00e9cuter avant le processus klippy. Apr\u00e8s avoir install\u00e9 Klipper, installez le script. Executez : cd ~/klipper/ sudo cp ./scripts/klipper-mcu.service /etc/systemd/system/ sudo systemctl enable klipper-mcu.service","title":"Installer le script rc"},{"location":"RPi_microcontroller.html#construire-le-code-du-microcontroleur","text":"Pour compiler le code du micro-contr\u00f4leur Klipper, commencez par le configurer pour le \"Linux process\"\u202f: cd ~/klipper/ make menuconfig Dans le menu, d\u00e9finissez \"Architecture du microcontr\u00f4leur\" sur \"Processus Linux\", puis enregistrez et quittez. Pour compiler et installer le nouveau code du microcontr\u00f4leur, ex\u00e9cutez : sudo service klipper stop make flash sudo service klipper start Si klippy.log signale une erreur \"Autorisation refus\u00e9e\" lors de la tentative de connexion \u00e0 /tmp/klipper_host_mcu , vous devez ajouter votre utilisateur au groupe tty. La commande suivante ajoutera l'utilisateur \"pi\" au groupe tty : sudo usermod -a -G tty pi","title":"Construire le code du microcontr\u00f4leur"},{"location":"RPi_microcontroller.html#configuration-restante","text":"Terminez l'installation en configurant le MCU secondaire de Klipper en suivant les instructions dans RaspberryPi exemlple de configuration et Exemples de configuration Multi MCU .","title":"Configuration restante"},{"location":"RPi_microcontroller.html#facultatif-activer-spi","text":"Assurez-vous que le pilote SPI Linux est activ\u00e9 en ex\u00e9cutant sudo raspi-config et en activant SPI dans le menu \u00ab Options d\u2019interface \u00bb.","title":"Facultatif\u00a0: Activer SPI"},{"location":"RPi_microcontroller.html#facultatif-activer-i2c","text":"Assurez-vous que le pilote Linux I2C est activ\u00e9 en ex\u00e9cutant sudo raspi-config et en activant I2C dans le menu \"Interfacing options\". Si vous pr\u00e9voyez d'utiliser I2C pour l'acc\u00e9l\u00e9rom\u00e8tre MPU, il est \u00e9galement n\u00e9cessaire de d\u00e9finir le d\u00e9bit en bauds sur 400 000 en : ajoutant/d\u00e9commentant dtparam=i2c_arm=on,i2c_arm_baudrate=400000 dans /boot/config. txt (ou /boot/firmware/config.txt dans certaines distributions).","title":"Facultatif\u00a0: Activer I2C"},{"location":"RPi_microcontroller.html#facultatif-identifiez-la-bonne-puce-gpio","text":"Sur Raspberry Pi et sur de nombreux clones, les broches disponibles sur le connecteur GPIO appartiennent \u00e0 la premi\u00e8re puce gpio. Ils peuvent donc \u00eatre utilis\u00e9s sur klipper simplement en les r\u00e9f\u00e9ren\u00e7ant avec le nom gpio0..n . Cependant, il existe des cas dans lesquels les broches disponibles appartiennent \u00e0 des puces gpio autres que la premi\u00e8re. Par exemple dans le cas de certains mod\u00e8les OrangePi ou si un \"Port Expander\" est utilis\u00e9. Dans ces cas, il est utile d'utiliser les commandes pour acc\u00e9der au P\u00e9riph\u00e9rique de caract\u00e8res GPIO Linux pour v\u00e9rifier la configuration. Pour installer le p\u00e9riph\u00e9rique de caract\u00e8res *Linux GPIO - binaire * sur une distribution bas\u00e9e sur Debian comme Octopi, ex\u00e9cutez : sudo apt-get install gpiod Pour v\u00e9rifier la puce gpio disponible ex\u00e9cutez : gpiodetect Pour v\u00e9rifier la num\u00e9rotation des broches du connecteur GPIO et leur disponibilit\u00e9, ex\u00e9cutez : gpioinfo La broche choisie peut donc \u00eatre utilis\u00e9e dans la configuration comme gpiochip<n>/gpio<o> o\u00f9 n est le num\u00e9ro de puce tel qu'il est vu par la commande gpiodetect et o est le num\u00e9ro de ligne vu par la commande gpioinfo . Avertissement : seul les broches gpio marqu\u00e9es comme inutilis\u00e9es peuvent \u00eatre utilis\u00e9es. Il n'est pas possible qu'une ligne soit utilis\u00e9e par plusieurs processus simultan\u00e9ment. Par exemple sur un RPi 3B+ o\u00f9 klipper utilise le GPIO20 comme un interrupteur : $ gpiodetect gpiochip0 [pinctrl-bcm2835] (54 lines) gpiochip1 [raspberrypi-exp-gpio] (8 lines) $ gpioinfo gpiochip0 - 54 lines: line 0: unnamed unused input active-high line 1: unnamed unused input active-high line 2: unnamed unused input active-high line 3: unnamed unused input active-high line 4: unnamed unused input active-high line 5: unnamed unused input active-high line 6: unnamed unused input active-high line 7: unnamed unused input active-high line 8: unnamed unused input active-high line 9: unnamed unused input active-high line 10: unnamed unused input active-high line 11: unnamed unused input active-high line 12: unnamed unused input active-high line 13: unnamed unused input active-high line 14: unnamed unused input active-high line 15: unnamed unused input active-high line 16: unnamed unused input active-high line 17: unnamed unused input active-high line 18: unnamed unused input active-high line 19: unnamed unused input active-high line 20: unnamed \"klipper\" output active-high [used] line 21: unnamed unused input active-high line 22: unnamed unused input active-high line 23: unnamed unused input active-high line 24: unnamed unused input active-high line 25: unnamed unused input active-high line 26: unnamed unused input active-high line 27: unnamed unused input active-high line 28: unnamed unused input active-high line 29: unnamed \"led0\" output active-high [used] line 30: unnamed unused input active-high line 31: unnamed unused input active-high line 32: unnamed unused input active-high line 33: unnamed unused input active-high line 34: unnamed unused input active-high line 35: unnamed unused input active-high line 36: unnamed unused input active-high line 37: unnamed unused input active-high line 38: unnamed unused input active-high line 39: unnamed unused input active-high line 40: unnamed unused input active-high line 41: unnamed unused input active-high line 42: unnamed unused input active-high line 43: unnamed unused input active-high line 44: unnamed unused input active-high line 45: unnamed unused input active-high line 46: unnamed unused input active-high line 47: unnamed unused input active-high line 48: unnamed unused input active-high line 49: unnamed unused input active-high line 50: unnamed unused input active-high line 51: unnamed unused input active-high line 52: unnamed unused input active-high line 53: unnamed unused input active-high gpiochip1 - 8 lines: line 0: unnamed unused input active-high line 1: unnamed unused input active-high line 2: unnamed \"led1\" output active-low [used] line 3: unnamed unused input active-high line 4: unnamed unused input active-high line 5: unnamed unused input active-high line 6: unnamed unused input active-high line 7: unnamed unused input active-high","title":"Facultatif\u00a0: identifiez la bonne puce gpio"},{"location":"RPi_microcontroller.html#facultatif-pwm-materiel","text":"Les Raspberry Pi ont deux canaux PWM (PWM0 et PWM1) qui sont disponibles sur le connecteur ou, sinon, peuvent \u00eatre redirig\u00e9s vers des broches gpio existantes. Le service mcu Linux utilise l'interface pwmchip sysfs pour contr\u00f4ler les p\u00e9riph\u00e9riques mat\u00e9riels pwm sur les h\u00f4tes Linux. L'interface pwm sysfs n'est pas disponible par d\u00e9faut sur un Raspberry et peut \u00eatre activ\u00e9e en ajoutant une ligne \u00e0 /boot/config.txt : # Activer l'interface pwmchip sysfs dtoverlay=pwm,pin=12,func=4 Cet exemple active uniquement PWM0 et l'achemine vers gpio12. Si les deux canaux PWM doivent \u00eatre activ\u00e9s, vous pouvez utiliser pwm-2chan . La superposition n'expose pas la ligne pwm sur sysfs au d\u00e9marrage et doit \u00eatre redirig\u00e9e en renvoyant le num\u00e9ro du canal pwm vers /sys/class/pwm/pwmchip0/export : echo 0 > /sys/class/pwm/pwmchip0/export Cela cr\u00e9era le p\u00e9riph\u00e9rique /sys/class/pwm/pwmchip0/pwm0 dans le syst\u00e8me de fichiers. La fa\u00e7on la plus simple de le faire est d'ajouter ceci \u00e0 /etc/rc.local avant la ligne exit 0 . Avec le sysfs en place, vous pouvez maintenant utiliser l'un ou l'autre des canaux pwm en ajoutant la configuration suivante \u00e0 votre printer.cfg : [output_pin caselight] pin: host:pwmchip0/pwm0 pwm: True hardware_pwm: True cycle_time: 0.000001 Cela ajoutera un contr\u00f4le pwm mat\u00e9riel \u00e0 gpio12 sur le Pi (car la superposition a \u00e9t\u00e9 configur\u00e9e pour acheminer pwm0 vers la broche = 12). PWM0 peut \u00eatre redirig\u00e9 vers gpio12 et gpio18, PWM1 peut \u00eatre redirig\u00e9 vers gpio13 et gpio19 : PWM (Modulation en Largeur d'Impulsion) Broche gpio Func 0 12 4 0 18 2 1 13 4 1 19 2","title":"Facultatif : PWM mat\u00e9riel"},{"location":"Releases.html","text":"Versions \u00b6 Historique de versions de Klipper. Merci de vous r\u00e9f\u00e9rer a la ressource installation pour plus d'information sur l'installation de Klipper. Klipper 0.11.0 \u00b6 Disponible le 28/11/2022. Changements majeurs dans cette version : Optimisation du pilote de moteur pas \u00e0 pas trinamic \"pas sur les deux c\u00f4t\u00e9s\" (\"step on both edges\"). Prise en charge de Python3. Le code h\u00f4te Klipper fonctionnera avec Python2 ou Python3. Prise en charge am\u00e9lior\u00e9e du bus CAN. Prise en charge du bus CAN sur les puces rp2040, stm32g0, stm32h7, same51 et same54. Prise en charge du mode \"pont USB vers bus CAN\". Prise en charge du chargeur de d\u00e9marrage CanBoot. Prise en charge des acc\u00e9l\u00e9rom\u00e8tres mpu9250 et mpu6050. Am\u00e9lioration de la gestion des erreurs pour les capteurs de temp\u00e9rature max31856, max31855, max31865 et max6675. Il est d\u00e9sormais possible de configurer les LED pour qu'elles se mettent \u00e0 jour pendant les longues commandes G-Code \u00e0 l'aide de la prise en charge du \"mod\u00e8le\" de LED. Plusieurs am\u00e9liorations sur le microcontr\u00f4leur. Nouvelle prise en charge des puces stm32h743, stm32h750, stm32l412, stm32g0b1, same70, same51 et same54. Prise en charge des lectures i2c sur atsamd et stm32f0. Prise en charge pwm mat\u00e9rielle sur stm32. Envoi d'\u00e9v\u00e9nements bas\u00e9 sur le signal Linux mcu. Nouveau support rp2040 pour \"make flash\", i2c et rp2040-e5 USB errata. Nouveaux modules ajout\u00e9s : angle, dac084S085, exclude_object, led, mpu9250, pca9632, smart_effector, z_thermal_adjust. Nouvelle cin\u00e9matique \"delt\u00e9sienne\" ajout\u00e9e. Nouvel outil dump_mcu ajout\u00e9. Plusieurs corrections de bogues et nettoyages de code. Klipper 0.10.0 \u00b6 Disponible le 29/09/2021. Changements majeurs dans cette version : Prise en charge de la mise \u00e0 l'origine \"Multi-MCU\". Il est d\u00e9sormais possible de c\u00e2bler un pilote de moteur pas \u00e0 pas et sa fin de course sur des microcontr\u00f4leurs s\u00e9par\u00e9s. Cela simplifie le c\u00e2blage des sondes Z sur les \"cartes de t\u00eate d'outil\". Klipper a maintenant un Serveur Discord et un Serveur Discourse . Le site Web de Klipper utilise d\u00e9sormais l'infrastructure \"mkdocs\". Il existe \u00e9galement un projet Klipper Translations . Prise en charge automatis\u00e9e du flash du micrologiciel via une carte SD sur de nombreuses cartes. Nouveau support cin\u00e9matique pour les imprimantes \"Hybrid CoreXY\" et \"Hybrid CoreXZ\". Klipper utilise maintenant rotation_distance pour configurer les distances de d\u00e9placement du moteur pas \u00e0 pas. Le code h\u00f4te principal de Klipper peut d\u00e9sormais communiquer directement avec les microcontr\u00f4leurs via le bus CAN. Nouveau syst\u00e8me \"d'analyse de mouvement\". Les mises \u00e0 jour des mouvements internes de Klipper et les r\u00e9sultats des capteurs peuvent \u00eatre suivis et enregistr\u00e9s pour analyse. Les pilotes de moteur pas \u00e0 pas Trinamic sont d\u00e9sormais surveill\u00e9s en permanence pour les conditions d'erreur. Prise en charge du microcontr\u00f4leur rp2040 (cartes Raspberry Pi Pico). Le syst\u00e8me \"make menuconfig\" utilise maintenant kconfiglib. De nombreux modules suppl\u00e9mentaires ajout\u00e9s : ds18b20, duplicate_pin_override, filament_motion_sensor, palette2, motion_report, pca9533, pulse_counter, save_variables, sdcard_loop, temperature_host, temperature_mcu Plusieurs corrections de bogues et nettoyages de code. Klipper 0.9.0 \u00b6 Disponible le 20/10/2020. Changements majeurs dans cette version : Prise en charge de \"Input Shaping\" - un m\u00e9canisme pour contrer la r\u00e9sonance de l'imprimante. Il peut r\u00e9duire ou \u00e9liminer les \"ondulations\" dans les impressions. Nouveau syst\u00e8me \"Smooth Pressure Advance\". Cela impl\u00e9mente \"Pressure Advance\" sans introduire de changements de vitesse instantan\u00e9s. Il est d\u00e9sormais possible de r\u00e9gler l'avance de pression \u00e0 l'aide d'une m\u00e9thode \"Tour de r\u00e9glage\". Nouveau serveur API \"webhooks\". Fournit une interface JSON programmable \u00e0 Klipper. L'\u00e9cran LCD et le menu sont d\u00e9sormais configurables \u00e0 l'aide du langage Jinja2. Les pilotes de moteur pas \u00e0 pas TMC2208 peuvent d\u00e9sormais \u00eatre utilis\u00e9s en mode \"standalone\" avec Klipper. Prise en charge am\u00e9lior\u00e9e du BL-Touch v3. Identification USB am\u00e9lior\u00e9e. Klipper dispose d\u00e9sormais de son propre code d'identification USB et les micro-contr\u00f4leurs peuvent d\u00e9sormais signaler leurs num\u00e9ros de s\u00e9rie lors de l'identification USB. Nouveau support cin\u00e9matique pour les imprimantes \"Rotary Delta\" et \"CoreXZ\". Am\u00e9liorations du microcontr\u00f4leur : prise en charge de stm32f070, prise en charge de stm32f207, prise en charge des broches GPIO sur \"Linux MCU\", prise en charge du \"chargeur de d\u00e9marrage HID\" stm32, prise en charge du chargeur de d\u00e9marrage Chitu, prise en charge du chargeur de d\u00e9marrage MKS Robin. Am\u00e9lioration de la gestion des \u00e9v\u00e9nements Python pour \"garbage collection\". Nombreux modules suppl\u00e9mentaires ajout\u00e9s : adc_scaled, adxl345, bme280, display_status, extruder_stepper, fan_generic, hall_filament_width_sensor, htu21d, homing_heaters, input_shaper, lm75, print_stats, resonance_tester, shaper_calibrate, query_adc, graph_accelerometer, graph_extruder, graph_motion, graph_shaper, graph_temp_sensor, whconsole Plusieurs corrections de bogues et nettoyages de code. Klipper 0.9.1 \u00b6 Disponible le 28/10/2020. Version contenant uniquement des corrections de bogues. Klipper 0.8.0 \u00b6 Disponible le 21/10/2019. Changements majeurs dans cette version : Prise en charge du nouveau mod\u00e8le de commande G-Code. Le G-Code dans le fichier de configuration est maintenant \u00e9valu\u00e9 avec le langage Jinja2. Am\u00e9liorations de la gestion des pilotes pas \u00e0 pas Trinamic : Nouvelle prise en charge pour les pilotes TMC2209 et TMC5160. Commandes G-Code DUMP_TMC, SET_TMC_CURRENT et INIT_TMC am\u00e9lior\u00e9es. Prise en charge am\u00e9lior\u00e9e de la gestion TMC UART avec un multiplexage analogique. Prise en charge am\u00e9lior\u00e9e de la mise \u00e0 l'origine, du sondage et de la mise \u00e0 niveau du lit : Nouveaux modules manual_probe, bed_screws, screw_tilt_adjust, skew_correction, safe_z_home ajout\u00e9s. Sondage multi-\u00e9chantillons am\u00e9lior\u00e9 avec une logique de m\u00e9diane, de moyenne et de nouvel essai. Documentation am\u00e9lior\u00e9e pour le BL-Touch, l'\u00e9talonnage de la sonde, l'\u00e9talonnage de la fin de course, l'\u00e9talonnage des imprimantes delta, la mise \u00e0 l'origine sans capteur et l'\u00e9talonnage de la phase de fin de course. Prise en charge am\u00e9lior\u00e9e de la mise \u00e0 l'origine sur un axe Z de grande taille. De nombreuses am\u00e9liorations du micro-contr\u00f4leur Klipper : Klipper port\u00e9 sur : SAM3X8C, SAM4S8C, SAMD51, STM32F042, STM32F4 Nouvelles impl\u00e9mentations des pilotes USB CDC sur SAM3X, SAM4, STM32F4. Prise en charge am\u00e9lior\u00e9e du flashage de Klipper via USB. Prise en charge du SPI logiciel. Filtrage de temp\u00e9rature grandement am\u00e9lior\u00e9 sur le capteur LPC176x. Les param\u00e8tres de d\u00e9marrage des broches de sortie peuvent \u00eatre configur\u00e9s dans le micro-contr\u00f4leur. Nouveau site web avec la documentation Klipper : http://klipper3d.org/ Klipper a maintenant un logo. Support exp\u00e9rimental pour la cin\u00e9matique polaire et \"treuil \u00e0 c\u00e2ble\". Le fichier de configuration peut maintenant inclure d'autres fichiers de configuration. De nombreux modules suppl\u00e9mentaires ajout\u00e9s : board_pins, controller_fan, delay_gcode, dotstar, filament_switch_sensor, firmware_retraction, gcode_arcs, gcode_button, heater_generic, manual_stepper, mcp4018, mcp4728, neopixel, pause_resume, respond, temperature_sensor tsl1401cl_filament_width_sensor, tuning_tower De nombreuses commandes suppl\u00e9mentaires ajout\u00e9es : RESTORE_GCODE_STATE, SAVE_GCODE_STATE, SET_GCODE_VARIABLE, SET_HEATER_TEMPERATURE, SET_IDLE_TIMEOUT, SET_TEMPERATURE_FAN_TARGET Plusieurs corrections de bogues et nettoyages de code. Klipper 0.7.0 \u00b6 Disponible le 20/12/2018. Changements majeurs dans cette version : Klipper prend d\u00e9sormais en charge le nivellement du lit par maillage Nouvel \u00e9talonnage des imprimantes delta \"am\u00e9lior\u00e9\" (\u00e9talonne les dimensions d'impression x/y sur les imprimantes delta) Gestion de la configuration pendant l'ex\u00e9cution des pilotes de moteur pas \u00e0 pas Trinamic (tmc2130, tmc2208, tmc2660) Prise en charge am\u00e9lior\u00e9e des capteurs de temp\u00e9rature : MAX6675, MAX31855, MAX31856, MAX31865, thermistances personnalis\u00e9es, capteurs de style pt100 Plusieurs nouveaux modules : temperature_fan, sx1509, force_move, mcp4451, z_tilt, quad_gantry_level, endstop_phase, bltouch Plusieurs nouvelles commandes ajout\u00e9es : SAVE_CONFIG, SET_PRESSURE_ADVANCE, SET_GCODE_OFFSET, SET_VELOCITY_LIMIT, STEPPER_BUZZ, TURN_OFF_HEATERS, M204, macros g-code personnalis\u00e9es Prise en charge \u00e9tendue de l'\u00e9cran LCD : Prise en charge des menus d'ex\u00e9cution Nouvelles ic\u00f4nes d'affichage Prise en charge des \u00e9crans \"uc1701\" et \"ssd1306\" Prise en charge de nouveaux micro-contr\u00f4leurs : Klipper port\u00e9 sur : LPC176x (Smoothieboards), SAM4E8E (Duet2), SAMD21 (Arduino Zero), STM32F103 (appareils \"Blue pill\"), atmega32u4 Nouveau pilote CDC USB g\u00e9n\u00e9rique impl\u00e9ment\u00e9 sur AVR, LPC176x, SAMD21 et STM32F103 Am\u00e9liorations des performances sur les processeurs ARM Le code cin\u00e9matique a \u00e9t\u00e9 r\u00e9\u00e9crit pour utiliser un \"solveur it\u00e9ratif\" Nouveaux tests automatis\u00e9s pour le logiciel h\u00f4te Klipper De nombreux nouveaux exemples de fichiers de configuration pour les imprimantes les plus courantes Mises \u00e0 jour de la documentation pour les chargeurs de d\u00e9marrage, l'analyse comparative, le portage des micro-contr\u00f4leurs, les v\u00e9rifications de configuration, le mappage des broches, les param\u00e8tres du trancheur, le packaging, et plus Plusieurs corrections de bogues et nettoyages de code Klipper 0.6.0 \u00b6 Disponible le 31/03/2018. Changements majeurs dans cette version : V\u00e9rifications am\u00e9lior\u00e9es des d\u00e9faillances mat\u00e9rielles des \u00e9l\u00e9ments chauffants et des thermistances Prise en charge des sondes Z Premi\u00e8re prise en charge de l'\u00e9talonnage automatique des param\u00e8tres sur les deltas (via une nouvelle commande delta_calibrate) Premi\u00e8re prise en charge de la compensation d'inclinaison du lit (via la commande bed_tilt_calibrate) Premi\u00e8re prise en charge de la \u00ab mise \u00e0 l'origine 's\u00fbre' \u00bb et des surcharges des mises \u00e0 l'origine Prise en charge de l'affichage de l'\u00e9tat sur les \u00e9crans RepRapDiscount style 2004 et 12864 Nouvelles am\u00e9liorations pour la multi-extrusion : Prise en charge des chauffages partag\u00e9s Prise en charge des chariots doubles (IDEX) Prise en charge de la configuration de plusieurs steppers par axe (par exemple, double Z) Prise en charge des broches de sortie num\u00e9riques et pwm personnalis\u00e9es (avec une nouvelle commande SET_PIN) Prise en charge d'une \"carte SD virtuelle\" qui permet d'imprimer directement depuis Klipper (aide sur les machines trop lentes pour bien ex\u00e9cuter OctoPrint) Prise en charge du r\u00e9glage de diff\u00e9rentes longueurs de bras sur chaque tour d'une delta Prise en charge des commandes G-Code M220/M221 (remplacement du facteur de vitesse/remplacement du facteur d'extrusion) Plusieurs mises \u00e0 jour de la documentation : De nombreux nouveaux exemples de fichiers de configuration pour les imprimantes les plus courantes Nouvel exemple de configuration multi-MCU Nouvel exemple de configuration du capteur bltouch Nouveaux documents sur la FAQ, la v\u00e9rification de la configuration et le G-Code Prise en charge des tests d'int\u00e9gration continue sur tous les commits github Plusieurs corrections de bogues et nettoyages de code Klipper 0.5.0 \u00b6 Disponible le 25/10/2017. Changements majeurs dans cette version : Prise en charge des imprimantes avec plusieurs extrudeuses. Prise en charge pour l'ex\u00e9cution sur le PRU Beaglebone. Prise en charge de la carte Replicape. Prise en charge de l'ex\u00e9cution du code du microcontr\u00f4leur dans un processus Linux en temps r\u00e9el. Prise en charge de plusieurs microcontr\u00f4leurs. (Par exemple, on pourrait contr\u00f4ler une extrudeuse avec un microcontr\u00f4leur et le reste de l'imprimante avec un autre.) Une synchronisation d'horloge logicielle est mise en \u0153uvre pour coordonner les actions entre les microcontr\u00f4leurs. Am\u00e9liorations des performances des moteurs pas \u00e0 pas (AVR 20Mhz jusqu'\u00e0 189K pas par seconde). Prise en charge du contr\u00f4le des servos et prise en charge de la d\u00e9finition des ventilateurs de refroidissement des buses. Plusieurs corrections de bogues et nettoyages de code Klipper 0.4.0 \u00b6 Disponible le 03/05/2017. Changements majeurs dans cette version : Installation am\u00e9lior\u00e9e sur les machines Raspberry Pi. La majeure partie de l'installation est maintenant script\u00e9e. Prise en charge des imprimantes corexy Mises \u00e0 jour de la documentation : nouveau document cin\u00e9matique, nouveau guide de r\u00e9glage Pressure Advance, nouveaux exemples de fichiers de configuration, et plus Am\u00e9liorations des performances des moteurs pas \u00e0 pas (AVR 20Mhz sur 175K pas par seconde, Arduino Due sur 460K) Prise en charge des r\u00e9initialisations automatiques du microcontr\u00f4leur. Prise en charge des r\u00e9initialisations via basculement de l'alimentation USB sur Raspberry Pi. L'algorithme d'avance de pression fonctionne d\u00e9sormais avec anticipation pour r\u00e9duire les changements de pression dans les virages. Prise en charge de la limitation de la vitesse maximale des mouvements courts en zigzag Prise en charge des capteurs AD595 Plusieurs corrections de bogues et nettoyages de code Klipper 0.3.0 \u00b6 Disponible le 23/12/2016. Changements majeurs dans cette version : Documentation am\u00e9lior\u00e9e Prise en charge des imprimantes avec cin\u00e9matique delta Prise en charge du microcontr\u00f4leur Arduino Due (ARM cortex-M3) Prise en charge des microcontr\u00f4leurs AVR bas\u00e9s sur USB Prise en charge de l'algorithme \"d'avance de pression\" - il r\u00e9duit le suintement pendant les impressions. Nouvelle fonctionnalit\u00e9 \"but\u00e9e de fin de course bas\u00e9e sur la phase de moteurs pas \u00e0 pas\" - permet une plus grande pr\u00e9cision sur la prise d'origine de la fin de course. Prise en charge des commandes \"g-code \u00e9tendu\" telles que \"help\", \"restart\" et \"status\". Prise en charge du rechargement de la configuration Klipper et du red\u00e9marrage du logiciel h\u00f4te en \u00e9mettant une commande \"restart\" depuis le terminal. Am\u00e9liorations des performances des moteurs pas \u00e0 pas (AVR 20Mhz jusqu'\u00e0 158K pas par seconde). Gestion des erreurs am\u00e9lior\u00e9e. La plupart des erreurs sont maintenant affich\u00e9es via le terminal avec une aide sur la fa\u00e7on de les r\u00e9soudre. Plusieurs corrections de bogues et nettoyages de code Klipper 0.2.0 \u00b6 Premi\u00e8re version de Klipper. Disponible le 25/05/2016. Les principales fonctionnalit\u00e9s disponibles dans la version initiale incluent : Prise en charge de base des imprimantes cart\u00e9siennes (moteurs pas \u00e0 pas, extrudeur, lit chauffant, ventilateur de refroidissement). Prise en charge des commandes g-code de base. Prise en charge de l'interfa\u00e7age avec OctoPrint. Acc\u00e9l\u00e9ration et gestion de l'anticipation Prise en charge des microcontr\u00f4leurs AVR via des ports s\u00e9rie standard","title":"Versions"},{"location":"Releases.html#versions","text":"Historique de versions de Klipper. Merci de vous r\u00e9f\u00e9rer a la ressource installation pour plus d'information sur l'installation de Klipper.","title":"Versions"},{"location":"Releases.html#klipper-0110","text":"Disponible le 28/11/2022. Changements majeurs dans cette version : Optimisation du pilote de moteur pas \u00e0 pas trinamic \"pas sur les deux c\u00f4t\u00e9s\" (\"step on both edges\"). Prise en charge de Python3. Le code h\u00f4te Klipper fonctionnera avec Python2 ou Python3. Prise en charge am\u00e9lior\u00e9e du bus CAN. Prise en charge du bus CAN sur les puces rp2040, stm32g0, stm32h7, same51 et same54. Prise en charge du mode \"pont USB vers bus CAN\". Prise en charge du chargeur de d\u00e9marrage CanBoot. Prise en charge des acc\u00e9l\u00e9rom\u00e8tres mpu9250 et mpu6050. Am\u00e9lioration de la gestion des erreurs pour les capteurs de temp\u00e9rature max31856, max31855, max31865 et max6675. Il est d\u00e9sormais possible de configurer les LED pour qu'elles se mettent \u00e0 jour pendant les longues commandes G-Code \u00e0 l'aide de la prise en charge du \"mod\u00e8le\" de LED. Plusieurs am\u00e9liorations sur le microcontr\u00f4leur. Nouvelle prise en charge des puces stm32h743, stm32h750, stm32l412, stm32g0b1, same70, same51 et same54. Prise en charge des lectures i2c sur atsamd et stm32f0. Prise en charge pwm mat\u00e9rielle sur stm32. Envoi d'\u00e9v\u00e9nements bas\u00e9 sur le signal Linux mcu. Nouveau support rp2040 pour \"make flash\", i2c et rp2040-e5 USB errata. Nouveaux modules ajout\u00e9s : angle, dac084S085, exclude_object, led, mpu9250, pca9632, smart_effector, z_thermal_adjust. Nouvelle cin\u00e9matique \"delt\u00e9sienne\" ajout\u00e9e. Nouvel outil dump_mcu ajout\u00e9. Plusieurs corrections de bogues et nettoyages de code.","title":"Klipper 0.11.0"},{"location":"Releases.html#klipper-0100","text":"Disponible le 29/09/2021. Changements majeurs dans cette version : Prise en charge de la mise \u00e0 l'origine \"Multi-MCU\". Il est d\u00e9sormais possible de c\u00e2bler un pilote de moteur pas \u00e0 pas et sa fin de course sur des microcontr\u00f4leurs s\u00e9par\u00e9s. Cela simplifie le c\u00e2blage des sondes Z sur les \"cartes de t\u00eate d'outil\". Klipper a maintenant un Serveur Discord et un Serveur Discourse . Le site Web de Klipper utilise d\u00e9sormais l'infrastructure \"mkdocs\". Il existe \u00e9galement un projet Klipper Translations . Prise en charge automatis\u00e9e du flash du micrologiciel via une carte SD sur de nombreuses cartes. Nouveau support cin\u00e9matique pour les imprimantes \"Hybrid CoreXY\" et \"Hybrid CoreXZ\". Klipper utilise maintenant rotation_distance pour configurer les distances de d\u00e9placement du moteur pas \u00e0 pas. Le code h\u00f4te principal de Klipper peut d\u00e9sormais communiquer directement avec les microcontr\u00f4leurs via le bus CAN. Nouveau syst\u00e8me \"d'analyse de mouvement\". Les mises \u00e0 jour des mouvements internes de Klipper et les r\u00e9sultats des capteurs peuvent \u00eatre suivis et enregistr\u00e9s pour analyse. Les pilotes de moteur pas \u00e0 pas Trinamic sont d\u00e9sormais surveill\u00e9s en permanence pour les conditions d'erreur. Prise en charge du microcontr\u00f4leur rp2040 (cartes Raspberry Pi Pico). Le syst\u00e8me \"make menuconfig\" utilise maintenant kconfiglib. De nombreux modules suppl\u00e9mentaires ajout\u00e9s : ds18b20, duplicate_pin_override, filament_motion_sensor, palette2, motion_report, pca9533, pulse_counter, save_variables, sdcard_loop, temperature_host, temperature_mcu Plusieurs corrections de bogues et nettoyages de code.","title":"Klipper 0.10.0"},{"location":"Releases.html#klipper-090","text":"Disponible le 20/10/2020. Changements majeurs dans cette version : Prise en charge de \"Input Shaping\" - un m\u00e9canisme pour contrer la r\u00e9sonance de l'imprimante. Il peut r\u00e9duire ou \u00e9liminer les \"ondulations\" dans les impressions. Nouveau syst\u00e8me \"Smooth Pressure Advance\". Cela impl\u00e9mente \"Pressure Advance\" sans introduire de changements de vitesse instantan\u00e9s. Il est d\u00e9sormais possible de r\u00e9gler l'avance de pression \u00e0 l'aide d'une m\u00e9thode \"Tour de r\u00e9glage\". Nouveau serveur API \"webhooks\". Fournit une interface JSON programmable \u00e0 Klipper. L'\u00e9cran LCD et le menu sont d\u00e9sormais configurables \u00e0 l'aide du langage Jinja2. Les pilotes de moteur pas \u00e0 pas TMC2208 peuvent d\u00e9sormais \u00eatre utilis\u00e9s en mode \"standalone\" avec Klipper. Prise en charge am\u00e9lior\u00e9e du BL-Touch v3. Identification USB am\u00e9lior\u00e9e. Klipper dispose d\u00e9sormais de son propre code d'identification USB et les micro-contr\u00f4leurs peuvent d\u00e9sormais signaler leurs num\u00e9ros de s\u00e9rie lors de l'identification USB. Nouveau support cin\u00e9matique pour les imprimantes \"Rotary Delta\" et \"CoreXZ\". Am\u00e9liorations du microcontr\u00f4leur : prise en charge de stm32f070, prise en charge de stm32f207, prise en charge des broches GPIO sur \"Linux MCU\", prise en charge du \"chargeur de d\u00e9marrage HID\" stm32, prise en charge du chargeur de d\u00e9marrage Chitu, prise en charge du chargeur de d\u00e9marrage MKS Robin. Am\u00e9lioration de la gestion des \u00e9v\u00e9nements Python pour \"garbage collection\". Nombreux modules suppl\u00e9mentaires ajout\u00e9s : adc_scaled, adxl345, bme280, display_status, extruder_stepper, fan_generic, hall_filament_width_sensor, htu21d, homing_heaters, input_shaper, lm75, print_stats, resonance_tester, shaper_calibrate, query_adc, graph_accelerometer, graph_extruder, graph_motion, graph_shaper, graph_temp_sensor, whconsole Plusieurs corrections de bogues et nettoyages de code.","title":"Klipper 0.9.0"},{"location":"Releases.html#klipper-091","text":"Disponible le 28/10/2020. Version contenant uniquement des corrections de bogues.","title":"Klipper 0.9.1"},{"location":"Releases.html#klipper-080","text":"Disponible le 21/10/2019. Changements majeurs dans cette version : Prise en charge du nouveau mod\u00e8le de commande G-Code. Le G-Code dans le fichier de configuration est maintenant \u00e9valu\u00e9 avec le langage Jinja2. Am\u00e9liorations de la gestion des pilotes pas \u00e0 pas Trinamic : Nouvelle prise en charge pour les pilotes TMC2209 et TMC5160. Commandes G-Code DUMP_TMC, SET_TMC_CURRENT et INIT_TMC am\u00e9lior\u00e9es. Prise en charge am\u00e9lior\u00e9e de la gestion TMC UART avec un multiplexage analogique. Prise en charge am\u00e9lior\u00e9e de la mise \u00e0 l'origine, du sondage et de la mise \u00e0 niveau du lit : Nouveaux modules manual_probe, bed_screws, screw_tilt_adjust, skew_correction, safe_z_home ajout\u00e9s. Sondage multi-\u00e9chantillons am\u00e9lior\u00e9 avec une logique de m\u00e9diane, de moyenne et de nouvel essai. Documentation am\u00e9lior\u00e9e pour le BL-Touch, l'\u00e9talonnage de la sonde, l'\u00e9talonnage de la fin de course, l'\u00e9talonnage des imprimantes delta, la mise \u00e0 l'origine sans capteur et l'\u00e9talonnage de la phase de fin de course. Prise en charge am\u00e9lior\u00e9e de la mise \u00e0 l'origine sur un axe Z de grande taille. De nombreuses am\u00e9liorations du micro-contr\u00f4leur Klipper : Klipper port\u00e9 sur : SAM3X8C, SAM4S8C, SAMD51, STM32F042, STM32F4 Nouvelles impl\u00e9mentations des pilotes USB CDC sur SAM3X, SAM4, STM32F4. Prise en charge am\u00e9lior\u00e9e du flashage de Klipper via USB. Prise en charge du SPI logiciel. Filtrage de temp\u00e9rature grandement am\u00e9lior\u00e9 sur le capteur LPC176x. Les param\u00e8tres de d\u00e9marrage des broches de sortie peuvent \u00eatre configur\u00e9s dans le micro-contr\u00f4leur. Nouveau site web avec la documentation Klipper : http://klipper3d.org/ Klipper a maintenant un logo. Support exp\u00e9rimental pour la cin\u00e9matique polaire et \"treuil \u00e0 c\u00e2ble\". Le fichier de configuration peut maintenant inclure d'autres fichiers de configuration. De nombreux modules suppl\u00e9mentaires ajout\u00e9s : board_pins, controller_fan, delay_gcode, dotstar, filament_switch_sensor, firmware_retraction, gcode_arcs, gcode_button, heater_generic, manual_stepper, mcp4018, mcp4728, neopixel, pause_resume, respond, temperature_sensor tsl1401cl_filament_width_sensor, tuning_tower De nombreuses commandes suppl\u00e9mentaires ajout\u00e9es : RESTORE_GCODE_STATE, SAVE_GCODE_STATE, SET_GCODE_VARIABLE, SET_HEATER_TEMPERATURE, SET_IDLE_TIMEOUT, SET_TEMPERATURE_FAN_TARGET Plusieurs corrections de bogues et nettoyages de code.","title":"Klipper 0.8.0"},{"location":"Releases.html#klipper-070","text":"Disponible le 20/12/2018. Changements majeurs dans cette version : Klipper prend d\u00e9sormais en charge le nivellement du lit par maillage Nouvel \u00e9talonnage des imprimantes delta \"am\u00e9lior\u00e9\" (\u00e9talonne les dimensions d'impression x/y sur les imprimantes delta) Gestion de la configuration pendant l'ex\u00e9cution des pilotes de moteur pas \u00e0 pas Trinamic (tmc2130, tmc2208, tmc2660) Prise en charge am\u00e9lior\u00e9e des capteurs de temp\u00e9rature : MAX6675, MAX31855, MAX31856, MAX31865, thermistances personnalis\u00e9es, capteurs de style pt100 Plusieurs nouveaux modules : temperature_fan, sx1509, force_move, mcp4451, z_tilt, quad_gantry_level, endstop_phase, bltouch Plusieurs nouvelles commandes ajout\u00e9es : SAVE_CONFIG, SET_PRESSURE_ADVANCE, SET_GCODE_OFFSET, SET_VELOCITY_LIMIT, STEPPER_BUZZ, TURN_OFF_HEATERS, M204, macros g-code personnalis\u00e9es Prise en charge \u00e9tendue de l'\u00e9cran LCD : Prise en charge des menus d'ex\u00e9cution Nouvelles ic\u00f4nes d'affichage Prise en charge des \u00e9crans \"uc1701\" et \"ssd1306\" Prise en charge de nouveaux micro-contr\u00f4leurs : Klipper port\u00e9 sur : LPC176x (Smoothieboards), SAM4E8E (Duet2), SAMD21 (Arduino Zero), STM32F103 (appareils \"Blue pill\"), atmega32u4 Nouveau pilote CDC USB g\u00e9n\u00e9rique impl\u00e9ment\u00e9 sur AVR, LPC176x, SAMD21 et STM32F103 Am\u00e9liorations des performances sur les processeurs ARM Le code cin\u00e9matique a \u00e9t\u00e9 r\u00e9\u00e9crit pour utiliser un \"solveur it\u00e9ratif\" Nouveaux tests automatis\u00e9s pour le logiciel h\u00f4te Klipper De nombreux nouveaux exemples de fichiers de configuration pour les imprimantes les plus courantes Mises \u00e0 jour de la documentation pour les chargeurs de d\u00e9marrage, l'analyse comparative, le portage des micro-contr\u00f4leurs, les v\u00e9rifications de configuration, le mappage des broches, les param\u00e8tres du trancheur, le packaging, et plus Plusieurs corrections de bogues et nettoyages de code","title":"Klipper 0.7.0"},{"location":"Releases.html#klipper-060","text":"Disponible le 31/03/2018. Changements majeurs dans cette version : V\u00e9rifications am\u00e9lior\u00e9es des d\u00e9faillances mat\u00e9rielles des \u00e9l\u00e9ments chauffants et des thermistances Prise en charge des sondes Z Premi\u00e8re prise en charge de l'\u00e9talonnage automatique des param\u00e8tres sur les deltas (via une nouvelle commande delta_calibrate) Premi\u00e8re prise en charge de la compensation d'inclinaison du lit (via la commande bed_tilt_calibrate) Premi\u00e8re prise en charge de la \u00ab mise \u00e0 l'origine 's\u00fbre' \u00bb et des surcharges des mises \u00e0 l'origine Prise en charge de l'affichage de l'\u00e9tat sur les \u00e9crans RepRapDiscount style 2004 et 12864 Nouvelles am\u00e9liorations pour la multi-extrusion : Prise en charge des chauffages partag\u00e9s Prise en charge des chariots doubles (IDEX) Prise en charge de la configuration de plusieurs steppers par axe (par exemple, double Z) Prise en charge des broches de sortie num\u00e9riques et pwm personnalis\u00e9es (avec une nouvelle commande SET_PIN) Prise en charge d'une \"carte SD virtuelle\" qui permet d'imprimer directement depuis Klipper (aide sur les machines trop lentes pour bien ex\u00e9cuter OctoPrint) Prise en charge du r\u00e9glage de diff\u00e9rentes longueurs de bras sur chaque tour d'une delta Prise en charge des commandes G-Code M220/M221 (remplacement du facteur de vitesse/remplacement du facteur d'extrusion) Plusieurs mises \u00e0 jour de la documentation : De nombreux nouveaux exemples de fichiers de configuration pour les imprimantes les plus courantes Nouvel exemple de configuration multi-MCU Nouvel exemple de configuration du capteur bltouch Nouveaux documents sur la FAQ, la v\u00e9rification de la configuration et le G-Code Prise en charge des tests d'int\u00e9gration continue sur tous les commits github Plusieurs corrections de bogues et nettoyages de code","title":"Klipper 0.6.0"},{"location":"Releases.html#klipper-050","text":"Disponible le 25/10/2017. Changements majeurs dans cette version : Prise en charge des imprimantes avec plusieurs extrudeuses. Prise en charge pour l'ex\u00e9cution sur le PRU Beaglebone. Prise en charge de la carte Replicape. Prise en charge de l'ex\u00e9cution du code du microcontr\u00f4leur dans un processus Linux en temps r\u00e9el. Prise en charge de plusieurs microcontr\u00f4leurs. (Par exemple, on pourrait contr\u00f4ler une extrudeuse avec un microcontr\u00f4leur et le reste de l'imprimante avec un autre.) Une synchronisation d'horloge logicielle est mise en \u0153uvre pour coordonner les actions entre les microcontr\u00f4leurs. Am\u00e9liorations des performances des moteurs pas \u00e0 pas (AVR 20Mhz jusqu'\u00e0 189K pas par seconde). Prise en charge du contr\u00f4le des servos et prise en charge de la d\u00e9finition des ventilateurs de refroidissement des buses. Plusieurs corrections de bogues et nettoyages de code","title":"Klipper 0.5.0"},{"location":"Releases.html#klipper-040","text":"Disponible le 03/05/2017. Changements majeurs dans cette version : Installation am\u00e9lior\u00e9e sur les machines Raspberry Pi. La majeure partie de l'installation est maintenant script\u00e9e. Prise en charge des imprimantes corexy Mises \u00e0 jour de la documentation : nouveau document cin\u00e9matique, nouveau guide de r\u00e9glage Pressure Advance, nouveaux exemples de fichiers de configuration, et plus Am\u00e9liorations des performances des moteurs pas \u00e0 pas (AVR 20Mhz sur 175K pas par seconde, Arduino Due sur 460K) Prise en charge des r\u00e9initialisations automatiques du microcontr\u00f4leur. Prise en charge des r\u00e9initialisations via basculement de l'alimentation USB sur Raspberry Pi. L'algorithme d'avance de pression fonctionne d\u00e9sormais avec anticipation pour r\u00e9duire les changements de pression dans les virages. Prise en charge de la limitation de la vitesse maximale des mouvements courts en zigzag Prise en charge des capteurs AD595 Plusieurs corrections de bogues et nettoyages de code","title":"Klipper 0.4.0"},{"location":"Releases.html#klipper-030","text":"Disponible le 23/12/2016. Changements majeurs dans cette version : Documentation am\u00e9lior\u00e9e Prise en charge des imprimantes avec cin\u00e9matique delta Prise en charge du microcontr\u00f4leur Arduino Due (ARM cortex-M3) Prise en charge des microcontr\u00f4leurs AVR bas\u00e9s sur USB Prise en charge de l'algorithme \"d'avance de pression\" - il r\u00e9duit le suintement pendant les impressions. Nouvelle fonctionnalit\u00e9 \"but\u00e9e de fin de course bas\u00e9e sur la phase de moteurs pas \u00e0 pas\" - permet une plus grande pr\u00e9cision sur la prise d'origine de la fin de course. Prise en charge des commandes \"g-code \u00e9tendu\" telles que \"help\", \"restart\" et \"status\". Prise en charge du rechargement de la configuration Klipper et du red\u00e9marrage du logiciel h\u00f4te en \u00e9mettant une commande \"restart\" depuis le terminal. Am\u00e9liorations des performances des moteurs pas \u00e0 pas (AVR 20Mhz jusqu'\u00e0 158K pas par seconde). Gestion des erreurs am\u00e9lior\u00e9e. La plupart des erreurs sont maintenant affich\u00e9es via le terminal avec une aide sur la fa\u00e7on de les r\u00e9soudre. Plusieurs corrections de bogues et nettoyages de code","title":"Klipper 0.3.0"},{"location":"Releases.html#klipper-020","text":"Premi\u00e8re version de Klipper. Disponible le 25/05/2016. Les principales fonctionnalit\u00e9s disponibles dans la version initiale incluent : Prise en charge de base des imprimantes cart\u00e9siennes (moteurs pas \u00e0 pas, extrudeur, lit chauffant, ventilateur de refroidissement). Prise en charge des commandes g-code de base. Prise en charge de l'interfa\u00e7age avec OctoPrint. Acc\u00e9l\u00e9ration et gestion de l'anticipation Prise en charge des microcontr\u00f4leurs AVR via des ports s\u00e9rie standard","title":"Klipper 0.2.0"},{"location":"Resonance_Compensation.html","text":"Compensation de r\u00e9sonance \u00b6 Klipper prend en charge la mise en forme de l'entr\u00e9e, une technique utilis\u00e9e pour r\u00e9duire l'effet de r\u00e9sonance (\u00e9galement connu sous le nom d'\u00e9cho, d'image fant\u00f4me ou d'ondulation) dans les impressions. La r\u00e9sonance est un d\u00e9faut d'impression de surface lorsque des \u00e9l\u00e9ments tels que des bords se r\u00e9p\u00e8tent sur une surface imprim\u00e9e sous forme d'un \"\u00e9cho\" subtil : | | | La r\u00e9sonance est caus\u00e9e par des vibrations m\u00e9caniques dans l'imprimante dues \u00e0 des changements rapides de direction durant une impression. Notez que la r\u00e9sonance a g\u00e9n\u00e9ralement des origines m\u00e9caniques : cadre de l'imprimante insuffisamment rigide, courroies non tendues ou trop \u00e9lastiques, probl\u00e8mes d'alignement des pi\u00e8ces m\u00e9caniques, masse mobile importante, etc. Ces probl\u00e8mes doivent \u00eatre v\u00e9rifi\u00e9s et corrig\u00e9s en premier lieu, si possible. La mise en forme de l'entr\u00e9e est une technique de contr\u00f4le en boucle ouverte qui cr\u00e9e un signal de commande annulant ses propres vibrations. La mise en forme de l'entr\u00e9e n\u00e9cessite quelques r\u00e9glages et mesures avant de pouvoir \u00eatre activ\u00e9e. Outre la r\u00e9sonance, la mise en forme de l'entr\u00e9e r\u00e9duit g\u00e9n\u00e9ralement les vibrations et les secousses de l'imprimante en g\u00e9n\u00e9ral, et peut \u00e9galement am\u00e9liorer la fiabilit\u00e9 du mode stealthChop des pilotes Trinamic. R\u00e9glages \u00b6 Le r\u00e9glage de base n\u00e9cessite de mesurer les fr\u00e9quences de r\u00e9sonance de l'imprimante en imprimant un mod\u00e8le de test. Tranchez le mod\u00e8le de test de r\u00e9sonance, qui se trouve dans docs/prints/ringing_tower.stl , dans le trancheur : La hauteur de couche sugg\u00e9r\u00e9e est de 0,2 ou 0,25 mm. Les couches de remplissage et de finition peuvent \u00eatre r\u00e9gl\u00e9es sur 0. Utilisez 1-2 p\u00e9rim\u00e8tres, ou mieux encore le mode vase avec 1-2 mm de base. Utilisez une vitesse suffisamment \u00e9lev\u00e9e, environ 80-100 mm/s, pour les p\u00e9rim\u00e8tres externes . Veillez \u00e0 ce que le temps de pause minimum soit au maximum de 3 secondes. Assurez-vous que le \"contr\u00f4le d'acc\u00e9l\u00e9ration\" est d\u00e9sactiv\u00e9 dans le trancheur. Ne tournez pas le mod\u00e8le. Le mod\u00e8le comporte des marques X et Y \u00e0 l'arri\u00e8re du mod\u00e8le. Notez l'emplacement inhabituel des marques par rapport aux axes de l'imprimante - il ne s'agit pas d'une erreur. Les marques peuvent \u00eatre utilis\u00e9es plus tard dans le processus de r\u00e9glage comme r\u00e9f\u00e9rence, car elles indiquent \u00e0 quel axe correspondent les mesures. Fr\u00e9quence de r\u00e9sonance \u00b6 Tout d'abord, mesurez la fr\u00e9quence de r\u00e9sonance . Si le param\u00e8tre square_corner_velocity a \u00e9t\u00e9 modifi\u00e9, remettez-le \u00e0 5.0. Il n'est pas conseill\u00e9 de l'augmenter lors de l'utilisation de l'input shaper car cela peut provoquer plus de lissage dans les pi\u00e8ces - il est pr\u00e9f\u00e9rable d'utiliser une valeur d'acc\u00e9l\u00e9ration plus \u00e9lev\u00e9e \u00e0 la place. Augmentez max_accel_to_decel en lan\u00e7ant la commande suivante : SET_VELOCITY_LIMIT ACCEL_TO_DECEL=7000 D\u00e9sactivez l'avance de pression : SET_PRESSURE_ADVANCE ADVANCE=0 Si vous avez d\u00e9j\u00e0 ajout\u00e9 la section [input_shaper] au printer.cfg, ex\u00e9cutez la commande SET_INPUT_SHAPER SHAPER_FREQ_X=0 SHAPER_FREQ_Y=0 . Si vous obtenez l'erreur \"Unknown command\", vous pouvez l'ignorer \u00e0 ce stade et continuer les mesures. Ex\u00e9cutez la commande : TUNING_TOWER COMMAND=SET_VELOCITY_LIMIT PARAMETER=ACCEL START=1500 STEP_DELTA=500 STEP_HEIGHT=5 Dans la pratique, nous essayons de rendre la r\u00e9sonance plus prononc\u00e9e en d\u00e9finissant diff\u00e9rentes valeurs \u00e9lev\u00e9es pour l'acc\u00e9l\u00e9ration. Cette commande augmentera l'acc\u00e9l\u00e9ration tous les 5 mm \u00e0 partir de 1500 mm/sec\u00b2 : 1500 mm/sec\u00b2, 2000 mm/sec\u00b2, 2500 mm/sec\u00b2 et ainsi de suite jusqu'\u00e0 7000 mm/sec\u00b2 pour la derni\u00e8re bande. Imprimez le mod\u00e8le de test tranch\u00e9 avec les param\u00e8tres sugg\u00e9r\u00e9s. Vous pouvez arr\u00eater l'impression plus t\u00f4t si la r\u00e9sonance est clairement visible et si vous constatez que l'acc\u00e9l\u00e9ration devient trop forte pour votre imprimante (par exemple, l'imprimante tremble trop ou commence \u00e0 sauter des pas). Utilisez les marques X et Y \u00e0 l'arri\u00e8re du mod\u00e8le comme r\u00e9f\u00e9rence. Les mesures du c\u00f4t\u00e9 avec la marque X doivent \u00eatre utilis\u00e9es pour la configuration de l'axe X, et la marque Y - pour la configuration de l'axe Y. Mesurez la distance D (en mm) entre plusieurs oscillations sur la pi\u00e8ce avec la marque X, pr\u00e8s des encoches, en sautant de pr\u00e9f\u00e9rence la ou les deux premi\u00e8res oscillations. Pour mesurer plus facilement la distance entre les oscillations, marquez d'abord les oscillations, puis mesurez la distance entre les marques avec une r\u00e8gle ou un pied \u00e0 coulisse :| | | Comptez le nombre d'oscillations N correspondant \u00e0 la distance mesur\u00e9e D . Si vous ne savez pas comment compter les oscillations, reportez-vous \u00e0 l'image ci-dessus, qui montre N = 6 oscillations. Calculer la fr\u00e9quence de r\u00e9sonance de l'axe X comme V \u00b7 N / D (Hz), o\u00f9 V est la vitesse des p\u00e9rim\u00e8tres ext\u00e9rieurs (mm/s). Pour l'exemple ci-dessus, nous avons marqu\u00e9 6 oscillations, et le test a \u00e9t\u00e9 imprim\u00e9 \u00e0 une vitesse de 100 mm/s, donc la fr\u00e9quence est 100 * 6 / 12,14 \u2248 49,4 Hz. Faites (8) - (10) pour la marque Y \u00e9galement. Notez que la r\u00e9sonanc sur l'impression de test devrait correspondre au mod\u00e8le des encoches courbes, comme dans l'image ci-dessus. Si ce n'est pas le cas, alors ce d\u00e9faut n'est pas vraiment une r\u00e9sonance et a probablement une origine diff\u00e9rente - soit m\u00e9canique, soit un probl\u00e8me d'extrudeuse. Ce probl\u00e8me doit \u00eatre r\u00e9solu avant d'activer et de r\u00e9gler les fa\u00e7onneurs d'entr\u00e9e. Si les mesures ne sont pas fiables parce que, par exemple, la distance entre les oscillations n'est pas stable, cela peut signifier que l'imprimante a plusieurs fr\u00e9quences de r\u00e9sonance sur le m\u00eame axe. On peut essayer de suivre le processus de r\u00e9glage d\u00e9crit dans la section Mesures peu fiables des fr\u00e9quences de r\u00e9sonance \u00e0 la place et obtenir quand m\u00eame quelque chose de la technique de mise en forme de l'entr\u00e9e. La fr\u00e9quence de r\u00e9sonance peut d\u00e9pendre de la position du mod\u00e8le sur la plaque de construction et de la hauteur Z, surtout sur les imprimantes delta ; vous pouvez v\u00e9rifier si vous observez des diff\u00e9rences de fr\u00e9quences \u00e0 diff\u00e9rentes positions le long des c\u00f4t\u00e9s du mod\u00e8le de test et \u00e0 diff\u00e9rentes hauteurs. Vous pouvez calculer les fr\u00e9quences de r\u00e9sonance moyennes sur les axes X et Y si c'est le cas. Si la fr\u00e9quence de r\u00e9sonance mesur\u00e9e est tr\u00e8s basse (inf\u00e9rieure \u00e0 20-25 Hz environ), il peut \u00eatre judicieux d'investir dans le raidissement de l'imprimante ou la r\u00e9duction de la masse mobile - selon ce qui est applicable dans votre cas - avant de poursuivre le r\u00e9glage de la mise en forme de l'entr\u00e9e et de mesurer \u00e0 nouveau les fr\u00e9quences par la suite. Pour de nombreux mod\u00e8les d'imprimantes populaires, il existe souvent des solutions d\u00e9j\u00e0 disponibles. Les fr\u00e9quences de r\u00e9sonance peuvent changer si des modifications sont apport\u00e9es \u00e0 l'imprimante qui affectent la masse en mouvement ou modifient la rigidit\u00e9 du syst\u00e8me, par exemple : Si la t\u00eate d'impression est modifi\u00e9e, par ex. changement de moteur pas \u00e0 pas (plus lourd ou plus l\u00e9ger) pour une extrusion directe, remplacement de la t\u00eate de l'outil (plus ou moins lourde), ajout d'un ventilateur plus lourd, etc. La tension des courroies a \u00e9t\u00e9 modifi\u00e9e. Des pi\u00e8ces con\u00e7ues pour augmenter la rigidit\u00e9 du cadre sont install\u00e9es. Un plateau diff\u00e9rent est install\u00e9 sur une imprimante \u00e0 lit mobile, ou une plaque de verre est ajout\u00e9e, etc. Si de tels changements sont apport\u00e9s, Il est conseill\u00e9 de mesurer au moins les fr\u00e9quences de r\u00e9sonance pour v\u00e9rifier s'il y a eu un changement ou pas. Configuration de l'\"input shaper\" \u00b6 Une fois les fr\u00e9quences de r\u00e9sonance des axes X et Y mesur\u00e9es, vous pouvez ajouter la section suivante \u00e0 votre printer.cfg : [input_shaper] shaper_freq_x: ... # frequence pour la marque X sur le mod\u00e8le de test shaper_freq_y: ... # frequence pour la marque Y sur le mod\u00e8le de test Pour l'exemple ci-dessus, nous obtenons shaper_freq_x/y = 49,4. Choix de l'\"input shaper\" \u00b6 Klipper prend en charge plusieurs type d'\"input shaper\". Ils diff\u00e8rent par leur sensibilit\u00e9 aux erreurs d\u00e9terminant la fr\u00e9quence de r\u00e9sonance et le degr\u00e9 de lissage qu'ils provoquent dans les pi\u00e8ces imprim\u00e9es. De plus, certains de ces \"input shaper\" comme 2HUMP_EI et 3HUMP_EI ne doivent g\u00e9n\u00e9ralement pas \u00eatre utilis\u00e9s avec shaper_freq = fr\u00e9quence de r\u00e9sonance - ils sont configur\u00e9s \u00e0 partir de diff\u00e9rentes consid\u00e9rations pour r\u00e9duire plusieurs r\u00e9sonances \u00e0 la fois (ndt\u202f: le 2HUMP_EI est \u00e0 utiliser lorsque deux pics de r\u00e9sonance sont d\u00e9tect\u00e9s, le 3HUMP_EI est \u00e0 utiliser lorsque trois pics de r\u00e9sonance sont d\u00e9tect\u00e9s). Pour la plupart des imprimantes, les shapers MZV ou EI peuvent \u00eatre recommand\u00e9s. Cette section d\u00e9crit un processus de test pour choisir entre eux et d\u00e9terminer quelques autres param\u00e8tres connexes. Imprimez le mod\u00e8le de test de r\u00e9sonance comme suit : Red\u00e9marrez le micrologiciel : RESTART Pr\u00e9parez-vous pour le test : SET_VELOCITY_LIMIT ACCEL_TO_DECEL=7000 D\u00e9sactivez l'avance de pression : SET_PRESSURE_ADVANCE ADVANCE=0 Ex\u00e9cutez : SET_INPUT_SHAPER SHAPER_TYPE=MZV Ex\u00e9cutez la commande : TUNING_TOWER COMMAND=SET_VELOCITY_LIMIT PARAMETER=ACCEL START=1500 STEP_DELTA=500 STEP_HEIGHT=5 Imprimez le mod\u00e8le de test tranch\u00e9 avec les param\u00e8tres sugg\u00e9r\u00e9s. Si vous ne voyez pas de r\u00e9sonance \u00e0 ce stade, l'utilisation de l'\"input shaper\" MZV peut \u00eatre recommand\u00e9e. Si vous voyez une r\u00e9sonance, mesurez \u00e0 nouveau les fr\u00e9quences en suivant les \u00e9tapes (8) \u00e0 (10) d\u00e9crites dans la section Fr\u00e9quence de r\u00e9sonance . Si les fr\u00e9quences diff\u00e8rent consid\u00e9rablement des valeurs obtenues pr\u00e9c\u00e9demment, une configuration d'input shaper plus complexe est n\u00e9cessaire. Vous pouvez vous r\u00e9f\u00e9rer aux d\u00e9tails techniques de la section Input shapers . Sinon, passez \u00e0 l'\u00e9tape suivante. Essayez l'input shaper EI. Pour l'essayer, r\u00e9p\u00e9tez les \u00e9tapes (1) \u00e0 (6) ci-dessus, mais en ex\u00e9cutant \u00e0 l'\u00e9tape 4 la commande suivante \u00e0 la place : SET_INPUT_SHAPER SHAPER_TYPE=EI . Comparez deux impressions avec les input shaper MZV et EI. Si EI montre des r\u00e9sultats sensiblement meilleurs que MZV, utilisez EI, sinon pr\u00e9f\u00e9rez MZV. Notez que le input shaper EI provoquera plus de lissage dans les pi\u00e8ces imprim\u00e9es (voir la section suivante pour plus de d\u00e9tails). Ajoutez le param\u00e8tre shaper_type: mzv (ou ei) \u00e0 la section [input_shaper], par exemple : [input_shaper] shaper_freq_x: ... shaper_freq_y: ... shaper_type: mzv Quelques notes sur le choix de l'input shaper : L' input shaper EI peut \u00eatre plus adapt\u00e9 aux imprimantes \u00e0 lit mobile (si la fr\u00e9quence de r\u00e9sonance et le lissage r\u00e9sultant le permettent) : plus le filament est d\u00e9pos\u00e9 sur le lit en mouvement, plus la masse du lit augmente et la fr\u00e9quence de r\u00e9sonance diminue. \u00c9tant donn\u00e9 que le input shaper EI est plus robuste aux changements de fr\u00e9quence de r\u00e9sonance, il peut mieux fonctionner lors de l'impression de grandes pi\u00e8ces. En raison de la nature de la cin\u00e9matique delta, les fr\u00e9quences de r\u00e9sonance peuvent diff\u00e9rer consid\u00e9rablement dans diff\u00e9rentes parties du volume de construction. Par cons\u00e9quent, l'input shaper EI peut \u00eatre mieux adapt\u00e9 aux imprimantes delta plut\u00f4t que MZV ou ZV. Si la fr\u00e9quence de r\u00e9sonance est suffisamment grande (plus de 50-60 Hz), alors on peut m\u00eame essayer de tester 2HUMP_EI (en ex\u00e9cutant le test sugg\u00e9r\u00e9 ci-dessus avec SET_INPUT_SHAPER SHAPER_TYPE=2HUMP_EI ), mais v\u00e9rifiez les consid\u00e9rations dans la section ci-dessous avant de l'activer. S\u00e9lection de max_accel \u00b6 Vous devriez obtenir le test imprim\u00e9 avec l'input shaper choisi \u00e0 l'\u00e9tape pr\u00e9c\u00e9dente (si vous ne le faites pas, imprimez le mod\u00e8le de test d\u00e9coup\u00e9 avec les param\u00e8tres sugg\u00e9r\u00e9s avec l'avance de pression d\u00e9sactiv\u00e9e SET_PRESSURE_ADVANCE ADVANCE=0 et avec la tour de r\u00e9glage activ\u00e9e comme TUNING_TOWER COMMAND=SET_VELOCITY_LIMIT PARAMETER=ACCEL START=1500 STEP_DELTA=500 STEP_HEIGHT=5 ). Notez qu'\u00e0 des acc\u00e9l\u00e9rations tr\u00e8s \u00e9lev\u00e9es, selon la fr\u00e9quence de r\u00e9sonance et l'input shaper choisi (par exemple, le shaper EI cr\u00e9e plus de lissage que MZV), cela peut provoquer trop de lissage et d'arrondi des pi\u00e8ces. Ainsi, max_accel doit \u00eatre choisi de mani\u00e8re \u00e0 l'\u00e9viter. Un autre param\u00e8tre ayant un impact sur le lissage est square_corner_velocity , il n'est donc pas conseill\u00e9 de l'augmenter au-dessus de la valeur par d\u00e9faut de 5 mm/s pour \u00e9viter un lissage accru. Afin de s\u00e9lectionner une valeur max_accel appropri\u00e9e, inspectez le mod\u00e8le pour l'input shaper choisi. Tout d'abord, notez \u00e0 quelle acc\u00e9l\u00e9ration la r\u00e9sonance est encore faible - convenant \u00e9galement \u00e0 l'imprimante. Ensuite, v\u00e9rifiez le lissage. Pour vous aider, le mod\u00e8le de test a un petit espace dans la paroi (0,15 mm) : \u00c0 mesure que l'acc\u00e9l\u00e9ration augmente, le lissage augmente \u00e9galement et l'espacement r\u00e9el dans l'impression s'\u00e9largit : Sur cette image, l'acc\u00e9l\u00e9ration augmente de gauche \u00e0 droite, et l'\u00e9cart commence \u00e0 cro\u00eetre \u00e0 partir de 3500 mm/s\u00b2 (5\u00e8me bande \u00e0 partir de la gauche). Dans ce cas, la valeur pour max_accel = 3000 (mm/s\u00b2) permet d'\u00e9viter un lissage excessif. Notez l'acc\u00e9l\u00e9ration lorsque l'\u00e9cart est encore tr\u00e8s faible dans votre test d'impression. Si vous voyez des renflements, mais aucun espace dans le mur, m\u00eame \u00e0 des acc\u00e9l\u00e9rations \u00e9lev\u00e9es, cela peut \u00eatre d\u00fb \u00e0 une avance de pression (PA) d\u00e9sactiv\u00e9e, en particulier sur les extrudeurs de type Bowden. Si tel est le cas, vous devrez peut-\u00eatre r\u00e9p\u00e9ter l'impression avec le PA activ\u00e9. Cela peut \u00e9galement \u00eatre le r\u00e9sultat d'un flux de filament mal calibr\u00e9 (trop \u00e9lev\u00e9), il faut donc v\u00e9rifier cela aussi. Choisissez la valeur minimale des deux valeurs d'acc\u00e9l\u00e9ration (de la r\u00e9sonance et du lissage) et affectez-l\u00e0 \u00e0 max_accel dans printer.cfg. Notez qu'il peut arriver - en particulier \u00e0 des fr\u00e9quences de r\u00e9sonance basses - que l'input shaper EI provoque trop de lissage, m\u00eame \u00e0 des acc\u00e9l\u00e9rations faibles. Dans ce cas, MZV peut \u00eatre un meilleur choix, car il peut permettre des valeurs d'acc\u00e9l\u00e9ration plus \u00e9lev\u00e9es. \u00c0 des fr\u00e9quences de r\u00e9sonance tr\u00e8s basses (~ 25 Hz et moins), m\u00eame l'input shaper MZV peut cr\u00e9er trop de lissage. Si tel est le cas, vous pouvez \u00e9galement essayer de r\u00e9p\u00e9ter les \u00e9tapes de la section Choix de l'input shaper avec l'input shaper ZV, en utilisant la commande SET_INPUT_SHAPER SHAPER_TYPE=ZV \u00e0 la place. L'input shaper ZV devrait montrer encore moins de lissage que MZV, mais il est plus sensible aux erreurs de mesure des fr\u00e9quences de r\u00e9sonance. Si une fr\u00e9quence de r\u00e9sonance est trop faible (inf\u00e9rieure \u00e0 20-25 Hz), il peut \u00eatre judicieux d'augmenter la rigidit\u00e9 de l'imprimante ou de r\u00e9duire la masse en mouvement. Sinon, l'acc\u00e9l\u00e9ration et la vitesse d'impression peuvent \u00eatre limit\u00e9es en raison d'un lissage trop important qui remplacera la r\u00e9sonance. R\u00e9glage fin des fr\u00e9quences de r\u00e9sonance \u00b6 Notez que la pr\u00e9cision des mesures des fr\u00e9quences de r\u00e9sonance \u00e0 l'aide du mod\u00e8le de test de r\u00e9sonance est suffisante dans la plupart des cas, donc un r\u00e9glage suppl\u00e9mentaire n'est pas utile. Si vous voulez toujours essayer de rev\u00e9rifier vos r\u00e9sultats (par exemple, si vous voyez toujours une r\u00e9sonance apr\u00e8s avoir imprim\u00e9 un mod\u00e8le de test avec un input shaper de votre choix avec les fr\u00e9quences mesur\u00e9es pr\u00e9c\u00e9demment), vous pouvez suivre les \u00e9tapes de cette section. Notez que si vous voyez une r\u00e9sonance \u00e0 diff\u00e9rentes fr\u00e9quences apr\u00e8s avoir activ\u00e9 [input_shaper], cette section ne vous aidera pas. En consid\u00e9rant que vous avez tranch\u00e9 le mod\u00e8le de r\u00e9sonance avec les param\u00e8tres sugg\u00e9r\u00e9s, effectuez les \u00e9tapes suivantes pour chacun des axes X et Y : Pr\u00e9parez-vous pour le test : SET_VELOCITY_LIMIT ACCEL_TO_DECEL=7000 Assurez-vous que l'avance de pression est d\u00e9sactiv\u00e9e : SET_PRESSURE_ADVANCE ADVANCE=0 Ex\u00e9cutez : SET_INPUT_SHAPER SHAPER_TYPE=ZV \u00c0 partir du mod\u00e8le de test de r\u00e9sonance imprim\u00e9 avec l'input shaper choisi, s\u00e9lectionnez l'acc\u00e9l\u00e9ration montrant suffisamment bien la r\u00e9sonance et d\u00e9finissez-la avec : SET_VELOCITY_LIMIT ACCEL=... Calculez les param\u00e8tres n\u00e9cessaires pour que la commande TUNING_TOWER r\u00e8gle le param\u00e8tre shaper_freq_x comme suit : start = shaper_freq_x * 83 / 132 et factor = shaper_freq_x / 66, o\u00f9 shaper_freq_x est la valeur indiqu\u00e9e dans printer.cfg . Ex\u00e9cutez la commande : TUNING_TOWER COMMAND=SET_INPUT_SHAPER PARAMETER=SHAPER_FREQ_X START=start FACTOR=factor BAND=5 en utilisant les valeurs start et factor calcul\u00e9es \u00e0 l'\u00e9tape (5). Imprimez le mod\u00e8le de test. Remettez la valeur de fr\u00e9quence d'origine : SET_INPUT_SHAPER SHAPER_FREQ_X=... . Trouvez la bande r\u00e9sonnant le moins et comptez son num\u00e9ro \u00e0 partir du bas en commen\u00e7ant \u00e0 1. Calculez la nouvelle valeur shaper_freq_x selon la formule : ancien shaper_freq_x * (39 + 5 * #band-number) / 66. R\u00e9p\u00e9tez ces \u00e9tapes pour l'axe Y de la m\u00eame mani\u00e8re, en rempla\u00e7ant les r\u00e9f\u00e9rences \u00e0 l'axe X par l'axe Y (par exemple, remplacez shaper_freq_x par shaper_freq_y dans les formules et dans la commande TUNING_TOWER ). A titre d'exemple, supposons que vous ayez mesur\u00e9 la fr\u00e9quence de r\u00e9sonance pour l'un des axes \u00e0 45 Hz. Cela donne les valeurs start = 45 * 83 / 132 = 28,30 et factor = 45 / 66 = 0,6818 pour la commande TUNING_TOWER . Supposons maintenant qu'apr\u00e8s l'impression du mod\u00e8le de test, la quatri\u00e8me bande \u00e0 partir du bas donne le moins de r\u00e9sonance. Cela donne le shaper_freq_ mis \u00e0 jour \u00e9gal \u00e0 45 * (39 + 5 * 4) / 66 \u2248 40,23. Une fois les deux nouveaux param\u00e8tres shaper_freq_x et shaper_freq_y calcul\u00e9s, vous pouvez mettre \u00e0 jour la section [input_shaper] dans printer.cfg avec le nouveau shaper_freq_x et shaper_freq_y . Avance de pression (PA) \u00b6 Si vous utilisiez l'avance de pression, il pourra \u00eatre n\u00e9cessaire de la r\u00e9ajuster. Suivez les instructions pour trouver la nouvelle valeur, si elle diff\u00e8re de la pr\u00e9c\u00e9dente. Assurez-vous de red\u00e9marrer Klipper avant de r\u00e9gler l'avance de pression. Mesures peu fiables des fr\u00e9quences de r\u00e9sonance \u00b6 Si vous ne parvenez pas \u00e0 mesurer les fr\u00e9quences de r\u00e9sonance, par ex. si la distance entre les oscillations n'est pas stable, vous pouvez toujours profiter des techniques de l'input shaper, mais les r\u00e9sultats peuvent ne pas \u00eatre aussi bons qu'avec des mesures appropri\u00e9es des fr\u00e9quences, et n\u00e9cessiteront un peu plus de r\u00e9glages et d'impressions du mod\u00e8le de test. Notez qu'une autre possibilit\u00e9 est d'acheter et d'installer un acc\u00e9l\u00e9rom\u00e8tre et de mesurer les r\u00e9sonances avec (reportez-vous \u00e0 la documentation d\u00e9crivant le mat\u00e9riel requis et le processus de configuration) - mais cette option n\u00e9cessite quelques soudures et un peu de sertissage. Pour le r\u00e9glage, ajoutez une section [input_shaper] vide \u00e0 votre printer.cfg . Ensuite, en supposant que vous avez tranch\u00e9 le mod\u00e8le de r\u00e9sonance avec les param\u00e8tres sugg\u00e9r\u00e9s, imprimez le mod\u00e8le de test 3 fois comme suit. Premi\u00e8re fois, avant l'impression, ex\u00e9cutez RESTART SET_VELOCITY_LIMIT ACCEL_TO_DECEL=7000 SET_PRESSURE_ADVANCE ADVANCE=0 SET_INPUT_SHAPER SHAPER_TYPE=2HUMP_EI SHAPER_FREQ_X=60 SHAPER_FREQ_Y=60 TUNING_TOWER COMMAND=SET_VELOCITY_LIMIT PARAMETER=ACCEL START=1500 STEP_DELTA=500 STEP_HEIGHT=5 et imprimez le mod\u00e8le. Ensuite, imprimez \u00e0 nouveau le mod\u00e8le, mais avant d'imprimer, ex\u00e9cutez \u00e0 la place SET_INPUT_SHAPER SHAPER_TYPE=2HUMP_EI SHAPER_FREQ_X=50 SHAPER_FREQ_Y=50 TUNING_TOWER COMMAND=SET_VELOCITY_LIMIT PARAMETER=ACCEL START=1500 STEP_DELTA=500 STEP_HEIGHT=5 Imprimez ensuite le mod\u00e8le pour la 3\u00e8me fois, mais ex\u00e9cutez maintenant SET_INPUT_SHAPER SHAPER_TYPE=2HUMP_EI SHAPER_FREQ_X=40 SHAPER_FREQ_Y=40 TUNING_TOWER COMMAND=SET_VELOCITY_LIMIT PARAMETER=ACCEL START=1500 STEP_DELTA=500 STEP_HEIGHT=5 Dans la pratique nous imprimons le mod\u00e8le de test de r\u00e9sonance avec TUNING_TOWER en utilisant l'input shaper 2HUMP_EI avec shaper_freq = 60 Hz, 50 Hz et 40 Hz. Si aucun des mod\u00e8les ne d\u00e9montre d'am\u00e9lioration de la r\u00e9sonance, aucune des techniques d'input shaper ne pourra vous aider. Sinon, il se peut que tous les mod\u00e8les n'affichent aucune r\u00e9sonance, ou que certains affichent la r\u00e9sonance et d'autres pas trop. Choisissez le mod\u00e8le de test avec la fr\u00e9quence la plus \u00e9lev\u00e9e qui montre encore de bonnes am\u00e9liorations dans la r\u00e9sonance. Par exemple, si les mod\u00e8les 40 Hz et 50 Hz n'affichent presque aucune r\u00e9sonance et que le mod\u00e8le 60 Hz affiche d\u00e9j\u00e0 un peu plus de r\u00e9sonance, restez \u00e0 50 Hz. V\u00e9rifiez maintenant si l'input shaper EI peut fonctionner dans votre cas. Choisissez la fr\u00e9quence de l'input shaper EI en fonction de la fr\u00e9quence de l'input shaper 2HUMP_EI que vous avez choisie : Pour l'input shaper 2HUMP_EI 60 Hz, utilisez l'input shaper EI avec shaper_freq = 50 Hz. Pour l'input shaper 2HUMP_EI 50 Hz, utilisez l'input shaper EI avec shaper_freq = 40 Hz. Pour l'input shaper 2HUMP_EI \u00e0 40 Hz, utilisez l'input shaper EI avec shaper_freq = 33 Hz. Imprimez le mod\u00e8le de test une fois de plus, en ex\u00e9cutant SET_INPUT_SHAPER SHAPER_TYPE=EI SHAPER_FREQ_X=... SHAPER_FREQ_Y=... TUNING_TOWER COMMAND=SET_VELOCITY_LIMIT PARAMETER=ACCEL START=1500 STEP_DELTA=500 STEP_HEIGHT=5 en fournissant le shaper_freq_x=... et shaper_freq_y=... comme d\u00e9termin\u00e9 pr\u00e9c\u00e9demment. Si l'input shaper EI montre de bons r\u00e9sultats comparables \u00e0 ceux de l'input shaper 2HUMP_EI, restez avec l'input shaper EI et la fr\u00e9quence d\u00e9termin\u00e9e pr\u00e9c\u00e9demment, sinon utilisez l'input shaper 2HUMP_EI avec la fr\u00e9quence correspondante. Ajoutez les r\u00e9sultats \u00e0 printer.cfg comme, par ex. [input_shaper] shaper_freq_x: 50 shaper_freq_y: 50 shaper_type: 2hump_ei Continuez le r\u00e9glage avec la section Choix de l'acc\u00e9l\u00e9ration maximale . D\u00e9pannage et FAQ \u00b6 Je n'arrive pas \u00e0 obtenir de mesures fiables des fr\u00e9quences de r\u00e9sonance \u00b6 En premier lieu, assurez-vous qu'il ne s'agit pas d'un autre probl\u00e8me avec l'imprimante plut\u00f4t que de la r\u00e9sonance. Si les mesures ne sont pas fiables parce que, par exemple, la distance entre les oscillations n'est pas stable, cela peut signifier que l'imprimante a plusieurs fr\u00e9quences de r\u00e9sonance sur le m\u00eame axe. On peut essayer de suivre le processus de r\u00e9glage d\u00e9crit dans la section Mesures non fiables des fr\u00e9quences de r\u00e9sonance et tirer encore quelque chose de la technique de l'input shaper. Une autre possibilit\u00e9 consiste \u00e0 installer un acc\u00e9l\u00e9rom\u00e8tre, \u00e0 mesurer les r\u00e9sonances avec celui-ci et \u00e0 r\u00e9gler automatiquement l'input shaper en utilisant les r\u00e9sultats de ces mesures. Apr\u00e8s avoir activ\u00e9 [input_shaper], j'obtiens des pi\u00e8ces imprim\u00e9es trop liss\u00e9es et les d\u00e9tails fins sont perdus \u00b6 V\u00e9rifiez les informations dans la section Choix de l'acc\u00e9l\u00e9ration maximale . Si la fr\u00e9quence de r\u00e9sonance est faible, il ne faut pas d\u00e9finir une valeur trop \u00e9lev\u00e9e pour max_accel ou augmenter les param\u00e8tres square_corner_velocity. Il peut \u00e9galement \u00eatre pr\u00e9f\u00e9rable de choisir un input shaper de type MZV ou m\u00eame ZV plut\u00f4t que EI (ou des shapers 2HUMP_EI et 3HUMP_EI). Apr\u00e8s avoir r\u00e9ussi \u00e0 imprimer pendant un certain temps sans r\u00e9sonance, elle semble revenir \u00b6 Il est possible qu'apr\u00e8s un certain temps, les fr\u00e9quences de r\u00e9sonance aient chang\u00e9. Par exemple. peut-\u00eatre que la tension des courroies a chang\u00e9 (les courroies sont devenues plus l\u00e2ches), etc. Il est bon de v\u00e9rifier et de mesurer \u00e0 nouveau les fr\u00e9quences de r\u00e9sonance comme d\u00e9crit dans la section Fr\u00e9quence de r\u00e9sonance et de mettre \u00e0 jour votre fichier de configuration si n\u00e9cessaire . La configuration \u00e0 double chariot est-elle prise en charge avec l'input shaper ? \u00b6 Il n'y a pas de support d\u00e9di\u00e9 pour les doubles chariots avec l'input shaper, mais cela ne signifie pas que cette configuration ne fonctionnera pas. Il faut ex\u00e9cuter le r\u00e9glage deux fois pour chacun des chariots et calculer les fr\u00e9quences de r\u00e9sonance des axes X et Y de chacun des chariots ind\u00e9pendamment. Ensuite, placez les valeurs du chariot 0 dans la section [input_shaper] et modifiez les valeurs \u00e0 la vol\u00e9e lors du changement de chariot, par ex. dans le cadre d'une macro\u202f: SET_DUAL_CARRIAGE CARRIAGE=1 SET_INPUT_SHAPER SHAPER_FREQ_X=... SHAPER_FREQ_Y=... Et pareil lors du retour au chariot 0. input_shaper affecte-t-il le temps d'impression ? \u00b6 Non, la fonctionnalit\u00e9 input_shaper n'a pratiquement aucun impact sur les temps d'impression. Cependant, la valeur de max_accel en a un (r\u00e9glage de ce param\u00e8tre d\u00e9crit dans cette section ). D\u00e9tails techniques \u00b6 Input shapers \u00b6 Les input shaper utilis\u00e9s dans Klipper sont plut\u00f4t standards, et on peut en trouver un aper\u00e7u plus d\u00e9taill\u00e9 dans les articles d\u00e9crivant les input shaper correspondants. Cette section contient un bref aper\u00e7u de certains aspects techniques des input shapers pris en charge. Le tableau ci-dessous montre certains param\u00e8tres (g\u00e9n\u00e9ralement approximatifs) pour chaque input shaper. Input shaper Dur\u00e9e de l'input shaper R\u00e9duction des vibrations 20x (5 % de tol\u00e9rance aux vibrations) R\u00e9duction des vibrations 10x (tol\u00e9rance aux vibrations de 10 %) ZV 0,5 / shaper_freq N/A \u00b1 5% shaper_freq MZV 0,75 / shaper_freq \u00b1 4% shaper_freq -10%...+15% shaper_freq ZVD 1 / shaper_freq \u00b1 15% shaper_freq \u00b1 22% shaper_freq EI 1 / shaper_freq \u00b1 20% shaper_freq \u00b1 25% shaper_freq 2HUMP_EI 1,5 / shaper_freq \u00b1 35% shaper_freq \u00b1 40 shaper_freq 3HUMP_EI 2 / shaper_freq -45...+50% shaper_freq -50%...+55% shaper_freq Remarque concernant l'att\u00e9nuation des vibrations : les valeurs du tableau ci-dessus sont approximatives. Si le taux d'amortissement de l'imprimante est connu pour chaque axe, l'input shaper peut \u00eatre configur\u00e9 plus pr\u00e9cis\u00e9ment ce qui r\u00e9duira alors les r\u00e9sonances dans une plage de fr\u00e9quences un peu plus large. Cependant, le taux d'amortissement est g\u00e9n\u00e9ralement inconnu et difficile \u00e0 estimer sans \u00e9quipement sp\u00e9cial. Klipper utilise donc la valeur 0,1 par d\u00e9faut, ce qui est une bonne valeur globale. Les gammes de fr\u00e9quences du tableau couvrent un certain nombre de diff\u00e9rents rapports d'amortissement possibles autour de cette valeur (environ de 0,05 \u00e0 0,2). Notez \u00e9galement que EI, 2HUMP_EI et 3HUMP_EI sont r\u00e9gl\u00e9s pour r\u00e9duire les vibrations \u00e0 5 %, les valeurs pour une tol\u00e9rance de vibration de 10 % sont fournies uniquement \u00e0 titre indicatif. Comment utiliser ce tableau : La dur\u00e9e de l'input shaper affecte le lissage des pi\u00e8ces - plus elle est grande, plus les pi\u00e8ces sont lisses. Cette d\u00e9pendance n'est pas lin\u00e9aire, mais peut donner une id\u00e9e des input shapers qui \"lissent\" le plus pour une m\u00eame fr\u00e9quence. L'ordre par lissage est le suivant : ZV < MZV < ZVD \u2248 EI < 2HUMP_EI < 3HUMP_EI. De plus, il est rarement pratique de r\u00e9gler shaper_freq = fr\u00e9quence de r\u00e9sonance des types 2HUMP_EI et 3HUMP_EI (utilis\u00e9s pour r\u00e9duire les vibrations sur plusieurs fr\u00e9quences). On peut estimer une gamme de fr\u00e9quences pour laquelle l'input shaper r\u00e9duit les vibrations. Par exemple, MZV avec shaper_freq = 35 Hz r\u00e9duit les vibrations \u00e0 5 % pour les fr\u00e9quences [33,6, 36,4] Hz. 3HUMP_EI avec shaper_freq = 50 Hz r\u00e9duit les vibrations \u00e0 5 % dans la plage [27,5 - 75] Hz. On peut utiliser ce tableau pour v\u00e9rifier quel input shaper choisir pour la r\u00e9duction des vibrations de plusieurs fr\u00e9quences. Par exemple, si on a des r\u00e9sonances \u00e0 35 Hz et 60 Hz sur le m\u00eame axe : a) EI doit avoir shaper_freq = 35 / (1 - 0.2) = 43.75 Hz, ce qui r\u00e9duirait les r\u00e9sonances jusqu'\u00e0 43.75 * (1 + 0,2) = 52,5 Hz, donc ce n'est pas suffisant ; b) Le 2HUMP_EI doit avoir shaper_freq = 35 / (1 - 0,35) = 53,85 Hz ce qui r\u00e9duira les vibrations jusqu'\u00e0 53,85 * (1 + 0,35) = 72,7 Hz - c'est donc une configuration acceptable. Essayez toujours d'utiliser le plus haut shaper_freq possible pour un input shaper donn\u00e9 (peut-\u00eatre avec une certaine marge de s\u00e9curit\u00e9, donc dans cet exemple shaper_freq \u2248 50-52 Hz fonctionnerait mieux), et essayez d'utiliser un input shaper avec une dur\u00e9e aussi petite que possible. Si l'on a besoin de r\u00e9duire les vibrations de plusieurs fr\u00e9quences tr\u00e8s diff\u00e9rentes (par exemple, 30 Hz et 100 Hz), le tableau ci-dessus ne fournit pas suffisamment d'informations. Dans ce cas, on peut avoir plus de chance avec le script scripts/graph_shaper.py , qui est plus flexible.","title":"Compensation de r\u00e9sonance"},{"location":"Resonance_Compensation.html#compensation-de-resonance","text":"Klipper prend en charge la mise en forme de l'entr\u00e9e, une technique utilis\u00e9e pour r\u00e9duire l'effet de r\u00e9sonance (\u00e9galement connu sous le nom d'\u00e9cho, d'image fant\u00f4me ou d'ondulation) dans les impressions. La r\u00e9sonance est un d\u00e9faut d'impression de surface lorsque des \u00e9l\u00e9ments tels que des bords se r\u00e9p\u00e8tent sur une surface imprim\u00e9e sous forme d'un \"\u00e9cho\" subtil : | | | La r\u00e9sonance est caus\u00e9e par des vibrations m\u00e9caniques dans l'imprimante dues \u00e0 des changements rapides de direction durant une impression. Notez que la r\u00e9sonance a g\u00e9n\u00e9ralement des origines m\u00e9caniques : cadre de l'imprimante insuffisamment rigide, courroies non tendues ou trop \u00e9lastiques, probl\u00e8mes d'alignement des pi\u00e8ces m\u00e9caniques, masse mobile importante, etc. Ces probl\u00e8mes doivent \u00eatre v\u00e9rifi\u00e9s et corrig\u00e9s en premier lieu, si possible. La mise en forme de l'entr\u00e9e est une technique de contr\u00f4le en boucle ouverte qui cr\u00e9e un signal de commande annulant ses propres vibrations. La mise en forme de l'entr\u00e9e n\u00e9cessite quelques r\u00e9glages et mesures avant de pouvoir \u00eatre activ\u00e9e. Outre la r\u00e9sonance, la mise en forme de l'entr\u00e9e r\u00e9duit g\u00e9n\u00e9ralement les vibrations et les secousses de l'imprimante en g\u00e9n\u00e9ral, et peut \u00e9galement am\u00e9liorer la fiabilit\u00e9 du mode stealthChop des pilotes Trinamic.","title":"Compensation de r\u00e9sonance"},{"location":"Resonance_Compensation.html#reglages","text":"Le r\u00e9glage de base n\u00e9cessite de mesurer les fr\u00e9quences de r\u00e9sonance de l'imprimante en imprimant un mod\u00e8le de test. Tranchez le mod\u00e8le de test de r\u00e9sonance, qui se trouve dans docs/prints/ringing_tower.stl , dans le trancheur : La hauteur de couche sugg\u00e9r\u00e9e est de 0,2 ou 0,25 mm. Les couches de remplissage et de finition peuvent \u00eatre r\u00e9gl\u00e9es sur 0. Utilisez 1-2 p\u00e9rim\u00e8tres, ou mieux encore le mode vase avec 1-2 mm de base. Utilisez une vitesse suffisamment \u00e9lev\u00e9e, environ 80-100 mm/s, pour les p\u00e9rim\u00e8tres externes . Veillez \u00e0 ce que le temps de pause minimum soit au maximum de 3 secondes. Assurez-vous que le \"contr\u00f4le d'acc\u00e9l\u00e9ration\" est d\u00e9sactiv\u00e9 dans le trancheur. Ne tournez pas le mod\u00e8le. Le mod\u00e8le comporte des marques X et Y \u00e0 l'arri\u00e8re du mod\u00e8le. Notez l'emplacement inhabituel des marques par rapport aux axes de l'imprimante - il ne s'agit pas d'une erreur. Les marques peuvent \u00eatre utilis\u00e9es plus tard dans le processus de r\u00e9glage comme r\u00e9f\u00e9rence, car elles indiquent \u00e0 quel axe correspondent les mesures.","title":"R\u00e9glages"},{"location":"Resonance_Compensation.html#frequence-de-resonance","text":"Tout d'abord, mesurez la fr\u00e9quence de r\u00e9sonance . Si le param\u00e8tre square_corner_velocity a \u00e9t\u00e9 modifi\u00e9, remettez-le \u00e0 5.0. Il n'est pas conseill\u00e9 de l'augmenter lors de l'utilisation de l'input shaper car cela peut provoquer plus de lissage dans les pi\u00e8ces - il est pr\u00e9f\u00e9rable d'utiliser une valeur d'acc\u00e9l\u00e9ration plus \u00e9lev\u00e9e \u00e0 la place. Augmentez max_accel_to_decel en lan\u00e7ant la commande suivante : SET_VELOCITY_LIMIT ACCEL_TO_DECEL=7000 D\u00e9sactivez l'avance de pression : SET_PRESSURE_ADVANCE ADVANCE=0 Si vous avez d\u00e9j\u00e0 ajout\u00e9 la section [input_shaper] au printer.cfg, ex\u00e9cutez la commande SET_INPUT_SHAPER SHAPER_FREQ_X=0 SHAPER_FREQ_Y=0 . Si vous obtenez l'erreur \"Unknown command\", vous pouvez l'ignorer \u00e0 ce stade et continuer les mesures. Ex\u00e9cutez la commande : TUNING_TOWER COMMAND=SET_VELOCITY_LIMIT PARAMETER=ACCEL START=1500 STEP_DELTA=500 STEP_HEIGHT=5 Dans la pratique, nous essayons de rendre la r\u00e9sonance plus prononc\u00e9e en d\u00e9finissant diff\u00e9rentes valeurs \u00e9lev\u00e9es pour l'acc\u00e9l\u00e9ration. Cette commande augmentera l'acc\u00e9l\u00e9ration tous les 5 mm \u00e0 partir de 1500 mm/sec\u00b2 : 1500 mm/sec\u00b2, 2000 mm/sec\u00b2, 2500 mm/sec\u00b2 et ainsi de suite jusqu'\u00e0 7000 mm/sec\u00b2 pour la derni\u00e8re bande. Imprimez le mod\u00e8le de test tranch\u00e9 avec les param\u00e8tres sugg\u00e9r\u00e9s. Vous pouvez arr\u00eater l'impression plus t\u00f4t si la r\u00e9sonance est clairement visible et si vous constatez que l'acc\u00e9l\u00e9ration devient trop forte pour votre imprimante (par exemple, l'imprimante tremble trop ou commence \u00e0 sauter des pas). Utilisez les marques X et Y \u00e0 l'arri\u00e8re du mod\u00e8le comme r\u00e9f\u00e9rence. Les mesures du c\u00f4t\u00e9 avec la marque X doivent \u00eatre utilis\u00e9es pour la configuration de l'axe X, et la marque Y - pour la configuration de l'axe Y. Mesurez la distance D (en mm) entre plusieurs oscillations sur la pi\u00e8ce avec la marque X, pr\u00e8s des encoches, en sautant de pr\u00e9f\u00e9rence la ou les deux premi\u00e8res oscillations. Pour mesurer plus facilement la distance entre les oscillations, marquez d'abord les oscillations, puis mesurez la distance entre les marques avec une r\u00e8gle ou un pied \u00e0 coulisse :| | | Comptez le nombre d'oscillations N correspondant \u00e0 la distance mesur\u00e9e D . Si vous ne savez pas comment compter les oscillations, reportez-vous \u00e0 l'image ci-dessus, qui montre N = 6 oscillations. Calculer la fr\u00e9quence de r\u00e9sonance de l'axe X comme V \u00b7 N / D (Hz), o\u00f9 V est la vitesse des p\u00e9rim\u00e8tres ext\u00e9rieurs (mm/s). Pour l'exemple ci-dessus, nous avons marqu\u00e9 6 oscillations, et le test a \u00e9t\u00e9 imprim\u00e9 \u00e0 une vitesse de 100 mm/s, donc la fr\u00e9quence est 100 * 6 / 12,14 \u2248 49,4 Hz. Faites (8) - (10) pour la marque Y \u00e9galement. Notez que la r\u00e9sonanc sur l'impression de test devrait correspondre au mod\u00e8le des encoches courbes, comme dans l'image ci-dessus. Si ce n'est pas le cas, alors ce d\u00e9faut n'est pas vraiment une r\u00e9sonance et a probablement une origine diff\u00e9rente - soit m\u00e9canique, soit un probl\u00e8me d'extrudeuse. Ce probl\u00e8me doit \u00eatre r\u00e9solu avant d'activer et de r\u00e9gler les fa\u00e7onneurs d'entr\u00e9e. Si les mesures ne sont pas fiables parce que, par exemple, la distance entre les oscillations n'est pas stable, cela peut signifier que l'imprimante a plusieurs fr\u00e9quences de r\u00e9sonance sur le m\u00eame axe. On peut essayer de suivre le processus de r\u00e9glage d\u00e9crit dans la section Mesures peu fiables des fr\u00e9quences de r\u00e9sonance \u00e0 la place et obtenir quand m\u00eame quelque chose de la technique de mise en forme de l'entr\u00e9e. La fr\u00e9quence de r\u00e9sonance peut d\u00e9pendre de la position du mod\u00e8le sur la plaque de construction et de la hauteur Z, surtout sur les imprimantes delta ; vous pouvez v\u00e9rifier si vous observez des diff\u00e9rences de fr\u00e9quences \u00e0 diff\u00e9rentes positions le long des c\u00f4t\u00e9s du mod\u00e8le de test et \u00e0 diff\u00e9rentes hauteurs. Vous pouvez calculer les fr\u00e9quences de r\u00e9sonance moyennes sur les axes X et Y si c'est le cas. Si la fr\u00e9quence de r\u00e9sonance mesur\u00e9e est tr\u00e8s basse (inf\u00e9rieure \u00e0 20-25 Hz environ), il peut \u00eatre judicieux d'investir dans le raidissement de l'imprimante ou la r\u00e9duction de la masse mobile - selon ce qui est applicable dans votre cas - avant de poursuivre le r\u00e9glage de la mise en forme de l'entr\u00e9e et de mesurer \u00e0 nouveau les fr\u00e9quences par la suite. Pour de nombreux mod\u00e8les d'imprimantes populaires, il existe souvent des solutions d\u00e9j\u00e0 disponibles. Les fr\u00e9quences de r\u00e9sonance peuvent changer si des modifications sont apport\u00e9es \u00e0 l'imprimante qui affectent la masse en mouvement ou modifient la rigidit\u00e9 du syst\u00e8me, par exemple : Si la t\u00eate d'impression est modifi\u00e9e, par ex. changement de moteur pas \u00e0 pas (plus lourd ou plus l\u00e9ger) pour une extrusion directe, remplacement de la t\u00eate de l'outil (plus ou moins lourde), ajout d'un ventilateur plus lourd, etc. La tension des courroies a \u00e9t\u00e9 modifi\u00e9e. Des pi\u00e8ces con\u00e7ues pour augmenter la rigidit\u00e9 du cadre sont install\u00e9es. Un plateau diff\u00e9rent est install\u00e9 sur une imprimante \u00e0 lit mobile, ou une plaque de verre est ajout\u00e9e, etc. Si de tels changements sont apport\u00e9s, Il est conseill\u00e9 de mesurer au moins les fr\u00e9quences de r\u00e9sonance pour v\u00e9rifier s'il y a eu un changement ou pas.","title":"Fr\u00e9quence de r\u00e9sonance"},{"location":"Resonance_Compensation.html#configuration-de-linput-shaper","text":"Une fois les fr\u00e9quences de r\u00e9sonance des axes X et Y mesur\u00e9es, vous pouvez ajouter la section suivante \u00e0 votre printer.cfg : [input_shaper] shaper_freq_x: ... # frequence pour la marque X sur le mod\u00e8le de test shaper_freq_y: ... # frequence pour la marque Y sur le mod\u00e8le de test Pour l'exemple ci-dessus, nous obtenons shaper_freq_x/y = 49,4.","title":"Configuration de l'\"input shaper\""},{"location":"Resonance_Compensation.html#choix-de-linput-shaper","text":"Klipper prend en charge plusieurs type d'\"input shaper\". Ils diff\u00e8rent par leur sensibilit\u00e9 aux erreurs d\u00e9terminant la fr\u00e9quence de r\u00e9sonance et le degr\u00e9 de lissage qu'ils provoquent dans les pi\u00e8ces imprim\u00e9es. De plus, certains de ces \"input shaper\" comme 2HUMP_EI et 3HUMP_EI ne doivent g\u00e9n\u00e9ralement pas \u00eatre utilis\u00e9s avec shaper_freq = fr\u00e9quence de r\u00e9sonance - ils sont configur\u00e9s \u00e0 partir de diff\u00e9rentes consid\u00e9rations pour r\u00e9duire plusieurs r\u00e9sonances \u00e0 la fois (ndt\u202f: le 2HUMP_EI est \u00e0 utiliser lorsque deux pics de r\u00e9sonance sont d\u00e9tect\u00e9s, le 3HUMP_EI est \u00e0 utiliser lorsque trois pics de r\u00e9sonance sont d\u00e9tect\u00e9s). Pour la plupart des imprimantes, les shapers MZV ou EI peuvent \u00eatre recommand\u00e9s. Cette section d\u00e9crit un processus de test pour choisir entre eux et d\u00e9terminer quelques autres param\u00e8tres connexes. Imprimez le mod\u00e8le de test de r\u00e9sonance comme suit : Red\u00e9marrez le micrologiciel : RESTART Pr\u00e9parez-vous pour le test : SET_VELOCITY_LIMIT ACCEL_TO_DECEL=7000 D\u00e9sactivez l'avance de pression : SET_PRESSURE_ADVANCE ADVANCE=0 Ex\u00e9cutez : SET_INPUT_SHAPER SHAPER_TYPE=MZV Ex\u00e9cutez la commande : TUNING_TOWER COMMAND=SET_VELOCITY_LIMIT PARAMETER=ACCEL START=1500 STEP_DELTA=500 STEP_HEIGHT=5 Imprimez le mod\u00e8le de test tranch\u00e9 avec les param\u00e8tres sugg\u00e9r\u00e9s. Si vous ne voyez pas de r\u00e9sonance \u00e0 ce stade, l'utilisation de l'\"input shaper\" MZV peut \u00eatre recommand\u00e9e. Si vous voyez une r\u00e9sonance, mesurez \u00e0 nouveau les fr\u00e9quences en suivant les \u00e9tapes (8) \u00e0 (10) d\u00e9crites dans la section Fr\u00e9quence de r\u00e9sonance . Si les fr\u00e9quences diff\u00e8rent consid\u00e9rablement des valeurs obtenues pr\u00e9c\u00e9demment, une configuration d'input shaper plus complexe est n\u00e9cessaire. Vous pouvez vous r\u00e9f\u00e9rer aux d\u00e9tails techniques de la section Input shapers . Sinon, passez \u00e0 l'\u00e9tape suivante. Essayez l'input shaper EI. Pour l'essayer, r\u00e9p\u00e9tez les \u00e9tapes (1) \u00e0 (6) ci-dessus, mais en ex\u00e9cutant \u00e0 l'\u00e9tape 4 la commande suivante \u00e0 la place : SET_INPUT_SHAPER SHAPER_TYPE=EI . Comparez deux impressions avec les input shaper MZV et EI. Si EI montre des r\u00e9sultats sensiblement meilleurs que MZV, utilisez EI, sinon pr\u00e9f\u00e9rez MZV. Notez que le input shaper EI provoquera plus de lissage dans les pi\u00e8ces imprim\u00e9es (voir la section suivante pour plus de d\u00e9tails). Ajoutez le param\u00e8tre shaper_type: mzv (ou ei) \u00e0 la section [input_shaper], par exemple : [input_shaper] shaper_freq_x: ... shaper_freq_y: ... shaper_type: mzv Quelques notes sur le choix de l'input shaper : L' input shaper EI peut \u00eatre plus adapt\u00e9 aux imprimantes \u00e0 lit mobile (si la fr\u00e9quence de r\u00e9sonance et le lissage r\u00e9sultant le permettent) : plus le filament est d\u00e9pos\u00e9 sur le lit en mouvement, plus la masse du lit augmente et la fr\u00e9quence de r\u00e9sonance diminue. \u00c9tant donn\u00e9 que le input shaper EI est plus robuste aux changements de fr\u00e9quence de r\u00e9sonance, il peut mieux fonctionner lors de l'impression de grandes pi\u00e8ces. En raison de la nature de la cin\u00e9matique delta, les fr\u00e9quences de r\u00e9sonance peuvent diff\u00e9rer consid\u00e9rablement dans diff\u00e9rentes parties du volume de construction. Par cons\u00e9quent, l'input shaper EI peut \u00eatre mieux adapt\u00e9 aux imprimantes delta plut\u00f4t que MZV ou ZV. Si la fr\u00e9quence de r\u00e9sonance est suffisamment grande (plus de 50-60 Hz), alors on peut m\u00eame essayer de tester 2HUMP_EI (en ex\u00e9cutant le test sugg\u00e9r\u00e9 ci-dessus avec SET_INPUT_SHAPER SHAPER_TYPE=2HUMP_EI ), mais v\u00e9rifiez les consid\u00e9rations dans la section ci-dessous avant de l'activer.","title":"Choix de l'\"input shaper\""},{"location":"Resonance_Compensation.html#selection-de-max_accel","text":"Vous devriez obtenir le test imprim\u00e9 avec l'input shaper choisi \u00e0 l'\u00e9tape pr\u00e9c\u00e9dente (si vous ne le faites pas, imprimez le mod\u00e8le de test d\u00e9coup\u00e9 avec les param\u00e8tres sugg\u00e9r\u00e9s avec l'avance de pression d\u00e9sactiv\u00e9e SET_PRESSURE_ADVANCE ADVANCE=0 et avec la tour de r\u00e9glage activ\u00e9e comme TUNING_TOWER COMMAND=SET_VELOCITY_LIMIT PARAMETER=ACCEL START=1500 STEP_DELTA=500 STEP_HEIGHT=5 ). Notez qu'\u00e0 des acc\u00e9l\u00e9rations tr\u00e8s \u00e9lev\u00e9es, selon la fr\u00e9quence de r\u00e9sonance et l'input shaper choisi (par exemple, le shaper EI cr\u00e9e plus de lissage que MZV), cela peut provoquer trop de lissage et d'arrondi des pi\u00e8ces. Ainsi, max_accel doit \u00eatre choisi de mani\u00e8re \u00e0 l'\u00e9viter. Un autre param\u00e8tre ayant un impact sur le lissage est square_corner_velocity , il n'est donc pas conseill\u00e9 de l'augmenter au-dessus de la valeur par d\u00e9faut de 5 mm/s pour \u00e9viter un lissage accru. Afin de s\u00e9lectionner une valeur max_accel appropri\u00e9e, inspectez le mod\u00e8le pour l'input shaper choisi. Tout d'abord, notez \u00e0 quelle acc\u00e9l\u00e9ration la r\u00e9sonance est encore faible - convenant \u00e9galement \u00e0 l'imprimante. Ensuite, v\u00e9rifiez le lissage. Pour vous aider, le mod\u00e8le de test a un petit espace dans la paroi (0,15 mm) : \u00c0 mesure que l'acc\u00e9l\u00e9ration augmente, le lissage augmente \u00e9galement et l'espacement r\u00e9el dans l'impression s'\u00e9largit : Sur cette image, l'acc\u00e9l\u00e9ration augmente de gauche \u00e0 droite, et l'\u00e9cart commence \u00e0 cro\u00eetre \u00e0 partir de 3500 mm/s\u00b2 (5\u00e8me bande \u00e0 partir de la gauche). Dans ce cas, la valeur pour max_accel = 3000 (mm/s\u00b2) permet d'\u00e9viter un lissage excessif. Notez l'acc\u00e9l\u00e9ration lorsque l'\u00e9cart est encore tr\u00e8s faible dans votre test d'impression. Si vous voyez des renflements, mais aucun espace dans le mur, m\u00eame \u00e0 des acc\u00e9l\u00e9rations \u00e9lev\u00e9es, cela peut \u00eatre d\u00fb \u00e0 une avance de pression (PA) d\u00e9sactiv\u00e9e, en particulier sur les extrudeurs de type Bowden. Si tel est le cas, vous devrez peut-\u00eatre r\u00e9p\u00e9ter l'impression avec le PA activ\u00e9. Cela peut \u00e9galement \u00eatre le r\u00e9sultat d'un flux de filament mal calibr\u00e9 (trop \u00e9lev\u00e9), il faut donc v\u00e9rifier cela aussi. Choisissez la valeur minimale des deux valeurs d'acc\u00e9l\u00e9ration (de la r\u00e9sonance et du lissage) et affectez-l\u00e0 \u00e0 max_accel dans printer.cfg. Notez qu'il peut arriver - en particulier \u00e0 des fr\u00e9quences de r\u00e9sonance basses - que l'input shaper EI provoque trop de lissage, m\u00eame \u00e0 des acc\u00e9l\u00e9rations faibles. Dans ce cas, MZV peut \u00eatre un meilleur choix, car il peut permettre des valeurs d'acc\u00e9l\u00e9ration plus \u00e9lev\u00e9es. \u00c0 des fr\u00e9quences de r\u00e9sonance tr\u00e8s basses (~ 25 Hz et moins), m\u00eame l'input shaper MZV peut cr\u00e9er trop de lissage. Si tel est le cas, vous pouvez \u00e9galement essayer de r\u00e9p\u00e9ter les \u00e9tapes de la section Choix de l'input shaper avec l'input shaper ZV, en utilisant la commande SET_INPUT_SHAPER SHAPER_TYPE=ZV \u00e0 la place. L'input shaper ZV devrait montrer encore moins de lissage que MZV, mais il est plus sensible aux erreurs de mesure des fr\u00e9quences de r\u00e9sonance. Si une fr\u00e9quence de r\u00e9sonance est trop faible (inf\u00e9rieure \u00e0 20-25 Hz), il peut \u00eatre judicieux d'augmenter la rigidit\u00e9 de l'imprimante ou de r\u00e9duire la masse en mouvement. Sinon, l'acc\u00e9l\u00e9ration et la vitesse d'impression peuvent \u00eatre limit\u00e9es en raison d'un lissage trop important qui remplacera la r\u00e9sonance.","title":"S\u00e9lection de max_accel"},{"location":"Resonance_Compensation.html#reglage-fin-des-frequences-de-resonance","text":"Notez que la pr\u00e9cision des mesures des fr\u00e9quences de r\u00e9sonance \u00e0 l'aide du mod\u00e8le de test de r\u00e9sonance est suffisante dans la plupart des cas, donc un r\u00e9glage suppl\u00e9mentaire n'est pas utile. Si vous voulez toujours essayer de rev\u00e9rifier vos r\u00e9sultats (par exemple, si vous voyez toujours une r\u00e9sonance apr\u00e8s avoir imprim\u00e9 un mod\u00e8le de test avec un input shaper de votre choix avec les fr\u00e9quences mesur\u00e9es pr\u00e9c\u00e9demment), vous pouvez suivre les \u00e9tapes de cette section. Notez que si vous voyez une r\u00e9sonance \u00e0 diff\u00e9rentes fr\u00e9quences apr\u00e8s avoir activ\u00e9 [input_shaper], cette section ne vous aidera pas. En consid\u00e9rant que vous avez tranch\u00e9 le mod\u00e8le de r\u00e9sonance avec les param\u00e8tres sugg\u00e9r\u00e9s, effectuez les \u00e9tapes suivantes pour chacun des axes X et Y : Pr\u00e9parez-vous pour le test : SET_VELOCITY_LIMIT ACCEL_TO_DECEL=7000 Assurez-vous que l'avance de pression est d\u00e9sactiv\u00e9e : SET_PRESSURE_ADVANCE ADVANCE=0 Ex\u00e9cutez : SET_INPUT_SHAPER SHAPER_TYPE=ZV \u00c0 partir du mod\u00e8le de test de r\u00e9sonance imprim\u00e9 avec l'input shaper choisi, s\u00e9lectionnez l'acc\u00e9l\u00e9ration montrant suffisamment bien la r\u00e9sonance et d\u00e9finissez-la avec : SET_VELOCITY_LIMIT ACCEL=... Calculez les param\u00e8tres n\u00e9cessaires pour que la commande TUNING_TOWER r\u00e8gle le param\u00e8tre shaper_freq_x comme suit : start = shaper_freq_x * 83 / 132 et factor = shaper_freq_x / 66, o\u00f9 shaper_freq_x est la valeur indiqu\u00e9e dans printer.cfg . Ex\u00e9cutez la commande : TUNING_TOWER COMMAND=SET_INPUT_SHAPER PARAMETER=SHAPER_FREQ_X START=start FACTOR=factor BAND=5 en utilisant les valeurs start et factor calcul\u00e9es \u00e0 l'\u00e9tape (5). Imprimez le mod\u00e8le de test. Remettez la valeur de fr\u00e9quence d'origine : SET_INPUT_SHAPER SHAPER_FREQ_X=... . Trouvez la bande r\u00e9sonnant le moins et comptez son num\u00e9ro \u00e0 partir du bas en commen\u00e7ant \u00e0 1. Calculez la nouvelle valeur shaper_freq_x selon la formule : ancien shaper_freq_x * (39 + 5 * #band-number) / 66. R\u00e9p\u00e9tez ces \u00e9tapes pour l'axe Y de la m\u00eame mani\u00e8re, en rempla\u00e7ant les r\u00e9f\u00e9rences \u00e0 l'axe X par l'axe Y (par exemple, remplacez shaper_freq_x par shaper_freq_y dans les formules et dans la commande TUNING_TOWER ). A titre d'exemple, supposons que vous ayez mesur\u00e9 la fr\u00e9quence de r\u00e9sonance pour l'un des axes \u00e0 45 Hz. Cela donne les valeurs start = 45 * 83 / 132 = 28,30 et factor = 45 / 66 = 0,6818 pour la commande TUNING_TOWER . Supposons maintenant qu'apr\u00e8s l'impression du mod\u00e8le de test, la quatri\u00e8me bande \u00e0 partir du bas donne le moins de r\u00e9sonance. Cela donne le shaper_freq_ mis \u00e0 jour \u00e9gal \u00e0 45 * (39 + 5 * 4) / 66 \u2248 40,23. Une fois les deux nouveaux param\u00e8tres shaper_freq_x et shaper_freq_y calcul\u00e9s, vous pouvez mettre \u00e0 jour la section [input_shaper] dans printer.cfg avec le nouveau shaper_freq_x et shaper_freq_y .","title":"R\u00e9glage fin des fr\u00e9quences de r\u00e9sonance"},{"location":"Resonance_Compensation.html#avance-de-pression-pa","text":"Si vous utilisiez l'avance de pression, il pourra \u00eatre n\u00e9cessaire de la r\u00e9ajuster. Suivez les instructions pour trouver la nouvelle valeur, si elle diff\u00e8re de la pr\u00e9c\u00e9dente. Assurez-vous de red\u00e9marrer Klipper avant de r\u00e9gler l'avance de pression.","title":"Avance de pression (PA)"},{"location":"Resonance_Compensation.html#mesures-peu-fiables-des-frequences-de-resonance","text":"Si vous ne parvenez pas \u00e0 mesurer les fr\u00e9quences de r\u00e9sonance, par ex. si la distance entre les oscillations n'est pas stable, vous pouvez toujours profiter des techniques de l'input shaper, mais les r\u00e9sultats peuvent ne pas \u00eatre aussi bons qu'avec des mesures appropri\u00e9es des fr\u00e9quences, et n\u00e9cessiteront un peu plus de r\u00e9glages et d'impressions du mod\u00e8le de test. Notez qu'une autre possibilit\u00e9 est d'acheter et d'installer un acc\u00e9l\u00e9rom\u00e8tre et de mesurer les r\u00e9sonances avec (reportez-vous \u00e0 la documentation d\u00e9crivant le mat\u00e9riel requis et le processus de configuration) - mais cette option n\u00e9cessite quelques soudures et un peu de sertissage. Pour le r\u00e9glage, ajoutez une section [input_shaper] vide \u00e0 votre printer.cfg . Ensuite, en supposant que vous avez tranch\u00e9 le mod\u00e8le de r\u00e9sonance avec les param\u00e8tres sugg\u00e9r\u00e9s, imprimez le mod\u00e8le de test 3 fois comme suit. Premi\u00e8re fois, avant l'impression, ex\u00e9cutez RESTART SET_VELOCITY_LIMIT ACCEL_TO_DECEL=7000 SET_PRESSURE_ADVANCE ADVANCE=0 SET_INPUT_SHAPER SHAPER_TYPE=2HUMP_EI SHAPER_FREQ_X=60 SHAPER_FREQ_Y=60 TUNING_TOWER COMMAND=SET_VELOCITY_LIMIT PARAMETER=ACCEL START=1500 STEP_DELTA=500 STEP_HEIGHT=5 et imprimez le mod\u00e8le. Ensuite, imprimez \u00e0 nouveau le mod\u00e8le, mais avant d'imprimer, ex\u00e9cutez \u00e0 la place SET_INPUT_SHAPER SHAPER_TYPE=2HUMP_EI SHAPER_FREQ_X=50 SHAPER_FREQ_Y=50 TUNING_TOWER COMMAND=SET_VELOCITY_LIMIT PARAMETER=ACCEL START=1500 STEP_DELTA=500 STEP_HEIGHT=5 Imprimez ensuite le mod\u00e8le pour la 3\u00e8me fois, mais ex\u00e9cutez maintenant SET_INPUT_SHAPER SHAPER_TYPE=2HUMP_EI SHAPER_FREQ_X=40 SHAPER_FREQ_Y=40 TUNING_TOWER COMMAND=SET_VELOCITY_LIMIT PARAMETER=ACCEL START=1500 STEP_DELTA=500 STEP_HEIGHT=5 Dans la pratique nous imprimons le mod\u00e8le de test de r\u00e9sonance avec TUNING_TOWER en utilisant l'input shaper 2HUMP_EI avec shaper_freq = 60 Hz, 50 Hz et 40 Hz. Si aucun des mod\u00e8les ne d\u00e9montre d'am\u00e9lioration de la r\u00e9sonance, aucune des techniques d'input shaper ne pourra vous aider. Sinon, il se peut que tous les mod\u00e8les n'affichent aucune r\u00e9sonance, ou que certains affichent la r\u00e9sonance et d'autres pas trop. Choisissez le mod\u00e8le de test avec la fr\u00e9quence la plus \u00e9lev\u00e9e qui montre encore de bonnes am\u00e9liorations dans la r\u00e9sonance. Par exemple, si les mod\u00e8les 40 Hz et 50 Hz n'affichent presque aucune r\u00e9sonance et que le mod\u00e8le 60 Hz affiche d\u00e9j\u00e0 un peu plus de r\u00e9sonance, restez \u00e0 50 Hz. V\u00e9rifiez maintenant si l'input shaper EI peut fonctionner dans votre cas. Choisissez la fr\u00e9quence de l'input shaper EI en fonction de la fr\u00e9quence de l'input shaper 2HUMP_EI que vous avez choisie : Pour l'input shaper 2HUMP_EI 60 Hz, utilisez l'input shaper EI avec shaper_freq = 50 Hz. Pour l'input shaper 2HUMP_EI 50 Hz, utilisez l'input shaper EI avec shaper_freq = 40 Hz. Pour l'input shaper 2HUMP_EI \u00e0 40 Hz, utilisez l'input shaper EI avec shaper_freq = 33 Hz. Imprimez le mod\u00e8le de test une fois de plus, en ex\u00e9cutant SET_INPUT_SHAPER SHAPER_TYPE=EI SHAPER_FREQ_X=... SHAPER_FREQ_Y=... TUNING_TOWER COMMAND=SET_VELOCITY_LIMIT PARAMETER=ACCEL START=1500 STEP_DELTA=500 STEP_HEIGHT=5 en fournissant le shaper_freq_x=... et shaper_freq_y=... comme d\u00e9termin\u00e9 pr\u00e9c\u00e9demment. Si l'input shaper EI montre de bons r\u00e9sultats comparables \u00e0 ceux de l'input shaper 2HUMP_EI, restez avec l'input shaper EI et la fr\u00e9quence d\u00e9termin\u00e9e pr\u00e9c\u00e9demment, sinon utilisez l'input shaper 2HUMP_EI avec la fr\u00e9quence correspondante. Ajoutez les r\u00e9sultats \u00e0 printer.cfg comme, par ex. [input_shaper] shaper_freq_x: 50 shaper_freq_y: 50 shaper_type: 2hump_ei Continuez le r\u00e9glage avec la section Choix de l'acc\u00e9l\u00e9ration maximale .","title":"Mesures peu fiables des fr\u00e9quences de r\u00e9sonance"},{"location":"Resonance_Compensation.html#depannage-et-faq","text":"","title":"D\u00e9pannage et FAQ"},{"location":"Resonance_Compensation.html#je-narrive-pas-a-obtenir-de-mesures-fiables-des-frequences-de-resonance","text":"En premier lieu, assurez-vous qu'il ne s'agit pas d'un autre probl\u00e8me avec l'imprimante plut\u00f4t que de la r\u00e9sonance. Si les mesures ne sont pas fiables parce que, par exemple, la distance entre les oscillations n'est pas stable, cela peut signifier que l'imprimante a plusieurs fr\u00e9quences de r\u00e9sonance sur le m\u00eame axe. On peut essayer de suivre le processus de r\u00e9glage d\u00e9crit dans la section Mesures non fiables des fr\u00e9quences de r\u00e9sonance et tirer encore quelque chose de la technique de l'input shaper. Une autre possibilit\u00e9 consiste \u00e0 installer un acc\u00e9l\u00e9rom\u00e8tre, \u00e0 mesurer les r\u00e9sonances avec celui-ci et \u00e0 r\u00e9gler automatiquement l'input shaper en utilisant les r\u00e9sultats de ces mesures.","title":"Je n'arrive pas \u00e0 obtenir de mesures fiables des fr\u00e9quences de r\u00e9sonance"},{"location":"Resonance_Compensation.html#apres-avoir-active-input_shaper-jobtiens-des-pieces-imprimees-trop-lissees-et-les-details-fins-sont-perdus","text":"V\u00e9rifiez les informations dans la section Choix de l'acc\u00e9l\u00e9ration maximale . Si la fr\u00e9quence de r\u00e9sonance est faible, il ne faut pas d\u00e9finir une valeur trop \u00e9lev\u00e9e pour max_accel ou augmenter les param\u00e8tres square_corner_velocity. Il peut \u00e9galement \u00eatre pr\u00e9f\u00e9rable de choisir un input shaper de type MZV ou m\u00eame ZV plut\u00f4t que EI (ou des shapers 2HUMP_EI et 3HUMP_EI).","title":"Apr\u00e8s avoir activ\u00e9 [input_shaper], j'obtiens des pi\u00e8ces imprim\u00e9es trop liss\u00e9es et les d\u00e9tails fins sont perdus"},{"location":"Resonance_Compensation.html#apres-avoir-reussi-a-imprimer-pendant-un-certain-temps-sans-resonance-elle-semble-revenir","text":"Il est possible qu'apr\u00e8s un certain temps, les fr\u00e9quences de r\u00e9sonance aient chang\u00e9. Par exemple. peut-\u00eatre que la tension des courroies a chang\u00e9 (les courroies sont devenues plus l\u00e2ches), etc. Il est bon de v\u00e9rifier et de mesurer \u00e0 nouveau les fr\u00e9quences de r\u00e9sonance comme d\u00e9crit dans la section Fr\u00e9quence de r\u00e9sonance et de mettre \u00e0 jour votre fichier de configuration si n\u00e9cessaire .","title":"Apr\u00e8s avoir r\u00e9ussi \u00e0 imprimer pendant un certain temps sans r\u00e9sonance, elle semble revenir"},{"location":"Resonance_Compensation.html#la-configuration-a-double-chariot-est-elle-prise-en-charge-avec-linput-shaper","text":"Il n'y a pas de support d\u00e9di\u00e9 pour les doubles chariots avec l'input shaper, mais cela ne signifie pas que cette configuration ne fonctionnera pas. Il faut ex\u00e9cuter le r\u00e9glage deux fois pour chacun des chariots et calculer les fr\u00e9quences de r\u00e9sonance des axes X et Y de chacun des chariots ind\u00e9pendamment. Ensuite, placez les valeurs du chariot 0 dans la section [input_shaper] et modifiez les valeurs \u00e0 la vol\u00e9e lors du changement de chariot, par ex. dans le cadre d'une macro\u202f: SET_DUAL_CARRIAGE CARRIAGE=1 SET_INPUT_SHAPER SHAPER_FREQ_X=... SHAPER_FREQ_Y=... Et pareil lors du retour au chariot 0.","title":"La configuration \u00e0 double chariot est-elle prise en charge avec l'input shaper\u00a0?"},{"location":"Resonance_Compensation.html#input_shaper-affecte-t-il-le-temps-dimpression","text":"Non, la fonctionnalit\u00e9 input_shaper n'a pratiquement aucun impact sur les temps d'impression. Cependant, la valeur de max_accel en a un (r\u00e9glage de ce param\u00e8tre d\u00e9crit dans cette section ).","title":"input_shaper affecte-t-il le temps d'impression\u00a0?"},{"location":"Resonance_Compensation.html#details-techniques","text":"","title":"D\u00e9tails techniques"},{"location":"Resonance_Compensation.html#input-shapers","text":"Les input shaper utilis\u00e9s dans Klipper sont plut\u00f4t standards, et on peut en trouver un aper\u00e7u plus d\u00e9taill\u00e9 dans les articles d\u00e9crivant les input shaper correspondants. Cette section contient un bref aper\u00e7u de certains aspects techniques des input shapers pris en charge. Le tableau ci-dessous montre certains param\u00e8tres (g\u00e9n\u00e9ralement approximatifs) pour chaque input shaper. Input shaper Dur\u00e9e de l'input shaper R\u00e9duction des vibrations 20x (5 % de tol\u00e9rance aux vibrations) R\u00e9duction des vibrations 10x (tol\u00e9rance aux vibrations de 10 %) ZV 0,5 / shaper_freq N/A \u00b1 5% shaper_freq MZV 0,75 / shaper_freq \u00b1 4% shaper_freq -10%...+15% shaper_freq ZVD 1 / shaper_freq \u00b1 15% shaper_freq \u00b1 22% shaper_freq EI 1 / shaper_freq \u00b1 20% shaper_freq \u00b1 25% shaper_freq 2HUMP_EI 1,5 / shaper_freq \u00b1 35% shaper_freq \u00b1 40 shaper_freq 3HUMP_EI 2 / shaper_freq -45...+50% shaper_freq -50%...+55% shaper_freq Remarque concernant l'att\u00e9nuation des vibrations : les valeurs du tableau ci-dessus sont approximatives. Si le taux d'amortissement de l'imprimante est connu pour chaque axe, l'input shaper peut \u00eatre configur\u00e9 plus pr\u00e9cis\u00e9ment ce qui r\u00e9duira alors les r\u00e9sonances dans une plage de fr\u00e9quences un peu plus large. Cependant, le taux d'amortissement est g\u00e9n\u00e9ralement inconnu et difficile \u00e0 estimer sans \u00e9quipement sp\u00e9cial. Klipper utilise donc la valeur 0,1 par d\u00e9faut, ce qui est une bonne valeur globale. Les gammes de fr\u00e9quences du tableau couvrent un certain nombre de diff\u00e9rents rapports d'amortissement possibles autour de cette valeur (environ de 0,05 \u00e0 0,2). Notez \u00e9galement que EI, 2HUMP_EI et 3HUMP_EI sont r\u00e9gl\u00e9s pour r\u00e9duire les vibrations \u00e0 5 %, les valeurs pour une tol\u00e9rance de vibration de 10 % sont fournies uniquement \u00e0 titre indicatif. Comment utiliser ce tableau : La dur\u00e9e de l'input shaper affecte le lissage des pi\u00e8ces - plus elle est grande, plus les pi\u00e8ces sont lisses. Cette d\u00e9pendance n'est pas lin\u00e9aire, mais peut donner une id\u00e9e des input shapers qui \"lissent\" le plus pour une m\u00eame fr\u00e9quence. L'ordre par lissage est le suivant : ZV < MZV < ZVD \u2248 EI < 2HUMP_EI < 3HUMP_EI. De plus, il est rarement pratique de r\u00e9gler shaper_freq = fr\u00e9quence de r\u00e9sonance des types 2HUMP_EI et 3HUMP_EI (utilis\u00e9s pour r\u00e9duire les vibrations sur plusieurs fr\u00e9quences). On peut estimer une gamme de fr\u00e9quences pour laquelle l'input shaper r\u00e9duit les vibrations. Par exemple, MZV avec shaper_freq = 35 Hz r\u00e9duit les vibrations \u00e0 5 % pour les fr\u00e9quences [33,6, 36,4] Hz. 3HUMP_EI avec shaper_freq = 50 Hz r\u00e9duit les vibrations \u00e0 5 % dans la plage [27,5 - 75] Hz. On peut utiliser ce tableau pour v\u00e9rifier quel input shaper choisir pour la r\u00e9duction des vibrations de plusieurs fr\u00e9quences. Par exemple, si on a des r\u00e9sonances \u00e0 35 Hz et 60 Hz sur le m\u00eame axe : a) EI doit avoir shaper_freq = 35 / (1 - 0.2) = 43.75 Hz, ce qui r\u00e9duirait les r\u00e9sonances jusqu'\u00e0 43.75 * (1 + 0,2) = 52,5 Hz, donc ce n'est pas suffisant ; b) Le 2HUMP_EI doit avoir shaper_freq = 35 / (1 - 0,35) = 53,85 Hz ce qui r\u00e9duira les vibrations jusqu'\u00e0 53,85 * (1 + 0,35) = 72,7 Hz - c'est donc une configuration acceptable. Essayez toujours d'utiliser le plus haut shaper_freq possible pour un input shaper donn\u00e9 (peut-\u00eatre avec une certaine marge de s\u00e9curit\u00e9, donc dans cet exemple shaper_freq \u2248 50-52 Hz fonctionnerait mieux), et essayez d'utiliser un input shaper avec une dur\u00e9e aussi petite que possible. Si l'on a besoin de r\u00e9duire les vibrations de plusieurs fr\u00e9quences tr\u00e8s diff\u00e9rentes (par exemple, 30 Hz et 100 Hz), le tableau ci-dessus ne fournit pas suffisamment d'informations. Dans ce cas, on peut avoir plus de chance avec le script scripts/graph_shaper.py , qui est plus flexible.","title":"Input shapers"},{"location":"Rotation_Distance.html","text":"Distance de rotation \u00b6 Les pilotes de moteur pas \u00e0 pas avec Klipper n\u00e9cessitent un param\u00e8tre rotation_distance dans chaque section de configuration des pilotes pas \u00e0 pas . La rotation_distance est la distance parcourue par l'axe apr\u00e8s un tour complet du moteur pas \u00e0 pas. Ce document d\u00e9crit comment configurer cette valeur. Obtention de la distance de rotation \u00e0 partir de steps_per_mm (ou step_distance) \u00b6 Les concepteurs de votre imprimante 3d ont calcul\u00e9 \u00e0 l'origine les pas_par_mm \u00e0 partir d'une distance de rotation. Si vous connaissez les pas_par_mm, il est possible d'utiliser cette formule g\u00e9n\u00e9rale pour obtenir cette distance de rotation originale : rotation_distance = <full_steps_par_rotation> * <microsteps> / <steps_par_mm> Ou, si vous avez une ancienne configuration Klipper et que vous connaissez le param\u00e8tre step_distance , vous pouvez utiliser cette formule : rotation_distance = <full_steps_per_rotation> * <microsteps> * <step_distance> Le param\u00e8tre <full_steps_per_rotation> est d\u00e9termin\u00e9 par le type du moteur pas \u00e0 pas. La plupart des moteurs pas \u00e0 pas sont des \"pas \u00e0 pas de 1,8 degr\u00e9\" et ont donc 200 pas complets par rotation (360 divis\u00e9 par 1,8 est \u00e9gal \u00e0 200). Certains moteurs pas \u00e0 pas sont des \"pas \u00e0 pas de 0,9 degr\u00e9\" et ont donc 400 pas complets par rotation. D'autres type de moteurs pas \u00e0 pas sont rares. En cas de doute, ne d\u00e9finissez pas full_steps_per_rotation dans le fichier de configuration et utilisez 200 dans la formule ci-dessus. Le param\u00e8tre <microsteps> est d\u00e9termin\u00e9 par le pilote du moteur pas \u00e0 pas. La plupart des pilotes utilisent 16 micro-pas. Si vous n'\u00eates pas s\u00fbr, d\u00e9finissez microsteps : 16 dans la configuration et utilisez 16 dans la formule ci-dessus. Presque toutes les imprimantes devraient utiliser un nombre entier pour la distance de rotation des axes de type X, Y, et Z. Si la formule ci-dessus donne une distance de rotation qui est \u00e0 moins de 0,01 d'un nombre entier, arrondissez la valeur finale \u00e0 ce nombre entier. Calibration de la distance de rotation des extrudeuses \u00b6 Sur une extrudeuse, la rotation_distance est la distance que parcourt le filament durant une rotation compl\u00e8te du moteur pas \u00e0 pas. La meilleure fa\u00e7on d'obtenir une valeur pr\u00e9cise pour ce param\u00e8tre est d'utiliser une proc\u00e9dure de \"mesure et ajustement\". Commencez par une estimation initiale de la distance de rotation. Elle peut \u00eatre obtenue \u00e0 partir de pas_par_mm ou en inspectant le mat\u00e9riel . Utilisez ensuite la proc\u00e9dure suivante pour \"mesurer et ajuster\" : Assurez-vous que l'extrudeuse contient du filament, que le bloc chauffant est \u00e0 une temp\u00e9rature appropri\u00e9e et que l'imprimante est pr\u00eate \u00e0 extruder. Utilisez un marqueur pour placer une marque sur le filament \u00e0 environ 70 mm de l'entr\u00e9e du corps de l'extrudeuse. Utilisez ensuite un pied \u00e0 coulisse num\u00e9rique pour mesurer la distance r\u00e9elle de cette marque aussi pr\u00e9cis\u00e9ment que possible. Notez cette mesure comme <initial_mark_distance> . Extrudez 50 mm de filament avec la s\u00e9quence de commandes suivante : G91 suivi de G1 E50 F60 . Notez 50mm comme <distance_extrud\u00e9e_requise> . Attendez que l'extrudeuse termine son mouvement (cela prendra environ 50 secondes). Il est important d'utiliser la vitesse d'extrusion lente pour ce test car une vitesse plus rapide peut provoquer une pression \u00e9lev\u00e9e dans l'extrudeuse qui fausserait les r\u00e9sultats. (N'utilisez pas le \"bouton d'extrusion\" des interfaces graphiques pour ce test car ils extrudent \u00e0 une vitesse rapide.) Utilisez le pied \u00e0 coulisse num\u00e9rique pour mesurer la nouvelle distance entre le corps de l'extrudeuse et la marque sur le filament. Notez cette distance comme <distance_marque_suivante> . Calculez ensuite : Distance_extrud\u00e9e_r\u00e9elle = <distance_marque_initiale> - <distance_marque_suivante> Calculez la distance de rotation comme suit : distance_rotation = <distance_rotation_pr\u00e9c\u00e9dente> * <distance_extrusion_r\u00e9elle> / <distance_extrusion_demand\u00e9e> Arrondissez la nouvelle distance_rotation \u00e0 trois d\u00e9cimales. Si la distance_extrud\u00e9e_r\u00e9elle diff\u00e8re de la distance_extrud\u00e9e_requise de plus de 2 mm environ, il est bon d'effectuer les \u00e9tapes ci-dessus une nouvelle fois. Remarque : n'utilisez pas une m\u00e9thode de type \" mesurer et ajuster \" pour calibrer les axes de type x, y ou z. La m\u00e9thode \" mesurer et ajuster \" n'est pas assez pr\u00e9cise pour ces axes et conduira probablement \u00e0 une configuration moins bonne. Au lieu de cela, si n\u00e9cessaire, ces axes peuvent \u00eatre d\u00e9termin\u00e9s en mesurant les courroies, les poulies et les vis-m\u00e8re . Obtention de la distance de rotation par l'inspection du mat\u00e9riel \u00b6 Il est possible de calculer la distance de rotation en connaissant les moteurs pas \u00e0 pas et la cin\u00e9matique de l'imprimante. Cela peut \u00eatre utile si le nombre de pas par mm n'est pas connu ou si l'on con\u00e7oit une nouvelle imprimante. Axes entra\u00een\u00e9s par courroie \u00b6 Il est facile de calculer la distance de rotation pour un axe lin\u00e9aire utilisant une courroie et une poulie. D\u00e9terminez d'abord le type de courroie. La plupart des imprimantes utilisent un pas de courroie de 2 mm (c'est-\u00e0-dire que chaque dent de la courroie est espac\u00e9e de 2 mm). Comptez ensuite le nombre de dents sur la poulie du moteur pas \u00e0 pas. La distance de rotation est alors calcul\u00e9e comme suit : rotation_distance = <belt_pitch> * <number_of_teeth_on_pulley> Par exemple, si une imprimante a une courroie dont le pas est de 2 mm et utilise une poulie \u00e0 20 dents, la distance de rotation est de 40. Axes avec vis-m\u00e8re \u00b6 Il est facile de calculer la distance de rotation pour les vis-m\u00e8res communes \u00e0 l'aide de la formule suivante : rotation_distance = <screw_pitch> * <number_of_separate_threads> Par exemple, la \"vis-m\u00e8re T8\" courante a une distance de rotation de 8 (elle a un pas de 2 mm et comporte 4 filets s\u00e9par\u00e9s). Les imprimantes plus anciennes \u00e9quip\u00e9es de \"tiges filet\u00e9es\" n'ont qu'un seul \"filetage\" sur la vis-m\u00e8re et la distance de rotation correspond donc au pas de la vis. (Le pas de la vis est la distance entre chaque rainure de la vis). Ainsi, par exemple, une tige m\u00e9trique M6 a une distance de rotation de 1 et une tige M8 a une distance de rotation de 1,25. Extrudeuse \u00b6 Il est possible d'obtenir une distance de rotation initiale pour les extrudeuses en mesurant le diam\u00e8tre de la \"roue dent\u00e9e\" entrainant le filament, en utilisant la formule suivante : distance_de_rotation = <diam\u00e8tre> * 3.14 Si l'extrudeuse utilise des engrenages, il faudra \u00e9galement d\u00e9terminer et r\u00e9gler le rapport de d\u00e9multiplication pour celle-ci. La distance de rotation r\u00e9elle d'une extrudeuse varie d'une imprimante \u00e0 l'autre, car la prise de la \"roue cr\u00e9nel\u00e9e\" qui s'engage dans le filament peut varier. Elle peut m\u00eame varier d'une bobine de filament \u00e0 l'autre. Apr\u00e8s avoir obtenu une distance de rotation initiale, utilisez la proc\u00e9dure de mesure et d'ajustement pour obtenir un r\u00e9glage plus pr\u00e9cis. Utilisation d'un gear_ratio \u00b6 D\u00e9finir un gear_ratio peut faciliter la configuration de la rotation_distance des moteurs ayant une bo\u00eete de vitesse (ou similaire) attach\u00e9e \u00e0 eux. La plupart des moteurs n'ont pas de bo\u00eete de vitesse - si vous n'\u00eates pas s\u00fbr, n'utilisez pas de gear_ratio dans la configuration. Lorsqu'un gear_ratio est d\u00e9fini, la rotation_distance repr\u00e9sente la distance parcourue par l'axe lors d'une rotation compl\u00e8te du dernier engrenage de la bo\u00eete de vitesses. Si, par exemple, on utilise une bo\u00eete de vitesses avec un rapport \"5:1\", on peut calculer la distance de rotation avec connaissance du mat\u00e9riel et ensuite ajouter gear_ratio : 5:1 \u00e0 la configuration. Pour des engrenages mis en \u0153uvre avec des courroies et des poulies, il est possible de d\u00e9terminer le rapport de d\u00e9multiplication en comptant les dents des poulies. Par exemple, si une poulie de 16 dents entra\u00eene la poulie suivante de 80 dents, on utilisera gear_ratio : 80:16 . En effet, on peut ouvrir une \"bo\u00eete de vitesse\" courante et compter les dents pour confirmer le rapport d'engrenage. Notez que parfois, une bo\u00eete de vitesses aura un rapport de transmission l\u00e9g\u00e8rement diff\u00e9rent de celui qui est annonc\u00e9. Les engrenages courants du moteur d'extrudeuse BMG en sont un exemple - ils sont annonc\u00e9s comme \u00e9tant de \"3:1\" mais utilisent en r\u00e9alit\u00e9 un engrenage de \"50:17\". (L'utilisation de nombres de dents sans d\u00e9nominateur commun peut am\u00e9liorer l'usure globale de l'engrenage car les dents ne s'engr\u00e8nent pas toujours de la m\u00eame mani\u00e8re \u00e0 chaque tour). La \"boite de vitesses plan\u00e9taire 5.18:1\" commune, est plus pr\u00e9cis\u00e9ment configur\u00e9e avec un gear_ratio : 57:11 . Si plusieurs engrenages sont utilis\u00e9s sur un axe, il est possible de fournir une liste s\u00e9par\u00e9e par des virgules au param\u00e8tre gear_ratio. Par exemple, une bo\u00eete de vitesse \"5:1\" entra\u00eenant une poulie de 16 \u00e0 80 dents pourrait utiliser gear_ratio : 5:1, 80:16 . Dans la plupart des cas, le param\u00e8tre gear_ratio doit \u00eatre d\u00e9fini avec des nombres entiers, car les engrenages et les poulies les plus courants ont un nombre entier de dents. Cependant, dans les cas o\u00f9 une courroie entra\u00eene une poulie en utilisant la friction au lieu des dents, il peut \u00eatre utile d'utiliser un nombre \u00e0 virgule flottante dans le rapport de vitesse (par exemple, gear_ratio : 107.237:16 ).","title":"Distance de rotation"},{"location":"Rotation_Distance.html#distance-de-rotation","text":"Les pilotes de moteur pas \u00e0 pas avec Klipper n\u00e9cessitent un param\u00e8tre rotation_distance dans chaque section de configuration des pilotes pas \u00e0 pas . La rotation_distance est la distance parcourue par l'axe apr\u00e8s un tour complet du moteur pas \u00e0 pas. Ce document d\u00e9crit comment configurer cette valeur.","title":"Distance de rotation"},{"location":"Rotation_Distance.html#obtention-de-la-distance-de-rotation-a-partir-de-steps_per_mm-ou-step_distance","text":"Les concepteurs de votre imprimante 3d ont calcul\u00e9 \u00e0 l'origine les pas_par_mm \u00e0 partir d'une distance de rotation. Si vous connaissez les pas_par_mm, il est possible d'utiliser cette formule g\u00e9n\u00e9rale pour obtenir cette distance de rotation originale : rotation_distance = <full_steps_par_rotation> * <microsteps> / <steps_par_mm> Ou, si vous avez une ancienne configuration Klipper et que vous connaissez le param\u00e8tre step_distance , vous pouvez utiliser cette formule : rotation_distance = <full_steps_per_rotation> * <microsteps> * <step_distance> Le param\u00e8tre <full_steps_per_rotation> est d\u00e9termin\u00e9 par le type du moteur pas \u00e0 pas. La plupart des moteurs pas \u00e0 pas sont des \"pas \u00e0 pas de 1,8 degr\u00e9\" et ont donc 200 pas complets par rotation (360 divis\u00e9 par 1,8 est \u00e9gal \u00e0 200). Certains moteurs pas \u00e0 pas sont des \"pas \u00e0 pas de 0,9 degr\u00e9\" et ont donc 400 pas complets par rotation. D'autres type de moteurs pas \u00e0 pas sont rares. En cas de doute, ne d\u00e9finissez pas full_steps_per_rotation dans le fichier de configuration et utilisez 200 dans la formule ci-dessus. Le param\u00e8tre <microsteps> est d\u00e9termin\u00e9 par le pilote du moteur pas \u00e0 pas. La plupart des pilotes utilisent 16 micro-pas. Si vous n'\u00eates pas s\u00fbr, d\u00e9finissez microsteps : 16 dans la configuration et utilisez 16 dans la formule ci-dessus. Presque toutes les imprimantes devraient utiliser un nombre entier pour la distance de rotation des axes de type X, Y, et Z. Si la formule ci-dessus donne une distance de rotation qui est \u00e0 moins de 0,01 d'un nombre entier, arrondissez la valeur finale \u00e0 ce nombre entier.","title":"Obtention de la distance de rotation \u00e0 partir de steps_per_mm (ou step_distance)"},{"location":"Rotation_Distance.html#calibration-de-la-distance-de-rotation-des-extrudeuses","text":"Sur une extrudeuse, la rotation_distance est la distance que parcourt le filament durant une rotation compl\u00e8te du moteur pas \u00e0 pas. La meilleure fa\u00e7on d'obtenir une valeur pr\u00e9cise pour ce param\u00e8tre est d'utiliser une proc\u00e9dure de \"mesure et ajustement\". Commencez par une estimation initiale de la distance de rotation. Elle peut \u00eatre obtenue \u00e0 partir de pas_par_mm ou en inspectant le mat\u00e9riel . Utilisez ensuite la proc\u00e9dure suivante pour \"mesurer et ajuster\" : Assurez-vous que l'extrudeuse contient du filament, que le bloc chauffant est \u00e0 une temp\u00e9rature appropri\u00e9e et que l'imprimante est pr\u00eate \u00e0 extruder. Utilisez un marqueur pour placer une marque sur le filament \u00e0 environ 70 mm de l'entr\u00e9e du corps de l'extrudeuse. Utilisez ensuite un pied \u00e0 coulisse num\u00e9rique pour mesurer la distance r\u00e9elle de cette marque aussi pr\u00e9cis\u00e9ment que possible. Notez cette mesure comme <initial_mark_distance> . Extrudez 50 mm de filament avec la s\u00e9quence de commandes suivante : G91 suivi de G1 E50 F60 . Notez 50mm comme <distance_extrud\u00e9e_requise> . Attendez que l'extrudeuse termine son mouvement (cela prendra environ 50 secondes). Il est important d'utiliser la vitesse d'extrusion lente pour ce test car une vitesse plus rapide peut provoquer une pression \u00e9lev\u00e9e dans l'extrudeuse qui fausserait les r\u00e9sultats. (N'utilisez pas le \"bouton d'extrusion\" des interfaces graphiques pour ce test car ils extrudent \u00e0 une vitesse rapide.) Utilisez le pied \u00e0 coulisse num\u00e9rique pour mesurer la nouvelle distance entre le corps de l'extrudeuse et la marque sur le filament. Notez cette distance comme <distance_marque_suivante> . Calculez ensuite : Distance_extrud\u00e9e_r\u00e9elle = <distance_marque_initiale> - <distance_marque_suivante> Calculez la distance de rotation comme suit : distance_rotation = <distance_rotation_pr\u00e9c\u00e9dente> * <distance_extrusion_r\u00e9elle> / <distance_extrusion_demand\u00e9e> Arrondissez la nouvelle distance_rotation \u00e0 trois d\u00e9cimales. Si la distance_extrud\u00e9e_r\u00e9elle diff\u00e8re de la distance_extrud\u00e9e_requise de plus de 2 mm environ, il est bon d'effectuer les \u00e9tapes ci-dessus une nouvelle fois. Remarque : n'utilisez pas une m\u00e9thode de type \" mesurer et ajuster \" pour calibrer les axes de type x, y ou z. La m\u00e9thode \" mesurer et ajuster \" n'est pas assez pr\u00e9cise pour ces axes et conduira probablement \u00e0 une configuration moins bonne. Au lieu de cela, si n\u00e9cessaire, ces axes peuvent \u00eatre d\u00e9termin\u00e9s en mesurant les courroies, les poulies et les vis-m\u00e8re .","title":"Calibration de la distance de rotation des extrudeuses"},{"location":"Rotation_Distance.html#obtention-de-la-distance-de-rotation-par-linspection-du-materiel","text":"Il est possible de calculer la distance de rotation en connaissant les moteurs pas \u00e0 pas et la cin\u00e9matique de l'imprimante. Cela peut \u00eatre utile si le nombre de pas par mm n'est pas connu ou si l'on con\u00e7oit une nouvelle imprimante.","title":"Obtention de la distance de rotation par l'inspection du mat\u00e9riel"},{"location":"Rotation_Distance.html#axes-entraines-par-courroie","text":"Il est facile de calculer la distance de rotation pour un axe lin\u00e9aire utilisant une courroie et une poulie. D\u00e9terminez d'abord le type de courroie. La plupart des imprimantes utilisent un pas de courroie de 2 mm (c'est-\u00e0-dire que chaque dent de la courroie est espac\u00e9e de 2 mm). Comptez ensuite le nombre de dents sur la poulie du moteur pas \u00e0 pas. La distance de rotation est alors calcul\u00e9e comme suit : rotation_distance = <belt_pitch> * <number_of_teeth_on_pulley> Par exemple, si une imprimante a une courroie dont le pas est de 2 mm et utilise une poulie \u00e0 20 dents, la distance de rotation est de 40.","title":"Axes entra\u00een\u00e9s par courroie"},{"location":"Rotation_Distance.html#axes-avec-vis-mere","text":"Il est facile de calculer la distance de rotation pour les vis-m\u00e8res communes \u00e0 l'aide de la formule suivante : rotation_distance = <screw_pitch> * <number_of_separate_threads> Par exemple, la \"vis-m\u00e8re T8\" courante a une distance de rotation de 8 (elle a un pas de 2 mm et comporte 4 filets s\u00e9par\u00e9s). Les imprimantes plus anciennes \u00e9quip\u00e9es de \"tiges filet\u00e9es\" n'ont qu'un seul \"filetage\" sur la vis-m\u00e8re et la distance de rotation correspond donc au pas de la vis. (Le pas de la vis est la distance entre chaque rainure de la vis). Ainsi, par exemple, une tige m\u00e9trique M6 a une distance de rotation de 1 et une tige M8 a une distance de rotation de 1,25.","title":"Axes avec vis-m\u00e8re"},{"location":"Rotation_Distance.html#extrudeuse","text":"Il est possible d'obtenir une distance de rotation initiale pour les extrudeuses en mesurant le diam\u00e8tre de la \"roue dent\u00e9e\" entrainant le filament, en utilisant la formule suivante : distance_de_rotation = <diam\u00e8tre> * 3.14 Si l'extrudeuse utilise des engrenages, il faudra \u00e9galement d\u00e9terminer et r\u00e9gler le rapport de d\u00e9multiplication pour celle-ci. La distance de rotation r\u00e9elle d'une extrudeuse varie d'une imprimante \u00e0 l'autre, car la prise de la \"roue cr\u00e9nel\u00e9e\" qui s'engage dans le filament peut varier. Elle peut m\u00eame varier d'une bobine de filament \u00e0 l'autre. Apr\u00e8s avoir obtenu une distance de rotation initiale, utilisez la proc\u00e9dure de mesure et d'ajustement pour obtenir un r\u00e9glage plus pr\u00e9cis.","title":"Extrudeuse"},{"location":"Rotation_Distance.html#utilisation-dun-gear_ratio","text":"D\u00e9finir un gear_ratio peut faciliter la configuration de la rotation_distance des moteurs ayant une bo\u00eete de vitesse (ou similaire) attach\u00e9e \u00e0 eux. La plupart des moteurs n'ont pas de bo\u00eete de vitesse - si vous n'\u00eates pas s\u00fbr, n'utilisez pas de gear_ratio dans la configuration. Lorsqu'un gear_ratio est d\u00e9fini, la rotation_distance repr\u00e9sente la distance parcourue par l'axe lors d'une rotation compl\u00e8te du dernier engrenage de la bo\u00eete de vitesses. Si, par exemple, on utilise une bo\u00eete de vitesses avec un rapport \"5:1\", on peut calculer la distance de rotation avec connaissance du mat\u00e9riel et ensuite ajouter gear_ratio : 5:1 \u00e0 la configuration. Pour des engrenages mis en \u0153uvre avec des courroies et des poulies, il est possible de d\u00e9terminer le rapport de d\u00e9multiplication en comptant les dents des poulies. Par exemple, si une poulie de 16 dents entra\u00eene la poulie suivante de 80 dents, on utilisera gear_ratio : 80:16 . En effet, on peut ouvrir une \"bo\u00eete de vitesse\" courante et compter les dents pour confirmer le rapport d'engrenage. Notez que parfois, une bo\u00eete de vitesses aura un rapport de transmission l\u00e9g\u00e8rement diff\u00e9rent de celui qui est annonc\u00e9. Les engrenages courants du moteur d'extrudeuse BMG en sont un exemple - ils sont annonc\u00e9s comme \u00e9tant de \"3:1\" mais utilisent en r\u00e9alit\u00e9 un engrenage de \"50:17\". (L'utilisation de nombres de dents sans d\u00e9nominateur commun peut am\u00e9liorer l'usure globale de l'engrenage car les dents ne s'engr\u00e8nent pas toujours de la m\u00eame mani\u00e8re \u00e0 chaque tour). La \"boite de vitesses plan\u00e9taire 5.18:1\" commune, est plus pr\u00e9cis\u00e9ment configur\u00e9e avec un gear_ratio : 57:11 . Si plusieurs engrenages sont utilis\u00e9s sur un axe, il est possible de fournir une liste s\u00e9par\u00e9e par des virgules au param\u00e8tre gear_ratio. Par exemple, une bo\u00eete de vitesse \"5:1\" entra\u00eenant une poulie de 16 \u00e0 80 dents pourrait utiliser gear_ratio : 5:1, 80:16 . Dans la plupart des cas, le param\u00e8tre gear_ratio doit \u00eatre d\u00e9fini avec des nombres entiers, car les engrenages et les poulies les plus courants ont un nombre entier de dents. Cependant, dans les cas o\u00f9 une courroie entra\u00eene une poulie en utilisant la friction au lieu des dents, il peut \u00eatre utile d'utiliser un nombre \u00e0 virgule flottante dans le rapport de vitesse (par exemple, gear_ratio : 107.237:16 ).","title":"Utilisation d'un gear_ratio"},{"location":"SDCard_Updates.html","text":"Mises \u00e0 jour via la carte SD \u00b6 La plupart des microcontr\u00f4leurs actuels sont livr\u00e9s avec un programme d'amor\u00e7age capable de mettre \u00e0 jour le micrologiciel via une carte SD. Bien que cela soit pratique dans de nombreux cas, ces programmes d'amor\u00e7age ne fournissent g\u00e9n\u00e9ralement aucun autre moyen de mettre \u00e0 jour le micrologiciel. Cela peut s'av\u00e9rer g\u00eanant si votre carte est install\u00e9e dans un endroit difficile d'acc\u00e8s ou si vous avez besoin de mettre \u00e0 jour le firmware r\u00e9guli\u00e8rement. Apr\u00e8s avoir initialement flash\u00e9 Klipper sur un microcontr\u00f4leur, il est possible de transf\u00e9rer le nouveau micrologiciel sur la carte SD et de lancer le processus de mise \u00e0 jour via ssh. Proc\u00e9dure de mise \u00e0 jour classique \u00b6 La proc\u00e9dure pour mettre \u00e0 jour le firmware du MCU en utilisant la carte SD est similaire \u00e0 celle des autres m\u00e9thodes. Au lieu d'utiliser make flash , il est n\u00e9cessaire d'ex\u00e9cuter un script d'aide, flash-sdcard.sh . La mise \u00e0 jour d'un BigTreeTech SKR 1.3 pourrait ressembler \u00e0 ce qui suit : sudo service klipper stop cd ~/klipper git pull make clean make menuconfig make ./scripts/flash-sdcard.sh /dev/ttyACM0 btt-skr-v1.3 sudo service klipper start C'est \u00e0 l'utilisateur de d\u00e9terminer l'emplacement du p\u00e9riph\u00e9rique et le nom de la carte. Si un utilisateur a besoin de flasher plusieurs cartes, flash-sdcard.sh (ou make flash si appropri\u00e9) doit \u00eatre ex\u00e9cut\u00e9 pour chaque carte avant de red\u00e9marrer le service Klipper. Les cartes support\u00e9es peuvent \u00eatre list\u00e9es avec la commande suivante : ./scripts/flash-sdcard.sh -l Si vous ne voyez pas votre carte dans la liste, il peut \u00eatre n\u00e9cessaire d'ajouter une nouvelle d\u00e9finition de carte comme d\u00e9crit ci-dessous . Utilisation avanc\u00e9e \u00b6 Les commandes ci-dessus supposent que votre MCU se connecte \u00e0 la vitesse de transmission par d\u00e9faut de 250000 et que le firmware se trouve dans ~/klipper/out/klipper.bin . Le script flash-sdcard.sh fournit des options pour changer ces valeurs par d\u00e9faut. Toutes les options peuvent \u00eatre visualis\u00e9es par l'\u00e9cran d'aide : ./scripts/flash-sdcard.sh -h SD Card upload utility for Klipper usage: flash_sdcard.sh [-h] [-l] [-c] [-b <baud>] [-f <firmware>] <device> <board> positional arguments: <device> device serial port <board> board type optional arguments: -h show this message -l list available boards -c run flash check/verify only (skip upload) -b <baud> serial baud rate (default is 250000) -f <firmware> path to klipper.bin Si votre carte est flash\u00e9e avec un firmware qui se connecte \u00e0 un taux de baud personnalis\u00e9, il est possible de mettre \u00e0 jour en sp\u00e9cifiant l'option -b : ./scripts/flash-sdcard.sh -b 115200 /dev/ttyAMA0 btt-skr-v1.3 Si vous souhaitez flasher une version de Klipper situ\u00e9e ailleurs que dans l'emplacement par d\u00e9faut, vous pouvez le faire en sp\u00e9cifiant l'option -f : ./scripts/flash-sdcard.sh -f ~/downloads/klipper.bin /dev/ttyAMA0 btt-skr-v1.3 Notez que lors de la mise \u00e0 jour d'un MKS Robin E3, il n'est pas n\u00e9cessaire d'ex\u00e9cuter manuellement update_mks_robin.py et de fournir le binaire r\u00e9sultant \u00e0 flash-sdcard.sh . Cette proc\u00e9dure est automatis\u00e9e pendant le processus de t\u00e9l\u00e9chargement. L'option -c est utilis\u00e9e pour effectuer une op\u00e9ration de contr\u00f4le ou de v\u00e9rification uniquement pour tester si la carte ex\u00e9cute correctement le firmware sp\u00e9cifi\u00e9. Cette option est principalement destin\u00e9e aux cas o\u00f9 un cycle d'alimentation manuel est n\u00e9cessaire pour compl\u00e9ter la proc\u00e9dure de flashage, comme avec des chargeurs de d\u00e9marrage utilisant le mode SDIO au lieu de SPI pour acc\u00e9der \u00e0 leurs cartes SD. (Voir Caveats ci-dessous) Mais, elle peut \u00e9galement \u00eatre utilis\u00e9e \u00e0 tout moment pour v\u00e9rifier si le code flash\u00e9 dans la carte correspond \u00e0 la version dans votre dossier de construction sur toute carte support\u00e9e. Avertissements \u00b6 Comme mentionn\u00e9 dans l'introduction, cette m\u00e9thode ne fonctionne que pour la mise \u00e0 jour du firmware. La proc\u00e9dure de flashage initial doit \u00eatre effectu\u00e9e manuellement selon les instructions qui s'appliquent \u00e0 votre carte contr\u00f4leur. Bien qu'il soit possible de flasher un build qui change le Baud s\u00e9rie ou l'interface de connexion (par exemple, de USB \u00e0 UART), la v\u00e9rification \u00e9chouera toujours car le script ne pourra pas se reconnecter au MCU pour v\u00e9rifier la version actuelle. Seules les cartes utilisant SPI pour la communication avec la carte SD sont support\u00e9es. Les cartes utiliaent SDIO, comme la Flymaker Flyboard et la MKS Robin Nano V1/V2, ne fonctionneront pas en mode SDIO. Cependant, il est g\u00e9n\u00e9ralement possible de flasher ces cartes en utilisant le mode SPI logiciel. Mais si le chargeur d'amor\u00e7age de la carte n'utilise que le mode SDIO pour acc\u00e9der \u00e0 la carte SD, un cycle d'alimentation de la carte et de la carte SD sera n\u00e9cessaire pour que le mode puisse passer de SPI \u00e0 SDIO pour terminer le flashage. De telles cartes devraient \u00eatre d\u00e9finies avec skip_verify activ\u00e9 pour sauter l'\u00e9tape de v\u00e9rification imm\u00e9diatement apr\u00e8s le flashage. Ensuite, apr\u00e8s le power-cycle manuel, vous pouvez r\u00e9-ex\u00e9cuter exactement la m\u00eame commande ./scripts/flash-sdcard.sh , mais ajouter l'option -c pour compl\u00e9ter l'op\u00e9ration de v\u00e9rification. Voir Flasher des cartes utilisant SDIO pour des exemples. D\u00e9finitions des cartes \u00b6 La plupart des cartes courantes devraient \u00eatre disponibles, mais il est possible d'ajouter une nouvelle d\u00e9finition de carte si n\u00e9cessaire. Les d\u00e9finitions des cartes sont situ\u00e9es dans ~/klipper/scripts/spi_flash/board_defs.py . Les d\u00e9finitions sont stock\u00e9es dans un dictionnaire, par exemple : BOARD_DEFS = { 'generic-lpc1768' : { 'mcu' : \"lpc1768\" , 'spi_bus' : \"ssp1\" , \"cs_pin\" : \"P0.6\" }, ...< further definitions > } Les champs suivants peuvent \u00eatre pr\u00e9cis\u00e9s : mcu : Le type de mcu. On peut le retrouver apr\u00e8s avoir configur\u00e9 le build via make menuconfig en ex\u00e9cutant cat .config | grep CONFIG_MCU . Ce champ est obligatoire. spi_bus : Le bus SPI connect\u00e9 \u00e0 la carte SD. Ceci doit \u00eatre obtenu \u00e0 partir du sch\u00e9ma de la carte. Ce champ est obligatoire. cs_pin : La broche de s\u00e9lection de puce connect\u00e9e \u00e0 la carte SD. Ceci doit \u00eatre obtenu \u00e0 partir du sch\u00e9ma de la carte. Ce champ est obligatoire. firmware_path : Le chemin sur la carte SD o\u00f9 le firmware doit \u00eatre transf\u00e9r\u00e9. La valeur par d\u00e9faut est firmware.bin . current_firmware_path : Le chemin sur la carte SD o\u00f9 le fichier du firmware renomm\u00e9 est situ\u00e9 apr\u00e8s un flash r\u00e9ussi. La valeur par d\u00e9faut est firmware.cur . skip_verify : d\u00e9finit une valeur bool\u00e9enne indiquant aux scripts d'ignorer l'\u00e9tape de v\u00e9rification du firmware pendant le processus de flashage. La valeur par d\u00e9faut est False . Peut \u00eatre d\u00e9fini \u00e0 True pour les cartes n\u00e9cessitant un cycle d'alimentation manuel pour terminer le flashage. Pour v\u00e9rifier le firmware par la suite, ex\u00e9cutez \u00e0 nouveau le script avec l'option -c pour effectuer l'\u00e9tape de v\u00e9rification. Voir les avertissements avec les cartes SDIO Si le SPI logiciel est requis, le champ spi_bus doit \u00eatre r\u00e9gl\u00e9 sur swspi et le champ suppl\u00e9mentaire suivant doit \u00eatre sp\u00e9cifi\u00e9 : spi_pins : Ceci devrait \u00eatre 3 broches s\u00e9par\u00e9es par des virgules qui sont connect\u00e9es \u00e0 la carte SD dans le format de miso,mosi,sclk . Il devrait \u00eatre extr\u00eamement rare que le SPI logiciel soit n\u00e9cessaire, typiquement seules les cartes avec des erreurs de conception ou les cartes ne supportant que le mode SDIO pour leur carte SD en auront besoin. La d\u00e9finition de la carte btt-skr-pro fournit un exemple du premier cas, et la d\u00e9finition de la carte btt-octopus-f446-v1 fournit un exemple du second. Avant de cr\u00e9er une nouvelle d\u00e9finition de carte, il faut v\u00e9rifier si la d\u00e9finition d'une carte existante r\u00e9pond aux crit\u00e8res n\u00e9cessaires pour la nouvelle carte. Si c'est le cas, un BOARD_ALIAS peut \u00eatre utilis\u00e9. Par exemple, l'alias suivant peut \u00eatre ajout\u00e9 pour sp\u00e9cifier my-new-board comme alias de generic-lpc1768 : BOARD_ALIASES = { ...< previous aliases > , 'my-new-board' : BOARD_DEFS [ 'generic-lpc1768' ], } Si vous avez besoin d'une nouvelle d\u00e9finition de carte et que vous n'\u00eates pas \u00e0 l'aise avec la proc\u00e9dure d\u00e9crite ci-dessus, il est recommand\u00e9 d'en demander une sur le Discord de la communaut\u00e9 Klipper . Flashage des cartes utilisant SDIO \u00b6 Comme mentionn\u00e9 dans les Caveats , les cartes dont le chargeur de d\u00e9marrage utilise le mode SDIO pour l'acc\u00e8s \u00e0 leur carte SD n\u00e9cessitent un power-cycle de la carte, et plus particuli\u00e8rement de la carte SD elle-m\u00eame, afin de passer du mode SPI utilis\u00e9 lors de l'\u00e9criture du fichier sur la carte SD au mode SDIO pour que le chargeur de d\u00e9marrage puisse le flasher sur la carte. Ces d\u00e9finitions de cartes utiliseront le drapeau skip_verify , qui indique \u00e0 l'outil de flashage de s'arr\u00eater apr\u00e8s l'\u00e9criture du firmware sur la carte SD afin que la carte puisse \u00eatre mise sous tension manuellement et que l'\u00e9tape de v\u00e9rification soit report\u00e9e jusqu'\u00e0 ce qu'elle soit termin\u00e9e. Il y a deux sc\u00e9narios : l'un avec l'h\u00f4te RPi fonctionnant sur une alimentation s\u00e9par\u00e9e et l'autre lorsque l'h\u00f4te RPi fonctionne sur la m\u00eame alimentation que la carte principale \u00e0 flasher. La diff\u00e9rence est de savoir s'il est n\u00e9cessaire ou non d'\u00e9teindre le RPi et ensuite ssh de nouveau apr\u00e8s que le flashage soit termin\u00e9 afin de faire l'\u00e9tape de v\u00e9rification, ou si la v\u00e9rification peut \u00eatre faite imm\u00e9diatement. Voici des exemples des deux sc\u00e9narios : Programmation SDIO avec RPi sur alimentation s\u00e9par\u00e9e \u00b6 Une session typique avec le RPi sur une alimentation s\u00e9par\u00e9e ressemble \u00e0 ce qui suit. Vous devrez, bien s\u00fbr, utiliser le chemin du p\u00e9riph\u00e9rique et le nom de la carte : sudo service klipper stop cd ~/klipper git pull make clean make menuconfig make ./scripts/flash-sdcard.sh /dev/ttyACM0 btt-octopus-f446-v1 [[[\u00e9teindre-allumer manuellement la carte de l'imprimante quand vous y \u00eates invit\u00e9]]] ./scripts/flash-sdcard.sh -c /dev/ttyACM0 btt-octopus-f446-v1 sudo service klipper start Programmation SDIO avec RPi sur la m\u00eame alimentation \u00e9lectrique \u00b6 Une session typique avec le RPi sur la m\u00eame alimentation ressemble \u00e0 ce qui suit. Vous devrez, bien s\u00fbr, utiliser le chemin du p\u00e9riph\u00e9rique et le nom de la carte : sudo service klipper stop cd ~/klipper git pull make clean make menuconfig make ./scripts/flash-sdcard.sh /dev/ttyACM0 btt-octopus-f446-v1 sudo shutdown -h now [[[attendre que le RPi s'arr\u00eate, puis \u00e9teindre-allumer et ssh \u00e0 nouveau sur le RPi quand il a red\u00e9marr\u00e9]]] sudo service klipper stop cd ~/klipper ./scripts/flash-sdcard.sh -c /dev/ttyACM0 btt-octopus-f446-v1 sudo service klipper start Dans ce cas, puisque l'h\u00f4te RPi est en train d'\u00eatre red\u00e9marr\u00e9, ce qui va red\u00e9marrer le service klipper , il est n\u00e9cessaire d'arr\u00eater le service klipper avant de faire l'\u00e9tape de v\u00e9rification et de le red\u00e9marrer une fois la v\u00e9rification termin\u00e9e. Mappage des broches SDIO vers SPI \u00b6 Si le sch\u00e9ma de votre carte utilise SDIO pour sa carte SD, vous pouvez mapper les broches comme d\u00e9crit dans le tableau ci-dessous pour d\u00e9terminer les broches SPI logicielles compatibles \u00e0 assigner dans le fichier board_defs.py : Broche de la carte SD Broche pour carte micro SD Nom de la broche SDIO Nom de la broche SPI 9 1 DATA2 None (PU)* 1 2 CD/DATA3 CS 2 3 CMD MOSI 4 4 +3.3V (VDD) +3.3V (VDD) 5 5 CLK SCLK 3 6 GND (VSS) GND (VSS) 7 7 DATA0 MISO 8 8 DATA1 None (PU)* N/A 9 Card Detect (CD) Card Detect (CD) 6 10 GND GND * None (PU) indique une broche inutilis\u00e9e avec une r\u00e9sistance de tirage haut","title":"Mises \u00e0 jour via la carte SD"},{"location":"SDCard_Updates.html#mises-a-jour-via-la-carte-sd","text":"La plupart des microcontr\u00f4leurs actuels sont livr\u00e9s avec un programme d'amor\u00e7age capable de mettre \u00e0 jour le micrologiciel via une carte SD. Bien que cela soit pratique dans de nombreux cas, ces programmes d'amor\u00e7age ne fournissent g\u00e9n\u00e9ralement aucun autre moyen de mettre \u00e0 jour le micrologiciel. Cela peut s'av\u00e9rer g\u00eanant si votre carte est install\u00e9e dans un endroit difficile d'acc\u00e8s ou si vous avez besoin de mettre \u00e0 jour le firmware r\u00e9guli\u00e8rement. Apr\u00e8s avoir initialement flash\u00e9 Klipper sur un microcontr\u00f4leur, il est possible de transf\u00e9rer le nouveau micrologiciel sur la carte SD et de lancer le processus de mise \u00e0 jour via ssh.","title":"Mises \u00e0 jour via la carte SD"},{"location":"SDCard_Updates.html#procedure-de-mise-a-jour-classique","text":"La proc\u00e9dure pour mettre \u00e0 jour le firmware du MCU en utilisant la carte SD est similaire \u00e0 celle des autres m\u00e9thodes. Au lieu d'utiliser make flash , il est n\u00e9cessaire d'ex\u00e9cuter un script d'aide, flash-sdcard.sh . La mise \u00e0 jour d'un BigTreeTech SKR 1.3 pourrait ressembler \u00e0 ce qui suit : sudo service klipper stop cd ~/klipper git pull make clean make menuconfig make ./scripts/flash-sdcard.sh /dev/ttyACM0 btt-skr-v1.3 sudo service klipper start C'est \u00e0 l'utilisateur de d\u00e9terminer l'emplacement du p\u00e9riph\u00e9rique et le nom de la carte. Si un utilisateur a besoin de flasher plusieurs cartes, flash-sdcard.sh (ou make flash si appropri\u00e9) doit \u00eatre ex\u00e9cut\u00e9 pour chaque carte avant de red\u00e9marrer le service Klipper. Les cartes support\u00e9es peuvent \u00eatre list\u00e9es avec la commande suivante : ./scripts/flash-sdcard.sh -l Si vous ne voyez pas votre carte dans la liste, il peut \u00eatre n\u00e9cessaire d'ajouter une nouvelle d\u00e9finition de carte comme d\u00e9crit ci-dessous .","title":"Proc\u00e9dure de mise \u00e0 jour classique"},{"location":"SDCard_Updates.html#utilisation-avancee","text":"Les commandes ci-dessus supposent que votre MCU se connecte \u00e0 la vitesse de transmission par d\u00e9faut de 250000 et que le firmware se trouve dans ~/klipper/out/klipper.bin . Le script flash-sdcard.sh fournit des options pour changer ces valeurs par d\u00e9faut. Toutes les options peuvent \u00eatre visualis\u00e9es par l'\u00e9cran d'aide : ./scripts/flash-sdcard.sh -h SD Card upload utility for Klipper usage: flash_sdcard.sh [-h] [-l] [-c] [-b <baud>] [-f <firmware>] <device> <board> positional arguments: <device> device serial port <board> board type optional arguments: -h show this message -l list available boards -c run flash check/verify only (skip upload) -b <baud> serial baud rate (default is 250000) -f <firmware> path to klipper.bin Si votre carte est flash\u00e9e avec un firmware qui se connecte \u00e0 un taux de baud personnalis\u00e9, il est possible de mettre \u00e0 jour en sp\u00e9cifiant l'option -b : ./scripts/flash-sdcard.sh -b 115200 /dev/ttyAMA0 btt-skr-v1.3 Si vous souhaitez flasher une version de Klipper situ\u00e9e ailleurs que dans l'emplacement par d\u00e9faut, vous pouvez le faire en sp\u00e9cifiant l'option -f : ./scripts/flash-sdcard.sh -f ~/downloads/klipper.bin /dev/ttyAMA0 btt-skr-v1.3 Notez que lors de la mise \u00e0 jour d'un MKS Robin E3, il n'est pas n\u00e9cessaire d'ex\u00e9cuter manuellement update_mks_robin.py et de fournir le binaire r\u00e9sultant \u00e0 flash-sdcard.sh . Cette proc\u00e9dure est automatis\u00e9e pendant le processus de t\u00e9l\u00e9chargement. L'option -c est utilis\u00e9e pour effectuer une op\u00e9ration de contr\u00f4le ou de v\u00e9rification uniquement pour tester si la carte ex\u00e9cute correctement le firmware sp\u00e9cifi\u00e9. Cette option est principalement destin\u00e9e aux cas o\u00f9 un cycle d'alimentation manuel est n\u00e9cessaire pour compl\u00e9ter la proc\u00e9dure de flashage, comme avec des chargeurs de d\u00e9marrage utilisant le mode SDIO au lieu de SPI pour acc\u00e9der \u00e0 leurs cartes SD. (Voir Caveats ci-dessous) Mais, elle peut \u00e9galement \u00eatre utilis\u00e9e \u00e0 tout moment pour v\u00e9rifier si le code flash\u00e9 dans la carte correspond \u00e0 la version dans votre dossier de construction sur toute carte support\u00e9e.","title":"Utilisation avanc\u00e9e"},{"location":"SDCard_Updates.html#avertissements","text":"Comme mentionn\u00e9 dans l'introduction, cette m\u00e9thode ne fonctionne que pour la mise \u00e0 jour du firmware. La proc\u00e9dure de flashage initial doit \u00eatre effectu\u00e9e manuellement selon les instructions qui s'appliquent \u00e0 votre carte contr\u00f4leur. Bien qu'il soit possible de flasher un build qui change le Baud s\u00e9rie ou l'interface de connexion (par exemple, de USB \u00e0 UART), la v\u00e9rification \u00e9chouera toujours car le script ne pourra pas se reconnecter au MCU pour v\u00e9rifier la version actuelle. Seules les cartes utilisant SPI pour la communication avec la carte SD sont support\u00e9es. Les cartes utiliaent SDIO, comme la Flymaker Flyboard et la MKS Robin Nano V1/V2, ne fonctionneront pas en mode SDIO. Cependant, il est g\u00e9n\u00e9ralement possible de flasher ces cartes en utilisant le mode SPI logiciel. Mais si le chargeur d'amor\u00e7age de la carte n'utilise que le mode SDIO pour acc\u00e9der \u00e0 la carte SD, un cycle d'alimentation de la carte et de la carte SD sera n\u00e9cessaire pour que le mode puisse passer de SPI \u00e0 SDIO pour terminer le flashage. De telles cartes devraient \u00eatre d\u00e9finies avec skip_verify activ\u00e9 pour sauter l'\u00e9tape de v\u00e9rification imm\u00e9diatement apr\u00e8s le flashage. Ensuite, apr\u00e8s le power-cycle manuel, vous pouvez r\u00e9-ex\u00e9cuter exactement la m\u00eame commande ./scripts/flash-sdcard.sh , mais ajouter l'option -c pour compl\u00e9ter l'op\u00e9ration de v\u00e9rification. Voir Flasher des cartes utilisant SDIO pour des exemples.","title":"Avertissements"},{"location":"SDCard_Updates.html#definitions-des-cartes","text":"La plupart des cartes courantes devraient \u00eatre disponibles, mais il est possible d'ajouter une nouvelle d\u00e9finition de carte si n\u00e9cessaire. Les d\u00e9finitions des cartes sont situ\u00e9es dans ~/klipper/scripts/spi_flash/board_defs.py . Les d\u00e9finitions sont stock\u00e9es dans un dictionnaire, par exemple : BOARD_DEFS = { 'generic-lpc1768' : { 'mcu' : \"lpc1768\" , 'spi_bus' : \"ssp1\" , \"cs_pin\" : \"P0.6\" }, ...< further definitions > } Les champs suivants peuvent \u00eatre pr\u00e9cis\u00e9s : mcu : Le type de mcu. On peut le retrouver apr\u00e8s avoir configur\u00e9 le build via make menuconfig en ex\u00e9cutant cat .config | grep CONFIG_MCU . Ce champ est obligatoire. spi_bus : Le bus SPI connect\u00e9 \u00e0 la carte SD. Ceci doit \u00eatre obtenu \u00e0 partir du sch\u00e9ma de la carte. Ce champ est obligatoire. cs_pin : La broche de s\u00e9lection de puce connect\u00e9e \u00e0 la carte SD. Ceci doit \u00eatre obtenu \u00e0 partir du sch\u00e9ma de la carte. Ce champ est obligatoire. firmware_path : Le chemin sur la carte SD o\u00f9 le firmware doit \u00eatre transf\u00e9r\u00e9. La valeur par d\u00e9faut est firmware.bin . current_firmware_path : Le chemin sur la carte SD o\u00f9 le fichier du firmware renomm\u00e9 est situ\u00e9 apr\u00e8s un flash r\u00e9ussi. La valeur par d\u00e9faut est firmware.cur . skip_verify : d\u00e9finit une valeur bool\u00e9enne indiquant aux scripts d'ignorer l'\u00e9tape de v\u00e9rification du firmware pendant le processus de flashage. La valeur par d\u00e9faut est False . Peut \u00eatre d\u00e9fini \u00e0 True pour les cartes n\u00e9cessitant un cycle d'alimentation manuel pour terminer le flashage. Pour v\u00e9rifier le firmware par la suite, ex\u00e9cutez \u00e0 nouveau le script avec l'option -c pour effectuer l'\u00e9tape de v\u00e9rification. Voir les avertissements avec les cartes SDIO Si le SPI logiciel est requis, le champ spi_bus doit \u00eatre r\u00e9gl\u00e9 sur swspi et le champ suppl\u00e9mentaire suivant doit \u00eatre sp\u00e9cifi\u00e9 : spi_pins : Ceci devrait \u00eatre 3 broches s\u00e9par\u00e9es par des virgules qui sont connect\u00e9es \u00e0 la carte SD dans le format de miso,mosi,sclk . Il devrait \u00eatre extr\u00eamement rare que le SPI logiciel soit n\u00e9cessaire, typiquement seules les cartes avec des erreurs de conception ou les cartes ne supportant que le mode SDIO pour leur carte SD en auront besoin. La d\u00e9finition de la carte btt-skr-pro fournit un exemple du premier cas, et la d\u00e9finition de la carte btt-octopus-f446-v1 fournit un exemple du second. Avant de cr\u00e9er une nouvelle d\u00e9finition de carte, il faut v\u00e9rifier si la d\u00e9finition d'une carte existante r\u00e9pond aux crit\u00e8res n\u00e9cessaires pour la nouvelle carte. Si c'est le cas, un BOARD_ALIAS peut \u00eatre utilis\u00e9. Par exemple, l'alias suivant peut \u00eatre ajout\u00e9 pour sp\u00e9cifier my-new-board comme alias de generic-lpc1768 : BOARD_ALIASES = { ...< previous aliases > , 'my-new-board' : BOARD_DEFS [ 'generic-lpc1768' ], } Si vous avez besoin d'une nouvelle d\u00e9finition de carte et que vous n'\u00eates pas \u00e0 l'aise avec la proc\u00e9dure d\u00e9crite ci-dessus, il est recommand\u00e9 d'en demander une sur le Discord de la communaut\u00e9 Klipper .","title":"D\u00e9finitions des cartes"},{"location":"SDCard_Updates.html#flashage-des-cartes-utilisant-sdio","text":"Comme mentionn\u00e9 dans les Caveats , les cartes dont le chargeur de d\u00e9marrage utilise le mode SDIO pour l'acc\u00e8s \u00e0 leur carte SD n\u00e9cessitent un power-cycle de la carte, et plus particuli\u00e8rement de la carte SD elle-m\u00eame, afin de passer du mode SPI utilis\u00e9 lors de l'\u00e9criture du fichier sur la carte SD au mode SDIO pour que le chargeur de d\u00e9marrage puisse le flasher sur la carte. Ces d\u00e9finitions de cartes utiliseront le drapeau skip_verify , qui indique \u00e0 l'outil de flashage de s'arr\u00eater apr\u00e8s l'\u00e9criture du firmware sur la carte SD afin que la carte puisse \u00eatre mise sous tension manuellement et que l'\u00e9tape de v\u00e9rification soit report\u00e9e jusqu'\u00e0 ce qu'elle soit termin\u00e9e. Il y a deux sc\u00e9narios : l'un avec l'h\u00f4te RPi fonctionnant sur une alimentation s\u00e9par\u00e9e et l'autre lorsque l'h\u00f4te RPi fonctionne sur la m\u00eame alimentation que la carte principale \u00e0 flasher. La diff\u00e9rence est de savoir s'il est n\u00e9cessaire ou non d'\u00e9teindre le RPi et ensuite ssh de nouveau apr\u00e8s que le flashage soit termin\u00e9 afin de faire l'\u00e9tape de v\u00e9rification, ou si la v\u00e9rification peut \u00eatre faite imm\u00e9diatement. Voici des exemples des deux sc\u00e9narios :","title":"Flashage des cartes utilisant SDIO"},{"location":"SDCard_Updates.html#programmation-sdio-avec-rpi-sur-alimentation-separee","text":"Une session typique avec le RPi sur une alimentation s\u00e9par\u00e9e ressemble \u00e0 ce qui suit. Vous devrez, bien s\u00fbr, utiliser le chemin du p\u00e9riph\u00e9rique et le nom de la carte : sudo service klipper stop cd ~/klipper git pull make clean make menuconfig make ./scripts/flash-sdcard.sh /dev/ttyACM0 btt-octopus-f446-v1 [[[\u00e9teindre-allumer manuellement la carte de l'imprimante quand vous y \u00eates invit\u00e9]]] ./scripts/flash-sdcard.sh -c /dev/ttyACM0 btt-octopus-f446-v1 sudo service klipper start","title":"Programmation SDIO avec RPi sur alimentation s\u00e9par\u00e9e"},{"location":"SDCard_Updates.html#programmation-sdio-avec-rpi-sur-la-meme-alimentation-electrique","text":"Une session typique avec le RPi sur la m\u00eame alimentation ressemble \u00e0 ce qui suit. Vous devrez, bien s\u00fbr, utiliser le chemin du p\u00e9riph\u00e9rique et le nom de la carte : sudo service klipper stop cd ~/klipper git pull make clean make menuconfig make ./scripts/flash-sdcard.sh /dev/ttyACM0 btt-octopus-f446-v1 sudo shutdown -h now [[[attendre que le RPi s'arr\u00eate, puis \u00e9teindre-allumer et ssh \u00e0 nouveau sur le RPi quand il a red\u00e9marr\u00e9]]] sudo service klipper stop cd ~/klipper ./scripts/flash-sdcard.sh -c /dev/ttyACM0 btt-octopus-f446-v1 sudo service klipper start Dans ce cas, puisque l'h\u00f4te RPi est en train d'\u00eatre red\u00e9marr\u00e9, ce qui va red\u00e9marrer le service klipper , il est n\u00e9cessaire d'arr\u00eater le service klipper avant de faire l'\u00e9tape de v\u00e9rification et de le red\u00e9marrer une fois la v\u00e9rification termin\u00e9e.","title":"Programmation SDIO avec RPi sur la m\u00eame alimentation \u00e9lectrique"},{"location":"SDCard_Updates.html#mappage-des-broches-sdio-vers-spi","text":"Si le sch\u00e9ma de votre carte utilise SDIO pour sa carte SD, vous pouvez mapper les broches comme d\u00e9crit dans le tableau ci-dessous pour d\u00e9terminer les broches SPI logicielles compatibles \u00e0 assigner dans le fichier board_defs.py : Broche de la carte SD Broche pour carte micro SD Nom de la broche SDIO Nom de la broche SPI 9 1 DATA2 None (PU)* 1 2 CD/DATA3 CS 2 3 CMD MOSI 4 4 +3.3V (VDD) +3.3V (VDD) 5 5 CLK SCLK 3 6 GND (VSS) GND (VSS) 7 7 DATA0 MISO 8 8 DATA1 None (PU)* N/A 9 Card Detect (CD) Card Detect (CD) 6 10 GND GND * None (PU) indique une broche inutilis\u00e9e avec une r\u00e9sistance de tirage haut","title":"Mappage des broches SDIO vers SPI"},{"location":"Skew_Correction.html","text":"Correction de l'\u00e9querrage \u00b6 La correction logicielle de l'\u00e9querrage peut aider \u00e0 r\u00e9soudre les inexactitudes dimensionnelles r\u00e9sultant d'un assemblage d'imprimante qui n'est pas parfaitement d'\u00e9querre. Notez que si votre imprimante est consid\u00e9rablement asym\u00e9trique, il est fortement recommand\u00e9 d'utiliser d'abord des moyens m\u00e9caniques pour obtenir une imprimante le plus d'\u00e9querre possible avant d'appliquer la correction bas\u00e9e sur le logiciel. Impression d'un objet de calibrage \u00b6 La premi\u00e8re \u00e9tape de la correction de l'\u00e9querrage consiste \u00e0 imprimer un objet d'\u00e9talonnage le long du plan que vous souhaitez corriger. Il existe \u00e9galement un objet d'\u00e9talonnage qui inclut tous les plans dans un seul mod\u00e8le. Veuillez \u00e0 orienter l'objet de sorte que le coin A soit vers l'origine du plan. Assurez-vous qu'aucune correction d'\u00e9querrage n'est appliqu\u00e9e pendant cette impression. Vous pouvez le faire en supprimant le module [skew_correction] du fichier printer.cfg ou en tapant un gcode SET_SKEW CLEAR=1 . Prenez vos mesures \u00b6 Le module [skew_correcton] n\u00e9cessite 3 mesures pour chaque plan que vous souhaitez corriger ; la longueur du coin A au coin C, la longueur du coin B au coin D et la longueur du coin A au coin D. Lors de la mesure de la longueur AD, n'incluez pas les plats sur les coins fournis par certains objets de test. Configurez votre \u00e9querrage \u00b6 Assurez-vous que [skew_correction] est bien dans le fichier printer.cfg. Vous pouvez maintenant utiliser le gcode SET_SKEW pour configurer skew_correcton. Par exemple, si vos longueurs mesur\u00e9es le long de XY sont les suivantes : Length AC = 140.4 Length BD = 142.8 Length AD = 99.8 SET_SKEW peut \u00eatre utilis\u00e9 pour configurer la correction d'\u00e9querrage pour le plan XY. SET_SKEW XY=140.4,142.8,99.8 Vous pouvez \u00e9galement ajouter des mesures pour XZ et YZ au gcode : SET_SKEW XY=140.4,142.8,99.8 XZ=141.6,141.4,99.8 YZ=142.4,140.5,99.5 Le module [skew_correction] prend \u00e9galement en charge la gestion des profils d'une mani\u00e8re similaire \u00e0 [bed_mesh] . Apr\u00e8s avoir d\u00e9fini la correction d'\u00e9querrage \u00e0 l'aide du gcode SET_SKEW , vous pouvez utiliser le gcode SKEW_PROFILE pour l'enregistrer : SKEW_PROFILE SAVE=my_skew_profile Apr\u00e8s cette commande, vous serez invit\u00e9 \u00e0 saisir un SAVE_CONFIG pour enregistrer le profil de mani\u00e8re permanente. Si aucun profil n'est nomm\u00e9 my_skew_profile alors un nouveau profil sera cr\u00e9\u00e9. Si le profil nomm\u00e9 existe, il sera \u00e9cras\u00e9. Une fois que vous avez un profil enregistr\u00e9, vous pouvez le charger : SKEW_PROFILE LOAD=my_skew_profile Il est \u00e9galement possible de supprimer un profil ancien ou obsol\u00e8te : SKEW_PROFILE REMOVE=my_skew_profile Apr\u00e8s avoir supprim\u00e9 un profil, vous serez invit\u00e9 \u00e0 saisir un SAVE_CONFIG pour que cette suppression soit sauvegard\u00e9e. V\u00e9rification de votre correction \u00b6 Une fois que skew_correction a \u00e9t\u00e9 configur\u00e9, vous pouvez r\u00e9imprimer l'objet de calibrage avec la correction activ\u00e9e. Utilisez le g-code suivant pour v\u00e9rifier votre \u00e9querrage sur chaque plan. Les r\u00e9sultats devraient \u00eatre inf\u00e9rieurs \u00e0 ceux rapport\u00e9s via GET_CURRENT_SKEW . CALC_MEASURED_SKEW AC=<ac_length> BD=<bd_length> AD=<ad_length> Avertissements \u00b6 En raison de la nature de la correction de l'\u00e9querrage, il est recommand\u00e9 de configurer la correction dans votre gcode de d\u00e9marrage, apr\u00e8s la mise \u00e0 l'origine et apr\u00e8s tout type de mouvement qui se d\u00e9place pr\u00e8s du bord de la zone d'impression, comme une purge ou un essuyage de buse. Vous pouvez utiliser les gcodes SET_SKEW ou SKEW_PROFILE pour le faire. Il est \u00e9galement recommand\u00e9 d'\u00e9mettre un SET_SKEW CLEAR=1 dans votre gcode final. Gardez \u00e0 l'esprit qu'il est possible que [skew_correction] g\u00e9n\u00e8re une correction qui d\u00e9place l'outil au-del\u00e0 des limites de l'imprimante sur les axes X et/ou Y. Il est recommand\u00e9 d'\u00e9loigner les pi\u00e8ces des bords lors de l'utilisation de [skew_correction] .","title":"Correction de l'\u00e9querrage"},{"location":"Skew_Correction.html#correction-de-lequerrage","text":"La correction logicielle de l'\u00e9querrage peut aider \u00e0 r\u00e9soudre les inexactitudes dimensionnelles r\u00e9sultant d'un assemblage d'imprimante qui n'est pas parfaitement d'\u00e9querre. Notez que si votre imprimante est consid\u00e9rablement asym\u00e9trique, il est fortement recommand\u00e9 d'utiliser d'abord des moyens m\u00e9caniques pour obtenir une imprimante le plus d'\u00e9querre possible avant d'appliquer la correction bas\u00e9e sur le logiciel.","title":"Correction de l'\u00e9querrage"},{"location":"Skew_Correction.html#impression-dun-objet-de-calibrage","text":"La premi\u00e8re \u00e9tape de la correction de l'\u00e9querrage consiste \u00e0 imprimer un objet d'\u00e9talonnage le long du plan que vous souhaitez corriger. Il existe \u00e9galement un objet d'\u00e9talonnage qui inclut tous les plans dans un seul mod\u00e8le. Veuillez \u00e0 orienter l'objet de sorte que le coin A soit vers l'origine du plan. Assurez-vous qu'aucune correction d'\u00e9querrage n'est appliqu\u00e9e pendant cette impression. Vous pouvez le faire en supprimant le module [skew_correction] du fichier printer.cfg ou en tapant un gcode SET_SKEW CLEAR=1 .","title":"Impression d'un objet de calibrage"},{"location":"Skew_Correction.html#prenez-vos-mesures","text":"Le module [skew_correcton] n\u00e9cessite 3 mesures pour chaque plan que vous souhaitez corriger ; la longueur du coin A au coin C, la longueur du coin B au coin D et la longueur du coin A au coin D. Lors de la mesure de la longueur AD, n'incluez pas les plats sur les coins fournis par certains objets de test.","title":"Prenez vos mesures"},{"location":"Skew_Correction.html#configurez-votre-equerrage","text":"Assurez-vous que [skew_correction] est bien dans le fichier printer.cfg. Vous pouvez maintenant utiliser le gcode SET_SKEW pour configurer skew_correcton. Par exemple, si vos longueurs mesur\u00e9es le long de XY sont les suivantes : Length AC = 140.4 Length BD = 142.8 Length AD = 99.8 SET_SKEW peut \u00eatre utilis\u00e9 pour configurer la correction d'\u00e9querrage pour le plan XY. SET_SKEW XY=140.4,142.8,99.8 Vous pouvez \u00e9galement ajouter des mesures pour XZ et YZ au gcode : SET_SKEW XY=140.4,142.8,99.8 XZ=141.6,141.4,99.8 YZ=142.4,140.5,99.5 Le module [skew_correction] prend \u00e9galement en charge la gestion des profils d'une mani\u00e8re similaire \u00e0 [bed_mesh] . Apr\u00e8s avoir d\u00e9fini la correction d'\u00e9querrage \u00e0 l'aide du gcode SET_SKEW , vous pouvez utiliser le gcode SKEW_PROFILE pour l'enregistrer : SKEW_PROFILE SAVE=my_skew_profile Apr\u00e8s cette commande, vous serez invit\u00e9 \u00e0 saisir un SAVE_CONFIG pour enregistrer le profil de mani\u00e8re permanente. Si aucun profil n'est nomm\u00e9 my_skew_profile alors un nouveau profil sera cr\u00e9\u00e9. Si le profil nomm\u00e9 existe, il sera \u00e9cras\u00e9. Une fois que vous avez un profil enregistr\u00e9, vous pouvez le charger : SKEW_PROFILE LOAD=my_skew_profile Il est \u00e9galement possible de supprimer un profil ancien ou obsol\u00e8te : SKEW_PROFILE REMOVE=my_skew_profile Apr\u00e8s avoir supprim\u00e9 un profil, vous serez invit\u00e9 \u00e0 saisir un SAVE_CONFIG pour que cette suppression soit sauvegard\u00e9e.","title":"Configurez votre \u00e9querrage"},{"location":"Skew_Correction.html#verification-de-votre-correction","text":"Une fois que skew_correction a \u00e9t\u00e9 configur\u00e9, vous pouvez r\u00e9imprimer l'objet de calibrage avec la correction activ\u00e9e. Utilisez le g-code suivant pour v\u00e9rifier votre \u00e9querrage sur chaque plan. Les r\u00e9sultats devraient \u00eatre inf\u00e9rieurs \u00e0 ceux rapport\u00e9s via GET_CURRENT_SKEW . CALC_MEASURED_SKEW AC=<ac_length> BD=<bd_length> AD=<ad_length>","title":"V\u00e9rification de votre correction"},{"location":"Skew_Correction.html#avertissements","text":"En raison de la nature de la correction de l'\u00e9querrage, il est recommand\u00e9 de configurer la correction dans votre gcode de d\u00e9marrage, apr\u00e8s la mise \u00e0 l'origine et apr\u00e8s tout type de mouvement qui se d\u00e9place pr\u00e8s du bord de la zone d'impression, comme une purge ou un essuyage de buse. Vous pouvez utiliser les gcodes SET_SKEW ou SKEW_PROFILE pour le faire. Il est \u00e9galement recommand\u00e9 d'\u00e9mettre un SET_SKEW CLEAR=1 dans votre gcode final. Gardez \u00e0 l'esprit qu'il est possible que [skew_correction] g\u00e9n\u00e8re une correction qui d\u00e9place l'outil au-del\u00e0 des limites de l'imprimante sur les axes X et/ou Y. Il est recommand\u00e9 d'\u00e9loigner les pi\u00e8ces des bords lors de l'utilisation de [skew_correction] .","title":"Avertissements"},{"location":"Slicers.html","text":"Slicers \u00b6 Ce document fournit certains conseils concernant la configuration d'une application \"Slicer\" pour une utilisation avec Klipper. Des slicers les plus courants utilis\u00e9s avec Klipper sont Sli3r, Cura, Simplify3D, etc. D\u00e9finissez le parfum g-code sur 'Marlin' \u00b6 De nombreux trancheurs ont une option pour configurer le \"Parfum G-Code\". La valeur par d\u00e9faut est souvent \"Marlin\" et cela fonctionne bien avec Klipper. La valeur \"Smoothieware\" fonctionne \u00e9galement bien avec Klipper. Les macros G-code de Klipper \u00b6 Les trancheurs permettent souvent de configurer les s\u00e9quences \"Start G-Code\" et \"End G-Code\". Il est souvent pratique de d\u00e9finir des macros personnalis\u00e9es dans le fichier de configuration de Klipper - telles que : [gcode_macro START_PRINT] et [gcode_macro END_PRINT] . Ensuite, on peut simplement indiquer START_PRINT et END_PRINT dans la configuration du slicer. La d\u00e9finition de ces actions dans la configuration de Klipper peut faciliter la modification des \u00e9tapes de d\u00e9but et de fin de l'imprimante, car les modifications ne n\u00e9cessitent pas de nouveau d\u00e9coupage. Voir sample-macros.cfg par exemple les macros START_PRINT et END_PRINT. Voir la r\u00e9f\u00e9rence de configuration pour plus de d\u00e9tails sur la d\u00e9finition de macros G-Code. Un r\u00e9glage de r\u00e9traction important peut n\u00e9cessiter un r\u00e9glage de Klipper \u00b6 La vitesse et l'acc\u00e9l\u00e9ration maximales des mouvements de r\u00e9traction sont contr\u00f4l\u00e9s dans Klipper par les param\u00e8tres de configuration max_extrude_only_velocity et max_extrude_only_accel . Ces param\u00e8tres ont une valeur par d\u00e9faut qui doit bien fonctionner sur de nombreuses imprimantes. Cependant, si l'on a configur\u00e9 une grande r\u00e9traction dans le trancheur (par exemple, 5 mm ou plus), on peut constater qu'ils limitent la vitesse de r\u00e9traction souhait\u00e9e. Si vous utilisez une grande distance r\u00e9traction, envisagez plut\u00f4t de r\u00e9gler le Pressure advance de Klipper. Dans la cas ou l'on trouve que la t\u00eate semble \"s'arr\u00eater\" pendant la r\u00e9traction et l'amor\u00e7age, d\u00e9finissez explicitement max_extrude_only_velocity et max_extrude_only_accel dans le fichier de configuration de Klipper. N'activez pas le mode \"roue libre\" \u00b6 Le mode \"roue libre\" est susceptible d'entra\u00eener des impressions de mauvaise qualit\u00e9 avec Klipper. Envisagez d'utiliser \u00e0 la place le pressure Advance de Klipper. Plus pr\u00e9cis\u00e9ment, si le slicer modifie consid\u00e9rablement le taux d'extrusion entre les mouvements, Klipper effectuera une d\u00e9c\u00e9l\u00e9ration et une acc\u00e9l\u00e9ration entre les mouvements. Cela risque d'aggraver les bavures, pas de les am\u00e9liorer. En revanche, il est possible (et souvent utile) d'utiliser le r\u00e9glage \u00ab r\u00e9tracter \u00bb, le r\u00e9glage \u00ab essuyer \u00bb et/ou le r\u00e9glage \u00ab essuyer lors de la r\u00e9tractation \u00bb d'un trancheur. Ne pas utiliser la \"distance de red\u00e9marrage suppl\u00e9mentaire\" sur Simplify3d \u00b6 Ce param\u00e8tre peut entra\u00eener de gros changements dans le taux d'extrusion, ce qui peut d\u00e9clencher la limite d'extrusion maximale de Klipper. Envisagez d'utiliser \u00e0 la place le pressure advance de Klipper (Pressure_Advance.md) ou le param\u00e8tre de r\u00e9tractation standard de Simplify3d. D\u00e9sactivez \"PreloadVE\" sur KISSlicer \u00b6 Si vous utilisez le trancheur KISSlicer, r\u00e9glez \"PreloadVE\" sur z\u00e9ro. Envisagez d'utiliser \u00e0 la place le Pressure Advance de Klipper. D\u00e9sactivez tous les param\u00e8tres de \"pression d'extrusion avanc\u00e9e\" \u00b6 Certains trancheurs pr\u00e9sentent une fonction de \"pression d'extrudeuse avanc\u00e9e\". Il est recommand\u00e9 de garder ces options d\u00e9sactiv\u00e9es lors de l'utilisation de Klipper car elles risquent d'entra\u00eener des impressions de mauvaise qualit\u00e9. Envisagez d'utiliser \u00e0 la place la Pressure Advance de Klipper. Ces param\u00e8tres de trancheur peuvent demander au micrologiciel d'apporter des modifications non contr\u00f4l\u00e9es au taux d'extrusion dans l'espoir que le micrologiciel se rapprochera de ces demandes et que l'imprimante obtiendra approximativement une pression d'extrudeuse souhaitable. Klipper, utilise des calculs cin\u00e9matiques et une synchronisation pr\u00e9cise. Lorsque Klipper re\u00e7oit l'ordre d'apporter des modifications importantes au taux d'extrusion, il planifiera les modifications correspondantes de la vitesse, de l'acc\u00e9l\u00e9ration et du mouvement de l'extrudeuse - ce qui n'est pas pr\u00e9vu par le trancheur. Le trancheur peut m\u00eame commander des taux d'extrusion excessifs au point de d\u00e9clencher la limite d'extrusion maximale de Klipper. En revanche, il est possible (et souvent utile) d'utiliser le r\u00e9glage \u00ab r\u00e9tracter \u00bb, le r\u00e9glage \u00ab essuyer \u00bb et/ou le r\u00e9glage \u00ab essuyer lors de la r\u00e9tractation \u00bb d'un trancheur.","title":"Slicers"},{"location":"Slicers.html#slicers","text":"Ce document fournit certains conseils concernant la configuration d'une application \"Slicer\" pour une utilisation avec Klipper. Des slicers les plus courants utilis\u00e9s avec Klipper sont Sli3r, Cura, Simplify3D, etc.","title":"Slicers"},{"location":"Slicers.html#definissez-le-parfum-g-code-sur-marlin","text":"De nombreux trancheurs ont une option pour configurer le \"Parfum G-Code\". La valeur par d\u00e9faut est souvent \"Marlin\" et cela fonctionne bien avec Klipper. La valeur \"Smoothieware\" fonctionne \u00e9galement bien avec Klipper.","title":"D\u00e9finissez le parfum g-code sur 'Marlin'"},{"location":"Slicers.html#les-macros-g-code-de-klipper","text":"Les trancheurs permettent souvent de configurer les s\u00e9quences \"Start G-Code\" et \"End G-Code\". Il est souvent pratique de d\u00e9finir des macros personnalis\u00e9es dans le fichier de configuration de Klipper - telles que : [gcode_macro START_PRINT] et [gcode_macro END_PRINT] . Ensuite, on peut simplement indiquer START_PRINT et END_PRINT dans la configuration du slicer. La d\u00e9finition de ces actions dans la configuration de Klipper peut faciliter la modification des \u00e9tapes de d\u00e9but et de fin de l'imprimante, car les modifications ne n\u00e9cessitent pas de nouveau d\u00e9coupage. Voir sample-macros.cfg par exemple les macros START_PRINT et END_PRINT. Voir la r\u00e9f\u00e9rence de configuration pour plus de d\u00e9tails sur la d\u00e9finition de macros G-Code.","title":"Les macros G-code de Klipper"},{"location":"Slicers.html#un-reglage-de-retraction-important-peut-necessiter-un-reglage-de-klipper","text":"La vitesse et l'acc\u00e9l\u00e9ration maximales des mouvements de r\u00e9traction sont contr\u00f4l\u00e9s dans Klipper par les param\u00e8tres de configuration max_extrude_only_velocity et max_extrude_only_accel . Ces param\u00e8tres ont une valeur par d\u00e9faut qui doit bien fonctionner sur de nombreuses imprimantes. Cependant, si l'on a configur\u00e9 une grande r\u00e9traction dans le trancheur (par exemple, 5 mm ou plus), on peut constater qu'ils limitent la vitesse de r\u00e9traction souhait\u00e9e. Si vous utilisez une grande distance r\u00e9traction, envisagez plut\u00f4t de r\u00e9gler le Pressure advance de Klipper. Dans la cas ou l'on trouve que la t\u00eate semble \"s'arr\u00eater\" pendant la r\u00e9traction et l'amor\u00e7age, d\u00e9finissez explicitement max_extrude_only_velocity et max_extrude_only_accel dans le fichier de configuration de Klipper.","title":"Un r\u00e9glage de r\u00e9traction important peut n\u00e9cessiter un r\u00e9glage de Klipper"},{"location":"Slicers.html#nactivez-pas-le-mode-roue-libre","text":"Le mode \"roue libre\" est susceptible d'entra\u00eener des impressions de mauvaise qualit\u00e9 avec Klipper. Envisagez d'utiliser \u00e0 la place le pressure Advance de Klipper. Plus pr\u00e9cis\u00e9ment, si le slicer modifie consid\u00e9rablement le taux d'extrusion entre les mouvements, Klipper effectuera une d\u00e9c\u00e9l\u00e9ration et une acc\u00e9l\u00e9ration entre les mouvements. Cela risque d'aggraver les bavures, pas de les am\u00e9liorer. En revanche, il est possible (et souvent utile) d'utiliser le r\u00e9glage \u00ab r\u00e9tracter \u00bb, le r\u00e9glage \u00ab essuyer \u00bb et/ou le r\u00e9glage \u00ab essuyer lors de la r\u00e9tractation \u00bb d'un trancheur.","title":"N'activez pas le mode \"roue libre\""},{"location":"Slicers.html#ne-pas-utiliser-la-distance-de-redemarrage-supplementaire-sur-simplify3d","text":"Ce param\u00e8tre peut entra\u00eener de gros changements dans le taux d'extrusion, ce qui peut d\u00e9clencher la limite d'extrusion maximale de Klipper. Envisagez d'utiliser \u00e0 la place le pressure advance de Klipper (Pressure_Advance.md) ou le param\u00e8tre de r\u00e9tractation standard de Simplify3d.","title":"Ne pas utiliser la \"distance de red\u00e9marrage suppl\u00e9mentaire\" sur Simplify3d"},{"location":"Slicers.html#desactivez-preloadve-sur-kisslicer","text":"Si vous utilisez le trancheur KISSlicer, r\u00e9glez \"PreloadVE\" sur z\u00e9ro. Envisagez d'utiliser \u00e0 la place le Pressure Advance de Klipper.","title":"D\u00e9sactivez \"PreloadVE\" sur KISSlicer"},{"location":"Slicers.html#desactivez-tous-les-parametres-de-pression-dextrusion-avancee","text":"Certains trancheurs pr\u00e9sentent une fonction de \"pression d'extrudeuse avanc\u00e9e\". Il est recommand\u00e9 de garder ces options d\u00e9sactiv\u00e9es lors de l'utilisation de Klipper car elles risquent d'entra\u00eener des impressions de mauvaise qualit\u00e9. Envisagez d'utiliser \u00e0 la place la Pressure Advance de Klipper. Ces param\u00e8tres de trancheur peuvent demander au micrologiciel d'apporter des modifications non contr\u00f4l\u00e9es au taux d'extrusion dans l'espoir que le micrologiciel se rapprochera de ces demandes et que l'imprimante obtiendra approximativement une pression d'extrudeuse souhaitable. Klipper, utilise des calculs cin\u00e9matiques et une synchronisation pr\u00e9cise. Lorsque Klipper re\u00e7oit l'ordre d'apporter des modifications importantes au taux d'extrusion, il planifiera les modifications correspondantes de la vitesse, de l'acc\u00e9l\u00e9ration et du mouvement de l'extrudeuse - ce qui n'est pas pr\u00e9vu par le trancheur. Le trancheur peut m\u00eame commander des taux d'extrusion excessifs au point de d\u00e9clencher la limite d'extrusion maximale de Klipper. En revanche, il est possible (et souvent utile) d'utiliser le r\u00e9glage \u00ab r\u00e9tracter \u00bb, le r\u00e9glage \u00ab essuyer \u00bb et/ou le r\u00e9glage \u00ab essuyer lors de la r\u00e9tractation \u00bb d'un trancheur.","title":"D\u00e9sactivez tous les param\u00e8tres de \"pression d'extrusion avanc\u00e9e\""},{"location":"Sponsors.html","text":"Sponsors \u00b6 Klipper est un logiciel libre. Nous d\u00e9pendons du g\u00e9n\u00e9reux soutien des sponsors. Merci de sponsoriser Klipper ou de soutenir nos sponsors. BIGTREETECH \u00b6 [ BIGTREETECH est le sponsor officiel de cartes m\u00e8res pour Klipper. BIGTREETECH s\u2019engage \u00e0 d\u00e9velopper des produits innovants et comp\u00e9titifs pour mieux servir la communaut\u00e9 de l\u2019impression 3D. Suivez-les sur Facebook ou Twitter . D\u00e9veloppeurs Klipper \u00b6 Kevin O'Connor \u00b6 Kevin est l'auteur original et le mainteneur actuel de Klipper. Faites un don sur : https://ko-fi.com/koconnor ou https://www.patreon.com/koconnor Eric Callahan \u00b6 Eric est l'auteur de bed_mesh, spi_flash et de plusieurs autres modules Klipper. Eric a une page de dons sur : https://ko-fi.com/arksine Projets Klipper associ\u00e9s \u00b6 Klipper est fr\u00e9quemment utilis\u00e9 avec d'autres logiciels libres. Pensez \u00e0 utiliser ou \u00e0 soutenir ces projets. Moonraker Mainsail Fluidd OctoPrint KlipperScreen","title":"Sponsors"},{"location":"Sponsors.html#sponsors","text":"Klipper est un logiciel libre. Nous d\u00e9pendons du g\u00e9n\u00e9reux soutien des sponsors. Merci de sponsoriser Klipper ou de soutenir nos sponsors.","title":"Sponsors"},{"location":"Sponsors.html#bigtreetech","text":"[ BIGTREETECH est le sponsor officiel de cartes m\u00e8res pour Klipper. BIGTREETECH s\u2019engage \u00e0 d\u00e9velopper des produits innovants et comp\u00e9titifs pour mieux servir la communaut\u00e9 de l\u2019impression 3D. Suivez-les sur Facebook ou Twitter .","title":"BIGTREETECH"},{"location":"Sponsors.html#developpeurs-klipper","text":"","title":"D\u00e9veloppeurs Klipper"},{"location":"Sponsors.html#kevin-oconnor","text":"Kevin est l'auteur original et le mainteneur actuel de Klipper. Faites un don sur : https://ko-fi.com/koconnor ou https://www.patreon.com/koconnor","title":"Kevin O'Connor"},{"location":"Sponsors.html#eric-callahan","text":"Eric est l'auteur de bed_mesh, spi_flash et de plusieurs autres modules Klipper. Eric a une page de dons sur : https://ko-fi.com/arksine","title":"Eric Callahan"},{"location":"Sponsors.html#projets-klipper-associes","text":"Klipper est fr\u00e9quemment utilis\u00e9 avec d'autres logiciels libres. Pensez \u00e0 utiliser ou \u00e0 soutenir ces projets. Moonraker Mainsail Fluidd OctoPrint KlipperScreen","title":"Projets Klipper associ\u00e9s"},{"location":"Status_Reference.html","text":"R\u00e9f\u00e9rence des \u00e9tats \u00b6 Ce document est une r\u00e9f\u00e9rence aux informations de status de l'imprimante dans Klipper macros , display fields , et via l' API Server . Les champs de ce document sont susceptibles d'\u00eatre modifi\u00e9s - si vous utilisez un attribut, veillez \u00e0 consulter le document Modifications des configurations lors de la mise \u00e0 jour du logiciel Klipper. angle \u00b6 Les informations suivantes sont disponibles dans les objets angle votre_nom : temperature : la derni\u00e8re lecture de temp\u00e9rature (en degr\u00e9s Celsius) d'un capteur \u00e0 effet Hall magn\u00e9tique de type tle5012b. Cette valeur n'est disponible que si le capteur d'angle est une puce tle5012b et si des mesures sont en cours (sinon il signale None ). bed_mesh \u00b6 Les informations suivantes sont disponibles dans l'objet cartographie du lit : profile_name , mesh_min , mesh_max , probed_matrix , mesh_matrix : informations sur la cartographie du lit actuellement active. profiles : l'ensemble des profils actuellement d\u00e9finis tels que configur\u00e9s \u00e0 l'aide de BED_MESH_PROFILE. bed_screws \u00b6 Les informations suivantes sont disponibles dans l'objet Config_Reference.md#bed_screws : is_active : Renvoie True si le script de r\u00e9glage des vis du lit est en cours. state : L'\u00e9tat du script de r\u00e9glage des vis du lit. deux \u00e9taIl s'agit de l'une des cha\u00eenes suivantes : \"adjust\", \"fine\". current_screw : le num\u00e9ro de la vis en cours de r\u00e9glage. accepted_screws : nombre de vis qui ont \u00e9t\u00e9 accept\u00e9es (ndt donc marqu\u00e9es comme r\u00e9gl\u00e9es). fichier de configuration \u00b6 Les informations suivantes sont disponibles dans l'objet configfile (cet objet est toujours disponible) : settings.<section>.<option> : Renvoie les param\u00e9trages du fichier de configuration (ou la valeur par d\u00e9faut) lors du dernier d\u00e9marrage ou red\u00e9marrage du logiciel. (Tout param\u00e8tre modifi\u00e9 au moment de l'ex\u00e9cution ne sera pas refl\u00e9t\u00e9 ici.) config.<section>.<option> : Renvoie le param\u00e8tre donn\u00e9 du fichier de configuration tel que lu par Klipper lors du dernier d\u00e9marrage ou red\u00e9marrage du logiciel. (Tout param\u00e8tre modifi\u00e9 au moment de l'ex\u00e9cution ne sera pas refl\u00e9t\u00e9 ici.) Toutes les valeurs sont renvoy\u00e9es sous forme de cha\u00eenes. save_config_pending : renvoie vrai s'il existe des mises \u00e0 jour en attente qu'une commande SAVE_CONFIG peut enregistrer sur le disque. save_config_pending_items : Contient les sections et les \u00e9l\u00e9ments qui ont \u00e9t\u00e9 modifi\u00e9es et qui peuvent \u00eatre sauvegard\u00e9es avec un SAVE_CONFIG . warnings : une liste d'avertissements concernant les options de configuration. Chaque entr\u00e9e de la liste sera un dictionnaire contenant un champ type et message (les deux cha\u00eenes). Des champs suppl\u00e9mentaires peuvent \u00eatre disponibles selon le type d'avertissement. display_status \u00b6 Les informations suivantes sont disponibles dans l\u2019objet display_status (cet objet est automatiquement disponible si une section de configuration affichage est d\u00e9finie) : progress : la valeur de progression de la derni\u00e8re commande G-Code M73 (ou virtual_sdcard.progress si aucune commande M73 r\u00e9cente n'a \u00e9t\u00e9 re\u00e7ue). message : Le message contenu dans la derni\u00e8re commande G-Code M117 . endstop_phase \u00b6 Les informations suivantes sont disponibles dans l'objet endstop_phase : last_home.<stepper name>.phase : La phase du moteur pas \u00e0 pas \u00e0 la fin de la derni\u00e8re tentative de retour \u00e0 l'origine. last_home.<stepper name>.phases : Le nombre total de phases disponibles sur le moteur pas \u00e0 pas. last_home.<stepper name>.mcu_position : La position (telle que suivie par le microcontr\u00f4leur) du moteur pas \u00e0 pas \u00e0 la fin de la derni\u00e8re tentative de retour \u00e0 l'origine. La position est le nombre total de pas effectu\u00e9s dans le sens avant moins le nombre total de pas effectu\u00e9s dans le sens inverse depuis le dernier red\u00e9marrage du microcontr\u00f4leur. exclude_object \u00b6 Les informations suivantes sont disponibles dans l'objet exclude_object : objects : Un tableau des objets connus tel que fourni par la commande EXCLUDE_OBJECT_DEFINE . Il s'agit des m\u00eames informations fournies par la commande EXCLUDE_OBJECT VERBOSE=1 . Les champs center et polygon ne seront pr\u00e9sents que s'ils sont fournis dans l'original EXCLUDE_OBJECT_DEFINE Voici un exemple JSON : [ { \"polygon\": [ [ 156.25, 146.2511675 ], [ 156.25, 153.7488325 ], [ 163.75, 153.7488325 ], [ 163.75, 146.2511675 ] ], \"name\": \"CYLINDER_2_STL_ID_2_COPY_0\", \"center\": [ 160, 150 ] }, { \"polygon\": [ [ 146.25, 146.2511675 ], [ 146.25, 153.7488325 ], [ 153.75, 153.7488325 ], [ 153.75, 146.2511675 ] ], \"name\": \"CYLINDER_2_STL_ID_1_COPY_0\", \"center\": [ 150, 150 ] } ] excluded_objects : un tableau de cha\u00eenes r\u00e9pertoriant les noms des objets exclus. current_object : Le nom de l'objet en cours d'impression. extruder_stepper \u00b6 Les informations suivantes sont disponibles pour les objets extruder_stepper (ainsi que les objets extruder ) : pressure_advance : la valeur actuelle de pressure advance . smooth_time : Le temps de lissage associ\u00e9 \u00e0 la valeur de \"pressure advance\" courante. ventilateur \u00b6 Les informations suivantes sont disponibles dans les objets fan , heater_fan nom_du_ventilateur et controller_fan nom_du_ventilateur : speed : La vitesse du ventilateur nombre r\u00e9el entre 0,0 et 1,0. rpm : La vitesse du ventilateur mesur\u00e9e en rotations par minute si le ventilateur a un tachometer_pin d\u00e9fini (ndt : et si le ventilateur poss\u00e8de un tachym\u00e8tre). filament_switch_sensor \u00b6 Les informations suivantes sont disponibles dans les objets filament_switch_sensor nom_du_d\u00e9tecteur : enabled : renvoie True si le d\u00e9tecteur de fin de filament est activ\u00e9. filament_detected : renvoie True si le d\u00e9tecteur de fin de filament a d\u00e9tect\u00e9 la pr\u00e9sence d'un filament. filament_motion_sensor \u00b6 Les informations suivantes sont disponibles dans les objets filament_motion_sensor nom_du_detecteur : enabled : renvoie True si le d\u00e9tecteur de mouvement du filament est activ\u00e9. filament_detected : renvoie True si le d\u00e9tecteur de fin de filament a d\u00e9tect\u00e9 la pr\u00e9sence d'un filament. firmware_retraction \u00b6 Les informations suivantes sont disponibles dans l'objet firmware_retraction : retract_length , retract_speed , unretract_extra_length , unretract_speed : sont les param\u00e8tres du module firmware_retraction. Ces param\u00e8tres peuvent diff\u00e9rer du fichier de configuration si une commande SET_RETRACTION les modifie. gcode_macro \u00b6 Les informations suivantes sont disponibles dans les objets gcode_macro nom_de_la_macro : <variable> : la valeur actuelle d'une variable gcode_macro . gcode_move \u00b6 Les informations suivantes sont disponibles dans l'objet gcode_move (cet objet est toujours disponible) : gcode_position : La position actuelle de la t\u00eate d'outil par rapport \u00e0 l'origine actuelle du G-Code. C'est-\u00e0-dire des positions que l'on pourrait envoyer directement \u00e0 une commande G1 . Il est possible d'acc\u00e9der aux composants x, y, z et e de cette position (par exemple, gcode_position.x ). position : la derni\u00e8re position command\u00e9e de la t\u00eate d'outil \u00e0 l'aide du syst\u00e8me de coordonn\u00e9es sp\u00e9cifi\u00e9 dans le fichier de configuration. Il est possible d'acc\u00e9der aux composantes x, y, z et e de cette position (par exemple, position.x ). homing_origin : L'origine du syst\u00e8me de coordonn\u00e9es gcode (par rapport au syst\u00e8me de coordonn\u00e9es sp\u00e9cifi\u00e9 dans le fichier de configuration) \u00e0 utiliser apr\u00e8s une commande G28 . La commande SET_GCODE_OFFSET peut modifier cette position. Il est possible d'acc\u00e9der aux composantes x, y et z de cette position (par exemple, homing_origin.x ). vitesse : La derni\u00e8re vitesse d\u00e9finie dans une commande G1 (en mm/s). speed_factor : Le \u00ab remplacement du facteur de vitesse \u00bb tel que d\u00e9fini par une commande M220 . Il s'agit d'une valeur \u00e0 virgule flottante. 1,0 signifie qu'il n'y a pas de d\u00e9passement et, par exemple, 2,0 double la vitesse demand\u00e9e. extrude_factor : le \"remplacement du facteur d'extrusion\" tel que d\u00e9fini par une commande M221 . Il s'agit d'une valeur \u00e0 virgule flottante. 1,0 signifie qu'il n'y a pas de remplacement et, par exemple, 2,0 double le volume d'extrusion demand\u00e9. absolute_coordinates : Cela renvoie True si l'on est en mode de coordonn\u00e9es absolues G90 ou False si l'on est en mode relatif G91 . absolute_extrude : Ceci renvoie True si l'on est en mode d'extrusion absolue M82 ou False si l'on est en mode relatif M83 . hall_filament_width_sensor \u00b6 Les informations suivantes sont disponibles dans l'objet hall_filament_width_sensor : is_active : renvoie True si le capteur est actif. Diameter : La derni\u00e8re lecture du capteur en mm. Raw : La derni\u00e8re lecture brute du convertisseur AN du capteur. heater \u00b6 Les informations suivantes sont disponibles pour les objets de type 'chauffage' tels que extruder , heater_bed et heater_generic : temperature : la derni\u00e8re temp\u00e9rature indiqu\u00e9e (en degr\u00e9s Celsius sous forme de nombre r\u00e9el) pour l'\u00e9l\u00e9ment chauffant donn\u00e9. target : la temp\u00e9rature cible actuelle (en degr\u00e9s Celsius sous forme de nombre r\u00e9el) pour l'\u00e9l\u00e9ment chauffant donn\u00e9. power : le dernier r\u00e9glage de la broche PWM (une valeur comprise entre 0,0 et 1,0) associ\u00e9e \u00e0 l'\u00e9l\u00e9ment chauffant. can_extrude : si l'extrudeuse est \u00e0 la temp\u00e9rature minimum de fonctionnement (d\u00e9fini par min_extrude_temp ), disponible uniquement pour extruder heaters \u00b6 Les informations suivantes sont disponibles dans l'objet heaters (cet objet est disponible si un \u00e9l\u00e9ment chauffant est d\u00e9fini) : available_heaters : renvoie une liste de tous les \u00e9l\u00e9ments chauffants disponibles par leurs noms de section de configuration complets, par ex. [\"extruder\", \"heater_bed\", \"heater_generic my_custom_heater\"] . available_sensors : renvoie une liste de tous les capteurs de temp\u00e9rature actuellement disponibles par leurs noms de section de configuration complets, par ex. [\"extruder\", \"heater_bed\", \"heater_generic my_custom_heater\", \"temperature_sensor electronics_temp\"] . idle_timeout \u00b6 Les informations suivantes sont disponibles dans l'objet idle_timeout (cet objet est toujours disponible) : state : L'\u00e9tat actuel de l'imprimante tel qu'il est suivi par le module idle_timeout. Il s'agit de l'une des cha\u00eenes suivantes : \"Idle\", \"Printing\", \"Ready\". printing_time : la dur\u00e9e (en secondes) pendant laquelle l'imprimante est rest\u00e9e dans l'\u00e9tat \"Impression\" (telle que suivie par le module idle_timeout). led \u00b6 Les informations suivantes sont disponibles pour chaque sections [led nom_des_leds] , [neopixel nom_des_leds] , [dotstar nom_des_leds] , [pca9533 nom_des_leds] et [pca9632 nom_des_leds] d\u00e9finies dans printer.cfg : color_data : une liste de listes de couleurs contenant les valeurs RGBW pour une led de la cha\u00eene. Chaque valeur est repr\u00e9sent\u00e9e par un r\u00e9el de 0,0 \u00e0 1,0. Chaque liste de couleurs contient 4 \u00e9l\u00e9ments (rouge, vert, bleu, blanc) m\u00eame si la LED sous-jacente prend en charge moins de canaux de couleur. Par exemple, la valeur bleue (3e \u00e9l\u00e9ment de la liste des couleurs) du deuxi\u00e8me neopixel d'une cha\u00eene peut \u00eatre consult\u00e9e sur printer[\"neopixel <config_name>\"].color_data[1][2] . manual_probe \u00b6 Les informations suivantes sont disponibles dans l'objet manual_probe : is_active : renvoie True si un script d'assistance de sondage manuel est actuellement actif. z_position : La hauteur actuelle de la buse (telle que l'imprimante la situe). z_position_lower : Valeur de la derni\u00e8re tentative de d\u00e9tection mesur\u00e9e juste en dessous de la hauteur actuelle. z_position_upper : Valeur de la derni\u00e8re tentative de d\u00e9tection mesur\u00e9e juste au dessus de la hauteur actuelle. mcu \u00b6 Les informations suivantes sont disponibles dans les objets mcu et mcu nom_du_mcu : mcu_version : la version du code Klipper remont\u00e9e par le microcontr\u00f4leur. mcu_build_versions : informations sur les outils de construction utilis\u00e9s pour g\u00e9n\u00e9rer le code du microcontr\u00f4leur (tel que remont\u00e9 par le microcontr\u00f4leur). mcu_constants.<constant_name> : Compile les constantes de temps rapport\u00e9es par le microcontr\u00f4leur. Les constantes disponibles peuvent diff\u00e9rer entre les architectures de microcontr\u00f4leur et \u00e0 chaque r\u00e9vision de code. last_stats.<statistics_name> : informations statistiques sur la connexion du microcontr\u00f4leur. motion_report \u00b6 Les informations suivantes sont disponibles dans l'objet motion_report (cet objet est automatiquement disponible si une section de configuration 'stepper' est d\u00e9finie) : live_position : la position de la t\u00eate d'outil demand\u00e9e interpol\u00e9e \u00e0 l'instant T. live_velocity : la vitesse de la t\u00eate d'outil demand\u00e9e (en mm/s) \u00e0 l'instant T. live_extruder_velocity : la vitesse d'extrusion demand\u00e9e (en mm/s) \u00e0 l'instant T. output_pin \u00b6 Les informations suivantes sont disponibles dans les objets output_pin nom_de_la_sortie : value : la \"valeur\" de la broche, telle que d\u00e9finie par une commande SET_PIN . palette2 \u00b6 Les informations suivantes sont disponibles dans l'objet palette2 : ping : montant du dernier ping du \"Palette 2\" signal\u00e9 en pourcentage. remaining_load_length : lors du d\u00e9marrage d'une impression Palette 2, ce sera la quantit\u00e9 de filament \u00e0 charger dans l'extrudeuse. is_splicing : Vrai lorsque la Palette 2 soude le filament. pause_resume \u00b6 Les informations suivantes sont disponibles dans l'objet pause_resume : is_paused : Renvoie true si une commande PAUSE a \u00e9t\u00e9 ex\u00e9cut\u00e9e sans RESUME correspondant. print_stats \u00b6 Les informations suivantes sont disponibles dans l'objet print_stats (cet objet est automatiquement disponible si une section de configuration virtual_sdcard est d\u00e9finie) : filename , total_duration , print_duration , filament_used , state , message : informations estim\u00e9es sur l'impression en cours lorsqu'une impression virtual_sdcard est active. info.total_layer : La valeur totale de la couche de la derni\u00e8re commande SET_PRINT_STATS_INFO TOTAL_LAYER=<value> G-Code. info.current_layer : la valeur de la couche actuelle de la derni\u00e8re commande G-Code SET_PRINT_STATS_INFO CURRENT_LAYER=<valeur> . probe \u00b6 Les informations suivantes sont disponibles dans l'objet probe (cet objet est \u00e9galement disponible si une section de configuration bltouch est d\u00e9finie) : last_query : renvoie True si la sonde a \u00e9t\u00e9 signal\u00e9e comme \"d\u00e9clench\u00e9e\" lors de la derni\u00e8re commande QUERY_PROBE. Notez que si cela est utilis\u00e9 dans une macro, en raison de l'ordre de d\u00e9veloppement du mod\u00e8le, la commande QUERY_PROBE doit \u00eatre ex\u00e9cut\u00e9e avant la macro contenant cette demande. last_z_result : Renvoie la valeur du Z de la derni\u00e8re commande PROBE. Notez que si cela est utilis\u00e9 dans une macro, en raison de l'ordre d'expansion du mod\u00e8le, la commande PROBE (ou similaire) doit \u00eatre ex\u00e9cut\u00e9e avant la macro contenant cette demande. quad_gantry_level \u00b6 Les informations suivantes sont disponibles dans l'objet quad_gantry_level (cet objet est disponible si quad_gantry_level est d\u00e9fini) : applied : Vrai si le processus de nivellement 4 points du portique a \u00e9t\u00e9 ex\u00e9cut\u00e9 et termin\u00e9 avec succ\u00e8s. query_endstops \u00b6 Les informations suivantes sont disponibles dans l'objet query_endstops (cet objet est disponible si au moins une fin de course est d\u00e9finie) : last_query[\"<endstop>\"] : renvoie True si l'endstop donn\u00e9 a \u00e9t\u00e9 signal\u00e9 comme \"d\u00e9clench\u00e9\" (triggered) lors de la derni\u00e8re commande QUERY_ENDSTOP. Notez que si cela est utilis\u00e9 dans une macro, en raison de l'ordre de d\u00e9veloppement du mod\u00e8le, la commande QUERY_ENDSTOP doit \u00eatre ex\u00e9cut\u00e9e avant la macro contenant cette demande. screws_tilt_adjust \u00b6 Les informations suivantes sont disponibles dans l'objet screws_tilt_adjust : error : renvoie True si la commande SCREWS_TILT_CALCULATE la plus r\u00e9cente incluait le param\u00e8tre MAX_DEVIATION et que l'un des sondages au niveau des vis de lit d\u00e9passait la valeur MAX_DEVIATION . r\u00e9sultats : une liste des emplacements des vis de lit sond\u00e9es. Chaque entr\u00e9e de la liste est un dictionnaire contenant les cl\u00e9s suivantes : name : le nom de la vis tel qu'il est sp\u00e9cifi\u00e9 dans le fichier de configuration. x : la coordonn\u00e9e X de la vis telle que sp\u00e9cifi\u00e9e dans le fichier de configuration. y : la coordonn\u00e9e Y de la vis telle que sp\u00e9cifi\u00e9e dans le fichier de configuration. z : La hauteur Z mesur\u00e9e \u00e0 l'emplacement de la vis. sign : Une cha\u00eene sp\u00e9cifiant le sens de rotation \u00e0 visser pour le r\u00e9glage n\u00e9cessaire. Soit \"CW\" pour le sens horaire ou \"CCW\" pour le sens antihoraire. La vis de base n'aura pas de cl\u00e9 sign . adjust : le nombre de tours de vis pour ajuster la vis, donn\u00e9 au format \"HH:MM\", o\u00f9 \"HH\" est le nombre de tours de vis complets et \"MM\" est le nombre de \"minutes d'un cadran d'horloge\" repr\u00e9sentant un tour de vis partiel. (Par exemple, \"01:15\" signifierait de tourner la vis d'un tour et quart.) servo \u00b6 Les informations suivantes sont disponibles dans les objets servo some_name : printer[\"servo <config_name>\"].value : le dernier r\u00e9glage de la broche PWM (une valeur comprise entre 0,0 et 1,0) associ\u00e9e au servo. system_stats \u00b6 Les informations suivantes sont disponibles dans l'objet system_stats (cet objet est toujours disponible) : sysload , cputime , memavail : informations sur le syst\u00e8me d'exploitation h\u00f4te et la charge du processus. Capteurs de temp\u00e9rature \u00b6 Les informations suivantes sont disponibles dans objets BME280 nom_du_capteur , htu21d nom_du_capteur , lm75 nom_du_capteur et temperature_host nom_du_capteur : temperature : La derni\u00e8re temp\u00e9rature lue par le capteur. humidit\u00e9 , pression , gaz : les derni\u00e8res valeurs lues par le capteur (uniquement sur les capteurs bme280, htu21d et lm75). temperature_fan \u00b6 Les informations suivantes sont disponibles dans les objets temperature_fan nom_du_ventilateur : temperature : La derni\u00e8re temp\u00e9rature lue par le capteur. target : La temp\u00e9rature cible pour le ventilateur. temperature_sensor \u00b6 Les informations suivantes sont disponibles dans les objets temperature_sensor nom_du_capteur : temperature : La derni\u00e8re temp\u00e9rature lue par le capteur. measured_min_temp , measured_max_temp : la temp\u00e9rature la plus basse et la plus \u00e9lev\u00e9e observ\u00e9es par le capteur depuis le dernier red\u00e9marrage de Klipper. Pilotes TMC \u00b6 Les informations suivantes sont disponibles dans les objets pilote pas \u00e0 pas TMC (par exemple, [tmc2208 stepper_x] ) : mcu_phase_offset : la position du moteur pas \u00e0 pas du microcontr\u00f4leur correspondant \u00e0 la phase \"z\u00e9ro\" du pilote. Ce champ peut \u00eatre nul si le d\u00e9phasage n'est pas connu. phase_offset_position : La \"position command\u00e9e\" correspondant \u00e0 la phase \"z\u00e9ro\" du driver. Ce champ peut \u00eatre nul si le d\u00e9phasage n'est pas connu. drv_status : les r\u00e9sultats de la derni\u00e8re requ\u00eate d'\u00e9tat du pilote. (Seuls les champs non nuls sont signal\u00e9s.) Ce champ sera nul si le pilote n'est pas activ\u00e9 (et n'est donc pas interrog\u00e9 p\u00e9riodiquement). run_current : le courant de fonctionnement actuellement d\u00e9fini. hold_current : Le courant de maintien actuellement d\u00e9fini. toolhead \u00b6 Les informations suivantes sont disponibles dans l'objet toolhead (cet objet est toujours disponible) : position : la derni\u00e8re position command\u00e9e de la t\u00eate d'outil par rapport au syst\u00e8me de coordonn\u00e9es sp\u00e9cifi\u00e9 dans le fichier de configuration. Il est possible d'acc\u00e9der aux composantes x, y, z et e de cette position (par exemple, position.x ). extruder : le nom de l'extrudeur actuellement actif. Par exemple, dans une macro, on pourrait utiliser printer[printer.toolhead.extruder].target pour obtenir la temp\u00e9rature cible de l'extrudeuse actuelle. homed_axes : les axes consid\u00e9r\u00e9s comme \u00e9tant dans un \u00e9tat \"\u00e0 l'origine\". Il s'agit d'une cha\u00eene contenant un ou plusieurs \"x\", \"y\", \"z\". axis_minimum , axis_maximum : les limites de d\u00e9placement de l'axe (mm) apr\u00e8s la mise \u00e0 l'origine. Il est possible d'acc\u00e9der aux composantes x, y, z de cette valeur limite (par exemple, axis_minimum.x , axis_maximum.z ). Pour les imprimantes Delta, le cone_start_z est la hauteur z maximale au rayon maximal ( printer.toolhead.cone_start_z ). max_velocity , max_accel , max_accel_to_decel , square_corner_velocity : les limites d'impression actuelles en vigueur. Cela peut diff\u00e9rer des param\u00e8tres du fichier de configuration si une commande SET_VELOCITY_LIMIT (ou M204 ) les a modifi\u00e9es au moment de l'ex\u00e9cution. stalls : Le nombre total de fois (depuis le dernier red\u00e9marrage) o\u00f9 l'imprimante a d\u00fb \u00eatre mise en pause parce que la t\u00eate d'outil s'est d\u00e9plac\u00e9e plus vite que les mouvements ne pouvaient \u00eatre lus \u00e0 partir de l'entr\u00e9e G-Code. dual_carriage \u00b6 Les informations suivantes sont disponibles dans dual_carriage sur une imprimante de type hybrid_corexy ou hybrid_corexz mode : Le mode actuel. Les valeurs possibles sont : \"FULL_CONTROL\" active_carriage : le chariot actif actuel. Les valeurs possibles sont : \"CARRIAGE_0\", \"CARRIAGE_1\" virtual_sdcard \u00b6 Les informations suivantes sont disponibles dans l'objet virtual_sdcard : is_active : renvoie True si une impression \u00e0 partir d'un fichier est actuellement active. progress : une estimation de la progression de l'impression actuelle (bas\u00e9e sur la taille et la position du fichier). file_path : un chemin d'acc\u00e8s complet au fichier actuellement charg\u00e9. file_position : la position actuelle (en octets) d'une impression active. file_size : taille (en octets) du fichier actuellement charg\u00e9. webhooks \u00b6 Les informations suivantes sont disponibles dans l'objet webhooks (cet objet est toujours disponible) : state : renvoie une cha\u00eene indiquant l'\u00e9tat actuel de Klipper. Les valeurs possibles sont : \"ready\", \"startup\", \"shutdown\", \"error\". state_message : une cha\u00eene donnant un contexte suppl\u00e9mentaire sur l'\u00e9tat actuel de Klipper. z_thermal_adjust \u00b6 Les informations suivantes sont disponibles dans l'objet z_thermal_adjust (cet objet est disponible si z_thermal_adjust est d\u00e9fini). enabled : renvoie True si le r\u00e9glage est activ\u00e9. temp\u00e9rature : Temp\u00e9rature actuelle (liss\u00e9e) du capteur d\u00e9fini. (en degr\u00e9s Centigrades) measured_min_temp : temp\u00e9rature minimale mesur\u00e9e. (en degr\u00e9s Centigrades) measured_max_temp : temp\u00e9rature maximale mesur\u00e9e. (En degr\u00e9s Centigrades) current_z_adjust : dernier ajustement Z calcul\u00e9 (en mm). z_adjust_ref_temperature : Temp\u00e9rature de r\u00e9f\u00e9rence actuelle utilis\u00e9e pour le calcul de Z current_z_adjust (En degr\u00e9s Centigrades). z_tilt \u00b6 Les informations suivantes sont disponibles dans l'objet z_tilt (cet objet est disponible si z_tilt est d\u00e9fini) : applied : Vrai si le processus de mise \u00e0 niveau z-tilt a \u00e9t\u00e9 ex\u00e9cut\u00e9 et termin\u00e9 avec succ\u00e8s.","title":"R\u00e9f\u00e9rence des \u00e9tats"},{"location":"Status_Reference.html#reference-des-etats","text":"Ce document est une r\u00e9f\u00e9rence aux informations de status de l'imprimante dans Klipper macros , display fields , et via l' API Server . Les champs de ce document sont susceptibles d'\u00eatre modifi\u00e9s - si vous utilisez un attribut, veillez \u00e0 consulter le document Modifications des configurations lors de la mise \u00e0 jour du logiciel Klipper.","title":"R\u00e9f\u00e9rence des \u00e9tats"},{"location":"Status_Reference.html#angle","text":"Les informations suivantes sont disponibles dans les objets angle votre_nom : temperature : la derni\u00e8re lecture de temp\u00e9rature (en degr\u00e9s Celsius) d'un capteur \u00e0 effet Hall magn\u00e9tique de type tle5012b. Cette valeur n'est disponible que si le capteur d'angle est une puce tle5012b et si des mesures sont en cours (sinon il signale None ).","title":"angle"},{"location":"Status_Reference.html#bed_mesh","text":"Les informations suivantes sont disponibles dans l'objet cartographie du lit : profile_name , mesh_min , mesh_max , probed_matrix , mesh_matrix : informations sur la cartographie du lit actuellement active. profiles : l'ensemble des profils actuellement d\u00e9finis tels que configur\u00e9s \u00e0 l'aide de BED_MESH_PROFILE.","title":"bed_mesh"},{"location":"Status_Reference.html#bed_screws","text":"Les informations suivantes sont disponibles dans l'objet Config_Reference.md#bed_screws : is_active : Renvoie True si le script de r\u00e9glage des vis du lit est en cours. state : L'\u00e9tat du script de r\u00e9glage des vis du lit. deux \u00e9taIl s'agit de l'une des cha\u00eenes suivantes : \"adjust\", \"fine\". current_screw : le num\u00e9ro de la vis en cours de r\u00e9glage. accepted_screws : nombre de vis qui ont \u00e9t\u00e9 accept\u00e9es (ndt donc marqu\u00e9es comme r\u00e9gl\u00e9es).","title":"bed_screws"},{"location":"Status_Reference.html#fichier-de-configuration","text":"Les informations suivantes sont disponibles dans l'objet configfile (cet objet est toujours disponible) : settings.<section>.<option> : Renvoie les param\u00e9trages du fichier de configuration (ou la valeur par d\u00e9faut) lors du dernier d\u00e9marrage ou red\u00e9marrage du logiciel. (Tout param\u00e8tre modifi\u00e9 au moment de l'ex\u00e9cution ne sera pas refl\u00e9t\u00e9 ici.) config.<section>.<option> : Renvoie le param\u00e8tre donn\u00e9 du fichier de configuration tel que lu par Klipper lors du dernier d\u00e9marrage ou red\u00e9marrage du logiciel. (Tout param\u00e8tre modifi\u00e9 au moment de l'ex\u00e9cution ne sera pas refl\u00e9t\u00e9 ici.) Toutes les valeurs sont renvoy\u00e9es sous forme de cha\u00eenes. save_config_pending : renvoie vrai s'il existe des mises \u00e0 jour en attente qu'une commande SAVE_CONFIG peut enregistrer sur le disque. save_config_pending_items : Contient les sections et les \u00e9l\u00e9ments qui ont \u00e9t\u00e9 modifi\u00e9es et qui peuvent \u00eatre sauvegard\u00e9es avec un SAVE_CONFIG . warnings : une liste d'avertissements concernant les options de configuration. Chaque entr\u00e9e de la liste sera un dictionnaire contenant un champ type et message (les deux cha\u00eenes). Des champs suppl\u00e9mentaires peuvent \u00eatre disponibles selon le type d'avertissement.","title":"fichier de configuration"},{"location":"Status_Reference.html#display_status","text":"Les informations suivantes sont disponibles dans l\u2019objet display_status (cet objet est automatiquement disponible si une section de configuration affichage est d\u00e9finie) : progress : la valeur de progression de la derni\u00e8re commande G-Code M73 (ou virtual_sdcard.progress si aucune commande M73 r\u00e9cente n'a \u00e9t\u00e9 re\u00e7ue). message : Le message contenu dans la derni\u00e8re commande G-Code M117 .","title":"display_status"},{"location":"Status_Reference.html#endstop_phase","text":"Les informations suivantes sont disponibles dans l'objet endstop_phase : last_home.<stepper name>.phase : La phase du moteur pas \u00e0 pas \u00e0 la fin de la derni\u00e8re tentative de retour \u00e0 l'origine. last_home.<stepper name>.phases : Le nombre total de phases disponibles sur le moteur pas \u00e0 pas. last_home.<stepper name>.mcu_position : La position (telle que suivie par le microcontr\u00f4leur) du moteur pas \u00e0 pas \u00e0 la fin de la derni\u00e8re tentative de retour \u00e0 l'origine. La position est le nombre total de pas effectu\u00e9s dans le sens avant moins le nombre total de pas effectu\u00e9s dans le sens inverse depuis le dernier red\u00e9marrage du microcontr\u00f4leur.","title":"endstop_phase"},{"location":"Status_Reference.html#exclude_object","text":"Les informations suivantes sont disponibles dans l'objet exclude_object : objects : Un tableau des objets connus tel que fourni par la commande EXCLUDE_OBJECT_DEFINE . Il s'agit des m\u00eames informations fournies par la commande EXCLUDE_OBJECT VERBOSE=1 . Les champs center et polygon ne seront pr\u00e9sents que s'ils sont fournis dans l'original EXCLUDE_OBJECT_DEFINE Voici un exemple JSON : [ { \"polygon\": [ [ 156.25, 146.2511675 ], [ 156.25, 153.7488325 ], [ 163.75, 153.7488325 ], [ 163.75, 146.2511675 ] ], \"name\": \"CYLINDER_2_STL_ID_2_COPY_0\", \"center\": [ 160, 150 ] }, { \"polygon\": [ [ 146.25, 146.2511675 ], [ 146.25, 153.7488325 ], [ 153.75, 153.7488325 ], [ 153.75, 146.2511675 ] ], \"name\": \"CYLINDER_2_STL_ID_1_COPY_0\", \"center\": [ 150, 150 ] } ] excluded_objects : un tableau de cha\u00eenes r\u00e9pertoriant les noms des objets exclus. current_object : Le nom de l'objet en cours d'impression.","title":"exclude_object"},{"location":"Status_Reference.html#extruder_stepper","text":"Les informations suivantes sont disponibles pour les objets extruder_stepper (ainsi que les objets extruder ) : pressure_advance : la valeur actuelle de pressure advance . smooth_time : Le temps de lissage associ\u00e9 \u00e0 la valeur de \"pressure advance\" courante.","title":"extruder_stepper"},{"location":"Status_Reference.html#ventilateur","text":"Les informations suivantes sont disponibles dans les objets fan , heater_fan nom_du_ventilateur et controller_fan nom_du_ventilateur : speed : La vitesse du ventilateur nombre r\u00e9el entre 0,0 et 1,0. rpm : La vitesse du ventilateur mesur\u00e9e en rotations par minute si le ventilateur a un tachometer_pin d\u00e9fini (ndt : et si le ventilateur poss\u00e8de un tachym\u00e8tre).","title":"ventilateur"},{"location":"Status_Reference.html#filament_switch_sensor","text":"Les informations suivantes sont disponibles dans les objets filament_switch_sensor nom_du_d\u00e9tecteur : enabled : renvoie True si le d\u00e9tecteur de fin de filament est activ\u00e9. filament_detected : renvoie True si le d\u00e9tecteur de fin de filament a d\u00e9tect\u00e9 la pr\u00e9sence d'un filament.","title":"filament_switch_sensor"},{"location":"Status_Reference.html#filament_motion_sensor","text":"Les informations suivantes sont disponibles dans les objets filament_motion_sensor nom_du_detecteur : enabled : renvoie True si le d\u00e9tecteur de mouvement du filament est activ\u00e9. filament_detected : renvoie True si le d\u00e9tecteur de fin de filament a d\u00e9tect\u00e9 la pr\u00e9sence d'un filament.","title":"filament_motion_sensor"},{"location":"Status_Reference.html#firmware_retraction","text":"Les informations suivantes sont disponibles dans l'objet firmware_retraction : retract_length , retract_speed , unretract_extra_length , unretract_speed : sont les param\u00e8tres du module firmware_retraction. Ces param\u00e8tres peuvent diff\u00e9rer du fichier de configuration si une commande SET_RETRACTION les modifie.","title":"firmware_retraction"},{"location":"Status_Reference.html#gcode_macro","text":"Les informations suivantes sont disponibles dans les objets gcode_macro nom_de_la_macro : <variable> : la valeur actuelle d'une variable gcode_macro .","title":"gcode_macro"},{"location":"Status_Reference.html#gcode_move","text":"Les informations suivantes sont disponibles dans l'objet gcode_move (cet objet est toujours disponible) : gcode_position : La position actuelle de la t\u00eate d'outil par rapport \u00e0 l'origine actuelle du G-Code. C'est-\u00e0-dire des positions que l'on pourrait envoyer directement \u00e0 une commande G1 . Il est possible d'acc\u00e9der aux composants x, y, z et e de cette position (par exemple, gcode_position.x ). position : la derni\u00e8re position command\u00e9e de la t\u00eate d'outil \u00e0 l'aide du syst\u00e8me de coordonn\u00e9es sp\u00e9cifi\u00e9 dans le fichier de configuration. Il est possible d'acc\u00e9der aux composantes x, y, z et e de cette position (par exemple, position.x ). homing_origin : L'origine du syst\u00e8me de coordonn\u00e9es gcode (par rapport au syst\u00e8me de coordonn\u00e9es sp\u00e9cifi\u00e9 dans le fichier de configuration) \u00e0 utiliser apr\u00e8s une commande G28 . La commande SET_GCODE_OFFSET peut modifier cette position. Il est possible d'acc\u00e9der aux composantes x, y et z de cette position (par exemple, homing_origin.x ). vitesse : La derni\u00e8re vitesse d\u00e9finie dans une commande G1 (en mm/s). speed_factor : Le \u00ab remplacement du facteur de vitesse \u00bb tel que d\u00e9fini par une commande M220 . Il s'agit d'une valeur \u00e0 virgule flottante. 1,0 signifie qu'il n'y a pas de d\u00e9passement et, par exemple, 2,0 double la vitesse demand\u00e9e. extrude_factor : le \"remplacement du facteur d'extrusion\" tel que d\u00e9fini par une commande M221 . Il s'agit d'une valeur \u00e0 virgule flottante. 1,0 signifie qu'il n'y a pas de remplacement et, par exemple, 2,0 double le volume d'extrusion demand\u00e9. absolute_coordinates : Cela renvoie True si l'on est en mode de coordonn\u00e9es absolues G90 ou False si l'on est en mode relatif G91 . absolute_extrude : Ceci renvoie True si l'on est en mode d'extrusion absolue M82 ou False si l'on est en mode relatif M83 .","title":"gcode_move"},{"location":"Status_Reference.html#hall_filament_width_sensor","text":"Les informations suivantes sont disponibles dans l'objet hall_filament_width_sensor : is_active : renvoie True si le capteur est actif. Diameter : La derni\u00e8re lecture du capteur en mm. Raw : La derni\u00e8re lecture brute du convertisseur AN du capteur.","title":"hall_filament_width_sensor"},{"location":"Status_Reference.html#heater","text":"Les informations suivantes sont disponibles pour les objets de type 'chauffage' tels que extruder , heater_bed et heater_generic : temperature : la derni\u00e8re temp\u00e9rature indiqu\u00e9e (en degr\u00e9s Celsius sous forme de nombre r\u00e9el) pour l'\u00e9l\u00e9ment chauffant donn\u00e9. target : la temp\u00e9rature cible actuelle (en degr\u00e9s Celsius sous forme de nombre r\u00e9el) pour l'\u00e9l\u00e9ment chauffant donn\u00e9. power : le dernier r\u00e9glage de la broche PWM (une valeur comprise entre 0,0 et 1,0) associ\u00e9e \u00e0 l'\u00e9l\u00e9ment chauffant. can_extrude : si l'extrudeuse est \u00e0 la temp\u00e9rature minimum de fonctionnement (d\u00e9fini par min_extrude_temp ), disponible uniquement pour extruder","title":"heater"},{"location":"Status_Reference.html#heaters","text":"Les informations suivantes sont disponibles dans l'objet heaters (cet objet est disponible si un \u00e9l\u00e9ment chauffant est d\u00e9fini) : available_heaters : renvoie une liste de tous les \u00e9l\u00e9ments chauffants disponibles par leurs noms de section de configuration complets, par ex. [\"extruder\", \"heater_bed\", \"heater_generic my_custom_heater\"] . available_sensors : renvoie une liste de tous les capteurs de temp\u00e9rature actuellement disponibles par leurs noms de section de configuration complets, par ex. [\"extruder\", \"heater_bed\", \"heater_generic my_custom_heater\", \"temperature_sensor electronics_temp\"] .","title":"heaters"},{"location":"Status_Reference.html#idle_timeout","text":"Les informations suivantes sont disponibles dans l'objet idle_timeout (cet objet est toujours disponible) : state : L'\u00e9tat actuel de l'imprimante tel qu'il est suivi par le module idle_timeout. Il s'agit de l'une des cha\u00eenes suivantes : \"Idle\", \"Printing\", \"Ready\". printing_time : la dur\u00e9e (en secondes) pendant laquelle l'imprimante est rest\u00e9e dans l'\u00e9tat \"Impression\" (telle que suivie par le module idle_timeout).","title":"idle_timeout"},{"location":"Status_Reference.html#led","text":"Les informations suivantes sont disponibles pour chaque sections [led nom_des_leds] , [neopixel nom_des_leds] , [dotstar nom_des_leds] , [pca9533 nom_des_leds] et [pca9632 nom_des_leds] d\u00e9finies dans printer.cfg : color_data : une liste de listes de couleurs contenant les valeurs RGBW pour une led de la cha\u00eene. Chaque valeur est repr\u00e9sent\u00e9e par un r\u00e9el de 0,0 \u00e0 1,0. Chaque liste de couleurs contient 4 \u00e9l\u00e9ments (rouge, vert, bleu, blanc) m\u00eame si la LED sous-jacente prend en charge moins de canaux de couleur. Par exemple, la valeur bleue (3e \u00e9l\u00e9ment de la liste des couleurs) du deuxi\u00e8me neopixel d'une cha\u00eene peut \u00eatre consult\u00e9e sur printer[\"neopixel <config_name>\"].color_data[1][2] .","title":"led"},{"location":"Status_Reference.html#manual_probe","text":"Les informations suivantes sont disponibles dans l'objet manual_probe : is_active : renvoie True si un script d'assistance de sondage manuel est actuellement actif. z_position : La hauteur actuelle de la buse (telle que l'imprimante la situe). z_position_lower : Valeur de la derni\u00e8re tentative de d\u00e9tection mesur\u00e9e juste en dessous de la hauteur actuelle. z_position_upper : Valeur de la derni\u00e8re tentative de d\u00e9tection mesur\u00e9e juste au dessus de la hauteur actuelle.","title":"manual_probe"},{"location":"Status_Reference.html#mcu","text":"Les informations suivantes sont disponibles dans les objets mcu et mcu nom_du_mcu : mcu_version : la version du code Klipper remont\u00e9e par le microcontr\u00f4leur. mcu_build_versions : informations sur les outils de construction utilis\u00e9s pour g\u00e9n\u00e9rer le code du microcontr\u00f4leur (tel que remont\u00e9 par le microcontr\u00f4leur). mcu_constants.<constant_name> : Compile les constantes de temps rapport\u00e9es par le microcontr\u00f4leur. Les constantes disponibles peuvent diff\u00e9rer entre les architectures de microcontr\u00f4leur et \u00e0 chaque r\u00e9vision de code. last_stats.<statistics_name> : informations statistiques sur la connexion du microcontr\u00f4leur.","title":"mcu"},{"location":"Status_Reference.html#motion_report","text":"Les informations suivantes sont disponibles dans l'objet motion_report (cet objet est automatiquement disponible si une section de configuration 'stepper' est d\u00e9finie) : live_position : la position de la t\u00eate d'outil demand\u00e9e interpol\u00e9e \u00e0 l'instant T. live_velocity : la vitesse de la t\u00eate d'outil demand\u00e9e (en mm/s) \u00e0 l'instant T. live_extruder_velocity : la vitesse d'extrusion demand\u00e9e (en mm/s) \u00e0 l'instant T.","title":"motion_report"},{"location":"Status_Reference.html#output_pin","text":"Les informations suivantes sont disponibles dans les objets output_pin nom_de_la_sortie : value : la \"valeur\" de la broche, telle que d\u00e9finie par une commande SET_PIN .","title":"output_pin"},{"location":"Status_Reference.html#palette2","text":"Les informations suivantes sont disponibles dans l'objet palette2 : ping : montant du dernier ping du \"Palette 2\" signal\u00e9 en pourcentage. remaining_load_length : lors du d\u00e9marrage d'une impression Palette 2, ce sera la quantit\u00e9 de filament \u00e0 charger dans l'extrudeuse. is_splicing : Vrai lorsque la Palette 2 soude le filament.","title":"palette2"},{"location":"Status_Reference.html#pause_resume","text":"Les informations suivantes sont disponibles dans l'objet pause_resume : is_paused : Renvoie true si une commande PAUSE a \u00e9t\u00e9 ex\u00e9cut\u00e9e sans RESUME correspondant.","title":"pause_resume"},{"location":"Status_Reference.html#print_stats","text":"Les informations suivantes sont disponibles dans l'objet print_stats (cet objet est automatiquement disponible si une section de configuration virtual_sdcard est d\u00e9finie) : filename , total_duration , print_duration , filament_used , state , message : informations estim\u00e9es sur l'impression en cours lorsqu'une impression virtual_sdcard est active. info.total_layer : La valeur totale de la couche de la derni\u00e8re commande SET_PRINT_STATS_INFO TOTAL_LAYER=<value> G-Code. info.current_layer : la valeur de la couche actuelle de la derni\u00e8re commande G-Code SET_PRINT_STATS_INFO CURRENT_LAYER=<valeur> .","title":"print_stats"},{"location":"Status_Reference.html#probe","text":"Les informations suivantes sont disponibles dans l'objet probe (cet objet est \u00e9galement disponible si une section de configuration bltouch est d\u00e9finie) : last_query : renvoie True si la sonde a \u00e9t\u00e9 signal\u00e9e comme \"d\u00e9clench\u00e9e\" lors de la derni\u00e8re commande QUERY_PROBE. Notez que si cela est utilis\u00e9 dans une macro, en raison de l'ordre de d\u00e9veloppement du mod\u00e8le, la commande QUERY_PROBE doit \u00eatre ex\u00e9cut\u00e9e avant la macro contenant cette demande. last_z_result : Renvoie la valeur du Z de la derni\u00e8re commande PROBE. Notez que si cela est utilis\u00e9 dans une macro, en raison de l'ordre d'expansion du mod\u00e8le, la commande PROBE (ou similaire) doit \u00eatre ex\u00e9cut\u00e9e avant la macro contenant cette demande.","title":"probe"},{"location":"Status_Reference.html#quad_gantry_level","text":"Les informations suivantes sont disponibles dans l'objet quad_gantry_level (cet objet est disponible si quad_gantry_level est d\u00e9fini) : applied : Vrai si le processus de nivellement 4 points du portique a \u00e9t\u00e9 ex\u00e9cut\u00e9 et termin\u00e9 avec succ\u00e8s.","title":"quad_gantry_level"},{"location":"Status_Reference.html#query_endstops","text":"Les informations suivantes sont disponibles dans l'objet query_endstops (cet objet est disponible si au moins une fin de course est d\u00e9finie) : last_query[\"<endstop>\"] : renvoie True si l'endstop donn\u00e9 a \u00e9t\u00e9 signal\u00e9 comme \"d\u00e9clench\u00e9\" (triggered) lors de la derni\u00e8re commande QUERY_ENDSTOP. Notez que si cela est utilis\u00e9 dans une macro, en raison de l'ordre de d\u00e9veloppement du mod\u00e8le, la commande QUERY_ENDSTOP doit \u00eatre ex\u00e9cut\u00e9e avant la macro contenant cette demande.","title":"query_endstops"},{"location":"Status_Reference.html#screws_tilt_adjust","text":"Les informations suivantes sont disponibles dans l'objet screws_tilt_adjust : error : renvoie True si la commande SCREWS_TILT_CALCULATE la plus r\u00e9cente incluait le param\u00e8tre MAX_DEVIATION et que l'un des sondages au niveau des vis de lit d\u00e9passait la valeur MAX_DEVIATION . r\u00e9sultats : une liste des emplacements des vis de lit sond\u00e9es. Chaque entr\u00e9e de la liste est un dictionnaire contenant les cl\u00e9s suivantes : name : le nom de la vis tel qu'il est sp\u00e9cifi\u00e9 dans le fichier de configuration. x : la coordonn\u00e9e X de la vis telle que sp\u00e9cifi\u00e9e dans le fichier de configuration. y : la coordonn\u00e9e Y de la vis telle que sp\u00e9cifi\u00e9e dans le fichier de configuration. z : La hauteur Z mesur\u00e9e \u00e0 l'emplacement de la vis. sign : Une cha\u00eene sp\u00e9cifiant le sens de rotation \u00e0 visser pour le r\u00e9glage n\u00e9cessaire. Soit \"CW\" pour le sens horaire ou \"CCW\" pour le sens antihoraire. La vis de base n'aura pas de cl\u00e9 sign . adjust : le nombre de tours de vis pour ajuster la vis, donn\u00e9 au format \"HH:MM\", o\u00f9 \"HH\" est le nombre de tours de vis complets et \"MM\" est le nombre de \"minutes d'un cadran d'horloge\" repr\u00e9sentant un tour de vis partiel. (Par exemple, \"01:15\" signifierait de tourner la vis d'un tour et quart.)","title":"screws_tilt_adjust"},{"location":"Status_Reference.html#servo","text":"Les informations suivantes sont disponibles dans les objets servo some_name : printer[\"servo <config_name>\"].value : le dernier r\u00e9glage de la broche PWM (une valeur comprise entre 0,0 et 1,0) associ\u00e9e au servo.","title":"servo"},{"location":"Status_Reference.html#system_stats","text":"Les informations suivantes sont disponibles dans l'objet system_stats (cet objet est toujours disponible) : sysload , cputime , memavail : informations sur le syst\u00e8me d'exploitation h\u00f4te et la charge du processus.","title":"system_stats"},{"location":"Status_Reference.html#capteurs-de-temperature","text":"Les informations suivantes sont disponibles dans objets BME280 nom_du_capteur , htu21d nom_du_capteur , lm75 nom_du_capteur et temperature_host nom_du_capteur : temperature : La derni\u00e8re temp\u00e9rature lue par le capteur. humidit\u00e9 , pression , gaz : les derni\u00e8res valeurs lues par le capteur (uniquement sur les capteurs bme280, htu21d et lm75).","title":"Capteurs de temp\u00e9rature"},{"location":"Status_Reference.html#temperature_fan","text":"Les informations suivantes sont disponibles dans les objets temperature_fan nom_du_ventilateur : temperature : La derni\u00e8re temp\u00e9rature lue par le capteur. target : La temp\u00e9rature cible pour le ventilateur.","title":"temperature_fan"},{"location":"Status_Reference.html#temperature_sensor","text":"Les informations suivantes sont disponibles dans les objets temperature_sensor nom_du_capteur : temperature : La derni\u00e8re temp\u00e9rature lue par le capteur. measured_min_temp , measured_max_temp : la temp\u00e9rature la plus basse et la plus \u00e9lev\u00e9e observ\u00e9es par le capteur depuis le dernier red\u00e9marrage de Klipper.","title":"temperature_sensor"},{"location":"Status_Reference.html#pilotes-tmc","text":"Les informations suivantes sont disponibles dans les objets pilote pas \u00e0 pas TMC (par exemple, [tmc2208 stepper_x] ) : mcu_phase_offset : la position du moteur pas \u00e0 pas du microcontr\u00f4leur correspondant \u00e0 la phase \"z\u00e9ro\" du pilote. Ce champ peut \u00eatre nul si le d\u00e9phasage n'est pas connu. phase_offset_position : La \"position command\u00e9e\" correspondant \u00e0 la phase \"z\u00e9ro\" du driver. Ce champ peut \u00eatre nul si le d\u00e9phasage n'est pas connu. drv_status : les r\u00e9sultats de la derni\u00e8re requ\u00eate d'\u00e9tat du pilote. (Seuls les champs non nuls sont signal\u00e9s.) Ce champ sera nul si le pilote n'est pas activ\u00e9 (et n'est donc pas interrog\u00e9 p\u00e9riodiquement). run_current : le courant de fonctionnement actuellement d\u00e9fini. hold_current : Le courant de maintien actuellement d\u00e9fini.","title":"Pilotes TMC"},{"location":"Status_Reference.html#toolhead","text":"Les informations suivantes sont disponibles dans l'objet toolhead (cet objet est toujours disponible) : position : la derni\u00e8re position command\u00e9e de la t\u00eate d'outil par rapport au syst\u00e8me de coordonn\u00e9es sp\u00e9cifi\u00e9 dans le fichier de configuration. Il est possible d'acc\u00e9der aux composantes x, y, z et e de cette position (par exemple, position.x ). extruder : le nom de l'extrudeur actuellement actif. Par exemple, dans une macro, on pourrait utiliser printer[printer.toolhead.extruder].target pour obtenir la temp\u00e9rature cible de l'extrudeuse actuelle. homed_axes : les axes consid\u00e9r\u00e9s comme \u00e9tant dans un \u00e9tat \"\u00e0 l'origine\". Il s'agit d'une cha\u00eene contenant un ou plusieurs \"x\", \"y\", \"z\". axis_minimum , axis_maximum : les limites de d\u00e9placement de l'axe (mm) apr\u00e8s la mise \u00e0 l'origine. Il est possible d'acc\u00e9der aux composantes x, y, z de cette valeur limite (par exemple, axis_minimum.x , axis_maximum.z ). Pour les imprimantes Delta, le cone_start_z est la hauteur z maximale au rayon maximal ( printer.toolhead.cone_start_z ). max_velocity , max_accel , max_accel_to_decel , square_corner_velocity : les limites d'impression actuelles en vigueur. Cela peut diff\u00e9rer des param\u00e8tres du fichier de configuration si une commande SET_VELOCITY_LIMIT (ou M204 ) les a modifi\u00e9es au moment de l'ex\u00e9cution. stalls : Le nombre total de fois (depuis le dernier red\u00e9marrage) o\u00f9 l'imprimante a d\u00fb \u00eatre mise en pause parce que la t\u00eate d'outil s'est d\u00e9plac\u00e9e plus vite que les mouvements ne pouvaient \u00eatre lus \u00e0 partir de l'entr\u00e9e G-Code.","title":"toolhead"},{"location":"Status_Reference.html#dual_carriage","text":"Les informations suivantes sont disponibles dans dual_carriage sur une imprimante de type hybrid_corexy ou hybrid_corexz mode : Le mode actuel. Les valeurs possibles sont : \"FULL_CONTROL\" active_carriage : le chariot actif actuel. Les valeurs possibles sont : \"CARRIAGE_0\", \"CARRIAGE_1\"","title":"dual_carriage"},{"location":"Status_Reference.html#virtual_sdcard","text":"Les informations suivantes sont disponibles dans l'objet virtual_sdcard : is_active : renvoie True si une impression \u00e0 partir d'un fichier est actuellement active. progress : une estimation de la progression de l'impression actuelle (bas\u00e9e sur la taille et la position du fichier). file_path : un chemin d'acc\u00e8s complet au fichier actuellement charg\u00e9. file_position : la position actuelle (en octets) d'une impression active. file_size : taille (en octets) du fichier actuellement charg\u00e9.","title":"virtual_sdcard"},{"location":"Status_Reference.html#webhooks","text":"Les informations suivantes sont disponibles dans l'objet webhooks (cet objet est toujours disponible) : state : renvoie une cha\u00eene indiquant l'\u00e9tat actuel de Klipper. Les valeurs possibles sont : \"ready\", \"startup\", \"shutdown\", \"error\". state_message : une cha\u00eene donnant un contexte suppl\u00e9mentaire sur l'\u00e9tat actuel de Klipper.","title":"webhooks"},{"location":"Status_Reference.html#z_thermal_adjust","text":"Les informations suivantes sont disponibles dans l'objet z_thermal_adjust (cet objet est disponible si z_thermal_adjust est d\u00e9fini). enabled : renvoie True si le r\u00e9glage est activ\u00e9. temp\u00e9rature : Temp\u00e9rature actuelle (liss\u00e9e) du capteur d\u00e9fini. (en degr\u00e9s Centigrades) measured_min_temp : temp\u00e9rature minimale mesur\u00e9e. (en degr\u00e9s Centigrades) measured_max_temp : temp\u00e9rature maximale mesur\u00e9e. (En degr\u00e9s Centigrades) current_z_adjust : dernier ajustement Z calcul\u00e9 (en mm). z_adjust_ref_temperature : Temp\u00e9rature de r\u00e9f\u00e9rence actuelle utilis\u00e9e pour le calcul de Z current_z_adjust (En degr\u00e9s Centigrades).","title":"z_thermal_adjust"},{"location":"Status_Reference.html#z_tilt","text":"Les informations suivantes sont disponibles dans l'objet z_tilt (cet objet est disponible si z_tilt est d\u00e9fini) : applied : Vrai si le processus de mise \u00e0 niveau z-tilt a \u00e9t\u00e9 ex\u00e9cut\u00e9 et termin\u00e9 avec succ\u00e8s.","title":"z_tilt"},{"location":"TMC_Drivers.html","text":"Pilotes de moteur pas \u00e0 pas TMC \u00b6 Ce document fournit des informations sur l'utilisation des pilotes de moteur pas \u00e0 pas Trinamic en mode SPI/UART sur Klipper. Klipper peut \u00e9galement utiliser les pilotes Trinamic dans leur \"mode autonome\". Cependant, lorsque les pilotes sont dans ce mode, aucune configuration sp\u00e9ciale de Klipper n'est possible et les fonctionnalit\u00e9s avanc\u00e9es de Klipper d\u00e9crites dans ce document ne sont pas disponibles. En plus de ce document, veillez \u00e0 consulter la r\u00e9f\u00e9rence de configuration du pilote TMC . R\u00e9glage du courant du moteur \u00b6 Un courant de commande plus \u00e9lev\u00e9 augmente la pr\u00e9cision de positionnement et le couple. Cependant, un courant plus \u00e9lev\u00e9 augmente \u00e9galement la chaleur produite par le moteur pas \u00e0 pas et le pilote du moteur pas \u00e0 pas. Si le pilote du moteur pas \u00e0 pas devient trop chaud, il se d\u00e9sactivera et Klipper signalera une erreur. Si le moteur pas \u00e0 pas devient trop chaud, il perd du couple et de la pr\u00e9cision de positionnement. (S'il devient tr\u00e8s chaud, il peut \u00e9galement faire fondre les pi\u00e8ces en plastique qui y sont attach\u00e9es ou \u00e0 proximit\u00e9.) Comme conseil de r\u00e9glage g\u00e9n\u00e9ral : pr\u00e9f\u00e9rez des valeurs de courant plus \u00e9lev\u00e9es tant que le moteur pas \u00e0 pas ne chauffe pas trop et que le pilote du moteur pas \u00e0 pas ne signale pas d'avertissements ou d'erreurs. En g\u00e9n\u00e9ral, il est normal que le moteur pas \u00e0 pas soit chaud, mais il ne doit pas devenir si chaud qu'il soit douloureux au toucher. Ne sp\u00e9cifiez pas de hold_current \u00b6 Si l'on configure un hold_current , le pilote TMC peut r\u00e9duire le courant vers le moteur pas \u00e0 pas lorsqu'il d\u00e9tecte que le moteur pas \u00e0 pas ne bouge pas. Cependant, la modification du courant du moteur peut elle-m\u00eame introduire un mouvement du moteur. Cela peut se produire en raison de \"forces de d\u00e9tente\" dans le moteur pas \u00e0 pas (l'aimant permanent du rotor tire vers les dents en fer du stator) ou en raison de forces externes sur le chariot d'axe. La plupart des moteurs pas \u00e0 pas ne fonctionneront pas mieux en r\u00e9duisant le courant pendant les impressions normales, car peu de mouvements d'impression laisseront un moteur pas \u00e0 pas inactif suffisamment longtemps pour activer la fonction hold_current . Et, il est peu probable que l'on veuille introduire des artefacts d'impression dans les quelques mouvements d'impression qui laissent un stepper inactif suffisamment longtemps. Si l'on souhaite r\u00e9duire le courant vers les moteurs pendant les routines de d\u00e9marrage d'impression, envisagez d'\u00e9mettre des commandes SET_TMC_CURRENT dans une MACRO START_PRINT pour ajuster le courant avant et apr\u00e8s les mouvements d'impression normaux. Certaines imprimantes avec des moteurs Z d\u00e9di\u00e9s qui sont inactifs pendant les mouvements d'impression normaux (pas de bed_mesh, pas de bed_tilt, pas de Z skew_correction, pas d'impressions en \"mode vase\", etc.) peuvent constater que les moteurs Z fonctionnent plus froid avec un hold_current . Si vous l'impl\u00e9mentez, assurez-vous de prendre en compte ce type de mouvement non command\u00e9 de l'axe Z pendant le nivellement du lit, le sondage du lit, l'\u00e9talonnage de la sonde, etc. Le driver_TPOWERDOWN et le driver_IHOLDDELAY doivent \u00e9galement \u00eatre calibr\u00e9s en cons\u00e9quence. En cas de doute, pr\u00e9f\u00e9rez ne pas sp\u00e9cifier de hold_current . R\u00e9glage du mode \"spreadCycle\" vs \"stealthChop\" \u00b6 Par d\u00e9faut, Klipper place les pilotes TMC en mode \"spreadCycle\". Si le pilote prend en charge \"stealthChop\", il peut \u00eatre activ\u00e9 en ajoutant stealthchop_threshold : 999999 \u00e0 la section de configuration TMC. Le mode spreadCycle fournit un couple sup\u00e9rieur et une plus grande pr\u00e9cision de positionnement que le mode stealthChop. Cependant, le mode StealthChop peut produire un bruit audible nettement plus faible sur certaines imprimantes. Les tests comparant les modes ont montr\u00e9 un \"d\u00e9calage de position\" accru d'environ 75 % d'un pas complet lors de mouvements \u00e0 vitesse constante lors de l'utilisation du mode StealthChop (par exemple, sur une imprimante avec une distance de rotation de 40 mm et 200 pas_par_rotation, l'\u00e9cart de position des mouvements \u00e0 vitesse constante a augment\u00e9 de ~0,150 mm). Cependant, ce \"retard dans l'obtention de la position demand\u00e9e\" peut ne pas se manifester par un d\u00e9faut d'impression significatif et on peut pr\u00e9f\u00e9rer le comportement plus silencieux du mode StealthChop. Il est recommand\u00e9 de toujours utiliser le mode \"spreadCycle\" (en ne sp\u00e9cifiant pas stealthchop_threshold ) ou de toujours utiliser le mode \"stealthChop\" (en r\u00e9glant stealthchop_threshold sur 999999). Malheureusement, les pilotes produisent souvent des r\u00e9sultats m\u00e9diocres et erron\u00e9s si le mode est chang\u00e9 alors que le moteur tourne. Le r\u00e9glage d'interpolation TMC introduit un petit \u00e9cart de position \u00b6 Le param\u00e8tre interpolation du pilote TMC peut r\u00e9duire le bruit audible du mouvement de l'imprimante au prix de l'introduction d'une petite erreur de position syst\u00e9mique. Cette erreur de position syst\u00e9mique r\u00e9sulte du retard du conducteur \u00e0 ex\u00e9cuter les \"\u00e9tapes\" que Klipper lui envoie. Pendant les d\u00e9placements \u00e0 vitesse constante, ce retard entra\u00eene une erreur de position de pr\u00e8s d'un demi-micropas configur\u00e9 (plus pr\u00e9cis\u00e9ment, l'erreur est d'une demi-distance de micropas moins un 512e de distance d'un pas complet). Par exemple, sur un axe avec une rotation_distance de 40 mm, 200 pas_par_rotation et 16 micropas, l'erreur syst\u00e9mique introduite lors des mouvements \u00e0 vitesse constante est d'environ 0,006 mm. Pour une meilleure pr\u00e9cision de positionnement, envisagez d'utiliser le mode spreadCycle et d\u00e9sactivez l'interpolation (d\u00e9finissez interpolate : False dans la configuration du pilote TMC). Lorsqu'il est configur\u00e9 de cette fa\u00e7on, on peut augmenter le param\u00e8tre microstep pour r\u00e9duire le bruit audible pendant le mouvement pas \u00e0 pas. En r\u00e8gle g\u00e9n\u00e9rale, un r\u00e9glage de micropas de 64 ou 128 aura un bruit audible similaire \u00e0 celui de l'interpolation, et ce, sans introduire d'erreur de position syst\u00e9mique. Si vous utilisez le mode StealthChop, l'impr\u00e9cision de position due \u00e0 l'interpolation est faible par rapport \u00e0 l'impr\u00e9cision de position introduite \u00e0 partir du mode StealthChop. Par cons\u00e9quent, le r\u00e9glage de l'interpolation n'est pas consid\u00e9r\u00e9e comme utile en mode StealthChop, et on peut laisser l'interpolation dans son \u00e9tat par d\u00e9faut. Mise \u00e0 l'origine sans capteur \u00b6 La mise \u00e0 l'origine ans capteur permet de r\u00e9f\u00e9rencer un axe sans avoir besoin d'une fin de course physique. Au lieu de cela, le chariot sur l'axe est d\u00e9plac\u00e9 dans la limite m\u00e9canique, ce qui fait perdre des pas au moteur pas \u00e0 pas. Le pilote pas \u00e0 pas d\u00e9tecte les pas perdus et l'indique au MCU de contr\u00f4le (Klipper) en basculant une broche. Cette information peut \u00eatre utilis\u00e9e par Klipper comme fin de course pour l'axe. Ce guide couvre la configuration de la mise \u00e0 l'origine sans capteur pour l'axe X de votre imprimante (cart\u00e9sienne). Cependant, cela fonctionne de la m\u00eame mani\u00e8re avec tous les autres axes (qui n\u00e9cessitent une fin de course). Vous devez le configurer et le r\u00e9gler pour un axe \u00e0 la fois. Limites \u00b6 Assurez-vous que vos composants m\u00e9caniques sont capables de supporter la charge du chariot heurtant \u00e0 plusieurs reprises la fin de course de l'axe. Les vis sans fin, en particulier, peuvent g\u00e9n\u00e9rer beaucoup de force. La prise d'origine d'un axe Z en \u00e9crasant la buse dans la surface d'impression n'est peut-\u00eatre pas une bonne id\u00e9e. Pour de meilleurs r\u00e9sultats, v\u00e9rifiez que le chariot de l'axe \u00e9tablit un contact lors de la mise \u00e0 l'origine. De plus, la mise \u00e0 l'origine sans capteur peut ne pas \u00eatre suffisamment pr\u00e9cise pour votre imprimante. Bien que la mise \u00e0 l'origine des axes X et Y sur une machine cart\u00e9sienne puisse bien fonctionner, la prise d'origine de l'axe Z n'est g\u00e9n\u00e9ralement pas assez pr\u00e9cise et peut entra\u00eener une hauteur de premi\u00e8re couche incoh\u00e9rente. Le r\u00e9f\u00e9rencement d'une imprimante delta sans capteur n'est pas conseill\u00e9 en raison du manque de pr\u00e9cision. De plus, la d\u00e9tection de d\u00e9crochage du pilote pas \u00e0 pas d\u00e9pend de la charge m\u00e9canique sur le moteur, du courant du moteur et de la temp\u00e9rature du moteur (r\u00e9sistance de la bobine). La mise \u00e0 l'origine sans capteur fonctionne mieux \u00e0 des vitesses de moteur moyennes. Pour des vitesses tr\u00e8s lentes (moins de 10 tr/min), le moteur ne g\u00e9n\u00e8re pas de force contre-\u00e9lectromotrice significative et le TMC ne peut pas d\u00e9tecter de mani\u00e8re fiable les calages du moteur. A des vitesses tr\u00e8s \u00e9lev\u00e9es, la force contre-\u00e9lectromotrice du moteur se rapproche de la tension d'alimentation du moteur, de sorte que le TMC ne peut plus d\u00e9tecter les calages. Il est conseill\u00e9 de consulter la fiche technique de vos TMC sp\u00e9cifiques. Vous y trouverez \u00e9galement plus de d\u00e9tails sur les limites de cette configuration. Conditions pr\u00e9alables \u00b6 Quelques pr\u00e9requis sont n\u00e9cessaires pour utiliser la mise \u00e0 l'origine sans capteur : Un pilote pas \u00e0 pas TMC compatible stallGuard (tmc2130, tmc2209, tmc2660 ou tmc5160). Interface SPI/UART du driver TMC c\u00e2bl\u00e9 au micro-contr\u00f4leur (le mode autonome ne fonctionne pas). La broche \"DIAG\" ou \"SG_TST\" appropri\u00e9e du pilote TMC doit \u00eatre connect\u00e9e au microcontr\u00f4leur. Les \u00e9tapes du document v\u00e9rification de la configuration doivent \u00eatre ex\u00e9cut\u00e9es pour confirmer que les moteurs pas \u00e0 pas sont configur\u00e9s et fonctionnent correctement. R\u00e9glages \u00b6 La proc\u00e9dure d\u00e9crite ici comporte six \u00e9tapes principales : Choisissez une vitesse de mise \u00e0 l'origine. Configurez le fichier printer.cfg pour activer la mise \u00e0 l'origine sans capteur. Trouvez le meilleur r\u00e9glage anti-d\u00e9crochage avec la sensibilit\u00e9 la plus \u00e9lev\u00e9e. Trouvez le r\u00e9glage anti-d\u00e9crochage avec la sensibilit\u00e9 la plus faible qui fonctionne avec une seule touche en fin de course. Mettez \u00e0 jour le fichier printer.cfg avec le param\u00e8tre anti-d\u00e9crochage souhait\u00e9. Cr\u00e9ez ou mettez \u00e0 jour les macros dans printer.cfg pour une mise \u00e0 l'origine r\u00e9p\u00e9table. Choisir la vitesse de prise d'origine \u00b6 La vitesse de mise \u00e0 l'origine est importante lors de la r\u00e9alisation d'une mise \u00e0 l'origine sans capteur. Il est souhaitable d'utiliser une vitesse de prise d'origine lente afin que le chariot n'exerce pas de force excessive sur le ch\u00e2ssis lorsqu'il entre en contact avec l'extr\u00e9mit\u00e9 du rail. Cependant, les pilotes TMC ne peuvent pas d\u00e9tecter de mani\u00e8re fiable un d\u00e9crochage \u00e0 des vitesses tr\u00e8s lentes. Un bon point de d\u00e9part pour la vitesse de prise d'origine est que le moteur pas \u00e0 pas effectue une rotation compl\u00e8te toutes les deux secondes. Pour de nombreux axes, ce sera la distance rotation_distance divis\u00e9e par deux. Par example\u202f: [stepper_x] rotation_distance: 40 homing_speed: 20 ... Configurer 'printer.cfg' pour une mise \u00e0 l'origine sans capteur \u00b6 Le param\u00e8tre homing_retract_dist doit \u00eatre d\u00e9fini sur z\u00e9ro dans la section de configuration stepper_x pour d\u00e9sactiver le deuxi\u00e8me mouvement de mise \u00e0 l'origine. La deuxi\u00e8me tentative de mise \u00e0 l'origine n'ajoute pas de valeur lors de l'utilisation d'une mise \u00e0 l'origine sans capteur, elle ne fonctionnera pas de mani\u00e8re fiable et introduira des erreurs dans le processus de r\u00e9glage. Assurez-vous que le param\u00e8tre hold_current n\u2019est pas sp\u00e9cifi\u00e9 dans la section Pilote TMC de la configuration. (Si un hold_current est r\u00e9gl\u00e9, le moteur s\u2019arr\u00eate lorsque le chariot est appuy\u00e9 contre l\u2019extr\u00e9mit\u00e9 du rail, et la r\u00e9duction du courant dans cette position peut entra\u00eener le d\u00e9placement du chariot - ce qui entra\u00eenera de mauvaises performances et perturbera le processus de r\u00e9glage.) Il est n\u00e9cessaire de configurer les broches du TMC pour le mode sans capteur et de configurer les param\u00e8tres initiaux de \u00ab Stallguard \u00bb. Un exemple de configuration tmc2209 pour un axe X pourrait ressembler \u00e0 : [tmc2209 stepper_x] diag_pin: ^PA1 # D\u00e9finit pour le MCU, la broche TMC DIAG driver_SGTHRS: 255 # 255 est la valeur la plus sensible, 0 la moins sensible ... [stepper_x] endstop_pin: tmc2209_stepper_x:virtual_endstop homing_retract_dist: 0 ... Un exemple de configuration de tmc2130 ou tmc5160 pourrait ressembler \u00e0 : [tmc2130 stepper_x] diag1_pin: ^!PA1 # Broche connect\u00e9e \u00e0 TMC DIAG1 (ou utilisez diag0_pin / DIAG0 pin) driver_SGT: -64 # -64 est la valeur la plus sensible, 63 est moins sensible ... [stepper_x] endstop_pin: tmc2130_stepper_x:virtual_endstop homing_retract_dist: 0 ... Un exemple de configuration de tmc2660 pourrait ressembler \u00e0 : [tmc2660 stepper_x] driver_SGT: -64 # -64 est la valeur la plus sensible,, 63 est moins sensible ... [stepper_x] endstop_pin: ^PA1 # Broche connect\u00e9e \u00e0 TMC SG_TST homing_retract_dist: 0 ... Les exemples ci-dessus ne montrent que les param\u00e8tres sp\u00e9cifiques \u00e0 la mise \u00e0 l'origine sans capteur. Voir la r\u00e9f\u00e9rence de configuration pour toutes les options disponibles. Trouvez la sensibilit\u00e9 la plus \u00e9lev\u00e9e qui fonctionne avec succ\u00e8s \u00b6 Placez le chariot pr\u00e8s du centre du rail. Utilisez la commande SET_TMC_FIELD pour d\u00e9finir la sensibilit\u00e9 la plus \u00e9lev\u00e9e. Pour un tmc2209 : SET_TMC_FIELD STEPPER=stepper_x FIELD=SGTHRS VALUE=255 Pour un tmc2130, tmc5160 et tmc2660 : SET_TMC_FIELD STEPPER=stepper_x FIELD=sgt VALUE=-64 \u00c9mettez ensuite une commande G28 X0 et v\u00e9rifiez que l'axe ne bouge pas du tout ou s'arr\u00eate rapidement. Si l'axe ne s'arr\u00eate pas, \u00e9mettez un M112 pour arr\u00eater l'imprimante - quelque chose n'est pas correct avec le c\u00e2blage ou la configuration de la broche diag/sg_tst et ce doit \u00eatre corrig\u00e9 avant de continuer. Ensuite, diminuez continuellement la sensibilit\u00e9 du param\u00e8tre VALUE et ex\u00e9cutez \u00e0 nouveau les commandes SET_TMC_FIELD G28 X0 pour trouver la sensibilit\u00e9 la plus \u00e9lev\u00e9e qui permet au chariot de se d\u00e9placer et de s'arr\u00eater en but\u00e9e. (Pour les pilotes tmc2209, cela diminuera SGTHRS, pour les autres pilotes, cela augmentera sgt.). Il devrait \u00eatre possible de trouver la sensibilit\u00e9 la plus \u00e9lev\u00e9e et fiable (les r\u00e9glages avec une sensibilit\u00e9 plus \u00e9lev\u00e9e entra\u00eenant peu ou pas de mouvement). Notez la valeur trouv\u00e9e comme maximum_sensitivity . (Si la sensibilit\u00e9 minimale possible (SGTHRS = 0 ou sgt = 63) est obtenue sans aucun mouvement du chariot, alors quelque chose ne fonctionne pas aun niveau c\u00e2blage ou configuration de la broche diag/sg_tst et il faut corriger le probl\u00e8me avant de continuer.) Lors de la recherche de maximum_sensitivity, il peut \u00eatre pratique de passer \u00e0 diff\u00e9rents param\u00e8tres VALUE (travaillez le param\u00e8tre VALUE par dichotomie pour plus d'efficacit\u00e9). Si vous proc\u00e9dez ainsi, pr\u00e9parez-vous \u00e0 \u00e9mettre une commande M112 pour arr\u00eater l'imprimante, car un r\u00e9glage avec une sensibilit\u00e9 trop faible peut entra\u00eener un \"cognement\" r\u00e9p\u00e9t\u00e9 de l'axe contre l'extr\u00e9mit\u00e9 du rail. Assurez-vous d'attendre quelques secondes entre chaque tentative de prise d'origine. Une fois que le pilote TMC a d\u00e9tect\u00e9 un d\u00e9crochage, il peut lui falloir un peu de temps pour effacer son indicateur interne et \u00eatre capable de d\u00e9tecter un autre d\u00e9crochage. Au cours de ces tests de r\u00e9glage, si une commande G28 X0 ne se d\u00e9place pas jusqu'\u00e0 la limite d'axe, soyez prudent lorsque vous ex\u00e9cutez des commandes de mouvement 'normales' (par exemple, G1 ). Klipper ne sachant pas ou est le chariot, une commande de d\u00e9placement pourra entra\u00eener des r\u00e9sultats ind\u00e9sirables. Trouver la sensibilit\u00e9 la plus basse qui permette la mise \u00e0 l'origine en une seule fois \u00b6 Lors de la mise \u00e0 l'origine avec la valeur maximum_sensitivity , l'axe doit se d\u00e9placer jusqu'\u00e0 l'extr\u00e9mit\u00e9 du rail et s'arr\u00eater avec un \u00ab simple toucher \u00bb - c'est-\u00e0-dire qu'il ne doit pas y avoir de \u00ab clic \u00bb ou de \u00ab claquement \u00bb. (S'il y a un bruit de claquement ou de clic \u00e0 la sensibilit\u00e9 maximale, la vitesse de mise \u00e0 l'origine est peut-\u00eatre trop faible, le courant du pilote peut \u00eatre trop faible ou la mise \u00e0 l'origine sans capteur n'est peut-\u00eatre pas un bon choix pour cet axe.) L'\u00e9tape suivante consiste \u00e0 nouveau \u00e0 d\u00e9placer le chariot vers une position proche du centre du rail, \u00e0 diminuer la sensibilit\u00e9 et \u00e0 ex\u00e9cuter les commandes SET_TMC_FIELD G28 X0 - l'objectif est maintenant de trouver la sensibilit\u00e9 la plus faible qui permette au chariot de se mettre \u00e0 l'origine correctement avec une \"simple touche\". C'est-\u00e0-dire qu'il ne \"cogne\" pas ou ne \"clique\" pas lorsqu'il entre en contact avec l'extr\u00e9mit\u00e9 du rail. Notez la valeur trouv\u00e9e comme minimum_sensitivity . Mettez \u00e0 jour printer.cfg avec la valeur de sensibilit\u00e9 \u00b6 Apr\u00e8s avoir trouv\u00e9 maximum_sensitivity et minimum_sensitivity , utilisez une calculatrice pour obtenir la sensibilit\u00e9 recommand\u00e9e : minimum_sensitivity + (maximum_sensitivity - minimum_sensitivity)/3 . La sensibilit\u00e9 recommand\u00e9e doit \u00eatre comprise entre le minimum et le maximum, mais l\u00e9g\u00e8rement plus proche du minimum. Arrondissez la valeur finale \u00e0 la valeur enti\u00e8re la plus proche. Pour un tmc2209, d\u00e9finissez-le dans la configuration en tant que driver_SGTHRS , pour les autres pilotes TMC, d\u00e9finissez-le dans la configuration en tant que driver_SGT . Si la plage entre maximum_sensitivity et minimum_sensitivity est petite (par exemple, inf\u00e9rieure \u00e0 5), cela peut entra\u00eener une mise \u00e0 l'origine instable. Une vitesse de mise \u00e0 l'origine plus rapide peut rendre l'op\u00e9ration plus stable. Notez que si une modification est apport\u00e9e au courant du pilote, \u00e0 la vitesse de prise d'origine ou si une modification notable est apport\u00e9e au mat\u00e9riel de l'imprimante, il sera alors n\u00e9cessaire de refaire le processus de r\u00e9glage. Utilisation de macros lors de la mise \u00e0 l'origine \u00b6 Une fois la mise \u00e0 l'origine sans capteur termin\u00e9e, le chariot sera appuy\u00e9 contre l'extr\u00e9mit\u00e9 du rail et le stepper exercera une force sur le cadre tant que le chariot ne sera pas \u00e9loign\u00e9 de la fin de course. Il est pr\u00e9f\u00e9rable de cr\u00e9er une macro pour positionner l'axe en but\u00e9e et l'\u00e9loigner imm\u00e9diatement de l'extr\u00e9mit\u00e9 du rail. Il est pr\u00e9f\u00e9rable, dans la macro, de faire une pause d'au moins 2 secondes avant de commencer la prise d'origine sans capteur (ou de s'assurer qu'il n'y a eu aucun mouvement sur le moteur pas \u00e0 pas depuis au moins 2 secondes). Sans d\u00e9lai, il est possible que le drapeau de d\u00e9crochage interne du pilote de moteur pas \u00e0 pas soit toujours activ\u00e9 suite \u00e0 un mouvement pr\u00e9c\u00e9dent. Il peut \u00e9galement \u00eatre utile que cette macro d\u00e9finisse le courant du pilote avant la prise d'origine et d\u00e9finisse un nouveau courant apr\u00e8s que le chariot s'est \u00e9loign\u00e9. Un exemple de macro pourrait ressembler \u00e0 : [gcode_macro SENSORLESS_HOME_X] gcode: {% set HOME_CUR = 0.700 %} {% set driver_config = printer.configfile.settings['tmc2209 stepper_x'] %} {% set RUN_CUR = driver_config.run_current %} # D\u00e9finir le courant pour la mise \u00e0 l'origine sans capteur SET_TMC_CURRENT STEPPER=stepper_x CURRENT={HOME_CUR} # Petit pause pour attendre que le drapeau stall flag soit d\u00e9sactiv\u00e9 G4 P2000 # mise \u00e0 l'origine G28 X0 # D\u00e9placement G90 G1 X5 F1200 # Remise du courant d'impression SET_TMC_CURRENT STEPPER=stepper_x CURRENT={RUN_CUR} La macro peut \u00eatre appel\u00e9e depuis une section de configuration homing_override ou depuis une macro START_PRINT . Notez que si le courant du pilote pas \u00e0 pas lors de la mise \u00e0 l'origine est modifi\u00e9, le processus de r\u00e9glage doit \u00eatre enti\u00e8rement refait. Conseils pour la mise \u00e0 l'origine sans capteur sur CoreXY \u00b6 Il est possible d'utiliser la mise \u00e0 l'origine sans capteur sur les chariots X et Y d'une imprimante CoreXY. Klipper utilise le stepper [stepper_x] pour d\u00e9tecter les d\u00e9crochages lors de la mise \u00e0 l'origine du chariot X et utilise le stepper [stepper_y] pour d\u00e9tecter les d\u00e9crochages lors de la mise \u00e0 l'origine du chariot Y. Utilisez le guide de r\u00e9glage d\u00e9crit ci-dessus pour trouver la \"sensibilit\u00e9 au d\u00e9crochage\" appropri\u00e9e pour chaque chariot, mais soyez conscient des restrictions suivantes : Lors de l'utilisation de la prise d'origine sans capteur sur CoreXY, assurez-vous qu'aucun hold_current n'est configur\u00e9 pour l'un ou l'autre des moteurs pas \u00e0 pas. Pendant le r\u00e9glage, assurez-vous que les chariots X et Y sont proches du centre de leurs rails avant chaque tentative de mise \u00e0 l'origine. Une fois les r\u00e9glages termin\u00e9s, lors de la prise d'origine de X et Y, utilisez des macros pour vous assurer qu'un axe est pris en charge en premier, puis \u00e9loignez ce chariot de la fin de course de l'axe, faites une pause d'au moins 2 secondes, puis d\u00e9marrez la prise d'origine de l'autre axe. L'\u00e9loignement de l'axe \u00e9vite le r\u00e9f\u00e9rencement d'un axe alors que l'autre est plaqu\u00e9 contre la fin de course (ce qui peut fausser la d\u00e9tection de d\u00e9crochage). La pause est n\u00e9cessaire pour s'assurer que le drapeau de d\u00e9crochage du pilote pas \u00e0 pas est effac\u00e9 avant de se d\u00e9placer \u00e0 nouveau. Un exemple de macro de r\u00e9f\u00e9rencement CoreXY pourrait ressembler \u00e0 : [gcode_macro HOME] gcode: G90 # mise \u00e0 l'origine Z G28 Z0 G1 Z10 F1200 # mise \u00e0 l'origine Y G28 Y0 G1 Y5 F1200 # mise \u00e0 l'origine X G4 P2000 G28 X0 G1 X5 F1200 Interroger et diagnostiquer les informations du pilote pas \u00e0 pas \u00b6 La ` commande DUMP_TMC est un outil utile lors de la configuration et du diagnostic des pilotes. Il signalera tous les champs configur\u00e9s par Klipper ainsi que tous les champs pouvant \u00eatre interrog\u00e9s \u00e0 partir du pilote. Tous les champs signal\u00e9s sont d\u00e9finis dans la fiche technique de Trinamic pour chaque pilote. Ces fiches techniques sont disponibles sur le site Internet de Trinamic . Obtenez et examinez la fiche technique de Trinamic du pilote pas \u00e0 pas afin d'interpr\u00e9ter correctement les r\u00e9sultats d'un DUMP_TMC. Configuration des param\u00e8tres d'un 'driver_XXX' \u00b6 Klipper prend en charge la configuration de nombreux param\u00e8tres de bas niveau pour les pilotes de moteurs pas \u00e0 pas \u00e0 l'aide des param\u00e8tres de la section driver_XXX . La r\u00e9f\u00e9rence de configuration du pilote TMC contient la liste compl\u00e8te des param\u00e8tres disponibles pour chaque type de pilote. De plus, presque tous les champs peuvent \u00eatre modifi\u00e9s au moment de l'ex\u00e9cution \u00e0 l'aide de la commande SET_TMC_FIELD . Chacun de ces param\u00e8tres est d\u00e9fini dans la fiche technique de Trinamic pour chaque pilote. Ces fiches techniques sont disponibles sur le site Internet de Trinamic . Les fiches techniques de Trinamic utilisent parfois une formulation qui peut confondre un param\u00e8tre de haut niveau (tel que \"fin d'hyst\u00e9r\u00e9sis\") avec une valeur de param\u00e8tre de bas niveau (par exemple, \"HEND\"). Dans Klipper, driver_XXX et SET_TMC_FIELD d\u00e9finissent toujours la valeur de param\u00e8tres de bas niveau (celles qui sontt r\u00e9ellement \u00e9crite dans le pilote). Ainsi, par exemple, si la fiche technique Trinamic indique qu'une valeur de 3 doit \u00eatre \u00e9crite dans le champ HEND pour obtenir une \"fin d'hyst\u00e9r\u00e9sis\" de 0, alors d\u00e9finissez driver_HEND=3 pour obtenir une valeur de haut niveau de 0. Questions courantes \u00b6 Puis-je utiliser le mode StealthChop sur une extrudeuse avec avance de pression ? \u00b6 Beaucoup de gens utilisent avec succ\u00e8s le mode \"stealthChop\" avec l'avance de pression de Klipper. Klipper impl\u00e9mente avance de pression \"adoucie\" qui n'introduit aucun changement de vitesse instantan\u00e9. Cependant, le mode \"stealthChop\" peut produire un couple moteur plus faible et/ou produire une chaleur moteur plus \u00e9lev\u00e9e. Il peut s'agir ou non d'un mode utilisable avec votre imprimante. J'ai des erreurs \"Unable to read tmc uart 'stepper_x' register IFCNT\" ? \u00b6 Cela se produit lorsque Klipper est incapable de communiquer avec un pilote tmc2208 ou tmc2209. Assurez-vous que l'alimentation du moteur est activ\u00e9e, car le pilote du moteur pas \u00e0 pas a g\u00e9n\u00e9ralement besoin de l'alimentation du moteur avant de pouvoir communiquer avec le micro-contr\u00f4leur. Si cette erreur se produit apr\u00e8s avoir flash\u00e9 Klipper pour la premi\u00e8re fois, le pilote pas \u00e0 pas peut avoir \u00e9t\u00e9 pr\u00e9c\u00e9demment programm\u00e9 dans un \u00e9tat qui n'est pas compatible avec Klipper. Pour r\u00e9initialiser l'\u00e9tat, coupez toute alimentation de l'imprimante pendant plusieurs secondes (d\u00e9branchez physiquement les prises USB et d'alimentation). Sinon, cette erreur est souvent due \u00e0 un c\u00e2blage incorrect des broche UART ou d'une configuration incorrecte des param\u00e8tres de broche UART dans Klipper. J'ai des erreurs \"Unable to write tmc spi 'stepper_x' register ...\" ? \u00b6 Cela se produit lorsque Klipper est incapable de communiquer avec un pilote tmc2130 ou tmc5160. Assurez-vous que l'alimentation du moteur est activ\u00e9e, car le pilote du moteur pas \u00e0 pas a g\u00e9n\u00e9ralement besoin de l'alimentation du moteur avant de pouvoir communiquer avec le micro-contr\u00f4leur. Cette erreur est souvent due \u00e0 un c\u00e2blage SPI incorrect, \u00e0 une configuration incorrecte des param\u00e8tres SPI de Klipper ou d'une configuration incompl\u00e8te des p\u00e9riph\u00e9riques sur un bus SPI. Si le pilote se trouve sur un bus SPI partag\u00e9 avec plusieurs p\u00e9riph\u00e9riques, assurez-vous de configurer - dans Klipper - chaque p\u00e9riph\u00e9rique sur ce bus SPI. Si un appareil sur un bus SPI partag\u00e9 n'est pas configur\u00e9, il peut r\u00e9pondre de mani\u00e8re incorrecte \u00e0 des commandes qui ne lui sont pas destin\u00e9es et corrompre la communication avec l'appareil pr\u00e9vu. S'il y a un appareil sur un bus SPI partag\u00e9 qui ne peut pas \u00eatre configur\u00e9 dans Klipper, utilisez la section de configuration static_digital_output pour r\u00e9gler la broche CS de l'appareil inutilis\u00e9 \u00e0 un niveau \u00e9lev\u00e9 (afin qu'il n'essaie pas d'utiliser le bus SPI). Le sch\u00e9ma de la carte est une r\u00e9f\u00e9rence utile (ndt et n\u00e9cessaire) pour trouver les p\u00e9riph\u00e9riques qui se trouvent sur un bus SPI et leurs broches associ\u00e9es. Pourquoi ai-je une erreur \"TMC reports error\u202f: ...\"\u202f? \u00b6 Ce type d'erreur indique que le pilote TMC a d\u00e9tect\u00e9 un probl\u00e8me et s'est d\u00e9sactiv\u00e9. C'est-\u00e0-dire que le pilote de moteur pas \u00e0 pas a cess\u00e9 de maintenir sa position et a ignor\u00e9 les commandes de mouvement. Si Klipper d\u00e9tecte qu'un pilote actif s'est d\u00e9sactiv\u00e9, il fera passer l'imprimante dans un \u00e9tat \"arr\u00eat\". Il est \u00e9galement possible qu'un arr\u00eat TMC reports error se produise en raison d'erreurs SPI qui emp\u00eachent la communication avec le pilote (sur les tmc2130, tmc5160 ou tmc2660). Si cela se produit, il est fr\u00e9quent que l'\u00e9tat du pilote indiqu\u00e9 affiche 00000000 ou ffffffff - par exemple : TMC reports error : DRV_STATUS : ffffffff ... OU [ X316X]TMC reports error : READRSP@RDSEL2 : 00000000 ...`. Une telle d\u00e9faillance peut \u00eatre due \u00e0 un probl\u00e8me de c\u00e2blage SPI ou \u00e0 une r\u00e9initialisation automatique ou \u00e0 une d\u00e9faillance du pilote TMC. Quelques erreurs courantes et conseils pour les diagnostiquer : TMC signale une erreur : ... ot=1(OvertempError !) \u00b6 Cela indique que le pilote du moteur s'est d\u00e9sactiv\u00e9 car il est en surchauffe. Les solutions typiques consistent \u00e0 diminuer le courant du pilote de moteur pas \u00e0 pas, \u00e0 augmenter le refroidissement du pilote du moteur pas \u00e0 pas et/ou \u00e0 augmenter le refroidissement du pilote du moteur pas \u00e0 pas. TMC signale une erreur : ... ShortToGND OU LowSideShort \u00b6 Cela indique que le pilote s'est d\u00e9sactiv\u00e9 car il a d\u00e9tect\u00e9 un courant tr\u00e8s \u00e9lev\u00e9 le traversant. Cela peut indiquer un fil desserr\u00e9 ou court-circuit\u00e9 vers le moteur pas \u00e0 pas ou dans le moteur pas \u00e0 pas lui-m\u00eame. Cette erreur peut \u00e9galement se produire si vous utilisez le mode StealthChop et que le pilote TMC n'est pas en mesure de pr\u00e9dire avec pr\u00e9cision la charge m\u00e9canique du moteur. (Si le pilote fait une mauvaise pr\u00e9diction, il peut envoyer trop de courant \u00e0 travers le moteur et d\u00e9clencher sa propre d\u00e9tection de surintensit\u00e9.) Pour tester cela, d\u00e9sactivez le mode StealthChop et v\u00e9rifiez si les erreurs continuent de se produire. TMC signale une erreur : ... reset=1(Reset) OR CS_ACTUAL=0(Reset ?) OR SE=0(Reset?) \u00b6 Cela indique que le pilote s'est r\u00e9initialis\u00e9 en cours d'impression. Cela peut \u00eatre d\u00fb \u00e0 des probl\u00e8mes de tension ou de c\u00e2blage. TMC signale une erreur : ... uv_cp=1(Sous-tension !) \u00b6 Cela indique que le pilote a d\u00e9tect\u00e9 un \u00e9v\u00e9nement de basse tension et s'est d\u00e9sactiv\u00e9. Cela peut \u00eatre d\u00fb \u00e0 des probl\u00e8mes de c\u00e2blage ou d'alimentation. Comment r\u00e9gler spreadCycle/coolStep/etc. mode sur mes pilotes ? \u00b6 Le site Web de Trinamic contient des guides sur la configuration des pilotes. Ces guides sont souvent techniques, de bas niveau et peuvent n\u00e9cessiter du mat\u00e9riel sp\u00e9cialis\u00e9. Quoi qu'il en soit, ils sont la meilleure source d'information.","title":"Pilotes de moteur pas \u00e0 pas TMC"},{"location":"TMC_Drivers.html#pilotes-de-moteur-pas-a-pas-tmc","text":"Ce document fournit des informations sur l'utilisation des pilotes de moteur pas \u00e0 pas Trinamic en mode SPI/UART sur Klipper. Klipper peut \u00e9galement utiliser les pilotes Trinamic dans leur \"mode autonome\". Cependant, lorsque les pilotes sont dans ce mode, aucune configuration sp\u00e9ciale de Klipper n'est possible et les fonctionnalit\u00e9s avanc\u00e9es de Klipper d\u00e9crites dans ce document ne sont pas disponibles. En plus de ce document, veillez \u00e0 consulter la r\u00e9f\u00e9rence de configuration du pilote TMC .","title":"Pilotes de moteur pas \u00e0 pas TMC"},{"location":"TMC_Drivers.html#reglage-du-courant-du-moteur","text":"Un courant de commande plus \u00e9lev\u00e9 augmente la pr\u00e9cision de positionnement et le couple. Cependant, un courant plus \u00e9lev\u00e9 augmente \u00e9galement la chaleur produite par le moteur pas \u00e0 pas et le pilote du moteur pas \u00e0 pas. Si le pilote du moteur pas \u00e0 pas devient trop chaud, il se d\u00e9sactivera et Klipper signalera une erreur. Si le moteur pas \u00e0 pas devient trop chaud, il perd du couple et de la pr\u00e9cision de positionnement. (S'il devient tr\u00e8s chaud, il peut \u00e9galement faire fondre les pi\u00e8ces en plastique qui y sont attach\u00e9es ou \u00e0 proximit\u00e9.) Comme conseil de r\u00e9glage g\u00e9n\u00e9ral : pr\u00e9f\u00e9rez des valeurs de courant plus \u00e9lev\u00e9es tant que le moteur pas \u00e0 pas ne chauffe pas trop et que le pilote du moteur pas \u00e0 pas ne signale pas d'avertissements ou d'erreurs. En g\u00e9n\u00e9ral, il est normal que le moteur pas \u00e0 pas soit chaud, mais il ne doit pas devenir si chaud qu'il soit douloureux au toucher.","title":"R\u00e9glage du courant du moteur"},{"location":"TMC_Drivers.html#ne-specifiez-pas-de-hold_current","text":"Si l'on configure un hold_current , le pilote TMC peut r\u00e9duire le courant vers le moteur pas \u00e0 pas lorsqu'il d\u00e9tecte que le moteur pas \u00e0 pas ne bouge pas. Cependant, la modification du courant du moteur peut elle-m\u00eame introduire un mouvement du moteur. Cela peut se produire en raison de \"forces de d\u00e9tente\" dans le moteur pas \u00e0 pas (l'aimant permanent du rotor tire vers les dents en fer du stator) ou en raison de forces externes sur le chariot d'axe. La plupart des moteurs pas \u00e0 pas ne fonctionneront pas mieux en r\u00e9duisant le courant pendant les impressions normales, car peu de mouvements d'impression laisseront un moteur pas \u00e0 pas inactif suffisamment longtemps pour activer la fonction hold_current . Et, il est peu probable que l'on veuille introduire des artefacts d'impression dans les quelques mouvements d'impression qui laissent un stepper inactif suffisamment longtemps. Si l'on souhaite r\u00e9duire le courant vers les moteurs pendant les routines de d\u00e9marrage d'impression, envisagez d'\u00e9mettre des commandes SET_TMC_CURRENT dans une MACRO START_PRINT pour ajuster le courant avant et apr\u00e8s les mouvements d'impression normaux. Certaines imprimantes avec des moteurs Z d\u00e9di\u00e9s qui sont inactifs pendant les mouvements d'impression normaux (pas de bed_mesh, pas de bed_tilt, pas de Z skew_correction, pas d'impressions en \"mode vase\", etc.) peuvent constater que les moteurs Z fonctionnent plus froid avec un hold_current . Si vous l'impl\u00e9mentez, assurez-vous de prendre en compte ce type de mouvement non command\u00e9 de l'axe Z pendant le nivellement du lit, le sondage du lit, l'\u00e9talonnage de la sonde, etc. Le driver_TPOWERDOWN et le driver_IHOLDDELAY doivent \u00e9galement \u00eatre calibr\u00e9s en cons\u00e9quence. En cas de doute, pr\u00e9f\u00e9rez ne pas sp\u00e9cifier de hold_current .","title":"Ne sp\u00e9cifiez pas de hold_current"},{"location":"TMC_Drivers.html#reglage-du-mode-spreadcycle-vs-stealthchop","text":"Par d\u00e9faut, Klipper place les pilotes TMC en mode \"spreadCycle\". Si le pilote prend en charge \"stealthChop\", il peut \u00eatre activ\u00e9 en ajoutant stealthchop_threshold : 999999 \u00e0 la section de configuration TMC. Le mode spreadCycle fournit un couple sup\u00e9rieur et une plus grande pr\u00e9cision de positionnement que le mode stealthChop. Cependant, le mode StealthChop peut produire un bruit audible nettement plus faible sur certaines imprimantes. Les tests comparant les modes ont montr\u00e9 un \"d\u00e9calage de position\" accru d'environ 75 % d'un pas complet lors de mouvements \u00e0 vitesse constante lors de l'utilisation du mode StealthChop (par exemple, sur une imprimante avec une distance de rotation de 40 mm et 200 pas_par_rotation, l'\u00e9cart de position des mouvements \u00e0 vitesse constante a augment\u00e9 de ~0,150 mm). Cependant, ce \"retard dans l'obtention de la position demand\u00e9e\" peut ne pas se manifester par un d\u00e9faut d'impression significatif et on peut pr\u00e9f\u00e9rer le comportement plus silencieux du mode StealthChop. Il est recommand\u00e9 de toujours utiliser le mode \"spreadCycle\" (en ne sp\u00e9cifiant pas stealthchop_threshold ) ou de toujours utiliser le mode \"stealthChop\" (en r\u00e9glant stealthchop_threshold sur 999999). Malheureusement, les pilotes produisent souvent des r\u00e9sultats m\u00e9diocres et erron\u00e9s si le mode est chang\u00e9 alors que le moteur tourne.","title":"R\u00e9glage du mode \"spreadCycle\" vs \"stealthChop\""},{"location":"TMC_Drivers.html#le-reglage-dinterpolation-tmc-introduit-un-petit-ecart-de-position","text":"Le param\u00e8tre interpolation du pilote TMC peut r\u00e9duire le bruit audible du mouvement de l'imprimante au prix de l'introduction d'une petite erreur de position syst\u00e9mique. Cette erreur de position syst\u00e9mique r\u00e9sulte du retard du conducteur \u00e0 ex\u00e9cuter les \"\u00e9tapes\" que Klipper lui envoie. Pendant les d\u00e9placements \u00e0 vitesse constante, ce retard entra\u00eene une erreur de position de pr\u00e8s d'un demi-micropas configur\u00e9 (plus pr\u00e9cis\u00e9ment, l'erreur est d'une demi-distance de micropas moins un 512e de distance d'un pas complet). Par exemple, sur un axe avec une rotation_distance de 40 mm, 200 pas_par_rotation et 16 micropas, l'erreur syst\u00e9mique introduite lors des mouvements \u00e0 vitesse constante est d'environ 0,006 mm. Pour une meilleure pr\u00e9cision de positionnement, envisagez d'utiliser le mode spreadCycle et d\u00e9sactivez l'interpolation (d\u00e9finissez interpolate : False dans la configuration du pilote TMC). Lorsqu'il est configur\u00e9 de cette fa\u00e7on, on peut augmenter le param\u00e8tre microstep pour r\u00e9duire le bruit audible pendant le mouvement pas \u00e0 pas. En r\u00e8gle g\u00e9n\u00e9rale, un r\u00e9glage de micropas de 64 ou 128 aura un bruit audible similaire \u00e0 celui de l'interpolation, et ce, sans introduire d'erreur de position syst\u00e9mique. Si vous utilisez le mode StealthChop, l'impr\u00e9cision de position due \u00e0 l'interpolation est faible par rapport \u00e0 l'impr\u00e9cision de position introduite \u00e0 partir du mode StealthChop. Par cons\u00e9quent, le r\u00e9glage de l'interpolation n'est pas consid\u00e9r\u00e9e comme utile en mode StealthChop, et on peut laisser l'interpolation dans son \u00e9tat par d\u00e9faut.","title":"Le r\u00e9glage d'interpolation TMC introduit un petit \u00e9cart de position"},{"location":"TMC_Drivers.html#mise-a-lorigine-sans-capteur","text":"La mise \u00e0 l'origine ans capteur permet de r\u00e9f\u00e9rencer un axe sans avoir besoin d'une fin de course physique. Au lieu de cela, le chariot sur l'axe est d\u00e9plac\u00e9 dans la limite m\u00e9canique, ce qui fait perdre des pas au moteur pas \u00e0 pas. Le pilote pas \u00e0 pas d\u00e9tecte les pas perdus et l'indique au MCU de contr\u00f4le (Klipper) en basculant une broche. Cette information peut \u00eatre utilis\u00e9e par Klipper comme fin de course pour l'axe. Ce guide couvre la configuration de la mise \u00e0 l'origine sans capteur pour l'axe X de votre imprimante (cart\u00e9sienne). Cependant, cela fonctionne de la m\u00eame mani\u00e8re avec tous les autres axes (qui n\u00e9cessitent une fin de course). Vous devez le configurer et le r\u00e9gler pour un axe \u00e0 la fois.","title":"Mise \u00e0 l'origine sans capteur"},{"location":"TMC_Drivers.html#limites","text":"Assurez-vous que vos composants m\u00e9caniques sont capables de supporter la charge du chariot heurtant \u00e0 plusieurs reprises la fin de course de l'axe. Les vis sans fin, en particulier, peuvent g\u00e9n\u00e9rer beaucoup de force. La prise d'origine d'un axe Z en \u00e9crasant la buse dans la surface d'impression n'est peut-\u00eatre pas une bonne id\u00e9e. Pour de meilleurs r\u00e9sultats, v\u00e9rifiez que le chariot de l'axe \u00e9tablit un contact lors de la mise \u00e0 l'origine. De plus, la mise \u00e0 l'origine sans capteur peut ne pas \u00eatre suffisamment pr\u00e9cise pour votre imprimante. Bien que la mise \u00e0 l'origine des axes X et Y sur une machine cart\u00e9sienne puisse bien fonctionner, la prise d'origine de l'axe Z n'est g\u00e9n\u00e9ralement pas assez pr\u00e9cise et peut entra\u00eener une hauteur de premi\u00e8re couche incoh\u00e9rente. Le r\u00e9f\u00e9rencement d'une imprimante delta sans capteur n'est pas conseill\u00e9 en raison du manque de pr\u00e9cision. De plus, la d\u00e9tection de d\u00e9crochage du pilote pas \u00e0 pas d\u00e9pend de la charge m\u00e9canique sur le moteur, du courant du moteur et de la temp\u00e9rature du moteur (r\u00e9sistance de la bobine). La mise \u00e0 l'origine sans capteur fonctionne mieux \u00e0 des vitesses de moteur moyennes. Pour des vitesses tr\u00e8s lentes (moins de 10 tr/min), le moteur ne g\u00e9n\u00e8re pas de force contre-\u00e9lectromotrice significative et le TMC ne peut pas d\u00e9tecter de mani\u00e8re fiable les calages du moteur. A des vitesses tr\u00e8s \u00e9lev\u00e9es, la force contre-\u00e9lectromotrice du moteur se rapproche de la tension d'alimentation du moteur, de sorte que le TMC ne peut plus d\u00e9tecter les calages. Il est conseill\u00e9 de consulter la fiche technique de vos TMC sp\u00e9cifiques. Vous y trouverez \u00e9galement plus de d\u00e9tails sur les limites de cette configuration.","title":"Limites"},{"location":"TMC_Drivers.html#conditions-prealables","text":"Quelques pr\u00e9requis sont n\u00e9cessaires pour utiliser la mise \u00e0 l'origine sans capteur : Un pilote pas \u00e0 pas TMC compatible stallGuard (tmc2130, tmc2209, tmc2660 ou tmc5160). Interface SPI/UART du driver TMC c\u00e2bl\u00e9 au micro-contr\u00f4leur (le mode autonome ne fonctionne pas). La broche \"DIAG\" ou \"SG_TST\" appropri\u00e9e du pilote TMC doit \u00eatre connect\u00e9e au microcontr\u00f4leur. Les \u00e9tapes du document v\u00e9rification de la configuration doivent \u00eatre ex\u00e9cut\u00e9es pour confirmer que les moteurs pas \u00e0 pas sont configur\u00e9s et fonctionnent correctement.","title":"Conditions pr\u00e9alables"},{"location":"TMC_Drivers.html#reglages","text":"La proc\u00e9dure d\u00e9crite ici comporte six \u00e9tapes principales : Choisissez une vitesse de mise \u00e0 l'origine. Configurez le fichier printer.cfg pour activer la mise \u00e0 l'origine sans capteur. Trouvez le meilleur r\u00e9glage anti-d\u00e9crochage avec la sensibilit\u00e9 la plus \u00e9lev\u00e9e. Trouvez le r\u00e9glage anti-d\u00e9crochage avec la sensibilit\u00e9 la plus faible qui fonctionne avec une seule touche en fin de course. Mettez \u00e0 jour le fichier printer.cfg avec le param\u00e8tre anti-d\u00e9crochage souhait\u00e9. Cr\u00e9ez ou mettez \u00e0 jour les macros dans printer.cfg pour une mise \u00e0 l'origine r\u00e9p\u00e9table.","title":"R\u00e9glages"},{"location":"TMC_Drivers.html#choisir-la-vitesse-de-prise-dorigine","text":"La vitesse de mise \u00e0 l'origine est importante lors de la r\u00e9alisation d'une mise \u00e0 l'origine sans capteur. Il est souhaitable d'utiliser une vitesse de prise d'origine lente afin que le chariot n'exerce pas de force excessive sur le ch\u00e2ssis lorsqu'il entre en contact avec l'extr\u00e9mit\u00e9 du rail. Cependant, les pilotes TMC ne peuvent pas d\u00e9tecter de mani\u00e8re fiable un d\u00e9crochage \u00e0 des vitesses tr\u00e8s lentes. Un bon point de d\u00e9part pour la vitesse de prise d'origine est que le moteur pas \u00e0 pas effectue une rotation compl\u00e8te toutes les deux secondes. Pour de nombreux axes, ce sera la distance rotation_distance divis\u00e9e par deux. Par example\u202f: [stepper_x] rotation_distance: 40 homing_speed: 20 ...","title":"Choisir la vitesse de prise d'origine"},{"location":"TMC_Drivers.html#configurer-printercfg-pour-une-mise-a-lorigine-sans-capteur","text":"Le param\u00e8tre homing_retract_dist doit \u00eatre d\u00e9fini sur z\u00e9ro dans la section de configuration stepper_x pour d\u00e9sactiver le deuxi\u00e8me mouvement de mise \u00e0 l'origine. La deuxi\u00e8me tentative de mise \u00e0 l'origine n'ajoute pas de valeur lors de l'utilisation d'une mise \u00e0 l'origine sans capteur, elle ne fonctionnera pas de mani\u00e8re fiable et introduira des erreurs dans le processus de r\u00e9glage. Assurez-vous que le param\u00e8tre hold_current n\u2019est pas sp\u00e9cifi\u00e9 dans la section Pilote TMC de la configuration. (Si un hold_current est r\u00e9gl\u00e9, le moteur s\u2019arr\u00eate lorsque le chariot est appuy\u00e9 contre l\u2019extr\u00e9mit\u00e9 du rail, et la r\u00e9duction du courant dans cette position peut entra\u00eener le d\u00e9placement du chariot - ce qui entra\u00eenera de mauvaises performances et perturbera le processus de r\u00e9glage.) Il est n\u00e9cessaire de configurer les broches du TMC pour le mode sans capteur et de configurer les param\u00e8tres initiaux de \u00ab Stallguard \u00bb. Un exemple de configuration tmc2209 pour un axe X pourrait ressembler \u00e0 : [tmc2209 stepper_x] diag_pin: ^PA1 # D\u00e9finit pour le MCU, la broche TMC DIAG driver_SGTHRS: 255 # 255 est la valeur la plus sensible, 0 la moins sensible ... [stepper_x] endstop_pin: tmc2209_stepper_x:virtual_endstop homing_retract_dist: 0 ... Un exemple de configuration de tmc2130 ou tmc5160 pourrait ressembler \u00e0 : [tmc2130 stepper_x] diag1_pin: ^!PA1 # Broche connect\u00e9e \u00e0 TMC DIAG1 (ou utilisez diag0_pin / DIAG0 pin) driver_SGT: -64 # -64 est la valeur la plus sensible, 63 est moins sensible ... [stepper_x] endstop_pin: tmc2130_stepper_x:virtual_endstop homing_retract_dist: 0 ... Un exemple de configuration de tmc2660 pourrait ressembler \u00e0 : [tmc2660 stepper_x] driver_SGT: -64 # -64 est la valeur la plus sensible,, 63 est moins sensible ... [stepper_x] endstop_pin: ^PA1 # Broche connect\u00e9e \u00e0 TMC SG_TST homing_retract_dist: 0 ... Les exemples ci-dessus ne montrent que les param\u00e8tres sp\u00e9cifiques \u00e0 la mise \u00e0 l'origine sans capteur. Voir la r\u00e9f\u00e9rence de configuration pour toutes les options disponibles.","title":"Configurer 'printer.cfg' pour une mise \u00e0 l'origine sans capteur"},{"location":"TMC_Drivers.html#trouvez-la-sensibilite-la-plus-elevee-qui-fonctionne-avec-succes","text":"Placez le chariot pr\u00e8s du centre du rail. Utilisez la commande SET_TMC_FIELD pour d\u00e9finir la sensibilit\u00e9 la plus \u00e9lev\u00e9e. Pour un tmc2209 : SET_TMC_FIELD STEPPER=stepper_x FIELD=SGTHRS VALUE=255 Pour un tmc2130, tmc5160 et tmc2660 : SET_TMC_FIELD STEPPER=stepper_x FIELD=sgt VALUE=-64 \u00c9mettez ensuite une commande G28 X0 et v\u00e9rifiez que l'axe ne bouge pas du tout ou s'arr\u00eate rapidement. Si l'axe ne s'arr\u00eate pas, \u00e9mettez un M112 pour arr\u00eater l'imprimante - quelque chose n'est pas correct avec le c\u00e2blage ou la configuration de la broche diag/sg_tst et ce doit \u00eatre corrig\u00e9 avant de continuer. Ensuite, diminuez continuellement la sensibilit\u00e9 du param\u00e8tre VALUE et ex\u00e9cutez \u00e0 nouveau les commandes SET_TMC_FIELD G28 X0 pour trouver la sensibilit\u00e9 la plus \u00e9lev\u00e9e qui permet au chariot de se d\u00e9placer et de s'arr\u00eater en but\u00e9e. (Pour les pilotes tmc2209, cela diminuera SGTHRS, pour les autres pilotes, cela augmentera sgt.). Il devrait \u00eatre possible de trouver la sensibilit\u00e9 la plus \u00e9lev\u00e9e et fiable (les r\u00e9glages avec une sensibilit\u00e9 plus \u00e9lev\u00e9e entra\u00eenant peu ou pas de mouvement). Notez la valeur trouv\u00e9e comme maximum_sensitivity . (Si la sensibilit\u00e9 minimale possible (SGTHRS = 0 ou sgt = 63) est obtenue sans aucun mouvement du chariot, alors quelque chose ne fonctionne pas aun niveau c\u00e2blage ou configuration de la broche diag/sg_tst et il faut corriger le probl\u00e8me avant de continuer.) Lors de la recherche de maximum_sensitivity, il peut \u00eatre pratique de passer \u00e0 diff\u00e9rents param\u00e8tres VALUE (travaillez le param\u00e8tre VALUE par dichotomie pour plus d'efficacit\u00e9). Si vous proc\u00e9dez ainsi, pr\u00e9parez-vous \u00e0 \u00e9mettre une commande M112 pour arr\u00eater l'imprimante, car un r\u00e9glage avec une sensibilit\u00e9 trop faible peut entra\u00eener un \"cognement\" r\u00e9p\u00e9t\u00e9 de l'axe contre l'extr\u00e9mit\u00e9 du rail. Assurez-vous d'attendre quelques secondes entre chaque tentative de prise d'origine. Une fois que le pilote TMC a d\u00e9tect\u00e9 un d\u00e9crochage, il peut lui falloir un peu de temps pour effacer son indicateur interne et \u00eatre capable de d\u00e9tecter un autre d\u00e9crochage. Au cours de ces tests de r\u00e9glage, si une commande G28 X0 ne se d\u00e9place pas jusqu'\u00e0 la limite d'axe, soyez prudent lorsque vous ex\u00e9cutez des commandes de mouvement 'normales' (par exemple, G1 ). Klipper ne sachant pas ou est le chariot, une commande de d\u00e9placement pourra entra\u00eener des r\u00e9sultats ind\u00e9sirables.","title":"Trouvez la sensibilit\u00e9 la plus \u00e9lev\u00e9e qui fonctionne avec succ\u00e8s"},{"location":"TMC_Drivers.html#trouver-la-sensibilite-la-plus-basse-qui-permette-la-mise-a-lorigine-en-une-seule-fois","text":"Lors de la mise \u00e0 l'origine avec la valeur maximum_sensitivity , l'axe doit se d\u00e9placer jusqu'\u00e0 l'extr\u00e9mit\u00e9 du rail et s'arr\u00eater avec un \u00ab simple toucher \u00bb - c'est-\u00e0-dire qu'il ne doit pas y avoir de \u00ab clic \u00bb ou de \u00ab claquement \u00bb. (S'il y a un bruit de claquement ou de clic \u00e0 la sensibilit\u00e9 maximale, la vitesse de mise \u00e0 l'origine est peut-\u00eatre trop faible, le courant du pilote peut \u00eatre trop faible ou la mise \u00e0 l'origine sans capteur n'est peut-\u00eatre pas un bon choix pour cet axe.) L'\u00e9tape suivante consiste \u00e0 nouveau \u00e0 d\u00e9placer le chariot vers une position proche du centre du rail, \u00e0 diminuer la sensibilit\u00e9 et \u00e0 ex\u00e9cuter les commandes SET_TMC_FIELD G28 X0 - l'objectif est maintenant de trouver la sensibilit\u00e9 la plus faible qui permette au chariot de se mettre \u00e0 l'origine correctement avec une \"simple touche\". C'est-\u00e0-dire qu'il ne \"cogne\" pas ou ne \"clique\" pas lorsqu'il entre en contact avec l'extr\u00e9mit\u00e9 du rail. Notez la valeur trouv\u00e9e comme minimum_sensitivity .","title":"Trouver la sensibilit\u00e9 la plus basse qui permette la mise \u00e0 l'origine en une seule fois"},{"location":"TMC_Drivers.html#mettez-a-jour-printercfg-avec-la-valeur-de-sensibilite","text":"Apr\u00e8s avoir trouv\u00e9 maximum_sensitivity et minimum_sensitivity , utilisez une calculatrice pour obtenir la sensibilit\u00e9 recommand\u00e9e : minimum_sensitivity + (maximum_sensitivity - minimum_sensitivity)/3 . La sensibilit\u00e9 recommand\u00e9e doit \u00eatre comprise entre le minimum et le maximum, mais l\u00e9g\u00e8rement plus proche du minimum. Arrondissez la valeur finale \u00e0 la valeur enti\u00e8re la plus proche. Pour un tmc2209, d\u00e9finissez-le dans la configuration en tant que driver_SGTHRS , pour les autres pilotes TMC, d\u00e9finissez-le dans la configuration en tant que driver_SGT . Si la plage entre maximum_sensitivity et minimum_sensitivity est petite (par exemple, inf\u00e9rieure \u00e0 5), cela peut entra\u00eener une mise \u00e0 l'origine instable. Une vitesse de mise \u00e0 l'origine plus rapide peut rendre l'op\u00e9ration plus stable. Notez que si une modification est apport\u00e9e au courant du pilote, \u00e0 la vitesse de prise d'origine ou si une modification notable est apport\u00e9e au mat\u00e9riel de l'imprimante, il sera alors n\u00e9cessaire de refaire le processus de r\u00e9glage.","title":"Mettez \u00e0 jour printer.cfg avec la valeur de sensibilit\u00e9"},{"location":"TMC_Drivers.html#utilisation-de-macros-lors-de-la-mise-a-lorigine","text":"Une fois la mise \u00e0 l'origine sans capteur termin\u00e9e, le chariot sera appuy\u00e9 contre l'extr\u00e9mit\u00e9 du rail et le stepper exercera une force sur le cadre tant que le chariot ne sera pas \u00e9loign\u00e9 de la fin de course. Il est pr\u00e9f\u00e9rable de cr\u00e9er une macro pour positionner l'axe en but\u00e9e et l'\u00e9loigner imm\u00e9diatement de l'extr\u00e9mit\u00e9 du rail. Il est pr\u00e9f\u00e9rable, dans la macro, de faire une pause d'au moins 2 secondes avant de commencer la prise d'origine sans capteur (ou de s'assurer qu'il n'y a eu aucun mouvement sur le moteur pas \u00e0 pas depuis au moins 2 secondes). Sans d\u00e9lai, il est possible que le drapeau de d\u00e9crochage interne du pilote de moteur pas \u00e0 pas soit toujours activ\u00e9 suite \u00e0 un mouvement pr\u00e9c\u00e9dent. Il peut \u00e9galement \u00eatre utile que cette macro d\u00e9finisse le courant du pilote avant la prise d'origine et d\u00e9finisse un nouveau courant apr\u00e8s que le chariot s'est \u00e9loign\u00e9. Un exemple de macro pourrait ressembler \u00e0 : [gcode_macro SENSORLESS_HOME_X] gcode: {% set HOME_CUR = 0.700 %} {% set driver_config = printer.configfile.settings['tmc2209 stepper_x'] %} {% set RUN_CUR = driver_config.run_current %} # D\u00e9finir le courant pour la mise \u00e0 l'origine sans capteur SET_TMC_CURRENT STEPPER=stepper_x CURRENT={HOME_CUR} # Petit pause pour attendre que le drapeau stall flag soit d\u00e9sactiv\u00e9 G4 P2000 # mise \u00e0 l'origine G28 X0 # D\u00e9placement G90 G1 X5 F1200 # Remise du courant d'impression SET_TMC_CURRENT STEPPER=stepper_x CURRENT={RUN_CUR} La macro peut \u00eatre appel\u00e9e depuis une section de configuration homing_override ou depuis une macro START_PRINT . Notez que si le courant du pilote pas \u00e0 pas lors de la mise \u00e0 l'origine est modifi\u00e9, le processus de r\u00e9glage doit \u00eatre enti\u00e8rement refait.","title":"Utilisation de macros lors de la mise \u00e0 l'origine"},{"location":"TMC_Drivers.html#conseils-pour-la-mise-a-lorigine-sans-capteur-sur-corexy","text":"Il est possible d'utiliser la mise \u00e0 l'origine sans capteur sur les chariots X et Y d'une imprimante CoreXY. Klipper utilise le stepper [stepper_x] pour d\u00e9tecter les d\u00e9crochages lors de la mise \u00e0 l'origine du chariot X et utilise le stepper [stepper_y] pour d\u00e9tecter les d\u00e9crochages lors de la mise \u00e0 l'origine du chariot Y. Utilisez le guide de r\u00e9glage d\u00e9crit ci-dessus pour trouver la \"sensibilit\u00e9 au d\u00e9crochage\" appropri\u00e9e pour chaque chariot, mais soyez conscient des restrictions suivantes : Lors de l'utilisation de la prise d'origine sans capteur sur CoreXY, assurez-vous qu'aucun hold_current n'est configur\u00e9 pour l'un ou l'autre des moteurs pas \u00e0 pas. Pendant le r\u00e9glage, assurez-vous que les chariots X et Y sont proches du centre de leurs rails avant chaque tentative de mise \u00e0 l'origine. Une fois les r\u00e9glages termin\u00e9s, lors de la prise d'origine de X et Y, utilisez des macros pour vous assurer qu'un axe est pris en charge en premier, puis \u00e9loignez ce chariot de la fin de course de l'axe, faites une pause d'au moins 2 secondes, puis d\u00e9marrez la prise d'origine de l'autre axe. L'\u00e9loignement de l'axe \u00e9vite le r\u00e9f\u00e9rencement d'un axe alors que l'autre est plaqu\u00e9 contre la fin de course (ce qui peut fausser la d\u00e9tection de d\u00e9crochage). La pause est n\u00e9cessaire pour s'assurer que le drapeau de d\u00e9crochage du pilote pas \u00e0 pas est effac\u00e9 avant de se d\u00e9placer \u00e0 nouveau. Un exemple de macro de r\u00e9f\u00e9rencement CoreXY pourrait ressembler \u00e0 : [gcode_macro HOME] gcode: G90 # mise \u00e0 l'origine Z G28 Z0 G1 Z10 F1200 # mise \u00e0 l'origine Y G28 Y0 G1 Y5 F1200 # mise \u00e0 l'origine X G4 P2000 G28 X0 G1 X5 F1200","title":"Conseils pour la mise \u00e0 l'origine sans capteur sur CoreXY"},{"location":"TMC_Drivers.html#interroger-et-diagnostiquer-les-informations-du-pilote-pas-a-pas","text":"La ` commande DUMP_TMC est un outil utile lors de la configuration et du diagnostic des pilotes. Il signalera tous les champs configur\u00e9s par Klipper ainsi que tous les champs pouvant \u00eatre interrog\u00e9s \u00e0 partir du pilote. Tous les champs signal\u00e9s sont d\u00e9finis dans la fiche technique de Trinamic pour chaque pilote. Ces fiches techniques sont disponibles sur le site Internet de Trinamic . Obtenez et examinez la fiche technique de Trinamic du pilote pas \u00e0 pas afin d'interpr\u00e9ter correctement les r\u00e9sultats d'un DUMP_TMC.","title":"Interroger et diagnostiquer les informations du pilote pas \u00e0 pas"},{"location":"TMC_Drivers.html#configuration-des-parametres-dun-driver_xxx","text":"Klipper prend en charge la configuration de nombreux param\u00e8tres de bas niveau pour les pilotes de moteurs pas \u00e0 pas \u00e0 l'aide des param\u00e8tres de la section driver_XXX . La r\u00e9f\u00e9rence de configuration du pilote TMC contient la liste compl\u00e8te des param\u00e8tres disponibles pour chaque type de pilote. De plus, presque tous les champs peuvent \u00eatre modifi\u00e9s au moment de l'ex\u00e9cution \u00e0 l'aide de la commande SET_TMC_FIELD . Chacun de ces param\u00e8tres est d\u00e9fini dans la fiche technique de Trinamic pour chaque pilote. Ces fiches techniques sont disponibles sur le site Internet de Trinamic . Les fiches techniques de Trinamic utilisent parfois une formulation qui peut confondre un param\u00e8tre de haut niveau (tel que \"fin d'hyst\u00e9r\u00e9sis\") avec une valeur de param\u00e8tre de bas niveau (par exemple, \"HEND\"). Dans Klipper, driver_XXX et SET_TMC_FIELD d\u00e9finissent toujours la valeur de param\u00e8tres de bas niveau (celles qui sontt r\u00e9ellement \u00e9crite dans le pilote). Ainsi, par exemple, si la fiche technique Trinamic indique qu'une valeur de 3 doit \u00eatre \u00e9crite dans le champ HEND pour obtenir une \"fin d'hyst\u00e9r\u00e9sis\" de 0, alors d\u00e9finissez driver_HEND=3 pour obtenir une valeur de haut niveau de 0.","title":"Configuration des param\u00e8tres d'un 'driver_XXX'"},{"location":"TMC_Drivers.html#questions-courantes","text":"","title":"Questions courantes"},{"location":"TMC_Drivers.html#puis-je-utiliser-le-mode-stealthchop-sur-une-extrudeuse-avec-avance-de-pression","text":"Beaucoup de gens utilisent avec succ\u00e8s le mode \"stealthChop\" avec l'avance de pression de Klipper. Klipper impl\u00e9mente avance de pression \"adoucie\" qui n'introduit aucun changement de vitesse instantan\u00e9. Cependant, le mode \"stealthChop\" peut produire un couple moteur plus faible et/ou produire une chaleur moteur plus \u00e9lev\u00e9e. Il peut s'agir ou non d'un mode utilisable avec votre imprimante.","title":"Puis-je utiliser le mode StealthChop sur une extrudeuse avec avance de pression\u00a0?"},{"location":"TMC_Drivers.html#jai-des-erreurs-unable-to-read-tmc-uart-stepper_x-register-ifcnt","text":"Cela se produit lorsque Klipper est incapable de communiquer avec un pilote tmc2208 ou tmc2209. Assurez-vous que l'alimentation du moteur est activ\u00e9e, car le pilote du moteur pas \u00e0 pas a g\u00e9n\u00e9ralement besoin de l'alimentation du moteur avant de pouvoir communiquer avec le micro-contr\u00f4leur. Si cette erreur se produit apr\u00e8s avoir flash\u00e9 Klipper pour la premi\u00e8re fois, le pilote pas \u00e0 pas peut avoir \u00e9t\u00e9 pr\u00e9c\u00e9demment programm\u00e9 dans un \u00e9tat qui n'est pas compatible avec Klipper. Pour r\u00e9initialiser l'\u00e9tat, coupez toute alimentation de l'imprimante pendant plusieurs secondes (d\u00e9branchez physiquement les prises USB et d'alimentation). Sinon, cette erreur est souvent due \u00e0 un c\u00e2blage incorrect des broche UART ou d'une configuration incorrecte des param\u00e8tres de broche UART dans Klipper.","title":"J'ai des erreurs \"Unable to read tmc uart 'stepper_x' register IFCNT\" ?"},{"location":"TMC_Drivers.html#jai-des-erreurs-unable-to-write-tmc-spi-stepper_x-register","text":"Cela se produit lorsque Klipper est incapable de communiquer avec un pilote tmc2130 ou tmc5160. Assurez-vous que l'alimentation du moteur est activ\u00e9e, car le pilote du moteur pas \u00e0 pas a g\u00e9n\u00e9ralement besoin de l'alimentation du moteur avant de pouvoir communiquer avec le micro-contr\u00f4leur. Cette erreur est souvent due \u00e0 un c\u00e2blage SPI incorrect, \u00e0 une configuration incorrecte des param\u00e8tres SPI de Klipper ou d'une configuration incompl\u00e8te des p\u00e9riph\u00e9riques sur un bus SPI. Si le pilote se trouve sur un bus SPI partag\u00e9 avec plusieurs p\u00e9riph\u00e9riques, assurez-vous de configurer - dans Klipper - chaque p\u00e9riph\u00e9rique sur ce bus SPI. Si un appareil sur un bus SPI partag\u00e9 n'est pas configur\u00e9, il peut r\u00e9pondre de mani\u00e8re incorrecte \u00e0 des commandes qui ne lui sont pas destin\u00e9es et corrompre la communication avec l'appareil pr\u00e9vu. S'il y a un appareil sur un bus SPI partag\u00e9 qui ne peut pas \u00eatre configur\u00e9 dans Klipper, utilisez la section de configuration static_digital_output pour r\u00e9gler la broche CS de l'appareil inutilis\u00e9 \u00e0 un niveau \u00e9lev\u00e9 (afin qu'il n'essaie pas d'utiliser le bus SPI). Le sch\u00e9ma de la carte est une r\u00e9f\u00e9rence utile (ndt et n\u00e9cessaire) pour trouver les p\u00e9riph\u00e9riques qui se trouvent sur un bus SPI et leurs broches associ\u00e9es.","title":"J'ai des erreurs \"Unable to write tmc spi 'stepper_x' register ...\" ?"},{"location":"TMC_Drivers.html#pourquoi-ai-je-une-erreur-tmc-reports-error","text":"Ce type d'erreur indique que le pilote TMC a d\u00e9tect\u00e9 un probl\u00e8me et s'est d\u00e9sactiv\u00e9. C'est-\u00e0-dire que le pilote de moteur pas \u00e0 pas a cess\u00e9 de maintenir sa position et a ignor\u00e9 les commandes de mouvement. Si Klipper d\u00e9tecte qu'un pilote actif s'est d\u00e9sactiv\u00e9, il fera passer l'imprimante dans un \u00e9tat \"arr\u00eat\". Il est \u00e9galement possible qu'un arr\u00eat TMC reports error se produise en raison d'erreurs SPI qui emp\u00eachent la communication avec le pilote (sur les tmc2130, tmc5160 ou tmc2660). Si cela se produit, il est fr\u00e9quent que l'\u00e9tat du pilote indiqu\u00e9 affiche 00000000 ou ffffffff - par exemple : TMC reports error : DRV_STATUS : ffffffff ... OU [ X316X]TMC reports error : READRSP@RDSEL2 : 00000000 ...`. Une telle d\u00e9faillance peut \u00eatre due \u00e0 un probl\u00e8me de c\u00e2blage SPI ou \u00e0 une r\u00e9initialisation automatique ou \u00e0 une d\u00e9faillance du pilote TMC. Quelques erreurs courantes et conseils pour les diagnostiquer :","title":"Pourquoi ai-je une erreur \"TMC reports error\u202f: ...\"\u202f?"},{"location":"TMC_Drivers.html#tmc-signale-une-erreur-ot1overtemperror","text":"Cela indique que le pilote du moteur s'est d\u00e9sactiv\u00e9 car il est en surchauffe. Les solutions typiques consistent \u00e0 diminuer le courant du pilote de moteur pas \u00e0 pas, \u00e0 augmenter le refroidissement du pilote du moteur pas \u00e0 pas et/ou \u00e0 augmenter le refroidissement du pilote du moteur pas \u00e0 pas.","title":"TMC signale une erreur\u00a0: ... ot=1(OvertempError\u00a0!)"},{"location":"TMC_Drivers.html#tmc-signale-une-erreur-shorttognd-ou-lowsideshort","text":"Cela indique que le pilote s'est d\u00e9sactiv\u00e9 car il a d\u00e9tect\u00e9 un courant tr\u00e8s \u00e9lev\u00e9 le traversant. Cela peut indiquer un fil desserr\u00e9 ou court-circuit\u00e9 vers le moteur pas \u00e0 pas ou dans le moteur pas \u00e0 pas lui-m\u00eame. Cette erreur peut \u00e9galement se produire si vous utilisez le mode StealthChop et que le pilote TMC n'est pas en mesure de pr\u00e9dire avec pr\u00e9cision la charge m\u00e9canique du moteur. (Si le pilote fait une mauvaise pr\u00e9diction, il peut envoyer trop de courant \u00e0 travers le moteur et d\u00e9clencher sa propre d\u00e9tection de surintensit\u00e9.) Pour tester cela, d\u00e9sactivez le mode StealthChop et v\u00e9rifiez si les erreurs continuent de se produire.","title":"TMC signale une erreur\u00a0: ... ShortToGND OU LowSideShort"},{"location":"TMC_Drivers.html#tmc-signale-une-erreur-reset1reset-or-cs_actual0reset-or-se0reset","text":"Cela indique que le pilote s'est r\u00e9initialis\u00e9 en cours d'impression. Cela peut \u00eatre d\u00fb \u00e0 des probl\u00e8mes de tension ou de c\u00e2blage.","title":"TMC signale une erreur\u00a0: ... reset=1(Reset) OR CS_ACTUAL=0(Reset\u00a0?) OR SE=0(Reset?)"},{"location":"TMC_Drivers.html#tmc-signale-une-erreur-uv_cp1sous-tension","text":"Cela indique que le pilote a d\u00e9tect\u00e9 un \u00e9v\u00e9nement de basse tension et s'est d\u00e9sactiv\u00e9. Cela peut \u00eatre d\u00fb \u00e0 des probl\u00e8mes de c\u00e2blage ou d'alimentation.","title":"TMC signale une erreur\u00a0: ... uv_cp=1(Sous-tension\u00a0!)"},{"location":"TMC_Drivers.html#comment-regler-spreadcyclecoolstepetc-mode-sur-mes-pilotes","text":"Le site Web de Trinamic contient des guides sur la configuration des pilotes. Ces guides sont souvent techniques, de bas niveau et peuvent n\u00e9cessiter du mat\u00e9riel sp\u00e9cialis\u00e9. Quoi qu'il en soit, ils sont la meilleure source d'information.","title":"Comment r\u00e9gler spreadCycle/coolStep/etc. mode sur mes pilotes\u00a0?"},{"location":"TSL1401CL_Filament_Width_Sensor.html","text":"Capteur de largeur de filament TSL1401CL \u00b6 Ce document d\u00e9crit le module h\u00f4te du capteur de largeur de filament. Le mat\u00e9riel utilis\u00e9 pour d\u00e9velopper ce module h\u00f4te est bas\u00e9 sur le r\u00e9seau de capteurs lin\u00e9aires TSL1401CL, mais il peut fonctionner avec tout r\u00e9seau de capteurs ayant une sortie analogique. Vous pouvez trouver les conceptions sur Thingiverse . Pour utiliser un r\u00e9seau de capteurs comme capteur de largeur de filament, consultez Config Reference et documentation G-Code . Comment cela fonctionne-t-il ? \u00b6 Le capteur g\u00e9n\u00e8re une sortie analogique bas\u00e9e sur la largeur calcul\u00e9e du filament. La tension de sortie est toujours \u00e9gale \u00e0 la largeur de filament d\u00e9tect\u00e9e (ex. 1,65v, 1,70v, 3,0v). Le module h\u00f4te surveille les changements de tension et ajuste le multiplicateur d'extrusion. Note : \u00b6 Les lectures du capteur sont effectu\u00e9es par d\u00e9faut avec des intervalles de 10 mm. Si n\u00e9cessaire, vous pouvez modifier ce param\u00e8tre en modifiant le param\u00e8tre MEASUREMENT_INTERVAL_MM dans le fichier filament_width_sensor.py .","title":"Capteur de largeur de filament TSL1401CL"},{"location":"TSL1401CL_Filament_Width_Sensor.html#capteur-de-largeur-de-filament-tsl1401cl","text":"Ce document d\u00e9crit le module h\u00f4te du capteur de largeur de filament. Le mat\u00e9riel utilis\u00e9 pour d\u00e9velopper ce module h\u00f4te est bas\u00e9 sur le r\u00e9seau de capteurs lin\u00e9aires TSL1401CL, mais il peut fonctionner avec tout r\u00e9seau de capteurs ayant une sortie analogique. Vous pouvez trouver les conceptions sur Thingiverse . Pour utiliser un r\u00e9seau de capteurs comme capteur de largeur de filament, consultez Config Reference et documentation G-Code .","title":"Capteur de largeur de filament TSL1401CL"},{"location":"TSL1401CL_Filament_Width_Sensor.html#comment-cela-fonctionne-t-il","text":"Le capteur g\u00e9n\u00e8re une sortie analogique bas\u00e9e sur la largeur calcul\u00e9e du filament. La tension de sortie est toujours \u00e9gale \u00e0 la largeur de filament d\u00e9tect\u00e9e (ex. 1,65v, 1,70v, 3,0v). Le module h\u00f4te surveille les changements de tension et ajuste le multiplicateur d'extrusion.","title":"Comment cela fonctionne-t-il ?"},{"location":"TSL1401CL_Filament_Width_Sensor.html#note","text":"Les lectures du capteur sont effectu\u00e9es par d\u00e9faut avec des intervalles de 10 mm. Si n\u00e9cessaire, vous pouvez modifier ce param\u00e8tre en modifiant le param\u00e8tre MEASUREMENT_INTERVAL_MM dans le fichier filament_width_sensor.py .","title":"Note :"},{"location":"Using_PWM_Tools.html","text":"Utilisation des outils PWM \u00b6 Ce document d\u00e9crit comment configurer un laser ou une broche contr\u00f4l\u00e9e par PWM en utilisant output_pin et quelques macros. Comment \u00e7a marche ? \u00b6 En r\u00e9-utilisant la sortie pwm du ventilateur de la t\u00eate d'impression, vous pouvez contr\u00f4ler des lasers ou des broches. Ceci est utile si vous utilisez des t\u00eates d'impression commutables, par exemple le changeur d'outils E3D ou une solution DIY. Habituellement, les outils \u00e0 came tels que LaserWeb peuvent \u00eatre configur\u00e9s pour utiliser les commandes M3-M5 , qui correspondent \u00e0 vitesse de broche CW ( M3 S[0-255] ), vitesse de broche CCW ( M4 S[0-255] ) et arr\u00eat de broche ( M5 ). Avertissement : Lorsque vous pilotez un laser, prenez toutes les pr\u00e9cautions de s\u00e9curit\u00e9 auxquelles vous pouvez penser ! Les lasers \u00e0 diodes sont g\u00e9n\u00e9ralement invers\u00e9s. Cela signifie que lorsque l'unit\u00e9 centrale red\u00e9marre, le laser sera compl\u00e8tement allum\u00e9 pendant le temps n\u00e9cessaire \u00e0 l'unit\u00e9 centrale pour red\u00e9marrer. Pour faire bonne mesure, il est recommand\u00e9 de toujours porter des lunettes laser appropri\u00e9es de la bonne longueur d'onde si le laser est aliment\u00e9 ; et de d\u00e9connecter le laser lorsqu'il n'est pas n\u00e9cessaire. Vous devriez \u00e9galement configurer un d\u00e9lai de s\u00e9curit\u00e9, de sorte que lorsque votre h\u00f4te ou votre MCU rencontre une erreur, l'outil s'arr\u00eate. Pour un exemple de configuration, voir config/sample-pwm-tool.cfg . Limites actuelles \u00b6 La fr\u00e9quence des mises \u00e0 jour PWM est limit\u00e9e. Bien qu'elle soit tr\u00e8s pr\u00e9cise, une mise \u00e0 jour PWM ne peut se produire que toutes les 0,1 seconde, ce qui la rend presque inutile pour la gravure tram\u00e9e. Cependant, il existe une branche exp\u00e9rimentale avec ses propres compromis. A long terme, il est pr\u00e9vu d'ajouter cette fonctionnalit\u00e9 au klipper principal. Commandes \u00b6 M3/M4 S<valeur> : D\u00e9finit le cycle de travail PWM. Valeurs comprises entre 0 et 255. M5 : Arr\u00eate la sortie PWM \u00e0 la valeur d'arr\u00eat. Configuration de Laserweb \u00b6 Si vous utilisez Laserweb, une configuration fonctionnelle serait la suivante : GCODE START : M5 ; D\u00e9sactiver le laser G21 ; D\u00e9finir les unit\u00e9s en mm G90 ; Positionnement absolu G0 Z0 F7000 ; R\u00e9gler la vitesse de non coupe GCODE END : M5 ; D\u00e9sactiver le laser G91 ; relatif G0 Z+20 F4000 ; G90 ; absolu GCODE HOMING : M5 ; D\u00e9sactiver le laser G28 ; D\u00e9placement sur tous les axes TOOL ON : M3 $INTENSIT\u00c9 TOOL OFF : M5 ; D\u00e9sactiver le laser INTENSIT\u00c9 DU LASER : S","title":"Utilisation des outils PWM"},{"location":"Using_PWM_Tools.html#utilisation-des-outils-pwm","text":"Ce document d\u00e9crit comment configurer un laser ou une broche contr\u00f4l\u00e9e par PWM en utilisant output_pin et quelques macros.","title":"Utilisation des outils PWM"},{"location":"Using_PWM_Tools.html#comment-ca-marche","text":"En r\u00e9-utilisant la sortie pwm du ventilateur de la t\u00eate d'impression, vous pouvez contr\u00f4ler des lasers ou des broches. Ceci est utile si vous utilisez des t\u00eates d'impression commutables, par exemple le changeur d'outils E3D ou une solution DIY. Habituellement, les outils \u00e0 came tels que LaserWeb peuvent \u00eatre configur\u00e9s pour utiliser les commandes M3-M5 , qui correspondent \u00e0 vitesse de broche CW ( M3 S[0-255] ), vitesse de broche CCW ( M4 S[0-255] ) et arr\u00eat de broche ( M5 ). Avertissement : Lorsque vous pilotez un laser, prenez toutes les pr\u00e9cautions de s\u00e9curit\u00e9 auxquelles vous pouvez penser ! Les lasers \u00e0 diodes sont g\u00e9n\u00e9ralement invers\u00e9s. Cela signifie que lorsque l'unit\u00e9 centrale red\u00e9marre, le laser sera compl\u00e8tement allum\u00e9 pendant le temps n\u00e9cessaire \u00e0 l'unit\u00e9 centrale pour red\u00e9marrer. Pour faire bonne mesure, il est recommand\u00e9 de toujours porter des lunettes laser appropri\u00e9es de la bonne longueur d'onde si le laser est aliment\u00e9 ; et de d\u00e9connecter le laser lorsqu'il n'est pas n\u00e9cessaire. Vous devriez \u00e9galement configurer un d\u00e9lai de s\u00e9curit\u00e9, de sorte que lorsque votre h\u00f4te ou votre MCU rencontre une erreur, l'outil s'arr\u00eate. Pour un exemple de configuration, voir config/sample-pwm-tool.cfg .","title":"Comment \u00e7a marche ?"},{"location":"Using_PWM_Tools.html#limites-actuelles","text":"La fr\u00e9quence des mises \u00e0 jour PWM est limit\u00e9e. Bien qu'elle soit tr\u00e8s pr\u00e9cise, une mise \u00e0 jour PWM ne peut se produire que toutes les 0,1 seconde, ce qui la rend presque inutile pour la gravure tram\u00e9e. Cependant, il existe une branche exp\u00e9rimentale avec ses propres compromis. A long terme, il est pr\u00e9vu d'ajouter cette fonctionnalit\u00e9 au klipper principal.","title":"Limites actuelles"},{"location":"Using_PWM_Tools.html#commandes","text":"M3/M4 S<valeur> : D\u00e9finit le cycle de travail PWM. Valeurs comprises entre 0 et 255. M5 : Arr\u00eate la sortie PWM \u00e0 la valeur d'arr\u00eat.","title":"Commandes"},{"location":"Using_PWM_Tools.html#configuration-de-laserweb","text":"Si vous utilisez Laserweb, une configuration fonctionnelle serait la suivante : GCODE START : M5 ; D\u00e9sactiver le laser G21 ; D\u00e9finir les unit\u00e9s en mm G90 ; Positionnement absolu G0 Z0 F7000 ; R\u00e9gler la vitesse de non coupe GCODE END : M5 ; D\u00e9sactiver le laser G91 ; relatif G0 Z+20 F4000 ; G90 ; absolu GCODE HOMING : M5 ; D\u00e9sactiver le laser G28 ; D\u00e9placement sur tous les axes TOOL ON : M3 $INTENSIT\u00c9 TOOL OFF : M5 ; D\u00e9sactiver le laser INTENSIT\u00c9 DU LASER : S","title":"Configuration de Laserweb"}]}
\ No newline at end of file
+{"config":{"indexing":"full","lang":["fr"],"min_search_length":3,"prebuild_index":false,"separator":"[\\s\\-]+"},"docs":[{"location":"index.html","text":"hide: toc title: Bienvenue Klipper est un microprogramme pour imprimante 3D. Il combine la puissance d'un ordinateur classique avec un ou plusieurs microcontr\u00f4leurs. Consultez le document Fonctionnalit\u00e9s pour plus d'informations sur les raisons pour lesquelles vous devriez utiliser Klipper. Pour commencer \u00e0 utiliser Klipper, commencez par effectuer l' installation . Klipper est un logiciel libre. Lisez sa documentation ou consultez le code de Klipper sur github . Nous d\u00e9pendons du soutien g\u00e9n\u00e9reux de nos sponsors .","title":"Home"},{"location":"API_Server.html","text":"Serveur API \u00b6 Ce document d\u00e9crit l'Interface de Programmation d'Applications (API) de Klipper. Cette interface permet \u00e0 des applications externes d'interroger et de contr\u00f4ler Klipper. Activer le socket API \u00b6 Pour pouvoir utiliser les Serveur API, le logiciel h\u00f4te klippy.py doit \u00eatre d\u00e9marr\u00e9 avec le param\u00e8tre -a . Par exemple : ~/klippy-env/bin/python ~/klipper/klippy/klippy.py ~/printer.cfg -a /tmp/klippy_uds -l /tmp/klippy.log Cela force le logiciel h\u00f4te \u00e0 cr\u00e9er un socket de domaine Unix. Un client peut alors ouvrir une connexion sur ce socket et envoyer des commandes \u00e0 Klipper. Voir le projet Moonraker pour un outil populaire qui peut transf\u00e9rer les requ\u00eates HTTP vers le socket du serveur d'API de Klipper. Format de la demande \u00b6 Les messages envoy\u00e9s et re\u00e7us sur le socket sont des cha\u00eenes au format JSON et termin\u00e9es par le caract\u00e8re ASCII 0x03 : <json_object_1><0x03><json_object_2><0x03>... Klipper contiens un outil scripts/whconsole.py qui peut effectuer la mise en forme du message ci-dessus. Par exemple : ~/klipper/scripts/whconsole.py /tmp/klippy_uds Cet outil peut lire une s\u00e9rie de commandes JSON \u00e0 partir de l'entr\u00e9e standard stdin, les envoyer \u00e0 Klipper et afficher les r\u00e9sultats. Cet outil s'attend \u00e0 avoir une commande JSON par ligne et il ajoute automatiquement le terminateur 0x03 avant d'envoyer les requ\u00eates. (Le serveur d'API de Klipper ne attend pas un saut de ligne.) Protocole de l'API \u00b6 Le protocole de commande utilis\u00e9 sur le socket de communications est inspir\u00e9 par json-rpc . Une requ\u00eate pourrait ressembler \u00e0 \u00e7a : {\"id\": 123, \"method\": \"info\", \"params\": {}} et une r\u00e9ponse pourrait ressembler \u00e0 \u00e7a : {\"id\": 123, \"result\": {\"state_message\": \"Printer is ready\", \"klipper_path\": \"/home/pi/klipper\", \"config_file\": \"/home/pi/printer.cfg\", \"software_version\": \"v0.8.0-823-g883b1cb6\", \"hostname\": \"octopi\", \"cpu_info\": \"4 core ARMv7 Processor rev 4 (v7l)\", \"state\": \"ready\", \"python_path\": \"/home/pi/klippy-env/bin/python\", \"log_file\": \"/tmp/klippy.log\"}} Toutes les requ\u00eates doivent \u00eatre un dictionnaire JSON. (Ce document utilise le terme Python 'dictionary' pour d\u00e9crire un objet JSON - une affectation de paires Cl\u00e9/Valeur comprises en deux parenth\u00e8ses {} .) le dictionnaire de requ\u00eate doit contenir un param\u00e8tre \"m\u00e9thode\" disponible dans les \"points de terminaison\" de Klipper. Le dictionnaire de requ\u00eate peut contenir un param\u00e8tre \"params\" qui doit \u00eatre de type dictionnaire. Les \"params\" fournissent des informations de param\u00e8tre suppl\u00e9mentaires au \"endpoint\" Klipper qui traite la demande. Son contenu est sp\u00e9cifique au \"endpoint\". Le dictionnaire de requ\u00eate peut contenir un param\u00e8tre \"id\" qui peut \u00eatre de n'importe quel type JSON. Si \"id\" est pr\u00e9sent, alors Klipper r\u00e9pondra \u00e0 la demande avec une r\u00e9ponse contenant cet \"id\". Si \"id\" est omis (ou d\u00e9fini sur une valeur JSON \"null\"), Klipper ne fournira aucune r\u00e9ponse \u00e0 la requ\u00eate. Un message de r\u00e9ponse est un dictionnaire JSON contenant \"id\" et \"result\". Le \"r\u00e9sultat\" est toujours un dictionnaire - son contenu est sp\u00e9cifique au \"endpoint\" traitant la demande. Si le traitement d'un requ\u00eate est en erreur, le message de r\u00e9ponse contiendra un champ \"error\" au lieu de \"result\". Par exemple, la requ\u00eate : {\"id\": 123, \"method\": \"gcode/script\", \"params\": {\"script\": \"G1 X200\"}} pourrait retourner une erreur telle que :: {\"id\": 123, \"error\": {\"message\": \"Must home axis first: 200.000 0.000 0.000 [0.000]\", \"error\": \"WebRequestError\"}} Klipper traite toujours les demandes dans l'ordre de leur r\u00e9ception. Cependant, certaines requ\u00eates peuvent ne pas se terminer imm\u00e9diatement, ce qui peut entra\u00eener l'envoi de la r\u00e9ponse associ\u00e9e dans le d\u00e9sordre par rapport aux r\u00e9ponses d'autres requ\u00eates. Une requ\u00eate JSON ne suspend jamais le traitement des requ\u00eates JSON suivantes. Abonnements \u00b6 Certains \"endpoint\" de Klipper autorisent un \"abonnement\" pour de futurs messages asynchrone de mise \u00e0 jour. Par exemple : {\"id\": 123, \"method\": \"gcode/subscribe_output\", \"params\": {\"response_template\":{\"key\": 345}}} Peut r\u00e9pondre dans un premier temps : {\"id\": 123, \"result\": {}} et faire en sorte que Klipper envoie de futurs messages similaires \u00e0 : {\"params\": {\"response\": \"ok B:22.8 /0.0 T0:22.4 /0.0\"}, \"key\": 345} Une demande d'abonnement accepte un dictionnaire \"response_template\" dans le champ \"params\" de la demande. Ce dictionnaire \"response_template\" est utilis\u00e9 comme mod\u00e8le pour les futurs messages asynchrones - il peut contenir des paires cl\u00e9/valeur arbitraires. Lors de l'envoi de ces futurs messages asynchrones, Klipper ajoutera un champ \"params\" contenant un dictionnaire avec un contenu sp\u00e9cifique \"endpoint\" au mod\u00e8le de r\u00e9ponse, puis enverra ce mod\u00e8le. Si un champ \"response_template\" n'est pas fourni, il s'agit par d\u00e9faut d'un dictionnaire vide ( {} ). \"endpoints\" disponibles \u00b6 Par convention, les \"endpoints\" de Klipper sont de la forme <module_name>/<some_name> . Lors d'une demande \u00e0 un \"endpoint\", le nom complet doit \u00eatre d\u00e9fini dans le param\u00e8tre \"method\" du dictionnaire de requ\u00eate (par exemple, {\"method\"=\"gcode/restart\"} ). Info \u00b6 Le point de terminaison \"info\" est utilis\u00e9 pour obtenir des informations sur le syst\u00e8me et la version de Klipper. Il est \u00e9galement utilis\u00e9 pour fournir les informations de version du client \u00e0 Klipper. Par exemple : {\"id\": 123, \"method\": \"info\", \"params\": { \"client_info\": { \"version\": \"v1\"}}} S'il est pr\u00e9sent, le param\u00e8tre \"client_info\" doit \u00eatre un dictionnaire, mais ce dictionnaire peut avoir un contenu arbitraire. Les clients sont encourag\u00e9s \u00e0 fournir le nom du client et sa version logicielle lors de la premi\u00e8re connexion au serveur API Klipper. arr\u00eat d'urgence \u00b6 Le point de terminaison \"emergency_stop\" est utilis\u00e9 pour demander \u00e0 Klipper de passer \u00e0 un \u00e9tat \"shutdown\". Il se comporte de la m\u00eame mani\u00e8re que la commande G-Code M112 . Par exemple : {\"id\": 123, \"method\": \"emergency_stop\"} register_remote_method \u00b6 Ce point de terminaison permet aux clients d'enregistrer des m\u00e9thodes pouvant \u00eatre appel\u00e9es depuis klipper. Il renverra un objet vide en cas de succ\u00e8s. Par exemple : {\"id\": 123, \"method\": \"register_remote_method\", \"params\": {\"response_template\": {\"action\": \"run_paneldue_beep\"}, \"remote_method\": \"paneldue_beep\"}} renverra : }` La m\u00e9thode distante paneldue_beep peut d\u00e9sormais \u00eatre appel\u00e9e depuis Klipper. Notez que si la m\u00e9thode prend des param\u00e8tres, ils doivent \u00eatre fournis en tant qu'arguments de mots cl\u00e9s. Voici un exemple de la fa\u00e7on dont il peut \u00eatre appel\u00e9 \u00e0 partir d'un gcode_macro : [gcode_macro PANELDUE_BEEP] gcode: {action_call_remote_method(\"paneldue_beep\", frequency=300, duration=1.0)} Lorsque la macro gcode PANELDUE_BEEP est ex\u00e9cut\u00e9e, Klipper enverra ce qui suit sur le socket : {\"action\": \"run_paneldue_beep\", \"params\": {\"frequency\": 300, \"duration\": 1.0}} objects/list \u00b6 Ce point de terminaison remonte la liste des \"objets\" disponibles de l'imprimante que l'on peut interroger (via le point de terminaison \"objects/query\"). Par exemple : {\"id\": 123, \"method\": \"objects/list\"} peut renvoyer : {\"id\": 123, \"result\": {\"objects\": [\" webhooks\", \"configfile\", \"heaters\", \"gcode_move\", \"query_endstops\", \"idle_timeout\", \"toolhead\", \"extruder\"]}} objects/query \u00b6 Ce point de terminaison permet de retrouver des informations \u00e0 partir d'objets de l'imprimante. Par exemple : {\"id\": 123, \"method\": \"objects/query\", \"params\": {\"objects\": {\"toolhead\": [\"position\"], \"webhooks\": null}} } peut renvoyer : {\"id\": 123, \"result\": {\"status\": {\"webhooks\": {\"state\": \"ready\", \"state_message\": \"L'imprimante est pr\u00eate\"} , \"toolhead\": {\"position\": [0.0, 0.0, 0.0, 0.0]}}, \"eventtime\": 3051555.377933684}} Le param\u00e8tre \"objects\" dans la requ\u00eate doit \u00eatre un dictionnaire contenant des objets de l'imprimante \u00e0 interroger - la cl\u00e9 contient le nom de l'objet imprimante et la valeur est soit \"null\" (pour interroger tous les champs) soit une liste de noms de champs. Le message de r\u00e9ponse contiendra un champ \"statut\" contenant un dictionnaire avec les informations demand\u00e9es - la cl\u00e9 contient le nom de l'objet imprimante et la valeur est un dictionnaire contenant ses champs. Le message de r\u00e9ponse contiendra \u00e9galement un champ \"eventtime\" contenant l'horodatage \u00e0 partir duquel la requ\u00eate a \u00e9t\u00e9 prise. Les champs disponibles sont document\u00e9s dans le document R\u00e9f\u00e9rence des \u00e9tats . objects/subscribe \u00b6 Ce point de terminaison permet d'interroger puis de s'abonner \u00e0 des informations provenant d'objets de l'imprimante. La demande et la r\u00e9ponse du point de terminaison sont identiques au point de terminaison \"objects/query\". Par exemple : {\"id\": 123, \"method\": \"objects/subscribe\", \"params\": {\"objects\":{\"toolhead\": [\"position\"], \"webhooks\": [\"state \"]}, \"response_template\":{}}} peut renvoyer : {\"id\": 123, \"result\": {\"status\": {\"webhooks\": {\"state\": \"pr\u00eat\" }, \"toolhead\": {\"position\": [0.0, 0.0, 0.0, 0.0]}}, \"eventtime\": 3052153.382083195}} et entra\u00eener des messages asynchrones ult\u00e9rieurs tels que : {\"params\": {\"status\": {\"webhooks\": {\"state\": \"shutdown\"}}, \"eventtime\": 3052165.418815847}} gcode/help \u00b6 Ce point de terminaison permet de retrouver les commandes G-Code disponibles qui ont une cha\u00eene d'aide d\u00e9finie. Par exemple : {\"id\": 123, \"method\": \"gcode/help\"} peut renvoyer : {\"id\": 123, \"result\": {\"RESTORE_GCODE_STATE\": \"Restaurer un \u00e9tat G-Code pr\u00e9c\u00e9demment enregistr\u00e9\", \"PID_CALIBRATE\": \"Ex\u00e9cuter le test d'\u00e9talonnage PID\", \"QUERY_ADC\": \"Rapport de la derni\u00e8re valeur d'une broche analogique\", ...}} gcode/script \u00b6 Ce point de terminaison permet d'ex\u00e9cuter une s\u00e9rie de commandes G-Code. Par exemple : {\"id\": 123, \"method\": \"gcode/script\", \"params\": {\"script\": \"G90\"}} Si le script G-Code fourni g\u00e9n\u00e8re une erreur, une r\u00e9ponse d'erreur est g\u00e9n\u00e9r\u00e9e. Cependant, si la commande G-Code produit une sortie vers le terminal, cette sortie n'est pas remont\u00e9e dans la r\u00e9ponse. (Utilisez le point de terminaison \"gcode/subscribe_output\" pour obtenir la remont\u00e9e des sortie du terminal G-Code.) Si une commande G-Code est en cours de traitement lorsque cette demande est re\u00e7ue, le script re\u00e7u sera mis en file d'attente. Ce d\u00e9lai peut \u00eatre important (par exemple, si une commande d'attente de temp\u00e9rature de code G est en cours). Le message de r\u00e9ponse JSON est envoy\u00e9 lorsque le traitement du script est enti\u00e8rement termin\u00e9. gcode/restart \u00b6 Ce point de terminaison permet de demander un red\u00e9marrage - il est similaire \u00e0 l'ex\u00e9cution de la commande G-Code \"RESTART\". Par exemple : {\"id\": 123, \"method\": \"gcode/restart\"} Comme pour le point de terminaison \"gcode/script\", ce point de terminaison ne se termine qu'apr\u00e8s la fin de toutes les commandes G-Code en attente. gcode/firmware_restart \u00b6 Ceci est similaire au point de terminaison \"gcode/restart\" - il impl\u00e9mente la commande G-Code \"FIRMWARE_RESTART\". Par exemple : {\"id\": 123, \"method\": \"gcode/firmware_restart\"} Comme pour le point de terminaison \"gcode/script\", ce point de terminaison ne se termine qu'apr\u00e8s la fin de toutes les commandes G-Code en attente. gcode/subscribe_output \u00b6 Ce point de terminaison est utilis\u00e9 pour s'abonner aux messages du terminal G-Code de Klipper. Par exemple : {\"id\": 123, \"method\": \"gcode/subscribe_output\", \"params\": {\"response_template\":{}}} peut ult\u00e9rieurement produire des messages asynchrones tels que : {\"params\": {\"response\": \"// \u00c9tat de Klipper : Arr\u00eat\"}} Ce point de terminaison est destin\u00e9 \u00e0 prendre en charge l'interaction humaine via une interface \"fen\u00eatre de terminal\". L'analyse du contenu de la sortie du terminal G-Code est d\u00e9conseill\u00e9e. Utilisez le point de terminaison \"objects/subscribe\" pour obtenir des mises \u00e0 jour sur l'\u00e9tat de Klipper. motion_report/dump_stepper \u00b6 Ce point de terminaison est utilis\u00e9 pour s'abonner au flux de commandes interne stepper queue_step de Klipper pour un stepper. L'obtention de ces mises \u00e0 jour de mouvement de bas niveau peut \u00eatre utile \u00e0 des fins de diagnostic et de d\u00e9bogage. L'utilisation de ce point de terminaison peut augmenter la charge syst\u00e8me de Klipper. Une requ\u00eate peut ressembler \u00e0 : {\"id\": 123, \"method\":\"motion_report/dump_stepper\", \"params\": {\"name\": \"stepper_x\", \"response_template\": {}}} et peut renvoyer : {\"id\": 123, \"result\": {\"header\": [\"interval\", \"count\", \"add\"]}} et peut produire ult\u00e9rieurement des messages asynchrones tels que : {\"params\": {\"first_clock\": 179601081, \"first_time\": 8.98, \"first_position\": 0, \"last_clock\": 219686097, \"last_time\": 10.984, \"data\": [[179601081, 1, 0 ], [29573, 2, -8685], [16230, 4, -1525], [10559, 6, -160], [10000, 976, 0], [10000, 1000, 0], [10000, 1000, 0], [10000, 1000, 0], [9855, 5, 187], [11632, 4, 1534], [20756, 2, 9442]]}} Le champ \"en-t\u00eate\" dans la r\u00e9ponse initiale \u00e0 la requ\u00eate est utilis\u00e9 pour d\u00e9crire les champs pr\u00e9sents dans les r\u00e9ponses \"donn\u00e9es\" ult\u00e9rieures. motion_report/dump_trapq \u00b6 Ce point de terminaison est utilis\u00e9 pour s'abonner \u00e0 la \"file d'attente de mouvements trap\u00e9zo\u00efdaux\" interne de Klipper. L'obtention de ces mises \u00e0 jour de mouvement de bas niveau peut \u00eatre utile \u00e0 des fins de diagnostic et de d\u00e9bogage. L'utilisation de ce point de terminaison peut augmenter la charge syst\u00e8me de Klipper. Une requ\u00eate peut ressembler \u00e0 : {\"id\": 123, \"method\": \"motion_report/dump_trapq\", \"params\": {\"name\": \"toolhead\", \"response_template\":{}}} et peut renvoyer : {\"id\": 1, \"result\": {\"header\": [\"time\", \"duration\", \"start_velocity\", \"acceleration\", \"start_position\", \"direction\"]}} et peut produire ult\u00e9rieurement des messages asynchrones tels que : {\"params\": {\"data\": [[4.05, 1.0, 0.0, 0.0, [300.0, 0.0, 0.0], [0.0, 0.0, 0.0] ], [5.054, 0.001, 0.0, 3000.0, [300.0, 0.0, 0.0], [-1.0, 0.0, 0.0]]]}} Le champ \"en-t\u00eate\" dans la r\u00e9ponse initiale \u00e0 la requ\u00eate est utilis\u00e9 pour d\u00e9crire les champs pr\u00e9sents dans les r\u00e9ponses \"donn\u00e9es\" ult\u00e9rieures. adxl345/dump_adxl345 \u00b6 Ce point de terminaison est utilis\u00e9 pour s'abonner aux donn\u00e9es de l'acc\u00e9l\u00e9rom\u00e8tre ADXL345. L'obtention de ces mises \u00e0 jour de mouvement de bas niveau peut \u00eatre utile \u00e0 des fins de diagnostic et de d\u00e9bogage. L'utilisation de ce point de terminaison peut augmenter la charge syst\u00e8me de Klipper. Une requ\u00eate peut ressembler \u00e0 : {\"id\": 123, \"method\":\"adxl345/dump_adxl345\", \"params\": {\"sensor\": \"adxl345\", \"response_template\": {}}} et pourrait renvoyer : {\"id\": 123,\"result\":{\"header\":[\"time\",\"x_acceleration\",\"y_acceleration\", \"z_acceleration\"]}} et pourrait plus tard produire des messages asynchrones messages tels que : {\"params\":{\"overflows\":0,\"data\":[[3292.432935,-535.44309,-1529.8374,9561.4], [3292.433256,-382.45935,-1606.32927,9561.48375]]}} Le champ \"en-t\u00eate\" dans la r\u00e9ponse initiale \u00e0 la requ\u00eate est utilis\u00e9 pour d\u00e9crire les champs pr\u00e9sents dans les r\u00e9ponses \"donn\u00e9es\" ult\u00e9rieures. angle/dump_angle \u00b6 Ce point de terminaison est utilis\u00e9 pour s'abonner aux donn\u00e9es du capteur d'angle . L'obtention de ces mises \u00e0 jour de mouvement de bas niveau peut \u00eatre utile \u00e0 des fins de diagnostic et de d\u00e9bogage. L'utilisation de ce point de terminaison peut augmenter la charge syst\u00e8me de Klipper. Une requ\u00eate peut ressembler \u00e0 : {\"id\": 123, \"method\":\"angle/dump_angle\", \"params\": {\"sensor\": \"my_angle_sensor\", \"response_template\": {}}} et peut renvoyer : {\"id\": 123,\"result\":{\"header\":[\"time\",\"angle\"]}} et peut produire ult\u00e9rieurement des messages asynchrones tels que : { \"params\":{\"position_offset\":3.151562,\"errors\":0, \"data\":[[1290.951905,-5063],[1290.952321,-5065]]}} Le champ \"en-t\u00eate\" dans la r\u00e9ponse initiale \u00e0 la requ\u00eate est utilis\u00e9 pour d\u00e9crire les champs pr\u00e9sents dans les r\u00e9ponses \"donn\u00e9es\" ult\u00e9rieures. pause_resume/cancel \u00b6 Ce point final est similaire \u00e0 l'ex\u00e9cution de la commande G-Code \"PRINT_CANCEL\". Par exemple : {\"id\": 123, \"method\": \"pause_resume/cancel\"} Comme pour le point de terminaison \"gcode/script\", ce point de terminaison ne se termine qu'apr\u00e8s la fin de toutes les commandes G-Code en attente. pause_resume/pause \u00b6 Ce point d'entr\u00e9e est similaire \u00e0 l'ex\u00e9cution de la commande G-Code \"PAUSE\". Par exemple : {\"id\": 123, \"method\": \"pause_resume/pause\"} Comme pour le point de terminaison \"gcode/script\", ce point de terminaison ne se termine qu'apr\u00e8s la fin de toutes les commandes G-Code en attente. pause_resume/resume \u00b6 Ce point de terminaison est similaire \u00e0 l'ex\u00e9cution de la commande G-Code \"RESUME\". Par exemple : {\"id\": 123, \"method\": \"pause_resume/resume\"} Comme pour le point de terminaison \"gcode/script\", ce point de terminaison ne se termine qu'apr\u00e8s la fin de toutes les commandes G-Code en attente. query_endstops/status \u00b6 Ce point de terminaison interrogera les fins de course actifs et renverra leur \u00e9tat. Par exemple : {\"id\": 123, \"method\": \"query_endstops/status\"} peut renvoyer : {\"id\": 123, \"result\": {\"y\": \"open \", \"x\": \"open\", \"z\": \"TRIGGERED\"}} Comme pour le point de terminaison \"gcode/script\", ce point de terminaison ne se termine qu'apr\u00e8s la fin de toutes les commandes G-Code en attente.","title":"Serveur API"},{"location":"API_Server.html#serveur-api","text":"Ce document d\u00e9crit l'Interface de Programmation d'Applications (API) de Klipper. Cette interface permet \u00e0 des applications externes d'interroger et de contr\u00f4ler Klipper.","title":"Serveur API"},{"location":"API_Server.html#activer-le-socket-api","text":"Pour pouvoir utiliser les Serveur API, le logiciel h\u00f4te klippy.py doit \u00eatre d\u00e9marr\u00e9 avec le param\u00e8tre -a . Par exemple : ~/klippy-env/bin/python ~/klipper/klippy/klippy.py ~/printer.cfg -a /tmp/klippy_uds -l /tmp/klippy.log Cela force le logiciel h\u00f4te \u00e0 cr\u00e9er un socket de domaine Unix. Un client peut alors ouvrir une connexion sur ce socket et envoyer des commandes \u00e0 Klipper. Voir le projet Moonraker pour un outil populaire qui peut transf\u00e9rer les requ\u00eates HTTP vers le socket du serveur d'API de Klipper.","title":"Activer le socket API"},{"location":"API_Server.html#format-de-la-demande","text":"Les messages envoy\u00e9s et re\u00e7us sur le socket sont des cha\u00eenes au format JSON et termin\u00e9es par le caract\u00e8re ASCII 0x03 : <json_object_1><0x03><json_object_2><0x03>... Klipper contiens un outil scripts/whconsole.py qui peut effectuer la mise en forme du message ci-dessus. Par exemple : ~/klipper/scripts/whconsole.py /tmp/klippy_uds Cet outil peut lire une s\u00e9rie de commandes JSON \u00e0 partir de l'entr\u00e9e standard stdin, les envoyer \u00e0 Klipper et afficher les r\u00e9sultats. Cet outil s'attend \u00e0 avoir une commande JSON par ligne et il ajoute automatiquement le terminateur 0x03 avant d'envoyer les requ\u00eates. (Le serveur d'API de Klipper ne attend pas un saut de ligne.)","title":"Format de la demande"},{"location":"API_Server.html#protocole-de-lapi","text":"Le protocole de commande utilis\u00e9 sur le socket de communications est inspir\u00e9 par json-rpc . Une requ\u00eate pourrait ressembler \u00e0 \u00e7a : {\"id\": 123, \"method\": \"info\", \"params\": {}} et une r\u00e9ponse pourrait ressembler \u00e0 \u00e7a : {\"id\": 123, \"result\": {\"state_message\": \"Printer is ready\", \"klipper_path\": \"/home/pi/klipper\", \"config_file\": \"/home/pi/printer.cfg\", \"software_version\": \"v0.8.0-823-g883b1cb6\", \"hostname\": \"octopi\", \"cpu_info\": \"4 core ARMv7 Processor rev 4 (v7l)\", \"state\": \"ready\", \"python_path\": \"/home/pi/klippy-env/bin/python\", \"log_file\": \"/tmp/klippy.log\"}} Toutes les requ\u00eates doivent \u00eatre un dictionnaire JSON. (Ce document utilise le terme Python 'dictionary' pour d\u00e9crire un objet JSON - une affectation de paires Cl\u00e9/Valeur comprises en deux parenth\u00e8ses {} .) le dictionnaire de requ\u00eate doit contenir un param\u00e8tre \"m\u00e9thode\" disponible dans les \"points de terminaison\" de Klipper. Le dictionnaire de requ\u00eate peut contenir un param\u00e8tre \"params\" qui doit \u00eatre de type dictionnaire. Les \"params\" fournissent des informations de param\u00e8tre suppl\u00e9mentaires au \"endpoint\" Klipper qui traite la demande. Son contenu est sp\u00e9cifique au \"endpoint\". Le dictionnaire de requ\u00eate peut contenir un param\u00e8tre \"id\" qui peut \u00eatre de n'importe quel type JSON. Si \"id\" est pr\u00e9sent, alors Klipper r\u00e9pondra \u00e0 la demande avec une r\u00e9ponse contenant cet \"id\". Si \"id\" est omis (ou d\u00e9fini sur une valeur JSON \"null\"), Klipper ne fournira aucune r\u00e9ponse \u00e0 la requ\u00eate. Un message de r\u00e9ponse est un dictionnaire JSON contenant \"id\" et \"result\". Le \"r\u00e9sultat\" est toujours un dictionnaire - son contenu est sp\u00e9cifique au \"endpoint\" traitant la demande. Si le traitement d'un requ\u00eate est en erreur, le message de r\u00e9ponse contiendra un champ \"error\" au lieu de \"result\". Par exemple, la requ\u00eate : {\"id\": 123, \"method\": \"gcode/script\", \"params\": {\"script\": \"G1 X200\"}} pourrait retourner une erreur telle que :: {\"id\": 123, \"error\": {\"message\": \"Must home axis first: 200.000 0.000 0.000 [0.000]\", \"error\": \"WebRequestError\"}} Klipper traite toujours les demandes dans l'ordre de leur r\u00e9ception. Cependant, certaines requ\u00eates peuvent ne pas se terminer imm\u00e9diatement, ce qui peut entra\u00eener l'envoi de la r\u00e9ponse associ\u00e9e dans le d\u00e9sordre par rapport aux r\u00e9ponses d'autres requ\u00eates. Une requ\u00eate JSON ne suspend jamais le traitement des requ\u00eates JSON suivantes.","title":"Protocole de l'API"},{"location":"API_Server.html#abonnements","text":"Certains \"endpoint\" de Klipper autorisent un \"abonnement\" pour de futurs messages asynchrone de mise \u00e0 jour. Par exemple : {\"id\": 123, \"method\": \"gcode/subscribe_output\", \"params\": {\"response_template\":{\"key\": 345}}} Peut r\u00e9pondre dans un premier temps : {\"id\": 123, \"result\": {}} et faire en sorte que Klipper envoie de futurs messages similaires \u00e0 : {\"params\": {\"response\": \"ok B:22.8 /0.0 T0:22.4 /0.0\"}, \"key\": 345} Une demande d'abonnement accepte un dictionnaire \"response_template\" dans le champ \"params\" de la demande. Ce dictionnaire \"response_template\" est utilis\u00e9 comme mod\u00e8le pour les futurs messages asynchrones - il peut contenir des paires cl\u00e9/valeur arbitraires. Lors de l'envoi de ces futurs messages asynchrones, Klipper ajoutera un champ \"params\" contenant un dictionnaire avec un contenu sp\u00e9cifique \"endpoint\" au mod\u00e8le de r\u00e9ponse, puis enverra ce mod\u00e8le. Si un champ \"response_template\" n'est pas fourni, il s'agit par d\u00e9faut d'un dictionnaire vide ( {} ).","title":"Abonnements"},{"location":"API_Server.html#endpoints-disponibles","text":"Par convention, les \"endpoints\" de Klipper sont de la forme <module_name>/<some_name> . Lors d'une demande \u00e0 un \"endpoint\", le nom complet doit \u00eatre d\u00e9fini dans le param\u00e8tre \"method\" du dictionnaire de requ\u00eate (par exemple, {\"method\"=\"gcode/restart\"} ).","title":"\"endpoints\" disponibles"},{"location":"API_Server.html#info","text":"Le point de terminaison \"info\" est utilis\u00e9 pour obtenir des informations sur le syst\u00e8me et la version de Klipper. Il est \u00e9galement utilis\u00e9 pour fournir les informations de version du client \u00e0 Klipper. Par exemple : {\"id\": 123, \"method\": \"info\", \"params\": { \"client_info\": { \"version\": \"v1\"}}} S'il est pr\u00e9sent, le param\u00e8tre \"client_info\" doit \u00eatre un dictionnaire, mais ce dictionnaire peut avoir un contenu arbitraire. Les clients sont encourag\u00e9s \u00e0 fournir le nom du client et sa version logicielle lors de la premi\u00e8re connexion au serveur API Klipper.","title":"Info"},{"location":"API_Server.html#arret-durgence","text":"Le point de terminaison \"emergency_stop\" est utilis\u00e9 pour demander \u00e0 Klipper de passer \u00e0 un \u00e9tat \"shutdown\". Il se comporte de la m\u00eame mani\u00e8re que la commande G-Code M112 . Par exemple : {\"id\": 123, \"method\": \"emergency_stop\"}","title":"arr\u00eat d'urgence"},{"location":"API_Server.html#register_remote_method","text":"Ce point de terminaison permet aux clients d'enregistrer des m\u00e9thodes pouvant \u00eatre appel\u00e9es depuis klipper. Il renverra un objet vide en cas de succ\u00e8s. Par exemple : {\"id\": 123, \"method\": \"register_remote_method\", \"params\": {\"response_template\": {\"action\": \"run_paneldue_beep\"}, \"remote_method\": \"paneldue_beep\"}} renverra : }` La m\u00e9thode distante paneldue_beep peut d\u00e9sormais \u00eatre appel\u00e9e depuis Klipper. Notez que si la m\u00e9thode prend des param\u00e8tres, ils doivent \u00eatre fournis en tant qu'arguments de mots cl\u00e9s. Voici un exemple de la fa\u00e7on dont il peut \u00eatre appel\u00e9 \u00e0 partir d'un gcode_macro : [gcode_macro PANELDUE_BEEP] gcode: {action_call_remote_method(\"paneldue_beep\", frequency=300, duration=1.0)} Lorsque la macro gcode PANELDUE_BEEP est ex\u00e9cut\u00e9e, Klipper enverra ce qui suit sur le socket : {\"action\": \"run_paneldue_beep\", \"params\": {\"frequency\": 300, \"duration\": 1.0}}","title":"register_remote_method"},{"location":"API_Server.html#objectslist","text":"Ce point de terminaison remonte la liste des \"objets\" disponibles de l'imprimante que l'on peut interroger (via le point de terminaison \"objects/query\"). Par exemple : {\"id\": 123, \"method\": \"objects/list\"} peut renvoyer : {\"id\": 123, \"result\": {\"objects\": [\" webhooks\", \"configfile\", \"heaters\", \"gcode_move\", \"query_endstops\", \"idle_timeout\", \"toolhead\", \"extruder\"]}}","title":"objects/list"},{"location":"API_Server.html#objectsquery","text":"Ce point de terminaison permet de retrouver des informations \u00e0 partir d'objets de l'imprimante. Par exemple : {\"id\": 123, \"method\": \"objects/query\", \"params\": {\"objects\": {\"toolhead\": [\"position\"], \"webhooks\": null}} } peut renvoyer : {\"id\": 123, \"result\": {\"status\": {\"webhooks\": {\"state\": \"ready\", \"state_message\": \"L'imprimante est pr\u00eate\"} , \"toolhead\": {\"position\": [0.0, 0.0, 0.0, 0.0]}}, \"eventtime\": 3051555.377933684}} Le param\u00e8tre \"objects\" dans la requ\u00eate doit \u00eatre un dictionnaire contenant des objets de l'imprimante \u00e0 interroger - la cl\u00e9 contient le nom de l'objet imprimante et la valeur est soit \"null\" (pour interroger tous les champs) soit une liste de noms de champs. Le message de r\u00e9ponse contiendra un champ \"statut\" contenant un dictionnaire avec les informations demand\u00e9es - la cl\u00e9 contient le nom de l'objet imprimante et la valeur est un dictionnaire contenant ses champs. Le message de r\u00e9ponse contiendra \u00e9galement un champ \"eventtime\" contenant l'horodatage \u00e0 partir duquel la requ\u00eate a \u00e9t\u00e9 prise. Les champs disponibles sont document\u00e9s dans le document R\u00e9f\u00e9rence des \u00e9tats .","title":"objects/query"},{"location":"API_Server.html#objectssubscribe","text":"Ce point de terminaison permet d'interroger puis de s'abonner \u00e0 des informations provenant d'objets de l'imprimante. La demande et la r\u00e9ponse du point de terminaison sont identiques au point de terminaison \"objects/query\". Par exemple : {\"id\": 123, \"method\": \"objects/subscribe\", \"params\": {\"objects\":{\"toolhead\": [\"position\"], \"webhooks\": [\"state \"]}, \"response_template\":{}}} peut renvoyer : {\"id\": 123, \"result\": {\"status\": {\"webhooks\": {\"state\": \"pr\u00eat\" }, \"toolhead\": {\"position\": [0.0, 0.0, 0.0, 0.0]}}, \"eventtime\": 3052153.382083195}} et entra\u00eener des messages asynchrones ult\u00e9rieurs tels que : {\"params\": {\"status\": {\"webhooks\": {\"state\": \"shutdown\"}}, \"eventtime\": 3052165.418815847}}","title":"objects/subscribe"},{"location":"API_Server.html#gcodehelp","text":"Ce point de terminaison permet de retrouver les commandes G-Code disponibles qui ont une cha\u00eene d'aide d\u00e9finie. Par exemple : {\"id\": 123, \"method\": \"gcode/help\"} peut renvoyer : {\"id\": 123, \"result\": {\"RESTORE_GCODE_STATE\": \"Restaurer un \u00e9tat G-Code pr\u00e9c\u00e9demment enregistr\u00e9\", \"PID_CALIBRATE\": \"Ex\u00e9cuter le test d'\u00e9talonnage PID\", \"QUERY_ADC\": \"Rapport de la derni\u00e8re valeur d'une broche analogique\", ...}}","title":"gcode/help"},{"location":"API_Server.html#gcodescript","text":"Ce point de terminaison permet d'ex\u00e9cuter une s\u00e9rie de commandes G-Code. Par exemple : {\"id\": 123, \"method\": \"gcode/script\", \"params\": {\"script\": \"G90\"}} Si le script G-Code fourni g\u00e9n\u00e8re une erreur, une r\u00e9ponse d'erreur est g\u00e9n\u00e9r\u00e9e. Cependant, si la commande G-Code produit une sortie vers le terminal, cette sortie n'est pas remont\u00e9e dans la r\u00e9ponse. (Utilisez le point de terminaison \"gcode/subscribe_output\" pour obtenir la remont\u00e9e des sortie du terminal G-Code.) Si une commande G-Code est en cours de traitement lorsque cette demande est re\u00e7ue, le script re\u00e7u sera mis en file d'attente. Ce d\u00e9lai peut \u00eatre important (par exemple, si une commande d'attente de temp\u00e9rature de code G est en cours). Le message de r\u00e9ponse JSON est envoy\u00e9 lorsque le traitement du script est enti\u00e8rement termin\u00e9.","title":"gcode/script"},{"location":"API_Server.html#gcoderestart","text":"Ce point de terminaison permet de demander un red\u00e9marrage - il est similaire \u00e0 l'ex\u00e9cution de la commande G-Code \"RESTART\". Par exemple : {\"id\": 123, \"method\": \"gcode/restart\"} Comme pour le point de terminaison \"gcode/script\", ce point de terminaison ne se termine qu'apr\u00e8s la fin de toutes les commandes G-Code en attente.","title":"gcode/restart"},{"location":"API_Server.html#gcodefirmware_restart","text":"Ceci est similaire au point de terminaison \"gcode/restart\" - il impl\u00e9mente la commande G-Code \"FIRMWARE_RESTART\". Par exemple : {\"id\": 123, \"method\": \"gcode/firmware_restart\"} Comme pour le point de terminaison \"gcode/script\", ce point de terminaison ne se termine qu'apr\u00e8s la fin de toutes les commandes G-Code en attente.","title":"gcode/firmware_restart"},{"location":"API_Server.html#gcodesubscribe_output","text":"Ce point de terminaison est utilis\u00e9 pour s'abonner aux messages du terminal G-Code de Klipper. Par exemple : {\"id\": 123, \"method\": \"gcode/subscribe_output\", \"params\": {\"response_template\":{}}} peut ult\u00e9rieurement produire des messages asynchrones tels que : {\"params\": {\"response\": \"// \u00c9tat de Klipper : Arr\u00eat\"}} Ce point de terminaison est destin\u00e9 \u00e0 prendre en charge l'interaction humaine via une interface \"fen\u00eatre de terminal\". L'analyse du contenu de la sortie du terminal G-Code est d\u00e9conseill\u00e9e. Utilisez le point de terminaison \"objects/subscribe\" pour obtenir des mises \u00e0 jour sur l'\u00e9tat de Klipper.","title":"gcode/subscribe_output"},{"location":"API_Server.html#motion_reportdump_stepper","text":"Ce point de terminaison est utilis\u00e9 pour s'abonner au flux de commandes interne stepper queue_step de Klipper pour un stepper. L'obtention de ces mises \u00e0 jour de mouvement de bas niveau peut \u00eatre utile \u00e0 des fins de diagnostic et de d\u00e9bogage. L'utilisation de ce point de terminaison peut augmenter la charge syst\u00e8me de Klipper. Une requ\u00eate peut ressembler \u00e0 : {\"id\": 123, \"method\":\"motion_report/dump_stepper\", \"params\": {\"name\": \"stepper_x\", \"response_template\": {}}} et peut renvoyer : {\"id\": 123, \"result\": {\"header\": [\"interval\", \"count\", \"add\"]}} et peut produire ult\u00e9rieurement des messages asynchrones tels que : {\"params\": {\"first_clock\": 179601081, \"first_time\": 8.98, \"first_position\": 0, \"last_clock\": 219686097, \"last_time\": 10.984, \"data\": [[179601081, 1, 0 ], [29573, 2, -8685], [16230, 4, -1525], [10559, 6, -160], [10000, 976, 0], [10000, 1000, 0], [10000, 1000, 0], [10000, 1000, 0], [9855, 5, 187], [11632, 4, 1534], [20756, 2, 9442]]}} Le champ \"en-t\u00eate\" dans la r\u00e9ponse initiale \u00e0 la requ\u00eate est utilis\u00e9 pour d\u00e9crire les champs pr\u00e9sents dans les r\u00e9ponses \"donn\u00e9es\" ult\u00e9rieures.","title":"motion_report/dump_stepper"},{"location":"API_Server.html#motion_reportdump_trapq","text":"Ce point de terminaison est utilis\u00e9 pour s'abonner \u00e0 la \"file d'attente de mouvements trap\u00e9zo\u00efdaux\" interne de Klipper. L'obtention de ces mises \u00e0 jour de mouvement de bas niveau peut \u00eatre utile \u00e0 des fins de diagnostic et de d\u00e9bogage. L'utilisation de ce point de terminaison peut augmenter la charge syst\u00e8me de Klipper. Une requ\u00eate peut ressembler \u00e0 : {\"id\": 123, \"method\": \"motion_report/dump_trapq\", \"params\": {\"name\": \"toolhead\", \"response_template\":{}}} et peut renvoyer : {\"id\": 1, \"result\": {\"header\": [\"time\", \"duration\", \"start_velocity\", \"acceleration\", \"start_position\", \"direction\"]}} et peut produire ult\u00e9rieurement des messages asynchrones tels que : {\"params\": {\"data\": [[4.05, 1.0, 0.0, 0.0, [300.0, 0.0, 0.0], [0.0, 0.0, 0.0] ], [5.054, 0.001, 0.0, 3000.0, [300.0, 0.0, 0.0], [-1.0, 0.0, 0.0]]]}} Le champ \"en-t\u00eate\" dans la r\u00e9ponse initiale \u00e0 la requ\u00eate est utilis\u00e9 pour d\u00e9crire les champs pr\u00e9sents dans les r\u00e9ponses \"donn\u00e9es\" ult\u00e9rieures.","title":"motion_report/dump_trapq"},{"location":"API_Server.html#adxl345dump_adxl345","text":"Ce point de terminaison est utilis\u00e9 pour s'abonner aux donn\u00e9es de l'acc\u00e9l\u00e9rom\u00e8tre ADXL345. L'obtention de ces mises \u00e0 jour de mouvement de bas niveau peut \u00eatre utile \u00e0 des fins de diagnostic et de d\u00e9bogage. L'utilisation de ce point de terminaison peut augmenter la charge syst\u00e8me de Klipper. Une requ\u00eate peut ressembler \u00e0 : {\"id\": 123, \"method\":\"adxl345/dump_adxl345\", \"params\": {\"sensor\": \"adxl345\", \"response_template\": {}}} et pourrait renvoyer : {\"id\": 123,\"result\":{\"header\":[\"time\",\"x_acceleration\",\"y_acceleration\", \"z_acceleration\"]}} et pourrait plus tard produire des messages asynchrones messages tels que : {\"params\":{\"overflows\":0,\"data\":[[3292.432935,-535.44309,-1529.8374,9561.4], [3292.433256,-382.45935,-1606.32927,9561.48375]]}} Le champ \"en-t\u00eate\" dans la r\u00e9ponse initiale \u00e0 la requ\u00eate est utilis\u00e9 pour d\u00e9crire les champs pr\u00e9sents dans les r\u00e9ponses \"donn\u00e9es\" ult\u00e9rieures.","title":"adxl345/dump_adxl345"},{"location":"API_Server.html#angledump_angle","text":"Ce point de terminaison est utilis\u00e9 pour s'abonner aux donn\u00e9es du capteur d'angle . L'obtention de ces mises \u00e0 jour de mouvement de bas niveau peut \u00eatre utile \u00e0 des fins de diagnostic et de d\u00e9bogage. L'utilisation de ce point de terminaison peut augmenter la charge syst\u00e8me de Klipper. Une requ\u00eate peut ressembler \u00e0 : {\"id\": 123, \"method\":\"angle/dump_angle\", \"params\": {\"sensor\": \"my_angle_sensor\", \"response_template\": {}}} et peut renvoyer : {\"id\": 123,\"result\":{\"header\":[\"time\",\"angle\"]}} et peut produire ult\u00e9rieurement des messages asynchrones tels que : { \"params\":{\"position_offset\":3.151562,\"errors\":0, \"data\":[[1290.951905,-5063],[1290.952321,-5065]]}} Le champ \"en-t\u00eate\" dans la r\u00e9ponse initiale \u00e0 la requ\u00eate est utilis\u00e9 pour d\u00e9crire les champs pr\u00e9sents dans les r\u00e9ponses \"donn\u00e9es\" ult\u00e9rieures.","title":"angle/dump_angle"},{"location":"API_Server.html#pause_resumecancel","text":"Ce point final est similaire \u00e0 l'ex\u00e9cution de la commande G-Code \"PRINT_CANCEL\". Par exemple : {\"id\": 123, \"method\": \"pause_resume/cancel\"} Comme pour le point de terminaison \"gcode/script\", ce point de terminaison ne se termine qu'apr\u00e8s la fin de toutes les commandes G-Code en attente.","title":"pause_resume/cancel"},{"location":"API_Server.html#pause_resumepause","text":"Ce point d'entr\u00e9e est similaire \u00e0 l'ex\u00e9cution de la commande G-Code \"PAUSE\". Par exemple : {\"id\": 123, \"method\": \"pause_resume/pause\"} Comme pour le point de terminaison \"gcode/script\", ce point de terminaison ne se termine qu'apr\u00e8s la fin de toutes les commandes G-Code en attente.","title":"pause_resume/pause"},{"location":"API_Server.html#pause_resumeresume","text":"Ce point de terminaison est similaire \u00e0 l'ex\u00e9cution de la commande G-Code \"RESUME\". Par exemple : {\"id\": 123, \"method\": \"pause_resume/resume\"} Comme pour le point de terminaison \"gcode/script\", ce point de terminaison ne se termine qu'apr\u00e8s la fin de toutes les commandes G-Code en attente.","title":"pause_resume/resume"},{"location":"API_Server.html#query_endstopsstatus","text":"Ce point de terminaison interrogera les fins de course actifs et renverra leur \u00e9tat. Par exemple : {\"id\": 123, \"method\": \"query_endstops/status\"} peut renvoyer : {\"id\": 123, \"result\": {\"y\": \"open \", \"x\": \"open\", \"z\": \"TRIGGERED\"}} Comme pour le point de terminaison \"gcode/script\", ce point de terminaison ne se termine qu'apr\u00e8s la fin de toutes les commandes G-Code en attente.","title":"query_endstops/status"},{"location":"BLTouch.html","text":"BL-Touch \u00b6 Connexion du BL-Touch \u00b6 Un avertissement avant de commencer : \u00c9vitez de toucher la broche BL-Touch avec vos doigts nus, car elle est tr\u00e8s sensible \u00e0 la graisse des doigts. Et si vous la touchez, soyez tr\u00e8s doux, afin de ne pas plier ou pousser quoi que ce soit. Connectez le connecteur \"servo\" de la BL-Touch \u00e0 une control_pin selon la documentation de la BL-Touch ou celle de votre MCU. En utilisant le c\u00e2blage originel, le fil jaune du c\u00e2blage triple est la control_pin et le fil blanc du c\u00e2blage double est la sensor_pin . Vous devez configurer ces broches en fonction de votre c\u00e2blage. La plupart des dispositifs BL-Touch n\u00e9cessitent un pullup sur la broche du capteur (pr\u00e9fixez le nom de la broche par \"^\"). Par exemple : [bltouch] sensor_pin: ^P1.24 control_pin: P1.26 Si le BL-Touch est utilis\u00e9 pour amener l'axe Z \u00e0 l'origine, r\u00e9glez endstop_pin : probe:z_virtual_endstop et supprimez position_endstop dans la section de configuration [stepper_z] , puis ajoutez une section de configuration [safe_z_home] pour lever l'axe z, ramener les axes xy \u00e0 la position d'origine, se d\u00e9placer au centre du lit et ramener l'axe z \u00e0 la position d'origine. Par exemple : [safe_z_home] home_xy_position: 100, 100 # Change coordinates to the center of your print bed speed: 50 z_hop: 10 # Move up 10mm z_hop_speed: 5 Il est important que le mouvement z_hop dans safe_z_home soit suffisamment \u00e9lev\u00e9 pour que la sonde ne heurte rien, m\u00eame si la broche de la sonde se trouve dans son \u00e9tat le plus bas. Tests initiaux \u00b6 Avant de poursuivre, v\u00e9rifiez que la BL-Touch est mont\u00e9e \u00e0 la bonne hauteur, la tige doit se trouver \u00e0 environ 2 mm au-dessus de la buse lorsqu'elle est r\u00e9tract\u00e9e Lorsque vous mettez l'imprimante sous tension, la sonde BL-Touch doit effectuer un auto-test en sortant et r\u00e9tractant le pointeau plusieurs Une fois l'auto-test termin\u00e9, le pointeau doit \u00eatre r\u00e9tract\u00e9 et le voyant rouge de la sonde doit \u00eatre allum\u00e9. En cas d'erreur, par exemple si la sonde clignote en rouge ou si le pointeau est en bas au lieu d'\u00eatre en haut, veuillez \u00e9teindre l'imprimante et v\u00e9rifier le c\u00e2blage et la configuration. Si tout ce qui pr\u00e9c\u00e8de semble bon, il est temps de tester que la broche de contr\u00f4le fonctionne correctement. Ex\u00e9cutez d'abord BLTOUCH_DEBUG COMMAND=pin_down dans votre terminal d'imprimante. V\u00e9rifiez que le pointeau se d\u00e9place vers le bas et que la LED rouge de la sonde s'\u00e9teint. Si ce n'est pas le cas, v\u00e9rifiez \u00e0 nouveau votre c\u00e2blage et votre configuration. Ensuite, lancez une commande BLTOUCH_DEBUG COMMAND=pin_up , v\u00e9rifiez que le pointeau se r\u00e9tracte et que la lumi\u00e8re rouge s'allume \u00e0 nouveau. Si elle clignote, il y a un probl\u00e8me. L'\u00e9tape suivante consiste \u00e0 confirmer que la tige du capteur fonctionne correctement. Ex\u00e9cutez BLTOUCH_DEBUG COMMAND=pin_down , v\u00e9rifiez que le pointeau se d\u00e9place vers le bas, ex\u00e9cutez BLTOUCH_DEBUG COMMAND=touch_mode , ex\u00e9cutez QUERY_PROBE , et v\u00e9rifiez que la commande rapporte \"probe : open\". Ensuite, tout en poussant l\u00e9g\u00e8rement le pointeau vers le haut avec l'ongle de votre doigt, ex\u00e9cutez \u00e0 nouveau QUERY_PROBE . V\u00e9rifiez que la commande rapporte \"probe : TRIGGERED\". Si l'une ou l'autre des requ\u00eates ne donne pas le bon message, cela indique g\u00e9n\u00e9ralement un c\u00e2blage ou une configuration incorrecte (certains clones peuvent n\u00e9cessiter une manipulation sp\u00e9ciale). A la fin de ce test, ex\u00e9cutez BLTOUCH_DEBUG COMMAND=pin_up et v\u00e9rifiez que le pointeau se d\u00e9place vers le haut. Apr\u00e8s avoir effectu\u00e9 les tests de la broche de contr\u00f4le et de la broche de d\u00e9tection du BL-Touch, il est maintenant temps de tester le palpage, mais avec une petite astuce. Au lieu de laisser le pointeau de la sonde toucher le lit d'impression, laissez-le toucher l'ongle de votre doigt. Positionnez la t\u00eate d'impression loin du lit, \u00e9mettez un G28 (ou PROBE si vous n'utilisez pas probe:z_virtual_endstop), attendez que la t\u00eate d'impression commence \u00e0 descendre, et arr\u00eatez le mouvement en touchant tr\u00e8s doucement le pointeau avec votre ongle. Il se peut que vous deviez le faire deux fois, car la configuration par d\u00e9faut de l'autoguidage sonde deux fois. Pr\u00e9parez-vous \u00e0 \u00e9teindre l'imprimante si elle ne s'arr\u00eate pas lorsque vous touchez le pointeau. Si ce test a r\u00e9ussi, faites un autre G28 (ou PROBE ) mais cette fois-ci laissez-le toucher le lit comme il se doit. BL-Touch d\u00e9faillant \u00b6 Une fois que le BL-Touch est dans un \u00e9tat incoh\u00e9rent, il se met \u00e0 clignoter en rouge. Vous pouvez le forcer \u00e0 quitter cet \u00e9tat en \u00e9mettant : BLTOUCH_DEBUG COMMAND=reset Cela peut se produire si son \u00e9talonnage est interrompu par un blocage de l'extraction du pointeau. Cependant, il se peut \u00e9galement que le BL-Touch ne soit plus capable de se calibrer lui-m\u00eame. Cela se produit si la vis situ\u00e9e sur le dessus est mal positionn\u00e9e ou si le noyau magn\u00e9tique \u00e0 l'int\u00e9rieur de la tige du pointeau a boug\u00e9. S'il s'est d\u00e9plac\u00e9 vers le haut au point de coller \u00e0 la vis, il se peut que le BL-Touch ne soit plus capable de lib\u00e9rer sa tige. Dans ce cas, vous devez ouvrir la vis et utiliser un stylo \u00e0 bille pour le remettre doucement en place. R\u00e9introduisez la tige dans le BL-Touch de fa\u00e7on \u00e0 ce qu'elle tombe dans la position extraite. R\u00e9ajustez d\u00e9licatement la vis sans t\u00eate du dessus. Vous devez trouver la juste position pour qu'elle soit capable d'abaisser et de relever la tige et que la lumi\u00e8re rouge s'allume et s'\u00e9teigne. Utilisez les commandes reset , pin_up et pin_down pour y parvenir. \"Clones\" du BL-Touch \u00b6 De nombreux \"clones\" BL-Touch fonctionnent correctement avec Klipper en utilisant la configuration par d\u00e9faut. Cependant, certains \"clones\" peuvent ne pas supporter la commande QUERY_PROBE et certains autres \"clones\" peuvent n\u00e9cessiter la configuration de pin_up_reports_not_triggered ou pin_up_touch_mode_reports_triggered . Important ! Ne configurez pas pin_up_reports_not_triggered ou pin_up_touch_mode_reports_triggered \u00e0 False sans suivre ces instructions. Ne configurez pas l'une ou l'autre de ces options sur False sur un v\u00e9ritable BL-Touch. Une configuration incorrecte de ces param\u00e8tres sur False peut augmenter le temps de palpage et peut augmenter le risque d'endommager l'imprimante. Certains \"clones\" ne supportent pas le touch_mode et par cons\u00e9quent la commande QUERY_PROBE ne fonctionne pas. Malgr\u00e9 cela, il est possible d'effectuer un palpage et une mise \u00e0 l'origine avec ces dispositifs. Sur ces dispositifs, la commande QUERY_PROBE pendant les tests initiaux n'aboutira pas, mais le test suivant G28 (ou PROBE ) aboutira. Il est possible d'utiliser ces \"clones\" avec Klipper tant que l'on n'utilise pas la commande QUERY_PROBE et que l'on n'active pas la fonction probe_with_touch_mode . Certains \"clones\" sont incapables d'effectuer le test de v\u00e9rification du capteur interne de Klipper. Sur ces appareils, les tentatives de mise \u00e0 l'origine ou de palpage peuvent entra\u00eener le signalement par Klipper de l'erreur \"BLTouch failed to verify sensor state\". Si cela se produit, ex\u00e9cutez manuellement les \u00e9tapes pour confirmer que la broche du capteur fonctionne comme d\u00e9crit dans la section tests initiaux . Si les commandes QUERY_PROBE de ce test produisent toujours les r\u00e9sultats attendus et que l'erreur \"BLTouch failed to verify sensor state\" se produit toujours, il peut \u00eatre n\u00e9cessaire de mettre pin_up_touch_mode_reports_triggered \u00e0 False dans le fichier de configuration de Klipper. Un nombre rare d'anciens \"clones\" sont incapables de signaler qu'ils ont r\u00e9ussi \u00e0 relever leur pointeau. Sur ces appareils, Klipper signalera une erreur \"BLTouch failed to raise probe\" apr\u00e8s chaque tentative de retour \u00e0 l'origine ou de palpage. On peut tester ces appareils - \u00e9loigner la t\u00eate du lit, ex\u00e9cuter BLTOUCH_DEBUG COMMAND=pin_down , v\u00e9rifier que le pointeau s'est d\u00e9plac\u00e9 vers le bas, ex\u00e9cuter QUERY_PROBE , v\u00e9rifier que la commande rapporte \"probe : open\", ex\u00e9cuter BLTOUCH_DEBUG COMMAND=pin_up , v\u00e9rifier que le pointeau s'est d\u00e9plac\u00e9 vers le haut, et ex\u00e9cuter QUERY_PROBE . Si la broche reste en haut, que le dispositif n'entre pas dans un \u00e9tat d'erreur, et que la premi\u00e8re requ\u00eate rapporte \"probe : open\" alors que la seconde rapporte \"probe : TRIGGERED\" alors cela indique que pin_up_reports_not_triggered doit \u00eatre mis \u00e0 False dans le fichier de configuration de Klipper. BL-Touch v3 \u00b6 Certains BL-Touch v3.0 et BL-Touch 3.1 peuvent n\u00e9cessiter la configuration de probe_with_touch_mode dans le fichier de configuration de l'imprimante. Si le fil de signal du BL-Touch v3.0 est connect\u00e9 \u00e0 une broche d'arr\u00eat (avec un condensateur de filtrage du bruit), il se peut que le BL-Touch v3.0 ne soit pas capable d'envoyer un signal de mani\u00e8re constante pendant la recherche de l'origine et le palpage. Si les commandes QUERY_PROBE dans la section des tests initiaux produisent toujours les r\u00e9sultats attendus, mais que la t\u00eate de l'outil ne s'arr\u00eate toujours pas pendant les commandes G28/PROBE, alors cela indique ce probl\u00e8me. Une solution de contournement est de d\u00e9finir probe_with_touch_mode : True dans le fichier de configuration. Le BL-Touch v3.1 peut entrer incorrectement dans un \u00e9tat d'erreur apr\u00e8s une tentative de sondage r\u00e9ussie. Les sympt\u00f4mes sont une lumi\u00e8re clignotante occasionnelle sur le BL-Touch v3.1 qui dure quelques secondes apr\u00e8s qu'il ait r\u00e9ussi \u00e0 entrer en contact avec le lit. Klipper devrait effacer cette erreur automatiquement et elle est g\u00e9n\u00e9ralement inoffensive. Cependant, on peut d\u00e9finir probe_with_touch_mode dans le fichier de configuration pour \u00e9viter ce probl\u00e8me. Important ! Certains \"clones\" ainsi que le BL-Touch v2.0 (et ant\u00e9rieur) peuvent avoir une pr\u00e9cision r\u00e9duite lorsque probe_with_touch_mode est r\u00e9gl\u00e9 sur True. Le r\u00e9glage de cette valeur sur True augmente \u00e9galement le temps n\u00e9cessaire au d\u00e9ploiement de la sonde. Si vous configurez cette valeur sur un dispositif BL-Touch \"clone\" ou plus ancien, assurez-vous de tester la pr\u00e9cision de la sonde avant et apr\u00e8s avoir d\u00e9fini cette valeur (utilisez la commande PROBE_ACCURACY pour tester). Multi-palpages sans r\u00e9traction du pointeau \u00b6 Par d\u00e9faut, Klipper d\u00e9ploie le pointeau au d\u00e9but de chaque tentative de mesure et le r\u00e9tracte ensuite. Ce d\u00e9ploiement et cette r\u00e9traction r\u00e9p\u00e9titifs du pointeau peuvent augmenter la dur\u00e9e totale des s\u00e9quences d'\u00e9talonnage impliquant de nombreuses mesures du plateau. Klipper permet de laisser le pointeau d\u00e9ploy\u00e9 entre deux mesures cons\u00e9cutives, ce qui peut r\u00e9duire la dur\u00e9e totale des mesures. Ce mode est activ\u00e9 en configurant stow_on_each_sample \u00e0 False dans le fichier de configuration. Important ! Si vous r\u00e9glez la valeur Stow_on_each_sample sur False, Klipper peut effectuer des mouvements horizontaux de la t\u00eate de l'outil durant le d\u00e9ploiement du palpeur. Assurez-vous que toutes les op\u00e9rations de palpage ont un d\u00e9gagement Z suffisant avant de r\u00e9gler cette valeur sur False. Si l'espace est insuffisant, un mouvement horizontal peut faire en sorte que le pointeau s'accroche \u00e0 une obstruction et endommager l'imprimante. Important ! Il est recommand\u00e9 d'utiliser probe_with_touch_mode configur\u00e9 \u00e0 True lorsque vous utilisez stow_on_each_sample configur\u00e9 \u00e0 False. Certains \"clones\" peuvent ne pas d\u00e9tecter un contact ult\u00e9rieur du lit si probe_with_touch_mode n'est pas configur\u00e9. Sur tous les dispositifs, l'utilisation de la combinaison de ces deux param\u00e8tres simplifie la signalisation de l'appareil, am\u00e9liorant la stabilit\u00e9 globale. Notez cependant que certains \"clones\" ainsi que le BL-Touch v2.0 (et ant\u00e9rieurs) peuvent avoir une pr\u00e9cision r\u00e9duite lorsque probe_with_touch_mode est r\u00e9gl\u00e9 sur True. Sur ces appareils, c'est une bonne id\u00e9e de tester la pr\u00e9cision de la sonde avant et apr\u00e8s avoir r\u00e9gl\u00e9 probe_with_touch_mode (utilisez la commande PROBE_ACCURACY pour tester). \u00c9talonnage des d\u00e9calages du BL-Touch \u00b6 Suivez les instructions du guide Calibration de la sonde pour d\u00e9finir les param\u00e8tres de configuration x_offset, y_offset et z_offset. C'est une bonne id\u00e9e de v\u00e9rifier que le d\u00e9calage Z est proche de 1mm. Si ce n'est pas le cas, vous devrez probablement d\u00e9placer le dispositif vers le haut ou vers le bas pour r\u00e9soudre ce probl\u00e8me. Vous voulez qu'il se d\u00e9clenche bien avant que la buse ne touche le lit, afin qu'un \u00e9ventuel filament coinc\u00e9 ou un lit d\u00e9form\u00e9 n'affecte pas l'action du BL-Touch. Mais en m\u00eame temps, vous voulez que la position r\u00e9tract\u00e9e soit aussi loin que possible au-dessus de la buse pour \u00e9viter qu'elle ne touche les pi\u00e8ces imprim\u00e9es. Si un ajustement est effectu\u00e9 sur la position du BL-Touch, recommencez les \u00e9tapes d'\u00e9talonnage de celui-ci. Mode de sortie du BL-Touch \u00b6 Un BL-Touch V3.0 accepte le r\u00e9glage d'un mode de sortie 5V ou OPEN-DRAIN, un BL-Touch V3.1 le supporte aussi et peut \u00e9galement le stocker dans son EEPROM interne. Si votre carte contr\u00f4leur a besoin du niveau logique haut de 5V du mode 5V, vous pouvez r\u00e9gler le param\u00e8tre 'set_output_mode' dans la section [bltouch] du fichier de configuration de l'imprimante sur \"5V\". N'utilisez le mode 5V que si la ligne d'entr\u00e9e de votre carte contr\u00f4leur est tol\u00e9rante \u00e0 cette tension (5V). C'est pourquoi la configuration par d\u00e9faut de ces versions de BL-Touch est le mode OPEN-DRAIN. Vous pourriez potentiellement endommager le CPU de votre carte contr\u00f4leur En r\u00e9sum\u00e9 : Si une carte contr\u00f4leur a besoin d'un mode 5V ET qu'elle est tol\u00e9rante \u00e0 5V sur sa ligne de signal d'entr\u00e9e ET si vous avez un BL-Touch Smart V3.0, vous devez utiliser le param\u00e8tre 'set_output_mode : 5V' pour assurer ce r\u00e9glage \u00e0 chaque d\u00e9marrage, puisque la sonde ne peut pas se souvenir du r\u00e9glage n\u00e9cessaire. vous avez un BL-Touch Smart V3.1, vous avez le choix d'utiliser 'set_output_mode : 5V' ou de m\u00e9moriser le mode une fois pour toutes en utilisant une commande 'BLTOUCH_STORE MODE=5V' manuellement et sans plus utiliser le param\u00e8tre 'set_output_mode:'. vous avez une autre sonde : Certaines sondes ont une trace sur la carte de circuit imprim\u00e9 \u00e0 couper ou un cavalier \u00e0 r\u00e9gler afin de d\u00e9finir (de fa\u00e7on permanente) le mode de sortie. Dans ce cas, omettez compl\u00e8tement le param\u00e8tre 'set_output_mode'. Si vous avez une version V3.1, n'automatisez pas ou ne r\u00e9p\u00e9tez pas la m\u00e9morisation du mode de sortie afin d'\u00e9viter d'user l'EEPROM de la sonde. L'EEPROM du BLTouch permet environ 100.000 mises \u00e0 jour. 100 mises \u00e0 jour par jour repr\u00e9sentent environ 3 ans de fonctionnement avant l'usure de la m\u00e9moire. Ainsi, le stockage du mode de sortie dans la V3.1 est con\u00e7u par le vendeur pour \u00eatre une op\u00e9ration compliqu\u00e9e (le d\u00e9faut d'usine \u00e9tant un mode s\u00fbr OPEN DRAIN) et n'est pas adapt\u00e9 pour \u00eatre \u00e9mis de mani\u00e8re r\u00e9p\u00e9t\u00e9e par un trancheur, une macro ou autre, il est pr\u00e9f\u00e9rable de ne l'utiliser que lors de la premi\u00e8re int\u00e9gration de la sonde dans l'\u00e9lectronique de l'imprimante.","title":"BL-Touch"},{"location":"BLTouch.html#bl-touch","text":"","title":"BL-Touch"},{"location":"BLTouch.html#connexion-du-bl-touch","text":"Un avertissement avant de commencer : \u00c9vitez de toucher la broche BL-Touch avec vos doigts nus, car elle est tr\u00e8s sensible \u00e0 la graisse des doigts. Et si vous la touchez, soyez tr\u00e8s doux, afin de ne pas plier ou pousser quoi que ce soit. Connectez le connecteur \"servo\" de la BL-Touch \u00e0 une control_pin selon la documentation de la BL-Touch ou celle de votre MCU. En utilisant le c\u00e2blage originel, le fil jaune du c\u00e2blage triple est la control_pin et le fil blanc du c\u00e2blage double est la sensor_pin . Vous devez configurer ces broches en fonction de votre c\u00e2blage. La plupart des dispositifs BL-Touch n\u00e9cessitent un pullup sur la broche du capteur (pr\u00e9fixez le nom de la broche par \"^\"). Par exemple : [bltouch] sensor_pin: ^P1.24 control_pin: P1.26 Si le BL-Touch est utilis\u00e9 pour amener l'axe Z \u00e0 l'origine, r\u00e9glez endstop_pin : probe:z_virtual_endstop et supprimez position_endstop dans la section de configuration [stepper_z] , puis ajoutez une section de configuration [safe_z_home] pour lever l'axe z, ramener les axes xy \u00e0 la position d'origine, se d\u00e9placer au centre du lit et ramener l'axe z \u00e0 la position d'origine. Par exemple : [safe_z_home] home_xy_position: 100, 100 # Change coordinates to the center of your print bed speed: 50 z_hop: 10 # Move up 10mm z_hop_speed: 5 Il est important que le mouvement z_hop dans safe_z_home soit suffisamment \u00e9lev\u00e9 pour que la sonde ne heurte rien, m\u00eame si la broche de la sonde se trouve dans son \u00e9tat le plus bas.","title":"Connexion du BL-Touch"},{"location":"BLTouch.html#tests-initiaux","text":"Avant de poursuivre, v\u00e9rifiez que la BL-Touch est mont\u00e9e \u00e0 la bonne hauteur, la tige doit se trouver \u00e0 environ 2 mm au-dessus de la buse lorsqu'elle est r\u00e9tract\u00e9e Lorsque vous mettez l'imprimante sous tension, la sonde BL-Touch doit effectuer un auto-test en sortant et r\u00e9tractant le pointeau plusieurs Une fois l'auto-test termin\u00e9, le pointeau doit \u00eatre r\u00e9tract\u00e9 et le voyant rouge de la sonde doit \u00eatre allum\u00e9. En cas d'erreur, par exemple si la sonde clignote en rouge ou si le pointeau est en bas au lieu d'\u00eatre en haut, veuillez \u00e9teindre l'imprimante et v\u00e9rifier le c\u00e2blage et la configuration. Si tout ce qui pr\u00e9c\u00e8de semble bon, il est temps de tester que la broche de contr\u00f4le fonctionne correctement. Ex\u00e9cutez d'abord BLTOUCH_DEBUG COMMAND=pin_down dans votre terminal d'imprimante. V\u00e9rifiez que le pointeau se d\u00e9place vers le bas et que la LED rouge de la sonde s'\u00e9teint. Si ce n'est pas le cas, v\u00e9rifiez \u00e0 nouveau votre c\u00e2blage et votre configuration. Ensuite, lancez une commande BLTOUCH_DEBUG COMMAND=pin_up , v\u00e9rifiez que le pointeau se r\u00e9tracte et que la lumi\u00e8re rouge s'allume \u00e0 nouveau. Si elle clignote, il y a un probl\u00e8me. L'\u00e9tape suivante consiste \u00e0 confirmer que la tige du capteur fonctionne correctement. Ex\u00e9cutez BLTOUCH_DEBUG COMMAND=pin_down , v\u00e9rifiez que le pointeau se d\u00e9place vers le bas, ex\u00e9cutez BLTOUCH_DEBUG COMMAND=touch_mode , ex\u00e9cutez QUERY_PROBE , et v\u00e9rifiez que la commande rapporte \"probe : open\". Ensuite, tout en poussant l\u00e9g\u00e8rement le pointeau vers le haut avec l'ongle de votre doigt, ex\u00e9cutez \u00e0 nouveau QUERY_PROBE . V\u00e9rifiez que la commande rapporte \"probe : TRIGGERED\". Si l'une ou l'autre des requ\u00eates ne donne pas le bon message, cela indique g\u00e9n\u00e9ralement un c\u00e2blage ou une configuration incorrecte (certains clones peuvent n\u00e9cessiter une manipulation sp\u00e9ciale). A la fin de ce test, ex\u00e9cutez BLTOUCH_DEBUG COMMAND=pin_up et v\u00e9rifiez que le pointeau se d\u00e9place vers le haut. Apr\u00e8s avoir effectu\u00e9 les tests de la broche de contr\u00f4le et de la broche de d\u00e9tection du BL-Touch, il est maintenant temps de tester le palpage, mais avec une petite astuce. Au lieu de laisser le pointeau de la sonde toucher le lit d'impression, laissez-le toucher l'ongle de votre doigt. Positionnez la t\u00eate d'impression loin du lit, \u00e9mettez un G28 (ou PROBE si vous n'utilisez pas probe:z_virtual_endstop), attendez que la t\u00eate d'impression commence \u00e0 descendre, et arr\u00eatez le mouvement en touchant tr\u00e8s doucement le pointeau avec votre ongle. Il se peut que vous deviez le faire deux fois, car la configuration par d\u00e9faut de l'autoguidage sonde deux fois. Pr\u00e9parez-vous \u00e0 \u00e9teindre l'imprimante si elle ne s'arr\u00eate pas lorsque vous touchez le pointeau. Si ce test a r\u00e9ussi, faites un autre G28 (ou PROBE ) mais cette fois-ci laissez-le toucher le lit comme il se doit.","title":"Tests initiaux"},{"location":"BLTouch.html#bl-touch-defaillant","text":"Une fois que le BL-Touch est dans un \u00e9tat incoh\u00e9rent, il se met \u00e0 clignoter en rouge. Vous pouvez le forcer \u00e0 quitter cet \u00e9tat en \u00e9mettant : BLTOUCH_DEBUG COMMAND=reset Cela peut se produire si son \u00e9talonnage est interrompu par un blocage de l'extraction du pointeau. Cependant, il se peut \u00e9galement que le BL-Touch ne soit plus capable de se calibrer lui-m\u00eame. Cela se produit si la vis situ\u00e9e sur le dessus est mal positionn\u00e9e ou si le noyau magn\u00e9tique \u00e0 l'int\u00e9rieur de la tige du pointeau a boug\u00e9. S'il s'est d\u00e9plac\u00e9 vers le haut au point de coller \u00e0 la vis, il se peut que le BL-Touch ne soit plus capable de lib\u00e9rer sa tige. Dans ce cas, vous devez ouvrir la vis et utiliser un stylo \u00e0 bille pour le remettre doucement en place. R\u00e9introduisez la tige dans le BL-Touch de fa\u00e7on \u00e0 ce qu'elle tombe dans la position extraite. R\u00e9ajustez d\u00e9licatement la vis sans t\u00eate du dessus. Vous devez trouver la juste position pour qu'elle soit capable d'abaisser et de relever la tige et que la lumi\u00e8re rouge s'allume et s'\u00e9teigne. Utilisez les commandes reset , pin_up et pin_down pour y parvenir.","title":"BL-Touch d\u00e9faillant"},{"location":"BLTouch.html#clones-du-bl-touch","text":"De nombreux \"clones\" BL-Touch fonctionnent correctement avec Klipper en utilisant la configuration par d\u00e9faut. Cependant, certains \"clones\" peuvent ne pas supporter la commande QUERY_PROBE et certains autres \"clones\" peuvent n\u00e9cessiter la configuration de pin_up_reports_not_triggered ou pin_up_touch_mode_reports_triggered . Important ! Ne configurez pas pin_up_reports_not_triggered ou pin_up_touch_mode_reports_triggered \u00e0 False sans suivre ces instructions. Ne configurez pas l'une ou l'autre de ces options sur False sur un v\u00e9ritable BL-Touch. Une configuration incorrecte de ces param\u00e8tres sur False peut augmenter le temps de palpage et peut augmenter le risque d'endommager l'imprimante. Certains \"clones\" ne supportent pas le touch_mode et par cons\u00e9quent la commande QUERY_PROBE ne fonctionne pas. Malgr\u00e9 cela, il est possible d'effectuer un palpage et une mise \u00e0 l'origine avec ces dispositifs. Sur ces dispositifs, la commande QUERY_PROBE pendant les tests initiaux n'aboutira pas, mais le test suivant G28 (ou PROBE ) aboutira. Il est possible d'utiliser ces \"clones\" avec Klipper tant que l'on n'utilise pas la commande QUERY_PROBE et que l'on n'active pas la fonction probe_with_touch_mode . Certains \"clones\" sont incapables d'effectuer le test de v\u00e9rification du capteur interne de Klipper. Sur ces appareils, les tentatives de mise \u00e0 l'origine ou de palpage peuvent entra\u00eener le signalement par Klipper de l'erreur \"BLTouch failed to verify sensor state\". Si cela se produit, ex\u00e9cutez manuellement les \u00e9tapes pour confirmer que la broche du capteur fonctionne comme d\u00e9crit dans la section tests initiaux . Si les commandes QUERY_PROBE de ce test produisent toujours les r\u00e9sultats attendus et que l'erreur \"BLTouch failed to verify sensor state\" se produit toujours, il peut \u00eatre n\u00e9cessaire de mettre pin_up_touch_mode_reports_triggered \u00e0 False dans le fichier de configuration de Klipper. Un nombre rare d'anciens \"clones\" sont incapables de signaler qu'ils ont r\u00e9ussi \u00e0 relever leur pointeau. Sur ces appareils, Klipper signalera une erreur \"BLTouch failed to raise probe\" apr\u00e8s chaque tentative de retour \u00e0 l'origine ou de palpage. On peut tester ces appareils - \u00e9loigner la t\u00eate du lit, ex\u00e9cuter BLTOUCH_DEBUG COMMAND=pin_down , v\u00e9rifier que le pointeau s'est d\u00e9plac\u00e9 vers le bas, ex\u00e9cuter QUERY_PROBE , v\u00e9rifier que la commande rapporte \"probe : open\", ex\u00e9cuter BLTOUCH_DEBUG COMMAND=pin_up , v\u00e9rifier que le pointeau s'est d\u00e9plac\u00e9 vers le haut, et ex\u00e9cuter QUERY_PROBE . Si la broche reste en haut, que le dispositif n'entre pas dans un \u00e9tat d'erreur, et que la premi\u00e8re requ\u00eate rapporte \"probe : open\" alors que la seconde rapporte \"probe : TRIGGERED\" alors cela indique que pin_up_reports_not_triggered doit \u00eatre mis \u00e0 False dans le fichier de configuration de Klipper.","title":"\"Clones\" du BL-Touch"},{"location":"BLTouch.html#bl-touch-v3","text":"Certains BL-Touch v3.0 et BL-Touch 3.1 peuvent n\u00e9cessiter la configuration de probe_with_touch_mode dans le fichier de configuration de l'imprimante. Si le fil de signal du BL-Touch v3.0 est connect\u00e9 \u00e0 une broche d'arr\u00eat (avec un condensateur de filtrage du bruit), il se peut que le BL-Touch v3.0 ne soit pas capable d'envoyer un signal de mani\u00e8re constante pendant la recherche de l'origine et le palpage. Si les commandes QUERY_PROBE dans la section des tests initiaux produisent toujours les r\u00e9sultats attendus, mais que la t\u00eate de l'outil ne s'arr\u00eate toujours pas pendant les commandes G28/PROBE, alors cela indique ce probl\u00e8me. Une solution de contournement est de d\u00e9finir probe_with_touch_mode : True dans le fichier de configuration. Le BL-Touch v3.1 peut entrer incorrectement dans un \u00e9tat d'erreur apr\u00e8s une tentative de sondage r\u00e9ussie. Les sympt\u00f4mes sont une lumi\u00e8re clignotante occasionnelle sur le BL-Touch v3.1 qui dure quelques secondes apr\u00e8s qu'il ait r\u00e9ussi \u00e0 entrer en contact avec le lit. Klipper devrait effacer cette erreur automatiquement et elle est g\u00e9n\u00e9ralement inoffensive. Cependant, on peut d\u00e9finir probe_with_touch_mode dans le fichier de configuration pour \u00e9viter ce probl\u00e8me. Important ! Certains \"clones\" ainsi que le BL-Touch v2.0 (et ant\u00e9rieur) peuvent avoir une pr\u00e9cision r\u00e9duite lorsque probe_with_touch_mode est r\u00e9gl\u00e9 sur True. Le r\u00e9glage de cette valeur sur True augmente \u00e9galement le temps n\u00e9cessaire au d\u00e9ploiement de la sonde. Si vous configurez cette valeur sur un dispositif BL-Touch \"clone\" ou plus ancien, assurez-vous de tester la pr\u00e9cision de la sonde avant et apr\u00e8s avoir d\u00e9fini cette valeur (utilisez la commande PROBE_ACCURACY pour tester).","title":"BL-Touch v3"},{"location":"BLTouch.html#multi-palpages-sans-retraction-du-pointeau","text":"Par d\u00e9faut, Klipper d\u00e9ploie le pointeau au d\u00e9but de chaque tentative de mesure et le r\u00e9tracte ensuite. Ce d\u00e9ploiement et cette r\u00e9traction r\u00e9p\u00e9titifs du pointeau peuvent augmenter la dur\u00e9e totale des s\u00e9quences d'\u00e9talonnage impliquant de nombreuses mesures du plateau. Klipper permet de laisser le pointeau d\u00e9ploy\u00e9 entre deux mesures cons\u00e9cutives, ce qui peut r\u00e9duire la dur\u00e9e totale des mesures. Ce mode est activ\u00e9 en configurant stow_on_each_sample \u00e0 False dans le fichier de configuration. Important ! Si vous r\u00e9glez la valeur Stow_on_each_sample sur False, Klipper peut effectuer des mouvements horizontaux de la t\u00eate de l'outil durant le d\u00e9ploiement du palpeur. Assurez-vous que toutes les op\u00e9rations de palpage ont un d\u00e9gagement Z suffisant avant de r\u00e9gler cette valeur sur False. Si l'espace est insuffisant, un mouvement horizontal peut faire en sorte que le pointeau s'accroche \u00e0 une obstruction et endommager l'imprimante. Important ! Il est recommand\u00e9 d'utiliser probe_with_touch_mode configur\u00e9 \u00e0 True lorsque vous utilisez stow_on_each_sample configur\u00e9 \u00e0 False. Certains \"clones\" peuvent ne pas d\u00e9tecter un contact ult\u00e9rieur du lit si probe_with_touch_mode n'est pas configur\u00e9. Sur tous les dispositifs, l'utilisation de la combinaison de ces deux param\u00e8tres simplifie la signalisation de l'appareil, am\u00e9liorant la stabilit\u00e9 globale. Notez cependant que certains \"clones\" ainsi que le BL-Touch v2.0 (et ant\u00e9rieurs) peuvent avoir une pr\u00e9cision r\u00e9duite lorsque probe_with_touch_mode est r\u00e9gl\u00e9 sur True. Sur ces appareils, c'est une bonne id\u00e9e de tester la pr\u00e9cision de la sonde avant et apr\u00e8s avoir r\u00e9gl\u00e9 probe_with_touch_mode (utilisez la commande PROBE_ACCURACY pour tester).","title":"Multi-palpages sans r\u00e9traction du pointeau"},{"location":"BLTouch.html#etalonnage-des-decalages-du-bl-touch","text":"Suivez les instructions du guide Calibration de la sonde pour d\u00e9finir les param\u00e8tres de configuration x_offset, y_offset et z_offset. C'est une bonne id\u00e9e de v\u00e9rifier que le d\u00e9calage Z est proche de 1mm. Si ce n'est pas le cas, vous devrez probablement d\u00e9placer le dispositif vers le haut ou vers le bas pour r\u00e9soudre ce probl\u00e8me. Vous voulez qu'il se d\u00e9clenche bien avant que la buse ne touche le lit, afin qu'un \u00e9ventuel filament coinc\u00e9 ou un lit d\u00e9form\u00e9 n'affecte pas l'action du BL-Touch. Mais en m\u00eame temps, vous voulez que la position r\u00e9tract\u00e9e soit aussi loin que possible au-dessus de la buse pour \u00e9viter qu'elle ne touche les pi\u00e8ces imprim\u00e9es. Si un ajustement est effectu\u00e9 sur la position du BL-Touch, recommencez les \u00e9tapes d'\u00e9talonnage de celui-ci.","title":"\u00c9talonnage des d\u00e9calages du BL-Touch"},{"location":"BLTouch.html#mode-de-sortie-du-bl-touch","text":"Un BL-Touch V3.0 accepte le r\u00e9glage d'un mode de sortie 5V ou OPEN-DRAIN, un BL-Touch V3.1 le supporte aussi et peut \u00e9galement le stocker dans son EEPROM interne. Si votre carte contr\u00f4leur a besoin du niveau logique haut de 5V du mode 5V, vous pouvez r\u00e9gler le param\u00e8tre 'set_output_mode' dans la section [bltouch] du fichier de configuration de l'imprimante sur \"5V\". N'utilisez le mode 5V que si la ligne d'entr\u00e9e de votre carte contr\u00f4leur est tol\u00e9rante \u00e0 cette tension (5V). C'est pourquoi la configuration par d\u00e9faut de ces versions de BL-Touch est le mode OPEN-DRAIN. Vous pourriez potentiellement endommager le CPU de votre carte contr\u00f4leur En r\u00e9sum\u00e9 : Si une carte contr\u00f4leur a besoin d'un mode 5V ET qu'elle est tol\u00e9rante \u00e0 5V sur sa ligne de signal d'entr\u00e9e ET si vous avez un BL-Touch Smart V3.0, vous devez utiliser le param\u00e8tre 'set_output_mode : 5V' pour assurer ce r\u00e9glage \u00e0 chaque d\u00e9marrage, puisque la sonde ne peut pas se souvenir du r\u00e9glage n\u00e9cessaire. vous avez un BL-Touch Smart V3.1, vous avez le choix d'utiliser 'set_output_mode : 5V' ou de m\u00e9moriser le mode une fois pour toutes en utilisant une commande 'BLTOUCH_STORE MODE=5V' manuellement et sans plus utiliser le param\u00e8tre 'set_output_mode:'. vous avez une autre sonde : Certaines sondes ont une trace sur la carte de circuit imprim\u00e9 \u00e0 couper ou un cavalier \u00e0 r\u00e9gler afin de d\u00e9finir (de fa\u00e7on permanente) le mode de sortie. Dans ce cas, omettez compl\u00e8tement le param\u00e8tre 'set_output_mode'. Si vous avez une version V3.1, n'automatisez pas ou ne r\u00e9p\u00e9tez pas la m\u00e9morisation du mode de sortie afin d'\u00e9viter d'user l'EEPROM de la sonde. L'EEPROM du BLTouch permet environ 100.000 mises \u00e0 jour. 100 mises \u00e0 jour par jour repr\u00e9sentent environ 3 ans de fonctionnement avant l'usure de la m\u00e9moire. Ainsi, le stockage du mode de sortie dans la V3.1 est con\u00e7u par le vendeur pour \u00eatre une op\u00e9ration compliqu\u00e9e (le d\u00e9faut d'usine \u00e9tant un mode s\u00fbr OPEN DRAIN) et n'est pas adapt\u00e9 pour \u00eatre \u00e9mis de mani\u00e8re r\u00e9p\u00e9t\u00e9e par un trancheur, une macro ou autre, il est pr\u00e9f\u00e9rable de ne l'utiliser que lors de la premi\u00e8re int\u00e9gration de la sonde dans l'\u00e9lectronique de l'imprimante.","title":"Mode de sortie du BL-Touch"},{"location":"Beaglebone.html","text":"Beaglebone \u00b6 Ce document d\u00e9crit le processus d'ex\u00e9cution de Klipper sur un Beaglebone PRU. Construire l'image de l'OS \u00b6 Commencez par installer l'image Debian 9.9 2019-08-03 4GB SD IoT . Vous pouvez ex\u00e9cuter l'image \u00e0 partir d'une carte micro-SD ou de la carte eMMC int\u00e9gr\u00e9e. Si vous utilisez l'eMMC, installez-la sur l'eMMC maintenant en suivant les instructions du lien ci-dessus. Ensuite, connectez-vous \u00e0 la machine Beaglebone ( ssh debian@beaglebone -- le mot de passe est temppwd ) et installez Klipper en ex\u00e9cutant les commandes suivantes : git clone https://github.com/Klipper3d/klipper ./klipper/scripts/install-beaglebone.sh Installer Octoprint \u00b6 On peut ensuite installer Octoprint : git clone https://github.com/foosel/OctoPrint.git cd OctoPrint/ virtualenv venv ./venv/bin/python setup.py install Et configurer OctoPrint pour qu'il d\u00e9marre au d\u00e9marrage : sudo cp ~/OctoPrint/scripts/octoprint.init /etc/init.d/octoprint sudo chmod +x /etc/init.d/octoprint sudo cp ~/OctoPrint/scripts/octoprint.default /etc/default/octoprint sudo update-rc.d octoprint defaults Il est n\u00e9cessaire de modifier le fichier de configuration d'OctoPrint /etc/default/octoprint . Il faut changer l'utilisateur OCTOPRINT_USER en debian , changer NICELEVEL en 0 , d\u00e9commenter les param\u00e8tres BASEDIR , CONFIGFILE , et DAEMON et changer les r\u00e9f\u00e9rences de /home/pi/ en /home/debian/ : sudo nano /etc/default/octoprint D\u00e9marrez ensuite le service Octoprint : sudo systemctl start octoprint Assurez-vous que le serveur web OctoPrint est accessible - il devrait se trouver \u00e0 l'adresse suivante : http://beaglebone:5000/ Construire le code du microcontr\u00f4leur \u00b6 Pour compiler le code du microcontr\u00f4leur Klipper, commencez par le configurer pour le \"Beaglebone PRU\" : cd ~/klipper/ make menuconfig Pour compiler et installer le nouveau code du microcontr\u00f4leur, ex\u00e9cutez : sudo service klipper stop make flash sudo service klipper start Il est \u00e9galement n\u00e9cessaire de compiler et d'installer le code du microcontr\u00f4leur pour un processus h\u00f4te Linux. Configurez-le une seconde fois pour un \"processus Linux\" : make menuconfig Puis installez \u00e9galement ce code de micro-contr\u00f4leur : sudo service klipper stop make flash sudo service klipper start Configuration restante \u00b6 Terminez l'installation en configurant Klipper et Octoprint en suivant les instructions du document principal Installation . Imprimer avec le Beaglebone \u00b6 Malheureusement, le processeur du Beaglebone peut parfois avoir du mal \u00e0 faire fonctionner OctoPrint correctement. Des blocages d'impression sont connus pour se produire sur des impressions complexes (l'imprimante peut se d\u00e9placer plus rapidement qu'OctoPrint ne peut envoyer de commandes de mouvement). Si cela se produit, envisagez d'utiliser la fonctionnalit\u00e9 \"virtual_sdcard\" (voir R\u00e9f\u00e9rence des configurations pour plus de d\u00e9tails) pour imprimer directement depuis Klipper.","title":"Beaglebone"},{"location":"Beaglebone.html#beaglebone","text":"Ce document d\u00e9crit le processus d'ex\u00e9cution de Klipper sur un Beaglebone PRU.","title":"Beaglebone"},{"location":"Beaglebone.html#construire-limage-de-los","text":"Commencez par installer l'image Debian 9.9 2019-08-03 4GB SD IoT . Vous pouvez ex\u00e9cuter l'image \u00e0 partir d'une carte micro-SD ou de la carte eMMC int\u00e9gr\u00e9e. Si vous utilisez l'eMMC, installez-la sur l'eMMC maintenant en suivant les instructions du lien ci-dessus. Ensuite, connectez-vous \u00e0 la machine Beaglebone ( ssh debian@beaglebone -- le mot de passe est temppwd ) et installez Klipper en ex\u00e9cutant les commandes suivantes : git clone https://github.com/Klipper3d/klipper ./klipper/scripts/install-beaglebone.sh","title":"Construire l'image de l'OS"},{"location":"Beaglebone.html#installer-octoprint","text":"On peut ensuite installer Octoprint : git clone https://github.com/foosel/OctoPrint.git cd OctoPrint/ virtualenv venv ./venv/bin/python setup.py install Et configurer OctoPrint pour qu'il d\u00e9marre au d\u00e9marrage : sudo cp ~/OctoPrint/scripts/octoprint.init /etc/init.d/octoprint sudo chmod +x /etc/init.d/octoprint sudo cp ~/OctoPrint/scripts/octoprint.default /etc/default/octoprint sudo update-rc.d octoprint defaults Il est n\u00e9cessaire de modifier le fichier de configuration d'OctoPrint /etc/default/octoprint . Il faut changer l'utilisateur OCTOPRINT_USER en debian , changer NICELEVEL en 0 , d\u00e9commenter les param\u00e8tres BASEDIR , CONFIGFILE , et DAEMON et changer les r\u00e9f\u00e9rences de /home/pi/ en /home/debian/ : sudo nano /etc/default/octoprint D\u00e9marrez ensuite le service Octoprint : sudo systemctl start octoprint Assurez-vous que le serveur web OctoPrint est accessible - il devrait se trouver \u00e0 l'adresse suivante : http://beaglebone:5000/","title":"Installer Octoprint"},{"location":"Beaglebone.html#construire-le-code-du-microcontroleur","text":"Pour compiler le code du microcontr\u00f4leur Klipper, commencez par le configurer pour le \"Beaglebone PRU\" : cd ~/klipper/ make menuconfig Pour compiler et installer le nouveau code du microcontr\u00f4leur, ex\u00e9cutez : sudo service klipper stop make flash sudo service klipper start Il est \u00e9galement n\u00e9cessaire de compiler et d'installer le code du microcontr\u00f4leur pour un processus h\u00f4te Linux. Configurez-le une seconde fois pour un \"processus Linux\" : make menuconfig Puis installez \u00e9galement ce code de micro-contr\u00f4leur : sudo service klipper stop make flash sudo service klipper start","title":"Construire le code du microcontr\u00f4leur"},{"location":"Beaglebone.html#configuration-restante","text":"Terminez l'installation en configurant Klipper et Octoprint en suivant les instructions du document principal Installation .","title":"Configuration restante"},{"location":"Beaglebone.html#imprimer-avec-le-beaglebone","text":"Malheureusement, le processeur du Beaglebone peut parfois avoir du mal \u00e0 faire fonctionner OctoPrint correctement. Des blocages d'impression sont connus pour se produire sur des impressions complexes (l'imprimante peut se d\u00e9placer plus rapidement qu'OctoPrint ne peut envoyer de commandes de mouvement). Si cela se produit, envisagez d'utiliser la fonctionnalit\u00e9 \"virtual_sdcard\" (voir R\u00e9f\u00e9rence des configurations pour plus de d\u00e9tails) pour imprimer directement depuis Klipper.","title":"Imprimer avec le Beaglebone"},{"location":"Bed_Level.html","text":"Nivellement du lit \u00b6 Le nivellement du lit (parfois aussi appel\u00e9 \u00ab tramage du lit \u00bb) est essentiel pour obtenir des impressions de haute qualit\u00e9. Si un lit n'est pas correctement \"nivel\u00e9\", cela peut entra\u00eener une mauvaise adh\u00e9rence du lit, un \"gauchissement\" et des probl\u00e8mes subtils tout au long de l'impression. Ce document sert de guide pour effectuer le nivellement du lit dans Klipper. Il est important de comprendre l'objectif du nivellement du lit. Si l'imprimante doit aller \u00e0 la position X0 Y0 Z10 pendant une impression, alors l'objectif est que la buse de l'imprimante soit exactement \u00e0 10 mm du lit de l'imprimante. De plus, si l'imprimante doit ensuite aller \u00e0 la position \"X50 Z10\", l'objectif est que la buse maintienne une distance exacte de 10 mm du lit pendant tout ce mouvement horizontal. Afin d'obtenir des impressions de bonne qualit\u00e9, l'imprimante doit \u00eatre calibr\u00e9e de sorte que les distances Z soient pr\u00e9cises \u00e0 environ 25 microns (0,025 mm). Il s'agit d'une petite distance - nettement inf\u00e9rieure \u00e0 la largeur d'un cheveu humain. Cette \u00e9chelle ne peut pas \u00eatre mesur\u00e9e \"\u00e0 l'\u0153il\". Des effets subtils (tels que la dilatation thermique) ont un impact sur les mesures \u00e0 cette \u00e9chelle. Le secret pour obtenir une grande pr\u00e9cision est d'utiliser un processus reproductible et d'utiliser une m\u00e9thode de mise \u00e0 niveau qui tire parti de la haute pr\u00e9cision du propre syst\u00e8me de mouvement de l'imprimante. Choisissez le m\u00e9canisme d'\u00e9talonnage appropri\u00e9 \u00b6 Diff\u00e9rents types d'imprimantes utilisent diff\u00e9rentes m\u00e9thodes pour effectuer le nivellement du lit. A la fin toutes les m\u00e9thodes d\u00e9pendent du \"test du papier\" (d\u00e9crit ci-dessous). Cependant, le processus pour un type particulier d'imprimante est d\u00e9crit dans les autres documents. Avant d'ex\u00e9cuter l'un de ces outils d'\u00e9talonnage, assurez-vous d'ex\u00e9cuter les v\u00e9rifications d\u00e9crites dans le document de v\u00e9rification de la configuration . Il est n\u00e9cessaire de v\u00e9rifier les mouvements de base de l'imprimante avant d'effectuer le nivellement du lit. Pour les imprimantes avec une sonde Z automatique, assurez-vous de calibrer la sonde en suivant les instructions du document R\u00e9glages de la sonde . Pour les imprimantes delta, consultez le document R\u00e9glage des deltas . Pour les imprimantes avec un lit r\u00e9glable par vis et des fin de course Z traditionnels, consultez le document Nivellement manuel . Pendant le calibrage, il peut \u00eatre n\u00e9cessaire de d\u00e9finir la position_min du Z de l'imprimante sur un nombre n\u00e9gatif (par exemple, position_min = -2 ). L'imprimante effectue des v\u00e9rifications des limites m\u00eame pendant les routines d'\u00e9talonnage. La d\u00e9finition d'un nombre n\u00e9gatif permet \u00e0 l'imprimante de se d\u00e9placer en dessous de la position nominale du lit, ce qui peut aider \u00e0 d\u00e9terminer la position r\u00e9elle du lit. Le \"Test du papier\" \u00b6 Le principal m\u00e9canisme d'\u00e9talonnage du lit est le \"test du papier\". Il s'agit de placer un morceau r\u00e9gulier de \"papier pour photocopieuse\" entre le lit et la buse de l'imprimante, puis de d\u00e9placer la buse \u00e0 diff\u00e9rentes hauteurs Z jusqu'\u00e0 ce que l'on ressente une petite friction lorsque l'on pousse le papier d'avant en arri\u00e8re. Il est important de bien comprendre le \"test papier\" m\u00eame si l'on dispose d'une \"sonde Z automatique\". La sonde elle-m\u00eame doit souvent \u00eatre calibr\u00e9e pour obtenir de bons r\u00e9sultats. Cet \u00e9talonnage de la sonde est effectu\u00e9 \u00e0 l'aide de ce \"test papier\". Afin d'effectuer le test du papier, coupez un petit morceau de papier rectangulaire \u00e0 l'aide d'une paire de ciseaux (par exemple, 5x3 cm). Le papier a g\u00e9n\u00e9ralement une \u00e9paisseur d'environ 100 microns (0,100 mm). (L'\u00e9paisseur exacte du papier n'est pas cruciale.) La premi\u00e8re \u00e9tape du test du papier consiste \u00e0 inspecter la buse et le lit de l'imprimante. Assurez-vous qu'il n'y a pas de plastique (ou d'autres d\u00e9bris) sur la buse ou le lit. Inspectez la buse et le lit pour vous assurer qu'il n'y a pas de plastique ! Si l'on imprime toujours sur une bande adh\u00e9sive ou une surface d'impression particuli\u00e8re, on peut alors effectuer le test papier avec cette bande/surface en place. Cependant, notez que le ruban lui-m\u00eame a une \u00e9paisseur et que diff\u00e9rents rubans (ou toute autre surface d'impression) auront un impact sur les mesures Z. Assurez-vous de relancer le test du papier pour mesurer chaque type de surface utilis\u00e9. S'il y a du plastique sur la buse, chauffez la buse et utilisez une pince \u00e0 \u00e9piler en m\u00e9tal pour retirer ce plastique. Attendez que la buse refroidisse compl\u00e8tement \u00e0 temp\u00e9rature ambiante avant de continuer avec le test papier. Pendant que la buse refroidit, utilisez la pince \u00e0 \u00e9piler en m\u00e9tal pour retirer tout plastique susceptible de suinter. Effectuez toujours le test du papier lorsque la buse et le lit sont \u00e0 temp\u00e9rature ambiante ! Lorsque la buse est chauff\u00e9e, sa position (par rapport au lit) change en raison de la dilatation thermique. Cette dilatation thermique est g\u00e9n\u00e9ralement d'environ 100 microns, ce qui correspond \u00e0 peu pr\u00e8s \u00e0 la m\u00eame \u00e9paisseur qu'un morceau de papier d'imprimante typique. La quantit\u00e9 exacte de dilatation thermique n'est pas cruciale, tout comme l'\u00e9paisseur exacte du papier n'est pas cruciale. Commencez par l'hypoth\u00e8se que les deux sont \u00e9gaux (voir ci-dessous pour une m\u00e9thode de d\u00e9termination de la diff\u00e9rence entre les deux distances). Il peut sembler \u00e9tonnant de calibrer la distance \u00e0 temp\u00e9rature ambiante alors que l'objectif est d'avoir une distance constante lorsqu'il est chauff\u00e9. Cependant, si l'on calibre lorsque la buse est chauff\u00e9e, elle a tendance \u00e0 laisser couler de petites quantit\u00e9s de plastique fondu sur le papier, ce qui modifie la quantit\u00e9 de frottement ressenti. Cela complique l'obtention d'un bon calibrage. Le calibrage alors que le lit/la buse est chaud augmente \u00e9galement consid\u00e9rablement le risque de se br\u00fbler. La dilatation thermique est stable, elle est donc facilement prise en compte plus tard dans le processus d'\u00e9talonnage. Utilisez un outil automatique pour d\u00e9terminer des hauteurs Z pr\u00e9cises ! Klipper a de nombreux scripts d'aide disponibles (par exemple, MANUAL_PROBE, Z_ENDSTOP_CALIBRATE, PROBE_CALIBRATE, DELTA_CALIBRATE). Lisez les documents d\u00e9crits ci-dessus pour en choisir un. Ex\u00e9cutez la commande choisie dans la fen\u00eatre du terminal OctoPrint. Le script demandera une action de l'utilisateur dans la sortie du terminal OctoPrint. Cela ressemblera \u00e0 quelque chose comme : Recv: // Starting manual Z probe. Use TESTZ to adjust position. Recv: // Finish with ACCEPT or ABORT command. Recv: // Z position: ?????? --> 5.000 <-- ?????? La hauteur actuelle de la buse (telle que l'imprimante la calcule) est indiqu\u00e9e entre \"--> <--\". Le nombre \u00e0 droite est la hauteur du dernier essai de sondage juste sup\u00e9rieure \u00e0 la hauteur actuelle, et \u00e0 gauche c'est la hauteur du dernier essai de sondage inf\u00e9rieur \u00e0 la hauteur actuelle (ou ?????? si aucune tentative n'a \u00e9t\u00e9 effectu\u00e9e). Placez le papier entre la buse et le lit. Il peut \u00eatre utile de plier un coin du papier pour qu'il soit plus facile \u00e0 saisir. (Essayez de ne pas appuyer sur le lit lorsque vous d\u00e9placez le papier d'avant en arri\u00e8re.) Utilisez la commande TESTZ pour demander \u00e0 la buse de se rapprocher du papier. Par exemple : TESTZ Z=-0.1 La commande TESTZ d\u00e9placera la buse \u00e0 une distance relative de la position actuelle de la buse. (Ainsi, Z = -0.1 demande \u00e0 la buse de se rapprocher du lit de 0,1 mm.) Une fois que la buse a cess\u00e9 de bouger, poussez le papier d'avant en arri\u00e8re pour v\u00e9rifier si la buse est en contact avec le papier et pour sentir la quantit\u00e9 de frottement. Continuez \u00e0 \u00e9mettre des commandes TESTZ jusqu'\u00e0 ce que vous ressentiez une l\u00e9g\u00e8re friction lors du test avec le papier. Si il y a trop de frottement, on peut utiliser une valeur Z positive pour d\u00e9placer la buse vers le haut. Il est \u00e9galement possible d'utiliser TESTZ Z=+ ou TESTZ Z=- pour \"dichotomiser\" la derni\u00e8re position - c'est-\u00e0-dire se d\u00e9placer vers une position \u00e0 mi-chemin entre deux positions. Par exemple, si l'on re\u00e7oit l'invite suivante d'une commande TESTZ : Recv: // Z position: 0.130 --> 0.230 <-- 0.280 Ensuite, un 'TESTZ Z=-' d\u00e9placerait la buse vers une position Z de 0,180 (\u00e0 mi-chemin entre 0,130 et 0,230). On peut utiliser cette fonctionnalit\u00e9 pour aider \u00e0 r\u00e9duire rapidement \u00e0 un frottement constant. Il est \u00e9galement possible d'utiliser Z=++ et Z=-- pour revenir directement \u00e0 une mesure pass\u00e9e - par exemple, apr\u00e8s l'invite ci-dessus, une commande TESTZ Z=-- d\u00e9placerait la buse vers un Z position de 0,130. Apr\u00e8s r\u00e9gl\u00e9 la l\u00e9g\u00e8re force de friction, ex\u00e9cutez la commande ACCEPT : ACCEPT Cela validera la hauteur Z donn\u00e9e et enregistrera la valeur d'\u00e9talonnage. La force de friction ressentie n'est pas cruciale, tout comme la quantit\u00e9 de dilatation thermique et la largeur exacte du papier ne sont pas cruciales. Essayez simplement d'obtenir la m\u00eame quantit\u00e9 de frottement \u00e0 chaque fois que vous ex\u00e9cutez le test. Si quelque chose ne va pas pendant le test, on peut utiliser la commande ABORT pour quitter l'outil d'\u00e9talonnage. D\u00e9termination de la dilatation thermique \u00b6 Apr\u00e8s avoir effectu\u00e9 le nivellement du lit, on peut continuer \u00e0 calculer une valeur plus pr\u00e9cise pour compenser \u00abl'expansion thermique\u00bb, \u00abl'\u00e9paisseur du papier\u00bb et la \u00abquantit\u00e9 de frottement ressentie pendant le test du papier\u00bb. Ce type de calcul n'est g\u00e9n\u00e9ralement pas n\u00e9cessaire car la plupart des utilisateurs trouvent que le simple \"test papier\" donne de bons r\u00e9sultats. La fa\u00e7on la plus simple de faire ce calcul est d'imprimer un objet de test qui a des parois droites de tous les c\u00f4t\u00e9s. Le grand carr\u00e9 creux trouv\u00e9 dans docs/prints/square.stl peut \u00eatre utilis\u00e9 pour cela. Lors du d\u00e9coupage de l'objet, assurez-vous que le segment utilise la m\u00eame hauteur de couche et la m\u00eame largeur d'extrusion pour le premier niveau et pour toutes les couches suivantes. Utilisez une hauteur de couche grossi\u00e8re (la hauteur de couche doit \u00eatre d'environ 75 % du diam\u00e8tre de la buse) et n'utilisez pas de bordure ou de radeau. Imprimez l'objet \u00e0 tester, attendez qu'il refroidisse et retirez-le du lit. Inspectez la couche la plus basse de l'objet. (Il peut \u00e9galement \u00eatre utile de passer un doigt ou un ongle le long du bord inf\u00e9rieur.) Si l'on constate que la couche inf\u00e9rieure est l\u00e9g\u00e8rement bomb\u00e9e le long de tous les c\u00f4t\u00e9s de l'objet, cela indique que la buse \u00e9tait l\u00e9g\u00e8rement plus proche du lit qu'elle ne l'aurait d\u00fb. On peut \u00e9mettre une commande SET_GCODE_OFFSET Z=+.010 pour augmenter la hauteur. Dans les impressions suivantes, on peut inspecter ce comportement et effectuer d'autres ajustements si n\u00e9cessaire. Les ajustements de ce type se font g\u00e9n\u00e9ralement en dizaines de microns (0,010 mm). Si la couche inf\u00e9rieure appara\u00eet syst\u00e9matiquement plus \u00e9troite que les couches suivantes, vous pouvez utiliser la commande SET_GCODE_OFFSET pour effectuer un ajustement Z n\u00e9gatif. En cas de doute, on peut diminuer le r\u00e9glage Z jusqu'\u00e0 ce que la couche inf\u00e9rieure des impressions pr\u00e9sente un petit renflement, puis reculer jusqu'\u00e0 ce qu'il disparaisse. Le moyen le plus simple d'appliquer l'ajustement Z souhait\u00e9 consiste \u00e0 cr\u00e9er une macro de g-code START_PRINT et \u00e0 faire en sorte que le slicer appelle cette macro au d\u00e9but de chaque impression et \u00e0 ajouter une commande SET_GCODE_OFFSET \u00e0 cette macro. Voir le document trancheurs pour plus de d\u00e9tails.","title":"Nivellement du lit"},{"location":"Bed_Level.html#nivellement-du-lit","text":"Le nivellement du lit (parfois aussi appel\u00e9 \u00ab tramage du lit \u00bb) est essentiel pour obtenir des impressions de haute qualit\u00e9. Si un lit n'est pas correctement \"nivel\u00e9\", cela peut entra\u00eener une mauvaise adh\u00e9rence du lit, un \"gauchissement\" et des probl\u00e8mes subtils tout au long de l'impression. Ce document sert de guide pour effectuer le nivellement du lit dans Klipper. Il est important de comprendre l'objectif du nivellement du lit. Si l'imprimante doit aller \u00e0 la position X0 Y0 Z10 pendant une impression, alors l'objectif est que la buse de l'imprimante soit exactement \u00e0 10 mm du lit de l'imprimante. De plus, si l'imprimante doit ensuite aller \u00e0 la position \"X50 Z10\", l'objectif est que la buse maintienne une distance exacte de 10 mm du lit pendant tout ce mouvement horizontal. Afin d'obtenir des impressions de bonne qualit\u00e9, l'imprimante doit \u00eatre calibr\u00e9e de sorte que les distances Z soient pr\u00e9cises \u00e0 environ 25 microns (0,025 mm). Il s'agit d'une petite distance - nettement inf\u00e9rieure \u00e0 la largeur d'un cheveu humain. Cette \u00e9chelle ne peut pas \u00eatre mesur\u00e9e \"\u00e0 l'\u0153il\". Des effets subtils (tels que la dilatation thermique) ont un impact sur les mesures \u00e0 cette \u00e9chelle. Le secret pour obtenir une grande pr\u00e9cision est d'utiliser un processus reproductible et d'utiliser une m\u00e9thode de mise \u00e0 niveau qui tire parti de la haute pr\u00e9cision du propre syst\u00e8me de mouvement de l'imprimante.","title":"Nivellement du lit"},{"location":"Bed_Level.html#choisissez-le-mecanisme-detalonnage-approprie","text":"Diff\u00e9rents types d'imprimantes utilisent diff\u00e9rentes m\u00e9thodes pour effectuer le nivellement du lit. A la fin toutes les m\u00e9thodes d\u00e9pendent du \"test du papier\" (d\u00e9crit ci-dessous). Cependant, le processus pour un type particulier d'imprimante est d\u00e9crit dans les autres documents. Avant d'ex\u00e9cuter l'un de ces outils d'\u00e9talonnage, assurez-vous d'ex\u00e9cuter les v\u00e9rifications d\u00e9crites dans le document de v\u00e9rification de la configuration . Il est n\u00e9cessaire de v\u00e9rifier les mouvements de base de l'imprimante avant d'effectuer le nivellement du lit. Pour les imprimantes avec une sonde Z automatique, assurez-vous de calibrer la sonde en suivant les instructions du document R\u00e9glages de la sonde . Pour les imprimantes delta, consultez le document R\u00e9glage des deltas . Pour les imprimantes avec un lit r\u00e9glable par vis et des fin de course Z traditionnels, consultez le document Nivellement manuel . Pendant le calibrage, il peut \u00eatre n\u00e9cessaire de d\u00e9finir la position_min du Z de l'imprimante sur un nombre n\u00e9gatif (par exemple, position_min = -2 ). L'imprimante effectue des v\u00e9rifications des limites m\u00eame pendant les routines d'\u00e9talonnage. La d\u00e9finition d'un nombre n\u00e9gatif permet \u00e0 l'imprimante de se d\u00e9placer en dessous de la position nominale du lit, ce qui peut aider \u00e0 d\u00e9terminer la position r\u00e9elle du lit.","title":"Choisissez le m\u00e9canisme d'\u00e9talonnage appropri\u00e9"},{"location":"Bed_Level.html#le-test-du-papier","text":"Le principal m\u00e9canisme d'\u00e9talonnage du lit est le \"test du papier\". Il s'agit de placer un morceau r\u00e9gulier de \"papier pour photocopieuse\" entre le lit et la buse de l'imprimante, puis de d\u00e9placer la buse \u00e0 diff\u00e9rentes hauteurs Z jusqu'\u00e0 ce que l'on ressente une petite friction lorsque l'on pousse le papier d'avant en arri\u00e8re. Il est important de bien comprendre le \"test papier\" m\u00eame si l'on dispose d'une \"sonde Z automatique\". La sonde elle-m\u00eame doit souvent \u00eatre calibr\u00e9e pour obtenir de bons r\u00e9sultats. Cet \u00e9talonnage de la sonde est effectu\u00e9 \u00e0 l'aide de ce \"test papier\". Afin d'effectuer le test du papier, coupez un petit morceau de papier rectangulaire \u00e0 l'aide d'une paire de ciseaux (par exemple, 5x3 cm). Le papier a g\u00e9n\u00e9ralement une \u00e9paisseur d'environ 100 microns (0,100 mm). (L'\u00e9paisseur exacte du papier n'est pas cruciale.) La premi\u00e8re \u00e9tape du test du papier consiste \u00e0 inspecter la buse et le lit de l'imprimante. Assurez-vous qu'il n'y a pas de plastique (ou d'autres d\u00e9bris) sur la buse ou le lit. Inspectez la buse et le lit pour vous assurer qu'il n'y a pas de plastique ! Si l'on imprime toujours sur une bande adh\u00e9sive ou une surface d'impression particuli\u00e8re, on peut alors effectuer le test papier avec cette bande/surface en place. Cependant, notez que le ruban lui-m\u00eame a une \u00e9paisseur et que diff\u00e9rents rubans (ou toute autre surface d'impression) auront un impact sur les mesures Z. Assurez-vous de relancer le test du papier pour mesurer chaque type de surface utilis\u00e9. S'il y a du plastique sur la buse, chauffez la buse et utilisez une pince \u00e0 \u00e9piler en m\u00e9tal pour retirer ce plastique. Attendez que la buse refroidisse compl\u00e8tement \u00e0 temp\u00e9rature ambiante avant de continuer avec le test papier. Pendant que la buse refroidit, utilisez la pince \u00e0 \u00e9piler en m\u00e9tal pour retirer tout plastique susceptible de suinter. Effectuez toujours le test du papier lorsque la buse et le lit sont \u00e0 temp\u00e9rature ambiante ! Lorsque la buse est chauff\u00e9e, sa position (par rapport au lit) change en raison de la dilatation thermique. Cette dilatation thermique est g\u00e9n\u00e9ralement d'environ 100 microns, ce qui correspond \u00e0 peu pr\u00e8s \u00e0 la m\u00eame \u00e9paisseur qu'un morceau de papier d'imprimante typique. La quantit\u00e9 exacte de dilatation thermique n'est pas cruciale, tout comme l'\u00e9paisseur exacte du papier n'est pas cruciale. Commencez par l'hypoth\u00e8se que les deux sont \u00e9gaux (voir ci-dessous pour une m\u00e9thode de d\u00e9termination de la diff\u00e9rence entre les deux distances). Il peut sembler \u00e9tonnant de calibrer la distance \u00e0 temp\u00e9rature ambiante alors que l'objectif est d'avoir une distance constante lorsqu'il est chauff\u00e9. Cependant, si l'on calibre lorsque la buse est chauff\u00e9e, elle a tendance \u00e0 laisser couler de petites quantit\u00e9s de plastique fondu sur le papier, ce qui modifie la quantit\u00e9 de frottement ressenti. Cela complique l'obtention d'un bon calibrage. Le calibrage alors que le lit/la buse est chaud augmente \u00e9galement consid\u00e9rablement le risque de se br\u00fbler. La dilatation thermique est stable, elle est donc facilement prise en compte plus tard dans le processus d'\u00e9talonnage. Utilisez un outil automatique pour d\u00e9terminer des hauteurs Z pr\u00e9cises ! Klipper a de nombreux scripts d'aide disponibles (par exemple, MANUAL_PROBE, Z_ENDSTOP_CALIBRATE, PROBE_CALIBRATE, DELTA_CALIBRATE). Lisez les documents d\u00e9crits ci-dessus pour en choisir un. Ex\u00e9cutez la commande choisie dans la fen\u00eatre du terminal OctoPrint. Le script demandera une action de l'utilisateur dans la sortie du terminal OctoPrint. Cela ressemblera \u00e0 quelque chose comme : Recv: // Starting manual Z probe. Use TESTZ to adjust position. Recv: // Finish with ACCEPT or ABORT command. Recv: // Z position: ?????? --> 5.000 <-- ?????? La hauteur actuelle de la buse (telle que l'imprimante la calcule) est indiqu\u00e9e entre \"--> <--\". Le nombre \u00e0 droite est la hauteur du dernier essai de sondage juste sup\u00e9rieure \u00e0 la hauteur actuelle, et \u00e0 gauche c'est la hauteur du dernier essai de sondage inf\u00e9rieur \u00e0 la hauteur actuelle (ou ?????? si aucune tentative n'a \u00e9t\u00e9 effectu\u00e9e). Placez le papier entre la buse et le lit. Il peut \u00eatre utile de plier un coin du papier pour qu'il soit plus facile \u00e0 saisir. (Essayez de ne pas appuyer sur le lit lorsque vous d\u00e9placez le papier d'avant en arri\u00e8re.) Utilisez la commande TESTZ pour demander \u00e0 la buse de se rapprocher du papier. Par exemple : TESTZ Z=-0.1 La commande TESTZ d\u00e9placera la buse \u00e0 une distance relative de la position actuelle de la buse. (Ainsi, Z = -0.1 demande \u00e0 la buse de se rapprocher du lit de 0,1 mm.) Une fois que la buse a cess\u00e9 de bouger, poussez le papier d'avant en arri\u00e8re pour v\u00e9rifier si la buse est en contact avec le papier et pour sentir la quantit\u00e9 de frottement. Continuez \u00e0 \u00e9mettre des commandes TESTZ jusqu'\u00e0 ce que vous ressentiez une l\u00e9g\u00e8re friction lors du test avec le papier. Si il y a trop de frottement, on peut utiliser une valeur Z positive pour d\u00e9placer la buse vers le haut. Il est \u00e9galement possible d'utiliser TESTZ Z=+ ou TESTZ Z=- pour \"dichotomiser\" la derni\u00e8re position - c'est-\u00e0-dire se d\u00e9placer vers une position \u00e0 mi-chemin entre deux positions. Par exemple, si l'on re\u00e7oit l'invite suivante d'une commande TESTZ : Recv: // Z position: 0.130 --> 0.230 <-- 0.280 Ensuite, un 'TESTZ Z=-' d\u00e9placerait la buse vers une position Z de 0,180 (\u00e0 mi-chemin entre 0,130 et 0,230). On peut utiliser cette fonctionnalit\u00e9 pour aider \u00e0 r\u00e9duire rapidement \u00e0 un frottement constant. Il est \u00e9galement possible d'utiliser Z=++ et Z=-- pour revenir directement \u00e0 une mesure pass\u00e9e - par exemple, apr\u00e8s l'invite ci-dessus, une commande TESTZ Z=-- d\u00e9placerait la buse vers un Z position de 0,130. Apr\u00e8s r\u00e9gl\u00e9 la l\u00e9g\u00e8re force de friction, ex\u00e9cutez la commande ACCEPT : ACCEPT Cela validera la hauteur Z donn\u00e9e et enregistrera la valeur d'\u00e9talonnage. La force de friction ressentie n'est pas cruciale, tout comme la quantit\u00e9 de dilatation thermique et la largeur exacte du papier ne sont pas cruciales. Essayez simplement d'obtenir la m\u00eame quantit\u00e9 de frottement \u00e0 chaque fois que vous ex\u00e9cutez le test. Si quelque chose ne va pas pendant le test, on peut utiliser la commande ABORT pour quitter l'outil d'\u00e9talonnage.","title":"Le \"Test du papier\""},{"location":"Bed_Level.html#determination-de-la-dilatation-thermique","text":"Apr\u00e8s avoir effectu\u00e9 le nivellement du lit, on peut continuer \u00e0 calculer une valeur plus pr\u00e9cise pour compenser \u00abl'expansion thermique\u00bb, \u00abl'\u00e9paisseur du papier\u00bb et la \u00abquantit\u00e9 de frottement ressentie pendant le test du papier\u00bb. Ce type de calcul n'est g\u00e9n\u00e9ralement pas n\u00e9cessaire car la plupart des utilisateurs trouvent que le simple \"test papier\" donne de bons r\u00e9sultats. La fa\u00e7on la plus simple de faire ce calcul est d'imprimer un objet de test qui a des parois droites de tous les c\u00f4t\u00e9s. Le grand carr\u00e9 creux trouv\u00e9 dans docs/prints/square.stl peut \u00eatre utilis\u00e9 pour cela. Lors du d\u00e9coupage de l'objet, assurez-vous que le segment utilise la m\u00eame hauteur de couche et la m\u00eame largeur d'extrusion pour le premier niveau et pour toutes les couches suivantes. Utilisez une hauteur de couche grossi\u00e8re (la hauteur de couche doit \u00eatre d'environ 75 % du diam\u00e8tre de la buse) et n'utilisez pas de bordure ou de radeau. Imprimez l'objet \u00e0 tester, attendez qu'il refroidisse et retirez-le du lit. Inspectez la couche la plus basse de l'objet. (Il peut \u00e9galement \u00eatre utile de passer un doigt ou un ongle le long du bord inf\u00e9rieur.) Si l'on constate que la couche inf\u00e9rieure est l\u00e9g\u00e8rement bomb\u00e9e le long de tous les c\u00f4t\u00e9s de l'objet, cela indique que la buse \u00e9tait l\u00e9g\u00e8rement plus proche du lit qu'elle ne l'aurait d\u00fb. On peut \u00e9mettre une commande SET_GCODE_OFFSET Z=+.010 pour augmenter la hauteur. Dans les impressions suivantes, on peut inspecter ce comportement et effectuer d'autres ajustements si n\u00e9cessaire. Les ajustements de ce type se font g\u00e9n\u00e9ralement en dizaines de microns (0,010 mm). Si la couche inf\u00e9rieure appara\u00eet syst\u00e9matiquement plus \u00e9troite que les couches suivantes, vous pouvez utiliser la commande SET_GCODE_OFFSET pour effectuer un ajustement Z n\u00e9gatif. En cas de doute, on peut diminuer le r\u00e9glage Z jusqu'\u00e0 ce que la couche inf\u00e9rieure des impressions pr\u00e9sente un petit renflement, puis reculer jusqu'\u00e0 ce qu'il disparaisse. Le moyen le plus simple d'appliquer l'ajustement Z souhait\u00e9 consiste \u00e0 cr\u00e9er une macro de g-code START_PRINT et \u00e0 faire en sorte que le slicer appelle cette macro au d\u00e9but de chaque impression et \u00e0 ajouter une commande SET_GCODE_OFFSET \u00e0 cette macro. Voir le document trancheurs pour plus de d\u00e9tails.","title":"D\u00e9termination de la dilatation thermique"},{"location":"Bed_Mesh.html","text":"Maillage du Bed \u00b6 Le module Maillage du lit peut \u00eatre utilis\u00e9 pour compenser les irr\u00e9gularit\u00e9s de la surface du lit afin d'obtenir une meilleure premi\u00e8re couche sur l'ensemble du lit. Il convient de noter que la correction logicielle ne permet pas d'obtenir de r\u00e9sultats parfaits, elle ne peut qu'approximer la forme du lit. Le maillage du lit ne peut pas non plus compenser les probl\u00e8mes m\u00e9caniques et \u00e9lectriques. Si un axe est de travers ou si un palpeur n'est pas pr\u00e9cis, le module bed_mesh n'obtiendra pas de r\u00e9sultats pr\u00e9cis lors du processus de palpage. Avant de proc\u00e9der \u00e0 l'\u00e9talonnage du maillage, vous devez vous assurer que l'offset Z de votre sonde est r\u00e9gl\u00e9. Si vous utilisez une but\u00e9e de fin de course pour la mise \u00e0 l'origine en Z, elle doit \u00e9galement \u00eatre r\u00e9gl\u00e9e. Voir Calibration de la sonde et Z_ENDSTOP_CALIBRATE dans Nivelage manuel pour plus d'informations. Configuration de base \u00b6 Lits rectangulaires \u00b6 Cet exemple suppose une imprimante avec un lit rectangulaire de 250 mm x 220 mm et une sonde avec un d\u00e9calage x de 24 mm et un d\u00e9calage y de 5 mm. [bed_mesh] speed: 120 horizontal_move_z: 5 mesh_min: 35, 6 mesh_max: 240, 198 probe_count: 5, 3 speed : 120 Valeur par d\u00e9faut : 50 La vitesse \u00e0 laquelle l'outil se d\u00e9place entre les points palp\u00e9s. horizontal_move_z : 5 Valeur par d\u00e9faut : 5 La coordonn\u00e9e Z \u00e0 laquelle la sonde s'\u00e9l\u00e8ve avant de se d\u00e9placer entre les points. mesh_min : 35, 6 Requis La premi\u00e8re coordonn\u00e9e palp\u00e9e, la plus proche de l'origine. Cette coordonn\u00e9e est relative \u00e0 l'emplacement de la sonde. mesh_max : 240, 198 Requis La coordonn\u00e9e palp\u00e9e la plus \u00e9loign\u00e9e de l'origine. Ce n'est pas n\u00e9cessairement le dernier point palp\u00e9, car le processus de palpage se d\u00e9roule en zig-zag. Comme pour mesh_min , cette coordonn\u00e9e est relative \u00e0 l'emplacement de la sonde. probe_count : 5, 3 Valeur par d\u00e9faut : 3, 3 Le nombre de points \u00e0 palper sur chaque axe, sp\u00e9cifi\u00e9 sous forme de valeurs enti\u00e8res X, Y. Dans cet exemple, 5 points seront palp\u00e9s le long de l'axe X, avec 3 points le long de l'axe Y, pour un total de 15 points palp\u00e9s. Notez que si vous voulez une grille carr\u00e9e, par exemple 3x3, il est possible de n'utiliser qu'une seule valeur enti\u00e8re pour les deux axes, par exemple probe_count : 3 . Notez qu'un maillage n\u00e9cessite un nombre minimum de 3 points de sondage sur chaque axe. L'illustration ci-dessous montre comment les options mesh_min , mesh_max , et probe_count sont utilis\u00e9es pour g\u00e9n\u00e9rer des points de palpage. Les fl\u00e8ches indiquent la direction de la proc\u00e9dure de palpage, commen\u00e7ant en mesh_min . Pour r\u00e9f\u00e9rence, lorsque la sonde est \u00e0 mesh_min , la buse sera \u00e0 (11, 1), et lorsque la sonde est \u00e0 mesh_max , la buse sera \u00e0 (206, 193). Lits circulaires \u00b6 Cet exemple suppose une imprimante \u00e9quip\u00e9e d'un lit circulaire de 100 mm de rayon. Nous utiliserons les m\u00eames d\u00e9calages de sonde que dans l'exemple rectangulaire, 24 mm sur X et 5 mm sur Y. [bed_mesh] speed: 120 horizontal_move_z: 5 mesh_radius: 75 mesh_origin: 0, 0 round_probe_count: 5 mesh_radius : 75 Requis Le rayon du maillage palp\u00e9 en mm, par rapport \u00e0 mesh_origin . Notez que les d\u00e9calages de la sonde limitent la taille du rayon du maillage. Dans cet exemple, un rayon sup\u00e9rieur \u00e0 76 d\u00e9placerait la t\u00eate de l'outil en dehors des limites physiques de l'imprimante. mesh_origin : 0, 0 Valeur par d\u00e9faut : 0, 0 Le point central du maillage. Cette coordonn\u00e9e est relative \u00e0 l'emplacement de la sonde. Bien que la valeur par d\u00e9faut soit 0, 0, il peut \u00eatre utile d'ajuster l'origine dans le but de sonder une plus grande partie du lit. Voir l'illustration ci-dessous. round_probe_count : 5 Valeur par d\u00e9faut : 5 C'est une valeur enti\u00e8re d\u00e9finissant le nombre maximum de points palp\u00e9s le long des axes X et Y. Par \"maximum\", nous entendons le nombre de points palp\u00e9s le long de l'origine du maillage. Cette valeur doit \u00eatre un nombre impair, car il est n\u00e9cessaire que le centre du maillage soit palp\u00e9. L'illustration ci-dessous montre comment les points palp\u00e9s sont g\u00e9n\u00e9r\u00e9s. Comme vous pouvez le voir, le r\u00e9glage de mesh_origin \u00e0 (-10, 0) nous permet de sp\u00e9cifier un rayon de maillage plus grand de 85. Configuration avanc\u00e9e \u00b6 Les options de configuration plus avanc\u00e9es sont expliqu\u00e9es en d\u00e9tail ci-dessous. Chaque exemple s'appuie sur la configuration de base du lit rectangulaire pr\u00e9sent\u00e9e ci-dessus. Chacune des options avanc\u00e9es s'applique de la m\u00eame mani\u00e8re aux lits circulaires. Interpolation du maillage \u00b6 Bien qu'il soit possible d'\u00e9chantillonner directement la matrice palp\u00e9e en utilisant une simple interpolation bilin\u00e9aire afin de d\u00e9terminer les valeurs Z entre les points palp\u00e9s, il est souvent utile d'interpoler des points suppl\u00e9mentaires en utilisant des algorithmes d'interpolation plus avanc\u00e9s pour augmenter la densit\u00e9 du maillage. Ces algorithmes ajoutent une courbure au maillage, en essayant de simuler les propri\u00e9t\u00e9s mat\u00e9rielles du lit. Le maillage du lit offre l'interpolation de lagrange et bicubique pour accomplir ceci. [bed_mesh] speed: 120 horizontal_move_z: 5 mesh_min: 35, 6 mesh_max: 240, 198 probe_count: 5, 3 mesh_pps: 2, 3 algorithm: bicubic bicubic_tension: 0.2 mesh_pps : 2, 3 Valeur par d\u00e9faut : 2, 2 L'option mesh_pps est l'abr\u00e9viation de Mesh Points Per Segment. Cette option indique le nombre de points \u00e0 interpoler pour chaque segment le long des axes X et Y. Un 'segment' est l'espace entre chaque point palp\u00e9. Comme pour probe_count , mesh_pps est sp\u00e9cifi\u00e9 en tant que paire de nombres entiers X, Y mais peut aussi \u00eatre sp\u00e9cifi\u00e9 comme un seul nombre entier en ce cas appliqu\u00e9 aux deux axes. Dans cet exemple, il y a 4 segments le long de l'axe X et 2 segments le long de l'axe Y. Cela r\u00e9sulte en 8 points interpol\u00e9s le long de l'axe X et 6 points interpol\u00e9s le long de l'axe Y, ce qui donne un maillage de 13x8. Notez que si mesh_pps est d\u00e9fini \u00e0 0, l'interpolation de maillage est d\u00e9sactiv\u00e9e et la matrice sond\u00e9e sera \u00e9chantillonn\u00e9e directement. algorithm : lagrange Valeur par d\u00e9faut : lagrange L'algorithme utilis\u00e9 pour interpoler le maillage. Peut \u00eatre lagrange ou bicubique . L'interpolation de Lagrange est plafonn\u00e9e \u00e0 6 points palp\u00e9s car une oscillation tend \u00e0 se produire avec un plus grand nombre d'\u00e9chantillons. L'interpolation bicubique requiert un minimum de 4 points le long de chaque axe, si moins de 4 points sont sp\u00e9cifi\u00e9s, l'\u00e9chantillonnage de Lagrange est forc\u00e9. Si mesh_pps est d\u00e9fini \u00e0 0 alors cette valeur est ignor\u00e9e car aucune interpolation de maille n'est faite. bicubic_tension : 0.2 Valeur par d\u00e9faut : 0.2 Si l'option algorithm est d\u00e9finie sur bicubique, il est possible d'indiquer une valeur de tension. Plus la tension est \u00e9lev\u00e9e, plus la pente est interpol\u00e9e. Soyez prudent lorsque vous ajustez cette valeur, car des valeurs plus \u00e9lev\u00e9es cr\u00e9ent \u00e9galement plus de d\u00e9passement, ce qui entra\u00eenera des valeurs interpol\u00e9es plus \u00e9lev\u00e9es ou plus basses que vos points palp\u00e9s. L'illustration ci-dessous montre comment les options ci-dessus sont utilis\u00e9es pour g\u00e9n\u00e9rer un maillage interpol\u00e9. Fractionnement des d\u00e9placements \u00b6 Le maillage du lit fonctionne en interceptant les commandes de d\u00e9placement du gcode et en appliquant une transformation \u00e0 leur coordonn\u00e9e Z. Les longs d\u00e9placements doivent \u00eatre divis\u00e9s en d\u00e9placements plus petits pour suivre correctement la forme du lit. Les options ci-dessous contr\u00f4lent le comportement du fractionnement. [bed_mesh] speed: 120 horizontal_move_z: 5 mesh_min: 35, 6 mesh_max: 240, 198 probe_count: 5, 3 move_check_distance: 5 split_delta_z: .025 move_check_distance : 5 Valeur par d\u00e9faut : 5 La distance minimale de v\u00e9rification de changement de Z souhait\u00e9 avant d'effectuer un fractionnemeny. Dans cet exemple, un mouvement de plus de 5mm sera travers\u00e9 par l'algorithme. Tous les 5 mm, une recherche de maille Z sera effectu\u00e9e, en la comparant \u00e0 la valeur Z du mouvement pr\u00e9c\u00e9dent. Si le delta atteint le seuil fix\u00e9 par split_delta_z , le mouvement sera divis\u00e9 et la travers\u00e9e continuera. Ce processus se r\u00e9p\u00e8te jusqu'\u00e0 ce que la fin du d\u00e9placement soit atteinte, o\u00f9 un ajustement final sera appliqu\u00e9. Les d\u00e9placements plus courts que la move_check_distance ont l'ajustement Z correct appliqu\u00e9 directement au d\u00e9placement sans travers\u00e9e ou division. split_delta_z : .025 Valeur par d\u00e9faut : .025 Comme mentionn\u00e9 ci-dessus, il s'agit de l'\u00e9cart minimum requis pour d\u00e9clencher un fractionnement du mouvement. Dans cet exemple, toute valeur Z avec un \u00e9cart de +/- 0,025 mm d\u00e9clenchera un fractionnement. G\u00e9n\u00e9ralement les valeurs par d\u00e9faut de ces options sont suffisantes, en fait la valeur par d\u00e9faut de 5mm pour la move_check_distance est probablement exag\u00e9r\u00e9e. Cependant, un utilisateur avanc\u00e9 peut souhaiter exp\u00e9rimenter avec ces options dans le but d'obtenir une premi\u00e8re couche optimale. Att\u00e9nuation du maillage \u00b6 Lorsque l'option \"fondu\" est activ\u00e9e, l'ajustement du Z est r\u00e9duit progressivement sur une distance d\u00e9finie par la configuration. Ceci est r\u00e9alis\u00e9 en appliquant de petits ajustements \u00e0 la hauteur de la couche, en augmentant ou en diminuant selon la forme du lit. Lorsque le fondu est termin\u00e9, l'ajustement Z n'est plus appliqu\u00e9, ce qui permet au sommet de l'impression d'\u00eatre plat plut\u00f4t que de refl\u00e9ter la forme du lit. Le fondu peut \u00e9galement pr\u00e9senter quelques caract\u00e9ristiques ind\u00e9sirables, si le fondu est effectu\u00e9 trop rapidement, il peut entra\u00eener des artefacts visibles sur l'impression. De plus, si votre lit est sensiblement d\u00e9form\u00e9, le fondu peut r\u00e9tr\u00e9cir ou \u00e9tirer la hauteur Z de l'impression. C'est pourquoi le fondu est d\u00e9sactiv\u00e9 par d\u00e9faut. [bed_mesh] speed: 120 horizontal_move_z: 5 mesh_min: 35, 6 mesh_max: 240, 198 probe_count: 5, 3 fade_start: 1 fade_end: 10 fade_target: 0 fade_start: 1 Valeur par d\u00e9faut : 1 La hauteur Z \u00e0 laquelle il faut commencer l'att\u00e9nuation progressive de l'ajustement. C'est une bonne id\u00e9e d'avoir quelques couches d\u00e9j\u00e0 d\u00e9pos\u00e9es avant de commencer le processus de fondu. fade_end : 10 Valeur par d\u00e9faut : 0 La hauteur Z \u00e0 laquelle le fondu doit s'arr\u00eater. Si cette valeur est inf\u00e9rieure \u00e0 fade_start , le fondu est d\u00e9sactiv\u00e9. Cette valeur peut \u00eatre ajust\u00e9e en fonction de la d\u00e9formation de la surface d'impression. Une surface fortement d\u00e9form\u00e9e devrait s'estomper sur une plus grande distance. Une surface presque plate peut \u00eatre capable de r\u00e9duire cette valeur pour s'estomper plus rapidement. 10mm est une valeur raisonnable pour commencer si vous utilisez la valeur par d\u00e9faut de 1 pour fade_start . fade_target : 0 Valeur par d\u00e9faut : La valeur Z moyenne du maillage Le fade_target peut \u00eatre consid\u00e9r\u00e9 comme un d\u00e9calage Z suppl\u00e9mentaire appliqu\u00e9 \u00e0 l'ensemble du lit apr\u00e8s la fin du fondu. En g\u00e9n\u00e9ral, nous aimerions que cette valeur soit \u00e9gale \u00e0 0, mais il y a des circonstances o\u00f9 elle ne devrait pas l'\u00eatre. Par exemple, supposons que votre position d'origine sur le lit est aberrante, elle est inf\u00e9rieure de 0,2 mm \u00e0 la hauteur moyenne palp\u00e9e du lit. Si le fade_target est 0, le fondu va r\u00e9tr\u00e9cir l'impression d'une moyenne de 0,2 mm \u00e0 travers le lit. En r\u00e9glant la fade_target sur .2, la zone d'origine sera agrandie de .2 mm, mais le reste du lit aura une taille pr\u00e9cise. En g\u00e9n\u00e9ral, c'est une bonne id\u00e9e de laisser fade_target en dehors de la configuration afin que la hauteur moyenne du maillage soit utilis\u00e9e, cependant il peut \u00eatre souhaitable d'ajuster manuellement la cible du fondu si l'on ne veut imprimer que sur une partie sp\u00e9cifique du lit. L'indice de r\u00e9f\u00e9rence relatif \u00b6 La plupart des sondes sont sensibles \u00e0 une d\u00e9rive, c'est-\u00e0-dire \u00e0 des inexactitudes dans le palpage introduites par la chaleur ou des interf\u00e9rences. Cela peut rendre difficile le calcul du d\u00e9calage en Z de la sonde, en particulier \u00e0 diff\u00e9rentes temp\u00e9ratures du lit. C'est pourquoi certaines imprimantes utilisent \u00e0 la fois une but\u00e9e pour la mise \u00e0 l'origine de l'axe Z et une sonde pour r\u00e9aliser le maillage. Ces imprimantes peuvent b\u00e9n\u00e9ficier de la configuration de l'index de r\u00e9f\u00e9rence relatif. [bed_mesh] speed: 120 horizontal_move_z: 5 mesh_min: 35, 6 mesh_max: 240, 198 probe_count: 5, 3 relative_reference_index: 7 relative_reference_index : 7 Valeur par d\u00e9faut : None (d\u00e9sactiv\u00e9) Lorsque les points palp\u00e9s sont g\u00e9n\u00e9r\u00e9s, un index leur est attribu\u00e9. Vous pouvez consulter cet index dans klippy.log ou en utilisant BED_MESH_OUTPUT (voir la section sur les GCodes de maillage de lit ci-dessous pour plus d'informations). Si vous assignez un index \u00e0 l'option relative_reference_index , la valeur palp\u00e9e \u00e0 cette coordonn\u00e9e remplacera le z_offset de la sonde. Ce qui fait de cette coordonn\u00e9e la r\u00e9f\u00e9rence \"z\u00e9ro\" pour le maillage. Lorsque vous utilisez l'indice de r\u00e9f\u00e9rence relatif, vous devez choisir l'indice le plus proche de l'endroit du lit o\u00f9 le calibrage de la but\u00e9e Z a \u00e9t\u00e9 effectu\u00e9. Notez que lorsque vous recherchez l'indice en utilisant le journal ou BED_MESH_OUTPUT, vous devez utiliser les coordonn\u00e9es list\u00e9es sous l'en-t\u00eate \"Probe\" pour trouver l'indice correct. R\u00e9gions d\u00e9fectueuses \u00b6 Il est possible que certaines zones d'un lit donnent des r\u00e9sultats inexacts lors du palpage en raison d'un \"d\u00e9faut\" \u00e0 des endroits particuliers. Le meilleur exemple de ce ph\u00e9nom\u00e8ne est celui des lits comportant une s\u00e9rie d'aimants int\u00e9gr\u00e9s utilis\u00e9s pour retenir les t\u00f4les d'acier amovibles. Le champ magn\u00e9tique au niveau et autour de ces aimants peut faire qu'une sonde inductive se d\u00e9clenche \u00e0 une distance plus \u00e9lev\u00e9e ou plus basse qu'elle ne le ferait autrement, ce qui donne un maillage ne repr\u00e9sentant pas pr\u00e9cis\u00e9ment la surface \u00e0 ces endroits. Remarque : Il ne faut pas confondre ce ph\u00e9nom\u00e8ne avec le biais de l'emplacement de la sonde, qui produit des r\u00e9sultats inexacts sur l'ensemble du lit. Les options faulty_region peuvent \u00eatre configur\u00e9es pour compenser cet effet. Si un point g\u00e9n\u00e9r\u00e9 se trouve dans une r\u00e9gion d\u00e9fectueuse, le maillage du lit tentera de palper jusqu'\u00e0 4 points aux limites de cette r\u00e9gion. Ces valeurs palp\u00e9es seront moyenn\u00e9es et ins\u00e9r\u00e9es dans le maillage comme valeur Z \u00e0 la coordonn\u00e9e (X, Y) g\u00e9n\u00e9r\u00e9e. [bed_mesh] speed: 120 horizontal_move_z: 5 mesh_min: 35, 6 mesh_max: 240, 198 probe_count: 5, 3 faulty_region_1_min: 130.0, 0.0 faulty_region_1_max: 145.0, 40.0 faulty_region_2_min: 225.0, 0.0 faulty_region_2_max: 250.0, 25.0 faulty_region_3_min: 165.0, 95.0 faulty_region_3_max: 205.0, 110.0 faulty_region_4_min: 30.0, 170.0 faulty_region_4_max: 45.0, 210.0 faulty_region_{1...99}_min faulty_region_{1..99}_max Valeur par d\u00e9faut : None (d\u00e9sactiv\u00e9) Les r\u00e9gions d\u00e9fectueuses sont d\u00e9finies d'une mani\u00e8re similaire \u00e0 celle du maillage lui-m\u00eame, o\u00f9 les coordonn\u00e9es minimum et maximum (X, Y) doivent \u00eatre infiqu\u00e9es pour chaque r\u00e9gion. Une r\u00e9gion d\u00e9fectueuse peut s'\u00e9tendre \u00e0 l'ext\u00e9rieur d'un maillage, mais les points alternatifs g\u00e9n\u00e9r\u00e9s seront toujours \u00e0 l'int\u00e9rieur des limites du maillage. Deux r\u00e9gions ne peuvent pas se chevaucher. L'image ci-dessous illustre comment les points de remplacement sont g\u00e9n\u00e9r\u00e9s lorsqu'un point g\u00e9n\u00e9r\u00e9 se trouve dans une r\u00e9gion d\u00e9fectueuse. Les r\u00e9gions repr\u00e9sent\u00e9es correspondent \u00e0 celles de l'exemple de configuration ci-dessus. Les points de remplacement et leurs coordonn\u00e9es sont identifi\u00e9s en vert. Gcodes de maillage du lit \u00b6 Calibration \u00b6 BED_MESH_CALIBRATE PROFILE=<name> METHOD=[manual | automatic] [<probe_parameter>=<value>] [<mesh_parameter>=<value>] Profil par d\u00e9faut : default M\u00e9thode par d\u00e9faut : automatique si une sonde est d\u00e9tect\u00e9e, sinon manuelle Lance la proc\u00e9dure de palpage de l'\u00e9talonnage du maillage du lit. Le maillage sera sauvegard\u00e9 dans un profil indiqu\u00e9 par le param\u00e8tre PROFILE , ou default si non pr\u00e9cis\u00e9. Si METHOD=manual est s\u00e9lectionn\u00e9, un palpage manuel sera effectu\u00e9. Lorsque vous passez du mode automatique au mode manuel, les points de maillage g\u00e9n\u00e9r\u00e9s seront automatiquement ajust\u00e9s. Il est possible de sp\u00e9cifier des param\u00e8tres de maillage pour modifier la zone palp\u00e9e. Les param\u00e8tres suivants sont disponibles : Lits rectangulaires (cart\u00e9siens) : MESH_MIN MESH_MAX PROBE_COUNT Lits circulaires (delta) : MESH_RADIUS MESH_ORIGIN ROUND_PROBE_COUNT Tous les lits : RELATIVE_REFERNCE_INDEX ALGORITHM Consultez la documentation de configuration ci-dessus pour plus de d\u00e9tails sur la fa\u00e7on dont chaque param\u00e8tre s'applique au maillage. Profils \u00b6 BED_MESH_PROFILE SAVE=<name> LOAD=<name> REMOVE=<name> Apr\u00e8s avoir r\u00e9alis\u00e9 un BED_MESH_CALIBRATE, il est possible de sauvegarder l'\u00e9tat actuel du maillage dans un profil nomm\u00e9. Cela permet de charger un maillage sans re-palper le lit. Apr\u00e8s qu'un profil ait \u00e9t\u00e9 enregistr\u00e9 en utilisant BED_MESH_PROFILE SAVE=<name> , le gcode SAVE_CONFIG peut \u00eatre ex\u00e9cut\u00e9 pour \u00e9crire le profil dans printer.cfg. Les profils peuvent \u00eatre charg\u00e9s en ex\u00e9cutant BED_MESH_PROFILE LOAD=<name> . Il convient de noter que chaque fois qu'un BED_MESH_CALIBRATE est produit, l'\u00e9tat actuel est automatiquement enregistr\u00e9 dans le profil par d\u00e9faut . Si ce profil existe, il est automatiquement charg\u00e9 au d\u00e9marrage de Klipper. Si ce comportement n'est pas souhaitable, le profil par d\u00e9faut peut \u00eatre supprim\u00e9 comme suit : BED_MESH_PROFILE REMOVE=default Tout autre profil enregistr\u00e9 peut \u00eatre supprim\u00e9 de la m\u00eame mani\u00e8re, en rempla\u00e7ant default par le nom du profil que vous souhaitez supprimer. Loading the default profile \u00b6 Previous versions of bed_mesh always loaded the profile named default on startup if it was present. This behavior has been removed in favor of allowing the user to determine when a profile is loaded. If a user wishes to load the default profile it is recommended to add BED_MESH_PROFILE LOAD=default to either their START_PRINT macro or their slicer's \"Start G-Code\" configuration, whichever is applicable. Alternatively the old behavior of loading a profile at startup can be restored with a [delayed_gcode] : [delayed_gcode bed_mesh_init] initial_duration : .01 gcode : BED_MESH_PROFILE LOAD = default Sortie \u00b6 BED_MESH_OUTPUT PGP=[0 | 1] Affiche l'\u00e9tat actuel du maillage dans le terminal. Notez que le maillage lui-m\u00eame est affich\u00e9 Le param\u00e8tre PGP est l'abr\u00e9viation de \"Print Generated Points\". Si PGP=1 est d\u00e9fini, les points palp\u00e9s g\u00e9n\u00e9r\u00e9s seront affich\u00e9s sur le terminal : // bed_mesh: generated points // Index | Tool Adjusted | Probe // 0 | (11.0, 1.0) | (35.0, 6.0) // 1 | (62.2, 1.0) | (86.2, 6.0) // 2 | (113.5, 1.0) | (137.5, 6.0) // 3 | (164.8, 1.0) | (188.8, 6.0) // 4 | (216.0, 1.0) | (240.0, 6.0) // 5 | (216.0, 97.0) | (240.0, 102.0) // 6 | (164.8, 97.0) | (188.8, 102.0) // 7 | (113.5, 97.0) | (137.5, 102.0) // 8 | (62.2, 97.0) | (86.2, 102.0) // 9 | (11.0, 97.0) | (35.0, 102.0) // 10 | (11.0, 193.0) | (35.0, 198.0) // 11 | (62.2, 193.0) | (86.2, 198.0) // 12 | (113.5, 193.0) | (137.5, 198.0) // 13 | (164.8, 193.0) | (188.8, 198.0) // 14 | (216.0, 193.0) | (240.0, 198.0) Les points de la colonne \"Tool Adjusted\" font r\u00e9f\u00e9rence \u00e0 l'emplacement de la buse, et les points de la colonne \"Probe\" font r\u00e9f\u00e9rence \u00e0 l'emplacement du palpeur. Notez que lors d'un palpage manuel, les points \"Probe\" se r\u00e9f\u00e8rent \u00e0 la fois \u00e0 l'emplacement de l'outil et de la buse. Effacer l'\u00e9tat du maillage \u00b6 BED_MESH_CLEAR Ce G-Code peut \u00eatre utilis\u00e9 pour effacer l'\u00e9tat interne du maillage. Appliquer les d\u00e9calages X/Y \u00b6 BED_MESH_OFFSET [X=<value>] [Y=<value>] Ceci est utile pour les imprimantes avec plusieurs extrudeuses ind\u00e9pendantes, car un d\u00e9calage est n\u00e9cessaire pour produire un ajustement Z correct apr\u00e8s un changement d'outil. Les d\u00e9calages doivent \u00eatre indiqu\u00e9s par rapport \u00e0 l'extrudeuse primaire. C'est-\u00e0-dire qu'un d\u00e9calage X positif doit \u00eatre indiqu\u00e9 si l'extrudeuse secondaire est mont\u00e9e \u00e0 droite de l'extrudeuse primaire, et un d\u00e9calage Y positif doit \u00eatre indiqu\u00e9 si l'extrudeuse secondaire est mont\u00e9e \"derri\u00e8re\" l'extrudeuse primaire.","title":"Maillage du Bed"},{"location":"Bed_Mesh.html#maillage-du-bed","text":"Le module Maillage du lit peut \u00eatre utilis\u00e9 pour compenser les irr\u00e9gularit\u00e9s de la surface du lit afin d'obtenir une meilleure premi\u00e8re couche sur l'ensemble du lit. Il convient de noter que la correction logicielle ne permet pas d'obtenir de r\u00e9sultats parfaits, elle ne peut qu'approximer la forme du lit. Le maillage du lit ne peut pas non plus compenser les probl\u00e8mes m\u00e9caniques et \u00e9lectriques. Si un axe est de travers ou si un palpeur n'est pas pr\u00e9cis, le module bed_mesh n'obtiendra pas de r\u00e9sultats pr\u00e9cis lors du processus de palpage. Avant de proc\u00e9der \u00e0 l'\u00e9talonnage du maillage, vous devez vous assurer que l'offset Z de votre sonde est r\u00e9gl\u00e9. Si vous utilisez une but\u00e9e de fin de course pour la mise \u00e0 l'origine en Z, elle doit \u00e9galement \u00eatre r\u00e9gl\u00e9e. Voir Calibration de la sonde et Z_ENDSTOP_CALIBRATE dans Nivelage manuel pour plus d'informations.","title":"Maillage du Bed"},{"location":"Bed_Mesh.html#configuration-de-base","text":"","title":"Configuration de base"},{"location":"Bed_Mesh.html#lits-rectangulaires","text":"Cet exemple suppose une imprimante avec un lit rectangulaire de 250 mm x 220 mm et une sonde avec un d\u00e9calage x de 24 mm et un d\u00e9calage y de 5 mm. [bed_mesh] speed: 120 horizontal_move_z: 5 mesh_min: 35, 6 mesh_max: 240, 198 probe_count: 5, 3 speed : 120 Valeur par d\u00e9faut : 50 La vitesse \u00e0 laquelle l'outil se d\u00e9place entre les points palp\u00e9s. horizontal_move_z : 5 Valeur par d\u00e9faut : 5 La coordonn\u00e9e Z \u00e0 laquelle la sonde s'\u00e9l\u00e8ve avant de se d\u00e9placer entre les points. mesh_min : 35, 6 Requis La premi\u00e8re coordonn\u00e9e palp\u00e9e, la plus proche de l'origine. Cette coordonn\u00e9e est relative \u00e0 l'emplacement de la sonde. mesh_max : 240, 198 Requis La coordonn\u00e9e palp\u00e9e la plus \u00e9loign\u00e9e de l'origine. Ce n'est pas n\u00e9cessairement le dernier point palp\u00e9, car le processus de palpage se d\u00e9roule en zig-zag. Comme pour mesh_min , cette coordonn\u00e9e est relative \u00e0 l'emplacement de la sonde. probe_count : 5, 3 Valeur par d\u00e9faut : 3, 3 Le nombre de points \u00e0 palper sur chaque axe, sp\u00e9cifi\u00e9 sous forme de valeurs enti\u00e8res X, Y. Dans cet exemple, 5 points seront palp\u00e9s le long de l'axe X, avec 3 points le long de l'axe Y, pour un total de 15 points palp\u00e9s. Notez que si vous voulez une grille carr\u00e9e, par exemple 3x3, il est possible de n'utiliser qu'une seule valeur enti\u00e8re pour les deux axes, par exemple probe_count : 3 . Notez qu'un maillage n\u00e9cessite un nombre minimum de 3 points de sondage sur chaque axe. L'illustration ci-dessous montre comment les options mesh_min , mesh_max , et probe_count sont utilis\u00e9es pour g\u00e9n\u00e9rer des points de palpage. Les fl\u00e8ches indiquent la direction de la proc\u00e9dure de palpage, commen\u00e7ant en mesh_min . Pour r\u00e9f\u00e9rence, lorsque la sonde est \u00e0 mesh_min , la buse sera \u00e0 (11, 1), et lorsque la sonde est \u00e0 mesh_max , la buse sera \u00e0 (206, 193).","title":"Lits rectangulaires"},{"location":"Bed_Mesh.html#lits-circulaires","text":"Cet exemple suppose une imprimante \u00e9quip\u00e9e d'un lit circulaire de 100 mm de rayon. Nous utiliserons les m\u00eames d\u00e9calages de sonde que dans l'exemple rectangulaire, 24 mm sur X et 5 mm sur Y. [bed_mesh] speed: 120 horizontal_move_z: 5 mesh_radius: 75 mesh_origin: 0, 0 round_probe_count: 5 mesh_radius : 75 Requis Le rayon du maillage palp\u00e9 en mm, par rapport \u00e0 mesh_origin . Notez que les d\u00e9calages de la sonde limitent la taille du rayon du maillage. Dans cet exemple, un rayon sup\u00e9rieur \u00e0 76 d\u00e9placerait la t\u00eate de l'outil en dehors des limites physiques de l'imprimante. mesh_origin : 0, 0 Valeur par d\u00e9faut : 0, 0 Le point central du maillage. Cette coordonn\u00e9e est relative \u00e0 l'emplacement de la sonde. Bien que la valeur par d\u00e9faut soit 0, 0, il peut \u00eatre utile d'ajuster l'origine dans le but de sonder une plus grande partie du lit. Voir l'illustration ci-dessous. round_probe_count : 5 Valeur par d\u00e9faut : 5 C'est une valeur enti\u00e8re d\u00e9finissant le nombre maximum de points palp\u00e9s le long des axes X et Y. Par \"maximum\", nous entendons le nombre de points palp\u00e9s le long de l'origine du maillage. Cette valeur doit \u00eatre un nombre impair, car il est n\u00e9cessaire que le centre du maillage soit palp\u00e9. L'illustration ci-dessous montre comment les points palp\u00e9s sont g\u00e9n\u00e9r\u00e9s. Comme vous pouvez le voir, le r\u00e9glage de mesh_origin \u00e0 (-10, 0) nous permet de sp\u00e9cifier un rayon de maillage plus grand de 85.","title":"Lits circulaires"},{"location":"Bed_Mesh.html#configuration-avancee","text":"Les options de configuration plus avanc\u00e9es sont expliqu\u00e9es en d\u00e9tail ci-dessous. Chaque exemple s'appuie sur la configuration de base du lit rectangulaire pr\u00e9sent\u00e9e ci-dessus. Chacune des options avanc\u00e9es s'applique de la m\u00eame mani\u00e8re aux lits circulaires.","title":"Configuration avanc\u00e9e"},{"location":"Bed_Mesh.html#interpolation-du-maillage","text":"Bien qu'il soit possible d'\u00e9chantillonner directement la matrice palp\u00e9e en utilisant une simple interpolation bilin\u00e9aire afin de d\u00e9terminer les valeurs Z entre les points palp\u00e9s, il est souvent utile d'interpoler des points suppl\u00e9mentaires en utilisant des algorithmes d'interpolation plus avanc\u00e9s pour augmenter la densit\u00e9 du maillage. Ces algorithmes ajoutent une courbure au maillage, en essayant de simuler les propri\u00e9t\u00e9s mat\u00e9rielles du lit. Le maillage du lit offre l'interpolation de lagrange et bicubique pour accomplir ceci. [bed_mesh] speed: 120 horizontal_move_z: 5 mesh_min: 35, 6 mesh_max: 240, 198 probe_count: 5, 3 mesh_pps: 2, 3 algorithm: bicubic bicubic_tension: 0.2 mesh_pps : 2, 3 Valeur par d\u00e9faut : 2, 2 L'option mesh_pps est l'abr\u00e9viation de Mesh Points Per Segment. Cette option indique le nombre de points \u00e0 interpoler pour chaque segment le long des axes X et Y. Un 'segment' est l'espace entre chaque point palp\u00e9. Comme pour probe_count , mesh_pps est sp\u00e9cifi\u00e9 en tant que paire de nombres entiers X, Y mais peut aussi \u00eatre sp\u00e9cifi\u00e9 comme un seul nombre entier en ce cas appliqu\u00e9 aux deux axes. Dans cet exemple, il y a 4 segments le long de l'axe X et 2 segments le long de l'axe Y. Cela r\u00e9sulte en 8 points interpol\u00e9s le long de l'axe X et 6 points interpol\u00e9s le long de l'axe Y, ce qui donne un maillage de 13x8. Notez que si mesh_pps est d\u00e9fini \u00e0 0, l'interpolation de maillage est d\u00e9sactiv\u00e9e et la matrice sond\u00e9e sera \u00e9chantillonn\u00e9e directement. algorithm : lagrange Valeur par d\u00e9faut : lagrange L'algorithme utilis\u00e9 pour interpoler le maillage. Peut \u00eatre lagrange ou bicubique . L'interpolation de Lagrange est plafonn\u00e9e \u00e0 6 points palp\u00e9s car une oscillation tend \u00e0 se produire avec un plus grand nombre d'\u00e9chantillons. L'interpolation bicubique requiert un minimum de 4 points le long de chaque axe, si moins de 4 points sont sp\u00e9cifi\u00e9s, l'\u00e9chantillonnage de Lagrange est forc\u00e9. Si mesh_pps est d\u00e9fini \u00e0 0 alors cette valeur est ignor\u00e9e car aucune interpolation de maille n'est faite. bicubic_tension : 0.2 Valeur par d\u00e9faut : 0.2 Si l'option algorithm est d\u00e9finie sur bicubique, il est possible d'indiquer une valeur de tension. Plus la tension est \u00e9lev\u00e9e, plus la pente est interpol\u00e9e. Soyez prudent lorsque vous ajustez cette valeur, car des valeurs plus \u00e9lev\u00e9es cr\u00e9ent \u00e9galement plus de d\u00e9passement, ce qui entra\u00eenera des valeurs interpol\u00e9es plus \u00e9lev\u00e9es ou plus basses que vos points palp\u00e9s. L'illustration ci-dessous montre comment les options ci-dessus sont utilis\u00e9es pour g\u00e9n\u00e9rer un maillage interpol\u00e9.","title":"Interpolation du maillage"},{"location":"Bed_Mesh.html#fractionnement-des-deplacements","text":"Le maillage du lit fonctionne en interceptant les commandes de d\u00e9placement du gcode et en appliquant une transformation \u00e0 leur coordonn\u00e9e Z. Les longs d\u00e9placements doivent \u00eatre divis\u00e9s en d\u00e9placements plus petits pour suivre correctement la forme du lit. Les options ci-dessous contr\u00f4lent le comportement du fractionnement. [bed_mesh] speed: 120 horizontal_move_z: 5 mesh_min: 35, 6 mesh_max: 240, 198 probe_count: 5, 3 move_check_distance: 5 split_delta_z: .025 move_check_distance : 5 Valeur par d\u00e9faut : 5 La distance minimale de v\u00e9rification de changement de Z souhait\u00e9 avant d'effectuer un fractionnemeny. Dans cet exemple, un mouvement de plus de 5mm sera travers\u00e9 par l'algorithme. Tous les 5 mm, une recherche de maille Z sera effectu\u00e9e, en la comparant \u00e0 la valeur Z du mouvement pr\u00e9c\u00e9dent. Si le delta atteint le seuil fix\u00e9 par split_delta_z , le mouvement sera divis\u00e9 et la travers\u00e9e continuera. Ce processus se r\u00e9p\u00e8te jusqu'\u00e0 ce que la fin du d\u00e9placement soit atteinte, o\u00f9 un ajustement final sera appliqu\u00e9. Les d\u00e9placements plus courts que la move_check_distance ont l'ajustement Z correct appliqu\u00e9 directement au d\u00e9placement sans travers\u00e9e ou division. split_delta_z : .025 Valeur par d\u00e9faut : .025 Comme mentionn\u00e9 ci-dessus, il s'agit de l'\u00e9cart minimum requis pour d\u00e9clencher un fractionnement du mouvement. Dans cet exemple, toute valeur Z avec un \u00e9cart de +/- 0,025 mm d\u00e9clenchera un fractionnement. G\u00e9n\u00e9ralement les valeurs par d\u00e9faut de ces options sont suffisantes, en fait la valeur par d\u00e9faut de 5mm pour la move_check_distance est probablement exag\u00e9r\u00e9e. Cependant, un utilisateur avanc\u00e9 peut souhaiter exp\u00e9rimenter avec ces options dans le but d'obtenir une premi\u00e8re couche optimale.","title":"Fractionnement des d\u00e9placements"},{"location":"Bed_Mesh.html#attenuation-du-maillage","text":"Lorsque l'option \"fondu\" est activ\u00e9e, l'ajustement du Z est r\u00e9duit progressivement sur une distance d\u00e9finie par la configuration. Ceci est r\u00e9alis\u00e9 en appliquant de petits ajustements \u00e0 la hauteur de la couche, en augmentant ou en diminuant selon la forme du lit. Lorsque le fondu est termin\u00e9, l'ajustement Z n'est plus appliqu\u00e9, ce qui permet au sommet de l'impression d'\u00eatre plat plut\u00f4t que de refl\u00e9ter la forme du lit. Le fondu peut \u00e9galement pr\u00e9senter quelques caract\u00e9ristiques ind\u00e9sirables, si le fondu est effectu\u00e9 trop rapidement, il peut entra\u00eener des artefacts visibles sur l'impression. De plus, si votre lit est sensiblement d\u00e9form\u00e9, le fondu peut r\u00e9tr\u00e9cir ou \u00e9tirer la hauteur Z de l'impression. C'est pourquoi le fondu est d\u00e9sactiv\u00e9 par d\u00e9faut. [bed_mesh] speed: 120 horizontal_move_z: 5 mesh_min: 35, 6 mesh_max: 240, 198 probe_count: 5, 3 fade_start: 1 fade_end: 10 fade_target: 0 fade_start: 1 Valeur par d\u00e9faut : 1 La hauteur Z \u00e0 laquelle il faut commencer l'att\u00e9nuation progressive de l'ajustement. C'est une bonne id\u00e9e d'avoir quelques couches d\u00e9j\u00e0 d\u00e9pos\u00e9es avant de commencer le processus de fondu. fade_end : 10 Valeur par d\u00e9faut : 0 La hauteur Z \u00e0 laquelle le fondu doit s'arr\u00eater. Si cette valeur est inf\u00e9rieure \u00e0 fade_start , le fondu est d\u00e9sactiv\u00e9. Cette valeur peut \u00eatre ajust\u00e9e en fonction de la d\u00e9formation de la surface d'impression. Une surface fortement d\u00e9form\u00e9e devrait s'estomper sur une plus grande distance. Une surface presque plate peut \u00eatre capable de r\u00e9duire cette valeur pour s'estomper plus rapidement. 10mm est une valeur raisonnable pour commencer si vous utilisez la valeur par d\u00e9faut de 1 pour fade_start . fade_target : 0 Valeur par d\u00e9faut : La valeur Z moyenne du maillage Le fade_target peut \u00eatre consid\u00e9r\u00e9 comme un d\u00e9calage Z suppl\u00e9mentaire appliqu\u00e9 \u00e0 l'ensemble du lit apr\u00e8s la fin du fondu. En g\u00e9n\u00e9ral, nous aimerions que cette valeur soit \u00e9gale \u00e0 0, mais il y a des circonstances o\u00f9 elle ne devrait pas l'\u00eatre. Par exemple, supposons que votre position d'origine sur le lit est aberrante, elle est inf\u00e9rieure de 0,2 mm \u00e0 la hauteur moyenne palp\u00e9e du lit. Si le fade_target est 0, le fondu va r\u00e9tr\u00e9cir l'impression d'une moyenne de 0,2 mm \u00e0 travers le lit. En r\u00e9glant la fade_target sur .2, la zone d'origine sera agrandie de .2 mm, mais le reste du lit aura une taille pr\u00e9cise. En g\u00e9n\u00e9ral, c'est une bonne id\u00e9e de laisser fade_target en dehors de la configuration afin que la hauteur moyenne du maillage soit utilis\u00e9e, cependant il peut \u00eatre souhaitable d'ajuster manuellement la cible du fondu si l'on ne veut imprimer que sur une partie sp\u00e9cifique du lit.","title":"Att\u00e9nuation du maillage"},{"location":"Bed_Mesh.html#lindice-de-reference-relatif","text":"La plupart des sondes sont sensibles \u00e0 une d\u00e9rive, c'est-\u00e0-dire \u00e0 des inexactitudes dans le palpage introduites par la chaleur ou des interf\u00e9rences. Cela peut rendre difficile le calcul du d\u00e9calage en Z de la sonde, en particulier \u00e0 diff\u00e9rentes temp\u00e9ratures du lit. C'est pourquoi certaines imprimantes utilisent \u00e0 la fois une but\u00e9e pour la mise \u00e0 l'origine de l'axe Z et une sonde pour r\u00e9aliser le maillage. Ces imprimantes peuvent b\u00e9n\u00e9ficier de la configuration de l'index de r\u00e9f\u00e9rence relatif. [bed_mesh] speed: 120 horizontal_move_z: 5 mesh_min: 35, 6 mesh_max: 240, 198 probe_count: 5, 3 relative_reference_index: 7 relative_reference_index : 7 Valeur par d\u00e9faut : None (d\u00e9sactiv\u00e9) Lorsque les points palp\u00e9s sont g\u00e9n\u00e9r\u00e9s, un index leur est attribu\u00e9. Vous pouvez consulter cet index dans klippy.log ou en utilisant BED_MESH_OUTPUT (voir la section sur les GCodes de maillage de lit ci-dessous pour plus d'informations). Si vous assignez un index \u00e0 l'option relative_reference_index , la valeur palp\u00e9e \u00e0 cette coordonn\u00e9e remplacera le z_offset de la sonde. Ce qui fait de cette coordonn\u00e9e la r\u00e9f\u00e9rence \"z\u00e9ro\" pour le maillage. Lorsque vous utilisez l'indice de r\u00e9f\u00e9rence relatif, vous devez choisir l'indice le plus proche de l'endroit du lit o\u00f9 le calibrage de la but\u00e9e Z a \u00e9t\u00e9 effectu\u00e9. Notez que lorsque vous recherchez l'indice en utilisant le journal ou BED_MESH_OUTPUT, vous devez utiliser les coordonn\u00e9es list\u00e9es sous l'en-t\u00eate \"Probe\" pour trouver l'indice correct.","title":"L'indice de r\u00e9f\u00e9rence relatif"},{"location":"Bed_Mesh.html#regions-defectueuses","text":"Il est possible que certaines zones d'un lit donnent des r\u00e9sultats inexacts lors du palpage en raison d'un \"d\u00e9faut\" \u00e0 des endroits particuliers. Le meilleur exemple de ce ph\u00e9nom\u00e8ne est celui des lits comportant une s\u00e9rie d'aimants int\u00e9gr\u00e9s utilis\u00e9s pour retenir les t\u00f4les d'acier amovibles. Le champ magn\u00e9tique au niveau et autour de ces aimants peut faire qu'une sonde inductive se d\u00e9clenche \u00e0 une distance plus \u00e9lev\u00e9e ou plus basse qu'elle ne le ferait autrement, ce qui donne un maillage ne repr\u00e9sentant pas pr\u00e9cis\u00e9ment la surface \u00e0 ces endroits. Remarque : Il ne faut pas confondre ce ph\u00e9nom\u00e8ne avec le biais de l'emplacement de la sonde, qui produit des r\u00e9sultats inexacts sur l'ensemble du lit. Les options faulty_region peuvent \u00eatre configur\u00e9es pour compenser cet effet. Si un point g\u00e9n\u00e9r\u00e9 se trouve dans une r\u00e9gion d\u00e9fectueuse, le maillage du lit tentera de palper jusqu'\u00e0 4 points aux limites de cette r\u00e9gion. Ces valeurs palp\u00e9es seront moyenn\u00e9es et ins\u00e9r\u00e9es dans le maillage comme valeur Z \u00e0 la coordonn\u00e9e (X, Y) g\u00e9n\u00e9r\u00e9e. [bed_mesh] speed: 120 horizontal_move_z: 5 mesh_min: 35, 6 mesh_max: 240, 198 probe_count: 5, 3 faulty_region_1_min: 130.0, 0.0 faulty_region_1_max: 145.0, 40.0 faulty_region_2_min: 225.0, 0.0 faulty_region_2_max: 250.0, 25.0 faulty_region_3_min: 165.0, 95.0 faulty_region_3_max: 205.0, 110.0 faulty_region_4_min: 30.0, 170.0 faulty_region_4_max: 45.0, 210.0 faulty_region_{1...99}_min faulty_region_{1..99}_max Valeur par d\u00e9faut : None (d\u00e9sactiv\u00e9) Les r\u00e9gions d\u00e9fectueuses sont d\u00e9finies d'une mani\u00e8re similaire \u00e0 celle du maillage lui-m\u00eame, o\u00f9 les coordonn\u00e9es minimum et maximum (X, Y) doivent \u00eatre infiqu\u00e9es pour chaque r\u00e9gion. Une r\u00e9gion d\u00e9fectueuse peut s'\u00e9tendre \u00e0 l'ext\u00e9rieur d'un maillage, mais les points alternatifs g\u00e9n\u00e9r\u00e9s seront toujours \u00e0 l'int\u00e9rieur des limites du maillage. Deux r\u00e9gions ne peuvent pas se chevaucher. L'image ci-dessous illustre comment les points de remplacement sont g\u00e9n\u00e9r\u00e9s lorsqu'un point g\u00e9n\u00e9r\u00e9 se trouve dans une r\u00e9gion d\u00e9fectueuse. Les r\u00e9gions repr\u00e9sent\u00e9es correspondent \u00e0 celles de l'exemple de configuration ci-dessus. Les points de remplacement et leurs coordonn\u00e9es sont identifi\u00e9s en vert.","title":"R\u00e9gions d\u00e9fectueuses"},{"location":"Bed_Mesh.html#gcodes-de-maillage-du-lit","text":"","title":"Gcodes de maillage du lit"},{"location":"Bed_Mesh.html#calibration","text":"BED_MESH_CALIBRATE PROFILE=<name> METHOD=[manual | automatic] [<probe_parameter>=<value>] [<mesh_parameter>=<value>] Profil par d\u00e9faut : default M\u00e9thode par d\u00e9faut : automatique si une sonde est d\u00e9tect\u00e9e, sinon manuelle Lance la proc\u00e9dure de palpage de l'\u00e9talonnage du maillage du lit. Le maillage sera sauvegard\u00e9 dans un profil indiqu\u00e9 par le param\u00e8tre PROFILE , ou default si non pr\u00e9cis\u00e9. Si METHOD=manual est s\u00e9lectionn\u00e9, un palpage manuel sera effectu\u00e9. Lorsque vous passez du mode automatique au mode manuel, les points de maillage g\u00e9n\u00e9r\u00e9s seront automatiquement ajust\u00e9s. Il est possible de sp\u00e9cifier des param\u00e8tres de maillage pour modifier la zone palp\u00e9e. Les param\u00e8tres suivants sont disponibles : Lits rectangulaires (cart\u00e9siens) : MESH_MIN MESH_MAX PROBE_COUNT Lits circulaires (delta) : MESH_RADIUS MESH_ORIGIN ROUND_PROBE_COUNT Tous les lits : RELATIVE_REFERNCE_INDEX ALGORITHM Consultez la documentation de configuration ci-dessus pour plus de d\u00e9tails sur la fa\u00e7on dont chaque param\u00e8tre s'applique au maillage.","title":"Calibration"},{"location":"Bed_Mesh.html#profils","text":"BED_MESH_PROFILE SAVE=<name> LOAD=<name> REMOVE=<name> Apr\u00e8s avoir r\u00e9alis\u00e9 un BED_MESH_CALIBRATE, il est possible de sauvegarder l'\u00e9tat actuel du maillage dans un profil nomm\u00e9. Cela permet de charger un maillage sans re-palper le lit. Apr\u00e8s qu'un profil ait \u00e9t\u00e9 enregistr\u00e9 en utilisant BED_MESH_PROFILE SAVE=<name> , le gcode SAVE_CONFIG peut \u00eatre ex\u00e9cut\u00e9 pour \u00e9crire le profil dans printer.cfg. Les profils peuvent \u00eatre charg\u00e9s en ex\u00e9cutant BED_MESH_PROFILE LOAD=<name> . Il convient de noter que chaque fois qu'un BED_MESH_CALIBRATE est produit, l'\u00e9tat actuel est automatiquement enregistr\u00e9 dans le profil par d\u00e9faut . Si ce profil existe, il est automatiquement charg\u00e9 au d\u00e9marrage de Klipper. Si ce comportement n'est pas souhaitable, le profil par d\u00e9faut peut \u00eatre supprim\u00e9 comme suit : BED_MESH_PROFILE REMOVE=default Tout autre profil enregistr\u00e9 peut \u00eatre supprim\u00e9 de la m\u00eame mani\u00e8re, en rempla\u00e7ant default par le nom du profil que vous souhaitez supprimer.","title":"Profils"},{"location":"Bed_Mesh.html#loading-the-default-profile","text":"Previous versions of bed_mesh always loaded the profile named default on startup if it was present. This behavior has been removed in favor of allowing the user to determine when a profile is loaded. If a user wishes to load the default profile it is recommended to add BED_MESH_PROFILE LOAD=default to either their START_PRINT macro or their slicer's \"Start G-Code\" configuration, whichever is applicable. Alternatively the old behavior of loading a profile at startup can be restored with a [delayed_gcode] : [delayed_gcode bed_mesh_init] initial_duration : .01 gcode : BED_MESH_PROFILE LOAD = default","title":"Loading the default profile"},{"location":"Bed_Mesh.html#sortie","text":"BED_MESH_OUTPUT PGP=[0 | 1] Affiche l'\u00e9tat actuel du maillage dans le terminal. Notez que le maillage lui-m\u00eame est affich\u00e9 Le param\u00e8tre PGP est l'abr\u00e9viation de \"Print Generated Points\". Si PGP=1 est d\u00e9fini, les points palp\u00e9s g\u00e9n\u00e9r\u00e9s seront affich\u00e9s sur le terminal : // bed_mesh: generated points // Index | Tool Adjusted | Probe // 0 | (11.0, 1.0) | (35.0, 6.0) // 1 | (62.2, 1.0) | (86.2, 6.0) // 2 | (113.5, 1.0) | (137.5, 6.0) // 3 | (164.8, 1.0) | (188.8, 6.0) // 4 | (216.0, 1.0) | (240.0, 6.0) // 5 | (216.0, 97.0) | (240.0, 102.0) // 6 | (164.8, 97.0) | (188.8, 102.0) // 7 | (113.5, 97.0) | (137.5, 102.0) // 8 | (62.2, 97.0) | (86.2, 102.0) // 9 | (11.0, 97.0) | (35.0, 102.0) // 10 | (11.0, 193.0) | (35.0, 198.0) // 11 | (62.2, 193.0) | (86.2, 198.0) // 12 | (113.5, 193.0) | (137.5, 198.0) // 13 | (164.8, 193.0) | (188.8, 198.0) // 14 | (216.0, 193.0) | (240.0, 198.0) Les points de la colonne \"Tool Adjusted\" font r\u00e9f\u00e9rence \u00e0 l'emplacement de la buse, et les points de la colonne \"Probe\" font r\u00e9f\u00e9rence \u00e0 l'emplacement du palpeur. Notez que lors d'un palpage manuel, les points \"Probe\" se r\u00e9f\u00e8rent \u00e0 la fois \u00e0 l'emplacement de l'outil et de la buse.","title":"Sortie"},{"location":"Bed_Mesh.html#effacer-letat-du-maillage","text":"BED_MESH_CLEAR Ce G-Code peut \u00eatre utilis\u00e9 pour effacer l'\u00e9tat interne du maillage.","title":"Effacer l'\u00e9tat du maillage"},{"location":"Bed_Mesh.html#appliquer-les-decalages-xy","text":"BED_MESH_OFFSET [X=<value>] [Y=<value>] Ceci est utile pour les imprimantes avec plusieurs extrudeuses ind\u00e9pendantes, car un d\u00e9calage est n\u00e9cessaire pour produire un ajustement Z correct apr\u00e8s un changement d'outil. Les d\u00e9calages doivent \u00eatre indiqu\u00e9s par rapport \u00e0 l'extrudeuse primaire. C'est-\u00e0-dire qu'un d\u00e9calage X positif doit \u00eatre indiqu\u00e9 si l'extrudeuse secondaire est mont\u00e9e \u00e0 droite de l'extrudeuse primaire, et un d\u00e9calage Y positif doit \u00eatre indiqu\u00e9 si l'extrudeuse secondaire est mont\u00e9e \"derri\u00e8re\" l'extrudeuse primaire.","title":"Appliquer les d\u00e9calages X/Y"},{"location":"Benchmarks.html","text":"Tests \u00b6 Ce document d\u00e9crit les benchmarks Klipper. Bancs d'essai des microcontr\u00f4leurs \u00b6 Cette section d\u00e9crit le m\u00e9canisme utilis\u00e9 pour g\u00e9n\u00e9rer les bancs d'essais (benchmarks) de fr\u00e9quence de pas du microcontr\u00f4leur Klipper. L'objectif principal des bancs d'essais est de fournir un m\u00e9canisme coh\u00e9rent pour mesurer l'impact des changements de codage dans le logiciel. Un objectif secondaire est de fournir des mesures de haut niveau pour comparer les performances entre puces et entre plateformes logicielles. Le test de vitesse des moteurs pas \u00e0 pas est con\u00e7u pour trouver la fr\u00e9quence de pas maximale que le mat\u00e9riel et le logiciel peuvent atteindre. Ce taux de pas de r\u00e9f\u00e9rence n'est pas r\u00e9alisable dans une utilisation normale de Klipper car il doit effectuer d'autres t\u00e2ches (par exemple, la communication mcu/h\u00f4te, la lecture de la temp\u00e9rature, la v\u00e9rification des fin de course). En g\u00e9n\u00e9ral, les broches pour les tests sont choisies pour faire clignoter des LED ou d'autres actions inoffensives. V\u00e9rifiez toujours qu'il est s\u00fbr de commander les broches configur\u00e9es avant d'ex\u00e9cuter un test. Il n'est pas recommand\u00e9 de piloter un moteur pas \u00e0 pas lors d'un benchmark. Test du taux de pas \u00b6 Le test est effectu\u00e9 \u00e0 l'aide de l'outil console.py (d\u00e9crit dans ). Le microcontr\u00f4leur est configur\u00e9 pour la plate-forme mat\u00e9rielle (voir ci-dessous), puis ce qui suit est copi\u00e9-coll\u00e9 dans la fen\u00eatre du terminal console.py : SET start_clock {clock+freq} SET ticks 1000 reset_step_clock oid=0 clock={start_clock} set_next_step_dir oid=0 dir=0 queue_step oid=0 interval={ticks} count=60000 add=0 set_next_step_dir oid=0 dir=1 queue_step oid=0 interval=3000 count=1 add=0 reset_step_clock oid=1 clock={start_clock} set_next_step_dir oid=1 dir=0 queue_step oid=1 interval={ticks} count=60000 add=0 set_next_step_dir oid=1 dir=1 queue_step oid=1 interval=3000 count=1 add=0 reset_step_clock oid=2 clock={start_clock} set_next_step_dir oid=2 dir=0 queue_step oid=2 interval={ticks} count=60000 add=0 set_next_step_dir oid=2 dir=1 queue_step oid=2 interval=3000 count=1 add=0 Ces tests simule le d\u00e9placement de trois moteurs pas \u00e0 pas simultan\u00e9ment. Si son ex\u00e9cution entra\u00eene une erreur \"Rescheduled timer in the past\" or \"Stepper too far in past\", cela indique que le param\u00e8tre ticks est trop faible (il en r\u00e9sulte une vitesse de pas trop rapide) . L'objectif est de trouver le r\u00e9glage le plus bas du param\u00e8tre ticks qui aboutit de mani\u00e8re fiable \u00e0 la r\u00e9ussite du test. Il devrait \u00eatre possible de rechercher par dichotomie le param\u00e8tre ticks jusqu'\u00e0 ce qu'une valeur stable soit trouv\u00e9e. En cas d'\u00e9chec, on peut copier-coller ce qui suit pour effacer l'erreur en vue du prochain test : clear_shutdown Pour obtenir les tests de moteurs pas \u00e0 pas, la m\u00eame s\u00e9quence de configuration est utilis\u00e9e, mais seul le premier bloc du test ci-dessus est copi\u00e9-coll\u00e9 dans la fen\u00eatre console.py. Pour produire les tests trouv\u00e9s dans le document Fonctionnalit\u00e9s , le nombre total de pas par seconde est calcul\u00e9 en multipliant le nombre de steppers actifs par la fr\u00e9quence mcu nominale et en divisant par le param\u00e8tre final ticks. Les r\u00e9sultats sont arrondis au K le plus proche. Par exemple, avec trois steppers actifs : ECHO Test result is: {\"%.0fK\" % (3. * freq / ticks / 1000.)} Les tests sont ex\u00e9cut\u00e9s avec des param\u00e8tres adapt\u00e9s aux pilotes TMC. Pour les microcontr\u00f4leurs prenant en charge STEPPER_BOTH_EDGE=1 (comme indiqu\u00e9 dans la ligne MCU config au premier d\u00e9marrage de console.py), utilisez step_pulse_duration=0 et invert_step=-1 pour permettre un pas optimis\u00e9 sur les deux fronts de l'impulsion de pas. Pour les autres microcontr\u00f4leurs utiliser un step_pulse_duration correspondant \u00e0 100ns. Test du taux de pas sur AVR \u00b6 La s\u00e9quence de configuration suivante est utilis\u00e9e sur les puces AVR : allocate_oids count=3 config_stepper oid=0 step_pin=PA5 dir_pin=PA4 invert_step=0 step_pulse_ticks=32 config_stepper oid=1 step_pin=PA3 dir_pin=PA2 invert_step=0 step_pulse_ticks=32 config_stepper oid=2 step_pin=PC7 dir_pin=PC6 invert_step=0 step_pulse_ticks=32 finalize_config crc=0 Le test a \u00e9t\u00e9 ex\u00e9cut\u00e9 pour la derni\u00e8re fois sur le commit 59314d99 avec la version gcc avr-gcc (GCC) 5.4.0 . Les tests 16Mhz et 20Mhz ont \u00e9t\u00e9 ex\u00e9cut\u00e9s \u00e0 l'aide d'un simulavr configur\u00e9 pour un atmega644p (les tests pr\u00e9c\u00e9dents ont confirm\u00e9 que les r\u00e9sultats du simulavr correspondent aux tests sur un 16Mhz at90usb et un 16Mhz atmega2560). avr ticks 1 moteur pas \u00e0 pas 102 3 moteurs pas \u00e0 pas 486 Test du taux de pas sur Arduino Due \u00b6 La s\u00e9quence de configuration suivante est utilis\u00e9e sur le Due : allocate_oids count=3 config_stepper oid=0 step_pin=PB27 dir_pin=PA21 invert_step=-1 step_pulse_ticks=0 config_stepper oid=1 step_pin=PB26 dir_pin=PC30 invert_step=-1 step_pulse_ticks=0 config_stepper oid=2 step_pin=PA21 dir_pin=PC30 invert_step=-1 step_pulse_ticks=0 finalize_config crc=0 Le test a \u00e9t\u00e9 ex\u00e9cut\u00e9 pour la derni\u00e8re fois sur le commit 59314d99 avec la version de gcc arm-none-eabi-gcc (Fedora 10.2.0-4.fc34) 10.2.0 . sam3x8e ticks 1 moteur pas \u00e0 pas 66 3 moteurs pas \u00e0 pas 257 Test du taux de pas sur Duet Maestro \u00b6 La s\u00e9quence de configuration suivante est utilis\u00e9e sur le Duet Maestro : allocate_oids count=3 config_stepper oid=0 step_pin=PC26 dir_pin=PC18 invert_step=-1 step_pulse_ticks=0 config_stepper oid=1 step_pin=PC26 dir_pin=PA8 invert_step=-1 step_pulse_ticks=0 config_stepper oid=2 step_pin=PC26 dir_pin=PB4 invert_step=-1 step_pulse_ticks=0 finalize_config crc=0 Le test a \u00e9t\u00e9 ex\u00e9cut\u00e9 pour la derni\u00e8re fois sur le commit 59314d99 avec la version de gcc arm-none-eabi-gcc (Fedora 10.2.0-4.fc34) 10.2.0 . sam4s8c ticks 1 moteur pas \u00e0 pas 71 3 moteurs pas \u00e0 pas 260 Test du taux de pas sur Duet Wifi \u00b6 La s\u00e9quence de configuration suivante est utilis\u00e9e sur le Duet Wifi : allocate_oids count=3 config_stepper oid=0 step_pin=PD6 dir_pin=PD11 invert_step=-1 step_pulse_ticks=0 config_stepper oid=1 step_pin=PD7 dir_pin=PD12 invert_step=-1 step_pulse_ticks=0 config_stepper oid=2 step_pin=PD8 dir_pin=PD13 invert_step=-1 step_pulse_ticks=0 finalize_config crc=0 Le test a \u00e9t\u00e9 ex\u00e9cut\u00e9 pour la derni\u00e8re fois sur la validation 59314d99 avec la version gcc gcc version 10.3.1 20210621 (version) (GNU Arm Embedded Toolchain 10.3-2021.07) . sam4e8e ticks 1 moteur pas \u00e0 pas 48 3 moteurs pas \u00e0 pas 215 Test du taux de pas sur Beaglebone PRU \u00b6 La s\u00e9quence de configuration suivante est utilis\u00e9e sur le PRU : allocate_oids count=3 config_stepper oid=0 step_pin=gpio0_23 dir_pin=gpio1_12 invert_step=0 step_pulse_ticks=20 config_stepper oid=1 step_pin=gpio1_15 dir_pin=gpio0_26 invert_step=0 step_pulse_ticks=20 config_stepper oid=2 step_pin=gpio0_22 dir_pin=gpio2_1 invert_step=0 step_pulse_ticks=20 finalize_config crc=0 Le test a \u00e9t\u00e9 ex\u00e9cut\u00e9 pour la derni\u00e8re fois sur le commit 59314d99 avec la version de gcc pru-gcc (GCC) 8.0.0 20170530 (exp\u00e9rimental) . pru ticks 1 moteur pas \u00e0 pas 231 3 moteurs pas \u00e0 pas 847 Test du taux de pas STM32F042 \u00b6 La s\u00e9quence de configuration suivante est utilis\u00e9e sur le STM32F042 : allocate_oids count=3 config_stepper oid=0 step_pin=PA1 dir_pin=PA2 invert_step=-1 step_pulse_ticks=0 config_stepper oid=1 step_pin=PA3 dir_pin=PA2 invert_step=-1 step_pulse_ticks=0 config_stepper oid=2 step_pin=PB8 dir_pin=PA2 invert_step=-1 step_pulse_ticks=0 finalize_config crc=0 Le test a \u00e9t\u00e9 ex\u00e9cut\u00e9 pour la derni\u00e8re fois sur le commit 59314d99 avec la version de gcc arm-none-eabi-gcc (Fedora 10.2.0-4.fc34) 10.2.0 . stm32f042 ticks 1 moteur pas \u00e0 pas 59 3 moteurs pas \u00e0 pas 249 Test du taux de pas sur STM32F103 \u00b6 La s\u00e9quence de configuration suivante est utilis\u00e9e sur le STM32F103 : allocate_oids count=3 config_stepper oid=0 step_pin=PC13 dir_pin=PB5 invert_step=-1 step_pulse_ticks=0 config_stepper oid=1 step_pin=PB3 dir_pin=PB6 invert_step=-1 step_pulse_ticks=0 config_stepper oid=2 step_pin=PA4 dir_pin=PB7 invert_step=-1 step_pulse_ticks=0 finalize_config crc=0 Le test a \u00e9t\u00e9 ex\u00e9cut\u00e9 pour la derni\u00e8re fois sur le commit 59314d99 avec la version de gcc arm-none-eabi-gcc (Fedora 10.2.0-4.fc34) 10.2.0 . stm32f103 ticks 1 moteur pas \u00e0 pas 61 3 moteurs pas \u00e0 pas 264 Test du taux de pas sur STM32F4 \u00b6 La s\u00e9quence de configuration suivante est utilis\u00e9e sur le STM32F4 : allocate_oids count=3 config_stepper oid=0 step_pin=PA5 dir_pin=PB5 invert_step=-1 step_pulse_ticks=0 config_stepper oid=1 step_pin=PB2 dir_pin=PB6 invert_step=-1 step_pulse_ticks=0 config_stepper oid=2 step_pin=PB3 dir_pin=PB7 invert_step=-1 step_pulse_ticks=0 finalize_config crc=0 Le test a \u00e9t\u00e9 ex\u00e9cut\u00e9 pour la derni\u00e8re fois sur le commit 59314d99 avec la version de gcc arm-none-eabi-gcc (Fedora 10.2.0-4.fc34) 10.2.0 . Les r\u00e9sultats STM32F407 ont \u00e9t\u00e9 obtenus en ex\u00e9cutant un binaire STM32F407 sur un STM32F446 (et donc en utilisant une horloge de 168 MHz). stm32f446 ticks 1 moteur pas \u00e0 pas 46 3 moteurs pas \u00e0 pas 205 stm32f407 ticks 1 moteur pas \u00e0 pas 46 3 moteurs pas \u00e0 pas 205 Test du taux de pas sur STM32H7 \u00b6 La s\u00e9quence de configuration suivante est utilis\u00e9e sur un STM32H743VIT6 : allocate_oids count=3 config_stepper oid=0 step_pin=PD4 dir_pin=PD3 invert_step=-1 step_pulse_ticks=0 config_stepper oid=1 step_pin=PA15 dir_pin=PA8 invert_step=-1 step_pulse_ticks=0 config_stepper oid=2 step_pin=PE2 dir_pin=PE3 invert_step=-1 step_pulse_ticks=0 finalize_config crc=0 Le test a \u00e9t\u00e9 ex\u00e9cut\u00e9 pour la derni\u00e8re fois sur le commit 00191b5c avec la version de gcc arm-none-eabi-gcc (15:8-2019-q3-1+b1) 8.3.1 20190703 (release) [gcc- 8 branches r\u00e9vision 273027] . stm32h7 ticks 1 moteur pas \u00e0 pas 44 3 moteurs pas \u00e0 pas 198 Test du taux de pas sur STM32G0B1 \u00b6 La s\u00e9quence de configuration suivante est utilis\u00e9e sur le STM32G0B1 : allocate_oids count=3 config_stepper oid=0 step_pin=PB13 dir_pin=PB12 invert_step=-1 step_pulse_ticks=0 config_stepper oid=1 step_pin=PB10 dir_pin=PB2 invert_step=-1 step_pulse_ticks=0 config_stepper oid=2 step_pin=PB0 dir_pin=PC5 invert_step=-1 step_pulse_ticks=0 finalize_config crc=0 Le test a \u00e9t\u00e9 ex\u00e9cut\u00e9 pour la derni\u00e8re fois sur le commit 247cd753 avec la version gcc arm-none-eabi-gcc (Fedora 10.2.0-4.fc34) 10.2.0 . stm32g0b1 ticks 1 moteur pas \u00e0 pas 58 3 moteurs pas \u00e0 pas 243 Test du taux de pas sur LPC176x \u00b6 La s\u00e9quence de configuration suivante est utilis\u00e9e sur le LPC176x : allocate_oids count=3 config_stepper oid=0 step_pin=P1.20 dir_pin=P1.18 invert_step=-1 step_pulse_ticks=0 config_stepper oid=1 step_pin=P1.21 dir_pin=P1.18 invert_step=-1 step_pulse_ticks=0 config_stepper oid=2 step_pin=P1.23 dir_pin=P1.18 invert_step=-1 step_pulse_ticks=0 finalize_config crc=0 Le test a \u00e9t\u00e9 ex\u00e9cut\u00e9 pour la derni\u00e8re fois sur le commit 59314d99 avec la version de gcc arm-none-eabi-gcc (Fedora 10.2.0-4.fc34) 10.2.0 . Les r\u00e9sultats du LPC1769 \u00e0 120Mhz ont \u00e9t\u00e9 obtenus en overclockant un LPC1768 \u00e0 120Mhz. lpc1768 ticks 1 moteur pas \u00e0 pas 52 3 moteurs pas \u00e0 pas 222 lpc1769 ticks 1 moteur pas \u00e0 pas 51 3 moteurs pas \u00e0 pas 222 Test du taux de pas sur SAMD21 \u00b6 La s\u00e9quence de configuration suivante est utilis\u00e9e sur le SAMD21 : allocate_oids count=3 config_stepper oid=0 step_pin=PA27 dir_pin=PA20 invert_step=-1 step_pulse_ticks=0 config_stepper oid=1 step_pin=PB3 dir_pin=PA21 invert_step=-1 step_pulse_ticks=0 config_stepper oid=2 step_pin=PA17 dir_pin=PA21 invert_step=-1 step_pulse_ticks=0 finalize_config crc=0 Le test a \u00e9t\u00e9 ex\u00e9cut\u00e9 pour la derni\u00e8re fois sur le commit 59314d99 avec la version de gcc arm-none-eabi-gcc (Fedora 10.2.0-4.fc34) 10.2.0 sur un microcontr\u00f4leur SAMD21G18. samd21 ticks 1 moteur pas \u00e0 pas 70 3 moteurs pas \u00e0 pas 306 Test du taux de pas sur SAMD51 \u00b6 La s\u00e9quence de configuration suivante est utilis\u00e9e sur le SAMD51 : allocate_oids count=3 config_stepper oid=0 step_pin=PA22 dir_pin=PA20 invert_step=-1 step_pulse_ticks=0 config_stepper oid=1 step_pin=PA22 dir_pin=PA21 invert_step=-1 step_pulse_ticks=0 config_stepper oid=2 step_pin=PA22 dir_pin=PA19 invert_step=-1 step_pulse_ticks=0 finalize_config crc=0 Le test a \u00e9t\u00e9 ex\u00e9cut\u00e9 pour la derni\u00e8re fois sur le commit 59314d99 avec la version gcc arm-none-eabi-gcc (Fedora 10.2.0-4.fc34) 10.2.0 sur un microcontr\u00f4leur SAMD51J19A. samd51 ticks 1 moteur pas \u00e0 pas 39 3 moteurs pas \u00e0 pas 191 1 moteur pas \u00e0 pas (200Mhz) 39 3 moteurs pas \u00e0 pas (200Mhz) 181 Test du taux de pas sur RP2040 \u00b6 La s\u00e9quence de configuration suivante est utilis\u00e9e sur le RP2040 : allocate_oids count=3 config_stepper oid=0 step_pin=gpio25 dir_pin=gpio3 invert_step=-1 step_pulse_ticks=0 config_stepper oid=1 step_pin=gpio26 dir_pin=gpio4 invert_step=-1 step_pulse_ticks=0 config_stepper oid=2 step_pin=gpio27 dir_pin=gpio5 invert_step=-1 step_pulse_ticks=0 finalize_config crc=0 Le test a \u00e9t\u00e9 ex\u00e9cut\u00e9 pour la derni\u00e8re fois sur le commit 59314d99 avec la version gcc arm-none-eabi-gcc (Fedora 10.2.0-4.fc34) 10.2.0 sur une carte Raspberry Pi Pico. rp2040 ticks 1 moteur pas \u00e0 pas 5 3 moteurs pas \u00e0 pas 22 Test du taux de pas pour le MCU Linux \u00b6 La s\u00e9quence de configuration suivante est utilis\u00e9e sur un Raspberry Pi : allocate_oids count=3 config_stepper oid=0 step_pin=gpio2 dir_pin=gpio3 invert_step=0 step_pulse_ticks=5 config_stepper oid=1 step_pin=gpio4 dir_pin=gpio5 invert_step=0 step_pulse_ticks=5 config_stepper oid=2 step_pin=gpio6 dir_pin=gpio17 invert_step=0 step_pulse_ticks=5 finalize_config crc=0 Le test a \u00e9t\u00e9 ex\u00e9cut\u00e9 pour la derni\u00e8re fois sur le commit 59314d99 avec la version gcc gcc (Raspbian 8.3.0-6+rpi1) 8.3.0 sur un Raspberry Pi 3 (r\u00e9vision a02082). Il \u00e9tait difficile d'obtenir des r\u00e9sultats stables dans ce benchmark. Linux (RPi3) ticks 1 moteur pas \u00e0 pas 160 3 moteurs pas \u00e0 pas 380 Test de r\u00e9partition des commandes \u00b6 Le test de r\u00e9partition des commandes teste le nombre de commandes \"factices\" que le microcontr\u00f4leur peut traiter. Il s'agit principalement d'un test du m\u00e9canisme de communication mat\u00e9riel. Le test est ex\u00e9cut\u00e9 \u00e0 l'aide de l'outil console.py (d\u00e9crit dans ). Ce qui suit est copi\u00e9-coll\u00e9 dans la fen\u00eatre du terminal console.py : DELAY {clock + 2*freq} get_uptime FLOOD 100000 0.0 debug_nop get_uptime Une fois le test termin\u00e9, d\u00e9terminez la diff\u00e9rence entre les horloges signal\u00e9es dans les deux messages de r\u00e9ponse \"uptime\". Le nombre total de commandes par seconde est alors 100000 * mcu_frequency / clock_diff . Notez que ce test peut saturer la capacit\u00e9 USB/CPU d'un Raspberry Pi. En cas d'ex\u00e9cution sur un Raspberry Pi, Beaglebone ou un ordinateur h\u00f4te similaire, augmentez le d\u00e9lai (par exemple, DELAY {clock + 20*freq} get_uptime ). Le cas \u00e9ch\u00e9ant, les tests de performances ci-dessous concernent console.py ex\u00e9cut\u00e9 sur une machine de bureau avec l'appareil connect\u00e9 via un concentrateur \u00e0 haut d\u00e9bit. MCU Fr\u00e9quence Version Compilateur stm32f042 (CAN) 18K c105adc8 arm-none-eabi-gcc (GNU Tools 7-2018-q3-update) 7.3.1 atmega2560 (serial) 23K b161a69e avr-gcc (GCC) 4.8.1 sam3x8e (serial) 23K b161a69e arm-none-eabi-gcc (Fedora 7.1.0-5.fc27) 7.1.0 at90usb1286 (USB) 75K 01d2183f avr-gcc (GCC) 5.4.0 samd21 (USB) 223K 01d2183f arm-none-eabi-gcc (Fedora 7.4.0-1.fc30) 7.4.0 pru (m\u00e9moire partag\u00e9e) 260K c5968a08 pru-gcc (GCC) 8.0.0 20170530 (exp\u00e9rimental) stm32f103 (USB) 355K 01d2183f arm-none-eabi-gcc (Fedora 7.4.0-1.fc30) 7.4.0 sam3x8e (USB) 418K 01d2183f arm-none-eabi-gcc (Fedora 7.4.0-1.fc30) 7.4.0 lpc1768 (USB) 534K 01d2183f arm-none-eabi-gcc (Fedora 7.4.0-1.fc30) 7.4.0 lpc1769 (USB) 628K 01d2183f arm-none-eabi-gcc (Fedora 7.4.0-1.fc30) 7.4.0 sam4s8c (USB) 650K 8d4a5c16 arm-none-eabi-gcc (Fedora 7.4.0-1.fc30) 7.4.0 samd51 (USB) 864K 01d2183f arm-none-eabi-gcc (Fedora 7.4.0-1.fc30) 7.4.0 stm32f446 (USB) 870K 01d2183f arm-none-eabi-gcc (Fedora 7.4.0-1.fc30) 7.4.0 rp2040 (USB) 873K c5667193 arm-none-eabi-gcc (Fedora 10.2.0-4.fc34) 10.2.0 Tests de l'h\u00f4te \u00b6 Il est possible d'ex\u00e9cuter des tests de temporisation sur le logiciel h\u00f4te en utilisant le m\u00e9canisme de traitement \"mode batch\" (d\u00e9crit dans ). Cela se fait g\u00e9n\u00e9ralement en choisissant un fichier G-Code volumineux et complexe et en chronom\u00e9trant le temps n\u00e9cessaire au logiciel h\u00f4te pour le traiter. Par example\u202f: time ~/klippy-env/bin/python ./klippy/klippy.py config/example-cartesian.cfg -i something_complex.gcode -o /dev/null -d out/klipper.dict","title":"Tests"},{"location":"Benchmarks.html#tests","text":"Ce document d\u00e9crit les benchmarks Klipper.","title":"Tests"},{"location":"Benchmarks.html#bancs-dessai-des-microcontroleurs","text":"Cette section d\u00e9crit le m\u00e9canisme utilis\u00e9 pour g\u00e9n\u00e9rer les bancs d'essais (benchmarks) de fr\u00e9quence de pas du microcontr\u00f4leur Klipper. L'objectif principal des bancs d'essais est de fournir un m\u00e9canisme coh\u00e9rent pour mesurer l'impact des changements de codage dans le logiciel. Un objectif secondaire est de fournir des mesures de haut niveau pour comparer les performances entre puces et entre plateformes logicielles. Le test de vitesse des moteurs pas \u00e0 pas est con\u00e7u pour trouver la fr\u00e9quence de pas maximale que le mat\u00e9riel et le logiciel peuvent atteindre. Ce taux de pas de r\u00e9f\u00e9rence n'est pas r\u00e9alisable dans une utilisation normale de Klipper car il doit effectuer d'autres t\u00e2ches (par exemple, la communication mcu/h\u00f4te, la lecture de la temp\u00e9rature, la v\u00e9rification des fin de course). En g\u00e9n\u00e9ral, les broches pour les tests sont choisies pour faire clignoter des LED ou d'autres actions inoffensives. V\u00e9rifiez toujours qu'il est s\u00fbr de commander les broches configur\u00e9es avant d'ex\u00e9cuter un test. Il n'est pas recommand\u00e9 de piloter un moteur pas \u00e0 pas lors d'un benchmark.","title":"Bancs d'essai des microcontr\u00f4leurs"},{"location":"Benchmarks.html#test-du-taux-de-pas","text":"Le test est effectu\u00e9 \u00e0 l'aide de l'outil console.py (d\u00e9crit dans ). Le microcontr\u00f4leur est configur\u00e9 pour la plate-forme mat\u00e9rielle (voir ci-dessous), puis ce qui suit est copi\u00e9-coll\u00e9 dans la fen\u00eatre du terminal console.py : SET start_clock {clock+freq} SET ticks 1000 reset_step_clock oid=0 clock={start_clock} set_next_step_dir oid=0 dir=0 queue_step oid=0 interval={ticks} count=60000 add=0 set_next_step_dir oid=0 dir=1 queue_step oid=0 interval=3000 count=1 add=0 reset_step_clock oid=1 clock={start_clock} set_next_step_dir oid=1 dir=0 queue_step oid=1 interval={ticks} count=60000 add=0 set_next_step_dir oid=1 dir=1 queue_step oid=1 interval=3000 count=1 add=0 reset_step_clock oid=2 clock={start_clock} set_next_step_dir oid=2 dir=0 queue_step oid=2 interval={ticks} count=60000 add=0 set_next_step_dir oid=2 dir=1 queue_step oid=2 interval=3000 count=1 add=0 Ces tests simule le d\u00e9placement de trois moteurs pas \u00e0 pas simultan\u00e9ment. Si son ex\u00e9cution entra\u00eene une erreur \"Rescheduled timer in the past\" or \"Stepper too far in past\", cela indique que le param\u00e8tre ticks est trop faible (il en r\u00e9sulte une vitesse de pas trop rapide) . L'objectif est de trouver le r\u00e9glage le plus bas du param\u00e8tre ticks qui aboutit de mani\u00e8re fiable \u00e0 la r\u00e9ussite du test. Il devrait \u00eatre possible de rechercher par dichotomie le param\u00e8tre ticks jusqu'\u00e0 ce qu'une valeur stable soit trouv\u00e9e. En cas d'\u00e9chec, on peut copier-coller ce qui suit pour effacer l'erreur en vue du prochain test : clear_shutdown Pour obtenir les tests de moteurs pas \u00e0 pas, la m\u00eame s\u00e9quence de configuration est utilis\u00e9e, mais seul le premier bloc du test ci-dessus est copi\u00e9-coll\u00e9 dans la fen\u00eatre console.py. Pour produire les tests trouv\u00e9s dans le document Fonctionnalit\u00e9s , le nombre total de pas par seconde est calcul\u00e9 en multipliant le nombre de steppers actifs par la fr\u00e9quence mcu nominale et en divisant par le param\u00e8tre final ticks. Les r\u00e9sultats sont arrondis au K le plus proche. Par exemple, avec trois steppers actifs : ECHO Test result is: {\"%.0fK\" % (3. * freq / ticks / 1000.)} Les tests sont ex\u00e9cut\u00e9s avec des param\u00e8tres adapt\u00e9s aux pilotes TMC. Pour les microcontr\u00f4leurs prenant en charge STEPPER_BOTH_EDGE=1 (comme indiqu\u00e9 dans la ligne MCU config au premier d\u00e9marrage de console.py), utilisez step_pulse_duration=0 et invert_step=-1 pour permettre un pas optimis\u00e9 sur les deux fronts de l'impulsion de pas. Pour les autres microcontr\u00f4leurs utiliser un step_pulse_duration correspondant \u00e0 100ns.","title":"Test du taux de pas"},{"location":"Benchmarks.html#test-du-taux-de-pas-sur-avr","text":"La s\u00e9quence de configuration suivante est utilis\u00e9e sur les puces AVR : allocate_oids count=3 config_stepper oid=0 step_pin=PA5 dir_pin=PA4 invert_step=0 step_pulse_ticks=32 config_stepper oid=1 step_pin=PA3 dir_pin=PA2 invert_step=0 step_pulse_ticks=32 config_stepper oid=2 step_pin=PC7 dir_pin=PC6 invert_step=0 step_pulse_ticks=32 finalize_config crc=0 Le test a \u00e9t\u00e9 ex\u00e9cut\u00e9 pour la derni\u00e8re fois sur le commit 59314d99 avec la version gcc avr-gcc (GCC) 5.4.0 . Les tests 16Mhz et 20Mhz ont \u00e9t\u00e9 ex\u00e9cut\u00e9s \u00e0 l'aide d'un simulavr configur\u00e9 pour un atmega644p (les tests pr\u00e9c\u00e9dents ont confirm\u00e9 que les r\u00e9sultats du simulavr correspondent aux tests sur un 16Mhz at90usb et un 16Mhz atmega2560). avr ticks 1 moteur pas \u00e0 pas 102 3 moteurs pas \u00e0 pas 486","title":"Test du taux de pas sur AVR"},{"location":"Benchmarks.html#test-du-taux-de-pas-sur-arduino-due","text":"La s\u00e9quence de configuration suivante est utilis\u00e9e sur le Due : allocate_oids count=3 config_stepper oid=0 step_pin=PB27 dir_pin=PA21 invert_step=-1 step_pulse_ticks=0 config_stepper oid=1 step_pin=PB26 dir_pin=PC30 invert_step=-1 step_pulse_ticks=0 config_stepper oid=2 step_pin=PA21 dir_pin=PC30 invert_step=-1 step_pulse_ticks=0 finalize_config crc=0 Le test a \u00e9t\u00e9 ex\u00e9cut\u00e9 pour la derni\u00e8re fois sur le commit 59314d99 avec la version de gcc arm-none-eabi-gcc (Fedora 10.2.0-4.fc34) 10.2.0 . sam3x8e ticks 1 moteur pas \u00e0 pas 66 3 moteurs pas \u00e0 pas 257","title":"Test du taux de pas sur Arduino Due"},{"location":"Benchmarks.html#test-du-taux-de-pas-sur-duet-maestro","text":"La s\u00e9quence de configuration suivante est utilis\u00e9e sur le Duet Maestro : allocate_oids count=3 config_stepper oid=0 step_pin=PC26 dir_pin=PC18 invert_step=-1 step_pulse_ticks=0 config_stepper oid=1 step_pin=PC26 dir_pin=PA8 invert_step=-1 step_pulse_ticks=0 config_stepper oid=2 step_pin=PC26 dir_pin=PB4 invert_step=-1 step_pulse_ticks=0 finalize_config crc=0 Le test a \u00e9t\u00e9 ex\u00e9cut\u00e9 pour la derni\u00e8re fois sur le commit 59314d99 avec la version de gcc arm-none-eabi-gcc (Fedora 10.2.0-4.fc34) 10.2.0 . sam4s8c ticks 1 moteur pas \u00e0 pas 71 3 moteurs pas \u00e0 pas 260","title":"Test du taux de pas sur Duet Maestro"},{"location":"Benchmarks.html#test-du-taux-de-pas-sur-duet-wifi","text":"La s\u00e9quence de configuration suivante est utilis\u00e9e sur le Duet Wifi : allocate_oids count=3 config_stepper oid=0 step_pin=PD6 dir_pin=PD11 invert_step=-1 step_pulse_ticks=0 config_stepper oid=1 step_pin=PD7 dir_pin=PD12 invert_step=-1 step_pulse_ticks=0 config_stepper oid=2 step_pin=PD8 dir_pin=PD13 invert_step=-1 step_pulse_ticks=0 finalize_config crc=0 Le test a \u00e9t\u00e9 ex\u00e9cut\u00e9 pour la derni\u00e8re fois sur la validation 59314d99 avec la version gcc gcc version 10.3.1 20210621 (version) (GNU Arm Embedded Toolchain 10.3-2021.07) . sam4e8e ticks 1 moteur pas \u00e0 pas 48 3 moteurs pas \u00e0 pas 215","title":"Test du taux de pas sur Duet Wifi"},{"location":"Benchmarks.html#test-du-taux-de-pas-sur-beaglebone-pru","text":"La s\u00e9quence de configuration suivante est utilis\u00e9e sur le PRU : allocate_oids count=3 config_stepper oid=0 step_pin=gpio0_23 dir_pin=gpio1_12 invert_step=0 step_pulse_ticks=20 config_stepper oid=1 step_pin=gpio1_15 dir_pin=gpio0_26 invert_step=0 step_pulse_ticks=20 config_stepper oid=2 step_pin=gpio0_22 dir_pin=gpio2_1 invert_step=0 step_pulse_ticks=20 finalize_config crc=0 Le test a \u00e9t\u00e9 ex\u00e9cut\u00e9 pour la derni\u00e8re fois sur le commit 59314d99 avec la version de gcc pru-gcc (GCC) 8.0.0 20170530 (exp\u00e9rimental) . pru ticks 1 moteur pas \u00e0 pas 231 3 moteurs pas \u00e0 pas 847","title":"Test du taux de pas sur Beaglebone PRU"},{"location":"Benchmarks.html#test-du-taux-de-pas-stm32f042","text":"La s\u00e9quence de configuration suivante est utilis\u00e9e sur le STM32F042 : allocate_oids count=3 config_stepper oid=0 step_pin=PA1 dir_pin=PA2 invert_step=-1 step_pulse_ticks=0 config_stepper oid=1 step_pin=PA3 dir_pin=PA2 invert_step=-1 step_pulse_ticks=0 config_stepper oid=2 step_pin=PB8 dir_pin=PA2 invert_step=-1 step_pulse_ticks=0 finalize_config crc=0 Le test a \u00e9t\u00e9 ex\u00e9cut\u00e9 pour la derni\u00e8re fois sur le commit 59314d99 avec la version de gcc arm-none-eabi-gcc (Fedora 10.2.0-4.fc34) 10.2.0 . stm32f042 ticks 1 moteur pas \u00e0 pas 59 3 moteurs pas \u00e0 pas 249","title":"Test du taux de pas STM32F042"},{"location":"Benchmarks.html#test-du-taux-de-pas-sur-stm32f103","text":"La s\u00e9quence de configuration suivante est utilis\u00e9e sur le STM32F103 : allocate_oids count=3 config_stepper oid=0 step_pin=PC13 dir_pin=PB5 invert_step=-1 step_pulse_ticks=0 config_stepper oid=1 step_pin=PB3 dir_pin=PB6 invert_step=-1 step_pulse_ticks=0 config_stepper oid=2 step_pin=PA4 dir_pin=PB7 invert_step=-1 step_pulse_ticks=0 finalize_config crc=0 Le test a \u00e9t\u00e9 ex\u00e9cut\u00e9 pour la derni\u00e8re fois sur le commit 59314d99 avec la version de gcc arm-none-eabi-gcc (Fedora 10.2.0-4.fc34) 10.2.0 . stm32f103 ticks 1 moteur pas \u00e0 pas 61 3 moteurs pas \u00e0 pas 264","title":"Test du taux de pas sur STM32F103"},{"location":"Benchmarks.html#test-du-taux-de-pas-sur-stm32f4","text":"La s\u00e9quence de configuration suivante est utilis\u00e9e sur le STM32F4 : allocate_oids count=3 config_stepper oid=0 step_pin=PA5 dir_pin=PB5 invert_step=-1 step_pulse_ticks=0 config_stepper oid=1 step_pin=PB2 dir_pin=PB6 invert_step=-1 step_pulse_ticks=0 config_stepper oid=2 step_pin=PB3 dir_pin=PB7 invert_step=-1 step_pulse_ticks=0 finalize_config crc=0 Le test a \u00e9t\u00e9 ex\u00e9cut\u00e9 pour la derni\u00e8re fois sur le commit 59314d99 avec la version de gcc arm-none-eabi-gcc (Fedora 10.2.0-4.fc34) 10.2.0 . Les r\u00e9sultats STM32F407 ont \u00e9t\u00e9 obtenus en ex\u00e9cutant un binaire STM32F407 sur un STM32F446 (et donc en utilisant une horloge de 168 MHz). stm32f446 ticks 1 moteur pas \u00e0 pas 46 3 moteurs pas \u00e0 pas 205 stm32f407 ticks 1 moteur pas \u00e0 pas 46 3 moteurs pas \u00e0 pas 205","title":"Test du taux de pas sur STM32F4"},{"location":"Benchmarks.html#test-du-taux-de-pas-sur-stm32h7","text":"La s\u00e9quence de configuration suivante est utilis\u00e9e sur un STM32H743VIT6 : allocate_oids count=3 config_stepper oid=0 step_pin=PD4 dir_pin=PD3 invert_step=-1 step_pulse_ticks=0 config_stepper oid=1 step_pin=PA15 dir_pin=PA8 invert_step=-1 step_pulse_ticks=0 config_stepper oid=2 step_pin=PE2 dir_pin=PE3 invert_step=-1 step_pulse_ticks=0 finalize_config crc=0 Le test a \u00e9t\u00e9 ex\u00e9cut\u00e9 pour la derni\u00e8re fois sur le commit 00191b5c avec la version de gcc arm-none-eabi-gcc (15:8-2019-q3-1+b1) 8.3.1 20190703 (release) [gcc- 8 branches r\u00e9vision 273027] . stm32h7 ticks 1 moteur pas \u00e0 pas 44 3 moteurs pas \u00e0 pas 198","title":"Test du taux de pas sur STM32H7"},{"location":"Benchmarks.html#test-du-taux-de-pas-sur-stm32g0b1","text":"La s\u00e9quence de configuration suivante est utilis\u00e9e sur le STM32G0B1 : allocate_oids count=3 config_stepper oid=0 step_pin=PB13 dir_pin=PB12 invert_step=-1 step_pulse_ticks=0 config_stepper oid=1 step_pin=PB10 dir_pin=PB2 invert_step=-1 step_pulse_ticks=0 config_stepper oid=2 step_pin=PB0 dir_pin=PC5 invert_step=-1 step_pulse_ticks=0 finalize_config crc=0 Le test a \u00e9t\u00e9 ex\u00e9cut\u00e9 pour la derni\u00e8re fois sur le commit 247cd753 avec la version gcc arm-none-eabi-gcc (Fedora 10.2.0-4.fc34) 10.2.0 . stm32g0b1 ticks 1 moteur pas \u00e0 pas 58 3 moteurs pas \u00e0 pas 243","title":"Test du taux de pas sur STM32G0B1"},{"location":"Benchmarks.html#test-du-taux-de-pas-sur-lpc176x","text":"La s\u00e9quence de configuration suivante est utilis\u00e9e sur le LPC176x : allocate_oids count=3 config_stepper oid=0 step_pin=P1.20 dir_pin=P1.18 invert_step=-1 step_pulse_ticks=0 config_stepper oid=1 step_pin=P1.21 dir_pin=P1.18 invert_step=-1 step_pulse_ticks=0 config_stepper oid=2 step_pin=P1.23 dir_pin=P1.18 invert_step=-1 step_pulse_ticks=0 finalize_config crc=0 Le test a \u00e9t\u00e9 ex\u00e9cut\u00e9 pour la derni\u00e8re fois sur le commit 59314d99 avec la version de gcc arm-none-eabi-gcc (Fedora 10.2.0-4.fc34) 10.2.0 . Les r\u00e9sultats du LPC1769 \u00e0 120Mhz ont \u00e9t\u00e9 obtenus en overclockant un LPC1768 \u00e0 120Mhz. lpc1768 ticks 1 moteur pas \u00e0 pas 52 3 moteurs pas \u00e0 pas 222 lpc1769 ticks 1 moteur pas \u00e0 pas 51 3 moteurs pas \u00e0 pas 222","title":"Test du taux de pas sur LPC176x"},{"location":"Benchmarks.html#test-du-taux-de-pas-sur-samd21","text":"La s\u00e9quence de configuration suivante est utilis\u00e9e sur le SAMD21 : allocate_oids count=3 config_stepper oid=0 step_pin=PA27 dir_pin=PA20 invert_step=-1 step_pulse_ticks=0 config_stepper oid=1 step_pin=PB3 dir_pin=PA21 invert_step=-1 step_pulse_ticks=0 config_stepper oid=2 step_pin=PA17 dir_pin=PA21 invert_step=-1 step_pulse_ticks=0 finalize_config crc=0 Le test a \u00e9t\u00e9 ex\u00e9cut\u00e9 pour la derni\u00e8re fois sur le commit 59314d99 avec la version de gcc arm-none-eabi-gcc (Fedora 10.2.0-4.fc34) 10.2.0 sur un microcontr\u00f4leur SAMD21G18. samd21 ticks 1 moteur pas \u00e0 pas 70 3 moteurs pas \u00e0 pas 306","title":"Test du taux de pas sur SAMD21"},{"location":"Benchmarks.html#test-du-taux-de-pas-sur-samd51","text":"La s\u00e9quence de configuration suivante est utilis\u00e9e sur le SAMD51 : allocate_oids count=3 config_stepper oid=0 step_pin=PA22 dir_pin=PA20 invert_step=-1 step_pulse_ticks=0 config_stepper oid=1 step_pin=PA22 dir_pin=PA21 invert_step=-1 step_pulse_ticks=0 config_stepper oid=2 step_pin=PA22 dir_pin=PA19 invert_step=-1 step_pulse_ticks=0 finalize_config crc=0 Le test a \u00e9t\u00e9 ex\u00e9cut\u00e9 pour la derni\u00e8re fois sur le commit 59314d99 avec la version gcc arm-none-eabi-gcc (Fedora 10.2.0-4.fc34) 10.2.0 sur un microcontr\u00f4leur SAMD51J19A. samd51 ticks 1 moteur pas \u00e0 pas 39 3 moteurs pas \u00e0 pas 191 1 moteur pas \u00e0 pas (200Mhz) 39 3 moteurs pas \u00e0 pas (200Mhz) 181","title":"Test du taux de pas sur SAMD51"},{"location":"Benchmarks.html#test-du-taux-de-pas-sur-rp2040","text":"La s\u00e9quence de configuration suivante est utilis\u00e9e sur le RP2040 : allocate_oids count=3 config_stepper oid=0 step_pin=gpio25 dir_pin=gpio3 invert_step=-1 step_pulse_ticks=0 config_stepper oid=1 step_pin=gpio26 dir_pin=gpio4 invert_step=-1 step_pulse_ticks=0 config_stepper oid=2 step_pin=gpio27 dir_pin=gpio5 invert_step=-1 step_pulse_ticks=0 finalize_config crc=0 Le test a \u00e9t\u00e9 ex\u00e9cut\u00e9 pour la derni\u00e8re fois sur le commit 59314d99 avec la version gcc arm-none-eabi-gcc (Fedora 10.2.0-4.fc34) 10.2.0 sur une carte Raspberry Pi Pico. rp2040 ticks 1 moteur pas \u00e0 pas 5 3 moteurs pas \u00e0 pas 22","title":"Test du taux de pas sur RP2040"},{"location":"Benchmarks.html#test-du-taux-de-pas-pour-le-mcu-linux","text":"La s\u00e9quence de configuration suivante est utilis\u00e9e sur un Raspberry Pi : allocate_oids count=3 config_stepper oid=0 step_pin=gpio2 dir_pin=gpio3 invert_step=0 step_pulse_ticks=5 config_stepper oid=1 step_pin=gpio4 dir_pin=gpio5 invert_step=0 step_pulse_ticks=5 config_stepper oid=2 step_pin=gpio6 dir_pin=gpio17 invert_step=0 step_pulse_ticks=5 finalize_config crc=0 Le test a \u00e9t\u00e9 ex\u00e9cut\u00e9 pour la derni\u00e8re fois sur le commit 59314d99 avec la version gcc gcc (Raspbian 8.3.0-6+rpi1) 8.3.0 sur un Raspberry Pi 3 (r\u00e9vision a02082). Il \u00e9tait difficile d'obtenir des r\u00e9sultats stables dans ce benchmark. Linux (RPi3) ticks 1 moteur pas \u00e0 pas 160 3 moteurs pas \u00e0 pas 380","title":"Test du taux de pas pour le MCU Linux"},{"location":"Benchmarks.html#test-de-repartition-des-commandes","text":"Le test de r\u00e9partition des commandes teste le nombre de commandes \"factices\" que le microcontr\u00f4leur peut traiter. Il s'agit principalement d'un test du m\u00e9canisme de communication mat\u00e9riel. Le test est ex\u00e9cut\u00e9 \u00e0 l'aide de l'outil console.py (d\u00e9crit dans ). Ce qui suit est copi\u00e9-coll\u00e9 dans la fen\u00eatre du terminal console.py : DELAY {clock + 2*freq} get_uptime FLOOD 100000 0.0 debug_nop get_uptime Une fois le test termin\u00e9, d\u00e9terminez la diff\u00e9rence entre les horloges signal\u00e9es dans les deux messages de r\u00e9ponse \"uptime\". Le nombre total de commandes par seconde est alors 100000 * mcu_frequency / clock_diff . Notez que ce test peut saturer la capacit\u00e9 USB/CPU d'un Raspberry Pi. En cas d'ex\u00e9cution sur un Raspberry Pi, Beaglebone ou un ordinateur h\u00f4te similaire, augmentez le d\u00e9lai (par exemple, DELAY {clock + 20*freq} get_uptime ). Le cas \u00e9ch\u00e9ant, les tests de performances ci-dessous concernent console.py ex\u00e9cut\u00e9 sur une machine de bureau avec l'appareil connect\u00e9 via un concentrateur \u00e0 haut d\u00e9bit. MCU Fr\u00e9quence Version Compilateur stm32f042 (CAN) 18K c105adc8 arm-none-eabi-gcc (GNU Tools 7-2018-q3-update) 7.3.1 atmega2560 (serial) 23K b161a69e avr-gcc (GCC) 4.8.1 sam3x8e (serial) 23K b161a69e arm-none-eabi-gcc (Fedora 7.1.0-5.fc27) 7.1.0 at90usb1286 (USB) 75K 01d2183f avr-gcc (GCC) 5.4.0 samd21 (USB) 223K 01d2183f arm-none-eabi-gcc (Fedora 7.4.0-1.fc30) 7.4.0 pru (m\u00e9moire partag\u00e9e) 260K c5968a08 pru-gcc (GCC) 8.0.0 20170530 (exp\u00e9rimental) stm32f103 (USB) 355K 01d2183f arm-none-eabi-gcc (Fedora 7.4.0-1.fc30) 7.4.0 sam3x8e (USB) 418K 01d2183f arm-none-eabi-gcc (Fedora 7.4.0-1.fc30) 7.4.0 lpc1768 (USB) 534K 01d2183f arm-none-eabi-gcc (Fedora 7.4.0-1.fc30) 7.4.0 lpc1769 (USB) 628K 01d2183f arm-none-eabi-gcc (Fedora 7.4.0-1.fc30) 7.4.0 sam4s8c (USB) 650K 8d4a5c16 arm-none-eabi-gcc (Fedora 7.4.0-1.fc30) 7.4.0 samd51 (USB) 864K 01d2183f arm-none-eabi-gcc (Fedora 7.4.0-1.fc30) 7.4.0 stm32f446 (USB) 870K 01d2183f arm-none-eabi-gcc (Fedora 7.4.0-1.fc30) 7.4.0 rp2040 (USB) 873K c5667193 arm-none-eabi-gcc (Fedora 10.2.0-4.fc34) 10.2.0","title":"Test de r\u00e9partition des commandes"},{"location":"Benchmarks.html#tests-de-lhote","text":"Il est possible d'ex\u00e9cuter des tests de temporisation sur le logiciel h\u00f4te en utilisant le m\u00e9canisme de traitement \"mode batch\" (d\u00e9crit dans ). Cela se fait g\u00e9n\u00e9ralement en choisissant un fichier G-Code volumineux et complexe et en chronom\u00e9trant le temps n\u00e9cessaire au logiciel h\u00f4te pour le traiter. Par example\u202f: time ~/klippy-env/bin/python ./klippy/klippy.py config/example-cartesian.cfg -i something_complex.gcode -o /dev/null -d out/klipper.dict","title":"Tests de l'h\u00f4te"},{"location":"Bootloaders.html","text":"Chargeurs de d\u00e9marrage \u00b6 Ce document fournit des informations sur les \"chargeurs de d\u00e9marrage\" ou \"Bootloaders\" courants trouv\u00e9s sur les microcontr\u00f4leurs pris en charge par Klipper. Le chargeur de d\u00e9marrage est un logiciel tiers qui s'ex\u00e9cute sur le microcontr\u00f4leur lors de sa premi\u00e8re mise sous tension. Il est g\u00e9n\u00e9ralement utilis\u00e9 pour flasher une nouvelle application (par exemple, Klipper) sur le microcontr\u00f4leur sans n\u00e9cessiter de mat\u00e9riel sp\u00e9cialis\u00e9. Malheureusement, il n'existe pas de norme \u00e0 l'\u00e9chelle de l'industrie pour flasher un microcontr\u00f4leur, ni de chargeur de d\u00e9marrage standard qui fonctionne sur tous les microcontr\u00f4leurs. Pire encore, il est courant que chaque chargeur de d\u00e9marrage n\u00e9cessite un ensemble d'\u00e9tapes diff\u00e9rent pour flasher une application. Si l'on peut flasher un chargeur de d\u00e9marrage sur un microcontr\u00f4leur, on peut g\u00e9n\u00e9ralement \u00e9galement utiliser ce m\u00e9canisme pour flasher une application, mais il faut faire attention en faisant cela car on peut supprimer le chargeur de d\u00e9marrage par inadvertance. En revanche, un chargeur de d\u00e9marrage permettra g\u00e9n\u00e9ralement \u00e0 un utilisateur de flasher une application. Il est donc recommand\u00e9 d'utiliser le chargeur de d\u00e9marrage pour flasher une application lorsque cela est possible. Ce document tente de d\u00e9crire les chargeurs de d\u00e9marrage courants, les \u00e9tapes n\u00e9cessaires pour flasher un chargeur de d\u00e9marrage et les \u00e9tapes n\u00e9cessaires pour flasher une application. Ce document n'est pas une r\u00e9f\u00e9rence faisant autorit\u00e9 ; il est con\u00e7u comme une collection d'informations utiles que les d\u00e9veloppeurs de Klipper ont accumul\u00e9es. Micro-contr\u00f4leurs AVR \u00b6 De mani\u00e8re g\u00e9n\u00e9rale, le projet Arduino est une bonne r\u00e9f\u00e9rence pour les chargeurs de d\u00e9marrage et les proc\u00e9dures de flashage sur les microcontr\u00f4leurs Atmel Atmega 8 bits. En particulier, le fichier \"boards.txt\" : https://github.com/arduino/Arduino/blob/1.8.5/hardware/arduino/avr/boards.txt est une r\u00e9f\u00e9rence utile. Pour flasher le chargeur de d\u00e9marrage, les puces AVR n\u00e9cessitent un outil de flashage mat\u00e9riel externe (qui communique avec la puce \u00e0 l'aide de SPI). Cet outil peut \u00eatre achet\u00e9 (par exemple, effectuez une recherche sur le Web pour \"avr isp\", \"arduino isp\" ou \"usb tiny isp\"). Il est \u00e9galement possible d'utiliser un autre Arduino ou Raspberry Pi pour flasher un chargeur de d\u00e9marrage AVR (par exemple, faites une recherche sur le Web pour \"programmer un avr \u00e0 l'aide de raspberry pi\"). Les exemples ci-dessous sont \u00e9crits en supposant qu'un appareil de type \"AVR ISP Mk2\" est utilis\u00e9. Le logiciel \"avrdude\" est l'outil le plus utilis\u00e9 pour flasher les puces atmega (\u00e0 la fois pour flasher le chargeur de d\u00e9marrage et l'application). Atmega2560 \u00b6 Cette puce se trouve g\u00e9n\u00e9ralement dans les \"Arduino Mega\" qui sont tr\u00e8s courante parmi les cartes d'imprimante 3d. Pour flasher le chargeur de d\u00e9marrage lui-m\u00eame, utilisez quelque chose comme : wget 'https://github.com/arduino/Arduino/raw/1.8.5/hardware/arduino/avr/bootloaders/stk500v2/stk500boot_v2_mega2560.hex' avrdude -cavrispv2 -patmega2560 -P/dev/ttyACM0 -b115200 -e -u -U lock:w:0x3F:m -U efuse:w:0xFD:m -U hfuse:w:0xD8:m -U lfuse:w:0xFF:m avrdude -cavrispv2 -patmega2560 -P/dev/ttyACM0 -b115200 -U flash:w:stk500boot_v2_mega2560.hex avrdude -cavrispv2 -patmega2560 -P/dev/ttyACM0 -b115200 -U lock:w:0x0F:m Pour flasher une application, utilisez quelque chose comme : avrdude -cwiring -patmega2560 -P/dev/ttyACM0 -b115200 -D -Uflash:w:out/klipper.elf.hex:i Atmega1280 \u00b6 Cette puce se trouve g\u00e9n\u00e9ralement dans les anciennes versions de \"l'Arduino Mega\". Pour flasher le chargeur de d\u00e9marrage lui-m\u00eame, utilisez quelque chose comme : wget 'https://github.com/arduino/Arduino/raw/1.8.5/hardware/arduino/avr/bootloaders/atmega/ATmegaBOOT_168_atmega1280.hex' avrdude -cavrispv2 -patmega1280 -P/dev/ttyACM0 -b115200 -e -u -U lock:w:0x3F:m -U efuse:w:0xF5:m -U hfuse:w:0xDA:m -U lfuse:w:0xFF:m avrdude -cavrispv2 -patmega1280 -P/dev/ttyACM0 -b115200 -U flash:w:ATmegaBOOT_168_atmega1280.hex avrdude -cavrispv2 -patmega1280 -P/dev/ttyACM0 -b115200 -U lock:w:0x0F:m Pour flasher une application, utilisez quelque chose comme : avrdude -carduino -patmega1280 -P/dev/ttyACM0 -b57600 -D -Uflash:w:out/klipper.elf.hex:i Atmega1284p \u00b6 Cette puce se trouve couramment dans les cartes d'imprimante 3d de style \"Melzi\". Pour flasher le chargeur de d\u00e9marrage lui-m\u00eame, utilisez quelque chose comme : wget 'https://github.com/Lauszus/Sanguino/raw/1.0.2/bootloaders/optiboot/optiboot_atmega1284p.hex' avrdude -cavrispv2 -patmega1284p -P/dev/ttyACM0 -b115200 -e -u -U lock:w:0x3F:m -U efuse:w:0xFD:m -U hfuse:w:0xDE:m -U lfuse:w:0xFF:m avrdude -cavrispv2 -patmega1284p -P/dev/ttyACM0 -b115200 -U flash:w:optiboot_atmega1284p.hex avrdude -cavrispv2 -patmega1284p -P/dev/ttyACM0 -b115200 -U lock:w:0x0F:m Pour flasher une application, utilisez quelque chose comme : avrdude -carduino -patmega1284p -P/dev/ttyACM0 -b115200 -D -Uflash:w:out/klipper.elf.hex:i Notez qu'un certain nombre de cartes de style \"Melzi\" sont pr\u00e9install\u00e9es avec un chargeur de d\u00e9marrage qui utilise un d\u00e9bit de 57600 bauds. Dans ce cas, pour flasher une application, utilisez plut\u00f4t quelque chose comme ceci : avrdude -carduino -patmega1284p -P/dev/ttyACM0 -b57600 -D -Uflash:w:out/klipper.elf.hex:i At90usb1286 \u00b6 Ce document ne couvre pas la m\u00e9thode pour flasher un chargeur de d\u00e9marrage sur l'At90usb1286 ni le flashage g\u00e9n\u00e9ral des applications sur cet appareil. L'appareil Teensy++ de pjrc.com est livr\u00e9 avec un chargeur de d\u00e9marrage propri\u00e9taire. Il n\u00e9cessite un outil de flash personnalis\u00e9 de https://github.com/PaulStoffregen/teensy_loader_cli . On peut flasher une application avec en utilisant quelque chose comme : teensy_loader_cli --mcu=at90usb1286 out/klipper.elf.hex -v Atmega168 \u00b6 L'atmega168 a un espace flash limit\u00e9. Si vous utilisez un chargeur de d\u00e9marrage, il est recommand\u00e9 d'utiliser le chargeur de d\u00e9marrage Optiboot. Pour flasher ce chargeur de d\u00e9marrage, utilisez quelque chose comme : wget 'https://github.com/arduino/Arduino/raw/1.8.5/hardware/arduino/avr/bootloaders/optiboot/optiboot_atmega168.hex' avrdude -cavrispv2 -patmega168 -P/dev/ttyACM0 -b115200 -e -u -U lock:w:0x3F:m -U efuse:w:0x04:m -U hfuse:w:0xDD:m -U lfuse:w:0xFF:m avrdude -cavrispv2 -patmega168 -P/dev/ttyACM0 -b115200 -U flash:w:optiboot_atmega168.hex avrdude -cavrispv2 -patmega168 -P/dev/ttyACM0 -b115200 -U lock:w:0x0F:m Pour flasher une application via le chargeur de d\u00e9marrage Optiboot, utilisez quelque chose comme : avrdude -carduino -patmega168 -P/dev/ttyACM0 -b115200 -D -Uflash:w:out/klipper.elf.hex:i Micro-contr\u00f4leurs SAM3 (Arduino Due) \u00b6 Il n'est pas courant d'utiliser un chargeur de d\u00e9marrage avec le mcu SAM3. La puce elle-m\u00eame poss\u00e8de une ROM qui permet de programmer le flash \u00e0 partir du port s\u00e9rie 3,3 V ou de l'USB. Pour activer la ROM, la broche \"effacement\" est maintenue haute pendant une r\u00e9initialisation, ce qui efface le contenu flash et provoque l'ex\u00e9cution de la ROM. Sur un Arduino Due, cette s\u00e9quence peut \u00eatre accomplie en d\u00e9finissant un d\u00e9bit en bauds de 1200 sur le \"port usb de programmation\" (le port USB le plus proche de l'alimentation). Le code sur https://github.com/shumatech/BOSSA peut \u00eatre utilis\u00e9 pour programmer le SAM3. Il est recommand\u00e9 d'utiliser la version 1.9 ou ult\u00e9rieure. Pour flasher une application, utilisez quelque chose comme : bossac -U -p /dev/ttyACM0 -a -e -w out/klipper.bin -v -b bossac -U -p /dev/ttyACM0 -R Micro-contr\u00f4leurs SAM4 (Duet Wifi) \u00b6 Il n'est pas courant d'utiliser un bootloader avec le mcu SAM4. La puce elle-m\u00eame poss\u00e8de une ROM qui permet de programmer le flash \u00e0 partir du port s\u00e9rie 3,3 V ou de l'USB. Pour activer la ROM, la broche \"effacement\" est maintenue haute pendant une r\u00e9initialisation, ce qui efface le contenu flash et provoque l'ex\u00e9cution de la ROM. Le code sur https://github.com/shumatech/BOSSA peut \u00eatre utilis\u00e9 pour programmer le SAM4. Il est n\u00e9cessaire d'utiliser la version 1.8.0 ou sup\u00e9rieure. Pour flasher une application, utilisez quelque chose comme : bossac --port=/dev/ttyACM0 -b -U -e -w -v -R out/klipper.bin Micro-contr\u00f4leurs SAMD21 (Arduino Zero) \u00b6 Le chargeur de d\u00e9marrage SAMD21 est flash\u00e9 via l'interface ARM Serial Wire Debug (SWD). Cela se fait g\u00e9n\u00e9ralement avec un dongle mat\u00e9riel SWD d\u00e9di\u00e9. Alternativement, on peut utiliser un Raspberry Pi avec OpenOCD . Pour flasher un chargeur de d\u00e9marrage avec OpenOCD, utilisez la configuration de puce suivante : source [find target/at91samdXX.cfg] Procurez-vous un bootloader - par exemple : wget 'https://github.com/arduino/ArduinoCore-samd/raw/1.8.3/bootloaders/zero/samd21_sam_ba.bin' Flashez avec des commandes OpenOCD similaires \u00e0 : at91samd bootloader 0 program samd21_sam_ba.bin verify Le chargeur de d\u00e9marrage le plus courant sur le SAMD21 est celui que l'on trouve sur le \"Arduino Zero\". Il utilise un chargeur de d\u00e9marrage de 8 Ko (l'application doit \u00eatre compil\u00e9e avec une adresse de d\u00e9marrage de 8 Ko). On peut entrer dans ce chargeur de d\u00e9marrage en double-cliquant sur le bouton de r\u00e9initialisation. Pour flasher une application, utilisez quelque chose comme : bossac -U -p /dev/ttyACM0 --offset=0x2000 -w out/klipper.bin -v -b -R En revanche, \"l'Arduino M0\" utilise un bootloader de 16KiB (l'application doit \u00eatre compil\u00e9e avec une adresse de d\u00e9marrage de 16KiB). Pour flasher une application sur ce chargeur de d\u00e9marrage, r\u00e9initialisez le microcontr\u00f4leur et ex\u00e9cutez la commande flash dans les premi\u00e8res secondes du d\u00e9marrage - quelque chose comme : avrdude -c stk500v2 -p atmega2560 -P /dev/ttyACM0 -u -Uflash:w:out/klipper.elf.hex:i Micro-contr\u00f4leurs SAMD51 (Adafruit Metro-M4 et similaires) \u00b6 Comme le SAMD21, le chargeur de d\u00e9marrage SAMD51 est flash\u00e9 via l'interface ARM Serial Wire Debug (SWD). Pour flasher un chargeur de d\u00e9marrage avec OpenOCD sur un Raspberry Pi utilisez la configuration de puce suivante : source [find target/atsame5x.cfg] Obtenir un Chargeur de D\u00e9marrage - De nombreux Chargeurs de d\u00e9marrage sont disponibles sur https://github.com/adafruit/uf2-samdx1/releases/latest . Par exemple\u202f: wget 'https://github.com/adafruit/uf2-samdx1/releases/download/v3.7.0/bootloader-itsybitsy_m4-v3.7.0.bin' Flashez avec des commandes OpenOCD similaires \u00e0 : at91samd bootloader 0 program bootloader-itsybitsy_m4-v3.7.0.bin verify at91samd bootloader 16384 Le SAMD51 utilise un chargeur de d\u00e9marrage de 16 Ko (l'application doit \u00eatre compil\u00e9e avec une adresse de d\u00e9marrage de 16 Ko). Pour flasher une application, utilisez quelque chose comme : bossac -U -p /dev/ttyACM0 --offset=0x4000 -w out/klipper.bin -v -b -R Microcontr\u00f4leurs STM32F103 (dispositifs Blue Pill) \u00b6 Les appareils STM32F103 ont une ROM qui peut flasher un chargeur de d\u00e9marrage ou une application via un port s\u00e9rie 3,3 V. En r\u00e8gle g\u00e9n\u00e9rale, on c\u00e2blerait les broches PA10 (MCU Rx) et PA9 (MCU Tx) \u00e0 un adaptateur UART 3,3 V. Pour acc\u00e9der \u00e0 la ROM, il faut connecter la broche \"boot 0\" au niveau haut et la broche \"boot 1\" au niveau bas, puis r\u00e9initialiser l'appareil. Le package \"stm32flash\" peut ensuite \u00eatre utilis\u00e9 pour flasher l'appareil en utilisant quelque chose comme : stm32flash -w out/klipper.bin -v -g 0 /dev/ttyAMA0 Notez que si l'on utilise un Raspberry Pi pour le port s\u00e9rie 3.3V, le protocole stm32flash utilise un mode de parit\u00e9 s\u00e9rie que le \"mini UART\" du Raspberry Pi ne prend pas en charge. Voir https://www.raspberrypi.com/documentation/computers/configuration.html#configuring-uarts pour plus de d\u00e9tails sur l'activation de l'uart complet sur les broches GPIO du Raspberry Pi. Apr\u00e8s avoir flash\u00e9, r\u00e9glez \u00e0 la fois \"boot 0\" et \"boot 1\" sur bas afin que les futures r\u00e9initialisations d\u00e9marrent \u00e0 partir du flash. STM32F103 avec chargeur de d\u00e9marrage stm32duino \u00b6 Le projet \"stm32duino\" a un chargeur de d\u00e9marrage compatible USB - voir : https://github.com/rogerclarkmelbourne/STM32duino-bootloader Ce chargeur de d\u00e9marrage peut \u00eatre flash\u00e9 via un port s\u00e9rie 3,3 V avec quelque chose comme : wget 'https://github.com/rogerclarkmelbourne/STM32duino-bootloader/raw/master/binaries/generic_boot20_pc13.bin' stm32flash -w generic_boot20_pc13.bin -v -g 0 /dev/ttyAMA0 Ce chargeur de d\u00e9marrage utilise 8 Ko d'espace flash (l'application doit \u00eatre compil\u00e9e avec une adresse de d\u00e9marrage de 8 Ko). Flashez une application avec quelque chose comme : dfu-util -d 1eaf:0003 -a 2 -R -D out/klipper.bin Le chargeur de d\u00e9marrage ne s'ex\u00e9cute g\u00e9n\u00e9ralement que pendant une courte p\u00e9riode apr\u00e8s le d\u00e9marrage. Il peut \u00eatre n\u00e9cessaire de chronom\u00e9trer la commande ci-dessus pour qu'elle s'ex\u00e9cute pendant que le chargeur de d\u00e9marrage est toujours actif (le chargeur de d\u00e9marrage fait clignoter une LED de la carte pendant son ex\u00e9cution). Vous pouvez \u00e9galement d\u00e9finir la broche \"boot 0\" sur low et la broche \"boot 1\" sur high pour rester en mode chargeur de d\u00e9marrage apr\u00e8s une r\u00e9initialisation. STM32F103 avec chargeur de d\u00e9marrage HID \u00b6 Le chargeur de d\u00e9marrage HID est un chargeur de d\u00e9marrage compact et sans pilote capable de flasher via USB. Un fork avec des builds sp\u00e9cifiques au SKR Mini E3 1.2 est \u00e9galement disponible. Pour les cartes STM32F103 g\u00e9n\u00e9riques telles que la blue pill, il est possible de flasher le chargeur de d\u00e9marrage via un port s\u00e9rie 3.3v en utilisant stm32flash comme indiqu\u00e9 dans la section stm32duino ci-dessus, en rempla\u00e7ant le nom de fichier par le binaire du chargeur de d\u00e9marrage souhait\u00e9 (c'est-\u00e0-dire\u202f: hid_generic_pc13.bin pour la blue pill). Il n'est pas possible d'utiliser stm32flash pour le SKR Mini E3 car la broche boot0 est directement li\u00e9e \u00e0 la terre et non connect\u00e9e via des broches d'en-t\u00eate. Il est recommand\u00e9 d'utiliser un STLink V2 avec le programmeur STM32Cube pour flasher le bootloader. Si vous n'avez pas acc\u00e8s \u00e0 un STLink, il est \u00e9galement possible d'utiliser un Raspberry Pi et OpenOCD avec la configuration de puce suivante : source [find target/stm32f1x.cfg] Si vous le souhaitez, vous pouvez faire une sauvegarde du flash actuel avec la commande suivante. Notez que cela peut prendre un certain temps : flash read_bank 0 btt_skr_mini_e3_backup.bin vous pouvez flasher avec des commandes similaires \u00e0 : stm32f1x mass_erase 0 program hid_btt_skr_mini_e3.bin verify 0x08000000 NOTES\u202f: L'exemple ci-dessus efface la puce puis programme le bootloader. Quelle que soit la m\u00e9thode choisie pour flasher, il est recommand\u00e9 d'effacer la puce avant de flasher. Avant de flasher le SKR Mini E3 avec ce chargeur de d\u00e9marrage, vous devez savoir que vous ne pourrez plus mettre \u00e0 jour le firmware via la carte SD. You may need to hold down the reset button on the board while launching OpenOCD. It should display something like: Open On-Chip Debugger 0.10.0+dev-01204-gc60252ac-dirty (2020-04-27-16:00) Licensed under GNU GPL v2 For bug reports, read http://openocd.org/doc/doxygen/bugs.html DEPRECATED! use 'adapter speed' not 'adapter_khz' Info : BCM2835 GPIO JTAG/SWD bitbang driver Info : JTAG and SWD modes enabled Info : clock speed 40 kHz Info : SWD DPIDR 0x1ba01477 Info : stm32f1x.cpu: hardware has 6 breakpoints, 4 watchpoints Info : stm32f1x.cpu: external reset detected Info : starting gdb server for stm32f1x.cpu on 3333 Info : Listening on port 3333 for gdb connections Apr\u00e8s quoi, vous pouvez rel\u00e2cher le bouton de r\u00e9initialisation. Ce chargeur de d\u00e9marrage n\u00e9cessite 2 Ko d'espace flash (l'application doit \u00eatre compil\u00e9e avec une adresse de d\u00e9marrage de 2 Ko). Le programme hid-flash est utilis\u00e9 pour t\u00e9l\u00e9charger un binaire sur le bootloader. Vous pouvez installer ce logiciel avec les commandes suivantes : sudo apt install libusb-1.0 cd ~/klipper/lib/hidflash make Si le chargeur de d\u00e9marrage est en cours d'ex\u00e9cution, vous pouvez flasher avec quelque chose comme : ~/klipper/lib/hidflash/hid-flash ~/klipper/out/klipper.bin Vous pouvez aussi utiliser make flash pour flasher directement klipper : make flash FLASH_DEVICE=1209:BEBA OU si klipper a d\u00e9j\u00e0 \u00e9t\u00e9 flash\u00e9 : make flash FLASH_DEVICE=/dev/ttyACM0 Il peut \u00eatre n\u00e9cessaire d'entrer manuellement dans le chargeur de d\u00e9marrage, cela peut \u00eatre fait en d\u00e9finissant \"boot 0\" au niveau bas et \"boot 1\" au niveau haut. Sur le SKR Mini E3 \"Boot 1\" n'est pas disponible, vous pouvez donc le faire en mettant la broche PA2 au niveau bas si vous avez flash\u00e9 \"hid_btt_skr_mini_e3.bin\". Cette broche est \u00e9tiquet\u00e9e \"TX0\" sur l'en-t\u00eate TFT dans le document \"PIN\" du SKR Mini E3. Il y a une broche de terre \u00e0 c\u00f4t\u00e9 de PA2 que vous pouvez utiliser pour mettre PA2 \u00e0 0. STM32F103/STM32F072 avec chargeur de d\u00e9marrage MSC \u00b6 Le chargeur de d\u00e9marrage MSC est un chargeur de d\u00e9marrage sans pilote capable de flasher via USB. Il est possible de flasher le chargeur de d\u00e9marrage via un port s\u00e9rie 3.3v en utilisant stm32flash comme indiqu\u00e9 dans la section stm32duino ci-dessus, en rempla\u00e7ant le nom de fichier par le binaire du chargeur de d\u00e9marrage MSC souhait\u00e9 (c'est-\u00e0-dire : MSCboot-Bluepill.bin pour la blue pill). Pour les cartes STM32F072, il est \u00e9galement possible de flasher le bootloader via USB (via DFU) avec quelque chose comme : dfu-util -d 0483:df11 -a 0 -R -D MSCboot-STM32F072.bin -s0x08000000:leave Ce chargeur de d\u00e9marrage utilise 8 Ko ou 16 Ko d'espace flash, voir la description du chargeur de d\u00e9marrage (l'application doit \u00eatre compil\u00e9e avec l'adresse de d\u00e9marrage correspondante). Le chargeur de d\u00e9marrage peut \u00eatre activ\u00e9 en appuyant deux fois sur le bouton de r\u00e9initialisation de la carte. D\u00e8s que le chargeur de d\u00e9marrage est activ\u00e9, la carte appara\u00eet comme une cl\u00e9 USB sur laquelle le fichier klipper.bin peut \u00eatre copi\u00e9. STM32F103/STM32F0x2 avec chargeur de d\u00e9marrage CanBoot \u00b6 Le chargeur de d\u00e9marrage CanBoot offre une option pour t\u00e9l\u00e9charger le micrologiciel Klipper via le CANBUS. Le chargeur de d\u00e9marrage lui-m\u00eame est d\u00e9riv\u00e9 du code source de Klipper. Actuellement, CanBoot prend en charge les mod\u00e8les STM32F103, STM32F042 et STM32F072. Il est recommand\u00e9 d'utiliser un programmeur ST-Link pour flasher CanBoot, mais il devrait \u00eatre possible de flasher en utilisant stm32flash sur les appareils STM32F103 et dfu-util sur les appareils STM32F042/STM32F072. Consultez les sections pr\u00e9c\u00e9dentes de ce document pour obtenir des instructions sur ces m\u00e9thodes de flash, en rempla\u00e7ant canboot.bin par le nom de fichier, le cas \u00e9ch\u00e9ant. Le lien CanBoot ci-dessus fournit des instructions pour cr\u00e9er le chargeur de d\u00e9marrage. La premi\u00e8re fois que CanBoot a \u00e9t\u00e9 flash\u00e9, il devrait d\u00e9tecter qu'aucune application n'est pr\u00e9sente et entrer dans le chargeur de d\u00e9marrage. Si cela ne se produit pas, il est possible d'entrer dans le chargeur de d\u00e9marrage en appuyant deux fois de suite sur le bouton de r\u00e9initialisation. L'utilitaire flash_can.py fourni dans le dossier lib/canboot peut \u00eatre utilis\u00e9 pour t\u00e9l\u00e9charger le firmware Klipper. L'UUID de l'appareil doit clignoter. Si vous n'avez pas d'UUID, il est possible d'interroger les n\u0153uds ex\u00e9cutant actuellement le chargeur de d\u00e9marrage : python3 flash_can.py -q Cela renverra les UUID pour tous les n\u0153uds connect\u00e9s et qui n'avaient pas d'UUID attribu\u00e9. Cela devrait inclure tous les n\u0153uds actuellement dans le chargeur de d\u00e9marrage. Une fois que vous avez un UUID, vous pouvez t\u00e9l\u00e9charger le firmware avec la commande suivante : python3 flash_can.py -i can0 -f ~/klipper/out/klipper.bin -u aabbccddeeff O\u00f9 aabbccddeeff est remplac\u00e9 par votre UUID. Notez que les options -i et -f peuvent \u00eatre omises, elles sont par d\u00e9faut sur can0 et ~/klipper/out/klipper.bin . Lors de la cr\u00e9ation de Klipper pour une utilisation avec CanBoot, s\u00e9lectionnez l'option 8 KiB Bootloader. Micro-contr\u00f4leurs STM32F4 (SKR Pro 1.1) \u00b6 Les microcontr\u00f4leurs STM32F4 sont \u00e9quip\u00e9s d'un chargeur de d\u00e9marrage syst\u00e8me int\u00e9gr\u00e9 capable de flasher via USB (via DFU), s\u00e9rie 3,3 V et diverses autres m\u00e9thodes (voir le document STM AN2606 pour plus d'informations). Certaines cartes STM32F4, telles que le SKR Pro 1.1, ne peuvent pas entrer dans le chargeur de d\u00e9marrage DFU. Le chargeur de d\u00e9marrage HID est disponible pour les cartes bas\u00e9es sur STM32F405/407 si l'utilisateur pr\u00e9f\u00e8re flasher sur USB plut\u00f4t que d'utiliser la carte SD. Notez que vous devrez peut-\u00eatre configurer et construire une version sp\u00e9cifique \u00e0 votre carte, une version pour le SKR Pro 1.1 est disponible ici . \u00c0 moins que votre carte ne soit compatible DFU, la m\u00e9thode de flash la plus accessible est probablement via un port s\u00e9rie 3.3v, qui suit la m\u00eame proc\u00e9dure que flasher le STM32F103 avec stm32flash . Par exemple\u202f: wget https://github.com/Arksine/STM32_HID_Bootloader/releases/download/v0.5-beta/hid_bootloader_SKR_PRO.bin stm32flash -w hid_bootloader_SKR_PRO.bin -v -g 0 /dev/ttyAMA0 Ce chargeur de d\u00e9marrage n\u00e9cessite 16 Ko d'espace flash sur le STM32F4 (l'application doit \u00eatre compil\u00e9e avec une adresse de d\u00e9marrage de 16 Ko). Comme avec le STM32F1, le STM32F4 utilise l'outil hid-flash pour t\u00e9l\u00e9charger des fichiers binaires sur le MCU. Voir les instructions ci-dessus pour plus de d\u00e9tails sur la fa\u00e7on de construire et d'utiliser hid-flash. Il peut \u00eatre n\u00e9cessaire d'entrer manuellement dans le chargeur de d\u00e9marrage, cela peut \u00eatre fait en d\u00e9finissant \"boot 0\" au niveau bas, \"boot 1\" au niveau haut et en branchant l'appareil. Une fois la programmation termin\u00e9e, d\u00e9branchez l'appareil et re-r\u00e9glez \"boot 1\" au niveau bas pour que l'application soit charg\u00e9e. Micro-contr\u00f4leurs LPC176x (Smoothieboards) \u00b6 Ce document ne d\u00e9crit pas la m\u00e9thode pour flasher le Chargeur de d\u00e9marrage lui-m\u00eame - voir : http://smoothieware.org/flashing-the-bootloader pour plus d'informations sur ce sujet. Il est courant que les Smoothieboards soient livr\u00e9s avec un chargeur de d\u00e9marrage de : https://github.com/triffid/LPC17xx-DFU-Bootloader . Lors de l'utilisation de ce chargeur de d\u00e9marrage, l'application doit \u00eatre compil\u00e9e avec une adresse de d\u00e9marrage de 16 Ko. Le moyen le plus simple de flasher une application avec ce chargeur de d\u00e9marrage est de copier le fichier d'application (par exemple, out/klipper.bin ) dans un fichier nomm\u00e9 firmware.bin sur une carte SD, et puis de red\u00e9marrer le microcontr\u00f4leur avec cette carte SD. Ex\u00e9cuter OpenOCD sur le Raspberry PI \u00b6 OpenOCD est un logiciel qui peut effectuer un flashage et un d\u00e9bogage de puce de bas niveau. Il peut utiliser les broches GPIO d'un Raspberry Pi pour communiquer avec une vari\u00e9t\u00e9 de puces ARM. Cette section d\u00e9crit comment installer et lancer OpenOCD. Elle d\u00e9rive des instructions disponibles sur : https://learn.adafruit.com/programming-microcontrollers-using-openocd-on-raspberry-pi Commencez par t\u00e9l\u00e9charger et compiler le logiciel (chaque \u00e9tape peut prendre plusieurs minutes et l'\u00e9tape \"make\" peut prendre plus de 30 minutes) : sudo apt-get update sudo apt-get install autoconf libtool telnet mkdir ~/openocd cd ~/openocd/ git clone http://openocd.zylin.com/openocd cd openocd ./bootstrap ./configure --enable-sysfsgpio --enable-bcm2835gpio --prefix=/home/pi/openocd/install make make install Configurer OpenOCD \u00b6 Cr\u00e9ez un fichier de configuration OpenOCD : nano ~/openocd/openocd.cfg Utilisez une configuration similaire \u00e0 la suivante : # Utilise les pins du RPI: GPIO25 pour SWDCLK, GPIO24 pour SWDIO, GPIO18 pour nRST source [find interface/raspberrypi2-native.cfg] bcm2835gpio_swd_nums 25 24 bcm2835gpio_srst_num 18 transport select swd # Utilise le reset c\u00e2bl\u00e9 pour la raz de la puce reset_config srst_only adapter_nsrst_delay 100 adapter_nsrst_assert_width 100 # Specification du type de puce source [find target/atsame5x.cfg] # D\u00e9finir la vitesse de l'adaptateur adapter_khz 40 # Connexion \u00e0 la puce init targets reset halt C\u00e2blez le Raspberry Pi sur la puce cible \u00b6 \u00c9teignez \u00e0 la fois le Raspberry Pi et la puce cible avant le c\u00e2blage ! V\u00e9rifiez que la puce cible utilise bien du 3,3 V avant de la connecter au Raspberry Pi ! Connectez GND, SWDCLK, SWDIO et RST sur la puce cible \u00e0 GND, GPIO25, GPIO24 et GPIO18 sur le Raspberry Pi. Mettez ensuite le Raspberry Pi sous tension et alimentez la puce cible. Ex\u00e9cutez OpenOCD \u00b6 Ex\u00e9cutez OpenOCD : cd ~/openocd/ sudo ~/openocd/install/bin/openocd -f ~/openocd/openocd.cfg Ce qui pr\u00e9c\u00e8de devrait amener OpenOCD \u00e0 \u00e9mettre des messages texte, puis \u00e0 attendre (il ne doit pas imm\u00e9diatement revenir \u00e0 l'invite du shell). Si OpenOCD se ferme tout seul ou s'il continue \u00e0 \u00e9mettre des messages texte, v\u00e9rifiez \u00e0 nouveau le c\u00e2blage. Une fois OpenOCD en cours d'ex\u00e9cution et stable, on peut lui envoyer des commandes via telnet. Ouvrez une autre session SSH et ex\u00e9cutez ce qui suit : telnet 127.0.0.1 4444 (Vous pouvez quitter telnet en appuyant sur ctrl+] puis en ex\u00e9cutant la commande \"quit\".) OpenOCD et gdb \u00b6 Il est possible d'utiliser OpenOCD avec gdb pour d\u00e9boguer Klipper. Les commandes suivantes supposent que l'on ex\u00e9cute gdb sur une machine de bureau. Ajoutez ce qui suit au fichier de configuration OpenOCD : bindto 0.0.0.0 gdb_port 44444 Red\u00e9marrez OpenOCD sur le Raspberry Pi, puis ex\u00e9cutez la commande Unix suivante sur la machine de bureau : cd /path/to/klipper/ gdb out/klipper.elf Dans gdb, ex\u00e9cutez : target remote octopi:44444 (Remplacez \"octopi\" par le nom d'h\u00f4te du Raspberry Pi.) Une fois que gdb est en cours d'ex\u00e9cution, il est possible de d\u00e9finir des points d'arr\u00eat et d'inspecter les registres.","title":"Chargeurs de d\u00e9marrage"},{"location":"Bootloaders.html#chargeurs-de-demarrage","text":"Ce document fournit des informations sur les \"chargeurs de d\u00e9marrage\" ou \"Bootloaders\" courants trouv\u00e9s sur les microcontr\u00f4leurs pris en charge par Klipper. Le chargeur de d\u00e9marrage est un logiciel tiers qui s'ex\u00e9cute sur le microcontr\u00f4leur lors de sa premi\u00e8re mise sous tension. Il est g\u00e9n\u00e9ralement utilis\u00e9 pour flasher une nouvelle application (par exemple, Klipper) sur le microcontr\u00f4leur sans n\u00e9cessiter de mat\u00e9riel sp\u00e9cialis\u00e9. Malheureusement, il n'existe pas de norme \u00e0 l'\u00e9chelle de l'industrie pour flasher un microcontr\u00f4leur, ni de chargeur de d\u00e9marrage standard qui fonctionne sur tous les microcontr\u00f4leurs. Pire encore, il est courant que chaque chargeur de d\u00e9marrage n\u00e9cessite un ensemble d'\u00e9tapes diff\u00e9rent pour flasher une application. Si l'on peut flasher un chargeur de d\u00e9marrage sur un microcontr\u00f4leur, on peut g\u00e9n\u00e9ralement \u00e9galement utiliser ce m\u00e9canisme pour flasher une application, mais il faut faire attention en faisant cela car on peut supprimer le chargeur de d\u00e9marrage par inadvertance. En revanche, un chargeur de d\u00e9marrage permettra g\u00e9n\u00e9ralement \u00e0 un utilisateur de flasher une application. Il est donc recommand\u00e9 d'utiliser le chargeur de d\u00e9marrage pour flasher une application lorsque cela est possible. Ce document tente de d\u00e9crire les chargeurs de d\u00e9marrage courants, les \u00e9tapes n\u00e9cessaires pour flasher un chargeur de d\u00e9marrage et les \u00e9tapes n\u00e9cessaires pour flasher une application. Ce document n'est pas une r\u00e9f\u00e9rence faisant autorit\u00e9 ; il est con\u00e7u comme une collection d'informations utiles que les d\u00e9veloppeurs de Klipper ont accumul\u00e9es.","title":"Chargeurs de d\u00e9marrage"},{"location":"Bootloaders.html#micro-controleurs-avr","text":"De mani\u00e8re g\u00e9n\u00e9rale, le projet Arduino est une bonne r\u00e9f\u00e9rence pour les chargeurs de d\u00e9marrage et les proc\u00e9dures de flashage sur les microcontr\u00f4leurs Atmel Atmega 8 bits. En particulier, le fichier \"boards.txt\" : https://github.com/arduino/Arduino/blob/1.8.5/hardware/arduino/avr/boards.txt est une r\u00e9f\u00e9rence utile. Pour flasher le chargeur de d\u00e9marrage, les puces AVR n\u00e9cessitent un outil de flashage mat\u00e9riel externe (qui communique avec la puce \u00e0 l'aide de SPI). Cet outil peut \u00eatre achet\u00e9 (par exemple, effectuez une recherche sur le Web pour \"avr isp\", \"arduino isp\" ou \"usb tiny isp\"). Il est \u00e9galement possible d'utiliser un autre Arduino ou Raspberry Pi pour flasher un chargeur de d\u00e9marrage AVR (par exemple, faites une recherche sur le Web pour \"programmer un avr \u00e0 l'aide de raspberry pi\"). Les exemples ci-dessous sont \u00e9crits en supposant qu'un appareil de type \"AVR ISP Mk2\" est utilis\u00e9. Le logiciel \"avrdude\" est l'outil le plus utilis\u00e9 pour flasher les puces atmega (\u00e0 la fois pour flasher le chargeur de d\u00e9marrage et l'application).","title":"Micro-contr\u00f4leurs AVR"},{"location":"Bootloaders.html#atmega2560","text":"Cette puce se trouve g\u00e9n\u00e9ralement dans les \"Arduino Mega\" qui sont tr\u00e8s courante parmi les cartes d'imprimante 3d. Pour flasher le chargeur de d\u00e9marrage lui-m\u00eame, utilisez quelque chose comme : wget 'https://github.com/arduino/Arduino/raw/1.8.5/hardware/arduino/avr/bootloaders/stk500v2/stk500boot_v2_mega2560.hex' avrdude -cavrispv2 -patmega2560 -P/dev/ttyACM0 -b115200 -e -u -U lock:w:0x3F:m -U efuse:w:0xFD:m -U hfuse:w:0xD8:m -U lfuse:w:0xFF:m avrdude -cavrispv2 -patmega2560 -P/dev/ttyACM0 -b115200 -U flash:w:stk500boot_v2_mega2560.hex avrdude -cavrispv2 -patmega2560 -P/dev/ttyACM0 -b115200 -U lock:w:0x0F:m Pour flasher une application, utilisez quelque chose comme : avrdude -cwiring -patmega2560 -P/dev/ttyACM0 -b115200 -D -Uflash:w:out/klipper.elf.hex:i","title":"Atmega2560"},{"location":"Bootloaders.html#atmega1280","text":"Cette puce se trouve g\u00e9n\u00e9ralement dans les anciennes versions de \"l'Arduino Mega\". Pour flasher le chargeur de d\u00e9marrage lui-m\u00eame, utilisez quelque chose comme : wget 'https://github.com/arduino/Arduino/raw/1.8.5/hardware/arduino/avr/bootloaders/atmega/ATmegaBOOT_168_atmega1280.hex' avrdude -cavrispv2 -patmega1280 -P/dev/ttyACM0 -b115200 -e -u -U lock:w:0x3F:m -U efuse:w:0xF5:m -U hfuse:w:0xDA:m -U lfuse:w:0xFF:m avrdude -cavrispv2 -patmega1280 -P/dev/ttyACM0 -b115200 -U flash:w:ATmegaBOOT_168_atmega1280.hex avrdude -cavrispv2 -patmega1280 -P/dev/ttyACM0 -b115200 -U lock:w:0x0F:m Pour flasher une application, utilisez quelque chose comme : avrdude -carduino -patmega1280 -P/dev/ttyACM0 -b57600 -D -Uflash:w:out/klipper.elf.hex:i","title":"Atmega1280"},{"location":"Bootloaders.html#atmega1284p","text":"Cette puce se trouve couramment dans les cartes d'imprimante 3d de style \"Melzi\". Pour flasher le chargeur de d\u00e9marrage lui-m\u00eame, utilisez quelque chose comme : wget 'https://github.com/Lauszus/Sanguino/raw/1.0.2/bootloaders/optiboot/optiboot_atmega1284p.hex' avrdude -cavrispv2 -patmega1284p -P/dev/ttyACM0 -b115200 -e -u -U lock:w:0x3F:m -U efuse:w:0xFD:m -U hfuse:w:0xDE:m -U lfuse:w:0xFF:m avrdude -cavrispv2 -patmega1284p -P/dev/ttyACM0 -b115200 -U flash:w:optiboot_atmega1284p.hex avrdude -cavrispv2 -patmega1284p -P/dev/ttyACM0 -b115200 -U lock:w:0x0F:m Pour flasher une application, utilisez quelque chose comme : avrdude -carduino -patmega1284p -P/dev/ttyACM0 -b115200 -D -Uflash:w:out/klipper.elf.hex:i Notez qu'un certain nombre de cartes de style \"Melzi\" sont pr\u00e9install\u00e9es avec un chargeur de d\u00e9marrage qui utilise un d\u00e9bit de 57600 bauds. Dans ce cas, pour flasher une application, utilisez plut\u00f4t quelque chose comme ceci : avrdude -carduino -patmega1284p -P/dev/ttyACM0 -b57600 -D -Uflash:w:out/klipper.elf.hex:i","title":"Atmega1284p"},{"location":"Bootloaders.html#at90usb1286","text":"Ce document ne couvre pas la m\u00e9thode pour flasher un chargeur de d\u00e9marrage sur l'At90usb1286 ni le flashage g\u00e9n\u00e9ral des applications sur cet appareil. L'appareil Teensy++ de pjrc.com est livr\u00e9 avec un chargeur de d\u00e9marrage propri\u00e9taire. Il n\u00e9cessite un outil de flash personnalis\u00e9 de https://github.com/PaulStoffregen/teensy_loader_cli . On peut flasher une application avec en utilisant quelque chose comme : teensy_loader_cli --mcu=at90usb1286 out/klipper.elf.hex -v","title":"At90usb1286"},{"location":"Bootloaders.html#atmega168","text":"L'atmega168 a un espace flash limit\u00e9. Si vous utilisez un chargeur de d\u00e9marrage, il est recommand\u00e9 d'utiliser le chargeur de d\u00e9marrage Optiboot. Pour flasher ce chargeur de d\u00e9marrage, utilisez quelque chose comme : wget 'https://github.com/arduino/Arduino/raw/1.8.5/hardware/arduino/avr/bootloaders/optiboot/optiboot_atmega168.hex' avrdude -cavrispv2 -patmega168 -P/dev/ttyACM0 -b115200 -e -u -U lock:w:0x3F:m -U efuse:w:0x04:m -U hfuse:w:0xDD:m -U lfuse:w:0xFF:m avrdude -cavrispv2 -patmega168 -P/dev/ttyACM0 -b115200 -U flash:w:optiboot_atmega168.hex avrdude -cavrispv2 -patmega168 -P/dev/ttyACM0 -b115200 -U lock:w:0x0F:m Pour flasher une application via le chargeur de d\u00e9marrage Optiboot, utilisez quelque chose comme : avrdude -carduino -patmega168 -P/dev/ttyACM0 -b115200 -D -Uflash:w:out/klipper.elf.hex:i","title":"Atmega168"},{"location":"Bootloaders.html#micro-controleurs-sam3-arduino-due","text":"Il n'est pas courant d'utiliser un chargeur de d\u00e9marrage avec le mcu SAM3. La puce elle-m\u00eame poss\u00e8de une ROM qui permet de programmer le flash \u00e0 partir du port s\u00e9rie 3,3 V ou de l'USB. Pour activer la ROM, la broche \"effacement\" est maintenue haute pendant une r\u00e9initialisation, ce qui efface le contenu flash et provoque l'ex\u00e9cution de la ROM. Sur un Arduino Due, cette s\u00e9quence peut \u00eatre accomplie en d\u00e9finissant un d\u00e9bit en bauds de 1200 sur le \"port usb de programmation\" (le port USB le plus proche de l'alimentation). Le code sur https://github.com/shumatech/BOSSA peut \u00eatre utilis\u00e9 pour programmer le SAM3. Il est recommand\u00e9 d'utiliser la version 1.9 ou ult\u00e9rieure. Pour flasher une application, utilisez quelque chose comme : bossac -U -p /dev/ttyACM0 -a -e -w out/klipper.bin -v -b bossac -U -p /dev/ttyACM0 -R","title":"Micro-contr\u00f4leurs SAM3 (Arduino Due)"},{"location":"Bootloaders.html#micro-controleurs-sam4-duet-wifi","text":"Il n'est pas courant d'utiliser un bootloader avec le mcu SAM4. La puce elle-m\u00eame poss\u00e8de une ROM qui permet de programmer le flash \u00e0 partir du port s\u00e9rie 3,3 V ou de l'USB. Pour activer la ROM, la broche \"effacement\" est maintenue haute pendant une r\u00e9initialisation, ce qui efface le contenu flash et provoque l'ex\u00e9cution de la ROM. Le code sur https://github.com/shumatech/BOSSA peut \u00eatre utilis\u00e9 pour programmer le SAM4. Il est n\u00e9cessaire d'utiliser la version 1.8.0 ou sup\u00e9rieure. Pour flasher une application, utilisez quelque chose comme : bossac --port=/dev/ttyACM0 -b -U -e -w -v -R out/klipper.bin","title":"Micro-contr\u00f4leurs SAM4 (Duet Wifi)"},{"location":"Bootloaders.html#micro-controleurs-samd21-arduino-zero","text":"Le chargeur de d\u00e9marrage SAMD21 est flash\u00e9 via l'interface ARM Serial Wire Debug (SWD). Cela se fait g\u00e9n\u00e9ralement avec un dongle mat\u00e9riel SWD d\u00e9di\u00e9. Alternativement, on peut utiliser un Raspberry Pi avec OpenOCD . Pour flasher un chargeur de d\u00e9marrage avec OpenOCD, utilisez la configuration de puce suivante : source [find target/at91samdXX.cfg] Procurez-vous un bootloader - par exemple : wget 'https://github.com/arduino/ArduinoCore-samd/raw/1.8.3/bootloaders/zero/samd21_sam_ba.bin' Flashez avec des commandes OpenOCD similaires \u00e0 : at91samd bootloader 0 program samd21_sam_ba.bin verify Le chargeur de d\u00e9marrage le plus courant sur le SAMD21 est celui que l'on trouve sur le \"Arduino Zero\". Il utilise un chargeur de d\u00e9marrage de 8 Ko (l'application doit \u00eatre compil\u00e9e avec une adresse de d\u00e9marrage de 8 Ko). On peut entrer dans ce chargeur de d\u00e9marrage en double-cliquant sur le bouton de r\u00e9initialisation. Pour flasher une application, utilisez quelque chose comme : bossac -U -p /dev/ttyACM0 --offset=0x2000 -w out/klipper.bin -v -b -R En revanche, \"l'Arduino M0\" utilise un bootloader de 16KiB (l'application doit \u00eatre compil\u00e9e avec une adresse de d\u00e9marrage de 16KiB). Pour flasher une application sur ce chargeur de d\u00e9marrage, r\u00e9initialisez le microcontr\u00f4leur et ex\u00e9cutez la commande flash dans les premi\u00e8res secondes du d\u00e9marrage - quelque chose comme : avrdude -c stk500v2 -p atmega2560 -P /dev/ttyACM0 -u -Uflash:w:out/klipper.elf.hex:i","title":"Micro-contr\u00f4leurs SAMD21 (Arduino Zero)"},{"location":"Bootloaders.html#micro-controleurs-samd51-adafruit-metro-m4-et-similaires","text":"Comme le SAMD21, le chargeur de d\u00e9marrage SAMD51 est flash\u00e9 via l'interface ARM Serial Wire Debug (SWD). Pour flasher un chargeur de d\u00e9marrage avec OpenOCD sur un Raspberry Pi utilisez la configuration de puce suivante : source [find target/atsame5x.cfg] Obtenir un Chargeur de D\u00e9marrage - De nombreux Chargeurs de d\u00e9marrage sont disponibles sur https://github.com/adafruit/uf2-samdx1/releases/latest . Par exemple\u202f: wget 'https://github.com/adafruit/uf2-samdx1/releases/download/v3.7.0/bootloader-itsybitsy_m4-v3.7.0.bin' Flashez avec des commandes OpenOCD similaires \u00e0 : at91samd bootloader 0 program bootloader-itsybitsy_m4-v3.7.0.bin verify at91samd bootloader 16384 Le SAMD51 utilise un chargeur de d\u00e9marrage de 16 Ko (l'application doit \u00eatre compil\u00e9e avec une adresse de d\u00e9marrage de 16 Ko). Pour flasher une application, utilisez quelque chose comme : bossac -U -p /dev/ttyACM0 --offset=0x4000 -w out/klipper.bin -v -b -R","title":"Micro-contr\u00f4leurs SAMD51 (Adafruit Metro-M4 et similaires)"},{"location":"Bootloaders.html#microcontroleurs-stm32f103-dispositifs-blue-pill","text":"Les appareils STM32F103 ont une ROM qui peut flasher un chargeur de d\u00e9marrage ou une application via un port s\u00e9rie 3,3 V. En r\u00e8gle g\u00e9n\u00e9rale, on c\u00e2blerait les broches PA10 (MCU Rx) et PA9 (MCU Tx) \u00e0 un adaptateur UART 3,3 V. Pour acc\u00e9der \u00e0 la ROM, il faut connecter la broche \"boot 0\" au niveau haut et la broche \"boot 1\" au niveau bas, puis r\u00e9initialiser l'appareil. Le package \"stm32flash\" peut ensuite \u00eatre utilis\u00e9 pour flasher l'appareil en utilisant quelque chose comme : stm32flash -w out/klipper.bin -v -g 0 /dev/ttyAMA0 Notez que si l'on utilise un Raspberry Pi pour le port s\u00e9rie 3.3V, le protocole stm32flash utilise un mode de parit\u00e9 s\u00e9rie que le \"mini UART\" du Raspberry Pi ne prend pas en charge. Voir https://www.raspberrypi.com/documentation/computers/configuration.html#configuring-uarts pour plus de d\u00e9tails sur l'activation de l'uart complet sur les broches GPIO du Raspberry Pi. Apr\u00e8s avoir flash\u00e9, r\u00e9glez \u00e0 la fois \"boot 0\" et \"boot 1\" sur bas afin que les futures r\u00e9initialisations d\u00e9marrent \u00e0 partir du flash.","title":"Microcontr\u00f4leurs STM32F103 (dispositifs Blue Pill)"},{"location":"Bootloaders.html#stm32f103-avec-chargeur-de-demarrage-stm32duino","text":"Le projet \"stm32duino\" a un chargeur de d\u00e9marrage compatible USB - voir : https://github.com/rogerclarkmelbourne/STM32duino-bootloader Ce chargeur de d\u00e9marrage peut \u00eatre flash\u00e9 via un port s\u00e9rie 3,3 V avec quelque chose comme : wget 'https://github.com/rogerclarkmelbourne/STM32duino-bootloader/raw/master/binaries/generic_boot20_pc13.bin' stm32flash -w generic_boot20_pc13.bin -v -g 0 /dev/ttyAMA0 Ce chargeur de d\u00e9marrage utilise 8 Ko d'espace flash (l'application doit \u00eatre compil\u00e9e avec une adresse de d\u00e9marrage de 8 Ko). Flashez une application avec quelque chose comme : dfu-util -d 1eaf:0003 -a 2 -R -D out/klipper.bin Le chargeur de d\u00e9marrage ne s'ex\u00e9cute g\u00e9n\u00e9ralement que pendant une courte p\u00e9riode apr\u00e8s le d\u00e9marrage. Il peut \u00eatre n\u00e9cessaire de chronom\u00e9trer la commande ci-dessus pour qu'elle s'ex\u00e9cute pendant que le chargeur de d\u00e9marrage est toujours actif (le chargeur de d\u00e9marrage fait clignoter une LED de la carte pendant son ex\u00e9cution). Vous pouvez \u00e9galement d\u00e9finir la broche \"boot 0\" sur low et la broche \"boot 1\" sur high pour rester en mode chargeur de d\u00e9marrage apr\u00e8s une r\u00e9initialisation.","title":"STM32F103 avec chargeur de d\u00e9marrage stm32duino"},{"location":"Bootloaders.html#stm32f103-avec-chargeur-de-demarrage-hid","text":"Le chargeur de d\u00e9marrage HID est un chargeur de d\u00e9marrage compact et sans pilote capable de flasher via USB. Un fork avec des builds sp\u00e9cifiques au SKR Mini E3 1.2 est \u00e9galement disponible. Pour les cartes STM32F103 g\u00e9n\u00e9riques telles que la blue pill, il est possible de flasher le chargeur de d\u00e9marrage via un port s\u00e9rie 3.3v en utilisant stm32flash comme indiqu\u00e9 dans la section stm32duino ci-dessus, en rempla\u00e7ant le nom de fichier par le binaire du chargeur de d\u00e9marrage souhait\u00e9 (c'est-\u00e0-dire\u202f: hid_generic_pc13.bin pour la blue pill). Il n'est pas possible d'utiliser stm32flash pour le SKR Mini E3 car la broche boot0 est directement li\u00e9e \u00e0 la terre et non connect\u00e9e via des broches d'en-t\u00eate. Il est recommand\u00e9 d'utiliser un STLink V2 avec le programmeur STM32Cube pour flasher le bootloader. Si vous n'avez pas acc\u00e8s \u00e0 un STLink, il est \u00e9galement possible d'utiliser un Raspberry Pi et OpenOCD avec la configuration de puce suivante : source [find target/stm32f1x.cfg] Si vous le souhaitez, vous pouvez faire une sauvegarde du flash actuel avec la commande suivante. Notez que cela peut prendre un certain temps : flash read_bank 0 btt_skr_mini_e3_backup.bin vous pouvez flasher avec des commandes similaires \u00e0 : stm32f1x mass_erase 0 program hid_btt_skr_mini_e3.bin verify 0x08000000 NOTES\u202f: L'exemple ci-dessus efface la puce puis programme le bootloader. Quelle que soit la m\u00e9thode choisie pour flasher, il est recommand\u00e9 d'effacer la puce avant de flasher. Avant de flasher le SKR Mini E3 avec ce chargeur de d\u00e9marrage, vous devez savoir que vous ne pourrez plus mettre \u00e0 jour le firmware via la carte SD. You may need to hold down the reset button on the board while launching OpenOCD. It should display something like: Open On-Chip Debugger 0.10.0+dev-01204-gc60252ac-dirty (2020-04-27-16:00) Licensed under GNU GPL v2 For bug reports, read http://openocd.org/doc/doxygen/bugs.html DEPRECATED! use 'adapter speed' not 'adapter_khz' Info : BCM2835 GPIO JTAG/SWD bitbang driver Info : JTAG and SWD modes enabled Info : clock speed 40 kHz Info : SWD DPIDR 0x1ba01477 Info : stm32f1x.cpu: hardware has 6 breakpoints, 4 watchpoints Info : stm32f1x.cpu: external reset detected Info : starting gdb server for stm32f1x.cpu on 3333 Info : Listening on port 3333 for gdb connections Apr\u00e8s quoi, vous pouvez rel\u00e2cher le bouton de r\u00e9initialisation. Ce chargeur de d\u00e9marrage n\u00e9cessite 2 Ko d'espace flash (l'application doit \u00eatre compil\u00e9e avec une adresse de d\u00e9marrage de 2 Ko). Le programme hid-flash est utilis\u00e9 pour t\u00e9l\u00e9charger un binaire sur le bootloader. Vous pouvez installer ce logiciel avec les commandes suivantes : sudo apt install libusb-1.0 cd ~/klipper/lib/hidflash make Si le chargeur de d\u00e9marrage est en cours d'ex\u00e9cution, vous pouvez flasher avec quelque chose comme : ~/klipper/lib/hidflash/hid-flash ~/klipper/out/klipper.bin Vous pouvez aussi utiliser make flash pour flasher directement klipper : make flash FLASH_DEVICE=1209:BEBA OU si klipper a d\u00e9j\u00e0 \u00e9t\u00e9 flash\u00e9 : make flash FLASH_DEVICE=/dev/ttyACM0 Il peut \u00eatre n\u00e9cessaire d'entrer manuellement dans le chargeur de d\u00e9marrage, cela peut \u00eatre fait en d\u00e9finissant \"boot 0\" au niveau bas et \"boot 1\" au niveau haut. Sur le SKR Mini E3 \"Boot 1\" n'est pas disponible, vous pouvez donc le faire en mettant la broche PA2 au niveau bas si vous avez flash\u00e9 \"hid_btt_skr_mini_e3.bin\". Cette broche est \u00e9tiquet\u00e9e \"TX0\" sur l'en-t\u00eate TFT dans le document \"PIN\" du SKR Mini E3. Il y a une broche de terre \u00e0 c\u00f4t\u00e9 de PA2 que vous pouvez utiliser pour mettre PA2 \u00e0 0.","title":"STM32F103 avec chargeur de d\u00e9marrage HID"},{"location":"Bootloaders.html#stm32f103stm32f072-avec-chargeur-de-demarrage-msc","text":"Le chargeur de d\u00e9marrage MSC est un chargeur de d\u00e9marrage sans pilote capable de flasher via USB. Il est possible de flasher le chargeur de d\u00e9marrage via un port s\u00e9rie 3.3v en utilisant stm32flash comme indiqu\u00e9 dans la section stm32duino ci-dessus, en rempla\u00e7ant le nom de fichier par le binaire du chargeur de d\u00e9marrage MSC souhait\u00e9 (c'est-\u00e0-dire : MSCboot-Bluepill.bin pour la blue pill). Pour les cartes STM32F072, il est \u00e9galement possible de flasher le bootloader via USB (via DFU) avec quelque chose comme : dfu-util -d 0483:df11 -a 0 -R -D MSCboot-STM32F072.bin -s0x08000000:leave Ce chargeur de d\u00e9marrage utilise 8 Ko ou 16 Ko d'espace flash, voir la description du chargeur de d\u00e9marrage (l'application doit \u00eatre compil\u00e9e avec l'adresse de d\u00e9marrage correspondante). Le chargeur de d\u00e9marrage peut \u00eatre activ\u00e9 en appuyant deux fois sur le bouton de r\u00e9initialisation de la carte. D\u00e8s que le chargeur de d\u00e9marrage est activ\u00e9, la carte appara\u00eet comme une cl\u00e9 USB sur laquelle le fichier klipper.bin peut \u00eatre copi\u00e9.","title":"STM32F103/STM32F072 avec chargeur de d\u00e9marrage MSC"},{"location":"Bootloaders.html#stm32f103stm32f0x2-avec-chargeur-de-demarrage-canboot","text":"Le chargeur de d\u00e9marrage CanBoot offre une option pour t\u00e9l\u00e9charger le micrologiciel Klipper via le CANBUS. Le chargeur de d\u00e9marrage lui-m\u00eame est d\u00e9riv\u00e9 du code source de Klipper. Actuellement, CanBoot prend en charge les mod\u00e8les STM32F103, STM32F042 et STM32F072. Il est recommand\u00e9 d'utiliser un programmeur ST-Link pour flasher CanBoot, mais il devrait \u00eatre possible de flasher en utilisant stm32flash sur les appareils STM32F103 et dfu-util sur les appareils STM32F042/STM32F072. Consultez les sections pr\u00e9c\u00e9dentes de ce document pour obtenir des instructions sur ces m\u00e9thodes de flash, en rempla\u00e7ant canboot.bin par le nom de fichier, le cas \u00e9ch\u00e9ant. Le lien CanBoot ci-dessus fournit des instructions pour cr\u00e9er le chargeur de d\u00e9marrage. La premi\u00e8re fois que CanBoot a \u00e9t\u00e9 flash\u00e9, il devrait d\u00e9tecter qu'aucune application n'est pr\u00e9sente et entrer dans le chargeur de d\u00e9marrage. Si cela ne se produit pas, il est possible d'entrer dans le chargeur de d\u00e9marrage en appuyant deux fois de suite sur le bouton de r\u00e9initialisation. L'utilitaire flash_can.py fourni dans le dossier lib/canboot peut \u00eatre utilis\u00e9 pour t\u00e9l\u00e9charger le firmware Klipper. L'UUID de l'appareil doit clignoter. Si vous n'avez pas d'UUID, il est possible d'interroger les n\u0153uds ex\u00e9cutant actuellement le chargeur de d\u00e9marrage : python3 flash_can.py -q Cela renverra les UUID pour tous les n\u0153uds connect\u00e9s et qui n'avaient pas d'UUID attribu\u00e9. Cela devrait inclure tous les n\u0153uds actuellement dans le chargeur de d\u00e9marrage. Une fois que vous avez un UUID, vous pouvez t\u00e9l\u00e9charger le firmware avec la commande suivante : python3 flash_can.py -i can0 -f ~/klipper/out/klipper.bin -u aabbccddeeff O\u00f9 aabbccddeeff est remplac\u00e9 par votre UUID. Notez que les options -i et -f peuvent \u00eatre omises, elles sont par d\u00e9faut sur can0 et ~/klipper/out/klipper.bin . Lors de la cr\u00e9ation de Klipper pour une utilisation avec CanBoot, s\u00e9lectionnez l'option 8 KiB Bootloader.","title":"STM32F103/STM32F0x2 avec chargeur de d\u00e9marrage CanBoot"},{"location":"Bootloaders.html#micro-controleurs-stm32f4-skr-pro-11","text":"Les microcontr\u00f4leurs STM32F4 sont \u00e9quip\u00e9s d'un chargeur de d\u00e9marrage syst\u00e8me int\u00e9gr\u00e9 capable de flasher via USB (via DFU), s\u00e9rie 3,3 V et diverses autres m\u00e9thodes (voir le document STM AN2606 pour plus d'informations). Certaines cartes STM32F4, telles que le SKR Pro 1.1, ne peuvent pas entrer dans le chargeur de d\u00e9marrage DFU. Le chargeur de d\u00e9marrage HID est disponible pour les cartes bas\u00e9es sur STM32F405/407 si l'utilisateur pr\u00e9f\u00e8re flasher sur USB plut\u00f4t que d'utiliser la carte SD. Notez que vous devrez peut-\u00eatre configurer et construire une version sp\u00e9cifique \u00e0 votre carte, une version pour le SKR Pro 1.1 est disponible ici . \u00c0 moins que votre carte ne soit compatible DFU, la m\u00e9thode de flash la plus accessible est probablement via un port s\u00e9rie 3.3v, qui suit la m\u00eame proc\u00e9dure que flasher le STM32F103 avec stm32flash . Par exemple\u202f: wget https://github.com/Arksine/STM32_HID_Bootloader/releases/download/v0.5-beta/hid_bootloader_SKR_PRO.bin stm32flash -w hid_bootloader_SKR_PRO.bin -v -g 0 /dev/ttyAMA0 Ce chargeur de d\u00e9marrage n\u00e9cessite 16 Ko d'espace flash sur le STM32F4 (l'application doit \u00eatre compil\u00e9e avec une adresse de d\u00e9marrage de 16 Ko). Comme avec le STM32F1, le STM32F4 utilise l'outil hid-flash pour t\u00e9l\u00e9charger des fichiers binaires sur le MCU. Voir les instructions ci-dessus pour plus de d\u00e9tails sur la fa\u00e7on de construire et d'utiliser hid-flash. Il peut \u00eatre n\u00e9cessaire d'entrer manuellement dans le chargeur de d\u00e9marrage, cela peut \u00eatre fait en d\u00e9finissant \"boot 0\" au niveau bas, \"boot 1\" au niveau haut et en branchant l'appareil. Une fois la programmation termin\u00e9e, d\u00e9branchez l'appareil et re-r\u00e9glez \"boot 1\" au niveau bas pour que l'application soit charg\u00e9e.","title":"Micro-contr\u00f4leurs STM32F4 (SKR Pro 1.1)"},{"location":"Bootloaders.html#micro-controleurs-lpc176x-smoothieboards","text":"Ce document ne d\u00e9crit pas la m\u00e9thode pour flasher le Chargeur de d\u00e9marrage lui-m\u00eame - voir : http://smoothieware.org/flashing-the-bootloader pour plus d'informations sur ce sujet. Il est courant que les Smoothieboards soient livr\u00e9s avec un chargeur de d\u00e9marrage de : https://github.com/triffid/LPC17xx-DFU-Bootloader . Lors de l'utilisation de ce chargeur de d\u00e9marrage, l'application doit \u00eatre compil\u00e9e avec une adresse de d\u00e9marrage de 16 Ko. Le moyen le plus simple de flasher une application avec ce chargeur de d\u00e9marrage est de copier le fichier d'application (par exemple, out/klipper.bin ) dans un fichier nomm\u00e9 firmware.bin sur une carte SD, et puis de red\u00e9marrer le microcontr\u00f4leur avec cette carte SD.","title":"Micro-contr\u00f4leurs LPC176x (Smoothieboards)"},{"location":"Bootloaders.html#executer-openocd-sur-le-raspberry-pi","text":"OpenOCD est un logiciel qui peut effectuer un flashage et un d\u00e9bogage de puce de bas niveau. Il peut utiliser les broches GPIO d'un Raspberry Pi pour communiquer avec une vari\u00e9t\u00e9 de puces ARM. Cette section d\u00e9crit comment installer et lancer OpenOCD. Elle d\u00e9rive des instructions disponibles sur : https://learn.adafruit.com/programming-microcontrollers-using-openocd-on-raspberry-pi Commencez par t\u00e9l\u00e9charger et compiler le logiciel (chaque \u00e9tape peut prendre plusieurs minutes et l'\u00e9tape \"make\" peut prendre plus de 30 minutes) : sudo apt-get update sudo apt-get install autoconf libtool telnet mkdir ~/openocd cd ~/openocd/ git clone http://openocd.zylin.com/openocd cd openocd ./bootstrap ./configure --enable-sysfsgpio --enable-bcm2835gpio --prefix=/home/pi/openocd/install make make install","title":"Ex\u00e9cuter OpenOCD sur le Raspberry PI"},{"location":"Bootloaders.html#configurer-openocd","text":"Cr\u00e9ez un fichier de configuration OpenOCD : nano ~/openocd/openocd.cfg Utilisez une configuration similaire \u00e0 la suivante : # Utilise les pins du RPI: GPIO25 pour SWDCLK, GPIO24 pour SWDIO, GPIO18 pour nRST source [find interface/raspberrypi2-native.cfg] bcm2835gpio_swd_nums 25 24 bcm2835gpio_srst_num 18 transport select swd # Utilise le reset c\u00e2bl\u00e9 pour la raz de la puce reset_config srst_only adapter_nsrst_delay 100 adapter_nsrst_assert_width 100 # Specification du type de puce source [find target/atsame5x.cfg] # D\u00e9finir la vitesse de l'adaptateur adapter_khz 40 # Connexion \u00e0 la puce init targets reset halt","title":"Configurer OpenOCD"},{"location":"Bootloaders.html#cablez-le-raspberry-pi-sur-la-puce-cible","text":"\u00c9teignez \u00e0 la fois le Raspberry Pi et la puce cible avant le c\u00e2blage ! V\u00e9rifiez que la puce cible utilise bien du 3,3 V avant de la connecter au Raspberry Pi ! Connectez GND, SWDCLK, SWDIO et RST sur la puce cible \u00e0 GND, GPIO25, GPIO24 et GPIO18 sur le Raspberry Pi. Mettez ensuite le Raspberry Pi sous tension et alimentez la puce cible.","title":"C\u00e2blez le Raspberry Pi sur la puce cible"},{"location":"Bootloaders.html#executez-openocd","text":"Ex\u00e9cutez OpenOCD : cd ~/openocd/ sudo ~/openocd/install/bin/openocd -f ~/openocd/openocd.cfg Ce qui pr\u00e9c\u00e8de devrait amener OpenOCD \u00e0 \u00e9mettre des messages texte, puis \u00e0 attendre (il ne doit pas imm\u00e9diatement revenir \u00e0 l'invite du shell). Si OpenOCD se ferme tout seul ou s'il continue \u00e0 \u00e9mettre des messages texte, v\u00e9rifiez \u00e0 nouveau le c\u00e2blage. Une fois OpenOCD en cours d'ex\u00e9cution et stable, on peut lui envoyer des commandes via telnet. Ouvrez une autre session SSH et ex\u00e9cutez ce qui suit : telnet 127.0.0.1 4444 (Vous pouvez quitter telnet en appuyant sur ctrl+] puis en ex\u00e9cutant la commande \"quit\".)","title":"Ex\u00e9cutez OpenOCD"},{"location":"Bootloaders.html#openocd-et-gdb","text":"Il est possible d'utiliser OpenOCD avec gdb pour d\u00e9boguer Klipper. Les commandes suivantes supposent que l'on ex\u00e9cute gdb sur une machine de bureau. Ajoutez ce qui suit au fichier de configuration OpenOCD : bindto 0.0.0.0 gdb_port 44444 Red\u00e9marrez OpenOCD sur le Raspberry Pi, puis ex\u00e9cutez la commande Unix suivante sur la machine de bureau : cd /path/to/klipper/ gdb out/klipper.elf Dans gdb, ex\u00e9cutez : target remote octopi:44444 (Remplacez \"octopi\" par le nom d'h\u00f4te du Raspberry Pi.) Une fois que gdb est en cours d'ex\u00e9cution, il est possible de d\u00e9finir des points d'arr\u00eat et d'inspecter les registres.","title":"OpenOCD et gdb"},{"location":"CANBUS.html","text":"CANBUS \u00b6 Ce document d\u00e9crit la prise en charge du CAN bus de Klipper. Mat\u00e9riel de l'appareil \u00b6 Klipper ne prend actuellement en charge CAN que sur les puces stm32, same5x et rp2040. De plus, la puce du microcontr\u00f4leur doit se trouver sur une carte dot\u00e9e d'un \u00e9metteur-r\u00e9cepteur CAN. Pour compiler le firmware de votre mat\u00e9riel canbus, ex\u00e9cutez make menuconfig et s\u00e9lectionnez \u00ab CAN bus \u00bb comme interface de communication. Enfin, compilez le code du microcontr\u00f4leur et flashez-le sur la carte cible. Mat\u00e9riel de l'h\u00f4te \u00b6 Pour utiliser un bus CAN, il est n\u00e9cessaire d'avoir un adaptateur h\u00f4te. Il existe actuellement deux solutions : Utilisez une Carte fille Waveshare Raspberry Pi CAN ou l'un de ses nombreux clones. Utilisez un adaptateur USB CAN (par exemple https://hacker-gadgets.com/product/cantact-usb-can-adapter/ ). Il existe de nombreux adaptateurs USB vers CAN diff\u00e9rents - lorsque vous en choisissez un, nous vous recommandons de v\u00e9rifier qu'il peut ex\u00e9cuter le micrologiciel Candlelight . (Malheureusement, nous avons constat\u00e9 que certains adaptateurs USB ex\u00e9cutent un micrologiciel d\u00e9fectueux et sont bloqu\u00e9s, v\u00e9rifiez avant d'acheter.) Il faut aussi configurer le syst\u00e8me d'exploitation h\u00f4te pour utiliser l'adaptateur. Cela se fait g\u00e9n\u00e9ralement en cr\u00e9ant un nouveau fichier nomm\u00e9 /etc/network/interfaces.d/can0 avec le contenu suivant : auto can0 iface can0 can static bitrate 500000 up ifconfig $IFACE txqueuelen 128 Notez que la \"Carte Fille Raspberry Pi CAN hat\" n\u00e9cessite \u00e9galement modifications de config.txt . R\u00e9sistances de terminaison \u00b6 Un bus CAN doit avoir deux r\u00e9sistances de 120 ohms entre les fils CANH et CANL. Id\u00e9alement, une r\u00e9sistance situ\u00e9e \u00e0 chaque extr\u00e9mit\u00e9 du bus. Notez que certains appareils ont une r\u00e9sistance int\u00e9gr\u00e9e de 120 ohms (par exemple, le \"Waveshare Raspberry Pi CAN hat\" a une r\u00e9sistance soud\u00e9e qui ne peut pas \u00eatre facilement retir\u00e9e). Certains appareils n'incluent pas de r\u00e9sistance du tout. D'autres appareils ont un m\u00e9canisme pour s\u00e9lectionner la r\u00e9sistance (g\u00e9n\u00e9ralement en connectant un ou plusieurs \"cavalier\"). V\u00e9rifiez les sch\u00e9mas de tous les appareils sur le bus CAN pour v\u00e9rifier qu'il y a deux et seulement deux r\u00e9sistances de 120 ohms sur le bus. Pour tester que les r\u00e9sistances sont correctes, on peut couper l'alimentation de l'imprimante et utiliser un multim\u00e8tre pour v\u00e9rifier la r\u00e9sistance entre les fils CANH et CANL - la r\u00e9sistance doit \u00eatre d'environ 60 ohms sur un bus CAN correctement c\u00e2bl\u00e9. Trouver le canbus_uuid pour les nouveaux microcontr\u00f4leurs \u00b6 Chaque microcontr\u00f4leur sur le bus CAN se voit attribuer un identifiant unique bas\u00e9 sur un identifiant de puce cod\u00e9 en usine dans chaque microcontr\u00f4leur. Pour trouver les identifiant canbus des microcontr\u00f4leurs, assurez-vous que le mat\u00e9riel est correctement aliment\u00e9 et c\u00e2bl\u00e9, puis ex\u00e9cutez : ~/klippy-env/bin/python ~/klipper/scripts/canbus_query.py can0 Si des p\u00e9riph\u00e9riques CAN non initialis\u00e9s sont d\u00e9tect\u00e9s, la commande ci-dessus remontera des lignes comme celles-ci : Found canbus_uuid=11aa22bb33cc, Application: Klipper Chaque appareil aura un identifiant unique. Dans l'exemple ci-dessus, 11aa22bb33cc est le \"canbus_uuid\" du microcontr\u00f4leur. Notez que l'outil canbus_query.py ne signalera que les appareils non initialis\u00e9s - si Klipper (ou un outil similaire) configure l'appareil, il n'appara\u00eetra plus dans la liste. Configuration de Klipper \u00b6 Mettez \u00e0 jour la configuration de Klipper configuration mcu afin d'utiliser le bus CAN pour communiquer avec l'appareil - par exemple : [mcu my_can_mcu] canbus_uuid: 11aa22bb33cc Mode pont USB vers bus CAN \u00b6 Certains microcontr\u00f4leurs prennent en charge la s\u00e9lection du mode \"pont USB vers bus CAN\" pendant \"make menuconfig\". Ce mode peut permettre d'utiliser un microcontr\u00f4leur \u00e0 la fois comme \"adaptateur de bus USB vers CAN\" et comme n\u0153ud Klipper. Lorsque Klipper utilise ce mode, le microcontr\u00f4leur appara\u00eet comme un \"adaptateur de bus USB CAN\" sous Linux. Le \"Klipper bridge mcu\" lui-m\u00eame appara\u00eetra comme s'il se trouvait sur ce bus CAN - il peut \u00eatre identifi\u00e9 via canbus_query.py et configur\u00e9 comme les autres n\u0153uds Klipper du bus CAN. Il appara\u00eetra \u00e0 c\u00f4t\u00e9 d'autres appareils qui sont en fait sur le bus CAN. Quelques remarques importantes lors de l'utilisation de ce mode : Le \"bridge mcu\" n'est pas r\u00e9ellement sur le bus CAN. Les messages entrants et sortants ne consomment pas de bande passante sur le bus CAN. Le mcu ne peut pas \u00eatre vu par les autres adaptateurs qui sont sur le bus CAN. Il est n\u00e9cessaire de configurer l'interface can0 (ou similaire) sous Linux afin de communiquer avec le bus. Cependant, la vitesse du bus CAN Linux et les options de synchronisation des bits du bus CAN sont ignor\u00e9es par Klipper. Actuellement, la fr\u00e9quence du bus CAN est sp\u00e9cifi\u00e9e lors de \"make menuconfig\" et la vitesse du bus sp\u00e9cifi\u00e9e dans Linux est ignor\u00e9e. Chaque fois que le \"bridge mcu\" est r\u00e9initialis\u00e9, Linux d\u00e9sactive l'interface can0 correspondante. Pour assurer une bonne gestion des commandes FIRMWARE_RESTART et RESTART, il est recommand\u00e9 de remplacer auto par allow-hotplug dans le fichier /etc/network/interfaces.d/can0 dossier. Par exemple\u202f: allow-hotplug can0 iface can0 can static bitrate 500000 up ifconfig $IFACE txqueuelen 128","title":"CANBUS"},{"location":"CANBUS.html#canbus","text":"Ce document d\u00e9crit la prise en charge du CAN bus de Klipper.","title":"CANBUS"},{"location":"CANBUS.html#materiel-de-lappareil","text":"Klipper ne prend actuellement en charge CAN que sur les puces stm32, same5x et rp2040. De plus, la puce du microcontr\u00f4leur doit se trouver sur une carte dot\u00e9e d'un \u00e9metteur-r\u00e9cepteur CAN. Pour compiler le firmware de votre mat\u00e9riel canbus, ex\u00e9cutez make menuconfig et s\u00e9lectionnez \u00ab CAN bus \u00bb comme interface de communication. Enfin, compilez le code du microcontr\u00f4leur et flashez-le sur la carte cible.","title":"Mat\u00e9riel de l'appareil"},{"location":"CANBUS.html#materiel-de-lhote","text":"Pour utiliser un bus CAN, il est n\u00e9cessaire d'avoir un adaptateur h\u00f4te. Il existe actuellement deux solutions : Utilisez une Carte fille Waveshare Raspberry Pi CAN ou l'un de ses nombreux clones. Utilisez un adaptateur USB CAN (par exemple https://hacker-gadgets.com/product/cantact-usb-can-adapter/ ). Il existe de nombreux adaptateurs USB vers CAN diff\u00e9rents - lorsque vous en choisissez un, nous vous recommandons de v\u00e9rifier qu'il peut ex\u00e9cuter le micrologiciel Candlelight . (Malheureusement, nous avons constat\u00e9 que certains adaptateurs USB ex\u00e9cutent un micrologiciel d\u00e9fectueux et sont bloqu\u00e9s, v\u00e9rifiez avant d'acheter.) Il faut aussi configurer le syst\u00e8me d'exploitation h\u00f4te pour utiliser l'adaptateur. Cela se fait g\u00e9n\u00e9ralement en cr\u00e9ant un nouveau fichier nomm\u00e9 /etc/network/interfaces.d/can0 avec le contenu suivant : auto can0 iface can0 can static bitrate 500000 up ifconfig $IFACE txqueuelen 128 Notez que la \"Carte Fille Raspberry Pi CAN hat\" n\u00e9cessite \u00e9galement modifications de config.txt .","title":"Mat\u00e9riel de l'h\u00f4te"},{"location":"CANBUS.html#resistances-de-terminaison","text":"Un bus CAN doit avoir deux r\u00e9sistances de 120 ohms entre les fils CANH et CANL. Id\u00e9alement, une r\u00e9sistance situ\u00e9e \u00e0 chaque extr\u00e9mit\u00e9 du bus. Notez que certains appareils ont une r\u00e9sistance int\u00e9gr\u00e9e de 120 ohms (par exemple, le \"Waveshare Raspberry Pi CAN hat\" a une r\u00e9sistance soud\u00e9e qui ne peut pas \u00eatre facilement retir\u00e9e). Certains appareils n'incluent pas de r\u00e9sistance du tout. D'autres appareils ont un m\u00e9canisme pour s\u00e9lectionner la r\u00e9sistance (g\u00e9n\u00e9ralement en connectant un ou plusieurs \"cavalier\"). V\u00e9rifiez les sch\u00e9mas de tous les appareils sur le bus CAN pour v\u00e9rifier qu'il y a deux et seulement deux r\u00e9sistances de 120 ohms sur le bus. Pour tester que les r\u00e9sistances sont correctes, on peut couper l'alimentation de l'imprimante et utiliser un multim\u00e8tre pour v\u00e9rifier la r\u00e9sistance entre les fils CANH et CANL - la r\u00e9sistance doit \u00eatre d'environ 60 ohms sur un bus CAN correctement c\u00e2bl\u00e9.","title":"R\u00e9sistances de terminaison"},{"location":"CANBUS.html#trouver-le-canbus_uuid-pour-les-nouveaux-microcontroleurs","text":"Chaque microcontr\u00f4leur sur le bus CAN se voit attribuer un identifiant unique bas\u00e9 sur un identifiant de puce cod\u00e9 en usine dans chaque microcontr\u00f4leur. Pour trouver les identifiant canbus des microcontr\u00f4leurs, assurez-vous que le mat\u00e9riel est correctement aliment\u00e9 et c\u00e2bl\u00e9, puis ex\u00e9cutez : ~/klippy-env/bin/python ~/klipper/scripts/canbus_query.py can0 Si des p\u00e9riph\u00e9riques CAN non initialis\u00e9s sont d\u00e9tect\u00e9s, la commande ci-dessus remontera des lignes comme celles-ci : Found canbus_uuid=11aa22bb33cc, Application: Klipper Chaque appareil aura un identifiant unique. Dans l'exemple ci-dessus, 11aa22bb33cc est le \"canbus_uuid\" du microcontr\u00f4leur. Notez que l'outil canbus_query.py ne signalera que les appareils non initialis\u00e9s - si Klipper (ou un outil similaire) configure l'appareil, il n'appara\u00eetra plus dans la liste.","title":"Trouver le canbus_uuid pour les nouveaux microcontr\u00f4leurs"},{"location":"CANBUS.html#configuration-de-klipper","text":"Mettez \u00e0 jour la configuration de Klipper configuration mcu afin d'utiliser le bus CAN pour communiquer avec l'appareil - par exemple : [mcu my_can_mcu] canbus_uuid: 11aa22bb33cc","title":"Configuration de Klipper"},{"location":"CANBUS.html#mode-pont-usb-vers-bus-can","text":"Certains microcontr\u00f4leurs prennent en charge la s\u00e9lection du mode \"pont USB vers bus CAN\" pendant \"make menuconfig\". Ce mode peut permettre d'utiliser un microcontr\u00f4leur \u00e0 la fois comme \"adaptateur de bus USB vers CAN\" et comme n\u0153ud Klipper. Lorsque Klipper utilise ce mode, le microcontr\u00f4leur appara\u00eet comme un \"adaptateur de bus USB CAN\" sous Linux. Le \"Klipper bridge mcu\" lui-m\u00eame appara\u00eetra comme s'il se trouvait sur ce bus CAN - il peut \u00eatre identifi\u00e9 via canbus_query.py et configur\u00e9 comme les autres n\u0153uds Klipper du bus CAN. Il appara\u00eetra \u00e0 c\u00f4t\u00e9 d'autres appareils qui sont en fait sur le bus CAN. Quelques remarques importantes lors de l'utilisation de ce mode : Le \"bridge mcu\" n'est pas r\u00e9ellement sur le bus CAN. Les messages entrants et sortants ne consomment pas de bande passante sur le bus CAN. Le mcu ne peut pas \u00eatre vu par les autres adaptateurs qui sont sur le bus CAN. Il est n\u00e9cessaire de configurer l'interface can0 (ou similaire) sous Linux afin de communiquer avec le bus. Cependant, la vitesse du bus CAN Linux et les options de synchronisation des bits du bus CAN sont ignor\u00e9es par Klipper. Actuellement, la fr\u00e9quence du bus CAN est sp\u00e9cifi\u00e9e lors de \"make menuconfig\" et la vitesse du bus sp\u00e9cifi\u00e9e dans Linux est ignor\u00e9e. Chaque fois que le \"bridge mcu\" est r\u00e9initialis\u00e9, Linux d\u00e9sactive l'interface can0 correspondante. Pour assurer une bonne gestion des commandes FIRMWARE_RESTART et RESTART, il est recommand\u00e9 de remplacer auto par allow-hotplug dans le fichier /etc/network/interfaces.d/can0 dossier. Par exemple\u202f: allow-hotplug can0 iface can0 can static bitrate 500000 up ifconfig $IFACE txqueuelen 128","title":"Mode pont USB vers bus CAN"},{"location":"CANBUS_protocol.html","text":"Protocole CANBUS \u00b6 Ce document d\u00e9crit le protocole qu'utilise Klipper pour communiquer sur la couche CAN bus . Voir pour plus d'informations sur la configuration de canbus avec Klipper. Assignation de l'identifiant du micro-contr\u00f4leur \u00b6 Klipper utilise uniquement les paquets CAN bus 2.0A de taille standard, limit\u00e9s \u00e0 8 octets de donn\u00e9es et \u00e0 un identificateur de bus CAN de 11 bits. Afin de permettre des communications efficaces, un identifiant ( canbus_nodeid ) de 1 octet est affect\u00e9 \u00e0 chaque microcontr\u00f4leur pour g\u00e9rer les commandes et r\u00e9ponses Klipper. Les commandes Klipper \u00e9mises du microcontr\u00f4leur vers l'h\u00f4te utilisent l'id du bus CAN canbus_nodeid * 2 + 256 , tandis que les messages de retour du microcontr\u00f4leur vers l'h\u00f4te utilisent canbus_nodeid' *2 + 256 + 1 . Chaque microcontr\u00f4leur poss\u00e8de un identifiant unique attribu\u00e9 en usine qui est utilis\u00e9 lors de l'attribution de l'id. Cet identifiant pout d\u00e9passer la taille d'un paquet CAN, un fonction de hash est utilis\u00e9e pour g\u00e9nerer un id unique de 6 octets ( canbus_uuid ) \u00e0 partir de l'id 'usine'. Messages 'Admin' \u00b6 Les messages 'administratifs' sont utilis\u00e9s pour l'attribution des id. Ces messages envoy\u00e9s de l'h\u00f4te vers le microcontr\u00f4leur utilisent l'id 0x3f0\u0300 et les messages envoy\u00e9s du microcontr\u00f4leur vers l'h\u00f4te utilisent l'id 0x3f1 . Tous les microcontr\u00f4leurs \u00e9coutent les messages en provenance de 0x3f0 . Cet id peut \u00eatre consid\u00e9r\u00e9 comme une adresse de multidiffusion. Message CMD_QUERY_UNASSIGNED \u00b6 Cette commande interroge tous les microcontr\u00f4leurs pour lesquels aucun canbus_nodeid n'a \u00e9t\u00e9 assign\u00e9. Ces microcontr\u00f4leurs non assign\u00e9s, retournent un message RESP_NEED_NODEID. Le format du message CMD_QUERY_UNASSIGNED est : <1-octet pour le message_id = 0x00> Message CMD_SET_KLIPPER_NODEID \u00b6 Cette commande attribue un canbus_nodeid \u00e0 partir du canbus_uuid du microcontr\u00f4leur. Le format du message CMD_SET_KLIPPER_NODEID est : <1 octet pour le message_id = 0x01><6 octets pour le canbus_uuid><1 octet pour le canbus_nodeid> Message RESP_NEED_NODEID \u00b6 Le format du message RESP_NODE_NODEID est : <1 octet pour le message_id = 0x20><6 octets pour le canbus_uuid><1 octet pour le set_klipper_nodeid=0x01> Paquets de donn\u00e9es \u00b6 Un microcont\u00f4leur ayant re\u00e7u un nodeid par la commande CMD_SET_KLIPPER_NODEID peut envoyer et recevoir des paquets de donn\u00e9es. Les donn\u00e9es des paquets des messages utilisant l'identifiant de r\u00e9ception du bus CAN du n\u0153ud ( canbus_nodeid * 2 + 256 )' sont simplement ajout\u00e9s \u00e0 la fin du tampon et lorsque un mcu protocol message complet est trouv\u00e9 son contenu est analys\u00e9 et trait\u00e9. Les donn\u00e9es sont trait\u00e9es comme un flux d'octets - il n'est pas n\u00e9cessaire que le d\u00e9but d'un bloc de message Klipper soit align\u00e9 avec le d\u00e9but d'un paquet CAN bus. De la m\u00eame mani\u00e8re, les r\u00e9ponses sont renvoy\u00e9es du micrcontr\u00f4leur \u00e0 l'h\u00f4te en copiant les donn\u00e9es du message dans un ou plusieurs paquets avec l'identifiant canbus ( canbus_nodeid * 2 + 256 + 1 ).","title":"Protocole CANBUS"},{"location":"CANBUS_protocol.html#protocole-canbus","text":"Ce document d\u00e9crit le protocole qu'utilise Klipper pour communiquer sur la couche CAN bus . Voir pour plus d'informations sur la configuration de canbus avec Klipper.","title":"Protocole CANBUS"},{"location":"CANBUS_protocol.html#assignation-de-lidentifiant-du-micro-controleur","text":"Klipper utilise uniquement les paquets CAN bus 2.0A de taille standard, limit\u00e9s \u00e0 8 octets de donn\u00e9es et \u00e0 un identificateur de bus CAN de 11 bits. Afin de permettre des communications efficaces, un identifiant ( canbus_nodeid ) de 1 octet est affect\u00e9 \u00e0 chaque microcontr\u00f4leur pour g\u00e9rer les commandes et r\u00e9ponses Klipper. Les commandes Klipper \u00e9mises du microcontr\u00f4leur vers l'h\u00f4te utilisent l'id du bus CAN canbus_nodeid * 2 + 256 , tandis que les messages de retour du microcontr\u00f4leur vers l'h\u00f4te utilisent canbus_nodeid' *2 + 256 + 1 . Chaque microcontr\u00f4leur poss\u00e8de un identifiant unique attribu\u00e9 en usine qui est utilis\u00e9 lors de l'attribution de l'id. Cet identifiant pout d\u00e9passer la taille d'un paquet CAN, un fonction de hash est utilis\u00e9e pour g\u00e9nerer un id unique de 6 octets ( canbus_uuid ) \u00e0 partir de l'id 'usine'.","title":"Assignation de l'identifiant du micro-contr\u00f4leur"},{"location":"CANBUS_protocol.html#messages-admin","text":"Les messages 'administratifs' sont utilis\u00e9s pour l'attribution des id. Ces messages envoy\u00e9s de l'h\u00f4te vers le microcontr\u00f4leur utilisent l'id 0x3f0\u0300 et les messages envoy\u00e9s du microcontr\u00f4leur vers l'h\u00f4te utilisent l'id 0x3f1 . Tous les microcontr\u00f4leurs \u00e9coutent les messages en provenance de 0x3f0 . Cet id peut \u00eatre consid\u00e9r\u00e9 comme une adresse de multidiffusion.","title":"Messages 'Admin'"},{"location":"CANBUS_protocol.html#message-cmd_query_unassigned","text":"Cette commande interroge tous les microcontr\u00f4leurs pour lesquels aucun canbus_nodeid n'a \u00e9t\u00e9 assign\u00e9. Ces microcontr\u00f4leurs non assign\u00e9s, retournent un message RESP_NEED_NODEID. Le format du message CMD_QUERY_UNASSIGNED est : <1-octet pour le message_id = 0x00>","title":"Message CMD_QUERY_UNASSIGNED"},{"location":"CANBUS_protocol.html#message-cmd_set_klipper_nodeid","text":"Cette commande attribue un canbus_nodeid \u00e0 partir du canbus_uuid du microcontr\u00f4leur. Le format du message CMD_SET_KLIPPER_NODEID est : <1 octet pour le message_id = 0x01><6 octets pour le canbus_uuid><1 octet pour le canbus_nodeid>","title":"Message CMD_SET_KLIPPER_NODEID"},{"location":"CANBUS_protocol.html#message-resp_need_nodeid","text":"Le format du message RESP_NODE_NODEID est : <1 octet pour le message_id = 0x20><6 octets pour le canbus_uuid><1 octet pour le set_klipper_nodeid=0x01>","title":"Message RESP_NEED_NODEID"},{"location":"CANBUS_protocol.html#paquets-de-donnees","text":"Un microcont\u00f4leur ayant re\u00e7u un nodeid par la commande CMD_SET_KLIPPER_NODEID peut envoyer et recevoir des paquets de donn\u00e9es. Les donn\u00e9es des paquets des messages utilisant l'identifiant de r\u00e9ception du bus CAN du n\u0153ud ( canbus_nodeid * 2 + 256 )' sont simplement ajout\u00e9s \u00e0 la fin du tampon et lorsque un mcu protocol message complet est trouv\u00e9 son contenu est analys\u00e9 et trait\u00e9. Les donn\u00e9es sont trait\u00e9es comme un flux d'octets - il n'est pas n\u00e9cessaire que le d\u00e9but d'un bloc de message Klipper soit align\u00e9 avec le d\u00e9but d'un paquet CAN bus. De la m\u00eame mani\u00e8re, les r\u00e9ponses sont renvoy\u00e9es du micrcontr\u00f4leur \u00e0 l'h\u00f4te en copiant les donn\u00e9es du message dans un ou plusieurs paquets avec l'identifiant canbus ( canbus_nodeid * 2 + 256 + 1 ).","title":"Paquets de donn\u00e9es"},{"location":"CONTRIBUTING.html","text":"Contribuer \u00e0 Klipper \u00b6 Merci de contribuer \u00e0 Klipper ! Ce document d\u00e9crit la proc\u00e9dure \u00e0 suivre pour apporter des modifications \u00e0 Klipper. Veuillez consulter la page de contact pour obtenir des informations sur le signalement d'un probl\u00e8me ou pour obtenir des d\u00e9tails sur la mani\u00e8re de contacter les d\u00e9veloppeurs. Aper\u00e7u de la proc\u00e9dure de contribution \u00b6 Les contributions \u00e0 Klipper suivent g\u00e9n\u00e9ralement un processus de haut niveau : Un soumissionnaire commence par cr\u00e9er une GitHub Pull Request lorsqu'une soumission est pr\u00eate \u00e0 \u00eatre d\u00e9ploy\u00e9e \u00e0 grande \u00e9chelle. Lorsqu'un relecteur est disponible pour r\u00e9viser la soumission, il s'attribuera la Pull Request sur GitHub. L'objectif de la r\u00e9vision est de rechercher les d\u00e9fauts et de v\u00e9rifier que la soumission suit les directives document\u00e9es. Apr\u00e8s une r\u00e9vision r\u00e9ussie, le relecteur \"approuve la r\u00e9vision\" sur GitHub et un mainteneur commet la modification dans la branche principale de Klipper. Lorsque vous travaillez sur des am\u00e9liorations, pensez \u00e0 lancer (ou \u00e0 contribuer \u00e0) un sujet sur Klipper Discourse . Une discussion continue sur le forum peut am\u00e9liorer la visibilit\u00e9 du travail de d\u00e9veloppement et peut attirer d'autres personnes int\u00e9ress\u00e9es \u00e0 tester le nouveau travail. A quoi s'attendre lors d'une r\u00e9vision \u00b6 Les contributions \u00e0 Klipper sont examin\u00e9es avant d'\u00eatre fusionn\u00e9es. L'objectif principal du processus de r\u00e9vision est de v\u00e9rifier l'absence de d\u00e9fauts et de s'assurer que la soumission respecte les directives sp\u00e9cifi\u00e9es dans la documentation de Klipper. Il est entendu qu'il existe de nombreuses fa\u00e7ons d'accomplir une t\u00e2che ; l'objectif de la r\u00e9vision n'est pas de discuter de la \"meilleure\" mise en \u0153uvre. Dans la mesure du possible, il est pr\u00e9f\u00e9rable que les discussions de la r\u00e9vision soient ax\u00e9es sur les faits et les mesures. La majorit\u00e9 des soumissions donneront lieu \u00e0 un retour d'information. Soyez pr\u00eat \u00e0 obtenir un retour, \u00e0 fournir des d\u00e9tails suppl\u00e9mentaires et \u00e0 mettre \u00e0 jour la soumission si n\u00e9cessaire. Ce que le relecteur recherche le plus souvent : La soumission est-elle exempte de d\u00e9fauts et est-elle pr\u00eate \u00e0 \u00eatre d\u00e9ploy\u00e9e \u00e0 grande \u00e9chelle ?Les soumissionnaires sont cens\u00e9s tester leurs modifications avant de les soumettre. Les relecteurs recherchent les erreurs, mais ne testent pas, en g\u00e9n\u00e9ral, les soumissions. Une soumission accept\u00e9e est souvent d\u00e9ploy\u00e9e sur des milliers d'imprimantes dans les quelques semaines qui suivent son acceptation. La qualit\u00e9 des soumissions est donc consid\u00e9r\u00e9e comme une priorit\u00e9. Le d\u00e9p\u00f4t GitHub principal de Klipper3d/klipper n'accepte pas les travaux exp\u00e9rimentaux. Les auteurs doivent effectuer les exp\u00e9rimentations, le d\u00e9bogage et les tests dans leurs propres d\u00e9p\u00f4ts. Le serveur Klipper Discourse est un bon endroit pour faire conna\u00eetre les nouveaux travaux et trouver des utilisateurs d\u00e9sireux de fournir des commentaires concrets. Les soumissions doivent r\u00e9ussir tous les tests de r\u00e9gression . Lorsqu'ils corrigent un d\u00e9faut dans le code, les soumissionnaires doivent avoir une compr\u00e9hension g\u00e9n\u00e9rale de la cause fondamentale de ce d\u00e9faut, et la correction doit cibler cette seule cause fondamentale. Les soumissions de code ne doivent pas contenir de code de d\u00e9bogage excessif, d'options de d\u00e9bogage, ni d'enregistrement de d\u00e9bogage \u00e0 l'ex\u00e9cution. Les commentaires dans les soumissions de code doivent se concentrer sur l'am\u00e9lioration de la maintenance du code. Les soumissions ne doivent pas contenir de \"code comment\u00e9\" ni de commentaires excessifs d\u00e9crivant des impl\u00e9mentations pass\u00e9es. Il ne doit pas y avoir de commentaires excessifs de type \"todo\". Les mises \u00e0 jour de la documentation ne doivent pas indiquer qu'il s'agit d'un \"travail en cours\". La demande apporte-t-elle un avantage \"\u00e0 fort impact\" \u00e0 des utilisateurs du monde r\u00e9el effectuant des t\u00e2ches du monde r\u00e9el ?Les relecteurs doivent identifier, au moins dans leur propre esprit, \u00e0 peu pr\u00e8s \"qui est le public cible\", une \u00e9chelle approximative de \"la taille de ce public\", le \"b\u00e9n\u00e9fice\" qu'ils obtiendront, comment le \"b\u00e9n\u00e9fice est mesur\u00e9\", et les \"r\u00e9sultats de ces tests de mesure\". Dans la plupart des cas, ces \u00e9l\u00e9ments sont \u00e9vidents pour l'auteur et l'examinateur, et ne sont pas explicitement mentionn\u00e9s lors d'un examen. Les soumissions \u00e0 la branche principale de Klipper doivent avoir un public cible important. En r\u00e8gle g\u00e9n\u00e9rale, les soumissions doivent cibler une base d'au moins 100 utilisateurs du monde r\u00e9el. Si un relecteur demande des d\u00e9tails sur les \"avantages\" d'une proposition, ne consid\u00e9rez pas cela comme une critique. \u00catre capable de comprendre les avantages concrets d'un changement est une partie naturelle d'un examen. Lorsque l'on discute des avantages, il est pr\u00e9f\u00e9rable de parler de \"faits et de mesures\". En g\u00e9n\u00e9ral, les \u00e9valuateurs ne cherchent pas des r\u00e9ponses du type \"quelqu'un pourrait trouver l'option X utile\", ni des r\u00e9ponses du type \"cette soumission ajoute une fonctionnalit\u00e9 que le micrologiciel X met en \u0153uvre\". Au lieu de cela, il est g\u00e9n\u00e9ralement pr\u00e9f\u00e9rable de discuter des d\u00e9tails sur la fa\u00e7on dont l'am\u00e9lioration de la qualit\u00e9 a \u00e9t\u00e9 mesur\u00e9e et quels \u00e9taient les r\u00e9sultats de ces mesures - par exemple, \"les tests sur les imprimantes Acme X1000 montrent des coins am\u00e9lior\u00e9s comme on le voit sur l'image ...\", ou par exemple \"le temps d'impression de l'objet X du monde r\u00e9el sur une imprimante Foomatic X900 est pass\u00e9 de 4 heures \u00e0 3,5 heures\". Il est entendu que les tests de ce type peuvent prendre beaucoup de temps et d'efforts. Certaines des fonctionnalit\u00e9s les plus remarquables de Klipper ont n\u00e9cessit\u00e9 des mois de discussion, de re-travail, de tests et de documentation avant d'\u00eatre int\u00e9gr\u00e9es dans la branche principale. Tous les nouveaux modules, options de configuration, commandes, param\u00e8tres de commande et documents doivent avoir un \"impact \u00e9lev\u00e9\". Nous ne voulons pas imposer aux utilisateurs des options qu'ils ne peuvent raisonnablement pas configurer, ni des options qui n'apportent aucun avantage notable. Un relecteur peut demander des \u00e9claircissements sur la mani\u00e8re dont un utilisateur doit configurer une option - une r\u00e9ponse id\u00e9ale contiendra des d\u00e9tails sur le processus - par exemple, \"les utilisateurs du MegaX500 doivent r\u00e9gler l'option X sur 99,3 tandis que les utilisateurs du Elite100Y doivent calibrer l'option X en utilisant la proc\u00e9dure ...\". Si le but d'une option est de rendre le code plus modulaire, il est pr\u00e9f\u00e9rable d'utiliser des constantes de code plut\u00f4t que des options de configuration pour l'utilisateur. Les nouveaux modules, les nouvelles options et les nouveaux param\u00e8tres ne doivent pas offrir des fonctionnalit\u00e9s similaires \u00e0 celles des modules existants - si les diff\u00e9rences sont arbitraires, il est pr\u00e9f\u00e9rable d'utiliser le syst\u00e8me existant ou de remanier le code existant. Le droit d'auteur de la soumission est-il clair, non gracieux et compatible ?Les nouveaux fichiers C et Python doivent comporter une d\u00e9claration de copyright sans ambigu\u00eft\u00e9. Voir les fichiers existants pour le format pr\u00e9f\u00e9r\u00e9. Il est d\u00e9conseill\u00e9 de d\u00e9clarer un droit d'auteur sur un fichier existant lorsque l'on apporte des modifications mineures \u00e0 ce fichier. Le code provenant de sources tierces doit \u00eatre compatible avec la licence Klipper (GNU GPLv3). Les ajouts importants de code tiers doivent \u00eatre ajout\u00e9s au r\u00e9pertoire lib/ (et suivre le format d\u00e9crit dans lib/README ). Les soumissionnaires doivent fournir une ligne Signed-off-by en utilisant leur nom r\u00e9el complet. Elle indique que le soumissionnaire est d'accord avec le certificat d'origine du d\u00e9veloppeur . La soumission suit-elle les directives sp\u00e9cifi\u00e9es dans la documentation de Klipper ?En particulier, le code doit suivre les directives de et les fichiers de configuration doivent suivre les directives de . La documentation de Klipper est-elle mise \u00e0 jour pour refl\u00e9ter les nouveaux changements ?Au minimum, la documentation de r\u00e9f\u00e9rence doit \u00eatre mise \u00e0 jour avec les modifications correspondantes du code : Toutes les commandes et tous les param\u00e8tres de commande doivent \u00eatre document\u00e9s dans . Tous les modules destin\u00e9s aux utilisateurs et leurs param\u00e8tres de configuration doivent \u00eatre document\u00e9s dans . Toutes les \"variables d'\u00e9tat\" export\u00e9es doivent \u00eatre document\u00e9es dans . Tous les nouveaux \"webhooks\" et leurs param\u00e8tres doivent \u00eatre document\u00e9s dans . Toute modification qui apporte un changement non r\u00e9trocompatible \u00e0 une commande ou \u00e0 un param\u00e8tre du fichier de configuration doit \u00eatre document\u00e9e dans . Les nouveaux documents doivent \u00eatre ajout\u00e9s \u00e0 et \u00eatre ajout\u00e9s \u00e0 l'index du site web docs/_klipper3d/mkdocs.yml . Les commits sont-ils bien form\u00e9s, abordent-ils un seul sujet par commit, et sont-ils ind\u00e9pendants ?Les messages de validation doivent suivre le format pr\u00e9f\u00e9r\u00e9 . Les commits ne doivent pas avoir de conflit de fusion. Les nouveaux ajouts \u00e0 la branche ma\u00eetresse de Klipper sont toujours effectu\u00e9s via un \"rebase\" ou un \"squash and rebase\". Il n'est g\u00e9n\u00e9ralement pas n\u00e9cessaire pour les soumissionnaires de fusionner \u00e0 nouveau leur soumission \u00e0 chaque mise \u00e0 jour du d\u00e9p\u00f4t ma\u00eetre de Klipper. Cependant, s'il y a un conflit de fusion, il est recommand\u00e9 aux soumissionnaires d'utiliser git rebase pour r\u00e9soudre le conflit. Chaque validation doit porter sur un seul changement de haut niveau. Les changements importants doivent \u00eatre d\u00e9compos\u00e9s en plusieurs commits ind\u00e9pendants. Chaque livraison doit se suffire \u00e0 elle-m\u00eame pour que des outils comme git bisect et git revert fonctionnent de mani\u00e8re fiable. Les modifications des espaces blancs ne doivent pas \u00eatre m\u00e9lang\u00e9es avec les modifications fonctionnelles. En g\u00e9n\u00e9ral, les changements gratuits d'espace blanc ne sont pas accept\u00e9s, sauf s'ils proviennent du \"propri\u00e9taire\" \u00e9tabli du code en cours de modification. Klipper ne met pas en \u0153uvre un \"guide de style de codage\" strict, mais les modifications apport\u00e9es au code existant doivent respecter le flux de code de haut niveau, le style d'indentation du code et le format de ce code existant. Les soumissions de nouveaux modules et syst\u00e8mes b\u00e9n\u00e9ficient d'une plus grande souplesse en mati\u00e8re de style de codage, mais il est pr\u00e9f\u00e9rable que ce nouveau code suive un style coh\u00e9rent en interne et respecte g\u00e9n\u00e9ralement les normes de codage en vigueur dans le secteur. L'objectif d'une r\u00e9vision n'est pas de discuter de \"meilleures mises en \u0153uvre\". Cependant, si un relecteur a du mal \u00e0 comprendre l'impl\u00e9mentation d'une soumission, il peut demander des changements pour rendre l'impl\u00e9mentation plus transparente. En particulier, si les relecteurs ne peuvent pas se convaincre qu'une soumission est exempte de d\u00e9fauts, des changements peuvent \u00eatre n\u00e9cessaires. Dans le cadre d'une r\u00e9vision, un r\u00e9viseur peut cr\u00e9er une Pull Request alternative pour un sujet. Cela peut \u00eatre fait pour \u00e9viter un \"va-et-vient\" excessif sur des \u00e9l\u00e9ments de proc\u00e9dure mineurs et ainsi rationaliser le processus de soumission. Cela peut \u00e9galement \u00eatre fait parce que la discussion inspire un r\u00e9viseur \u00e0 construire une impl\u00e9mentation alternative. Ces deux situations sont le r\u00e9sultat normal d'une r\u00e9vision et ne doivent pas \u00eatre consid\u00e9r\u00e9es comme une critique de la soumission originale. Aider \u00e0 la r\u00e9vision \u00b6 Nous appr\u00e9cions l'aide pour les \u00e9valuations ! Il n'est pas n\u00e9cessaire d'\u00eatre un reviewer list\u00e9 pour effectuer une r\u00e9vision. Les auteurs de Pull Requests GitHub sont \u00e9galement encourag\u00e9s \u00e0 r\u00e9viser leurs propres soumissions. Pour faciliter la r\u00e9vision, suivez les \u00e9tapes d\u00e9crites dans \u00e0 quoi s'attendre lors d'une r\u00e9vision pour v\u00e9rifier la soumission. Une fois la r\u00e9vision termin\u00e9e, ajoutez un commentaire \u00e0 la Pull Request GitHub avec vos conclusions. Si la soumission passe la r\u00e9vision, veuillez l'indiquer explicitement dans le commentaire - par exemple quelque chose comme \"J'ai revu cette modification selon les \u00e9tapes du document CONTRIBUTING et tout me semble correct\". Si vous n'avez pas pu effectuer certaines \u00e9tapes de la r\u00e9vision, veuillez indiquer explicitement quelles \u00e9tapes ont \u00e9t\u00e9 r\u00e9vis\u00e9es et quelles \u00e9tapes ne l'ont pas \u00e9t\u00e9 - par exemple quelque chose comme \"Je n'ai pas v\u00e9rifi\u00e9 les d\u00e9fauts du code, mais j'ai revu tout le reste dans le document CONTRIBUTING et tout semble bon\". Nous appr\u00e9cions \u00e9galement les tests des soumissions. Si le code a \u00e9t\u00e9 test\u00e9, veuillez ajouter un commentaire \u00e0 la Pull Request GitHub avec les r\u00e9sultats de votre test - succ\u00e8s ou \u00e9chec. Veuillez indiquer explicitement que le code a \u00e9t\u00e9 test\u00e9 et les r\u00e9sultats - par exemple quelque chose comme \"J'ai test\u00e9 ce code sur mon imprimante Acme900Z avec une impression de vase et les r\u00e9sultats \u00e9taient bons\". R\u00e9viseurs \u00b6 Les \"r\u00e9viseurs\" de Klipper sont : Nom Id GitHub Domaines d'int\u00e9r\u00eat Dmitry Butyugin @dmbutyugin Input shaping, test de r\u00e9sonance, cin\u00e9matiques Eric Callahan @Arksine Nivellement du lit, flashage du MCU Kevin O'Connor @KevinOConnor Syst\u00e8me de mouvement de base, code du microcontr\u00f4leur Paul McGowan @mental405 Fichiers de configuration, documentation Veuillez ne pas envoyer de \"ping\" \u00e0 l'un des \u00e9valuateurs et ne pas leur adresser de soumissions. Tous les \u00e9valuateurs surveillent les forums et les PR, et prennent en charge les \u00e9valuations quand ils en ont le temps. Les \"mainteneurs\" de Klipper sont : Nom Nom GitHub Kevin O'Connor @KevinOConnor Format des messages de commit \u00b6 Chaque livraison doit avoir un message de livraison format\u00e9 de la mani\u00e8re suivante : module : R\u00e9sum\u00e9 en majuscules, court (50 caract\u00e8res ou moins) Texte explicatif plus d\u00e9taill\u00e9, si n\u00e9cessaire. Limitez-le \u00e0 environ 75 caract\u00e8res ou plus. Dans certains contextes, la premi\u00e8re ligne est consid\u00e9r\u00e9e comme l'objet d'un courriel et le reste du texte comme le corps. sujet d'un message \u00e9lectronique et le reste du texte comme le corps du message. La ligne vierge s\u00e9parant le r\u00e9sum\u00e9 du corps est essentielle (\u00e0 moins que vous n'omettiez enti\u00e8rement le corps). le corps enti\u00e8rement) ; des outils comme rebase peuvent \u00eatre confondus si vous ex\u00e9cutez les les deux ensemble. Les autres paragraphes viennent apr\u00e8s les lignes vides.. Sign\u00e9 par : Mon nom <myemail@example.org> Dans l'exemple ci-dessus, module doit \u00eatre le nom d'un fichier ou d'un r\u00e9pertoire dans le r\u00e9f\u00e9rentiel (sans extension de fichier). Par exemple, clocksync : Corriger une faute de frappe dans l'appel pause() au moment de la connexion . Le but de sp\u00e9cifier un nom de module dans le message de livraison est d'aider \u00e0 fournir un contexte pour les commentaires de livraison. Il est important d'avoir une ligne \"Signed-off-by\" sur chaque commit - elle certifie que vous acceptez le certificat d'origine du d\u00e9veloppeur . Cette ligne doit contenir votre vrai nom (d\u00e9sol\u00e9, pas de pseudonymes ou de contributions anonymes) et une adresse \u00e9lectronique valide. Contribuer aux traductions de Klipper \u00b6 Projet de traduction de Klipper est le projet d\u00e9di\u00e9 \u00e0 la traduction de Klipper dans diff\u00e9rentes langues. Weblate h\u00e9berge toutes les cha\u00eenes Gettext pour la traduction et la r\u00e9vision. Les localisations peuvent \u00eatre affich\u00e9es sur klipper3d.org d\u00e8s lors qu'elles satisfont aux exigences suivantes : 75% Couverture totale Tous les titres (H1) sont traduits Une PR (Pull Request) hi\u00e9rarchis\u00e9e de navigation mise \u00e0 jour dans klipper-translations. Afin de r\u00e9duire la frustration li\u00e9e \u00e0 la traduction de termes sp\u00e9cifiques \u00e0 un domaine et de prendre connaissance des traductions en cours, vous pouvez soumettre une PR modifiant le Projet Klipper-translations readme.md . D\u00e8s qu'une traduction est pr\u00eate, la modification correspondante du projet Klipper peut \u00eatre effectu\u00e9e. Si une traduction existe d\u00e9j\u00e0 dans le r\u00e9f\u00e9rentiel Klipper et ne r\u00e9pond plus \u00e0 la liste de contr\u00f4le ci-dessus, elle sera marqu\u00e9e comme obsol\u00e8te apr\u00e8s un mois sans mise \u00e0 jour. Une fois que les conditions sont remplies, vous devez : mettre \u00e0 jour le fichier active_translations du d\u00e9p\u00f4t de klipper-tranlations Facultatif : ajouter un fichier manual-index.md dans le dossier docs\\locals\\<lang> du d\u00e9p\u00f4t klipper-translations pour remplacer l'index.md sp\u00e9cifique \u00e0 la langue (l'index.md g\u00e9n\u00e9r\u00e9 ne s'affiche pas correctement). Probl\u00e8mes connus : Actuellement, il n'existe pas de m\u00e9thode permettant de traduire correctement les images dans la documentation Il est impossible de traduire les titres dans mkdocs.yml.","title":"Contribuer \u00e0 Klipper"},{"location":"CONTRIBUTING.html#contribuer-a-klipper","text":"Merci de contribuer \u00e0 Klipper ! Ce document d\u00e9crit la proc\u00e9dure \u00e0 suivre pour apporter des modifications \u00e0 Klipper. Veuillez consulter la page de contact pour obtenir des informations sur le signalement d'un probl\u00e8me ou pour obtenir des d\u00e9tails sur la mani\u00e8re de contacter les d\u00e9veloppeurs.","title":"Contribuer \u00e0 Klipper"},{"location":"CONTRIBUTING.html#apercu-de-la-procedure-de-contribution","text":"Les contributions \u00e0 Klipper suivent g\u00e9n\u00e9ralement un processus de haut niveau : Un soumissionnaire commence par cr\u00e9er une GitHub Pull Request lorsqu'une soumission est pr\u00eate \u00e0 \u00eatre d\u00e9ploy\u00e9e \u00e0 grande \u00e9chelle. Lorsqu'un relecteur est disponible pour r\u00e9viser la soumission, il s'attribuera la Pull Request sur GitHub. L'objectif de la r\u00e9vision est de rechercher les d\u00e9fauts et de v\u00e9rifier que la soumission suit les directives document\u00e9es. Apr\u00e8s une r\u00e9vision r\u00e9ussie, le relecteur \"approuve la r\u00e9vision\" sur GitHub et un mainteneur commet la modification dans la branche principale de Klipper. Lorsque vous travaillez sur des am\u00e9liorations, pensez \u00e0 lancer (ou \u00e0 contribuer \u00e0) un sujet sur Klipper Discourse . Une discussion continue sur le forum peut am\u00e9liorer la visibilit\u00e9 du travail de d\u00e9veloppement et peut attirer d'autres personnes int\u00e9ress\u00e9es \u00e0 tester le nouveau travail.","title":"Aper\u00e7u de la proc\u00e9dure de contribution"},{"location":"CONTRIBUTING.html#a-quoi-sattendre-lors-dune-revision","text":"Les contributions \u00e0 Klipper sont examin\u00e9es avant d'\u00eatre fusionn\u00e9es. L'objectif principal du processus de r\u00e9vision est de v\u00e9rifier l'absence de d\u00e9fauts et de s'assurer que la soumission respecte les directives sp\u00e9cifi\u00e9es dans la documentation de Klipper. Il est entendu qu'il existe de nombreuses fa\u00e7ons d'accomplir une t\u00e2che ; l'objectif de la r\u00e9vision n'est pas de discuter de la \"meilleure\" mise en \u0153uvre. Dans la mesure du possible, il est pr\u00e9f\u00e9rable que les discussions de la r\u00e9vision soient ax\u00e9es sur les faits et les mesures. La majorit\u00e9 des soumissions donneront lieu \u00e0 un retour d'information. Soyez pr\u00eat \u00e0 obtenir un retour, \u00e0 fournir des d\u00e9tails suppl\u00e9mentaires et \u00e0 mettre \u00e0 jour la soumission si n\u00e9cessaire. Ce que le relecteur recherche le plus souvent : La soumission est-elle exempte de d\u00e9fauts et est-elle pr\u00eate \u00e0 \u00eatre d\u00e9ploy\u00e9e \u00e0 grande \u00e9chelle ?Les soumissionnaires sont cens\u00e9s tester leurs modifications avant de les soumettre. Les relecteurs recherchent les erreurs, mais ne testent pas, en g\u00e9n\u00e9ral, les soumissions. Une soumission accept\u00e9e est souvent d\u00e9ploy\u00e9e sur des milliers d'imprimantes dans les quelques semaines qui suivent son acceptation. La qualit\u00e9 des soumissions est donc consid\u00e9r\u00e9e comme une priorit\u00e9. Le d\u00e9p\u00f4t GitHub principal de Klipper3d/klipper n'accepte pas les travaux exp\u00e9rimentaux. Les auteurs doivent effectuer les exp\u00e9rimentations, le d\u00e9bogage et les tests dans leurs propres d\u00e9p\u00f4ts. Le serveur Klipper Discourse est un bon endroit pour faire conna\u00eetre les nouveaux travaux et trouver des utilisateurs d\u00e9sireux de fournir des commentaires concrets. Les soumissions doivent r\u00e9ussir tous les tests de r\u00e9gression . Lorsqu'ils corrigent un d\u00e9faut dans le code, les soumissionnaires doivent avoir une compr\u00e9hension g\u00e9n\u00e9rale de la cause fondamentale de ce d\u00e9faut, et la correction doit cibler cette seule cause fondamentale. Les soumissions de code ne doivent pas contenir de code de d\u00e9bogage excessif, d'options de d\u00e9bogage, ni d'enregistrement de d\u00e9bogage \u00e0 l'ex\u00e9cution. Les commentaires dans les soumissions de code doivent se concentrer sur l'am\u00e9lioration de la maintenance du code. Les soumissions ne doivent pas contenir de \"code comment\u00e9\" ni de commentaires excessifs d\u00e9crivant des impl\u00e9mentations pass\u00e9es. Il ne doit pas y avoir de commentaires excessifs de type \"todo\". Les mises \u00e0 jour de la documentation ne doivent pas indiquer qu'il s'agit d'un \"travail en cours\". La demande apporte-t-elle un avantage \"\u00e0 fort impact\" \u00e0 des utilisateurs du monde r\u00e9el effectuant des t\u00e2ches du monde r\u00e9el ?Les relecteurs doivent identifier, au moins dans leur propre esprit, \u00e0 peu pr\u00e8s \"qui est le public cible\", une \u00e9chelle approximative de \"la taille de ce public\", le \"b\u00e9n\u00e9fice\" qu'ils obtiendront, comment le \"b\u00e9n\u00e9fice est mesur\u00e9\", et les \"r\u00e9sultats de ces tests de mesure\". Dans la plupart des cas, ces \u00e9l\u00e9ments sont \u00e9vidents pour l'auteur et l'examinateur, et ne sont pas explicitement mentionn\u00e9s lors d'un examen. Les soumissions \u00e0 la branche principale de Klipper doivent avoir un public cible important. En r\u00e8gle g\u00e9n\u00e9rale, les soumissions doivent cibler une base d'au moins 100 utilisateurs du monde r\u00e9el. Si un relecteur demande des d\u00e9tails sur les \"avantages\" d'une proposition, ne consid\u00e9rez pas cela comme une critique. \u00catre capable de comprendre les avantages concrets d'un changement est une partie naturelle d'un examen. Lorsque l'on discute des avantages, il est pr\u00e9f\u00e9rable de parler de \"faits et de mesures\". En g\u00e9n\u00e9ral, les \u00e9valuateurs ne cherchent pas des r\u00e9ponses du type \"quelqu'un pourrait trouver l'option X utile\", ni des r\u00e9ponses du type \"cette soumission ajoute une fonctionnalit\u00e9 que le micrologiciel X met en \u0153uvre\". Au lieu de cela, il est g\u00e9n\u00e9ralement pr\u00e9f\u00e9rable de discuter des d\u00e9tails sur la fa\u00e7on dont l'am\u00e9lioration de la qualit\u00e9 a \u00e9t\u00e9 mesur\u00e9e et quels \u00e9taient les r\u00e9sultats de ces mesures - par exemple, \"les tests sur les imprimantes Acme X1000 montrent des coins am\u00e9lior\u00e9s comme on le voit sur l'image ...\", ou par exemple \"le temps d'impression de l'objet X du monde r\u00e9el sur une imprimante Foomatic X900 est pass\u00e9 de 4 heures \u00e0 3,5 heures\". Il est entendu que les tests de ce type peuvent prendre beaucoup de temps et d'efforts. Certaines des fonctionnalit\u00e9s les plus remarquables de Klipper ont n\u00e9cessit\u00e9 des mois de discussion, de re-travail, de tests et de documentation avant d'\u00eatre int\u00e9gr\u00e9es dans la branche principale. Tous les nouveaux modules, options de configuration, commandes, param\u00e8tres de commande et documents doivent avoir un \"impact \u00e9lev\u00e9\". Nous ne voulons pas imposer aux utilisateurs des options qu'ils ne peuvent raisonnablement pas configurer, ni des options qui n'apportent aucun avantage notable. Un relecteur peut demander des \u00e9claircissements sur la mani\u00e8re dont un utilisateur doit configurer une option - une r\u00e9ponse id\u00e9ale contiendra des d\u00e9tails sur le processus - par exemple, \"les utilisateurs du MegaX500 doivent r\u00e9gler l'option X sur 99,3 tandis que les utilisateurs du Elite100Y doivent calibrer l'option X en utilisant la proc\u00e9dure ...\". Si le but d'une option est de rendre le code plus modulaire, il est pr\u00e9f\u00e9rable d'utiliser des constantes de code plut\u00f4t que des options de configuration pour l'utilisateur. Les nouveaux modules, les nouvelles options et les nouveaux param\u00e8tres ne doivent pas offrir des fonctionnalit\u00e9s similaires \u00e0 celles des modules existants - si les diff\u00e9rences sont arbitraires, il est pr\u00e9f\u00e9rable d'utiliser le syst\u00e8me existant ou de remanier le code existant. Le droit d'auteur de la soumission est-il clair, non gracieux et compatible ?Les nouveaux fichiers C et Python doivent comporter une d\u00e9claration de copyright sans ambigu\u00eft\u00e9. Voir les fichiers existants pour le format pr\u00e9f\u00e9r\u00e9. Il est d\u00e9conseill\u00e9 de d\u00e9clarer un droit d'auteur sur un fichier existant lorsque l'on apporte des modifications mineures \u00e0 ce fichier. Le code provenant de sources tierces doit \u00eatre compatible avec la licence Klipper (GNU GPLv3). Les ajouts importants de code tiers doivent \u00eatre ajout\u00e9s au r\u00e9pertoire lib/ (et suivre le format d\u00e9crit dans lib/README ). Les soumissionnaires doivent fournir une ligne Signed-off-by en utilisant leur nom r\u00e9el complet. Elle indique que le soumissionnaire est d'accord avec le certificat d'origine du d\u00e9veloppeur . La soumission suit-elle les directives sp\u00e9cifi\u00e9es dans la documentation de Klipper ?En particulier, le code doit suivre les directives de et les fichiers de configuration doivent suivre les directives de . La documentation de Klipper est-elle mise \u00e0 jour pour refl\u00e9ter les nouveaux changements ?Au minimum, la documentation de r\u00e9f\u00e9rence doit \u00eatre mise \u00e0 jour avec les modifications correspondantes du code : Toutes les commandes et tous les param\u00e8tres de commande doivent \u00eatre document\u00e9s dans . Tous les modules destin\u00e9s aux utilisateurs et leurs param\u00e8tres de configuration doivent \u00eatre document\u00e9s dans . Toutes les \"variables d'\u00e9tat\" export\u00e9es doivent \u00eatre document\u00e9es dans . Tous les nouveaux \"webhooks\" et leurs param\u00e8tres doivent \u00eatre document\u00e9s dans . Toute modification qui apporte un changement non r\u00e9trocompatible \u00e0 une commande ou \u00e0 un param\u00e8tre du fichier de configuration doit \u00eatre document\u00e9e dans . Les nouveaux documents doivent \u00eatre ajout\u00e9s \u00e0 et \u00eatre ajout\u00e9s \u00e0 l'index du site web docs/_klipper3d/mkdocs.yml . Les commits sont-ils bien form\u00e9s, abordent-ils un seul sujet par commit, et sont-ils ind\u00e9pendants ?Les messages de validation doivent suivre le format pr\u00e9f\u00e9r\u00e9 . Les commits ne doivent pas avoir de conflit de fusion. Les nouveaux ajouts \u00e0 la branche ma\u00eetresse de Klipper sont toujours effectu\u00e9s via un \"rebase\" ou un \"squash and rebase\". Il n'est g\u00e9n\u00e9ralement pas n\u00e9cessaire pour les soumissionnaires de fusionner \u00e0 nouveau leur soumission \u00e0 chaque mise \u00e0 jour du d\u00e9p\u00f4t ma\u00eetre de Klipper. Cependant, s'il y a un conflit de fusion, il est recommand\u00e9 aux soumissionnaires d'utiliser git rebase pour r\u00e9soudre le conflit. Chaque validation doit porter sur un seul changement de haut niveau. Les changements importants doivent \u00eatre d\u00e9compos\u00e9s en plusieurs commits ind\u00e9pendants. Chaque livraison doit se suffire \u00e0 elle-m\u00eame pour que des outils comme git bisect et git revert fonctionnent de mani\u00e8re fiable. Les modifications des espaces blancs ne doivent pas \u00eatre m\u00e9lang\u00e9es avec les modifications fonctionnelles. En g\u00e9n\u00e9ral, les changements gratuits d'espace blanc ne sont pas accept\u00e9s, sauf s'ils proviennent du \"propri\u00e9taire\" \u00e9tabli du code en cours de modification. Klipper ne met pas en \u0153uvre un \"guide de style de codage\" strict, mais les modifications apport\u00e9es au code existant doivent respecter le flux de code de haut niveau, le style d'indentation du code et le format de ce code existant. Les soumissions de nouveaux modules et syst\u00e8mes b\u00e9n\u00e9ficient d'une plus grande souplesse en mati\u00e8re de style de codage, mais il est pr\u00e9f\u00e9rable que ce nouveau code suive un style coh\u00e9rent en interne et respecte g\u00e9n\u00e9ralement les normes de codage en vigueur dans le secteur. L'objectif d'une r\u00e9vision n'est pas de discuter de \"meilleures mises en \u0153uvre\". Cependant, si un relecteur a du mal \u00e0 comprendre l'impl\u00e9mentation d'une soumission, il peut demander des changements pour rendre l'impl\u00e9mentation plus transparente. En particulier, si les relecteurs ne peuvent pas se convaincre qu'une soumission est exempte de d\u00e9fauts, des changements peuvent \u00eatre n\u00e9cessaires. Dans le cadre d'une r\u00e9vision, un r\u00e9viseur peut cr\u00e9er une Pull Request alternative pour un sujet. Cela peut \u00eatre fait pour \u00e9viter un \"va-et-vient\" excessif sur des \u00e9l\u00e9ments de proc\u00e9dure mineurs et ainsi rationaliser le processus de soumission. Cela peut \u00e9galement \u00eatre fait parce que la discussion inspire un r\u00e9viseur \u00e0 construire une impl\u00e9mentation alternative. Ces deux situations sont le r\u00e9sultat normal d'une r\u00e9vision et ne doivent pas \u00eatre consid\u00e9r\u00e9es comme une critique de la soumission originale.","title":"A quoi s'attendre lors d'une r\u00e9vision"},{"location":"CONTRIBUTING.html#aider-a-la-revision","text":"Nous appr\u00e9cions l'aide pour les \u00e9valuations ! Il n'est pas n\u00e9cessaire d'\u00eatre un reviewer list\u00e9 pour effectuer une r\u00e9vision. Les auteurs de Pull Requests GitHub sont \u00e9galement encourag\u00e9s \u00e0 r\u00e9viser leurs propres soumissions. Pour faciliter la r\u00e9vision, suivez les \u00e9tapes d\u00e9crites dans \u00e0 quoi s'attendre lors d'une r\u00e9vision pour v\u00e9rifier la soumission. Une fois la r\u00e9vision termin\u00e9e, ajoutez un commentaire \u00e0 la Pull Request GitHub avec vos conclusions. Si la soumission passe la r\u00e9vision, veuillez l'indiquer explicitement dans le commentaire - par exemple quelque chose comme \"J'ai revu cette modification selon les \u00e9tapes du document CONTRIBUTING et tout me semble correct\". Si vous n'avez pas pu effectuer certaines \u00e9tapes de la r\u00e9vision, veuillez indiquer explicitement quelles \u00e9tapes ont \u00e9t\u00e9 r\u00e9vis\u00e9es et quelles \u00e9tapes ne l'ont pas \u00e9t\u00e9 - par exemple quelque chose comme \"Je n'ai pas v\u00e9rifi\u00e9 les d\u00e9fauts du code, mais j'ai revu tout le reste dans le document CONTRIBUTING et tout semble bon\". Nous appr\u00e9cions \u00e9galement les tests des soumissions. Si le code a \u00e9t\u00e9 test\u00e9, veuillez ajouter un commentaire \u00e0 la Pull Request GitHub avec les r\u00e9sultats de votre test - succ\u00e8s ou \u00e9chec. Veuillez indiquer explicitement que le code a \u00e9t\u00e9 test\u00e9 et les r\u00e9sultats - par exemple quelque chose comme \"J'ai test\u00e9 ce code sur mon imprimante Acme900Z avec une impression de vase et les r\u00e9sultats \u00e9taient bons\".","title":"Aider \u00e0 la r\u00e9vision"},{"location":"CONTRIBUTING.html#reviseurs","text":"Les \"r\u00e9viseurs\" de Klipper sont : Nom Id GitHub Domaines d'int\u00e9r\u00eat Dmitry Butyugin @dmbutyugin Input shaping, test de r\u00e9sonance, cin\u00e9matiques Eric Callahan @Arksine Nivellement du lit, flashage du MCU Kevin O'Connor @KevinOConnor Syst\u00e8me de mouvement de base, code du microcontr\u00f4leur Paul McGowan @mental405 Fichiers de configuration, documentation Veuillez ne pas envoyer de \"ping\" \u00e0 l'un des \u00e9valuateurs et ne pas leur adresser de soumissions. Tous les \u00e9valuateurs surveillent les forums et les PR, et prennent en charge les \u00e9valuations quand ils en ont le temps. Les \"mainteneurs\" de Klipper sont : Nom Nom GitHub Kevin O'Connor @KevinOConnor","title":"R\u00e9viseurs"},{"location":"CONTRIBUTING.html#format-des-messages-de-commit","text":"Chaque livraison doit avoir un message de livraison format\u00e9 de la mani\u00e8re suivante : module : R\u00e9sum\u00e9 en majuscules, court (50 caract\u00e8res ou moins) Texte explicatif plus d\u00e9taill\u00e9, si n\u00e9cessaire. Limitez-le \u00e0 environ 75 caract\u00e8res ou plus. Dans certains contextes, la premi\u00e8re ligne est consid\u00e9r\u00e9e comme l'objet d'un courriel et le reste du texte comme le corps. sujet d'un message \u00e9lectronique et le reste du texte comme le corps du message. La ligne vierge s\u00e9parant le r\u00e9sum\u00e9 du corps est essentielle (\u00e0 moins que vous n'omettiez enti\u00e8rement le corps). le corps enti\u00e8rement) ; des outils comme rebase peuvent \u00eatre confondus si vous ex\u00e9cutez les les deux ensemble. Les autres paragraphes viennent apr\u00e8s les lignes vides.. Sign\u00e9 par : Mon nom <myemail@example.org> Dans l'exemple ci-dessus, module doit \u00eatre le nom d'un fichier ou d'un r\u00e9pertoire dans le r\u00e9f\u00e9rentiel (sans extension de fichier). Par exemple, clocksync : Corriger une faute de frappe dans l'appel pause() au moment de la connexion . Le but de sp\u00e9cifier un nom de module dans le message de livraison est d'aider \u00e0 fournir un contexte pour les commentaires de livraison. Il est important d'avoir une ligne \"Signed-off-by\" sur chaque commit - elle certifie que vous acceptez le certificat d'origine du d\u00e9veloppeur . Cette ligne doit contenir votre vrai nom (d\u00e9sol\u00e9, pas de pseudonymes ou de contributions anonymes) et une adresse \u00e9lectronique valide.","title":"Format des messages de commit"},{"location":"CONTRIBUTING.html#contribuer-aux-traductions-de-klipper","text":"Projet de traduction de Klipper est le projet d\u00e9di\u00e9 \u00e0 la traduction de Klipper dans diff\u00e9rentes langues. Weblate h\u00e9berge toutes les cha\u00eenes Gettext pour la traduction et la r\u00e9vision. Les localisations peuvent \u00eatre affich\u00e9es sur klipper3d.org d\u00e8s lors qu'elles satisfont aux exigences suivantes : 75% Couverture totale Tous les titres (H1) sont traduits Une PR (Pull Request) hi\u00e9rarchis\u00e9e de navigation mise \u00e0 jour dans klipper-translations. Afin de r\u00e9duire la frustration li\u00e9e \u00e0 la traduction de termes sp\u00e9cifiques \u00e0 un domaine et de prendre connaissance des traductions en cours, vous pouvez soumettre une PR modifiant le Projet Klipper-translations readme.md . D\u00e8s qu'une traduction est pr\u00eate, la modification correspondante du projet Klipper peut \u00eatre effectu\u00e9e. Si une traduction existe d\u00e9j\u00e0 dans le r\u00e9f\u00e9rentiel Klipper et ne r\u00e9pond plus \u00e0 la liste de contr\u00f4le ci-dessus, elle sera marqu\u00e9e comme obsol\u00e8te apr\u00e8s un mois sans mise \u00e0 jour. Une fois que les conditions sont remplies, vous devez : mettre \u00e0 jour le fichier active_translations du d\u00e9p\u00f4t de klipper-tranlations Facultatif : ajouter un fichier manual-index.md dans le dossier docs\\locals\\<lang> du d\u00e9p\u00f4t klipper-translations pour remplacer l'index.md sp\u00e9cifique \u00e0 la langue (l'index.md g\u00e9n\u00e9r\u00e9 ne s'affiche pas correctement). Probl\u00e8mes connus : Actuellement, il n'existe pas de m\u00e9thode permettant de traduire correctement les images dans la documentation Il est impossible de traduire les titres dans mkdocs.yml.","title":"Contribuer aux traductions de Klipper"},{"location":"Code_Overview.html","text":"Aper\u00e7u du code \u00b6 Ce document d\u00e9crit la disposition g\u00e9n\u00e9rale du code et le flux de code principal de Klipper. Disposition du r\u00e9pertoire \u00b6 Le r\u00e9pertoire src/ contient les sources C du code du micro-contr\u00f4leur. Les r\u00e9pertoires src/atsam/ , src/atsamd/ , src/avr/ , src/linux/ , src/lpc176x/ , src/pru/ , et src/stm32/ contiennent le code du micro-contr\u00f4leur sp\u00e9cifique \u00e0 chaque architecture. Le r\u00e9pertoire src/simulator/ contient des \u00e9l\u00e9ments de remplacement de code permettant de tester la compilation du micro-contr\u00f4leur sur d'autres architectures. Le r\u00e9pertoire src/generic/ contient du code d'assistance utile sur diff\u00e9rentes architectures. La compilation fait en sorte que les inclusions de \"board/somefile.h\" soient d'abord recherch\u00e9es dans le r\u00e9pertoire de l'architecture courante (par exemple, src/avr/somefile.h) et ensuite dans le r\u00e9pertoire g\u00e9n\u00e9rique (par exemple, src/generic/somefile.h). Le r\u00e9pertoire klippy/ contient le logiciel h\u00f4te. La majorit\u00e9 du logiciel h\u00f4te est \u00e9crit en Python, cependant le r\u00e9pertoire klippy/chelper/ contient quelques assistants en code C. Le r\u00e9pertoire klippy/kinematics/ contient le code li\u00e9 \u00e0 la cin\u00e9matique du robot. Le r\u00e9pertoire klippy/extras/ contient les \"modules\" extensibles du code h\u00f4te. Le r\u00e9pertoire lib/ contient du code de biblioth\u00e8que externe de tierce partie n\u00e9cessaire \u00e0 la construction de certaines cibles. Le r\u00e9pertoire config/ contient des exemples de fichiers de configuration d'imprimante. Le r\u00e9pertoire scripts/ contient des scripts de construction utiles \u00e0 la compilation du code du micro-contr\u00f4leur. Le r\u00e9pertoire test/ contient des cas de tests automatis\u00e9s. Pendant la compilation, le constructeur peut cr\u00e9er un r\u00e9pertoire out/ . Celui-ci contient des objets temporaires de compilation. L'objet micro-contr\u00f4leur final qui est construit est out/klipper.elf.hex sur AVR et out/klipper.bin sur ARM. Flux de code du micro-contr\u00f4leur \u00b6 L'ex\u00e9cution du code du microcontr\u00f4leur d\u00e9bute dans le code sp\u00e9cifique \u00e0 l'architecture (par exemple, src/avr/main.c ) qui appelle finalement sched_main() situ\u00e9 dans src/sched.c . Le code sched_main() commence par ex\u00e9cuter toutes les fonctions marqu\u00e9es avec la macro DECL_INIT(). Il ex\u00e9cute ensuite de mani\u00e8re r\u00e9p\u00e9t\u00e9e toutes les fonctions marqu\u00e9es par la macro DECL_TASK(). L'une des principales fonctions de la t\u00e2che est command_dispatch() situ\u00e9e dans src/command.c . Cette fonction est appel\u00e9e \u00e0 partir du code d'entr\u00e9e/sortie sp\u00e9cifique \u00e0 la carte (par exemple, src/avr/serial.c , src/generic/serial_irq.c ) et elle ex\u00e9cute les fonctions de commande associ\u00e9es aux commandes trouv\u00e9es dans le flux d'entr\u00e9e. Les fonctions de commande sont d\u00e9clar\u00e9es \u00e0 l'aide de la macro DECL_COMMAND() (voir le document protocole pour plus d'informations). Les fonctions de t\u00e2che, d'initialisation et de commande s'ex\u00e9cutent toujours avec les interruptions activ\u00e9es (toutefois, elles peuvent d\u00e9sactiver temporairement les interruptions si n\u00e9cessaire). Ces fonctions doivent \u00e9viter les longues pauses, les retards, ou effectuer un travail qui dure un temps significatif. (Les longs retards de ces fonctions \"t\u00e2ches\" entra\u00eenent une gigue de programmation pour d'autres \"t\u00e2ches\" - les retards de plus de 100us peuvent devenir perceptibles, les retards de plus de 500us peuvent entra\u00eener des retransmissions de commandes, les retards de plus de 100ms peuvent entra\u00eener des red\u00e9marrages du chien de garde). Ces fonctions planifient le travail \u00e0 des moments pr\u00e9cis en programmant des minuteries. Les fonctions de temporisation sont programm\u00e9es en appelant sched_add_timer() (situ\u00e9 dans src/sched.c ). Le code du planificateur s'arrangera pour que la fonction donn\u00e9e soit appel\u00e9e au moment demand\u00e9. Les interruptions de temporisation sont initialement trait\u00e9es dans un gestionnaire d'interruption sp\u00e9cifique \u00e0 l'architecture (par exemple, src/avr/timer.c ) qui appelle sched_timer_dispatch() situ\u00e9 dans src/sched.c . L'interruption de la temporisation entra\u00eene l'ex\u00e9cution des fonctions de temporisation planifi\u00e9es. Les fonctions de temporisation sont toujours ex\u00e9cut\u00e9es avec des interruptions d\u00e9sactiv\u00e9es. Les fonctions de temporisation devraient toujours se terminer en quelques microsecondes. \u00c0 la fin de l'\u00e9v\u00e9nement de temporisation, la fonction peut choisir de se reprogrammer. En cas de d\u00e9tection d'erreur, le code peut invoquer shutdown() (une macro qui appelle sched_shutdown() situ\u00e9e dans src/sched.c ). L'appel \u00e0 shutdown() entra\u00eene l'ex\u00e9cution de toutes les fonctions marqu\u00e9es par la macro DECL_SHUTDOWN(). Les fonctions d'arr\u00eat s'ex\u00e9cutent toujours avec des interruptions d\u00e9sactiv\u00e9es. Une grande partie des fonctionnalit\u00e9s du micro-contr\u00f4leur implique de travailler avec des broches d'entr\u00e9e/sortie \u00e0 usage g\u00e9n\u00e9ral (GPIO). Afin de s\u00e9parer le code de bas niveau sp\u00e9cifique \u00e0 l'architecture du code de haut niveau de la t\u00e2che, tous les \u00e9v\u00e9nements GPIO sont impl\u00e9ment\u00e9s dans des emballages sp\u00e9cifiques \u00e0 l'architecture (par exemple, src/avr/gpio.c ). Le code est compil\u00e9 avec l'optimisation \"-flto -fwhole-program\" de gcc qui fait un excellent travail d'int\u00e9gration des fonctions \u00e0 travers les unit\u00e9s de compilation, ainsi la plupart de ces minuscules fonctions gpio sont int\u00e9gr\u00e9es \u00e0 leurs appelants, et il n'y a aucun co\u00fbt d'ex\u00e9cution \u00e0 les utiliser. Aper\u00e7u du code Klippy \u00b6 Le code h\u00f4te (Klippy) est destin\u00e9 \u00e0 fonctionner sur un ordinateur \u00e0 petit prix (tel qu'un Raspberry Pi) associ\u00e9 au microcontr\u00f4leur. Le code est principalement \u00e9crit en Python, cependant il utilise CFFI pour impl\u00e9menter certaines fonctionnalit\u00e9s en code C. L'ex\u00e9cution initiale commence dans klippy/klippy.py . Ceci lit les arguments de la ligne de commande, ouvre le fichier de configuration de l'imprimante, instancie les principaux objets de l'imprimante et lance la connexion s\u00e9rie. L'ex\u00e9cution principale des commandes G-code se fait dans la m\u00e9thode process_commands() de klippy/gcode.py . Ce code traduit les commandes G-code en appels d'objets d'imprimante fr\u00e9quemment traduis en commandes d'actions \u00e0 ex\u00e9cuter sur le micro-contr\u00f4leur (tel que d\u00e9clar\u00e9 via la macro DECL_COMMAND dans le code du micro-contr\u00f4leur). Il y a quatre threads dans le code h\u00f4te de Klippy. Le thread principal g\u00e8re les commandes gcode entrantes. Un deuxi\u00e8me thread (r\u00e9sidant enti\u00e8rement dans le code C klippy/chelper/serialqueue.c ) g\u00e8re les entr\u00e9es/sorties de bas niveau avec le port s\u00e9rie. Le troisi\u00e8me thread est utilis\u00e9 pour traiter les messages de r\u00e9ponse du micro-contr\u00f4leur dans le code Python (voir klippy/serialhdl.py ). Le quatri\u00e8me thread \u00e9crit les messages de d\u00e9bogage dans le journal (voir klippy/queuelogger.py ) afin que les autres threads ne bloquent jamais les \u00e9critures dans le journal. Flux du code d'une commande de d\u00e9placement \u00b6 Un mouvement typique de l'imprimante commence lorsqu'une commande \"G1\" est envoy\u00e9e \u00e0 l'h\u00f4te Klippy et se termine lorsque les impulsions de pas correspondantes sont produites sur le micro-contr\u00f4leur. Cette section d\u00e9crit le flux du code d'une commande de d\u00e9placement typique. Le document cin\u00e9matiques fournit des informations suppl\u00e9mentaires sur la m\u00e9canique des mouvements. Le traitement d'une commande de d\u00e9placement commence dans gcode.py. Le but de gcode.py est de traduire le G-code en appels internes. Une commande G1 invoquera cmd_G1() dans klippy/extras/gcode_move.py. Le code gcode_move.py g\u00e8re les changements d'origine (par exemple, G92), les changements de positions relatives et absolues (par exemple, G90), et les changements d'unit\u00e9s (par exemple, F6000=100mm/s). Le chemin du code pour un d\u00e9placement est : _process_data() -> _process_commands() -> cmd_G1() . Finalement, la classe ToolHead est invoqu\u00e9e pour ex\u00e9cuter la demande r\u00e9elle : cmd_G1() -> ToolHead.move() La classe ToolHead (dans toolhead.py) g\u00e8re le \"look-ahead\" et suit la temporisation des actions d'impression. Le chemin du code principal pour un d\u00e9placement est : ToolHead.move() -> MoveQueue.add_move() -> MoveQueue.flush() -> Move.set_junction() -> ToolHead._process_moves() . ToolHead.move() cr\u00e9e un objet Move() avec les param\u00e8tres du d\u00e9placement (dans l'espace cart\u00e9sien et en unit\u00e9s de secondes et de millim\u00e8tres). La classe cin\u00e9matique a la possibilit\u00e9 de v\u00e9rifier chaque mouvement ( ToolHead.move() -> kin.check_move() ). Les classes cin\u00e9matiques sont situ\u00e9es dans le r\u00e9pertoire klippy/kinematics/. Le code check_move() peut lever une erreur si le d\u00e9placement n'est pas valide. Si check_move() se termine avec succ\u00e8s, alors la cin\u00e9matique sous-jacente doit \u00eatre capable de g\u00e9rer le d\u00e9placement. MoveQueue.add_move() place l'objet move dans la file d'attente \"look-ahead\". MoveQueue.flush() d\u00e9termine les vitesses de d\u00e9but et de fin de chaque mouvement. Move.set_junction() impl\u00e9mente le \"g\u00e9n\u00e9rateur de trap\u00e8ze\" sur un mouvement. Le \"g\u00e9n\u00e9rateur de trap\u00e8ze\" divise chaque mouvement en trois parties : une phase d'acc\u00e9l\u00e9ration constante, suivie d'une phase de vitesse constante, puis d'une phase de d\u00e9c\u00e9l\u00e9ration constante. Chaque d\u00e9placement contient ces trois phases dans cet ordre, certaines phases pouvant \u00eatre de dur\u00e9e nulle. Lorsque ToolHead._process_moves() est appel\u00e9, tout ce qui concerne le d\u00e9placement est connu : sa position de d\u00e9part, sa position d'arriv\u00e9e, son acc\u00e9l\u00e9ration, sa vitesse de d\u00e9part/de croisi\u00e8re/de fin, et la distance parcourue pendant l'acc\u00e9l\u00e9ration/la croisi\u00e8re/la d\u00e9c\u00e9l\u00e9ration. Toutes ces informations sont stock\u00e9es dans la classe Move() et sont dans l'espace cart\u00e9sien en unit\u00e9s de millim\u00e8tres et de secondes. Klipper utilise un solveur it\u00e9ratif afin de g\u00e9n\u00e9rer les d\u00e9lais des pas pour chaque moteur pas \u00e0 pas. Pour des raisons d'efficacit\u00e9, les d\u00e9lais d'impulsion des pas sont g\u00e9n\u00e9r\u00e9s en code C. Les mouvements sont d'abord plac\u00e9s dans une \"file d'attente de mouvements trap\u00e9zo\u00efdaux\" : ToolHead._process_moves() -> trapq_append() (dans klippy/chelper/trapq.c). Les d\u00e9lais de pas sont ensuite g\u00e9n\u00e9r\u00e9s : ToolHead._process_moves() -> ToolHead._update_move_time() -> MCU_Stepper.generate_steps() -> itersolve_generate_steps() -> itersolve_gen_steps_range() (dans klippy/chelper/itersolve.c). Le but du solveur it\u00e9ratif est de trouver les d\u00e9lais de pas \u00e0 partir d'une fonction calculant la position du moteur \u00e0 partir du temps. Ceci est fait en \"devinant\" de mani\u00e8re r\u00e9p\u00e9t\u00e9e plusieurs d\u00e9lais jusqu'\u00e0 ce que la formule de position du pas renvoie la position d\u00e9sir\u00e9e du pas suivant sur le moteur. Le retour d'information produit par chaque estimation est utilis\u00e9 afin d'am\u00e9liorer les estimations futures, de sorte que le processus converge rapidement vers le d\u00e9lai souhait\u00e9. Les formules de position cin\u00e9matique du moteur sont situ\u00e9es dans le r\u00e9pertoire klippy/chelper/ (par exemple, kin_cart.c, kin_corexy.c, kin_delta.c, kin_extruder.c). Notez que l'extrudeuse est g\u00e9r\u00e9e dans sa propre classe cin\u00e9matique : ToolHead._process_moves() -> PrinterExtruder.move() . Puisque la classe Move() sp\u00e9cifie le d\u00e9lai exact du mouvement et que les impulsions de pas sont envoy\u00e9es au micro-contr\u00f4leur avec un timing sp\u00e9cifique, les mouvements du moteur produits par la classe de l'extrudeuse seront synchronis\u00e9s avec le mouvement de la t\u00eate m\u00eame si le code est s\u00e9par\u00e9. Apr\u00e8s que le solveur it\u00e9ratif ait calcul\u00e9 les d\u00e9lais de pas, ils sont ajout\u00e9s \u00e0 un tableau : itersolve_gen_steps_range() -> stepcompress_append() (dans klippy/chelper/stepcompress.c). Le tableau (struct stepcompress.queue) stocke les dur\u00e9es correspondantes du compteur d'horloge du micro-contr\u00f4leur pour chaque \u00e9tape. Ici, la valeur du \"compteur d'horloge du micro-contr\u00f4leur\" correspond directement au compteur mat\u00e9riel du micro-contr\u00f4leur - elle est relative \u00e0 la derni\u00e8re mise sous tension du micro-contr\u00f4leur. La prochaine \u00e9tape majeure est de compresser les \u00e9tapes : stepcompress_flush() -> compress_bisect_add() (dans klippy/chelper/stepcompress.c). Ce code g\u00e9n\u00e8re et encode une s\u00e9rie de commandes \"queue_step\" du micro-contr\u00f4leur correspondant \u00e0 la liste des dur\u00e9es de pas du moteur construite \u00e0 l'\u00e9tape pr\u00e9c\u00e9dente. Ces commandes \"queue_step\" sont ensuite mises en file d'attente, hi\u00e9rarchis\u00e9es et envoy\u00e9es au micro-contr\u00f4leur (via stepcompress.c:steppersync et serialqueue.c:serialqueue). Le traitement des commandes queue_step sur le micro-contr\u00f4leur commence dans src/command.c qui analyse la commande et appelle command_queue_step() . Le code command_queue_step() (dans src/stepper.c) ajoute simplement les param\u00e8tres de chaque commande queue_step \u00e0 une file d'attente par moteur. En fonctionnement normal, la commande queue_step est analys\u00e9e et mise en file d'attente au moins 100ms avant le moment de son premier pas. Enfin, la g\u00e9n\u00e9ration des \u00e9v\u00e9nements de pas du moteur est faite dans stepper_event() . Elle est appel\u00e9e depuis l'interruption du compteur mat\u00e9riel \u00e0 l'heure pr\u00e9vue du premier pas. Le code stepper_event() g\u00e9n\u00e8re une impulsion de pas et se reprogramme ensuite pour s'ex\u00e9cuter au moment de l'impulsion de pas suivante pour les param\u00e8tres queue_step donn\u00e9s. Les param\u00e8tres pour chaque commande queue_step sont \"interval\", \"count\", et \"add\". A un haut niveau, stepper_event() ex\u00e9cute la commande suivante, 'count' fois : do_step() ; next_wake_time = last_wake_time + interval ; interval += add; Ce qui pr\u00e9c\u00e8de peut sembler beaucoup de complexit\u00e9 pour l'ex\u00e9cution d'un mouvement. Cependant, les seules parties vraiment int\u00e9ressantes se trouvent dans les classes ToolHead et kinematic. C'est cette partie du code qui pr\u00e9cise les mouvements et leurs dur\u00e9es. Les autres parties du traitement sont essentiellement de la communication et de la plomberie. Ajout d'un module h\u00f4te \u00b6 Le code h\u00f4te de Klippy a une capacit\u00e9 de chargement dynamique de modules. Si une section de configuration nomm\u00e9e \"[mon_module]\" est trouv\u00e9e dans le fichier de configuration de l'imprimante, le logiciel tentera automatiquement de charger le module python klippy/extras/mon_module.py . Ce syst\u00e8me de modules est la m\u00e9thode pr\u00e9f\u00e9r\u00e9e pour ajouter de nouvelles fonctionnalit\u00e9s \u00e0 Klipper. La fa\u00e7on la plus simple d'ajouter un nouveau module est d'utiliser un module existant comme r\u00e9f\u00e9rence - voir klippy/extras/servo.py comme exemple. Les \u00e9l\u00e9ments suivants peuvent \u00e9galement \u00eatre utiles : L'ex\u00e9cution du module commence dans la fonction load_config() au niveau du module (pour les sections de configuration de la forme [mon_module]) ou dans load_config_prefix() (pour les sections de configuration de la forme [mon_module mon_nom]). On passe \u00e0 cette fonction un objet \"config\" et elle doit retourner un nouvel \"objet imprimante\" associ\u00e9 \u00e0 la section de configuration donn\u00e9e. Durant le processus d'instanciation d'un nouvel objet imprimante, l'objet config peut \u00eatre utilis\u00e9 pour lire les param\u00e8tres de la section config donn\u00e9e. Ceci est fait en utilisant les m\u00e9thodes config.get() , config.getfloat() , config.getint() , etc. Assurez-vous de lire toutes les valeurs de la configuration pendant la construction de l'objet imprimante - si l'utilisateur sp\u00e9cifie un param\u00e8tre de configuration qui n'est pas lu pendant cette phase, il sera suppos\u00e9 qu'il s'agit d'une faute de frappe dans la configuration et une erreur sera lev\u00e9e. Utilisez la m\u00e9thode config.get_printer() pour obtenir une r\u00e9f\u00e9rence \u00e0 la classe principale \"printer\". Cette classe \"printer\" stocke les r\u00e9f\u00e9rences de tous les \"objets imprimante\" instanci\u00e9s. Utilisez la m\u00e9thode printer.lookup_object() pour trouver des r\u00e9f\u00e9rences \u00e0 d'autres objets imprimante. Presque toutes les fonctionnalit\u00e9s (m\u00eame les modules cin\u00e9matiques de base) sont encapsul\u00e9es dans un de ces objets imprimante. Notez, cependant, que lorsqu'un nouveau module est instanci\u00e9, tous les autres objets d'impression n'auront pas encore \u00e9t\u00e9 instanci\u00e9s. Les modules \"gcode\" et \"pins\" seront toujours disponibles, mais pour les autres modules, il est pr\u00e9f\u00e9rable de diff\u00e9rer la recherche. Enregistrez les gestionnaires d'\u00e9v\u00e9nements en utilisant la m\u00e9thode printer.register_event_handler() si le code doit \u00eatre appel\u00e9 lors d'\"\u00e9v\u00e9nements\" d\u00e9clench\u00e9s par d'autres objets imprimante. Chaque nom d'\u00e9v\u00e9nement est une cha\u00eene de caract\u00e8res, et par convention, c'est le nom du module source principal d\u00e9clenchant l'\u00e9v\u00e9nement avec un nom court pour l'action produite (par exemple, \"klippy:connect\"). Les param\u00e8tres pass\u00e9s \u00e0 chaque gestionnaire d'\u00e9v\u00e9nement sont sp\u00e9cifiques \u00e0 l'\u00e9v\u00e9nement en question (tout comme le traitement des exceptions et le contexte d'ex\u00e9cution). Deux \u00e9v\u00e9nements de d\u00e9marrage courants sont : klippy:connect - Cet \u00e9v\u00e9nement est g\u00e9n\u00e9r\u00e9 apr\u00e8s l'instanciation de tous les objets imprimante. Il est couramment utilis\u00e9 pour rechercher d'autres objets imprimante, pour v\u00e9rifier les param\u00e8tres de configuration et pour effectuer une premi\u00e8re \"prise de contact\" avec le mat\u00e9riel de l'imprimante. klippy:ready - Cet \u00e9v\u00e9nement est g\u00e9n\u00e9r\u00e9 apr\u00e8s que tous les gestionnaires de connexion se soient termin\u00e9s avec succ\u00e8s. Il indique que l'imprimante est en train de passer \u00e0 l'\u00e9tat pr\u00eat \u00e0 g\u00e9rer les op\u00e9rations normales. Ne d\u00e9clenchez pas d'erreur dans ce rappel. S'il y a une erreur dans la configuration de l'utilisateur, assurez-vous de la signaler pendant les phases load_config() ou \"connect event\". Utilisez soit raise config.error(\"mon erreur\") soit raise printer.config_error(\"mon erreur\") pour signaler l'erreur. Utilisez le module \"pins\" pour configurer une broche sur un micro-contr\u00f4leur. Ceci est typiquement fait avec quelque chose de similaire \u00e0 printer.lookup_object(\"pins\").setup_pin(\"pwm\", config.get(\"my_pin\")) . L'objet retourn\u00e9 peut alors \u00eatre command\u00e9 au moment de l'ex\u00e9cution. Si l'objet imprimante d\u00e9finit une m\u00e9thode get_status() , le module peut exporter des informations d'\u00e9tat via des macros et via le serveur API . La m\u00e9thode get_status() doit retourner un dictionnaire Python dont les cl\u00e9s sont des cha\u00eenes de caract\u00e8res et les valeurs des entiers, des flottants, des cha\u00eenes de caract\u00e8res, des listes, des dictionnaires, True, False ou None. Les tuples (et les tuples nomm\u00e9s) peuvent \u00e9galement \u00eatre utilis\u00e9s (ils apparaissent comme des listes lorsqu'on y acc\u00e8de via le serveur API). Les listes et les dictionnaires export\u00e9s doivent \u00eatre trait\u00e9s comme \"immuables\" - si leur contenu change, un nouvel objet doit \u00eatre renvoy\u00e9 par get_status() , sinon le serveur API ne d\u00e9tectera pas ces changements. Si le module doit acc\u00e9der \u00e0 la temporisation du syst\u00e8me ou \u00e0 des descripteurs de fichiers externes, utilisez printer.get_reactor() pour obtenir l'acc\u00e8s \u00e0 la classe globale \"event reactor\". Cette classe de r\u00e9acteur permet de programmer des temporisations, d'attendre des entr\u00e9es sur des descripteurs de fichiers, et d'\"endormir\" le code h\u00f4te. N'utilisez pas de variables globales. Tous les \u00e9tats doivent \u00eatre stock\u00e9s dans l'objet imprimante renvoy\u00e9 par la fonction load_config() . Ceci est important car sinon la commande RESTART pourrait ne pas fonctionner comme pr\u00e9vu. De m\u00eame, pour des raisons similaires, si des fichiers externes (ou des sockets) sont ouverts, assurez-vous d'enregistrer un gestionnaire d'\u00e9v\u00e9nement \"klippy:disconnect\" et de les fermer \u00e0 partir de ce rappel. \u00c9vitez d'acc\u00e9der aux variables membres internes (ou d'appeler les m\u00e9thodes commen\u00e7ant par un trait de soulignement) d'autres objets imprimante. Le respect de cette convention facilite la gestion des modifications futures. Il est recommand\u00e9 d'attribuer une valeur \u00e0 toutes les variables membres dans le constructeur Python des classes Python. (Et donc d'\u00e9viter d'utiliser la capacit\u00e9 de Python \u00e0 cr\u00e9er dynamiquement de nouvelles variables membres.) Si une variable Python doit stocker une valeur en virgule flottante, il est recommand\u00e9 de toujours affecter et manipuler cette variable avec des constantes en virgule flottante (et de ne jamais utiliser de constantes enti\u00e8res). Par exemple, pr\u00e9f\u00e9rez self.speed = 1. \u00e0 self.speed = 1 , et pr\u00e9f\u00e9rez self.speed = 2. * x plut\u00f4t que self.speed = 2 * x . L'utilisation coh\u00e9rente des valeurs \u00e0 virgule flottante peut \u00e9viter des bizarreries difficiles \u00e0 d\u00e9boguer dans les conversions de types Python. Si vous soumettez le module pour qu'il soit inclus dans le code principal de Klipper, veillez \u00e0 placer un avis de copyright en haut du module. Consultez les modules existants pour conna\u00eetre le format pr\u00e9f\u00e9r\u00e9. Ajout de nouvelles cin\u00e9matiques \u00b6 Cette section fournit quelques conseils pour ajouter le support \u00e0 Klipper de types suppl\u00e9mentaires de cin\u00e9matiques d'imprimante. Ce type d'activit\u00e9 n\u00e9cessite une excellente compr\u00e9hension des formules math\u00e9matiques de la cin\u00e9matique cible. Elle requiert \u00e9galement des comp\u00e9tences en mati\u00e8re de d\u00e9veloppement de logiciels, m\u00eame s'il suffit de mettre \u00e0 jour le logiciel h\u00f4te. Les \u00e9tapes utiles : Commencez par \u00e9tudier la section \" code de flux d'un mouvement \" et le document cin\u00e9matiques . Passez en revue les classes cin\u00e9matiques existantes dans le r\u00e9pertoire klippy/kinematics/. Les classes cin\u00e9matiques sont charg\u00e9es de convertir le mouvement en coordonn\u00e9es cart\u00e9siennes en un mouvement sur chaque moteur. On devrait \u00eatre capable de copier un de ces fichiers comme point de d\u00e9part. Impl\u00e9mentez les fonctions de position cin\u00e9matique du moteur en C pour chaque moteur si elles ne sont pas d\u00e9j\u00e0 disponibles (voir kin_cart.c, kin_corexy.c, et kin_delta.c dans klippy/chelper/). La fonction doit appeler move_get_coord() pour convertir une dur\u00e9e de d\u00e9placement donn\u00e9e (en secondes) en coordonn\u00e9es cart\u00e9siennes (en millim\u00e8tres), et ensuite calculer la position souhait\u00e9e du moteur (en millim\u00e8tres) \u00e0 partir de ces coordonn\u00e9es cart\u00e9siennes. Impl\u00e9mentez la m\u00e9thode calc_position() dans la nouvelle classe cin\u00e9matique. Cette m\u00e9thode calcule la position de la t\u00eate de l'outil en coordonn\u00e9es cart\u00e9siennes \u00e0 partir de la position de chaque moteur. Elle n'a pas besoin d'\u00eatre efficace car elle n'est typiquement appel\u00e9e que pendant les op\u00e9rations de mise \u00e0 l'origine et de palpage. Autres m\u00e9thodes. Impl\u00e9mentez les m\u00e9thodes check_move() , get_status() , get_steppers() , home() , et set_position() . Ces fonctions sont typiquement utilis\u00e9es pour fournir des v\u00e9rifications sp\u00e9cifiques \u00e0 la cin\u00e9matique. Cependant, au d\u00e9but du d\u00e9veloppement, on peut utiliser du code passe-partout ici. Impl\u00e9menter des cas de test. Cr\u00e9ez un fichier g-code avec une s\u00e9rie de mouvements pouvant tester des cas importants pour la cin\u00e9matique donn\u00e9e. Suivez la documentation de d\u00e9bogage pour convertir ce fichier g-code en commandes de micro-contr\u00f4leur. Ceci est utile pour tester les cas extr\u00eames et v\u00e9rifier les r\u00e9gressions. Portage sur un nouveau microcontr\u00f4leur \u00b6 Cette section fournit quelques conseils sur le portage du code du microcontr\u00f4leur de Klipper vers une nouvelle architecture. Ce type d'activit\u00e9 n\u00e9cessite une bonne connaissance du d\u00e9veloppement embarqu\u00e9 et un acc\u00e8s pratique au microcontr\u00f4leur cible. Les \u00e9tapes utiles : Commencez par identifier toutes les biblioth\u00e8ques tierces qui seront utilis\u00e9es pendant le portage. Les exemples courants incluent les wrappers \"CMSIS\" et les biblioth\u00e8ques \"HAL\" des fabricants. Tout code tiers doit \u00eatre compatible avec la licence GNU GPLv3. Le code tiers doit \u00eatre livr\u00e9 dans le r\u00e9pertoire Klipper lib/. Mettez \u00e0 jour le fichier lib/README en indiquant o\u00f9 et quand la biblioth\u00e8que a \u00e9t\u00e9 obtenue. Il est pr\u00e9f\u00e9rable de copier le code dans le d\u00e9p\u00f4t Klipper sans modification, mais si des modifications sont n\u00e9cessaires, elles doivent \u00eatre indiqu\u00e9es explicitement dans le fichier lib/README. Cr\u00e9er un nouveau sous-r\u00e9pertoire d'architecture dans le r\u00e9pertoire src/ et ajouter le support initial de Kconfig et Makefile. Utilisez les architectures existantes comme guide. Le simulateur src/simulator fournit un exemple de base pour un point de d\u00e9part minimal. La premi\u00e8re t\u00e2che principale de codage est d'apporter le support de communication \u00e0 la carte cible. C'est l'\u00e9tape la plus difficile dans un nouveau portage. Une fois que la communication de base fonctionne, les autres \u00e9tapes ont tendance \u00e0 \u00eatre beaucoup plus faciles. Il est typique d'utiliser un dispositif s\u00e9rie de type UART pendant le d\u00e9veloppement initial car ces types de dispositifs mat\u00e9riels sont g\u00e9n\u00e9ralement plus faciles \u00e0 activer et \u00e0 contr\u00f4ler. Pendant cette phase, faites un usage lib\u00e9ral du code d'aide du r\u00e9pertoire src/generic/ (v\u00e9rifiez comment src/simulator/Makefile inclut le code C g\u00e9n\u00e9rique dans la compilation). Il est \u00e9galement n\u00e9cessaire de d\u00e9finir timer_read_time() (qui renvoie l'horloge syst\u00e8me actuelle) dans cette phase, mais il n'est pas n\u00e9cessaire de supporter compl\u00e8tement la gestion des irq des timers. Familiarisez-vous avec l'outil console.py (comme d\u00e9crit dans le document de d\u00e9bogage ) et v\u00e9rifiez la connectivit\u00e9 au microcontr\u00f4leur avec cet outil. Cet outil traduit le protocole de communication de bas niveau du microcontr\u00f4leur en une forme lisible par l'homme. Ajouter le support pour la distribution des timers \u00e0 partir des interruptions mat\u00e9rielles. Voir Klipper commit 970831ee comme exemple des \u00e9tapes 1-5 r\u00e9alis\u00e9es pour l'architecture LPC176x. Apporter le support de base des entr\u00e9es et sorties GPIO. Voir Klipper commit c78b9076 comme exemple. Faire appara\u00eetre des p\u00e9riph\u00e9riques suppl\u00e9mentaires - par exemple, voir Klipper commit 65613aed , c812a40a , et c381d03a . Cr\u00e9ez un exemple de fichier de configuration Klipper dans le r\u00e9pertoire config/. Testez le micro-contr\u00f4leur avec le programme principal klippy.py. Pensez \u00e0 ajouter des cas de test de construction dans le r\u00e9pertoire test/. Conseils suppl\u00e9mentaires pour le codage : \u00c9vitez d'utiliser des \"champs de bits C\" pour acc\u00e9der aux registres d'E/S ; pr\u00e9f\u00e9rez les op\u00e9rations directes de lecture et d'\u00e9criture d'entiers de 32, 16 ou 8 bits. Les sp\u00e9cifications du langage C ne pr\u00e9cisent pas clairement comment le compilateur doit impl\u00e9menter les champs de bits C (par exemple, l'endianness et la disposition des bits), et il est difficile de d\u00e9terminer quelles op\u00e9rations d'E/S se produiront lors de la lecture ou de l'\u00e9criture d'un champ de bits C. Pr\u00e9f\u00e9rez l'\u00e9criture de valeurs explicites dans les registres d'E/S \u00e0 l'utilisation d'op\u00e9rations de lecture-modification-\u00e9criture. Autrement dit, si l'on met \u00e0 jour un champ dans un registre d'E/S dont les autres champs ont des valeurs connues, il est pr\u00e9f\u00e9rable d'\u00e9crire explicitement le contenu complet du registre. Les \u00e9critures explicites produisent un code plus petit, plus rapide et plus facile \u00e0 d\u00e9boguer. Les syst\u00e8mes de coordonn\u00e9es \u00b6 En interne, Klipper suit principalement la position de la t\u00eate de l'outil en coordonn\u00e9es cart\u00e9siennes relatives au syst\u00e8me de coordonn\u00e9es sp\u00e9cifi\u00e9 dans le fichier de configuration. C'est-\u00e0-dire que la plupart du code de Klipper ne conna\u00eetra jamais de changement de syst\u00e8me de coordonn\u00e9es. Si l'utilisateur fait une demande pour changer l'origine (par exemple, une commande G92 ) alors cet effet est obtenu en traduisant les commandes futures vers le syst\u00e8me de coordonn\u00e9es primaires. Cependant, dans certains cas, il est utile d'obtenir la position de la t\u00eate de l'outil dans un autre syst\u00e8me de coordonn\u00e9es et Klipper dispose de plusieurs outils pour faciliter cela. Vous pouvez le constater en ex\u00e9cutant la commande GET_POSITION. Par exemple : Send: GET_POSITION Recv: // mcu: stepper_a:-2060 stepper_b:-1169 stepper_c:-1613 Recv: // stepper: stepper_a:457.254159 stepper_b:466.085669 stepper_c:465.382132 Recv: // kinematic: X:8.339144 Y:-3.131558 Z:233.347121 Recv: // toolhead: X:8.338078 Y:-3.123175 Z:233.347878 E:0.000000 Recv: // gcode: X:8.338078 Y:-3.123175 Z:233.347878 E:0.000000 Recv: // gcode base: X:0.000000 Y:0.000000 Z:0.000000 E:0.000000 Recv: // gcode homing: X:0.000000 Y:0.000000 Z:0.000000 La position \"mcu\" ( stepper.get_mcu_position() dans le code) est le nombre total de pas que le micro-contr\u00f4leur a \u00e9mis dans un sens positif moins le nombre de pas \u00e9mis dans un sens n\u00e9gatif depuis la derni\u00e8re r\u00e9initialisation du micro-contr\u00f4leur. Si le robot est en mouvement lorsque la requ\u00eate est \u00e9mise, la valeur rapport\u00e9e inclut les mouvements mis en m\u00e9moire tampon dans le microcontr\u00f4leur, mais pas les mouvements de la file d'attente de surveillance. La position \"stepper\" ( stepper.get_commanded_position() ) est la position du moteur donn\u00e9 telle qu'elle est suivie par le code cin\u00e9matique. Cela correspond g\u00e9n\u00e9ralement \u00e0 la position (en mm) du chariot le long de son rail, par rapport \u00e0 la position_endstop indiqu\u00e9e dans le fichier de configuration. (Si le robot est en mouvement lorsque la requ\u00eate est \u00e9mise, la valeur rapport\u00e9e inclut les mouvements mis en m\u00e9moire tampon sur le micro-contr\u00f4leur, mais n'inclut pas les mouvements de la file d'attente look-ahead. On peut utiliser les appels toolhead.flush_step_generation() ou toolhead.wait_moves() pour vider compl\u00e8tement les codes de look-ahead et de g\u00e9n\u00e9ration de pas. La position \"kinematic\" ( kin.calc_position() ) est la position cart\u00e9sienne de la t\u00eate de l'outil telle que d\u00e9riv\u00e9e des positions \"pas \u00e0 pas\" et est relative au syst\u00e8me de coordonn\u00e9es sp\u00e9cifi\u00e9 dans le fichier de configuration. Cela peut diff\u00e9rer de la position cart\u00e9sienne demand\u00e9e en raison de la granularit\u00e9 des moteurs pas \u00e0 pas. Si le robot est en mouvement lorsque les positions \"stepper\" sont prises, la valeur rapport\u00e9e inclut les mouvements mis en m\u00e9moire tampon sur le micro-contr\u00f4leur, mais n'inclut pas les mouvements de la file d'attente look-ahead. On peut utiliser les appels toolhead.flush_step_generation() ou toolhead.wait_moves() pour vider compl\u00e8tement le code de look-ahead et de g\u00e9n\u00e9ration de pas. La position de la t\u00eate d'outil ( toolhead.get_position() ) est la derni\u00e8re position demand\u00e9e de la t\u00eate d'outil en coordonn\u00e9es cart\u00e9siennes par rapport au syst\u00e8me de coordonn\u00e9es sp\u00e9cifi\u00e9 dans le fichier de configuration. Si le robot est en mouvement lorsque la requ\u00eate est \u00e9mise, la valeur rapport\u00e9e inclut tous les d\u00e9placements demand\u00e9s (m\u00eame ceux dans les tampons en attente d'\u00eatre \u00e9mis vers les pilotes de moteurs pas \u00e0 pas). La position \"gcode\" est la derni\u00e8re position demand\u00e9e par une commande G1 (ou G0 ) en coordonn\u00e9es cart\u00e9siennes par rapport au syst\u00e8me de coordonn\u00e9es sp\u00e9cifi\u00e9 dans le fichier de configuration. Elle peut diff\u00e9rer de la position \"toolhead\" si une transformation g-code (par exemple, bed_mesh, bed_tilt, skew_correction) est en cours. Cela peut diff\u00e9rer des coordonn\u00e9es r\u00e9elles sp\u00e9cifi\u00e9es dans la derni\u00e8re commande G1 si l'origine du gcode a \u00e9t\u00e9 modifi\u00e9e (par exemple, G92 , SET_GCODE_OFFSET , M221 ). La commande M114 ( gcode_move.get_status()['gcode_position'] ) indiquera la derni\u00e8re position du g-code par rapport au syst\u00e8me de coordonn\u00e9es actuel du g-code. La \"base gcode\" est l'emplacement de l'origine du g-code en coordonn\u00e9es cart\u00e9siennes par rapport au syst\u00e8me de coordonn\u00e9es sp\u00e9cifi\u00e9 dans le fichier de configuration. Les commandes telles que G92 , SET_GCODE_OFFSET , et M221 modifient cette valeur. Le \"gcode homing\" est l'emplacement \u00e0 utiliser pour l'origine du g-code (en coordonn\u00e9es cart\u00e9siennes par rapport au syst\u00e8me de coordonn\u00e9es sp\u00e9cifi\u00e9 dans le fichier de configuration) apr\u00e8s une commande de mise \u00e0 l'origine G28 . La commande SET_GCODE_OFFSET peut modifier cette valeur. Temporisation \u00b6 La manipulation des horloges, des dur\u00e9es et des horodatages est fondamentale pour le fonctionnement de Klipper. Celui-ci ex\u00e9cute des actions sur l'imprimante en programmant des \u00e9v\u00e9nements qui se produiront dans un avenir proche. Par exemple, pour allumer un ventilateur, le code peut programmer un changement sur une broche GPIO dans 100 ms. Il est rare que le code tente d'effectuer une action instantan\u00e9e. Ainsi, la gestion du temps dans Klipper est essentielle pour un fonctionnement correct. Il existe trois types de temporisations suivis en interne dans le logiciel h\u00f4te Klipper : Heure du syst\u00e8me. L'heure syst\u00e8me utilise l'horloge du syst\u00e8me - c'est un nombre \u00e0 virgule flottante stock\u00e9 sous forme de secondes (g\u00e9n\u00e9ralement) relatif \u00e0 la date du dernier d\u00e9marrage de l'ordinateur h\u00f4te. Les temps syst\u00e8me ont un usage limit\u00e9 dans le logiciel - ils sont principalement utilis\u00e9s lors de l'interaction avec le syst\u00e8me d'exploitation. Dans le code h\u00f4te, les heures syst\u00e8me sont souvent stock\u00e9es dans des variables nomm\u00e9es eventtime ou curtime . Temps d'impression. Le temps d'impression est synchronis\u00e9 avec l'horloge du micro-contr\u00f4leur principal (le micro-contr\u00f4leur d\u00e9fini dans la section \"[mcu]\" de la configuration). C'est un nombre \u00e0 virgule flottante stock\u00e9 en secondes relatif \u00e0 la date du dernier red\u00e9marrage du micro-contr\u00f4leur principal. Il est possible de convertir un \"temps d'impression\" en horloge mat\u00e9rielle du micro-contr\u00f4leur principal en multipliant le temps d'impression par le taux de fr\u00e9quence du mcu configur\u00e9 statiquement. Le code h\u00f4te de haut niveau utilise les temps d'impression pour calculer presque toutes les actions physiques (par exemple, le mouvement de la t\u00eate, les changements de chauffage, etc.) Dans le code h\u00f4te, les temps d'impression sont g\u00e9n\u00e9ralement stock\u00e9s dans des variables nomm\u00e9es print_time ou move_time . Horloge MCU. Il s'agit du compteur d'horloge mat\u00e9riel de chaque micro-contr\u00f4leur. Il est stock\u00e9 sous forme d'un nombre entier et son taux de mise \u00e0 jour est relatif \u00e0 la fr\u00e9quence du micro-contr\u00f4leur donn\u00e9. Le logiciel h\u00f4te convertit ses temps internes en horloges avant de les transmettre \u00e0 l'unit\u00e9 centrale. Le code de l'unit\u00e9 centrale de traitement ne suit jamais le temps qu'en ticks d'horloge. Dans le code h\u00f4te, les valeurs d'horloge sont suivies sous forme d'entiers de 64 bits, alors que le code de l'unit\u00e9 centrale utilise des entiers de 32 bits. Dans le code h\u00f4te, les horloges sont g\u00e9n\u00e9ralement stock\u00e9es dans des variables dont les noms contiennent clock ou ticks . La conversion entre les diff\u00e9rents formats de temps est principalement impl\u00e9ment\u00e9e dans le code klippy/clocksync.py . Quelques \u00e9l\u00e9ments \u00e0 prendre en compte lors de la r\u00e9vision du code : Horloges 32bit et 64bit : Pour r\u00e9duire la bande passante et am\u00e9liorer l'efficacit\u00e9 du micro-contr\u00f4leur, les horloges sur le micro-contr\u00f4leur sont suivies comme des entiers 32bit. Lors de la comparaison de deux horloges dans le code mcu, la fonction timer_is_before() doit toujours \u00eatre utilis\u00e9e pour s'assurer que les renversements d'entiers sont trait\u00e9s correctement. Le logiciel h\u00f4te convertit les horloges 32bit en horloges 64bit en ajoutant les bits de poids fort du dernier timestamp mcu qu'il a re\u00e7u - aucun message du mcu n'est jamais plus de 2^31 ticks d'horloge dans le futur ou le pass\u00e9, donc cette conversion n'est jamais ambigu\u00eb. L'h\u00f4te convertit les horloges de 64 bits en horloges de 32 bits en tronquant simplement les bits de poids fort. Pour s'assurer qu'il n'y a pas d'ambigu\u00eft\u00e9 dans cette conversion, le code klippy/chelper/serialqueue.c mettra en m\u00e9moire tampon les messages jusqu'\u00e0 ce qu'ils soient dans les 2^31 ticks d'horloge de leur temps cible. Microcontr\u00f4leurs multiples : Le logiciel h\u00f4te permet d'utiliser plusieurs microcontr\u00f4leurs sur une seule imprimante. Dans ce cas, l'\"horloge MCU\" de chaque microcontr\u00f4leur est suivie s\u00e9par\u00e9ment. Le code clocksync.py g\u00e8re la d\u00e9rive de l'horloge entre les micro-contr\u00f4leurs en modifiant la fa\u00e7on dont il convertit le \"temps d'impression\" en \"horloge MCU\". Sur les mcus secondaires, la fr\u00e9quence du mcu utilis\u00e9e dans cette conversion est r\u00e9guli\u00e8rement mise \u00e0 jour pour tenir compte de la d\u00e9rive mesur\u00e9e.","title":"Aper\u00e7u du code"},{"location":"Code_Overview.html#apercu-du-code","text":"Ce document d\u00e9crit la disposition g\u00e9n\u00e9rale du code et le flux de code principal de Klipper.","title":"Aper\u00e7u du code"},{"location":"Code_Overview.html#disposition-du-repertoire","text":"Le r\u00e9pertoire src/ contient les sources C du code du micro-contr\u00f4leur. Les r\u00e9pertoires src/atsam/ , src/atsamd/ , src/avr/ , src/linux/ , src/lpc176x/ , src/pru/ , et src/stm32/ contiennent le code du micro-contr\u00f4leur sp\u00e9cifique \u00e0 chaque architecture. Le r\u00e9pertoire src/simulator/ contient des \u00e9l\u00e9ments de remplacement de code permettant de tester la compilation du micro-contr\u00f4leur sur d'autres architectures. Le r\u00e9pertoire src/generic/ contient du code d'assistance utile sur diff\u00e9rentes architectures. La compilation fait en sorte que les inclusions de \"board/somefile.h\" soient d'abord recherch\u00e9es dans le r\u00e9pertoire de l'architecture courante (par exemple, src/avr/somefile.h) et ensuite dans le r\u00e9pertoire g\u00e9n\u00e9rique (par exemple, src/generic/somefile.h). Le r\u00e9pertoire klippy/ contient le logiciel h\u00f4te. La majorit\u00e9 du logiciel h\u00f4te est \u00e9crit en Python, cependant le r\u00e9pertoire klippy/chelper/ contient quelques assistants en code C. Le r\u00e9pertoire klippy/kinematics/ contient le code li\u00e9 \u00e0 la cin\u00e9matique du robot. Le r\u00e9pertoire klippy/extras/ contient les \"modules\" extensibles du code h\u00f4te. Le r\u00e9pertoire lib/ contient du code de biblioth\u00e8que externe de tierce partie n\u00e9cessaire \u00e0 la construction de certaines cibles. Le r\u00e9pertoire config/ contient des exemples de fichiers de configuration d'imprimante. Le r\u00e9pertoire scripts/ contient des scripts de construction utiles \u00e0 la compilation du code du micro-contr\u00f4leur. Le r\u00e9pertoire test/ contient des cas de tests automatis\u00e9s. Pendant la compilation, le constructeur peut cr\u00e9er un r\u00e9pertoire out/ . Celui-ci contient des objets temporaires de compilation. L'objet micro-contr\u00f4leur final qui est construit est out/klipper.elf.hex sur AVR et out/klipper.bin sur ARM.","title":"Disposition du r\u00e9pertoire"},{"location":"Code_Overview.html#flux-de-code-du-micro-controleur","text":"L'ex\u00e9cution du code du microcontr\u00f4leur d\u00e9bute dans le code sp\u00e9cifique \u00e0 l'architecture (par exemple, src/avr/main.c ) qui appelle finalement sched_main() situ\u00e9 dans src/sched.c . Le code sched_main() commence par ex\u00e9cuter toutes les fonctions marqu\u00e9es avec la macro DECL_INIT(). Il ex\u00e9cute ensuite de mani\u00e8re r\u00e9p\u00e9t\u00e9e toutes les fonctions marqu\u00e9es par la macro DECL_TASK(). L'une des principales fonctions de la t\u00e2che est command_dispatch() situ\u00e9e dans src/command.c . Cette fonction est appel\u00e9e \u00e0 partir du code d'entr\u00e9e/sortie sp\u00e9cifique \u00e0 la carte (par exemple, src/avr/serial.c , src/generic/serial_irq.c ) et elle ex\u00e9cute les fonctions de commande associ\u00e9es aux commandes trouv\u00e9es dans le flux d'entr\u00e9e. Les fonctions de commande sont d\u00e9clar\u00e9es \u00e0 l'aide de la macro DECL_COMMAND() (voir le document protocole pour plus d'informations). Les fonctions de t\u00e2che, d'initialisation et de commande s'ex\u00e9cutent toujours avec les interruptions activ\u00e9es (toutefois, elles peuvent d\u00e9sactiver temporairement les interruptions si n\u00e9cessaire). Ces fonctions doivent \u00e9viter les longues pauses, les retards, ou effectuer un travail qui dure un temps significatif. (Les longs retards de ces fonctions \"t\u00e2ches\" entra\u00eenent une gigue de programmation pour d'autres \"t\u00e2ches\" - les retards de plus de 100us peuvent devenir perceptibles, les retards de plus de 500us peuvent entra\u00eener des retransmissions de commandes, les retards de plus de 100ms peuvent entra\u00eener des red\u00e9marrages du chien de garde). Ces fonctions planifient le travail \u00e0 des moments pr\u00e9cis en programmant des minuteries. Les fonctions de temporisation sont programm\u00e9es en appelant sched_add_timer() (situ\u00e9 dans src/sched.c ). Le code du planificateur s'arrangera pour que la fonction donn\u00e9e soit appel\u00e9e au moment demand\u00e9. Les interruptions de temporisation sont initialement trait\u00e9es dans un gestionnaire d'interruption sp\u00e9cifique \u00e0 l'architecture (par exemple, src/avr/timer.c ) qui appelle sched_timer_dispatch() situ\u00e9 dans src/sched.c . L'interruption de la temporisation entra\u00eene l'ex\u00e9cution des fonctions de temporisation planifi\u00e9es. Les fonctions de temporisation sont toujours ex\u00e9cut\u00e9es avec des interruptions d\u00e9sactiv\u00e9es. Les fonctions de temporisation devraient toujours se terminer en quelques microsecondes. \u00c0 la fin de l'\u00e9v\u00e9nement de temporisation, la fonction peut choisir de se reprogrammer. En cas de d\u00e9tection d'erreur, le code peut invoquer shutdown() (une macro qui appelle sched_shutdown() situ\u00e9e dans src/sched.c ). L'appel \u00e0 shutdown() entra\u00eene l'ex\u00e9cution de toutes les fonctions marqu\u00e9es par la macro DECL_SHUTDOWN(). Les fonctions d'arr\u00eat s'ex\u00e9cutent toujours avec des interruptions d\u00e9sactiv\u00e9es. Une grande partie des fonctionnalit\u00e9s du micro-contr\u00f4leur implique de travailler avec des broches d'entr\u00e9e/sortie \u00e0 usage g\u00e9n\u00e9ral (GPIO). Afin de s\u00e9parer le code de bas niveau sp\u00e9cifique \u00e0 l'architecture du code de haut niveau de la t\u00e2che, tous les \u00e9v\u00e9nements GPIO sont impl\u00e9ment\u00e9s dans des emballages sp\u00e9cifiques \u00e0 l'architecture (par exemple, src/avr/gpio.c ). Le code est compil\u00e9 avec l'optimisation \"-flto -fwhole-program\" de gcc qui fait un excellent travail d'int\u00e9gration des fonctions \u00e0 travers les unit\u00e9s de compilation, ainsi la plupart de ces minuscules fonctions gpio sont int\u00e9gr\u00e9es \u00e0 leurs appelants, et il n'y a aucun co\u00fbt d'ex\u00e9cution \u00e0 les utiliser.","title":"Flux de code du micro-contr\u00f4leur"},{"location":"Code_Overview.html#apercu-du-code-klippy","text":"Le code h\u00f4te (Klippy) est destin\u00e9 \u00e0 fonctionner sur un ordinateur \u00e0 petit prix (tel qu'un Raspberry Pi) associ\u00e9 au microcontr\u00f4leur. Le code est principalement \u00e9crit en Python, cependant il utilise CFFI pour impl\u00e9menter certaines fonctionnalit\u00e9s en code C. L'ex\u00e9cution initiale commence dans klippy/klippy.py . Ceci lit les arguments de la ligne de commande, ouvre le fichier de configuration de l'imprimante, instancie les principaux objets de l'imprimante et lance la connexion s\u00e9rie. L'ex\u00e9cution principale des commandes G-code se fait dans la m\u00e9thode process_commands() de klippy/gcode.py . Ce code traduit les commandes G-code en appels d'objets d'imprimante fr\u00e9quemment traduis en commandes d'actions \u00e0 ex\u00e9cuter sur le micro-contr\u00f4leur (tel que d\u00e9clar\u00e9 via la macro DECL_COMMAND dans le code du micro-contr\u00f4leur). Il y a quatre threads dans le code h\u00f4te de Klippy. Le thread principal g\u00e8re les commandes gcode entrantes. Un deuxi\u00e8me thread (r\u00e9sidant enti\u00e8rement dans le code C klippy/chelper/serialqueue.c ) g\u00e8re les entr\u00e9es/sorties de bas niveau avec le port s\u00e9rie. Le troisi\u00e8me thread est utilis\u00e9 pour traiter les messages de r\u00e9ponse du micro-contr\u00f4leur dans le code Python (voir klippy/serialhdl.py ). Le quatri\u00e8me thread \u00e9crit les messages de d\u00e9bogage dans le journal (voir klippy/queuelogger.py ) afin que les autres threads ne bloquent jamais les \u00e9critures dans le journal.","title":"Aper\u00e7u du code Klippy"},{"location":"Code_Overview.html#flux-du-code-dune-commande-de-deplacement","text":"Un mouvement typique de l'imprimante commence lorsqu'une commande \"G1\" est envoy\u00e9e \u00e0 l'h\u00f4te Klippy et se termine lorsque les impulsions de pas correspondantes sont produites sur le micro-contr\u00f4leur. Cette section d\u00e9crit le flux du code d'une commande de d\u00e9placement typique. Le document cin\u00e9matiques fournit des informations suppl\u00e9mentaires sur la m\u00e9canique des mouvements. Le traitement d'une commande de d\u00e9placement commence dans gcode.py. Le but de gcode.py est de traduire le G-code en appels internes. Une commande G1 invoquera cmd_G1() dans klippy/extras/gcode_move.py. Le code gcode_move.py g\u00e8re les changements d'origine (par exemple, G92), les changements de positions relatives et absolues (par exemple, G90), et les changements d'unit\u00e9s (par exemple, F6000=100mm/s). Le chemin du code pour un d\u00e9placement est : _process_data() -> _process_commands() -> cmd_G1() . Finalement, la classe ToolHead est invoqu\u00e9e pour ex\u00e9cuter la demande r\u00e9elle : cmd_G1() -> ToolHead.move() La classe ToolHead (dans toolhead.py) g\u00e8re le \"look-ahead\" et suit la temporisation des actions d'impression. Le chemin du code principal pour un d\u00e9placement est : ToolHead.move() -> MoveQueue.add_move() -> MoveQueue.flush() -> Move.set_junction() -> ToolHead._process_moves() . ToolHead.move() cr\u00e9e un objet Move() avec les param\u00e8tres du d\u00e9placement (dans l'espace cart\u00e9sien et en unit\u00e9s de secondes et de millim\u00e8tres). La classe cin\u00e9matique a la possibilit\u00e9 de v\u00e9rifier chaque mouvement ( ToolHead.move() -> kin.check_move() ). Les classes cin\u00e9matiques sont situ\u00e9es dans le r\u00e9pertoire klippy/kinematics/. Le code check_move() peut lever une erreur si le d\u00e9placement n'est pas valide. Si check_move() se termine avec succ\u00e8s, alors la cin\u00e9matique sous-jacente doit \u00eatre capable de g\u00e9rer le d\u00e9placement. MoveQueue.add_move() place l'objet move dans la file d'attente \"look-ahead\". MoveQueue.flush() d\u00e9termine les vitesses de d\u00e9but et de fin de chaque mouvement. Move.set_junction() impl\u00e9mente le \"g\u00e9n\u00e9rateur de trap\u00e8ze\" sur un mouvement. Le \"g\u00e9n\u00e9rateur de trap\u00e8ze\" divise chaque mouvement en trois parties : une phase d'acc\u00e9l\u00e9ration constante, suivie d'une phase de vitesse constante, puis d'une phase de d\u00e9c\u00e9l\u00e9ration constante. Chaque d\u00e9placement contient ces trois phases dans cet ordre, certaines phases pouvant \u00eatre de dur\u00e9e nulle. Lorsque ToolHead._process_moves() est appel\u00e9, tout ce qui concerne le d\u00e9placement est connu : sa position de d\u00e9part, sa position d'arriv\u00e9e, son acc\u00e9l\u00e9ration, sa vitesse de d\u00e9part/de croisi\u00e8re/de fin, et la distance parcourue pendant l'acc\u00e9l\u00e9ration/la croisi\u00e8re/la d\u00e9c\u00e9l\u00e9ration. Toutes ces informations sont stock\u00e9es dans la classe Move() et sont dans l'espace cart\u00e9sien en unit\u00e9s de millim\u00e8tres et de secondes. Klipper utilise un solveur it\u00e9ratif afin de g\u00e9n\u00e9rer les d\u00e9lais des pas pour chaque moteur pas \u00e0 pas. Pour des raisons d'efficacit\u00e9, les d\u00e9lais d'impulsion des pas sont g\u00e9n\u00e9r\u00e9s en code C. Les mouvements sont d'abord plac\u00e9s dans une \"file d'attente de mouvements trap\u00e9zo\u00efdaux\" : ToolHead._process_moves() -> trapq_append() (dans klippy/chelper/trapq.c). Les d\u00e9lais de pas sont ensuite g\u00e9n\u00e9r\u00e9s : ToolHead._process_moves() -> ToolHead._update_move_time() -> MCU_Stepper.generate_steps() -> itersolve_generate_steps() -> itersolve_gen_steps_range() (dans klippy/chelper/itersolve.c). Le but du solveur it\u00e9ratif est de trouver les d\u00e9lais de pas \u00e0 partir d'une fonction calculant la position du moteur \u00e0 partir du temps. Ceci est fait en \"devinant\" de mani\u00e8re r\u00e9p\u00e9t\u00e9e plusieurs d\u00e9lais jusqu'\u00e0 ce que la formule de position du pas renvoie la position d\u00e9sir\u00e9e du pas suivant sur le moteur. Le retour d'information produit par chaque estimation est utilis\u00e9 afin d'am\u00e9liorer les estimations futures, de sorte que le processus converge rapidement vers le d\u00e9lai souhait\u00e9. Les formules de position cin\u00e9matique du moteur sont situ\u00e9es dans le r\u00e9pertoire klippy/chelper/ (par exemple, kin_cart.c, kin_corexy.c, kin_delta.c, kin_extruder.c). Notez que l'extrudeuse est g\u00e9r\u00e9e dans sa propre classe cin\u00e9matique : ToolHead._process_moves() -> PrinterExtruder.move() . Puisque la classe Move() sp\u00e9cifie le d\u00e9lai exact du mouvement et que les impulsions de pas sont envoy\u00e9es au micro-contr\u00f4leur avec un timing sp\u00e9cifique, les mouvements du moteur produits par la classe de l'extrudeuse seront synchronis\u00e9s avec le mouvement de la t\u00eate m\u00eame si le code est s\u00e9par\u00e9. Apr\u00e8s que le solveur it\u00e9ratif ait calcul\u00e9 les d\u00e9lais de pas, ils sont ajout\u00e9s \u00e0 un tableau : itersolve_gen_steps_range() -> stepcompress_append() (dans klippy/chelper/stepcompress.c). Le tableau (struct stepcompress.queue) stocke les dur\u00e9es correspondantes du compteur d'horloge du micro-contr\u00f4leur pour chaque \u00e9tape. Ici, la valeur du \"compteur d'horloge du micro-contr\u00f4leur\" correspond directement au compteur mat\u00e9riel du micro-contr\u00f4leur - elle est relative \u00e0 la derni\u00e8re mise sous tension du micro-contr\u00f4leur. La prochaine \u00e9tape majeure est de compresser les \u00e9tapes : stepcompress_flush() -> compress_bisect_add() (dans klippy/chelper/stepcompress.c). Ce code g\u00e9n\u00e8re et encode une s\u00e9rie de commandes \"queue_step\" du micro-contr\u00f4leur correspondant \u00e0 la liste des dur\u00e9es de pas du moteur construite \u00e0 l'\u00e9tape pr\u00e9c\u00e9dente. Ces commandes \"queue_step\" sont ensuite mises en file d'attente, hi\u00e9rarchis\u00e9es et envoy\u00e9es au micro-contr\u00f4leur (via stepcompress.c:steppersync et serialqueue.c:serialqueue). Le traitement des commandes queue_step sur le micro-contr\u00f4leur commence dans src/command.c qui analyse la commande et appelle command_queue_step() . Le code command_queue_step() (dans src/stepper.c) ajoute simplement les param\u00e8tres de chaque commande queue_step \u00e0 une file d'attente par moteur. En fonctionnement normal, la commande queue_step est analys\u00e9e et mise en file d'attente au moins 100ms avant le moment de son premier pas. Enfin, la g\u00e9n\u00e9ration des \u00e9v\u00e9nements de pas du moteur est faite dans stepper_event() . Elle est appel\u00e9e depuis l'interruption du compteur mat\u00e9riel \u00e0 l'heure pr\u00e9vue du premier pas. Le code stepper_event() g\u00e9n\u00e8re une impulsion de pas et se reprogramme ensuite pour s'ex\u00e9cuter au moment de l'impulsion de pas suivante pour les param\u00e8tres queue_step donn\u00e9s. Les param\u00e8tres pour chaque commande queue_step sont \"interval\", \"count\", et \"add\". A un haut niveau, stepper_event() ex\u00e9cute la commande suivante, 'count' fois : do_step() ; next_wake_time = last_wake_time + interval ; interval += add; Ce qui pr\u00e9c\u00e8de peut sembler beaucoup de complexit\u00e9 pour l'ex\u00e9cution d'un mouvement. Cependant, les seules parties vraiment int\u00e9ressantes se trouvent dans les classes ToolHead et kinematic. C'est cette partie du code qui pr\u00e9cise les mouvements et leurs dur\u00e9es. Les autres parties du traitement sont essentiellement de la communication et de la plomberie.","title":"Flux du code d'une commande de d\u00e9placement"},{"location":"Code_Overview.html#ajout-dun-module-hote","text":"Le code h\u00f4te de Klippy a une capacit\u00e9 de chargement dynamique de modules. Si une section de configuration nomm\u00e9e \"[mon_module]\" est trouv\u00e9e dans le fichier de configuration de l'imprimante, le logiciel tentera automatiquement de charger le module python klippy/extras/mon_module.py . Ce syst\u00e8me de modules est la m\u00e9thode pr\u00e9f\u00e9r\u00e9e pour ajouter de nouvelles fonctionnalit\u00e9s \u00e0 Klipper. La fa\u00e7on la plus simple d'ajouter un nouveau module est d'utiliser un module existant comme r\u00e9f\u00e9rence - voir klippy/extras/servo.py comme exemple. Les \u00e9l\u00e9ments suivants peuvent \u00e9galement \u00eatre utiles : L'ex\u00e9cution du module commence dans la fonction load_config() au niveau du module (pour les sections de configuration de la forme [mon_module]) ou dans load_config_prefix() (pour les sections de configuration de la forme [mon_module mon_nom]). On passe \u00e0 cette fonction un objet \"config\" et elle doit retourner un nouvel \"objet imprimante\" associ\u00e9 \u00e0 la section de configuration donn\u00e9e. Durant le processus d'instanciation d'un nouvel objet imprimante, l'objet config peut \u00eatre utilis\u00e9 pour lire les param\u00e8tres de la section config donn\u00e9e. Ceci est fait en utilisant les m\u00e9thodes config.get() , config.getfloat() , config.getint() , etc. Assurez-vous de lire toutes les valeurs de la configuration pendant la construction de l'objet imprimante - si l'utilisateur sp\u00e9cifie un param\u00e8tre de configuration qui n'est pas lu pendant cette phase, il sera suppos\u00e9 qu'il s'agit d'une faute de frappe dans la configuration et une erreur sera lev\u00e9e. Utilisez la m\u00e9thode config.get_printer() pour obtenir une r\u00e9f\u00e9rence \u00e0 la classe principale \"printer\". Cette classe \"printer\" stocke les r\u00e9f\u00e9rences de tous les \"objets imprimante\" instanci\u00e9s. Utilisez la m\u00e9thode printer.lookup_object() pour trouver des r\u00e9f\u00e9rences \u00e0 d'autres objets imprimante. Presque toutes les fonctionnalit\u00e9s (m\u00eame les modules cin\u00e9matiques de base) sont encapsul\u00e9es dans un de ces objets imprimante. Notez, cependant, que lorsqu'un nouveau module est instanci\u00e9, tous les autres objets d'impression n'auront pas encore \u00e9t\u00e9 instanci\u00e9s. Les modules \"gcode\" et \"pins\" seront toujours disponibles, mais pour les autres modules, il est pr\u00e9f\u00e9rable de diff\u00e9rer la recherche. Enregistrez les gestionnaires d'\u00e9v\u00e9nements en utilisant la m\u00e9thode printer.register_event_handler() si le code doit \u00eatre appel\u00e9 lors d'\"\u00e9v\u00e9nements\" d\u00e9clench\u00e9s par d'autres objets imprimante. Chaque nom d'\u00e9v\u00e9nement est une cha\u00eene de caract\u00e8res, et par convention, c'est le nom du module source principal d\u00e9clenchant l'\u00e9v\u00e9nement avec un nom court pour l'action produite (par exemple, \"klippy:connect\"). Les param\u00e8tres pass\u00e9s \u00e0 chaque gestionnaire d'\u00e9v\u00e9nement sont sp\u00e9cifiques \u00e0 l'\u00e9v\u00e9nement en question (tout comme le traitement des exceptions et le contexte d'ex\u00e9cution). Deux \u00e9v\u00e9nements de d\u00e9marrage courants sont : klippy:connect - Cet \u00e9v\u00e9nement est g\u00e9n\u00e9r\u00e9 apr\u00e8s l'instanciation de tous les objets imprimante. Il est couramment utilis\u00e9 pour rechercher d'autres objets imprimante, pour v\u00e9rifier les param\u00e8tres de configuration et pour effectuer une premi\u00e8re \"prise de contact\" avec le mat\u00e9riel de l'imprimante. klippy:ready - Cet \u00e9v\u00e9nement est g\u00e9n\u00e9r\u00e9 apr\u00e8s que tous les gestionnaires de connexion se soient termin\u00e9s avec succ\u00e8s. Il indique que l'imprimante est en train de passer \u00e0 l'\u00e9tat pr\u00eat \u00e0 g\u00e9rer les op\u00e9rations normales. Ne d\u00e9clenchez pas d'erreur dans ce rappel. S'il y a une erreur dans la configuration de l'utilisateur, assurez-vous de la signaler pendant les phases load_config() ou \"connect event\". Utilisez soit raise config.error(\"mon erreur\") soit raise printer.config_error(\"mon erreur\") pour signaler l'erreur. Utilisez le module \"pins\" pour configurer une broche sur un micro-contr\u00f4leur. Ceci est typiquement fait avec quelque chose de similaire \u00e0 printer.lookup_object(\"pins\").setup_pin(\"pwm\", config.get(\"my_pin\")) . L'objet retourn\u00e9 peut alors \u00eatre command\u00e9 au moment de l'ex\u00e9cution. Si l'objet imprimante d\u00e9finit une m\u00e9thode get_status() , le module peut exporter des informations d'\u00e9tat via des macros et via le serveur API . La m\u00e9thode get_status() doit retourner un dictionnaire Python dont les cl\u00e9s sont des cha\u00eenes de caract\u00e8res et les valeurs des entiers, des flottants, des cha\u00eenes de caract\u00e8res, des listes, des dictionnaires, True, False ou None. Les tuples (et les tuples nomm\u00e9s) peuvent \u00e9galement \u00eatre utilis\u00e9s (ils apparaissent comme des listes lorsqu'on y acc\u00e8de via le serveur API). Les listes et les dictionnaires export\u00e9s doivent \u00eatre trait\u00e9s comme \"immuables\" - si leur contenu change, un nouvel objet doit \u00eatre renvoy\u00e9 par get_status() , sinon le serveur API ne d\u00e9tectera pas ces changements. Si le module doit acc\u00e9der \u00e0 la temporisation du syst\u00e8me ou \u00e0 des descripteurs de fichiers externes, utilisez printer.get_reactor() pour obtenir l'acc\u00e8s \u00e0 la classe globale \"event reactor\". Cette classe de r\u00e9acteur permet de programmer des temporisations, d'attendre des entr\u00e9es sur des descripteurs de fichiers, et d'\"endormir\" le code h\u00f4te. N'utilisez pas de variables globales. Tous les \u00e9tats doivent \u00eatre stock\u00e9s dans l'objet imprimante renvoy\u00e9 par la fonction load_config() . Ceci est important car sinon la commande RESTART pourrait ne pas fonctionner comme pr\u00e9vu. De m\u00eame, pour des raisons similaires, si des fichiers externes (ou des sockets) sont ouverts, assurez-vous d'enregistrer un gestionnaire d'\u00e9v\u00e9nement \"klippy:disconnect\" et de les fermer \u00e0 partir de ce rappel. \u00c9vitez d'acc\u00e9der aux variables membres internes (ou d'appeler les m\u00e9thodes commen\u00e7ant par un trait de soulignement) d'autres objets imprimante. Le respect de cette convention facilite la gestion des modifications futures. Il est recommand\u00e9 d'attribuer une valeur \u00e0 toutes les variables membres dans le constructeur Python des classes Python. (Et donc d'\u00e9viter d'utiliser la capacit\u00e9 de Python \u00e0 cr\u00e9er dynamiquement de nouvelles variables membres.) Si une variable Python doit stocker une valeur en virgule flottante, il est recommand\u00e9 de toujours affecter et manipuler cette variable avec des constantes en virgule flottante (et de ne jamais utiliser de constantes enti\u00e8res). Par exemple, pr\u00e9f\u00e9rez self.speed = 1. \u00e0 self.speed = 1 , et pr\u00e9f\u00e9rez self.speed = 2. * x plut\u00f4t que self.speed = 2 * x . L'utilisation coh\u00e9rente des valeurs \u00e0 virgule flottante peut \u00e9viter des bizarreries difficiles \u00e0 d\u00e9boguer dans les conversions de types Python. Si vous soumettez le module pour qu'il soit inclus dans le code principal de Klipper, veillez \u00e0 placer un avis de copyright en haut du module. Consultez les modules existants pour conna\u00eetre le format pr\u00e9f\u00e9r\u00e9.","title":"Ajout d'un module h\u00f4te"},{"location":"Code_Overview.html#ajout-de-nouvelles-cinematiques","text":"Cette section fournit quelques conseils pour ajouter le support \u00e0 Klipper de types suppl\u00e9mentaires de cin\u00e9matiques d'imprimante. Ce type d'activit\u00e9 n\u00e9cessite une excellente compr\u00e9hension des formules math\u00e9matiques de la cin\u00e9matique cible. Elle requiert \u00e9galement des comp\u00e9tences en mati\u00e8re de d\u00e9veloppement de logiciels, m\u00eame s'il suffit de mettre \u00e0 jour le logiciel h\u00f4te. Les \u00e9tapes utiles : Commencez par \u00e9tudier la section \" code de flux d'un mouvement \" et le document cin\u00e9matiques . Passez en revue les classes cin\u00e9matiques existantes dans le r\u00e9pertoire klippy/kinematics/. Les classes cin\u00e9matiques sont charg\u00e9es de convertir le mouvement en coordonn\u00e9es cart\u00e9siennes en un mouvement sur chaque moteur. On devrait \u00eatre capable de copier un de ces fichiers comme point de d\u00e9part. Impl\u00e9mentez les fonctions de position cin\u00e9matique du moteur en C pour chaque moteur si elles ne sont pas d\u00e9j\u00e0 disponibles (voir kin_cart.c, kin_corexy.c, et kin_delta.c dans klippy/chelper/). La fonction doit appeler move_get_coord() pour convertir une dur\u00e9e de d\u00e9placement donn\u00e9e (en secondes) en coordonn\u00e9es cart\u00e9siennes (en millim\u00e8tres), et ensuite calculer la position souhait\u00e9e du moteur (en millim\u00e8tres) \u00e0 partir de ces coordonn\u00e9es cart\u00e9siennes. Impl\u00e9mentez la m\u00e9thode calc_position() dans la nouvelle classe cin\u00e9matique. Cette m\u00e9thode calcule la position de la t\u00eate de l'outil en coordonn\u00e9es cart\u00e9siennes \u00e0 partir de la position de chaque moteur. Elle n'a pas besoin d'\u00eatre efficace car elle n'est typiquement appel\u00e9e que pendant les op\u00e9rations de mise \u00e0 l'origine et de palpage. Autres m\u00e9thodes. Impl\u00e9mentez les m\u00e9thodes check_move() , get_status() , get_steppers() , home() , et set_position() . Ces fonctions sont typiquement utilis\u00e9es pour fournir des v\u00e9rifications sp\u00e9cifiques \u00e0 la cin\u00e9matique. Cependant, au d\u00e9but du d\u00e9veloppement, on peut utiliser du code passe-partout ici. Impl\u00e9menter des cas de test. Cr\u00e9ez un fichier g-code avec une s\u00e9rie de mouvements pouvant tester des cas importants pour la cin\u00e9matique donn\u00e9e. Suivez la documentation de d\u00e9bogage pour convertir ce fichier g-code en commandes de micro-contr\u00f4leur. Ceci est utile pour tester les cas extr\u00eames et v\u00e9rifier les r\u00e9gressions.","title":"Ajout de nouvelles cin\u00e9matiques"},{"location":"Code_Overview.html#portage-sur-un-nouveau-microcontroleur","text":"Cette section fournit quelques conseils sur le portage du code du microcontr\u00f4leur de Klipper vers une nouvelle architecture. Ce type d'activit\u00e9 n\u00e9cessite une bonne connaissance du d\u00e9veloppement embarqu\u00e9 et un acc\u00e8s pratique au microcontr\u00f4leur cible. Les \u00e9tapes utiles : Commencez par identifier toutes les biblioth\u00e8ques tierces qui seront utilis\u00e9es pendant le portage. Les exemples courants incluent les wrappers \"CMSIS\" et les biblioth\u00e8ques \"HAL\" des fabricants. Tout code tiers doit \u00eatre compatible avec la licence GNU GPLv3. Le code tiers doit \u00eatre livr\u00e9 dans le r\u00e9pertoire Klipper lib/. Mettez \u00e0 jour le fichier lib/README en indiquant o\u00f9 et quand la biblioth\u00e8que a \u00e9t\u00e9 obtenue. Il est pr\u00e9f\u00e9rable de copier le code dans le d\u00e9p\u00f4t Klipper sans modification, mais si des modifications sont n\u00e9cessaires, elles doivent \u00eatre indiqu\u00e9es explicitement dans le fichier lib/README. Cr\u00e9er un nouveau sous-r\u00e9pertoire d'architecture dans le r\u00e9pertoire src/ et ajouter le support initial de Kconfig et Makefile. Utilisez les architectures existantes comme guide. Le simulateur src/simulator fournit un exemple de base pour un point de d\u00e9part minimal. La premi\u00e8re t\u00e2che principale de codage est d'apporter le support de communication \u00e0 la carte cible. C'est l'\u00e9tape la plus difficile dans un nouveau portage. Une fois que la communication de base fonctionne, les autres \u00e9tapes ont tendance \u00e0 \u00eatre beaucoup plus faciles. Il est typique d'utiliser un dispositif s\u00e9rie de type UART pendant le d\u00e9veloppement initial car ces types de dispositifs mat\u00e9riels sont g\u00e9n\u00e9ralement plus faciles \u00e0 activer et \u00e0 contr\u00f4ler. Pendant cette phase, faites un usage lib\u00e9ral du code d'aide du r\u00e9pertoire src/generic/ (v\u00e9rifiez comment src/simulator/Makefile inclut le code C g\u00e9n\u00e9rique dans la compilation). Il est \u00e9galement n\u00e9cessaire de d\u00e9finir timer_read_time() (qui renvoie l'horloge syst\u00e8me actuelle) dans cette phase, mais il n'est pas n\u00e9cessaire de supporter compl\u00e8tement la gestion des irq des timers. Familiarisez-vous avec l'outil console.py (comme d\u00e9crit dans le document de d\u00e9bogage ) et v\u00e9rifiez la connectivit\u00e9 au microcontr\u00f4leur avec cet outil. Cet outil traduit le protocole de communication de bas niveau du microcontr\u00f4leur en une forme lisible par l'homme. Ajouter le support pour la distribution des timers \u00e0 partir des interruptions mat\u00e9rielles. Voir Klipper commit 970831ee comme exemple des \u00e9tapes 1-5 r\u00e9alis\u00e9es pour l'architecture LPC176x. Apporter le support de base des entr\u00e9es et sorties GPIO. Voir Klipper commit c78b9076 comme exemple. Faire appara\u00eetre des p\u00e9riph\u00e9riques suppl\u00e9mentaires - par exemple, voir Klipper commit 65613aed , c812a40a , et c381d03a . Cr\u00e9ez un exemple de fichier de configuration Klipper dans le r\u00e9pertoire config/. Testez le micro-contr\u00f4leur avec le programme principal klippy.py. Pensez \u00e0 ajouter des cas de test de construction dans le r\u00e9pertoire test/. Conseils suppl\u00e9mentaires pour le codage : \u00c9vitez d'utiliser des \"champs de bits C\" pour acc\u00e9der aux registres d'E/S ; pr\u00e9f\u00e9rez les op\u00e9rations directes de lecture et d'\u00e9criture d'entiers de 32, 16 ou 8 bits. Les sp\u00e9cifications du langage C ne pr\u00e9cisent pas clairement comment le compilateur doit impl\u00e9menter les champs de bits C (par exemple, l'endianness et la disposition des bits), et il est difficile de d\u00e9terminer quelles op\u00e9rations d'E/S se produiront lors de la lecture ou de l'\u00e9criture d'un champ de bits C. Pr\u00e9f\u00e9rez l'\u00e9criture de valeurs explicites dans les registres d'E/S \u00e0 l'utilisation d'op\u00e9rations de lecture-modification-\u00e9criture. Autrement dit, si l'on met \u00e0 jour un champ dans un registre d'E/S dont les autres champs ont des valeurs connues, il est pr\u00e9f\u00e9rable d'\u00e9crire explicitement le contenu complet du registre. Les \u00e9critures explicites produisent un code plus petit, plus rapide et plus facile \u00e0 d\u00e9boguer.","title":"Portage sur un nouveau microcontr\u00f4leur"},{"location":"Code_Overview.html#les-systemes-de-coordonnees","text":"En interne, Klipper suit principalement la position de la t\u00eate de l'outil en coordonn\u00e9es cart\u00e9siennes relatives au syst\u00e8me de coordonn\u00e9es sp\u00e9cifi\u00e9 dans le fichier de configuration. C'est-\u00e0-dire que la plupart du code de Klipper ne conna\u00eetra jamais de changement de syst\u00e8me de coordonn\u00e9es. Si l'utilisateur fait une demande pour changer l'origine (par exemple, une commande G92 ) alors cet effet est obtenu en traduisant les commandes futures vers le syst\u00e8me de coordonn\u00e9es primaires. Cependant, dans certains cas, il est utile d'obtenir la position de la t\u00eate de l'outil dans un autre syst\u00e8me de coordonn\u00e9es et Klipper dispose de plusieurs outils pour faciliter cela. Vous pouvez le constater en ex\u00e9cutant la commande GET_POSITION. Par exemple : Send: GET_POSITION Recv: // mcu: stepper_a:-2060 stepper_b:-1169 stepper_c:-1613 Recv: // stepper: stepper_a:457.254159 stepper_b:466.085669 stepper_c:465.382132 Recv: // kinematic: X:8.339144 Y:-3.131558 Z:233.347121 Recv: // toolhead: X:8.338078 Y:-3.123175 Z:233.347878 E:0.000000 Recv: // gcode: X:8.338078 Y:-3.123175 Z:233.347878 E:0.000000 Recv: // gcode base: X:0.000000 Y:0.000000 Z:0.000000 E:0.000000 Recv: // gcode homing: X:0.000000 Y:0.000000 Z:0.000000 La position \"mcu\" ( stepper.get_mcu_position() dans le code) est le nombre total de pas que le micro-contr\u00f4leur a \u00e9mis dans un sens positif moins le nombre de pas \u00e9mis dans un sens n\u00e9gatif depuis la derni\u00e8re r\u00e9initialisation du micro-contr\u00f4leur. Si le robot est en mouvement lorsque la requ\u00eate est \u00e9mise, la valeur rapport\u00e9e inclut les mouvements mis en m\u00e9moire tampon dans le microcontr\u00f4leur, mais pas les mouvements de la file d'attente de surveillance. La position \"stepper\" ( stepper.get_commanded_position() ) est la position du moteur donn\u00e9 telle qu'elle est suivie par le code cin\u00e9matique. Cela correspond g\u00e9n\u00e9ralement \u00e0 la position (en mm) du chariot le long de son rail, par rapport \u00e0 la position_endstop indiqu\u00e9e dans le fichier de configuration. (Si le robot est en mouvement lorsque la requ\u00eate est \u00e9mise, la valeur rapport\u00e9e inclut les mouvements mis en m\u00e9moire tampon sur le micro-contr\u00f4leur, mais n'inclut pas les mouvements de la file d'attente look-ahead. On peut utiliser les appels toolhead.flush_step_generation() ou toolhead.wait_moves() pour vider compl\u00e8tement les codes de look-ahead et de g\u00e9n\u00e9ration de pas. La position \"kinematic\" ( kin.calc_position() ) est la position cart\u00e9sienne de la t\u00eate de l'outil telle que d\u00e9riv\u00e9e des positions \"pas \u00e0 pas\" et est relative au syst\u00e8me de coordonn\u00e9es sp\u00e9cifi\u00e9 dans le fichier de configuration. Cela peut diff\u00e9rer de la position cart\u00e9sienne demand\u00e9e en raison de la granularit\u00e9 des moteurs pas \u00e0 pas. Si le robot est en mouvement lorsque les positions \"stepper\" sont prises, la valeur rapport\u00e9e inclut les mouvements mis en m\u00e9moire tampon sur le micro-contr\u00f4leur, mais n'inclut pas les mouvements de la file d'attente look-ahead. On peut utiliser les appels toolhead.flush_step_generation() ou toolhead.wait_moves() pour vider compl\u00e8tement le code de look-ahead et de g\u00e9n\u00e9ration de pas. La position de la t\u00eate d'outil ( toolhead.get_position() ) est la derni\u00e8re position demand\u00e9e de la t\u00eate d'outil en coordonn\u00e9es cart\u00e9siennes par rapport au syst\u00e8me de coordonn\u00e9es sp\u00e9cifi\u00e9 dans le fichier de configuration. Si le robot est en mouvement lorsque la requ\u00eate est \u00e9mise, la valeur rapport\u00e9e inclut tous les d\u00e9placements demand\u00e9s (m\u00eame ceux dans les tampons en attente d'\u00eatre \u00e9mis vers les pilotes de moteurs pas \u00e0 pas). La position \"gcode\" est la derni\u00e8re position demand\u00e9e par une commande G1 (ou G0 ) en coordonn\u00e9es cart\u00e9siennes par rapport au syst\u00e8me de coordonn\u00e9es sp\u00e9cifi\u00e9 dans le fichier de configuration. Elle peut diff\u00e9rer de la position \"toolhead\" si une transformation g-code (par exemple, bed_mesh, bed_tilt, skew_correction) est en cours. Cela peut diff\u00e9rer des coordonn\u00e9es r\u00e9elles sp\u00e9cifi\u00e9es dans la derni\u00e8re commande G1 si l'origine du gcode a \u00e9t\u00e9 modifi\u00e9e (par exemple, G92 , SET_GCODE_OFFSET , M221 ). La commande M114 ( gcode_move.get_status()['gcode_position'] ) indiquera la derni\u00e8re position du g-code par rapport au syst\u00e8me de coordonn\u00e9es actuel du g-code. La \"base gcode\" est l'emplacement de l'origine du g-code en coordonn\u00e9es cart\u00e9siennes par rapport au syst\u00e8me de coordonn\u00e9es sp\u00e9cifi\u00e9 dans le fichier de configuration. Les commandes telles que G92 , SET_GCODE_OFFSET , et M221 modifient cette valeur. Le \"gcode homing\" est l'emplacement \u00e0 utiliser pour l'origine du g-code (en coordonn\u00e9es cart\u00e9siennes par rapport au syst\u00e8me de coordonn\u00e9es sp\u00e9cifi\u00e9 dans le fichier de configuration) apr\u00e8s une commande de mise \u00e0 l'origine G28 . La commande SET_GCODE_OFFSET peut modifier cette valeur.","title":"Les syst\u00e8mes de coordonn\u00e9es"},{"location":"Code_Overview.html#temporisation","text":"La manipulation des horloges, des dur\u00e9es et des horodatages est fondamentale pour le fonctionnement de Klipper. Celui-ci ex\u00e9cute des actions sur l'imprimante en programmant des \u00e9v\u00e9nements qui se produiront dans un avenir proche. Par exemple, pour allumer un ventilateur, le code peut programmer un changement sur une broche GPIO dans 100 ms. Il est rare que le code tente d'effectuer une action instantan\u00e9e. Ainsi, la gestion du temps dans Klipper est essentielle pour un fonctionnement correct. Il existe trois types de temporisations suivis en interne dans le logiciel h\u00f4te Klipper : Heure du syst\u00e8me. L'heure syst\u00e8me utilise l'horloge du syst\u00e8me - c'est un nombre \u00e0 virgule flottante stock\u00e9 sous forme de secondes (g\u00e9n\u00e9ralement) relatif \u00e0 la date du dernier d\u00e9marrage de l'ordinateur h\u00f4te. Les temps syst\u00e8me ont un usage limit\u00e9 dans le logiciel - ils sont principalement utilis\u00e9s lors de l'interaction avec le syst\u00e8me d'exploitation. Dans le code h\u00f4te, les heures syst\u00e8me sont souvent stock\u00e9es dans des variables nomm\u00e9es eventtime ou curtime . Temps d'impression. Le temps d'impression est synchronis\u00e9 avec l'horloge du micro-contr\u00f4leur principal (le micro-contr\u00f4leur d\u00e9fini dans la section \"[mcu]\" de la configuration). C'est un nombre \u00e0 virgule flottante stock\u00e9 en secondes relatif \u00e0 la date du dernier red\u00e9marrage du micro-contr\u00f4leur principal. Il est possible de convertir un \"temps d'impression\" en horloge mat\u00e9rielle du micro-contr\u00f4leur principal en multipliant le temps d'impression par le taux de fr\u00e9quence du mcu configur\u00e9 statiquement. Le code h\u00f4te de haut niveau utilise les temps d'impression pour calculer presque toutes les actions physiques (par exemple, le mouvement de la t\u00eate, les changements de chauffage, etc.) Dans le code h\u00f4te, les temps d'impression sont g\u00e9n\u00e9ralement stock\u00e9s dans des variables nomm\u00e9es print_time ou move_time . Horloge MCU. Il s'agit du compteur d'horloge mat\u00e9riel de chaque micro-contr\u00f4leur. Il est stock\u00e9 sous forme d'un nombre entier et son taux de mise \u00e0 jour est relatif \u00e0 la fr\u00e9quence du micro-contr\u00f4leur donn\u00e9. Le logiciel h\u00f4te convertit ses temps internes en horloges avant de les transmettre \u00e0 l'unit\u00e9 centrale. Le code de l'unit\u00e9 centrale de traitement ne suit jamais le temps qu'en ticks d'horloge. Dans le code h\u00f4te, les valeurs d'horloge sont suivies sous forme d'entiers de 64 bits, alors que le code de l'unit\u00e9 centrale utilise des entiers de 32 bits. Dans le code h\u00f4te, les horloges sont g\u00e9n\u00e9ralement stock\u00e9es dans des variables dont les noms contiennent clock ou ticks . La conversion entre les diff\u00e9rents formats de temps est principalement impl\u00e9ment\u00e9e dans le code klippy/clocksync.py . Quelques \u00e9l\u00e9ments \u00e0 prendre en compte lors de la r\u00e9vision du code : Horloges 32bit et 64bit : Pour r\u00e9duire la bande passante et am\u00e9liorer l'efficacit\u00e9 du micro-contr\u00f4leur, les horloges sur le micro-contr\u00f4leur sont suivies comme des entiers 32bit. Lors de la comparaison de deux horloges dans le code mcu, la fonction timer_is_before() doit toujours \u00eatre utilis\u00e9e pour s'assurer que les renversements d'entiers sont trait\u00e9s correctement. Le logiciel h\u00f4te convertit les horloges 32bit en horloges 64bit en ajoutant les bits de poids fort du dernier timestamp mcu qu'il a re\u00e7u - aucun message du mcu n'est jamais plus de 2^31 ticks d'horloge dans le futur ou le pass\u00e9, donc cette conversion n'est jamais ambigu\u00eb. L'h\u00f4te convertit les horloges de 64 bits en horloges de 32 bits en tronquant simplement les bits de poids fort. Pour s'assurer qu'il n'y a pas d'ambigu\u00eft\u00e9 dans cette conversion, le code klippy/chelper/serialqueue.c mettra en m\u00e9moire tampon les messages jusqu'\u00e0 ce qu'ils soient dans les 2^31 ticks d'horloge de leur temps cible. Microcontr\u00f4leurs multiples : Le logiciel h\u00f4te permet d'utiliser plusieurs microcontr\u00f4leurs sur une seule imprimante. Dans ce cas, l'\"horloge MCU\" de chaque microcontr\u00f4leur est suivie s\u00e9par\u00e9ment. Le code clocksync.py g\u00e8re la d\u00e9rive de l'horloge entre les micro-contr\u00f4leurs en modifiant la fa\u00e7on dont il convertit le \"temps d'impression\" en \"horloge MCU\". Sur les mcus secondaires, la fr\u00e9quence du mcu utilis\u00e9e dans cette conversion est r\u00e9guli\u00e8rement mise \u00e0 jour pour tenir compte de la d\u00e9rive mesur\u00e9e.","title":"Temporisation"},{"location":"Command_Templates.html","text":"Mod\u00e8les de commandes \u00b6 Ce document fournit des informations sur l'impl\u00e9mentation des s\u00e9quences de commandes G-Code dans les sections de configuration gcode_macro (et similaires). Nommage des macros de G-code \u00b6 La casse n'est pas importante pour le nom de la macro G-Code - MA_MACRO et ma_macro \u00e9valueront la m\u00eame chose et peuvent \u00eatre appel\u00e9es en majuscules ou en minuscules. Si des nombres sont utilis\u00e9s dans le nom de la macro, ils doivent tous se trouver \u00e0 la fin du nom (par exemple, TEST_MACRO25 est valide, mais MACRO25_TEST3 ne l'est pas). Formatage du G-Code dans la config \u00b6 L'indentation est importante lors de la d\u00e9finition d'une macro dans le fichier de configuration. Pour sp\u00e9cifier une s\u00e9quence G-Code multiligne, il est important que chaque ligne ait une indentation appropri\u00e9e. Par exemple\u202f: [gcode_macro blink_led] gcode: SET_PIN PIN=my_led VALUE=1 G4 P2000 SET_PIN PIN=my_led VALUE=0 L'option de configuration gcode: commence toujours au d\u00e9but de la ligne et les lignes suivantes de la macro G-Code ne commencent jamais au d\u00e9but. Ajouter une description \u00e0 votre macro \u00b6 Pour vous aider \u00e0 identifier la fonctionnalit\u00e9, une courte description peut \u00eatre ajout\u00e9e. Ajoutez description\u202f: avec un texte court pour d\u00e9crire la fonctionnalit\u00e9. La valeur par d\u00e9faut est \"Macro G-Code\". Par exemple\u202f: [gcode_macro blink_led] description: Blink my_led one time gcode: SET_PIN PIN=my_led VALUE=1 G4 P2000 SET_PIN PIN=my_led VALUE=0 Le terminal affichera la description lorsque vous utiliserez la commande HELP ou la fonction de saisie semi-automatique. Enregistrer/Restaurer l'\u00e9tat pour les d\u00e9placements G-Code \u00b6 Le langage de commande G-Code peut \u00eatre difficile \u00e0 utiliser. Le m\u00e9canisme standard pour d\u00e9placer la t\u00eate d'outil se fait via la commande G1 (la commande G0 est un alias pour G1 et elle peut \u00eatre utilis\u00e9e \u00e0 la place de G1 et inversement). Cependant, cette commande repose sur la configuration \"G-Code parsing state\" d\u00e9finie par M82 , M83 , G90 , G91 , G92 et les commandes pr\u00e9c\u00e9dentes G1 . Lors de la cr\u00e9ation d'une macro G-Code, il est conseill\u00e9 de toujours d\u00e9finir explicitement l'\u00e9tat d'analyse du G-Code avant d'\u00e9mettre une commande G1 . (Sinon, il y a un risque que la commande G1 fasse une demande ind\u00e9sirable.) Une fa\u00e7on courante d'y parvenir consiste \u00e0 encapsuler les mouvements G1 avec SAVE_GCODE_STATE , G91 et RESTORE_GCODE_STATE . Par exemple\u202f: [gcode_macro MOVE_UP] gcode: SAVE_GCODE_STATE NAME=my_move_up_state G91 G1 Z10 F300 RESTORE_GCODE_STATE NAME=my_move_up_state La commande G91 place l'\u00e9tat d'analyse du G-Code en \"mode de d\u00e9placement relatif\" et la commande RESTORE_GCODE_STATE restaure l'\u00e9tat tel qu'il \u00e9tait avant d'entrer dans la macro. Veillez \u00e0 sp\u00e9cifier une vitesse explicite (via le param\u00e8tre F ) sur la premi\u00e8re commande G1 . Extension du mod\u00e8le \u00b6 La section de configuration gcode_macro gcode: est \u00e9valu\u00e9e \u00e0 l'aide du langage Jinja2. On peut \u00e9valuer des expressions au moment de l'ex\u00e9cution en les entourant des caract\u00e8res { } ou utiliser des instructions conditionnelles avec des commande entour\u00e9es par {% %} . Voir la documentation Jinja2 pour plus d'informations sur la syntaxe. Un exemple de macro complexe : [gcode_macro clean_nozzle] gcode: {% set wipe_count = 8 %} SAVE_GCODE_STATE NAME=clean_nozzle_state G90 G0 Z15 F300 {% for wipe in range(wipe_count) %} {% for coordinate in [(275, 4),(235, 4)] %} G0 X{coordinate[0]} Y{coordinate[1] + 0.25 * wipe} Z9.7 F12000 {% endfor %} {% endfor %} RESTORE_GCODE_STATE NAME=clean_nozzle_state Param\u00e8tres de macro \u00b6 Il est souvent utile d'inspecter les param\u00e8tres pass\u00e9s \u00e0 la macro lorsqu'elle est appel\u00e9e. Ces param\u00e8tres sont disponibles via la pseudo-variable params . Par exemple, si la macro : [gcode_macro SET_PERCENT] gcode: M117 Now at { params.VALUE|float * 100 }% a \u00e9t\u00e9 appel\u00e9 avec SET_PERCENT VALUE=.2 , il sera \u00e9valu\u00e9 \u00e0 M117 Maintenant \u00e0 20 % . Les noms de param\u00e8tres sont toujours en majuscules lorsqu'ils sont \u00e9valu\u00e9s dans la macro et sont toujours transmis sous forme de cha\u00eenes. Si vous effectuez des calculs, ils doivent \u00eatre explicitement convertis en nombres entiers ou flottants. Il est courant d'utiliser la directive Jinja2 set pour affecter un param\u00e8tre \u00e0 une variable locale. Par exemple\u202f: [gcode_macro SET_BED_TEMPERATURE] gcode: {% set bed_temp = params.TEMPERATURE|default(40)|float %} M140 S{bed_temp} La variable \"rawparams\" \u00b6 Les param\u00e8tres complets non analys\u00e9s pour la macro en cours d'ex\u00e9cution sont accessibles via la pseudo-variable rawparams . Notez que cela inclura tous les commentaires qui faisaient partie de la commande d'origine. Voir le fichier sample-macros.cfg pour un exemple montrant comment remplacer la commande M117 \u00e0 l'aide de rawparams . La variable \"printer\" \u00b6 Il est possible d'inspecter (et de modifier) l'\u00e9tat actuel de l'imprimante via la pseudo-variable printer . Par exemple\u202f: [gcode_macro slow_fan] gcode: M106 S{ printer.fan.speed * 0.9 * 255} Les champs disponibles sont d\u00e9finis dans le document Status Reference . Important\u202f! Les macros sont d'abord \u00e9valu\u00e9es dans leur int\u00e9gralit\u00e9 et ce n'est qu'ensuite que les commandes r\u00e9sultantes sont ex\u00e9cut\u00e9es. Si une macro \u00e9met une commande qui modifie l'\u00e9tat de l'imprimante, les r\u00e9sultats de ce changement d'\u00e9tat ne seront pas visibles lors de l'\u00e9valuation de la macro. Cela peut \u00e9galement entra\u00eener un comportement subtil lorsqu'une macro g\u00e9n\u00e8re des commandes qui appellent d'autres macros, car la macro appel\u00e9e est \u00e9valu\u00e9e lorsqu'elle est invoqu\u00e9e (c'est-\u00e0-dire apr\u00e8s l'\u00e9valuation compl\u00e8te de la macro appelante). Par convention, le nom suivant imm\u00e9diatement printer est le nom d'une section de configuration. Ainsi, par exemple, printer.fan fait r\u00e9f\u00e9rence \u00e0 l'objet ventilateur cr\u00e9\u00e9 par la section de configuration [fan] . Il existe quelques exceptions \u00e0 cette r\u00e8gle, notamment les objets gcode_move et toolhead . Si la section de configuration contient des espaces, on peut y acc\u00e9der via l'accesseur [ ] - par exemple : printer[\"generic_heater my_chamber_heater\"].temperature . Notez que la directive Jinja2 set permet d'affecter un objet dans la hi\u00e9rarchie printer \u00e0 une variable locale. Cela peut rendre les macros plus lisibles et r\u00e9duire la saisie. Par exemple\u202f: [gcode_macro QUERY_HTU21D] gcode: {% set sensor = printer[\"htu21d my_sensor\"] %} M117 Temp:{sensor.temperature} Humidity:{sensor.humidity} Actions \u00b6 Certaines commandes disponibles peuvent modifier l'\u00e9tat de l'imprimante. Par exemple, { action_emergency_stop() } entra\u00eenera l'arr\u00eat de l'imprimante. Ces actions sont execut\u00e9es au moment o\u00f9 la macro est \u00e9valu\u00e9e, ce qui peut prendre beaucoup de temps avant que les commandes g-code g\u00e9n\u00e9r\u00e9es ne soient ex\u00e9cut\u00e9es. Commandes \"action\" disponibles : action_respond_info(msg) : affiche le msg donn\u00e9 dans le pseudo-terminal /tmp/printer. Chaque ligne de msg sera envoy\u00e9e avec un pr\u00e9fixe \"//\". action_raise_error(msg) : termine la macro actuelle (et toutes les macros appelantes) et \u00e9crit le msg donn\u00e9 sur le pseudo-terminal /tmp/printer. La premi\u00e8re ligne de msg sera envoy\u00e9e avec un pr\u00e9fixe \"!!\" et les lignes suivantes auront un pr\u00e9fixe \"//\". action_emergency_stop(msg) : Arr\u00eate l'imprimante. Le param\u00e8tre msg est facultatif, il peut \u00eatre utile de d\u00e9crire la raison de l'arr\u00eat. action_call_remote_method(method_name) : appelle une m\u00e9thode enregistr\u00e9e par un client distant. Si la m\u00e9thode prend des param\u00e8tres, ils doivent \u00eatre fournis via des arguments de mots-cl\u00e9s, c\u2019est-\u00e0-dire : action_call_remote_method(\u00ab print_stuff \u00bb, my_arg=\"hello_world \u00bb) Variables \u00b6 La commande SET_GCODE_VARIABLE peut \u00eatre utile pour enregistrer l'\u00e9tat entre les appels de macro. Les noms de variables ne doivent pas contenir de caract\u00e8res majuscules. Par exemple\u202f: [gcode_macro start_probe] variable_bed_temp: 0 gcode: # Save target temperature to bed_temp variable SET_GCODE_VARIABLE MACRO=start_probe VARIABLE=bed_temp VALUE={printer.heater_bed.target} # Disable bed heater M140 # Perform probe PROBE # Call finish_probe macro at completion of probe finish_probe [gcode_macro finish_probe] gcode: # Restore temperature M140 S{printer[\"gcode_macro start_probe\"].bed_temp} Assurez-vous de prendre en compte le moment de l'\u00e9valuation de la macro et de l'ex\u00e9cution de la commande lors de l'utilisation de SET_GCODE_VARIABLE. Gcodes retard\u00e9s \u00b6 L'option de configuration [delayed_gcode] peut \u00eatre utilis\u00e9e pour ex\u00e9cuter une s\u00e9quence gcode retard\u00e9e : [delayed_gcode clear_display] gcode: M117 [gcode_macro load_filament] gcode: G91 G1 E50 G90 M400 M117 Load Complete! UPDATE_DELAYED_GCODE ID=clear_display DURATION=10 Lorsque la macro load_filament ci-dessus s'ex\u00e9cute, elle affiche un message \"Load Complete!\" une fois l'extrusion termin\u00e9e. La derni\u00e8re ligne de gcode active le delay_gcode \"clear_display\", configur\u00e9 pour s'ex\u00e9cuter en 10 secondes. L'option de configuration initial_duration peut \u00eatre d\u00e9finie pour ex\u00e9cuter le delay_gcode au d\u00e9marrage de l'imprimante. Le compte \u00e0 rebours commence lorsque l'imprimante passe \u00e0 l'\u00e9tat \"pr\u00eat\". Par exemple, le delay_gcode ci-dessous s'ex\u00e9cutera 5 secondes apr\u00e8s que l'imprimante soit pr\u00eate, initialisant l'affichage avec \"Welcome!\" : [delayed_gcode welcome] initial_duration: 5. gcode: M117 Welcome! Il est possible qu'un gcode retard\u00e9 se r\u00e9p\u00e8te en le mettant \u00e0 jour dans l'option gcode : [delayed_gcode report_temp] initial_duration: 2. gcode: {action_respond_info(\"Extruder Temp: %.1f\" % (printer.extruder0.temperature))} UPDATE_DELAYED_GCODE ID=report_temp DURATION=2 Le delay_gcode ci-dessus enverra \"// Extruder Temp\u202f: [ex0_temp]\" \u00e0 Octoprint toutes les 2 secondes. Cela peut \u00eatre annul\u00e9 avec le gcode suivant\u202f: UPDATE_DELAYED_GCODE ID=report_temp DURATION=0 Mod\u00e8les de menus \u00b6 Si une section display_config est activ\u00e9e, il est alors possible de personnaliser le menu avec les sections de configuration menu . Les attributs en lecture seule suivants sont disponibles dans les mod\u00e8les de menu : menu.width - largeur de l\u2019\u00e9l\u00e9ment (nombre de colonnes d\u2019affichage) menu.ns - espace de noms de l'\u00e9l\u00e9ment menu.event - nom de l'\u00e9v\u00e9nement qui a d\u00e9clench\u00e9 le script menu.input - valeur d'entr\u00e9e, uniquement disponible dans le contexte du script d'entr\u00e9e Les actions suivantes sont disponibles dans les mod\u00e8les de menu : menu.back(force, update) : ex\u00e9cutera la commande de retour du menu, param\u00e8tres bool\u00e9ens facultatifs <force> et <update> . Lorsque <force> est d\u00e9fini sur True, l'\u00e9dition s'arr\u00eate \u00e9galement. La valeur par d\u00e9faut est False. Lorsque <update> est d\u00e9fini sur False, les \u00e9l\u00e9ments de conteneur parent ne sont pas mis \u00e0 jour. La valeur par d\u00e9faut est True. menu.exit(force) - ex\u00e9cutera la commande de sortie du menu, param\u00e8tre bool\u00e9en facultatif <force> valeur par d\u00e9faut False. Lorsque <force> est d\u00e9fini sur True, l'\u00e9dition s'arr\u00eate \u00e9galement. La valeur par d\u00e9faut est False. Enregistrer les variables sur le disque \u00b6 Si une section de configuration save_variables a \u00e9t\u00e9 activ\u00e9e, SAVE_VARIABLE VARIABLE=<name> VALUE=<value> peut \u00eatre utilis\u00e9 pour enregistrer la variable sur le disque afin qu'elle puisse \u00eatre utilis\u00e9e \u00e0 travers les red\u00e9marrages. Toutes les variables stock\u00e9es sont charg\u00e9es dans le dictionnaire printer.save_variables.variables au d\u00e9marrage et peuvent \u00eatre utilis\u00e9es dans les macros gcode. pour \u00e9viter les lignes trop longues, vous pouvez ajouter ce qui suit en haut de la macro : {% set svv = printer.save_variables.variables %} Par exemple, il pourrait \u00eatre utilis\u00e9 pour enregistrer l'\u00e9tat d'un extrudeur cyclope lors du d\u00e9marrage d'une impression, assurez-vous que l'extrudeuse active est utilis\u00e9e, au lieu de T0 : [gcode_macro T1] gcode: ACTIVATE_EXTRUDER extruder=extruder1 SAVE_VARIABLE VARIABLE=currentextruder VALUE='\"extruder1\"' [gcode_macro T0] gcode: ACTIVATE_EXTRUDER extruder=extruder SAVE_VARIABLE VARIABLE=currentextruder VALUE='\"extruder\"' [gcode_macro START_GCODE] gcode: {% set svv = printer.save_variables.variables %} ACTIVATE_EXTRUDER extruder={svv.currentextruder}","title":"Mod\u00e8les de commandes"},{"location":"Command_Templates.html#modeles-de-commandes","text":"Ce document fournit des informations sur l'impl\u00e9mentation des s\u00e9quences de commandes G-Code dans les sections de configuration gcode_macro (et similaires).","title":"Mod\u00e8les de commandes"},{"location":"Command_Templates.html#nommage-des-macros-de-g-code","text":"La casse n'est pas importante pour le nom de la macro G-Code - MA_MACRO et ma_macro \u00e9valueront la m\u00eame chose et peuvent \u00eatre appel\u00e9es en majuscules ou en minuscules. Si des nombres sont utilis\u00e9s dans le nom de la macro, ils doivent tous se trouver \u00e0 la fin du nom (par exemple, TEST_MACRO25 est valide, mais MACRO25_TEST3 ne l'est pas).","title":"Nommage des macros de G-code"},{"location":"Command_Templates.html#formatage-du-g-code-dans-la-config","text":"L'indentation est importante lors de la d\u00e9finition d'une macro dans le fichier de configuration. Pour sp\u00e9cifier une s\u00e9quence G-Code multiligne, il est important que chaque ligne ait une indentation appropri\u00e9e. Par exemple\u202f: [gcode_macro blink_led] gcode: SET_PIN PIN=my_led VALUE=1 G4 P2000 SET_PIN PIN=my_led VALUE=0 L'option de configuration gcode: commence toujours au d\u00e9but de la ligne et les lignes suivantes de la macro G-Code ne commencent jamais au d\u00e9but.","title":"Formatage du G-Code dans la config"},{"location":"Command_Templates.html#ajouter-une-description-a-votre-macro","text":"Pour vous aider \u00e0 identifier la fonctionnalit\u00e9, une courte description peut \u00eatre ajout\u00e9e. Ajoutez description\u202f: avec un texte court pour d\u00e9crire la fonctionnalit\u00e9. La valeur par d\u00e9faut est \"Macro G-Code\". Par exemple\u202f: [gcode_macro blink_led] description: Blink my_led one time gcode: SET_PIN PIN=my_led VALUE=1 G4 P2000 SET_PIN PIN=my_led VALUE=0 Le terminal affichera la description lorsque vous utiliserez la commande HELP ou la fonction de saisie semi-automatique.","title":"Ajouter une description \u00e0 votre macro"},{"location":"Command_Templates.html#enregistrerrestaurer-letat-pour-les-deplacements-g-code","text":"Le langage de commande G-Code peut \u00eatre difficile \u00e0 utiliser. Le m\u00e9canisme standard pour d\u00e9placer la t\u00eate d'outil se fait via la commande G1 (la commande G0 est un alias pour G1 et elle peut \u00eatre utilis\u00e9e \u00e0 la place de G1 et inversement). Cependant, cette commande repose sur la configuration \"G-Code parsing state\" d\u00e9finie par M82 , M83 , G90 , G91 , G92 et les commandes pr\u00e9c\u00e9dentes G1 . Lors de la cr\u00e9ation d'une macro G-Code, il est conseill\u00e9 de toujours d\u00e9finir explicitement l'\u00e9tat d'analyse du G-Code avant d'\u00e9mettre une commande G1 . (Sinon, il y a un risque que la commande G1 fasse une demande ind\u00e9sirable.) Une fa\u00e7on courante d'y parvenir consiste \u00e0 encapsuler les mouvements G1 avec SAVE_GCODE_STATE , G91 et RESTORE_GCODE_STATE . Par exemple\u202f: [gcode_macro MOVE_UP] gcode: SAVE_GCODE_STATE NAME=my_move_up_state G91 G1 Z10 F300 RESTORE_GCODE_STATE NAME=my_move_up_state La commande G91 place l'\u00e9tat d'analyse du G-Code en \"mode de d\u00e9placement relatif\" et la commande RESTORE_GCODE_STATE restaure l'\u00e9tat tel qu'il \u00e9tait avant d'entrer dans la macro. Veillez \u00e0 sp\u00e9cifier une vitesse explicite (via le param\u00e8tre F ) sur la premi\u00e8re commande G1 .","title":"Enregistrer/Restaurer l'\u00e9tat pour les d\u00e9placements G-Code"},{"location":"Command_Templates.html#extension-du-modele","text":"La section de configuration gcode_macro gcode: est \u00e9valu\u00e9e \u00e0 l'aide du langage Jinja2. On peut \u00e9valuer des expressions au moment de l'ex\u00e9cution en les entourant des caract\u00e8res { } ou utiliser des instructions conditionnelles avec des commande entour\u00e9es par {% %} . Voir la documentation Jinja2 pour plus d'informations sur la syntaxe. Un exemple de macro complexe : [gcode_macro clean_nozzle] gcode: {% set wipe_count = 8 %} SAVE_GCODE_STATE NAME=clean_nozzle_state G90 G0 Z15 F300 {% for wipe in range(wipe_count) %} {% for coordinate in [(275, 4),(235, 4)] %} G0 X{coordinate[0]} Y{coordinate[1] + 0.25 * wipe} Z9.7 F12000 {% endfor %} {% endfor %} RESTORE_GCODE_STATE NAME=clean_nozzle_state","title":"Extension du mod\u00e8le"},{"location":"Command_Templates.html#parametres-de-macro","text":"Il est souvent utile d'inspecter les param\u00e8tres pass\u00e9s \u00e0 la macro lorsqu'elle est appel\u00e9e. Ces param\u00e8tres sont disponibles via la pseudo-variable params . Par exemple, si la macro : [gcode_macro SET_PERCENT] gcode: M117 Now at { params.VALUE|float * 100 }% a \u00e9t\u00e9 appel\u00e9 avec SET_PERCENT VALUE=.2 , il sera \u00e9valu\u00e9 \u00e0 M117 Maintenant \u00e0 20 % . Les noms de param\u00e8tres sont toujours en majuscules lorsqu'ils sont \u00e9valu\u00e9s dans la macro et sont toujours transmis sous forme de cha\u00eenes. Si vous effectuez des calculs, ils doivent \u00eatre explicitement convertis en nombres entiers ou flottants. Il est courant d'utiliser la directive Jinja2 set pour affecter un param\u00e8tre \u00e0 une variable locale. Par exemple\u202f: [gcode_macro SET_BED_TEMPERATURE] gcode: {% set bed_temp = params.TEMPERATURE|default(40)|float %} M140 S{bed_temp}","title":"Param\u00e8tres de macro"},{"location":"Command_Templates.html#la-variable-rawparams","text":"Les param\u00e8tres complets non analys\u00e9s pour la macro en cours d'ex\u00e9cution sont accessibles via la pseudo-variable rawparams . Notez que cela inclura tous les commentaires qui faisaient partie de la commande d'origine. Voir le fichier sample-macros.cfg pour un exemple montrant comment remplacer la commande M117 \u00e0 l'aide de rawparams .","title":"La variable \"rawparams\""},{"location":"Command_Templates.html#la-variable-printer","text":"Il est possible d'inspecter (et de modifier) l'\u00e9tat actuel de l'imprimante via la pseudo-variable printer . Par exemple\u202f: [gcode_macro slow_fan] gcode: M106 S{ printer.fan.speed * 0.9 * 255} Les champs disponibles sont d\u00e9finis dans le document Status Reference . Important\u202f! Les macros sont d'abord \u00e9valu\u00e9es dans leur int\u00e9gralit\u00e9 et ce n'est qu'ensuite que les commandes r\u00e9sultantes sont ex\u00e9cut\u00e9es. Si une macro \u00e9met une commande qui modifie l'\u00e9tat de l'imprimante, les r\u00e9sultats de ce changement d'\u00e9tat ne seront pas visibles lors de l'\u00e9valuation de la macro. Cela peut \u00e9galement entra\u00eener un comportement subtil lorsqu'une macro g\u00e9n\u00e8re des commandes qui appellent d'autres macros, car la macro appel\u00e9e est \u00e9valu\u00e9e lorsqu'elle est invoqu\u00e9e (c'est-\u00e0-dire apr\u00e8s l'\u00e9valuation compl\u00e8te de la macro appelante). Par convention, le nom suivant imm\u00e9diatement printer est le nom d'une section de configuration. Ainsi, par exemple, printer.fan fait r\u00e9f\u00e9rence \u00e0 l'objet ventilateur cr\u00e9\u00e9 par la section de configuration [fan] . Il existe quelques exceptions \u00e0 cette r\u00e8gle, notamment les objets gcode_move et toolhead . Si la section de configuration contient des espaces, on peut y acc\u00e9der via l'accesseur [ ] - par exemple : printer[\"generic_heater my_chamber_heater\"].temperature . Notez que la directive Jinja2 set permet d'affecter un objet dans la hi\u00e9rarchie printer \u00e0 une variable locale. Cela peut rendre les macros plus lisibles et r\u00e9duire la saisie. Par exemple\u202f: [gcode_macro QUERY_HTU21D] gcode: {% set sensor = printer[\"htu21d my_sensor\"] %} M117 Temp:{sensor.temperature} Humidity:{sensor.humidity}","title":"La variable \"printer\""},{"location":"Command_Templates.html#actions","text":"Certaines commandes disponibles peuvent modifier l'\u00e9tat de l'imprimante. Par exemple, { action_emergency_stop() } entra\u00eenera l'arr\u00eat de l'imprimante. Ces actions sont execut\u00e9es au moment o\u00f9 la macro est \u00e9valu\u00e9e, ce qui peut prendre beaucoup de temps avant que les commandes g-code g\u00e9n\u00e9r\u00e9es ne soient ex\u00e9cut\u00e9es. Commandes \"action\" disponibles : action_respond_info(msg) : affiche le msg donn\u00e9 dans le pseudo-terminal /tmp/printer. Chaque ligne de msg sera envoy\u00e9e avec un pr\u00e9fixe \"//\". action_raise_error(msg) : termine la macro actuelle (et toutes les macros appelantes) et \u00e9crit le msg donn\u00e9 sur le pseudo-terminal /tmp/printer. La premi\u00e8re ligne de msg sera envoy\u00e9e avec un pr\u00e9fixe \"!!\" et les lignes suivantes auront un pr\u00e9fixe \"//\". action_emergency_stop(msg) : Arr\u00eate l'imprimante. Le param\u00e8tre msg est facultatif, il peut \u00eatre utile de d\u00e9crire la raison de l'arr\u00eat. action_call_remote_method(method_name) : appelle une m\u00e9thode enregistr\u00e9e par un client distant. Si la m\u00e9thode prend des param\u00e8tres, ils doivent \u00eatre fournis via des arguments de mots-cl\u00e9s, c\u2019est-\u00e0-dire : action_call_remote_method(\u00ab print_stuff \u00bb, my_arg=\"hello_world \u00bb)","title":"Actions"},{"location":"Command_Templates.html#variables","text":"La commande SET_GCODE_VARIABLE peut \u00eatre utile pour enregistrer l'\u00e9tat entre les appels de macro. Les noms de variables ne doivent pas contenir de caract\u00e8res majuscules. Par exemple\u202f: [gcode_macro start_probe] variable_bed_temp: 0 gcode: # Save target temperature to bed_temp variable SET_GCODE_VARIABLE MACRO=start_probe VARIABLE=bed_temp VALUE={printer.heater_bed.target} # Disable bed heater M140 # Perform probe PROBE # Call finish_probe macro at completion of probe finish_probe [gcode_macro finish_probe] gcode: # Restore temperature M140 S{printer[\"gcode_macro start_probe\"].bed_temp} Assurez-vous de prendre en compte le moment de l'\u00e9valuation de la macro et de l'ex\u00e9cution de la commande lors de l'utilisation de SET_GCODE_VARIABLE.","title":"Variables"},{"location":"Command_Templates.html#gcodes-retardes","text":"L'option de configuration [delayed_gcode] peut \u00eatre utilis\u00e9e pour ex\u00e9cuter une s\u00e9quence gcode retard\u00e9e : [delayed_gcode clear_display] gcode: M117 [gcode_macro load_filament] gcode: G91 G1 E50 G90 M400 M117 Load Complete! UPDATE_DELAYED_GCODE ID=clear_display DURATION=10 Lorsque la macro load_filament ci-dessus s'ex\u00e9cute, elle affiche un message \"Load Complete!\" une fois l'extrusion termin\u00e9e. La derni\u00e8re ligne de gcode active le delay_gcode \"clear_display\", configur\u00e9 pour s'ex\u00e9cuter en 10 secondes. L'option de configuration initial_duration peut \u00eatre d\u00e9finie pour ex\u00e9cuter le delay_gcode au d\u00e9marrage de l'imprimante. Le compte \u00e0 rebours commence lorsque l'imprimante passe \u00e0 l'\u00e9tat \"pr\u00eat\". Par exemple, le delay_gcode ci-dessous s'ex\u00e9cutera 5 secondes apr\u00e8s que l'imprimante soit pr\u00eate, initialisant l'affichage avec \"Welcome!\" : [delayed_gcode welcome] initial_duration: 5. gcode: M117 Welcome! Il est possible qu'un gcode retard\u00e9 se r\u00e9p\u00e8te en le mettant \u00e0 jour dans l'option gcode : [delayed_gcode report_temp] initial_duration: 2. gcode: {action_respond_info(\"Extruder Temp: %.1f\" % (printer.extruder0.temperature))} UPDATE_DELAYED_GCODE ID=report_temp DURATION=2 Le delay_gcode ci-dessus enverra \"// Extruder Temp\u202f: [ex0_temp]\" \u00e0 Octoprint toutes les 2 secondes. Cela peut \u00eatre annul\u00e9 avec le gcode suivant\u202f: UPDATE_DELAYED_GCODE ID=report_temp DURATION=0","title":"Gcodes retard\u00e9s"},{"location":"Command_Templates.html#modeles-de-menus","text":"Si une section display_config est activ\u00e9e, il est alors possible de personnaliser le menu avec les sections de configuration menu . Les attributs en lecture seule suivants sont disponibles dans les mod\u00e8les de menu : menu.width - largeur de l\u2019\u00e9l\u00e9ment (nombre de colonnes d\u2019affichage) menu.ns - espace de noms de l'\u00e9l\u00e9ment menu.event - nom de l'\u00e9v\u00e9nement qui a d\u00e9clench\u00e9 le script menu.input - valeur d'entr\u00e9e, uniquement disponible dans le contexte du script d'entr\u00e9e Les actions suivantes sont disponibles dans les mod\u00e8les de menu : menu.back(force, update) : ex\u00e9cutera la commande de retour du menu, param\u00e8tres bool\u00e9ens facultatifs <force> et <update> . Lorsque <force> est d\u00e9fini sur True, l'\u00e9dition s'arr\u00eate \u00e9galement. La valeur par d\u00e9faut est False. Lorsque <update> est d\u00e9fini sur False, les \u00e9l\u00e9ments de conteneur parent ne sont pas mis \u00e0 jour. La valeur par d\u00e9faut est True. menu.exit(force) - ex\u00e9cutera la commande de sortie du menu, param\u00e8tre bool\u00e9en facultatif <force> valeur par d\u00e9faut False. Lorsque <force> est d\u00e9fini sur True, l'\u00e9dition s'arr\u00eate \u00e9galement. La valeur par d\u00e9faut est False.","title":"Mod\u00e8les de menus"},{"location":"Command_Templates.html#enregistrer-les-variables-sur-le-disque","text":"Si une section de configuration save_variables a \u00e9t\u00e9 activ\u00e9e, SAVE_VARIABLE VARIABLE=<name> VALUE=<value> peut \u00eatre utilis\u00e9 pour enregistrer la variable sur le disque afin qu'elle puisse \u00eatre utilis\u00e9e \u00e0 travers les red\u00e9marrages. Toutes les variables stock\u00e9es sont charg\u00e9es dans le dictionnaire printer.save_variables.variables au d\u00e9marrage et peuvent \u00eatre utilis\u00e9es dans les macros gcode. pour \u00e9viter les lignes trop longues, vous pouvez ajouter ce qui suit en haut de la macro : {% set svv = printer.save_variables.variables %} Par exemple, il pourrait \u00eatre utilis\u00e9 pour enregistrer l'\u00e9tat d'un extrudeur cyclope lors du d\u00e9marrage d'une impression, assurez-vous que l'extrudeuse active est utilis\u00e9e, au lieu de T0 : [gcode_macro T1] gcode: ACTIVATE_EXTRUDER extruder=extruder1 SAVE_VARIABLE VARIABLE=currentextruder VALUE='\"extruder1\"' [gcode_macro T0] gcode: ACTIVATE_EXTRUDER extruder=extruder SAVE_VARIABLE VARIABLE=currentextruder VALUE='\"extruder\"' [gcode_macro START_GCODE] gcode: {% set svv = printer.save_variables.variables %} ACTIVATE_EXTRUDER extruder={svv.currentextruder}","title":"Enregistrer les variables sur le disque"},{"location":"Config_Changes.html","text":"Changements de configuration \u00b6 Ce document couvre les modifications logicielles apport\u00e9es au fichier de configuration qui ne sont pas r\u00e9tro compatibles. Il est conseill\u00e9 de consulter ce document lors de la mise \u00e0 jour du logiciel Klipper. Toutes les dates de ce document sont approximatives. Changements \u00b6 20230201: The [bed_mesh] module no longer loads the default profile on startup. It is recommended that users who use the default profile add BED_MESH_PROFILE LOAD=default to their START_PRINT macro (or to their slicer's \"Start G-Code\" configuration when applicable). 20230103: It is now possible with the flash-sdcard.sh script to flash both variants of the Bigtreetech SKR-2, STM32F407 and STM32F429. This means that the original tag of btt-skr2 now has changed to either btt-skr-2-f407 or btt-skr-2-f429. 20221128: Klipper v0.11.0 released. 20221122 : Auparavant, avec safe_z_home, il \u00e9tait possible que le z_hop apr\u00e8s la mise \u00e0 l'origine g28 aille dans une direction z n\u00e9gative. Maintenant, un saut en z n'est effectu\u00e9 apr\u00e8s g28 que s'il r\u00e9sulte en un saut positif, refl\u00e9tant le comportement du saut en z se produisant avant la mise \u00e0 l'origine g28. 20220616 : Il \u00e9tait auparavant possible de flasher un rp2040 en mode bootloader en ex\u00e9cutant make flash FLASH_DEVICE=first . La commande \u00e9quivalente est maintenant make flash FLASH_DEVICE=2e8a:0003 . 20220612 : Le micro-contr\u00f4leur rp2040 a maintenant une solution de contournement pour l'errata USB \"rp2040-e5\". Cela devrait rendre les premi\u00e8res connexions USB plus fiables. Cependant, cela peut entra\u00eener un changement de comportement de la broche gpio15. Il est peu probable que le changement de comportement de la gpio15 soit perceptible. 20220407 : L'option de configuration pid_integral_max de temperature_fan a \u00e9t\u00e9 supprim\u00e9e (elle \u00e9tait obsol\u00e8te depuis 20210612). 20220407 : L'ordre des couleurs par d\u00e9faut pour les LEDs pca9632 est maintenant \"RGBW\". Ajoutez un param\u00e8tre explicite color_order : RBGW \u00e0 la section pca9632 config pour obtenir le comportement pr\u00e9c\u00e9dent. 20220330 : Le format des informations d'\u00e9tat printer.neopixel.color_data des modules neopixel et dotstar a chang\u00e9. L'information est maintenant stock\u00e9e comme une liste de listes de couleurs (au lieu d'une liste de dictionnaires). Voir la r\u00e9f\u00e9rence d'\u00e9tat pour plus de d\u00e9tails. 20220307 : M73 ne mettra plus la progression de l'impression \u00e0 0 si P est absent. 20220304 : Il n'y a plus de valeur par d\u00e9faut pour le param\u00e8tre extruder des sections de configuration extruder_stepper . Si vous le souhaitez, sp\u00e9cifiez explicitement extruder : extruder pour associer le moteur pas \u00e0 pas \u00e0 la file d'attente de mouvement \"extruder\" au d\u00e9marrage. 20220210 : La commande SYNC_STEPPER_TO_EXTRUDER est obsol\u00e8te ; la commande SET_EXTRUDER_STEP_DISTANCE est obsol\u00e8te ; l'option de configuration shared_heater de l' extrudeuse est obsol\u00e8te. Ces fonctionnalit\u00e9s seront supprim\u00e9es dans un futur proche. Remplacez SET_EXTRUDER_STEP_DISTANCE par SET_EXTRUDER_ROTATION_DISTANCE . Remplacez SYNC_STEPPER_TO_EXTRUDER par SYNC_EXTRUDER_MOTION . Remplacez les sections de configuration de l'extrudeuse utilisant shared_heater par les sections de configuration extruder_stepper et mettez \u00e0 jour toutes les macros d'activation pour utiliser SYNC_EXTRUDER_MOTION . 20220116 : Le code de calcul run_current des tmc2130, tmc2208, tmc2209, et tmc2660 a chang\u00e9. Pour certains param\u00e8tres run_current les pilotes peuvent maintenant \u00eatre configur\u00e9s diff\u00e9remment. Cette nouvelle configuration devrait \u00eatre plus pr\u00e9cise, mais elle peut invalider les r\u00e9glages pr\u00e9c\u00e9dents des pilotes tmc. 20211230 : Les scripts pour ajuster le fa\u00e7onneur d'entr\u00e9e ( scripts/calibrate_shaper.py et scripts/graph_accelerometer.py ) ont \u00e9t\u00e9 migr\u00e9s pour utiliser Python3 par d\u00e9faut. Par cons\u00e9quent, les utilisateurs doivent installer les versions Python3 de certains paquets (par exemple, sudo apt install python3-numpy python3-matplotlib ) pour continuer \u00e0 utiliser ces scripts. Pour plus de d\u00e9tails, reportez-vous \u00e0 Installation du logiciel . Alternativement, les utilisateurs peuvent temporairement forcer l'ex\u00e9cution de ces scripts sous Python 2 en appelant explicitement l'interpr\u00e9teur Python2 dans la console : python2 ~/klipper/scripts/calibrate_shaper.py ... 20211110 : Le capteur de temp\u00e9rature \"NTC 100K beta 3950\" est d\u00e9pr\u00e9ci\u00e9. Ce capteur sera supprim\u00e9 dans un avenir proche. La plupart des utilisateurs trouveront le capteur de temp\u00e9rature \"Generic 3950\" plus pr\u00e9cis. Pour continuer \u00e0 utiliser l'ancienne d\u00e9finition (g\u00e9n\u00e9ralement moins pr\u00e9cise), d\u00e9finissez une thermistance personnalis\u00e9e avec temp\u00e9rature1 : 25 , r\u00e9sistance1 : 100000 , et beta : 3950 . 20211104 : L'option \"step pulse duration\" dans \"make menuconfig\" a \u00e9t\u00e9 supprim\u00e9e. La dur\u00e9e d'impulsion par d\u00e9faut pour les pilotes TMC configur\u00e9s en mode UART ou SPI est maintenant de 100ns. Un nouveau param\u00e8tre step_pulse_duration dans la section configuration des moteurs doit \u00eatre d\u00e9fini pour tous les moteurs n\u00e9cessitant une dur\u00e9e d'impulsion personnalis\u00e9e. 20211102 : Plusieurs fonctionnalit\u00e9s obsol\u00e8tes ont \u00e9t\u00e9 supprim\u00e9es. L'option step_distance du stepper a \u00e9t\u00e9 supprim\u00e9e (obsol\u00e8te depuis 20201222). L'alias du capteur rpi_temperature a \u00e9t\u00e9 supprim\u00e9 (obsol\u00e8te depuis 20210219). L'option mcu pin_map a \u00e9t\u00e9 supprim\u00e9e (obsol\u00e8te depuis 20210325). L'option gcode_macro default_parameter_<name> et l'acc\u00e8s aux param\u00e8tres de commande par la macro autrement que par la pseudo-variable params ont \u00e9t\u00e9 supprim\u00e9s (obsol\u00e8te depuis 20210503). L'option heater pid_integral_max a \u00e9t\u00e9 supprim\u00e9e (obsol\u00e8te le 20210612). 20210929 : Sortie de Klipper v0.10.0. 20210903 : La valeur par d\u00e9faut de smooth_time pour les \u00e9l\u00e9ments chauffants est pass\u00e9e \u00e0 1 seconde (au lieu de 2 secondes). Pour la plupart des imprimantes, cela permettra un contr\u00f4le plus stable de la temp\u00e9rature. 20210830 : Le nom par d\u00e9faut de adxl345 est maintenant \"adxl345\". Le param\u00e8tre CHIP par d\u00e9faut pour les fonctions ACCELEROMETER_MEASURE et ACCELEROMETER_QUERY est maintenant aussi \"adxl345\". 20210830 : La commande adxl345 ACCELEROMETER_MEASURE ne prend plus en charge un param\u00e8tre RATE. Pour modifier le taux d'interrogation, mettez \u00e0 jour le fichier printer.cfg et lancez une commande RESTART. 20210821 : Plusieurs param\u00e8tres de configuration dans printer.configfile.settings seront maintenant rapport\u00e9s sous forme de listes au lieu de cha\u00eenes brutes. Si vous souhaitez obtenir une cha\u00eene de caract\u00e8res brute, utilisez printer.configfile.config \u00e0 la place. 20210819 : Dans certains cas, un mouvement de retour \u00e0 l'origine G28 peut se terminer dans une position qui est nominalement en dehors de la plage de mouvement valide. Dans de rares situations, cela peut entra\u00eener des erreurs d\u00e9routantes \"Move out of range\" apr\u00e8s le retour \u00e0 la position initiale. Si cela se produit, modifiez vos scripts de d\u00e9marrage pour d\u00e9placer la t\u00eate d'outil vers une position valide imm\u00e9diatement apr\u00e8s le retour \u00e0 la position initiale. 20210814 : Les pseudo-pins analogiques sur l'atmega168 et l'atmega328 ont \u00e9t\u00e9 renomm\u00e9s de PE0/PE1 \u00e0 PE2/PE3. 20210720 : Une section controller_fan surveille maintenant tous les moteurs pas \u00e0 pas par d\u00e9faut (pas seulement les moteurs pas \u00e0 pas cin\u00e9matiques). Si le comportement pr\u00e9c\u00e9dent est souhait\u00e9, voir l'option de configuration stepper dans la r\u00e9f\u00e9rence de configuration . 20210703 : Une section de configuration samd_sercom doit maintenant sp\u00e9cifier le bus sercom qu'elle configure via l'option sercom . 20210612 : l'option de configuration pid_integral_max dans les sections heater et temperature_fan est obsol\u00e8te. Cette option sera supprim\u00e9e dans les prochaines versions. 20210503: The gcode_macro default_parameter_<name> config option is deprecated. Use the params pseudo-variable to access macro parameters. Other methods for accessing macro parameters will be removed in the near future. Most users can replace a default_parameter_NAME: VALUE config option with a line like the following in the start of the macro: {% set NAME = params.NAME|default(VALUE)|float %} . See the Command Templates document for examples. 20210430 : la commande SET_VELOCITY_LIMIT (et M204) peuvent maintenant d\u00e9finir une \"velocity\", \"acceleration\", et \"square_corner_velocity\" sup\u00e9rieurs aux valeurs sp\u00e9cifi\u00e9es dans le fichier de configuration. 20210325 : La prise en charge de l'option de configuration pin_map est obsol\u00e8te. Utilisez le fichier sample-aliases.cfg pour traduire les noms des broches r\u00e9elles du microcontr\u00f4leur. L'option de configuration pin_map sera supprim\u00e9e dans les prochaines version. 20210313 : La prise en charge de Klipper pour les microcontr\u00f4leurs CAN bus a \u00e9t\u00e9 modifi\u00e9e. Si vous utilisez CANBus, tous les microcontr\u00f4leurs doivent \u00eatre reflash\u00e9s et le fichier de configuration de Klipper doit \u00eatre mise \u00e0 jour . 20210310 : la valeur par d\u00e9faut de driver_SFILT pour les TMC2660 a \u00e9t\u00e9 modifi\u00e9e : passage de 1 \u00e0 0 par d\u00e9faut. 20210227 : Les pilotes de moteur pas \u00e0 pas TMC en mode UART ou SPI sont d\u00e9sormais interrog\u00e9s une fois par seconde si ils sont activ\u00e9s - si le pilote ne peut pas \u00eatre contact\u00e9 ou si le pilote signale une erreur, alors Klipper passera \u00e0 un \u00e9tat d'arr\u00eat. 20210219 : Le module rpi_temperature a \u00e9t\u00e9 renomm\u00e9 en temperature_host . Remplacez toutes les occurrences de sensor_type : rpi_temperature par sensor_type : temperature_host . Le chemin vers le fichier de temp\u00e9rature peut \u00eatre sp\u00e9cifi\u00e9 dans la variable de configuration sensor_path . Le nom rpi_temperature est obsol\u00e8te et sera supprim\u00e9 dans les prochaines versions. 20210201: La commande TEST_RESONANCES va maintenant d\u00e9sactiver la mise en forme des entr\u00e9es si elle \u00e9tait pr\u00e9c\u00e9demment activ\u00e9e (et la r\u00e9activer apr\u00e8s le test). Afin d'outrepasser ce comportement et de garder la mise en forme de l'entr\u00e9e activ\u00e9e, on peut passer un param\u00e8tre suppl\u00e9mentaire INPUT_SHAPING=1 \u00e0 la commande. 20210201 : La commande ACCELEROMETER_MEASURE ajoutera d\u00e9sormais le nom de la puce acc\u00e9l\u00e9rom\u00e8tre au nom du fichier de sortie si un nom a \u00e9t\u00e9 donn\u00e9 \u00e0 la puce dans la section adxl345 correspondante du printer.cfg. 20201222 : Le param\u00e8tre step_distance dans les sections de configuration de moteur est obsol\u00e8te. Il est conseill\u00e9 de mettre \u00e0 jour la configuration pour utiliser le param\u00e8tre rotation_distance . Le support de step_distance sera supprim\u00e9 dans un futur proche. 20201218 : Le param\u00e8tre endstop_phase du module endstop_phase a \u00e9t\u00e9 remplac\u00e9 par trigger_phase . Si vous utilisez le module endstop phases, il sera n\u00e9cessaire de convertir en rotation_distance et de recalibrer les phases endstop en ex\u00e9cutant la commande ENDSTOP_PHASE_CALIBRATE. 20201218 : Les imprimantes rotatives delta et polaires doivent maintenant sp\u00e9cifier un gear_ratio pour leurs moteurs rotatifs, et elles ne peuvent plus sp\u00e9cifier un param\u00e8tre step_distance . Voir la r\u00e9f\u00e9rence de configuration pour le format du nouveau param\u00e8tre gear_ratio. 20201213 : Il n'est pas valide de sp\u00e9cifier un Z \"position_endstop\" lors de l'utilisation de \"probe:z_virtual_endstop\". Une erreur sera maintenant soulev\u00e9e si un Z \"position_endstop\" est sp\u00e9cifi\u00e9 avec \"probe:z_virtual_endstop\". Supprimez la d\u00e9finition de Z \"position_endstop\" pour corriger l'erreur. 20201120 : La section de configuration [board_pins] sp\u00e9cifie maintenant le nom du mcu dans un param\u00e8tre explicite mcu: . Si vous utilisez board_pins pour un mcu secondaire, alors la config doit \u00eatre mise \u00e0 jour pour sp\u00e9cifier ce nom. Voir la r\u00e9f\u00e9rence config pour plus de d\u00e9tails. 20201112 : La dur\u00e9e rapport\u00e9e par print_stats.print_duration a chang\u00e9. La dur\u00e9e pr\u00e9c\u00e9dant la premi\u00e8re extrusion d\u00e9tect\u00e9e est maintenant exclue. 20201029 : L'option de configuration neopixel color_order_GRB a \u00e9t\u00e9 supprim\u00e9e. Si n\u00e9cessaire, mettez \u00e0 jour la configuration pour d\u00e9finir la nouvelle option color_order sur RGB, GRB, RGBW, ou GRBW. 20201029 : L'option serial dans la section mcu config ne prend plus par d\u00e9faut /dev/ttyS0. Dans la rare situation o\u00f9 /dev/ttyS0 est le port s\u00e9rie d\u00e9sir\u00e9, il doit \u00eatre indiqu\u00e9 explicitement. 20201020 : Sortie de Klipper v0.9.0. 20200902 : Le calcul de la r\u00e9sistance \u00e0 la temp\u00e9rature des RTD des convertisseurs MAX31865 a \u00e9t\u00e9 corrig\u00e9 pour ne pas lire une valeur basse. Si vous utilisez un tel dispositif, vous devez recalibrer votre temp\u00e9rature d'impression et vos param\u00e8tres PID. 20200816 : L'objet macro gcode printer.gcode a \u00e9t\u00e9 renomm\u00e9 en printer.gcode_move . Plusieurs variables non document\u00e9es dans printer.toolhead et printer.gcode ont \u00e9t\u00e9 supprim\u00e9es. Voir docs/Command_Templates.md pour une liste des variables de mod\u00e8les disponibles. 20200816 : Le syst\u00e8me de macro gcode \"action_\" a chang\u00e9. Remplacez tout appel \u00e0 printer.gcode.action_emergency_stop() par action_emergency_stop() , printer.gcode.action_respond_info() par action_respond_info() , et printer.gcode.action_respond_error() par action_raise_error() . 20200809 : Le syst\u00e8me de menu a \u00e9t\u00e9 r\u00e9\u00e9crit. Si le menu a \u00e9t\u00e9 personnalis\u00e9, il sera n\u00e9cessaire de le mettre \u00e0 jour avec la nouvelle configuration. Voir config/example-menu.cfg pour les d\u00e9tails de la configuration et voir klippy/extras/display/menu.cfg pour les exemples. 20200731 : Le comportement de l'attribut progress rapport\u00e9 par l'objet imprimante virtual_sdcard a chang\u00e9. La progression n'est plus remise \u00e0 0 lorsqu'une impression est mise en pause. La progression est maintenant toujours bas\u00e9e sur la position interne du fichier, ou 0 si aucun fichier n'est charg\u00e9. 20200725 : Le param\u00e8tre de configuration enable du servo et le param\u00e8tre SET_SERVO ENABLE ont \u00e9t\u00e9 supprim\u00e9s. Mettez \u00e0 jour toutes les macros pour utiliser SET_SERVO SERVO=my_servo WIDTH=0 pour d\u00e9sactiver un servo. 20200608 : Le support de l'affichage LCD a chang\u00e9 le nom de certains \"glyphes\" internes. Si une disposition d'affichage personnalis\u00e9e a \u00e9t\u00e9 impl\u00e9ment\u00e9e, il peut \u00eatre n\u00e9cessaire d'actualiser avec les noms actuels de glyphes (voir klippy/extras/display/display.cfg pour une liste des glyphes disponibles). 20200606 : Les noms des broches sur linux mcu ont chang\u00e9. Les broches ont maintenant des noms de la forme gpiochip<chipid>/gpio<gpio> . Pour gpiochip0 vous pouvez aussi utiliser un court gpio<gpio> . Par exemple, ce qui \u00e9tait pr\u00e9c\u00e9demment appel\u00e9 P20 devient maintenant gpio20 ou `gpiochip0/gpio20``. 20200603 : La disposition par d\u00e9faut de l'\u00e9cran LCD 16x4 n'affiche plus le temps estim\u00e9 restant pour une impression. (Seul le temps \u00e9coul\u00e9 sera affich\u00e9.) Si l'on souhaite conserver l'ancien comportement, on peut personnaliser l'affichage du menu avec cette information (voir la description de display_data dans config/example-extras.cfg pour plus de d\u00e9tails). 20200531 : L'id par d\u00e9faut du vendeur/produit USB est maintenant 0x1d50/0x614e. Ces nouveaux identifiants sont r\u00e9serv\u00e9s \u00e0 Klipper (gr\u00e2ce au projet openmoko). Ce changement ne devrait pas n\u00e9cessiter de modification de la configuration, mais les nouveaux identifiants peuvent appara\u00eetre dans les journaux syst\u00e8me. 20200524 : La valeur par d\u00e9faut du champ pwm_freq du tmc5160 est maintenant z\u00e9ro (au lieu de un). 20200425 : La variable du mod\u00e8le de commande gcode_macro printer.heater a \u00e9t\u00e9 renomm\u00e9e en printer.heaters . 20200313 : La disposition par d\u00e9faut de l'\u00e9cran pour les imprimantes multi-extrudeurs avec un \u00e9cran 16x4 a chang\u00e9. La disposition de l'\u00e9cran pour un seul extrudeur est maintenant la disposition par d\u00e9faut et elle montrera l'extrudeur actuellement actif. Pour utiliser la disposition d'\u00e9cran pr\u00e9c\u00e9dente, d\u00e9finissez \"display_group : _multiextruder_16x4\" dans la section [display] du fichier printer.cfg. 20200308 : L'\u00e9l\u00e9ment de menu par d\u00e9faut __test a \u00e9t\u00e9 supprim\u00e9. Si le fichier de configuration a un menu personnalis\u00e9, assurez-vous de supprimer toutes les r\u00e9f\u00e9rences \u00e0 cet \u00e9l\u00e9ment de menu __test . 20200308 : Les options \"deck\" et \"card\" du menu ont \u00e9t\u00e9 supprim\u00e9es. Pour personnaliser la disposition d'un \u00e9cran lcd, utilisez les nouvelles sections de configuration display_data (voir config/example-extras.cfg pour les d\u00e9tails). 20200109 : Le module bed_mesh fait d\u00e9sormais r\u00e9f\u00e9rence \u00e0 l'emplacement de la sonde pour la configuration du maillage. Ainsi, certaines options de configuration ont \u00e9t\u00e9 renomm\u00e9es pour mieux refl\u00e9ter leur fonctionnalit\u00e9. Pour les lits rectangulaires, min_point et max_point ont \u00e9t\u00e9 renomm\u00e9s en mesh_min et mesh_max respectivement. Pour les lits ronds, bed_radius a \u00e9t\u00e9 renomm\u00e9 en mesh_radius . Une nouvelle option mesh_origin a \u00e9galement \u00e9t\u00e9 ajout\u00e9e pour les lits ronds. Notez que ces changements sont \u00e9galement incompatibles avec les profils de maillage pr\u00e9c\u00e9demment enregistr\u00e9s. Si un profil incompatible est d\u00e9tect\u00e9, il sera ignor\u00e9 et sa suppression sera programm\u00e9e. Le processus de suppression peut \u00eatre achev\u00e9 en lan\u00e7ant la commande SAVE_CONFIG. L'utilisateur devra recalibrer chaque profil. 20191218 : La section de configuration de l'affichage ne prend plus en charge \"lcd_type : st7567\". Utilisez le type d'affichage \"uc1701\" \u00e0 la place - d\u00e9finissez \"lcd_type : uc1701\" et changez \"rs_pin : some_pin\" en \"rst_pin : some_pin\". Il peut \u00e9galement \u00eatre n\u00e9cessaire d'ajouter un param\u00e8tre de configuration \"contrast : 60\". 20191210 : Les commandes int\u00e9gr\u00e9es T0, T1, T2, ... ont \u00e9t\u00e9 supprim\u00e9es. Les options de configuration activate_gcode et deactivate_gcode de l'extrudeuse ont \u00e9t\u00e9 supprim\u00e9es. Si ces commandes (et scripts) sont n\u00e9cessaires, d\u00e9finissez des macros individuelles de type [gcode_macro T0] qui appellent la commande ACTIVATE_EXTRUDER. Voir les fichiers config/sample-idex.cfg et sample-multi-extruder.cfg pour des exemples. 20191210 : La prise en charge de la commande M206 a \u00e9t\u00e9 supprim\u00e9e. Remplacer par des appels \u00e0 SET_GCODE_OFFSET. Si le support de M206 est n\u00e9cessaire, ajoutez une section de configuration [gcode_macro M206] qui appelle SET_GCODE_OFFSET. (Par exemple \"SET_GCODE_OFFSET Z=-{params.Z}\".) 20191202 : La prise en charge du param\u00e8tre non document\u00e9 \"S\" de la commande \"G4\" a \u00e9t\u00e9 supprim\u00e9e. Remplacez toutes les occurrences de S par le param\u00e8tre standard \"P\" (le d\u00e9lai sp\u00e9cifi\u00e9 en millisecondes). 20191126 : Les noms USB ont chang\u00e9 sur les micro-contr\u00f4leurs avec un support USB natif. Ils utilisent d\u00e9sormais un identifiant de puce unique par d\u00e9faut (lorsqu'il est disponible). Si une section de configuration \"mcu\" utilise un param\u00e8tre \"serial\" qui commence par \"/dev/serial/by-id/\", il peut \u00eatre n\u00e9cessaire de mettre \u00e0 jour la configuration. Ex\u00e9cutez \"ls /dev/serial/by-id/*\" dans un terminal ssh pour d\u00e9terminer le nouvel identifiant. 20191121 : Le param\u00e8tre pressure_advance_lookahead_time a \u00e9t\u00e9 supprim\u00e9. Voir example.cfg pour d'autres param\u00e8tres de configuration. 20191112 : La capacit\u00e9 d'activation virtuelle du pilote de pas \u00e0 pas tmc est d\u00e9sormais automatiquement activ\u00e9e si le moteur pas \u00e0 pas ne poss\u00e8de pas de broche d'activation d\u00e9di\u00e9e. Supprimez les r\u00e9f\u00e9rences \u00e0 tmcXXXX:virtual_enable de la configuration. La possibilit\u00e9 de contr\u00f4ler plusieurs broches dans la configuration enable_pin du moteur a \u00e9t\u00e9 supprim\u00e9e. Si plusieurs broches sont n\u00e9cessaires, utilisez une section de configuration multi_pin. 20191107 : La section de configuration de l'extrudeur primaire doit \u00eatre sp\u00e9cifi\u00e9e comme \"extruder\" et ne peut plus \u00eatre sp\u00e9cifi\u00e9e comme \"extruder0\". Les mod\u00e8les de commande Gcode qui interrogent le statut de l'extrudeur sont d\u00e9sormais accessibles via \"{printer.extruder}\". 20191021 : Sortie de Klipper v0.8.0 20191003 : L'option move_to_previous de [safe_z_homing] a d\u00e9sormais la valeur par d\u00e9faut False. (Elle \u00e9tait effectivement False avant 20190918.) 20190918 : L'option zhop de [safe_z_homing] est toujours r\u00e9appliqu\u00e9e apr\u00e8s la fin du homing sur l'axe Z. Cela peut obliger les utilisateurs \u00e0 mettre \u00e0 jour les scripts personnalis\u00e9s bas\u00e9s sur ce module. 20190806 : La commande SET_NEOPIXEL a \u00e9t\u00e9 renomm\u00e9e SET_LED. 20190726 : Le code num\u00e9rique-analogique du mcp4728 a \u00e9t\u00e9 modifi\u00e9. L'adresse i2c_address par d\u00e9faut est maintenant 0x60 et la r\u00e9f\u00e9rence de tension est maintenant relative \u00e0 la r\u00e9f\u00e9rence interne de 2,048 volts du mcp4728. 20190710 : L'option z_hop a \u00e9t\u00e9 supprim\u00e9e de la section de configuration [firmware_retract]. La prise en charge de z_hop \u00e9tait incompl\u00e8te et pouvait provoquer un comportement incorrect avec plusieurs trancheurs courants. 20190710 : Les param\u00e8tres optionnels de la commande PROBE_ACCURACY ont \u00e9t\u00e9 modifi\u00e9s. Il peut \u00eatre n\u00e9cessaire de mettre \u00e0 jour les macros ou les scripts qui utilisent cette commande. 20190628 : Toutes les options de configuration ont \u00e9t\u00e9 supprim\u00e9es de la section [skew_correction]. La configuration de la correction d'obliquit\u00e9 se fait d\u00e9sormais via le gcode SET_SKEW. Voir Correction de l'obliquit\u00e9 pour l'utilisation recommand\u00e9e. 20190607 : Les param\u00e8tres \"variable_X\" de gcode_macro (ainsi que le param\u00e8tre VALUE de SET_GCODE_VARIABLE) sont maintenant analys\u00e9s comme des litt\u00e9raux Python. Si une valeur doit \u00eatre assign\u00e9e \u00e0 une cha\u00eene de caract\u00e8res, mettez-la entre guillemets pour qu'elle soit \u00e9valu\u00e9e comme une cha\u00eene de caract\u00e8res. 20190606 : Les options de configuration \"samples\", \"samples_result\" et \"sample_retract_dist\" ont \u00e9t\u00e9 d\u00e9plac\u00e9es vers la section de configuration \"probe\". Ces options ne sont plus support\u00e9es dans les sections de configuration \"delta_calibrate\", \"bed_tilt\", \"bed_mesh\", \"screws_tilt_adjust\", \"z_tilt\", ou \"quad_gantry_level\". 20190528 : La variable magique \"status\" dans l'\u00e9valuation du mod\u00e8le gcode_macro a \u00e9t\u00e9 renomm\u00e9e en \"printer\". 20190520 : La commande SET_GCODE_OFFSET a \u00e9t\u00e9 modifi\u00e9e ; mettez \u00e0 jour vos macros de code G en cons\u00e9quence. La commande n'appliquera plus le d\u00e9calage demand\u00e9 \u00e0 la prochaine commande G1. L'ancien comportement peut \u00eatre approch\u00e9 en utilisant le nouveau param\u00e8tre \"MOVE=1\". 20190404 : Les paquets du logiciel h\u00f4te Python ont \u00e9t\u00e9 mis \u00e0 jour. Les utilisateurs devront r\u00e9ex\u00e9cuter le script ~/klipper/scripts/install-octopi.sh (ou mettre \u00e0 jour les d\u00e9pendances python s'ils n'utilisent pas une installation OctoPi standard). 20190404 : Les param\u00e8tres i2c_bus et spi_bus (dans diverses sections de configuration) prennent d\u00e9sormais un nom de bus au lieu d'un num\u00e9ro. 20190404 : Les param\u00e8tres de configuration du sx1509 ont chang\u00e9. Le param\u00e8tre 'adresse' est maintenant 'i2c_address' et doit \u00eatre sp\u00e9cifi\u00e9 comme un nombre d\u00e9cimal. L\u00e0 o\u00f9 0x3E \u00e9tait pr\u00e9c\u00e9demment utilis\u00e9, sp\u00e9cifiez 62. 20190328 : La valeur min_speed dans la configuration [temperature_fan] sera d\u00e9sormais respect\u00e9e et le ventilateur fonctionnera toujours \u00e0 cette vitesse ou plus en mode PID. 20190322 : La valeur par d\u00e9faut de \"driver_HEND\" dans les sections de configuration [tmc2660] a \u00e9t\u00e9 modifi\u00e9e de 6 \u00e0 3. Le champ \"driver_VSENSE\" a \u00e9t\u00e9 supprim\u00e9 (il est d\u00e9sormais calcul\u00e9 automatiquement \u00e0 partir de run_current). 20190310 : La section de configuration [controller_fan] prend d\u00e9sormais toujours un nom (tel que [controller_fan my_controller_fan]). 20190308 : Le champ \"driver_BLANK_TIME_SELECT\" dans les sections de configuration [tmc2130] et [tmc2208] a \u00e9t\u00e9 renomm\u00e9 \"driver_TBL\". 20190308 : La section config [tmc2660] a \u00e9t\u00e9 modifi\u00e9e. Un nouveau param\u00e8tre de configuration sense_resistor doit maintenant \u00eatre fourni. La signification de plusieurs des param\u00e8tres driver_XXX a \u00e9t\u00e9 modifi\u00e9e. 20190228 : Les utilisateurs de SPI ou I2C sur les cartes SAMD21 doivent maintenant sp\u00e9cifier les broches du bus via une section de configuration [samd_sercom]. 20190224 : L'option bed_shape a \u00e9t\u00e9 supprim\u00e9e de bed_mesh. L'option radius a \u00e9t\u00e9 renomm\u00e9e bed_radius. Les utilisateurs avec des lits ronds doivent fournir les options bed_radius et round_probe_count. 20190107 : Le param\u00e8tre i2c_address de la section config du mcp4451 a \u00e9t\u00e9 modifi\u00e9. Il s'agit d'un param\u00e8tre courant sur les Smoothieboards. La nouvelle valeur est la moiti\u00e9 de l'ancienne valeur (88 doit \u00eatre chang\u00e9 en 44, et 90 doit \u00eatre chang\u00e9 en 45). 20181220 : Sortie de Klipper v0.7.0","title":"Changements de configuration"},{"location":"Config_Changes.html#changements-de-configuration","text":"Ce document couvre les modifications logicielles apport\u00e9es au fichier de configuration qui ne sont pas r\u00e9tro compatibles. Il est conseill\u00e9 de consulter ce document lors de la mise \u00e0 jour du logiciel Klipper. Toutes les dates de ce document sont approximatives.","title":"Changements de configuration"},{"location":"Config_Changes.html#changements","text":"20230201: The [bed_mesh] module no longer loads the default profile on startup. It is recommended that users who use the default profile add BED_MESH_PROFILE LOAD=default to their START_PRINT macro (or to their slicer's \"Start G-Code\" configuration when applicable). 20230103: It is now possible with the flash-sdcard.sh script to flash both variants of the Bigtreetech SKR-2, STM32F407 and STM32F429. This means that the original tag of btt-skr2 now has changed to either btt-skr-2-f407 or btt-skr-2-f429. 20221128: Klipper v0.11.0 released. 20221122 : Auparavant, avec safe_z_home, il \u00e9tait possible que le z_hop apr\u00e8s la mise \u00e0 l'origine g28 aille dans une direction z n\u00e9gative. Maintenant, un saut en z n'est effectu\u00e9 apr\u00e8s g28 que s'il r\u00e9sulte en un saut positif, refl\u00e9tant le comportement du saut en z se produisant avant la mise \u00e0 l'origine g28. 20220616 : Il \u00e9tait auparavant possible de flasher un rp2040 en mode bootloader en ex\u00e9cutant make flash FLASH_DEVICE=first . La commande \u00e9quivalente est maintenant make flash FLASH_DEVICE=2e8a:0003 . 20220612 : Le micro-contr\u00f4leur rp2040 a maintenant une solution de contournement pour l'errata USB \"rp2040-e5\". Cela devrait rendre les premi\u00e8res connexions USB plus fiables. Cependant, cela peut entra\u00eener un changement de comportement de la broche gpio15. Il est peu probable que le changement de comportement de la gpio15 soit perceptible. 20220407 : L'option de configuration pid_integral_max de temperature_fan a \u00e9t\u00e9 supprim\u00e9e (elle \u00e9tait obsol\u00e8te depuis 20210612). 20220407 : L'ordre des couleurs par d\u00e9faut pour les LEDs pca9632 est maintenant \"RGBW\". Ajoutez un param\u00e8tre explicite color_order : RBGW \u00e0 la section pca9632 config pour obtenir le comportement pr\u00e9c\u00e9dent. 20220330 : Le format des informations d'\u00e9tat printer.neopixel.color_data des modules neopixel et dotstar a chang\u00e9. L'information est maintenant stock\u00e9e comme une liste de listes de couleurs (au lieu d'une liste de dictionnaires). Voir la r\u00e9f\u00e9rence d'\u00e9tat pour plus de d\u00e9tails. 20220307 : M73 ne mettra plus la progression de l'impression \u00e0 0 si P est absent. 20220304 : Il n'y a plus de valeur par d\u00e9faut pour le param\u00e8tre extruder des sections de configuration extruder_stepper . Si vous le souhaitez, sp\u00e9cifiez explicitement extruder : extruder pour associer le moteur pas \u00e0 pas \u00e0 la file d'attente de mouvement \"extruder\" au d\u00e9marrage. 20220210 : La commande SYNC_STEPPER_TO_EXTRUDER est obsol\u00e8te ; la commande SET_EXTRUDER_STEP_DISTANCE est obsol\u00e8te ; l'option de configuration shared_heater de l' extrudeuse est obsol\u00e8te. Ces fonctionnalit\u00e9s seront supprim\u00e9es dans un futur proche. Remplacez SET_EXTRUDER_STEP_DISTANCE par SET_EXTRUDER_ROTATION_DISTANCE . Remplacez SYNC_STEPPER_TO_EXTRUDER par SYNC_EXTRUDER_MOTION . Remplacez les sections de configuration de l'extrudeuse utilisant shared_heater par les sections de configuration extruder_stepper et mettez \u00e0 jour toutes les macros d'activation pour utiliser SYNC_EXTRUDER_MOTION . 20220116 : Le code de calcul run_current des tmc2130, tmc2208, tmc2209, et tmc2660 a chang\u00e9. Pour certains param\u00e8tres run_current les pilotes peuvent maintenant \u00eatre configur\u00e9s diff\u00e9remment. Cette nouvelle configuration devrait \u00eatre plus pr\u00e9cise, mais elle peut invalider les r\u00e9glages pr\u00e9c\u00e9dents des pilotes tmc. 20211230 : Les scripts pour ajuster le fa\u00e7onneur d'entr\u00e9e ( scripts/calibrate_shaper.py et scripts/graph_accelerometer.py ) ont \u00e9t\u00e9 migr\u00e9s pour utiliser Python3 par d\u00e9faut. Par cons\u00e9quent, les utilisateurs doivent installer les versions Python3 de certains paquets (par exemple, sudo apt install python3-numpy python3-matplotlib ) pour continuer \u00e0 utiliser ces scripts. Pour plus de d\u00e9tails, reportez-vous \u00e0 Installation du logiciel . Alternativement, les utilisateurs peuvent temporairement forcer l'ex\u00e9cution de ces scripts sous Python 2 en appelant explicitement l'interpr\u00e9teur Python2 dans la console : python2 ~/klipper/scripts/calibrate_shaper.py ... 20211110 : Le capteur de temp\u00e9rature \"NTC 100K beta 3950\" est d\u00e9pr\u00e9ci\u00e9. Ce capteur sera supprim\u00e9 dans un avenir proche. La plupart des utilisateurs trouveront le capteur de temp\u00e9rature \"Generic 3950\" plus pr\u00e9cis. Pour continuer \u00e0 utiliser l'ancienne d\u00e9finition (g\u00e9n\u00e9ralement moins pr\u00e9cise), d\u00e9finissez une thermistance personnalis\u00e9e avec temp\u00e9rature1 : 25 , r\u00e9sistance1 : 100000 , et beta : 3950 . 20211104 : L'option \"step pulse duration\" dans \"make menuconfig\" a \u00e9t\u00e9 supprim\u00e9e. La dur\u00e9e d'impulsion par d\u00e9faut pour les pilotes TMC configur\u00e9s en mode UART ou SPI est maintenant de 100ns. Un nouveau param\u00e8tre step_pulse_duration dans la section configuration des moteurs doit \u00eatre d\u00e9fini pour tous les moteurs n\u00e9cessitant une dur\u00e9e d'impulsion personnalis\u00e9e. 20211102 : Plusieurs fonctionnalit\u00e9s obsol\u00e8tes ont \u00e9t\u00e9 supprim\u00e9es. L'option step_distance du stepper a \u00e9t\u00e9 supprim\u00e9e (obsol\u00e8te depuis 20201222). L'alias du capteur rpi_temperature a \u00e9t\u00e9 supprim\u00e9 (obsol\u00e8te depuis 20210219). L'option mcu pin_map a \u00e9t\u00e9 supprim\u00e9e (obsol\u00e8te depuis 20210325). L'option gcode_macro default_parameter_<name> et l'acc\u00e8s aux param\u00e8tres de commande par la macro autrement que par la pseudo-variable params ont \u00e9t\u00e9 supprim\u00e9s (obsol\u00e8te depuis 20210503). L'option heater pid_integral_max a \u00e9t\u00e9 supprim\u00e9e (obsol\u00e8te le 20210612). 20210929 : Sortie de Klipper v0.10.0. 20210903 : La valeur par d\u00e9faut de smooth_time pour les \u00e9l\u00e9ments chauffants est pass\u00e9e \u00e0 1 seconde (au lieu de 2 secondes). Pour la plupart des imprimantes, cela permettra un contr\u00f4le plus stable de la temp\u00e9rature. 20210830 : Le nom par d\u00e9faut de adxl345 est maintenant \"adxl345\". Le param\u00e8tre CHIP par d\u00e9faut pour les fonctions ACCELEROMETER_MEASURE et ACCELEROMETER_QUERY est maintenant aussi \"adxl345\". 20210830 : La commande adxl345 ACCELEROMETER_MEASURE ne prend plus en charge un param\u00e8tre RATE. Pour modifier le taux d'interrogation, mettez \u00e0 jour le fichier printer.cfg et lancez une commande RESTART. 20210821 : Plusieurs param\u00e8tres de configuration dans printer.configfile.settings seront maintenant rapport\u00e9s sous forme de listes au lieu de cha\u00eenes brutes. Si vous souhaitez obtenir une cha\u00eene de caract\u00e8res brute, utilisez printer.configfile.config \u00e0 la place. 20210819 : Dans certains cas, un mouvement de retour \u00e0 l'origine G28 peut se terminer dans une position qui est nominalement en dehors de la plage de mouvement valide. Dans de rares situations, cela peut entra\u00eener des erreurs d\u00e9routantes \"Move out of range\" apr\u00e8s le retour \u00e0 la position initiale. Si cela se produit, modifiez vos scripts de d\u00e9marrage pour d\u00e9placer la t\u00eate d'outil vers une position valide imm\u00e9diatement apr\u00e8s le retour \u00e0 la position initiale. 20210814 : Les pseudo-pins analogiques sur l'atmega168 et l'atmega328 ont \u00e9t\u00e9 renomm\u00e9s de PE0/PE1 \u00e0 PE2/PE3. 20210720 : Une section controller_fan surveille maintenant tous les moteurs pas \u00e0 pas par d\u00e9faut (pas seulement les moteurs pas \u00e0 pas cin\u00e9matiques). Si le comportement pr\u00e9c\u00e9dent est souhait\u00e9, voir l'option de configuration stepper dans la r\u00e9f\u00e9rence de configuration . 20210703 : Une section de configuration samd_sercom doit maintenant sp\u00e9cifier le bus sercom qu'elle configure via l'option sercom . 20210612 : l'option de configuration pid_integral_max dans les sections heater et temperature_fan est obsol\u00e8te. Cette option sera supprim\u00e9e dans les prochaines versions. 20210503: The gcode_macro default_parameter_<name> config option is deprecated. Use the params pseudo-variable to access macro parameters. Other methods for accessing macro parameters will be removed in the near future. Most users can replace a default_parameter_NAME: VALUE config option with a line like the following in the start of the macro: {% set NAME = params.NAME|default(VALUE)|float %} . See the Command Templates document for examples. 20210430 : la commande SET_VELOCITY_LIMIT (et M204) peuvent maintenant d\u00e9finir une \"velocity\", \"acceleration\", et \"square_corner_velocity\" sup\u00e9rieurs aux valeurs sp\u00e9cifi\u00e9es dans le fichier de configuration. 20210325 : La prise en charge de l'option de configuration pin_map est obsol\u00e8te. Utilisez le fichier sample-aliases.cfg pour traduire les noms des broches r\u00e9elles du microcontr\u00f4leur. L'option de configuration pin_map sera supprim\u00e9e dans les prochaines version. 20210313 : La prise en charge de Klipper pour les microcontr\u00f4leurs CAN bus a \u00e9t\u00e9 modifi\u00e9e. Si vous utilisez CANBus, tous les microcontr\u00f4leurs doivent \u00eatre reflash\u00e9s et le fichier de configuration de Klipper doit \u00eatre mise \u00e0 jour . 20210310 : la valeur par d\u00e9faut de driver_SFILT pour les TMC2660 a \u00e9t\u00e9 modifi\u00e9e : passage de 1 \u00e0 0 par d\u00e9faut. 20210227 : Les pilotes de moteur pas \u00e0 pas TMC en mode UART ou SPI sont d\u00e9sormais interrog\u00e9s une fois par seconde si ils sont activ\u00e9s - si le pilote ne peut pas \u00eatre contact\u00e9 ou si le pilote signale une erreur, alors Klipper passera \u00e0 un \u00e9tat d'arr\u00eat. 20210219 : Le module rpi_temperature a \u00e9t\u00e9 renomm\u00e9 en temperature_host . Remplacez toutes les occurrences de sensor_type : rpi_temperature par sensor_type : temperature_host . Le chemin vers le fichier de temp\u00e9rature peut \u00eatre sp\u00e9cifi\u00e9 dans la variable de configuration sensor_path . Le nom rpi_temperature est obsol\u00e8te et sera supprim\u00e9 dans les prochaines versions. 20210201: La commande TEST_RESONANCES va maintenant d\u00e9sactiver la mise en forme des entr\u00e9es si elle \u00e9tait pr\u00e9c\u00e9demment activ\u00e9e (et la r\u00e9activer apr\u00e8s le test). Afin d'outrepasser ce comportement et de garder la mise en forme de l'entr\u00e9e activ\u00e9e, on peut passer un param\u00e8tre suppl\u00e9mentaire INPUT_SHAPING=1 \u00e0 la commande. 20210201 : La commande ACCELEROMETER_MEASURE ajoutera d\u00e9sormais le nom de la puce acc\u00e9l\u00e9rom\u00e8tre au nom du fichier de sortie si un nom a \u00e9t\u00e9 donn\u00e9 \u00e0 la puce dans la section adxl345 correspondante du printer.cfg. 20201222 : Le param\u00e8tre step_distance dans les sections de configuration de moteur est obsol\u00e8te. Il est conseill\u00e9 de mettre \u00e0 jour la configuration pour utiliser le param\u00e8tre rotation_distance . Le support de step_distance sera supprim\u00e9 dans un futur proche. 20201218 : Le param\u00e8tre endstop_phase du module endstop_phase a \u00e9t\u00e9 remplac\u00e9 par trigger_phase . Si vous utilisez le module endstop phases, il sera n\u00e9cessaire de convertir en rotation_distance et de recalibrer les phases endstop en ex\u00e9cutant la commande ENDSTOP_PHASE_CALIBRATE. 20201218 : Les imprimantes rotatives delta et polaires doivent maintenant sp\u00e9cifier un gear_ratio pour leurs moteurs rotatifs, et elles ne peuvent plus sp\u00e9cifier un param\u00e8tre step_distance . Voir la r\u00e9f\u00e9rence de configuration pour le format du nouveau param\u00e8tre gear_ratio. 20201213 : Il n'est pas valide de sp\u00e9cifier un Z \"position_endstop\" lors de l'utilisation de \"probe:z_virtual_endstop\". Une erreur sera maintenant soulev\u00e9e si un Z \"position_endstop\" est sp\u00e9cifi\u00e9 avec \"probe:z_virtual_endstop\". Supprimez la d\u00e9finition de Z \"position_endstop\" pour corriger l'erreur. 20201120 : La section de configuration [board_pins] sp\u00e9cifie maintenant le nom du mcu dans un param\u00e8tre explicite mcu: . Si vous utilisez board_pins pour un mcu secondaire, alors la config doit \u00eatre mise \u00e0 jour pour sp\u00e9cifier ce nom. Voir la r\u00e9f\u00e9rence config pour plus de d\u00e9tails. 20201112 : La dur\u00e9e rapport\u00e9e par print_stats.print_duration a chang\u00e9. La dur\u00e9e pr\u00e9c\u00e9dant la premi\u00e8re extrusion d\u00e9tect\u00e9e est maintenant exclue. 20201029 : L'option de configuration neopixel color_order_GRB a \u00e9t\u00e9 supprim\u00e9e. Si n\u00e9cessaire, mettez \u00e0 jour la configuration pour d\u00e9finir la nouvelle option color_order sur RGB, GRB, RGBW, ou GRBW. 20201029 : L'option serial dans la section mcu config ne prend plus par d\u00e9faut /dev/ttyS0. Dans la rare situation o\u00f9 /dev/ttyS0 est le port s\u00e9rie d\u00e9sir\u00e9, il doit \u00eatre indiqu\u00e9 explicitement. 20201020 : Sortie de Klipper v0.9.0. 20200902 : Le calcul de la r\u00e9sistance \u00e0 la temp\u00e9rature des RTD des convertisseurs MAX31865 a \u00e9t\u00e9 corrig\u00e9 pour ne pas lire une valeur basse. Si vous utilisez un tel dispositif, vous devez recalibrer votre temp\u00e9rature d'impression et vos param\u00e8tres PID. 20200816 : L'objet macro gcode printer.gcode a \u00e9t\u00e9 renomm\u00e9 en printer.gcode_move . Plusieurs variables non document\u00e9es dans printer.toolhead et printer.gcode ont \u00e9t\u00e9 supprim\u00e9es. Voir docs/Command_Templates.md pour une liste des variables de mod\u00e8les disponibles. 20200816 : Le syst\u00e8me de macro gcode \"action_\" a chang\u00e9. Remplacez tout appel \u00e0 printer.gcode.action_emergency_stop() par action_emergency_stop() , printer.gcode.action_respond_info() par action_respond_info() , et printer.gcode.action_respond_error() par action_raise_error() . 20200809 : Le syst\u00e8me de menu a \u00e9t\u00e9 r\u00e9\u00e9crit. Si le menu a \u00e9t\u00e9 personnalis\u00e9, il sera n\u00e9cessaire de le mettre \u00e0 jour avec la nouvelle configuration. Voir config/example-menu.cfg pour les d\u00e9tails de la configuration et voir klippy/extras/display/menu.cfg pour les exemples. 20200731 : Le comportement de l'attribut progress rapport\u00e9 par l'objet imprimante virtual_sdcard a chang\u00e9. La progression n'est plus remise \u00e0 0 lorsqu'une impression est mise en pause. La progression est maintenant toujours bas\u00e9e sur la position interne du fichier, ou 0 si aucun fichier n'est charg\u00e9. 20200725 : Le param\u00e8tre de configuration enable du servo et le param\u00e8tre SET_SERVO ENABLE ont \u00e9t\u00e9 supprim\u00e9s. Mettez \u00e0 jour toutes les macros pour utiliser SET_SERVO SERVO=my_servo WIDTH=0 pour d\u00e9sactiver un servo. 20200608 : Le support de l'affichage LCD a chang\u00e9 le nom de certains \"glyphes\" internes. Si une disposition d'affichage personnalis\u00e9e a \u00e9t\u00e9 impl\u00e9ment\u00e9e, il peut \u00eatre n\u00e9cessaire d'actualiser avec les noms actuels de glyphes (voir klippy/extras/display/display.cfg pour une liste des glyphes disponibles). 20200606 : Les noms des broches sur linux mcu ont chang\u00e9. Les broches ont maintenant des noms de la forme gpiochip<chipid>/gpio<gpio> . Pour gpiochip0 vous pouvez aussi utiliser un court gpio<gpio> . Par exemple, ce qui \u00e9tait pr\u00e9c\u00e9demment appel\u00e9 P20 devient maintenant gpio20 ou `gpiochip0/gpio20``. 20200603 : La disposition par d\u00e9faut de l'\u00e9cran LCD 16x4 n'affiche plus le temps estim\u00e9 restant pour une impression. (Seul le temps \u00e9coul\u00e9 sera affich\u00e9.) Si l'on souhaite conserver l'ancien comportement, on peut personnaliser l'affichage du menu avec cette information (voir la description de display_data dans config/example-extras.cfg pour plus de d\u00e9tails). 20200531 : L'id par d\u00e9faut du vendeur/produit USB est maintenant 0x1d50/0x614e. Ces nouveaux identifiants sont r\u00e9serv\u00e9s \u00e0 Klipper (gr\u00e2ce au projet openmoko). Ce changement ne devrait pas n\u00e9cessiter de modification de la configuration, mais les nouveaux identifiants peuvent appara\u00eetre dans les journaux syst\u00e8me. 20200524 : La valeur par d\u00e9faut du champ pwm_freq du tmc5160 est maintenant z\u00e9ro (au lieu de un). 20200425 : La variable du mod\u00e8le de commande gcode_macro printer.heater a \u00e9t\u00e9 renomm\u00e9e en printer.heaters . 20200313 : La disposition par d\u00e9faut de l'\u00e9cran pour les imprimantes multi-extrudeurs avec un \u00e9cran 16x4 a chang\u00e9. La disposition de l'\u00e9cran pour un seul extrudeur est maintenant la disposition par d\u00e9faut et elle montrera l'extrudeur actuellement actif. Pour utiliser la disposition d'\u00e9cran pr\u00e9c\u00e9dente, d\u00e9finissez \"display_group : _multiextruder_16x4\" dans la section [display] du fichier printer.cfg. 20200308 : L'\u00e9l\u00e9ment de menu par d\u00e9faut __test a \u00e9t\u00e9 supprim\u00e9. Si le fichier de configuration a un menu personnalis\u00e9, assurez-vous de supprimer toutes les r\u00e9f\u00e9rences \u00e0 cet \u00e9l\u00e9ment de menu __test . 20200308 : Les options \"deck\" et \"card\" du menu ont \u00e9t\u00e9 supprim\u00e9es. Pour personnaliser la disposition d'un \u00e9cran lcd, utilisez les nouvelles sections de configuration display_data (voir config/example-extras.cfg pour les d\u00e9tails). 20200109 : Le module bed_mesh fait d\u00e9sormais r\u00e9f\u00e9rence \u00e0 l'emplacement de la sonde pour la configuration du maillage. Ainsi, certaines options de configuration ont \u00e9t\u00e9 renomm\u00e9es pour mieux refl\u00e9ter leur fonctionnalit\u00e9. Pour les lits rectangulaires, min_point et max_point ont \u00e9t\u00e9 renomm\u00e9s en mesh_min et mesh_max respectivement. Pour les lits ronds, bed_radius a \u00e9t\u00e9 renomm\u00e9 en mesh_radius . Une nouvelle option mesh_origin a \u00e9galement \u00e9t\u00e9 ajout\u00e9e pour les lits ronds. Notez que ces changements sont \u00e9galement incompatibles avec les profils de maillage pr\u00e9c\u00e9demment enregistr\u00e9s. Si un profil incompatible est d\u00e9tect\u00e9, il sera ignor\u00e9 et sa suppression sera programm\u00e9e. Le processus de suppression peut \u00eatre achev\u00e9 en lan\u00e7ant la commande SAVE_CONFIG. L'utilisateur devra recalibrer chaque profil. 20191218 : La section de configuration de l'affichage ne prend plus en charge \"lcd_type : st7567\". Utilisez le type d'affichage \"uc1701\" \u00e0 la place - d\u00e9finissez \"lcd_type : uc1701\" et changez \"rs_pin : some_pin\" en \"rst_pin : some_pin\". Il peut \u00e9galement \u00eatre n\u00e9cessaire d'ajouter un param\u00e8tre de configuration \"contrast : 60\". 20191210 : Les commandes int\u00e9gr\u00e9es T0, T1, T2, ... ont \u00e9t\u00e9 supprim\u00e9es. Les options de configuration activate_gcode et deactivate_gcode de l'extrudeuse ont \u00e9t\u00e9 supprim\u00e9es. Si ces commandes (et scripts) sont n\u00e9cessaires, d\u00e9finissez des macros individuelles de type [gcode_macro T0] qui appellent la commande ACTIVATE_EXTRUDER. Voir les fichiers config/sample-idex.cfg et sample-multi-extruder.cfg pour des exemples. 20191210 : La prise en charge de la commande M206 a \u00e9t\u00e9 supprim\u00e9e. Remplacer par des appels \u00e0 SET_GCODE_OFFSET. Si le support de M206 est n\u00e9cessaire, ajoutez une section de configuration [gcode_macro M206] qui appelle SET_GCODE_OFFSET. (Par exemple \"SET_GCODE_OFFSET Z=-{params.Z}\".) 20191202 : La prise en charge du param\u00e8tre non document\u00e9 \"S\" de la commande \"G4\" a \u00e9t\u00e9 supprim\u00e9e. Remplacez toutes les occurrences de S par le param\u00e8tre standard \"P\" (le d\u00e9lai sp\u00e9cifi\u00e9 en millisecondes). 20191126 : Les noms USB ont chang\u00e9 sur les micro-contr\u00f4leurs avec un support USB natif. Ils utilisent d\u00e9sormais un identifiant de puce unique par d\u00e9faut (lorsqu'il est disponible). Si une section de configuration \"mcu\" utilise un param\u00e8tre \"serial\" qui commence par \"/dev/serial/by-id/\", il peut \u00eatre n\u00e9cessaire de mettre \u00e0 jour la configuration. Ex\u00e9cutez \"ls /dev/serial/by-id/*\" dans un terminal ssh pour d\u00e9terminer le nouvel identifiant. 20191121 : Le param\u00e8tre pressure_advance_lookahead_time a \u00e9t\u00e9 supprim\u00e9. Voir example.cfg pour d'autres param\u00e8tres de configuration. 20191112 : La capacit\u00e9 d'activation virtuelle du pilote de pas \u00e0 pas tmc est d\u00e9sormais automatiquement activ\u00e9e si le moteur pas \u00e0 pas ne poss\u00e8de pas de broche d'activation d\u00e9di\u00e9e. Supprimez les r\u00e9f\u00e9rences \u00e0 tmcXXXX:virtual_enable de la configuration. La possibilit\u00e9 de contr\u00f4ler plusieurs broches dans la configuration enable_pin du moteur a \u00e9t\u00e9 supprim\u00e9e. Si plusieurs broches sont n\u00e9cessaires, utilisez une section de configuration multi_pin. 20191107 : La section de configuration de l'extrudeur primaire doit \u00eatre sp\u00e9cifi\u00e9e comme \"extruder\" et ne peut plus \u00eatre sp\u00e9cifi\u00e9e comme \"extruder0\". Les mod\u00e8les de commande Gcode qui interrogent le statut de l'extrudeur sont d\u00e9sormais accessibles via \"{printer.extruder}\". 20191021 : Sortie de Klipper v0.8.0 20191003 : L'option move_to_previous de [safe_z_homing] a d\u00e9sormais la valeur par d\u00e9faut False. (Elle \u00e9tait effectivement False avant 20190918.) 20190918 : L'option zhop de [safe_z_homing] est toujours r\u00e9appliqu\u00e9e apr\u00e8s la fin du homing sur l'axe Z. Cela peut obliger les utilisateurs \u00e0 mettre \u00e0 jour les scripts personnalis\u00e9s bas\u00e9s sur ce module. 20190806 : La commande SET_NEOPIXEL a \u00e9t\u00e9 renomm\u00e9e SET_LED. 20190726 : Le code num\u00e9rique-analogique du mcp4728 a \u00e9t\u00e9 modifi\u00e9. L'adresse i2c_address par d\u00e9faut est maintenant 0x60 et la r\u00e9f\u00e9rence de tension est maintenant relative \u00e0 la r\u00e9f\u00e9rence interne de 2,048 volts du mcp4728. 20190710 : L'option z_hop a \u00e9t\u00e9 supprim\u00e9e de la section de configuration [firmware_retract]. La prise en charge de z_hop \u00e9tait incompl\u00e8te et pouvait provoquer un comportement incorrect avec plusieurs trancheurs courants. 20190710 : Les param\u00e8tres optionnels de la commande PROBE_ACCURACY ont \u00e9t\u00e9 modifi\u00e9s. Il peut \u00eatre n\u00e9cessaire de mettre \u00e0 jour les macros ou les scripts qui utilisent cette commande. 20190628 : Toutes les options de configuration ont \u00e9t\u00e9 supprim\u00e9es de la section [skew_correction]. La configuration de la correction d'obliquit\u00e9 se fait d\u00e9sormais via le gcode SET_SKEW. Voir Correction de l'obliquit\u00e9 pour l'utilisation recommand\u00e9e. 20190607 : Les param\u00e8tres \"variable_X\" de gcode_macro (ainsi que le param\u00e8tre VALUE de SET_GCODE_VARIABLE) sont maintenant analys\u00e9s comme des litt\u00e9raux Python. Si une valeur doit \u00eatre assign\u00e9e \u00e0 une cha\u00eene de caract\u00e8res, mettez-la entre guillemets pour qu'elle soit \u00e9valu\u00e9e comme une cha\u00eene de caract\u00e8res. 20190606 : Les options de configuration \"samples\", \"samples_result\" et \"sample_retract_dist\" ont \u00e9t\u00e9 d\u00e9plac\u00e9es vers la section de configuration \"probe\". Ces options ne sont plus support\u00e9es dans les sections de configuration \"delta_calibrate\", \"bed_tilt\", \"bed_mesh\", \"screws_tilt_adjust\", \"z_tilt\", ou \"quad_gantry_level\". 20190528 : La variable magique \"status\" dans l'\u00e9valuation du mod\u00e8le gcode_macro a \u00e9t\u00e9 renomm\u00e9e en \"printer\". 20190520 : La commande SET_GCODE_OFFSET a \u00e9t\u00e9 modifi\u00e9e ; mettez \u00e0 jour vos macros de code G en cons\u00e9quence. La commande n'appliquera plus le d\u00e9calage demand\u00e9 \u00e0 la prochaine commande G1. L'ancien comportement peut \u00eatre approch\u00e9 en utilisant le nouveau param\u00e8tre \"MOVE=1\". 20190404 : Les paquets du logiciel h\u00f4te Python ont \u00e9t\u00e9 mis \u00e0 jour. Les utilisateurs devront r\u00e9ex\u00e9cuter le script ~/klipper/scripts/install-octopi.sh (ou mettre \u00e0 jour les d\u00e9pendances python s'ils n'utilisent pas une installation OctoPi standard). 20190404 : Les param\u00e8tres i2c_bus et spi_bus (dans diverses sections de configuration) prennent d\u00e9sormais un nom de bus au lieu d'un num\u00e9ro. 20190404 : Les param\u00e8tres de configuration du sx1509 ont chang\u00e9. Le param\u00e8tre 'adresse' est maintenant 'i2c_address' et doit \u00eatre sp\u00e9cifi\u00e9 comme un nombre d\u00e9cimal. L\u00e0 o\u00f9 0x3E \u00e9tait pr\u00e9c\u00e9demment utilis\u00e9, sp\u00e9cifiez 62. 20190328 : La valeur min_speed dans la configuration [temperature_fan] sera d\u00e9sormais respect\u00e9e et le ventilateur fonctionnera toujours \u00e0 cette vitesse ou plus en mode PID. 20190322 : La valeur par d\u00e9faut de \"driver_HEND\" dans les sections de configuration [tmc2660] a \u00e9t\u00e9 modifi\u00e9e de 6 \u00e0 3. Le champ \"driver_VSENSE\" a \u00e9t\u00e9 supprim\u00e9 (il est d\u00e9sormais calcul\u00e9 automatiquement \u00e0 partir de run_current). 20190310 : La section de configuration [controller_fan] prend d\u00e9sormais toujours un nom (tel que [controller_fan my_controller_fan]). 20190308 : Le champ \"driver_BLANK_TIME_SELECT\" dans les sections de configuration [tmc2130] et [tmc2208] a \u00e9t\u00e9 renomm\u00e9 \"driver_TBL\". 20190308 : La section config [tmc2660] a \u00e9t\u00e9 modifi\u00e9e. Un nouveau param\u00e8tre de configuration sense_resistor doit maintenant \u00eatre fourni. La signification de plusieurs des param\u00e8tres driver_XXX a \u00e9t\u00e9 modifi\u00e9e. 20190228 : Les utilisateurs de SPI ou I2C sur les cartes SAMD21 doivent maintenant sp\u00e9cifier les broches du bus via une section de configuration [samd_sercom]. 20190224 : L'option bed_shape a \u00e9t\u00e9 supprim\u00e9e de bed_mesh. L'option radius a \u00e9t\u00e9 renomm\u00e9e bed_radius. Les utilisateurs avec des lits ronds doivent fournir les options bed_radius et round_probe_count. 20190107 : Le param\u00e8tre i2c_address de la section config du mcp4451 a \u00e9t\u00e9 modifi\u00e9. Il s'agit d'un param\u00e8tre courant sur les Smoothieboards. La nouvelle valeur est la moiti\u00e9 de l'ancienne valeur (88 doit \u00eatre chang\u00e9 en 44, et 90 doit \u00eatre chang\u00e9 en 45). 20181220 : Sortie de Klipper v0.7.0","title":"Changements"},{"location":"Config_Reference.html","text":"R\u00e9f\u00e9rence de configuration \u00b6 Ce document est la r\u00e9f\u00e9rence des options disponibles dans le fichier de configuration de Klipper. Les descriptions de ce document sont format\u00e9es de mani\u00e8re \u00e0 ce qu'il soit possible de les copier-coller dans un fichier de configuration d'imprimante. Consultez le document d'installation pour obtenir des informations sur la configuration de Klipper et le choix d'un fichier de configuration initial. Configuration du microcontr\u00f4leur \u00b6 Format du nom des broches du microcontr\u00f4leur \u00b6 De nombreuses options de configuration n\u00e9cessitent le nom d'une broche du micro-contr\u00f4leur. Klipper utilise les noms mat\u00e9riel pour ces broches - par exemple PA4 . Les noms des broches peuvent \u00eatre pr\u00e9c\u00e9d\u00e9s de ! pour indiquer qu'une polarit\u00e9 inverse doit \u00eatre utilis\u00e9e (par exemple, d\u00e9clencher sur le niveau bas au lieu du niveau haut). Les broches d'entr\u00e9e peuvent \u00eatre pr\u00e9c\u00e9d\u00e9es de ^ pour indiquer qu'une r\u00e9sistance pull-up mat\u00e9rielle doit \u00eatre activ\u00e9e pour cette broche. Si le micro-contr\u00f4leur supporte les r\u00e9sistances pull-down, une broche d'entr\u00e9e peut \u00e9galement \u00eatre pr\u00e9c\u00e9d\u00e9e de ~ . Notez que certaines sections de configuration peuvent \"cr\u00e9er\" des broches suppl\u00e9mentaires. Lorsque cela se produit, la section de configuration d\u00e9finissant ces broches doit \u00eatre r\u00e9pertori\u00e9e dans le fichier de configuration avant toute section utilisant celles-ci. [mcu| \u00b6 Configuration du microcontr\u00f4leur primaire. [mcu] serial: # Le port s\u00e9rie \u00e0 connecter \u00e0 l'unit\u00e9 MCU. Si vous n'\u00eates pas s\u00fbr (ou s'il # change) consultez la section \"O\u00f9 est mon port s\u00e9rie ?\" de la FAQ. # Ce param\u00e8tre doit \u00eatre fourni lors de l'utilisation d'un port s\u00e9rie. #baud: 250000 # Le d\u00e9bit en bauds \u00e0 utiliser. La valeur par d\u00e9faut est 250000. #canbus_uuid: # Si vous utilisez un dispositif connect\u00e9 \u00e0 un bus CAN, ceci d\u00e9finit l'identifiant # unique de la puce \u00e0 laquelle se connecter. Cette valeur doit \u00eatre fournie lorsque l'on utilise # le bus CAN pour la communication. #canbus_interface: # Si vous utilisez un dispositif connect\u00e9 \u00e0 un bus CAN, ceci d\u00e9finit l'interface r\u00e9seau CAN # \u00e0 utiliser. La valeur par d\u00e9faut est 'can0'. #restart_method: # Ceci contr\u00f4le le m\u00e9canisme que l'h\u00f4te utilisera pour r\u00e9initialiser le microcontr\u00f4leur. # Les choix sont 'arduino', 'cheetah', 'rpi_usb', et 'command'. La m\u00e9thode 'arduino' # (basculer DTR) est courante sur les cartes et clones Arduino. # La m\u00e9thode 'cheetah' est une m\u00e9thode particuli\u00e8re n\u00e9cessaire pour certaines cartes # Fysetc Cheetah. La m\u00e9thode 'rpi_usb' est utile sur les cartes Raspberry Pi avec des # micro-contr\u00f4leurs aliment\u00e9s par USB - elle d\u00e9sactive bri\u00e8vement l'alimentation de tous # les ports USB pour effectuer une r\u00e9initialisation du microcontr\u00f4leur. # La m\u00e9thode 'command' implique l'envoi d'une commande Klipper au microcontr\u00f4leur # afin qu'il puisse # se r\u00e9initialiser. # La valeur par d\u00e9faut est 'arduino' si le micro-contr\u00f4leur communique via un port s\u00e9rie, # 'command' sinon. [mcu my_extra_mcu] \u00b6 Microcontr\u00f4leurs suppl\u00e9mentaires (on peut d\u00e9finir un nombre quelconque de sections avec un pr\u00e9fixe \"mcu\"). Les microcontr\u00f4leurs suppl\u00e9mentaires introduisent des broches additionnelles pouvant \u00eatre configur\u00e9es comme des \u00e9l\u00e9ments de chauffage, des pilotes moteurs, des ventilateurs, etc. Par exemple, si une section \"[mcu extra_mcu]\" est ajout\u00e9e, des broches telles que \"extra_mcu:ar9\" pourront \u00eatre utilis\u00e9es ailleurs dans la configuration (o\u00f9 \"ar9\" est un nom de broche mat\u00e9rielle ou un nom d'alias sur le mcu donn\u00e9). [mcu my_extra_mcu] # Voir la section \"mcu\" pour les param\u00e8tres de configuration. Param\u00e8tres cin\u00e9matiques courants \u00b6 [printer] \u00b6 La section imprimante contr\u00f4le les param\u00e8tres de haut niveau de l'imprimante. [printer] kinematics: # Le type d'imprimante utilis\u00e9e. Cette option peut \u00eatre l'une des suivantes : cart\u00e9sienne, # corexy, corexz, hybrid_corexy, hybrid_corexz, rotary_delta, delta, deltesian, polar, winch, # ou none. Ce param\u00e8tre doit \u00eatre sp\u00e9cifi\u00e9. max_velocity: # Vitesse maximale (en mm/s) de la t\u00eate d'outil (par rapport \u00e0 l'impression). # Ce param\u00e8tre doit \u00eatre sp\u00e9cifi\u00e9. max_accel: # Acc\u00e9l\u00e9ration maximale (en mm/s^2) de la t\u00eate de l'outil (par rapport \u00e0 l'impression). # Ce param\u00e8tre doit \u00eatre sp\u00e9cifi\u00e9. #max_accel_to_decel: # Une pseudo-acc\u00e9l\u00e9ration (en mm/s^2) contr\u00f4lant la vitesse \u00e0 laquelle la t\u00eate de l'outil peut # passer de l'acc\u00e9l\u00e9ration \u00e0 la d\u00e9c\u00e9l\u00e9ration. Elle est utilis\u00e9e pour r\u00e9duire la vitesse maximale # des courts mouvements en zigzag (et donc r\u00e9duire les vibrations de l'imprimante dues \u00e0 ces # mouvements). La valeur par d\u00e9faut est la moiti\u00e9 de max_accel. #square_corner_velocity: 5.0 # La vitesse maximale (en mm/s) \u00e0 laquelle la t\u00eate d'outil peut parcourir un angle de 90 degr\u00e9s. # Une valeur non nulle peut r\u00e9duire les changements dans les d\u00e9bits de l'extrudeuse en # permettant des changements de vitesse instantan\u00e9s de la t\u00eate d'outil pendant les virages. # Cette valeur configure l'algorithme interne de prise de virage \u00e0 vitesse centrip\u00e8te ; les virages # dont l'angle est sup\u00e9rieur \u00e0 90 degr\u00e9s auront une vitesse de prise de virage plus \u00e9lev\u00e9e tandis # que ceux d'angles inf\u00e9rieurs \u00e0 90 degr\u00e9s auront une vitesse de virage plus faible. # Si ce param\u00e8tre est d\u00e9fini sur z\u00e9ro, la t\u00eate d'outil d\u00e9c\u00e9l\u00e9rera jusqu'\u00e0 z\u00e9ro \u00e0 chaque coin. # La valeur par d\u00e9faut est 5mm/s. [stepper] \u00b6 D\u00e9finitions des pilotes de moteurs pas \u00e0 pas. Diff\u00e9rents types d'imprimantes (comme sp\u00e9cifi\u00e9 par l'option \"kinematics\" dans la section [printer]) requi\u00e8rent diff\u00e9rents noms pour le moteur pas \u00e0 pas (par exemple, stepper_x vs stepper_a ). Ci-dessous, vous trouverez les d\u00e9finitions les plus courantes. Voir le document distance de rotation pour des informations sur le calcul du param\u00e8tre rotation_distance . Voir le document Multi-MCU homing pour des informations sur l'utilisation de plusieurs microcontr\u00f4leurs lors d'une mise \u00e0 l'origine. [stepper_x] step_pin: # Broche GPIO du moteur (d\u00e9clench\u00e9e \u00e0 l'\u00e9tat haut). Ce param\u00e8tre doit \u00eatre fourni. dir_pin: # Broche GPIO de direction (le niveau haut indique une direction positive). Ce param\u00e8tre # doit \u00eatre fourni. enable_pin: # Broche d'activation (par d\u00e9faut, enable est haut ; utilisez ! pour indiquer enable # bas). Si ce param\u00e8tre n'est pas fourni, le pilote du moteur pas \u00e0 pas doit toujours # \u00eatre activ\u00e9. rotation_distance: # Distance (en mm) parcourue par l'axe lors d'une rotation compl\u00e8te du moteur pas \u00e0 pas # (ou de l'engrenage final si le rapport de vitesse est sp\u00e9cifi\u00e9). # Ce param\u00e8tre doit \u00eatre fourni. microsteps: # Le nombre de micropas utilis\u00e9s par le pilote du moteur pas \u00e0 pas. Ce param\u00e8tre # doit \u00eatre fourni. #full_steps_per_rotation: 200 # Nombre de pas complets pour une rotation compl\u00e8te du moteur pas \u00e0 pas. # R\u00e9glez ce param\u00e8tre sur 200 pour un moteur pas \u00e0 pas de 1,8 degr\u00e9 ou sur 400 pour # un moteur de 0,9 degr\u00e9. La valeur par d\u00e9faut est 200. #gear_ratio: # Le rapport d'engrenage si le moteur pas \u00e0 pas est reli\u00e9 \u00e0 l'axe via une d\u00e9multiplication. # Par exemple, on peut sp\u00e9cifier \"5:1\" si un r\u00e9ducteur de 5 pour 1 est utilis\u00e9. # Si l'axe a plusieurs d\u00e9multiplications, on peut sp\u00e9cifier une liste de rapports s\u00e9par\u00e9s par # des virgules (par exemple, \"57:11, 2:1\"). Si un rapport de vitesse est sp\u00e9cifi\u00e9, alors # rotation_distance sp\u00e9cifie la distance parcourue par l'axe pour une rotation compl\u00e8te # de l'engrenage final. # La valeur par d\u00e9faut est de ne pas utiliser de rapport de vitesse. #step_pulse_duration: # Le temps minimum entre le front du signal d'impulsion de pas et le front du signal \"unstep\" suivant. # Ceci est \u00e9galement utilis\u00e9 pour d\u00e9finir le temps minimum entre une impulsion de pas et un signal # de changement de direction. # La valeur par d\u00e9faut est 0,000000100 (100ns) pour les pilotes TMC configur\u00e9s en mode UART ou SPI, # sinon la valeur par d\u00e9faut est de 0,000002 (2us) pour tous les autres pilotes. endstop_pin: # Broche de d\u00e9tection de l'interrupteur de fin de course. Si cette broche est sur un mcu diff\u00e9rent de # celui du moteur pas \u00e0 pas, cela active le \"multi-mcu\". Ce param\u00e8tre doit \u00eatre fourni pour les moteurs # pas \u00e0 pas X, Y, et Z sur les imprimantes de style cart\u00e9sien. #position_min: 0 # Distance minimale valide (en mm) vers laquelle l'utilisateur peut commander le moteur pas \u00e0 pas. # La valeur par d\u00e9faut est 0mm. position_endstop: # Emplacement de la but\u00e9e (en mm). Ce param\u00e8tre doit \u00eatre fourni pour les moteurs X, Y et Z # des imprimantes de style cart\u00e9sien. position_max: # Distance maximale valide (en mm) vers laquelle l'utilisateur peut ordonner au moteur de se d\u00e9placer. # Ce param\u00e8tre doit \u00eatre fourni pour les moteurs X, Y, et Z des imprimantes de type cart\u00e9sien. #homing_speed: 5.0 # Vitesse maximale (en mm/s) du moteur pas \u00e0 pas lors de la mise \u00e0 l'origine. La valeur par d\u00e9faut # est de 5mm/s. #homing_retract_dist: 5.0 # Distance de recul (en mm) avant le retour au point d'origine une seconde fois. # R\u00e9glez cette valeur \u00e0 z\u00e9ro pour d\u00e9sactiver le second retour \u00e0 l'origine. La valeur par d\u00e9faut # est de 5 mm. #homing_retract_speed: # Vitesse \u00e0 utiliser pour le mouvement de recul apr\u00e8s le retour \u00e0 l'origine au cas o\u00f9 elle soit # diff\u00e9rente de la vitesse de mise \u00e0 l'origine qui est la valeur par d\u00e9faut de ce param\u00e8tre. #second_homing_speed: # Vitesse (en mm/s) du moteur pas \u00e0 pas lors du second retour \u00e0 l'origine. # La valeur par d\u00e9faut est homing_speed/2. #homing_positive_dir: # Si la valeur est vraie (true), le retour au point d'origine entra\u00eenera le d\u00e9placement de la commande pas # \u00e0 pas dans une direction positive (en s'\u00e9loignant de z\u00e9ro) ; si elle est fausse (false), le retour \u00e0 l'origine # se fera vers z\u00e9ro. Il est pr\u00e9f\u00e9rable d'utiliser la valeur par d\u00e9faut que de sp\u00e9cifier ce param\u00e8tre. La valeur # par d\u00e9faut est true si position_endstop est proche de position_max et false si elle est proche de # la position_min. Cin\u00e9matique cart\u00e9sienne \u00b6 Voir example-cartesian.cfg pour un exemple de fichier de configuration de cin\u00e9matique cart\u00e9sienne. Seuls les param\u00e8tres sp\u00e9cifiques aux imprimantes cart\u00e9siennes sont d\u00e9crits ici - voir param\u00e8tres cin\u00e9matiques communs pour les param\u00e8tres disponibles. [printer] kinematics: cartesian max_z_velocity: # Ceci d\u00e9finit la vitesse maximale (en mm/s) du mouvement le long de l'axe z # Ce param\u00e8tre peut \u00eatre utilis\u00e9 pour limiter la vitesse maximale du moteur pas \u00e0 pas z. # La valeur par d\u00e9faut est l'utilisation de max_velocity pour # max_z_velocity. max_z_accel: # Ce param\u00e8tre d\u00e9finit l'acc\u00e9l\u00e9ration maximale (en mm/s^2) du mouvement sur l'axe z. # Cela limite l'acc\u00e9l\u00e9ration du moteur pas \u00e0 pas z. La valeur par d\u00e9faut est # d'utiliser max_accel pour max_z_accel. # La section stepper_x est utilis\u00e9e pour d\u00e9crire le moteur pas \u00e0 pas contr\u00f4lant # l'axe X dans un robot cart\u00e9sien. [stepper_x] # La section stepper_y est utilis\u00e9e pour d\u00e9crire le moteur pas \u00e0 pas contr\u00f4lant # l'axe Y d'un robot cart\u00e9sien. [stepper_y] # La section stepper_z est utilis\u00e9e pour d\u00e9crire le moteur pas \u00e0 pas contr\u00f4lant # l'axe Z d'un robot cart\u00e9sien. [stepper_z] Cin\u00e9matique Delta lin\u00e9aire \u00b6 Voir example-delta.cfg pour un exemple de fichier de configuration de cin\u00e9matique delta lin\u00e9aire. Voir le guide de calibration delta pour des informations sur la calibration. Seuls les param\u00e8tres sp\u00e9cifiques aux imprimantes delta lin\u00e9aires sont d\u00e9crits ici - voir param\u00e8tres cin\u00e9matiques communs pour les param\u00e8tres disponibles. [printer] kinematics: delta max_z_velocity: # Pour les imprimantes delta, cela limite la vitesse maximale (en mm/s) des # mouvements de l'axe z. Ce param\u00e8tre peut \u00eatre utilis\u00e9 pour r\u00e9duire la # vitesse maximale des d\u00e9placements vers le haut/bas (n\u00e9cessitent une vitesse # de pas plus \u00e9lev\u00e9e que les autres mouvements sur une imprimante delta). La # valeur par d\u00e9faut est d'utiliser max_velocity pour max_z_velocity. #max_z_accel: # Ceci d\u00e9finit l'acc\u00e9l\u00e9ration maximale (en mm/s^2) du mouvement le long de l'axe z. # Ce param\u00e8tre peut \u00eatre utile si l'imprimante peut atteindre une plus grande # acc\u00e9l\u00e9ration sur les mouvements XY que sur les mouvements Z (par exemple, lors # de l'utilisation de la compensation de r\u00e9sonance). # La valeur par d\u00e9faut est d'utiliser max_accel pour max_z_accel. #minimum_z_position: 0 # Position Z minimale \u00e0 laquelle l'utilisateur peut ordonner \u00e0 la t\u00eate de se d\u00e9placer. # La valeur par d\u00e9faut est 0. delta_radius: # Rayon (en mm) du cercle horizontal form\u00e9 par les trois colonnes d'axe lin\u00e9aire. # Ce param\u00e8tre peut \u00e9galement \u00eatre calcul\u00e9 comme suit : # delta_radius = smooth_rod_offset - effector_offset - carriage_offset. # Ce param\u00e8tre doit \u00eatre fourni. #print_radius: # Le rayon (en mm) des coordonn\u00e9es XY valides de la t\u00eate d'extrusion. On peut utiliser # ce param\u00e8tre pour personnaliser la v\u00e9rification de la plage de mouvements de la t\u00eate. # Si une grande valeur est sp\u00e9cifi\u00e9e ici, il peut \u00eatre possible de faire entrer la t\u00eate en collision # avec une colonne. La valeur par d\u00e9faut est d'utiliser delta_radius pour print_radius (ce qui # emp\u00eachera normalement une collision avec une colonne). # La section stepper_a d\u00e9crit le moteur pas \u00e0 pas contr\u00f4lant la colonne avant gauche (\u00e0 210 # degr\u00e9s). Cette section contr\u00f4le \u00e9galement les param\u00e8tres de la mise \u00e0 l'origine # (homing_speed, homing_retract_dist) pour toutes les colonnes. [stepper_a] position_endstop: # Distance (en mm) entre la buse et le lit lorsque la buse se trouve au centre de la zone de # construction et que la fin de course se d\u00e9clenche. Ce param\u00e8tre doit \u00eatre fourni pour le # stepper_a ; pour les stepper_b et stepper_c, ce param\u00e8tre prend par d\u00e9faut la valeur # sp\u00e9cifi\u00e9e pour stepper_a. arm_length: # Longueur (en mm) du bras reliant cette colonne \u00e0 la t\u00eate d'impression. # Ce param\u00e8tre doit \u00eatre fourni pour stepper_a ; pour stepper_b et stepper_c, ce param\u00e8tre # prend par d\u00e9faut la valeur sp\u00e9cifi\u00e9e pour stepper_a. #angle: # Cette option sp\u00e9cifie l'angle (en degr\u00e9s) o\u00f9 se trouve positionn\u00e9e la colonne. # La valeur par d\u00e9faut est 210 pour stepper_a, 330 pour stepper_b, et 90 # pour stepper_c. # La section stepper_b d\u00e9crit le moteur pas \u00e0 pas contr\u00f4lant la colonne avant droite (\u00e0 330 degr\u00e9s). [stepper_b] # La section stepper_c d\u00e9crit le moteur pas \u00e0 pas contr\u00f4lant la colonne arri\u00e8re droite (\u00e0 90 degr\u00e9s). [stepper_c] # La section delta_calibrate active une commande G-code \u00e9tendue DELTA_CALIBRATE permettant # de calibrer la position des interrupteurs de fin de course ainsi que les angles des colonnes. [delta_calibrate] radius: # Rayon (en mm) de la zone palpable. Il s'agit du rayon des coordonn\u00e9es de la buse \u00e0 sonder ; si # vous utilisez un palpeur automatique avec un d\u00e9calage XY, choisissez un rayon suffisamment # petit pour que la sonde reste toujours au-dessus du lit. # Ce param\u00e8tre doit \u00eatre fourni. #speed: 50 # La vitesse (en mm/s) des mouvements sans palpage pendant l'\u00e9talonnage. # La valeur par d\u00e9faut est 50. #horizontal_move_z: 5 # La hauteur (en mm) \u00e0 laquelle la t\u00eate doit \u00eatre relev\u00e9e pour se d\u00e9placer # juste avant de lancer une op\u00e9ration de palpage. La valeur par d\u00e9faut est 5. Cin\u00e9matique deltesienne \u00b6 Voir example-deltesian.cfg pour un exemple de fichier de configuration de cin\u00e9matique deltesienne. Seuls les param\u00e8tres sp\u00e9cifiques aux imprimantes deltesiennes sont d\u00e9crits ici - voir param\u00e8tres cin\u00e9matiques communs pour les param\u00e8tres disponibles. [printer] kinematics: deltesian max_z_velocity: # Pour les imprimantes deltesiennes, ceci limite la vitesse maximale (en mm/s) des # d\u00e9placements avec un mouvement sur l'axe z. Ce param\u00e8tre peut \u00eatre utilis\u00e9 pour # r\u00e9duire la vitesse maximale des d\u00e9placements vers le haut/bas (qui n\u00e9cessitent un # taux de pas plus \u00e9lev\u00e9 que les autres mouvements sur une imprimante deltesienne). # La valeur par d\u00e9faut est d'utiliser max_velocity pour max_z_velocity. #max_z_accel: # Ceci d\u00e9finit l'acc\u00e9l\u00e9ration maximale (en mm/s^2) du mouvement le long de l'axe z. # Ce param\u00e8tre peut \u00eatre utile si l'imprimante peut atteindre une plus grande # acc\u00e9l\u00e9ration sur les mouvements XY que sur les mouvements Z (par exemple, lors # de l'utilisation de la compensation de la r\u00e9sonance). # La valeur par d\u00e9faut est d'utiliser max_accel pour max_z_accel. #minimum_z_position : 0 # Position Z minimale \u00e0 laquelle l'utilisateur peut ordonner \u00e0 la t\u00eate de se d\u00e9placer. # La valeur par d\u00e9faut est 0. #min_angle: 5 # Ceci repr\u00e9sente l'angle minimum (en degr\u00e9s) par rapport \u00e0 l'horizontale que les bras # deltesiens sont autoris\u00e9s \u00e0 atteindre. Ce param\u00e8tre est destin\u00e9 \u00e0 emp\u00eacher les bras de # devenir compl\u00e8tement horizontaux, ce qui risquerait de provoquer une inversion # accidentelle de l'axe XZ. # La valeur par d\u00e9faut est 5. #print_width: # La distance (en mm) des coordonn\u00e9es X valides de la t\u00eate de l'outil. On peut utiliser ce # param\u00e8tre pour personnaliser la v\u00e9rification de la plage des mouvements de la t\u00eate de # l'outil. Si une grande valeur est sp\u00e9cifi\u00e9e ici, il peut \u00eatre possible de faire entrer la t\u00eate # de l'outil en collision avec une colonne. Ce param\u00e8tre correspond g\u00e9n\u00e9ralement \u00e0 la # largeur du banc (en mm). #slow_ratio: 3 # Rapport utilis\u00e9 pour limiter la vitesse et l'acc\u00e9l\u00e9ration des mouvements proches des # extr\u00eames de l'axe X. Si la distance verticale divis\u00e9e par la distance horizontale d\u00e9passe # la valeur de slow_ratio, la vitesse et l'acc\u00e9l\u00e9ration sont limit\u00e9es \u00e0 la moiti\u00e9 de leur valeur # nominale. Si la distance verticale divis\u00e9e par la distance horizontale d\u00e9passe de deux fois # la valeur de slow_ratio, alors la vitesse et l'acc\u00e9l\u00e9ration sont limit\u00e9es \u00e0 un quart de leur # valeur nominale. La valeur par d\u00e9faut est 3. # La section stepper_left est utilis\u00e9e pour d\u00e9crire le moteur pas \u00e0 pas contr\u00f4lant la colonne # gauche. Cette section contr\u00f4le \u00e9galement les param\u00e8tres d'orientation (homing_speed, # homing_retract_dist) pour toutes les colonnes. [stepper_left] position_endstop: # Distance (en mm) entre la buse et le lit lorsque la buse se trouve au centre de la zone de # construction. Ce param\u00e8tre doit \u00eatre fourni pour stepper_left ; pour le param\u00e8tre stepper_right # ce param\u00e8tre prend par d\u00e9faut la valeur sp\u00e9cifi\u00e9e pour stepper_left. arm_length: # Longueur (en mm) de la tige diagonale reliant le chariot de la colonne \u00e0 la t\u00eate d'impression. # Ce param\u00e8tre doit \u00eatre fourni pour stepper_left. Pour le param\u00e8tre stepper_right, ce param\u00e8tre # prend par d\u00e9faut la valeur sp\u00e9cifi\u00e9e pour stepper_left. arm_x_length: # Distance horizontale entre la t\u00eate d'impression et la colonne lorsque l'imprimante est mise \u00e0 # l'origine. Ce param\u00e8tre doit \u00eatre fourni pour stepper_left ; pour stepper_right, ce param\u00e8tre # prend par d\u00e9faut la valeur sp\u00e9cifi\u00e9e pour stepper_left. # La section stepper_right est utilis\u00e9e pour d\u00e9crire le moteur pas \u00e0 pas contr\u00f4lant la colonne de droite. [stepper_right] # La section stepper_y est utilis\u00e9e pour d\u00e9crire le moteur pas \u00e0 pas contr\u00f4lant l'axe Y d'un robot deltesien. [stepper_y] Cin\u00e9matique CoreXY \u00b6 Voir example-corexy.cfg pour un exemple de fichier cin\u00e9matique corexy (et h-bot). Seuls les param\u00e8tres sp\u00e9cifiques aux imprimantes corexy sont d\u00e9crits ici - voir param\u00e8tres cin\u00e9matiques communs pour les param\u00e8tres disponibles. [printer] kinematics: corexy max_z_velocity: # Ceci d\u00e9finit la vitesse maximale (en mm/s) du mouvement le long de l'axe z # Ce param\u00e8tre peut \u00eatre utilis\u00e9 pour limiter la vitesse maximale du moteur pas \u00e0 pas z. # La valeur par d\u00e9faut est l'utilisation de max_velocity pour max_z_velocity. max_z_accel: # Ce param\u00e8tre d\u00e9finit l'acc\u00e9l\u00e9ration maximale (en mm/s^2) du mouvement sur l'axe z. # Cela limite l'acc\u00e9l\u00e9ration du moteur pas \u00e0 pas z. La valeur par d\u00e9faut est # d'utiliser max_accel pour max_z_accel. # La section stepper_x est utilis\u00e9e pour d\u00e9crire l'axe X ainsi que le moteur pas \u00e0 pas # contr\u00f4lant le mouvement X+Y. [stepper_x] # La section stepper_y est utilis\u00e9e pour d\u00e9crire l'axe Y ainsi que le moteur pas \u00e0 pas # contr\u00f4lant le mouvement X-Y. [stepper_y] # La section stepper_z est utilis\u00e9e pour d\u00e9crire le moteur pas \u00e0 pas contr\u00f4lant l'axe Z. [stepper_z] Cin\u00e9matique CoreXZ \u00b6 Voir example-corexz.cfg pour un exemple de fichier de configuration de cin\u00e9matique corexz. Seuls les param\u00e8tres sp\u00e9cifiques aux imprimantes corexz sont d\u00e9crits ici - voir param\u00e8tres cin\u00e9matiques communs pour les param\u00e8tres disponibles. [printer] kinematics: corexz max_z_velocity: # Ceci d\u00e9finit la vitesse maximale (en mm/s) du mouvement le long de l'axe z. # La valeur par d\u00e9faut est d'utiliser max_velocity pour max_z_velocity. max_z_accel: # Ceci d\u00e9finit l'acc\u00e9l\u00e9ration maximale (en mm/s^2) du mouvement le long de l'axe z. # La valeur par d\u00e9faut est d'utiliser max_accel pour max_z_accel. # La section stepper_x est utilis\u00e9e pour d\u00e9crire l'axe X ainsi que le moteur pas \u00e0 pas # contr\u00f4lant le mouvement X+Z. [stepper_x] # La section stepper_y est utilis\u00e9e pour d\u00e9crire le moteur pas \u00e0 pas contr\u00f4lant l'axe Y. [stepper_y] # La section stepper_z est utilis\u00e9e pour d\u00e9crire l'axe Z ainsi que le moteur pas \u00e0 pas # contr\u00f4lant le mouvement X-Z. [stepper_z] Cin\u00e9matique Hybride-CoreXY \u00b6 Voir example-hybrid-corexy.cfg pour un exemple de fichier de configuration de cin\u00e9matique hybride corexy. Cette cin\u00e9matique est \u00e9galement connue sous le nom de cin\u00e9matique Markforged. Seuls les param\u00e8tres sp\u00e9cifiques aux imprimantes hybrides corexy sont d\u00e9crits ici ; voir param\u00e8tres cin\u00e9matiques communs pour les param\u00e8tres disponibles. [printer] kinematics: hybrid_corexy max_z_velocity: # Ceci d\u00e9finit la vitesse maximale (en mm/s) du mouvement le long de l'axe z # La valeur par d\u00e9faut est d'utiliser max_velocity pour max_z_velocity. max_z_acce : # Ceci d\u00e9finit l'acc\u00e9l\u00e9ration maximale (en mm/s^2) du mouvement le long de l'axe z. # La valeur par d\u00e9faut est d'utiliser max_accel pour max_z_accel. # La section stepper_x est utilis\u00e9e pour d\u00e9crire l'axe X ainsi que le moteur pas \u00e0 pas # contr\u00f4lant le mouvement X-Y. [stepper_x] # La section stepper_y est utilis\u00e9e pour d\u00e9crire le moteur pas \u00e0 pas contr\u00f4lant # l'axe Y. [stepper_y] # La section stepper_z est utilis\u00e9e pour d\u00e9crire le moteur pas \u00e0 pas contr\u00f4lant # l'axe Z. [stepper_z] Cin\u00e9matique Hybride-CoreXZ \u00b6 Voir example-hybrid-corexz.cfg pour un exemple de fichier de configuration de cin\u00e9matique hybride corexz. Cette cin\u00e9matique est \u00e9galement connue sous le nom de cin\u00e9matique Markforged. Seuls les param\u00e8tres sp\u00e9cifiques aux imprimantes hybrides corexy sont d\u00e9crits ici ; voir param\u00e8tres cin\u00e9matiques communs pour les param\u00e8tres disponibles. [printer] kinematics: hybrid_corexz max_z_velocity: # Ceci d\u00e9finit la vitesse maximale (en mm/s) du mouvement le long de l'axe z # La valeur par d\u00e9faut est d'utiliser max_velocity pour max_z_velocity. max_z_accel: # Ceci d\u00e9finit l'acc\u00e9l\u00e9ration maximale (en mm/s^2) du mouvement le long de # l'axe z. La valeur par d\u00e9faut est d'utiliser max_accel pour max_z_accel. # La section stepper_x est utilis\u00e9e pour d\u00e9crire l'axe X ainsi que le moteur pas \u00e0 pas # contr\u00f4lant le mouvement X-Z. [stepper_x] # La section stepper_y est utilis\u00e9e pour d\u00e9crire le moteur pas \u00e0 pas contr\u00f4lant # l'axe Y. [stepper_y] # La section stepper_z est utilis\u00e9e pour d\u00e9crire le moteur pas \u00e0 pas contr\u00f4lant # l'axe Z. [stepper_z] Cin\u00e9matique polaire \u00b6 Voir example-polar.cfg pour un exemple de fichier de configuration de cin\u00e9matique polaire. Seuls les param\u00e8tres sp\u00e9cifiques aux imprimantes polaires sont d\u00e9crits ici - voir param\u00e8tres cin\u00e9matiques communs pour les param\u00e8tres disponibles. LA CIN\u00c9MATIQUE POLAIRE EST UN TRAVAIL EN COURS. Les d\u00e9placements autour de la position 0, 0 sont connus pour ne pas fonctionner correctement. [printer] kinematics: polar max_z_velocity: # Ceci d\u00e9finit la vitesse maximale (en mm/s) du mouvement le long de l'axe z # Ce param\u00e8tre peut \u00eatre utilis\u00e9 pour limiter la vitesse maximale du moteur z. # La valeur par d\u00e9faut est d'utiliser max_velocity pour max_z_velocity. max_z_accel: # Ce param\u00e8tre d\u00e9finit l'acc\u00e9l\u00e9ration maximale (en mm/s^2) du mouvement sur l'axe z. # Cela limite l'acc\u00e9l\u00e9ration du moteur pas \u00e0 pas z. La valeur par d\u00e9faut est d'utiliser # max_accel pour max_z_accel. # La section stepper_bed est utilis\u00e9e pour d\u00e9crire le moteur pas \u00e0 pas contr\u00f4lant # le lit. [stepper_bed] gear_ratio: # Un rapport de vitesse doit \u00eatre sp\u00e9cifi\u00e9 et la distance de rotation ne peut pas \u00eatre # sp\u00e9cifi\u00e9e. Par exemple, si le lit est \u00e9quip\u00e9 d'une poulie \u00e0 80 dents entra\u00een\u00e9e par un # moteur dont l'axe est muni d'une poulie \u00e0 16 dents, il faut sp\u00e9cifier le rapport # d'engrenage de \"80:16\". Ce param\u00e8tre doit \u00eatre fourni. # La section stepper_arm est utilis\u00e9e pour d\u00e9crire le moteur pas \u00e0 pas contr\u00f4lant # le chariot sur le bras. [stepper_arm] # La section stepper_z permet de d\u00e9crire le moteur pas \u00e0 pas contr\u00f4lant l'axe Z. [stepper_z] Cin\u00e9matique rotative delta \u00b6 Voir example-rotary-delta.cfg pour un exemple de fichier de configuration de cin\u00e9matique rotative delta. Seuls les param\u00e8tres sp\u00e9cifiques aux imprimantes rotatives delta sont d\u00e9crits ici - voir param\u00e8tres cin\u00e9matiques communs pour les param\u00e8tres disponibles. LA CIN\u00c9MATIQUE ROTATIVE DELTA EST UN TRAVAIL EN COURS. Les mouvements d'orientation peuvent d\u00e9passer le temps imparti et certains contr\u00f4les de limites ne sont pas impl\u00e9ment\u00e9s. [printer] kinematics: rotary_delta max_z_velocity: # Pour les imprimantes delta, ceci limite la vitesse maximale (en mm/s) des d\u00e9placements avec # mouvement de l'axe z. Ce param\u00e8tre peut \u00eatre utilis\u00e9 pour r\u00e9duire la vitesse maximale des # mouvements de mont\u00e9e/descente (n\u00e9cessitant un taux de pas plus \u00e9lev\u00e9 que les autres mouvements # sur une imprimante delta). La valeur par d\u00e9faut est d'utiliser max_velocity pour max_z_velocity. #minimum_z_position: 0 # La position Z minimale \u00e0 laquelle l'utilisateur peut ordonner \u00e0 la t\u00eate de se d\u00e9placer. # La valeur par d\u00e9faut est 0. shoulder_radius: # Rayon (en mm) du cercle horizontal form\u00e9 par les trois articulations de l'effecteur, moins le rayon # du cercle form\u00e9 par l'articulation de l'effecteur. # Ce param\u00e8tre peut \u00e9galement \u00eatre calcul\u00e9 comme suit # shoulder_radius = (delta_f - delta_e) / sqrt(12) # Ce param\u00e8tre doit \u00eatre fourni. shoulder_height: # Distance (en mm) des joints de l'effecteur par rapport au lit, moins la hauteur de la t\u00eate de l'outil # sur l'effecteur. Ce param\u00e8tre doit \u00eatre fourni. # La section stepper_a d\u00e9crit le moteur pas \u00e0 pas contr\u00f4lant le bras arri\u00e8re droit (\u00e0 30 degr\u00e9s). # Cette section contr\u00f4le \u00e9galement les param\u00e8tres de la mise \u00e0 l'origine (homing_speed, # homing_retract_dist) pour tous les bras. [stepper_a] gear_ratio: # Un rapport de vitesse doit \u00eatre sp\u00e9cifi\u00e9 et la rotation_distance ne peut pas \u00eatre sp\u00e9cifi\u00e9e. # Par exemple, si le bras a une poulie de 80 dents entra\u00een\u00e9e par une poulie de 16 dents, \u00e0 son # tour reli\u00e9e \u00e0 une poulie de 60 dents entra\u00een\u00e9e par un moteur dont l'arbre est muni d'une poulie # \u00e0 16 dents, alors on sp\u00e9cifierait un rapport de vitesse de \"80:16, 60:16\". # Ce param\u00e8tre doit \u00eatre fourni. position_endstop: # Distance (en mm) entre la buse et le lit lorsque la buse se trouve au centre de la zone de construction # et que la but\u00e9e se d\u00e9clenche. Ce param\u00e8tre doit \u00eatre fourni pour le stepper_a ; pour le stepper_b et # le stepper_c, ce param\u00e8tre prend par d\u00e9faut la valeur sp\u00e9cifi\u00e9e pour stepper_a. upper_arm_length: # Longueur (en mm) du bras reliant l'\"articulation de l'effecteur\" \u00e0 l'\"articulation du coude\". # Ce param\u00e8tre doit \u00eatre fourni pour stepper_a ; pour stepper_b et stepper_c, ce param\u00e8tre prend par # d\u00e9faut la valeur sp\u00e9cifi\u00e9e pour stepper_a. lower_arm_length: # Longueur (en mm) du bras reliant l'\"articulation du coude\" \u00e0 l'\"articulation de l'effecteur\". # Ce param\u00e8tre doit \u00eatre fourni pour stepper_a ; pour stepper_b et stepper_c, ce param\u00e8tre prend # par d\u00e9faut la valeur sp\u00e9cifi\u00e9e pour stepper_a. #angle: # Cette option sp\u00e9cifie l'angle (en degr\u00e9s) auquel se trouve le bras. # La valeur par d\u00e9faut est 30 pour stepper_a, 150 pour stepper_b et 270 pour stepper_c. # La section stepper_b d\u00e9crit le moteur pas \u00e0 pas contr\u00f4lant le bras arri\u00e8re gauche (\u00e0 150 degr\u00e9s). [stepper_b] # La section stepper_c d\u00e9crit le moteur pas \u00e0 pas contr\u00f4lant le bras avant (\u00e0 270 degr\u00e9s). [stepper_c] # La section delta_calibrate active une commande G-code \u00e9tendue DELTA_CALIBRATE permettant # de calibrer les positions de la but\u00e9e de l'effecteur. [delta_calibrate] radius: # Rayon (en mm) de la zone pouvant \u00eatre palp\u00e9e. Il s'agit du rayon des coordonn\u00e9es de palpage # de la buse; si vous utilisez un palpeur automatique avec un d\u00e9calage XY, choisissez un rayon # suffisamment petit pour que la sonde s'adapte toujours au lit. Ce param\u00e8tre doit \u00eatre fourni. #speed: 50 # La vitesse (en mm/s) des mouvements sans palpage pendant l'\u00e9talonnage. # La valeur par d\u00e9faut est 50. #horizontal_move_z: 5 # La hauteur (en mm) \u00e0 laquelle la t\u00eate doit \u00eatre remont\u00e9e pour se d\u00e9placer juste avant de lancer # une op\u00e9ration de palpage. La valeur par d\u00e9faut est 5. Cin\u00e9matique du treuil \u00e0 c\u00e2ble \u00b6 Voir le fichier example-winch.cfg pour un exemple de fichier de configuration cin\u00e9matique d'un treuil \u00e0 c\u00e2ble. Seuls les param\u00e8tres sp\u00e9cifiques aux imprimantes \u00e0 treuil sont d\u00e9crits ici - voir param\u00e8tres cin\u00e9matiques communs pour les param\u00e8tres disponibles. LE SUPPORT DU TREUIL \u00c0 C\u00c2BLE EST EXP\u00c9RIMENTAL. La mise \u00e0 l'origine n'est pas impl\u00e9ment\u00e9e dans la cin\u00e9matique du treuil \u00e0 c\u00e2ble. Pour ramener l'imprimante \u00e0 l'origine, envoyez des commandes manuelles de mouvements jusqu'\u00e0 ce que la t\u00eate de l'outil soit \u00e0 0, 0, 0, puis envoyez la commande G28 . [printer] kinematics: winch # La section stepper_a d\u00e9crit le moteur pas \u00e0 pas connect\u00e9 au premier treuil \u00e0 c\u00e2ble. # Un minimum de 3 et un maximum de 26 treuils \u00e0 c\u00e2ble peuvent \u00eatre d\u00e9finis # (stepper_a \u00e0 stepper_z) bien qu'il soit courant d'en d\u00e9finir 4. [stepper_a] rotation_distance: # La rotation_distance est la distance nominale (en mm) \u00e0 laquelle la t\u00eate de l'outil # se d\u00e9place vers le treuil de c\u00e2ble pour chaque rotation compl\u00e8te du moteur pas # \u00e0 pas. Ce param\u00e8tre doit \u00eatre fourni. anchor_x: anchor_y: anchor_z: # Les positions X, Y et Z du treuil \u00e0 c\u00e2ble dans l'espace cart\u00e9sien. # Ces param\u00e8tres doivent \u00eatre fournis. Aucune cin\u00e9matique \u00b6 Il est possible de d\u00e9finir une cin\u00e9matique particuli\u00e8re \"aucune (none)\" pour d\u00e9sactiver le support cin\u00e9matique dans Klipper. Cela peut \u00eatre utile pour contr\u00f4ler des p\u00e9riph\u00e9riques qui ne sont pas des imprimantes 3D typiques ou encore \u00e0 des fins de d\u00e9bogage. [printer] kinematics: none max_velocity: 1 max_accel: 1 # Les param\u00e8tres max_velocity et max_accel doivent \u00eatre d\u00e9finis. Les # valeurs par d\u00e9faut ne sont pas utilis\u00e9es pour la cin\u00e9matique \"none\". Extrudeur commun et support du lit chauffant \u00b6 [extruder] \u00b6 La section de l'extrudeuse est utilis\u00e9e pour d\u00e9crire les param\u00e8tres de chauffe de la buse ainsi que pour les commandes pas \u00e0 pas de l'extrudeuse. Voir la r\u00e9f\u00e9rence de commande pour plus d'informations. Voir le guide d'avance de pression pour des informations sur le r\u00e9glage de l'avance de pression. [extruder] step_pin: dir_pin: enable_pin: microsteps: rotation_distance: #full_steps_per_rotation: #gear_ratio: # Voir la section \"stepper\" pour une description des param\u00e8tres ci-dessus. # Si aucun des param\u00e8tres ci-dessus n'est sp\u00e9cifi\u00e9, alors aucun pilote ne # sera associ\u00e9 \u00e0 la buse (bien qu'une commande SYNC_EXTRUDER_MOTION # puisse en associer un au moment de l'ex\u00e9cution). nozzle_diameter: # Diam\u00e8tre de l'orifice de la buse (en mm). Ce param\u00e8tre doit \u00eatre # fourni. filament_diameter: # Diam\u00e8tre moyen du filament (en mm) lorsqu'il entre dans l'extrudeuse. # Ce param\u00e8tre doit \u00eatre fourni. #max_extrude_cross_section: # Surface maximale (en mm^2) d'une section transversale d'extrusion (ex: # largeur de l'extrusion multipli\u00e9e par la hauteur de la couche). Ce param\u00e8tre # permet d'\u00e9viter d'extruder des quantit\u00e9s excessives durant de petits d\u00e9placements # XY. Si un d\u00e9placement demande une quantit\u00e9 d'extrusion sup\u00e9rieure \u00e0 cette valeur, # une erreur sera renvoy\u00e9e. La valeur par d\u00e9faut est 4.0 *diam\u00e8tre_buse^2 #instantaneous_corner_velocity: 1.000 # La variation instantan\u00e9e maximale de la vitesse (en mm/s) de l'extrudeuse # pendant la jonction de deux mouvements. La valeur par d\u00e9faut est 1mm/s. #max_extrude_only_distance: 50.0 # Longueur maximale (en mm de filament) qu'un mouvement de r\u00e9traction ou d'extrusion # peut fournir. Si un mouvement de r\u00e9traction ou d'extrusion unique demande une # distance sup\u00e9rieure \u00e0 cette valeur, une erreur sera renvoy\u00e9e. # La valeur par d\u00e9faut est 50mm. #max_extrude_only_velocity: #max_extrude_only_accel: # Vitesse maximale (en mm/s) et acc\u00e9l\u00e9ration (en mm/s^2) du moteur de l'extrudeuse # pour les r\u00e9tractions et les mouvements d'extrusion seuls. Ces param\u00e8tres n'ont aucun # impact sur les mouvements d'impression normaux. S'ils ne sont pas sp\u00e9cifi\u00e9s, ils sont # calcul\u00e9s pour correspondre \u00e0 la limite d'un mouvement qu'une impression de # section transversale de 4.0*diam\u00e8tre_buse^2 aurait. #pressure_advance: 0.0 # La quantit\u00e9 de filament \u00e0 pousser dans l'extrudeuse durant l'acc\u00e9l\u00e9ration de celle-ci. # Une quantit\u00e9 \u00e9gale de filament est r\u00e9tract\u00e9e durant la d\u00e9c\u00e9l\u00e9ration. Elle est mesur\u00e9e # en millim\u00e8tre/seconde. La valeur par d\u00e9faut est 0, ce qui d\u00e9sactive la fonctionnalit\u00e9 # d'avance de pression. #pressure_advance_smooth_time: 0.040 # Une dur\u00e9e (en secondes) \u00e0 utiliser lors du calcul de la vitesse moyenne de l'extrudeuse # pour l'avance de pression. Une valeur plus grande donne lieu \u00e0 des mouvements # d'extrusion plus lisses. Ce param\u00e8tre ne doit pas d\u00e9passer 200ms. # Ce param\u00e8tre ne s'applique que si pressure_advance est diff\u00e9rent de z\u00e9ro. La valeur # par d\u00e9faut est 0.040 (40 millisecondes). # # Les variables restantes d\u00e9crivent la chauffe de l'extrudeuse. heater_pin: # Broche de sortie PWM contr\u00f4lant le chauffage. Ce param\u00e8tre doit \u00eatre # fourni. #max_power: 1.0 # La puissance maximale (exprim\u00e9e sous la forme d'une valeur comprise entre 0,0 et 1,0) # de r\u00e9glage du heater_pin . La valeur 1.0 permet \u00e0 la broche d'\u00eatre r\u00e9gl\u00e9e comme toujours # activ\u00e9e durant des p\u00e9riodes prolong\u00e9es, tandis qu'une valeur de 0,5 permet \u00e0 la broche # de n'\u00eatre activ\u00e9e durant au plus la moiti\u00e9 du temps. # Ce r\u00e9glage peut \u00eatre utilis\u00e9 pour limiter la puissance totale de sortie (sur de longues # p\u00e9riodes) de l'\u00e9l\u00e9ment de chauffe. La valeur par d\u00e9faut est 1.0. sensor_type: # Type de capteur - les thermistances courantes sont \"EPCOS 100K B57560G104F\", # \"ATC Semitec 104GT-2\", \"ATC Semitec 104NT-4-R025H42G\", \"Generic # 3950\", \"Honeywell 100K 135-104LAG-J01\", \"NTC 100K MGB18-104F39050L32\", # \"SliceEngineering 450\", et \"TDK NTCG104LH104JT1\". Voir la section \"Capteurs de # temp\u00e9rature\" pour d'autres capteurs. # Ce param\u00e8tre doit \u00eatre fourni. sensor_pin: # Broche d'entr\u00e9e analogique connect\u00e9e au capteur. Ce param\u00e8tre doit \u00eatre # fourni. #pullup_resistor: 4700 # La r\u00e9sistance (en ohms) du pullup reli\u00e9 \u00e0 la thermistance. # Ce param\u00e8tre n'est valable que si le capteur est une thermistance. La valeur par # d\u00e9faut est 4700 ohms. #smooth_time: 1.0 # Une dur\u00e9e (en secondes) sur laquelle les mesures de temp\u00e9rature seront # liss\u00e9es pour r\u00e9duire l'impact du bruit de la mesure. La valeur par d\u00e9faut # est de 1 seconde. control: # Algorithme de contr\u00f4le (soit pid, soit filigrane (watermark)). Ce param\u00e8tre doit # \u00eatre fourni. pid_Kp: pid_Ki: pid_Kd: # Les param\u00e8tres proportionnels (pid_Kp), int\u00e9graux (pid_Ki) et d\u00e9riv\u00e9s (pid_Kd) du syst\u00e8me de # contr\u00f4le de r\u00e9troaction PID. Klipper \u00e9value les param\u00e8tres PID avec la formule g\u00e9n\u00e9rale suivante : # heater_pwm = (Kp*erreur + Ki*int\u00e9grale(erreur) - Kd*d\u00e9riv\u00e9e(erreur)) / 255 # O\u00f9 \"erreur\" est le r\u00e9sultat de \"requested_temperature - measured_temperature\" et # \"heater_pwm\" est le taux de chauffage demand\u00e9, 0.0 \u00e9tant compl\u00e8tement \u00e9teint et 1.0 \u00e9tant # compl\u00e8tement allum\u00e9. Pensez \u00e0 utiliser la commande PID_CALIBRATE pour obtenir ces param\u00e8tres. # Les param\u00e8tres pid_Kp, pid_Ki, et pid_Kd doivent \u00eatre fournis pour les \u00e9l\u00e9ments de chauffe PID. #max_delta: 2.0 # Sur les \u00e9l\u00e9ments de chauffe contr\u00f4l\u00e9s par un filigrane (watermark), il s'agit du nombre de degr\u00e9s en # Celsius au-dessus de la temp\u00e9rature cible avant de d\u00e9sactiver le chauffage ainsi que le nombre de # degr\u00e9s en dessous de la temp\u00e9rature cible avant la r\u00e9activation du chauffage. La valeur par d\u00e9faut # est de 2 degr\u00e9s Celsius. #pwm_cycle_time: 0.100 # Dur\u00e9e en secondes de chaque cycle PWM logiciel du chauffage. Il n'est # pas recommand\u00e9 de d\u00e9finir cette valeur, sauf s'il existe une exigence # \u00e9lectrique pour commuter le chauffage plus rapidement que 10 fois par seconde. # La valeur par d\u00e9faut est 0,100 seconde. #min_extrude_temp: 170 # La temp\u00e9rature minimale (en Celsius) au-dessus de laquelle les commandes de d\u00e9placement de # l'extrudeuse peuvent \u00eatre \u00e9mises. La valeur par d\u00e9faut est 170 Celsius. min_temp: max_temp: # La plage maximale de temp\u00e9ratures valides (en Celsius) dans laquelle l'\u00e9l\u00e9ment de chauffe doit rester. # Ceci contr\u00f4le une fonction de s\u00e9curit\u00e9 impl\u00e9ment\u00e9e dans le code du micro-contr\u00f4leur - si la temp\u00e9rature # mesur\u00e9e sort de cette plage, le microcontr\u00f4leur se met en \u00e9tat d'arr\u00eat. # Ce contr\u00f4le peut aider \u00e0 d\u00e9tecter certaines d\u00e9faillances mat\u00e9rielles de l'\u00e9l\u00e9ment chauffant et/ou du capteur. # D\u00e9finissez cette plage suffisamment large pour que des temp\u00e9ratures raisonnables n'entra\u00eenent pas d'erreur. # Ces param\u00e8tres doivent \u00eatre fournis. [heater_bed] \u00b6 La section heater_bed concerne le lit chauffant. Elle utilise les m\u00eames param\u00e8tres de mise en chauffe que ceux d\u00e9crits dans la section \"extrudeuse\". [heater_bed] heater_pin: sensor_type: sensor_pin: control: min_temp: max_temp: # Voir la section \"extruder\" pour une description des param\u00e8tres ci-dessus. Support du nivelage du lit \u00b6 [bed_mesh] \u00b6 Nivelage du maillage du lit. On peut d\u00e9finir une section de configuration bed_mesh pour activer les transformations de d\u00e9placement qui d\u00e9calent l'axe z en fonction d'un maillage g\u00e9n\u00e9r\u00e9 \u00e0 partir de points palp\u00e9s. Lorsqu'on utilise une sonde pour d\u00e9finir l'origine de l'axe z, il est recommand\u00e9 de d\u00e9finir une section safe_z_home dans printer.cfg pour r\u00e9aliser cette mise \u00e0 l'origine au centre de la zone d'impression. Consultez le guide du maillage du lit et la r\u00e9f\u00e9rence de la commande pour plus d'informations. Exemples visuels : lit rectangulaire, probe_count = 3, 3: x---x---x (max_point) | x---x---x | (min_point) x---x---x lit circulaire, round_probe_count = 5, bed_radius = r: x (0, r) fin / x---x---x \\ (-r, 0) x---x---x---x---x (r, 0) \\ x---x---x / x (0, -r) d\u00e9but [bed_mesh] #speed: 50 # La vitesse (en mm/s) des d\u00e9placements entre les points de palpage # durant l'\u00e9talonnage. # La valeur par d\u00e9faut est 50. #horizontal_move_z: 5 # La hauteur (en mm) \u00e0 laquelle la t\u00eate doit \u00eatre relev\u00e9e juste avant de # lancer une op\u00e9ration de palpage. La valeur par d\u00e9faut est 5. #mesh_radius: # D\u00e9finit le rayon de la maille \u00e0 palper pour les lits circulaires. Notez que # le rayon est relatif aux coordonn\u00e9es sp\u00e9cifi\u00e9es par l'option # mesh_origin. Ce param\u00e8tre doit \u00eatre fourni pour des lits circulaires # et omis pour des lits rectangulaires. #mesh_origin: # D\u00e9finit les coordonn\u00e9es X, Y du centre du maillage des lits circulaires. Ces # coordonn\u00e9es sont relatives \u00e0 l'emplacement de la sonde. Il peut \u00eatre utile # d'ajuster l'origine du maillage afin de maximiser la taille du rayon du maillage. # La valeur par d\u00e9faut est 0, 0. Ce param\u00e8tre doit \u00eatre omis pour des lits rectangulaires. #mesh_min: # D\u00e9finit les coordonn\u00e9es X, Y minimales du maillage pour les lits rectangulaires. # Ces coordonn\u00e9es sont relatives \u00e0 l'emplacement de la sonde. Cette position # sera le premier point sond\u00e9, le plus proche de l'origine. Ce param\u00e8tre doit # \u00eatre fourni pour des lits rectangulaires. #mesh_max: # D\u00e9finit les coordonn\u00e9es X, Y maximales du maillage pour les lits rectangulaires. # Le principe est le m\u00eame que pour mesh_min, mais ce sera le point le plus \u00e9loign\u00e9 # atteignable par rapport \u00e0 l'origine du lit. Ce param\u00e8tre doit \u00eatre fourni pour # des lits rectangulaires. #probe_count: 3, 3 # Pour les lits rectangulaires, il s'agit d'une paire d'entiers X, Y s\u00e9par\u00e9s par des virgules, # d\u00e9finissant le nombre de points \u00e0 palper le long de chaque axe. # Une valeur seule est \u00e9galement valide, auquel cas cette valeur sera appliqu\u00e9e aux # deux axes. La valeur par d\u00e9faut est 3, 3. #round_probe_count: 5 # Pour les lits circulaires, cette valeur enti\u00e8re d\u00e9finit le nombre maximum de points # \u00e0 palper le long de chaque axe. Cette valeur doit \u00eatre un nombre impair. # La valeur par d\u00e9faut est 5. #fade_start: 1.0 # La position z du gcode \u00e0 partir de laquelle il faut commencer \u00e0 \u00e9liminer progressivement # l'ajustement z lorsque la compensation est activ\u00e9e. La valeur par d\u00e9faut est 1.0. #fade_end: 0.0 # La position z du gcode \u00e0 partir de laquelle la compensation se termine. Lorsqu'elle est # d\u00e9finie \u00e0 une valeur inf\u00e9rieure \u00e0 fade_start, la compensation est d\u00e9sactiv\u00e9e. Notez que # la compensation peut ajouter une mise \u00e0 l'\u00e9chelle ind\u00e9sirable le long de l'axe z d'une impression. # Si un utilisateur souhaite activer la compensation, une valeur de 10.0 est recommand\u00e9e. # La valeur par d\u00e9faut est 0.0, ce qui d\u00e9sactive la compensation. #fade_target: # La position z vers laquelle la compensation doit converger. Lorsque cette valeur est # d\u00e9finie \u00e0 une valeur non nulle, elle doit se situer dans la plage des valeurs z du maillage. # Les utilisateurs qui souhaitent converger vers la position de mise \u00e0 l'origine du Z # doivent r\u00e9gler cette valeur \u00e0 0. # La valeur par d\u00e9faut est la valeur z moyenne du maillage. #split_delta_z: .025 # Le delta de diff\u00e9rence de Z (en mm) le long d'un mouvement qui d\u00e9clenchera une s\u00e9paration. # La valeur par d\u00e9faut est de 0,025. #move_check_distance: 5.0 # La distance (en mm) le long d'un mouvement pour v\u00e9rifier le split_delta_z. # C'est \u00e9galement la longueur minimale pour laquelle un mouvement peut \u00eatre divis\u00e9. # La valeur par d\u00e9faut est 5.0. #mesh_pps: 2, 2 # Une paire de nombres entiers X, Y s\u00e9par\u00e9s par des virgules, d\u00e9finissant le nombre de # points par segment \u00e0 interpoler dans le maillage le long de chaque axe. Un \"segment\" # \u00e9tant d\u00e9fini comme l'espace entre chaque point palp\u00e9. # L'utilisateur peut saisir une seule valeur qui sera appliqu\u00e9e aux deux axes. # La valeur par d\u00e9faut est 2, 2. #algorithme: lagrange # L'algorithme d'interpolation \u00e0 utiliser. Soit \"lagrange\", soit \"bicubic\". Cette option # n'affecte pas les grilles 3x3 forc\u00e9es d'utiliser l'\u00e9chantillonnage de lagrange. # La valeur par d\u00e9faut est lagrange. #bicubic_tension: .2 # Lors de l'utilisation de l'algorithme bicubic, le param\u00e8tre de tension ci-dessus peut # \u00eatre appliqu\u00e9 pour modifier la quantit\u00e9 de pente interpol\u00e9e. # Des nombres plus grands augmenteront la quantit\u00e9 de pente entra\u00eenant une plus grande # courbure du maillage. La valeur par d\u00e9faut est 0,2. #relative_reference_index: # Un index de points dans le maillage auquel r\u00e9f\u00e9rencer toutes les valeurs z. En activant # ce param\u00e8tre, on produit un maillage relatif \u00e0 la position z palp\u00e9e de l'indice fourni. #faulty_region_1_min: #faulty_region_1_max: # Points optionnels d\u00e9finissant une r\u00e9gion d\u00e9fectueuse. Voir docs/Bed_Mesh.md pour # plus de d\u00e9tails sur les r\u00e9gions d\u00e9fectueuses. Jusqu'\u00e0 99 r\u00e9gions d\u00e9fectueuses peuvent # \u00eatre ajout\u00e9es. # Par d\u00e9faut, aucune r\u00e9gion d\u00e9fectueuse n'est d\u00e9finie. [bed_tilt] \u00b6 Compensation de l'inclinaison du lit. On peut d\u00e9finir une section de configuration bed_tilt pour activer les transformations de d\u00e9placement tenant compte d'un lit inclin\u00e9. Notez que bed_mesh et bed_tilt sont incompatibles ; les deux ne peuvent pas \u00eatre d\u00e9finis en m\u00eame temps. Voir la r\u00e9f\u00e9rence des commandes pour plus d'informations. [bed_tilt] #x_adjust: 0 # Quantit\u00e9 \u00e0 ajouter \u00e0 la hauteur Z de chaque mouvement pour chaque mm sur l'axe X. # La valeur par d\u00e9faut est 0. #y_adjust: 0 # Quantit\u00e9 \u00e0 ajouter \u00e0 la hauteur Z de chaque mouvement pour chaque mm sur l'axe Y. # La valeur par d\u00e9faut est 0. #z_adjust: 0 # Quantit\u00e9 \u00e0 ajouter \u00e0 la hauteur Z lorsque la buse est nominalement \u00e0 0, 0. # La valeur par d\u00e9faut est 0. # Les param\u00e8tres suivants contr\u00f4lent la commande g-code \u00e9tendue BED_TILT_CALIBRATE # utilis\u00e9e pour calibrer les param\u00e8tres de r\u00e9glage x et y appropri\u00e9s. #points: # Une liste de coordonn\u00e9es X, Y (une par ligne ; les lignes suivantes indent\u00e9es) devant # \u00eatre palp\u00e9es pendant une commande BED_TILT_CALIBRATE # Sp\u00e9cifiez les coordonn\u00e9es de la buse et assurez-vous que la sonde est au-dessus du lit # aux coordonn\u00e9es donn\u00e9es de la buse. # La valeur par d\u00e9faut est de ne pas activer la commande. #speed: 50 # Vitesse (en mm/s) des mouvements de d\u00e9placements hors palpage pendant l'\u00e9talonnage. # La valeur par d\u00e9faut est 50. #horizontal_move_z: 5 # Hauteur (en mm) \u00e0 laquelle la t\u00eate doit \u00eatre relev\u00e9e lors du d\u00e9placement juste avant # de lancer une op\u00e9ration de palpage. La valeur par d\u00e9faut est 5. [bed_screws] \u00b6 Outil d'aide au r\u00e9glage des vis de nivellement du lit. On peut d\u00e9finir une section de configuration [bed_screws] pour activer une commande g-code BED_SCREWS_ADJUST. Consultez le guide de nivelage et la r\u00e9f\u00e9rence des commandes pour plus d'informations. [bed_screws] #screw1: # Coordonn\u00e9es X, Y de la premi\u00e8re vis de r\u00e9glage du niveau du lit. Il s'agit de la # position vers laquelle d\u00e9placer la buse afin qu'elle soit plac\u00e9e au-dessus de cette # vis de r\u00e9glage (ou aussi proche que possible tout en \u00e9tant au-dessus du lit). # Ce param\u00e8tre doit \u00eatre fourni. #screw1_name: # Un nom arbitraire pour la vis donn\u00e9e. Ce nom est affich\u00e9 lors de # l'ex\u00e9cution du script d'aide. Par d\u00e9faut, le nom utilis\u00e9 est bas\u00e9 sur # la position XY de la vis. #screw1_fine_adjust : # Coordonn\u00e9es X, Y pour commander la buse afin de pouvoir affiner le r\u00e9glage de la vis de mise # \u00e0 niveau du lit. Par d\u00e9faut, il n'y a pas de r\u00e9glage fin sur la vis de mise \u00e0 niveau du lit. #screw2: #screw2_name: #screw2_fine_adjust: #... # Vis suppl\u00e9mentaires de mise \u00e0 niveau du lit. Au moins trois vis doivent \u00eatre # d\u00e9finies. #horizontal_move_z: 5 # Hauteur (en mm) \u00e0 laquelle la t\u00eate doit \u00eatre relev\u00e9e pour se d\u00e9placer # lors du passage d'une vis \u00e0 la suivante. La valeur par d\u00e9faut est 5. #probe_height: 0 # Hauteur de la sonde (en mm) apr\u00e8s ajustement d\u00fb \u00e0 la dilatation thermique # du lit et de la buse. La valeur par d\u00e9faut est z\u00e9ro. #speed: 50 # Vitesse (en mm/s) des d\u00e9placements entre les palpages pendant l'\u00e9talonnage. # La valeur par d\u00e9faut est 50. #probe_speed: 5 # Vitesse (en mm/s) lors du d\u00e9placement d'une position horizontal_move_z # \u00e0 la position probe_height. La valeur par d\u00e9faut est 5. [screws_tilt_adjust] \u00b6 Outil d'assistance au nivellement du lit avec les vis de r\u00e9glage et l'aide du palpeur Z. On peut d\u00e9finir une section de configuration screws_tilt_adjust pour activer une commande g-code SCREWS_TILT_CALCULATE. Voir le guide de nivelage et la r\u00e9f\u00e9rence des commandes pour des informations suppl\u00e9mentaires. [screws_tilt_adjust] #screw1: # Les coordonn\u00e9es (X, Y) de la premi\u00e8re vis de mise \u00e0 niveau du lit. Il s'agit d'une # position \u00e0 laquelle d\u00e9placer la buse de mani\u00e8re \u00e0 ce que la sonde soit directement # au-dessus de la vis de mise \u00e0 niveau du lit (ou aussi pr\u00e8s que possible tout en \u00e9tant # encore au-dessus du lit). Il s'agit de la vis de base utilis\u00e9e dans les calculs. # Ce param\u00e8tre doit \u00eatre fourni. #screw1_name: # Un nom arbitraire pour la vis donn\u00e9e. Ce nom est affich\u00e9 lorsque le script d'aide # s'ex\u00e9cute. Par d\u00e9faut, le nom utilis\u00e9 est bas\u00e9 sur la position XY de la vis. #screw2: #screw2_name: #... # Vis suppl\u00e9mentaires de mise \u00e0 niveau du lit. Au moins deux vis doivent \u00eatre # d\u00e9finies. #speed: 50 # La vitesse (en mm/s) des d\u00e9placements sans palpage pendant l'\u00e9talonnage. # La valeur par d\u00e9faut est 50. #horizontal_move_z: 5 # La hauteur (en mm) \u00e0 laquelle la t\u00eate doit \u00eatre lev\u00e9e pour se d\u00e9placer juste # avant de lancer une op\u00e9ration de palpage. La valeur par d\u00e9faut est 5. #screw_thread: CW-M3 # Le type de vis utilis\u00e9e pour le niveau du lit, M3, M4 ou M5 et la direction de la molette # utilis\u00e9e pour le nivelage du lit, diminution dans le sens des aiguilles d'une montre, # augmentation dans le sens inverse des aiguilles d'une montre. # Valeurs accept\u00e9es : CW-M3, CCW-M3, CW-M4, CCW-M4, CW-M5, CCW-M5. # La valeur par d\u00e9faut est CW-M3. De nombreuses imprimantes utilisent une vis M3, # un tour de molette dans le sens des aiguilles d'une montre diminue la distance. [z_tilt] \u00b6 R\u00e9glage multiples de l'inclinaison de moteurs pas \u00e0 pas de l'axe Z. Cette fonction permet d'ajuster de mani\u00e8re ind\u00e9pendante l'inclinaison de plusieurs moteurs Z (voir la section \"stepper_z1\"). Si cette section est pr\u00e9sente, une commande G-Code \u00e9tendue Z_TILT_ADJUST devient disponible. [z_tilt] #z_positions: # Une liste de coordonn\u00e9es X, Y (une par ligne ; les lignes subs\u00e9quentes # indent\u00e9es) d\u00e9crivant l'emplacement de chaque \"point de pivot\" du lit. # Le \"point de pivot\" est le point o\u00f9 le lit s'attache \u00e0 l'\u00e9l\u00e9ment Z # donn\u00e9. Il est d\u00e9crit \u00e0 l'aide des coordonn\u00e9es de la buse (la position X, Y # de la buse si elle pouvait se d\u00e9placer directement au-dessus du point). La # premi\u00e8re entr\u00e9e correspond \u00e0 stepper_z, la deuxi\u00e8me \u00e0 stepper_z1, # la troisi\u00e8me \u00e0 stepper_z2, etc. Ce param\u00e8tre doit \u00eatre fourni. #points: # Une liste de coordonn\u00e9es X, Y (une par ligne ; les lignes ult\u00e9rieures # indent\u00e9es) qui doivent \u00eatre palp\u00e9es pendant une commande Z_TILT_ADJUST. # Sp\u00e9cifiez les coordonn\u00e9es de la buse et assurez-vous que le palpeur est # au-dessus du lit aux coordonn\u00e9es donn\u00e9es de la buse. # Ce param\u00e8tre doit \u00eatre fourni. #speed: 50 # La vitesse (en mm/s) des mouvements de d\u00e9placements hors palpage # pendant l'\u00e9talonnage. La valeur par d\u00e9faut est 50. #horizontal_move_z: 5 # Hauteur (en mm) \u00e0 laquelle la t\u00eate doit \u00eatre relev\u00e9e pour se d\u00e9placer juste # avant de lancer une op\u00e9ration de palpage. La valeur par d\u00e9faut est 5. #retries: 0 # Nombre de tentatives \u00e0 effectuer si les points palp\u00e9s ne sont pas dans la # tol\u00e9rance. #retry_tolerance: 0 # Si les r\u00e9-essais sont activ\u00e9s, r\u00e9essayer si les points sond\u00e9s les plus grands et # les plus petits diff\u00e8rent plus que la tol\u00e9rance retry_tolerance. Notez que la # plus petite unit\u00e9 de changement ici serait un seul pas. Cependant, si vous # sondez plus de points que de moteurs, il est probable que vous aurez une # valeur minimale fixe pour la plage de points sond\u00e9s. Vous pouvez en # apprendre plus en observant la sortie de la commande. [quad_gantry_level] \u00b6 Mise \u00e0 niveau du portique mobile \u00e0 l'aide de 4 moteurs Z contr\u00f4l\u00e9s ind\u00e9pendamment. Corrige les effets de paraboles hyperboliques (chips de pommes de terre) sur un portique mobile qui est plus flexible. AVERTISSEMENT : l'utilisation de cette section sur un lit mobile peut conduire \u00e0 des r\u00e9sultats ind\u00e9sirables. Si cette section est pr\u00e9sente, une commande G-Code \u00e9tendue QUAD_GANTRY_LEVEL devient disponible. Cette routine suppose la configuration suivante des moteurs Z : ---------------- |Z1 Z2| | --------- | | | | | | | | | | x-------- | |Z Z3| ---------------- O\u00f9 x est la position 0, 0 sur le lit [quad_gantry_level] #gantry_corners: # Une liste de coordonn\u00e9es X, Y, s\u00e9par\u00e9es par des retours \u00e0 la ligne, d\u00e9crivant les deux # coins oppos\u00e9s du portique. La premi\u00e8re entr\u00e9e correspond \u00e0 Z, la seconde \u00e0 Z2. # Ce param\u00e8tre doit \u00eatre fourni. #points: # Une liste, s\u00e9par\u00e9e par des retours \u00e0 la ligne, de quatre points X, Y devant \u00eatre palp\u00e9s # pendant une commande QUAD_GANTRY_LEVEL. L'ordre des emplacements est # important, il doit correspondre aux emplacements Z, Z1, Z2 et Z3 dans l'ordre. # Ce param\u00e8tre doit \u00eatre fourni. Pour une pr\u00e9cision maximale, assurez-vous que les # d\u00e9calages de votre sonde sont configur\u00e9s. #speed: 50 # La vitesse (en mm/s) des mouvements sans palpage pendant l'\u00e9talonnage. # La valeur par d\u00e9faut est 50. #horizontal_move_z: 5 # La hauteur (en mm) \u00e0 laquelle la t\u00eate doit \u00eatre relev\u00e9e pour se d\u00e9placer juste # avant de lancer une op\u00e9ration de palpage. La valeur par d\u00e9faut est 5. #max_adjust: 4 # Limite de s\u00e9curit\u00e9 quand un ajustement sup\u00e9rieur \u00e0 cette valeur est demand\u00e9. # quad_gantry_level abandonnera. #retries: 0 # Nombre de tentatives si les points palp\u00e9s ne sont pas dans la tol\u00e9rance. #retry_tolerance: 0 # Si les re-tentatives (retries) sont activ\u00e9es, r\u00e9essayer si les points palp\u00e9s les plus grands # et les plus petits diff\u00e8rent plus que la tol\u00e9rance de re-tentative (retry_tolerance). [skew_correction] \u00b6 Correction de l'inclinaison de l'imprimante. Il est possible de corriger l'inclinaison de l'imprimante logiciellement sur 3 plans, xy, xz, yz. Pour ce faire, on imprime un mod\u00e8le d'\u00e9talonnage le long d'un plan et on mesure trois longueurs. En raison de la nature de la correction d'inclinaison, ces longueurs sont d\u00e9finies via le gcode. Voir Correction d'inclinaison et R\u00e9f\u00e9rence des commandes pour plus de d\u00e9tails. [skew_correction] [z_thermal_adjust] \u00b6 Ajustement de la position Z de la t\u00eate d'impression en fonction de la temp\u00e9rature. Compenser le mouvement vertical de la t\u00eate d'impression caus\u00e9 par la dilatation thermique du ch\u00e2ssis de l'imprimante en temps r\u00e9el \u00e0 l'aide d'un capteur de temp\u00e9rature (g\u00e9n\u00e9ralement coupl\u00e9 \u00e0 une section verticale du ch\u00e2ssis). Voir aussi : commandes de code G \u00e9tendues . [z_thermal_adjust] #temp_coeff: # Le coefficient de dilatation thermique, en mm/\u00b0C. Par exemple, un # temp_coeff de 0,01 mm/\u00b0C d\u00e9placera l'axe Z vers le bas de 0,01 mm pour # chaque degr\u00e9 Celsius d'augmentation du capteur de temp\u00e9rature. La # valeur par d\u00e9faut, 0,0 mm/\u00b0C, n'applique aucun ajustement. #smooth_time: # Fen\u00eatre de lissage appliqu\u00e9e au capteur de temp\u00e9rature, en secondes. # Peut r\u00e9duire le bruit du moteur d\u00fb \u00e0 de petites corrections excessives en # r\u00e9ponse au bruit du capteur. La valeur par d\u00e9faut est de 2,0 secondes. #z_adjust_off_above: # D\u00e9sactive les ajustements au-dessus de cette hauteur Z [mm]. La derni\u00e8re # correction calcul\u00e9e restera appliqu\u00e9e jusqu'\u00e0 ce que la t\u00eate de l'outil passe # \u00e0 nouveau en dessous de la hauteur Z sp\u00e9cifi\u00e9e. La valeur par d\u00e9faut est # 99999999.0 mm (toujours actif). #max_z_adjustment: # Ajustement absolu maximal pouvant \u00eatre appliqu\u00e9 \u00e0 l'axe Z [mm]. # La valeur par d\u00e9faut est 99999999.0 mm (illimit\u00e9). #sensor_type: #sensor_pin: #min_temp: #max_temp: # Configuration du capteur de temp\u00e9rature. # Voir la section \"extrudeuse\" pour la d\u00e9finition des param\u00e8tres ci-dessus. #gcode_id: # Voir la section \"heater_generic\" pour la d\u00e9finition de ce # param\u00e8tre. Mise \u00e0 l'origine personnalis\u00e9e \u00b6 [safe_z_home] \u00b6 Mise \u00e0 l'origine s\u00fbre de l'axe Z. On peut utiliser ce m\u00e9canisme pour centrer l'axe Z sur des coordonn\u00e9es X, Y sp\u00e9cifiques. Ceci est utile si la t\u00eate de l'outil, par exemple, doit se d\u00e9placer vers le centre du lit avant que l'axe Z puisse \u00eatre mis \u00e0 l'origine. [safe_z_home] home_xy_position: # Une coordonn\u00e9e X, Y (par exemple 100, 100) o\u00f9 la mise \u00e0 l'origine Z doit \u00eatre # effectu\u00e9e. Ce param\u00e8tre doit \u00eatre fourni. #speed: 50.0 # Vitesse \u00e0 laquelle la t\u00eate de l'outil est d\u00e9plac\u00e9e vers la position de r\u00e9f\u00e9rence Z s\u00fbre. # La valeur par d\u00e9faut est 50 mm/s #z_hop: # Distance (en mm) pour lever l'axe Z avant le retour au point d'origine. Cette valeur est # appliqu\u00e9e \u00e0 toute commande d'initialisation, m\u00eame si elle n'initialise pas l'axe Z. # Si l'axe Z est d\u00e9j\u00e0 ramen\u00e9 \u00e0 la position de base et que la position Z actuelle est inf\u00e9rieure # \u00e0 z_hop, alors ceci l\u00e8vera la t\u00eate \u00e0 une hauteur de z_hop. Si l'axe Z n'est pas d\u00e9j\u00e0 centr\u00e9, # la t\u00eate est relev\u00e9e de z_hop. # La valeur par d\u00e9faut est de ne pas impl\u00e9menter le relevage en Z. #z_hop_speed: 15.0 # Vitesse (en mm/s) \u00e0 laquelle l'axe Z est relev\u00e9 avant le retour \u00e0 la position initiale. # La valeur par d\u00e9faut est de 15 mm/s. #move_to_previous: False # Lorsqu'il a la valeur True, les axes X et Y sont r\u00e9initialis\u00e9s \u00e0 leurs positions pr\u00e9c\u00e9dentes apr\u00e8s # retour \u00e0 la position initiale de l'axe Z. La valeur par d\u00e9faut est False. [homing_override] \u00b6 Homing override. On peut utiliser ce m\u00e9canisme pour ex\u00e9cuter une s\u00e9rie de commandes g-code \u00e0 la place d'un G28 trouv\u00e9 dans l'entr\u00e9e g-code normale. Cela peut \u00eatre utile sur les imprimantes qui n\u00e9cessitent une proc\u00e9dure sp\u00e9cifique du retour au point d'origine de la machine. [homing_override] gcode: # Une liste de commandes G-Code \u00e0 ex\u00e9cuter \u00e0 la place des commandes G28 # trouv\u00e9es dans l'entr\u00e9e g-code normale. Voir docs/Command_Templates.md # pour le format G-Code. Si un G28 est contenu dans cette liste de commandes # alors la proc\u00e9dure de mise \u00e0 l'origine de l'imprimante sera invoqu\u00e9e. # Les commandes \u00e9num\u00e9r\u00e9es ici doivent ramener tous les axes \u00e0 la position initiale. # Ce param\u00e8tre doit \u00eatre fourni. #axes: xyz # Les axes \u00e0 remplacer. Par exemple, si ce param\u00e8tre est d\u00e9fini sur \"z\", alors le script # d'annulation ne sera ex\u00e9cut\u00e9 que lorsque l'axe z est mis \u00e0 l'origine (par ex. # une commande \"G28\" ou \"G28 Z\"). Remarque : le script de neutralisation doit # toujours g\u00e9rer tous les axes. La valeur par d\u00e9faut est \"xyz\" ce qui fait que le script # de remplacement sera ex\u00e9cut\u00e9 \u00e0 la place de toutes les commandes G28. #set_position_x: #set_position_y: #set_position_z: # Si sp\u00e9cifi\u00e9, l'imprimante supposera que l'axe est \u00e0 la position sp\u00e9cifi\u00e9e avant # d'ex\u00e9cuter les commandes g-code ci-dessus. Le fait de d\u00e9finir ceci d\u00e9sactive les # contr\u00f4les d'orientation pour cet axe. Cela peut \u00eatre utile si la t\u00eate doit se d\u00e9placer # avant d'invoquer le m\u00e9canisme G28 normal d'un axe. # La valeur par d\u00e9faut est de ne pas forcer une position pour un axe. [endstop_phase] \u00b6 Interrupteurs de fin de course ajust\u00e9s \u00e0 la phase du moteur pas \u00e0 pas. Pour utiliser cette fonction, d\u00e9finissez une section de configuration avec un pr\u00e9fixe \"endstop_phase\" suivi du nom de la section de configuration du moteur pas \u00e0 pas correspondante (par exemple, \"[endstop_phase stepper_z]\"). Cette fonctionnalit\u00e9 peut am\u00e9liorer la pr\u00e9cision des interrupteurs de fin de course. Ajoutez une d\u00e9claration nue \"[endstop_phase]\" pour activer la commande ENDSTOP_PHASE_CALIBRATE. Voir le guide de d\u00e9tecteurs de fin de course et la r\u00e9f\u00e9rence des commandes pour plus d'informations. [endstop_phase stepper_z] #endstop_accuracy: # D\u00e9finit la pr\u00e9cision attendue (en mm) de la but\u00e9e. Cela repr\u00e9sente la distance d'erreur # maximale que la but\u00e9e peut d\u00e9clencher (par exemple, si une but\u00e9e peut occasionnellement # se d\u00e9clencher 100um en avance ou jusqu'\u00e0 100um en retard alors r\u00e9glez cette valeur # sur 0.200 pour 200um). La valeur par d\u00e9faut est 4*rotation_distance/full_steps_per_rotation. #trigger_phase: # Sp\u00e9cifie la phase du pilote du moteur pas \u00e0 pas \u00e0 attendre lorsque l'on atteint la but\u00e9e. # Compos\u00e9 de deux nombres s\u00e9par\u00e9s par une barre oblique - la phase et le nombre total # de phases (par exemple, \"7/64\"). Ne d\u00e9finissez cette valeur que si vous \u00eates s\u00fbr que le # pilote du moteur pas \u00e0 pas est r\u00e9initialis\u00e9 \u00e0 chaque fois que le mcu est r\u00e9initialis\u00e9. # Si cette valeur n'est pas d\u00e9finie, alors la phase du moteur pas \u00e0 pas sera d\u00e9tect\u00e9e \u00e0 la # premi\u00e8re mise \u00e0 l'origine et cette phase sera utilis\u00e9e sur toutes les origines suivantes. #endstop_align_zero: False # Si vrai, la position_endstop de l'axe sera effectivement modifi\u00e9e de mani\u00e8re \u00e0 ce que la # position z\u00e9ro de l'axe se produise sur un pas complet du moteur pas \u00e0 pas. (Si utilis\u00e9 sur # l'axe Z et que la hauteur de la couche d'impression est un multiple de la distance parcourue # par un pas complet, alors chaque couche se produira sur un pas complet). # La valeur par d\u00e9faut est False. Macros et \u00e9v\u00e9nements G-Code \u00b6 [gcode_macro] \u00b6 Macros G-Code (on peut d\u00e9finir un nombre quelconque de sections avec le pr\u00e9fixe \"gcode_macro\"). Voir le guide des mod\u00e8les de commande pour plus d'informations. [gcode_macro my_cmd] #gcode: # Une liste de commandes G-Code \u00e0 ex\u00e9cuter \u00e0 la place de \"my_cmd\". Voir # docs/Command_Templates.md pour le format G-Code. Ce param\u00e8tre doit # \u00eatre fourni. #variable_<name>: # On peut sp\u00e9cifier un nombre quelconque d'options avec le pr\u00e9fixe \"variable_\". # Le nom de variable donn\u00e9 se verra attribu\u00e9 la valeur donn\u00e9e (analys\u00e9e en tant # que litt\u00e9ral par Python) et sera disponible pendant l'expansion de la macro. # Par exemple, une configuration avec \"variable_fan_speed = 75\" pourrait avoir # des commandes gcode contenant \"M106 S{ fan_speed * 255 }\". Ces variables # peuvent alors \u00eatre modifi\u00e9es au moment de l'ex\u00e9cution en utilisant la commande # SET_GCODE_VARIABLE (voir docs/Command_Templates.md pour plus de d\u00e9tails). # Les noms de variables peuvent ne pas utiliser de caract\u00e8res majuscules. #rename_existing: # Cette option permet \u00e0 la macro de remplacer une commande G-Code existante # et fournira la d\u00e9finition pr\u00e9c\u00e9dente de la commande via le nom fourni ici. Ceci # peut \u00eatre utilis\u00e9 pour remplacer les commandes G-Code originelles. Il convient # d'\u00eatre prudent lorsque l'on remplace des commandes, cela pouvant provoquer # des r\u00e9sultats complexes et inattendus. La valeur par d\u00e9faut est de ne pas # remplacer une commande G-Code existante. #description: Macro G-Code # Ceci ajoutera une courte description utilis\u00e9e \u00e0 la commande HELP ou lors de # l'utilisation de la fonction de compl\u00e9tion automatique. # Par d\u00e9faut : \"G-Code macro\". [delayed_gcode] \u00b6 Ex\u00e9cute un gcode sur un d\u00e9lai d\u00e9fini. Voir le guide des mod\u00e8les de commande et la r\u00e9f\u00e9rence des commandes pour plus d'informations. [delayed_gcode my_delayed_gcode] gcode: # Une liste de commandes G-Code \u00e0 ex\u00e9cuter lorsque la dur\u00e9e du d\u00e9lai est \u00e9coul\u00e9e. # Les mod\u00e8les G-Code sont support\u00e9s. Ce param\u00e8tre doit \u00eatre fourni. #initial_duration: 0.0 # Dur\u00e9e du d\u00e9lai initial (en secondes). Si elle est d\u00e9finie \u00e0 une valeur non nulle, le gcode # diff\u00e9r\u00e9 s'ex\u00e9cutera le nombre de secondes sp\u00e9cifi\u00e9 apr\u00e8s que l'imprimante passe \u00e0 # l'\u00e9tat \"pr\u00eat\". Ceci peut \u00eatre utile pour les proc\u00e9dures d'initialisation ou lors d'une # r\u00e9p\u00e9tition de delayed_gcode. Si la valeur est 0, le delayed_gcode ne sera pas ex\u00e9cut\u00e9 # au d\u00e9marrage. # La valeur par d\u00e9faut est 0. [save_variables] \u00b6 Prise en charge de l'enregistrement des variables sur le disque afin qu'elles soient conserv\u00e9es lors des red\u00e9marrages. Voir mod\u00e8les de commande et r\u00e9f\u00e9rence G-code pour plus d'informations. [save_variables] filename: # Obligatoire - fournir un nom de fichier utilis\u00e9 pour enregistrer les variables # sur le disque, par exemple ~/variables.cfg. [idle_timeout] \u00b6 D\u00e9lai d'inactivit\u00e9. Un d\u00e9lai d'inactivit\u00e9 est automatiquement activ\u00e9 - ajoutez une section de configuration idle_timeout explicite pour modifier les param\u00e8tres par d\u00e9faut. [idle_timeout] #gcode: # Une liste de commandes G-Code \u00e0 ex\u00e9cuter lors d'un d\u00e9lai d'inactivit\u00e9. Voir # docs/Command_Templates.md pour le format G-Code. La valeur par d\u00e9faut # est d'ex\u00e9cuter \"TURN_OFF_HEATERS\" et \"M84\". #timeout: 600 # Dur\u00e9e d'attente (en secondes) avant d'ex\u00e9cuter les commandes G-Code ci-dessus. # La valeur par d\u00e9faut est de 600 secondes. Fonctionnalit\u00e9s optionnelles du G-code \u00b6 [virtual_sdcard] \u00b6 Une carte SD virtuelle peut \u00eatre utile si la machine h\u00f4te n'est pas assez rapide pour faire fonctionner OctoPrint correctement. Elle permet au logiciel h\u00f4te Klipper d'imprimer directement les fichiers gcode stock\u00e9s dans un r\u00e9pertoire sur l'h\u00f4te en utilisant les commandes G-Code standard de la carte SD (par exemple, M24). [virtual_sdcard] path: # Le chemin d'acc\u00e8s au r\u00e9pertoire local sur la machine h\u00f4te de recherche # des fichiers g-code. Il s'agit d'un r\u00e9pertoire en lecture seule (les \u00e9critures # de fichiers sur une carte SD ne sont pas support\u00e9es). On peut le faire pointer # vers le r\u00e9pertoire de t\u00e9l\u00e9chargement d'OctoPrint (g\u00e9n\u00e9ralement # ~/.octoprint/uploads/ ). Ce param\u00e8tre doit \u00eatre fourni. #on_error_gcode: # Une liste de commandes G-Code \u00e0 ex\u00e9cuter lorsqu'une erreur est signal\u00e9e. [sdcard_loop] \u00b6 Certaines imprimantes dot\u00e9es de fonctions d'\u00e9jections des pi\u00e8ces imprim\u00e9es, comme un \u00e9jecteur de pi\u00e8ces ou une imprimante \u00e0 courroie, peuvent trouver une utilit\u00e9 dans la mise en boucle de sections du fichier de la carte SD (par exemple, pour imprimer la m\u00eame pi\u00e8ce encore et encore, ou r\u00e9p\u00e9ter une section d'une pi\u00e8ce pour une cha\u00eene ou un autre motif r\u00e9p\u00e9t\u00e9). Voir la r\u00e9f\u00e9rence des commandes pour les commandes prises en charge. Voir le fichier sample-macros.cfg pour une macro G-Code compatible avec le M808 de Marlin. [sdcard_loop] [force_move] \u00b6 Support des d\u00e9placements manuels des moteurs pas \u00e0 pas \u00e0 des fins de diagnostic. Remarque : l'utilisation de cette fonction peut placer l'imprimante dans un \u00e9tat invalide - consultez la r\u00e9f\u00e9rence de la commande pour obtenir des d\u00e9tails importants. [force_move] #enable_force_move: False # D\u00e9fini \u00e0 true pour activer les commandes G-Code \u00e9tendues FORCE_MOVE et # SET_KINEMATIC_POSITION # La valeur par d\u00e9faut est false. [pause_resume] \u00b6 Fonctionnalit\u00e9 Pause/Reprise avec prise en charge de la capture et de la restauration de position. Voir la r\u00e9f\u00e9rence de la commande pour plus d'informations. [pause_resume] #recover_velocity: 50. # Lorsque la capture/restauration est activ\u00e9e, la vitesse \u00e0 laquelle retourner \u00e0 # la position captur\u00e9e (en mm/s). La valeur par d\u00e9faut est 50,0 mm/s. [firmware_retraction] \u00b6 R\u00e9traction du filament par le firmware. Cela permet d'activer les commandes GCODE G10 (r\u00e9traction) et G11 (d\u00e9-r\u00e9traction) \u00e9mises par de nombreux trancheurs. Les param\u00e8tres ci-dessous fournissent des valeurs par d\u00e9faut au d\u00e9marrage, ces valeurs peuvent \u00eatre ajust\u00e9es via la commande SET_RETRACTION , ce qui permet des r\u00e9glages par filament et des ajustements en cours d'impression. [firmware_retraction] #retract_length: 0 # La longueur du filament (en mm) \u00e0 r\u00e9tracter lorsque G10 est activ\u00e9, et \u00e0 fournir # lorsque G11 est activ\u00e9 (voir unretract_extra_length ci-dessous). # La valeur par d\u00e9faut est 0 mm. #retract_speed: 20 # La vitesse de r\u00e9traction, en mm/s. La valeur par d\u00e9faut est 20 mm/s. #unretract_extra_length: 0 # Longueur (en mm) de filament *suppl\u00e9mentaire* \u00e0 ajouter lors de la d\u00e9-r\u00e9traction. #unretract_speed: 10 # La vitesse de d\u00e9-r\u00e9traction, en mm/s. La valeur par d\u00e9faut est 10 mm/s. [gcode_arcs] \u00b6 Support des commandes gcode de courbes (arc) (G2/G3). [gcode_arcs] #resolution: 1.0 # Un arc sera divis\u00e9 en segments. La longueur de chaque segment sera \u00e9gale \u00e0 # la r\u00e9solution en mm d\u00e9finie ci-dessus. Des valeurs plus faibles produiront un # arc plus fin, mais \u00e9galement plus de travail de votre machine. Les arcs plus # petits que la valeur configur\u00e9e deviendront des lignes droites. La valeur par # d\u00e9faut est 1 mm. [respond] \u00b6 Active les commandes \u00e9tendues \"M118\" et \"RESPOND\" . [respond] #default_type: echo # D\u00e9finit le pr\u00e9fixe par d\u00e9faut de la sortie \"M118\" et \"RESPOND\" \u00e0 l'un des # \u00e9l\u00e9ments suivants : # echo: \"echo : \" (C'est la valeur par d\u00e9faut) # command: \"// \" # error: \" !! \" #default_prefix: echo: # D\u00e9finit directement le pr\u00e9fixe par d\u00e9faut. Si elle est pr\u00e9sente, cette valeur # remplacera celle de \"default_type\". [exclude_object] \u00b6 Permet de prendre en charge l'exclusion ou l'annulation d'objets individuels pendant le processus d'impression. Voir le guide des objets exclus et la r\u00e9f\u00e9rence des commandes pour plus d'informations. Voir le fichier sample-macros.cfg pour une macro G-Code M486 compatible avec Marlin/RepRapFirmware. [exclude_object] Compensation de la r\u00e9sonance \u00b6 [input_shaper] \u00b6 Active la compensation de r\u00e9sonance . Voir \u00e9galement la r\u00e9f\u00e9rence des commandes . [input_shaper] #shaper_freq_x: 0 # Fr\u00e9quence (en Hz) de la mise en forme de l'entr\u00e9e pour l'axe X. Il s'agit g\u00e9n\u00e9ralement # d'une fr\u00e9quence de r\u00e9sonance de l'axe X que la mise en forme de l'entr\u00e9e doit supprimer. # Pour les mises en forme plus complexes, comme les mises en forme \u00e0 2 ou 3 bosses EI # (2hump/3hump), ce param\u00e8tre peut \u00eatre d\u00e9fini \u00e0 partir de diff\u00e9rentes consid\u00e9rations. # La valeur par d\u00e9faut est 0, ce qui d\u00e9sactive la mise en forme de l'entr\u00e9e pour l'axe X. #shaper_freq_y: 0 # Fr\u00e9quence (en Hz) de la mise en forme de l'entr\u00e9e pour l'axe Y. Il s'agit g\u00e9n\u00e9ralement # d'une fr\u00e9quence de r\u00e9sonance de l'axe Y que la mise en forme de l'entr\u00e9e doit supprimer. # Pour les mises en forme plus complexes, comme les mises en forme \u00e0 2 ou 3 bosses EI # (2hump/3hump), ce param\u00e8tre peut \u00eatre d\u00e9fini \u00e0 partir de diff\u00e9rentes consid\u00e9rations. # La valeur par d\u00e9faut est 0, ce qui d\u00e9sactive la mise en forme de l'entr\u00e9e pour l'axe Y. #shaper_type: mzv # Le type de mise en forme de l'entr\u00e9e \u00e0 utiliser pour les axes X et Y. Les types support\u00e9s # sont zv, mzv, zvd, ei, 2hump_ei, et 3hump_ei. # La valeur par d\u00e9faut est la compensation de r\u00e9sonance mzv. #shaper_type_x: #shaper_type_y: # Si shaper_type n'est pas d\u00e9fini, ces deux param\u00e8tres peuvent \u00eatre utilis\u00e9s pour configurer # des formes d'entr\u00e9e diff\u00e9rentes pour les axes X et Y. Les valeurs support\u00e9es sont les # m\u00eames que celles du param\u00e8tre shaper_type. #damping_ratio_x: 0.1 #damping_ratio_y: 0.1 # Taux d'amortissement des vibrations des axes X et Y utilis\u00e9s par les dispositifs de mise # en forme de l'entr\u00e9e afin d'am\u00e9liorer la suppression des vibrations. La valeur par d\u00e9faut est # 0.1 ce qui est une bonne valeur g\u00e9n\u00e9rale pour la plupart des imprimantes. Dans la plupart # des cas, ce param\u00e8tre ne n\u00e9cessite aucun r\u00e9glage et ne doit pas \u00eatre modifi\u00e9. [adxl345] \u00b6 Support des acc\u00e9l\u00e9rom\u00e8tres ADXL345. Ce support permet d'interroger les mesures de l'acc\u00e9l\u00e9rom\u00e8tre \u00e0 partir du capteur. Cela active une commande ACCELEROMETER_MEASURE (voir G-Codes pour plus d'informations). Le nom de la puce par d\u00e9faut est \"default\", mais on peut sp\u00e9cifier un nom explicite (par exemple, [adxl345 my_chip_name]). [adxl345] cs_pin: # La broche d'activation SPI du capteur. Ce param\u00e8tre doit \u00eatre fourni. #spi_speed: 5000000 # La vitesse SPI (en hz) \u00e0 utiliser lors de la communication avec la puce. # La valeur par d\u00e9faut est 5000000. #spi_bus: #spi_software_sclk_pin: #spi_software_mosi_pin: #spi_software_miso_pin: # Voir la section \"param\u00e8tres SPI communs\" pour une description des # param\u00e8tres ci-dessus. #axes_map : x, y, z # L'axe de l'acc\u00e9l\u00e9rom\u00e8tre de chacun des axes X, Y et Z de l'imprimante. # Ceci peut \u00eatre utile si l'acc\u00e9l\u00e9rom\u00e8tre est mont\u00e9 dans une orientation # qui ne correspond pas \u00e0 celle de l'imprimante. Par exemple, on peut # r\u00e9gler cette option sur \"y, x, z\" pour permuter les axes X et Y. # Il est \u00e9galement possible d'inverser un axe si la direction de l'acc\u00e9l\u00e9rom\u00e8tre # est invers\u00e9e (par exemple, \"x, z, -y\"). La valeur par d\u00e9faut est \"x, y, z\". #Rate: 3200 # D\u00e9bit de donn\u00e9es de sortie pour ADXL345. ADXL345 prend en charge les d\u00e9bits # de donn\u00e9es suivants : 3200, 1600, 800, 400, 200, 100, 50, et 25. Notez qu'il n'est # pas recommand\u00e9 de changer ce d\u00e9bit par rapport au d\u00e9bit par d\u00e9faut de 3200, # les d\u00e9bits inf\u00e9rieurs \u00e0 800 affecteront consid\u00e9rablement la qualit\u00e9 des mesures # de r\u00e9sonance. [mpu9250] \u00b6 Support for MPU-9250, MPU-9255, MPU-6515, MPU-6050, and MPU-6500 accelerometers (one may define any number of sections with an \"mpu9250\" prefix). [mpu9250 my_accelerometer] #i2c_address: # La valeur par d\u00e9faut est 104 (0x68). Si AD0 est \u00e9lev\u00e9, ce sera 0x69 \u00e0 la place. #i2c_mcu: #i2c_bus: #i2c_speed: 400000 # Voir la section \"param\u00e8tres I2C communs\" pour une description des # param\u00e8tres ci-dessus. La valeur par d\u00e9faut de \"i2c_speed\" est 400000. #axes_map: x, y, z # Voir la section \"adxl345\" pour des informations sur ce param\u00e8tre. [resonance_tester] \u00b6 Prise en charge du test de r\u00e9sonance et du calibrage automatique du fa\u00e7onneur d'entr\u00e9e (input shaper). Pour utiliser la plupart des fonctionnalit\u00e9s de ce module, des d\u00e9pendances logicielles suppl\u00e9mentaires doivent \u00eatre install\u00e9es ; reportez-vous \u00e0 Mesurer les r\u00e9sonances et \u00e0 la r\u00e9f\u00e9rence de commande pour plus d'informations. Voir la section Adoucissement Max du guide de mesure des r\u00e9sonances pour plus d'informations sur le param\u00e8tre max_smoothing et son utilisation. [resonance_tester] #probe_points: # Une liste de coordonn\u00e9es X, Y, Z de points (un point par ligne) \u00e0 tester. # Au moins un point est requis. Assurez-vous que tous les points avec une certaine marge # de s\u00e9curit\u00e9 dans le plan XY (~ quelques centim\u00e8tres) sont accessibles par la t\u00eate de l'outil. #accel_chip: # Nom de la puce d'acc\u00e9l\u00e9rom\u00e8tre \u00e0 utiliser pour les mesures. Si la puce adxl345 a \u00e9t\u00e9 d\u00e9finie # sans un nom explicite, ce param\u00e8tre peut simplement la r\u00e9f\u00e9rencer en tant que # \"accel_chip : adxl345\", sinon un nom explicite doit \u00eatre fourni, par exemple # \"accel_chip : adxl345 my_chip_name\". Soit ce param\u00e8tre seul, soit les deux param\u00e8tres # suivants doivent \u00eatre d\u00e9finis. #accel_chip_x: #accel_chip_y: # Noms des puces d'acc\u00e9l\u00e9rom\u00e8tre \u00e0 utiliser pour les mesures de chaque axe. # Peut \u00eatre utile, par exemple, sur une imprimante de type \"bed slinger\", si deux acc\u00e9l\u00e9rom\u00e8tres # s\u00e9par\u00e9s sont mont\u00e9s, un sur le lit (pour l'axe Y), l'autre sur la t\u00eate de l'outil (pour l'axe X). # Ces param\u00e8tres ont le m\u00eame format que le param\u00e8tre 'accel_chip'. Soit le param\u00e8tre # 'accel_chip' soit ces deux param\u00e8tres doivent \u00eatre fournis. #max_smoothing: # Lissage maximal du fa\u00e7onneur (shaper) d'entr\u00e9e \u00e0 autoriser pour chaque axe pendant # l'auto-calibration (avec la commande 'SHAPER_CALIBRATE'). Par d\u00e9faut, aucun lissage # maximal n'est sp\u00e9cifi\u00e9. Reportez-vous au guide Measuring_Resonances pour plus de d\u00e9tails # sur l'utilisation de cette fonction. #min_freq: 5 # Fr\u00e9quence minimale de test des r\u00e9sonances. La valeur par d\u00e9faut est 5 Hz. #max_freq: 133.33 # Fr\u00e9quence maximale de test des r\u00e9sonances. La valeur par d\u00e9faut est 133,33 Hz. #accel_per_hz: 75 # Ce param\u00e8tre permet de d\u00e9terminer l'acc\u00e9l\u00e9ration \u00e0 utiliser pour tester une fr\u00e9quence # sp\u00e9cifique: accel = accel_per_hz * freq. Plus haute est cette valeur, plus l'\u00e9nergie des # oscillations est \u00e9lev\u00e9e. Peut \u00eatre fix\u00e9 \u00e0 une valeur inf\u00e9rieure \u00e0 celle par d\u00e9faut si les # r\u00e9sonances deviennent trop fortes sur l'imprimante. Cependant, des valeurs plus faibles # rendent les mesures des r\u00e9sonances \u00e0 haute fr\u00e9quence moins pr\u00e9cises. La valeur par # d\u00e9faut est de 75 (mm/sec). #hz_per_sec: 1 # D\u00e9termine la vitesse de l'essai. Lors du test de toutes les fr\u00e9quences dans la plage [min_freq, # max_freq], chaque seconde, la fr\u00e9quence augmente de hz_per_sec. # De faibles valeurs rendent le test lent, de grandes valeurs diminueront la pr\u00e9cision du test. # La valeur par d\u00e9faut est 1.0 (Hz/sec == sec^-2). Assistants de fichiers de configuration \u00b6 [board_pins] \u00b6 Alias des broches de la carte (on peut d\u00e9finir un nombre quelconque de sections avec le pr\u00e9fixe \"board_pins\"). Utilisez ceci pour d\u00e9finir des alias de broches d'un micro-contr\u00f4leur. [board_pins my_aliases] mcu: mcu # Une liste de micro-contr\u00f4leurs s\u00e9par\u00e9s par des virgules pouvant utiliser les # alias. La valeur par d\u00e9faut est d'appliquer les alias au \"mcu\" principal. alias: aliases_<nom>: # Une liste s\u00e9par\u00e9e par des virgules d'alias \"nom=valeur\" \u00e0 cr\u00e9er pour le micro- # contr\u00f4leur donn\u00e9. Par exemple, \"EXP1_1=PE6\" cr\u00e9era un alias \"EXP1_1\" pour la # broche \"PE6\". Cependant, si la \"valeur\" est incluse dans \"<>\", alors \"nom\" est cr\u00e9\u00e9 # comme une broche r\u00e9serv\u00e9e (par exemple, \"EXP1_9=<GND>\" r\u00e9serverait \"EXP1_9\"). # Un nombre quelconque d'options commen\u00e7ant par \"alias_\" peuvent \u00eatre sp\u00e9cifi\u00e9es. [include] \u00b6 Prise en charge de l'inclusion de fichiers. On peut inclure des fichiers de configuration suppl\u00e9mentaires \u00e0 partir du fichier de configuration principal de l'imprimante. Les caract\u00e8res g\u00e9n\u00e9riques peuvent \u00e9galement \u00eatre utilis\u00e9s (par exemple, \"configs/*.cfg\"). [include my_other_config.cfg] [duplicate_pin_override] \u00b6 Cet outil permet de d\u00e9finir plusieurs fois une m\u00eame broche de microcontr\u00f4leur dans un fichier de configuration sans v\u00e9rification normale des erreurs. Ceci est destin\u00e9 \u00e0 des fins de diagnostic et de d\u00e9bogage. Cette section n'est pas n\u00e9cessaire lorsque Klipper prend en charge l'utilisation de la m\u00eame broche plusieurs fois, et l'utilisation de cette d\u00e9rogation peut entra\u00eener des r\u00e9sultats confus et inattendus. [duplicate_pin_override] pins: # Une liste de broches s\u00e9par\u00e9es par des virgules pouvant \u00eatre utilis\u00e9es plusieurs fois dans # un fichier de configuration sans contr\u00f4les d'erreurs normaux. Ce param\u00e8tre doit \u00eatre # fourni. Mat\u00e9riel de nivelage du lit \u00b6 [probe] \u00b6 Sonde de hauteur Z. On peut d\u00e9finir cette section pour activer le mat\u00e9riel de nivellement de l'axe Z. Lorsque cette section est activ\u00e9e, les commandes g-code \u00e9tendus PROBE et QUERY_PROBE deviennent disponibles. Consultez \u00e9galement le guide d'\u00e9talonnage des sondes . La section probe cr\u00e9e \u00e9galement une broche virtuelle \"probe:z_virtual_endstop\". Il est possible de d\u00e9finir la broche du stepper_z, endstop_pin, sur cette broche virtuelle pour les imprimantes de style cart\u00e9sien qui utilisent la sonde \u00e0 la place d'un interrupteur de fin de course Z. Si vous utilisez \"probe:z_virtual_endstop\", ne d\u00e9finissez pas de position_endstop dans la configuration de la section stepper_z. [probe] pin: # Broche de d\u00e9tection de la sonde. Si la broche se trouve sur un microcontr\u00f4leur diff\u00e9rent # de celui des moteurs de l'axe Z alors elle active le \"multi-mcu homing\". Ce param\u00e8tre # doit \u00eatre fourni. #deactivate_on_each_sample: True # Ceci d\u00e9termine si Klipper doit ex\u00e9cuter le gcode de d\u00e9sactivation entre chaque tentative # de palpage lors d'une s\u00e9quence de palpages multiples. # La valeur par d\u00e9faut est True. #x_offset: 0.0 # La distance (en mm) entre la sonde et la buse le long de l'axe x. # La valeur par d\u00e9faut est 0. #y_offset: 0.0 # La distance (en mm) entre la sonde et la buse le long de l'axe y. # La valeur par d\u00e9faut est 0. z_offset: # La distance (en mm) entre le lit et la buse lorsque la sonde se d\u00e9clenche. # Ce param\u00e8tre doit \u00eatre fourni. #speed: 5.0 # Vitesse (en mm/s) de l'axe Z lors du palpage. La valeur par d\u00e9faut est 5mm/s. #samples: 1 # Le nombre de fois o\u00f9 il faut palper chaque point. Les valeurs z palp\u00e9es seront # moyenn\u00e9es. La valeur par d\u00e9faut est de palper 1 fois. #sample_retract_dist: 2.0 # Distance (en mm) \u00e0 parcourir pour relever la t\u00eate de l'outil entre chaque palpage # (en cas d'\u00e9chantillonnage multiple). La valeur par d\u00e9faut est 2mm. #lift_speed: # Vitesse (en mm/s) de l'axe Z lors du levage de la sonde entre les \u00e9chantillons. # La valeur par d\u00e9faut est la m\u00eame que celle du param\u00e8tre 'speed'. #samples_result: average # La m\u00e9thode de calcul lorsque l'on \u00e9chantillonne plusieurs fois - soit \"m\u00e9diane\" # (median) ou \"moyenne\" (average). La valeur par d\u00e9faut est \"moyenne\". #samples_tolerance: 0.100 # La distance Z maximale (en mm) \u00e0 laquelle un \u00e9chantillon peut diff\u00e9rer des autres # \u00e9chantillons. Si cette tol\u00e9rance est d\u00e9pass\u00e9e, soit une erreur est signal\u00e9e soit une # tentative de palpage est recommenc\u00e9e (cf. samples_tolerance_retries). # La valeur par d\u00e9faut est 0.100mm. #samples_tolerance_retries: 0 # Le nombre de fois qu'il faut r\u00e9essayer quand un palpage d\u00e9passe la tol\u00e9rance des # \u00e9chantillons. Lors d'une nouvelle tentative, tous les \u00e9chantillons en cours sont rejet\u00e9s # et une tentative de palpa est relanc\u00e9e. Si un ensemble valide d'\u00e9chantillons n'est pas # obtenu dans le nombre de tentatives donn\u00e9, une erreur est signal\u00e9e. La valeur par d\u00e9faut # est z\u00e9ro, ce qui entra\u00eene le signalement d'une erreur d\u00e8s le premier \u00e9chantillon d\u00e9passant # la tol\u00e9rance de samples_tolerance. #activate_gcode: # Une liste de commandes G-Code \u00e0 ex\u00e9cuter avant chaque tentative de palpage. # Voir docs/Command_Templates.md pour le format G-Code. Cela peut \u00eatre utile si la sonde # doit \u00eatre activ\u00e9e d'une mani\u00e8re particuli\u00e8re. Ne pas envoyer ici de commandes d\u00e9pla\u00e7ant # la t\u00eate de l'outil (par exemple, G1). La valeur par d\u00e9faut est de ne pas ex\u00e9cuter de commandes # G-code sp\u00e9ciales lors de l'activation. #deactivate_gcode: # Une liste de commandes G-Code \u00e0 ex\u00e9cuter apr\u00e8s la fin de chaque tentative de palpage # termin\u00e9e. Voir docs/Command_Templates.md pour le format G-Code. Ne pas envoyer ici # de commandes d\u00e9pla\u00e7ant la t\u00eate de l'outil. La valeur par d\u00e9faut est de ne pas ex\u00e9cuter de # commandes G-code sp\u00e9ciales lors de la d\u00e9sactivation. [bltouch] \u00b6 Sonde BLTouch. On peut d\u00e9finir cette section (au lieu d'une section probe) pour activer une sonde BLTouch. Voir Guide BL-Touch et R\u00e9f\u00e9rence des commandes pour plus d'informations. Une broche virtuelle \"probe:z_virtual_endstop\" est \u00e9galement cr\u00e9\u00e9e (voir la section \"probe\" pour les d\u00e9tails). [bltouch] sensor_pin: # Broche connect\u00e9e \u00e0 la broche du capteur (sensor) BLTouch. La plupart des BLTouch # exigent un pullup sur la broche du capteur (pr\u00e9fixez le nom de la broche par \"^\"). # Ce param\u00e8tre doit \u00eatre fourni. control_pin: # Broche connect\u00e9e \u00e0 la broche de commande du BLTouch. # Ce param\u00e8tre doit \u00eatre fourni. #pin_move_time: 0.680 # Dur\u00e9e d'attente (en secondes) pour que la broche BLTouch se d\u00e9place vers # le haut ou le bas. La valeur par d\u00e9faut est de 0,680 seconde. #stow_on_each_sample: True # D\u00e9termine si Klipper doit ordonner \u00e0 la broche de se d\u00e9placer vers le haut entre # chaque palpage lors d'une s\u00e9quence de palpages multiples. # Lisez les instructions dans docs/BLTouch.md avant de r\u00e9gler ce param\u00e8tre \u00e0 False. # La valeur par d\u00e9faut est True. #probe_with_touch_mode: False # Si ce param\u00e8tre est d\u00e9fini sur True, Klipper palpera avec le p\u00e9riph\u00e9rique en # \"touch_mode\". La valeur par d\u00e9faut est False (palpage en mode \"pin_down\"). #pin_up_reports_not_triggered: True # D\u00e9finit si le BLTouch rapporte syst\u00e9matiquement le palpeur dans un \u00e9tat \"non # d\u00e9clench\u00e9\" apr\u00e8s une commande \"pin_up\" r\u00e9ussie. Ceci devrait \u00eatre True pour # tous les BLTouch authentiques. Lisez les instructions de docs/BLTouch.md avant # de r\u00e9gler cette valeur \u00e0 False. La valeur par d\u00e9faut est True. #pin_up_touch_mode_reports_triggered: True # D\u00e9finit si le BLTouch rapporte syst\u00e9matiquement un \u00e9tat \"d\u00e9clench\u00e9\" apr\u00e8s la # commande \"pin_up_mode_reports_triggered\". Ceci devrait \u00eatre True pour tous les # BLTouch authentiques. Lisez les instructions de docs/BLTouch.md avant de r\u00e9gler # cette valeur \u00e0 False. La valeur par d\u00e9faut est True. #set_output_mode: # Demande un mode de sortie particulier de la broche du capteur sur un BLTouch V3.0 # (et ult\u00e9rieurs). Ce param\u00e8tre ne doit pas \u00eatre utilis\u00e9 sur d'autres types de sondes. # R\u00e9glez sur \"5V\" pour demander une sortie de 5 Volts de la broche du capteur (\u00e0 n'utiliser # que si la carte contr\u00f4leur n\u00e9cessite le mode 5V et est tol\u00e9rante \u00e0 5V sur sa ligne de signal # d'entr\u00e9e). R\u00e9glez sur \"OD\" pour demander l'utilisation de la sortie de la broche du capteur # en mode drain ouvert. La valeur par d\u00e9faut est de ne pas demander de mode de sortie. #x_offset: #y_offset: #z_offset: #speed: #lift_speed: #samples: #sample_retract_dist: #samples_result: #samples_tolerance: #samples_tolerance_retries: # Voir la section \"probe\" pour des informations sur ces param\u00e8tres. [smart_effector] \u00b6 Le \"Smart Effector\" de Duet3d impl\u00e9mente une sonde Z utilisant un capteur de force. On peut d\u00e9finir cette section \u00e0 la place de [probe] pour activer les fonctionnalit\u00e9s sp\u00e9cifiques du Smart Effector. Cela permet \u00e9galement d'activer les commandes d'ex\u00e9cution afin d'ajuster les param\u00e8tres du Smart Effector au moment de son ex\u00e9cution. [smart_effector] pin: # Broche connect\u00e9e \u00e0 la broche de sortie de la sonde Z de Smart Effector (broche 5). Notez qu' une # r\u00e9sistance de tirage (pullup) sur la carte n'est g\u00e9n\u00e9ralement pas n\u00e9cessaire. Cependant, si la broche # de sortie est connect\u00e9e \u00e0 la broche de la carte \u00e0 l'aide d'une r\u00e9sistance de tirage, cette r\u00e9sistance doit # \u00eatre de valeur \u00e9lev\u00e9e (par ex. 10K Ohm ou plus). Certaines cartes ont une r\u00e9sistance de tirage de faible # valeur sur l'entr\u00e9e de la sonde Z, ce qui entra\u00eenera probablement un \u00e9tat de sonde toujours d\u00e9clench\u00e9. # Dans ce cas, connectez le Smart Effector \u00e0 une autre broche sur la carte. Ce param\u00e8tre est n\u00e9cessaire. #control_pin: # Broche connect\u00e9e \u00e0 la broche d'entr\u00e9e de contr\u00f4le du Smart Effector (broche 7). Si elle est fournie, # les commandes de programmation de la sensibilit\u00e9 du Smart Effector deviennent disponibles. #probe_accel: # Si elle est d\u00e9finie, limite l'acc\u00e9l\u00e9ration des mouvements de palpage (en mm/sec^2). # Une grande acc\u00e9l\u00e9ration soudaine au d\u00e9but du mouvement de palpage peut provoquer des # d\u00e9clenchements intempestifs de la sonde, surtout si la t\u00eate de l'outil est lourde. # Pour \u00e9viter cela, il peut \u00eatre n\u00e9cessaire de r\u00e9duire l'acc\u00e9l\u00e9ration des mouvements de palpage # via ce param\u00e8tre. #recovery_time: 0.4 # D\u00e9lai entre les mouvements de d\u00e9placement et les mouvements de palpage en secondes. Un # d\u00e9placement rapide avant le palpage peut entra\u00eener un d\u00e9clenchement intempestif de celui-ci. # Cela peut provoquer des erreurs 'Probe triggered prior to movement' si aucun d\u00e9lai n'est d\u00e9fini. # La valeur 0 d\u00e9sactive le d\u00e9lai de r\u00e9cup\u00e9ration. # La valeur par d\u00e9faut est 0,4. #x_offset: #y_offset: # Doivent \u00eatre laiss\u00e9s non d\u00e9finis (ou d\u00e9finis \u00e0 0). z_offset: # Hauteur de d\u00e9clenchement de la sonde. Commencez avec -0,1 (mm), et ajustez plus tard en # utilisant la commande `PROBE_CALIBRATE`. Ce param\u00e8tre doit \u00eatre fourni. #speed: # Vitesse (en mm/s) de l'axe Z lors du palpage. Il est recommand\u00e9 de commencer avec une # vitesse de palpage de 20 mm/s et d'ajuster si n\u00e9cessaire pour am\u00e9liorer la pr\u00e9cision et la # r\u00e9p\u00e9tabilit\u00e9 du d\u00e9clenchement du palpeur. #samples: #sample_retract_dist: #samples_result: #samples_tolerance: #samples_tolerance_retries: #activate_gcode: #deactivate_gcode: #deactivate_on_each_sample: # Voir la section \"sonde\" (probe) pour plus d'informations sur les param\u00e8tres ci-dessus. Moteurs pas \u00e0 pas et extrudeurs additionnels \u00b6 [stepper_z1] \u00b6 Axes \u00e0 moteurs pas \u00e0 pas multiples. Sur une imprimante de style cart\u00e9sien, le pilote moteur contr\u00f4lant un axe donn\u00e9 peut avoir des blocs de configuration suppl\u00e9mentaires d\u00e9finissant les pilotes moteurs qui doivent \u00eatre mis en marche de concert avec le pilote principal. On peut d\u00e9finir un nombre quelconque de sections avec un suffixe num\u00e9rique commen\u00e7ant \u00e0 1 (par exemple, \"stepper_z1\", \"stepper_z2\", etc.). [stepper_z1] #step_pin: #dir_pin: #enable_pin: #microsteps: #rotation_distanc : # Voir la section \"stepper\" pour la d\u00e9finition des param\u00e8tres ci-dessus. #endstop_pin: # Si une endstop_pin est d\u00e9finie pour le moteur suppl\u00e9mentaire, alors le moteur # se d\u00e9placera \u00e0 l'origine jusqu'\u00e0 ce que la fin de course soit d\u00e9clench\u00e9e. Sinon, le # moteur se d\u00e9placera jusqu'\u00e0 ce que la fin de course du moteur principal de l'axe # soit d\u00e9clench\u00e9e. [extruder1] \u00b6 Dans une imprimante multi-extrudeurs, ajoutez une section d'extrudeur suppl\u00e9mentaire pour chaque extrudeur suppl\u00e9mentaire. Les sections d'extrudeur suppl\u00e9mentaires doivent \u00eatre nomm\u00e9es \"extruder1\", \"extruder2\", \"extruder3\", et ainsi de suite. Voir la section \"extruder\" pour une description des param\u00e8tres disponibles. Voir sample-multi-extruder.cfg pour un exemple de configuration. [extruder1] #step_pin: #dir_pin: #... # Voir la section \"extruder\" pour les param\u00e8tres disponibles pour le pilote de moteur # pas \u00e0 pas et l'\u00e9l\u00e9ment de chauffe. #shared_heater: # Cette option est obsol\u00e8te et ne doit plus \u00eatre utilis\u00e9e. [dual_carriage] \u00b6 Prise en charge des imprimantes cart\u00e9siennes avec deux chariots sur un seul axe. Le chariot actif est d\u00e9fini par la commande g-code \u00e9tendue SET_DUAL_CARRIAGE. La commande \"SET_DUAL_CARRIAGE CARRIAGE=1\" active le chariot d\u00e9fini dans cette section (CARRIAGE=0 ram\u00e8ne l'activation au chariot principal). Le support du double chariot est g\u00e9n\u00e9ralement combin\u00e9 avec des extrudeuses suppl\u00e9mentaires - la commande SET_DUAL_CARRIAGE est souvent appel\u00e9e en m\u00eame temps que la commande ACTIVATE_EXTRUDER. Veillez \u00e0 garer les chariots pendant la d\u00e9sactivation. Voir sample-idex.cfg pour un exemple de configuration. [dual_carriage] axis: # L'axe sur lequel se trouve ce chariot suppl\u00e9mentaire (soit x, soit y). Ce param\u00e8tre # doit \u00eatre fourni. #step_pin: #dir_pin: #enable_pin: #microsteps: #rotation_distance: #endstop_pin: #position_endstop: #position_min: #position_max: # Voir la section \"stepper\" pour la d\u00e9finition des param\u00e8tres ci-dessus. [extruder_stepper] \u00b6 Support pour des moteurs suppl\u00e9mentaires synchronis\u00e9s avec le mouvement d'une extrudeuse (on peut d\u00e9finir un nombre quelconque de sections avec un pr\u00e9fixe \"extruder_stepper\"). Voir la r\u00e9f\u00e9rence des commandes pour plus d'informations. [extrudeur_stepper my_extra_stepper] extruder: # L'extrudeur sur lequel ce pilote moteur est synchronis\u00e9. Si ce param\u00e8tre est # d\u00e9fini sur une cha\u00eene vide, le pilote ne sera pas synchronis\u00e9 avec un extrudeur. # Ce param\u00e8tre doit \u00eatre fourni. #step_pin: #dir_pin: #enable_pin: #microsteps: #rotation_distance: # Voir la section \"stepper\" pour la d\u00e9finition des param\u00e8tres # ci-dessus. [manual_stepper] \u00b6 Pilotes de moteur manuels (on peut d\u00e9finir un nombre quelconque de sections avec le pr\u00e9fixe \"manual_stepper\"). Ce sont des pilotes de moteur contr\u00f4l\u00e9s par la commande g-code MANUAL_STEPPER. Par exemple \"MANUAL_STEPPER STEPPER=my_stepper MOVE=10 SPEED=5\". Voir le fichier G-Codes pour une description de la commande MANUAL_STEPPER. Les pilotes de moteur ne sont pas connect\u00e9s \u00e0 la cin\u00e9matique normale de l'imprimante. [manual_stepper my_stepper] #step_pin: #dir_pin: #enable_pin: #microsteps: #rotation_distance: # Voir la section \"stepper\" pour une description de ces param\u00e8tres. #velocity: # D\u00e9finit la vitesse par d\u00e9faut (en mm/s) pour le pilote moteur. Cette valeur # sera utilis\u00e9e si une commande MANUAL_STEPPER ne sp\u00e9cifie pas de param\u00e8tre SPEED # La valeur par d\u00e9faut est 5mm/s. #accel # D\u00e9finit l'acc\u00e9l\u00e9ration par d\u00e9faut (en mm/s^2) pour le pilote moteur Une # acc\u00e9l\u00e9ration de z\u00e9ro n'entra\u00eenera aucune acc\u00e9l\u00e9ration. Cette valeur # sera utilis\u00e9e si une commande MANUAL_STEPPER ne sp\u00e9cifie pas de # param\u00e8tre ACCEL. La valeur par d\u00e9faut est z\u00e9ro. #endstop_pin: # Broche de d\u00e9tection de l'interrupteur de fin de course. Si elle est sp\u00e9cifi\u00e9e, on peut effectuer # des \"mouvements de retour \u00e0 l'origine\" en ajoutant un param\u00e8tre STOP_ON_ENDSTOP aux # commandes de mouvement MANUAL_STEPPER. \u00c9l\u00e9ments chauffants et capteurs personnalis\u00e9s \u00b6 [verify_heater] \u00b6 V\u00e9rification de l'\u00e9l\u00e9ment chauffant et du capteur de temp\u00e9rature. La v\u00e9rification des \u00e9l\u00e9ments de chauffage est automatiquement activ\u00e9e pour chaque mat\u00e9riel de chauffage configur\u00e9 sur l'imprimante. Utilisez les sections verify_heater pour modifier les param\u00e8tres par d\u00e9faut. [verify_heater heater_config_name] #max_error: 120 # L'erreur de temp\u00e9rature cumul\u00e9e maximale avant de d\u00e9clencher une erreur. # Des valeurs plus petites entra\u00eenent une v\u00e9rification plus stricte et des valeurs # plus grandes permettent un d\u00e9lai plus long avant qu'une erreur ne soit signal\u00e9e. # Plus pr\u00e9cis\u00e9ment, la temp\u00e9rature est inspect\u00e9e une fois par seconde et si elle # est proche de la temp\u00e9rature cible, un \"compteur d'erreurs\" interne est remis # \u00e0 z\u00e9ro; sinon, si la temp\u00e9rature est inf\u00e9rieure \u00e0 la plage cible, le compteur est # augment\u00e9 de la quantit\u00e9 de temp\u00e9rature rapport\u00e9e diff\u00e9rant de cette plage. Si # le compteur d\u00e9passe ce \"max_error\", une erreur est signal\u00e9e. La valeur par # d\u00e9faut est 120. #check_gain_time: # Ceci contr\u00f4le la v\u00e9rification du chauffage durant la chauffe initiale. Des valeurs # plus petites entra\u00eenent une v\u00e9rification plus stricte et des valeurs plus grandes # autorisent un d\u00e9lai plus grand avant qu'une erreur ne soit signal\u00e9e. Sp\u00e9cifiquement, # pendant la chauffe initiale, tant que la temp\u00e9rature de l'\u00e9l\u00e9ment chauffant augmente # durant ce laps de temps (sp\u00e9cifi\u00e9 en secondes), le \"compteur d'erreurs\" interne est # remis \u00e0 z\u00e9ro. La valeur par d\u00e9faut est de 20 secondes pour les extrudeuses et 60 # secondes pour le lit chauffant. #hysteresis: 5 # La diff\u00e9rence de temp\u00e9rature maximale (en Celsius) par rapport \u00e0 une temp\u00e9rature # cible consid\u00e9r\u00e9e comme situ\u00e9e dans la plage de la cible. Ceci contr\u00f4le la v\u00e9rification # de la plage du param\u00e8tre max_error. Il est rare de personnaliser cette valeur. # La valeur par d\u00e9faut est 5. #heating_gain: 2 # La temp\u00e9rature minimale (en Celsius) pour laquelle le chauffage doit progresser # pendant la p\u00e9riode de check_gain_time. Il est rare de personnaliser cette valeur. # La valeur par d\u00e9faut est 2. [homing_heaters] \u00b6 Outil de d\u00e9sactivation des \u00e9l\u00e9ments chauffants lors de la prise d'origine ou du palpage d'un axe. [homing_heaters] #steppers: # Une liste de pilotes moteurs s\u00e9par\u00e9s par des virgules qui devraient d\u00e9sactiver les chauffages. # La valeur par d\u00e9faut est de d\u00e9sactiver les chauffages pour tout d\u00e9placement (mise \u00e0 # l'origine / palpage). # Exemple typique : stepper_z #heaters: # Une liste, s\u00e9par\u00e9e par des virgules, d'\u00e9l\u00e9ments chauffants \u00e0 d\u00e9sactiver pendant les d\u00e9placements # (mise \u00e0 l'origine / palpage). La valeur par d\u00e9faut est de d\u00e9sactiver tous les \u00e9l\u00e9ments chauffants. # Exemple typique : extruder, heater_bed [thermistor] \u00b6 Thermistances personnalis\u00e9es (on peut d\u00e9finir un nombre quelconque de sections avec le pr\u00e9fixe \"thermistor\"). Une thermistance personnalis\u00e9e peut \u00eatre utilis\u00e9e dans le champ sensor_type d'une section de configuration de chauffage. (Par exemple, si l'on d\u00e9finit une section \"[thermistor my_thermistor]\", on peut utiliser un \"sensor_type: my_thermistor\" lors de la d\u00e9finition d'un \u00e9l\u00e9ment de chauffe). Veillez \u00e0 placer la section thermistor dans le fichier de configuration avant sa premi\u00e8re utilisation dans une section de chauffage. [thermistor ma_thermistance] #temperature1: #resistance1: #temperature2: #resistance2: #temperature3: #resistance3: # Trois mesures de r\u00e9sistance (en Ohms) aux temp\u00e9ratures donn\u00e9es # (en Celsius). Ces trois mesures seront utilis\u00e9es pour calculer les # coefficients de Steinhart-Hart pour la thermistance. Ces param\u00e8tres # doivent \u00eatre fournis lors de l'utilisation de Steinhart-Hart pour d\u00e9finir la # thermistance. #beta: # Alternativement, on peut d\u00e9finir temp\u00e9rature1, r\u00e9sistance1, et beta # pour d\u00e9finir les param\u00e8tres de la thermistance. Ce param\u00e8tre doit \u00eatre # fourni lorsque l'on utilise \"beta\" pour d\u00e9finir la thermistance. [adc_temperature] \u00b6 Capteurs de temp\u00e9rature ADC personnalis\u00e9s (on peut d\u00e9finir un nombre quelconque de sections avec un pr\u00e9fixe \"adc_temperature\"). Cela permet de d\u00e9finir un capteur de temp\u00e9rature personnalis\u00e9 mesurant une tension sur une broche de convertisseur analogique-num\u00e9rique (ADC) et utilise une interpolation lin\u00e9aire entre un ensemble de mesures configur\u00e9es de temp\u00e9rature/tension (ou de temp\u00e9rature/r\u00e9sistance) pour d\u00e9terminer la temp\u00e9rature. Le capteur r\u00e9sultant peut \u00eatre utilis\u00e9 comme un type de capteur dans une section de chauffage. (Par exemple, si l'on d\u00e9finit une section \"[adc_temperature my_sensor]\", on peut utiliser un \"sensor_type : my_sensor\" lors de la d\u00e9finition d'un \u00e9l\u00e9ment chauffant). Veillez \u00e0 placer la section du capteur dans le fichier de configuration avant sa premi\u00e8re utilisation dans une section de chauffage. [adc_temperature mon_capteur] #temperature1: #voltage1: #temperature2: #voltage2: #... # Un ensemble de temp\u00e9ratures (en Celsius) et de tensions (en Volts) \u00e0 utiliser comme # r\u00e9f\u00e9rence lors de la conversion d'une temp\u00e9rature. Une section de chauffage utilisant # ce capteur peut \u00e9galement sp\u00e9cifier les param\u00e8tres adc_voltage et voltage_offset # pour d\u00e9finir la tension ADC (voir la section \"Amplificateurs communs de temp\u00e9rature\" # pour plus de d\u00e9tails). Au moins deux mesures doivent \u00eatre fournies. #temperature1: #resistance1: #temperature2: #resistance2: #... # Alternativement, on peut indiquer un ensemble de temp\u00e9ratures (en Celsius) # et de r\u00e9sistance (en Ohms) \u00e0 utiliser comme r\u00e9f\u00e9rence lors de la conversion d'une # temp\u00e9rature. Une section de chauffage utilisant ce capteur peut \u00e9galement sp\u00e9cifier un # param\u00e8tre pullup_resistor (voir la section \"extrudeuse\" pour plus de d\u00e9tails). Au # moins deux mesures doivent \u00eatre fournies. [heater_generic] \u00b6 \u00c9l\u00e9ments de chauffe g\u00e9n\u00e9riques (on peut d\u00e9finir un nombre quelconque de sections avec le pr\u00e9fixe \"heater_generic\"). Ces \u00e9l\u00e9ments de chauffe se comportent de la m\u00eame mani\u00e8re que les \u00e9l\u00e9ments de chauffe standards (extrudeuses, lits chauffants). Utilisez la commande SET_HEATER_TEMPERATURE (voir G-Codes pour plus de d\u00e9tails) pour d\u00e9finir la temp\u00e9rature cible. [heater_generic my_generic_heater] #gcode_id: # L'identifiant \u00e0 utiliser pour signaler la temp\u00e9rature dans la commande M105. # Ce param\u00e8tre doit \u00eatre fourni. #heater_pin: #max_power: #sensor_type: #sensor_pin: #smooth_time: #control: #pid_Kp: #pid_Ki: #pid_Kd: #pwm_cycle_time: #min_temp: #max_temp: # Voir la section \"extruder\" pour la d\u00e9finition des param\u00e8tres # ci-dessus. [temperature_sensor] \u00b6 Capteurs de temp\u00e9rature g\u00e9n\u00e9riques. On peut d\u00e9finir un nombre quelconque de capteurs de temp\u00e9rature suppl\u00e9mentaires signal\u00e9s par la commande M105. [temperature_sensor my_sensor] #sensor_type: #sensor_pin: #min_temp: #max_temp: # Voir la section \"extrudeuse\" pour la d\u00e9finition des param\u00e8tres # ci-dessus. #gcode_id: # Voir la section \"heater_generic\" pour la d\u00e9finition de ce # param\u00e8tre. Capteurs de temp\u00e9rature \u00b6 Klipper inclut les d\u00e9finitions de nombreux types de capteurs de temp\u00e9rature. Ces capteurs peuvent \u00eatre utilis\u00e9s dans n'importe quelle section de la configuration n\u00e9cessitant un capteur de temp\u00e9rature (comme une section [extruder] ou [heater_bed] ). Thermistances communes \u00b6 Thermistances communes. Les param\u00e8tres suivants sont disponibles dans les sections de chauffage utilisant l'un de ces capteurs. sensor_type: # Un parmi \"EPCOS 100K B57560G104F\", \"ATC Semitec 104GT-2\", # \"ATC Semitec 104NT-4-R025H42G\", \"Generic 3950\", # \"Honeywell 100K 135-104LAG-J01\", \"NTC 100K MGB18-104F39050L32\", # \"SliceEngineering 450\", ou \"TDK NTCG104LH104JT1\". sensor_pin: # Broche d'entr\u00e9e analogique connect\u00e9e \u00e0 la thermistance. Ce param\u00e8tre doit # \u00eatre fourni. #pullup_resistor: 4700 # La r\u00e9sistance (en ohms) de tirage (pullup) reli\u00e9e \u00e0 la thermistance. # La valeur par d\u00e9faut est 4700 ohms. #inline_resistor: 0 # La r\u00e9sistance (en ohms) d'une r\u00e9sistance suppl\u00e9mentaire (ne variant pas en fonction de # la chaleur) plac\u00e9e en ligne avec la thermistance. Il est rare de la d\u00e9finir. # La valeur par d\u00e9faut est 0 ohms. Amplificateurs de temp\u00e9rature courants \u00b6 Amplificateurs de temp\u00e9rature courants. Les param\u00e8tres suivants sont disponibles dans les sections de chauffage utilisant l'un de ces capteurs. sensor_type: # Un parmi \"PT100 INA826\", \"AD595\", \"AD597\", \"AD8494\", \"AD8495\", # \"AD8496\", ou \"AD8497\". sensor_pin: # Broche d'entr\u00e9e analogique connect\u00e9e au capteur. Ce param\u00e8tre doit \u00eatre # fourni. #adc_voltage: 5.0 # La tension de comparaison ADC (en Volts). La valeur par d\u00e9faut est de 5 volts. #voltage_offset: 0 # D\u00e9calage de la tension de l'ADC (en Volts). La valeur par d\u00e9faut est 0. Capteur PT1000 directement connect\u00e9 \u00b6 Capteur PT1000 connect\u00e9 en direct. Les param\u00e8tres suivants sont disponibles dans les sections chauffage utilisant ces capteurs. sensor_type : PT1000 sensor_pin: # Broche d'entr\u00e9e analogique connect\u00e9e au capteur. Ce param\u00e8tre doit \u00eatre # fourni. #pullup_resistor: 4700 # La r\u00e9sistance (en ohms) de tirage (pullup) reli\u00e9e au capteur. La valeur par # d\u00e9faut est 4700 ohms. Capteurs de temp\u00e9rature MAXxxxxx \u00b6 Capteurs MAXxxxxx \u00e0 interface p\u00e9riph\u00e9rique s\u00e9rie (SPI) bas\u00e9s sur la temp\u00e9rature. Les param\u00e8tres suivants sont disponibles dans les sections de chauffage qui utilisent l'un de ces types de capteurs. sensor_type : # Un parmi les types suivants : \"MAX6675\", \"MAX31855\", \"MAX31856\" ou \"MAX31865\". sensor_pin: # La broche de s\u00e9lection de puce pour la puce du capteur. Ce param\u00e8tre doit \u00eatre # fourni. #spi_speed: 4000000 # La vitesse SPI (en hz) \u00e0 utiliser lors de la communication avec la puce. # La valeur par d\u00e9faut est 4000000. #spi_bus: #spi_software_sclk_pin: #spi_software_mosi_pin: #spi_software_miso_pin: # Voir la section \"param\u00e8tres SPI communs\" pour une description des # param\u00e8tres ci-dessus. #tc_type: K #tc_use_50Hz_filter: False #tc_averaging_count: 1 # Les param\u00e8tres ci-dessus contr\u00f4lent les param\u00e8tres des capteurs des puces MAX31856 # Les valeurs par d\u00e9faut de chaque param\u00e8tre sont indiqu\u00e9es \u00e0 c\u00f4t\u00e9 du nom du param\u00e8tre # dans la liste ci-dessus. #rtd_nominal_r: 100 #rtd_reference_r: 430 #rtd_num_of_wires: 2 #rtd_use_50Hz_filter: False # Les param\u00e8tres ci-dessus contr\u00f4lent les param\u00e8tres des capteurs des puces MAX31865 # Les valeurs par d\u00e9faut de chaque param\u00e8tre sont indiqu\u00e9es \u00e0 c\u00f4t\u00e9 du nom du param\u00e8tre # dans la liste ci-dessus. Capteurs de temp\u00e9rature BMP280/BME280/BME680 \u00b6 Capteurs environnementaux BMP280/BME280/BME680 \u00e0 interface \u00e0 deux fils (I2C). Notez que ces capteurs ne sont pas destin\u00e9s \u00e0 \u00eatre utilis\u00e9s avec des extrudeurs et des lits chauffants, mais plut\u00f4t pour surveiller la temp\u00e9rature ambiante (C), la pression (hPa), l'humidit\u00e9 relative et, dans le cas du BME680, le niveau de gaz. Voir sample-macros.cfg pour un gcode_macro pouvant \u00eatre utilis\u00e9 pour signaler la pression et l'humidit\u00e9 en plus de la temp\u00e9rature. sensor_type: BME280 #i2c_address: # La valeur par d\u00e9faut est 118 (0x76). Certains capteurs BME280 ont une adresse de 119 # (0x77). #i2c_mcu: #i2c_bus: #i2c_speed: # Voir la section \"param\u00e8tres I2C communs\" pour une description des # param\u00e8tres ci-dessus. Capteur HTU21D \u00b6 Capteur d'environnement de la famille HTU21D \u00e0 interface \u00e0 deux fils (I2C). Notez que ce capteur n'est pas destin\u00e9 \u00e0 \u00eatre utilis\u00e9 avec les extrudeuses et les lits chauffants, mais plut\u00f4t \u00e0 surveiller la temp\u00e9rature ambiante (C) et l'humidit\u00e9 relative. Voir sample-macros.cfg pour un gcode_macro utilisable permettant d'indiquer l'humidit\u00e9 en plus de la temp\u00e9rature. sensor_type: # Doit \u00eatre \"HTU21D\" , \"SI7013\", \"SI7020\", \"SI7021\" ou \"SHT21\". #i2c_address: # La valeur par d\u00e9faut est 64 (0x40). #i2c_mcu: #i2c_bus: #i2c_speed: # Voir la section \"param\u00e8tres I2C communs\" pour une description des # param\u00e8tres ci-dessus. #htu21d_hold_master: # Si le capteur peut maintenir le tampon I2C durant la lecture. Si True, aucune autre # communication par bus ne peut \u00eatre effectu\u00e9e durant la lecture en cours. # La valeur par d\u00e9faut est False. #htu21d_resolution: # La r\u00e9solution de lecture de la temp\u00e9rature et de l'humidit\u00e9. # Les valeurs valides sont : # 'TEMP14_HUM12' -> 14 bits pour la temp\u00e9rature et 12 bits pour l'humidit\u00e9. # 'TEMP13_HUM10' -> 13 bits pour la temp\u00e9rature et 10 bits pour l'humidit\u00e9. # 'TEMP12_HUM08' -> 12 bits pour la temp\u00e9rature et 08 bits pour l'humidit\u00e9 # 'TEMP11_HUM11' -> 11 bits pour la temp\u00e9rature et 11 bits pour l'humidit\u00e9 # La valeur par d\u00e9faut est \"TEMP11_HUM11\" #htu21d_report_time: # Intervalle en secondes entre les lectures. La valeur par d\u00e9faut est 30 Capteur de temp\u00e9rature LM75 \u00b6 Capteurs de temp\u00e9rature LM75/LM75A connect\u00e9s en deux fils (I2C). Ces capteurs ont une gamme de -55~125 \u00b0C, et sont donc utilisables par exemple pour la surveillance de la temp\u00e9rature d'une chambre. Ils peuvent aussi fonctionner comme de simples contr\u00f4leurs de ventilateurs/\u00e9l\u00e9ments chauffants. sensor_type: LM75 #i2c_address: # La valeur par d\u00e9faut est 72 (0x48). La plage normale est 72-79 (0x48-0x4F), les 3 # bits de poids faible de l'adresse sont configur\u00e9s via des broches sur la puce # (g\u00e9n\u00e9ralement avec des cavaliers ou c\u00e2bl\u00e9s). #i2c_mcu: #i2c_bus: #i2c_speed: # Voir la section \"param\u00e8tres I2C communs\" pour une description des # param\u00e8tres ci-dessus. #lm75_report_time: # Intervalle en secondes entre les lectures. La valeur par d\u00e9faut est 0.8, avec un # minimum de 0.5. Capteur de temp\u00e9rature int\u00e9gr\u00e9 au microcontr\u00f4leur \u00b6 Les micro-contr\u00f4leurs atsam, atsamd, et stm32 poss\u00e8dent un capteur de temp\u00e9rature interne. On peut utiliser le capteur \"temperature_mcu\" pour surveiller ces temp\u00e9ratures. sensor_type: temperature_mcu #sensor_mcu: mcu # Le micro-contr\u00f4leur \u00e0 lire. La valeur par d\u00e9faut est \"mcu\". #sensor_temperature1: #sensor_adc1: # Sp\u00e9cifiez les deux param\u00e8tres ci-dessus (une temp\u00e9rature en Celsius et une valeur d' ADC sous # forme de flottant entre 0,0 et 1,0) pour calibrer la temp\u00e9rature du microcontr\u00f4leur. Cela peut # am\u00e9liorer la pr\u00e9cision de la temp\u00e9rature rapport\u00e9e sur certaines puces. Une fa\u00e7on typique d'obtenir # ces informations d'\u00e9talonnage est de couper compl\u00e8tement l'alimentation de l'imprimante pendant # quelques heures (afin de s'assurer qu'elle est \u00e0 la temp\u00e9rature ambiante), puis de la remettre sous # tension et d'utiliser la fonction QUERY_ADC pour obtenir une mesure ADC. # Utilisez un autre capteur de temp\u00e9rature sur l'imprimante pour trouver la temp\u00e9rature ambiante # correspondante. La valeur par d\u00e9faut est d'utiliser les donn\u00e9es d'\u00e9talonnage d'usine du microcontr\u00f4leur # (le cas \u00e9ch\u00e9ant) ou les valeurs nominales de la sp\u00e9cification du microcontr\u00f4leur. #sensor_temperature2: #sensor_adc2: # Si sensor_temperature1/sensor_adc1 est sp\u00e9cifi\u00e9, on peut \u00e9galement sp\u00e9cifier les donn\u00e9es # d'\u00e9talonnage de sensor_temperature2/sensor_adc2. En proc\u00e9dant ainsi on peut fournir des # informations calibr\u00e9es sur la \"pente de temp\u00e9rature\". La valeur par d\u00e9faut est d'utiliser les donn\u00e9es # d'\u00e9talonnage d'usine sur le microcontr\u00f4leur (le cas \u00e9ch\u00e9ant) ou les valeurs nominales de la # sp\u00e9cification du microcontr\u00f4leur. Capteur de temp\u00e9rature de l'h\u00f4te \u00b6 Temp\u00e9rature de la machine (par exemple Raspberry Pi) ex\u00e9cutant le logiciel h\u00f4te. sensor_type: temperature_host #sensor_path: # Le chemin d'acc\u00e8s au fichier syst\u00e8me de temp\u00e9rature. La valeur par d\u00e9faut est # \" /sys/class/thermal/thermal_zone0/temp \" qui est le fichier syst\u00e8me de # temp\u00e9rature sur un ordinateur Raspberry Pi. Capteur de temp\u00e9rature DS18B20 \u00b6 Le DS18B20 est un capteur de temp\u00e9rature num\u00e9rique \u00e0 1 fil (w1). Notez que ce capteur n'est pas destin\u00e9 \u00e0 \u00eatre utilis\u00e9 avec les extrudeurs et les lits chauffants, mais plut\u00f4t pour surveiller la temp\u00e9rature ambiante (C). Ces capteurs ont une port\u00e9e allant jusqu'\u00e0 125 \u00b0C et sont donc utilisables pour la surveillance de la temp\u00e9rature d'un caisson par exemple. Ils peuvent \u00e9galement fonctionner comme de simples contr\u00f4leurs de ventilateurs/\u00e9l\u00e9ments chauffants. Les capteurs DS18B20 ne sont support\u00e9s que par un \"mcu h\u00f4te\", par exemple le Raspberry Pi. Le module w1-gpio du noyau Linux doit \u00eatre install\u00e9. sensor_type: DS18B20 serial_no: # Chaque dispositif \u00e0 1-wire poss\u00e8de un num\u00e9ro de s\u00e9rie unique utilis\u00e9 pour l'identifier, # g\u00e9n\u00e9ralement au format 28-031674b175ff. Ce param\u00e8tre doit \u00eatre fourni. # Les p\u00e9riph\u00e9riques 1-wire connect\u00e9s peuvent \u00eatre list\u00e9s \u00e0 l'aide de la commande Linux suivante : # ls /sys/bus/w1/devices/ #ds18_report_time: # Intervalle en secondes entre les lectures. La valeur par d\u00e9faut est de 3,0, avec un minimum de 1,0. #sensor_mcu: # Le micro-contr\u00f4leur \u00e0 lire. Doit \u00eatre le host_mcu Ventilateurs \u00b6 [fan] \u00b6 Ventilateur de refroidissement de la pi\u00e8ce. [fan] pin: # Broche de sortie contr\u00f4lant le ventilateur. Ce param\u00e8tre doit \u00eatre fourni. #max_power: 1.0 # La puissance maximale (exprim\u00e9e en tant que valeur comprise entre 0,0 et 1,0) \u00e0 laquelle # r\u00e9gler la broche. La valeur 1.0 permet de r\u00e9gler la broche enti\u00e8rement activ\u00e9e pendant de # longues p\u00e9riodes, tandis qu'une valeur de 0,5 permet \u00e0 la broche de n'\u00eatre activ\u00e9e que # durant la moiti\u00e9 du temps au maximum. Ce param\u00e8tre peut \u00eatre utilis\u00e9 pour limiter la # puissance totale de sortie (sur des p\u00e9riodes prolong\u00e9es) du ventilateur. # Si cette valeur est inf\u00e9rieure \u00e0 1,0, les demandes de vitesse du ventilateur seront mises \u00e0 # l'\u00e9chelle entre z\u00e9ro et max_power (par exemple, si la puissance maximale est de 0,9 et # qu'une vitesse de 80 % est demand\u00e9e, la puissance du ventilateur sera r\u00e9gl\u00e9e \u00e0 72 %. # La valeur par d\u00e9faut est 1.0. #shutdown_speed: 0 # La vitesse souhait\u00e9e du ventilateur (exprim\u00e9e comme une valeur de 0,0 \u00e0 1,0) si # le logiciel du microcontr\u00f4leur passe dans un \u00e9tat d'erreur. La valeur par d\u00e9faut # est 0. #cycle_time: 0.010 # La dur\u00e9e (en secondes) de chaque cycle d'alimentation PWM du ventilateur. Il est # recommand\u00e9 que cette dur\u00e9e soit de 10 millisecondes ou plus si vous utilisez un PWM logiciel. # La valeur par d\u00e9faut est de 0,010 seconde. #hardware_pwm: False # Activez ceci pour utiliser le PWM mat\u00e9riel au lieu du PWM logiciel. La plupart des ventilateurs # ne fonctionnent pas correctement avec le PWM mat\u00e9riel, il n'est donc pas recommand\u00e9 # d'activer cette option \u00e0 moins qu'il n'y ait une exigence \u00e9lectrique pour obtenir une tr\u00e8s haute # vitesse. Lorsque vous utilisez le PWM mat\u00e9riel, le temps de cycle r\u00e9el est contraint par la mise # en \u0153uvre et peut \u00eatre significativement diff\u00e9rent du temps de cycle demand\u00e9. # La valeur par d\u00e9faut est False. #kick_start_time: 0.100 # Dur\u00e9e (en secondes) de fonctionnement du ventilateur \u00e0 pleine vitesse, soit lors de sa premi\u00e8re # activation soit lors d'une augmentation de plus de 50% (pour faire tourner le ventilateur). # La valeur par d\u00e9faut est de 0,100 seconde. #off_below: 0.0 # La vitesse d'entr\u00e9e minimale qui alimentera le ventilateur (exprim\u00e9e comme une valeur # comprise entre 0,0 et 1,0). Quand une vitesse inf\u00e9rieure \u00e0 off_below est demand\u00e9e le ventilateur # sera d\u00e9sactiv\u00e9. Ce r\u00e9glage peut \u00eatre utilis\u00e9 pour \u00e9viter que le ventilateur ne cale et pour # garantir que les d\u00e9marrages sont efficaces. # La valeur par d\u00e9faut est 0.0. # # Ce param\u00e8tre doit \u00eatre recalibr\u00e9 chaque fois que max_power est ajust\u00e9. # Pour calibrer ce param\u00e8tre, commencez avec off_below r\u00e9gl\u00e9 sur 0.0 et ventilateur tournant. Diminuez # progressivement la vitesse du ventilateur afin de d\u00e9terminer la vitesse d'entr\u00e9e la plus faible entra\u00eenant # le ventilateur de mani\u00e8re fiable sans d\u00e9crochage. R\u00e9glez off_below au rapport cyclique correspondant # \u00e0 cette valeur (par exemple, 12% -> 0,12) ou l\u00e9g\u00e8rement plus. #tachometer_pin: # Broche d'entr\u00e9e tachym\u00e9trique de surveillance de la vitesse du ventilateur. Un pullup est g\u00e9n\u00e9ralement # n\u00e9cessaire. Ce param\u00e8tre est facultatif. #tachometer_ppr: 2 # Lorsque tachometer_pin est sp\u00e9cifi\u00e9, il s'agit du nombre d'impulsions par r\u00e9volution du signal # tachym\u00e9trique. Pour un ventilateur BLDC, c'est normalement la moiti\u00e9 du nombre de p\u00f4les. # La valeur par d\u00e9faut est 2. #tachometer_poll_interval: 0.0015 # Lorsque tachometer_pin est sp\u00e9cifi\u00e9, il s'agit de la p\u00e9riode d'interrogation de la broche tachym\u00e9trique, # en secondes. La valeur par d\u00e9faut est 0.0015, ce qui est suffisamment rapide pour des ventilateurs de # moins de 10000 RPM \u00e0 2 PPR. Cette valeur doit \u00eatre inf\u00e9rieure \u00e0 30/(tachometer_ppr*rpm), avec une # certaine marge, o\u00f9 rpm est la vitesse maximale (en RPM) du ventilateur. #enable_pin: # Broche optionnelle pour d'activation de l'alimentation du ventilateur. Cela peut \u00eatre utile pour les # ventilateurs avec des entr\u00e9es PWM d\u00e9di\u00e9es. Certains de ces ventilateurs restent allum\u00e9s m\u00eame \u00e0 0 % # de PWM. Dans ce cas, la broche PWM peut \u00eatre utilis\u00e9e normalement et, par exemple, un FET commut\u00e9 # \u00e0 la masse (broche de ventilateur standard) peut \u00eatre utilis\u00e9 pour contr\u00f4ler l'alimentation du ventilateur. [heater_fan] \u00b6 Ventilateurs de chauffage (on peut d\u00e9finir un nombre quelconque de sections avec le pr\u00e9fixe \"heater_fan\"). Un \"ventilateur de chauffage\" est un ventilateur activ\u00e9 lorsque le chauffage qui lui est associ\u00e9 est actif. Par d\u00e9faut, un heater_fan a une vitesse d'arr\u00eat \u00e9gale \u00e0 la puissance maximale. [heater_fan my_nozzle_fan] #pin: #max_power: #shutdown_speed: #cycle_time: #hardware_pwm: #kick_start_time: #off_below: #tachometer_pin: #tachometer_ppr: #tachometer_poll_interval: #enable_pin: # Voir la section \"fan\" pour une description des param\u00e8tres ci-dessus. #heater: extruder # Nom de la section de configuration d\u00e9finissant le chauffage auquel ce ventilateur est associ\u00e9. # Si une liste de noms d'\u00e9l\u00e9ments chauffants s\u00e9par\u00e9s par des virgules est fournie ici, le # ventilateur sera activ\u00e9 lorsque l'un des chauffages donn\u00e9s est activ\u00e9. # La valeur par d\u00e9faut est \"extruder\". #heater_temp: 50.0 # Temp\u00e9rature (en Celsius) en dessous de laquelle l'\u00e9l\u00e9ment chauffant doit descendre pour que # le ventilateur soit d\u00e9sactiv\u00e9. La valeur par d\u00e9faut est 50 \u00b0C. #fan_speed: 1.0 # La vitesse du ventilateur (exprim\u00e9e sous la forme d'une valeur comprise entre 0,0 et 1,0) \u00e0 # laquelle le ventilateur sera r\u00e9gl\u00e9 lorsque l'\u00e9l\u00e9ment chauffant qui lui est associ\u00e9 est activ\u00e9. # La valeur par d\u00e9faut est 1.0 [controller_fan] \u00b6 Ventilateur de refroidissement du contr\u00f4leur (on peut d\u00e9finir un nombre quelconque de sections avec le pr\u00e9fixe \"controller_fan\"). Un \"ventilateur de contr\u00f4leur\" est un ventilateur activ\u00e9 chaque fois que l'\u00e9l\u00e9ment chauffant ou le pilote pas \u00e0 pas qui lui est associ\u00e9 est actif. Le ventilateur s'arr\u00eatera chaque fois qu'un idle_timeout sera atteint afin de garantir qu'aucune surchauffe ne se produise apr\u00e8s la d\u00e9sactivation d'un composant surveill\u00e9. [controller_fan my_controller_fan] #pin: #max_power: #shutdown_speed: #cycle_time: #hardware_pwm: #kick_start_time: #off_below: #tachometer_pin: #tachometer_ppr: #tachometer_poll_interval: #enable_pin: # Voir la section \"fan\" pour une description des param\u00e8tres ci-dessus. #fan_speed: 1.0 # Vitesse du ventilateur (exprim\u00e9e comme une valeur de 0,0 \u00e0 1,0) \u00e0 laquelle celui-ci # sera r\u00e9gl\u00e9 lorsqu'un chauffage ou un pilote pas \u00e0 pas est actif. # La valeur par d\u00e9faut est 1.0 #idle_timeout: # Dur\u00e9e (en secondes) apr\u00e8s activit\u00e9 d'un pilote pas \u00e0 pas ou d'un \u00e9l\u00e9ment chauffant # pour laquelle le ventilateur doit continuer de fonctionner. La valeur par d\u00e9faut # est de 30 secondes. #idle_speed: # Vitesse du ventilateur (exprim\u00e9e comme une valeur de 0,0 et 1,0) \u00e0 laquelle le r\u00e9gler # lors de l'activit\u00e9 d'une chauffe ou d'un pilote pas \u00e0 pas avant que le d\u00e9lai d'attente # idle_timeout ne soit atteint. La valeur par d\u00e9faut est fan_speed. #heater: #stepper : # Nom de la section de configuration d\u00e9finissant l'\u00e9l\u00e9ment chauffant/pilote auquel ce ventilateur # est associ\u00e9. Si une liste s\u00e9par\u00e9e par des virgules de noms d'\u00e9l\u00e9ments chauffants/pilotes est # fournie ici, le ventilateur s'activera lorsque l'un des \u00e9l\u00e9ments chauffants/pilotes donn\u00e9s est activ\u00e9. # Le chauffage par d\u00e9faut est \"extruder\", le pilote par d\u00e9faut est tous. [temperature_fan] \u00b6 Ventilateurs de refroidissement d\u00e9clench\u00e9s en fonction de la temp\u00e9rature (on peut d\u00e9finir un nombre quelconque de sections avec le pr\u00e9fixe \"temperature_fan\"). Un \"ventilateur de temp\u00e9rature\" est un ventilateur activ\u00e9 lorsque le capteur qui lui est associ\u00e9 est au-dessus d'une temp\u00e9rature d\u00e9finie. Par d\u00e9faut, un ventilateur de temp\u00e9rature a une vitesse d'arr\u00eat \u00e9gale \u00e0 la puissance maximale. Voir la r\u00e9f\u00e9rence des commandes pour plus d'informations. [temperature_fan my_temp_fan] #pin: #max_power: #shutdown_speed: #cycle_time: #hardware_pwm: #kick_start_time: #off_below: #tachometer_pin: #tachometer_ppr: #tachometer_poll_interval: #enable_pin: # Voir la section \"ventilateur\" pour une description des param\u00e8tres ci-dessus. #sensor_type: #sensor_pin: #control: #max_delta: #min_temp: #max_temp: # Voir la section \"extrudeuse\" pour une description des param\u00e8tres ci-dessus. #pid_Kp: #pid_Ki: #pid_Kd: # Les param\u00e8tres proportionnels (pid_Kp), int\u00e9graux (pid_Ki), et d\u00e9riv\u00e9s (pid_Ki) # du syst\u00e8me de contr\u00f4le par r\u00e9troaction PID. Klipper \u00e9value les param\u00e8tres PID # avec la formule g\u00e9n\u00e9rale suivante : # fan_pwm = max_power - (Kp*e + Ki*integral(e) - Kd*derivative(e)) / 255 # O\u00f9 \"e\" est \"temp\u00e9rature_cible - temp\u00e9rature_mesur\u00e9e\" et # \"fan_pwm\" est le d\u00e9bit du ventilateur demand\u00e9, 0,0 correspondant \u00e0 un arr\u00eat complet # et 1,0 correspond \u00e0 un fonctionnement \u00e0 plein r\u00e9gime. Les param\u00e8tres pid_Kp, pid_Ki, # et pid_Kd doivent \u00eatre fournis lorsque l'algorithme de contr\u00f4le PID est activ\u00e9. #pid_deriv_time: 2.0 # Une dur\u00e9e (en secondes) sur laquelle lisser les mesures de temp\u00e9rature lors de # l'utilisation de l'algorithme de contr\u00f4le PID. Cela peut r\u00e9duire l'impact du bruit de # mesure. La valeur par d\u00e9faut est de 2 secondes. #target_temp: 40.0 # Une temp\u00e9rature (en Celsius) qui sera la temp\u00e9rature cible. # La valeur par d\u00e9faut est 40 degr\u00e9s. #max_speed: 1.0 # La vitesse du ventilateur (exprim\u00e9e comme une valeur de 0,0 \u00e0 1,0) \u00e0 laquelle r\u00e9gler # le ventilateur lorsque la temp\u00e9rature du capteur d\u00e9passera la valeur d\u00e9finie. # La valeur par d\u00e9faut est 1.0. #min_speed: 0.3 # Vitesse minimale du ventilateur (exprim\u00e9e sous forme d'une valeur comprise entre 0,0 # et 1,0) \u00e0 laquelle r\u00e9gler le ventilateur pour les ventilateurs \u00e0 temp\u00e9rature PID. # La valeur par d\u00e9faut est 0,3. #gcode_id: # S'il est d\u00e9fini, la temp\u00e9rature sera signal\u00e9e dans les requ\u00eates M105 en utilisant l'identifiant # d'id donn\u00e9. La valeur par d\u00e9faut est de ne pas rapporter la temp\u00e9rature via M105. [fan_generic] \u00b6 Ventilateur command\u00e9 manuellement (on peut d\u00e9finir un nombre quelconque de sections avec le pr\u00e9fixe \"fan_generic\"). La vitesse d'un ventilateur command\u00e9 manuellement est r\u00e9gl\u00e9e avec la commande SET_FAN_SPEED commandes G-Code . [fan_generic extruder_partfan] #pin: #max_power: #shutdown_speed: #cycle_time: #hardware_pwm: #kick_start_time: #off_below: #tachometer_pin: #tachometer_ppr: #tachometer_poll_interval: #enable_pin: # Voir la section \"ventilateur\" pour une description des param\u00e8tres ci-dessus. LEDs \u00b6 [led] \u00b6 Prise en charge des LEDs (et des bandes de LEDs) contr\u00f4l\u00e9es par les broches PWM du microcontr\u00f4leur (on peut d\u00e9finir un nombre quelconque de sections avec le pr\u00e9fixe \"led\"). Voir la r\u00e9f\u00e9rence de la commande pour plus d'informations. [led my_led] #red_pin: #green_pin: #blue_pin: #white_pin: # La broche contr\u00f4lant la couleur de la LED donn\u00e9e. Au moins un des param\u00e8tres ci-dessus # doit \u00eatre fourni. #cycle_time: 0.010 # Dur\u00e9e (en secondes) par cycle PWM. Il est recommand\u00e9 # que ce soit 10 millisecondes ou plus lorsque l'on utilise un PWM logiciel. # La valeur par d\u00e9faut est de 0,010 seconde. #hardware_pwm: False # Activez ceci pour utiliser le PWM mat\u00e9riel au lieu du PWM logiciel. Lors de # l'utilisation du PWM mat\u00e9riel, le temps de cycle r\u00e9el est contraint par # l'impl\u00e9mentation et peut \u00eatre significativement diff\u00e9rent du # cycle_time demand\u00e9. La valeur par d\u00e9faut est False. #initial_RED: 0.0 #initial_GREEN: 0.0 #initial_BLUE: 0.0 #initial_WHITE: 0.0 # D\u00e9finit la couleur initiale de la LED. Chaque valeur doit \u00eatre comprise entre 0.0 et # 1.0. La valeur par d\u00e9faut pour chaque couleur est 0. [neopixel] \u00b6 Prise en charge des LED neopixel (alias WS2812) (on peut d\u00e9finir un nombre quelconque de sections avec le pr\u00e9fixe \"neopixel\"). Voir la r\u00e9f\u00e9rence de commande pour plus d'informations. Notez que l'impl\u00e9mentation du mcu linux ne supporte pas actuellement les neopixels directement connect\u00e9s. La conception actuelle utilisant l'interface du noyau Linux ne permet pas ce sc\u00e9nario car l'interface GPIO du noyau n'est pas assez rapide pour fournir les taux d'impulsion requis. [neopixel my_neopixel] pin: # La broche connect\u00e9e au neopixel. Ce param\u00e8tre doit \u00eatre # fourni. #chain_count: # Le nombre de puces Neopixel connect\u00e9es en \"cha\u00eene\" \u00e0 la broche fournie. # La valeur par d\u00e9faut est 1 (ce qui indique qu'un seul Neopixel est connect\u00e9 \u00e0 la broche). #color_order: GRB # D\u00e9finit l'ordre des pixels requis par le mat\u00e9riel LED (en utilisant une cha\u00eene # contenant les lettres R, G, B, W avec W en option). Alternativement, il peut s'agir d'une liste # d'ordres de pixels s\u00e9par\u00e9s par des virgules - un pour chaque LED de la cha\u00eene. # La valeur par d\u00e9faut est GRB. #initial_RED: 0.0 #initial_GREEN: 0.0 #initial_BLUE: 0.0 #initial_WHITE: 0.0 # Voir la section \"led\" pour des informations sur ces param\u00e8tres. [dotstar] \u00b6 Prise en charge des LEDs Dotstar (alias APA102) (on peut d\u00e9finir un nombre quelconque de sections avec le pr\u00e9fixe \"dotstar\"). Voir la r\u00e9f\u00e9rence de commande pour plus d'informations. [dotstar my_dotstar] data_pin: # La broche connect\u00e9e \u00e0 la ligne de donn\u00e9es du dotstar. Ce param\u00e8tre # doit \u00eatre fourni. clock_pin: # La broche connect\u00e9e \u00e0 la ligne d'horloge du dotstar. Ce param\u00e8tre # doit \u00eatre fourni. #chain_count: # Voir la section \"neopixel\" pour des informations sur ce param\u00e8tre. #initial_RED: 0.0 #initial_GREEN: 0.0 #initial_BLUE: 0.0 # Voir la section \"led\" pour des informations sur ces param\u00e8tres. [pca9533] \u00b6 Support de la LED PCA9533. Le PCA9533 est utilis\u00e9 sur la mightyboard. [pca9533 my_pca9533] #i2c_address : 98 # L'adresse i2c que la puce utilise sur le bus i2c. Utilisez 98 pour # le PCA9533/1, 99 pour le PCA9533/2. La valeur par d\u00e9faut est 98. #i2c_mcu: #i2c_bus: #i2c_speed: # Voir la section \"param\u00e8tres I2C communs\" pour une description des # param\u00e8tres ci-dessus. #initial_RED: 0.0 #initial_GREEN: 0.0 #initial_BLUE: 0.0 #initial_WHITE: 0.0 # Voir la section \"led\" pour des informations sur ces param\u00e8tres. [pca9632] \u00b6 Support des LEDs du PCA9632. Le PCA9632 est utilis\u00e9 sur le FlashForge Dreamer. [pca9632 my_pca9632] #i2c_address 98 # L'adresse i2c que la puce utilise sur le bus i2c. Cela peut \u00eatre # 96, 97, 98, ou 99. La valeur par d\u00e9faut est 98. #i2c_mcu: #i2c_bus: #i2c_speed: # Voir la section \"param\u00e8tres I2C communs\" pour une description des # param\u00e8tres ci-dessus. #scl_pin: #sda_pin: # Alternativement, si le pca9632 n'est pas connect\u00e9 \u00e0 un bus mat\u00e9riel I2C # il est possible de sp\u00e9cifier les broches \"clock\" (scl_pin) et \"data\" (sda_pin). # Le d\u00e9faut est d'utiliser l'I2C mat\u00e9riel. #color_order : RGBW # D\u00e9finit l'ordre des pixels de la LED (en utilisant une cha\u00eene contenant les lettres # R, G, B, W). La valeur par d\u00e9faut est RGBW. #initial_RED: 0.0 #initial_GREEN: 0.0 #initial_BLUE: 0.0 #initial_WHITE: 0.0 # Voir la section \"led\" pour des informations sur ces param\u00e8tres. Servos suppl\u00e9mentaires, boutons et autres broches \u00b6 [servo] \u00b6 Servos (on peut d\u00e9finir un nombre quelconque de sections avec le pr\u00e9fixe \"servo\"). Les servos peuvent \u00eatre contr\u00f4l\u00e9s en utilisant la commande SET_SERVO g-code . Par exemple : SET_SERVO SERVO=my_servo ANGLE=180 [servo my_servo] pin: # Broche de sortie PWM contr\u00f4lant le servo. Ce param\u00e8tre doit \u00eatre # fourni. #maximum_servo_angle: 180 # L'angle maximum (en degr\u00e9s) auquel ce servo peut \u00eatre r\u00e9gl\u00e9. La valeur # par d\u00e9faut est de 180 degr\u00e9s. #minimum_pulse_width: 0.001 # La dur\u00e9e minimale de la largeur d'impulsion (en secondes). Cela devrait correspondre # avec un angle de 0 degr\u00e9. La valeur par d\u00e9faut est de 0,001 seconde. #maximum_pulse_width: 0.002 # La dur\u00e9e maximale de la largeur d'impulsion (en secondes). Cela devrait correspondre # avec l'angle de maximum_servo_angle. La valeur par d\u00e9faut est 0.002 secondes. #initial_angle: # Angle initial (en degr\u00e9s) sur lequel r\u00e9gler le servo. La valeur par d\u00e9faut est de # ne pas envoyer de signal au d\u00e9marrage. #initial_pulse_width: # Dur\u00e9e initiale de la largeur d'impulsion (en secondes) \u00e0 laquelle le servo doit \u00eatre r\u00e9gl\u00e9. (Ceci # n'est valable que si initial_angle n'est pas d\u00e9fini). La valeur par d\u00e9faut est de n'envoyer # aucun signal au d\u00e9marrage. [gcode_button] \u00b6 Ex\u00e9cute le gcode quand un bouton est press\u00e9 ou rel\u00e2ch\u00e9 (ou quand une broche change d'\u00e9tat). Vous pouvez v\u00e9rifier l'\u00e9tat du bouton en utilisant QUERY_BUTTON button=my_gcode_button . [gcode_button my_gcode_button] pin: # La broche sur laquelle le bouton est connect\u00e9. Ce param\u00e8tre doit \u00eatre # fourni. #analog_range: # Deux r\u00e9sistances s\u00e9par\u00e9es par des virgules (en Ohms) sp\u00e9cifiant la plage de # r\u00e9sistance minimale et maximale de la r\u00e9sistance du bouton. Si le param\u00e8tre # analog_range est fourni, la broche doit \u00eatre une broche \u00e0 capacit\u00e9 analogique. # La valeur par d\u00e9faut est d'utiliser un gpio num\u00e9rique pour le bouton. #analog_pullup_resistor: # La r\u00e9sistance d'excursion (en Ohms) lorsque la gamme analogique est sp\u00e9cifi\u00e9e. # La valeur par d\u00e9faut est 4700 ohms. #press_gcode: # Une liste de commandes G-Code \u00e0 ex\u00e9cuter lorsque le bouton est press\u00e9. # Les mod\u00e8les G-Code sont pris en charge. Ce param\u00e8tre doit \u00eatre fourni. #release_gcode: # Une liste de commandes G-code \u00e0 ex\u00e9cuter lorsque le bouton est rel\u00e2ch\u00e9. # Les mod\u00e8les G-Code sont support\u00e9s. La valeur par d\u00e9faut est de ne pas ex\u00e9cuter # de commandes lors du rel\u00e2chement d'un bouton. [output_pin] \u00b6 Broches de sortie configurables \u00e0 l'ex\u00e9cution (on peut d\u00e9finir un nombre quelconque de sections avec un pr\u00e9fixe \"output_pin\"). Les broches configur\u00e9es ici seront param\u00e9tr\u00e9es comme des broches de sortie modifiables au moment de l'ex\u00e9cution en utilisant des commandes g-code \u00e9tendues de type \"SET_PIN PIN=my_pin VALUE=.1\" [output_pin my_pin] pin: # La broche \u00e0 configurer comme une sortie. Ce param\u00e8tre doit \u00eatre # fourni. #pwm: False # D\u00e9finit si la broche de sortie doit \u00eatre capable de modulation de largeur d'impulsion. # Si ce param\u00e8tre est vrai, les champs de valeur doivent \u00eatre compris entre 0 et 1. # La valeur par d\u00e9faut est False. #static_value: # Si cette valeur est d\u00e9finie, la broche est affect\u00e9e \u00e0 cette valeur au d\u00e9marrage et # la broche ne peut pas \u00eatre modifi\u00e9e pendant l'ex\u00e9cution. Une broche statique utilise # l\u00e9g\u00e8rement moins de RAM dans le micro-contr\u00f4leur. Le d\u00e9faut est d'utiliser # la configuration des broches param\u00e9tr\u00e9es lors du d\u00e9marrage. #value: # La valeur \u00e0 donner initialement \u00e0 la broche pendant la configuration du MCU. # La valeur par d\u00e9faut est 0 (pour une tension basse). #shutdown_value: # La valeur \u00e0 donner \u00e0 la broche lors d'un \u00e9v\u00e9nement d'arr\u00eat du MCU. La valeur par # d\u00e9faut est 0 (pour une tension basse). #maximum_mcu_duration: # La dur\u00e9e maximale pendant laquelle une valeur de non-arr\u00eat peut \u00eatre pilot\u00e9e par # le MCUsans un accus\u00e9 de r\u00e9ception de l'h\u00f4te. # Si l'h\u00f4te ne peut pas suivre une mise \u00e0 jour, le MCU s'\u00e9teindra et mettra # toutes les broches \u00e0 leurs valeurs d'arr\u00eat respectives. # D\u00e9faut : 0 (d\u00e9sactiv\u00e9) # Les valeurs habituelles sont d'environ 5 secondes. #cycle_time: 0.100 # La dur\u00e9e (en secondes) par cycle PWM. Il est recommand\u00e9 que ce soit # 10 millisecondes ou plus lorsque vous utilisez un PWM logiciel. # La valeur par d\u00e9faut est de 0.100 secondes pour les broches PWM. #hardware_pwm: False # Activez pour utiliser le PWM mat\u00e9riel au lieu du PWM logiciel. Lors de # l'utilisation d'un PWM mat\u00e9riel, le temps de cycle r\u00e9el est limit\u00e9 par # l'impl\u00e9mentation et peut \u00eatre significativement diff\u00e9rent du # cycle_time demand\u00e9. La valeur par d\u00e9faut est False. #scale : # Ce param\u00e8tre peut \u00eatre utilis\u00e9 pour modifier la fa\u00e7on dont les param\u00e8tres 'value' # et 'shutdown_value' sont interpr\u00e9t\u00e9s pour les broches pwm. Si fourni, alors # le param\u00e8tre 'value' doit \u00eatre compris entre 0.0 et 'scale'. Cela peut \u00eatre utile # lors de la configuration d'une broche PWM contr\u00f4lant une r\u00e9f\u00e9rence de tension # d'un moteur pas \u00e0 pas. L''\u00e9chelle' peut \u00eatre d\u00e9finie sur l'intensit\u00e9 du moteur pas # \u00e0 pas \u00e9quivalent si le PWM \u00e9tait enti\u00e8rement activ\u00e9, et puis le param\u00e8tre 'value' # peut \u00eatre sp\u00e9cifi\u00e9 en utilisant l'intensit\u00e9 souhait\u00e9e pour le moteur pas \u00e0 pas. La # valeur par d\u00e9faut est de ne pas mettre \u00e0 l'\u00e9chelle le param\u00e8tre 'value'. [static_digital_output] \u00b6 Broches de sortie num\u00e9rique configur\u00e9es statiquement (on peut d\u00e9finir un nombre quelconque de sections avec un pr\u00e9fixe \"static_digital_output\"). Les broches configur\u00e9es ici seront configur\u00e9es comme une sortie GPIO pendant la configuration du MCU. Elles ne peuvent pas \u00eatre modifi\u00e9es en cours d'ex\u00e9cution. [static_digital_output my_output_pins] pins: # Une liste de broches s\u00e9par\u00e9es par des virgules \u00e0 d\u00e9finir comme broches de sortie GPIO. La broche # sera d\u00e9finie \u00e0 un niveau haut, sauf si le nom de la broche est pr\u00e9c\u00e9d\u00e9 de \"!\". # Ce param\u00e8tre doit \u00eatre fourni. [multi_pin] \u00b6 Sorties \u00e0 broches multiples (on peut d\u00e9finir un nombre quelconque de sections avec le pr\u00e9fixe \"multi_pin\"). Une sortie multi_pin cr\u00e9e un alias de broche interne pouvant modifier plusieurs broches de sortie chaque fois que la broche alias est d\u00e9finie. Par exemple, on peut d\u00e9finir un objet \"[multi_pin my_fan]\" contenant deux broches et ensuite d\u00e9finir \"pin=multi_pin:my_fan\" dans la section \"[fan]\" - \u00e0 chaque changement du ventilateur, les deux broches de sortie seront mises \u00e0 jour. Ces alias ne peuvent pas \u00eatre utilis\u00e9s avec des broches de moteur pas \u00e0 pas. [multi_pin my_multi_pin] pins: # Une liste s\u00e9par\u00e9e par des virgules des broches associ\u00e9es \u00e0 cet alias. Ce param\u00e8tre # doit \u00eatre fourni. Configuration des pilotes pas \u00e0 pas TMC \u00b6 Configuration des pilotes de moteurs pas \u00e0 pas Trinamic en mode UART/SPI. Des informations suppl\u00e9mentaires sont disponibles dans le guide des pilotes TMC et dans la r\u00e9f\u00e9rence des commandes . [tmc2130] \u00b6 Configuration d' un pilote de moteur pas \u00e0 pas TMC2130 via le bus SPI. Pour utiliser cette fonctionnalit\u00e9, d\u00e9finissez une section de configuration avec un pr\u00e9fixe \"tmc2130\" suivi du nom de la section de configuration du moteur pas \u00e0 pas correspondant (par exemple, \"[tmc2130 stepper_x]\"). [tmc2130 stepper_x] cs_pin: # The pin corresponding to the TMC2130 chip select line. This pin # will be set to low at the start of SPI messages and raised to high # after the message completes. This parameter must be provided. #spi_speed: #spi_bus: #spi_software_sclk_pin: #spi_software_mosi_pin: #spi_software_miso_pin: # See the \"common SPI settings\" section for a description of the # above parameters. #chain_position: #chain_length: # These parameters configure an SPI daisy chain. The two parameters # define the stepper position in the chain and the total chain length. # Position 1 corresponds to the stepper that connects to the MOSI signal. # The default is to not use an SPI daisy chain. #interpolate: True # If true, enable step interpolation (the driver will internally # step at a rate of 256 micro-steps). This interpolation does # introduce a small systemic positional deviation - see # TMC_Drivers.md for details. The default is True. run_current: # The amount of current (in amps RMS) to configure the driver to use # during stepper movement. This parameter must be provided. #hold_current: # The amount of current (in amps RMS) to configure the driver to use # when the stepper is not moving. Setting a hold_current is not # recommended (see TMC_Drivers.md for details). The default is to # not reduce the current. #sense_resistor: 0.110 # The resistance (in ohms) of the motor sense resistor. The default # is 0.110 ohms. #stealthchop_threshold: 0 # The velocity (in mm/s) to set the \"stealthChop\" threshold to. When # set, \"stealthChop\" mode will be enabled if the stepper motor # velocity is below this value. The default is 0, which disables # \"stealthChop\" mode. #driver_MSLUT0: 2863314260 #driver_MSLUT1: 1251300522 #driver_MSLUT2: 608774441 #driver_MSLUT3: 269500962 #driver_MSLUT4: 4227858431 #driver_MSLUT5: 3048961917 #driver_MSLUT6: 1227445590 #driver_MSLUT7: 4211234 #driver_W0: 2 #driver_W1: 1 #driver_W2: 1 #driver_W3: 1 #driver_X1: 128 #driver_X2: 255 #driver_X3: 255 #driver_START_SIN: 0 #driver_START_SIN90: 247 # These fields control the Microstep Table registers directly. The optimal # wave table is specific to each motor and might vary with current. An # optimal configuration will have minimal print artifacts caused by # non-linear stepper movement. The values specified above are the default # values used by the driver. The value must be specified as a decimal integer # (hex form is not supported). In order to compute the wave table fields, # see the tmc2130 \"Calculation Sheet\" from the Trinamic website. #driver_IHOLDDELAY: 8 #driver_TPOWERDOWN: 0 #driver_TBL: 1 #driver_TOFF: 4 #driver_HEND: 7 #driver_HSTRT: 0 #driver_PWM_AUTOSCALE: True #driver_PWM_FREQ: 1 #driver_PWM_GRAD: 4 #driver_PWM_AMPL: 128 #driver_SGT: 0 # Set the given register during the configuration of the TMC2130 # chip. This may be used to set custom motor parameters. The # defaults for each parameter are next to the parameter name in the # above list. #diag0_pin: #diag1_pin: # The micro-controller pin attached to one of the DIAG lines of the # TMC2130 chip. Only a single diag pin should be specified. The pin # is \"active low\" and is thus normally prefaced with \"^!\". Setting # this creates a \"tmc2130_stepper_x:virtual_endstop\" virtual pin # which may be used as the stepper's endstop_pin. Doing this enables # \"sensorless homing\". (Be sure to also set driver_SGT to an # appropriate sensitivity value.) The default is to not enable # sensorless homing. [tmc2208] \u00b6 Configuration d'un pilote de moteur pas \u00e0 pas TMC2208 (ou TMC2224) via un UART \u00e0 fil unique. Pour utiliser cette fonctionnalit\u00e9, d\u00e9finissez une section de configuration avec un pr\u00e9fixe \"tmc2208\" suivi du nom de la section de configuration du moteur pas \u00e0 pas correspondant (par exemple, \"[tmc2208 stepper_x]\"). [tmc2208 stepper_x] uart_pin: # La broche connect\u00e9e \u00e0 la ligne PDN_UART de la TMC2208. Ce param\u00e8tre # doit \u00eatre fourni. #tx_pin: # Si vous utilisez des lignes de r\u00e9ception et de transmission s\u00e9par\u00e9es pour communiquer # avec le pilote, r\u00e9glez uart_pin sur la broche de r\u00e9ception et tx_pin sur la broche # d'\u00e9mission. La valeur par d\u00e9faut est d'utiliser uart_pin pour la lecture et l'\u00e9criture. #select_pins: # Une liste de broches, s\u00e9par\u00e9es par des virgules, \u00e0 d\u00e9finir avant d'acc\u00e9der \u00e0 l'UART du # tmc2208. Ceci peut \u00eatre utile pour configurer un mux analogique pour la communication # UART. La valeur par d\u00e9faut est de ne pas configurer de broches. #interpolate: True # Si true, active l'interpolation de pas (le pilote fera un pas interne \u00e0 un taux de 256 # micro-pas). Cette interpolation introduit une petite d\u00e9viation syst\u00e9mique de la position - # voir TMC_Drivers.md pour plus de d\u00e9tails. La valeur par d\u00e9faut est True. run_current: # La quantit\u00e9 de courant (en amp\u00e8res RMS) \u00e0 configurer que le pilote doit utiliser # pendant le mouvement du pas. Ce param\u00e8tre doit \u00eatre fourni. #hold_current: # La quantit\u00e9 de courant (en amp\u00e8res RMS) \u00e0 configurer que le pilote doit utiliser quand # le moteur pas \u00e0 pas n'est pas en mouvement. La d\u00e9finition d'un hold_current n'est pas # recommand\u00e9e (voir TMC_Drivers.md pour plus de d\u00e9tails). La valeur par d\u00e9faut est de # ne pas r\u00e9duire le courant. #sense_resistor: 0.110 # La r\u00e9sistance (en ohms) de la r\u00e9sistance de d\u00e9tection du moteur (Vr\u00e9f). La valeur par # d\u00e9faut est de 0.110 ohms. #stealthchop_threshold: 0 # La vitesse (en mm/s) \u00e0 laquelle le seuil \"stealthChop\" doit \u00eatre fix\u00e9. Lorsque d\u00e9fini, # le mode \"stealthChop\" sera activ\u00e9 si la vitesse du moteur pas \u00e0 pas est inf\u00e9rieure \u00e0 # cette valeur. La valeur par d\u00e9faut est 0, ce qui d\u00e9sactive le mode \"stealthChop\". #driver_IHOLDDELAY: 8 #driver_TPOWERDOWN: 20 #driver_TBL: 2 #driver_TOFF: 3 #driver_HEND: 0 #driver_HSTRT: 5 #driver_PWM_AUTOGRAD: True #driver_PWM_AUTOSCALE: True #driver_PWM_LIM: 12 #driver_PWM_REG: 8 #driver_PWM_FREQ: 1 #driver_PWM_GRAD: 14 #driver_PWM_OFS: 36 # D\u00e9finissez le registre donn\u00e9 pendant la configuration de la puce TMC2208. Ceci peut \u00eatre # utilis\u00e9 pour d\u00e9finir les param\u00e8tres personnalis\u00e9s du moteur. Les valeurs par d\u00e9faut de # chaque param\u00e8tre sont indiqu\u00e9es \u00e0 c\u00f4t\u00e9 du nom du param\u00e8tre dans la liste ci-dessus. [tmc2209] \u00b6 Configuration d'un pilote de moteur pas \u00e0 pas TMC2209 via un UART \u00e0 fil unique. Pour utiliser cette fonctionnalit\u00e9, d\u00e9finissez une section de configuration avec un pr\u00e9fixe \"tmc2209\" suivi du nom de la section de configuration du moteur pas \u00e0 pas correspondant (par exemple, \"[tmc2209 stepper_x]\"). [tmc2209 stepper_x] uart_pin: #tx_pin #select_pins: #interpolate: True run_current: #hold_current: #sense_resistor: 0.110 #stealthchop_threshold: 0 # Voir la section \"tmc2208\" pour la d\u00e9finition de ces param\u00e8tres. #uart_address: # L'adresse de la puce TMC2209 pour les messages UART (un entier entre 0 et 3). # Ce param\u00e8tre est g\u00e9n\u00e9ralement utilis\u00e9 lorsque plusieurs puces TMC2209 sont # connect\u00e9es \u00e0 la m\u00eame broche UART. La valeur par d\u00e9faut est z\u00e9ro. #driver_IHOLDDELAY: 8 #driver_TPOWERDOWN: 20 #driver_TBL: 2 #driver_TOFF: 3 #driver_HEND: 0 #driver_HSTRT: 5 #driver_PWM_AUTOGRAD: True #driver_PWM_AUTOSCALE: True #driver_PWM_LIM: 12 #driver_PWM_REG: 8 #driver_PWM_FREQ: 1 #driver_PWM_GRAD: 14 #driver_PWM_OFS: 36 #driver_SGTHRS: 0 # D\u00e9finit le registre donn\u00e9 pendant la configuration de la puce TMC2209. Ceci peut \u00eatre # utilis\u00e9 pour d\u00e9finir les param\u00e8tres personnalis\u00e9s du moteur. Les valeurs par d\u00e9faut de # chaque param\u00e8tre sont indiqu\u00e9es \u00e0 c\u00f4t\u00e9 du nom du param\u00e8tre dans la liste ci-dessus. #diag_pin: # La broche du microcontr\u00f4leur reli\u00e9e \u00e0 la ligne DIAG de la puce TMC2209. La broche est # normalement pr\u00e9c\u00e9d\u00e9e de \"^\" pour activer un pullup. Le param\u00e9trage de cette broche # cr\u00e9e une broche virtuelle \"tmc2209_stepper_x:virtual_endstop\" pouvant \u00eatre utilis\u00e9e # comme broche d'arr\u00eat du moteur. Ainsi cela active le \"sensorless homing\". (Assurez- # vous de d\u00e9finir \u00e9galement driver_SGTHRS \u00e0 une valeur de sensibilit\u00e9 appropri\u00e9e). # La valeur par d\u00e9faut est de ne pas activer la recherche d'origine sans capteur. [tmc2660] \u00b6 Configuration d'un pilote de moteur pas \u00e0 pas TMC2660 via le bus SPI. Pour utiliser cette fonctionnalit\u00e9, d\u00e9finissez une section de configuration avec un pr\u00e9fixe \"tmc2660\" suivi du nom de la section de configuration du moteur pas \u00e0 pas correspondant (par exemple, \"[tmc2660 stepper_x]\"). [tmc2660 stepper_x] cs_pin: # La broche correspondant \u00e0 la ligne de s\u00e9lection de la puce TMC2660. Cette # broche sera mise \u00e0 l'\u00e9tat bas au d\u00e9but des messages SPI et passera \u00e0 l'\u00e9tat # haut apr\u00e8s la fin du transfert du message. Ce param\u00e8tre doit \u00eatre fourni. #spi_speed: 4000000 # Fr\u00e9quence du bus SPI utilis\u00e9e pour communiquer avec le pilote de pas \u00e0 pas # TMC2660. La valeur par d\u00e9faut est 4000000. #spi_bus: #spi_software_sclk_pin: #spi_software_mosi_pin: #spi_software_miso_pin: # Voir la section \"param\u00e8tres SPI communs\" pour une description des # param\u00e8tres ci-dessus. #interpolate: True # Si vrai, active l'interpolation par pas (le pilote fera un pas interne \u00e0 un taux # de 256 micro-pas). Cela ne fonctionne que si les micro-pas sont fix\u00e9s \u00e0 16. # L'interpolation introduit une petite d\u00e9viation de position syst\u00e9mique - voir # TMC_Drivers.md pour plus de d\u00e9tails. La valeur par d\u00e9faut est True. run_current: # La quantit\u00e9 de courant (en amp\u00e8res RMS) utilis\u00e9e par le pilote pendant le # d\u00e9placement du moteur pas \u00e0 pas. Ce param\u00e8tre doit \u00eatre fourni. #sense_resistor: # La r\u00e9sistance (en ohms) de la r\u00e9sistance de d\u00e9tection du moteur (Vr\u00e9f). Ce # param\u00e8tre doit \u00eatre fourni. #idle_current_percent 100 # Le pourcentage du courant de fonctionnement auquel le pilote pas \u00e0 pas # sera abaiss\u00e9 quand le d\u00e9lai d'inactivit\u00e9 expirera (vous devez configurer le # d\u00e9lai \u00e0 l'aide d'une section de configuration [idle_timeout]). Le courant sera # remont\u00e9 d\u00e8s que le moteur devra \u00e0 nouveau se d\u00e9placer. Assurez-vous de # d\u00e9finir une valeur suffisamment \u00e9lev\u00e9e pour que les moteurs ne perdent pas # leur position. Il y a \u00e9galement un petit d\u00e9lai avant que le courant ne soit remis, # il faut donc en tenir compte lors de demandes de mouvements rapides alors # que le pilote est inactif. La valeur par d\u00e9faut est 100 (aucune r\u00e9duction). #driver_TBL: 2 #driver_RNDTF: 0 #driver_HDEC: 0 #driver_CHM: 0 #driver_HEND: 3 #driver_HSTRT: 3 #driver_TOFF: 4 #driver_SEIMIN: 0 #driver_SEDN: 0 #driver_SEMAX: 0 #driver_SEUP: 0 #driver_SEMIN: 0 #driver_SFILT: 0 #driver_SGT: 0 #driver_SLPH: 0 #driver_SLPL: 0 #driver_DISS2G: 0 #driver_TS2G: 3 # D\u00e9finit les param\u00e8tres \u00e0 utiliser pendant la configuration de la puce TMC2660. # Ceci peut \u00eatre utilis\u00e9 pour d\u00e9finir des param\u00e8tres de pilote personnalis\u00e9s. Les # valeurs par d\u00e9faut de chaque param\u00e8tre sont indiqu\u00e9es \u00e0 c\u00f4t\u00e9 du nom du param\u00e8tre # dans la liste ci-dessus. Consultez la fiche technique du TMC2660 pour conna\u00eetre la # fonction de chaque param\u00e8tre ainsi que les restrictions sur les combinaisons de # param\u00e8tres. Soyez particuli\u00e8rement attentif au registre CHOPCONF, o\u00f9 le fait de # r\u00e9gler CHM \u00e0 soit z\u00e9ro, soit un, entra\u00eene des modifications de la disposition (le # premier bit de HDEC est interpr\u00e9t\u00e9 comme le MSB de HSTRT dans ce cas). [tmc5160] \u00b6 Configuration d'un pilote de moteur pas \u00e0 pas TMC5160 via le bus SPI. Pour utiliser cette fonctionnalit\u00e9, d\u00e9finissez une section de configuration avec un pr\u00e9fixe \"tmc5160\" suivi du nom de la section de configuration du moteur pas \u00e0 pas correspondant (par exemple, \"[tmc5160 stepper_x]\"). [tmc5160 stepper_x] cs_pin: # The pin corresponding to the TMC5160 chip select line. This pin # will be set to low at the start of SPI messages and raised to high # after the message completes. This parameter must be provided. #spi_speed: #spi_bus: #spi_software_sclk_pin: #spi_software_mosi_pin: #spi_software_miso_pin: # See the \"common SPI settings\" section for a description of the # above parameters. #chain_position: #chain_length: # These parameters configure an SPI daisy chain. The two parameters # define the stepper position in the chain and the total chain length. # Position 1 corresponds to the stepper that connects to the MOSI signal. # The default is to not use an SPI daisy chain. #interpolate: True # If true, enable step interpolation (the driver will internally # step at a rate of 256 micro-steps). The default is True. run_current: # The amount of current (in amps RMS) to configure the driver to use # during stepper movement. This parameter must be provided. #hold_current: # The amount of current (in amps RMS) to configure the driver to use # when the stepper is not moving. Setting a hold_current is not # recommended (see TMC_Drivers.md for details). The default is to # not reduce the current. #sense_resistor: 0.075 # The resistance (in ohms) of the motor sense resistor. The default # is 0.075 ohms. #stealthchop_threshold: 0 # The velocity (in mm/s) to set the \"stealthChop\" threshold to. When # set, \"stealthChop\" mode will be enabled if the stepper motor # velocity is below this value. The default is 0, which disables # \"stealthChop\" mode. #driver_MSLUT0: 2863314260 #driver_MSLUT1: 1251300522 #driver_MSLUT2: 608774441 #driver_MSLUT3: 269500962 #driver_MSLUT4: 4227858431 #driver_MSLUT5: 3048961917 #driver_MSLUT6: 1227445590 #driver_MSLUT7: 4211234 #driver_W0: 2 #driver_W1: 1 #driver_W2: 1 #driver_W3: 1 #driver_X1: 128 #driver_X2: 255 #driver_X3: 255 #driver_START_SIN: 0 #driver_START_SIN90: 247 # These fields control the Microstep Table registers directly. The optimal # wave table is specific to each motor and might vary with current. An # optimal configuration will have minimal print artifacts caused by # non-linear stepper movement. The values specified above are the default # values used by the driver. The value must be specified as a decimal integer # (hex form is not supported). In order to compute the wave table fields, # see the tmc2130 \"Calculation Sheet\" from the Trinamic website. #driver_IHOLDDELAY: 6 #driver_TPOWERDOWN: 10 #driver_TBL: 2 #driver_TOFF: 3 #driver_HEND: 2 #driver_HSTRT: 5 #driver_FD3: 0 #driver_TPFD: 4 #driver_CHM: 0 #driver_VHIGHFS: 0 #driver_VHIGHCHM: 0 #driver_DISS2G: 0 #driver_DISS2VS: 0 #driver_PWM_AUTOSCALE: True #driver_PWM_AUTOGRAD: True #driver_PWM_FREQ: 0 #driver_FREEWHEEL: 0 #driver_PWM_GRAD: 0 #driver_PWM_OFS: 30 #driver_PWM_REG: 4 #driver_PWM_LIM: 12 #driver_SGT: 0 #driver_SEMIN: 0 #driver_SEUP: 0 #driver_SEMAX: 0 #driver_SEDN: 0 #driver_SEIMIN: 0 #driver_SFILT: 0 # Set the given register during the configuration of the TMC5160 # chip. This may be used to set custom motor parameters. The # defaults for each parameter are next to the parameter name in the # above list. #diag0_pin: #diag1_pin: # The micro-controller pin attached to one of the DIAG lines of the # TMC5160 chip. Only a single diag pin should be specified. The pin # is \"active low\" and is thus normally prefaced with \"^!\". Setting # this creates a \"tmc5160_stepper_x:virtual_endstop\" virtual pin # which may be used as the stepper's endstop_pin. Doing this enables # \"sensorless homing\". (Be sure to also set driver_SGT to an # appropriate sensitivity value.) The default is to not enable # sensorless homing. Configuration du courant du moteur pas \u00e0 pas en temps r\u00e9el \u00b6 [ad5206] \u00b6 Digipots AD5206 configur\u00e9s statiquement et connect\u00e9s via un bus SPI (on peut d\u00e9finir un nombre quelconque de sections avec un pr\u00e9fixe \"ad5206\"). [ad5206 my_digipot] enable_pin: # La broche correspondant \u00e0 la ligne de s\u00e9lection de la puce AD5206. Cette broche # sera r\u00e9gl\u00e9e \u00e0 un niveau bas au d\u00e9but des messages SPI et sera relev\u00e9e \u00e0 un niveau \u00e9lev\u00e9 # apr\u00e8s la fin du message. Ce param\u00e8tre doit \u00eatre fourni. #spi_speed: #spi_bus: #spi_software_sclk_pin: #spi_software_mosi_pin: #spi_software_miso_pin: # Voir la section \"param\u00e8tres communs SPI\" pour une description des param\u00e8tres ci-dessus. # #channel_1: #channel_2: #channel_3: #channel_4: #channel_5: #channel_6: # La valeur pour d\u00e9finir statiquement le canal AD5206 donn\u00e9. Cette valeur est # g\u00e9n\u00e9ralement d\u00e9finie sur un nombre compris entre 0,0 et 1,0. 1,0 \u00e9tant la r\u00e9sistance # la plus \u00e9lev\u00e9e et 0,0 la r\u00e9sistance la plus faible. Cependant, la plage peut \u00eatre # modifi\u00e9e \u00e0 l'aide du param\u00e8tre 'scale' (voir ci-dessous). # Si un canal n'est pas sp\u00e9cifi\u00e9, il n'est pas configur\u00e9. # scale: # Ce param\u00e8tre peut \u00eatre utilis\u00e9 pour modifier l'interpr\u00e9tation des param\u00e8tres 'channel_x'. # S'il est fourni, alors les param\u00e8tres 'channel_x' doivent \u00eatre compris entre 0.0 et 'scale'. # Cela peut \u00eatre utile lorsque le AD5206 est utilis\u00e9 pour d\u00e9finir des r\u00e9f\u00e9rences de tension # pas \u00e0 pas. L''\u00e9chelle' peut \u00eatre r\u00e9gl\u00e9e sur l'intensit\u00e9 \u00e9quivalente de la commande pas \u00e0 pas # si l'AD5206 \u00e9tait \u00e0 sa r\u00e9sistance la plus \u00e9lev\u00e9e, puis les param\u00e8tres 'channel_x' peuvent \u00eatre # sp\u00e9cifi\u00e9s en utilisant la valeur d'intensit\u00e9 d\u00e9sir\u00e9e pour le pilote pas \u00e0 pas. La configuration # par d\u00e9faut est de ne pas mettre \u00e0 l'\u00e9chelle les param\u00e8tres 'channel_x'. [mcp4451] \u00b6 Digipot MCP4451 configur\u00e9 statiquement et connect\u00e9 via le bus I2C (on peut d\u00e9finir un nombre quelconque de sections avec un pr\u00e9fixe \"mcp4451\"). [mcp4451 mon_digipot] i2c_address: # L'adresse i2c que la puce utilise sur le bus i2c. Ce param\u00e8tre # doit \u00eatre fourni. #i2c_mcu: #i2c_bus: #i2c_speed: # Voir la section \"param\u00e8tres I2C communs\" pour une description des # param\u00e8tres ci-dessus. #wiper_0: #wiper_1: #wiper_2: #wiper_3: # La valeur pour d\u00e9finir statiquement le \"wiper\" MCP4451 donn\u00e9. Cette valeur est # g\u00e9n\u00e9ralement r\u00e9gl\u00e9e sur un nombre compris entre 0.0 et 1.0, 1.0 \u00e9tant la r\u00e9sistance # la plus \u00e9lev\u00e9e et 0.0 la r\u00e9sistance la plus faible. Cependant, la plage peut \u00eatre modifi\u00e9e # \u00e0 l'aide du param\u00e8tre 'scale' (voir ci-dessous). Si un wiper n'est pas sp\u00e9cifi\u00e9, il n'est # pas configur\u00e9. #scale: # Ce param\u00e8tre peut \u00eatre utilis\u00e9 pour modifier l'interpr\u00e9tation des param\u00e8tres 'wiper_x'. # S'il est fourni, alors les param\u00e8tres 'wiper_x' doivent \u00eatre compris entre 0,0 et 'scale'. # Ceci peut \u00eatre utile lorsque le MCP4451 est utilis\u00e9 pour d\u00e9finir des r\u00e9f\u00e9rences de tension # du pilote pas \u00e0 pas.L''\u00e9chelle' peut \u00eatre r\u00e9gl\u00e9e sur l'intensit\u00e9 du pilote pas \u00e0 pas \u00e9quivalent # si le MCP4451 \u00e9tait \u00e0 sa r\u00e9sistance la plus \u00e9lev\u00e9e, puis les param\u00e8tres 'wiper_x' peuvent # \u00eatre sp\u00e9cifi\u00e9s en utilisant la valeur d'intensit\u00e9 d\u00e9sir\u00e9e pour le pilote pas \u00e0 pas. La valeur # par d\u00e9faut est de ne pas mettre \u00e0 l'\u00e9chelle les param\u00e8tres 'wiper_x'. [mcp4728] \u00b6 Convertisseur num\u00e9rique-analogique MCP4728 configur\u00e9 statiquement et connect\u00e9 via le bus I2C (on peut d\u00e9finir un nombre quelconque de sections avec un pr\u00e9fixe \"mcp4728\"). [mcp4728 my_dac] #i2c_address: 96 # L'adresse i2c que la puce utilise sur le bus i2c. La valeur par d\u00e9faut # est 96. #i2c_mcu: #i2c_bus: #i2c_speed: # Voir la section \"param\u00e8tres I2C communs\" pour une description des # param\u00e8tres ci-dessus. #channel_a: #channel_b: #channel_c: #channel_d: # La valeur pour d\u00e9finir statiquement le canal MCP4728 donn\u00e9. Ceci est # g\u00e9n\u00e9ralement d\u00e9finie par un nombre compris entre 0.0 et 1.0, 1.0 repr\u00e9sentant # la tension la plus \u00e9lev\u00e9e (2.048V) et 0.0 la tension la plus basse. # Cependant, la plage peut \u00eatre modifi\u00e9e \u00e0 l'aide du param\u00e8tre 'scale' (cf. # ci-dessous). Si un canal n'est pas sp\u00e9cifi\u00e9, il n'est pas configur\u00e9. #scale: # Ce param\u00e8tre peut \u00eatre utilis\u00e9 pour modifier l'interpr\u00e9tation des param\u00e8tres 'channel_x'. # S'il est fourni, le param\u00e8tre 'channel_x' doit \u00eatre compris entre 0,0 et 'scale'. # Cela peut \u00eatre utile lorsque le MCP4728 est utilis\u00e9 pour d\u00e9finir des r\u00e9f\u00e9rences de tension # de moteur pas \u00e0 pas. L''\u00e9chelle' peut \u00eatre r\u00e9gl\u00e9e sur l'intensit\u00e9 \u00e9quivalente de la commande # de moteur pas \u00e0 pas si le MCP4728 \u00e9tait \u00e0 sa tension la plus \u00e9lev\u00e9e (2.048V), et ensuite les # param\u00e8tres 'channel_x' peuvent \u00eatre sp\u00e9cifi\u00e9s en utilisant l'intensit\u00e9 d\u00e9sir\u00e9e pour le # moteur pas \u00e0 pas. La valeur par d\u00e9faut est de ne pas mettre \u00e0 l'\u00e9chelle les # param\u00e8tres 'channel_x'. [mcp4018] \u00b6 Digipot MCP4018 configur\u00e9 statiquement et connect\u00e9 via deux broches gpio \"bit banging\" (on peut d\u00e9finir un nombre quelconque de sections avec un pr\u00e9fixe \"mcp4018\"). [mcp4018 my_digipot] scl_pin: # La broche d'horloge SCL. Ce param\u00e8tre doit \u00eatre fourni. sda_pin: # La broche de \"donn\u00e9es\" SDA. Ce param\u00e8tre doit \u00eatre fourni. wiper: # La valeur \u00e0 laquelle d\u00e9finir statiquement le \"wiper\" MCP4018 donn\u00e9. Ce param\u00e8tre est # g\u00e9n\u00e9ralement r\u00e9gl\u00e9e sur un nombre compris entre 0,0 et 1,0, 1,0 \u00e9tant la r\u00e9sistance # la plus \u00e9lev\u00e9e et 0.0 la r\u00e9sistance la plus faible. Cependant, la plage peut \u00eatre modifi\u00e9e \u00e0 # l'aide du param\u00e8tre 'scale' (voir ci-dessous). Ce param\u00e8tre doit \u00eatre fourni. #scale: # Ce param\u00e8tre peut \u00eatre utilis\u00e9 pour modifier l'interpr\u00e9tation du param\u00e8tre 'wiper'. # S'il est fourni, le param\u00e8tre 'wiper' doit se situer entre 0,0 et 'scale'. Ceci peut \u00eatre utile # lorsque le MCP4018 est utilis\u00e9 pour d\u00e9finir des r\u00e9f\u00e9rences de tension pas \u00e0 pas. # L''\u00e9chelle' peut \u00eatre r\u00e9gl\u00e9e sur l'intensit\u00e9 du pilote pas \u00e0 pas \u00e9quivalent si le MCP4018 # est \u00e0 sa plus grande# r\u00e9sistance la plus \u00e9lev\u00e9e, puis le param\u00e8tre 'wiper' peut \u00eatre sp\u00e9cifi\u00e9 # en utilisant la valeur d'intensit\u00e9 d\u00e9sir\u00e9e pour le pilote pas \u00e0 pas. La valeur par d\u00e9faut est # de ne pas mettre \u00e0 l'\u00e9chelle le param\u00e8tre 'wiper'. Prise en charge de l'affichage \u00b6 [display] \u00b6 Prise en charge d'un \u00e9cran reli\u00e9 au microcontr\u00f4leur. [display] lcd_type: # Le type de puce LCD utilis\u00e9. Cela peut \u00eatre \"hd44780\", \"hd44780_spi\", \"st7920\", # \"emulated_st7920\", \"uc1701\", \"ssd1306\", ou \"sh1106\". # Voir les sections d'affichage ci-dessous pour plus d'informations sur chaque type # et les param\u00e8tres suppl\u00e9mentaires qu'ils fournissent. Ce param\u00e8tre doit \u00eatre # fourni. #display_group: # Le nom du groupe de donn\u00e9es \u00e0 afficher sur l'\u00e9cran. Cela contr\u00f4le le contenu de # l'\u00e9cran (voir la section \"display_data\" pour plus d'informations). La valeur par # d\u00e9faut est _default_20x4 pour les \u00e9crans hd44780 et _default_16x4 pour les # autres affichages. #menu_timeout: # D\u00e9lai d'attente pour le menu. Le fait d'\u00eatre inactif pendant ce nombre de secondes # d\u00e9clenchera la sortie du menu ou le retour au menu racine si l'autorun est activ\u00e9. # La valeur par d\u00e9faut est 0 seconde (d\u00e9sactiv\u00e9) #menu_root: # Nom de la section du menu principal \u00e0 afficher lorsque vous cliquez sur l'encodeur # de l'\u00e9cran d'accueil. La valeur par d\u00e9faut est __main, et cela affiche les menus par # d\u00e9faut tels que d\u00e9finis dans klippy/extras/display/menu.cfg #menu_reverse_navigation: # Lorsque activ\u00e9, inverse les directions vers le haut et vers le bas de la liste. # La valeur par d\u00e9faut est False. Ce param\u00e8tre est optionnel. #encoder_pins: # Les broches connect\u00e9es \u00e0 l'encodeur. 2 broches doivent \u00eatre fournies lorsque vous # utilisez l'encodeur. Ce param\u00e8tre doit \u00eatre fourni lors de l'utilisation du menu. #encoder_steps_per_detent: # Combien de pas l'encodeur \u00e9met par cran (\"clic\"). Si l'encodeur prend deux crans pour # se d\u00e9placer entre les entr\u00e9es ou d\u00e9place deux entr\u00e9es \u00e0 partir d'un seul cran, essayez de # modifier cette valeur. Les valeurs autoris\u00e9es sont 2 (demi-step) ou 4 (full-step). # La valeur par d\u00e9faut est 4. #click_pin: # La broche connect\u00e9e au bouton 'entr\u00e9e' ou au 'clic' de l'encodeur. Ce param\u00e8tre doit # \u00eatre fourni lors de l'utilisation du menu. La pr\u00e9sence d'un param\u00e8tre de configuration # 'analog_range_click_pin' fait passer ce param\u00e8tre de num\u00e9rique \u00e0 analogique. #back_pin: # La broche connect\u00e9e au bouton 'retour'. Ce param\u00e8tre est facultatif, le menu peut \u00eatre utilis\u00e9 # sans lui. La pr\u00e9sence d'un param\u00e8tre de configuration 'analog_range_back_pin' transforme # ce param\u00e8tre de num\u00e9rique \u00e0 analogique. #up_pin: # La broche connect\u00e9e au bouton 'haut'. Ce param\u00e8tre doit \u00eatre fourni lorsque vous utilisez un # menu sans encodeur. La pr\u00e9sence d'un param\u00e8tre de configuration 'analog_range_up_pin' # transforme ce param\u00e8tre de num\u00e9rique \u00e0 analogique. #down_pin: # La broche connect\u00e9e au bouton 'bas'. Ce param\u00e8tre doit \u00eatre fourni lorsque vous utilisez un # menu sans encodeur. La pr\u00e9sence d'un param\u00e8tre de configuration 'analog_range_down_pin' # transforme ce param\u00e8tre de num\u00e9rique \u00e0 analogique. #kill_pin: # La broche connect\u00e9e au bouton 'kill'. Ce bouton appellera l'arr\u00eat d'urgence. La pr\u00e9sence d'un # param\u00e8tre 'analog_range_kill_pin' fait passer ce param\u00e8tre de num\u00e9rique \u00e0 analogique. #analog_pullup_resistor: 4700 # La r\u00e9sistance (en ohms) du pullup attach\u00e9 au bouton analogique. # La valeur par d\u00e9faut est de 4700 ohms. #analog_range_click_pin: # La plage de r\u00e9sistances du bouton 'entr\u00e9e'. Les valeurs minimale et maximale de la plage # s\u00e9par\u00e9es par des virgules doivent \u00eatre fournies lors de l'utilisation du bouton analogique. #analog_range_back_pin: # La plage de r\u00e9sistances du bouton 'retour'. Les valeurs minimale et maximale de la plage # s\u00e9par\u00e9es par des virgules doivent \u00eatre fournies lors de l'utilisation du bouton analogique. #analog_range_up_pin: # La plage de r\u00e9sistances du bouton 'haut'. Les valeurs minimale et maximale de la plage # s\u00e9par\u00e9es par des virgules doivent \u00eatre fournies lors de l'utilisation du bouton analogique. #analog_range_down_pin: # La plage de r\u00e9sistances du bouton 'bas'. Les valeurs minimale et maximale de la plage # s\u00e9par\u00e9es par des virgules doivent \u00eatre fournies lors de l'utilisation du bouton analogique. #analog_range_kill_pin: # La plage de r\u00e9sistances du bouton 'kill'. Les valeurs minimale et maximale de la plage # s\u00e9par\u00e9es par des virgules doivent \u00eatre fournies lors de l'utilisation du bouton analogique. \u00e9cran hd44780 \u00b6 Informations de configuration des \u00e9crans hd44780 (utilis\u00e9s dans les \u00e9crans de type \"RepRapDiscount 2004 Smart Controller\"). [display] lcd_type: hd44780 # D\u00e9finir \u00e0 \"hd44780\" pour les \u00e9crans hd44780. rs_pin: e_pin: d4_pin: d5_pin: d6_pin: d7_pin: # Broches connect\u00e9es \u00e0 un lcd de type hd44780. Ces param\u00e8tres doivent # \u00eatre fournis. #hd44780_protocol_init: True # Effectuer l'initialisation du protocole 8-bit/4-bit sur un \u00e9cran hd44780. # Ceci est n\u00e9cessaire sur les vrais dispositifs hd44780. Cependant, on peut avoir besoin # de le d\u00e9sactiver avec certains p\u00e9riph\u00e9riques \"clones\". La valeur par d\u00e9faut est True. #line_length: # D\u00e9finit le nombre de caract\u00e8res par ligne pour un lcd de type hd44780. # Les valeurs possibles sont 20 (par d\u00e9faut) et 16. Le nombre de lignes est # fix\u00e9 \u00e0 4. ... \u00e9cran hd44780_spi \u00b6 Informations de configuration d'un \u00e9cran hd44780_spi - un \u00e9cran 20x04 contr\u00f4l\u00e9 par un \"registre \u00e0 d\u00e9calage (shift register)\" mat\u00e9riel (utilis\u00e9 dans les imprimantes bas\u00e9es sur mightyboard). [display] lcd_type: hd44780_spi # D\u00e9finir \u00e0 \"hd44780_spi\" pour les \u00e9crans hd44780_spi. latch_pin: spi_software_sclk_pin: spi_software_mosi_pin: spi_software_miso_pin: # Broches connect\u00e9es au registre \u00e0 d\u00e9calage contr\u00f4lant l'affichage. # La broche spi_software_miso_pin doit \u00eatre d\u00e9finie sur une broche inutilis\u00e9e # de la carte m\u00e8re de l'imprimante, car le registre \u00e0 d\u00e9calage contr\u00f4lant l'affichage # n'a pas de broche MISO, mais l'impl\u00e9mentation logicielle de spi n\u00e9cessite que # cette broche soit configur\u00e9e. #hd44780_protocol_init: True # Effectue l'initialisation du protocole 8-bit/4-bit sur un \u00e9cran hd44780. # Ceci est n\u00e9cessaire sur les vrais dispositifs hd44780. Cependant, on peut avoir besoin # de le d\u00e9sactiver avec certains p\u00e9riph\u00e9riques \"clones\". La valeur par d\u00e9faut est True. #line_length: # D\u00e9finit le nombre de caract\u00e8res par ligne pour un lcd de type hd44780. # Les valeurs possibles sont 20 (par d\u00e9faut) et 16. Le nombre de lignes est # fix\u00e9 \u00e0 4. ... \u00e9cran st7920 \u00b6 Informations de configuration des \u00e9crans st7920 (utilis\u00e9s dans les \u00e9crans de type \"RepRapDiscount 12864 Full Graphic Smart Controller\"). [display] lcd_type: st7920 # D\u00e9finir \u00e0 \"st7920\" pour les \u00e9crans st7920. cs_pin: sclk_pin: sid_pin: # Les broches connect\u00e9es \u00e0 un lcd de type st7920. Ces param\u00e8tres doivent \u00eatre # fournis. ... \u00e9cran emulated_st7920 \u00b6 Informations de configuration d'un \u00e9cran st7920 \u00e9mul\u00e9 - que l'on trouve dans certains \"\u00e9crans tactiles de 2,4 pouces\" et similaires. [display] lcd_type: emulated_st7920 # D\u00e9finir \u00e0 \"emulated_st7920\" pour les \u00e9crans emulated_st7920. en_pin: spi_software_sclk_pin: spi_software_mosi_pin: spi_software_miso_pin: # Les broches connect\u00e9es \u00e0 un lcd de type emulated_st7920. L'en_pin # correspond \u00e0 la cs_pin du lcd de type st7920, # spi_software_sclk_pin correspond \u00e0 sclk_pin et # spi_software_mosi_pin correspond \u00e0 sid_pin. La broche # spi_software_miso_pin doit \u00eatre r\u00e9gl\u00e9e sur une broche non utilis\u00e9e de la carte # m\u00e8re de l'imprimante car le st7920 n'a pas de broche MISO mais l'impl\u00e9mentation # logicielle spi n\u00e9cessite que cette broche soit configur\u00e9e. ... \u00e9cran uc1701 \u00b6 Informations de configuration des \u00e9crans uc1701 (utilis\u00e9s dans les \u00e9crans de type \"MKS Mini 12864\"). [display] lcd_type: uc1701 # D\u00e9finir \u00e0 \"uc1701\" pour les \u00e9crans uc1701. cs_pin: a0_pin: # Les broches connect\u00e9es \u00e0 un lcd de type uc1701. Ces param\u00e8tres doivent \u00eatre # fournis. #rst_pin: # La broche connect\u00e9e \u00e0 la broche \"rst\" du lcd. Si elle n'est pas sp\u00e9cifi\u00e9e, # le mat\u00e9riel doit avoir un pull-up sur la ligne lcd correspondante. #contrast: # Le contraste \u00e0 d\u00e9finir. La valeur peut aller de 0 \u00e0 63 , la valeur par # d\u00e9faut est 40. ... \u00e9crans ssd1306 et sh1106 \u00b6 Les informations de configuration des \u00e9crans ssd1306 et sh1106. [display] lcd_type: # D\u00e9finir \u00e0 \"ssd1306\" ou \"sh1106\" pour le type d'affichage donn\u00e9. #i2c_mcu: #i2c_bus: #i2c_speed: # Param\u00e8tres optionnels disponibles pour des \u00e9crans connect\u00e9s via un bus i2c. # Voir la section \"Param\u00e8tres I2C communs\" pour une description des # param\u00e8tres ci-dessus. #cs_pin: #dc_pin: #spi_speed: #spi_bus: #spi_software_sclk_pin: #spi_software_mosi_pin: #spi_software_miso_pin: # Les broches connect\u00e9es au lcd en mode spi \"4-wire\". Voir la section # \"param\u00e8tres SPI communs\" pour une description des param\u00e8tres # commen\u00e7ant par \"spi_\". Le d\u00e9faut est d'utiliser le mode i2c pour l'\u00e9cran # d'affichage. #reset_pin: # Une broche de r\u00e9initialisation peut \u00eatre sp\u00e9cifi\u00e9e sur l'affichage. Si elle # n'est pas sp\u00e9cifi\u00e9e, le mat\u00e9riel doit avoir un pull-up sur la ligne # lcd correspondante. #contrast: # Le contraste \u00e0 d\u00e9finir. La valeur peut aller de 0 \u00e0 256 , la valeur par # d\u00e9faut est 239. #vcomh: 0 # D\u00e9finit la valeur Vcomh sur l'\u00e9cran. Cette valeur est associ\u00e9e \u00e0 un effet # de \"bavure\" sur certains \u00e9crans OLED. La valeur peut \u00eatre comprise # de 0 \u00e0 63. La valeur par d\u00e9faut est 0. #invert: False # TRUE inverse les pixels sur certains \u00e9crans OLED. La valeur par d\u00e9faut est # False. #x_offset: 0 # D\u00e9finit la valeur du d\u00e9calage horizontal sur les \u00e9crans SH1106. La valeur par # d\u00e9faut est 0. ... [display_data] \u00b6 Support pour l'affichage de donn\u00e9es personnalis\u00e9es sur un \u00e9cran lcd. On peut cr\u00e9er un nombre quelconque de groupes d'affichage et un nombre quelconque d'\u00e9l\u00e9ments de donn\u00e9es sous ces groupes. L'\u00e9cran affichera tous les \u00e9l\u00e9ments de donn\u00e9es d'un groupe donn\u00e9 si l'option display_group de la section [display] est d\u00e9finie sur le nom du groupe en question. Un ensemble par d\u00e9faut de groupes d'affichage est automatiquement cr\u00e9\u00e9. On peut remplacer ou \u00e9tendre ces \u00e9l\u00e9ments display_data en rempla\u00e7ant les valeurs par d\u00e9faut dans le fichier de configuration principal printer.cfg. [display_data my_group_name my_data_name] position: # Ligne et colonne s\u00e9par\u00e9es par des virgules de la position de l'affichage \u00e0 # utiliser pour afficher l'information. Ce param\u00e8tre doit \u00eatre fourni. text: # Le texte \u00e0 afficher \u00e0 la position donn\u00e9e. Ce champ est \u00e9valu\u00e9 en utilisant les # mod\u00e8les de commande (voir docs/Command_Templates.md). # Ce param\u00e8tre doit \u00eatre fourni. [display_template] \u00b6 Les \"macros\" de texte des donn\u00e9es d'affichage (on peut d\u00e9finir un nombre quelconque de sections avec un pr\u00e9fixe display_template). Voir le document mod\u00e8les de commande pour des informations sur l'\u00e9valuation des mod\u00e8les. Cette fonctionnalit\u00e9 permet de r\u00e9duire les d\u00e9finitions r\u00e9p\u00e9titives dans les sections display_data. On peut utiliser la fonction int\u00e9gr\u00e9e render() dans les sections display_data pour \u00e9valuer un mod\u00e8le. Par exemple, si l'on d\u00e9finit \"[display_template my_template] \", on peut alors utiliser \"{ render('my_template') } dans une section display_data. Cette fonctionnalit\u00e9 peut \u00e9galement \u00eatre utilis\u00e9e pour des mises \u00e0 jour continues des LEDs \u00e0 l'aide de la commande SET_LED_TEMPLATE . [display_template my_template_name] #param_<name>: # On peut sp\u00e9cifier un nombre quelconque d'options avec le pr\u00e9fixe \"param_\". Le nom # donn\u00e9 se verra attribuer la valeur donn\u00e9e (analys\u00e9e comme un litt\u00e9ral Python) et # sera disponible pendant l'expansion de la macro. Si le param\u00e8tre est pass\u00e9 dans # l'appel \u00e0 render(), alors cette valeur sera utilis\u00e9e pendant l'expansion de la macro. # Par exemple, une configuration avec \"param_speed = 75\" pourrait avoir un appelant # avec \"render('my_template_name', param_speed=80)\". Les noms de param\u00e8tres # peuvent ne pas utiliser de caract\u00e8res majuscules. text: # Le texte \u00e0 renvoyer lors du rendu de ce mod\u00e8le. Ce champ est \u00e9valu\u00e9 \u00e0 l'aide de # mod\u00e8les de commande (voir docs/Command_Templates.md). # Ce param\u00e8tre doit \u00eatre fourni. [display_glyph] \u00b6 Affiche un glyphe personnalis\u00e9 sur les \u00e9crans le supportant. Le nom donn\u00e9 se verra attribu\u00e9 les donn\u00e9es d'affichage, donn\u00e9es qui pourront ensuite \u00eatre r\u00e9f\u00e9renc\u00e9es dans les mod\u00e8les d'affichage par leur nom entour\u00e9 de deux symboles \"tilde\", par exemple ~my_display_glyph~ Voir sample-glyphs.cfg pour quelques exemples. [display_glyph my_display_glyph] #data: # Les donn\u00e9es d'affichage, stock\u00e9es sous forme de 16 lignes compos\u00e9es de 16 bits (1 par # pixel) o\u00f9 '.' est un pixel vide et '*' est un pixel actif (par ex, \"****************\" pour afficher # une ligne horizontale pleine). # On peut \u00e9galement utiliser '0' pour un pixel vide et '1' pour un pixel actif. # Placez chaque ligne d'affichage sur une ligne de configuration distincte. Le glyphe doit \u00eatre # compos\u00e9 d'exactement 16 lignes de 16 bits chacune. Ce param\u00e8tre est facultatif. #hd44780_data: # Glyphe \u00e0 utiliser sur les \u00e9crans 20x4 hd44780. Le glyphe doit \u00eatre compos\u00e9 d'exactement # 8 lignes de 5 bits chacune. Ce param\u00e8tre est facultatif. #hd44780_slot: # L'index mat\u00e9riel hd44780 (0..7) pour stocker le glyphe. Si plusieurs images distinctes # utilisent le m\u00eame slot, assurez-vous de n'utiliser qu'une seule de ces images dans un # \u00e9cran donn\u00e9. Ce param\u00e8tre est requis si hd44780_data est sp\u00e9cifi\u00e9. [display my_extra_display] \u00b6 Si une section principale [display] a \u00e9t\u00e9 d\u00e9finie dans printer.cfg comme indiqu\u00e9 ci-dessus, il est possible de d\u00e9finir plusieurs affichages auxiliaires. Notez que les affichages auxiliaires ne supportent pas actuellement la fonctionnalit\u00e9 de menus, ils ne supportent donc pas les options \"menu\" ou la configuration de boutons. [display my_extra_display] # Voir la section \"affichage\" (display) pour les param\u00e8tres disponibles. [menu] \u00b6 Menus de l'\u00e9cran LCD personnalisables. Un ensemble de menus par d\u00e9faut est automatiquement cr\u00e9\u00e9. On peut remplacer ou \u00e9tendre le menu en rempla\u00e7ant les valeurs par d\u00e9faut dans le fichier de configuration principal printer.cfg. Consultez le document sur les mod\u00e8les de commande pour obtenir des informations sur les attributs de menu disponibles lors du rendu du mod\u00e8le. # Param\u00e8tres communs disponibles pour toutes les sections de configuration de menu. #[menu __some_list __some_name] #type: disabled # \u00c9l\u00e9ment de menu d\u00e9sactiv\u00e9 de fa\u00e7on permanente, le seul attribut requis est 'type'. # Vous permet de d\u00e9sactiver/masquer facilement des \u00e9l\u00e9ments de menu existants. #[menu some_name] #type: # Un \u00e9l\u00e9ment parmi command, input, list, text : # command - \u00e9l\u00e9ment de menu de base avec divers d\u00e9clencheurs de script. # input - m\u00eame chose que 'command' mais avec des capacit\u00e9s de changement de valeur. # Pressez pour d\u00e9marrer/arr\u00eater le mode d'\u00e9dition. # list - permet de regrouper les \u00e9l\u00e9ments du menu dans une liste d\u00e9roulante. # Ajoutez \u00e0 la liste en cr\u00e9ant des configurations de menu en utilisant # \"some_list\" comme pr\u00e9fixe - par exemple : # [menu some_list some_item_in_the_list]. # vsdlist - identique \u00e0 'list' mais ajoutera les fichiers de la carte SD virtuelle # (sera supprim\u00e9 dans le futur) #name: # Nom de l'\u00e9l\u00e9ment de menu - \u00e9valu\u00e9 comme un mod\u00e8le. #enable: # Mod\u00e8le \u00e9valu\u00e9 \u00e0 True ou False. #index: # Position o\u00f9 l'\u00e9l\u00e9ment doit \u00eatre ins\u00e9r\u00e9 dans la liste. Par d\u00e9faut # l'\u00e9l\u00e9ment est ajout\u00e9 \u00e0 la fin. #[menu some_list] #type: list #name: #enable: # Voir ci-dessus pour une description de ces param\u00e8tres. #[menu some_list some_command] #type: command #name: #enable: # Voir ci-dessus pour une description de ces param\u00e8tres. #gcode: # Script \u00e0 ex\u00e9cuter lors d'un clic sur un bouton ou un clic long. \u00c9valu\u00e9 comme un # mod\u00e8le. #[menu some_list some_input] #type: input #name: #enable: # Voir ci-dessus pour une description de ces param\u00e8tres. #input: # Valeur initiale \u00e0 utiliser lors de l'\u00e9dition - \u00e9valu\u00e9e comme un mod\u00e8le. # Le r\u00e9sultat doit \u00eatre de type flottant. #input_min: # Valeur minimale de l''intervalle - \u00e9valu\u00e9e comme un mod\u00e8le. Par d\u00e9faut -99999. #input_max: # Valeur maximale de l'intervalle - \u00e9valu\u00e9e comme un mod\u00e8le. Par d\u00e9faut 99999. #input_step: # Pas d'\u00e9dition - Doit \u00eatre un nombre entier positif ou une valeur flottante. Poss\u00e8de # un pas de vitesse rapide interne. Lorsque \"(input_max - input_min) / input_step > 100\" # alors le pas de vitesse rapide est 10 * input_step sinon le pas de vitesse rapide # est le m\u00eame que celui de l'input_step. #realtime: # Cet attribut accepte une valeur bool\u00e9enne statique. Lorsqu'il est activ\u00e9, alors le script # gcode est ex\u00e9cut\u00e9 apr\u00e8s chaque changement de valeur. La valeur par d\u00e9faut est False. #gcode: # Script \u00e0 ex\u00e9cuter lors d'un clic sur un bouton, d'un clic long ou d'un changement de valeur. # \u00c9valu\u00e9 comme un mod\u00e8le. Le clic sur le bouton d\u00e9clenchera le d\u00e9but ou fin du mode d'\u00e9dition. Capteurs de filaments \u00b6 [filament_switch_sensor] \u00b6 Capteur de commutation de filament. Prise en charge de la d\u00e9tection de l'insertion et du d\u00e9placement du filament \u00e0 l'aide d'un capteur de commutation, tel qu'un interrupteur de fin de course. Voir la r\u00e9f\u00e9rence des commandes pour plus d'informations. [filament_switch_sensor my_sensor] #pause_on_runout: True # Lorsque d\u00e9fini sur True, une PAUSE sera ex\u00e9cut\u00e9e imm\u00e9diatement apr\u00e8s qu'un runout # soit d\u00e9tect\u00e9. Notez que si pause_on_runout est False et que le runout_gcode est omis, # la d\u00e9tection du runout est d\u00e9sactiv\u00e9e. Par d\u00e9faut, est True. #runout_gcode: # Une liste de commandes G-Code \u00e0 ex\u00e9cuter apr\u00e8s la d\u00e9tection d'une fin de filament. # Voir docs/Command_Templates.md pour le format G-Code. Si pause_on_runout est # r\u00e9gl\u00e9 sur True, ce G-code sera ex\u00e9cut\u00e9 apr\u00e8s la fin de la PAUSE. Par d\u00e9faut, aucune # commande G-Code n'est ex\u00e9cut\u00e9e. #insert_gcode: # Une liste de commandes G-Code \u00e0 ex\u00e9cuter apr\u00e8s qu'une insertion de filament soit d\u00e9tect\u00e9e. # Voir docs/Command_Templates.md pour le format G-Code. La valeur par d\u00e9faut est de # n'ex\u00e9cuter aucune commande G-Code, ce qui d\u00e9sactive la d\u00e9tection de l'insertion. #event_delay 3.0 # La dur\u00e9e minimale en secondes \u00e0 attendre entre les \u00e9v\u00e9nements. # Des \u00e9v\u00e9nements d\u00e9clench\u00e9s durant cette p\u00e9riode seront silencieusement ignor\u00e9s. # La valeur par d\u00e9faut est de 3 secondes. #pause_delay: 0.5 # Le d\u00e9lai, en secondes, entre l'envoi de la commande de pause et l'ex\u00e9cution du runout_gcode. # Il peut \u00eatre utile d'augmenter ce d\u00e9lai si OctoPrint pr\u00e9sente un comportement \u00e9trange lors de # la pause. La valeur par d\u00e9faut est 0.5 secondes. #switch_pin: # La broche sur laquelle l'interrupteur est connect\u00e9. # Ce param\u00e8tre doit \u00eatre fourni. [filament_motion_sensor] \u00b6 Capteur de mouvement de filament. Prise en charge de la d\u00e9tection de pr\u00e9sence et d\u00e9placement du filament \u00e0 l'aide d'un encodeur basculant la broche de sortie pendant le mouvement du filament dans le capteur. Voir la r\u00e9f\u00e9rence des commandes pour plus d'informations. [filament_motion_sensor my_sensor] detection_length: 7.0 # La longueur minimale du filament tir\u00e9 \u00e0 travers le capteur d\u00e9clenchant # un changement d'\u00e9tat sur la broche de commutation. # La valeur par d\u00e9faut est 7 mm. extruder: # Le nom de la section de l'extrudeuse \u00e0 laquelle ce capteur est associ\u00e9. # Ce param\u00e8tre doit \u00eatre fourni. switch_pin: #pause_on_runout: #runout_gcode: #insert_gcode: #event_delay: #pause_delay: # Voir la section \"filament_switch_sensor\" pour une description des # param\u00e8tres ci-dessus. [tsl1401cl_filament_width_sensor] \u00b6 Capteur de largeur de filament bas\u00e9 sur le TSLl401CL. Voir ce guide pour plus d'informations. [tsl1401cl_filament_width_sensor] #pin: #default_nominal_filament_diameter: 1.75 # (mm) # Diff\u00e9rence maximale de diam\u00e8tre de filament autoris\u00e9e en mm. #max_diff\u00e9rence: 0.2 # La distance entre le capteur et la chambre de fusion en mm. #measurement_delay: 100 [hall_filament_width_sensor] \u00b6 Capteur Hall de largeur de filament (voir Capteur Hall de largeur de filament ). [hall_filament_width_sensor] adc1: adc2: # Broches d'entr\u00e9e analogiques connect\u00e9es au capteur. Ces param\u00e8tres doivent # \u00eatre fournis. #cal_dia1: 1.50 #cal_dia2: 2.00 # Les valeurs d'\u00e9talonnage (en mm) pour les capteurs. La valeur par d\u00e9faut est # 1,50 pour cal_dia1 et 2,00 pour cal_dia2. #raw_dia1: 9500 #raw_dia2: 10500 # Les valeurs brutes d'\u00e9talonnage des capteurs. La valeur par d\u00e9faut est 9500 # pour raw_dia1 et 10500 pour raw_dia2. #default_nominal_filament_diameter: 1.75 # Le diam\u00e8tre nominal du filament. Ce param\u00e8tre doit \u00eatre fourni. #max_difference: 0.200 # Diff\u00e9rence maximale autoris\u00e9e de diam\u00e8tre du filament en millim\u00e8tres (mm). # Si la diff\u00e9rence entre le diam\u00e8tre nominal du filament et la sortie du capteur # est sup\u00e9rieure \u00e0 +- max_difference, le multiplicateur d'extrusion est ramen\u00e9 \u00e0 # \u00e0 %100. La valeur par d\u00e9faut est de 0,200. #measurement_delay: 70 # La distance entre le capteur et la chambre de fusion/la buse en # millim\u00e8tres (mm). Le filament situ\u00e9 entre le capteur et la buse # sera trait\u00e9 comme le default_nominal_filament_diameter. # Ce module h\u00f4te fonctionne avec une logique FIFO. Il conserve chaque valeur # de capteur dans un tableau et les remet (POP) dans la bonne position. Ce # param\u00e8tre doit \u00eatre fourni. #enable: False # Capteur activ\u00e9 ou d\u00e9sactiv\u00e9 apr\u00e8s la mise sous tension. La valeur par d\u00e9faut est # d\u00e9sactiv\u00e9. #measurement_interval: 10 # La distance approximative (en mm) entre les lectures du capteur. La valeur # par d\u00e9faut est de 10mm. #logging: False # Le diam\u00e8tre de sortie vers le terminal et vers klipper.log peut \u00eatre activ\u00e9 par # ce param\u00e8tre. #min_diameter: 1.0 # Diam\u00e8tre minimal pour d\u00e9clencher le capteur virtuel filament_switch_sensor. #use_current_dia_while_delay: False # Utiliser le diam\u00e8tre actuel au lieu du diam\u00e8tre nominal pendant que le d\u00e9lai # de mesure n'est pas \u00e9coul\u00e9. #pause_on_runout: #runout_gcode: #insert_gcode: #event_delay: #pause_delay: # Voir la section \"filament_switch_sensor\" pour une description des # param\u00e8tres ci-dessus. Support mat\u00e9riel sp\u00e9cifique \u00e0 une carte \u00b6 [sx1509] \u00b6 Configuration d'un expandeur SX1509 I2C vers GPIO. En raison du d\u00e9lai encouru par la communication I2C, vous ne devez PAS utiliser les broches du SX1509 comme activation du moteur pas \u00e0 pas, pas ou direction ou toute autre broche n\u00e9cessitant un changement de bit rapide. Il est pr\u00e9f\u00e9rable de les utiliser comme sorties num\u00e9riques statiques ou contr\u00f4l\u00e9es par gcode ou comme broches hardware-pwm pour des ventilateurs par exemple. On peut d\u00e9finir un nombre quelconque de sections avec un pr\u00e9fixe \"sx1509\". Chaque expandeur fournit un ensemble de 16 broches (sx1509_my_sx1509:PIN_0 \u00e0 sx1509_my_sx1509:PIN_15) pouvant \u00eatre utilis\u00e9es dans la configuration de l'imprimante. Voir le fichier generic-duet2-duex.cfg pour un exemple. [sx1509 my_sx1509] i2c_address: # Adresse I2C utilis\u00e9e par cet expandeur. Selon le mat\u00e9riel # il s'agit de l'une des adresses suivantes : 62 63 112 113. # Ce param\u00e8tre doit \u00eatre fourni. #i2c_mcu: #i2c_bus: #i2c_speed: # Voir la section \"param\u00e8tres I2C communs\" pour une description des # param\u00e8tres ci-dessus. #i2c_bus: # Si l'impl\u00e9mentation I2C de votre micro-contr\u00f4leur prend en charge # plusieurs bus I2C, vous pouvez sp\u00e9cifier le nom du bus ici. La valeur # par d\u00e9faut est d'utiliser le bus i2c par d\u00e9faut du micro-contr\u00f4leur. [samd_sercom] \u00b6 Configuration de SAMD SERCOM pour indiquer les broches \u00e0 utiliser sur un mat\u00e9riel SERCOM. On peut d\u00e9finir un nombre quelconque de sections avec le pr\u00e9fixe \"samd_sercom\". Chaque SERCOM doit \u00eatre configur\u00e9 avant de pouvoir \u00eatre utilis\u00e9 comme p\u00e9riph\u00e9rique SPI ou I2C. Placez cette section de configuration au-dessus de toute autre section qui utilise les bus SPI ou I2C. [samd_sercom my_sercom] sercom: # Le nom du bus sercom \u00e0 configurer dans le micro-contr\u00f4leur. # Les noms disponibles sont \"sercom0\", \"sercom1\", etc. # Ce param\u00e8tredoit \u00eatre fourni. tx_pin: # Broche MOSI pour la communication SPI, ou broche SDA (donn\u00e9es) pour la communication I2C. # La broche doit avoir une configuration pinmux valide pour le p\u00e9riph\u00e9rique SERCOM donn\u00e9. # Ce param\u00e8tre doit \u00eatre fourni. #rx_pin: # Broche MISO pour la communication SPI. Cette broche n'est pas utilis\u00e9e pour la communication I2C # (I2C utilise tx_pin pour l'envoi et la r\u00e9ception). # La broche doit avoir une configuration pinmux valide pour le p\u00e9riph\u00e9rique SERCOM donn\u00e9. # Ce param\u00e8tre est optionnel. clk_pin: # La broche CLK pour la communication SPI, ou la broche SCL (horloge) pour la communication I2C. # La broche doit avoir une configuration pinmux valide pour le p\u00e9riph\u00e9rique SERCOM donn\u00e9. # Ce param\u00e8tre doit \u00eatre fourni [adc_scaled] \u00b6 Mise \u00e0 l'\u00e9chelle analogique du Duet2 Maestro par lectures vref et vssa. D\u00e9finir une section adc_scaled permet d'activer des broches adc virtuelles (telles que \"my_name:PB0\") qui seront automatiquement ajust\u00e9es par les broches de surveillance vref et vssa de la carte. Assurez-vous de d\u00e9finir cette section de configuration au-dessus de toute section de configuration utilisant l'une de ces broches virtuelles. Voir le fichier generic-duet2-maestro.cfg pour un exemple. [adc_scaled my_name] vref_pin : # La broche ADC \u00e0 utiliser pour le contr\u00f4le de VREF. Ce param\u00e8tre doit \u00eatre # fourni. vssa_pin : # La broche ADC \u00e0 utiliser pour la surveillance VSSA. Ce param\u00e8tre doit \u00eatre # fourni. #smooth_time : 2.0 # Une dur\u00e9e (en secondes) durant laquelle les mesures de vref et vssa # seront liss\u00e9es pour r\u00e9duire l'impact du bruit des mesures. # La valeur par d\u00e9faut est de 2 secondes. [replicape] \u00b6 Support de Replicape - voir le guide beaglebone et le fichier generic-replicape.cfg pour un exemple. # La section de configuration \"replicape\" ajoute \"replicape:stepper_x_enable\" pour # l'activation de broches virtuelles de moteur (pour les moteurs X, Y, Z, E et H) et # \"replicape:power_x\" des broches de sortie PWM (pour les pilotes, e, h, fan0, fan1, # fan2, et fan3) utilisables ailleurs dans le fichier de configuration. [replicape] revision: # La r\u00e9vision du mat\u00e9riel replicape. Actuellement, seule la r\u00e9vision \"B3\" est # support\u00e9e. Ce param\u00e8tre doit \u00eatre fourni. #enable_pin: !gpio0_20 # La broche d'activation globale de la replicape. La valeur par d\u00e9faut est !gpio0_20 # (aka P9_41). host_mcu : # Le nom de la section de configuration mcu communiquant avec la section de # l'instance mcu du \"processus linux\" de Klipper. Ce param\u00e8tre doit \u00eatre # fourni. #standstill_power_down: False # Ce param\u00e8tre contr\u00f4le la ligne CFG6_ENN sur tous les moteurs pas \u00e0 pas. # True r\u00e8gle les lignes d'activation sur \"ouvert\". La valeur par d\u00e9faut est # False. #stepper_x_microstep_mode: #stepper_y_microstep_mode: #stepper_z_microstep_mode: #stepper_e_microstep_mode: #stepper_h_microstep_mode: # Ce param\u00e8tre contr\u00f4le les broches CFG1 et CFG2 du pilote de moteur donn\u00e9. # Les options disponibles sont : disable, 1, 2, spread2, 4, 16, spread4, spread16, # stealth4, et stealth16. La valeur par d\u00e9faut est disable. #stepper_x_current: #stepper_y_current: #stepper_z_current: #stepper_e_current: #stepper_h_current: # Le courant maximum configur\u00e9 (en Amp\u00e8res) du moteur pas \u00e0 pas. # Ce param\u00e8tre doit \u00eatre fourni si le moteur pas \u00e0 pas n'est pas dans un # mode d\u00e9sactiv\u00e9. #stepper_x_chopper_off_time_high: #stepper_y_chopper_off_time_high: #stepper_z_chopper_off_time_high: #stepper_e_chopper_off_time_high: #stepper_h_chopper_off_time_high: # Ce param\u00e8tre contr\u00f4le la broche CFG0 du pilote du moteur pas \u00e0 pas. # (True place CFG0 en haut, False le place en bas). La valeur par d\u00e9faut est False. #stepper_x_chopper_hysteresis_high: #stepper_y_chopper_hysteresis_high: #stepper_z_chopper_hysteresis_high: #stepper_e_chopper_hysteresis_high: #stepper_h_chopper_hysteresis_high: # Ce param\u00e8tre contr\u00f4le la broche CFG4 du pilote du moteur pas \u00e0 pas. # (True place CFG4 en haut, False le place en bas). La valeur par d\u00e9faut est False. #stepper_x_chopper_blank_time_high: #stepper_y_chopper_blank_time_high: #stepper_z_chopper_blank_time_high: #stepper_e_chopper_blank_time_high: #stepper_h_chopper_blank_time_high: # Ce param\u00e8tre contr\u00f4le la broche CFG5 du pilote du moteur pas \u00e0 pas. # (True place CFG5 en haut, False le place en bas). La valeur par d\u00e9faut est True. Autres modules sp\u00e9cifiques \u00b6 [palette2] \u00b6 Prise en charge des multimat\u00e9riaux de la Palette 2 - assure une int\u00e9gration plus \u00e9troite de la prise en charge des p\u00e9riph\u00e9riques de la Palette 2 en mode connect\u00e9. Ce module n\u00e9cessite \u00e9galement [virtual_sdcard] et [pause_resume] pour une fonctionnalit\u00e9 compl\u00e8te. Si vous utilisez ce module, n'utilisez pas le plugin Palette 2 pour Octoprint car ils entreront en conflit, et le module ne pourra pas s'initialiser correctement, ce qui fera \u00e9chouer votre impression. Si vous utilisez Octoprint et que vous diffusez du gcode sur le port s\u00e9rie au lieu d'imprimer \u00e0 partir de virtual_sd, alors supprimez M1 et M0 de Commandes de pause dans Param\u00e8tres > Connexion s\u00e9rie > Firmware & protocole \u00e9vitera d'avoir \u00e0 lancer l'impression sur la Palette 2 et de devoir lever la pause dans Octoprint pour que l'impression commence. [palette2] serial: # Le port s\u00e9rie \u00e0 connecter \u00e0 la Palette 2. #baud: 115200 # Le d\u00e9bit en bauds \u00e0 utiliser. La valeur par d\u00e9faut est 115200. #feedrate_splice: 0.8 # Le taux d'avance \u00e0 utiliser lors de l'\u00e9pissage, la valeur par d\u00e9faut est 0.8. #feedrate_normal: 1.0 # L'avance \u00e0 utiliser apr\u00e8s l'\u00e9pissage, la valeur par d\u00e9faut est 1.0. #auto_load_speed: 2 # Vitesse d'extrusion lors du chargement automatique, par d\u00e9faut 2 (mm/s). #auto_cancel_variation: 0.1 # Annulation automatique de l'impression lorsque la variation du ping est sup\u00e9rieure \u00e0 ce seuil. [angle] \u00b6 Prise en charge du capteur d'angle Hall magn\u00e9tique pour la lecture des mesures de l'angle de l'arbre du moteur pas \u00e0 pas \u00e0 l'aide des puces SPI a1333, as5047d ou tle5012b. Les mesures sont disponibles via le serveur API et l' outil d'analyse de mouvement . Voir la r\u00e9f\u00e9rence G-Code pour les commandes disponibles. [angle my_angle_sensor] sensor_type: # Le type de la puce du capteur magn\u00e9tique \u00e0 effet Hall. Les choix disponibles # sont \"a1333\", \"as5047d\" et \"tle5012b\". Ce param\u00e8tre doit \u00eatre sp\u00e9cifi\u00e9. #sample_period: 0.000400 # La p\u00e9riode de requ\u00eate (en secondes) \u00e0 utiliser lors des mesures. La valeur par # d\u00e9faut est de 0.000400 (ce qui correspond \u00e0 2500 \u00e9chantillons par seconde). #stepper: # Le nom du pilote moteur pas \u00e0 pas auquel le capteur d'angle est attach\u00e9 (ex, # \"stepper_x\"). La d\u00e9finition de cette valeur active un \u00e9talonnage d'angle. # Pour utiliser cette fonction, le paquet Python \"numpy\" doit \u00eatre install\u00e9. # Par d\u00e9faut, l'\u00e9talonnage d'angle n'est pas activ\u00e9 pour un capteur d'angle. cs_pin: # La broche d'activation SPI du capteur. Ce param\u00e8tre doit \u00eatre fourni. #spi_speed: #spi_bus: #spi_software_sclk_pin: #spi_software_mosi_pin: #spi_software_miso_pin: # Voir la section \"param\u00e8tres SPI communs\" pour une description des # param\u00e8tres ci-dessus. Param\u00e8tres communs aux bus \u00b6 Param\u00e8tres SPI communs \u00b6 Les param\u00e8tres suivants sont g\u00e9n\u00e9ralement disponibles pour les dispositifs utilisant un bus SPI. #spi_speed: # La vitesse SPI (en hz) \u00e0 utiliser lors de la communication avec le p\u00e9riph\u00e9rique. # La valeur par d\u00e9faut d\u00e9pend du type de p\u00e9riph\u00e9rique. #spi_bus: # Si le micro-contr\u00f4leur supporte plusieurs bus SPI alors on peut sp\u00e9cifier le nom # du bus du micro-contr\u00f4leur ici. La valeur par d\u00e9faut d\u00e9pend du type de # micro-contr\u00f4leur. #spi_software_sclk_pin: #spi_software_mosi_pin: #spi_software_miso_pin: # Sp\u00e9cifiez les param\u00e8tres ci-dessus pour utiliser le \"SPI logiciel\". Ce mode ne # n\u00e9cessite pas le support mat\u00e9riel du micro-contr\u00f4leur (typiquement n'importe # quelle broche d'usage g\u00e9n\u00e9ral peut \u00eatre utilis\u00e9e). La valeur par d\u00e9faut est de # ne pas utiliser le \"spi logiciel\". Param\u00e8tres I2C communs \u00b6 Les param\u00e8tres suivants sont g\u00e9n\u00e9ralement disponibles pour les dispositifs utilisant un bus I2C. Notez que le support actuel des micro-contr\u00f4leurs de Klipper pour i2c n'est g\u00e9n\u00e9ralement pas tol\u00e9rant au bruit sur la ligne. Des erreurs inattendues sur les fils i2c peuvent entra\u00eener une erreur d'ex\u00e9cution de Klipper. Le support de Klipper de r\u00e9cup\u00e9ration des erreurs varie selon le type de micro-contr\u00f4leur. Il est g\u00e9n\u00e9ralement recommand\u00e9 de n'utiliser que des dispositifs i2c se trouvant sur la m\u00eame carte de circuit imprim\u00e9 que le microcontr\u00f4leur. La plupart des impl\u00e9mentations de micro-contr\u00f4leurs Klipper ne supportent qu'une i2c_speed de 100000. Le micro-contr\u00f4leur Klipper \"linux\" supporte une vitesse de 400000, mais elle doit \u00eatre d\u00e9finie dans le syst\u00e8me d'exploitation sinon le param\u00e8tre i2c_speed est ignor\u00e9. Le micro-contr\u00f4leur Klipper \"rp2040\" supporte un taux de 400000 via le param\u00e8tre i2c_speed . Tous les autres micro-contr\u00f4leurs Klipper utilisent un taux de 100000 et ignorent le param\u00e8tre i2c_speed . #i2c_address: # L'adresse i2c du p\u00e9riph\u00e9rique. Elle doit \u00eatre sp\u00e9cifi\u00e9e sous la forme d'un nombre d\u00e9cimal # (pas en hexad\u00e9cimal). La valeur par d\u00e9faut d\u00e9pend du type de p\u00e9riph\u00e9rique. #i2c_mcu: # Le nom du micro-contr\u00f4leur auquel la puce est connect\u00e9e. # La valeur par d\u00e9faut est \"mcu\". #i2c_bus: # Si le micro-contr\u00f4leur supporte plusieurs bus I2C, on peut sp\u00e9cifier le bus du micro-contr\u00f4leur. # La valeur par d\u00e9faut d\u00e9pend du type de micro-contr\u00f4leur. #i2c_speed: # La vitesse I2C (en Hz) \u00e0 utiliser lors de la communication avec le p\u00e9riph\u00e9rique. # L'impl\u00e9mentation de Klipper pour la plupart des micro-contr\u00f4leurs est cod\u00e9e en dur \u00e0 100000, # modifier cette valeur n'a aucun effet. La valeur par d\u00e9faut est 100000.","title":"R\u00e9f\u00e9rence de configuration"},{"location":"Config_Reference.html#reference-de-configuration","text":"Ce document est la r\u00e9f\u00e9rence des options disponibles dans le fichier de configuration de Klipper. Les descriptions de ce document sont format\u00e9es de mani\u00e8re \u00e0 ce qu'il soit possible de les copier-coller dans un fichier de configuration d'imprimante. Consultez le document d'installation pour obtenir des informations sur la configuration de Klipper et le choix d'un fichier de configuration initial.","title":"R\u00e9f\u00e9rence de configuration"},{"location":"Config_Reference.html#configuration-du-microcontroleur","text":"","title":"Configuration du microcontr\u00f4leur"},{"location":"Config_Reference.html#format-du-nom-des-broches-du-microcontroleur","text":"De nombreuses options de configuration n\u00e9cessitent le nom d'une broche du micro-contr\u00f4leur. Klipper utilise les noms mat\u00e9riel pour ces broches - par exemple PA4 . Les noms des broches peuvent \u00eatre pr\u00e9c\u00e9d\u00e9s de ! pour indiquer qu'une polarit\u00e9 inverse doit \u00eatre utilis\u00e9e (par exemple, d\u00e9clencher sur le niveau bas au lieu du niveau haut). Les broches d'entr\u00e9e peuvent \u00eatre pr\u00e9c\u00e9d\u00e9es de ^ pour indiquer qu'une r\u00e9sistance pull-up mat\u00e9rielle doit \u00eatre activ\u00e9e pour cette broche. Si le micro-contr\u00f4leur supporte les r\u00e9sistances pull-down, une broche d'entr\u00e9e peut \u00e9galement \u00eatre pr\u00e9c\u00e9d\u00e9e de ~ . Notez que certaines sections de configuration peuvent \"cr\u00e9er\" des broches suppl\u00e9mentaires. Lorsque cela se produit, la section de configuration d\u00e9finissant ces broches doit \u00eatre r\u00e9pertori\u00e9e dans le fichier de configuration avant toute section utilisant celles-ci.","title":"Format du nom des broches du microcontr\u00f4leur"},{"location":"Config_Reference.html#mcu","text":"Configuration du microcontr\u00f4leur primaire. [mcu] serial: # Le port s\u00e9rie \u00e0 connecter \u00e0 l'unit\u00e9 MCU. Si vous n'\u00eates pas s\u00fbr (ou s'il # change) consultez la section \"O\u00f9 est mon port s\u00e9rie ?\" de la FAQ. # Ce param\u00e8tre doit \u00eatre fourni lors de l'utilisation d'un port s\u00e9rie. #baud: 250000 # Le d\u00e9bit en bauds \u00e0 utiliser. La valeur par d\u00e9faut est 250000. #canbus_uuid: # Si vous utilisez un dispositif connect\u00e9 \u00e0 un bus CAN, ceci d\u00e9finit l'identifiant # unique de la puce \u00e0 laquelle se connecter. Cette valeur doit \u00eatre fournie lorsque l'on utilise # le bus CAN pour la communication. #canbus_interface: # Si vous utilisez un dispositif connect\u00e9 \u00e0 un bus CAN, ceci d\u00e9finit l'interface r\u00e9seau CAN # \u00e0 utiliser. La valeur par d\u00e9faut est 'can0'. #restart_method: # Ceci contr\u00f4le le m\u00e9canisme que l'h\u00f4te utilisera pour r\u00e9initialiser le microcontr\u00f4leur. # Les choix sont 'arduino', 'cheetah', 'rpi_usb', et 'command'. La m\u00e9thode 'arduino' # (basculer DTR) est courante sur les cartes et clones Arduino. # La m\u00e9thode 'cheetah' est une m\u00e9thode particuli\u00e8re n\u00e9cessaire pour certaines cartes # Fysetc Cheetah. La m\u00e9thode 'rpi_usb' est utile sur les cartes Raspberry Pi avec des # micro-contr\u00f4leurs aliment\u00e9s par USB - elle d\u00e9sactive bri\u00e8vement l'alimentation de tous # les ports USB pour effectuer une r\u00e9initialisation du microcontr\u00f4leur. # La m\u00e9thode 'command' implique l'envoi d'une commande Klipper au microcontr\u00f4leur # afin qu'il puisse # se r\u00e9initialiser. # La valeur par d\u00e9faut est 'arduino' si le micro-contr\u00f4leur communique via un port s\u00e9rie, # 'command' sinon.","title":"[mcu|"},{"location":"Config_Reference.html#mcu-my_extra_mcu","text":"Microcontr\u00f4leurs suppl\u00e9mentaires (on peut d\u00e9finir un nombre quelconque de sections avec un pr\u00e9fixe \"mcu\"). Les microcontr\u00f4leurs suppl\u00e9mentaires introduisent des broches additionnelles pouvant \u00eatre configur\u00e9es comme des \u00e9l\u00e9ments de chauffage, des pilotes moteurs, des ventilateurs, etc. Par exemple, si une section \"[mcu extra_mcu]\" est ajout\u00e9e, des broches telles que \"extra_mcu:ar9\" pourront \u00eatre utilis\u00e9es ailleurs dans la configuration (o\u00f9 \"ar9\" est un nom de broche mat\u00e9rielle ou un nom d'alias sur le mcu donn\u00e9). [mcu my_extra_mcu] # Voir la section \"mcu\" pour les param\u00e8tres de configuration.","title":"[mcu my_extra_mcu]"},{"location":"Config_Reference.html#parametres-cinematiques-courants","text":"","title":"Param\u00e8tres cin\u00e9matiques courants"},{"location":"Config_Reference.html#printer","text":"La section imprimante contr\u00f4le les param\u00e8tres de haut niveau de l'imprimante. [printer] kinematics: # Le type d'imprimante utilis\u00e9e. Cette option peut \u00eatre l'une des suivantes : cart\u00e9sienne, # corexy, corexz, hybrid_corexy, hybrid_corexz, rotary_delta, delta, deltesian, polar, winch, # ou none. Ce param\u00e8tre doit \u00eatre sp\u00e9cifi\u00e9. max_velocity: # Vitesse maximale (en mm/s) de la t\u00eate d'outil (par rapport \u00e0 l'impression). # Ce param\u00e8tre doit \u00eatre sp\u00e9cifi\u00e9. max_accel: # Acc\u00e9l\u00e9ration maximale (en mm/s^2) de la t\u00eate de l'outil (par rapport \u00e0 l'impression). # Ce param\u00e8tre doit \u00eatre sp\u00e9cifi\u00e9. #max_accel_to_decel: # Une pseudo-acc\u00e9l\u00e9ration (en mm/s^2) contr\u00f4lant la vitesse \u00e0 laquelle la t\u00eate de l'outil peut # passer de l'acc\u00e9l\u00e9ration \u00e0 la d\u00e9c\u00e9l\u00e9ration. Elle est utilis\u00e9e pour r\u00e9duire la vitesse maximale # des courts mouvements en zigzag (et donc r\u00e9duire les vibrations de l'imprimante dues \u00e0 ces # mouvements). La valeur par d\u00e9faut est la moiti\u00e9 de max_accel. #square_corner_velocity: 5.0 # La vitesse maximale (en mm/s) \u00e0 laquelle la t\u00eate d'outil peut parcourir un angle de 90 degr\u00e9s. # Une valeur non nulle peut r\u00e9duire les changements dans les d\u00e9bits de l'extrudeuse en # permettant des changements de vitesse instantan\u00e9s de la t\u00eate d'outil pendant les virages. # Cette valeur configure l'algorithme interne de prise de virage \u00e0 vitesse centrip\u00e8te ; les virages # dont l'angle est sup\u00e9rieur \u00e0 90 degr\u00e9s auront une vitesse de prise de virage plus \u00e9lev\u00e9e tandis # que ceux d'angles inf\u00e9rieurs \u00e0 90 degr\u00e9s auront une vitesse de virage plus faible. # Si ce param\u00e8tre est d\u00e9fini sur z\u00e9ro, la t\u00eate d'outil d\u00e9c\u00e9l\u00e9rera jusqu'\u00e0 z\u00e9ro \u00e0 chaque coin. # La valeur par d\u00e9faut est 5mm/s.","title":"[printer]"},{"location":"Config_Reference.html#stepper","text":"D\u00e9finitions des pilotes de moteurs pas \u00e0 pas. Diff\u00e9rents types d'imprimantes (comme sp\u00e9cifi\u00e9 par l'option \"kinematics\" dans la section [printer]) requi\u00e8rent diff\u00e9rents noms pour le moteur pas \u00e0 pas (par exemple, stepper_x vs stepper_a ). Ci-dessous, vous trouverez les d\u00e9finitions les plus courantes. Voir le document distance de rotation pour des informations sur le calcul du param\u00e8tre rotation_distance . Voir le document Multi-MCU homing pour des informations sur l'utilisation de plusieurs microcontr\u00f4leurs lors d'une mise \u00e0 l'origine. [stepper_x] step_pin: # Broche GPIO du moteur (d\u00e9clench\u00e9e \u00e0 l'\u00e9tat haut). Ce param\u00e8tre doit \u00eatre fourni. dir_pin: # Broche GPIO de direction (le niveau haut indique une direction positive). Ce param\u00e8tre # doit \u00eatre fourni. enable_pin: # Broche d'activation (par d\u00e9faut, enable est haut ; utilisez ! pour indiquer enable # bas). Si ce param\u00e8tre n'est pas fourni, le pilote du moteur pas \u00e0 pas doit toujours # \u00eatre activ\u00e9. rotation_distance: # Distance (en mm) parcourue par l'axe lors d'une rotation compl\u00e8te du moteur pas \u00e0 pas # (ou de l'engrenage final si le rapport de vitesse est sp\u00e9cifi\u00e9). # Ce param\u00e8tre doit \u00eatre fourni. microsteps: # Le nombre de micropas utilis\u00e9s par le pilote du moteur pas \u00e0 pas. Ce param\u00e8tre # doit \u00eatre fourni. #full_steps_per_rotation: 200 # Nombre de pas complets pour une rotation compl\u00e8te du moteur pas \u00e0 pas. # R\u00e9glez ce param\u00e8tre sur 200 pour un moteur pas \u00e0 pas de 1,8 degr\u00e9 ou sur 400 pour # un moteur de 0,9 degr\u00e9. La valeur par d\u00e9faut est 200. #gear_ratio: # Le rapport d'engrenage si le moteur pas \u00e0 pas est reli\u00e9 \u00e0 l'axe via une d\u00e9multiplication. # Par exemple, on peut sp\u00e9cifier \"5:1\" si un r\u00e9ducteur de 5 pour 1 est utilis\u00e9. # Si l'axe a plusieurs d\u00e9multiplications, on peut sp\u00e9cifier une liste de rapports s\u00e9par\u00e9s par # des virgules (par exemple, \"57:11, 2:1\"). Si un rapport de vitesse est sp\u00e9cifi\u00e9, alors # rotation_distance sp\u00e9cifie la distance parcourue par l'axe pour une rotation compl\u00e8te # de l'engrenage final. # La valeur par d\u00e9faut est de ne pas utiliser de rapport de vitesse. #step_pulse_duration: # Le temps minimum entre le front du signal d'impulsion de pas et le front du signal \"unstep\" suivant. # Ceci est \u00e9galement utilis\u00e9 pour d\u00e9finir le temps minimum entre une impulsion de pas et un signal # de changement de direction. # La valeur par d\u00e9faut est 0,000000100 (100ns) pour les pilotes TMC configur\u00e9s en mode UART ou SPI, # sinon la valeur par d\u00e9faut est de 0,000002 (2us) pour tous les autres pilotes. endstop_pin: # Broche de d\u00e9tection de l'interrupteur de fin de course. Si cette broche est sur un mcu diff\u00e9rent de # celui du moteur pas \u00e0 pas, cela active le \"multi-mcu\". Ce param\u00e8tre doit \u00eatre fourni pour les moteurs # pas \u00e0 pas X, Y, et Z sur les imprimantes de style cart\u00e9sien. #position_min: 0 # Distance minimale valide (en mm) vers laquelle l'utilisateur peut commander le moteur pas \u00e0 pas. # La valeur par d\u00e9faut est 0mm. position_endstop: # Emplacement de la but\u00e9e (en mm). Ce param\u00e8tre doit \u00eatre fourni pour les moteurs X, Y et Z # des imprimantes de style cart\u00e9sien. position_max: # Distance maximale valide (en mm) vers laquelle l'utilisateur peut ordonner au moteur de se d\u00e9placer. # Ce param\u00e8tre doit \u00eatre fourni pour les moteurs X, Y, et Z des imprimantes de type cart\u00e9sien. #homing_speed: 5.0 # Vitesse maximale (en mm/s) du moteur pas \u00e0 pas lors de la mise \u00e0 l'origine. La valeur par d\u00e9faut # est de 5mm/s. #homing_retract_dist: 5.0 # Distance de recul (en mm) avant le retour au point d'origine une seconde fois. # R\u00e9glez cette valeur \u00e0 z\u00e9ro pour d\u00e9sactiver le second retour \u00e0 l'origine. La valeur par d\u00e9faut # est de 5 mm. #homing_retract_speed: # Vitesse \u00e0 utiliser pour le mouvement de recul apr\u00e8s le retour \u00e0 l'origine au cas o\u00f9 elle soit # diff\u00e9rente de la vitesse de mise \u00e0 l'origine qui est la valeur par d\u00e9faut de ce param\u00e8tre. #second_homing_speed: # Vitesse (en mm/s) du moteur pas \u00e0 pas lors du second retour \u00e0 l'origine. # La valeur par d\u00e9faut est homing_speed/2. #homing_positive_dir: # Si la valeur est vraie (true), le retour au point d'origine entra\u00eenera le d\u00e9placement de la commande pas # \u00e0 pas dans une direction positive (en s'\u00e9loignant de z\u00e9ro) ; si elle est fausse (false), le retour \u00e0 l'origine # se fera vers z\u00e9ro. Il est pr\u00e9f\u00e9rable d'utiliser la valeur par d\u00e9faut que de sp\u00e9cifier ce param\u00e8tre. La valeur # par d\u00e9faut est true si position_endstop est proche de position_max et false si elle est proche de # la position_min.","title":"[stepper]"},{"location":"Config_Reference.html#cinematique-cartesienne","text":"Voir example-cartesian.cfg pour un exemple de fichier de configuration de cin\u00e9matique cart\u00e9sienne. Seuls les param\u00e8tres sp\u00e9cifiques aux imprimantes cart\u00e9siennes sont d\u00e9crits ici - voir param\u00e8tres cin\u00e9matiques communs pour les param\u00e8tres disponibles. [printer] kinematics: cartesian max_z_velocity: # Ceci d\u00e9finit la vitesse maximale (en mm/s) du mouvement le long de l'axe z # Ce param\u00e8tre peut \u00eatre utilis\u00e9 pour limiter la vitesse maximale du moteur pas \u00e0 pas z. # La valeur par d\u00e9faut est l'utilisation de max_velocity pour # max_z_velocity. max_z_accel: # Ce param\u00e8tre d\u00e9finit l'acc\u00e9l\u00e9ration maximale (en mm/s^2) du mouvement sur l'axe z. # Cela limite l'acc\u00e9l\u00e9ration du moteur pas \u00e0 pas z. La valeur par d\u00e9faut est # d'utiliser max_accel pour max_z_accel. # La section stepper_x est utilis\u00e9e pour d\u00e9crire le moteur pas \u00e0 pas contr\u00f4lant # l'axe X dans un robot cart\u00e9sien. [stepper_x] # La section stepper_y est utilis\u00e9e pour d\u00e9crire le moteur pas \u00e0 pas contr\u00f4lant # l'axe Y d'un robot cart\u00e9sien. [stepper_y] # La section stepper_z est utilis\u00e9e pour d\u00e9crire le moteur pas \u00e0 pas contr\u00f4lant # l'axe Z d'un robot cart\u00e9sien. [stepper_z]","title":"Cin\u00e9matique cart\u00e9sienne"},{"location":"Config_Reference.html#cinematique-delta-lineaire","text":"Voir example-delta.cfg pour un exemple de fichier de configuration de cin\u00e9matique delta lin\u00e9aire. Voir le guide de calibration delta pour des informations sur la calibration. Seuls les param\u00e8tres sp\u00e9cifiques aux imprimantes delta lin\u00e9aires sont d\u00e9crits ici - voir param\u00e8tres cin\u00e9matiques communs pour les param\u00e8tres disponibles. [printer] kinematics: delta max_z_velocity: # Pour les imprimantes delta, cela limite la vitesse maximale (en mm/s) des # mouvements de l'axe z. Ce param\u00e8tre peut \u00eatre utilis\u00e9 pour r\u00e9duire la # vitesse maximale des d\u00e9placements vers le haut/bas (n\u00e9cessitent une vitesse # de pas plus \u00e9lev\u00e9e que les autres mouvements sur une imprimante delta). La # valeur par d\u00e9faut est d'utiliser max_velocity pour max_z_velocity. #max_z_accel: # Ceci d\u00e9finit l'acc\u00e9l\u00e9ration maximale (en mm/s^2) du mouvement le long de l'axe z. # Ce param\u00e8tre peut \u00eatre utile si l'imprimante peut atteindre une plus grande # acc\u00e9l\u00e9ration sur les mouvements XY que sur les mouvements Z (par exemple, lors # de l'utilisation de la compensation de r\u00e9sonance). # La valeur par d\u00e9faut est d'utiliser max_accel pour max_z_accel. #minimum_z_position: 0 # Position Z minimale \u00e0 laquelle l'utilisateur peut ordonner \u00e0 la t\u00eate de se d\u00e9placer. # La valeur par d\u00e9faut est 0. delta_radius: # Rayon (en mm) du cercle horizontal form\u00e9 par les trois colonnes d'axe lin\u00e9aire. # Ce param\u00e8tre peut \u00e9galement \u00eatre calcul\u00e9 comme suit : # delta_radius = smooth_rod_offset - effector_offset - carriage_offset. # Ce param\u00e8tre doit \u00eatre fourni. #print_radius: # Le rayon (en mm) des coordonn\u00e9es XY valides de la t\u00eate d'extrusion. On peut utiliser # ce param\u00e8tre pour personnaliser la v\u00e9rification de la plage de mouvements de la t\u00eate. # Si une grande valeur est sp\u00e9cifi\u00e9e ici, il peut \u00eatre possible de faire entrer la t\u00eate en collision # avec une colonne. La valeur par d\u00e9faut est d'utiliser delta_radius pour print_radius (ce qui # emp\u00eachera normalement une collision avec une colonne). # La section stepper_a d\u00e9crit le moteur pas \u00e0 pas contr\u00f4lant la colonne avant gauche (\u00e0 210 # degr\u00e9s). Cette section contr\u00f4le \u00e9galement les param\u00e8tres de la mise \u00e0 l'origine # (homing_speed, homing_retract_dist) pour toutes les colonnes. [stepper_a] position_endstop: # Distance (en mm) entre la buse et le lit lorsque la buse se trouve au centre de la zone de # construction et que la fin de course se d\u00e9clenche. Ce param\u00e8tre doit \u00eatre fourni pour le # stepper_a ; pour les stepper_b et stepper_c, ce param\u00e8tre prend par d\u00e9faut la valeur # sp\u00e9cifi\u00e9e pour stepper_a. arm_length: # Longueur (en mm) du bras reliant cette colonne \u00e0 la t\u00eate d'impression. # Ce param\u00e8tre doit \u00eatre fourni pour stepper_a ; pour stepper_b et stepper_c, ce param\u00e8tre # prend par d\u00e9faut la valeur sp\u00e9cifi\u00e9e pour stepper_a. #angle: # Cette option sp\u00e9cifie l'angle (en degr\u00e9s) o\u00f9 se trouve positionn\u00e9e la colonne. # La valeur par d\u00e9faut est 210 pour stepper_a, 330 pour stepper_b, et 90 # pour stepper_c. # La section stepper_b d\u00e9crit le moteur pas \u00e0 pas contr\u00f4lant la colonne avant droite (\u00e0 330 degr\u00e9s). [stepper_b] # La section stepper_c d\u00e9crit le moteur pas \u00e0 pas contr\u00f4lant la colonne arri\u00e8re droite (\u00e0 90 degr\u00e9s). [stepper_c] # La section delta_calibrate active une commande G-code \u00e9tendue DELTA_CALIBRATE permettant # de calibrer la position des interrupteurs de fin de course ainsi que les angles des colonnes. [delta_calibrate] radius: # Rayon (en mm) de la zone palpable. Il s'agit du rayon des coordonn\u00e9es de la buse \u00e0 sonder ; si # vous utilisez un palpeur automatique avec un d\u00e9calage XY, choisissez un rayon suffisamment # petit pour que la sonde reste toujours au-dessus du lit. # Ce param\u00e8tre doit \u00eatre fourni. #speed: 50 # La vitesse (en mm/s) des mouvements sans palpage pendant l'\u00e9talonnage. # La valeur par d\u00e9faut est 50. #horizontal_move_z: 5 # La hauteur (en mm) \u00e0 laquelle la t\u00eate doit \u00eatre relev\u00e9e pour se d\u00e9placer # juste avant de lancer une op\u00e9ration de palpage. La valeur par d\u00e9faut est 5.","title":"Cin\u00e9matique Delta lin\u00e9aire"},{"location":"Config_Reference.html#cinematique-deltesienne","text":"Voir example-deltesian.cfg pour un exemple de fichier de configuration de cin\u00e9matique deltesienne. Seuls les param\u00e8tres sp\u00e9cifiques aux imprimantes deltesiennes sont d\u00e9crits ici - voir param\u00e8tres cin\u00e9matiques communs pour les param\u00e8tres disponibles. [printer] kinematics: deltesian max_z_velocity: # Pour les imprimantes deltesiennes, ceci limite la vitesse maximale (en mm/s) des # d\u00e9placements avec un mouvement sur l'axe z. Ce param\u00e8tre peut \u00eatre utilis\u00e9 pour # r\u00e9duire la vitesse maximale des d\u00e9placements vers le haut/bas (qui n\u00e9cessitent un # taux de pas plus \u00e9lev\u00e9 que les autres mouvements sur une imprimante deltesienne). # La valeur par d\u00e9faut est d'utiliser max_velocity pour max_z_velocity. #max_z_accel: # Ceci d\u00e9finit l'acc\u00e9l\u00e9ration maximale (en mm/s^2) du mouvement le long de l'axe z. # Ce param\u00e8tre peut \u00eatre utile si l'imprimante peut atteindre une plus grande # acc\u00e9l\u00e9ration sur les mouvements XY que sur les mouvements Z (par exemple, lors # de l'utilisation de la compensation de la r\u00e9sonance). # La valeur par d\u00e9faut est d'utiliser max_accel pour max_z_accel. #minimum_z_position : 0 # Position Z minimale \u00e0 laquelle l'utilisateur peut ordonner \u00e0 la t\u00eate de se d\u00e9placer. # La valeur par d\u00e9faut est 0. #min_angle: 5 # Ceci repr\u00e9sente l'angle minimum (en degr\u00e9s) par rapport \u00e0 l'horizontale que les bras # deltesiens sont autoris\u00e9s \u00e0 atteindre. Ce param\u00e8tre est destin\u00e9 \u00e0 emp\u00eacher les bras de # devenir compl\u00e8tement horizontaux, ce qui risquerait de provoquer une inversion # accidentelle de l'axe XZ. # La valeur par d\u00e9faut est 5. #print_width: # La distance (en mm) des coordonn\u00e9es X valides de la t\u00eate de l'outil. On peut utiliser ce # param\u00e8tre pour personnaliser la v\u00e9rification de la plage des mouvements de la t\u00eate de # l'outil. Si une grande valeur est sp\u00e9cifi\u00e9e ici, il peut \u00eatre possible de faire entrer la t\u00eate # de l'outil en collision avec une colonne. Ce param\u00e8tre correspond g\u00e9n\u00e9ralement \u00e0 la # largeur du banc (en mm). #slow_ratio: 3 # Rapport utilis\u00e9 pour limiter la vitesse et l'acc\u00e9l\u00e9ration des mouvements proches des # extr\u00eames de l'axe X. Si la distance verticale divis\u00e9e par la distance horizontale d\u00e9passe # la valeur de slow_ratio, la vitesse et l'acc\u00e9l\u00e9ration sont limit\u00e9es \u00e0 la moiti\u00e9 de leur valeur # nominale. Si la distance verticale divis\u00e9e par la distance horizontale d\u00e9passe de deux fois # la valeur de slow_ratio, alors la vitesse et l'acc\u00e9l\u00e9ration sont limit\u00e9es \u00e0 un quart de leur # valeur nominale. La valeur par d\u00e9faut est 3. # La section stepper_left est utilis\u00e9e pour d\u00e9crire le moteur pas \u00e0 pas contr\u00f4lant la colonne # gauche. Cette section contr\u00f4le \u00e9galement les param\u00e8tres d'orientation (homing_speed, # homing_retract_dist) pour toutes les colonnes. [stepper_left] position_endstop: # Distance (en mm) entre la buse et le lit lorsque la buse se trouve au centre de la zone de # construction. Ce param\u00e8tre doit \u00eatre fourni pour stepper_left ; pour le param\u00e8tre stepper_right # ce param\u00e8tre prend par d\u00e9faut la valeur sp\u00e9cifi\u00e9e pour stepper_left. arm_length: # Longueur (en mm) de la tige diagonale reliant le chariot de la colonne \u00e0 la t\u00eate d'impression. # Ce param\u00e8tre doit \u00eatre fourni pour stepper_left. Pour le param\u00e8tre stepper_right, ce param\u00e8tre # prend par d\u00e9faut la valeur sp\u00e9cifi\u00e9e pour stepper_left. arm_x_length: # Distance horizontale entre la t\u00eate d'impression et la colonne lorsque l'imprimante est mise \u00e0 # l'origine. Ce param\u00e8tre doit \u00eatre fourni pour stepper_left ; pour stepper_right, ce param\u00e8tre # prend par d\u00e9faut la valeur sp\u00e9cifi\u00e9e pour stepper_left. # La section stepper_right est utilis\u00e9e pour d\u00e9crire le moteur pas \u00e0 pas contr\u00f4lant la colonne de droite. [stepper_right] # La section stepper_y est utilis\u00e9e pour d\u00e9crire le moteur pas \u00e0 pas contr\u00f4lant l'axe Y d'un robot deltesien. [stepper_y]","title":"Cin\u00e9matique deltesienne"},{"location":"Config_Reference.html#cinematique-corexy","text":"Voir example-corexy.cfg pour un exemple de fichier cin\u00e9matique corexy (et h-bot). Seuls les param\u00e8tres sp\u00e9cifiques aux imprimantes corexy sont d\u00e9crits ici - voir param\u00e8tres cin\u00e9matiques communs pour les param\u00e8tres disponibles. [printer] kinematics: corexy max_z_velocity: # Ceci d\u00e9finit la vitesse maximale (en mm/s) du mouvement le long de l'axe z # Ce param\u00e8tre peut \u00eatre utilis\u00e9 pour limiter la vitesse maximale du moteur pas \u00e0 pas z. # La valeur par d\u00e9faut est l'utilisation de max_velocity pour max_z_velocity. max_z_accel: # Ce param\u00e8tre d\u00e9finit l'acc\u00e9l\u00e9ration maximale (en mm/s^2) du mouvement sur l'axe z. # Cela limite l'acc\u00e9l\u00e9ration du moteur pas \u00e0 pas z. La valeur par d\u00e9faut est # d'utiliser max_accel pour max_z_accel. # La section stepper_x est utilis\u00e9e pour d\u00e9crire l'axe X ainsi que le moteur pas \u00e0 pas # contr\u00f4lant le mouvement X+Y. [stepper_x] # La section stepper_y est utilis\u00e9e pour d\u00e9crire l'axe Y ainsi que le moteur pas \u00e0 pas # contr\u00f4lant le mouvement X-Y. [stepper_y] # La section stepper_z est utilis\u00e9e pour d\u00e9crire le moteur pas \u00e0 pas contr\u00f4lant l'axe Z. [stepper_z]","title":"Cin\u00e9matique CoreXY"},{"location":"Config_Reference.html#cinematique-corexz","text":"Voir example-corexz.cfg pour un exemple de fichier de configuration de cin\u00e9matique corexz. Seuls les param\u00e8tres sp\u00e9cifiques aux imprimantes corexz sont d\u00e9crits ici - voir param\u00e8tres cin\u00e9matiques communs pour les param\u00e8tres disponibles. [printer] kinematics: corexz max_z_velocity: # Ceci d\u00e9finit la vitesse maximale (en mm/s) du mouvement le long de l'axe z. # La valeur par d\u00e9faut est d'utiliser max_velocity pour max_z_velocity. max_z_accel: # Ceci d\u00e9finit l'acc\u00e9l\u00e9ration maximale (en mm/s^2) du mouvement le long de l'axe z. # La valeur par d\u00e9faut est d'utiliser max_accel pour max_z_accel. # La section stepper_x est utilis\u00e9e pour d\u00e9crire l'axe X ainsi que le moteur pas \u00e0 pas # contr\u00f4lant le mouvement X+Z. [stepper_x] # La section stepper_y est utilis\u00e9e pour d\u00e9crire le moteur pas \u00e0 pas contr\u00f4lant l'axe Y. [stepper_y] # La section stepper_z est utilis\u00e9e pour d\u00e9crire l'axe Z ainsi que le moteur pas \u00e0 pas # contr\u00f4lant le mouvement X-Z. [stepper_z]","title":"Cin\u00e9matique CoreXZ"},{"location":"Config_Reference.html#cinematique-hybride-corexy","text":"Voir example-hybrid-corexy.cfg pour un exemple de fichier de configuration de cin\u00e9matique hybride corexy. Cette cin\u00e9matique est \u00e9galement connue sous le nom de cin\u00e9matique Markforged. Seuls les param\u00e8tres sp\u00e9cifiques aux imprimantes hybrides corexy sont d\u00e9crits ici ; voir param\u00e8tres cin\u00e9matiques communs pour les param\u00e8tres disponibles. [printer] kinematics: hybrid_corexy max_z_velocity: # Ceci d\u00e9finit la vitesse maximale (en mm/s) du mouvement le long de l'axe z # La valeur par d\u00e9faut est d'utiliser max_velocity pour max_z_velocity. max_z_acce : # Ceci d\u00e9finit l'acc\u00e9l\u00e9ration maximale (en mm/s^2) du mouvement le long de l'axe z. # La valeur par d\u00e9faut est d'utiliser max_accel pour max_z_accel. # La section stepper_x est utilis\u00e9e pour d\u00e9crire l'axe X ainsi que le moteur pas \u00e0 pas # contr\u00f4lant le mouvement X-Y. [stepper_x] # La section stepper_y est utilis\u00e9e pour d\u00e9crire le moteur pas \u00e0 pas contr\u00f4lant # l'axe Y. [stepper_y] # La section stepper_z est utilis\u00e9e pour d\u00e9crire le moteur pas \u00e0 pas contr\u00f4lant # l'axe Z. [stepper_z]","title":"Cin\u00e9matique Hybride-CoreXY"},{"location":"Config_Reference.html#cinematique-hybride-corexz","text":"Voir example-hybrid-corexz.cfg pour un exemple de fichier de configuration de cin\u00e9matique hybride corexz. Cette cin\u00e9matique est \u00e9galement connue sous le nom de cin\u00e9matique Markforged. Seuls les param\u00e8tres sp\u00e9cifiques aux imprimantes hybrides corexy sont d\u00e9crits ici ; voir param\u00e8tres cin\u00e9matiques communs pour les param\u00e8tres disponibles. [printer] kinematics: hybrid_corexz max_z_velocity: # Ceci d\u00e9finit la vitesse maximale (en mm/s) du mouvement le long de l'axe z # La valeur par d\u00e9faut est d'utiliser max_velocity pour max_z_velocity. max_z_accel: # Ceci d\u00e9finit l'acc\u00e9l\u00e9ration maximale (en mm/s^2) du mouvement le long de # l'axe z. La valeur par d\u00e9faut est d'utiliser max_accel pour max_z_accel. # La section stepper_x est utilis\u00e9e pour d\u00e9crire l'axe X ainsi que le moteur pas \u00e0 pas # contr\u00f4lant le mouvement X-Z. [stepper_x] # La section stepper_y est utilis\u00e9e pour d\u00e9crire le moteur pas \u00e0 pas contr\u00f4lant # l'axe Y. [stepper_y] # La section stepper_z est utilis\u00e9e pour d\u00e9crire le moteur pas \u00e0 pas contr\u00f4lant # l'axe Z. [stepper_z]","title":"Cin\u00e9matique Hybride-CoreXZ"},{"location":"Config_Reference.html#cinematique-polaire","text":"Voir example-polar.cfg pour un exemple de fichier de configuration de cin\u00e9matique polaire. Seuls les param\u00e8tres sp\u00e9cifiques aux imprimantes polaires sont d\u00e9crits ici - voir param\u00e8tres cin\u00e9matiques communs pour les param\u00e8tres disponibles. LA CIN\u00c9MATIQUE POLAIRE EST UN TRAVAIL EN COURS. Les d\u00e9placements autour de la position 0, 0 sont connus pour ne pas fonctionner correctement. [printer] kinematics: polar max_z_velocity: # Ceci d\u00e9finit la vitesse maximale (en mm/s) du mouvement le long de l'axe z # Ce param\u00e8tre peut \u00eatre utilis\u00e9 pour limiter la vitesse maximale du moteur z. # La valeur par d\u00e9faut est d'utiliser max_velocity pour max_z_velocity. max_z_accel: # Ce param\u00e8tre d\u00e9finit l'acc\u00e9l\u00e9ration maximale (en mm/s^2) du mouvement sur l'axe z. # Cela limite l'acc\u00e9l\u00e9ration du moteur pas \u00e0 pas z. La valeur par d\u00e9faut est d'utiliser # max_accel pour max_z_accel. # La section stepper_bed est utilis\u00e9e pour d\u00e9crire le moteur pas \u00e0 pas contr\u00f4lant # le lit. [stepper_bed] gear_ratio: # Un rapport de vitesse doit \u00eatre sp\u00e9cifi\u00e9 et la distance de rotation ne peut pas \u00eatre # sp\u00e9cifi\u00e9e. Par exemple, si le lit est \u00e9quip\u00e9 d'une poulie \u00e0 80 dents entra\u00een\u00e9e par un # moteur dont l'axe est muni d'une poulie \u00e0 16 dents, il faut sp\u00e9cifier le rapport # d'engrenage de \"80:16\". Ce param\u00e8tre doit \u00eatre fourni. # La section stepper_arm est utilis\u00e9e pour d\u00e9crire le moteur pas \u00e0 pas contr\u00f4lant # le chariot sur le bras. [stepper_arm] # La section stepper_z permet de d\u00e9crire le moteur pas \u00e0 pas contr\u00f4lant l'axe Z. [stepper_z]","title":"Cin\u00e9matique polaire"},{"location":"Config_Reference.html#cinematique-rotative-delta","text":"Voir example-rotary-delta.cfg pour un exemple de fichier de configuration de cin\u00e9matique rotative delta. Seuls les param\u00e8tres sp\u00e9cifiques aux imprimantes rotatives delta sont d\u00e9crits ici - voir param\u00e8tres cin\u00e9matiques communs pour les param\u00e8tres disponibles. LA CIN\u00c9MATIQUE ROTATIVE DELTA EST UN TRAVAIL EN COURS. Les mouvements d'orientation peuvent d\u00e9passer le temps imparti et certains contr\u00f4les de limites ne sont pas impl\u00e9ment\u00e9s. [printer] kinematics: rotary_delta max_z_velocity: # Pour les imprimantes delta, ceci limite la vitesse maximale (en mm/s) des d\u00e9placements avec # mouvement de l'axe z. Ce param\u00e8tre peut \u00eatre utilis\u00e9 pour r\u00e9duire la vitesse maximale des # mouvements de mont\u00e9e/descente (n\u00e9cessitant un taux de pas plus \u00e9lev\u00e9 que les autres mouvements # sur une imprimante delta). La valeur par d\u00e9faut est d'utiliser max_velocity pour max_z_velocity. #minimum_z_position: 0 # La position Z minimale \u00e0 laquelle l'utilisateur peut ordonner \u00e0 la t\u00eate de se d\u00e9placer. # La valeur par d\u00e9faut est 0. shoulder_radius: # Rayon (en mm) du cercle horizontal form\u00e9 par les trois articulations de l'effecteur, moins le rayon # du cercle form\u00e9 par l'articulation de l'effecteur. # Ce param\u00e8tre peut \u00e9galement \u00eatre calcul\u00e9 comme suit # shoulder_radius = (delta_f - delta_e) / sqrt(12) # Ce param\u00e8tre doit \u00eatre fourni. shoulder_height: # Distance (en mm) des joints de l'effecteur par rapport au lit, moins la hauteur de la t\u00eate de l'outil # sur l'effecteur. Ce param\u00e8tre doit \u00eatre fourni. # La section stepper_a d\u00e9crit le moteur pas \u00e0 pas contr\u00f4lant le bras arri\u00e8re droit (\u00e0 30 degr\u00e9s). # Cette section contr\u00f4le \u00e9galement les param\u00e8tres de la mise \u00e0 l'origine (homing_speed, # homing_retract_dist) pour tous les bras. [stepper_a] gear_ratio: # Un rapport de vitesse doit \u00eatre sp\u00e9cifi\u00e9 et la rotation_distance ne peut pas \u00eatre sp\u00e9cifi\u00e9e. # Par exemple, si le bras a une poulie de 80 dents entra\u00een\u00e9e par une poulie de 16 dents, \u00e0 son # tour reli\u00e9e \u00e0 une poulie de 60 dents entra\u00een\u00e9e par un moteur dont l'arbre est muni d'une poulie # \u00e0 16 dents, alors on sp\u00e9cifierait un rapport de vitesse de \"80:16, 60:16\". # Ce param\u00e8tre doit \u00eatre fourni. position_endstop: # Distance (en mm) entre la buse et le lit lorsque la buse se trouve au centre de la zone de construction # et que la but\u00e9e se d\u00e9clenche. Ce param\u00e8tre doit \u00eatre fourni pour le stepper_a ; pour le stepper_b et # le stepper_c, ce param\u00e8tre prend par d\u00e9faut la valeur sp\u00e9cifi\u00e9e pour stepper_a. upper_arm_length: # Longueur (en mm) du bras reliant l'\"articulation de l'effecteur\" \u00e0 l'\"articulation du coude\". # Ce param\u00e8tre doit \u00eatre fourni pour stepper_a ; pour stepper_b et stepper_c, ce param\u00e8tre prend par # d\u00e9faut la valeur sp\u00e9cifi\u00e9e pour stepper_a. lower_arm_length: # Longueur (en mm) du bras reliant l'\"articulation du coude\" \u00e0 l'\"articulation de l'effecteur\". # Ce param\u00e8tre doit \u00eatre fourni pour stepper_a ; pour stepper_b et stepper_c, ce param\u00e8tre prend # par d\u00e9faut la valeur sp\u00e9cifi\u00e9e pour stepper_a. #angle: # Cette option sp\u00e9cifie l'angle (en degr\u00e9s) auquel se trouve le bras. # La valeur par d\u00e9faut est 30 pour stepper_a, 150 pour stepper_b et 270 pour stepper_c. # La section stepper_b d\u00e9crit le moteur pas \u00e0 pas contr\u00f4lant le bras arri\u00e8re gauche (\u00e0 150 degr\u00e9s). [stepper_b] # La section stepper_c d\u00e9crit le moteur pas \u00e0 pas contr\u00f4lant le bras avant (\u00e0 270 degr\u00e9s). [stepper_c] # La section delta_calibrate active une commande G-code \u00e9tendue DELTA_CALIBRATE permettant # de calibrer les positions de la but\u00e9e de l'effecteur. [delta_calibrate] radius: # Rayon (en mm) de la zone pouvant \u00eatre palp\u00e9e. Il s'agit du rayon des coordonn\u00e9es de palpage # de la buse; si vous utilisez un palpeur automatique avec un d\u00e9calage XY, choisissez un rayon # suffisamment petit pour que la sonde s'adapte toujours au lit. Ce param\u00e8tre doit \u00eatre fourni. #speed: 50 # La vitesse (en mm/s) des mouvements sans palpage pendant l'\u00e9talonnage. # La valeur par d\u00e9faut est 50. #horizontal_move_z: 5 # La hauteur (en mm) \u00e0 laquelle la t\u00eate doit \u00eatre remont\u00e9e pour se d\u00e9placer juste avant de lancer # une op\u00e9ration de palpage. La valeur par d\u00e9faut est 5.","title":"Cin\u00e9matique rotative delta"},{"location":"Config_Reference.html#cinematique-du-treuil-a-cable","text":"Voir le fichier example-winch.cfg pour un exemple de fichier de configuration cin\u00e9matique d'un treuil \u00e0 c\u00e2ble. Seuls les param\u00e8tres sp\u00e9cifiques aux imprimantes \u00e0 treuil sont d\u00e9crits ici - voir param\u00e8tres cin\u00e9matiques communs pour les param\u00e8tres disponibles. LE SUPPORT DU TREUIL \u00c0 C\u00c2BLE EST EXP\u00c9RIMENTAL. La mise \u00e0 l'origine n'est pas impl\u00e9ment\u00e9e dans la cin\u00e9matique du treuil \u00e0 c\u00e2ble. Pour ramener l'imprimante \u00e0 l'origine, envoyez des commandes manuelles de mouvements jusqu'\u00e0 ce que la t\u00eate de l'outil soit \u00e0 0, 0, 0, puis envoyez la commande G28 . [printer] kinematics: winch # La section stepper_a d\u00e9crit le moteur pas \u00e0 pas connect\u00e9 au premier treuil \u00e0 c\u00e2ble. # Un minimum de 3 et un maximum de 26 treuils \u00e0 c\u00e2ble peuvent \u00eatre d\u00e9finis # (stepper_a \u00e0 stepper_z) bien qu'il soit courant d'en d\u00e9finir 4. [stepper_a] rotation_distance: # La rotation_distance est la distance nominale (en mm) \u00e0 laquelle la t\u00eate de l'outil # se d\u00e9place vers le treuil de c\u00e2ble pour chaque rotation compl\u00e8te du moteur pas # \u00e0 pas. Ce param\u00e8tre doit \u00eatre fourni. anchor_x: anchor_y: anchor_z: # Les positions X, Y et Z du treuil \u00e0 c\u00e2ble dans l'espace cart\u00e9sien. # Ces param\u00e8tres doivent \u00eatre fournis.","title":"Cin\u00e9matique du treuil \u00e0 c\u00e2ble"},{"location":"Config_Reference.html#aucune-cinematique","text":"Il est possible de d\u00e9finir une cin\u00e9matique particuli\u00e8re \"aucune (none)\" pour d\u00e9sactiver le support cin\u00e9matique dans Klipper. Cela peut \u00eatre utile pour contr\u00f4ler des p\u00e9riph\u00e9riques qui ne sont pas des imprimantes 3D typiques ou encore \u00e0 des fins de d\u00e9bogage. [printer] kinematics: none max_velocity: 1 max_accel: 1 # Les param\u00e8tres max_velocity et max_accel doivent \u00eatre d\u00e9finis. Les # valeurs par d\u00e9faut ne sont pas utilis\u00e9es pour la cin\u00e9matique \"none\".","title":"Aucune cin\u00e9matique"},{"location":"Config_Reference.html#extrudeur-commun-et-support-du-lit-chauffant","text":"","title":"Extrudeur commun et support du lit chauffant"},{"location":"Config_Reference.html#extruder","text":"La section de l'extrudeuse est utilis\u00e9e pour d\u00e9crire les param\u00e8tres de chauffe de la buse ainsi que pour les commandes pas \u00e0 pas de l'extrudeuse. Voir la r\u00e9f\u00e9rence de commande pour plus d'informations. Voir le guide d'avance de pression pour des informations sur le r\u00e9glage de l'avance de pression. [extruder] step_pin: dir_pin: enable_pin: microsteps: rotation_distance: #full_steps_per_rotation: #gear_ratio: # Voir la section \"stepper\" pour une description des param\u00e8tres ci-dessus. # Si aucun des param\u00e8tres ci-dessus n'est sp\u00e9cifi\u00e9, alors aucun pilote ne # sera associ\u00e9 \u00e0 la buse (bien qu'une commande SYNC_EXTRUDER_MOTION # puisse en associer un au moment de l'ex\u00e9cution). nozzle_diameter: # Diam\u00e8tre de l'orifice de la buse (en mm). Ce param\u00e8tre doit \u00eatre # fourni. filament_diameter: # Diam\u00e8tre moyen du filament (en mm) lorsqu'il entre dans l'extrudeuse. # Ce param\u00e8tre doit \u00eatre fourni. #max_extrude_cross_section: # Surface maximale (en mm^2) d'une section transversale d'extrusion (ex: # largeur de l'extrusion multipli\u00e9e par la hauteur de la couche). Ce param\u00e8tre # permet d'\u00e9viter d'extruder des quantit\u00e9s excessives durant de petits d\u00e9placements # XY. Si un d\u00e9placement demande une quantit\u00e9 d'extrusion sup\u00e9rieure \u00e0 cette valeur, # une erreur sera renvoy\u00e9e. La valeur par d\u00e9faut est 4.0 *diam\u00e8tre_buse^2 #instantaneous_corner_velocity: 1.000 # La variation instantan\u00e9e maximale de la vitesse (en mm/s) de l'extrudeuse # pendant la jonction de deux mouvements. La valeur par d\u00e9faut est 1mm/s. #max_extrude_only_distance: 50.0 # Longueur maximale (en mm de filament) qu'un mouvement de r\u00e9traction ou d'extrusion # peut fournir. Si un mouvement de r\u00e9traction ou d'extrusion unique demande une # distance sup\u00e9rieure \u00e0 cette valeur, une erreur sera renvoy\u00e9e. # La valeur par d\u00e9faut est 50mm. #max_extrude_only_velocity: #max_extrude_only_accel: # Vitesse maximale (en mm/s) et acc\u00e9l\u00e9ration (en mm/s^2) du moteur de l'extrudeuse # pour les r\u00e9tractions et les mouvements d'extrusion seuls. Ces param\u00e8tres n'ont aucun # impact sur les mouvements d'impression normaux. S'ils ne sont pas sp\u00e9cifi\u00e9s, ils sont # calcul\u00e9s pour correspondre \u00e0 la limite d'un mouvement qu'une impression de # section transversale de 4.0*diam\u00e8tre_buse^2 aurait. #pressure_advance: 0.0 # La quantit\u00e9 de filament \u00e0 pousser dans l'extrudeuse durant l'acc\u00e9l\u00e9ration de celle-ci. # Une quantit\u00e9 \u00e9gale de filament est r\u00e9tract\u00e9e durant la d\u00e9c\u00e9l\u00e9ration. Elle est mesur\u00e9e # en millim\u00e8tre/seconde. La valeur par d\u00e9faut est 0, ce qui d\u00e9sactive la fonctionnalit\u00e9 # d'avance de pression. #pressure_advance_smooth_time: 0.040 # Une dur\u00e9e (en secondes) \u00e0 utiliser lors du calcul de la vitesse moyenne de l'extrudeuse # pour l'avance de pression. Une valeur plus grande donne lieu \u00e0 des mouvements # d'extrusion plus lisses. Ce param\u00e8tre ne doit pas d\u00e9passer 200ms. # Ce param\u00e8tre ne s'applique que si pressure_advance est diff\u00e9rent de z\u00e9ro. La valeur # par d\u00e9faut est 0.040 (40 millisecondes). # # Les variables restantes d\u00e9crivent la chauffe de l'extrudeuse. heater_pin: # Broche de sortie PWM contr\u00f4lant le chauffage. Ce param\u00e8tre doit \u00eatre # fourni. #max_power: 1.0 # La puissance maximale (exprim\u00e9e sous la forme d'une valeur comprise entre 0,0 et 1,0) # de r\u00e9glage du heater_pin . La valeur 1.0 permet \u00e0 la broche d'\u00eatre r\u00e9gl\u00e9e comme toujours # activ\u00e9e durant des p\u00e9riodes prolong\u00e9es, tandis qu'une valeur de 0,5 permet \u00e0 la broche # de n'\u00eatre activ\u00e9e durant au plus la moiti\u00e9 du temps. # Ce r\u00e9glage peut \u00eatre utilis\u00e9 pour limiter la puissance totale de sortie (sur de longues # p\u00e9riodes) de l'\u00e9l\u00e9ment de chauffe. La valeur par d\u00e9faut est 1.0. sensor_type: # Type de capteur - les thermistances courantes sont \"EPCOS 100K B57560G104F\", # \"ATC Semitec 104GT-2\", \"ATC Semitec 104NT-4-R025H42G\", \"Generic # 3950\", \"Honeywell 100K 135-104LAG-J01\", \"NTC 100K MGB18-104F39050L32\", # \"SliceEngineering 450\", et \"TDK NTCG104LH104JT1\". Voir la section \"Capteurs de # temp\u00e9rature\" pour d'autres capteurs. # Ce param\u00e8tre doit \u00eatre fourni. sensor_pin: # Broche d'entr\u00e9e analogique connect\u00e9e au capteur. Ce param\u00e8tre doit \u00eatre # fourni. #pullup_resistor: 4700 # La r\u00e9sistance (en ohms) du pullup reli\u00e9 \u00e0 la thermistance. # Ce param\u00e8tre n'est valable que si le capteur est une thermistance. La valeur par # d\u00e9faut est 4700 ohms. #smooth_time: 1.0 # Une dur\u00e9e (en secondes) sur laquelle les mesures de temp\u00e9rature seront # liss\u00e9es pour r\u00e9duire l'impact du bruit de la mesure. La valeur par d\u00e9faut # est de 1 seconde. control: # Algorithme de contr\u00f4le (soit pid, soit filigrane (watermark)). Ce param\u00e8tre doit # \u00eatre fourni. pid_Kp: pid_Ki: pid_Kd: # Les param\u00e8tres proportionnels (pid_Kp), int\u00e9graux (pid_Ki) et d\u00e9riv\u00e9s (pid_Kd) du syst\u00e8me de # contr\u00f4le de r\u00e9troaction PID. Klipper \u00e9value les param\u00e8tres PID avec la formule g\u00e9n\u00e9rale suivante : # heater_pwm = (Kp*erreur + Ki*int\u00e9grale(erreur) - Kd*d\u00e9riv\u00e9e(erreur)) / 255 # O\u00f9 \"erreur\" est le r\u00e9sultat de \"requested_temperature - measured_temperature\" et # \"heater_pwm\" est le taux de chauffage demand\u00e9, 0.0 \u00e9tant compl\u00e8tement \u00e9teint et 1.0 \u00e9tant # compl\u00e8tement allum\u00e9. Pensez \u00e0 utiliser la commande PID_CALIBRATE pour obtenir ces param\u00e8tres. # Les param\u00e8tres pid_Kp, pid_Ki, et pid_Kd doivent \u00eatre fournis pour les \u00e9l\u00e9ments de chauffe PID. #max_delta: 2.0 # Sur les \u00e9l\u00e9ments de chauffe contr\u00f4l\u00e9s par un filigrane (watermark), il s'agit du nombre de degr\u00e9s en # Celsius au-dessus de la temp\u00e9rature cible avant de d\u00e9sactiver le chauffage ainsi que le nombre de # degr\u00e9s en dessous de la temp\u00e9rature cible avant la r\u00e9activation du chauffage. La valeur par d\u00e9faut # est de 2 degr\u00e9s Celsius. #pwm_cycle_time: 0.100 # Dur\u00e9e en secondes de chaque cycle PWM logiciel du chauffage. Il n'est # pas recommand\u00e9 de d\u00e9finir cette valeur, sauf s'il existe une exigence # \u00e9lectrique pour commuter le chauffage plus rapidement que 10 fois par seconde. # La valeur par d\u00e9faut est 0,100 seconde. #min_extrude_temp: 170 # La temp\u00e9rature minimale (en Celsius) au-dessus de laquelle les commandes de d\u00e9placement de # l'extrudeuse peuvent \u00eatre \u00e9mises. La valeur par d\u00e9faut est 170 Celsius. min_temp: max_temp: # La plage maximale de temp\u00e9ratures valides (en Celsius) dans laquelle l'\u00e9l\u00e9ment de chauffe doit rester. # Ceci contr\u00f4le une fonction de s\u00e9curit\u00e9 impl\u00e9ment\u00e9e dans le code du micro-contr\u00f4leur - si la temp\u00e9rature # mesur\u00e9e sort de cette plage, le microcontr\u00f4leur se met en \u00e9tat d'arr\u00eat. # Ce contr\u00f4le peut aider \u00e0 d\u00e9tecter certaines d\u00e9faillances mat\u00e9rielles de l'\u00e9l\u00e9ment chauffant et/ou du capteur. # D\u00e9finissez cette plage suffisamment large pour que des temp\u00e9ratures raisonnables n'entra\u00eenent pas d'erreur. # Ces param\u00e8tres doivent \u00eatre fournis.","title":"[extruder]"},{"location":"Config_Reference.html#heater_bed","text":"La section heater_bed concerne le lit chauffant. Elle utilise les m\u00eames param\u00e8tres de mise en chauffe que ceux d\u00e9crits dans la section \"extrudeuse\". [heater_bed] heater_pin: sensor_type: sensor_pin: control: min_temp: max_temp: # Voir la section \"extruder\" pour une description des param\u00e8tres ci-dessus.","title":"[heater_bed]"},{"location":"Config_Reference.html#support-du-nivelage-du-lit","text":"","title":"Support du nivelage du lit"},{"location":"Config_Reference.html#bed_mesh","text":"Nivelage du maillage du lit. On peut d\u00e9finir une section de configuration bed_mesh pour activer les transformations de d\u00e9placement qui d\u00e9calent l'axe z en fonction d'un maillage g\u00e9n\u00e9r\u00e9 \u00e0 partir de points palp\u00e9s. Lorsqu'on utilise une sonde pour d\u00e9finir l'origine de l'axe z, il est recommand\u00e9 de d\u00e9finir une section safe_z_home dans printer.cfg pour r\u00e9aliser cette mise \u00e0 l'origine au centre de la zone d'impression. Consultez le guide du maillage du lit et la r\u00e9f\u00e9rence de la commande pour plus d'informations. Exemples visuels : lit rectangulaire, probe_count = 3, 3: x---x---x (max_point) | x---x---x | (min_point) x---x---x lit circulaire, round_probe_count = 5, bed_radius = r: x (0, r) fin / x---x---x \\ (-r, 0) x---x---x---x---x (r, 0) \\ x---x---x / x (0, -r) d\u00e9but [bed_mesh] #speed: 50 # La vitesse (en mm/s) des d\u00e9placements entre les points de palpage # durant l'\u00e9talonnage. # La valeur par d\u00e9faut est 50. #horizontal_move_z: 5 # La hauteur (en mm) \u00e0 laquelle la t\u00eate doit \u00eatre relev\u00e9e juste avant de # lancer une op\u00e9ration de palpage. La valeur par d\u00e9faut est 5. #mesh_radius: # D\u00e9finit le rayon de la maille \u00e0 palper pour les lits circulaires. Notez que # le rayon est relatif aux coordonn\u00e9es sp\u00e9cifi\u00e9es par l'option # mesh_origin. Ce param\u00e8tre doit \u00eatre fourni pour des lits circulaires # et omis pour des lits rectangulaires. #mesh_origin: # D\u00e9finit les coordonn\u00e9es X, Y du centre du maillage des lits circulaires. Ces # coordonn\u00e9es sont relatives \u00e0 l'emplacement de la sonde. Il peut \u00eatre utile # d'ajuster l'origine du maillage afin de maximiser la taille du rayon du maillage. # La valeur par d\u00e9faut est 0, 0. Ce param\u00e8tre doit \u00eatre omis pour des lits rectangulaires. #mesh_min: # D\u00e9finit les coordonn\u00e9es X, Y minimales du maillage pour les lits rectangulaires. # Ces coordonn\u00e9es sont relatives \u00e0 l'emplacement de la sonde. Cette position # sera le premier point sond\u00e9, le plus proche de l'origine. Ce param\u00e8tre doit # \u00eatre fourni pour des lits rectangulaires. #mesh_max: # D\u00e9finit les coordonn\u00e9es X, Y maximales du maillage pour les lits rectangulaires. # Le principe est le m\u00eame que pour mesh_min, mais ce sera le point le plus \u00e9loign\u00e9 # atteignable par rapport \u00e0 l'origine du lit. Ce param\u00e8tre doit \u00eatre fourni pour # des lits rectangulaires. #probe_count: 3, 3 # Pour les lits rectangulaires, il s'agit d'une paire d'entiers X, Y s\u00e9par\u00e9s par des virgules, # d\u00e9finissant le nombre de points \u00e0 palper le long de chaque axe. # Une valeur seule est \u00e9galement valide, auquel cas cette valeur sera appliqu\u00e9e aux # deux axes. La valeur par d\u00e9faut est 3, 3. #round_probe_count: 5 # Pour les lits circulaires, cette valeur enti\u00e8re d\u00e9finit le nombre maximum de points # \u00e0 palper le long de chaque axe. Cette valeur doit \u00eatre un nombre impair. # La valeur par d\u00e9faut est 5. #fade_start: 1.0 # La position z du gcode \u00e0 partir de laquelle il faut commencer \u00e0 \u00e9liminer progressivement # l'ajustement z lorsque la compensation est activ\u00e9e. La valeur par d\u00e9faut est 1.0. #fade_end: 0.0 # La position z du gcode \u00e0 partir de laquelle la compensation se termine. Lorsqu'elle est # d\u00e9finie \u00e0 une valeur inf\u00e9rieure \u00e0 fade_start, la compensation est d\u00e9sactiv\u00e9e. Notez que # la compensation peut ajouter une mise \u00e0 l'\u00e9chelle ind\u00e9sirable le long de l'axe z d'une impression. # Si un utilisateur souhaite activer la compensation, une valeur de 10.0 est recommand\u00e9e. # La valeur par d\u00e9faut est 0.0, ce qui d\u00e9sactive la compensation. #fade_target: # La position z vers laquelle la compensation doit converger. Lorsque cette valeur est # d\u00e9finie \u00e0 une valeur non nulle, elle doit se situer dans la plage des valeurs z du maillage. # Les utilisateurs qui souhaitent converger vers la position de mise \u00e0 l'origine du Z # doivent r\u00e9gler cette valeur \u00e0 0. # La valeur par d\u00e9faut est la valeur z moyenne du maillage. #split_delta_z: .025 # Le delta de diff\u00e9rence de Z (en mm) le long d'un mouvement qui d\u00e9clenchera une s\u00e9paration. # La valeur par d\u00e9faut est de 0,025. #move_check_distance: 5.0 # La distance (en mm) le long d'un mouvement pour v\u00e9rifier le split_delta_z. # C'est \u00e9galement la longueur minimale pour laquelle un mouvement peut \u00eatre divis\u00e9. # La valeur par d\u00e9faut est 5.0. #mesh_pps: 2, 2 # Une paire de nombres entiers X, Y s\u00e9par\u00e9s par des virgules, d\u00e9finissant le nombre de # points par segment \u00e0 interpoler dans le maillage le long de chaque axe. Un \"segment\" # \u00e9tant d\u00e9fini comme l'espace entre chaque point palp\u00e9. # L'utilisateur peut saisir une seule valeur qui sera appliqu\u00e9e aux deux axes. # La valeur par d\u00e9faut est 2, 2. #algorithme: lagrange # L'algorithme d'interpolation \u00e0 utiliser. Soit \"lagrange\", soit \"bicubic\". Cette option # n'affecte pas les grilles 3x3 forc\u00e9es d'utiliser l'\u00e9chantillonnage de lagrange. # La valeur par d\u00e9faut est lagrange. #bicubic_tension: .2 # Lors de l'utilisation de l'algorithme bicubic, le param\u00e8tre de tension ci-dessus peut # \u00eatre appliqu\u00e9 pour modifier la quantit\u00e9 de pente interpol\u00e9e. # Des nombres plus grands augmenteront la quantit\u00e9 de pente entra\u00eenant une plus grande # courbure du maillage. La valeur par d\u00e9faut est 0,2. #relative_reference_index: # Un index de points dans le maillage auquel r\u00e9f\u00e9rencer toutes les valeurs z. En activant # ce param\u00e8tre, on produit un maillage relatif \u00e0 la position z palp\u00e9e de l'indice fourni. #faulty_region_1_min: #faulty_region_1_max: # Points optionnels d\u00e9finissant une r\u00e9gion d\u00e9fectueuse. Voir docs/Bed_Mesh.md pour # plus de d\u00e9tails sur les r\u00e9gions d\u00e9fectueuses. Jusqu'\u00e0 99 r\u00e9gions d\u00e9fectueuses peuvent # \u00eatre ajout\u00e9es. # Par d\u00e9faut, aucune r\u00e9gion d\u00e9fectueuse n'est d\u00e9finie.","title":"[bed_mesh]"},{"location":"Config_Reference.html#bed_tilt","text":"Compensation de l'inclinaison du lit. On peut d\u00e9finir une section de configuration bed_tilt pour activer les transformations de d\u00e9placement tenant compte d'un lit inclin\u00e9. Notez que bed_mesh et bed_tilt sont incompatibles ; les deux ne peuvent pas \u00eatre d\u00e9finis en m\u00eame temps. Voir la r\u00e9f\u00e9rence des commandes pour plus d'informations. [bed_tilt] #x_adjust: 0 # Quantit\u00e9 \u00e0 ajouter \u00e0 la hauteur Z de chaque mouvement pour chaque mm sur l'axe X. # La valeur par d\u00e9faut est 0. #y_adjust: 0 # Quantit\u00e9 \u00e0 ajouter \u00e0 la hauteur Z de chaque mouvement pour chaque mm sur l'axe Y. # La valeur par d\u00e9faut est 0. #z_adjust: 0 # Quantit\u00e9 \u00e0 ajouter \u00e0 la hauteur Z lorsque la buse est nominalement \u00e0 0, 0. # La valeur par d\u00e9faut est 0. # Les param\u00e8tres suivants contr\u00f4lent la commande g-code \u00e9tendue BED_TILT_CALIBRATE # utilis\u00e9e pour calibrer les param\u00e8tres de r\u00e9glage x et y appropri\u00e9s. #points: # Une liste de coordonn\u00e9es X, Y (une par ligne ; les lignes suivantes indent\u00e9es) devant # \u00eatre palp\u00e9es pendant une commande BED_TILT_CALIBRATE # Sp\u00e9cifiez les coordonn\u00e9es de la buse et assurez-vous que la sonde est au-dessus du lit # aux coordonn\u00e9es donn\u00e9es de la buse. # La valeur par d\u00e9faut est de ne pas activer la commande. #speed: 50 # Vitesse (en mm/s) des mouvements de d\u00e9placements hors palpage pendant l'\u00e9talonnage. # La valeur par d\u00e9faut est 50. #horizontal_move_z: 5 # Hauteur (en mm) \u00e0 laquelle la t\u00eate doit \u00eatre relev\u00e9e lors du d\u00e9placement juste avant # de lancer une op\u00e9ration de palpage. La valeur par d\u00e9faut est 5.","title":"[bed_tilt]"},{"location":"Config_Reference.html#bed_screws","text":"Outil d'aide au r\u00e9glage des vis de nivellement du lit. On peut d\u00e9finir une section de configuration [bed_screws] pour activer une commande g-code BED_SCREWS_ADJUST. Consultez le guide de nivelage et la r\u00e9f\u00e9rence des commandes pour plus d'informations. [bed_screws] #screw1: # Coordonn\u00e9es X, Y de la premi\u00e8re vis de r\u00e9glage du niveau du lit. Il s'agit de la # position vers laquelle d\u00e9placer la buse afin qu'elle soit plac\u00e9e au-dessus de cette # vis de r\u00e9glage (ou aussi proche que possible tout en \u00e9tant au-dessus du lit). # Ce param\u00e8tre doit \u00eatre fourni. #screw1_name: # Un nom arbitraire pour la vis donn\u00e9e. Ce nom est affich\u00e9 lors de # l'ex\u00e9cution du script d'aide. Par d\u00e9faut, le nom utilis\u00e9 est bas\u00e9 sur # la position XY de la vis. #screw1_fine_adjust : # Coordonn\u00e9es X, Y pour commander la buse afin de pouvoir affiner le r\u00e9glage de la vis de mise # \u00e0 niveau du lit. Par d\u00e9faut, il n'y a pas de r\u00e9glage fin sur la vis de mise \u00e0 niveau du lit. #screw2: #screw2_name: #screw2_fine_adjust: #... # Vis suppl\u00e9mentaires de mise \u00e0 niveau du lit. Au moins trois vis doivent \u00eatre # d\u00e9finies. #horizontal_move_z: 5 # Hauteur (en mm) \u00e0 laquelle la t\u00eate doit \u00eatre relev\u00e9e pour se d\u00e9placer # lors du passage d'une vis \u00e0 la suivante. La valeur par d\u00e9faut est 5. #probe_height: 0 # Hauteur de la sonde (en mm) apr\u00e8s ajustement d\u00fb \u00e0 la dilatation thermique # du lit et de la buse. La valeur par d\u00e9faut est z\u00e9ro. #speed: 50 # Vitesse (en mm/s) des d\u00e9placements entre les palpages pendant l'\u00e9talonnage. # La valeur par d\u00e9faut est 50. #probe_speed: 5 # Vitesse (en mm/s) lors du d\u00e9placement d'une position horizontal_move_z # \u00e0 la position probe_height. La valeur par d\u00e9faut est 5.","title":"[bed_screws]"},{"location":"Config_Reference.html#screws_tilt_adjust","text":"Outil d'assistance au nivellement du lit avec les vis de r\u00e9glage et l'aide du palpeur Z. On peut d\u00e9finir une section de configuration screws_tilt_adjust pour activer une commande g-code SCREWS_TILT_CALCULATE. Voir le guide de nivelage et la r\u00e9f\u00e9rence des commandes pour des informations suppl\u00e9mentaires. [screws_tilt_adjust] #screw1: # Les coordonn\u00e9es (X, Y) de la premi\u00e8re vis de mise \u00e0 niveau du lit. Il s'agit d'une # position \u00e0 laquelle d\u00e9placer la buse de mani\u00e8re \u00e0 ce que la sonde soit directement # au-dessus de la vis de mise \u00e0 niveau du lit (ou aussi pr\u00e8s que possible tout en \u00e9tant # encore au-dessus du lit). Il s'agit de la vis de base utilis\u00e9e dans les calculs. # Ce param\u00e8tre doit \u00eatre fourni. #screw1_name: # Un nom arbitraire pour la vis donn\u00e9e. Ce nom est affich\u00e9 lorsque le script d'aide # s'ex\u00e9cute. Par d\u00e9faut, le nom utilis\u00e9 est bas\u00e9 sur la position XY de la vis. #screw2: #screw2_name: #... # Vis suppl\u00e9mentaires de mise \u00e0 niveau du lit. Au moins deux vis doivent \u00eatre # d\u00e9finies. #speed: 50 # La vitesse (en mm/s) des d\u00e9placements sans palpage pendant l'\u00e9talonnage. # La valeur par d\u00e9faut est 50. #horizontal_move_z: 5 # La hauteur (en mm) \u00e0 laquelle la t\u00eate doit \u00eatre lev\u00e9e pour se d\u00e9placer juste # avant de lancer une op\u00e9ration de palpage. La valeur par d\u00e9faut est 5. #screw_thread: CW-M3 # Le type de vis utilis\u00e9e pour le niveau du lit, M3, M4 ou M5 et la direction de la molette # utilis\u00e9e pour le nivelage du lit, diminution dans le sens des aiguilles d'une montre, # augmentation dans le sens inverse des aiguilles d'une montre. # Valeurs accept\u00e9es : CW-M3, CCW-M3, CW-M4, CCW-M4, CW-M5, CCW-M5. # La valeur par d\u00e9faut est CW-M3. De nombreuses imprimantes utilisent une vis M3, # un tour de molette dans le sens des aiguilles d'une montre diminue la distance.","title":"[screws_tilt_adjust]"},{"location":"Config_Reference.html#z_tilt","text":"R\u00e9glage multiples de l'inclinaison de moteurs pas \u00e0 pas de l'axe Z. Cette fonction permet d'ajuster de mani\u00e8re ind\u00e9pendante l'inclinaison de plusieurs moteurs Z (voir la section \"stepper_z1\"). Si cette section est pr\u00e9sente, une commande G-Code \u00e9tendue Z_TILT_ADJUST devient disponible. [z_tilt] #z_positions: # Une liste de coordonn\u00e9es X, Y (une par ligne ; les lignes subs\u00e9quentes # indent\u00e9es) d\u00e9crivant l'emplacement de chaque \"point de pivot\" du lit. # Le \"point de pivot\" est le point o\u00f9 le lit s'attache \u00e0 l'\u00e9l\u00e9ment Z # donn\u00e9. Il est d\u00e9crit \u00e0 l'aide des coordonn\u00e9es de la buse (la position X, Y # de la buse si elle pouvait se d\u00e9placer directement au-dessus du point). La # premi\u00e8re entr\u00e9e correspond \u00e0 stepper_z, la deuxi\u00e8me \u00e0 stepper_z1, # la troisi\u00e8me \u00e0 stepper_z2, etc. Ce param\u00e8tre doit \u00eatre fourni. #points: # Une liste de coordonn\u00e9es X, Y (une par ligne ; les lignes ult\u00e9rieures # indent\u00e9es) qui doivent \u00eatre palp\u00e9es pendant une commande Z_TILT_ADJUST. # Sp\u00e9cifiez les coordonn\u00e9es de la buse et assurez-vous que le palpeur est # au-dessus du lit aux coordonn\u00e9es donn\u00e9es de la buse. # Ce param\u00e8tre doit \u00eatre fourni. #speed: 50 # La vitesse (en mm/s) des mouvements de d\u00e9placements hors palpage # pendant l'\u00e9talonnage. La valeur par d\u00e9faut est 50. #horizontal_move_z: 5 # Hauteur (en mm) \u00e0 laquelle la t\u00eate doit \u00eatre relev\u00e9e pour se d\u00e9placer juste # avant de lancer une op\u00e9ration de palpage. La valeur par d\u00e9faut est 5. #retries: 0 # Nombre de tentatives \u00e0 effectuer si les points palp\u00e9s ne sont pas dans la # tol\u00e9rance. #retry_tolerance: 0 # Si les r\u00e9-essais sont activ\u00e9s, r\u00e9essayer si les points sond\u00e9s les plus grands et # les plus petits diff\u00e8rent plus que la tol\u00e9rance retry_tolerance. Notez que la # plus petite unit\u00e9 de changement ici serait un seul pas. Cependant, si vous # sondez plus de points que de moteurs, il est probable que vous aurez une # valeur minimale fixe pour la plage de points sond\u00e9s. Vous pouvez en # apprendre plus en observant la sortie de la commande.","title":"[z_tilt]"},{"location":"Config_Reference.html#quad_gantry_level","text":"Mise \u00e0 niveau du portique mobile \u00e0 l'aide de 4 moteurs Z contr\u00f4l\u00e9s ind\u00e9pendamment. Corrige les effets de paraboles hyperboliques (chips de pommes de terre) sur un portique mobile qui est plus flexible. AVERTISSEMENT : l'utilisation de cette section sur un lit mobile peut conduire \u00e0 des r\u00e9sultats ind\u00e9sirables. Si cette section est pr\u00e9sente, une commande G-Code \u00e9tendue QUAD_GANTRY_LEVEL devient disponible. Cette routine suppose la configuration suivante des moteurs Z : ---------------- |Z1 Z2| | --------- | | | | | | | | | | x-------- | |Z Z3| ---------------- O\u00f9 x est la position 0, 0 sur le lit [quad_gantry_level] #gantry_corners: # Une liste de coordonn\u00e9es X, Y, s\u00e9par\u00e9es par des retours \u00e0 la ligne, d\u00e9crivant les deux # coins oppos\u00e9s du portique. La premi\u00e8re entr\u00e9e correspond \u00e0 Z, la seconde \u00e0 Z2. # Ce param\u00e8tre doit \u00eatre fourni. #points: # Une liste, s\u00e9par\u00e9e par des retours \u00e0 la ligne, de quatre points X, Y devant \u00eatre palp\u00e9s # pendant une commande QUAD_GANTRY_LEVEL. L'ordre des emplacements est # important, il doit correspondre aux emplacements Z, Z1, Z2 et Z3 dans l'ordre. # Ce param\u00e8tre doit \u00eatre fourni. Pour une pr\u00e9cision maximale, assurez-vous que les # d\u00e9calages de votre sonde sont configur\u00e9s. #speed: 50 # La vitesse (en mm/s) des mouvements sans palpage pendant l'\u00e9talonnage. # La valeur par d\u00e9faut est 50. #horizontal_move_z: 5 # La hauteur (en mm) \u00e0 laquelle la t\u00eate doit \u00eatre relev\u00e9e pour se d\u00e9placer juste # avant de lancer une op\u00e9ration de palpage. La valeur par d\u00e9faut est 5. #max_adjust: 4 # Limite de s\u00e9curit\u00e9 quand un ajustement sup\u00e9rieur \u00e0 cette valeur est demand\u00e9. # quad_gantry_level abandonnera. #retries: 0 # Nombre de tentatives si les points palp\u00e9s ne sont pas dans la tol\u00e9rance. #retry_tolerance: 0 # Si les re-tentatives (retries) sont activ\u00e9es, r\u00e9essayer si les points palp\u00e9s les plus grands # et les plus petits diff\u00e8rent plus que la tol\u00e9rance de re-tentative (retry_tolerance).","title":"[quad_gantry_level]"},{"location":"Config_Reference.html#skew_correction","text":"Correction de l'inclinaison de l'imprimante. Il est possible de corriger l'inclinaison de l'imprimante logiciellement sur 3 plans, xy, xz, yz. Pour ce faire, on imprime un mod\u00e8le d'\u00e9talonnage le long d'un plan et on mesure trois longueurs. En raison de la nature de la correction d'inclinaison, ces longueurs sont d\u00e9finies via le gcode. Voir Correction d'inclinaison et R\u00e9f\u00e9rence des commandes pour plus de d\u00e9tails. [skew_correction]","title":"[skew_correction]"},{"location":"Config_Reference.html#z_thermal_adjust","text":"Ajustement de la position Z de la t\u00eate d'impression en fonction de la temp\u00e9rature. Compenser le mouvement vertical de la t\u00eate d'impression caus\u00e9 par la dilatation thermique du ch\u00e2ssis de l'imprimante en temps r\u00e9el \u00e0 l'aide d'un capteur de temp\u00e9rature (g\u00e9n\u00e9ralement coupl\u00e9 \u00e0 une section verticale du ch\u00e2ssis). Voir aussi : commandes de code G \u00e9tendues . [z_thermal_adjust] #temp_coeff: # Le coefficient de dilatation thermique, en mm/\u00b0C. Par exemple, un # temp_coeff de 0,01 mm/\u00b0C d\u00e9placera l'axe Z vers le bas de 0,01 mm pour # chaque degr\u00e9 Celsius d'augmentation du capteur de temp\u00e9rature. La # valeur par d\u00e9faut, 0,0 mm/\u00b0C, n'applique aucun ajustement. #smooth_time: # Fen\u00eatre de lissage appliqu\u00e9e au capteur de temp\u00e9rature, en secondes. # Peut r\u00e9duire le bruit du moteur d\u00fb \u00e0 de petites corrections excessives en # r\u00e9ponse au bruit du capteur. La valeur par d\u00e9faut est de 2,0 secondes. #z_adjust_off_above: # D\u00e9sactive les ajustements au-dessus de cette hauteur Z [mm]. La derni\u00e8re # correction calcul\u00e9e restera appliqu\u00e9e jusqu'\u00e0 ce que la t\u00eate de l'outil passe # \u00e0 nouveau en dessous de la hauteur Z sp\u00e9cifi\u00e9e. La valeur par d\u00e9faut est # 99999999.0 mm (toujours actif). #max_z_adjustment: # Ajustement absolu maximal pouvant \u00eatre appliqu\u00e9 \u00e0 l'axe Z [mm]. # La valeur par d\u00e9faut est 99999999.0 mm (illimit\u00e9). #sensor_type: #sensor_pin: #min_temp: #max_temp: # Configuration du capteur de temp\u00e9rature. # Voir la section \"extrudeuse\" pour la d\u00e9finition des param\u00e8tres ci-dessus. #gcode_id: # Voir la section \"heater_generic\" pour la d\u00e9finition de ce # param\u00e8tre.","title":"[z_thermal_adjust]"},{"location":"Config_Reference.html#mise-a-lorigine-personnalisee","text":"","title":"Mise \u00e0 l'origine personnalis\u00e9e"},{"location":"Config_Reference.html#safe_z_home","text":"Mise \u00e0 l'origine s\u00fbre de l'axe Z. On peut utiliser ce m\u00e9canisme pour centrer l'axe Z sur des coordonn\u00e9es X, Y sp\u00e9cifiques. Ceci est utile si la t\u00eate de l'outil, par exemple, doit se d\u00e9placer vers le centre du lit avant que l'axe Z puisse \u00eatre mis \u00e0 l'origine. [safe_z_home] home_xy_position: # Une coordonn\u00e9e X, Y (par exemple 100, 100) o\u00f9 la mise \u00e0 l'origine Z doit \u00eatre # effectu\u00e9e. Ce param\u00e8tre doit \u00eatre fourni. #speed: 50.0 # Vitesse \u00e0 laquelle la t\u00eate de l'outil est d\u00e9plac\u00e9e vers la position de r\u00e9f\u00e9rence Z s\u00fbre. # La valeur par d\u00e9faut est 50 mm/s #z_hop: # Distance (en mm) pour lever l'axe Z avant le retour au point d'origine. Cette valeur est # appliqu\u00e9e \u00e0 toute commande d'initialisation, m\u00eame si elle n'initialise pas l'axe Z. # Si l'axe Z est d\u00e9j\u00e0 ramen\u00e9 \u00e0 la position de base et que la position Z actuelle est inf\u00e9rieure # \u00e0 z_hop, alors ceci l\u00e8vera la t\u00eate \u00e0 une hauteur de z_hop. Si l'axe Z n'est pas d\u00e9j\u00e0 centr\u00e9, # la t\u00eate est relev\u00e9e de z_hop. # La valeur par d\u00e9faut est de ne pas impl\u00e9menter le relevage en Z. #z_hop_speed: 15.0 # Vitesse (en mm/s) \u00e0 laquelle l'axe Z est relev\u00e9 avant le retour \u00e0 la position initiale. # La valeur par d\u00e9faut est de 15 mm/s. #move_to_previous: False # Lorsqu'il a la valeur True, les axes X et Y sont r\u00e9initialis\u00e9s \u00e0 leurs positions pr\u00e9c\u00e9dentes apr\u00e8s # retour \u00e0 la position initiale de l'axe Z. La valeur par d\u00e9faut est False.","title":"[safe_z_home]"},{"location":"Config_Reference.html#homing_override","text":"Homing override. On peut utiliser ce m\u00e9canisme pour ex\u00e9cuter une s\u00e9rie de commandes g-code \u00e0 la place d'un G28 trouv\u00e9 dans l'entr\u00e9e g-code normale. Cela peut \u00eatre utile sur les imprimantes qui n\u00e9cessitent une proc\u00e9dure sp\u00e9cifique du retour au point d'origine de la machine. [homing_override] gcode: # Une liste de commandes G-Code \u00e0 ex\u00e9cuter \u00e0 la place des commandes G28 # trouv\u00e9es dans l'entr\u00e9e g-code normale. Voir docs/Command_Templates.md # pour le format G-Code. Si un G28 est contenu dans cette liste de commandes # alors la proc\u00e9dure de mise \u00e0 l'origine de l'imprimante sera invoqu\u00e9e. # Les commandes \u00e9num\u00e9r\u00e9es ici doivent ramener tous les axes \u00e0 la position initiale. # Ce param\u00e8tre doit \u00eatre fourni. #axes: xyz # Les axes \u00e0 remplacer. Par exemple, si ce param\u00e8tre est d\u00e9fini sur \"z\", alors le script # d'annulation ne sera ex\u00e9cut\u00e9 que lorsque l'axe z est mis \u00e0 l'origine (par ex. # une commande \"G28\" ou \"G28 Z\"). Remarque : le script de neutralisation doit # toujours g\u00e9rer tous les axes. La valeur par d\u00e9faut est \"xyz\" ce qui fait que le script # de remplacement sera ex\u00e9cut\u00e9 \u00e0 la place de toutes les commandes G28. #set_position_x: #set_position_y: #set_position_z: # Si sp\u00e9cifi\u00e9, l'imprimante supposera que l'axe est \u00e0 la position sp\u00e9cifi\u00e9e avant # d'ex\u00e9cuter les commandes g-code ci-dessus. Le fait de d\u00e9finir ceci d\u00e9sactive les # contr\u00f4les d'orientation pour cet axe. Cela peut \u00eatre utile si la t\u00eate doit se d\u00e9placer # avant d'invoquer le m\u00e9canisme G28 normal d'un axe. # La valeur par d\u00e9faut est de ne pas forcer une position pour un axe.","title":"[homing_override]"},{"location":"Config_Reference.html#endstop_phase","text":"Interrupteurs de fin de course ajust\u00e9s \u00e0 la phase du moteur pas \u00e0 pas. Pour utiliser cette fonction, d\u00e9finissez une section de configuration avec un pr\u00e9fixe \"endstop_phase\" suivi du nom de la section de configuration du moteur pas \u00e0 pas correspondante (par exemple, \"[endstop_phase stepper_z]\"). Cette fonctionnalit\u00e9 peut am\u00e9liorer la pr\u00e9cision des interrupteurs de fin de course. Ajoutez une d\u00e9claration nue \"[endstop_phase]\" pour activer la commande ENDSTOP_PHASE_CALIBRATE. Voir le guide de d\u00e9tecteurs de fin de course et la r\u00e9f\u00e9rence des commandes pour plus d'informations. [endstop_phase stepper_z] #endstop_accuracy: # D\u00e9finit la pr\u00e9cision attendue (en mm) de la but\u00e9e. Cela repr\u00e9sente la distance d'erreur # maximale que la but\u00e9e peut d\u00e9clencher (par exemple, si une but\u00e9e peut occasionnellement # se d\u00e9clencher 100um en avance ou jusqu'\u00e0 100um en retard alors r\u00e9glez cette valeur # sur 0.200 pour 200um). La valeur par d\u00e9faut est 4*rotation_distance/full_steps_per_rotation. #trigger_phase: # Sp\u00e9cifie la phase du pilote du moteur pas \u00e0 pas \u00e0 attendre lorsque l'on atteint la but\u00e9e. # Compos\u00e9 de deux nombres s\u00e9par\u00e9s par une barre oblique - la phase et le nombre total # de phases (par exemple, \"7/64\"). Ne d\u00e9finissez cette valeur que si vous \u00eates s\u00fbr que le # pilote du moteur pas \u00e0 pas est r\u00e9initialis\u00e9 \u00e0 chaque fois que le mcu est r\u00e9initialis\u00e9. # Si cette valeur n'est pas d\u00e9finie, alors la phase du moteur pas \u00e0 pas sera d\u00e9tect\u00e9e \u00e0 la # premi\u00e8re mise \u00e0 l'origine et cette phase sera utilis\u00e9e sur toutes les origines suivantes. #endstop_align_zero: False # Si vrai, la position_endstop de l'axe sera effectivement modifi\u00e9e de mani\u00e8re \u00e0 ce que la # position z\u00e9ro de l'axe se produise sur un pas complet du moteur pas \u00e0 pas. (Si utilis\u00e9 sur # l'axe Z et que la hauteur de la couche d'impression est un multiple de la distance parcourue # par un pas complet, alors chaque couche se produira sur un pas complet). # La valeur par d\u00e9faut est False.","title":"[endstop_phase]"},{"location":"Config_Reference.html#macros-et-evenements-g-code","text":"","title":"Macros et \u00e9v\u00e9nements G-Code"},{"location":"Config_Reference.html#gcode_macro","text":"Macros G-Code (on peut d\u00e9finir un nombre quelconque de sections avec le pr\u00e9fixe \"gcode_macro\"). Voir le guide des mod\u00e8les de commande pour plus d'informations. [gcode_macro my_cmd] #gcode: # Une liste de commandes G-Code \u00e0 ex\u00e9cuter \u00e0 la place de \"my_cmd\". Voir # docs/Command_Templates.md pour le format G-Code. Ce param\u00e8tre doit # \u00eatre fourni. #variable_<name>: # On peut sp\u00e9cifier un nombre quelconque d'options avec le pr\u00e9fixe \"variable_\". # Le nom de variable donn\u00e9 se verra attribu\u00e9 la valeur donn\u00e9e (analys\u00e9e en tant # que litt\u00e9ral par Python) et sera disponible pendant l'expansion de la macro. # Par exemple, une configuration avec \"variable_fan_speed = 75\" pourrait avoir # des commandes gcode contenant \"M106 S{ fan_speed * 255 }\". Ces variables # peuvent alors \u00eatre modifi\u00e9es au moment de l'ex\u00e9cution en utilisant la commande # SET_GCODE_VARIABLE (voir docs/Command_Templates.md pour plus de d\u00e9tails). # Les noms de variables peuvent ne pas utiliser de caract\u00e8res majuscules. #rename_existing: # Cette option permet \u00e0 la macro de remplacer une commande G-Code existante # et fournira la d\u00e9finition pr\u00e9c\u00e9dente de la commande via le nom fourni ici. Ceci # peut \u00eatre utilis\u00e9 pour remplacer les commandes G-Code originelles. Il convient # d'\u00eatre prudent lorsque l'on remplace des commandes, cela pouvant provoquer # des r\u00e9sultats complexes et inattendus. La valeur par d\u00e9faut est de ne pas # remplacer une commande G-Code existante. #description: Macro G-Code # Ceci ajoutera une courte description utilis\u00e9e \u00e0 la commande HELP ou lors de # l'utilisation de la fonction de compl\u00e9tion automatique. # Par d\u00e9faut : \"G-Code macro\".","title":"[gcode_macro]"},{"location":"Config_Reference.html#delayed_gcode","text":"Ex\u00e9cute un gcode sur un d\u00e9lai d\u00e9fini. Voir le guide des mod\u00e8les de commande et la r\u00e9f\u00e9rence des commandes pour plus d'informations. [delayed_gcode my_delayed_gcode] gcode: # Une liste de commandes G-Code \u00e0 ex\u00e9cuter lorsque la dur\u00e9e du d\u00e9lai est \u00e9coul\u00e9e. # Les mod\u00e8les G-Code sont support\u00e9s. Ce param\u00e8tre doit \u00eatre fourni. #initial_duration: 0.0 # Dur\u00e9e du d\u00e9lai initial (en secondes). Si elle est d\u00e9finie \u00e0 une valeur non nulle, le gcode # diff\u00e9r\u00e9 s'ex\u00e9cutera le nombre de secondes sp\u00e9cifi\u00e9 apr\u00e8s que l'imprimante passe \u00e0 # l'\u00e9tat \"pr\u00eat\". Ceci peut \u00eatre utile pour les proc\u00e9dures d'initialisation ou lors d'une # r\u00e9p\u00e9tition de delayed_gcode. Si la valeur est 0, le delayed_gcode ne sera pas ex\u00e9cut\u00e9 # au d\u00e9marrage. # La valeur par d\u00e9faut est 0.","title":"[delayed_gcode]"},{"location":"Config_Reference.html#save_variables","text":"Prise en charge de l'enregistrement des variables sur le disque afin qu'elles soient conserv\u00e9es lors des red\u00e9marrages. Voir mod\u00e8les de commande et r\u00e9f\u00e9rence G-code pour plus d'informations. [save_variables] filename: # Obligatoire - fournir un nom de fichier utilis\u00e9 pour enregistrer les variables # sur le disque, par exemple ~/variables.cfg.","title":"[save_variables]"},{"location":"Config_Reference.html#idle_timeout","text":"D\u00e9lai d'inactivit\u00e9. Un d\u00e9lai d'inactivit\u00e9 est automatiquement activ\u00e9 - ajoutez une section de configuration idle_timeout explicite pour modifier les param\u00e8tres par d\u00e9faut. [idle_timeout] #gcode: # Une liste de commandes G-Code \u00e0 ex\u00e9cuter lors d'un d\u00e9lai d'inactivit\u00e9. Voir # docs/Command_Templates.md pour le format G-Code. La valeur par d\u00e9faut # est d'ex\u00e9cuter \"TURN_OFF_HEATERS\" et \"M84\". #timeout: 600 # Dur\u00e9e d'attente (en secondes) avant d'ex\u00e9cuter les commandes G-Code ci-dessus. # La valeur par d\u00e9faut est de 600 secondes.","title":"[idle_timeout]"},{"location":"Config_Reference.html#fonctionnalites-optionnelles-du-g-code","text":"","title":"Fonctionnalit\u00e9s optionnelles du G-code"},{"location":"Config_Reference.html#virtual_sdcard","text":"Une carte SD virtuelle peut \u00eatre utile si la machine h\u00f4te n'est pas assez rapide pour faire fonctionner OctoPrint correctement. Elle permet au logiciel h\u00f4te Klipper d'imprimer directement les fichiers gcode stock\u00e9s dans un r\u00e9pertoire sur l'h\u00f4te en utilisant les commandes G-Code standard de la carte SD (par exemple, M24). [virtual_sdcard] path: # Le chemin d'acc\u00e8s au r\u00e9pertoire local sur la machine h\u00f4te de recherche # des fichiers g-code. Il s'agit d'un r\u00e9pertoire en lecture seule (les \u00e9critures # de fichiers sur une carte SD ne sont pas support\u00e9es). On peut le faire pointer # vers le r\u00e9pertoire de t\u00e9l\u00e9chargement d'OctoPrint (g\u00e9n\u00e9ralement # ~/.octoprint/uploads/ ). Ce param\u00e8tre doit \u00eatre fourni. #on_error_gcode: # Une liste de commandes G-Code \u00e0 ex\u00e9cuter lorsqu'une erreur est signal\u00e9e.","title":"[virtual_sdcard]"},{"location":"Config_Reference.html#sdcard_loop","text":"Certaines imprimantes dot\u00e9es de fonctions d'\u00e9jections des pi\u00e8ces imprim\u00e9es, comme un \u00e9jecteur de pi\u00e8ces ou une imprimante \u00e0 courroie, peuvent trouver une utilit\u00e9 dans la mise en boucle de sections du fichier de la carte SD (par exemple, pour imprimer la m\u00eame pi\u00e8ce encore et encore, ou r\u00e9p\u00e9ter une section d'une pi\u00e8ce pour une cha\u00eene ou un autre motif r\u00e9p\u00e9t\u00e9). Voir la r\u00e9f\u00e9rence des commandes pour les commandes prises en charge. Voir le fichier sample-macros.cfg pour une macro G-Code compatible avec le M808 de Marlin. [sdcard_loop]","title":"[sdcard_loop]"},{"location":"Config_Reference.html#force_move","text":"Support des d\u00e9placements manuels des moteurs pas \u00e0 pas \u00e0 des fins de diagnostic. Remarque : l'utilisation de cette fonction peut placer l'imprimante dans un \u00e9tat invalide - consultez la r\u00e9f\u00e9rence de la commande pour obtenir des d\u00e9tails importants. [force_move] #enable_force_move: False # D\u00e9fini \u00e0 true pour activer les commandes G-Code \u00e9tendues FORCE_MOVE et # SET_KINEMATIC_POSITION # La valeur par d\u00e9faut est false.","title":"[force_move]"},{"location":"Config_Reference.html#pause_resume","text":"Fonctionnalit\u00e9 Pause/Reprise avec prise en charge de la capture et de la restauration de position. Voir la r\u00e9f\u00e9rence de la commande pour plus d'informations. [pause_resume] #recover_velocity: 50. # Lorsque la capture/restauration est activ\u00e9e, la vitesse \u00e0 laquelle retourner \u00e0 # la position captur\u00e9e (en mm/s). La valeur par d\u00e9faut est 50,0 mm/s.","title":"[pause_resume]"},{"location":"Config_Reference.html#firmware_retraction","text":"R\u00e9traction du filament par le firmware. Cela permet d'activer les commandes GCODE G10 (r\u00e9traction) et G11 (d\u00e9-r\u00e9traction) \u00e9mises par de nombreux trancheurs. Les param\u00e8tres ci-dessous fournissent des valeurs par d\u00e9faut au d\u00e9marrage, ces valeurs peuvent \u00eatre ajust\u00e9es via la commande SET_RETRACTION , ce qui permet des r\u00e9glages par filament et des ajustements en cours d'impression. [firmware_retraction] #retract_length: 0 # La longueur du filament (en mm) \u00e0 r\u00e9tracter lorsque G10 est activ\u00e9, et \u00e0 fournir # lorsque G11 est activ\u00e9 (voir unretract_extra_length ci-dessous). # La valeur par d\u00e9faut est 0 mm. #retract_speed: 20 # La vitesse de r\u00e9traction, en mm/s. La valeur par d\u00e9faut est 20 mm/s. #unretract_extra_length: 0 # Longueur (en mm) de filament *suppl\u00e9mentaire* \u00e0 ajouter lors de la d\u00e9-r\u00e9traction. #unretract_speed: 10 # La vitesse de d\u00e9-r\u00e9traction, en mm/s. La valeur par d\u00e9faut est 10 mm/s.","title":"[firmware_retraction]"},{"location":"Config_Reference.html#gcode_arcs","text":"Support des commandes gcode de courbes (arc) (G2/G3). [gcode_arcs] #resolution: 1.0 # Un arc sera divis\u00e9 en segments. La longueur de chaque segment sera \u00e9gale \u00e0 # la r\u00e9solution en mm d\u00e9finie ci-dessus. Des valeurs plus faibles produiront un # arc plus fin, mais \u00e9galement plus de travail de votre machine. Les arcs plus # petits que la valeur configur\u00e9e deviendront des lignes droites. La valeur par # d\u00e9faut est 1 mm.","title":"[gcode_arcs]"},{"location":"Config_Reference.html#respond","text":"Active les commandes \u00e9tendues \"M118\" et \"RESPOND\" . [respond] #default_type: echo # D\u00e9finit le pr\u00e9fixe par d\u00e9faut de la sortie \"M118\" et \"RESPOND\" \u00e0 l'un des # \u00e9l\u00e9ments suivants : # echo: \"echo : \" (C'est la valeur par d\u00e9faut) # command: \"// \" # error: \" !! \" #default_prefix: echo: # D\u00e9finit directement le pr\u00e9fixe par d\u00e9faut. Si elle est pr\u00e9sente, cette valeur # remplacera celle de \"default_type\".","title":"[respond]"},{"location":"Config_Reference.html#exclude_object","text":"Permet de prendre en charge l'exclusion ou l'annulation d'objets individuels pendant le processus d'impression. Voir le guide des objets exclus et la r\u00e9f\u00e9rence des commandes pour plus d'informations. Voir le fichier sample-macros.cfg pour une macro G-Code M486 compatible avec Marlin/RepRapFirmware. [exclude_object]","title":"[exclude_object]"},{"location":"Config_Reference.html#compensation-de-la-resonance","text":"","title":"Compensation de la r\u00e9sonance"},{"location":"Config_Reference.html#input_shaper","text":"Active la compensation de r\u00e9sonance . Voir \u00e9galement la r\u00e9f\u00e9rence des commandes . [input_shaper] #shaper_freq_x: 0 # Fr\u00e9quence (en Hz) de la mise en forme de l'entr\u00e9e pour l'axe X. Il s'agit g\u00e9n\u00e9ralement # d'une fr\u00e9quence de r\u00e9sonance de l'axe X que la mise en forme de l'entr\u00e9e doit supprimer. # Pour les mises en forme plus complexes, comme les mises en forme \u00e0 2 ou 3 bosses EI # (2hump/3hump), ce param\u00e8tre peut \u00eatre d\u00e9fini \u00e0 partir de diff\u00e9rentes consid\u00e9rations. # La valeur par d\u00e9faut est 0, ce qui d\u00e9sactive la mise en forme de l'entr\u00e9e pour l'axe X. #shaper_freq_y: 0 # Fr\u00e9quence (en Hz) de la mise en forme de l'entr\u00e9e pour l'axe Y. Il s'agit g\u00e9n\u00e9ralement # d'une fr\u00e9quence de r\u00e9sonance de l'axe Y que la mise en forme de l'entr\u00e9e doit supprimer. # Pour les mises en forme plus complexes, comme les mises en forme \u00e0 2 ou 3 bosses EI # (2hump/3hump), ce param\u00e8tre peut \u00eatre d\u00e9fini \u00e0 partir de diff\u00e9rentes consid\u00e9rations. # La valeur par d\u00e9faut est 0, ce qui d\u00e9sactive la mise en forme de l'entr\u00e9e pour l'axe Y. #shaper_type: mzv # Le type de mise en forme de l'entr\u00e9e \u00e0 utiliser pour les axes X et Y. Les types support\u00e9s # sont zv, mzv, zvd, ei, 2hump_ei, et 3hump_ei. # La valeur par d\u00e9faut est la compensation de r\u00e9sonance mzv. #shaper_type_x: #shaper_type_y: # Si shaper_type n'est pas d\u00e9fini, ces deux param\u00e8tres peuvent \u00eatre utilis\u00e9s pour configurer # des formes d'entr\u00e9e diff\u00e9rentes pour les axes X et Y. Les valeurs support\u00e9es sont les # m\u00eames que celles du param\u00e8tre shaper_type. #damping_ratio_x: 0.1 #damping_ratio_y: 0.1 # Taux d'amortissement des vibrations des axes X et Y utilis\u00e9s par les dispositifs de mise # en forme de l'entr\u00e9e afin d'am\u00e9liorer la suppression des vibrations. La valeur par d\u00e9faut est # 0.1 ce qui est une bonne valeur g\u00e9n\u00e9rale pour la plupart des imprimantes. Dans la plupart # des cas, ce param\u00e8tre ne n\u00e9cessite aucun r\u00e9glage et ne doit pas \u00eatre modifi\u00e9.","title":"[input_shaper]"},{"location":"Config_Reference.html#adxl345","text":"Support des acc\u00e9l\u00e9rom\u00e8tres ADXL345. Ce support permet d'interroger les mesures de l'acc\u00e9l\u00e9rom\u00e8tre \u00e0 partir du capteur. Cela active une commande ACCELEROMETER_MEASURE (voir G-Codes pour plus d'informations). Le nom de la puce par d\u00e9faut est \"default\", mais on peut sp\u00e9cifier un nom explicite (par exemple, [adxl345 my_chip_name]). [adxl345] cs_pin: # La broche d'activation SPI du capteur. Ce param\u00e8tre doit \u00eatre fourni. #spi_speed: 5000000 # La vitesse SPI (en hz) \u00e0 utiliser lors de la communication avec la puce. # La valeur par d\u00e9faut est 5000000. #spi_bus: #spi_software_sclk_pin: #spi_software_mosi_pin: #spi_software_miso_pin: # Voir la section \"param\u00e8tres SPI communs\" pour une description des # param\u00e8tres ci-dessus. #axes_map : x, y, z # L'axe de l'acc\u00e9l\u00e9rom\u00e8tre de chacun des axes X, Y et Z de l'imprimante. # Ceci peut \u00eatre utile si l'acc\u00e9l\u00e9rom\u00e8tre est mont\u00e9 dans une orientation # qui ne correspond pas \u00e0 celle de l'imprimante. Par exemple, on peut # r\u00e9gler cette option sur \"y, x, z\" pour permuter les axes X et Y. # Il est \u00e9galement possible d'inverser un axe si la direction de l'acc\u00e9l\u00e9rom\u00e8tre # est invers\u00e9e (par exemple, \"x, z, -y\"). La valeur par d\u00e9faut est \"x, y, z\". #Rate: 3200 # D\u00e9bit de donn\u00e9es de sortie pour ADXL345. ADXL345 prend en charge les d\u00e9bits # de donn\u00e9es suivants : 3200, 1600, 800, 400, 200, 100, 50, et 25. Notez qu'il n'est # pas recommand\u00e9 de changer ce d\u00e9bit par rapport au d\u00e9bit par d\u00e9faut de 3200, # les d\u00e9bits inf\u00e9rieurs \u00e0 800 affecteront consid\u00e9rablement la qualit\u00e9 des mesures # de r\u00e9sonance.","title":"[adxl345]"},{"location":"Config_Reference.html#mpu9250","text":"Support for MPU-9250, MPU-9255, MPU-6515, MPU-6050, and MPU-6500 accelerometers (one may define any number of sections with an \"mpu9250\" prefix). [mpu9250 my_accelerometer] #i2c_address: # La valeur par d\u00e9faut est 104 (0x68). Si AD0 est \u00e9lev\u00e9, ce sera 0x69 \u00e0 la place. #i2c_mcu: #i2c_bus: #i2c_speed: 400000 # Voir la section \"param\u00e8tres I2C communs\" pour une description des # param\u00e8tres ci-dessus. La valeur par d\u00e9faut de \"i2c_speed\" est 400000. #axes_map: x, y, z # Voir la section \"adxl345\" pour des informations sur ce param\u00e8tre.","title":"[mpu9250]"},{"location":"Config_Reference.html#resonance_tester","text":"Prise en charge du test de r\u00e9sonance et du calibrage automatique du fa\u00e7onneur d'entr\u00e9e (input shaper). Pour utiliser la plupart des fonctionnalit\u00e9s de ce module, des d\u00e9pendances logicielles suppl\u00e9mentaires doivent \u00eatre install\u00e9es ; reportez-vous \u00e0 Mesurer les r\u00e9sonances et \u00e0 la r\u00e9f\u00e9rence de commande pour plus d'informations. Voir la section Adoucissement Max du guide de mesure des r\u00e9sonances pour plus d'informations sur le param\u00e8tre max_smoothing et son utilisation. [resonance_tester] #probe_points: # Une liste de coordonn\u00e9es X, Y, Z de points (un point par ligne) \u00e0 tester. # Au moins un point est requis. Assurez-vous que tous les points avec une certaine marge # de s\u00e9curit\u00e9 dans le plan XY (~ quelques centim\u00e8tres) sont accessibles par la t\u00eate de l'outil. #accel_chip: # Nom de la puce d'acc\u00e9l\u00e9rom\u00e8tre \u00e0 utiliser pour les mesures. Si la puce adxl345 a \u00e9t\u00e9 d\u00e9finie # sans un nom explicite, ce param\u00e8tre peut simplement la r\u00e9f\u00e9rencer en tant que # \"accel_chip : adxl345\", sinon un nom explicite doit \u00eatre fourni, par exemple # \"accel_chip : adxl345 my_chip_name\". Soit ce param\u00e8tre seul, soit les deux param\u00e8tres # suivants doivent \u00eatre d\u00e9finis. #accel_chip_x: #accel_chip_y: # Noms des puces d'acc\u00e9l\u00e9rom\u00e8tre \u00e0 utiliser pour les mesures de chaque axe. # Peut \u00eatre utile, par exemple, sur une imprimante de type \"bed slinger\", si deux acc\u00e9l\u00e9rom\u00e8tres # s\u00e9par\u00e9s sont mont\u00e9s, un sur le lit (pour l'axe Y), l'autre sur la t\u00eate de l'outil (pour l'axe X). # Ces param\u00e8tres ont le m\u00eame format que le param\u00e8tre 'accel_chip'. Soit le param\u00e8tre # 'accel_chip' soit ces deux param\u00e8tres doivent \u00eatre fournis. #max_smoothing: # Lissage maximal du fa\u00e7onneur (shaper) d'entr\u00e9e \u00e0 autoriser pour chaque axe pendant # l'auto-calibration (avec la commande 'SHAPER_CALIBRATE'). Par d\u00e9faut, aucun lissage # maximal n'est sp\u00e9cifi\u00e9. Reportez-vous au guide Measuring_Resonances pour plus de d\u00e9tails # sur l'utilisation de cette fonction. #min_freq: 5 # Fr\u00e9quence minimale de test des r\u00e9sonances. La valeur par d\u00e9faut est 5 Hz. #max_freq: 133.33 # Fr\u00e9quence maximale de test des r\u00e9sonances. La valeur par d\u00e9faut est 133,33 Hz. #accel_per_hz: 75 # Ce param\u00e8tre permet de d\u00e9terminer l'acc\u00e9l\u00e9ration \u00e0 utiliser pour tester une fr\u00e9quence # sp\u00e9cifique: accel = accel_per_hz * freq. Plus haute est cette valeur, plus l'\u00e9nergie des # oscillations est \u00e9lev\u00e9e. Peut \u00eatre fix\u00e9 \u00e0 une valeur inf\u00e9rieure \u00e0 celle par d\u00e9faut si les # r\u00e9sonances deviennent trop fortes sur l'imprimante. Cependant, des valeurs plus faibles # rendent les mesures des r\u00e9sonances \u00e0 haute fr\u00e9quence moins pr\u00e9cises. La valeur par # d\u00e9faut est de 75 (mm/sec). #hz_per_sec: 1 # D\u00e9termine la vitesse de l'essai. Lors du test de toutes les fr\u00e9quences dans la plage [min_freq, # max_freq], chaque seconde, la fr\u00e9quence augmente de hz_per_sec. # De faibles valeurs rendent le test lent, de grandes valeurs diminueront la pr\u00e9cision du test. # La valeur par d\u00e9faut est 1.0 (Hz/sec == sec^-2).","title":"[resonance_tester]"},{"location":"Config_Reference.html#assistants-de-fichiers-de-configuration","text":"","title":"Assistants de fichiers de configuration"},{"location":"Config_Reference.html#board_pins","text":"Alias des broches de la carte (on peut d\u00e9finir un nombre quelconque de sections avec le pr\u00e9fixe \"board_pins\"). Utilisez ceci pour d\u00e9finir des alias de broches d'un micro-contr\u00f4leur. [board_pins my_aliases] mcu: mcu # Une liste de micro-contr\u00f4leurs s\u00e9par\u00e9s par des virgules pouvant utiliser les # alias. La valeur par d\u00e9faut est d'appliquer les alias au \"mcu\" principal. alias: aliases_<nom>: # Une liste s\u00e9par\u00e9e par des virgules d'alias \"nom=valeur\" \u00e0 cr\u00e9er pour le micro- # contr\u00f4leur donn\u00e9. Par exemple, \"EXP1_1=PE6\" cr\u00e9era un alias \"EXP1_1\" pour la # broche \"PE6\". Cependant, si la \"valeur\" est incluse dans \"<>\", alors \"nom\" est cr\u00e9\u00e9 # comme une broche r\u00e9serv\u00e9e (par exemple, \"EXP1_9=<GND>\" r\u00e9serverait \"EXP1_9\"). # Un nombre quelconque d'options commen\u00e7ant par \"alias_\" peuvent \u00eatre sp\u00e9cifi\u00e9es.","title":"[board_pins]"},{"location":"Config_Reference.html#include","text":"Prise en charge de l'inclusion de fichiers. On peut inclure des fichiers de configuration suppl\u00e9mentaires \u00e0 partir du fichier de configuration principal de l'imprimante. Les caract\u00e8res g\u00e9n\u00e9riques peuvent \u00e9galement \u00eatre utilis\u00e9s (par exemple, \"configs/*.cfg\"). [include my_other_config.cfg]","title":"[include]"},{"location":"Config_Reference.html#duplicate_pin_override","text":"Cet outil permet de d\u00e9finir plusieurs fois une m\u00eame broche de microcontr\u00f4leur dans un fichier de configuration sans v\u00e9rification normale des erreurs. Ceci est destin\u00e9 \u00e0 des fins de diagnostic et de d\u00e9bogage. Cette section n'est pas n\u00e9cessaire lorsque Klipper prend en charge l'utilisation de la m\u00eame broche plusieurs fois, et l'utilisation de cette d\u00e9rogation peut entra\u00eener des r\u00e9sultats confus et inattendus. [duplicate_pin_override] pins: # Une liste de broches s\u00e9par\u00e9es par des virgules pouvant \u00eatre utilis\u00e9es plusieurs fois dans # un fichier de configuration sans contr\u00f4les d'erreurs normaux. Ce param\u00e8tre doit \u00eatre # fourni.","title":"[duplicate_pin_override]"},{"location":"Config_Reference.html#materiel-de-nivelage-du-lit","text":"","title":"Mat\u00e9riel de nivelage du lit"},{"location":"Config_Reference.html#probe","text":"Sonde de hauteur Z. On peut d\u00e9finir cette section pour activer le mat\u00e9riel de nivellement de l'axe Z. Lorsque cette section est activ\u00e9e, les commandes g-code \u00e9tendus PROBE et QUERY_PROBE deviennent disponibles. Consultez \u00e9galement le guide d'\u00e9talonnage des sondes . La section probe cr\u00e9e \u00e9galement une broche virtuelle \"probe:z_virtual_endstop\". Il est possible de d\u00e9finir la broche du stepper_z, endstop_pin, sur cette broche virtuelle pour les imprimantes de style cart\u00e9sien qui utilisent la sonde \u00e0 la place d'un interrupteur de fin de course Z. Si vous utilisez \"probe:z_virtual_endstop\", ne d\u00e9finissez pas de position_endstop dans la configuration de la section stepper_z. [probe] pin: # Broche de d\u00e9tection de la sonde. Si la broche se trouve sur un microcontr\u00f4leur diff\u00e9rent # de celui des moteurs de l'axe Z alors elle active le \"multi-mcu homing\". Ce param\u00e8tre # doit \u00eatre fourni. #deactivate_on_each_sample: True # Ceci d\u00e9termine si Klipper doit ex\u00e9cuter le gcode de d\u00e9sactivation entre chaque tentative # de palpage lors d'une s\u00e9quence de palpages multiples. # La valeur par d\u00e9faut est True. #x_offset: 0.0 # La distance (en mm) entre la sonde et la buse le long de l'axe x. # La valeur par d\u00e9faut est 0. #y_offset: 0.0 # La distance (en mm) entre la sonde et la buse le long de l'axe y. # La valeur par d\u00e9faut est 0. z_offset: # La distance (en mm) entre le lit et la buse lorsque la sonde se d\u00e9clenche. # Ce param\u00e8tre doit \u00eatre fourni. #speed: 5.0 # Vitesse (en mm/s) de l'axe Z lors du palpage. La valeur par d\u00e9faut est 5mm/s. #samples: 1 # Le nombre de fois o\u00f9 il faut palper chaque point. Les valeurs z palp\u00e9es seront # moyenn\u00e9es. La valeur par d\u00e9faut est de palper 1 fois. #sample_retract_dist: 2.0 # Distance (en mm) \u00e0 parcourir pour relever la t\u00eate de l'outil entre chaque palpage # (en cas d'\u00e9chantillonnage multiple). La valeur par d\u00e9faut est 2mm. #lift_speed: # Vitesse (en mm/s) de l'axe Z lors du levage de la sonde entre les \u00e9chantillons. # La valeur par d\u00e9faut est la m\u00eame que celle du param\u00e8tre 'speed'. #samples_result: average # La m\u00e9thode de calcul lorsque l'on \u00e9chantillonne plusieurs fois - soit \"m\u00e9diane\" # (median) ou \"moyenne\" (average). La valeur par d\u00e9faut est \"moyenne\". #samples_tolerance: 0.100 # La distance Z maximale (en mm) \u00e0 laquelle un \u00e9chantillon peut diff\u00e9rer des autres # \u00e9chantillons. Si cette tol\u00e9rance est d\u00e9pass\u00e9e, soit une erreur est signal\u00e9e soit une # tentative de palpage est recommenc\u00e9e (cf. samples_tolerance_retries). # La valeur par d\u00e9faut est 0.100mm. #samples_tolerance_retries: 0 # Le nombre de fois qu'il faut r\u00e9essayer quand un palpage d\u00e9passe la tol\u00e9rance des # \u00e9chantillons. Lors d'une nouvelle tentative, tous les \u00e9chantillons en cours sont rejet\u00e9s # et une tentative de palpa est relanc\u00e9e. Si un ensemble valide d'\u00e9chantillons n'est pas # obtenu dans le nombre de tentatives donn\u00e9, une erreur est signal\u00e9e. La valeur par d\u00e9faut # est z\u00e9ro, ce qui entra\u00eene le signalement d'une erreur d\u00e8s le premier \u00e9chantillon d\u00e9passant # la tol\u00e9rance de samples_tolerance. #activate_gcode: # Une liste de commandes G-Code \u00e0 ex\u00e9cuter avant chaque tentative de palpage. # Voir docs/Command_Templates.md pour le format G-Code. Cela peut \u00eatre utile si la sonde # doit \u00eatre activ\u00e9e d'une mani\u00e8re particuli\u00e8re. Ne pas envoyer ici de commandes d\u00e9pla\u00e7ant # la t\u00eate de l'outil (par exemple, G1). La valeur par d\u00e9faut est de ne pas ex\u00e9cuter de commandes # G-code sp\u00e9ciales lors de l'activation. #deactivate_gcode: # Une liste de commandes G-Code \u00e0 ex\u00e9cuter apr\u00e8s la fin de chaque tentative de palpage # termin\u00e9e. Voir docs/Command_Templates.md pour le format G-Code. Ne pas envoyer ici # de commandes d\u00e9pla\u00e7ant la t\u00eate de l'outil. La valeur par d\u00e9faut est de ne pas ex\u00e9cuter de # commandes G-code sp\u00e9ciales lors de la d\u00e9sactivation.","title":"[probe]"},{"location":"Config_Reference.html#bltouch","text":"Sonde BLTouch. On peut d\u00e9finir cette section (au lieu d'une section probe) pour activer une sonde BLTouch. Voir Guide BL-Touch et R\u00e9f\u00e9rence des commandes pour plus d'informations. Une broche virtuelle \"probe:z_virtual_endstop\" est \u00e9galement cr\u00e9\u00e9e (voir la section \"probe\" pour les d\u00e9tails). [bltouch] sensor_pin: # Broche connect\u00e9e \u00e0 la broche du capteur (sensor) BLTouch. La plupart des BLTouch # exigent un pullup sur la broche du capteur (pr\u00e9fixez le nom de la broche par \"^\"). # Ce param\u00e8tre doit \u00eatre fourni. control_pin: # Broche connect\u00e9e \u00e0 la broche de commande du BLTouch. # Ce param\u00e8tre doit \u00eatre fourni. #pin_move_time: 0.680 # Dur\u00e9e d'attente (en secondes) pour que la broche BLTouch se d\u00e9place vers # le haut ou le bas. La valeur par d\u00e9faut est de 0,680 seconde. #stow_on_each_sample: True # D\u00e9termine si Klipper doit ordonner \u00e0 la broche de se d\u00e9placer vers le haut entre # chaque palpage lors d'une s\u00e9quence de palpages multiples. # Lisez les instructions dans docs/BLTouch.md avant de r\u00e9gler ce param\u00e8tre \u00e0 False. # La valeur par d\u00e9faut est True. #probe_with_touch_mode: False # Si ce param\u00e8tre est d\u00e9fini sur True, Klipper palpera avec le p\u00e9riph\u00e9rique en # \"touch_mode\". La valeur par d\u00e9faut est False (palpage en mode \"pin_down\"). #pin_up_reports_not_triggered: True # D\u00e9finit si le BLTouch rapporte syst\u00e9matiquement le palpeur dans un \u00e9tat \"non # d\u00e9clench\u00e9\" apr\u00e8s une commande \"pin_up\" r\u00e9ussie. Ceci devrait \u00eatre True pour # tous les BLTouch authentiques. Lisez les instructions de docs/BLTouch.md avant # de r\u00e9gler cette valeur \u00e0 False. La valeur par d\u00e9faut est True. #pin_up_touch_mode_reports_triggered: True # D\u00e9finit si le BLTouch rapporte syst\u00e9matiquement un \u00e9tat \"d\u00e9clench\u00e9\" apr\u00e8s la # commande \"pin_up_mode_reports_triggered\". Ceci devrait \u00eatre True pour tous les # BLTouch authentiques. Lisez les instructions de docs/BLTouch.md avant de r\u00e9gler # cette valeur \u00e0 False. La valeur par d\u00e9faut est True. #set_output_mode: # Demande un mode de sortie particulier de la broche du capteur sur un BLTouch V3.0 # (et ult\u00e9rieurs). Ce param\u00e8tre ne doit pas \u00eatre utilis\u00e9 sur d'autres types de sondes. # R\u00e9glez sur \"5V\" pour demander une sortie de 5 Volts de la broche du capteur (\u00e0 n'utiliser # que si la carte contr\u00f4leur n\u00e9cessite le mode 5V et est tol\u00e9rante \u00e0 5V sur sa ligne de signal # d'entr\u00e9e). R\u00e9glez sur \"OD\" pour demander l'utilisation de la sortie de la broche du capteur # en mode drain ouvert. La valeur par d\u00e9faut est de ne pas demander de mode de sortie. #x_offset: #y_offset: #z_offset: #speed: #lift_speed: #samples: #sample_retract_dist: #samples_result: #samples_tolerance: #samples_tolerance_retries: # Voir la section \"probe\" pour des informations sur ces param\u00e8tres.","title":"[bltouch]"},{"location":"Config_Reference.html#smart_effector","text":"Le \"Smart Effector\" de Duet3d impl\u00e9mente une sonde Z utilisant un capteur de force. On peut d\u00e9finir cette section \u00e0 la place de [probe] pour activer les fonctionnalit\u00e9s sp\u00e9cifiques du Smart Effector. Cela permet \u00e9galement d'activer les commandes d'ex\u00e9cution afin d'ajuster les param\u00e8tres du Smart Effector au moment de son ex\u00e9cution. [smart_effector] pin: # Broche connect\u00e9e \u00e0 la broche de sortie de la sonde Z de Smart Effector (broche 5). Notez qu' une # r\u00e9sistance de tirage (pullup) sur la carte n'est g\u00e9n\u00e9ralement pas n\u00e9cessaire. Cependant, si la broche # de sortie est connect\u00e9e \u00e0 la broche de la carte \u00e0 l'aide d'une r\u00e9sistance de tirage, cette r\u00e9sistance doit # \u00eatre de valeur \u00e9lev\u00e9e (par ex. 10K Ohm ou plus). Certaines cartes ont une r\u00e9sistance de tirage de faible # valeur sur l'entr\u00e9e de la sonde Z, ce qui entra\u00eenera probablement un \u00e9tat de sonde toujours d\u00e9clench\u00e9. # Dans ce cas, connectez le Smart Effector \u00e0 une autre broche sur la carte. Ce param\u00e8tre est n\u00e9cessaire. #control_pin: # Broche connect\u00e9e \u00e0 la broche d'entr\u00e9e de contr\u00f4le du Smart Effector (broche 7). Si elle est fournie, # les commandes de programmation de la sensibilit\u00e9 du Smart Effector deviennent disponibles. #probe_accel: # Si elle est d\u00e9finie, limite l'acc\u00e9l\u00e9ration des mouvements de palpage (en mm/sec^2). # Une grande acc\u00e9l\u00e9ration soudaine au d\u00e9but du mouvement de palpage peut provoquer des # d\u00e9clenchements intempestifs de la sonde, surtout si la t\u00eate de l'outil est lourde. # Pour \u00e9viter cela, il peut \u00eatre n\u00e9cessaire de r\u00e9duire l'acc\u00e9l\u00e9ration des mouvements de palpage # via ce param\u00e8tre. #recovery_time: 0.4 # D\u00e9lai entre les mouvements de d\u00e9placement et les mouvements de palpage en secondes. Un # d\u00e9placement rapide avant le palpage peut entra\u00eener un d\u00e9clenchement intempestif de celui-ci. # Cela peut provoquer des erreurs 'Probe triggered prior to movement' si aucun d\u00e9lai n'est d\u00e9fini. # La valeur 0 d\u00e9sactive le d\u00e9lai de r\u00e9cup\u00e9ration. # La valeur par d\u00e9faut est 0,4. #x_offset: #y_offset: # Doivent \u00eatre laiss\u00e9s non d\u00e9finis (ou d\u00e9finis \u00e0 0). z_offset: # Hauteur de d\u00e9clenchement de la sonde. Commencez avec -0,1 (mm), et ajustez plus tard en # utilisant la commande `PROBE_CALIBRATE`. Ce param\u00e8tre doit \u00eatre fourni. #speed: # Vitesse (en mm/s) de l'axe Z lors du palpage. Il est recommand\u00e9 de commencer avec une # vitesse de palpage de 20 mm/s et d'ajuster si n\u00e9cessaire pour am\u00e9liorer la pr\u00e9cision et la # r\u00e9p\u00e9tabilit\u00e9 du d\u00e9clenchement du palpeur. #samples: #sample_retract_dist: #samples_result: #samples_tolerance: #samples_tolerance_retries: #activate_gcode: #deactivate_gcode: #deactivate_on_each_sample: # Voir la section \"sonde\" (probe) pour plus d'informations sur les param\u00e8tres ci-dessus.","title":"[smart_effector]"},{"location":"Config_Reference.html#moteurs-pas-a-pas-et-extrudeurs-additionnels","text":"","title":"Moteurs pas \u00e0 pas et extrudeurs additionnels"},{"location":"Config_Reference.html#stepper_z1","text":"Axes \u00e0 moteurs pas \u00e0 pas multiples. Sur une imprimante de style cart\u00e9sien, le pilote moteur contr\u00f4lant un axe donn\u00e9 peut avoir des blocs de configuration suppl\u00e9mentaires d\u00e9finissant les pilotes moteurs qui doivent \u00eatre mis en marche de concert avec le pilote principal. On peut d\u00e9finir un nombre quelconque de sections avec un suffixe num\u00e9rique commen\u00e7ant \u00e0 1 (par exemple, \"stepper_z1\", \"stepper_z2\", etc.). [stepper_z1] #step_pin: #dir_pin: #enable_pin: #microsteps: #rotation_distanc : # Voir la section \"stepper\" pour la d\u00e9finition des param\u00e8tres ci-dessus. #endstop_pin: # Si une endstop_pin est d\u00e9finie pour le moteur suppl\u00e9mentaire, alors le moteur # se d\u00e9placera \u00e0 l'origine jusqu'\u00e0 ce que la fin de course soit d\u00e9clench\u00e9e. Sinon, le # moteur se d\u00e9placera jusqu'\u00e0 ce que la fin de course du moteur principal de l'axe # soit d\u00e9clench\u00e9e.","title":"[stepper_z1]"},{"location":"Config_Reference.html#extruder1","text":"Dans une imprimante multi-extrudeurs, ajoutez une section d'extrudeur suppl\u00e9mentaire pour chaque extrudeur suppl\u00e9mentaire. Les sections d'extrudeur suppl\u00e9mentaires doivent \u00eatre nomm\u00e9es \"extruder1\", \"extruder2\", \"extruder3\", et ainsi de suite. Voir la section \"extruder\" pour une description des param\u00e8tres disponibles. Voir sample-multi-extruder.cfg pour un exemple de configuration. [extruder1] #step_pin: #dir_pin: #... # Voir la section \"extruder\" pour les param\u00e8tres disponibles pour le pilote de moteur # pas \u00e0 pas et l'\u00e9l\u00e9ment de chauffe. #shared_heater: # Cette option est obsol\u00e8te et ne doit plus \u00eatre utilis\u00e9e.","title":"[extruder1]"},{"location":"Config_Reference.html#dual_carriage","text":"Prise en charge des imprimantes cart\u00e9siennes avec deux chariots sur un seul axe. Le chariot actif est d\u00e9fini par la commande g-code \u00e9tendue SET_DUAL_CARRIAGE. La commande \"SET_DUAL_CARRIAGE CARRIAGE=1\" active le chariot d\u00e9fini dans cette section (CARRIAGE=0 ram\u00e8ne l'activation au chariot principal). Le support du double chariot est g\u00e9n\u00e9ralement combin\u00e9 avec des extrudeuses suppl\u00e9mentaires - la commande SET_DUAL_CARRIAGE est souvent appel\u00e9e en m\u00eame temps que la commande ACTIVATE_EXTRUDER. Veillez \u00e0 garer les chariots pendant la d\u00e9sactivation. Voir sample-idex.cfg pour un exemple de configuration. [dual_carriage] axis: # L'axe sur lequel se trouve ce chariot suppl\u00e9mentaire (soit x, soit y). Ce param\u00e8tre # doit \u00eatre fourni. #step_pin: #dir_pin: #enable_pin: #microsteps: #rotation_distance: #endstop_pin: #position_endstop: #position_min: #position_max: # Voir la section \"stepper\" pour la d\u00e9finition des param\u00e8tres ci-dessus.","title":"[dual_carriage]"},{"location":"Config_Reference.html#extruder_stepper","text":"Support pour des moteurs suppl\u00e9mentaires synchronis\u00e9s avec le mouvement d'une extrudeuse (on peut d\u00e9finir un nombre quelconque de sections avec un pr\u00e9fixe \"extruder_stepper\"). Voir la r\u00e9f\u00e9rence des commandes pour plus d'informations. [extrudeur_stepper my_extra_stepper] extruder: # L'extrudeur sur lequel ce pilote moteur est synchronis\u00e9. Si ce param\u00e8tre est # d\u00e9fini sur une cha\u00eene vide, le pilote ne sera pas synchronis\u00e9 avec un extrudeur. # Ce param\u00e8tre doit \u00eatre fourni. #step_pin: #dir_pin: #enable_pin: #microsteps: #rotation_distance: # Voir la section \"stepper\" pour la d\u00e9finition des param\u00e8tres # ci-dessus.","title":"[extruder_stepper]"},{"location":"Config_Reference.html#manual_stepper","text":"Pilotes de moteur manuels (on peut d\u00e9finir un nombre quelconque de sections avec le pr\u00e9fixe \"manual_stepper\"). Ce sont des pilotes de moteur contr\u00f4l\u00e9s par la commande g-code MANUAL_STEPPER. Par exemple \"MANUAL_STEPPER STEPPER=my_stepper MOVE=10 SPEED=5\". Voir le fichier G-Codes pour une description de la commande MANUAL_STEPPER. Les pilotes de moteur ne sont pas connect\u00e9s \u00e0 la cin\u00e9matique normale de l'imprimante. [manual_stepper my_stepper] #step_pin: #dir_pin: #enable_pin: #microsteps: #rotation_distance: # Voir la section \"stepper\" pour une description de ces param\u00e8tres. #velocity: # D\u00e9finit la vitesse par d\u00e9faut (en mm/s) pour le pilote moteur. Cette valeur # sera utilis\u00e9e si une commande MANUAL_STEPPER ne sp\u00e9cifie pas de param\u00e8tre SPEED # La valeur par d\u00e9faut est 5mm/s. #accel # D\u00e9finit l'acc\u00e9l\u00e9ration par d\u00e9faut (en mm/s^2) pour le pilote moteur Une # acc\u00e9l\u00e9ration de z\u00e9ro n'entra\u00eenera aucune acc\u00e9l\u00e9ration. Cette valeur # sera utilis\u00e9e si une commande MANUAL_STEPPER ne sp\u00e9cifie pas de # param\u00e8tre ACCEL. La valeur par d\u00e9faut est z\u00e9ro. #endstop_pin: # Broche de d\u00e9tection de l'interrupteur de fin de course. Si elle est sp\u00e9cifi\u00e9e, on peut effectuer # des \"mouvements de retour \u00e0 l'origine\" en ajoutant un param\u00e8tre STOP_ON_ENDSTOP aux # commandes de mouvement MANUAL_STEPPER.","title":"[manual_stepper]"},{"location":"Config_Reference.html#elements-chauffants-et-capteurs-personnalises","text":"","title":"\u00c9l\u00e9ments chauffants et capteurs personnalis\u00e9s"},{"location":"Config_Reference.html#verify_heater","text":"V\u00e9rification de l'\u00e9l\u00e9ment chauffant et du capteur de temp\u00e9rature. La v\u00e9rification des \u00e9l\u00e9ments de chauffage est automatiquement activ\u00e9e pour chaque mat\u00e9riel de chauffage configur\u00e9 sur l'imprimante. Utilisez les sections verify_heater pour modifier les param\u00e8tres par d\u00e9faut. [verify_heater heater_config_name] #max_error: 120 # L'erreur de temp\u00e9rature cumul\u00e9e maximale avant de d\u00e9clencher une erreur. # Des valeurs plus petites entra\u00eenent une v\u00e9rification plus stricte et des valeurs # plus grandes permettent un d\u00e9lai plus long avant qu'une erreur ne soit signal\u00e9e. # Plus pr\u00e9cis\u00e9ment, la temp\u00e9rature est inspect\u00e9e une fois par seconde et si elle # est proche de la temp\u00e9rature cible, un \"compteur d'erreurs\" interne est remis # \u00e0 z\u00e9ro; sinon, si la temp\u00e9rature est inf\u00e9rieure \u00e0 la plage cible, le compteur est # augment\u00e9 de la quantit\u00e9 de temp\u00e9rature rapport\u00e9e diff\u00e9rant de cette plage. Si # le compteur d\u00e9passe ce \"max_error\", une erreur est signal\u00e9e. La valeur par # d\u00e9faut est 120. #check_gain_time: # Ceci contr\u00f4le la v\u00e9rification du chauffage durant la chauffe initiale. Des valeurs # plus petites entra\u00eenent une v\u00e9rification plus stricte et des valeurs plus grandes # autorisent un d\u00e9lai plus grand avant qu'une erreur ne soit signal\u00e9e. Sp\u00e9cifiquement, # pendant la chauffe initiale, tant que la temp\u00e9rature de l'\u00e9l\u00e9ment chauffant augmente # durant ce laps de temps (sp\u00e9cifi\u00e9 en secondes), le \"compteur d'erreurs\" interne est # remis \u00e0 z\u00e9ro. La valeur par d\u00e9faut est de 20 secondes pour les extrudeuses et 60 # secondes pour le lit chauffant. #hysteresis: 5 # La diff\u00e9rence de temp\u00e9rature maximale (en Celsius) par rapport \u00e0 une temp\u00e9rature # cible consid\u00e9r\u00e9e comme situ\u00e9e dans la plage de la cible. Ceci contr\u00f4le la v\u00e9rification # de la plage du param\u00e8tre max_error. Il est rare de personnaliser cette valeur. # La valeur par d\u00e9faut est 5. #heating_gain: 2 # La temp\u00e9rature minimale (en Celsius) pour laquelle le chauffage doit progresser # pendant la p\u00e9riode de check_gain_time. Il est rare de personnaliser cette valeur. # La valeur par d\u00e9faut est 2.","title":"[verify_heater]"},{"location":"Config_Reference.html#homing_heaters","text":"Outil de d\u00e9sactivation des \u00e9l\u00e9ments chauffants lors de la prise d'origine ou du palpage d'un axe. [homing_heaters] #steppers: # Une liste de pilotes moteurs s\u00e9par\u00e9s par des virgules qui devraient d\u00e9sactiver les chauffages. # La valeur par d\u00e9faut est de d\u00e9sactiver les chauffages pour tout d\u00e9placement (mise \u00e0 # l'origine / palpage). # Exemple typique : stepper_z #heaters: # Une liste, s\u00e9par\u00e9e par des virgules, d'\u00e9l\u00e9ments chauffants \u00e0 d\u00e9sactiver pendant les d\u00e9placements # (mise \u00e0 l'origine / palpage). La valeur par d\u00e9faut est de d\u00e9sactiver tous les \u00e9l\u00e9ments chauffants. # Exemple typique : extruder, heater_bed","title":"[homing_heaters]"},{"location":"Config_Reference.html#thermistor","text":"Thermistances personnalis\u00e9es (on peut d\u00e9finir un nombre quelconque de sections avec le pr\u00e9fixe \"thermistor\"). Une thermistance personnalis\u00e9e peut \u00eatre utilis\u00e9e dans le champ sensor_type d'une section de configuration de chauffage. (Par exemple, si l'on d\u00e9finit une section \"[thermistor my_thermistor]\", on peut utiliser un \"sensor_type: my_thermistor\" lors de la d\u00e9finition d'un \u00e9l\u00e9ment de chauffe). Veillez \u00e0 placer la section thermistor dans le fichier de configuration avant sa premi\u00e8re utilisation dans une section de chauffage. [thermistor ma_thermistance] #temperature1: #resistance1: #temperature2: #resistance2: #temperature3: #resistance3: # Trois mesures de r\u00e9sistance (en Ohms) aux temp\u00e9ratures donn\u00e9es # (en Celsius). Ces trois mesures seront utilis\u00e9es pour calculer les # coefficients de Steinhart-Hart pour la thermistance. Ces param\u00e8tres # doivent \u00eatre fournis lors de l'utilisation de Steinhart-Hart pour d\u00e9finir la # thermistance. #beta: # Alternativement, on peut d\u00e9finir temp\u00e9rature1, r\u00e9sistance1, et beta # pour d\u00e9finir les param\u00e8tres de la thermistance. Ce param\u00e8tre doit \u00eatre # fourni lorsque l'on utilise \"beta\" pour d\u00e9finir la thermistance.","title":"[thermistor]"},{"location":"Config_Reference.html#adc_temperature","text":"Capteurs de temp\u00e9rature ADC personnalis\u00e9s (on peut d\u00e9finir un nombre quelconque de sections avec un pr\u00e9fixe \"adc_temperature\"). Cela permet de d\u00e9finir un capteur de temp\u00e9rature personnalis\u00e9 mesurant une tension sur une broche de convertisseur analogique-num\u00e9rique (ADC) et utilise une interpolation lin\u00e9aire entre un ensemble de mesures configur\u00e9es de temp\u00e9rature/tension (ou de temp\u00e9rature/r\u00e9sistance) pour d\u00e9terminer la temp\u00e9rature. Le capteur r\u00e9sultant peut \u00eatre utilis\u00e9 comme un type de capteur dans une section de chauffage. (Par exemple, si l'on d\u00e9finit une section \"[adc_temperature my_sensor]\", on peut utiliser un \"sensor_type : my_sensor\" lors de la d\u00e9finition d'un \u00e9l\u00e9ment chauffant). Veillez \u00e0 placer la section du capteur dans le fichier de configuration avant sa premi\u00e8re utilisation dans une section de chauffage. [adc_temperature mon_capteur] #temperature1: #voltage1: #temperature2: #voltage2: #... # Un ensemble de temp\u00e9ratures (en Celsius) et de tensions (en Volts) \u00e0 utiliser comme # r\u00e9f\u00e9rence lors de la conversion d'une temp\u00e9rature. Une section de chauffage utilisant # ce capteur peut \u00e9galement sp\u00e9cifier les param\u00e8tres adc_voltage et voltage_offset # pour d\u00e9finir la tension ADC (voir la section \"Amplificateurs communs de temp\u00e9rature\" # pour plus de d\u00e9tails). Au moins deux mesures doivent \u00eatre fournies. #temperature1: #resistance1: #temperature2: #resistance2: #... # Alternativement, on peut indiquer un ensemble de temp\u00e9ratures (en Celsius) # et de r\u00e9sistance (en Ohms) \u00e0 utiliser comme r\u00e9f\u00e9rence lors de la conversion d'une # temp\u00e9rature. Une section de chauffage utilisant ce capteur peut \u00e9galement sp\u00e9cifier un # param\u00e8tre pullup_resistor (voir la section \"extrudeuse\" pour plus de d\u00e9tails). Au # moins deux mesures doivent \u00eatre fournies.","title":"[adc_temperature]"},{"location":"Config_Reference.html#heater_generic","text":"\u00c9l\u00e9ments de chauffe g\u00e9n\u00e9riques (on peut d\u00e9finir un nombre quelconque de sections avec le pr\u00e9fixe \"heater_generic\"). Ces \u00e9l\u00e9ments de chauffe se comportent de la m\u00eame mani\u00e8re que les \u00e9l\u00e9ments de chauffe standards (extrudeuses, lits chauffants). Utilisez la commande SET_HEATER_TEMPERATURE (voir G-Codes pour plus de d\u00e9tails) pour d\u00e9finir la temp\u00e9rature cible. [heater_generic my_generic_heater] #gcode_id: # L'identifiant \u00e0 utiliser pour signaler la temp\u00e9rature dans la commande M105. # Ce param\u00e8tre doit \u00eatre fourni. #heater_pin: #max_power: #sensor_type: #sensor_pin: #smooth_time: #control: #pid_Kp: #pid_Ki: #pid_Kd: #pwm_cycle_time: #min_temp: #max_temp: # Voir la section \"extruder\" pour la d\u00e9finition des param\u00e8tres # ci-dessus.","title":"[heater_generic]"},{"location":"Config_Reference.html#temperature_sensor","text":"Capteurs de temp\u00e9rature g\u00e9n\u00e9riques. On peut d\u00e9finir un nombre quelconque de capteurs de temp\u00e9rature suppl\u00e9mentaires signal\u00e9s par la commande M105. [temperature_sensor my_sensor] #sensor_type: #sensor_pin: #min_temp: #max_temp: # Voir la section \"extrudeuse\" pour la d\u00e9finition des param\u00e8tres # ci-dessus. #gcode_id: # Voir la section \"heater_generic\" pour la d\u00e9finition de ce # param\u00e8tre.","title":"[temperature_sensor]"},{"location":"Config_Reference.html#capteurs-de-temperature","text":"Klipper inclut les d\u00e9finitions de nombreux types de capteurs de temp\u00e9rature. Ces capteurs peuvent \u00eatre utilis\u00e9s dans n'importe quelle section de la configuration n\u00e9cessitant un capteur de temp\u00e9rature (comme une section [extruder] ou [heater_bed] ).","title":"Capteurs de temp\u00e9rature"},{"location":"Config_Reference.html#thermistances-communes","text":"Thermistances communes. Les param\u00e8tres suivants sont disponibles dans les sections de chauffage utilisant l'un de ces capteurs. sensor_type: # Un parmi \"EPCOS 100K B57560G104F\", \"ATC Semitec 104GT-2\", # \"ATC Semitec 104NT-4-R025H42G\", \"Generic 3950\", # \"Honeywell 100K 135-104LAG-J01\", \"NTC 100K MGB18-104F39050L32\", # \"SliceEngineering 450\", ou \"TDK NTCG104LH104JT1\". sensor_pin: # Broche d'entr\u00e9e analogique connect\u00e9e \u00e0 la thermistance. Ce param\u00e8tre doit # \u00eatre fourni. #pullup_resistor: 4700 # La r\u00e9sistance (en ohms) de tirage (pullup) reli\u00e9e \u00e0 la thermistance. # La valeur par d\u00e9faut est 4700 ohms. #inline_resistor: 0 # La r\u00e9sistance (en ohms) d'une r\u00e9sistance suppl\u00e9mentaire (ne variant pas en fonction de # la chaleur) plac\u00e9e en ligne avec la thermistance. Il est rare de la d\u00e9finir. # La valeur par d\u00e9faut est 0 ohms.","title":"Thermistances communes"},{"location":"Config_Reference.html#amplificateurs-de-temperature-courants","text":"Amplificateurs de temp\u00e9rature courants. Les param\u00e8tres suivants sont disponibles dans les sections de chauffage utilisant l'un de ces capteurs. sensor_type: # Un parmi \"PT100 INA826\", \"AD595\", \"AD597\", \"AD8494\", \"AD8495\", # \"AD8496\", ou \"AD8497\". sensor_pin: # Broche d'entr\u00e9e analogique connect\u00e9e au capteur. Ce param\u00e8tre doit \u00eatre # fourni. #adc_voltage: 5.0 # La tension de comparaison ADC (en Volts). La valeur par d\u00e9faut est de 5 volts. #voltage_offset: 0 # D\u00e9calage de la tension de l'ADC (en Volts). La valeur par d\u00e9faut est 0.","title":"Amplificateurs de temp\u00e9rature courants"},{"location":"Config_Reference.html#capteur-pt1000-directement-connecte","text":"Capteur PT1000 connect\u00e9 en direct. Les param\u00e8tres suivants sont disponibles dans les sections chauffage utilisant ces capteurs. sensor_type : PT1000 sensor_pin: # Broche d'entr\u00e9e analogique connect\u00e9e au capteur. Ce param\u00e8tre doit \u00eatre # fourni. #pullup_resistor: 4700 # La r\u00e9sistance (en ohms) de tirage (pullup) reli\u00e9e au capteur. La valeur par # d\u00e9faut est 4700 ohms.","title":"Capteur PT1000 directement connect\u00e9"},{"location":"Config_Reference.html#capteurs-de-temperature-maxxxxxx","text":"Capteurs MAXxxxxx \u00e0 interface p\u00e9riph\u00e9rique s\u00e9rie (SPI) bas\u00e9s sur la temp\u00e9rature. Les param\u00e8tres suivants sont disponibles dans les sections de chauffage qui utilisent l'un de ces types de capteurs. sensor_type : # Un parmi les types suivants : \"MAX6675\", \"MAX31855\", \"MAX31856\" ou \"MAX31865\". sensor_pin: # La broche de s\u00e9lection de puce pour la puce du capteur. Ce param\u00e8tre doit \u00eatre # fourni. #spi_speed: 4000000 # La vitesse SPI (en hz) \u00e0 utiliser lors de la communication avec la puce. # La valeur par d\u00e9faut est 4000000. #spi_bus: #spi_software_sclk_pin: #spi_software_mosi_pin: #spi_software_miso_pin: # Voir la section \"param\u00e8tres SPI communs\" pour une description des # param\u00e8tres ci-dessus. #tc_type: K #tc_use_50Hz_filter: False #tc_averaging_count: 1 # Les param\u00e8tres ci-dessus contr\u00f4lent les param\u00e8tres des capteurs des puces MAX31856 # Les valeurs par d\u00e9faut de chaque param\u00e8tre sont indiqu\u00e9es \u00e0 c\u00f4t\u00e9 du nom du param\u00e8tre # dans la liste ci-dessus. #rtd_nominal_r: 100 #rtd_reference_r: 430 #rtd_num_of_wires: 2 #rtd_use_50Hz_filter: False # Les param\u00e8tres ci-dessus contr\u00f4lent les param\u00e8tres des capteurs des puces MAX31865 # Les valeurs par d\u00e9faut de chaque param\u00e8tre sont indiqu\u00e9es \u00e0 c\u00f4t\u00e9 du nom du param\u00e8tre # dans la liste ci-dessus.","title":"Capteurs de temp\u00e9rature MAXxxxxx"},{"location":"Config_Reference.html#capteurs-de-temperature-bmp280bme280bme680","text":"Capteurs environnementaux BMP280/BME280/BME680 \u00e0 interface \u00e0 deux fils (I2C). Notez que ces capteurs ne sont pas destin\u00e9s \u00e0 \u00eatre utilis\u00e9s avec des extrudeurs et des lits chauffants, mais plut\u00f4t pour surveiller la temp\u00e9rature ambiante (C), la pression (hPa), l'humidit\u00e9 relative et, dans le cas du BME680, le niveau de gaz. Voir sample-macros.cfg pour un gcode_macro pouvant \u00eatre utilis\u00e9 pour signaler la pression et l'humidit\u00e9 en plus de la temp\u00e9rature. sensor_type: BME280 #i2c_address: # La valeur par d\u00e9faut est 118 (0x76). Certains capteurs BME280 ont une adresse de 119 # (0x77). #i2c_mcu: #i2c_bus: #i2c_speed: # Voir la section \"param\u00e8tres I2C communs\" pour une description des # param\u00e8tres ci-dessus.","title":"Capteurs de temp\u00e9rature BMP280/BME280/BME680"},{"location":"Config_Reference.html#capteur-htu21d","text":"Capteur d'environnement de la famille HTU21D \u00e0 interface \u00e0 deux fils (I2C). Notez que ce capteur n'est pas destin\u00e9 \u00e0 \u00eatre utilis\u00e9 avec les extrudeuses et les lits chauffants, mais plut\u00f4t \u00e0 surveiller la temp\u00e9rature ambiante (C) et l'humidit\u00e9 relative. Voir sample-macros.cfg pour un gcode_macro utilisable permettant d'indiquer l'humidit\u00e9 en plus de la temp\u00e9rature. sensor_type: # Doit \u00eatre \"HTU21D\" , \"SI7013\", \"SI7020\", \"SI7021\" ou \"SHT21\". #i2c_address: # La valeur par d\u00e9faut est 64 (0x40). #i2c_mcu: #i2c_bus: #i2c_speed: # Voir la section \"param\u00e8tres I2C communs\" pour une description des # param\u00e8tres ci-dessus. #htu21d_hold_master: # Si le capteur peut maintenir le tampon I2C durant la lecture. Si True, aucune autre # communication par bus ne peut \u00eatre effectu\u00e9e durant la lecture en cours. # La valeur par d\u00e9faut est False. #htu21d_resolution: # La r\u00e9solution de lecture de la temp\u00e9rature et de l'humidit\u00e9. # Les valeurs valides sont : # 'TEMP14_HUM12' -> 14 bits pour la temp\u00e9rature et 12 bits pour l'humidit\u00e9. # 'TEMP13_HUM10' -> 13 bits pour la temp\u00e9rature et 10 bits pour l'humidit\u00e9. # 'TEMP12_HUM08' -> 12 bits pour la temp\u00e9rature et 08 bits pour l'humidit\u00e9 # 'TEMP11_HUM11' -> 11 bits pour la temp\u00e9rature et 11 bits pour l'humidit\u00e9 # La valeur par d\u00e9faut est \"TEMP11_HUM11\" #htu21d_report_time: # Intervalle en secondes entre les lectures. La valeur par d\u00e9faut est 30","title":"Capteur HTU21D"},{"location":"Config_Reference.html#capteur-de-temperature-lm75","text":"Capteurs de temp\u00e9rature LM75/LM75A connect\u00e9s en deux fils (I2C). Ces capteurs ont une gamme de -55~125 \u00b0C, et sont donc utilisables par exemple pour la surveillance de la temp\u00e9rature d'une chambre. Ils peuvent aussi fonctionner comme de simples contr\u00f4leurs de ventilateurs/\u00e9l\u00e9ments chauffants. sensor_type: LM75 #i2c_address: # La valeur par d\u00e9faut est 72 (0x48). La plage normale est 72-79 (0x48-0x4F), les 3 # bits de poids faible de l'adresse sont configur\u00e9s via des broches sur la puce # (g\u00e9n\u00e9ralement avec des cavaliers ou c\u00e2bl\u00e9s). #i2c_mcu: #i2c_bus: #i2c_speed: # Voir la section \"param\u00e8tres I2C communs\" pour une description des # param\u00e8tres ci-dessus. #lm75_report_time: # Intervalle en secondes entre les lectures. La valeur par d\u00e9faut est 0.8, avec un # minimum de 0.5.","title":"Capteur de temp\u00e9rature LM75"},{"location":"Config_Reference.html#capteur-de-temperature-integre-au-microcontroleur","text":"Les micro-contr\u00f4leurs atsam, atsamd, et stm32 poss\u00e8dent un capteur de temp\u00e9rature interne. On peut utiliser le capteur \"temperature_mcu\" pour surveiller ces temp\u00e9ratures. sensor_type: temperature_mcu #sensor_mcu: mcu # Le micro-contr\u00f4leur \u00e0 lire. La valeur par d\u00e9faut est \"mcu\". #sensor_temperature1: #sensor_adc1: # Sp\u00e9cifiez les deux param\u00e8tres ci-dessus (une temp\u00e9rature en Celsius et une valeur d' ADC sous # forme de flottant entre 0,0 et 1,0) pour calibrer la temp\u00e9rature du microcontr\u00f4leur. Cela peut # am\u00e9liorer la pr\u00e9cision de la temp\u00e9rature rapport\u00e9e sur certaines puces. Une fa\u00e7on typique d'obtenir # ces informations d'\u00e9talonnage est de couper compl\u00e8tement l'alimentation de l'imprimante pendant # quelques heures (afin de s'assurer qu'elle est \u00e0 la temp\u00e9rature ambiante), puis de la remettre sous # tension et d'utiliser la fonction QUERY_ADC pour obtenir une mesure ADC. # Utilisez un autre capteur de temp\u00e9rature sur l'imprimante pour trouver la temp\u00e9rature ambiante # correspondante. La valeur par d\u00e9faut est d'utiliser les donn\u00e9es d'\u00e9talonnage d'usine du microcontr\u00f4leur # (le cas \u00e9ch\u00e9ant) ou les valeurs nominales de la sp\u00e9cification du microcontr\u00f4leur. #sensor_temperature2: #sensor_adc2: # Si sensor_temperature1/sensor_adc1 est sp\u00e9cifi\u00e9, on peut \u00e9galement sp\u00e9cifier les donn\u00e9es # d'\u00e9talonnage de sensor_temperature2/sensor_adc2. En proc\u00e9dant ainsi on peut fournir des # informations calibr\u00e9es sur la \"pente de temp\u00e9rature\". La valeur par d\u00e9faut est d'utiliser les donn\u00e9es # d'\u00e9talonnage d'usine sur le microcontr\u00f4leur (le cas \u00e9ch\u00e9ant) ou les valeurs nominales de la # sp\u00e9cification du microcontr\u00f4leur.","title":"Capteur de temp\u00e9rature int\u00e9gr\u00e9 au microcontr\u00f4leur"},{"location":"Config_Reference.html#capteur-de-temperature-de-lhote","text":"Temp\u00e9rature de la machine (par exemple Raspberry Pi) ex\u00e9cutant le logiciel h\u00f4te. sensor_type: temperature_host #sensor_path: # Le chemin d'acc\u00e8s au fichier syst\u00e8me de temp\u00e9rature. La valeur par d\u00e9faut est # \" /sys/class/thermal/thermal_zone0/temp \" qui est le fichier syst\u00e8me de # temp\u00e9rature sur un ordinateur Raspberry Pi.","title":"Capteur de temp\u00e9rature de l'h\u00f4te"},{"location":"Config_Reference.html#capteur-de-temperature-ds18b20","text":"Le DS18B20 est un capteur de temp\u00e9rature num\u00e9rique \u00e0 1 fil (w1). Notez que ce capteur n'est pas destin\u00e9 \u00e0 \u00eatre utilis\u00e9 avec les extrudeurs et les lits chauffants, mais plut\u00f4t pour surveiller la temp\u00e9rature ambiante (C). Ces capteurs ont une port\u00e9e allant jusqu'\u00e0 125 \u00b0C et sont donc utilisables pour la surveillance de la temp\u00e9rature d'un caisson par exemple. Ils peuvent \u00e9galement fonctionner comme de simples contr\u00f4leurs de ventilateurs/\u00e9l\u00e9ments chauffants. Les capteurs DS18B20 ne sont support\u00e9s que par un \"mcu h\u00f4te\", par exemple le Raspberry Pi. Le module w1-gpio du noyau Linux doit \u00eatre install\u00e9. sensor_type: DS18B20 serial_no: # Chaque dispositif \u00e0 1-wire poss\u00e8de un num\u00e9ro de s\u00e9rie unique utilis\u00e9 pour l'identifier, # g\u00e9n\u00e9ralement au format 28-031674b175ff. Ce param\u00e8tre doit \u00eatre fourni. # Les p\u00e9riph\u00e9riques 1-wire connect\u00e9s peuvent \u00eatre list\u00e9s \u00e0 l'aide de la commande Linux suivante : # ls /sys/bus/w1/devices/ #ds18_report_time: # Intervalle en secondes entre les lectures. La valeur par d\u00e9faut est de 3,0, avec un minimum de 1,0. #sensor_mcu: # Le micro-contr\u00f4leur \u00e0 lire. Doit \u00eatre le host_mcu","title":"Capteur de temp\u00e9rature DS18B20"},{"location":"Config_Reference.html#ventilateurs","text":"","title":"Ventilateurs"},{"location":"Config_Reference.html#fan","text":"Ventilateur de refroidissement de la pi\u00e8ce. [fan] pin: # Broche de sortie contr\u00f4lant le ventilateur. Ce param\u00e8tre doit \u00eatre fourni. #max_power: 1.0 # La puissance maximale (exprim\u00e9e en tant que valeur comprise entre 0,0 et 1,0) \u00e0 laquelle # r\u00e9gler la broche. La valeur 1.0 permet de r\u00e9gler la broche enti\u00e8rement activ\u00e9e pendant de # longues p\u00e9riodes, tandis qu'une valeur de 0,5 permet \u00e0 la broche de n'\u00eatre activ\u00e9e que # durant la moiti\u00e9 du temps au maximum. Ce param\u00e8tre peut \u00eatre utilis\u00e9 pour limiter la # puissance totale de sortie (sur des p\u00e9riodes prolong\u00e9es) du ventilateur. # Si cette valeur est inf\u00e9rieure \u00e0 1,0, les demandes de vitesse du ventilateur seront mises \u00e0 # l'\u00e9chelle entre z\u00e9ro et max_power (par exemple, si la puissance maximale est de 0,9 et # qu'une vitesse de 80 % est demand\u00e9e, la puissance du ventilateur sera r\u00e9gl\u00e9e \u00e0 72 %. # La valeur par d\u00e9faut est 1.0. #shutdown_speed: 0 # La vitesse souhait\u00e9e du ventilateur (exprim\u00e9e comme une valeur de 0,0 \u00e0 1,0) si # le logiciel du microcontr\u00f4leur passe dans un \u00e9tat d'erreur. La valeur par d\u00e9faut # est 0. #cycle_time: 0.010 # La dur\u00e9e (en secondes) de chaque cycle d'alimentation PWM du ventilateur. Il est # recommand\u00e9 que cette dur\u00e9e soit de 10 millisecondes ou plus si vous utilisez un PWM logiciel. # La valeur par d\u00e9faut est de 0,010 seconde. #hardware_pwm: False # Activez ceci pour utiliser le PWM mat\u00e9riel au lieu du PWM logiciel. La plupart des ventilateurs # ne fonctionnent pas correctement avec le PWM mat\u00e9riel, il n'est donc pas recommand\u00e9 # d'activer cette option \u00e0 moins qu'il n'y ait une exigence \u00e9lectrique pour obtenir une tr\u00e8s haute # vitesse. Lorsque vous utilisez le PWM mat\u00e9riel, le temps de cycle r\u00e9el est contraint par la mise # en \u0153uvre et peut \u00eatre significativement diff\u00e9rent du temps de cycle demand\u00e9. # La valeur par d\u00e9faut est False. #kick_start_time: 0.100 # Dur\u00e9e (en secondes) de fonctionnement du ventilateur \u00e0 pleine vitesse, soit lors de sa premi\u00e8re # activation soit lors d'une augmentation de plus de 50% (pour faire tourner le ventilateur). # La valeur par d\u00e9faut est de 0,100 seconde. #off_below: 0.0 # La vitesse d'entr\u00e9e minimale qui alimentera le ventilateur (exprim\u00e9e comme une valeur # comprise entre 0,0 et 1,0). Quand une vitesse inf\u00e9rieure \u00e0 off_below est demand\u00e9e le ventilateur # sera d\u00e9sactiv\u00e9. Ce r\u00e9glage peut \u00eatre utilis\u00e9 pour \u00e9viter que le ventilateur ne cale et pour # garantir que les d\u00e9marrages sont efficaces. # La valeur par d\u00e9faut est 0.0. # # Ce param\u00e8tre doit \u00eatre recalibr\u00e9 chaque fois que max_power est ajust\u00e9. # Pour calibrer ce param\u00e8tre, commencez avec off_below r\u00e9gl\u00e9 sur 0.0 et ventilateur tournant. Diminuez # progressivement la vitesse du ventilateur afin de d\u00e9terminer la vitesse d'entr\u00e9e la plus faible entra\u00eenant # le ventilateur de mani\u00e8re fiable sans d\u00e9crochage. R\u00e9glez off_below au rapport cyclique correspondant # \u00e0 cette valeur (par exemple, 12% -> 0,12) ou l\u00e9g\u00e8rement plus. #tachometer_pin: # Broche d'entr\u00e9e tachym\u00e9trique de surveillance de la vitesse du ventilateur. Un pullup est g\u00e9n\u00e9ralement # n\u00e9cessaire. Ce param\u00e8tre est facultatif. #tachometer_ppr: 2 # Lorsque tachometer_pin est sp\u00e9cifi\u00e9, il s'agit du nombre d'impulsions par r\u00e9volution du signal # tachym\u00e9trique. Pour un ventilateur BLDC, c'est normalement la moiti\u00e9 du nombre de p\u00f4les. # La valeur par d\u00e9faut est 2. #tachometer_poll_interval: 0.0015 # Lorsque tachometer_pin est sp\u00e9cifi\u00e9, il s'agit de la p\u00e9riode d'interrogation de la broche tachym\u00e9trique, # en secondes. La valeur par d\u00e9faut est 0.0015, ce qui est suffisamment rapide pour des ventilateurs de # moins de 10000 RPM \u00e0 2 PPR. Cette valeur doit \u00eatre inf\u00e9rieure \u00e0 30/(tachometer_ppr*rpm), avec une # certaine marge, o\u00f9 rpm est la vitesse maximale (en RPM) du ventilateur. #enable_pin: # Broche optionnelle pour d'activation de l'alimentation du ventilateur. Cela peut \u00eatre utile pour les # ventilateurs avec des entr\u00e9es PWM d\u00e9di\u00e9es. Certains de ces ventilateurs restent allum\u00e9s m\u00eame \u00e0 0 % # de PWM. Dans ce cas, la broche PWM peut \u00eatre utilis\u00e9e normalement et, par exemple, un FET commut\u00e9 # \u00e0 la masse (broche de ventilateur standard) peut \u00eatre utilis\u00e9 pour contr\u00f4ler l'alimentation du ventilateur.","title":"[fan]"},{"location":"Config_Reference.html#heater_fan","text":"Ventilateurs de chauffage (on peut d\u00e9finir un nombre quelconque de sections avec le pr\u00e9fixe \"heater_fan\"). Un \"ventilateur de chauffage\" est un ventilateur activ\u00e9 lorsque le chauffage qui lui est associ\u00e9 est actif. Par d\u00e9faut, un heater_fan a une vitesse d'arr\u00eat \u00e9gale \u00e0 la puissance maximale. [heater_fan my_nozzle_fan] #pin: #max_power: #shutdown_speed: #cycle_time: #hardware_pwm: #kick_start_time: #off_below: #tachometer_pin: #tachometer_ppr: #tachometer_poll_interval: #enable_pin: # Voir la section \"fan\" pour une description des param\u00e8tres ci-dessus. #heater: extruder # Nom de la section de configuration d\u00e9finissant le chauffage auquel ce ventilateur est associ\u00e9. # Si une liste de noms d'\u00e9l\u00e9ments chauffants s\u00e9par\u00e9s par des virgules est fournie ici, le # ventilateur sera activ\u00e9 lorsque l'un des chauffages donn\u00e9s est activ\u00e9. # La valeur par d\u00e9faut est \"extruder\". #heater_temp: 50.0 # Temp\u00e9rature (en Celsius) en dessous de laquelle l'\u00e9l\u00e9ment chauffant doit descendre pour que # le ventilateur soit d\u00e9sactiv\u00e9. La valeur par d\u00e9faut est 50 \u00b0C. #fan_speed: 1.0 # La vitesse du ventilateur (exprim\u00e9e sous la forme d'une valeur comprise entre 0,0 et 1,0) \u00e0 # laquelle le ventilateur sera r\u00e9gl\u00e9 lorsque l'\u00e9l\u00e9ment chauffant qui lui est associ\u00e9 est activ\u00e9. # La valeur par d\u00e9faut est 1.0","title":"[heater_fan]"},{"location":"Config_Reference.html#controller_fan","text":"Ventilateur de refroidissement du contr\u00f4leur (on peut d\u00e9finir un nombre quelconque de sections avec le pr\u00e9fixe \"controller_fan\"). Un \"ventilateur de contr\u00f4leur\" est un ventilateur activ\u00e9 chaque fois que l'\u00e9l\u00e9ment chauffant ou le pilote pas \u00e0 pas qui lui est associ\u00e9 est actif. Le ventilateur s'arr\u00eatera chaque fois qu'un idle_timeout sera atteint afin de garantir qu'aucune surchauffe ne se produise apr\u00e8s la d\u00e9sactivation d'un composant surveill\u00e9. [controller_fan my_controller_fan] #pin: #max_power: #shutdown_speed: #cycle_time: #hardware_pwm: #kick_start_time: #off_below: #tachometer_pin: #tachometer_ppr: #tachometer_poll_interval: #enable_pin: # Voir la section \"fan\" pour une description des param\u00e8tres ci-dessus. #fan_speed: 1.0 # Vitesse du ventilateur (exprim\u00e9e comme une valeur de 0,0 \u00e0 1,0) \u00e0 laquelle celui-ci # sera r\u00e9gl\u00e9 lorsqu'un chauffage ou un pilote pas \u00e0 pas est actif. # La valeur par d\u00e9faut est 1.0 #idle_timeout: # Dur\u00e9e (en secondes) apr\u00e8s activit\u00e9 d'un pilote pas \u00e0 pas ou d'un \u00e9l\u00e9ment chauffant # pour laquelle le ventilateur doit continuer de fonctionner. La valeur par d\u00e9faut # est de 30 secondes. #idle_speed: # Vitesse du ventilateur (exprim\u00e9e comme une valeur de 0,0 et 1,0) \u00e0 laquelle le r\u00e9gler # lors de l'activit\u00e9 d'une chauffe ou d'un pilote pas \u00e0 pas avant que le d\u00e9lai d'attente # idle_timeout ne soit atteint. La valeur par d\u00e9faut est fan_speed. #heater: #stepper : # Nom de la section de configuration d\u00e9finissant l'\u00e9l\u00e9ment chauffant/pilote auquel ce ventilateur # est associ\u00e9. Si une liste s\u00e9par\u00e9e par des virgules de noms d'\u00e9l\u00e9ments chauffants/pilotes est # fournie ici, le ventilateur s'activera lorsque l'un des \u00e9l\u00e9ments chauffants/pilotes donn\u00e9s est activ\u00e9. # Le chauffage par d\u00e9faut est \"extruder\", le pilote par d\u00e9faut est tous.","title":"[controller_fan]"},{"location":"Config_Reference.html#temperature_fan","text":"Ventilateurs de refroidissement d\u00e9clench\u00e9s en fonction de la temp\u00e9rature (on peut d\u00e9finir un nombre quelconque de sections avec le pr\u00e9fixe \"temperature_fan\"). Un \"ventilateur de temp\u00e9rature\" est un ventilateur activ\u00e9 lorsque le capteur qui lui est associ\u00e9 est au-dessus d'une temp\u00e9rature d\u00e9finie. Par d\u00e9faut, un ventilateur de temp\u00e9rature a une vitesse d'arr\u00eat \u00e9gale \u00e0 la puissance maximale. Voir la r\u00e9f\u00e9rence des commandes pour plus d'informations. [temperature_fan my_temp_fan] #pin: #max_power: #shutdown_speed: #cycle_time: #hardware_pwm: #kick_start_time: #off_below: #tachometer_pin: #tachometer_ppr: #tachometer_poll_interval: #enable_pin: # Voir la section \"ventilateur\" pour une description des param\u00e8tres ci-dessus. #sensor_type: #sensor_pin: #control: #max_delta: #min_temp: #max_temp: # Voir la section \"extrudeuse\" pour une description des param\u00e8tres ci-dessus. #pid_Kp: #pid_Ki: #pid_Kd: # Les param\u00e8tres proportionnels (pid_Kp), int\u00e9graux (pid_Ki), et d\u00e9riv\u00e9s (pid_Ki) # du syst\u00e8me de contr\u00f4le par r\u00e9troaction PID. Klipper \u00e9value les param\u00e8tres PID # avec la formule g\u00e9n\u00e9rale suivante : # fan_pwm = max_power - (Kp*e + Ki*integral(e) - Kd*derivative(e)) / 255 # O\u00f9 \"e\" est \"temp\u00e9rature_cible - temp\u00e9rature_mesur\u00e9e\" et # \"fan_pwm\" est le d\u00e9bit du ventilateur demand\u00e9, 0,0 correspondant \u00e0 un arr\u00eat complet # et 1,0 correspond \u00e0 un fonctionnement \u00e0 plein r\u00e9gime. Les param\u00e8tres pid_Kp, pid_Ki, # et pid_Kd doivent \u00eatre fournis lorsque l'algorithme de contr\u00f4le PID est activ\u00e9. #pid_deriv_time: 2.0 # Une dur\u00e9e (en secondes) sur laquelle lisser les mesures de temp\u00e9rature lors de # l'utilisation de l'algorithme de contr\u00f4le PID. Cela peut r\u00e9duire l'impact du bruit de # mesure. La valeur par d\u00e9faut est de 2 secondes. #target_temp: 40.0 # Une temp\u00e9rature (en Celsius) qui sera la temp\u00e9rature cible. # La valeur par d\u00e9faut est 40 degr\u00e9s. #max_speed: 1.0 # La vitesse du ventilateur (exprim\u00e9e comme une valeur de 0,0 \u00e0 1,0) \u00e0 laquelle r\u00e9gler # le ventilateur lorsque la temp\u00e9rature du capteur d\u00e9passera la valeur d\u00e9finie. # La valeur par d\u00e9faut est 1.0. #min_speed: 0.3 # Vitesse minimale du ventilateur (exprim\u00e9e sous forme d'une valeur comprise entre 0,0 # et 1,0) \u00e0 laquelle r\u00e9gler le ventilateur pour les ventilateurs \u00e0 temp\u00e9rature PID. # La valeur par d\u00e9faut est 0,3. #gcode_id: # S'il est d\u00e9fini, la temp\u00e9rature sera signal\u00e9e dans les requ\u00eates M105 en utilisant l'identifiant # d'id donn\u00e9. La valeur par d\u00e9faut est de ne pas rapporter la temp\u00e9rature via M105.","title":"[temperature_fan]"},{"location":"Config_Reference.html#fan_generic","text":"Ventilateur command\u00e9 manuellement (on peut d\u00e9finir un nombre quelconque de sections avec le pr\u00e9fixe \"fan_generic\"). La vitesse d'un ventilateur command\u00e9 manuellement est r\u00e9gl\u00e9e avec la commande SET_FAN_SPEED commandes G-Code . [fan_generic extruder_partfan] #pin: #max_power: #shutdown_speed: #cycle_time: #hardware_pwm: #kick_start_time: #off_below: #tachometer_pin: #tachometer_ppr: #tachometer_poll_interval: #enable_pin: # Voir la section \"ventilateur\" pour une description des param\u00e8tres ci-dessus.","title":"[fan_generic]"},{"location":"Config_Reference.html#leds","text":"","title":"LEDs"},{"location":"Config_Reference.html#led","text":"Prise en charge des LEDs (et des bandes de LEDs) contr\u00f4l\u00e9es par les broches PWM du microcontr\u00f4leur (on peut d\u00e9finir un nombre quelconque de sections avec le pr\u00e9fixe \"led\"). Voir la r\u00e9f\u00e9rence de la commande pour plus d'informations. [led my_led] #red_pin: #green_pin: #blue_pin: #white_pin: # La broche contr\u00f4lant la couleur de la LED donn\u00e9e. Au moins un des param\u00e8tres ci-dessus # doit \u00eatre fourni. #cycle_time: 0.010 # Dur\u00e9e (en secondes) par cycle PWM. Il est recommand\u00e9 # que ce soit 10 millisecondes ou plus lorsque l'on utilise un PWM logiciel. # La valeur par d\u00e9faut est de 0,010 seconde. #hardware_pwm: False # Activez ceci pour utiliser le PWM mat\u00e9riel au lieu du PWM logiciel. Lors de # l'utilisation du PWM mat\u00e9riel, le temps de cycle r\u00e9el est contraint par # l'impl\u00e9mentation et peut \u00eatre significativement diff\u00e9rent du # cycle_time demand\u00e9. La valeur par d\u00e9faut est False. #initial_RED: 0.0 #initial_GREEN: 0.0 #initial_BLUE: 0.0 #initial_WHITE: 0.0 # D\u00e9finit la couleur initiale de la LED. Chaque valeur doit \u00eatre comprise entre 0.0 et # 1.0. La valeur par d\u00e9faut pour chaque couleur est 0.","title":"[led]"},{"location":"Config_Reference.html#neopixel","text":"Prise en charge des LED neopixel (alias WS2812) (on peut d\u00e9finir un nombre quelconque de sections avec le pr\u00e9fixe \"neopixel\"). Voir la r\u00e9f\u00e9rence de commande pour plus d'informations. Notez que l'impl\u00e9mentation du mcu linux ne supporte pas actuellement les neopixels directement connect\u00e9s. La conception actuelle utilisant l'interface du noyau Linux ne permet pas ce sc\u00e9nario car l'interface GPIO du noyau n'est pas assez rapide pour fournir les taux d'impulsion requis. [neopixel my_neopixel] pin: # La broche connect\u00e9e au neopixel. Ce param\u00e8tre doit \u00eatre # fourni. #chain_count: # Le nombre de puces Neopixel connect\u00e9es en \"cha\u00eene\" \u00e0 la broche fournie. # La valeur par d\u00e9faut est 1 (ce qui indique qu'un seul Neopixel est connect\u00e9 \u00e0 la broche). #color_order: GRB # D\u00e9finit l'ordre des pixels requis par le mat\u00e9riel LED (en utilisant une cha\u00eene # contenant les lettres R, G, B, W avec W en option). Alternativement, il peut s'agir d'une liste # d'ordres de pixels s\u00e9par\u00e9s par des virgules - un pour chaque LED de la cha\u00eene. # La valeur par d\u00e9faut est GRB. #initial_RED: 0.0 #initial_GREEN: 0.0 #initial_BLUE: 0.0 #initial_WHITE: 0.0 # Voir la section \"led\" pour des informations sur ces param\u00e8tres.","title":"[neopixel]"},{"location":"Config_Reference.html#dotstar","text":"Prise en charge des LEDs Dotstar (alias APA102) (on peut d\u00e9finir un nombre quelconque de sections avec le pr\u00e9fixe \"dotstar\"). Voir la r\u00e9f\u00e9rence de commande pour plus d'informations. [dotstar my_dotstar] data_pin: # La broche connect\u00e9e \u00e0 la ligne de donn\u00e9es du dotstar. Ce param\u00e8tre # doit \u00eatre fourni. clock_pin: # La broche connect\u00e9e \u00e0 la ligne d'horloge du dotstar. Ce param\u00e8tre # doit \u00eatre fourni. #chain_count: # Voir la section \"neopixel\" pour des informations sur ce param\u00e8tre. #initial_RED: 0.0 #initial_GREEN: 0.0 #initial_BLUE: 0.0 # Voir la section \"led\" pour des informations sur ces param\u00e8tres.","title":"[dotstar]"},{"location":"Config_Reference.html#pca9533","text":"Support de la LED PCA9533. Le PCA9533 est utilis\u00e9 sur la mightyboard. [pca9533 my_pca9533] #i2c_address : 98 # L'adresse i2c que la puce utilise sur le bus i2c. Utilisez 98 pour # le PCA9533/1, 99 pour le PCA9533/2. La valeur par d\u00e9faut est 98. #i2c_mcu: #i2c_bus: #i2c_speed: # Voir la section \"param\u00e8tres I2C communs\" pour une description des # param\u00e8tres ci-dessus. #initial_RED: 0.0 #initial_GREEN: 0.0 #initial_BLUE: 0.0 #initial_WHITE: 0.0 # Voir la section \"led\" pour des informations sur ces param\u00e8tres.","title":"[pca9533]"},{"location":"Config_Reference.html#pca9632","text":"Support des LEDs du PCA9632. Le PCA9632 est utilis\u00e9 sur le FlashForge Dreamer. [pca9632 my_pca9632] #i2c_address 98 # L'adresse i2c que la puce utilise sur le bus i2c. Cela peut \u00eatre # 96, 97, 98, ou 99. La valeur par d\u00e9faut est 98. #i2c_mcu: #i2c_bus: #i2c_speed: # Voir la section \"param\u00e8tres I2C communs\" pour une description des # param\u00e8tres ci-dessus. #scl_pin: #sda_pin: # Alternativement, si le pca9632 n'est pas connect\u00e9 \u00e0 un bus mat\u00e9riel I2C # il est possible de sp\u00e9cifier les broches \"clock\" (scl_pin) et \"data\" (sda_pin). # Le d\u00e9faut est d'utiliser l'I2C mat\u00e9riel. #color_order : RGBW # D\u00e9finit l'ordre des pixels de la LED (en utilisant une cha\u00eene contenant les lettres # R, G, B, W). La valeur par d\u00e9faut est RGBW. #initial_RED: 0.0 #initial_GREEN: 0.0 #initial_BLUE: 0.0 #initial_WHITE: 0.0 # Voir la section \"led\" pour des informations sur ces param\u00e8tres.","title":"[pca9632]"},{"location":"Config_Reference.html#servos-supplementaires-boutons-et-autres-broches","text":"","title":"Servos suppl\u00e9mentaires, boutons et autres broches"},{"location":"Config_Reference.html#servo","text":"Servos (on peut d\u00e9finir un nombre quelconque de sections avec le pr\u00e9fixe \"servo\"). Les servos peuvent \u00eatre contr\u00f4l\u00e9s en utilisant la commande SET_SERVO g-code . Par exemple : SET_SERVO SERVO=my_servo ANGLE=180 [servo my_servo] pin: # Broche de sortie PWM contr\u00f4lant le servo. Ce param\u00e8tre doit \u00eatre # fourni. #maximum_servo_angle: 180 # L'angle maximum (en degr\u00e9s) auquel ce servo peut \u00eatre r\u00e9gl\u00e9. La valeur # par d\u00e9faut est de 180 degr\u00e9s. #minimum_pulse_width: 0.001 # La dur\u00e9e minimale de la largeur d'impulsion (en secondes). Cela devrait correspondre # avec un angle de 0 degr\u00e9. La valeur par d\u00e9faut est de 0,001 seconde. #maximum_pulse_width: 0.002 # La dur\u00e9e maximale de la largeur d'impulsion (en secondes). Cela devrait correspondre # avec l'angle de maximum_servo_angle. La valeur par d\u00e9faut est 0.002 secondes. #initial_angle: # Angle initial (en degr\u00e9s) sur lequel r\u00e9gler le servo. La valeur par d\u00e9faut est de # ne pas envoyer de signal au d\u00e9marrage. #initial_pulse_width: # Dur\u00e9e initiale de la largeur d'impulsion (en secondes) \u00e0 laquelle le servo doit \u00eatre r\u00e9gl\u00e9. (Ceci # n'est valable que si initial_angle n'est pas d\u00e9fini). La valeur par d\u00e9faut est de n'envoyer # aucun signal au d\u00e9marrage.","title":"[servo]"},{"location":"Config_Reference.html#gcode_button","text":"Ex\u00e9cute le gcode quand un bouton est press\u00e9 ou rel\u00e2ch\u00e9 (ou quand une broche change d'\u00e9tat). Vous pouvez v\u00e9rifier l'\u00e9tat du bouton en utilisant QUERY_BUTTON button=my_gcode_button . [gcode_button my_gcode_button] pin: # La broche sur laquelle le bouton est connect\u00e9. Ce param\u00e8tre doit \u00eatre # fourni. #analog_range: # Deux r\u00e9sistances s\u00e9par\u00e9es par des virgules (en Ohms) sp\u00e9cifiant la plage de # r\u00e9sistance minimale et maximale de la r\u00e9sistance du bouton. Si le param\u00e8tre # analog_range est fourni, la broche doit \u00eatre une broche \u00e0 capacit\u00e9 analogique. # La valeur par d\u00e9faut est d'utiliser un gpio num\u00e9rique pour le bouton. #analog_pullup_resistor: # La r\u00e9sistance d'excursion (en Ohms) lorsque la gamme analogique est sp\u00e9cifi\u00e9e. # La valeur par d\u00e9faut est 4700 ohms. #press_gcode: # Une liste de commandes G-Code \u00e0 ex\u00e9cuter lorsque le bouton est press\u00e9. # Les mod\u00e8les G-Code sont pris en charge. Ce param\u00e8tre doit \u00eatre fourni. #release_gcode: # Une liste de commandes G-code \u00e0 ex\u00e9cuter lorsque le bouton est rel\u00e2ch\u00e9. # Les mod\u00e8les G-Code sont support\u00e9s. La valeur par d\u00e9faut est de ne pas ex\u00e9cuter # de commandes lors du rel\u00e2chement d'un bouton.","title":"[gcode_button]"},{"location":"Config_Reference.html#output_pin","text":"Broches de sortie configurables \u00e0 l'ex\u00e9cution (on peut d\u00e9finir un nombre quelconque de sections avec un pr\u00e9fixe \"output_pin\"). Les broches configur\u00e9es ici seront param\u00e9tr\u00e9es comme des broches de sortie modifiables au moment de l'ex\u00e9cution en utilisant des commandes g-code \u00e9tendues de type \"SET_PIN PIN=my_pin VALUE=.1\" [output_pin my_pin] pin: # La broche \u00e0 configurer comme une sortie. Ce param\u00e8tre doit \u00eatre # fourni. #pwm: False # D\u00e9finit si la broche de sortie doit \u00eatre capable de modulation de largeur d'impulsion. # Si ce param\u00e8tre est vrai, les champs de valeur doivent \u00eatre compris entre 0 et 1. # La valeur par d\u00e9faut est False. #static_value: # Si cette valeur est d\u00e9finie, la broche est affect\u00e9e \u00e0 cette valeur au d\u00e9marrage et # la broche ne peut pas \u00eatre modifi\u00e9e pendant l'ex\u00e9cution. Une broche statique utilise # l\u00e9g\u00e8rement moins de RAM dans le micro-contr\u00f4leur. Le d\u00e9faut est d'utiliser # la configuration des broches param\u00e9tr\u00e9es lors du d\u00e9marrage. #value: # La valeur \u00e0 donner initialement \u00e0 la broche pendant la configuration du MCU. # La valeur par d\u00e9faut est 0 (pour une tension basse). #shutdown_value: # La valeur \u00e0 donner \u00e0 la broche lors d'un \u00e9v\u00e9nement d'arr\u00eat du MCU. La valeur par # d\u00e9faut est 0 (pour une tension basse). #maximum_mcu_duration: # La dur\u00e9e maximale pendant laquelle une valeur de non-arr\u00eat peut \u00eatre pilot\u00e9e par # le MCUsans un accus\u00e9 de r\u00e9ception de l'h\u00f4te. # Si l'h\u00f4te ne peut pas suivre une mise \u00e0 jour, le MCU s'\u00e9teindra et mettra # toutes les broches \u00e0 leurs valeurs d'arr\u00eat respectives. # D\u00e9faut : 0 (d\u00e9sactiv\u00e9) # Les valeurs habituelles sont d'environ 5 secondes. #cycle_time: 0.100 # La dur\u00e9e (en secondes) par cycle PWM. Il est recommand\u00e9 que ce soit # 10 millisecondes ou plus lorsque vous utilisez un PWM logiciel. # La valeur par d\u00e9faut est de 0.100 secondes pour les broches PWM. #hardware_pwm: False # Activez pour utiliser le PWM mat\u00e9riel au lieu du PWM logiciel. Lors de # l'utilisation d'un PWM mat\u00e9riel, le temps de cycle r\u00e9el est limit\u00e9 par # l'impl\u00e9mentation et peut \u00eatre significativement diff\u00e9rent du # cycle_time demand\u00e9. La valeur par d\u00e9faut est False. #scale : # Ce param\u00e8tre peut \u00eatre utilis\u00e9 pour modifier la fa\u00e7on dont les param\u00e8tres 'value' # et 'shutdown_value' sont interpr\u00e9t\u00e9s pour les broches pwm. Si fourni, alors # le param\u00e8tre 'value' doit \u00eatre compris entre 0.0 et 'scale'. Cela peut \u00eatre utile # lors de la configuration d'une broche PWM contr\u00f4lant une r\u00e9f\u00e9rence de tension # d'un moteur pas \u00e0 pas. L''\u00e9chelle' peut \u00eatre d\u00e9finie sur l'intensit\u00e9 du moteur pas # \u00e0 pas \u00e9quivalent si le PWM \u00e9tait enti\u00e8rement activ\u00e9, et puis le param\u00e8tre 'value' # peut \u00eatre sp\u00e9cifi\u00e9 en utilisant l'intensit\u00e9 souhait\u00e9e pour le moteur pas \u00e0 pas. La # valeur par d\u00e9faut est de ne pas mettre \u00e0 l'\u00e9chelle le param\u00e8tre 'value'.","title":"[output_pin]"},{"location":"Config_Reference.html#static_digital_output","text":"Broches de sortie num\u00e9rique configur\u00e9es statiquement (on peut d\u00e9finir un nombre quelconque de sections avec un pr\u00e9fixe \"static_digital_output\"). Les broches configur\u00e9es ici seront configur\u00e9es comme une sortie GPIO pendant la configuration du MCU. Elles ne peuvent pas \u00eatre modifi\u00e9es en cours d'ex\u00e9cution. [static_digital_output my_output_pins] pins: # Une liste de broches s\u00e9par\u00e9es par des virgules \u00e0 d\u00e9finir comme broches de sortie GPIO. La broche # sera d\u00e9finie \u00e0 un niveau haut, sauf si le nom de la broche est pr\u00e9c\u00e9d\u00e9 de \"!\". # Ce param\u00e8tre doit \u00eatre fourni.","title":"[static_digital_output]"},{"location":"Config_Reference.html#multi_pin","text":"Sorties \u00e0 broches multiples (on peut d\u00e9finir un nombre quelconque de sections avec le pr\u00e9fixe \"multi_pin\"). Une sortie multi_pin cr\u00e9e un alias de broche interne pouvant modifier plusieurs broches de sortie chaque fois que la broche alias est d\u00e9finie. Par exemple, on peut d\u00e9finir un objet \"[multi_pin my_fan]\" contenant deux broches et ensuite d\u00e9finir \"pin=multi_pin:my_fan\" dans la section \"[fan]\" - \u00e0 chaque changement du ventilateur, les deux broches de sortie seront mises \u00e0 jour. Ces alias ne peuvent pas \u00eatre utilis\u00e9s avec des broches de moteur pas \u00e0 pas. [multi_pin my_multi_pin] pins: # Une liste s\u00e9par\u00e9e par des virgules des broches associ\u00e9es \u00e0 cet alias. Ce param\u00e8tre # doit \u00eatre fourni.","title":"[multi_pin]"},{"location":"Config_Reference.html#configuration-des-pilotes-pas-a-pas-tmc","text":"Configuration des pilotes de moteurs pas \u00e0 pas Trinamic en mode UART/SPI. Des informations suppl\u00e9mentaires sont disponibles dans le guide des pilotes TMC et dans la r\u00e9f\u00e9rence des commandes .","title":"Configuration des pilotes pas \u00e0 pas TMC"},{"location":"Config_Reference.html#tmc2130","text":"Configuration d' un pilote de moteur pas \u00e0 pas TMC2130 via le bus SPI. Pour utiliser cette fonctionnalit\u00e9, d\u00e9finissez une section de configuration avec un pr\u00e9fixe \"tmc2130\" suivi du nom de la section de configuration du moteur pas \u00e0 pas correspondant (par exemple, \"[tmc2130 stepper_x]\"). [tmc2130 stepper_x] cs_pin: # The pin corresponding to the TMC2130 chip select line. This pin # will be set to low at the start of SPI messages and raised to high # after the message completes. This parameter must be provided. #spi_speed: #spi_bus: #spi_software_sclk_pin: #spi_software_mosi_pin: #spi_software_miso_pin: # See the \"common SPI settings\" section for a description of the # above parameters. #chain_position: #chain_length: # These parameters configure an SPI daisy chain. The two parameters # define the stepper position in the chain and the total chain length. # Position 1 corresponds to the stepper that connects to the MOSI signal. # The default is to not use an SPI daisy chain. #interpolate: True # If true, enable step interpolation (the driver will internally # step at a rate of 256 micro-steps). This interpolation does # introduce a small systemic positional deviation - see # TMC_Drivers.md for details. The default is True. run_current: # The amount of current (in amps RMS) to configure the driver to use # during stepper movement. This parameter must be provided. #hold_current: # The amount of current (in amps RMS) to configure the driver to use # when the stepper is not moving. Setting a hold_current is not # recommended (see TMC_Drivers.md for details). The default is to # not reduce the current. #sense_resistor: 0.110 # The resistance (in ohms) of the motor sense resistor. The default # is 0.110 ohms. #stealthchop_threshold: 0 # The velocity (in mm/s) to set the \"stealthChop\" threshold to. When # set, \"stealthChop\" mode will be enabled if the stepper motor # velocity is below this value. The default is 0, which disables # \"stealthChop\" mode. #driver_MSLUT0: 2863314260 #driver_MSLUT1: 1251300522 #driver_MSLUT2: 608774441 #driver_MSLUT3: 269500962 #driver_MSLUT4: 4227858431 #driver_MSLUT5: 3048961917 #driver_MSLUT6: 1227445590 #driver_MSLUT7: 4211234 #driver_W0: 2 #driver_W1: 1 #driver_W2: 1 #driver_W3: 1 #driver_X1: 128 #driver_X2: 255 #driver_X3: 255 #driver_START_SIN: 0 #driver_START_SIN90: 247 # These fields control the Microstep Table registers directly. The optimal # wave table is specific to each motor and might vary with current. An # optimal configuration will have minimal print artifacts caused by # non-linear stepper movement. The values specified above are the default # values used by the driver. The value must be specified as a decimal integer # (hex form is not supported). In order to compute the wave table fields, # see the tmc2130 \"Calculation Sheet\" from the Trinamic website. #driver_IHOLDDELAY: 8 #driver_TPOWERDOWN: 0 #driver_TBL: 1 #driver_TOFF: 4 #driver_HEND: 7 #driver_HSTRT: 0 #driver_PWM_AUTOSCALE: True #driver_PWM_FREQ: 1 #driver_PWM_GRAD: 4 #driver_PWM_AMPL: 128 #driver_SGT: 0 # Set the given register during the configuration of the TMC2130 # chip. This may be used to set custom motor parameters. The # defaults for each parameter are next to the parameter name in the # above list. #diag0_pin: #diag1_pin: # The micro-controller pin attached to one of the DIAG lines of the # TMC2130 chip. Only a single diag pin should be specified. The pin # is \"active low\" and is thus normally prefaced with \"^!\". Setting # this creates a \"tmc2130_stepper_x:virtual_endstop\" virtual pin # which may be used as the stepper's endstop_pin. Doing this enables # \"sensorless homing\". (Be sure to also set driver_SGT to an # appropriate sensitivity value.) The default is to not enable # sensorless homing.","title":"[tmc2130]"},{"location":"Config_Reference.html#tmc2208","text":"Configuration d'un pilote de moteur pas \u00e0 pas TMC2208 (ou TMC2224) via un UART \u00e0 fil unique. Pour utiliser cette fonctionnalit\u00e9, d\u00e9finissez une section de configuration avec un pr\u00e9fixe \"tmc2208\" suivi du nom de la section de configuration du moteur pas \u00e0 pas correspondant (par exemple, \"[tmc2208 stepper_x]\"). [tmc2208 stepper_x] uart_pin: # La broche connect\u00e9e \u00e0 la ligne PDN_UART de la TMC2208. Ce param\u00e8tre # doit \u00eatre fourni. #tx_pin: # Si vous utilisez des lignes de r\u00e9ception et de transmission s\u00e9par\u00e9es pour communiquer # avec le pilote, r\u00e9glez uart_pin sur la broche de r\u00e9ception et tx_pin sur la broche # d'\u00e9mission. La valeur par d\u00e9faut est d'utiliser uart_pin pour la lecture et l'\u00e9criture. #select_pins: # Une liste de broches, s\u00e9par\u00e9es par des virgules, \u00e0 d\u00e9finir avant d'acc\u00e9der \u00e0 l'UART du # tmc2208. Ceci peut \u00eatre utile pour configurer un mux analogique pour la communication # UART. La valeur par d\u00e9faut est de ne pas configurer de broches. #interpolate: True # Si true, active l'interpolation de pas (le pilote fera un pas interne \u00e0 un taux de 256 # micro-pas). Cette interpolation introduit une petite d\u00e9viation syst\u00e9mique de la position - # voir TMC_Drivers.md pour plus de d\u00e9tails. La valeur par d\u00e9faut est True. run_current: # La quantit\u00e9 de courant (en amp\u00e8res RMS) \u00e0 configurer que le pilote doit utiliser # pendant le mouvement du pas. Ce param\u00e8tre doit \u00eatre fourni. #hold_current: # La quantit\u00e9 de courant (en amp\u00e8res RMS) \u00e0 configurer que le pilote doit utiliser quand # le moteur pas \u00e0 pas n'est pas en mouvement. La d\u00e9finition d'un hold_current n'est pas # recommand\u00e9e (voir TMC_Drivers.md pour plus de d\u00e9tails). La valeur par d\u00e9faut est de # ne pas r\u00e9duire le courant. #sense_resistor: 0.110 # La r\u00e9sistance (en ohms) de la r\u00e9sistance de d\u00e9tection du moteur (Vr\u00e9f). La valeur par # d\u00e9faut est de 0.110 ohms. #stealthchop_threshold: 0 # La vitesse (en mm/s) \u00e0 laquelle le seuil \"stealthChop\" doit \u00eatre fix\u00e9. Lorsque d\u00e9fini, # le mode \"stealthChop\" sera activ\u00e9 si la vitesse du moteur pas \u00e0 pas est inf\u00e9rieure \u00e0 # cette valeur. La valeur par d\u00e9faut est 0, ce qui d\u00e9sactive le mode \"stealthChop\". #driver_IHOLDDELAY: 8 #driver_TPOWERDOWN: 20 #driver_TBL: 2 #driver_TOFF: 3 #driver_HEND: 0 #driver_HSTRT: 5 #driver_PWM_AUTOGRAD: True #driver_PWM_AUTOSCALE: True #driver_PWM_LIM: 12 #driver_PWM_REG: 8 #driver_PWM_FREQ: 1 #driver_PWM_GRAD: 14 #driver_PWM_OFS: 36 # D\u00e9finissez le registre donn\u00e9 pendant la configuration de la puce TMC2208. Ceci peut \u00eatre # utilis\u00e9 pour d\u00e9finir les param\u00e8tres personnalis\u00e9s du moteur. Les valeurs par d\u00e9faut de # chaque param\u00e8tre sont indiqu\u00e9es \u00e0 c\u00f4t\u00e9 du nom du param\u00e8tre dans la liste ci-dessus.","title":"[tmc2208]"},{"location":"Config_Reference.html#tmc2209","text":"Configuration d'un pilote de moteur pas \u00e0 pas TMC2209 via un UART \u00e0 fil unique. Pour utiliser cette fonctionnalit\u00e9, d\u00e9finissez une section de configuration avec un pr\u00e9fixe \"tmc2209\" suivi du nom de la section de configuration du moteur pas \u00e0 pas correspondant (par exemple, \"[tmc2209 stepper_x]\"). [tmc2209 stepper_x] uart_pin: #tx_pin #select_pins: #interpolate: True run_current: #hold_current: #sense_resistor: 0.110 #stealthchop_threshold: 0 # Voir la section \"tmc2208\" pour la d\u00e9finition de ces param\u00e8tres. #uart_address: # L'adresse de la puce TMC2209 pour les messages UART (un entier entre 0 et 3). # Ce param\u00e8tre est g\u00e9n\u00e9ralement utilis\u00e9 lorsque plusieurs puces TMC2209 sont # connect\u00e9es \u00e0 la m\u00eame broche UART. La valeur par d\u00e9faut est z\u00e9ro. #driver_IHOLDDELAY: 8 #driver_TPOWERDOWN: 20 #driver_TBL: 2 #driver_TOFF: 3 #driver_HEND: 0 #driver_HSTRT: 5 #driver_PWM_AUTOGRAD: True #driver_PWM_AUTOSCALE: True #driver_PWM_LIM: 12 #driver_PWM_REG: 8 #driver_PWM_FREQ: 1 #driver_PWM_GRAD: 14 #driver_PWM_OFS: 36 #driver_SGTHRS: 0 # D\u00e9finit le registre donn\u00e9 pendant la configuration de la puce TMC2209. Ceci peut \u00eatre # utilis\u00e9 pour d\u00e9finir les param\u00e8tres personnalis\u00e9s du moteur. Les valeurs par d\u00e9faut de # chaque param\u00e8tre sont indiqu\u00e9es \u00e0 c\u00f4t\u00e9 du nom du param\u00e8tre dans la liste ci-dessus. #diag_pin: # La broche du microcontr\u00f4leur reli\u00e9e \u00e0 la ligne DIAG de la puce TMC2209. La broche est # normalement pr\u00e9c\u00e9d\u00e9e de \"^\" pour activer un pullup. Le param\u00e9trage de cette broche # cr\u00e9e une broche virtuelle \"tmc2209_stepper_x:virtual_endstop\" pouvant \u00eatre utilis\u00e9e # comme broche d'arr\u00eat du moteur. Ainsi cela active le \"sensorless homing\". (Assurez- # vous de d\u00e9finir \u00e9galement driver_SGTHRS \u00e0 une valeur de sensibilit\u00e9 appropri\u00e9e). # La valeur par d\u00e9faut est de ne pas activer la recherche d'origine sans capteur.","title":"[tmc2209]"},{"location":"Config_Reference.html#tmc2660","text":"Configuration d'un pilote de moteur pas \u00e0 pas TMC2660 via le bus SPI. Pour utiliser cette fonctionnalit\u00e9, d\u00e9finissez une section de configuration avec un pr\u00e9fixe \"tmc2660\" suivi du nom de la section de configuration du moteur pas \u00e0 pas correspondant (par exemple, \"[tmc2660 stepper_x]\"). [tmc2660 stepper_x] cs_pin: # La broche correspondant \u00e0 la ligne de s\u00e9lection de la puce TMC2660. Cette # broche sera mise \u00e0 l'\u00e9tat bas au d\u00e9but des messages SPI et passera \u00e0 l'\u00e9tat # haut apr\u00e8s la fin du transfert du message. Ce param\u00e8tre doit \u00eatre fourni. #spi_speed: 4000000 # Fr\u00e9quence du bus SPI utilis\u00e9e pour communiquer avec le pilote de pas \u00e0 pas # TMC2660. La valeur par d\u00e9faut est 4000000. #spi_bus: #spi_software_sclk_pin: #spi_software_mosi_pin: #spi_software_miso_pin: # Voir la section \"param\u00e8tres SPI communs\" pour une description des # param\u00e8tres ci-dessus. #interpolate: True # Si vrai, active l'interpolation par pas (le pilote fera un pas interne \u00e0 un taux # de 256 micro-pas). Cela ne fonctionne que si les micro-pas sont fix\u00e9s \u00e0 16. # L'interpolation introduit une petite d\u00e9viation de position syst\u00e9mique - voir # TMC_Drivers.md pour plus de d\u00e9tails. La valeur par d\u00e9faut est True. run_current: # La quantit\u00e9 de courant (en amp\u00e8res RMS) utilis\u00e9e par le pilote pendant le # d\u00e9placement du moteur pas \u00e0 pas. Ce param\u00e8tre doit \u00eatre fourni. #sense_resistor: # La r\u00e9sistance (en ohms) de la r\u00e9sistance de d\u00e9tection du moteur (Vr\u00e9f). Ce # param\u00e8tre doit \u00eatre fourni. #idle_current_percent 100 # Le pourcentage du courant de fonctionnement auquel le pilote pas \u00e0 pas # sera abaiss\u00e9 quand le d\u00e9lai d'inactivit\u00e9 expirera (vous devez configurer le # d\u00e9lai \u00e0 l'aide d'une section de configuration [idle_timeout]). Le courant sera # remont\u00e9 d\u00e8s que le moteur devra \u00e0 nouveau se d\u00e9placer. Assurez-vous de # d\u00e9finir une valeur suffisamment \u00e9lev\u00e9e pour que les moteurs ne perdent pas # leur position. Il y a \u00e9galement un petit d\u00e9lai avant que le courant ne soit remis, # il faut donc en tenir compte lors de demandes de mouvements rapides alors # que le pilote est inactif. La valeur par d\u00e9faut est 100 (aucune r\u00e9duction). #driver_TBL: 2 #driver_RNDTF: 0 #driver_HDEC: 0 #driver_CHM: 0 #driver_HEND: 3 #driver_HSTRT: 3 #driver_TOFF: 4 #driver_SEIMIN: 0 #driver_SEDN: 0 #driver_SEMAX: 0 #driver_SEUP: 0 #driver_SEMIN: 0 #driver_SFILT: 0 #driver_SGT: 0 #driver_SLPH: 0 #driver_SLPL: 0 #driver_DISS2G: 0 #driver_TS2G: 3 # D\u00e9finit les param\u00e8tres \u00e0 utiliser pendant la configuration de la puce TMC2660. # Ceci peut \u00eatre utilis\u00e9 pour d\u00e9finir des param\u00e8tres de pilote personnalis\u00e9s. Les # valeurs par d\u00e9faut de chaque param\u00e8tre sont indiqu\u00e9es \u00e0 c\u00f4t\u00e9 du nom du param\u00e8tre # dans la liste ci-dessus. Consultez la fiche technique du TMC2660 pour conna\u00eetre la # fonction de chaque param\u00e8tre ainsi que les restrictions sur les combinaisons de # param\u00e8tres. Soyez particuli\u00e8rement attentif au registre CHOPCONF, o\u00f9 le fait de # r\u00e9gler CHM \u00e0 soit z\u00e9ro, soit un, entra\u00eene des modifications de la disposition (le # premier bit de HDEC est interpr\u00e9t\u00e9 comme le MSB de HSTRT dans ce cas).","title":"[tmc2660]"},{"location":"Config_Reference.html#tmc5160","text":"Configuration d'un pilote de moteur pas \u00e0 pas TMC5160 via le bus SPI. Pour utiliser cette fonctionnalit\u00e9, d\u00e9finissez une section de configuration avec un pr\u00e9fixe \"tmc5160\" suivi du nom de la section de configuration du moteur pas \u00e0 pas correspondant (par exemple, \"[tmc5160 stepper_x]\"). [tmc5160 stepper_x] cs_pin: # The pin corresponding to the TMC5160 chip select line. This pin # will be set to low at the start of SPI messages and raised to high # after the message completes. This parameter must be provided. #spi_speed: #spi_bus: #spi_software_sclk_pin: #spi_software_mosi_pin: #spi_software_miso_pin: # See the \"common SPI settings\" section for a description of the # above parameters. #chain_position: #chain_length: # These parameters configure an SPI daisy chain. The two parameters # define the stepper position in the chain and the total chain length. # Position 1 corresponds to the stepper that connects to the MOSI signal. # The default is to not use an SPI daisy chain. #interpolate: True # If true, enable step interpolation (the driver will internally # step at a rate of 256 micro-steps). The default is True. run_current: # The amount of current (in amps RMS) to configure the driver to use # during stepper movement. This parameter must be provided. #hold_current: # The amount of current (in amps RMS) to configure the driver to use # when the stepper is not moving. Setting a hold_current is not # recommended (see TMC_Drivers.md for details). The default is to # not reduce the current. #sense_resistor: 0.075 # The resistance (in ohms) of the motor sense resistor. The default # is 0.075 ohms. #stealthchop_threshold: 0 # The velocity (in mm/s) to set the \"stealthChop\" threshold to. When # set, \"stealthChop\" mode will be enabled if the stepper motor # velocity is below this value. The default is 0, which disables # \"stealthChop\" mode. #driver_MSLUT0: 2863314260 #driver_MSLUT1: 1251300522 #driver_MSLUT2: 608774441 #driver_MSLUT3: 269500962 #driver_MSLUT4: 4227858431 #driver_MSLUT5: 3048961917 #driver_MSLUT6: 1227445590 #driver_MSLUT7: 4211234 #driver_W0: 2 #driver_W1: 1 #driver_W2: 1 #driver_W3: 1 #driver_X1: 128 #driver_X2: 255 #driver_X3: 255 #driver_START_SIN: 0 #driver_START_SIN90: 247 # These fields control the Microstep Table registers directly. The optimal # wave table is specific to each motor and might vary with current. An # optimal configuration will have minimal print artifacts caused by # non-linear stepper movement. The values specified above are the default # values used by the driver. The value must be specified as a decimal integer # (hex form is not supported). In order to compute the wave table fields, # see the tmc2130 \"Calculation Sheet\" from the Trinamic website. #driver_IHOLDDELAY: 6 #driver_TPOWERDOWN: 10 #driver_TBL: 2 #driver_TOFF: 3 #driver_HEND: 2 #driver_HSTRT: 5 #driver_FD3: 0 #driver_TPFD: 4 #driver_CHM: 0 #driver_VHIGHFS: 0 #driver_VHIGHCHM: 0 #driver_DISS2G: 0 #driver_DISS2VS: 0 #driver_PWM_AUTOSCALE: True #driver_PWM_AUTOGRAD: True #driver_PWM_FREQ: 0 #driver_FREEWHEEL: 0 #driver_PWM_GRAD: 0 #driver_PWM_OFS: 30 #driver_PWM_REG: 4 #driver_PWM_LIM: 12 #driver_SGT: 0 #driver_SEMIN: 0 #driver_SEUP: 0 #driver_SEMAX: 0 #driver_SEDN: 0 #driver_SEIMIN: 0 #driver_SFILT: 0 # Set the given register during the configuration of the TMC5160 # chip. This may be used to set custom motor parameters. The # defaults for each parameter are next to the parameter name in the # above list. #diag0_pin: #diag1_pin: # The micro-controller pin attached to one of the DIAG lines of the # TMC5160 chip. Only a single diag pin should be specified. The pin # is \"active low\" and is thus normally prefaced with \"^!\". Setting # this creates a \"tmc5160_stepper_x:virtual_endstop\" virtual pin # which may be used as the stepper's endstop_pin. Doing this enables # \"sensorless homing\". (Be sure to also set driver_SGT to an # appropriate sensitivity value.) The default is to not enable # sensorless homing.","title":"[tmc5160]"},{"location":"Config_Reference.html#configuration-du-courant-du-moteur-pas-a-pas-en-temps-reel","text":"","title":"Configuration du courant du moteur pas \u00e0 pas en temps r\u00e9el"},{"location":"Config_Reference.html#ad5206","text":"Digipots AD5206 configur\u00e9s statiquement et connect\u00e9s via un bus SPI (on peut d\u00e9finir un nombre quelconque de sections avec un pr\u00e9fixe \"ad5206\"). [ad5206 my_digipot] enable_pin: # La broche correspondant \u00e0 la ligne de s\u00e9lection de la puce AD5206. Cette broche # sera r\u00e9gl\u00e9e \u00e0 un niveau bas au d\u00e9but des messages SPI et sera relev\u00e9e \u00e0 un niveau \u00e9lev\u00e9 # apr\u00e8s la fin du message. Ce param\u00e8tre doit \u00eatre fourni. #spi_speed: #spi_bus: #spi_software_sclk_pin: #spi_software_mosi_pin: #spi_software_miso_pin: # Voir la section \"param\u00e8tres communs SPI\" pour une description des param\u00e8tres ci-dessus. # #channel_1: #channel_2: #channel_3: #channel_4: #channel_5: #channel_6: # La valeur pour d\u00e9finir statiquement le canal AD5206 donn\u00e9. Cette valeur est # g\u00e9n\u00e9ralement d\u00e9finie sur un nombre compris entre 0,0 et 1,0. 1,0 \u00e9tant la r\u00e9sistance # la plus \u00e9lev\u00e9e et 0,0 la r\u00e9sistance la plus faible. Cependant, la plage peut \u00eatre # modifi\u00e9e \u00e0 l'aide du param\u00e8tre 'scale' (voir ci-dessous). # Si un canal n'est pas sp\u00e9cifi\u00e9, il n'est pas configur\u00e9. # scale: # Ce param\u00e8tre peut \u00eatre utilis\u00e9 pour modifier l'interpr\u00e9tation des param\u00e8tres 'channel_x'. # S'il est fourni, alors les param\u00e8tres 'channel_x' doivent \u00eatre compris entre 0.0 et 'scale'. # Cela peut \u00eatre utile lorsque le AD5206 est utilis\u00e9 pour d\u00e9finir des r\u00e9f\u00e9rences de tension # pas \u00e0 pas. L''\u00e9chelle' peut \u00eatre r\u00e9gl\u00e9e sur l'intensit\u00e9 \u00e9quivalente de la commande pas \u00e0 pas # si l'AD5206 \u00e9tait \u00e0 sa r\u00e9sistance la plus \u00e9lev\u00e9e, puis les param\u00e8tres 'channel_x' peuvent \u00eatre # sp\u00e9cifi\u00e9s en utilisant la valeur d'intensit\u00e9 d\u00e9sir\u00e9e pour le pilote pas \u00e0 pas. La configuration # par d\u00e9faut est de ne pas mettre \u00e0 l'\u00e9chelle les param\u00e8tres 'channel_x'.","title":"[ad5206]"},{"location":"Config_Reference.html#mcp4451","text":"Digipot MCP4451 configur\u00e9 statiquement et connect\u00e9 via le bus I2C (on peut d\u00e9finir un nombre quelconque de sections avec un pr\u00e9fixe \"mcp4451\"). [mcp4451 mon_digipot] i2c_address: # L'adresse i2c que la puce utilise sur le bus i2c. Ce param\u00e8tre # doit \u00eatre fourni. #i2c_mcu: #i2c_bus: #i2c_speed: # Voir la section \"param\u00e8tres I2C communs\" pour une description des # param\u00e8tres ci-dessus. #wiper_0: #wiper_1: #wiper_2: #wiper_3: # La valeur pour d\u00e9finir statiquement le \"wiper\" MCP4451 donn\u00e9. Cette valeur est # g\u00e9n\u00e9ralement r\u00e9gl\u00e9e sur un nombre compris entre 0.0 et 1.0, 1.0 \u00e9tant la r\u00e9sistance # la plus \u00e9lev\u00e9e et 0.0 la r\u00e9sistance la plus faible. Cependant, la plage peut \u00eatre modifi\u00e9e # \u00e0 l'aide du param\u00e8tre 'scale' (voir ci-dessous). Si un wiper n'est pas sp\u00e9cifi\u00e9, il n'est # pas configur\u00e9. #scale: # Ce param\u00e8tre peut \u00eatre utilis\u00e9 pour modifier l'interpr\u00e9tation des param\u00e8tres 'wiper_x'. # S'il est fourni, alors les param\u00e8tres 'wiper_x' doivent \u00eatre compris entre 0,0 et 'scale'. # Ceci peut \u00eatre utile lorsque le MCP4451 est utilis\u00e9 pour d\u00e9finir des r\u00e9f\u00e9rences de tension # du pilote pas \u00e0 pas.L''\u00e9chelle' peut \u00eatre r\u00e9gl\u00e9e sur l'intensit\u00e9 du pilote pas \u00e0 pas \u00e9quivalent # si le MCP4451 \u00e9tait \u00e0 sa r\u00e9sistance la plus \u00e9lev\u00e9e, puis les param\u00e8tres 'wiper_x' peuvent # \u00eatre sp\u00e9cifi\u00e9s en utilisant la valeur d'intensit\u00e9 d\u00e9sir\u00e9e pour le pilote pas \u00e0 pas. La valeur # par d\u00e9faut est de ne pas mettre \u00e0 l'\u00e9chelle les param\u00e8tres 'wiper_x'.","title":"[mcp4451]"},{"location":"Config_Reference.html#mcp4728","text":"Convertisseur num\u00e9rique-analogique MCP4728 configur\u00e9 statiquement et connect\u00e9 via le bus I2C (on peut d\u00e9finir un nombre quelconque de sections avec un pr\u00e9fixe \"mcp4728\"). [mcp4728 my_dac] #i2c_address: 96 # L'adresse i2c que la puce utilise sur le bus i2c. La valeur par d\u00e9faut # est 96. #i2c_mcu: #i2c_bus: #i2c_speed: # Voir la section \"param\u00e8tres I2C communs\" pour une description des # param\u00e8tres ci-dessus. #channel_a: #channel_b: #channel_c: #channel_d: # La valeur pour d\u00e9finir statiquement le canal MCP4728 donn\u00e9. Ceci est # g\u00e9n\u00e9ralement d\u00e9finie par un nombre compris entre 0.0 et 1.0, 1.0 repr\u00e9sentant # la tension la plus \u00e9lev\u00e9e (2.048V) et 0.0 la tension la plus basse. # Cependant, la plage peut \u00eatre modifi\u00e9e \u00e0 l'aide du param\u00e8tre 'scale' (cf. # ci-dessous). Si un canal n'est pas sp\u00e9cifi\u00e9, il n'est pas configur\u00e9. #scale: # Ce param\u00e8tre peut \u00eatre utilis\u00e9 pour modifier l'interpr\u00e9tation des param\u00e8tres 'channel_x'. # S'il est fourni, le param\u00e8tre 'channel_x' doit \u00eatre compris entre 0,0 et 'scale'. # Cela peut \u00eatre utile lorsque le MCP4728 est utilis\u00e9 pour d\u00e9finir des r\u00e9f\u00e9rences de tension # de moteur pas \u00e0 pas. L''\u00e9chelle' peut \u00eatre r\u00e9gl\u00e9e sur l'intensit\u00e9 \u00e9quivalente de la commande # de moteur pas \u00e0 pas si le MCP4728 \u00e9tait \u00e0 sa tension la plus \u00e9lev\u00e9e (2.048V), et ensuite les # param\u00e8tres 'channel_x' peuvent \u00eatre sp\u00e9cifi\u00e9s en utilisant l'intensit\u00e9 d\u00e9sir\u00e9e pour le # moteur pas \u00e0 pas. La valeur par d\u00e9faut est de ne pas mettre \u00e0 l'\u00e9chelle les # param\u00e8tres 'channel_x'.","title":"[mcp4728]"},{"location":"Config_Reference.html#mcp4018","text":"Digipot MCP4018 configur\u00e9 statiquement et connect\u00e9 via deux broches gpio \"bit banging\" (on peut d\u00e9finir un nombre quelconque de sections avec un pr\u00e9fixe \"mcp4018\"). [mcp4018 my_digipot] scl_pin: # La broche d'horloge SCL. Ce param\u00e8tre doit \u00eatre fourni. sda_pin: # La broche de \"donn\u00e9es\" SDA. Ce param\u00e8tre doit \u00eatre fourni. wiper: # La valeur \u00e0 laquelle d\u00e9finir statiquement le \"wiper\" MCP4018 donn\u00e9. Ce param\u00e8tre est # g\u00e9n\u00e9ralement r\u00e9gl\u00e9e sur un nombre compris entre 0,0 et 1,0, 1,0 \u00e9tant la r\u00e9sistance # la plus \u00e9lev\u00e9e et 0.0 la r\u00e9sistance la plus faible. Cependant, la plage peut \u00eatre modifi\u00e9e \u00e0 # l'aide du param\u00e8tre 'scale' (voir ci-dessous). Ce param\u00e8tre doit \u00eatre fourni. #scale: # Ce param\u00e8tre peut \u00eatre utilis\u00e9 pour modifier l'interpr\u00e9tation du param\u00e8tre 'wiper'. # S'il est fourni, le param\u00e8tre 'wiper' doit se situer entre 0,0 et 'scale'. Ceci peut \u00eatre utile # lorsque le MCP4018 est utilis\u00e9 pour d\u00e9finir des r\u00e9f\u00e9rences de tension pas \u00e0 pas. # L''\u00e9chelle' peut \u00eatre r\u00e9gl\u00e9e sur l'intensit\u00e9 du pilote pas \u00e0 pas \u00e9quivalent si le MCP4018 # est \u00e0 sa plus grande# r\u00e9sistance la plus \u00e9lev\u00e9e, puis le param\u00e8tre 'wiper' peut \u00eatre sp\u00e9cifi\u00e9 # en utilisant la valeur d'intensit\u00e9 d\u00e9sir\u00e9e pour le pilote pas \u00e0 pas. La valeur par d\u00e9faut est # de ne pas mettre \u00e0 l'\u00e9chelle le param\u00e8tre 'wiper'.","title":"[mcp4018]"},{"location":"Config_Reference.html#prise-en-charge-de-laffichage","text":"","title":"Prise en charge de l'affichage"},{"location":"Config_Reference.html#display","text":"Prise en charge d'un \u00e9cran reli\u00e9 au microcontr\u00f4leur. [display] lcd_type: # Le type de puce LCD utilis\u00e9. Cela peut \u00eatre \"hd44780\", \"hd44780_spi\", \"st7920\", # \"emulated_st7920\", \"uc1701\", \"ssd1306\", ou \"sh1106\". # Voir les sections d'affichage ci-dessous pour plus d'informations sur chaque type # et les param\u00e8tres suppl\u00e9mentaires qu'ils fournissent. Ce param\u00e8tre doit \u00eatre # fourni. #display_group: # Le nom du groupe de donn\u00e9es \u00e0 afficher sur l'\u00e9cran. Cela contr\u00f4le le contenu de # l'\u00e9cran (voir la section \"display_data\" pour plus d'informations). La valeur par # d\u00e9faut est _default_20x4 pour les \u00e9crans hd44780 et _default_16x4 pour les # autres affichages. #menu_timeout: # D\u00e9lai d'attente pour le menu. Le fait d'\u00eatre inactif pendant ce nombre de secondes # d\u00e9clenchera la sortie du menu ou le retour au menu racine si l'autorun est activ\u00e9. # La valeur par d\u00e9faut est 0 seconde (d\u00e9sactiv\u00e9) #menu_root: # Nom de la section du menu principal \u00e0 afficher lorsque vous cliquez sur l'encodeur # de l'\u00e9cran d'accueil. La valeur par d\u00e9faut est __main, et cela affiche les menus par # d\u00e9faut tels que d\u00e9finis dans klippy/extras/display/menu.cfg #menu_reverse_navigation: # Lorsque activ\u00e9, inverse les directions vers le haut et vers le bas de la liste. # La valeur par d\u00e9faut est False. Ce param\u00e8tre est optionnel. #encoder_pins: # Les broches connect\u00e9es \u00e0 l'encodeur. 2 broches doivent \u00eatre fournies lorsque vous # utilisez l'encodeur. Ce param\u00e8tre doit \u00eatre fourni lors de l'utilisation du menu. #encoder_steps_per_detent: # Combien de pas l'encodeur \u00e9met par cran (\"clic\"). Si l'encodeur prend deux crans pour # se d\u00e9placer entre les entr\u00e9es ou d\u00e9place deux entr\u00e9es \u00e0 partir d'un seul cran, essayez de # modifier cette valeur. Les valeurs autoris\u00e9es sont 2 (demi-step) ou 4 (full-step). # La valeur par d\u00e9faut est 4. #click_pin: # La broche connect\u00e9e au bouton 'entr\u00e9e' ou au 'clic' de l'encodeur. Ce param\u00e8tre doit # \u00eatre fourni lors de l'utilisation du menu. La pr\u00e9sence d'un param\u00e8tre de configuration # 'analog_range_click_pin' fait passer ce param\u00e8tre de num\u00e9rique \u00e0 analogique. #back_pin: # La broche connect\u00e9e au bouton 'retour'. Ce param\u00e8tre est facultatif, le menu peut \u00eatre utilis\u00e9 # sans lui. La pr\u00e9sence d'un param\u00e8tre de configuration 'analog_range_back_pin' transforme # ce param\u00e8tre de num\u00e9rique \u00e0 analogique. #up_pin: # La broche connect\u00e9e au bouton 'haut'. Ce param\u00e8tre doit \u00eatre fourni lorsque vous utilisez un # menu sans encodeur. La pr\u00e9sence d'un param\u00e8tre de configuration 'analog_range_up_pin' # transforme ce param\u00e8tre de num\u00e9rique \u00e0 analogique. #down_pin: # La broche connect\u00e9e au bouton 'bas'. Ce param\u00e8tre doit \u00eatre fourni lorsque vous utilisez un # menu sans encodeur. La pr\u00e9sence d'un param\u00e8tre de configuration 'analog_range_down_pin' # transforme ce param\u00e8tre de num\u00e9rique \u00e0 analogique. #kill_pin: # La broche connect\u00e9e au bouton 'kill'. Ce bouton appellera l'arr\u00eat d'urgence. La pr\u00e9sence d'un # param\u00e8tre 'analog_range_kill_pin' fait passer ce param\u00e8tre de num\u00e9rique \u00e0 analogique. #analog_pullup_resistor: 4700 # La r\u00e9sistance (en ohms) du pullup attach\u00e9 au bouton analogique. # La valeur par d\u00e9faut est de 4700 ohms. #analog_range_click_pin: # La plage de r\u00e9sistances du bouton 'entr\u00e9e'. Les valeurs minimale et maximale de la plage # s\u00e9par\u00e9es par des virgules doivent \u00eatre fournies lors de l'utilisation du bouton analogique. #analog_range_back_pin: # La plage de r\u00e9sistances du bouton 'retour'. Les valeurs minimale et maximale de la plage # s\u00e9par\u00e9es par des virgules doivent \u00eatre fournies lors de l'utilisation du bouton analogique. #analog_range_up_pin: # La plage de r\u00e9sistances du bouton 'haut'. Les valeurs minimale et maximale de la plage # s\u00e9par\u00e9es par des virgules doivent \u00eatre fournies lors de l'utilisation du bouton analogique. #analog_range_down_pin: # La plage de r\u00e9sistances du bouton 'bas'. Les valeurs minimale et maximale de la plage # s\u00e9par\u00e9es par des virgules doivent \u00eatre fournies lors de l'utilisation du bouton analogique. #analog_range_kill_pin: # La plage de r\u00e9sistances du bouton 'kill'. Les valeurs minimale et maximale de la plage # s\u00e9par\u00e9es par des virgules doivent \u00eatre fournies lors de l'utilisation du bouton analogique.","title":"[display]"},{"location":"Config_Reference.html#ecran-hd44780","text":"Informations de configuration des \u00e9crans hd44780 (utilis\u00e9s dans les \u00e9crans de type \"RepRapDiscount 2004 Smart Controller\"). [display] lcd_type: hd44780 # D\u00e9finir \u00e0 \"hd44780\" pour les \u00e9crans hd44780. rs_pin: e_pin: d4_pin: d5_pin: d6_pin: d7_pin: # Broches connect\u00e9es \u00e0 un lcd de type hd44780. Ces param\u00e8tres doivent # \u00eatre fournis. #hd44780_protocol_init: True # Effectuer l'initialisation du protocole 8-bit/4-bit sur un \u00e9cran hd44780. # Ceci est n\u00e9cessaire sur les vrais dispositifs hd44780. Cependant, on peut avoir besoin # de le d\u00e9sactiver avec certains p\u00e9riph\u00e9riques \"clones\". La valeur par d\u00e9faut est True. #line_length: # D\u00e9finit le nombre de caract\u00e8res par ligne pour un lcd de type hd44780. # Les valeurs possibles sont 20 (par d\u00e9faut) et 16. Le nombre de lignes est # fix\u00e9 \u00e0 4. ...","title":"\u00e9cran hd44780"},{"location":"Config_Reference.html#ecran-hd44780_spi","text":"Informations de configuration d'un \u00e9cran hd44780_spi - un \u00e9cran 20x04 contr\u00f4l\u00e9 par un \"registre \u00e0 d\u00e9calage (shift register)\" mat\u00e9riel (utilis\u00e9 dans les imprimantes bas\u00e9es sur mightyboard). [display] lcd_type: hd44780_spi # D\u00e9finir \u00e0 \"hd44780_spi\" pour les \u00e9crans hd44780_spi. latch_pin: spi_software_sclk_pin: spi_software_mosi_pin: spi_software_miso_pin: # Broches connect\u00e9es au registre \u00e0 d\u00e9calage contr\u00f4lant l'affichage. # La broche spi_software_miso_pin doit \u00eatre d\u00e9finie sur une broche inutilis\u00e9e # de la carte m\u00e8re de l'imprimante, car le registre \u00e0 d\u00e9calage contr\u00f4lant l'affichage # n'a pas de broche MISO, mais l'impl\u00e9mentation logicielle de spi n\u00e9cessite que # cette broche soit configur\u00e9e. #hd44780_protocol_init: True # Effectue l'initialisation du protocole 8-bit/4-bit sur un \u00e9cran hd44780. # Ceci est n\u00e9cessaire sur les vrais dispositifs hd44780. Cependant, on peut avoir besoin # de le d\u00e9sactiver avec certains p\u00e9riph\u00e9riques \"clones\". La valeur par d\u00e9faut est True. #line_length: # D\u00e9finit le nombre de caract\u00e8res par ligne pour un lcd de type hd44780. # Les valeurs possibles sont 20 (par d\u00e9faut) et 16. Le nombre de lignes est # fix\u00e9 \u00e0 4. ...","title":"\u00e9cran hd44780_spi"},{"location":"Config_Reference.html#ecran-st7920","text":"Informations de configuration des \u00e9crans st7920 (utilis\u00e9s dans les \u00e9crans de type \"RepRapDiscount 12864 Full Graphic Smart Controller\"). [display] lcd_type: st7920 # D\u00e9finir \u00e0 \"st7920\" pour les \u00e9crans st7920. cs_pin: sclk_pin: sid_pin: # Les broches connect\u00e9es \u00e0 un lcd de type st7920. Ces param\u00e8tres doivent \u00eatre # fournis. ...","title":"\u00e9cran st7920"},{"location":"Config_Reference.html#ecran-emulated_st7920","text":"Informations de configuration d'un \u00e9cran st7920 \u00e9mul\u00e9 - que l'on trouve dans certains \"\u00e9crans tactiles de 2,4 pouces\" et similaires. [display] lcd_type: emulated_st7920 # D\u00e9finir \u00e0 \"emulated_st7920\" pour les \u00e9crans emulated_st7920. en_pin: spi_software_sclk_pin: spi_software_mosi_pin: spi_software_miso_pin: # Les broches connect\u00e9es \u00e0 un lcd de type emulated_st7920. L'en_pin # correspond \u00e0 la cs_pin du lcd de type st7920, # spi_software_sclk_pin correspond \u00e0 sclk_pin et # spi_software_mosi_pin correspond \u00e0 sid_pin. La broche # spi_software_miso_pin doit \u00eatre r\u00e9gl\u00e9e sur une broche non utilis\u00e9e de la carte # m\u00e8re de l'imprimante car le st7920 n'a pas de broche MISO mais l'impl\u00e9mentation # logicielle spi n\u00e9cessite que cette broche soit configur\u00e9e. ...","title":"\u00e9cran emulated_st7920"},{"location":"Config_Reference.html#ecran-uc1701","text":"Informations de configuration des \u00e9crans uc1701 (utilis\u00e9s dans les \u00e9crans de type \"MKS Mini 12864\"). [display] lcd_type: uc1701 # D\u00e9finir \u00e0 \"uc1701\" pour les \u00e9crans uc1701. cs_pin: a0_pin: # Les broches connect\u00e9es \u00e0 un lcd de type uc1701. Ces param\u00e8tres doivent \u00eatre # fournis. #rst_pin: # La broche connect\u00e9e \u00e0 la broche \"rst\" du lcd. Si elle n'est pas sp\u00e9cifi\u00e9e, # le mat\u00e9riel doit avoir un pull-up sur la ligne lcd correspondante. #contrast: # Le contraste \u00e0 d\u00e9finir. La valeur peut aller de 0 \u00e0 63 , la valeur par # d\u00e9faut est 40. ...","title":"\u00e9cran uc1701"},{"location":"Config_Reference.html#ecrans-ssd1306-et-sh1106","text":"Les informations de configuration des \u00e9crans ssd1306 et sh1106. [display] lcd_type: # D\u00e9finir \u00e0 \"ssd1306\" ou \"sh1106\" pour le type d'affichage donn\u00e9. #i2c_mcu: #i2c_bus: #i2c_speed: # Param\u00e8tres optionnels disponibles pour des \u00e9crans connect\u00e9s via un bus i2c. # Voir la section \"Param\u00e8tres I2C communs\" pour une description des # param\u00e8tres ci-dessus. #cs_pin: #dc_pin: #spi_speed: #spi_bus: #spi_software_sclk_pin: #spi_software_mosi_pin: #spi_software_miso_pin: # Les broches connect\u00e9es au lcd en mode spi \"4-wire\". Voir la section # \"param\u00e8tres SPI communs\" pour une description des param\u00e8tres # commen\u00e7ant par \"spi_\". Le d\u00e9faut est d'utiliser le mode i2c pour l'\u00e9cran # d'affichage. #reset_pin: # Une broche de r\u00e9initialisation peut \u00eatre sp\u00e9cifi\u00e9e sur l'affichage. Si elle # n'est pas sp\u00e9cifi\u00e9e, le mat\u00e9riel doit avoir un pull-up sur la ligne # lcd correspondante. #contrast: # Le contraste \u00e0 d\u00e9finir. La valeur peut aller de 0 \u00e0 256 , la valeur par # d\u00e9faut est 239. #vcomh: 0 # D\u00e9finit la valeur Vcomh sur l'\u00e9cran. Cette valeur est associ\u00e9e \u00e0 un effet # de \"bavure\" sur certains \u00e9crans OLED. La valeur peut \u00eatre comprise # de 0 \u00e0 63. La valeur par d\u00e9faut est 0. #invert: False # TRUE inverse les pixels sur certains \u00e9crans OLED. La valeur par d\u00e9faut est # False. #x_offset: 0 # D\u00e9finit la valeur du d\u00e9calage horizontal sur les \u00e9crans SH1106. La valeur par # d\u00e9faut est 0. ...","title":"\u00e9crans ssd1306 et sh1106"},{"location":"Config_Reference.html#display_data","text":"Support pour l'affichage de donn\u00e9es personnalis\u00e9es sur un \u00e9cran lcd. On peut cr\u00e9er un nombre quelconque de groupes d'affichage et un nombre quelconque d'\u00e9l\u00e9ments de donn\u00e9es sous ces groupes. L'\u00e9cran affichera tous les \u00e9l\u00e9ments de donn\u00e9es d'un groupe donn\u00e9 si l'option display_group de la section [display] est d\u00e9finie sur le nom du groupe en question. Un ensemble par d\u00e9faut de groupes d'affichage est automatiquement cr\u00e9\u00e9. On peut remplacer ou \u00e9tendre ces \u00e9l\u00e9ments display_data en rempla\u00e7ant les valeurs par d\u00e9faut dans le fichier de configuration principal printer.cfg. [display_data my_group_name my_data_name] position: # Ligne et colonne s\u00e9par\u00e9es par des virgules de la position de l'affichage \u00e0 # utiliser pour afficher l'information. Ce param\u00e8tre doit \u00eatre fourni. text: # Le texte \u00e0 afficher \u00e0 la position donn\u00e9e. Ce champ est \u00e9valu\u00e9 en utilisant les # mod\u00e8les de commande (voir docs/Command_Templates.md). # Ce param\u00e8tre doit \u00eatre fourni.","title":"[display_data]"},{"location":"Config_Reference.html#display_template","text":"Les \"macros\" de texte des donn\u00e9es d'affichage (on peut d\u00e9finir un nombre quelconque de sections avec un pr\u00e9fixe display_template). Voir le document mod\u00e8les de commande pour des informations sur l'\u00e9valuation des mod\u00e8les. Cette fonctionnalit\u00e9 permet de r\u00e9duire les d\u00e9finitions r\u00e9p\u00e9titives dans les sections display_data. On peut utiliser la fonction int\u00e9gr\u00e9e render() dans les sections display_data pour \u00e9valuer un mod\u00e8le. Par exemple, si l'on d\u00e9finit \"[display_template my_template] \", on peut alors utiliser \"{ render('my_template') } dans une section display_data. Cette fonctionnalit\u00e9 peut \u00e9galement \u00eatre utilis\u00e9e pour des mises \u00e0 jour continues des LEDs \u00e0 l'aide de la commande SET_LED_TEMPLATE . [display_template my_template_name] #param_<name>: # On peut sp\u00e9cifier un nombre quelconque d'options avec le pr\u00e9fixe \"param_\". Le nom # donn\u00e9 se verra attribuer la valeur donn\u00e9e (analys\u00e9e comme un litt\u00e9ral Python) et # sera disponible pendant l'expansion de la macro. Si le param\u00e8tre est pass\u00e9 dans # l'appel \u00e0 render(), alors cette valeur sera utilis\u00e9e pendant l'expansion de la macro. # Par exemple, une configuration avec \"param_speed = 75\" pourrait avoir un appelant # avec \"render('my_template_name', param_speed=80)\". Les noms de param\u00e8tres # peuvent ne pas utiliser de caract\u00e8res majuscules. text: # Le texte \u00e0 renvoyer lors du rendu de ce mod\u00e8le. Ce champ est \u00e9valu\u00e9 \u00e0 l'aide de # mod\u00e8les de commande (voir docs/Command_Templates.md). # Ce param\u00e8tre doit \u00eatre fourni.","title":"[display_template]"},{"location":"Config_Reference.html#display_glyph","text":"Affiche un glyphe personnalis\u00e9 sur les \u00e9crans le supportant. Le nom donn\u00e9 se verra attribu\u00e9 les donn\u00e9es d'affichage, donn\u00e9es qui pourront ensuite \u00eatre r\u00e9f\u00e9renc\u00e9es dans les mod\u00e8les d'affichage par leur nom entour\u00e9 de deux symboles \"tilde\", par exemple ~my_display_glyph~ Voir sample-glyphs.cfg pour quelques exemples. [display_glyph my_display_glyph] #data: # Les donn\u00e9es d'affichage, stock\u00e9es sous forme de 16 lignes compos\u00e9es de 16 bits (1 par # pixel) o\u00f9 '.' est un pixel vide et '*' est un pixel actif (par ex, \"****************\" pour afficher # une ligne horizontale pleine). # On peut \u00e9galement utiliser '0' pour un pixel vide et '1' pour un pixel actif. # Placez chaque ligne d'affichage sur une ligne de configuration distincte. Le glyphe doit \u00eatre # compos\u00e9 d'exactement 16 lignes de 16 bits chacune. Ce param\u00e8tre est facultatif. #hd44780_data: # Glyphe \u00e0 utiliser sur les \u00e9crans 20x4 hd44780. Le glyphe doit \u00eatre compos\u00e9 d'exactement # 8 lignes de 5 bits chacune. Ce param\u00e8tre est facultatif. #hd44780_slot: # L'index mat\u00e9riel hd44780 (0..7) pour stocker le glyphe. Si plusieurs images distinctes # utilisent le m\u00eame slot, assurez-vous de n'utiliser qu'une seule de ces images dans un # \u00e9cran donn\u00e9. Ce param\u00e8tre est requis si hd44780_data est sp\u00e9cifi\u00e9.","title":"[display_glyph]"},{"location":"Config_Reference.html#display-my_extra_display","text":"Si une section principale [display] a \u00e9t\u00e9 d\u00e9finie dans printer.cfg comme indiqu\u00e9 ci-dessus, il est possible de d\u00e9finir plusieurs affichages auxiliaires. Notez que les affichages auxiliaires ne supportent pas actuellement la fonctionnalit\u00e9 de menus, ils ne supportent donc pas les options \"menu\" ou la configuration de boutons. [display my_extra_display] # Voir la section \"affichage\" (display) pour les param\u00e8tres disponibles.","title":"[display my_extra_display]"},{"location":"Config_Reference.html#menu","text":"Menus de l'\u00e9cran LCD personnalisables. Un ensemble de menus par d\u00e9faut est automatiquement cr\u00e9\u00e9. On peut remplacer ou \u00e9tendre le menu en rempla\u00e7ant les valeurs par d\u00e9faut dans le fichier de configuration principal printer.cfg. Consultez le document sur les mod\u00e8les de commande pour obtenir des informations sur les attributs de menu disponibles lors du rendu du mod\u00e8le. # Param\u00e8tres communs disponibles pour toutes les sections de configuration de menu. #[menu __some_list __some_name] #type: disabled # \u00c9l\u00e9ment de menu d\u00e9sactiv\u00e9 de fa\u00e7on permanente, le seul attribut requis est 'type'. # Vous permet de d\u00e9sactiver/masquer facilement des \u00e9l\u00e9ments de menu existants. #[menu some_name] #type: # Un \u00e9l\u00e9ment parmi command, input, list, text : # command - \u00e9l\u00e9ment de menu de base avec divers d\u00e9clencheurs de script. # input - m\u00eame chose que 'command' mais avec des capacit\u00e9s de changement de valeur. # Pressez pour d\u00e9marrer/arr\u00eater le mode d'\u00e9dition. # list - permet de regrouper les \u00e9l\u00e9ments du menu dans une liste d\u00e9roulante. # Ajoutez \u00e0 la liste en cr\u00e9ant des configurations de menu en utilisant # \"some_list\" comme pr\u00e9fixe - par exemple : # [menu some_list some_item_in_the_list]. # vsdlist - identique \u00e0 'list' mais ajoutera les fichiers de la carte SD virtuelle # (sera supprim\u00e9 dans le futur) #name: # Nom de l'\u00e9l\u00e9ment de menu - \u00e9valu\u00e9 comme un mod\u00e8le. #enable: # Mod\u00e8le \u00e9valu\u00e9 \u00e0 True ou False. #index: # Position o\u00f9 l'\u00e9l\u00e9ment doit \u00eatre ins\u00e9r\u00e9 dans la liste. Par d\u00e9faut # l'\u00e9l\u00e9ment est ajout\u00e9 \u00e0 la fin. #[menu some_list] #type: list #name: #enable: # Voir ci-dessus pour une description de ces param\u00e8tres. #[menu some_list some_command] #type: command #name: #enable: # Voir ci-dessus pour une description de ces param\u00e8tres. #gcode: # Script \u00e0 ex\u00e9cuter lors d'un clic sur un bouton ou un clic long. \u00c9valu\u00e9 comme un # mod\u00e8le. #[menu some_list some_input] #type: input #name: #enable: # Voir ci-dessus pour une description de ces param\u00e8tres. #input: # Valeur initiale \u00e0 utiliser lors de l'\u00e9dition - \u00e9valu\u00e9e comme un mod\u00e8le. # Le r\u00e9sultat doit \u00eatre de type flottant. #input_min: # Valeur minimale de l''intervalle - \u00e9valu\u00e9e comme un mod\u00e8le. Par d\u00e9faut -99999. #input_max: # Valeur maximale de l'intervalle - \u00e9valu\u00e9e comme un mod\u00e8le. Par d\u00e9faut 99999. #input_step: # Pas d'\u00e9dition - Doit \u00eatre un nombre entier positif ou une valeur flottante. Poss\u00e8de # un pas de vitesse rapide interne. Lorsque \"(input_max - input_min) / input_step > 100\" # alors le pas de vitesse rapide est 10 * input_step sinon le pas de vitesse rapide # est le m\u00eame que celui de l'input_step. #realtime: # Cet attribut accepte une valeur bool\u00e9enne statique. Lorsqu'il est activ\u00e9, alors le script # gcode est ex\u00e9cut\u00e9 apr\u00e8s chaque changement de valeur. La valeur par d\u00e9faut est False. #gcode: # Script \u00e0 ex\u00e9cuter lors d'un clic sur un bouton, d'un clic long ou d'un changement de valeur. # \u00c9valu\u00e9 comme un mod\u00e8le. Le clic sur le bouton d\u00e9clenchera le d\u00e9but ou fin du mode d'\u00e9dition.","title":"[menu]"},{"location":"Config_Reference.html#capteurs-de-filaments","text":"","title":"Capteurs de filaments"},{"location":"Config_Reference.html#filament_switch_sensor","text":"Capteur de commutation de filament. Prise en charge de la d\u00e9tection de l'insertion et du d\u00e9placement du filament \u00e0 l'aide d'un capteur de commutation, tel qu'un interrupteur de fin de course. Voir la r\u00e9f\u00e9rence des commandes pour plus d'informations. [filament_switch_sensor my_sensor] #pause_on_runout: True # Lorsque d\u00e9fini sur True, une PAUSE sera ex\u00e9cut\u00e9e imm\u00e9diatement apr\u00e8s qu'un runout # soit d\u00e9tect\u00e9. Notez que si pause_on_runout est False et que le runout_gcode est omis, # la d\u00e9tection du runout est d\u00e9sactiv\u00e9e. Par d\u00e9faut, est True. #runout_gcode: # Une liste de commandes G-Code \u00e0 ex\u00e9cuter apr\u00e8s la d\u00e9tection d'une fin de filament. # Voir docs/Command_Templates.md pour le format G-Code. Si pause_on_runout est # r\u00e9gl\u00e9 sur True, ce G-code sera ex\u00e9cut\u00e9 apr\u00e8s la fin de la PAUSE. Par d\u00e9faut, aucune # commande G-Code n'est ex\u00e9cut\u00e9e. #insert_gcode: # Une liste de commandes G-Code \u00e0 ex\u00e9cuter apr\u00e8s qu'une insertion de filament soit d\u00e9tect\u00e9e. # Voir docs/Command_Templates.md pour le format G-Code. La valeur par d\u00e9faut est de # n'ex\u00e9cuter aucune commande G-Code, ce qui d\u00e9sactive la d\u00e9tection de l'insertion. #event_delay 3.0 # La dur\u00e9e minimale en secondes \u00e0 attendre entre les \u00e9v\u00e9nements. # Des \u00e9v\u00e9nements d\u00e9clench\u00e9s durant cette p\u00e9riode seront silencieusement ignor\u00e9s. # La valeur par d\u00e9faut est de 3 secondes. #pause_delay: 0.5 # Le d\u00e9lai, en secondes, entre l'envoi de la commande de pause et l'ex\u00e9cution du runout_gcode. # Il peut \u00eatre utile d'augmenter ce d\u00e9lai si OctoPrint pr\u00e9sente un comportement \u00e9trange lors de # la pause. La valeur par d\u00e9faut est 0.5 secondes. #switch_pin: # La broche sur laquelle l'interrupteur est connect\u00e9. # Ce param\u00e8tre doit \u00eatre fourni.","title":"[filament_switch_sensor]"},{"location":"Config_Reference.html#filament_motion_sensor","text":"Capteur de mouvement de filament. Prise en charge de la d\u00e9tection de pr\u00e9sence et d\u00e9placement du filament \u00e0 l'aide d'un encodeur basculant la broche de sortie pendant le mouvement du filament dans le capteur. Voir la r\u00e9f\u00e9rence des commandes pour plus d'informations. [filament_motion_sensor my_sensor] detection_length: 7.0 # La longueur minimale du filament tir\u00e9 \u00e0 travers le capteur d\u00e9clenchant # un changement d'\u00e9tat sur la broche de commutation. # La valeur par d\u00e9faut est 7 mm. extruder: # Le nom de la section de l'extrudeuse \u00e0 laquelle ce capteur est associ\u00e9. # Ce param\u00e8tre doit \u00eatre fourni. switch_pin: #pause_on_runout: #runout_gcode: #insert_gcode: #event_delay: #pause_delay: # Voir la section \"filament_switch_sensor\" pour une description des # param\u00e8tres ci-dessus.","title":"[filament_motion_sensor]"},{"location":"Config_Reference.html#tsl1401cl_filament_width_sensor","text":"Capteur de largeur de filament bas\u00e9 sur le TSLl401CL. Voir ce guide pour plus d'informations. [tsl1401cl_filament_width_sensor] #pin: #default_nominal_filament_diameter: 1.75 # (mm) # Diff\u00e9rence maximale de diam\u00e8tre de filament autoris\u00e9e en mm. #max_diff\u00e9rence: 0.2 # La distance entre le capteur et la chambre de fusion en mm. #measurement_delay: 100","title":"[tsl1401cl_filament_width_sensor]"},{"location":"Config_Reference.html#hall_filament_width_sensor","text":"Capteur Hall de largeur de filament (voir Capteur Hall de largeur de filament ). [hall_filament_width_sensor] adc1: adc2: # Broches d'entr\u00e9e analogiques connect\u00e9es au capteur. Ces param\u00e8tres doivent # \u00eatre fournis. #cal_dia1: 1.50 #cal_dia2: 2.00 # Les valeurs d'\u00e9talonnage (en mm) pour les capteurs. La valeur par d\u00e9faut est # 1,50 pour cal_dia1 et 2,00 pour cal_dia2. #raw_dia1: 9500 #raw_dia2: 10500 # Les valeurs brutes d'\u00e9talonnage des capteurs. La valeur par d\u00e9faut est 9500 # pour raw_dia1 et 10500 pour raw_dia2. #default_nominal_filament_diameter: 1.75 # Le diam\u00e8tre nominal du filament. Ce param\u00e8tre doit \u00eatre fourni. #max_difference: 0.200 # Diff\u00e9rence maximale autoris\u00e9e de diam\u00e8tre du filament en millim\u00e8tres (mm). # Si la diff\u00e9rence entre le diam\u00e8tre nominal du filament et la sortie du capteur # est sup\u00e9rieure \u00e0 +- max_difference, le multiplicateur d'extrusion est ramen\u00e9 \u00e0 # \u00e0 %100. La valeur par d\u00e9faut est de 0,200. #measurement_delay: 70 # La distance entre le capteur et la chambre de fusion/la buse en # millim\u00e8tres (mm). Le filament situ\u00e9 entre le capteur et la buse # sera trait\u00e9 comme le default_nominal_filament_diameter. # Ce module h\u00f4te fonctionne avec une logique FIFO. Il conserve chaque valeur # de capteur dans un tableau et les remet (POP) dans la bonne position. Ce # param\u00e8tre doit \u00eatre fourni. #enable: False # Capteur activ\u00e9 ou d\u00e9sactiv\u00e9 apr\u00e8s la mise sous tension. La valeur par d\u00e9faut est # d\u00e9sactiv\u00e9. #measurement_interval: 10 # La distance approximative (en mm) entre les lectures du capteur. La valeur # par d\u00e9faut est de 10mm. #logging: False # Le diam\u00e8tre de sortie vers le terminal et vers klipper.log peut \u00eatre activ\u00e9 par # ce param\u00e8tre. #min_diameter: 1.0 # Diam\u00e8tre minimal pour d\u00e9clencher le capteur virtuel filament_switch_sensor. #use_current_dia_while_delay: False # Utiliser le diam\u00e8tre actuel au lieu du diam\u00e8tre nominal pendant que le d\u00e9lai # de mesure n'est pas \u00e9coul\u00e9. #pause_on_runout: #runout_gcode: #insert_gcode: #event_delay: #pause_delay: # Voir la section \"filament_switch_sensor\" pour une description des # param\u00e8tres ci-dessus.","title":"[hall_filament_width_sensor]"},{"location":"Config_Reference.html#support-materiel-specifique-a-une-carte","text":"","title":"Support mat\u00e9riel sp\u00e9cifique \u00e0 une carte"},{"location":"Config_Reference.html#sx1509","text":"Configuration d'un expandeur SX1509 I2C vers GPIO. En raison du d\u00e9lai encouru par la communication I2C, vous ne devez PAS utiliser les broches du SX1509 comme activation du moteur pas \u00e0 pas, pas ou direction ou toute autre broche n\u00e9cessitant un changement de bit rapide. Il est pr\u00e9f\u00e9rable de les utiliser comme sorties num\u00e9riques statiques ou contr\u00f4l\u00e9es par gcode ou comme broches hardware-pwm pour des ventilateurs par exemple. On peut d\u00e9finir un nombre quelconque de sections avec un pr\u00e9fixe \"sx1509\". Chaque expandeur fournit un ensemble de 16 broches (sx1509_my_sx1509:PIN_0 \u00e0 sx1509_my_sx1509:PIN_15) pouvant \u00eatre utilis\u00e9es dans la configuration de l'imprimante. Voir le fichier generic-duet2-duex.cfg pour un exemple. [sx1509 my_sx1509] i2c_address: # Adresse I2C utilis\u00e9e par cet expandeur. Selon le mat\u00e9riel # il s'agit de l'une des adresses suivantes : 62 63 112 113. # Ce param\u00e8tre doit \u00eatre fourni. #i2c_mcu: #i2c_bus: #i2c_speed: # Voir la section \"param\u00e8tres I2C communs\" pour une description des # param\u00e8tres ci-dessus. #i2c_bus: # Si l'impl\u00e9mentation I2C de votre micro-contr\u00f4leur prend en charge # plusieurs bus I2C, vous pouvez sp\u00e9cifier le nom du bus ici. La valeur # par d\u00e9faut est d'utiliser le bus i2c par d\u00e9faut du micro-contr\u00f4leur.","title":"[sx1509]"},{"location":"Config_Reference.html#samd_sercom","text":"Configuration de SAMD SERCOM pour indiquer les broches \u00e0 utiliser sur un mat\u00e9riel SERCOM. On peut d\u00e9finir un nombre quelconque de sections avec le pr\u00e9fixe \"samd_sercom\". Chaque SERCOM doit \u00eatre configur\u00e9 avant de pouvoir \u00eatre utilis\u00e9 comme p\u00e9riph\u00e9rique SPI ou I2C. Placez cette section de configuration au-dessus de toute autre section qui utilise les bus SPI ou I2C. [samd_sercom my_sercom] sercom: # Le nom du bus sercom \u00e0 configurer dans le micro-contr\u00f4leur. # Les noms disponibles sont \"sercom0\", \"sercom1\", etc. # Ce param\u00e8tredoit \u00eatre fourni. tx_pin: # Broche MOSI pour la communication SPI, ou broche SDA (donn\u00e9es) pour la communication I2C. # La broche doit avoir une configuration pinmux valide pour le p\u00e9riph\u00e9rique SERCOM donn\u00e9. # Ce param\u00e8tre doit \u00eatre fourni. #rx_pin: # Broche MISO pour la communication SPI. Cette broche n'est pas utilis\u00e9e pour la communication I2C # (I2C utilise tx_pin pour l'envoi et la r\u00e9ception). # La broche doit avoir une configuration pinmux valide pour le p\u00e9riph\u00e9rique SERCOM donn\u00e9. # Ce param\u00e8tre est optionnel. clk_pin: # La broche CLK pour la communication SPI, ou la broche SCL (horloge) pour la communication I2C. # La broche doit avoir une configuration pinmux valide pour le p\u00e9riph\u00e9rique SERCOM donn\u00e9. # Ce param\u00e8tre doit \u00eatre fourni","title":"[samd_sercom]"},{"location":"Config_Reference.html#adc_scaled","text":"Mise \u00e0 l'\u00e9chelle analogique du Duet2 Maestro par lectures vref et vssa. D\u00e9finir une section adc_scaled permet d'activer des broches adc virtuelles (telles que \"my_name:PB0\") qui seront automatiquement ajust\u00e9es par les broches de surveillance vref et vssa de la carte. Assurez-vous de d\u00e9finir cette section de configuration au-dessus de toute section de configuration utilisant l'une de ces broches virtuelles. Voir le fichier generic-duet2-maestro.cfg pour un exemple. [adc_scaled my_name] vref_pin : # La broche ADC \u00e0 utiliser pour le contr\u00f4le de VREF. Ce param\u00e8tre doit \u00eatre # fourni. vssa_pin : # La broche ADC \u00e0 utiliser pour la surveillance VSSA. Ce param\u00e8tre doit \u00eatre # fourni. #smooth_time : 2.0 # Une dur\u00e9e (en secondes) durant laquelle les mesures de vref et vssa # seront liss\u00e9es pour r\u00e9duire l'impact du bruit des mesures. # La valeur par d\u00e9faut est de 2 secondes.","title":"[adc_scaled]"},{"location":"Config_Reference.html#replicape","text":"Support de Replicape - voir le guide beaglebone et le fichier generic-replicape.cfg pour un exemple. # La section de configuration \"replicape\" ajoute \"replicape:stepper_x_enable\" pour # l'activation de broches virtuelles de moteur (pour les moteurs X, Y, Z, E et H) et # \"replicape:power_x\" des broches de sortie PWM (pour les pilotes, e, h, fan0, fan1, # fan2, et fan3) utilisables ailleurs dans le fichier de configuration. [replicape] revision: # La r\u00e9vision du mat\u00e9riel replicape. Actuellement, seule la r\u00e9vision \"B3\" est # support\u00e9e. Ce param\u00e8tre doit \u00eatre fourni. #enable_pin: !gpio0_20 # La broche d'activation globale de la replicape. La valeur par d\u00e9faut est !gpio0_20 # (aka P9_41). host_mcu : # Le nom de la section de configuration mcu communiquant avec la section de # l'instance mcu du \"processus linux\" de Klipper. Ce param\u00e8tre doit \u00eatre # fourni. #standstill_power_down: False # Ce param\u00e8tre contr\u00f4le la ligne CFG6_ENN sur tous les moteurs pas \u00e0 pas. # True r\u00e8gle les lignes d'activation sur \"ouvert\". La valeur par d\u00e9faut est # False. #stepper_x_microstep_mode: #stepper_y_microstep_mode: #stepper_z_microstep_mode: #stepper_e_microstep_mode: #stepper_h_microstep_mode: # Ce param\u00e8tre contr\u00f4le les broches CFG1 et CFG2 du pilote de moteur donn\u00e9. # Les options disponibles sont : disable, 1, 2, spread2, 4, 16, spread4, spread16, # stealth4, et stealth16. La valeur par d\u00e9faut est disable. #stepper_x_current: #stepper_y_current: #stepper_z_current: #stepper_e_current: #stepper_h_current: # Le courant maximum configur\u00e9 (en Amp\u00e8res) du moteur pas \u00e0 pas. # Ce param\u00e8tre doit \u00eatre fourni si le moteur pas \u00e0 pas n'est pas dans un # mode d\u00e9sactiv\u00e9. #stepper_x_chopper_off_time_high: #stepper_y_chopper_off_time_high: #stepper_z_chopper_off_time_high: #stepper_e_chopper_off_time_high: #stepper_h_chopper_off_time_high: # Ce param\u00e8tre contr\u00f4le la broche CFG0 du pilote du moteur pas \u00e0 pas. # (True place CFG0 en haut, False le place en bas). La valeur par d\u00e9faut est False. #stepper_x_chopper_hysteresis_high: #stepper_y_chopper_hysteresis_high: #stepper_z_chopper_hysteresis_high: #stepper_e_chopper_hysteresis_high: #stepper_h_chopper_hysteresis_high: # Ce param\u00e8tre contr\u00f4le la broche CFG4 du pilote du moteur pas \u00e0 pas. # (True place CFG4 en haut, False le place en bas). La valeur par d\u00e9faut est False. #stepper_x_chopper_blank_time_high: #stepper_y_chopper_blank_time_high: #stepper_z_chopper_blank_time_high: #stepper_e_chopper_blank_time_high: #stepper_h_chopper_blank_time_high: # Ce param\u00e8tre contr\u00f4le la broche CFG5 du pilote du moteur pas \u00e0 pas. # (True place CFG5 en haut, False le place en bas). La valeur par d\u00e9faut est True.","title":"[replicape]"},{"location":"Config_Reference.html#autres-modules-specifiques","text":"","title":"Autres modules sp\u00e9cifiques"},{"location":"Config_Reference.html#palette2","text":"Prise en charge des multimat\u00e9riaux de la Palette 2 - assure une int\u00e9gration plus \u00e9troite de la prise en charge des p\u00e9riph\u00e9riques de la Palette 2 en mode connect\u00e9. Ce module n\u00e9cessite \u00e9galement [virtual_sdcard] et [pause_resume] pour une fonctionnalit\u00e9 compl\u00e8te. Si vous utilisez ce module, n'utilisez pas le plugin Palette 2 pour Octoprint car ils entreront en conflit, et le module ne pourra pas s'initialiser correctement, ce qui fera \u00e9chouer votre impression. Si vous utilisez Octoprint et que vous diffusez du gcode sur le port s\u00e9rie au lieu d'imprimer \u00e0 partir de virtual_sd, alors supprimez M1 et M0 de Commandes de pause dans Param\u00e8tres > Connexion s\u00e9rie > Firmware & protocole \u00e9vitera d'avoir \u00e0 lancer l'impression sur la Palette 2 et de devoir lever la pause dans Octoprint pour que l'impression commence. [palette2] serial: # Le port s\u00e9rie \u00e0 connecter \u00e0 la Palette 2. #baud: 115200 # Le d\u00e9bit en bauds \u00e0 utiliser. La valeur par d\u00e9faut est 115200. #feedrate_splice: 0.8 # Le taux d'avance \u00e0 utiliser lors de l'\u00e9pissage, la valeur par d\u00e9faut est 0.8. #feedrate_normal: 1.0 # L'avance \u00e0 utiliser apr\u00e8s l'\u00e9pissage, la valeur par d\u00e9faut est 1.0. #auto_load_speed: 2 # Vitesse d'extrusion lors du chargement automatique, par d\u00e9faut 2 (mm/s). #auto_cancel_variation: 0.1 # Annulation automatique de l'impression lorsque la variation du ping est sup\u00e9rieure \u00e0 ce seuil.","title":"[palette2]"},{"location":"Config_Reference.html#angle","text":"Prise en charge du capteur d'angle Hall magn\u00e9tique pour la lecture des mesures de l'angle de l'arbre du moteur pas \u00e0 pas \u00e0 l'aide des puces SPI a1333, as5047d ou tle5012b. Les mesures sont disponibles via le serveur API et l' outil d'analyse de mouvement . Voir la r\u00e9f\u00e9rence G-Code pour les commandes disponibles. [angle my_angle_sensor] sensor_type: # Le type de la puce du capteur magn\u00e9tique \u00e0 effet Hall. Les choix disponibles # sont \"a1333\", \"as5047d\" et \"tle5012b\". Ce param\u00e8tre doit \u00eatre sp\u00e9cifi\u00e9. #sample_period: 0.000400 # La p\u00e9riode de requ\u00eate (en secondes) \u00e0 utiliser lors des mesures. La valeur par # d\u00e9faut est de 0.000400 (ce qui correspond \u00e0 2500 \u00e9chantillons par seconde). #stepper: # Le nom du pilote moteur pas \u00e0 pas auquel le capteur d'angle est attach\u00e9 (ex, # \"stepper_x\"). La d\u00e9finition de cette valeur active un \u00e9talonnage d'angle. # Pour utiliser cette fonction, le paquet Python \"numpy\" doit \u00eatre install\u00e9. # Par d\u00e9faut, l'\u00e9talonnage d'angle n'est pas activ\u00e9 pour un capteur d'angle. cs_pin: # La broche d'activation SPI du capteur. Ce param\u00e8tre doit \u00eatre fourni. #spi_speed: #spi_bus: #spi_software_sclk_pin: #spi_software_mosi_pin: #spi_software_miso_pin: # Voir la section \"param\u00e8tres SPI communs\" pour une description des # param\u00e8tres ci-dessus.","title":"[angle]"},{"location":"Config_Reference.html#parametres-communs-aux-bus","text":"","title":"Param\u00e8tres communs aux bus"},{"location":"Config_Reference.html#parametres-spi-communs","text":"Les param\u00e8tres suivants sont g\u00e9n\u00e9ralement disponibles pour les dispositifs utilisant un bus SPI. #spi_speed: # La vitesse SPI (en hz) \u00e0 utiliser lors de la communication avec le p\u00e9riph\u00e9rique. # La valeur par d\u00e9faut d\u00e9pend du type de p\u00e9riph\u00e9rique. #spi_bus: # Si le micro-contr\u00f4leur supporte plusieurs bus SPI alors on peut sp\u00e9cifier le nom # du bus du micro-contr\u00f4leur ici. La valeur par d\u00e9faut d\u00e9pend du type de # micro-contr\u00f4leur. #spi_software_sclk_pin: #spi_software_mosi_pin: #spi_software_miso_pin: # Sp\u00e9cifiez les param\u00e8tres ci-dessus pour utiliser le \"SPI logiciel\". Ce mode ne # n\u00e9cessite pas le support mat\u00e9riel du micro-contr\u00f4leur (typiquement n'importe # quelle broche d'usage g\u00e9n\u00e9ral peut \u00eatre utilis\u00e9e). La valeur par d\u00e9faut est de # ne pas utiliser le \"spi logiciel\".","title":"Param\u00e8tres SPI communs"},{"location":"Config_Reference.html#parametres-i2c-communs","text":"Les param\u00e8tres suivants sont g\u00e9n\u00e9ralement disponibles pour les dispositifs utilisant un bus I2C. Notez que le support actuel des micro-contr\u00f4leurs de Klipper pour i2c n'est g\u00e9n\u00e9ralement pas tol\u00e9rant au bruit sur la ligne. Des erreurs inattendues sur les fils i2c peuvent entra\u00eener une erreur d'ex\u00e9cution de Klipper. Le support de Klipper de r\u00e9cup\u00e9ration des erreurs varie selon le type de micro-contr\u00f4leur. Il est g\u00e9n\u00e9ralement recommand\u00e9 de n'utiliser que des dispositifs i2c se trouvant sur la m\u00eame carte de circuit imprim\u00e9 que le microcontr\u00f4leur. La plupart des impl\u00e9mentations de micro-contr\u00f4leurs Klipper ne supportent qu'une i2c_speed de 100000. Le micro-contr\u00f4leur Klipper \"linux\" supporte une vitesse de 400000, mais elle doit \u00eatre d\u00e9finie dans le syst\u00e8me d'exploitation sinon le param\u00e8tre i2c_speed est ignor\u00e9. Le micro-contr\u00f4leur Klipper \"rp2040\" supporte un taux de 400000 via le param\u00e8tre i2c_speed . Tous les autres micro-contr\u00f4leurs Klipper utilisent un taux de 100000 et ignorent le param\u00e8tre i2c_speed . #i2c_address: # L'adresse i2c du p\u00e9riph\u00e9rique. Elle doit \u00eatre sp\u00e9cifi\u00e9e sous la forme d'un nombre d\u00e9cimal # (pas en hexad\u00e9cimal). La valeur par d\u00e9faut d\u00e9pend du type de p\u00e9riph\u00e9rique. #i2c_mcu: # Le nom du micro-contr\u00f4leur auquel la puce est connect\u00e9e. # La valeur par d\u00e9faut est \"mcu\". #i2c_bus: # Si le micro-contr\u00f4leur supporte plusieurs bus I2C, on peut sp\u00e9cifier le bus du micro-contr\u00f4leur. # La valeur par d\u00e9faut d\u00e9pend du type de micro-contr\u00f4leur. #i2c_speed: # La vitesse I2C (en Hz) \u00e0 utiliser lors de la communication avec le p\u00e9riph\u00e9rique. # L'impl\u00e9mentation de Klipper pour la plupart des micro-contr\u00f4leurs est cod\u00e9e en dur \u00e0 100000, # modifier cette valeur n'a aucun effet. La valeur par d\u00e9faut est 100000.","title":"Param\u00e8tres I2C communs"},{"location":"Config_checks.html","text":"Contr\u00f4les de la configuration \u00b6 Ce document fournit une liste des \u00e9tapes permettant de v\u00e9rifier les affectations des broches dans le fichier printer.cfg de Klipper. Il est conseill\u00e9 d'ex\u00e9cuter ces \u00e9tapes apr\u00e8s avoir suivi les \u00e9tapes du document d'installation . Pendant ce guide, il peut \u00eatre n\u00e9cessaire d'apporter des modifications au fichier de configuration de Klipper. Veillez \u00e0 \u00e9mettre une commande RESTART apr\u00e8s chaque modification du fichier de configuration pour vous assurer que la modification prend effet (tapez \"restart\" dans l'onglet du terminal Octoprint et cliquez ensuite sur \"Send\"). C'est aussi une bonne id\u00e9e d'envoyer une commande STATUS apr\u00e8s chaque RESTART pour v\u00e9rifier que le fichier de configuration a \u00e9t\u00e9 charg\u00e9 avec succ\u00e8s. V\u00e9rifier la temp\u00e9rature \u00b6 Commencez par v\u00e9rifier que les temp\u00e9ratures sont correctement rapport\u00e9es. Naviguez vers l'onglet temp\u00e9rature d'Octoprint. V\u00e9rifiez que la temp\u00e9rature de la buse et du plateau chauffant (le cas \u00e9ch\u00e9ant) est pr\u00e9sente et n'augmente pas. Si elle augmente, mettez l'imprimante hors tension. Si les temp\u00e9ratures ne sont pas pr\u00e9cises, v\u00e9rifiez les param\u00e8tres \"sensor_type\" et \"sensor_pin\" pour la buse et/ou le plateau chauffant. V\u00e9rifier M112 \u00b6 Naviguez vers l'onglet du terminal Octoprint et lancez une commande M112 dans la bo\u00eete du terminal. Cette commande demande \u00e0 Klipper de se mettre dans un \u00e9tat \"d'arr\u00eat\". Octoprint se d\u00e9connectera de Klipper - naviguez vers la zone de connexion et cliquez sur \"Connecter\" pour reconnecter Octoprint. Ensuite, naviguez vers l'onglet temp\u00e9rature d'Octoprint et v\u00e9rifiez que les temp\u00e9ratures continuent \u00e0 se mettre \u00e0 jour et qu'elles n'augmentent pas. Si les temp\u00e9ratures augmentent, coupez l'alimentation de l'imprimante. La commande M112 fait passer Klipper dans un \u00e9tat \"d'arr\u00eat\". Pour effacer cet \u00e9tat, lancez la commande FIRMWARE_RESTART dans l'onglet du terminal Octoprint. V\u00e9rifier la cartouche chauffante \u00b6 Naviguez jusqu'\u00e0 l'onglet temp\u00e9rature d'Octoprint et tapez 50 suivi d'une entr\u00e9e dans la bo\u00eete de temp\u00e9rature \"Tool\". La temp\u00e9rature de l'extrudeuse dans le graphique devrait commencer \u00e0 augmenter (dans les 30 secondes environ). Ensuite, allez dans la bo\u00eete d\u00e9roulante de la temp\u00e9rature de l'outil et s\u00e9lectionnez \"Off\". Apr\u00e8s plusieurs minutes, la temp\u00e9rature devrait commencer \u00e0 revenir \u00e0 sa valeur initiale de temp\u00e9rature ambiante. Si la temp\u00e9rature n'augmente pas, v\u00e9rifiez le param\u00e8tre \"heater_pin\" dans la configuration. Si l'imprimante est \u00e9quip\u00e9e d'un plateau chauffant, effectuez \u00e0 nouveau le test ci-dessus avec le plateau. V\u00e9rifier l'activation du moteur pas \u00e0 pas \u00b6 V\u00e9rifiez que tous les axes de l'imprimante peuvent se d\u00e9placer librement manuellement (les moteurs pas \u00e0 pas sont d\u00e9sactiv\u00e9s). Si ce n'est pas le cas, lancez une commande M84 pour d\u00e9sactiver les moteurs. Si l'un des axes ne peut toujours pas se d\u00e9placer librement, v\u00e9rifiez la configuration de la \"broche d'activation\" du moteur pas \u00e0 pas pour l'axe en question. Sur la plupart des pilotes de moteurs pas \u00e0 pas, la broche d'activation du moteur est \"active basse\" et la broche d'activation doit donc \u00eatre pr\u00e9c\u00e9d\u00e9e d'un \" !\" (par exemple, \"enable_pin : !ar38\"). V\u00e9rifier les capteurs de fin de course \u00b6 D\u00e9placez manuellement tous les axes de l'imprimante afin qu'aucun d'entre eux ne soit en contact avec une but\u00e9e. Envoyez une commande QUERY_ENDSTOPS via l'onglet du terminal Octoprint. L'imprimante devrait r\u00e9pondre avec l'\u00e9tat actuel de toutes les but\u00e9es configur\u00e9es et elles devraient toutes rapporter un \u00e9tat \"ouvert\". Pour chacun des arr\u00eats, r\u00e9ex\u00e9cutez la commande QUERY_ENDSTOPS en d\u00e9clenchant manuellement l'arr\u00eat. La commande QUERY_ENDSTOPS doit indiquer que la fin de course est \"TRIGGERED\". Si la fin de course semble invers\u00e9e (elle signale qu'elle est \"ouverte\" lorsqu'elle est d\u00e9clench\u00e9e et vice-versa), ajoutez un \" !\" \u00e0 la d\u00e9finition de la broche (par exemple, \"endstop_pin : ^!ar3\"), ou supprimez le \" !\" s'il est d\u00e9j\u00e0 pr\u00e9sent. Si la fin de course ne change pas du tout, cela indique g\u00e9n\u00e9ralement que la fin de course est connect\u00e9e \u00e0 une autre broche. Cependant, cela peut \u00e9galement n\u00e9cessiter une modification du param\u00e8tre de pullup de la broche (le '^' au d\u00e9but du nom endstop_pin - la plupart des imprimantes utilisent une r\u00e9sistance pullup et le '^' doit \u00eatre pr\u00e9sent). V\u00e9rifier les moteurs pas \u00e0 pas \u00b6 Utilisez la commande STEPPER_BUZZ pour v\u00e9rifier la connectivit\u00e9 de chaque moteur pas \u00e0 pas. Commencez par positionner manuellement l'axe donn\u00e9 \u00e0 un point m\u00e9dian, puis ex\u00e9cutez la commande STEPPER_BUZZ STEPPER=stepper_x . La commande STEPPER_BUZZ fera en sorte que le moteur pas \u00e0 pas donn\u00e9 se d\u00e9place d'un millim\u00e8tre dans une direction positive, puis il reviendra \u00e0 sa position de d\u00e9part. (Si la fin de course est d\u00e9finie \u00e0 position_endstop=0, alors au d\u00e9but de chaque mouvement, le stepper s'\u00e9loignera de la fin de course). Il effectuera cette oscillation dix fois. Si le moteur pas \u00e0 pas ne bouge pas du tout, v\u00e9rifiez les r\u00e9glages \"enable_pin\" et \"step_pin\" du moteur pas \u00e0 pas. Si le moteur pas \u00e0 pas se d\u00e9place mais ne revient pas \u00e0 sa position initiale, v\u00e9rifiez le r\u00e9glage \"dir_pin\". Si le moteur pas \u00e0 pas oscille dans une direction incorrecte, cela indique g\u00e9n\u00e9ralement que le param\u00e8tre \"dir_pin\" de l'axe doit \u00eatre invers\u00e9. Pour ce faire, il suffit d'ajouter un \" !\" au param\u00e8tre \"dir_pin\" dans le fichier de configuration de l'imprimante (ou de le supprimer s'il y en a d\u00e9j\u00e0 un). Si le moteur se d\u00e9place de mani\u00e8re significativement sup\u00e9rieure ou inf\u00e9rieure \u00e0 un millim\u00e8tre, v\u00e9rifiez le param\u00e8tre \"rotation_distance\". Ex\u00e9cutez le test ci-dessus pour chaque moteur pas \u00e0 pas d\u00e9fini dans le fichier de configuration. (D\u00e9finissez le param\u00e8tre STEPPER de la commande STEPPER_BUZZ au nom de la section de la configuration qui doit \u00eatre test\u00e9e). S'il n'y a pas de filament dans l'extrudeur, on peut utiliser STEPPER_BUZZ pour v\u00e9rifier la connectivit\u00e9 du moteur de l'extrudeur (utilisez STEPPER=extrudeur). Sinon, il est pr\u00e9f\u00e9rable de tester le moteur de l'extrudeur s\u00e9par\u00e9ment (voir la section suivante). Apr\u00e8s avoir v\u00e9rifi\u00e9 tous les arr\u00eats et tous les moteurs pas \u00e0 pas, le m\u00e9canisme d'auto-home doit \u00eatre test\u00e9. Envoyez une commande G28 pour ramener tous les axes \u00e0 leur position initiale. Coupez l'alimentation de l'imprimante si elle ne se positionne pas correctement. R\u00e9p\u00e9tez les \u00e9tapes de v\u00e9rification des fins de course et des moteurs pas \u00e0 pas si n\u00e9cessaire. V\u00e9rifier le moteur de l'extrudeur \u00b6 Pour tester le moteur de l'extrudeur, il sera n\u00e9cessaire de chauffer l'extrudeur \u00e0 une temp\u00e9rature d'impression. Naviguez vers l'onglet temp\u00e9rature d'Octoprint et s\u00e9lectionnez une temp\u00e9rature cible dans la bo\u00eete d\u00e9roulante de temp\u00e9rature (ou entrez manuellement une temp\u00e9rature appropri\u00e9e). Attendez que l'imprimante atteigne la temp\u00e9rature d\u00e9sir\u00e9e. Naviguez ensuite vers l'onglet de contr\u00f4le Octoprint et cliquez sur le bouton \"Extrude\". V\u00e9rifiez que le moteur de l'extrudeur tourne dans la bonne direction. Si ce n'est pas le cas, consultez les conseils de d\u00e9pannage de la section pr\u00e9c\u00e9dente pour confirmer les param\u00e8tres \"enable_pin\", \"step_pin\" et \"dir_pin\" de l'extrudeur. Calibrer les param\u00e8tres PID \u00b6 Klipper prend en charge le r\u00e9gulateur PID pour l'extrudeuse et le chauffage du lit. Afin d'utiliser ce m\u00e9canisme de contr\u00f4le, il est n\u00e9cessaire de calibrer les param\u00e8tres PID sur chaque imprimante (les param\u00e8tres PID trouv\u00e9s dans d'autres micrologiciels ou dans les fichiers de configuration d'exemple fonctionnent souvent mal). Pour calibrer l'extrudeur, naviguez dans l'onglet du terminal OctoPrint et ex\u00e9cutez la commande PID_CALIBRATE. Par exemple : PID_CALIBRATE HEATER=extruder TARGET=170 A la fin du test de r\u00e9glage, ex\u00e9cutez SAVE_CONFIG pour mettre \u00e0 jour le fichier printer.cfg avec les nouveaux param\u00e8tres PID. Si l'imprimante est \u00e9quip\u00e9e d'un lit chauffant et qu'elle peut \u00eatre pilot\u00e9e par PWM (Pulse Width Modulation), il est recommand\u00e9 d'utiliser la commande PID pour le plateau (lorsque le chauffage du lit est contr\u00f4l\u00e9 \u00e0 l'aide de l'algorithme PID, il peut s'allumer et s'\u00e9teindre dix fois par seconde, ce qui peut ne pas convenir aux chauffages utilisant un interrupteur m\u00e9canique). Une commande typique de calibrage PID du plateau est : PID_CALIBRATE HEATER=heater_bed TARGET=60 Prochaines \u00e9tapes \u00b6 Ce guide a pour but d'aider \u00e0 la v\u00e9rification de base des param\u00e8tres des broches dans le fichier de configuration de Klipper. Veillez \u00e0 lire le guide bed leveling . Consultez \u00e9galement le document Slicers pour obtenir des informations sur la configuration d'un trancheur avec Klipper. Apr\u00e8s avoir v\u00e9rifi\u00e9 que l'impression de base fonctionne, il est bon d'envisager de calibrer l'avance de pression . Il peut \u00eatre n\u00e9cessaire d'effectuer d'autres types de calibrage d\u00e9taill\u00e9 de l'imprimante - un certain nombre de guides sont disponibles en ligne pour vous aider (par exemple, faites une recherche sur le Web pour \"3d printer calibration\"). Par exemple, si vous rencontrez un effet appel\u00e9 \"ringing\", vous pouvez essayer de suivre le guide de r\u00e9glage de la compensation de r\u00e9sonance .","title":"Contr\u00f4les de la configuration"},{"location":"Config_checks.html#controles-de-la-configuration","text":"Ce document fournit une liste des \u00e9tapes permettant de v\u00e9rifier les affectations des broches dans le fichier printer.cfg de Klipper. Il est conseill\u00e9 d'ex\u00e9cuter ces \u00e9tapes apr\u00e8s avoir suivi les \u00e9tapes du document d'installation . Pendant ce guide, il peut \u00eatre n\u00e9cessaire d'apporter des modifications au fichier de configuration de Klipper. Veillez \u00e0 \u00e9mettre une commande RESTART apr\u00e8s chaque modification du fichier de configuration pour vous assurer que la modification prend effet (tapez \"restart\" dans l'onglet du terminal Octoprint et cliquez ensuite sur \"Send\"). C'est aussi une bonne id\u00e9e d'envoyer une commande STATUS apr\u00e8s chaque RESTART pour v\u00e9rifier que le fichier de configuration a \u00e9t\u00e9 charg\u00e9 avec succ\u00e8s.","title":"Contr\u00f4les de la configuration"},{"location":"Config_checks.html#verifier-la-temperature","text":"Commencez par v\u00e9rifier que les temp\u00e9ratures sont correctement rapport\u00e9es. Naviguez vers l'onglet temp\u00e9rature d'Octoprint. V\u00e9rifiez que la temp\u00e9rature de la buse et du plateau chauffant (le cas \u00e9ch\u00e9ant) est pr\u00e9sente et n'augmente pas. Si elle augmente, mettez l'imprimante hors tension. Si les temp\u00e9ratures ne sont pas pr\u00e9cises, v\u00e9rifiez les param\u00e8tres \"sensor_type\" et \"sensor_pin\" pour la buse et/ou le plateau chauffant.","title":"V\u00e9rifier la temp\u00e9rature"},{"location":"Config_checks.html#verifier-m112","text":"Naviguez vers l'onglet du terminal Octoprint et lancez une commande M112 dans la bo\u00eete du terminal. Cette commande demande \u00e0 Klipper de se mettre dans un \u00e9tat \"d'arr\u00eat\". Octoprint se d\u00e9connectera de Klipper - naviguez vers la zone de connexion et cliquez sur \"Connecter\" pour reconnecter Octoprint. Ensuite, naviguez vers l'onglet temp\u00e9rature d'Octoprint et v\u00e9rifiez que les temp\u00e9ratures continuent \u00e0 se mettre \u00e0 jour et qu'elles n'augmentent pas. Si les temp\u00e9ratures augmentent, coupez l'alimentation de l'imprimante. La commande M112 fait passer Klipper dans un \u00e9tat \"d'arr\u00eat\". Pour effacer cet \u00e9tat, lancez la commande FIRMWARE_RESTART dans l'onglet du terminal Octoprint.","title":"V\u00e9rifier M112"},{"location":"Config_checks.html#verifier-la-cartouche-chauffante","text":"Naviguez jusqu'\u00e0 l'onglet temp\u00e9rature d'Octoprint et tapez 50 suivi d'une entr\u00e9e dans la bo\u00eete de temp\u00e9rature \"Tool\". La temp\u00e9rature de l'extrudeuse dans le graphique devrait commencer \u00e0 augmenter (dans les 30 secondes environ). Ensuite, allez dans la bo\u00eete d\u00e9roulante de la temp\u00e9rature de l'outil et s\u00e9lectionnez \"Off\". Apr\u00e8s plusieurs minutes, la temp\u00e9rature devrait commencer \u00e0 revenir \u00e0 sa valeur initiale de temp\u00e9rature ambiante. Si la temp\u00e9rature n'augmente pas, v\u00e9rifiez le param\u00e8tre \"heater_pin\" dans la configuration. Si l'imprimante est \u00e9quip\u00e9e d'un plateau chauffant, effectuez \u00e0 nouveau le test ci-dessus avec le plateau.","title":"V\u00e9rifier la cartouche chauffante"},{"location":"Config_checks.html#verifier-lactivation-du-moteur-pas-a-pas","text":"V\u00e9rifiez que tous les axes de l'imprimante peuvent se d\u00e9placer librement manuellement (les moteurs pas \u00e0 pas sont d\u00e9sactiv\u00e9s). Si ce n'est pas le cas, lancez une commande M84 pour d\u00e9sactiver les moteurs. Si l'un des axes ne peut toujours pas se d\u00e9placer librement, v\u00e9rifiez la configuration de la \"broche d'activation\" du moteur pas \u00e0 pas pour l'axe en question. Sur la plupart des pilotes de moteurs pas \u00e0 pas, la broche d'activation du moteur est \"active basse\" et la broche d'activation doit donc \u00eatre pr\u00e9c\u00e9d\u00e9e d'un \" !\" (par exemple, \"enable_pin : !ar38\").","title":"V\u00e9rifier l'activation du moteur pas \u00e0 pas"},{"location":"Config_checks.html#verifier-les-capteurs-de-fin-de-course","text":"D\u00e9placez manuellement tous les axes de l'imprimante afin qu'aucun d'entre eux ne soit en contact avec une but\u00e9e. Envoyez une commande QUERY_ENDSTOPS via l'onglet du terminal Octoprint. L'imprimante devrait r\u00e9pondre avec l'\u00e9tat actuel de toutes les but\u00e9es configur\u00e9es et elles devraient toutes rapporter un \u00e9tat \"ouvert\". Pour chacun des arr\u00eats, r\u00e9ex\u00e9cutez la commande QUERY_ENDSTOPS en d\u00e9clenchant manuellement l'arr\u00eat. La commande QUERY_ENDSTOPS doit indiquer que la fin de course est \"TRIGGERED\". Si la fin de course semble invers\u00e9e (elle signale qu'elle est \"ouverte\" lorsqu'elle est d\u00e9clench\u00e9e et vice-versa), ajoutez un \" !\" \u00e0 la d\u00e9finition de la broche (par exemple, \"endstop_pin : ^!ar3\"), ou supprimez le \" !\" s'il est d\u00e9j\u00e0 pr\u00e9sent. Si la fin de course ne change pas du tout, cela indique g\u00e9n\u00e9ralement que la fin de course est connect\u00e9e \u00e0 une autre broche. Cependant, cela peut \u00e9galement n\u00e9cessiter une modification du param\u00e8tre de pullup de la broche (le '^' au d\u00e9but du nom endstop_pin - la plupart des imprimantes utilisent une r\u00e9sistance pullup et le '^' doit \u00eatre pr\u00e9sent).","title":"V\u00e9rifier les capteurs de fin de course"},{"location":"Config_checks.html#verifier-les-moteurs-pas-a-pas","text":"Utilisez la commande STEPPER_BUZZ pour v\u00e9rifier la connectivit\u00e9 de chaque moteur pas \u00e0 pas. Commencez par positionner manuellement l'axe donn\u00e9 \u00e0 un point m\u00e9dian, puis ex\u00e9cutez la commande STEPPER_BUZZ STEPPER=stepper_x . La commande STEPPER_BUZZ fera en sorte que le moteur pas \u00e0 pas donn\u00e9 se d\u00e9place d'un millim\u00e8tre dans une direction positive, puis il reviendra \u00e0 sa position de d\u00e9part. (Si la fin de course est d\u00e9finie \u00e0 position_endstop=0, alors au d\u00e9but de chaque mouvement, le stepper s'\u00e9loignera de la fin de course). Il effectuera cette oscillation dix fois. Si le moteur pas \u00e0 pas ne bouge pas du tout, v\u00e9rifiez les r\u00e9glages \"enable_pin\" et \"step_pin\" du moteur pas \u00e0 pas. Si le moteur pas \u00e0 pas se d\u00e9place mais ne revient pas \u00e0 sa position initiale, v\u00e9rifiez le r\u00e9glage \"dir_pin\". Si le moteur pas \u00e0 pas oscille dans une direction incorrecte, cela indique g\u00e9n\u00e9ralement que le param\u00e8tre \"dir_pin\" de l'axe doit \u00eatre invers\u00e9. Pour ce faire, il suffit d'ajouter un \" !\" au param\u00e8tre \"dir_pin\" dans le fichier de configuration de l'imprimante (ou de le supprimer s'il y en a d\u00e9j\u00e0 un). Si le moteur se d\u00e9place de mani\u00e8re significativement sup\u00e9rieure ou inf\u00e9rieure \u00e0 un millim\u00e8tre, v\u00e9rifiez le param\u00e8tre \"rotation_distance\". Ex\u00e9cutez le test ci-dessus pour chaque moteur pas \u00e0 pas d\u00e9fini dans le fichier de configuration. (D\u00e9finissez le param\u00e8tre STEPPER de la commande STEPPER_BUZZ au nom de la section de la configuration qui doit \u00eatre test\u00e9e). S'il n'y a pas de filament dans l'extrudeur, on peut utiliser STEPPER_BUZZ pour v\u00e9rifier la connectivit\u00e9 du moteur de l'extrudeur (utilisez STEPPER=extrudeur). Sinon, il est pr\u00e9f\u00e9rable de tester le moteur de l'extrudeur s\u00e9par\u00e9ment (voir la section suivante). Apr\u00e8s avoir v\u00e9rifi\u00e9 tous les arr\u00eats et tous les moteurs pas \u00e0 pas, le m\u00e9canisme d'auto-home doit \u00eatre test\u00e9. Envoyez une commande G28 pour ramener tous les axes \u00e0 leur position initiale. Coupez l'alimentation de l'imprimante si elle ne se positionne pas correctement. R\u00e9p\u00e9tez les \u00e9tapes de v\u00e9rification des fins de course et des moteurs pas \u00e0 pas si n\u00e9cessaire.","title":"V\u00e9rifier les moteurs pas \u00e0 pas"},{"location":"Config_checks.html#verifier-le-moteur-de-lextrudeur","text":"Pour tester le moteur de l'extrudeur, il sera n\u00e9cessaire de chauffer l'extrudeur \u00e0 une temp\u00e9rature d'impression. Naviguez vers l'onglet temp\u00e9rature d'Octoprint et s\u00e9lectionnez une temp\u00e9rature cible dans la bo\u00eete d\u00e9roulante de temp\u00e9rature (ou entrez manuellement une temp\u00e9rature appropri\u00e9e). Attendez que l'imprimante atteigne la temp\u00e9rature d\u00e9sir\u00e9e. Naviguez ensuite vers l'onglet de contr\u00f4le Octoprint et cliquez sur le bouton \"Extrude\". V\u00e9rifiez que le moteur de l'extrudeur tourne dans la bonne direction. Si ce n'est pas le cas, consultez les conseils de d\u00e9pannage de la section pr\u00e9c\u00e9dente pour confirmer les param\u00e8tres \"enable_pin\", \"step_pin\" et \"dir_pin\" de l'extrudeur.","title":"V\u00e9rifier le moteur de l'extrudeur"},{"location":"Config_checks.html#calibrer-les-parametres-pid","text":"Klipper prend en charge le r\u00e9gulateur PID pour l'extrudeuse et le chauffage du lit. Afin d'utiliser ce m\u00e9canisme de contr\u00f4le, il est n\u00e9cessaire de calibrer les param\u00e8tres PID sur chaque imprimante (les param\u00e8tres PID trouv\u00e9s dans d'autres micrologiciels ou dans les fichiers de configuration d'exemple fonctionnent souvent mal). Pour calibrer l'extrudeur, naviguez dans l'onglet du terminal OctoPrint et ex\u00e9cutez la commande PID_CALIBRATE. Par exemple : PID_CALIBRATE HEATER=extruder TARGET=170 A la fin du test de r\u00e9glage, ex\u00e9cutez SAVE_CONFIG pour mettre \u00e0 jour le fichier printer.cfg avec les nouveaux param\u00e8tres PID. Si l'imprimante est \u00e9quip\u00e9e d'un lit chauffant et qu'elle peut \u00eatre pilot\u00e9e par PWM (Pulse Width Modulation), il est recommand\u00e9 d'utiliser la commande PID pour le plateau (lorsque le chauffage du lit est contr\u00f4l\u00e9 \u00e0 l'aide de l'algorithme PID, il peut s'allumer et s'\u00e9teindre dix fois par seconde, ce qui peut ne pas convenir aux chauffages utilisant un interrupteur m\u00e9canique). Une commande typique de calibrage PID du plateau est : PID_CALIBRATE HEATER=heater_bed TARGET=60","title":"Calibrer les param\u00e8tres PID"},{"location":"Config_checks.html#prochaines-etapes","text":"Ce guide a pour but d'aider \u00e0 la v\u00e9rification de base des param\u00e8tres des broches dans le fichier de configuration de Klipper. Veillez \u00e0 lire le guide bed leveling . Consultez \u00e9galement le document Slicers pour obtenir des informations sur la configuration d'un trancheur avec Klipper. Apr\u00e8s avoir v\u00e9rifi\u00e9 que l'impression de base fonctionne, il est bon d'envisager de calibrer l'avance de pression . Il peut \u00eatre n\u00e9cessaire d'effectuer d'autres types de calibrage d\u00e9taill\u00e9 de l'imprimante - un certain nombre de guides sont disponibles en ligne pour vous aider (par exemple, faites une recherche sur le Web pour \"3d printer calibration\"). Par exemple, si vous rencontrez un effet appel\u00e9 \"ringing\", vous pouvez essayer de suivre le guide de r\u00e9glage de la compensation de r\u00e9sonance .","title":"Prochaines \u00e9tapes"},{"location":"Contact.html","text":"Contact \u00b6 Ce document fourni les informations de contact pour Klipper. Forum de la Communaut\u00e9 Salon Discord J'ai une question au sujet de Klipper J'ai une demande d'ajout de fonctionnalit\u00e9 A l'aide ! Ca ne fonctionne pas ! J'ai trouv\u00e9 un bug dans le logiciel Klipper J\u2019apporte des modifications que j\u2019aimerais inclure dans Klipper Github Klipper Forum de la communaut\u00e9 \u00b6 Il y a un Serveur Communautaire Discourse Klipper pour les discussions sur Klipper. Salon Discord \u00b6 Un serveur Discord d\u00e9di\u00e9 \u00e0 Klipper est l\u00e0 : https://discord.klipper3d.org . Ce serveur, g\u00e9r\u00e9 par une communaut\u00e9 de passionn\u00e9s de Klipper, est d\u00e9di\u00e9 aux discussions sur Klipper. Il permet aux utilisateurs de discuter en temps r\u00e9el. J'ai une question sur Klipper \u00b6 La plupart des questions que nous recevons ont d\u00e9j\u00e0 une r\u00e9ponse dans la documentation de Klipper . Assurez-vous de bien la lire et de suivre les instructions qui y sont fournies. Il est \u00e9galement possible de rechercher des questions similaires sur le Forum de la communaut\u00e9 Klipper . Si vous souhaitez partager vos connaissances et votre exp\u00e9rience avec d'autres utilisateurs de Klipper, vous pouvez rejoindre le Forum de la communaut\u00e9 Klipper ou encore le Salon Discord Klipper . Il s'agit de deux communaut\u00e9s o\u00f9 les utilisateurs de Klipper peuvent discuter du logiciel avec d'autres. De nombreuses questions que nous recevons sont relatives \u00e0 l'impression 3D en g\u00e9n\u00e9ral et ne sont pas sp\u00e9cifiques \u00e0 Klipper. Si vous avez une question ou si vous rencontrez des probl\u00e8mes d'impression en g\u00e9n\u00e9ral, vous obtiendrez probablement une meilleure r\u00e9ponse en la posant sur un forum consacr\u00e9 \u00e0 l'impression 3D dans la globalit\u00e9 ou bien sur un d\u00e9di\u00e9 au mat\u00e9riel de votre imprimante. J'ai une demande d'ajout de fonctionnalit\u00e9 \u00b6 Toute nouvelle fonctionnalit\u00e9 n\u00e9cessite d'avoir une personne int\u00e9ress\u00e9e et en capacit\u00e9 de la mettre en oeuvre. Si vous souhaitez aider \u00e0 impl\u00e9menter ou tester une fonctionnalit\u00e9, nous pouvez consulter les d\u00e9veloppements en cours sur le Forum de la Communaut\u00e9 Klipper . Le Salon Discord Klipper est \u00e9galement l\u00e0 pour les discussions entre contributeurs. A l'aide ! Ca ne fonctionne pas ! \u00b6 Malheureusement, nous recevons beaucoup plus de demandes d'aide que nous ne pouvons en traiter. La majorit\u00e9 des rapports d'anomalie que nous recevons sont g\u00e9n\u00e9ralement li\u00e9s \u00e0 : Des erreurs subtiles dans le mat\u00e9riel, ou Ne pas avoir suivi toutes les \u00e9tapes d\u00e9crites dans la documentation de Klipper. Si vous rencontrez des soucis, nous vous recommandons de lire attentivement la documentation de Klipper et de v\u00e9rifier que toutes les \u00e9tapes ont \u00e9t\u00e9 suivies. Si vous rencontrez des soucis d'impression, nous vous recommandons d'inspecter minutieusement votre imprimante pour voir s'il n'y a pas d'anomalies (joints, vis, fils, etc). Nous avons remarqu\u00e9 que la plupart des anomalies ne sont pas sp\u00e9cifiquement li\u00e9es \u00e0 Klipper. Si vous avez un probl\u00e8me avec votre imprimante, vous obtiendrez s\u00fbrement une meilleure r\u00e9ponse en recherchant sur un forum d\u00e9di\u00e9 \u00e0 l'impression 3D en g\u00e9n\u00e9ral ou bien sur un consacr\u00e9 au mat\u00e9riel de votre imprimante. Il est \u00e9galement possible de rechercher des questions similaires sur le Forum de la communaut\u00e9 Klipper . Si vous souhaitez partager vos connaissances et votre exp\u00e9rience avec d'autres utilisateurs de Klipper, vous pouvez rejoindre le Forum de la communaut\u00e9 Klipper ou encore le Salon Discord Klipper . Il s'agit de deux communaut\u00e9s o\u00f9 les utilisateurs de Klipper peuvent discuter du logiciel avec d'autres. J'ai trouv\u00e9 un bug dans le logiciel Klipper \u00b6 Klipper est un projet open-source et nous appr\u00e9cions quand des contributeurs diagnostiquent des erreurs dans le logiciel. Les probl\u00e8mes devraient \u00eatre signal\u00e9s dans le Forum communautaire Klipper . Il y a des informations importantes qui sont n\u00e9cessaires pour pouvoir corriger un bug. Veuillez suivre ces \u00e9tapes : Assurez-vous que vous ex\u00e9cutez le code non modifi\u00e9 de https://github.com/Klipper3d/klipper . Si le code a \u00e9t\u00e9 modifi\u00e9 ou provient d'une autre source, vous devez reproduire le probl\u00e8me sur le code non modifi\u00e9 de https://github.com/Klipper3d/klipper avant de le signaler. Si possible, ex\u00e9cutez une commande M112 imm\u00e9diatement apr\u00e8s que l'\u00e9v\u00e9nement ind\u00e9sirable se soit produit. Klipper se met alors dans un \"\u00e9tat d'arr\u00eat\" et des informations de d\u00e9bogage suppl\u00e9mentaires sont \u00e9crites dans le fichier journal. R\u00e9cup\u00e9rez l'\u00e9v\u00e9nement depuis le fichier journal Klipper. Ce journal a \u00e9t\u00e9 con\u00e7u pour r\u00e9pondre aux questions courantes que les d\u00e9veloppeurs de Klipper se posent sur le logiciel et son environnement (version du logiciel, type de mat\u00e9riel, configuration, \u00e0 quel moment l'anomalie eu lieu, et des centaines d'autres questions). Le fichier journal de Klipper est situ\u00e9 dans /tmp/klippy.log sur l'ordinateur \"h\u00f4te\" de Klipper (le Raspberry Pi). Un utilitaire comme \"scp\" ou \"sftp\" est n\u00e9cessaire pour copier ce fichier journal sur votre ordinateur. L'utilitaire \"scp\" est fourni en standard avec les syst\u00e8mes Linux et MacOS. Il existe des utilitaires scp disponibles gratuitement pour d'autres syst\u00e8mes (par exemple, WinSCP). Si vous utilisez un utilitaire scp graphique qui ne peut pas copier directement /tmp/klippy.log , cliquez plusieurs fois sur ... ou dossier parent jusqu'\u00e0 ce que vous arriviez au r\u00e9pertoire racine, cliquez ensuite sur le dossier tmp , puis s\u00e9lectionnez le fichier klippy.log . Copiez le fichier journal sur votre bureau afin de le joindre au rapport d'anomalie. Ne modifiez pas le fichier journal de quelque fa\u00e7on que ce soit ; ne fournissez pas un extrait non plus. Seul le fichier journal complet sans alt\u00e9ration fournira les informations n\u00e9cessaires. C'est une bonne id\u00e9e de compresser le fichier journal avec zip ou gzip. Ouvrez un nouveau sujet sur le Forum communautaire Klipper et fournissez une description claire du probl\u00e8me. Les autres contributeurs de Klipper devront comprendre quelles mesures ont \u00e9t\u00e9 prises, quel \u00e9tait le r\u00e9sultat souhait\u00e9 et quel r\u00e9sultat s'est effectivement produit. Le fichier journal Klipper compress\u00e9 doit \u00eatre joint \u00e0 ce sujet. J\u2019apporte des modifications que j\u2019aimerais inclure dans Klipper \u00b6 Klipper est un logiciel libre et nous appr\u00e9cions les nouvelles contributions. Les nouvelles contributions (que ce soit pour le code ou pour la documentation) sont soumises au moyen de Pull Requests Github. R\u00e9f\u00e9rez-vous au document CONTRIBUTIONS pour conna\u00eetre les informations importantes \u00e0 ce sujet. Il existe plusieurs documents pour les d\u00e9veloppeurs . Si vous avez des questions sur le code, vous pouvez \u00e9galement les poser sur le Forum de la communaut\u00e9 Klipper ou sur le Discord de la communaut\u00e9 Klipper . GitHub Klipper \u00b6 Le GitHub de Klipper peut \u00eatre utilis\u00e9 par les contributeurs pour partager l'\u00e9tat de leur travail pour am\u00e9liorer Klipper. On s'attend \u00e0 ce que la personne qui ouvre un ticket github travaille activement sur la t\u00e2che donn\u00e9e et soit celle qui effectue tout le travail n\u00e9cessaire pour l'accomplir. Le GitHub de Klipper n'est pas utilis\u00e9 pour les demandes, ni pour signaler des bogues, ni pour poser des questions. Utilisez plut\u00f4t le Forum communautaire Klipper ou le Discord communautaire Klipper .","title":"Contact"},{"location":"Contact.html#contact","text":"Ce document fourni les informations de contact pour Klipper. Forum de la Communaut\u00e9 Salon Discord J'ai une question au sujet de Klipper J'ai une demande d'ajout de fonctionnalit\u00e9 A l'aide ! Ca ne fonctionne pas ! J'ai trouv\u00e9 un bug dans le logiciel Klipper J\u2019apporte des modifications que j\u2019aimerais inclure dans Klipper Github Klipper","title":"Contact"},{"location":"Contact.html#forum-de-la-communaute","text":"Il y a un Serveur Communautaire Discourse Klipper pour les discussions sur Klipper.","title":"Forum de la communaut\u00e9"},{"location":"Contact.html#salon-discord","text":"Un serveur Discord d\u00e9di\u00e9 \u00e0 Klipper est l\u00e0 : https://discord.klipper3d.org . Ce serveur, g\u00e9r\u00e9 par une communaut\u00e9 de passionn\u00e9s de Klipper, est d\u00e9di\u00e9 aux discussions sur Klipper. Il permet aux utilisateurs de discuter en temps r\u00e9el.","title":"Salon Discord"},{"location":"Contact.html#jai-une-question-sur-klipper","text":"La plupart des questions que nous recevons ont d\u00e9j\u00e0 une r\u00e9ponse dans la documentation de Klipper . Assurez-vous de bien la lire et de suivre les instructions qui y sont fournies. Il est \u00e9galement possible de rechercher des questions similaires sur le Forum de la communaut\u00e9 Klipper . Si vous souhaitez partager vos connaissances et votre exp\u00e9rience avec d'autres utilisateurs de Klipper, vous pouvez rejoindre le Forum de la communaut\u00e9 Klipper ou encore le Salon Discord Klipper . Il s'agit de deux communaut\u00e9s o\u00f9 les utilisateurs de Klipper peuvent discuter du logiciel avec d'autres. De nombreuses questions que nous recevons sont relatives \u00e0 l'impression 3D en g\u00e9n\u00e9ral et ne sont pas sp\u00e9cifiques \u00e0 Klipper. Si vous avez une question ou si vous rencontrez des probl\u00e8mes d'impression en g\u00e9n\u00e9ral, vous obtiendrez probablement une meilleure r\u00e9ponse en la posant sur un forum consacr\u00e9 \u00e0 l'impression 3D dans la globalit\u00e9 ou bien sur un d\u00e9di\u00e9 au mat\u00e9riel de votre imprimante.","title":"J'ai une question sur Klipper"},{"location":"Contact.html#jai-une-demande-dajout-de-fonctionnalite","text":"Toute nouvelle fonctionnalit\u00e9 n\u00e9cessite d'avoir une personne int\u00e9ress\u00e9e et en capacit\u00e9 de la mettre en oeuvre. Si vous souhaitez aider \u00e0 impl\u00e9menter ou tester une fonctionnalit\u00e9, nous pouvez consulter les d\u00e9veloppements en cours sur le Forum de la Communaut\u00e9 Klipper . Le Salon Discord Klipper est \u00e9galement l\u00e0 pour les discussions entre contributeurs.","title":"J'ai une demande d'ajout de fonctionnalit\u00e9"},{"location":"Contact.html#a-laide-ca-ne-fonctionne-pas","text":"Malheureusement, nous recevons beaucoup plus de demandes d'aide que nous ne pouvons en traiter. La majorit\u00e9 des rapports d'anomalie que nous recevons sont g\u00e9n\u00e9ralement li\u00e9s \u00e0 : Des erreurs subtiles dans le mat\u00e9riel, ou Ne pas avoir suivi toutes les \u00e9tapes d\u00e9crites dans la documentation de Klipper. Si vous rencontrez des soucis, nous vous recommandons de lire attentivement la documentation de Klipper et de v\u00e9rifier que toutes les \u00e9tapes ont \u00e9t\u00e9 suivies. Si vous rencontrez des soucis d'impression, nous vous recommandons d'inspecter minutieusement votre imprimante pour voir s'il n'y a pas d'anomalies (joints, vis, fils, etc). Nous avons remarqu\u00e9 que la plupart des anomalies ne sont pas sp\u00e9cifiquement li\u00e9es \u00e0 Klipper. Si vous avez un probl\u00e8me avec votre imprimante, vous obtiendrez s\u00fbrement une meilleure r\u00e9ponse en recherchant sur un forum d\u00e9di\u00e9 \u00e0 l'impression 3D en g\u00e9n\u00e9ral ou bien sur un consacr\u00e9 au mat\u00e9riel de votre imprimante. Il est \u00e9galement possible de rechercher des questions similaires sur le Forum de la communaut\u00e9 Klipper . Si vous souhaitez partager vos connaissances et votre exp\u00e9rience avec d'autres utilisateurs de Klipper, vous pouvez rejoindre le Forum de la communaut\u00e9 Klipper ou encore le Salon Discord Klipper . Il s'agit de deux communaut\u00e9s o\u00f9 les utilisateurs de Klipper peuvent discuter du logiciel avec d'autres.","title":"A l'aide ! Ca ne fonctionne pas !"},{"location":"Contact.html#jai-trouve-un-bug-dans-le-logiciel-klipper","text":"Klipper est un projet open-source et nous appr\u00e9cions quand des contributeurs diagnostiquent des erreurs dans le logiciel. Les probl\u00e8mes devraient \u00eatre signal\u00e9s dans le Forum communautaire Klipper . Il y a des informations importantes qui sont n\u00e9cessaires pour pouvoir corriger un bug. Veuillez suivre ces \u00e9tapes : Assurez-vous que vous ex\u00e9cutez le code non modifi\u00e9 de https://github.com/Klipper3d/klipper . Si le code a \u00e9t\u00e9 modifi\u00e9 ou provient d'une autre source, vous devez reproduire le probl\u00e8me sur le code non modifi\u00e9 de https://github.com/Klipper3d/klipper avant de le signaler. Si possible, ex\u00e9cutez une commande M112 imm\u00e9diatement apr\u00e8s que l'\u00e9v\u00e9nement ind\u00e9sirable se soit produit. Klipper se met alors dans un \"\u00e9tat d'arr\u00eat\" et des informations de d\u00e9bogage suppl\u00e9mentaires sont \u00e9crites dans le fichier journal. R\u00e9cup\u00e9rez l'\u00e9v\u00e9nement depuis le fichier journal Klipper. Ce journal a \u00e9t\u00e9 con\u00e7u pour r\u00e9pondre aux questions courantes que les d\u00e9veloppeurs de Klipper se posent sur le logiciel et son environnement (version du logiciel, type de mat\u00e9riel, configuration, \u00e0 quel moment l'anomalie eu lieu, et des centaines d'autres questions). Le fichier journal de Klipper est situ\u00e9 dans /tmp/klippy.log sur l'ordinateur \"h\u00f4te\" de Klipper (le Raspberry Pi). Un utilitaire comme \"scp\" ou \"sftp\" est n\u00e9cessaire pour copier ce fichier journal sur votre ordinateur. L'utilitaire \"scp\" est fourni en standard avec les syst\u00e8mes Linux et MacOS. Il existe des utilitaires scp disponibles gratuitement pour d'autres syst\u00e8mes (par exemple, WinSCP). Si vous utilisez un utilitaire scp graphique qui ne peut pas copier directement /tmp/klippy.log , cliquez plusieurs fois sur ... ou dossier parent jusqu'\u00e0 ce que vous arriviez au r\u00e9pertoire racine, cliquez ensuite sur le dossier tmp , puis s\u00e9lectionnez le fichier klippy.log . Copiez le fichier journal sur votre bureau afin de le joindre au rapport d'anomalie. Ne modifiez pas le fichier journal de quelque fa\u00e7on que ce soit ; ne fournissez pas un extrait non plus. Seul le fichier journal complet sans alt\u00e9ration fournira les informations n\u00e9cessaires. C'est une bonne id\u00e9e de compresser le fichier journal avec zip ou gzip. Ouvrez un nouveau sujet sur le Forum communautaire Klipper et fournissez une description claire du probl\u00e8me. Les autres contributeurs de Klipper devront comprendre quelles mesures ont \u00e9t\u00e9 prises, quel \u00e9tait le r\u00e9sultat souhait\u00e9 et quel r\u00e9sultat s'est effectivement produit. Le fichier journal Klipper compress\u00e9 doit \u00eatre joint \u00e0 ce sujet.","title":"J'ai trouv\u00e9 un bug dans le logiciel Klipper"},{"location":"Contact.html#japporte-des-modifications-que-jaimerais-inclure-dans-klipper","text":"Klipper est un logiciel libre et nous appr\u00e9cions les nouvelles contributions. Les nouvelles contributions (que ce soit pour le code ou pour la documentation) sont soumises au moyen de Pull Requests Github. R\u00e9f\u00e9rez-vous au document CONTRIBUTIONS pour conna\u00eetre les informations importantes \u00e0 ce sujet. Il existe plusieurs documents pour les d\u00e9veloppeurs . Si vous avez des questions sur le code, vous pouvez \u00e9galement les poser sur le Forum de la communaut\u00e9 Klipper ou sur le Discord de la communaut\u00e9 Klipper .","title":"J\u2019apporte des modifications que j\u2019aimerais inclure dans Klipper"},{"location":"Contact.html#github-klipper","text":"Le GitHub de Klipper peut \u00eatre utilis\u00e9 par les contributeurs pour partager l'\u00e9tat de leur travail pour am\u00e9liorer Klipper. On s'attend \u00e0 ce que la personne qui ouvre un ticket github travaille activement sur la t\u00e2che donn\u00e9e et soit celle qui effectue tout le travail n\u00e9cessaire pour l'accomplir. Le GitHub de Klipper n'est pas utilis\u00e9 pour les demandes, ni pour signaler des bogues, ni pour poser des questions. Utilisez plut\u00f4t le Forum communautaire Klipper ou le Discord communautaire Klipper .","title":"GitHub Klipper"},{"location":"Debugging.html","text":"D\u00e9bogage \u00b6 Ce document d\u00e9crit certains des outils de d\u00e9bogage de Klipper. Ex\u00e9cution des tests de non-r\u00e9gression \u00b6 Le r\u00e9f\u00e9rentiel principal Klipper GitHub utilise des \"github actions\" pour ex\u00e9cuter une s\u00e9rie de tests de non-r\u00e9gression. Il peut \u00eatre utile d'ex\u00e9cuter certains de ces tests localement. La \"v\u00e9rification des espaces\" dans le code source peut \u00eatre ex\u00e9cut\u00e9e avec : ./scripts/check_whitespace.sh La suite de tests de non-r\u00e9gression Klippy n\u00e9cessite les \"dictionnaires de donn\u00e9es\" de nombreuses plates-formes. Le moyen le plus simple de les obtenir est de les t\u00e9l\u00e9charger depuis github . Une fois les dictionnaires de donn\u00e9es t\u00e9l\u00e9charg\u00e9s, utilisez les \u00e9l\u00e9ments suivants pour ex\u00e9cuter la suite de tests de non-r\u00e9gression : tar xfz klipper-dict-20??????.tar.gz ~/klippy-env/bin/python ~/klipper/scripts/test_klippy.py -d dict/ ~/klipper/test/klippy/*.test Envoi manuel de commandes au microcontr\u00f4leur \u00b6 Normalement, le processus h\u00f4te klippy.py est utilis\u00e9 pour traduire les commandes gcode en commandes de microcontr\u00f4leur Klipper. Cependant, il est \u00e9galement possible d'envoyer manuellement ces commandes MCU (fonctions marqu\u00e9es avec la macro DECL_COMMAND() dans le code source de Klipper). Pour ce faire, ex\u00e9cutez : ~/klippy-env/bin/python ./klippy/console.py /tmp/pseudoserial Voir la commande \"AIDE\" dans l'outil pour plus d'informations sur sa fonctionnalit\u00e9. Certaines options en ligne de commande sont disponibles. Pour plus d'informations, ex\u00e9cutez : ~/klippy-env/bin/python ./klippy/console.py --help Traduction des fichiers G-Code en commandes de microcontr\u00f4leur \u00b6 Le code h\u00f4te Klippy peut s'ex\u00e9cuter en mode batch pour produire les commandes de microcontr\u00f4leur de bas niveau associ\u00e9es \u00e0 un fichier gcode. L'inspection de ces commandes de bas niveau est utile lorsque vous essayez de comprendre les actions du mat\u00e9riel de bas niveau. Il peut \u00e9galement \u00eatre utile de comparer la diff\u00e9rence des commandes du microcontr\u00f4leur apr\u00e8s un changement de code. Pour ex\u00e9cuter Klippy dans ce mode batch, il y a une seule \u00e9tape n\u00e9cessaire pour g\u00e9n\u00e9rer le \"dictionnaire de donn\u00e9es\" du microcontr\u00f4leur. Cela se fait en compilant le code du micro-contr\u00f4leur pour obtenir le fichier out/klipper.dict : make menuconfig make Une fois que ce qui pr\u00e9c\u00e8de est fait, il est possible d'ex\u00e9cuter Klipper en mode batch (voir installation pour les \u00e9tapes n\u00e9cessaires pour construire l'environnement virtuel python et un fichier printer.cfg) : ~/klippy-env/bin/python ./klippy/klippy.py ~/printer.cfg -i test.gcode -o test.serial -v -d out/klipper.dict Ce qui pr\u00e9c\u00e8de produira un fichier test.serial avec la sortie s\u00e9rie binaire. Cette sortie peut \u00eatre traduite en texte lisible avec : ~/klippy-env/bin/python ./klippy/parsedump.py out/klipper.dict test.serial > test.txt Le fichier r\u00e9sultant test.txt contient une liste lisible des commandes du microcontr\u00f4leur. Le mode batch d\u00e9sactive certaines commandes de r\u00e9ponse/requ\u00eate pour fonctionner. Par cons\u00e9quent, il y aura des diff\u00e9rences entre les commandes r\u00e9elles et la sortie ci-dessus. Les donn\u00e9es g\u00e9n\u00e9r\u00e9es sont utiles pour les tests et l'inspection ; elles ne sont pas utiles en fonctionnement normale (vers un vrai microcontr\u00f4leur). Analyse de mouvements et enregistrement de donn\u00e9es \u00b6 Klipper prend en charge la journalisation de l'historique des mouvement, qui peut \u00eatre analys\u00e9 ult\u00e9rieurement. Pour utiliser cette fonctionnalit\u00e9, Klipper doit \u00eatre d\u00e9marr\u00e9 avec le Serveur API activ\u00e9. L'enregistrement des donn\u00e9es est activ\u00e9 avec l'outil data_logger.py . Par example\u202f: ~/klipper/scripts/motan/data_logger.py /tmp/klippy_uds mylog Cette commande se connectera au serveur API de Klipper, s'abonnera aux informations d'\u00e9tat et de mouvement et consignera les r\u00e9sultats. Deux fichiers sont g\u00e9n\u00e9r\u00e9s : un fichier de donn\u00e9es compress\u00e9es et un fichier d'index (par exemple, mylog.json.gz et mylog.index.gz ). Apr\u00e8s avoir d\u00e9marr\u00e9 la journalisation, il est possible d'effectuer des impressions et d'autres actions - la journalisation se poursuivra en arri\u00e8re-plan. Une fois la journalisation termin\u00e9e, appuyez sur ctrl-c pour quitter l'outil data_logger.py . Les fichiers r\u00e9sultants peuvent \u00eatre lus et repr\u00e9sent\u00e9s graphiquement \u00e0 l'aide de l'outil motan_graph.py . Pour g\u00e9n\u00e9rer des graphiques sur un Raspberry Pi, une seule \u00e9tape est n\u00e9cessaire pour installer le package \"matplotlib\"\u202f: sudo apt-get update sudo apt-get install python-matplotlib Cependant, il peut \u00eatre plus pratique de copier les fichiers de donn\u00e9es sur une machine de bureau avec le code Python dans le r\u00e9pertoire scripts/motan/ . Les scripts d'analyse de mouvement doivent s'ex\u00e9cuter sur n'importe quelle machine sur laquelle une version r\u00e9cente de Python et Matplotlib est install\u00e9e. Les graphiques peuvent \u00eatre g\u00e9n\u00e9r\u00e9s avec une commande comme celle-ci : ~/klipper/scripts/motan/motan_graph.py mylog -o mygraph.png On peut utiliser l'option -g pour sp\u00e9cifier les jeux de donn\u00e9es \u00e0 repr\u00e9senter graphiquement (il faut un litt\u00e9ral Python contenant une liste de listes). Par exemple\u202f: ~/klipper/scripts/motan/motan_graph.py mylog -g '[[\"trapq(toolhead,velocity)\"], [\"trapq(toolhead,accel)\"]]' La liste des ensembles de donn\u00e9es disponibles peut \u00eatre trouv\u00e9e en utilisant l'option -l - par exemple : ~/klipper/scripts/motan/motan_graph.py -l Il est \u00e9galement possible de sp\u00e9cifier les options de trac\u00e9 matplotlib pour chaque jeu de donn\u00e9es : ~/klipper/scripts/motan/motan_graph.py mylog -g '[[\"trapq(toolhead,velocity)?color=red&alpha=0.4\"]]' De nombreuses options matplotlib sont disponibles ; quelques exemples sont \"color\", \"label\", \"alpha\" et \"linestyle\". L'outil motan_graph.py prend en charge plusieurs autres options de ligne de commande - utilisez l'option --help pour afficher une liste. Il peut \u00e9galement \u00eatre pratique de visualiser/modifier le script motan_graph.py lui-m\u00eame. Les journaux de donn\u00e9es brutes produits par l'outil data_logger.py suivent le format d\u00e9crit dans Serveur API . Il peut \u00eatre utile d'inspecter les donn\u00e9es avec une commande Unix comme celle-ci : gunzip < mylog.json.gz | tr '\\03' '\\n' | moins G\u00e9n\u00e9ration de graphiques de charge \u00b6 Le fichier journal Klippy (/tmp/klippy.log) stocke des statistiques sur la bande passante utilis\u00e9e, la charge du microcontr\u00f4leur et la charge du tampon h\u00f4te. Il peut \u00eatre utile de repr\u00e9senter graphiquement ces statistiques apr\u00e8s une impression. Pour g\u00e9n\u00e9rer un graphique, une seule \u00e9tape est n\u00e9cessaire pour installer le package \"matplotlib\"\u202f: sudo apt-get update sudo apt-get install python-matplotlib Ensuite, les graphiques peuvent \u00eatre produits avec\u202f: ~/klipper/scripts/graphstats.py /tmp/klippy.log -o loadgraph.png On peut alors visualiser le fichier loadgraph.png r\u00e9sultant. Diff\u00e9rents graphiques peuvent \u00eatre produits. Pour plus d'informations, ex\u00e9cutez : ~/klipper/scripts/graphstats.py --help Extraire des informations du fichier klippy.log \u00b6 Le fichier journal Klippy (/tmp/klippy.log) contient \u00e9galement des informations de d\u00e9bogage. Il existe un script logextract.py qui peut \u00eatre utile lors de l'analyse d'un arr\u00eat de microcontr\u00f4leur ou d'un probl\u00e8me similaire. Il est g\u00e9n\u00e9ralement ex\u00e9cut\u00e9 avec quelque chose comme : mkdir work_directory cd work_directory cp /tmp/klippy.log . ~/klipper/scripts/logextract.py ./klippy.log Le script extrait le fichier de configuration de l'imprimante et extrait les informations d'arr\u00eat du MCU. Les vidages d'informations d'un arr\u00eat de MCU (le cas \u00e9ch\u00e9ant) sont r\u00e9organis\u00e9s par horodatage pour faciliter le diagnostic des sc\u00e9narios de cause \u00e0 effet. Tester avec simulavr \u00b6 L'outil simulavr permet de simuler un microcontr\u00f4leur Atmel ATmega. Cette section d\u00e9crit comment ex\u00e9cuter des fichiers gcode de test via simulavr. Il est recommand\u00e9 de l'ex\u00e9cuter sur une machine de bureau (pas un Raspberry Pi) car il n\u00e9cessite un processeur important pour fonctionner efficacement. Pour utiliser simulavr, t\u00e9l\u00e9chargez le package simulavr et compilez avec le support python. Notez que le syst\u00e8me de construction peut n\u00e9cessiter l'installation de certains packages (tels que swig) afin de construire le module python. git clone git://git.savannah.nongnu.org/simulavr.git cd simulavr make python make build Assurez-vous qu'un fichier ./build/pysimulavr/_pysimulavr.*.so est pr\u00e9sent apr\u00e8s la compilation ci-dessus : ls ./build/pysimulavr/_pysimulavr.*.so Cette commande doit signaler un fichier sp\u00e9cifique (par exemple ./build/pysimulavr/_pysimulavr.cpython-39-x86_64-linux-gnu.so ) et non une erreur. Si vous \u00eates sur un syst\u00e8me bas\u00e9 sur Debian (Debian, Ubuntu, etc.), vous pouvez installer les packages suivants et g\u00e9n\u00e9rer des fichiers *.deb pour une installation de simulavr \u00e0 l'\u00e9chelle du syst\u00e8me : sudo apt update sudo apt install g++ make cmake swig rst2pdf help2man texinfo make cfgclean python debian sudo dpkg -i build/debian/python3-simulavr*.deb Pour compiler Klipper pour une utilisation dans simulavr, ex\u00e9cutez : cd /path/to/klipper make menuconfig et compilez le logiciel du microcontr\u00f4leur pour un AVR atmega644p et s\u00e9lectionnez le support d'\u00e9mulation du logiciel SIMULAVR. Ensuite on peut compiler Klipper (lancer make ) puis lancer la simulation avec : PYTHONPATH=/path/to/simulavr/build/pysimulavr/ ./scripts/avrsim.py out/klipper.elf Si vous avez install\u00e9 python3-simulavr au niveau syst\u00e8me, vous n'avez pas besoin de d\u00e9finir PYTHONPATH , et vous pouvez simplement ex\u00e9cuter le simulateur comme ./scripts/avrsim.py out/klipper.elf Ensuite, avec simulavr en cours d\u2019ex\u00e9cution dans une autre fen\u00eatre, on peut ex\u00e9cuter ce qui suit pour lire le gcode d\u2019un fichier (par exemple, \u00ab test.gcode \u00bb), le traiter avec Klippy, et l\u2019envoyer \u00e0 Klipper ex\u00e9cut\u00e9 dans simulavr (voir installation pour les \u00e9tapes n\u00e9cessaires \u00e0 la construction de l\u2019environnement virtuel python)\u202f: ~/klippy-env/bin/python ./klippy/klippy.py config/generic-simulavr.cfg -i test.gcode -v Utiliser simulavr avec gtkwave \u00b6 Une fonctionnalit\u00e9 utile de simulavr est sa capacit\u00e9 \u00e0 cr\u00e9er des fichiers de g\u00e9n\u00e9ration d'ondes avec la synchronisation exacte des \u00e9v\u00e9nements. Pour ce faire, suivez les instructions ci-dessus, mais ex\u00e9cutez avrsim.py avec une ligne de commande comme celle-ci : PYTHONPATH=/path/to/simulavr/src/python/ ./scripts/avrsim.py out/klipper.elf -t PORTA.PORT,PORTC.PORT Ce qui pr\u00e9c\u00e8de cr\u00e9era un fichier avrsim.vcd avec des informations sur chaque modification des GPIO sur PORTA et PORTB. Ce fichier pourra ensuite \u00eatre visualis\u00e9 en utilisant gtkwave avec : gtkwave avrsim.vcd","title":"D\u00e9bogage"},{"location":"Debugging.html#debogage","text":"Ce document d\u00e9crit certains des outils de d\u00e9bogage de Klipper.","title":"D\u00e9bogage"},{"location":"Debugging.html#execution-des-tests-de-non-regression","text":"Le r\u00e9f\u00e9rentiel principal Klipper GitHub utilise des \"github actions\" pour ex\u00e9cuter une s\u00e9rie de tests de non-r\u00e9gression. Il peut \u00eatre utile d'ex\u00e9cuter certains de ces tests localement. La \"v\u00e9rification des espaces\" dans le code source peut \u00eatre ex\u00e9cut\u00e9e avec : ./scripts/check_whitespace.sh La suite de tests de non-r\u00e9gression Klippy n\u00e9cessite les \"dictionnaires de donn\u00e9es\" de nombreuses plates-formes. Le moyen le plus simple de les obtenir est de les t\u00e9l\u00e9charger depuis github . Une fois les dictionnaires de donn\u00e9es t\u00e9l\u00e9charg\u00e9s, utilisez les \u00e9l\u00e9ments suivants pour ex\u00e9cuter la suite de tests de non-r\u00e9gression : tar xfz klipper-dict-20??????.tar.gz ~/klippy-env/bin/python ~/klipper/scripts/test_klippy.py -d dict/ ~/klipper/test/klippy/*.test","title":"Ex\u00e9cution des tests de non-r\u00e9gression"},{"location":"Debugging.html#envoi-manuel-de-commandes-au-microcontroleur","text":"Normalement, le processus h\u00f4te klippy.py est utilis\u00e9 pour traduire les commandes gcode en commandes de microcontr\u00f4leur Klipper. Cependant, il est \u00e9galement possible d'envoyer manuellement ces commandes MCU (fonctions marqu\u00e9es avec la macro DECL_COMMAND() dans le code source de Klipper). Pour ce faire, ex\u00e9cutez : ~/klippy-env/bin/python ./klippy/console.py /tmp/pseudoserial Voir la commande \"AIDE\" dans l'outil pour plus d'informations sur sa fonctionnalit\u00e9. Certaines options en ligne de commande sont disponibles. Pour plus d'informations, ex\u00e9cutez : ~/klippy-env/bin/python ./klippy/console.py --help","title":"Envoi manuel de commandes au microcontr\u00f4leur"},{"location":"Debugging.html#traduction-des-fichiers-g-code-en-commandes-de-microcontroleur","text":"Le code h\u00f4te Klippy peut s'ex\u00e9cuter en mode batch pour produire les commandes de microcontr\u00f4leur de bas niveau associ\u00e9es \u00e0 un fichier gcode. L'inspection de ces commandes de bas niveau est utile lorsque vous essayez de comprendre les actions du mat\u00e9riel de bas niveau. Il peut \u00e9galement \u00eatre utile de comparer la diff\u00e9rence des commandes du microcontr\u00f4leur apr\u00e8s un changement de code. Pour ex\u00e9cuter Klippy dans ce mode batch, il y a une seule \u00e9tape n\u00e9cessaire pour g\u00e9n\u00e9rer le \"dictionnaire de donn\u00e9es\" du microcontr\u00f4leur. Cela se fait en compilant le code du micro-contr\u00f4leur pour obtenir le fichier out/klipper.dict : make menuconfig make Une fois que ce qui pr\u00e9c\u00e8de est fait, il est possible d'ex\u00e9cuter Klipper en mode batch (voir installation pour les \u00e9tapes n\u00e9cessaires pour construire l'environnement virtuel python et un fichier printer.cfg) : ~/klippy-env/bin/python ./klippy/klippy.py ~/printer.cfg -i test.gcode -o test.serial -v -d out/klipper.dict Ce qui pr\u00e9c\u00e8de produira un fichier test.serial avec la sortie s\u00e9rie binaire. Cette sortie peut \u00eatre traduite en texte lisible avec : ~/klippy-env/bin/python ./klippy/parsedump.py out/klipper.dict test.serial > test.txt Le fichier r\u00e9sultant test.txt contient une liste lisible des commandes du microcontr\u00f4leur. Le mode batch d\u00e9sactive certaines commandes de r\u00e9ponse/requ\u00eate pour fonctionner. Par cons\u00e9quent, il y aura des diff\u00e9rences entre les commandes r\u00e9elles et la sortie ci-dessus. Les donn\u00e9es g\u00e9n\u00e9r\u00e9es sont utiles pour les tests et l'inspection ; elles ne sont pas utiles en fonctionnement normale (vers un vrai microcontr\u00f4leur).","title":"Traduction des fichiers G-Code en commandes de microcontr\u00f4leur"},{"location":"Debugging.html#analyse-de-mouvements-et-enregistrement-de-donnees","text":"Klipper prend en charge la journalisation de l'historique des mouvement, qui peut \u00eatre analys\u00e9 ult\u00e9rieurement. Pour utiliser cette fonctionnalit\u00e9, Klipper doit \u00eatre d\u00e9marr\u00e9 avec le Serveur API activ\u00e9. L'enregistrement des donn\u00e9es est activ\u00e9 avec l'outil data_logger.py . Par example\u202f: ~/klipper/scripts/motan/data_logger.py /tmp/klippy_uds mylog Cette commande se connectera au serveur API de Klipper, s'abonnera aux informations d'\u00e9tat et de mouvement et consignera les r\u00e9sultats. Deux fichiers sont g\u00e9n\u00e9r\u00e9s : un fichier de donn\u00e9es compress\u00e9es et un fichier d'index (par exemple, mylog.json.gz et mylog.index.gz ). Apr\u00e8s avoir d\u00e9marr\u00e9 la journalisation, il est possible d'effectuer des impressions et d'autres actions - la journalisation se poursuivra en arri\u00e8re-plan. Une fois la journalisation termin\u00e9e, appuyez sur ctrl-c pour quitter l'outil data_logger.py . Les fichiers r\u00e9sultants peuvent \u00eatre lus et repr\u00e9sent\u00e9s graphiquement \u00e0 l'aide de l'outil motan_graph.py . Pour g\u00e9n\u00e9rer des graphiques sur un Raspberry Pi, une seule \u00e9tape est n\u00e9cessaire pour installer le package \"matplotlib\"\u202f: sudo apt-get update sudo apt-get install python-matplotlib Cependant, il peut \u00eatre plus pratique de copier les fichiers de donn\u00e9es sur une machine de bureau avec le code Python dans le r\u00e9pertoire scripts/motan/ . Les scripts d'analyse de mouvement doivent s'ex\u00e9cuter sur n'importe quelle machine sur laquelle une version r\u00e9cente de Python et Matplotlib est install\u00e9e. Les graphiques peuvent \u00eatre g\u00e9n\u00e9r\u00e9s avec une commande comme celle-ci : ~/klipper/scripts/motan/motan_graph.py mylog -o mygraph.png On peut utiliser l'option -g pour sp\u00e9cifier les jeux de donn\u00e9es \u00e0 repr\u00e9senter graphiquement (il faut un litt\u00e9ral Python contenant une liste de listes). Par exemple\u202f: ~/klipper/scripts/motan/motan_graph.py mylog -g '[[\"trapq(toolhead,velocity)\"], [\"trapq(toolhead,accel)\"]]' La liste des ensembles de donn\u00e9es disponibles peut \u00eatre trouv\u00e9e en utilisant l'option -l - par exemple : ~/klipper/scripts/motan/motan_graph.py -l Il est \u00e9galement possible de sp\u00e9cifier les options de trac\u00e9 matplotlib pour chaque jeu de donn\u00e9es : ~/klipper/scripts/motan/motan_graph.py mylog -g '[[\"trapq(toolhead,velocity)?color=red&alpha=0.4\"]]' De nombreuses options matplotlib sont disponibles ; quelques exemples sont \"color\", \"label\", \"alpha\" et \"linestyle\". L'outil motan_graph.py prend en charge plusieurs autres options de ligne de commande - utilisez l'option --help pour afficher une liste. Il peut \u00e9galement \u00eatre pratique de visualiser/modifier le script motan_graph.py lui-m\u00eame. Les journaux de donn\u00e9es brutes produits par l'outil data_logger.py suivent le format d\u00e9crit dans Serveur API . Il peut \u00eatre utile d'inspecter les donn\u00e9es avec une commande Unix comme celle-ci : gunzip < mylog.json.gz | tr '\\03' '\\n' | moins","title":"Analyse de mouvements et enregistrement de donn\u00e9es"},{"location":"Debugging.html#generation-de-graphiques-de-charge","text":"Le fichier journal Klippy (/tmp/klippy.log) stocke des statistiques sur la bande passante utilis\u00e9e, la charge du microcontr\u00f4leur et la charge du tampon h\u00f4te. Il peut \u00eatre utile de repr\u00e9senter graphiquement ces statistiques apr\u00e8s une impression. Pour g\u00e9n\u00e9rer un graphique, une seule \u00e9tape est n\u00e9cessaire pour installer le package \"matplotlib\"\u202f: sudo apt-get update sudo apt-get install python-matplotlib Ensuite, les graphiques peuvent \u00eatre produits avec\u202f: ~/klipper/scripts/graphstats.py /tmp/klippy.log -o loadgraph.png On peut alors visualiser le fichier loadgraph.png r\u00e9sultant. Diff\u00e9rents graphiques peuvent \u00eatre produits. Pour plus d'informations, ex\u00e9cutez : ~/klipper/scripts/graphstats.py --help","title":"G\u00e9n\u00e9ration de graphiques de charge"},{"location":"Debugging.html#extraire-des-informations-du-fichier-klippylog","text":"Le fichier journal Klippy (/tmp/klippy.log) contient \u00e9galement des informations de d\u00e9bogage. Il existe un script logextract.py qui peut \u00eatre utile lors de l'analyse d'un arr\u00eat de microcontr\u00f4leur ou d'un probl\u00e8me similaire. Il est g\u00e9n\u00e9ralement ex\u00e9cut\u00e9 avec quelque chose comme : mkdir work_directory cd work_directory cp /tmp/klippy.log . ~/klipper/scripts/logextract.py ./klippy.log Le script extrait le fichier de configuration de l'imprimante et extrait les informations d'arr\u00eat du MCU. Les vidages d'informations d'un arr\u00eat de MCU (le cas \u00e9ch\u00e9ant) sont r\u00e9organis\u00e9s par horodatage pour faciliter le diagnostic des sc\u00e9narios de cause \u00e0 effet.","title":"Extraire des informations du fichier klippy.log"},{"location":"Debugging.html#tester-avec-simulavr","text":"L'outil simulavr permet de simuler un microcontr\u00f4leur Atmel ATmega. Cette section d\u00e9crit comment ex\u00e9cuter des fichiers gcode de test via simulavr. Il est recommand\u00e9 de l'ex\u00e9cuter sur une machine de bureau (pas un Raspberry Pi) car il n\u00e9cessite un processeur important pour fonctionner efficacement. Pour utiliser simulavr, t\u00e9l\u00e9chargez le package simulavr et compilez avec le support python. Notez que le syst\u00e8me de construction peut n\u00e9cessiter l'installation de certains packages (tels que swig) afin de construire le module python. git clone git://git.savannah.nongnu.org/simulavr.git cd simulavr make python make build Assurez-vous qu'un fichier ./build/pysimulavr/_pysimulavr.*.so est pr\u00e9sent apr\u00e8s la compilation ci-dessus : ls ./build/pysimulavr/_pysimulavr.*.so Cette commande doit signaler un fichier sp\u00e9cifique (par exemple ./build/pysimulavr/_pysimulavr.cpython-39-x86_64-linux-gnu.so ) et non une erreur. Si vous \u00eates sur un syst\u00e8me bas\u00e9 sur Debian (Debian, Ubuntu, etc.), vous pouvez installer les packages suivants et g\u00e9n\u00e9rer des fichiers *.deb pour une installation de simulavr \u00e0 l'\u00e9chelle du syst\u00e8me : sudo apt update sudo apt install g++ make cmake swig rst2pdf help2man texinfo make cfgclean python debian sudo dpkg -i build/debian/python3-simulavr*.deb Pour compiler Klipper pour une utilisation dans simulavr, ex\u00e9cutez : cd /path/to/klipper make menuconfig et compilez le logiciel du microcontr\u00f4leur pour un AVR atmega644p et s\u00e9lectionnez le support d'\u00e9mulation du logiciel SIMULAVR. Ensuite on peut compiler Klipper (lancer make ) puis lancer la simulation avec : PYTHONPATH=/path/to/simulavr/build/pysimulavr/ ./scripts/avrsim.py out/klipper.elf Si vous avez install\u00e9 python3-simulavr au niveau syst\u00e8me, vous n'avez pas besoin de d\u00e9finir PYTHONPATH , et vous pouvez simplement ex\u00e9cuter le simulateur comme ./scripts/avrsim.py out/klipper.elf Ensuite, avec simulavr en cours d\u2019ex\u00e9cution dans une autre fen\u00eatre, on peut ex\u00e9cuter ce qui suit pour lire le gcode d\u2019un fichier (par exemple, \u00ab test.gcode \u00bb), le traiter avec Klippy, et l\u2019envoyer \u00e0 Klipper ex\u00e9cut\u00e9 dans simulavr (voir installation pour les \u00e9tapes n\u00e9cessaires \u00e0 la construction de l\u2019environnement virtuel python)\u202f: ~/klippy-env/bin/python ./klippy/klippy.py config/generic-simulavr.cfg -i test.gcode -v","title":"Tester avec simulavr"},{"location":"Debugging.html#utiliser-simulavr-avec-gtkwave","text":"Une fonctionnalit\u00e9 utile de simulavr est sa capacit\u00e9 \u00e0 cr\u00e9er des fichiers de g\u00e9n\u00e9ration d'ondes avec la synchronisation exacte des \u00e9v\u00e9nements. Pour ce faire, suivez les instructions ci-dessus, mais ex\u00e9cutez avrsim.py avec une ligne de commande comme celle-ci : PYTHONPATH=/path/to/simulavr/src/python/ ./scripts/avrsim.py out/klipper.elf -t PORTA.PORT,PORTC.PORT Ce qui pr\u00e9c\u00e8de cr\u00e9era un fichier avrsim.vcd avec des informations sur chaque modification des GPIO sur PORTA et PORTB. Ce fichier pourra ensuite \u00eatre visualis\u00e9 en utilisant gtkwave avec : gtkwave avrsim.vcd","title":"Utiliser simulavr avec gtkwave"},{"location":"Delta_Calibrate.html","text":"\u00c9talonnage Delta \u00b6 Ce document d\u00e9crit le syst\u00e8me de calibration automatique de Klipper pour les imprimantes de type \"delta\". L'\u00e9talonnage Delta consiste \u00e0 trouver les positions pour les but\u00e9es de tour, les angles de tour, le rayon Delta et les longueurs de bras Delta. Ces param\u00e8tres contr\u00f4lent le mouvement de l'imprimante sur une imprimante Delta. Chacun de ces param\u00e8tres a un impact non lin\u00e9aire et il est difficile de les calibrer manuellement. En revanche, le code d'\u00e9talonnage logiciel peut fournir d'excellents r\u00e9sultats en quelques minutes seulement. Aucun mat\u00e9riel sp\u00e9cial n'est n\u00e9cessaire. L'\u00e9talonnage Delta d\u00e9pend de la pr\u00e9cision des interrupteurs de fin de course de chaque tour. Si l'on utilise des pilotes de moteur pas \u00e0 pas Trinamic, envisagez d'activer la d\u00e9tection de phase d'arr\u00eat pour am\u00e9liorer la pr\u00e9cision de ces commutateurs. Sondage automatique vs manuel \u00b6 Klipper prend en charge l'\u00e9talonnage des param\u00e8tres delta via une m\u00e9thode de sondage manuelle ou via une sonde Z automatique. Un certain nombre de kits d'imprimantes delta sont livr\u00e9s avec des sondes Z automatiques qui ne sont pas suffisamment pr\u00e9cises (en particulier, de petites diff\u00e9rences de longueur de bras peuvent provoquer une inclinaison de l'effecteur qui peut fausser une sonde automatique). Si vous utilisez une sonde automatique, \u00e9talonnez d'abord la sonde , puis recherchez un le biais d'emplacement de la sonde . Si la sonde automatique a un biais de plus de 25 microns (0,025 mm), utilisez plut\u00f4t une sonde manuelle. Le sondage manuel ne prend que quelques minutes et \u00e9limine les erreurs introduites par la sonde. Si vous utilisez une sonde mont\u00e9e sur le c\u00f4t\u00e9 de l'extr\u00e9mit\u00e9 chaude (c'est-\u00e0-dire qu'elle a un d\u00e9calage X ou Y), notez que l'ex\u00e9cution de l'\u00e9talonnage delta invalidera les r\u00e9sultats de l'\u00e9talonnage de la sonde. Ces types de sondes sont rarement adapt\u00e9s \u00e0 une utilisation sur une delta (car une inclinaison mineure de l'effecteur entra\u00eenera un biais de localisation de la sonde). Si vous utilisez quand m\u00eame la sonde, assurez-vous de relancer l'\u00e9talonnage de la sonde apr\u00e8s tout \u00e9talonnage delta. \u00c9talonnage Delta de base \u00b6 Klipper a une commande DELTA_CALIBRATE qui peut effectuer un \u00e9talonnage Delta de base. Cette commande sonde sept points diff\u00e9rents sur le lit et calcule de nouvelles valeurs pour les angles de la tour, les but\u00e9es de la tour et le rayon delta. Afin d'effectuer cet \u00e9talonnage, les param\u00e8tres delta initiaux (longueurs de bras, rayon et positions de but\u00e9e) doivent \u00eatre fournis et ils doivent avoir une pr\u00e9cision de quelques millim\u00e8tres. La plupart des kits d'imprimante delta fournissent ces param\u00e8tres - configurez l'imprimante avec ces valeurs par d\u00e9faut, puis ex\u00e9cutez la commande DELTA_CALIBRATE comme d\u00e9crit ci-dessous. Si aucune valeur par d\u00e9faut n'est disponible, recherchez en ligne un guide d'\u00e9talonnage delta qui peut fournir un point de d\u00e9part de base. Au cours du processus d'\u00e9talonnage Delta, il peut \u00eatre n\u00e9cessaire que l'imprimante sonde 'en dessous' de ce qui serait autrement consid\u00e9r\u00e9 comme le plan du lit. Il est courant d'autoriser cela lors de l'\u00e9talonnage en mettant \u00e0 jour la configuration de sorte que la position minimum_z_position=-5 de l'imprimante. (Une fois l'\u00e9talonnage termin\u00e9, on peut supprimer ce param\u00e8tre de la configuration.) Il existe deux fa\u00e7ons d'effectuer le sondage : le sondage manuel ( DELTA_CALIBRATE METHOD=manual ) et le sondage automatique ( DELTA_CALIBRATE ). La m\u00e9thode de sondage manuel d\u00e9placera la t\u00eate pr\u00e8s du lit, puis attendra que l'utilisateur suive les \u00e9tapes d\u00e9crites dans \"the paper test\" pour d\u00e9terminer la distance r\u00e9elle entre la buse et lit \u00e0 l'endroit indiqu\u00e9. Pour effectuer le sondage initial, assurez-vous que la configuration a une section [delta_calibrate] d\u00e9finie, puis ex\u00e9cutez l'outil : G28 DELTA_CALIBRATE METHOD=manual Apr\u00e8s avoir sond\u00e9 les sept points, de nouveaux param\u00e8tres Delta seront calcul\u00e9s. Enregistrez et appliquez ces param\u00e8tres en ex\u00e9cutant : SAVE_CONFIG L'\u00e9talonnage initial doit fournir des param\u00e8tres Delta suffisamment pr\u00e9cis pour une impression. S'il s'agit d'une nouvelle imprimante, c'est le bon moment pour imprimer certains objets simples et v\u00e9rifier son bon fonctionnement. \u00c9talonnage Delta avanc\u00e9 \u00b6 L'\u00e9talonnage Delta de base fait g\u00e9n\u00e9ralement un bon travail de calcul des param\u00e8tres delta de sorte que la buse soit \u00e0 la bonne distance du lit. Cependant, il n'essaye pas de calibrer la pr\u00e9cision dimensionnelle X et Y. L'\u00e9talonnage delta am\u00e9lior\u00e9 permet de v\u00e9rifier la pr\u00e9cision dimensionnelle. Cette proc\u00e9dure d'\u00e9talonnage n\u00e9cessite l'impression d'un objet de test et la mesure de parties de cet objet de test avec un pied \u00e0 coulisse. Avant d'ex\u00e9cuter un \u00e9talonnage delta avanc\u00e9, il faut ex\u00e9cuter l'\u00e9talonnage delta de base (via la commande DELTA_CALIBRATE) et enregistrer les r\u00e9sultats (via la commande SAVE_CONFIG). Assurez-vous qu'il n'y a eu aucun changement notable dans la configuration de l'imprimante ni dans le mat\u00e9riel depuis le dernier \u00e9talonnage delta de base (en cas de doute, r\u00e9ex\u00e9cutez l' \u00e9talonnage delta de base , y compris SAVE_CONFIG, juste avant l'impression l'objet de test d\u00e9crit ci-dessous.) Utilisez un trancheur pour g\u00e9n\u00e9rer le G-Code \u00e0 partir du fichier docs/prints/calibrate_size.stl . Tranchez l'objet en utilisant une vitesse lente (par exemple, 40 mm/s). Si possible, utilisez un plastique rigide (comme le PLA) pour l'objet. L'objet a un diam\u00e8tre de 140 mm. Si c'est trop grand pour l'imprimante, il est possible de le r\u00e9duire (mais assurez-vous de mettre uniform\u00e9ment \u00e0 l'\u00e9chelle les axes X et Y). Si l'imprimante prend en charge des impressions beaucoup plus grandes, cet objet peut \u00e9galement \u00eatre agrandi. Une taille plus grande peut am\u00e9liorer la pr\u00e9cision de la mesure, mais une bonne adh\u00e9rence de l'impression est plus importante qu'une taille d'impression plus grande. Imprimez l'objet \u00e0 tester et attendez qu'il refroidisse compl\u00e8tement. Les commandes d\u00e9crites ci-dessous doivent \u00eatre ex\u00e9cut\u00e9es avec les m\u00eames param\u00e8tres d'imprimante que ceux utilis\u00e9s pour imprimer l'objet de calibrage (ne pas ex\u00e9cuter DELTA_CALIBRATE entre l'impression et la mesure, ou faire quelque chose d'autre qui changerait la configuration de l'imprimante). Si possible, effectuez les mesures d\u00e9crites ci-dessous pendant que l'objet est toujours attach\u00e9 au lit d'impression, mais ne vous inqui\u00e9tez pas si la pi\u00e8ce se d\u00e9tache du lit - essayez simplement d'\u00e9viter de tordre l'objet lors de l'ex\u00e9cution des mesures. Commencez par mesurer la distance entre le pilier central et le pilier \u00e0 c\u00f4t\u00e9 de l'\u00e9tiquette \"A\" (qui doit \u00e9galement pointer vers la tour \"A\"). Ensuite, allez dans le sens inverse des aiguilles d'une montre et mesurez les distances entre le pilier central et les autres piliers (distance du centre au pilier en face de l'\u00e9tiquette C, distance du centre au pilier avec l'\u00e9tiquette B, etc.). Entrez ces param\u00e8tres dans Klipper avec une liste de nombres r\u00e9els (/!\\ utilisez le point comme s\u00e9parateur d\u00e9cimal) s\u00e9par\u00e9s par des virgules : DELTA_ANALYZE CENTER_DISTS=<a_dist>,<far_c_dist>,<b_dist>,<far_a_dist>,<c_dist>,<far_b_dist> Fournissez les valeurs sans espaces entre chaque valeurs. Mesurez ensuite la distance entre le pilier A et le pilier en face de l'\u00e9tiquette C. Ensuite, dans le sens antihoraire, mesurez la distance entre le pilier en face de C et le pilier B, la distance entre le pilier B et le pilier en face de A, et ainsi de suite. Saisissez ces param\u00e8tres dans Klipper : DELTA_ANALYZE OUTER_DISTS=<a_to_far_c>,<far_c_to_b>,<b_to_far_a>,<far_a_to_c>,<c_to_far_b>,<far_b_to_a> \u00c0 ce stade, vous pouvez retirer l'objet du lit. Les mesures finales concernent les piliers eux-m\u00eames. Mesurez la taille du pilier central le long du rayon A, puis du rayon B, puis du rayon C. Saisissez-les dans Klipper : DELTA_ANALYZE CENTER_PILLAR_WIDTHS=<a>,<b>,<c> Les mesures finales concernent les piliers ext\u00e9rieurs. Commencez par mesurer la distance du pilier A le long de la ligne allant de A au pilier en face de C. Ensuite, dans le sens antihoraire, mesurez les piliers ext\u00e9rieurs restants (pilier en face de C le long de la ligne vers B, pilier B le long de la ligne vers le pilier en face de A, etc.). Et entrez-les dans Klipper : DELTA_ANALYZE OUTER_PILLAR_WIDTHS=<a>,<far_c>,<b>,<far_a>,<c>,<far_b> Si l'objet a \u00e9t\u00e9 mis \u00e0 l'\u00e9chelle \u00e0 une taille plus petite ou plus grande, indiquez le facteur d'\u00e9chelle utilis\u00e9 lors du d\u00e9coupage de l'objet : DELTA_ANALYZE SCALE=1.0 (Une valeur d'\u00e9chelle de 2,0 signifierait que l'objet est deux fois sa taille d'origine, 0,5 serait la moiti\u00e9 de sa taille d'origine.) Enfin, effectuez l'\u00e9talonnage delta am\u00e9lior\u00e9 en ex\u00e9cutant : DELTA_ANALYZE CALIBRATE=extended Cette commande peut prendre plusieurs minutes. Une fois termin\u00e9, elle calculera les param\u00e8tres delta mis \u00e0 jour (rayon delta, angles de tour, positions de but\u00e9e et longueurs de bras). Utilisez la commande SAVE_CONFIG pour enregistrer et appliquer les param\u00e8tres : SAVE_CONFIG La commande SAVE_CONFIG enregistre \u00e0 la fois les param\u00e8tres delta mis \u00e0 jour et les informations des mesures de distance. Les futures commandes DELTA_CALIBRATE utiliseront \u00e9galement ces informations de distance. N'essayez pas de ressaisir les mesures de distance brutes apr\u00e8s avoir ex\u00e9cut\u00e9 SAVE_CONFIG, car cette commande modifie la configuration de l'imprimante et les mesures brutes ne s'appliquent plus. Notes compl\u00e9mentaires \u00b6 Si l'imprimante Delta a une bonne pr\u00e9cision dimensionnelle, la distance entre deux piliers doit \u00eatre d'environ 74 mm et la largeur de chaque pilier doit \u00eatre d'environ 9 mm. (Plus pr\u00e9cis\u00e9ment, l'objectif est que la distance entre deux piliers moins la largeur de l'un des piliers soit exactement de 65 mm.) S'il y a une inexactitude dimensionnelle dans la pi\u00e8ce, la routine DELTA_ANALYZE calculera de nouveaux param\u00e8tres delta en utilisant \u00e0 la fois les mesures de distance et les mesures de hauteur pr\u00e9c\u00e9dentes de la derni\u00e8re commande DELTA_CALIBRATE. DELTA_ANALYZE peut g\u00e9nerer des param\u00e8tres delta surprenants. Par exemple, il peut sugg\u00e9rer des longueurs de bras qui ne correspondent pas aux longueurs de bras r\u00e9elles de l'imprimante. Malgr\u00e9 cela, les tests ont montr\u00e9 que DELTA_ANALYZE produit souvent de bons r\u00e9sultats. Les param\u00e8tres delta calcul\u00e9s sont capables de tenir compte de l\u00e9g\u00e8res erreurs ailleurs dans le mat\u00e9riel. Par exemple, de petites diff\u00e9rences de longueur de bras peuvent entra\u00eener une inclinaison de l'effecteur et une partie de cette inclinaison peut \u00eatre prise en compte en ajustant les param\u00e8tres de longueur de bras. Utilisation d'un maillage du lit sur une Delta \u00b6 Il est possible d'utiliser le maillage du lit sur une Delta. Cependant, il est important d'obtenir un bon \u00e9talonnage Delta avant d'activer un maillage du lit. L'ex\u00e9cution d'un maillage du lit avec un mauvais calibrage delta entra\u00eenera des r\u00e9sultats m\u00e9diocres. Notez que l'ex\u00e9cution de l'\u00e9talonnage delta invalidera tout maillage de lit pr\u00e9c\u00e9demment obtenu. Apr\u00e8s avoir effectu\u00e9 un nouvel \u00e9talonnage delta, assurez-vous de relancer BED_MESH_CALIBRATE.","title":"\u00c9talonnage Delta"},{"location":"Delta_Calibrate.html#etalonnage-delta","text":"Ce document d\u00e9crit le syst\u00e8me de calibration automatique de Klipper pour les imprimantes de type \"delta\". L'\u00e9talonnage Delta consiste \u00e0 trouver les positions pour les but\u00e9es de tour, les angles de tour, le rayon Delta et les longueurs de bras Delta. Ces param\u00e8tres contr\u00f4lent le mouvement de l'imprimante sur une imprimante Delta. Chacun de ces param\u00e8tres a un impact non lin\u00e9aire et il est difficile de les calibrer manuellement. En revanche, le code d'\u00e9talonnage logiciel peut fournir d'excellents r\u00e9sultats en quelques minutes seulement. Aucun mat\u00e9riel sp\u00e9cial n'est n\u00e9cessaire. L'\u00e9talonnage Delta d\u00e9pend de la pr\u00e9cision des interrupteurs de fin de course de chaque tour. Si l'on utilise des pilotes de moteur pas \u00e0 pas Trinamic, envisagez d'activer la d\u00e9tection de phase d'arr\u00eat pour am\u00e9liorer la pr\u00e9cision de ces commutateurs.","title":"\u00c9talonnage Delta"},{"location":"Delta_Calibrate.html#sondage-automatique-vs-manuel","text":"Klipper prend en charge l'\u00e9talonnage des param\u00e8tres delta via une m\u00e9thode de sondage manuelle ou via une sonde Z automatique. Un certain nombre de kits d'imprimantes delta sont livr\u00e9s avec des sondes Z automatiques qui ne sont pas suffisamment pr\u00e9cises (en particulier, de petites diff\u00e9rences de longueur de bras peuvent provoquer une inclinaison de l'effecteur qui peut fausser une sonde automatique). Si vous utilisez une sonde automatique, \u00e9talonnez d'abord la sonde , puis recherchez un le biais d'emplacement de la sonde . Si la sonde automatique a un biais de plus de 25 microns (0,025 mm), utilisez plut\u00f4t une sonde manuelle. Le sondage manuel ne prend que quelques minutes et \u00e9limine les erreurs introduites par la sonde. Si vous utilisez une sonde mont\u00e9e sur le c\u00f4t\u00e9 de l'extr\u00e9mit\u00e9 chaude (c'est-\u00e0-dire qu'elle a un d\u00e9calage X ou Y), notez que l'ex\u00e9cution de l'\u00e9talonnage delta invalidera les r\u00e9sultats de l'\u00e9talonnage de la sonde. Ces types de sondes sont rarement adapt\u00e9s \u00e0 une utilisation sur une delta (car une inclinaison mineure de l'effecteur entra\u00eenera un biais de localisation de la sonde). Si vous utilisez quand m\u00eame la sonde, assurez-vous de relancer l'\u00e9talonnage de la sonde apr\u00e8s tout \u00e9talonnage delta.","title":"Sondage automatique vs manuel"},{"location":"Delta_Calibrate.html#etalonnage-delta-de-base","text":"Klipper a une commande DELTA_CALIBRATE qui peut effectuer un \u00e9talonnage Delta de base. Cette commande sonde sept points diff\u00e9rents sur le lit et calcule de nouvelles valeurs pour les angles de la tour, les but\u00e9es de la tour et le rayon delta. Afin d'effectuer cet \u00e9talonnage, les param\u00e8tres delta initiaux (longueurs de bras, rayon et positions de but\u00e9e) doivent \u00eatre fournis et ils doivent avoir une pr\u00e9cision de quelques millim\u00e8tres. La plupart des kits d'imprimante delta fournissent ces param\u00e8tres - configurez l'imprimante avec ces valeurs par d\u00e9faut, puis ex\u00e9cutez la commande DELTA_CALIBRATE comme d\u00e9crit ci-dessous. Si aucune valeur par d\u00e9faut n'est disponible, recherchez en ligne un guide d'\u00e9talonnage delta qui peut fournir un point de d\u00e9part de base. Au cours du processus d'\u00e9talonnage Delta, il peut \u00eatre n\u00e9cessaire que l'imprimante sonde 'en dessous' de ce qui serait autrement consid\u00e9r\u00e9 comme le plan du lit. Il est courant d'autoriser cela lors de l'\u00e9talonnage en mettant \u00e0 jour la configuration de sorte que la position minimum_z_position=-5 de l'imprimante. (Une fois l'\u00e9talonnage termin\u00e9, on peut supprimer ce param\u00e8tre de la configuration.) Il existe deux fa\u00e7ons d'effectuer le sondage : le sondage manuel ( DELTA_CALIBRATE METHOD=manual ) et le sondage automatique ( DELTA_CALIBRATE ). La m\u00e9thode de sondage manuel d\u00e9placera la t\u00eate pr\u00e8s du lit, puis attendra que l'utilisateur suive les \u00e9tapes d\u00e9crites dans \"the paper test\" pour d\u00e9terminer la distance r\u00e9elle entre la buse et lit \u00e0 l'endroit indiqu\u00e9. Pour effectuer le sondage initial, assurez-vous que la configuration a une section [delta_calibrate] d\u00e9finie, puis ex\u00e9cutez l'outil : G28 DELTA_CALIBRATE METHOD=manual Apr\u00e8s avoir sond\u00e9 les sept points, de nouveaux param\u00e8tres Delta seront calcul\u00e9s. Enregistrez et appliquez ces param\u00e8tres en ex\u00e9cutant : SAVE_CONFIG L'\u00e9talonnage initial doit fournir des param\u00e8tres Delta suffisamment pr\u00e9cis pour une impression. S'il s'agit d'une nouvelle imprimante, c'est le bon moment pour imprimer certains objets simples et v\u00e9rifier son bon fonctionnement.","title":"\u00c9talonnage Delta de base"},{"location":"Delta_Calibrate.html#etalonnage-delta-avance","text":"L'\u00e9talonnage Delta de base fait g\u00e9n\u00e9ralement un bon travail de calcul des param\u00e8tres delta de sorte que la buse soit \u00e0 la bonne distance du lit. Cependant, il n'essaye pas de calibrer la pr\u00e9cision dimensionnelle X et Y. L'\u00e9talonnage delta am\u00e9lior\u00e9 permet de v\u00e9rifier la pr\u00e9cision dimensionnelle. Cette proc\u00e9dure d'\u00e9talonnage n\u00e9cessite l'impression d'un objet de test et la mesure de parties de cet objet de test avec un pied \u00e0 coulisse. Avant d'ex\u00e9cuter un \u00e9talonnage delta avanc\u00e9, il faut ex\u00e9cuter l'\u00e9talonnage delta de base (via la commande DELTA_CALIBRATE) et enregistrer les r\u00e9sultats (via la commande SAVE_CONFIG). Assurez-vous qu'il n'y a eu aucun changement notable dans la configuration de l'imprimante ni dans le mat\u00e9riel depuis le dernier \u00e9talonnage delta de base (en cas de doute, r\u00e9ex\u00e9cutez l' \u00e9talonnage delta de base , y compris SAVE_CONFIG, juste avant l'impression l'objet de test d\u00e9crit ci-dessous.) Utilisez un trancheur pour g\u00e9n\u00e9rer le G-Code \u00e0 partir du fichier docs/prints/calibrate_size.stl . Tranchez l'objet en utilisant une vitesse lente (par exemple, 40 mm/s). Si possible, utilisez un plastique rigide (comme le PLA) pour l'objet. L'objet a un diam\u00e8tre de 140 mm. Si c'est trop grand pour l'imprimante, il est possible de le r\u00e9duire (mais assurez-vous de mettre uniform\u00e9ment \u00e0 l'\u00e9chelle les axes X et Y). Si l'imprimante prend en charge des impressions beaucoup plus grandes, cet objet peut \u00e9galement \u00eatre agrandi. Une taille plus grande peut am\u00e9liorer la pr\u00e9cision de la mesure, mais une bonne adh\u00e9rence de l'impression est plus importante qu'une taille d'impression plus grande. Imprimez l'objet \u00e0 tester et attendez qu'il refroidisse compl\u00e8tement. Les commandes d\u00e9crites ci-dessous doivent \u00eatre ex\u00e9cut\u00e9es avec les m\u00eames param\u00e8tres d'imprimante que ceux utilis\u00e9s pour imprimer l'objet de calibrage (ne pas ex\u00e9cuter DELTA_CALIBRATE entre l'impression et la mesure, ou faire quelque chose d'autre qui changerait la configuration de l'imprimante). Si possible, effectuez les mesures d\u00e9crites ci-dessous pendant que l'objet est toujours attach\u00e9 au lit d'impression, mais ne vous inqui\u00e9tez pas si la pi\u00e8ce se d\u00e9tache du lit - essayez simplement d'\u00e9viter de tordre l'objet lors de l'ex\u00e9cution des mesures. Commencez par mesurer la distance entre le pilier central et le pilier \u00e0 c\u00f4t\u00e9 de l'\u00e9tiquette \"A\" (qui doit \u00e9galement pointer vers la tour \"A\"). Ensuite, allez dans le sens inverse des aiguilles d'une montre et mesurez les distances entre le pilier central et les autres piliers (distance du centre au pilier en face de l'\u00e9tiquette C, distance du centre au pilier avec l'\u00e9tiquette B, etc.). Entrez ces param\u00e8tres dans Klipper avec une liste de nombres r\u00e9els (/!\\ utilisez le point comme s\u00e9parateur d\u00e9cimal) s\u00e9par\u00e9s par des virgules : DELTA_ANALYZE CENTER_DISTS=<a_dist>,<far_c_dist>,<b_dist>,<far_a_dist>,<c_dist>,<far_b_dist> Fournissez les valeurs sans espaces entre chaque valeurs. Mesurez ensuite la distance entre le pilier A et le pilier en face de l'\u00e9tiquette C. Ensuite, dans le sens antihoraire, mesurez la distance entre le pilier en face de C et le pilier B, la distance entre le pilier B et le pilier en face de A, et ainsi de suite. Saisissez ces param\u00e8tres dans Klipper : DELTA_ANALYZE OUTER_DISTS=<a_to_far_c>,<far_c_to_b>,<b_to_far_a>,<far_a_to_c>,<c_to_far_b>,<far_b_to_a> \u00c0 ce stade, vous pouvez retirer l'objet du lit. Les mesures finales concernent les piliers eux-m\u00eames. Mesurez la taille du pilier central le long du rayon A, puis du rayon B, puis du rayon C. Saisissez-les dans Klipper : DELTA_ANALYZE CENTER_PILLAR_WIDTHS=<a>,<b>,<c> Les mesures finales concernent les piliers ext\u00e9rieurs. Commencez par mesurer la distance du pilier A le long de la ligne allant de A au pilier en face de C. Ensuite, dans le sens antihoraire, mesurez les piliers ext\u00e9rieurs restants (pilier en face de C le long de la ligne vers B, pilier B le long de la ligne vers le pilier en face de A, etc.). Et entrez-les dans Klipper : DELTA_ANALYZE OUTER_PILLAR_WIDTHS=<a>,<far_c>,<b>,<far_a>,<c>,<far_b> Si l'objet a \u00e9t\u00e9 mis \u00e0 l'\u00e9chelle \u00e0 une taille plus petite ou plus grande, indiquez le facteur d'\u00e9chelle utilis\u00e9 lors du d\u00e9coupage de l'objet : DELTA_ANALYZE SCALE=1.0 (Une valeur d'\u00e9chelle de 2,0 signifierait que l'objet est deux fois sa taille d'origine, 0,5 serait la moiti\u00e9 de sa taille d'origine.) Enfin, effectuez l'\u00e9talonnage delta am\u00e9lior\u00e9 en ex\u00e9cutant : DELTA_ANALYZE CALIBRATE=extended Cette commande peut prendre plusieurs minutes. Une fois termin\u00e9, elle calculera les param\u00e8tres delta mis \u00e0 jour (rayon delta, angles de tour, positions de but\u00e9e et longueurs de bras). Utilisez la commande SAVE_CONFIG pour enregistrer et appliquer les param\u00e8tres : SAVE_CONFIG La commande SAVE_CONFIG enregistre \u00e0 la fois les param\u00e8tres delta mis \u00e0 jour et les informations des mesures de distance. Les futures commandes DELTA_CALIBRATE utiliseront \u00e9galement ces informations de distance. N'essayez pas de ressaisir les mesures de distance brutes apr\u00e8s avoir ex\u00e9cut\u00e9 SAVE_CONFIG, car cette commande modifie la configuration de l'imprimante et les mesures brutes ne s'appliquent plus.","title":"\u00c9talonnage Delta avanc\u00e9"},{"location":"Delta_Calibrate.html#notes-complementaires","text":"Si l'imprimante Delta a une bonne pr\u00e9cision dimensionnelle, la distance entre deux piliers doit \u00eatre d'environ 74 mm et la largeur de chaque pilier doit \u00eatre d'environ 9 mm. (Plus pr\u00e9cis\u00e9ment, l'objectif est que la distance entre deux piliers moins la largeur de l'un des piliers soit exactement de 65 mm.) S'il y a une inexactitude dimensionnelle dans la pi\u00e8ce, la routine DELTA_ANALYZE calculera de nouveaux param\u00e8tres delta en utilisant \u00e0 la fois les mesures de distance et les mesures de hauteur pr\u00e9c\u00e9dentes de la derni\u00e8re commande DELTA_CALIBRATE. DELTA_ANALYZE peut g\u00e9nerer des param\u00e8tres delta surprenants. Par exemple, il peut sugg\u00e9rer des longueurs de bras qui ne correspondent pas aux longueurs de bras r\u00e9elles de l'imprimante. Malgr\u00e9 cela, les tests ont montr\u00e9 que DELTA_ANALYZE produit souvent de bons r\u00e9sultats. Les param\u00e8tres delta calcul\u00e9s sont capables de tenir compte de l\u00e9g\u00e8res erreurs ailleurs dans le mat\u00e9riel. Par exemple, de petites diff\u00e9rences de longueur de bras peuvent entra\u00eener une inclinaison de l'effecteur et une partie de cette inclinaison peut \u00eatre prise en compte en ajustant les param\u00e8tres de longueur de bras.","title":"Notes compl\u00e9mentaires"},{"location":"Delta_Calibrate.html#utilisation-dun-maillage-du-lit-sur-une-delta","text":"Il est possible d'utiliser le maillage du lit sur une Delta. Cependant, il est important d'obtenir un bon \u00e9talonnage Delta avant d'activer un maillage du lit. L'ex\u00e9cution d'un maillage du lit avec un mauvais calibrage delta entra\u00eenera des r\u00e9sultats m\u00e9diocres. Notez que l'ex\u00e9cution de l'\u00e9talonnage delta invalidera tout maillage de lit pr\u00e9c\u00e9demment obtenu. Apr\u00e8s avoir effectu\u00e9 un nouvel \u00e9talonnage delta, assurez-vous de relancer BED_MESH_CALIBRATE.","title":"Utilisation d'un maillage du lit sur une Delta"},{"location":"Endstop_Phase.html","text":"Phase de fin de course \u00b6 Ce document d\u00e9crit le syst\u00e8me de but\u00e9e ajust\u00e9e en phase pas \u00e0 pas de Klipper. Cette fonctionnalit\u00e9 peut am\u00e9liorer la pr\u00e9cision des interrupteurs de fin de course traditionnels. Il est particuli\u00e8rement utile lors de l'utilisation d'un pilote de moteur pas \u00e0 pas Trinamic dot\u00e9 d'une configuration d'ex\u00e9cution. Un interrupteur de fin de course standard a une pr\u00e9cision d'environ 100 microns. (Chaque fois qu'un axe est r\u00e9f\u00e9renc\u00e9, le commutateur peut se d\u00e9clencher l\u00e9g\u00e8rement plus t\u00f4t ou l\u00e9g\u00e8rement plus tard.) Bien qu'il s'agisse d'une erreur relativement petite, elle peut entra\u00eener des artefacts ind\u00e9sirables. En particulier, cet \u00e9cart de position peut \u00eatre perceptible lors de l'impression de la premi\u00e8re couche d'un objet. En revanche, les moteurs pas \u00e0 pas standard peuvent obtenir une pr\u00e9cision nettement sup\u00e9rieure. Le m\u00e9canisme de but\u00e9e \u00e0 ajustement de phase peut utiliser la pr\u00e9cision des moteurs pas \u00e0 pas pour am\u00e9liorer la pr\u00e9cision des interrupteurs de but\u00e9e. Un moteur pas \u00e0 pas se d\u00e9place en suivant une s\u00e9rie de phase jusqu'\u00e0 ce qu'il effectue quatre \"\u00e9tapes compl\u00e8tes\". Ainsi, un moteur pas \u00e0 pas utilisant 16 micro-pas aura 64 phases et lorsqu'il se d\u00e9place dans le sens positif, il passera par phases : 0, 1, 2, ... 61, 62, 63, 0, 1, 2, etc. Surtout, lorsque le moteur pas \u00e0 pas se trouve \u00e0 une position particuli\u00e8re sur un rail lin\u00e9aire, il doit toujours \u00eatre \u00e0 la m\u00eame phase. Ainsi, lorsqu'un chariot d\u00e9clenche l'interrupteur de fin de course, le moteur pas \u00e0 pas contr\u00f4lant ce chariot doit toujours \u00eatre \u00e0 la m\u00eame phase du moteur pas \u00e0 pas. Le syst\u00e8me de phase d'arr\u00eat final de Klipper combine la phase pas \u00e0 pas avec le d\u00e9clencheur d'arr\u00eat final pour am\u00e9liorer la pr\u00e9cision de l'arr\u00eat final. Pour utiliser cette fonctionnalit\u00e9, il est n\u00e9cessaire de pouvoir identifier la phase du moteur pas \u00e0 pas. Si l'on utilise les pilotes Trinamic TMC2130, TMC2208, TMC2224 ou TMC2660 en mode de configuration d'ex\u00e9cution (c'est-\u00e0-dire pas en mode autonome - \"standalone\"), Klipper peut interroger la phase pas \u00e0 pas du pilote. (Il est \u00e9galement possible d'utiliser ce syst\u00e8me sur des pilotes pas \u00e0 pas traditionnels si l'on peut r\u00e9initialiser de mani\u00e8re fiable ces pilotes pas \u00e0 pas - voir ci-dessous pour plus de d\u00e9tails.) \u00c9talonnage des phases de fin de course \u00b6 Si vous utilisez des pilotes de moteur pas \u00e0 pas Trinamic avec une configuration d'ex\u00e9cution, vous pouvez calibrer les phases de fin de course \u00e0 l'aide de la commande ENDSTOP_PHASE_CALIBRATE. Commencez par ajouter les \u00e9l\u00e9ments suivants au fichier de configuration : [endstop_phase] Red\u00e9marrez ensuite l'imprimante et ex\u00e9cutez une commande G28 suivie d'une commande ENDSTOP_PHASE_CALIBRATE . D\u00e9placez ensuite la t\u00eate d'outil vers un nouvel emplacement et ex\u00e9cutez \u00e0 nouveau G28 . Essayez de d\u00e9placer la t\u00eate d'outil \u00e0 plusieurs endroits diff\u00e9rents et r\u00e9ex\u00e9cutez G28 \u00e0 partir de chaque position. Ex\u00e9cutez au moins cinq commandes G28 . Apr\u00e8s avoir effectu\u00e9 ce qui pr\u00e9c\u00e8de, la commande ENDSTOP_PHASE_CALIBRATE signalera souvent la m\u00eame (ou presque la m\u00eame) phase pour le stepper. Cette phase peut \u00eatre enregistr\u00e9e dans le fichier de configuration afin que toutes les futures commandes G28 utilisent cette phase. (Ainsi, dans les futures op\u00e9rations de prise d'origine, Klipper obtiendra la m\u00eame position m\u00eame si la but\u00e9e se d\u00e9clenche un peu plus t\u00f4t ou un peu plus tard.) Pour enregistrer la phase d'arr\u00eat final d'un moteur pas \u00e0 pas particulier, ex\u00e9cutez quelque chose comme ceci : ENDSTOP_PHASE_CALIBRATE STEPPER=stepper_z Ex\u00e9cutez ce qui pr\u00e9c\u00e8de pour tous les steppers que vous souhaitez enregistrer. En r\u00e8gle g\u00e9n\u00e9rale, on l'utiliserait sur stepper_z pour les imprimantes cart\u00e9siennes et corexy, et pour stepper_a, stepper_b et stepper_c sur les imprimantes delta. Enfin, ex\u00e9cutez la commande suivante pour mettre \u00e0 jour le fichier de configuration avec les donn\u00e9es : SAVE_CONFIG Notes compl\u00e9mentaires \u00b6 Cette fonctionnalit\u00e9 est particuli\u00e8rement utile sur les imprimantes delta et sur la but\u00e9e Z des imprimantes cart\u00e9siennes/corexy. Il est possible d'utiliser cette fonctionnalit\u00e9 sur les but\u00e9es XY des imprimantes cart\u00e9siennes, mais cela n'est pas particuli\u00e8rement utile car une erreur mineure dans la position de la but\u00e9e X/Y n'aura probablement pas d'impact sur la qualit\u00e9 d'impression. Il n'est pas valide d'utiliser cette fonctionnalit\u00e9 sur les but\u00e9es XY des imprimantes corexy (car la position XY n'est pas d\u00e9termin\u00e9e par un seul stepper sur la cin\u00e9matique corexy). Il n'est pas valide d'utiliser cette fonctionnalit\u00e9 sur une imprimante utilisant une but\u00e9e Z \"probe:z_virtual_endstop\" (car la phase pas \u00e0 pas n'est stable que si la but\u00e9e se trouve \u00e0 un emplacement statique sur un rail). Apr\u00e8s avoir calibr\u00e9 la phase de but\u00e9e, si la but\u00e9e est d\u00e9plac\u00e9e ou ajust\u00e9e ult\u00e9rieurement, il sera n\u00e9cessaire de recalibrer la but\u00e9e. Supprimez les donn\u00e9es d'\u00e9talonnage du fichier de configuration et r\u00e9ex\u00e9cutez les \u00e9tapes ci-dessus. Pour utiliser ce syst\u00e8me, la but\u00e9e doit \u00eatre suffisamment pr\u00e9cise pour identifier la position du stepper en deux \"pas complets\". Ainsi, par exemple, si un stepper utilise 16 micro-pas avec une distance de pas de 0,005 mm, la but\u00e9e doit avoir une pr\u00e9cision d'au moins 0,160 mm. Si l'on obtient des messages d'erreur de type \"Endstop stepper_z incorrect phase\", cela peut \u00eatre d\u00fb \u00e0 un endstop qui n'est pas suffisamment pr\u00e9cis. Si le recalibrage n'aide pas, d\u00e9sactivez les ajustements de phase de but\u00e9e en les supprimant du fichier de configuration. Si l'on utilise un axe Z traditionnel contr\u00f4l\u00e9 par pas \u00e0 pas (comme sur une imprimante cart\u00e9sienne ou corexy) avec des vis de nivellement de lit traditionnelles, il est \u00e9galement possible d'utiliser ce syst\u00e8me pour faire en sorte que chaque couche d'impression soit effectu\u00e9e sur une limite \"pas complet\" . Pour activer cette fonctionnalit\u00e9, assurez-vous que le slicer G-Code est configur\u00e9 avec une hauteur de couche qui est un multiple d'un \"pas complet\", activez manuellement l'option endstop_align_zero dans la section de configuration endstop_phase (voir reference de configuration pour plus de d\u00e9tails), puis remettez \u00e0 niveau les vis du lit. Il est possible d'utiliser ce syst\u00e8me avec des pilotes de moteurs pas \u00e0 pas traditionnels (non Trinamic). Cependant, cela n\u00e9cessite de s'assurer que les pilotes du moteur pas \u00e0 pas sont r\u00e9initialis\u00e9s \u00e0 chaque fois que le microcontr\u00f4leur est r\u00e9initialis\u00e9. (Si les deux sont toujours r\u00e9initialis\u00e9s ensemble, Klipper peut d\u00e9terminer la phase du moteur pas \u00e0 pas en suivant le nombre total de pas qu'il a command\u00e9 au moteur pas \u00e0 pas.) Actuellement, la seule fa\u00e7on de le faire de mani\u00e8re fiable est que le microcontr\u00f4leur et le moteur pas \u00e0 pas les pilotes soient aliment\u00e9s uniquement par USB et que l'alimentation USB soit fournie par un h\u00f4te fonctionnant sur un Raspberry Pi. Dans cette situation, on peut sp\u00e9cifier une configuration mcu avec \"restart_method\u202f: rpi_usb\" - cette option fera en sorte que le microcontr\u00f4leur soit toujours r\u00e9initialis\u00e9 via une r\u00e9initialisation de l'alimentation USB, ce qui permettrait \u00e0 la fois au microcontr\u00f4leur et aux pilotes de moteur pas \u00e0 pas d'\u00eatre r\u00e9initialiser ensemble. Si vous utilisez ce m\u00e9canisme, vous devrez alors configurer manuellement les sections de configuration \"trigger_phase\" (voir config reference pour les d\u00e9tails).","title":"Phase de fin de course"},{"location":"Endstop_Phase.html#phase-de-fin-de-course","text":"Ce document d\u00e9crit le syst\u00e8me de but\u00e9e ajust\u00e9e en phase pas \u00e0 pas de Klipper. Cette fonctionnalit\u00e9 peut am\u00e9liorer la pr\u00e9cision des interrupteurs de fin de course traditionnels. Il est particuli\u00e8rement utile lors de l'utilisation d'un pilote de moteur pas \u00e0 pas Trinamic dot\u00e9 d'une configuration d'ex\u00e9cution. Un interrupteur de fin de course standard a une pr\u00e9cision d'environ 100 microns. (Chaque fois qu'un axe est r\u00e9f\u00e9renc\u00e9, le commutateur peut se d\u00e9clencher l\u00e9g\u00e8rement plus t\u00f4t ou l\u00e9g\u00e8rement plus tard.) Bien qu'il s'agisse d'une erreur relativement petite, elle peut entra\u00eener des artefacts ind\u00e9sirables. En particulier, cet \u00e9cart de position peut \u00eatre perceptible lors de l'impression de la premi\u00e8re couche d'un objet. En revanche, les moteurs pas \u00e0 pas standard peuvent obtenir une pr\u00e9cision nettement sup\u00e9rieure. Le m\u00e9canisme de but\u00e9e \u00e0 ajustement de phase peut utiliser la pr\u00e9cision des moteurs pas \u00e0 pas pour am\u00e9liorer la pr\u00e9cision des interrupteurs de but\u00e9e. Un moteur pas \u00e0 pas se d\u00e9place en suivant une s\u00e9rie de phase jusqu'\u00e0 ce qu'il effectue quatre \"\u00e9tapes compl\u00e8tes\". Ainsi, un moteur pas \u00e0 pas utilisant 16 micro-pas aura 64 phases et lorsqu'il se d\u00e9place dans le sens positif, il passera par phases : 0, 1, 2, ... 61, 62, 63, 0, 1, 2, etc. Surtout, lorsque le moteur pas \u00e0 pas se trouve \u00e0 une position particuli\u00e8re sur un rail lin\u00e9aire, il doit toujours \u00eatre \u00e0 la m\u00eame phase. Ainsi, lorsqu'un chariot d\u00e9clenche l'interrupteur de fin de course, le moteur pas \u00e0 pas contr\u00f4lant ce chariot doit toujours \u00eatre \u00e0 la m\u00eame phase du moteur pas \u00e0 pas. Le syst\u00e8me de phase d'arr\u00eat final de Klipper combine la phase pas \u00e0 pas avec le d\u00e9clencheur d'arr\u00eat final pour am\u00e9liorer la pr\u00e9cision de l'arr\u00eat final. Pour utiliser cette fonctionnalit\u00e9, il est n\u00e9cessaire de pouvoir identifier la phase du moteur pas \u00e0 pas. Si l'on utilise les pilotes Trinamic TMC2130, TMC2208, TMC2224 ou TMC2660 en mode de configuration d'ex\u00e9cution (c'est-\u00e0-dire pas en mode autonome - \"standalone\"), Klipper peut interroger la phase pas \u00e0 pas du pilote. (Il est \u00e9galement possible d'utiliser ce syst\u00e8me sur des pilotes pas \u00e0 pas traditionnels si l'on peut r\u00e9initialiser de mani\u00e8re fiable ces pilotes pas \u00e0 pas - voir ci-dessous pour plus de d\u00e9tails.)","title":"Phase de fin de course"},{"location":"Endstop_Phase.html#etalonnage-des-phases-de-fin-de-course","text":"Si vous utilisez des pilotes de moteur pas \u00e0 pas Trinamic avec une configuration d'ex\u00e9cution, vous pouvez calibrer les phases de fin de course \u00e0 l'aide de la commande ENDSTOP_PHASE_CALIBRATE. Commencez par ajouter les \u00e9l\u00e9ments suivants au fichier de configuration : [endstop_phase] Red\u00e9marrez ensuite l'imprimante et ex\u00e9cutez une commande G28 suivie d'une commande ENDSTOP_PHASE_CALIBRATE . D\u00e9placez ensuite la t\u00eate d'outil vers un nouvel emplacement et ex\u00e9cutez \u00e0 nouveau G28 . Essayez de d\u00e9placer la t\u00eate d'outil \u00e0 plusieurs endroits diff\u00e9rents et r\u00e9ex\u00e9cutez G28 \u00e0 partir de chaque position. Ex\u00e9cutez au moins cinq commandes G28 . Apr\u00e8s avoir effectu\u00e9 ce qui pr\u00e9c\u00e8de, la commande ENDSTOP_PHASE_CALIBRATE signalera souvent la m\u00eame (ou presque la m\u00eame) phase pour le stepper. Cette phase peut \u00eatre enregistr\u00e9e dans le fichier de configuration afin que toutes les futures commandes G28 utilisent cette phase. (Ainsi, dans les futures op\u00e9rations de prise d'origine, Klipper obtiendra la m\u00eame position m\u00eame si la but\u00e9e se d\u00e9clenche un peu plus t\u00f4t ou un peu plus tard.) Pour enregistrer la phase d'arr\u00eat final d'un moteur pas \u00e0 pas particulier, ex\u00e9cutez quelque chose comme ceci : ENDSTOP_PHASE_CALIBRATE STEPPER=stepper_z Ex\u00e9cutez ce qui pr\u00e9c\u00e8de pour tous les steppers que vous souhaitez enregistrer. En r\u00e8gle g\u00e9n\u00e9rale, on l'utiliserait sur stepper_z pour les imprimantes cart\u00e9siennes et corexy, et pour stepper_a, stepper_b et stepper_c sur les imprimantes delta. Enfin, ex\u00e9cutez la commande suivante pour mettre \u00e0 jour le fichier de configuration avec les donn\u00e9es : SAVE_CONFIG","title":"\u00c9talonnage des phases de fin de course"},{"location":"Endstop_Phase.html#notes-complementaires","text":"Cette fonctionnalit\u00e9 est particuli\u00e8rement utile sur les imprimantes delta et sur la but\u00e9e Z des imprimantes cart\u00e9siennes/corexy. Il est possible d'utiliser cette fonctionnalit\u00e9 sur les but\u00e9es XY des imprimantes cart\u00e9siennes, mais cela n'est pas particuli\u00e8rement utile car une erreur mineure dans la position de la but\u00e9e X/Y n'aura probablement pas d'impact sur la qualit\u00e9 d'impression. Il n'est pas valide d'utiliser cette fonctionnalit\u00e9 sur les but\u00e9es XY des imprimantes corexy (car la position XY n'est pas d\u00e9termin\u00e9e par un seul stepper sur la cin\u00e9matique corexy). Il n'est pas valide d'utiliser cette fonctionnalit\u00e9 sur une imprimante utilisant une but\u00e9e Z \"probe:z_virtual_endstop\" (car la phase pas \u00e0 pas n'est stable que si la but\u00e9e se trouve \u00e0 un emplacement statique sur un rail). Apr\u00e8s avoir calibr\u00e9 la phase de but\u00e9e, si la but\u00e9e est d\u00e9plac\u00e9e ou ajust\u00e9e ult\u00e9rieurement, il sera n\u00e9cessaire de recalibrer la but\u00e9e. Supprimez les donn\u00e9es d'\u00e9talonnage du fichier de configuration et r\u00e9ex\u00e9cutez les \u00e9tapes ci-dessus. Pour utiliser ce syst\u00e8me, la but\u00e9e doit \u00eatre suffisamment pr\u00e9cise pour identifier la position du stepper en deux \"pas complets\". Ainsi, par exemple, si un stepper utilise 16 micro-pas avec une distance de pas de 0,005 mm, la but\u00e9e doit avoir une pr\u00e9cision d'au moins 0,160 mm. Si l'on obtient des messages d'erreur de type \"Endstop stepper_z incorrect phase\", cela peut \u00eatre d\u00fb \u00e0 un endstop qui n'est pas suffisamment pr\u00e9cis. Si le recalibrage n'aide pas, d\u00e9sactivez les ajustements de phase de but\u00e9e en les supprimant du fichier de configuration. Si l'on utilise un axe Z traditionnel contr\u00f4l\u00e9 par pas \u00e0 pas (comme sur une imprimante cart\u00e9sienne ou corexy) avec des vis de nivellement de lit traditionnelles, il est \u00e9galement possible d'utiliser ce syst\u00e8me pour faire en sorte que chaque couche d'impression soit effectu\u00e9e sur une limite \"pas complet\" . Pour activer cette fonctionnalit\u00e9, assurez-vous que le slicer G-Code est configur\u00e9 avec une hauteur de couche qui est un multiple d'un \"pas complet\", activez manuellement l'option endstop_align_zero dans la section de configuration endstop_phase (voir reference de configuration pour plus de d\u00e9tails), puis remettez \u00e0 niveau les vis du lit. Il est possible d'utiliser ce syst\u00e8me avec des pilotes de moteurs pas \u00e0 pas traditionnels (non Trinamic). Cependant, cela n\u00e9cessite de s'assurer que les pilotes du moteur pas \u00e0 pas sont r\u00e9initialis\u00e9s \u00e0 chaque fois que le microcontr\u00f4leur est r\u00e9initialis\u00e9. (Si les deux sont toujours r\u00e9initialis\u00e9s ensemble, Klipper peut d\u00e9terminer la phase du moteur pas \u00e0 pas en suivant le nombre total de pas qu'il a command\u00e9 au moteur pas \u00e0 pas.) Actuellement, la seule fa\u00e7on de le faire de mani\u00e8re fiable est que le microcontr\u00f4leur et le moteur pas \u00e0 pas les pilotes soient aliment\u00e9s uniquement par USB et que l'alimentation USB soit fournie par un h\u00f4te fonctionnant sur un Raspberry Pi. Dans cette situation, on peut sp\u00e9cifier une configuration mcu avec \"restart_method\u202f: rpi_usb\" - cette option fera en sorte que le microcontr\u00f4leur soit toujours r\u00e9initialis\u00e9 via une r\u00e9initialisation de l'alimentation USB, ce qui permettrait \u00e0 la fois au microcontr\u00f4leur et aux pilotes de moteur pas \u00e0 pas d'\u00eatre r\u00e9initialiser ensemble. Si vous utilisez ce m\u00e9canisme, vous devrez alors configurer manuellement les sections de configuration \"trigger_phase\" (voir config reference pour les d\u00e9tails).","title":"Notes compl\u00e9mentaires"},{"location":"Example_Configs.html","text":"Exemples de configurations \u00b6 Ce document contient des directives pour contribuer \u00e0 un exemple de configuration Klipper dans le d\u00e9p\u00f4t github de Klipper (situ\u00e9 dans le r\u00e9pertoire config ). Notez que le serveur discord communautaire de Klipper est une ressource utile pour trouver et partager des fichiers de configuration. Lignes directives \u00b6 S\u00e9lectionnez le pr\u00e9fixe de nom de fichier de configuration appropri\u00e9 : Le pr\u00e9fixe printer est utilis\u00e9 pour les imprimantes de stock vendues par un fabricant grand public. Le pr\u00e9fixe generic est utilis\u00e9 pour une carte m\u00e8re d'imprimante 3d qui peut \u00eatre utilis\u00e9e dans de nombreux types d'imprimantes. Le pr\u00e9fixe kit est destin\u00e9 aux imprimantes 3D assembl\u00e9es selon une sp\u00e9cification largement utilis\u00e9e. Ces imprimantes en \u00ab kit \u00bb sont g\u00e9n\u00e9ralement distinctes des \u00ab imprimantes \u00bb normales en ce sens qu\u2019elles ne sont pas vendues par un fabricant. Le pr\u00e9fixe sample est utilis\u00e9 pour des \"extraits\" de configuration que l'on peut copier-coller dans le fichier de configuration principal. Le pr\u00e9fixe example est utilis\u00e9 pour d\u00e9crire la cin\u00e9matique de l\u2019imprimante. Ce type de configuration n\u2019est g\u00e9n\u00e9ralement ajout\u00e9 qu\u2019avec le code d\u2019un nouveau type de cin\u00e9matique d\u2019imprimante. Tous les fichiers de configuration doivent se terminer par un suffixe .cfg . Les fichiers de configuration printer doivent se terminer par une ann\u00e9e suivie de .cfg (par exemple, -2019.cfg ). Dans ce cas, l'ann\u00e9e est une ann\u00e9e approximative o\u00f9 l'imprimante donn\u00e9e a \u00e9t\u00e9 vendue. N'utilisez pas d'espaces ou de caract\u00e8res sp\u00e9ciaux dans le nom du fichier de configuration. Le nom du fichier doit contenir uniquement les caract\u00e8res A-Z , a-z , 0-9 , - , et . . Klipper doit \u00eatre capable de d\u00e9marrer les fichiers de configuration d'exemple printer , generic , et kit sans erreur. Ces fichiers de configuration doivent \u00eatre ajout\u00e9s au sc\u00e9nario de test de r\u00e9gression test/klippy/printers.test . Ajoutez les nouveaux fichiers de configuration \u00e0 ce sc\u00e9nario de test dans la section appropri\u00e9e et par ordre alphab\u00e9tique dans cette section. L'exemple de configuration doit correspondre \u00e0 la configuration \"standard\" de l'imprimante. (Il existe trop de configurations \"personnalis\u00e9es\" pour \u00eatre suivies dans le r\u00e9f\u00e9rentiel principal de Klipper). De m\u00eame, nous n'ajoutons de fichiers de configuration d'exemple que pour les imprimantes, les kits et les cartes contr\u00f4leur qui ont une popularit\u00e9 grand public (par exemple, il devrait y en avoir au moins une centaine en utilisation active). Pensez \u00e0 utiliser le Serveur communautaire Discourse de Klipper pour les autres configurations. Only specify those devices present on the given printer or board. Do not specify settings specific to your particular setup. For generic config files, only those devices on the mainboard should be described. For example, it would not make sense to add a display config section to a \"generic\" config as there is no way to know if the board will be attached to that type of display. If the board has a specific hardware port to facilitate an optional peripheral (eg, a bltouch port) then one can add a \"commented out\" config section for the given device. Ne sp\u00e9cifiez pas pressure_advance dans un exemple de configuration, car cette valeur est sp\u00e9cifique au filament, et non au mat\u00e9riel de l'imprimante. De m\u00eame, ne sp\u00e9cifiez pas les param\u00e8tres max_extrude_only_velocity et max_extrude_only_accel . Ne sp\u00e9cifiez pas une section de configuration contenant un chemin d'acc\u00e8s \u00e0 l'h\u00f4te ou un mat\u00e9riel h\u00f4te. Par exemple, ne sp\u00e9cifiez pas les sections de configuration [virtual_sdcard] et [temperature_host] . Ne d\u00e9finissez que les macros qui utilisent une fonctionnalit\u00e9 sp\u00e9cifique \u00e0 l'imprimante donn\u00e9e ou pour d\u00e9finir les codes g g\u00e9n\u00e9ralement \u00e9mis par les trancheurs configur\u00e9s pour l'imprimante donn\u00e9e. Where possible, it is best to use the same wording, phrasing, indentation, and section ordering as the existing config files. The top of each config file should list the type of micro-controller the user should select during \"make menuconfig\". It should also have a reference to \"docs/Config_Reference.md\". Ne copiez pas la documentation du champ dans les fichiers de configuration d'exemple. (Faire cela cr\u00e9e une charge de maintenance car une mise \u00e0 jour de la documentation n\u00e9cessiterait alors de la modifier \u00e0 de nombreux endroits.) Les exemples de fichiers de configuration ne doivent pas contenir de section \"SAVE_CONFIG\". Si n\u00e9cessaire, copiez les champs pertinents de la section SAVE_CONFIG dans la section appropri\u00e9e de la zone de configuration principale. Utilisez la syntaxe field: value au lieu de field=value . Lorsque vous ajoutez une rotation_distance pour une extrudeuse, il est pr\u00e9f\u00e9rable de sp\u00e9cifier un gear_ratio si l'extrudeuse a un m\u00e9canisme d'engrenage. Nous nous attendons \u00e0 ce que la distance de rotation dans les exemples de configuration corresponde \u00e0 la circonf\u00e9rence de l'engrenage dent\u00e9 dans l'extrudeuse - elle est normalement comprise entre 20 et 35 mm. Lorsque vous sp\u00e9cifiez un gear_ratio , il est pr\u00e9f\u00e9rable de sp\u00e9cifier les engrenages r\u00e9els du m\u00e9canisme (par exemple, pr\u00e9f\u00e9rez gear_ratio : 80:20 \u00e0 gear_ratio : 4:1 ). Voir le document sur la distance de rotation pour plus d'informations. \u00c9vitez de d\u00e9finir des valeurs de champ fix\u00e9es \u00e0 leur valeur par d\u00e9faut. Par exemple, il est inutile de sp\u00e9cifier min_extrude_temp : 170 car c'est d\u00e9j\u00e0 la valeur par d\u00e9faut. Dans la mesure du possible, les lignes ne devraient pas d\u00e9passer 80 colonnes. \u00c9vitez d'ajouter des messages d'attribution ou de r\u00e9vision dans les fichiers de configuration. (Par exemple, \u00e9vitez d'ajouter des lignes telles que \"ce fichier a \u00e9t\u00e9 cr\u00e9\u00e9 par ...\".) Placez l'attribution et l'historique des modifications dans le message git commit. N'utilisez pas de fonctionnalit\u00e9s obsol\u00e8tes dans le fichier de configuration d'exemple. Ne pas d\u00e9sactiver un syst\u00e8me de s\u00e9curit\u00e9 par d\u00e9faut dans un fichier de configuration d'exemple. Par exemple, une configuration ne doit pas sp\u00e9cifier un max_extrude_cross_section personnalis\u00e9. N'activez pas les fonctions de d\u00e9bogage. Par exemple, il ne doit pas y avoir de section de configuration force_move . Toutes les cartes connues que Klipper prend en charge peuvent utiliser la vitesse de transmission s\u00e9rie par d\u00e9faut de 250000. Ne recommandez pas un d\u00e9bit en bauds diff\u00e9rent dans un fichier de configuration d'exemple. Les exemples de fichiers de configuration sont soumis en cr\u00e9ant une \"pull request\" sur github. Veuillez \u00e9galement suivre les instructions du document de contribution .","title":"Exemples de configurations"},{"location":"Example_Configs.html#exemples-de-configurations","text":"Ce document contient des directives pour contribuer \u00e0 un exemple de configuration Klipper dans le d\u00e9p\u00f4t github de Klipper (situ\u00e9 dans le r\u00e9pertoire config ). Notez que le serveur discord communautaire de Klipper est une ressource utile pour trouver et partager des fichiers de configuration.","title":"Exemples de configurations"},{"location":"Example_Configs.html#lignes-directives","text":"S\u00e9lectionnez le pr\u00e9fixe de nom de fichier de configuration appropri\u00e9 : Le pr\u00e9fixe printer est utilis\u00e9 pour les imprimantes de stock vendues par un fabricant grand public. Le pr\u00e9fixe generic est utilis\u00e9 pour une carte m\u00e8re d'imprimante 3d qui peut \u00eatre utilis\u00e9e dans de nombreux types d'imprimantes. Le pr\u00e9fixe kit est destin\u00e9 aux imprimantes 3D assembl\u00e9es selon une sp\u00e9cification largement utilis\u00e9e. Ces imprimantes en \u00ab kit \u00bb sont g\u00e9n\u00e9ralement distinctes des \u00ab imprimantes \u00bb normales en ce sens qu\u2019elles ne sont pas vendues par un fabricant. Le pr\u00e9fixe sample est utilis\u00e9 pour des \"extraits\" de configuration que l'on peut copier-coller dans le fichier de configuration principal. Le pr\u00e9fixe example est utilis\u00e9 pour d\u00e9crire la cin\u00e9matique de l\u2019imprimante. Ce type de configuration n\u2019est g\u00e9n\u00e9ralement ajout\u00e9 qu\u2019avec le code d\u2019un nouveau type de cin\u00e9matique d\u2019imprimante. Tous les fichiers de configuration doivent se terminer par un suffixe .cfg . Les fichiers de configuration printer doivent se terminer par une ann\u00e9e suivie de .cfg (par exemple, -2019.cfg ). Dans ce cas, l'ann\u00e9e est une ann\u00e9e approximative o\u00f9 l'imprimante donn\u00e9e a \u00e9t\u00e9 vendue. N'utilisez pas d'espaces ou de caract\u00e8res sp\u00e9ciaux dans le nom du fichier de configuration. Le nom du fichier doit contenir uniquement les caract\u00e8res A-Z , a-z , 0-9 , - , et . . Klipper doit \u00eatre capable de d\u00e9marrer les fichiers de configuration d'exemple printer , generic , et kit sans erreur. Ces fichiers de configuration doivent \u00eatre ajout\u00e9s au sc\u00e9nario de test de r\u00e9gression test/klippy/printers.test . Ajoutez les nouveaux fichiers de configuration \u00e0 ce sc\u00e9nario de test dans la section appropri\u00e9e et par ordre alphab\u00e9tique dans cette section. L'exemple de configuration doit correspondre \u00e0 la configuration \"standard\" de l'imprimante. (Il existe trop de configurations \"personnalis\u00e9es\" pour \u00eatre suivies dans le r\u00e9f\u00e9rentiel principal de Klipper). De m\u00eame, nous n'ajoutons de fichiers de configuration d'exemple que pour les imprimantes, les kits et les cartes contr\u00f4leur qui ont une popularit\u00e9 grand public (par exemple, il devrait y en avoir au moins une centaine en utilisation active). Pensez \u00e0 utiliser le Serveur communautaire Discourse de Klipper pour les autres configurations. Only specify those devices present on the given printer or board. Do not specify settings specific to your particular setup. For generic config files, only those devices on the mainboard should be described. For example, it would not make sense to add a display config section to a \"generic\" config as there is no way to know if the board will be attached to that type of display. If the board has a specific hardware port to facilitate an optional peripheral (eg, a bltouch port) then one can add a \"commented out\" config section for the given device. Ne sp\u00e9cifiez pas pressure_advance dans un exemple de configuration, car cette valeur est sp\u00e9cifique au filament, et non au mat\u00e9riel de l'imprimante. De m\u00eame, ne sp\u00e9cifiez pas les param\u00e8tres max_extrude_only_velocity et max_extrude_only_accel . Ne sp\u00e9cifiez pas une section de configuration contenant un chemin d'acc\u00e8s \u00e0 l'h\u00f4te ou un mat\u00e9riel h\u00f4te. Par exemple, ne sp\u00e9cifiez pas les sections de configuration [virtual_sdcard] et [temperature_host] . Ne d\u00e9finissez que les macros qui utilisent une fonctionnalit\u00e9 sp\u00e9cifique \u00e0 l'imprimante donn\u00e9e ou pour d\u00e9finir les codes g g\u00e9n\u00e9ralement \u00e9mis par les trancheurs configur\u00e9s pour l'imprimante donn\u00e9e. Where possible, it is best to use the same wording, phrasing, indentation, and section ordering as the existing config files. The top of each config file should list the type of micro-controller the user should select during \"make menuconfig\". It should also have a reference to \"docs/Config_Reference.md\". Ne copiez pas la documentation du champ dans les fichiers de configuration d'exemple. (Faire cela cr\u00e9e une charge de maintenance car une mise \u00e0 jour de la documentation n\u00e9cessiterait alors de la modifier \u00e0 de nombreux endroits.) Les exemples de fichiers de configuration ne doivent pas contenir de section \"SAVE_CONFIG\". Si n\u00e9cessaire, copiez les champs pertinents de la section SAVE_CONFIG dans la section appropri\u00e9e de la zone de configuration principale. Utilisez la syntaxe field: value au lieu de field=value . Lorsque vous ajoutez une rotation_distance pour une extrudeuse, il est pr\u00e9f\u00e9rable de sp\u00e9cifier un gear_ratio si l'extrudeuse a un m\u00e9canisme d'engrenage. Nous nous attendons \u00e0 ce que la distance de rotation dans les exemples de configuration corresponde \u00e0 la circonf\u00e9rence de l'engrenage dent\u00e9 dans l'extrudeuse - elle est normalement comprise entre 20 et 35 mm. Lorsque vous sp\u00e9cifiez un gear_ratio , il est pr\u00e9f\u00e9rable de sp\u00e9cifier les engrenages r\u00e9els du m\u00e9canisme (par exemple, pr\u00e9f\u00e9rez gear_ratio : 80:20 \u00e0 gear_ratio : 4:1 ). Voir le document sur la distance de rotation pour plus d'informations. \u00c9vitez de d\u00e9finir des valeurs de champ fix\u00e9es \u00e0 leur valeur par d\u00e9faut. Par exemple, il est inutile de sp\u00e9cifier min_extrude_temp : 170 car c'est d\u00e9j\u00e0 la valeur par d\u00e9faut. Dans la mesure du possible, les lignes ne devraient pas d\u00e9passer 80 colonnes. \u00c9vitez d'ajouter des messages d'attribution ou de r\u00e9vision dans les fichiers de configuration. (Par exemple, \u00e9vitez d'ajouter des lignes telles que \"ce fichier a \u00e9t\u00e9 cr\u00e9\u00e9 par ...\".) Placez l'attribution et l'historique des modifications dans le message git commit. N'utilisez pas de fonctionnalit\u00e9s obsol\u00e8tes dans le fichier de configuration d'exemple. Ne pas d\u00e9sactiver un syst\u00e8me de s\u00e9curit\u00e9 par d\u00e9faut dans un fichier de configuration d'exemple. Par exemple, une configuration ne doit pas sp\u00e9cifier un max_extrude_cross_section personnalis\u00e9. N'activez pas les fonctions de d\u00e9bogage. Par exemple, il ne doit pas y avoir de section de configuration force_move . Toutes les cartes connues que Klipper prend en charge peuvent utiliser la vitesse de transmission s\u00e9rie par d\u00e9faut de 250000. Ne recommandez pas un d\u00e9bit en bauds diff\u00e9rent dans un fichier de configuration d'exemple. Les exemples de fichiers de configuration sont soumis en cr\u00e9ant une \"pull request\" sur github. Veuillez \u00e9galement suivre les instructions du document de contribution .","title":"Lignes directives"},{"location":"Exclude_Object.html","text":"Exclure des objets \u00b6 The [exclude_object] module allows Klipper to exclude objects while a print is in progress. To enable this feature include an exclude_object config section (also see the command reference and sample-macros.cfg file for a Marlin/RepRapFirmware compatible M486 G-Code macro.) Contrairement \u00e0 d'autres options de micrologiciel d'imprimante 3D, une imprimante ex\u00e9cutant Klipper utilise une suite de composants et les utilisateurs ont le choix de nombreuses options. Par cons\u00e9quent, afin de fournir une exp\u00e9rience utilisateur coh\u00e9rente, le module [exclude_object] \u00e9tablira un contrat ou une sorte d'API. Le contrat couvre le contenu du fichier gcode, la fa\u00e7on dont l'\u00e9tat interne du module est contr\u00f4l\u00e9, et la fa\u00e7on dont cet \u00e9tat est fourni aux clients. Aper\u00e7u du flux de travail \u00b6 Le flux de travail typique de l'impression d'un fichier peut ressembler \u00e0 ceci : Le tranchage est termin\u00e9 et le fichier a \u00e9t\u00e9 t\u00e9l\u00e9charg\u00e9 pour \u00eatre imprim\u00e9. Pendant le t\u00e9l\u00e9chargement, le fichier est trait\u00e9 et des marqueurs [exclude_object] sont ajout\u00e9s au fichier. Alternativement, les trancheurs peuvent \u00eatre configur\u00e9s pour pr\u00e9parer les marqueurs d'exclusion d'objets de mani\u00e8re native ou dans leur propre \u00e9tape de pr\u00e9traitement. Lorsque l'impression d\u00e9marre, Klipper r\u00e9initialise l' \u00e9tat de [exclude_object] . Lorsque Klipper traite le bloc EXCLUDE_OBJECT_DEFINE , il met \u00e0 jour l'\u00e9tat avec les objets connus et le transmet aux clients. Le client peut utiliser ces informations pour pr\u00e9senter une interface \u00e0 l'utilisateur afin de suivre la progression. Klipper mettra \u00e0 jour l'\u00e9tat pour inclure l'objet en cours d'impression que le client peut utiliser \u00e0 des fins d'affichage. Si l'utilisateur demande l'annulation d'un objet, le client envoie une commande EXCLUDE_OBJECT NAME=<name> \u00e0 Klipper. Lorsque Klipper traite la commande, il ajoute l'objet \u00e0 la liste des objets exclus et met \u00e0 jour le statut du client. Le client recevra l'\u00e9tat mis \u00e0 jour de Klipper et pourra utiliser cette information pour refl\u00e9ter l'\u00e9tat de l'objet dans l'interface utilisateur. Une fois l'impression termin\u00e9e, l'\u00e9tat [exclude_object] continuera \u00e0 \u00eatre disponible jusqu'\u00e0 ce qu'une autre action le r\u00e9initialise. Le fichier GCode \u00b6 Le traitement particulier du gcode n\u00e9cessaire \u00e0 la prise en charge des objets exclus ne correspond pas aux caract\u00e9ristiques de conception de d\u00e9part de Klipper. Par cons\u00e9quent, ce module exige que le fichier soit trait\u00e9 avant d'\u00eatre envoy\u00e9 \u00e0 Klipper pour l'impression. L'utilisation d'un script de post-traitement dans le trancheur ou le traitement du fichier par un logiciel interm\u00e9diaire lors du t\u00e9l\u00e9chargement sont deux possibilit\u00e9s pour pr\u00e9parer le fichier pour Klipper. Un script de post-traitement de r\u00e9f\u00e9rence est disponible \u00e0 la fois comme ex\u00e9cutable et comme biblioth\u00e8que python, voir cancelobject-preprocessor . D\u00e9finitions des objets \u00b6 La commande EXCLUDE_OBJECT_DEFINE est utilis\u00e9e pour fournir un r\u00e9sum\u00e9 de chaque objet du fichier gcode \u00e0 imprimer. Elle fournit le r\u00e9sum\u00e9 d'un objet dans le fichier. Les objets n'ont pas besoin d'\u00eatre d\u00e9finis pour \u00eatre r\u00e9f\u00e9renc\u00e9s par d'autres commandes. Le but principal de cette commande est de fournir des informations \u00e0 l'interface utilisateur sans avoir \u00e0 analyser le fichier gcode en entier. Les d\u00e9finitions d'objets sont nomm\u00e9es, pour permettre aux utilisateurs de s\u00e9lectionner facilement un objet \u00e0 exclure, et des m\u00e9tadonn\u00e9es suppl\u00e9mentaires peuvent \u00eatre fournies pour permettre des affichages graphiques d'annulation. Les m\u00e9tadonn\u00e9es actuellement d\u00e9finies comprennent une coordonn\u00e9e X,Y CENTER , et une liste POLYGON de points X,Y repr\u00e9sentant un contour minimal de l'objet. Il peut s'agir d'une simple bo\u00eete englobante ou d'une coque complexe permettant de visualiser les objets imprim\u00e9s de mani\u00e8re plus d\u00e9taill\u00e9e. En particulier, lorsque les fichiers gcode comprennent plusieurs parties avec des r\u00e9gions limites qui se chevauchent, les points centraux deviennent difficiles \u00e0 distinguer visuellement. POLYGONS doit \u00eatre un tableau compatible json de points [X,Y] ( tuples) sans espace. Les param\u00e8tres suppl\u00e9mentaires seront enregistr\u00e9s sous forme de cha\u00eenes de caract\u00e8res dans la d\u00e9finition de l'objet et fournis dans les mises \u00e0 jour de l'\u00e9tat. EXCLUDE_OBJECT_DEFINE NAME=calibration_pyramid CENTER=50,50 POLYGON=[[40,40],[50,60],[60,40]] All available G-Code commands are documented in the G-Code Reference Informations sur le statut \u00b6 The state of this module is provided to clients by the exclude_object status . L'\u00e9tat est r\u00e9initialis\u00e9 lorsque : Le microprogramme Klipper est red\u00e9marr\u00e9. Il y a une r\u00e9initialisation de la [virtual_sdcard] . Notamment, ceci est remis \u00e0 z\u00e9ro par Klipper au d\u00e9but d'une impression. Lorsqu'une commande EXCLUDE_OBJECT_DEFINE RESET=1 est \u00e9mise. La liste des objets d\u00e9finis est repr\u00e9sent\u00e9e dans le champ d'\u00e9tat exclude_object.objects . Dans un fichier gcode bien d\u00e9fini, cela sera fait avec les commandes EXCLUDE_OBJECT_DEFINE au d\u00e9but du fichier. Cela fournira aux clients les noms et les coordonn\u00e9es des objets afin que l'interface utilisateur puisse fournir une repr\u00e9sentation graphique des objets si n\u00e9cessaire. Au fur et \u00e0 mesure de l'impression, le champ d'\u00e9tat exclude_object.current_object sera mis \u00e0 jour lorsque Klipper traitera les commandes EXCLUDE_OBJECT_START et EXCLUDE_OBJECT_END . Le champ current_object sera activ\u00e9 m\u00eame si l'objet a \u00e9t\u00e9 exclu. Les objets non d\u00e9finis marqu\u00e9s d'un EXCLUDE_OBJECT_START seront ajout\u00e9s aux objets connus pour aider \u00e0 la mise en place de l'interface utilisateur, sans m\u00e9tadonn\u00e9es suppl\u00e9mentaires. Lorsque les commandes EXCLUDE_OBJECT sont \u00e9mises, la liste des objets exclus est fournie dans le tableau exclude_object.excluded_objects . Comme Klipper anticipe le traitement du gcode \u00e0 venir, il peut y avoir un d\u00e9lai entre le moment o\u00f9 la commande est \u00e9mise et celui o\u00f9 le statut est mis \u00e0 jour.","title":"Exclure des objets"},{"location":"Exclude_Object.html#exclure-des-objets","text":"The [exclude_object] module allows Klipper to exclude objects while a print is in progress. To enable this feature include an exclude_object config section (also see the command reference and sample-macros.cfg file for a Marlin/RepRapFirmware compatible M486 G-Code macro.) Contrairement \u00e0 d'autres options de micrologiciel d'imprimante 3D, une imprimante ex\u00e9cutant Klipper utilise une suite de composants et les utilisateurs ont le choix de nombreuses options. Par cons\u00e9quent, afin de fournir une exp\u00e9rience utilisateur coh\u00e9rente, le module [exclude_object] \u00e9tablira un contrat ou une sorte d'API. Le contrat couvre le contenu du fichier gcode, la fa\u00e7on dont l'\u00e9tat interne du module est contr\u00f4l\u00e9, et la fa\u00e7on dont cet \u00e9tat est fourni aux clients.","title":"Exclure des objets"},{"location":"Exclude_Object.html#apercu-du-flux-de-travail","text":"Le flux de travail typique de l'impression d'un fichier peut ressembler \u00e0 ceci : Le tranchage est termin\u00e9 et le fichier a \u00e9t\u00e9 t\u00e9l\u00e9charg\u00e9 pour \u00eatre imprim\u00e9. Pendant le t\u00e9l\u00e9chargement, le fichier est trait\u00e9 et des marqueurs [exclude_object] sont ajout\u00e9s au fichier. Alternativement, les trancheurs peuvent \u00eatre configur\u00e9s pour pr\u00e9parer les marqueurs d'exclusion d'objets de mani\u00e8re native ou dans leur propre \u00e9tape de pr\u00e9traitement. Lorsque l'impression d\u00e9marre, Klipper r\u00e9initialise l' \u00e9tat de [exclude_object] . Lorsque Klipper traite le bloc EXCLUDE_OBJECT_DEFINE , il met \u00e0 jour l'\u00e9tat avec les objets connus et le transmet aux clients. Le client peut utiliser ces informations pour pr\u00e9senter une interface \u00e0 l'utilisateur afin de suivre la progression. Klipper mettra \u00e0 jour l'\u00e9tat pour inclure l'objet en cours d'impression que le client peut utiliser \u00e0 des fins d'affichage. Si l'utilisateur demande l'annulation d'un objet, le client envoie une commande EXCLUDE_OBJECT NAME=<name> \u00e0 Klipper. Lorsque Klipper traite la commande, il ajoute l'objet \u00e0 la liste des objets exclus et met \u00e0 jour le statut du client. Le client recevra l'\u00e9tat mis \u00e0 jour de Klipper et pourra utiliser cette information pour refl\u00e9ter l'\u00e9tat de l'objet dans l'interface utilisateur. Une fois l'impression termin\u00e9e, l'\u00e9tat [exclude_object] continuera \u00e0 \u00eatre disponible jusqu'\u00e0 ce qu'une autre action le r\u00e9initialise.","title":"Aper\u00e7u du flux de travail"},{"location":"Exclude_Object.html#le-fichier-gcode","text":"Le traitement particulier du gcode n\u00e9cessaire \u00e0 la prise en charge des objets exclus ne correspond pas aux caract\u00e9ristiques de conception de d\u00e9part de Klipper. Par cons\u00e9quent, ce module exige que le fichier soit trait\u00e9 avant d'\u00eatre envoy\u00e9 \u00e0 Klipper pour l'impression. L'utilisation d'un script de post-traitement dans le trancheur ou le traitement du fichier par un logiciel interm\u00e9diaire lors du t\u00e9l\u00e9chargement sont deux possibilit\u00e9s pour pr\u00e9parer le fichier pour Klipper. Un script de post-traitement de r\u00e9f\u00e9rence est disponible \u00e0 la fois comme ex\u00e9cutable et comme biblioth\u00e8que python, voir cancelobject-preprocessor .","title":"Le fichier GCode"},{"location":"Exclude_Object.html#definitions-des-objets","text":"La commande EXCLUDE_OBJECT_DEFINE est utilis\u00e9e pour fournir un r\u00e9sum\u00e9 de chaque objet du fichier gcode \u00e0 imprimer. Elle fournit le r\u00e9sum\u00e9 d'un objet dans le fichier. Les objets n'ont pas besoin d'\u00eatre d\u00e9finis pour \u00eatre r\u00e9f\u00e9renc\u00e9s par d'autres commandes. Le but principal de cette commande est de fournir des informations \u00e0 l'interface utilisateur sans avoir \u00e0 analyser le fichier gcode en entier. Les d\u00e9finitions d'objets sont nomm\u00e9es, pour permettre aux utilisateurs de s\u00e9lectionner facilement un objet \u00e0 exclure, et des m\u00e9tadonn\u00e9es suppl\u00e9mentaires peuvent \u00eatre fournies pour permettre des affichages graphiques d'annulation. Les m\u00e9tadonn\u00e9es actuellement d\u00e9finies comprennent une coordonn\u00e9e X,Y CENTER , et une liste POLYGON de points X,Y repr\u00e9sentant un contour minimal de l'objet. Il peut s'agir d'une simple bo\u00eete englobante ou d'une coque complexe permettant de visualiser les objets imprim\u00e9s de mani\u00e8re plus d\u00e9taill\u00e9e. En particulier, lorsque les fichiers gcode comprennent plusieurs parties avec des r\u00e9gions limites qui se chevauchent, les points centraux deviennent difficiles \u00e0 distinguer visuellement. POLYGONS doit \u00eatre un tableau compatible json de points [X,Y] ( tuples) sans espace. Les param\u00e8tres suppl\u00e9mentaires seront enregistr\u00e9s sous forme de cha\u00eenes de caract\u00e8res dans la d\u00e9finition de l'objet et fournis dans les mises \u00e0 jour de l'\u00e9tat. EXCLUDE_OBJECT_DEFINE NAME=calibration_pyramid CENTER=50,50 POLYGON=[[40,40],[50,60],[60,40]] All available G-Code commands are documented in the G-Code Reference","title":"D\u00e9finitions des objets"},{"location":"Exclude_Object.html#informations-sur-le-statut","text":"The state of this module is provided to clients by the exclude_object status . L'\u00e9tat est r\u00e9initialis\u00e9 lorsque : Le microprogramme Klipper est red\u00e9marr\u00e9. Il y a une r\u00e9initialisation de la [virtual_sdcard] . Notamment, ceci est remis \u00e0 z\u00e9ro par Klipper au d\u00e9but d'une impression. Lorsqu'une commande EXCLUDE_OBJECT_DEFINE RESET=1 est \u00e9mise. La liste des objets d\u00e9finis est repr\u00e9sent\u00e9e dans le champ d'\u00e9tat exclude_object.objects . Dans un fichier gcode bien d\u00e9fini, cela sera fait avec les commandes EXCLUDE_OBJECT_DEFINE au d\u00e9but du fichier. Cela fournira aux clients les noms et les coordonn\u00e9es des objets afin que l'interface utilisateur puisse fournir une repr\u00e9sentation graphique des objets si n\u00e9cessaire. Au fur et \u00e0 mesure de l'impression, le champ d'\u00e9tat exclude_object.current_object sera mis \u00e0 jour lorsque Klipper traitera les commandes EXCLUDE_OBJECT_START et EXCLUDE_OBJECT_END . Le champ current_object sera activ\u00e9 m\u00eame si l'objet a \u00e9t\u00e9 exclu. Les objets non d\u00e9finis marqu\u00e9s d'un EXCLUDE_OBJECT_START seront ajout\u00e9s aux objets connus pour aider \u00e0 la mise en place de l'interface utilisateur, sans m\u00e9tadonn\u00e9es suppl\u00e9mentaires. Lorsque les commandes EXCLUDE_OBJECT sont \u00e9mises, la liste des objets exclus est fournie dans le tableau exclude_object.excluded_objects . Comme Klipper anticipe le traitement du gcode \u00e0 venir, il peut y avoir un d\u00e9lai entre le moment o\u00f9 la commande est \u00e9mise et celui o\u00f9 le statut est mis \u00e0 jour.","title":"Informations sur le statut"},{"location":"FAQ.html","text":"Foire Aux Questions \u00b6 Comment puis-je faire un don au projet ? \u00b6 Merci de votre soutien. Voir la page Sponsors pour plus d'informations. Comment calculer le param\u00e8tre de configuration rotation_distance ? \u00b6 Voir le document sur la distance de rotation . O\u00f9 est mon port s\u00e9rie ? \u00b6 De mani\u00e8re g\u00e9n\u00e9rale, on ex\u00e9cute la commande ls /dev/serial/by-id/* \u00e0 partir d'un terminal ssh sur la machine h\u00f4te pour trouver un port s\u00e9rie USB. Cette commande produira s\u00fbrement un r\u00e9sultat similaire \u00e0 celui-ci : /dev/serial/by-id/usb-1a86_USB2.0-Serial-if00-port0 Le nom retourn\u00e9 par la commande ci-dessus est constant, il est donc possible de l'utiliser dans le fichier de configuration et lors du flashage du microcontr\u00f4leur. Par exemple, une commande de flash peur ressembler \u00e0 : sudo service klipper stop make flash FLASH_DEVICE=/dev/serial/by-id/usb-1a86_USB2.0-Serial-if00-port0 sudo service klipper start et la configuration mise \u00e0 jour devrait ressembler \u00e0 : [mcu] serial: /dev/serial/by-id/usb-1a86_USB2.0-Serial-if00-port0 Veillez \u00e0 copier-coller le nom retourn\u00e9 par la commande \"ls\" que vous avez ex\u00e9cut\u00e9e ci-avant, car le nom sera diff\u00e9rent pour chaque imprimante. Si vous utilisez plusieurs microcontr\u00f4leurs et qu'ils n'ont pas d'identifiant unique (fr\u00e9quent avec les cartes utilisant une puce USB CH340), suivez les instructions ci-dessus en utilisant la commande ls /dev/serial/by-path/* \u00e0 la place. Lorsque le microcontr\u00f4leur red\u00e9marre, le p\u00e9riph\u00e9rique passe \u00e0 /dev/ttyUSB1 \u00b6 Suivez les instructions de la section \" O\u00f9 est mon port s\u00e9rie ? \" pour \u00e9viter que cela ne se produise. La commande \"make flash\" ne fonctionne pas \u00b6 Le code tente de flasher le dispositif en utilisant la m\u00e9thode la plus courante pour chaque plateforme. Malheureusement, il y a beaucoup de variations dans les m\u00e9thodes de flashage, donc la commande \"make flash\" peut ne pas fonctionner avec toutes les cartes. Si vous rencontrez une erreur intermittente ou si votre configuration est standard, v\u00e9rifiez que Klipper est arr\u00eat\u00e9 pendant le flashage (sudo service klipper stop), assurez-vous qu'OctoPrint n'essaye pas de se connecter directement \u00e0 l'appareil (ouvrez l'onglet Connexion de la page web et cliquez sur D\u00e9connecter si le port s\u00e9rie de la carte est s\u00e9lectionn\u00e9), et assurez-vous que FLASH_DEVICE est correctement d\u00e9fini pour votre carte (voir la question ci-dessus ). Toutefois si \"make flash\" ne fonctionne pas pour votre carte, vous devrez flasher manuellement. V\u00e9rifiez s'il existe un fichier de configuration dans le r\u00e9pertoire config avec des instructions sp\u00e9cifiques pour flasher la carte. V\u00e9rifiez \u00e9galement la documentation du fabricant de la carte pour voir si elle d\u00e9crit comment la flasher. Enfin, il peut \u00eatre possible de flasher manuellement la carte en utilisant des outils tels que \"avrdude\" ou \"bossac\" - voir le document sur les booloaders pour plus d'informations. Comment changer la vitesse de communication(baud rate) du port s\u00e9rie ? \u00b6 Le baud rate (taux bit/s) recommand\u00e9 pour Klipper est de 250000. Ce baud rate fonctionne bien sur toutes les cartes microcontr\u00f4leurs que Klipper prend en charge. Si vous avez trouv\u00e9 un guide en ligne recommandant un baud rate diff\u00e9rent, ignorez cette partie du guide et continuez avec la valeur par d\u00e9faut de 250000. Si vous voulez quand m\u00eame changer le baud rate, le nouveau taux devra \u00eatre configur\u00e9e dans le microcontr\u00f4leur (pendant make menuconfig ) et ce code mis \u00e0 jour devra \u00eatre compil\u00e9 et flash\u00e9 dans le microcontr\u00f4leur. Le fichier printer.cfg de Klipper devra \u00e9galement \u00eatre mis \u00e0 jour pour correspondre \u00e0 ce baud rate (voir le document de r\u00e9f\u00e9rence des configurations pour plus de d\u00e9tails). Par exemple : [mcu] baud: 250000 Le baud rate (taux bit/s) indiqu\u00e9 sur la page Web d'OctoPrint n'a aucun impact sur la vitesse de transmission du microcontr\u00f4leur interne de Klipper. R\u00e9glez toujours le taux de bit/s d'OctoPrint sur 250000 lorsque vous utilisez Klipper. Le baud rate utilis\u00e9 avec Klipper n'est pas li\u00e9e au baud rate du bootloader du microcontr\u00f4leur. Voir le document sur les bootloaders pour plus d'informations sur les bootloaders. Puis-je faire fonctionner Klipper sur autre chose qu'un Raspberry Pi 3 ? \u00b6 Le mat\u00e9riel recommand\u00e9 est un Raspberry Pi 2, Raspberry Pi 3 ou Raspberry Pi 4. Klipper fonctionne sur un Raspberry Pi 1 et sur le Raspberry Pi Zero, mais ces cartes n'ont pas assez de puissance de traitement pour faire fonctionner OctoPrint correctement. Il est fr\u00e9quent que l'impression se fasse par \u00e0-coup avec ces machines plus lentes lorsqu'on imprime directement depuis OctoPrint. (L'imprimante peut chercher \u00e0 imprimer plus rapidement que la vitesse \u00e0 laquelle OctoPrint peut envoyer les commandes de mouvement.) Si vous souhaitez quand m\u00eame utiliser une de ces cartes plus lentes, pensez \u00e0 utiliser la fonctionnalit\u00e9 \"virtual_sdcard\" lors de l'impression (voir le document de r\u00e9f\u00e9rence des configurations pour plus de d\u00e9tails). Pour l'ex\u00e9cution sur le Beaglebone, voir les instructions d'installation sp\u00e9cifiques au Beaglebone . Klipper a \u00e9t\u00e9 ex\u00e9cut\u00e9 sur d'autres machines. Le logiciel h\u00f4te de Klipper ne n\u00e9cessite que l'ex\u00e9cution de Python sur un ordinateur Linux (ou similaire). Cependant, si vous souhaitez l'ex\u00e9cuter sur une autre machine, vous aurez besoin de connaissances d'administrateur Linux pour installer les pr\u00e9requis du syst\u00e8me pour cette machine particuli\u00e8re. Consultez le script install-octopi.sh pour plus d'informations sur les \u00e9tapes n\u00e9cessaires \u00e0 l'administration de Linux. Si vous souhaitez ex\u00e9cuter le logiciel h\u00f4te Klipper sur une puce bas de gamme, sachez qu'il faut au minimum une machine dot\u00e9e d'un mat\u00e9riel \u00e0 \"double pr\u00e9cision en virgule flottante\". Si vous souhaitez ex\u00e9cuter le logiciel h\u00f4te Klipper sur un ordinateur de bureau ou un serveur polyvalent partag\u00e9, notez que Klipper a des exigences en mati\u00e8re de programmation en temps r\u00e9el. Si, au cours d'une impression, l'ordinateur h\u00f4te ex\u00e9cute \u00e9galement une t\u00e2che informatique intensive (comme la d\u00e9fragmentation d'un disque dur, un rendu 3D, une forte utilisation du fichier d'\u00e9change, etc.), Klipper pourrait signaler des erreurs d'impression. Note : Si vous n'utilisez pas une image OctoPi, sachez que de nombreuses distributions Linux activent un paquet \"ModemManager\" (ou similaire) pouvant perturber la communication s\u00e9rie. (Ce qui peut amener Klipper \u00e0 rapporter des erreurs apparemment al\u00e9atoires \"Lost communication with MCU\"). Si vous installez Klipper sur une de ces distributions, vous devrez peut-\u00eatre d\u00e9sactiver ce paquet. Puis-je ex\u00e9cuter plusieurs instances de Klipper sur la m\u00eame machine h\u00f4te ? \u00b6 Il est possible d'ex\u00e9cuter plusieurs instances du logiciel h\u00f4te Klipper, mais cela n\u00e9cessite des connaissances en administration Linux. Les scripts d'installation de Klipper entra\u00eenent finalement l'ex\u00e9cution de la commande Unix suivante : ~/klippy-env/bin/python ~/klipper/klippy/klippy.py ~/printer.cfg -l /tmp/klippy.log On peut ex\u00e9cuter plusieurs instances de la commande ci-dessus \u00e0 condition que chaque instance ait son propre fichier de configuration d'imprimante, son propre fichier journal et son propre pseudo-tty. Par exemple : ~/klippy-env/bin/python ~/klipper/klippy/klippy.py ~/printer2.cfg -l /tmp/klippy2.log -I /tmp/printer2 Si vous choisissez de le faire, vous devrez impl\u00e9menter les scripts de d\u00e9marrage, d'arr\u00eat et d'installation n\u00e9cessaires (le cas \u00e9ch\u00e9ant). Le script install-octopi.sh et le script klipper-start.sh peuvent \u00eatre utiles comme exemples. Suis-je oblig\u00e9 d'utiliser Octoprint ? \u00b6 Le logiciel Klipper n'est pas d\u00e9pendant d'OctoPrint. Il est possible d'utiliser un autre logiciel pour envoyer des commandes \u00e0 Klipper, mais cela n\u00e9cessite des connaissances en administration Linux. Klipper cr\u00e9e un \"port s\u00e9rie virtuel\" via le fichier \"/tmp/printer\" qui \u00e9mule une interface s\u00e9rie classique d'imprimante 3d via ce fichier. En g\u00e9n\u00e9ral, les logiciels alternatifs peuvent fonctionner avec Klipper tant qu'ils peuvent \u00eatre configur\u00e9s pour utiliser \"/tmp/printer\" pour le port s\u00e9rie de l'imprimante. Pourquoi ne puis-je pas lancer un d\u00e9placement avant de prendre l'origine ? \u00b6 Le code fait cela pour r\u00e9duire le risque de d\u00e9placer accidentellement la t\u00eate dans le lit ou dans un mur. Une fois que la prise d'origine est effectu\u00e9e, le logiciel v\u00e9rifie que chaque mouvement se situe dans les limites de position_min/max d\u00e9finies dans le fichier de configuration. Si les moteurs sont d\u00e9sactiv\u00e9s (via une commande M84 ou M18), les moteurs devront reprendre l'origine avant tout mouvement. Si vous souhaitez d\u00e9placer la t\u00eate apr\u00e8s avoir annul\u00e9 une impression via OctoPrint, pensez \u00e0 modifier la s\u00e9quence d'annulation d'OctoPrint pour qu'elle le fasse pour vous. Depuis un navigateur web, elle est configur\u00e9e dans OctoPrint sous : Param\u00e8tres->Scripts GCODE Si vous souhaitez d\u00e9placer la t\u00eate apr\u00e8s la fin d'une impression, pensez \u00e0 ajouter le mouvement souhait\u00e9 \u00e0 la section \"G-Code personnalis\u00e9\" de votre slicer. Si l'imprimante n\u00e9cessite un mouvement suppl\u00e9mentaire dans le cadre du processus de mise \u00e0 l'origine (ou si elle n'a pas de processus de mise \u00e0 l'origine), envisagez d'utiliser une section safe_z_home ou homing_override dans le fichier de configuration. Si vous devez d\u00e9placer un moteur \u00e0 des fins de diagnostic ou de d\u00e9bogage, pensez \u00e0 ajouter une section force_move dans le fichier de configuration. Voir r\u00e9f\u00e9rence de configuration pour plus de d\u00e9tails sur ces options. Pourquoi le param\u00e8tre position_endstop de l'axe Z est-il d\u00e9fini \u00e0 0.5 dans les configurations par d\u00e9faut ? \u00b6 Pour les imprimantes de style cart\u00e9sien, la position Z_endstop indique la distance entre la buse et le lit au moment du d\u00e9clenchement de la fin de course. Si possible, il est recommand\u00e9 d'utiliser une but\u00e9e de fin de course Z-max et de s'\u00e9loigner du lit (car cela r\u00e9duit le risque de collision avec le lit). Cependant, si l'on doit se rapprocher du lit, il est recommand\u00e9 de positionner la but\u00e9e de mani\u00e8re \u00e0 ce qu'elle se d\u00e9clenche lorsque la buse est encore \u00e0 une petite distance du lit. De cette fa\u00e7on, lorsque l'axe se dirige vers le lit, il s'arr\u00eate avant que la buse ne touche le lit. Voir le document niveau du lit pour plus d'informations. J'ai converti ma configuration depuis Marlin et les axes X/Y fonctionnent bien, mais j'obtiens un bruit strident lors de l'orientation de l'axe Z \u00b6 R\u00e9ponse courte : Tout d'abord, assurez-vous d'avoir v\u00e9rifi\u00e9 la configuration du moteur comme d\u00e9crit dans le document de v\u00e9rification de la configuration . Si le probl\u00e8me persiste, essayez de r\u00e9duire le param\u00e8tre max_z_velocity dans la configuration de l'imprimante. R\u00e9ponse longue : En pratique, Marlin ne peut se d\u00e9placer qu'\u00e0 une vitesse d'environ 10000 pas par seconde. Si on lui demande de se d\u00e9placer \u00e0 une vitesse n\u00e9cessitant un taux de pas plus \u00e9lev\u00e9, Marlin se contentera g\u00e9n\u00e9ralement de faire des pas aussi rapides qu'il le peut. Klipper est capable d'atteindre des taux de pas beaucoup plus \u00e9lev\u00e9s, mais le moteur pas \u00e0 pas peut ne pas avoir de couple suffisant pour se d\u00e9placer \u00e0 une vitesse plus \u00e9lev\u00e9e. Ainsi, pour un axe Z avec un rapport d'engrenage \u00e9lev\u00e9 ou un r\u00e9glage de micropas \u00e9lev\u00e9, la vitesse max_z_obtenue peut \u00eatre inf\u00e9rieure \u00e0 ce qui est configur\u00e9 dans Marlin. Mes pilotes de moteur TMC s'arr\u00eatent en plein milieu d'une impression \u00b6 Si vous utilisez le pilote TMC2208 (ou TMC2224) en \"mode autonome\", assurez-vous d'utiliser la derni\u00e8re version de Klipper . Une solution de contournement pour un probl\u00e8me avec les pilotes TMC2208 \"stealthchop\" a \u00e9t\u00e9 ajout\u00e9e \u00e0 Klipper \u00e0 la mi-mars 2020. J'ai des erreurs al\u00e9atoires \"Lost communication with MCU\" (communication perdue avec le microcontr\u00f4leur) \u00b6 Ce probl\u00e8me est g\u00e9n\u00e9ralement caus\u00e9 par des erreurs mat\u00e9rielles sur la connexion USB entre la machine h\u00f4te et le microcontr\u00f4leur. Les choses \u00e0 rechercher : Utilisez un c\u00e2ble USB de qualit\u00e9 entre la machine h\u00f4te et le microcontr\u00f4leur. Assurez-vous que les fiches sont bien fix\u00e9es. Si vous utilisez un Raspberry Pi, utilisez une alimentation de bonne qualit\u00e9 pour le Raspberry Pi et utilisez un c\u00e2ble USB de bonne qualit\u00e9 pour connecter cette alimentation au Pi. Si OctoPrint vous avertit que vous \u00eates sous tension, cela est li\u00e9 \u00e0 l'alimentation \u00e9lectrique et doit \u00eatre r\u00e9par\u00e9. Assurez-vous que l'alimentation \u00e9lectrique de l'imprimante n'est pas surcharg\u00e9e. (Les fluctuations d'alimentation de la puce USB du microcontr\u00f4leur peuvent entra\u00eener une r\u00e9initialisation de cette puce.) V\u00e9rifiez que les fils de l'imprimante (pastille, \u00e9l\u00e9ment chauffant et autres) sont bien sertis et pas effiloch\u00e9s. (Le mouvement de l'imprimante peut exercer une contrainte sur un c\u00e2blage d\u00e9fectueux entra\u00eenant une perte de contact, un court-circuit bref ou la production d'un bruit excessif.) Des signalements ont fait \u00e9tat d'un bruit USB \u00e9lev\u00e9 lorsque l'alimentation de l'imprimante et l'alimentation 5V de l'h\u00f4te sont m\u00e9lang\u00e9es. (Si vous constatez que le microcontr\u00f4leur s'allume lorsque l'alimentation de l'imprimante est sous tension ou que le c\u00e2ble USB est branch\u00e9, cela indique que les alimentations 5V sont m\u00e9lang\u00e9es). Il peut \u00eatre utile de configurer le micro-contr\u00f4leur pour qu'il utilise l'alimentation d'une seule source. (Alternativement, si la carte du micro-contr\u00f4leur ne peut pas configurer sa source d'alimentation, on peut modifier un c\u00e2ble USB pour qu'il ne transporte pas de tension de 5V entre l'h\u00f4te et le micro-contr\u00f4leur.) Mon Raspberry Pi red\u00e9marre pendant les impressions \u00b6 Cela est tr\u00e8s probablement d\u00fb \u00e0 des fluctuations de tension. Suivez les m\u00eames \u00e9tapes de d\u00e9pannage que pour une erreur \u00ab Communication perdue avec le MCU \u00bb . Lorsque j'ai d\u00e9fini restart_method=command , mon appareil AVR se bloque lors d'un red\u00e9marrage \u00b6 Certaines anciennes versions du bootloader AVR ont un bogue connu dans la gestion des \u00e9v\u00e9nements de chien de garde. Cela se manifeste typiquement lorsque le param\u00e8tre restart_method est d\u00e9fini sur \"command\" dans le fichier printer.cfg. Lorsque le bogue se produit, le dispositif AVR ne r\u00e9pond pas jusqu'\u00e0 ce que l'alimentation de la carte soit coup\u00e9e puis remise (les DEL d'alimentation ou d'\u00e9tat peuvent \u00e9galement clignoter de mani\u00e8re r\u00e9p\u00e9t\u00e9e jusqu'\u00e0 ce que l'alimentation soit retir\u00e9e). La solution est d'utiliser un restart_method autre que \"command\" ou de flasher un bootloader r\u00e9cent sur le dispositif AVR. Le flashage d'un nouveau bootloader est une \u00e9tape particuli\u00e8re qui n\u00e9cessite g\u00e9n\u00e9ralement un programmateur externe - voir Bootloaders pour plus de d\u00e9tails. Est-ce que les \u00e9l\u00e9ments chauffants restent allum\u00e9s si le Raspberry Pi plante ? \u00b6 Le logiciel a \u00e9t\u00e9 con\u00e7u pour \u00e9viter cela. Une fois que l'h\u00f4te a activ\u00e9 un \u00e9l\u00e9ment chauffant, le logiciel h\u00f4te doit confirmer cette activation toutes les 5 secondes. Si le microcontr\u00f4leur ne re\u00e7oit pas de confirmation toutes les 5 secondes, il passe dans un status \"arr\u00eat\u00e9\" con\u00e7u pour \u00e9teindre tous les \u00e9l\u00e9ments chauffants et les moteurs pas \u00e0 pas. Voir la commande \"config_digital_out\" dans le documentation des commandes MCU pour plus de d\u00e9tails. En outre, le logiciel du microcontr\u00f4leur est configur\u00e9 avec une plage de temp\u00e9rature minimale et maximale pour chaque \u00e9l\u00e9ment chauffant au d\u00e9marrage (voir les param\u00e8tres min_temp et max_temp dans le document de r\u00e9f\u00e9rences des configurations pour plus de d\u00e9tails). Si le microcontr\u00f4leur d\u00e9tecte que la temp\u00e9rature est en dehors de cette plage, il passe \u00e9galement au status \"arr\u00eat\u00e9\". S\u00e9par\u00e9ment, le logiciel h\u00f4te impl\u00e9mente \u00e9galement un code pour v\u00e9rifier que les \u00e9l\u00e9ments chauffants et les capteurs de temp\u00e9rature fonctionnent correctement. Voir le document de r\u00e9f\u00e9rence des configurations pour plus de d\u00e9tails. Comment puis-je convertir les noms de broches de Marlin \u00e0 Klipper ? \u00b6 R\u00e9ponse courte : un mappage est disponible dans le fichier sample-aliases.cfg . Utilisez ce fichier comme guide pour trouver les noms des broches du microcontr\u00f4leur. (Il est \u00e9galement possible de copier la section de configuration board_pins correspondante dans votre fichier de configuration et d'utiliser les alias dans votre configuration, mais il est pr\u00e9f\u00e9rable de traduire et d'utiliser les noms r\u00e9els des broches du microcontr\u00f4leur). Notez que le fichier sample-aliases.cfg utilise des noms de broches qui commencent par le pr\u00e9fixe \"ar\" au lieu de \"D\" (par exemple, la broche Arduino D23 est l'alias Klipper ar23 ) et le pr\u00e9fixe \"analog\" au lieu de \"A\" (par exemple, la broche Arduino A14 est l'alias Klipper analog14 ). R\u00e9ponse longue : Klipper utilise les noms de broches standard d\u00e9finis par le microcontr\u00f4leur. Sur les puces Atmega, ces broches mat\u00e9rielles ont des noms tels que PA4 , PC7 , ou PD2 . Il y a longtemps, le projet Arduino a d\u00e9cid\u00e9 d'\u00e9viter d'utiliser les noms standards du mat\u00e9riel en faveur de leurs propres noms de broches bas\u00e9s sur des nombres incr\u00e9ment\u00e9s - ces noms Arduino ressemblent g\u00e9n\u00e9ralement \u00e0 D23 ou A14 . Il s'agit d'un choix malheureux qui peut pr\u00eater \u00e0 confusion. En particulier parce que les num\u00e9ros de broches Arduino ne correspondent pas syst\u00e9matiquement aux m\u00eames noms mat\u00e9riels. Par exemple, D21 correspond \u00e0 PD0 sur certaines cartes Arduino et \u00e0 PC7 sur d'autres. Pour \u00e9viter cette confusion, le code source de Klipper utilise les noms de broches standard d\u00e9finis par le microcontr\u00f4leur. Dois-je connecter mon appareil \u00e0 un type sp\u00e9cifique de broche de microcontr\u00f4leur ? \u00b6 Cela d\u00e9pend du type d'appareil et du type de broche : Broches ADC (ou broches analogiques) : pour les thermistances et autres capteurs \"analogiques\", l'\u00e9l\u00e9ment doit \u00eatre c\u00e2bl\u00e9 \u00e0 une broche \"analogique\" ou \"ADC\" du microcontr\u00f4leur. Si vous configurez Klipper pour utiliser une broche qui n'est pas capable de fonctionner en analogique, Klipper signalera une erreur \"Not a valid ADC pin\". Broches PWM (ou broches de timer) : Klipper n'utilise pas de PWM mat\u00e9riel par d\u00e9faut pour aucun \u00e9l\u00e9ment. Donc on peut c\u00e2bler des \u00e9l\u00e9ments chauffants, des ventilateurs et des dispositifs similaires \u00e0 n'importe quelle broche d'E/S d'usage g\u00e9n\u00e9ral. Cependant, les ventilateurs et les \u00e9l\u00e9ments param\u00e9tr\u00e9s en output_pin peuvent \u00eatre \u00e9ventuellement configur\u00e9s pour utiliser hardware_pwm : True , auquel cas le micro-contr\u00f4leur doit supporter le PWM mat\u00e9riel sur la broche (sinon, Klipper signalera une erreur \"Not a valid PWM pin\"). Broches IRQ (ou broches d'interruption) : Klipper n'utilise pas d'interruptions mat\u00e9rielles sur les broches d'E/S, il n'est donc jamais n\u00e9cessaire de connecter un p\u00e9riph\u00e9rique \u00e0 l'une de ces broches du microcontr\u00f4leur. Broches SPI : Lors de l'utilisation du SPI mat\u00e9riel, il est n\u00e9cessaire de connecter l\u2019\u00e9l\u00e9ment aux broches SPI du micro-contr\u00f4leur. Toutefois, la plupart des \u00e9l\u00e9ments peuvent \u00eatre configur\u00e9s pour utiliser le \"SPI logiciel\", auquel cas n'importe quelle broche d'E/S d'usage g\u00e9n\u00e9ral peut \u00eatre utilis\u00e9e. Broches I2C : lors de l'utilisation d'I2C, il est n\u00e9cessaire de c\u00e2bler les broches aux broches compatibles I2C du microcontr\u00f4leur. D\u2019autres \u00e9l\u00e9ments peuvent \u00eatre c\u00e2bl\u00e9s \u00e0 n\u2019importe quelle broche d\u2019E/S \u00e0 usage g\u00e9n\u00e9ral. Par exemple, les steppers, les \u00e9l\u00e9ments chauffants, les ventilateurs, les sondes Z, les servos, les LED, les \u00e9crans LCD hd44780 /st7920 courants, le c\u00e2ble de communication UART des pilotes Trinamic peut \u00eatre raccord\u00e9 \u00e0 n\u2019importe quelle broche d'E/S. Comment annuler une commande M109/M190 \u00ab attendre la temp\u00e9rature \u00bb ? \u00b6 Allez dans l'onglet terminal d'OctoPrint et envoyez une commande M112 dans la console. La commande M112 fera entrer Klipper dans un \u00e9tat \"d'arr\u00eat\" et d\u00e9connectera OctoPrint de Klipper. Dans le bloc de connexion d'OctoPrint, cliquez sur \"Connecter\" pour que OctoPrint se reconnecte. Revenez \u00e0 l'onglet du terminal et lancez une commande FIRMWARE_RESTART pour effacer le status en erreur de Klipper. Apr\u00e8s avoir effectu\u00e9 cette s\u00e9quence, la demande de chauffage pr\u00e9c\u00e9dente sera annul\u00e9e et une nouvelle impression pourra \u00eatre lanc\u00e9e. Comment savoir si l'imprimante a perdu des pas ? \u00b6 D'une certaine mani\u00e8re, oui. Effectuez la prise d'origine (homing), lancez la commande GET_POSITION , d\u00e9marrez votre impression, refaite la prise d'origine et lancez \u00e0 nouveau la commande GET_POSITION . Comparez ensuite les valeurs de la ligne mcu : . Cela peut \u00eatre utile pour r\u00e9gler des param\u00e8tres tels que les courants, les acc\u00e9l\u00e9rations et les vitesses des moteurs pas \u00e0 pas sans avoir besoin d'imprimer quelque chose et de gaspiller du filament : il suffit d'ex\u00e9cuter quelques mouvements \u00e0 grande vitesse entre des commandes GET_POSITION . Notez que les interrupteurs de fin de course eux-m\u00eames ont tendance \u00e0 se d\u00e9clencher \u00e0 des positions l\u00e9g\u00e8rement diff\u00e9rentes, de sorte qu'une diff\u00e9rence de quelques micro-pas est probablement caus\u00e9 par l'impr\u00e9cision de la fin de course. Un moteur pas \u00e0 pas ne peut perdre des pas que par incr\u00e9ments de 4 pas complets. (Ainsi, si l'on utilise 16 micropas, un pas r\u00e9ellement perdu par le moteur se traduirait par une diff\u00e9rence multiple de 64 micropas avec le compteur de pas \"mcu :\") Pourquoi Klipper signale-t-il des erreurs ? J\u2019ai rat\u00e9 mon impression ! \u00b6 R\u00e9ponse courte : Nous voulons savoir si nos imprimantes rencontre un probl\u00e8me afin qu'il puisse \u00eatre r\u00e9solu et que nous puissions obtenir des impressions de grande qualit\u00e9. Nous ne voulons surtout pas que nos imprimantes produisent sans le signaler, des impressions de mauvaise qualit\u00e9. R\u00e9ponse longue : Klipper a \u00e9t\u00e9 con\u00e7u pour contourner automatiquement de nombreux probl\u00e8mes passagers. Par exemple, il d\u00e9tecte automatiquement les erreurs de communication et retransmet les donn\u00e9es ; il planifie les actions \u00e0 l'avance et met en m\u00e9moire tampon les commandes \u00e0 plusieurs niveaux pour permettre une synchronisation pr\u00e9cise, m\u00eame en cas d'interf\u00e9rences intermittentes. Toutefois, si le logiciel d\u00e9tecte une erreur dont il ne peut corriger, s'il re\u00e7oit l'ordre d'effectuer une action non valide ou s'il constate qu'il est d\u00e9sesp\u00e9r\u00e9ment incapable d'ex\u00e9cuter la t\u00e2che qui lui est demand\u00e9e, Klipper signalera une erreur. Dans ces situations, le risque est grand de produire une impression de mauvaise qualit\u00e9 (ou pire). Nous esp\u00e9rons que le fait d'alerter l'utilisateur lui permettra de r\u00e9soudre le probl\u00e8me sous-jacent et d'am\u00e9liorer la qualit\u00e9 globale de ses impressions. Il y a quelques questions connexes : Pourquoi Klipper ne met-il pas plut\u00f4t l'impression en pause ? Ne signale-t-il pas plut\u00f4t un avertissement ? Ne v\u00e9rifie-t-il pas les erreurs avant l'impression ? N'ignore-t-il pas les erreurs dans les commandes saisies par l'utilisateur ? etc. Actuellement, Klipper lit les commandes en utilisant le protocole G-Code, et malheureusement le protocole de commande G-Code n'est pas assez flexible pour rendre ces alternatives praticables aujourd'hui. Il y a un int\u00e9r\u00eat certain \u00e0 am\u00e9liorer l'exp\u00e9rience utilisateur pour la gestion de ces \u00e9v\u00e8nements anormaux mais cela n\u00e9cessite un travail notable sur l'infrastructure (incluant de d\u00e9tourner le G-Code). Comment mettre \u00e0 jour vers la derni\u00e8re version du logiciel ? \u00b6 La premi\u00e8re \u00e9tape de la mise \u00e0 jour du logiciel consiste \u00e0 consulter le document le plus r\u00e9cent des changements de configuration . Il arrive que des modifications soient apport\u00e9es au logiciel et que les utilisateurs doivent mettre \u00e0 jour leurs param\u00e8tres dans le cadre d'une mise \u00e0 niveau logicielle. Il est conseill\u00e9 de consulter ce document avant de proc\u00e9der \u00e0 la mise \u00e0 niveau. Lorsque vous \u00eates pr\u00eat \u00e0 mettre \u00e0 jour, la m\u00e9thode g\u00e9n\u00e9rale consiste \u00e0 se connecter au Raspberry Pi et \u00e0 ex\u00e9cuter : cd ~/klipper git pull ~/klipper/scripts/install-octopi.sh On peut ensuite recompiler et flasher le code du microcontr\u00f4leur. Par exemple : make menuconfig make clean make sudo service klipper stop make flash FLASH_DEVICE=/dev/ttyACM0 sudo service klipper start Cependant, il arrive parfois que seul le logiciel h\u00f4te change. Dans ce cas, on peut mettre \u00e0 jour et red\u00e9marrer uniquement le logiciel h\u00f4te avec : cd ~/klipper git pull sudo service klipper restart Si, apr\u00e8s avoir utilis\u00e9 ce raccourci, le logiciel vous avertit qu'il faut reflasher le microcontr\u00f4leur ou qu'une autre erreur inhabituelle se produit, suivez les \u00e9tapes compl\u00e8tes de mise \u00e0 jour d\u00e9crites ci-dessus. Si des erreurs persistent, v\u00e9rifiez le document modifications de configuration , car vous devrez peut-\u00eatre modifier la configuration de l\u2019imprimante. Notez que les commandes G-Code RESTART et FIRMWARE_RESTART ne rechargent pas le logiciel - les commandes \"sudo service klipper restart\" et \"make flash\" ci-dessus sont n\u00e9cessaires pour que les modifications du logiciel prennent effet. Comment d\u00e9sinstaller Klipper ? \u00b6 Pour ce qui est du firmware, il n'y a rien de sp\u00e9cial \u00e0 faire. Suivez simplement les instructions de flashage du nouveau firmware. Du c\u00f4t\u00e9 Raspberry Pi, un script de d\u00e9sinstallation est disponible dans scripts/klipper-uninstall.sh . Par exemple : sudo ~/klipper/scripts/klipper-uninstall.sh rm -rf ~/klippy-env ~/klipper","title":"Foire Aux Questions"},{"location":"FAQ.html#foire-aux-questions","text":"","title":"Foire Aux Questions"},{"location":"FAQ.html#comment-puis-je-faire-un-don-au-projet","text":"Merci de votre soutien. Voir la page Sponsors pour plus d'informations.","title":"Comment puis-je faire un don au projet ?"},{"location":"FAQ.html#comment-calculer-le-parametre-de-configuration-rotation_distance","text":"Voir le document sur la distance de rotation .","title":"Comment calculer le param\u00e8tre de configuration rotation_distance ?"},{"location":"FAQ.html#ou-est-mon-port-serie","text":"De mani\u00e8re g\u00e9n\u00e9rale, on ex\u00e9cute la commande ls /dev/serial/by-id/* \u00e0 partir d'un terminal ssh sur la machine h\u00f4te pour trouver un port s\u00e9rie USB. Cette commande produira s\u00fbrement un r\u00e9sultat similaire \u00e0 celui-ci : /dev/serial/by-id/usb-1a86_USB2.0-Serial-if00-port0 Le nom retourn\u00e9 par la commande ci-dessus est constant, il est donc possible de l'utiliser dans le fichier de configuration et lors du flashage du microcontr\u00f4leur. Par exemple, une commande de flash peur ressembler \u00e0 : sudo service klipper stop make flash FLASH_DEVICE=/dev/serial/by-id/usb-1a86_USB2.0-Serial-if00-port0 sudo service klipper start et la configuration mise \u00e0 jour devrait ressembler \u00e0 : [mcu] serial: /dev/serial/by-id/usb-1a86_USB2.0-Serial-if00-port0 Veillez \u00e0 copier-coller le nom retourn\u00e9 par la commande \"ls\" que vous avez ex\u00e9cut\u00e9e ci-avant, car le nom sera diff\u00e9rent pour chaque imprimante. Si vous utilisez plusieurs microcontr\u00f4leurs et qu'ils n'ont pas d'identifiant unique (fr\u00e9quent avec les cartes utilisant une puce USB CH340), suivez les instructions ci-dessus en utilisant la commande ls /dev/serial/by-path/* \u00e0 la place.","title":"O\u00f9 est mon port s\u00e9rie ?"},{"location":"FAQ.html#lorsque-le-microcontroleur-redemarre-le-peripherique-passe-a-devttyusb1","text":"Suivez les instructions de la section \" O\u00f9 est mon port s\u00e9rie ? \" pour \u00e9viter que cela ne se produise.","title":"Lorsque le microcontr\u00f4leur red\u00e9marre, le p\u00e9riph\u00e9rique passe \u00e0 /dev/ttyUSB1"},{"location":"FAQ.html#la-commande-make-flash-ne-fonctionne-pas","text":"Le code tente de flasher le dispositif en utilisant la m\u00e9thode la plus courante pour chaque plateforme. Malheureusement, il y a beaucoup de variations dans les m\u00e9thodes de flashage, donc la commande \"make flash\" peut ne pas fonctionner avec toutes les cartes. Si vous rencontrez une erreur intermittente ou si votre configuration est standard, v\u00e9rifiez que Klipper est arr\u00eat\u00e9 pendant le flashage (sudo service klipper stop), assurez-vous qu'OctoPrint n'essaye pas de se connecter directement \u00e0 l'appareil (ouvrez l'onglet Connexion de la page web et cliquez sur D\u00e9connecter si le port s\u00e9rie de la carte est s\u00e9lectionn\u00e9), et assurez-vous que FLASH_DEVICE est correctement d\u00e9fini pour votre carte (voir la question ci-dessus ). Toutefois si \"make flash\" ne fonctionne pas pour votre carte, vous devrez flasher manuellement. V\u00e9rifiez s'il existe un fichier de configuration dans le r\u00e9pertoire config avec des instructions sp\u00e9cifiques pour flasher la carte. V\u00e9rifiez \u00e9galement la documentation du fabricant de la carte pour voir si elle d\u00e9crit comment la flasher. Enfin, il peut \u00eatre possible de flasher manuellement la carte en utilisant des outils tels que \"avrdude\" ou \"bossac\" - voir le document sur les booloaders pour plus d'informations.","title":"La commande \"make flash\" ne fonctionne pas"},{"location":"FAQ.html#comment-changer-la-vitesse-de-communicationbaud-rate-du-port-serie","text":"Le baud rate (taux bit/s) recommand\u00e9 pour Klipper est de 250000. Ce baud rate fonctionne bien sur toutes les cartes microcontr\u00f4leurs que Klipper prend en charge. Si vous avez trouv\u00e9 un guide en ligne recommandant un baud rate diff\u00e9rent, ignorez cette partie du guide et continuez avec la valeur par d\u00e9faut de 250000. Si vous voulez quand m\u00eame changer le baud rate, le nouveau taux devra \u00eatre configur\u00e9e dans le microcontr\u00f4leur (pendant make menuconfig ) et ce code mis \u00e0 jour devra \u00eatre compil\u00e9 et flash\u00e9 dans le microcontr\u00f4leur. Le fichier printer.cfg de Klipper devra \u00e9galement \u00eatre mis \u00e0 jour pour correspondre \u00e0 ce baud rate (voir le document de r\u00e9f\u00e9rence des configurations pour plus de d\u00e9tails). Par exemple : [mcu] baud: 250000 Le baud rate (taux bit/s) indiqu\u00e9 sur la page Web d'OctoPrint n'a aucun impact sur la vitesse de transmission du microcontr\u00f4leur interne de Klipper. R\u00e9glez toujours le taux de bit/s d'OctoPrint sur 250000 lorsque vous utilisez Klipper. Le baud rate utilis\u00e9 avec Klipper n'est pas li\u00e9e au baud rate du bootloader du microcontr\u00f4leur. Voir le document sur les bootloaders pour plus d'informations sur les bootloaders.","title":"Comment changer la vitesse de communication(baud rate) du port s\u00e9rie ?"},{"location":"FAQ.html#puis-je-faire-fonctionner-klipper-sur-autre-chose-quun-raspberry-pi-3","text":"Le mat\u00e9riel recommand\u00e9 est un Raspberry Pi 2, Raspberry Pi 3 ou Raspberry Pi 4. Klipper fonctionne sur un Raspberry Pi 1 et sur le Raspberry Pi Zero, mais ces cartes n'ont pas assez de puissance de traitement pour faire fonctionner OctoPrint correctement. Il est fr\u00e9quent que l'impression se fasse par \u00e0-coup avec ces machines plus lentes lorsqu'on imprime directement depuis OctoPrint. (L'imprimante peut chercher \u00e0 imprimer plus rapidement que la vitesse \u00e0 laquelle OctoPrint peut envoyer les commandes de mouvement.) Si vous souhaitez quand m\u00eame utiliser une de ces cartes plus lentes, pensez \u00e0 utiliser la fonctionnalit\u00e9 \"virtual_sdcard\" lors de l'impression (voir le document de r\u00e9f\u00e9rence des configurations pour plus de d\u00e9tails). Pour l'ex\u00e9cution sur le Beaglebone, voir les instructions d'installation sp\u00e9cifiques au Beaglebone . Klipper a \u00e9t\u00e9 ex\u00e9cut\u00e9 sur d'autres machines. Le logiciel h\u00f4te de Klipper ne n\u00e9cessite que l'ex\u00e9cution de Python sur un ordinateur Linux (ou similaire). Cependant, si vous souhaitez l'ex\u00e9cuter sur une autre machine, vous aurez besoin de connaissances d'administrateur Linux pour installer les pr\u00e9requis du syst\u00e8me pour cette machine particuli\u00e8re. Consultez le script install-octopi.sh pour plus d'informations sur les \u00e9tapes n\u00e9cessaires \u00e0 l'administration de Linux. Si vous souhaitez ex\u00e9cuter le logiciel h\u00f4te Klipper sur une puce bas de gamme, sachez qu'il faut au minimum une machine dot\u00e9e d'un mat\u00e9riel \u00e0 \"double pr\u00e9cision en virgule flottante\". Si vous souhaitez ex\u00e9cuter le logiciel h\u00f4te Klipper sur un ordinateur de bureau ou un serveur polyvalent partag\u00e9, notez que Klipper a des exigences en mati\u00e8re de programmation en temps r\u00e9el. Si, au cours d'une impression, l'ordinateur h\u00f4te ex\u00e9cute \u00e9galement une t\u00e2che informatique intensive (comme la d\u00e9fragmentation d'un disque dur, un rendu 3D, une forte utilisation du fichier d'\u00e9change, etc.), Klipper pourrait signaler des erreurs d'impression. Note : Si vous n'utilisez pas une image OctoPi, sachez que de nombreuses distributions Linux activent un paquet \"ModemManager\" (ou similaire) pouvant perturber la communication s\u00e9rie. (Ce qui peut amener Klipper \u00e0 rapporter des erreurs apparemment al\u00e9atoires \"Lost communication with MCU\"). Si vous installez Klipper sur une de ces distributions, vous devrez peut-\u00eatre d\u00e9sactiver ce paquet.","title":"Puis-je faire fonctionner Klipper sur autre chose qu'un Raspberry Pi 3 ?"},{"location":"FAQ.html#puis-je-executer-plusieurs-instances-de-klipper-sur-la-meme-machine-hote","text":"Il est possible d'ex\u00e9cuter plusieurs instances du logiciel h\u00f4te Klipper, mais cela n\u00e9cessite des connaissances en administration Linux. Les scripts d'installation de Klipper entra\u00eenent finalement l'ex\u00e9cution de la commande Unix suivante : ~/klippy-env/bin/python ~/klipper/klippy/klippy.py ~/printer.cfg -l /tmp/klippy.log On peut ex\u00e9cuter plusieurs instances de la commande ci-dessus \u00e0 condition que chaque instance ait son propre fichier de configuration d'imprimante, son propre fichier journal et son propre pseudo-tty. Par exemple : ~/klippy-env/bin/python ~/klipper/klippy/klippy.py ~/printer2.cfg -l /tmp/klippy2.log -I /tmp/printer2 Si vous choisissez de le faire, vous devrez impl\u00e9menter les scripts de d\u00e9marrage, d'arr\u00eat et d'installation n\u00e9cessaires (le cas \u00e9ch\u00e9ant). Le script install-octopi.sh et le script klipper-start.sh peuvent \u00eatre utiles comme exemples.","title":"Puis-je ex\u00e9cuter plusieurs instances de Klipper sur la m\u00eame machine h\u00f4te ?"},{"location":"FAQ.html#suis-je-oblige-dutiliser-octoprint","text":"Le logiciel Klipper n'est pas d\u00e9pendant d'OctoPrint. Il est possible d'utiliser un autre logiciel pour envoyer des commandes \u00e0 Klipper, mais cela n\u00e9cessite des connaissances en administration Linux. Klipper cr\u00e9e un \"port s\u00e9rie virtuel\" via le fichier \"/tmp/printer\" qui \u00e9mule une interface s\u00e9rie classique d'imprimante 3d via ce fichier. En g\u00e9n\u00e9ral, les logiciels alternatifs peuvent fonctionner avec Klipper tant qu'ils peuvent \u00eatre configur\u00e9s pour utiliser \"/tmp/printer\" pour le port s\u00e9rie de l'imprimante.","title":"Suis-je oblig\u00e9 d'utiliser Octoprint ?"},{"location":"FAQ.html#pourquoi-ne-puis-je-pas-lancer-un-deplacement-avant-de-prendre-lorigine","text":"Le code fait cela pour r\u00e9duire le risque de d\u00e9placer accidentellement la t\u00eate dans le lit ou dans un mur. Une fois que la prise d'origine est effectu\u00e9e, le logiciel v\u00e9rifie que chaque mouvement se situe dans les limites de position_min/max d\u00e9finies dans le fichier de configuration. Si les moteurs sont d\u00e9sactiv\u00e9s (via une commande M84 ou M18), les moteurs devront reprendre l'origine avant tout mouvement. Si vous souhaitez d\u00e9placer la t\u00eate apr\u00e8s avoir annul\u00e9 une impression via OctoPrint, pensez \u00e0 modifier la s\u00e9quence d'annulation d'OctoPrint pour qu'elle le fasse pour vous. Depuis un navigateur web, elle est configur\u00e9e dans OctoPrint sous : Param\u00e8tres->Scripts GCODE Si vous souhaitez d\u00e9placer la t\u00eate apr\u00e8s la fin d'une impression, pensez \u00e0 ajouter le mouvement souhait\u00e9 \u00e0 la section \"G-Code personnalis\u00e9\" de votre slicer. Si l'imprimante n\u00e9cessite un mouvement suppl\u00e9mentaire dans le cadre du processus de mise \u00e0 l'origine (ou si elle n'a pas de processus de mise \u00e0 l'origine), envisagez d'utiliser une section safe_z_home ou homing_override dans le fichier de configuration. Si vous devez d\u00e9placer un moteur \u00e0 des fins de diagnostic ou de d\u00e9bogage, pensez \u00e0 ajouter une section force_move dans le fichier de configuration. Voir r\u00e9f\u00e9rence de configuration pour plus de d\u00e9tails sur ces options.","title":"Pourquoi ne puis-je pas lancer un d\u00e9placement avant de prendre l'origine ?"},{"location":"FAQ.html#pourquoi-le-parametre-position_endstop-de-laxe-z-est-il-defini-a-05-dans-les-configurations-par-defaut","text":"Pour les imprimantes de style cart\u00e9sien, la position Z_endstop indique la distance entre la buse et le lit au moment du d\u00e9clenchement de la fin de course. Si possible, il est recommand\u00e9 d'utiliser une but\u00e9e de fin de course Z-max et de s'\u00e9loigner du lit (car cela r\u00e9duit le risque de collision avec le lit). Cependant, si l'on doit se rapprocher du lit, il est recommand\u00e9 de positionner la but\u00e9e de mani\u00e8re \u00e0 ce qu'elle se d\u00e9clenche lorsque la buse est encore \u00e0 une petite distance du lit. De cette fa\u00e7on, lorsque l'axe se dirige vers le lit, il s'arr\u00eate avant que la buse ne touche le lit. Voir le document niveau du lit pour plus d'informations.","title":"Pourquoi le param\u00e8tre position_endstop de l'axe Z est-il d\u00e9fini \u00e0 0.5 dans les configurations par d\u00e9faut ?"},{"location":"FAQ.html#jai-converti-ma-configuration-depuis-marlin-et-les-axes-xy-fonctionnent-bien-mais-jobtiens-un-bruit-strident-lors-de-lorientation-de-laxe-z","text":"R\u00e9ponse courte : Tout d'abord, assurez-vous d'avoir v\u00e9rifi\u00e9 la configuration du moteur comme d\u00e9crit dans le document de v\u00e9rification de la configuration . Si le probl\u00e8me persiste, essayez de r\u00e9duire le param\u00e8tre max_z_velocity dans la configuration de l'imprimante. R\u00e9ponse longue : En pratique, Marlin ne peut se d\u00e9placer qu'\u00e0 une vitesse d'environ 10000 pas par seconde. Si on lui demande de se d\u00e9placer \u00e0 une vitesse n\u00e9cessitant un taux de pas plus \u00e9lev\u00e9, Marlin se contentera g\u00e9n\u00e9ralement de faire des pas aussi rapides qu'il le peut. Klipper est capable d'atteindre des taux de pas beaucoup plus \u00e9lev\u00e9s, mais le moteur pas \u00e0 pas peut ne pas avoir de couple suffisant pour se d\u00e9placer \u00e0 une vitesse plus \u00e9lev\u00e9e. Ainsi, pour un axe Z avec un rapport d'engrenage \u00e9lev\u00e9 ou un r\u00e9glage de micropas \u00e9lev\u00e9, la vitesse max_z_obtenue peut \u00eatre inf\u00e9rieure \u00e0 ce qui est configur\u00e9 dans Marlin.","title":"J'ai converti ma configuration depuis Marlin et les axes X/Y fonctionnent bien, mais j'obtiens un bruit strident lors de l'orientation de l'axe Z"},{"location":"FAQ.html#mes-pilotes-de-moteur-tmc-sarretent-en-plein-milieu-dune-impression","text":"Si vous utilisez le pilote TMC2208 (ou TMC2224) en \"mode autonome\", assurez-vous d'utiliser la derni\u00e8re version de Klipper . Une solution de contournement pour un probl\u00e8me avec les pilotes TMC2208 \"stealthchop\" a \u00e9t\u00e9 ajout\u00e9e \u00e0 Klipper \u00e0 la mi-mars 2020.","title":"Mes pilotes de moteur TMC s'arr\u00eatent en plein milieu d'une impression"},{"location":"FAQ.html#jai-des-erreurs-aleatoires-lost-communication-with-mcu-communication-perdue-avec-le-microcontroleur","text":"Ce probl\u00e8me est g\u00e9n\u00e9ralement caus\u00e9 par des erreurs mat\u00e9rielles sur la connexion USB entre la machine h\u00f4te et le microcontr\u00f4leur. Les choses \u00e0 rechercher : Utilisez un c\u00e2ble USB de qualit\u00e9 entre la machine h\u00f4te et le microcontr\u00f4leur. Assurez-vous que les fiches sont bien fix\u00e9es. Si vous utilisez un Raspberry Pi, utilisez une alimentation de bonne qualit\u00e9 pour le Raspberry Pi et utilisez un c\u00e2ble USB de bonne qualit\u00e9 pour connecter cette alimentation au Pi. Si OctoPrint vous avertit que vous \u00eates sous tension, cela est li\u00e9 \u00e0 l'alimentation \u00e9lectrique et doit \u00eatre r\u00e9par\u00e9. Assurez-vous que l'alimentation \u00e9lectrique de l'imprimante n'est pas surcharg\u00e9e. (Les fluctuations d'alimentation de la puce USB du microcontr\u00f4leur peuvent entra\u00eener une r\u00e9initialisation de cette puce.) V\u00e9rifiez que les fils de l'imprimante (pastille, \u00e9l\u00e9ment chauffant et autres) sont bien sertis et pas effiloch\u00e9s. (Le mouvement de l'imprimante peut exercer une contrainte sur un c\u00e2blage d\u00e9fectueux entra\u00eenant une perte de contact, un court-circuit bref ou la production d'un bruit excessif.) Des signalements ont fait \u00e9tat d'un bruit USB \u00e9lev\u00e9 lorsque l'alimentation de l'imprimante et l'alimentation 5V de l'h\u00f4te sont m\u00e9lang\u00e9es. (Si vous constatez que le microcontr\u00f4leur s'allume lorsque l'alimentation de l'imprimante est sous tension ou que le c\u00e2ble USB est branch\u00e9, cela indique que les alimentations 5V sont m\u00e9lang\u00e9es). Il peut \u00eatre utile de configurer le micro-contr\u00f4leur pour qu'il utilise l'alimentation d'une seule source. (Alternativement, si la carte du micro-contr\u00f4leur ne peut pas configurer sa source d'alimentation, on peut modifier un c\u00e2ble USB pour qu'il ne transporte pas de tension de 5V entre l'h\u00f4te et le micro-contr\u00f4leur.)","title":"J'ai des erreurs al\u00e9atoires \"Lost communication with MCU\" (communication perdue avec le microcontr\u00f4leur)"},{"location":"FAQ.html#mon-raspberry-pi-redemarre-pendant-les-impressions","text":"Cela est tr\u00e8s probablement d\u00fb \u00e0 des fluctuations de tension. Suivez les m\u00eames \u00e9tapes de d\u00e9pannage que pour une erreur \u00ab Communication perdue avec le MCU \u00bb .","title":"Mon Raspberry Pi red\u00e9marre pendant les impressions"},{"location":"FAQ.html#lorsque-jai-defini-restart_methodcommand-mon-appareil-avr-se-bloque-lors-dun-redemarrage","text":"Certaines anciennes versions du bootloader AVR ont un bogue connu dans la gestion des \u00e9v\u00e9nements de chien de garde. Cela se manifeste typiquement lorsque le param\u00e8tre restart_method est d\u00e9fini sur \"command\" dans le fichier printer.cfg. Lorsque le bogue se produit, le dispositif AVR ne r\u00e9pond pas jusqu'\u00e0 ce que l'alimentation de la carte soit coup\u00e9e puis remise (les DEL d'alimentation ou d'\u00e9tat peuvent \u00e9galement clignoter de mani\u00e8re r\u00e9p\u00e9t\u00e9e jusqu'\u00e0 ce que l'alimentation soit retir\u00e9e). La solution est d'utiliser un restart_method autre que \"command\" ou de flasher un bootloader r\u00e9cent sur le dispositif AVR. Le flashage d'un nouveau bootloader est une \u00e9tape particuli\u00e8re qui n\u00e9cessite g\u00e9n\u00e9ralement un programmateur externe - voir Bootloaders pour plus de d\u00e9tails.","title":"Lorsque j'ai d\u00e9fini restart_method=command, mon appareil AVR se bloque lors d'un red\u00e9marrage"},{"location":"FAQ.html#est-ce-que-les-elements-chauffants-restent-allumes-si-le-raspberry-pi-plante","text":"Le logiciel a \u00e9t\u00e9 con\u00e7u pour \u00e9viter cela. Une fois que l'h\u00f4te a activ\u00e9 un \u00e9l\u00e9ment chauffant, le logiciel h\u00f4te doit confirmer cette activation toutes les 5 secondes. Si le microcontr\u00f4leur ne re\u00e7oit pas de confirmation toutes les 5 secondes, il passe dans un status \"arr\u00eat\u00e9\" con\u00e7u pour \u00e9teindre tous les \u00e9l\u00e9ments chauffants et les moteurs pas \u00e0 pas. Voir la commande \"config_digital_out\" dans le documentation des commandes MCU pour plus de d\u00e9tails. En outre, le logiciel du microcontr\u00f4leur est configur\u00e9 avec une plage de temp\u00e9rature minimale et maximale pour chaque \u00e9l\u00e9ment chauffant au d\u00e9marrage (voir les param\u00e8tres min_temp et max_temp dans le document de r\u00e9f\u00e9rences des configurations pour plus de d\u00e9tails). Si le microcontr\u00f4leur d\u00e9tecte que la temp\u00e9rature est en dehors de cette plage, il passe \u00e9galement au status \"arr\u00eat\u00e9\". S\u00e9par\u00e9ment, le logiciel h\u00f4te impl\u00e9mente \u00e9galement un code pour v\u00e9rifier que les \u00e9l\u00e9ments chauffants et les capteurs de temp\u00e9rature fonctionnent correctement. Voir le document de r\u00e9f\u00e9rence des configurations pour plus de d\u00e9tails.","title":"Est-ce que les \u00e9l\u00e9ments chauffants restent allum\u00e9s si le Raspberry Pi plante ?"},{"location":"FAQ.html#comment-puis-je-convertir-les-noms-de-broches-de-marlin-a-klipper","text":"R\u00e9ponse courte : un mappage est disponible dans le fichier sample-aliases.cfg . Utilisez ce fichier comme guide pour trouver les noms des broches du microcontr\u00f4leur. (Il est \u00e9galement possible de copier la section de configuration board_pins correspondante dans votre fichier de configuration et d'utiliser les alias dans votre configuration, mais il est pr\u00e9f\u00e9rable de traduire et d'utiliser les noms r\u00e9els des broches du microcontr\u00f4leur). Notez que le fichier sample-aliases.cfg utilise des noms de broches qui commencent par le pr\u00e9fixe \"ar\" au lieu de \"D\" (par exemple, la broche Arduino D23 est l'alias Klipper ar23 ) et le pr\u00e9fixe \"analog\" au lieu de \"A\" (par exemple, la broche Arduino A14 est l'alias Klipper analog14 ). R\u00e9ponse longue : Klipper utilise les noms de broches standard d\u00e9finis par le microcontr\u00f4leur. Sur les puces Atmega, ces broches mat\u00e9rielles ont des noms tels que PA4 , PC7 , ou PD2 . Il y a longtemps, le projet Arduino a d\u00e9cid\u00e9 d'\u00e9viter d'utiliser les noms standards du mat\u00e9riel en faveur de leurs propres noms de broches bas\u00e9s sur des nombres incr\u00e9ment\u00e9s - ces noms Arduino ressemblent g\u00e9n\u00e9ralement \u00e0 D23 ou A14 . Il s'agit d'un choix malheureux qui peut pr\u00eater \u00e0 confusion. En particulier parce que les num\u00e9ros de broches Arduino ne correspondent pas syst\u00e9matiquement aux m\u00eames noms mat\u00e9riels. Par exemple, D21 correspond \u00e0 PD0 sur certaines cartes Arduino et \u00e0 PC7 sur d'autres. Pour \u00e9viter cette confusion, le code source de Klipper utilise les noms de broches standard d\u00e9finis par le microcontr\u00f4leur.","title":"Comment puis-je convertir les noms de broches de Marlin \u00e0 Klipper ?"},{"location":"FAQ.html#dois-je-connecter-mon-appareil-a-un-type-specifique-de-broche-de-microcontroleur","text":"Cela d\u00e9pend du type d'appareil et du type de broche : Broches ADC (ou broches analogiques) : pour les thermistances et autres capteurs \"analogiques\", l'\u00e9l\u00e9ment doit \u00eatre c\u00e2bl\u00e9 \u00e0 une broche \"analogique\" ou \"ADC\" du microcontr\u00f4leur. Si vous configurez Klipper pour utiliser une broche qui n'est pas capable de fonctionner en analogique, Klipper signalera une erreur \"Not a valid ADC pin\". Broches PWM (ou broches de timer) : Klipper n'utilise pas de PWM mat\u00e9riel par d\u00e9faut pour aucun \u00e9l\u00e9ment. Donc on peut c\u00e2bler des \u00e9l\u00e9ments chauffants, des ventilateurs et des dispositifs similaires \u00e0 n'importe quelle broche d'E/S d'usage g\u00e9n\u00e9ral. Cependant, les ventilateurs et les \u00e9l\u00e9ments param\u00e9tr\u00e9s en output_pin peuvent \u00eatre \u00e9ventuellement configur\u00e9s pour utiliser hardware_pwm : True , auquel cas le micro-contr\u00f4leur doit supporter le PWM mat\u00e9riel sur la broche (sinon, Klipper signalera une erreur \"Not a valid PWM pin\"). Broches IRQ (ou broches d'interruption) : Klipper n'utilise pas d'interruptions mat\u00e9rielles sur les broches d'E/S, il n'est donc jamais n\u00e9cessaire de connecter un p\u00e9riph\u00e9rique \u00e0 l'une de ces broches du microcontr\u00f4leur. Broches SPI : Lors de l'utilisation du SPI mat\u00e9riel, il est n\u00e9cessaire de connecter l\u2019\u00e9l\u00e9ment aux broches SPI du micro-contr\u00f4leur. Toutefois, la plupart des \u00e9l\u00e9ments peuvent \u00eatre configur\u00e9s pour utiliser le \"SPI logiciel\", auquel cas n'importe quelle broche d'E/S d'usage g\u00e9n\u00e9ral peut \u00eatre utilis\u00e9e. Broches I2C : lors de l'utilisation d'I2C, il est n\u00e9cessaire de c\u00e2bler les broches aux broches compatibles I2C du microcontr\u00f4leur. D\u2019autres \u00e9l\u00e9ments peuvent \u00eatre c\u00e2bl\u00e9s \u00e0 n\u2019importe quelle broche d\u2019E/S \u00e0 usage g\u00e9n\u00e9ral. Par exemple, les steppers, les \u00e9l\u00e9ments chauffants, les ventilateurs, les sondes Z, les servos, les LED, les \u00e9crans LCD hd44780 /st7920 courants, le c\u00e2ble de communication UART des pilotes Trinamic peut \u00eatre raccord\u00e9 \u00e0 n\u2019importe quelle broche d'E/S.","title":"Dois-je connecter mon appareil \u00e0 un type sp\u00e9cifique de broche de microcontr\u00f4leur ?"},{"location":"FAQ.html#comment-annuler-une-commande-m109m190-attendre-la-temperature","text":"Allez dans l'onglet terminal d'OctoPrint et envoyez une commande M112 dans la console. La commande M112 fera entrer Klipper dans un \u00e9tat \"d'arr\u00eat\" et d\u00e9connectera OctoPrint de Klipper. Dans le bloc de connexion d'OctoPrint, cliquez sur \"Connecter\" pour que OctoPrint se reconnecte. Revenez \u00e0 l'onglet du terminal et lancez une commande FIRMWARE_RESTART pour effacer le status en erreur de Klipper. Apr\u00e8s avoir effectu\u00e9 cette s\u00e9quence, la demande de chauffage pr\u00e9c\u00e9dente sera annul\u00e9e et une nouvelle impression pourra \u00eatre lanc\u00e9e.","title":"Comment annuler une commande M109/M190 \u00ab attendre la temp\u00e9rature \u00bb ?"},{"location":"FAQ.html#comment-savoir-si-limprimante-a-perdu-des-pas","text":"D'une certaine mani\u00e8re, oui. Effectuez la prise d'origine (homing), lancez la commande GET_POSITION , d\u00e9marrez votre impression, refaite la prise d'origine et lancez \u00e0 nouveau la commande GET_POSITION . Comparez ensuite les valeurs de la ligne mcu : . Cela peut \u00eatre utile pour r\u00e9gler des param\u00e8tres tels que les courants, les acc\u00e9l\u00e9rations et les vitesses des moteurs pas \u00e0 pas sans avoir besoin d'imprimer quelque chose et de gaspiller du filament : il suffit d'ex\u00e9cuter quelques mouvements \u00e0 grande vitesse entre des commandes GET_POSITION . Notez que les interrupteurs de fin de course eux-m\u00eames ont tendance \u00e0 se d\u00e9clencher \u00e0 des positions l\u00e9g\u00e8rement diff\u00e9rentes, de sorte qu'une diff\u00e9rence de quelques micro-pas est probablement caus\u00e9 par l'impr\u00e9cision de la fin de course. Un moteur pas \u00e0 pas ne peut perdre des pas que par incr\u00e9ments de 4 pas complets. (Ainsi, si l'on utilise 16 micropas, un pas r\u00e9ellement perdu par le moteur se traduirait par une diff\u00e9rence multiple de 64 micropas avec le compteur de pas \"mcu :\")","title":"Comment savoir si l'imprimante a perdu des pas ?"},{"location":"FAQ.html#pourquoi-klipper-signale-t-il-des-erreurs-jai-rate-mon-impression","text":"R\u00e9ponse courte : Nous voulons savoir si nos imprimantes rencontre un probl\u00e8me afin qu'il puisse \u00eatre r\u00e9solu et que nous puissions obtenir des impressions de grande qualit\u00e9. Nous ne voulons surtout pas que nos imprimantes produisent sans le signaler, des impressions de mauvaise qualit\u00e9. R\u00e9ponse longue : Klipper a \u00e9t\u00e9 con\u00e7u pour contourner automatiquement de nombreux probl\u00e8mes passagers. Par exemple, il d\u00e9tecte automatiquement les erreurs de communication et retransmet les donn\u00e9es ; il planifie les actions \u00e0 l'avance et met en m\u00e9moire tampon les commandes \u00e0 plusieurs niveaux pour permettre une synchronisation pr\u00e9cise, m\u00eame en cas d'interf\u00e9rences intermittentes. Toutefois, si le logiciel d\u00e9tecte une erreur dont il ne peut corriger, s'il re\u00e7oit l'ordre d'effectuer une action non valide ou s'il constate qu'il est d\u00e9sesp\u00e9r\u00e9ment incapable d'ex\u00e9cuter la t\u00e2che qui lui est demand\u00e9e, Klipper signalera une erreur. Dans ces situations, le risque est grand de produire une impression de mauvaise qualit\u00e9 (ou pire). Nous esp\u00e9rons que le fait d'alerter l'utilisateur lui permettra de r\u00e9soudre le probl\u00e8me sous-jacent et d'am\u00e9liorer la qualit\u00e9 globale de ses impressions. Il y a quelques questions connexes : Pourquoi Klipper ne met-il pas plut\u00f4t l'impression en pause ? Ne signale-t-il pas plut\u00f4t un avertissement ? Ne v\u00e9rifie-t-il pas les erreurs avant l'impression ? N'ignore-t-il pas les erreurs dans les commandes saisies par l'utilisateur ? etc. Actuellement, Klipper lit les commandes en utilisant le protocole G-Code, et malheureusement le protocole de commande G-Code n'est pas assez flexible pour rendre ces alternatives praticables aujourd'hui. Il y a un int\u00e9r\u00eat certain \u00e0 am\u00e9liorer l'exp\u00e9rience utilisateur pour la gestion de ces \u00e9v\u00e8nements anormaux mais cela n\u00e9cessite un travail notable sur l'infrastructure (incluant de d\u00e9tourner le G-Code).","title":"Pourquoi Klipper signale-t-il des erreurs ? J\u2019ai rat\u00e9 mon impression !"},{"location":"FAQ.html#comment-mettre-a-jour-vers-la-derniere-version-du-logiciel","text":"La premi\u00e8re \u00e9tape de la mise \u00e0 jour du logiciel consiste \u00e0 consulter le document le plus r\u00e9cent des changements de configuration . Il arrive que des modifications soient apport\u00e9es au logiciel et que les utilisateurs doivent mettre \u00e0 jour leurs param\u00e8tres dans le cadre d'une mise \u00e0 niveau logicielle. Il est conseill\u00e9 de consulter ce document avant de proc\u00e9der \u00e0 la mise \u00e0 niveau. Lorsque vous \u00eates pr\u00eat \u00e0 mettre \u00e0 jour, la m\u00e9thode g\u00e9n\u00e9rale consiste \u00e0 se connecter au Raspberry Pi et \u00e0 ex\u00e9cuter : cd ~/klipper git pull ~/klipper/scripts/install-octopi.sh On peut ensuite recompiler et flasher le code du microcontr\u00f4leur. Par exemple : make menuconfig make clean make sudo service klipper stop make flash FLASH_DEVICE=/dev/ttyACM0 sudo service klipper start Cependant, il arrive parfois que seul le logiciel h\u00f4te change. Dans ce cas, on peut mettre \u00e0 jour et red\u00e9marrer uniquement le logiciel h\u00f4te avec : cd ~/klipper git pull sudo service klipper restart Si, apr\u00e8s avoir utilis\u00e9 ce raccourci, le logiciel vous avertit qu'il faut reflasher le microcontr\u00f4leur ou qu'une autre erreur inhabituelle se produit, suivez les \u00e9tapes compl\u00e8tes de mise \u00e0 jour d\u00e9crites ci-dessus. Si des erreurs persistent, v\u00e9rifiez le document modifications de configuration , car vous devrez peut-\u00eatre modifier la configuration de l\u2019imprimante. Notez que les commandes G-Code RESTART et FIRMWARE_RESTART ne rechargent pas le logiciel - les commandes \"sudo service klipper restart\" et \"make flash\" ci-dessus sont n\u00e9cessaires pour que les modifications du logiciel prennent effet.","title":"Comment mettre \u00e0 jour vers la derni\u00e8re version du logiciel ?"},{"location":"FAQ.html#comment-desinstaller-klipper","text":"Pour ce qui est du firmware, il n'y a rien de sp\u00e9cial \u00e0 faire. Suivez simplement les instructions de flashage du nouveau firmware. Du c\u00f4t\u00e9 Raspberry Pi, un script de d\u00e9sinstallation est disponible dans scripts/klipper-uninstall.sh . Par exemple : sudo ~/klipper/scripts/klipper-uninstall.sh rm -rf ~/klippy-env ~/klipper","title":"Comment d\u00e9sinstaller Klipper ?"},{"location":"Features.html","text":"Caract\u00e9ristiques \u00b6 Klipper propose plusieurs caract\u00e9ristiques int\u00e9ressantes : Mouvements pas \u00e0 pas de haute pr\u00e9cision. Klipper utilise un processeur d'application (tel qu'un Raspberry Pi \u00e0 bas prix) pour calculer les mouvements de l'imprimante. Ce processeur d'application d\u00e9termine le moment o\u00f9 il faut faire marcher chaque moteur pas \u00e0 pas, compresse ces \u00e9v\u00e9nements, les transmet au microcontr\u00f4leur pour que celui-ci ex\u00e9cute chaque \u00e9v\u00e9nement au moment demand\u00e9. Chaque \u00e9v\u00e9nement du moteur pas \u00e0 pas est programm\u00e9 avec une pr\u00e9cision de 25 microsecondes ou mieux. Le logiciel n'utilise pas d'estimations cin\u00e9matiques (telles que l'algorithme de Bresenham), au lieu de cela, il calcule des dur\u00e9es de pas pr\u00e9cises bas\u00e9es sur les physiques de l'acc\u00e9l\u00e9ration et de la cin\u00e9matique de la machine. Un mouvement plus pr\u00e9cis des pas permet un fonctionnement plus silencieux et plus stable de l'imprimante. Meilleures performances de sa cat\u00e9gorie. Klipper est capable d'atteindre des taux de pas \u00e9lev\u00e9s sur les micro-contr\u00f4leurs nouveaux et anciens. M\u00eame les anciens microcontr\u00f4leurs 8 bits peuvent obtenir des taux sup\u00e9rieurs \u00e0 175 000 pas par seconde. Sur les micro-contr\u00f4leurs plus r\u00e9cents, plusieurs millions de pas par seconde sont possibles. Des taux de pas plus \u00e9lev\u00e9s permettent des vitesses d'impression plus \u00e9lev\u00e9es. La synchronisation des \u00e9v\u00e9nements du pas \u00e0 pas reste pr\u00e9cise m\u00eame \u00e0 des vitesses \u00e9lev\u00e9es, ce qui am\u00e9liore la stabilit\u00e9 globale. Klipper prend en charge les imprimantes dot\u00e9es de plusieurs microcontr\u00f4leurs. Par exemple, un microcontr\u00f4leur peut \u00eatre utilis\u00e9 pour contr\u00f4ler l'extrudeur, tandis qu'un autre contr\u00f4le les pi\u00e8ces chauffantes de l'imprimante, et un troisi\u00e8me s'occupe du reste de l'imprimante. Le logiciel Klipper met en \u0153uvre la synchronisation de l'horloge pour tenir compte de la d\u00e9rive entre les microcontr\u00f4leurs. Il n'y a pas besoin de code particulier pour activer plusieurs microcontr\u00f4leurs - il suffit de quelques lignes suppl\u00e9mentaires dans le fichier de configuration. Configuration gr\u00e2ce \u00e0 un fichier de configuration unique. Il n'est pas n\u00e9cessaire de reflasher le microcontr\u00f4leur pour modifier un param\u00e8tre. Toute la configuration de Klipper est stock\u00e9e dans un fichier de configuration standard qui peut \u00eatre facilement modifi\u00e9. Cela facilite la configuration et la maintenance du mat\u00e9riel. Klipper prend en charge la fonction \"Smooth Pressure Advance\", un m\u00e9canisme permettant de prendre en compte les effets de la pression dans un extrudeur. Cela r\u00e9duit le \"suintement\" de l'extrudeur et am\u00e9liore la qualit\u00e9 des d'impression des coins. L'impl\u00e9mentation de Klipper n'introduit pas de changements instantan\u00e9s de la vitesse de l'extrudeur, ce qui am\u00e9liore la stabilit\u00e9 et la robustesse g\u00e9n\u00e9rales. Klipper prend en charge la fonction \"Input Shaping\" pour r\u00e9duire l'impact des vibrations sur la qualit\u00e9 d'impression. Cela peut r\u00e9duire ou \u00e9liminer le \"ringing\" (\u00e9galement appel\u00e9 \"ghosting\", \"echoing\" ou \"rippling\") des impressions. Cela peut \u00e9galement permettre d'obtenir des vitesses d'impression plus rapides tout en maintenant une qualit\u00e9 d'impression \u00e9lev\u00e9e. Klipper utilise un \"solveur it\u00e9ratif\" pour calculer des temps de pas pr\u00e9cis \u00e0 partir d'\u00e9quations cin\u00e9matiques simples. Cela facilite le portage de Klipper sur de nouveaux types de robots et permet de conserver un timing pr\u00e9cis m\u00eame avec une cin\u00e9matique complexe (aucune \"segmentation de ligne\" n'est n\u00e9cessaire). Klipper est agnostique vis-\u00e0-vis du mat\u00e9riel. On doit obtenir le m\u00eame timing pr\u00e9cis ind\u00e9pendamment du mat\u00e9riel \u00e9lectronique de bas niveau. Le code du microcontr\u00f4leur de Klipper est con\u00e7u pour suivre fid\u00e8lement l\u2019ordonnancement fourni par le logiciel h\u00f4te de Klipper (ou pour alerter l'utilisateur de mani\u00e8re \u00e9vidente s'il n'y parvient pas). Il est ainsi plus facile d'utiliser le mat\u00e9riel disponible, de mettre \u00e0 niveau vers un nouveau mat\u00e9riel et d'\u00eatre confiant dans ce mat\u00e9riel. Code portable. Klipper fonctionne sur les micro-contr\u00f4leurs bas\u00e9s sur ARM, AVR et PRU. Les imprimantes existantes de type \"reprap\" peuvent utiliser Klipper sans modification mat\u00e9rielle - il suffit d'ajouter un Raspberry Pi. La conception interne du code de Klipper facilite le support d'autres architectures de micro-contr\u00f4leurs. Un code plus simple. Klipper utilise un langage de tr\u00e8s haut niveau (Python) pour la plupart du code. Les algorithmes cin\u00e9matiques, l'analyse du code G, les algorithmes de chauffage et de thermistance, etc. sont tous \u00e9crits en Python. Il est donc plus facile de d\u00e9velopper de nouvelles fonctionnalit\u00e9s. Macros programmables personnalis\u00e9es. De nouvelles commandes G-Code peuvent \u00eatre d\u00e9finies dans le fichier de configuration de l'imprimante (aucune modification du code n'est alors n\u00e9cessaire). Ces commandes sont programmables - ce qui leur permet de produire diff\u00e9rentes actions selon l'\u00e9tat de l'imprimante. Serveur d\u2019API int\u00e9gr\u00e9. En plus de l\u2019interface G-Code standard, Klipper prend en charge une interface d\u2019application en JSON. Cela permet aux programmeurs de cr\u00e9er des applications externes avec un contr\u00f4le pr\u00e9cis de l\u2019imprimante. Caract\u00e9ristiques suppl\u00e9mentaires \u00b6 Klipper prend en charge de nombreuses fonctionnalit\u00e9s standard des imprimantes 3d : Plusieurs interfaces web disponibles. Fonctionne avec Mainsail, Fluidd, OctoPrint et d'autres. Cela permet de contr\u00f4ler l'imprimante \u00e0 l'aide d'un navigateur web ordinaire. Le m\u00eame Raspberry Pi qui fait fonctionner Klipper peut \u00e9galement faire fonctionner l'interface web. Prise en charge du G-Code standard. Les commandes de g-code courantes produites par les \"trancheurs\" (slicers) typiques (SuperSlicer, Cura, PrusaSlicer, etc.) sont prises en charge. Prise en charge de l'extrusion multiple. Les extrudeurs avec r\u00e9chauffeurs partag\u00e9s et les extrudeurs sur chariots ind\u00e9pendants (IDEX) sont \u00e9galement prises en charge. Prise en charge des imprimantes cart\u00e9siennes, delta, corexy, corexz, hybrides-corexy, hybrides-corexz, deltesiennes, rotatives delta, polaires et \u00e0 treuil. Support du nivellement automatique du bed. Klipper peut \u00eatre configur\u00e9 pour une d\u00e9tection de base de l'inclinaison du bed ou pour une mise \u00e0 niveau compl\u00e8te de celui-ci. Si le bed utilise plusieurs steppers Z, Klipper peut \u00e9galement le mettre \u00e0 niveau en manipulant ind\u00e9pendamment les steppers Z. La plupart des capteurs de hauteur Z sont prises en charge, y compris les sondes BL-Touch et les sondes activ\u00e9es par servomoteur. Prise en charge du calibrage delta automatique. L'outil d'\u00e9talonnage peut effectuer un \u00e9talonnage de base de la hauteur ainsi qu'un avanc\u00e9 des dimensions X et Y. L'\u00e9talonnage peut \u00eatre effectu\u00e9 avec un palpeur de l'axe Z ou manuellement. Prise en charge de l'option \"exclure un objet\" lors de l'impression. Lorsqu'il est configur\u00e9, ce module peut faciliter l'annulation d'un seul objet dans une impression en plusieurs parties. Prise en charge des capteurs de temp\u00e9rature courants (par exemple, les thermistances courantes, AD595, AD597, AD849x, PT100, PT1000, MAX6675, MAX31855, MAX31856, MAX31865, BME280, HTU21D, DS18B20 et LM75). Des thermistances et des capteurs de temp\u00e9rature analogiques personnalis\u00e9s peuvent \u00e9galement \u00eatre configur\u00e9s. On peut surveiller le capteur de temp\u00e9rature interne du microcontr\u00f4leur et le capteur de temp\u00e9rature interne d'un Raspberry Pi. Protection thermique basique de l'appareil activ\u00e9e par d\u00e9faut. Prise en charge des ventilateurs standard, des ventilateurs de buses et des ventilateurs \u00e0 temp\u00e9rature contr\u00f4l\u00e9e. Il n'est pas n\u00e9cessaire de faire tourner les ventilateurs lorsque l'imprimante est inactive. La vitesse du ventilateur peut \u00eatre contr\u00f4l\u00e9e sur les ventilateurs dot\u00e9s d'un tachym\u00e8tre. Prise en charge de la configuration en temps r\u00e9el des pilotes de moteurs pas \u00e0 pas TMC2130, TMC2208/TMC2224, TMC2209, TMC2660 et TMC5160. Il existe \u00e9galement un support pour le contr\u00f4le du courant des pilotes de moteurs pas \u00e0 pas traditionnels via AD5206, DAC084S085, MCP4451, MCP4728, MCP4018, et les broches PWM. Prise en charge des \u00e9crans LCD courants fix\u00e9s directement \u00e0 l'imprimante. Un menu par d\u00e9faut est \u00e9galement disponible. Le contenu de l'\u00e9cran et du menu peut \u00eatre enti\u00e8rement personnalis\u00e9 via le fichier de configuration. Acc\u00e9l\u00e9ration constante et prise en charge du \"look-ahead\". Tous les mouvements de l'imprimante s'acc\u00e9l\u00e8rent progressivement de l'arr\u00eat \u00e0 la vitesse de croisi\u00e8re, puis d\u00e9c\u00e9l\u00e8rent pour revenir \u00e0 l'arr\u00eat. Le flux entrant de commandes de mouvement en G-Code est mis en file d'attente et analys\u00e9 - l'acc\u00e9l\u00e9ration entre les mouvements dans une direction similaire sera optimis\u00e9e pour r\u00e9duire les blocages d'impression et am\u00e9liorer le temps d'impression global. Klipper met en \u0153uvre un algorithme de \"fin de phase pas \u00e0 pas\" qui peut am\u00e9liorer la pr\u00e9cision des interrupteurs de but\u00e9e. Lorsqu'il est correctement r\u00e9gl\u00e9, il peut am\u00e9liorer l'adh\u00e9rence de la premi\u00e8re couche d'une impression. Prise en charge des capteurs de pr\u00e9sence de filaments, des capteurs de mouvement de filaments et des capteurs de largeur de filaments. Prise en charge de la mesure et l'enregistrement de l'acc\u00e9l\u00e9ration \u00e0 l'aide d'un acc\u00e9l\u00e9rom\u00e8tre adxl345, mpu9250 et mpu6050. Prise en charge de la limitation de la vitesse maximale des mouvements courts en \"zigzag\" pour r\u00e9duire les vibrations et le bruit de l'imprimante. Voir le document Cin\u00e9matiques pour plus d'informations. Des exemples de fichiers de configuration sont disponibles pour de nombreuses imprimantes courantes. Consultez le r\u00e9pertoire des configurations pour en obtenir la liste. Pour commencer avec Klipper, lisez le guide d' installation . Tests de performance du stepper \u00b6 Ci-apr\u00e8s les r\u00e9sultats des tests de performance du stepper. Les chiffres indiqu\u00e9s repr\u00e9sentent le nombre total de pas par seconde sur le micro-contr\u00f4leur. Microcontr\u00f4leur 1 stepper actif 3 steppers actifs AVR 16Mhz 157K 99K AVR 20Mhz 196K 123K SAMD21 686K 471K STM32F042 814K 578K PRU Beaglebone 866K 708K STM32G0B1 1103K 790K STM32F103 1180K 818K SAM3X8E 1273K 981K SAM4S8C 1690K 1385K LPC1768 1923K 1351K LPC1769 2353K 1622K RP2040 2400K 1636K SAM4E8E 2500K 1674K SAMD51 3077K 1885K STM32F407 3652K 2459K STM32F446 3913K 2634K STM32H743 9091K 6061K Si vous n'\u00eates pas s\u00fbr du microcontr\u00f4leur d'une carte particuli\u00e8re, trouvez le fichier de configuration appropri\u00e9 , et cherchez le nom du microcontr\u00f4leur dans les commentaires en haut de ce fichier. De plus amples d\u00e9tails sur les bancs d'essais sont disponibles dans le document des bancs d'essais .","title":"Caract\u00e9ristiques"},{"location":"Features.html#caracteristiques","text":"Klipper propose plusieurs caract\u00e9ristiques int\u00e9ressantes : Mouvements pas \u00e0 pas de haute pr\u00e9cision. Klipper utilise un processeur d'application (tel qu'un Raspberry Pi \u00e0 bas prix) pour calculer les mouvements de l'imprimante. Ce processeur d'application d\u00e9termine le moment o\u00f9 il faut faire marcher chaque moteur pas \u00e0 pas, compresse ces \u00e9v\u00e9nements, les transmet au microcontr\u00f4leur pour que celui-ci ex\u00e9cute chaque \u00e9v\u00e9nement au moment demand\u00e9. Chaque \u00e9v\u00e9nement du moteur pas \u00e0 pas est programm\u00e9 avec une pr\u00e9cision de 25 microsecondes ou mieux. Le logiciel n'utilise pas d'estimations cin\u00e9matiques (telles que l'algorithme de Bresenham), au lieu de cela, il calcule des dur\u00e9es de pas pr\u00e9cises bas\u00e9es sur les physiques de l'acc\u00e9l\u00e9ration et de la cin\u00e9matique de la machine. Un mouvement plus pr\u00e9cis des pas permet un fonctionnement plus silencieux et plus stable de l'imprimante. Meilleures performances de sa cat\u00e9gorie. Klipper est capable d'atteindre des taux de pas \u00e9lev\u00e9s sur les micro-contr\u00f4leurs nouveaux et anciens. M\u00eame les anciens microcontr\u00f4leurs 8 bits peuvent obtenir des taux sup\u00e9rieurs \u00e0 175 000 pas par seconde. Sur les micro-contr\u00f4leurs plus r\u00e9cents, plusieurs millions de pas par seconde sont possibles. Des taux de pas plus \u00e9lev\u00e9s permettent des vitesses d'impression plus \u00e9lev\u00e9es. La synchronisation des \u00e9v\u00e9nements du pas \u00e0 pas reste pr\u00e9cise m\u00eame \u00e0 des vitesses \u00e9lev\u00e9es, ce qui am\u00e9liore la stabilit\u00e9 globale. Klipper prend en charge les imprimantes dot\u00e9es de plusieurs microcontr\u00f4leurs. Par exemple, un microcontr\u00f4leur peut \u00eatre utilis\u00e9 pour contr\u00f4ler l'extrudeur, tandis qu'un autre contr\u00f4le les pi\u00e8ces chauffantes de l'imprimante, et un troisi\u00e8me s'occupe du reste de l'imprimante. Le logiciel Klipper met en \u0153uvre la synchronisation de l'horloge pour tenir compte de la d\u00e9rive entre les microcontr\u00f4leurs. Il n'y a pas besoin de code particulier pour activer plusieurs microcontr\u00f4leurs - il suffit de quelques lignes suppl\u00e9mentaires dans le fichier de configuration. Configuration gr\u00e2ce \u00e0 un fichier de configuration unique. Il n'est pas n\u00e9cessaire de reflasher le microcontr\u00f4leur pour modifier un param\u00e8tre. Toute la configuration de Klipper est stock\u00e9e dans un fichier de configuration standard qui peut \u00eatre facilement modifi\u00e9. Cela facilite la configuration et la maintenance du mat\u00e9riel. Klipper prend en charge la fonction \"Smooth Pressure Advance\", un m\u00e9canisme permettant de prendre en compte les effets de la pression dans un extrudeur. Cela r\u00e9duit le \"suintement\" de l'extrudeur et am\u00e9liore la qualit\u00e9 des d'impression des coins. L'impl\u00e9mentation de Klipper n'introduit pas de changements instantan\u00e9s de la vitesse de l'extrudeur, ce qui am\u00e9liore la stabilit\u00e9 et la robustesse g\u00e9n\u00e9rales. Klipper prend en charge la fonction \"Input Shaping\" pour r\u00e9duire l'impact des vibrations sur la qualit\u00e9 d'impression. Cela peut r\u00e9duire ou \u00e9liminer le \"ringing\" (\u00e9galement appel\u00e9 \"ghosting\", \"echoing\" ou \"rippling\") des impressions. Cela peut \u00e9galement permettre d'obtenir des vitesses d'impression plus rapides tout en maintenant une qualit\u00e9 d'impression \u00e9lev\u00e9e. Klipper utilise un \"solveur it\u00e9ratif\" pour calculer des temps de pas pr\u00e9cis \u00e0 partir d'\u00e9quations cin\u00e9matiques simples. Cela facilite le portage de Klipper sur de nouveaux types de robots et permet de conserver un timing pr\u00e9cis m\u00eame avec une cin\u00e9matique complexe (aucune \"segmentation de ligne\" n'est n\u00e9cessaire). Klipper est agnostique vis-\u00e0-vis du mat\u00e9riel. On doit obtenir le m\u00eame timing pr\u00e9cis ind\u00e9pendamment du mat\u00e9riel \u00e9lectronique de bas niveau. Le code du microcontr\u00f4leur de Klipper est con\u00e7u pour suivre fid\u00e8lement l\u2019ordonnancement fourni par le logiciel h\u00f4te de Klipper (ou pour alerter l'utilisateur de mani\u00e8re \u00e9vidente s'il n'y parvient pas). Il est ainsi plus facile d'utiliser le mat\u00e9riel disponible, de mettre \u00e0 niveau vers un nouveau mat\u00e9riel et d'\u00eatre confiant dans ce mat\u00e9riel. Code portable. Klipper fonctionne sur les micro-contr\u00f4leurs bas\u00e9s sur ARM, AVR et PRU. Les imprimantes existantes de type \"reprap\" peuvent utiliser Klipper sans modification mat\u00e9rielle - il suffit d'ajouter un Raspberry Pi. La conception interne du code de Klipper facilite le support d'autres architectures de micro-contr\u00f4leurs. Un code plus simple. Klipper utilise un langage de tr\u00e8s haut niveau (Python) pour la plupart du code. Les algorithmes cin\u00e9matiques, l'analyse du code G, les algorithmes de chauffage et de thermistance, etc. sont tous \u00e9crits en Python. Il est donc plus facile de d\u00e9velopper de nouvelles fonctionnalit\u00e9s. Macros programmables personnalis\u00e9es. De nouvelles commandes G-Code peuvent \u00eatre d\u00e9finies dans le fichier de configuration de l'imprimante (aucune modification du code n'est alors n\u00e9cessaire). Ces commandes sont programmables - ce qui leur permet de produire diff\u00e9rentes actions selon l'\u00e9tat de l'imprimante. Serveur d\u2019API int\u00e9gr\u00e9. En plus de l\u2019interface G-Code standard, Klipper prend en charge une interface d\u2019application en JSON. Cela permet aux programmeurs de cr\u00e9er des applications externes avec un contr\u00f4le pr\u00e9cis de l\u2019imprimante.","title":"Caract\u00e9ristiques"},{"location":"Features.html#caracteristiques-supplementaires","text":"Klipper prend en charge de nombreuses fonctionnalit\u00e9s standard des imprimantes 3d : Plusieurs interfaces web disponibles. Fonctionne avec Mainsail, Fluidd, OctoPrint et d'autres. Cela permet de contr\u00f4ler l'imprimante \u00e0 l'aide d'un navigateur web ordinaire. Le m\u00eame Raspberry Pi qui fait fonctionner Klipper peut \u00e9galement faire fonctionner l'interface web. Prise en charge du G-Code standard. Les commandes de g-code courantes produites par les \"trancheurs\" (slicers) typiques (SuperSlicer, Cura, PrusaSlicer, etc.) sont prises en charge. Prise en charge de l'extrusion multiple. Les extrudeurs avec r\u00e9chauffeurs partag\u00e9s et les extrudeurs sur chariots ind\u00e9pendants (IDEX) sont \u00e9galement prises en charge. Prise en charge des imprimantes cart\u00e9siennes, delta, corexy, corexz, hybrides-corexy, hybrides-corexz, deltesiennes, rotatives delta, polaires et \u00e0 treuil. Support du nivellement automatique du bed. Klipper peut \u00eatre configur\u00e9 pour une d\u00e9tection de base de l'inclinaison du bed ou pour une mise \u00e0 niveau compl\u00e8te de celui-ci. Si le bed utilise plusieurs steppers Z, Klipper peut \u00e9galement le mettre \u00e0 niveau en manipulant ind\u00e9pendamment les steppers Z. La plupart des capteurs de hauteur Z sont prises en charge, y compris les sondes BL-Touch et les sondes activ\u00e9es par servomoteur. Prise en charge du calibrage delta automatique. L'outil d'\u00e9talonnage peut effectuer un \u00e9talonnage de base de la hauteur ainsi qu'un avanc\u00e9 des dimensions X et Y. L'\u00e9talonnage peut \u00eatre effectu\u00e9 avec un palpeur de l'axe Z ou manuellement. Prise en charge de l'option \"exclure un objet\" lors de l'impression. Lorsqu'il est configur\u00e9, ce module peut faciliter l'annulation d'un seul objet dans une impression en plusieurs parties. Prise en charge des capteurs de temp\u00e9rature courants (par exemple, les thermistances courantes, AD595, AD597, AD849x, PT100, PT1000, MAX6675, MAX31855, MAX31856, MAX31865, BME280, HTU21D, DS18B20 et LM75). Des thermistances et des capteurs de temp\u00e9rature analogiques personnalis\u00e9s peuvent \u00e9galement \u00eatre configur\u00e9s. On peut surveiller le capteur de temp\u00e9rature interne du microcontr\u00f4leur et le capteur de temp\u00e9rature interne d'un Raspberry Pi. Protection thermique basique de l'appareil activ\u00e9e par d\u00e9faut. Prise en charge des ventilateurs standard, des ventilateurs de buses et des ventilateurs \u00e0 temp\u00e9rature contr\u00f4l\u00e9e. Il n'est pas n\u00e9cessaire de faire tourner les ventilateurs lorsque l'imprimante est inactive. La vitesse du ventilateur peut \u00eatre contr\u00f4l\u00e9e sur les ventilateurs dot\u00e9s d'un tachym\u00e8tre. Prise en charge de la configuration en temps r\u00e9el des pilotes de moteurs pas \u00e0 pas TMC2130, TMC2208/TMC2224, TMC2209, TMC2660 et TMC5160. Il existe \u00e9galement un support pour le contr\u00f4le du courant des pilotes de moteurs pas \u00e0 pas traditionnels via AD5206, DAC084S085, MCP4451, MCP4728, MCP4018, et les broches PWM. Prise en charge des \u00e9crans LCD courants fix\u00e9s directement \u00e0 l'imprimante. Un menu par d\u00e9faut est \u00e9galement disponible. Le contenu de l'\u00e9cran et du menu peut \u00eatre enti\u00e8rement personnalis\u00e9 via le fichier de configuration. Acc\u00e9l\u00e9ration constante et prise en charge du \"look-ahead\". Tous les mouvements de l'imprimante s'acc\u00e9l\u00e8rent progressivement de l'arr\u00eat \u00e0 la vitesse de croisi\u00e8re, puis d\u00e9c\u00e9l\u00e8rent pour revenir \u00e0 l'arr\u00eat. Le flux entrant de commandes de mouvement en G-Code est mis en file d'attente et analys\u00e9 - l'acc\u00e9l\u00e9ration entre les mouvements dans une direction similaire sera optimis\u00e9e pour r\u00e9duire les blocages d'impression et am\u00e9liorer le temps d'impression global. Klipper met en \u0153uvre un algorithme de \"fin de phase pas \u00e0 pas\" qui peut am\u00e9liorer la pr\u00e9cision des interrupteurs de but\u00e9e. Lorsqu'il est correctement r\u00e9gl\u00e9, il peut am\u00e9liorer l'adh\u00e9rence de la premi\u00e8re couche d'une impression. Prise en charge des capteurs de pr\u00e9sence de filaments, des capteurs de mouvement de filaments et des capteurs de largeur de filaments. Prise en charge de la mesure et l'enregistrement de l'acc\u00e9l\u00e9ration \u00e0 l'aide d'un acc\u00e9l\u00e9rom\u00e8tre adxl345, mpu9250 et mpu6050. Prise en charge de la limitation de la vitesse maximale des mouvements courts en \"zigzag\" pour r\u00e9duire les vibrations et le bruit de l'imprimante. Voir le document Cin\u00e9matiques pour plus d'informations. Des exemples de fichiers de configuration sont disponibles pour de nombreuses imprimantes courantes. Consultez le r\u00e9pertoire des configurations pour en obtenir la liste. Pour commencer avec Klipper, lisez le guide d' installation .","title":"Caract\u00e9ristiques suppl\u00e9mentaires"},{"location":"Features.html#tests-de-performance-du-stepper","text":"Ci-apr\u00e8s les r\u00e9sultats des tests de performance du stepper. Les chiffres indiqu\u00e9s repr\u00e9sentent le nombre total de pas par seconde sur le micro-contr\u00f4leur. Microcontr\u00f4leur 1 stepper actif 3 steppers actifs AVR 16Mhz 157K 99K AVR 20Mhz 196K 123K SAMD21 686K 471K STM32F042 814K 578K PRU Beaglebone 866K 708K STM32G0B1 1103K 790K STM32F103 1180K 818K SAM3X8E 1273K 981K SAM4S8C 1690K 1385K LPC1768 1923K 1351K LPC1769 2353K 1622K RP2040 2400K 1636K SAM4E8E 2500K 1674K SAMD51 3077K 1885K STM32F407 3652K 2459K STM32F446 3913K 2634K STM32H743 9091K 6061K Si vous n'\u00eates pas s\u00fbr du microcontr\u00f4leur d'une carte particuli\u00e8re, trouvez le fichier de configuration appropri\u00e9 , et cherchez le nom du microcontr\u00f4leur dans les commentaires en haut de ce fichier. De plus amples d\u00e9tails sur les bancs d'essais sont disponibles dans le document des bancs d'essais .","title":"Tests de performance du stepper"},{"location":"G-Codes.html","text":"G-Codes \u00b6 Ce document d\u00e9crit les commandes que Klipper supporte. Il s'agit de commandes que l'on peut saisir dans l'onglet du terminal OctoPrint. Commandes G-Code \u00b6 Klipper prend en charge les commandes G-Code standard suivantes : Move (G0 ou G1): G1 [X<pos>] [Y<pos>] [Z<pos>] [E<pos>] [F<speed>] Temporisation : G4 P<millisecondes> D\u00e9placement vers l'origine : G28 [X] [Y] [Z] \u00c9teindre les moteurs : M18 ou M84 Attendre la fin des mouvements en cours : M400 Utiliser des distances absolues/relatives pour l'extrusion : M82 , M83 Utiliser des coordonn\u00e9es absolues/relatives : G90 , G91 D\u00e9finir la position : G92 [X<pos>] [Y<pos>] [Z<pos>] [E<pos>] D\u00e9finir le pourcentage de neutralisation du facteur de vitesse : M220 S<percent> D\u00e9finit le pourcentage d'annulation du facteur d'extrusion : M221 S<percent> R\u00e9gler l'acc\u00e9l\u00e9ration : M204 S<valeur> OU M204 P<valeur> T<valeur> Remarque : si S n'est pas sp\u00e9cifi\u00e9 et que P et T le sont, l'acc\u00e9l\u00e9ration sera r\u00e9gl\u00e9e sur le minimum de P et T. Si un seul P ou T est donn\u00e9, la commande n'aura aucun effet. Obtenir la temp\u00e9rature de l'extrudeur : M105 R\u00e9gler la temp\u00e9rature de l'extrudeur : M104 [T<index>] [S<temp\u00e9rature>] R\u00e9gler la temp\u00e9rature de l'extrudeur et attendre : M109 [T<index>] S<temp\u00e9rature> Note : M109 attendra toujours que la temp\u00e9rature se stabilise \u00e0 la valeur demand\u00e9e. R\u00e9gler la temp\u00e9rature du bed : M140 [S<temperature>] R\u00e9gler la temp\u00e9rature du bed et attendre : M190 S<temperature> Note : M190 attendra toujours que la temp\u00e9rature se stabilise \u00e0 la valeur demand\u00e9e. R\u00e9gler la vitesse du ventilateur : M106 S<valeur> D\u00e9sactiver le ventilateur : M107 Arr\u00eat d'urgence : M112 Obtenir la position actuelle : M114 Obtenir la version du firmware : M115 Pour plus de d\u00e9tails sur les commandes ci-dessus, voir la [documentation RepRap G-Code] ( http://reprap.org/wiki/G-code ). L'objectif de Klipper est de prendre en charge les commandes G-Code produites par les logiciels tiers courants (par exemple, OctoPrint, Printrun, Slic3r, Cura, etc.) dans leurs configurations standards. Le but n'est pas de prendre en charge toutes les commandes G-Code possibles. Au contraire, Klipper pr\u00e9f\u00e8re les [\"commandes G-Code \u00e9tendues\"] (#additional-commands) humainement lisibles. De la m\u00eame mani\u00e8re, la sortie du terminal G-Code est uniquement destin\u00e9e \u00e0 \u00eatre humainement lisible - voir le document du serveur API si vous contr\u00f4lez Klipper depuis un logiciel externe. Si vous avez besoin d'une commande G-Code moins courante, il est possible de l'impl\u00e9menter avec une section de configuration gcode_macro personnalis\u00e9e . Par exemple, on peut utiliser ceci pour impl\u00e9menter : G12 , G29 , G30 , G31 , M42 , M80 , M81 , T1 , etc. Commandes additionnelles \u00b6 Klipper utilise des commandes G-Code \"\u00e9tendues\" pour la configuration g\u00e9n\u00e9rale et l'\u00e9tat. Ces commandes \u00e9tendues suivent toutes un format similaire : elles commencent par le nom de la commande et peuvent \u00eatre suivies d'un ou plusieurs param\u00e8tres. Par exemple : SET_SERVO SERVO=myservo ANGLE=5.3 . Dans ce document, les commandes et les param\u00e8tres sont indiqu\u00e9s en majuscules, mais ils ne sont pas sensibles \u00e0 la casse. (Ainsi, \"SET_SERVO\" et \"set_servo\" ex\u00e9cuteront tous deux la m\u00eame commande). Cette section est organis\u00e9e par nom de module Klipper, en suivant g\u00e9n\u00e9ralement les noms de section sp\u00e9cifi\u00e9s dans le fichier de configuration de l'imprimante . Notez que certains modules sont automatiquement charg\u00e9s. [adxl345] \u00b6 Les commandes suivantes sont disponibles lorsqu'une section adxl345 config est activ\u00e9e. ACCELEROMETER_MEASURE \u00b6 ACCELEROMETER_MEASURE [CHIP=<nom_de_la_configuration>] [NAME=<valeur>] : D\u00e9marre les mesures de l'acc\u00e9l\u00e9rom\u00e8tre au nombre d'\u00e9chantillons par seconde demand\u00e9. Si CHIP n'est pas pr\u00e9cis\u00e9, la valeur par d\u00e9faut est \"adxl345\". La commande fonctionne en mode start-stop : ex\u00e9cut\u00e9e pour la premi\u00e8re fois, elle d\u00e9marre les mesures, l'ex\u00e9cution suivante les arr\u00eate. Les r\u00e9sultats des mesures sont \u00e9crits dans un fichier nomm\u00e9 /tmp/adxl345-<chip>-<nom>.csv o\u00f9 <chip> est le nom de la puce acc\u00e9l\u00e9rom\u00e8tre ( my_chip_name de [adxl345 my_chip_name] ) et <nom> est le param\u00e8tre optionnel NAME. Si le param\u00e8tre NOM n'est pas pr\u00e9cis\u00e9, l'heure actuelle est utilis\u00e9e par d\u00e9faut au format \"AAAAMMJJ_HHMMSS\". Si l'acc\u00e9l\u00e9rom\u00e8tre n'a pas de nom dans sa section de configuration (simplement [adxl345] ) alors la partie <chip> du nom n'est pas g\u00e9n\u00e9r\u00e9e. ACCELEROMETER_QUERY \u00b6 ACCELEROMETER_QUERY [CHIP=<nom_de_la_configuration>] [RATE=<valeur>] : interroge l'acc\u00e9l\u00e9rom\u00e8tre pour la valeur courante. Si CHIP n'est pas pr\u00e9cis\u00e9, la valeur par d\u00e9faut est \"adxl345\". Si RATE n'est pas pr\u00e9cis\u00e9, la valeur par d\u00e9faut est utilis\u00e9e. Cette commande permet de tester la connexion \u00e0 l'acc\u00e9l\u00e9rom\u00e8tre ADXL345 : une des valeurs retourn\u00e9es devrait \u00eatre une acc\u00e9l\u00e9ration en chute libre (+/- un certain bruit de la puce). ACCELEROMETER_DEBUG_READ \u00b6 ACCELEROMETER_DEBUG_READ [CHIP=<nom_de_la_configuration>] REG=<registre> : interroge le registre ADXL345 \"registre\" (par exemple 44 ou 0x2C). Peut \u00eatre utile \u00e0 des fins de d\u00e9bogage. ACCELEROMETER_DEBUG_WRITE \u00b6 ACCELEROMETER_DEBUG_WRITE [CHIP=<nom_de_la_configuration>] REG=<registre> VAL=<valeur> : Ecrit la \"valeur\" brute dans le registre \"registre\". La \"valeur\" et le \"registre\" peuvent \u00eatre des entiers d\u00e9cimaux ou hexad\u00e9cimaux. A utiliser avec pr\u00e9caution, et se r\u00e9f\u00e9rer \u00e0 la fiche technique de l'ADXL345 pour la r\u00e9f\u00e9rence. [angle] \u00b6 Les commandes suivantes sont disponibles lorsqu'une section angle config est activ\u00e9e. ANGLE_CALIBRATE \u00b6 ANGLE_CALIBRATE CHIP=<nom_de_la_puce> : Effectue une calibration d'angle sur le capteur donn\u00e9 (il doit y avoir une section de configuration [angle nom_de_la_puce] qui a indiqu\u00e9 un param\u00e8tre stepper ). IMPORTANT - cet outil commandera au moteur pas \u00e0 pas de se d\u00e9placer sans v\u00e9rifier les limites normales de la cin\u00e9matique. Id\u00e9alement, le moteur devrait \u00eatre d\u00e9connect\u00e9 de tout chariot d'imprimante avant d'effectuer le calibrage. Si le moteur pas \u00e0 pas ne peut pas \u00eatre d\u00e9connect\u00e9 de l'imprimante, assurez-vous que le chariot est proche du centre de son rail avant de commencer l'\u00e9talonnage. (Le moteur pas \u00e0 pas peut se d\u00e9placer vers l'avant ou l'arri\u00e8re de deux rotations compl\u00e8tes durant ce test). Apr\u00e8s avoir termin\u00e9 ce test, utilisez la commande SAVE_CONFIG pour sauvegarder les donn\u00e9es de calibration dans le fichier de configuration. Afin d'utiliser cet outil, le paquetage Python \"numpy\" doit \u00eatre install\u00e9 (voir le document mesurer les r\u00e9sonances pour plus d'informations). ANGLE_DEBUG_READ \u00b6 ANGLE_DEBUG_READ CHIP=<nom_de_la_configuration> REG=<registre> : Interroge le registre \"registre\" du capteur (par exemple 44 ou 0x2C). Peut \u00eatre utile \u00e0 des fins de d\u00e9bogage. Ceci n'est disponible que pour les puces tle5012b. ANGLE_DEBUG_WRITE \u00b6 ANGLE_DEBUG_WRITE CHIP=<nom_de_la_configuration> REG=<registre> VAL=<valeur> : \u00c9crit la \"valeur\" brute dans le registre \"registre\". La \"valeur\" et le \"registre\" peuvent \u00eatre des entiers d\u00e9cimaux ou hexad\u00e9cimaux. A utiliser avec pr\u00e9caution, et se r\u00e9f\u00e9rer \u00e0 la fiche technique du capteur pour la r\u00e9f\u00e9rence. Cette fonction n'est disponible que pour les puces tle5012b. [bed_mesh] \u00b6 Les commandes suivantes sont disponibles lorsque la section configuration de bed_mesh est activ\u00e9e (voir \u00e9galement le guide de bed_mesh ). BED_MESH_CALIBRATE \u00b6 BED_MESH_CALIBRATE [METHOD=manual] [<probe_parameter>=<value>] [<mesh_parameter>=<value>] : Cette commande palpe le bed en utilisant des points g\u00e9n\u00e9r\u00e9s sp\u00e9cifi\u00e9s par les param\u00e8tres de la config. Apr\u00e8s le test, un maillage est g\u00e9n\u00e9r\u00e9 et le d\u00e9placement de l'axe Z est ajust\u00e9 en fonction de celui-ci. R\u00e9f\u00e9rez-vous \u00e0 la commande PROBE pour plus de d\u00e9tails sur les param\u00e8tres optionnels. Si METHOD=manual est sp\u00e9cifi\u00e9, l'outil de palpage manuel est activ\u00e9 - voir la commande MANUAL_PROBE ci-dessus pour plus de d\u00e9tails sur les possibilit\u00e9s suppl\u00e9mentaires disponibles lorsque cet outil est utilis\u00e9. BED_MESH_OUTPUT \u00b6 BED_MESH_OUTPUT PGP=[<0:1>] : Cette commande \u00e9crit les valeurs z palp\u00e9es actuelles et les valeurs de maillage actuelles sur le terminal. Si PGP=1 est sp\u00e9cifi\u00e9, les coordonn\u00e9es X, Y g\u00e9n\u00e9r\u00e9es par bed_mesh, ainsi que leurs indices associ\u00e9s, seront envoy\u00e9s au terminal. BED_MESH_MAP \u00b6 BED_MESH_MAP : Comme pour BED_MESH_OUTPUT, cette commande affiche l'\u00e9tat actuel du maillage sur le terminal. L'\u00e9tat sera retourn\u00e9 au format json. Cela permet aux plugins octoprint de r\u00e9cup\u00e9rer facilement les donn\u00e9es et de g\u00e9n\u00e9rer des cartes d'altitude au plus proche de la surface du bed. BED_MESH_CLEAR \u00b6 BED_MESH_CLEAR : Cette commande efface le maillage actuel et supprime les ajustements de l'axe z. Il est recommand\u00e9 de mettre cette commande dans votre gcode de fin. BED_MESH_PROFILE \u00b6 BED_MESH_PROFILE LOAD=<nom> SAVE=<nom> REMOVE=<nom> : Cette commande fournit une gestion de profil pour l'\u00e9tat du maillage. LOAD restaurera l'\u00e9tat du maillage \u00e0 partir du profil correspondant au nom fourni. SAVE sauvegarde l'\u00e9tat du maillage actuel dans un profil correspondant au nom fourni. REMOVE supprimera le profil correspondant au nom fourni de la m\u00e9moire persistante. Notez qu'apr\u00e8s l'ex\u00e9cution des op\u00e9rations SAVE ou REMOVE, le gcode SAVE_CONFIG doit \u00eatre ex\u00e9cut\u00e9 pour rendre les changements de la m\u00e9moire persistante permanents. BED_MESH_OFFSET \u00b6 BED_MESH_OFFSET [X=<value>] [Y=<value>] : Applique des d\u00e9calages X et/ou Y pour l'\u00e9valuation du maillage. Ceci est utile pour les imprimantes avec extrudeurs ind\u00e9pendants, car un d\u00e9calage est n\u00e9cessaire pour obtenir un ajustement Z correct apr\u00e8s un changement d'outil. [bed_screws] \u00b6 Les commandes suivantes sont disponibles lorsque la section config bed_screws est activ\u00e9e (voir \u00e9galement le guide du nivelage manuel ). BED_SCREWS_ADJUST \u00b6 BED_SCREWS_ADJUST : Cette commande fait appel \u00e0 l'outil de r\u00e9glage des vis du bed. Elle commandera la buse \u00e0 diff\u00e9rents endroits (tels que d\u00e9finis dans le fichier de configuration) et permettra d'ajuster les vis du bed afin que celui-ci et la buse soient \u00e0 distance constante. [bed_tilt] \u00b6 Les commandes suivantes sont disponibles lorsque la section config bed_tilt est activ\u00e9e. BED_TILT_CALIBRATE \u00b6 BED_TILT_CALIBRATE [METHOD=manual] [<probe_parameter>=<value>] : Cette commande teste les points sp\u00e9cifi\u00e9s dans la configuration, puis recommande des ajustements d'inclinaison x et y mis \u00e0 jour. Voir la commande PROBE pour plus de d\u00e9tails sur les param\u00e8tres de palpage optionnels. Si METHOD=manual est sp\u00e9cifi\u00e9, l'outil de palpage manuel est activ\u00e9 - voir la commande MANUAL_PROBE ci-dessus pour plus de d\u00e9tails sur les commandes suppl\u00e9mentaires disponibles lorsque cet outil est actif. [bltouch] \u00b6 La commande suivante est disponible lorsqu'une section bltouch config est activ\u00e9e (voir \u00e9galement le Guide BL-Touch ). BLTOUCH_DEBUG \u00b6 BLTOUCH_DEBUG COMMAND=<commande> : Ceci envoie une commande au BLTouch. Elle peut \u00eatre utile pour le d\u00e9bogage. Les commandes disponibles sont : pin_down , touch_mode , pin_up , self_test , reset . Un BL-Touch V3.0 ou V3.1 accepte en plus les commandes set_5V_output_mode , set_OD_output_mode , output_mode_store . BLTOUCH_STORE \u00b6 BLTOUCH_STORE MODE=<output_mode> : Stocke un mode de sortie dans l'EEPROM d'un BLTouch V3.1 Les modes de sortie disponibles sont : 5V , OD [configfile] \u00b6 Le module configfile est automatiquement charg\u00e9. SAVE_CONFIG \u00b6 SAVE_CONFIG : Cette commande \u00e9crase le fichier de configuration principal de l'imprimante et red\u00e9marre le logiciel h\u00f4te. Cette commande est utilis\u00e9e conjointement avec d'autres commandes d'\u00e9talonnage pour enregistrer les r\u00e9sultats de ces tests. [delayed_gcode] \u00b6 La commande suivante est activ\u00e9e si une section de configuration delayed_gcode a \u00e9t\u00e9 activ\u00e9e (voir \u00e9galement le guide des mod\u00e8les ). UPDATE_DELAYED_GCODE \u00b6 UPDATE_DELAYED_GCODE [ID=<nom>] [DURATION=<secondes>] : Met \u00e0 jour la dur\u00e9e du retard du [delayed_gcode] identifi\u00e9 et d\u00e9marre le minuteur pour l'ex\u00e9cution du gcode. Une valeur de 0 annulera l'ex\u00e9cution d'un gcode retard\u00e9 en attente. [delta_calibrate] \u00b6 Les commandes suivantes sont disponibles lorsque la section delta_calibrate config est activ\u00e9e (voir \u00e9galement le guide delta calibrate ). DELTA_CALIBRATE \u00b6 DELTA_CALIBRATE [METHOD=manual] [<probe_parameter>=<value>] : Cette commande teste sept points sur le lit et recommande des positions de but\u00e9e, des angles de tour et des rayons mis \u00e0 jour. Voir la commande PROBE pour plus de d\u00e9tails sur les param\u00e8tres de palpage optionnels. Si METHOD=manual est sp\u00e9cifi\u00e9, l'outil de palpage manuel est activ\u00e9 - voir la commande MANUAL_PROBE ci-dessus pour plus de d\u00e9tails sur les commandes suppl\u00e9mentaires disponibles lorsque cet outil est actif. DELTA_ANALYZE \u00b6 DELTA_ANALYZE : Cette commande est utilis\u00e9e pendant l'\u00e9talonnage delta am\u00e9lior\u00e9. Voir Calibrage delta pour plus de d\u00e9tails. [display] \u00b6 La commande suivante est disponible lorsqu'une section display config est activ\u00e9e. SET_DISPLAY_GROUP \u00b6 SET_DISPLAY_GROUP [DISPLAY=<display>] GROUP=<group> : D\u00e9finit le groupe d'affichage actif d'un \u00e9cran LCD. Cela permet de d\u00e9finir plusieurs groupes de donn\u00e9es d'affichage dans la configuration, par exemple [display_data <group> <elementname>] et de passer de l'un \u00e0 l'autre en utilisant cette commande gcode \u00e9tendue. Si DISPLAY n'est pas sp\u00e9cifi\u00e9, la valeur par d\u00e9faut est \"display\" (l'affichage principal). [display_status] \u00b6 Le module display_status est automatiquement charg\u00e9 si une section display config est activ\u00e9e. Il fournit les commandes G-Code standard suivantes : Afficher un message : M117 <message> D\u00e9finir le pourcentage de g\u00e9n\u00e9ration : M73 P<pourcentage> La commande G-Code \u00e9tendue suivante est \u00e9galement fournie : SET_DISPLAY_TEXT MSG=<message> : Effectue l'\u00e9quivalent de M117, en d\u00e9finissant le MSG fourni comme le message d'affichage actuel. Si MSG est omis, l'affichage est effac\u00e9. [dual_carriage] \u00b6 La commande suivante est disponible lorsque la section config dual_carriage est activ\u00e9e. SET_DUAL_CARRIAGE \u00b6 SET_DUAL_CARRIAGE CARRIAGE=[0|1] : Cette commande d\u00e9finit le chariot actif. Elle est g\u00e9n\u00e9ralement appel\u00e9e \u00e0 partir des champs activate_gcode et deactivate_gcode dans une configuration \u00e0 extrudeurs multiples. [endstop_phase] \u00b6 Les commandes suivantes sont disponibles lorsqu'une section de configuration endstop_phase est activ\u00e9e (voir \u00e9galement le guide de la phase d'arr\u00eat ). ENDSTOP_PHASE_CALIBRATE \u00b6 ENDSTOP_PHASE_CALIBRATE [STEPPER=<config_name>] : Si aucun param\u00e8tre STEPPER n'est fourni, cette commande rapporte des statistiques sur les phases d'arr\u00eat du stepper pendant les pr\u00e9c\u00e9dentes op\u00e9rations de recherche d'origine. Lorsqu'un param\u00e8tre STEPPER est fourni, elle fait en sorte que le param\u00e8tre de phase de fin de course donn\u00e9 soit \u00e9crit dans le fichier de configuration (en lien avec la commande SAVE_CONFIG). [exclude_object] \u00b6 Les commandes suivantes sont disponibles lorsqu'une section de configuration exclude_object est activ\u00e9e (voir \u00e9galement le guide d'exclusion d'objet ) : EXCLUDE_OBJECT \u00b6 EXCLUDE_OBJECT [NAME=nom_objet] [CURRENT=1] [RESET=1] : Sans param\u00e8tres, cette commande renvoie une liste de tous les objets actuellement exclus. Lorsque le param\u00e8tre NAME est donn\u00e9, l'objet nomm\u00e9 sera exclu de l'impression. Lorsque le param\u00e8tre CURRENT est donn\u00e9, l'objet courant sera exclu de l'impression. Lorsque le param\u00e8tre RESET est donn\u00e9, la liste des objets exclus sera effac\u00e9e. De plus, inclure le param\u00e8tre NAME ne r\u00e9initialisera que l'objet nomm\u00e9. Cela peut provoquer des \u00e9checs d'impression, si des couches ont d\u00e9j\u00e0 \u00e9t\u00e9 omises. EXCLUDE_OBJECT_DEFINE \u00b6 EXCLUDE_OBJECT_DEFINE [NAME=nom_objet [CENTER=X,Y] [POLYGON=[[x,y],...]]] [RESET=1] [JSON=1] : Fournit le r\u00e9sum\u00e9 d'un objet dans le fichier. Sans param\u00e8tres fournis, ceci va lister les objets d\u00e9finis connus de Klipper. Retourne une liste de cha\u00eenes de caract\u00e8res, \u00e0 moins que le param\u00e8tre JSON soit donn\u00e9, auquel cas retournera les d\u00e9tails de l'objet au format json. Lorsque le param\u00e8tre NAME est inclus, cela d\u00e9finit un objet \u00e0 exclure. NAME : Ce param\u00e8tre est obligatoire. Il s'agit de l'identifiant utilis\u00e9 par les autres commandes de ce module. CENTER : Une coordonn\u00e9e X,Y pour l'objet. POLYGON : Un tableau de coordonn\u00e9es X,Y fournissant le contour d'un objet. Lorsque le param\u00e8tre RESET est fourni, tous les objets d\u00e9finis seront effac\u00e9s, et le module [exclude_object] sera r\u00e9initialis\u00e9. EXCLUDE_OBJECT_START \u00b6 EXCLUDE_OBJECT_START NAME=nom_objet : Cette commande prend un param\u00e8tre NAME et indique le d\u00e9but du gcode pour un objet sur la couche courante. EXCLUDE_OBJECT_END \u00b6 EXCLUDE_OBJECT_END [NAME=nom_objet] : Indique la fin du gcode de l'objet pour la couche. Il est associ\u00e9 \u00e0 EXCLUDE_OBJECT_START . Le param\u00e8tre NAME est optionnel, et n'avertira que si le nom fourni ne correspond au nom actuel. [extruder] \u00b6 Les commandes suivantes sont disponibles si une section configuration de l'extrudeuse est activ\u00e9e : ACTIVATE_EXTRUDER \u00b6 ACTIVATE_EXTRUDER EXTRUDER=<nom_de_la_configuration> : Dans une imprimante comportant plusieurs sections de configuration d' extrudeuse , cette commande s\u00e9lectionne la t\u00eate d'outil active. SET_PRESSURE_ADVANCE \u00b6 SET_PRESSURE_ADVANCE [EXTRUDER=<nom_de_la_configuration>] [ADVANCE=<avance_de_pression>] [SMOOTH_TIME=<dur\u00e9e_adoucissemt_avance_de_pression>] : D\u00e9finit les param\u00e8tres d'avance de pression du moteur d'extrudeuse (comme d\u00e9fini dans une section de configuration extrudeur ou extruder_stepper ). Si EXTRUDER n'est pas sp\u00e9cifi\u00e9, il s'agit par d\u00e9faut du stepper d\u00e9fini dans la t\u00eate d'outil active. SET_EXTRUDER_ROTATION_DISTANCE \u00b6 SET_EXTRUDER_ROTATION_DISTANCE EXTRUDER=<nom_config> [DISTANCE=<distance>] : D\u00e9finit une nouvelle valeur pour la \"distance de rotation\" du moteur de l'extrudeuse fournie (telle que d\u00e9finie dans une section de configuration extruder ou extruder_stepper ). Si la distance de rotation est un nombre n\u00e9gatif, le mouvement du moteur sera invers\u00e9 (par rapport \u00e0 la direction du moteur sp\u00e9cifi\u00e9e dans le fichier de configuration). Les param\u00e8tres modifi\u00e9s ne sont pas conserv\u00e9s lors de la r\u00e9initialisation de Klipper. Utilisez avec pr\u00e9caution car de petites modifications peuvent entra\u00eener une pression excessive entre l'extrudeuse et la t\u00eate de l'outil. Effectuez un calibrage correct avec le filament avant de l'utiliser. Si la valeur 'DISTANCE' n'est pas fournie, cette commande renvoie la distance de rotation actuelle. SYNC_EXTRUDER_MOTION \u00b6 SYNC_EXTRUDER_MOTION EXTRUDER=<nom> MOTION_QUEUE=<nom> : Cette commande permet de synchroniser le moteur d'entra\u00eenement sp\u00e9cifi\u00e9 par EXTRUDER (tel que d\u00e9fini dans la section de configuration extruder ou extruder_stepper avec le mouvement d'un extrudeur sp\u00e9cifi\u00e9 par MOTION_QUEUE (tel que d\u00e9fini dans la section de configuration extruder ). Si MOTION_QUEUE est une cha\u00eene vide, le stepper sera d\u00e9synchronis\u00e9 de tout mouvement d'extrudeuse. SET_EXTRUDER_STEP_DISTANCE \u00b6 Cette commande est obsol\u00e8te et sera supprim\u00e9e dans un avenir proche. SYNC_STEPPER_TO_EXTRUDER \u00b6 Cette commande est obsol\u00e8te et sera supprim\u00e9e dans un avenir proche. [fan_generic] \u00b6 La commande suivante est disponible lorsqu'une section fan_generic config est activ\u00e9e. SET_FAN_SPEED \u00b6 SET_FAN_SPEED FAN=nom_config SPEED=<vitesse> Cette commande d\u00e9finit la vitesse d'un ventilateur. La valeur de \"vitesse\" doit \u00eatre comprise entre 0,0 et 1,0. [filament_switch_sensor] \u00b6 La commande suivante est disponible lorsqu'une section de configuration filament_switch_sensor ou filament_motion_sensor est activ\u00e9e. QUERY_FILAMENT_SENSOR \u00b6 QUERY_FILAMENT_SENSOR SENSOR=<nom_du_capteur> : Interroge l'\u00e9tat actuel du capteur de filament. Les donn\u00e9es affich\u00e9es sur le terminal d\u00e9pendront du type de capteur d\u00e9fini dans la configuration. SET_FILAMENT_SENSOR \u00b6 SET_FILAMENT_SENSOR SENSOR=<nom_du_capteur> ENABLE=[0|1] : Active/d\u00e9sactive le d\u00e9tecteur de filament. Si ENABLE est r\u00e9gl\u00e9 sur 0, le d\u00e9tecteur de filament est d\u00e9sactiv\u00e9, s'il est r\u00e9gl\u00e9 sur 1, il est activ\u00e9. [firmware_retraction] \u00b6 Les commandes G-Code standard suivantes sont disponibles lorsque la section de configuration firmware_retraction est activ\u00e9e. Ces commandes vous permettent d'utiliser la fonction de r\u00e9traction du micrologiciel disponible dans de nombreux trancheurs, afin de r\u00e9duire le cordage pendant les d\u00e9placements sans extrusion d'une partie de l'impression \u00e0 une autre. Une configuration appropri\u00e9e de l'avance \u00e0 la pression r\u00e9duit la longueur de r\u00e9traction requise. G10 : R\u00e9tracte l'extrudeur en utilisant les param\u00e8tres actuellement configur\u00e9s. G11 : D\u00e9tache l'extrudeur en utilisant les param\u00e8tres actuellement configur\u00e9s. Les commandes suppl\u00e9mentaires suivantes sont \u00e9galement disponibles. SET_RETRACTION \u00b6 SET_RETRACTION [RETRACT_LENGTH=<mm>] [RETRACT_SPEED=<mm/s>] [UNRETRACT_EXTRA_LENGTH=<mm>] [UNRETRACT_SPEED=<mm/s>] : Ajuste les param\u00e8tres utilis\u00e9s par la r\u00e9traction du micrologiciel. RETRACT_LENGTH d\u00e9termine la longueur de filament \u00e0 r\u00e9tracter et \u00e0 d\u00e9r\u00e9tracter. La vitesse de r\u00e9traction est ajust\u00e9e via RETRACT_SPEED, et est g\u00e9n\u00e9ralement r\u00e9gl\u00e9e relativement haut. La vitesse de d\u00e9stratification est ajust\u00e9e via UNRETRACT_SPEED, et n'est pas particuli\u00e8rement critique, bien que souvent inf\u00e9rieure \u00e0 RETRACT_SPEED. Dans certains cas, il est utile d'ajouter une petite quantit\u00e9 de longueur suppl\u00e9mentaire lors de la d\u00e9r\u00e9traction, et ceci est r\u00e9gl\u00e9 via UNRETRACT_EXTRA_LENGTH. SET_RETRACTION est g\u00e9n\u00e9ralement d\u00e9fini dans le cadre de la configuration du slicer par filament, car les diff\u00e9rents filaments n\u00e9cessitent des param\u00e8tres diff\u00e9rents. GET_RETRACTION \u00b6 GET_RETRACTION : Interroge les param\u00e8tres actuellement utilis\u00e9s pour la r\u00e9traction du firmware et les affiche sur le terminal. [force_move] \u00b6 Le module force_move est automatiquement charg\u00e9, mais certaines commandes n\u00e9cessitent de d\u00e9finir enable_force_move dans la configuration de l'imprimante . STEPPER_BUZZ \u00b6 STEPPER_BUZZ STEPPER=<nom_de_la_configuration> : D\u00e9place le moteur donn\u00e9 en avant d'un mm puis en arri\u00e8re d'un mm, r\u00e9p\u00e9t\u00e9 10 fois. Il s'agit d'un outil de diagnostic permettant de v\u00e9rifier la connectivit\u00e9 du moteur. FORCE_MOVE \u00b6 FORCE_MOVE STEPPER=<nom_de_la_configuration> DISTANCE=<valeur> VELOCITE=<valeur> [ACCEL=<valeur>] : Cette commande forcera le d\u00e9placement du stepper donn\u00e9 sur la distance donn\u00e9e (en mm) \u00e0 la vitesse constante donn\u00e9e (en mm/s). Si ACCEL est sp\u00e9cifi\u00e9 et est sup\u00e9rieur \u00e0 z\u00e9ro, alors l'acc\u00e9l\u00e9ration donn\u00e9e (en mm/s^2) sera utilis\u00e9e ; sinon, aucune acc\u00e9l\u00e9ration n'est effectu\u00e9e. Aucune v\u00e9rification des limites n'est effectu\u00e9e ; aucune mise \u00e0 jour cin\u00e9matique n'est faite ; les autres steppers parall\u00e8les sur un axe ne seront pas d\u00e9plac\u00e9s. Soyez prudent car une commande incorrecte pourrait endommager le mat\u00e9riel ! L'utilisation de cette commande placera presque certainement la cin\u00e9matique de bas niveau dans un \u00e9tat incorrect ; \u00e9mettez ensuite un G28 pour r\u00e9initialiser la cin\u00e9matique. Cette commande est destin\u00e9e aux diagnostics de bas niveau et au d\u00e9bogage. SET_KINEMATIC_POSITION \u00b6 SET_KINEMATIC_POSITION [X=<value>] [Y=<value>] [Z=<value>] : Force le code cin\u00e9matique de bas niveau \u00e0 croire que la t\u00eate d'outil est \u00e0 la position cart\u00e9sienne donn\u00e9e. Il s'agit d'une commande de diagnostic et de d\u00e9bogage ; utilisez SET_GCODE_OFFSET et/ou G92 pour des transformations d'axe r\u00e9guli\u00e8res. Si un axe n'est pas sp\u00e9cifi\u00e9, la position par d\u00e9faut sera celle de la derni\u00e8re commande de la t\u00eate. La d\u00e9finition d'une position incorrecte ou invalide peut entra\u00eener des erreurs logicielles internes. Cette commande peut invalider les futures v\u00e9rifications de limites ; \u00e9mettez ensuite un G28 pour r\u00e9initialiser la cin\u00e9matique. [gcode] \u00b6 Le module gcode est automatiquement charg\u00e9. RESTART \u00b6 RESTART : Cette commande permet au logiciel h\u00f4te de recharger sa configuration et d'effectuer une r\u00e9initialisation interne. Cette commande n'efface pas l'\u00e9tat d'erreur du micro-contr\u00f4leur (voir FIRMWARE_RESTART) et ne charge pas de nouveau logiciel (voir la FAQ ). FIRMWARE_RESTART \u00b6 FIRMWARE_RESTART : Cette commande est similaire \u00e0 un RESTART, mais elle efface \u00e9galement tout \u00e9tat d'erreur du micro-contr\u00f4leur. STATUS \u00b6 STATUS : Indique l'\u00e9tat du logiciel de l'h\u00f4te Klipper. HELP \u00b6 HELP : Affiche la liste des commandes G-Code \u00e9tendues disponibles. [gcode_arcs] \u00b6 Les commandes G-Code standard suivantes sont disponibles si une section gcode_arcs config est activ\u00e9e : D\u00e9placement d'un arc dans le sens des aiguilles d'une montre (G2), d\u00e9placement d'un arc dans le sens inverse des aiguilles d'une montre (G3) : G2|G3 [X<pos>] [Y<pos>] [Z<pos>] [E<pos>] [F<speed>] I<value> J<value>|I<value> K<value>|J<value> K<value> S\u00e9lection du plan de l'arc : G17 (plan XY), G18 (plan XZ), G19 (plan YZ) [gcode_macro] \u00b6 La commande suivante est disponible lorsqu'une section de configuration gcode_macro est activ\u00e9e (voir \u00e9galement le guide des mod\u00e8les de commande ). SET_GCODE_VARIABLE \u00b6 SET_GCODE_VARIABLE MACRO=<macro_name> VARIABLE=<name> VALUE=<value> : Cette commande permet de changer la valeur d'une variable gcode_macro au moment de l'ex\u00e9cution. La valeur fournie est analys\u00e9e comme un litt\u00e9ral Python. [gcode_move] \u00b6 Le module gcode_move est automatiquement charg\u00e9. GET_POSITION \u00b6 GET_POSITION : Retourne les informations de l'emplacement actuel de la t\u00eate d'outil. Voir la documentation du d\u00e9veloppeur de restitution de GET_POSITION pour plus d'informations. SET_GCODE_OFFSET \u00b6 SET_GCODE_OFFSET [X=<pos>|X_ADJUST=<adjust>] [Y=<pos>|Y_ADJUST=<adjust>] [Z=<pos>|Z_ADJUST=<adjust>] [MOVE=1 [MOVE_SPEED=<speed>]] : D\u00e9finit un d\u00e9calage positionnel \u00e0 appliquer aux futures commandes G-Code. Ceci est g\u00e9n\u00e9ralement utilis\u00e9 pour changer virtuellement le d\u00e9calage Z du bed ou pour d\u00e9finir les d\u00e9calages XY des buses lors du changement d'extrudeur. Par exemple, si \"SET_GCODE_OFFSET Z=0.2\" est donn\u00e9, les prochains mouvements G-Code auront 0,2mm ajout\u00e9 \u00e0 leur hauteur Z. Si les param\u00e8tres de style X_ADJUST sont utilis\u00e9s, l'ajustement sera ajout\u00e9 \u00e0 tout d\u00e9calage existant (par exemple, \"SET_GCODE_OFFSET Z=-0.2\" suivi de \"SET_GCODE_OFFSET Z_ADJUST=0.3\" donnerait un d\u00e9calage Z total de 0.1). Si \"MOVE=1\" est sp\u00e9cifi\u00e9, un d\u00e9placement de la t\u00eate d'outil sera effectu\u00e9 pour appliquer le d\u00e9calage donn\u00e9 (sinon le d\u00e9calage prendra effet lors du prochain d\u00e9placement absolu en G-code qui sp\u00e9cifie l'axe donn\u00e9). Si \"MOVE_SPEED\" est sp\u00e9cifi\u00e9, le d\u00e9placement de la t\u00eate d'outil sera effectu\u00e9 avec la vitesse donn\u00e9e (en mm/s) ; sinon, le d\u00e9placement de la t\u00eate d'outil utilisera la derni\u00e8re vitesse G-Code sp\u00e9cifi\u00e9e. SAVE_GCODE_STATE \u00b6 SAVE_GCODE_STATE [NAME=<nom_de_l'\u00e9tat>] : Sauvegarde l'\u00e9tat actuel de l'analyse des coordonn\u00e9es du g-code. La sauvegarde et le r\u00e9tablissement de l'\u00e9tat du g-code sont utiles dans les scripts et les macros. Cette commande enregistre le mode actuel de coordonn\u00e9es absolues en g-code (G90/G91), le mode d'extrusion absolue (M82/M83), l'origine (G92), le d\u00e9calage (SET_GCODE_OFFSET), la priorit\u00e9 de vitesse (M220), la priorit\u00e9 d'extrusion (M221), la vitesse de d\u00e9placement, la position XYZ actuelle et la position relative de l'extrudeuse \"E\". Si NOM est fourni, cela permet de nommer l'\u00e9tat sauvegard\u00e9 avec la cha\u00eene de caract\u00e8res donn\u00e9e. Si le NOM n'est pas fourni, la valeur par d\u00e9faut est \"default\". RESTORE_GCODE_STATE \u00b6 RESTORE_GCODE_STATE [NAME=<nom_de_l'\u00e9tat>] [MOVE=1 [MOVE_SPEED=<speed>]] : Restaure un \u00e9tat pr\u00e9c\u00e9demment sauvegard\u00e9 via SAVE_GCODE_STATE. Si \"MOVE=1\" est sp\u00e9cifi\u00e9, un d\u00e9placement de la t\u00eate d'outil sera effectu\u00e9 pour revenir \u00e0 la position XYZ pr\u00e9c\u00e9dente. Si \"MOVE_SPEED\" est sp\u00e9cifi\u00e9, alors le d\u00e9placement de la t\u00eate d'outil sera effectu\u00e9 avec la vitesse donn\u00e9e (en mm/s) ; sinon, le d\u00e9placement de la t\u00eate d'outil utilisera la vitesse du G-Code restaur\u00e9. [hall_filament_width_sensor] \u00b6 Les commandes suivantes sont disponibles lorsque la section de configuration tsl1401cl filament width sensor ou hall filament width sensor est activ\u00e9e (voir \u00e9galement TSLl401CL Filament Width Sensor et Hall Filament Width Sensor ) : QUERY_FILAMENT_WIDTH \u00b6 QUERY_FILAMENT_WIDTH : Renvoie la largeur actuelle du filament mesur\u00e9. RESET_FILAMENT_WIDTH_SENSOR \u00b6 RESET_FILAMENT_WIDTH_SENSOR : Efface toutes les lectures du capteur. Utile apr\u00e8s un changement de filament. DISABLE_FILAMENT_WIDTH_SENSOR \u00b6 DISABLE_FILAMENT_WIDTH_SENSOR : D\u00e9sactiver le capteur de largeur de filament et arr\u00eater de l'utiliser pour le contr\u00f4le du flux. ENABLE_FILAMENT_WIDTH_SENSOR \u00b6 ENABLE_FILAMENT_WIDTH_SENSOR : Activez le capteur de largeur de filament et commencez \u00e0 l'utiliser pour le contr\u00f4le du flux. QUERY_RAW_FILAMENT_WIDTH \u00b6 QUERY_RAW_FILAMENT_WIDTH : Renvoie les lectures actuelles des canaux ADC et la valeur RAW du capteur des points de calibration. ENABLE_FILAMENT_WIDTH_LOG \u00b6 ENABLE_FILAMENT_WIDTH_LOG : Activer la journalisation du diam\u00e8tre. DISABLE_FILAMENT_WIDTH_LOG \u00b6 DISABLE_FILAMENT_WIDTH_LOG : D\u00e9sactiver la journalisation du diam\u00e8tre. [heaters] \u00b6 Le module chauffages est automatiquement charg\u00e9 si un chauffage est d\u00e9fini dans le fichier de configuration. TURN_OFF_HEATERS \u00b6 TURN_OFF_HEATERS : \u00c9teindre tous les chauffages. TEMPERATURE_WAIT \u00b6 TEMPERATURE_WAIT SENSOR=<nom_config> [MINIMUM=<cible>] [MAXIMUM=<cible>] : Attend jusqu'\u00e0 ce que le capteur de temp\u00e9rature donn\u00e9 soit \u00e0 ou au-dessus du MINIMUM fourni et/ou \u00e0 ou en dessous du MAXIMUM fourni. SET_HEATER_TEMPERATURE \u00b6 SET_HEATER_TEMPERATURE HEATER=<nom_du_chauffeur> [TARGET=<temp\u00e9rature_cible>] : D\u00e9finit la temp\u00e9rature cible d'un \u00e9l\u00e9ment chauffant. Si une temp\u00e9rature cible n'est pas fournie, la cible est 0. [idle_timeout] \u00b6 Le module idle_timeout est automatiquement charg\u00e9. SET_IDLE_TIMEOUT \u00b6 SET_IDLE_TIMEOUT [TIMEOUT=<timeout>] : Permet \u00e0 l'utilisateur de d\u00e9finir le d\u00e9lai d'inactivit\u00e9 (en secondes). [input_shaper] \u00b6 La commande suivante est activ\u00e9e si une section de configuration input_shaper a \u00e9t\u00e9 activ\u00e9e (voir \u00e9galement le guide de compensation de r\u00e9sonance ). SET_INPUT_SHAPER \u00b6 SET_INPUT_SHAPER [SHAPER_FREQ_X=<shaper_freq_x>] [SHAPER_FREQ_Y=<shaper_freq_y>] [DAMPING_RATIO_X=<damping_ratio_x>] [DAMPING_RATIO_Y=<damping_ratio_y>] [SHAPER_TYPE=<shaper>] [SHAPER_TYPE_X=<shaper_type_x>] [SHAPER_TYPE_Y=<shaper_type_y>] : Modifie les param\u00e8tres de mise en forme d'entr\u00e9e. Notez que le param\u00e8tre SHAPER_TYPE r\u00e9initialise le shaper d'entr\u00e9e pour les axes X et Y m\u00eame si diff\u00e9rents types de shaper ont \u00e9t\u00e9 configur\u00e9s dans la section [input_shaper]. SHAPER_TYPE ne peut pas \u00eatre utilis\u00e9 avec l'un des param\u00e8tres SHAPER_TYPE_X et SHAPER_TYPE_Y. Voir config reference pour plus de d\u00e9tails sur chacun de ces param\u00e8tres. [manual_probe] \u00b6 Le module manual_probe est automatiquement charg\u00e9. MANUAL_PROBE \u00b6 MANUAL_PROBE [SPEED=<speed>] : Ex\u00e9cute un script d'aide servant \u00e0 mesurer la hauteur de la buse \u00e0 un point donn\u00e9. Si SPEED est sp\u00e9cifi\u00e9, il d\u00e9finit la vitesse des commandes TESTZ (la valeur par d\u00e9faut est 5mm/s). Pendant un sondage manuel, les commandes suppl\u00e9mentaires suivantes sont disponibles : ACCEPT : Cette commande valide la position Z actuelle et met fin au sondage manuel. ABORT : Cette commande interrompt le sondage manuel. TESTZ Z=<valeur> : Cette commande d\u00e9place la buse vers le haut ou vers le bas de la quantit\u00e9 sp\u00e9cifi\u00e9e dans \"valeur\". Par exemple, TESTZ Z=-.1 d\u00e9placera la buse vers le bas de 0,1mm tandis que TESTZ Z=.1 d\u00e9placera la buse vers le haut de 0,1mm. La valeur peut \u00e9galement \u00eatre + , - , ++ , ou -- pour d\u00e9placer la buse vers le haut ou vers le bas d'une quantit\u00e9 relative aux tentatives pr\u00e9c\u00e9dentes. Z_ENDSTOP_CALIBRATE \u00b6 Z_ENDSTOP_CALIBRATE [SPEED=<vitesse>] : Ex\u00e9cute un script d'assistance utile pour calibrer un param\u00e8tre de configuration de la position Z_endstop. Voir la commande MANUAL_PROBE pour plus de d\u00e9tails sur les param\u00e8tres et les commandes suppl\u00e9mentaires disponibles lorsque l'outil est actif. Z_OFFSET_APPLY_ENDSTOP \u00b6 Z_OFFSET_APPLY_ENDSTOP : Prend le d\u00e9calage actuel du Gcode Z (alias, babystepping), et le soustrait de la position endstop_position d\u00e9finie dans stepper_z. Ceci permet de prendre une valeur de babystepping fr\u00e9quemment utilis\u00e9e, et de la rendre permanente. N\u00e9cessite un SAVE_CONFIG pour prendre effet. [manual_stepper] \u00b6 La commande suivante est disponible lorsqu'une section manual_stepper config est activ\u00e9e. MANUAL_STEPPER \u00b6 MANUAL_STEPPER STEPPER=nom_du_config [ENABLE=[0|1]]] [SET_POSITION=<pos>] [SPEED=<speed>] [ACCEL=<accel>] [MOVE=<pos> [STOP_ON_ENDSTOP=[1|2|-1|-2]] [SYNC=0]] : Cette commande modifie l'\u00e9tat du stepper. Utilisez le param\u00e8tre ENABLE pour activer/d\u00e9sactiver le stepper. Utilisez le param\u00e8tre SET_POSITION pour forcer le moteur pas \u00e0 pas \u00e0 penser qu'il se trouve \u00e0 la position donn\u00e9e. Utilisez le param\u00e8tre MOVE pour d\u00e9placer vers la position donn\u00e9e. Si SPEED et/ou ACCEL sont sp\u00e9cifi\u00e9s, les valeurs donn\u00e9es seront utilis\u00e9es \u00e0 la place de celles par d\u00e9faut issues du fichier de configuration. Si un ACCEL de z\u00e9ro est sp\u00e9cifi\u00e9, aucune acc\u00e9l\u00e9ration ne sera effectu\u00e9e. Si STOP_ON_ENDSTOP=1 est sp\u00e9cifi\u00e9, le d\u00e9placement se terminera pr\u00e9matur\u00e9ment si la fin de course est d\u00e9clench\u00e9e (utilisez STOP_ON_ENDSTOP=2 pour terminer le d\u00e9placement sans erreur m\u00eame si la fin de course n'est pas d\u00e9clench\u00e9e, utilisez -1 ou -2 pour s'arr\u00eater lorsque la fin de course n'est pas d\u00e9clench\u00e9e). Normalement, les futures commandes G-Code seront programm\u00e9es pour \u00eatre ex\u00e9cut\u00e9es apr\u00e8s la fin du d\u00e9placement de la commande de pas, mais si un d\u00e9placement manuel de la commande de pas utilise SYNC=0, les futures commandes de d\u00e9placement G-Code peuvent \u00eatre ex\u00e9cut\u00e9es en parall\u00e8le avec le d\u00e9placement de la commande de pas. [mcp4018] \u00b6 La commande suivante est disponible lorsqu'une section mcp4018 config est activ\u00e9e. SET_DIGIPOT \u00b6 SET_DIGIPOT DIGIPOT=config_name WIPER=<valeur> : Cette commande change la valeur actuelle du digipot. Cette valeur devrait typiquement \u00eatre comprise entre 0.0 et 1.0, \u00e0 moins qu'une '\u00e9chelle' soit d\u00e9finie dans la configuration. Lorsque 'scale' est d\u00e9fini, alors cette valeur doit \u00eatre comprise entre 0.0 et 'scale'. [led] \u00b6 La commande suivante est disponible lorsque l'une des sections led config est activ\u00e9e. SET_LED \u00b6 SET_LED LED=<nom_de_la_configuration> RED=<valeur> GREEN=<valeur> BLUE=<valeur> WHITE=<valeur> [INDEX=<index>] [TRANSMIT=0] [SYNC=1] : Ceci d\u00e9finit la sortie de la LED. Chaque <valeur> de couleur doit \u00eatre comprise entre 0.0 et 1.0. L'option WHITE n'est valable que pour les LEDs RGBW. Si la LED supporte plusieurs puces dans une cha\u00eene, on peut sp\u00e9cifier INDEX pour modifier la couleur de la seule puce donn\u00e9e (1 pour la premi\u00e8re puce, 2 pour la seconde, etc.). Si INDEX n'est pas sp\u00e9cifi\u00e9, alors toutes les LEDs de la cha\u00eene seront r\u00e9gl\u00e9es sur la couleur fournie. Si TRANSMIT=0 est sp\u00e9cifi\u00e9, le changement de couleur ne sera effectu\u00e9 que lors de la prochaine commande SET_LED qui ne sp\u00e9cifie pas TRANSMIT=0 ; cela peut \u00eatre utile en combinaison avec le param\u00e8tre INDEX pour effectuer plusieurs mises \u00e0 jour dans une cha\u00eene. Par d\u00e9faut, la commande SET_LED synchronisera ses changements avec les autres commandes gcode en cours. Cela peut conduire \u00e0 un comportement ind\u00e9sirable si les LEDs sont r\u00e9gl\u00e9es alors que l'imprimante n'imprime pas, car cela r\u00e9initialisera le d\u00e9lai d'inactivit\u00e9. Si un timing pr\u00e9cis n'est pas n\u00e9cessaire, le param\u00e8tre optionnel SYNC=0 peut \u00eatre sp\u00e9cifi\u00e9 pour appliquer les changements sans r\u00e9initialiser le d\u00e9lai d'inactivit\u00e9. SET_LED_TEMPLATE \u00b6 SET_LED_TEMPLATE LED=<nom_de_la_led> TEMPLATE=<nom_du_mod\u00e8le> [<param_x>=<literal>] [INDEX=<index>] : Attribue un mod\u00e8le d'affichage \u00e0 une LED donn\u00e9e. Par exemple, si l'on d\u00e9finit une section de configuration [display_template my_led_template] , on peut affecter TEMPLATE=my_led_template ici. Le mod\u00e8le d'affichage doit produire une cha\u00eene de caract\u00e8res s\u00e9par\u00e9e par des virgules contenant quatre nombres \u00e0 virgule flottante correspondant aux param\u00e8tres de couleur rouge, vert, bleu et blanc. Le mod\u00e8le sera continuellement \u00e9valu\u00e9 et la LED sera automatiquement r\u00e9gl\u00e9e sur les couleurs r\u00e9sultantes. On peut d\u00e9finir des param\u00e8tres display_template \u00e0 utiliser pendant l'\u00e9valuation du mod\u00e8le (les param\u00e8tres seront analys\u00e9s comme des litt\u00e9raux Python). Si INDEX n'est pas sp\u00e9cifi\u00e9, alors toutes les puces dans la cha\u00eene de la LED seront r\u00e9gl\u00e9es sur le mod\u00e8le, sinon seule la puce avec l'index donn\u00e9 sera mise \u00e0 jour. Si TEMPLATE est une cha\u00eene vide, cette commande effacera tout mod\u00e8le pr\u00e9c\u00e9dent assign\u00e9 \u00e0 la LED (on peut alors utiliser les commandes SET_LED pour g\u00e9rer les param\u00e8tres de couleur de la LED). [output_pin] \u00b6 La commande suivante est disponible lorsqu'une section output_pin config est activ\u00e9e. SET_PIN \u00b6 SET_PIN PIN=config_name VALUE=<value> [CYCLE_TIME=<cycle_time>] : Set the pin to the given output VALUE . VALUE should be 0 or 1 for \"digital\" output pins. For PWM pins, set to a value between 0.0 and 1.0, or between 0.0 and scale if a scale is configured in the output_pin config section. Some pins (currently only \"soft PWM\" pins) support setting an explicit cycle time using the CYCLE_TIME parameter (specified in seconds). Note that the CYCLE_TIME parameter is not stored between SET_PIN commands (any SET_PIN command without an explicit CYCLE_TIME parameter will use the cycle_time specified in the output_pin config section). [palette2] \u00b6 Les commandes suivantes sont disponibles lorsque la section palette2 config est activ\u00e9e. Les impressions avec Palette fonctionnent en int\u00e9grant des OCodes (Omega Codes) sp\u00e9ciaux dans le fichier GCode : O1 ... O32 : Ces codes sont lus \u00e0 partir du flux GCode, trait\u00e9s par ce module et transmis au dispositif Palette 2. Les commandes suppl\u00e9mentaires suivantes sont \u00e9galement disponibles. PALETTE_CONNECT \u00b6 PALETTE_CONNECT : Cette commande initie la connexion avec Palette 2. PALETTE_DISCONNECT \u00b6 PALETTE_DISCONNECT : Cette commande permet de se d\u00e9connecter de Palette 2. PALETTE_CLEAR \u00b6 PALETTE_CLEAR : Cette commande demande \u00e0 Palette 2 de purger le filament de tous les chemins d'entr\u00e9e et de sortie. PALETTE_CUT \u00b6 PALETTE_CUT : Cette commande demande \u00e0 Palette 2 de couper le filament actuellement charg\u00e9 dans le noyau de jonction. PALETTE_SMART_LOAD \u00b6 PALETTE_SMART_LOAD : cette commande initialise la s\u00e9quence de chargement intelligente sur Palette 2. Le filament est charg\u00e9 automatiquement en l\u2019extrudant sur la distance calibr\u00e9e sur l\u2019appareil pour l\u2019imprimante, et l'indique \u00e0 Palette 2 une fois le chargement termin\u00e9. Cette commande revient \u00e0 appuyer sur Smart Load directement sur l\u2019\u00e9cran Palette 2 une fois l'insertion du filament faite. [pid_calibrate] \u00b6 Le module pid_calibrate est automatiquement charg\u00e9 si un chauffage est d\u00e9fini dans le fichier de configuration. PID_CALIBRATE \u00b6 PID_CALIBRATE HEATER=<config_name> TARGET=<temperature> [WRITE_FILE=1] : Effectuer un test d\u2019\u00e9talonnage PID. Le chauffage demand\u00e9 sera activ\u00e9 jusqu\u2019\u00e0 ce que la temp\u00e9rature d\u00e9finie soit atteinte, il s'\u00e9teindra et se rallumera durant plusieurs cycles. Si le param\u00e8tre WRITE_FILE est activ\u00e9, le fichier /tmp/heattest.txt sera cr\u00e9\u00e9 avec un journal de tous les \u00e9chantillons de temp\u00e9rature mesur\u00e9s pendant le test. [pause_resume] \u00b6 Les commandes suivantes sont disponibles lorsque la section pause_resume config est activ\u00e9e : PAUSE \u00b6 PAUSE : suspend l\u2019impression en cours. La position actuelle est enregistr\u00e9e pour reprendre lorsque demand\u00e9. RESUME \u00b6 RESUME [VELOCITY=<value>] : Reprend l'impression \u00e0 la suite d'une pause, en r\u00e9tablissant d'abord la position captur\u00e9e pr\u00e9c\u00e9demment. Le param\u00e8tre VELOCITY d\u00e9termine la vitesse \u00e0 laquelle l'outil doit revenir \u00e0 la position captur\u00e9e d'origine. CLEAR_PAUSE \u00b6 CLEAR_PAUSE : Supprime la mise en pause actuelle sans reprendre l'impression. Ceci est utile si l'on d\u00e9cide d'interrompre une impression apr\u00e8s une PAUSE. Il est recommand\u00e9 d'ajouter ceci \u00e0 votre gcode de d\u00e9marrage pour s'assurer que l'\u00e9tat de pause est r\u00e9initialis\u00e9 pour chaque impression. CANCEL_PRINT \u00b6 CANCEL_PRINT : Annule l'impression en cours. [print_stats] \u00b6 Le module print_stats est automatiquement charg\u00e9. SET_PRINT_STATS_INFO \u00b6 SET_PRINT_STATS_INFO [TOTAL_LAYER=<nombre_total_de_couches>] [CURRENT_LAYER= <couche_actuelle>] : Passe les informations du trancheur comme le nombre total de couches et celle actuellement en cours \u00e0 Klipper. Ajoutez SET_PRINT_STATS_INFO [TOTAL_LAYER=<nombre_total_de_couches>] \u00e0 votre section gcode de d\u00e9but du trancheur et SET_PRINT_STATS_INFO [CURRENT_LAYER= <couche_actuelle>] \u00e0 la section gcode de changement de couche pour passer les informations de couche de votre trancheur \u00e0 Klipper. [probe] \u00b6 Les commandes suivantes sont disponibles lorsqu'une section probe config ou bltouch config est activ\u00e9e (voir \u00e9galement le guide d'\u00e9talonnage de la sonde ). PROBE \u00b6 PROBE [PROBE_SPEED=<mm/s>] [LIFT_SPEED=<mm/s>] [SAMPLES=<count>] [SAMPLE_RETRACT_DIST=<mm>] [SAMPLES_TOLERANCE=<mm>] [SAMPLES_TOLERANCE_RETRIES=<count>] [SAMPLES_RESULT=median|average] : D\u00e9place la buse vers le bas jusqu'\u00e0 ce que le palpeur se d\u00e9clenche. Si l'un des param\u00e8tres facultatifs est fourni, il remplace son param\u00e8tre \u00e9quivalent dans la section configuration de la sonde . QUERY_PROBE \u00b6 QUERY_PROBE : Retourne l'\u00e9tat actuel de la sonde (\"triggered\" ou \"open\"). PROBE_ACCURACY \u00b6 PROBE_ACCURACY [PROBE_SPEED=<mm/s>] [SAMPLES=<count>] [SAMPLE_RETRACT_DIST=<mm>] : Calculer le maximum, le minimum, la moyenne, la m\u00e9diane et l\u2019\u00e9cart type des \u00e9chantillons des multiples palpeurs. Par d\u00e9faut, 10 \u00c9CHANTILLONS sont pr\u00e9lev\u00e9s. Sinon, les param\u00e8tres optionnels peuvent \u00eatre d\u00e9finis dans la section de configuration du palpeur. PROBE_CALIBRATE \u00b6 PROBE_CALIBRATE [SPEED=<speed>] [<probe_parameter>=<value>] : Ex\u00e9cute l'assistant servant \u00e0 calibrer le z_offset du palpeur. Consultez la commande PROBE pour plus d\u2019informations sur les param\u00e8tres optionnels du palpeur. Reportez-vous \u00e0 la commande MANUAL_PROBE pour plus d\u2019informations sur le param\u00e8tre SPEED et les commandes suppl\u00e9mentaires disponibles lorsque l'assistant est actif. Veuillez noter que la commande PROBE_CALIBRATE utilise la variable de vitesse pour se d\u00e9placer dans la direction XY ainsi que dans Z. Z_OFFSET_APPLY_PROBE \u00b6 Z_OFFSET_APPLY_PROBE : Prend le d\u00e9calage actuel du Gcode Z (alias, babystepping), et le soustrait du z_offset de la sonde. Cela permet de prendre une valeur de babystepping fr\u00e9quemment utilis\u00e9e, et de la rendre permanente. N\u00e9cessite un SAVE_CONFIG pour prendre effet. [query_adc] \u00b6 Le module query_adc est automatiquement charg\u00e9. QUERY_ADC \u00b6 QUERY_ADC [NAME=<nom_de_la_configuration>] [PULLUP=<valeur>] : Rapporte la derni\u00e8re valeur analogique re\u00e7ue pour une broche analogique donn\u00e9e. Si NAME n'est pas fourni, la liste des noms d'adc disponibles est retourn\u00e9e. Si PULLUP est fourni (comme une valeur en Ohms), la valeur analogique brute ainsi que la r\u00e9sistance \u00e9quivalente relative \u00e0 ce pullup est retourn\u00e9e. [query_endstops] \u00b6 Le module query_endstops est automatiquement charg\u00e9. Les commandes G-Code standard suivantes sont actuellement disponibles, mais leur utilisation n'est pas recommand\u00e9e : Obtenir le statut Fin de course : M119 (Utilisez QUERY_ENDSTOPS \u00e0 la place.) QUERY_ENDSTOPS \u00b6 QUERY_ENDSTOPS : Teste les but\u00e9es d'axe et indique si elles sont \"d\u00e9clench\u00e9es\" ou dans un \u00e9tat \"ouvert\". Cette commande est g\u00e9n\u00e9ralement utilis\u00e9e pour v\u00e9rifier qu'un butoir de fin de course fonctionne correctement. [resonance_tester] \u00b6 Les commandes suivantes sont disponibles lorsqu'une section configuration du testeur de r\u00e9sonances est activ\u00e9e (voir \u00e9galement le guide de mesure des r\u00e9sonances ). MEASURE_AXES_NOISE \u00b6 MEASURE_AXES_NOISE : Mesure et affiche le bruit pour tous les axes de toutes les puces acc\u00e9l\u00e9rom\u00e9triques activ\u00e9es. TEST_RESONANCES \u00b6 TEST_RESONANCES AXE=<axe> OUTPUT=<resonances,raw_data> [NOM=<nom>] [FREQ_START=<freq_min>] [FREQ_END=<freq_max>] [HZ_PER_SEC=<hz_par_sec>] [CHIPS=<nom_puce_adxl345>] [POINT=x,y,z] [INPUT_SHAPING=[<0:1>]] : Ex\u00e9cute le test de r\u00e9sonance dans tous les points de sonde configur\u00e9s pour l'\"axe\" demand\u00e9 et mesure l'acc\u00e9l\u00e9ration en utilisant les puces acc\u00e9l\u00e9rom\u00e9tres configur\u00e9es pour l'axe respectif. L'\"axe\" peut \u00eatre X ou Y, ou sp\u00e9cifier une direction arbitraire comme AXIS=dx,dy , o\u00f9 dx et dy sont des nombres \u00e0 virgule flottante d\u00e9finissant un vecteur de direction (par exemple, AXIS=X , AXIS=Y , ou AXIS=1,-1 pour d\u00e9finir une direction diagonale). Notez que AXIS=dx,dy et AXIS=-dx,-dy sont \u00e9quivalents. nom_puce_adxl345 peut \u00eatre une ou plusieurs puces adxl345 configur\u00e9es, d\u00e9limit\u00e9es par des virgules, par exemple CHIPS=\"adxl345, adxl345 rpi\" . Notez que le terme adxl345 peut \u00eatre omis pour les puces adxl345 nomm\u00e9es. Si POINT est indiqu\u00e9, il remplacera le(s) point(s) configur\u00e9(s) dans [resonance_tester] . Si INPUT_SHAPING=0 ou non d\u00e9fini (par d\u00e9faut), d\u00e9sactive la mise en forme de l'entr\u00e9e pour le test de r\u00e9sonance, car il n'est pas valide d'ex\u00e9cuter le test de r\u00e9sonance avec la mise en forme de l'entr\u00e9e active. Le param\u00e8tre OUTPUT consiste en une liste s\u00e9par\u00e9e par des virgules des sorties qui seront \u00e9crites. Si raw_data est demand\u00e9, alors les donn\u00e9es brutes de l'acc\u00e9l\u00e9rom\u00e8tre sont \u00e9crites dans un fichier ou une s\u00e9rie de fichiers /tmp/raw_data_<axe>_[<nom_puce>_][<point>_]<nom>.csv avec (la partie <point>_ du nom g\u00e9n\u00e9r\u00e9e seulement si plus d'un point de sonde est configur\u00e9 ou si POINT est sp\u00e9cifi\u00e9). Si resonances est sp\u00e9cifi\u00e9, la r\u00e9ponse en fr\u00e9quence est calcul\u00e9e (\u00e0 travers tous les points de sonde) et \u00e9crite dans le fichier /tmp/resonances_<axe>_<nom>.csv . S'il n'est pas d\u00e9fini, OUTPUT prend par d\u00e9faut la valeur de resonances , et NAME prend par d\u00e9faut la valeur de l'heure actuelle au format \"AAAAMMJJ_HHMMSS\". SHAPER_CALIBRATE \u00b6 SHAPER_CALIBRATE [AXIS=<axe>] [NAME=<nom>] [FREQ_START=<freq_min>] [FREQ_END=<freq_max>] [HZ_PER_SEC=<hz_par_sec>] [MAX_SMOOTHING=<adoucissement_max>] : Comme TEST_RESONANCES , ex\u00e9cute le test de r\u00e9sonance tel que configur\u00e9, et essaie de trouver les param\u00e8tres optimaux pour le fa\u00e7onneur d'entr\u00e9e pour l'axe demand\u00e9 (ou les deux axes X et Y si le param\u00e8tre AXIS est d\u00e9sactiv\u00e9). Si MAX_SMOOTHING n'est pas d\u00e9fini, sa valeur est reprise de la section [resonance_tester] , la valeur par d\u00e9faut \u00e9tant non d\u00e9finie. Voir le Max smoothing du guide de la mesure des r\u00e9sonances pour plus d'informations sur l'utilisation de cette fonctionnalit\u00e9. Les r\u00e9sultats de l\u2019\u00e9talonnage sont imprim\u00e9s sur la console, les r\u00e9ponses en fr\u00e9quence et les diff\u00e9rentes valeurs des fa\u00e7onneurs d'entr\u00e9e sont \u00e9crites dans un ou plusieurs fichiers CSV /tmp/calibration_data_<axe>_<nom>.csv . Sauf si sp\u00e9cifi\u00e9, NOM est par d\u00e9faut l'heure actuelle au format \"AAAAMMJJ_HHMMSS\". Notez que les param\u00e8tres de mise en forme d'entr\u00e9e sugg\u00e9r\u00e9s peuvent \u00eatre conserv\u00e9s dans la configuration en \u00e9mettant la commande SAVE_CONFIG . [respond] \u00b6 Les commandes G-Code standard suivantes sont disponibles lorsque la section respond config est activ\u00e9e : M118 <message> : affiche le message pr\u00e9c\u00e9d\u00e9 du pr\u00e9fixe par d\u00e9faut configur\u00e9 (ou echo : si aucun pr\u00e9fixe n'est configur\u00e9). Les commandes suppl\u00e9mentaires suivantes sont \u00e9galement disponibles. RESPOND \u00b6 RESPOND MSG=\"<message>\" : Affiche le message pr\u00e9c\u00e9d\u00e9 du pr\u00e9fixe par d\u00e9faut configur\u00e9 (ou echo : si aucun pr\u00e9fixe n'est configur\u00e9). RESPOND TYPE=echo MSG=\"<message>\" : affiche le message pr\u00e9c\u00e9d\u00e9 par echo : . RESPOND TYPE=echo_no_space MSG=\"<message>\" : renvoie le message pr\u00e9c\u00e9d\u00e9 de echo: sans espace entre le pr\u00e9fixe et le message, utile pour la compatibilit\u00e9 avec certains plugins octoprint qui attendent un formatage tr\u00e8s sp\u00e9cifique. RESPOND TYPE=command MSG=\"<message>\" : renvoie le message pr\u00e9c\u00e9d\u00e9 de // . OctoPrint peut \u00eatre configur\u00e9 pour r\u00e9pondre \u00e0 ces messages (par exemple, RESPOND TYPE=command MSG=action:pause ). RESPOND TYPE=error MSG=\"<message>\" : affiche le message pr\u00e9c\u00e9d\u00e9 par !!! . RESPOND PREFIX=<prefix> MSG=\"<message>\" : renvoie le message pr\u00e9c\u00e9d\u00e9 de <prefix> . (Le param\u00e8tre PREFIX est prioritaire sur le param\u00e8tre TYPE ). [save_variables] \u00b6 La commande suivante est activ\u00e9e si une section save_variables config a \u00e9t\u00e9 activ\u00e9e. SAVE_VARIABLE \u00b6 SAVE_VARIABLE VARIABLE=<nom> VALUE=<valeur> : Enregistre la variable sur le disque afin qu'elle puisse \u00eatre utilis\u00e9e lors des red\u00e9marrages. Toutes les variables enregistr\u00e9es sont charg\u00e9es dans le dict printer.save_variables.variables au d\u00e9marrage et peuvent \u00eatre utilis\u00e9es dans des macros gcode. La VALEUR fournie est analys\u00e9e comme un litt\u00e9ral Python. [screws_tilt_adjust] \u00b6 Les commandes suivantes sont disponibles lorsque la section de configuration screws_tilt_adjust est activ\u00e9e (voir \u00e9galement le guide du nivelage manuel ). SCREWS_TILT_CALCULATE \u00b6 SCREWS_TILT_CALCULATE [DIRECTION=CW|CCW] [MAX_DEVIATION=<valeur>] [<probe_parameter>=<valeur>] : Cette commande invoquera l'outil de r\u00e9glage des vis du lit. Elle d\u00e9placera la buse \u00e0 diff\u00e9rents endroits (tels que d\u00e9finis dans le fichier de configuration) en palpant la hauteur z et calculera le nombre de tours de la molette de r\u00e9glage pour ajuster le niveau du lit. Si DIRECTION est sp\u00e9cifi\u00e9, les tours de la molette seront tous dans la m\u00eame direction, dans le sens des aiguilles d'une montre (CW) ou dans le sens inverse (CCW). Voir la commande PROBE pour plus de d\u00e9tails sur les param\u00e8tres optionnels de la sonde. IMPORTANT : Vous DEVEZ toujours effectuer un G28 avant d'utiliser cette commande. Si MAX_DEVIATION est sp\u00e9cifi\u00e9, la commande d\u00e9clenchera une erreur de gcode si une diff\u00e9rence de hauteur de vis par rapport \u00e0 la hauteur de vis de base est sup\u00e9rieure \u00e0 la valeur fournie. [sdcard_loop] \u00b6 Lorsque la section de configuration sdcard_loop est activ\u00e9e, les commandes \u00e9tendues suivantes sont disponibles. SDCARD_LOOP_BEGIN \u00b6 SDCARD_LOOP_BEGIN COUNT=<compte> : Commence une section boucl\u00e9e dans l'impression SD. Un compte de 0 indique que la section doit \u00eatre boucl\u00e9e ind\u00e9finiment. SDCARD_LOOP_END \u00b6 SDCARD_LOOP_END : Termine une section de boucle dans l'impression SD. SDCARD_LOOP_DESIST \u00b6 SDCARD_LOOP_DESIST : Termine les boucles existantes sans autres it\u00e9rations. [servo] \u00b6 Les commandes suivantes sont disponibles lorsqu'une section servo config est activ\u00e9e. SET_SERVO \u00b6 SET_SERVO SERVO=nom_config [ANGLE=<degr\u00e9s> | LARGEUR=<secondes>] : D\u00e9finit la position du servo \u00e0 l'angle (en degr\u00e9s) ou \u00e0 la largeur d'impulsion (en secondes) donn\u00e9s. Utilisez WIDTH=0 pour d\u00e9sactiver la sortie du servo. [skew_correction] \u00b6 Les commandes suivantes sont disponibles lorsque la section de configuration skew_correction est activ\u00e9e (voir \u00e9galement le guide Skew Correction ). SET_SKEW \u00b6 SET_SKEW [XY=<ac_length,bd_length,ad_length>] [XZ=<ac,bd,ad>] [YZ=<ac,bd,ad>] [CLEAR=<0|1>] : Configure le module [skew_correction] avec des mesures (en mm) prises \u00e0 partir d'une impression d'\u00e9talonnage. On peut entrer des mesures pour n'importe quelle combinaison de plans, les plans non entr\u00e9s conserveront leur valeur actuelle. Si CLEAR=1 est entr\u00e9, toute correction d'inclinaison sera d\u00e9sactiv\u00e9e. GET_CURRENT_SKEW \u00b6 GET_CURRENT_SKEW : Indique l'inclinaison actuelle de l'imprimante pour chaque plan en radians et en degr\u00e9s. L'inclinaison est calcul\u00e9e en fonction des param\u00e8tres fournis par le gcode SET_SKEW . CALC_MEASURED_SKEW \u00b6 CALC_MEASURED_SKEW [AC=<ac_length>] [BD=<bd_length>] [AD=<ad_length>] : Calcule et rapporte l'inclinaison (en radians et en degr\u00e9s) bas\u00e9e sur une impression mesur\u00e9e. Cela peut \u00eatre utile pour d\u00e9terminer l'inclinaison actuelle de l'imprimante apr\u00e8s l'application de la correction. Elle peut \u00e9galement \u00eatre utile avant l'application de la correction pour d\u00e9terminer si une correction de l'inclinaison est n\u00e9cessaire. Reportez-vous \u00e0 la section [Correction de l'obliquit\u00e9] (Skew_Correction.md) pour plus de d\u00e9tails sur les objets et les mesures de calibrage de l'obliquit\u00e9. SKEW_PROFILE \u00b6 SKEW_PROFILE [LOAD=<nom>] [SAVE=<nom>] [REMOVE=<nom>] : Gestion des profils pour la correction de l'obliquit\u00e9. LOAD restaurera l'\u00e9tat d'inclinaison \u00e0 partir du profil correspondant au nom fourni. SAVE sauvegardera l'\u00e9tat actuel d'inclinaison dans un profil correspondant au nom fourni. Remove supprimera le profil correspondant au nom fourni de la m\u00e9moire persistante. Notez qu'apr\u00e8s l'ex\u00e9cution des op\u00e9rations SAVE ou REMOVE, le gcode SAVE_CONFIG doit \u00eatre ex\u00e9cut\u00e9 pour que les modifications apport\u00e9es \u00e0 la m\u00e9moire permanente deviennent permanentes. [smart_effector] \u00b6 Plusieurs commandes sont disponibles lorsqu'une section de configuration smart_effector est activ\u00e9e. Assurez-vous de consulter la documentation officielle du Smart Effector sur le Duet3D Wiki avant de modifier les param\u00e8tres du Smart Effector. Consultez \u00e9galement le guide d'\u00e9talonnage de la sonde . SET_SMART_EFFECTOR \u00b6 SET_SMART_EFFECTOR [SENSITIVITY=<sensitivity>] [ACCEL=<accel>] [RECOVERY_TIME=<time>] : D\u00e9finit les param\u00e8tres du Smart Effector. Lorsque SENSITIVITY est sp\u00e9cifi\u00e9, la valeur respective est \u00e9crite dans l'EEPROM du SmartEffecteur (n\u00e9cessite que control_pin soit fourni). Les valeurs acceptables de <sensitivity> sont 0..255, la valeur par d\u00e9faut est 50. Des valeurs plus faibles n\u00e9cessitent moins de force de contact de la buse pour se d\u00e9clencher (mais il y a un plus grand risque de faux d\u00e9clenchement d\u00fb aux vibrations pendant le palpage), des valeurs plus \u00e9lev\u00e9es r\u00e9duisent les faux d\u00e9clenchements (mais n\u00e9cessitent une plus grande force de contact pour se d\u00e9clencher). Comme la sensibilit\u00e9 est \u00e9crite dans l'EEPROM, elle est conserv\u00e9e apr\u00e8s l'arr\u00eat, il n'est donc pas n\u00e9cessaire de la configurer \u00e0 chaque d\u00e9marrage de l'imprimante. ACCEL et RECOVERY_TIME permettent de modifier les param\u00e8tres correspondants lors de l'ex\u00e9cution, voir la section config de Smart Effector pour plus d'informations sur ces param\u00e8tres. RESET_SMART_EFFECTOR \u00b6 RESET_SMART_EFFECTOR : R\u00e9initialise la sensibilit\u00e9 du Smart Effector \u00e0 ses param\u00e8tres d'usine. N\u00e9cessite que control_pin soit fourni dans la section de configuration. [stepper_enable] \u00b6 Le module stepper_enable est automatiquement charg\u00e9. SET_STEPPER_ENABLE \u00b6 SET_STEPPER_ENABLE STEPPER=<nom_de_la_configuration> ENABLE=[0|1] : Active ou d\u00e9sactive uniquement le stepper donn\u00e9. Il s'agit d'un outil de diagnostic et de d\u00e9bogage qui doit donc \u00eatre utilis\u00e9 avec pr\u00e9caution. La d\u00e9sactivation d'un moteur d'axe ne r\u00e9initialise pas les informations d'orientation. Le d\u00e9placement manuel d'un moteur pas \u00e0 pas d\u00e9sactiv\u00e9 peut amener la machine \u00e0 faire fonctionner le moteur en dehors des limites de s\u00e9curit\u00e9. Cela peut entra\u00eener des dommages aux composants de l'axe, aux extr\u00e9mit\u00e9s chaudes et \u00e0 la surface d'impression. [temperature_fan] \u00b6 La commande suivante est disponible lorsqu'une section temperature_fan config est activ\u00e9e. SET_TEMPERATURE_FAN_TARGET \u00b6 SET_TEMPERATURE_FAN_TARGET temperature_fan=<nom_du_ventilateur_temp\u00e9rature> [target=<temp\u00e9rature_cible>] [min_speed=<vitesse_min>] [max_speed=<vitesse_max>] : D\u00e9finit la temp\u00e9rature cible d'un ventilateur_temp\u00e9rature. Si une cible n'est pas fournie, elle est fix\u00e9e \u00e0 la temp\u00e9rature sp\u00e9cifi\u00e9e dans le fichier de configuration. Si les vitesses ne sont pas fournies, aucun changement n'est appliqu\u00e9. [tmcXXXX] \u00b6 Les commandes suivantes sont disponibles lorsque l'une des sections tmcXXXX config est activ\u00e9e. DUMP_TMC \u00b6 DUMP_TMC STEPPER=<nom> : Cette commande lit les registres du pilote TMC et renvoie leurs valeurs. INIT_TMC \u00b6 INIT_TMC STEPPER=<nom> : Cette commande initialise les registres de la puce TMC. N\u00e9cessaire pour r\u00e9activer le pilote si l'alimentation de la puce est coup\u00e9e puis r\u00e9tablie. SET_TMC_CURRENT \u00b6 SET_TMC_CURRENT STEPPER=<nom> CURRENT=<amps> HOLDCURRENT=<amps> : Ceci ajustera les courants de marche et de maintien du pilote TMC. (HOLDCURRENT n'est pas applicable aux pilotes tmc2660). SET_TMC_FIELD \u00b6 SET_TMC_FIELD STEPPER=<nom> FIELD=<champ> VALUE=<valeur> : Cette commande modifie la valeur du champ de registre sp\u00e9cifi\u00e9 du pilote TMC. Cette commande est destin\u00e9e aux diagnostics de bas niveau et au d\u00e9bogage uniquement car la modification des champs pendant l'ex\u00e9cution peut entra\u00eener un comportement ind\u00e9sirable et potentiellement dangereux de votre imprimante. Les modifications permanentes doivent \u00eatre effectu\u00e9es \u00e0 l'aide du fichier de configuration de l'imprimante. Aucun contr\u00f4le d'int\u00e9grit\u00e9 n'est effectu\u00e9 pour les valeurs donn\u00e9es. [toolhead] \u00b6 Le module de t\u00eate d'outil est automatiquement charg\u00e9. SET_VELOCITY_LIMIT \u00b6 SET_VELOCITY_LIMIT [VELOCITY=<valeur>] [ACCEL=<valeur>] [ACCEL_TO_DECEL=<valeur>] [SQUARE_CORNER_VELOCITY=<valeur>] : Modifie les limites de v\u00e9locit\u00e9 de l'imprimante. [tuning_tower] \u00b6 Le module tuning_tower est automatiquement charg\u00e9. TUNING_TOWER \u00b6 TUNING_TOWER COMMAND=<commande> PARAMETER=<nom> START=<valeur> [SKIP=<valeur>] [FACTOR=<valeur> [BAND=<valeur>]]. | [STEP_DELTA=<valeur> STEP_HEIGHT=<valeur>] : Un outil pour affiner un param\u00e8tre sur chaque hauteur Z pendant une impression. L'outil ex\u00e9cutera la COMMANDE donn\u00e9e avec le PARAM\u00c8TRE donn\u00e9 assign\u00e9 \u00e0 une valeur qui varie avec Z selon une formule. Utilisez FACTOR si vous allez utiliser une r\u00e8gle ou un pied \u00e0 coulisse pour mesurer la hauteur Z de la valeur optimale, ou STEP_DELTA et STEP_HEIGHT si le mod\u00e8le de tour de r\u00e9glage a des bandes de valeurs discr\u00e8tes comme c'est le cas avec les tours de temp\u00e9rature. Si SKIP=<valeur> est sp\u00e9cifi\u00e9, le processus de r\u00e9glage ne commence pas avant que la hauteur Z <valeur> soit atteinte, et en dessous, la valeur sera mise \u00e0 START ; dans ce cas, la z_height utilis\u00e9e dans les formules ci-dessous est en fait max(z - skip, 0) . Il y a trois combinaisons possibles d'options : FACTOR : La valeur change \u00e0 un taux de factor par millim\u00e8tre. La formule utilis\u00e9e est : valeur = start + factor * z_height . Vous pouvez ins\u00e9rer la hauteur Z optimale directement dans la formule pour d\u00e9terminer la valeur optimale du param\u00e8tre. FACTOR and BAND : La valeur change \u00e0 un taux moyen de factor par millim\u00e8tre, mais dans des bandes discr\u00e8tes o\u00f9 l'ajustement ne sera fait que tous les BAND millim\u00e8tres de hauteur Z. La formule utilis\u00e9e est : valeur =start + factor * ((floor(z_height / band) + .5) * band) . STEP_DELTA et STEP_HEIGHT : La valeur change de STEP_DELTA tous les millim\u00e8tres de STEP_HEIGHT . La formule utilis\u00e9e est : valeur = start + step_delta * floor(z_height / step_height) . Vous pouvez simplement compter les bandes ou lire les \u00e9tiquettes des tours de r\u00e9glage pour d\u00e9terminer la valeur optimale. [virtual_sdcard] \u00b6 Klipper prend en charge les commandes G-Code standards suivantes si la section de configuration virtual_sdcard est activ\u00e9e : Liste des cartes SD : M20 Initialiser la carte SD : M21 S\u00e9lectionnez le fichier SD : M23 <nom du fichier> D\u00e9marrer/reprendre l'impression SD : M24 Suspendre l'impression depuis la SD : M25 D\u00e9finir la position SD : M26 S<d\u00e9calage> Afficher l'\u00e9tat d'impression depuis la carte SD : M27 En outre, les commandes \u00e9tendues suivantes sont disponibles lorsque la section de configuration \"virtual_sdcard\" est activ\u00e9e. SDCARD_PRINT_FILE \u00b6 SDCARD_PRINT_FILE FILENAME=<nom_fichier> : Charge un fichier et lance l'impression SD. SDCARD_RESET_FILE \u00b6 SDCARD_RESET_FILE : D\u00e9charge le fichier et efface l'\u00e9tat de la carte SD. [z_thermal_adjust] \u00b6 Les commandes suivantes sont disponibles lorsque la section z_thermal_adjust config est activ\u00e9e. SET_Z_THERMAL_ADJUST \u00b6 SET_Z_THERMAL_ADJUST [ENABLE=<0:1>] [TEMP_COEFF=<valeur>] [REF_TEMP=<valeur>] : Active ou d\u00e9sactive l'ajustement thermique Z avec ENABLE . La d\u00e9sactivation ne supprime pas l'ajustement d\u00e9j\u00e0 appliqu\u00e9, mais g\u00e8le la valeur d'ajustement actuelle - cela emp\u00eache un mouvement Z vers le bas potentiellement dangereux. La r\u00e9activation peut potentiellement causer un mouvement de l'outil vers le haut lorsque l'ajustement est mis \u00e0 jour et appliqu\u00e9. TEMP_COEFF permet de r\u00e9gler le coefficient de temp\u00e9rature de l'ajustement en cours d'ex\u00e9cution (c'est-\u00e0-dire le param\u00e8tre de configuration TEMP_COEFF ). Les valeurs de TEMP_COEFF ne sont pas sauvegard\u00e9es dans la config. REF_TEMP remplace manuellement la temp\u00e9rature de r\u00e9f\u00e9rence g\u00e9n\u00e9ralement r\u00e9gl\u00e9e pendant le retour \u00e0 l'origine (pour une utilisation dans des routines de retour \u00e0 l'origine non standard) - sera remis \u00e0 z\u00e9ro automatiquement lors du retour \u00e0 l'origine. [z_tilt] \u00b6 Les commandes suivantes sont disponibles lorsque la section z_tilt config est activ\u00e9e. Z_TILT_ADJUST \u00b6 Z_TILT_ADJUST [<probe_parameter>=<valeur>] : Cette commande palpe les points sp\u00e9cifi\u00e9s dans la configuration et effectue ensuite des ajustements ind\u00e9pendants pour chaque moteur Z afin de compenser l'inclinaison. Reportez-vous \u00e0 la commande PROBE pour plus de d\u00e9tails sur les param\u00e8tres de palpage optionnels.","title":"G-Codes"},{"location":"G-Codes.html#g-codes","text":"Ce document d\u00e9crit les commandes que Klipper supporte. Il s'agit de commandes que l'on peut saisir dans l'onglet du terminal OctoPrint.","title":"G-Codes"},{"location":"G-Codes.html#commandes-g-code","text":"Klipper prend en charge les commandes G-Code standard suivantes : Move (G0 ou G1): G1 [X<pos>] [Y<pos>] [Z<pos>] [E<pos>] [F<speed>] Temporisation : G4 P<millisecondes> D\u00e9placement vers l'origine : G28 [X] [Y] [Z] \u00c9teindre les moteurs : M18 ou M84 Attendre la fin des mouvements en cours : M400 Utiliser des distances absolues/relatives pour l'extrusion : M82 , M83 Utiliser des coordonn\u00e9es absolues/relatives : G90 , G91 D\u00e9finir la position : G92 [X<pos>] [Y<pos>] [Z<pos>] [E<pos>] D\u00e9finir le pourcentage de neutralisation du facteur de vitesse : M220 S<percent> D\u00e9finit le pourcentage d'annulation du facteur d'extrusion : M221 S<percent> R\u00e9gler l'acc\u00e9l\u00e9ration : M204 S<valeur> OU M204 P<valeur> T<valeur> Remarque : si S n'est pas sp\u00e9cifi\u00e9 et que P et T le sont, l'acc\u00e9l\u00e9ration sera r\u00e9gl\u00e9e sur le minimum de P et T. Si un seul P ou T est donn\u00e9, la commande n'aura aucun effet. Obtenir la temp\u00e9rature de l'extrudeur : M105 R\u00e9gler la temp\u00e9rature de l'extrudeur : M104 [T<index>] [S<temp\u00e9rature>] R\u00e9gler la temp\u00e9rature de l'extrudeur et attendre : M109 [T<index>] S<temp\u00e9rature> Note : M109 attendra toujours que la temp\u00e9rature se stabilise \u00e0 la valeur demand\u00e9e. R\u00e9gler la temp\u00e9rature du bed : M140 [S<temperature>] R\u00e9gler la temp\u00e9rature du bed et attendre : M190 S<temperature> Note : M190 attendra toujours que la temp\u00e9rature se stabilise \u00e0 la valeur demand\u00e9e. R\u00e9gler la vitesse du ventilateur : M106 S<valeur> D\u00e9sactiver le ventilateur : M107 Arr\u00eat d'urgence : M112 Obtenir la position actuelle : M114 Obtenir la version du firmware : M115 Pour plus de d\u00e9tails sur les commandes ci-dessus, voir la [documentation RepRap G-Code] ( http://reprap.org/wiki/G-code ). L'objectif de Klipper est de prendre en charge les commandes G-Code produites par les logiciels tiers courants (par exemple, OctoPrint, Printrun, Slic3r, Cura, etc.) dans leurs configurations standards. Le but n'est pas de prendre en charge toutes les commandes G-Code possibles. Au contraire, Klipper pr\u00e9f\u00e8re les [\"commandes G-Code \u00e9tendues\"] (#additional-commands) humainement lisibles. De la m\u00eame mani\u00e8re, la sortie du terminal G-Code est uniquement destin\u00e9e \u00e0 \u00eatre humainement lisible - voir le document du serveur API si vous contr\u00f4lez Klipper depuis un logiciel externe. Si vous avez besoin d'une commande G-Code moins courante, il est possible de l'impl\u00e9menter avec une section de configuration gcode_macro personnalis\u00e9e . Par exemple, on peut utiliser ceci pour impl\u00e9menter : G12 , G29 , G30 , G31 , M42 , M80 , M81 , T1 , etc.","title":"Commandes G-Code"},{"location":"G-Codes.html#commandes-additionnelles","text":"Klipper utilise des commandes G-Code \"\u00e9tendues\" pour la configuration g\u00e9n\u00e9rale et l'\u00e9tat. Ces commandes \u00e9tendues suivent toutes un format similaire : elles commencent par le nom de la commande et peuvent \u00eatre suivies d'un ou plusieurs param\u00e8tres. Par exemple : SET_SERVO SERVO=myservo ANGLE=5.3 . Dans ce document, les commandes et les param\u00e8tres sont indiqu\u00e9s en majuscules, mais ils ne sont pas sensibles \u00e0 la casse. (Ainsi, \"SET_SERVO\" et \"set_servo\" ex\u00e9cuteront tous deux la m\u00eame commande). Cette section est organis\u00e9e par nom de module Klipper, en suivant g\u00e9n\u00e9ralement les noms de section sp\u00e9cifi\u00e9s dans le fichier de configuration de l'imprimante . Notez que certains modules sont automatiquement charg\u00e9s.","title":"Commandes additionnelles"},{"location":"G-Codes.html#adxl345","text":"Les commandes suivantes sont disponibles lorsqu'une section adxl345 config est activ\u00e9e.","title":"[adxl345]"},{"location":"G-Codes.html#accelerometer_measure","text":"ACCELEROMETER_MEASURE [CHIP=<nom_de_la_configuration>] [NAME=<valeur>] : D\u00e9marre les mesures de l'acc\u00e9l\u00e9rom\u00e8tre au nombre d'\u00e9chantillons par seconde demand\u00e9. Si CHIP n'est pas pr\u00e9cis\u00e9, la valeur par d\u00e9faut est \"adxl345\". La commande fonctionne en mode start-stop : ex\u00e9cut\u00e9e pour la premi\u00e8re fois, elle d\u00e9marre les mesures, l'ex\u00e9cution suivante les arr\u00eate. Les r\u00e9sultats des mesures sont \u00e9crits dans un fichier nomm\u00e9 /tmp/adxl345-<chip>-<nom>.csv o\u00f9 <chip> est le nom de la puce acc\u00e9l\u00e9rom\u00e8tre ( my_chip_name de [adxl345 my_chip_name] ) et <nom> est le param\u00e8tre optionnel NAME. Si le param\u00e8tre NOM n'est pas pr\u00e9cis\u00e9, l'heure actuelle est utilis\u00e9e par d\u00e9faut au format \"AAAAMMJJ_HHMMSS\". Si l'acc\u00e9l\u00e9rom\u00e8tre n'a pas de nom dans sa section de configuration (simplement [adxl345] ) alors la partie <chip> du nom n'est pas g\u00e9n\u00e9r\u00e9e.","title":"ACCELEROMETER_MEASURE"},{"location":"G-Codes.html#accelerometer_query","text":"ACCELEROMETER_QUERY [CHIP=<nom_de_la_configuration>] [RATE=<valeur>] : interroge l'acc\u00e9l\u00e9rom\u00e8tre pour la valeur courante. Si CHIP n'est pas pr\u00e9cis\u00e9, la valeur par d\u00e9faut est \"adxl345\". Si RATE n'est pas pr\u00e9cis\u00e9, la valeur par d\u00e9faut est utilis\u00e9e. Cette commande permet de tester la connexion \u00e0 l'acc\u00e9l\u00e9rom\u00e8tre ADXL345 : une des valeurs retourn\u00e9es devrait \u00eatre une acc\u00e9l\u00e9ration en chute libre (+/- un certain bruit de la puce).","title":"ACCELEROMETER_QUERY"},{"location":"G-Codes.html#accelerometer_debug_read","text":"ACCELEROMETER_DEBUG_READ [CHIP=<nom_de_la_configuration>] REG=<registre> : interroge le registre ADXL345 \"registre\" (par exemple 44 ou 0x2C). Peut \u00eatre utile \u00e0 des fins de d\u00e9bogage.","title":"ACCELEROMETER_DEBUG_READ"},{"location":"G-Codes.html#accelerometer_debug_write","text":"ACCELEROMETER_DEBUG_WRITE [CHIP=<nom_de_la_configuration>] REG=<registre> VAL=<valeur> : Ecrit la \"valeur\" brute dans le registre \"registre\". La \"valeur\" et le \"registre\" peuvent \u00eatre des entiers d\u00e9cimaux ou hexad\u00e9cimaux. A utiliser avec pr\u00e9caution, et se r\u00e9f\u00e9rer \u00e0 la fiche technique de l'ADXL345 pour la r\u00e9f\u00e9rence.","title":"ACCELEROMETER_DEBUG_WRITE"},{"location":"G-Codes.html#angle","text":"Les commandes suivantes sont disponibles lorsqu'une section angle config est activ\u00e9e.","title":"[angle]"},{"location":"G-Codes.html#angle_calibrate","text":"ANGLE_CALIBRATE CHIP=<nom_de_la_puce> : Effectue une calibration d'angle sur le capteur donn\u00e9 (il doit y avoir une section de configuration [angle nom_de_la_puce] qui a indiqu\u00e9 un param\u00e8tre stepper ). IMPORTANT - cet outil commandera au moteur pas \u00e0 pas de se d\u00e9placer sans v\u00e9rifier les limites normales de la cin\u00e9matique. Id\u00e9alement, le moteur devrait \u00eatre d\u00e9connect\u00e9 de tout chariot d'imprimante avant d'effectuer le calibrage. Si le moteur pas \u00e0 pas ne peut pas \u00eatre d\u00e9connect\u00e9 de l'imprimante, assurez-vous que le chariot est proche du centre de son rail avant de commencer l'\u00e9talonnage. (Le moteur pas \u00e0 pas peut se d\u00e9placer vers l'avant ou l'arri\u00e8re de deux rotations compl\u00e8tes durant ce test). Apr\u00e8s avoir termin\u00e9 ce test, utilisez la commande SAVE_CONFIG pour sauvegarder les donn\u00e9es de calibration dans le fichier de configuration. Afin d'utiliser cet outil, le paquetage Python \"numpy\" doit \u00eatre install\u00e9 (voir le document mesurer les r\u00e9sonances pour plus d'informations).","title":"ANGLE_CALIBRATE"},{"location":"G-Codes.html#angle_debug_read","text":"ANGLE_DEBUG_READ CHIP=<nom_de_la_configuration> REG=<registre> : Interroge le registre \"registre\" du capteur (par exemple 44 ou 0x2C). Peut \u00eatre utile \u00e0 des fins de d\u00e9bogage. Ceci n'est disponible que pour les puces tle5012b.","title":"ANGLE_DEBUG_READ"},{"location":"G-Codes.html#angle_debug_write","text":"ANGLE_DEBUG_WRITE CHIP=<nom_de_la_configuration> REG=<registre> VAL=<valeur> : \u00c9crit la \"valeur\" brute dans le registre \"registre\". La \"valeur\" et le \"registre\" peuvent \u00eatre des entiers d\u00e9cimaux ou hexad\u00e9cimaux. A utiliser avec pr\u00e9caution, et se r\u00e9f\u00e9rer \u00e0 la fiche technique du capteur pour la r\u00e9f\u00e9rence. Cette fonction n'est disponible que pour les puces tle5012b.","title":"ANGLE_DEBUG_WRITE"},{"location":"G-Codes.html#bed_mesh","text":"Les commandes suivantes sont disponibles lorsque la section configuration de bed_mesh est activ\u00e9e (voir \u00e9galement le guide de bed_mesh ).","title":"[bed_mesh]"},{"location":"G-Codes.html#bed_mesh_calibrate","text":"BED_MESH_CALIBRATE [METHOD=manual] [<probe_parameter>=<value>] [<mesh_parameter>=<value>] : Cette commande palpe le bed en utilisant des points g\u00e9n\u00e9r\u00e9s sp\u00e9cifi\u00e9s par les param\u00e8tres de la config. Apr\u00e8s le test, un maillage est g\u00e9n\u00e9r\u00e9 et le d\u00e9placement de l'axe Z est ajust\u00e9 en fonction de celui-ci. R\u00e9f\u00e9rez-vous \u00e0 la commande PROBE pour plus de d\u00e9tails sur les param\u00e8tres optionnels. Si METHOD=manual est sp\u00e9cifi\u00e9, l'outil de palpage manuel est activ\u00e9 - voir la commande MANUAL_PROBE ci-dessus pour plus de d\u00e9tails sur les possibilit\u00e9s suppl\u00e9mentaires disponibles lorsque cet outil est utilis\u00e9.","title":"BED_MESH_CALIBRATE"},{"location":"G-Codes.html#bed_mesh_output","text":"BED_MESH_OUTPUT PGP=[<0:1>] : Cette commande \u00e9crit les valeurs z palp\u00e9es actuelles et les valeurs de maillage actuelles sur le terminal. Si PGP=1 est sp\u00e9cifi\u00e9, les coordonn\u00e9es X, Y g\u00e9n\u00e9r\u00e9es par bed_mesh, ainsi que leurs indices associ\u00e9s, seront envoy\u00e9s au terminal.","title":"BED_MESH_OUTPUT"},{"location":"G-Codes.html#bed_mesh_map","text":"BED_MESH_MAP : Comme pour BED_MESH_OUTPUT, cette commande affiche l'\u00e9tat actuel du maillage sur le terminal. L'\u00e9tat sera retourn\u00e9 au format json. Cela permet aux plugins octoprint de r\u00e9cup\u00e9rer facilement les donn\u00e9es et de g\u00e9n\u00e9rer des cartes d'altitude au plus proche de la surface du bed.","title":"BED_MESH_MAP"},{"location":"G-Codes.html#bed_mesh_clear","text":"BED_MESH_CLEAR : Cette commande efface le maillage actuel et supprime les ajustements de l'axe z. Il est recommand\u00e9 de mettre cette commande dans votre gcode de fin.","title":"BED_MESH_CLEAR"},{"location":"G-Codes.html#bed_mesh_profile","text":"BED_MESH_PROFILE LOAD=<nom> SAVE=<nom> REMOVE=<nom> : Cette commande fournit une gestion de profil pour l'\u00e9tat du maillage. LOAD restaurera l'\u00e9tat du maillage \u00e0 partir du profil correspondant au nom fourni. SAVE sauvegarde l'\u00e9tat du maillage actuel dans un profil correspondant au nom fourni. REMOVE supprimera le profil correspondant au nom fourni de la m\u00e9moire persistante. Notez qu'apr\u00e8s l'ex\u00e9cution des op\u00e9rations SAVE ou REMOVE, le gcode SAVE_CONFIG doit \u00eatre ex\u00e9cut\u00e9 pour rendre les changements de la m\u00e9moire persistante permanents.","title":"BED_MESH_PROFILE"},{"location":"G-Codes.html#bed_mesh_offset","text":"BED_MESH_OFFSET [X=<value>] [Y=<value>] : Applique des d\u00e9calages X et/ou Y pour l'\u00e9valuation du maillage. Ceci est utile pour les imprimantes avec extrudeurs ind\u00e9pendants, car un d\u00e9calage est n\u00e9cessaire pour obtenir un ajustement Z correct apr\u00e8s un changement d'outil.","title":"BED_MESH_OFFSET"},{"location":"G-Codes.html#bed_screws","text":"Les commandes suivantes sont disponibles lorsque la section config bed_screws est activ\u00e9e (voir \u00e9galement le guide du nivelage manuel ).","title":"[bed_screws]"},{"location":"G-Codes.html#bed_screws_adjust","text":"BED_SCREWS_ADJUST : Cette commande fait appel \u00e0 l'outil de r\u00e9glage des vis du bed. Elle commandera la buse \u00e0 diff\u00e9rents endroits (tels que d\u00e9finis dans le fichier de configuration) et permettra d'ajuster les vis du bed afin que celui-ci et la buse soient \u00e0 distance constante.","title":"BED_SCREWS_ADJUST"},{"location":"G-Codes.html#bed_tilt","text":"Les commandes suivantes sont disponibles lorsque la section config bed_tilt est activ\u00e9e.","title":"[bed_tilt]"},{"location":"G-Codes.html#bed_tilt_calibrate","text":"BED_TILT_CALIBRATE [METHOD=manual] [<probe_parameter>=<value>] : Cette commande teste les points sp\u00e9cifi\u00e9s dans la configuration, puis recommande des ajustements d'inclinaison x et y mis \u00e0 jour. Voir la commande PROBE pour plus de d\u00e9tails sur les param\u00e8tres de palpage optionnels. Si METHOD=manual est sp\u00e9cifi\u00e9, l'outil de palpage manuel est activ\u00e9 - voir la commande MANUAL_PROBE ci-dessus pour plus de d\u00e9tails sur les commandes suppl\u00e9mentaires disponibles lorsque cet outil est actif.","title":"BED_TILT_CALIBRATE"},{"location":"G-Codes.html#bltouch","text":"La commande suivante est disponible lorsqu'une section bltouch config est activ\u00e9e (voir \u00e9galement le Guide BL-Touch ).","title":"[bltouch]"},{"location":"G-Codes.html#bltouch_debug","text":"BLTOUCH_DEBUG COMMAND=<commande> : Ceci envoie une commande au BLTouch. Elle peut \u00eatre utile pour le d\u00e9bogage. Les commandes disponibles sont : pin_down , touch_mode , pin_up , self_test , reset . Un BL-Touch V3.0 ou V3.1 accepte en plus les commandes set_5V_output_mode , set_OD_output_mode , output_mode_store .","title":"BLTOUCH_DEBUG"},{"location":"G-Codes.html#bltouch_store","text":"BLTOUCH_STORE MODE=<output_mode> : Stocke un mode de sortie dans l'EEPROM d'un BLTouch V3.1 Les modes de sortie disponibles sont : 5V , OD","title":"BLTOUCH_STORE"},{"location":"G-Codes.html#configfile","text":"Le module configfile est automatiquement charg\u00e9.","title":"[configfile]"},{"location":"G-Codes.html#save_config","text":"SAVE_CONFIG : Cette commande \u00e9crase le fichier de configuration principal de l'imprimante et red\u00e9marre le logiciel h\u00f4te. Cette commande est utilis\u00e9e conjointement avec d'autres commandes d'\u00e9talonnage pour enregistrer les r\u00e9sultats de ces tests.","title":"SAVE_CONFIG"},{"location":"G-Codes.html#delayed_gcode","text":"La commande suivante est activ\u00e9e si une section de configuration delayed_gcode a \u00e9t\u00e9 activ\u00e9e (voir \u00e9galement le guide des mod\u00e8les ).","title":"[delayed_gcode]"},{"location":"G-Codes.html#update_delayed_gcode","text":"UPDATE_DELAYED_GCODE [ID=<nom>] [DURATION=<secondes>] : Met \u00e0 jour la dur\u00e9e du retard du [delayed_gcode] identifi\u00e9 et d\u00e9marre le minuteur pour l'ex\u00e9cution du gcode. Une valeur de 0 annulera l'ex\u00e9cution d'un gcode retard\u00e9 en attente.","title":"UPDATE_DELAYED_GCODE"},{"location":"G-Codes.html#delta_calibrate","text":"Les commandes suivantes sont disponibles lorsque la section delta_calibrate config est activ\u00e9e (voir \u00e9galement le guide delta calibrate ).","title":"[delta_calibrate]"},{"location":"G-Codes.html#delta_calibrate_1","text":"DELTA_CALIBRATE [METHOD=manual] [<probe_parameter>=<value>] : Cette commande teste sept points sur le lit et recommande des positions de but\u00e9e, des angles de tour et des rayons mis \u00e0 jour. Voir la commande PROBE pour plus de d\u00e9tails sur les param\u00e8tres de palpage optionnels. Si METHOD=manual est sp\u00e9cifi\u00e9, l'outil de palpage manuel est activ\u00e9 - voir la commande MANUAL_PROBE ci-dessus pour plus de d\u00e9tails sur les commandes suppl\u00e9mentaires disponibles lorsque cet outil est actif.","title":"DELTA_CALIBRATE"},{"location":"G-Codes.html#delta_analyze","text":"DELTA_ANALYZE : Cette commande est utilis\u00e9e pendant l'\u00e9talonnage delta am\u00e9lior\u00e9. Voir Calibrage delta pour plus de d\u00e9tails.","title":"DELTA_ANALYZE"},{"location":"G-Codes.html#display","text":"La commande suivante est disponible lorsqu'une section display config est activ\u00e9e.","title":"[display]"},{"location":"G-Codes.html#set_display_group","text":"SET_DISPLAY_GROUP [DISPLAY=<display>] GROUP=<group> : D\u00e9finit le groupe d'affichage actif d'un \u00e9cran LCD. Cela permet de d\u00e9finir plusieurs groupes de donn\u00e9es d'affichage dans la configuration, par exemple [display_data <group> <elementname>] et de passer de l'un \u00e0 l'autre en utilisant cette commande gcode \u00e9tendue. Si DISPLAY n'est pas sp\u00e9cifi\u00e9, la valeur par d\u00e9faut est \"display\" (l'affichage principal).","title":"SET_DISPLAY_GROUP"},{"location":"G-Codes.html#display_status","text":"Le module display_status est automatiquement charg\u00e9 si une section display config est activ\u00e9e. Il fournit les commandes G-Code standard suivantes : Afficher un message : M117 <message> D\u00e9finir le pourcentage de g\u00e9n\u00e9ration : M73 P<pourcentage> La commande G-Code \u00e9tendue suivante est \u00e9galement fournie : SET_DISPLAY_TEXT MSG=<message> : Effectue l'\u00e9quivalent de M117, en d\u00e9finissant le MSG fourni comme le message d'affichage actuel. Si MSG est omis, l'affichage est effac\u00e9.","title":"[display_status]"},{"location":"G-Codes.html#dual_carriage","text":"La commande suivante est disponible lorsque la section config dual_carriage est activ\u00e9e.","title":"[dual_carriage]"},{"location":"G-Codes.html#set_dual_carriage","text":"SET_DUAL_CARRIAGE CARRIAGE=[0|1] : Cette commande d\u00e9finit le chariot actif. Elle est g\u00e9n\u00e9ralement appel\u00e9e \u00e0 partir des champs activate_gcode et deactivate_gcode dans une configuration \u00e0 extrudeurs multiples.","title":"SET_DUAL_CARRIAGE"},{"location":"G-Codes.html#endstop_phase","text":"Les commandes suivantes sont disponibles lorsqu'une section de configuration endstop_phase est activ\u00e9e (voir \u00e9galement le guide de la phase d'arr\u00eat ).","title":"[endstop_phase]"},{"location":"G-Codes.html#endstop_phase_calibrate","text":"ENDSTOP_PHASE_CALIBRATE [STEPPER=<config_name>] : Si aucun param\u00e8tre STEPPER n'est fourni, cette commande rapporte des statistiques sur les phases d'arr\u00eat du stepper pendant les pr\u00e9c\u00e9dentes op\u00e9rations de recherche d'origine. Lorsqu'un param\u00e8tre STEPPER est fourni, elle fait en sorte que le param\u00e8tre de phase de fin de course donn\u00e9 soit \u00e9crit dans le fichier de configuration (en lien avec la commande SAVE_CONFIG).","title":"ENDSTOP_PHASE_CALIBRATE"},{"location":"G-Codes.html#exclude_object","text":"Les commandes suivantes sont disponibles lorsqu'une section de configuration exclude_object est activ\u00e9e (voir \u00e9galement le guide d'exclusion d'objet ) :","title":"[exclude_object]"},{"location":"G-Codes.html#exclude_object_1","text":"EXCLUDE_OBJECT [NAME=nom_objet] [CURRENT=1] [RESET=1] : Sans param\u00e8tres, cette commande renvoie une liste de tous les objets actuellement exclus. Lorsque le param\u00e8tre NAME est donn\u00e9, l'objet nomm\u00e9 sera exclu de l'impression. Lorsque le param\u00e8tre CURRENT est donn\u00e9, l'objet courant sera exclu de l'impression. Lorsque le param\u00e8tre RESET est donn\u00e9, la liste des objets exclus sera effac\u00e9e. De plus, inclure le param\u00e8tre NAME ne r\u00e9initialisera que l'objet nomm\u00e9. Cela peut provoquer des \u00e9checs d'impression, si des couches ont d\u00e9j\u00e0 \u00e9t\u00e9 omises.","title":"EXCLUDE_OBJECT"},{"location":"G-Codes.html#exclude_object_define","text":"EXCLUDE_OBJECT_DEFINE [NAME=nom_objet [CENTER=X,Y] [POLYGON=[[x,y],...]]] [RESET=1] [JSON=1] : Fournit le r\u00e9sum\u00e9 d'un objet dans le fichier. Sans param\u00e8tres fournis, ceci va lister les objets d\u00e9finis connus de Klipper. Retourne une liste de cha\u00eenes de caract\u00e8res, \u00e0 moins que le param\u00e8tre JSON soit donn\u00e9, auquel cas retournera les d\u00e9tails de l'objet au format json. Lorsque le param\u00e8tre NAME est inclus, cela d\u00e9finit un objet \u00e0 exclure. NAME : Ce param\u00e8tre est obligatoire. Il s'agit de l'identifiant utilis\u00e9 par les autres commandes de ce module. CENTER : Une coordonn\u00e9e X,Y pour l'objet. POLYGON : Un tableau de coordonn\u00e9es X,Y fournissant le contour d'un objet. Lorsque le param\u00e8tre RESET est fourni, tous les objets d\u00e9finis seront effac\u00e9s, et le module [exclude_object] sera r\u00e9initialis\u00e9.","title":"EXCLUDE_OBJECT_DEFINE"},{"location":"G-Codes.html#exclude_object_start","text":"EXCLUDE_OBJECT_START NAME=nom_objet : Cette commande prend un param\u00e8tre NAME et indique le d\u00e9but du gcode pour un objet sur la couche courante.","title":"EXCLUDE_OBJECT_START"},{"location":"G-Codes.html#exclude_object_end","text":"EXCLUDE_OBJECT_END [NAME=nom_objet] : Indique la fin du gcode de l'objet pour la couche. Il est associ\u00e9 \u00e0 EXCLUDE_OBJECT_START . Le param\u00e8tre NAME est optionnel, et n'avertira que si le nom fourni ne correspond au nom actuel.","title":"EXCLUDE_OBJECT_END"},{"location":"G-Codes.html#extruder","text":"Les commandes suivantes sont disponibles si une section configuration de l'extrudeuse est activ\u00e9e :","title":"[extruder]"},{"location":"G-Codes.html#activate_extruder","text":"ACTIVATE_EXTRUDER EXTRUDER=<nom_de_la_configuration> : Dans une imprimante comportant plusieurs sections de configuration d' extrudeuse , cette commande s\u00e9lectionne la t\u00eate d'outil active.","title":"ACTIVATE_EXTRUDER"},{"location":"G-Codes.html#set_pressure_advance","text":"SET_PRESSURE_ADVANCE [EXTRUDER=<nom_de_la_configuration>] [ADVANCE=<avance_de_pression>] [SMOOTH_TIME=<dur\u00e9e_adoucissemt_avance_de_pression>] : D\u00e9finit les param\u00e8tres d'avance de pression du moteur d'extrudeuse (comme d\u00e9fini dans une section de configuration extrudeur ou extruder_stepper ). Si EXTRUDER n'est pas sp\u00e9cifi\u00e9, il s'agit par d\u00e9faut du stepper d\u00e9fini dans la t\u00eate d'outil active.","title":"SET_PRESSURE_ADVANCE"},{"location":"G-Codes.html#set_extruder_rotation_distance","text":"SET_EXTRUDER_ROTATION_DISTANCE EXTRUDER=<nom_config> [DISTANCE=<distance>] : D\u00e9finit une nouvelle valeur pour la \"distance de rotation\" du moteur de l'extrudeuse fournie (telle que d\u00e9finie dans une section de configuration extruder ou extruder_stepper ). Si la distance de rotation est un nombre n\u00e9gatif, le mouvement du moteur sera invers\u00e9 (par rapport \u00e0 la direction du moteur sp\u00e9cifi\u00e9e dans le fichier de configuration). Les param\u00e8tres modifi\u00e9s ne sont pas conserv\u00e9s lors de la r\u00e9initialisation de Klipper. Utilisez avec pr\u00e9caution car de petites modifications peuvent entra\u00eener une pression excessive entre l'extrudeuse et la t\u00eate de l'outil. Effectuez un calibrage correct avec le filament avant de l'utiliser. Si la valeur 'DISTANCE' n'est pas fournie, cette commande renvoie la distance de rotation actuelle.","title":"SET_EXTRUDER_ROTATION_DISTANCE"},{"location":"G-Codes.html#sync_extruder_motion","text":"SYNC_EXTRUDER_MOTION EXTRUDER=<nom> MOTION_QUEUE=<nom> : Cette commande permet de synchroniser le moteur d'entra\u00eenement sp\u00e9cifi\u00e9 par EXTRUDER (tel que d\u00e9fini dans la section de configuration extruder ou extruder_stepper avec le mouvement d'un extrudeur sp\u00e9cifi\u00e9 par MOTION_QUEUE (tel que d\u00e9fini dans la section de configuration extruder ). Si MOTION_QUEUE est une cha\u00eene vide, le stepper sera d\u00e9synchronis\u00e9 de tout mouvement d'extrudeuse.","title":"SYNC_EXTRUDER_MOTION"},{"location":"G-Codes.html#set_extruder_step_distance","text":"Cette commande est obsol\u00e8te et sera supprim\u00e9e dans un avenir proche.","title":"SET_EXTRUDER_STEP_DISTANCE"},{"location":"G-Codes.html#sync_stepper_to_extruder","text":"Cette commande est obsol\u00e8te et sera supprim\u00e9e dans un avenir proche.","title":"SYNC_STEPPER_TO_EXTRUDER"},{"location":"G-Codes.html#fan_generic","text":"La commande suivante est disponible lorsqu'une section fan_generic config est activ\u00e9e.","title":"[fan_generic]"},{"location":"G-Codes.html#set_fan_speed","text":"SET_FAN_SPEED FAN=nom_config SPEED=<vitesse> Cette commande d\u00e9finit la vitesse d'un ventilateur. La valeur de \"vitesse\" doit \u00eatre comprise entre 0,0 et 1,0.","title":"SET_FAN_SPEED"},{"location":"G-Codes.html#filament_switch_sensor","text":"La commande suivante est disponible lorsqu'une section de configuration filament_switch_sensor ou filament_motion_sensor est activ\u00e9e.","title":"[filament_switch_sensor]"},{"location":"G-Codes.html#query_filament_sensor","text":"QUERY_FILAMENT_SENSOR SENSOR=<nom_du_capteur> : Interroge l'\u00e9tat actuel du capteur de filament. Les donn\u00e9es affich\u00e9es sur le terminal d\u00e9pendront du type de capteur d\u00e9fini dans la configuration.","title":"QUERY_FILAMENT_SENSOR"},{"location":"G-Codes.html#set_filament_sensor","text":"SET_FILAMENT_SENSOR SENSOR=<nom_du_capteur> ENABLE=[0|1] : Active/d\u00e9sactive le d\u00e9tecteur de filament. Si ENABLE est r\u00e9gl\u00e9 sur 0, le d\u00e9tecteur de filament est d\u00e9sactiv\u00e9, s'il est r\u00e9gl\u00e9 sur 1, il est activ\u00e9.","title":"SET_FILAMENT_SENSOR"},{"location":"G-Codes.html#firmware_retraction","text":"Les commandes G-Code standard suivantes sont disponibles lorsque la section de configuration firmware_retraction est activ\u00e9e. Ces commandes vous permettent d'utiliser la fonction de r\u00e9traction du micrologiciel disponible dans de nombreux trancheurs, afin de r\u00e9duire le cordage pendant les d\u00e9placements sans extrusion d'une partie de l'impression \u00e0 une autre. Une configuration appropri\u00e9e de l'avance \u00e0 la pression r\u00e9duit la longueur de r\u00e9traction requise. G10 : R\u00e9tracte l'extrudeur en utilisant les param\u00e8tres actuellement configur\u00e9s. G11 : D\u00e9tache l'extrudeur en utilisant les param\u00e8tres actuellement configur\u00e9s. Les commandes suppl\u00e9mentaires suivantes sont \u00e9galement disponibles.","title":"[firmware_retraction]"},{"location":"G-Codes.html#set_retraction","text":"SET_RETRACTION [RETRACT_LENGTH=<mm>] [RETRACT_SPEED=<mm/s>] [UNRETRACT_EXTRA_LENGTH=<mm>] [UNRETRACT_SPEED=<mm/s>] : Ajuste les param\u00e8tres utilis\u00e9s par la r\u00e9traction du micrologiciel. RETRACT_LENGTH d\u00e9termine la longueur de filament \u00e0 r\u00e9tracter et \u00e0 d\u00e9r\u00e9tracter. La vitesse de r\u00e9traction est ajust\u00e9e via RETRACT_SPEED, et est g\u00e9n\u00e9ralement r\u00e9gl\u00e9e relativement haut. La vitesse de d\u00e9stratification est ajust\u00e9e via UNRETRACT_SPEED, et n'est pas particuli\u00e8rement critique, bien que souvent inf\u00e9rieure \u00e0 RETRACT_SPEED. Dans certains cas, il est utile d'ajouter une petite quantit\u00e9 de longueur suppl\u00e9mentaire lors de la d\u00e9r\u00e9traction, et ceci est r\u00e9gl\u00e9 via UNRETRACT_EXTRA_LENGTH. SET_RETRACTION est g\u00e9n\u00e9ralement d\u00e9fini dans le cadre de la configuration du slicer par filament, car les diff\u00e9rents filaments n\u00e9cessitent des param\u00e8tres diff\u00e9rents.","title":"SET_RETRACTION"},{"location":"G-Codes.html#get_retraction","text":"GET_RETRACTION : Interroge les param\u00e8tres actuellement utilis\u00e9s pour la r\u00e9traction du firmware et les affiche sur le terminal.","title":"GET_RETRACTION"},{"location":"G-Codes.html#force_move","text":"Le module force_move est automatiquement charg\u00e9, mais certaines commandes n\u00e9cessitent de d\u00e9finir enable_force_move dans la configuration de l'imprimante .","title":"[force_move]"},{"location":"G-Codes.html#stepper_buzz","text":"STEPPER_BUZZ STEPPER=<nom_de_la_configuration> : D\u00e9place le moteur donn\u00e9 en avant d'un mm puis en arri\u00e8re d'un mm, r\u00e9p\u00e9t\u00e9 10 fois. Il s'agit d'un outil de diagnostic permettant de v\u00e9rifier la connectivit\u00e9 du moteur.","title":"STEPPER_BUZZ"},{"location":"G-Codes.html#force_move_1","text":"FORCE_MOVE STEPPER=<nom_de_la_configuration> DISTANCE=<valeur> VELOCITE=<valeur> [ACCEL=<valeur>] : Cette commande forcera le d\u00e9placement du stepper donn\u00e9 sur la distance donn\u00e9e (en mm) \u00e0 la vitesse constante donn\u00e9e (en mm/s). Si ACCEL est sp\u00e9cifi\u00e9 et est sup\u00e9rieur \u00e0 z\u00e9ro, alors l'acc\u00e9l\u00e9ration donn\u00e9e (en mm/s^2) sera utilis\u00e9e ; sinon, aucune acc\u00e9l\u00e9ration n'est effectu\u00e9e. Aucune v\u00e9rification des limites n'est effectu\u00e9e ; aucune mise \u00e0 jour cin\u00e9matique n'est faite ; les autres steppers parall\u00e8les sur un axe ne seront pas d\u00e9plac\u00e9s. Soyez prudent car une commande incorrecte pourrait endommager le mat\u00e9riel ! L'utilisation de cette commande placera presque certainement la cin\u00e9matique de bas niveau dans un \u00e9tat incorrect ; \u00e9mettez ensuite un G28 pour r\u00e9initialiser la cin\u00e9matique. Cette commande est destin\u00e9e aux diagnostics de bas niveau et au d\u00e9bogage.","title":"FORCE_MOVE"},{"location":"G-Codes.html#set_kinematic_position","text":"SET_KINEMATIC_POSITION [X=<value>] [Y=<value>] [Z=<value>] : Force le code cin\u00e9matique de bas niveau \u00e0 croire que la t\u00eate d'outil est \u00e0 la position cart\u00e9sienne donn\u00e9e. Il s'agit d'une commande de diagnostic et de d\u00e9bogage ; utilisez SET_GCODE_OFFSET et/ou G92 pour des transformations d'axe r\u00e9guli\u00e8res. Si un axe n'est pas sp\u00e9cifi\u00e9, la position par d\u00e9faut sera celle de la derni\u00e8re commande de la t\u00eate. La d\u00e9finition d'une position incorrecte ou invalide peut entra\u00eener des erreurs logicielles internes. Cette commande peut invalider les futures v\u00e9rifications de limites ; \u00e9mettez ensuite un G28 pour r\u00e9initialiser la cin\u00e9matique.","title":"SET_KINEMATIC_POSITION"},{"location":"G-Codes.html#gcode","text":"Le module gcode est automatiquement charg\u00e9.","title":"[gcode]"},{"location":"G-Codes.html#restart","text":"RESTART : Cette commande permet au logiciel h\u00f4te de recharger sa configuration et d'effectuer une r\u00e9initialisation interne. Cette commande n'efface pas l'\u00e9tat d'erreur du micro-contr\u00f4leur (voir FIRMWARE_RESTART) et ne charge pas de nouveau logiciel (voir la FAQ ).","title":"RESTART"},{"location":"G-Codes.html#firmware_restart","text":"FIRMWARE_RESTART : Cette commande est similaire \u00e0 un RESTART, mais elle efface \u00e9galement tout \u00e9tat d'erreur du micro-contr\u00f4leur.","title":"FIRMWARE_RESTART"},{"location":"G-Codes.html#status","text":"STATUS : Indique l'\u00e9tat du logiciel de l'h\u00f4te Klipper.","title":"STATUS"},{"location":"G-Codes.html#help","text":"HELP : Affiche la liste des commandes G-Code \u00e9tendues disponibles.","title":"HELP"},{"location":"G-Codes.html#gcode_arcs","text":"Les commandes G-Code standard suivantes sont disponibles si une section gcode_arcs config est activ\u00e9e : D\u00e9placement d'un arc dans le sens des aiguilles d'une montre (G2), d\u00e9placement d'un arc dans le sens inverse des aiguilles d'une montre (G3) : G2|G3 [X<pos>] [Y<pos>] [Z<pos>] [E<pos>] [F<speed>] I<value> J<value>|I<value> K<value>|J<value> K<value> S\u00e9lection du plan de l'arc : G17 (plan XY), G18 (plan XZ), G19 (plan YZ)","title":"[gcode_arcs]"},{"location":"G-Codes.html#gcode_macro","text":"La commande suivante est disponible lorsqu'une section de configuration gcode_macro est activ\u00e9e (voir \u00e9galement le guide des mod\u00e8les de commande ).","title":"[gcode_macro]"},{"location":"G-Codes.html#set_gcode_variable","text":"SET_GCODE_VARIABLE MACRO=<macro_name> VARIABLE=<name> VALUE=<value> : Cette commande permet de changer la valeur d'une variable gcode_macro au moment de l'ex\u00e9cution. La valeur fournie est analys\u00e9e comme un litt\u00e9ral Python.","title":"SET_GCODE_VARIABLE"},{"location":"G-Codes.html#gcode_move","text":"Le module gcode_move est automatiquement charg\u00e9.","title":"[gcode_move]"},{"location":"G-Codes.html#get_position","text":"GET_POSITION : Retourne les informations de l'emplacement actuel de la t\u00eate d'outil. Voir la documentation du d\u00e9veloppeur de restitution de GET_POSITION pour plus d'informations.","title":"GET_POSITION"},{"location":"G-Codes.html#set_gcode_offset","text":"SET_GCODE_OFFSET [X=<pos>|X_ADJUST=<adjust>] [Y=<pos>|Y_ADJUST=<adjust>] [Z=<pos>|Z_ADJUST=<adjust>] [MOVE=1 [MOVE_SPEED=<speed>]] : D\u00e9finit un d\u00e9calage positionnel \u00e0 appliquer aux futures commandes G-Code. Ceci est g\u00e9n\u00e9ralement utilis\u00e9 pour changer virtuellement le d\u00e9calage Z du bed ou pour d\u00e9finir les d\u00e9calages XY des buses lors du changement d'extrudeur. Par exemple, si \"SET_GCODE_OFFSET Z=0.2\" est donn\u00e9, les prochains mouvements G-Code auront 0,2mm ajout\u00e9 \u00e0 leur hauteur Z. Si les param\u00e8tres de style X_ADJUST sont utilis\u00e9s, l'ajustement sera ajout\u00e9 \u00e0 tout d\u00e9calage existant (par exemple, \"SET_GCODE_OFFSET Z=-0.2\" suivi de \"SET_GCODE_OFFSET Z_ADJUST=0.3\" donnerait un d\u00e9calage Z total de 0.1). Si \"MOVE=1\" est sp\u00e9cifi\u00e9, un d\u00e9placement de la t\u00eate d'outil sera effectu\u00e9 pour appliquer le d\u00e9calage donn\u00e9 (sinon le d\u00e9calage prendra effet lors du prochain d\u00e9placement absolu en G-code qui sp\u00e9cifie l'axe donn\u00e9). Si \"MOVE_SPEED\" est sp\u00e9cifi\u00e9, le d\u00e9placement de la t\u00eate d'outil sera effectu\u00e9 avec la vitesse donn\u00e9e (en mm/s) ; sinon, le d\u00e9placement de la t\u00eate d'outil utilisera la derni\u00e8re vitesse G-Code sp\u00e9cifi\u00e9e.","title":"SET_GCODE_OFFSET"},{"location":"G-Codes.html#save_gcode_state","text":"SAVE_GCODE_STATE [NAME=<nom_de_l'\u00e9tat>] : Sauvegarde l'\u00e9tat actuel de l'analyse des coordonn\u00e9es du g-code. La sauvegarde et le r\u00e9tablissement de l'\u00e9tat du g-code sont utiles dans les scripts et les macros. Cette commande enregistre le mode actuel de coordonn\u00e9es absolues en g-code (G90/G91), le mode d'extrusion absolue (M82/M83), l'origine (G92), le d\u00e9calage (SET_GCODE_OFFSET), la priorit\u00e9 de vitesse (M220), la priorit\u00e9 d'extrusion (M221), la vitesse de d\u00e9placement, la position XYZ actuelle et la position relative de l'extrudeuse \"E\". Si NOM est fourni, cela permet de nommer l'\u00e9tat sauvegard\u00e9 avec la cha\u00eene de caract\u00e8res donn\u00e9e. Si le NOM n'est pas fourni, la valeur par d\u00e9faut est \"default\".","title":"SAVE_GCODE_STATE"},{"location":"G-Codes.html#restore_gcode_state","text":"RESTORE_GCODE_STATE [NAME=<nom_de_l'\u00e9tat>] [MOVE=1 [MOVE_SPEED=<speed>]] : Restaure un \u00e9tat pr\u00e9c\u00e9demment sauvegard\u00e9 via SAVE_GCODE_STATE. Si \"MOVE=1\" est sp\u00e9cifi\u00e9, un d\u00e9placement de la t\u00eate d'outil sera effectu\u00e9 pour revenir \u00e0 la position XYZ pr\u00e9c\u00e9dente. Si \"MOVE_SPEED\" est sp\u00e9cifi\u00e9, alors le d\u00e9placement de la t\u00eate d'outil sera effectu\u00e9 avec la vitesse donn\u00e9e (en mm/s) ; sinon, le d\u00e9placement de la t\u00eate d'outil utilisera la vitesse du G-Code restaur\u00e9.","title":"RESTORE_GCODE_STATE"},{"location":"G-Codes.html#hall_filament_width_sensor","text":"Les commandes suivantes sont disponibles lorsque la section de configuration tsl1401cl filament width sensor ou hall filament width sensor est activ\u00e9e (voir \u00e9galement TSLl401CL Filament Width Sensor et Hall Filament Width Sensor ) :","title":"[hall_filament_width_sensor]"},{"location":"G-Codes.html#query_filament_width","text":"QUERY_FILAMENT_WIDTH : Renvoie la largeur actuelle du filament mesur\u00e9.","title":"QUERY_FILAMENT_WIDTH"},{"location":"G-Codes.html#reset_filament_width_sensor","text":"RESET_FILAMENT_WIDTH_SENSOR : Efface toutes les lectures du capteur. Utile apr\u00e8s un changement de filament.","title":"RESET_FILAMENT_WIDTH_SENSOR"},{"location":"G-Codes.html#disable_filament_width_sensor","text":"DISABLE_FILAMENT_WIDTH_SENSOR : D\u00e9sactiver le capteur de largeur de filament et arr\u00eater de l'utiliser pour le contr\u00f4le du flux.","title":"DISABLE_FILAMENT_WIDTH_SENSOR"},{"location":"G-Codes.html#enable_filament_width_sensor","text":"ENABLE_FILAMENT_WIDTH_SENSOR : Activez le capteur de largeur de filament et commencez \u00e0 l'utiliser pour le contr\u00f4le du flux.","title":"ENABLE_FILAMENT_WIDTH_SENSOR"},{"location":"G-Codes.html#query_raw_filament_width","text":"QUERY_RAW_FILAMENT_WIDTH : Renvoie les lectures actuelles des canaux ADC et la valeur RAW du capteur des points de calibration.","title":"QUERY_RAW_FILAMENT_WIDTH"},{"location":"G-Codes.html#enable_filament_width_log","text":"ENABLE_FILAMENT_WIDTH_LOG : Activer la journalisation du diam\u00e8tre.","title":"ENABLE_FILAMENT_WIDTH_LOG"},{"location":"G-Codes.html#disable_filament_width_log","text":"DISABLE_FILAMENT_WIDTH_LOG : D\u00e9sactiver la journalisation du diam\u00e8tre.","title":"DISABLE_FILAMENT_WIDTH_LOG"},{"location":"G-Codes.html#heaters","text":"Le module chauffages est automatiquement charg\u00e9 si un chauffage est d\u00e9fini dans le fichier de configuration.","title":"[heaters]"},{"location":"G-Codes.html#turn_off_heaters","text":"TURN_OFF_HEATERS : \u00c9teindre tous les chauffages.","title":"TURN_OFF_HEATERS"},{"location":"G-Codes.html#temperature_wait","text":"TEMPERATURE_WAIT SENSOR=<nom_config> [MINIMUM=<cible>] [MAXIMUM=<cible>] : Attend jusqu'\u00e0 ce que le capteur de temp\u00e9rature donn\u00e9 soit \u00e0 ou au-dessus du MINIMUM fourni et/ou \u00e0 ou en dessous du MAXIMUM fourni.","title":"TEMPERATURE_WAIT"},{"location":"G-Codes.html#set_heater_temperature","text":"SET_HEATER_TEMPERATURE HEATER=<nom_du_chauffeur> [TARGET=<temp\u00e9rature_cible>] : D\u00e9finit la temp\u00e9rature cible d'un \u00e9l\u00e9ment chauffant. Si une temp\u00e9rature cible n'est pas fournie, la cible est 0.","title":"SET_HEATER_TEMPERATURE"},{"location":"G-Codes.html#idle_timeout","text":"Le module idle_timeout est automatiquement charg\u00e9.","title":"[idle_timeout]"},{"location":"G-Codes.html#set_idle_timeout","text":"SET_IDLE_TIMEOUT [TIMEOUT=<timeout>] : Permet \u00e0 l'utilisateur de d\u00e9finir le d\u00e9lai d'inactivit\u00e9 (en secondes).","title":"SET_IDLE_TIMEOUT"},{"location":"G-Codes.html#input_shaper","text":"La commande suivante est activ\u00e9e si une section de configuration input_shaper a \u00e9t\u00e9 activ\u00e9e (voir \u00e9galement le guide de compensation de r\u00e9sonance ).","title":"[input_shaper]"},{"location":"G-Codes.html#set_input_shaper","text":"SET_INPUT_SHAPER [SHAPER_FREQ_X=<shaper_freq_x>] [SHAPER_FREQ_Y=<shaper_freq_y>] [DAMPING_RATIO_X=<damping_ratio_x>] [DAMPING_RATIO_Y=<damping_ratio_y>] [SHAPER_TYPE=<shaper>] [SHAPER_TYPE_X=<shaper_type_x>] [SHAPER_TYPE_Y=<shaper_type_y>] : Modifie les param\u00e8tres de mise en forme d'entr\u00e9e. Notez que le param\u00e8tre SHAPER_TYPE r\u00e9initialise le shaper d'entr\u00e9e pour les axes X et Y m\u00eame si diff\u00e9rents types de shaper ont \u00e9t\u00e9 configur\u00e9s dans la section [input_shaper]. SHAPER_TYPE ne peut pas \u00eatre utilis\u00e9 avec l'un des param\u00e8tres SHAPER_TYPE_X et SHAPER_TYPE_Y. Voir config reference pour plus de d\u00e9tails sur chacun de ces param\u00e8tres.","title":"SET_INPUT_SHAPER"},{"location":"G-Codes.html#manual_probe","text":"Le module manual_probe est automatiquement charg\u00e9.","title":"[manual_probe]"},{"location":"G-Codes.html#manual_probe_1","text":"MANUAL_PROBE [SPEED=<speed>] : Ex\u00e9cute un script d'aide servant \u00e0 mesurer la hauteur de la buse \u00e0 un point donn\u00e9. Si SPEED est sp\u00e9cifi\u00e9, il d\u00e9finit la vitesse des commandes TESTZ (la valeur par d\u00e9faut est 5mm/s). Pendant un sondage manuel, les commandes suppl\u00e9mentaires suivantes sont disponibles : ACCEPT : Cette commande valide la position Z actuelle et met fin au sondage manuel. ABORT : Cette commande interrompt le sondage manuel. TESTZ Z=<valeur> : Cette commande d\u00e9place la buse vers le haut ou vers le bas de la quantit\u00e9 sp\u00e9cifi\u00e9e dans \"valeur\". Par exemple, TESTZ Z=-.1 d\u00e9placera la buse vers le bas de 0,1mm tandis que TESTZ Z=.1 d\u00e9placera la buse vers le haut de 0,1mm. La valeur peut \u00e9galement \u00eatre + , - , ++ , ou -- pour d\u00e9placer la buse vers le haut ou vers le bas d'une quantit\u00e9 relative aux tentatives pr\u00e9c\u00e9dentes.","title":"MANUAL_PROBE"},{"location":"G-Codes.html#z_endstop_calibrate","text":"Z_ENDSTOP_CALIBRATE [SPEED=<vitesse>] : Ex\u00e9cute un script d'assistance utile pour calibrer un param\u00e8tre de configuration de la position Z_endstop. Voir la commande MANUAL_PROBE pour plus de d\u00e9tails sur les param\u00e8tres et les commandes suppl\u00e9mentaires disponibles lorsque l'outil est actif.","title":"Z_ENDSTOP_CALIBRATE"},{"location":"G-Codes.html#z_offset_apply_endstop","text":"Z_OFFSET_APPLY_ENDSTOP : Prend le d\u00e9calage actuel du Gcode Z (alias, babystepping), et le soustrait de la position endstop_position d\u00e9finie dans stepper_z. Ceci permet de prendre une valeur de babystepping fr\u00e9quemment utilis\u00e9e, et de la rendre permanente. N\u00e9cessite un SAVE_CONFIG pour prendre effet.","title":"Z_OFFSET_APPLY_ENDSTOP"},{"location":"G-Codes.html#manual_stepper","text":"La commande suivante est disponible lorsqu'une section manual_stepper config est activ\u00e9e.","title":"[manual_stepper]"},{"location":"G-Codes.html#manual_stepper_1","text":"MANUAL_STEPPER STEPPER=nom_du_config [ENABLE=[0|1]]] [SET_POSITION=<pos>] [SPEED=<speed>] [ACCEL=<accel>] [MOVE=<pos> [STOP_ON_ENDSTOP=[1|2|-1|-2]] [SYNC=0]] : Cette commande modifie l'\u00e9tat du stepper. Utilisez le param\u00e8tre ENABLE pour activer/d\u00e9sactiver le stepper. Utilisez le param\u00e8tre SET_POSITION pour forcer le moteur pas \u00e0 pas \u00e0 penser qu'il se trouve \u00e0 la position donn\u00e9e. Utilisez le param\u00e8tre MOVE pour d\u00e9placer vers la position donn\u00e9e. Si SPEED et/ou ACCEL sont sp\u00e9cifi\u00e9s, les valeurs donn\u00e9es seront utilis\u00e9es \u00e0 la place de celles par d\u00e9faut issues du fichier de configuration. Si un ACCEL de z\u00e9ro est sp\u00e9cifi\u00e9, aucune acc\u00e9l\u00e9ration ne sera effectu\u00e9e. Si STOP_ON_ENDSTOP=1 est sp\u00e9cifi\u00e9, le d\u00e9placement se terminera pr\u00e9matur\u00e9ment si la fin de course est d\u00e9clench\u00e9e (utilisez STOP_ON_ENDSTOP=2 pour terminer le d\u00e9placement sans erreur m\u00eame si la fin de course n'est pas d\u00e9clench\u00e9e, utilisez -1 ou -2 pour s'arr\u00eater lorsque la fin de course n'est pas d\u00e9clench\u00e9e). Normalement, les futures commandes G-Code seront programm\u00e9es pour \u00eatre ex\u00e9cut\u00e9es apr\u00e8s la fin du d\u00e9placement de la commande de pas, mais si un d\u00e9placement manuel de la commande de pas utilise SYNC=0, les futures commandes de d\u00e9placement G-Code peuvent \u00eatre ex\u00e9cut\u00e9es en parall\u00e8le avec le d\u00e9placement de la commande de pas.","title":"MANUAL_STEPPER"},{"location":"G-Codes.html#mcp4018","text":"La commande suivante est disponible lorsqu'une section mcp4018 config est activ\u00e9e.","title":"[mcp4018]"},{"location":"G-Codes.html#set_digipot","text":"SET_DIGIPOT DIGIPOT=config_name WIPER=<valeur> : Cette commande change la valeur actuelle du digipot. Cette valeur devrait typiquement \u00eatre comprise entre 0.0 et 1.0, \u00e0 moins qu'une '\u00e9chelle' soit d\u00e9finie dans la configuration. Lorsque 'scale' est d\u00e9fini, alors cette valeur doit \u00eatre comprise entre 0.0 et 'scale'.","title":"SET_DIGIPOT"},{"location":"G-Codes.html#led","text":"La commande suivante est disponible lorsque l'une des sections led config est activ\u00e9e.","title":"[led]"},{"location":"G-Codes.html#set_led","text":"SET_LED LED=<nom_de_la_configuration> RED=<valeur> GREEN=<valeur> BLUE=<valeur> WHITE=<valeur> [INDEX=<index>] [TRANSMIT=0] [SYNC=1] : Ceci d\u00e9finit la sortie de la LED. Chaque <valeur> de couleur doit \u00eatre comprise entre 0.0 et 1.0. L'option WHITE n'est valable que pour les LEDs RGBW. Si la LED supporte plusieurs puces dans une cha\u00eene, on peut sp\u00e9cifier INDEX pour modifier la couleur de la seule puce donn\u00e9e (1 pour la premi\u00e8re puce, 2 pour la seconde, etc.). Si INDEX n'est pas sp\u00e9cifi\u00e9, alors toutes les LEDs de la cha\u00eene seront r\u00e9gl\u00e9es sur la couleur fournie. Si TRANSMIT=0 est sp\u00e9cifi\u00e9, le changement de couleur ne sera effectu\u00e9 que lors de la prochaine commande SET_LED qui ne sp\u00e9cifie pas TRANSMIT=0 ; cela peut \u00eatre utile en combinaison avec le param\u00e8tre INDEX pour effectuer plusieurs mises \u00e0 jour dans une cha\u00eene. Par d\u00e9faut, la commande SET_LED synchronisera ses changements avec les autres commandes gcode en cours. Cela peut conduire \u00e0 un comportement ind\u00e9sirable si les LEDs sont r\u00e9gl\u00e9es alors que l'imprimante n'imprime pas, car cela r\u00e9initialisera le d\u00e9lai d'inactivit\u00e9. Si un timing pr\u00e9cis n'est pas n\u00e9cessaire, le param\u00e8tre optionnel SYNC=0 peut \u00eatre sp\u00e9cifi\u00e9 pour appliquer les changements sans r\u00e9initialiser le d\u00e9lai d'inactivit\u00e9.","title":"SET_LED"},{"location":"G-Codes.html#set_led_template","text":"SET_LED_TEMPLATE LED=<nom_de_la_led> TEMPLATE=<nom_du_mod\u00e8le> [<param_x>=<literal>] [INDEX=<index>] : Attribue un mod\u00e8le d'affichage \u00e0 une LED donn\u00e9e. Par exemple, si l'on d\u00e9finit une section de configuration [display_template my_led_template] , on peut affecter TEMPLATE=my_led_template ici. Le mod\u00e8le d'affichage doit produire une cha\u00eene de caract\u00e8res s\u00e9par\u00e9e par des virgules contenant quatre nombres \u00e0 virgule flottante correspondant aux param\u00e8tres de couleur rouge, vert, bleu et blanc. Le mod\u00e8le sera continuellement \u00e9valu\u00e9 et la LED sera automatiquement r\u00e9gl\u00e9e sur les couleurs r\u00e9sultantes. On peut d\u00e9finir des param\u00e8tres display_template \u00e0 utiliser pendant l'\u00e9valuation du mod\u00e8le (les param\u00e8tres seront analys\u00e9s comme des litt\u00e9raux Python). Si INDEX n'est pas sp\u00e9cifi\u00e9, alors toutes les puces dans la cha\u00eene de la LED seront r\u00e9gl\u00e9es sur le mod\u00e8le, sinon seule la puce avec l'index donn\u00e9 sera mise \u00e0 jour. Si TEMPLATE est une cha\u00eene vide, cette commande effacera tout mod\u00e8le pr\u00e9c\u00e9dent assign\u00e9 \u00e0 la LED (on peut alors utiliser les commandes SET_LED pour g\u00e9rer les param\u00e8tres de couleur de la LED).","title":"SET_LED_TEMPLATE"},{"location":"G-Codes.html#output_pin","text":"La commande suivante est disponible lorsqu'une section output_pin config est activ\u00e9e.","title":"[output_pin]"},{"location":"G-Codes.html#set_pin","text":"SET_PIN PIN=config_name VALUE=<value> [CYCLE_TIME=<cycle_time>] : Set the pin to the given output VALUE . VALUE should be 0 or 1 for \"digital\" output pins. For PWM pins, set to a value between 0.0 and 1.0, or between 0.0 and scale if a scale is configured in the output_pin config section. Some pins (currently only \"soft PWM\" pins) support setting an explicit cycle time using the CYCLE_TIME parameter (specified in seconds). Note that the CYCLE_TIME parameter is not stored between SET_PIN commands (any SET_PIN command without an explicit CYCLE_TIME parameter will use the cycle_time specified in the output_pin config section).","title":"SET_PIN"},{"location":"G-Codes.html#palette2","text":"Les commandes suivantes sont disponibles lorsque la section palette2 config est activ\u00e9e. Les impressions avec Palette fonctionnent en int\u00e9grant des OCodes (Omega Codes) sp\u00e9ciaux dans le fichier GCode : O1 ... O32 : Ces codes sont lus \u00e0 partir du flux GCode, trait\u00e9s par ce module et transmis au dispositif Palette 2. Les commandes suppl\u00e9mentaires suivantes sont \u00e9galement disponibles.","title":"[palette2]"},{"location":"G-Codes.html#palette_connect","text":"PALETTE_CONNECT : Cette commande initie la connexion avec Palette 2.","title":"PALETTE_CONNECT"},{"location":"G-Codes.html#palette_disconnect","text":"PALETTE_DISCONNECT : Cette commande permet de se d\u00e9connecter de Palette 2.","title":"PALETTE_DISCONNECT"},{"location":"G-Codes.html#palette_clear","text":"PALETTE_CLEAR : Cette commande demande \u00e0 Palette 2 de purger le filament de tous les chemins d'entr\u00e9e et de sortie.","title":"PALETTE_CLEAR"},{"location":"G-Codes.html#palette_cut","text":"PALETTE_CUT : Cette commande demande \u00e0 Palette 2 de couper le filament actuellement charg\u00e9 dans le noyau de jonction.","title":"PALETTE_CUT"},{"location":"G-Codes.html#palette_smart_load","text":"PALETTE_SMART_LOAD : cette commande initialise la s\u00e9quence de chargement intelligente sur Palette 2. Le filament est charg\u00e9 automatiquement en l\u2019extrudant sur la distance calibr\u00e9e sur l\u2019appareil pour l\u2019imprimante, et l'indique \u00e0 Palette 2 une fois le chargement termin\u00e9. Cette commande revient \u00e0 appuyer sur Smart Load directement sur l\u2019\u00e9cran Palette 2 une fois l'insertion du filament faite.","title":"PALETTE_SMART_LOAD"},{"location":"G-Codes.html#pid_calibrate","text":"Le module pid_calibrate est automatiquement charg\u00e9 si un chauffage est d\u00e9fini dans le fichier de configuration.","title":"[pid_calibrate]"},{"location":"G-Codes.html#pid_calibrate_1","text":"PID_CALIBRATE HEATER=<config_name> TARGET=<temperature> [WRITE_FILE=1] : Effectuer un test d\u2019\u00e9talonnage PID. Le chauffage demand\u00e9 sera activ\u00e9 jusqu\u2019\u00e0 ce que la temp\u00e9rature d\u00e9finie soit atteinte, il s'\u00e9teindra et se rallumera durant plusieurs cycles. Si le param\u00e8tre WRITE_FILE est activ\u00e9, le fichier /tmp/heattest.txt sera cr\u00e9\u00e9 avec un journal de tous les \u00e9chantillons de temp\u00e9rature mesur\u00e9s pendant le test.","title":"PID_CALIBRATE"},{"location":"G-Codes.html#pause_resume","text":"Les commandes suivantes sont disponibles lorsque la section pause_resume config est activ\u00e9e :","title":"[pause_resume]"},{"location":"G-Codes.html#pause","text":"PAUSE : suspend l\u2019impression en cours. La position actuelle est enregistr\u00e9e pour reprendre lorsque demand\u00e9.","title":"PAUSE"},{"location":"G-Codes.html#resume","text":"RESUME [VELOCITY=<value>] : Reprend l'impression \u00e0 la suite d'une pause, en r\u00e9tablissant d'abord la position captur\u00e9e pr\u00e9c\u00e9demment. Le param\u00e8tre VELOCITY d\u00e9termine la vitesse \u00e0 laquelle l'outil doit revenir \u00e0 la position captur\u00e9e d'origine.","title":"RESUME"},{"location":"G-Codes.html#clear_pause","text":"CLEAR_PAUSE : Supprime la mise en pause actuelle sans reprendre l'impression. Ceci est utile si l'on d\u00e9cide d'interrompre une impression apr\u00e8s une PAUSE. Il est recommand\u00e9 d'ajouter ceci \u00e0 votre gcode de d\u00e9marrage pour s'assurer que l'\u00e9tat de pause est r\u00e9initialis\u00e9 pour chaque impression.","title":"CLEAR_PAUSE"},{"location":"G-Codes.html#cancel_print","text":"CANCEL_PRINT : Annule l'impression en cours.","title":"CANCEL_PRINT"},{"location":"G-Codes.html#print_stats","text":"Le module print_stats est automatiquement charg\u00e9.","title":"[print_stats]"},{"location":"G-Codes.html#set_print_stats_info","text":"SET_PRINT_STATS_INFO [TOTAL_LAYER=<nombre_total_de_couches>] [CURRENT_LAYER= <couche_actuelle>] : Passe les informations du trancheur comme le nombre total de couches et celle actuellement en cours \u00e0 Klipper. Ajoutez SET_PRINT_STATS_INFO [TOTAL_LAYER=<nombre_total_de_couches>] \u00e0 votre section gcode de d\u00e9but du trancheur et SET_PRINT_STATS_INFO [CURRENT_LAYER= <couche_actuelle>] \u00e0 la section gcode de changement de couche pour passer les informations de couche de votre trancheur \u00e0 Klipper.","title":"SET_PRINT_STATS_INFO"},{"location":"G-Codes.html#probe","text":"Les commandes suivantes sont disponibles lorsqu'une section probe config ou bltouch config est activ\u00e9e (voir \u00e9galement le guide d'\u00e9talonnage de la sonde ).","title":"[probe]"},{"location":"G-Codes.html#probe_1","text":"PROBE [PROBE_SPEED=<mm/s>] [LIFT_SPEED=<mm/s>] [SAMPLES=<count>] [SAMPLE_RETRACT_DIST=<mm>] [SAMPLES_TOLERANCE=<mm>] [SAMPLES_TOLERANCE_RETRIES=<count>] [SAMPLES_RESULT=median|average] : D\u00e9place la buse vers le bas jusqu'\u00e0 ce que le palpeur se d\u00e9clenche. Si l'un des param\u00e8tres facultatifs est fourni, il remplace son param\u00e8tre \u00e9quivalent dans la section configuration de la sonde .","title":"PROBE"},{"location":"G-Codes.html#query_probe","text":"QUERY_PROBE : Retourne l'\u00e9tat actuel de la sonde (\"triggered\" ou \"open\").","title":"QUERY_PROBE"},{"location":"G-Codes.html#probe_accuracy","text":"PROBE_ACCURACY [PROBE_SPEED=<mm/s>] [SAMPLES=<count>] [SAMPLE_RETRACT_DIST=<mm>] : Calculer le maximum, le minimum, la moyenne, la m\u00e9diane et l\u2019\u00e9cart type des \u00e9chantillons des multiples palpeurs. Par d\u00e9faut, 10 \u00c9CHANTILLONS sont pr\u00e9lev\u00e9s. Sinon, les param\u00e8tres optionnels peuvent \u00eatre d\u00e9finis dans la section de configuration du palpeur.","title":"PROBE_ACCURACY"},{"location":"G-Codes.html#probe_calibrate","text":"PROBE_CALIBRATE [SPEED=<speed>] [<probe_parameter>=<value>] : Ex\u00e9cute l'assistant servant \u00e0 calibrer le z_offset du palpeur. Consultez la commande PROBE pour plus d\u2019informations sur les param\u00e8tres optionnels du palpeur. Reportez-vous \u00e0 la commande MANUAL_PROBE pour plus d\u2019informations sur le param\u00e8tre SPEED et les commandes suppl\u00e9mentaires disponibles lorsque l'assistant est actif. Veuillez noter que la commande PROBE_CALIBRATE utilise la variable de vitesse pour se d\u00e9placer dans la direction XY ainsi que dans Z.","title":"PROBE_CALIBRATE"},{"location":"G-Codes.html#z_offset_apply_probe","text":"Z_OFFSET_APPLY_PROBE : Prend le d\u00e9calage actuel du Gcode Z (alias, babystepping), et le soustrait du z_offset de la sonde. Cela permet de prendre une valeur de babystepping fr\u00e9quemment utilis\u00e9e, et de la rendre permanente. N\u00e9cessite un SAVE_CONFIG pour prendre effet.","title":"Z_OFFSET_APPLY_PROBE"},{"location":"G-Codes.html#query_adc","text":"Le module query_adc est automatiquement charg\u00e9.","title":"[query_adc]"},{"location":"G-Codes.html#query_adc_1","text":"QUERY_ADC [NAME=<nom_de_la_configuration>] [PULLUP=<valeur>] : Rapporte la derni\u00e8re valeur analogique re\u00e7ue pour une broche analogique donn\u00e9e. Si NAME n'est pas fourni, la liste des noms d'adc disponibles est retourn\u00e9e. Si PULLUP est fourni (comme une valeur en Ohms), la valeur analogique brute ainsi que la r\u00e9sistance \u00e9quivalente relative \u00e0 ce pullup est retourn\u00e9e.","title":"QUERY_ADC"},{"location":"G-Codes.html#query_endstops","text":"Le module query_endstops est automatiquement charg\u00e9. Les commandes G-Code standard suivantes sont actuellement disponibles, mais leur utilisation n'est pas recommand\u00e9e : Obtenir le statut Fin de course : M119 (Utilisez QUERY_ENDSTOPS \u00e0 la place.)","title":"[query_endstops]"},{"location":"G-Codes.html#query_endstops_1","text":"QUERY_ENDSTOPS : Teste les but\u00e9es d'axe et indique si elles sont \"d\u00e9clench\u00e9es\" ou dans un \u00e9tat \"ouvert\". Cette commande est g\u00e9n\u00e9ralement utilis\u00e9e pour v\u00e9rifier qu'un butoir de fin de course fonctionne correctement.","title":"QUERY_ENDSTOPS"},{"location":"G-Codes.html#resonance_tester","text":"Les commandes suivantes sont disponibles lorsqu'une section configuration du testeur de r\u00e9sonances est activ\u00e9e (voir \u00e9galement le guide de mesure des r\u00e9sonances ).","title":"[resonance_tester]"},{"location":"G-Codes.html#measure_axes_noise","text":"MEASURE_AXES_NOISE : Mesure et affiche le bruit pour tous les axes de toutes les puces acc\u00e9l\u00e9rom\u00e9triques activ\u00e9es.","title":"MEASURE_AXES_NOISE"},{"location":"G-Codes.html#test_resonances","text":"TEST_RESONANCES AXE=<axe> OUTPUT=<resonances,raw_data> [NOM=<nom>] [FREQ_START=<freq_min>] [FREQ_END=<freq_max>] [HZ_PER_SEC=<hz_par_sec>] [CHIPS=<nom_puce_adxl345>] [POINT=x,y,z] [INPUT_SHAPING=[<0:1>]] : Ex\u00e9cute le test de r\u00e9sonance dans tous les points de sonde configur\u00e9s pour l'\"axe\" demand\u00e9 et mesure l'acc\u00e9l\u00e9ration en utilisant les puces acc\u00e9l\u00e9rom\u00e9tres configur\u00e9es pour l'axe respectif. L'\"axe\" peut \u00eatre X ou Y, ou sp\u00e9cifier une direction arbitraire comme AXIS=dx,dy , o\u00f9 dx et dy sont des nombres \u00e0 virgule flottante d\u00e9finissant un vecteur de direction (par exemple, AXIS=X , AXIS=Y , ou AXIS=1,-1 pour d\u00e9finir une direction diagonale). Notez que AXIS=dx,dy et AXIS=-dx,-dy sont \u00e9quivalents. nom_puce_adxl345 peut \u00eatre une ou plusieurs puces adxl345 configur\u00e9es, d\u00e9limit\u00e9es par des virgules, par exemple CHIPS=\"adxl345, adxl345 rpi\" . Notez que le terme adxl345 peut \u00eatre omis pour les puces adxl345 nomm\u00e9es. Si POINT est indiqu\u00e9, il remplacera le(s) point(s) configur\u00e9(s) dans [resonance_tester] . Si INPUT_SHAPING=0 ou non d\u00e9fini (par d\u00e9faut), d\u00e9sactive la mise en forme de l'entr\u00e9e pour le test de r\u00e9sonance, car il n'est pas valide d'ex\u00e9cuter le test de r\u00e9sonance avec la mise en forme de l'entr\u00e9e active. Le param\u00e8tre OUTPUT consiste en une liste s\u00e9par\u00e9e par des virgules des sorties qui seront \u00e9crites. Si raw_data est demand\u00e9, alors les donn\u00e9es brutes de l'acc\u00e9l\u00e9rom\u00e8tre sont \u00e9crites dans un fichier ou une s\u00e9rie de fichiers /tmp/raw_data_<axe>_[<nom_puce>_][<point>_]<nom>.csv avec (la partie <point>_ du nom g\u00e9n\u00e9r\u00e9e seulement si plus d'un point de sonde est configur\u00e9 ou si POINT est sp\u00e9cifi\u00e9). Si resonances est sp\u00e9cifi\u00e9, la r\u00e9ponse en fr\u00e9quence est calcul\u00e9e (\u00e0 travers tous les points de sonde) et \u00e9crite dans le fichier /tmp/resonances_<axe>_<nom>.csv . S'il n'est pas d\u00e9fini, OUTPUT prend par d\u00e9faut la valeur de resonances , et NAME prend par d\u00e9faut la valeur de l'heure actuelle au format \"AAAAMMJJ_HHMMSS\".","title":"TEST_RESONANCES"},{"location":"G-Codes.html#shaper_calibrate","text":"SHAPER_CALIBRATE [AXIS=<axe>] [NAME=<nom>] [FREQ_START=<freq_min>] [FREQ_END=<freq_max>] [HZ_PER_SEC=<hz_par_sec>] [MAX_SMOOTHING=<adoucissement_max>] : Comme TEST_RESONANCES , ex\u00e9cute le test de r\u00e9sonance tel que configur\u00e9, et essaie de trouver les param\u00e8tres optimaux pour le fa\u00e7onneur d'entr\u00e9e pour l'axe demand\u00e9 (ou les deux axes X et Y si le param\u00e8tre AXIS est d\u00e9sactiv\u00e9). Si MAX_SMOOTHING n'est pas d\u00e9fini, sa valeur est reprise de la section [resonance_tester] , la valeur par d\u00e9faut \u00e9tant non d\u00e9finie. Voir le Max smoothing du guide de la mesure des r\u00e9sonances pour plus d'informations sur l'utilisation de cette fonctionnalit\u00e9. Les r\u00e9sultats de l\u2019\u00e9talonnage sont imprim\u00e9s sur la console, les r\u00e9ponses en fr\u00e9quence et les diff\u00e9rentes valeurs des fa\u00e7onneurs d'entr\u00e9e sont \u00e9crites dans un ou plusieurs fichiers CSV /tmp/calibration_data_<axe>_<nom>.csv . Sauf si sp\u00e9cifi\u00e9, NOM est par d\u00e9faut l'heure actuelle au format \"AAAAMMJJ_HHMMSS\". Notez que les param\u00e8tres de mise en forme d'entr\u00e9e sugg\u00e9r\u00e9s peuvent \u00eatre conserv\u00e9s dans la configuration en \u00e9mettant la commande SAVE_CONFIG .","title":"SHAPER_CALIBRATE"},{"location":"G-Codes.html#respond","text":"Les commandes G-Code standard suivantes sont disponibles lorsque la section respond config est activ\u00e9e : M118 <message> : affiche le message pr\u00e9c\u00e9d\u00e9 du pr\u00e9fixe par d\u00e9faut configur\u00e9 (ou echo : si aucun pr\u00e9fixe n'est configur\u00e9). Les commandes suppl\u00e9mentaires suivantes sont \u00e9galement disponibles.","title":"[respond]"},{"location":"G-Codes.html#respond_1","text":"RESPOND MSG=\"<message>\" : Affiche le message pr\u00e9c\u00e9d\u00e9 du pr\u00e9fixe par d\u00e9faut configur\u00e9 (ou echo : si aucun pr\u00e9fixe n'est configur\u00e9). RESPOND TYPE=echo MSG=\"<message>\" : affiche le message pr\u00e9c\u00e9d\u00e9 par echo : . RESPOND TYPE=echo_no_space MSG=\"<message>\" : renvoie le message pr\u00e9c\u00e9d\u00e9 de echo: sans espace entre le pr\u00e9fixe et le message, utile pour la compatibilit\u00e9 avec certains plugins octoprint qui attendent un formatage tr\u00e8s sp\u00e9cifique. RESPOND TYPE=command MSG=\"<message>\" : renvoie le message pr\u00e9c\u00e9d\u00e9 de // . OctoPrint peut \u00eatre configur\u00e9 pour r\u00e9pondre \u00e0 ces messages (par exemple, RESPOND TYPE=command MSG=action:pause ). RESPOND TYPE=error MSG=\"<message>\" : affiche le message pr\u00e9c\u00e9d\u00e9 par !!! . RESPOND PREFIX=<prefix> MSG=\"<message>\" : renvoie le message pr\u00e9c\u00e9d\u00e9 de <prefix> . (Le param\u00e8tre PREFIX est prioritaire sur le param\u00e8tre TYPE ).","title":"RESPOND"},{"location":"G-Codes.html#save_variables","text":"La commande suivante est activ\u00e9e si une section save_variables config a \u00e9t\u00e9 activ\u00e9e.","title":"[save_variables]"},{"location":"G-Codes.html#save_variable","text":"SAVE_VARIABLE VARIABLE=<nom> VALUE=<valeur> : Enregistre la variable sur le disque afin qu'elle puisse \u00eatre utilis\u00e9e lors des red\u00e9marrages. Toutes les variables enregistr\u00e9es sont charg\u00e9es dans le dict printer.save_variables.variables au d\u00e9marrage et peuvent \u00eatre utilis\u00e9es dans des macros gcode. La VALEUR fournie est analys\u00e9e comme un litt\u00e9ral Python.","title":"SAVE_VARIABLE"},{"location":"G-Codes.html#screws_tilt_adjust","text":"Les commandes suivantes sont disponibles lorsque la section de configuration screws_tilt_adjust est activ\u00e9e (voir \u00e9galement le guide du nivelage manuel ).","title":"[screws_tilt_adjust]"},{"location":"G-Codes.html#screws_tilt_calculate","text":"SCREWS_TILT_CALCULATE [DIRECTION=CW|CCW] [MAX_DEVIATION=<valeur>] [<probe_parameter>=<valeur>] : Cette commande invoquera l'outil de r\u00e9glage des vis du lit. Elle d\u00e9placera la buse \u00e0 diff\u00e9rents endroits (tels que d\u00e9finis dans le fichier de configuration) en palpant la hauteur z et calculera le nombre de tours de la molette de r\u00e9glage pour ajuster le niveau du lit. Si DIRECTION est sp\u00e9cifi\u00e9, les tours de la molette seront tous dans la m\u00eame direction, dans le sens des aiguilles d'une montre (CW) ou dans le sens inverse (CCW). Voir la commande PROBE pour plus de d\u00e9tails sur les param\u00e8tres optionnels de la sonde. IMPORTANT : Vous DEVEZ toujours effectuer un G28 avant d'utiliser cette commande. Si MAX_DEVIATION est sp\u00e9cifi\u00e9, la commande d\u00e9clenchera une erreur de gcode si une diff\u00e9rence de hauteur de vis par rapport \u00e0 la hauteur de vis de base est sup\u00e9rieure \u00e0 la valeur fournie.","title":"SCREWS_TILT_CALCULATE"},{"location":"G-Codes.html#sdcard_loop","text":"Lorsque la section de configuration sdcard_loop est activ\u00e9e, les commandes \u00e9tendues suivantes sont disponibles.","title":"[sdcard_loop]"},{"location":"G-Codes.html#sdcard_loop_begin","text":"SDCARD_LOOP_BEGIN COUNT=<compte> : Commence une section boucl\u00e9e dans l'impression SD. Un compte de 0 indique que la section doit \u00eatre boucl\u00e9e ind\u00e9finiment.","title":"SDCARD_LOOP_BEGIN"},{"location":"G-Codes.html#sdcard_loop_end","text":"SDCARD_LOOP_END : Termine une section de boucle dans l'impression SD.","title":"SDCARD_LOOP_END"},{"location":"G-Codes.html#sdcard_loop_desist","text":"SDCARD_LOOP_DESIST : Termine les boucles existantes sans autres it\u00e9rations.","title":"SDCARD_LOOP_DESIST"},{"location":"G-Codes.html#servo","text":"Les commandes suivantes sont disponibles lorsqu'une section servo config est activ\u00e9e.","title":"[servo]"},{"location":"G-Codes.html#set_servo","text":"SET_SERVO SERVO=nom_config [ANGLE=<degr\u00e9s> | LARGEUR=<secondes>] : D\u00e9finit la position du servo \u00e0 l'angle (en degr\u00e9s) ou \u00e0 la largeur d'impulsion (en secondes) donn\u00e9s. Utilisez WIDTH=0 pour d\u00e9sactiver la sortie du servo.","title":"SET_SERVO"},{"location":"G-Codes.html#skew_correction","text":"Les commandes suivantes sont disponibles lorsque la section de configuration skew_correction est activ\u00e9e (voir \u00e9galement le guide Skew Correction ).","title":"[skew_correction]"},{"location":"G-Codes.html#set_skew","text":"SET_SKEW [XY=<ac_length,bd_length,ad_length>] [XZ=<ac,bd,ad>] [YZ=<ac,bd,ad>] [CLEAR=<0|1>] : Configure le module [skew_correction] avec des mesures (en mm) prises \u00e0 partir d'une impression d'\u00e9talonnage. On peut entrer des mesures pour n'importe quelle combinaison de plans, les plans non entr\u00e9s conserveront leur valeur actuelle. Si CLEAR=1 est entr\u00e9, toute correction d'inclinaison sera d\u00e9sactiv\u00e9e.","title":"SET_SKEW"},{"location":"G-Codes.html#get_current_skew","text":"GET_CURRENT_SKEW : Indique l'inclinaison actuelle de l'imprimante pour chaque plan en radians et en degr\u00e9s. L'inclinaison est calcul\u00e9e en fonction des param\u00e8tres fournis par le gcode SET_SKEW .","title":"GET_CURRENT_SKEW"},{"location":"G-Codes.html#calc_measured_skew","text":"CALC_MEASURED_SKEW [AC=<ac_length>] [BD=<bd_length>] [AD=<ad_length>] : Calcule et rapporte l'inclinaison (en radians et en degr\u00e9s) bas\u00e9e sur une impression mesur\u00e9e. Cela peut \u00eatre utile pour d\u00e9terminer l'inclinaison actuelle de l'imprimante apr\u00e8s l'application de la correction. Elle peut \u00e9galement \u00eatre utile avant l'application de la correction pour d\u00e9terminer si une correction de l'inclinaison est n\u00e9cessaire. Reportez-vous \u00e0 la section [Correction de l'obliquit\u00e9] (Skew_Correction.md) pour plus de d\u00e9tails sur les objets et les mesures de calibrage de l'obliquit\u00e9.","title":"CALC_MEASURED_SKEW"},{"location":"G-Codes.html#skew_profile","text":"SKEW_PROFILE [LOAD=<nom>] [SAVE=<nom>] [REMOVE=<nom>] : Gestion des profils pour la correction de l'obliquit\u00e9. LOAD restaurera l'\u00e9tat d'inclinaison \u00e0 partir du profil correspondant au nom fourni. SAVE sauvegardera l'\u00e9tat actuel d'inclinaison dans un profil correspondant au nom fourni. Remove supprimera le profil correspondant au nom fourni de la m\u00e9moire persistante. Notez qu'apr\u00e8s l'ex\u00e9cution des op\u00e9rations SAVE ou REMOVE, le gcode SAVE_CONFIG doit \u00eatre ex\u00e9cut\u00e9 pour que les modifications apport\u00e9es \u00e0 la m\u00e9moire permanente deviennent permanentes.","title":"SKEW_PROFILE"},{"location":"G-Codes.html#smart_effector","text":"Plusieurs commandes sont disponibles lorsqu'une section de configuration smart_effector est activ\u00e9e. Assurez-vous de consulter la documentation officielle du Smart Effector sur le Duet3D Wiki avant de modifier les param\u00e8tres du Smart Effector. Consultez \u00e9galement le guide d'\u00e9talonnage de la sonde .","title":"[smart_effector]"},{"location":"G-Codes.html#set_smart_effector","text":"SET_SMART_EFFECTOR [SENSITIVITY=<sensitivity>] [ACCEL=<accel>] [RECOVERY_TIME=<time>] : D\u00e9finit les param\u00e8tres du Smart Effector. Lorsque SENSITIVITY est sp\u00e9cifi\u00e9, la valeur respective est \u00e9crite dans l'EEPROM du SmartEffecteur (n\u00e9cessite que control_pin soit fourni). Les valeurs acceptables de <sensitivity> sont 0..255, la valeur par d\u00e9faut est 50. Des valeurs plus faibles n\u00e9cessitent moins de force de contact de la buse pour se d\u00e9clencher (mais il y a un plus grand risque de faux d\u00e9clenchement d\u00fb aux vibrations pendant le palpage), des valeurs plus \u00e9lev\u00e9es r\u00e9duisent les faux d\u00e9clenchements (mais n\u00e9cessitent une plus grande force de contact pour se d\u00e9clencher). Comme la sensibilit\u00e9 est \u00e9crite dans l'EEPROM, elle est conserv\u00e9e apr\u00e8s l'arr\u00eat, il n'est donc pas n\u00e9cessaire de la configurer \u00e0 chaque d\u00e9marrage de l'imprimante. ACCEL et RECOVERY_TIME permettent de modifier les param\u00e8tres correspondants lors de l'ex\u00e9cution, voir la section config de Smart Effector pour plus d'informations sur ces param\u00e8tres.","title":"SET_SMART_EFFECTOR"},{"location":"G-Codes.html#reset_smart_effector","text":"RESET_SMART_EFFECTOR : R\u00e9initialise la sensibilit\u00e9 du Smart Effector \u00e0 ses param\u00e8tres d'usine. N\u00e9cessite que control_pin soit fourni dans la section de configuration.","title":"RESET_SMART_EFFECTOR"},{"location":"G-Codes.html#stepper_enable","text":"Le module stepper_enable est automatiquement charg\u00e9.","title":"[stepper_enable]"},{"location":"G-Codes.html#set_stepper_enable","text":"SET_STEPPER_ENABLE STEPPER=<nom_de_la_configuration> ENABLE=[0|1] : Active ou d\u00e9sactive uniquement le stepper donn\u00e9. Il s'agit d'un outil de diagnostic et de d\u00e9bogage qui doit donc \u00eatre utilis\u00e9 avec pr\u00e9caution. La d\u00e9sactivation d'un moteur d'axe ne r\u00e9initialise pas les informations d'orientation. Le d\u00e9placement manuel d'un moteur pas \u00e0 pas d\u00e9sactiv\u00e9 peut amener la machine \u00e0 faire fonctionner le moteur en dehors des limites de s\u00e9curit\u00e9. Cela peut entra\u00eener des dommages aux composants de l'axe, aux extr\u00e9mit\u00e9s chaudes et \u00e0 la surface d'impression.","title":"SET_STEPPER_ENABLE"},{"location":"G-Codes.html#temperature_fan","text":"La commande suivante est disponible lorsqu'une section temperature_fan config est activ\u00e9e.","title":"[temperature_fan]"},{"location":"G-Codes.html#set_temperature_fan_target","text":"SET_TEMPERATURE_FAN_TARGET temperature_fan=<nom_du_ventilateur_temp\u00e9rature> [target=<temp\u00e9rature_cible>] [min_speed=<vitesse_min>] [max_speed=<vitesse_max>] : D\u00e9finit la temp\u00e9rature cible d'un ventilateur_temp\u00e9rature. Si une cible n'est pas fournie, elle est fix\u00e9e \u00e0 la temp\u00e9rature sp\u00e9cifi\u00e9e dans le fichier de configuration. Si les vitesses ne sont pas fournies, aucun changement n'est appliqu\u00e9.","title":"SET_TEMPERATURE_FAN_TARGET"},{"location":"G-Codes.html#tmcxxxx","text":"Les commandes suivantes sont disponibles lorsque l'une des sections tmcXXXX config est activ\u00e9e.","title":"[tmcXXXX]"},{"location":"G-Codes.html#dump_tmc","text":"DUMP_TMC STEPPER=<nom> : Cette commande lit les registres du pilote TMC et renvoie leurs valeurs.","title":"DUMP_TMC"},{"location":"G-Codes.html#init_tmc","text":"INIT_TMC STEPPER=<nom> : Cette commande initialise les registres de la puce TMC. N\u00e9cessaire pour r\u00e9activer le pilote si l'alimentation de la puce est coup\u00e9e puis r\u00e9tablie.","title":"INIT_TMC"},{"location":"G-Codes.html#set_tmc_current","text":"SET_TMC_CURRENT STEPPER=<nom> CURRENT=<amps> HOLDCURRENT=<amps> : Ceci ajustera les courants de marche et de maintien du pilote TMC. (HOLDCURRENT n'est pas applicable aux pilotes tmc2660).","title":"SET_TMC_CURRENT"},{"location":"G-Codes.html#set_tmc_field","text":"SET_TMC_FIELD STEPPER=<nom> FIELD=<champ> VALUE=<valeur> : Cette commande modifie la valeur du champ de registre sp\u00e9cifi\u00e9 du pilote TMC. Cette commande est destin\u00e9e aux diagnostics de bas niveau et au d\u00e9bogage uniquement car la modification des champs pendant l'ex\u00e9cution peut entra\u00eener un comportement ind\u00e9sirable et potentiellement dangereux de votre imprimante. Les modifications permanentes doivent \u00eatre effectu\u00e9es \u00e0 l'aide du fichier de configuration de l'imprimante. Aucun contr\u00f4le d'int\u00e9grit\u00e9 n'est effectu\u00e9 pour les valeurs donn\u00e9es.","title":"SET_TMC_FIELD"},{"location":"G-Codes.html#toolhead","text":"Le module de t\u00eate d'outil est automatiquement charg\u00e9.","title":"[toolhead]"},{"location":"G-Codes.html#set_velocity_limit","text":"SET_VELOCITY_LIMIT [VELOCITY=<valeur>] [ACCEL=<valeur>] [ACCEL_TO_DECEL=<valeur>] [SQUARE_CORNER_VELOCITY=<valeur>] : Modifie les limites de v\u00e9locit\u00e9 de l'imprimante.","title":"SET_VELOCITY_LIMIT"},{"location":"G-Codes.html#tuning_tower","text":"Le module tuning_tower est automatiquement charg\u00e9.","title":"[tuning_tower]"},{"location":"G-Codes.html#tuning_tower_1","text":"TUNING_TOWER COMMAND=<commande> PARAMETER=<nom> START=<valeur> [SKIP=<valeur>] [FACTOR=<valeur> [BAND=<valeur>]]. | [STEP_DELTA=<valeur> STEP_HEIGHT=<valeur>] : Un outil pour affiner un param\u00e8tre sur chaque hauteur Z pendant une impression. L'outil ex\u00e9cutera la COMMANDE donn\u00e9e avec le PARAM\u00c8TRE donn\u00e9 assign\u00e9 \u00e0 une valeur qui varie avec Z selon une formule. Utilisez FACTOR si vous allez utiliser une r\u00e8gle ou un pied \u00e0 coulisse pour mesurer la hauteur Z de la valeur optimale, ou STEP_DELTA et STEP_HEIGHT si le mod\u00e8le de tour de r\u00e9glage a des bandes de valeurs discr\u00e8tes comme c'est le cas avec les tours de temp\u00e9rature. Si SKIP=<valeur> est sp\u00e9cifi\u00e9, le processus de r\u00e9glage ne commence pas avant que la hauteur Z <valeur> soit atteinte, et en dessous, la valeur sera mise \u00e0 START ; dans ce cas, la z_height utilis\u00e9e dans les formules ci-dessous est en fait max(z - skip, 0) . Il y a trois combinaisons possibles d'options : FACTOR : La valeur change \u00e0 un taux de factor par millim\u00e8tre. La formule utilis\u00e9e est : valeur = start + factor * z_height . Vous pouvez ins\u00e9rer la hauteur Z optimale directement dans la formule pour d\u00e9terminer la valeur optimale du param\u00e8tre. FACTOR and BAND : La valeur change \u00e0 un taux moyen de factor par millim\u00e8tre, mais dans des bandes discr\u00e8tes o\u00f9 l'ajustement ne sera fait que tous les BAND millim\u00e8tres de hauteur Z. La formule utilis\u00e9e est : valeur =start + factor * ((floor(z_height / band) + .5) * band) . STEP_DELTA et STEP_HEIGHT : La valeur change de STEP_DELTA tous les millim\u00e8tres de STEP_HEIGHT . La formule utilis\u00e9e est : valeur = start + step_delta * floor(z_height / step_height) . Vous pouvez simplement compter les bandes ou lire les \u00e9tiquettes des tours de r\u00e9glage pour d\u00e9terminer la valeur optimale.","title":"TUNING_TOWER"},{"location":"G-Codes.html#virtual_sdcard","text":"Klipper prend en charge les commandes G-Code standards suivantes si la section de configuration virtual_sdcard est activ\u00e9e : Liste des cartes SD : M20 Initialiser la carte SD : M21 S\u00e9lectionnez le fichier SD : M23 <nom du fichier> D\u00e9marrer/reprendre l'impression SD : M24 Suspendre l'impression depuis la SD : M25 D\u00e9finir la position SD : M26 S<d\u00e9calage> Afficher l'\u00e9tat d'impression depuis la carte SD : M27 En outre, les commandes \u00e9tendues suivantes sont disponibles lorsque la section de configuration \"virtual_sdcard\" est activ\u00e9e.","title":"[virtual_sdcard]"},{"location":"G-Codes.html#sdcard_print_file","text":"SDCARD_PRINT_FILE FILENAME=<nom_fichier> : Charge un fichier et lance l'impression SD.","title":"SDCARD_PRINT_FILE"},{"location":"G-Codes.html#sdcard_reset_file","text":"SDCARD_RESET_FILE : D\u00e9charge le fichier et efface l'\u00e9tat de la carte SD.","title":"SDCARD_RESET_FILE"},{"location":"G-Codes.html#z_thermal_adjust","text":"Les commandes suivantes sont disponibles lorsque la section z_thermal_adjust config est activ\u00e9e.","title":"[z_thermal_adjust]"},{"location":"G-Codes.html#set_z_thermal_adjust","text":"SET_Z_THERMAL_ADJUST [ENABLE=<0:1>] [TEMP_COEFF=<valeur>] [REF_TEMP=<valeur>] : Active ou d\u00e9sactive l'ajustement thermique Z avec ENABLE . La d\u00e9sactivation ne supprime pas l'ajustement d\u00e9j\u00e0 appliqu\u00e9, mais g\u00e8le la valeur d'ajustement actuelle - cela emp\u00eache un mouvement Z vers le bas potentiellement dangereux. La r\u00e9activation peut potentiellement causer un mouvement de l'outil vers le haut lorsque l'ajustement est mis \u00e0 jour et appliqu\u00e9. TEMP_COEFF permet de r\u00e9gler le coefficient de temp\u00e9rature de l'ajustement en cours d'ex\u00e9cution (c'est-\u00e0-dire le param\u00e8tre de configuration TEMP_COEFF ). Les valeurs de TEMP_COEFF ne sont pas sauvegard\u00e9es dans la config. REF_TEMP remplace manuellement la temp\u00e9rature de r\u00e9f\u00e9rence g\u00e9n\u00e9ralement r\u00e9gl\u00e9e pendant le retour \u00e0 l'origine (pour une utilisation dans des routines de retour \u00e0 l'origine non standard) - sera remis \u00e0 z\u00e9ro automatiquement lors du retour \u00e0 l'origine.","title":"SET_Z_THERMAL_ADJUST"},{"location":"G-Codes.html#z_tilt","text":"Les commandes suivantes sont disponibles lorsque la section z_tilt config est activ\u00e9e.","title":"[z_tilt]"},{"location":"G-Codes.html#z_tilt_adjust","text":"Z_TILT_ADJUST [<probe_parameter>=<valeur>] : Cette commande palpe les points sp\u00e9cifi\u00e9s dans la configuration et effectue ensuite des ajustements ind\u00e9pendants pour chaque moteur Z afin de compenser l'inclinaison. Reportez-vous \u00e0 la commande PROBE pour plus de d\u00e9tails sur les param\u00e8tres de palpage optionnels.","title":"Z_TILT_ADJUST"},{"location":"Hall_Filament_Width_Sensor.html","text":"D\u00e9tecteur de largeur de filament \u00e0 effet hall \u00b6 Ce document d\u00e9crit le module h\u00f4te du capteur de largeur de filament. Le mat\u00e9riel utilis\u00e9 pour d\u00e9velopper ce module h\u00f4te est bas\u00e9 sur deux capteurs lin\u00e9aires de type Hall (ss49e par exemple). Les capteurs dans le corps sont situ\u00e9s sur des c\u00f4t\u00e9s oppos\u00e9s. Principe de fonctionnement : deux capteurs Hall fonctionnent en mode diff\u00e9rentiel, la d\u00e9rive de temp\u00e9rature est la m\u00eame pour tous les capteurs. Une compensation sp\u00e9ciale de la temp\u00e9rature n'est donc pas n\u00e9cessaire. Vous trouverez les mod\u00e8les sur Thingiverse , une vid\u00e9o de montage est \u00e9galement disponible sur Youtube Pour utiliser le capteur de largeur de filament de Hall, consultez R\u00e9f\u00e9rence des configurations et documentation G-Code . Comment cela fonctionne-t-il ? \u00b6 Le capteur g\u00e9n\u00e8re deux sorties analogiques bas\u00e9es sur la largeur calcul\u00e9e du filament. La somme des tensions de sortie est toujours \u00e9gale \u00e0 la largeur de filament d\u00e9tect\u00e9e. Le module h\u00f4te surveille les changements de tension et ajuste le multiplicateur d'extrusion. J'utilise le connecteur aux2 sur les broches analogiques 11 et 12 d'une carte genre Ramps. Vous pouvez utiliser des broches diff\u00e9rentes et des cartes diff\u00e9rentes. Mod\u00e8le pour les variables du menu \u00b6 [menu __main __filament __width_current] type: command enable: {'hall_filament_width_sensor' in printer} name: Dia: {'%.2F' % printer.hall_filament_width_sensor.Diameter} index: 0 [menu __main __filament __raw_width_current] type: command enable: {'hall_filament_width_sensor' in printer} name: Raw: {'%4.0F' % printer.hall_filament_width_sensor.Raw} index: 1 Proc\u00e9dure d'\u00e9talonnage \u00b6 Pour obtenir la valeur brute du capteur, vous pouvez utiliser le menu ou la commande QUERY_RAW_FILAMENT_WIDTH dans le terminal. Ins\u00e9rer la premi\u00e8re tige d'\u00e9talonnage (taille 1,5 mm) pour obtenir la premi\u00e8re valeur brute du capteur Ins\u00e9rer une deuxi\u00e8me tige d'\u00e9talonnage (taille 2,0 mm) pour obtenir la deuxi\u00e8me valeur brute du capteur Enregistrer les valeurs brutes des capteurs dans les param\u00e8tres de configuration Raw_dia1 et Raw_dia2 Comment activer le capteur \u00b6 Par d\u00e9faut, le capteur est d\u00e9sactiv\u00e9 \u00e0 la mise sous tension. Pour activer le capteur, lancez la commande ENABLE_FILAMENT_WIDTH_SENSOR ou d\u00e9finissez le param\u00e8tre enable sur true . Journalisation \u00b6 Par d\u00e9faut, la journalisation du diam\u00e8tre est d\u00e9sactiv\u00e9e \u00e0 la mise sous tension. Envoyez la commande ENABLE_FILAMENT_WIDTH_LOG pour d\u00e9marrer la journalisation, envoyez la commande DISABLE_FILAMENT_WIDTH_LOG pour l'arr\u00eater. Pour activer la journalisation \u00e0 la mise sous tension, d\u00e9finissez le param\u00e8tre logging \u00e0 true . Le diam\u00e8tre du filament est enregistr\u00e9 \u00e0 chaque intervalle de mesure (10 mm par d\u00e9faut).","title":"D\u00e9tecteur de largeur de filament \u00e0 effet hall"},{"location":"Hall_Filament_Width_Sensor.html#detecteur-de-largeur-de-filament-a-effet-hall","text":"Ce document d\u00e9crit le module h\u00f4te du capteur de largeur de filament. Le mat\u00e9riel utilis\u00e9 pour d\u00e9velopper ce module h\u00f4te est bas\u00e9 sur deux capteurs lin\u00e9aires de type Hall (ss49e par exemple). Les capteurs dans le corps sont situ\u00e9s sur des c\u00f4t\u00e9s oppos\u00e9s. Principe de fonctionnement : deux capteurs Hall fonctionnent en mode diff\u00e9rentiel, la d\u00e9rive de temp\u00e9rature est la m\u00eame pour tous les capteurs. Une compensation sp\u00e9ciale de la temp\u00e9rature n'est donc pas n\u00e9cessaire. Vous trouverez les mod\u00e8les sur Thingiverse , une vid\u00e9o de montage est \u00e9galement disponible sur Youtube Pour utiliser le capteur de largeur de filament de Hall, consultez R\u00e9f\u00e9rence des configurations et documentation G-Code .","title":"D\u00e9tecteur de largeur de filament \u00e0 effet hall"},{"location":"Hall_Filament_Width_Sensor.html#comment-cela-fonctionne-t-il","text":"Le capteur g\u00e9n\u00e8re deux sorties analogiques bas\u00e9es sur la largeur calcul\u00e9e du filament. La somme des tensions de sortie est toujours \u00e9gale \u00e0 la largeur de filament d\u00e9tect\u00e9e. Le module h\u00f4te surveille les changements de tension et ajuste le multiplicateur d'extrusion. J'utilise le connecteur aux2 sur les broches analogiques 11 et 12 d'une carte genre Ramps. Vous pouvez utiliser des broches diff\u00e9rentes et des cartes diff\u00e9rentes.","title":"Comment cela fonctionne-t-il ?"},{"location":"Hall_Filament_Width_Sensor.html#modele-pour-les-variables-du-menu","text":"[menu __main __filament __width_current] type: command enable: {'hall_filament_width_sensor' in printer} name: Dia: {'%.2F' % printer.hall_filament_width_sensor.Diameter} index: 0 [menu __main __filament __raw_width_current] type: command enable: {'hall_filament_width_sensor' in printer} name: Raw: {'%4.0F' % printer.hall_filament_width_sensor.Raw} index: 1","title":"Mod\u00e8le pour les variables du menu"},{"location":"Hall_Filament_Width_Sensor.html#procedure-detalonnage","text":"Pour obtenir la valeur brute du capteur, vous pouvez utiliser le menu ou la commande QUERY_RAW_FILAMENT_WIDTH dans le terminal. Ins\u00e9rer la premi\u00e8re tige d'\u00e9talonnage (taille 1,5 mm) pour obtenir la premi\u00e8re valeur brute du capteur Ins\u00e9rer une deuxi\u00e8me tige d'\u00e9talonnage (taille 2,0 mm) pour obtenir la deuxi\u00e8me valeur brute du capteur Enregistrer les valeurs brutes des capteurs dans les param\u00e8tres de configuration Raw_dia1 et Raw_dia2","title":"Proc\u00e9dure d'\u00e9talonnage"},{"location":"Hall_Filament_Width_Sensor.html#comment-activer-le-capteur","text":"Par d\u00e9faut, le capteur est d\u00e9sactiv\u00e9 \u00e0 la mise sous tension. Pour activer le capteur, lancez la commande ENABLE_FILAMENT_WIDTH_SENSOR ou d\u00e9finissez le param\u00e8tre enable sur true .","title":"Comment activer le capteur"},{"location":"Hall_Filament_Width_Sensor.html#journalisation","text":"Par d\u00e9faut, la journalisation du diam\u00e8tre est d\u00e9sactiv\u00e9e \u00e0 la mise sous tension. Envoyez la commande ENABLE_FILAMENT_WIDTH_LOG pour d\u00e9marrer la journalisation, envoyez la commande DISABLE_FILAMENT_WIDTH_LOG pour l'arr\u00eater. Pour activer la journalisation \u00e0 la mise sous tension, d\u00e9finissez le param\u00e8tre logging \u00e0 true . Le diam\u00e8tre du filament est enregistr\u00e9 \u00e0 chaque intervalle de mesure (10 mm par d\u00e9faut).","title":"Journalisation"},{"location":"Installation.html","text":"Installation \u00b6 Ces instructions supposent que le logiciel fonctionnera sur un ordinateur Raspberry Pi en conjonction avec OctoPrint. Il est recommand\u00e9 d'utiliser un ordinateur Raspberry Pi 2, 3 ou 4 comme machine h\u00f4te (voir la FAQ pour les autres machines). Obtenir un fichier de configuration de Klipper \u00b6 La plupart des param\u00e8tres de Klipper sont d\u00e9termin\u00e9s par un \"fichier de configuration d'imprimante\" stock\u00e9 sur le Raspberry Pi. Un fichier de configuration appropri\u00e9 peut souvent \u00eatre trouv\u00e9 en recherchant dans le r\u00e9pertoire des configurations de Klipper, un fichier commen\u00e7ant par un pr\u00e9fixe \"printer-\" correspondant \u00e0 l'imprimante cible. Le fichier de configuration de Klipper contient des informations techniques sur l'imprimante n\u00e9cessaires pendant l'installation. S'il n'y a pas de fichier de configuration d'imprimante appropri\u00e9 dans le r\u00e9pertoire des configurations de Klipper, essayez de rechercher le site Web du fabricant de l'imprimante pour voir s'il y a un fichier de configuration Klipper appropri\u00e9. Si aucun fichier de configuration pour l'imprimante ne peut \u00eatre trouv\u00e9, mais que le type de carte de contr\u00f4le de l'imprimante est connu, recherchez un fichier de configuration appropri\u00e9 commen\u00e7ant par un pr\u00e9fixe \"generic-\". Ces exemples de fichiers de carte d'imprimante devraient permettre de r\u00e9aliser avec succ\u00e8s l'installation initiale, mais n\u00e9cessiteront une personnalisation afin d'obtenir la fonctionnalit\u00e9 compl\u00e8te de l'imprimante. Il est \u00e9galement possible de d\u00e9finir une nouvelle configuration d'imprimante en partant de z\u00e9ro. Toutefois, cela n\u00e9cessite des connaissances techniques importantes sur l'imprimante et son \u00e9lectronique. Il est recommand\u00e9 \u00e0 la plupart des utilisateurs de commencer par un fichier de configuration appropri\u00e9. Si vous cr\u00e9ez un nouveau fichier de configuration d'imprimante personnalis\u00e9, commencez par l'exemple d'un fichier de configuration proche et utilisez la r\u00e9f\u00e9rence de configuration de Klipper pour plus d'informations. Pr\u00e9paration de l'image du syst\u00e8me d'exploitation (OS) \u00b6 Commencez par installer OctoPi sur l'ordinateur Raspberry Pi. Utilisez OctoPi v0.17.0 ou plus r\u00e9cent - voir les OctoPi releases pour les informations de versions. Il faut v\u00e9rifier que OctoPi d\u00e9marre et que le serveur web OctoPrint fonctionne. Apr\u00e8s s'\u00eatre connect\u00e9 \u00e0 la page web d'OctoPrint, suivez les instructions pour mettre \u00e0 jour OctoPrint \u00e0 la version v1.4.2 ou ult\u00e9rieure. Apr\u00e8s avoir install\u00e9 OctoPi et mis \u00e0 jour OctoPrint, il sera n\u00e9cessaire de se connecter via ssh \u00e0 la machine cible pour ex\u00e9cuter quelques commandes syst\u00e8me. Si vous utilisez un bureau Linux ou MacOS, le logiciel \"ssh\" devrait d\u00e9j\u00e0 \u00eatre install\u00e9 sur le bureau. Il existe des clients ssh gratuits pour d'autres ordinateurs de bureau (par exemple, PuTTY ). Utilisez l'utilitaire ssh pour vous connecter au Raspberry Pi (ssh pi@octopi -- le mot de passe par d\u00e9faut est \"raspberry\") et ex\u00e9cutez les commandes suivantes : git clone https://github.com/Klipper3d/klipper ./klipper/scripts/install-octopi.sh L'op\u00e9ration ci-dessus permet de t\u00e9l\u00e9charger Klipper, d'installer certaines d\u00e9pendances du syst\u00e8me, de configurer Klipper pour qu'il soit ex\u00e9cut\u00e9 au d\u00e9marrage du syst\u00e8me et de lancer le logiciel h\u00f4te Klipper. Une connexion Internet est n\u00e9cessaire et l'op\u00e9ration peut prendre quelques minutes. Compilation et flashage du micro-contr\u00f4leur \u00b6 Pour compiler le code du microcontr\u00f4leur, commencez par ex\u00e9cuter ces commandes sur le Raspberry Pi : cd ~/klipper/ make menuconfig Les commentaires en haut du fichier de configuration de l'imprimante devraient d\u00e9crire les param\u00e8tres qui doivent \u00eatre d\u00e9finis pendant le \"make menuconfig\". Ouvrez le fichier dans un navigateur Web ou un \u00e9diteur de texte et recherchez ces instructions en haut du fichier. Une fois que les param\u00e8tres appropri\u00e9s de \"menuconfig\" ont \u00e9t\u00e9 configur\u00e9s, appuyez sur \"Q\" pour quitter, puis sur \"Y\" pour enregistrer. Ensuite, ex\u00e9cutez : make Si les commentaires au haut de printer configuration file d\u00e9crive des \u00e9tapes pour le \"flashing\" de l'image finale sur la carte de contr\u00f4le de l'imprimante alors suivez ces \u00e9tapes puis proc\u00e9dez \u00e0 configuring OctoPrint . Sinon, les \u00e9tapes suivantes sont souvent utilis\u00e9es pour le \"flash\" de la carte de contr\u00f4le de l'imprimante. D'abord, il est n\u00e9cessaire de d\u00e9terminer le port s\u00e9rie connect\u00e9 au micro-contr\u00f4leur. Lancez ceci : ls /dev/serial/by-id/* Il devrait retourner quelque chose de similaire \u00e0 ce qui suit : /dev/serial/by-id/usb-1a86_USB2.0-Serial-if00-port0 Il est courant que chaque imprimante ait son propre nom de port s\u00e9rie unique. Ce nom unique sera utilis\u00e9 lors du flashage du micro-contr\u00f4leur. Il est possible qu'il y ait plusieurs lignes dans la sortie ci-dessus - si c'est le cas, choisissez la ligne correspondant au micro-contr\u00f4leur (voir la FAQ pour plus d'informations). Pour les micro-contr\u00f4leurs courants, le code peut \u00eatre flash\u00e9 avec quelque chose de similaire : sudo service klipper stop make flash FLASH_DEVICE=/dev/serial/by-id/usb-1a86_USB2.0-Serial-if00-port0 sudo service klipper start Veillez \u00e0 mettre \u00e0 jour le FLASH_DEVICE avec le nom unique du port s\u00e9rie de l'imprimante. Lors du premier flashage, assurez-vous qu'OctoPrint n'est pas connect\u00e9 directement \u00e0 l'imprimante (\u00e0 partir de la page web d'OctoPrint, sous la section \"Connexion\", cliquez sur \"D\u00e9connecter\"). Configuration d'OctoPrint pour utiliser Klipper \u00b6 Le serveur web OctoPrint doit \u00eatre configur\u00e9 pour communiquer avec le logiciel h\u00f4te Klipper. \u00c0 l'aide d'un navigateur Web, connectez-vous \u00e0 la page Web d'OctoPrint, puis configurez les \u00e9l\u00e9ments suivants : Naviguez vers l'onglet \"Settings\" (l'ic\u00f4ne de la cl\u00e9 \u00e0 molette en haut de la page). Sous \"Serial Connection\" dans \"Additional serial ports\" ajoutez \"/tmp/printer\". Cliquez ensuite sur \"Save\". Entrez \u00e0 nouveau dans l'onglet Param\u00e8tres et, sous \"Connexion s\u00e9rie\", changez le param\u00e8tre \"Port s\u00e9rie\" en \"/tmp/printer\". Dans l'onglet \"Param\u00e8tres\", acc\u00e9dez au sous-onglet \"Behavior\" et s\u00e9lectionnez l'option \"Cancel any ongoing prints but stay connected to the printer\". Cliquez sur \"Enregistrer\". Sur la page principale, dans la section \"Connection\" (en haut \u00e0 gauche de la page), assurez-vous que le \"Serial Port\" est r\u00e9gl\u00e9 sur \"/tmp/printer\" et cliquez sur \"Connect\". (si \"/tmp/printer\" n'est pas une s\u00e9lection disponible, essayez de recharger la page.) Une fois connect\u00e9, naviguez vers l'onglet \"Terminal\" et tapez \"status\" (sans les guillemets) dans la bo\u00eete de saisie de la commande et cliquez sur \"Send\". La fen\u00eatre du terminal indiquera probablement qu'il y a une erreur dans l'ouverture du fichier de configuration - cela signifie qu'OctoPrint communique avec succ\u00e8s avec Klipper. Passez \u00e0 la section suivante. Configuration de Klipper \u00b6 La prochaine \u00e9tape est de copier le printer configuration file dans le Raspberry Pi. La fa\u00e7on la plus simple de d\u00e9finir le fichier de configuration de Klipper est d'utiliser un \u00e9diteur de bureau qui prend en charge l'\u00e9dition de fichiers via les protocoles \"scp\" et/ou \"sftp\". Il existe des outils disponibles gratuitement qui prenant en charge cette fonction (par exemple, Notepad++, WinSCP et Cyberduck). Chargez le fichier de configuration de l'imprimante dans l'\u00e9diteur, puis sauvegardez-le dans un fichier nomm\u00e9 \"printer.cfg\" dans le r\u00e9pertoire personnel de l'utilisateur pi (par exemple, /home/pi/printer.cfg). On peut \u00e9galement copier et modifier le fichier directement sur le Raspberry Pi via ssh. Cela peut ressembler \u00e0 ce qui suit (veillez \u00e0 mettre \u00e0 jour la commande pour utiliser le nom de fichier de configuration de l'imprimante appropri\u00e9) : cp ~/klipper/config/example-cartesian.cfg ~/printer.cfg nano ~/printer.cfg C'est classique pour chaque imprimante d'avoir son propre nom pour le micro-contr\u00f4leur. Le nom peut changer apr\u00e8s le flashing de Klipper, relancez donc ces \u00e9tapes \u00e0 nouveau m\u00eame si elles ont d\u00e9j\u00e0 \u00e9t\u00e9 faites lors du flashing. Lancez : ls /dev/serial/by-id/* Il devrait retourner quelque chose de similaire \u00e0 ce qui suit : /dev/serial/by-id/usb-1a86_USB2.0-Serial-if00-port0 Puis mettez \u00e0 jour le fichier de configuration avec un nom unique. Par exemple, mettez \u00e0 jour la section [mcu] pour ressembler \u00e0 quelque chose comme : [mcu] serial: /dev/serial/by-id/usb-1a86_USB2.0-Serial-if00-port0 Apr\u00e8s avoir cr\u00e9\u00e9 et \u00e9dit\u00e9 le fichier, il sera n\u00e9cessaire de lancer une commande \"restart\" dans le terminal web OctoPrint pour charger la configuration. Une commande \"status\" indiquera que l'imprimante est pr\u00eate si le fichier de configuration Klipper est lu avec succ\u00e8s et si le micro-contr\u00f4leur est trouv\u00e9 et configur\u00e9 avec succ\u00e8s. Lors de la personnalisation du fichier de configuration de l'imprimante, il n'est pas rare que Klipper signale une erreur de configuration. Si une erreur se produit, apportez les corrections n\u00e9cessaires au fichier de configuration de l'imprimante et lancez \"restart\" jusqu'\u00e0 ce que \"status\" indique que l'imprimante est pr\u00eate. Klipper rapporte les messages d'erreur via l'onglet du terminal OctoPrint. La commande \"status\" peut \u00eatre utilis\u00e9e pour rapporter \u00e0 nouveau les messages d'erreur. Le script de d\u00e9marrage par d\u00e9faut de Klipper place \u00e9galement un journal dans /tmp/klippy.log qui fournit des informations plus d\u00e9taill\u00e9es. Une fois que Klipper a signal\u00e9 que l'imprimante est pr\u00eate, passez au document de v\u00e9rification de la configuration pour effectuer les v\u00e9rifications de base sur les d\u00e9finitions du fichier de configuration. Pour plus d'informations, consultez la r\u00e9f\u00e9rence de documentation principale pour plus d'informations.","title":"Installation"},{"location":"Installation.html#installation","text":"Ces instructions supposent que le logiciel fonctionnera sur un ordinateur Raspberry Pi en conjonction avec OctoPrint. Il est recommand\u00e9 d'utiliser un ordinateur Raspberry Pi 2, 3 ou 4 comme machine h\u00f4te (voir la FAQ pour les autres machines).","title":"Installation"},{"location":"Installation.html#obtenir-un-fichier-de-configuration-de-klipper","text":"La plupart des param\u00e8tres de Klipper sont d\u00e9termin\u00e9s par un \"fichier de configuration d'imprimante\" stock\u00e9 sur le Raspberry Pi. Un fichier de configuration appropri\u00e9 peut souvent \u00eatre trouv\u00e9 en recherchant dans le r\u00e9pertoire des configurations de Klipper, un fichier commen\u00e7ant par un pr\u00e9fixe \"printer-\" correspondant \u00e0 l'imprimante cible. Le fichier de configuration de Klipper contient des informations techniques sur l'imprimante n\u00e9cessaires pendant l'installation. S'il n'y a pas de fichier de configuration d'imprimante appropri\u00e9 dans le r\u00e9pertoire des configurations de Klipper, essayez de rechercher le site Web du fabricant de l'imprimante pour voir s'il y a un fichier de configuration Klipper appropri\u00e9. Si aucun fichier de configuration pour l'imprimante ne peut \u00eatre trouv\u00e9, mais que le type de carte de contr\u00f4le de l'imprimante est connu, recherchez un fichier de configuration appropri\u00e9 commen\u00e7ant par un pr\u00e9fixe \"generic-\". Ces exemples de fichiers de carte d'imprimante devraient permettre de r\u00e9aliser avec succ\u00e8s l'installation initiale, mais n\u00e9cessiteront une personnalisation afin d'obtenir la fonctionnalit\u00e9 compl\u00e8te de l'imprimante. Il est \u00e9galement possible de d\u00e9finir une nouvelle configuration d'imprimante en partant de z\u00e9ro. Toutefois, cela n\u00e9cessite des connaissances techniques importantes sur l'imprimante et son \u00e9lectronique. Il est recommand\u00e9 \u00e0 la plupart des utilisateurs de commencer par un fichier de configuration appropri\u00e9. Si vous cr\u00e9ez un nouveau fichier de configuration d'imprimante personnalis\u00e9, commencez par l'exemple d'un fichier de configuration proche et utilisez la r\u00e9f\u00e9rence de configuration de Klipper pour plus d'informations.","title":"Obtenir un fichier de configuration de Klipper"},{"location":"Installation.html#preparation-de-limage-du-systeme-dexploitation-os","text":"Commencez par installer OctoPi sur l'ordinateur Raspberry Pi. Utilisez OctoPi v0.17.0 ou plus r\u00e9cent - voir les OctoPi releases pour les informations de versions. Il faut v\u00e9rifier que OctoPi d\u00e9marre et que le serveur web OctoPrint fonctionne. Apr\u00e8s s'\u00eatre connect\u00e9 \u00e0 la page web d'OctoPrint, suivez les instructions pour mettre \u00e0 jour OctoPrint \u00e0 la version v1.4.2 ou ult\u00e9rieure. Apr\u00e8s avoir install\u00e9 OctoPi et mis \u00e0 jour OctoPrint, il sera n\u00e9cessaire de se connecter via ssh \u00e0 la machine cible pour ex\u00e9cuter quelques commandes syst\u00e8me. Si vous utilisez un bureau Linux ou MacOS, le logiciel \"ssh\" devrait d\u00e9j\u00e0 \u00eatre install\u00e9 sur le bureau. Il existe des clients ssh gratuits pour d'autres ordinateurs de bureau (par exemple, PuTTY ). Utilisez l'utilitaire ssh pour vous connecter au Raspberry Pi (ssh pi@octopi -- le mot de passe par d\u00e9faut est \"raspberry\") et ex\u00e9cutez les commandes suivantes : git clone https://github.com/Klipper3d/klipper ./klipper/scripts/install-octopi.sh L'op\u00e9ration ci-dessus permet de t\u00e9l\u00e9charger Klipper, d'installer certaines d\u00e9pendances du syst\u00e8me, de configurer Klipper pour qu'il soit ex\u00e9cut\u00e9 au d\u00e9marrage du syst\u00e8me et de lancer le logiciel h\u00f4te Klipper. Une connexion Internet est n\u00e9cessaire et l'op\u00e9ration peut prendre quelques minutes.","title":"Pr\u00e9paration de l'image du syst\u00e8me d'exploitation (OS)"},{"location":"Installation.html#compilation-et-flashage-du-micro-controleur","text":"Pour compiler le code du microcontr\u00f4leur, commencez par ex\u00e9cuter ces commandes sur le Raspberry Pi : cd ~/klipper/ make menuconfig Les commentaires en haut du fichier de configuration de l'imprimante devraient d\u00e9crire les param\u00e8tres qui doivent \u00eatre d\u00e9finis pendant le \"make menuconfig\". Ouvrez le fichier dans un navigateur Web ou un \u00e9diteur de texte et recherchez ces instructions en haut du fichier. Une fois que les param\u00e8tres appropri\u00e9s de \"menuconfig\" ont \u00e9t\u00e9 configur\u00e9s, appuyez sur \"Q\" pour quitter, puis sur \"Y\" pour enregistrer. Ensuite, ex\u00e9cutez : make Si les commentaires au haut de printer configuration file d\u00e9crive des \u00e9tapes pour le \"flashing\" de l'image finale sur la carte de contr\u00f4le de l'imprimante alors suivez ces \u00e9tapes puis proc\u00e9dez \u00e0 configuring OctoPrint . Sinon, les \u00e9tapes suivantes sont souvent utilis\u00e9es pour le \"flash\" de la carte de contr\u00f4le de l'imprimante. D'abord, il est n\u00e9cessaire de d\u00e9terminer le port s\u00e9rie connect\u00e9 au micro-contr\u00f4leur. Lancez ceci : ls /dev/serial/by-id/* Il devrait retourner quelque chose de similaire \u00e0 ce qui suit : /dev/serial/by-id/usb-1a86_USB2.0-Serial-if00-port0 Il est courant que chaque imprimante ait son propre nom de port s\u00e9rie unique. Ce nom unique sera utilis\u00e9 lors du flashage du micro-contr\u00f4leur. Il est possible qu'il y ait plusieurs lignes dans la sortie ci-dessus - si c'est le cas, choisissez la ligne correspondant au micro-contr\u00f4leur (voir la FAQ pour plus d'informations). Pour les micro-contr\u00f4leurs courants, le code peut \u00eatre flash\u00e9 avec quelque chose de similaire : sudo service klipper stop make flash FLASH_DEVICE=/dev/serial/by-id/usb-1a86_USB2.0-Serial-if00-port0 sudo service klipper start Veillez \u00e0 mettre \u00e0 jour le FLASH_DEVICE avec le nom unique du port s\u00e9rie de l'imprimante. Lors du premier flashage, assurez-vous qu'OctoPrint n'est pas connect\u00e9 directement \u00e0 l'imprimante (\u00e0 partir de la page web d'OctoPrint, sous la section \"Connexion\", cliquez sur \"D\u00e9connecter\").","title":"Compilation et flashage du micro-contr\u00f4leur"},{"location":"Installation.html#configuration-doctoprint-pour-utiliser-klipper","text":"Le serveur web OctoPrint doit \u00eatre configur\u00e9 pour communiquer avec le logiciel h\u00f4te Klipper. \u00c0 l'aide d'un navigateur Web, connectez-vous \u00e0 la page Web d'OctoPrint, puis configurez les \u00e9l\u00e9ments suivants : Naviguez vers l'onglet \"Settings\" (l'ic\u00f4ne de la cl\u00e9 \u00e0 molette en haut de la page). Sous \"Serial Connection\" dans \"Additional serial ports\" ajoutez \"/tmp/printer\". Cliquez ensuite sur \"Save\". Entrez \u00e0 nouveau dans l'onglet Param\u00e8tres et, sous \"Connexion s\u00e9rie\", changez le param\u00e8tre \"Port s\u00e9rie\" en \"/tmp/printer\". Dans l'onglet \"Param\u00e8tres\", acc\u00e9dez au sous-onglet \"Behavior\" et s\u00e9lectionnez l'option \"Cancel any ongoing prints but stay connected to the printer\". Cliquez sur \"Enregistrer\". Sur la page principale, dans la section \"Connection\" (en haut \u00e0 gauche de la page), assurez-vous que le \"Serial Port\" est r\u00e9gl\u00e9 sur \"/tmp/printer\" et cliquez sur \"Connect\". (si \"/tmp/printer\" n'est pas une s\u00e9lection disponible, essayez de recharger la page.) Une fois connect\u00e9, naviguez vers l'onglet \"Terminal\" et tapez \"status\" (sans les guillemets) dans la bo\u00eete de saisie de la commande et cliquez sur \"Send\". La fen\u00eatre du terminal indiquera probablement qu'il y a une erreur dans l'ouverture du fichier de configuration - cela signifie qu'OctoPrint communique avec succ\u00e8s avec Klipper. Passez \u00e0 la section suivante.","title":"Configuration d'OctoPrint pour utiliser Klipper"},{"location":"Installation.html#configuration-de-klipper","text":"La prochaine \u00e9tape est de copier le printer configuration file dans le Raspberry Pi. La fa\u00e7on la plus simple de d\u00e9finir le fichier de configuration de Klipper est d'utiliser un \u00e9diteur de bureau qui prend en charge l'\u00e9dition de fichiers via les protocoles \"scp\" et/ou \"sftp\". Il existe des outils disponibles gratuitement qui prenant en charge cette fonction (par exemple, Notepad++, WinSCP et Cyberduck). Chargez le fichier de configuration de l'imprimante dans l'\u00e9diteur, puis sauvegardez-le dans un fichier nomm\u00e9 \"printer.cfg\" dans le r\u00e9pertoire personnel de l'utilisateur pi (par exemple, /home/pi/printer.cfg). On peut \u00e9galement copier et modifier le fichier directement sur le Raspberry Pi via ssh. Cela peut ressembler \u00e0 ce qui suit (veillez \u00e0 mettre \u00e0 jour la commande pour utiliser le nom de fichier de configuration de l'imprimante appropri\u00e9) : cp ~/klipper/config/example-cartesian.cfg ~/printer.cfg nano ~/printer.cfg C'est classique pour chaque imprimante d'avoir son propre nom pour le micro-contr\u00f4leur. Le nom peut changer apr\u00e8s le flashing de Klipper, relancez donc ces \u00e9tapes \u00e0 nouveau m\u00eame si elles ont d\u00e9j\u00e0 \u00e9t\u00e9 faites lors du flashing. Lancez : ls /dev/serial/by-id/* Il devrait retourner quelque chose de similaire \u00e0 ce qui suit : /dev/serial/by-id/usb-1a86_USB2.0-Serial-if00-port0 Puis mettez \u00e0 jour le fichier de configuration avec un nom unique. Par exemple, mettez \u00e0 jour la section [mcu] pour ressembler \u00e0 quelque chose comme : [mcu] serial: /dev/serial/by-id/usb-1a86_USB2.0-Serial-if00-port0 Apr\u00e8s avoir cr\u00e9\u00e9 et \u00e9dit\u00e9 le fichier, il sera n\u00e9cessaire de lancer une commande \"restart\" dans le terminal web OctoPrint pour charger la configuration. Une commande \"status\" indiquera que l'imprimante est pr\u00eate si le fichier de configuration Klipper est lu avec succ\u00e8s et si le micro-contr\u00f4leur est trouv\u00e9 et configur\u00e9 avec succ\u00e8s. Lors de la personnalisation du fichier de configuration de l'imprimante, il n'est pas rare que Klipper signale une erreur de configuration. Si une erreur se produit, apportez les corrections n\u00e9cessaires au fichier de configuration de l'imprimante et lancez \"restart\" jusqu'\u00e0 ce que \"status\" indique que l'imprimante est pr\u00eate. Klipper rapporte les messages d'erreur via l'onglet du terminal OctoPrint. La commande \"status\" peut \u00eatre utilis\u00e9e pour rapporter \u00e0 nouveau les messages d'erreur. Le script de d\u00e9marrage par d\u00e9faut de Klipper place \u00e9galement un journal dans /tmp/klippy.log qui fournit des informations plus d\u00e9taill\u00e9es. Une fois que Klipper a signal\u00e9 que l'imprimante est pr\u00eate, passez au document de v\u00e9rification de la configuration pour effectuer les v\u00e9rifications de base sur les d\u00e9finitions du fichier de configuration. Pour plus d'informations, consultez la r\u00e9f\u00e9rence de documentation principale pour plus d'informations.","title":"Configuration de Klipper"},{"location":"Kinematics.html","text":"Cin\u00e9matiques \u00b6 Ce document donne un aper\u00e7u de la fa\u00e7on dont Klipper impl\u00e9mente le mouvement du robot (sa cin\u00e9matique ). Ce contenu peut int\u00e9resser aussi bien les d\u00e9veloppeurs travaillant sur le logiciel Klipper que les utilisateurs int\u00e9ress\u00e9s \u00e0 mieux comprendre la m\u00e9canique de leurs machines. Acc\u00e9l\u00e9ration \u00b6 Klipper met en \u0153uvre un sch\u00e9ma d'acc\u00e9l\u00e9ration constante chaque fois que la t\u00eate d'impression change de vitesse - la vitesse est progressivement modifi\u00e9e pour atteindre la nouvelle vitesse au lieu d'\u00eatre brusquement atteinte. Klipper applique toujours l'acc\u00e9l\u00e9ration entre la t\u00eate de l'outil et l'impression. Le filament sortant de l'extrudeuse peut \u00eatre assez fragile - des secousses rapides et/ou des changements de d\u00e9bit de l'extrudeuse entra\u00eenent une qualit\u00e9 m\u00e9diocre et une mauvaise adh\u00e9rence du lit. M\u00eame en l'absence d'extrusion, si la t\u00eate d'impression se trouve au m\u00eame niveau que l'impression, des secousses rapides de la t\u00eate peuvent perturber le filament r\u00e9cemment d\u00e9pos\u00e9. Limiter les changements de vitesse de la t\u00eate d'impression (par rapport \u00e0 l'impression) r\u00e9duit les risques de perturbation de l'impression. Il est \u00e9galement important de limiter l'acc\u00e9l\u00e9ration afin que les moteurs pas \u00e0 pas ne perdent pas de pas et ne soumettent pas la machine \u00e0 des contraintes excessives. Klipper limite le couple de chaque moteur pas \u00e0 pas en limitant l'acc\u00e9l\u00e9ration de la t\u00eate d'impression. Le fait d'imposer une acc\u00e9l\u00e9ration \u00e0 la t\u00eate d'impression limite naturellement aussi le couple des moteurs pas \u00e0 pas qui d\u00e9placent la t\u00eate d'impression (l'inverse n'est pas toujours vrai). Klipper met en \u0153uvre une acc\u00e9l\u00e9ration constante. La formule cl\u00e9 de l'acc\u00e9l\u00e9ration constante est la suivante : velocity(time) = start_velocity + accel*time G\u00e9n\u00e9rateur de trap\u00e9zo\u00efdes \u00b6 Klipper utilise un \"g\u00e9n\u00e9rateur de trap\u00e8ze\" traditionnel pour mod\u00e9liser le mouvement de chaque d\u00e9placement - chaque d\u00e9placement a une vitesse de d\u00e9part, il acc\u00e9l\u00e8re jusqu'\u00e0 une vitesse de croisi\u00e8re \u00e0 une acc\u00e9l\u00e9ration constante, il se d\u00e9place \u00e0 une vitesse constante, puis d\u00e9c\u00e9l\u00e8re jusqu'\u00e0 la vitesse finale en utilisant une d\u00e9c\u00e9l\u00e9ration constante. On l'appelle \"g\u00e9n\u00e9rateur de trap\u00e8ze\" parce que le diagramme de vitesse du mouvement ressemble \u00e0 un trap\u00e8ze. La vitesse de croisi\u00e8re est toujours sup\u00e9rieure ou \u00e9gale \u00e0 la fois \u00e0 la vitesse de d\u00e9part et \u00e0 la vitesse d'arriv\u00e9e. La phase d'acc\u00e9l\u00e9ration peut \u00eatre de dur\u00e9e nulle (si la vitesse de d\u00e9part est \u00e9gale \u00e0 la vitesse de croisi\u00e8re), la phase de croisi\u00e8re peut \u00eatre de dur\u00e9e nulle (si le mouvement commence imm\u00e9diatement \u00e0 d\u00e9c\u00e9l\u00e9rer apr\u00e8s l'acc\u00e9l\u00e9ration), et/ou la phase de d\u00e9c\u00e9l\u00e9ration peut \u00eatre de dur\u00e9e nulle (si la vitesse finale est \u00e9gale \u00e0 la vitesse de croisi\u00e8re). Projection \u00b6 Le syst\u00e8me de projection \"look-ahead\" est utilis\u00e9 pour d\u00e9terminer les vitesses lors des virages entre les mouvements. Consid\u00e9rons les deux mouvements suivants contenus dans un plan XY : Dans la situation ci-dessus, il est possible de d\u00e9c\u00e9l\u00e9rer compl\u00e8tement apr\u00e8s le premier mouvement et d'acc\u00e9l\u00e9rer compl\u00e8tement au d\u00e9but du mouvement suivant, mais ce n'est pas id\u00e9al car toutes ces acc\u00e9l\u00e9rations et d\u00e9c\u00e9l\u00e9rations augmenteraient consid\u00e9rablement le temps d'impression et les changements fr\u00e9quents dans le flux de l'extrudeuse entra\u00eeneraient une mauvaise qualit\u00e9 d'impression. Pour r\u00e9soudre ce probl\u00e8me, le m\u00e9canisme de projection \"look-ahead\" met en file d'attente plusieurs mouvements entrants et analyse les angles entre les mouvements pour d\u00e9terminer une vitesse raisonnable pouvant \u00eatre obtenue pendant la \"jonction\" entre deux mouvements. Si le d\u00e9placement suivant est presque dans la m\u00eame direction, la t\u00eate ne doit ralentir que l\u00e9g\u00e8rement (voire pas du tout). Toutefois, si le mouvement suivant forme un angle aigu (la t\u00eate va se d\u00e9placer dans une direction presque inverse lors du mouvement suivant), seule une petite vitesse de jonction est autoris\u00e9e. Les vitesses de jonction sont d\u00e9termin\u00e9es en utilisant \"l'acc\u00e9l\u00e9ration centrip\u00e8te approximative\". Best d\u00e9crit par l'auteur . Cependant, dans Klipper, les vitesses de jonction sont configur\u00e9es en sp\u00e9cifiant la vitesse souhait\u00e9e pour un angle de 90\u00b0 (la \"vitesse de l'angle carr\u00e9\"), et les vitesses de jonction des autres angles en sont d\u00e9riv\u00e9es. Formule cl\u00e9 pour la projection : end_velocity^2 = start_velocity^2 + 2*accel*move_distance Lissage de la projection \u00b6 Klipper met \u00e9galement en \u0153uvre un m\u00e9canisme permettant de lisser les mouvements de courts d\u00e9placements en \"zigzag\". Consid\u00e9rons les mouvements suivants : Dans l'exemple ci-dessus, les passages fr\u00e9quents de l'acc\u00e9l\u00e9ration \u00e0 la d\u00e9c\u00e9l\u00e9ration peuvent faire vibrer la machine provoquant des contraintes sur la machine et augmentant le bruit. Pour r\u00e9duire ce ph\u00e9nom\u00e8ne, Klipper suit \u00e0 la fois l'acc\u00e9l\u00e9ration des mouvements r\u00e9guliers et un taux virtuel \"d'acc\u00e9l\u00e9ration \u00e0 d\u00e9c\u00e9l\u00e9ration\". Gr\u00e2ce \u00e0 ce syst\u00e8me, la vitesse maximale de ces courts mouvements en \"zigzag\" est limit\u00e9e pour lisser le mouvement de l'imprimante : Plus pr\u00e9cis\u00e9ment, le code calcule ce que serait la vitesse de chaque mouvement s'il \u00e9tait limit\u00e9 \u00e0 ce taux virtuel \"d'acc\u00e9l\u00e9ration \u00e0 d\u00e9c\u00e9l\u00e9ration\" (la moiti\u00e9 du taux d'acc\u00e9l\u00e9ration normal par d\u00e9faut). Dans l'image ci-dessus, les lignes grises en pointill\u00e9s repr\u00e9sentent ce taux d'acc\u00e9l\u00e9ration virtuel pour le premier d\u00e9placement. Si un d\u00e9placement ne peut atteindre sa vitesse de croisi\u00e8re maximale en utilisant ce taux d'acc\u00e9l\u00e9ration virtuel, sa vitesse maximale est r\u00e9duite \u00e0 la vitesse maximale obtenu avec ce taux d'acc\u00e9l\u00e9ration virtuel. Pour la plupart des mouvements, la limite sera \u00e9gale ou sup\u00e9rieure aux limites existantes du mouvement et aucun changement de comportement n'est induit. En revanche, pour les d\u00e9placements courts en zigzag, cette limite r\u00e9duit la vitesse maximale. Notez que cela ne modifie pas l'acc\u00e9l\u00e9ration r\u00e9elle du mouvement - le mouvement continue d'utiliser le sch\u00e9ma d'acc\u00e9l\u00e9ration normal jusqu'\u00e0 sa vitesse maximale ajust\u00e9e. \u00c9tapes de la g\u00e9n\u00e9ration \u00b6 Une fois le processus d'anticipation termin\u00e9, le mouvement de la t\u00eate d'impression du mouvement donn\u00e9 est enti\u00e8rement connu (temps, position de d\u00e9part, position finale, vitesse \u00e0 chaque point) et il est possible de g\u00e9n\u00e9rer les dur\u00e9es de pas du mouvement. Ce processus est effectu\u00e9 dans les \"classes cin\u00e9matiques\" du code Klipper. En dehors de ces classes cin\u00e9matiques, tout est suivi en millim\u00e8tres, en secondes et dans un espace de coordonn\u00e9es cart\u00e9siennes. C'est la t\u00e2che des classes cin\u00e9matiques de convertir ce syst\u00e8me de coordonn\u00e9es g\u00e9n\u00e9rique aux sp\u00e9cificit\u00e9s mat\u00e9rielles de l'imprimante particuli\u00e8re. Klipper utilise un solveur it\u00e9ratif pour g\u00e9n\u00e9rer les dur\u00e9s de pas pour chaque moteur. Le code contient les formules permettant de calculer les coordonn\u00e9es cart\u00e9siennes id\u00e9ales de la t\u00eate \u00e0 chaque instant, ainsi que les formules cin\u00e9matiques permettant de calculer les positions id\u00e9ales des moteurs \u00e0 partir de ces coordonn\u00e9es cart\u00e9siennes. Gr\u00e2ce \u00e0 ces formules, Klipper peut d\u00e9terminer le moment id\u00e9al o\u00f9 le moteur doit se trouver \u00e0 chaque position de pas. Les \u00e9tapes donn\u00e9es sont alors programm\u00e9es \u00e0 ces moments calcul\u00e9s. La formule cl\u00e9 d\u00e9terminant la distance qu'un mouvement doit parcourir sous une acc\u00e9l\u00e9ration constante est la suivante : move_distance = (start_velocity + .5 * accel * move_time) * move_time et la formule cl\u00e9 d'un mouvement \u00e0 vitesse constante est : move_distance = cruise_velocity * move_time Les formules cl\u00e9s permettant de d\u00e9terminer la coordonn\u00e9e cart\u00e9sienne d'un d\u00e9placement en fonction de la distance du d\u00e9placement sont les suivantes : cartesian_x_position = start_x + move_distance * total_x_movement / total_movement cartesian_y_position = start_y + move_distance * total_y_movement / total_movement cartesian_z_position = start_z + move_distance * total_z_movement / total_movement Robots cart\u00e9siens \u00b6 La g\u00e9n\u00e9ration de pas des imprimantes cart\u00e9siennes est le cas le plus simple. Le mouvement sur chaque axe est directement li\u00e9 au mouvement dans l'espace cart\u00e9sien. Formules cl\u00e9s : stepper_x_position = cartesian_x_position stepper_y_position = cartesian_y_position stepper_z_position = cartesian_z_position Robots CoreXY \u00b6 La g\u00e9n\u00e9ration de pas d'une machine CoreXY n'est qu'un peu plus complexe que les robots cart\u00e9siens de base. Les formules cl\u00e9s sont les suivantes : stepper_a_position = cartesian_x_position + cartesian_y_position stepper_b_position = cartesian_x_position - cartesian_y_position stepper_z_position = cartesian_z_position Robots Delta \u00b6 La g\u00e9n\u00e9ration de pas d'un robot delta est bas\u00e9e sur le th\u00e9or\u00e8me de Pythagore : stepper_position = (sqrt(arm_length^2 - (cartesian_x_position - tower_x_position)^2 - (cartesian_y_position - tower_y_position)^2) + cartesian_z_position) Limites d'acc\u00e9l\u00e9ration du moteur pas \u00e0 pas \u00b6 Avec la cin\u00e9matique delta, il est possible qu'un mouvement acc\u00e9l\u00e8rant dans l'espace cart\u00e9sien n\u00e9cessite une acc\u00e9l\u00e9ration sur un moteur pas \u00e0 pas particulier sup\u00e9rieure \u00e0 l'acc\u00e9l\u00e9ration du mouvement. Cela peut se produire lorsque le bras d'un moteur pas \u00e0 pas est plus horizontal que vertical et que la ligne de mouvement passe pr\u00e8s de la tour de ce moteur pas \u00e0 pas. Bien que ces mouvements puissent n\u00e9cessiter une acc\u00e9l\u00e9ration du moteur pas \u00e0 pas sup\u00e9rieure \u00e0 l'acc\u00e9l\u00e9ration maximale du mouvement configur\u00e9 de l'imprimante, la masse effective d\u00e9plac\u00e9e par ce moteur pas \u00e0 pas serait plus faible. Ainsi, l'acc\u00e9l\u00e9ration plus \u00e9lev\u00e9e du moteur pas \u00e0 pas n'entra\u00eene pas un couple beaucoup plus \u00e9lev\u00e9 et est donc consid\u00e9r\u00e9e comme inoffensive. Cependant, afin d'\u00e9viter les cas extr\u00eames, Klipper applique un plafond maximal \u00e0 l'acc\u00e9l\u00e9ration du moteur de trois fois l'acc\u00e9l\u00e9ration de d\u00e9placement maximale configur\u00e9e de l'imprimante. (De m\u00eame, la vitesse maximale du moteur est limit\u00e9e \u00e0 trois fois la vitesse de d\u00e9placement maximale). Afin de faire respecter cette limite, les mouvements situ\u00e9s \u00e0 l'extr\u00e9mit\u00e9 de l'enveloppe de construction (o\u00f9 le bras du stepper peut \u00eatre presque horizontal) auront une acc\u00e9l\u00e9ration et une vitesse maximales inf\u00e9rieures. Cin\u00e9matique de l'extrudeuse \u00b6 Klipper impl\u00e9mente le mouvement de l'extrudeuse dans sa propre classe cin\u00e9matique. Comme la dur\u00e9e et la vitesse de chaque mouvement de la t\u00eate d'impression sont enti\u00e8rement connus pour chaque mouvement, il est possible de calculer les dur\u00e9es de pas de l'extrudeuse ind\u00e9pendamment des calculs de dur\u00e9es de pas du mouvement de la t\u00eate d'impression. Le mouvement de base de l'extrudeuse est simple \u00e0 calculer. La g\u00e9n\u00e9ration de dur\u00e9e de pas utilise les m\u00eames formules que celles utilis\u00e9es par les robots cart\u00e9siens : stepper_position = requested_e_position Avance \u00e0 la pression \u00b6 L'exp\u00e9rimentation a montr\u00e9 qu'il est possible d'am\u00e9liorer la mod\u00e9lisation de l'extrudeuse au-del\u00e0 de la formule de base de l'extrudeuse. Dans le cas id\u00e9al, au fur et \u00e0 mesure qu'un mouvement d'extrusion progresse, le m\u00eame volume de filament devrait \u00eatre d\u00e9pos\u00e9 \u00e0 chaque point du mouvement et il ne devrait pas y avoir de volume extrud\u00e9 apr\u00e8s le mouvement. Malheureusement, il est courant de constater que les formules d'extrusion de base font que trop peu de filament sort de l'extrudeuse au d\u00e9but des mouvements d'extrusion et qu'un exc\u00e8s de filament est extrud\u00e9 apr\u00e8s la fin de l'extrusion. Ce ph\u00e9nom\u00e8ne est souvent appel\u00e9 \"suintement\". Le syst\u00e8me d'\"avance \u00e0 la pression\" tente de tenir compte de ce ph\u00e9nom\u00e8ne en utilisant un mod\u00e8le diff\u00e9rent pour l'extrudeuse. Au lieu de croire na\u00efvement que chaque mm^3 de filament introduit dans l'extrudeuse entra\u00eenera la sortie imm\u00e9diate de cette quantit\u00e9 de mm^3, est utilis\u00e9 un mod\u00e8le bas\u00e9 sur la pression. La pression augmente lorsque le filament est pouss\u00e9 dans l'extrudeuse (comme dans la loi de Hooke ) et la pression n\u00e9cessaire pour extruder est domin\u00e9e par le d\u00e9bit \u00e0 travers l'orifice de la buse (comme dans la loi de Poiseuille ). L'id\u00e9e principale est que la relation entre le filament, la pression et le d\u00e9bit peut \u00eatre mod\u00e9lis\u00e9e par un coefficient lin\u00e9aire : pa_position = nominal_position + pressure_advance_coefficient * nominal_velocity Voir le document avance \u00e0 la pression pour savoir comment d\u00e9terminer ce coefficient d'avance \u00e0 la pression. La formule de base de l'avance \u00e0 la pression peut entra\u00eener des changements brusques de la vitesse du moteur de l'extrudeuse. Klipper met en \u0153uvre un \"lissage\" du mouvement de l'extrudeuse pour \u00e9viter cela. Le graphique ci-dessus montre un exemple de deux mouvements d'extrusion avec une vitesse de virage non nulle entre eux. Notez que le syst\u00e8me d'avance \u00e0 la pression fait que du filament suppl\u00e9mentaire est pouss\u00e9 dans l'extrudeuse pendant l'acc\u00e9l\u00e9ration. Plus le d\u00e9bit de filament souhait\u00e9 est \u00e9lev\u00e9, plus il faut pousser de filament dans l'extrudeuse pendant l'acc\u00e9l\u00e9ration pour tenir compte de la pression. Pendant la d\u00e9c\u00e9l\u00e9ration de la t\u00eate, le filament suppl\u00e9mentaire est r\u00e9tract\u00e9 (l'extrudeuse aura une vitesse n\u00e9gative). Le \"lissage\" est impl\u00e9ment\u00e9 en utilisant une moyenne pond\u00e9r\u00e9e de la position de l'extrudeuse sur une tr\u00e8s courte p\u00e9riode de temps (comme sp\u00e9cifi\u00e9 par le param\u00e8tre de configuration pressure_advance_smooth_time ). Cette moyenne peut s'\u00e9tendre sur plusieurs mouvements du g-code. Notez comment le moteur de l'extrudeuse commencera \u00e0 bouger avant le d\u00e9but nominal du premier mouvement d'extrusion et continuera \u00e0 bouger apr\u00e8s la fin nominale du dernier mouvement d'extrusion. Formule cl\u00e9 pour \"l'avance \u00e0 la pression liss\u00e9e\" : smooth_pa_position(t) = ( definitive_integral(pa_position(x) * (smooth_time/2 - abs(t - x)) * dx, from=t-smooth_time/2, to=t+smooth_time/2) / (smooth_time/2)^2 )","title":"Cin\u00e9matiques"},{"location":"Kinematics.html#cinematiques","text":"Ce document donne un aper\u00e7u de la fa\u00e7on dont Klipper impl\u00e9mente le mouvement du robot (sa cin\u00e9matique ). Ce contenu peut int\u00e9resser aussi bien les d\u00e9veloppeurs travaillant sur le logiciel Klipper que les utilisateurs int\u00e9ress\u00e9s \u00e0 mieux comprendre la m\u00e9canique de leurs machines.","title":"Cin\u00e9matiques"},{"location":"Kinematics.html#acceleration","text":"Klipper met en \u0153uvre un sch\u00e9ma d'acc\u00e9l\u00e9ration constante chaque fois que la t\u00eate d'impression change de vitesse - la vitesse est progressivement modifi\u00e9e pour atteindre la nouvelle vitesse au lieu d'\u00eatre brusquement atteinte. Klipper applique toujours l'acc\u00e9l\u00e9ration entre la t\u00eate de l'outil et l'impression. Le filament sortant de l'extrudeuse peut \u00eatre assez fragile - des secousses rapides et/ou des changements de d\u00e9bit de l'extrudeuse entra\u00eenent une qualit\u00e9 m\u00e9diocre et une mauvaise adh\u00e9rence du lit. M\u00eame en l'absence d'extrusion, si la t\u00eate d'impression se trouve au m\u00eame niveau que l'impression, des secousses rapides de la t\u00eate peuvent perturber le filament r\u00e9cemment d\u00e9pos\u00e9. Limiter les changements de vitesse de la t\u00eate d'impression (par rapport \u00e0 l'impression) r\u00e9duit les risques de perturbation de l'impression. Il est \u00e9galement important de limiter l'acc\u00e9l\u00e9ration afin que les moteurs pas \u00e0 pas ne perdent pas de pas et ne soumettent pas la machine \u00e0 des contraintes excessives. Klipper limite le couple de chaque moteur pas \u00e0 pas en limitant l'acc\u00e9l\u00e9ration de la t\u00eate d'impression. Le fait d'imposer une acc\u00e9l\u00e9ration \u00e0 la t\u00eate d'impression limite naturellement aussi le couple des moteurs pas \u00e0 pas qui d\u00e9placent la t\u00eate d'impression (l'inverse n'est pas toujours vrai). Klipper met en \u0153uvre une acc\u00e9l\u00e9ration constante. La formule cl\u00e9 de l'acc\u00e9l\u00e9ration constante est la suivante : velocity(time) = start_velocity + accel*time","title":"Acc\u00e9l\u00e9ration"},{"location":"Kinematics.html#generateur-de-trapezoides","text":"Klipper utilise un \"g\u00e9n\u00e9rateur de trap\u00e8ze\" traditionnel pour mod\u00e9liser le mouvement de chaque d\u00e9placement - chaque d\u00e9placement a une vitesse de d\u00e9part, il acc\u00e9l\u00e8re jusqu'\u00e0 une vitesse de croisi\u00e8re \u00e0 une acc\u00e9l\u00e9ration constante, il se d\u00e9place \u00e0 une vitesse constante, puis d\u00e9c\u00e9l\u00e8re jusqu'\u00e0 la vitesse finale en utilisant une d\u00e9c\u00e9l\u00e9ration constante. On l'appelle \"g\u00e9n\u00e9rateur de trap\u00e8ze\" parce que le diagramme de vitesse du mouvement ressemble \u00e0 un trap\u00e8ze. La vitesse de croisi\u00e8re est toujours sup\u00e9rieure ou \u00e9gale \u00e0 la fois \u00e0 la vitesse de d\u00e9part et \u00e0 la vitesse d'arriv\u00e9e. La phase d'acc\u00e9l\u00e9ration peut \u00eatre de dur\u00e9e nulle (si la vitesse de d\u00e9part est \u00e9gale \u00e0 la vitesse de croisi\u00e8re), la phase de croisi\u00e8re peut \u00eatre de dur\u00e9e nulle (si le mouvement commence imm\u00e9diatement \u00e0 d\u00e9c\u00e9l\u00e9rer apr\u00e8s l'acc\u00e9l\u00e9ration), et/ou la phase de d\u00e9c\u00e9l\u00e9ration peut \u00eatre de dur\u00e9e nulle (si la vitesse finale est \u00e9gale \u00e0 la vitesse de croisi\u00e8re).","title":"G\u00e9n\u00e9rateur de trap\u00e9zo\u00efdes"},{"location":"Kinematics.html#projection","text":"Le syst\u00e8me de projection \"look-ahead\" est utilis\u00e9 pour d\u00e9terminer les vitesses lors des virages entre les mouvements. Consid\u00e9rons les deux mouvements suivants contenus dans un plan XY : Dans la situation ci-dessus, il est possible de d\u00e9c\u00e9l\u00e9rer compl\u00e8tement apr\u00e8s le premier mouvement et d'acc\u00e9l\u00e9rer compl\u00e8tement au d\u00e9but du mouvement suivant, mais ce n'est pas id\u00e9al car toutes ces acc\u00e9l\u00e9rations et d\u00e9c\u00e9l\u00e9rations augmenteraient consid\u00e9rablement le temps d'impression et les changements fr\u00e9quents dans le flux de l'extrudeuse entra\u00eeneraient une mauvaise qualit\u00e9 d'impression. Pour r\u00e9soudre ce probl\u00e8me, le m\u00e9canisme de projection \"look-ahead\" met en file d'attente plusieurs mouvements entrants et analyse les angles entre les mouvements pour d\u00e9terminer une vitesse raisonnable pouvant \u00eatre obtenue pendant la \"jonction\" entre deux mouvements. Si le d\u00e9placement suivant est presque dans la m\u00eame direction, la t\u00eate ne doit ralentir que l\u00e9g\u00e8rement (voire pas du tout). Toutefois, si le mouvement suivant forme un angle aigu (la t\u00eate va se d\u00e9placer dans une direction presque inverse lors du mouvement suivant), seule une petite vitesse de jonction est autoris\u00e9e. Les vitesses de jonction sont d\u00e9termin\u00e9es en utilisant \"l'acc\u00e9l\u00e9ration centrip\u00e8te approximative\". Best d\u00e9crit par l'auteur . Cependant, dans Klipper, les vitesses de jonction sont configur\u00e9es en sp\u00e9cifiant la vitesse souhait\u00e9e pour un angle de 90\u00b0 (la \"vitesse de l'angle carr\u00e9\"), et les vitesses de jonction des autres angles en sont d\u00e9riv\u00e9es. Formule cl\u00e9 pour la projection : end_velocity^2 = start_velocity^2 + 2*accel*move_distance","title":"Projection"},{"location":"Kinematics.html#lissage-de-la-projection","text":"Klipper met \u00e9galement en \u0153uvre un m\u00e9canisme permettant de lisser les mouvements de courts d\u00e9placements en \"zigzag\". Consid\u00e9rons les mouvements suivants : Dans l'exemple ci-dessus, les passages fr\u00e9quents de l'acc\u00e9l\u00e9ration \u00e0 la d\u00e9c\u00e9l\u00e9ration peuvent faire vibrer la machine provoquant des contraintes sur la machine et augmentant le bruit. Pour r\u00e9duire ce ph\u00e9nom\u00e8ne, Klipper suit \u00e0 la fois l'acc\u00e9l\u00e9ration des mouvements r\u00e9guliers et un taux virtuel \"d'acc\u00e9l\u00e9ration \u00e0 d\u00e9c\u00e9l\u00e9ration\". Gr\u00e2ce \u00e0 ce syst\u00e8me, la vitesse maximale de ces courts mouvements en \"zigzag\" est limit\u00e9e pour lisser le mouvement de l'imprimante : Plus pr\u00e9cis\u00e9ment, le code calcule ce que serait la vitesse de chaque mouvement s'il \u00e9tait limit\u00e9 \u00e0 ce taux virtuel \"d'acc\u00e9l\u00e9ration \u00e0 d\u00e9c\u00e9l\u00e9ration\" (la moiti\u00e9 du taux d'acc\u00e9l\u00e9ration normal par d\u00e9faut). Dans l'image ci-dessus, les lignes grises en pointill\u00e9s repr\u00e9sentent ce taux d'acc\u00e9l\u00e9ration virtuel pour le premier d\u00e9placement. Si un d\u00e9placement ne peut atteindre sa vitesse de croisi\u00e8re maximale en utilisant ce taux d'acc\u00e9l\u00e9ration virtuel, sa vitesse maximale est r\u00e9duite \u00e0 la vitesse maximale obtenu avec ce taux d'acc\u00e9l\u00e9ration virtuel. Pour la plupart des mouvements, la limite sera \u00e9gale ou sup\u00e9rieure aux limites existantes du mouvement et aucun changement de comportement n'est induit. En revanche, pour les d\u00e9placements courts en zigzag, cette limite r\u00e9duit la vitesse maximale. Notez que cela ne modifie pas l'acc\u00e9l\u00e9ration r\u00e9elle du mouvement - le mouvement continue d'utiliser le sch\u00e9ma d'acc\u00e9l\u00e9ration normal jusqu'\u00e0 sa vitesse maximale ajust\u00e9e.","title":"Lissage de la projection"},{"location":"Kinematics.html#etapes-de-la-generation","text":"Une fois le processus d'anticipation termin\u00e9, le mouvement de la t\u00eate d'impression du mouvement donn\u00e9 est enti\u00e8rement connu (temps, position de d\u00e9part, position finale, vitesse \u00e0 chaque point) et il est possible de g\u00e9n\u00e9rer les dur\u00e9es de pas du mouvement. Ce processus est effectu\u00e9 dans les \"classes cin\u00e9matiques\" du code Klipper. En dehors de ces classes cin\u00e9matiques, tout est suivi en millim\u00e8tres, en secondes et dans un espace de coordonn\u00e9es cart\u00e9siennes. C'est la t\u00e2che des classes cin\u00e9matiques de convertir ce syst\u00e8me de coordonn\u00e9es g\u00e9n\u00e9rique aux sp\u00e9cificit\u00e9s mat\u00e9rielles de l'imprimante particuli\u00e8re. Klipper utilise un solveur it\u00e9ratif pour g\u00e9n\u00e9rer les dur\u00e9s de pas pour chaque moteur. Le code contient les formules permettant de calculer les coordonn\u00e9es cart\u00e9siennes id\u00e9ales de la t\u00eate \u00e0 chaque instant, ainsi que les formules cin\u00e9matiques permettant de calculer les positions id\u00e9ales des moteurs \u00e0 partir de ces coordonn\u00e9es cart\u00e9siennes. Gr\u00e2ce \u00e0 ces formules, Klipper peut d\u00e9terminer le moment id\u00e9al o\u00f9 le moteur doit se trouver \u00e0 chaque position de pas. Les \u00e9tapes donn\u00e9es sont alors programm\u00e9es \u00e0 ces moments calcul\u00e9s. La formule cl\u00e9 d\u00e9terminant la distance qu'un mouvement doit parcourir sous une acc\u00e9l\u00e9ration constante est la suivante : move_distance = (start_velocity + .5 * accel * move_time) * move_time et la formule cl\u00e9 d'un mouvement \u00e0 vitesse constante est : move_distance = cruise_velocity * move_time Les formules cl\u00e9s permettant de d\u00e9terminer la coordonn\u00e9e cart\u00e9sienne d'un d\u00e9placement en fonction de la distance du d\u00e9placement sont les suivantes : cartesian_x_position = start_x + move_distance * total_x_movement / total_movement cartesian_y_position = start_y + move_distance * total_y_movement / total_movement cartesian_z_position = start_z + move_distance * total_z_movement / total_movement","title":"\u00c9tapes de la g\u00e9n\u00e9ration"},{"location":"Kinematics.html#robots-cartesiens","text":"La g\u00e9n\u00e9ration de pas des imprimantes cart\u00e9siennes est le cas le plus simple. Le mouvement sur chaque axe est directement li\u00e9 au mouvement dans l'espace cart\u00e9sien. Formules cl\u00e9s : stepper_x_position = cartesian_x_position stepper_y_position = cartesian_y_position stepper_z_position = cartesian_z_position","title":"Robots cart\u00e9siens"},{"location":"Kinematics.html#robots-corexy","text":"La g\u00e9n\u00e9ration de pas d'une machine CoreXY n'est qu'un peu plus complexe que les robots cart\u00e9siens de base. Les formules cl\u00e9s sont les suivantes : stepper_a_position = cartesian_x_position + cartesian_y_position stepper_b_position = cartesian_x_position - cartesian_y_position stepper_z_position = cartesian_z_position","title":"Robots CoreXY"},{"location":"Kinematics.html#robots-delta","text":"La g\u00e9n\u00e9ration de pas d'un robot delta est bas\u00e9e sur le th\u00e9or\u00e8me de Pythagore : stepper_position = (sqrt(arm_length^2 - (cartesian_x_position - tower_x_position)^2 - (cartesian_y_position - tower_y_position)^2) + cartesian_z_position)","title":"Robots Delta"},{"location":"Kinematics.html#limites-dacceleration-du-moteur-pas-a-pas","text":"Avec la cin\u00e9matique delta, il est possible qu'un mouvement acc\u00e9l\u00e8rant dans l'espace cart\u00e9sien n\u00e9cessite une acc\u00e9l\u00e9ration sur un moteur pas \u00e0 pas particulier sup\u00e9rieure \u00e0 l'acc\u00e9l\u00e9ration du mouvement. Cela peut se produire lorsque le bras d'un moteur pas \u00e0 pas est plus horizontal que vertical et que la ligne de mouvement passe pr\u00e8s de la tour de ce moteur pas \u00e0 pas. Bien que ces mouvements puissent n\u00e9cessiter une acc\u00e9l\u00e9ration du moteur pas \u00e0 pas sup\u00e9rieure \u00e0 l'acc\u00e9l\u00e9ration maximale du mouvement configur\u00e9 de l'imprimante, la masse effective d\u00e9plac\u00e9e par ce moteur pas \u00e0 pas serait plus faible. Ainsi, l'acc\u00e9l\u00e9ration plus \u00e9lev\u00e9e du moteur pas \u00e0 pas n'entra\u00eene pas un couple beaucoup plus \u00e9lev\u00e9 et est donc consid\u00e9r\u00e9e comme inoffensive. Cependant, afin d'\u00e9viter les cas extr\u00eames, Klipper applique un plafond maximal \u00e0 l'acc\u00e9l\u00e9ration du moteur de trois fois l'acc\u00e9l\u00e9ration de d\u00e9placement maximale configur\u00e9e de l'imprimante. (De m\u00eame, la vitesse maximale du moteur est limit\u00e9e \u00e0 trois fois la vitesse de d\u00e9placement maximale). Afin de faire respecter cette limite, les mouvements situ\u00e9s \u00e0 l'extr\u00e9mit\u00e9 de l'enveloppe de construction (o\u00f9 le bras du stepper peut \u00eatre presque horizontal) auront une acc\u00e9l\u00e9ration et une vitesse maximales inf\u00e9rieures.","title":"Limites d'acc\u00e9l\u00e9ration du moteur pas \u00e0 pas"},{"location":"Kinematics.html#cinematique-de-lextrudeuse","text":"Klipper impl\u00e9mente le mouvement de l'extrudeuse dans sa propre classe cin\u00e9matique. Comme la dur\u00e9e et la vitesse de chaque mouvement de la t\u00eate d'impression sont enti\u00e8rement connus pour chaque mouvement, il est possible de calculer les dur\u00e9es de pas de l'extrudeuse ind\u00e9pendamment des calculs de dur\u00e9es de pas du mouvement de la t\u00eate d'impression. Le mouvement de base de l'extrudeuse est simple \u00e0 calculer. La g\u00e9n\u00e9ration de dur\u00e9e de pas utilise les m\u00eames formules que celles utilis\u00e9es par les robots cart\u00e9siens : stepper_position = requested_e_position","title":"Cin\u00e9matique de l'extrudeuse"},{"location":"Kinematics.html#avance-a-la-pression","text":"L'exp\u00e9rimentation a montr\u00e9 qu'il est possible d'am\u00e9liorer la mod\u00e9lisation de l'extrudeuse au-del\u00e0 de la formule de base de l'extrudeuse. Dans le cas id\u00e9al, au fur et \u00e0 mesure qu'un mouvement d'extrusion progresse, le m\u00eame volume de filament devrait \u00eatre d\u00e9pos\u00e9 \u00e0 chaque point du mouvement et il ne devrait pas y avoir de volume extrud\u00e9 apr\u00e8s le mouvement. Malheureusement, il est courant de constater que les formules d'extrusion de base font que trop peu de filament sort de l'extrudeuse au d\u00e9but des mouvements d'extrusion et qu'un exc\u00e8s de filament est extrud\u00e9 apr\u00e8s la fin de l'extrusion. Ce ph\u00e9nom\u00e8ne est souvent appel\u00e9 \"suintement\". Le syst\u00e8me d'\"avance \u00e0 la pression\" tente de tenir compte de ce ph\u00e9nom\u00e8ne en utilisant un mod\u00e8le diff\u00e9rent pour l'extrudeuse. Au lieu de croire na\u00efvement que chaque mm^3 de filament introduit dans l'extrudeuse entra\u00eenera la sortie imm\u00e9diate de cette quantit\u00e9 de mm^3, est utilis\u00e9 un mod\u00e8le bas\u00e9 sur la pression. La pression augmente lorsque le filament est pouss\u00e9 dans l'extrudeuse (comme dans la loi de Hooke ) et la pression n\u00e9cessaire pour extruder est domin\u00e9e par le d\u00e9bit \u00e0 travers l'orifice de la buse (comme dans la loi de Poiseuille ). L'id\u00e9e principale est que la relation entre le filament, la pression et le d\u00e9bit peut \u00eatre mod\u00e9lis\u00e9e par un coefficient lin\u00e9aire : pa_position = nominal_position + pressure_advance_coefficient * nominal_velocity Voir le document avance \u00e0 la pression pour savoir comment d\u00e9terminer ce coefficient d'avance \u00e0 la pression. La formule de base de l'avance \u00e0 la pression peut entra\u00eener des changements brusques de la vitesse du moteur de l'extrudeuse. Klipper met en \u0153uvre un \"lissage\" du mouvement de l'extrudeuse pour \u00e9viter cela. Le graphique ci-dessus montre un exemple de deux mouvements d'extrusion avec une vitesse de virage non nulle entre eux. Notez que le syst\u00e8me d'avance \u00e0 la pression fait que du filament suppl\u00e9mentaire est pouss\u00e9 dans l'extrudeuse pendant l'acc\u00e9l\u00e9ration. Plus le d\u00e9bit de filament souhait\u00e9 est \u00e9lev\u00e9, plus il faut pousser de filament dans l'extrudeuse pendant l'acc\u00e9l\u00e9ration pour tenir compte de la pression. Pendant la d\u00e9c\u00e9l\u00e9ration de la t\u00eate, le filament suppl\u00e9mentaire est r\u00e9tract\u00e9 (l'extrudeuse aura une vitesse n\u00e9gative). Le \"lissage\" est impl\u00e9ment\u00e9 en utilisant une moyenne pond\u00e9r\u00e9e de la position de l'extrudeuse sur une tr\u00e8s courte p\u00e9riode de temps (comme sp\u00e9cifi\u00e9 par le param\u00e8tre de configuration pressure_advance_smooth_time ). Cette moyenne peut s'\u00e9tendre sur plusieurs mouvements du g-code. Notez comment le moteur de l'extrudeuse commencera \u00e0 bouger avant le d\u00e9but nominal du premier mouvement d'extrusion et continuera \u00e0 bouger apr\u00e8s la fin nominale du dernier mouvement d'extrusion. Formule cl\u00e9 pour \"l'avance \u00e0 la pression liss\u00e9e\" : smooth_pa_position(t) = ( definitive_integral(pa_position(x) * (smooth_time/2 - abs(t - x)) * dx, from=t-smooth_time/2, to=t+smooth_time/2) / (smooth_time/2)^2 )","title":"Avance \u00e0 la pression"},{"location":"MCU_Commands.html","text":"Commandes MCU \u00b6 Ce document fournit des informations sur les commandes de bas niveau du microcontr\u00f4leur qui sont envoy\u00e9es depuis le logiciel \"h\u00f4te\" Klipper et trait\u00e9es par le firmware Klipper du microcontr\u00f4leur. Ce document n'est pas une r\u00e9f\u00e9rence faisant autorit\u00e9 pour ces commandes, ni une liste exclusive de toutes les commandes disponibles. Ce document peut \u00eatre utile aux d\u00e9veloppeurs souhaitant comprendre les commandes de bas niveau du microcontr\u00f4leur. Voir le document protocole pour plus d'informations sur le format des commandes et leur transmission. Les commandes ici sont d\u00e9crites en utilisant une syntaxe de style \"printf\" - pour ceux qui ne connaissent pas ce format, notez simplement que lorsqu'une s\u00e9quence '%...' est vue, elle doit \u00eatre remplac\u00e9e par un entier r\u00e9el. Par exemple, une description avec \"count=%c\" pourrait \u00eatre remplac\u00e9e par le texte \"count=10\". Notez que les param\u00e8tres qui sont consid\u00e9r\u00e9s comme des \"\u00e9num\u00e9rations\" (voir le document de protocole ci-dessus) prennent une valeur de cha\u00eene qui est automatiquement convertie en une valeur enti\u00e8re pour le microcontr\u00f4leur. Ceci est courant avec les param\u00e8tres nomm\u00e9s \"pin\" (ou qui ont le suffixe \"_pin\"). Commandes de d\u00e9marrage \u00b6 Il peut \u00eatre n\u00e9cessaire d'effectuer des actions ponctuelles pour configurer le microcontr\u00f4leur et ses p\u00e9riph\u00e9riques. Cette section r\u00e9pertorie les commandes courantes disponibles \u00e0 cette effet. Contrairement \u00e0 la plupart des commandes de microcontr\u00f4leur, ces commandes s'ex\u00e9cutent d\u00e8s leur r\u00e9ception et ne n\u00e9cessitent aucune configuration particuli\u00e8re. Commandes de d\u00e9marrage courantes : set_digital_out pin=%u value=%c : Cette commande configure imm\u00e9diatement la broche donn\u00e9e en tant que sortie num\u00e9rique GPIO et la d\u00e9finit soit \u00e0 un niveau bas (valeur=0) soit \u00e0 un niveau haut (valeur=1 ). Cette commande peut \u00eatre utile pour configurer la valeur initiale des LED et pour configurer la valeur initiale des broches de micro-pas du pilote de moteur pas \u00e0 pas. set_pwm_out pin=%u cycle_ticks=%u value=%hu : Cette commande configurera la broche donn\u00e9e pour utiliser la modulation de largeur d'impulsion (PWM) bas\u00e9e sur le mat\u00e9riel avec le nombre donn\u00e9 de cycle_ticks. Le \"cycle_ticks\" est le nombre de ticks d'horloge du MCU que chaque cycle de mise sous tension et hors tension doit durer. Une valeur cycle_ticks de 1 peut \u00eatre utilis\u00e9e pour demander le temps de cycle le plus rapide possible. Le param\u00e8tre \"valeur\" est compris entre 0 et 255, 0 indiquant un \u00e9tat enti\u00e8rement d\u00e9sactiv\u00e9 et 255 indiquant un \u00e9tat enti\u00e8rement activ\u00e9. Cette commande peut \u00eatre utile pour activer les ventilateurs de refroidissement du processeur et des buses. Configuration bas niveau du microcontr\u00f4leur \u00b6 La plupart des commandes du microcontr\u00f4leur n\u00e9cessitent une configuration initiale avant de pouvoir \u00eatre appel\u00e9es. Cette section fournit une vue d'ensemble du processus de configuration. Cette section et les sections suivantes ne sont susceptibles d'int\u00e9resser que les d\u00e9veloppeurs int\u00e9ress\u00e9s par les d\u00e9tails internes de Klipper. Lorsque l'h\u00f4te se connecte pour la premi\u00e8re fois au microcontr\u00f4leur, il commence toujours par obtenir un dictionnaire de donn\u00e9es (voir protocole pour plus d'informations). Une fois le dictionnaire de donn\u00e9es obtenu, l'h\u00f4te v\u00e9rifie si le microcontr\u00f4leur est dans un \u00e9tat \"configur\u00e9\" et le configure si ce n'est pas le cas. La configuration comprend les phases suivantes : get_config : L'h\u00f4te commence par v\u00e9rifier si le micro-contr\u00f4leur est d\u00e9j\u00e0 configur\u00e9. Le microcontr\u00f4leur r\u00e9pond \u00e0 cette commande par un message de r\u00e9ponse \u00ab config \u00bb. Le logiciel du microcontr\u00f4leur d\u00e9marre toujours dans un \u00e9tat non configur\u00e9 \u00e0 la mise sous tension. Il reste dans cet \u00e9tat jusqu'\u00e0 ce que l'h\u00f4te termine les processus de configuration (en \u00e9mettant une commande finalize_config). Si le microcontr\u00f4leur est d\u00e9j\u00e0 configur\u00e9 \u00e0 partir d'une session pr\u00e9c\u00e9dente (et est configur\u00e9 avec les param\u00e8tres souhait\u00e9s), aucune autre action n'est requise de la part de l'h\u00f4te et le processus de configuration se termine avec succ\u00e8s. allocate_oids count=%c : cette commande est envoy\u00e9e pour informer le microcontr\u00f4leur du nombre maximal d'identifiants d'objet (oid) requis par l'h\u00f4te. Il n'e faut envoyer cette commande qu'une seule fois. Un oid est un identifiant entier allou\u00e9 \u00e0 chaque stepper, chaque fin de course et chaque broche gpio programmable. L'h\u00f4te d\u00e9termine \u00e0 l'avance le nombre d'oids dont il aura besoin pour faire fonctionner le mat\u00e9riel et le transmet au microcontr\u00f4leur afin qu'il puisse allouer suffisamment de m\u00e9moire pour stocker un mappage de l'oid \u00e0 l'objet interne. config_XXX oid=%c ... : Par convention toute commande commen\u00e7ant par le pr\u00e9fixe \"config_\" cr\u00e9e un nouvel objet microcontr\u00f4leur et lui affecte l'oid donn\u00e9. Par exemple, la commande config_digital_out configurera la broche sp\u00e9cifi\u00e9e en tant que GPIO de sortie num\u00e9rique et cr\u00e9era un objet interne que l'h\u00f4te peut utiliser pour planifier des modifications du GPIO donn\u00e9. Le param\u00e8tre oid pass\u00e9 dans la commande config est s\u00e9lectionn\u00e9 par l'h\u00f4te et doit \u00eatre compris entre z\u00e9ro et le nombre maximal fourni dans la commande allow_oids. Les commandes de configuration ne peuvent \u00eatre ex\u00e9cut\u00e9es que lorsque le microcontr\u00f4leur n'est pas dans un \u00e9tat configur\u00e9 (c'est-\u00e0-dire avant que l'h\u00f4te n'envoie finalize_config) et apr\u00e8s que la commande allow_oids a \u00e9t\u00e9 envoy\u00e9e. finalize_config crc=%u : La commande finalize_config fait passer le microcontr\u00f4leur d'un \u00e9tat non configur\u00e9 \u00e0 un \u00e9tat configur\u00e9. Le param\u00e8tre crc transmis au microcontr\u00f4leur est stock\u00e9 et renvoy\u00e9 \u00e0 l'h\u00f4te dans les messages de r\u00e9ponse \"config\". Par convention, l'h\u00f4te prend un CRC 32 bits de la configuration qu'il demandera et au d\u00e9but des sessions de communication suivantes, il v\u00e9rifie que le CRC stock\u00e9 dans le microcontr\u00f4leur correspond exactement \u00e0 son CRC souhait\u00e9. Si le CRC ne correspond pas, l'h\u00f4te saura que le microcontr\u00f4leur n'a pas \u00e9t\u00e9 configur\u00e9 correctement. Objets de base du microcontr\u00f4leur \u00b6 Cette section r\u00e9pertorie quelques commandes de configuration couramment utilis\u00e9es. config_digital_out oid=%c pin=%u value=%c default_value=%c max_duration=%u : cette commande cr\u00e9e un objet de microcontr\u00f4leur interne pour la \"broche\" GPIO donn\u00e9e. La broche sera configur\u00e9e en mode de sortie num\u00e9rique et d\u00e9finie sur une valeur initiale telle que sp\u00e9cifi\u00e9e par 'value' (0 pour bas, 1 pour haut). La cr\u00e9ation d'un objet digital_out permet \u00e0 l'h\u00f4te de programmer des mises \u00e0 jour GPIO pour la broche donn\u00e9e \u00e0 des heures sp\u00e9cifi\u00e9es (voir la commande queue_digital_out d\u00e9crite ci-dessous). Si le logiciel du microcontr\u00f4leur passe en mode d'arr\u00eat, tous les objets digital_out configur\u00e9s seront d\u00e9finis sur 'default_value'. Le param\u00e8tre 'max_duration' est utilis\u00e9 pour impl\u00e9menter un contr\u00f4le de s\u00e9curit\u00e9 - s'il est diff\u00e9rent de z\u00e9ro, il s'agit du nombre maximal de ticks d'horloge pendannt lesquels l'h\u00f4te peut d\u00e9finir le GPIO donn\u00e9 sur une valeur autre que celle par d\u00e9faut sans autres mises \u00e0 jour. Par exemple, si la default_value est z\u00e9ro et la max_duration est de 16000, alors si l'h\u00f4te d\u00e9finit le gpio sur une valeur de un, il doit planifier une autre mise \u00e0 jour de la broche gpio (\u00e0 z\u00e9ro ou \u00e0 un) dans les 16000 tics d'horloge. Cette fonction de s\u00e9curit\u00e9 peut \u00eatre utilis\u00e9e avec des broches de chauffage pour s'assurer que l'h\u00f4te n'active pas le chauffage puis se d\u00e9connecte en le laissant activ\u00e9. config_pwm_out oid=%c pin=%u cycle_ticks=%u value=%hu default_value=%hu max_duration=%u : cette commande cr\u00e9e un objet interne pour les broches PWM mat\u00e9rielles pour lesquelles l'h\u00f4te peut planifier des mises \u00e0 jour . Son utilisation est analogue \u00e0 config_digital_out - voir la description des commandes 'set_pwm_out' et 'config_digital_out' pour la description des param\u00e8tres. config_analog_in oid=%c pin=%u : Cette commande permet de configurer une broche en mode d'\u00e9chantillonnage d'entr\u00e9e analogique. Une fois configur\u00e9e, la broche peut \u00eatre \u00e9chantillonn\u00e9e \u00e0 intervalle r\u00e9gulier \u00e0 l'aide de la commande query_analog_in (voir ci-dessous). config_stepper oid=%c step_pin=%c dir_pin=%c invert_step=%c step_pulse_ticks=%u : Cette commande cr\u00e9e un objet \"moteur pas \u00e0 pas\" interne. Les param\u00e8tres 'step_pin' et 'dir_pin' sp\u00e9cifient respectivement les broches de pas et de direction ; cette commande les configurera en mode de sortie num\u00e9rique. Le param\u00e8tre 'invert_step' sp\u00e9cifie si une \u00e9tape se produit sur un front montant (invert_step=0) ou descendant (invert_step=1). Le param\u00e8tre 'step_pulse_ticks' sp\u00e9cifie la dur\u00e9e minimale de l'impulsion de pas. Si le mcu exporte la constante 'STEPPER_BOTH_EDGE=1', le r\u00e9glage step_pulse_ticks=0 et invert_step=-1 sera configur\u00e9 pour marcher sur les fronts montant et descendant de la broche de pas. config_endstop oid=%c pin=%c pull_up=%c stepper_count=%c : Cette commande cr\u00e9e un objet \"endstop\" interne. Il est utilis\u00e9 pour sp\u00e9cifier les broches d'arr\u00eat et pour activer les op\u00e9rations de \"homing\" (voir la commande endstop_home ci-dessous). La commande configurera la broche sp\u00e9cifi\u00e9e en mode d'entr\u00e9e num\u00e9rique. Le param\u00e8tre 'pull_up' d\u00e9termine si les r\u00e9sistances pullup fournies par le mat\u00e9riel pour la broche (si disponibles) seront activ\u00e9es. Le param\u00e8tre 'stepper_count' sp\u00e9cifie le nombre maximum de pas dont cette but\u00e9e peut avoir besoin pendant une op\u00e9ration de prise d'origine (voir endstop_home ci-dessous). config_spi oid=%c bus=%u pin=%u mode=%u rate=%u shutdown_msg=%*s : Cette commande cr\u00e9e un objet SPI interne. Il est utilis\u00e9 avec les commandes spi_transfer et spi_send (voir ci-dessous). Le param\u00e8tre \"bus\" identifie le bus SPI \u00e0 utiliser (si le microcontr\u00f4leur a plus d'un bus SPI disponible). Le param\u00e8tre \"broche\" sp\u00e9cifie la broche de s\u00e9lection de puce (CS) pour le p\u00e9riph\u00e9rique. Le param\u00e8tre \"mode\" est le mode SPI (doit \u00eatre compris entre 0 et 3). Le param\u00e8tre \"rate\" sp\u00e9cifie le d\u00e9bit du bus SPI (en cycles par seconde). Enfin, le param\u00e8tre \"shutdown_msg\" est une commande SPI \u00e0 envoyer \u00e0 l'appareil donn\u00e9 si le microcontr\u00f4leur passe en \u00e9tat d'arr\u00eat. config_spi_without_cs oid=%c bus=%u mode=%u rate=%u shutdown_msg=%*s : Cette commande est similaire \u00e0 config_spi, mais sans d\u00e9finition de la broche CS. Il est utile pour les appareils SPI qui n'ont pas de ligne de s\u00e9lection de puce. Commandes courantes \u00b6 Cette section r\u00e9pertorie les commandes les plus couramment utilis\u00e9es. Cela n'int\u00e9resse probablement que les d\u00e9veloppeurs qui cherchent \u00e0 mieux comprendre Klipper. set_digital_out_pwm_cycle oid=%c cycle_ticks=%u : cette commande configure une broche de sortie num\u00e9rique (telle que cr\u00e9\u00e9e par config_digital_out) pour utiliser le \"PWM logciel\". Le 'cycle_ticks' est le nombre de tics d'horloge pour le cycle PWM. \u00c9tant donn\u00e9 que la commutation de sortie est impl\u00e9ment\u00e9e dans le logiciel du microcontr\u00f4leur, il est recommand\u00e9 que 'cycle_ticks' corresponde \u00e0 un temps de 10 ms ou plus. queue_digital_out oid=%c clock=%u on_ticks=%u : Cette commande permet de planifier une changement d'\u00e9tat d'une broche GPIO de sortie num\u00e9rique au tick d'horloge donn\u00e9e. Pour utiliser cette commande, une commande 'config_digital_out' avec le m\u00eame param\u00e8tre 'oid' doit avoir \u00e9t\u00e9 \u00e9mise lors de la configuration du microcontr\u00f4leur. Si 'set_digital_out_pwm_cycle' a \u00e9t\u00e9 appel\u00e9, alors 'on_ticks' est la dur\u00e9e d'activation (en ticks d'horloge) pour le cycle pwm. Sinon, 'on_ticks' doit \u00eatre soit 0 (pour basse tension) soit 1 (pour haute tension). queue_pwm_out oid=%c clock=%u value=%hu : planifie un changement sur une broche de sortie PWM mat\u00e9rielle. Voir les commandes 'queue_digital_out' et 'config_pwm_out' pour plus d'informations. query_analog_in oid=%c clock=%u sample_ticks=%u sample_count=%c rest_ticks=%u min_value=%hu max_value=%hu : Cette commande d\u00e9finit une r\u00e9cup\u00e9ration r\u00e9currente d'\u00e9chantillons d'entr\u00e9e analogique. Pour utiliser cette commande, une commande 'config_analog_in' avec le m\u00eame param\u00e8tre 'oid' doit avoir \u00e9t\u00e9 \u00e9mise lors de la configuration du microcontr\u00f4leur. Les \u00e9chantillons commenceront \u00e0 partir de l'heure 'clock', et ils rapporteront la valeur obtenue \u00e0 chaque tic d'horloge 'rest_ticks', il sur\u00e9chantillonnera avec un nombre 'sample_count' d'\u00e9chantillons et il se mettra en pause pendant le nombre 'sample_ticks' de tic d'horloge entre chaque \u00e9chantillonnage. Les param\u00e8tres 'min_value' et 'max_value' impl\u00e9mentent une fonction de s\u00e9curit\u00e9 - le logiciel du microcontr\u00f4leur v\u00e9rifiera que la valeur \u00e9chantillonn\u00e9e se situe toujours dans la plage fournie. Ceci est destin\u00e9 \u00e0 \u00eatre utilis\u00e9 avec des broches rattach\u00e9es aux thermistances contr\u00f4lant les radiateurs - il peut \u00eatre utilis\u00e9 pour v\u00e9rifier qu'un radiateur se trouve dans une plage de temp\u00e9rature correcte. get_clock : Cette commande am\u00e8ne le microcontr\u00f4leur \u00e0 g\u00e9n\u00e9rer un message de r\u00e9ponse \"clock\". L'h\u00f4te envoie cette commande une fois par seconde pour obtenir la valeur de l'horloge du microcontr\u00f4leur et pour estimer la d\u00e9rive entre les horloges de l'h\u00f4te et du microcontr\u00f4leur. Il permet \u00e0 l'h\u00f4te d'estimer avec pr\u00e9cision l'horloge du microcontr\u00f4leur. Commandes de moteurs pas \u00e0 pas \u00b6 queue_step oid=%c interval=%u count=%hu add=%hi : cette commande planifie le nombre de pas 'count' pour le stepper donn\u00e9, avec un nombre 'd'intervalle' de ticks d'horloge entre chaque pas. La premi\u00e8re \u00e9tape sera le nombre \"d'intervalle\" de ticks d'horloge depuis la derni\u00e8re \u00e9tape planifi\u00e9e pour le stepper donn\u00e9. Si 'add' n'est pas nul, l'intervalle sera ajust\u00e9 du montant 'add' apr\u00e8s chaque pas. Cette commande ajoute la s\u00e9quence d'intervalle/compte/ajout donn\u00e9e \u00e0 une file d'attente des pas. Il peut y avoir des centaines de ces s\u00e9quences en file d'attente pendant le fonctionnement normal. Une nouvelle s\u00e9quence est ajout\u00e9e \u00e0 la fin de la file d'attente et lorsque chaque s\u00e9quence termine son nombre de pas, elle est retir\u00e9e du d\u00e9but de la file d'attente. Ce syst\u00e8me permet au microcontr\u00f4leur de mettre en file d'attente potentiellement des centaines de milliers d'\u00e9tapes, le tout avec des dur\u00e9es fiables et pr\u00e9visibles. set_next_step_dir oid=%c dir=%c : Cette commande sp\u00e9cifie la valeur du dir_pin que la prochaine commande queue_step utilisera. reset_step_clock oid=%c clock=%u : Normalement, la synchronisation des pas est relative au dernier pas pour un stepper donn\u00e9. Cette commande r\u00e9initialise l'horloge de sorte que l'\u00e9tape suivante soit relative \u00e0 l'heure \"horloge\" fournie. L'h\u00f4te n'envoie g\u00e9n\u00e9ralement cette commande qu'au d\u00e9but d'une impression. stepper_get_position oid=%c : Cette commande am\u00e8ne le microcontr\u00f4leur \u00e0 g\u00e9n\u00e9rer un message de r\u00e9ponse \"stepper_position\" avec la position actuelle du stepper. La position est le nombre total d'\u00e9tapes g\u00e9n\u00e9r\u00e9es avec dir=1 moins le nombre total d'\u00e9tapes g\u00e9n\u00e9r\u00e9es avec dir=0. endstop_home oid=%c clock=%u sample_ticks=%u sample_count=%c rest_ticks=%u pin_value=%c : Cette commande est utilis\u00e9e lors des op\u00e9rations de \"homing\" des moteurs pas \u00e0 pas. Pour utiliser cette commande, une commande 'config_endstop' avec le m\u00eame param\u00e8tre 'oid' doit avoir \u00e9t\u00e9 \u00e9mise lors de la configuration du microcontr\u00f4leur. Lorsque cette commande est invoqu\u00e9e, le microcontr\u00f4leur \u00e9chantillonnera la broche endstop \u00e0 chaque tic d'horloge 'rest_ticks' et v\u00e9rifiera si elle a une valeur \u00e9gale \u00e0 'pin_value'. Si la valeur correspond (et continue de correspondre pour 'sample_count' \u00e9chantillons suppl\u00e9mentaires r\u00e9partis 'sample_ticks'), alors la file d'attente de mouvement pour le stepper associ\u00e9 sera effac\u00e9e et le stepper s'arr\u00eatera imm\u00e9diatement. L'h\u00f4te utilise cette commande pour impl\u00e9menter la prise d'origine - l'h\u00f4te demande \u00e0 la but\u00e9e d'\u00e9chantillonner pour le d\u00e9clencheur de but\u00e9e, puis il \u00e9met une s\u00e9rie de commandes queue_step pour d\u00e9placer un stepper vers la but\u00e9e. Une fois que le stepper atteint la but\u00e9e, le d\u00e9clencheur sera d\u00e9tect\u00e9, le mouvement arr\u00eat\u00e9 et l'h\u00f4te notifi\u00e9. D\u00e9placer la file d'attente \u00b6 Chaque commande queue_step utilise une entr\u00e9e dans la \"file d'attente de d\u00e9placement\" du microcontr\u00f4leur. Cette file d'attente est allou\u00e9e lorsqu'elle re\u00e7oit la commande \"finalize_config\", et elle signale le nombre d'entr\u00e9es de file d'attente disponibles dans les messages de r\u00e9ponse \"config\". Il est de la responsabilit\u00e9 de l'h\u00f4te de s'assurer qu'il y a de l'espace disponible dans la file d'attente avant d'envoyer une commande queue_step. Pour ce faire, l'h\u00f4te calcule le moment o\u00f9 chaque commande queue_step se termine et planifie de nouvelles commandes queue_step en cons\u00e9quence. Commandes SPI \u00b6 spi_transfer oid=%c data=%*s : Cette commande am\u00e8ne le microcontr\u00f4leur \u00e0 envoyer des \"donn\u00e9es\" au p\u00e9riph\u00e9rique spi sp\u00e9cifi\u00e9 par \"oid\" et g\u00e9n\u00e8re un message de r\u00e9ponse \"spi_transfer_response\" avec les donn\u00e9es retourn\u00e9es par le p\u00e9riph\u00e9rique. spi_send oid=%c data=%*s : Cette commande est similaire \u00e0 \"spi_transfer\", mais elle ne g\u00e9n\u00e8re pas de message \"spi_transfer_response\".","title":"Commandes MCU"},{"location":"MCU_Commands.html#commandes-mcu","text":"Ce document fournit des informations sur les commandes de bas niveau du microcontr\u00f4leur qui sont envoy\u00e9es depuis le logiciel \"h\u00f4te\" Klipper et trait\u00e9es par le firmware Klipper du microcontr\u00f4leur. Ce document n'est pas une r\u00e9f\u00e9rence faisant autorit\u00e9 pour ces commandes, ni une liste exclusive de toutes les commandes disponibles. Ce document peut \u00eatre utile aux d\u00e9veloppeurs souhaitant comprendre les commandes de bas niveau du microcontr\u00f4leur. Voir le document protocole pour plus d'informations sur le format des commandes et leur transmission. Les commandes ici sont d\u00e9crites en utilisant une syntaxe de style \"printf\" - pour ceux qui ne connaissent pas ce format, notez simplement que lorsqu'une s\u00e9quence '%...' est vue, elle doit \u00eatre remplac\u00e9e par un entier r\u00e9el. Par exemple, une description avec \"count=%c\" pourrait \u00eatre remplac\u00e9e par le texte \"count=10\". Notez que les param\u00e8tres qui sont consid\u00e9r\u00e9s comme des \"\u00e9num\u00e9rations\" (voir le document de protocole ci-dessus) prennent une valeur de cha\u00eene qui est automatiquement convertie en une valeur enti\u00e8re pour le microcontr\u00f4leur. Ceci est courant avec les param\u00e8tres nomm\u00e9s \"pin\" (ou qui ont le suffixe \"_pin\").","title":"Commandes MCU"},{"location":"MCU_Commands.html#commandes-de-demarrage","text":"Il peut \u00eatre n\u00e9cessaire d'effectuer des actions ponctuelles pour configurer le microcontr\u00f4leur et ses p\u00e9riph\u00e9riques. Cette section r\u00e9pertorie les commandes courantes disponibles \u00e0 cette effet. Contrairement \u00e0 la plupart des commandes de microcontr\u00f4leur, ces commandes s'ex\u00e9cutent d\u00e8s leur r\u00e9ception et ne n\u00e9cessitent aucune configuration particuli\u00e8re. Commandes de d\u00e9marrage courantes : set_digital_out pin=%u value=%c : Cette commande configure imm\u00e9diatement la broche donn\u00e9e en tant que sortie num\u00e9rique GPIO et la d\u00e9finit soit \u00e0 un niveau bas (valeur=0) soit \u00e0 un niveau haut (valeur=1 ). Cette commande peut \u00eatre utile pour configurer la valeur initiale des LED et pour configurer la valeur initiale des broches de micro-pas du pilote de moteur pas \u00e0 pas. set_pwm_out pin=%u cycle_ticks=%u value=%hu : Cette commande configurera la broche donn\u00e9e pour utiliser la modulation de largeur d'impulsion (PWM) bas\u00e9e sur le mat\u00e9riel avec le nombre donn\u00e9 de cycle_ticks. Le \"cycle_ticks\" est le nombre de ticks d'horloge du MCU que chaque cycle de mise sous tension et hors tension doit durer. Une valeur cycle_ticks de 1 peut \u00eatre utilis\u00e9e pour demander le temps de cycle le plus rapide possible. Le param\u00e8tre \"valeur\" est compris entre 0 et 255, 0 indiquant un \u00e9tat enti\u00e8rement d\u00e9sactiv\u00e9 et 255 indiquant un \u00e9tat enti\u00e8rement activ\u00e9. Cette commande peut \u00eatre utile pour activer les ventilateurs de refroidissement du processeur et des buses.","title":"Commandes de d\u00e9marrage"},{"location":"MCU_Commands.html#configuration-bas-niveau-du-microcontroleur","text":"La plupart des commandes du microcontr\u00f4leur n\u00e9cessitent une configuration initiale avant de pouvoir \u00eatre appel\u00e9es. Cette section fournit une vue d'ensemble du processus de configuration. Cette section et les sections suivantes ne sont susceptibles d'int\u00e9resser que les d\u00e9veloppeurs int\u00e9ress\u00e9s par les d\u00e9tails internes de Klipper. Lorsque l'h\u00f4te se connecte pour la premi\u00e8re fois au microcontr\u00f4leur, il commence toujours par obtenir un dictionnaire de donn\u00e9es (voir protocole pour plus d'informations). Une fois le dictionnaire de donn\u00e9es obtenu, l'h\u00f4te v\u00e9rifie si le microcontr\u00f4leur est dans un \u00e9tat \"configur\u00e9\" et le configure si ce n'est pas le cas. La configuration comprend les phases suivantes : get_config : L'h\u00f4te commence par v\u00e9rifier si le micro-contr\u00f4leur est d\u00e9j\u00e0 configur\u00e9. Le microcontr\u00f4leur r\u00e9pond \u00e0 cette commande par un message de r\u00e9ponse \u00ab config \u00bb. Le logiciel du microcontr\u00f4leur d\u00e9marre toujours dans un \u00e9tat non configur\u00e9 \u00e0 la mise sous tension. Il reste dans cet \u00e9tat jusqu'\u00e0 ce que l'h\u00f4te termine les processus de configuration (en \u00e9mettant une commande finalize_config). Si le microcontr\u00f4leur est d\u00e9j\u00e0 configur\u00e9 \u00e0 partir d'une session pr\u00e9c\u00e9dente (et est configur\u00e9 avec les param\u00e8tres souhait\u00e9s), aucune autre action n'est requise de la part de l'h\u00f4te et le processus de configuration se termine avec succ\u00e8s. allocate_oids count=%c : cette commande est envoy\u00e9e pour informer le microcontr\u00f4leur du nombre maximal d'identifiants d'objet (oid) requis par l'h\u00f4te. Il n'e faut envoyer cette commande qu'une seule fois. Un oid est un identifiant entier allou\u00e9 \u00e0 chaque stepper, chaque fin de course et chaque broche gpio programmable. L'h\u00f4te d\u00e9termine \u00e0 l'avance le nombre d'oids dont il aura besoin pour faire fonctionner le mat\u00e9riel et le transmet au microcontr\u00f4leur afin qu'il puisse allouer suffisamment de m\u00e9moire pour stocker un mappage de l'oid \u00e0 l'objet interne. config_XXX oid=%c ... : Par convention toute commande commen\u00e7ant par le pr\u00e9fixe \"config_\" cr\u00e9e un nouvel objet microcontr\u00f4leur et lui affecte l'oid donn\u00e9. Par exemple, la commande config_digital_out configurera la broche sp\u00e9cifi\u00e9e en tant que GPIO de sortie num\u00e9rique et cr\u00e9era un objet interne que l'h\u00f4te peut utiliser pour planifier des modifications du GPIO donn\u00e9. Le param\u00e8tre oid pass\u00e9 dans la commande config est s\u00e9lectionn\u00e9 par l'h\u00f4te et doit \u00eatre compris entre z\u00e9ro et le nombre maximal fourni dans la commande allow_oids. Les commandes de configuration ne peuvent \u00eatre ex\u00e9cut\u00e9es que lorsque le microcontr\u00f4leur n'est pas dans un \u00e9tat configur\u00e9 (c'est-\u00e0-dire avant que l'h\u00f4te n'envoie finalize_config) et apr\u00e8s que la commande allow_oids a \u00e9t\u00e9 envoy\u00e9e. finalize_config crc=%u : La commande finalize_config fait passer le microcontr\u00f4leur d'un \u00e9tat non configur\u00e9 \u00e0 un \u00e9tat configur\u00e9. Le param\u00e8tre crc transmis au microcontr\u00f4leur est stock\u00e9 et renvoy\u00e9 \u00e0 l'h\u00f4te dans les messages de r\u00e9ponse \"config\". Par convention, l'h\u00f4te prend un CRC 32 bits de la configuration qu'il demandera et au d\u00e9but des sessions de communication suivantes, il v\u00e9rifie que le CRC stock\u00e9 dans le microcontr\u00f4leur correspond exactement \u00e0 son CRC souhait\u00e9. Si le CRC ne correspond pas, l'h\u00f4te saura que le microcontr\u00f4leur n'a pas \u00e9t\u00e9 configur\u00e9 correctement.","title":"Configuration bas niveau du microcontr\u00f4leur"},{"location":"MCU_Commands.html#objets-de-base-du-microcontroleur","text":"Cette section r\u00e9pertorie quelques commandes de configuration couramment utilis\u00e9es. config_digital_out oid=%c pin=%u value=%c default_value=%c max_duration=%u : cette commande cr\u00e9e un objet de microcontr\u00f4leur interne pour la \"broche\" GPIO donn\u00e9e. La broche sera configur\u00e9e en mode de sortie num\u00e9rique et d\u00e9finie sur une valeur initiale telle que sp\u00e9cifi\u00e9e par 'value' (0 pour bas, 1 pour haut). La cr\u00e9ation d'un objet digital_out permet \u00e0 l'h\u00f4te de programmer des mises \u00e0 jour GPIO pour la broche donn\u00e9e \u00e0 des heures sp\u00e9cifi\u00e9es (voir la commande queue_digital_out d\u00e9crite ci-dessous). Si le logiciel du microcontr\u00f4leur passe en mode d'arr\u00eat, tous les objets digital_out configur\u00e9s seront d\u00e9finis sur 'default_value'. Le param\u00e8tre 'max_duration' est utilis\u00e9 pour impl\u00e9menter un contr\u00f4le de s\u00e9curit\u00e9 - s'il est diff\u00e9rent de z\u00e9ro, il s'agit du nombre maximal de ticks d'horloge pendannt lesquels l'h\u00f4te peut d\u00e9finir le GPIO donn\u00e9 sur une valeur autre que celle par d\u00e9faut sans autres mises \u00e0 jour. Par exemple, si la default_value est z\u00e9ro et la max_duration est de 16000, alors si l'h\u00f4te d\u00e9finit le gpio sur une valeur de un, il doit planifier une autre mise \u00e0 jour de la broche gpio (\u00e0 z\u00e9ro ou \u00e0 un) dans les 16000 tics d'horloge. Cette fonction de s\u00e9curit\u00e9 peut \u00eatre utilis\u00e9e avec des broches de chauffage pour s'assurer que l'h\u00f4te n'active pas le chauffage puis se d\u00e9connecte en le laissant activ\u00e9. config_pwm_out oid=%c pin=%u cycle_ticks=%u value=%hu default_value=%hu max_duration=%u : cette commande cr\u00e9e un objet interne pour les broches PWM mat\u00e9rielles pour lesquelles l'h\u00f4te peut planifier des mises \u00e0 jour . Son utilisation est analogue \u00e0 config_digital_out - voir la description des commandes 'set_pwm_out' et 'config_digital_out' pour la description des param\u00e8tres. config_analog_in oid=%c pin=%u : Cette commande permet de configurer une broche en mode d'\u00e9chantillonnage d'entr\u00e9e analogique. Une fois configur\u00e9e, la broche peut \u00eatre \u00e9chantillonn\u00e9e \u00e0 intervalle r\u00e9gulier \u00e0 l'aide de la commande query_analog_in (voir ci-dessous). config_stepper oid=%c step_pin=%c dir_pin=%c invert_step=%c step_pulse_ticks=%u : Cette commande cr\u00e9e un objet \"moteur pas \u00e0 pas\" interne. Les param\u00e8tres 'step_pin' et 'dir_pin' sp\u00e9cifient respectivement les broches de pas et de direction ; cette commande les configurera en mode de sortie num\u00e9rique. Le param\u00e8tre 'invert_step' sp\u00e9cifie si une \u00e9tape se produit sur un front montant (invert_step=0) ou descendant (invert_step=1). Le param\u00e8tre 'step_pulse_ticks' sp\u00e9cifie la dur\u00e9e minimale de l'impulsion de pas. Si le mcu exporte la constante 'STEPPER_BOTH_EDGE=1', le r\u00e9glage step_pulse_ticks=0 et invert_step=-1 sera configur\u00e9 pour marcher sur les fronts montant et descendant de la broche de pas. config_endstop oid=%c pin=%c pull_up=%c stepper_count=%c : Cette commande cr\u00e9e un objet \"endstop\" interne. Il est utilis\u00e9 pour sp\u00e9cifier les broches d'arr\u00eat et pour activer les op\u00e9rations de \"homing\" (voir la commande endstop_home ci-dessous). La commande configurera la broche sp\u00e9cifi\u00e9e en mode d'entr\u00e9e num\u00e9rique. Le param\u00e8tre 'pull_up' d\u00e9termine si les r\u00e9sistances pullup fournies par le mat\u00e9riel pour la broche (si disponibles) seront activ\u00e9es. Le param\u00e8tre 'stepper_count' sp\u00e9cifie le nombre maximum de pas dont cette but\u00e9e peut avoir besoin pendant une op\u00e9ration de prise d'origine (voir endstop_home ci-dessous). config_spi oid=%c bus=%u pin=%u mode=%u rate=%u shutdown_msg=%*s : Cette commande cr\u00e9e un objet SPI interne. Il est utilis\u00e9 avec les commandes spi_transfer et spi_send (voir ci-dessous). Le param\u00e8tre \"bus\" identifie le bus SPI \u00e0 utiliser (si le microcontr\u00f4leur a plus d'un bus SPI disponible). Le param\u00e8tre \"broche\" sp\u00e9cifie la broche de s\u00e9lection de puce (CS) pour le p\u00e9riph\u00e9rique. Le param\u00e8tre \"mode\" est le mode SPI (doit \u00eatre compris entre 0 et 3). Le param\u00e8tre \"rate\" sp\u00e9cifie le d\u00e9bit du bus SPI (en cycles par seconde). Enfin, le param\u00e8tre \"shutdown_msg\" est une commande SPI \u00e0 envoyer \u00e0 l'appareil donn\u00e9 si le microcontr\u00f4leur passe en \u00e9tat d'arr\u00eat. config_spi_without_cs oid=%c bus=%u mode=%u rate=%u shutdown_msg=%*s : Cette commande est similaire \u00e0 config_spi, mais sans d\u00e9finition de la broche CS. Il est utile pour les appareils SPI qui n'ont pas de ligne de s\u00e9lection de puce.","title":"Objets de base du microcontr\u00f4leur"},{"location":"MCU_Commands.html#commandes-courantes","text":"Cette section r\u00e9pertorie les commandes les plus couramment utilis\u00e9es. Cela n'int\u00e9resse probablement que les d\u00e9veloppeurs qui cherchent \u00e0 mieux comprendre Klipper. set_digital_out_pwm_cycle oid=%c cycle_ticks=%u : cette commande configure une broche de sortie num\u00e9rique (telle que cr\u00e9\u00e9e par config_digital_out) pour utiliser le \"PWM logciel\". Le 'cycle_ticks' est le nombre de tics d'horloge pour le cycle PWM. \u00c9tant donn\u00e9 que la commutation de sortie est impl\u00e9ment\u00e9e dans le logiciel du microcontr\u00f4leur, il est recommand\u00e9 que 'cycle_ticks' corresponde \u00e0 un temps de 10 ms ou plus. queue_digital_out oid=%c clock=%u on_ticks=%u : Cette commande permet de planifier une changement d'\u00e9tat d'une broche GPIO de sortie num\u00e9rique au tick d'horloge donn\u00e9e. Pour utiliser cette commande, une commande 'config_digital_out' avec le m\u00eame param\u00e8tre 'oid' doit avoir \u00e9t\u00e9 \u00e9mise lors de la configuration du microcontr\u00f4leur. Si 'set_digital_out_pwm_cycle' a \u00e9t\u00e9 appel\u00e9, alors 'on_ticks' est la dur\u00e9e d'activation (en ticks d'horloge) pour le cycle pwm. Sinon, 'on_ticks' doit \u00eatre soit 0 (pour basse tension) soit 1 (pour haute tension). queue_pwm_out oid=%c clock=%u value=%hu : planifie un changement sur une broche de sortie PWM mat\u00e9rielle. Voir les commandes 'queue_digital_out' et 'config_pwm_out' pour plus d'informations. query_analog_in oid=%c clock=%u sample_ticks=%u sample_count=%c rest_ticks=%u min_value=%hu max_value=%hu : Cette commande d\u00e9finit une r\u00e9cup\u00e9ration r\u00e9currente d'\u00e9chantillons d'entr\u00e9e analogique. Pour utiliser cette commande, une commande 'config_analog_in' avec le m\u00eame param\u00e8tre 'oid' doit avoir \u00e9t\u00e9 \u00e9mise lors de la configuration du microcontr\u00f4leur. Les \u00e9chantillons commenceront \u00e0 partir de l'heure 'clock', et ils rapporteront la valeur obtenue \u00e0 chaque tic d'horloge 'rest_ticks', il sur\u00e9chantillonnera avec un nombre 'sample_count' d'\u00e9chantillons et il se mettra en pause pendant le nombre 'sample_ticks' de tic d'horloge entre chaque \u00e9chantillonnage. Les param\u00e8tres 'min_value' et 'max_value' impl\u00e9mentent une fonction de s\u00e9curit\u00e9 - le logiciel du microcontr\u00f4leur v\u00e9rifiera que la valeur \u00e9chantillonn\u00e9e se situe toujours dans la plage fournie. Ceci est destin\u00e9 \u00e0 \u00eatre utilis\u00e9 avec des broches rattach\u00e9es aux thermistances contr\u00f4lant les radiateurs - il peut \u00eatre utilis\u00e9 pour v\u00e9rifier qu'un radiateur se trouve dans une plage de temp\u00e9rature correcte. get_clock : Cette commande am\u00e8ne le microcontr\u00f4leur \u00e0 g\u00e9n\u00e9rer un message de r\u00e9ponse \"clock\". L'h\u00f4te envoie cette commande une fois par seconde pour obtenir la valeur de l'horloge du microcontr\u00f4leur et pour estimer la d\u00e9rive entre les horloges de l'h\u00f4te et du microcontr\u00f4leur. Il permet \u00e0 l'h\u00f4te d'estimer avec pr\u00e9cision l'horloge du microcontr\u00f4leur.","title":"Commandes courantes"},{"location":"MCU_Commands.html#commandes-de-moteurs-pas-a-pas","text":"queue_step oid=%c interval=%u count=%hu add=%hi : cette commande planifie le nombre de pas 'count' pour le stepper donn\u00e9, avec un nombre 'd'intervalle' de ticks d'horloge entre chaque pas. La premi\u00e8re \u00e9tape sera le nombre \"d'intervalle\" de ticks d'horloge depuis la derni\u00e8re \u00e9tape planifi\u00e9e pour le stepper donn\u00e9. Si 'add' n'est pas nul, l'intervalle sera ajust\u00e9 du montant 'add' apr\u00e8s chaque pas. Cette commande ajoute la s\u00e9quence d'intervalle/compte/ajout donn\u00e9e \u00e0 une file d'attente des pas. Il peut y avoir des centaines de ces s\u00e9quences en file d'attente pendant le fonctionnement normal. Une nouvelle s\u00e9quence est ajout\u00e9e \u00e0 la fin de la file d'attente et lorsque chaque s\u00e9quence termine son nombre de pas, elle est retir\u00e9e du d\u00e9but de la file d'attente. Ce syst\u00e8me permet au microcontr\u00f4leur de mettre en file d'attente potentiellement des centaines de milliers d'\u00e9tapes, le tout avec des dur\u00e9es fiables et pr\u00e9visibles. set_next_step_dir oid=%c dir=%c : Cette commande sp\u00e9cifie la valeur du dir_pin que la prochaine commande queue_step utilisera. reset_step_clock oid=%c clock=%u : Normalement, la synchronisation des pas est relative au dernier pas pour un stepper donn\u00e9. Cette commande r\u00e9initialise l'horloge de sorte que l'\u00e9tape suivante soit relative \u00e0 l'heure \"horloge\" fournie. L'h\u00f4te n'envoie g\u00e9n\u00e9ralement cette commande qu'au d\u00e9but d'une impression. stepper_get_position oid=%c : Cette commande am\u00e8ne le microcontr\u00f4leur \u00e0 g\u00e9n\u00e9rer un message de r\u00e9ponse \"stepper_position\" avec la position actuelle du stepper. La position est le nombre total d'\u00e9tapes g\u00e9n\u00e9r\u00e9es avec dir=1 moins le nombre total d'\u00e9tapes g\u00e9n\u00e9r\u00e9es avec dir=0. endstop_home oid=%c clock=%u sample_ticks=%u sample_count=%c rest_ticks=%u pin_value=%c : Cette commande est utilis\u00e9e lors des op\u00e9rations de \"homing\" des moteurs pas \u00e0 pas. Pour utiliser cette commande, une commande 'config_endstop' avec le m\u00eame param\u00e8tre 'oid' doit avoir \u00e9t\u00e9 \u00e9mise lors de la configuration du microcontr\u00f4leur. Lorsque cette commande est invoqu\u00e9e, le microcontr\u00f4leur \u00e9chantillonnera la broche endstop \u00e0 chaque tic d'horloge 'rest_ticks' et v\u00e9rifiera si elle a une valeur \u00e9gale \u00e0 'pin_value'. Si la valeur correspond (et continue de correspondre pour 'sample_count' \u00e9chantillons suppl\u00e9mentaires r\u00e9partis 'sample_ticks'), alors la file d'attente de mouvement pour le stepper associ\u00e9 sera effac\u00e9e et le stepper s'arr\u00eatera imm\u00e9diatement. L'h\u00f4te utilise cette commande pour impl\u00e9menter la prise d'origine - l'h\u00f4te demande \u00e0 la but\u00e9e d'\u00e9chantillonner pour le d\u00e9clencheur de but\u00e9e, puis il \u00e9met une s\u00e9rie de commandes queue_step pour d\u00e9placer un stepper vers la but\u00e9e. Une fois que le stepper atteint la but\u00e9e, le d\u00e9clencheur sera d\u00e9tect\u00e9, le mouvement arr\u00eat\u00e9 et l'h\u00f4te notifi\u00e9.","title":"Commandes de moteurs pas \u00e0 pas"},{"location":"MCU_Commands.html#deplacer-la-file-dattente","text":"Chaque commande queue_step utilise une entr\u00e9e dans la \"file d'attente de d\u00e9placement\" du microcontr\u00f4leur. Cette file d'attente est allou\u00e9e lorsqu'elle re\u00e7oit la commande \"finalize_config\", et elle signale le nombre d'entr\u00e9es de file d'attente disponibles dans les messages de r\u00e9ponse \"config\". Il est de la responsabilit\u00e9 de l'h\u00f4te de s'assurer qu'il y a de l'espace disponible dans la file d'attente avant d'envoyer une commande queue_step. Pour ce faire, l'h\u00f4te calcule le moment o\u00f9 chaque commande queue_step se termine et planifie de nouvelles commandes queue_step en cons\u00e9quence.","title":"D\u00e9placer la file d'attente"},{"location":"MCU_Commands.html#commandes-spi","text":"spi_transfer oid=%c data=%*s : Cette commande am\u00e8ne le microcontr\u00f4leur \u00e0 envoyer des \"donn\u00e9es\" au p\u00e9riph\u00e9rique spi sp\u00e9cifi\u00e9 par \"oid\" et g\u00e9n\u00e8re un message de r\u00e9ponse \"spi_transfer_response\" avec les donn\u00e9es retourn\u00e9es par le p\u00e9riph\u00e9rique. spi_send oid=%c data=%*s : Cette commande est similaire \u00e0 \"spi_transfer\", mais elle ne g\u00e9n\u00e8re pas de message \"spi_transfer_response\".","title":"Commandes SPI"},{"location":"Manual_Level.html","text":"Nivellement manuel \u00b6 Ce document d\u00e9crit les outils pour le r\u00e9glage de la fin de course Z et pour effectuer les r\u00e9glages sur les vis de mise \u00e0 niveau du lit. Calibrer la fin de course Z \u00b6 Une position pr\u00e9cise de la but\u00e9e Z est essentielle pour obtenir des impressions de haute qualit\u00e9. Notez que la pr\u00e9cision de l'interrupteur de fin de course Z lui-m\u00eame peut \u00eatre un facteur limitant. Si vous utilisez des pilotes de moteurs pas \u00e0 pas Trinamic, pensez \u00e0 activer la d\u00e9tection endstop phase pour am\u00e9liorer la pr\u00e9cision du commutateur. Pour effectuer un \u00e9talonnage de la fin de course Z, placez l'imprimante \u00e0 l'origine, d\u00e9placez la t\u00eate vers une position Z situ\u00e9e \u00e0 au moins cinq millim\u00e8tres au-dessus du lit (si ce n'est d\u00e9j\u00e0 fait), d\u00e9placez ensuite la t\u00eate vers une position XY pr\u00e8s du centre de le lit, puis acc\u00e9dez \u00e0 l'aide du terminal ex\u00e9cutez : Z_ENDSTOP_CALIBRATE Suivez ensuite les \u00e9tapes d\u00e9crites dans \"le test du papier\" pour d\u00e9terminer la distance r\u00e9elle entre la buse et le lit \u00e0 l'emplacement donn\u00e9. Une fois ces \u00e9tapes termin\u00e9es, on peut taper ACCEPT pour valider la position et enregistrer les r\u00e9sultats dans le fichier de configuration avec : SAVE_CONFIG Il est pr\u00e9f\u00e9rable d'utiliser un interrupteur de fin de course Z \u00e0 l'extr\u00e9mit\u00e9 de l'axe Z oppos\u00e9e au lit (il est plus s\u00e9curisant d'effectuer le retour au point d'origine loin du lit). Cependant, si l'on doit se diriger vers le lit, il est recommand\u00e9 de r\u00e9gler la but\u00e9e de fin de course de mani\u00e8re \u00e0 ce qu'elle se d\u00e9clenche \u00e0 une petite distance (par exemple, 0,5 mm) au-dessus du lit. Presque tous les interrupteurs de fin de course peuvent \u00eatre enfonc\u00e9s en toute s\u00e9curit\u00e9 \u00e0 une petite distance au-del\u00e0 de leur point de d\u00e9clenchement. Lorsque cela est fait, on devrait constater que la commande Z_ENDSTOP_CALIBRATE rapporte une petite valeur positive (par exemple, 0,5 mm) pour la position Z_endstop. D\u00e9clencher la but\u00e9e de fin de course alors qu'elle est encore \u00e0 une certaine distance du lit r\u00e9duit le risque d'\u00e9crasement involontaire de la buse sur le lit. Certaines imprimantes laissent la possibilit\u00e9 d'ajuster manuellement l'emplacement de l'interrupteur de fin de course. Cependant, il est recommand\u00e9 d'effectuer le positionnement de la but\u00e9e Z dans le logiciel avec Klipper - une fois que la but\u00e9e est bien positionn\u00e9, on peut faire d'autres ajustements en ex\u00e9cutant Z_ENDSTOP_CALIBRATE ou en mettant \u00e0 jour manuellement la position Z_endstop dans le fichier de configuration. R\u00e9glage des vis de mise \u00e0 niveau du lit \u00b6 Le secret pour obtenir un bon nivellement du lit avec les vis est d'utiliser le syst\u00e8me de mouvement de haute pr\u00e9cision de l'imprimante pendant le processus de nivellement du lit lui-m\u00eame. Cela se fait en commandant la buse \u00e0 une position proche de chaque vis de r\u00e9glage du lit, puis en ajustant cette vis jusqu'\u00e0 ce que le lit soit \u00e0 une distance d\u00e9finie de la buse. Klipper a un outil pour vous aider. Pour utiliser l'outil, il est n\u00e9cessaire de sp\u00e9cifier l'emplacement XY de chaque vis. Cela se fait en cr\u00e9ant une section de configuration [bed_screws] . Par exemple, cela pourrait ressembler \u00e0 : [bed_screws] screw1: 100, 50 screw2: 100, 150 screw3: 150, 100 Si la vis de r\u00e9glage se trouve sous le lit, sp\u00e9cifiez la position XY directement au-dessus de la vis. Si la vis est \u00e0 l'ext\u00e9rieur du lit, sp\u00e9cifiez une position XY la plus proche de la vis tout en restant dans les limites du lit. Une fois que le fichier de configuration est pr\u00eat, ex\u00e9cutez RESTART pour charger la nouvelle configuration, puis vous pouvez d\u00e9marrer l'outil en ex\u00e9cutant : BED_SCREWS_ADJUST Cet outil va d\u00e9placer la buse de l'imprimante vers chaque emplacement XY de vis, puis d\u00e9placera la buse \u00e0 une hauteur Z = 0. \u00c0 ce stade, on peut utiliser le \"test du papier\" pour ajuster la vis de r\u00e9glage directement sous la buse. Voir les informations d\u00e9crites dans \"le test du papier\" , mais ajustez la vis de r\u00e9glage au lieu de d\u00e9placer la buse \u00e0 diff\u00e9rentes hauteurs. Ajustez la vis de r\u00e9glage jusqu'\u00e0 ce qu'il y ait une petite friction lorsque vous poussez le papier d'avant en arri\u00e8re. Une fois la vis ajust\u00e9e de mani\u00e8re \u00e0 ressentir une l\u00e9g\u00e8re friction, ex\u00e9cutez la commande ACCEPT ou ADJUSTED . Utilisez la commande ADJUSTED si la vis du lit n\u00e9cessitait un ajustement (g\u00e9n\u00e9ralement plus d'environ 1/8 de tour de vis). Utilisez la commande ACCEPTER si aucun ajustement significatif n'est n\u00e9cessaire. Les deux commandes feront passer l'outil \u00e0 la vis suivante. (Lorsqu'une commande ADJUSTED est utilis\u00e9e, l'outil programme un cycle suppl\u00e9mentaire d'ajustements des vis\u202f; l'outil se termine avec succ\u00e8s lorsque toutes les vis d'assise sont v\u00e9rifi\u00e9es pour ne pas n\u00e9cessiter d'ajustements importants.) On peut utiliser la commande ABORT pour quitter l'outil plus t\u00f4t. Ce syst\u00e8me fonctionne mieux lorsque l'imprimante a une surface d'impression plate (telle que du verre) et des rails rectilignes. Une fois l'outil de nivellement du lit termin\u00e9 avec succ\u00e8s, le lit est pr\u00eat pour l'impression. R\u00e9glages fin des vis de nivellement \u00b6 Si l'imprimante utilise trois vis de r\u00e9glages et que les trois vis sont sous le lit, il est alors \u00eatre possible d'effectuer une deuxi\u00e8me \u00e9tape de mise \u00e0 niveau du lit de \u00ab haute pr\u00e9cision \u00bb. Cela se fait en d\u00e9pla\u00e7ant la buse vers les endroits les plus \u00e9loign\u00e9s des vis de r\u00e9glages. Par exemple, consid\u00e9rons un lit avec des vis aux emplacements A, B et C : Pour chaque r\u00e9glage effectu\u00e9 sur la vis du lit \u00e0 l'emplacement C, le lit oscillera le long d'un axe d\u00e9fini par les deux vis du lit restantes (repr\u00e9sent\u00e9es ici par une ligne verte). Dans cette situation, chaque r\u00e9glage de la vis du lit en C d\u00e9placera le lit en position D d'une plus grande distance que directement en C. Il est ainsi possible d'effectuer un r\u00e9glage am\u00e9lior\u00e9 de la vis C lorsque la buse est en position D. Pour activer cette fonctionnalit\u00e9, il faudra d\u00e9terminer les coordonn\u00e9es suppl\u00e9mentaires de la buse et les ajouter au fichier de configuration. Par exemple, cela pourrait ressembler \u00e0 : [bed_screws] screw1: 100, 50 screw1_fine_adjust: 0, 0 screw2: 100, 150 screw2_fine_adjust: 300, 300 screw3: 150, 100 screw3_fine_adjust: 0, 100 Lorsque cette fonctionnalit\u00e9 est activ\u00e9e, la commande BED_SCREWS_ADJUST demandera d'abord des ajustements grossiers directement au-dessus de chaque position de vis, et une fois ceux-ci accept\u00e9s, il demandera des ajustements fins aux emplacements suppl\u00e9mentaires. Continuez \u00e0 utiliser ACCEPT et ADJUSTED \u00e0 chaque position. R\u00e9glage des vis de mise \u00e0 niveau du lit \u00e0 l'aide de la sonde de lit \u00b6 C'est une autre fa\u00e7on de calibrer le niveau du lit avec la sonde de lit. Pour l'utiliser, vous devez disposer d'une sonde Z (BL Touch, capteur inductif, etc.). Pour activer cette fonctionnalit\u00e9, il faut d\u00e9terminer les coordonn\u00e9es de la buse de sorte que la sonde Z soit au-dessus des vis, puis les ajouter au fichier de configuration. Par exemple, cela pourrait ressembler \u00e0 : [screws_tilt_adjust] screw1: -5, 30 screw1_name: front left screw screw2: 155, 30 screw2_name: front right screw screw3: 155, 190 screw3_name: rear right screw screw4: -5, 190 screw4_name: rear left screw horizontal_move_z: 10. speed: 50. screw_thread: CW-M3 La vis1 est toujours le point de r\u00e9f\u00e9rence pour les autres, donc le syst\u00e8me suppose que la vis1 est \u00e0 la bonne hauteur. Ex\u00e9cutez toujours G28 en premier, puis ex\u00e9cutez SCREWS_TILT_CALCULATE - cela devrait produire une sortie similaire \u00e0 : Send: G28 Recv: ok Send: SCREWS_TILT_CALCULATE Recv: // 01:20 means 1 full turn and 20 minutes, CW=clockwise, CCW=counter-clockwise Recv: // front left screw (base) : x=-5.0, y=30.0, z=2.48750 Recv: // front right screw : x=155.0, y=30.0, z=2.36000 : adjust CW 01:15 Recv: // rear right screw : y=155.0, y=190.0, z=2.71500 : adjust CCW 00:50 Recv: // read left screw : x=-5.0, y=190.0, z=2.47250 : adjust CW 00:02 Recv: ok Cela signifie que : la vis avant gauche est le point de r\u00e9f\u00e9rence vous ne devez pas la changer. la vis avant droite doit \u00eatre tourn\u00e9e dans le sens des aiguilles d'une montre d'un tour complet et d'un quart de tour La vis arri\u00e8re droite doit \u00eatre tourn\u00e9e dans le sens inverse des aiguilles d\u2019une montre d'environ 50 minutes la vis arri\u00e8re gauche doit \u00eatre tourn\u00e9e dans le sens des aiguilles d'une montre d'un angle de 2 minutes (pas besoin c'est ok) Notez que \"minutes\" fait r\u00e9f\u00e9rence aux \"minutes d'un cadran d'horloge\". Ainsi, par exemple, 15 minutes correspondent \u00e0 un quart de tour complet. R\u00e9p\u00e9tez le processus plusieurs fois jusqu'\u00e0 ce que vous obteniez un bon niveau de lit - normalement lorsque tous les ajustements sont inf\u00e9rieurs \u00e0 une rotation de 6 minutes des vis de r\u00e9glage. Si vous utilisez une sonde mont\u00e9e sur le c\u00f4t\u00e9 de la hotend (c'est-\u00e0-dire qu'elle a un d\u00e9calage X ou Y), notez que le r\u00e9glage de l'inclinaison du lit rendra caduc l'\u00e9talonnage de sonde pr\u00e9c\u00e9demment effectu\u00e9 avec un lit inclin\u00e9. Assurez-vous d'ex\u00e9cuter \u00e9talonnage de la sonde apr\u00e8s avoir ajust\u00e9 les vis du lit. Le param\u00e8tre MAX_DEVIATION est utile lorsqu'un maillage de lit sauvegard\u00e9 est utilis\u00e9, pour s'assurer que le niveau du lit n'a pas trop d\u00e9riv\u00e9 de l'endroit o\u00f9 il se trouvait lorsque le maillage a \u00e9t\u00e9 cr\u00e9\u00e9. Par exemple, SCREWS_TILT_CALCULATE MAX_DEVIATION=0.01 peut \u00eatre ajout\u00e9 au gcode de d\u00e9marrage personnalis\u00e9 du trancheur avant le chargement du maillage. Il interrompra l'impression si la limite configur\u00e9e est d\u00e9pass\u00e9e (0,01 mm dans cet exemple), donnant \u00e0 l'utilisateur une chance d'ajuster les vis et de red\u00e9marrer l'impression. Le param\u00e8tre DIRECTION est utile si vous ne pouvez tourner les vis de r\u00e9glage de votre lit que dans un seul sens. Par exemple, vous pourriez avoir des vis qui commencent \u00e0 \u00eatre serr\u00e9es dans leur position la plus basse (ou la plus haute) possible, qui ne peuvent \u00eatre tourn\u00e9es que dans une seule direction, pour \u00e9lever (ou abaisser) le lit. Si vous ne pouvez tourner les vis que dans le sens des aiguilles d'une montre, ex\u00e9cutez SCREWS_TILT_CALCULATE DIRECTION=CW . Si vous ne pouvez les tourner que dans le sens antihoraire, ex\u00e9cutez SCREWS_TILT_CALCULATE DIRECTION=CCW . Un point de r\u00e9f\u00e9rence appropri\u00e9 sera choisi de sorte que le lit puisse \u00eatre nivel\u00e9 en tournant toutes les vis dans la direction donn\u00e9e.","title":"Nivellement manuel"},{"location":"Manual_Level.html#nivellement-manuel","text":"Ce document d\u00e9crit les outils pour le r\u00e9glage de la fin de course Z et pour effectuer les r\u00e9glages sur les vis de mise \u00e0 niveau du lit.","title":"Nivellement manuel"},{"location":"Manual_Level.html#calibrer-la-fin-de-course-z","text":"Une position pr\u00e9cise de la but\u00e9e Z est essentielle pour obtenir des impressions de haute qualit\u00e9. Notez que la pr\u00e9cision de l'interrupteur de fin de course Z lui-m\u00eame peut \u00eatre un facteur limitant. Si vous utilisez des pilotes de moteurs pas \u00e0 pas Trinamic, pensez \u00e0 activer la d\u00e9tection endstop phase pour am\u00e9liorer la pr\u00e9cision du commutateur. Pour effectuer un \u00e9talonnage de la fin de course Z, placez l'imprimante \u00e0 l'origine, d\u00e9placez la t\u00eate vers une position Z situ\u00e9e \u00e0 au moins cinq millim\u00e8tres au-dessus du lit (si ce n'est d\u00e9j\u00e0 fait), d\u00e9placez ensuite la t\u00eate vers une position XY pr\u00e8s du centre de le lit, puis acc\u00e9dez \u00e0 l'aide du terminal ex\u00e9cutez : Z_ENDSTOP_CALIBRATE Suivez ensuite les \u00e9tapes d\u00e9crites dans \"le test du papier\" pour d\u00e9terminer la distance r\u00e9elle entre la buse et le lit \u00e0 l'emplacement donn\u00e9. Une fois ces \u00e9tapes termin\u00e9es, on peut taper ACCEPT pour valider la position et enregistrer les r\u00e9sultats dans le fichier de configuration avec : SAVE_CONFIG Il est pr\u00e9f\u00e9rable d'utiliser un interrupteur de fin de course Z \u00e0 l'extr\u00e9mit\u00e9 de l'axe Z oppos\u00e9e au lit (il est plus s\u00e9curisant d'effectuer le retour au point d'origine loin du lit). Cependant, si l'on doit se diriger vers le lit, il est recommand\u00e9 de r\u00e9gler la but\u00e9e de fin de course de mani\u00e8re \u00e0 ce qu'elle se d\u00e9clenche \u00e0 une petite distance (par exemple, 0,5 mm) au-dessus du lit. Presque tous les interrupteurs de fin de course peuvent \u00eatre enfonc\u00e9s en toute s\u00e9curit\u00e9 \u00e0 une petite distance au-del\u00e0 de leur point de d\u00e9clenchement. Lorsque cela est fait, on devrait constater que la commande Z_ENDSTOP_CALIBRATE rapporte une petite valeur positive (par exemple, 0,5 mm) pour la position Z_endstop. D\u00e9clencher la but\u00e9e de fin de course alors qu'elle est encore \u00e0 une certaine distance du lit r\u00e9duit le risque d'\u00e9crasement involontaire de la buse sur le lit. Certaines imprimantes laissent la possibilit\u00e9 d'ajuster manuellement l'emplacement de l'interrupteur de fin de course. Cependant, il est recommand\u00e9 d'effectuer le positionnement de la but\u00e9e Z dans le logiciel avec Klipper - une fois que la but\u00e9e est bien positionn\u00e9, on peut faire d'autres ajustements en ex\u00e9cutant Z_ENDSTOP_CALIBRATE ou en mettant \u00e0 jour manuellement la position Z_endstop dans le fichier de configuration.","title":"Calibrer la fin de course Z"},{"location":"Manual_Level.html#reglage-des-vis-de-mise-a-niveau-du-lit","text":"Le secret pour obtenir un bon nivellement du lit avec les vis est d'utiliser le syst\u00e8me de mouvement de haute pr\u00e9cision de l'imprimante pendant le processus de nivellement du lit lui-m\u00eame. Cela se fait en commandant la buse \u00e0 une position proche de chaque vis de r\u00e9glage du lit, puis en ajustant cette vis jusqu'\u00e0 ce que le lit soit \u00e0 une distance d\u00e9finie de la buse. Klipper a un outil pour vous aider. Pour utiliser l'outil, il est n\u00e9cessaire de sp\u00e9cifier l'emplacement XY de chaque vis. Cela se fait en cr\u00e9ant une section de configuration [bed_screws] . Par exemple, cela pourrait ressembler \u00e0 : [bed_screws] screw1: 100, 50 screw2: 100, 150 screw3: 150, 100 Si la vis de r\u00e9glage se trouve sous le lit, sp\u00e9cifiez la position XY directement au-dessus de la vis. Si la vis est \u00e0 l'ext\u00e9rieur du lit, sp\u00e9cifiez une position XY la plus proche de la vis tout en restant dans les limites du lit. Une fois que le fichier de configuration est pr\u00eat, ex\u00e9cutez RESTART pour charger la nouvelle configuration, puis vous pouvez d\u00e9marrer l'outil en ex\u00e9cutant : BED_SCREWS_ADJUST Cet outil va d\u00e9placer la buse de l'imprimante vers chaque emplacement XY de vis, puis d\u00e9placera la buse \u00e0 une hauteur Z = 0. \u00c0 ce stade, on peut utiliser le \"test du papier\" pour ajuster la vis de r\u00e9glage directement sous la buse. Voir les informations d\u00e9crites dans \"le test du papier\" , mais ajustez la vis de r\u00e9glage au lieu de d\u00e9placer la buse \u00e0 diff\u00e9rentes hauteurs. Ajustez la vis de r\u00e9glage jusqu'\u00e0 ce qu'il y ait une petite friction lorsque vous poussez le papier d'avant en arri\u00e8re. Une fois la vis ajust\u00e9e de mani\u00e8re \u00e0 ressentir une l\u00e9g\u00e8re friction, ex\u00e9cutez la commande ACCEPT ou ADJUSTED . Utilisez la commande ADJUSTED si la vis du lit n\u00e9cessitait un ajustement (g\u00e9n\u00e9ralement plus d'environ 1/8 de tour de vis). Utilisez la commande ACCEPTER si aucun ajustement significatif n'est n\u00e9cessaire. Les deux commandes feront passer l'outil \u00e0 la vis suivante. (Lorsqu'une commande ADJUSTED est utilis\u00e9e, l'outil programme un cycle suppl\u00e9mentaire d'ajustements des vis\u202f; l'outil se termine avec succ\u00e8s lorsque toutes les vis d'assise sont v\u00e9rifi\u00e9es pour ne pas n\u00e9cessiter d'ajustements importants.) On peut utiliser la commande ABORT pour quitter l'outil plus t\u00f4t. Ce syst\u00e8me fonctionne mieux lorsque l'imprimante a une surface d'impression plate (telle que du verre) et des rails rectilignes. Une fois l'outil de nivellement du lit termin\u00e9 avec succ\u00e8s, le lit est pr\u00eat pour l'impression.","title":"R\u00e9glage des vis de mise \u00e0 niveau du lit"},{"location":"Manual_Level.html#reglages-fin-des-vis-de-nivellement","text":"Si l'imprimante utilise trois vis de r\u00e9glages et que les trois vis sont sous le lit, il est alors \u00eatre possible d'effectuer une deuxi\u00e8me \u00e9tape de mise \u00e0 niveau du lit de \u00ab haute pr\u00e9cision \u00bb. Cela se fait en d\u00e9pla\u00e7ant la buse vers les endroits les plus \u00e9loign\u00e9s des vis de r\u00e9glages. Par exemple, consid\u00e9rons un lit avec des vis aux emplacements A, B et C : Pour chaque r\u00e9glage effectu\u00e9 sur la vis du lit \u00e0 l'emplacement C, le lit oscillera le long d'un axe d\u00e9fini par les deux vis du lit restantes (repr\u00e9sent\u00e9es ici par une ligne verte). Dans cette situation, chaque r\u00e9glage de la vis du lit en C d\u00e9placera le lit en position D d'une plus grande distance que directement en C. Il est ainsi possible d'effectuer un r\u00e9glage am\u00e9lior\u00e9 de la vis C lorsque la buse est en position D. Pour activer cette fonctionnalit\u00e9, il faudra d\u00e9terminer les coordonn\u00e9es suppl\u00e9mentaires de la buse et les ajouter au fichier de configuration. Par exemple, cela pourrait ressembler \u00e0 : [bed_screws] screw1: 100, 50 screw1_fine_adjust: 0, 0 screw2: 100, 150 screw2_fine_adjust: 300, 300 screw3: 150, 100 screw3_fine_adjust: 0, 100 Lorsque cette fonctionnalit\u00e9 est activ\u00e9e, la commande BED_SCREWS_ADJUST demandera d'abord des ajustements grossiers directement au-dessus de chaque position de vis, et une fois ceux-ci accept\u00e9s, il demandera des ajustements fins aux emplacements suppl\u00e9mentaires. Continuez \u00e0 utiliser ACCEPT et ADJUSTED \u00e0 chaque position.","title":"R\u00e9glages fin des vis de nivellement"},{"location":"Manual_Level.html#reglage-des-vis-de-mise-a-niveau-du-lit-a-laide-de-la-sonde-de-lit","text":"C'est une autre fa\u00e7on de calibrer le niveau du lit avec la sonde de lit. Pour l'utiliser, vous devez disposer d'une sonde Z (BL Touch, capteur inductif, etc.). Pour activer cette fonctionnalit\u00e9, il faut d\u00e9terminer les coordonn\u00e9es de la buse de sorte que la sonde Z soit au-dessus des vis, puis les ajouter au fichier de configuration. Par exemple, cela pourrait ressembler \u00e0 : [screws_tilt_adjust] screw1: -5, 30 screw1_name: front left screw screw2: 155, 30 screw2_name: front right screw screw3: 155, 190 screw3_name: rear right screw screw4: -5, 190 screw4_name: rear left screw horizontal_move_z: 10. speed: 50. screw_thread: CW-M3 La vis1 est toujours le point de r\u00e9f\u00e9rence pour les autres, donc le syst\u00e8me suppose que la vis1 est \u00e0 la bonne hauteur. Ex\u00e9cutez toujours G28 en premier, puis ex\u00e9cutez SCREWS_TILT_CALCULATE - cela devrait produire une sortie similaire \u00e0 : Send: G28 Recv: ok Send: SCREWS_TILT_CALCULATE Recv: // 01:20 means 1 full turn and 20 minutes, CW=clockwise, CCW=counter-clockwise Recv: // front left screw (base) : x=-5.0, y=30.0, z=2.48750 Recv: // front right screw : x=155.0, y=30.0, z=2.36000 : adjust CW 01:15 Recv: // rear right screw : y=155.0, y=190.0, z=2.71500 : adjust CCW 00:50 Recv: // read left screw : x=-5.0, y=190.0, z=2.47250 : adjust CW 00:02 Recv: ok Cela signifie que : la vis avant gauche est le point de r\u00e9f\u00e9rence vous ne devez pas la changer. la vis avant droite doit \u00eatre tourn\u00e9e dans le sens des aiguilles d'une montre d'un tour complet et d'un quart de tour La vis arri\u00e8re droite doit \u00eatre tourn\u00e9e dans le sens inverse des aiguilles d\u2019une montre d'environ 50 minutes la vis arri\u00e8re gauche doit \u00eatre tourn\u00e9e dans le sens des aiguilles d'une montre d'un angle de 2 minutes (pas besoin c'est ok) Notez que \"minutes\" fait r\u00e9f\u00e9rence aux \"minutes d'un cadran d'horloge\". Ainsi, par exemple, 15 minutes correspondent \u00e0 un quart de tour complet. R\u00e9p\u00e9tez le processus plusieurs fois jusqu'\u00e0 ce que vous obteniez un bon niveau de lit - normalement lorsque tous les ajustements sont inf\u00e9rieurs \u00e0 une rotation de 6 minutes des vis de r\u00e9glage. Si vous utilisez une sonde mont\u00e9e sur le c\u00f4t\u00e9 de la hotend (c'est-\u00e0-dire qu'elle a un d\u00e9calage X ou Y), notez que le r\u00e9glage de l'inclinaison du lit rendra caduc l'\u00e9talonnage de sonde pr\u00e9c\u00e9demment effectu\u00e9 avec un lit inclin\u00e9. Assurez-vous d'ex\u00e9cuter \u00e9talonnage de la sonde apr\u00e8s avoir ajust\u00e9 les vis du lit. Le param\u00e8tre MAX_DEVIATION est utile lorsqu'un maillage de lit sauvegard\u00e9 est utilis\u00e9, pour s'assurer que le niveau du lit n'a pas trop d\u00e9riv\u00e9 de l'endroit o\u00f9 il se trouvait lorsque le maillage a \u00e9t\u00e9 cr\u00e9\u00e9. Par exemple, SCREWS_TILT_CALCULATE MAX_DEVIATION=0.01 peut \u00eatre ajout\u00e9 au gcode de d\u00e9marrage personnalis\u00e9 du trancheur avant le chargement du maillage. Il interrompra l'impression si la limite configur\u00e9e est d\u00e9pass\u00e9e (0,01 mm dans cet exemple), donnant \u00e0 l'utilisateur une chance d'ajuster les vis et de red\u00e9marrer l'impression. Le param\u00e8tre DIRECTION est utile si vous ne pouvez tourner les vis de r\u00e9glage de votre lit que dans un seul sens. Par exemple, vous pourriez avoir des vis qui commencent \u00e0 \u00eatre serr\u00e9es dans leur position la plus basse (ou la plus haute) possible, qui ne peuvent \u00eatre tourn\u00e9es que dans une seule direction, pour \u00e9lever (ou abaisser) le lit. Si vous ne pouvez tourner les vis que dans le sens des aiguilles d'une montre, ex\u00e9cutez SCREWS_TILT_CALCULATE DIRECTION=CW . Si vous ne pouvez les tourner que dans le sens antihoraire, ex\u00e9cutez SCREWS_TILT_CALCULATE DIRECTION=CCW . Un point de r\u00e9f\u00e9rence appropri\u00e9 sera choisi de sorte que le lit puisse \u00eatre nivel\u00e9 en tournant toutes les vis dans la direction donn\u00e9e.","title":"R\u00e9glage des vis de mise \u00e0 niveau du lit \u00e0 l'aide de la sonde de lit"},{"location":"Measuring_Resonances.html","text":"Mesurer la r\u00e9sonance \u00b6 Klipper prend en charge l\u2019acc\u00e9l\u00e9rom\u00e8tre ADXL345, utilis\u00e9 pour mesurer les fr\u00e9quences de r\u00e9sonance de l\u2019imprimante sur diff\u00e9rents axes ainsi que le r\u00e9glage automatique des formateurs d'entr\u00e9e ( aka input shapers) pour limiter les r\u00e9sonances. Notez que l\u2019utilisation de l\u2019ADXL345 n\u00e9cessite un peu de soudure et de sertissage. L\u2019ADXL345 peut \u00eatre connect\u00e9 directement \u00e0 un Raspberry Pi, ou \u00e0 une interface SPI d\u2019une carte MCU (qui devra \u00eatre rapide). Lors de l\u2019approvisionnement en ADXL345, sachez qu\u2019il existe une vari\u00e9t\u00e9 de conceptions de cartes PCB diff\u00e9rentes et diff\u00e9rents clones. Assurez-vous que la carte prend en charge le mode SPI (un petit nombre de cartes semble \u00eatre configur\u00e9e en dur pour I2C avec SDO raccord\u00e9 au GND) et, si elle doit \u00eatre connect\u00e9e \u00e0 un microcontr\u00f4leur d\u2019imprimante 5V, qu\u2019elle dispose d\u2019un r\u00e9gulateur de tension et d\u2019un d\u00e9calage de niveau. Instructions d\u2019installation \u00b6 C\u00e2blage \u00b6 Un c\u00e2ble Ethernet \u00e0 paires torsad\u00e9es blind\u00e9es (cat5e ou sup\u00e9rieur) est recommand\u00e9 pour la qualit\u00e9 du signal sur une longue distance. Si vous rencontrez toujours des probl\u00e8mes de qualit\u00e9 du signal (erreurs SPI/I2C), raccourcissez le c\u00e2ble. Connectez le blindage du c\u00e2ble Ethernet \u00e0 la terre de la carte contr\u00f4leur/RPI. V\u00e9rifiez votre c\u00e2blage avant de mettre sous tension pour \u00e9viter d'endommager votre MCU/Raspberry Pi ou l'acc\u00e9l\u00e9rom\u00e8tre ou les deux. Acc\u00e9l\u00e9rom\u00e8tres SPI \u00b6 Suggestions d'utilisation des paires torsad\u00e9es : GND+MISO 3.3V+MOSI SCLK+CS ADXL345 \u00b6 Remarque : de nombreux microcontr\u00f4leurs fonctionnent avec un ADXL345 en mode SPI (par exemple, Pi Pico), le c\u00e2blage et la configuration varient en fonction de votre carte ADXL et des broches disponibles. sur votre MCU Vous devez connecter votre ADXL345 \u00e0 votre Raspberry Pi via SPI. Notez que la connexion I2C, sugg\u00e9r\u00e9e par la documentation ADXL345, poss\u00e8de un d\u00e9bit trop faible et ne fonctionnera pas . Le sch\u00e9ma de connexion recommand\u00e9 : Brochage de l'ADXL345 Brochage du RPI Nom des broches du RPI 3,3 V (ou VCC) 01 Alimentation 3.3v continu GND 06 Terre CS 24 GPIO08 (SPI0_CE0_N) SDO 21 GPIO09 (SPI0_MISO) SDA 19 GPIO10 (SPI0_MOSI) SCL 23 GPIO11 (SPI0_SCLK) Sch\u00e9mas de c\u00e2blage de Fritzing pour certaines des cartes ADXL345 : Acc\u00e9l\u00e9rom\u00e8tres I2C \u00b6 Suggestions d'utilisation des paires torsad\u00e9es : 3.3V+SDA GND+SCL MPU-9250/MPU-9255/MPU-6515/MPU-6050/MPU-6500 \u00b6 Les alternatives \u00e0 l'ADXL345 sont MPU-9250, MPU-9255, MPU-6515, MPU-6050 ou MPU-6500. Ces acc\u00e9l\u00e9rom\u00e8tres ont \u00e9t\u00e9 test\u00e9s pour fonctionner sur I2C avec un RPi ou un RP2040(pico) \u00e0 400kbaud. Sch\u00e9ma de connexion recommand\u00e9 pour I2C sur le Raspberry Pi : brochage du MPU-9250 Brochage du RPI Nom des broches du RPI VCC 01 Alimentation 3.3v continu GND 09 Terre SDA 03 GPIO02 (SDA1) SCL 05 GPIO03 (SCL1) Sch\u00e9ma de connexion recommand\u00e9 pour I2C(i2c0a) connect\u00e9 au RP2040 : brochage du MPU-9250 Broche du RP2040 Nom des broches du RPI VCC 39 3v3 GND 38 Terre SDA 01 GP0 (I2C0 SDA) SCL 02 GP1 (I2C0 SCL) Montage de l\u2019acc\u00e9l\u00e9rom\u00e8tre \u00b6 L\u2019acc\u00e9l\u00e9rom\u00e8tre doit \u00eatre fix\u00e9 sur la t\u00eate d'impression. Il faut concevoir un support appropri\u00e9 et adapt\u00e9 \u00e0 l'imprimante 3D. Il est pr\u00e9f\u00e9rable d\u2019aligner les axes de l\u2019acc\u00e9l\u00e9rom\u00e8tre avec les axes de l\u2019imprimante (mais ce n'est pas obligatoire - c\u2019est-\u00e0-dire pas besoin d\u2019aligner l\u2019axe X avec X et ainsi de suite - cela devrait \u00eatre correct m\u00eame si l\u2019axe Z de l\u2019acc\u00e9l\u00e9rom\u00e8tre est l\u2019axe X de l\u2019imprimante, etc.). Exemple de montage d\u2019ADXL345 sur le SmartEffector : Notez que sur une imprimante cart\u00e9sienne, il faut concevoir 2 supports : un pour la t\u00eate et un pour le lit, et ex\u00e9cuter les mesures deux fois. Voir la section correspondante pour plus de d\u00e9tails. Attention : assurez-vous que l\u2019acc\u00e9l\u00e9rom\u00e8tre et les vis qui le maintiennent en place ne touchent aucune partie m\u00e9tallique de l\u2019imprimante. Fondamentalement, le support doit \u00eatre con\u00e7u de mani\u00e8re \u00e0 assurer l\u2019isolation \u00e9lectrique de l\u2019acc\u00e9l\u00e9rom\u00e8tre du ch\u00e2ssis de l\u2019imprimante. Ne pas s\u2019assurer de cette isolation peut cr\u00e9er une boucle de masse dans le syst\u00e8me conduisant \u00e0 l'endommagement de l\u2019\u00e9lectronique. Installation logicielle \u00b6 Notez que les mesures de r\u00e9sonance et l\u2019auto-\u00e9talonnage de l'input shaper n\u00e9cessitent des d\u00e9pendances logicielles suppl\u00e9mentaires non install\u00e9es par d\u00e9faut. Tout d\u2019abord, ex\u00e9cutez sur votre Raspberry Pi les commandes suivantes\u202f: sudo apt update sudo apt install python3-numpy python3-matplotlib libatlas-base-dev Ensuite, pour installer NumPy dans l\u2019environnement Klipper, ex\u00e9cutez la commande\u202f: ~/klippy-env/bin/pip install -v numpy Selon les performances du processeur, cette op\u00e9ration peut prendre jusqu\u2019\u00e0 20 minutes. Soyez patient et attendez la fin de l\u2019installation. Dans certains cas, si la carte a trop peu de m\u00e9moire, l\u2019installation peut \u00e9chouer et vous devrez activer le fichier d\u2019\u00e9change. V\u00e9rifiez et suivez les instructions dans le document du Microcontr\u00f4leur RPi pour configurer le \u00ab mcu linux \u00bb sur le Raspberry Pi. Configurer l'ADXL345 avec le RPi \u00b6 Assurez-vous que le pilote SPI Linux est activ\u00e9 en ex\u00e9cutant sudo raspi-config et en activant SPI dans le menu \u00ab Options d\u2019interface \u00bb. Ajoutez les lignes suivantes au fichier printer.cfg : [mcu rpi] serial: /tmp/klipper_host_mcu [adxl345] cs_pin: rpi:None [resonance_tester] accel_chip: adxl345 probe_points: 100, 100, 20 # valeur exemple Il est conseill\u00e9 de commencer par 1 point de test, au milieu du lit d\u2019impression, l\u00e9g\u00e8rement au-dessus. Configurer les s\u00e9ries MPU-6000/9000 avec le RPi \u00b6 Assurez-vous que le pilote Linux I2C est activ\u00e9 et que le d\u00e9bit en bauds est d\u00e9fini sur 400 000 (voir la section Activation d'I2C pour plus de d\u00e9tails). Ensuite, ajoutez ce qui suit au fichier printer.cfg : [mcu rpi] serial: /tmp/klipper_host_mcu [mpu9250] i2c_mcu: rpi i2c_bus: i2c.1 [resonance_tester] accel_chip: mpu9250 probe_points: 100, 100, 20 # valeurs exemple Configurer les s\u00e9ries MPU-6000/9000 avec le PICO \u00b6 Sur le PICO I2C est r\u00e9gl\u00e9 sur 400000 par d\u00e9faut. Ajoutez simplement ce qui suit au fichier printer.cfg : [mcu pico] serial\u202f: /dev/serial/by-id/<le serial id du PICO> [mpu9250] i2c_mcu\u202f: pico i2c_bus\u202f: i2c1a [resonance_tester] accel_chip\u202f: mpu9250 probe_points\u202f: 100, 100, 20 # un exemple [static_digital_output pico_3V3pwm] # Am\u00e9lioration de la stabilit\u00e9 de l'alimentation pin\u202f: pico\u202f:gpio23 Red\u00e9marrez Klipper avec la commande RESTART . Mesurer les r\u00e9sonances \u00b6 V\u00e9rification de la configuration \u00b6 Vous pouvez maintenant tester la connexion. Pour les imprimantes non cart\u00e9siennes (celles avec une seul acc\u00e9l\u00e9rom\u00e8tre), dans Octoprint, entrez ACCELEROMETER_QUERY Pour les imprimante cart\u00e9siennes (plus d\u2019un acc\u00e9l\u00e9rom\u00e8tre), entrez ACCELEROMETER_QUERY CHIP=<chip> o\u00f9 <chip> est le nom de la puce tel qu\u2019il a \u00e9t\u00e9 entr\u00e9, par exemple CHIP=bed (voir\u202f: bed-slinger ) faites-le pour tous les acc\u00e9l\u00e9rom\u00e8tre install\u00e9s. Vous devriez voir les mesures actuelles de l\u2019acc\u00e9l\u00e9rom\u00e8tre, y compris l\u2019acc\u00e9l\u00e9ration en chute libre. Recv: // adxl345 values (x, y, z)\u202f: 470.719200, 941.438400, 9728.196800 Si vous obtenez une erreur comme Invalid adxl345 id (got xx vs e5) , o\u00f9 xx est un autre ID, cela indique un probl\u00e8me de connexion avec l'ADXL345, ou un capteur d\u00e9fectueux. V\u00e9rifiez l\u2019alimentation, le c\u00e2blage (correspondance avec les sch\u00e9mas, aucun fil coup\u00e9 ou desserr\u00e9, etc.) et la qualit\u00e9 des soudures. Si vous utilisez un acc\u00e9l\u00e9rom\u00e8tre de la s\u00e9rie MPU-6000/9000 et qu'il s'affiche comme \"mpu-unknown\", utilisez-le avec prudence ! Ce sont probablement des puces reconditionn\u00e9es ! Ensuite, essayez d\u2019ex\u00e9cuter MEASURE_AXES_NOISE dans Octoprint, vous devriez obtenir des chiffres de base pour le bruit de fond de l\u2019acc\u00e9l\u00e9rom\u00e8tre sur les axes (devraient se situer entre 1 et 100). Un bruit de fond d\u2019axe trop \u00e9lev\u00e9 (par exemple 1000 et plus) peut indiquer des probl\u00e8mes de capteur, des probl\u00e8mes de puissance ou des ventilateurs d\u00e9s\u00e9quilibr\u00e9s entrainant trop de vibrations sur l'imprimante 3D. Mesurer les r\u00e9sonances \u00b6 Vous pouvez maintenant ex\u00e9cuter les tests r\u00e9els. Ex\u00e9cutez la commande suivante : TEST_RESONANCES AXIS=X Notez que cela cr\u00e9era des vibrations sur l\u2019axe X. Ce test d\u00e9sactivera les valeurs du formateur d'entr\u00e9e (aka input shapper) d\u00e9j\u00e0 param\u00e9tr\u00e9es. Le test de r\u00e9sonance ne peut pas \u00eatre fait avec le formateur d'entr\u00e9e d\u00e9j\u00e0 activ\u00e9. Attention\u202f! Gardez un \u0153il sur l\u2019imprimante la premi\u00e8re fois, pour vous assurer que les vibrations ne deviennent pas trop violentes (la commande M112 peut \u00eatre utilis\u00e9e pour interrompre le test en cas d\u2019urgence - en esp\u00e9rant ne pas avoir \u00e0 l'utiliser). Si les vibrations deviennent trop fortes, vous pouvez sp\u00e9cifier une valeur inf\u00e9rieure \u00e0 la valeur par d\u00e9faut du param\u00e8tre accel_per_hz dans la section [resonance_tester] . [resonance_tester] accel_chip: adxl345 accel_per_hz: 50 # default is 75 probe_points: ... Si cela fonctionne pour l\u2019axe X, ex\u00e9cutez ensuite la commande pour l\u2019axe Y : TEST_RESONANCES AXIS=Y Cela g\u00e9n\u00e9rera 2 fichiers CSV ( /tmp/resonances_x_*.csv et /tmp/resonances_y_*.csv ). Ces fichiers peuvent \u00eatre trait\u00e9s avec le script autonome sur un Raspberry Pi. Pour ce faire, ex\u00e9cutez les commandes suivantes : ~/klipper/scripts/calibrate_shaper.py /tmp/resonances_x_*.csv -o /tmp/shaper_calibrate_x.png ~/klipper/scripts/calibrate_shaper.py /tmp/resonances_y_*.csv -o /tmp/shaper_calibrate_y.png Ce script g\u00e9n\u00e9rera les graphiques /tmp/shaper_calibrate_x.png et /tmp/shaper_calibrate_y.png avec les r\u00e9ponses en fr\u00e9quence. Vous obtiendrez \u00e9galement les fr\u00e9quences sugg\u00e9r\u00e9es pour chaque mode du formateur d'entr\u00e9e (input shapper), ainsi que la valeur recommand\u00e9e pour votre configuration. Par exemple : Fitted shaper 'zv' frequency = 34.4 Hz (vibrations = 4.0%, smoothing ~= 0.132) To avoid too much smoothing with 'zv', suggested max_accel <= 4500 mm/sec^2 Fitted shaper 'mzv' frequency = 34.6 Hz (vibrations = 0.0%, smoothing ~= 0.170) To avoid too much smoothing with 'mzv', suggested max_accel <= 3500 mm/sec^2 Fitted shaper 'ei' frequency = 41.4 Hz (vibrations = 0.0%, smoothing ~= 0.188) To avoid too much smoothing with 'ei', suggested max_accel <= 3200 mm/sec^2 Fitted shaper '2hump_ei' frequency = 51.8 Hz (vibrations = 0.0%, smoothing ~= 0.201) To avoid too much smoothing with '2hump_ei', suggested max_accel <= 3000 mm/sec^2 Fitted shaper '3hump_ei' frequency = 61.8 Hz (vibrations = 0.0%, smoothing ~= 0.215) To avoid too much smoothing with '3hump_ei', suggested max_accel <= 2800 mm/sec^2 Recommended shaper is mzv @ 34.6 Hz La configuration sugg\u00e9r\u00e9e peut \u00eatre ajout\u00e9e \u00e0 la section [input_shaper] de printer.cfg , par exemple : [input_shaper] shaper_freq_x: ... shaper_type_x: ... shaper_freq_y: 34.6 shaper_type_y: mzv [printer] max_accel: 3000 # Ne devrait pas d\u00e9passer les valeurs estim\u00e9es d'acc\u00e9l\u00e9ration calcul\u00e9es pour les axes X et Y Ou vous pouvez choisir vous-m\u00eame une autre configuration en fonction des graphiques g\u00e9n\u00e9r\u00e9s\u202f: les pics de densit\u00e9 spectrale de puissance sur les graphiques correspondent aux fr\u00e9quences de r\u00e9sonance de l\u2019imprimante. Notez que vous pouvez \u00e9galement ex\u00e9cuter l\u2019auto-\u00e9talonnage du formateur d'entr\u00e9e (input shapper) \u00e0 partir de Klipper directement , pratique, par exemple, pour la recalibration du formateur d'entr\u00e9e. Imprimantes cart\u00e9siennes \u00e0 lit mobile \u00b6 Si votre imprimante est une imprimante cart\u00e9sienne dont le plateau est mobile sur l'axe Y, vous devrez changer l\u2019emplacement de l\u2019acc\u00e9l\u00e9rom\u00e8tre entre les mesures des axes X et Y : mesurez les r\u00e9sonances de l\u2019axe X avec l\u2019acc\u00e9l\u00e9rom\u00e8tre fix\u00e9 \u00e0 la t\u00eate et les r\u00e9sonances de l\u2019axe Y - au lit (la configuration habituelle des imprimantes cart\u00e9siennes). Cependant, vous pouvez \u00e9galement connecter les deux acc\u00e9l\u00e9rom\u00e8tres simultan\u00e9ment, bien qu'ils doivent \u00eatre connect\u00e9s \u00e0 des cartes diff\u00e9rentes (par exemple, \u00e0 une carte RPi et au MCU de l'imprimante), ou \u00e0 deux interfaces SPI physiques diff\u00e9rentes sur la m\u00eame carte (rarement disponibles). Ensuite, ils peuvent \u00eatre configur\u00e9s de la mani\u00e8re suivante : [adxl345 hotend] # En consid\u00e9rant que l'adxl de la t\u00eate connect\u00e9e au RPI cs_pin: rpi:None [adxl345 bed] # En consid\u00e9rant que l'adxl du lit est connect\u00e9 au MCU cs_pin: ... # Printer board SPI chip select (CS) pin [resonance_tester] # En consid\u00e9rant un montage standard pour une imprimante cart\u00e9sienne accel_chip_x: adxl345 hotend accel_chip_y: adxl345 bed probe_points: ... Ensuite, les commandes TEST_RESONANCES AXIS=X et TEST_RESONANCES AXIS=Y utiliseront le bon acc\u00e9l\u00e9rom\u00e8tre pour chaque axe. Lissage maximum \u00b6 Gardez \u00e0 l'esprit que le formateur d'entr\u00e9e (input shapper) peut cr\u00e9er un lissage sur certaines parties de l'impression. Le r\u00e9glage automatique du formateur d'entr\u00e9e effectu\u00e9 par le script calibrate_shaper.py ou la commande SHAPER_CALIBRATE essaie de limiter le lissage, mais il essaie aussi de minimiser les vibrations r\u00e9sultantes. Cela peut conduire parfois, \u00e0 un choix peu optimis\u00e9 de la fr\u00e9quence du formateur d'entr\u00e9e ou peut-\u00eatre pr\u00e9f\u00e9rez-vous simplement avoir moins de lissage dans certaines parties de l'impression au d\u00e9triment des vibrations restantes. Dans ces cas, vous pouvez demander de limiter le lissage maximal \u00e0 partir du formateur d'entr\u00e9e. Regardons les r\u00e9sultats suivants du r\u00e9glage automatique : Fitted shaper 'zv' frequency = 57.8 Hz (vibrations = 20.3%, smoothing ~= 0.053) To avoid too much smoothing with 'zv', suggested max_accel <= 13000 mm/sec^2 Fitted shaper 'mzv' frequency = 34.8 Hz (vibrations = 3.6%, smoothing ~= 0.168) To avoid too much smoothing with 'mzv', suggested max_accel <= 3600 mm/sec^2 Fitted shaper 'ei' frequency = 48.8 Hz (vibrations = 4.9%, smoothing ~= 0.135) To avoid too much smoothing with 'ei', suggested max_accel <= 4400 mm/sec^2 Fitted shaper '2hump_ei' frequency = 45.2 Hz (vibrations = 0.1%, smoothing ~= 0.264) To avoid too much smoothing with '2hump_ei', suggested max_accel <= 2200 mm/sec^2 Fitted shaper '3hump_ei' frequency = 48.0 Hz (vibrations = 0.0%, smoothing ~= 0.356) To avoid too much smoothing with '3hump_ei', suggested max_accel <= 1500 mm/sec^2 Recommended shaper is 2hump_ei @ 45.2 Hz Notez que les valeurs rapport\u00e9es smoothing sont des valeurs projet\u00e9es abstraites. Ces valeurs peuvent \u00eatre utilis\u00e9es pour comparer diff\u00e9rentes configurations : plus la valeur est \u00e9lev\u00e9e, plus le formateur d'entr\u00e9e cr\u00e9era de lissage. Cependant, ces scores de lissage ne repr\u00e9sentent aucune mesure r\u00e9elle du lissage, car le lissage r\u00e9el d\u00e9pend des param\u00e8tres max_accel et square_corner_velocity . Par cons\u00e9quent, vous devrez faire des impressions de test pour voir exactement le lissage cr\u00e9\u00e9 par la configuration choisie. Dans l'exemple ci-dessus, les param\u00e8tres de mise en forme sugg\u00e9r\u00e9s ne sont pas mauvais, mais que se passe-t-il si vous souhaitez obtenir moins de lissage sur l'axe X ? Vous pouvez essayer de limiter le lissage maximal du formateur d'entr\u00e9e \u00e0 l'aide de la commande suivante : ~/klipper/scripts/calibrate_shaper.py /tmp/resonances_x_*.csv -o /tmp/shaper_calibrate_x.png --max_smoothing=0.2 ce qui limite le lissage \u00e0 un score de 0,2. Vous pouvez maintenant obtenir le r\u00e9sultat suivant : Fitted shaper 'zv' frequency = 55.4 Hz (vibrations = 19.7%, smoothing ~= 0.057) To avoid too much smoothing with 'zv', suggested max_accel <= 12000 mm/sec^2 Fitted shaper 'mzv' frequency = 34.6 Hz (vibrations = 3.6%, smoothing ~= 0.170) To avoid too much smoothing with 'mzv', suggested max_accel <= 3500 mm/sec^2 Fitted shaper 'ei' frequency = 48.2 Hz (vibrations = 4.8%, smoothing ~= 0.139) To avoid too much smoothing with 'ei', suggested max_accel <= 4300 mm/sec^2 Fitted shaper '2hump_ei' frequency = 52.0 Hz (vibrations = 2.7%, smoothing ~= 0.200) To avoid too much smoothing with '2hump_ei', suggested max_accel <= 3000 mm/sec^2 Fitted shaper '3hump_ei' frequency = 72.6 Hz (vibrations = 1.4%, smoothing ~= 0.155) To avoid too much smoothing with '3hump_ei', suggested max_accel <= 3900 mm/sec^2 Recommended shaper is 3hump_ei @ 72.6 Hz Si vous comparez avec les pr\u00e9c\u00e9dents param\u00e8tres sugg\u00e9r\u00e9s, les vibrations sont un peu plus importantes, mais le lissage est nettement plus faible qu'auparavant, ce qui permet une acc\u00e9l\u00e9ration maximale plus importante. Lorsque vous choisissez le param\u00e8tre max_smoothing , vous pouvez utiliser une approche par essais et erreurs. Essayez quelques valeurs diff\u00e9rentes et voyez quels r\u00e9sultats vous obtenez. Notez que le lissage r\u00e9el produit par le formateur d'entr\u00e9e d\u00e9pend principalement de la fr\u00e9quence de r\u00e9sonance la plus basse de l'imprimante : plus la fr\u00e9quence de r\u00e9sonance la plus basse est \u00e9lev\u00e9e, plus le lissage est faible. Par cons\u00e9quent, si vous demandez au script de trouver une configuration du formateur d'entr\u00e9e avec un lissage irr\u00e9aliste, cela se fera au d\u00e9triment d'une r\u00e9sonance accrue aux fr\u00e9quences les plus basses (g\u00e9n\u00e9ralement, les plus visibles dans les impressions). V\u00e9rifiez donc toujours les vibrations restantes projet\u00e9es signal\u00e9es par le script et assurez-vous qu'elles ne sont pas trop \u00e9lev\u00e9es. Notez que si vous avez trouv\u00e9 une bonne valeur de max_smoothing pour vos deux axes, vous pouvez la stocker dans printer.cfg comme [resonance_tester] accel_chip: ... probe_points: ... max_smoothing: 0.25 # valeur exemple Ensuite, si vous r\u00e9ex\u00e9cutez le r\u00e9glage automatique du formateur d'entr\u00e9e \u00e0 l'aide de la commande SHAPER_CALIBRATE , c'est cette valeur stock\u00e9e max_smoothing qui sera prise comme r\u00e9f\u00e9rence. S\u00e9lection de max_accel \u00b6 \u00c9tant donn\u00e9 que le formateur d'entr\u00e9e peut cr\u00e9er un certain lissage dans les pi\u00e8ces, en particulier avec des acc\u00e9l\u00e9rations \u00e9lev\u00e9es, vous devrez toujours choisir une valeur max_accel ne cr\u00e9ant pas trop de lissage dans les pi\u00e8ces imprim\u00e9es. Un script d'\u00e9talonnage fournit une estimation du param\u00e8tre max_accel qui ne devrait pas cr\u00e9er trop de lissage. Notez que le max_accel tel qu'affich\u00e9 par le script de calibrage n'est qu'un maximum th\u00e9orique auquel le formateur d'entr\u00e9e est encore capable de travailler sans produire trop de lissage. Il ne s'agit en aucun cas d'une recommandation pour d\u00e9finir cette acc\u00e9l\u00e9ration sur vos impressions. L'acc\u00e9l\u00e9ration maximale support\u00e9e par votre imprimante d\u00e9pend de ses propri\u00e9t\u00e9s m\u00e9caniques et du couple maximal des moteurs pas \u00e0 pas utilis\u00e9s. Par cons\u00e9quent, il est sugg\u00e9r\u00e9 de d\u00e9finir un max_accel dans la section [printer] qui ne d\u00e9passe pas les valeurs estim\u00e9es pour les axes X et Y, probablement avec une marge de s\u00e9curit\u00e9. Vous pouvez \u00e9galement suivre cette partie du guide de r\u00e9glage du formateur d'entr\u00e9e et imprimer un mod\u00e8le de test pour choisir le param\u00e8tre max_accel de mani\u00e8re exp\u00e9rimentale. M\u00eame remarque pour l' auto-calibration du formateur d'entr\u00e9e avec la commande SHAPER_CALIBRATE : il faut encore choisir la bonne valeur max_accel apr\u00e8s l'auto-calibrage, notez que les limites d'acc\u00e9l\u00e9rations sugg\u00e9r\u00e9es ne sont pas appliqu\u00e9es automatiquement. Si vous effectuez un r\u00e9-\u00e9talonnage du formateur d'entr\u00e9e et que le lissage indiqu\u00e9 pour la configuration de formateur sugg\u00e9r\u00e9e est pratiquement le m\u00eame que celui obtenu lors du calibrage pr\u00e9c\u00e9dent, cette \u00e9tape peut \u00eatre ignor\u00e9e. Test des axes personnalis\u00e9s \u00b6 la commande TEST_RESONANCES prend en charge les axes personnalis\u00e9s. Bien que cela ne soit pas vraiment utile pour l\u2019\u00e9talonnage des input shaper, cela peut \u00eatre utilis\u00e9 pour \u00e9tudier en profondeur les r\u00e9sonances de l\u2019imprimante et v\u00e9rifier, par exemple, la tension de la courroie. Pour v\u00e9rifier la tension de la courroie sur les imprimantes CoreXY, ex\u00e9cutez TEST_RESONANCES AXIS=1,1 OUTPUT=raw_data TEST_RESONANCES AXIS=1,-1 OUTPUT=raw_data et utilisez graph_accelerometer.py pour traiter les fichiers g\u00e9n\u00e9r\u00e9s. ~/klipper/scripts/graph_accelerometer.py -c /tmp/raw_data_axis*.csv -o /tmp/resonances.png qui g\u00e9n\u00e9rera /tmp/r\u00e9sonances.png en comparant les r\u00e9sonances. Pour les imprimantes Delta avec le placement des tours par d\u00e9faut (tour A ~= 210 degr\u00e9s, B ~= 330 degr\u00e9s et C ~= 90 degr\u00e9s), ex\u00e9cutez TEST_RESONANCES AXIS=0,1 OUTPUT=raw_data TEST_RESONANCES AXIS=-0.866025404,-0.5 OUTPUT=raw_data TEST_RESONANCES AXIS=0.866025404,-0.5 OUTPUT=raw_data puis utilisez la m\u00eame commande ~/klipper/scripts/graph_accelerometer.py -c /tmp/raw_data_axis*.csv -o /tmp/resonances.png pour g\u00e9n\u00e9rer le fichier de comparaison des r\u00e9sonnances /tmp/r\u00e9sonances.png . Calibrage automatique du formateur d'entr\u00e9e \u00b6 En plus de choisir manuellement les param\u00e8tres appropri\u00e9s pour la fonction de formateur d'entr\u00e9e, il est \u00e9galement possible d'ex\u00e9cuter le r\u00e9glage automatique du formateur d'entr\u00e9e directement \u00e0 partir de Klipper. Ex\u00e9cutez la commande suivante via le terminal Octoprint : SHAPER_CALIBRATE Cela ex\u00e9cutera le test complet pour les deux axes et g\u00e9n\u00e9rera la sortie csv ( /tmp/calibration_data_*.csv par d\u00e9faut) pour la r\u00e9ponse en fr\u00e9quence et les formateurs d'entr\u00e9e sugg\u00e9r\u00e9s. Vous obtiendrez \u00e9galement les fr\u00e9quences sugg\u00e9r\u00e9es pour chaque formateur, ainsi que le mod\u00e8le de formateur d'entr\u00e9e recommand\u00e9 pour votre configuration, sur la console Octoprint. Par exemple\u202f: Calculating the best input shaper parameters for y axis Fitted shaper 'zv' frequency = 39.0 Hz (vibrations = 13.2%, smoothing ~= 0.105) To avoid too much smoothing with 'zv', suggested max_accel <= 5900 mm/sec^2 Fitted shaper 'mzv' frequency = 36.8 Hz (vibrations = 1.7%, smoothing ~= 0.150) To avoid too much smoothing with 'mzv', suggested max_accel <= 4000 mm/sec^2 Fitted shaper 'ei' frequency = 36.6 Hz (vibrations = 2.2%, smoothing ~= 0.240) To avoid too much smoothing with 'ei', suggested max_accel <= 2500 mm/sec^2 Fitted shaper '2hump_ei' frequency = 48.0 Hz (vibrations = 0.0%, smoothing ~= 0.234) To avoid too much smoothing with '2hump_ei', suggested max_accel <= 2500 mm/sec^2 Fitted shaper '3hump_ei' frequency = 59.0 Hz (vibrations = 0.0%, smoothing ~= 0.235) To avoid too much smoothing with '3hump_ei', suggested max_accel <= 2500 mm/sec^2 Recommended shaper_type_y = mzv, shaper_freq_y = 36.8 Hz Si vous \u00eates d'accord avec les param\u00e8tres sugg\u00e9r\u00e9s, vous pouvez ex\u00e9cuter SAVE_CONFIG maintenant pour les enregistrer et red\u00e9marrer Klipper. Notez que cela ne mettra pas \u00e0 jour la valeur max_accel dans la section [printer] . Vous devrez la mettre \u00e0 jour manuellement en suivant les recommandations de la section Choisir l'acc\u00e9l\u00e9ration maximale . Si votre imprimante est une imprimante cart\u00e9sienne, vous pouvez pr\u00e9ciser l'axe \u00e0 tester, afin de pouvoir modifier le point de montage de l'acc\u00e9l\u00e9rom\u00e8tre entre les tests (par d\u00e9faut, le test est effectu\u00e9 pour les deux axes) : SHAPER_CALIBRATE AXIS=Y Vous pouvez ex\u00e9cuter SAVE_CONFIG deux fois - apr\u00e8s avoir calibr\u00e9 chaque axe. Cependant, si vous avez connect\u00e9 deux acc\u00e9l\u00e9rom\u00e8tres simultan\u00e9ment, vous pouvez ex\u00e9cutez simplement SHAPER_CALIBRATE sans sp\u00e9cifier d'axe pour calibrer les formateurs d'entr\u00e9e des deux axes en une seule fois. R\u00e9-\u00e9talonnage du formateur d'entr\u00e9e (aka input shapper) \u00b6 La commande SHAPER_CALIBRATE peut \u00e9galement \u00eatre utilis\u00e9e pour recalibrer le formateur d'entr\u00e9e ult\u00e9rieurement, en particulier si des modifications de l'imprimante pouvant affecter sa cin\u00e9matique sont apport\u00e9es. On peut soit relancer l'\u00e9talonnage complet \u00e0 l'aide de la commande SHAPER_CALIBRATE , soit restreindre l'auto-\u00e9talonnage \u00e0 un seul axe en fournissant le param\u00e8tre AXIS= , comme SHAPER_CALIBRATE AXIS=X Attention ! Il est d\u00e9conseill\u00e9 d'ex\u00e9cuter l'autocalibrage de l'input shaper tr\u00e8s fr\u00e9quemment (par exemple, avant chaque impression ou tous les jours). Afin de d\u00e9terminer les fr\u00e9quences de r\u00e9sonance, l'autocalibrage cr\u00e9e des vibrations intenses sur chacun des axes. Les imprimantes 3D ne sont pas con\u00e7ues pour r\u00e9sister \u00e0 une exposition prolong\u00e9e \u00e0 des vibrations proches des fr\u00e9quences de r\u00e9sonance. Cela pourrait augmenter l'usure des composants de l'imprimante et r\u00e9duire leur dur\u00e9e de vie. Il existe \u00e9galement un risque accru que certaines pi\u00e8ces se d\u00e9vissent ou se desserrent. V\u00e9rifiez toujours que toutes les pi\u00e8ces de l'imprimante (y compris celles qui ne peuvent normalement pas bouger) sont solidement fix\u00e9es en place apr\u00e8s chaque r\u00e9glage automatique. De plus, en raison d'un certain bruit dans les mesures, il est possible que les r\u00e9sultats de r\u00e9glage soient l\u00e9g\u00e8rement diff\u00e9rents d'un calibrage \u00e0 l'autre. Ce bruit ne devrait pas trop affecter la qualit\u00e9 d'impression. Cependant, il est conseill\u00e9 de rev\u00e9rifier les param\u00e8tres sugg\u00e9r\u00e9s et d'imprimer des tests d'impression avant de les utiliser pour confirmer qu'ils sont corrects. Traitement hors ligne des donn\u00e9es de l\u2019acc\u00e9l\u00e9rom\u00e8tre \u00b6 Il est possible de g\u00e9n\u00e9rer les donn\u00e9es brutes de l\u2019acc\u00e9l\u00e9rom\u00e8tre et de les traiter hors ligne (par exemple sur une machine h\u00f4te), par exemple pour trouver des r\u00e9sonances. Pour ce faire, ex\u00e9cutez les commandes suivantes via le terminal Octoprint : SET_INPUT_SHAPER SHAPER_FREQ_X=0 SHAPER_FREQ_Y=0 TEST_RESONANCES AXIS=X OUTPUT=raw_data ignorez toute erreur pour la commande SET_INPUT_SHAPER . Pour la commande TEST_RESONANCES , sp\u00e9cifiez l\u2019axe de test souhait\u00e9. Les donn\u00e9es brutes seront \u00e9crites dans le r\u00e9pertoire /tmp sur le RPi. Les donn\u00e9es brutes peuvent \u00e9galement \u00eatre obtenues en ex\u00e9cutant la commande ACCELEROMETER_MEASURE deux fois - d\u2019abord pour d\u00e9marrer les mesures, puis pour les arr\u00eater et \u00e9crire le fichier de sortie. Reportez-vous \u00e0 G-Codes pour plus de d\u00e9tails. Les donn\u00e9es peuvent \u00eatre trait\u00e9es ult\u00e9rieurement avec les scripts suivants : scripts/graph_accelerometer.py et scripts/calibrate_shaper.py . Les deux acceptent un ou plusieurs fichiers csv bruts comme entr\u00e9e en fonction du mode. Le script graph_accelerometer.py prend en charge plusieurs modes de fonctionnement : pour le tra\u00e7age des donn\u00e9es brutes de l\u2019acc\u00e9l\u00e9rom\u00e8tre (utilisez le param\u00e8tre -r ), seule 1 entr\u00e9e est prise en charge\u202f; tracer une r\u00e9ponse en fr\u00e9quence (aucun param\u00e8tre suppl\u00e9mentaire n'est requis), si plusieurs entr\u00e9es sont sp\u00e9cifi\u00e9es, la r\u00e9ponse en fr\u00e9quence moyenne est calcul\u00e9e ; comparaison de la r\u00e9ponse en fr\u00e9quence entre plusieurs entr\u00e9es (utiliser le param\u00e8tre -c ) ; vous pouvez \u00e9galement sp\u00e9cifier l\u2019axe de l\u2019acc\u00e9l\u00e9rom\u00e8tre \u00e0 prendre en compte via le param\u00e8tre -a x , -a y ou -a z (si aucun n\u2019est sp\u00e9cifi\u00e9, la somme des vibrations pour tous les axes est utilis\u00e9e) ; tra\u00e7age du spectrogramme (utiliser le param\u00e8tre -s ), seule 1 entr\u00e9e est prise en charge\u202f; vous pouvez \u00e9galement sp\u00e9cifier l\u2019axe de l\u2019acc\u00e9l\u00e9rom\u00e8tre \u00e0 prendre en compte via le param\u00e8tre -a x , -a y ou -a z (si aucun n\u2019est sp\u00e9cifi\u00e9, la somme des vibrations pour tous les axes est utilis\u00e9e). Notez que graph_accelerometer.py script ne prend en charge que les fichiers raw_data*.csv et non les fichiers resonances*.csv ou calibration_data*.csv. Par exemple, ~/klipper/scripts/graph_accelerometer.py /tmp/raw_data_x_*.csv -o /tmp/resonances_x.png -c -a z tracera la comparaison de plusieurs fichiers /tmp/raw_data_x_*.csv pour l\u2019axe Z dans le fichier /tmp/resonances_x.png . Le script shaper_calibrate.py accepte 1 ou plusieurs entr\u00e9es et peut ex\u00e9cuter le r\u00e9glage automatique de l'input shaper et sugg\u00e9rer les meilleurs param\u00e8tres pour les entr\u00e9es fournies. Il affiche les param\u00e8tres sugg\u00e9r\u00e9s sur la console et peut en outre g\u00e9n\u00e9rer un graphique si le param\u00e8tre -o output.png est fourni, ou un fichier CSV si le param\u00e8tre -c output.csv est sp\u00e9cifi\u00e9. Fournir plusieurs entr\u00e9es \u00e0 shaper_calibrate.py script peut \u00eatre utile si vous ex\u00e9cutez un r\u00e9glage avanc\u00e9 de l'input shaper, par exemple : Ex\u00e9cutez TEST_RESONANCES AXIS=X OUTPUT=raw_data (et Y axe) pour un seul axe deux fois sur une imprimante cart\u00e9sienne avec l\u2019acc\u00e9l\u00e9rom\u00e8tre fix\u00e9 \u00e0 la t\u00eate d\u2019outil la premi\u00e8re fois, et l\u2019acc\u00e9l\u00e9rom\u00e8tre fix\u00e9 au lit la deuxi\u00e8me fois afin de d\u00e9tecter les r\u00e9sonances crois\u00e9es des axes et de tenter de les annuler avec l'input shaper. Ex\u00e9cutez TEST_RESONANCES AXIS=Y OUTPUT=raw_data deux fois sur le lit avec un lit en verre et une surface magn\u00e9tique (plus l\u00e9g\u00e8re) pour trouver les param\u00e8tres d'input shaper qui fonctionnent bien pour n\u2019importe quelle configuration de surface d\u2019impression. Combinaison des donn\u00e9es de r\u00e9sonance de plusieurs points de test. Combinaison des donn\u00e9es de r\u00e9sonance \u00e0 partir de 2 axes (par exemple, sur une imprimante cart\u00e9sienne pour configurer les input_shaper de l\u2019axe X \u00e0 partir des r\u00e9sonances des axes X et Y pour annuler les vibrations du lit * * au cas o\u00f9 la buse \u00ab attraperait \u00bb une impression lors du d\u00e9placement dans la direction de l\u2019axe X).","title":"Mesurer la r\u00e9sonance"},{"location":"Measuring_Resonances.html#mesurer-la-resonance","text":"Klipper prend en charge l\u2019acc\u00e9l\u00e9rom\u00e8tre ADXL345, utilis\u00e9 pour mesurer les fr\u00e9quences de r\u00e9sonance de l\u2019imprimante sur diff\u00e9rents axes ainsi que le r\u00e9glage automatique des formateurs d'entr\u00e9e ( aka input shapers) pour limiter les r\u00e9sonances. Notez que l\u2019utilisation de l\u2019ADXL345 n\u00e9cessite un peu de soudure et de sertissage. L\u2019ADXL345 peut \u00eatre connect\u00e9 directement \u00e0 un Raspberry Pi, ou \u00e0 une interface SPI d\u2019une carte MCU (qui devra \u00eatre rapide). Lors de l\u2019approvisionnement en ADXL345, sachez qu\u2019il existe une vari\u00e9t\u00e9 de conceptions de cartes PCB diff\u00e9rentes et diff\u00e9rents clones. Assurez-vous que la carte prend en charge le mode SPI (un petit nombre de cartes semble \u00eatre configur\u00e9e en dur pour I2C avec SDO raccord\u00e9 au GND) et, si elle doit \u00eatre connect\u00e9e \u00e0 un microcontr\u00f4leur d\u2019imprimante 5V, qu\u2019elle dispose d\u2019un r\u00e9gulateur de tension et d\u2019un d\u00e9calage de niveau.","title":"Mesurer la r\u00e9sonance"},{"location":"Measuring_Resonances.html#instructions-dinstallation","text":"","title":"Instructions d\u2019installation"},{"location":"Measuring_Resonances.html#cablage","text":"Un c\u00e2ble Ethernet \u00e0 paires torsad\u00e9es blind\u00e9es (cat5e ou sup\u00e9rieur) est recommand\u00e9 pour la qualit\u00e9 du signal sur une longue distance. Si vous rencontrez toujours des probl\u00e8mes de qualit\u00e9 du signal (erreurs SPI/I2C), raccourcissez le c\u00e2ble. Connectez le blindage du c\u00e2ble Ethernet \u00e0 la terre de la carte contr\u00f4leur/RPI. V\u00e9rifiez votre c\u00e2blage avant de mettre sous tension pour \u00e9viter d'endommager votre MCU/Raspberry Pi ou l'acc\u00e9l\u00e9rom\u00e8tre ou les deux.","title":"C\u00e2blage"},{"location":"Measuring_Resonances.html#accelerometres-spi","text":"Suggestions d'utilisation des paires torsad\u00e9es : GND+MISO 3.3V+MOSI SCLK+CS","title":"Acc\u00e9l\u00e9rom\u00e8tres SPI"},{"location":"Measuring_Resonances.html#adxl345","text":"Remarque : de nombreux microcontr\u00f4leurs fonctionnent avec un ADXL345 en mode SPI (par exemple, Pi Pico), le c\u00e2blage et la configuration varient en fonction de votre carte ADXL et des broches disponibles. sur votre MCU Vous devez connecter votre ADXL345 \u00e0 votre Raspberry Pi via SPI. Notez que la connexion I2C, sugg\u00e9r\u00e9e par la documentation ADXL345, poss\u00e8de un d\u00e9bit trop faible et ne fonctionnera pas . Le sch\u00e9ma de connexion recommand\u00e9 : Brochage de l'ADXL345 Brochage du RPI Nom des broches du RPI 3,3 V (ou VCC) 01 Alimentation 3.3v continu GND 06 Terre CS 24 GPIO08 (SPI0_CE0_N) SDO 21 GPIO09 (SPI0_MISO) SDA 19 GPIO10 (SPI0_MOSI) SCL 23 GPIO11 (SPI0_SCLK) Sch\u00e9mas de c\u00e2blage de Fritzing pour certaines des cartes ADXL345 :","title":"ADXL345"},{"location":"Measuring_Resonances.html#accelerometres-i2c","text":"Suggestions d'utilisation des paires torsad\u00e9es : 3.3V+SDA GND+SCL","title":"Acc\u00e9l\u00e9rom\u00e8tres I2C"},{"location":"Measuring_Resonances.html#mpu-9250mpu-9255mpu-6515mpu-6050mpu-6500","text":"Les alternatives \u00e0 l'ADXL345 sont MPU-9250, MPU-9255, MPU-6515, MPU-6050 ou MPU-6500. Ces acc\u00e9l\u00e9rom\u00e8tres ont \u00e9t\u00e9 test\u00e9s pour fonctionner sur I2C avec un RPi ou un RP2040(pico) \u00e0 400kbaud. Sch\u00e9ma de connexion recommand\u00e9 pour I2C sur le Raspberry Pi : brochage du MPU-9250 Brochage du RPI Nom des broches du RPI VCC 01 Alimentation 3.3v continu GND 09 Terre SDA 03 GPIO02 (SDA1) SCL 05 GPIO03 (SCL1) Sch\u00e9ma de connexion recommand\u00e9 pour I2C(i2c0a) connect\u00e9 au RP2040 : brochage du MPU-9250 Broche du RP2040 Nom des broches du RPI VCC 39 3v3 GND 38 Terre SDA 01 GP0 (I2C0 SDA) SCL 02 GP1 (I2C0 SCL)","title":"MPU-9250/MPU-9255/MPU-6515/MPU-6050/MPU-6500"},{"location":"Measuring_Resonances.html#montage-de-laccelerometre","text":"L\u2019acc\u00e9l\u00e9rom\u00e8tre doit \u00eatre fix\u00e9 sur la t\u00eate d'impression. Il faut concevoir un support appropri\u00e9 et adapt\u00e9 \u00e0 l'imprimante 3D. Il est pr\u00e9f\u00e9rable d\u2019aligner les axes de l\u2019acc\u00e9l\u00e9rom\u00e8tre avec les axes de l\u2019imprimante (mais ce n'est pas obligatoire - c\u2019est-\u00e0-dire pas besoin d\u2019aligner l\u2019axe X avec X et ainsi de suite - cela devrait \u00eatre correct m\u00eame si l\u2019axe Z de l\u2019acc\u00e9l\u00e9rom\u00e8tre est l\u2019axe X de l\u2019imprimante, etc.). Exemple de montage d\u2019ADXL345 sur le SmartEffector : Notez que sur une imprimante cart\u00e9sienne, il faut concevoir 2 supports : un pour la t\u00eate et un pour le lit, et ex\u00e9cuter les mesures deux fois. Voir la section correspondante pour plus de d\u00e9tails. Attention : assurez-vous que l\u2019acc\u00e9l\u00e9rom\u00e8tre et les vis qui le maintiennent en place ne touchent aucune partie m\u00e9tallique de l\u2019imprimante. Fondamentalement, le support doit \u00eatre con\u00e7u de mani\u00e8re \u00e0 assurer l\u2019isolation \u00e9lectrique de l\u2019acc\u00e9l\u00e9rom\u00e8tre du ch\u00e2ssis de l\u2019imprimante. Ne pas s\u2019assurer de cette isolation peut cr\u00e9er une boucle de masse dans le syst\u00e8me conduisant \u00e0 l'endommagement de l\u2019\u00e9lectronique.","title":"Montage de l\u2019acc\u00e9l\u00e9rom\u00e8tre"},{"location":"Measuring_Resonances.html#installation-logicielle","text":"Notez que les mesures de r\u00e9sonance et l\u2019auto-\u00e9talonnage de l'input shaper n\u00e9cessitent des d\u00e9pendances logicielles suppl\u00e9mentaires non install\u00e9es par d\u00e9faut. Tout d\u2019abord, ex\u00e9cutez sur votre Raspberry Pi les commandes suivantes\u202f: sudo apt update sudo apt install python3-numpy python3-matplotlib libatlas-base-dev Ensuite, pour installer NumPy dans l\u2019environnement Klipper, ex\u00e9cutez la commande\u202f: ~/klippy-env/bin/pip install -v numpy Selon les performances du processeur, cette op\u00e9ration peut prendre jusqu\u2019\u00e0 20 minutes. Soyez patient et attendez la fin de l\u2019installation. Dans certains cas, si la carte a trop peu de m\u00e9moire, l\u2019installation peut \u00e9chouer et vous devrez activer le fichier d\u2019\u00e9change. V\u00e9rifiez et suivez les instructions dans le document du Microcontr\u00f4leur RPi pour configurer le \u00ab mcu linux \u00bb sur le Raspberry Pi.","title":"Installation logicielle"},{"location":"Measuring_Resonances.html#configurer-ladxl345-avec-le-rpi","text":"Assurez-vous que le pilote SPI Linux est activ\u00e9 en ex\u00e9cutant sudo raspi-config et en activant SPI dans le menu \u00ab Options d\u2019interface \u00bb. Ajoutez les lignes suivantes au fichier printer.cfg : [mcu rpi] serial: /tmp/klipper_host_mcu [adxl345] cs_pin: rpi:None [resonance_tester] accel_chip: adxl345 probe_points: 100, 100, 20 # valeur exemple Il est conseill\u00e9 de commencer par 1 point de test, au milieu du lit d\u2019impression, l\u00e9g\u00e8rement au-dessus.","title":"Configurer l'ADXL345 avec le RPi"},{"location":"Measuring_Resonances.html#configurer-les-series-mpu-60009000-avec-le-rpi","text":"Assurez-vous que le pilote Linux I2C est activ\u00e9 et que le d\u00e9bit en bauds est d\u00e9fini sur 400 000 (voir la section Activation d'I2C pour plus de d\u00e9tails). Ensuite, ajoutez ce qui suit au fichier printer.cfg : [mcu rpi] serial: /tmp/klipper_host_mcu [mpu9250] i2c_mcu: rpi i2c_bus: i2c.1 [resonance_tester] accel_chip: mpu9250 probe_points: 100, 100, 20 # valeurs exemple","title":"Configurer les s\u00e9ries MPU-6000/9000 avec le RPi"},{"location":"Measuring_Resonances.html#configurer-les-series-mpu-60009000-avec-le-pico","text":"Sur le PICO I2C est r\u00e9gl\u00e9 sur 400000 par d\u00e9faut. Ajoutez simplement ce qui suit au fichier printer.cfg : [mcu pico] serial\u202f: /dev/serial/by-id/<le serial id du PICO> [mpu9250] i2c_mcu\u202f: pico i2c_bus\u202f: i2c1a [resonance_tester] accel_chip\u202f: mpu9250 probe_points\u202f: 100, 100, 20 # un exemple [static_digital_output pico_3V3pwm] # Am\u00e9lioration de la stabilit\u00e9 de l'alimentation pin\u202f: pico\u202f:gpio23 Red\u00e9marrez Klipper avec la commande RESTART .","title":"Configurer les s\u00e9ries MPU-6000/9000 avec le PICO"},{"location":"Measuring_Resonances.html#mesurer-les-resonances","text":"","title":"Mesurer les r\u00e9sonances"},{"location":"Measuring_Resonances.html#verification-de-la-configuration","text":"Vous pouvez maintenant tester la connexion. Pour les imprimantes non cart\u00e9siennes (celles avec une seul acc\u00e9l\u00e9rom\u00e8tre), dans Octoprint, entrez ACCELEROMETER_QUERY Pour les imprimante cart\u00e9siennes (plus d\u2019un acc\u00e9l\u00e9rom\u00e8tre), entrez ACCELEROMETER_QUERY CHIP=<chip> o\u00f9 <chip> est le nom de la puce tel qu\u2019il a \u00e9t\u00e9 entr\u00e9, par exemple CHIP=bed (voir\u202f: bed-slinger ) faites-le pour tous les acc\u00e9l\u00e9rom\u00e8tre install\u00e9s. Vous devriez voir les mesures actuelles de l\u2019acc\u00e9l\u00e9rom\u00e8tre, y compris l\u2019acc\u00e9l\u00e9ration en chute libre. Recv: // adxl345 values (x, y, z)\u202f: 470.719200, 941.438400, 9728.196800 Si vous obtenez une erreur comme Invalid adxl345 id (got xx vs e5) , o\u00f9 xx est un autre ID, cela indique un probl\u00e8me de connexion avec l'ADXL345, ou un capteur d\u00e9fectueux. V\u00e9rifiez l\u2019alimentation, le c\u00e2blage (correspondance avec les sch\u00e9mas, aucun fil coup\u00e9 ou desserr\u00e9, etc.) et la qualit\u00e9 des soudures. Si vous utilisez un acc\u00e9l\u00e9rom\u00e8tre de la s\u00e9rie MPU-6000/9000 et qu'il s'affiche comme \"mpu-unknown\", utilisez-le avec prudence ! Ce sont probablement des puces reconditionn\u00e9es ! Ensuite, essayez d\u2019ex\u00e9cuter MEASURE_AXES_NOISE dans Octoprint, vous devriez obtenir des chiffres de base pour le bruit de fond de l\u2019acc\u00e9l\u00e9rom\u00e8tre sur les axes (devraient se situer entre 1 et 100). Un bruit de fond d\u2019axe trop \u00e9lev\u00e9 (par exemple 1000 et plus) peut indiquer des probl\u00e8mes de capteur, des probl\u00e8mes de puissance ou des ventilateurs d\u00e9s\u00e9quilibr\u00e9s entrainant trop de vibrations sur l'imprimante 3D.","title":"V\u00e9rification de la configuration"},{"location":"Measuring_Resonances.html#mesurer-les-resonances_1","text":"Vous pouvez maintenant ex\u00e9cuter les tests r\u00e9els. Ex\u00e9cutez la commande suivante : TEST_RESONANCES AXIS=X Notez que cela cr\u00e9era des vibrations sur l\u2019axe X. Ce test d\u00e9sactivera les valeurs du formateur d'entr\u00e9e (aka input shapper) d\u00e9j\u00e0 param\u00e9tr\u00e9es. Le test de r\u00e9sonance ne peut pas \u00eatre fait avec le formateur d'entr\u00e9e d\u00e9j\u00e0 activ\u00e9. Attention\u202f! Gardez un \u0153il sur l\u2019imprimante la premi\u00e8re fois, pour vous assurer que les vibrations ne deviennent pas trop violentes (la commande M112 peut \u00eatre utilis\u00e9e pour interrompre le test en cas d\u2019urgence - en esp\u00e9rant ne pas avoir \u00e0 l'utiliser). Si les vibrations deviennent trop fortes, vous pouvez sp\u00e9cifier une valeur inf\u00e9rieure \u00e0 la valeur par d\u00e9faut du param\u00e8tre accel_per_hz dans la section [resonance_tester] . [resonance_tester] accel_chip: adxl345 accel_per_hz: 50 # default is 75 probe_points: ... Si cela fonctionne pour l\u2019axe X, ex\u00e9cutez ensuite la commande pour l\u2019axe Y : TEST_RESONANCES AXIS=Y Cela g\u00e9n\u00e9rera 2 fichiers CSV ( /tmp/resonances_x_*.csv et /tmp/resonances_y_*.csv ). Ces fichiers peuvent \u00eatre trait\u00e9s avec le script autonome sur un Raspberry Pi. Pour ce faire, ex\u00e9cutez les commandes suivantes : ~/klipper/scripts/calibrate_shaper.py /tmp/resonances_x_*.csv -o /tmp/shaper_calibrate_x.png ~/klipper/scripts/calibrate_shaper.py /tmp/resonances_y_*.csv -o /tmp/shaper_calibrate_y.png Ce script g\u00e9n\u00e9rera les graphiques /tmp/shaper_calibrate_x.png et /tmp/shaper_calibrate_y.png avec les r\u00e9ponses en fr\u00e9quence. Vous obtiendrez \u00e9galement les fr\u00e9quences sugg\u00e9r\u00e9es pour chaque mode du formateur d'entr\u00e9e (input shapper), ainsi que la valeur recommand\u00e9e pour votre configuration. Par exemple : Fitted shaper 'zv' frequency = 34.4 Hz (vibrations = 4.0%, smoothing ~= 0.132) To avoid too much smoothing with 'zv', suggested max_accel <= 4500 mm/sec^2 Fitted shaper 'mzv' frequency = 34.6 Hz (vibrations = 0.0%, smoothing ~= 0.170) To avoid too much smoothing with 'mzv', suggested max_accel <= 3500 mm/sec^2 Fitted shaper 'ei' frequency = 41.4 Hz (vibrations = 0.0%, smoothing ~= 0.188) To avoid too much smoothing with 'ei', suggested max_accel <= 3200 mm/sec^2 Fitted shaper '2hump_ei' frequency = 51.8 Hz (vibrations = 0.0%, smoothing ~= 0.201) To avoid too much smoothing with '2hump_ei', suggested max_accel <= 3000 mm/sec^2 Fitted shaper '3hump_ei' frequency = 61.8 Hz (vibrations = 0.0%, smoothing ~= 0.215) To avoid too much smoothing with '3hump_ei', suggested max_accel <= 2800 mm/sec^2 Recommended shaper is mzv @ 34.6 Hz La configuration sugg\u00e9r\u00e9e peut \u00eatre ajout\u00e9e \u00e0 la section [input_shaper] de printer.cfg , par exemple : [input_shaper] shaper_freq_x: ... shaper_type_x: ... shaper_freq_y: 34.6 shaper_type_y: mzv [printer] max_accel: 3000 # Ne devrait pas d\u00e9passer les valeurs estim\u00e9es d'acc\u00e9l\u00e9ration calcul\u00e9es pour les axes X et Y Ou vous pouvez choisir vous-m\u00eame une autre configuration en fonction des graphiques g\u00e9n\u00e9r\u00e9s\u202f: les pics de densit\u00e9 spectrale de puissance sur les graphiques correspondent aux fr\u00e9quences de r\u00e9sonance de l\u2019imprimante. Notez que vous pouvez \u00e9galement ex\u00e9cuter l\u2019auto-\u00e9talonnage du formateur d'entr\u00e9e (input shapper) \u00e0 partir de Klipper directement , pratique, par exemple, pour la recalibration du formateur d'entr\u00e9e.","title":"Mesurer les r\u00e9sonances"},{"location":"Measuring_Resonances.html#imprimantes-cartesiennes-a-lit-mobile","text":"Si votre imprimante est une imprimante cart\u00e9sienne dont le plateau est mobile sur l'axe Y, vous devrez changer l\u2019emplacement de l\u2019acc\u00e9l\u00e9rom\u00e8tre entre les mesures des axes X et Y : mesurez les r\u00e9sonances de l\u2019axe X avec l\u2019acc\u00e9l\u00e9rom\u00e8tre fix\u00e9 \u00e0 la t\u00eate et les r\u00e9sonances de l\u2019axe Y - au lit (la configuration habituelle des imprimantes cart\u00e9siennes). Cependant, vous pouvez \u00e9galement connecter les deux acc\u00e9l\u00e9rom\u00e8tres simultan\u00e9ment, bien qu'ils doivent \u00eatre connect\u00e9s \u00e0 des cartes diff\u00e9rentes (par exemple, \u00e0 une carte RPi et au MCU de l'imprimante), ou \u00e0 deux interfaces SPI physiques diff\u00e9rentes sur la m\u00eame carte (rarement disponibles). Ensuite, ils peuvent \u00eatre configur\u00e9s de la mani\u00e8re suivante : [adxl345 hotend] # En consid\u00e9rant que l'adxl de la t\u00eate connect\u00e9e au RPI cs_pin: rpi:None [adxl345 bed] # En consid\u00e9rant que l'adxl du lit est connect\u00e9 au MCU cs_pin: ... # Printer board SPI chip select (CS) pin [resonance_tester] # En consid\u00e9rant un montage standard pour une imprimante cart\u00e9sienne accel_chip_x: adxl345 hotend accel_chip_y: adxl345 bed probe_points: ... Ensuite, les commandes TEST_RESONANCES AXIS=X et TEST_RESONANCES AXIS=Y utiliseront le bon acc\u00e9l\u00e9rom\u00e8tre pour chaque axe.","title":"Imprimantes cart\u00e9siennes \u00e0 lit mobile"},{"location":"Measuring_Resonances.html#lissage-maximum","text":"Gardez \u00e0 l'esprit que le formateur d'entr\u00e9e (input shapper) peut cr\u00e9er un lissage sur certaines parties de l'impression. Le r\u00e9glage automatique du formateur d'entr\u00e9e effectu\u00e9 par le script calibrate_shaper.py ou la commande SHAPER_CALIBRATE essaie de limiter le lissage, mais il essaie aussi de minimiser les vibrations r\u00e9sultantes. Cela peut conduire parfois, \u00e0 un choix peu optimis\u00e9 de la fr\u00e9quence du formateur d'entr\u00e9e ou peut-\u00eatre pr\u00e9f\u00e9rez-vous simplement avoir moins de lissage dans certaines parties de l'impression au d\u00e9triment des vibrations restantes. Dans ces cas, vous pouvez demander de limiter le lissage maximal \u00e0 partir du formateur d'entr\u00e9e. Regardons les r\u00e9sultats suivants du r\u00e9glage automatique : Fitted shaper 'zv' frequency = 57.8 Hz (vibrations = 20.3%, smoothing ~= 0.053) To avoid too much smoothing with 'zv', suggested max_accel <= 13000 mm/sec^2 Fitted shaper 'mzv' frequency = 34.8 Hz (vibrations = 3.6%, smoothing ~= 0.168) To avoid too much smoothing with 'mzv', suggested max_accel <= 3600 mm/sec^2 Fitted shaper 'ei' frequency = 48.8 Hz (vibrations = 4.9%, smoothing ~= 0.135) To avoid too much smoothing with 'ei', suggested max_accel <= 4400 mm/sec^2 Fitted shaper '2hump_ei' frequency = 45.2 Hz (vibrations = 0.1%, smoothing ~= 0.264) To avoid too much smoothing with '2hump_ei', suggested max_accel <= 2200 mm/sec^2 Fitted shaper '3hump_ei' frequency = 48.0 Hz (vibrations = 0.0%, smoothing ~= 0.356) To avoid too much smoothing with '3hump_ei', suggested max_accel <= 1500 mm/sec^2 Recommended shaper is 2hump_ei @ 45.2 Hz Notez que les valeurs rapport\u00e9es smoothing sont des valeurs projet\u00e9es abstraites. Ces valeurs peuvent \u00eatre utilis\u00e9es pour comparer diff\u00e9rentes configurations : plus la valeur est \u00e9lev\u00e9e, plus le formateur d'entr\u00e9e cr\u00e9era de lissage. Cependant, ces scores de lissage ne repr\u00e9sentent aucune mesure r\u00e9elle du lissage, car le lissage r\u00e9el d\u00e9pend des param\u00e8tres max_accel et square_corner_velocity . Par cons\u00e9quent, vous devrez faire des impressions de test pour voir exactement le lissage cr\u00e9\u00e9 par la configuration choisie. Dans l'exemple ci-dessus, les param\u00e8tres de mise en forme sugg\u00e9r\u00e9s ne sont pas mauvais, mais que se passe-t-il si vous souhaitez obtenir moins de lissage sur l'axe X ? Vous pouvez essayer de limiter le lissage maximal du formateur d'entr\u00e9e \u00e0 l'aide de la commande suivante : ~/klipper/scripts/calibrate_shaper.py /tmp/resonances_x_*.csv -o /tmp/shaper_calibrate_x.png --max_smoothing=0.2 ce qui limite le lissage \u00e0 un score de 0,2. Vous pouvez maintenant obtenir le r\u00e9sultat suivant : Fitted shaper 'zv' frequency = 55.4 Hz (vibrations = 19.7%, smoothing ~= 0.057) To avoid too much smoothing with 'zv', suggested max_accel <= 12000 mm/sec^2 Fitted shaper 'mzv' frequency = 34.6 Hz (vibrations = 3.6%, smoothing ~= 0.170) To avoid too much smoothing with 'mzv', suggested max_accel <= 3500 mm/sec^2 Fitted shaper 'ei' frequency = 48.2 Hz (vibrations = 4.8%, smoothing ~= 0.139) To avoid too much smoothing with 'ei', suggested max_accel <= 4300 mm/sec^2 Fitted shaper '2hump_ei' frequency = 52.0 Hz (vibrations = 2.7%, smoothing ~= 0.200) To avoid too much smoothing with '2hump_ei', suggested max_accel <= 3000 mm/sec^2 Fitted shaper '3hump_ei' frequency = 72.6 Hz (vibrations = 1.4%, smoothing ~= 0.155) To avoid too much smoothing with '3hump_ei', suggested max_accel <= 3900 mm/sec^2 Recommended shaper is 3hump_ei @ 72.6 Hz Si vous comparez avec les pr\u00e9c\u00e9dents param\u00e8tres sugg\u00e9r\u00e9s, les vibrations sont un peu plus importantes, mais le lissage est nettement plus faible qu'auparavant, ce qui permet une acc\u00e9l\u00e9ration maximale plus importante. Lorsque vous choisissez le param\u00e8tre max_smoothing , vous pouvez utiliser une approche par essais et erreurs. Essayez quelques valeurs diff\u00e9rentes et voyez quels r\u00e9sultats vous obtenez. Notez que le lissage r\u00e9el produit par le formateur d'entr\u00e9e d\u00e9pend principalement de la fr\u00e9quence de r\u00e9sonance la plus basse de l'imprimante : plus la fr\u00e9quence de r\u00e9sonance la plus basse est \u00e9lev\u00e9e, plus le lissage est faible. Par cons\u00e9quent, si vous demandez au script de trouver une configuration du formateur d'entr\u00e9e avec un lissage irr\u00e9aliste, cela se fera au d\u00e9triment d'une r\u00e9sonance accrue aux fr\u00e9quences les plus basses (g\u00e9n\u00e9ralement, les plus visibles dans les impressions). V\u00e9rifiez donc toujours les vibrations restantes projet\u00e9es signal\u00e9es par le script et assurez-vous qu'elles ne sont pas trop \u00e9lev\u00e9es. Notez que si vous avez trouv\u00e9 une bonne valeur de max_smoothing pour vos deux axes, vous pouvez la stocker dans printer.cfg comme [resonance_tester] accel_chip: ... probe_points: ... max_smoothing: 0.25 # valeur exemple Ensuite, si vous r\u00e9ex\u00e9cutez le r\u00e9glage automatique du formateur d'entr\u00e9e \u00e0 l'aide de la commande SHAPER_CALIBRATE , c'est cette valeur stock\u00e9e max_smoothing qui sera prise comme r\u00e9f\u00e9rence.","title":"Lissage maximum"},{"location":"Measuring_Resonances.html#selection-de-max_accel","text":"\u00c9tant donn\u00e9 que le formateur d'entr\u00e9e peut cr\u00e9er un certain lissage dans les pi\u00e8ces, en particulier avec des acc\u00e9l\u00e9rations \u00e9lev\u00e9es, vous devrez toujours choisir une valeur max_accel ne cr\u00e9ant pas trop de lissage dans les pi\u00e8ces imprim\u00e9es. Un script d'\u00e9talonnage fournit une estimation du param\u00e8tre max_accel qui ne devrait pas cr\u00e9er trop de lissage. Notez que le max_accel tel qu'affich\u00e9 par le script de calibrage n'est qu'un maximum th\u00e9orique auquel le formateur d'entr\u00e9e est encore capable de travailler sans produire trop de lissage. Il ne s'agit en aucun cas d'une recommandation pour d\u00e9finir cette acc\u00e9l\u00e9ration sur vos impressions. L'acc\u00e9l\u00e9ration maximale support\u00e9e par votre imprimante d\u00e9pend de ses propri\u00e9t\u00e9s m\u00e9caniques et du couple maximal des moteurs pas \u00e0 pas utilis\u00e9s. Par cons\u00e9quent, il est sugg\u00e9r\u00e9 de d\u00e9finir un max_accel dans la section [printer] qui ne d\u00e9passe pas les valeurs estim\u00e9es pour les axes X et Y, probablement avec une marge de s\u00e9curit\u00e9. Vous pouvez \u00e9galement suivre cette partie du guide de r\u00e9glage du formateur d'entr\u00e9e et imprimer un mod\u00e8le de test pour choisir le param\u00e8tre max_accel de mani\u00e8re exp\u00e9rimentale. M\u00eame remarque pour l' auto-calibration du formateur d'entr\u00e9e avec la commande SHAPER_CALIBRATE : il faut encore choisir la bonne valeur max_accel apr\u00e8s l'auto-calibrage, notez que les limites d'acc\u00e9l\u00e9rations sugg\u00e9r\u00e9es ne sont pas appliqu\u00e9es automatiquement. Si vous effectuez un r\u00e9-\u00e9talonnage du formateur d'entr\u00e9e et que le lissage indiqu\u00e9 pour la configuration de formateur sugg\u00e9r\u00e9e est pratiquement le m\u00eame que celui obtenu lors du calibrage pr\u00e9c\u00e9dent, cette \u00e9tape peut \u00eatre ignor\u00e9e.","title":"S\u00e9lection de max_accel"},{"location":"Measuring_Resonances.html#test-des-axes-personnalises","text":"la commande TEST_RESONANCES prend en charge les axes personnalis\u00e9s. Bien que cela ne soit pas vraiment utile pour l\u2019\u00e9talonnage des input shaper, cela peut \u00eatre utilis\u00e9 pour \u00e9tudier en profondeur les r\u00e9sonances de l\u2019imprimante et v\u00e9rifier, par exemple, la tension de la courroie. Pour v\u00e9rifier la tension de la courroie sur les imprimantes CoreXY, ex\u00e9cutez TEST_RESONANCES AXIS=1,1 OUTPUT=raw_data TEST_RESONANCES AXIS=1,-1 OUTPUT=raw_data et utilisez graph_accelerometer.py pour traiter les fichiers g\u00e9n\u00e9r\u00e9s. ~/klipper/scripts/graph_accelerometer.py -c /tmp/raw_data_axis*.csv -o /tmp/resonances.png qui g\u00e9n\u00e9rera /tmp/r\u00e9sonances.png en comparant les r\u00e9sonances. Pour les imprimantes Delta avec le placement des tours par d\u00e9faut (tour A ~= 210 degr\u00e9s, B ~= 330 degr\u00e9s et C ~= 90 degr\u00e9s), ex\u00e9cutez TEST_RESONANCES AXIS=0,1 OUTPUT=raw_data TEST_RESONANCES AXIS=-0.866025404,-0.5 OUTPUT=raw_data TEST_RESONANCES AXIS=0.866025404,-0.5 OUTPUT=raw_data puis utilisez la m\u00eame commande ~/klipper/scripts/graph_accelerometer.py -c /tmp/raw_data_axis*.csv -o /tmp/resonances.png pour g\u00e9n\u00e9rer le fichier de comparaison des r\u00e9sonnances /tmp/r\u00e9sonances.png .","title":"Test des axes personnalis\u00e9s"},{"location":"Measuring_Resonances.html#calibrage-automatique-du-formateur-dentree","text":"En plus de choisir manuellement les param\u00e8tres appropri\u00e9s pour la fonction de formateur d'entr\u00e9e, il est \u00e9galement possible d'ex\u00e9cuter le r\u00e9glage automatique du formateur d'entr\u00e9e directement \u00e0 partir de Klipper. Ex\u00e9cutez la commande suivante via le terminal Octoprint : SHAPER_CALIBRATE Cela ex\u00e9cutera le test complet pour les deux axes et g\u00e9n\u00e9rera la sortie csv ( /tmp/calibration_data_*.csv par d\u00e9faut) pour la r\u00e9ponse en fr\u00e9quence et les formateurs d'entr\u00e9e sugg\u00e9r\u00e9s. Vous obtiendrez \u00e9galement les fr\u00e9quences sugg\u00e9r\u00e9es pour chaque formateur, ainsi que le mod\u00e8le de formateur d'entr\u00e9e recommand\u00e9 pour votre configuration, sur la console Octoprint. Par exemple\u202f: Calculating the best input shaper parameters for y axis Fitted shaper 'zv' frequency = 39.0 Hz (vibrations = 13.2%, smoothing ~= 0.105) To avoid too much smoothing with 'zv', suggested max_accel <= 5900 mm/sec^2 Fitted shaper 'mzv' frequency = 36.8 Hz (vibrations = 1.7%, smoothing ~= 0.150) To avoid too much smoothing with 'mzv', suggested max_accel <= 4000 mm/sec^2 Fitted shaper 'ei' frequency = 36.6 Hz (vibrations = 2.2%, smoothing ~= 0.240) To avoid too much smoothing with 'ei', suggested max_accel <= 2500 mm/sec^2 Fitted shaper '2hump_ei' frequency = 48.0 Hz (vibrations = 0.0%, smoothing ~= 0.234) To avoid too much smoothing with '2hump_ei', suggested max_accel <= 2500 mm/sec^2 Fitted shaper '3hump_ei' frequency = 59.0 Hz (vibrations = 0.0%, smoothing ~= 0.235) To avoid too much smoothing with '3hump_ei', suggested max_accel <= 2500 mm/sec^2 Recommended shaper_type_y = mzv, shaper_freq_y = 36.8 Hz Si vous \u00eates d'accord avec les param\u00e8tres sugg\u00e9r\u00e9s, vous pouvez ex\u00e9cuter SAVE_CONFIG maintenant pour les enregistrer et red\u00e9marrer Klipper. Notez que cela ne mettra pas \u00e0 jour la valeur max_accel dans la section [printer] . Vous devrez la mettre \u00e0 jour manuellement en suivant les recommandations de la section Choisir l'acc\u00e9l\u00e9ration maximale . Si votre imprimante est une imprimante cart\u00e9sienne, vous pouvez pr\u00e9ciser l'axe \u00e0 tester, afin de pouvoir modifier le point de montage de l'acc\u00e9l\u00e9rom\u00e8tre entre les tests (par d\u00e9faut, le test est effectu\u00e9 pour les deux axes) : SHAPER_CALIBRATE AXIS=Y Vous pouvez ex\u00e9cuter SAVE_CONFIG deux fois - apr\u00e8s avoir calibr\u00e9 chaque axe. Cependant, si vous avez connect\u00e9 deux acc\u00e9l\u00e9rom\u00e8tres simultan\u00e9ment, vous pouvez ex\u00e9cutez simplement SHAPER_CALIBRATE sans sp\u00e9cifier d'axe pour calibrer les formateurs d'entr\u00e9e des deux axes en une seule fois.","title":"Calibrage automatique du formateur d'entr\u00e9e"},{"location":"Measuring_Resonances.html#re-etalonnage-du-formateur-dentree-aka-input-shapper","text":"La commande SHAPER_CALIBRATE peut \u00e9galement \u00eatre utilis\u00e9e pour recalibrer le formateur d'entr\u00e9e ult\u00e9rieurement, en particulier si des modifications de l'imprimante pouvant affecter sa cin\u00e9matique sont apport\u00e9es. On peut soit relancer l'\u00e9talonnage complet \u00e0 l'aide de la commande SHAPER_CALIBRATE , soit restreindre l'auto-\u00e9talonnage \u00e0 un seul axe en fournissant le param\u00e8tre AXIS= , comme SHAPER_CALIBRATE AXIS=X Attention ! Il est d\u00e9conseill\u00e9 d'ex\u00e9cuter l'autocalibrage de l'input shaper tr\u00e8s fr\u00e9quemment (par exemple, avant chaque impression ou tous les jours). Afin de d\u00e9terminer les fr\u00e9quences de r\u00e9sonance, l'autocalibrage cr\u00e9e des vibrations intenses sur chacun des axes. Les imprimantes 3D ne sont pas con\u00e7ues pour r\u00e9sister \u00e0 une exposition prolong\u00e9e \u00e0 des vibrations proches des fr\u00e9quences de r\u00e9sonance. Cela pourrait augmenter l'usure des composants de l'imprimante et r\u00e9duire leur dur\u00e9e de vie. Il existe \u00e9galement un risque accru que certaines pi\u00e8ces se d\u00e9vissent ou se desserrent. V\u00e9rifiez toujours que toutes les pi\u00e8ces de l'imprimante (y compris celles qui ne peuvent normalement pas bouger) sont solidement fix\u00e9es en place apr\u00e8s chaque r\u00e9glage automatique. De plus, en raison d'un certain bruit dans les mesures, il est possible que les r\u00e9sultats de r\u00e9glage soient l\u00e9g\u00e8rement diff\u00e9rents d'un calibrage \u00e0 l'autre. Ce bruit ne devrait pas trop affecter la qualit\u00e9 d'impression. Cependant, il est conseill\u00e9 de rev\u00e9rifier les param\u00e8tres sugg\u00e9r\u00e9s et d'imprimer des tests d'impression avant de les utiliser pour confirmer qu'ils sont corrects.","title":"R\u00e9-\u00e9talonnage du formateur d'entr\u00e9e (aka input shapper)"},{"location":"Measuring_Resonances.html#traitement-hors-ligne-des-donnees-de-laccelerometre","text":"Il est possible de g\u00e9n\u00e9rer les donn\u00e9es brutes de l\u2019acc\u00e9l\u00e9rom\u00e8tre et de les traiter hors ligne (par exemple sur une machine h\u00f4te), par exemple pour trouver des r\u00e9sonances. Pour ce faire, ex\u00e9cutez les commandes suivantes via le terminal Octoprint : SET_INPUT_SHAPER SHAPER_FREQ_X=0 SHAPER_FREQ_Y=0 TEST_RESONANCES AXIS=X OUTPUT=raw_data ignorez toute erreur pour la commande SET_INPUT_SHAPER . Pour la commande TEST_RESONANCES , sp\u00e9cifiez l\u2019axe de test souhait\u00e9. Les donn\u00e9es brutes seront \u00e9crites dans le r\u00e9pertoire /tmp sur le RPi. Les donn\u00e9es brutes peuvent \u00e9galement \u00eatre obtenues en ex\u00e9cutant la commande ACCELEROMETER_MEASURE deux fois - d\u2019abord pour d\u00e9marrer les mesures, puis pour les arr\u00eater et \u00e9crire le fichier de sortie. Reportez-vous \u00e0 G-Codes pour plus de d\u00e9tails. Les donn\u00e9es peuvent \u00eatre trait\u00e9es ult\u00e9rieurement avec les scripts suivants : scripts/graph_accelerometer.py et scripts/calibrate_shaper.py . Les deux acceptent un ou plusieurs fichiers csv bruts comme entr\u00e9e en fonction du mode. Le script graph_accelerometer.py prend en charge plusieurs modes de fonctionnement : pour le tra\u00e7age des donn\u00e9es brutes de l\u2019acc\u00e9l\u00e9rom\u00e8tre (utilisez le param\u00e8tre -r ), seule 1 entr\u00e9e est prise en charge\u202f; tracer une r\u00e9ponse en fr\u00e9quence (aucun param\u00e8tre suppl\u00e9mentaire n'est requis), si plusieurs entr\u00e9es sont sp\u00e9cifi\u00e9es, la r\u00e9ponse en fr\u00e9quence moyenne est calcul\u00e9e ; comparaison de la r\u00e9ponse en fr\u00e9quence entre plusieurs entr\u00e9es (utiliser le param\u00e8tre -c ) ; vous pouvez \u00e9galement sp\u00e9cifier l\u2019axe de l\u2019acc\u00e9l\u00e9rom\u00e8tre \u00e0 prendre en compte via le param\u00e8tre -a x , -a y ou -a z (si aucun n\u2019est sp\u00e9cifi\u00e9, la somme des vibrations pour tous les axes est utilis\u00e9e) ; tra\u00e7age du spectrogramme (utiliser le param\u00e8tre -s ), seule 1 entr\u00e9e est prise en charge\u202f; vous pouvez \u00e9galement sp\u00e9cifier l\u2019axe de l\u2019acc\u00e9l\u00e9rom\u00e8tre \u00e0 prendre en compte via le param\u00e8tre -a x , -a y ou -a z (si aucun n\u2019est sp\u00e9cifi\u00e9, la somme des vibrations pour tous les axes est utilis\u00e9e). Notez que graph_accelerometer.py script ne prend en charge que les fichiers raw_data*.csv et non les fichiers resonances*.csv ou calibration_data*.csv. Par exemple, ~/klipper/scripts/graph_accelerometer.py /tmp/raw_data_x_*.csv -o /tmp/resonances_x.png -c -a z tracera la comparaison de plusieurs fichiers /tmp/raw_data_x_*.csv pour l\u2019axe Z dans le fichier /tmp/resonances_x.png . Le script shaper_calibrate.py accepte 1 ou plusieurs entr\u00e9es et peut ex\u00e9cuter le r\u00e9glage automatique de l'input shaper et sugg\u00e9rer les meilleurs param\u00e8tres pour les entr\u00e9es fournies. Il affiche les param\u00e8tres sugg\u00e9r\u00e9s sur la console et peut en outre g\u00e9n\u00e9rer un graphique si le param\u00e8tre -o output.png est fourni, ou un fichier CSV si le param\u00e8tre -c output.csv est sp\u00e9cifi\u00e9. Fournir plusieurs entr\u00e9es \u00e0 shaper_calibrate.py script peut \u00eatre utile si vous ex\u00e9cutez un r\u00e9glage avanc\u00e9 de l'input shaper, par exemple : Ex\u00e9cutez TEST_RESONANCES AXIS=X OUTPUT=raw_data (et Y axe) pour un seul axe deux fois sur une imprimante cart\u00e9sienne avec l\u2019acc\u00e9l\u00e9rom\u00e8tre fix\u00e9 \u00e0 la t\u00eate d\u2019outil la premi\u00e8re fois, et l\u2019acc\u00e9l\u00e9rom\u00e8tre fix\u00e9 au lit la deuxi\u00e8me fois afin de d\u00e9tecter les r\u00e9sonances crois\u00e9es des axes et de tenter de les annuler avec l'input shaper. Ex\u00e9cutez TEST_RESONANCES AXIS=Y OUTPUT=raw_data deux fois sur le lit avec un lit en verre et une surface magn\u00e9tique (plus l\u00e9g\u00e8re) pour trouver les param\u00e8tres d'input shaper qui fonctionnent bien pour n\u2019importe quelle configuration de surface d\u2019impression. Combinaison des donn\u00e9es de r\u00e9sonance de plusieurs points de test. Combinaison des donn\u00e9es de r\u00e9sonance \u00e0 partir de 2 axes (par exemple, sur une imprimante cart\u00e9sienne pour configurer les input_shaper de l\u2019axe X \u00e0 partir des r\u00e9sonances des axes X et Y pour annuler les vibrations du lit * * au cas o\u00f9 la buse \u00ab attraperait \u00bb une impression lors du d\u00e9placement dans la direction de l\u2019axe X).","title":"Traitement hors ligne des donn\u00e9es de l\u2019acc\u00e9l\u00e9rom\u00e8tre"},{"location":"Multi_MCU_Homing.html","text":"Mise \u00e0 l'origine et Palpage multi contr\u00f4leurs \u00b6 Klipper poss\u00e8de un m\u00e9canisme pour la mise \u00e0 l'origine avec une fin de course raccord\u00e9e \u00e0 un microcontr\u00f4leur et des moteurs pas \u00e0 pas raccord\u00e9s \u00e0 un autre microcontr\u00f4leur. Ce m\u00e9canisme est connu sous le nom de \"multi-mcu homing\". Cette fonctionnalit\u00e9 est aussi utilis\u00e9e si la sonde de palpage Z est raccord\u00e9e \u00e0 un microcontr\u00f4leur diff\u00e9rent de celui des moteurs Z. Cette fonctionnalit\u00e9 peut \u00eatre utile pour simplifier le c\u00e2blage : il peut \u00eatre plus simple de raccorder un fin de course ou une sonde au microcontr\u00f4leur le plus proche. Cependant, l'utilisation de cette fonctionnalit\u00e9 peut provoquer un \"d\u00e9passement\" des moteurs pas \u00e0 pas pendant les op\u00e9ration de mise \u00e0 l'origine ou de palpage. Cette possibilit\u00e9 de \"d\u00e9passement\" peut arriver \u00e0 cause des d\u00e9lais de transmission entre le microcontr\u00f4leur des endstop et le microcontr\u00f4leur qui d\u00e9plce les moteurs pas \u00e0 pas. Le code de Klipper a \u00e9t\u00e9 con\u00e7u pour limiter ce d\u00e9lai a moins de 25 ms. (Quand la mise \u00e0 l'origine multi contr\u00f4leurs est active, les microcontr\u00f4leurs envoient des messages d'\u00e9tat p\u00e9riodiquement et il y a une v\u00e9rification que ces messages sont bien re\u00e7us dans la limite des 25 ms.) Donc, par exemple, si l'on fait une mise \u00e0 l'origine \u00e0 10 mm/s, il est alors possible de d\u00e9passer de 0.250 mm maximum (10 mm/s * 0.25 s = 0.250 mm).Il faut bien faire attention \u00e0 cette possibilit\u00e9 de \"d\u00e9passement\" lors de la configuration d'une mise \u00e0 l'origine avec multiples contr\u00f4leurs. Une mise \u00e0 l'origine ou un palpage plus lent peut r\u00e9duite le \"d\u00e9passement\". Ce d\u00e9passement des moteurs pas \u00e0 pas ne nuit pas \u00e0 la pr\u00e9cision de la proc\u00e9dure de mise \u00e0 l'origine et de palpage. Le code de Klipper d\u00e9tectera le d\u00e9passement et en tiendra compte dans ses calculs. Cependant, il est important que la conception mat\u00e9rielle soit capable de g\u00e9rer les d\u00e9passements sans endommager la machine. Si Klipper d\u00e9tecte un probl\u00e8me de communication entre les microcontr\u00f4leurs lors de la mise \u00e0 l'origine multi-mcu, il d\u00e9clenchera une erreur \"D\u00e9lai de communication pendant la mise \u00e0 l'origine\". Notez qu'un axe avec plusieurs steppers (par exemple, stepper_z et stepper_z1 ) doit avoir tous les meteeurs pas \u00e0 pas sur le m\u00eame microcontr\u00f4leur afin d'utiliser le r\u00e9f\u00e9rencement multi-mcu. Par exemple, si une fin de course est sur un microcontr\u00f4leur distinct de stepper_z alors stepper_z1 doit \u00eatre sur le m\u00eame microcontr\u00f4leur que stepper_z .","title":"Mise \u00e0 l'origine et Palpage multi contr\u00f4leurs"},{"location":"Multi_MCU_Homing.html#mise-a-lorigine-et-palpage-multi-controleurs","text":"Klipper poss\u00e8de un m\u00e9canisme pour la mise \u00e0 l'origine avec une fin de course raccord\u00e9e \u00e0 un microcontr\u00f4leur et des moteurs pas \u00e0 pas raccord\u00e9s \u00e0 un autre microcontr\u00f4leur. Ce m\u00e9canisme est connu sous le nom de \"multi-mcu homing\". Cette fonctionnalit\u00e9 est aussi utilis\u00e9e si la sonde de palpage Z est raccord\u00e9e \u00e0 un microcontr\u00f4leur diff\u00e9rent de celui des moteurs Z. Cette fonctionnalit\u00e9 peut \u00eatre utile pour simplifier le c\u00e2blage : il peut \u00eatre plus simple de raccorder un fin de course ou une sonde au microcontr\u00f4leur le plus proche. Cependant, l'utilisation de cette fonctionnalit\u00e9 peut provoquer un \"d\u00e9passement\" des moteurs pas \u00e0 pas pendant les op\u00e9ration de mise \u00e0 l'origine ou de palpage. Cette possibilit\u00e9 de \"d\u00e9passement\" peut arriver \u00e0 cause des d\u00e9lais de transmission entre le microcontr\u00f4leur des endstop et le microcontr\u00f4leur qui d\u00e9plce les moteurs pas \u00e0 pas. Le code de Klipper a \u00e9t\u00e9 con\u00e7u pour limiter ce d\u00e9lai a moins de 25 ms. (Quand la mise \u00e0 l'origine multi contr\u00f4leurs est active, les microcontr\u00f4leurs envoient des messages d'\u00e9tat p\u00e9riodiquement et il y a une v\u00e9rification que ces messages sont bien re\u00e7us dans la limite des 25 ms.) Donc, par exemple, si l'on fait une mise \u00e0 l'origine \u00e0 10 mm/s, il est alors possible de d\u00e9passer de 0.250 mm maximum (10 mm/s * 0.25 s = 0.250 mm).Il faut bien faire attention \u00e0 cette possibilit\u00e9 de \"d\u00e9passement\" lors de la configuration d'une mise \u00e0 l'origine avec multiples contr\u00f4leurs. Une mise \u00e0 l'origine ou un palpage plus lent peut r\u00e9duite le \"d\u00e9passement\". Ce d\u00e9passement des moteurs pas \u00e0 pas ne nuit pas \u00e0 la pr\u00e9cision de la proc\u00e9dure de mise \u00e0 l'origine et de palpage. Le code de Klipper d\u00e9tectera le d\u00e9passement et en tiendra compte dans ses calculs. Cependant, il est important que la conception mat\u00e9rielle soit capable de g\u00e9rer les d\u00e9passements sans endommager la machine. Si Klipper d\u00e9tecte un probl\u00e8me de communication entre les microcontr\u00f4leurs lors de la mise \u00e0 l'origine multi-mcu, il d\u00e9clenchera une erreur \"D\u00e9lai de communication pendant la mise \u00e0 l'origine\". Notez qu'un axe avec plusieurs steppers (par exemple, stepper_z et stepper_z1 ) doit avoir tous les meteeurs pas \u00e0 pas sur le m\u00eame microcontr\u00f4leur afin d'utiliser le r\u00e9f\u00e9rencement multi-mcu. Par exemple, si une fin de course est sur un microcontr\u00f4leur distinct de stepper_z alors stepper_z1 doit \u00eatre sur le m\u00eame microcontr\u00f4leur que stepper_z .","title":"Mise \u00e0 l'origine et Palpage multi contr\u00f4leurs"},{"location":"Navigation.html","text":"Documentation Klipper Installation et configuration R\u00e9f\u00e9rence de configuration Nivellement du lit Compensation de la r\u00e9sonance Mod\u00e8les de commandes Documentation pour les d\u00e9veloppeurs Documents sp\u00e9cifiques \u00e0 certains appareils","title":"Navigation"},{"location":"Overview.html","text":"Vue d'ensemble \u00b6 Bienvenue dans la documentation de Klipper. Si vous d\u00e9butez avec Klipper, commencez par les sections fonctionnalit\u00e9s et installation . Informations g\u00e9n\u00e9rales \u00b6 Fonctionnalit\u00e9s : Une liste avanc\u00e9e des fonctionnalit\u00e9s de Klipper. FAQ \u202f: Foire aux questions. Versions : L'historique des versions de Klipper. Modifications de configuration \u202f: Modifications r\u00e9centes du logiciel pouvant n\u00e9cessiter que les utilisateurs mettent \u00e0 jour la configuration de leur imprimante. Contact \u202f: Informations sur les rapports d'anomalies et communication g\u00e9n\u00e9rale avec les d\u00e9veloppeurs de Klipper. Installation et configuration \u00b6 Installation \u202f: Guide d'installation de Klipper. R\u00e9f\u00e9rence de la configuration : Description de tous les param\u00e8tres de configuration. Distance de rotation : Calcul du param\u00e8tre rotation_distance du moteur. V\u00e9rifications de la configuration : V\u00e9rification des param\u00e8tres de base des broches du fichier de configuration. Nivelage du lit : Informations sur le \"nivelage du lit\" dans Klipper. Calibration delta : Calibration de la cin\u00e9matique Delta. Calibration de la sonde : Calibration automatique des sondes Z. BL-Touch : Configuration d'une sonde \"BL-Touch\". Nivelage manuel : Calibration des but\u00e9es Z (et similaires). Maillage du lit : Correction de la hauteur du lit bas\u00e9e sur les emplacements XY. Phase de fin de course : Positionnement de la but\u00e9e Z assist\u00e9 par moteur. Compensation de la r\u00e9sonance : Un outil permettant de r\u00e9duire la r\u00e9sonance durant les impressions. Mesure des r\u00e9sonances : Informations sur l'utilisation d'un acc\u00e9l\u00e9rom\u00e8tre adxl345 pour mesurer les r\u00e9sonances. Avance \u00e0 la pression : Calibration de la pression dans l'extrudeur. G-Codes : Informations sur les instructions prises en charge par Klipper. Mod\u00e8les de commande : Macros G-Code et \u00e9valuation conditionnelle. R\u00e9f\u00e9rence des \u00e9tats : Informations disponibles pour les macros (et similaires). Pilotes TMC : Utilisation des pilotes de moteurs pas \u00e0 pas Trinamic avec Klipper. Prise origine multi-MCU : Mise \u00e0 l'origine et palpage utilisant plusieurs micro-contr\u00f4leurs. Trancheurs : Configuration d'un logiciel de \"tranchage\" pour Klipper. Correction d'obliquit\u00e9 : Ajustements des axes qui ne sont pas parfaitement d'\u00e9querre. Outils PWM : Guide sur l'utilisation des outils contr\u00f4l\u00e9s par PWM tels que les lasers ou les broches. Exclusion d'objets : Le guide de l'impl\u00e9mentation de l'exclusion d'objets. Documentation pour les d\u00e9veloppeurs \u00b6 Aper\u00e7u du code : Les d\u00e9veloppeurs devraient lire ceci en premier. Cin\u00e9matiques : D\u00e9tails techniques sur la fa\u00e7on dont Klipper met en \u0153uvre les mouvements. Protocole : Informations sur le protocole de messagerie de bas niveau entre l'h\u00f4te et le microcontr\u00f4leur. API du serveur : Informations sur l'API de commande et de contr\u00f4le de Klipper. Commandes MCU : Une description des commandes de bas niveau impl\u00e9ment\u00e9es dans le logiciel du micro-contr\u00f4leur. Protocole du bus CAN : Format de messages du bus CAN de Klipper. D\u00e9bogage : Informations sur la fa\u00e7on de tester et d\u00e9boguer Klipper. Tests de charge : Informations sur la m\u00e9thode de tests de charge de Klipper. Contribuer : Comment proposer des am\u00e9liorations pour Klipper. Packaging : Informations sur la construction de paquets de syst\u00e8me d'exploitation. Documents sp\u00e9cifiques \u00e0 certains appareils \u00b6 Exemples de configurations : Informations sur l'ajout d'un exemple de fichier de configuration \u00e0 Klipper. Mises \u00e0 jour par carte SD : Flasher le micro-contr\u00f4leur en copiant un binaire sur une carte SD. Raspberry Pi en tant que micro-contr\u00f4leur : D\u00e9tails pour contr\u00f4ler les appareils connect\u00e9s aux broches GPIO d'un Raspberry Pi. Beaglebone : D\u00e9tails pour l'ex\u00e9cution de Klipper sur le SBC Beaglebone. Bootloaders : Informations pour les d\u00e9veloppeurs sur le flashage des microcontr\u00f4leurs. Bus CAN : Informations sur l'utilisation du bus CAN avec Klipper. Capteur de largeur de filament TSL1401CL D\u00e9tecteur de largeur de filament \u00e0 effet hall","title":"Vue d'ensemble"},{"location":"Overview.html#vue-densemble","text":"Bienvenue dans la documentation de Klipper. Si vous d\u00e9butez avec Klipper, commencez par les sections fonctionnalit\u00e9s et installation .","title":"Vue d'ensemble"},{"location":"Overview.html#informations-generales","text":"Fonctionnalit\u00e9s : Une liste avanc\u00e9e des fonctionnalit\u00e9s de Klipper. FAQ \u202f: Foire aux questions. Versions : L'historique des versions de Klipper. Modifications de configuration \u202f: Modifications r\u00e9centes du logiciel pouvant n\u00e9cessiter que les utilisateurs mettent \u00e0 jour la configuration de leur imprimante. Contact \u202f: Informations sur les rapports d'anomalies et communication g\u00e9n\u00e9rale avec les d\u00e9veloppeurs de Klipper.","title":"Informations g\u00e9n\u00e9rales"},{"location":"Overview.html#installation-et-configuration","text":"Installation \u202f: Guide d'installation de Klipper. R\u00e9f\u00e9rence de la configuration : Description de tous les param\u00e8tres de configuration. Distance de rotation : Calcul du param\u00e8tre rotation_distance du moteur. V\u00e9rifications de la configuration : V\u00e9rification des param\u00e8tres de base des broches du fichier de configuration. Nivelage du lit : Informations sur le \"nivelage du lit\" dans Klipper. Calibration delta : Calibration de la cin\u00e9matique Delta. Calibration de la sonde : Calibration automatique des sondes Z. BL-Touch : Configuration d'une sonde \"BL-Touch\". Nivelage manuel : Calibration des but\u00e9es Z (et similaires). Maillage du lit : Correction de la hauteur du lit bas\u00e9e sur les emplacements XY. Phase de fin de course : Positionnement de la but\u00e9e Z assist\u00e9 par moteur. Compensation de la r\u00e9sonance : Un outil permettant de r\u00e9duire la r\u00e9sonance durant les impressions. Mesure des r\u00e9sonances : Informations sur l'utilisation d'un acc\u00e9l\u00e9rom\u00e8tre adxl345 pour mesurer les r\u00e9sonances. Avance \u00e0 la pression : Calibration de la pression dans l'extrudeur. G-Codes : Informations sur les instructions prises en charge par Klipper. Mod\u00e8les de commande : Macros G-Code et \u00e9valuation conditionnelle. R\u00e9f\u00e9rence des \u00e9tats : Informations disponibles pour les macros (et similaires). Pilotes TMC : Utilisation des pilotes de moteurs pas \u00e0 pas Trinamic avec Klipper. Prise origine multi-MCU : Mise \u00e0 l'origine et palpage utilisant plusieurs micro-contr\u00f4leurs. Trancheurs : Configuration d'un logiciel de \"tranchage\" pour Klipper. Correction d'obliquit\u00e9 : Ajustements des axes qui ne sont pas parfaitement d'\u00e9querre. Outils PWM : Guide sur l'utilisation des outils contr\u00f4l\u00e9s par PWM tels que les lasers ou les broches. Exclusion d'objets : Le guide de l'impl\u00e9mentation de l'exclusion d'objets.","title":"Installation et configuration"},{"location":"Overview.html#documentation-pour-les-developpeurs","text":"Aper\u00e7u du code : Les d\u00e9veloppeurs devraient lire ceci en premier. Cin\u00e9matiques : D\u00e9tails techniques sur la fa\u00e7on dont Klipper met en \u0153uvre les mouvements. Protocole : Informations sur le protocole de messagerie de bas niveau entre l'h\u00f4te et le microcontr\u00f4leur. API du serveur : Informations sur l'API de commande et de contr\u00f4le de Klipper. Commandes MCU : Une description des commandes de bas niveau impl\u00e9ment\u00e9es dans le logiciel du micro-contr\u00f4leur. Protocole du bus CAN : Format de messages du bus CAN de Klipper. D\u00e9bogage : Informations sur la fa\u00e7on de tester et d\u00e9boguer Klipper. Tests de charge : Informations sur la m\u00e9thode de tests de charge de Klipper. Contribuer : Comment proposer des am\u00e9liorations pour Klipper. Packaging : Informations sur la construction de paquets de syst\u00e8me d'exploitation.","title":"Documentation pour les d\u00e9veloppeurs"},{"location":"Overview.html#documents-specifiques-a-certains-appareils","text":"Exemples de configurations : Informations sur l'ajout d'un exemple de fichier de configuration \u00e0 Klipper. Mises \u00e0 jour par carte SD : Flasher le micro-contr\u00f4leur en copiant un binaire sur une carte SD. Raspberry Pi en tant que micro-contr\u00f4leur : D\u00e9tails pour contr\u00f4ler les appareils connect\u00e9s aux broches GPIO d'un Raspberry Pi. Beaglebone : D\u00e9tails pour l'ex\u00e9cution de Klipper sur le SBC Beaglebone. Bootloaders : Informations pour les d\u00e9veloppeurs sur le flashage des microcontr\u00f4leurs. Bus CAN : Informations sur l'utilisation du bus CAN avec Klipper. Capteur de largeur de filament TSL1401CL D\u00e9tecteur de largeur de filament \u00e0 effet hall","title":"Documents sp\u00e9cifiques \u00e0 certains appareils"},{"location":"Packaging.html","text":"Packager Klipper \u00b6 Klipper est en quelque sorte comme une anomalie de packaging au sein des programmes Python, car il ne requiert pas d'outils de configuration pour \u00eatre construit et install\u00e9. Quelques notes en ce qui concerne comment package au mieux sont : Modules C \u00b6 Klipper utilise un module en langage C pour g\u00e9rer plus rapidement certains calculs cin\u00e9matiques. Ce module doit \u00eatre compil\u00e9 au moment de l'empaquetage pour \u00e9viter d'introduire une d\u00e9pendance d'ex\u00e9cution sur un compilateur. Pour compiler le module C, ex\u00e9cutez python2 klippy/chelper/__init__.py . Compiler du code python \u00b6 De nombreuses distributions compilent tout le code python avant de l'empaqueter pour am\u00e9liorer le temps de d\u00e9marrage. Vous pouvez le faire en ex\u00e9cutant python2 -m compileall klippy . Versionnage \u00b6 Si vous construisez un paquet de Klipper \u00e0 partir de git, il est d'usage de ne pas envoyer de r\u00e9pertoire .git, donc la gestion des versions doit \u00eatre g\u00e9r\u00e9e sans git. Pour ce faire, utilisez le script fourni dans scripts/make_version.py qui doit \u00eatre ex\u00e9cut\u00e9 comme suit : python2 scripts/make_version.py YOURDISTRONAME > klippy/.version . Exemple de script de pr\u00e9compilation \u00b6 klipper-git is packaged for Arch Linux, and has a PKGBUILD (package build script) available at Arch User Repositiory .","title":"Packager Klipper"},{"location":"Packaging.html#packager-klipper","text":"Klipper est en quelque sorte comme une anomalie de packaging au sein des programmes Python, car il ne requiert pas d'outils de configuration pour \u00eatre construit et install\u00e9. Quelques notes en ce qui concerne comment package au mieux sont :","title":"Packager Klipper"},{"location":"Packaging.html#modules-c","text":"Klipper utilise un module en langage C pour g\u00e9rer plus rapidement certains calculs cin\u00e9matiques. Ce module doit \u00eatre compil\u00e9 au moment de l'empaquetage pour \u00e9viter d'introduire une d\u00e9pendance d'ex\u00e9cution sur un compilateur. Pour compiler le module C, ex\u00e9cutez python2 klippy/chelper/__init__.py .","title":"Modules C"},{"location":"Packaging.html#compiler-du-code-python","text":"De nombreuses distributions compilent tout le code python avant de l'empaqueter pour am\u00e9liorer le temps de d\u00e9marrage. Vous pouvez le faire en ex\u00e9cutant python2 -m compileall klippy .","title":"Compiler du code python"},{"location":"Packaging.html#versionnage","text":"Si vous construisez un paquet de Klipper \u00e0 partir de git, il est d'usage de ne pas envoyer de r\u00e9pertoire .git, donc la gestion des versions doit \u00eatre g\u00e9r\u00e9e sans git. Pour ce faire, utilisez le script fourni dans scripts/make_version.py qui doit \u00eatre ex\u00e9cut\u00e9 comme suit : python2 scripts/make_version.py YOURDISTRONAME > klippy/.version .","title":"Versionnage"},{"location":"Packaging.html#exemple-de-script-de-precompilation","text":"klipper-git is packaged for Arch Linux, and has a PKGBUILD (package build script) available at Arch User Repositiory .","title":"Exemple de script de pr\u00e9compilation"},{"location":"Pressure_Advance.html","text":"Avance \u00e0 la pression \u00b6 Ce document fournit des informations sur les r\u00e9glages de la variable \"pressure advance\" pour une buse et un filament donn\u00e9. La fonctionnalit\u00e9 pressure advance peut aider \u00e0 r\u00e9duire le suintement. Pour plus d'informations sur l'impl\u00e9mentation du pressure advance, vous pouvez lire le document kinematics . R\u00e9glage du pressure advance \u00b6 Pressure advance permet deux choses importantes - r\u00e9duire le suintement pendant les d\u00e9placements sans extrusion et r\u00e9duire les bavures dans les coins. Ce guide utilise la r\u00e9duction des bavures dans les angles comme base de r\u00e9glage. Pour r\u00e9gler le pressure advance, l'imprimante doit \u00eatre configur\u00e9e et en \u00e9tat de marche le test n\u00e9cessitant une impression et une inspection de l'objet imprim\u00e9. Il est conseill\u00e9 de lire ce document en int\u00e9gralit\u00e9 avant de lancer les tests. Utilisez un trancheur pour g\u00e9n\u00e9rer le g-code du grand carr\u00e9 creux disponible dans docs/prints/square_tower.stl . Utilisez un vitesse rapide (ex 100mm/s), pas de remplissage et une hauteur de couche grossi\u00e8re (la hauteur de couche devrait \u00eatre dans les 75% du diam\u00e8tre de la buse). Pensez \u00e0 d\u00e9sactiver toutes les contr\u00f4le d'\"acc\u00e9l\u00e9ration dynamique\" dans le trancheur. Pr\u00e9parez le test en ex\u00e9cutant la commande G-Code suivante : SET_VELOCITY_LIMIT SQUARE_CORNER_VELOCITY=1 ACCEL=500 Cette commande ralentit le d\u00e9placement de la buse dans les angles pour maximiser les effets de la pression de l'extrudeur. Pour les imprimantes munies de direct drive ex\u00e9cutez cette commande : TUNING_TOWER COMMAND=SET_PRESSURE_ADVANCE PARAMETER=ADVANCE START=0 FACTOR=.005 Pour les longs extrudeurs bowden , utilisez : TUNING_TOWER COMMAND=SET_PRESSURE_ADVANCE PARAMETER=ADVANCE START=0 FACTOR=.020 Puis imprimez la pi\u00e8ce. Une fois l'impression termin\u00e9e, l'objet ressemble \u00e0 : La commande TUNING_TOWER ci-dessus demande \u00e0 Klipper de modifier le param\u00e8tre pressure_advance apr\u00e8s chaque couche de l'impression. Les couches sup\u00e9rieures de l'impression auront une valeur de pressure_advance plus \u00e9lev\u00e9e. Les couches en dessous du r\u00e9glage de pressure_advance optimal auront des bavures dans les angles et celles au-dessus du r\u00e9glage id\u00e9ale pourront avoir des coins arrondis ou une mauvaise extrusion dans les angles. Vous pouvez arr\u00eater l'impression si vous observez que les angles ne s'impriment plus correctement. (cela permet d'\u00e9viter d'imprimer les couches qui sont au-dessus de la valeur id\u00e9ale pour le pressure_advance). Inspectez l'impression et utilisez un pied \u00e0 coulisse digital pour trouver la hauteur \u00e0 laquelle les angles sont de bonne qualit\u00e9. En cas de doute, choisissez une hauteur inf\u00e9rieure. La valeur du pressure_advance peut \u00eatre calcul\u00e9e de la mani\u00e8re suivante pressure_advance = <d\u00e9but> + <hauteur_mesur\u00e9e> * <facteur> . (Par exemple, 0 + 12.90 *0 .020 donnera 0.258 .) Il est possible de choisir des valeurs personnalis\u00e9es pour START et FACTOR si cela permet d'identifier le meilleur r\u00e9glage de pressure advance. Si vous utilisez des valeurs personnalis\u00e9es, assurez-vous d'envoyer la commande TUNING_TOWER au d\u00e9but de chaque impression. Les valeurs d\u2019avance de pression moyennes se situent entre 0,050 et 1,000 (le haut de la fourchette est g\u00e9n\u00e9ralement pour les extrudeurs Bowden). S\u2019il n\u2019y a pas d\u2019am\u00e9lioration significative avec une avance de pression jusqu\u2019\u00e0 1.000, il est peu probable que l\u2019avance de pression am\u00e9liore la qualit\u00e9 des impressions. Revenez \u00e0 une configuration par d\u00e9faut avec l\u2019avance de pression d\u00e9sactiv\u00e9e. Bien que cet exercice de r\u00e9glage am\u00e9liore directement la qualit\u00e9 des coins, il convient de rappeler qu\u2019une bonne configuration d\u2019avance de pression r\u00e9duit \u00e9galement le suintement tout au long de l\u2019impression. \u00c0 la fin de ce test, d\u00e9finissez pressure_advance = <calculated_value> dans la section [extruder]` du fichier de configuration et ex\u00e9cutez une commande RESTART. La commande RESTART effacera l\u2019\u00e9tat de test et r\u00e9tablira les param\u00e8tres de vitesse \u00e0 leur valeurs normales. Informations importantes \u00b6 La valeur d\u2019avance de pression d\u00e9pend de l\u2019extrudeur, de la buse et du filament. Il est courant que les filaments de diff\u00e9rents fabricants ou avec diff\u00e9rents pigments n\u00e9cessitent des valeurs d\u2019avance de pression significativement diff\u00e9rentes. Par cons\u00e9quent, il faut calibrer l\u2019avance de pression sur chaque imprimante et avec chaque bobine de filament. La temp\u00e9rature d\u2019impression et les taux d\u2019extrusion peuvent avoir un impact sur l\u2019avancement de la pression. Assurez-vous de r\u00e9gler la rotation_distance de l'extrudeur et temp\u00e9rature de la buse avant de r\u00e9gler l'avance de pression. L\u2019impression de test est con\u00e7ue pour fonctionner avec un d\u00e9bit d\u2019extrudeur \u00e9lev\u00e9, mais avec des r\u00e9glages de trancheur \u00ab normaux \u00bb. Un d\u00e9bit \u00e9lev\u00e9 est obtenu en utilisant une vitesse d\u2019impression \u00e9lev\u00e9e (par exemple, 100 mm/s) et une hauteur de couche grossi\u00e8re (g\u00e9n\u00e9ralement 75% du diam\u00e8tre de la buse). Les autres param\u00e8tres du segment doivent \u00eatre similaires \u00e0 leurs valeurs par d\u00e9faut (par exemple, p\u00e9rim\u00e8tres de 2 ou 3 lignes, distance de r\u00e9traction normale). Il peut \u00eatre utile de d\u00e9finir la vitesse du p\u00e9rim\u00e8tre externe pour qu\u2019elle soit la m\u00eame que le reste de l\u2019impression, mais ce n\u2019est pas une exigence. Il est fr\u00e9quent que l\u2019impression de test montre un comportement diff\u00e9rent \u00e0 chaque coin. Souvent, le trancheur s\u2019arrange pour changer les couches dans un coin, ce qui peut entra\u00eener une diff\u00e9rence significative entre ce coin et les trois coins restants. Si cela se produit, ignorez ce coin et r\u00e9glez l\u2019avance de pression en utilisant les trois autres coins. Il est \u00e9galement courant que les coins restants varient l\u00e9g\u00e8rement. (Cela peut se produire en raison de petites diff\u00e9rences dans la fa\u00e7on dont le cadre de l\u2019imprimante r\u00e9agit aux virages dans certaines directions.) Essayez de choisir une valeur qui fonctionne bien pour tous les coins restants. En cas de doute, pr\u00e9f\u00e9rez une valeur d\u2019avance de pression inf\u00e9rieure. Si une valeur d'avance de pression \u00e9lev\u00e9e (par exemple sup\u00e9rieure \u00e0 0,200) est utilis\u00e9e, il est possible que l'extrudeur saute lors du retour \u00e0 l'acc\u00e9l\u00e9ration normale de l'imprimante. Le syst\u00e8me d'avance de pression tient compte de la pression en poussant un peu plus de filament pendant l'acc\u00e9l\u00e9ration et en r\u00e9tractant ce filament pendant la d\u00e9c\u00e9l\u00e9ration. Avec une acc\u00e9l\u00e9ration \u00e9lev\u00e9e et une avance \u00e0 haute pression, l'extrudeur peut ne pas avoir assez de couple pour pousser la quantit\u00e9 de filament requise. Si cela se produit, utilisez une valeur d'acc\u00e9l\u00e9ration inf\u00e9rieure ou d\u00e9sactivez l'avance de pression. Une fois que l'avance de pression est r\u00e9gl\u00e9e dans Klipper, il peut toujours \u00eatre utile de configurer une petite valeur de r\u00e9traction dans le trancheur (par exemple, 0,75 mm) et d'utiliser l'option \"essuyer lors de la r\u00e9traction\" du trancheur si elle est disponible. Ces r\u00e9glages du trancheur peuvent aider \u00e0 contrecarrer le suintement caus\u00e9 par la coh\u00e9sion du filament (filament retir\u00e9 de la buse en raison de l'adh\u00e9rence du plastique). Il est recommand\u00e9 de d\u00e9sactiver l'option \"relever le Z lors de la r\u00e9traction\" du trancheur. Le syst\u00e8me d'avance de pression ne modifie pas la synchronisation ou la trajectoire de la t\u00eate. Une impression avec l'avance de pression activ\u00e9e prendra le m\u00eame temps qu'une impression sans avance de pression. L'avance de pression ne modifie pas non plus la quantit\u00e9 totale de filament extrud\u00e9 lors d'une impression. L'avance de pression entra\u00eene un mouvement suppl\u00e9mentaire de l'extrudeur pendant l'acc\u00e9l\u00e9ration et la d\u00e9c\u00e9l\u00e9ration du mouvement. Un r\u00e9glage d'avance de pression tr\u00e8s \u00e9lev\u00e9 entra\u00eenera une tr\u00e8s grande quantit\u00e9 de mouvement de l'extrudeur pendant l'acc\u00e9l\u00e9ration et la d\u00e9c\u00e9l\u00e9ration, et aucun r\u00e9glage de configuration ne limite la quantit\u00e9 de ce mouvement.","title":"Avance \u00e0 la pression"},{"location":"Pressure_Advance.html#avance-a-la-pression","text":"Ce document fournit des informations sur les r\u00e9glages de la variable \"pressure advance\" pour une buse et un filament donn\u00e9. La fonctionnalit\u00e9 pressure advance peut aider \u00e0 r\u00e9duire le suintement. Pour plus d'informations sur l'impl\u00e9mentation du pressure advance, vous pouvez lire le document kinematics .","title":"Avance \u00e0 la pression"},{"location":"Pressure_Advance.html#reglage-du-pressure-advance","text":"Pressure advance permet deux choses importantes - r\u00e9duire le suintement pendant les d\u00e9placements sans extrusion et r\u00e9duire les bavures dans les coins. Ce guide utilise la r\u00e9duction des bavures dans les angles comme base de r\u00e9glage. Pour r\u00e9gler le pressure advance, l'imprimante doit \u00eatre configur\u00e9e et en \u00e9tat de marche le test n\u00e9cessitant une impression et une inspection de l'objet imprim\u00e9. Il est conseill\u00e9 de lire ce document en int\u00e9gralit\u00e9 avant de lancer les tests. Utilisez un trancheur pour g\u00e9n\u00e9rer le g-code du grand carr\u00e9 creux disponible dans docs/prints/square_tower.stl . Utilisez un vitesse rapide (ex 100mm/s), pas de remplissage et une hauteur de couche grossi\u00e8re (la hauteur de couche devrait \u00eatre dans les 75% du diam\u00e8tre de la buse). Pensez \u00e0 d\u00e9sactiver toutes les contr\u00f4le d'\"acc\u00e9l\u00e9ration dynamique\" dans le trancheur. Pr\u00e9parez le test en ex\u00e9cutant la commande G-Code suivante : SET_VELOCITY_LIMIT SQUARE_CORNER_VELOCITY=1 ACCEL=500 Cette commande ralentit le d\u00e9placement de la buse dans les angles pour maximiser les effets de la pression de l'extrudeur. Pour les imprimantes munies de direct drive ex\u00e9cutez cette commande : TUNING_TOWER COMMAND=SET_PRESSURE_ADVANCE PARAMETER=ADVANCE START=0 FACTOR=.005 Pour les longs extrudeurs bowden , utilisez : TUNING_TOWER COMMAND=SET_PRESSURE_ADVANCE PARAMETER=ADVANCE START=0 FACTOR=.020 Puis imprimez la pi\u00e8ce. Une fois l'impression termin\u00e9e, l'objet ressemble \u00e0 : La commande TUNING_TOWER ci-dessus demande \u00e0 Klipper de modifier le param\u00e8tre pressure_advance apr\u00e8s chaque couche de l'impression. Les couches sup\u00e9rieures de l'impression auront une valeur de pressure_advance plus \u00e9lev\u00e9e. Les couches en dessous du r\u00e9glage de pressure_advance optimal auront des bavures dans les angles et celles au-dessus du r\u00e9glage id\u00e9ale pourront avoir des coins arrondis ou une mauvaise extrusion dans les angles. Vous pouvez arr\u00eater l'impression si vous observez que les angles ne s'impriment plus correctement. (cela permet d'\u00e9viter d'imprimer les couches qui sont au-dessus de la valeur id\u00e9ale pour le pressure_advance). Inspectez l'impression et utilisez un pied \u00e0 coulisse digital pour trouver la hauteur \u00e0 laquelle les angles sont de bonne qualit\u00e9. En cas de doute, choisissez une hauteur inf\u00e9rieure. La valeur du pressure_advance peut \u00eatre calcul\u00e9e de la mani\u00e8re suivante pressure_advance = <d\u00e9but> + <hauteur_mesur\u00e9e> * <facteur> . (Par exemple, 0 + 12.90 *0 .020 donnera 0.258 .) Il est possible de choisir des valeurs personnalis\u00e9es pour START et FACTOR si cela permet d'identifier le meilleur r\u00e9glage de pressure advance. Si vous utilisez des valeurs personnalis\u00e9es, assurez-vous d'envoyer la commande TUNING_TOWER au d\u00e9but de chaque impression. Les valeurs d\u2019avance de pression moyennes se situent entre 0,050 et 1,000 (le haut de la fourchette est g\u00e9n\u00e9ralement pour les extrudeurs Bowden). S\u2019il n\u2019y a pas d\u2019am\u00e9lioration significative avec une avance de pression jusqu\u2019\u00e0 1.000, il est peu probable que l\u2019avance de pression am\u00e9liore la qualit\u00e9 des impressions. Revenez \u00e0 une configuration par d\u00e9faut avec l\u2019avance de pression d\u00e9sactiv\u00e9e. Bien que cet exercice de r\u00e9glage am\u00e9liore directement la qualit\u00e9 des coins, il convient de rappeler qu\u2019une bonne configuration d\u2019avance de pression r\u00e9duit \u00e9galement le suintement tout au long de l\u2019impression. \u00c0 la fin de ce test, d\u00e9finissez pressure_advance = <calculated_value> dans la section [extruder]` du fichier de configuration et ex\u00e9cutez une commande RESTART. La commande RESTART effacera l\u2019\u00e9tat de test et r\u00e9tablira les param\u00e8tres de vitesse \u00e0 leur valeurs normales.","title":"R\u00e9glage du pressure advance"},{"location":"Pressure_Advance.html#informations-importantes","text":"La valeur d\u2019avance de pression d\u00e9pend de l\u2019extrudeur, de la buse et du filament. Il est courant que les filaments de diff\u00e9rents fabricants ou avec diff\u00e9rents pigments n\u00e9cessitent des valeurs d\u2019avance de pression significativement diff\u00e9rentes. Par cons\u00e9quent, il faut calibrer l\u2019avance de pression sur chaque imprimante et avec chaque bobine de filament. La temp\u00e9rature d\u2019impression et les taux d\u2019extrusion peuvent avoir un impact sur l\u2019avancement de la pression. Assurez-vous de r\u00e9gler la rotation_distance de l'extrudeur et temp\u00e9rature de la buse avant de r\u00e9gler l'avance de pression. L\u2019impression de test est con\u00e7ue pour fonctionner avec un d\u00e9bit d\u2019extrudeur \u00e9lev\u00e9, mais avec des r\u00e9glages de trancheur \u00ab normaux \u00bb. Un d\u00e9bit \u00e9lev\u00e9 est obtenu en utilisant une vitesse d\u2019impression \u00e9lev\u00e9e (par exemple, 100 mm/s) et une hauteur de couche grossi\u00e8re (g\u00e9n\u00e9ralement 75% du diam\u00e8tre de la buse). Les autres param\u00e8tres du segment doivent \u00eatre similaires \u00e0 leurs valeurs par d\u00e9faut (par exemple, p\u00e9rim\u00e8tres de 2 ou 3 lignes, distance de r\u00e9traction normale). Il peut \u00eatre utile de d\u00e9finir la vitesse du p\u00e9rim\u00e8tre externe pour qu\u2019elle soit la m\u00eame que le reste de l\u2019impression, mais ce n\u2019est pas une exigence. Il est fr\u00e9quent que l\u2019impression de test montre un comportement diff\u00e9rent \u00e0 chaque coin. Souvent, le trancheur s\u2019arrange pour changer les couches dans un coin, ce qui peut entra\u00eener une diff\u00e9rence significative entre ce coin et les trois coins restants. Si cela se produit, ignorez ce coin et r\u00e9glez l\u2019avance de pression en utilisant les trois autres coins. Il est \u00e9galement courant que les coins restants varient l\u00e9g\u00e8rement. (Cela peut se produire en raison de petites diff\u00e9rences dans la fa\u00e7on dont le cadre de l\u2019imprimante r\u00e9agit aux virages dans certaines directions.) Essayez de choisir une valeur qui fonctionne bien pour tous les coins restants. En cas de doute, pr\u00e9f\u00e9rez une valeur d\u2019avance de pression inf\u00e9rieure. Si une valeur d'avance de pression \u00e9lev\u00e9e (par exemple sup\u00e9rieure \u00e0 0,200) est utilis\u00e9e, il est possible que l'extrudeur saute lors du retour \u00e0 l'acc\u00e9l\u00e9ration normale de l'imprimante. Le syst\u00e8me d'avance de pression tient compte de la pression en poussant un peu plus de filament pendant l'acc\u00e9l\u00e9ration et en r\u00e9tractant ce filament pendant la d\u00e9c\u00e9l\u00e9ration. Avec une acc\u00e9l\u00e9ration \u00e9lev\u00e9e et une avance \u00e0 haute pression, l'extrudeur peut ne pas avoir assez de couple pour pousser la quantit\u00e9 de filament requise. Si cela se produit, utilisez une valeur d'acc\u00e9l\u00e9ration inf\u00e9rieure ou d\u00e9sactivez l'avance de pression. Une fois que l'avance de pression est r\u00e9gl\u00e9e dans Klipper, il peut toujours \u00eatre utile de configurer une petite valeur de r\u00e9traction dans le trancheur (par exemple, 0,75 mm) et d'utiliser l'option \"essuyer lors de la r\u00e9traction\" du trancheur si elle est disponible. Ces r\u00e9glages du trancheur peuvent aider \u00e0 contrecarrer le suintement caus\u00e9 par la coh\u00e9sion du filament (filament retir\u00e9 de la buse en raison de l'adh\u00e9rence du plastique). Il est recommand\u00e9 de d\u00e9sactiver l'option \"relever le Z lors de la r\u00e9traction\" du trancheur. Le syst\u00e8me d'avance de pression ne modifie pas la synchronisation ou la trajectoire de la t\u00eate. Une impression avec l'avance de pression activ\u00e9e prendra le m\u00eame temps qu'une impression sans avance de pression. L'avance de pression ne modifie pas non plus la quantit\u00e9 totale de filament extrud\u00e9 lors d'une impression. L'avance de pression entra\u00eene un mouvement suppl\u00e9mentaire de l'extrudeur pendant l'acc\u00e9l\u00e9ration et la d\u00e9c\u00e9l\u00e9ration du mouvement. Un r\u00e9glage d'avance de pression tr\u00e8s \u00e9lev\u00e9 entra\u00eenera une tr\u00e8s grande quantit\u00e9 de mouvement de l'extrudeur pendant l'acc\u00e9l\u00e9ration et la d\u00e9c\u00e9l\u00e9ration, et aucun r\u00e9glage de configuration ne limite la quantit\u00e9 de ce mouvement.","title":"Informations importantes"},{"location":"Probe_Calibrate.html","text":"\u00c9talonnage de la sonde \u00b6 Ce document d\u00e9crit la m\u00e9thode de r\u00e9glage des d\u00e9calages X, Y et Z d'une \"sonde z automatique\" dans Klipper. Ceci est utile pour les utilisateurs qui ont une section [probe] ou [bltouch] dans leur fichier de configuration. \u00c9talonnage des d\u00e9calages X et Y de la sonde \u00b6 Pour calibrer le d\u00e9calage X et Y, acc\u00e9dez \u00e0 l'onglet \"Contr\u00f4le\" d'OctoPrint, placez l'imprimante \u00e0 l'origine, puis utilisez les fl\u00e8ches de d\u00e9placement pour amener la t\u00eate vers une position proche du centre du lit. Placez un morceau de ruban adh\u00e9sif bleu (ou similaire) sur le lit sous la sonde. Acc\u00e9dez \u00e0 l'onglet \"Terminal\" d'OctoPrint et lancez une commande PROBE : SONDE Placez une marque sur le ruban directement sous l'endroit o\u00f9 se trouve la sonde (ou utilisez une m\u00e9thode similaire pour noter l'emplacement sur le lit). Ex\u00e9cutez une commande GET_POSITION et enregistrez l'emplacement XY de la t\u00eate d'outil signal\u00e9 par cette commande. Par exemple si l'on voit : Recv: // toolhead: X:46.500000 Y:27.000000 Z:15.000000 E:0.000000 La position d l a sonde serait de 46,5 en X et de 27 en Y. Apr\u00e8s avoir enregistr\u00e9 la position de la sonde, lancez une s\u00e9rie de commandes G1 jusqu'\u00e0 ce que la buse soit directement au-dessus de la marque sur le lit. Par exemple, on pourrait lancer : G1 F300 X57 Y30 Z15 pour d\u00e9placer la buse vers une position X de 57 et Y de 30. Une fois que l'on a trouv\u00e9 la position directement au-dessus de la marque, utilisez la commande GET_POSITION pour afficher cette position. C'est la position de la buse. Le x_offset est alors la nozzle_x_position - probe_x_position et y_offset est de m\u00eame la nozzle_y_position - probe_y_position . Mettez \u00e0 jour le fichier printer.cfg avec les valeurs donn\u00e9es, retirez la bande/les marques du lit, puis \u00e9mettez une commande RESTART afin que les nouvelles valeurs prennent effet. \u00c9talonnage de l'offset Z de la sonde \u00b6 Avoir un z offset pr\u00e9cis est essentiel pour obtenir des impressions de haute qualit\u00e9. Le z_offset est la distance entre la buse et le lit lorsque la sonde se d\u00e9clenche. L'outil Klipper PROBE_CALIBRATE peut \u00eatre utilis\u00e9 pour obtenir cette valeur - il ex\u00e9cutera un sondage automatique pour mesurer la position de d\u00e9clenchement Z de la sonde, puis d\u00e9marrera un sondage manuel pour obtenir la hauteur Z de la buse. Le z_offset sera alors calcul\u00e9e \u00e0 partir de ces mesures. Commencez par mettre l'imprimante \u00e0 l'origine, puis d\u00e9placez la t\u00eate vers une position proche du centre du lit. Acc\u00e9dez \u00e0 l'onglet du terminal OctoPrint et ex\u00e9cutez la commande PROBE_CALIBRATE pour d\u00e9marrer l'outil. Cet outil effectuera un sondage automatique, puis soul\u00e8vera la t\u00eate, d\u00e9placera la buse sur l'emplacement du point de sonde et d\u00e9marrera l'outil de sondage manuel. Si la buse ne se d\u00e9place pas vers une position au-dessus du point de sonde automatique, tapez ABORT pour annuler le sondage manuel et effectuez l'\u00e9talonnage de d\u00e9calage de sonde XY d\u00e9crit ci-dessus. Une fois que l'outil de sondage manuel d\u00e9marre, suivez les \u00e9tapes d\u00e9crites dans \"le test du papier\" ) pour d\u00e9terminer la distance r\u00e9elle entre la buse et le lit \u00e0 l'emplacement donn\u00e9. Une fois ces \u00e9tapes termin\u00e9es, vous pouvez taper ACCEPT pour enregistrer les r\u00e9sultats dans le fichier de configuration avec : SAVE_CONFIG Notez que si une modification est apport\u00e9e au syst\u00e8me de mouvement de l'imprimante, \u00e0 la position de la hotend ou \u00e0 l'emplacement de la sonde, cela invalidera les r\u00e9sultats de PROBE_CALIBRATE. Si la sonde a un d\u00e9calage X ou Y et que l'inclinaison du lit est modifi\u00e9e (par exemple, en ajustant les vis du lit, en ex\u00e9cutant DELTA_CALIBRATE, en ex\u00e9cutant Z_TILT_ADJUST, en ex\u00e9cutant QUAD_GANTRY_LEVEL, ou similaire), les r\u00e9sultats de PROBE_CALIBRATE seront invalid\u00e9s. Apr\u00e8s avoir effectu\u00e9 l'un des ajustements ci-dessus, il sera n\u00e9cessaire d'ex\u00e9cuter \u00e0 nouveau PROBE_CALIBRATE. Si les r\u00e9sultats de PROBE_CALIBRATE sont invalid\u00e9s, tous les r\u00e9sultats pr\u00e9c\u00e9dents bed mesh qui ont \u00e9t\u00e9 obtenus \u00e0 l'aide de la sonde sont \u00e9galement invalid\u00e9s - il sera n\u00e9cessaire de r\u00e9ex\u00e9cuter BED_MESH_CALIBRATE apr\u00e8s avoir recalibr\u00e9 la sonde. Contr\u00f4le de r\u00e9p\u00e9tabilit\u00e9 \u00b6 Apr\u00e8s avoir calibr\u00e9 les d\u00e9calages X, Y et Z de la sonde, il est conseill\u00e9 de v\u00e9rifier que la sonde fournit des r\u00e9sultats reproductibles. Commencez par mettre l'imprimante \u00e0 l'origine, puis d\u00e9placez la t\u00eate vers une position proche du centre du lit. Acc\u00e9dez \u00e0 l'onglet du terminal OctoPrint et ex\u00e9cutez la commande PROBE_ACCURACY . Cette commande ex\u00e9cutera le sondage dix fois et produira une sortie semblable \u00e0 la suivante : Recv: // probe accuracy: at X:0.000 Y:0.000 Z:10.000 Recv: // and read 10 times with speed of 5 mm/s Recv: // probe at -0.003,0.005 is z=2.506948 Recv: // probe at -0.003,0.005 is z=2.519448 Recv: // probe at -0.003,0.005 is z=2.519448 Recv: // probe at -0.003,0.005 is z=2.506948 Recv: // probe at -0.003,0.005 is z=2.519448 Recv: // probe at -0.003,0.005 is z=2.519448 Recv: // probe at -0.003,0.005 is z=2.506948 Recv: // probe at -0.003,0.005 is z=2.506948 Recv: // probe at -0.003,0.005 is z=2.519448 Recv: // probe at -0.003,0.005 is z=2.506948 Recv: // probe accuracy results: maximum 2.519448, minimum 2.506948, range 0.012500, average 2.513198, median 2.513198, standard deviation 0.006250 Id\u00e9alement, l'outil rapportera une valeur maximale et minimale identique. (C'est-\u00e0-dire que, id\u00e9alement, la sonde obtient un r\u00e9sultat identique sur les dix sondes.) Cependant, il est normal que les valeurs minimale et maximale diff\u00e8rent d'une \"distance de pas\" Z ou jusqu'\u00e0 5 microns (0,005 mm). Une \"distance de pas\" est distance_rotation/(full_steps_per_rotation*microsteps) . La distance entre la valeur minimale et la valeur maximale s'appelle la plage. Ainsi, dans l'exemple ci-dessus, \u00e9tant donn\u00e9 que l'imprimante utilise une distance de pas Z de 0,0125, une plage de 0,012500 serait consid\u00e9r\u00e9e comme normale. Si les r\u00e9sultats du test indiquent une plage de valeur sup\u00e9rieure \u00e0 25 microns (0,025 mm), la sonde n'a pas une pr\u00e9cision suffisante pour les proc\u00e9dures de nivellement de lit typiques. Il peut \u00eatre possible de r\u00e9gler la vitesse de la sonde et/ou la hauteur de d\u00e9part de la sonde pour am\u00e9liorer la r\u00e9p\u00e9tabilit\u00e9 de la sonde. La commande PROBE_ACCURACY permet d'ex\u00e9cuter des tests avec diff\u00e9rents param\u00e8tres pour voir leur impact - voir le document G-Codes pour plus de d\u00e9tails. Si la sonde obtient g\u00e9n\u00e9ralement des r\u00e9sultats reproductibles mais pr\u00e9sente une valeur aberrante occasionnelle, il peut \u00eatre possible d'en tenir compte en utilisant plusieurs \u00e9chantillons sur chaque sonde - lisez la description des param\u00e8tres de configuration de la sonde samples dans la r\u00e9f\u00e9rence de configuration pour plus de d\u00e9tails. Si une nouvelle vitesse de sondage, un nouveau nombre d'\u00e9chantillons ou d'autres param\u00e8tres sont n\u00e9cessaires, mettez \u00e0 jour le fichier printer.cfg et lancez une commande RESTART . Si c'est le cas, c'est une bonne id\u00e9e de calibrer le z_offset \u00e0 nouveau. Si des r\u00e9sultats reproductibles ne peuvent pas \u00eatre obtenus, n'utilisez pas la sonde pour le nivellement du lit. Klipper dispose de plusieurs outils de sondage manuels qui peuvent \u00eatre utilis\u00e9s \u00e0 la place - voir le Mise \u00e0 niveau du lit pour plus de d\u00e9tails. V\u00e9rification des erreurs de localisation \u00b6 Certaines sondes peuvent avoir une erreur syst\u00e9mique qui corrompt les r\u00e9sultats de la sonde \u00e0 certains emplacements de la t\u00eate d'outil. Par exemple, si le support de la sonde s'incline l\u00e9g\u00e8rement lorsqu'il se d\u00e9place le long de l'axe Y, la sonde peut alors signaler des r\u00e9sultats fauss\u00e9s \u00e0 diff\u00e9rentes positions Y. Il s'agit d'un probl\u00e8me courant avec les sondes sur les imprimantes delta, mais il peut se produire sur toutes les imprimantes. On peut v\u00e9rifier une erreur d'emplacement en utilisant la commande PROBE_CALIBRATE pour mesurer le d\u00e9calage z_offset de la sonde \u00e0 divers emplacements X et Y. Id\u00e9alement, le z_offset serait une valeur constante \u00e0 chaque emplacement d'imprimante. Pour les imprimantes delta, essayez de mesurer le z_offset \u00e0 une position proche de la tour A, \u00e0 une position proche de la tour B et \u00e0 une position proche de la tour C. Pour les imprimantes cart\u00e9siennes, corexy et similaires, essayez de mesurer le z_offset \u00e0 des positions proches des quatre coins du lit. Avant de commencer ce test, calibrez d'abord les d\u00e9calages X, Y et Z de la sonde comme d\u00e9crit au d\u00e9but de ce document. Remettez ensuite l'imprimante \u00e0 l'origine et naviguez jusqu'\u00e0 la premi\u00e8re position XY. Suivez les \u00e9tapes de calibrer le d\u00e9calage en Z de la sonde en ex\u00e9cutant la commande PROBE_CALIBRATE , les commandes TESTZ et la commande ACCEPT . , mais n'ex\u00e9cutez pas SAVE_CONFIG . Notez le rapport z_offset trouv\u00e9. Naviguez ensuite vers les autres positions XY, r\u00e9p\u00e9tez ces \u00e9tapes PROBE_CALIBRATE et notez le d\u00e9calage z signal\u00e9. Si la diff\u00e9rence entre le d\u00e9calage z_offset minimum signal\u00e9 et le d\u00e9calage z_maximum signal\u00e9 est sup\u00e9rieure \u00e0 25 microns (0,025 mm), la sonde n'est pas adapt\u00e9e aux proc\u00e9dures de nivellement de lit typiques. Voir le document mise \u00e0 niveau du lit pour les alternatives de sonde manuelle. Erreurs de temp\u00e9rature \u00b6 De nombreuses sondes ont une erreur syst\u00e9mique lorsqu'elles sondent \u00e0 diff\u00e9rentes temp\u00e9ratures. Par exemple, la sonde peut se d\u00e9clencher syst\u00e9matiquement \u00e0 une hauteur inf\u00e9rieure lorsque la sonde est \u00e0 une temp\u00e9rature plus \u00e9lev\u00e9e. Il est recommand\u00e9 de faire fonctionner les outils de nivellement du lit \u00e0 une temp\u00e9rature constante pour tenir compte de cette erreur. Par exemple, ex\u00e9cutez toujours les outils lorsque l'imprimante est \u00e0 temp\u00e9rature ambiante ou ex\u00e9cutez toujours les outils une fois que l'imprimante a obtenu une temp\u00e9rature d'impression constante. Dans les deux cas, c'est une bonne id\u00e9e d'attendre plusieurs minutes apr\u00e8s que la temp\u00e9rature souhait\u00e9e est atteinte, de sorte que l'appareil d'impression soit constamment \u00e0 la temp\u00e9rature souhait\u00e9e. Pour v\u00e9rifier une erreur de temp\u00e9rature, commencez avec l'imprimante \u00e0 temp\u00e9rature ambiante, puis mettez l'imprimante \u00e0 l'origine, d\u00e9placez la t\u00eate vers une position proche du centre du lit et ex\u00e9cutez la commande PROBE_ACCURACY . Notez les r\u00e9sultats. Ensuite, sans mise \u00e0 l'origine ou d\u00e9sactiver les moteurs pas \u00e0 pas, chauffez la buse et le lit de l'imprimante \u00e0 la temp\u00e9rature d'impression, puis ex\u00e9cutez \u00e0 nouveau la commande PROBE_ACCURACY . Id\u00e9alement, la commande rapportera des r\u00e9sultats identiques. Comme ci-dessus, si la sonde a un d\u00e9calage en temp\u00e9rature, veillez \u00e0 toujours utiliser la sonde \u00e0 une temp\u00e9rature constante.","title":"\u00c9talonnage de la sonde"},{"location":"Probe_Calibrate.html#etalonnage-de-la-sonde","text":"Ce document d\u00e9crit la m\u00e9thode de r\u00e9glage des d\u00e9calages X, Y et Z d'une \"sonde z automatique\" dans Klipper. Ceci est utile pour les utilisateurs qui ont une section [probe] ou [bltouch] dans leur fichier de configuration.","title":"\u00c9talonnage de la sonde"},{"location":"Probe_Calibrate.html#etalonnage-des-decalages-x-et-y-de-la-sonde","text":"Pour calibrer le d\u00e9calage X et Y, acc\u00e9dez \u00e0 l'onglet \"Contr\u00f4le\" d'OctoPrint, placez l'imprimante \u00e0 l'origine, puis utilisez les fl\u00e8ches de d\u00e9placement pour amener la t\u00eate vers une position proche du centre du lit. Placez un morceau de ruban adh\u00e9sif bleu (ou similaire) sur le lit sous la sonde. Acc\u00e9dez \u00e0 l'onglet \"Terminal\" d'OctoPrint et lancez une commande PROBE : SONDE Placez une marque sur le ruban directement sous l'endroit o\u00f9 se trouve la sonde (ou utilisez une m\u00e9thode similaire pour noter l'emplacement sur le lit). Ex\u00e9cutez une commande GET_POSITION et enregistrez l'emplacement XY de la t\u00eate d'outil signal\u00e9 par cette commande. Par exemple si l'on voit : Recv: // toolhead: X:46.500000 Y:27.000000 Z:15.000000 E:0.000000 La position d l a sonde serait de 46,5 en X et de 27 en Y. Apr\u00e8s avoir enregistr\u00e9 la position de la sonde, lancez une s\u00e9rie de commandes G1 jusqu'\u00e0 ce que la buse soit directement au-dessus de la marque sur le lit. Par exemple, on pourrait lancer : G1 F300 X57 Y30 Z15 pour d\u00e9placer la buse vers une position X de 57 et Y de 30. Une fois que l'on a trouv\u00e9 la position directement au-dessus de la marque, utilisez la commande GET_POSITION pour afficher cette position. C'est la position de la buse. Le x_offset est alors la nozzle_x_position - probe_x_position et y_offset est de m\u00eame la nozzle_y_position - probe_y_position . Mettez \u00e0 jour le fichier printer.cfg avec les valeurs donn\u00e9es, retirez la bande/les marques du lit, puis \u00e9mettez une commande RESTART afin que les nouvelles valeurs prennent effet.","title":"\u00c9talonnage des d\u00e9calages X et Y de la sonde"},{"location":"Probe_Calibrate.html#etalonnage-de-loffset-z-de-la-sonde","text":"Avoir un z offset pr\u00e9cis est essentiel pour obtenir des impressions de haute qualit\u00e9. Le z_offset est la distance entre la buse et le lit lorsque la sonde se d\u00e9clenche. L'outil Klipper PROBE_CALIBRATE peut \u00eatre utilis\u00e9 pour obtenir cette valeur - il ex\u00e9cutera un sondage automatique pour mesurer la position de d\u00e9clenchement Z de la sonde, puis d\u00e9marrera un sondage manuel pour obtenir la hauteur Z de la buse. Le z_offset sera alors calcul\u00e9e \u00e0 partir de ces mesures. Commencez par mettre l'imprimante \u00e0 l'origine, puis d\u00e9placez la t\u00eate vers une position proche du centre du lit. Acc\u00e9dez \u00e0 l'onglet du terminal OctoPrint et ex\u00e9cutez la commande PROBE_CALIBRATE pour d\u00e9marrer l'outil. Cet outil effectuera un sondage automatique, puis soul\u00e8vera la t\u00eate, d\u00e9placera la buse sur l'emplacement du point de sonde et d\u00e9marrera l'outil de sondage manuel. Si la buse ne se d\u00e9place pas vers une position au-dessus du point de sonde automatique, tapez ABORT pour annuler le sondage manuel et effectuez l'\u00e9talonnage de d\u00e9calage de sonde XY d\u00e9crit ci-dessus. Une fois que l'outil de sondage manuel d\u00e9marre, suivez les \u00e9tapes d\u00e9crites dans \"le test du papier\" ) pour d\u00e9terminer la distance r\u00e9elle entre la buse et le lit \u00e0 l'emplacement donn\u00e9. Une fois ces \u00e9tapes termin\u00e9es, vous pouvez taper ACCEPT pour enregistrer les r\u00e9sultats dans le fichier de configuration avec : SAVE_CONFIG Notez que si une modification est apport\u00e9e au syst\u00e8me de mouvement de l'imprimante, \u00e0 la position de la hotend ou \u00e0 l'emplacement de la sonde, cela invalidera les r\u00e9sultats de PROBE_CALIBRATE. Si la sonde a un d\u00e9calage X ou Y et que l'inclinaison du lit est modifi\u00e9e (par exemple, en ajustant les vis du lit, en ex\u00e9cutant DELTA_CALIBRATE, en ex\u00e9cutant Z_TILT_ADJUST, en ex\u00e9cutant QUAD_GANTRY_LEVEL, ou similaire), les r\u00e9sultats de PROBE_CALIBRATE seront invalid\u00e9s. Apr\u00e8s avoir effectu\u00e9 l'un des ajustements ci-dessus, il sera n\u00e9cessaire d'ex\u00e9cuter \u00e0 nouveau PROBE_CALIBRATE. Si les r\u00e9sultats de PROBE_CALIBRATE sont invalid\u00e9s, tous les r\u00e9sultats pr\u00e9c\u00e9dents bed mesh qui ont \u00e9t\u00e9 obtenus \u00e0 l'aide de la sonde sont \u00e9galement invalid\u00e9s - il sera n\u00e9cessaire de r\u00e9ex\u00e9cuter BED_MESH_CALIBRATE apr\u00e8s avoir recalibr\u00e9 la sonde.","title":"\u00c9talonnage de l'offset Z de la sonde"},{"location":"Probe_Calibrate.html#controle-de-repetabilite","text":"Apr\u00e8s avoir calibr\u00e9 les d\u00e9calages X, Y et Z de la sonde, il est conseill\u00e9 de v\u00e9rifier que la sonde fournit des r\u00e9sultats reproductibles. Commencez par mettre l'imprimante \u00e0 l'origine, puis d\u00e9placez la t\u00eate vers une position proche du centre du lit. Acc\u00e9dez \u00e0 l'onglet du terminal OctoPrint et ex\u00e9cutez la commande PROBE_ACCURACY . Cette commande ex\u00e9cutera le sondage dix fois et produira une sortie semblable \u00e0 la suivante : Recv: // probe accuracy: at X:0.000 Y:0.000 Z:10.000 Recv: // and read 10 times with speed of 5 mm/s Recv: // probe at -0.003,0.005 is z=2.506948 Recv: // probe at -0.003,0.005 is z=2.519448 Recv: // probe at -0.003,0.005 is z=2.519448 Recv: // probe at -0.003,0.005 is z=2.506948 Recv: // probe at -0.003,0.005 is z=2.519448 Recv: // probe at -0.003,0.005 is z=2.519448 Recv: // probe at -0.003,0.005 is z=2.506948 Recv: // probe at -0.003,0.005 is z=2.506948 Recv: // probe at -0.003,0.005 is z=2.519448 Recv: // probe at -0.003,0.005 is z=2.506948 Recv: // probe accuracy results: maximum 2.519448, minimum 2.506948, range 0.012500, average 2.513198, median 2.513198, standard deviation 0.006250 Id\u00e9alement, l'outil rapportera une valeur maximale et minimale identique. (C'est-\u00e0-dire que, id\u00e9alement, la sonde obtient un r\u00e9sultat identique sur les dix sondes.) Cependant, il est normal que les valeurs minimale et maximale diff\u00e8rent d'une \"distance de pas\" Z ou jusqu'\u00e0 5 microns (0,005 mm). Une \"distance de pas\" est distance_rotation/(full_steps_per_rotation*microsteps) . La distance entre la valeur minimale et la valeur maximale s'appelle la plage. Ainsi, dans l'exemple ci-dessus, \u00e9tant donn\u00e9 que l'imprimante utilise une distance de pas Z de 0,0125, une plage de 0,012500 serait consid\u00e9r\u00e9e comme normale. Si les r\u00e9sultats du test indiquent une plage de valeur sup\u00e9rieure \u00e0 25 microns (0,025 mm), la sonde n'a pas une pr\u00e9cision suffisante pour les proc\u00e9dures de nivellement de lit typiques. Il peut \u00eatre possible de r\u00e9gler la vitesse de la sonde et/ou la hauteur de d\u00e9part de la sonde pour am\u00e9liorer la r\u00e9p\u00e9tabilit\u00e9 de la sonde. La commande PROBE_ACCURACY permet d'ex\u00e9cuter des tests avec diff\u00e9rents param\u00e8tres pour voir leur impact - voir le document G-Codes pour plus de d\u00e9tails. Si la sonde obtient g\u00e9n\u00e9ralement des r\u00e9sultats reproductibles mais pr\u00e9sente une valeur aberrante occasionnelle, il peut \u00eatre possible d'en tenir compte en utilisant plusieurs \u00e9chantillons sur chaque sonde - lisez la description des param\u00e8tres de configuration de la sonde samples dans la r\u00e9f\u00e9rence de configuration pour plus de d\u00e9tails. Si une nouvelle vitesse de sondage, un nouveau nombre d'\u00e9chantillons ou d'autres param\u00e8tres sont n\u00e9cessaires, mettez \u00e0 jour le fichier printer.cfg et lancez une commande RESTART . Si c'est le cas, c'est une bonne id\u00e9e de calibrer le z_offset \u00e0 nouveau. Si des r\u00e9sultats reproductibles ne peuvent pas \u00eatre obtenus, n'utilisez pas la sonde pour le nivellement du lit. Klipper dispose de plusieurs outils de sondage manuels qui peuvent \u00eatre utilis\u00e9s \u00e0 la place - voir le Mise \u00e0 niveau du lit pour plus de d\u00e9tails.","title":"Contr\u00f4le de r\u00e9p\u00e9tabilit\u00e9"},{"location":"Probe_Calibrate.html#verification-des-erreurs-de-localisation","text":"Certaines sondes peuvent avoir une erreur syst\u00e9mique qui corrompt les r\u00e9sultats de la sonde \u00e0 certains emplacements de la t\u00eate d'outil. Par exemple, si le support de la sonde s'incline l\u00e9g\u00e8rement lorsqu'il se d\u00e9place le long de l'axe Y, la sonde peut alors signaler des r\u00e9sultats fauss\u00e9s \u00e0 diff\u00e9rentes positions Y. Il s'agit d'un probl\u00e8me courant avec les sondes sur les imprimantes delta, mais il peut se produire sur toutes les imprimantes. On peut v\u00e9rifier une erreur d'emplacement en utilisant la commande PROBE_CALIBRATE pour mesurer le d\u00e9calage z_offset de la sonde \u00e0 divers emplacements X et Y. Id\u00e9alement, le z_offset serait une valeur constante \u00e0 chaque emplacement d'imprimante. Pour les imprimantes delta, essayez de mesurer le z_offset \u00e0 une position proche de la tour A, \u00e0 une position proche de la tour B et \u00e0 une position proche de la tour C. Pour les imprimantes cart\u00e9siennes, corexy et similaires, essayez de mesurer le z_offset \u00e0 des positions proches des quatre coins du lit. Avant de commencer ce test, calibrez d'abord les d\u00e9calages X, Y et Z de la sonde comme d\u00e9crit au d\u00e9but de ce document. Remettez ensuite l'imprimante \u00e0 l'origine et naviguez jusqu'\u00e0 la premi\u00e8re position XY. Suivez les \u00e9tapes de calibrer le d\u00e9calage en Z de la sonde en ex\u00e9cutant la commande PROBE_CALIBRATE , les commandes TESTZ et la commande ACCEPT . , mais n'ex\u00e9cutez pas SAVE_CONFIG . Notez le rapport z_offset trouv\u00e9. Naviguez ensuite vers les autres positions XY, r\u00e9p\u00e9tez ces \u00e9tapes PROBE_CALIBRATE et notez le d\u00e9calage z signal\u00e9. Si la diff\u00e9rence entre le d\u00e9calage z_offset minimum signal\u00e9 et le d\u00e9calage z_maximum signal\u00e9 est sup\u00e9rieure \u00e0 25 microns (0,025 mm), la sonde n'est pas adapt\u00e9e aux proc\u00e9dures de nivellement de lit typiques. Voir le document mise \u00e0 niveau du lit pour les alternatives de sonde manuelle.","title":"V\u00e9rification des erreurs de localisation"},{"location":"Probe_Calibrate.html#erreurs-de-temperature","text":"De nombreuses sondes ont une erreur syst\u00e9mique lorsqu'elles sondent \u00e0 diff\u00e9rentes temp\u00e9ratures. Par exemple, la sonde peut se d\u00e9clencher syst\u00e9matiquement \u00e0 une hauteur inf\u00e9rieure lorsque la sonde est \u00e0 une temp\u00e9rature plus \u00e9lev\u00e9e. Il est recommand\u00e9 de faire fonctionner les outils de nivellement du lit \u00e0 une temp\u00e9rature constante pour tenir compte de cette erreur. Par exemple, ex\u00e9cutez toujours les outils lorsque l'imprimante est \u00e0 temp\u00e9rature ambiante ou ex\u00e9cutez toujours les outils une fois que l'imprimante a obtenu une temp\u00e9rature d'impression constante. Dans les deux cas, c'est une bonne id\u00e9e d'attendre plusieurs minutes apr\u00e8s que la temp\u00e9rature souhait\u00e9e est atteinte, de sorte que l'appareil d'impression soit constamment \u00e0 la temp\u00e9rature souhait\u00e9e. Pour v\u00e9rifier une erreur de temp\u00e9rature, commencez avec l'imprimante \u00e0 temp\u00e9rature ambiante, puis mettez l'imprimante \u00e0 l'origine, d\u00e9placez la t\u00eate vers une position proche du centre du lit et ex\u00e9cutez la commande PROBE_ACCURACY . Notez les r\u00e9sultats. Ensuite, sans mise \u00e0 l'origine ou d\u00e9sactiver les moteurs pas \u00e0 pas, chauffez la buse et le lit de l'imprimante \u00e0 la temp\u00e9rature d'impression, puis ex\u00e9cutez \u00e0 nouveau la commande PROBE_ACCURACY . Id\u00e9alement, la commande rapportera des r\u00e9sultats identiques. Comme ci-dessus, si la sonde a un d\u00e9calage en temp\u00e9rature, veillez \u00e0 toujours utiliser la sonde \u00e0 une temp\u00e9rature constante.","title":"Erreurs de temp\u00e9rature"},{"location":"Protocol.html","text":"Protocole \u00b6 Le protocole de messagerie Klipper est utilis\u00e9 pour la communication de bas niveau entre le logiciel h\u00f4te Klipper et le logiciel du microcontr\u00f4leur Klipper. \u00c0 un niveau \u00e9lev\u00e9, le protocole peut \u00eatre consid\u00e9r\u00e9 comme une s\u00e9rie de cha\u00eenes de commandes et de r\u00e9ponses qui sont compress\u00e9es, transmises, puis trait\u00e9es du c\u00f4t\u00e9 r\u00e9ception. Un exemple d'une s\u00e9ries de commandes dans un format non compress\u00e9 lisible par l'homme pourrait ressembler \u00e0 : set_digital_out pin=PA3 value=1 set_digital_out pin=PA7 value=1 schedule_digital_out oid=8 clock=4000000 value=0 queue_step oid=7 interval=7458 count=10 add=331 queue_step oid=7 interval=11717 count=4 add=1281 Consultez le document commandes mcu pour plus d'informations sur les commandes disponibles. Voir le document deboguage pour plus d'informations sur la fa\u00e7on de traduire un fichier G-Code en commandes de microcontr\u00f4leur lisibles. Cette page fournit une description de haut niveau du protocole de communication de Klipper lui-m\u00eame. Il d\u00e9crit comment les messages sont d\u00e9clar\u00e9s, cod\u00e9s au format binaire (le sch\u00e9ma de \"compression\") et transmis. L'objectif du protocole est de permettre un canal de communication sans erreur entre l'h\u00f4te et le microcontr\u00f4leur qui soit \u00e0 faible latence, \u00e0 faible bande passante et \u00e0 faible complexit\u00e9 pour le microcontr\u00f4leur. Interface du micro-contr\u00f4leur \u00b6 Le protocole de transmission Klipper peut \u00eatre consid\u00e9r\u00e9 comme un m\u00e9canisme Appel de proc\u00e9dure \u00e0 distance entre le micro-contr\u00f4leur et l'h\u00f4te. Le logiciel du microcontr\u00f4leur d\u00e9clare les commandes que l'h\u00f4te peut invoquer ainsi que les messages de r\u00e9ponse qu'il peut g\u00e9n\u00e9rer. L'h\u00f4te utilise ces informations pour ordonner au microcontr\u00f4leur d'effectuer des actions et d'interpr\u00e9ter les r\u00e9sultats. D\u00e9claration des commandes \u00b6 Le logiciel du microcontr\u00f4leur d\u00e9clare une \"commande\" en utilisant la macro DECL_COMMAND() dans le code C. Par exemple\u202f: DECL_COMMAND(command_update_digital_out, \"update_digital_out oid=%c value=%c\"); Ce qui pr\u00e9c\u00e8de d\u00e9clare une commande nomm\u00e9e \"update_digital_out\". Cela permet \u00e0 l'h\u00f4te \"d'appeler\" cette commande qui entra\u00eenerait l'ex\u00e9cution de la fonction C command_update_digital_out() dans le microcontr\u00f4leur. Ce qui pr\u00e9c\u00e8de indique \u00e9galement que la commande prend deux param\u00e8tres entiers. Lorsque le code C command_update_digital_out() est ex\u00e9cut\u00e9, un tableau contenant ces deux entiers lui sera transmis - le premier correspondant \u00e0 'oid' et le second correspondant \u00e0 'value'. En g\u00e9n\u00e9ral, les param\u00e8tres sont d\u00e9crits avec une syntaxe de style printf() (par exemple, \"%u\"). Le formatage correspond directement \u00e0 une vue \"lisible\" des commandes (par exemple, \"update_digital_out oid=7 value=1\"). Dans l'exemple ci-dessus, \"value=\" est un nom de param\u00e8tre et \"%c\" indique que le param\u00e8tre est un entier. En interne, le nom du param\u00e8tre n'est utilis\u00e9 que comme documentation. Dans cet exemple, le \"%c\" est \u00e9galement utilis\u00e9 comme documentation pour indiquer que l'entier attendu a une taille de 1 octet (la taille de l'entier d\u00e9clar\u00e9 n'a pas d'impact sur l'analyse ou l'encodage). La construction du micrologiciel du microcontr\u00f4leur collectera toutes les commandes d\u00e9clar\u00e9es avec DECL_COMMAND(), d\u00e9terminera leurs param\u00e8tres et s'arrangera pour qu'elles soient appelables. D\u00e9claration des r\u00e9ponses \u00b6 Pour envoyer des informations du microcontr\u00f4leur \u00e0 l'h\u00f4te, des \"r\u00e9ponses\" sont g\u00e9n\u00e9r\u00e9es. Celles-ci sont \u00e0 la fois d\u00e9clar\u00e9es et transmises \u00e0 l'aide de la macro C sendf(). Par example\u202f: sendf(\"status clock=%u status=%c\", sched_read_time(), sched_is_shutdown()); Ce qui pr\u00e9c\u00e8de transmet un message de r\u00e9ponse \"status\" qui contient deux param\u00e8tres entiers (\"clock\" et \"status\"). La construction du microcontr\u00f4leur trouve automatiquement tous les appels sendf() et g\u00e9n\u00e8re des encodeurs pour eux. Le premier param\u00e8tre de la fonction sendf() d\u00e9crit la r\u00e9ponse et il est dans le m\u00eame format que les d\u00e9clarations de commande. L'h\u00f4te peut enregistrer une fonction de rappel pour chaque r\u00e9ponse. Ainsi, les commandes permettent \u00e0 l'h\u00f4te d'invoquer des fonctions C dans le microcontr\u00f4leur et les r\u00e9ponses permettent au logiciel du microcontr\u00f4leur d'invoquer du code dans l'h\u00f4te. La macro sendf() ne doit \u00eatre appel\u00e9e qu'\u00e0 partir de commandes ou de gestionnaires de t\u00e2ches, et elle ne doit pas \u00eatre appel\u00e9e \u00e0 partir d'interruptions ou de timers. Le code n'a pas besoin d'\u00e9mettre un sendf() en r\u00e9ponse \u00e0 une commande re\u00e7ue, le nombre d'appels \u00e0 sendf() n'est pas limi\u00e9, et il est possible d'appeler sendf() \u00e0 tout moment \u00e0 partir d'un gestionnaire de t\u00e2ches. R\u00e9ponses de sortie \u00b6 Pour simplifier le d\u00e9bogage, il existe \u00e9galement une fonction C output(). Par exemple\u202f: output(\"La valeur de %u est %s avec une taille de %u.\", x, buf, buf_len); La fonction output() est similaire \u00e0 printf() - elle est destin\u00e9e \u00e0 g\u00e9n\u00e9rer et formater des messages de d\u00e9bogage avec un affichage dans un format compr\u00e9hensible (ndt : par un humain normalement constitu\u00e9 :-)). D\u00e9clarer des \u00e9num\u00e9rations \u00b6 Les \u00e9num\u00e9rations permettent au code h\u00f4te d'utiliser des identificateurs de type cha\u00eene pour des param\u00e8tres que le microcontr\u00f4leur g\u00e8re comme des entiers. Ils sont d\u00e9clar\u00e9s dans le code du microcontr\u00f4leur - par exemple : DECL_ENUMERATION(\"spi_bus\", \"spi\", 0); DECL_ENUMERATION_RANGE(\"pin\", \"PC0\", 16, 8); Dans le premier exemple, la macro DECL_ENUMERATION() d\u00e9finit une \u00e9num\u00e9ration pour les messages de commande/r\u00e9ponse avec un nom de param\u00e8tre \"spi_bus\" ou un nom de param\u00e8tre avec un suffixe \"_spi_bus\". Pour ces param\u00e8tres, la cha\u00eene \"spi\" sera une valeur valide et elle sera transmise comme une valeur enti\u00e8re \u00e9gale \u00e0 z\u00e9ro. Il est \u00e9galement possible de d\u00e9clarer une plage d'\u00e9num\u00e9ration. Dans le deuxi\u00e8me exemple, un param\u00e8tre \"pin\" (ou tout param\u00e8tre avec le suffixe \"_pin\") accepterait PC0, PC1, PC2, ..., PC7 comme valeurs valides. Les cha\u00eenes seront transmises comme des entiers 16, 17, 18, ..., 23. D\u00e9claration de constantes \u00b6 Les constantes peuvent \u00eatre export\u00e9es. Par exemple, les \u00e9l\u00e9ments suivants : DECL_CONSTANT(\"SERIAL_BAUD\", 250000); exporterait une constante nomm\u00e9e \"SERIAL_BAUD\" avec une valeur de 250000 du microcontr\u00f4leur vers l'h\u00f4te. Il est \u00e9galement possible de d\u00e9clarer une constante de type cha\u00eene - par exemple : DECL_CONSTANT_STR(\"MCU\", \"pru\"); Encodage des message de bas niveau \u00b6 Pour accomplir le m\u00e9canisme \"RPC\" ci-dessus, chaque commandes et r\u00e9ponses sont cod\u00e9es dans un format binaire pour la transmission. Cette section d\u00e9crit le syst\u00e8me de transmission. Blocs de message \u00b6 Toutes les donn\u00e9es envoy\u00e9es de l'h\u00f4te au microcontr\u00f4leur et vice-versa sont contenues dans des \"blocs de message\". Un bloc de message a un en-t\u00eate de deux octets et une fin de trois octets. Le format d'un bloc de message est : <1 byte length><1 byte sequence><n-byte content><2 byte crc><1 byte sync> L'octet de longueur contient le nombre d'octets dans le bloc de message, y compris les octets d'en-t\u00eate et de fin (la longueur minimale du message est donc de 5 octets). La longueur maximale d'un bloc de message est de 64 octets. L'octet de s\u00e9quence contient un num\u00e9ro de s\u00e9quence de 4 bits dans les bits de poids faible et les bits de poids fort contiennent toujours 0x10 (les bits de poids fort sont r\u00e9serv\u00e9s pour une utilisation future). Les octets de contenu contiennent les donn\u00e9es du message et leur format est d\u00e9crit dans la section suivante. Les octets crc contiennent un CCITT CRC 16 bits du bloc de message incluant les octets d'en-t\u00eate mais excluant les octets de fin. L'octet de synchronisation est 0x7e. Le format du bloc de message est inspir\u00e9 des trames de message HDLC . Comme dans HDLC, le bloc de message peut \u00e9ventuellement contenir un caract\u00e8re de synchronisation suppl\u00e9mentaire au d\u00e9but du bloc. Contrairement \u00e0 HDLC, un caract\u00e8re de synchronisation n'est pas propre au header et peut \u00eatre pr\u00e9sent dans le contenu du bloc de message. Contenu du bloc de message \u00b6 Chaque bloc de message envoy\u00e9 de l'h\u00f4te au microcontr\u00f4leur contient une s\u00e9rie de z\u00e9ro ou plusieurs commandes de message dans son contenu. Chaque commande commence par une Quantit\u00e9 de longueur variable (VLQ) encod\u00e9 entier command-id suivi de z\u00e9ro ou plusieurs param\u00e8tres VLQ pour la commande donn\u00e9e. Par exemple, les quatre commandes suivantes peuvent \u00eatre plac\u00e9es dans un seul bloc de message : update_digital_out oid=6 value=1 update_digital_out oid=5 value=0 get_config get_clock et cod\u00e9 dans les huit entiers VLQ suivants : <id_update_digital_out><6><1><id_update_digital_out><5><0><id_get_config><id_get_clock> Afin d'encoder et d'analyser le contenu du message, l'h\u00f4te et le microcontr\u00f4leur doivent s'accorder sur les identifiants de commande et le nombre de param\u00e8tres de chaque commande. Ainsi, dans l'exemple ci-dessus, l'h\u00f4te et le microcontr\u00f4leur savent que \"id_update_digital_out\" est toujours suivi de deux param\u00e8tres, et \"id_get_config\" et \"id_get_clock\" n'ont aucun param\u00e8tre. L'h\u00f4te et le microcontr\u00f4leur partagent un \"dictionnaire de donn\u00e9es\" qui mappe les descriptions de commande (par exemple, \"update_digital_out oid=%c value=%c\") \u00e0 leurs identifiants de commande \"entiers\". Lors du traitement des donn\u00e9es, l'analyseur saura s'attendre \u00e0 un nombre sp\u00e9cifique de param\u00e8tres cod\u00e9s VLQ apr\u00e8s un identifiant de commande donn\u00e9. Le contenu des messages pour les blocs envoy\u00e9s du microcontr\u00f4leur \u00e0 l'h\u00f4te suit le m\u00eame format. Les identifiants de ces messages sont des \"identifiants de r\u00e9ponse\", mais ils ont le m\u00eame objectif et suivent les m\u00eames r\u00e8gles de codage. En pratique, les blocs de message envoy\u00e9s du microcontr\u00f4leur \u00e0 l'h\u00f4te ne contiennent jamais plus d'une r\u00e9ponse dans le contenu du bloc de message. Quantit\u00e9s de longueur variable \u00b6 Voir l' article wikipedia sur les VLQ pour plus d'informations sur le format g\u00e9n\u00e9ral des entiers cod\u00e9s VLQ. Klipper utilise un sch\u00e9ma de codage qui prend en charge les entiers positifs et n\u00e9gatifs. Les entiers proches de z\u00e9ro utilisent moins d'octets pour coder et les entiers positifs cod\u00e9s utilisent moins d'octets - en g\u00e9n\u00e9ral - que les entiers n\u00e9gatifs. Le tableau suivant indique le nombre d'octets n\u00e9cessaires \u00e0 l'encodage de chaque entier : Integer Taille encod\u00e9e -32 .. 95 1 -4096 .. 12287 2 -524288 .. 1572863 3 -67108864 .. 201326591 4 -2147483648 .. 4294967295 5 Cha\u00eenes de longueur variable \u00b6 Une exception aux r\u00e8gles de codage ci-dessus, si le param\u00e8tre d'une commande ou d'une r\u00e9ponse est une cha\u00eene dynamique, le param\u00e8tre n'est pas cod\u00e9 comme un simple entier VLQ. Au lieu de cela, il est cod\u00e9 en transmettant la longueur sous la forme d'un entier cod\u00e9 VLQ suivi du contenu de la cha\u00eene lui-m\u00eame : <VLQ encoded length><n-byte contents> Les descriptions de commande trouv\u00e9es dans le dictionnaire de donn\u00e9es permettent \u00e0 la fois \u00e0 l'h\u00f4te et au microcontr\u00f4leur de savoir quels param\u00e8tres de commande utilisent un codage VLQ simple et quels param\u00e8tres utilisent un codage de cha\u00eene. Dictionnaire de donn\u00e9es \u00b6 Pour que des communications significatives soient \u00e9tablies entre le microcontr\u00f4leur et l'h\u00f4te, les deux parties doivent s'entendre sur un \"dictionnaire de donn\u00e9es\". Ce dictionnaire de donn\u00e9es contient les identificateurs entiers des commandes et des r\u00e9ponses ainsi que leurs descriptions. La construction du micrologiciel du microcontr\u00f4leur utilise le contenu des macros DECL_COMMAND() et sendf() pour g\u00e9n\u00e9rer le dictionnaire de donn\u00e9es. La construction attribue automatiquement des identifiants uniques \u00e0 chaque commande et r\u00e9ponse. Ce syst\u00e8me permet \u00e0 la fois au code h\u00f4te et au code du microcontr\u00f4leur d'utiliser de mani\u00e8re transparente des noms descriptifs lisibles par l'homme tout en utilisant une bande passante minimale. L'h\u00f4te interroge le dictionnaire de donn\u00e9es lors de sa premi\u00e8re connexion au microcontr\u00f4leur. Une fois que l'h\u00f4te a t\u00e9l\u00e9charg\u00e9 le dictionnaire de donn\u00e9es du microcontr\u00f4leur, il utilise ce dictionnaire de donn\u00e9es pour coder toutes les commandes et analyser toutes les r\u00e9ponses du microcontr\u00f4leur. L'h\u00f4te doit donc g\u00e9rer un dictionnaire de donn\u00e9es dynamique. Cependant, pour garder le logiciel du microcontr\u00f4leur simple, le microcontr\u00f4leur utilise - lui - toujours son dictionnaire de donn\u00e9es statique (compil\u00e9). Le dictionnaire de donn\u00e9es est demand\u00e9 en envoyant des commandes \"identify\" au microcontr\u00f4leur. Le microcontr\u00f4leur r\u00e9pond \u00e0 chaque commande d'identification par un message \"identifier_response\". \u00c9tant donn\u00e9 que ces deux commandes sont n\u00e9cessaires avant d'obtenir le dictionnaire de donn\u00e9es, leurs identifiants entiers et leurs types de param\u00e8tres sont cod\u00e9s en dur \u00e0 la fois dans le microcontr\u00f4leur et dans l'h\u00f4te. L'identifiant de r\u00e9ponse \"identifier_response\" est 0, l'identifiant de commande \"identify\" est 1. En plus d'avoir des identifiants cod\u00e9s en dur, la commande d'identification et sa r\u00e9ponse sont d\u00e9clar\u00e9es et transmises de la m\u00eame mani\u00e8re que les autres commandes et r\u00e9ponses. Aucune autre commande ou r\u00e9ponse n'est cod\u00e9e en dur. Le format du dictionnaire de donn\u00e9es transmis est une cha\u00eene JSON compress\u00e9e zlib. Le processus de construction du microcontr\u00f4leur g\u00e9n\u00e8re la cha\u00eene, la comprime et la stocke dans la section texte du flash du microcontr\u00f4leur. Le dictionnaire de donn\u00e9es peut \u00eatre beaucoup plus grand que la taille maximale du bloc de message - l'h\u00f4te le t\u00e9l\u00e9charge en envoyant plusieurs commandes d'identification demandant des blocs progressifs du dictionnaire de donn\u00e9es. Une fois que tous les morceaux sont obtenus, l'h\u00f4te r\u00e9assemble les morceaux, d\u00e9compresse les donn\u00e9es et analyse le contenu. En plus des informations sur le protocole de communication, le dictionnaire de donn\u00e9es contient \u00e9galement la version du logiciel, les \u00e9num\u00e9rations (telles que d\u00e9finies par DECL_ENUMERATION) et les constantes (telles que d\u00e9finies par DECL_CONSTANT). Flux de messages \u00b6 Les message de commande envoy\u00e9es de l'h\u00f4te au microcontr\u00f4leur sont cens\u00e9es \u00eatre sans erreur. Le microcontr\u00f4leur v\u00e9rifiera le CRC et les num\u00e9ros de s\u00e9quence dans chaque bloc de message pour s'assurer que les commandes sont exactes et dans l'ordre. Le microcontr\u00f4leur traite toujours les blocs de message dans l'ordre - s'il re\u00e7oit un bloc dans le d\u00e9sordre, il le rejettera ainsi que tout autre bloc dans le d\u00e9sordre jusqu'\u00e0 ce qu'il re\u00e7oive des blocs avec le bon s\u00e9quencement. Le code de bas niveau de l'h\u00f4te impl\u00e9mente un syst\u00e8me de retransmission automatique des blocs de messages perdus ou corrompus envoy\u00e9s au microcontr\u00f4leur. Pour faciliter cela, le microcontr\u00f4leur transmet un \"bloc de message ack\" apr\u00e8s chaque bloc de message re\u00e7u avec succ\u00e8s. L'h\u00f4te planifie un d\u00e9lai apr\u00e8s l'envoi de chaque bloc et il retransmettra si le d\u00e9lai expire sans recevoir de \"ack\" correspondant. De plus, si le microcontr\u00f4leur d\u00e9tecte un bloc corrompu ou dans le d\u00e9sordre, il peut transmettre un \"bloc de message nak\" pour faciliter une retransmission rapide. Un \"ack\" est un bloc de message avec un contenu vide (c'est-\u00e0-dire un bloc de message de 5 octets) et un num\u00e9ro de s\u00e9quence sup\u00e9rieur au dernier num\u00e9ro de s\u00e9quence d'h\u00f4te re\u00e7u. Un \"nak\" est un bloc de message avec un contenu vide et un num\u00e9ro de s\u00e9quence inf\u00e9rieur au dernier num\u00e9ro de s\u00e9quence d'h\u00f4te re\u00e7u. Le protocole facilite un syst\u00e8me de transmission \"fen\u00eatr\u00e9\" : l'h\u00f4te peut avoir de nombreux blocs de messages en cours \u00e0 la fois. (Ceci s'ajoute aux nombreuses commandes qui peuvent \u00eatre pr\u00e9sentes dans un bloc de message.) Cela permet une utilisation maximale de la bande passante m\u00eame en cas de latence de transmission. Les m\u00e9canismes de temporisation, de retransmission, de fen\u00eatrage et d'accus\u00e9 de r\u00e9ception sont inspir\u00e9s de m\u00e9canismes similaires de TCP . Dans l'autre sens, les blocs de messages envoy\u00e9s du microcontr\u00f4leur \u00e0 l'h\u00f4te sont aussi con\u00e7us pour \u00eatre sans erreur, mais ils n'ont pas de validation de transmission. (Les r\u00e9ponses ne doivent pas \u00eatre corrompues, mais elles peuvent dispara\u00eetre.) Cette conception a \u00e9t\u00e9 choisie pour garder une mise en \u0153uvre simple dans le microcontr\u00f4leur. Il n'y a pas de syst\u00e8me de retransmission automatique des r\u00e9ponses - le code de haut niveau devrait \u00eatre capable de g\u00e9rer une r\u00e9ponse manquante occasionnelle (g\u00e9n\u00e9ralement en redemandant le contenu ou en \u00e9tablissant un calendrier r\u00e9current de transmission des r\u00e9ponses). Le champ du num\u00e9ro de s\u00e9quence dans les blocs de message envoy\u00e9s \u00e0 l'h\u00f4te est toujours sup\u00e9rieur d'une unit\u00e9 au dernier num\u00e9ro de s\u00e9quence envoy\u00e9 par l'h\u00f4te. Il n'est pas utilis\u00e9 pour suivre les s\u00e9quences de blocs de message de r\u00e9ponse.","title":"Protocole"},{"location":"Protocol.html#protocole","text":"Le protocole de messagerie Klipper est utilis\u00e9 pour la communication de bas niveau entre le logiciel h\u00f4te Klipper et le logiciel du microcontr\u00f4leur Klipper. \u00c0 un niveau \u00e9lev\u00e9, le protocole peut \u00eatre consid\u00e9r\u00e9 comme une s\u00e9rie de cha\u00eenes de commandes et de r\u00e9ponses qui sont compress\u00e9es, transmises, puis trait\u00e9es du c\u00f4t\u00e9 r\u00e9ception. Un exemple d'une s\u00e9ries de commandes dans un format non compress\u00e9 lisible par l'homme pourrait ressembler \u00e0 : set_digital_out pin=PA3 value=1 set_digital_out pin=PA7 value=1 schedule_digital_out oid=8 clock=4000000 value=0 queue_step oid=7 interval=7458 count=10 add=331 queue_step oid=7 interval=11717 count=4 add=1281 Consultez le document commandes mcu pour plus d'informations sur les commandes disponibles. Voir le document deboguage pour plus d'informations sur la fa\u00e7on de traduire un fichier G-Code en commandes de microcontr\u00f4leur lisibles. Cette page fournit une description de haut niveau du protocole de communication de Klipper lui-m\u00eame. Il d\u00e9crit comment les messages sont d\u00e9clar\u00e9s, cod\u00e9s au format binaire (le sch\u00e9ma de \"compression\") et transmis. L'objectif du protocole est de permettre un canal de communication sans erreur entre l'h\u00f4te et le microcontr\u00f4leur qui soit \u00e0 faible latence, \u00e0 faible bande passante et \u00e0 faible complexit\u00e9 pour le microcontr\u00f4leur.","title":"Protocole"},{"location":"Protocol.html#interface-du-micro-controleur","text":"Le protocole de transmission Klipper peut \u00eatre consid\u00e9r\u00e9 comme un m\u00e9canisme Appel de proc\u00e9dure \u00e0 distance entre le micro-contr\u00f4leur et l'h\u00f4te. Le logiciel du microcontr\u00f4leur d\u00e9clare les commandes que l'h\u00f4te peut invoquer ainsi que les messages de r\u00e9ponse qu'il peut g\u00e9n\u00e9rer. L'h\u00f4te utilise ces informations pour ordonner au microcontr\u00f4leur d'effectuer des actions et d'interpr\u00e9ter les r\u00e9sultats.","title":"Interface du micro-contr\u00f4leur"},{"location":"Protocol.html#declaration-des-commandes","text":"Le logiciel du microcontr\u00f4leur d\u00e9clare une \"commande\" en utilisant la macro DECL_COMMAND() dans le code C. Par exemple\u202f: DECL_COMMAND(command_update_digital_out, \"update_digital_out oid=%c value=%c\"); Ce qui pr\u00e9c\u00e8de d\u00e9clare une commande nomm\u00e9e \"update_digital_out\". Cela permet \u00e0 l'h\u00f4te \"d'appeler\" cette commande qui entra\u00eenerait l'ex\u00e9cution de la fonction C command_update_digital_out() dans le microcontr\u00f4leur. Ce qui pr\u00e9c\u00e8de indique \u00e9galement que la commande prend deux param\u00e8tres entiers. Lorsque le code C command_update_digital_out() est ex\u00e9cut\u00e9, un tableau contenant ces deux entiers lui sera transmis - le premier correspondant \u00e0 'oid' et le second correspondant \u00e0 'value'. En g\u00e9n\u00e9ral, les param\u00e8tres sont d\u00e9crits avec une syntaxe de style printf() (par exemple, \"%u\"). Le formatage correspond directement \u00e0 une vue \"lisible\" des commandes (par exemple, \"update_digital_out oid=7 value=1\"). Dans l'exemple ci-dessus, \"value=\" est un nom de param\u00e8tre et \"%c\" indique que le param\u00e8tre est un entier. En interne, le nom du param\u00e8tre n'est utilis\u00e9 que comme documentation. Dans cet exemple, le \"%c\" est \u00e9galement utilis\u00e9 comme documentation pour indiquer que l'entier attendu a une taille de 1 octet (la taille de l'entier d\u00e9clar\u00e9 n'a pas d'impact sur l'analyse ou l'encodage). La construction du micrologiciel du microcontr\u00f4leur collectera toutes les commandes d\u00e9clar\u00e9es avec DECL_COMMAND(), d\u00e9terminera leurs param\u00e8tres et s'arrangera pour qu'elles soient appelables.","title":"D\u00e9claration des commandes"},{"location":"Protocol.html#declaration-des-reponses","text":"Pour envoyer des informations du microcontr\u00f4leur \u00e0 l'h\u00f4te, des \"r\u00e9ponses\" sont g\u00e9n\u00e9r\u00e9es. Celles-ci sont \u00e0 la fois d\u00e9clar\u00e9es et transmises \u00e0 l'aide de la macro C sendf(). Par example\u202f: sendf(\"status clock=%u status=%c\", sched_read_time(), sched_is_shutdown()); Ce qui pr\u00e9c\u00e8de transmet un message de r\u00e9ponse \"status\" qui contient deux param\u00e8tres entiers (\"clock\" et \"status\"). La construction du microcontr\u00f4leur trouve automatiquement tous les appels sendf() et g\u00e9n\u00e8re des encodeurs pour eux. Le premier param\u00e8tre de la fonction sendf() d\u00e9crit la r\u00e9ponse et il est dans le m\u00eame format que les d\u00e9clarations de commande. L'h\u00f4te peut enregistrer une fonction de rappel pour chaque r\u00e9ponse. Ainsi, les commandes permettent \u00e0 l'h\u00f4te d'invoquer des fonctions C dans le microcontr\u00f4leur et les r\u00e9ponses permettent au logiciel du microcontr\u00f4leur d'invoquer du code dans l'h\u00f4te. La macro sendf() ne doit \u00eatre appel\u00e9e qu'\u00e0 partir de commandes ou de gestionnaires de t\u00e2ches, et elle ne doit pas \u00eatre appel\u00e9e \u00e0 partir d'interruptions ou de timers. Le code n'a pas besoin d'\u00e9mettre un sendf() en r\u00e9ponse \u00e0 une commande re\u00e7ue, le nombre d'appels \u00e0 sendf() n'est pas limi\u00e9, et il est possible d'appeler sendf() \u00e0 tout moment \u00e0 partir d'un gestionnaire de t\u00e2ches.","title":"D\u00e9claration des r\u00e9ponses"},{"location":"Protocol.html#reponses-de-sortie","text":"Pour simplifier le d\u00e9bogage, il existe \u00e9galement une fonction C output(). Par exemple\u202f: output(\"La valeur de %u est %s avec une taille de %u.\", x, buf, buf_len); La fonction output() est similaire \u00e0 printf() - elle est destin\u00e9e \u00e0 g\u00e9n\u00e9rer et formater des messages de d\u00e9bogage avec un affichage dans un format compr\u00e9hensible (ndt : par un humain normalement constitu\u00e9 :-)).","title":"R\u00e9ponses de sortie"},{"location":"Protocol.html#declarer-des-enumerations","text":"Les \u00e9num\u00e9rations permettent au code h\u00f4te d'utiliser des identificateurs de type cha\u00eene pour des param\u00e8tres que le microcontr\u00f4leur g\u00e8re comme des entiers. Ils sont d\u00e9clar\u00e9s dans le code du microcontr\u00f4leur - par exemple : DECL_ENUMERATION(\"spi_bus\", \"spi\", 0); DECL_ENUMERATION_RANGE(\"pin\", \"PC0\", 16, 8); Dans le premier exemple, la macro DECL_ENUMERATION() d\u00e9finit une \u00e9num\u00e9ration pour les messages de commande/r\u00e9ponse avec un nom de param\u00e8tre \"spi_bus\" ou un nom de param\u00e8tre avec un suffixe \"_spi_bus\". Pour ces param\u00e8tres, la cha\u00eene \"spi\" sera une valeur valide et elle sera transmise comme une valeur enti\u00e8re \u00e9gale \u00e0 z\u00e9ro. Il est \u00e9galement possible de d\u00e9clarer une plage d'\u00e9num\u00e9ration. Dans le deuxi\u00e8me exemple, un param\u00e8tre \"pin\" (ou tout param\u00e8tre avec le suffixe \"_pin\") accepterait PC0, PC1, PC2, ..., PC7 comme valeurs valides. Les cha\u00eenes seront transmises comme des entiers 16, 17, 18, ..., 23.","title":"D\u00e9clarer des \u00e9num\u00e9rations"},{"location":"Protocol.html#declaration-de-constantes","text":"Les constantes peuvent \u00eatre export\u00e9es. Par exemple, les \u00e9l\u00e9ments suivants : DECL_CONSTANT(\"SERIAL_BAUD\", 250000); exporterait une constante nomm\u00e9e \"SERIAL_BAUD\" avec une valeur de 250000 du microcontr\u00f4leur vers l'h\u00f4te. Il est \u00e9galement possible de d\u00e9clarer une constante de type cha\u00eene - par exemple : DECL_CONSTANT_STR(\"MCU\", \"pru\");","title":"D\u00e9claration de constantes"},{"location":"Protocol.html#encodage-des-message-de-bas-niveau","text":"Pour accomplir le m\u00e9canisme \"RPC\" ci-dessus, chaque commandes et r\u00e9ponses sont cod\u00e9es dans un format binaire pour la transmission. Cette section d\u00e9crit le syst\u00e8me de transmission.","title":"Encodage des message de bas niveau"},{"location":"Protocol.html#blocs-de-message","text":"Toutes les donn\u00e9es envoy\u00e9es de l'h\u00f4te au microcontr\u00f4leur et vice-versa sont contenues dans des \"blocs de message\". Un bloc de message a un en-t\u00eate de deux octets et une fin de trois octets. Le format d'un bloc de message est : <1 byte length><1 byte sequence><n-byte content><2 byte crc><1 byte sync> L'octet de longueur contient le nombre d'octets dans le bloc de message, y compris les octets d'en-t\u00eate et de fin (la longueur minimale du message est donc de 5 octets). La longueur maximale d'un bloc de message est de 64 octets. L'octet de s\u00e9quence contient un num\u00e9ro de s\u00e9quence de 4 bits dans les bits de poids faible et les bits de poids fort contiennent toujours 0x10 (les bits de poids fort sont r\u00e9serv\u00e9s pour une utilisation future). Les octets de contenu contiennent les donn\u00e9es du message et leur format est d\u00e9crit dans la section suivante. Les octets crc contiennent un CCITT CRC 16 bits du bloc de message incluant les octets d'en-t\u00eate mais excluant les octets de fin. L'octet de synchronisation est 0x7e. Le format du bloc de message est inspir\u00e9 des trames de message HDLC . Comme dans HDLC, le bloc de message peut \u00e9ventuellement contenir un caract\u00e8re de synchronisation suppl\u00e9mentaire au d\u00e9but du bloc. Contrairement \u00e0 HDLC, un caract\u00e8re de synchronisation n'est pas propre au header et peut \u00eatre pr\u00e9sent dans le contenu du bloc de message.","title":"Blocs de message"},{"location":"Protocol.html#contenu-du-bloc-de-message","text":"Chaque bloc de message envoy\u00e9 de l'h\u00f4te au microcontr\u00f4leur contient une s\u00e9rie de z\u00e9ro ou plusieurs commandes de message dans son contenu. Chaque commande commence par une Quantit\u00e9 de longueur variable (VLQ) encod\u00e9 entier command-id suivi de z\u00e9ro ou plusieurs param\u00e8tres VLQ pour la commande donn\u00e9e. Par exemple, les quatre commandes suivantes peuvent \u00eatre plac\u00e9es dans un seul bloc de message : update_digital_out oid=6 value=1 update_digital_out oid=5 value=0 get_config get_clock et cod\u00e9 dans les huit entiers VLQ suivants : <id_update_digital_out><6><1><id_update_digital_out><5><0><id_get_config><id_get_clock> Afin d'encoder et d'analyser le contenu du message, l'h\u00f4te et le microcontr\u00f4leur doivent s'accorder sur les identifiants de commande et le nombre de param\u00e8tres de chaque commande. Ainsi, dans l'exemple ci-dessus, l'h\u00f4te et le microcontr\u00f4leur savent que \"id_update_digital_out\" est toujours suivi de deux param\u00e8tres, et \"id_get_config\" et \"id_get_clock\" n'ont aucun param\u00e8tre. L'h\u00f4te et le microcontr\u00f4leur partagent un \"dictionnaire de donn\u00e9es\" qui mappe les descriptions de commande (par exemple, \"update_digital_out oid=%c value=%c\") \u00e0 leurs identifiants de commande \"entiers\". Lors du traitement des donn\u00e9es, l'analyseur saura s'attendre \u00e0 un nombre sp\u00e9cifique de param\u00e8tres cod\u00e9s VLQ apr\u00e8s un identifiant de commande donn\u00e9. Le contenu des messages pour les blocs envoy\u00e9s du microcontr\u00f4leur \u00e0 l'h\u00f4te suit le m\u00eame format. Les identifiants de ces messages sont des \"identifiants de r\u00e9ponse\", mais ils ont le m\u00eame objectif et suivent les m\u00eames r\u00e8gles de codage. En pratique, les blocs de message envoy\u00e9s du microcontr\u00f4leur \u00e0 l'h\u00f4te ne contiennent jamais plus d'une r\u00e9ponse dans le contenu du bloc de message.","title":"Contenu du bloc de message"},{"location":"Protocol.html#quantites-de-longueur-variable","text":"Voir l' article wikipedia sur les VLQ pour plus d'informations sur le format g\u00e9n\u00e9ral des entiers cod\u00e9s VLQ. Klipper utilise un sch\u00e9ma de codage qui prend en charge les entiers positifs et n\u00e9gatifs. Les entiers proches de z\u00e9ro utilisent moins d'octets pour coder et les entiers positifs cod\u00e9s utilisent moins d'octets - en g\u00e9n\u00e9ral - que les entiers n\u00e9gatifs. Le tableau suivant indique le nombre d'octets n\u00e9cessaires \u00e0 l'encodage de chaque entier : Integer Taille encod\u00e9e -32 .. 95 1 -4096 .. 12287 2 -524288 .. 1572863 3 -67108864 .. 201326591 4 -2147483648 .. 4294967295 5","title":"Quantit\u00e9s de longueur variable"},{"location":"Protocol.html#chaines-de-longueur-variable","text":"Une exception aux r\u00e8gles de codage ci-dessus, si le param\u00e8tre d'une commande ou d'une r\u00e9ponse est une cha\u00eene dynamique, le param\u00e8tre n'est pas cod\u00e9 comme un simple entier VLQ. Au lieu de cela, il est cod\u00e9 en transmettant la longueur sous la forme d'un entier cod\u00e9 VLQ suivi du contenu de la cha\u00eene lui-m\u00eame : <VLQ encoded length><n-byte contents> Les descriptions de commande trouv\u00e9es dans le dictionnaire de donn\u00e9es permettent \u00e0 la fois \u00e0 l'h\u00f4te et au microcontr\u00f4leur de savoir quels param\u00e8tres de commande utilisent un codage VLQ simple et quels param\u00e8tres utilisent un codage de cha\u00eene.","title":"Cha\u00eenes de longueur variable"},{"location":"Protocol.html#dictionnaire-de-donnees","text":"Pour que des communications significatives soient \u00e9tablies entre le microcontr\u00f4leur et l'h\u00f4te, les deux parties doivent s'entendre sur un \"dictionnaire de donn\u00e9es\". Ce dictionnaire de donn\u00e9es contient les identificateurs entiers des commandes et des r\u00e9ponses ainsi que leurs descriptions. La construction du micrologiciel du microcontr\u00f4leur utilise le contenu des macros DECL_COMMAND() et sendf() pour g\u00e9n\u00e9rer le dictionnaire de donn\u00e9es. La construction attribue automatiquement des identifiants uniques \u00e0 chaque commande et r\u00e9ponse. Ce syst\u00e8me permet \u00e0 la fois au code h\u00f4te et au code du microcontr\u00f4leur d'utiliser de mani\u00e8re transparente des noms descriptifs lisibles par l'homme tout en utilisant une bande passante minimale. L'h\u00f4te interroge le dictionnaire de donn\u00e9es lors de sa premi\u00e8re connexion au microcontr\u00f4leur. Une fois que l'h\u00f4te a t\u00e9l\u00e9charg\u00e9 le dictionnaire de donn\u00e9es du microcontr\u00f4leur, il utilise ce dictionnaire de donn\u00e9es pour coder toutes les commandes et analyser toutes les r\u00e9ponses du microcontr\u00f4leur. L'h\u00f4te doit donc g\u00e9rer un dictionnaire de donn\u00e9es dynamique. Cependant, pour garder le logiciel du microcontr\u00f4leur simple, le microcontr\u00f4leur utilise - lui - toujours son dictionnaire de donn\u00e9es statique (compil\u00e9). Le dictionnaire de donn\u00e9es est demand\u00e9 en envoyant des commandes \"identify\" au microcontr\u00f4leur. Le microcontr\u00f4leur r\u00e9pond \u00e0 chaque commande d'identification par un message \"identifier_response\". \u00c9tant donn\u00e9 que ces deux commandes sont n\u00e9cessaires avant d'obtenir le dictionnaire de donn\u00e9es, leurs identifiants entiers et leurs types de param\u00e8tres sont cod\u00e9s en dur \u00e0 la fois dans le microcontr\u00f4leur et dans l'h\u00f4te. L'identifiant de r\u00e9ponse \"identifier_response\" est 0, l'identifiant de commande \"identify\" est 1. En plus d'avoir des identifiants cod\u00e9s en dur, la commande d'identification et sa r\u00e9ponse sont d\u00e9clar\u00e9es et transmises de la m\u00eame mani\u00e8re que les autres commandes et r\u00e9ponses. Aucune autre commande ou r\u00e9ponse n'est cod\u00e9e en dur. Le format du dictionnaire de donn\u00e9es transmis est une cha\u00eene JSON compress\u00e9e zlib. Le processus de construction du microcontr\u00f4leur g\u00e9n\u00e8re la cha\u00eene, la comprime et la stocke dans la section texte du flash du microcontr\u00f4leur. Le dictionnaire de donn\u00e9es peut \u00eatre beaucoup plus grand que la taille maximale du bloc de message - l'h\u00f4te le t\u00e9l\u00e9charge en envoyant plusieurs commandes d'identification demandant des blocs progressifs du dictionnaire de donn\u00e9es. Une fois que tous les morceaux sont obtenus, l'h\u00f4te r\u00e9assemble les morceaux, d\u00e9compresse les donn\u00e9es et analyse le contenu. En plus des informations sur le protocole de communication, le dictionnaire de donn\u00e9es contient \u00e9galement la version du logiciel, les \u00e9num\u00e9rations (telles que d\u00e9finies par DECL_ENUMERATION) et les constantes (telles que d\u00e9finies par DECL_CONSTANT).","title":"Dictionnaire de donn\u00e9es"},{"location":"Protocol.html#flux-de-messages","text":"Les message de commande envoy\u00e9es de l'h\u00f4te au microcontr\u00f4leur sont cens\u00e9es \u00eatre sans erreur. Le microcontr\u00f4leur v\u00e9rifiera le CRC et les num\u00e9ros de s\u00e9quence dans chaque bloc de message pour s'assurer que les commandes sont exactes et dans l'ordre. Le microcontr\u00f4leur traite toujours les blocs de message dans l'ordre - s'il re\u00e7oit un bloc dans le d\u00e9sordre, il le rejettera ainsi que tout autre bloc dans le d\u00e9sordre jusqu'\u00e0 ce qu'il re\u00e7oive des blocs avec le bon s\u00e9quencement. Le code de bas niveau de l'h\u00f4te impl\u00e9mente un syst\u00e8me de retransmission automatique des blocs de messages perdus ou corrompus envoy\u00e9s au microcontr\u00f4leur. Pour faciliter cela, le microcontr\u00f4leur transmet un \"bloc de message ack\" apr\u00e8s chaque bloc de message re\u00e7u avec succ\u00e8s. L'h\u00f4te planifie un d\u00e9lai apr\u00e8s l'envoi de chaque bloc et il retransmettra si le d\u00e9lai expire sans recevoir de \"ack\" correspondant. De plus, si le microcontr\u00f4leur d\u00e9tecte un bloc corrompu ou dans le d\u00e9sordre, il peut transmettre un \"bloc de message nak\" pour faciliter une retransmission rapide. Un \"ack\" est un bloc de message avec un contenu vide (c'est-\u00e0-dire un bloc de message de 5 octets) et un num\u00e9ro de s\u00e9quence sup\u00e9rieur au dernier num\u00e9ro de s\u00e9quence d'h\u00f4te re\u00e7u. Un \"nak\" est un bloc de message avec un contenu vide et un num\u00e9ro de s\u00e9quence inf\u00e9rieur au dernier num\u00e9ro de s\u00e9quence d'h\u00f4te re\u00e7u. Le protocole facilite un syst\u00e8me de transmission \"fen\u00eatr\u00e9\" : l'h\u00f4te peut avoir de nombreux blocs de messages en cours \u00e0 la fois. (Ceci s'ajoute aux nombreuses commandes qui peuvent \u00eatre pr\u00e9sentes dans un bloc de message.) Cela permet une utilisation maximale de la bande passante m\u00eame en cas de latence de transmission. Les m\u00e9canismes de temporisation, de retransmission, de fen\u00eatrage et d'accus\u00e9 de r\u00e9ception sont inspir\u00e9s de m\u00e9canismes similaires de TCP . Dans l'autre sens, les blocs de messages envoy\u00e9s du microcontr\u00f4leur \u00e0 l'h\u00f4te sont aussi con\u00e7us pour \u00eatre sans erreur, mais ils n'ont pas de validation de transmission. (Les r\u00e9ponses ne doivent pas \u00eatre corrompues, mais elles peuvent dispara\u00eetre.) Cette conception a \u00e9t\u00e9 choisie pour garder une mise en \u0153uvre simple dans le microcontr\u00f4leur. Il n'y a pas de syst\u00e8me de retransmission automatique des r\u00e9ponses - le code de haut niveau devrait \u00eatre capable de g\u00e9rer une r\u00e9ponse manquante occasionnelle (g\u00e9n\u00e9ralement en redemandant le contenu ou en \u00e9tablissant un calendrier r\u00e9current de transmission des r\u00e9ponses). Le champ du num\u00e9ro de s\u00e9quence dans les blocs de message envoy\u00e9s \u00e0 l'h\u00f4te est toujours sup\u00e9rieur d'une unit\u00e9 au dernier num\u00e9ro de s\u00e9quence envoy\u00e9 par l'h\u00f4te. Il n'est pas utilis\u00e9 pour suivre les s\u00e9quences de blocs de message de r\u00e9ponse.","title":"Flux de messages"},{"location":"RPi_microcontroller.html","text":"Microcontr\u00f4leur RPi \u00b6 Ce document d\u00e9crit le processus via lequel il est possible de lancer Klipper sur un Raspberry Pi et d'utiliser le m\u00eame Raspberry Pi comme mcu secondaire. Pourquoi utiliser un RPi comme microcontr\u00f4leur secondaire ? \u00b6 Souvent les microcontr\u00f4leurs d\u00e9di\u00e9s au contr\u00f4le des imprimantes 3D disposent d'un nombre limit\u00e9 et pr\u00e9-configur\u00e9 de broches expos\u00e9es pour g\u00e9rer les principales fonctions d'impression (r\u00e9sistances thermiques, extrudeuses, steppers...). L'utilisation du RPi o\u00f9 Klipper est install\u00e9 en tant que MCU secondaire donne la possibilit\u00e9 d'utiliser directement les GPIO et les bus (i2c, spi) du RPi \u00e0 l'int\u00e9rieur de klipper sans utiliser de plugins Octoprint (le cas \u00e9ch\u00e9ant) ou de programmes externes donnant la possibilit\u00e9 de tout contr\u00f4ler \u00e0 l'int\u00e9rieur l'impression GCODE. Avertissement : Si votre plate-forme est un Beaglebone et que vous avez correctement suivi les \u00e9tapes d'installation, le mcu linux est d\u00e9j\u00e0 install\u00e9 et configur\u00e9 pour votre syst\u00e8me. Installer le script rc \u00b6 Si vous souhaitez utiliser l'h\u00f4te comme MCU secondaire, le processus klipper_mcu doit s'ex\u00e9cuter avant le processus klippy. Apr\u00e8s avoir install\u00e9 Klipper, installez le script. Executez : cd ~/klipper/ sudo cp ./scripts/klipper-mcu.service /etc/systemd/system/ sudo systemctl enable klipper-mcu.service Construire le code du microcontr\u00f4leur \u00b6 Pour compiler le code du micro-contr\u00f4leur Klipper, commencez par le configurer pour le \"Linux process\"\u202f: cd ~/klipper/ make menuconfig Dans le menu, d\u00e9finissez \"Architecture du microcontr\u00f4leur\" sur \"Processus Linux\", puis enregistrez et quittez. Pour compiler et installer le nouveau code du microcontr\u00f4leur, ex\u00e9cutez : sudo service klipper stop make flash sudo service klipper start Si klippy.log signale une erreur \"Autorisation refus\u00e9e\" lors de la tentative de connexion \u00e0 /tmp/klipper_host_mcu , vous devez ajouter votre utilisateur au groupe tty. La commande suivante ajoutera l'utilisateur \"pi\" au groupe tty : sudo usermod -a -G tty pi Configuration restante \u00b6 Terminez l'installation en configurant le MCU secondaire de Klipper en suivant les instructions dans RaspberryPi exemlple de configuration et Exemples de configuration Multi MCU . Facultatif : Activer SPI \u00b6 Assurez-vous que le pilote SPI Linux est activ\u00e9 en ex\u00e9cutant sudo raspi-config et en activant SPI dans le menu \u00ab Options d\u2019interface \u00bb. Facultatif : Activer I2C \u00b6 Assurez-vous que le pilote Linux I2C est activ\u00e9 en ex\u00e9cutant sudo raspi-config et en activant I2C dans le menu \"Interfacing options\". Si vous pr\u00e9voyez d'utiliser I2C pour l'acc\u00e9l\u00e9rom\u00e8tre MPU, il est \u00e9galement n\u00e9cessaire de d\u00e9finir le d\u00e9bit en bauds sur 400 000 en : ajoutant/d\u00e9commentant dtparam=i2c_arm=on,i2c_arm_baudrate=400000 dans /boot/config. txt (ou /boot/firmware/config.txt dans certaines distributions). Facultatif : identifiez la bonne puce gpio \u00b6 Sur Raspberry Pi et sur de nombreux clones, les broches disponibles sur le connecteur GPIO appartiennent \u00e0 la premi\u00e8re puce gpio. Ils peuvent donc \u00eatre utilis\u00e9s sur klipper simplement en les r\u00e9f\u00e9ren\u00e7ant avec le nom gpio0..n . Cependant, il existe des cas dans lesquels les broches disponibles appartiennent \u00e0 des puces gpio autres que la premi\u00e8re. Par exemple dans le cas de certains mod\u00e8les OrangePi ou si un \"Port Expander\" est utilis\u00e9. Dans ces cas, il est utile d'utiliser les commandes pour acc\u00e9der au P\u00e9riph\u00e9rique de caract\u00e8res GPIO Linux pour v\u00e9rifier la configuration. Pour installer le p\u00e9riph\u00e9rique de caract\u00e8res *Linux GPIO - binaire * sur une distribution bas\u00e9e sur Debian comme Octopi, ex\u00e9cutez : sudo apt-get install gpiod Pour v\u00e9rifier la puce gpio disponible ex\u00e9cutez : gpiodetect Pour v\u00e9rifier la num\u00e9rotation des broches du connecteur GPIO et leur disponibilit\u00e9, ex\u00e9cutez : gpioinfo La broche choisie peut donc \u00eatre utilis\u00e9e dans la configuration comme gpiochip<n>/gpio<o> o\u00f9 n est le num\u00e9ro de puce tel qu'il est vu par la commande gpiodetect et o est le num\u00e9ro de ligne vu par la commande gpioinfo . Avertissement : seul les broches gpio marqu\u00e9es comme inutilis\u00e9es peuvent \u00eatre utilis\u00e9es. Il n'est pas possible qu'une ligne soit utilis\u00e9e par plusieurs processus simultan\u00e9ment. Par exemple sur un RPi 3B+ o\u00f9 klipper utilise le GPIO20 comme un interrupteur : $ gpiodetect gpiochip0 [pinctrl-bcm2835] (54 lines) gpiochip1 [raspberrypi-exp-gpio] (8 lines) $ gpioinfo gpiochip0 - 54 lines: line 0: unnamed unused input active-high line 1: unnamed unused input active-high line 2: unnamed unused input active-high line 3: unnamed unused input active-high line 4: unnamed unused input active-high line 5: unnamed unused input active-high line 6: unnamed unused input active-high line 7: unnamed unused input active-high line 8: unnamed unused input active-high line 9: unnamed unused input active-high line 10: unnamed unused input active-high line 11: unnamed unused input active-high line 12: unnamed unused input active-high line 13: unnamed unused input active-high line 14: unnamed unused input active-high line 15: unnamed unused input active-high line 16: unnamed unused input active-high line 17: unnamed unused input active-high line 18: unnamed unused input active-high line 19: unnamed unused input active-high line 20: unnamed \"klipper\" output active-high [used] line 21: unnamed unused input active-high line 22: unnamed unused input active-high line 23: unnamed unused input active-high line 24: unnamed unused input active-high line 25: unnamed unused input active-high line 26: unnamed unused input active-high line 27: unnamed unused input active-high line 28: unnamed unused input active-high line 29: unnamed \"led0\" output active-high [used] line 30: unnamed unused input active-high line 31: unnamed unused input active-high line 32: unnamed unused input active-high line 33: unnamed unused input active-high line 34: unnamed unused input active-high line 35: unnamed unused input active-high line 36: unnamed unused input active-high line 37: unnamed unused input active-high line 38: unnamed unused input active-high line 39: unnamed unused input active-high line 40: unnamed unused input active-high line 41: unnamed unused input active-high line 42: unnamed unused input active-high line 43: unnamed unused input active-high line 44: unnamed unused input active-high line 45: unnamed unused input active-high line 46: unnamed unused input active-high line 47: unnamed unused input active-high line 48: unnamed unused input active-high line 49: unnamed unused input active-high line 50: unnamed unused input active-high line 51: unnamed unused input active-high line 52: unnamed unused input active-high line 53: unnamed unused input active-high gpiochip1 - 8 lines: line 0: unnamed unused input active-high line 1: unnamed unused input active-high line 2: unnamed \"led1\" output active-low [used] line 3: unnamed unused input active-high line 4: unnamed unused input active-high line 5: unnamed unused input active-high line 6: unnamed unused input active-high line 7: unnamed unused input active-high Facultatif : PWM mat\u00e9riel \u00b6 Les Raspberry Pi ont deux canaux PWM (PWM0 et PWM1) qui sont disponibles sur le connecteur ou, sinon, peuvent \u00eatre redirig\u00e9s vers des broches gpio existantes. Le service mcu Linux utilise l'interface pwmchip sysfs pour contr\u00f4ler les p\u00e9riph\u00e9riques mat\u00e9riels pwm sur les h\u00f4tes Linux. L'interface pwm sysfs n'est pas disponible par d\u00e9faut sur un Raspberry et peut \u00eatre activ\u00e9e en ajoutant une ligne \u00e0 /boot/config.txt : # Activer l'interface pwmchip sysfs dtoverlay=pwm,pin=12,func=4 Cet exemple active uniquement PWM0 et l'achemine vers gpio12. Si les deux canaux PWM doivent \u00eatre activ\u00e9s, vous pouvez utiliser pwm-2chan . La superposition n'expose pas la ligne pwm sur sysfs au d\u00e9marrage et doit \u00eatre redirig\u00e9e en renvoyant le num\u00e9ro du canal pwm vers /sys/class/pwm/pwmchip0/export : echo 0 > /sys/class/pwm/pwmchip0/export Cela cr\u00e9era le p\u00e9riph\u00e9rique /sys/class/pwm/pwmchip0/pwm0 dans le syst\u00e8me de fichiers. La fa\u00e7on la plus simple de le faire est d'ajouter ceci \u00e0 /etc/rc.local avant la ligne exit 0 . Avec le sysfs en place, vous pouvez maintenant utiliser l'un ou l'autre des canaux pwm en ajoutant la configuration suivante \u00e0 votre printer.cfg : [output_pin caselight] pin: host:pwmchip0/pwm0 pwm: True hardware_pwm: True cycle_time: 0.000001 Cela ajoutera un contr\u00f4le pwm mat\u00e9riel \u00e0 gpio12 sur le Pi (car la superposition a \u00e9t\u00e9 configur\u00e9e pour acheminer pwm0 vers la broche = 12). PWM0 peut \u00eatre redirig\u00e9 vers gpio12 et gpio18, PWM1 peut \u00eatre redirig\u00e9 vers gpio13 et gpio19 : PWM (Modulation en Largeur d'Impulsion) Broche gpio Func 0 12 4 0 18 2 1 13 4 1 19 2","title":"Microcontr\u00f4leur RPi"},{"location":"RPi_microcontroller.html#microcontroleur-rpi","text":"Ce document d\u00e9crit le processus via lequel il est possible de lancer Klipper sur un Raspberry Pi et d'utiliser le m\u00eame Raspberry Pi comme mcu secondaire.","title":"Microcontr\u00f4leur RPi"},{"location":"RPi_microcontroller.html#pourquoi-utiliser-un-rpi-comme-microcontroleur-secondaire","text":"Souvent les microcontr\u00f4leurs d\u00e9di\u00e9s au contr\u00f4le des imprimantes 3D disposent d'un nombre limit\u00e9 et pr\u00e9-configur\u00e9 de broches expos\u00e9es pour g\u00e9rer les principales fonctions d'impression (r\u00e9sistances thermiques, extrudeuses, steppers...). L'utilisation du RPi o\u00f9 Klipper est install\u00e9 en tant que MCU secondaire donne la possibilit\u00e9 d'utiliser directement les GPIO et les bus (i2c, spi) du RPi \u00e0 l'int\u00e9rieur de klipper sans utiliser de plugins Octoprint (le cas \u00e9ch\u00e9ant) ou de programmes externes donnant la possibilit\u00e9 de tout contr\u00f4ler \u00e0 l'int\u00e9rieur l'impression GCODE. Avertissement : Si votre plate-forme est un Beaglebone et que vous avez correctement suivi les \u00e9tapes d'installation, le mcu linux est d\u00e9j\u00e0 install\u00e9 et configur\u00e9 pour votre syst\u00e8me.","title":"Pourquoi utiliser un RPi comme microcontr\u00f4leur secondaire ?"},{"location":"RPi_microcontroller.html#installer-le-script-rc","text":"Si vous souhaitez utiliser l'h\u00f4te comme MCU secondaire, le processus klipper_mcu doit s'ex\u00e9cuter avant le processus klippy. Apr\u00e8s avoir install\u00e9 Klipper, installez le script. Executez : cd ~/klipper/ sudo cp ./scripts/klipper-mcu.service /etc/systemd/system/ sudo systemctl enable klipper-mcu.service","title":"Installer le script rc"},{"location":"RPi_microcontroller.html#construire-le-code-du-microcontroleur","text":"Pour compiler le code du micro-contr\u00f4leur Klipper, commencez par le configurer pour le \"Linux process\"\u202f: cd ~/klipper/ make menuconfig Dans le menu, d\u00e9finissez \"Architecture du microcontr\u00f4leur\" sur \"Processus Linux\", puis enregistrez et quittez. Pour compiler et installer le nouveau code du microcontr\u00f4leur, ex\u00e9cutez : sudo service klipper stop make flash sudo service klipper start Si klippy.log signale une erreur \"Autorisation refus\u00e9e\" lors de la tentative de connexion \u00e0 /tmp/klipper_host_mcu , vous devez ajouter votre utilisateur au groupe tty. La commande suivante ajoutera l'utilisateur \"pi\" au groupe tty : sudo usermod -a -G tty pi","title":"Construire le code du microcontr\u00f4leur"},{"location":"RPi_microcontroller.html#configuration-restante","text":"Terminez l'installation en configurant le MCU secondaire de Klipper en suivant les instructions dans RaspberryPi exemlple de configuration et Exemples de configuration Multi MCU .","title":"Configuration restante"},{"location":"RPi_microcontroller.html#facultatif-activer-spi","text":"Assurez-vous que le pilote SPI Linux est activ\u00e9 en ex\u00e9cutant sudo raspi-config et en activant SPI dans le menu \u00ab Options d\u2019interface \u00bb.","title":"Facultatif\u00a0: Activer SPI"},{"location":"RPi_microcontroller.html#facultatif-activer-i2c","text":"Assurez-vous que le pilote Linux I2C est activ\u00e9 en ex\u00e9cutant sudo raspi-config et en activant I2C dans le menu \"Interfacing options\". Si vous pr\u00e9voyez d'utiliser I2C pour l'acc\u00e9l\u00e9rom\u00e8tre MPU, il est \u00e9galement n\u00e9cessaire de d\u00e9finir le d\u00e9bit en bauds sur 400 000 en : ajoutant/d\u00e9commentant dtparam=i2c_arm=on,i2c_arm_baudrate=400000 dans /boot/config. txt (ou /boot/firmware/config.txt dans certaines distributions).","title":"Facultatif\u00a0: Activer I2C"},{"location":"RPi_microcontroller.html#facultatif-identifiez-la-bonne-puce-gpio","text":"Sur Raspberry Pi et sur de nombreux clones, les broches disponibles sur le connecteur GPIO appartiennent \u00e0 la premi\u00e8re puce gpio. Ils peuvent donc \u00eatre utilis\u00e9s sur klipper simplement en les r\u00e9f\u00e9ren\u00e7ant avec le nom gpio0..n . Cependant, il existe des cas dans lesquels les broches disponibles appartiennent \u00e0 des puces gpio autres que la premi\u00e8re. Par exemple dans le cas de certains mod\u00e8les OrangePi ou si un \"Port Expander\" est utilis\u00e9. Dans ces cas, il est utile d'utiliser les commandes pour acc\u00e9der au P\u00e9riph\u00e9rique de caract\u00e8res GPIO Linux pour v\u00e9rifier la configuration. Pour installer le p\u00e9riph\u00e9rique de caract\u00e8res *Linux GPIO - binaire * sur une distribution bas\u00e9e sur Debian comme Octopi, ex\u00e9cutez : sudo apt-get install gpiod Pour v\u00e9rifier la puce gpio disponible ex\u00e9cutez : gpiodetect Pour v\u00e9rifier la num\u00e9rotation des broches du connecteur GPIO et leur disponibilit\u00e9, ex\u00e9cutez : gpioinfo La broche choisie peut donc \u00eatre utilis\u00e9e dans la configuration comme gpiochip<n>/gpio<o> o\u00f9 n est le num\u00e9ro de puce tel qu'il est vu par la commande gpiodetect et o est le num\u00e9ro de ligne vu par la commande gpioinfo . Avertissement : seul les broches gpio marqu\u00e9es comme inutilis\u00e9es peuvent \u00eatre utilis\u00e9es. Il n'est pas possible qu'une ligne soit utilis\u00e9e par plusieurs processus simultan\u00e9ment. Par exemple sur un RPi 3B+ o\u00f9 klipper utilise le GPIO20 comme un interrupteur : $ gpiodetect gpiochip0 [pinctrl-bcm2835] (54 lines) gpiochip1 [raspberrypi-exp-gpio] (8 lines) $ gpioinfo gpiochip0 - 54 lines: line 0: unnamed unused input active-high line 1: unnamed unused input active-high line 2: unnamed unused input active-high line 3: unnamed unused input active-high line 4: unnamed unused input active-high line 5: unnamed unused input active-high line 6: unnamed unused input active-high line 7: unnamed unused input active-high line 8: unnamed unused input active-high line 9: unnamed unused input active-high line 10: unnamed unused input active-high line 11: unnamed unused input active-high line 12: unnamed unused input active-high line 13: unnamed unused input active-high line 14: unnamed unused input active-high line 15: unnamed unused input active-high line 16: unnamed unused input active-high line 17: unnamed unused input active-high line 18: unnamed unused input active-high line 19: unnamed unused input active-high line 20: unnamed \"klipper\" output active-high [used] line 21: unnamed unused input active-high line 22: unnamed unused input active-high line 23: unnamed unused input active-high line 24: unnamed unused input active-high line 25: unnamed unused input active-high line 26: unnamed unused input active-high line 27: unnamed unused input active-high line 28: unnamed unused input active-high line 29: unnamed \"led0\" output active-high [used] line 30: unnamed unused input active-high line 31: unnamed unused input active-high line 32: unnamed unused input active-high line 33: unnamed unused input active-high line 34: unnamed unused input active-high line 35: unnamed unused input active-high line 36: unnamed unused input active-high line 37: unnamed unused input active-high line 38: unnamed unused input active-high line 39: unnamed unused input active-high line 40: unnamed unused input active-high line 41: unnamed unused input active-high line 42: unnamed unused input active-high line 43: unnamed unused input active-high line 44: unnamed unused input active-high line 45: unnamed unused input active-high line 46: unnamed unused input active-high line 47: unnamed unused input active-high line 48: unnamed unused input active-high line 49: unnamed unused input active-high line 50: unnamed unused input active-high line 51: unnamed unused input active-high line 52: unnamed unused input active-high line 53: unnamed unused input active-high gpiochip1 - 8 lines: line 0: unnamed unused input active-high line 1: unnamed unused input active-high line 2: unnamed \"led1\" output active-low [used] line 3: unnamed unused input active-high line 4: unnamed unused input active-high line 5: unnamed unused input active-high line 6: unnamed unused input active-high line 7: unnamed unused input active-high","title":"Facultatif\u00a0: identifiez la bonne puce gpio"},{"location":"RPi_microcontroller.html#facultatif-pwm-materiel","text":"Les Raspberry Pi ont deux canaux PWM (PWM0 et PWM1) qui sont disponibles sur le connecteur ou, sinon, peuvent \u00eatre redirig\u00e9s vers des broches gpio existantes. Le service mcu Linux utilise l'interface pwmchip sysfs pour contr\u00f4ler les p\u00e9riph\u00e9riques mat\u00e9riels pwm sur les h\u00f4tes Linux. L'interface pwm sysfs n'est pas disponible par d\u00e9faut sur un Raspberry et peut \u00eatre activ\u00e9e en ajoutant une ligne \u00e0 /boot/config.txt : # Activer l'interface pwmchip sysfs dtoverlay=pwm,pin=12,func=4 Cet exemple active uniquement PWM0 et l'achemine vers gpio12. Si les deux canaux PWM doivent \u00eatre activ\u00e9s, vous pouvez utiliser pwm-2chan . La superposition n'expose pas la ligne pwm sur sysfs au d\u00e9marrage et doit \u00eatre redirig\u00e9e en renvoyant le num\u00e9ro du canal pwm vers /sys/class/pwm/pwmchip0/export : echo 0 > /sys/class/pwm/pwmchip0/export Cela cr\u00e9era le p\u00e9riph\u00e9rique /sys/class/pwm/pwmchip0/pwm0 dans le syst\u00e8me de fichiers. La fa\u00e7on la plus simple de le faire est d'ajouter ceci \u00e0 /etc/rc.local avant la ligne exit 0 . Avec le sysfs en place, vous pouvez maintenant utiliser l'un ou l'autre des canaux pwm en ajoutant la configuration suivante \u00e0 votre printer.cfg : [output_pin caselight] pin: host:pwmchip0/pwm0 pwm: True hardware_pwm: True cycle_time: 0.000001 Cela ajoutera un contr\u00f4le pwm mat\u00e9riel \u00e0 gpio12 sur le Pi (car la superposition a \u00e9t\u00e9 configur\u00e9e pour acheminer pwm0 vers la broche = 12). PWM0 peut \u00eatre redirig\u00e9 vers gpio12 et gpio18, PWM1 peut \u00eatre redirig\u00e9 vers gpio13 et gpio19 : PWM (Modulation en Largeur d'Impulsion) Broche gpio Func 0 12 4 0 18 2 1 13 4 1 19 2","title":"Facultatif : PWM mat\u00e9riel"},{"location":"Releases.html","text":"Versions \u00b6 Historique de versions de Klipper. Merci de vous r\u00e9f\u00e9rer a la ressource installation pour plus d'information sur l'installation de Klipper. Klipper 0.11.0 \u00b6 Disponible le 28/11/2022. Changements majeurs dans cette version : Optimisation du pilote de moteur pas \u00e0 pas trinamic \"pas sur les deux c\u00f4t\u00e9s\" (\"step on both edges\"). Prise en charge de Python3. Le code h\u00f4te Klipper fonctionnera avec Python2 ou Python3. Prise en charge am\u00e9lior\u00e9e du bus CAN. Prise en charge du bus CAN sur les puces rp2040, stm32g0, stm32h7, same51 et same54. Prise en charge du mode \"pont USB vers bus CAN\". Prise en charge du chargeur de d\u00e9marrage CanBoot. Prise en charge des acc\u00e9l\u00e9rom\u00e8tres mpu9250 et mpu6050. Am\u00e9lioration de la gestion des erreurs pour les capteurs de temp\u00e9rature max31856, max31855, max31865 et max6675. Il est d\u00e9sormais possible de configurer les LED pour qu'elles se mettent \u00e0 jour pendant les longues commandes G-Code \u00e0 l'aide de la prise en charge du \"mod\u00e8le\" de LED. Plusieurs am\u00e9liorations sur le microcontr\u00f4leur. Nouvelle prise en charge des puces stm32h743, stm32h750, stm32l412, stm32g0b1, same70, same51 et same54. Prise en charge des lectures i2c sur atsamd et stm32f0. Prise en charge pwm mat\u00e9rielle sur stm32. Envoi d'\u00e9v\u00e9nements bas\u00e9 sur le signal Linux mcu. Nouveau support rp2040 pour \"make flash\", i2c et rp2040-e5 USB errata. Nouveaux modules ajout\u00e9s : angle, dac084S085, exclude_object, led, mpu9250, pca9632, smart_effector, z_thermal_adjust. Nouvelle cin\u00e9matique \"delt\u00e9sienne\" ajout\u00e9e. Nouvel outil dump_mcu ajout\u00e9. Plusieurs corrections de bogues et nettoyages de code. Klipper 0.10.0 \u00b6 Disponible le 29/09/2021. Changements majeurs dans cette version : Prise en charge de la mise \u00e0 l'origine \"Multi-MCU\". Il est d\u00e9sormais possible de c\u00e2bler un pilote de moteur pas \u00e0 pas et sa fin de course sur des microcontr\u00f4leurs s\u00e9par\u00e9s. Cela simplifie le c\u00e2blage des sondes Z sur les \"cartes de t\u00eate d'outil\". Klipper a maintenant un Serveur Discord et un Serveur Discourse . Le site Web de Klipper utilise d\u00e9sormais l'infrastructure \"mkdocs\". Il existe \u00e9galement un projet Klipper Translations . Prise en charge automatis\u00e9e du flash du micrologiciel via une carte SD sur de nombreuses cartes. Nouveau support cin\u00e9matique pour les imprimantes \"Hybrid CoreXY\" et \"Hybrid CoreXZ\". Klipper utilise maintenant rotation_distance pour configurer les distances de d\u00e9placement du moteur pas \u00e0 pas. Le code h\u00f4te principal de Klipper peut d\u00e9sormais communiquer directement avec les microcontr\u00f4leurs via le bus CAN. Nouveau syst\u00e8me \"d'analyse de mouvement\". Les mises \u00e0 jour des mouvements internes de Klipper et les r\u00e9sultats des capteurs peuvent \u00eatre suivis et enregistr\u00e9s pour analyse. Les pilotes de moteur pas \u00e0 pas Trinamic sont d\u00e9sormais surveill\u00e9s en permanence pour les conditions d'erreur. Prise en charge du microcontr\u00f4leur rp2040 (cartes Raspberry Pi Pico). Le syst\u00e8me \"make menuconfig\" utilise maintenant kconfiglib. De nombreux modules suppl\u00e9mentaires ajout\u00e9s : ds18b20, duplicate_pin_override, filament_motion_sensor, palette2, motion_report, pca9533, pulse_counter, save_variables, sdcard_loop, temperature_host, temperature_mcu Plusieurs corrections de bogues et nettoyages de code. Klipper 0.9.0 \u00b6 Disponible le 20/10/2020. Changements majeurs dans cette version : Prise en charge de \"Input Shaping\" - un m\u00e9canisme pour contrer la r\u00e9sonance de l'imprimante. Il peut r\u00e9duire ou \u00e9liminer les \"ondulations\" dans les impressions. Nouveau syst\u00e8me \"Smooth Pressure Advance\". Cela impl\u00e9mente \"Pressure Advance\" sans introduire de changements de vitesse instantan\u00e9s. Il est d\u00e9sormais possible de r\u00e9gler l'avance de pression \u00e0 l'aide d'une m\u00e9thode \"Tour de r\u00e9glage\". Nouveau serveur API \"webhooks\". Fournit une interface JSON programmable \u00e0 Klipper. L'\u00e9cran LCD et le menu sont d\u00e9sormais configurables \u00e0 l'aide du langage Jinja2. Les pilotes de moteur pas \u00e0 pas TMC2208 peuvent d\u00e9sormais \u00eatre utilis\u00e9s en mode \"standalone\" avec Klipper. Prise en charge am\u00e9lior\u00e9e du BL-Touch v3. Identification USB am\u00e9lior\u00e9e. Klipper dispose d\u00e9sormais de son propre code d'identification USB et les micro-contr\u00f4leurs peuvent d\u00e9sormais signaler leurs num\u00e9ros de s\u00e9rie lors de l'identification USB. Nouveau support cin\u00e9matique pour les imprimantes \"Rotary Delta\" et \"CoreXZ\". Am\u00e9liorations du microcontr\u00f4leur : prise en charge de stm32f070, prise en charge de stm32f207, prise en charge des broches GPIO sur \"Linux MCU\", prise en charge du \"chargeur de d\u00e9marrage HID\" stm32, prise en charge du chargeur de d\u00e9marrage Chitu, prise en charge du chargeur de d\u00e9marrage MKS Robin. Am\u00e9lioration de la gestion des \u00e9v\u00e9nements Python pour \"garbage collection\". Nombreux modules suppl\u00e9mentaires ajout\u00e9s : adc_scaled, adxl345, bme280, display_status, extruder_stepper, fan_generic, hall_filament_width_sensor, htu21d, homing_heaters, input_shaper, lm75, print_stats, resonance_tester, shaper_calibrate, query_adc, graph_accelerometer, graph_extruder, graph_motion, graph_shaper, graph_temp_sensor, whconsole Plusieurs corrections de bogues et nettoyages de code. Klipper 0.9.1 \u00b6 Disponible le 28/10/2020. Version contenant uniquement des corrections de bogues. Klipper 0.8.0 \u00b6 Disponible le 21/10/2019. Changements majeurs dans cette version : Prise en charge du nouveau mod\u00e8le de commande G-Code. Le G-Code dans le fichier de configuration est maintenant \u00e9valu\u00e9 avec le langage Jinja2. Am\u00e9liorations de la gestion des pilotes pas \u00e0 pas Trinamic : Nouvelle prise en charge pour les pilotes TMC2209 et TMC5160. Commandes G-Code DUMP_TMC, SET_TMC_CURRENT et INIT_TMC am\u00e9lior\u00e9es. Prise en charge am\u00e9lior\u00e9e de la gestion TMC UART avec un multiplexage analogique. Prise en charge am\u00e9lior\u00e9e de la mise \u00e0 l'origine, du sondage et de la mise \u00e0 niveau du lit : Nouveaux modules manual_probe, bed_screws, screw_tilt_adjust, skew_correction, safe_z_home ajout\u00e9s. Sondage multi-\u00e9chantillons am\u00e9lior\u00e9 avec une logique de m\u00e9diane, de moyenne et de nouvel essai. Documentation am\u00e9lior\u00e9e pour le BL-Touch, l'\u00e9talonnage de la sonde, l'\u00e9talonnage de la fin de course, l'\u00e9talonnage des imprimantes delta, la mise \u00e0 l'origine sans capteur et l'\u00e9talonnage de la phase de fin de course. Prise en charge am\u00e9lior\u00e9e de la mise \u00e0 l'origine sur un axe Z de grande taille. De nombreuses am\u00e9liorations du micro-contr\u00f4leur Klipper : Klipper port\u00e9 sur : SAM3X8C, SAM4S8C, SAMD51, STM32F042, STM32F4 Nouvelles impl\u00e9mentations des pilotes USB CDC sur SAM3X, SAM4, STM32F4. Prise en charge am\u00e9lior\u00e9e du flashage de Klipper via USB. Prise en charge du SPI logiciel. Filtrage de temp\u00e9rature grandement am\u00e9lior\u00e9 sur le capteur LPC176x. Les param\u00e8tres de d\u00e9marrage des broches de sortie peuvent \u00eatre configur\u00e9s dans le micro-contr\u00f4leur. Nouveau site web avec la documentation Klipper : http://klipper3d.org/ Klipper a maintenant un logo. Support exp\u00e9rimental pour la cin\u00e9matique polaire et \"treuil \u00e0 c\u00e2ble\". Le fichier de configuration peut maintenant inclure d'autres fichiers de configuration. De nombreux modules suppl\u00e9mentaires ajout\u00e9s : board_pins, controller_fan, delay_gcode, dotstar, filament_switch_sensor, firmware_retraction, gcode_arcs, gcode_button, heater_generic, manual_stepper, mcp4018, mcp4728, neopixel, pause_resume, respond, temperature_sensor tsl1401cl_filament_width_sensor, tuning_tower De nombreuses commandes suppl\u00e9mentaires ajout\u00e9es : RESTORE_GCODE_STATE, SAVE_GCODE_STATE, SET_GCODE_VARIABLE, SET_HEATER_TEMPERATURE, SET_IDLE_TIMEOUT, SET_TEMPERATURE_FAN_TARGET Plusieurs corrections de bogues et nettoyages de code. Klipper 0.7.0 \u00b6 Disponible le 20/12/2018. Changements majeurs dans cette version : Klipper prend d\u00e9sormais en charge le nivellement du lit par maillage Nouvel \u00e9talonnage des imprimantes delta \"am\u00e9lior\u00e9\" (\u00e9talonne les dimensions d'impression x/y sur les imprimantes delta) Gestion de la configuration pendant l'ex\u00e9cution des pilotes de moteur pas \u00e0 pas Trinamic (tmc2130, tmc2208, tmc2660) Prise en charge am\u00e9lior\u00e9e des capteurs de temp\u00e9rature : MAX6675, MAX31855, MAX31856, MAX31865, thermistances personnalis\u00e9es, capteurs de style pt100 Plusieurs nouveaux modules : temperature_fan, sx1509, force_move, mcp4451, z_tilt, quad_gantry_level, endstop_phase, bltouch Plusieurs nouvelles commandes ajout\u00e9es : SAVE_CONFIG, SET_PRESSURE_ADVANCE, SET_GCODE_OFFSET, SET_VELOCITY_LIMIT, STEPPER_BUZZ, TURN_OFF_HEATERS, M204, macros g-code personnalis\u00e9es Prise en charge \u00e9tendue de l'\u00e9cran LCD : Prise en charge des menus d'ex\u00e9cution Nouvelles ic\u00f4nes d'affichage Prise en charge des \u00e9crans \"uc1701\" et \"ssd1306\" Prise en charge de nouveaux micro-contr\u00f4leurs : Klipper port\u00e9 sur : LPC176x (Smoothieboards), SAM4E8E (Duet2), SAMD21 (Arduino Zero), STM32F103 (appareils \"Blue pill\"), atmega32u4 Nouveau pilote CDC USB g\u00e9n\u00e9rique impl\u00e9ment\u00e9 sur AVR, LPC176x, SAMD21 et STM32F103 Am\u00e9liorations des performances sur les processeurs ARM Le code cin\u00e9matique a \u00e9t\u00e9 r\u00e9\u00e9crit pour utiliser un \"solveur it\u00e9ratif\" Nouveaux tests automatis\u00e9s pour le logiciel h\u00f4te Klipper De nombreux nouveaux exemples de fichiers de configuration pour les imprimantes les plus courantes Mises \u00e0 jour de la documentation pour les chargeurs de d\u00e9marrage, l'analyse comparative, le portage des micro-contr\u00f4leurs, les v\u00e9rifications de configuration, le mappage des broches, les param\u00e8tres du trancheur, le packaging, et plus Plusieurs corrections de bogues et nettoyages de code Klipper 0.6.0 \u00b6 Disponible le 31/03/2018. Changements majeurs dans cette version : V\u00e9rifications am\u00e9lior\u00e9es des d\u00e9faillances mat\u00e9rielles des \u00e9l\u00e9ments chauffants et des thermistances Prise en charge des sondes Z Premi\u00e8re prise en charge de l'\u00e9talonnage automatique des param\u00e8tres sur les deltas (via une nouvelle commande delta_calibrate) Premi\u00e8re prise en charge de la compensation d'inclinaison du lit (via la commande bed_tilt_calibrate) Premi\u00e8re prise en charge de la \u00ab mise \u00e0 l'origine 's\u00fbre' \u00bb et des surcharges des mises \u00e0 l'origine Prise en charge de l'affichage de l'\u00e9tat sur les \u00e9crans RepRapDiscount style 2004 et 12864 Nouvelles am\u00e9liorations pour la multi-extrusion : Prise en charge des chauffages partag\u00e9s Prise en charge des chariots doubles (IDEX) Prise en charge de la configuration de plusieurs steppers par axe (par exemple, double Z) Prise en charge des broches de sortie num\u00e9riques et pwm personnalis\u00e9es (avec une nouvelle commande SET_PIN) Prise en charge d'une \"carte SD virtuelle\" qui permet d'imprimer directement depuis Klipper (aide sur les machines trop lentes pour bien ex\u00e9cuter OctoPrint) Prise en charge du r\u00e9glage de diff\u00e9rentes longueurs de bras sur chaque tour d'une delta Prise en charge des commandes G-Code M220/M221 (remplacement du facteur de vitesse/remplacement du facteur d'extrusion) Plusieurs mises \u00e0 jour de la documentation : De nombreux nouveaux exemples de fichiers de configuration pour les imprimantes les plus courantes Nouvel exemple de configuration multi-MCU Nouvel exemple de configuration du capteur bltouch Nouveaux documents sur la FAQ, la v\u00e9rification de la configuration et le G-Code Prise en charge des tests d'int\u00e9gration continue sur tous les commits github Plusieurs corrections de bogues et nettoyages de code Klipper 0.5.0 \u00b6 Disponible le 25/10/2017. Changements majeurs dans cette version : Prise en charge des imprimantes avec plusieurs extrudeuses. Prise en charge pour l'ex\u00e9cution sur le PRU Beaglebone. Prise en charge de la carte Replicape. Prise en charge de l'ex\u00e9cution du code du microcontr\u00f4leur dans un processus Linux en temps r\u00e9el. Prise en charge de plusieurs microcontr\u00f4leurs. (Par exemple, on pourrait contr\u00f4ler une extrudeuse avec un microcontr\u00f4leur et le reste de l'imprimante avec un autre.) Une synchronisation d'horloge logicielle est mise en \u0153uvre pour coordonner les actions entre les microcontr\u00f4leurs. Am\u00e9liorations des performances des moteurs pas \u00e0 pas (AVR 20Mhz jusqu'\u00e0 189K pas par seconde). Prise en charge du contr\u00f4le des servos et prise en charge de la d\u00e9finition des ventilateurs de refroidissement des buses. Plusieurs corrections de bogues et nettoyages de code Klipper 0.4.0 \u00b6 Disponible le 03/05/2017. Changements majeurs dans cette version : Installation am\u00e9lior\u00e9e sur les machines Raspberry Pi. La majeure partie de l'installation est maintenant script\u00e9e. Prise en charge des imprimantes corexy Mises \u00e0 jour de la documentation : nouveau document cin\u00e9matique, nouveau guide de r\u00e9glage Pressure Advance, nouveaux exemples de fichiers de configuration, et plus Am\u00e9liorations des performances des moteurs pas \u00e0 pas (AVR 20Mhz sur 175K pas par seconde, Arduino Due sur 460K) Prise en charge des r\u00e9initialisations automatiques du microcontr\u00f4leur. Prise en charge des r\u00e9initialisations via basculement de l'alimentation USB sur Raspberry Pi. L'algorithme d'avance de pression fonctionne d\u00e9sormais avec anticipation pour r\u00e9duire les changements de pression dans les virages. Prise en charge de la limitation de la vitesse maximale des mouvements courts en zigzag Prise en charge des capteurs AD595 Plusieurs corrections de bogues et nettoyages de code Klipper 0.3.0 \u00b6 Disponible le 23/12/2016. Changements majeurs dans cette version : Documentation am\u00e9lior\u00e9e Prise en charge des imprimantes avec cin\u00e9matique delta Prise en charge du microcontr\u00f4leur Arduino Due (ARM cortex-M3) Prise en charge des microcontr\u00f4leurs AVR bas\u00e9s sur USB Prise en charge de l'algorithme \"d'avance de pression\" - il r\u00e9duit le suintement pendant les impressions. Nouvelle fonctionnalit\u00e9 \"but\u00e9e de fin de course bas\u00e9e sur la phase de moteurs pas \u00e0 pas\" - permet une plus grande pr\u00e9cision sur la prise d'origine de la fin de course. Prise en charge des commandes \"g-code \u00e9tendu\" telles que \"help\", \"restart\" et \"status\". Prise en charge du rechargement de la configuration Klipper et du red\u00e9marrage du logiciel h\u00f4te en \u00e9mettant une commande \"restart\" depuis le terminal. Am\u00e9liorations des performances des moteurs pas \u00e0 pas (AVR 20Mhz jusqu'\u00e0 158K pas par seconde). Gestion des erreurs am\u00e9lior\u00e9e. La plupart des erreurs sont maintenant affich\u00e9es via le terminal avec une aide sur la fa\u00e7on de les r\u00e9soudre. Plusieurs corrections de bogues et nettoyages de code Klipper 0.2.0 \u00b6 Premi\u00e8re version de Klipper. Disponible le 25/05/2016. Les principales fonctionnalit\u00e9s disponibles dans la version initiale incluent : Prise en charge de base des imprimantes cart\u00e9siennes (moteurs pas \u00e0 pas, extrudeur, lit chauffant, ventilateur de refroidissement). Prise en charge des commandes g-code de base. Prise en charge de l'interfa\u00e7age avec OctoPrint. Acc\u00e9l\u00e9ration et gestion de l'anticipation Prise en charge des microcontr\u00f4leurs AVR via des ports s\u00e9rie standard","title":"Versions"},{"location":"Releases.html#versions","text":"Historique de versions de Klipper. Merci de vous r\u00e9f\u00e9rer a la ressource installation pour plus d'information sur l'installation de Klipper.","title":"Versions"},{"location":"Releases.html#klipper-0110","text":"Disponible le 28/11/2022. Changements majeurs dans cette version : Optimisation du pilote de moteur pas \u00e0 pas trinamic \"pas sur les deux c\u00f4t\u00e9s\" (\"step on both edges\"). Prise en charge de Python3. Le code h\u00f4te Klipper fonctionnera avec Python2 ou Python3. Prise en charge am\u00e9lior\u00e9e du bus CAN. Prise en charge du bus CAN sur les puces rp2040, stm32g0, stm32h7, same51 et same54. Prise en charge du mode \"pont USB vers bus CAN\". Prise en charge du chargeur de d\u00e9marrage CanBoot. Prise en charge des acc\u00e9l\u00e9rom\u00e8tres mpu9250 et mpu6050. Am\u00e9lioration de la gestion des erreurs pour les capteurs de temp\u00e9rature max31856, max31855, max31865 et max6675. Il est d\u00e9sormais possible de configurer les LED pour qu'elles se mettent \u00e0 jour pendant les longues commandes G-Code \u00e0 l'aide de la prise en charge du \"mod\u00e8le\" de LED. Plusieurs am\u00e9liorations sur le microcontr\u00f4leur. Nouvelle prise en charge des puces stm32h743, stm32h750, stm32l412, stm32g0b1, same70, same51 et same54. Prise en charge des lectures i2c sur atsamd et stm32f0. Prise en charge pwm mat\u00e9rielle sur stm32. Envoi d'\u00e9v\u00e9nements bas\u00e9 sur le signal Linux mcu. Nouveau support rp2040 pour \"make flash\", i2c et rp2040-e5 USB errata. Nouveaux modules ajout\u00e9s : angle, dac084S085, exclude_object, led, mpu9250, pca9632, smart_effector, z_thermal_adjust. Nouvelle cin\u00e9matique \"delt\u00e9sienne\" ajout\u00e9e. Nouvel outil dump_mcu ajout\u00e9. Plusieurs corrections de bogues et nettoyages de code.","title":"Klipper 0.11.0"},{"location":"Releases.html#klipper-0100","text":"Disponible le 29/09/2021. Changements majeurs dans cette version : Prise en charge de la mise \u00e0 l'origine \"Multi-MCU\". Il est d\u00e9sormais possible de c\u00e2bler un pilote de moteur pas \u00e0 pas et sa fin de course sur des microcontr\u00f4leurs s\u00e9par\u00e9s. Cela simplifie le c\u00e2blage des sondes Z sur les \"cartes de t\u00eate d'outil\". Klipper a maintenant un Serveur Discord et un Serveur Discourse . Le site Web de Klipper utilise d\u00e9sormais l'infrastructure \"mkdocs\". Il existe \u00e9galement un projet Klipper Translations . Prise en charge automatis\u00e9e du flash du micrologiciel via une carte SD sur de nombreuses cartes. Nouveau support cin\u00e9matique pour les imprimantes \"Hybrid CoreXY\" et \"Hybrid CoreXZ\". Klipper utilise maintenant rotation_distance pour configurer les distances de d\u00e9placement du moteur pas \u00e0 pas. Le code h\u00f4te principal de Klipper peut d\u00e9sormais communiquer directement avec les microcontr\u00f4leurs via le bus CAN. Nouveau syst\u00e8me \"d'analyse de mouvement\". Les mises \u00e0 jour des mouvements internes de Klipper et les r\u00e9sultats des capteurs peuvent \u00eatre suivis et enregistr\u00e9s pour analyse. Les pilotes de moteur pas \u00e0 pas Trinamic sont d\u00e9sormais surveill\u00e9s en permanence pour les conditions d'erreur. Prise en charge du microcontr\u00f4leur rp2040 (cartes Raspberry Pi Pico). Le syst\u00e8me \"make menuconfig\" utilise maintenant kconfiglib. De nombreux modules suppl\u00e9mentaires ajout\u00e9s : ds18b20, duplicate_pin_override, filament_motion_sensor, palette2, motion_report, pca9533, pulse_counter, save_variables, sdcard_loop, temperature_host, temperature_mcu Plusieurs corrections de bogues et nettoyages de code.","title":"Klipper 0.10.0"},{"location":"Releases.html#klipper-090","text":"Disponible le 20/10/2020. Changements majeurs dans cette version : Prise en charge de \"Input Shaping\" - un m\u00e9canisme pour contrer la r\u00e9sonance de l'imprimante. Il peut r\u00e9duire ou \u00e9liminer les \"ondulations\" dans les impressions. Nouveau syst\u00e8me \"Smooth Pressure Advance\". Cela impl\u00e9mente \"Pressure Advance\" sans introduire de changements de vitesse instantan\u00e9s. Il est d\u00e9sormais possible de r\u00e9gler l'avance de pression \u00e0 l'aide d'une m\u00e9thode \"Tour de r\u00e9glage\". Nouveau serveur API \"webhooks\". Fournit une interface JSON programmable \u00e0 Klipper. L'\u00e9cran LCD et le menu sont d\u00e9sormais configurables \u00e0 l'aide du langage Jinja2. Les pilotes de moteur pas \u00e0 pas TMC2208 peuvent d\u00e9sormais \u00eatre utilis\u00e9s en mode \"standalone\" avec Klipper. Prise en charge am\u00e9lior\u00e9e du BL-Touch v3. Identification USB am\u00e9lior\u00e9e. Klipper dispose d\u00e9sormais de son propre code d'identification USB et les micro-contr\u00f4leurs peuvent d\u00e9sormais signaler leurs num\u00e9ros de s\u00e9rie lors de l'identification USB. Nouveau support cin\u00e9matique pour les imprimantes \"Rotary Delta\" et \"CoreXZ\". Am\u00e9liorations du microcontr\u00f4leur : prise en charge de stm32f070, prise en charge de stm32f207, prise en charge des broches GPIO sur \"Linux MCU\", prise en charge du \"chargeur de d\u00e9marrage HID\" stm32, prise en charge du chargeur de d\u00e9marrage Chitu, prise en charge du chargeur de d\u00e9marrage MKS Robin. Am\u00e9lioration de la gestion des \u00e9v\u00e9nements Python pour \"garbage collection\". Nombreux modules suppl\u00e9mentaires ajout\u00e9s : adc_scaled, adxl345, bme280, display_status, extruder_stepper, fan_generic, hall_filament_width_sensor, htu21d, homing_heaters, input_shaper, lm75, print_stats, resonance_tester, shaper_calibrate, query_adc, graph_accelerometer, graph_extruder, graph_motion, graph_shaper, graph_temp_sensor, whconsole Plusieurs corrections de bogues et nettoyages de code.","title":"Klipper 0.9.0"},{"location":"Releases.html#klipper-091","text":"Disponible le 28/10/2020. Version contenant uniquement des corrections de bogues.","title":"Klipper 0.9.1"},{"location":"Releases.html#klipper-080","text":"Disponible le 21/10/2019. Changements majeurs dans cette version : Prise en charge du nouveau mod\u00e8le de commande G-Code. Le G-Code dans le fichier de configuration est maintenant \u00e9valu\u00e9 avec le langage Jinja2. Am\u00e9liorations de la gestion des pilotes pas \u00e0 pas Trinamic : Nouvelle prise en charge pour les pilotes TMC2209 et TMC5160. Commandes G-Code DUMP_TMC, SET_TMC_CURRENT et INIT_TMC am\u00e9lior\u00e9es. Prise en charge am\u00e9lior\u00e9e de la gestion TMC UART avec un multiplexage analogique. Prise en charge am\u00e9lior\u00e9e de la mise \u00e0 l'origine, du sondage et de la mise \u00e0 niveau du lit : Nouveaux modules manual_probe, bed_screws, screw_tilt_adjust, skew_correction, safe_z_home ajout\u00e9s. Sondage multi-\u00e9chantillons am\u00e9lior\u00e9 avec une logique de m\u00e9diane, de moyenne et de nouvel essai. Documentation am\u00e9lior\u00e9e pour le BL-Touch, l'\u00e9talonnage de la sonde, l'\u00e9talonnage de la fin de course, l'\u00e9talonnage des imprimantes delta, la mise \u00e0 l'origine sans capteur et l'\u00e9talonnage de la phase de fin de course. Prise en charge am\u00e9lior\u00e9e de la mise \u00e0 l'origine sur un axe Z de grande taille. De nombreuses am\u00e9liorations du micro-contr\u00f4leur Klipper : Klipper port\u00e9 sur : SAM3X8C, SAM4S8C, SAMD51, STM32F042, STM32F4 Nouvelles impl\u00e9mentations des pilotes USB CDC sur SAM3X, SAM4, STM32F4. Prise en charge am\u00e9lior\u00e9e du flashage de Klipper via USB. Prise en charge du SPI logiciel. Filtrage de temp\u00e9rature grandement am\u00e9lior\u00e9 sur le capteur LPC176x. Les param\u00e8tres de d\u00e9marrage des broches de sortie peuvent \u00eatre configur\u00e9s dans le micro-contr\u00f4leur. Nouveau site web avec la documentation Klipper : http://klipper3d.org/ Klipper a maintenant un logo. Support exp\u00e9rimental pour la cin\u00e9matique polaire et \"treuil \u00e0 c\u00e2ble\". Le fichier de configuration peut maintenant inclure d'autres fichiers de configuration. De nombreux modules suppl\u00e9mentaires ajout\u00e9s : board_pins, controller_fan, delay_gcode, dotstar, filament_switch_sensor, firmware_retraction, gcode_arcs, gcode_button, heater_generic, manual_stepper, mcp4018, mcp4728, neopixel, pause_resume, respond, temperature_sensor tsl1401cl_filament_width_sensor, tuning_tower De nombreuses commandes suppl\u00e9mentaires ajout\u00e9es : RESTORE_GCODE_STATE, SAVE_GCODE_STATE, SET_GCODE_VARIABLE, SET_HEATER_TEMPERATURE, SET_IDLE_TIMEOUT, SET_TEMPERATURE_FAN_TARGET Plusieurs corrections de bogues et nettoyages de code.","title":"Klipper 0.8.0"},{"location":"Releases.html#klipper-070","text":"Disponible le 20/12/2018. Changements majeurs dans cette version : Klipper prend d\u00e9sormais en charge le nivellement du lit par maillage Nouvel \u00e9talonnage des imprimantes delta \"am\u00e9lior\u00e9\" (\u00e9talonne les dimensions d'impression x/y sur les imprimantes delta) Gestion de la configuration pendant l'ex\u00e9cution des pilotes de moteur pas \u00e0 pas Trinamic (tmc2130, tmc2208, tmc2660) Prise en charge am\u00e9lior\u00e9e des capteurs de temp\u00e9rature : MAX6675, MAX31855, MAX31856, MAX31865, thermistances personnalis\u00e9es, capteurs de style pt100 Plusieurs nouveaux modules : temperature_fan, sx1509, force_move, mcp4451, z_tilt, quad_gantry_level, endstop_phase, bltouch Plusieurs nouvelles commandes ajout\u00e9es : SAVE_CONFIG, SET_PRESSURE_ADVANCE, SET_GCODE_OFFSET, SET_VELOCITY_LIMIT, STEPPER_BUZZ, TURN_OFF_HEATERS, M204, macros g-code personnalis\u00e9es Prise en charge \u00e9tendue de l'\u00e9cran LCD : Prise en charge des menus d'ex\u00e9cution Nouvelles ic\u00f4nes d'affichage Prise en charge des \u00e9crans \"uc1701\" et \"ssd1306\" Prise en charge de nouveaux micro-contr\u00f4leurs : Klipper port\u00e9 sur : LPC176x (Smoothieboards), SAM4E8E (Duet2), SAMD21 (Arduino Zero), STM32F103 (appareils \"Blue pill\"), atmega32u4 Nouveau pilote CDC USB g\u00e9n\u00e9rique impl\u00e9ment\u00e9 sur AVR, LPC176x, SAMD21 et STM32F103 Am\u00e9liorations des performances sur les processeurs ARM Le code cin\u00e9matique a \u00e9t\u00e9 r\u00e9\u00e9crit pour utiliser un \"solveur it\u00e9ratif\" Nouveaux tests automatis\u00e9s pour le logiciel h\u00f4te Klipper De nombreux nouveaux exemples de fichiers de configuration pour les imprimantes les plus courantes Mises \u00e0 jour de la documentation pour les chargeurs de d\u00e9marrage, l'analyse comparative, le portage des micro-contr\u00f4leurs, les v\u00e9rifications de configuration, le mappage des broches, les param\u00e8tres du trancheur, le packaging, et plus Plusieurs corrections de bogues et nettoyages de code","title":"Klipper 0.7.0"},{"location":"Releases.html#klipper-060","text":"Disponible le 31/03/2018. Changements majeurs dans cette version : V\u00e9rifications am\u00e9lior\u00e9es des d\u00e9faillances mat\u00e9rielles des \u00e9l\u00e9ments chauffants et des thermistances Prise en charge des sondes Z Premi\u00e8re prise en charge de l'\u00e9talonnage automatique des param\u00e8tres sur les deltas (via une nouvelle commande delta_calibrate) Premi\u00e8re prise en charge de la compensation d'inclinaison du lit (via la commande bed_tilt_calibrate) Premi\u00e8re prise en charge de la \u00ab mise \u00e0 l'origine 's\u00fbre' \u00bb et des surcharges des mises \u00e0 l'origine Prise en charge de l'affichage de l'\u00e9tat sur les \u00e9crans RepRapDiscount style 2004 et 12864 Nouvelles am\u00e9liorations pour la multi-extrusion : Prise en charge des chauffages partag\u00e9s Prise en charge des chariots doubles (IDEX) Prise en charge de la configuration de plusieurs steppers par axe (par exemple, double Z) Prise en charge des broches de sortie num\u00e9riques et pwm personnalis\u00e9es (avec une nouvelle commande SET_PIN) Prise en charge d'une \"carte SD virtuelle\" qui permet d'imprimer directement depuis Klipper (aide sur les machines trop lentes pour bien ex\u00e9cuter OctoPrint) Prise en charge du r\u00e9glage de diff\u00e9rentes longueurs de bras sur chaque tour d'une delta Prise en charge des commandes G-Code M220/M221 (remplacement du facteur de vitesse/remplacement du facteur d'extrusion) Plusieurs mises \u00e0 jour de la documentation : De nombreux nouveaux exemples de fichiers de configuration pour les imprimantes les plus courantes Nouvel exemple de configuration multi-MCU Nouvel exemple de configuration du capteur bltouch Nouveaux documents sur la FAQ, la v\u00e9rification de la configuration et le G-Code Prise en charge des tests d'int\u00e9gration continue sur tous les commits github Plusieurs corrections de bogues et nettoyages de code","title":"Klipper 0.6.0"},{"location":"Releases.html#klipper-050","text":"Disponible le 25/10/2017. Changements majeurs dans cette version : Prise en charge des imprimantes avec plusieurs extrudeuses. Prise en charge pour l'ex\u00e9cution sur le PRU Beaglebone. Prise en charge de la carte Replicape. Prise en charge de l'ex\u00e9cution du code du microcontr\u00f4leur dans un processus Linux en temps r\u00e9el. Prise en charge de plusieurs microcontr\u00f4leurs. (Par exemple, on pourrait contr\u00f4ler une extrudeuse avec un microcontr\u00f4leur et le reste de l'imprimante avec un autre.) Une synchronisation d'horloge logicielle est mise en \u0153uvre pour coordonner les actions entre les microcontr\u00f4leurs. Am\u00e9liorations des performances des moteurs pas \u00e0 pas (AVR 20Mhz jusqu'\u00e0 189K pas par seconde). Prise en charge du contr\u00f4le des servos et prise en charge de la d\u00e9finition des ventilateurs de refroidissement des buses. Plusieurs corrections de bogues et nettoyages de code","title":"Klipper 0.5.0"},{"location":"Releases.html#klipper-040","text":"Disponible le 03/05/2017. Changements majeurs dans cette version : Installation am\u00e9lior\u00e9e sur les machines Raspberry Pi. La majeure partie de l'installation est maintenant script\u00e9e. Prise en charge des imprimantes corexy Mises \u00e0 jour de la documentation : nouveau document cin\u00e9matique, nouveau guide de r\u00e9glage Pressure Advance, nouveaux exemples de fichiers de configuration, et plus Am\u00e9liorations des performances des moteurs pas \u00e0 pas (AVR 20Mhz sur 175K pas par seconde, Arduino Due sur 460K) Prise en charge des r\u00e9initialisations automatiques du microcontr\u00f4leur. Prise en charge des r\u00e9initialisations via basculement de l'alimentation USB sur Raspberry Pi. L'algorithme d'avance de pression fonctionne d\u00e9sormais avec anticipation pour r\u00e9duire les changements de pression dans les virages. Prise en charge de la limitation de la vitesse maximale des mouvements courts en zigzag Prise en charge des capteurs AD595 Plusieurs corrections de bogues et nettoyages de code","title":"Klipper 0.4.0"},{"location":"Releases.html#klipper-030","text":"Disponible le 23/12/2016. Changements majeurs dans cette version : Documentation am\u00e9lior\u00e9e Prise en charge des imprimantes avec cin\u00e9matique delta Prise en charge du microcontr\u00f4leur Arduino Due (ARM cortex-M3) Prise en charge des microcontr\u00f4leurs AVR bas\u00e9s sur USB Prise en charge de l'algorithme \"d'avance de pression\" - il r\u00e9duit le suintement pendant les impressions. Nouvelle fonctionnalit\u00e9 \"but\u00e9e de fin de course bas\u00e9e sur la phase de moteurs pas \u00e0 pas\" - permet une plus grande pr\u00e9cision sur la prise d'origine de la fin de course. Prise en charge des commandes \"g-code \u00e9tendu\" telles que \"help\", \"restart\" et \"status\". Prise en charge du rechargement de la configuration Klipper et du red\u00e9marrage du logiciel h\u00f4te en \u00e9mettant une commande \"restart\" depuis le terminal. Am\u00e9liorations des performances des moteurs pas \u00e0 pas (AVR 20Mhz jusqu'\u00e0 158K pas par seconde). Gestion des erreurs am\u00e9lior\u00e9e. La plupart des erreurs sont maintenant affich\u00e9es via le terminal avec une aide sur la fa\u00e7on de les r\u00e9soudre. Plusieurs corrections de bogues et nettoyages de code","title":"Klipper 0.3.0"},{"location":"Releases.html#klipper-020","text":"Premi\u00e8re version de Klipper. Disponible le 25/05/2016. Les principales fonctionnalit\u00e9s disponibles dans la version initiale incluent : Prise en charge de base des imprimantes cart\u00e9siennes (moteurs pas \u00e0 pas, extrudeur, lit chauffant, ventilateur de refroidissement). Prise en charge des commandes g-code de base. Prise en charge de l'interfa\u00e7age avec OctoPrint. Acc\u00e9l\u00e9ration et gestion de l'anticipation Prise en charge des microcontr\u00f4leurs AVR via des ports s\u00e9rie standard","title":"Klipper 0.2.0"},{"location":"Resonance_Compensation.html","text":"Compensation de la r\u00e9sonance \u00b6 Klipper prend en charge l'input shaper, une technique utilis\u00e9e pour r\u00e9duire l'effet de la r\u00e9sonance (\u00e9galement connu sous le nom d'\u00e9cho, d'image fant\u00f4me - \"ghosting\" - ou d'ondulation - \"ringing\") dans les impressions. La r\u00e9sonance est un d\u00e9faut d'impression de la surface lorsque des \u00e9l\u00e9ments tels que des bords se r\u00e9p\u00e8tent sous la forme d'un l\u00e9ger \"\u00e9cho\" : | | | La r\u00e9sonance est caus\u00e9e par des vibrations m\u00e9caniques dans l'imprimante dues \u00e0 des changements rapides de direction pendant l'impression. La r\u00e9sonance a g\u00e9n\u00e9ralement des origines m\u00e9caniques : cadre de l'imprimante insuffisamment rigide, courroies non tendues ou trop \u00e9lastiques, probl\u00e8mes d'alignement des pi\u00e8ces m\u00e9caniques, masse mobile importante, etc. Ces probl\u00e8mes doivent \u00eatre v\u00e9rifi\u00e9s et corrig\u00e9s en premier lieu, si possible. L' input shaping est une technique de contr\u00f4le en boucle ouverte qui cr\u00e9e un signal de commande annulant ses propres vibrations. L'input shaping n\u00e9cessite quelques r\u00e9glages et mesures avant de pouvoir \u00eatre activ\u00e9e. Outre la r\u00e9sonance, l'input shaping r\u00e9duit aussi les vibrations et les secousses de l'imprimante en g\u00e9n\u00e9ral, et peut \u00e9galement am\u00e9liorer la fiabilit\u00e9 du mode stealthChop des pilotes Trinamic. R\u00e9glages \u00b6 Le r\u00e9glage de base n\u00e9cessite de mesurer les fr\u00e9quences de r\u00e9sonance de l'imprimante en imprimant un mod\u00e8le de test. Tranchez le mod\u00e8le de test de r\u00e9sonance, qui se trouve dans docs/prints/ringing_tower.stl , avec votre trancheur : La hauteur de couche recommand\u00e9e est de 0,2 ou 0,25 mm. Le remplissage et le nombre de couches sup\u00e9rieures peuvent \u00eatre r\u00e9gl\u00e9s sur 0. Utilisez 1 ou 2 parois, ou mieux encore le mode vase avec 1 ou 2 mm de base. Utilisez une vitesse suffisamment \u00e9lev\u00e9e, entre 80 et 100 mm/s, pour les parois externes . Veillez \u00e0 ce que le temps minimum par couche soit au maximum de 3 secondes. Assurez-vous que toutes les options de \"contr\u00f4le d'acc\u00e9l\u00e9ration\" soient bien d\u00e9sactiv\u00e9es dans le trancheur. Ne tournez pas le mod\u00e8le. Le mod\u00e8le comporte des marques X et Y \u00e0 l'arri\u00e8re du mod\u00e8le. L'emplacement inhabituel des marques par rapport aux axes de l'imprimante n'est pas une erreur. Ces marques pourront \u00eatre utilis\u00e9es plus tard - comme r\u00e9f\u00e9rence - dans le processus de r\u00e9glage, car elles indiquent \u00e0 quel axe correspondent les mesures. Fr\u00e9quence de r\u00e9sonance \u00b6 En premier lieu, mesurez la fr\u00e9quence de r\u00e9sonance . Si le param\u00e8tre square_corner_velocity a \u00e9t\u00e9 modifi\u00e9, remettez-le \u00e0 5.0. Il n'est pas conseill\u00e9 de l'augmenter lors de l'utilisation de l'input shaper car cela peut provoquer plus de lissage dans les pi\u00e8ces - il est pr\u00e9f\u00e9rable d'utiliser une valeur d'acc\u00e9l\u00e9ration plus \u00e9lev\u00e9e \u00e0 la place. Augmentez max_accel_to_decel en lan\u00e7ant la commande suivante : SET_VELOCITY_LIMIT ACCEL_TO_DECEL=7000 D\u00e9sactivez l'avance de pression : SET_PRESSURE_ADVANCE ADVANCE=0 Si vous avez d\u00e9j\u00e0 ajout\u00e9 la section [input_shaper] au fichier printer.cfg, ex\u00e9cutez la commande SET_INPUT_SHAPER SHAPER_FREQ_X=0 SHAPER_FREQ_Y=0 . Si vous obtenez l'erreur \"Unknown command\", vous pouvez l'ignorer - pour le moment - et continuer les mesures. Ex\u00e9cutez la commande : TUNING_TOWER COMMAND=SET_VELOCITY_LIMIT PARAMETER=ACCEL START=1500 STEP_DELTA=500 STEP_HEIGHT=5 Dans la pratique, nous essayons de rendre la r\u00e9sonance plus prononc\u00e9e en d\u00e9finissant diff\u00e9rentes valeurs \u00e9lev\u00e9es pour l'acc\u00e9l\u00e9ration. Cette commande augmentera l'acc\u00e9l\u00e9ration tous les 5 mm \u00e0 partir de 1500 mm/sec\u00b2 : 1500 mm/sec\u00b2, 2000 mm/sec\u00b2, 2500 mm/sec\u00b2 et ainsi de suite jusqu'\u00e0 7000 mm/sec\u00b2 pour la derni\u00e8re bande. Imprimez le mod\u00e8le de test tranch\u00e9 avec les param\u00e8tres indiqu\u00e9s. Vous pouvez arr\u00eater l'impression avant la fin si la r\u00e9sonance est clairement visible et si vous constatez que l'acc\u00e9l\u00e9ration devient trop forte pour votre imprimante (par exemple, l'imprimante tremble trop ou commence \u00e0 sauter des pas). Utilisez les marques X et Y \u00e0 l'arri\u00e8re du mod\u00e8le comme r\u00e9f\u00e9rence. Les mesures du c\u00f4t\u00e9 avec la marque X doivent \u00eatre utilis\u00e9es pour la configuration de l'axe X, et les mesures du c\u00f4t\u00e9 avec la marque Y pour la configuration de l'axe Y. Mesurez la distance D (en mm) entre plusieurs oscillations sur la partie de la pi\u00e8ce avec la marque X, pr\u00e8s des encoches et en sautant de pr\u00e9f\u00e9rence la ou les deux premi\u00e8res oscillations. Pour mesurer plus facilement la distance entre les oscillations, marquez d'abord les oscillations, puis mesurez la distance entre les marques avec une r\u00e8gle ou un pied \u00e0 coulisse :| | | Comptez le nombre d'oscillations N correspondant \u00e0 la distance mesur\u00e9e D . Si vous ne savez pas comment compter les oscillations, reportez-vous \u00e0 l'image ci-dessus, qui montre N = 6 oscillations. Calculez la fr\u00e9quence de r\u00e9sonance de l'axe X : V \u00b7 N / D (Hz), o\u00f9 V est la vitesse des p\u00e9rim\u00e8tres ext\u00e9rieurs (mm/s). Pour l'exemple ci-dessus, nous avons marqu\u00e9 6 oscillations (N) sur une distance de 12,14 mm (D), et le test a \u00e9t\u00e9 imprim\u00e9 \u00e0 une vitesse de 100 mm/s (V), donc la fr\u00e9quence est 100 * 6 / 12,14 \u2248 49,4 Hz. Faites (8) - (10) pour la marque Y \u00e9galement. Notez que la r\u00e9sonance sur l'impression de test devrait suivre les encoches courb\u00e9es de la pi\u00e8ce, comme dans l'image ci-dessus. Si ce n'est pas le cas, alors ce d\u00e9faut n'est pas vraiment une r\u00e9sonance et a probablement une origine diff\u00e9rente - soit m\u00e9canique, soit un probl\u00e8me d'extrudeuse. Ce probl\u00e8me doit \u00eatre r\u00e9solu avant d'activer et de r\u00e9gler les input shapers. Si les mesures ne sont pas fiables parce que, par exemple, la distance entre les oscillations n'est pas r\u00e9guli\u00e8re, cela peut signifier que l'imprimante a plusieurs fr\u00e9quences de r\u00e9sonance sur le m\u00eame axe. On peut essayer de suivre le processus de r\u00e9glage d\u00e9crit dans la section Mesures peu fiables des fr\u00e9quences de r\u00e9sonance \u00e0 la place et obtenir quand m\u00eame une am\u00e9lioration gr\u00e2ce \u00e0 l'input shaping. La fr\u00e9quence de r\u00e9sonance peut d\u00e9pendre de la position du mod\u00e8le sur le plateau et de la hauteur Z, surtout sur les imprimantes delta ; vous pouvez v\u00e9rifier si vous observez des diff\u00e9rences de fr\u00e9quences \u00e0 diff\u00e9rentes positions le long des c\u00f4t\u00e9s du mod\u00e8le de test et \u00e0 diff\u00e9rentes hauteurs. Si c'est le cas, vous pouvez calculer les fr\u00e9quences de r\u00e9sonance moyennes sur les axes X et Y. Si la fr\u00e9quence de r\u00e9sonance mesur\u00e9e est tr\u00e8s basse (inf\u00e9rieure \u00e0 20-25 Hz), il peut \u00eatre judicieux de penser \u00e0 rigidifier la structure de l'imprimante ou \u00e0 r\u00e9duire la masse mobile - dans la mesure du possible - avant de poursuivre le r\u00e9glage de l'input shaping et de mesurer \u00e0 nouveau les fr\u00e9quences. Pour de nombreux mod\u00e8les d'imprimantes populaires, il existe souvent des solutions d\u00e9j\u00e0 disponibles. Les fr\u00e9quences de r\u00e9sonance peuvent changer si des modifications sont apport\u00e9es \u00e0 l'imprimante qui affectent la masse en mouvement ou modifient la rigidit\u00e9 du syst\u00e8me, par exemple : Si la t\u00eate d'impression est modifi\u00e9e, par ex. changement de moteur pas \u00e0 pas (plus lourd ou plus l\u00e9ger) pour une extrusion directe, remplacement de la t\u00eate de l'outil (plus ou moins lourde), ajout d'un ventilateur plus lourd, etc. La tension des courroies a \u00e9t\u00e9 modifi\u00e9e. Des pi\u00e8ces con\u00e7ues pour augmenter la rigidit\u00e9 du cadre sont install\u00e9es. Un plateau diff\u00e9rent est install\u00e9 sur une imprimante \u00e0 lit mobile, ou une plaque de verre est ajout\u00e9e, etc. Si de telles modifications sont apport\u00e9es, Il est conseill\u00e9 - au minimum - de mesurer les fr\u00e9quences de r\u00e9sonance pour v\u00e9rifier s'il elles ont chang\u00e9es (ou pas). Configuration de l'input shaper \u00b6 Une fois les fr\u00e9quences de r\u00e9sonance des axes X et Y mesur\u00e9es, vous pouvez ajouter la section suivante \u00e0 votre fichier printer.cfg : [input_shaper] shaper_freq_x: ... # frequence pour la marque X sur le mod\u00e8le de test shaper_freq_y: ... # frequence pour la marque Y sur le mod\u00e8le de test Pour l'exemple ci-dessus, nous obtenons shaper_freq_x/y = 49,4. Choix de l'input shaper \u00b6 Klipper prend en charge plusieurs type d'\"input shaper\". Ils diff\u00e8rent par leur sensibilit\u00e9 aux erreurs d\u00e9terminant la fr\u00e9quence de r\u00e9sonance et le degr\u00e9 de lissage qu'ils provoquent dans les pi\u00e8ces imprim\u00e9es. De plus, certains de ces \"input shaper\" comme 2HUMP_EI et 3HUMP_EI ne doivent g\u00e9n\u00e9ralement pas \u00eatre utilis\u00e9s avec shaper_freq = fr\u00e9quence de r\u00e9sonance - ils sont configur\u00e9s \u00e0 partir de diff\u00e9rentes consid\u00e9rations pour r\u00e9duire plusieurs r\u00e9sonances \u00e0 la fois (ndt\u202f: le 2HUMP_EI est \u00e0 utiliser lorsque deux pics de r\u00e9sonance sont d\u00e9tect\u00e9s, le 3HUMP_EI est \u00e0 utiliser lorsque trois pics de r\u00e9sonance sont d\u00e9tect\u00e9s). Pour la plupart des imprimantes, les types MZV ou EI sont recommand\u00e9s. Cette section d\u00e9crit un processus de test pour choisir entre eux et d\u00e9terminer quelques autres param\u00e8tres connexes. Imprimez le mod\u00e8le de test de r\u00e9sonance comme suit : Red\u00e9marrez le micrologiciel : RESTART Pr\u00e9parez-vous pour le test : SET_VELOCITY_LIMIT ACCEL_TO_DECEL=7000 D\u00e9sactivez l'avance de pression : SET_PRESSURE_ADVANCE ADVANCE=0 Ex\u00e9cutez : SET_INPUT_SHAPER SHAPER_TYPE=MZV Ex\u00e9cutez la commande : TUNING_TOWER COMMAND=SET_VELOCITY_LIMIT PARAMETER=ACCEL START=1500 STEP_DELTA=500 STEP_HEIGHT=5 Imprimez le mod\u00e8le de test tranch\u00e9 avec les param\u00e8tres indiqu\u00e9s. Si vous ne voyez pas de r\u00e9sonance \u00e0 ce stade, l'utilisation du type MZV peut \u00eatre recommand\u00e9e. Si vous voyez une r\u00e9sonance, mesurez \u00e0 nouveau les fr\u00e9quences en suivant les \u00e9tapes (8) \u00e0 (10) d\u00e9crites dans la section Fr\u00e9quence de r\u00e9sonance . Si les fr\u00e9quences diff\u00e8rent consid\u00e9rablement des valeurs obtenues pr\u00e9c\u00e9demment, une configuration d'input shaper plus complexe est n\u00e9cessaire. Vous pouvez vous r\u00e9f\u00e9rer aux d\u00e9tails techniques de la section Input shapers . Sinon, passez \u00e0 l'\u00e9tape suivante. Essayez l'input shaper EI. Pour l'essayer, r\u00e9p\u00e9tez les \u00e9tapes (1) \u00e0 (6) ci-dessus, mais en ex\u00e9cutant \u00e0 l'\u00e9tape 4 la commande suivante \u00e0 la place : SET_INPUT_SHAPER SHAPER_TYPE=EI . Comparez deux impressions avec les types MZV et EI. Si EI montre des r\u00e9sultats sensiblement meilleurs que MZV, utilisez EI, sinon pr\u00e9f\u00e9rez MZV. Notez que le type EI provoquera plus de lissage dans les pi\u00e8ces imprim\u00e9es (voir la section suivante pour plus de d\u00e9tails). Ajoutez le param\u00e8tre shaper_type: mzv (ou ei) \u00e0 la section [input_shaper], par exemple : [input_shaper] shaper_freq_x: ... shaper_freq_y: ... shaper_type: mzv Quelques notes sur le choix de l'input shaper : Le type EI peut \u00eatre plus adapt\u00e9 aux imprimantes \u00e0 lit mobile (si la fr\u00e9quence de r\u00e9sonance et le lissage r\u00e9sultant le permettent) : plus le filament est d\u00e9pos\u00e9 sur le lit en mouvement, plus la masse du lit augmente et la fr\u00e9quence de r\u00e9sonance diminue. \u00c9tant donn\u00e9 que le type EI est plus robuste aux changements de fr\u00e9quence de r\u00e9sonance, il peut \u00eatre plus efficace lors de l'impression de grandes pi\u00e8ces. En raison de la nature de la cin\u00e9matique delta, les fr\u00e9quences de r\u00e9sonance peuvent diff\u00e9rer consid\u00e9rablement dans diff\u00e9rentes parties du volume de construction. Par cons\u00e9quent, le type EI peut \u00eatre mieux adapt\u00e9 aux imprimantes delta plut\u00f4t que MZV ou ZV. Si la fr\u00e9quence de r\u00e9sonance est suffisamment grande (plus de 50-60 Hz), alors on peut m\u00eame essayer de tester 2HUMP_EI (en ex\u00e9cutant le test sugg\u00e9r\u00e9 ci-dessus avec SET_INPUT_SHAPER SHAPER_TYPE=2HUMP_EI ), mais v\u00e9rifiez les consid\u00e9rations dans la section ci-dessous avant de l'activer. S\u00e9lection de max_accel \u00b6 Vous devriez obtenir le test imprim\u00e9 avec l'input shaper choisi \u00e0 l'\u00e9tape pr\u00e9c\u00e9dente (si vous ne le faites pas, imprimez le mod\u00e8le de test d\u00e9coup\u00e9 avec les param\u00e8tres sugg\u00e9r\u00e9s avec l'avance de pression d\u00e9sactiv\u00e9e SET_PRESSURE_ADVANCE ADVANCE=0 et avec la tour de r\u00e9glage activ\u00e9e comme TUNING_TOWER COMMAND=SET_VELOCITY_LIMIT PARAMETER=ACCEL START=1500 STEP_DELTA=500 STEP_HEIGHT=5 ). Notez qu'\u00e0 des acc\u00e9l\u00e9rations tr\u00e8s \u00e9lev\u00e9es, selon la fr\u00e9quence de r\u00e9sonance et l'input shaper choisi (par exemple, le shaper EI cr\u00e9e plus de lissage que MZV), cela peut provoquer trop de lissage et d'arrondi des pi\u00e8ces. Ainsi, max_accel doit \u00eatre choisi de mani\u00e8re \u00e0 l'\u00e9viter. Un autre param\u00e8tre ayant un impact sur le lissage est square_corner_velocity , il n'est donc pas conseill\u00e9 de l'augmenter au-dessus de la valeur par d\u00e9faut de 5 mm/s pour \u00e9viter un lissage accru. Afin de s\u00e9lectionner une valeur correcte pour max_accel, inspectez le mod\u00e8le imprim\u00e9 pour l'input shaper choisi. Tout d'abord, notez \u00e0 quelle acc\u00e9l\u00e9ration la r\u00e9sonance reste imperceptible. Ensuite, v\u00e9rifiez le lissage. Pour vous aider, le mod\u00e8le de test a un petit espace dans la paroi (0,15 mm) : \u00c0 mesure que l'acc\u00e9l\u00e9ration augmente, le lissage augmente \u00e9galement et l'espacement r\u00e9el dans l'impression s'\u00e9largit : Sur cette image, l'acc\u00e9l\u00e9ration augmente de gauche \u00e0 droite, et l'\u00e9cart commence \u00e0 cro\u00eetre \u00e0 partir de 3500 mm/s\u00b2 (5\u00e8me bande \u00e0 partir de la gauche). Dans ce cas, la valeur pour max_accel = 3000 (mm/s\u00b2) permet d'\u00e9viter un lissage excessif. Notez l'acc\u00e9l\u00e9ration lorsque l'\u00e9cart est encore tr\u00e8s faible dans votre test d'impression. Si vous voyez des renflements, mais aucun espace dans le mur, m\u00eame \u00e0 des acc\u00e9l\u00e9rations \u00e9lev\u00e9es, cela peut \u00eatre d\u00fb \u00e0 une avance de pression (PA) d\u00e9sactiv\u00e9e, en particulier sur les extrudeurs de type Bowden. Si tel est le cas, vous devrez peut-\u00eatre relancer l'impression avec le PA activ\u00e9. Cela peut \u00e9galement \u00eatre le r\u00e9sultat d'un extrudeur mal calibr\u00e9 (trop \u00e9lev\u00e9), il faut donc v\u00e9rifier cela aussi. Choisissez la valeur minimale des deux valeurs d'acc\u00e9l\u00e9ration (de la r\u00e9sonance et du lissage) et affectez-l\u00e0 \u00e0 max_accel dans printer.cfg. Notez qu'il peut arriver - en particulier \u00e0 des fr\u00e9quences de r\u00e9sonance basses - que l'input shaper EI provoque trop de lissage, m\u00eame \u00e0 des acc\u00e9l\u00e9rations faibles. Dans ce cas, MZV peut \u00eatre un meilleur choix, car il peut permettre des valeurs d'acc\u00e9l\u00e9ration plus \u00e9lev\u00e9es. \u00c0 des fr\u00e9quences de r\u00e9sonance tr\u00e8s basses (~ 25 Hz et moins), m\u00eame l'input shaper MZV peut cr\u00e9er trop de lissage. Si tel est le cas, vous pouvez \u00e9galement essayer de r\u00e9p\u00e9ter les \u00e9tapes de la section Choix de l'input shaper avec l'input shaper ZV, en utilisant la commande SET_INPUT_SHAPER SHAPER_TYPE=ZV \u00e0 la place. L'input shaper ZV devrait montrer encore moins de lissage que MZV, mais il est plus sensible aux erreurs de mesure des fr\u00e9quences de r\u00e9sonance. Si une fr\u00e9quence de r\u00e9sonance est trop faible (inf\u00e9rieure \u00e0 20-25 Hz), il peut \u00eatre judicieux d'augmenter la rigidit\u00e9 de l'imprimante ou de r\u00e9duire la masse en mouvement. Sinon, l'acc\u00e9l\u00e9ration et la vitesse d'impression peuvent \u00eatre limit\u00e9es en raison d'un lissage trop important qui remplacera la r\u00e9sonance. R\u00e9glage fin des fr\u00e9quences de r\u00e9sonance \u00b6 Notez que la pr\u00e9cision des mesures des fr\u00e9quences de r\u00e9sonance \u00e0 l'aide du mod\u00e8le de test de r\u00e9sonance est suffisante dans la plupart des cas, donc un r\u00e9glage suppl\u00e9mentaire n'est pas utile. Si vous voulez toujours essayer de rev\u00e9rifier vos r\u00e9sultats (par exemple, si vous voyez toujours une r\u00e9sonance apr\u00e8s avoir imprim\u00e9 un mod\u00e8le de test avec un input shaper de votre choix avec les fr\u00e9quences mesur\u00e9es pr\u00e9c\u00e9demment), vous pouvez suivre les \u00e9tapes de cette section. Notez que si vous voyez une r\u00e9sonance \u00e0 diff\u00e9rentes fr\u00e9quences apr\u00e8s avoir activ\u00e9 [input_shaper], cette section ne vous aidera pas. En consid\u00e9rant que vous avez tranch\u00e9 le mod\u00e8le de r\u00e9sonance avec les param\u00e8tres sugg\u00e9r\u00e9s, effectuez les \u00e9tapes suivantes pour chacun des axes X et Y : Pr\u00e9parez-vous pour le test : SET_VELOCITY_LIMIT ACCEL_TO_DECEL=7000 Assurez-vous que l'avance de pression est d\u00e9sactiv\u00e9e : SET_PRESSURE_ADVANCE ADVANCE=0 Ex\u00e9cutez : SET_INPUT_SHAPER SHAPER_TYPE=ZV \u00c0 partir du mod\u00e8le de test de r\u00e9sonance imprim\u00e9 avec l'input shaper choisi, s\u00e9lectionnez l'acc\u00e9l\u00e9ration montrant suffisamment bien la r\u00e9sonance et d\u00e9finissez-la avec : SET_VELOCITY_LIMIT ACCEL=... Calculez les param\u00e8tres n\u00e9cessaires pour que la commande TUNING_TOWER r\u00e8gle le param\u00e8tre shaper_freq_x comme suit : start = shaper_freq_x * 83 / 132 et factor = shaper_freq_x / 66, o\u00f9 shaper_freq_x est la valeur indiqu\u00e9e dans printer.cfg . Ex\u00e9cutez la commande : TUNING_TOWER COMMAND=SET_INPUT_SHAPER PARAMETER=SHAPER_FREQ_X START=start FACTOR=factor BAND=5 en utilisant les valeurs start et factor calcul\u00e9es \u00e0 l'\u00e9tape (5). Imprimez le mod\u00e8le de test. Remettez la valeur de fr\u00e9quence d'origine : SET_INPUT_SHAPER SHAPER_FREQ_X=... . Trouvez la bande r\u00e9sonnant le moins et comptez son num\u00e9ro \u00e0 partir du bas en commen\u00e7ant \u00e0 1. Calculez la nouvelle valeur shaper_freq_x selon la formule : ancien shaper_freq_x * (39 + 5 * #band-number) / 66. R\u00e9p\u00e9tez ces \u00e9tapes pour l'axe Y de la m\u00eame mani\u00e8re, en rempla\u00e7ant les r\u00e9f\u00e9rences \u00e0 l'axe X par l'axe Y (par exemple, remplacez shaper_freq_x par shaper_freq_y dans les formules et dans la commande TUNING_TOWER ). A titre d'exemple, supposons que vous ayez mesur\u00e9 la fr\u00e9quence de r\u00e9sonance pour l'un des axes \u00e0 45 Hz. Cela donne les valeurs start = 45 * 83 / 132 = 28,30 et factor = 45 / 66 = 0,6818 pour la commande TUNING_TOWER . Supposons maintenant qu'apr\u00e8s l'impression du mod\u00e8le de test, la quatri\u00e8me bande \u00e0 partir du bas donne le moins de r\u00e9sonance. Cela donne le shaper_freq_ mis \u00e0 jour \u00e9gal \u00e0 45 * (39 + 5 * 4) / 66 \u2248 40,23. Une fois les deux nouveaux param\u00e8tres shaper_freq_x et shaper_freq_y calcul\u00e9s, vous pouvez mettre \u00e0 jour la section [input_shaper] dans printer.cfg avec le nouveau shaper_freq_x et shaper_freq_y . Avance de pression (PA) \u00b6 Si vous utilisiez l'avance de pression, il pourra \u00eatre n\u00e9cessaire de la r\u00e9ajuster. Suivez les instructions pour trouver la nouvelle valeur, si elle diff\u00e8re de la pr\u00e9c\u00e9dente. Assurez-vous de red\u00e9marrer Klipper avant de r\u00e9gler l'avance de pression. Mesures peu fiables des fr\u00e9quences de r\u00e9sonance \u00b6 Si vous ne parvenez pas \u00e0 mesurer les fr\u00e9quences de r\u00e9sonance, par ex. si la distance entre les oscillations n'est pas stable, vous pouvez toujours profiter des techniques de l'input shaper, mais les r\u00e9sultats peuvent ne pas \u00eatre aussi bons qu'avec des mesures appropri\u00e9es des fr\u00e9quences, et n\u00e9cessiteront un peu plus de r\u00e9glages et d'impressions du mod\u00e8le de test. Notez qu'une autre possibilit\u00e9 est d'acheter et d'installer un acc\u00e9l\u00e9rom\u00e8tre et de mesurer les r\u00e9sonances avec (reportez-vous \u00e0 la documentation d\u00e9crivant le mat\u00e9riel requis et le processus de configuration) - mais cette option n\u00e9cessite quelques soudures et un peu de sertissage. Pour le r\u00e9glage, ajoutez une section [input_shaper] vide \u00e0 votre printer.cfg . Ensuite, en supposant que vous avez tranch\u00e9 le mod\u00e8le de r\u00e9sonance avec les param\u00e8tres sugg\u00e9r\u00e9s, imprimez le mod\u00e8le de test 3 fois comme suit. Premi\u00e8re fois, avant l'impression, ex\u00e9cutez RESTART SET_VELOCITY_LIMIT ACCEL_TO_DECEL=7000 SET_PRESSURE_ADVANCE ADVANCE=0 SET_INPUT_SHAPER SHAPER_TYPE=2HUMP_EI SHAPER_FREQ_X=60 SHAPER_FREQ_Y=60 TUNING_TOWER COMMAND=SET_VELOCITY_LIMIT PARAMETER=ACCEL START=1500 STEP_DELTA=500 STEP_HEIGHT=5 et imprimez le mod\u00e8le. Ensuite, imprimez \u00e0 nouveau le mod\u00e8le, mais avant d'imprimer, ex\u00e9cutez \u00e0 la place SET_INPUT_SHAPER SHAPER_TYPE=2HUMP_EI SHAPER_FREQ_X=50 SHAPER_FREQ_Y=50 TUNING_TOWER COMMAND=SET_VELOCITY_LIMIT PARAMETER=ACCEL START=1500 STEP_DELTA=500 STEP_HEIGHT=5 Imprimez ensuite le mod\u00e8le pour la 3\u00e8me fois, mais ex\u00e9cutez maintenant SET_INPUT_SHAPER SHAPER_TYPE=2HUMP_EI SHAPER_FREQ_X=40 SHAPER_FREQ_Y=40 TUNING_TOWER COMMAND=SET_VELOCITY_LIMIT PARAMETER=ACCEL START=1500 STEP_DELTA=500 STEP_HEIGHT=5 Dans la pratique nous imprimons le mod\u00e8le de test de r\u00e9sonance avec TUNING_TOWER en utilisant l'input shaper 2HUMP_EI avec shaper_freq = 60 Hz, 50 Hz et 40 Hz. Si aucun des mod\u00e8les ne d\u00e9montre d'am\u00e9lioration de la r\u00e9sonance, aucune des techniques d'input shaper ne pourra vous aider. Sinon, il se peut que tous les mod\u00e8les n'affichent aucune r\u00e9sonance, ou que certains affichent la r\u00e9sonance et d'autres pas trop. Choisissez le mod\u00e8le de test avec la fr\u00e9quence la plus \u00e9lev\u00e9e qui montre encore de bonnes am\u00e9liorations dans la r\u00e9sonance. Par exemple, si les mod\u00e8les 40 Hz et 50 Hz n'affichent presque aucune r\u00e9sonance et que le mod\u00e8le 60 Hz affiche d\u00e9j\u00e0 un peu plus de r\u00e9sonance, restez \u00e0 50 Hz. V\u00e9rifiez maintenant si l'input shaper EI peut fonctionner dans votre cas. Choisissez la fr\u00e9quence de l'input shaper EI en fonction de la fr\u00e9quence de l'input shaper 2HUMP_EI que vous avez choisie : Pour l'input shaper 2HUMP_EI 60 Hz, utilisez l'input shaper EI avec shaper_freq = 50 Hz. Pour l'input shaper 2HUMP_EI 50 Hz, utilisez l'input shaper EI avec shaper_freq = 40 Hz. Pour l'input shaper 2HUMP_EI \u00e0 40 Hz, utilisez l'input shaper EI avec shaper_freq = 33 Hz. Imprimez le mod\u00e8le de test une fois de plus, en ex\u00e9cutant SET_INPUT_SHAPER SHAPER_TYPE=EI SHAPER_FREQ_X=... SHAPER_FREQ_Y=... TUNING_TOWER COMMAND=SET_VELOCITY_LIMIT PARAMETER=ACCEL START=1500 STEP_DELTA=500 STEP_HEIGHT=5 en fournissant le shaper_freq_x=... et shaper_freq_y=... comme d\u00e9termin\u00e9 pr\u00e9c\u00e9demment. Si l'input shaper EI montre de bons r\u00e9sultats comparables \u00e0 ceux de l'input shaper 2HUMP_EI, restez avec l'input shaper EI et la fr\u00e9quence d\u00e9termin\u00e9e pr\u00e9c\u00e9demment, sinon utilisez l'input shaper 2HUMP_EI avec la fr\u00e9quence correspondante. Ajoutez les r\u00e9sultats \u00e0 printer.cfg comme, par ex. [input_shaper] shaper_freq_x: 50 shaper_freq_y: 50 shaper_type: 2hump_ei Continuez le r\u00e9glage avec la section Choix de l'acc\u00e9l\u00e9ration maximale . D\u00e9pannage et FAQ \u00b6 Je n'arrive pas \u00e0 obtenir de mesures fiables des fr\u00e9quences de r\u00e9sonance \u00b6 En premier lieu, assurez-vous qu'il ne s'agit pas d'un autre probl\u00e8me avec l'imprimante plut\u00f4t que de la r\u00e9sonance. Si les mesures ne sont pas fiables parce que, par exemple, la distance entre les oscillations n'est pas stable, cela peut signifier que l'imprimante a plusieurs fr\u00e9quences de r\u00e9sonance sur le m\u00eame axe. On peut essayer de suivre le processus de r\u00e9glage d\u00e9crit dans la section Mesures non fiables des fr\u00e9quences de r\u00e9sonance et tirer encore quelque chose de la technique de l'input shaper. Une autre possibilit\u00e9 consiste \u00e0 installer un acc\u00e9l\u00e9rom\u00e8tre, \u00e0 mesurer les r\u00e9sonances avec celui-ci et \u00e0 r\u00e9gler automatiquement l'input shaper en utilisant les r\u00e9sultats de ces mesures. Apr\u00e8s avoir activ\u00e9 [input_shaper], j'obtiens des pi\u00e8ces imprim\u00e9es trop liss\u00e9es et les d\u00e9tails fins sont perdus \u00b6 V\u00e9rifiez les informations dans la section Choix de l'acc\u00e9l\u00e9ration maximale . Si la fr\u00e9quence de r\u00e9sonance est faible, il ne faut pas d\u00e9finir une valeur trop \u00e9lev\u00e9e pour max_accel ou augmenter les param\u00e8tres square_corner_velocity. Il peut \u00e9galement \u00eatre pr\u00e9f\u00e9rable de choisir un input shaper de type MZV ou m\u00eame ZV plut\u00f4t que EI (ou des shapers 2HUMP_EI et 3HUMP_EI). Apr\u00e8s avoir r\u00e9ussi \u00e0 imprimer pendant un certain temps sans r\u00e9sonance, elle semble revenir \u00b6 Il est possible qu'apr\u00e8s un certain temps, les fr\u00e9quences de r\u00e9sonance aient chang\u00e9. Par exemple. peut-\u00eatre que la tension des courroies a chang\u00e9 (les courroies sont devenues plus l\u00e2ches), etc. Il est bon de v\u00e9rifier et de mesurer \u00e0 nouveau les fr\u00e9quences de r\u00e9sonance comme d\u00e9crit dans la section Fr\u00e9quence de r\u00e9sonance et de mettre \u00e0 jour votre fichier de configuration si n\u00e9cessaire . La configuration \u00e0 double chariot est-elle prise en charge avec l'input shaper ? \u00b6 Il n'y a pas de support d\u00e9di\u00e9 pour les doubles chariots avec l'input shaper, mais cela ne signifie pas que cette configuration ne fonctionnera pas. Il faut ex\u00e9cuter le r\u00e9glage deux fois pour chacun des chariots et calculer les fr\u00e9quences de r\u00e9sonance des axes X et Y de chacun des chariots ind\u00e9pendamment. Ensuite, placez les valeurs du chariot 0 dans la section [input_shaper] et modifiez les valeurs \u00e0 la vol\u00e9e lors du changement de chariot, par ex. dans le cadre d'une macro\u202f: SET_DUAL_CARRIAGE CARRIAGE=1 SET_INPUT_SHAPER SHAPER_FREQ_X=... SHAPER_FREQ_Y=... Et pareil lors du retour au chariot 0. input_shaper affecte-t-il le temps d'impression ? \u00b6 Non, la fonctionnalit\u00e9 input_shaper n'a pratiquement aucun impact sur les temps d'impression. Cependant, la valeur de max_accel en a un (r\u00e9glage de ce param\u00e8tre d\u00e9crit dans cette section ). D\u00e9tails techniques \u00b6 Input shapers \u00b6 Les input shaper utilis\u00e9s dans Klipper sont plut\u00f4t standards, et on peut en trouver un aper\u00e7u plus d\u00e9taill\u00e9 dans les articles d\u00e9crivant les input shaper correspondants. Cette section contient un bref aper\u00e7u de certains aspects techniques des input shapers pris en charge. Le tableau ci-dessous montre certains param\u00e8tres (g\u00e9n\u00e9ralement approximatifs) pour chaque input shaper. Input shaper Dur\u00e9e de l'input shaper R\u00e9duction des vibrations 20x (5 % de tol\u00e9rance aux vibrations) R\u00e9duction des vibrations 10x (tol\u00e9rance aux vibrations de 10 %) ZV 0,5 / shaper_freq N/A \u00b1 5% shaper_freq MZV 0,75 / shaper_freq \u00b1 4% shaper_freq -10%...+15% shaper_freq ZVD 1 / shaper_freq \u00b1 15% shaper_freq \u00b1 22% shaper_freq EI 1 / shaper_freq \u00b1 20% shaper_freq \u00b1 25% shaper_freq 2HUMP_EI 1,5 / shaper_freq \u00b1 35% shaper_freq \u00b1 40 shaper_freq 3HUMP_EI 2 / shaper_freq -45...+50% shaper_freq -50%...+55% shaper_freq Remarque concernant l'att\u00e9nuation des vibrations : les valeurs du tableau ci-dessus sont approximatives. Si le taux d'amortissement de l'imprimante est connu pour chaque axe, l'input shaper peut \u00eatre configur\u00e9 plus pr\u00e9cis\u00e9ment ce qui r\u00e9duira alors les r\u00e9sonances dans une plage de fr\u00e9quences un peu plus large. Cependant, le taux d'amortissement est g\u00e9n\u00e9ralement inconnu et difficile \u00e0 estimer sans \u00e9quipement sp\u00e9cial. Klipper utilise donc la valeur 0,1 par d\u00e9faut, ce qui est une bonne valeur globale. Les gammes de fr\u00e9quences du tableau couvrent un certain nombre de diff\u00e9rents rapports d'amortissement possibles autour de cette valeur (environ de 0,05 \u00e0 0,2). Notez \u00e9galement que EI, 2HUMP_EI et 3HUMP_EI sont r\u00e9gl\u00e9s pour r\u00e9duire les vibrations \u00e0 5 %, les valeurs pour une tol\u00e9rance de vibration de 10 % sont fournies uniquement \u00e0 titre indicatif. Comment utiliser ce tableau : La dur\u00e9e de l'input shaper affecte le lissage des pi\u00e8ces - plus elle est grande, plus les pi\u00e8ces sont lisses. Cette d\u00e9pendance n'est pas lin\u00e9aire, mais peut donner une id\u00e9e des input shapers qui \"lissent\" le plus pour une m\u00eame fr\u00e9quence. L'ordre par lissage est le suivant : ZV < MZV < ZVD \u2248 EI < 2HUMP_EI < 3HUMP_EI. De plus, il est rarement pratique de r\u00e9gler shaper_freq = fr\u00e9quence de r\u00e9sonance des types 2HUMP_EI et 3HUMP_EI (utilis\u00e9s pour r\u00e9duire les vibrations sur plusieurs fr\u00e9quences). On peut estimer une gamme de fr\u00e9quences pour laquelle l'input shaper r\u00e9duit les vibrations. Par exemple, MZV avec shaper_freq = 35 Hz r\u00e9duit les vibrations \u00e0 5 % pour les fr\u00e9quences [33,6, 36,4] Hz. 3HUMP_EI avec shaper_freq = 50 Hz r\u00e9duit les vibrations \u00e0 5 % dans la plage [27,5 - 75] Hz. On peut utiliser ce tableau pour v\u00e9rifier quel input shaper choisir pour la r\u00e9duction des vibrations de plusieurs fr\u00e9quences. Par exemple, si on a des r\u00e9sonances \u00e0 35 Hz et 60 Hz sur le m\u00eame axe : a) EI doit avoir shaper_freq = 35 / (1 - 0.2) = 43.75 Hz, ce qui r\u00e9duirait les r\u00e9sonances jusqu'\u00e0 43.75 * (1 + 0,2) = 52,5 Hz, donc ce n'est pas suffisant ; b) Le 2HUMP_EI doit avoir shaper_freq = 35 / (1 - 0,35) = 53,85 Hz ce qui r\u00e9duira les vibrations jusqu'\u00e0 53,85 * (1 + 0,35) = 72,7 Hz - c'est donc une configuration acceptable. Essayez toujours d'utiliser le plus haut shaper_freq possible pour un input shaper donn\u00e9 (peut-\u00eatre avec une certaine marge de s\u00e9curit\u00e9, donc dans cet exemple shaper_freq \u2248 50-52 Hz fonctionnerait mieux), et essayez d'utiliser un input shaper avec une dur\u00e9e aussi petite que possible. Si l'on a besoin de r\u00e9duire les vibrations de plusieurs fr\u00e9quences tr\u00e8s diff\u00e9rentes (par exemple, 30 Hz et 100 Hz), le tableau ci-dessus ne fournit pas suffisamment d'informations. Dans ce cas, on peut avoir plus de chance avec le script scripts/graph_shaper.py , qui est plus flexible.","title":"Compensation de la r\u00e9sonance"},{"location":"Resonance_Compensation.html#compensation-de-la-resonance","text":"Klipper prend en charge l'input shaper, une technique utilis\u00e9e pour r\u00e9duire l'effet de la r\u00e9sonance (\u00e9galement connu sous le nom d'\u00e9cho, d'image fant\u00f4me - \"ghosting\" - ou d'ondulation - \"ringing\") dans les impressions. La r\u00e9sonance est un d\u00e9faut d'impression de la surface lorsque des \u00e9l\u00e9ments tels que des bords se r\u00e9p\u00e8tent sous la forme d'un l\u00e9ger \"\u00e9cho\" : | | | La r\u00e9sonance est caus\u00e9e par des vibrations m\u00e9caniques dans l'imprimante dues \u00e0 des changements rapides de direction pendant l'impression. La r\u00e9sonance a g\u00e9n\u00e9ralement des origines m\u00e9caniques : cadre de l'imprimante insuffisamment rigide, courroies non tendues ou trop \u00e9lastiques, probl\u00e8mes d'alignement des pi\u00e8ces m\u00e9caniques, masse mobile importante, etc. Ces probl\u00e8mes doivent \u00eatre v\u00e9rifi\u00e9s et corrig\u00e9s en premier lieu, si possible. L' input shaping est une technique de contr\u00f4le en boucle ouverte qui cr\u00e9e un signal de commande annulant ses propres vibrations. L'input shaping n\u00e9cessite quelques r\u00e9glages et mesures avant de pouvoir \u00eatre activ\u00e9e. Outre la r\u00e9sonance, l'input shaping r\u00e9duit aussi les vibrations et les secousses de l'imprimante en g\u00e9n\u00e9ral, et peut \u00e9galement am\u00e9liorer la fiabilit\u00e9 du mode stealthChop des pilotes Trinamic.","title":"Compensation de la r\u00e9sonance"},{"location":"Resonance_Compensation.html#reglages","text":"Le r\u00e9glage de base n\u00e9cessite de mesurer les fr\u00e9quences de r\u00e9sonance de l'imprimante en imprimant un mod\u00e8le de test. Tranchez le mod\u00e8le de test de r\u00e9sonance, qui se trouve dans docs/prints/ringing_tower.stl , avec votre trancheur : La hauteur de couche recommand\u00e9e est de 0,2 ou 0,25 mm. Le remplissage et le nombre de couches sup\u00e9rieures peuvent \u00eatre r\u00e9gl\u00e9s sur 0. Utilisez 1 ou 2 parois, ou mieux encore le mode vase avec 1 ou 2 mm de base. Utilisez une vitesse suffisamment \u00e9lev\u00e9e, entre 80 et 100 mm/s, pour les parois externes . Veillez \u00e0 ce que le temps minimum par couche soit au maximum de 3 secondes. Assurez-vous que toutes les options de \"contr\u00f4le d'acc\u00e9l\u00e9ration\" soient bien d\u00e9sactiv\u00e9es dans le trancheur. Ne tournez pas le mod\u00e8le. Le mod\u00e8le comporte des marques X et Y \u00e0 l'arri\u00e8re du mod\u00e8le. L'emplacement inhabituel des marques par rapport aux axes de l'imprimante n'est pas une erreur. Ces marques pourront \u00eatre utilis\u00e9es plus tard - comme r\u00e9f\u00e9rence - dans le processus de r\u00e9glage, car elles indiquent \u00e0 quel axe correspondent les mesures.","title":"R\u00e9glages"},{"location":"Resonance_Compensation.html#frequence-de-resonance","text":"En premier lieu, mesurez la fr\u00e9quence de r\u00e9sonance . Si le param\u00e8tre square_corner_velocity a \u00e9t\u00e9 modifi\u00e9, remettez-le \u00e0 5.0. Il n'est pas conseill\u00e9 de l'augmenter lors de l'utilisation de l'input shaper car cela peut provoquer plus de lissage dans les pi\u00e8ces - il est pr\u00e9f\u00e9rable d'utiliser une valeur d'acc\u00e9l\u00e9ration plus \u00e9lev\u00e9e \u00e0 la place. Augmentez max_accel_to_decel en lan\u00e7ant la commande suivante : SET_VELOCITY_LIMIT ACCEL_TO_DECEL=7000 D\u00e9sactivez l'avance de pression : SET_PRESSURE_ADVANCE ADVANCE=0 Si vous avez d\u00e9j\u00e0 ajout\u00e9 la section [input_shaper] au fichier printer.cfg, ex\u00e9cutez la commande SET_INPUT_SHAPER SHAPER_FREQ_X=0 SHAPER_FREQ_Y=0 . Si vous obtenez l'erreur \"Unknown command\", vous pouvez l'ignorer - pour le moment - et continuer les mesures. Ex\u00e9cutez la commande : TUNING_TOWER COMMAND=SET_VELOCITY_LIMIT PARAMETER=ACCEL START=1500 STEP_DELTA=500 STEP_HEIGHT=5 Dans la pratique, nous essayons de rendre la r\u00e9sonance plus prononc\u00e9e en d\u00e9finissant diff\u00e9rentes valeurs \u00e9lev\u00e9es pour l'acc\u00e9l\u00e9ration. Cette commande augmentera l'acc\u00e9l\u00e9ration tous les 5 mm \u00e0 partir de 1500 mm/sec\u00b2 : 1500 mm/sec\u00b2, 2000 mm/sec\u00b2, 2500 mm/sec\u00b2 et ainsi de suite jusqu'\u00e0 7000 mm/sec\u00b2 pour la derni\u00e8re bande. Imprimez le mod\u00e8le de test tranch\u00e9 avec les param\u00e8tres indiqu\u00e9s. Vous pouvez arr\u00eater l'impression avant la fin si la r\u00e9sonance est clairement visible et si vous constatez que l'acc\u00e9l\u00e9ration devient trop forte pour votre imprimante (par exemple, l'imprimante tremble trop ou commence \u00e0 sauter des pas). Utilisez les marques X et Y \u00e0 l'arri\u00e8re du mod\u00e8le comme r\u00e9f\u00e9rence. Les mesures du c\u00f4t\u00e9 avec la marque X doivent \u00eatre utilis\u00e9es pour la configuration de l'axe X, et les mesures du c\u00f4t\u00e9 avec la marque Y pour la configuration de l'axe Y. Mesurez la distance D (en mm) entre plusieurs oscillations sur la partie de la pi\u00e8ce avec la marque X, pr\u00e8s des encoches et en sautant de pr\u00e9f\u00e9rence la ou les deux premi\u00e8res oscillations. Pour mesurer plus facilement la distance entre les oscillations, marquez d'abord les oscillations, puis mesurez la distance entre les marques avec une r\u00e8gle ou un pied \u00e0 coulisse :| | | Comptez le nombre d'oscillations N correspondant \u00e0 la distance mesur\u00e9e D . Si vous ne savez pas comment compter les oscillations, reportez-vous \u00e0 l'image ci-dessus, qui montre N = 6 oscillations. Calculez la fr\u00e9quence de r\u00e9sonance de l'axe X : V \u00b7 N / D (Hz), o\u00f9 V est la vitesse des p\u00e9rim\u00e8tres ext\u00e9rieurs (mm/s). Pour l'exemple ci-dessus, nous avons marqu\u00e9 6 oscillations (N) sur une distance de 12,14 mm (D), et le test a \u00e9t\u00e9 imprim\u00e9 \u00e0 une vitesse de 100 mm/s (V), donc la fr\u00e9quence est 100 * 6 / 12,14 \u2248 49,4 Hz. Faites (8) - (10) pour la marque Y \u00e9galement. Notez que la r\u00e9sonance sur l'impression de test devrait suivre les encoches courb\u00e9es de la pi\u00e8ce, comme dans l'image ci-dessus. Si ce n'est pas le cas, alors ce d\u00e9faut n'est pas vraiment une r\u00e9sonance et a probablement une origine diff\u00e9rente - soit m\u00e9canique, soit un probl\u00e8me d'extrudeuse. Ce probl\u00e8me doit \u00eatre r\u00e9solu avant d'activer et de r\u00e9gler les input shapers. Si les mesures ne sont pas fiables parce que, par exemple, la distance entre les oscillations n'est pas r\u00e9guli\u00e8re, cela peut signifier que l'imprimante a plusieurs fr\u00e9quences de r\u00e9sonance sur le m\u00eame axe. On peut essayer de suivre le processus de r\u00e9glage d\u00e9crit dans la section Mesures peu fiables des fr\u00e9quences de r\u00e9sonance \u00e0 la place et obtenir quand m\u00eame une am\u00e9lioration gr\u00e2ce \u00e0 l'input shaping. La fr\u00e9quence de r\u00e9sonance peut d\u00e9pendre de la position du mod\u00e8le sur le plateau et de la hauteur Z, surtout sur les imprimantes delta ; vous pouvez v\u00e9rifier si vous observez des diff\u00e9rences de fr\u00e9quences \u00e0 diff\u00e9rentes positions le long des c\u00f4t\u00e9s du mod\u00e8le de test et \u00e0 diff\u00e9rentes hauteurs. Si c'est le cas, vous pouvez calculer les fr\u00e9quences de r\u00e9sonance moyennes sur les axes X et Y. Si la fr\u00e9quence de r\u00e9sonance mesur\u00e9e est tr\u00e8s basse (inf\u00e9rieure \u00e0 20-25 Hz), il peut \u00eatre judicieux de penser \u00e0 rigidifier la structure de l'imprimante ou \u00e0 r\u00e9duire la masse mobile - dans la mesure du possible - avant de poursuivre le r\u00e9glage de l'input shaping et de mesurer \u00e0 nouveau les fr\u00e9quences. Pour de nombreux mod\u00e8les d'imprimantes populaires, il existe souvent des solutions d\u00e9j\u00e0 disponibles. Les fr\u00e9quences de r\u00e9sonance peuvent changer si des modifications sont apport\u00e9es \u00e0 l'imprimante qui affectent la masse en mouvement ou modifient la rigidit\u00e9 du syst\u00e8me, par exemple : Si la t\u00eate d'impression est modifi\u00e9e, par ex. changement de moteur pas \u00e0 pas (plus lourd ou plus l\u00e9ger) pour une extrusion directe, remplacement de la t\u00eate de l'outil (plus ou moins lourde), ajout d'un ventilateur plus lourd, etc. La tension des courroies a \u00e9t\u00e9 modifi\u00e9e. Des pi\u00e8ces con\u00e7ues pour augmenter la rigidit\u00e9 du cadre sont install\u00e9es. Un plateau diff\u00e9rent est install\u00e9 sur une imprimante \u00e0 lit mobile, ou une plaque de verre est ajout\u00e9e, etc. Si de telles modifications sont apport\u00e9es, Il est conseill\u00e9 - au minimum - de mesurer les fr\u00e9quences de r\u00e9sonance pour v\u00e9rifier s'il elles ont chang\u00e9es (ou pas).","title":"Fr\u00e9quence de r\u00e9sonance"},{"location":"Resonance_Compensation.html#configuration-de-linput-shaper","text":"Une fois les fr\u00e9quences de r\u00e9sonance des axes X et Y mesur\u00e9es, vous pouvez ajouter la section suivante \u00e0 votre fichier printer.cfg : [input_shaper] shaper_freq_x: ... # frequence pour la marque X sur le mod\u00e8le de test shaper_freq_y: ... # frequence pour la marque Y sur le mod\u00e8le de test Pour l'exemple ci-dessus, nous obtenons shaper_freq_x/y = 49,4.","title":"Configuration de l'input shaper"},{"location":"Resonance_Compensation.html#choix-de-linput-shaper","text":"Klipper prend en charge plusieurs type d'\"input shaper\". Ils diff\u00e8rent par leur sensibilit\u00e9 aux erreurs d\u00e9terminant la fr\u00e9quence de r\u00e9sonance et le degr\u00e9 de lissage qu'ils provoquent dans les pi\u00e8ces imprim\u00e9es. De plus, certains de ces \"input shaper\" comme 2HUMP_EI et 3HUMP_EI ne doivent g\u00e9n\u00e9ralement pas \u00eatre utilis\u00e9s avec shaper_freq = fr\u00e9quence de r\u00e9sonance - ils sont configur\u00e9s \u00e0 partir de diff\u00e9rentes consid\u00e9rations pour r\u00e9duire plusieurs r\u00e9sonances \u00e0 la fois (ndt\u202f: le 2HUMP_EI est \u00e0 utiliser lorsque deux pics de r\u00e9sonance sont d\u00e9tect\u00e9s, le 3HUMP_EI est \u00e0 utiliser lorsque trois pics de r\u00e9sonance sont d\u00e9tect\u00e9s). Pour la plupart des imprimantes, les types MZV ou EI sont recommand\u00e9s. Cette section d\u00e9crit un processus de test pour choisir entre eux et d\u00e9terminer quelques autres param\u00e8tres connexes. Imprimez le mod\u00e8le de test de r\u00e9sonance comme suit : Red\u00e9marrez le micrologiciel : RESTART Pr\u00e9parez-vous pour le test : SET_VELOCITY_LIMIT ACCEL_TO_DECEL=7000 D\u00e9sactivez l'avance de pression : SET_PRESSURE_ADVANCE ADVANCE=0 Ex\u00e9cutez : SET_INPUT_SHAPER SHAPER_TYPE=MZV Ex\u00e9cutez la commande : TUNING_TOWER COMMAND=SET_VELOCITY_LIMIT PARAMETER=ACCEL START=1500 STEP_DELTA=500 STEP_HEIGHT=5 Imprimez le mod\u00e8le de test tranch\u00e9 avec les param\u00e8tres indiqu\u00e9s. Si vous ne voyez pas de r\u00e9sonance \u00e0 ce stade, l'utilisation du type MZV peut \u00eatre recommand\u00e9e. Si vous voyez une r\u00e9sonance, mesurez \u00e0 nouveau les fr\u00e9quences en suivant les \u00e9tapes (8) \u00e0 (10) d\u00e9crites dans la section Fr\u00e9quence de r\u00e9sonance . Si les fr\u00e9quences diff\u00e8rent consid\u00e9rablement des valeurs obtenues pr\u00e9c\u00e9demment, une configuration d'input shaper plus complexe est n\u00e9cessaire. Vous pouvez vous r\u00e9f\u00e9rer aux d\u00e9tails techniques de la section Input shapers . Sinon, passez \u00e0 l'\u00e9tape suivante. Essayez l'input shaper EI. Pour l'essayer, r\u00e9p\u00e9tez les \u00e9tapes (1) \u00e0 (6) ci-dessus, mais en ex\u00e9cutant \u00e0 l'\u00e9tape 4 la commande suivante \u00e0 la place : SET_INPUT_SHAPER SHAPER_TYPE=EI . Comparez deux impressions avec les types MZV et EI. Si EI montre des r\u00e9sultats sensiblement meilleurs que MZV, utilisez EI, sinon pr\u00e9f\u00e9rez MZV. Notez que le type EI provoquera plus de lissage dans les pi\u00e8ces imprim\u00e9es (voir la section suivante pour plus de d\u00e9tails). Ajoutez le param\u00e8tre shaper_type: mzv (ou ei) \u00e0 la section [input_shaper], par exemple : [input_shaper] shaper_freq_x: ... shaper_freq_y: ... shaper_type: mzv Quelques notes sur le choix de l'input shaper : Le type EI peut \u00eatre plus adapt\u00e9 aux imprimantes \u00e0 lit mobile (si la fr\u00e9quence de r\u00e9sonance et le lissage r\u00e9sultant le permettent) : plus le filament est d\u00e9pos\u00e9 sur le lit en mouvement, plus la masse du lit augmente et la fr\u00e9quence de r\u00e9sonance diminue. \u00c9tant donn\u00e9 que le type EI est plus robuste aux changements de fr\u00e9quence de r\u00e9sonance, il peut \u00eatre plus efficace lors de l'impression de grandes pi\u00e8ces. En raison de la nature de la cin\u00e9matique delta, les fr\u00e9quences de r\u00e9sonance peuvent diff\u00e9rer consid\u00e9rablement dans diff\u00e9rentes parties du volume de construction. Par cons\u00e9quent, le type EI peut \u00eatre mieux adapt\u00e9 aux imprimantes delta plut\u00f4t que MZV ou ZV. Si la fr\u00e9quence de r\u00e9sonance est suffisamment grande (plus de 50-60 Hz), alors on peut m\u00eame essayer de tester 2HUMP_EI (en ex\u00e9cutant le test sugg\u00e9r\u00e9 ci-dessus avec SET_INPUT_SHAPER SHAPER_TYPE=2HUMP_EI ), mais v\u00e9rifiez les consid\u00e9rations dans la section ci-dessous avant de l'activer.","title":"Choix de l'input shaper"},{"location":"Resonance_Compensation.html#selection-de-max_accel","text":"Vous devriez obtenir le test imprim\u00e9 avec l'input shaper choisi \u00e0 l'\u00e9tape pr\u00e9c\u00e9dente (si vous ne le faites pas, imprimez le mod\u00e8le de test d\u00e9coup\u00e9 avec les param\u00e8tres sugg\u00e9r\u00e9s avec l'avance de pression d\u00e9sactiv\u00e9e SET_PRESSURE_ADVANCE ADVANCE=0 et avec la tour de r\u00e9glage activ\u00e9e comme TUNING_TOWER COMMAND=SET_VELOCITY_LIMIT PARAMETER=ACCEL START=1500 STEP_DELTA=500 STEP_HEIGHT=5 ). Notez qu'\u00e0 des acc\u00e9l\u00e9rations tr\u00e8s \u00e9lev\u00e9es, selon la fr\u00e9quence de r\u00e9sonance et l'input shaper choisi (par exemple, le shaper EI cr\u00e9e plus de lissage que MZV), cela peut provoquer trop de lissage et d'arrondi des pi\u00e8ces. Ainsi, max_accel doit \u00eatre choisi de mani\u00e8re \u00e0 l'\u00e9viter. Un autre param\u00e8tre ayant un impact sur le lissage est square_corner_velocity , il n'est donc pas conseill\u00e9 de l'augmenter au-dessus de la valeur par d\u00e9faut de 5 mm/s pour \u00e9viter un lissage accru. Afin de s\u00e9lectionner une valeur correcte pour max_accel, inspectez le mod\u00e8le imprim\u00e9 pour l'input shaper choisi. Tout d'abord, notez \u00e0 quelle acc\u00e9l\u00e9ration la r\u00e9sonance reste imperceptible. Ensuite, v\u00e9rifiez le lissage. Pour vous aider, le mod\u00e8le de test a un petit espace dans la paroi (0,15 mm) : \u00c0 mesure que l'acc\u00e9l\u00e9ration augmente, le lissage augmente \u00e9galement et l'espacement r\u00e9el dans l'impression s'\u00e9largit : Sur cette image, l'acc\u00e9l\u00e9ration augmente de gauche \u00e0 droite, et l'\u00e9cart commence \u00e0 cro\u00eetre \u00e0 partir de 3500 mm/s\u00b2 (5\u00e8me bande \u00e0 partir de la gauche). Dans ce cas, la valeur pour max_accel = 3000 (mm/s\u00b2) permet d'\u00e9viter un lissage excessif. Notez l'acc\u00e9l\u00e9ration lorsque l'\u00e9cart est encore tr\u00e8s faible dans votre test d'impression. Si vous voyez des renflements, mais aucun espace dans le mur, m\u00eame \u00e0 des acc\u00e9l\u00e9rations \u00e9lev\u00e9es, cela peut \u00eatre d\u00fb \u00e0 une avance de pression (PA) d\u00e9sactiv\u00e9e, en particulier sur les extrudeurs de type Bowden. Si tel est le cas, vous devrez peut-\u00eatre relancer l'impression avec le PA activ\u00e9. Cela peut \u00e9galement \u00eatre le r\u00e9sultat d'un extrudeur mal calibr\u00e9 (trop \u00e9lev\u00e9), il faut donc v\u00e9rifier cela aussi. Choisissez la valeur minimale des deux valeurs d'acc\u00e9l\u00e9ration (de la r\u00e9sonance et du lissage) et affectez-l\u00e0 \u00e0 max_accel dans printer.cfg. Notez qu'il peut arriver - en particulier \u00e0 des fr\u00e9quences de r\u00e9sonance basses - que l'input shaper EI provoque trop de lissage, m\u00eame \u00e0 des acc\u00e9l\u00e9rations faibles. Dans ce cas, MZV peut \u00eatre un meilleur choix, car il peut permettre des valeurs d'acc\u00e9l\u00e9ration plus \u00e9lev\u00e9es. \u00c0 des fr\u00e9quences de r\u00e9sonance tr\u00e8s basses (~ 25 Hz et moins), m\u00eame l'input shaper MZV peut cr\u00e9er trop de lissage. Si tel est le cas, vous pouvez \u00e9galement essayer de r\u00e9p\u00e9ter les \u00e9tapes de la section Choix de l'input shaper avec l'input shaper ZV, en utilisant la commande SET_INPUT_SHAPER SHAPER_TYPE=ZV \u00e0 la place. L'input shaper ZV devrait montrer encore moins de lissage que MZV, mais il est plus sensible aux erreurs de mesure des fr\u00e9quences de r\u00e9sonance. Si une fr\u00e9quence de r\u00e9sonance est trop faible (inf\u00e9rieure \u00e0 20-25 Hz), il peut \u00eatre judicieux d'augmenter la rigidit\u00e9 de l'imprimante ou de r\u00e9duire la masse en mouvement. Sinon, l'acc\u00e9l\u00e9ration et la vitesse d'impression peuvent \u00eatre limit\u00e9es en raison d'un lissage trop important qui remplacera la r\u00e9sonance.","title":"S\u00e9lection de max_accel"},{"location":"Resonance_Compensation.html#reglage-fin-des-frequences-de-resonance","text":"Notez que la pr\u00e9cision des mesures des fr\u00e9quences de r\u00e9sonance \u00e0 l'aide du mod\u00e8le de test de r\u00e9sonance est suffisante dans la plupart des cas, donc un r\u00e9glage suppl\u00e9mentaire n'est pas utile. Si vous voulez toujours essayer de rev\u00e9rifier vos r\u00e9sultats (par exemple, si vous voyez toujours une r\u00e9sonance apr\u00e8s avoir imprim\u00e9 un mod\u00e8le de test avec un input shaper de votre choix avec les fr\u00e9quences mesur\u00e9es pr\u00e9c\u00e9demment), vous pouvez suivre les \u00e9tapes de cette section. Notez que si vous voyez une r\u00e9sonance \u00e0 diff\u00e9rentes fr\u00e9quences apr\u00e8s avoir activ\u00e9 [input_shaper], cette section ne vous aidera pas. En consid\u00e9rant que vous avez tranch\u00e9 le mod\u00e8le de r\u00e9sonance avec les param\u00e8tres sugg\u00e9r\u00e9s, effectuez les \u00e9tapes suivantes pour chacun des axes X et Y : Pr\u00e9parez-vous pour le test : SET_VELOCITY_LIMIT ACCEL_TO_DECEL=7000 Assurez-vous que l'avance de pression est d\u00e9sactiv\u00e9e : SET_PRESSURE_ADVANCE ADVANCE=0 Ex\u00e9cutez : SET_INPUT_SHAPER SHAPER_TYPE=ZV \u00c0 partir du mod\u00e8le de test de r\u00e9sonance imprim\u00e9 avec l'input shaper choisi, s\u00e9lectionnez l'acc\u00e9l\u00e9ration montrant suffisamment bien la r\u00e9sonance et d\u00e9finissez-la avec : SET_VELOCITY_LIMIT ACCEL=... Calculez les param\u00e8tres n\u00e9cessaires pour que la commande TUNING_TOWER r\u00e8gle le param\u00e8tre shaper_freq_x comme suit : start = shaper_freq_x * 83 / 132 et factor = shaper_freq_x / 66, o\u00f9 shaper_freq_x est la valeur indiqu\u00e9e dans printer.cfg . Ex\u00e9cutez la commande : TUNING_TOWER COMMAND=SET_INPUT_SHAPER PARAMETER=SHAPER_FREQ_X START=start FACTOR=factor BAND=5 en utilisant les valeurs start et factor calcul\u00e9es \u00e0 l'\u00e9tape (5). Imprimez le mod\u00e8le de test. Remettez la valeur de fr\u00e9quence d'origine : SET_INPUT_SHAPER SHAPER_FREQ_X=... . Trouvez la bande r\u00e9sonnant le moins et comptez son num\u00e9ro \u00e0 partir du bas en commen\u00e7ant \u00e0 1. Calculez la nouvelle valeur shaper_freq_x selon la formule : ancien shaper_freq_x * (39 + 5 * #band-number) / 66. R\u00e9p\u00e9tez ces \u00e9tapes pour l'axe Y de la m\u00eame mani\u00e8re, en rempla\u00e7ant les r\u00e9f\u00e9rences \u00e0 l'axe X par l'axe Y (par exemple, remplacez shaper_freq_x par shaper_freq_y dans les formules et dans la commande TUNING_TOWER ). A titre d'exemple, supposons que vous ayez mesur\u00e9 la fr\u00e9quence de r\u00e9sonance pour l'un des axes \u00e0 45 Hz. Cela donne les valeurs start = 45 * 83 / 132 = 28,30 et factor = 45 / 66 = 0,6818 pour la commande TUNING_TOWER . Supposons maintenant qu'apr\u00e8s l'impression du mod\u00e8le de test, la quatri\u00e8me bande \u00e0 partir du bas donne le moins de r\u00e9sonance. Cela donne le shaper_freq_ mis \u00e0 jour \u00e9gal \u00e0 45 * (39 + 5 * 4) / 66 \u2248 40,23. Une fois les deux nouveaux param\u00e8tres shaper_freq_x et shaper_freq_y calcul\u00e9s, vous pouvez mettre \u00e0 jour la section [input_shaper] dans printer.cfg avec le nouveau shaper_freq_x et shaper_freq_y .","title":"R\u00e9glage fin des fr\u00e9quences de r\u00e9sonance"},{"location":"Resonance_Compensation.html#avance-de-pression-pa","text":"Si vous utilisiez l'avance de pression, il pourra \u00eatre n\u00e9cessaire de la r\u00e9ajuster. Suivez les instructions pour trouver la nouvelle valeur, si elle diff\u00e8re de la pr\u00e9c\u00e9dente. Assurez-vous de red\u00e9marrer Klipper avant de r\u00e9gler l'avance de pression.","title":"Avance de pression (PA)"},{"location":"Resonance_Compensation.html#mesures-peu-fiables-des-frequences-de-resonance","text":"Si vous ne parvenez pas \u00e0 mesurer les fr\u00e9quences de r\u00e9sonance, par ex. si la distance entre les oscillations n'est pas stable, vous pouvez toujours profiter des techniques de l'input shaper, mais les r\u00e9sultats peuvent ne pas \u00eatre aussi bons qu'avec des mesures appropri\u00e9es des fr\u00e9quences, et n\u00e9cessiteront un peu plus de r\u00e9glages et d'impressions du mod\u00e8le de test. Notez qu'une autre possibilit\u00e9 est d'acheter et d'installer un acc\u00e9l\u00e9rom\u00e8tre et de mesurer les r\u00e9sonances avec (reportez-vous \u00e0 la documentation d\u00e9crivant le mat\u00e9riel requis et le processus de configuration) - mais cette option n\u00e9cessite quelques soudures et un peu de sertissage. Pour le r\u00e9glage, ajoutez une section [input_shaper] vide \u00e0 votre printer.cfg . Ensuite, en supposant que vous avez tranch\u00e9 le mod\u00e8le de r\u00e9sonance avec les param\u00e8tres sugg\u00e9r\u00e9s, imprimez le mod\u00e8le de test 3 fois comme suit. Premi\u00e8re fois, avant l'impression, ex\u00e9cutez RESTART SET_VELOCITY_LIMIT ACCEL_TO_DECEL=7000 SET_PRESSURE_ADVANCE ADVANCE=0 SET_INPUT_SHAPER SHAPER_TYPE=2HUMP_EI SHAPER_FREQ_X=60 SHAPER_FREQ_Y=60 TUNING_TOWER COMMAND=SET_VELOCITY_LIMIT PARAMETER=ACCEL START=1500 STEP_DELTA=500 STEP_HEIGHT=5 et imprimez le mod\u00e8le. Ensuite, imprimez \u00e0 nouveau le mod\u00e8le, mais avant d'imprimer, ex\u00e9cutez \u00e0 la place SET_INPUT_SHAPER SHAPER_TYPE=2HUMP_EI SHAPER_FREQ_X=50 SHAPER_FREQ_Y=50 TUNING_TOWER COMMAND=SET_VELOCITY_LIMIT PARAMETER=ACCEL START=1500 STEP_DELTA=500 STEP_HEIGHT=5 Imprimez ensuite le mod\u00e8le pour la 3\u00e8me fois, mais ex\u00e9cutez maintenant SET_INPUT_SHAPER SHAPER_TYPE=2HUMP_EI SHAPER_FREQ_X=40 SHAPER_FREQ_Y=40 TUNING_TOWER COMMAND=SET_VELOCITY_LIMIT PARAMETER=ACCEL START=1500 STEP_DELTA=500 STEP_HEIGHT=5 Dans la pratique nous imprimons le mod\u00e8le de test de r\u00e9sonance avec TUNING_TOWER en utilisant l'input shaper 2HUMP_EI avec shaper_freq = 60 Hz, 50 Hz et 40 Hz. Si aucun des mod\u00e8les ne d\u00e9montre d'am\u00e9lioration de la r\u00e9sonance, aucune des techniques d'input shaper ne pourra vous aider. Sinon, il se peut que tous les mod\u00e8les n'affichent aucune r\u00e9sonance, ou que certains affichent la r\u00e9sonance et d'autres pas trop. Choisissez le mod\u00e8le de test avec la fr\u00e9quence la plus \u00e9lev\u00e9e qui montre encore de bonnes am\u00e9liorations dans la r\u00e9sonance. Par exemple, si les mod\u00e8les 40 Hz et 50 Hz n'affichent presque aucune r\u00e9sonance et que le mod\u00e8le 60 Hz affiche d\u00e9j\u00e0 un peu plus de r\u00e9sonance, restez \u00e0 50 Hz. V\u00e9rifiez maintenant si l'input shaper EI peut fonctionner dans votre cas. Choisissez la fr\u00e9quence de l'input shaper EI en fonction de la fr\u00e9quence de l'input shaper 2HUMP_EI que vous avez choisie : Pour l'input shaper 2HUMP_EI 60 Hz, utilisez l'input shaper EI avec shaper_freq = 50 Hz. Pour l'input shaper 2HUMP_EI 50 Hz, utilisez l'input shaper EI avec shaper_freq = 40 Hz. Pour l'input shaper 2HUMP_EI \u00e0 40 Hz, utilisez l'input shaper EI avec shaper_freq = 33 Hz. Imprimez le mod\u00e8le de test une fois de plus, en ex\u00e9cutant SET_INPUT_SHAPER SHAPER_TYPE=EI SHAPER_FREQ_X=... SHAPER_FREQ_Y=... TUNING_TOWER COMMAND=SET_VELOCITY_LIMIT PARAMETER=ACCEL START=1500 STEP_DELTA=500 STEP_HEIGHT=5 en fournissant le shaper_freq_x=... et shaper_freq_y=... comme d\u00e9termin\u00e9 pr\u00e9c\u00e9demment. Si l'input shaper EI montre de bons r\u00e9sultats comparables \u00e0 ceux de l'input shaper 2HUMP_EI, restez avec l'input shaper EI et la fr\u00e9quence d\u00e9termin\u00e9e pr\u00e9c\u00e9demment, sinon utilisez l'input shaper 2HUMP_EI avec la fr\u00e9quence correspondante. Ajoutez les r\u00e9sultats \u00e0 printer.cfg comme, par ex. [input_shaper] shaper_freq_x: 50 shaper_freq_y: 50 shaper_type: 2hump_ei Continuez le r\u00e9glage avec la section Choix de l'acc\u00e9l\u00e9ration maximale .","title":"Mesures peu fiables des fr\u00e9quences de r\u00e9sonance"},{"location":"Resonance_Compensation.html#depannage-et-faq","text":"","title":"D\u00e9pannage et FAQ"},{"location":"Resonance_Compensation.html#je-narrive-pas-a-obtenir-de-mesures-fiables-des-frequences-de-resonance","text":"En premier lieu, assurez-vous qu'il ne s'agit pas d'un autre probl\u00e8me avec l'imprimante plut\u00f4t que de la r\u00e9sonance. Si les mesures ne sont pas fiables parce que, par exemple, la distance entre les oscillations n'est pas stable, cela peut signifier que l'imprimante a plusieurs fr\u00e9quences de r\u00e9sonance sur le m\u00eame axe. On peut essayer de suivre le processus de r\u00e9glage d\u00e9crit dans la section Mesures non fiables des fr\u00e9quences de r\u00e9sonance et tirer encore quelque chose de la technique de l'input shaper. Une autre possibilit\u00e9 consiste \u00e0 installer un acc\u00e9l\u00e9rom\u00e8tre, \u00e0 mesurer les r\u00e9sonances avec celui-ci et \u00e0 r\u00e9gler automatiquement l'input shaper en utilisant les r\u00e9sultats de ces mesures.","title":"Je n'arrive pas \u00e0 obtenir de mesures fiables des fr\u00e9quences de r\u00e9sonance"},{"location":"Resonance_Compensation.html#apres-avoir-active-input_shaper-jobtiens-des-pieces-imprimees-trop-lissees-et-les-details-fins-sont-perdus","text":"V\u00e9rifiez les informations dans la section Choix de l'acc\u00e9l\u00e9ration maximale . Si la fr\u00e9quence de r\u00e9sonance est faible, il ne faut pas d\u00e9finir une valeur trop \u00e9lev\u00e9e pour max_accel ou augmenter les param\u00e8tres square_corner_velocity. Il peut \u00e9galement \u00eatre pr\u00e9f\u00e9rable de choisir un input shaper de type MZV ou m\u00eame ZV plut\u00f4t que EI (ou des shapers 2HUMP_EI et 3HUMP_EI).","title":"Apr\u00e8s avoir activ\u00e9 [input_shaper], j'obtiens des pi\u00e8ces imprim\u00e9es trop liss\u00e9es et les d\u00e9tails fins sont perdus"},{"location":"Resonance_Compensation.html#apres-avoir-reussi-a-imprimer-pendant-un-certain-temps-sans-resonance-elle-semble-revenir","text":"Il est possible qu'apr\u00e8s un certain temps, les fr\u00e9quences de r\u00e9sonance aient chang\u00e9. Par exemple. peut-\u00eatre que la tension des courroies a chang\u00e9 (les courroies sont devenues plus l\u00e2ches), etc. Il est bon de v\u00e9rifier et de mesurer \u00e0 nouveau les fr\u00e9quences de r\u00e9sonance comme d\u00e9crit dans la section Fr\u00e9quence de r\u00e9sonance et de mettre \u00e0 jour votre fichier de configuration si n\u00e9cessaire .","title":"Apr\u00e8s avoir r\u00e9ussi \u00e0 imprimer pendant un certain temps sans r\u00e9sonance, elle semble revenir"},{"location":"Resonance_Compensation.html#la-configuration-a-double-chariot-est-elle-prise-en-charge-avec-linput-shaper","text":"Il n'y a pas de support d\u00e9di\u00e9 pour les doubles chariots avec l'input shaper, mais cela ne signifie pas que cette configuration ne fonctionnera pas. Il faut ex\u00e9cuter le r\u00e9glage deux fois pour chacun des chariots et calculer les fr\u00e9quences de r\u00e9sonance des axes X et Y de chacun des chariots ind\u00e9pendamment. Ensuite, placez les valeurs du chariot 0 dans la section [input_shaper] et modifiez les valeurs \u00e0 la vol\u00e9e lors du changement de chariot, par ex. dans le cadre d'une macro\u202f: SET_DUAL_CARRIAGE CARRIAGE=1 SET_INPUT_SHAPER SHAPER_FREQ_X=... SHAPER_FREQ_Y=... Et pareil lors du retour au chariot 0.","title":"La configuration \u00e0 double chariot est-elle prise en charge avec l'input shaper\u00a0?"},{"location":"Resonance_Compensation.html#input_shaper-affecte-t-il-le-temps-dimpression","text":"Non, la fonctionnalit\u00e9 input_shaper n'a pratiquement aucun impact sur les temps d'impression. Cependant, la valeur de max_accel en a un (r\u00e9glage de ce param\u00e8tre d\u00e9crit dans cette section ).","title":"input_shaper affecte-t-il le temps d'impression\u00a0?"},{"location":"Resonance_Compensation.html#details-techniques","text":"","title":"D\u00e9tails techniques"},{"location":"Resonance_Compensation.html#input-shapers","text":"Les input shaper utilis\u00e9s dans Klipper sont plut\u00f4t standards, et on peut en trouver un aper\u00e7u plus d\u00e9taill\u00e9 dans les articles d\u00e9crivant les input shaper correspondants. Cette section contient un bref aper\u00e7u de certains aspects techniques des input shapers pris en charge. Le tableau ci-dessous montre certains param\u00e8tres (g\u00e9n\u00e9ralement approximatifs) pour chaque input shaper. Input shaper Dur\u00e9e de l'input shaper R\u00e9duction des vibrations 20x (5 % de tol\u00e9rance aux vibrations) R\u00e9duction des vibrations 10x (tol\u00e9rance aux vibrations de 10 %) ZV 0,5 / shaper_freq N/A \u00b1 5% shaper_freq MZV 0,75 / shaper_freq \u00b1 4% shaper_freq -10%...+15% shaper_freq ZVD 1 / shaper_freq \u00b1 15% shaper_freq \u00b1 22% shaper_freq EI 1 / shaper_freq \u00b1 20% shaper_freq \u00b1 25% shaper_freq 2HUMP_EI 1,5 / shaper_freq \u00b1 35% shaper_freq \u00b1 40 shaper_freq 3HUMP_EI 2 / shaper_freq -45...+50% shaper_freq -50%...+55% shaper_freq Remarque concernant l'att\u00e9nuation des vibrations : les valeurs du tableau ci-dessus sont approximatives. Si le taux d'amortissement de l'imprimante est connu pour chaque axe, l'input shaper peut \u00eatre configur\u00e9 plus pr\u00e9cis\u00e9ment ce qui r\u00e9duira alors les r\u00e9sonances dans une plage de fr\u00e9quences un peu plus large. Cependant, le taux d'amortissement est g\u00e9n\u00e9ralement inconnu et difficile \u00e0 estimer sans \u00e9quipement sp\u00e9cial. Klipper utilise donc la valeur 0,1 par d\u00e9faut, ce qui est une bonne valeur globale. Les gammes de fr\u00e9quences du tableau couvrent un certain nombre de diff\u00e9rents rapports d'amortissement possibles autour de cette valeur (environ de 0,05 \u00e0 0,2). Notez \u00e9galement que EI, 2HUMP_EI et 3HUMP_EI sont r\u00e9gl\u00e9s pour r\u00e9duire les vibrations \u00e0 5 %, les valeurs pour une tol\u00e9rance de vibration de 10 % sont fournies uniquement \u00e0 titre indicatif. Comment utiliser ce tableau : La dur\u00e9e de l'input shaper affecte le lissage des pi\u00e8ces - plus elle est grande, plus les pi\u00e8ces sont lisses. Cette d\u00e9pendance n'est pas lin\u00e9aire, mais peut donner une id\u00e9e des input shapers qui \"lissent\" le plus pour une m\u00eame fr\u00e9quence. L'ordre par lissage est le suivant : ZV < MZV < ZVD \u2248 EI < 2HUMP_EI < 3HUMP_EI. De plus, il est rarement pratique de r\u00e9gler shaper_freq = fr\u00e9quence de r\u00e9sonance des types 2HUMP_EI et 3HUMP_EI (utilis\u00e9s pour r\u00e9duire les vibrations sur plusieurs fr\u00e9quences). On peut estimer une gamme de fr\u00e9quences pour laquelle l'input shaper r\u00e9duit les vibrations. Par exemple, MZV avec shaper_freq = 35 Hz r\u00e9duit les vibrations \u00e0 5 % pour les fr\u00e9quences [33,6, 36,4] Hz. 3HUMP_EI avec shaper_freq = 50 Hz r\u00e9duit les vibrations \u00e0 5 % dans la plage [27,5 - 75] Hz. On peut utiliser ce tableau pour v\u00e9rifier quel input shaper choisir pour la r\u00e9duction des vibrations de plusieurs fr\u00e9quences. Par exemple, si on a des r\u00e9sonances \u00e0 35 Hz et 60 Hz sur le m\u00eame axe : a) EI doit avoir shaper_freq = 35 / (1 - 0.2) = 43.75 Hz, ce qui r\u00e9duirait les r\u00e9sonances jusqu'\u00e0 43.75 * (1 + 0,2) = 52,5 Hz, donc ce n'est pas suffisant ; b) Le 2HUMP_EI doit avoir shaper_freq = 35 / (1 - 0,35) = 53,85 Hz ce qui r\u00e9duira les vibrations jusqu'\u00e0 53,85 * (1 + 0,35) = 72,7 Hz - c'est donc une configuration acceptable. Essayez toujours d'utiliser le plus haut shaper_freq possible pour un input shaper donn\u00e9 (peut-\u00eatre avec une certaine marge de s\u00e9curit\u00e9, donc dans cet exemple shaper_freq \u2248 50-52 Hz fonctionnerait mieux), et essayez d'utiliser un input shaper avec une dur\u00e9e aussi petite que possible. Si l'on a besoin de r\u00e9duire les vibrations de plusieurs fr\u00e9quences tr\u00e8s diff\u00e9rentes (par exemple, 30 Hz et 100 Hz), le tableau ci-dessus ne fournit pas suffisamment d'informations. Dans ce cas, on peut avoir plus de chance avec le script scripts/graph_shaper.py , qui est plus flexible.","title":"Input shapers"},{"location":"Rotation_Distance.html","text":"Distance de rotation \u00b6 Les pilotes de moteur pas \u00e0 pas avec Klipper n\u00e9cessitent un param\u00e8tre rotation_distance dans chaque section de configuration des pilotes pas \u00e0 pas . La rotation_distance est la distance parcourue par l'axe apr\u00e8s un tour complet du moteur pas \u00e0 pas. Ce document d\u00e9crit comment configurer cette valeur. Obtention de la distance de rotation \u00e0 partir de steps_per_mm (ou step_distance) \u00b6 Les concepteurs de votre imprimante 3d ont calcul\u00e9 \u00e0 l'origine les pas_par_mm \u00e0 partir d'une distance de rotation. Si vous connaissez les pas_par_mm, il est possible d'utiliser cette formule g\u00e9n\u00e9rale pour obtenir cette distance de rotation originale : rotation_distance = <full_steps_par_rotation> * <microsteps> / <steps_par_mm> Ou, si vous avez une ancienne configuration Klipper et que vous connaissez le param\u00e8tre step_distance , vous pouvez utiliser cette formule : rotation_distance = <full_steps_per_rotation> * <microsteps> * <step_distance> Le param\u00e8tre <full_steps_per_rotation> est d\u00e9termin\u00e9 par le type du moteur pas \u00e0 pas. La plupart des moteurs pas \u00e0 pas sont des \"pas \u00e0 pas de 1,8 degr\u00e9\" et ont donc 200 pas complets par rotation (360 divis\u00e9 par 1,8 est \u00e9gal \u00e0 200). Certains moteurs pas \u00e0 pas sont des \"pas \u00e0 pas de 0,9 degr\u00e9\" et ont donc 400 pas complets par rotation. D'autres type de moteurs pas \u00e0 pas sont rares. En cas de doute, ne d\u00e9finissez pas full_steps_per_rotation dans le fichier de configuration et utilisez 200 dans la formule ci-dessus. Le param\u00e8tre <microsteps> est d\u00e9termin\u00e9 par le pilote du moteur pas \u00e0 pas. La plupart des pilotes utilisent 16 micro-pas. Si vous n'\u00eates pas s\u00fbr, d\u00e9finissez microsteps : 16 dans la configuration et utilisez 16 dans la formule ci-dessus. Presque toutes les imprimantes devraient utiliser un nombre entier pour la distance de rotation des axes de type X, Y, et Z. Si la formule ci-dessus donne une distance de rotation qui est \u00e0 moins de 0,01 d'un nombre entier, arrondissez la valeur finale \u00e0 ce nombre entier. Calibration de la distance de rotation des extrudeuses \u00b6 Sur une extrudeuse, la rotation_distance est la distance que parcourt le filament durant une rotation compl\u00e8te du moteur pas \u00e0 pas. La meilleure fa\u00e7on d'obtenir une valeur pr\u00e9cise pour ce param\u00e8tre est d'utiliser une proc\u00e9dure de \"mesure et ajustement\". Commencez par une estimation initiale de la distance de rotation. Elle peut \u00eatre obtenue \u00e0 partir de pas_par_mm ou en inspectant le mat\u00e9riel . Utilisez ensuite la proc\u00e9dure suivante pour \"mesurer et ajuster\" : Assurez-vous que l'extrudeuse contient du filament, que le bloc chauffant est \u00e0 une temp\u00e9rature appropri\u00e9e et que l'imprimante est pr\u00eate \u00e0 extruder. Utilisez un marqueur pour placer une marque sur le filament \u00e0 environ 70 mm de l'entr\u00e9e du corps de l'extrudeuse. Utilisez ensuite un pied \u00e0 coulisse num\u00e9rique pour mesurer la distance r\u00e9elle de cette marque aussi pr\u00e9cis\u00e9ment que possible. Notez cette mesure comme <initial_mark_distance> . Extrudez 50 mm de filament avec la s\u00e9quence de commandes suivante : G91 suivi de G1 E50 F60 . Notez 50mm comme <distance_extrud\u00e9e_requise> . Attendez que l'extrudeuse termine son mouvement (cela prendra environ 50 secondes). Il est important d'utiliser la vitesse d'extrusion lente pour ce test car une vitesse plus rapide peut provoquer une pression \u00e9lev\u00e9e dans l'extrudeuse qui fausserait les r\u00e9sultats. (N'utilisez pas le \"bouton d'extrusion\" des interfaces graphiques pour ce test car ils extrudent \u00e0 une vitesse rapide.) Utilisez le pied \u00e0 coulisse num\u00e9rique pour mesurer la nouvelle distance entre le corps de l'extrudeuse et la marque sur le filament. Notez cette distance comme <distance_marque_suivante> . Calculez ensuite : Distance_extrud\u00e9e_r\u00e9elle = <distance_marque_initiale> - <distance_marque_suivante> Calculez la distance de rotation comme suit : distance_rotation = <distance_rotation_pr\u00e9c\u00e9dente> * <distance_extrusion_r\u00e9elle> / <distance_extrusion_demand\u00e9e> Arrondissez la nouvelle distance_rotation \u00e0 trois d\u00e9cimales. Si la distance_extrud\u00e9e_r\u00e9elle diff\u00e8re de la distance_extrud\u00e9e_requise de plus de 2 mm environ, il est bon d'effectuer les \u00e9tapes ci-dessus une nouvelle fois. Remarque : n'utilisez pas une m\u00e9thode de type \" mesurer et ajuster \" pour calibrer les axes de type x, y ou z. La m\u00e9thode \" mesurer et ajuster \" n'est pas assez pr\u00e9cise pour ces axes et conduira probablement \u00e0 une configuration moins bonne. Au lieu de cela, si n\u00e9cessaire, ces axes peuvent \u00eatre d\u00e9termin\u00e9s en mesurant les courroies, les poulies et les vis-m\u00e8re . Obtention de la distance de rotation par l'inspection du mat\u00e9riel \u00b6 Il est possible de calculer la distance de rotation en connaissant les moteurs pas \u00e0 pas et la cin\u00e9matique de l'imprimante. Cela peut \u00eatre utile si le nombre de pas par mm n'est pas connu ou si l'on con\u00e7oit une nouvelle imprimante. Axes entra\u00een\u00e9s par courroie \u00b6 Il est facile de calculer la distance de rotation pour un axe lin\u00e9aire utilisant une courroie et une poulie. D\u00e9terminez d'abord le type de courroie. La plupart des imprimantes utilisent un pas de courroie de 2 mm (c'est-\u00e0-dire que chaque dent de la courroie est espac\u00e9e de 2 mm). Comptez ensuite le nombre de dents sur la poulie du moteur pas \u00e0 pas. La distance de rotation est alors calcul\u00e9e comme suit : rotation_distance = <belt_pitch> * <number_of_teeth_on_pulley> Par exemple, si une imprimante a une courroie dont le pas est de 2 mm et utilise une poulie \u00e0 20 dents, la distance de rotation est de 40. Axes avec vis-m\u00e8re \u00b6 Il est facile de calculer la distance de rotation pour les vis-m\u00e8res communes \u00e0 l'aide de la formule suivante : rotation_distance = <screw_pitch> * <number_of_separate_threads> Par exemple, la \"vis-m\u00e8re T8\" courante a une distance de rotation de 8 (elle a un pas de 2 mm et comporte 4 filets s\u00e9par\u00e9s). Les imprimantes plus anciennes \u00e9quip\u00e9es de \"tiges filet\u00e9es\" n'ont qu'un seul \"filetage\" sur la vis-m\u00e8re et la distance de rotation correspond donc au pas de la vis. (Le pas de la vis est la distance entre chaque rainure de la vis). Ainsi, par exemple, une tige m\u00e9trique M6 a une distance de rotation de 1 et une tige M8 a une distance de rotation de 1,25. Extrudeuse \u00b6 Il est possible d'obtenir une distance de rotation initiale pour les extrudeuses en mesurant le diam\u00e8tre de la \"roue dent\u00e9e\" entrainant le filament, en utilisant la formule suivante : distance_de_rotation = <diam\u00e8tre> * 3.14 Si l'extrudeuse utilise des engrenages, il faudra \u00e9galement d\u00e9terminer et r\u00e9gler le rapport de d\u00e9multiplication pour celle-ci. La distance de rotation r\u00e9elle d'une extrudeuse varie d'une imprimante \u00e0 l'autre, car la prise de la \"roue cr\u00e9nel\u00e9e\" qui s'engage dans le filament peut varier. Elle peut m\u00eame varier d'une bobine de filament \u00e0 l'autre. Apr\u00e8s avoir obtenu une distance de rotation initiale, utilisez la proc\u00e9dure de mesure et d'ajustement pour obtenir un r\u00e9glage plus pr\u00e9cis. Utilisation d'un gear_ratio \u00b6 D\u00e9finir un gear_ratio peut faciliter la configuration de la rotation_distance des moteurs ayant une bo\u00eete de vitesse (ou similaire) attach\u00e9e \u00e0 eux. La plupart des moteurs n'ont pas de bo\u00eete de vitesse - si vous n'\u00eates pas s\u00fbr, n'utilisez pas de gear_ratio dans la configuration. Lorsqu'un gear_ratio est d\u00e9fini, la rotation_distance repr\u00e9sente la distance parcourue par l'axe lors d'une rotation compl\u00e8te du dernier engrenage de la bo\u00eete de vitesses. Si, par exemple, on utilise une bo\u00eete de vitesses avec un rapport \"5:1\", on peut calculer la distance de rotation avec connaissance du mat\u00e9riel et ensuite ajouter gear_ratio : 5:1 \u00e0 la configuration. Pour des engrenages mis en \u0153uvre avec des courroies et des poulies, il est possible de d\u00e9terminer le rapport de d\u00e9multiplication en comptant les dents des poulies. Par exemple, si une poulie de 16 dents entra\u00eene la poulie suivante de 80 dents, on utilisera gear_ratio : 80:16 . En effet, on peut ouvrir une \"bo\u00eete de vitesse\" courante et compter les dents pour confirmer le rapport d'engrenage. Notez que parfois, une bo\u00eete de vitesses aura un rapport de transmission l\u00e9g\u00e8rement diff\u00e9rent de celui qui est annonc\u00e9. Les engrenages courants du moteur d'extrudeuse BMG en sont un exemple - ils sont annonc\u00e9s comme \u00e9tant de \"3:1\" mais utilisent en r\u00e9alit\u00e9 un engrenage de \"50:17\". (L'utilisation de nombres de dents sans d\u00e9nominateur commun peut am\u00e9liorer l'usure globale de l'engrenage car les dents ne s'engr\u00e8nent pas toujours de la m\u00eame mani\u00e8re \u00e0 chaque tour). La \"boite de vitesses plan\u00e9taire 5.18:1\" commune, est plus pr\u00e9cis\u00e9ment configur\u00e9e avec un gear_ratio : 57:11 . Si plusieurs engrenages sont utilis\u00e9s sur un axe, il est possible de fournir une liste s\u00e9par\u00e9e par des virgules au param\u00e8tre gear_ratio. Par exemple, une bo\u00eete de vitesse \"5:1\" entra\u00eenant une poulie de 16 \u00e0 80 dents pourrait utiliser gear_ratio : 5:1, 80:16 . Dans la plupart des cas, le param\u00e8tre gear_ratio doit \u00eatre d\u00e9fini avec des nombres entiers, car les engrenages et les poulies les plus courants ont un nombre entier de dents. Cependant, dans les cas o\u00f9 une courroie entra\u00eene une poulie en utilisant la friction au lieu des dents, il peut \u00eatre utile d'utiliser un nombre \u00e0 virgule flottante dans le rapport de vitesse (par exemple, gear_ratio : 107.237:16 ).","title":"Distance de rotation"},{"location":"Rotation_Distance.html#distance-de-rotation","text":"Les pilotes de moteur pas \u00e0 pas avec Klipper n\u00e9cessitent un param\u00e8tre rotation_distance dans chaque section de configuration des pilotes pas \u00e0 pas . La rotation_distance est la distance parcourue par l'axe apr\u00e8s un tour complet du moteur pas \u00e0 pas. Ce document d\u00e9crit comment configurer cette valeur.","title":"Distance de rotation"},{"location":"Rotation_Distance.html#obtention-de-la-distance-de-rotation-a-partir-de-steps_per_mm-ou-step_distance","text":"Les concepteurs de votre imprimante 3d ont calcul\u00e9 \u00e0 l'origine les pas_par_mm \u00e0 partir d'une distance de rotation. Si vous connaissez les pas_par_mm, il est possible d'utiliser cette formule g\u00e9n\u00e9rale pour obtenir cette distance de rotation originale : rotation_distance = <full_steps_par_rotation> * <microsteps> / <steps_par_mm> Ou, si vous avez une ancienne configuration Klipper et que vous connaissez le param\u00e8tre step_distance , vous pouvez utiliser cette formule : rotation_distance = <full_steps_per_rotation> * <microsteps> * <step_distance> Le param\u00e8tre <full_steps_per_rotation> est d\u00e9termin\u00e9 par le type du moteur pas \u00e0 pas. La plupart des moteurs pas \u00e0 pas sont des \"pas \u00e0 pas de 1,8 degr\u00e9\" et ont donc 200 pas complets par rotation (360 divis\u00e9 par 1,8 est \u00e9gal \u00e0 200). Certains moteurs pas \u00e0 pas sont des \"pas \u00e0 pas de 0,9 degr\u00e9\" et ont donc 400 pas complets par rotation. D'autres type de moteurs pas \u00e0 pas sont rares. En cas de doute, ne d\u00e9finissez pas full_steps_per_rotation dans le fichier de configuration et utilisez 200 dans la formule ci-dessus. Le param\u00e8tre <microsteps> est d\u00e9termin\u00e9 par le pilote du moteur pas \u00e0 pas. La plupart des pilotes utilisent 16 micro-pas. Si vous n'\u00eates pas s\u00fbr, d\u00e9finissez microsteps : 16 dans la configuration et utilisez 16 dans la formule ci-dessus. Presque toutes les imprimantes devraient utiliser un nombre entier pour la distance de rotation des axes de type X, Y, et Z. Si la formule ci-dessus donne une distance de rotation qui est \u00e0 moins de 0,01 d'un nombre entier, arrondissez la valeur finale \u00e0 ce nombre entier.","title":"Obtention de la distance de rotation \u00e0 partir de steps_per_mm (ou step_distance)"},{"location":"Rotation_Distance.html#calibration-de-la-distance-de-rotation-des-extrudeuses","text":"Sur une extrudeuse, la rotation_distance est la distance que parcourt le filament durant une rotation compl\u00e8te du moteur pas \u00e0 pas. La meilleure fa\u00e7on d'obtenir une valeur pr\u00e9cise pour ce param\u00e8tre est d'utiliser une proc\u00e9dure de \"mesure et ajustement\". Commencez par une estimation initiale de la distance de rotation. Elle peut \u00eatre obtenue \u00e0 partir de pas_par_mm ou en inspectant le mat\u00e9riel . Utilisez ensuite la proc\u00e9dure suivante pour \"mesurer et ajuster\" : Assurez-vous que l'extrudeuse contient du filament, que le bloc chauffant est \u00e0 une temp\u00e9rature appropri\u00e9e et que l'imprimante est pr\u00eate \u00e0 extruder. Utilisez un marqueur pour placer une marque sur le filament \u00e0 environ 70 mm de l'entr\u00e9e du corps de l'extrudeuse. Utilisez ensuite un pied \u00e0 coulisse num\u00e9rique pour mesurer la distance r\u00e9elle de cette marque aussi pr\u00e9cis\u00e9ment que possible. Notez cette mesure comme <initial_mark_distance> . Extrudez 50 mm de filament avec la s\u00e9quence de commandes suivante : G91 suivi de G1 E50 F60 . Notez 50mm comme <distance_extrud\u00e9e_requise> . Attendez que l'extrudeuse termine son mouvement (cela prendra environ 50 secondes). Il est important d'utiliser la vitesse d'extrusion lente pour ce test car une vitesse plus rapide peut provoquer une pression \u00e9lev\u00e9e dans l'extrudeuse qui fausserait les r\u00e9sultats. (N'utilisez pas le \"bouton d'extrusion\" des interfaces graphiques pour ce test car ils extrudent \u00e0 une vitesse rapide.) Utilisez le pied \u00e0 coulisse num\u00e9rique pour mesurer la nouvelle distance entre le corps de l'extrudeuse et la marque sur le filament. Notez cette distance comme <distance_marque_suivante> . Calculez ensuite : Distance_extrud\u00e9e_r\u00e9elle = <distance_marque_initiale> - <distance_marque_suivante> Calculez la distance de rotation comme suit : distance_rotation = <distance_rotation_pr\u00e9c\u00e9dente> * <distance_extrusion_r\u00e9elle> / <distance_extrusion_demand\u00e9e> Arrondissez la nouvelle distance_rotation \u00e0 trois d\u00e9cimales. Si la distance_extrud\u00e9e_r\u00e9elle diff\u00e8re de la distance_extrud\u00e9e_requise de plus de 2 mm environ, il est bon d'effectuer les \u00e9tapes ci-dessus une nouvelle fois. Remarque : n'utilisez pas une m\u00e9thode de type \" mesurer et ajuster \" pour calibrer les axes de type x, y ou z. La m\u00e9thode \" mesurer et ajuster \" n'est pas assez pr\u00e9cise pour ces axes et conduira probablement \u00e0 une configuration moins bonne. Au lieu de cela, si n\u00e9cessaire, ces axes peuvent \u00eatre d\u00e9termin\u00e9s en mesurant les courroies, les poulies et les vis-m\u00e8re .","title":"Calibration de la distance de rotation des extrudeuses"},{"location":"Rotation_Distance.html#obtention-de-la-distance-de-rotation-par-linspection-du-materiel","text":"Il est possible de calculer la distance de rotation en connaissant les moteurs pas \u00e0 pas et la cin\u00e9matique de l'imprimante. Cela peut \u00eatre utile si le nombre de pas par mm n'est pas connu ou si l'on con\u00e7oit une nouvelle imprimante.","title":"Obtention de la distance de rotation par l'inspection du mat\u00e9riel"},{"location":"Rotation_Distance.html#axes-entraines-par-courroie","text":"Il est facile de calculer la distance de rotation pour un axe lin\u00e9aire utilisant une courroie et une poulie. D\u00e9terminez d'abord le type de courroie. La plupart des imprimantes utilisent un pas de courroie de 2 mm (c'est-\u00e0-dire que chaque dent de la courroie est espac\u00e9e de 2 mm). Comptez ensuite le nombre de dents sur la poulie du moteur pas \u00e0 pas. La distance de rotation est alors calcul\u00e9e comme suit : rotation_distance = <belt_pitch> * <number_of_teeth_on_pulley> Par exemple, si une imprimante a une courroie dont le pas est de 2 mm et utilise une poulie \u00e0 20 dents, la distance de rotation est de 40.","title":"Axes entra\u00een\u00e9s par courroie"},{"location":"Rotation_Distance.html#axes-avec-vis-mere","text":"Il est facile de calculer la distance de rotation pour les vis-m\u00e8res communes \u00e0 l'aide de la formule suivante : rotation_distance = <screw_pitch> * <number_of_separate_threads> Par exemple, la \"vis-m\u00e8re T8\" courante a une distance de rotation de 8 (elle a un pas de 2 mm et comporte 4 filets s\u00e9par\u00e9s). Les imprimantes plus anciennes \u00e9quip\u00e9es de \"tiges filet\u00e9es\" n'ont qu'un seul \"filetage\" sur la vis-m\u00e8re et la distance de rotation correspond donc au pas de la vis. (Le pas de la vis est la distance entre chaque rainure de la vis). Ainsi, par exemple, une tige m\u00e9trique M6 a une distance de rotation de 1 et une tige M8 a une distance de rotation de 1,25.","title":"Axes avec vis-m\u00e8re"},{"location":"Rotation_Distance.html#extrudeuse","text":"Il est possible d'obtenir une distance de rotation initiale pour les extrudeuses en mesurant le diam\u00e8tre de la \"roue dent\u00e9e\" entrainant le filament, en utilisant la formule suivante : distance_de_rotation = <diam\u00e8tre> * 3.14 Si l'extrudeuse utilise des engrenages, il faudra \u00e9galement d\u00e9terminer et r\u00e9gler le rapport de d\u00e9multiplication pour celle-ci. La distance de rotation r\u00e9elle d'une extrudeuse varie d'une imprimante \u00e0 l'autre, car la prise de la \"roue cr\u00e9nel\u00e9e\" qui s'engage dans le filament peut varier. Elle peut m\u00eame varier d'une bobine de filament \u00e0 l'autre. Apr\u00e8s avoir obtenu une distance de rotation initiale, utilisez la proc\u00e9dure de mesure et d'ajustement pour obtenir un r\u00e9glage plus pr\u00e9cis.","title":"Extrudeuse"},{"location":"Rotation_Distance.html#utilisation-dun-gear_ratio","text":"D\u00e9finir un gear_ratio peut faciliter la configuration de la rotation_distance des moteurs ayant une bo\u00eete de vitesse (ou similaire) attach\u00e9e \u00e0 eux. La plupart des moteurs n'ont pas de bo\u00eete de vitesse - si vous n'\u00eates pas s\u00fbr, n'utilisez pas de gear_ratio dans la configuration. Lorsqu'un gear_ratio est d\u00e9fini, la rotation_distance repr\u00e9sente la distance parcourue par l'axe lors d'une rotation compl\u00e8te du dernier engrenage de la bo\u00eete de vitesses. Si, par exemple, on utilise une bo\u00eete de vitesses avec un rapport \"5:1\", on peut calculer la distance de rotation avec connaissance du mat\u00e9riel et ensuite ajouter gear_ratio : 5:1 \u00e0 la configuration. Pour des engrenages mis en \u0153uvre avec des courroies et des poulies, il est possible de d\u00e9terminer le rapport de d\u00e9multiplication en comptant les dents des poulies. Par exemple, si une poulie de 16 dents entra\u00eene la poulie suivante de 80 dents, on utilisera gear_ratio : 80:16 . En effet, on peut ouvrir une \"bo\u00eete de vitesse\" courante et compter les dents pour confirmer le rapport d'engrenage. Notez que parfois, une bo\u00eete de vitesses aura un rapport de transmission l\u00e9g\u00e8rement diff\u00e9rent de celui qui est annonc\u00e9. Les engrenages courants du moteur d'extrudeuse BMG en sont un exemple - ils sont annonc\u00e9s comme \u00e9tant de \"3:1\" mais utilisent en r\u00e9alit\u00e9 un engrenage de \"50:17\". (L'utilisation de nombres de dents sans d\u00e9nominateur commun peut am\u00e9liorer l'usure globale de l'engrenage car les dents ne s'engr\u00e8nent pas toujours de la m\u00eame mani\u00e8re \u00e0 chaque tour). La \"boite de vitesses plan\u00e9taire 5.18:1\" commune, est plus pr\u00e9cis\u00e9ment configur\u00e9e avec un gear_ratio : 57:11 . Si plusieurs engrenages sont utilis\u00e9s sur un axe, il est possible de fournir une liste s\u00e9par\u00e9e par des virgules au param\u00e8tre gear_ratio. Par exemple, une bo\u00eete de vitesse \"5:1\" entra\u00eenant une poulie de 16 \u00e0 80 dents pourrait utiliser gear_ratio : 5:1, 80:16 . Dans la plupart des cas, le param\u00e8tre gear_ratio doit \u00eatre d\u00e9fini avec des nombres entiers, car les engrenages et les poulies les plus courants ont un nombre entier de dents. Cependant, dans les cas o\u00f9 une courroie entra\u00eene une poulie en utilisant la friction au lieu des dents, il peut \u00eatre utile d'utiliser un nombre \u00e0 virgule flottante dans le rapport de vitesse (par exemple, gear_ratio : 107.237:16 ).","title":"Utilisation d'un gear_ratio"},{"location":"SDCard_Updates.html","text":"Mises \u00e0 jour via la carte SD \u00b6 La plupart des microcontr\u00f4leurs actuels sont livr\u00e9s avec un programme d'amor\u00e7age capable de mettre \u00e0 jour le micrologiciel via une carte SD. Bien que cela soit pratique dans de nombreux cas, ces programmes d'amor\u00e7age ne fournissent g\u00e9n\u00e9ralement aucun autre moyen de mettre \u00e0 jour le micrologiciel. Cela peut s'av\u00e9rer g\u00eanant si votre carte est install\u00e9e dans un endroit difficile d'acc\u00e8s ou si vous avez besoin de mettre \u00e0 jour le firmware r\u00e9guli\u00e8rement. Apr\u00e8s avoir initialement flash\u00e9 Klipper sur un microcontr\u00f4leur, il est possible de transf\u00e9rer le nouveau micrologiciel sur la carte SD et de lancer le processus de mise \u00e0 jour via ssh. Proc\u00e9dure de mise \u00e0 jour classique \u00b6 La proc\u00e9dure pour mettre \u00e0 jour le firmware du MCU en utilisant la carte SD est similaire \u00e0 celle des autres m\u00e9thodes. Au lieu d'utiliser make flash , il est n\u00e9cessaire d'ex\u00e9cuter un script d'aide, flash-sdcard.sh . La mise \u00e0 jour d'un BigTreeTech SKR 1.3 pourrait ressembler \u00e0 ce qui suit : sudo service klipper stop cd ~/klipper git pull make clean make menuconfig make ./scripts/flash-sdcard.sh /dev/ttyACM0 btt-skr-v1.3 sudo service klipper start C'est \u00e0 l'utilisateur de d\u00e9terminer l'emplacement du p\u00e9riph\u00e9rique et le nom de la carte. Si un utilisateur a besoin de flasher plusieurs cartes, flash-sdcard.sh (ou make flash si appropri\u00e9) doit \u00eatre ex\u00e9cut\u00e9 pour chaque carte avant de red\u00e9marrer le service Klipper. Les cartes support\u00e9es peuvent \u00eatre list\u00e9es avec la commande suivante : ./scripts/flash-sdcard.sh -l Si vous ne voyez pas votre carte dans la liste, il peut \u00eatre n\u00e9cessaire d'ajouter une nouvelle d\u00e9finition de carte comme d\u00e9crit ci-dessous . Utilisation avanc\u00e9e \u00b6 Les commandes ci-dessus supposent que votre MCU se connecte \u00e0 la vitesse de transmission par d\u00e9faut de 250000 et que le firmware se trouve dans ~/klipper/out/klipper.bin . Le script flash-sdcard.sh fournit des options pour changer ces valeurs par d\u00e9faut. Toutes les options peuvent \u00eatre visualis\u00e9es par l'\u00e9cran d'aide : ./scripts/flash-sdcard.sh -h SD Card upload utility for Klipper usage: flash_sdcard.sh [-h] [-l] [-c] [-b <baud>] [-f <firmware>] <device> <board> positional arguments: <device> device serial port <board> board type optional arguments: -h show this message -l list available boards -c run flash check/verify only (skip upload) -b <baud> serial baud rate (default is 250000) -f <firmware> path to klipper.bin Si votre carte est flash\u00e9e avec un firmware qui se connecte \u00e0 un taux de baud personnalis\u00e9, il est possible de mettre \u00e0 jour en sp\u00e9cifiant l'option -b : ./scripts/flash-sdcard.sh -b 115200 /dev/ttyAMA0 btt-skr-v1.3 Si vous souhaitez flasher une version de Klipper situ\u00e9e ailleurs que dans l'emplacement par d\u00e9faut, vous pouvez le faire en sp\u00e9cifiant l'option -f : ./scripts/flash-sdcard.sh -f ~/downloads/klipper.bin /dev/ttyAMA0 btt-skr-v1.3 Notez que lors de la mise \u00e0 jour d'un MKS Robin E3, il n'est pas n\u00e9cessaire d'ex\u00e9cuter manuellement update_mks_robin.py et de fournir le binaire r\u00e9sultant \u00e0 flash-sdcard.sh . Cette proc\u00e9dure est automatis\u00e9e pendant le processus de t\u00e9l\u00e9chargement. L'option -c est utilis\u00e9e pour effectuer une op\u00e9ration de contr\u00f4le ou de v\u00e9rification uniquement pour tester si la carte ex\u00e9cute correctement le firmware sp\u00e9cifi\u00e9. Cette option est principalement destin\u00e9e aux cas o\u00f9 un cycle d'alimentation manuel est n\u00e9cessaire pour compl\u00e9ter la proc\u00e9dure de flashage, comme avec des chargeurs de d\u00e9marrage utilisant le mode SDIO au lieu de SPI pour acc\u00e9der \u00e0 leurs cartes SD. (Voir Caveats ci-dessous) Mais, elle peut \u00e9galement \u00eatre utilis\u00e9e \u00e0 tout moment pour v\u00e9rifier si le code flash\u00e9 dans la carte correspond \u00e0 la version dans votre dossier de construction sur toute carte support\u00e9e. Avertissements \u00b6 Comme mentionn\u00e9 dans l'introduction, cette m\u00e9thode ne fonctionne que pour la mise \u00e0 jour du firmware. La proc\u00e9dure de flashage initial doit \u00eatre effectu\u00e9e manuellement selon les instructions qui s'appliquent \u00e0 votre carte contr\u00f4leur. Bien qu'il soit possible de flasher un build qui change le Baud s\u00e9rie ou l'interface de connexion (par exemple, de USB \u00e0 UART), la v\u00e9rification \u00e9chouera toujours car le script ne pourra pas se reconnecter au MCU pour v\u00e9rifier la version actuelle. Seules les cartes utilisant SPI pour la communication avec la carte SD sont support\u00e9es. Les cartes utiliaent SDIO, comme la Flymaker Flyboard et la MKS Robin Nano V1/V2, ne fonctionneront pas en mode SDIO. Cependant, il est g\u00e9n\u00e9ralement possible de flasher ces cartes en utilisant le mode SPI logiciel. Mais si le chargeur d'amor\u00e7age de la carte n'utilise que le mode SDIO pour acc\u00e9der \u00e0 la carte SD, un cycle d'alimentation de la carte et de la carte SD sera n\u00e9cessaire pour que le mode puisse passer de SPI \u00e0 SDIO pour terminer le flashage. De telles cartes devraient \u00eatre d\u00e9finies avec skip_verify activ\u00e9 pour sauter l'\u00e9tape de v\u00e9rification imm\u00e9diatement apr\u00e8s le flashage. Ensuite, apr\u00e8s le power-cycle manuel, vous pouvez r\u00e9-ex\u00e9cuter exactement la m\u00eame commande ./scripts/flash-sdcard.sh , mais ajouter l'option -c pour compl\u00e9ter l'op\u00e9ration de v\u00e9rification. Voir Flasher des cartes utilisant SDIO pour des exemples. D\u00e9finitions des cartes \u00b6 La plupart des cartes courantes devraient \u00eatre disponibles, mais il est possible d'ajouter une nouvelle d\u00e9finition de carte si n\u00e9cessaire. Les d\u00e9finitions des cartes sont situ\u00e9es dans ~/klipper/scripts/spi_flash/board_defs.py . Les d\u00e9finitions sont stock\u00e9es dans un dictionnaire, par exemple : BOARD_DEFS = { 'generic-lpc1768' : { 'mcu' : \"lpc1768\" , 'spi_bus' : \"ssp1\" , \"cs_pin\" : \"P0.6\" }, ...< further definitions > } Les champs suivants peuvent \u00eatre pr\u00e9cis\u00e9s : mcu : Le type de mcu. On peut le retrouver apr\u00e8s avoir configur\u00e9 le build via make menuconfig en ex\u00e9cutant cat .config | grep CONFIG_MCU . Ce champ est obligatoire. spi_bus : Le bus SPI connect\u00e9 \u00e0 la carte SD. Ceci doit \u00eatre obtenu \u00e0 partir du sch\u00e9ma de la carte. Ce champ est obligatoire. cs_pin : La broche de s\u00e9lection de puce connect\u00e9e \u00e0 la carte SD. Ceci doit \u00eatre obtenu \u00e0 partir du sch\u00e9ma de la carte. Ce champ est obligatoire. firmware_path : Le chemin sur la carte SD o\u00f9 le firmware doit \u00eatre transf\u00e9r\u00e9. La valeur par d\u00e9faut est firmware.bin . current_firmware_path : Le chemin sur la carte SD o\u00f9 le fichier du firmware renomm\u00e9 est situ\u00e9 apr\u00e8s un flash r\u00e9ussi. La valeur par d\u00e9faut est firmware.cur . skip_verify : d\u00e9finit une valeur bool\u00e9enne indiquant aux scripts d'ignorer l'\u00e9tape de v\u00e9rification du firmware pendant le processus de flashage. La valeur par d\u00e9faut est False . Peut \u00eatre d\u00e9fini \u00e0 True pour les cartes n\u00e9cessitant un cycle d'alimentation manuel pour terminer le flashage. Pour v\u00e9rifier le firmware par la suite, ex\u00e9cutez \u00e0 nouveau le script avec l'option -c pour effectuer l'\u00e9tape de v\u00e9rification. Voir les avertissements avec les cartes SDIO Si le SPI logiciel est requis, le champ spi_bus doit \u00eatre r\u00e9gl\u00e9 sur swspi et le champ suppl\u00e9mentaire suivant doit \u00eatre sp\u00e9cifi\u00e9 : spi_pins : Ceci devrait \u00eatre 3 broches s\u00e9par\u00e9es par des virgules qui sont connect\u00e9es \u00e0 la carte SD dans le format de miso,mosi,sclk . Il devrait \u00eatre extr\u00eamement rare que le SPI logiciel soit n\u00e9cessaire, typiquement seules les cartes avec des erreurs de conception ou les cartes ne supportant que le mode SDIO pour leur carte SD en auront besoin. La d\u00e9finition de la carte btt-skr-pro fournit un exemple du premier cas, et la d\u00e9finition de la carte btt-octopus-f446-v1 fournit un exemple du second. Avant de cr\u00e9er une nouvelle d\u00e9finition de carte, il faut v\u00e9rifier si la d\u00e9finition d'une carte existante r\u00e9pond aux crit\u00e8res n\u00e9cessaires pour la nouvelle carte. Si c'est le cas, un BOARD_ALIAS peut \u00eatre utilis\u00e9. Par exemple, l'alias suivant peut \u00eatre ajout\u00e9 pour sp\u00e9cifier my-new-board comme alias de generic-lpc1768 : BOARD_ALIASES = { ...< previous aliases > , 'my-new-board' : BOARD_DEFS [ 'generic-lpc1768' ], } Si vous avez besoin d'une nouvelle d\u00e9finition de carte et que vous n'\u00eates pas \u00e0 l'aise avec la proc\u00e9dure d\u00e9crite ci-dessus, il est recommand\u00e9 d'en demander une sur le Discord de la communaut\u00e9 Klipper . Flashage des cartes utilisant SDIO \u00b6 Comme mentionn\u00e9 dans les Caveats , les cartes dont le chargeur de d\u00e9marrage utilise le mode SDIO pour l'acc\u00e8s \u00e0 leur carte SD n\u00e9cessitent un power-cycle de la carte, et plus particuli\u00e8rement de la carte SD elle-m\u00eame, afin de passer du mode SPI utilis\u00e9 lors de l'\u00e9criture du fichier sur la carte SD au mode SDIO pour que le chargeur de d\u00e9marrage puisse le flasher sur la carte. Ces d\u00e9finitions de cartes utiliseront le drapeau skip_verify , qui indique \u00e0 l'outil de flashage de s'arr\u00eater apr\u00e8s l'\u00e9criture du firmware sur la carte SD afin que la carte puisse \u00eatre mise sous tension manuellement et que l'\u00e9tape de v\u00e9rification soit report\u00e9e jusqu'\u00e0 ce qu'elle soit termin\u00e9e. Il y a deux sc\u00e9narios : l'un avec l'h\u00f4te RPi fonctionnant sur une alimentation s\u00e9par\u00e9e et l'autre lorsque l'h\u00f4te RPi fonctionne sur la m\u00eame alimentation que la carte principale \u00e0 flasher. La diff\u00e9rence est de savoir s'il est n\u00e9cessaire ou non d'\u00e9teindre le RPi et ensuite ssh de nouveau apr\u00e8s que le flashage soit termin\u00e9 afin de faire l'\u00e9tape de v\u00e9rification, ou si la v\u00e9rification peut \u00eatre faite imm\u00e9diatement. Voici des exemples des deux sc\u00e9narios : Programmation SDIO avec RPi sur alimentation s\u00e9par\u00e9e \u00b6 Une session typique avec le RPi sur une alimentation s\u00e9par\u00e9e ressemble \u00e0 ce qui suit. Vous devrez, bien s\u00fbr, utiliser le chemin du p\u00e9riph\u00e9rique et le nom de la carte : sudo service klipper stop cd ~/klipper git pull make clean make menuconfig make ./scripts/flash-sdcard.sh /dev/ttyACM0 btt-octopus-f446-v1 [[[\u00e9teindre-allumer manuellement la carte de l'imprimante quand vous y \u00eates invit\u00e9]]] ./scripts/flash-sdcard.sh -c /dev/ttyACM0 btt-octopus-f446-v1 sudo service klipper start Programmation SDIO avec RPi sur la m\u00eame alimentation \u00e9lectrique \u00b6 Une session typique avec le RPi sur la m\u00eame alimentation ressemble \u00e0 ce qui suit. Vous devrez, bien s\u00fbr, utiliser le chemin du p\u00e9riph\u00e9rique et le nom de la carte : sudo service klipper stop cd ~/klipper git pull make clean make menuconfig make ./scripts/flash-sdcard.sh /dev/ttyACM0 btt-octopus-f446-v1 sudo shutdown -h now [[[attendre que le RPi s'arr\u00eate, puis \u00e9teindre-allumer et ssh \u00e0 nouveau sur le RPi quand il a red\u00e9marr\u00e9]]] sudo service klipper stop cd ~/klipper ./scripts/flash-sdcard.sh -c /dev/ttyACM0 btt-octopus-f446-v1 sudo service klipper start Dans ce cas, puisque l'h\u00f4te RPi est en train d'\u00eatre red\u00e9marr\u00e9, ce qui va red\u00e9marrer le service klipper , il est n\u00e9cessaire d'arr\u00eater le service klipper avant de faire l'\u00e9tape de v\u00e9rification et de le red\u00e9marrer une fois la v\u00e9rification termin\u00e9e. Mappage des broches SDIO vers SPI \u00b6 Si le sch\u00e9ma de votre carte utilise SDIO pour sa carte SD, vous pouvez mapper les broches comme d\u00e9crit dans le tableau ci-dessous pour d\u00e9terminer les broches SPI logicielles compatibles \u00e0 assigner dans le fichier board_defs.py : Broche de la carte SD Broche pour carte micro SD Nom de la broche SDIO Nom de la broche SPI 9 1 DATA2 None (PU)* 1 2 CD/DATA3 CS 2 3 CMD MOSI 4 4 +3.3V (VDD) +3.3V (VDD) 5 5 CLK SCLK 3 6 GND (VSS) GND (VSS) 7 7 DATA0 MISO 8 8 DATA1 None (PU)* N/A 9 Card Detect (CD) Card Detect (CD) 6 10 GND GND * None (PU) indique une broche inutilis\u00e9e avec une r\u00e9sistance de tirage haut","title":"Mises \u00e0 jour via la carte SD"},{"location":"SDCard_Updates.html#mises-a-jour-via-la-carte-sd","text":"La plupart des microcontr\u00f4leurs actuels sont livr\u00e9s avec un programme d'amor\u00e7age capable de mettre \u00e0 jour le micrologiciel via une carte SD. Bien que cela soit pratique dans de nombreux cas, ces programmes d'amor\u00e7age ne fournissent g\u00e9n\u00e9ralement aucun autre moyen de mettre \u00e0 jour le micrologiciel. Cela peut s'av\u00e9rer g\u00eanant si votre carte est install\u00e9e dans un endroit difficile d'acc\u00e8s ou si vous avez besoin de mettre \u00e0 jour le firmware r\u00e9guli\u00e8rement. Apr\u00e8s avoir initialement flash\u00e9 Klipper sur un microcontr\u00f4leur, il est possible de transf\u00e9rer le nouveau micrologiciel sur la carte SD et de lancer le processus de mise \u00e0 jour via ssh.","title":"Mises \u00e0 jour via la carte SD"},{"location":"SDCard_Updates.html#procedure-de-mise-a-jour-classique","text":"La proc\u00e9dure pour mettre \u00e0 jour le firmware du MCU en utilisant la carte SD est similaire \u00e0 celle des autres m\u00e9thodes. Au lieu d'utiliser make flash , il est n\u00e9cessaire d'ex\u00e9cuter un script d'aide, flash-sdcard.sh . La mise \u00e0 jour d'un BigTreeTech SKR 1.3 pourrait ressembler \u00e0 ce qui suit : sudo service klipper stop cd ~/klipper git pull make clean make menuconfig make ./scripts/flash-sdcard.sh /dev/ttyACM0 btt-skr-v1.3 sudo service klipper start C'est \u00e0 l'utilisateur de d\u00e9terminer l'emplacement du p\u00e9riph\u00e9rique et le nom de la carte. Si un utilisateur a besoin de flasher plusieurs cartes, flash-sdcard.sh (ou make flash si appropri\u00e9) doit \u00eatre ex\u00e9cut\u00e9 pour chaque carte avant de red\u00e9marrer le service Klipper. Les cartes support\u00e9es peuvent \u00eatre list\u00e9es avec la commande suivante : ./scripts/flash-sdcard.sh -l Si vous ne voyez pas votre carte dans la liste, il peut \u00eatre n\u00e9cessaire d'ajouter une nouvelle d\u00e9finition de carte comme d\u00e9crit ci-dessous .","title":"Proc\u00e9dure de mise \u00e0 jour classique"},{"location":"SDCard_Updates.html#utilisation-avancee","text":"Les commandes ci-dessus supposent que votre MCU se connecte \u00e0 la vitesse de transmission par d\u00e9faut de 250000 et que le firmware se trouve dans ~/klipper/out/klipper.bin . Le script flash-sdcard.sh fournit des options pour changer ces valeurs par d\u00e9faut. Toutes les options peuvent \u00eatre visualis\u00e9es par l'\u00e9cran d'aide : ./scripts/flash-sdcard.sh -h SD Card upload utility for Klipper usage: flash_sdcard.sh [-h] [-l] [-c] [-b <baud>] [-f <firmware>] <device> <board> positional arguments: <device> device serial port <board> board type optional arguments: -h show this message -l list available boards -c run flash check/verify only (skip upload) -b <baud> serial baud rate (default is 250000) -f <firmware> path to klipper.bin Si votre carte est flash\u00e9e avec un firmware qui se connecte \u00e0 un taux de baud personnalis\u00e9, il est possible de mettre \u00e0 jour en sp\u00e9cifiant l'option -b : ./scripts/flash-sdcard.sh -b 115200 /dev/ttyAMA0 btt-skr-v1.3 Si vous souhaitez flasher une version de Klipper situ\u00e9e ailleurs que dans l'emplacement par d\u00e9faut, vous pouvez le faire en sp\u00e9cifiant l'option -f : ./scripts/flash-sdcard.sh -f ~/downloads/klipper.bin /dev/ttyAMA0 btt-skr-v1.3 Notez que lors de la mise \u00e0 jour d'un MKS Robin E3, il n'est pas n\u00e9cessaire d'ex\u00e9cuter manuellement update_mks_robin.py et de fournir le binaire r\u00e9sultant \u00e0 flash-sdcard.sh . Cette proc\u00e9dure est automatis\u00e9e pendant le processus de t\u00e9l\u00e9chargement. L'option -c est utilis\u00e9e pour effectuer une op\u00e9ration de contr\u00f4le ou de v\u00e9rification uniquement pour tester si la carte ex\u00e9cute correctement le firmware sp\u00e9cifi\u00e9. Cette option est principalement destin\u00e9e aux cas o\u00f9 un cycle d'alimentation manuel est n\u00e9cessaire pour compl\u00e9ter la proc\u00e9dure de flashage, comme avec des chargeurs de d\u00e9marrage utilisant le mode SDIO au lieu de SPI pour acc\u00e9der \u00e0 leurs cartes SD. (Voir Caveats ci-dessous) Mais, elle peut \u00e9galement \u00eatre utilis\u00e9e \u00e0 tout moment pour v\u00e9rifier si le code flash\u00e9 dans la carte correspond \u00e0 la version dans votre dossier de construction sur toute carte support\u00e9e.","title":"Utilisation avanc\u00e9e"},{"location":"SDCard_Updates.html#avertissements","text":"Comme mentionn\u00e9 dans l'introduction, cette m\u00e9thode ne fonctionne que pour la mise \u00e0 jour du firmware. La proc\u00e9dure de flashage initial doit \u00eatre effectu\u00e9e manuellement selon les instructions qui s'appliquent \u00e0 votre carte contr\u00f4leur. Bien qu'il soit possible de flasher un build qui change le Baud s\u00e9rie ou l'interface de connexion (par exemple, de USB \u00e0 UART), la v\u00e9rification \u00e9chouera toujours car le script ne pourra pas se reconnecter au MCU pour v\u00e9rifier la version actuelle. Seules les cartes utilisant SPI pour la communication avec la carte SD sont support\u00e9es. Les cartes utiliaent SDIO, comme la Flymaker Flyboard et la MKS Robin Nano V1/V2, ne fonctionneront pas en mode SDIO. Cependant, il est g\u00e9n\u00e9ralement possible de flasher ces cartes en utilisant le mode SPI logiciel. Mais si le chargeur d'amor\u00e7age de la carte n'utilise que le mode SDIO pour acc\u00e9der \u00e0 la carte SD, un cycle d'alimentation de la carte et de la carte SD sera n\u00e9cessaire pour que le mode puisse passer de SPI \u00e0 SDIO pour terminer le flashage. De telles cartes devraient \u00eatre d\u00e9finies avec skip_verify activ\u00e9 pour sauter l'\u00e9tape de v\u00e9rification imm\u00e9diatement apr\u00e8s le flashage. Ensuite, apr\u00e8s le power-cycle manuel, vous pouvez r\u00e9-ex\u00e9cuter exactement la m\u00eame commande ./scripts/flash-sdcard.sh , mais ajouter l'option -c pour compl\u00e9ter l'op\u00e9ration de v\u00e9rification. Voir Flasher des cartes utilisant SDIO pour des exemples.","title":"Avertissements"},{"location":"SDCard_Updates.html#definitions-des-cartes","text":"La plupart des cartes courantes devraient \u00eatre disponibles, mais il est possible d'ajouter une nouvelle d\u00e9finition de carte si n\u00e9cessaire. Les d\u00e9finitions des cartes sont situ\u00e9es dans ~/klipper/scripts/spi_flash/board_defs.py . Les d\u00e9finitions sont stock\u00e9es dans un dictionnaire, par exemple : BOARD_DEFS = { 'generic-lpc1768' : { 'mcu' : \"lpc1768\" , 'spi_bus' : \"ssp1\" , \"cs_pin\" : \"P0.6\" }, ...< further definitions > } Les champs suivants peuvent \u00eatre pr\u00e9cis\u00e9s : mcu : Le type de mcu. On peut le retrouver apr\u00e8s avoir configur\u00e9 le build via make menuconfig en ex\u00e9cutant cat .config | grep CONFIG_MCU . Ce champ est obligatoire. spi_bus : Le bus SPI connect\u00e9 \u00e0 la carte SD. Ceci doit \u00eatre obtenu \u00e0 partir du sch\u00e9ma de la carte. Ce champ est obligatoire. cs_pin : La broche de s\u00e9lection de puce connect\u00e9e \u00e0 la carte SD. Ceci doit \u00eatre obtenu \u00e0 partir du sch\u00e9ma de la carte. Ce champ est obligatoire. firmware_path : Le chemin sur la carte SD o\u00f9 le firmware doit \u00eatre transf\u00e9r\u00e9. La valeur par d\u00e9faut est firmware.bin . current_firmware_path : Le chemin sur la carte SD o\u00f9 le fichier du firmware renomm\u00e9 est situ\u00e9 apr\u00e8s un flash r\u00e9ussi. La valeur par d\u00e9faut est firmware.cur . skip_verify : d\u00e9finit une valeur bool\u00e9enne indiquant aux scripts d'ignorer l'\u00e9tape de v\u00e9rification du firmware pendant le processus de flashage. La valeur par d\u00e9faut est False . Peut \u00eatre d\u00e9fini \u00e0 True pour les cartes n\u00e9cessitant un cycle d'alimentation manuel pour terminer le flashage. Pour v\u00e9rifier le firmware par la suite, ex\u00e9cutez \u00e0 nouveau le script avec l'option -c pour effectuer l'\u00e9tape de v\u00e9rification. Voir les avertissements avec les cartes SDIO Si le SPI logiciel est requis, le champ spi_bus doit \u00eatre r\u00e9gl\u00e9 sur swspi et le champ suppl\u00e9mentaire suivant doit \u00eatre sp\u00e9cifi\u00e9 : spi_pins : Ceci devrait \u00eatre 3 broches s\u00e9par\u00e9es par des virgules qui sont connect\u00e9es \u00e0 la carte SD dans le format de miso,mosi,sclk . Il devrait \u00eatre extr\u00eamement rare que le SPI logiciel soit n\u00e9cessaire, typiquement seules les cartes avec des erreurs de conception ou les cartes ne supportant que le mode SDIO pour leur carte SD en auront besoin. La d\u00e9finition de la carte btt-skr-pro fournit un exemple du premier cas, et la d\u00e9finition de la carte btt-octopus-f446-v1 fournit un exemple du second. Avant de cr\u00e9er une nouvelle d\u00e9finition de carte, il faut v\u00e9rifier si la d\u00e9finition d'une carte existante r\u00e9pond aux crit\u00e8res n\u00e9cessaires pour la nouvelle carte. Si c'est le cas, un BOARD_ALIAS peut \u00eatre utilis\u00e9. Par exemple, l'alias suivant peut \u00eatre ajout\u00e9 pour sp\u00e9cifier my-new-board comme alias de generic-lpc1768 : BOARD_ALIASES = { ...< previous aliases > , 'my-new-board' : BOARD_DEFS [ 'generic-lpc1768' ], } Si vous avez besoin d'une nouvelle d\u00e9finition de carte et que vous n'\u00eates pas \u00e0 l'aise avec la proc\u00e9dure d\u00e9crite ci-dessus, il est recommand\u00e9 d'en demander une sur le Discord de la communaut\u00e9 Klipper .","title":"D\u00e9finitions des cartes"},{"location":"SDCard_Updates.html#flashage-des-cartes-utilisant-sdio","text":"Comme mentionn\u00e9 dans les Caveats , les cartes dont le chargeur de d\u00e9marrage utilise le mode SDIO pour l'acc\u00e8s \u00e0 leur carte SD n\u00e9cessitent un power-cycle de la carte, et plus particuli\u00e8rement de la carte SD elle-m\u00eame, afin de passer du mode SPI utilis\u00e9 lors de l'\u00e9criture du fichier sur la carte SD au mode SDIO pour que le chargeur de d\u00e9marrage puisse le flasher sur la carte. Ces d\u00e9finitions de cartes utiliseront le drapeau skip_verify , qui indique \u00e0 l'outil de flashage de s'arr\u00eater apr\u00e8s l'\u00e9criture du firmware sur la carte SD afin que la carte puisse \u00eatre mise sous tension manuellement et que l'\u00e9tape de v\u00e9rification soit report\u00e9e jusqu'\u00e0 ce qu'elle soit termin\u00e9e. Il y a deux sc\u00e9narios : l'un avec l'h\u00f4te RPi fonctionnant sur une alimentation s\u00e9par\u00e9e et l'autre lorsque l'h\u00f4te RPi fonctionne sur la m\u00eame alimentation que la carte principale \u00e0 flasher. La diff\u00e9rence est de savoir s'il est n\u00e9cessaire ou non d'\u00e9teindre le RPi et ensuite ssh de nouveau apr\u00e8s que le flashage soit termin\u00e9 afin de faire l'\u00e9tape de v\u00e9rification, ou si la v\u00e9rification peut \u00eatre faite imm\u00e9diatement. Voici des exemples des deux sc\u00e9narios :","title":"Flashage des cartes utilisant SDIO"},{"location":"SDCard_Updates.html#programmation-sdio-avec-rpi-sur-alimentation-separee","text":"Une session typique avec le RPi sur une alimentation s\u00e9par\u00e9e ressemble \u00e0 ce qui suit. Vous devrez, bien s\u00fbr, utiliser le chemin du p\u00e9riph\u00e9rique et le nom de la carte : sudo service klipper stop cd ~/klipper git pull make clean make menuconfig make ./scripts/flash-sdcard.sh /dev/ttyACM0 btt-octopus-f446-v1 [[[\u00e9teindre-allumer manuellement la carte de l'imprimante quand vous y \u00eates invit\u00e9]]] ./scripts/flash-sdcard.sh -c /dev/ttyACM0 btt-octopus-f446-v1 sudo service klipper start","title":"Programmation SDIO avec RPi sur alimentation s\u00e9par\u00e9e"},{"location":"SDCard_Updates.html#programmation-sdio-avec-rpi-sur-la-meme-alimentation-electrique","text":"Une session typique avec le RPi sur la m\u00eame alimentation ressemble \u00e0 ce qui suit. Vous devrez, bien s\u00fbr, utiliser le chemin du p\u00e9riph\u00e9rique et le nom de la carte : sudo service klipper stop cd ~/klipper git pull make clean make menuconfig make ./scripts/flash-sdcard.sh /dev/ttyACM0 btt-octopus-f446-v1 sudo shutdown -h now [[[attendre que le RPi s'arr\u00eate, puis \u00e9teindre-allumer et ssh \u00e0 nouveau sur le RPi quand il a red\u00e9marr\u00e9]]] sudo service klipper stop cd ~/klipper ./scripts/flash-sdcard.sh -c /dev/ttyACM0 btt-octopus-f446-v1 sudo service klipper start Dans ce cas, puisque l'h\u00f4te RPi est en train d'\u00eatre red\u00e9marr\u00e9, ce qui va red\u00e9marrer le service klipper , il est n\u00e9cessaire d'arr\u00eater le service klipper avant de faire l'\u00e9tape de v\u00e9rification et de le red\u00e9marrer une fois la v\u00e9rification termin\u00e9e.","title":"Programmation SDIO avec RPi sur la m\u00eame alimentation \u00e9lectrique"},{"location":"SDCard_Updates.html#mappage-des-broches-sdio-vers-spi","text":"Si le sch\u00e9ma de votre carte utilise SDIO pour sa carte SD, vous pouvez mapper les broches comme d\u00e9crit dans le tableau ci-dessous pour d\u00e9terminer les broches SPI logicielles compatibles \u00e0 assigner dans le fichier board_defs.py : Broche de la carte SD Broche pour carte micro SD Nom de la broche SDIO Nom de la broche SPI 9 1 DATA2 None (PU)* 1 2 CD/DATA3 CS 2 3 CMD MOSI 4 4 +3.3V (VDD) +3.3V (VDD) 5 5 CLK SCLK 3 6 GND (VSS) GND (VSS) 7 7 DATA0 MISO 8 8 DATA1 None (PU)* N/A 9 Card Detect (CD) Card Detect (CD) 6 10 GND GND * None (PU) indique une broche inutilis\u00e9e avec une r\u00e9sistance de tirage haut","title":"Mappage des broches SDIO vers SPI"},{"location":"Skew_Correction.html","text":"Correction de l'\u00e9querrage \u00b6 La correction logicielle de l'\u00e9querrage peut aider \u00e0 r\u00e9soudre les inexactitudes dimensionnelles r\u00e9sultant d'un assemblage d'imprimante qui n'est pas parfaitement d'\u00e9querre. Notez que si votre imprimante est consid\u00e9rablement asym\u00e9trique, il est fortement recommand\u00e9 d'utiliser d'abord des moyens m\u00e9caniques pour obtenir une imprimante le plus d'\u00e9querre possible avant d'appliquer la correction bas\u00e9e sur le logiciel. Impression d'un objet de calibrage \u00b6 La premi\u00e8re \u00e9tape de la correction de l'\u00e9querrage consiste \u00e0 imprimer un objet d'\u00e9talonnage le long du plan que vous souhaitez corriger. Il existe \u00e9galement un objet d'\u00e9talonnage qui inclut tous les plans dans un seul mod\u00e8le. Veuillez \u00e0 orienter l'objet de sorte que le coin A soit vers l'origine du plan. Assurez-vous qu'aucune correction d'\u00e9querrage n'est appliqu\u00e9e pendant cette impression. Vous pouvez le faire en supprimant le module [skew_correction] du fichier printer.cfg ou en tapant un gcode SET_SKEW CLEAR=1 . Prenez vos mesures \u00b6 Le module [skew_correcton] n\u00e9cessite 3 mesures pour chaque plan que vous souhaitez corriger ; la longueur du coin A au coin C, la longueur du coin B au coin D et la longueur du coin A au coin D. Lors de la mesure de la longueur AD, n'incluez pas les plats sur les coins fournis par certains objets de test. Configurez votre \u00e9querrage \u00b6 Assurez-vous que [skew_correction] est bien dans le fichier printer.cfg. Vous pouvez maintenant utiliser le gcode SET_SKEW pour configurer skew_correcton. Par exemple, si vos longueurs mesur\u00e9es le long de XY sont les suivantes : Length AC = 140.4 Length BD = 142.8 Length AD = 99.8 SET_SKEW peut \u00eatre utilis\u00e9 pour configurer la correction d'\u00e9querrage pour le plan XY. SET_SKEW XY=140.4,142.8,99.8 Vous pouvez \u00e9galement ajouter des mesures pour XZ et YZ au gcode : SET_SKEW XY=140.4,142.8,99.8 XZ=141.6,141.4,99.8 YZ=142.4,140.5,99.5 Le module [skew_correction] prend \u00e9galement en charge la gestion des profils d'une mani\u00e8re similaire \u00e0 [bed_mesh] . Apr\u00e8s avoir d\u00e9fini la correction d'\u00e9querrage \u00e0 l'aide du gcode SET_SKEW , vous pouvez utiliser le gcode SKEW_PROFILE pour l'enregistrer : SKEW_PROFILE SAVE=my_skew_profile Apr\u00e8s cette commande, vous serez invit\u00e9 \u00e0 saisir un SAVE_CONFIG pour enregistrer le profil de mani\u00e8re permanente. Si aucun profil n'est nomm\u00e9 my_skew_profile alors un nouveau profil sera cr\u00e9\u00e9. Si le profil nomm\u00e9 existe, il sera \u00e9cras\u00e9. Une fois que vous avez un profil enregistr\u00e9, vous pouvez le charger : SKEW_PROFILE LOAD=my_skew_profile Il est \u00e9galement possible de supprimer un profil ancien ou obsol\u00e8te : SKEW_PROFILE REMOVE=my_skew_profile Apr\u00e8s avoir supprim\u00e9 un profil, vous serez invit\u00e9 \u00e0 saisir un SAVE_CONFIG pour que cette suppression soit sauvegard\u00e9e. V\u00e9rification de votre correction \u00b6 Une fois que skew_correction a \u00e9t\u00e9 configur\u00e9, vous pouvez r\u00e9imprimer l'objet de calibrage avec la correction activ\u00e9e. Utilisez le g-code suivant pour v\u00e9rifier votre \u00e9querrage sur chaque plan. Les r\u00e9sultats devraient \u00eatre inf\u00e9rieurs \u00e0 ceux rapport\u00e9s via GET_CURRENT_SKEW . CALC_MEASURED_SKEW AC=<ac_length> BD=<bd_length> AD=<ad_length> Avertissements \u00b6 En raison de la nature de la correction de l'\u00e9querrage, il est recommand\u00e9 de configurer la correction dans votre gcode de d\u00e9marrage, apr\u00e8s la mise \u00e0 l'origine et apr\u00e8s tout type de mouvement qui se d\u00e9place pr\u00e8s du bord de la zone d'impression, comme une purge ou un essuyage de buse. Vous pouvez utiliser les gcodes SET_SKEW ou SKEW_PROFILE pour le faire. Il est \u00e9galement recommand\u00e9 d'\u00e9mettre un SET_SKEW CLEAR=1 dans votre gcode final. Gardez \u00e0 l'esprit qu'il est possible que [skew_correction] g\u00e9n\u00e8re une correction qui d\u00e9place l'outil au-del\u00e0 des limites de l'imprimante sur les axes X et/ou Y. Il est recommand\u00e9 d'\u00e9loigner les pi\u00e8ces des bords lors de l'utilisation de [skew_correction] .","title":"Correction de l'\u00e9querrage"},{"location":"Skew_Correction.html#correction-de-lequerrage","text":"La correction logicielle de l'\u00e9querrage peut aider \u00e0 r\u00e9soudre les inexactitudes dimensionnelles r\u00e9sultant d'un assemblage d'imprimante qui n'est pas parfaitement d'\u00e9querre. Notez que si votre imprimante est consid\u00e9rablement asym\u00e9trique, il est fortement recommand\u00e9 d'utiliser d'abord des moyens m\u00e9caniques pour obtenir une imprimante le plus d'\u00e9querre possible avant d'appliquer la correction bas\u00e9e sur le logiciel.","title":"Correction de l'\u00e9querrage"},{"location":"Skew_Correction.html#impression-dun-objet-de-calibrage","text":"La premi\u00e8re \u00e9tape de la correction de l'\u00e9querrage consiste \u00e0 imprimer un objet d'\u00e9talonnage le long du plan que vous souhaitez corriger. Il existe \u00e9galement un objet d'\u00e9talonnage qui inclut tous les plans dans un seul mod\u00e8le. Veuillez \u00e0 orienter l'objet de sorte que le coin A soit vers l'origine du plan. Assurez-vous qu'aucune correction d'\u00e9querrage n'est appliqu\u00e9e pendant cette impression. Vous pouvez le faire en supprimant le module [skew_correction] du fichier printer.cfg ou en tapant un gcode SET_SKEW CLEAR=1 .","title":"Impression d'un objet de calibrage"},{"location":"Skew_Correction.html#prenez-vos-mesures","text":"Le module [skew_correcton] n\u00e9cessite 3 mesures pour chaque plan que vous souhaitez corriger ; la longueur du coin A au coin C, la longueur du coin B au coin D et la longueur du coin A au coin D. Lors de la mesure de la longueur AD, n'incluez pas les plats sur les coins fournis par certains objets de test.","title":"Prenez vos mesures"},{"location":"Skew_Correction.html#configurez-votre-equerrage","text":"Assurez-vous que [skew_correction] est bien dans le fichier printer.cfg. Vous pouvez maintenant utiliser le gcode SET_SKEW pour configurer skew_correcton. Par exemple, si vos longueurs mesur\u00e9es le long de XY sont les suivantes : Length AC = 140.4 Length BD = 142.8 Length AD = 99.8 SET_SKEW peut \u00eatre utilis\u00e9 pour configurer la correction d'\u00e9querrage pour le plan XY. SET_SKEW XY=140.4,142.8,99.8 Vous pouvez \u00e9galement ajouter des mesures pour XZ et YZ au gcode : SET_SKEW XY=140.4,142.8,99.8 XZ=141.6,141.4,99.8 YZ=142.4,140.5,99.5 Le module [skew_correction] prend \u00e9galement en charge la gestion des profils d'une mani\u00e8re similaire \u00e0 [bed_mesh] . Apr\u00e8s avoir d\u00e9fini la correction d'\u00e9querrage \u00e0 l'aide du gcode SET_SKEW , vous pouvez utiliser le gcode SKEW_PROFILE pour l'enregistrer : SKEW_PROFILE SAVE=my_skew_profile Apr\u00e8s cette commande, vous serez invit\u00e9 \u00e0 saisir un SAVE_CONFIG pour enregistrer le profil de mani\u00e8re permanente. Si aucun profil n'est nomm\u00e9 my_skew_profile alors un nouveau profil sera cr\u00e9\u00e9. Si le profil nomm\u00e9 existe, il sera \u00e9cras\u00e9. Une fois que vous avez un profil enregistr\u00e9, vous pouvez le charger : SKEW_PROFILE LOAD=my_skew_profile Il est \u00e9galement possible de supprimer un profil ancien ou obsol\u00e8te : SKEW_PROFILE REMOVE=my_skew_profile Apr\u00e8s avoir supprim\u00e9 un profil, vous serez invit\u00e9 \u00e0 saisir un SAVE_CONFIG pour que cette suppression soit sauvegard\u00e9e.","title":"Configurez votre \u00e9querrage"},{"location":"Skew_Correction.html#verification-de-votre-correction","text":"Une fois que skew_correction a \u00e9t\u00e9 configur\u00e9, vous pouvez r\u00e9imprimer l'objet de calibrage avec la correction activ\u00e9e. Utilisez le g-code suivant pour v\u00e9rifier votre \u00e9querrage sur chaque plan. Les r\u00e9sultats devraient \u00eatre inf\u00e9rieurs \u00e0 ceux rapport\u00e9s via GET_CURRENT_SKEW . CALC_MEASURED_SKEW AC=<ac_length> BD=<bd_length> AD=<ad_length>","title":"V\u00e9rification de votre correction"},{"location":"Skew_Correction.html#avertissements","text":"En raison de la nature de la correction de l'\u00e9querrage, il est recommand\u00e9 de configurer la correction dans votre gcode de d\u00e9marrage, apr\u00e8s la mise \u00e0 l'origine et apr\u00e8s tout type de mouvement qui se d\u00e9place pr\u00e8s du bord de la zone d'impression, comme une purge ou un essuyage de buse. Vous pouvez utiliser les gcodes SET_SKEW ou SKEW_PROFILE pour le faire. Il est \u00e9galement recommand\u00e9 d'\u00e9mettre un SET_SKEW CLEAR=1 dans votre gcode final. Gardez \u00e0 l'esprit qu'il est possible que [skew_correction] g\u00e9n\u00e8re une correction qui d\u00e9place l'outil au-del\u00e0 des limites de l'imprimante sur les axes X et/ou Y. Il est recommand\u00e9 d'\u00e9loigner les pi\u00e8ces des bords lors de l'utilisation de [skew_correction] .","title":"Avertissements"},{"location":"Slicers.html","text":"Slicers \u00b6 Ce document fournit certains conseils concernant la configuration d'une application \"Slicer\" pour une utilisation avec Klipper. Des slicers les plus courants utilis\u00e9s avec Klipper sont Sli3r, Cura, Simplify3D, etc. D\u00e9finissez le parfum g-code sur 'Marlin' \u00b6 De nombreux trancheurs ont une option pour configurer le \"Parfum G-Code\". La valeur par d\u00e9faut est souvent \"Marlin\" et cela fonctionne bien avec Klipper. La valeur \"Smoothieware\" fonctionne \u00e9galement bien avec Klipper. Les macros G-code de Klipper \u00b6 Les trancheurs permettent souvent de configurer les s\u00e9quences \"Start G-Code\" et \"End G-Code\". Il est souvent pratique de d\u00e9finir des macros personnalis\u00e9es dans le fichier de configuration de Klipper - telles que : [gcode_macro START_PRINT] et [gcode_macro END_PRINT] . Ensuite, on peut simplement indiquer START_PRINT et END_PRINT dans la configuration du slicer. La d\u00e9finition de ces actions dans la configuration de Klipper peut faciliter la modification des \u00e9tapes de d\u00e9but et de fin de l'imprimante, car les modifications ne n\u00e9cessitent pas de nouveau d\u00e9coupage. Voir sample-macros.cfg par exemple les macros START_PRINT et END_PRINT. Voir la r\u00e9f\u00e9rence de configuration pour plus de d\u00e9tails sur la d\u00e9finition de macros G-Code. Un r\u00e9glage de r\u00e9traction important peut n\u00e9cessiter un r\u00e9glage de Klipper \u00b6 La vitesse et l'acc\u00e9l\u00e9ration maximales des mouvements de r\u00e9traction sont contr\u00f4l\u00e9s dans Klipper par les param\u00e8tres de configuration max_extrude_only_velocity et max_extrude_only_accel . Ces param\u00e8tres ont une valeur par d\u00e9faut qui doit bien fonctionner sur de nombreuses imprimantes. Cependant, si l'on a configur\u00e9 une grande r\u00e9traction dans le trancheur (par exemple, 5 mm ou plus), on peut constater qu'ils limitent la vitesse de r\u00e9traction souhait\u00e9e. Si vous utilisez une grande distance r\u00e9traction, envisagez plut\u00f4t de r\u00e9gler le Pressure advance de Klipper. Dans la cas ou l'on trouve que la t\u00eate semble \"s'arr\u00eater\" pendant la r\u00e9traction et l'amor\u00e7age, d\u00e9finissez explicitement max_extrude_only_velocity et max_extrude_only_accel dans le fichier de configuration de Klipper. N'activez pas le mode \"roue libre\" \u00b6 Le mode \"roue libre\" est susceptible d'entra\u00eener des impressions de mauvaise qualit\u00e9 avec Klipper. Envisagez d'utiliser \u00e0 la place le pressure Advance de Klipper. Plus pr\u00e9cis\u00e9ment, si le slicer modifie consid\u00e9rablement le taux d'extrusion entre les mouvements, Klipper effectuera une d\u00e9c\u00e9l\u00e9ration et une acc\u00e9l\u00e9ration entre les mouvements. Cela risque d'aggraver les bavures, pas de les am\u00e9liorer. En revanche, il est possible (et souvent utile) d'utiliser le r\u00e9glage \u00ab r\u00e9tracter \u00bb, le r\u00e9glage \u00ab essuyer \u00bb et/ou le r\u00e9glage \u00ab essuyer lors de la r\u00e9tractation \u00bb d'un trancheur. Ne pas utiliser la \"distance de red\u00e9marrage suppl\u00e9mentaire\" sur Simplify3d \u00b6 Ce param\u00e8tre peut entra\u00eener de gros changements dans le taux d'extrusion, ce qui peut d\u00e9clencher la limite d'extrusion maximale de Klipper. Envisagez d'utiliser \u00e0 la place le pressure advance de Klipper (Pressure_Advance.md) ou le param\u00e8tre de r\u00e9tractation standard de Simplify3d. D\u00e9sactivez \"PreloadVE\" sur KISSlicer \u00b6 Si vous utilisez le trancheur KISSlicer, r\u00e9glez \"PreloadVE\" sur z\u00e9ro. Envisagez d'utiliser \u00e0 la place le Pressure Advance de Klipper. D\u00e9sactivez tous les param\u00e8tres de \"pression d'extrusion avanc\u00e9e\" \u00b6 Certains trancheurs pr\u00e9sentent une fonction de \"pression d'extrudeuse avanc\u00e9e\". Il est recommand\u00e9 de garder ces options d\u00e9sactiv\u00e9es lors de l'utilisation de Klipper car elles risquent d'entra\u00eener des impressions de mauvaise qualit\u00e9. Envisagez d'utiliser \u00e0 la place la Pressure Advance de Klipper. Ces param\u00e8tres de trancheur peuvent demander au micrologiciel d'apporter des modifications non contr\u00f4l\u00e9es au taux d'extrusion dans l'espoir que le micrologiciel se rapprochera de ces demandes et que l'imprimante obtiendra approximativement une pression d'extrudeuse souhaitable. Klipper, utilise des calculs cin\u00e9matiques et une synchronisation pr\u00e9cise. Lorsque Klipper re\u00e7oit l'ordre d'apporter des modifications importantes au taux d'extrusion, il planifiera les modifications correspondantes de la vitesse, de l'acc\u00e9l\u00e9ration et du mouvement de l'extrudeuse - ce qui n'est pas pr\u00e9vu par le trancheur. Le trancheur peut m\u00eame commander des taux d'extrusion excessifs au point de d\u00e9clencher la limite d'extrusion maximale de Klipper. En revanche, il est possible (et souvent utile) d'utiliser le r\u00e9glage \u00ab r\u00e9tracter \u00bb, le r\u00e9glage \u00ab essuyer \u00bb et/ou le r\u00e9glage \u00ab essuyer lors de la r\u00e9tractation \u00bb d'un trancheur.","title":"Slicers"},{"location":"Slicers.html#slicers","text":"Ce document fournit certains conseils concernant la configuration d'une application \"Slicer\" pour une utilisation avec Klipper. Des slicers les plus courants utilis\u00e9s avec Klipper sont Sli3r, Cura, Simplify3D, etc.","title":"Slicers"},{"location":"Slicers.html#definissez-le-parfum-g-code-sur-marlin","text":"De nombreux trancheurs ont une option pour configurer le \"Parfum G-Code\". La valeur par d\u00e9faut est souvent \"Marlin\" et cela fonctionne bien avec Klipper. La valeur \"Smoothieware\" fonctionne \u00e9galement bien avec Klipper.","title":"D\u00e9finissez le parfum g-code sur 'Marlin'"},{"location":"Slicers.html#les-macros-g-code-de-klipper","text":"Les trancheurs permettent souvent de configurer les s\u00e9quences \"Start G-Code\" et \"End G-Code\". Il est souvent pratique de d\u00e9finir des macros personnalis\u00e9es dans le fichier de configuration de Klipper - telles que : [gcode_macro START_PRINT] et [gcode_macro END_PRINT] . Ensuite, on peut simplement indiquer START_PRINT et END_PRINT dans la configuration du slicer. La d\u00e9finition de ces actions dans la configuration de Klipper peut faciliter la modification des \u00e9tapes de d\u00e9but et de fin de l'imprimante, car les modifications ne n\u00e9cessitent pas de nouveau d\u00e9coupage. Voir sample-macros.cfg par exemple les macros START_PRINT et END_PRINT. Voir la r\u00e9f\u00e9rence de configuration pour plus de d\u00e9tails sur la d\u00e9finition de macros G-Code.","title":"Les macros G-code de Klipper"},{"location":"Slicers.html#un-reglage-de-retraction-important-peut-necessiter-un-reglage-de-klipper","text":"La vitesse et l'acc\u00e9l\u00e9ration maximales des mouvements de r\u00e9traction sont contr\u00f4l\u00e9s dans Klipper par les param\u00e8tres de configuration max_extrude_only_velocity et max_extrude_only_accel . Ces param\u00e8tres ont une valeur par d\u00e9faut qui doit bien fonctionner sur de nombreuses imprimantes. Cependant, si l'on a configur\u00e9 une grande r\u00e9traction dans le trancheur (par exemple, 5 mm ou plus), on peut constater qu'ils limitent la vitesse de r\u00e9traction souhait\u00e9e. Si vous utilisez une grande distance r\u00e9traction, envisagez plut\u00f4t de r\u00e9gler le Pressure advance de Klipper. Dans la cas ou l'on trouve que la t\u00eate semble \"s'arr\u00eater\" pendant la r\u00e9traction et l'amor\u00e7age, d\u00e9finissez explicitement max_extrude_only_velocity et max_extrude_only_accel dans le fichier de configuration de Klipper.","title":"Un r\u00e9glage de r\u00e9traction important peut n\u00e9cessiter un r\u00e9glage de Klipper"},{"location":"Slicers.html#nactivez-pas-le-mode-roue-libre","text":"Le mode \"roue libre\" est susceptible d'entra\u00eener des impressions de mauvaise qualit\u00e9 avec Klipper. Envisagez d'utiliser \u00e0 la place le pressure Advance de Klipper. Plus pr\u00e9cis\u00e9ment, si le slicer modifie consid\u00e9rablement le taux d'extrusion entre les mouvements, Klipper effectuera une d\u00e9c\u00e9l\u00e9ration et une acc\u00e9l\u00e9ration entre les mouvements. Cela risque d'aggraver les bavures, pas de les am\u00e9liorer. En revanche, il est possible (et souvent utile) d'utiliser le r\u00e9glage \u00ab r\u00e9tracter \u00bb, le r\u00e9glage \u00ab essuyer \u00bb et/ou le r\u00e9glage \u00ab essuyer lors de la r\u00e9tractation \u00bb d'un trancheur.","title":"N'activez pas le mode \"roue libre\""},{"location":"Slicers.html#ne-pas-utiliser-la-distance-de-redemarrage-supplementaire-sur-simplify3d","text":"Ce param\u00e8tre peut entra\u00eener de gros changements dans le taux d'extrusion, ce qui peut d\u00e9clencher la limite d'extrusion maximale de Klipper. Envisagez d'utiliser \u00e0 la place le pressure advance de Klipper (Pressure_Advance.md) ou le param\u00e8tre de r\u00e9tractation standard de Simplify3d.","title":"Ne pas utiliser la \"distance de red\u00e9marrage suppl\u00e9mentaire\" sur Simplify3d"},{"location":"Slicers.html#desactivez-preloadve-sur-kisslicer","text":"Si vous utilisez le trancheur KISSlicer, r\u00e9glez \"PreloadVE\" sur z\u00e9ro. Envisagez d'utiliser \u00e0 la place le Pressure Advance de Klipper.","title":"D\u00e9sactivez \"PreloadVE\" sur KISSlicer"},{"location":"Slicers.html#desactivez-tous-les-parametres-de-pression-dextrusion-avancee","text":"Certains trancheurs pr\u00e9sentent une fonction de \"pression d'extrudeuse avanc\u00e9e\". Il est recommand\u00e9 de garder ces options d\u00e9sactiv\u00e9es lors de l'utilisation de Klipper car elles risquent d'entra\u00eener des impressions de mauvaise qualit\u00e9. Envisagez d'utiliser \u00e0 la place la Pressure Advance de Klipper. Ces param\u00e8tres de trancheur peuvent demander au micrologiciel d'apporter des modifications non contr\u00f4l\u00e9es au taux d'extrusion dans l'espoir que le micrologiciel se rapprochera de ces demandes et que l'imprimante obtiendra approximativement une pression d'extrudeuse souhaitable. Klipper, utilise des calculs cin\u00e9matiques et une synchronisation pr\u00e9cise. Lorsque Klipper re\u00e7oit l'ordre d'apporter des modifications importantes au taux d'extrusion, il planifiera les modifications correspondantes de la vitesse, de l'acc\u00e9l\u00e9ration et du mouvement de l'extrudeuse - ce qui n'est pas pr\u00e9vu par le trancheur. Le trancheur peut m\u00eame commander des taux d'extrusion excessifs au point de d\u00e9clencher la limite d'extrusion maximale de Klipper. En revanche, il est possible (et souvent utile) d'utiliser le r\u00e9glage \u00ab r\u00e9tracter \u00bb, le r\u00e9glage \u00ab essuyer \u00bb et/ou le r\u00e9glage \u00ab essuyer lors de la r\u00e9tractation \u00bb d'un trancheur.","title":"D\u00e9sactivez tous les param\u00e8tres de \"pression d'extrusion avanc\u00e9e\""},{"location":"Sponsors.html","text":"Sponsors \u00b6 Klipper est un logiciel libre. Nous d\u00e9pendons du g\u00e9n\u00e9reux soutien des sponsors. Merci de sponsoriser Klipper ou de soutenir nos sponsors. BIGTREETECH \u00b6 [ BIGTREETECH est le sponsor officiel de cartes m\u00e8res pour Klipper. BIGTREETECH s\u2019engage \u00e0 d\u00e9velopper des produits innovants et comp\u00e9titifs pour mieux servir la communaut\u00e9 de l\u2019impression 3D. Suivez-les sur Facebook ou Twitter . D\u00e9veloppeurs Klipper \u00b6 Kevin O'Connor \u00b6 Kevin est l'auteur original et le mainteneur actuel de Klipper. Faites un don sur : https://ko-fi.com/koconnor ou https://www.patreon.com/koconnor Eric Callahan \u00b6 Eric est l'auteur de bed_mesh, spi_flash et de plusieurs autres modules Klipper. Eric a une page de dons sur : https://ko-fi.com/arksine Projets Klipper associ\u00e9s \u00b6 Klipper est fr\u00e9quemment utilis\u00e9 avec d'autres logiciels libres. Pensez \u00e0 utiliser ou \u00e0 soutenir ces projets. Moonraker Mainsail Fluidd OctoPrint KlipperScreen","title":"Sponsors"},{"location":"Sponsors.html#sponsors","text":"Klipper est un logiciel libre. Nous d\u00e9pendons du g\u00e9n\u00e9reux soutien des sponsors. Merci de sponsoriser Klipper ou de soutenir nos sponsors.","title":"Sponsors"},{"location":"Sponsors.html#bigtreetech","text":"[ BIGTREETECH est le sponsor officiel de cartes m\u00e8res pour Klipper. BIGTREETECH s\u2019engage \u00e0 d\u00e9velopper des produits innovants et comp\u00e9titifs pour mieux servir la communaut\u00e9 de l\u2019impression 3D. Suivez-les sur Facebook ou Twitter .","title":"BIGTREETECH"},{"location":"Sponsors.html#developpeurs-klipper","text":"","title":"D\u00e9veloppeurs Klipper"},{"location":"Sponsors.html#kevin-oconnor","text":"Kevin est l'auteur original et le mainteneur actuel de Klipper. Faites un don sur : https://ko-fi.com/koconnor ou https://www.patreon.com/koconnor","title":"Kevin O'Connor"},{"location":"Sponsors.html#eric-callahan","text":"Eric est l'auteur de bed_mesh, spi_flash et de plusieurs autres modules Klipper. Eric a une page de dons sur : https://ko-fi.com/arksine","title":"Eric Callahan"},{"location":"Sponsors.html#projets-klipper-associes","text":"Klipper est fr\u00e9quemment utilis\u00e9 avec d'autres logiciels libres. Pensez \u00e0 utiliser ou \u00e0 soutenir ces projets. Moonraker Mainsail Fluidd OctoPrint KlipperScreen","title":"Projets Klipper associ\u00e9s"},{"location":"Status_Reference.html","text":"R\u00e9f\u00e9rence des \u00e9tats \u00b6 Ce document est une r\u00e9f\u00e9rence aux informations de status de l'imprimante dans Klipper macros , display fields , et via l' API Server . Les champs de ce document sont susceptibles d'\u00eatre modifi\u00e9s - si vous utilisez un attribut, veillez \u00e0 consulter le document Modifications des configurations lors de la mise \u00e0 jour du logiciel Klipper. angle \u00b6 Les informations suivantes sont disponibles dans les objets angle votre_nom : temperature : la derni\u00e8re lecture de temp\u00e9rature (en degr\u00e9s Celsius) d'un capteur \u00e0 effet Hall magn\u00e9tique de type tle5012b. Cette valeur n'est disponible que si le capteur d'angle est une puce tle5012b et si des mesures sont en cours (sinon il signale None ). bed_mesh \u00b6 Les informations suivantes sont disponibles dans l'objet cartographie du lit : profile_name , mesh_min , mesh_max , probed_matrix , mesh_matrix : informations sur la cartographie du lit actuellement active. profiles : l'ensemble des profils actuellement d\u00e9finis tels que configur\u00e9s \u00e0 l'aide de BED_MESH_PROFILE. bed_screws \u00b6 Les informations suivantes sont disponibles dans l'objet Config_Reference.md#bed_screws : is_active : Renvoie True si le script de r\u00e9glage des vis du lit est en cours. state : L'\u00e9tat du script de r\u00e9glage des vis du lit. deux \u00e9taIl s'agit de l'une des cha\u00eenes suivantes : \"adjust\", \"fine\". current_screw : le num\u00e9ro de la vis en cours de r\u00e9glage. accepted_screws : nombre de vis qui ont \u00e9t\u00e9 accept\u00e9es (ndt donc marqu\u00e9es comme r\u00e9gl\u00e9es). fichier de configuration \u00b6 Les informations suivantes sont disponibles dans l'objet configfile (cet objet est toujours disponible) : settings.<section>.<option> : Renvoie les param\u00e9trages du fichier de configuration (ou la valeur par d\u00e9faut) lors du dernier d\u00e9marrage ou red\u00e9marrage du logiciel. (Tout param\u00e8tre modifi\u00e9 au moment de l'ex\u00e9cution ne sera pas refl\u00e9t\u00e9 ici.) config.<section>.<option> : Renvoie le param\u00e8tre donn\u00e9 du fichier de configuration tel que lu par Klipper lors du dernier d\u00e9marrage ou red\u00e9marrage du logiciel. (Tout param\u00e8tre modifi\u00e9 au moment de l'ex\u00e9cution ne sera pas refl\u00e9t\u00e9 ici.) Toutes les valeurs sont renvoy\u00e9es sous forme de cha\u00eenes. save_config_pending : renvoie vrai s'il existe des mises \u00e0 jour en attente qu'une commande SAVE_CONFIG peut enregistrer sur le disque. save_config_pending_items : Contient les sections et les \u00e9l\u00e9ments qui ont \u00e9t\u00e9 modifi\u00e9es et qui peuvent \u00eatre sauvegard\u00e9es avec un SAVE_CONFIG . warnings : une liste d'avertissements concernant les options de configuration. Chaque entr\u00e9e de la liste sera un dictionnaire contenant un champ type et message (les deux cha\u00eenes). Des champs suppl\u00e9mentaires peuvent \u00eatre disponibles selon le type d'avertissement. display_status \u00b6 Les informations suivantes sont disponibles dans l\u2019objet display_status (cet objet est automatiquement disponible si une section de configuration affichage est d\u00e9finie) : progress : la valeur de progression de la derni\u00e8re commande G-Code M73 (ou virtual_sdcard.progress si aucune commande M73 r\u00e9cente n'a \u00e9t\u00e9 re\u00e7ue). message : Le message contenu dans la derni\u00e8re commande G-Code M117 . endstop_phase \u00b6 Les informations suivantes sont disponibles dans l'objet endstop_phase : last_home.<stepper name>.phase : La phase du moteur pas \u00e0 pas \u00e0 la fin de la derni\u00e8re tentative de retour \u00e0 l'origine. last_home.<stepper name>.phases : Le nombre total de phases disponibles sur le moteur pas \u00e0 pas. last_home.<stepper name>.mcu_position : La position (telle que suivie par le microcontr\u00f4leur) du moteur pas \u00e0 pas \u00e0 la fin de la derni\u00e8re tentative de retour \u00e0 l'origine. La position est le nombre total de pas effectu\u00e9s dans le sens avant moins le nombre total de pas effectu\u00e9s dans le sens inverse depuis le dernier red\u00e9marrage du microcontr\u00f4leur. exclude_object \u00b6 Les informations suivantes sont disponibles dans l'objet exclude_object : objects : Un tableau des objets connus tel que fourni par la commande EXCLUDE_OBJECT_DEFINE . Il s'agit des m\u00eames informations fournies par la commande EXCLUDE_OBJECT VERBOSE=1 . Les champs center et polygon ne seront pr\u00e9sents que s'ils sont fournis dans l'original EXCLUDE_OBJECT_DEFINE Voici un exemple JSON : [ { \"polygon\": [ [ 156.25, 146.2511675 ], [ 156.25, 153.7488325 ], [ 163.75, 153.7488325 ], [ 163.75, 146.2511675 ] ], \"name\": \"CYLINDER_2_STL_ID_2_COPY_0\", \"center\": [ 160, 150 ] }, { \"polygon\": [ [ 146.25, 146.2511675 ], [ 146.25, 153.7488325 ], [ 153.75, 153.7488325 ], [ 153.75, 146.2511675 ] ], \"name\": \"CYLINDER_2_STL_ID_1_COPY_0\", \"center\": [ 150, 150 ] } ] excluded_objects : un tableau de cha\u00eenes r\u00e9pertoriant les noms des objets exclus. current_object : Le nom de l'objet en cours d'impression. extruder_stepper \u00b6 Les informations suivantes sont disponibles pour les objets extruder_stepper (ainsi que les objets extruder ) : pressure_advance : la valeur actuelle de pressure advance . smooth_time : Le temps de lissage associ\u00e9 \u00e0 la valeur de \"pressure advance\" courante. ventilateur \u00b6 Les informations suivantes sont disponibles dans les objets fan , heater_fan nom_du_ventilateur et controller_fan nom_du_ventilateur : speed : La vitesse du ventilateur nombre r\u00e9el entre 0,0 et 1,0. rpm : La vitesse du ventilateur mesur\u00e9e en rotations par minute si le ventilateur a un tachometer_pin d\u00e9fini (ndt : et si le ventilateur poss\u00e8de un tachym\u00e8tre). filament_switch_sensor \u00b6 Les informations suivantes sont disponibles dans les objets filament_switch_sensor nom_du_d\u00e9tecteur : enabled : renvoie True si le d\u00e9tecteur de fin de filament est activ\u00e9. filament_detected : renvoie True si le d\u00e9tecteur de fin de filament a d\u00e9tect\u00e9 la pr\u00e9sence d'un filament. filament_motion_sensor \u00b6 Les informations suivantes sont disponibles dans les objets filament_motion_sensor nom_du_detecteur : enabled : renvoie True si le d\u00e9tecteur de mouvement du filament est activ\u00e9. filament_detected : renvoie True si le d\u00e9tecteur de fin de filament a d\u00e9tect\u00e9 la pr\u00e9sence d'un filament. firmware_retraction \u00b6 Les informations suivantes sont disponibles dans l'objet firmware_retraction : retract_length , retract_speed , unretract_extra_length , unretract_speed : sont les param\u00e8tres du module firmware_retraction. Ces param\u00e8tres peuvent diff\u00e9rer du fichier de configuration si une commande SET_RETRACTION les modifie. gcode_macro \u00b6 Les informations suivantes sont disponibles dans les objets gcode_macro nom_de_la_macro : <variable> : la valeur actuelle d'une variable gcode_macro . gcode_move \u00b6 Les informations suivantes sont disponibles dans l'objet gcode_move (cet objet est toujours disponible) : gcode_position : La position actuelle de la t\u00eate d'outil par rapport \u00e0 l'origine actuelle du G-Code. C'est-\u00e0-dire des positions que l'on pourrait envoyer directement \u00e0 une commande G1 . Il est possible d'acc\u00e9der aux composants x, y, z et e de cette position (par exemple, gcode_position.x ). position : la derni\u00e8re position command\u00e9e de la t\u00eate d'outil \u00e0 l'aide du syst\u00e8me de coordonn\u00e9es sp\u00e9cifi\u00e9 dans le fichier de configuration. Il est possible d'acc\u00e9der aux composantes x, y, z et e de cette position (par exemple, position.x ). homing_origin : L'origine du syst\u00e8me de coordonn\u00e9es gcode (par rapport au syst\u00e8me de coordonn\u00e9es sp\u00e9cifi\u00e9 dans le fichier de configuration) \u00e0 utiliser apr\u00e8s une commande G28 . La commande SET_GCODE_OFFSET peut modifier cette position. Il est possible d'acc\u00e9der aux composantes x, y et z de cette position (par exemple, homing_origin.x ). vitesse : La derni\u00e8re vitesse d\u00e9finie dans une commande G1 (en mm/s). speed_factor : Le \u00ab remplacement du facteur de vitesse \u00bb tel que d\u00e9fini par une commande M220 . Il s'agit d'une valeur \u00e0 virgule flottante. 1,0 signifie qu'il n'y a pas de d\u00e9passement et, par exemple, 2,0 double la vitesse demand\u00e9e. extrude_factor : le \"remplacement du facteur d'extrusion\" tel que d\u00e9fini par une commande M221 . Il s'agit d'une valeur \u00e0 virgule flottante. 1,0 signifie qu'il n'y a pas de remplacement et, par exemple, 2,0 double le volume d'extrusion demand\u00e9. absolute_coordinates : Cela renvoie True si l'on est en mode de coordonn\u00e9es absolues G90 ou False si l'on est en mode relatif G91 . absolute_extrude : Ceci renvoie True si l'on est en mode d'extrusion absolue M82 ou False si l'on est en mode relatif M83 . hall_filament_width_sensor \u00b6 Les informations suivantes sont disponibles dans l'objet hall_filament_width_sensor : is_active : renvoie True si le capteur est actif. Diameter : La derni\u00e8re lecture du capteur en mm. Raw : La derni\u00e8re lecture brute du convertisseur AN du capteur. heater \u00b6 Les informations suivantes sont disponibles pour les objets de type 'chauffage' tels que extruder , heater_bed et heater_generic : temperature : la derni\u00e8re temp\u00e9rature indiqu\u00e9e (en degr\u00e9s Celsius sous forme de nombre r\u00e9el) pour l'\u00e9l\u00e9ment chauffant donn\u00e9. target : la temp\u00e9rature cible actuelle (en degr\u00e9s Celsius sous forme de nombre r\u00e9el) pour l'\u00e9l\u00e9ment chauffant donn\u00e9. power : le dernier r\u00e9glage de la broche PWM (une valeur comprise entre 0,0 et 1,0) associ\u00e9e \u00e0 l'\u00e9l\u00e9ment chauffant. can_extrude : si l'extrudeuse est \u00e0 la temp\u00e9rature minimum de fonctionnement (d\u00e9fini par min_extrude_temp ), disponible uniquement pour extruder heaters \u00b6 Les informations suivantes sont disponibles dans l'objet heaters (cet objet est disponible si un \u00e9l\u00e9ment chauffant est d\u00e9fini) : available_heaters : renvoie une liste de tous les \u00e9l\u00e9ments chauffants disponibles par leurs noms de section de configuration complets, par ex. [\"extruder\", \"heater_bed\", \"heater_generic my_custom_heater\"] . available_sensors : renvoie une liste de tous les capteurs de temp\u00e9rature actuellement disponibles par leurs noms de section de configuration complets, par ex. [\"extruder\", \"heater_bed\", \"heater_generic my_custom_heater\", \"temperature_sensor electronics_temp\"] . idle_timeout \u00b6 Les informations suivantes sont disponibles dans l'objet idle_timeout (cet objet est toujours disponible) : state : L'\u00e9tat actuel de l'imprimante tel qu'il est suivi par le module idle_timeout. Il s'agit de l'une des cha\u00eenes suivantes : \"Idle\", \"Printing\", \"Ready\". printing_time : la dur\u00e9e (en secondes) pendant laquelle l'imprimante est rest\u00e9e dans l'\u00e9tat \"Impression\" (telle que suivie par le module idle_timeout). led \u00b6 Les informations suivantes sont disponibles pour chaque sections [led nom_des_leds] , [neopixel nom_des_leds] , [dotstar nom_des_leds] , [pca9533 nom_des_leds] et [pca9632 nom_des_leds] d\u00e9finies dans printer.cfg : color_data : une liste de listes de couleurs contenant les valeurs RGBW pour une led de la cha\u00eene. Chaque valeur est repr\u00e9sent\u00e9e par un r\u00e9el de 0,0 \u00e0 1,0. Chaque liste de couleurs contient 4 \u00e9l\u00e9ments (rouge, vert, bleu, blanc) m\u00eame si la LED sous-jacente prend en charge moins de canaux de couleur. Par exemple, la valeur bleue (3e \u00e9l\u00e9ment de la liste des couleurs) du deuxi\u00e8me neopixel d'une cha\u00eene peut \u00eatre consult\u00e9e sur printer[\"neopixel <config_name>\"].color_data[1][2] . manual_probe \u00b6 Les informations suivantes sont disponibles dans l'objet manual_probe : is_active : renvoie True si un script d'assistance de sondage manuel est actuellement actif. z_position : La hauteur actuelle de la buse (telle que l'imprimante la situe). z_position_lower : Valeur de la derni\u00e8re tentative de d\u00e9tection mesur\u00e9e juste en dessous de la hauteur actuelle. z_position_upper : Valeur de la derni\u00e8re tentative de d\u00e9tection mesur\u00e9e juste au dessus de la hauteur actuelle. mcu \u00b6 Les informations suivantes sont disponibles dans les objets mcu et mcu nom_du_mcu : mcu_version : la version du code Klipper remont\u00e9e par le microcontr\u00f4leur. mcu_build_versions : informations sur les outils de construction utilis\u00e9s pour g\u00e9n\u00e9rer le code du microcontr\u00f4leur (tel que remont\u00e9 par le microcontr\u00f4leur). mcu_constants.<constant_name> : Compile les constantes de temps rapport\u00e9es par le microcontr\u00f4leur. Les constantes disponibles peuvent diff\u00e9rer entre les architectures de microcontr\u00f4leur et \u00e0 chaque r\u00e9vision de code. last_stats.<statistics_name> : informations statistiques sur la connexion du microcontr\u00f4leur. motion_report \u00b6 Les informations suivantes sont disponibles dans l'objet motion_report (cet objet est automatiquement disponible si une section de configuration 'stepper' est d\u00e9finie) : live_position : la position de la t\u00eate d'outil demand\u00e9e interpol\u00e9e \u00e0 l'instant T. live_velocity : la vitesse de la t\u00eate d'outil demand\u00e9e (en mm/s) \u00e0 l'instant T. live_extruder_velocity : la vitesse d'extrusion demand\u00e9e (en mm/s) \u00e0 l'instant T. output_pin \u00b6 Les informations suivantes sont disponibles dans les objets output_pin nom_de_la_sortie : value : la \"valeur\" de la broche, telle que d\u00e9finie par une commande SET_PIN . palette2 \u00b6 Les informations suivantes sont disponibles dans l'objet palette2 : ping : montant du dernier ping du \"Palette 2\" signal\u00e9 en pourcentage. remaining_load_length : lors du d\u00e9marrage d'une impression Palette 2, ce sera la quantit\u00e9 de filament \u00e0 charger dans l'extrudeuse. is_splicing : Vrai lorsque la Palette 2 soude le filament. pause_resume \u00b6 Les informations suivantes sont disponibles dans l'objet pause_resume : is_paused : Renvoie true si une commande PAUSE a \u00e9t\u00e9 ex\u00e9cut\u00e9e sans RESUME correspondant. print_stats \u00b6 Les informations suivantes sont disponibles dans l'objet print_stats (cet objet est automatiquement disponible si une section de configuration virtual_sdcard est d\u00e9finie) : filename , total_duration , print_duration , filament_used , state , message : informations estim\u00e9es sur l'impression en cours lorsqu'une impression virtual_sdcard est active. info.total_layer : La valeur totale de la couche de la derni\u00e8re commande SET_PRINT_STATS_INFO TOTAL_LAYER=<value> G-Code. info.current_layer : la valeur de la couche actuelle de la derni\u00e8re commande G-Code SET_PRINT_STATS_INFO CURRENT_LAYER=<valeur> . probe \u00b6 Les informations suivantes sont disponibles dans l'objet probe (cet objet est \u00e9galement disponible si une section de configuration bltouch est d\u00e9finie) : last_query : renvoie True si la sonde a \u00e9t\u00e9 signal\u00e9e comme \"d\u00e9clench\u00e9e\" lors de la derni\u00e8re commande QUERY_PROBE. Notez que si cela est utilis\u00e9 dans une macro, en raison de l'ordre de d\u00e9veloppement du mod\u00e8le, la commande QUERY_PROBE doit \u00eatre ex\u00e9cut\u00e9e avant la macro contenant cette demande. last_z_result : Renvoie la valeur du Z de la derni\u00e8re commande PROBE. Notez que si cela est utilis\u00e9 dans une macro, en raison de l'ordre d'expansion du mod\u00e8le, la commande PROBE (ou similaire) doit \u00eatre ex\u00e9cut\u00e9e avant la macro contenant cette demande. quad_gantry_level \u00b6 Les informations suivantes sont disponibles dans l'objet quad_gantry_level (cet objet est disponible si quad_gantry_level est d\u00e9fini) : applied : Vrai si le processus de nivellement 4 points du portique a \u00e9t\u00e9 ex\u00e9cut\u00e9 et termin\u00e9 avec succ\u00e8s. query_endstops \u00b6 Les informations suivantes sont disponibles dans l'objet query_endstops (cet objet est disponible si au moins une fin de course est d\u00e9finie) : last_query[\"<endstop>\"] : renvoie True si l'endstop donn\u00e9 a \u00e9t\u00e9 signal\u00e9 comme \"d\u00e9clench\u00e9\" (triggered) lors de la derni\u00e8re commande QUERY_ENDSTOP. Notez que si cela est utilis\u00e9 dans une macro, en raison de l'ordre de d\u00e9veloppement du mod\u00e8le, la commande QUERY_ENDSTOP doit \u00eatre ex\u00e9cut\u00e9e avant la macro contenant cette demande. screws_tilt_adjust \u00b6 Les informations suivantes sont disponibles dans l'objet screws_tilt_adjust : error : renvoie True si la commande SCREWS_TILT_CALCULATE la plus r\u00e9cente incluait le param\u00e8tre MAX_DEVIATION et que l'un des sondages au niveau des vis de lit d\u00e9passait la valeur MAX_DEVIATION . r\u00e9sultats : une liste des emplacements des vis de lit sond\u00e9es. Chaque entr\u00e9e de la liste est un dictionnaire contenant les cl\u00e9s suivantes : name : le nom de la vis tel qu'il est sp\u00e9cifi\u00e9 dans le fichier de configuration. x : la coordonn\u00e9e X de la vis telle que sp\u00e9cifi\u00e9e dans le fichier de configuration. y : la coordonn\u00e9e Y de la vis telle que sp\u00e9cifi\u00e9e dans le fichier de configuration. z : La hauteur Z mesur\u00e9e \u00e0 l'emplacement de la vis. sign : Une cha\u00eene sp\u00e9cifiant le sens de rotation \u00e0 visser pour le r\u00e9glage n\u00e9cessaire. Soit \"CW\" pour le sens horaire ou \"CCW\" pour le sens antihoraire. La vis de base n'aura pas de cl\u00e9 sign . adjust : le nombre de tours de vis pour ajuster la vis, donn\u00e9 au format \"HH:MM\", o\u00f9 \"HH\" est le nombre de tours de vis complets et \"MM\" est le nombre de \"minutes d'un cadran d'horloge\" repr\u00e9sentant un tour de vis partiel. (Par exemple, \"01:15\" signifierait de tourner la vis d'un tour et quart.) servo \u00b6 Les informations suivantes sont disponibles dans les objets servo some_name : printer[\"servo <config_name>\"].value : le dernier r\u00e9glage de la broche PWM (une valeur comprise entre 0,0 et 1,0) associ\u00e9e au servo. system_stats \u00b6 Les informations suivantes sont disponibles dans l'objet system_stats (cet objet est toujours disponible) : sysload , cputime , memavail : informations sur le syst\u00e8me d'exploitation h\u00f4te et la charge du processus. Capteurs de temp\u00e9rature \u00b6 Les informations suivantes sont disponibles dans objets BME280 nom_du_capteur , htu21d nom_du_capteur , lm75 nom_du_capteur et temperature_host nom_du_capteur : temperature : La derni\u00e8re temp\u00e9rature lue par le capteur. humidit\u00e9 , pression , gaz : les derni\u00e8res valeurs lues par le capteur (uniquement sur les capteurs bme280, htu21d et lm75). temperature_fan \u00b6 Les informations suivantes sont disponibles dans les objets temperature_fan nom_du_ventilateur : temperature : La derni\u00e8re temp\u00e9rature lue par le capteur. target : La temp\u00e9rature cible pour le ventilateur. temperature_sensor \u00b6 Les informations suivantes sont disponibles dans les objets temperature_sensor nom_du_capteur : temperature : La derni\u00e8re temp\u00e9rature lue par le capteur. measured_min_temp , measured_max_temp : la temp\u00e9rature la plus basse et la plus \u00e9lev\u00e9e observ\u00e9es par le capteur depuis le dernier red\u00e9marrage de Klipper. Pilotes TMC \u00b6 Les informations suivantes sont disponibles dans les objets pilote pas \u00e0 pas TMC (par exemple, [tmc2208 stepper_x] ) : mcu_phase_offset : la position du moteur pas \u00e0 pas du microcontr\u00f4leur correspondant \u00e0 la phase \"z\u00e9ro\" du pilote. Ce champ peut \u00eatre nul si le d\u00e9phasage n'est pas connu. phase_offset_position : La \"position command\u00e9e\" correspondant \u00e0 la phase \"z\u00e9ro\" du driver. Ce champ peut \u00eatre nul si le d\u00e9phasage n'est pas connu. drv_status : les r\u00e9sultats de la derni\u00e8re requ\u00eate d'\u00e9tat du pilote. (Seuls les champs non nuls sont signal\u00e9s.) Ce champ sera nul si le pilote n'est pas activ\u00e9 (et n'est donc pas interrog\u00e9 p\u00e9riodiquement). run_current : le courant de fonctionnement actuellement d\u00e9fini. hold_current : Le courant de maintien actuellement d\u00e9fini. toolhead \u00b6 Les informations suivantes sont disponibles dans l'objet toolhead (cet objet est toujours disponible) : position : la derni\u00e8re position command\u00e9e de la t\u00eate d'outil par rapport au syst\u00e8me de coordonn\u00e9es sp\u00e9cifi\u00e9 dans le fichier de configuration. Il est possible d'acc\u00e9der aux composantes x, y, z et e de cette position (par exemple, position.x ). extruder : le nom de l'extrudeur actuellement actif. Par exemple, dans une macro, on pourrait utiliser printer[printer.toolhead.extruder].target pour obtenir la temp\u00e9rature cible de l'extrudeuse actuelle. homed_axes : les axes consid\u00e9r\u00e9s comme \u00e9tant dans un \u00e9tat \"\u00e0 l'origine\". Il s'agit d'une cha\u00eene contenant un ou plusieurs \"x\", \"y\", \"z\". axis_minimum , axis_maximum : les limites de d\u00e9placement de l'axe (mm) apr\u00e8s la mise \u00e0 l'origine. Il est possible d'acc\u00e9der aux composantes x, y, z de cette valeur limite (par exemple, axis_minimum.x , axis_maximum.z ). Pour les imprimantes Delta, le cone_start_z est la hauteur z maximale au rayon maximal ( printer.toolhead.cone_start_z ). max_velocity , max_accel , max_accel_to_decel , square_corner_velocity : les limites d'impression actuelles en vigueur. Cela peut diff\u00e9rer des param\u00e8tres du fichier de configuration si une commande SET_VELOCITY_LIMIT (ou M204 ) les a modifi\u00e9es au moment de l'ex\u00e9cution. stalls : Le nombre total de fois (depuis le dernier red\u00e9marrage) o\u00f9 l'imprimante a d\u00fb \u00eatre mise en pause parce que la t\u00eate d'outil s'est d\u00e9plac\u00e9e plus vite que les mouvements ne pouvaient \u00eatre lus \u00e0 partir de l'entr\u00e9e G-Code. dual_carriage \u00b6 Les informations suivantes sont disponibles dans dual_carriage sur une imprimante de type hybrid_corexy ou hybrid_corexz mode : Le mode actuel. Les valeurs possibles sont : \"FULL_CONTROL\" active_carriage : le chariot actif actuel. Les valeurs possibles sont : \"CARRIAGE_0\", \"CARRIAGE_1\" virtual_sdcard \u00b6 Les informations suivantes sont disponibles dans l'objet virtual_sdcard : is_active : renvoie True si une impression \u00e0 partir d'un fichier est actuellement active. progress : une estimation de la progression de l'impression actuelle (bas\u00e9e sur la taille et la position du fichier). file_path : un chemin d'acc\u00e8s complet au fichier actuellement charg\u00e9. file_position : la position actuelle (en octets) d'une impression active. file_size : taille (en octets) du fichier actuellement charg\u00e9. webhooks \u00b6 Les informations suivantes sont disponibles dans l'objet webhooks (cet objet est toujours disponible) : state : renvoie une cha\u00eene indiquant l'\u00e9tat actuel de Klipper. Les valeurs possibles sont : \"ready\", \"startup\", \"shutdown\", \"error\". state_message : une cha\u00eene donnant un contexte suppl\u00e9mentaire sur l'\u00e9tat actuel de Klipper. z_thermal_adjust \u00b6 Les informations suivantes sont disponibles dans l'objet z_thermal_adjust (cet objet est disponible si z_thermal_adjust est d\u00e9fini). enabled : renvoie True si le r\u00e9glage est activ\u00e9. temp\u00e9rature : Temp\u00e9rature actuelle (liss\u00e9e) du capteur d\u00e9fini. (en degr\u00e9s Centigrades) measured_min_temp : temp\u00e9rature minimale mesur\u00e9e. (en degr\u00e9s Centigrades) measured_max_temp : temp\u00e9rature maximale mesur\u00e9e. (En degr\u00e9s Centigrades) current_z_adjust : dernier ajustement Z calcul\u00e9 (en mm). z_adjust_ref_temperature : Temp\u00e9rature de r\u00e9f\u00e9rence actuelle utilis\u00e9e pour le calcul de Z current_z_adjust (En degr\u00e9s Centigrades). z_tilt \u00b6 Les informations suivantes sont disponibles dans l'objet z_tilt (cet objet est disponible si z_tilt est d\u00e9fini) : applied : Vrai si le processus de mise \u00e0 niveau z-tilt a \u00e9t\u00e9 ex\u00e9cut\u00e9 et termin\u00e9 avec succ\u00e8s.","title":"R\u00e9f\u00e9rence des \u00e9tats"},{"location":"Status_Reference.html#reference-des-etats","text":"Ce document est une r\u00e9f\u00e9rence aux informations de status de l'imprimante dans Klipper macros , display fields , et via l' API Server . Les champs de ce document sont susceptibles d'\u00eatre modifi\u00e9s - si vous utilisez un attribut, veillez \u00e0 consulter le document Modifications des configurations lors de la mise \u00e0 jour du logiciel Klipper.","title":"R\u00e9f\u00e9rence des \u00e9tats"},{"location":"Status_Reference.html#angle","text":"Les informations suivantes sont disponibles dans les objets angle votre_nom : temperature : la derni\u00e8re lecture de temp\u00e9rature (en degr\u00e9s Celsius) d'un capteur \u00e0 effet Hall magn\u00e9tique de type tle5012b. Cette valeur n'est disponible que si le capteur d'angle est une puce tle5012b et si des mesures sont en cours (sinon il signale None ).","title":"angle"},{"location":"Status_Reference.html#bed_mesh","text":"Les informations suivantes sont disponibles dans l'objet cartographie du lit : profile_name , mesh_min , mesh_max , probed_matrix , mesh_matrix : informations sur la cartographie du lit actuellement active. profiles : l'ensemble des profils actuellement d\u00e9finis tels que configur\u00e9s \u00e0 l'aide de BED_MESH_PROFILE.","title":"bed_mesh"},{"location":"Status_Reference.html#bed_screws","text":"Les informations suivantes sont disponibles dans l'objet Config_Reference.md#bed_screws : is_active : Renvoie True si le script de r\u00e9glage des vis du lit est en cours. state : L'\u00e9tat du script de r\u00e9glage des vis du lit. deux \u00e9taIl s'agit de l'une des cha\u00eenes suivantes : \"adjust\", \"fine\". current_screw : le num\u00e9ro de la vis en cours de r\u00e9glage. accepted_screws : nombre de vis qui ont \u00e9t\u00e9 accept\u00e9es (ndt donc marqu\u00e9es comme r\u00e9gl\u00e9es).","title":"bed_screws"},{"location":"Status_Reference.html#fichier-de-configuration","text":"Les informations suivantes sont disponibles dans l'objet configfile (cet objet est toujours disponible) : settings.<section>.<option> : Renvoie les param\u00e9trages du fichier de configuration (ou la valeur par d\u00e9faut) lors du dernier d\u00e9marrage ou red\u00e9marrage du logiciel. (Tout param\u00e8tre modifi\u00e9 au moment de l'ex\u00e9cution ne sera pas refl\u00e9t\u00e9 ici.) config.<section>.<option> : Renvoie le param\u00e8tre donn\u00e9 du fichier de configuration tel que lu par Klipper lors du dernier d\u00e9marrage ou red\u00e9marrage du logiciel. (Tout param\u00e8tre modifi\u00e9 au moment de l'ex\u00e9cution ne sera pas refl\u00e9t\u00e9 ici.) Toutes les valeurs sont renvoy\u00e9es sous forme de cha\u00eenes. save_config_pending : renvoie vrai s'il existe des mises \u00e0 jour en attente qu'une commande SAVE_CONFIG peut enregistrer sur le disque. save_config_pending_items : Contient les sections et les \u00e9l\u00e9ments qui ont \u00e9t\u00e9 modifi\u00e9es et qui peuvent \u00eatre sauvegard\u00e9es avec un SAVE_CONFIG . warnings : une liste d'avertissements concernant les options de configuration. Chaque entr\u00e9e de la liste sera un dictionnaire contenant un champ type et message (les deux cha\u00eenes). Des champs suppl\u00e9mentaires peuvent \u00eatre disponibles selon le type d'avertissement.","title":"fichier de configuration"},{"location":"Status_Reference.html#display_status","text":"Les informations suivantes sont disponibles dans l\u2019objet display_status (cet objet est automatiquement disponible si une section de configuration affichage est d\u00e9finie) : progress : la valeur de progression de la derni\u00e8re commande G-Code M73 (ou virtual_sdcard.progress si aucune commande M73 r\u00e9cente n'a \u00e9t\u00e9 re\u00e7ue). message : Le message contenu dans la derni\u00e8re commande G-Code M117 .","title":"display_status"},{"location":"Status_Reference.html#endstop_phase","text":"Les informations suivantes sont disponibles dans l'objet endstop_phase : last_home.<stepper name>.phase : La phase du moteur pas \u00e0 pas \u00e0 la fin de la derni\u00e8re tentative de retour \u00e0 l'origine. last_home.<stepper name>.phases : Le nombre total de phases disponibles sur le moteur pas \u00e0 pas. last_home.<stepper name>.mcu_position : La position (telle que suivie par le microcontr\u00f4leur) du moteur pas \u00e0 pas \u00e0 la fin de la derni\u00e8re tentative de retour \u00e0 l'origine. La position est le nombre total de pas effectu\u00e9s dans le sens avant moins le nombre total de pas effectu\u00e9s dans le sens inverse depuis le dernier red\u00e9marrage du microcontr\u00f4leur.","title":"endstop_phase"},{"location":"Status_Reference.html#exclude_object","text":"Les informations suivantes sont disponibles dans l'objet exclude_object : objects : Un tableau des objets connus tel que fourni par la commande EXCLUDE_OBJECT_DEFINE . Il s'agit des m\u00eames informations fournies par la commande EXCLUDE_OBJECT VERBOSE=1 . Les champs center et polygon ne seront pr\u00e9sents que s'ils sont fournis dans l'original EXCLUDE_OBJECT_DEFINE Voici un exemple JSON : [ { \"polygon\": [ [ 156.25, 146.2511675 ], [ 156.25, 153.7488325 ], [ 163.75, 153.7488325 ], [ 163.75, 146.2511675 ] ], \"name\": \"CYLINDER_2_STL_ID_2_COPY_0\", \"center\": [ 160, 150 ] }, { \"polygon\": [ [ 146.25, 146.2511675 ], [ 146.25, 153.7488325 ], [ 153.75, 153.7488325 ], [ 153.75, 146.2511675 ] ], \"name\": \"CYLINDER_2_STL_ID_1_COPY_0\", \"center\": [ 150, 150 ] } ] excluded_objects : un tableau de cha\u00eenes r\u00e9pertoriant les noms des objets exclus. current_object : Le nom de l'objet en cours d'impression.","title":"exclude_object"},{"location":"Status_Reference.html#extruder_stepper","text":"Les informations suivantes sont disponibles pour les objets extruder_stepper (ainsi que les objets extruder ) : pressure_advance : la valeur actuelle de pressure advance . smooth_time : Le temps de lissage associ\u00e9 \u00e0 la valeur de \"pressure advance\" courante.","title":"extruder_stepper"},{"location":"Status_Reference.html#ventilateur","text":"Les informations suivantes sont disponibles dans les objets fan , heater_fan nom_du_ventilateur et controller_fan nom_du_ventilateur : speed : La vitesse du ventilateur nombre r\u00e9el entre 0,0 et 1,0. rpm : La vitesse du ventilateur mesur\u00e9e en rotations par minute si le ventilateur a un tachometer_pin d\u00e9fini (ndt : et si le ventilateur poss\u00e8de un tachym\u00e8tre).","title":"ventilateur"},{"location":"Status_Reference.html#filament_switch_sensor","text":"Les informations suivantes sont disponibles dans les objets filament_switch_sensor nom_du_d\u00e9tecteur : enabled : renvoie True si le d\u00e9tecteur de fin de filament est activ\u00e9. filament_detected : renvoie True si le d\u00e9tecteur de fin de filament a d\u00e9tect\u00e9 la pr\u00e9sence d'un filament.","title":"filament_switch_sensor"},{"location":"Status_Reference.html#filament_motion_sensor","text":"Les informations suivantes sont disponibles dans les objets filament_motion_sensor nom_du_detecteur : enabled : renvoie True si le d\u00e9tecteur de mouvement du filament est activ\u00e9. filament_detected : renvoie True si le d\u00e9tecteur de fin de filament a d\u00e9tect\u00e9 la pr\u00e9sence d'un filament.","title":"filament_motion_sensor"},{"location":"Status_Reference.html#firmware_retraction","text":"Les informations suivantes sont disponibles dans l'objet firmware_retraction : retract_length , retract_speed , unretract_extra_length , unretract_speed : sont les param\u00e8tres du module firmware_retraction. Ces param\u00e8tres peuvent diff\u00e9rer du fichier de configuration si une commande SET_RETRACTION les modifie.","title":"firmware_retraction"},{"location":"Status_Reference.html#gcode_macro","text":"Les informations suivantes sont disponibles dans les objets gcode_macro nom_de_la_macro : <variable> : la valeur actuelle d'une variable gcode_macro .","title":"gcode_macro"},{"location":"Status_Reference.html#gcode_move","text":"Les informations suivantes sont disponibles dans l'objet gcode_move (cet objet est toujours disponible) : gcode_position : La position actuelle de la t\u00eate d'outil par rapport \u00e0 l'origine actuelle du G-Code. C'est-\u00e0-dire des positions que l'on pourrait envoyer directement \u00e0 une commande G1 . Il est possible d'acc\u00e9der aux composants x, y, z et e de cette position (par exemple, gcode_position.x ). position : la derni\u00e8re position command\u00e9e de la t\u00eate d'outil \u00e0 l'aide du syst\u00e8me de coordonn\u00e9es sp\u00e9cifi\u00e9 dans le fichier de configuration. Il est possible d'acc\u00e9der aux composantes x, y, z et e de cette position (par exemple, position.x ). homing_origin : L'origine du syst\u00e8me de coordonn\u00e9es gcode (par rapport au syst\u00e8me de coordonn\u00e9es sp\u00e9cifi\u00e9 dans le fichier de configuration) \u00e0 utiliser apr\u00e8s une commande G28 . La commande SET_GCODE_OFFSET peut modifier cette position. Il est possible d'acc\u00e9der aux composantes x, y et z de cette position (par exemple, homing_origin.x ). vitesse : La derni\u00e8re vitesse d\u00e9finie dans une commande G1 (en mm/s). speed_factor : Le \u00ab remplacement du facteur de vitesse \u00bb tel que d\u00e9fini par une commande M220 . Il s'agit d'une valeur \u00e0 virgule flottante. 1,0 signifie qu'il n'y a pas de d\u00e9passement et, par exemple, 2,0 double la vitesse demand\u00e9e. extrude_factor : le \"remplacement du facteur d'extrusion\" tel que d\u00e9fini par une commande M221 . Il s'agit d'une valeur \u00e0 virgule flottante. 1,0 signifie qu'il n'y a pas de remplacement et, par exemple, 2,0 double le volume d'extrusion demand\u00e9. absolute_coordinates : Cela renvoie True si l'on est en mode de coordonn\u00e9es absolues G90 ou False si l'on est en mode relatif G91 . absolute_extrude : Ceci renvoie True si l'on est en mode d'extrusion absolue M82 ou False si l'on est en mode relatif M83 .","title":"gcode_move"},{"location":"Status_Reference.html#hall_filament_width_sensor","text":"Les informations suivantes sont disponibles dans l'objet hall_filament_width_sensor : is_active : renvoie True si le capteur est actif. Diameter : La derni\u00e8re lecture du capteur en mm. Raw : La derni\u00e8re lecture brute du convertisseur AN du capteur.","title":"hall_filament_width_sensor"},{"location":"Status_Reference.html#heater","text":"Les informations suivantes sont disponibles pour les objets de type 'chauffage' tels que extruder , heater_bed et heater_generic : temperature : la derni\u00e8re temp\u00e9rature indiqu\u00e9e (en degr\u00e9s Celsius sous forme de nombre r\u00e9el) pour l'\u00e9l\u00e9ment chauffant donn\u00e9. target : la temp\u00e9rature cible actuelle (en degr\u00e9s Celsius sous forme de nombre r\u00e9el) pour l'\u00e9l\u00e9ment chauffant donn\u00e9. power : le dernier r\u00e9glage de la broche PWM (une valeur comprise entre 0,0 et 1,0) associ\u00e9e \u00e0 l'\u00e9l\u00e9ment chauffant. can_extrude : si l'extrudeuse est \u00e0 la temp\u00e9rature minimum de fonctionnement (d\u00e9fini par min_extrude_temp ), disponible uniquement pour extruder","title":"heater"},{"location":"Status_Reference.html#heaters","text":"Les informations suivantes sont disponibles dans l'objet heaters (cet objet est disponible si un \u00e9l\u00e9ment chauffant est d\u00e9fini) : available_heaters : renvoie une liste de tous les \u00e9l\u00e9ments chauffants disponibles par leurs noms de section de configuration complets, par ex. [\"extruder\", \"heater_bed\", \"heater_generic my_custom_heater\"] . available_sensors : renvoie une liste de tous les capteurs de temp\u00e9rature actuellement disponibles par leurs noms de section de configuration complets, par ex. [\"extruder\", \"heater_bed\", \"heater_generic my_custom_heater\", \"temperature_sensor electronics_temp\"] .","title":"heaters"},{"location":"Status_Reference.html#idle_timeout","text":"Les informations suivantes sont disponibles dans l'objet idle_timeout (cet objet est toujours disponible) : state : L'\u00e9tat actuel de l'imprimante tel qu'il est suivi par le module idle_timeout. Il s'agit de l'une des cha\u00eenes suivantes : \"Idle\", \"Printing\", \"Ready\". printing_time : la dur\u00e9e (en secondes) pendant laquelle l'imprimante est rest\u00e9e dans l'\u00e9tat \"Impression\" (telle que suivie par le module idle_timeout).","title":"idle_timeout"},{"location":"Status_Reference.html#led","text":"Les informations suivantes sont disponibles pour chaque sections [led nom_des_leds] , [neopixel nom_des_leds] , [dotstar nom_des_leds] , [pca9533 nom_des_leds] et [pca9632 nom_des_leds] d\u00e9finies dans printer.cfg : color_data : une liste de listes de couleurs contenant les valeurs RGBW pour une led de la cha\u00eene. Chaque valeur est repr\u00e9sent\u00e9e par un r\u00e9el de 0,0 \u00e0 1,0. Chaque liste de couleurs contient 4 \u00e9l\u00e9ments (rouge, vert, bleu, blanc) m\u00eame si la LED sous-jacente prend en charge moins de canaux de couleur. Par exemple, la valeur bleue (3e \u00e9l\u00e9ment de la liste des couleurs) du deuxi\u00e8me neopixel d'une cha\u00eene peut \u00eatre consult\u00e9e sur printer[\"neopixel <config_name>\"].color_data[1][2] .","title":"led"},{"location":"Status_Reference.html#manual_probe","text":"Les informations suivantes sont disponibles dans l'objet manual_probe : is_active : renvoie True si un script d'assistance de sondage manuel est actuellement actif. z_position : La hauteur actuelle de la buse (telle que l'imprimante la situe). z_position_lower : Valeur de la derni\u00e8re tentative de d\u00e9tection mesur\u00e9e juste en dessous de la hauteur actuelle. z_position_upper : Valeur de la derni\u00e8re tentative de d\u00e9tection mesur\u00e9e juste au dessus de la hauteur actuelle.","title":"manual_probe"},{"location":"Status_Reference.html#mcu","text":"Les informations suivantes sont disponibles dans les objets mcu et mcu nom_du_mcu : mcu_version : la version du code Klipper remont\u00e9e par le microcontr\u00f4leur. mcu_build_versions : informations sur les outils de construction utilis\u00e9s pour g\u00e9n\u00e9rer le code du microcontr\u00f4leur (tel que remont\u00e9 par le microcontr\u00f4leur). mcu_constants.<constant_name> : Compile les constantes de temps rapport\u00e9es par le microcontr\u00f4leur. Les constantes disponibles peuvent diff\u00e9rer entre les architectures de microcontr\u00f4leur et \u00e0 chaque r\u00e9vision de code. last_stats.<statistics_name> : informations statistiques sur la connexion du microcontr\u00f4leur.","title":"mcu"},{"location":"Status_Reference.html#motion_report","text":"Les informations suivantes sont disponibles dans l'objet motion_report (cet objet est automatiquement disponible si une section de configuration 'stepper' est d\u00e9finie) : live_position : la position de la t\u00eate d'outil demand\u00e9e interpol\u00e9e \u00e0 l'instant T. live_velocity : la vitesse de la t\u00eate d'outil demand\u00e9e (en mm/s) \u00e0 l'instant T. live_extruder_velocity : la vitesse d'extrusion demand\u00e9e (en mm/s) \u00e0 l'instant T.","title":"motion_report"},{"location":"Status_Reference.html#output_pin","text":"Les informations suivantes sont disponibles dans les objets output_pin nom_de_la_sortie : value : la \"valeur\" de la broche, telle que d\u00e9finie par une commande SET_PIN .","title":"output_pin"},{"location":"Status_Reference.html#palette2","text":"Les informations suivantes sont disponibles dans l'objet palette2 : ping : montant du dernier ping du \"Palette 2\" signal\u00e9 en pourcentage. remaining_load_length : lors du d\u00e9marrage d'une impression Palette 2, ce sera la quantit\u00e9 de filament \u00e0 charger dans l'extrudeuse. is_splicing : Vrai lorsque la Palette 2 soude le filament.","title":"palette2"},{"location":"Status_Reference.html#pause_resume","text":"Les informations suivantes sont disponibles dans l'objet pause_resume : is_paused : Renvoie true si une commande PAUSE a \u00e9t\u00e9 ex\u00e9cut\u00e9e sans RESUME correspondant.","title":"pause_resume"},{"location":"Status_Reference.html#print_stats","text":"Les informations suivantes sont disponibles dans l'objet print_stats (cet objet est automatiquement disponible si une section de configuration virtual_sdcard est d\u00e9finie) : filename , total_duration , print_duration , filament_used , state , message : informations estim\u00e9es sur l'impression en cours lorsqu'une impression virtual_sdcard est active. info.total_layer : La valeur totale de la couche de la derni\u00e8re commande SET_PRINT_STATS_INFO TOTAL_LAYER=<value> G-Code. info.current_layer : la valeur de la couche actuelle de la derni\u00e8re commande G-Code SET_PRINT_STATS_INFO CURRENT_LAYER=<valeur> .","title":"print_stats"},{"location":"Status_Reference.html#probe","text":"Les informations suivantes sont disponibles dans l'objet probe (cet objet est \u00e9galement disponible si une section de configuration bltouch est d\u00e9finie) : last_query : renvoie True si la sonde a \u00e9t\u00e9 signal\u00e9e comme \"d\u00e9clench\u00e9e\" lors de la derni\u00e8re commande QUERY_PROBE. Notez que si cela est utilis\u00e9 dans une macro, en raison de l'ordre de d\u00e9veloppement du mod\u00e8le, la commande QUERY_PROBE doit \u00eatre ex\u00e9cut\u00e9e avant la macro contenant cette demande. last_z_result : Renvoie la valeur du Z de la derni\u00e8re commande PROBE. Notez que si cela est utilis\u00e9 dans une macro, en raison de l'ordre d'expansion du mod\u00e8le, la commande PROBE (ou similaire) doit \u00eatre ex\u00e9cut\u00e9e avant la macro contenant cette demande.","title":"probe"},{"location":"Status_Reference.html#quad_gantry_level","text":"Les informations suivantes sont disponibles dans l'objet quad_gantry_level (cet objet est disponible si quad_gantry_level est d\u00e9fini) : applied : Vrai si le processus de nivellement 4 points du portique a \u00e9t\u00e9 ex\u00e9cut\u00e9 et termin\u00e9 avec succ\u00e8s.","title":"quad_gantry_level"},{"location":"Status_Reference.html#query_endstops","text":"Les informations suivantes sont disponibles dans l'objet query_endstops (cet objet est disponible si au moins une fin de course est d\u00e9finie) : last_query[\"<endstop>\"] : renvoie True si l'endstop donn\u00e9 a \u00e9t\u00e9 signal\u00e9 comme \"d\u00e9clench\u00e9\" (triggered) lors de la derni\u00e8re commande QUERY_ENDSTOP. Notez que si cela est utilis\u00e9 dans une macro, en raison de l'ordre de d\u00e9veloppement du mod\u00e8le, la commande QUERY_ENDSTOP doit \u00eatre ex\u00e9cut\u00e9e avant la macro contenant cette demande.","title":"query_endstops"},{"location":"Status_Reference.html#screws_tilt_adjust","text":"Les informations suivantes sont disponibles dans l'objet screws_tilt_adjust : error : renvoie True si la commande SCREWS_TILT_CALCULATE la plus r\u00e9cente incluait le param\u00e8tre MAX_DEVIATION et que l'un des sondages au niveau des vis de lit d\u00e9passait la valeur MAX_DEVIATION . r\u00e9sultats : une liste des emplacements des vis de lit sond\u00e9es. Chaque entr\u00e9e de la liste est un dictionnaire contenant les cl\u00e9s suivantes : name : le nom de la vis tel qu'il est sp\u00e9cifi\u00e9 dans le fichier de configuration. x : la coordonn\u00e9e X de la vis telle que sp\u00e9cifi\u00e9e dans le fichier de configuration. y : la coordonn\u00e9e Y de la vis telle que sp\u00e9cifi\u00e9e dans le fichier de configuration. z : La hauteur Z mesur\u00e9e \u00e0 l'emplacement de la vis. sign : Une cha\u00eene sp\u00e9cifiant le sens de rotation \u00e0 visser pour le r\u00e9glage n\u00e9cessaire. Soit \"CW\" pour le sens horaire ou \"CCW\" pour le sens antihoraire. La vis de base n'aura pas de cl\u00e9 sign . adjust : le nombre de tours de vis pour ajuster la vis, donn\u00e9 au format \"HH:MM\", o\u00f9 \"HH\" est le nombre de tours de vis complets et \"MM\" est le nombre de \"minutes d'un cadran d'horloge\" repr\u00e9sentant un tour de vis partiel. (Par exemple, \"01:15\" signifierait de tourner la vis d'un tour et quart.)","title":"screws_tilt_adjust"},{"location":"Status_Reference.html#servo","text":"Les informations suivantes sont disponibles dans les objets servo some_name : printer[\"servo <config_name>\"].value : le dernier r\u00e9glage de la broche PWM (une valeur comprise entre 0,0 et 1,0) associ\u00e9e au servo.","title":"servo"},{"location":"Status_Reference.html#system_stats","text":"Les informations suivantes sont disponibles dans l'objet system_stats (cet objet est toujours disponible) : sysload , cputime , memavail : informations sur le syst\u00e8me d'exploitation h\u00f4te et la charge du processus.","title":"system_stats"},{"location":"Status_Reference.html#capteurs-de-temperature","text":"Les informations suivantes sont disponibles dans objets BME280 nom_du_capteur , htu21d nom_du_capteur , lm75 nom_du_capteur et temperature_host nom_du_capteur : temperature : La derni\u00e8re temp\u00e9rature lue par le capteur. humidit\u00e9 , pression , gaz : les derni\u00e8res valeurs lues par le capteur (uniquement sur les capteurs bme280, htu21d et lm75).","title":"Capteurs de temp\u00e9rature"},{"location":"Status_Reference.html#temperature_fan","text":"Les informations suivantes sont disponibles dans les objets temperature_fan nom_du_ventilateur : temperature : La derni\u00e8re temp\u00e9rature lue par le capteur. target : La temp\u00e9rature cible pour le ventilateur.","title":"temperature_fan"},{"location":"Status_Reference.html#temperature_sensor","text":"Les informations suivantes sont disponibles dans les objets temperature_sensor nom_du_capteur : temperature : La derni\u00e8re temp\u00e9rature lue par le capteur. measured_min_temp , measured_max_temp : la temp\u00e9rature la plus basse et la plus \u00e9lev\u00e9e observ\u00e9es par le capteur depuis le dernier red\u00e9marrage de Klipper.","title":"temperature_sensor"},{"location":"Status_Reference.html#pilotes-tmc","text":"Les informations suivantes sont disponibles dans les objets pilote pas \u00e0 pas TMC (par exemple, [tmc2208 stepper_x] ) : mcu_phase_offset : la position du moteur pas \u00e0 pas du microcontr\u00f4leur correspondant \u00e0 la phase \"z\u00e9ro\" du pilote. Ce champ peut \u00eatre nul si le d\u00e9phasage n'est pas connu. phase_offset_position : La \"position command\u00e9e\" correspondant \u00e0 la phase \"z\u00e9ro\" du driver. Ce champ peut \u00eatre nul si le d\u00e9phasage n'est pas connu. drv_status : les r\u00e9sultats de la derni\u00e8re requ\u00eate d'\u00e9tat du pilote. (Seuls les champs non nuls sont signal\u00e9s.) Ce champ sera nul si le pilote n'est pas activ\u00e9 (et n'est donc pas interrog\u00e9 p\u00e9riodiquement). run_current : le courant de fonctionnement actuellement d\u00e9fini. hold_current : Le courant de maintien actuellement d\u00e9fini.","title":"Pilotes TMC"},{"location":"Status_Reference.html#toolhead","text":"Les informations suivantes sont disponibles dans l'objet toolhead (cet objet est toujours disponible) : position : la derni\u00e8re position command\u00e9e de la t\u00eate d'outil par rapport au syst\u00e8me de coordonn\u00e9es sp\u00e9cifi\u00e9 dans le fichier de configuration. Il est possible d'acc\u00e9der aux composantes x, y, z et e de cette position (par exemple, position.x ). extruder : le nom de l'extrudeur actuellement actif. Par exemple, dans une macro, on pourrait utiliser printer[printer.toolhead.extruder].target pour obtenir la temp\u00e9rature cible de l'extrudeuse actuelle. homed_axes : les axes consid\u00e9r\u00e9s comme \u00e9tant dans un \u00e9tat \"\u00e0 l'origine\". Il s'agit d'une cha\u00eene contenant un ou plusieurs \"x\", \"y\", \"z\". axis_minimum , axis_maximum : les limites de d\u00e9placement de l'axe (mm) apr\u00e8s la mise \u00e0 l'origine. Il est possible d'acc\u00e9der aux composantes x, y, z de cette valeur limite (par exemple, axis_minimum.x , axis_maximum.z ). Pour les imprimantes Delta, le cone_start_z est la hauteur z maximale au rayon maximal ( printer.toolhead.cone_start_z ). max_velocity , max_accel , max_accel_to_decel , square_corner_velocity : les limites d'impression actuelles en vigueur. Cela peut diff\u00e9rer des param\u00e8tres du fichier de configuration si une commande SET_VELOCITY_LIMIT (ou M204 ) les a modifi\u00e9es au moment de l'ex\u00e9cution. stalls : Le nombre total de fois (depuis le dernier red\u00e9marrage) o\u00f9 l'imprimante a d\u00fb \u00eatre mise en pause parce que la t\u00eate d'outil s'est d\u00e9plac\u00e9e plus vite que les mouvements ne pouvaient \u00eatre lus \u00e0 partir de l'entr\u00e9e G-Code.","title":"toolhead"},{"location":"Status_Reference.html#dual_carriage","text":"Les informations suivantes sont disponibles dans dual_carriage sur une imprimante de type hybrid_corexy ou hybrid_corexz mode : Le mode actuel. Les valeurs possibles sont : \"FULL_CONTROL\" active_carriage : le chariot actif actuel. Les valeurs possibles sont : \"CARRIAGE_0\", \"CARRIAGE_1\"","title":"dual_carriage"},{"location":"Status_Reference.html#virtual_sdcard","text":"Les informations suivantes sont disponibles dans l'objet virtual_sdcard : is_active : renvoie True si une impression \u00e0 partir d'un fichier est actuellement active. progress : une estimation de la progression de l'impression actuelle (bas\u00e9e sur la taille et la position du fichier). file_path : un chemin d'acc\u00e8s complet au fichier actuellement charg\u00e9. file_position : la position actuelle (en octets) d'une impression active. file_size : taille (en octets) du fichier actuellement charg\u00e9.","title":"virtual_sdcard"},{"location":"Status_Reference.html#webhooks","text":"Les informations suivantes sont disponibles dans l'objet webhooks (cet objet est toujours disponible) : state : renvoie une cha\u00eene indiquant l'\u00e9tat actuel de Klipper. Les valeurs possibles sont : \"ready\", \"startup\", \"shutdown\", \"error\". state_message : une cha\u00eene donnant un contexte suppl\u00e9mentaire sur l'\u00e9tat actuel de Klipper.","title":"webhooks"},{"location":"Status_Reference.html#z_thermal_adjust","text":"Les informations suivantes sont disponibles dans l'objet z_thermal_adjust (cet objet est disponible si z_thermal_adjust est d\u00e9fini). enabled : renvoie True si le r\u00e9glage est activ\u00e9. temp\u00e9rature : Temp\u00e9rature actuelle (liss\u00e9e) du capteur d\u00e9fini. (en degr\u00e9s Centigrades) measured_min_temp : temp\u00e9rature minimale mesur\u00e9e. (en degr\u00e9s Centigrades) measured_max_temp : temp\u00e9rature maximale mesur\u00e9e. (En degr\u00e9s Centigrades) current_z_adjust : dernier ajustement Z calcul\u00e9 (en mm). z_adjust_ref_temperature : Temp\u00e9rature de r\u00e9f\u00e9rence actuelle utilis\u00e9e pour le calcul de Z current_z_adjust (En degr\u00e9s Centigrades).","title":"z_thermal_adjust"},{"location":"Status_Reference.html#z_tilt","text":"Les informations suivantes sont disponibles dans l'objet z_tilt (cet objet est disponible si z_tilt est d\u00e9fini) : applied : Vrai si le processus de mise \u00e0 niveau z-tilt a \u00e9t\u00e9 ex\u00e9cut\u00e9 et termin\u00e9 avec succ\u00e8s.","title":"z_tilt"},{"location":"TMC_Drivers.html","text":"Pilotes de moteur pas \u00e0 pas TMC \u00b6 Ce document fournit des informations sur l'utilisation des pilotes de moteur pas \u00e0 pas Trinamic en mode SPI/UART sur Klipper. Klipper peut \u00e9galement utiliser les pilotes Trinamic dans leur \"mode autonome\". Cependant, lorsque les pilotes sont dans ce mode, aucune configuration sp\u00e9ciale de Klipper n'est possible et les fonctionnalit\u00e9s avanc\u00e9es de Klipper d\u00e9crites dans ce document ne sont pas disponibles. En plus de ce document, veillez \u00e0 consulter la r\u00e9f\u00e9rence de configuration du pilote TMC . R\u00e9glage du courant du moteur \u00b6 Un courant de commande plus \u00e9lev\u00e9 augmente la pr\u00e9cision de positionnement et le couple. Cependant, un courant plus \u00e9lev\u00e9 augmente \u00e9galement la chaleur produite par le moteur pas \u00e0 pas et le pilote du moteur pas \u00e0 pas. Si le pilote du moteur pas \u00e0 pas devient trop chaud, il se d\u00e9sactivera et Klipper signalera une erreur. Si le moteur pas \u00e0 pas devient trop chaud, il perd du couple et de la pr\u00e9cision de positionnement. (S'il devient tr\u00e8s chaud, il peut \u00e9galement faire fondre les pi\u00e8ces en plastique qui y sont attach\u00e9es ou \u00e0 proximit\u00e9.) Comme conseil de r\u00e9glage g\u00e9n\u00e9ral : pr\u00e9f\u00e9rez des valeurs de courant plus \u00e9lev\u00e9es tant que le moteur pas \u00e0 pas ne chauffe pas trop et que le pilote du moteur pas \u00e0 pas ne signale pas d'avertissements ou d'erreurs. En g\u00e9n\u00e9ral, il est normal que le moteur pas \u00e0 pas soit chaud, mais il ne doit pas devenir si chaud qu'il soit douloureux au toucher. Ne sp\u00e9cifiez pas de hold_current \u00b6 Si l'on configure un hold_current , le pilote TMC peut r\u00e9duire le courant vers le moteur pas \u00e0 pas lorsqu'il d\u00e9tecte que le moteur pas \u00e0 pas ne bouge pas. Cependant, la modification du courant du moteur peut elle-m\u00eame introduire un mouvement du moteur. Cela peut se produire en raison de \"forces de d\u00e9tente\" dans le moteur pas \u00e0 pas (l'aimant permanent du rotor tire vers les dents en fer du stator) ou en raison de forces externes sur le chariot d'axe. La plupart des moteurs pas \u00e0 pas ne fonctionneront pas mieux en r\u00e9duisant le courant pendant les impressions normales, car peu de mouvements d'impression laisseront un moteur pas \u00e0 pas inactif suffisamment longtemps pour activer la fonction hold_current . Et, il est peu probable que l'on veuille introduire des artefacts d'impression dans les quelques mouvements d'impression qui laissent un stepper inactif suffisamment longtemps. Si l'on souhaite r\u00e9duire le courant vers les moteurs pendant les routines de d\u00e9marrage d'impression, envisagez d'\u00e9mettre des commandes SET_TMC_CURRENT dans une MACRO START_PRINT pour ajuster le courant avant et apr\u00e8s les mouvements d'impression normaux. Certaines imprimantes avec des moteurs Z d\u00e9di\u00e9s qui sont inactifs pendant les mouvements d'impression normaux (pas de bed_mesh, pas de bed_tilt, pas de Z skew_correction, pas d'impressions en \"mode vase\", etc.) peuvent constater que les moteurs Z fonctionnent plus froid avec un hold_current . Si vous l'impl\u00e9mentez, assurez-vous de prendre en compte ce type de mouvement non command\u00e9 de l'axe Z pendant le nivellement du lit, le sondage du lit, l'\u00e9talonnage de la sonde, etc. Le driver_TPOWERDOWN et le driver_IHOLDDELAY doivent \u00e9galement \u00eatre calibr\u00e9s en cons\u00e9quence. En cas de doute, pr\u00e9f\u00e9rez ne pas sp\u00e9cifier de hold_current . R\u00e9glage du mode \"spreadCycle\" vs \"stealthChop\" \u00b6 Par d\u00e9faut, Klipper place les pilotes TMC en mode \"spreadCycle\". Si le pilote prend en charge \"stealthChop\", il peut \u00eatre activ\u00e9 en ajoutant stealthchop_threshold : 999999 \u00e0 la section de configuration TMC. Le mode spreadCycle fournit un couple sup\u00e9rieur et une plus grande pr\u00e9cision de positionnement que le mode stealthChop. Cependant, le mode StealthChop peut produire un bruit audible nettement plus faible sur certaines imprimantes. Les tests comparant les modes ont montr\u00e9 un \"d\u00e9calage de position\" accru d'environ 75 % d'un pas complet lors de mouvements \u00e0 vitesse constante lors de l'utilisation du mode StealthChop (par exemple, sur une imprimante avec une distance de rotation de 40 mm et 200 pas_par_rotation, l'\u00e9cart de position des mouvements \u00e0 vitesse constante a augment\u00e9 de ~0,150 mm). Cependant, ce \"retard dans l'obtention de la position demand\u00e9e\" peut ne pas se manifester par un d\u00e9faut d'impression significatif et on peut pr\u00e9f\u00e9rer le comportement plus silencieux du mode StealthChop. Il est recommand\u00e9 de toujours utiliser le mode \"spreadCycle\" (en ne sp\u00e9cifiant pas stealthchop_threshold ) ou de toujours utiliser le mode \"stealthChop\" (en r\u00e9glant stealthchop_threshold sur 999999). Malheureusement, les pilotes produisent souvent des r\u00e9sultats m\u00e9diocres et erron\u00e9s si le mode est chang\u00e9 alors que le moteur tourne. Le r\u00e9glage d'interpolation TMC introduit un petit \u00e9cart de position \u00b6 Le param\u00e8tre interpolation du pilote TMC peut r\u00e9duire le bruit audible du mouvement de l'imprimante au prix de l'introduction d'une petite erreur de position syst\u00e9mique. Cette erreur de position syst\u00e9mique r\u00e9sulte du retard du conducteur \u00e0 ex\u00e9cuter les \"\u00e9tapes\" que Klipper lui envoie. Pendant les d\u00e9placements \u00e0 vitesse constante, ce retard entra\u00eene une erreur de position de pr\u00e8s d'un demi-micropas configur\u00e9 (plus pr\u00e9cis\u00e9ment, l'erreur est d'une demi-distance de micropas moins un 512e de distance d'un pas complet). Par exemple, sur un axe avec une rotation_distance de 40 mm, 200 pas_par_rotation et 16 micropas, l'erreur syst\u00e9mique introduite lors des mouvements \u00e0 vitesse constante est d'environ 0,006 mm. Pour une meilleure pr\u00e9cision de positionnement, envisagez d'utiliser le mode spreadCycle et d\u00e9sactivez l'interpolation (d\u00e9finissez interpolate : False dans la configuration du pilote TMC). Lorsqu'il est configur\u00e9 de cette fa\u00e7on, on peut augmenter le param\u00e8tre microstep pour r\u00e9duire le bruit audible pendant le mouvement pas \u00e0 pas. En r\u00e8gle g\u00e9n\u00e9rale, un r\u00e9glage de micropas de 64 ou 128 aura un bruit audible similaire \u00e0 celui de l'interpolation, et ce, sans introduire d'erreur de position syst\u00e9mique. Si vous utilisez le mode StealthChop, l'impr\u00e9cision de position due \u00e0 l'interpolation est faible par rapport \u00e0 l'impr\u00e9cision de position introduite \u00e0 partir du mode StealthChop. Par cons\u00e9quent, le r\u00e9glage de l'interpolation n'est pas consid\u00e9r\u00e9e comme utile en mode StealthChop, et on peut laisser l'interpolation dans son \u00e9tat par d\u00e9faut. Mise \u00e0 l'origine sans capteur \u00b6 La mise \u00e0 l'origine ans capteur permet de r\u00e9f\u00e9rencer un axe sans avoir besoin d'une fin de course physique. Au lieu de cela, le chariot sur l'axe est d\u00e9plac\u00e9 dans la limite m\u00e9canique, ce qui fait perdre des pas au moteur pas \u00e0 pas. Le pilote pas \u00e0 pas d\u00e9tecte les pas perdus et l'indique au MCU de contr\u00f4le (Klipper) en basculant une broche. Cette information peut \u00eatre utilis\u00e9e par Klipper comme fin de course pour l'axe. Ce guide couvre la configuration de la mise \u00e0 l'origine sans capteur pour l'axe X de votre imprimante (cart\u00e9sienne). Cependant, cela fonctionne de la m\u00eame mani\u00e8re avec tous les autres axes (qui n\u00e9cessitent une fin de course). Vous devez le configurer et le r\u00e9gler pour un axe \u00e0 la fois. Limites \u00b6 Assurez-vous que vos composants m\u00e9caniques sont capables de supporter la charge du chariot heurtant \u00e0 plusieurs reprises la fin de course de l'axe. Les vis sans fin, en particulier, peuvent g\u00e9n\u00e9rer beaucoup de force. La prise d'origine d'un axe Z en \u00e9crasant la buse dans la surface d'impression n'est peut-\u00eatre pas une bonne id\u00e9e. Pour de meilleurs r\u00e9sultats, v\u00e9rifiez que le chariot de l'axe \u00e9tablit un contact lors de la mise \u00e0 l'origine. De plus, la mise \u00e0 l'origine sans capteur peut ne pas \u00eatre suffisamment pr\u00e9cise pour votre imprimante. Bien que la mise \u00e0 l'origine des axes X et Y sur une machine cart\u00e9sienne puisse bien fonctionner, la prise d'origine de l'axe Z n'est g\u00e9n\u00e9ralement pas assez pr\u00e9cise et peut entra\u00eener une hauteur de premi\u00e8re couche incoh\u00e9rente. Le r\u00e9f\u00e9rencement d'une imprimante delta sans capteur n'est pas conseill\u00e9 en raison du manque de pr\u00e9cision. De plus, la d\u00e9tection de d\u00e9crochage du pilote pas \u00e0 pas d\u00e9pend de la charge m\u00e9canique sur le moteur, du courant du moteur et de la temp\u00e9rature du moteur (r\u00e9sistance de la bobine). La mise \u00e0 l'origine sans capteur fonctionne mieux \u00e0 des vitesses de moteur moyennes. Pour des vitesses tr\u00e8s lentes (moins de 10 tr/min), le moteur ne g\u00e9n\u00e8re pas de force contre-\u00e9lectromotrice significative et le TMC ne peut pas d\u00e9tecter de mani\u00e8re fiable les calages du moteur. A des vitesses tr\u00e8s \u00e9lev\u00e9es, la force contre-\u00e9lectromotrice du moteur se rapproche de la tension d'alimentation du moteur, de sorte que le TMC ne peut plus d\u00e9tecter les calages. Il est conseill\u00e9 de consulter la fiche technique de vos TMC sp\u00e9cifiques. Vous y trouverez \u00e9galement plus de d\u00e9tails sur les limites de cette configuration. Conditions pr\u00e9alables \u00b6 Quelques pr\u00e9requis sont n\u00e9cessaires pour utiliser la mise \u00e0 l'origine sans capteur : Un pilote pas \u00e0 pas TMC compatible stallGuard (tmc2130, tmc2209, tmc2660 ou tmc5160). Interface SPI/UART du driver TMC c\u00e2bl\u00e9 au micro-contr\u00f4leur (le mode autonome ne fonctionne pas). La broche \"DIAG\" ou \"SG_TST\" appropri\u00e9e du pilote TMC doit \u00eatre connect\u00e9e au microcontr\u00f4leur. Les \u00e9tapes du document v\u00e9rification de la configuration doivent \u00eatre ex\u00e9cut\u00e9es pour confirmer que les moteurs pas \u00e0 pas sont configur\u00e9s et fonctionnent correctement. R\u00e9glages \u00b6 La proc\u00e9dure d\u00e9crite ici comporte six \u00e9tapes principales : Choisissez une vitesse de mise \u00e0 l'origine. Configurez le fichier printer.cfg pour activer la mise \u00e0 l'origine sans capteur. Trouvez le meilleur r\u00e9glage anti-d\u00e9crochage avec la sensibilit\u00e9 la plus \u00e9lev\u00e9e. Trouvez le r\u00e9glage anti-d\u00e9crochage avec la sensibilit\u00e9 la plus faible qui fonctionne avec une seule touche en fin de course. Mettez \u00e0 jour le fichier printer.cfg avec le param\u00e8tre anti-d\u00e9crochage souhait\u00e9. Cr\u00e9ez ou mettez \u00e0 jour les macros dans printer.cfg pour une mise \u00e0 l'origine r\u00e9p\u00e9table. Choisir la vitesse de prise d'origine \u00b6 La vitesse de mise \u00e0 l'origine est importante lors de la r\u00e9alisation d'une mise \u00e0 l'origine sans capteur. Il est souhaitable d'utiliser une vitesse de prise d'origine lente afin que le chariot n'exerce pas de force excessive sur le ch\u00e2ssis lorsqu'il entre en contact avec l'extr\u00e9mit\u00e9 du rail. Cependant, les pilotes TMC ne peuvent pas d\u00e9tecter de mani\u00e8re fiable un d\u00e9crochage \u00e0 des vitesses tr\u00e8s lentes. Un bon point de d\u00e9part pour la vitesse de prise d'origine est que le moteur pas \u00e0 pas effectue une rotation compl\u00e8te toutes les deux secondes. Pour de nombreux axes, ce sera la distance rotation_distance divis\u00e9e par deux. Par example\u202f: [stepper_x] rotation_distance: 40 homing_speed: 20 ... Configurer 'printer.cfg' pour une mise \u00e0 l'origine sans capteur \u00b6 Le param\u00e8tre homing_retract_dist doit \u00eatre d\u00e9fini sur z\u00e9ro dans la section de configuration stepper_x pour d\u00e9sactiver le deuxi\u00e8me mouvement de mise \u00e0 l'origine. La deuxi\u00e8me tentative de mise \u00e0 l'origine n'ajoute pas de valeur lors de l'utilisation d'une mise \u00e0 l'origine sans capteur, elle ne fonctionnera pas de mani\u00e8re fiable et introduira des erreurs dans le processus de r\u00e9glage. Assurez-vous que le param\u00e8tre hold_current n\u2019est pas sp\u00e9cifi\u00e9 dans la section Pilote TMC de la configuration. (Si un hold_current est r\u00e9gl\u00e9, le moteur s\u2019arr\u00eate lorsque le chariot est appuy\u00e9 contre l\u2019extr\u00e9mit\u00e9 du rail, et la r\u00e9duction du courant dans cette position peut entra\u00eener le d\u00e9placement du chariot - ce qui entra\u00eenera de mauvaises performances et perturbera le processus de r\u00e9glage.) Il est n\u00e9cessaire de configurer les broches du TMC pour le mode sans capteur et de configurer les param\u00e8tres initiaux de \u00ab Stallguard \u00bb. Un exemple de configuration tmc2209 pour un axe X pourrait ressembler \u00e0 : [tmc2209 stepper_x] diag_pin: ^PA1 # D\u00e9finit pour le MCU, la broche TMC DIAG driver_SGTHRS: 255 # 255 est la valeur la plus sensible, 0 la moins sensible ... [stepper_x] endstop_pin: tmc2209_stepper_x:virtual_endstop homing_retract_dist: 0 ... Un exemple de configuration de tmc2130 ou tmc5160 pourrait ressembler \u00e0 : [tmc2130 stepper_x] diag1_pin: ^!PA1 # Broche connect\u00e9e \u00e0 TMC DIAG1 (ou utilisez diag0_pin / DIAG0 pin) driver_SGT: -64 # -64 est la valeur la plus sensible, 63 est moins sensible ... [stepper_x] endstop_pin: tmc2130_stepper_x:virtual_endstop homing_retract_dist: 0 ... Un exemple de configuration de tmc2660 pourrait ressembler \u00e0 : [tmc2660 stepper_x] driver_SGT: -64 # -64 est la valeur la plus sensible,, 63 est moins sensible ... [stepper_x] endstop_pin: ^PA1 # Broche connect\u00e9e \u00e0 TMC SG_TST homing_retract_dist: 0 ... Les exemples ci-dessus ne montrent que les param\u00e8tres sp\u00e9cifiques \u00e0 la mise \u00e0 l'origine sans capteur. Voir la r\u00e9f\u00e9rence de configuration pour toutes les options disponibles. Trouvez la sensibilit\u00e9 la plus \u00e9lev\u00e9e qui fonctionne avec succ\u00e8s \u00b6 Placez le chariot pr\u00e8s du centre du rail. Utilisez la commande SET_TMC_FIELD pour d\u00e9finir la sensibilit\u00e9 la plus \u00e9lev\u00e9e. Pour un tmc2209 : SET_TMC_FIELD STEPPER=stepper_x FIELD=SGTHRS VALUE=255 Pour un tmc2130, tmc5160 et tmc2660 : SET_TMC_FIELD STEPPER=stepper_x FIELD=sgt VALUE=-64 \u00c9mettez ensuite une commande G28 X0 et v\u00e9rifiez que l'axe ne bouge pas du tout ou s'arr\u00eate rapidement. Si l'axe ne s'arr\u00eate pas, \u00e9mettez un M112 pour arr\u00eater l'imprimante - quelque chose n'est pas correct avec le c\u00e2blage ou la configuration de la broche diag/sg_tst et ce doit \u00eatre corrig\u00e9 avant de continuer. Ensuite, diminuez continuellement la sensibilit\u00e9 du param\u00e8tre VALUE et ex\u00e9cutez \u00e0 nouveau les commandes SET_TMC_FIELD G28 X0 pour trouver la sensibilit\u00e9 la plus \u00e9lev\u00e9e qui permet au chariot de se d\u00e9placer et de s'arr\u00eater en but\u00e9e. (Pour les pilotes tmc2209, cela diminuera SGTHRS, pour les autres pilotes, cela augmentera sgt.). Il devrait \u00eatre possible de trouver la sensibilit\u00e9 la plus \u00e9lev\u00e9e et fiable (les r\u00e9glages avec une sensibilit\u00e9 plus \u00e9lev\u00e9e entra\u00eenant peu ou pas de mouvement). Notez la valeur trouv\u00e9e comme maximum_sensitivity . (Si la sensibilit\u00e9 minimale possible (SGTHRS = 0 ou sgt = 63) est obtenue sans aucun mouvement du chariot, alors quelque chose ne fonctionne pas aun niveau c\u00e2blage ou configuration de la broche diag/sg_tst et il faut corriger le probl\u00e8me avant de continuer.) Lors de la recherche de maximum_sensitivity, il peut \u00eatre pratique de passer \u00e0 diff\u00e9rents param\u00e8tres VALUE (travaillez le param\u00e8tre VALUE par dichotomie pour plus d'efficacit\u00e9). Si vous proc\u00e9dez ainsi, pr\u00e9parez-vous \u00e0 \u00e9mettre une commande M112 pour arr\u00eater l'imprimante, car un r\u00e9glage avec une sensibilit\u00e9 trop faible peut entra\u00eener un \"cognement\" r\u00e9p\u00e9t\u00e9 de l'axe contre l'extr\u00e9mit\u00e9 du rail. Assurez-vous d'attendre quelques secondes entre chaque tentative de prise d'origine. Une fois que le pilote TMC a d\u00e9tect\u00e9 un d\u00e9crochage, il peut lui falloir un peu de temps pour effacer son indicateur interne et \u00eatre capable de d\u00e9tecter un autre d\u00e9crochage. Au cours de ces tests de r\u00e9glage, si une commande G28 X0 ne se d\u00e9place pas jusqu'\u00e0 la limite d'axe, soyez prudent lorsque vous ex\u00e9cutez des commandes de mouvement 'normales' (par exemple, G1 ). Klipper ne sachant pas ou est le chariot, une commande de d\u00e9placement pourra entra\u00eener des r\u00e9sultats ind\u00e9sirables. Trouver la sensibilit\u00e9 la plus basse qui permette la mise \u00e0 l'origine en une seule fois \u00b6 Lors de la mise \u00e0 l'origine avec la valeur maximum_sensitivity , l'axe doit se d\u00e9placer jusqu'\u00e0 l'extr\u00e9mit\u00e9 du rail et s'arr\u00eater avec un \u00ab simple toucher \u00bb - c'est-\u00e0-dire qu'il ne doit pas y avoir de \u00ab clic \u00bb ou de \u00ab claquement \u00bb. (S'il y a un bruit de claquement ou de clic \u00e0 la sensibilit\u00e9 maximale, la vitesse de mise \u00e0 l'origine est peut-\u00eatre trop faible, le courant du pilote peut \u00eatre trop faible ou la mise \u00e0 l'origine sans capteur n'est peut-\u00eatre pas un bon choix pour cet axe.) L'\u00e9tape suivante consiste \u00e0 nouveau \u00e0 d\u00e9placer le chariot vers une position proche du centre du rail, \u00e0 diminuer la sensibilit\u00e9 et \u00e0 ex\u00e9cuter les commandes SET_TMC_FIELD G28 X0 - l'objectif est maintenant de trouver la sensibilit\u00e9 la plus faible qui permette au chariot de se mettre \u00e0 l'origine correctement avec une \"simple touche\". C'est-\u00e0-dire qu'il ne \"cogne\" pas ou ne \"clique\" pas lorsqu'il entre en contact avec l'extr\u00e9mit\u00e9 du rail. Notez la valeur trouv\u00e9e comme minimum_sensitivity . Mettez \u00e0 jour printer.cfg avec la valeur de sensibilit\u00e9 \u00b6 Apr\u00e8s avoir trouv\u00e9 maximum_sensitivity et minimum_sensitivity , utilisez une calculatrice pour obtenir la sensibilit\u00e9 recommand\u00e9e : minimum_sensitivity + (maximum_sensitivity - minimum_sensitivity)/3 . La sensibilit\u00e9 recommand\u00e9e doit \u00eatre comprise entre le minimum et le maximum, mais l\u00e9g\u00e8rement plus proche du minimum. Arrondissez la valeur finale \u00e0 la valeur enti\u00e8re la plus proche. Pour un tmc2209, d\u00e9finissez-le dans la configuration en tant que driver_SGTHRS , pour les autres pilotes TMC, d\u00e9finissez-le dans la configuration en tant que driver_SGT . Si la plage entre maximum_sensitivity et minimum_sensitivity est petite (par exemple, inf\u00e9rieure \u00e0 5), cela peut entra\u00eener une mise \u00e0 l'origine instable. Une vitesse de mise \u00e0 l'origine plus rapide peut rendre l'op\u00e9ration plus stable. Notez que si une modification est apport\u00e9e au courant du pilote, \u00e0 la vitesse de prise d'origine ou si une modification notable est apport\u00e9e au mat\u00e9riel de l'imprimante, il sera alors n\u00e9cessaire de refaire le processus de r\u00e9glage. Utilisation de macros lors de la mise \u00e0 l'origine \u00b6 Une fois la mise \u00e0 l'origine sans capteur termin\u00e9e, le chariot sera appuy\u00e9 contre l'extr\u00e9mit\u00e9 du rail et le stepper exercera une force sur le cadre tant que le chariot ne sera pas \u00e9loign\u00e9 de la fin de course. Il est pr\u00e9f\u00e9rable de cr\u00e9er une macro pour positionner l'axe en but\u00e9e et l'\u00e9loigner imm\u00e9diatement de l'extr\u00e9mit\u00e9 du rail. Il est pr\u00e9f\u00e9rable, dans la macro, de faire une pause d'au moins 2 secondes avant de commencer la prise d'origine sans capteur (ou de s'assurer qu'il n'y a eu aucun mouvement sur le moteur pas \u00e0 pas depuis au moins 2 secondes). Sans d\u00e9lai, il est possible que le drapeau de d\u00e9crochage interne du pilote de moteur pas \u00e0 pas soit toujours activ\u00e9 suite \u00e0 un mouvement pr\u00e9c\u00e9dent. Il peut \u00e9galement \u00eatre utile que cette macro d\u00e9finisse le courant du pilote avant la prise d'origine et d\u00e9finisse un nouveau courant apr\u00e8s que le chariot s'est \u00e9loign\u00e9. Un exemple de macro pourrait ressembler \u00e0 : [gcode_macro SENSORLESS_HOME_X] gcode: {% set HOME_CUR = 0.700 %} {% set driver_config = printer.configfile.settings['tmc2209 stepper_x'] %} {% set RUN_CUR = driver_config.run_current %} # D\u00e9finir le courant pour la mise \u00e0 l'origine sans capteur SET_TMC_CURRENT STEPPER=stepper_x CURRENT={HOME_CUR} # Petit pause pour attendre que le drapeau stall flag soit d\u00e9sactiv\u00e9 G4 P2000 # mise \u00e0 l'origine G28 X0 # D\u00e9placement G90 G1 X5 F1200 # Remise du courant d'impression SET_TMC_CURRENT STEPPER=stepper_x CURRENT={RUN_CUR} La macro peut \u00eatre appel\u00e9e depuis une section de configuration homing_override ou depuis une macro START_PRINT . Notez que si le courant du pilote pas \u00e0 pas lors de la mise \u00e0 l'origine est modifi\u00e9, le processus de r\u00e9glage doit \u00eatre enti\u00e8rement refait. Conseils pour la mise \u00e0 l'origine sans capteur sur CoreXY \u00b6 Il est possible d'utiliser la mise \u00e0 l'origine sans capteur sur les chariots X et Y d'une imprimante CoreXY. Klipper utilise le stepper [stepper_x] pour d\u00e9tecter les d\u00e9crochages lors de la mise \u00e0 l'origine du chariot X et utilise le stepper [stepper_y] pour d\u00e9tecter les d\u00e9crochages lors de la mise \u00e0 l'origine du chariot Y. Utilisez le guide de r\u00e9glage d\u00e9crit ci-dessus pour trouver la \"sensibilit\u00e9 au d\u00e9crochage\" appropri\u00e9e pour chaque chariot, mais soyez conscient des restrictions suivantes : Lors de l'utilisation de la prise d'origine sans capteur sur CoreXY, assurez-vous qu'aucun hold_current n'est configur\u00e9 pour l'un ou l'autre des moteurs pas \u00e0 pas. Pendant le r\u00e9glage, assurez-vous que les chariots X et Y sont proches du centre de leurs rails avant chaque tentative de mise \u00e0 l'origine. Une fois les r\u00e9glages termin\u00e9s, lors de la prise d'origine de X et Y, utilisez des macros pour vous assurer qu'un axe est pris en charge en premier, puis \u00e9loignez ce chariot de la fin de course de l'axe, faites une pause d'au moins 2 secondes, puis d\u00e9marrez la prise d'origine de l'autre axe. L'\u00e9loignement de l'axe \u00e9vite le r\u00e9f\u00e9rencement d'un axe alors que l'autre est plaqu\u00e9 contre la fin de course (ce qui peut fausser la d\u00e9tection de d\u00e9crochage). La pause est n\u00e9cessaire pour s'assurer que le drapeau de d\u00e9crochage du pilote pas \u00e0 pas est effac\u00e9 avant de se d\u00e9placer \u00e0 nouveau. Un exemple de macro de r\u00e9f\u00e9rencement CoreXY pourrait ressembler \u00e0 : [gcode_macro HOME] gcode: G90 # mise \u00e0 l'origine Z G28 Z0 G1 Z10 F1200 # mise \u00e0 l'origine Y G28 Y0 G1 Y5 F1200 # mise \u00e0 l'origine X G4 P2000 G28 X0 G1 X5 F1200 Interroger et diagnostiquer les informations du pilote pas \u00e0 pas \u00b6 La ` commande DUMP_TMC est un outil utile lors de la configuration et du diagnostic des pilotes. Il signalera tous les champs configur\u00e9s par Klipper ainsi que tous les champs pouvant \u00eatre interrog\u00e9s \u00e0 partir du pilote. Tous les champs signal\u00e9s sont d\u00e9finis dans la fiche technique de Trinamic pour chaque pilote. Ces fiches techniques sont disponibles sur le site Internet de Trinamic . Obtenez et examinez la fiche technique de Trinamic du pilote pas \u00e0 pas afin d'interpr\u00e9ter correctement les r\u00e9sultats d'un DUMP_TMC. Configuration des param\u00e8tres d'un 'driver_XXX' \u00b6 Klipper prend en charge la configuration de nombreux param\u00e8tres de bas niveau pour les pilotes de moteurs pas \u00e0 pas \u00e0 l'aide des param\u00e8tres de la section driver_XXX . La r\u00e9f\u00e9rence de configuration du pilote TMC contient la liste compl\u00e8te des param\u00e8tres disponibles pour chaque type de pilote. De plus, presque tous les champs peuvent \u00eatre modifi\u00e9s au moment de l'ex\u00e9cution \u00e0 l'aide de la commande SET_TMC_FIELD . Chacun de ces param\u00e8tres est d\u00e9fini dans la fiche technique de Trinamic pour chaque pilote. Ces fiches techniques sont disponibles sur le site Internet de Trinamic . Les fiches techniques de Trinamic utilisent parfois une formulation qui peut confondre un param\u00e8tre de haut niveau (tel que \"fin d'hyst\u00e9r\u00e9sis\") avec une valeur de param\u00e8tre de bas niveau (par exemple, \"HEND\"). Dans Klipper, driver_XXX et SET_TMC_FIELD d\u00e9finissent toujours la valeur de param\u00e8tres de bas niveau (celles qui sontt r\u00e9ellement \u00e9crite dans le pilote). Ainsi, par exemple, si la fiche technique Trinamic indique qu'une valeur de 3 doit \u00eatre \u00e9crite dans le champ HEND pour obtenir une \"fin d'hyst\u00e9r\u00e9sis\" de 0, alors d\u00e9finissez driver_HEND=3 pour obtenir une valeur de haut niveau de 0. Questions courantes \u00b6 Puis-je utiliser le mode StealthChop sur une extrudeuse avec avance de pression ? \u00b6 Beaucoup de gens utilisent avec succ\u00e8s le mode \"stealthChop\" avec l'avance de pression de Klipper. Klipper impl\u00e9mente avance de pression \"adoucie\" qui n'introduit aucun changement de vitesse instantan\u00e9. Cependant, le mode \"stealthChop\" peut produire un couple moteur plus faible et/ou produire une chaleur moteur plus \u00e9lev\u00e9e. Il peut s'agir ou non d'un mode utilisable avec votre imprimante. J'ai des erreurs \"Unable to read tmc uart 'stepper_x' register IFCNT\" ? \u00b6 Cela se produit lorsque Klipper est incapable de communiquer avec un pilote tmc2208 ou tmc2209. Assurez-vous que l'alimentation du moteur est activ\u00e9e, car le pilote du moteur pas \u00e0 pas a g\u00e9n\u00e9ralement besoin de l'alimentation du moteur avant de pouvoir communiquer avec le micro-contr\u00f4leur. Si cette erreur se produit apr\u00e8s avoir flash\u00e9 Klipper pour la premi\u00e8re fois, le pilote pas \u00e0 pas peut avoir \u00e9t\u00e9 pr\u00e9c\u00e9demment programm\u00e9 dans un \u00e9tat qui n'est pas compatible avec Klipper. Pour r\u00e9initialiser l'\u00e9tat, coupez toute alimentation de l'imprimante pendant plusieurs secondes (d\u00e9branchez physiquement les prises USB et d'alimentation). Sinon, cette erreur est souvent due \u00e0 un c\u00e2blage incorrect des broche UART ou d'une configuration incorrecte des param\u00e8tres de broche UART dans Klipper. J'ai des erreurs \"Unable to write tmc spi 'stepper_x' register ...\" ? \u00b6 Cela se produit lorsque Klipper est incapable de communiquer avec un pilote tmc2130 ou tmc5160. Assurez-vous que l'alimentation du moteur est activ\u00e9e, car le pilote du moteur pas \u00e0 pas a g\u00e9n\u00e9ralement besoin de l'alimentation du moteur avant de pouvoir communiquer avec le micro-contr\u00f4leur. Cette erreur est souvent due \u00e0 un c\u00e2blage SPI incorrect, \u00e0 une configuration incorrecte des param\u00e8tres SPI de Klipper ou d'une configuration incompl\u00e8te des p\u00e9riph\u00e9riques sur un bus SPI. Si le pilote se trouve sur un bus SPI partag\u00e9 avec plusieurs p\u00e9riph\u00e9riques, assurez-vous de configurer - dans Klipper - chaque p\u00e9riph\u00e9rique sur ce bus SPI. Si un appareil sur un bus SPI partag\u00e9 n'est pas configur\u00e9, il peut r\u00e9pondre de mani\u00e8re incorrecte \u00e0 des commandes qui ne lui sont pas destin\u00e9es et corrompre la communication avec l'appareil pr\u00e9vu. S'il y a un appareil sur un bus SPI partag\u00e9 qui ne peut pas \u00eatre configur\u00e9 dans Klipper, utilisez la section de configuration static_digital_output pour r\u00e9gler la broche CS de l'appareil inutilis\u00e9 \u00e0 un niveau \u00e9lev\u00e9 (afin qu'il n'essaie pas d'utiliser le bus SPI). Le sch\u00e9ma de la carte est une r\u00e9f\u00e9rence utile (ndt et n\u00e9cessaire) pour trouver les p\u00e9riph\u00e9riques qui se trouvent sur un bus SPI et leurs broches associ\u00e9es. Pourquoi ai-je une erreur \"TMC reports error\u202f: ...\"\u202f? \u00b6 Ce type d'erreur indique que le pilote TMC a d\u00e9tect\u00e9 un probl\u00e8me et s'est d\u00e9sactiv\u00e9. C'est-\u00e0-dire que le pilote de moteur pas \u00e0 pas a cess\u00e9 de maintenir sa position et a ignor\u00e9 les commandes de mouvement. Si Klipper d\u00e9tecte qu'un pilote actif s'est d\u00e9sactiv\u00e9, il fera passer l'imprimante dans un \u00e9tat \"arr\u00eat\". Il est \u00e9galement possible qu'un arr\u00eat TMC reports error se produise en raison d'erreurs SPI qui emp\u00eachent la communication avec le pilote (sur les tmc2130, tmc5160 ou tmc2660). Si cela se produit, il est fr\u00e9quent que l'\u00e9tat du pilote indiqu\u00e9 affiche 00000000 ou ffffffff - par exemple : TMC reports error : DRV_STATUS : ffffffff ... OU [ X316X]TMC reports error : READRSP@RDSEL2 : 00000000 ...`. Une telle d\u00e9faillance peut \u00eatre due \u00e0 un probl\u00e8me de c\u00e2blage SPI ou \u00e0 une r\u00e9initialisation automatique ou \u00e0 une d\u00e9faillance du pilote TMC. Quelques erreurs courantes et conseils pour les diagnostiquer : TMC signale une erreur : ... ot=1(OvertempError !) \u00b6 Cela indique que le pilote du moteur s'est d\u00e9sactiv\u00e9 car il est en surchauffe. Les solutions typiques consistent \u00e0 diminuer le courant du pilote de moteur pas \u00e0 pas, \u00e0 augmenter le refroidissement du pilote du moteur pas \u00e0 pas et/ou \u00e0 augmenter le refroidissement du pilote du moteur pas \u00e0 pas. TMC signale une erreur : ... ShortToGND OU LowSideShort \u00b6 Cela indique que le pilote s'est d\u00e9sactiv\u00e9 car il a d\u00e9tect\u00e9 un courant tr\u00e8s \u00e9lev\u00e9 le traversant. Cela peut indiquer un fil desserr\u00e9 ou court-circuit\u00e9 vers le moteur pas \u00e0 pas ou dans le moteur pas \u00e0 pas lui-m\u00eame. Cette erreur peut \u00e9galement se produire si vous utilisez le mode StealthChop et que le pilote TMC n'est pas en mesure de pr\u00e9dire avec pr\u00e9cision la charge m\u00e9canique du moteur. (Si le pilote fait une mauvaise pr\u00e9diction, il peut envoyer trop de courant \u00e0 travers le moteur et d\u00e9clencher sa propre d\u00e9tection de surintensit\u00e9.) Pour tester cela, d\u00e9sactivez le mode StealthChop et v\u00e9rifiez si les erreurs continuent de se produire. TMC signale une erreur : ... reset=1(Reset) OR CS_ACTUAL=0(Reset ?) OR SE=0(Reset?) \u00b6 Cela indique que le pilote s'est r\u00e9initialis\u00e9 en cours d'impression. Cela peut \u00eatre d\u00fb \u00e0 des probl\u00e8mes de tension ou de c\u00e2blage. TMC signale une erreur : ... uv_cp=1(Sous-tension !) \u00b6 Cela indique que le pilote a d\u00e9tect\u00e9 un \u00e9v\u00e9nement de basse tension et s'est d\u00e9sactiv\u00e9. Cela peut \u00eatre d\u00fb \u00e0 des probl\u00e8mes de c\u00e2blage ou d'alimentation. Comment r\u00e9gler spreadCycle/coolStep/etc. mode sur mes pilotes ? \u00b6 Le site Web de Trinamic contient des guides sur la configuration des pilotes. Ces guides sont souvent techniques, de bas niveau et peuvent n\u00e9cessiter du mat\u00e9riel sp\u00e9cialis\u00e9. Quoi qu'il en soit, ils sont la meilleure source d'information.","title":"Pilotes de moteur pas \u00e0 pas TMC"},{"location":"TMC_Drivers.html#pilotes-de-moteur-pas-a-pas-tmc","text":"Ce document fournit des informations sur l'utilisation des pilotes de moteur pas \u00e0 pas Trinamic en mode SPI/UART sur Klipper. Klipper peut \u00e9galement utiliser les pilotes Trinamic dans leur \"mode autonome\". Cependant, lorsque les pilotes sont dans ce mode, aucune configuration sp\u00e9ciale de Klipper n'est possible et les fonctionnalit\u00e9s avanc\u00e9es de Klipper d\u00e9crites dans ce document ne sont pas disponibles. En plus de ce document, veillez \u00e0 consulter la r\u00e9f\u00e9rence de configuration du pilote TMC .","title":"Pilotes de moteur pas \u00e0 pas TMC"},{"location":"TMC_Drivers.html#reglage-du-courant-du-moteur","text":"Un courant de commande plus \u00e9lev\u00e9 augmente la pr\u00e9cision de positionnement et le couple. Cependant, un courant plus \u00e9lev\u00e9 augmente \u00e9galement la chaleur produite par le moteur pas \u00e0 pas et le pilote du moteur pas \u00e0 pas. Si le pilote du moteur pas \u00e0 pas devient trop chaud, il se d\u00e9sactivera et Klipper signalera une erreur. Si le moteur pas \u00e0 pas devient trop chaud, il perd du couple et de la pr\u00e9cision de positionnement. (S'il devient tr\u00e8s chaud, il peut \u00e9galement faire fondre les pi\u00e8ces en plastique qui y sont attach\u00e9es ou \u00e0 proximit\u00e9.) Comme conseil de r\u00e9glage g\u00e9n\u00e9ral : pr\u00e9f\u00e9rez des valeurs de courant plus \u00e9lev\u00e9es tant que le moteur pas \u00e0 pas ne chauffe pas trop et que le pilote du moteur pas \u00e0 pas ne signale pas d'avertissements ou d'erreurs. En g\u00e9n\u00e9ral, il est normal que le moteur pas \u00e0 pas soit chaud, mais il ne doit pas devenir si chaud qu'il soit douloureux au toucher.","title":"R\u00e9glage du courant du moteur"},{"location":"TMC_Drivers.html#ne-specifiez-pas-de-hold_current","text":"Si l'on configure un hold_current , le pilote TMC peut r\u00e9duire le courant vers le moteur pas \u00e0 pas lorsqu'il d\u00e9tecte que le moteur pas \u00e0 pas ne bouge pas. Cependant, la modification du courant du moteur peut elle-m\u00eame introduire un mouvement du moteur. Cela peut se produire en raison de \"forces de d\u00e9tente\" dans le moteur pas \u00e0 pas (l'aimant permanent du rotor tire vers les dents en fer du stator) ou en raison de forces externes sur le chariot d'axe. La plupart des moteurs pas \u00e0 pas ne fonctionneront pas mieux en r\u00e9duisant le courant pendant les impressions normales, car peu de mouvements d'impression laisseront un moteur pas \u00e0 pas inactif suffisamment longtemps pour activer la fonction hold_current . Et, il est peu probable que l'on veuille introduire des artefacts d'impression dans les quelques mouvements d'impression qui laissent un stepper inactif suffisamment longtemps. Si l'on souhaite r\u00e9duire le courant vers les moteurs pendant les routines de d\u00e9marrage d'impression, envisagez d'\u00e9mettre des commandes SET_TMC_CURRENT dans une MACRO START_PRINT pour ajuster le courant avant et apr\u00e8s les mouvements d'impression normaux. Certaines imprimantes avec des moteurs Z d\u00e9di\u00e9s qui sont inactifs pendant les mouvements d'impression normaux (pas de bed_mesh, pas de bed_tilt, pas de Z skew_correction, pas d'impressions en \"mode vase\", etc.) peuvent constater que les moteurs Z fonctionnent plus froid avec un hold_current . Si vous l'impl\u00e9mentez, assurez-vous de prendre en compte ce type de mouvement non command\u00e9 de l'axe Z pendant le nivellement du lit, le sondage du lit, l'\u00e9talonnage de la sonde, etc. Le driver_TPOWERDOWN et le driver_IHOLDDELAY doivent \u00e9galement \u00eatre calibr\u00e9s en cons\u00e9quence. En cas de doute, pr\u00e9f\u00e9rez ne pas sp\u00e9cifier de hold_current .","title":"Ne sp\u00e9cifiez pas de hold_current"},{"location":"TMC_Drivers.html#reglage-du-mode-spreadcycle-vs-stealthchop","text":"Par d\u00e9faut, Klipper place les pilotes TMC en mode \"spreadCycle\". Si le pilote prend en charge \"stealthChop\", il peut \u00eatre activ\u00e9 en ajoutant stealthchop_threshold : 999999 \u00e0 la section de configuration TMC. Le mode spreadCycle fournit un couple sup\u00e9rieur et une plus grande pr\u00e9cision de positionnement que le mode stealthChop. Cependant, le mode StealthChop peut produire un bruit audible nettement plus faible sur certaines imprimantes. Les tests comparant les modes ont montr\u00e9 un \"d\u00e9calage de position\" accru d'environ 75 % d'un pas complet lors de mouvements \u00e0 vitesse constante lors de l'utilisation du mode StealthChop (par exemple, sur une imprimante avec une distance de rotation de 40 mm et 200 pas_par_rotation, l'\u00e9cart de position des mouvements \u00e0 vitesse constante a augment\u00e9 de ~0,150 mm). Cependant, ce \"retard dans l'obtention de la position demand\u00e9e\" peut ne pas se manifester par un d\u00e9faut d'impression significatif et on peut pr\u00e9f\u00e9rer le comportement plus silencieux du mode StealthChop. Il est recommand\u00e9 de toujours utiliser le mode \"spreadCycle\" (en ne sp\u00e9cifiant pas stealthchop_threshold ) ou de toujours utiliser le mode \"stealthChop\" (en r\u00e9glant stealthchop_threshold sur 999999). Malheureusement, les pilotes produisent souvent des r\u00e9sultats m\u00e9diocres et erron\u00e9s si le mode est chang\u00e9 alors que le moteur tourne.","title":"R\u00e9glage du mode \"spreadCycle\" vs \"stealthChop\""},{"location":"TMC_Drivers.html#le-reglage-dinterpolation-tmc-introduit-un-petit-ecart-de-position","text":"Le param\u00e8tre interpolation du pilote TMC peut r\u00e9duire le bruit audible du mouvement de l'imprimante au prix de l'introduction d'une petite erreur de position syst\u00e9mique. Cette erreur de position syst\u00e9mique r\u00e9sulte du retard du conducteur \u00e0 ex\u00e9cuter les \"\u00e9tapes\" que Klipper lui envoie. Pendant les d\u00e9placements \u00e0 vitesse constante, ce retard entra\u00eene une erreur de position de pr\u00e8s d'un demi-micropas configur\u00e9 (plus pr\u00e9cis\u00e9ment, l'erreur est d'une demi-distance de micropas moins un 512e de distance d'un pas complet). Par exemple, sur un axe avec une rotation_distance de 40 mm, 200 pas_par_rotation et 16 micropas, l'erreur syst\u00e9mique introduite lors des mouvements \u00e0 vitesse constante est d'environ 0,006 mm. Pour une meilleure pr\u00e9cision de positionnement, envisagez d'utiliser le mode spreadCycle et d\u00e9sactivez l'interpolation (d\u00e9finissez interpolate : False dans la configuration du pilote TMC). Lorsqu'il est configur\u00e9 de cette fa\u00e7on, on peut augmenter le param\u00e8tre microstep pour r\u00e9duire le bruit audible pendant le mouvement pas \u00e0 pas. En r\u00e8gle g\u00e9n\u00e9rale, un r\u00e9glage de micropas de 64 ou 128 aura un bruit audible similaire \u00e0 celui de l'interpolation, et ce, sans introduire d'erreur de position syst\u00e9mique. Si vous utilisez le mode StealthChop, l'impr\u00e9cision de position due \u00e0 l'interpolation est faible par rapport \u00e0 l'impr\u00e9cision de position introduite \u00e0 partir du mode StealthChop. Par cons\u00e9quent, le r\u00e9glage de l'interpolation n'est pas consid\u00e9r\u00e9e comme utile en mode StealthChop, et on peut laisser l'interpolation dans son \u00e9tat par d\u00e9faut.","title":"Le r\u00e9glage d'interpolation TMC introduit un petit \u00e9cart de position"},{"location":"TMC_Drivers.html#mise-a-lorigine-sans-capteur","text":"La mise \u00e0 l'origine ans capteur permet de r\u00e9f\u00e9rencer un axe sans avoir besoin d'une fin de course physique. Au lieu de cela, le chariot sur l'axe est d\u00e9plac\u00e9 dans la limite m\u00e9canique, ce qui fait perdre des pas au moteur pas \u00e0 pas. Le pilote pas \u00e0 pas d\u00e9tecte les pas perdus et l'indique au MCU de contr\u00f4le (Klipper) en basculant une broche. Cette information peut \u00eatre utilis\u00e9e par Klipper comme fin de course pour l'axe. Ce guide couvre la configuration de la mise \u00e0 l'origine sans capteur pour l'axe X de votre imprimante (cart\u00e9sienne). Cependant, cela fonctionne de la m\u00eame mani\u00e8re avec tous les autres axes (qui n\u00e9cessitent une fin de course). Vous devez le configurer et le r\u00e9gler pour un axe \u00e0 la fois.","title":"Mise \u00e0 l'origine sans capteur"},{"location":"TMC_Drivers.html#limites","text":"Assurez-vous que vos composants m\u00e9caniques sont capables de supporter la charge du chariot heurtant \u00e0 plusieurs reprises la fin de course de l'axe. Les vis sans fin, en particulier, peuvent g\u00e9n\u00e9rer beaucoup de force. La prise d'origine d'un axe Z en \u00e9crasant la buse dans la surface d'impression n'est peut-\u00eatre pas une bonne id\u00e9e. Pour de meilleurs r\u00e9sultats, v\u00e9rifiez que le chariot de l'axe \u00e9tablit un contact lors de la mise \u00e0 l'origine. De plus, la mise \u00e0 l'origine sans capteur peut ne pas \u00eatre suffisamment pr\u00e9cise pour votre imprimante. Bien que la mise \u00e0 l'origine des axes X et Y sur une machine cart\u00e9sienne puisse bien fonctionner, la prise d'origine de l'axe Z n'est g\u00e9n\u00e9ralement pas assez pr\u00e9cise et peut entra\u00eener une hauteur de premi\u00e8re couche incoh\u00e9rente. Le r\u00e9f\u00e9rencement d'une imprimante delta sans capteur n'est pas conseill\u00e9 en raison du manque de pr\u00e9cision. De plus, la d\u00e9tection de d\u00e9crochage du pilote pas \u00e0 pas d\u00e9pend de la charge m\u00e9canique sur le moteur, du courant du moteur et de la temp\u00e9rature du moteur (r\u00e9sistance de la bobine). La mise \u00e0 l'origine sans capteur fonctionne mieux \u00e0 des vitesses de moteur moyennes. Pour des vitesses tr\u00e8s lentes (moins de 10 tr/min), le moteur ne g\u00e9n\u00e8re pas de force contre-\u00e9lectromotrice significative et le TMC ne peut pas d\u00e9tecter de mani\u00e8re fiable les calages du moteur. A des vitesses tr\u00e8s \u00e9lev\u00e9es, la force contre-\u00e9lectromotrice du moteur se rapproche de la tension d'alimentation du moteur, de sorte que le TMC ne peut plus d\u00e9tecter les calages. Il est conseill\u00e9 de consulter la fiche technique de vos TMC sp\u00e9cifiques. Vous y trouverez \u00e9galement plus de d\u00e9tails sur les limites de cette configuration.","title":"Limites"},{"location":"TMC_Drivers.html#conditions-prealables","text":"Quelques pr\u00e9requis sont n\u00e9cessaires pour utiliser la mise \u00e0 l'origine sans capteur : Un pilote pas \u00e0 pas TMC compatible stallGuard (tmc2130, tmc2209, tmc2660 ou tmc5160). Interface SPI/UART du driver TMC c\u00e2bl\u00e9 au micro-contr\u00f4leur (le mode autonome ne fonctionne pas). La broche \"DIAG\" ou \"SG_TST\" appropri\u00e9e du pilote TMC doit \u00eatre connect\u00e9e au microcontr\u00f4leur. Les \u00e9tapes du document v\u00e9rification de la configuration doivent \u00eatre ex\u00e9cut\u00e9es pour confirmer que les moteurs pas \u00e0 pas sont configur\u00e9s et fonctionnent correctement.","title":"Conditions pr\u00e9alables"},{"location":"TMC_Drivers.html#reglages","text":"La proc\u00e9dure d\u00e9crite ici comporte six \u00e9tapes principales : Choisissez une vitesse de mise \u00e0 l'origine. Configurez le fichier printer.cfg pour activer la mise \u00e0 l'origine sans capteur. Trouvez le meilleur r\u00e9glage anti-d\u00e9crochage avec la sensibilit\u00e9 la plus \u00e9lev\u00e9e. Trouvez le r\u00e9glage anti-d\u00e9crochage avec la sensibilit\u00e9 la plus faible qui fonctionne avec une seule touche en fin de course. Mettez \u00e0 jour le fichier printer.cfg avec le param\u00e8tre anti-d\u00e9crochage souhait\u00e9. Cr\u00e9ez ou mettez \u00e0 jour les macros dans printer.cfg pour une mise \u00e0 l'origine r\u00e9p\u00e9table.","title":"R\u00e9glages"},{"location":"TMC_Drivers.html#choisir-la-vitesse-de-prise-dorigine","text":"La vitesse de mise \u00e0 l'origine est importante lors de la r\u00e9alisation d'une mise \u00e0 l'origine sans capteur. Il est souhaitable d'utiliser une vitesse de prise d'origine lente afin que le chariot n'exerce pas de force excessive sur le ch\u00e2ssis lorsqu'il entre en contact avec l'extr\u00e9mit\u00e9 du rail. Cependant, les pilotes TMC ne peuvent pas d\u00e9tecter de mani\u00e8re fiable un d\u00e9crochage \u00e0 des vitesses tr\u00e8s lentes. Un bon point de d\u00e9part pour la vitesse de prise d'origine est que le moteur pas \u00e0 pas effectue une rotation compl\u00e8te toutes les deux secondes. Pour de nombreux axes, ce sera la distance rotation_distance divis\u00e9e par deux. Par example\u202f: [stepper_x] rotation_distance: 40 homing_speed: 20 ...","title":"Choisir la vitesse de prise d'origine"},{"location":"TMC_Drivers.html#configurer-printercfg-pour-une-mise-a-lorigine-sans-capteur","text":"Le param\u00e8tre homing_retract_dist doit \u00eatre d\u00e9fini sur z\u00e9ro dans la section de configuration stepper_x pour d\u00e9sactiver le deuxi\u00e8me mouvement de mise \u00e0 l'origine. La deuxi\u00e8me tentative de mise \u00e0 l'origine n'ajoute pas de valeur lors de l'utilisation d'une mise \u00e0 l'origine sans capteur, elle ne fonctionnera pas de mani\u00e8re fiable et introduira des erreurs dans le processus de r\u00e9glage. Assurez-vous que le param\u00e8tre hold_current n\u2019est pas sp\u00e9cifi\u00e9 dans la section Pilote TMC de la configuration. (Si un hold_current est r\u00e9gl\u00e9, le moteur s\u2019arr\u00eate lorsque le chariot est appuy\u00e9 contre l\u2019extr\u00e9mit\u00e9 du rail, et la r\u00e9duction du courant dans cette position peut entra\u00eener le d\u00e9placement du chariot - ce qui entra\u00eenera de mauvaises performances et perturbera le processus de r\u00e9glage.) Il est n\u00e9cessaire de configurer les broches du TMC pour le mode sans capteur et de configurer les param\u00e8tres initiaux de \u00ab Stallguard \u00bb. Un exemple de configuration tmc2209 pour un axe X pourrait ressembler \u00e0 : [tmc2209 stepper_x] diag_pin: ^PA1 # D\u00e9finit pour le MCU, la broche TMC DIAG driver_SGTHRS: 255 # 255 est la valeur la plus sensible, 0 la moins sensible ... [stepper_x] endstop_pin: tmc2209_stepper_x:virtual_endstop homing_retract_dist: 0 ... Un exemple de configuration de tmc2130 ou tmc5160 pourrait ressembler \u00e0 : [tmc2130 stepper_x] diag1_pin: ^!PA1 # Broche connect\u00e9e \u00e0 TMC DIAG1 (ou utilisez diag0_pin / DIAG0 pin) driver_SGT: -64 # -64 est la valeur la plus sensible, 63 est moins sensible ... [stepper_x] endstop_pin: tmc2130_stepper_x:virtual_endstop homing_retract_dist: 0 ... Un exemple de configuration de tmc2660 pourrait ressembler \u00e0 : [tmc2660 stepper_x] driver_SGT: -64 # -64 est la valeur la plus sensible,, 63 est moins sensible ... [stepper_x] endstop_pin: ^PA1 # Broche connect\u00e9e \u00e0 TMC SG_TST homing_retract_dist: 0 ... Les exemples ci-dessus ne montrent que les param\u00e8tres sp\u00e9cifiques \u00e0 la mise \u00e0 l'origine sans capteur. Voir la r\u00e9f\u00e9rence de configuration pour toutes les options disponibles.","title":"Configurer 'printer.cfg' pour une mise \u00e0 l'origine sans capteur"},{"location":"TMC_Drivers.html#trouvez-la-sensibilite-la-plus-elevee-qui-fonctionne-avec-succes","text":"Placez le chariot pr\u00e8s du centre du rail. Utilisez la commande SET_TMC_FIELD pour d\u00e9finir la sensibilit\u00e9 la plus \u00e9lev\u00e9e. Pour un tmc2209 : SET_TMC_FIELD STEPPER=stepper_x FIELD=SGTHRS VALUE=255 Pour un tmc2130, tmc5160 et tmc2660 : SET_TMC_FIELD STEPPER=stepper_x FIELD=sgt VALUE=-64 \u00c9mettez ensuite une commande G28 X0 et v\u00e9rifiez que l'axe ne bouge pas du tout ou s'arr\u00eate rapidement. Si l'axe ne s'arr\u00eate pas, \u00e9mettez un M112 pour arr\u00eater l'imprimante - quelque chose n'est pas correct avec le c\u00e2blage ou la configuration de la broche diag/sg_tst et ce doit \u00eatre corrig\u00e9 avant de continuer. Ensuite, diminuez continuellement la sensibilit\u00e9 du param\u00e8tre VALUE et ex\u00e9cutez \u00e0 nouveau les commandes SET_TMC_FIELD G28 X0 pour trouver la sensibilit\u00e9 la plus \u00e9lev\u00e9e qui permet au chariot de se d\u00e9placer et de s'arr\u00eater en but\u00e9e. (Pour les pilotes tmc2209, cela diminuera SGTHRS, pour les autres pilotes, cela augmentera sgt.). Il devrait \u00eatre possible de trouver la sensibilit\u00e9 la plus \u00e9lev\u00e9e et fiable (les r\u00e9glages avec une sensibilit\u00e9 plus \u00e9lev\u00e9e entra\u00eenant peu ou pas de mouvement). Notez la valeur trouv\u00e9e comme maximum_sensitivity . (Si la sensibilit\u00e9 minimale possible (SGTHRS = 0 ou sgt = 63) est obtenue sans aucun mouvement du chariot, alors quelque chose ne fonctionne pas aun niveau c\u00e2blage ou configuration de la broche diag/sg_tst et il faut corriger le probl\u00e8me avant de continuer.) Lors de la recherche de maximum_sensitivity, il peut \u00eatre pratique de passer \u00e0 diff\u00e9rents param\u00e8tres VALUE (travaillez le param\u00e8tre VALUE par dichotomie pour plus d'efficacit\u00e9). Si vous proc\u00e9dez ainsi, pr\u00e9parez-vous \u00e0 \u00e9mettre une commande M112 pour arr\u00eater l'imprimante, car un r\u00e9glage avec une sensibilit\u00e9 trop faible peut entra\u00eener un \"cognement\" r\u00e9p\u00e9t\u00e9 de l'axe contre l'extr\u00e9mit\u00e9 du rail. Assurez-vous d'attendre quelques secondes entre chaque tentative de prise d'origine. Une fois que le pilote TMC a d\u00e9tect\u00e9 un d\u00e9crochage, il peut lui falloir un peu de temps pour effacer son indicateur interne et \u00eatre capable de d\u00e9tecter un autre d\u00e9crochage. Au cours de ces tests de r\u00e9glage, si une commande G28 X0 ne se d\u00e9place pas jusqu'\u00e0 la limite d'axe, soyez prudent lorsque vous ex\u00e9cutez des commandes de mouvement 'normales' (par exemple, G1 ). Klipper ne sachant pas ou est le chariot, une commande de d\u00e9placement pourra entra\u00eener des r\u00e9sultats ind\u00e9sirables.","title":"Trouvez la sensibilit\u00e9 la plus \u00e9lev\u00e9e qui fonctionne avec succ\u00e8s"},{"location":"TMC_Drivers.html#trouver-la-sensibilite-la-plus-basse-qui-permette-la-mise-a-lorigine-en-une-seule-fois","text":"Lors de la mise \u00e0 l'origine avec la valeur maximum_sensitivity , l'axe doit se d\u00e9placer jusqu'\u00e0 l'extr\u00e9mit\u00e9 du rail et s'arr\u00eater avec un \u00ab simple toucher \u00bb - c'est-\u00e0-dire qu'il ne doit pas y avoir de \u00ab clic \u00bb ou de \u00ab claquement \u00bb. (S'il y a un bruit de claquement ou de clic \u00e0 la sensibilit\u00e9 maximale, la vitesse de mise \u00e0 l'origine est peut-\u00eatre trop faible, le courant du pilote peut \u00eatre trop faible ou la mise \u00e0 l'origine sans capteur n'est peut-\u00eatre pas un bon choix pour cet axe.) L'\u00e9tape suivante consiste \u00e0 nouveau \u00e0 d\u00e9placer le chariot vers une position proche du centre du rail, \u00e0 diminuer la sensibilit\u00e9 et \u00e0 ex\u00e9cuter les commandes SET_TMC_FIELD G28 X0 - l'objectif est maintenant de trouver la sensibilit\u00e9 la plus faible qui permette au chariot de se mettre \u00e0 l'origine correctement avec une \"simple touche\". C'est-\u00e0-dire qu'il ne \"cogne\" pas ou ne \"clique\" pas lorsqu'il entre en contact avec l'extr\u00e9mit\u00e9 du rail. Notez la valeur trouv\u00e9e comme minimum_sensitivity .","title":"Trouver la sensibilit\u00e9 la plus basse qui permette la mise \u00e0 l'origine en une seule fois"},{"location":"TMC_Drivers.html#mettez-a-jour-printercfg-avec-la-valeur-de-sensibilite","text":"Apr\u00e8s avoir trouv\u00e9 maximum_sensitivity et minimum_sensitivity , utilisez une calculatrice pour obtenir la sensibilit\u00e9 recommand\u00e9e : minimum_sensitivity + (maximum_sensitivity - minimum_sensitivity)/3 . La sensibilit\u00e9 recommand\u00e9e doit \u00eatre comprise entre le minimum et le maximum, mais l\u00e9g\u00e8rement plus proche du minimum. Arrondissez la valeur finale \u00e0 la valeur enti\u00e8re la plus proche. Pour un tmc2209, d\u00e9finissez-le dans la configuration en tant que driver_SGTHRS , pour les autres pilotes TMC, d\u00e9finissez-le dans la configuration en tant que driver_SGT . Si la plage entre maximum_sensitivity et minimum_sensitivity est petite (par exemple, inf\u00e9rieure \u00e0 5), cela peut entra\u00eener une mise \u00e0 l'origine instable. Une vitesse de mise \u00e0 l'origine plus rapide peut rendre l'op\u00e9ration plus stable. Notez que si une modification est apport\u00e9e au courant du pilote, \u00e0 la vitesse de prise d'origine ou si une modification notable est apport\u00e9e au mat\u00e9riel de l'imprimante, il sera alors n\u00e9cessaire de refaire le processus de r\u00e9glage.","title":"Mettez \u00e0 jour printer.cfg avec la valeur de sensibilit\u00e9"},{"location":"TMC_Drivers.html#utilisation-de-macros-lors-de-la-mise-a-lorigine","text":"Une fois la mise \u00e0 l'origine sans capteur termin\u00e9e, le chariot sera appuy\u00e9 contre l'extr\u00e9mit\u00e9 du rail et le stepper exercera une force sur le cadre tant que le chariot ne sera pas \u00e9loign\u00e9 de la fin de course. Il est pr\u00e9f\u00e9rable de cr\u00e9er une macro pour positionner l'axe en but\u00e9e et l'\u00e9loigner imm\u00e9diatement de l'extr\u00e9mit\u00e9 du rail. Il est pr\u00e9f\u00e9rable, dans la macro, de faire une pause d'au moins 2 secondes avant de commencer la prise d'origine sans capteur (ou de s'assurer qu'il n'y a eu aucun mouvement sur le moteur pas \u00e0 pas depuis au moins 2 secondes). Sans d\u00e9lai, il est possible que le drapeau de d\u00e9crochage interne du pilote de moteur pas \u00e0 pas soit toujours activ\u00e9 suite \u00e0 un mouvement pr\u00e9c\u00e9dent. Il peut \u00e9galement \u00eatre utile que cette macro d\u00e9finisse le courant du pilote avant la prise d'origine et d\u00e9finisse un nouveau courant apr\u00e8s que le chariot s'est \u00e9loign\u00e9. Un exemple de macro pourrait ressembler \u00e0 : [gcode_macro SENSORLESS_HOME_X] gcode: {% set HOME_CUR = 0.700 %} {% set driver_config = printer.configfile.settings['tmc2209 stepper_x'] %} {% set RUN_CUR = driver_config.run_current %} # D\u00e9finir le courant pour la mise \u00e0 l'origine sans capteur SET_TMC_CURRENT STEPPER=stepper_x CURRENT={HOME_CUR} # Petit pause pour attendre que le drapeau stall flag soit d\u00e9sactiv\u00e9 G4 P2000 # mise \u00e0 l'origine G28 X0 # D\u00e9placement G90 G1 X5 F1200 # Remise du courant d'impression SET_TMC_CURRENT STEPPER=stepper_x CURRENT={RUN_CUR} La macro peut \u00eatre appel\u00e9e depuis une section de configuration homing_override ou depuis une macro START_PRINT . Notez que si le courant du pilote pas \u00e0 pas lors de la mise \u00e0 l'origine est modifi\u00e9, le processus de r\u00e9glage doit \u00eatre enti\u00e8rement refait.","title":"Utilisation de macros lors de la mise \u00e0 l'origine"},{"location":"TMC_Drivers.html#conseils-pour-la-mise-a-lorigine-sans-capteur-sur-corexy","text":"Il est possible d'utiliser la mise \u00e0 l'origine sans capteur sur les chariots X et Y d'une imprimante CoreXY. Klipper utilise le stepper [stepper_x] pour d\u00e9tecter les d\u00e9crochages lors de la mise \u00e0 l'origine du chariot X et utilise le stepper [stepper_y] pour d\u00e9tecter les d\u00e9crochages lors de la mise \u00e0 l'origine du chariot Y. Utilisez le guide de r\u00e9glage d\u00e9crit ci-dessus pour trouver la \"sensibilit\u00e9 au d\u00e9crochage\" appropri\u00e9e pour chaque chariot, mais soyez conscient des restrictions suivantes : Lors de l'utilisation de la prise d'origine sans capteur sur CoreXY, assurez-vous qu'aucun hold_current n'est configur\u00e9 pour l'un ou l'autre des moteurs pas \u00e0 pas. Pendant le r\u00e9glage, assurez-vous que les chariots X et Y sont proches du centre de leurs rails avant chaque tentative de mise \u00e0 l'origine. Une fois les r\u00e9glages termin\u00e9s, lors de la prise d'origine de X et Y, utilisez des macros pour vous assurer qu'un axe est pris en charge en premier, puis \u00e9loignez ce chariot de la fin de course de l'axe, faites une pause d'au moins 2 secondes, puis d\u00e9marrez la prise d'origine de l'autre axe. L'\u00e9loignement de l'axe \u00e9vite le r\u00e9f\u00e9rencement d'un axe alors que l'autre est plaqu\u00e9 contre la fin de course (ce qui peut fausser la d\u00e9tection de d\u00e9crochage). La pause est n\u00e9cessaire pour s'assurer que le drapeau de d\u00e9crochage du pilote pas \u00e0 pas est effac\u00e9 avant de se d\u00e9placer \u00e0 nouveau. Un exemple de macro de r\u00e9f\u00e9rencement CoreXY pourrait ressembler \u00e0 : [gcode_macro HOME] gcode: G90 # mise \u00e0 l'origine Z G28 Z0 G1 Z10 F1200 # mise \u00e0 l'origine Y G28 Y0 G1 Y5 F1200 # mise \u00e0 l'origine X G4 P2000 G28 X0 G1 X5 F1200","title":"Conseils pour la mise \u00e0 l'origine sans capteur sur CoreXY"},{"location":"TMC_Drivers.html#interroger-et-diagnostiquer-les-informations-du-pilote-pas-a-pas","text":"La ` commande DUMP_TMC est un outil utile lors de la configuration et du diagnostic des pilotes. Il signalera tous les champs configur\u00e9s par Klipper ainsi que tous les champs pouvant \u00eatre interrog\u00e9s \u00e0 partir du pilote. Tous les champs signal\u00e9s sont d\u00e9finis dans la fiche technique de Trinamic pour chaque pilote. Ces fiches techniques sont disponibles sur le site Internet de Trinamic . Obtenez et examinez la fiche technique de Trinamic du pilote pas \u00e0 pas afin d'interpr\u00e9ter correctement les r\u00e9sultats d'un DUMP_TMC.","title":"Interroger et diagnostiquer les informations du pilote pas \u00e0 pas"},{"location":"TMC_Drivers.html#configuration-des-parametres-dun-driver_xxx","text":"Klipper prend en charge la configuration de nombreux param\u00e8tres de bas niveau pour les pilotes de moteurs pas \u00e0 pas \u00e0 l'aide des param\u00e8tres de la section driver_XXX . La r\u00e9f\u00e9rence de configuration du pilote TMC contient la liste compl\u00e8te des param\u00e8tres disponibles pour chaque type de pilote. De plus, presque tous les champs peuvent \u00eatre modifi\u00e9s au moment de l'ex\u00e9cution \u00e0 l'aide de la commande SET_TMC_FIELD . Chacun de ces param\u00e8tres est d\u00e9fini dans la fiche technique de Trinamic pour chaque pilote. Ces fiches techniques sont disponibles sur le site Internet de Trinamic . Les fiches techniques de Trinamic utilisent parfois une formulation qui peut confondre un param\u00e8tre de haut niveau (tel que \"fin d'hyst\u00e9r\u00e9sis\") avec une valeur de param\u00e8tre de bas niveau (par exemple, \"HEND\"). Dans Klipper, driver_XXX et SET_TMC_FIELD d\u00e9finissent toujours la valeur de param\u00e8tres de bas niveau (celles qui sontt r\u00e9ellement \u00e9crite dans le pilote). Ainsi, par exemple, si la fiche technique Trinamic indique qu'une valeur de 3 doit \u00eatre \u00e9crite dans le champ HEND pour obtenir une \"fin d'hyst\u00e9r\u00e9sis\" de 0, alors d\u00e9finissez driver_HEND=3 pour obtenir une valeur de haut niveau de 0.","title":"Configuration des param\u00e8tres d'un 'driver_XXX'"},{"location":"TMC_Drivers.html#questions-courantes","text":"","title":"Questions courantes"},{"location":"TMC_Drivers.html#puis-je-utiliser-le-mode-stealthchop-sur-une-extrudeuse-avec-avance-de-pression","text":"Beaucoup de gens utilisent avec succ\u00e8s le mode \"stealthChop\" avec l'avance de pression de Klipper. Klipper impl\u00e9mente avance de pression \"adoucie\" qui n'introduit aucun changement de vitesse instantan\u00e9. Cependant, le mode \"stealthChop\" peut produire un couple moteur plus faible et/ou produire une chaleur moteur plus \u00e9lev\u00e9e. Il peut s'agir ou non d'un mode utilisable avec votre imprimante.","title":"Puis-je utiliser le mode StealthChop sur une extrudeuse avec avance de pression\u00a0?"},{"location":"TMC_Drivers.html#jai-des-erreurs-unable-to-read-tmc-uart-stepper_x-register-ifcnt","text":"Cela se produit lorsque Klipper est incapable de communiquer avec un pilote tmc2208 ou tmc2209. Assurez-vous que l'alimentation du moteur est activ\u00e9e, car le pilote du moteur pas \u00e0 pas a g\u00e9n\u00e9ralement besoin de l'alimentation du moteur avant de pouvoir communiquer avec le micro-contr\u00f4leur. Si cette erreur se produit apr\u00e8s avoir flash\u00e9 Klipper pour la premi\u00e8re fois, le pilote pas \u00e0 pas peut avoir \u00e9t\u00e9 pr\u00e9c\u00e9demment programm\u00e9 dans un \u00e9tat qui n'est pas compatible avec Klipper. Pour r\u00e9initialiser l'\u00e9tat, coupez toute alimentation de l'imprimante pendant plusieurs secondes (d\u00e9branchez physiquement les prises USB et d'alimentation). Sinon, cette erreur est souvent due \u00e0 un c\u00e2blage incorrect des broche UART ou d'une configuration incorrecte des param\u00e8tres de broche UART dans Klipper.","title":"J'ai des erreurs \"Unable to read tmc uart 'stepper_x' register IFCNT\" ?"},{"location":"TMC_Drivers.html#jai-des-erreurs-unable-to-write-tmc-spi-stepper_x-register","text":"Cela se produit lorsque Klipper est incapable de communiquer avec un pilote tmc2130 ou tmc5160. Assurez-vous que l'alimentation du moteur est activ\u00e9e, car le pilote du moteur pas \u00e0 pas a g\u00e9n\u00e9ralement besoin de l'alimentation du moteur avant de pouvoir communiquer avec le micro-contr\u00f4leur. Cette erreur est souvent due \u00e0 un c\u00e2blage SPI incorrect, \u00e0 une configuration incorrecte des param\u00e8tres SPI de Klipper ou d'une configuration incompl\u00e8te des p\u00e9riph\u00e9riques sur un bus SPI. Si le pilote se trouve sur un bus SPI partag\u00e9 avec plusieurs p\u00e9riph\u00e9riques, assurez-vous de configurer - dans Klipper - chaque p\u00e9riph\u00e9rique sur ce bus SPI. Si un appareil sur un bus SPI partag\u00e9 n'est pas configur\u00e9, il peut r\u00e9pondre de mani\u00e8re incorrecte \u00e0 des commandes qui ne lui sont pas destin\u00e9es et corrompre la communication avec l'appareil pr\u00e9vu. S'il y a un appareil sur un bus SPI partag\u00e9 qui ne peut pas \u00eatre configur\u00e9 dans Klipper, utilisez la section de configuration static_digital_output pour r\u00e9gler la broche CS de l'appareil inutilis\u00e9 \u00e0 un niveau \u00e9lev\u00e9 (afin qu'il n'essaie pas d'utiliser le bus SPI). Le sch\u00e9ma de la carte est une r\u00e9f\u00e9rence utile (ndt et n\u00e9cessaire) pour trouver les p\u00e9riph\u00e9riques qui se trouvent sur un bus SPI et leurs broches associ\u00e9es.","title":"J'ai des erreurs \"Unable to write tmc spi 'stepper_x' register ...\" ?"},{"location":"TMC_Drivers.html#pourquoi-ai-je-une-erreur-tmc-reports-error","text":"Ce type d'erreur indique que le pilote TMC a d\u00e9tect\u00e9 un probl\u00e8me et s'est d\u00e9sactiv\u00e9. C'est-\u00e0-dire que le pilote de moteur pas \u00e0 pas a cess\u00e9 de maintenir sa position et a ignor\u00e9 les commandes de mouvement. Si Klipper d\u00e9tecte qu'un pilote actif s'est d\u00e9sactiv\u00e9, il fera passer l'imprimante dans un \u00e9tat \"arr\u00eat\". Il est \u00e9galement possible qu'un arr\u00eat TMC reports error se produise en raison d'erreurs SPI qui emp\u00eachent la communication avec le pilote (sur les tmc2130, tmc5160 ou tmc2660). Si cela se produit, il est fr\u00e9quent que l'\u00e9tat du pilote indiqu\u00e9 affiche 00000000 ou ffffffff - par exemple : TMC reports error : DRV_STATUS : ffffffff ... OU [ X316X]TMC reports error : READRSP@RDSEL2 : 00000000 ...`. Une telle d\u00e9faillance peut \u00eatre due \u00e0 un probl\u00e8me de c\u00e2blage SPI ou \u00e0 une r\u00e9initialisation automatique ou \u00e0 une d\u00e9faillance du pilote TMC. Quelques erreurs courantes et conseils pour les diagnostiquer :","title":"Pourquoi ai-je une erreur \"TMC reports error\u202f: ...\"\u202f?"},{"location":"TMC_Drivers.html#tmc-signale-une-erreur-ot1overtemperror","text":"Cela indique que le pilote du moteur s'est d\u00e9sactiv\u00e9 car il est en surchauffe. Les solutions typiques consistent \u00e0 diminuer le courant du pilote de moteur pas \u00e0 pas, \u00e0 augmenter le refroidissement du pilote du moteur pas \u00e0 pas et/ou \u00e0 augmenter le refroidissement du pilote du moteur pas \u00e0 pas.","title":"TMC signale une erreur\u00a0: ... ot=1(OvertempError\u00a0!)"},{"location":"TMC_Drivers.html#tmc-signale-une-erreur-shorttognd-ou-lowsideshort","text":"Cela indique que le pilote s'est d\u00e9sactiv\u00e9 car il a d\u00e9tect\u00e9 un courant tr\u00e8s \u00e9lev\u00e9 le traversant. Cela peut indiquer un fil desserr\u00e9 ou court-circuit\u00e9 vers le moteur pas \u00e0 pas ou dans le moteur pas \u00e0 pas lui-m\u00eame. Cette erreur peut \u00e9galement se produire si vous utilisez le mode StealthChop et que le pilote TMC n'est pas en mesure de pr\u00e9dire avec pr\u00e9cision la charge m\u00e9canique du moteur. (Si le pilote fait une mauvaise pr\u00e9diction, il peut envoyer trop de courant \u00e0 travers le moteur et d\u00e9clencher sa propre d\u00e9tection de surintensit\u00e9.) Pour tester cela, d\u00e9sactivez le mode StealthChop et v\u00e9rifiez si les erreurs continuent de se produire.","title":"TMC signale une erreur\u00a0: ... ShortToGND OU LowSideShort"},{"location":"TMC_Drivers.html#tmc-signale-une-erreur-reset1reset-or-cs_actual0reset-or-se0reset","text":"Cela indique que le pilote s'est r\u00e9initialis\u00e9 en cours d'impression. Cela peut \u00eatre d\u00fb \u00e0 des probl\u00e8mes de tension ou de c\u00e2blage.","title":"TMC signale une erreur\u00a0: ... reset=1(Reset) OR CS_ACTUAL=0(Reset\u00a0?) OR SE=0(Reset?)"},{"location":"TMC_Drivers.html#tmc-signale-une-erreur-uv_cp1sous-tension","text":"Cela indique que le pilote a d\u00e9tect\u00e9 un \u00e9v\u00e9nement de basse tension et s'est d\u00e9sactiv\u00e9. Cela peut \u00eatre d\u00fb \u00e0 des probl\u00e8mes de c\u00e2blage ou d'alimentation.","title":"TMC signale une erreur\u00a0: ... uv_cp=1(Sous-tension\u00a0!)"},{"location":"TMC_Drivers.html#comment-regler-spreadcyclecoolstepetc-mode-sur-mes-pilotes","text":"Le site Web de Trinamic contient des guides sur la configuration des pilotes. Ces guides sont souvent techniques, de bas niveau et peuvent n\u00e9cessiter du mat\u00e9riel sp\u00e9cialis\u00e9. Quoi qu'il en soit, ils sont la meilleure source d'information.","title":"Comment r\u00e9gler spreadCycle/coolStep/etc. mode sur mes pilotes\u00a0?"},{"location":"TSL1401CL_Filament_Width_Sensor.html","text":"Capteur de largeur de filament TSL1401CL \u00b6 Ce document d\u00e9crit le module h\u00f4te du capteur de largeur de filament. Le mat\u00e9riel utilis\u00e9 pour d\u00e9velopper ce module h\u00f4te est bas\u00e9 sur le r\u00e9seau de capteurs lin\u00e9aires TSL1401CL, mais il peut fonctionner avec tout r\u00e9seau de capteurs ayant une sortie analogique. Vous pouvez trouver les conceptions sur Thingiverse . Pour utiliser un r\u00e9seau de capteurs comme capteur de largeur de filament, consultez Config Reference et documentation G-Code . Comment cela fonctionne-t-il ? \u00b6 Le capteur g\u00e9n\u00e8re une sortie analogique bas\u00e9e sur la largeur calcul\u00e9e du filament. La tension de sortie est toujours \u00e9gale \u00e0 la largeur de filament d\u00e9tect\u00e9e (ex. 1,65v, 1,70v, 3,0v). Le module h\u00f4te surveille les changements de tension et ajuste le multiplicateur d'extrusion. Note : \u00b6 Les lectures du capteur sont effectu\u00e9es par d\u00e9faut avec des intervalles de 10 mm. Si n\u00e9cessaire, vous pouvez modifier ce param\u00e8tre en modifiant le param\u00e8tre MEASUREMENT_INTERVAL_MM dans le fichier filament_width_sensor.py .","title":"Capteur de largeur de filament TSL1401CL"},{"location":"TSL1401CL_Filament_Width_Sensor.html#capteur-de-largeur-de-filament-tsl1401cl","text":"Ce document d\u00e9crit le module h\u00f4te du capteur de largeur de filament. Le mat\u00e9riel utilis\u00e9 pour d\u00e9velopper ce module h\u00f4te est bas\u00e9 sur le r\u00e9seau de capteurs lin\u00e9aires TSL1401CL, mais il peut fonctionner avec tout r\u00e9seau de capteurs ayant une sortie analogique. Vous pouvez trouver les conceptions sur Thingiverse . Pour utiliser un r\u00e9seau de capteurs comme capteur de largeur de filament, consultez Config Reference et documentation G-Code .","title":"Capteur de largeur de filament TSL1401CL"},{"location":"TSL1401CL_Filament_Width_Sensor.html#comment-cela-fonctionne-t-il","text":"Le capteur g\u00e9n\u00e8re une sortie analogique bas\u00e9e sur la largeur calcul\u00e9e du filament. La tension de sortie est toujours \u00e9gale \u00e0 la largeur de filament d\u00e9tect\u00e9e (ex. 1,65v, 1,70v, 3,0v). Le module h\u00f4te surveille les changements de tension et ajuste le multiplicateur d'extrusion.","title":"Comment cela fonctionne-t-il ?"},{"location":"TSL1401CL_Filament_Width_Sensor.html#note","text":"Les lectures du capteur sont effectu\u00e9es par d\u00e9faut avec des intervalles de 10 mm. Si n\u00e9cessaire, vous pouvez modifier ce param\u00e8tre en modifiant le param\u00e8tre MEASUREMENT_INTERVAL_MM dans le fichier filament_width_sensor.py .","title":"Note :"},{"location":"Using_PWM_Tools.html","text":"Utilisation des outils PWM \u00b6 Ce document d\u00e9crit comment configurer un laser ou une broche contr\u00f4l\u00e9e par PWM en utilisant output_pin et quelques macros. Comment \u00e7a marche ? \u00b6 En r\u00e9-utilisant la sortie pwm du ventilateur de la t\u00eate d'impression, vous pouvez contr\u00f4ler des lasers ou des broches. Ceci est utile si vous utilisez des t\u00eates d'impression commutables, par exemple le changeur d'outils E3D ou une solution DIY. Habituellement, les outils \u00e0 came tels que LaserWeb peuvent \u00eatre configur\u00e9s pour utiliser les commandes M3-M5 , qui correspondent \u00e0 vitesse de broche CW ( M3 S[0-255] ), vitesse de broche CCW ( M4 S[0-255] ) et arr\u00eat de broche ( M5 ). Avertissement : Lorsque vous pilotez un laser, prenez toutes les pr\u00e9cautions de s\u00e9curit\u00e9 auxquelles vous pouvez penser ! Les lasers \u00e0 diodes sont g\u00e9n\u00e9ralement invers\u00e9s. Cela signifie que lorsque l'unit\u00e9 centrale red\u00e9marre, le laser sera compl\u00e8tement allum\u00e9 pendant le temps n\u00e9cessaire \u00e0 l'unit\u00e9 centrale pour red\u00e9marrer. Pour faire bonne mesure, il est recommand\u00e9 de toujours porter des lunettes laser appropri\u00e9es de la bonne longueur d'onde si le laser est aliment\u00e9 ; et de d\u00e9connecter le laser lorsqu'il n'est pas n\u00e9cessaire. Vous devriez \u00e9galement configurer un d\u00e9lai de s\u00e9curit\u00e9, de sorte que lorsque votre h\u00f4te ou votre MCU rencontre une erreur, l'outil s'arr\u00eate. Pour un exemple de configuration, voir config/sample-pwm-tool.cfg . Limites actuelles \u00b6 La fr\u00e9quence des mises \u00e0 jour PWM est limit\u00e9e. Bien qu'elle soit tr\u00e8s pr\u00e9cise, une mise \u00e0 jour PWM ne peut se produire que toutes les 0,1 seconde, ce qui la rend presque inutile pour la gravure tram\u00e9e. Cependant, il existe une branche exp\u00e9rimentale avec ses propres compromis. A long terme, il est pr\u00e9vu d'ajouter cette fonctionnalit\u00e9 au klipper principal. Commandes \u00b6 M3/M4 S<valeur> : D\u00e9finit le cycle de travail PWM. Valeurs comprises entre 0 et 255. M5 : Arr\u00eate la sortie PWM \u00e0 la valeur d'arr\u00eat. Configuration de Laserweb \u00b6 Si vous utilisez Laserweb, une configuration fonctionnelle serait la suivante : GCODE START : M5 ; D\u00e9sactiver le laser G21 ; D\u00e9finir les unit\u00e9s en mm G90 ; Positionnement absolu G0 Z0 F7000 ; R\u00e9gler la vitesse de non coupe GCODE END : M5 ; D\u00e9sactiver le laser G91 ; relatif G0 Z+20 F4000 ; G90 ; absolu GCODE HOMING : M5 ; D\u00e9sactiver le laser G28 ; D\u00e9placement sur tous les axes TOOL ON : M3 $INTENSIT\u00c9 TOOL OFF : M5 ; D\u00e9sactiver le laser INTENSIT\u00c9 DU LASER : S","title":"Utilisation des outils PWM"},{"location":"Using_PWM_Tools.html#utilisation-des-outils-pwm","text":"Ce document d\u00e9crit comment configurer un laser ou une broche contr\u00f4l\u00e9e par PWM en utilisant output_pin et quelques macros.","title":"Utilisation des outils PWM"},{"location":"Using_PWM_Tools.html#comment-ca-marche","text":"En r\u00e9-utilisant la sortie pwm du ventilateur de la t\u00eate d'impression, vous pouvez contr\u00f4ler des lasers ou des broches. Ceci est utile si vous utilisez des t\u00eates d'impression commutables, par exemple le changeur d'outils E3D ou une solution DIY. Habituellement, les outils \u00e0 came tels que LaserWeb peuvent \u00eatre configur\u00e9s pour utiliser les commandes M3-M5 , qui correspondent \u00e0 vitesse de broche CW ( M3 S[0-255] ), vitesse de broche CCW ( M4 S[0-255] ) et arr\u00eat de broche ( M5 ). Avertissement : Lorsque vous pilotez un laser, prenez toutes les pr\u00e9cautions de s\u00e9curit\u00e9 auxquelles vous pouvez penser ! Les lasers \u00e0 diodes sont g\u00e9n\u00e9ralement invers\u00e9s. Cela signifie que lorsque l'unit\u00e9 centrale red\u00e9marre, le laser sera compl\u00e8tement allum\u00e9 pendant le temps n\u00e9cessaire \u00e0 l'unit\u00e9 centrale pour red\u00e9marrer. Pour faire bonne mesure, il est recommand\u00e9 de toujours porter des lunettes laser appropri\u00e9es de la bonne longueur d'onde si le laser est aliment\u00e9 ; et de d\u00e9connecter le laser lorsqu'il n'est pas n\u00e9cessaire. Vous devriez \u00e9galement configurer un d\u00e9lai de s\u00e9curit\u00e9, de sorte que lorsque votre h\u00f4te ou votre MCU rencontre une erreur, l'outil s'arr\u00eate. Pour un exemple de configuration, voir config/sample-pwm-tool.cfg .","title":"Comment \u00e7a marche ?"},{"location":"Using_PWM_Tools.html#limites-actuelles","text":"La fr\u00e9quence des mises \u00e0 jour PWM est limit\u00e9e. Bien qu'elle soit tr\u00e8s pr\u00e9cise, une mise \u00e0 jour PWM ne peut se produire que toutes les 0,1 seconde, ce qui la rend presque inutile pour la gravure tram\u00e9e. Cependant, il existe une branche exp\u00e9rimentale avec ses propres compromis. A long terme, il est pr\u00e9vu d'ajouter cette fonctionnalit\u00e9 au klipper principal.","title":"Limites actuelles"},{"location":"Using_PWM_Tools.html#commandes","text":"M3/M4 S<valeur> : D\u00e9finit le cycle de travail PWM. Valeurs comprises entre 0 et 255. M5 : Arr\u00eate la sortie PWM \u00e0 la valeur d'arr\u00eat.","title":"Commandes"},{"location":"Using_PWM_Tools.html#configuration-de-laserweb","text":"Si vous utilisez Laserweb, une configuration fonctionnelle serait la suivante : GCODE START : M5 ; D\u00e9sactiver le laser G21 ; D\u00e9finir les unit\u00e9s en mm G90 ; Positionnement absolu G0 Z0 F7000 ; R\u00e9gler la vitesse de non coupe GCODE END : M5 ; D\u00e9sactiver le laser G91 ; relatif G0 Z+20 F4000 ; G90 ; absolu GCODE HOMING : M5 ; D\u00e9sactiver le laser G28 ; D\u00e9placement sur tous les axes TOOL ON : M3 $INTENSIT\u00c9 TOOL OFF : M5 ; D\u00e9sactiver le laser INTENSIT\u00c9 DU LASER : S","title":"Configuration de Laserweb"}]}
\ No newline at end of file
diff --git a/fr/sitemap.xml b/fr/sitemap.xml
index 589ca26a4..0fca06649 100644
--- a/fr/sitemap.xml
+++ b/fr/sitemap.xml
@@ -2,252 +2,252 @@
 <urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
 </urlset>
\ No newline at end of file
diff --git a/fr/sitemap.xml.gz b/fr/sitemap.xml.gz
index a5c955ce8955926e185fd7a275f5d6e62ce8241f..29d84e4a773da8204895fe341d0db82c81ce57b8 100644
GIT binary patch
delta 84
zcmV-a0IUDv0pbBeABzYGZJps`0{?SqbY*Q}a4vXlYyj=eOAdlC6a~<^t00|2D-Qgm
ql$k?Ex&Q(dNT9{OD!P05#jpjF`zC$8z3GvWLzf5w%AkPP7ytm_uOz4d

delta 84
zcmV-a0IUDv0pbBeABzYG_e0=g0{?SqbY*Q}a4vXlYyj=eO%8%E5C!19ry$)!D<(!w
qDLa?0^Z*1ZkU)!_DtdeQi{T0;Z#JF2zVwrkLzf5z@gV}&7ytmbJ|Zsw

diff --git a/hu/_klipper3d/__pycache__/mkdocs_hooks.cpython-38.pyc b/hu/_klipper3d/__pycache__/mkdocs_hooks.cpython-38.pyc
index 5da67cbb5f7b316a897b1f45ea74add26d185cdc..406a5b31d8ec56dfda96532a8fe45345f0518786 100644
GIT binary patch
delta 20
acmcc4ex02=l$V!_0SH3pKHSKCh8X}iVg;W7

delta 20
acmcc4ex02=l$V!_0SIn6KiJ59h8X}j<ORt9

diff --git a/hu/sitemap.xml b/hu/sitemap.xml
index 589ca26a4..0fca06649 100644
--- a/hu/sitemap.xml
+++ b/hu/sitemap.xml
@@ -2,252 +2,252 @@
 <urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
 </urlset>
\ No newline at end of file
diff --git a/hu/sitemap.xml.gz b/hu/sitemap.xml.gz
index a6d87ab67c36b78944d55a5a29d97c1ccee1a363..282a6601b8c3f271f656cc88612c0bc628a68601 100644
GIT binary patch
delta 84
zcmV-a0IUDv0pbBeABzYGX`SI?0{?SqbY*Q}a4vXlYyj=eOAdlC6a~<^t00|2D-Qgm
ql$k?Ex&Q(dNT9{OD!P05#jpjF`zC$8z3GvWLzf5w%AkPP7ytm^gCwK?

delta 84
zcmV-a0IUDv0pbBeABzYG@<ZTb0{?SqbY*Q}a4vXlYyj=eO%8%E5C!19ry$)!D<(!w
qDLa?0^Z*1ZkU)!_DtdeQi{T0;Z#JF2zVwrkLzf5z@gV}&7ytmZ$08~K

diff --git a/it/Bed_Mesh.html b/it/Bed_Mesh.html
index bc5c5eda8..0cb48b156 100644
--- a/it/Bed_Mesh.html
+++ b/it/Bed_Mesh.html
@@ -730,8 +730,8 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#loading-the-default-profile" class="md-nav__link">
-    Loading the default profile
+  <a href="#caricamento-del-profilo-predefinito" class="md-nav__link">
+    Caricamento del profilo predefinito
   </a>
   
 </li>
@@ -1497,8 +1497,8 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#loading-the-default-profile" class="md-nav__link">
-    Loading the default profile
+  <a href="#caricamento-del-profilo-predefinito" class="md-nav__link">
+    Caricamento del profilo predefinito
   </a>
   
 </li>
@@ -1720,9 +1720,9 @@ faulty_region_4_max: 45.0, 210.0
 <p>Va notato che ogni volta che si verifica un BED_MESH_CALIBRATE, lo stato corrente viene automaticamente salvato nel profilo <em>predefinito</em>. Se questo profilo esiste, viene caricato automaticamente all'avvio di Klipper. Se questo comportamento non è desiderabile, il profilo <em>predefinito</em> può essere rimosso come segue:</p>
 <p><code>BED_MESH_PROFILE REMOVE=default</code></p>
 <p>Qualsiasi altro profilo salvato può essere rimosso allo stesso modo, sostituendo <em>default</em> con il nome del profilo che desideri rimuovere.</p>
-<h4 id="loading-the-default-profile">Loading the default profile<a class="headerlink" href="#loading-the-default-profile" title="Permanent link">&para;</a></h4>
-<p>Previous versions of <code>bed_mesh</code> always loaded the profile named <em>default</em> on startup if it was present. This behavior has been removed in favor of allowing the user to determine when a profile is loaded. If a user wishes to load the <code>default</code> profile it is recommended to add <code>BED_MESH_PROFILE LOAD=default</code> to either their <code>START_PRINT</code> macro or their slicer's "Start G-Code" configuration, whichever is applicable.</p>
-<p>Alternatively the old behavior of loading a profile at startup can be restored with a <code>[delayed_gcode]</code>:</p>
+<h4 id="caricamento-del-profilo-predefinito">Caricamento del profilo predefinito<a class="headerlink" href="#caricamento-del-profilo-predefinito" title="Permanent link">&para;</a></h4>
+<p>Le versioni precedenti di <code>bed_mesh</code> caricavano sempre il profilo denominato <em>default</em> all'avvio se era presente. Questo comportamento è stato rimosso per consentire all'utente di determinare quando viene caricato un profilo. Se un utente desidera caricare il profilo <code>predefinito</code>, si consiglia di aggiungere <code>BED_MESH_PROFILE LOAD=default</code> alla macro <code>START_PRINT</code> o alla configurazione "Start G-Code" del proprio slicer, a seconda di quale sia applicabile.</p>
+<p>In alternativa, il vecchio comportamento di caricamento di un profilo all'avvio può essere ripristinato con un <code>[delayed_gcode]</code>:</p>
 <div class="highlight"><pre><span></span><code><span class="k">[delayed_gcode bed_mesh_init]</span>
 <span class="na">initial_duration</span><span class="o">:</span><span class="w"> </span><span class="s">.01</span>
 <span class="na">gcode</span><span class="o">:</span>
diff --git a/it/Config_Changes.html b/it/Config_Changes.html
index dbf01825e..f0fd0ecdd 100644
--- a/it/Config_Changes.html
+++ b/it/Config_Changes.html
@@ -1293,9 +1293,9 @@
 <p>Questo documento copre le modifiche software recenti al file di configurazione che non sono compatibili con le versioni precedenti. È una buona idea rivedere questo documento durante l'aggiornamento del software Klipper.</p>
 <p>Tutte le date in questo documento sono approssimative.</p>
 <h2 id="cambiamenti">Cambiamenti<a class="headerlink" href="#cambiamenti" title="Permanent link">&para;</a></h2>
-<p>20230201: The <code>[bed_mesh]</code> module no longer loads the <code>default</code> profile on startup. It is recommended that users who use the <code>default</code> profile add <code>BED_MESH_PROFILE LOAD=default</code> to their <code>START_PRINT</code> macro (or to their slicer's "Start G-Code" configuration when applicable).</p>
-<p>20230103: It is now possible with the flash-sdcard.sh script to flash both variants of the Bigtreetech SKR-2, STM32F407 and STM32F429. This means that the original tag of btt-skr2 now has changed to either btt-skr-2-f407 or btt-skr-2-f429.</p>
-<p>20221128: Klipper v0.11.0 released.</p>
+<p>20230201: Il modulo <code>[bed_mesh]</code> non carica più il profilo <code>default</code> all'avvio. Si consiglia agli utenti che usano il profilo <code>default</code> di aggiungere <code>BED_MESH_PROFILE LOAD=default</code> alla loro macro <code>START_PRINT</code> (o alla configurazione "Start G-Code" del loro slicer quando applicabile).</p>
+<p>20230103: Ora è possibile con lo script flash-sdcard.sh eseguire il flashing di entrambe le varianti di Bigtreetech SKR-2, STM32F407 e STM32F429. Ciò significa che il tag originale di btt-skr2 ora è cambiato in btt-skr-2-f407 o btt-skr-2-f429.</p>
+<p>20221128: rilascio di Klipper v0.11.0.</p>
 <p>20221122: In precedenza, con safe_z_home, era possibile che z_hop dopo l'homing g28 andasse nella direzione z negativa. Ora, uno z_hop viene eseguito dopo g28 solo se risulta in un hop positivo, rispecchiando il comportamento dello z_hop che si verifica prima dell'homing g28.</p>
 <p>20220616: in precedenza era possibile eseguire il flashing di un rp2040 in modalità bootloader eseguendo <code>make flash FLASH_DEVICE=first</code>. Il comando equivalente è ora <code>make flash FLASH_DEVICE=2e8a:0003</code>.</p>
 <p>20220612: Il microcontrollore rp2040 ora ha una soluzione alternativa per l'errata USB "rp2040-e5". Ciò dovrebbe rendere più affidabili le connessioni USB iniziali. Tuttavia, potrebbe comportare un cambiamento nel comportamento del pin gpio15. È improbabile che il cambiamento di comportamento di gpio15 sia evidente.</p>
diff --git a/it/G-Codes.html b/it/G-Codes.html
index a087c9170..ddaf3adda 100644
--- a/it/G-Codes.html
+++ b/it/G-Codes.html
@@ -4641,8 +4641,8 @@
 <h3 id="output_pin">[output_pin]<a class="headerlink" href="#output_pin" title="Permanent link">&para;</a></h3>
 <p>Il comando seguente è disponibile quando una <a href="Config_Reference.html#pin_output">sezione di configurazione pin_output</a> è abilitata.</p>
 <h4 id="set_pin">SET_PIN<a class="headerlink" href="#set_pin" title="Permanent link">&para;</a></h4>
-<p><code>SET_PIN PIN=config_name VALUE=&lt;value&gt; [CYCLE_TIME=&lt;cycle_time&gt;]</code>: Set the pin to the given output <code>VALUE</code>. VALUE should be 0 or 1 for "digital" output pins. For PWM pins, set to a value between 0.0 and 1.0, or between 0.0 and <code>scale</code> if a scale is configured in the output_pin config section.</p>
-<p>Some pins (currently only "soft PWM" pins) support setting an explicit cycle time using the CYCLE_TIME parameter (specified in seconds). Note that the CYCLE_TIME parameter is not stored between SET_PIN commands (any SET_PIN command without an explicit CYCLE_TIME parameter will use the <code>cycle_time</code> specified in the output_pin config section).</p>
+<p><code>SET_PIN PIN=config_name VALUE=&lt;value&gt; [CYCLE_TIME=&lt;cycle_time&gt;]</code>: Imposta il pin sull'output <code>VALUE</code>. VALUE dovrebbe essere 0 o 1 per i pin di uscita "digital". Per i pin PWM, impostare su un valore compreso tra 0.0 e 1.0 o tra 0.0 e <code>scale</code> se è configurata una scala nella sezione di configurazione output_pin.</p>
+<p>Alcuni pin (attualmente solo pin "soft PWM") supportano l'impostazione di un tempo di ciclo esplicito utilizzando il parametro CYCLE_TIME (specificato in secondi). Si noti che il parametro CYCLE_TIME non è memorizzato tra i comandi SET_PIN (qualsiasi comando SET_PIN senza un parametro CYCLE_TIME esplicito utilizzerà il <code>cycle_time</code> specificato nella sezione di configurazione output_pin).</p>
 <h3 id="palette2">[palette2]<a class="headerlink" href="#palette2" title="Permanent link">&para;</a></h3>
 <p>I seguenti comandi sono disponibili quando la <a href="Config_Reference.html#palette2">sezione di configurazione della palette2</a> è abilitata.</p>
 <p>Le stampe di Palette funzionano incorporando speciali OCodes (Codici Omega) nel file GCode:</p>
diff --git a/it/_klipper3d/__pycache__/mkdocs_hooks.cpython-38.pyc b/it/_klipper3d/__pycache__/mkdocs_hooks.cpython-38.pyc
index 5da67cbb5f7b316a897b1f45ea74add26d185cdc..406a5b31d8ec56dfda96532a8fe45345f0518786 100644
GIT binary patch
delta 20
acmcc4ex02=l$V!_0SH3pKHSKCh8X}iVg;W7

delta 20
acmcc4ex02=l$V!_0SIn6KiJ59h8X}j<ORt9

diff --git a/it/search/search_index.json b/it/search/search_index.json
index edeb298cc..316a16ce5 100644
--- a/it/search/search_index.json
+++ b/it/search/search_index.json
@@ -1 +1 @@
-{"config":{"indexing":"full","lang":["it"],"min_search_length":3,"prebuild_index":false,"separator":"[\\s\\-]+"},"docs":[{"location":"index.html","text":"Klipper \u00e8 un firmware per stampanti 3D. Combina la potenza di un computer con uno o pi\u00f9 microntrollori. Leggi la pagina sulle funzionalit\u00e0 per avere pi\u00f9 informazioni sul perch\u00e9 usare Klipper. Per iniziare ad usare Klipper comincia con la sua installazione . Klipper \u00e8 un software libero. Leggi la documentazione o visualizza il codice Klipper su github . Dipendiamo dal generoso supporto dei nostri sponsor .","title":"Benvenuto"},{"location":"API_Server.html","text":"Server API \u00b6 Questo documento descrive l'Application Programmer Interface (API) di Klipper. Questa interfaccia consente alle applicazioni esterne di interrogare e controllare il software host Klipper. Abilitazione del socket API \u00b6 Per utilizzare il server API, il software host klippy.py deve essere avviato con il parametro -a . Per esempio: ~/klippy-env/bin/python ~/klipper/klippy/klippy.py ~/printer.cfg -a /tmp/klippy_uds -l /tmp/klippy.log Ci\u00f2 fa s\u00ec che il software host crei un socket di dominio Unix. Un client pu\u00f2 quindi aprire una connessione su quel socket e inviare comandi a Klipper. Consulta il progetto Moonraker per uno strumento popolare in grado di inoltrare richieste HTTP all'API Server Unix Domain Socket di Klipper. Formato richiesta \u00b6 I messaggi inviati e ricevuti sul socket sono stringhe codificate JSON terminate da un carattere ASCII 0x03: <json_object_1><0x03><json_object_2><0x03>... Klipper contiene uno strumento scripts/whconsole.py che pu\u00f2 eseguire il framing dei messaggi sopra. Per esempio: ~/klipper/scripts/whconsole.py /tmp/klippy_uds Questo strumento pu\u00f2 leggere una serie di comandi JSON da stdin, inviarli a Klipper e riportare i risultati. Lo strumento prevede che ogni comando JSON si trovi su una singola riga e aggiunger\u00e0 automaticamente il terminatore 0x03 durante la trasmissione di una richiesta. (Il server dell'API Klipper non ha un requisito di newline.) Protocollo API \u00b6 Il protocollo dei comandi utilizzato sul socket di comunicazione \u00e8 ispirato a json-rpc . Una richiesta potrebbe essere simile a: {\"id\": 123, \"method\": \"info\", \"params\": {}} e una risposta potrebbe essere simile a: {\"id\": 123, \"result\": {\"state_message\": \"Printer is ready\", \"klipper_path\": \"/home/pi/klipper\", \"config_file\": \"/home/pi/printer.cfg\", \"software_version\": \"v0.8.0-823-g883b1cb6\", \"hostname\": \"octopi\", \"cpu_info\": \"4 core ARMv7 Processor rev 4 (v7l)\", \"state\": \"ready\", \"python_path\": \"/home/pi/klippy-env/bin/python\", \"log_file\": \"/tmp/klippy.log\"}} Ogni richiesta deve essere un dizionario JSON. (Questo documento usa il termine Python \"dizionario\" per descrivere un \"oggetto JSON\" - una mappatura di coppie chiave/valore contenute in {} .) Il dizionario di richiesta deve contenere un parametro \"method\" che \u00e8 il nome stringa di un \"endpoint\" di Klipper disponibile. Il dizionario della richiesta pu\u00f2 contenere un parametro \"params\" che deve essere di tipo dizionario. I \"parametri\" forniscono ulteriori informazioni sui parametri all'\"endpoint\" di Klipper che gestisce la richiesta. Il suo contenuto \u00e8 specifico dell'\"endpoint\". Il dizionario delle richieste pu\u00f2 contenere un parametro \"id\" che pu\u00f2 essere di qualsiasi tipo JSON. Se \u00e8 presente \"id\", Klipper risponder\u00e0 alla richiesta con un messaggio di risposta contenente tale \"id\". Se \"id\" viene omesso (o impostato su un valore JSON \"null\"), Klipper non fornir\u00e0 alcuna risposta alla richiesta. Un messaggio di risposta \u00e8 un dizionario JSON contenente \"id\" e \"result\". Il \"risultato\" \u00e8 sempre un dizionario: i suoi contenuti sono specifici dell'\"endpoint\" che gestisce la richiesta. Se l'elaborazione di una richiesta genera un errore, il messaggio di risposta conterr\u00e0 un campo \"errore\" anzich\u00e9 un campo \"risultato\". Ad esempio, la richiesta: {\"id\": 123, \"method\": \"gcode/script\", \"params\": {\"script\": \"G1 X200\"}} potrebbe generare una risposta di errore come: {\"id\": 123, \"error\": {\"message\": \"Deve prima posizionare l'asse: 200.000 0.000 0.000 [0.000]\", \"error\": \"WebRequestError\"}} Klipper inizier\u00e0 sempre a elaborare le richieste nell'ordine in cui sono state ricevute. Tuttavia, alcune richieste potrebbero non essere completate immediatamente, il che potrebbe causare l'invio di una risposta associata non conforme rispetto alle risposte di altre richieste. Una richiesta JSON non sospender\u00e0 mai l'elaborazione di future richieste JSON. Sottoscrizioni \u00b6 Alcune richieste di \"endpoint\" di Klipper consentono di \"iscriversi\" a futuri messaggi di aggiornamento asincrono. Per esempio: {\"id\": 123, \"method\": \"gcode/subscribe_output\", \"params\": {\"response_template\":{\"key\": 345}}} inizialmente pu\u00f2 rispondere con: {\"id\": 123, \"result\": {}} e fare in modo che Klipper invii messaggi futuri simili a: {\"params\": {\"response\": \"ok B:22.8 /0.0 T0:22.4 /0.0\"}, \"key\": 345} Una richiesta di sottoscrizione accetta un dizionario \"response_template\" nel campo \"params\" della richiesta. Quel dizionario \"response_template\" viene utilizzato come modello per futuri messaggi asincroni: pu\u00f2 contenere coppie chiave/valore arbitrarie. Quando invier\u00e0 questi futuri messaggi asincroni, Klipper aggiunger\u00e0 un campo \"params\" contenente un dizionario con contenuti specifici per \"endpoint\" al modello di risposta e quindi invier\u00e0 quel modello. Se non viene fornito un campo \"response_template\", il valore predefinito \u00e8 un dizionario vuoto ( {} ). \"endpoint\" disponibili \u00b6 Per convenzione, gli \"endpoint\" di Klipper sono nella forma <module_name>/<some_name> . Quando si effettua una richiesta a un \"endpoint\", il nome completo deve essere impostato nel parametro \"method\" del dizionario di richiesta (ad esempio, {\"method\"=\"gcode/restart\"} ). info \u00b6 L'endpoint \"info\" viene utilizzato per ottenere informazioni sul sistema e sulla versione da Klipper. Viene anche utilizzato per fornire a Klipper le informazioni sulla versione del client. Ad esempio: {\"id\": 123, \"method\": \"info\", \"params\": { \"client_info\": { \"version\": \"v1\"}}} Se presente, il parametro \"client_info\" deve essere un dizionario, ma quel dizionario potrebbe avere contenuti arbitrari. I clienti sono incoraggiati a fornire il nome del client e la sua versione del software quando si connettono per la prima volta al server dell'API Klipper. emergency_stop \u00b6 L'endpoint \"emergency_stop\" viene utilizzato per indicare a Klipper di passare allo stato di \"spegnimento\". Si comporta in modo simile al comando G-Code M112 . Ad esempio: {\"id\": 123, \"method\": \"emergency_stop\"} register_remote_method \u00b6 Questo endpoint consente ai client di registrare metodi che possono essere chiamati da klipper. Restituir\u00e0 un oggetto vuoto in caso di successo. Per esempio: {\"id\": 123, \"method\": \"register_remote_method\", \"params\": {\"response_template\": {\"action\": \"run_paneldue_beep\"}, \"remote_method\": \"paneldue_beep\"}} will return: {\"id\": 123, \"result\": {}} Il metodo remoto paneldue_beep ora pu\u00f2 essere chiamato da Klipper. Nota che se il metodo accetta parametri, dovrebbero essere forniti come argomenti di parole chiave. Di seguito \u00e8 riportato un esempio di come pu\u00f2 essere chiamato da una gcode_macro: [gcode_macro PANELDUE_BEEP] gcode: {action_call_remote_method(\"paneldue_beep\", frequency=300, duration=1.0)} Quando viene eseguita la macro gcode PANELDUE_BEEP, Klipper invia qualcosa di simile al seguente tramite il socket: {\"action\": \"run_paneldue_beep\", \"params\": {\"frequency\": 300, \"duration\": 1.0}} oggetti/elenco \u00b6 Questo endpoint interroga l'elenco degli \"oggetti\" della stampante disponibili che \u00e8 possibile interrogare (tramite l'endpoint \"objects/query\"). Ad esempio: {\"id\": 123, \"method\": \"objects/list\"} potrebbe restituire: {\"id\": 123, \"result\": {\"objects\": [\"webhooks\", \"configfile\" , \"heaters\", \"gcode_move\", \"query_endstops\", \"idle_timeout\", \"toolhead\", \"extruder\"]}} oggetti/interrogazione \u00b6 Questo endpoint consente di interrogare informazioni da oggetti. Ad esempio: {\"id\": 123, \"method\": \"objects/query\", \"params\": {\"objects\": {\"toolhead\": [\"position\"], \"webhooks\": null}}} potrebbe restituire: {\"id\": 123, \"result\": {\"status\": {\"webhooks\": {\"state\": \"ready\", \"state_message\": \"Printer is ready\"}, \"toolhead\": { \"position\": [0.0, 0.0, 0.0, 0.0]}}, \"eventtime\": 3051555.377933684}} Il parametro \"objects\" nella richiesta deve essere un dizionario contenente gli oggetti stampante che devono essere interrogati - la chiave contiene il nome dell'oggetto stampante e il valore \u00e8 \"null\" (per interrogare tutti i campi) o un elenco di nomi di campo. Il messaggio di risposta conterr\u00e0 un campo \"status\" contenente un dizionario con le informazioni richieste: la chiave contiene il nome dell'oggetto stampante e il valore \u00e8 un dizionario contenente i suoi campi. Il messaggio di risposta conterr\u00e0 anche un campo \"eventtime\" contenente il timestamp da quando \u00e8 stata eseguita la query. I campi disponibili sono documentati nel documento Status Reference . oggetti/subscribe \u00b6 Questo endpoint consente di eseguire query e quindi iscriversi alle informazioni dagli oggetti stampante. La richiesta e la risposta dell'endpoint sono identiche all'endpoint \"objects/query\". Ad esempio: {\"id\": 123, \"method\": \"objects/subscribe\", \"params\": {\"objects\":{\"toolhead\": [\"position\"], \"webhooks\": [\"state\"] }, \"response_template\":{}}} potrebbe restituire: {\"id\": 123, \"result\": {\"status\": {\"webhooks\": {\"state\": \"ready\"}, \"toolhead\": {\"position\": [0.0, 0.0, 0.0, 0.0]}}, \"eventtime\": 3052153.382083195}} e generare messaggi asincroni successivi come: {\"params\": {\"status\": {\"webhooks\": {\"state\": \"shutdown\"}}, \"eventtime\": 3052165.418815847}} gcode/help \u00b6 Questo endpoint consente di interrogare i comandi G-Code disponibili che hanno una stringa di aiuto definita. Ad esempio: {\"id\": 123, \"method\": \"gcode/help\"} potrebbe restituire: {\"id\": 123, \"result\": {\"RESTORE_GCODE_STATE\": \"Restore a previously saved G-Code state\", \"PID_CALIBRATE\": \"Run PID calibration test\", \"QUERY_ADC\": \"Report the last value of an analog pin\", ...}} gcode/script \u00b6 Questo endpoint consente di eseguire una serie di comandi G-Code. Ad esempio: {\"id\": 123, \"method\": \"gcode/script\", \"params\": {\"script\": \"G90\"}} Se lo script G-Code fornito genera un errore, allora viene generata una risposta di errore. Tuttavia, se il comando G-Code produce un output del terminale, tale output del terminale non viene fornito nella risposta. (Utilizzare l'endpoint \"gcode/subscribe_output\" per ottenere l'output del terminale G-Code.) Se c'\u00e8 un comando G-Code in elaborazione quando viene ricevuta questa richiesta, lo script fornito verr\u00e0 messo in coda. Questo ritardo potrebbe essere significativo (ad esempio, se \u00e8 in esecuzione un comando di attesa del codice G per la temperatura). Il messaggio di risposta JSON viene inviato al completamento dell'elaborazione dello script. gcode/restart \u00b6 Questo endpoint consente di richiedere un riavvio: \u00e8 simile all'esecuzione del comando \"RESTART\" del codice G. Ad esempio: {\"id\": 123, \"method\": \"gcode/restart\"} Come con l'endpoint \"gcode/script\", questo endpoint viene completato solo dopo il completamento di tutti i comandi G-Code in sospeso. gcode/firmware_restart \u00b6 Questo \u00e8 simile all'endpoint \"gcode/restart\": implementa il comando G-Code \"FIRMWARE_RESTART\". Ad esempio: {\"id\": 123, \"method\": \"gcode/firmware_restart\"} Come con l'endpoint \"gcode/script\", questo endpoint viene completato solo dopo il completamento di tutti i comandi G-Code in sospeso. gcode/subscribe_output \u00b6 Questo endpoint viene utilizzato per iscriversi ai messaggi del terminale G-Code generati da Klipper. Ad esempio: {\"id\": 123, \"method\": \"gcode/subscribe_output\", \"params\": {\"response_template\":{}}} potrebbe in seguito produrre messaggi asincroni come: {\"params\": { \"response\": \"// Klipper state: Shutdown\"}} Questo endpoint ha lo scopo di supportare l'interazione umana tramite un'interfaccia \"finestra di terminale\". L'analisi del contenuto dall'output del terminale G-Code \u00e8 sconsigliata. Usa l'endpoint \"objects/subscribe\" per ottenere aggiornamenti sullo stato di Klipper. motion_report/dump_stepper \u00b6 Questo endpoint viene utilizzato per iscriversi al flusso di comandi queue_step interno di Klipper per uno stepper. L'ottenimento di questi aggiornamenti di movimento di basso livello pu\u00f2 essere utile per scopi diagnostici e di debug. L'utilizzo di questo endpoint pu\u00f2 aumentare il carico di sistema di Klipper. Una richiesta pu\u00f2 essere simile a: {\"id\": 123, \"method\":\"motion_report/dump_stepper\", \"params\": {\"name\": \"stepper_x\", \"response_template\": {}}} e potrebbe restituire: {\"id\": 123, \"result\": {\"header\": [\"interval\", \"count\", \"add\"]}} e potrebbe in seguito produrre messaggi asincroni come: {\"params\": {\" first_clock\": 179601081, \"first_time\": 8.98, \"first_position\": 0, \"last_clock\": 219686097, \"last_time\": 10.984, \"data\": [[179601081, 1, 0], [29573, 2, -8685] , [16230, 4, -1525], [10559, 6, -160], [10000, 976, 0], [10000, 1000, 0], [10000, 1000, 0], [10000, 1000, 0] , [9855, 5, 187], [11632, 4, 1534], [20756, 2, 9442]]}} Il campo \"intestazione\" nella risposta alla query iniziale viene utilizzato per descrivere i campi trovati nelle risposte \"dati\" successive. motion_report/dump_trapq \u00b6 Questo endpoint viene utilizzato per iscriversi alla \"coda di movimento trapezoidale\" interna di Klipper. L'ottenimento di questi aggiornamenti di movimento di basso livello pu\u00f2 essere utile per scopi diagnostici e di debug. L'utilizzo di questo endpoint pu\u00f2 aumentare il carico di sistema di Klipper. Una richiesta pu\u00f2 essere simile a: {\"id\": 123, \"method\": \"motion_report/dump_trapq\", \"params\": {\"name\": \"toolhead\", \"response_template\":{}}} e potrebbe restituire: {\"id\": 1, \"result\": {\"header\": [\"time\", \"duration\", \"start_velocity\", \"acceleration\", \"start_position\", \"direction\"]}} e potrebbero in seguito produrre messaggi asincroni quali: {\"params\": {\"data\": [[4.05, 1.0, 0.0, 0.0, [300.0, 0.0, 0.0], [0.0, 0.0, 0.0]], [5.054, 0.001, 0.0, 3000.0 , [300.0, 0.0, 0.0], [-1.0, 0.0, 0.0]]]}} Il campo \"intestazione\" nella risposta alla query iniziale viene utilizzato per descrivere i campi trovati nelle risposte \"dati\" successive. adxl345/dump_adxl345 \u00b6 Questo endpoint viene utilizzato per la sottoscrizione ai dati dell'accelerometro ADXL345. L'ottenimento di questi aggiornamenti di movimento di basso livello pu\u00f2 essere utile per scopi diagnostici e di debug. L'utilizzo di questo endpoint pu\u00f2 aumentare il carico di sistema di Klipper. Una richiesta pu\u00f2 essere simile a: {\"id\": 123, \"method\":\"adxl345/dump_adxl345\", \"params\": {\"sensor\": \"adxl345\", \"response_template\": {}}} e potrebbe restituire: {\"id\": 123,\"result\":{\"header\":[\"time\",\"x_acceleration\",\"y_acceleration\", \"z_acceleration\"]}} e potrebbe in seguito produrre messaggi asincroni come: {\"params \":{\"overflow\":0,\"data\":[[3292.432935,-535.44309,-1529.8374,9561.4], [3292.433256,-382.45935,-1606.32927,9561.48375]]}} Il campo \"intestazione\" nella risposta alla query iniziale viene utilizzato per descrivere i campi trovati nelle risposte \"dati\" successive. angle/dump_angle \u00b6 Questo endpoint viene utilizzato per iscriversi a dati del sensore angolare . L'ottenimento di questi aggiornamenti di movimento di basso livello pu\u00f2 essere utile per scopi diagnostici e di debug. L'utilizzo di questo endpoint pu\u00f2 aumentare il carico di sistema di Klipper. Una richiesta pu\u00f2 essere simile a: {\"id\": 123, \"method\":\"angle/dump_angle\", \"params\": {\"sensor\": \"my_angle_sensor\", \"response_template\": {}}} e potrebbe restituire: {\"id\": 123,\"result\":{\"header\":[\"time\",\"angle\"]}} e potrebbe in seguito produrre messaggi asincroni come: {\"params\":{\"position_offset\":3.151562 ,\"errori\":0, \"dati\":[[1290.951905,-5063],[1290.952321,-5065]]}} Il campo \"intestazione\" nella risposta alla query iniziale viene utilizzato per descrivere i campi trovati nelle risposte \"dati\" successive. pause_resume/cancel \u00b6 Questo endpoint \u00e8 simile all'esecuzione del comando G-Code \"PRINT_CANCEL\". Ad esempio: {\"id\": 123, \"method\": \"pause_resume/cancel\"} Come con l'endpoint \"gcode/script\", questo endpoint viene completato solo dopo il completamento di tutti i comandi G-Code in sospeso. pause_resume/pause \u00b6 Questo endpoint \u00e8 simile all'esecuzione del comando G-Code \"PAUSE\". Ad esempio: {\"id\": 123, \"method\": \"pause_resume/pause\"} Come con l'endpoint \"gcode/script\", questo endpoint viene completato solo dopo il completamento di tutti i comandi G-Code in sospeso. pause_resume/resume \u00b6 Questo endpoint \u00e8 simile all'esecuzione del comando G-Code \"RESUME\". Ad esempio: {\"id\": 123, \"method\": \"pause_resume/resume\"} Come con l'endpoint \"gcode/script\", questo endpoint viene completato solo dopo il completamento di tutti i comandi G-Code in sospeso. query_endstops/status \u00b6 Questo endpoint eseguir\u00e0 una query sugli endpoint attivi e restituir\u00e0 il loro stato. Ad esempio: {\"id\": 123, \"method\": \"query_endstops/status\"} potrebbe restituire: {\"id\": 123, \"result\": {\"y\": \"open\", \"x\": \"aperto\", \"z\": \"TRIGGERED\"}} Come con l'endpoint \"gcode/script\", questo endpoint viene completato solo dopo il completamento di tutti i comandi G-Code in sospeso.","title":"Server API"},{"location":"API_Server.html#server-api","text":"Questo documento descrive l'Application Programmer Interface (API) di Klipper. Questa interfaccia consente alle applicazioni esterne di interrogare e controllare il software host Klipper.","title":"Server API"},{"location":"API_Server.html#abilitazione-del-socket-api","text":"Per utilizzare il server API, il software host klippy.py deve essere avviato con il parametro -a . Per esempio: ~/klippy-env/bin/python ~/klipper/klippy/klippy.py ~/printer.cfg -a /tmp/klippy_uds -l /tmp/klippy.log Ci\u00f2 fa s\u00ec che il software host crei un socket di dominio Unix. Un client pu\u00f2 quindi aprire una connessione su quel socket e inviare comandi a Klipper. Consulta il progetto Moonraker per uno strumento popolare in grado di inoltrare richieste HTTP all'API Server Unix Domain Socket di Klipper.","title":"Abilitazione del socket API"},{"location":"API_Server.html#formato-richiesta","text":"I messaggi inviati e ricevuti sul socket sono stringhe codificate JSON terminate da un carattere ASCII 0x03: <json_object_1><0x03><json_object_2><0x03>... Klipper contiene uno strumento scripts/whconsole.py che pu\u00f2 eseguire il framing dei messaggi sopra. Per esempio: ~/klipper/scripts/whconsole.py /tmp/klippy_uds Questo strumento pu\u00f2 leggere una serie di comandi JSON da stdin, inviarli a Klipper e riportare i risultati. Lo strumento prevede che ogni comando JSON si trovi su una singola riga e aggiunger\u00e0 automaticamente il terminatore 0x03 durante la trasmissione di una richiesta. (Il server dell'API Klipper non ha un requisito di newline.)","title":"Formato richiesta"},{"location":"API_Server.html#protocollo-api","text":"Il protocollo dei comandi utilizzato sul socket di comunicazione \u00e8 ispirato a json-rpc . Una richiesta potrebbe essere simile a: {\"id\": 123, \"method\": \"info\", \"params\": {}} e una risposta potrebbe essere simile a: {\"id\": 123, \"result\": {\"state_message\": \"Printer is ready\", \"klipper_path\": \"/home/pi/klipper\", \"config_file\": \"/home/pi/printer.cfg\", \"software_version\": \"v0.8.0-823-g883b1cb6\", \"hostname\": \"octopi\", \"cpu_info\": \"4 core ARMv7 Processor rev 4 (v7l)\", \"state\": \"ready\", \"python_path\": \"/home/pi/klippy-env/bin/python\", \"log_file\": \"/tmp/klippy.log\"}} Ogni richiesta deve essere un dizionario JSON. (Questo documento usa il termine Python \"dizionario\" per descrivere un \"oggetto JSON\" - una mappatura di coppie chiave/valore contenute in {} .) Il dizionario di richiesta deve contenere un parametro \"method\" che \u00e8 il nome stringa di un \"endpoint\" di Klipper disponibile. Il dizionario della richiesta pu\u00f2 contenere un parametro \"params\" che deve essere di tipo dizionario. I \"parametri\" forniscono ulteriori informazioni sui parametri all'\"endpoint\" di Klipper che gestisce la richiesta. Il suo contenuto \u00e8 specifico dell'\"endpoint\". Il dizionario delle richieste pu\u00f2 contenere un parametro \"id\" che pu\u00f2 essere di qualsiasi tipo JSON. Se \u00e8 presente \"id\", Klipper risponder\u00e0 alla richiesta con un messaggio di risposta contenente tale \"id\". Se \"id\" viene omesso (o impostato su un valore JSON \"null\"), Klipper non fornir\u00e0 alcuna risposta alla richiesta. Un messaggio di risposta \u00e8 un dizionario JSON contenente \"id\" e \"result\". Il \"risultato\" \u00e8 sempre un dizionario: i suoi contenuti sono specifici dell'\"endpoint\" che gestisce la richiesta. Se l'elaborazione di una richiesta genera un errore, il messaggio di risposta conterr\u00e0 un campo \"errore\" anzich\u00e9 un campo \"risultato\". Ad esempio, la richiesta: {\"id\": 123, \"method\": \"gcode/script\", \"params\": {\"script\": \"G1 X200\"}} potrebbe generare una risposta di errore come: {\"id\": 123, \"error\": {\"message\": \"Deve prima posizionare l'asse: 200.000 0.000 0.000 [0.000]\", \"error\": \"WebRequestError\"}} Klipper inizier\u00e0 sempre a elaborare le richieste nell'ordine in cui sono state ricevute. Tuttavia, alcune richieste potrebbero non essere completate immediatamente, il che potrebbe causare l'invio di una risposta associata non conforme rispetto alle risposte di altre richieste. Una richiesta JSON non sospender\u00e0 mai l'elaborazione di future richieste JSON.","title":"Protocollo API"},{"location":"API_Server.html#sottoscrizioni","text":"Alcune richieste di \"endpoint\" di Klipper consentono di \"iscriversi\" a futuri messaggi di aggiornamento asincrono. Per esempio: {\"id\": 123, \"method\": \"gcode/subscribe_output\", \"params\": {\"response_template\":{\"key\": 345}}} inizialmente pu\u00f2 rispondere con: {\"id\": 123, \"result\": {}} e fare in modo che Klipper invii messaggi futuri simili a: {\"params\": {\"response\": \"ok B:22.8 /0.0 T0:22.4 /0.0\"}, \"key\": 345} Una richiesta di sottoscrizione accetta un dizionario \"response_template\" nel campo \"params\" della richiesta. Quel dizionario \"response_template\" viene utilizzato come modello per futuri messaggi asincroni: pu\u00f2 contenere coppie chiave/valore arbitrarie. Quando invier\u00e0 questi futuri messaggi asincroni, Klipper aggiunger\u00e0 un campo \"params\" contenente un dizionario con contenuti specifici per \"endpoint\" al modello di risposta e quindi invier\u00e0 quel modello. Se non viene fornito un campo \"response_template\", il valore predefinito \u00e8 un dizionario vuoto ( {} ).","title":"Sottoscrizioni"},{"location":"API_Server.html#endpoint-disponibili","text":"Per convenzione, gli \"endpoint\" di Klipper sono nella forma <module_name>/<some_name> . Quando si effettua una richiesta a un \"endpoint\", il nome completo deve essere impostato nel parametro \"method\" del dizionario di richiesta (ad esempio, {\"method\"=\"gcode/restart\"} ).","title":"\"endpoint\" disponibili"},{"location":"API_Server.html#info","text":"L'endpoint \"info\" viene utilizzato per ottenere informazioni sul sistema e sulla versione da Klipper. Viene anche utilizzato per fornire a Klipper le informazioni sulla versione del client. Ad esempio: {\"id\": 123, \"method\": \"info\", \"params\": { \"client_info\": { \"version\": \"v1\"}}} Se presente, il parametro \"client_info\" deve essere un dizionario, ma quel dizionario potrebbe avere contenuti arbitrari. I clienti sono incoraggiati a fornire il nome del client e la sua versione del software quando si connettono per la prima volta al server dell'API Klipper.","title":"info"},{"location":"API_Server.html#emergency_stop","text":"L'endpoint \"emergency_stop\" viene utilizzato per indicare a Klipper di passare allo stato di \"spegnimento\". Si comporta in modo simile al comando G-Code M112 . Ad esempio: {\"id\": 123, \"method\": \"emergency_stop\"}","title":"emergency_stop"},{"location":"API_Server.html#register_remote_method","text":"Questo endpoint consente ai client di registrare metodi che possono essere chiamati da klipper. Restituir\u00e0 un oggetto vuoto in caso di successo. Per esempio: {\"id\": 123, \"method\": \"register_remote_method\", \"params\": {\"response_template\": {\"action\": \"run_paneldue_beep\"}, \"remote_method\": \"paneldue_beep\"}} will return: {\"id\": 123, \"result\": {}} Il metodo remoto paneldue_beep ora pu\u00f2 essere chiamato da Klipper. Nota che se il metodo accetta parametri, dovrebbero essere forniti come argomenti di parole chiave. Di seguito \u00e8 riportato un esempio di come pu\u00f2 essere chiamato da una gcode_macro: [gcode_macro PANELDUE_BEEP] gcode: {action_call_remote_method(\"paneldue_beep\", frequency=300, duration=1.0)} Quando viene eseguita la macro gcode PANELDUE_BEEP, Klipper invia qualcosa di simile al seguente tramite il socket: {\"action\": \"run_paneldue_beep\", \"params\": {\"frequency\": 300, \"duration\": 1.0}}","title":"register_remote_method"},{"location":"API_Server.html#oggettielenco","text":"Questo endpoint interroga l'elenco degli \"oggetti\" della stampante disponibili che \u00e8 possibile interrogare (tramite l'endpoint \"objects/query\"). Ad esempio: {\"id\": 123, \"method\": \"objects/list\"} potrebbe restituire: {\"id\": 123, \"result\": {\"objects\": [\"webhooks\", \"configfile\" , \"heaters\", \"gcode_move\", \"query_endstops\", \"idle_timeout\", \"toolhead\", \"extruder\"]}}","title":"oggetti/elenco"},{"location":"API_Server.html#oggettiinterrogazione","text":"Questo endpoint consente di interrogare informazioni da oggetti. Ad esempio: {\"id\": 123, \"method\": \"objects/query\", \"params\": {\"objects\": {\"toolhead\": [\"position\"], \"webhooks\": null}}} potrebbe restituire: {\"id\": 123, \"result\": {\"status\": {\"webhooks\": {\"state\": \"ready\", \"state_message\": \"Printer is ready\"}, \"toolhead\": { \"position\": [0.0, 0.0, 0.0, 0.0]}}, \"eventtime\": 3051555.377933684}} Il parametro \"objects\" nella richiesta deve essere un dizionario contenente gli oggetti stampante che devono essere interrogati - la chiave contiene il nome dell'oggetto stampante e il valore \u00e8 \"null\" (per interrogare tutti i campi) o un elenco di nomi di campo. Il messaggio di risposta conterr\u00e0 un campo \"status\" contenente un dizionario con le informazioni richieste: la chiave contiene il nome dell'oggetto stampante e il valore \u00e8 un dizionario contenente i suoi campi. Il messaggio di risposta conterr\u00e0 anche un campo \"eventtime\" contenente il timestamp da quando \u00e8 stata eseguita la query. I campi disponibili sono documentati nel documento Status Reference .","title":"oggetti/interrogazione"},{"location":"API_Server.html#oggettisubscribe","text":"Questo endpoint consente di eseguire query e quindi iscriversi alle informazioni dagli oggetti stampante. La richiesta e la risposta dell'endpoint sono identiche all'endpoint \"objects/query\". Ad esempio: {\"id\": 123, \"method\": \"objects/subscribe\", \"params\": {\"objects\":{\"toolhead\": [\"position\"], \"webhooks\": [\"state\"] }, \"response_template\":{}}} potrebbe restituire: {\"id\": 123, \"result\": {\"status\": {\"webhooks\": {\"state\": \"ready\"}, \"toolhead\": {\"position\": [0.0, 0.0, 0.0, 0.0]}}, \"eventtime\": 3052153.382083195}} e generare messaggi asincroni successivi come: {\"params\": {\"status\": {\"webhooks\": {\"state\": \"shutdown\"}}, \"eventtime\": 3052165.418815847}}","title":"oggetti/subscribe"},{"location":"API_Server.html#gcodehelp","text":"Questo endpoint consente di interrogare i comandi G-Code disponibili che hanno una stringa di aiuto definita. Ad esempio: {\"id\": 123, \"method\": \"gcode/help\"} potrebbe restituire: {\"id\": 123, \"result\": {\"RESTORE_GCODE_STATE\": \"Restore a previously saved G-Code state\", \"PID_CALIBRATE\": \"Run PID calibration test\", \"QUERY_ADC\": \"Report the last value of an analog pin\", ...}}","title":"gcode/help"},{"location":"API_Server.html#gcodescript","text":"Questo endpoint consente di eseguire una serie di comandi G-Code. Ad esempio: {\"id\": 123, \"method\": \"gcode/script\", \"params\": {\"script\": \"G90\"}} Se lo script G-Code fornito genera un errore, allora viene generata una risposta di errore. Tuttavia, se il comando G-Code produce un output del terminale, tale output del terminale non viene fornito nella risposta. (Utilizzare l'endpoint \"gcode/subscribe_output\" per ottenere l'output del terminale G-Code.) Se c'\u00e8 un comando G-Code in elaborazione quando viene ricevuta questa richiesta, lo script fornito verr\u00e0 messo in coda. Questo ritardo potrebbe essere significativo (ad esempio, se \u00e8 in esecuzione un comando di attesa del codice G per la temperatura). Il messaggio di risposta JSON viene inviato al completamento dell'elaborazione dello script.","title":"gcode/script"},{"location":"API_Server.html#gcoderestart","text":"Questo endpoint consente di richiedere un riavvio: \u00e8 simile all'esecuzione del comando \"RESTART\" del codice G. Ad esempio: {\"id\": 123, \"method\": \"gcode/restart\"} Come con l'endpoint \"gcode/script\", questo endpoint viene completato solo dopo il completamento di tutti i comandi G-Code in sospeso.","title":"gcode/restart"},{"location":"API_Server.html#gcodefirmware_restart","text":"Questo \u00e8 simile all'endpoint \"gcode/restart\": implementa il comando G-Code \"FIRMWARE_RESTART\". Ad esempio: {\"id\": 123, \"method\": \"gcode/firmware_restart\"} Come con l'endpoint \"gcode/script\", questo endpoint viene completato solo dopo il completamento di tutti i comandi G-Code in sospeso.","title":"gcode/firmware_restart"},{"location":"API_Server.html#gcodesubscribe_output","text":"Questo endpoint viene utilizzato per iscriversi ai messaggi del terminale G-Code generati da Klipper. Ad esempio: {\"id\": 123, \"method\": \"gcode/subscribe_output\", \"params\": {\"response_template\":{}}} potrebbe in seguito produrre messaggi asincroni come: {\"params\": { \"response\": \"// Klipper state: Shutdown\"}} Questo endpoint ha lo scopo di supportare l'interazione umana tramite un'interfaccia \"finestra di terminale\". L'analisi del contenuto dall'output del terminale G-Code \u00e8 sconsigliata. Usa l'endpoint \"objects/subscribe\" per ottenere aggiornamenti sullo stato di Klipper.","title":"gcode/subscribe_output"},{"location":"API_Server.html#motion_reportdump_stepper","text":"Questo endpoint viene utilizzato per iscriversi al flusso di comandi queue_step interno di Klipper per uno stepper. L'ottenimento di questi aggiornamenti di movimento di basso livello pu\u00f2 essere utile per scopi diagnostici e di debug. L'utilizzo di questo endpoint pu\u00f2 aumentare il carico di sistema di Klipper. Una richiesta pu\u00f2 essere simile a: {\"id\": 123, \"method\":\"motion_report/dump_stepper\", \"params\": {\"name\": \"stepper_x\", \"response_template\": {}}} e potrebbe restituire: {\"id\": 123, \"result\": {\"header\": [\"interval\", \"count\", \"add\"]}} e potrebbe in seguito produrre messaggi asincroni come: {\"params\": {\" first_clock\": 179601081, \"first_time\": 8.98, \"first_position\": 0, \"last_clock\": 219686097, \"last_time\": 10.984, \"data\": [[179601081, 1, 0], [29573, 2, -8685] , [16230, 4, -1525], [10559, 6, -160], [10000, 976, 0], [10000, 1000, 0], [10000, 1000, 0], [10000, 1000, 0] , [9855, 5, 187], [11632, 4, 1534], [20756, 2, 9442]]}} Il campo \"intestazione\" nella risposta alla query iniziale viene utilizzato per descrivere i campi trovati nelle risposte \"dati\" successive.","title":"motion_report/dump_stepper"},{"location":"API_Server.html#motion_reportdump_trapq","text":"Questo endpoint viene utilizzato per iscriversi alla \"coda di movimento trapezoidale\" interna di Klipper. L'ottenimento di questi aggiornamenti di movimento di basso livello pu\u00f2 essere utile per scopi diagnostici e di debug. L'utilizzo di questo endpoint pu\u00f2 aumentare il carico di sistema di Klipper. Una richiesta pu\u00f2 essere simile a: {\"id\": 123, \"method\": \"motion_report/dump_trapq\", \"params\": {\"name\": \"toolhead\", \"response_template\":{}}} e potrebbe restituire: {\"id\": 1, \"result\": {\"header\": [\"time\", \"duration\", \"start_velocity\", \"acceleration\", \"start_position\", \"direction\"]}} e potrebbero in seguito produrre messaggi asincroni quali: {\"params\": {\"data\": [[4.05, 1.0, 0.0, 0.0, [300.0, 0.0, 0.0], [0.0, 0.0, 0.0]], [5.054, 0.001, 0.0, 3000.0 , [300.0, 0.0, 0.0], [-1.0, 0.0, 0.0]]]}} Il campo \"intestazione\" nella risposta alla query iniziale viene utilizzato per descrivere i campi trovati nelle risposte \"dati\" successive.","title":"motion_report/dump_trapq"},{"location":"API_Server.html#adxl345dump_adxl345","text":"Questo endpoint viene utilizzato per la sottoscrizione ai dati dell'accelerometro ADXL345. L'ottenimento di questi aggiornamenti di movimento di basso livello pu\u00f2 essere utile per scopi diagnostici e di debug. L'utilizzo di questo endpoint pu\u00f2 aumentare il carico di sistema di Klipper. Una richiesta pu\u00f2 essere simile a: {\"id\": 123, \"method\":\"adxl345/dump_adxl345\", \"params\": {\"sensor\": \"adxl345\", \"response_template\": {}}} e potrebbe restituire: {\"id\": 123,\"result\":{\"header\":[\"time\",\"x_acceleration\",\"y_acceleration\", \"z_acceleration\"]}} e potrebbe in seguito produrre messaggi asincroni come: {\"params \":{\"overflow\":0,\"data\":[[3292.432935,-535.44309,-1529.8374,9561.4], [3292.433256,-382.45935,-1606.32927,9561.48375]]}} Il campo \"intestazione\" nella risposta alla query iniziale viene utilizzato per descrivere i campi trovati nelle risposte \"dati\" successive.","title":"adxl345/dump_adxl345"},{"location":"API_Server.html#angledump_angle","text":"Questo endpoint viene utilizzato per iscriversi a dati del sensore angolare . L'ottenimento di questi aggiornamenti di movimento di basso livello pu\u00f2 essere utile per scopi diagnostici e di debug. L'utilizzo di questo endpoint pu\u00f2 aumentare il carico di sistema di Klipper. Una richiesta pu\u00f2 essere simile a: {\"id\": 123, \"method\":\"angle/dump_angle\", \"params\": {\"sensor\": \"my_angle_sensor\", \"response_template\": {}}} e potrebbe restituire: {\"id\": 123,\"result\":{\"header\":[\"time\",\"angle\"]}} e potrebbe in seguito produrre messaggi asincroni come: {\"params\":{\"position_offset\":3.151562 ,\"errori\":0, \"dati\":[[1290.951905,-5063],[1290.952321,-5065]]}} Il campo \"intestazione\" nella risposta alla query iniziale viene utilizzato per descrivere i campi trovati nelle risposte \"dati\" successive.","title":"angle/dump_angle"},{"location":"API_Server.html#pause_resumecancel","text":"Questo endpoint \u00e8 simile all'esecuzione del comando G-Code \"PRINT_CANCEL\". Ad esempio: {\"id\": 123, \"method\": \"pause_resume/cancel\"} Come con l'endpoint \"gcode/script\", questo endpoint viene completato solo dopo il completamento di tutti i comandi G-Code in sospeso.","title":"pause_resume/cancel"},{"location":"API_Server.html#pause_resumepause","text":"Questo endpoint \u00e8 simile all'esecuzione del comando G-Code \"PAUSE\". Ad esempio: {\"id\": 123, \"method\": \"pause_resume/pause\"} Come con l'endpoint \"gcode/script\", questo endpoint viene completato solo dopo il completamento di tutti i comandi G-Code in sospeso.","title":"pause_resume/pause"},{"location":"API_Server.html#pause_resumeresume","text":"Questo endpoint \u00e8 simile all'esecuzione del comando G-Code \"RESUME\". Ad esempio: {\"id\": 123, \"method\": \"pause_resume/resume\"} Come con l'endpoint \"gcode/script\", questo endpoint viene completato solo dopo il completamento di tutti i comandi G-Code in sospeso.","title":"pause_resume/resume"},{"location":"API_Server.html#query_endstopsstatus","text":"Questo endpoint eseguir\u00e0 una query sugli endpoint attivi e restituir\u00e0 il loro stato. Ad esempio: {\"id\": 123, \"method\": \"query_endstops/status\"} potrebbe restituire: {\"id\": 123, \"result\": {\"y\": \"open\", \"x\": \"aperto\", \"z\": \"TRIGGERED\"}} Come con l'endpoint \"gcode/script\", questo endpoint viene completato solo dopo il completamento di tutti i comandi G-Code in sospeso.","title":"query_endstops/status"},{"location":"BLTouch.html","text":"BL-Touch \u00b6 Collegare BL-Touch \u00b6 Attenzione warning prima di cominciare : Evita di toccare la punta del BL-Touch a mani nude, \u00e8 molto sensibili al sebo delle dita. Se sei costretto usa dei guanti ed evita di spingerla o piegarla. Collega il connettore \"servo\" BL-Touch a un control_pin secondo la documentazione BL-Touch o la documentazione MCU. Usando il cablaggio originale, il filo giallo del triplo \u00e8 il control_pin e il filo bianco della coppia \u00e8 il sensor_pin . \u00c8 necessario configurare questi pin in base al cablaggio. La maggior parte dei dispositivi BL-Touch richiede un pullup sul pin del sensore (prefissare il nome del pin con \"^\"). Per esempio: [bltouch] sensor_pin: ^P1.24 control_pin: P1.26 Se il BL-Touch verr\u00e0 utilizzato per l'home dell'asse Z, impostare endstop_pin: probe:z_virtual_endstop e rimuovere position_endstop nella sezione di configurazione [stepper_z] , quindi aggiungere una sezione di configurazione [safe_z_home] per aumentare il asse z, posiziona gli assi xy, spostati al centro del letto e posizionati sull'asse z. Per esempio: [safe_z_home] home_xy_position: 100, 100 # Cambiare le coordinate per il centro del tuo piatto speed: 50 z_hop: 10 # Move up 10mm z_hop_speed: 5 \u00c8 importante che il movimento z_hop in safe_z_home sia sufficientemente alto in mode che la sonda non colpisca nulla anche se il pin della sonda si trova nel suo stato pi\u00f9 basso. Test iniziali \u00b6 Prima di proseguire, verificare che il BL-Touch sia montato all'altezza corretta, il perno dovrebbe trovarsi a circa 2 mm sopra il nozzle quando \u00e8 retratto Quando si accende la stampante, la sonda BL-Touch dovrebbe eseguire un autotest e spostare il pin su e gi\u00f9 un paio di volte. Una volta completato l'autotest, il perno deve essere retratto e il LED rosso sulla sonda deve essere acceso. In caso di errori, ad esempio la sonda lampeggia in rosso o il pin \u00e8 in basso anzich\u00e9 in alto, spegnere la stampante e controllare il cablaggio e la configurazione. Se quanto sopra sembra buono, \u00e8 il momento di verificare che il pin di controllo funzioni correttamente. Per prima cosa esegui BLTOUCH_DEBUG COMMAND=pin_down nel terminale della tua stampante. Verificare che il pin si abbassi e che il LED rosso sulla sonda si spenga. In caso contrario, controllare nuovamente il cablaggio e la configurazione. Quindi emettere un BLTOUCH_DEBUG COMMAND=pin_up , verificare che il pin si muova verso l'alto e che la luce rossa si accenda di nuovo. Se lampeggia allora c'\u00e8 qualche problema. Il passaggio successivo \u00e8 confermare che il pin del sensore funzioni correttamente. Esegui BLTOUCH_DEBUG COMMAND=pin_down , verifica che il pin si sposti verso il basso, esegui BLTOUCH_DEBUG COMMAND=touch_mode , esegui QUERY_PROBE e verifica che il comando riporti \"probe: open\". Quindi, spingendo leggermente verso l'alto il perno con l'unghia del dito, eseguire nuovamente QUERY_PROBE . Verificare che il comando riporti \"probe: TRIGGERED\". Se una delle query non riporta il messaggio corretto, di solito indica un cablaggio o una configurazione errati (sebbene alcuni clones potrebbero richiedere una gestione speciale). Al completamento di questo test, eseguire BLTOUCH_DEBUG COMMAND=pin_up e verificare che il pin si muova verso l'alto. Dopo aver completato i test del pin di controllo BL-Touch e del pin del sensore, \u00e8 ora il momento di testare il rilevamento, ma con una svolta. Invece di lasciare che il perno della sonda tocchi il piano di stampa, lascia che tocchi l'unghia del dito. Posizionare la testina lontano dal letto, emettere un G28 (o PROBE se non si utilizza probe:z_virtual_endstop), attendere che la testina inizi a muoversi verso il basso e interrompere il movimento toccando molto delicatamente il perno con l'unghia. Potrebbe essere necessario farlo due volte, poich\u00e9 la configurazione di homing predefinita esegue due sonde. Preparati a spegnere la stampante se non si ferma quando tocchi il perno. Se ha avuto successo, esegui un altro G28 (o PROBE ) ma questa volta lascia che tocchi il letto come dovrebbe. BL-Touch andato male \u00b6 Una volta che il BL-Touch \u00e8 in uno stato incoerente, inizia a lampeggiare in rosso. Puoi forzarlo a lasciare quello stato emettendo: BLTOUCH_DEBUG COMMAND=reset Ci\u00f2 pu\u00f2 accadere se la sua calibrazione viene interrotta dal blocco dell'estrazione della sonda. Tuttavia, anche il BL-Touch potrebbe non essere pi\u00f9 in grado di calibrarsi. Ci\u00f2 accade se la vite sulla sua sommit\u00e0 \u00e8 nella posizione sbagliata o se il nucleo magnetico all'interno del perno della sonda si \u00e8 spostato. Se si \u00e8 alzato in modo che si attacchi alla vite, potrebbe non essere pi\u00f9 in grado di abbassare il perno. Con questo comportamento \u00e8 necessario aprire la vite e utilizzare una penna a sfera per spingerla delicatamente in posizione. Reinserire il perno nel BL-Touch in modo che cada nella posizione estratta. Riposizionare con cura la vite senza testa in posizione. \u00c8 necessario trovare la posizione giusta in modo che sia in grado di abbassare e alzare il perno e la luce rossa si accende e si spegne. Usa i comandi reset , pin_up e pin_down per raggiungere questo obiettivo. BL-Touch \"cloni\" \u00b6 Molti dispositivi \"clone\" BL-Touch funzionano correttamente con Klipper utilizzando la configurazione predefinita. Tuttavia, alcuni dispositivi \"clone\" potrebbero non supportare il comando QUERY_PROBE e alcuni dispositivi \"clone\" potrebbero richiedere la configurazione di pin_up_reports_not_triggered o pin_up_touch_mode_reports_triggered . Importante! Non configurare pin_up_reports_not_triggered o pin_up_touch_mode_reports_triggered su False senza prima seguire queste indicazioni. Non configurare nessuno di questi su False su un BL-Touch originale. Un'impostazione errata di questi valori su False pu\u00f2 aumentare il tempo di ispezione e pu\u00f2 aumentare il rischio di danneggiare la stampante. Alcuni dispositivi \"clone\" non supportano touch_mode e di conseguenza il comando QUERY_PROBE non funziona. Nonostante ci\u00f2, potrebbe essere ancora possibile eseguire il rilevamento e l'homing con questi dispositivi. Su questi dispositivi il comando QUERY_PROBE durante i initial tests non avr\u00e0 esito positivo, tuttavia il successivo test G28 (o PROBE ) riesce. Potrebbe essere possibile utilizzare questi dispositivi \"clone\" con Klipper se non si utilizza il comando QUERY_PROBE e se non si abilita la funzione probe_with_touch_mode . Alcuni dispositivi \"clone\" non sono in grado di eseguire il test di verifica del sensore interno di Klipper. Su questi dispositivi, i tentativi di home o probe possono far s\u00ec che Klipper riporti un errore \"BLTouch non \u00e8 riuscito a verificare lo stato del sensore\". In tal caso, eseguire manualmente i passaggi per verificare che il pin del sensore funzioni come descritto nella initial tests section . Se i comandi QUERY_PROBE in quel test producono sempre i risultati attesi e si verificano ancora gli errori \"BLTouch non \u00e8 riuscito a verificare lo stato del sensore\", potrebbe essere necessario impostare pin_up_touch_mode_reports_triggered su False nel file di configurazione di Klipper. Un raro numero di vecchi dispositivi \"clone\" non \u00e8 in grado di segnalare quando hanno sollevato con successo la sonda. Su questi dispositivi Klipper segnaler\u00e0 un errore \"BLTouch non \u00e8 riuscito a sollevare la sonda\" dopo ogni tentativo di home o probe. Si pu\u00f2 testare questi dispositivi: spostare la testa lontano dal letto, eseguire BLTOUCH_DEBUG COMMAND=pin_down , verificare che il pin si sia spostato verso il basso, eseguire QUERY_PROBE , verificare che il comando riporti \"probe: open\", eseguire BLTOUCH_DEBUG COMMAND= pin_up , verifica che il pin sia stato spostato in alto ed esegui QUERY_PROBE . Se il pin rimane attivo, il dispositivo non entra in uno stato di errore e la prima query riporta \"probe: open\" mentre la seconda query riporta \"probe: TRIGGERED\", quindi indica che pin_up_reports_not_triggered dovrebbe essere impostato su False in Klipper file di configurazione. BL-Touch v3 \u00b6 Alcuni dispositivi BL-Touch v3.0 e BL-Touch 3.1 potrebbero richiedere la configurazione di probe_with_touch_mode nel file di configurazione della stampante. Se il BL-Touch v3.0 ha il cavo del segnale collegato a un pin endstop (con un condensatore di filtraggio del rumore), il BL-Touch v3.0 potrebbe non essere in grado di inviare un segnale in modo coerente durante l'homing e il probe. Se i comandi QUERY_PROBE nella initial tests section producono sempre i risultati attesi, ma il toolhead non si ferma sempre durante i comandi G28/PROBE, allora \u00e8 indicativo di questo problema. Una soluzione alternativa consiste nell'impostare probe_with_touch_mode: True nel file di configurazione. Il BL-Touch v3.1 potrebbe entrare erroneamente in uno stato di errore dopo un tentativo di probe riuscito. I sintomi sono una luce lampeggiante occasionale sul BL-Touch v3.1 che dura per un paio di secondi dopo che \u00e8 entrato in contatto con successo con il letto. Klipper dovrebbe cancellare questo errore automaticamente ed \u00e8 generalmente innocuo. Tuttavia, \u00e8 possibile impostare probe_with_touch_mode nel file di configurazione per evitare questo problema. Importante! Alcuni dispositivi \"clone\" e BL-Touch v2.0 (e precedenti) potrebbero avere una precisione ridotta quando probe_with_touch_mode \u00e8 impostato su True. L'impostazione su True aumenta anche il tempo necessario per distribuire la sonda. Se si configura questo valore su un dispositivo BL-Touch \"clone\" o precedente, assicurarsi di testare l'accuratezza della sonda prima e dopo aver impostato questo valore (utilizzare il comando PROBE_ACCURACY per eseguire il test). Multi-sondaggio senza riporre \u00b6 Per impostazione predefinita, Klipper rilascia la sonda all'inizio di ogni tentativo di sonda e poi riporr\u00e0 la sonda in seguito. Questo dispiegamento e stivaggio ripetitivo della sonda pu\u00f2 aumentare il tempo totale delle sequenze di calibrazione che coinvolgono molte misurazioni della sonda. Klipper consente di lasciare la sonda dispiegata tra test consecutivi, il che pu\u00f2 ridurre il tempo totale di rilevamento. Questa modalit\u00e0 \u00e8 abilitata configurando stow_on_each_sample su False nel file di configurazione. Importante! L'impostazione di stow_on_each_sample su False pu\u00f2 portare Klipper a fare movimenti orizzontali della testa utensile mentre la sonda \u00e8 estesa. Assicurarsi di verificare che tutte le operazioni con la probe abbiano un gioco Z sufficiente prima di impostare questo valore su False. Se lo spazio libero \u00e8 insufficiente, uno spostamento orizzontale pu\u00f2 causare l'intrappolamento del perno in un'ostruzione e causare danni alla stampante. Importante! Si consiglia di utilizzare probe_with_touch_mode configurato su True quando si utilizza stow_on_each_sample configurato su False. Alcuni dispositivi \"clone\" potrebbero non rilevare un successivo contatto con il piatto se probe_with_touch_mode non \u00e8 impostato. Su tutti i dispositivi, l'utilizzo della combinazione di queste due impostazioni semplifica la segnalazione del dispositivo, che pu\u00f2 migliorare la stabilit\u00e0 generale. Si noti, tuttavia, che alcuni dispositivi \"clone\" e BL-Touch v2.0 (e precedenti) potrebbero avere una precisione ridotta quando probe_with_touch_mode \u00e8 impostato su True. Su questi dispositivi \u00e8 una buona idea testare l'accuratezza della sonda prima e dopo aver impostato probe_with_touch_mode (usare il comando di test PROBE_ACCURACY ). Calibrazione degli offset BL-Touch \u00b6 Seguire le istruzioni nella guida Probe Calibrate per impostare i parametri di configurazione x_offset, y_offset e z_offset. \u00c8 una buona idea verificare che l'offset Z sia vicino a 1 mm. In caso contrario, probabilmente vorrai spostare la sonda su o gi\u00f9 per risolvere il problema. Si desidera che si attivi ben prima che l'ugello colpisca il piatto, in modo che un possibile filamento bloccato o un piatto deformato non influisca sull'azione della sonda. Ma allo stesso tempo, si desidera che la posizione retratta sia il pi\u00f9 possibile al di sopra dell'ugello per evitare che tocchi le parti stampate. Se viene effettuata una regolazione della posizione della sonda, eseguire nuovamente i passaggi di calibrazione della sonda. Modalit\u00e0 di output BL-Touch \u00b6 Un BL-Touch V3.0 supporta l'impostazione di una modalit\u00e0 di uscita 5V o OPEN-DRAIN, un BL-Touch V3.1 supporta anche questo, ma pu\u00f2 anche memorizzarlo nella sua EEPROM interna. Se la tua scheda controller ha bisogno del livello logico alto 5V fisso della modalit\u00e0 5V, puoi impostare il parametro 'set_output_mode' nella sezione [bltouch] del file di configurazione della stampante su \"5V\". Utilizzare la modalit\u00e0 5V solo se la linea di ingresso della scheda controller \u00e8 tollerante a 5V. Ecco perch\u00e9 la configurazione di default di queste versioni BL-Touch \u00e8 la modalit\u00e0 OPEN-DRAIN. Potresti potenzialmente danneggiare la CPU delle tue schede di controllo Quindi: se una scheda controller HA BISOGNO della modalit\u00e0 5V ED \u00e8 tollerante a 5V sulla sua linea del segnale di ingresso E se si dispone di un BL-Touch Smart V3.0, \u00e8 necessario utilizzare il parametro 'set_output_mode: 5V' per garantire questa impostazione ad ogni avvio, poich\u00e9 la sonda non ricorda l'impostazione necessaria. hai un BL-Touch Smart V3.1, puoi scegliere di usare 'set_output_mode: 5V' o memorizzare la modalit\u00e0 una volta usando un comando 'BLTOUCH_STORE MODE=5V' manualmente e NON usando il parametro 'set_output_mode:'. hai qualche altra sonda: alcune sonde hanno una traccia sul circuito stampato da tagliare o un ponticello da impostare per impostare (permanentemente) la modalit\u00e0 di uscita. In tal caso, omettere completamente il parametro 'set_output_mode'. Se hai una V3.1, non automatizzare o ripetere la memorizzazione della modalit\u00e0 di output per evitare di consumare la EEPROM della sonda. La BLTouch EEPROM \u00e8 valida per circa 100.000 aggiornamenti. 100 memorizzazioni al giorno aggiungerebbero fino a circa 3 anni di attivit\u00e0 prima di logorarlo. Pertanto, la memorizzazione della modalit\u00e0 di output in una V3.1 \u00e8 progettata dal fornitore per essere un'operazione complicata (l'impostazione predefinita di fabbrica \u00e8 una modalit\u00e0 OPEN DRAIN sicura) e non \u00e8 adatta per essere emessa ripetutamente da qualsiasi slicer, macro o altro, esso \u00e8 preferibilmente da utilizzare solo quando si integra per la prima volta la sonda nell'elettronica di una stampante.","title":"BL-Touch"},{"location":"BLTouch.html#bl-touch","text":"","title":"BL-Touch"},{"location":"BLTouch.html#collegare-bl-touch","text":"Attenzione warning prima di cominciare : Evita di toccare la punta del BL-Touch a mani nude, \u00e8 molto sensibili al sebo delle dita. Se sei costretto usa dei guanti ed evita di spingerla o piegarla. Collega il connettore \"servo\" BL-Touch a un control_pin secondo la documentazione BL-Touch o la documentazione MCU. Usando il cablaggio originale, il filo giallo del triplo \u00e8 il control_pin e il filo bianco della coppia \u00e8 il sensor_pin . \u00c8 necessario configurare questi pin in base al cablaggio. La maggior parte dei dispositivi BL-Touch richiede un pullup sul pin del sensore (prefissare il nome del pin con \"^\"). Per esempio: [bltouch] sensor_pin: ^P1.24 control_pin: P1.26 Se il BL-Touch verr\u00e0 utilizzato per l'home dell'asse Z, impostare endstop_pin: probe:z_virtual_endstop e rimuovere position_endstop nella sezione di configurazione [stepper_z] , quindi aggiungere una sezione di configurazione [safe_z_home] per aumentare il asse z, posiziona gli assi xy, spostati al centro del letto e posizionati sull'asse z. Per esempio: [safe_z_home] home_xy_position: 100, 100 # Cambiare le coordinate per il centro del tuo piatto speed: 50 z_hop: 10 # Move up 10mm z_hop_speed: 5 \u00c8 importante che il movimento z_hop in safe_z_home sia sufficientemente alto in mode che la sonda non colpisca nulla anche se il pin della sonda si trova nel suo stato pi\u00f9 basso.","title":"Collegare BL-Touch"},{"location":"BLTouch.html#test-iniziali","text":"Prima di proseguire, verificare che il BL-Touch sia montato all'altezza corretta, il perno dovrebbe trovarsi a circa 2 mm sopra il nozzle quando \u00e8 retratto Quando si accende la stampante, la sonda BL-Touch dovrebbe eseguire un autotest e spostare il pin su e gi\u00f9 un paio di volte. Una volta completato l'autotest, il perno deve essere retratto e il LED rosso sulla sonda deve essere acceso. In caso di errori, ad esempio la sonda lampeggia in rosso o il pin \u00e8 in basso anzich\u00e9 in alto, spegnere la stampante e controllare il cablaggio e la configurazione. Se quanto sopra sembra buono, \u00e8 il momento di verificare che il pin di controllo funzioni correttamente. Per prima cosa esegui BLTOUCH_DEBUG COMMAND=pin_down nel terminale della tua stampante. Verificare che il pin si abbassi e che il LED rosso sulla sonda si spenga. In caso contrario, controllare nuovamente il cablaggio e la configurazione. Quindi emettere un BLTOUCH_DEBUG COMMAND=pin_up , verificare che il pin si muova verso l'alto e che la luce rossa si accenda di nuovo. Se lampeggia allora c'\u00e8 qualche problema. Il passaggio successivo \u00e8 confermare che il pin del sensore funzioni correttamente. Esegui BLTOUCH_DEBUG COMMAND=pin_down , verifica che il pin si sposti verso il basso, esegui BLTOUCH_DEBUG COMMAND=touch_mode , esegui QUERY_PROBE e verifica che il comando riporti \"probe: open\". Quindi, spingendo leggermente verso l'alto il perno con l'unghia del dito, eseguire nuovamente QUERY_PROBE . Verificare che il comando riporti \"probe: TRIGGERED\". Se una delle query non riporta il messaggio corretto, di solito indica un cablaggio o una configurazione errati (sebbene alcuni clones potrebbero richiedere una gestione speciale). Al completamento di questo test, eseguire BLTOUCH_DEBUG COMMAND=pin_up e verificare che il pin si muova verso l'alto. Dopo aver completato i test del pin di controllo BL-Touch e del pin del sensore, \u00e8 ora il momento di testare il rilevamento, ma con una svolta. Invece di lasciare che il perno della sonda tocchi il piano di stampa, lascia che tocchi l'unghia del dito. Posizionare la testina lontano dal letto, emettere un G28 (o PROBE se non si utilizza probe:z_virtual_endstop), attendere che la testina inizi a muoversi verso il basso e interrompere il movimento toccando molto delicatamente il perno con l'unghia. Potrebbe essere necessario farlo due volte, poich\u00e9 la configurazione di homing predefinita esegue due sonde. Preparati a spegnere la stampante se non si ferma quando tocchi il perno. Se ha avuto successo, esegui un altro G28 (o PROBE ) ma questa volta lascia che tocchi il letto come dovrebbe.","title":"Test iniziali"},{"location":"BLTouch.html#bl-touch-andato-male","text":"Una volta che il BL-Touch \u00e8 in uno stato incoerente, inizia a lampeggiare in rosso. Puoi forzarlo a lasciare quello stato emettendo: BLTOUCH_DEBUG COMMAND=reset Ci\u00f2 pu\u00f2 accadere se la sua calibrazione viene interrotta dal blocco dell'estrazione della sonda. Tuttavia, anche il BL-Touch potrebbe non essere pi\u00f9 in grado di calibrarsi. Ci\u00f2 accade se la vite sulla sua sommit\u00e0 \u00e8 nella posizione sbagliata o se il nucleo magnetico all'interno del perno della sonda si \u00e8 spostato. Se si \u00e8 alzato in modo che si attacchi alla vite, potrebbe non essere pi\u00f9 in grado di abbassare il perno. Con questo comportamento \u00e8 necessario aprire la vite e utilizzare una penna a sfera per spingerla delicatamente in posizione. Reinserire il perno nel BL-Touch in modo che cada nella posizione estratta. Riposizionare con cura la vite senza testa in posizione. \u00c8 necessario trovare la posizione giusta in modo che sia in grado di abbassare e alzare il perno e la luce rossa si accende e si spegne. Usa i comandi reset , pin_up e pin_down per raggiungere questo obiettivo.","title":"BL-Touch andato male"},{"location":"BLTouch.html#bl-touch-cloni","text":"Molti dispositivi \"clone\" BL-Touch funzionano correttamente con Klipper utilizzando la configurazione predefinita. Tuttavia, alcuni dispositivi \"clone\" potrebbero non supportare il comando QUERY_PROBE e alcuni dispositivi \"clone\" potrebbero richiedere la configurazione di pin_up_reports_not_triggered o pin_up_touch_mode_reports_triggered . Importante! Non configurare pin_up_reports_not_triggered o pin_up_touch_mode_reports_triggered su False senza prima seguire queste indicazioni. Non configurare nessuno di questi su False su un BL-Touch originale. Un'impostazione errata di questi valori su False pu\u00f2 aumentare il tempo di ispezione e pu\u00f2 aumentare il rischio di danneggiare la stampante. Alcuni dispositivi \"clone\" non supportano touch_mode e di conseguenza il comando QUERY_PROBE non funziona. Nonostante ci\u00f2, potrebbe essere ancora possibile eseguire il rilevamento e l'homing con questi dispositivi. Su questi dispositivi il comando QUERY_PROBE durante i initial tests non avr\u00e0 esito positivo, tuttavia il successivo test G28 (o PROBE ) riesce. Potrebbe essere possibile utilizzare questi dispositivi \"clone\" con Klipper se non si utilizza il comando QUERY_PROBE e se non si abilita la funzione probe_with_touch_mode . Alcuni dispositivi \"clone\" non sono in grado di eseguire il test di verifica del sensore interno di Klipper. Su questi dispositivi, i tentativi di home o probe possono far s\u00ec che Klipper riporti un errore \"BLTouch non \u00e8 riuscito a verificare lo stato del sensore\". In tal caso, eseguire manualmente i passaggi per verificare che il pin del sensore funzioni come descritto nella initial tests section . Se i comandi QUERY_PROBE in quel test producono sempre i risultati attesi e si verificano ancora gli errori \"BLTouch non \u00e8 riuscito a verificare lo stato del sensore\", potrebbe essere necessario impostare pin_up_touch_mode_reports_triggered su False nel file di configurazione di Klipper. Un raro numero di vecchi dispositivi \"clone\" non \u00e8 in grado di segnalare quando hanno sollevato con successo la sonda. Su questi dispositivi Klipper segnaler\u00e0 un errore \"BLTouch non \u00e8 riuscito a sollevare la sonda\" dopo ogni tentativo di home o probe. Si pu\u00f2 testare questi dispositivi: spostare la testa lontano dal letto, eseguire BLTOUCH_DEBUG COMMAND=pin_down , verificare che il pin si sia spostato verso il basso, eseguire QUERY_PROBE , verificare che il comando riporti \"probe: open\", eseguire BLTOUCH_DEBUG COMMAND= pin_up , verifica che il pin sia stato spostato in alto ed esegui QUERY_PROBE . Se il pin rimane attivo, il dispositivo non entra in uno stato di errore e la prima query riporta \"probe: open\" mentre la seconda query riporta \"probe: TRIGGERED\", quindi indica che pin_up_reports_not_triggered dovrebbe essere impostato su False in Klipper file di configurazione.","title":"BL-Touch \"cloni\""},{"location":"BLTouch.html#bl-touch-v3","text":"Alcuni dispositivi BL-Touch v3.0 e BL-Touch 3.1 potrebbero richiedere la configurazione di probe_with_touch_mode nel file di configurazione della stampante. Se il BL-Touch v3.0 ha il cavo del segnale collegato a un pin endstop (con un condensatore di filtraggio del rumore), il BL-Touch v3.0 potrebbe non essere in grado di inviare un segnale in modo coerente durante l'homing e il probe. Se i comandi QUERY_PROBE nella initial tests section producono sempre i risultati attesi, ma il toolhead non si ferma sempre durante i comandi G28/PROBE, allora \u00e8 indicativo di questo problema. Una soluzione alternativa consiste nell'impostare probe_with_touch_mode: True nel file di configurazione. Il BL-Touch v3.1 potrebbe entrare erroneamente in uno stato di errore dopo un tentativo di probe riuscito. I sintomi sono una luce lampeggiante occasionale sul BL-Touch v3.1 che dura per un paio di secondi dopo che \u00e8 entrato in contatto con successo con il letto. Klipper dovrebbe cancellare questo errore automaticamente ed \u00e8 generalmente innocuo. Tuttavia, \u00e8 possibile impostare probe_with_touch_mode nel file di configurazione per evitare questo problema. Importante! Alcuni dispositivi \"clone\" e BL-Touch v2.0 (e precedenti) potrebbero avere una precisione ridotta quando probe_with_touch_mode \u00e8 impostato su True. L'impostazione su True aumenta anche il tempo necessario per distribuire la sonda. Se si configura questo valore su un dispositivo BL-Touch \"clone\" o precedente, assicurarsi di testare l'accuratezza della sonda prima e dopo aver impostato questo valore (utilizzare il comando PROBE_ACCURACY per eseguire il test).","title":"BL-Touch v3"},{"location":"BLTouch.html#multi-sondaggio-senza-riporre","text":"Per impostazione predefinita, Klipper rilascia la sonda all'inizio di ogni tentativo di sonda e poi riporr\u00e0 la sonda in seguito. Questo dispiegamento e stivaggio ripetitivo della sonda pu\u00f2 aumentare il tempo totale delle sequenze di calibrazione che coinvolgono molte misurazioni della sonda. Klipper consente di lasciare la sonda dispiegata tra test consecutivi, il che pu\u00f2 ridurre il tempo totale di rilevamento. Questa modalit\u00e0 \u00e8 abilitata configurando stow_on_each_sample su False nel file di configurazione. Importante! L'impostazione di stow_on_each_sample su False pu\u00f2 portare Klipper a fare movimenti orizzontali della testa utensile mentre la sonda \u00e8 estesa. Assicurarsi di verificare che tutte le operazioni con la probe abbiano un gioco Z sufficiente prima di impostare questo valore su False. Se lo spazio libero \u00e8 insufficiente, uno spostamento orizzontale pu\u00f2 causare l'intrappolamento del perno in un'ostruzione e causare danni alla stampante. Importante! Si consiglia di utilizzare probe_with_touch_mode configurato su True quando si utilizza stow_on_each_sample configurato su False. Alcuni dispositivi \"clone\" potrebbero non rilevare un successivo contatto con il piatto se probe_with_touch_mode non \u00e8 impostato. Su tutti i dispositivi, l'utilizzo della combinazione di queste due impostazioni semplifica la segnalazione del dispositivo, che pu\u00f2 migliorare la stabilit\u00e0 generale. Si noti, tuttavia, che alcuni dispositivi \"clone\" e BL-Touch v2.0 (e precedenti) potrebbero avere una precisione ridotta quando probe_with_touch_mode \u00e8 impostato su True. Su questi dispositivi \u00e8 una buona idea testare l'accuratezza della sonda prima e dopo aver impostato probe_with_touch_mode (usare il comando di test PROBE_ACCURACY ).","title":"Multi-sondaggio senza riporre"},{"location":"BLTouch.html#calibrazione-degli-offset-bl-touch","text":"Seguire le istruzioni nella guida Probe Calibrate per impostare i parametri di configurazione x_offset, y_offset e z_offset. \u00c8 una buona idea verificare che l'offset Z sia vicino a 1 mm. In caso contrario, probabilmente vorrai spostare la sonda su o gi\u00f9 per risolvere il problema. Si desidera che si attivi ben prima che l'ugello colpisca il piatto, in modo che un possibile filamento bloccato o un piatto deformato non influisca sull'azione della sonda. Ma allo stesso tempo, si desidera che la posizione retratta sia il pi\u00f9 possibile al di sopra dell'ugello per evitare che tocchi le parti stampate. Se viene effettuata una regolazione della posizione della sonda, eseguire nuovamente i passaggi di calibrazione della sonda.","title":"Calibrazione degli offset BL-Touch"},{"location":"BLTouch.html#modalita-di-output-bl-touch","text":"Un BL-Touch V3.0 supporta l'impostazione di una modalit\u00e0 di uscita 5V o OPEN-DRAIN, un BL-Touch V3.1 supporta anche questo, ma pu\u00f2 anche memorizzarlo nella sua EEPROM interna. Se la tua scheda controller ha bisogno del livello logico alto 5V fisso della modalit\u00e0 5V, puoi impostare il parametro 'set_output_mode' nella sezione [bltouch] del file di configurazione della stampante su \"5V\". Utilizzare la modalit\u00e0 5V solo se la linea di ingresso della scheda controller \u00e8 tollerante a 5V. Ecco perch\u00e9 la configurazione di default di queste versioni BL-Touch \u00e8 la modalit\u00e0 OPEN-DRAIN. Potresti potenzialmente danneggiare la CPU delle tue schede di controllo Quindi: se una scheda controller HA BISOGNO della modalit\u00e0 5V ED \u00e8 tollerante a 5V sulla sua linea del segnale di ingresso E se si dispone di un BL-Touch Smart V3.0, \u00e8 necessario utilizzare il parametro 'set_output_mode: 5V' per garantire questa impostazione ad ogni avvio, poich\u00e9 la sonda non ricorda l'impostazione necessaria. hai un BL-Touch Smart V3.1, puoi scegliere di usare 'set_output_mode: 5V' o memorizzare la modalit\u00e0 una volta usando un comando 'BLTOUCH_STORE MODE=5V' manualmente e NON usando il parametro 'set_output_mode:'. hai qualche altra sonda: alcune sonde hanno una traccia sul circuito stampato da tagliare o un ponticello da impostare per impostare (permanentemente) la modalit\u00e0 di uscita. In tal caso, omettere completamente il parametro 'set_output_mode'. Se hai una V3.1, non automatizzare o ripetere la memorizzazione della modalit\u00e0 di output per evitare di consumare la EEPROM della sonda. La BLTouch EEPROM \u00e8 valida per circa 100.000 aggiornamenti. 100 memorizzazioni al giorno aggiungerebbero fino a circa 3 anni di attivit\u00e0 prima di logorarlo. Pertanto, la memorizzazione della modalit\u00e0 di output in una V3.1 \u00e8 progettata dal fornitore per essere un'operazione complicata (l'impostazione predefinita di fabbrica \u00e8 una modalit\u00e0 OPEN DRAIN sicura) e non \u00e8 adatta per essere emessa ripetutamente da qualsiasi slicer, macro o altro, esso \u00e8 preferibilmente da utilizzare solo quando si integra per la prima volta la sonda nell'elettronica di una stampante.","title":"Modalit\u00e0 di output BL-Touch"},{"location":"Beaglebone.html","text":"Beaglebone \u00b6 Questo documento descrive il processo di esecuzione di Klipper su una PRU Beaglebone. Creazione di un'immagine del sistema operativo \u00b6 Inizia installando l'immagine Debian 9.9 2019-08-03 4GB SD IoT . \u00c8 possibile eseguire l'immagine da una scheda micro-SD o dall'eMMC integrato. Se si utilizza l'eMMC, installarlo ora nell'eMMC seguendo le istruzioni dal collegamento sopra. Quindi loggati ssh nella macchina Beaglebone ( ssh debian@beaglebone -- la password \u00e8 temppwd ) e installa Klipper eseguendo i seguenti comandi: git clone https://github.com/Klipper3d/klipper ./klipper/scripts/install-beaglebone.sh Installare Octoprint \u00b6 Si pu\u00f2 quindi installare Octoprint: git clone https://github.com/foosel/OctoPrint.git cd OctoPrint/ virtualenv venv ./venv/bin/python setup.py install E configura OctoPrint per l'avvio all'avvio: sudo cp ~/OctoPrint/scripts/octoprint.init /etc/init.d/octoprint sudo chmod +x /etc/init.d/octoprint sudo cp ~/OctoPrint/scripts/octoprint.default /etc/default/octoprint sudo update-rc.d octoprint defaults \u00c8 necessario modificare il file di configurazione /etc/default/octoprint di OctoPrint. Si deve cambiare l'utente OCTOPRINT_USER in debian , cambiare NICELEVEL in 0 , togliere il commento alle impostazioni di BASEDIR , CONFIGFILE e DAEMON e cambiare i riferimenti della home da /home/pi/ a /home/debian/ : sudo nano /etc/default/octoprint Quindi avvia il servizio Octoprint: sudo systemctl start octoprint Assicurati che il server web OctoPrint sia accessibile - dovrebbe trovarsi su: http://beaglebone:5000/ Creazione del codice del microcontrollore \u00b6 Per compilare il codice del microcontrollore Klipper, inizia configurandolo per il \"Beaglebone PRU\": cd ~/klipper/ make menuconfig Per compilare e installare il nuovo codice del microcontrollore, eseguire: sudo service klipper stop make flash sudo service klipper start \u00c8 inoltre necessario compilare e installare il codice del microcontrollore per un processo host Linux. Configuralo per un \"processo Linux\": make menuconfig Quindi installa anche questo codice del microcontrollore: sudo service klipper stop make flash sudo service klipper start Configurazione rimanente \u00b6 Completare l'installazione configurando Klipper e Octoprint seguendo le istruzioni nel documento principale Installation . Stampa sul Beaglebone \u00b6 Sfortunatamente, il processore Beaglebone a volte pu\u00f2 avere difficolt\u00e0 a far funzionare bene OctoPrint. \u00c8 noto che i blocchi di stampa si verificano su stampe complesse (la stampante potrebbe muoversi pi\u00f9 velocemente di quanto OctoPrint possa inviare comandi di movimento). In questo caso, considera l'utilizzo della funzione \"virtual_sdcard\" (consulta Config Reference per i dettagli) per stampare direttamente da Klipper.","title":"Beaglebone"},{"location":"Beaglebone.html#beaglebone","text":"Questo documento descrive il processo di esecuzione di Klipper su una PRU Beaglebone.","title":"Beaglebone"},{"location":"Beaglebone.html#creazione-di-unimmagine-del-sistema-operativo","text":"Inizia installando l'immagine Debian 9.9 2019-08-03 4GB SD IoT . \u00c8 possibile eseguire l'immagine da una scheda micro-SD o dall'eMMC integrato. Se si utilizza l'eMMC, installarlo ora nell'eMMC seguendo le istruzioni dal collegamento sopra. Quindi loggati ssh nella macchina Beaglebone ( ssh debian@beaglebone -- la password \u00e8 temppwd ) e installa Klipper eseguendo i seguenti comandi: git clone https://github.com/Klipper3d/klipper ./klipper/scripts/install-beaglebone.sh","title":"Creazione di un'immagine del sistema operativo"},{"location":"Beaglebone.html#installare-octoprint","text":"Si pu\u00f2 quindi installare Octoprint: git clone https://github.com/foosel/OctoPrint.git cd OctoPrint/ virtualenv venv ./venv/bin/python setup.py install E configura OctoPrint per l'avvio all'avvio: sudo cp ~/OctoPrint/scripts/octoprint.init /etc/init.d/octoprint sudo chmod +x /etc/init.d/octoprint sudo cp ~/OctoPrint/scripts/octoprint.default /etc/default/octoprint sudo update-rc.d octoprint defaults \u00c8 necessario modificare il file di configurazione /etc/default/octoprint di OctoPrint. Si deve cambiare l'utente OCTOPRINT_USER in debian , cambiare NICELEVEL in 0 , togliere il commento alle impostazioni di BASEDIR , CONFIGFILE e DAEMON e cambiare i riferimenti della home da /home/pi/ a /home/debian/ : sudo nano /etc/default/octoprint Quindi avvia il servizio Octoprint: sudo systemctl start octoprint Assicurati che il server web OctoPrint sia accessibile - dovrebbe trovarsi su: http://beaglebone:5000/","title":"Installare Octoprint"},{"location":"Beaglebone.html#creazione-del-codice-del-microcontrollore","text":"Per compilare il codice del microcontrollore Klipper, inizia configurandolo per il \"Beaglebone PRU\": cd ~/klipper/ make menuconfig Per compilare e installare il nuovo codice del microcontrollore, eseguire: sudo service klipper stop make flash sudo service klipper start \u00c8 inoltre necessario compilare e installare il codice del microcontrollore per un processo host Linux. Configuralo per un \"processo Linux\": make menuconfig Quindi installa anche questo codice del microcontrollore: sudo service klipper stop make flash sudo service klipper start","title":"Creazione del codice del microcontrollore"},{"location":"Beaglebone.html#configurazione-rimanente","text":"Completare l'installazione configurando Klipper e Octoprint seguendo le istruzioni nel documento principale Installation .","title":"Configurazione rimanente"},{"location":"Beaglebone.html#stampa-sul-beaglebone","text":"Sfortunatamente, il processore Beaglebone a volte pu\u00f2 avere difficolt\u00e0 a far funzionare bene OctoPrint. \u00c8 noto che i blocchi di stampa si verificano su stampe complesse (la stampante potrebbe muoversi pi\u00f9 velocemente di quanto OctoPrint possa inviare comandi di movimento). In questo caso, considera l'utilizzo della funzione \"virtual_sdcard\" (consulta Config Reference per i dettagli) per stampare direttamente da Klipper.","title":"Stampa sul Beaglebone"},{"location":"Bed_Level.html","text":"Livellamento del piatto \u00b6 La livellatura del piatto \u00e8 fondamentale per ottenere stampe di alta qualit\u00e0. Se un piatto non \u00e8 adeguatamente \"livellato\" pu\u00f2 portare a una scarsa adesione sul piatto, a una \"deformazione\" e a problemi minori durante la stampa. Questo documento serve come guida per eseguire il livellamento del piatto in Klipper. \u00c8 importante comprendere l'obiettivo del livellamento del piatto. Se alla stampante viene comandata una posizione X0 Y0 Z10 durante una stampa, l'obiettivo \u00e8 che l'ugello della stampante si trovi esattamente a 10 mm dal piatto della stampante. Inoltre, se poi la stampante dovesse essere comandata in una posizione di X50 Z10 , l'obiettivo \u00e8 che l'ugello mantenga una distanza esatta di 10 mm dal piatto durante l'intero movimento orizzontale. Per ottenere stampe di buona qualit\u00e0, la stampante deve essere calibrata in modo che le distanze Z siano precise entro circa 25 micron (0,025 mm). Questa \u00e8 una piccola distanza, significativamente pi\u00f9 piccola della larghezza di un tipico capello umano. Questa scala non pu\u00f2 essere misurata \"a occhio\". Gli effetti sottili (come l'espansione del calore) influiscono sulle misurazioni a questa scala. Il segreto per ottenere un'elevata precisione \u00e8 utilizzare un processo ripetibile e un metodo di livellamento che sfrutti l'elevata precisione del sistema di movimento della stampante. Scegliere il meccanismo di calibrazione appropriato \u00b6 Diversi tipi di stampanti utilizzano metodi diversi per eseguire il livellamento del piatto. Tutti alla fine dipendono dal \"test cartaceo\" (descritto di seguito). Tuttavia, il processo effettivo per un particolare tipo di stampante \u00e8 descritto in altri documenti. Prima di eseguire uno di questi strumenti di calibrazione, assicurarsi di eseguire i controlli descritti nel documento check di configurazione . \u00c8 necessario verificare il movimento di base della stampante prima di eseguire il livellamento del piatto. Per le stampanti con una \"sonda Z automatica\", assicurarsi di calibrare la sonda seguendo le istruzioni nel documento Probe Calibrate . Per le stampanti delta, vedere il documento Delta Calibrate . Per le stampanti con viti di fissaggio e fermi Z tradizionali, vedere il documento Manual Level . Durante la calibrazione potrebbe essere necessario impostare la Z position_min della stampante su un numero negativo (ad esempio, position_min = -2 ). La stampante applica i controlli dei confini anche durante le routine di calibrazione. L'impostazione di un numero negativo consente alla stampante di spostarsi al di sotto della posizione nominale del piatto, il che pu\u00f2 aiutare quando si tenta di determinare la posizione effettiva del piatto. Il \"test con la carta\" \u00b6 Il meccanismo primario di calibrazione del piatto primario \u00e8 il \"test della carta\". Si tratta di posizionare un normale pezzo di \"carta per fotocopiatrice\" tra il piatto della stampante e l'ugello, quindi comandare l'ugello a diverse altezze Z finch\u00e9 non si avverte una piccola quantit\u00e0 di attrito quando si spinge la carta avanti e indietro. \u00c8 importante comprendere il \"test della carta\" anche se si dispone di una \"sonda Z automatica\". La sonda stessa deve spesso essere calibrata per ottenere buoni risultati. La calibrazione della sonda viene eseguita utilizzando questo \"test della carta\". Per eseguire il test della carta, taglia un piccolo pezzo di carta rettangolare usando un paio di forbici (es. 5x3 cm). La carta ha generalmente uno spessore di circa 100 micron (0,100 mm). (Lo spessore esatto della carta non \u00e8 cruciale.) Il primo passaggio del test della carta consiste nell'ispezione dell'ugello e del piatto della stampante. Assicurati che non ci sia plastica (o altri detriti) sull'ugello o sul letto. Ispeziona l'ugello e il piatto per assicurarti che non sia presente plastica! Se si stampa sempre su un determinato nastro o superficie di stampa, \u00e8 possibile eseguire il test della carta con quel nastro/superficie in posizione. Tuttavia, tieni presente che il nastro stesso ha uno spessore e nastri diversi (o qualsiasi altra superficie di stampa) influiranno sulle misurazioni Z. Assicurati di eseguire nuovamente il test della carta per misurare ogni tipo di superficie in uso. Se c'\u00e8 della plastica sull'ugello, riscalda l'estrusore e usa una pinzetta di metallo per rimuovere quella plastica. Attendere che l'estrusore si raffreddi completamente a temperatura ambiente prima di continuare con il test della carta. Mentre l'ugello si sta raffreddando, usa le pinzette di metallo per rimuovere la plastica che potrebbe fuoriuscire. Esegui sempre il test della carta quando sia l'ugello che il letto sono a temperatura ambiente! Quando l'ugello \u00e8 riscaldato, la sua posizione (rispetto al piatto) cambia a causa dell'espansione termica. Questa espansione termica \u00e8 in genere di circa 100 micron, che ha all'incirca lo stesso spessore di un tipico pezzo di carta per stampante. L'esatta quantit\u00e0 di espansione termica non \u00e8 cruciale, cos\u00ec come lo spessore esatto della carta non \u00e8 cruciale. Inizia con il presupposto che i due siano uguali (vedi sotto per un metodo per determinare la differenza tra le due distanze). Pu\u00f2 sembrare strano calibrare la distanza a temperatura ambiente quando l'obiettivo \u00e8 avere una distanza costante quando riscaldata. Tuttavia, se si calibra quando l'ugello \u00e8 riscaldato, tende a rilasciare piccole quantit\u00e0 di plastica fusa alla carta, il che cambia la quantit\u00e0 di attrito sentito. Ci\u00f2 rende pi\u00f9 difficile ottenere una buona calibrazione. La calibrazione mentre il letto/ugello \u00e8 caldo aumenta notevolmente anche il rischio di ustione. La quantit\u00e0 di espansione termica \u00e8 stabile, quindi \u00e8 facilmente contabilizzabile pi\u00f9 avanti nel processo di calibrazione. Utilizza uno strumento automatizzato per determinare l'altezza Z precisa! Klipper ha diversi script di supporto disponibili (ad esempio, MANUAL_PROBE, Z_ENDSTOP_CALIBRATE, PROBE_CALIBRATE, DELTA_CALIBRATE). Consulta i documenti descritti sopra per sceglierne uno. Eseguire il comando appropriato nella finestra del terminale di OctoPrint. Lo script richieder\u00e0 l'interazione dell'utente nell'output del terminale OctoPrint. Sembrer\u00e0 qualcosa come: Recv: // Starting manual Z probe. Use TESTZ to adjust position. Recv: // Finish with ACCEPT or ABORT command. Recv: // Z position: ?????? --> 5.000 <-- ?????? L'altezza attuale dell'ugello (come la intende attualmente la stampante) \u00e8 mostrata tra \"--> <--\". Il numero a destra \u00e8 l'altezza dell'ultimo tentativo di sonda appena maggiore dell'altezza attuale e a sinistra \u00e8 l'ultimo tentativo di sonda inferiore all'altezza attuale (o ?????? se non \u00e8 stato effettuato alcun tentativo). Metti la carta tra l'ugello e il letto. Pu\u00f2 essere utile piegare un angolo della carta in modo che sia pi\u00f9 facile da afferrare. (Cerca di non spingere il piatto quando muovi la carta avanti e indietro.) Utilizzare il comando TESTZ per richiedere all'ugello di avvicinarsi alla carta. Per esempio: TESTZ Z=-.1 Il comando TESTZ sposter\u00e0 l'ugello di una distanza relativa dalla posizione corrente dell'ugello. (Quindi, Z=-.1 richiede che l'ugello si avvicini al piatto di 0,1 mm.) Dopo che l'ugello ha smesso di muoversi, spingere la carta avanti e indietro per controllare se l'ugello \u00e8 in contatto con la carta e per sentire la quantit\u00e0 di attrito. Continua a emettere comandi TESTZ finch\u00e9 non si avverte una piccola quantit\u00e0 di attrito durante il test con la carta. Se si trova troppo attrito, \u00e8 possibile utilizzare un valore Z positivo per spostare l'ugello verso l'alto. \u00c8 anche possibile utilizzare TESTZ Z=+ o TESTZ Z=- per \"sezionare in due\" l'ultima posizione, ovvero per spostarsi in una posizione a met\u00e0 strada tra due posizioni. Ad esempio, se si riceve il seguente prompt da un comando TESTZ: Recv: // Z position: 0.130 --> 0.230 <-- 0.280 Quindi un TESTZ Z=- sposterebbe l'ugello in una posizione Z di 0,180 (a met\u00e0 strada tra 0,130 e 0,230). \u00c8 possibile utilizzare questa funzione per ridurre rapidamente a un attrito costante. \u00c8 anche possibile usare Z=++ e Z=-- per tornare direttamente a una misurazione passata - per esempio, dopo il prompt sopra un comando TESTZ Z=-- sposterebbe l'ugello su una Z posizione di 0,130. Dopo aver trovato una piccola quantit\u00e0 di attrito, eseguire il comando ACCETTA: ACCEPT Questo accetter\u00e0 l'altezza Z data e proceder\u00e0 con lo strumento di calibrazione fornito. L'esatta quantit\u00e0 di attrito percepito non \u00e8 cruciale, cos\u00ec come la quantit\u00e0 di espansione termica e l'esatta larghezza della carta non sono cruciali. Cerca solo di ottenere la stessa quantit\u00e0 di attrito ogni volta che esegui il test. Se qualcosa va storto durante il test, \u00e8 possibile utilizzare il comando ABORT per uscire dallo strumento di calibrazione. Determinare l'espansione termica \u00b6 Dopo aver eseguito con successo il livellamento del piatto, si pu\u00f2 continuare a calcolare un valore pi\u00f9 preciso per l'impatto combinato di \"espansione termica\", \"spessore della carta\" e \"quantit\u00e0 di attrito sentito durante il test della carta\". Questo tipo di calcolo generalmente non \u00e8 necessario poich\u00e9 la maggior parte degli utenti ritiene che il semplice \"test cartaceo\" fornisca buoni risultati. Il modo pi\u00f9 semplice per eseguire questo calcolo \u00e8 stampare un oggetto di prova con pareti dritte su tutti i lati. Il cubo vuoto che si trova in docs/prints/square.stl pu\u00f2 essere usato per questo. Quando si fa lo slicing l'oggetto, assicurarsi che lo slicer utilizzi la stessa altezza del livello e la stessa larghezza di estrusione per il primo livello che utilizza per tutti i livelli successivi. Utilizzare un'altezza dello strato grossolana (l'altezza dello strato dovrebbe essere circa il 75% del diametro dell'ugello) e non utilizzare un bordo o una raft. Stampa l'oggetto di prova, attendi che si raffreddi e rimuovilo dal piatto. Ispeziona lo strato pi\u00f9 basso dell'oggetto. (Pu\u00f2 anche essere utile far scorrere un dito o un'unghia lungo il bordo inferiore.) Se si scopre che lo strato inferiore si gonfia leggermente lungo tutti i lati dell'oggetto, significa che l'ugello era leggermente pi\u00f9 vicino al piatto di quanto dovrebbe essere. Si pu\u00f2 emettere un comando SET_GCODE_OFFSET Z=+.010 per aumentare l'altezza. Nelle stampe successive \u00e8 possibile controllare questo comportamento e apportare ulteriori modifiche secondo necessit\u00e0. Le regolazioni di questo tipo sono in genere in 10 micron (0,010 mm). Se il livello inferiore appare costantemente pi\u00f9 stretto dei livelli successivi, \u00e8 possibile utilizzare il comando SET_GCODE_OFFSET per effettuare una regolazione Z negativa. Se non si \u00e8 sicuri, \u00e8 possibile diminuire la regolazione Z finch\u00e9 lo strato inferiore delle stampe non mostra un piccolo rigonfiamento, quindi arretrare finch\u00e9 non scompare. Il modo pi\u00f9 semplice per applicare la regolazione Z desiderata \u00e8 creare una macro di G-code START_PRINT, fare in modo che lo slicer chiami quella macro all'inizio di ogni stampa e aggiungere un comando SET_GCODE_OFFSET a quella macro. Per ulteriori dettagli, vedere il documento slicers .","title":"Livellamento del piatto"},{"location":"Bed_Level.html#livellamento-del-piatto","text":"La livellatura del piatto \u00e8 fondamentale per ottenere stampe di alta qualit\u00e0. Se un piatto non \u00e8 adeguatamente \"livellato\" pu\u00f2 portare a una scarsa adesione sul piatto, a una \"deformazione\" e a problemi minori durante la stampa. Questo documento serve come guida per eseguire il livellamento del piatto in Klipper. \u00c8 importante comprendere l'obiettivo del livellamento del piatto. Se alla stampante viene comandata una posizione X0 Y0 Z10 durante una stampa, l'obiettivo \u00e8 che l'ugello della stampante si trovi esattamente a 10 mm dal piatto della stampante. Inoltre, se poi la stampante dovesse essere comandata in una posizione di X50 Z10 , l'obiettivo \u00e8 che l'ugello mantenga una distanza esatta di 10 mm dal piatto durante l'intero movimento orizzontale. Per ottenere stampe di buona qualit\u00e0, la stampante deve essere calibrata in modo che le distanze Z siano precise entro circa 25 micron (0,025 mm). Questa \u00e8 una piccola distanza, significativamente pi\u00f9 piccola della larghezza di un tipico capello umano. Questa scala non pu\u00f2 essere misurata \"a occhio\". Gli effetti sottili (come l'espansione del calore) influiscono sulle misurazioni a questa scala. Il segreto per ottenere un'elevata precisione \u00e8 utilizzare un processo ripetibile e un metodo di livellamento che sfrutti l'elevata precisione del sistema di movimento della stampante.","title":"Livellamento del piatto"},{"location":"Bed_Level.html#scegliere-il-meccanismo-di-calibrazione-appropriato","text":"Diversi tipi di stampanti utilizzano metodi diversi per eseguire il livellamento del piatto. Tutti alla fine dipendono dal \"test cartaceo\" (descritto di seguito). Tuttavia, il processo effettivo per un particolare tipo di stampante \u00e8 descritto in altri documenti. Prima di eseguire uno di questi strumenti di calibrazione, assicurarsi di eseguire i controlli descritti nel documento check di configurazione . \u00c8 necessario verificare il movimento di base della stampante prima di eseguire il livellamento del piatto. Per le stampanti con una \"sonda Z automatica\", assicurarsi di calibrare la sonda seguendo le istruzioni nel documento Probe Calibrate . Per le stampanti delta, vedere il documento Delta Calibrate . Per le stampanti con viti di fissaggio e fermi Z tradizionali, vedere il documento Manual Level . Durante la calibrazione potrebbe essere necessario impostare la Z position_min della stampante su un numero negativo (ad esempio, position_min = -2 ). La stampante applica i controlli dei confini anche durante le routine di calibrazione. L'impostazione di un numero negativo consente alla stampante di spostarsi al di sotto della posizione nominale del piatto, il che pu\u00f2 aiutare quando si tenta di determinare la posizione effettiva del piatto.","title":"Scegliere il meccanismo di calibrazione appropriato"},{"location":"Bed_Level.html#il-test-con-la-carta","text":"Il meccanismo primario di calibrazione del piatto primario \u00e8 il \"test della carta\". Si tratta di posizionare un normale pezzo di \"carta per fotocopiatrice\" tra il piatto della stampante e l'ugello, quindi comandare l'ugello a diverse altezze Z finch\u00e9 non si avverte una piccola quantit\u00e0 di attrito quando si spinge la carta avanti e indietro. \u00c8 importante comprendere il \"test della carta\" anche se si dispone di una \"sonda Z automatica\". La sonda stessa deve spesso essere calibrata per ottenere buoni risultati. La calibrazione della sonda viene eseguita utilizzando questo \"test della carta\". Per eseguire il test della carta, taglia un piccolo pezzo di carta rettangolare usando un paio di forbici (es. 5x3 cm). La carta ha generalmente uno spessore di circa 100 micron (0,100 mm). (Lo spessore esatto della carta non \u00e8 cruciale.) Il primo passaggio del test della carta consiste nell'ispezione dell'ugello e del piatto della stampante. Assicurati che non ci sia plastica (o altri detriti) sull'ugello o sul letto. Ispeziona l'ugello e il piatto per assicurarti che non sia presente plastica! Se si stampa sempre su un determinato nastro o superficie di stampa, \u00e8 possibile eseguire il test della carta con quel nastro/superficie in posizione. Tuttavia, tieni presente che il nastro stesso ha uno spessore e nastri diversi (o qualsiasi altra superficie di stampa) influiranno sulle misurazioni Z. Assicurati di eseguire nuovamente il test della carta per misurare ogni tipo di superficie in uso. Se c'\u00e8 della plastica sull'ugello, riscalda l'estrusore e usa una pinzetta di metallo per rimuovere quella plastica. Attendere che l'estrusore si raffreddi completamente a temperatura ambiente prima di continuare con il test della carta. Mentre l'ugello si sta raffreddando, usa le pinzette di metallo per rimuovere la plastica che potrebbe fuoriuscire. Esegui sempre il test della carta quando sia l'ugello che il letto sono a temperatura ambiente! Quando l'ugello \u00e8 riscaldato, la sua posizione (rispetto al piatto) cambia a causa dell'espansione termica. Questa espansione termica \u00e8 in genere di circa 100 micron, che ha all'incirca lo stesso spessore di un tipico pezzo di carta per stampante. L'esatta quantit\u00e0 di espansione termica non \u00e8 cruciale, cos\u00ec come lo spessore esatto della carta non \u00e8 cruciale. Inizia con il presupposto che i due siano uguali (vedi sotto per un metodo per determinare la differenza tra le due distanze). Pu\u00f2 sembrare strano calibrare la distanza a temperatura ambiente quando l'obiettivo \u00e8 avere una distanza costante quando riscaldata. Tuttavia, se si calibra quando l'ugello \u00e8 riscaldato, tende a rilasciare piccole quantit\u00e0 di plastica fusa alla carta, il che cambia la quantit\u00e0 di attrito sentito. Ci\u00f2 rende pi\u00f9 difficile ottenere una buona calibrazione. La calibrazione mentre il letto/ugello \u00e8 caldo aumenta notevolmente anche il rischio di ustione. La quantit\u00e0 di espansione termica \u00e8 stabile, quindi \u00e8 facilmente contabilizzabile pi\u00f9 avanti nel processo di calibrazione. Utilizza uno strumento automatizzato per determinare l'altezza Z precisa! Klipper ha diversi script di supporto disponibili (ad esempio, MANUAL_PROBE, Z_ENDSTOP_CALIBRATE, PROBE_CALIBRATE, DELTA_CALIBRATE). Consulta i documenti descritti sopra per sceglierne uno. Eseguire il comando appropriato nella finestra del terminale di OctoPrint. Lo script richieder\u00e0 l'interazione dell'utente nell'output del terminale OctoPrint. Sembrer\u00e0 qualcosa come: Recv: // Starting manual Z probe. Use TESTZ to adjust position. Recv: // Finish with ACCEPT or ABORT command. Recv: // Z position: ?????? --> 5.000 <-- ?????? L'altezza attuale dell'ugello (come la intende attualmente la stampante) \u00e8 mostrata tra \"--> <--\". Il numero a destra \u00e8 l'altezza dell'ultimo tentativo di sonda appena maggiore dell'altezza attuale e a sinistra \u00e8 l'ultimo tentativo di sonda inferiore all'altezza attuale (o ?????? se non \u00e8 stato effettuato alcun tentativo). Metti la carta tra l'ugello e il letto. Pu\u00f2 essere utile piegare un angolo della carta in modo che sia pi\u00f9 facile da afferrare. (Cerca di non spingere il piatto quando muovi la carta avanti e indietro.) Utilizzare il comando TESTZ per richiedere all'ugello di avvicinarsi alla carta. Per esempio: TESTZ Z=-.1 Il comando TESTZ sposter\u00e0 l'ugello di una distanza relativa dalla posizione corrente dell'ugello. (Quindi, Z=-.1 richiede che l'ugello si avvicini al piatto di 0,1 mm.) Dopo che l'ugello ha smesso di muoversi, spingere la carta avanti e indietro per controllare se l'ugello \u00e8 in contatto con la carta e per sentire la quantit\u00e0 di attrito. Continua a emettere comandi TESTZ finch\u00e9 non si avverte una piccola quantit\u00e0 di attrito durante il test con la carta. Se si trova troppo attrito, \u00e8 possibile utilizzare un valore Z positivo per spostare l'ugello verso l'alto. \u00c8 anche possibile utilizzare TESTZ Z=+ o TESTZ Z=- per \"sezionare in due\" l'ultima posizione, ovvero per spostarsi in una posizione a met\u00e0 strada tra due posizioni. Ad esempio, se si riceve il seguente prompt da un comando TESTZ: Recv: // Z position: 0.130 --> 0.230 <-- 0.280 Quindi un TESTZ Z=- sposterebbe l'ugello in una posizione Z di 0,180 (a met\u00e0 strada tra 0,130 e 0,230). \u00c8 possibile utilizzare questa funzione per ridurre rapidamente a un attrito costante. \u00c8 anche possibile usare Z=++ e Z=-- per tornare direttamente a una misurazione passata - per esempio, dopo il prompt sopra un comando TESTZ Z=-- sposterebbe l'ugello su una Z posizione di 0,130. Dopo aver trovato una piccola quantit\u00e0 di attrito, eseguire il comando ACCETTA: ACCEPT Questo accetter\u00e0 l'altezza Z data e proceder\u00e0 con lo strumento di calibrazione fornito. L'esatta quantit\u00e0 di attrito percepito non \u00e8 cruciale, cos\u00ec come la quantit\u00e0 di espansione termica e l'esatta larghezza della carta non sono cruciali. Cerca solo di ottenere la stessa quantit\u00e0 di attrito ogni volta che esegui il test. Se qualcosa va storto durante il test, \u00e8 possibile utilizzare il comando ABORT per uscire dallo strumento di calibrazione.","title":"Il \"test con la carta\""},{"location":"Bed_Level.html#determinare-lespansione-termica","text":"Dopo aver eseguito con successo il livellamento del piatto, si pu\u00f2 continuare a calcolare un valore pi\u00f9 preciso per l'impatto combinato di \"espansione termica\", \"spessore della carta\" e \"quantit\u00e0 di attrito sentito durante il test della carta\". Questo tipo di calcolo generalmente non \u00e8 necessario poich\u00e9 la maggior parte degli utenti ritiene che il semplice \"test cartaceo\" fornisca buoni risultati. Il modo pi\u00f9 semplice per eseguire questo calcolo \u00e8 stampare un oggetto di prova con pareti dritte su tutti i lati. Il cubo vuoto che si trova in docs/prints/square.stl pu\u00f2 essere usato per questo. Quando si fa lo slicing l'oggetto, assicurarsi che lo slicer utilizzi la stessa altezza del livello e la stessa larghezza di estrusione per il primo livello che utilizza per tutti i livelli successivi. Utilizzare un'altezza dello strato grossolana (l'altezza dello strato dovrebbe essere circa il 75% del diametro dell'ugello) e non utilizzare un bordo o una raft. Stampa l'oggetto di prova, attendi che si raffreddi e rimuovilo dal piatto. Ispeziona lo strato pi\u00f9 basso dell'oggetto. (Pu\u00f2 anche essere utile far scorrere un dito o un'unghia lungo il bordo inferiore.) Se si scopre che lo strato inferiore si gonfia leggermente lungo tutti i lati dell'oggetto, significa che l'ugello era leggermente pi\u00f9 vicino al piatto di quanto dovrebbe essere. Si pu\u00f2 emettere un comando SET_GCODE_OFFSET Z=+.010 per aumentare l'altezza. Nelle stampe successive \u00e8 possibile controllare questo comportamento e apportare ulteriori modifiche secondo necessit\u00e0. Le regolazioni di questo tipo sono in genere in 10 micron (0,010 mm). Se il livello inferiore appare costantemente pi\u00f9 stretto dei livelli successivi, \u00e8 possibile utilizzare il comando SET_GCODE_OFFSET per effettuare una regolazione Z negativa. Se non si \u00e8 sicuri, \u00e8 possibile diminuire la regolazione Z finch\u00e9 lo strato inferiore delle stampe non mostra un piccolo rigonfiamento, quindi arretrare finch\u00e9 non scompare. Il modo pi\u00f9 semplice per applicare la regolazione Z desiderata \u00e8 creare una macro di G-code START_PRINT, fare in modo che lo slicer chiami quella macro all'inizio di ogni stampa e aggiungere un comando SET_GCODE_OFFSET a quella macro. Per ulteriori dettagli, vedere il documento slicers .","title":"Determinare l'espansione termica"},{"location":"Bed_Mesh.html","text":"Matrice del Piatto \u00b6 Il modulo rete piatto (bed mesh) pu\u00f2 essere usato per compensare le irregolarit\u00e0 della superficie del piatto e per ottenere un primo strato migliore su tutto il piatto. Va notato che la correzione basata sul software non raggiunger\u00e0 risultati perfetti, pu\u00f2 solo approssimare la forma del piatto. Bed mesh inoltre non pu\u00f2 compensare i problemi meccanici ed elettrici. Se un asse \u00e8 obliquo o una sonda non \u00e8 accurata, il modulo Bed mesh non ricever\u00e0 risultati accurati dal processo di ispezione. Prima della calibrazione della mesh dovrai assicurarti che l'offset Z della tua sonda sia calibrato. Se si utilizza un fine corsa per l'homing Z, anche questo dovr\u00e0 essere calibrato. Per ulteriori informazioni, vedere Probe Calibrate e Z_ENDSTOP_CALIBRATE in Manual Level . Configurazione base \u00b6 Piatti rettangolari \u00b6 Questo esempio presuppone una stampante con un piatto rettangolare di 250 mm x 220 mm e una sonda con un offset x di 24 mm e un offset y di 5 mm. [bed_mesh] speed: 120 horizontal_move_z: 5 mesh_min: 35, 6 mesh_max: 240, 198 probe_count: 5, 3 speed: 120 Valore predefinito: 50 La velocit\u00e0 con cui la testa di stampa si sposta tra i punti. horizontal_move_z: 5 Valore predefinito: 5 La coordinata Z a cui si solleva la sonda prima di spostarsi tra i punti. mesh_min: 35, 6 Richiesto La prima coordinata rilevata, pi\u00f9 vicina all'origine. Questa coordinata \u00e8 relativa alla posizione della sonda. mesh_max: 240, 198 Richiesto La coordinata rilevata pi\u00f9 lontana dall'origine. Questo non \u00e8 necessariamente l'ultimo punto sondato, poich\u00e9 il processo di rilevamento avviene a zig-zag. Come per mesh_min , questa coordinata \u00e8 relativa alla posizione della sonda. probe_count: 5, 3 Valore predefinito: 3, 3 Il numero di punti da sondare su ciascun asse, specificato come valori interi X, Y. In questo esempio verranno tastati 5 punti lungo l'asse X, con 3 punti lungo l'asse Y, per un totale di 15 punti tastati. Nota che se desideri una griglia quadrata, ad esempio 3x3, questo potrebbe essere specificato come un singolo valore intero che viene utilizzato per entrambi gli assi, ad esempio probe_count: 3 . Si noti che una mesh richiede un probe_count minimo di 3 lungo ciascun asse. L'illustrazione seguente mostra come le opzioni mesh_min , mesh_max e probe_count vengono utilizzate per generare punti sonda. Le frecce indicano la direzione della procedura di probing, a partire da mesh_min . Per riferimento, quando la sonda \u00e8 a mesh_min , l'ugello sar\u00e0 a (11, 1), e quando la sonda \u00e8 a mesh_max , l'ugello sar\u00e0 a (206, 193). Piatti rotondi \u00b6 Questo esempio presuppone una stampante dotata di un raggio del piatto rotondo di 100 mm. Utilizzeremo gli stessi offset della sonda dell'esempio rettangolare, 24 mm su X e 5 mm su Y. [bed_mesh] speed: 120 horizontal_move_z: 5 mesh_radius: 75 mesh_origin: 0, 0 round_probe_count: 5 mesh_radius: 75 Obbligatorio Il raggio della mesh sondata in mm, relativo a mesh_origin . Si noti che gli offset della sonda limitano la dimensione del raggio della mesh. In questo esempio, un raggio maggiore di 76 sposterebbe lo strumento oltre il range della stampante. mesh_origin: 0, 0 Valore predefinito: 0, 0 Il punto centrale della mesh. Questa coordinata \u00e8 relativa alla posizione della sonda. Sebbene il valore predefinito sia 0, 0, pu\u00f2 essere utile regolare l'origine nel tentativo di sondare una porzione pi\u00f9 ampia del letto. Vedi l'illustrazione qui sotto. round_probe_count: 5 Valore predefinito: 5 Questo \u00e8 un valore intero che definisce il numero massimo di punti sondati lungo gli assi X e Y. Per \"massimo\" si intende il numero di punti tastati lungo l'origine della mesh. Questo valore deve essere un numero dispari, in quanto \u00e8 necessario che venga sondato il centro della mesh. L'illustrazione seguente mostra come vengono generati i punti sondati. Come puoi vedere, l'impostazione di mesh_origin su (-10, 0) ci consente di specificare un raggio di mesh maggiore di 85. Configurazione avanzata \u00b6 Di seguito vengono spiegate in dettaglio le opzioni di configurazione pi\u00f9 avanzate. Ciascun esempio si baser\u00e0 sulla configurazione base del piatto rettangolare mostrata sopra. Ciascuna delle opzioni avanzate si applica allo stesso modo ai piatti rotondi. Interpolazione mesh \u00b6 Sebbene sia possibile campionare la matrice sondata direttamente utilizzando una semplice interpolazione bilineare per determinare i valori Z tra i punti sondati, \u00e8 spesso utile interpolare punti extra utilizzando algoritmi di interpolazione pi\u00f9 avanzati per aumentare la densit\u00e0 della mesh. Questi algoritmi aggiungono curvatura alla mesh, tentando di simulare le propriet\u00e0 del materiale del piatto. Bed Mesh offre l'interpolazione lagrange e bicubica per ottenere questo risultato. [bed_mesh] speed: 120 horizontal_move_z: 5 mesh_min: 35, 6 mesh_max: 240, 198 probe_count: 5, 3 mesh_pps: 2, 3 algorithm: bicubic bicubic_tension: 0.2 mesh_pps: 2, 3 Valore predefinito: 2, 2 L'opzione mesh_pps \u00e8 un'abbreviazione per Mesh Points Per Segment. Questa opzione specifica quanti punti interpolare per ciascun segmento lungo gli assi X e Y. Considera un \"segmento\" come lo spazio tra ogni punto sondato. Come probe_count , mesh_pps \u00e8 specificato come una coppia di interi X, Y e pu\u00f2 anche essere specificato un singolo intero che viene applicato a entrambi gli assi. In questo esempio ci sono 4 segmenti lungo l'asse X e 2 segmenti lungo l'asse Y. Questo restituisce 8 punti interpolati lungo X, 6 punti interpolati lungo Y, che si traduce in una mesh 13x8. Si noti che se mesh_pps \u00e8 impostato su 0, l'interpolazione della mesh \u00e8 disabilitata e la matrice sondata verr\u00e0 campionata direttamente. algoritmo: lagrange Valore predefinito: lagrange L'algoritmo utilizzato per interpolare la mesh. Pu\u00f2 essere \"lagrange\" o \"bicubico\". L'interpolazione Lagrange \u00e8 limitata a 6 punti sondati poich\u00e9 tende a verificarsi l'oscillazione con un numero maggiore di campioni. L'interpolazione bicubica richiede un minimo di 4 punti sondati lungo ciascun asse, se vengono specificati meno di 4 punti, viene forzato il campionamento lagrange. Se mesh_pps \u00e8 impostato su 0, questo valore viene ignorato poich\u00e9 non viene eseguita alcuna interpolazione della mesh. bicubic_tension: 0.2 Valore predefinito: 0.2 Se l'opzione algorithm \u00e8 impostata su bicubic \u00e8 possibile specificare il valore della tensione. Maggiore \u00e8 la tensione, maggiore \u00e8 la pendenza interpolata. Prestare attenzione durante la regolazione, poich\u00e9 valori pi\u00f9 elevati creano anche una maggiore sovraelongazione, che risulter\u00e0 in valori interpolati superiori o inferiori rispetto ai punti rilevati. L'illustrazione seguente mostra come vengono utilizzate le opzioni precedenti per generare una mesh interpolata. Divisione dei movimenti \u00b6 Bed Mesh funziona intercettando i comandi di spostamento di gcode e applicando una trasformazione alla loro coordinata Z. I movimenti lunghi devono essere suddivisi in movimenti pi\u00f9 piccoli per seguire correttamente la forma del piatto. Le opzioni seguenti controllano il comportamento di divisione. [bed_mesh] speed: 120 horizontal_move_z: 5 mesh_min: 35, 6 mesh_max: 240, 198 probe_count: 5, 3 move_check_distance: 5 split_delta_z: .025 move_check_distance: 5 Valore predefinito: 5 La distanza minima per verificare la modifica desiderata in Z prima di eseguire una divisione. In questo esempio, un movimento pi\u00f9 lungo di 5 mm verr\u00e0 eseguito dall'algoritmo. Ogni 5 mm si verificher\u00e0 una ricerca Z della mesh, confrontandola con il valore Z del movimento precedente. Se il delta raggiunge la soglia impostata da split_delta_z , il movimento sar\u00e0 diviso e l'attraversamento continuer\u00e0. Questo processo si ripete fino al raggiungimento della fine del movimento, dove verr\u00e0 applicato un aggiustamento finale. I movimenti pi\u00f9 brevi di move_check_distance hanno la correzione Z corretta applicata direttamente alla mossa senza attraversamento o divisione. split_delta_z: .025 Valore predefinito: .025 Come accennato in precedenza, questa \u00e8 la deviazione minima richiesta per attivare una divisione del movimento. In questo esempio, qualsiasi valore Z con una deviazione +/- 0,025 mm attiver\u00e0 una divisione. Generalmente i valori di default per queste opzioni sono sufficienti, infatti il valore di default di 5mm per il move_check_distance potrebbe essere eccessivo. Tuttavia, un utente esperto potrebbe voler sperimentare queste opzioni nel tentativo di spremere un primo layer ottimale. Dissolvenza Mesh \u00b6 Quando la \"dissolvenza\" \u00e8 abilitata, la regolazione Z viene gradualmente eliminata su una distanza definita dalla configurazione. Ci\u00f2 si ottiene applicando piccole regolazioni all'altezza dello strato, aumentando o diminuendo a seconda della forma del letto. Quando la dissolvenza \u00e8 completata, la regolazione Z non viene pi\u00f9 applicata, consentendo alla parte superiore della stampa di essere piatta anzich\u00e9 rispecchiare la forma del letto. La dissolvenza pu\u00f2 anche avere alcuni tratti indesiderati, se dissolve troppo rapidamente pu\u00f2 causare artefatti visibili sulla stampa. Inoltre, se il tuo letto \u00e8 notevolmente deformato, la dissolvenza pu\u00f2 ridurre o allungare l'altezza Z della stampa. In quanto tale, la dissolvenza \u00e8 disabilitata per impostazione predefinita. [bed_mesh] speed: 120 horizontal_move_z: 5 mesh_min: 35, 6 mesh_max: 240, 198 probe_count: 5, 3 fade_start: 1 fade_end: 10 fade_target: 0 fade_start: 1 Valore predefinito: 1 L'altezza Z in cui iniziare la regolazione graduale. \u00c8 una buona idea avere alcuni layer prima di iniziare il processo di dissolvenza. fade_end: 10 Valore predefinito: 0 L'altezza Z in cui deve essere completata la dissolvenza. Se questo valore \u00e8 inferiore a fade_start , la dissolvenza \u00e8 disabilitata. Questo valore pu\u00f2 essere regolato a seconda di quanto \u00e8 deformata la superficie di stampa. Una superficie notevolmente deformata dovrebbe dissolvere su una distanza maggiore. Una superficie quasi piatta potrebbe essere in grado di ridurre questo valore per eliminarlo gradualmente pi\u00f9 rapidamente. 10mm \u00e8 un valore ragionevole per cominciare se si utilizza il valore predefinito di 1 per fade_start . fade_target: 0 Valore predefinito: il valore Z medio della mesh Il fade_target pu\u00f2 essere pensato come un offset Z aggiuntivo applicato all'intero letto dopo il completamento della dissolvenza. In generale, vorremmo che questo valore fosse 0, tuttavia ci sono circostanze in cui non dovrebbe essere. Ad esempio, supponiamo che la tua posizione di riferimento sul letto sia un valore anomalo, 0,2 mm inferiore all'altezza media rilevata del letto. Se fade_target \u00e8 0, la dissolvenza ridurr\u00e0 la stampa di una media di 0,2 mm sul letto. Impostando fade_target su .2, l'area homed si espander\u00e0 di .2 mm, tuttavia il resto del letto avr\u00e0 una dimensione precisa. Generalmente \u00e8 una buona idea lasciare fade_target fuori dalla configurazione in modo che venga utilizzata l'altezza media della mesh, tuttavia potrebbe essere desiderabile regolare manualmente il target di dissolvenza se si desidera stampare su una parte specifica del letto. L'Indice di Riferimento Relativo \u00b6 La maggior parte delle sonde \u00e8 suscettibile alla deriva, cio\u00e8: imprecisioni nel sondaggio introdotte da calore o interferenza. Ci\u00f2 pu\u00f2 rendere difficile il calcolo dell'offset z della sonda, in particolare a diverse temperature del letto. In quanto tali, alcune stampanti utilizzano un fine corsa per l'homing dell'asse Z e una sonda per calibrare la mesh. Queste stampanti possono trarre vantaggio dalla configurazione del relativo indice di riferimento. [bed_mesh] speed: 120 horizontal_move_z: 5 mesh_min: 35, 6 mesh_max: 240, 198 probe_count: 5, 3 relative_reference_index: 7 relative_reference_index: 7 Valore predefinito: Nessuno (disabilitato) Quando i punti sondati vengono generati, a ciascuno viene assegnato un indice. Puoi cercare questo indice in klippy.log o usando BED_MESH_OUTPUT (vedi la sezione sui GCodes Bed Mesh di seguito per maggiori informazioni). Se si assegna un indice all'opzione relative_reference_index , il valore rilevato a questa coordinata sostituir\u00e0 lo z_offset del probe. Questo rende effettivamente questa coordinata il riferimento \"zero\" per la mesh. Quando si utilizza l'indice di riferimento relativo, \u00e8 necessario scegliere l'indice pi\u00f9 vicino al punto sul letto in cui \u00e8 stata eseguita la calibrazione del fine corsa Z. Nota che quando cerchi l'indice usando il log o BED_MESH_OUTPUT, dovresti usare le coordinate elencate sotto l'intestazione \"Probe\" per trovare l'indice corretto. Regioni difettose \u00b6 \u00c8 possibile che alcune aree di un piatto riportino risultati imprecisi durante il sondaggio a causa di un \"guasto\" in punti specifici. Il miglior esempio di ci\u00f2 sono i piatti con serie di magneti integrati utilizzati per trattenere le lamiere di acciaio rimovibili. Il campo magnetico su e intorno a questi magneti pu\u00f2 causare l'attivazione di una sonda induttiva a una distanza maggiore o minore di quanto sarebbe altrimenti, risultando in una mesh che non rappresenta accuratamente la superficie in queste posizioni. Nota: questo non deve essere confuso con la distorsione della posizione della sonda, che produce risultati imprecisi sull'intero letto. Le opzioni faulty_region possono essere configurate per compensare questo effetto. Se un punto generato si trova all'interno di una regione difettosa, la mesh del letto tenter\u00e0 di sondare fino a 4 punti ai confini di questa regione. Questi valori sondati verranno mediati e inseriti nella mesh come valore Z alla coordinata generata (X, Y). [bed_mesh] speed: 120 horizontal_move_z: 5 mesh_min: 35, 6 mesh_max: 240, 198 probe_count: 5, 3 faulty_region_1_min: 130.0, 0.0 faulty_region_1_max: 145.0, 40.0 faulty_region_2_min: 225.0, 0.0 faulty_region_2_max: 250.0, 25.0 faulty_region_3_min: 165.0, 95.0 faulty_region_3_max: 205.0, 110.0 faulty_region_4_min: 30.0, 170.0 faulty_region_4_max: 45.0, 210.0 faulty_region_{1...99}_min faulty_region_{1..99}_max Valore predefinito: Nessuno (disabilitato) Le regioni difettose sono definite in modo simile a quello della mesh stessa, dove minimo e massimo (X , Y) delle coordinate devono essere specificate per ciascuna regione. Una regione difettosa pu\u00f2 estendersi al di fuori di una mesh, tuttavia i punti alternativi generati saranno sempre all'interno del confine della mesh. Non possono sovrapporsi due regioni. L'immagine seguente illustra come vengono generati i punti di sostituzione quando un punto generato si trova all'interno di una regione difettosa. Le regioni mostrate corrispondono a quelle nella configurazione di esempio sopra. I punti di sostituzione e le relative coordinate sono identificati in verde. GCodes della mesh del piatto \u00b6 Calibrazione \u00b6 BED_MESH_CALIBRATE PROFILE=<nome> METHOD=[manuale | automatico] [<parametro_sonda>=<valore>] [<mesh_parameter>=<valore>] Profilo predefinito: default Metodo predefinito: automatico se viene rilevata una sonda, altrimenti manuale Avvia la procedura di sondaggio per la calibrazione della mesh del piatto. La mesh verr\u00e0 salvata in un profilo specificato dal parametro PROFILE , o default se non specificato. Se viene selezionato METHOD=manual , si verificher\u00e0 il rilevamento manuale. Quando si passa dal probing automatico a quello manuale, i punti mesh generati verranno regolati automaticamente. \u00c8 possibile specificare parametri mesh per modificare l'area sondata. Sono disponibili i seguenti parametri: Piatti rettangolari (cartesiani): MESH_MIN MESH_MAX PROBE_COUNT Piatti rotondi (delta): MESH_RADIUS MESH_ORIGIN ROUND_PROBE_COUNT Tutti i piatti: RELATIVE_REFERNCE_INDEX ALGORITHM Vedere la documentazione di configurazione sopra per i dettagli su come ogni parametro si applica alla mesh. Profili \u00b6 BED_MESH_PROFILE SAVE=<name> LOAD=<name> REMOVE=<name> Dopo aver eseguito un BED_MESH_CALIBRATE, \u00e8 possibile salvare lo stato della mesh corrente in un profilo denominato. Ci\u00f2 consente di caricare una mesh senza risondare il piatto. Dopo che un profilo \u00e8 stato salvato usando BED_MESH_PROFILE SAVE=<nome> \u00e8 possibile eseguire il gcode SAVE_CONFIG per scrivere il profilo su printer.cfg. I profili possono essere caricati eseguendo BED_MESH_PROFILE LOAD=<name> . Va notato che ogni volta che si verifica un BED_MESH_CALIBRATE, lo stato corrente viene automaticamente salvato nel profilo predefinito . Se questo profilo esiste, viene caricato automaticamente all'avvio di Klipper. Se questo comportamento non \u00e8 desiderabile, il profilo predefinito pu\u00f2 essere rimosso come segue: BED_MESH_PROFILE REMOVE=default Qualsiasi altro profilo salvato pu\u00f2 essere rimosso allo stesso modo, sostituendo default con il nome del profilo che desideri rimuovere. Loading the default profile \u00b6 Previous versions of bed_mesh always loaded the profile named default on startup if it was present. This behavior has been removed in favor of allowing the user to determine when a profile is loaded. If a user wishes to load the default profile it is recommended to add BED_MESH_PROFILE LOAD=default to either their START_PRINT macro or their slicer's \"Start G-Code\" configuration, whichever is applicable. Alternatively the old behavior of loading a profile at startup can be restored with a [delayed_gcode] : [delayed_gcode bed_mesh_init] initial_duration : .01 gcode : BED_MESH_PROFILE LOAD = default Output \u00b6 BED_MESH_OUTPUT PGP=[0 | 1] Invia lo stato della mesh corrente al terminale. Si noti che viene emessa la mesh stessa Il parametro PGP \u00e8 un'abbreviazione per \"Print Generated Points\". Se \u00e8 impostato PGP=1 , i punti sondati generati verranno inviati al terminale: // bed_mesh: generated points // Index | Tool Adjusted | Probe // 0 | (11.0, 1.0) | (35.0, 6.0) // 1 | (62.2, 1.0) | (86.2, 6.0) // 2 | (113.5, 1.0) | (137.5, 6.0) // 3 | (164.8, 1.0) | (188.8, 6.0) // 4 | (216.0, 1.0) | (240.0, 6.0) // 5 | (216.0, 97.0) | (240.0, 102.0) // 6 | (164.8, 97.0) | (188.8, 102.0) // 7 | (113.5, 97.0) | (137.5, 102.0) // 8 | (62.2, 97.0) | (86.2, 102.0) // 9 | (11.0, 97.0) | (35.0, 102.0) // 10 | (11.0, 193.0) | (35.0, 198.0) // 11 | (62.2, 193.0) | (86.2, 198.0) // 12 | (113.5, 193.0) | (137.5, 198.0) // 13 | (164.8, 193.0) | (188.8, 198.0) // 14 | (216.0, 193.0) | (240.0, 198.0) I punti \"Tool Adjusted\" si riferiscono alla posizione dell'ugello per ciascun punto e i punti \"Probe\" si riferiscono alla posizione della sonda. Si noti che quando il probing \u00e8 manuale i punti \"sonda\" si riferiscono sia alla posizione dell'utensile che dell'ugello. Cancella stato mesh \u00b6 BED_MESH_CLEAR Questo gcode pu\u00f2 essere utilizzato per cancellare lo stato della mesh interna. Applicare gli offset X/Y \u00b6 BED_MESH_OFFSET [X=<value>] [Y=<value>] Ci\u00f2 \u00e8 utile per le stampanti con pi\u00f9 estrusori indipendenti, poich\u00e9 \u00e8 necessario un offset per produrre la corretta regolazione Z dopo un cambio utensile. Gli offset devono essere specificati rispetto all'estrusore primario. Vale a dire, \u00e8 necessario specificare un offset X positivo se l'estrusore secondario \u00e8 montato a destra dell'estrusore primario e un offset Y positivo se l'estrusore secondario \u00e8 montato \"dietro\" l'estrusore primario.","title":"Matrice del Piatto"},{"location":"Bed_Mesh.html#matrice-del-piatto","text":"Il modulo rete piatto (bed mesh) pu\u00f2 essere usato per compensare le irregolarit\u00e0 della superficie del piatto e per ottenere un primo strato migliore su tutto il piatto. Va notato che la correzione basata sul software non raggiunger\u00e0 risultati perfetti, pu\u00f2 solo approssimare la forma del piatto. Bed mesh inoltre non pu\u00f2 compensare i problemi meccanici ed elettrici. Se un asse \u00e8 obliquo o una sonda non \u00e8 accurata, il modulo Bed mesh non ricever\u00e0 risultati accurati dal processo di ispezione. Prima della calibrazione della mesh dovrai assicurarti che l'offset Z della tua sonda sia calibrato. Se si utilizza un fine corsa per l'homing Z, anche questo dovr\u00e0 essere calibrato. Per ulteriori informazioni, vedere Probe Calibrate e Z_ENDSTOP_CALIBRATE in Manual Level .","title":"Matrice del Piatto"},{"location":"Bed_Mesh.html#configurazione-base","text":"","title":"Configurazione base"},{"location":"Bed_Mesh.html#piatti-rettangolari","text":"Questo esempio presuppone una stampante con un piatto rettangolare di 250 mm x 220 mm e una sonda con un offset x di 24 mm e un offset y di 5 mm. [bed_mesh] speed: 120 horizontal_move_z: 5 mesh_min: 35, 6 mesh_max: 240, 198 probe_count: 5, 3 speed: 120 Valore predefinito: 50 La velocit\u00e0 con cui la testa di stampa si sposta tra i punti. horizontal_move_z: 5 Valore predefinito: 5 La coordinata Z a cui si solleva la sonda prima di spostarsi tra i punti. mesh_min: 35, 6 Richiesto La prima coordinata rilevata, pi\u00f9 vicina all'origine. Questa coordinata \u00e8 relativa alla posizione della sonda. mesh_max: 240, 198 Richiesto La coordinata rilevata pi\u00f9 lontana dall'origine. Questo non \u00e8 necessariamente l'ultimo punto sondato, poich\u00e9 il processo di rilevamento avviene a zig-zag. Come per mesh_min , questa coordinata \u00e8 relativa alla posizione della sonda. probe_count: 5, 3 Valore predefinito: 3, 3 Il numero di punti da sondare su ciascun asse, specificato come valori interi X, Y. In questo esempio verranno tastati 5 punti lungo l'asse X, con 3 punti lungo l'asse Y, per un totale di 15 punti tastati. Nota che se desideri una griglia quadrata, ad esempio 3x3, questo potrebbe essere specificato come un singolo valore intero che viene utilizzato per entrambi gli assi, ad esempio probe_count: 3 . Si noti che una mesh richiede un probe_count minimo di 3 lungo ciascun asse. L'illustrazione seguente mostra come le opzioni mesh_min , mesh_max e probe_count vengono utilizzate per generare punti sonda. Le frecce indicano la direzione della procedura di probing, a partire da mesh_min . Per riferimento, quando la sonda \u00e8 a mesh_min , l'ugello sar\u00e0 a (11, 1), e quando la sonda \u00e8 a mesh_max , l'ugello sar\u00e0 a (206, 193).","title":"Piatti rettangolari"},{"location":"Bed_Mesh.html#piatti-rotondi","text":"Questo esempio presuppone una stampante dotata di un raggio del piatto rotondo di 100 mm. Utilizzeremo gli stessi offset della sonda dell'esempio rettangolare, 24 mm su X e 5 mm su Y. [bed_mesh] speed: 120 horizontal_move_z: 5 mesh_radius: 75 mesh_origin: 0, 0 round_probe_count: 5 mesh_radius: 75 Obbligatorio Il raggio della mesh sondata in mm, relativo a mesh_origin . Si noti che gli offset della sonda limitano la dimensione del raggio della mesh. In questo esempio, un raggio maggiore di 76 sposterebbe lo strumento oltre il range della stampante. mesh_origin: 0, 0 Valore predefinito: 0, 0 Il punto centrale della mesh. Questa coordinata \u00e8 relativa alla posizione della sonda. Sebbene il valore predefinito sia 0, 0, pu\u00f2 essere utile regolare l'origine nel tentativo di sondare una porzione pi\u00f9 ampia del letto. Vedi l'illustrazione qui sotto. round_probe_count: 5 Valore predefinito: 5 Questo \u00e8 un valore intero che definisce il numero massimo di punti sondati lungo gli assi X e Y. Per \"massimo\" si intende il numero di punti tastati lungo l'origine della mesh. Questo valore deve essere un numero dispari, in quanto \u00e8 necessario che venga sondato il centro della mesh. L'illustrazione seguente mostra come vengono generati i punti sondati. Come puoi vedere, l'impostazione di mesh_origin su (-10, 0) ci consente di specificare un raggio di mesh maggiore di 85.","title":"Piatti rotondi"},{"location":"Bed_Mesh.html#configurazione-avanzata","text":"Di seguito vengono spiegate in dettaglio le opzioni di configurazione pi\u00f9 avanzate. Ciascun esempio si baser\u00e0 sulla configurazione base del piatto rettangolare mostrata sopra. Ciascuna delle opzioni avanzate si applica allo stesso modo ai piatti rotondi.","title":"Configurazione avanzata"},{"location":"Bed_Mesh.html#interpolazione-mesh","text":"Sebbene sia possibile campionare la matrice sondata direttamente utilizzando una semplice interpolazione bilineare per determinare i valori Z tra i punti sondati, \u00e8 spesso utile interpolare punti extra utilizzando algoritmi di interpolazione pi\u00f9 avanzati per aumentare la densit\u00e0 della mesh. Questi algoritmi aggiungono curvatura alla mesh, tentando di simulare le propriet\u00e0 del materiale del piatto. Bed Mesh offre l'interpolazione lagrange e bicubica per ottenere questo risultato. [bed_mesh] speed: 120 horizontal_move_z: 5 mesh_min: 35, 6 mesh_max: 240, 198 probe_count: 5, 3 mesh_pps: 2, 3 algorithm: bicubic bicubic_tension: 0.2 mesh_pps: 2, 3 Valore predefinito: 2, 2 L'opzione mesh_pps \u00e8 un'abbreviazione per Mesh Points Per Segment. Questa opzione specifica quanti punti interpolare per ciascun segmento lungo gli assi X e Y. Considera un \"segmento\" come lo spazio tra ogni punto sondato. Come probe_count , mesh_pps \u00e8 specificato come una coppia di interi X, Y e pu\u00f2 anche essere specificato un singolo intero che viene applicato a entrambi gli assi. In questo esempio ci sono 4 segmenti lungo l'asse X e 2 segmenti lungo l'asse Y. Questo restituisce 8 punti interpolati lungo X, 6 punti interpolati lungo Y, che si traduce in una mesh 13x8. Si noti che se mesh_pps \u00e8 impostato su 0, l'interpolazione della mesh \u00e8 disabilitata e la matrice sondata verr\u00e0 campionata direttamente. algoritmo: lagrange Valore predefinito: lagrange L'algoritmo utilizzato per interpolare la mesh. Pu\u00f2 essere \"lagrange\" o \"bicubico\". L'interpolazione Lagrange \u00e8 limitata a 6 punti sondati poich\u00e9 tende a verificarsi l'oscillazione con un numero maggiore di campioni. L'interpolazione bicubica richiede un minimo di 4 punti sondati lungo ciascun asse, se vengono specificati meno di 4 punti, viene forzato il campionamento lagrange. Se mesh_pps \u00e8 impostato su 0, questo valore viene ignorato poich\u00e9 non viene eseguita alcuna interpolazione della mesh. bicubic_tension: 0.2 Valore predefinito: 0.2 Se l'opzione algorithm \u00e8 impostata su bicubic \u00e8 possibile specificare il valore della tensione. Maggiore \u00e8 la tensione, maggiore \u00e8 la pendenza interpolata. Prestare attenzione durante la regolazione, poich\u00e9 valori pi\u00f9 elevati creano anche una maggiore sovraelongazione, che risulter\u00e0 in valori interpolati superiori o inferiori rispetto ai punti rilevati. L'illustrazione seguente mostra come vengono utilizzate le opzioni precedenti per generare una mesh interpolata.","title":"Interpolazione mesh"},{"location":"Bed_Mesh.html#divisione-dei-movimenti","text":"Bed Mesh funziona intercettando i comandi di spostamento di gcode e applicando una trasformazione alla loro coordinata Z. I movimenti lunghi devono essere suddivisi in movimenti pi\u00f9 piccoli per seguire correttamente la forma del piatto. Le opzioni seguenti controllano il comportamento di divisione. [bed_mesh] speed: 120 horizontal_move_z: 5 mesh_min: 35, 6 mesh_max: 240, 198 probe_count: 5, 3 move_check_distance: 5 split_delta_z: .025 move_check_distance: 5 Valore predefinito: 5 La distanza minima per verificare la modifica desiderata in Z prima di eseguire una divisione. In questo esempio, un movimento pi\u00f9 lungo di 5 mm verr\u00e0 eseguito dall'algoritmo. Ogni 5 mm si verificher\u00e0 una ricerca Z della mesh, confrontandola con il valore Z del movimento precedente. Se il delta raggiunge la soglia impostata da split_delta_z , il movimento sar\u00e0 diviso e l'attraversamento continuer\u00e0. Questo processo si ripete fino al raggiungimento della fine del movimento, dove verr\u00e0 applicato un aggiustamento finale. I movimenti pi\u00f9 brevi di move_check_distance hanno la correzione Z corretta applicata direttamente alla mossa senza attraversamento o divisione. split_delta_z: .025 Valore predefinito: .025 Come accennato in precedenza, questa \u00e8 la deviazione minima richiesta per attivare una divisione del movimento. In questo esempio, qualsiasi valore Z con una deviazione +/- 0,025 mm attiver\u00e0 una divisione. Generalmente i valori di default per queste opzioni sono sufficienti, infatti il valore di default di 5mm per il move_check_distance potrebbe essere eccessivo. Tuttavia, un utente esperto potrebbe voler sperimentare queste opzioni nel tentativo di spremere un primo layer ottimale.","title":"Divisione dei movimenti"},{"location":"Bed_Mesh.html#dissolvenza-mesh","text":"Quando la \"dissolvenza\" \u00e8 abilitata, la regolazione Z viene gradualmente eliminata su una distanza definita dalla configurazione. Ci\u00f2 si ottiene applicando piccole regolazioni all'altezza dello strato, aumentando o diminuendo a seconda della forma del letto. Quando la dissolvenza \u00e8 completata, la regolazione Z non viene pi\u00f9 applicata, consentendo alla parte superiore della stampa di essere piatta anzich\u00e9 rispecchiare la forma del letto. La dissolvenza pu\u00f2 anche avere alcuni tratti indesiderati, se dissolve troppo rapidamente pu\u00f2 causare artefatti visibili sulla stampa. Inoltre, se il tuo letto \u00e8 notevolmente deformato, la dissolvenza pu\u00f2 ridurre o allungare l'altezza Z della stampa. In quanto tale, la dissolvenza \u00e8 disabilitata per impostazione predefinita. [bed_mesh] speed: 120 horizontal_move_z: 5 mesh_min: 35, 6 mesh_max: 240, 198 probe_count: 5, 3 fade_start: 1 fade_end: 10 fade_target: 0 fade_start: 1 Valore predefinito: 1 L'altezza Z in cui iniziare la regolazione graduale. \u00c8 una buona idea avere alcuni layer prima di iniziare il processo di dissolvenza. fade_end: 10 Valore predefinito: 0 L'altezza Z in cui deve essere completata la dissolvenza. Se questo valore \u00e8 inferiore a fade_start , la dissolvenza \u00e8 disabilitata. Questo valore pu\u00f2 essere regolato a seconda di quanto \u00e8 deformata la superficie di stampa. Una superficie notevolmente deformata dovrebbe dissolvere su una distanza maggiore. Una superficie quasi piatta potrebbe essere in grado di ridurre questo valore per eliminarlo gradualmente pi\u00f9 rapidamente. 10mm \u00e8 un valore ragionevole per cominciare se si utilizza il valore predefinito di 1 per fade_start . fade_target: 0 Valore predefinito: il valore Z medio della mesh Il fade_target pu\u00f2 essere pensato come un offset Z aggiuntivo applicato all'intero letto dopo il completamento della dissolvenza. In generale, vorremmo che questo valore fosse 0, tuttavia ci sono circostanze in cui non dovrebbe essere. Ad esempio, supponiamo che la tua posizione di riferimento sul letto sia un valore anomalo, 0,2 mm inferiore all'altezza media rilevata del letto. Se fade_target \u00e8 0, la dissolvenza ridurr\u00e0 la stampa di una media di 0,2 mm sul letto. Impostando fade_target su .2, l'area homed si espander\u00e0 di .2 mm, tuttavia il resto del letto avr\u00e0 una dimensione precisa. Generalmente \u00e8 una buona idea lasciare fade_target fuori dalla configurazione in modo che venga utilizzata l'altezza media della mesh, tuttavia potrebbe essere desiderabile regolare manualmente il target di dissolvenza se si desidera stampare su una parte specifica del letto.","title":"Dissolvenza Mesh"},{"location":"Bed_Mesh.html#lindice-di-riferimento-relativo","text":"La maggior parte delle sonde \u00e8 suscettibile alla deriva, cio\u00e8: imprecisioni nel sondaggio introdotte da calore o interferenza. Ci\u00f2 pu\u00f2 rendere difficile il calcolo dell'offset z della sonda, in particolare a diverse temperature del letto. In quanto tali, alcune stampanti utilizzano un fine corsa per l'homing dell'asse Z e una sonda per calibrare la mesh. Queste stampanti possono trarre vantaggio dalla configurazione del relativo indice di riferimento. [bed_mesh] speed: 120 horizontal_move_z: 5 mesh_min: 35, 6 mesh_max: 240, 198 probe_count: 5, 3 relative_reference_index: 7 relative_reference_index: 7 Valore predefinito: Nessuno (disabilitato) Quando i punti sondati vengono generati, a ciascuno viene assegnato un indice. Puoi cercare questo indice in klippy.log o usando BED_MESH_OUTPUT (vedi la sezione sui GCodes Bed Mesh di seguito per maggiori informazioni). Se si assegna un indice all'opzione relative_reference_index , il valore rilevato a questa coordinata sostituir\u00e0 lo z_offset del probe. Questo rende effettivamente questa coordinata il riferimento \"zero\" per la mesh. Quando si utilizza l'indice di riferimento relativo, \u00e8 necessario scegliere l'indice pi\u00f9 vicino al punto sul letto in cui \u00e8 stata eseguita la calibrazione del fine corsa Z. Nota che quando cerchi l'indice usando il log o BED_MESH_OUTPUT, dovresti usare le coordinate elencate sotto l'intestazione \"Probe\" per trovare l'indice corretto.","title":"L'Indice di Riferimento Relativo"},{"location":"Bed_Mesh.html#regioni-difettose","text":"\u00c8 possibile che alcune aree di un piatto riportino risultati imprecisi durante il sondaggio a causa di un \"guasto\" in punti specifici. Il miglior esempio di ci\u00f2 sono i piatti con serie di magneti integrati utilizzati per trattenere le lamiere di acciaio rimovibili. Il campo magnetico su e intorno a questi magneti pu\u00f2 causare l'attivazione di una sonda induttiva a una distanza maggiore o minore di quanto sarebbe altrimenti, risultando in una mesh che non rappresenta accuratamente la superficie in queste posizioni. Nota: questo non deve essere confuso con la distorsione della posizione della sonda, che produce risultati imprecisi sull'intero letto. Le opzioni faulty_region possono essere configurate per compensare questo effetto. Se un punto generato si trova all'interno di una regione difettosa, la mesh del letto tenter\u00e0 di sondare fino a 4 punti ai confini di questa regione. Questi valori sondati verranno mediati e inseriti nella mesh come valore Z alla coordinata generata (X, Y). [bed_mesh] speed: 120 horizontal_move_z: 5 mesh_min: 35, 6 mesh_max: 240, 198 probe_count: 5, 3 faulty_region_1_min: 130.0, 0.0 faulty_region_1_max: 145.0, 40.0 faulty_region_2_min: 225.0, 0.0 faulty_region_2_max: 250.0, 25.0 faulty_region_3_min: 165.0, 95.0 faulty_region_3_max: 205.0, 110.0 faulty_region_4_min: 30.0, 170.0 faulty_region_4_max: 45.0, 210.0 faulty_region_{1...99}_min faulty_region_{1..99}_max Valore predefinito: Nessuno (disabilitato) Le regioni difettose sono definite in modo simile a quello della mesh stessa, dove minimo e massimo (X , Y) delle coordinate devono essere specificate per ciascuna regione. Una regione difettosa pu\u00f2 estendersi al di fuori di una mesh, tuttavia i punti alternativi generati saranno sempre all'interno del confine della mesh. Non possono sovrapporsi due regioni. L'immagine seguente illustra come vengono generati i punti di sostituzione quando un punto generato si trova all'interno di una regione difettosa. Le regioni mostrate corrispondono a quelle nella configurazione di esempio sopra. I punti di sostituzione e le relative coordinate sono identificati in verde.","title":"Regioni difettose"},{"location":"Bed_Mesh.html#gcodes-della-mesh-del-piatto","text":"","title":"GCodes della mesh del piatto"},{"location":"Bed_Mesh.html#calibrazione","text":"BED_MESH_CALIBRATE PROFILE=<nome> METHOD=[manuale | automatico] [<parametro_sonda>=<valore>] [<mesh_parameter>=<valore>] Profilo predefinito: default Metodo predefinito: automatico se viene rilevata una sonda, altrimenti manuale Avvia la procedura di sondaggio per la calibrazione della mesh del piatto. La mesh verr\u00e0 salvata in un profilo specificato dal parametro PROFILE , o default se non specificato. Se viene selezionato METHOD=manual , si verificher\u00e0 il rilevamento manuale. Quando si passa dal probing automatico a quello manuale, i punti mesh generati verranno regolati automaticamente. \u00c8 possibile specificare parametri mesh per modificare l'area sondata. Sono disponibili i seguenti parametri: Piatti rettangolari (cartesiani): MESH_MIN MESH_MAX PROBE_COUNT Piatti rotondi (delta): MESH_RADIUS MESH_ORIGIN ROUND_PROBE_COUNT Tutti i piatti: RELATIVE_REFERNCE_INDEX ALGORITHM Vedere la documentazione di configurazione sopra per i dettagli su come ogni parametro si applica alla mesh.","title":"Calibrazione"},{"location":"Bed_Mesh.html#profili","text":"BED_MESH_PROFILE SAVE=<name> LOAD=<name> REMOVE=<name> Dopo aver eseguito un BED_MESH_CALIBRATE, \u00e8 possibile salvare lo stato della mesh corrente in un profilo denominato. Ci\u00f2 consente di caricare una mesh senza risondare il piatto. Dopo che un profilo \u00e8 stato salvato usando BED_MESH_PROFILE SAVE=<nome> \u00e8 possibile eseguire il gcode SAVE_CONFIG per scrivere il profilo su printer.cfg. I profili possono essere caricati eseguendo BED_MESH_PROFILE LOAD=<name> . Va notato che ogni volta che si verifica un BED_MESH_CALIBRATE, lo stato corrente viene automaticamente salvato nel profilo predefinito . Se questo profilo esiste, viene caricato automaticamente all'avvio di Klipper. Se questo comportamento non \u00e8 desiderabile, il profilo predefinito pu\u00f2 essere rimosso come segue: BED_MESH_PROFILE REMOVE=default Qualsiasi altro profilo salvato pu\u00f2 essere rimosso allo stesso modo, sostituendo default con il nome del profilo che desideri rimuovere.","title":"Profili"},{"location":"Bed_Mesh.html#loading-the-default-profile","text":"Previous versions of bed_mesh always loaded the profile named default on startup if it was present. This behavior has been removed in favor of allowing the user to determine when a profile is loaded. If a user wishes to load the default profile it is recommended to add BED_MESH_PROFILE LOAD=default to either their START_PRINT macro or their slicer's \"Start G-Code\" configuration, whichever is applicable. Alternatively the old behavior of loading a profile at startup can be restored with a [delayed_gcode] : [delayed_gcode bed_mesh_init] initial_duration : .01 gcode : BED_MESH_PROFILE LOAD = default","title":"Loading the default profile"},{"location":"Bed_Mesh.html#output","text":"BED_MESH_OUTPUT PGP=[0 | 1] Invia lo stato della mesh corrente al terminale. Si noti che viene emessa la mesh stessa Il parametro PGP \u00e8 un'abbreviazione per \"Print Generated Points\". Se \u00e8 impostato PGP=1 , i punti sondati generati verranno inviati al terminale: // bed_mesh: generated points // Index | Tool Adjusted | Probe // 0 | (11.0, 1.0) | (35.0, 6.0) // 1 | (62.2, 1.0) | (86.2, 6.0) // 2 | (113.5, 1.0) | (137.5, 6.0) // 3 | (164.8, 1.0) | (188.8, 6.0) // 4 | (216.0, 1.0) | (240.0, 6.0) // 5 | (216.0, 97.0) | (240.0, 102.0) // 6 | (164.8, 97.0) | (188.8, 102.0) // 7 | (113.5, 97.0) | (137.5, 102.0) // 8 | (62.2, 97.0) | (86.2, 102.0) // 9 | (11.0, 97.0) | (35.0, 102.0) // 10 | (11.0, 193.0) | (35.0, 198.0) // 11 | (62.2, 193.0) | (86.2, 198.0) // 12 | (113.5, 193.0) | (137.5, 198.0) // 13 | (164.8, 193.0) | (188.8, 198.0) // 14 | (216.0, 193.0) | (240.0, 198.0) I punti \"Tool Adjusted\" si riferiscono alla posizione dell'ugello per ciascun punto e i punti \"Probe\" si riferiscono alla posizione della sonda. Si noti che quando il probing \u00e8 manuale i punti \"sonda\" si riferiscono sia alla posizione dell'utensile che dell'ugello.","title":"Output"},{"location":"Bed_Mesh.html#cancella-stato-mesh","text":"BED_MESH_CLEAR Questo gcode pu\u00f2 essere utilizzato per cancellare lo stato della mesh interna.","title":"Cancella stato mesh"},{"location":"Bed_Mesh.html#applicare-gli-offset-xy","text":"BED_MESH_OFFSET [X=<value>] [Y=<value>] Ci\u00f2 \u00e8 utile per le stampanti con pi\u00f9 estrusori indipendenti, poich\u00e9 \u00e8 necessario un offset per produrre la corretta regolazione Z dopo un cambio utensile. Gli offset devono essere specificati rispetto all'estrusore primario. Vale a dire, \u00e8 necessario specificare un offset X positivo se l'estrusore secondario \u00e8 montato a destra dell'estrusore primario e un offset Y positivo se l'estrusore secondario \u00e8 montato \"dietro\" l'estrusore primario.","title":"Applicare gli offset X/Y"},{"location":"Benchmarks.html","text":"Benchmark \u00b6 Questo documento descrive i benchmark di Klipper. Benchmark del microcontrollore \u00b6 Questa sezione descrive il meccanismo utilizzato per generare i benchmark della velocit\u00e0 di passaggio del microcontrollore Klipper. L'obiettivo principale dei benchmark \u00e8 fornire un meccanismo coerente per misurare l'impatto delle modifiche alla codifica all'interno del software. Un obiettivo secondario \u00e8 fornire metriche di alto livello per confrontare le prestazioni tra i chip e tra le piattaforme software. Il benchmark dello step rate \u00e8 progettato per trovare la velocit\u00e0 di stepping massima che l'hardware e il software possono raggiungere. Questa velocit\u00e0 di stepping del benchmark non \u00e8 raggiungibile nell'uso quotidiano poich\u00e9 Klipper ha bisogno di eseguire altre attivit\u00e0 (ad esempio, comunicazione mcu/host, lettura della temperatura, controllo endstop) in qualsiasi utilizzo nel mondo reale. In generale, i pin per i test di benchmark sono scelti per far lampeggiare LED o altri pin innocui. Verifica sempre che sia sicuro guidare i pin configurati prima di eseguire un benchmark. Non \u00e8 consigliabile pilotare uno stepper reale durante un benchmark. Test di riferimento della frequenza di passi \u00b6 Il test viene eseguito utilizzando lo strumento console.py (descritto in ). Il microcontrollore \u00e8 configurato per la particolare piattaforma hardware (vedi sotto) e quindi quanto segue viene tagliato e incollato nella finestra del terminale console.py: SET start_clock {clock+freq} SET ticks 1000 reset_step_clock oid=0 clock={start_clock} set_next_step_dir oid=0 dir=0 queue_step oid=0 interval={ticks} count=60000 add=0 set_next_step_dir oid=0 dir=1 queue_step oid=0 interval=3000 count=1 add=0 reset_step_clock oid=1 clock={start_clock} set_next_step_dir oid=1 dir=0 queue_step oid=1 interval={ticks} count=60000 add=0 set_next_step_dir oid=1 dir=1 queue_step oid=1 interval=3000 count=1 add=0 reset_step_clock oid=2 clock={start_clock} set_next_step_dir oid=2 dir=0 queue_step oid=2 interval={ticks} count=60000 add=0 set_next_step_dir oid=2 dir=1 queue_step oid=2 interval=3000 count=1 add=0 Quanto sopra testa tre stepper che fanno un passo simultaneo. Se l'esecuzione di quanto sopra comporta un errore \"Rescheduled timer in the past\" o \"Stepper too far in past\", indica che il parametro ticks \u00e8 troppo basso (risulta in una velocit\u00e0 di incremento troppo veloce). L'obiettivo \u00e8 trovare l'impostazione pi\u00f9 bassa del parametro tick che si traduca in modo affidabile in un completamento positivo del test. Dovrebbe essere possibile dividere in due il parametro tick fino a trovare un valore stabile. In caso di errore, \u00e8 possibile copiare e incollare quanto segue per cancellare l'errore in preparazione per il test successivo: clear_shutdown Per ottenere i benchmark del singolo stepper, viene utilizzata la stessa sequenza di configurazione, ma solo il primo blocco del test precedente viene tagliato e incollato nella finestra di console.py. Per produrre i benchmark trovati nel documento Features , il numero totale di passi al secondo viene calcolato moltiplicando il numero di stepper attivi per la frequenza nominale mcu e dividendo per il parametro tick finale. I risultati vengono arrotondati alla K pi\u00f9 vicina. Ad esempio, con tre stepper attivi: ECHO Test result is: {\"%.0fK\" % (3. * freq / ticks / 1000.)} I benchmark vengono eseguiti con parametri adatti ai driver TMC. Per i microcontrollori che supportano STEPPER_BOTH_EDGE=1 (come riportato nella riga MCU config al primo avvio di console.py) usa step_pulse_duration=0 e invert_step=-1 per abilitare lo stepping ottimizzato su entrambi i bordi del impulso di passo. Per altri microcontrollori usa un step_pulse_duration corrispondente a 100ns. Benchmark rateo passi AVR \u00b6 La seguente sequenza di configurazione viene utilizzata sui chip AVR: allocate_oids count=3 config_stepper oid=0 step_pin=PA5 dir_pin=PA4 invert_step=0 step_pulse_ticks=32 config_stepper oid=1 step_pin=PA3 dir_pin=PA2 invert_step=0 step_pulse_ticks=32 config_stepper oid=2 step_pin=PC7 dir_pin=PC6 invert_step=0 step_pulse_ticks=32 finalize_config crc=0 Il test \u00e8 stato eseguito l'ultima volta su commit 59314d99 con versione gcc avr-gcc (GCC) 5.4.0 . Entrambi i test a 16Mhz e 20Mhz sono stati eseguiti utilizzando simulavr configurato per un atmega644p (i test precedenti hanno confermato i risultati del simulavr match test su entrambi un 16Mhz at90usb e un 16Mhz atmega2560). avr ticks 1 stepper 102 3 stepper 486 Benchmark rateo passi Arduino Due \u00b6 Sul Due viene utilizzata la seguente sequenza di configurazione: allocate_oids count=3 config_stepper oid=0 step_pin=PB27 dir_pin=PA21 invert_step=-1 step_pulse_ticks=0 config_stepper oid=1 step_pin=PB26 dir_pin=PC30 invert_step=-1 step_pulse_ticks=0 config_stepper oid=2 step_pin=PA21 dir_pin=PC30 invert_step=-1 step_pulse_ticks=0 finalize_config crc=0 Il test \u00e8 stato eseguito l'ultima volta su commit 59314d99 con versione gcc arm-none-eabi-gcc (Fedora 10.2.0-4.fc34) 10.2.0 . sam3x8e ticks 1 stepper 66 3 stepper 257 Benchmark step rate Duet Maestro \u00b6 La seguente sequenza di configurazione viene utilizzata su Duet Maestro: allocate_oids count=3 config_stepper oid=0 step_pin=PC26 dir_pin=PC18 invert_step=-1 step_pulse_ticks=0 config_stepper oid=1 step_pin=PC26 dir_pin=PA8 invert_step=-1 step_pulse_ticks=0 config_stepper oid=2 step_pin=PC26 dir_pin=PB4 invert_step=-1 step_pulse_ticks=0 finalize_config crc=0 Il test \u00e8 stato eseguito l'ultima volta su commit 59314d99 con versione gcc arm-none-eabi-gcc (Fedora 10.2.0-4.fc34) 10.2.0 . sam4s8c ticks 1 stepper 71 3 stepper 260 Benchmark step rate Duet Wifi \u00b6 La seguente sequenza di configurazione viene utilizzata su Duet Wifi: allocate_oids count=3 config_stepper oid=0 step_pin=PD6 dir_pin=PD11 invert_step=-1 step_pulse_ticks=0 config_stepper oid=1 step_pin=PD7 dir_pin=PD12 invert_step=-1 step_pulse_ticks=0 config_stepper oid=2 step_pin=PD8 dir_pin=PD13 invert_step=-1 step_pulse_ticks=0 finalize_config crc=0 Il test \u00e8 stato eseguito l'ultima volta su commit 59314d99 con gcc versione gcc versione 10.3.1 20210621 (rilascio) (GNU Arm Embedded Toolchain 10.3-2021.07) . sam4e8e ticks 1 stepper 48 3 stepper 215 Benchmark step rate Beaglebone PRU \u00b6 Sulla PRU viene utilizzata la seguente sequenza di configurazione: allocate_oids count=3 config_stepper oid=0 step_pin=gpio0_23 dir_pin=gpio1_12 invert_step=0 step_pulse_ticks=20 config_stepper oid=1 step_pin=gpio1_15 dir_pin=gpio0_26 invert_step=0 step_pulse_ticks=20 config_stepper oid=2 step_pin=gpio0_22 dir_pin=gpio2_1 invert_step=0 step_pulse_ticks=20 finalize_config crc=0 Il test \u00e8 stato eseguito l'ultima volta su commit 59314d99 con versione gcc pru-gcc (GCC) 8.0.0 20170530 (sperimentale) . pru ticks 1 stepper 231 3 stepper 847 Benchmark step rate STM32F042 \u00b6 La seguente sequenza di configurazione viene utilizzata sull'STM32F042: allocate_oids count=3 config_stepper oid=0 step_pin=PA1 dir_pin=PA2 invert_step=-1 step_pulse_ticks=0 config_stepper oid=1 step_pin=PA3 dir_pin=PA2 invert_step=-1 step_pulse_ticks=0 config_stepper oid=2 step_pin=PB8 dir_pin=PA2 invert_step=-1 step_pulse_ticks=0 finalize_config crc=0 Il test \u00e8 stato eseguito l'ultima volta su commit 59314d99 con versione gcc arm-none-eabi-gcc (Fedora 10.2.0-4.fc34) 10.2.0 . stm32f042 ticks 1 stepper 59 3 stepper 249 Benchmark step rate STM32F103 \u00b6 Sull'STM32F103 viene utilizzata la seguente sequenza di configurazione: allocate_oids count=3 config_stepper oid=0 step_pin=PC13 dir_pin=PB5 invert_step=-1 step_pulse_ticks=0 config_stepper oid=1 step_pin=PB3 dir_pin=PB6 invert_step=-1 step_pulse_ticks=0 config_stepper oid=2 step_pin=PA4 dir_pin=PB7 invert_step=-1 step_pulse_ticks=0 finalize_config crc=0 Il test \u00e8 stato eseguito l'ultima volta su commit 59314d99 con versione gcc arm-none-eabi-gcc (Fedora 10.2.0-4.fc34) 10.2.0 . stm32f103 ticks 1 stepper 61 3 stepper 264 Benchmark step rate STM32F4 \u00b6 Sull'STM32F4 viene utilizzata la seguente sequenza di configurazione: allocate_oids count=3 config_stepper oid=0 step_pin=PA5 dir_pin=PB5 invert_step=-1 step_pulse_ticks=0 config_stepper oid=1 step_pin=PB2 dir_pin=PB6 invert_step=-1 step_pulse_ticks=0 config_stepper oid=2 step_pin=PB3 dir_pin=PB7 invert_step=-1 step_pulse_ticks=0 finalize_config crc=0 Il test \u00e8 stato eseguito l'ultima volta su commit 59314d99 con versione gcc arm-none-eabi-gcc (Fedora 10.2.0-4.fc34) 10.2.0 . I risultati dell'STM32F407 sono stati ottenuti eseguendo un binario STM32F407 su un STM32F446 (e quindi utilizzando un clock a 168 Mhz). stm32f446 ticks 1 stepper 46 3 stepper 205 stm32f407 ticks 1 stepper 46 3 stepper 205 STM32H7 benchmark della velocit\u00e0 di step \u00b6 La seguente sequenza di configurazione viene utilizzata su un STM32H743VIT6: allocate_oids count=3 config_stepper oid=0 step_pin=PD4 dir_pin=PD3 invert_step=-1 step_pulse_ticks=0 config_stepper oid=1 step_pin=PA15 dir_pin=PA8 invert_step=-1 step_pulse_ticks=0 config_stepper oid=2 step_pin=PE2 dir_pin=PE3 invert_step=-1 step_pulse_ticks=0 finalize_config crc=0 Il test \u00e8 stato eseguito l'ultima volta su commit 00191b5c con versione gcc arm-none-eabi-gcc (15:8-2019-q3-1+b1) 8.3.1 20190703 (release) [gcc-8-branch revisione 273027] . stm32h7 ticks 1 stepper 44 3 stepper 198 Benchmark step rate STM32G0B1 \u00b6 Sull'STM32G0B1 viene utilizzata la seguente sequenza di configurazione: allocate_oids count=3 config_stepper oid=0 step_pin=PB13 dir_pin=PB12 invert_step=-1 step_pulse_ticks=0 config_stepper oid=1 step_pin=PB10 dir_pin=PB2 invert_step=-1 step_pulse_ticks=0 config_stepper oid=2 step_pin=PB0 dir_pin=PC5 invert_step=-1 step_pulse_ticks=0 finalize_config crc=0 Il test \u00e8 stato eseguito l'ultima volta su commit 247cd753 con versione gcc arm-none-eabi-gcc (Fedora 10.2.0-4.fc34) 10.2.0 . stm32g0b1 ticks 1 stepper 58 3 stepper 243 Benchmark step rate LPC176x \u00b6 La seguente sequenza di configurazione viene utilizzata sull'LPC176x: allocate_oids count=3 config_stepper oid=0 step_pin=P1.20 dir_pin=P1.18 invert_step=-1 step_pulse_ticks=0 config_stepper oid=1 step_pin=P1.21 dir_pin=P1.18 invert_step=-1 step_pulse_ticks=0 config_stepper oid=2 step_pin=P1.23 dir_pin=P1.18 invert_step=-1 step_pulse_ticks=0 finalize_config crc=0 Il test \u00e8 stato eseguito l'ultima volta su commit 59314d99 con versione gcc arm-none-eabi-gcc (Fedora 10.2.0-4.fc34) 10.2.0 . I risultati a 120 Mhz LPC1769 sono stati ottenuti overclockando un LPC1768 a 120 Mhz. lpc1768 ticks 1 stepper 52 3 stepper 222 lpc1769 ticks 1 stepper 51 3 stepper 222 Benchmark step rate SAMD21 \u00b6 La seguente sequenza di configurazione viene utilizzata sul SAMD21: allocate_oids count=3 config_stepper oid=0 step_pin=PA27 dir_pin=PA20 invert_step=-1 step_pulse_ticks=0 config_stepper oid=1 step_pin=PB3 dir_pin=PA21 invert_step=-1 step_pulse_ticks=0 config_stepper oid=2 step_pin=PA17 dir_pin=PA21 invert_step=-1 step_pulse_ticks=0 finalize_config crc=0 Il test \u00e8 stato eseguito l'ultima volta su commit 59314d99 con versione gcc arm-none-eabi-gcc (Fedora 10.2.0-4.fc34) 10.2.0 su un microcontrollore SAMD21G18. samd21 ticks 1 stepper 70 3 stepper 306 Benchmark step rate SAMD51 \u00b6 La seguente sequenza di configurazione viene utilizzata sul SAMD51: allocate_oids count=3 config_stepper oid=0 step_pin=PA22 dir_pin=PA20 invert_step=-1 step_pulse_ticks=0 config_stepper oid=1 step_pin=PA22 dir_pin=PA21 invert_step=-1 step_pulse_ticks=0 config_stepper oid=2 step_pin=PA22 dir_pin=PA19 invert_step=-1 step_pulse_ticks=0 finalize_config crc=0 Il test \u00e8 stato eseguito l'ultima volta su commit 59314d99 con versione gcc arm-none-eabi-gcc (Fedora 10.2.0-4.fc34) 10.2.0 su un microcontrollore SAMD51J19A. samd51 ticks 1 stepper 39 3 stepper 191 1 stepper (200Mhz) 39 3 stepper (200Mhz) 181 Benchmark step rate RP2040 \u00b6 Sull'RP2040 viene utilizzata la seguente sequenza di configurazione: allocate_oids count=3 config_stepper oid=0 step_pin=gpio25 dir_pin=gpio3 invert_step=-1 step_pulse_ticks=0 config_stepper oid=1 step_pin=gpio26 dir_pin=gpio4 invert_step=-1 step_pulse_ticks=0 config_stepper oid=2 step_pin=gpio27 dir_pin=gpio5 invert_step=-1 step_pulse_ticks=0 finalize_config crc=0 Il test \u00e8 stato eseguito l'ultima volta su commit 59314d99 con versione gcc arm-none-eabi-gcc (Fedora 10.2.0-4.fc34) 10.2.0 su una scheda Raspberry Pi Pico. rp2040 ticks 1 stepper 5 3 stepper 22 Benchmark step rate MCU Linux \u00b6 La seguente sequenza di configurazione viene utilizzata su un Raspberry Pi: allocate_oids count=3 config_stepper oid=0 step_pin=gpio2 dir_pin=gpio3 invert_step=0 step_pulse_ticks=5 config_stepper oid=1 step_pin=gpio4 dir_pin=gpio5 invert_step=0 step_pulse_ticks=5 config_stepper oid=2 step_pin=gpio6 dir_pin=gpio17 invert_step=0 step_pulse_ticks=5 finalize_config crc=0 Il test \u00e8 stato eseguito l'ultima volta su commit 59314d99 con versione gcc gcc (Raspbian 8.3.0-6+rpi1) 8.3.0 su un Raspberry Pi 3 (revisione a02082). \u00c8 stato difficile ottenere risultati stabili in questo benchmark. Linux (RPi3) ticks 1 stepper 160 3 stepper 380 Benchmark dispacciamento comandi \u00b6 Il benchmark di invio dei comandi verifica quanti comandi \"fittizi\" possono elaborare il microcontrollore. \u00c8 principalmente un test del meccanismo di comunicazione hardware. Il test viene eseguito utilizzando lo strumento console.py (descritto in ). Quanto segue \u00e8 taglia e incolla nella finestra del terminale console.py: DELAY {clock + 2*freq} get_uptime FLOOD 100000 0.0 debug_nop get_uptime Al termine del test, determinare la differenza tra gli orologi riportati nei due messaggi di risposta \"uptime\". Il numero totale di comandi al secondo \u00e8 quindi 100000 * mcu_frequency / clock_diff . Nota che questo test potrebbe saturare la capacit\u00e0 USB/CPU di un Raspberry Pi. Se \u00e8 in esecuzione su un computer host Raspberry Pi, Beaglebone o simile, aumenta il ritardo (ad esempio, DELAY {clock + 20*freq} get_uptime ). Ove applicabile, i benchmark seguenti riguardano console.py in esecuzione su una macchina di classe desktop con il dispositivo connesso tramite un hub ad alta velocit\u00e0. MCU Rateo Build Build compiler stm32f042 (CAN) 18K c105adc8 arm-none-eabi-gcc (GNU Tools 7-2018-q3-update) 7.3.1 atmega2560 (serial) 23K b161a69e avr-gcc (GCC) 4.8.1 sam3x8e (serial) 23K b161a69e arm-none-eabi-gcc (Fedora 7.1.0-5.fc27) 7.1.0 at90usb1286 (USB) 75K 01d2183f avr-gcc (GCC) 5.4.0 samd21 (USB) 223K 01d2183f arm-none-eabi-gcc (Fedora 7.4.0-1.fc30) 7.4.0 pru (shared memory) 260K c5968a08 pru-gcc (GCC) 8.0.0 20170530 (experimental) stm32f103 (USB) 355K 01d2183f arm-none-eabi-gcc (Fedora 7.4.0-1.fc30) 7.4.0 sam3x8e (USB) 418K 01d2183f arm-none-eabi-gcc (Fedora 7.4.0-1.fc30) 7.4.0 lpc1768 (USB) 534K 01d2183f arm-none-eabi-gcc (Fedora 7.4.0-1.fc30) 7.4.0 lpc1769 (USB) 628K 01d2183f arm-none-eabi-gcc (Fedora 7.4.0-1.fc30) 7.4.0 sam4s8c (USB) 650K 8d4a5c16 arm-none-eabi-gcc (Fedora 7.4.0-1.fc30) 7.4.0 samd51 (USB) 864K 01d2183f arm-none-eabi-gcc (Fedora 7.4.0-1.fc30) 7.4.0 stm32f446 (USB) 870K 01d2183f arm-none-eabi-gcc (Fedora 7.4.0-1.fc30) 7.4.0 rp2040 (USB) 873K c5667193 arm-none-eabi-gcc (Fedora 10.2.0-4.fc34) 10.2.0 Benchmark Host \u00b6 \u00c8 possibile eseguire test di temporizzazione sul software host utilizzando il meccanismo di elaborazione \"batch mode\" (descritto in ). Questo viene in genere fatto scegliendo un file G-Code grande e complesso e calcolando il tempo impiegato dal software host per elaborarlo. Per esempio: time ~/klippy-env/bin/python ./klippy/klippy.py config/example-cartesian.cfg -i something_complex.gcode -o /dev/null -d out/klipper.dict","title":"Benchmark"},{"location":"Benchmarks.html#benchmark","text":"Questo documento descrive i benchmark di Klipper.","title":"Benchmark"},{"location":"Benchmarks.html#benchmark-del-microcontrollore","text":"Questa sezione descrive il meccanismo utilizzato per generare i benchmark della velocit\u00e0 di passaggio del microcontrollore Klipper. L'obiettivo principale dei benchmark \u00e8 fornire un meccanismo coerente per misurare l'impatto delle modifiche alla codifica all'interno del software. Un obiettivo secondario \u00e8 fornire metriche di alto livello per confrontare le prestazioni tra i chip e tra le piattaforme software. Il benchmark dello step rate \u00e8 progettato per trovare la velocit\u00e0 di stepping massima che l'hardware e il software possono raggiungere. Questa velocit\u00e0 di stepping del benchmark non \u00e8 raggiungibile nell'uso quotidiano poich\u00e9 Klipper ha bisogno di eseguire altre attivit\u00e0 (ad esempio, comunicazione mcu/host, lettura della temperatura, controllo endstop) in qualsiasi utilizzo nel mondo reale. In generale, i pin per i test di benchmark sono scelti per far lampeggiare LED o altri pin innocui. Verifica sempre che sia sicuro guidare i pin configurati prima di eseguire un benchmark. Non \u00e8 consigliabile pilotare uno stepper reale durante un benchmark.","title":"Benchmark del microcontrollore"},{"location":"Benchmarks.html#test-di-riferimento-della-frequenza-di-passi","text":"Il test viene eseguito utilizzando lo strumento console.py (descritto in ). Il microcontrollore \u00e8 configurato per la particolare piattaforma hardware (vedi sotto) e quindi quanto segue viene tagliato e incollato nella finestra del terminale console.py: SET start_clock {clock+freq} SET ticks 1000 reset_step_clock oid=0 clock={start_clock} set_next_step_dir oid=0 dir=0 queue_step oid=0 interval={ticks} count=60000 add=0 set_next_step_dir oid=0 dir=1 queue_step oid=0 interval=3000 count=1 add=0 reset_step_clock oid=1 clock={start_clock} set_next_step_dir oid=1 dir=0 queue_step oid=1 interval={ticks} count=60000 add=0 set_next_step_dir oid=1 dir=1 queue_step oid=1 interval=3000 count=1 add=0 reset_step_clock oid=2 clock={start_clock} set_next_step_dir oid=2 dir=0 queue_step oid=2 interval={ticks} count=60000 add=0 set_next_step_dir oid=2 dir=1 queue_step oid=2 interval=3000 count=1 add=0 Quanto sopra testa tre stepper che fanno un passo simultaneo. Se l'esecuzione di quanto sopra comporta un errore \"Rescheduled timer in the past\" o \"Stepper too far in past\", indica che il parametro ticks \u00e8 troppo basso (risulta in una velocit\u00e0 di incremento troppo veloce). L'obiettivo \u00e8 trovare l'impostazione pi\u00f9 bassa del parametro tick che si traduca in modo affidabile in un completamento positivo del test. Dovrebbe essere possibile dividere in due il parametro tick fino a trovare un valore stabile. In caso di errore, \u00e8 possibile copiare e incollare quanto segue per cancellare l'errore in preparazione per il test successivo: clear_shutdown Per ottenere i benchmark del singolo stepper, viene utilizzata la stessa sequenza di configurazione, ma solo il primo blocco del test precedente viene tagliato e incollato nella finestra di console.py. Per produrre i benchmark trovati nel documento Features , il numero totale di passi al secondo viene calcolato moltiplicando il numero di stepper attivi per la frequenza nominale mcu e dividendo per il parametro tick finale. I risultati vengono arrotondati alla K pi\u00f9 vicina. Ad esempio, con tre stepper attivi: ECHO Test result is: {\"%.0fK\" % (3. * freq / ticks / 1000.)} I benchmark vengono eseguiti con parametri adatti ai driver TMC. Per i microcontrollori che supportano STEPPER_BOTH_EDGE=1 (come riportato nella riga MCU config al primo avvio di console.py) usa step_pulse_duration=0 e invert_step=-1 per abilitare lo stepping ottimizzato su entrambi i bordi del impulso di passo. Per altri microcontrollori usa un step_pulse_duration corrispondente a 100ns.","title":"Test di riferimento della frequenza di passi"},{"location":"Benchmarks.html#benchmark-rateo-passi-avr","text":"La seguente sequenza di configurazione viene utilizzata sui chip AVR: allocate_oids count=3 config_stepper oid=0 step_pin=PA5 dir_pin=PA4 invert_step=0 step_pulse_ticks=32 config_stepper oid=1 step_pin=PA3 dir_pin=PA2 invert_step=0 step_pulse_ticks=32 config_stepper oid=2 step_pin=PC7 dir_pin=PC6 invert_step=0 step_pulse_ticks=32 finalize_config crc=0 Il test \u00e8 stato eseguito l'ultima volta su commit 59314d99 con versione gcc avr-gcc (GCC) 5.4.0 . Entrambi i test a 16Mhz e 20Mhz sono stati eseguiti utilizzando simulavr configurato per un atmega644p (i test precedenti hanno confermato i risultati del simulavr match test su entrambi un 16Mhz at90usb e un 16Mhz atmega2560). avr ticks 1 stepper 102 3 stepper 486","title":"Benchmark rateo passi AVR"},{"location":"Benchmarks.html#benchmark-rateo-passi-arduino-due","text":"Sul Due viene utilizzata la seguente sequenza di configurazione: allocate_oids count=3 config_stepper oid=0 step_pin=PB27 dir_pin=PA21 invert_step=-1 step_pulse_ticks=0 config_stepper oid=1 step_pin=PB26 dir_pin=PC30 invert_step=-1 step_pulse_ticks=0 config_stepper oid=2 step_pin=PA21 dir_pin=PC30 invert_step=-1 step_pulse_ticks=0 finalize_config crc=0 Il test \u00e8 stato eseguito l'ultima volta su commit 59314d99 con versione gcc arm-none-eabi-gcc (Fedora 10.2.0-4.fc34) 10.2.0 . sam3x8e ticks 1 stepper 66 3 stepper 257","title":"Benchmark rateo passi Arduino Due"},{"location":"Benchmarks.html#benchmark-step-rate-duet-maestro","text":"La seguente sequenza di configurazione viene utilizzata su Duet Maestro: allocate_oids count=3 config_stepper oid=0 step_pin=PC26 dir_pin=PC18 invert_step=-1 step_pulse_ticks=0 config_stepper oid=1 step_pin=PC26 dir_pin=PA8 invert_step=-1 step_pulse_ticks=0 config_stepper oid=2 step_pin=PC26 dir_pin=PB4 invert_step=-1 step_pulse_ticks=0 finalize_config crc=0 Il test \u00e8 stato eseguito l'ultima volta su commit 59314d99 con versione gcc arm-none-eabi-gcc (Fedora 10.2.0-4.fc34) 10.2.0 . sam4s8c ticks 1 stepper 71 3 stepper 260","title":"Benchmark step rate Duet Maestro"},{"location":"Benchmarks.html#benchmark-step-rate-duet-wifi","text":"La seguente sequenza di configurazione viene utilizzata su Duet Wifi: allocate_oids count=3 config_stepper oid=0 step_pin=PD6 dir_pin=PD11 invert_step=-1 step_pulse_ticks=0 config_stepper oid=1 step_pin=PD7 dir_pin=PD12 invert_step=-1 step_pulse_ticks=0 config_stepper oid=2 step_pin=PD8 dir_pin=PD13 invert_step=-1 step_pulse_ticks=0 finalize_config crc=0 Il test \u00e8 stato eseguito l'ultima volta su commit 59314d99 con gcc versione gcc versione 10.3.1 20210621 (rilascio) (GNU Arm Embedded Toolchain 10.3-2021.07) . sam4e8e ticks 1 stepper 48 3 stepper 215","title":"Benchmark step rate Duet Wifi"},{"location":"Benchmarks.html#benchmark-step-rate-beaglebone-pru","text":"Sulla PRU viene utilizzata la seguente sequenza di configurazione: allocate_oids count=3 config_stepper oid=0 step_pin=gpio0_23 dir_pin=gpio1_12 invert_step=0 step_pulse_ticks=20 config_stepper oid=1 step_pin=gpio1_15 dir_pin=gpio0_26 invert_step=0 step_pulse_ticks=20 config_stepper oid=2 step_pin=gpio0_22 dir_pin=gpio2_1 invert_step=0 step_pulse_ticks=20 finalize_config crc=0 Il test \u00e8 stato eseguito l'ultima volta su commit 59314d99 con versione gcc pru-gcc (GCC) 8.0.0 20170530 (sperimentale) . pru ticks 1 stepper 231 3 stepper 847","title":"Benchmark step rate Beaglebone PRU"},{"location":"Benchmarks.html#benchmark-step-rate-stm32f042","text":"La seguente sequenza di configurazione viene utilizzata sull'STM32F042: allocate_oids count=3 config_stepper oid=0 step_pin=PA1 dir_pin=PA2 invert_step=-1 step_pulse_ticks=0 config_stepper oid=1 step_pin=PA3 dir_pin=PA2 invert_step=-1 step_pulse_ticks=0 config_stepper oid=2 step_pin=PB8 dir_pin=PA2 invert_step=-1 step_pulse_ticks=0 finalize_config crc=0 Il test \u00e8 stato eseguito l'ultima volta su commit 59314d99 con versione gcc arm-none-eabi-gcc (Fedora 10.2.0-4.fc34) 10.2.0 . stm32f042 ticks 1 stepper 59 3 stepper 249","title":"Benchmark step rate STM32F042"},{"location":"Benchmarks.html#benchmark-step-rate-stm32f103","text":"Sull'STM32F103 viene utilizzata la seguente sequenza di configurazione: allocate_oids count=3 config_stepper oid=0 step_pin=PC13 dir_pin=PB5 invert_step=-1 step_pulse_ticks=0 config_stepper oid=1 step_pin=PB3 dir_pin=PB6 invert_step=-1 step_pulse_ticks=0 config_stepper oid=2 step_pin=PA4 dir_pin=PB7 invert_step=-1 step_pulse_ticks=0 finalize_config crc=0 Il test \u00e8 stato eseguito l'ultima volta su commit 59314d99 con versione gcc arm-none-eabi-gcc (Fedora 10.2.0-4.fc34) 10.2.0 . stm32f103 ticks 1 stepper 61 3 stepper 264","title":"Benchmark step rate STM32F103"},{"location":"Benchmarks.html#benchmark-step-rate-stm32f4","text":"Sull'STM32F4 viene utilizzata la seguente sequenza di configurazione: allocate_oids count=3 config_stepper oid=0 step_pin=PA5 dir_pin=PB5 invert_step=-1 step_pulse_ticks=0 config_stepper oid=1 step_pin=PB2 dir_pin=PB6 invert_step=-1 step_pulse_ticks=0 config_stepper oid=2 step_pin=PB3 dir_pin=PB7 invert_step=-1 step_pulse_ticks=0 finalize_config crc=0 Il test \u00e8 stato eseguito l'ultima volta su commit 59314d99 con versione gcc arm-none-eabi-gcc (Fedora 10.2.0-4.fc34) 10.2.0 . I risultati dell'STM32F407 sono stati ottenuti eseguendo un binario STM32F407 su un STM32F446 (e quindi utilizzando un clock a 168 Mhz). stm32f446 ticks 1 stepper 46 3 stepper 205 stm32f407 ticks 1 stepper 46 3 stepper 205","title":"Benchmark step rate STM32F4"},{"location":"Benchmarks.html#stm32h7-benchmark-della-velocita-di-step","text":"La seguente sequenza di configurazione viene utilizzata su un STM32H743VIT6: allocate_oids count=3 config_stepper oid=0 step_pin=PD4 dir_pin=PD3 invert_step=-1 step_pulse_ticks=0 config_stepper oid=1 step_pin=PA15 dir_pin=PA8 invert_step=-1 step_pulse_ticks=0 config_stepper oid=2 step_pin=PE2 dir_pin=PE3 invert_step=-1 step_pulse_ticks=0 finalize_config crc=0 Il test \u00e8 stato eseguito l'ultima volta su commit 00191b5c con versione gcc arm-none-eabi-gcc (15:8-2019-q3-1+b1) 8.3.1 20190703 (release) [gcc-8-branch revisione 273027] . stm32h7 ticks 1 stepper 44 3 stepper 198","title":"STM32H7 benchmark della velocit\u00e0 di step"},{"location":"Benchmarks.html#benchmark-step-rate-stm32g0b1","text":"Sull'STM32G0B1 viene utilizzata la seguente sequenza di configurazione: allocate_oids count=3 config_stepper oid=0 step_pin=PB13 dir_pin=PB12 invert_step=-1 step_pulse_ticks=0 config_stepper oid=1 step_pin=PB10 dir_pin=PB2 invert_step=-1 step_pulse_ticks=0 config_stepper oid=2 step_pin=PB0 dir_pin=PC5 invert_step=-1 step_pulse_ticks=0 finalize_config crc=0 Il test \u00e8 stato eseguito l'ultima volta su commit 247cd753 con versione gcc arm-none-eabi-gcc (Fedora 10.2.0-4.fc34) 10.2.0 . stm32g0b1 ticks 1 stepper 58 3 stepper 243","title":"Benchmark step rate STM32G0B1"},{"location":"Benchmarks.html#benchmark-step-rate-lpc176x","text":"La seguente sequenza di configurazione viene utilizzata sull'LPC176x: allocate_oids count=3 config_stepper oid=0 step_pin=P1.20 dir_pin=P1.18 invert_step=-1 step_pulse_ticks=0 config_stepper oid=1 step_pin=P1.21 dir_pin=P1.18 invert_step=-1 step_pulse_ticks=0 config_stepper oid=2 step_pin=P1.23 dir_pin=P1.18 invert_step=-1 step_pulse_ticks=0 finalize_config crc=0 Il test \u00e8 stato eseguito l'ultima volta su commit 59314d99 con versione gcc arm-none-eabi-gcc (Fedora 10.2.0-4.fc34) 10.2.0 . I risultati a 120 Mhz LPC1769 sono stati ottenuti overclockando un LPC1768 a 120 Mhz. lpc1768 ticks 1 stepper 52 3 stepper 222 lpc1769 ticks 1 stepper 51 3 stepper 222","title":"Benchmark step rate LPC176x"},{"location":"Benchmarks.html#benchmark-step-rate-samd21","text":"La seguente sequenza di configurazione viene utilizzata sul SAMD21: allocate_oids count=3 config_stepper oid=0 step_pin=PA27 dir_pin=PA20 invert_step=-1 step_pulse_ticks=0 config_stepper oid=1 step_pin=PB3 dir_pin=PA21 invert_step=-1 step_pulse_ticks=0 config_stepper oid=2 step_pin=PA17 dir_pin=PA21 invert_step=-1 step_pulse_ticks=0 finalize_config crc=0 Il test \u00e8 stato eseguito l'ultima volta su commit 59314d99 con versione gcc arm-none-eabi-gcc (Fedora 10.2.0-4.fc34) 10.2.0 su un microcontrollore SAMD21G18. samd21 ticks 1 stepper 70 3 stepper 306","title":"Benchmark step rate SAMD21"},{"location":"Benchmarks.html#benchmark-step-rate-samd51","text":"La seguente sequenza di configurazione viene utilizzata sul SAMD51: allocate_oids count=3 config_stepper oid=0 step_pin=PA22 dir_pin=PA20 invert_step=-1 step_pulse_ticks=0 config_stepper oid=1 step_pin=PA22 dir_pin=PA21 invert_step=-1 step_pulse_ticks=0 config_stepper oid=2 step_pin=PA22 dir_pin=PA19 invert_step=-1 step_pulse_ticks=0 finalize_config crc=0 Il test \u00e8 stato eseguito l'ultima volta su commit 59314d99 con versione gcc arm-none-eabi-gcc (Fedora 10.2.0-4.fc34) 10.2.0 su un microcontrollore SAMD51J19A. samd51 ticks 1 stepper 39 3 stepper 191 1 stepper (200Mhz) 39 3 stepper (200Mhz) 181","title":"Benchmark step rate SAMD51"},{"location":"Benchmarks.html#benchmark-step-rate-rp2040","text":"Sull'RP2040 viene utilizzata la seguente sequenza di configurazione: allocate_oids count=3 config_stepper oid=0 step_pin=gpio25 dir_pin=gpio3 invert_step=-1 step_pulse_ticks=0 config_stepper oid=1 step_pin=gpio26 dir_pin=gpio4 invert_step=-1 step_pulse_ticks=0 config_stepper oid=2 step_pin=gpio27 dir_pin=gpio5 invert_step=-1 step_pulse_ticks=0 finalize_config crc=0 Il test \u00e8 stato eseguito l'ultima volta su commit 59314d99 con versione gcc arm-none-eabi-gcc (Fedora 10.2.0-4.fc34) 10.2.0 su una scheda Raspberry Pi Pico. rp2040 ticks 1 stepper 5 3 stepper 22","title":"Benchmark step rate RP2040"},{"location":"Benchmarks.html#benchmark-step-rate-mcu-linux","text":"La seguente sequenza di configurazione viene utilizzata su un Raspberry Pi: allocate_oids count=3 config_stepper oid=0 step_pin=gpio2 dir_pin=gpio3 invert_step=0 step_pulse_ticks=5 config_stepper oid=1 step_pin=gpio4 dir_pin=gpio5 invert_step=0 step_pulse_ticks=5 config_stepper oid=2 step_pin=gpio6 dir_pin=gpio17 invert_step=0 step_pulse_ticks=5 finalize_config crc=0 Il test \u00e8 stato eseguito l'ultima volta su commit 59314d99 con versione gcc gcc (Raspbian 8.3.0-6+rpi1) 8.3.0 su un Raspberry Pi 3 (revisione a02082). \u00c8 stato difficile ottenere risultati stabili in questo benchmark. Linux (RPi3) ticks 1 stepper 160 3 stepper 380","title":"Benchmark step rate MCU Linux"},{"location":"Benchmarks.html#benchmark-dispacciamento-comandi","text":"Il benchmark di invio dei comandi verifica quanti comandi \"fittizi\" possono elaborare il microcontrollore. \u00c8 principalmente un test del meccanismo di comunicazione hardware. Il test viene eseguito utilizzando lo strumento console.py (descritto in ). Quanto segue \u00e8 taglia e incolla nella finestra del terminale console.py: DELAY {clock + 2*freq} get_uptime FLOOD 100000 0.0 debug_nop get_uptime Al termine del test, determinare la differenza tra gli orologi riportati nei due messaggi di risposta \"uptime\". Il numero totale di comandi al secondo \u00e8 quindi 100000 * mcu_frequency / clock_diff . Nota che questo test potrebbe saturare la capacit\u00e0 USB/CPU di un Raspberry Pi. Se \u00e8 in esecuzione su un computer host Raspberry Pi, Beaglebone o simile, aumenta il ritardo (ad esempio, DELAY {clock + 20*freq} get_uptime ). Ove applicabile, i benchmark seguenti riguardano console.py in esecuzione su una macchina di classe desktop con il dispositivo connesso tramite un hub ad alta velocit\u00e0. MCU Rateo Build Build compiler stm32f042 (CAN) 18K c105adc8 arm-none-eabi-gcc (GNU Tools 7-2018-q3-update) 7.3.1 atmega2560 (serial) 23K b161a69e avr-gcc (GCC) 4.8.1 sam3x8e (serial) 23K b161a69e arm-none-eabi-gcc (Fedora 7.1.0-5.fc27) 7.1.0 at90usb1286 (USB) 75K 01d2183f avr-gcc (GCC) 5.4.0 samd21 (USB) 223K 01d2183f arm-none-eabi-gcc (Fedora 7.4.0-1.fc30) 7.4.0 pru (shared memory) 260K c5968a08 pru-gcc (GCC) 8.0.0 20170530 (experimental) stm32f103 (USB) 355K 01d2183f arm-none-eabi-gcc (Fedora 7.4.0-1.fc30) 7.4.0 sam3x8e (USB) 418K 01d2183f arm-none-eabi-gcc (Fedora 7.4.0-1.fc30) 7.4.0 lpc1768 (USB) 534K 01d2183f arm-none-eabi-gcc (Fedora 7.4.0-1.fc30) 7.4.0 lpc1769 (USB) 628K 01d2183f arm-none-eabi-gcc (Fedora 7.4.0-1.fc30) 7.4.0 sam4s8c (USB) 650K 8d4a5c16 arm-none-eabi-gcc (Fedora 7.4.0-1.fc30) 7.4.0 samd51 (USB) 864K 01d2183f arm-none-eabi-gcc (Fedora 7.4.0-1.fc30) 7.4.0 stm32f446 (USB) 870K 01d2183f arm-none-eabi-gcc (Fedora 7.4.0-1.fc30) 7.4.0 rp2040 (USB) 873K c5667193 arm-none-eabi-gcc (Fedora 10.2.0-4.fc34) 10.2.0","title":"Benchmark dispacciamento comandi"},{"location":"Benchmarks.html#benchmark-host","text":"\u00c8 possibile eseguire test di temporizzazione sul software host utilizzando il meccanismo di elaborazione \"batch mode\" (descritto in ). Questo viene in genere fatto scegliendo un file G-Code grande e complesso e calcolando il tempo impiegato dal software host per elaborarlo. Per esempio: time ~/klippy-env/bin/python ./klippy/klippy.py config/example-cartesian.cfg -i something_complex.gcode -o /dev/null -d out/klipper.dict","title":"Benchmark Host"},{"location":"Bootloaders.html","text":"Bootloader \u00b6 Questo documento fornisce informazioni sui bootloader comuni scoperti sui microcontrollori che sono supportati da Klipper. Il bootloader \u00e8 un software di terze parti che viene eseguito sul microcontrollore quando viene acceso per la prima volta. Viene generalmente utilizzato per eseguire il flashing di una nuova applicazione (ad es. Klipper) sul microcontrollore senza richiedere hardware specializzato. Sfortunatamente, non esiste uno standard a livello di settore per il flashing di un microcontrollore, n\u00e9 esiste un bootloader standard che funzioni su tutti i microcontrollori. Peggio ancora, \u00e8 comune che ogni bootloader richieda una serie di passaggi diversa per eseguire il flashing di un'applicazione. Se si pu\u00f2 eseguire il flashing di un bootloader su un microcontrollore, generalmente si pu\u00f2 anche utilizzare quel meccanismo per eseguire il flashing di un'applicazione, ma \u00e8 necessario prestare attenzione quando si esegue questa operazione poich\u00e9 si potrebbe rimuovere inavvertitamente il bootloader. Al contrario, un bootloader generalmente consentir\u00e0 solo a un utente di eseguire il flashing di un'applicazione. Si consiglia pertanto di utilizzare un bootloader per eseguire il flashing di un'applicazione, ove possibile. Questo documento tenta di descrivere i bootloader comuni, i passaggi necessari per eseguire il flashing di un bootloader e i passaggi necessari per eseguire il flashing di un'applicazione. Questo documento non \u00e8 un riferimento autorevole; \u00e8 inteso come una raccolta di informazioni utili che gli sviluppatori di Klipper hanno accumulato. Microcontrollori AVR \u00b6 In generale, il progetto Arduino \u00e8 un buon riferimento per bootloader e procedure di flashing sui microcontrollori Atmel Atmega a 8 bit. In particolare, il file \"boards.txt\": https://github.com/arduino/Arduino/blob/1.8.5/hardware/arduino/avr/boards.txt \u00e8 un utile riferimento. Per eseguire il flashing di un bootloader, i chip AVR richiedono uno strumento di flashing hardware esterno (che comunica con il chip tramite SPI). Questo strumento pu\u00f2 essere acquistato (ad esempio, eseguire una ricerca sul Web per \"avr isp\", \"arduino isp\" o \"usb tiny isp\"). \u00c8 anche possibile utilizzare un altro Arduino o Raspberry Pi per eseguire il flashing di un bootloader AVR (ad esempio, eseguire una ricerca sul Web per \"programmare un avr utilizzando raspberry pi\"). Gli esempi seguenti sono scritti presupponendo che sia in uso un dispositivo di tipo \"AVR ISP Mk2\". Il programma \"avrdude\" \u00e8 lo strumento pi\u00f9 comune utilizzato per eseguire il flashing dei chip atmega (sia flash del bootloader che flash dell'applicazione). Atmega2560 \u00b6 Questo chip si trova in genere nell'\"Arduino Mega\" ed \u00e8 molto comune nelle schede per stampanti 3D. Per eseguire il flashing del bootloader stesso usa qualcosa come: wget 'https://github.com/arduino/Arduino/raw/1.8.5/hardware/arduino/avr/bootloaders/stk500v2/stk500boot_v2_mega2560.hex' avrdude -cavrispv2 -patmega2560 -P/dev/ttyACM0 -b115200 -e -u -U lock:w:0x3F:m -U efuse:w:0xFD:m -U hfuse:w:0xD8:m -U lfuse:w:0xFF:m avrdude -cavrispv2 -patmega2560 -P/dev/ttyACM0 -b115200 -U flash:w:stk500boot_v2_mega2560.hex avrdude -cavrispv2 -patmega2560 -P/dev/ttyACM0 -b115200 -U lock:w:0x0F:m Per eseguire il flashing di un'applicazione, utilizzare qualcosa come: avrdude -cwiring -patmega2560 -P/dev/ttyACM0 -b115200 -D -Uflash:w:out/klipper.elf.hex:i Atmega1280 \u00b6 Questo chip si trova in genere nelle prime versioni di \"Arduino Mega\". Per eseguire il flashing del bootloader stesso usa qualcosa come: wget 'https://github.com/arduino/Arduino/raw/1.8.5/hardware/arduino/avr/bootloaders/atmega/ATmegaBOOT_168_atmega1280.hex' avrdude -cavrispv2 -patmega1280 -P/dev/ttyACM0 -b115200 -e -u -U lock:w:0x3F:m -U efuse:w:0xF5:m -U hfuse:w:0xDA:m -U lfuse:w:0xFF:m avrdude -cavrispv2 -patmega1280 -P/dev/ttyACM0 -b115200 -U flash:w:ATmegaBOOT_168_atmega1280.hex avrdude -cavrispv2 -patmega1280 -P/dev/ttyACM0 -b115200 -U lock:w:0x0F:m Per eseguire il flashing di un'applicazione, utilizzare qualcosa come: avrdude -carduino -patmega1280 -P/dev/ttyACM0 -b57600 -D -Uflash:w:out/klipper.elf.hex:i Atmega1284p \u00b6 Questo chip si trova comunemente nelle schede per stampanti 3D in stile \"Melzi\". Per eseguire il flashing del bootloader stesso usa qualcosa come: wget 'https://github.com/Lauszus/Sanguino/raw/1.0.2/bootloaders/optiboot/optiboot_atmega1284p.hex' avrdude -cavrispv2 -patmega1284p -P/dev/ttyACM0 -b115200 -e -u -U lock:w:0x3F:m -U efuse:w:0xFD:m -U hfuse:w:0xDE:m -U lfuse:w:0xFF:m avrdude -cavrispv2 -patmega1284p -P/dev/ttyACM0 -b115200 -U flash:w:optiboot_atmega1284p.hex avrdude -cavrispv2 -patmega1284p -P/dev/ttyACM0 -b115200 -U lock:w:0x0F:m Per eseguire il flashing di un'applicazione, utilizzare qualcosa come: avrdude -carduino -patmega1284p -P/dev/ttyACM0 -b115200 -D -Uflash:w:out/klipper.elf.hex:i Si noti che un certo numero di schede in stile \"Melzi\" sono precaricate con un bootloader che utilizza una velocit\u00e0 di trasmissione di 57600 baud. In questo caso, per eseguire il flashing di un'applicazione utilizzare invece qualcosa di simile: avrdude -carduino -patmega1284p -P/dev/ttyACM0 -b57600 -D -Uflash:w:out/klipper.elf.hex:i At90usb1286 \u00b6 Questo documento non copre il metodo per eseguire il flashing di un bootloader su At90usb1286 n\u00e9 copre il flashing di applicazioni generali su questo dispositivo. Il dispositivo Teensy++ di pjrc.com viene fornito con un bootloader proprietario. Richiede uno strumento di flashing personalizzato da https://github.com/PaulStoffregen/teensy_loader_cli . Si pu\u00f2 eseguire il flashing di un'applicazione usando qualcosa come: teensy_loader_cli --mcu=at90usb1286 out/klipper.elf.hex -v Atmega168 \u00b6 L'atmega168 ha uno spazio flash limitato. Se si utilizza un bootloader, si consiglia di utilizzare il bootloader Optiboot. Per eseguire il flashing di quel bootloader usa qualcosa come: wget 'https://github.com/arduino/Arduino/raw/1.8.5/hardware/arduino/avr/bootloaders/optiboot/optiboot_atmega168.hex' avrdude -cavrispv2 -patmega168 -P/dev/ttyACM0 -b115200 -e -u -U lock:w:0x3F:m -U efuse:w:0x04:m -U hfuse:w:0xDD:m -U lfuse:w:0xFF:m avrdude -cavrispv2 -patmega168 -P/dev/ttyACM0 -b115200 -U flash:w:optiboot_atmega168.hex avrdude -cavrispv2 -patmega168 -P/dev/ttyACM0 -b115200 -U lock:w:0x0F:m Per eseguire il flashing di un'applicazione tramite il bootloader Optiboot, utilizzare qualcosa come: avrdude -carduino -patmega168 -P/dev/ttyACM0 -b115200 -D -Uflash:w:out/klipper.elf.hex:i Microcontrollori SAM3 (Arduino Due) \u00b6 Non \u00e8 comune utilizzare un bootloader con l'mcu SAM3. Il chip stesso ha una ROM che permette di programmare il flash da porta seriale 3.3V o da USB. Per abilitare la ROM, il pin \"erase\" viene tenuto alto durante un reset, che cancella il contenuto della flash e fa funzionare la ROM. Su un Arduino Due, questa sequenza pu\u00f2 essere realizzata impostando un baud rate di 1200 sulla \"porta usb di programmazione\" (la porta USB pi\u00f9 vicina all'alimentatore). Il codice in https://github.com/shumatech/BOSSA pu\u00f2 essere utilizzato per programmare il SAM3. Si consiglia di utilizzare la versione 1.9 o successiva. Per eseguire il flashing di un'applicazione, utilizzare qualcosa come: bossac -U -p /dev/ttyACM0 -a -e -w out/klipper.bin -v -b bossac -U -p /dev/ttyACM0 -R Microcontrollori SAM4 (Duet Wifi) \u00b6 Non \u00e8 comune utilizzare un bootloader con l'mcu SAM4. Il chip stesso ha una ROM che permette di programmare la memoria flash da porta seriale 3.3V o da USB. Per abilitare la ROM, il pin \"erase\" viene tenuto alto durante un reset, che cancella il contenuto della memoria flash e fa funzionare la ROM. Il codice in https://github.com/shumatech/BOSSA pu\u00f2 essere utilizzato per programmare il SAM4. \u00c8 necessario utilizzare la versione 1.8.0 o successiva. Per eseguire il flashing di un'applicazione, utilizzare qualcosa come: bossac --port=/dev/ttyACM0 -b -U -e -w -v -R out/klipper.bin Microcontrollori SAMD21 (Arduino Zero) \u00b6 Il bootloader SAMD21 viene caricato in memoria flashing tramite l'interfaccia ARM Serial Wire Debug (SWD). Questo viene fatto comunemente con un dongle hardware SWD dedicato. In alternativa, \u00e8 possibile utilizzare un Raspberry Pi con OpenOCD . Per eseguire il flashing di un bootloader con OpenOCD, utilizzare la seguente configurazione del chip: source [find target/at91samdXX.cfg] Ottieni un bootloader, ad esempio: wget 'https://github.com/arduino/ArduinoCore-samd/raw/1.8.3/bootloaders/zero/samd21_sam_ba.bin' Carica la memoria Flash con comandi OpenOCD simili a: at91samd bootloader 0 program samd21_sam_ba.bin verify Il bootloader pi\u00f9 comune sul SAMD21 \u00e8 quello che si trova sull' \"Arduino Zero\". Utilizza un bootloader da 8KiB (l'applicazione deve essere compilata con un indirizzo iniziale di 8KiB). Si pu\u00f2 entrare in questo bootloader facendo doppio clic sul pulsante di ripristino. Per eseguire il flashing di un'applicazione, utilizzare qualcosa come: bossac -U -p /dev/ttyACM0 --offset=0x2000 -w out/klipper.bin -v -b -R Al contrario, \"Arduino M0\" utilizza un bootloader da 16 KiB (l'applicazione deve essere compilata con un indirizzo iniziale di 16 KiB). Per eseguire il flashing di un'applicazione su questo bootloader, ripristinare il microcontrollore ed eseguire il comando flash entro i primi secondi dall'avvio, qualcosa del tipo: avrdude -c stk500v2 -p atmega2560 -P /dev/ttyACM0 -u -Uflash:w:out/klipper.elf.hex:i Microcontrollori SAMD51 (Adafruit Metro-M4 e simili) \u00b6 Come il SAMD21, il bootloader SAMD51 viene eseguito il flashing tramite l'interfaccia ARM Serial Wire Debug (SWD). Per eseguire il flashing di un bootloader con OpenOCD su un Raspberry Pi utilizzare la seguente configurazione del chip: source [find target/atsame5x.cfg] Ottieni un bootloader: diversi bootloader sono disponibili da https://github.com/adafruit/uf2-samdx1/releases/latest . Per esempio: wget 'https://github.com/adafruit/uf2-samdx1/releases/download/v3.7.0/bootloader-itsybitsy_m4-v3.7.0.bin' Carica la memoria Flash con comandi OpenOCD simili a: at91samd bootloader 0 program bootloader-itsybitsy_m4-v3.7.0.bin verify at91samd bootloader 16384 Il SAMD51 utilizza un bootloader da 16 KiB (l'applicazione deve essere compilata con un indirizzo iniziale di 16 KiB). Per eseguire il flashing di un'applicazione, utilizzare qualcosa come: bossac -U -p /dev/ttyACM0 --offset=0x4000 -w out/klipper.bin -v -b -R Microcontrollori STM32F103 (dispositivi Blue Pill) \u00b6 I dispositivi STM32F103 dispongono di una ROM che pu\u00f2 eseguire il flashing di un bootloader o di un'applicazione tramite seriale a 3,3 V. In genere si collegano i pin PA10 (MCU Rx) e PA9 (MCU Tx) a un adattatore UART da 3,3 V. Per accedere alla ROM, \u00e8 necessario collegare il pin \"boot 0\" in alto e il pin \"boot 1\" in basso, quindi ripristinare il dispositivo. Il pacchetto \"stm32flash\" pu\u00f2 quindi essere utilizzato per eseguire il flashing del dispositivo utilizzando qualcosa come: stm32flash -w out/klipper.bin -v -g 0 /dev/ttyAMA0 Si noti che se si utilizza un Raspberry Pi per la seriale da 3,3 V, il protocollo stm32flash utilizza una modalit\u00e0 di parit\u00e0 seriale che il \"mini UART\" di Raspberry Pi non supporta. Vedere https://www.raspberrypi.com/documentation/computers/configuration.html#configuring-uarts per i dettagli sull'abilitazione dell'uart completo sui pin GPIO di Raspberry Pi. Dopo aver caricato la memoria flash, imposta \"boot 0\" e \"boot 1\" su basso in modo che in futuro ripristini l'avvio da flash. STM32F103 con bootloader stm32duino \u00b6 Il progetto \"stm32duino\" ha un bootloader compatibile con USB - vedere: https://github.com/rogerclarkmelbourne/STM32duino-bootloader Questo bootloader pu\u00f2 essere flashato tramite seriale 3.3V con qualcosa come: wget 'https://github.com/rogerclarkmelbourne/STM32duino-bootloader/raw/master/binaries/generic_boot20_pc13.bin' stm32flash -w generic_boot20_pc13.bin -v -g 0 /dev/ttyAMA0 Questo bootloader utilizza 8KiB di spazio flash (l'applicazione deve essere compilata con un indirizzo iniziale di 8KiB). Caricare in memoria flash un'applicazione con qualcosa come: dfu-util -d 1eaf:0003 -a 2 -R -D out/klipper.bin Il bootloader in genere viene eseguito solo per un breve periodo dopo l'avvio. Potrebbe essere necessario sincronizzare il comando sopra in modo che venga eseguito mentre il bootloader \u00e8 ancora attivo (il bootloader far\u00e0 lampeggiare un led della scheda mentre \u00e8 in esecuzione). In alternativa, imposta il pin \"boot 0\" su basso e il pin \"boot 1\" su alto per rimanere nel bootloader dopo un ripristino. STM32F103 con bootloader HID \u00b6 Il bootloader HID \u00e8 un bootloader compatto e senza driver in grado di eseguire il flashing attraverso USB. \u00c8 inoltre disponibile un fork con build specifiche per SKR Mini E3 1.2 . Per schede STM32F103 generiche come la blue pill \u00e8 possibile eseguire il flashing del bootloader tramite seriale 3.3v utilizzando stm32flash come indicato nella sezione stm32duino sopra, sostituendo il nome del file con il binario del bootloader desiderato (es: hid_generic_pc13.bin per blue pill ). Non \u00e8 possibile utilizzare stm32flash per SKR Mini E3 poich\u00e9 il pin boot0 \u00e8 collegato direttamente a terra e non disponibile tramite pin header. Si consiglia di utilizzare un STLink V2 con STM32Cubeprogrammer per eseguire il flashing del bootloader. Se non hai accesso a un STLink \u00e8 anche possibile utilizzare un Raspberry Pi e OpenOCD con la seguente configurazione del chip: source [find target/stm32f1x.cfg] Se lo desideri puoi fare un backup della flash corrente con il seguente comando. Tieni presente che il completamento potrebbe richiedere del tempo: flash read_bank 0 btt_skr_mini_e3_backup.bin infine, puoi eseguire il flashing con comandi simili a: stm32f1x mass_erase 0 program hid_btt_skr_mini_e3.bin verify 0x08000000 NOTE: L'esempio sopra cancella il chip, quindi programma il bootloader. Indipendentemente dal metodo scelto per eseguire il flashing, si consiglia di cancellare il chip prima del flashing. Prima di eseguire il flashing di SKR Mini E3 con questo bootloader, dovresti essere consapevole che non sarai pi\u00f9 in grado di aggiornare il firmware tramite la sdcard. You may need to hold down the reset button on the board while launching OpenOCD. It should display something like: Open On-Chip Debugger 0.10.0+dev-01204-gc60252ac-dirty (2020-04-27-16:00) Licensed under GNU GPL v2 For bug reports, read http://openocd.org/doc/doxygen/bugs.html DEPRECATED! use 'adapter speed' not 'adapter_khz' Info : BCM2835 GPIO JTAG/SWD bitbang driver Info : JTAG and SWD modes enabled Info : clock speed 40 kHz Info : SWD DPIDR 0x1ba01477 Info : stm32f1x.cpu: hardware has 6 breakpoints, 4 watchpoints Info : stm32f1x.cpu: external reset detected Info : starting gdb server for stm32f1x.cpu on 3333 Info : Listening on port 3333 for gdb connections Dopodich\u00e9 puoi rilasciare il pulsante di reset. Questo bootloader richiede 2KiB di spazio flash (l'applicazione deve essere compilata con un indirizzo iniziale di 2KiB). Il programma hid-flash viene utilizzato per caricare un file binario sul bootloader. \u00c8 possibile installare questo software con i seguenti comandi: sudo apt install libusb-1.0 cd ~/klipper/lib/hidflash make Se il bootloader \u00e8 in esecuzione, puoi eseguire il flash con qualcosa del tipo: ~/klipper/lib/hidflash/hid-flash ~/klipper/out/klipper.bin in alternativa, puoi usare make flash per flashare klipper direttamente: make flash FLASH_DEVICE=1209:BEBA O se klipper \u00e8 stato precedentemente flashato: make flash FLASH_DEVICE=/dev/ttyACM0 Potrebbe essere necessario inserire manualmente il bootloader, questo pu\u00f2 essere fatto impostando \"boot 0\" basso e \"boot 1\" alto. Su SKR Mini E3 \"Boot 1\" non \u00e8 disponibile, quindi pu\u00f2 essere fatto impostando il pin PA2 basso se hai flashato \"hid_btt_skr_mini_e3.bin\". Questo pin \u00e8 etichettato \"TX0\" sull'intestazione TFT nel documento \"PIN\" di SKR Mini E3. C'\u00e8 un pin di massa accanto a PA2 che puoi usare per abbassare PA2. STM32F103/STM32F072 con bootloader MSC \u00b6 Il bootloader MSC \u00e8 un bootloader senza driver in grado di eseguire il flashing su USB. \u00c8 possibile eseguire il flashing del bootloader tramite seriale 3.3v usando stm32flash come indicato nella sezione stm32duino sopra, sostituendo il nome del file con il file binario del bootloader MSC desiderato (es: MSCboot-Bluepill.bin per la Blue pill). Per le schede STM32F072 \u00e8 anche possibile eseguire il flashing del bootloader su USB (tramite DFU) con qualcosa del tipo: dfu-util -d 0483:df11 -a 0 -R -D MSCboot-STM32F072.bin -s0x08000000:leave Questo bootloader utilizza 8KiB o 16KiB di spazio flash, vedere la descrizione del bootloader (l'applicazione deve essere compilata con l'indirizzo iniziale corrispondente). Il bootloader pu\u00f2 essere attivato premendo due volte il pulsante di reset della scheda. Non appena il bootloader viene attivato, la scheda appare come una chiavetta USB su cui \u00e8 possibile copiare il file klipper.bin. STM32F103/STM32F0x2 con bootloader CanBoot \u00b6 Il bootloader CanBoot fornisce un'opzione per caricare il firmware Klipper su CANBUS. Il bootloader stesso \u00e8 derivato dal codice sorgente di Klipper. Attualmente CanBoot supporta i modelli STM32F103, STM32F042 e STM32F072. Si consiglia di utilizzare un programmatore ST-Link per eseguire il flashing di CanBoot, tuttavia dovrebbe essere possibile eseguire il flashing utilizzando stm32flash sui dispositivi STM32F103 e dfu-util sui dispositivi STM32F042/STM32F072. Vedere le sezioni precedenti di questo documento per istruzioni su questi metodi di flashing, sostituendo canboot.bin per il nome del file ove appropriato. Il link al repository CanBoot collegato sopra fornisce istruzioni per la creazione del bootloader. La prima volta che CanBoot \u00e8 stato flashato, dovrebbe rilevare che non \u00e8 presente alcuna applicazione e accedere al bootloader. Se ci\u00f2 non accade \u00e8 possibile entrare nel bootloader premendo due volte di seguito il pulsante di reset. L'utilit\u00e0 flash_can.py fornita nella cartella lib/canboot pu\u00f2 essere utilizzata per caricare il firmware di Klipper. E' necessario l'UUID del dispositivo per eseguire il flashing. Se non si dispone di un UUID \u00e8 possibile interrogare i nodi che attualmente eseguono il bootloader: python3 flash_can.py -q Ci\u00f2 restituir\u00e0 gli UUID per tutti i nodi collegati non attualmente assegnati a un UUID. Questo dovrebbe includere tutti i nodi attualmente nel bootloader. Una volta che hai un UUID, puoi caricare il firmware con il seguente comando: python3 flash_can.py -i can0 -f ~/klipper/out/klipper.bin -u aabbccddeeff Dove aabbccddeeff \u00e8 sostituito dal tuo UUID. Nota che le opzioni -i e -f possono essere omesse, per impostazione predefinita sono rispettivamente can0 e ~/klipper/out/klipper.bin . Quando crei Klipper per l'uso con CanBoot, seleziona l'opzione Bootloader da 8 KiB. Microcontrollori STM32F4 (SKR Pro 1.1) \u00b6 I microcontrollori STM32F4 sono dotati di un bootloader di sistema integrato in grado di eseguire il flashing su USB (tramite DFU), seriale 3.3v e vari altri metodi (consultare il documento STM AN2606 per ulteriori informazioni). Alcune schede STM32F4, come SKR Pro 1.1, non sono in grado di accedere al bootloader DFU. Il bootloader HID \u00e8 disponibile per schede basate su STM32F405/407 nel caso in cui l'utente preferisca eseguire il flashing su USB anzich\u00e9 utilizzare la scheda SD. Tieni presente che potrebbe essere necessario configurare e creare una versione specifica per la tua scheda, una build per SKR Pro 1.1 \u00e8 disponibile qui . A meno che la tua scheda non sia compatibile con DFU, il metodo di flashing pi\u00f9 accessibile \u00e8 probabilmente tramite seriale 3.3v, che segue la stessa procedura di flash dell'STM32F103 usando stm32flash . Per esempio: wget https://github.com/Arksine/STM32_HID_Bootloader/releases/download/v0.5-beta/hid_bootloader_SKR_PRO.bin stm32flash -w hid_bootloader_SKR_PRO.bin -v -g 0 /dev/ttyAMA0 Questo bootloader richiede 16Kib di spazio flash sull'STM32F4 (l'applicazione deve essere compilata con un indirizzo iniziale di 16KiB). Come con l'STM32F1, l'STM32F4 utilizza lo strumento hid-flash per caricare i file binari nell'MCU. Consulta le istruzioni sopra per i dettagli su come creare e utilizzare hid-flash. Potrebbe essere necessario inserire manualmente il bootloader, questo pu\u00f2 essere fatto impostando \"boot 0\" basso, \"boot 1\" alto e collegando il dispositivo. Al termine della programmazione, scollegare il dispositivo e impostare \"boot 1\" su basso in modo che l'applicazione venga caricata. Microcontrollori LPC176x (Smoothieboards) \u00b6 Questo documento non descrive il metodo per eseguire il flashing di un bootloader stesso - vedere: http://smoothieware.org/flashing-the-bootloader per ulteriori informazioni su questo argomento. \u00c8 comune che per le Smoothieboard venga fornito con un bootloader da: https://github.com/triffid/LPC17xx-DFU-Bootloader . Quando si utilizza questo bootloader, l'applicazione deve essere compilata con un indirizzo iniziale di 16 KiB. Il modo pi\u00f9 semplice per eseguire il flashing di un'applicazione con questo bootloader \u00e8 copiare il file dell'applicazione (ad es. out/klipper.bin ) in un file denominato firmware.bin su una scheda SD, quindi riavviare il microcontrollore con quella scheda SD. Eseguire OpenOCD su Raspberry PI \u00b6 OpenOCD \u00e8 un pacchetto software in grado di eseguire il flashing e il debug di chip di basso livello. Pu\u00f2 utilizzare i pin GPIO su un Raspberry Pi per comunicare con una variet\u00e0 di chip ARM. Questa sezione descrive come installare e avviare OpenOCD. \u00c8 derivato dalle istruzioni su: https://learn.adafruit.com/programming-microcontrollers-using-openocd-on-raspberry-pi Inizia scaricando e compilando il software (ogni passaggio pu\u00f2 richiedere diversi minuti e il passaggio \"make\" pu\u00f2 richiedere pi\u00f9 di 30 minuti): sudo apt-get update sudo apt-get install autoconf libtool telnet mkdir ~/openocd cd ~/openocd/ git clone http://openocd.zylin.com/openocd cd openocd ./bootstrap ./configure --enable-sysfsgpio --enable-bcm2835gpio --prefix=/home/pi/openocd/install make make install Configurare OpenOCD \u00b6 Crea un file di configurazione OpenOCD: nano ~/openocd/openocd.cfg Utilizzare una configurazione simile alla seguente: # Uses RPi pins: GPIO25 for SWDCLK, GPIO24 for SWDIO, GPIO18 for nRST source [find interface/raspberrypi2-native.cfg] bcm2835gpio_swd_nums 25 24 bcm2835gpio_srst_num 18 transport select swd # Use hardware reset wire for chip resets reset_config srst_only adapter_nsrst_delay 100 adapter_nsrst_assert_width 100 # Specify the chip type source [find target/atsame5x.cfg] # Set the adapter speed adapter_khz 40 # Connect to chip init targets reset halt Collega il Raspberry Pi al chip di destinazione \u00b6 Spegni sia il Raspberry Pi che il chip di destinazione prima del cablaggio! Verificare che il chip di destinazione utilizzi 3,3 V prima di connettersi a un Raspberry Pi! Collega GND, SWDCLK, SWDIO e RST sul chip di destinazione rispettivamente a GND, GPIO25, GPIO24 e GPIO18 sul Raspberry Pi. Quindi accendi il Raspberry Pi e fornisci alimentazione al chip di destinazione. Eseguire OpenOCD \u00b6 Esegui OpenOCD: cd ~/openocd/ sudo ~/openocd/install/bin/openocd -f ~/openocd/openocd.cfg Quanto sopra dovrebbe far s\u00ec che OpenOCD emetta alcuni messaggi di testo e quindi attenda (non dovrebbe tornare immediatamente al prompt della shell Unix). Se OpenOCD termina da solo o se continua a emettere messaggi di testo, ricontrolla il cablaggio. Una volta che OpenOCD \u00e8 in esecuzione ed \u00e8 stabile, \u00e8 possibile inviargli comandi tramite telnet. Apri un'altra sessione ssh ed esegui quanto segue: telnet 127.0.0.1 4444 (Si pu\u00f2 uscire da telnet premendo ctrl+] e quindi eseguendo il comando \"quit\".) OpenOCD e gdb \u00b6 \u00c8 possibile utilizzare OpenOCD con gdb per eseguire il debug di Klipper. I seguenti comandi presuppongono che uno stia eseguendo gdb su una macchina di classe desktop. Aggiungi quanto segue al file di configurazione di OpenOCD: bindto 0.0.0.0 gdb_port 44444 Riavvia OpenOCD sul Raspberry Pi e quindi esegui il seguente comando Unix sul computer desktop: cd /path/to/klipper/ gdb out/klipper.elf All'interno di gdb esegui: target remote octopi:44444 (Sostituisci \"octopi\" con il nome host del Raspberry Pi.) Una volta che gdb \u00e8 in esecuzione, \u00e8 possibile impostare punti di interruzione e ispezionare i registri.","title":"Bootloader"},{"location":"Bootloaders.html#bootloader","text":"Questo documento fornisce informazioni sui bootloader comuni scoperti sui microcontrollori che sono supportati da Klipper. Il bootloader \u00e8 un software di terze parti che viene eseguito sul microcontrollore quando viene acceso per la prima volta. Viene generalmente utilizzato per eseguire il flashing di una nuova applicazione (ad es. Klipper) sul microcontrollore senza richiedere hardware specializzato. Sfortunatamente, non esiste uno standard a livello di settore per il flashing di un microcontrollore, n\u00e9 esiste un bootloader standard che funzioni su tutti i microcontrollori. Peggio ancora, \u00e8 comune che ogni bootloader richieda una serie di passaggi diversa per eseguire il flashing di un'applicazione. Se si pu\u00f2 eseguire il flashing di un bootloader su un microcontrollore, generalmente si pu\u00f2 anche utilizzare quel meccanismo per eseguire il flashing di un'applicazione, ma \u00e8 necessario prestare attenzione quando si esegue questa operazione poich\u00e9 si potrebbe rimuovere inavvertitamente il bootloader. Al contrario, un bootloader generalmente consentir\u00e0 solo a un utente di eseguire il flashing di un'applicazione. Si consiglia pertanto di utilizzare un bootloader per eseguire il flashing di un'applicazione, ove possibile. Questo documento tenta di descrivere i bootloader comuni, i passaggi necessari per eseguire il flashing di un bootloader e i passaggi necessari per eseguire il flashing di un'applicazione. Questo documento non \u00e8 un riferimento autorevole; \u00e8 inteso come una raccolta di informazioni utili che gli sviluppatori di Klipper hanno accumulato.","title":"Bootloader"},{"location":"Bootloaders.html#microcontrollori-avr","text":"In generale, il progetto Arduino \u00e8 un buon riferimento per bootloader e procedure di flashing sui microcontrollori Atmel Atmega a 8 bit. In particolare, il file \"boards.txt\": https://github.com/arduino/Arduino/blob/1.8.5/hardware/arduino/avr/boards.txt \u00e8 un utile riferimento. Per eseguire il flashing di un bootloader, i chip AVR richiedono uno strumento di flashing hardware esterno (che comunica con il chip tramite SPI). Questo strumento pu\u00f2 essere acquistato (ad esempio, eseguire una ricerca sul Web per \"avr isp\", \"arduino isp\" o \"usb tiny isp\"). \u00c8 anche possibile utilizzare un altro Arduino o Raspberry Pi per eseguire il flashing di un bootloader AVR (ad esempio, eseguire una ricerca sul Web per \"programmare un avr utilizzando raspberry pi\"). Gli esempi seguenti sono scritti presupponendo che sia in uso un dispositivo di tipo \"AVR ISP Mk2\". Il programma \"avrdude\" \u00e8 lo strumento pi\u00f9 comune utilizzato per eseguire il flashing dei chip atmega (sia flash del bootloader che flash dell'applicazione).","title":"Microcontrollori AVR"},{"location":"Bootloaders.html#atmega2560","text":"Questo chip si trova in genere nell'\"Arduino Mega\" ed \u00e8 molto comune nelle schede per stampanti 3D. Per eseguire il flashing del bootloader stesso usa qualcosa come: wget 'https://github.com/arduino/Arduino/raw/1.8.5/hardware/arduino/avr/bootloaders/stk500v2/stk500boot_v2_mega2560.hex' avrdude -cavrispv2 -patmega2560 -P/dev/ttyACM0 -b115200 -e -u -U lock:w:0x3F:m -U efuse:w:0xFD:m -U hfuse:w:0xD8:m -U lfuse:w:0xFF:m avrdude -cavrispv2 -patmega2560 -P/dev/ttyACM0 -b115200 -U flash:w:stk500boot_v2_mega2560.hex avrdude -cavrispv2 -patmega2560 -P/dev/ttyACM0 -b115200 -U lock:w:0x0F:m Per eseguire il flashing di un'applicazione, utilizzare qualcosa come: avrdude -cwiring -patmega2560 -P/dev/ttyACM0 -b115200 -D -Uflash:w:out/klipper.elf.hex:i","title":"Atmega2560"},{"location":"Bootloaders.html#atmega1280","text":"Questo chip si trova in genere nelle prime versioni di \"Arduino Mega\". Per eseguire il flashing del bootloader stesso usa qualcosa come: wget 'https://github.com/arduino/Arduino/raw/1.8.5/hardware/arduino/avr/bootloaders/atmega/ATmegaBOOT_168_atmega1280.hex' avrdude -cavrispv2 -patmega1280 -P/dev/ttyACM0 -b115200 -e -u -U lock:w:0x3F:m -U efuse:w:0xF5:m -U hfuse:w:0xDA:m -U lfuse:w:0xFF:m avrdude -cavrispv2 -patmega1280 -P/dev/ttyACM0 -b115200 -U flash:w:ATmegaBOOT_168_atmega1280.hex avrdude -cavrispv2 -patmega1280 -P/dev/ttyACM0 -b115200 -U lock:w:0x0F:m Per eseguire il flashing di un'applicazione, utilizzare qualcosa come: avrdude -carduino -patmega1280 -P/dev/ttyACM0 -b57600 -D -Uflash:w:out/klipper.elf.hex:i","title":"Atmega1280"},{"location":"Bootloaders.html#atmega1284p","text":"Questo chip si trova comunemente nelle schede per stampanti 3D in stile \"Melzi\". Per eseguire il flashing del bootloader stesso usa qualcosa come: wget 'https://github.com/Lauszus/Sanguino/raw/1.0.2/bootloaders/optiboot/optiboot_atmega1284p.hex' avrdude -cavrispv2 -patmega1284p -P/dev/ttyACM0 -b115200 -e -u -U lock:w:0x3F:m -U efuse:w:0xFD:m -U hfuse:w:0xDE:m -U lfuse:w:0xFF:m avrdude -cavrispv2 -patmega1284p -P/dev/ttyACM0 -b115200 -U flash:w:optiboot_atmega1284p.hex avrdude -cavrispv2 -patmega1284p -P/dev/ttyACM0 -b115200 -U lock:w:0x0F:m Per eseguire il flashing di un'applicazione, utilizzare qualcosa come: avrdude -carduino -patmega1284p -P/dev/ttyACM0 -b115200 -D -Uflash:w:out/klipper.elf.hex:i Si noti che un certo numero di schede in stile \"Melzi\" sono precaricate con un bootloader che utilizza una velocit\u00e0 di trasmissione di 57600 baud. In questo caso, per eseguire il flashing di un'applicazione utilizzare invece qualcosa di simile: avrdude -carduino -patmega1284p -P/dev/ttyACM0 -b57600 -D -Uflash:w:out/klipper.elf.hex:i","title":"Atmega1284p"},{"location":"Bootloaders.html#at90usb1286","text":"Questo documento non copre il metodo per eseguire il flashing di un bootloader su At90usb1286 n\u00e9 copre il flashing di applicazioni generali su questo dispositivo. Il dispositivo Teensy++ di pjrc.com viene fornito con un bootloader proprietario. Richiede uno strumento di flashing personalizzato da https://github.com/PaulStoffregen/teensy_loader_cli . Si pu\u00f2 eseguire il flashing di un'applicazione usando qualcosa come: teensy_loader_cli --mcu=at90usb1286 out/klipper.elf.hex -v","title":"At90usb1286"},{"location":"Bootloaders.html#atmega168","text":"L'atmega168 ha uno spazio flash limitato. Se si utilizza un bootloader, si consiglia di utilizzare il bootloader Optiboot. Per eseguire il flashing di quel bootloader usa qualcosa come: wget 'https://github.com/arduino/Arduino/raw/1.8.5/hardware/arduino/avr/bootloaders/optiboot/optiboot_atmega168.hex' avrdude -cavrispv2 -patmega168 -P/dev/ttyACM0 -b115200 -e -u -U lock:w:0x3F:m -U efuse:w:0x04:m -U hfuse:w:0xDD:m -U lfuse:w:0xFF:m avrdude -cavrispv2 -patmega168 -P/dev/ttyACM0 -b115200 -U flash:w:optiboot_atmega168.hex avrdude -cavrispv2 -patmega168 -P/dev/ttyACM0 -b115200 -U lock:w:0x0F:m Per eseguire il flashing di un'applicazione tramite il bootloader Optiboot, utilizzare qualcosa come: avrdude -carduino -patmega168 -P/dev/ttyACM0 -b115200 -D -Uflash:w:out/klipper.elf.hex:i","title":"Atmega168"},{"location":"Bootloaders.html#microcontrollori-sam3-arduino-due","text":"Non \u00e8 comune utilizzare un bootloader con l'mcu SAM3. Il chip stesso ha una ROM che permette di programmare il flash da porta seriale 3.3V o da USB. Per abilitare la ROM, il pin \"erase\" viene tenuto alto durante un reset, che cancella il contenuto della flash e fa funzionare la ROM. Su un Arduino Due, questa sequenza pu\u00f2 essere realizzata impostando un baud rate di 1200 sulla \"porta usb di programmazione\" (la porta USB pi\u00f9 vicina all'alimentatore). Il codice in https://github.com/shumatech/BOSSA pu\u00f2 essere utilizzato per programmare il SAM3. Si consiglia di utilizzare la versione 1.9 o successiva. Per eseguire il flashing di un'applicazione, utilizzare qualcosa come: bossac -U -p /dev/ttyACM0 -a -e -w out/klipper.bin -v -b bossac -U -p /dev/ttyACM0 -R","title":"Microcontrollori SAM3 (Arduino Due)"},{"location":"Bootloaders.html#microcontrollori-sam4-duet-wifi","text":"Non \u00e8 comune utilizzare un bootloader con l'mcu SAM4. Il chip stesso ha una ROM che permette di programmare la memoria flash da porta seriale 3.3V o da USB. Per abilitare la ROM, il pin \"erase\" viene tenuto alto durante un reset, che cancella il contenuto della memoria flash e fa funzionare la ROM. Il codice in https://github.com/shumatech/BOSSA pu\u00f2 essere utilizzato per programmare il SAM4. \u00c8 necessario utilizzare la versione 1.8.0 o successiva. Per eseguire il flashing di un'applicazione, utilizzare qualcosa come: bossac --port=/dev/ttyACM0 -b -U -e -w -v -R out/klipper.bin","title":"Microcontrollori SAM4 (Duet Wifi)"},{"location":"Bootloaders.html#microcontrollori-samd21-arduino-zero","text":"Il bootloader SAMD21 viene caricato in memoria flashing tramite l'interfaccia ARM Serial Wire Debug (SWD). Questo viene fatto comunemente con un dongle hardware SWD dedicato. In alternativa, \u00e8 possibile utilizzare un Raspberry Pi con OpenOCD . Per eseguire il flashing di un bootloader con OpenOCD, utilizzare la seguente configurazione del chip: source [find target/at91samdXX.cfg] Ottieni un bootloader, ad esempio: wget 'https://github.com/arduino/ArduinoCore-samd/raw/1.8.3/bootloaders/zero/samd21_sam_ba.bin' Carica la memoria Flash con comandi OpenOCD simili a: at91samd bootloader 0 program samd21_sam_ba.bin verify Il bootloader pi\u00f9 comune sul SAMD21 \u00e8 quello che si trova sull' \"Arduino Zero\". Utilizza un bootloader da 8KiB (l'applicazione deve essere compilata con un indirizzo iniziale di 8KiB). Si pu\u00f2 entrare in questo bootloader facendo doppio clic sul pulsante di ripristino. Per eseguire il flashing di un'applicazione, utilizzare qualcosa come: bossac -U -p /dev/ttyACM0 --offset=0x2000 -w out/klipper.bin -v -b -R Al contrario, \"Arduino M0\" utilizza un bootloader da 16 KiB (l'applicazione deve essere compilata con un indirizzo iniziale di 16 KiB). Per eseguire il flashing di un'applicazione su questo bootloader, ripristinare il microcontrollore ed eseguire il comando flash entro i primi secondi dall'avvio, qualcosa del tipo: avrdude -c stk500v2 -p atmega2560 -P /dev/ttyACM0 -u -Uflash:w:out/klipper.elf.hex:i","title":"Microcontrollori SAMD21 (Arduino Zero)"},{"location":"Bootloaders.html#microcontrollori-samd51-adafruit-metro-m4-e-simili","text":"Come il SAMD21, il bootloader SAMD51 viene eseguito il flashing tramite l'interfaccia ARM Serial Wire Debug (SWD). Per eseguire il flashing di un bootloader con OpenOCD su un Raspberry Pi utilizzare la seguente configurazione del chip: source [find target/atsame5x.cfg] Ottieni un bootloader: diversi bootloader sono disponibili da https://github.com/adafruit/uf2-samdx1/releases/latest . Per esempio: wget 'https://github.com/adafruit/uf2-samdx1/releases/download/v3.7.0/bootloader-itsybitsy_m4-v3.7.0.bin' Carica la memoria Flash con comandi OpenOCD simili a: at91samd bootloader 0 program bootloader-itsybitsy_m4-v3.7.0.bin verify at91samd bootloader 16384 Il SAMD51 utilizza un bootloader da 16 KiB (l'applicazione deve essere compilata con un indirizzo iniziale di 16 KiB). Per eseguire il flashing di un'applicazione, utilizzare qualcosa come: bossac -U -p /dev/ttyACM0 --offset=0x4000 -w out/klipper.bin -v -b -R","title":"Microcontrollori SAMD51 (Adafruit Metro-M4 e simili)"},{"location":"Bootloaders.html#microcontrollori-stm32f103-dispositivi-blue-pill","text":"I dispositivi STM32F103 dispongono di una ROM che pu\u00f2 eseguire il flashing di un bootloader o di un'applicazione tramite seriale a 3,3 V. In genere si collegano i pin PA10 (MCU Rx) e PA9 (MCU Tx) a un adattatore UART da 3,3 V. Per accedere alla ROM, \u00e8 necessario collegare il pin \"boot 0\" in alto e il pin \"boot 1\" in basso, quindi ripristinare il dispositivo. Il pacchetto \"stm32flash\" pu\u00f2 quindi essere utilizzato per eseguire il flashing del dispositivo utilizzando qualcosa come: stm32flash -w out/klipper.bin -v -g 0 /dev/ttyAMA0 Si noti che se si utilizza un Raspberry Pi per la seriale da 3,3 V, il protocollo stm32flash utilizza una modalit\u00e0 di parit\u00e0 seriale che il \"mini UART\" di Raspberry Pi non supporta. Vedere https://www.raspberrypi.com/documentation/computers/configuration.html#configuring-uarts per i dettagli sull'abilitazione dell'uart completo sui pin GPIO di Raspberry Pi. Dopo aver caricato la memoria flash, imposta \"boot 0\" e \"boot 1\" su basso in modo che in futuro ripristini l'avvio da flash.","title":"Microcontrollori STM32F103 (dispositivi Blue Pill)"},{"location":"Bootloaders.html#stm32f103-con-bootloader-stm32duino","text":"Il progetto \"stm32duino\" ha un bootloader compatibile con USB - vedere: https://github.com/rogerclarkmelbourne/STM32duino-bootloader Questo bootloader pu\u00f2 essere flashato tramite seriale 3.3V con qualcosa come: wget 'https://github.com/rogerclarkmelbourne/STM32duino-bootloader/raw/master/binaries/generic_boot20_pc13.bin' stm32flash -w generic_boot20_pc13.bin -v -g 0 /dev/ttyAMA0 Questo bootloader utilizza 8KiB di spazio flash (l'applicazione deve essere compilata con un indirizzo iniziale di 8KiB). Caricare in memoria flash un'applicazione con qualcosa come: dfu-util -d 1eaf:0003 -a 2 -R -D out/klipper.bin Il bootloader in genere viene eseguito solo per un breve periodo dopo l'avvio. Potrebbe essere necessario sincronizzare il comando sopra in modo che venga eseguito mentre il bootloader \u00e8 ancora attivo (il bootloader far\u00e0 lampeggiare un led della scheda mentre \u00e8 in esecuzione). In alternativa, imposta il pin \"boot 0\" su basso e il pin \"boot 1\" su alto per rimanere nel bootloader dopo un ripristino.","title":"STM32F103 con bootloader stm32duino"},{"location":"Bootloaders.html#stm32f103-con-bootloader-hid","text":"Il bootloader HID \u00e8 un bootloader compatto e senza driver in grado di eseguire il flashing attraverso USB. \u00c8 inoltre disponibile un fork con build specifiche per SKR Mini E3 1.2 . Per schede STM32F103 generiche come la blue pill \u00e8 possibile eseguire il flashing del bootloader tramite seriale 3.3v utilizzando stm32flash come indicato nella sezione stm32duino sopra, sostituendo il nome del file con il binario del bootloader desiderato (es: hid_generic_pc13.bin per blue pill ). Non \u00e8 possibile utilizzare stm32flash per SKR Mini E3 poich\u00e9 il pin boot0 \u00e8 collegato direttamente a terra e non disponibile tramite pin header. Si consiglia di utilizzare un STLink V2 con STM32Cubeprogrammer per eseguire il flashing del bootloader. Se non hai accesso a un STLink \u00e8 anche possibile utilizzare un Raspberry Pi e OpenOCD con la seguente configurazione del chip: source [find target/stm32f1x.cfg] Se lo desideri puoi fare un backup della flash corrente con il seguente comando. Tieni presente che il completamento potrebbe richiedere del tempo: flash read_bank 0 btt_skr_mini_e3_backup.bin infine, puoi eseguire il flashing con comandi simili a: stm32f1x mass_erase 0 program hid_btt_skr_mini_e3.bin verify 0x08000000 NOTE: L'esempio sopra cancella il chip, quindi programma il bootloader. Indipendentemente dal metodo scelto per eseguire il flashing, si consiglia di cancellare il chip prima del flashing. Prima di eseguire il flashing di SKR Mini E3 con questo bootloader, dovresti essere consapevole che non sarai pi\u00f9 in grado di aggiornare il firmware tramite la sdcard. You may need to hold down the reset button on the board while launching OpenOCD. It should display something like: Open On-Chip Debugger 0.10.0+dev-01204-gc60252ac-dirty (2020-04-27-16:00) Licensed under GNU GPL v2 For bug reports, read http://openocd.org/doc/doxygen/bugs.html DEPRECATED! use 'adapter speed' not 'adapter_khz' Info : BCM2835 GPIO JTAG/SWD bitbang driver Info : JTAG and SWD modes enabled Info : clock speed 40 kHz Info : SWD DPIDR 0x1ba01477 Info : stm32f1x.cpu: hardware has 6 breakpoints, 4 watchpoints Info : stm32f1x.cpu: external reset detected Info : starting gdb server for stm32f1x.cpu on 3333 Info : Listening on port 3333 for gdb connections Dopodich\u00e9 puoi rilasciare il pulsante di reset. Questo bootloader richiede 2KiB di spazio flash (l'applicazione deve essere compilata con un indirizzo iniziale di 2KiB). Il programma hid-flash viene utilizzato per caricare un file binario sul bootloader. \u00c8 possibile installare questo software con i seguenti comandi: sudo apt install libusb-1.0 cd ~/klipper/lib/hidflash make Se il bootloader \u00e8 in esecuzione, puoi eseguire il flash con qualcosa del tipo: ~/klipper/lib/hidflash/hid-flash ~/klipper/out/klipper.bin in alternativa, puoi usare make flash per flashare klipper direttamente: make flash FLASH_DEVICE=1209:BEBA O se klipper \u00e8 stato precedentemente flashato: make flash FLASH_DEVICE=/dev/ttyACM0 Potrebbe essere necessario inserire manualmente il bootloader, questo pu\u00f2 essere fatto impostando \"boot 0\" basso e \"boot 1\" alto. Su SKR Mini E3 \"Boot 1\" non \u00e8 disponibile, quindi pu\u00f2 essere fatto impostando il pin PA2 basso se hai flashato \"hid_btt_skr_mini_e3.bin\". Questo pin \u00e8 etichettato \"TX0\" sull'intestazione TFT nel documento \"PIN\" di SKR Mini E3. C'\u00e8 un pin di massa accanto a PA2 che puoi usare per abbassare PA2.","title":"STM32F103 con bootloader HID"},{"location":"Bootloaders.html#stm32f103stm32f072-con-bootloader-msc","text":"Il bootloader MSC \u00e8 un bootloader senza driver in grado di eseguire il flashing su USB. \u00c8 possibile eseguire il flashing del bootloader tramite seriale 3.3v usando stm32flash come indicato nella sezione stm32duino sopra, sostituendo il nome del file con il file binario del bootloader MSC desiderato (es: MSCboot-Bluepill.bin per la Blue pill). Per le schede STM32F072 \u00e8 anche possibile eseguire il flashing del bootloader su USB (tramite DFU) con qualcosa del tipo: dfu-util -d 0483:df11 -a 0 -R -D MSCboot-STM32F072.bin -s0x08000000:leave Questo bootloader utilizza 8KiB o 16KiB di spazio flash, vedere la descrizione del bootloader (l'applicazione deve essere compilata con l'indirizzo iniziale corrispondente). Il bootloader pu\u00f2 essere attivato premendo due volte il pulsante di reset della scheda. Non appena il bootloader viene attivato, la scheda appare come una chiavetta USB su cui \u00e8 possibile copiare il file klipper.bin.","title":"STM32F103/STM32F072 con bootloader MSC"},{"location":"Bootloaders.html#stm32f103stm32f0x2-con-bootloader-canboot","text":"Il bootloader CanBoot fornisce un'opzione per caricare il firmware Klipper su CANBUS. Il bootloader stesso \u00e8 derivato dal codice sorgente di Klipper. Attualmente CanBoot supporta i modelli STM32F103, STM32F042 e STM32F072. Si consiglia di utilizzare un programmatore ST-Link per eseguire il flashing di CanBoot, tuttavia dovrebbe essere possibile eseguire il flashing utilizzando stm32flash sui dispositivi STM32F103 e dfu-util sui dispositivi STM32F042/STM32F072. Vedere le sezioni precedenti di questo documento per istruzioni su questi metodi di flashing, sostituendo canboot.bin per il nome del file ove appropriato. Il link al repository CanBoot collegato sopra fornisce istruzioni per la creazione del bootloader. La prima volta che CanBoot \u00e8 stato flashato, dovrebbe rilevare che non \u00e8 presente alcuna applicazione e accedere al bootloader. Se ci\u00f2 non accade \u00e8 possibile entrare nel bootloader premendo due volte di seguito il pulsante di reset. L'utilit\u00e0 flash_can.py fornita nella cartella lib/canboot pu\u00f2 essere utilizzata per caricare il firmware di Klipper. E' necessario l'UUID del dispositivo per eseguire il flashing. Se non si dispone di un UUID \u00e8 possibile interrogare i nodi che attualmente eseguono il bootloader: python3 flash_can.py -q Ci\u00f2 restituir\u00e0 gli UUID per tutti i nodi collegati non attualmente assegnati a un UUID. Questo dovrebbe includere tutti i nodi attualmente nel bootloader. Una volta che hai un UUID, puoi caricare il firmware con il seguente comando: python3 flash_can.py -i can0 -f ~/klipper/out/klipper.bin -u aabbccddeeff Dove aabbccddeeff \u00e8 sostituito dal tuo UUID. Nota che le opzioni -i e -f possono essere omesse, per impostazione predefinita sono rispettivamente can0 e ~/klipper/out/klipper.bin . Quando crei Klipper per l'uso con CanBoot, seleziona l'opzione Bootloader da 8 KiB.","title":"STM32F103/STM32F0x2 con bootloader CanBoot"},{"location":"Bootloaders.html#microcontrollori-stm32f4-skr-pro-11","text":"I microcontrollori STM32F4 sono dotati di un bootloader di sistema integrato in grado di eseguire il flashing su USB (tramite DFU), seriale 3.3v e vari altri metodi (consultare il documento STM AN2606 per ulteriori informazioni). Alcune schede STM32F4, come SKR Pro 1.1, non sono in grado di accedere al bootloader DFU. Il bootloader HID \u00e8 disponibile per schede basate su STM32F405/407 nel caso in cui l'utente preferisca eseguire il flashing su USB anzich\u00e9 utilizzare la scheda SD. Tieni presente che potrebbe essere necessario configurare e creare una versione specifica per la tua scheda, una build per SKR Pro 1.1 \u00e8 disponibile qui . A meno che la tua scheda non sia compatibile con DFU, il metodo di flashing pi\u00f9 accessibile \u00e8 probabilmente tramite seriale 3.3v, che segue la stessa procedura di flash dell'STM32F103 usando stm32flash . Per esempio: wget https://github.com/Arksine/STM32_HID_Bootloader/releases/download/v0.5-beta/hid_bootloader_SKR_PRO.bin stm32flash -w hid_bootloader_SKR_PRO.bin -v -g 0 /dev/ttyAMA0 Questo bootloader richiede 16Kib di spazio flash sull'STM32F4 (l'applicazione deve essere compilata con un indirizzo iniziale di 16KiB). Come con l'STM32F1, l'STM32F4 utilizza lo strumento hid-flash per caricare i file binari nell'MCU. Consulta le istruzioni sopra per i dettagli su come creare e utilizzare hid-flash. Potrebbe essere necessario inserire manualmente il bootloader, questo pu\u00f2 essere fatto impostando \"boot 0\" basso, \"boot 1\" alto e collegando il dispositivo. Al termine della programmazione, scollegare il dispositivo e impostare \"boot 1\" su basso in modo che l'applicazione venga caricata.","title":"Microcontrollori STM32F4 (SKR Pro 1.1)"},{"location":"Bootloaders.html#microcontrollori-lpc176x-smoothieboards","text":"Questo documento non descrive il metodo per eseguire il flashing di un bootloader stesso - vedere: http://smoothieware.org/flashing-the-bootloader per ulteriori informazioni su questo argomento. \u00c8 comune che per le Smoothieboard venga fornito con un bootloader da: https://github.com/triffid/LPC17xx-DFU-Bootloader . Quando si utilizza questo bootloader, l'applicazione deve essere compilata con un indirizzo iniziale di 16 KiB. Il modo pi\u00f9 semplice per eseguire il flashing di un'applicazione con questo bootloader \u00e8 copiare il file dell'applicazione (ad es. out/klipper.bin ) in un file denominato firmware.bin su una scheda SD, quindi riavviare il microcontrollore con quella scheda SD.","title":"Microcontrollori LPC176x (Smoothieboards)"},{"location":"Bootloaders.html#eseguire-openocd-su-raspberry-pi","text":"OpenOCD \u00e8 un pacchetto software in grado di eseguire il flashing e il debug di chip di basso livello. Pu\u00f2 utilizzare i pin GPIO su un Raspberry Pi per comunicare con una variet\u00e0 di chip ARM. Questa sezione descrive come installare e avviare OpenOCD. \u00c8 derivato dalle istruzioni su: https://learn.adafruit.com/programming-microcontrollers-using-openocd-on-raspberry-pi Inizia scaricando e compilando il software (ogni passaggio pu\u00f2 richiedere diversi minuti e il passaggio \"make\" pu\u00f2 richiedere pi\u00f9 di 30 minuti): sudo apt-get update sudo apt-get install autoconf libtool telnet mkdir ~/openocd cd ~/openocd/ git clone http://openocd.zylin.com/openocd cd openocd ./bootstrap ./configure --enable-sysfsgpio --enable-bcm2835gpio --prefix=/home/pi/openocd/install make make install","title":"Eseguire OpenOCD su Raspberry PI"},{"location":"Bootloaders.html#configurare-openocd","text":"Crea un file di configurazione OpenOCD: nano ~/openocd/openocd.cfg Utilizzare una configurazione simile alla seguente: # Uses RPi pins: GPIO25 for SWDCLK, GPIO24 for SWDIO, GPIO18 for nRST source [find interface/raspberrypi2-native.cfg] bcm2835gpio_swd_nums 25 24 bcm2835gpio_srst_num 18 transport select swd # Use hardware reset wire for chip resets reset_config srst_only adapter_nsrst_delay 100 adapter_nsrst_assert_width 100 # Specify the chip type source [find target/atsame5x.cfg] # Set the adapter speed adapter_khz 40 # Connect to chip init targets reset halt","title":"Configurare OpenOCD"},{"location":"Bootloaders.html#collega-il-raspberry-pi-al-chip-di-destinazione","text":"Spegni sia il Raspberry Pi che il chip di destinazione prima del cablaggio! Verificare che il chip di destinazione utilizzi 3,3 V prima di connettersi a un Raspberry Pi! Collega GND, SWDCLK, SWDIO e RST sul chip di destinazione rispettivamente a GND, GPIO25, GPIO24 e GPIO18 sul Raspberry Pi. Quindi accendi il Raspberry Pi e fornisci alimentazione al chip di destinazione.","title":"Collega il Raspberry Pi al chip di destinazione"},{"location":"Bootloaders.html#eseguire-openocd","text":"Esegui OpenOCD: cd ~/openocd/ sudo ~/openocd/install/bin/openocd -f ~/openocd/openocd.cfg Quanto sopra dovrebbe far s\u00ec che OpenOCD emetta alcuni messaggi di testo e quindi attenda (non dovrebbe tornare immediatamente al prompt della shell Unix). Se OpenOCD termina da solo o se continua a emettere messaggi di testo, ricontrolla il cablaggio. Una volta che OpenOCD \u00e8 in esecuzione ed \u00e8 stabile, \u00e8 possibile inviargli comandi tramite telnet. Apri un'altra sessione ssh ed esegui quanto segue: telnet 127.0.0.1 4444 (Si pu\u00f2 uscire da telnet premendo ctrl+] e quindi eseguendo il comando \"quit\".)","title":"Eseguire OpenOCD"},{"location":"Bootloaders.html#openocd-e-gdb","text":"\u00c8 possibile utilizzare OpenOCD con gdb per eseguire il debug di Klipper. I seguenti comandi presuppongono che uno stia eseguendo gdb su una macchina di classe desktop. Aggiungi quanto segue al file di configurazione di OpenOCD: bindto 0.0.0.0 gdb_port 44444 Riavvia OpenOCD sul Raspberry Pi e quindi esegui il seguente comando Unix sul computer desktop: cd /path/to/klipper/ gdb out/klipper.elf All'interno di gdb esegui: target remote octopi:44444 (Sostituisci \"octopi\" con il nome host del Raspberry Pi.) Una volta che gdb \u00e8 in esecuzione, \u00e8 possibile impostare punti di interruzione e ispezionare i registri.","title":"OpenOCD e gdb"},{"location":"CANBUS.html","text":"CANBUS \u00b6 Questo documento descrive il supporto del CAN bus di Klipper. Hardware del dispositivo \u00b6 Klipper attualmente supporta CAN su chip stm32, same5x e rp2040. Inoltre, il chip del microcontrollore deve trovarsi su una scheda dotata di un ricetrasmettitore CAN. Per compilare per CAN, eseguire make menuconfig e selezionare \"CAN bus\" come interfaccia di comunicazione. Infine, compila il codice del microcontrollore e flashalo sulla scheda di destinazione. Hardware Host \u00b6 Per utilizzare un bus CAN, \u00e8 necessario disporre di un adattatore sul host. Attualmente ci sono due opzioni comuni: Usa un Waveshare Raspberry Pi CAN o uno dei suoi tanti cloni. Utilizzare un adattatore CAN USB (ad esempio https://hacker-gadgets.com/product/cantact-usb-can-adapter/ ). Sono disponibili molti adattatori diversi da USB a CAN: quando ne scegli uno, ti consigliamo di verificare che possa eseguire il candlelight firmware . (Sfortunatamente, abbiamo riscontrato che alcuni adattatori USB eseguono firmware difettoso e sono bloccati, quindi verifica prima dell'acquisto.) \u00c8 inoltre necessario configurare il sistema operativo host per utilizzare l'adattatore. Questo viene in genere fatto creando un nuovo file chiamato /etc/network/interfaces.d/can0 con il seguente contenuto: auto can0 iface can0 can static bitrate 500000 up ifconfig $IFACE txqueuelen 128 Nota che il \"Raspberry Pi CAN hat\" richiede anche modifiche a config.txt . Resistori di terminazione \u00b6 Un bus CAN dovrebbe avere due resistori da 120 ohm tra i cavi CANH e CANL. Idealmente, un resistore situato a ciascuna estremit\u00e0 del bus. Si noti che alcuni dispositivi hanno un resistore integrato da 120 ohm (ad esempio, il \"Waveshare Raspberry Pi CAN\" ha un resistore saldato che non pu\u00f2 essere rimosso facilmente). Alcuni dispositivi non includono affatto un resistore. Altri dispositivi hanno un meccanismo per selezionare il resistore (in genere collegando un \"ponticello jumper\"). Assicurati di controllare gli schemi di tutti i dispositivi sul bus CAN per verificare che ci siano due e solo due resistori da 120 Ohm sul bus. Per verificare che i resistori siano corretti, \u00e8 possibile rimuovere l'alimentazione alla stampante e utilizzare un multimetro per controllare la resistenza tra i cavi CNH e CANL: dovrebbe riportare ~60 ohm su un bus CAN cablato correttamente. Trovare canbus_uuid per nuovi microcontrollori \u00b6 A ogni microcontrollore sul bus CAN viene assegnato un ID univoco basato sull'identificatore del chip di fabbrica codificato in ciascun microcontrollore. Per trovare l'ID di ciascun dispositivo del microcontrollore, assicurati che l'hardware sia alimentato e cablato correttamente, quindi esegui: ~/klippy-env/bin/python ~/klipper/scripts/canbus_query.py can0 Se vengono rilevati dispositivi CAN non inizializzati, il comando precedente riporter\u00e0 righe come le seguenti: Found canbus_uuid=11aa22bb33cc, Application: Klipper Ogni dispositivo avr\u00e0 un identificatore univoco. Nell'esempio sopra, 11aa22bb33cc \u00e8 il \"canbus_uuid\" del microcontrollore. Nota che lo strumento canbus_query.py riporter\u00e0 solo i dispositivi non inizializzati - se Klipper (o uno strumento simile) configura il dispositivo, non apparir\u00e0 pi\u00f9 nell'elenco. Configurare Klipper \u00b6 Aggiorna Klipper configurazione mcu per utilizzare il bus CAN per comunicare con il dispositivo, ad esempio: [mcu my_can_mcu] canbus_uuid: 11aa22bb33cc Modalit\u00e0 bridge da USB a CAN bus \u00b6 Alcuni microcontrollori supportano la selezione della modalit\u00e0 \"USB to CAN bus bridge\" durante \"make menuconfig\". Questa modalit\u00e0 pu\u00f2 consentire di utilizzare un microcontrollore sia come \"adattatore bus da USB a CAN\" che come nodo Klipper. Quando Klipper utilizza questa modalit\u00e0, il microcontrollore appare come un \"adattatore bus CAN USB\" sotto Linux. Lo stesso \"Klipper bridge mcu\" apparir\u00e0 come se fosse su questo bus CAN - pu\u00f2 essere identificato tramite canbus_query.py e configurato come altri nodi Klipper del bus CAN. Apparir\u00e0 insieme ad altri dispositivi che sono effettivamente sul bus CAN. Alcune note importanti quando si utilizza questa modalit\u00e0: Il \"bridge mcu\" non \u00e8 effettivamente sul bus CAN. I messaggi in entrata e in uscita non consumano larghezza di banda sul bus CAN. L'mcu non pu\u00f2 essere visto da altri adattatori che potrebbero essere sul bus CAN. \u00c8 necessario configurare l'interfaccia can0 (o simile) in Linux per comunicare con il bus. Tuttavia, Klipper ignora la velocit\u00e0 del bus CAN di Linux e le opzioni di temporizzazione del bus CAN. Attualmente, la frequenza del bus CAN viene specificata durante \"make menuconfig\" e la velocit\u00e0 del bus specificata in Linux viene ignorata. Ogni volta che il \"bridge mcu\" viene ripristinato, Linux disabiliter\u00e0 l'interfaccia can0 corrispondente. Per garantire una corretta gestione dei comandi FIRMWARE_RESTART e RESTART, si consiglia di sostituire auto con allow-hotplug nel file /etc/network/interfaces.d/can0 . Per esempio: allow-hotplug can0 iface can0 can static bitrate 500000 up ifconfig $IFACE txqueuelen 128","title":"CANBUS"},{"location":"CANBUS.html#canbus","text":"Questo documento descrive il supporto del CAN bus di Klipper.","title":"CANBUS"},{"location":"CANBUS.html#hardware-del-dispositivo","text":"Klipper attualmente supporta CAN su chip stm32, same5x e rp2040. Inoltre, il chip del microcontrollore deve trovarsi su una scheda dotata di un ricetrasmettitore CAN. Per compilare per CAN, eseguire make menuconfig e selezionare \"CAN bus\" come interfaccia di comunicazione. Infine, compila il codice del microcontrollore e flashalo sulla scheda di destinazione.","title":"Hardware del dispositivo"},{"location":"CANBUS.html#hardware-host","text":"Per utilizzare un bus CAN, \u00e8 necessario disporre di un adattatore sul host. Attualmente ci sono due opzioni comuni: Usa un Waveshare Raspberry Pi CAN o uno dei suoi tanti cloni. Utilizzare un adattatore CAN USB (ad esempio https://hacker-gadgets.com/product/cantact-usb-can-adapter/ ). Sono disponibili molti adattatori diversi da USB a CAN: quando ne scegli uno, ti consigliamo di verificare che possa eseguire il candlelight firmware . (Sfortunatamente, abbiamo riscontrato che alcuni adattatori USB eseguono firmware difettoso e sono bloccati, quindi verifica prima dell'acquisto.) \u00c8 inoltre necessario configurare il sistema operativo host per utilizzare l'adattatore. Questo viene in genere fatto creando un nuovo file chiamato /etc/network/interfaces.d/can0 con il seguente contenuto: auto can0 iface can0 can static bitrate 500000 up ifconfig $IFACE txqueuelen 128 Nota che il \"Raspberry Pi CAN hat\" richiede anche modifiche a config.txt .","title":"Hardware Host"},{"location":"CANBUS.html#resistori-di-terminazione","text":"Un bus CAN dovrebbe avere due resistori da 120 ohm tra i cavi CANH e CANL. Idealmente, un resistore situato a ciascuna estremit\u00e0 del bus. Si noti che alcuni dispositivi hanno un resistore integrato da 120 ohm (ad esempio, il \"Waveshare Raspberry Pi CAN\" ha un resistore saldato che non pu\u00f2 essere rimosso facilmente). Alcuni dispositivi non includono affatto un resistore. Altri dispositivi hanno un meccanismo per selezionare il resistore (in genere collegando un \"ponticello jumper\"). Assicurati di controllare gli schemi di tutti i dispositivi sul bus CAN per verificare che ci siano due e solo due resistori da 120 Ohm sul bus. Per verificare che i resistori siano corretti, \u00e8 possibile rimuovere l'alimentazione alla stampante e utilizzare un multimetro per controllare la resistenza tra i cavi CNH e CANL: dovrebbe riportare ~60 ohm su un bus CAN cablato correttamente.","title":"Resistori di terminazione"},{"location":"CANBUS.html#trovare-canbus_uuid-per-nuovi-microcontrollori","text":"A ogni microcontrollore sul bus CAN viene assegnato un ID univoco basato sull'identificatore del chip di fabbrica codificato in ciascun microcontrollore. Per trovare l'ID di ciascun dispositivo del microcontrollore, assicurati che l'hardware sia alimentato e cablato correttamente, quindi esegui: ~/klippy-env/bin/python ~/klipper/scripts/canbus_query.py can0 Se vengono rilevati dispositivi CAN non inizializzati, il comando precedente riporter\u00e0 righe come le seguenti: Found canbus_uuid=11aa22bb33cc, Application: Klipper Ogni dispositivo avr\u00e0 un identificatore univoco. Nell'esempio sopra, 11aa22bb33cc \u00e8 il \"canbus_uuid\" del microcontrollore. Nota che lo strumento canbus_query.py riporter\u00e0 solo i dispositivi non inizializzati - se Klipper (o uno strumento simile) configura il dispositivo, non apparir\u00e0 pi\u00f9 nell'elenco.","title":"Trovare canbus_uuid per nuovi microcontrollori"},{"location":"CANBUS.html#configurare-klipper","text":"Aggiorna Klipper configurazione mcu per utilizzare il bus CAN per comunicare con il dispositivo, ad esempio: [mcu my_can_mcu] canbus_uuid: 11aa22bb33cc","title":"Configurare Klipper"},{"location":"CANBUS.html#modalita-bridge-da-usb-a-can-bus","text":"Alcuni microcontrollori supportano la selezione della modalit\u00e0 \"USB to CAN bus bridge\" durante \"make menuconfig\". Questa modalit\u00e0 pu\u00f2 consentire di utilizzare un microcontrollore sia come \"adattatore bus da USB a CAN\" che come nodo Klipper. Quando Klipper utilizza questa modalit\u00e0, il microcontrollore appare come un \"adattatore bus CAN USB\" sotto Linux. Lo stesso \"Klipper bridge mcu\" apparir\u00e0 come se fosse su questo bus CAN - pu\u00f2 essere identificato tramite canbus_query.py e configurato come altri nodi Klipper del bus CAN. Apparir\u00e0 insieme ad altri dispositivi che sono effettivamente sul bus CAN. Alcune note importanti quando si utilizza questa modalit\u00e0: Il \"bridge mcu\" non \u00e8 effettivamente sul bus CAN. I messaggi in entrata e in uscita non consumano larghezza di banda sul bus CAN. L'mcu non pu\u00f2 essere visto da altri adattatori che potrebbero essere sul bus CAN. \u00c8 necessario configurare l'interfaccia can0 (o simile) in Linux per comunicare con il bus. Tuttavia, Klipper ignora la velocit\u00e0 del bus CAN di Linux e le opzioni di temporizzazione del bus CAN. Attualmente, la frequenza del bus CAN viene specificata durante \"make menuconfig\" e la velocit\u00e0 del bus specificata in Linux viene ignorata. Ogni volta che il \"bridge mcu\" viene ripristinato, Linux disabiliter\u00e0 l'interfaccia can0 corrispondente. Per garantire una corretta gestione dei comandi FIRMWARE_RESTART e RESTART, si consiglia di sostituire auto con allow-hotplug nel file /etc/network/interfaces.d/can0 . Per esempio: allow-hotplug can0 iface can0 can static bitrate 500000 up ifconfig $IFACE txqueuelen 128","title":"Modalit\u00e0 bridge da USB a CAN bus"},{"location":"CANBUS_protocol.html","text":"Protocollo CANBUS \u00b6 Questo documento descrive il protocollo utilizzato da Klipper per comunicare su CAN bus . Vedere per informazioni sulla configurazione di Klipper con CANBUS. Assegnazione dell'id del microcontrollore \u00b6 Klipper utilizza solo pacchetti CAN bus di dimensioni standard CAN 2.0A, che sono limitati a 8 byte di dati e un identificatore bus CAN a 11 bit. Per supportare una comunicazione efficiente, a ogni microcontrollore viene assegnato in fase di esecuzione un ID nodo bus CAN univoco a 1 byte (\"canbus_nodeid\") per il traffico generale di comandi e risposte Klipper. I messaggi di comando di Klipper che vanno dall'host al microcontrollore utilizzano l'ID bus CAN di canbus_nodeid * 2 + 256 , mentre i messaggi di risposta di Klipper dal microcontrollore all'host usano canbus_nodeid * 2 + 256 + 1 . Ogni microcontrollore ha un identificatore di chip univoco assegnato in fabbrica che viene utilizzato durante l'assegnazione dell'ID. Questo identificatore pu\u00f2 superare la lunghezza di un pacchetto CAN, quindi una funzione hash viene utilizzata per generare un ID univoco a 6 byte ( canbus_uuid ) dall'ID di fabbrica. Messaggi dell'amministratore \u00b6 I messaggi dell'amministratore vengono utilizzati per l'assegnazione dell'ID. I messaggi di amministrazione inviati dall'host al microcontrollore utilizzano l'ID bus CAN \"0x3f0\" e i messaggi inviati dal microcontrollore all'host utilizzano l'ID bus CAN \"0x3f1\". Tutti i microcontrollori ascoltano i messaggi sull'id 0x3f0 ; quell'ID pu\u00f2 essere considerato un \"indirizzo di trasmissione\". messaggio CMD_QUERY_UNASSIGNED \u00b6 Questo comando interroga tutti i microcontrollori a cui non \u00e8 stato ancora assegnato un canbus_nodeid . I microcontrollori non assegnati risponderanno con un messaggio di risposta RESP_NEED_NODEID. Il formato del messaggio CMD_QUERY_UNASSIGNED \u00e8: <1 byte message_id = 0x00> CMD_SET_KLIPPER_NODEID messaggio \u00b6 Questo comando assegna un canbus_nodeid al microcontrollore con un dato canbus_uuid . Il formato del messaggio CMD_SET_KLIPPER_NODEID \u00e8: <1-byte message_id = 0x01><6-byte canbus_uuid><1-byte canbus_nodeid> Messaggio RESP_NEED_NODEID \u00b6 Il formato del messaggio RESP_NEED_NODEID \u00e8: <1-byte message_id = 0x20><6-byte canbus_uuid><1-byte set_klipper_nodeid = 0x01> Pacchetti dati \u00b6 Un microcontrollore a cui \u00e8 stato assegnato un nodeid tramite il comando CMD_SET_KLIPPER_NODEID pu\u00f2 inviare e ricevere pacchetti di dati. I dati del pacchetto nei messaggi che utilizzano l'ID bus CAN di ricezione del nodo ( canbus_nodeid * 2 + 256 ) vengono semplicemente aggiunti a un buffer e quando viene trovato un mcu protocol message completo, il suo contenuto viene analizzato ed elaborato . I dati vengono trattati come un flusso di byte: non \u00e8 necessario che l'inizio di un blocco di messaggi Klipper sia allineato con l'inizio di un pacchetto bus CAN. Allo stesso modo, le risposte ai messaggi del protocollo mcu vengono inviate dal microcontrollore all'host copiando i dati del messaggio in uno o pi\u00f9 pacchetti con l'ID del bus CAN di trasmissione del nodo ( canbus_nodeid * 2 + 256 + 1 ).","title":"Protocollo CANBUS"},{"location":"CANBUS_protocol.html#protocollo-canbus","text":"Questo documento descrive il protocollo utilizzato da Klipper per comunicare su CAN bus . Vedere per informazioni sulla configurazione di Klipper con CANBUS.","title":"Protocollo CANBUS"},{"location":"CANBUS_protocol.html#assegnazione-dellid-del-microcontrollore","text":"Klipper utilizza solo pacchetti CAN bus di dimensioni standard CAN 2.0A, che sono limitati a 8 byte di dati e un identificatore bus CAN a 11 bit. Per supportare una comunicazione efficiente, a ogni microcontrollore viene assegnato in fase di esecuzione un ID nodo bus CAN univoco a 1 byte (\"canbus_nodeid\") per il traffico generale di comandi e risposte Klipper. I messaggi di comando di Klipper che vanno dall'host al microcontrollore utilizzano l'ID bus CAN di canbus_nodeid * 2 + 256 , mentre i messaggi di risposta di Klipper dal microcontrollore all'host usano canbus_nodeid * 2 + 256 + 1 . Ogni microcontrollore ha un identificatore di chip univoco assegnato in fabbrica che viene utilizzato durante l'assegnazione dell'ID. Questo identificatore pu\u00f2 superare la lunghezza di un pacchetto CAN, quindi una funzione hash viene utilizzata per generare un ID univoco a 6 byte ( canbus_uuid ) dall'ID di fabbrica.","title":"Assegnazione dell'id del microcontrollore"},{"location":"CANBUS_protocol.html#messaggi-dellamministratore","text":"I messaggi dell'amministratore vengono utilizzati per l'assegnazione dell'ID. I messaggi di amministrazione inviati dall'host al microcontrollore utilizzano l'ID bus CAN \"0x3f0\" e i messaggi inviati dal microcontrollore all'host utilizzano l'ID bus CAN \"0x3f1\". Tutti i microcontrollori ascoltano i messaggi sull'id 0x3f0 ; quell'ID pu\u00f2 essere considerato un \"indirizzo di trasmissione\".","title":"Messaggi dell'amministratore"},{"location":"CANBUS_protocol.html#messaggio-cmd_query_unassigned","text":"Questo comando interroga tutti i microcontrollori a cui non \u00e8 stato ancora assegnato un canbus_nodeid . I microcontrollori non assegnati risponderanno con un messaggio di risposta RESP_NEED_NODEID. Il formato del messaggio CMD_QUERY_UNASSIGNED \u00e8: <1 byte message_id = 0x00>","title":"messaggio CMD_QUERY_UNASSIGNED"},{"location":"CANBUS_protocol.html#cmd_set_klipper_nodeid-messaggio","text":"Questo comando assegna un canbus_nodeid al microcontrollore con un dato canbus_uuid . Il formato del messaggio CMD_SET_KLIPPER_NODEID \u00e8: <1-byte message_id = 0x01><6-byte canbus_uuid><1-byte canbus_nodeid>","title":"CMD_SET_KLIPPER_NODEID messaggio"},{"location":"CANBUS_protocol.html#messaggio-resp_need_nodeid","text":"Il formato del messaggio RESP_NEED_NODEID \u00e8: <1-byte message_id = 0x20><6-byte canbus_uuid><1-byte set_klipper_nodeid = 0x01>","title":"Messaggio RESP_NEED_NODEID"},{"location":"CANBUS_protocol.html#pacchetti-dati","text":"Un microcontrollore a cui \u00e8 stato assegnato un nodeid tramite il comando CMD_SET_KLIPPER_NODEID pu\u00f2 inviare e ricevere pacchetti di dati. I dati del pacchetto nei messaggi che utilizzano l'ID bus CAN di ricezione del nodo ( canbus_nodeid * 2 + 256 ) vengono semplicemente aggiunti a un buffer e quando viene trovato un mcu protocol message completo, il suo contenuto viene analizzato ed elaborato . I dati vengono trattati come un flusso di byte: non \u00e8 necessario che l'inizio di un blocco di messaggi Klipper sia allineato con l'inizio di un pacchetto bus CAN. Allo stesso modo, le risposte ai messaggi del protocollo mcu vengono inviate dal microcontrollore all'host copiando i dati del messaggio in uno o pi\u00f9 pacchetti con l'ID del bus CAN di trasmissione del nodo ( canbus_nodeid * 2 + 256 + 1 ).","title":"Pacchetti dati"},{"location":"CONTRIBUTING.html","text":"Contribuire a Klipper \u00b6 Grazie per aver contribuito a Klipper! Questo documento descrive il processo per contribuire alle modifiche di Klipper. Consulta la contact page per informazioni sulla segnalazione di un problema o per i dettagli su come contattare gli sviluppatori. Panoramica del processo di contribuzione \u00b6 I contributi a Klipper seguono generalmente un processo di alto livello: Inizia creando una Richiesta pull GitHub quando un proposta \u00e8 pronta per la diffusione. Quando un reviewer \u00e8 disponibile per review l'invio, si assegner\u00e0 la richiesta pull su GitHub. L'obiettivo della revisione \u00e8 cercare i difetti e verificare che la proposta segua linee guida documentate. Dopo una revisione riuscita, il revisore \"approver\u00e0 la revisione\" su GitHub e un maintainer eseguir\u00e0 il commit della modifica al ramo principale di Klipper. Quando lavori sui miglioramenti, considera di iniziare (o contribuire a) un argomento su Klipper Discourse . Una discussione in corso sul forum pu\u00f2 migliorare la visibilit\u00e0 del lavoro di sviluppo e pu\u00f2 attirare altri interessati a testare nuovi lavori. Cosa aspettarsi da una revisione \u00b6 I contributi a Klipper vengono rivisti prima del merging. L'obiettivo principale del processo di revisione \u00e8 verificare la presenza di difetti e verificare che la presentazione segua le linee guida specificate nella documentazione di Klipper. Resta inteso che ci sono molti modi per portare a termine un compito; non \u00e8 intenzione della revisione discutere la \"migliore\" implementazione. Ove possibile, sono preferibili discussioni di revisione incentrate su fatti e misurazioni. La maggior parte degli invii otterr\u00e0 in feedback da una recensione. Preparati a ottenere feedback, fornire ulteriori dettagli e aggiornare l'invio, se necessario. Cose comuni che un revisore cercher\u00e0: L'invio \u00e8 privo di difetti ed \u00e8 pronto per essere diffuso?I realizzatori dei contributi sono tenuti a testare le loro modifiche prima dell'invio. I revisori cercano gli errori, ma in generale non testano gli invii. Un invio accettato viene spesso distribuito a migliaia di stampanti entro poche settimane dall'accettazione. La qualit\u00e0 degli invii \u00e8 quindi considerata una priorit\u00e0. Il repository GitHub principale Klipper3d/klipper non accetta lavori sperimentali. I realizzatori di contributi devono eseguire la sperimentazione, il debug e il test nei propri repository. Il server Klipper Discourse \u00e8 un buon posto per aumentare la consapevolezza del nuovo lavoro e per trovare utenti interessati a fornire feedback nel mondo reale. Gli invii devono superare tutti i test di regressione . Quando si corregge un difetto nel codice, i submitters dovrebbero avere una comprensione generale della causa principale di tale difetto e la correzione dovrebbe mirare a tale causa principale. Gli contributi di codice non devono contenere codice di debug eccessivo, opzioni di debug o registrazione del debug in fase di runtime. I commenti negli invii di codice dovrebbero concentrarsi sul miglioramento della manutenzione del codice. Gli invii non devono contenere \"codice commentato\" n\u00e9 commenti eccessivi che descrivono implementazioni passate. Non dovrebbero esserci commenti \"todo\" eccessivi. Gli aggiornamenti alla documentazione non devono dichiarare che si tratta di un \"work in progress\". L'invio fornisce un vantaggio \"ad alto impatto\" per gli utenti del mondo reale che svolgono attivit\u00e0 nel mondo reale?I revisori devono identificare, almeno nella loro mente, approssimativamente \"chi \u00e8 il pubblico di destinazione\", una scala approssimativa delle \"dimensioni di quel pubblico\", il \"beneficio\" che otterranno, come \"il beneficio viene misurato\" e i \"risultati di tali prove di misurazione\". Nella maggior parte dei casi questo sar\u00e0 ovvio sia per il mittente che per il revisore e non \u00e8 esplicitamente dichiarato durante una revisione. Le proposte al ramo principale di Klipper dovrebbero avere un pubblico di destinazione degno di nota. Come \"regola pratica\" generale, gli invii dovrebbero avere come target una base di utenti di almeno 100 utenti del mondo reale. Se un revisore chiede dettagli sul \"beneficio\" di un invio, non considerarlo una critica. Essere in grado di comprendere i vantaggi reali di un cambiamento \u00e8 una parte naturale di una revisione. Quando si discute dei benefici \u00e8 preferibile discutere di \"fatti e misurazioni\". In generale, i revisori non cercano risposte del modulo \"qualcuno potrebbe trovare utile l'opzione X\", n\u00e9 cercano risposte del modulo \"questo invio aggiunge una funzionalit\u00e0 implementata dal firmware X\". Invece, \u00e8 generalmente preferibile discutere i dettagli su come \u00e8 stato misurato il miglioramento della qualit\u00e0 e quali sono stati i risultati di tali misurazioni, ad esempio \"i test sulle stampanti Acme X1000 mostrano angoli migliorati come si vede in figura...\", o ad esempio \" il tempo di stampa dell'oggetto reale X su una stampante Foomatic X900 \u00e8 passato da 4 ore a 3,5 ore\". Resta inteso che i test di questo tipo possono richiedere molto tempo e sforzi. Alcune delle caratteristiche pi\u00f9 importanti di Klipper hanno richiesto mesi di discussioni, rielaborazioni, test e documentazione prima di essere fuse nel ramo principale. Tutti i nuovi moduli, opzioni di configurazione, comandi, parametri di comando e documenti dovrebbero avere un \"impatto elevato\". Non vogliamo appesantire gli utenti con opzioni che non possono configurare ragionevolmente n\u00e9 vogliamo appesantirli con opzioni che non forniscono un vantaggio notevole. Un revisore pu\u00f2 chiedere chiarimenti su come un utente deve configurare un'opzione - una risposta ideale conterr\u00e0 dettagli sul processo - ad esempio, \"gli utenti del MegaX500 dovrebbero impostare l'opzione X su 99,3 mentre gli utenti dell'Elite100Y dovrebbero calibrare l'opzione X usando la procedura ...\". Se l'obiettivo di un'opzione \u00e8 rendere il codice pi\u00f9 modulare, \u00e8 preferibile utilizzare le costanti del codice invece delle opzioni di configurazione rivolte all'utente. Nuovi moduli, nuove opzioni e nuovi parametri non dovrebbero fornire funzionalit\u00e0 simili ai moduli esistenti: se le differenze sono arbitrarie, \u00e8 preferibile utilizzare il sistema esistente o effettuare refactoring del codice esistente. Il copyright dell'invio \u00e8 chiaro, non gratuito e compatibile?I nuovi file C e Python dovrebbero avere una dichiarazione di copyright univoca. Vedere i file esistenti per il formato preferito. \u00c8 sconsigliato dichiarare un copyright su un file esistente quando si apportano modifiche minori a quel file. Il codice prelevato da fonti di terze parti deve essere compatibile con la licenza Klipper (GNU GPLv3). Grandi aggiunte di codice di terze parti dovrebbero essere aggiunte alla directory lib/ (e seguire il formato descritto in lib/README ). I mittenti devono fornire una Signed-off-line utilizzando il loro vero nome completo. Indica che il mittente \u00e8 d'accordo con il developer certificate of origin . L'invio segue le linee guida specificate nella documentazione di Klipper?In particolare, il codice deve seguire le linee guida in e i file di configurazione devono seguire le linee guida in . La documentazione di Klipper \u00e8 aggiornata per riflettere le nuove modifiche?Come minimo, la documentazione di riferimento deve essere aggiornata con le relative modifiche al codice: Tutti i comandi e i relativi parametri devono essere documentati in . Tutti i moduli rivolti all'utente e i relativi parametri di configurazione devono essere documentati in . Tutte le \"variabili di stato\" esportate devono essere documentate in . Tutti i nuovi \"webhook\" e i relativi parametri devono essere documentati in . Qualsiasi modifica che apporti una modifica non compatibile con le versioni precedenti a un comando o a un'impostazione del file di configurazione deve essere documentata in . I nuovi documenti dovrebbero essere aggiunti a e all'indice del sito web docs/_klipper3d/mkdocs.yml . I commit sono ben formati, affrontano un singolo argomento per commit e sono indipendenti?I messaggi di commit devono seguire il formato preferito . I commit non devono avere un conflitto in fase di merge. Le nuove aggiunte al ramo principale di Klipper vengono sempre eseguite tramite un \"rebase\" o \"squash and rebase\". In genere non \u00e8 necessario che i propositori uniscano nuovamente il loro invio ad ogni aggiornamento al repository principale di Klipper. Tuttavia, se c'\u00e8 un conflitto in fase di merge, si consiglia ai mittenti di usare git rebase per risolvere il conflitto. Ogni commit dovrebbe affrontare una singola modifica di alto livello. Le modifiche di grandi dimensioni dovrebbero essere suddivise in pi\u00f9 commit indipendenti. Ogni commit dovrebbe \"stare in piedi da solo\" in modo che strumenti come git bisect e git revert funzionino in modo affidabile. Le modifiche agli spazi bianchi non devono essere mescolate con le modifiche funzionali. In generale, le modifiche agli spazi bianchi gratuite non sono accettate a meno che non provengano dal \"proprietario\" stabilito del codice da modificare. Klipper non implementa una rigida \"guida allo stile di codifica\", ma le modifiche al codice esistente dovrebbero seguire il flusso di codice di alto livello, lo stile di indentazione del codice e il formato di quel codice esistente. Gli invii di nuovi moduli e sistemi hanno una maggiore flessibilit\u00e0 nello stile di codifica, ma \u00e8 preferibile che il nuovo codice segua uno stile internamente coerente e generalmente segua le norme di codifica. Non \u00e8 un obiettivo di una revisione discutere di \"migliori implementazioni\". Tuttavia, se un revisore ha difficolt\u00e0 a comprendere l'implementazione di un invio, pu\u00f2 richiedere modifiche per rendere l'implementazione pi\u00f9 trasparente. In particolare, se i revisori non riescono a convincersi che un contributo \u00e8 privo di difetti, potrebbero essere necessarie modifiche. Come parte di una revisione, un revisore pu\u00f2 creare una richiesta pull alternativa per un argomento. Questo pu\u00f2 essere fatto per evitare eccessivi \"avanti e indietro\" su elementi procedurali minori e quindi snellire il processo di proposta. Pu\u00f2 anche essere fatto perch\u00e9 la discussione ispira un revisore a costruire un'implementazione alternativa. Entrambe le situazioni sono il normale risultato di una revisione e non devono essere considerate critiche alla proposta originale. Aiutare con le revisioni \u00b6 Apprezziamo l'aiuto con le recensioni! Non \u00e8 necessario essere un revisore elencato per eseguire una revisione. I propositori di richieste pull di GitHub sono inoltre incoraggiati a rivedere i propri invii. Per aiutare con una revisione, segui i passaggi descritti in cosa aspettarsi in una revisione per verificare l'invio. Dopo aver completato la revisione, aggiungi un commento alla richiesta pull di GitHub con i tuoi risultati. Se l'invio supera la revisione, si prega di dichiararlo esplicitamente nel commento, ad esempio qualcosa del tipo \"Ho esaminato questa modifica in base ai passaggi del documento CONTRIBUTING e tutto mi sembra a posto\". Se non \u00e8 possibile completare alcuni passaggi della revisione, indicare esplicitamente quali passaggi sono stati rivisti e quali non sono stati rivisti, ad esempio qualcosa del tipo \"Non ho verificato la presenza di difetti nel codice, ma ho rivisto tutto il resto nel documento CONTRIBUTING e sembra buono\". Apprezziamo anche il test degli invii. Se il codice \u00e8 stato testato, aggiungi un commento alla richiesta pull di GitHub con i risultati del tuo test: successo o fallimento. Si prega di affermare esplicitamente che il codice \u00e8 stato testato e i risultati, ad esempio qualcosa del tipo \"Ho testato questo codice sulla mia stampante Acme900Z con una stampa a vaso e i risultati sono stati buoni\". Revisori \u00b6 I \"revisori\" di Klipper sono: Nome GitHub Id Aree di interesse Dmitry Butyugin @dmbutyugin Input shaping, test di risonanza, cinematica Eric Callahan @Arksine Livellamento del piatto, flashing MCU Kevin O'Connor @KevinOConnor Core motion system, codice microcontrollore Paul McGowan @mental405 File di configurazione, documentazione Si prega di non eseguire il \"ping\" di nessuno dei revisori e di non indirizzare gli invii a loro. Tutti i revisori controllano i forum e le PR e si occuperanno delle revisioni quando ne avranno il tempo. I \"manutentori\" di Klipper sono: Nome nome GitHub Kevin O'Connor @KevinOConnor Formato dei messaggi di commit \u00b6 Ogni commit dovrebbe avere un messaggio di commit formattato in modo simile al seguente: modulo: Riepilogo breve (50 caratteri o meno) in maiuscolo Testo esplicativo pi\u00f9 dettagliato, se necessario. Incolonna a circa 75 caratteri o gi\u00f9 di l\u00ec. In alcuni contesti, la prima riga \u00e8 trattata come l'oggetto di un'e-mail e il resto del testo come corpo. La riga vuota che separa il riassunto dal corpo \u00e8 critica (a meno che non si ometta del tutto il corpo); strumenti come rebase possono confondersi se li metti due insieme. Ulteriori paragrafi vengono dopo le righe vuote.. Firmato da: Il mio nome <myemail@example.org> Nell'esempio sopra, module dovrebbe essere il nome di un file o di una directory nel repository (senza un'estensione di file). Ad esempio, clocksync: fix di errore di battitura nella chiamata pause() al momento della connessione . Lo scopo di specificare un nome di modulo nel messaggio di commit \u00e8 di aiutare a fornire il contesto per i commenti di commit. \u00c8 importante avere una riga \"Signed-off-by\" su ogni commit - certifica che accetti il developer certificate of origin . Deve contenere il tuo vero nome (mi dispiace, niente pseudonimi o contributi anonimi) e contenere un indirizzo email corrente. Contribuire a Traduzioni Klipper \u00b6 Klipper-translations Project \u00e8 un progetto dedicato alla traduzione di Klipper in diverse lingue. Weblate ospita tutte le stringhe Gettext per la traduzione e la revisione. Le impostazioni locali possono essere visualizzate su klipper3d.org una volta che soddisfano i seguenti requisiti: 75% Copertura totale Tutti i titoli (H1) sono tradotti Una gerarchia di navigazione PR aggiornata nelle traduzioni klipper. Per ridurre la frustrazione di tradurre termini specifici del dominio e acquisire consapevolezza delle traduzioni in corso, puoi inviare un PR modificando il Klipper-translations Project readme.md . Una volta che una traduzione \u00e8 pronta, \u00e8 possibile apportare la modifica corrispondente al progetto Klipper. Se una traduzione esiste gi\u00e0 nel repository Klipper e non soddisfa pi\u00f9 l'elenco di controllo di cui sopra, verr\u00e0 contrassegnata come obsoleta dopo un mese senza aggiornamenti. Una volta soddisfatti i requisiti, \u00e8 necessario: aggiorna il repository di klipper-translations active_translations Opzionale: aggiungi un file manual-index.md nella cartella docs\\locals\\<lang> del repository klipper-translations per sostituire index.md specifico della lingua (il file index.md generato non viene visualizzato correttamente). Problemi noti: Al momento, non esiste un metodo per tradurre correttamente le immagini nella documentazione \u00c8 impossibile tradurre i titoli in mkdocs.yml.","title":"Contribuire a Klipper"},{"location":"CONTRIBUTING.html#contribuire-a-klipper","text":"Grazie per aver contribuito a Klipper! Questo documento descrive il processo per contribuire alle modifiche di Klipper. Consulta la contact page per informazioni sulla segnalazione di un problema o per i dettagli su come contattare gli sviluppatori.","title":"Contribuire a Klipper"},{"location":"CONTRIBUTING.html#panoramica-del-processo-di-contribuzione","text":"I contributi a Klipper seguono generalmente un processo di alto livello: Inizia creando una Richiesta pull GitHub quando un proposta \u00e8 pronta per la diffusione. Quando un reviewer \u00e8 disponibile per review l'invio, si assegner\u00e0 la richiesta pull su GitHub. L'obiettivo della revisione \u00e8 cercare i difetti e verificare che la proposta segua linee guida documentate. Dopo una revisione riuscita, il revisore \"approver\u00e0 la revisione\" su GitHub e un maintainer eseguir\u00e0 il commit della modifica al ramo principale di Klipper. Quando lavori sui miglioramenti, considera di iniziare (o contribuire a) un argomento su Klipper Discourse . Una discussione in corso sul forum pu\u00f2 migliorare la visibilit\u00e0 del lavoro di sviluppo e pu\u00f2 attirare altri interessati a testare nuovi lavori.","title":"Panoramica del processo di contribuzione"},{"location":"CONTRIBUTING.html#cosa-aspettarsi-da-una-revisione","text":"I contributi a Klipper vengono rivisti prima del merging. L'obiettivo principale del processo di revisione \u00e8 verificare la presenza di difetti e verificare che la presentazione segua le linee guida specificate nella documentazione di Klipper. Resta inteso che ci sono molti modi per portare a termine un compito; non \u00e8 intenzione della revisione discutere la \"migliore\" implementazione. Ove possibile, sono preferibili discussioni di revisione incentrate su fatti e misurazioni. La maggior parte degli invii otterr\u00e0 in feedback da una recensione. Preparati a ottenere feedback, fornire ulteriori dettagli e aggiornare l'invio, se necessario. Cose comuni che un revisore cercher\u00e0: L'invio \u00e8 privo di difetti ed \u00e8 pronto per essere diffuso?I realizzatori dei contributi sono tenuti a testare le loro modifiche prima dell'invio. I revisori cercano gli errori, ma in generale non testano gli invii. Un invio accettato viene spesso distribuito a migliaia di stampanti entro poche settimane dall'accettazione. La qualit\u00e0 degli invii \u00e8 quindi considerata una priorit\u00e0. Il repository GitHub principale Klipper3d/klipper non accetta lavori sperimentali. I realizzatori di contributi devono eseguire la sperimentazione, il debug e il test nei propri repository. Il server Klipper Discourse \u00e8 un buon posto per aumentare la consapevolezza del nuovo lavoro e per trovare utenti interessati a fornire feedback nel mondo reale. Gli invii devono superare tutti i test di regressione . Quando si corregge un difetto nel codice, i submitters dovrebbero avere una comprensione generale della causa principale di tale difetto e la correzione dovrebbe mirare a tale causa principale. Gli contributi di codice non devono contenere codice di debug eccessivo, opzioni di debug o registrazione del debug in fase di runtime. I commenti negli invii di codice dovrebbero concentrarsi sul miglioramento della manutenzione del codice. Gli invii non devono contenere \"codice commentato\" n\u00e9 commenti eccessivi che descrivono implementazioni passate. Non dovrebbero esserci commenti \"todo\" eccessivi. Gli aggiornamenti alla documentazione non devono dichiarare che si tratta di un \"work in progress\". L'invio fornisce un vantaggio \"ad alto impatto\" per gli utenti del mondo reale che svolgono attivit\u00e0 nel mondo reale?I revisori devono identificare, almeno nella loro mente, approssimativamente \"chi \u00e8 il pubblico di destinazione\", una scala approssimativa delle \"dimensioni di quel pubblico\", il \"beneficio\" che otterranno, come \"il beneficio viene misurato\" e i \"risultati di tali prove di misurazione\". Nella maggior parte dei casi questo sar\u00e0 ovvio sia per il mittente che per il revisore e non \u00e8 esplicitamente dichiarato durante una revisione. Le proposte al ramo principale di Klipper dovrebbero avere un pubblico di destinazione degno di nota. Come \"regola pratica\" generale, gli invii dovrebbero avere come target una base di utenti di almeno 100 utenti del mondo reale. Se un revisore chiede dettagli sul \"beneficio\" di un invio, non considerarlo una critica. Essere in grado di comprendere i vantaggi reali di un cambiamento \u00e8 una parte naturale di una revisione. Quando si discute dei benefici \u00e8 preferibile discutere di \"fatti e misurazioni\". In generale, i revisori non cercano risposte del modulo \"qualcuno potrebbe trovare utile l'opzione X\", n\u00e9 cercano risposte del modulo \"questo invio aggiunge una funzionalit\u00e0 implementata dal firmware X\". Invece, \u00e8 generalmente preferibile discutere i dettagli su come \u00e8 stato misurato il miglioramento della qualit\u00e0 e quali sono stati i risultati di tali misurazioni, ad esempio \"i test sulle stampanti Acme X1000 mostrano angoli migliorati come si vede in figura...\", o ad esempio \" il tempo di stampa dell'oggetto reale X su una stampante Foomatic X900 \u00e8 passato da 4 ore a 3,5 ore\". Resta inteso che i test di questo tipo possono richiedere molto tempo e sforzi. Alcune delle caratteristiche pi\u00f9 importanti di Klipper hanno richiesto mesi di discussioni, rielaborazioni, test e documentazione prima di essere fuse nel ramo principale. Tutti i nuovi moduli, opzioni di configurazione, comandi, parametri di comando e documenti dovrebbero avere un \"impatto elevato\". Non vogliamo appesantire gli utenti con opzioni che non possono configurare ragionevolmente n\u00e9 vogliamo appesantirli con opzioni che non forniscono un vantaggio notevole. Un revisore pu\u00f2 chiedere chiarimenti su come un utente deve configurare un'opzione - una risposta ideale conterr\u00e0 dettagli sul processo - ad esempio, \"gli utenti del MegaX500 dovrebbero impostare l'opzione X su 99,3 mentre gli utenti dell'Elite100Y dovrebbero calibrare l'opzione X usando la procedura ...\". Se l'obiettivo di un'opzione \u00e8 rendere il codice pi\u00f9 modulare, \u00e8 preferibile utilizzare le costanti del codice invece delle opzioni di configurazione rivolte all'utente. Nuovi moduli, nuove opzioni e nuovi parametri non dovrebbero fornire funzionalit\u00e0 simili ai moduli esistenti: se le differenze sono arbitrarie, \u00e8 preferibile utilizzare il sistema esistente o effettuare refactoring del codice esistente. Il copyright dell'invio \u00e8 chiaro, non gratuito e compatibile?I nuovi file C e Python dovrebbero avere una dichiarazione di copyright univoca. Vedere i file esistenti per il formato preferito. \u00c8 sconsigliato dichiarare un copyright su un file esistente quando si apportano modifiche minori a quel file. Il codice prelevato da fonti di terze parti deve essere compatibile con la licenza Klipper (GNU GPLv3). Grandi aggiunte di codice di terze parti dovrebbero essere aggiunte alla directory lib/ (e seguire il formato descritto in lib/README ). I mittenti devono fornire una Signed-off-line utilizzando il loro vero nome completo. Indica che il mittente \u00e8 d'accordo con il developer certificate of origin . L'invio segue le linee guida specificate nella documentazione di Klipper?In particolare, il codice deve seguire le linee guida in e i file di configurazione devono seguire le linee guida in . La documentazione di Klipper \u00e8 aggiornata per riflettere le nuove modifiche?Come minimo, la documentazione di riferimento deve essere aggiornata con le relative modifiche al codice: Tutti i comandi e i relativi parametri devono essere documentati in . Tutti i moduli rivolti all'utente e i relativi parametri di configurazione devono essere documentati in . Tutte le \"variabili di stato\" esportate devono essere documentate in . Tutti i nuovi \"webhook\" e i relativi parametri devono essere documentati in . Qualsiasi modifica che apporti una modifica non compatibile con le versioni precedenti a un comando o a un'impostazione del file di configurazione deve essere documentata in . I nuovi documenti dovrebbero essere aggiunti a e all'indice del sito web docs/_klipper3d/mkdocs.yml . I commit sono ben formati, affrontano un singolo argomento per commit e sono indipendenti?I messaggi di commit devono seguire il formato preferito . I commit non devono avere un conflitto in fase di merge. Le nuove aggiunte al ramo principale di Klipper vengono sempre eseguite tramite un \"rebase\" o \"squash and rebase\". In genere non \u00e8 necessario che i propositori uniscano nuovamente il loro invio ad ogni aggiornamento al repository principale di Klipper. Tuttavia, se c'\u00e8 un conflitto in fase di merge, si consiglia ai mittenti di usare git rebase per risolvere il conflitto. Ogni commit dovrebbe affrontare una singola modifica di alto livello. Le modifiche di grandi dimensioni dovrebbero essere suddivise in pi\u00f9 commit indipendenti. Ogni commit dovrebbe \"stare in piedi da solo\" in modo che strumenti come git bisect e git revert funzionino in modo affidabile. Le modifiche agli spazi bianchi non devono essere mescolate con le modifiche funzionali. In generale, le modifiche agli spazi bianchi gratuite non sono accettate a meno che non provengano dal \"proprietario\" stabilito del codice da modificare. Klipper non implementa una rigida \"guida allo stile di codifica\", ma le modifiche al codice esistente dovrebbero seguire il flusso di codice di alto livello, lo stile di indentazione del codice e il formato di quel codice esistente. Gli invii di nuovi moduli e sistemi hanno una maggiore flessibilit\u00e0 nello stile di codifica, ma \u00e8 preferibile che il nuovo codice segua uno stile internamente coerente e generalmente segua le norme di codifica. Non \u00e8 un obiettivo di una revisione discutere di \"migliori implementazioni\". Tuttavia, se un revisore ha difficolt\u00e0 a comprendere l'implementazione di un invio, pu\u00f2 richiedere modifiche per rendere l'implementazione pi\u00f9 trasparente. In particolare, se i revisori non riescono a convincersi che un contributo \u00e8 privo di difetti, potrebbero essere necessarie modifiche. Come parte di una revisione, un revisore pu\u00f2 creare una richiesta pull alternativa per un argomento. Questo pu\u00f2 essere fatto per evitare eccessivi \"avanti e indietro\" su elementi procedurali minori e quindi snellire il processo di proposta. Pu\u00f2 anche essere fatto perch\u00e9 la discussione ispira un revisore a costruire un'implementazione alternativa. Entrambe le situazioni sono il normale risultato di una revisione e non devono essere considerate critiche alla proposta originale.","title":"Cosa aspettarsi da una revisione"},{"location":"CONTRIBUTING.html#aiutare-con-le-revisioni","text":"Apprezziamo l'aiuto con le recensioni! Non \u00e8 necessario essere un revisore elencato per eseguire una revisione. I propositori di richieste pull di GitHub sono inoltre incoraggiati a rivedere i propri invii. Per aiutare con una revisione, segui i passaggi descritti in cosa aspettarsi in una revisione per verificare l'invio. Dopo aver completato la revisione, aggiungi un commento alla richiesta pull di GitHub con i tuoi risultati. Se l'invio supera la revisione, si prega di dichiararlo esplicitamente nel commento, ad esempio qualcosa del tipo \"Ho esaminato questa modifica in base ai passaggi del documento CONTRIBUTING e tutto mi sembra a posto\". Se non \u00e8 possibile completare alcuni passaggi della revisione, indicare esplicitamente quali passaggi sono stati rivisti e quali non sono stati rivisti, ad esempio qualcosa del tipo \"Non ho verificato la presenza di difetti nel codice, ma ho rivisto tutto il resto nel documento CONTRIBUTING e sembra buono\". Apprezziamo anche il test degli invii. Se il codice \u00e8 stato testato, aggiungi un commento alla richiesta pull di GitHub con i risultati del tuo test: successo o fallimento. Si prega di affermare esplicitamente che il codice \u00e8 stato testato e i risultati, ad esempio qualcosa del tipo \"Ho testato questo codice sulla mia stampante Acme900Z con una stampa a vaso e i risultati sono stati buoni\".","title":"Aiutare con le revisioni"},{"location":"CONTRIBUTING.html#revisori","text":"I \"revisori\" di Klipper sono: Nome GitHub Id Aree di interesse Dmitry Butyugin @dmbutyugin Input shaping, test di risonanza, cinematica Eric Callahan @Arksine Livellamento del piatto, flashing MCU Kevin O'Connor @KevinOConnor Core motion system, codice microcontrollore Paul McGowan @mental405 File di configurazione, documentazione Si prega di non eseguire il \"ping\" di nessuno dei revisori e di non indirizzare gli invii a loro. Tutti i revisori controllano i forum e le PR e si occuperanno delle revisioni quando ne avranno il tempo. I \"manutentori\" di Klipper sono: Nome nome GitHub Kevin O'Connor @KevinOConnor","title":"Revisori"},{"location":"CONTRIBUTING.html#formato-dei-messaggi-di-commit","text":"Ogni commit dovrebbe avere un messaggio di commit formattato in modo simile al seguente: modulo: Riepilogo breve (50 caratteri o meno) in maiuscolo Testo esplicativo pi\u00f9 dettagliato, se necessario. Incolonna a circa 75 caratteri o gi\u00f9 di l\u00ec. In alcuni contesti, la prima riga \u00e8 trattata come l'oggetto di un'e-mail e il resto del testo come corpo. La riga vuota che separa il riassunto dal corpo \u00e8 critica (a meno che non si ometta del tutto il corpo); strumenti come rebase possono confondersi se li metti due insieme. Ulteriori paragrafi vengono dopo le righe vuote.. Firmato da: Il mio nome <myemail@example.org> Nell'esempio sopra, module dovrebbe essere il nome di un file o di una directory nel repository (senza un'estensione di file). Ad esempio, clocksync: fix di errore di battitura nella chiamata pause() al momento della connessione . Lo scopo di specificare un nome di modulo nel messaggio di commit \u00e8 di aiutare a fornire il contesto per i commenti di commit. \u00c8 importante avere una riga \"Signed-off-by\" su ogni commit - certifica che accetti il developer certificate of origin . Deve contenere il tuo vero nome (mi dispiace, niente pseudonimi o contributi anonimi) e contenere un indirizzo email corrente.","title":"Formato dei messaggi di commit"},{"location":"CONTRIBUTING.html#contribuire-a-traduzioni-klipper","text":"Klipper-translations Project \u00e8 un progetto dedicato alla traduzione di Klipper in diverse lingue. Weblate ospita tutte le stringhe Gettext per la traduzione e la revisione. Le impostazioni locali possono essere visualizzate su klipper3d.org una volta che soddisfano i seguenti requisiti: 75% Copertura totale Tutti i titoli (H1) sono tradotti Una gerarchia di navigazione PR aggiornata nelle traduzioni klipper. Per ridurre la frustrazione di tradurre termini specifici del dominio e acquisire consapevolezza delle traduzioni in corso, puoi inviare un PR modificando il Klipper-translations Project readme.md . Una volta che una traduzione \u00e8 pronta, \u00e8 possibile apportare la modifica corrispondente al progetto Klipper. Se una traduzione esiste gi\u00e0 nel repository Klipper e non soddisfa pi\u00f9 l'elenco di controllo di cui sopra, verr\u00e0 contrassegnata come obsoleta dopo un mese senza aggiornamenti. Una volta soddisfatti i requisiti, \u00e8 necessario: aggiorna il repository di klipper-translations active_translations Opzionale: aggiungi un file manual-index.md nella cartella docs\\locals\\<lang> del repository klipper-translations per sostituire index.md specifico della lingua (il file index.md generato non viene visualizzato correttamente). Problemi noti: Al momento, non esiste un metodo per tradurre correttamente le immagini nella documentazione \u00c8 impossibile tradurre i titoli in mkdocs.yml.","title":"Contribuire a Traduzioni Klipper"},{"location":"Code_Overview.html","text":"Panoramica del codice \u00b6 Questo documento descrive il formato generale del codice e il flusso principale del codice di Klipper. Directory Layout \u00b6 La directory src/ contiene il sorgente C per il codice del microcontrollore. src/atsam/ , src/atsamd/ , src/avr/ , src/linux/ , src/lpc176x/ , src/ Le directory pru/ e src/stm32/ contengono il codice del microcontrollore specifico dell'architettura. src/simulator/ contiene stub di codice che consentono la compilazione di test del microcontrollore su altre architetture. La directory src/generic/ contiene codice di supporto che pu\u00f2 essere utile in diverse architetture. La build fa in modo che le include di \"board/somefile.h\" guardino prima nella directory dell'architettura corrente (ad esempio, src/avr/somefile.h) e poi nella directory generica (ad esempio, src/generic/somefile.h). La directory klippy/ contiene il software host. La maggior parte del software host \u00e8 scritto in Python, tuttavia la directory klippy/chelper/ contiene alcuni helper del codice C. La directory klippy/kinematics/ contiene il codice della cinematica del robot. La directory klippy/extras/ contiene i \"moduli\" estensibili del codice host. La directory lib/ contiene il codice della libreria di terze parti esterne necessarie per creare alcune destinazioni. La directory config/ contiene file di configurazione della stampante di esempio. La directory scripts/ contiene script di build-time utili per compilare il codice del microcontrollore. La directory test/ contiene test case automatizzati. Durante la compilazione, la build potrebbe creare una directory out/ . Questa contiene oggetti temporanei di compilazione. L'oggetto microcontrollore finale che viene creato \u00e8 out/klipper.elf.hex su AVR e out/klipper.bin su ARM. Flusso del codice del microcontrollore \u00b6 L'esecuzione del codice del microcontrollore inizia nel codice specifico dell'architettura (ad esempio, src/avr/main.c ) che alla fine chiama sched_main() che si trova in src/sched.c . Il codice sched_main() inizia eseguendo tutte le funzioni che sono state contrassegnate con la macro DECL_INIT(). Quindi continua a eseguire ripetutamente tutte le funzioni contrassegnate con la macro DECL_TASK(). Una delle principali funzioni dell'attivit\u00e0 \u00e8 command_dispatch() che si trova in src/command.c . Questa funzione viene richiamata dal codice input/output specifico della scheda (es. src/avr/serial.c , src/generic/serial_irq.c ) ed esegue le funzioni di comando associate ai comandi trovati nel flusso di input. Le funzioni di comando vengono dichiarate utilizzando la macro DECL_COMMAND() (consultare il documento protocol per ulteriori informazioni). Le funzioni task, init e comando vengono sempre eseguite con gli interrupt abilitati (tuttavia, possono disabilitare temporaneamente gli interrupt se necessario). Queste funzioni dovrebbero evitare lunghe pause, ritardi o eseguire lavori che durano un tempo significativo. (Lunghi ritardi in queste funzioni di \"attivit\u00e0\" provocano un jitter di pianificazione per altre \"attivit\u00e0\" - ritardi superiori a 100us possono diventare evidenti, ritardi superiori a 500us possono causare ritrasmissioni dei comandi, ritardi superiori a 100 ms possono causare riavvii del watchdog.) Queste funzioni pianificano il lavoro a orari specifici programmando i timer. Le funzioni timer vengono pianificate chiamando sched_add_timer() (che si trova in src/sched.c ). Il codice di pianificazione far\u00e0 in modo che la funzione data venga chiamata all'ora richiesta. Gli interrupt timer sono inizialmente gestiti in un gestore di interrupt specifico dell'architettura (ad esempio, src/avr/timer.c ) che chiama sched_timer_dispatch() situato in src/sched.c . L'interruzione del timer porta all'esecuzione delle funzioni del timer di pianificazione. Le funzioni timer vengono eseguite sempre con gli interrupt disabilitati. Le funzioni del timer dovrebbero sempre completarsi entro pochi microsecondi. Al completamento dell'evento timer, la funzione pu\u00f2 scegliere di riprogrammare se stessa. Nel caso in cui venga rilevato un errore, il codice pu\u00f2 invocare shutdown() (una macro che chiama sched_shutdown() situata in src/sched.c ). Il richiamo di shutdown() provoca l'esecuzione di tutte le funzioni contrassegnate con la macro DECL_SHUTDOWN(). Le funzioni di spegnimento vengono eseguite sempre con gli interrupt disabilitati. Gran parte delle funzionalit\u00e0 del microcontrollore implica il lavoro con pin di input/output per uso generico (GPIO). Per astrarre il codice specifico dell'architettura di basso livello dal codice dell'attivit\u00e0 di alto livello, tutti gli eventi GPIO sono implementati in wrapper specifici dell'architettura (ad esempio, src/avr/gpio.c ). Il codice \u00e8 compilato con l'ottimizzazione \"-flto -fwhole-program\" di gcc che fa un ottimo lavoro di inlining delle funzioni tra le unit\u00e0 di compilazione, quindi la maggior parte di queste minuscole funzioni gpio sono integrate nei loro chiamanti e non ci sono costi di runtime per l'utilizzo loro. Panoramica del codice Klippy \u00b6 Il codice host (Klippy) deve essere eseguito su un computer a basso costo (come un Raspberry Pi) abbinato al microcontrollore. Il codice \u00e8 scritto principalmente in Python, tuttavia utilizza CFFI per implementare alcune funzionalit\u00e0 nel codice C. L'esecuzione iniziale comincia in klippy/klippy.py . Questo legge gli argomenti della riga di comando, apre il file di configurazione della stampante, crea un'istanza degli oggetti principali della stampante e avvia la connessione seriale. L'esecuzione principale dei comandi G-code \u00e8 nel metodo process_commands() in klippy/gcode.py . Questo codice traduce i comandi del codice G in chiamate a oggetti stampante, che spesso traducono le azioni in comandi da eseguire sul microcontrollore (come dichiarato tramite la macro DECL_COMMAND nel codice del microcontrollore). Ci sono quattro thread nel codice host di Klippy. Il thread principale gestisce i comandi gcode in arrivo. Un secondo thread (che risiede interamente nel codice C klippy/chelper/serialqueue.c ) gestisce l'IO di basso livello con la porta seriale. Il terzo thread viene utilizzato per elaborare i messaggi di risposta dal microcontrollore nel codice Python (vedi klippy/serialhdl.py ). Il quarto thread scrive i messaggi di debug nel log (vedi klippy/queuelogger.py ) in modo che gli altri thread non blocchino mai le scritture del log. Flusso di codice di un comando di spostamento \u00b6 Un tipico movimento della stampante inizia quando viene inviato un comando \"G1\" all'host Klippy e si completa quando vengono prodotti i corrispondenti impulsi di passo sul microcontrollore. Questa sezione delinea il flusso di codice di un tipico comando di spostamento. Il documento cinematica fornisce ulteriori informazioni sulla meccanica dei movimenti. L'elaborazione di un comando di spostamento inizia in gcode.py. L'obiettivo di gcode.py \u00e8 tradurre il G-code in chiamate interne. Un comando G1 invocher\u00e0 cmd_G1() in klippy/extras/gcode_move.py. Il codice gcode_move.py gestisce le modifiche all'origine (ad esempio, G92), le modifiche alle posizioni relative rispetto a quelle assolute (ad esempio, G90) e le modifiche alle unit\u00e0 (ad esempio, F6000=100mm/s). Il percorso del codice per una mossa \u00e8: _process_data() -> _process_commands() -> cmd_G1() . Infine viene invocata la classe ToolHead per eseguire la richiesta effettiva: cmd_G1() -> ToolHead.move() La classe ToolHead (in toolhead.py) gestisce \"look-ahead\" e tiene traccia dei tempi delle azioni di stampa. Il percorso di codice principale per una mossa \u00e8: ToolHead.move() -> MoveQueue.add_move() -> MoveQueue.flush() -> Move.set_junction() -> ToolHead._process_moves() . ToolHead.move() crea un oggetto Move() con i parametri del movimento (in spazio cartesiano e in unit\u00e0 di secondi e millimetri). Alla classe cinematica viene data l'opportunit\u00e0 di controllare ogni movimento ( ToolHead.move() -> kin.check_move() ). Le classi cinematiche si trovano nella directory klippy/cinematica/. Il codice check_move() pu\u00f2 generare un errore se il movimento non \u00e8 valida. Se check_move() viene completato correttamente, la cinematica sottostante deve essere in grado di gestire lo spostamento. MoveQueue.add_move() posiziona l'oggetto di spostamento nella coda \"look-ahead\". MoveQueue.flush() determina le velocit\u00e0 di inizio e fine di ogni movimento. Move.set_junction() implementa il \"generatore di trapezi\" per il movimento. Il \"generatore trapezoidale\" suddivide ogni movimento in tre parti: una fase di accelerazione costante, seguita da una fase di velocit\u00e0 costante, seguita da una fase di decelerazione costante. Ogni mossa contiene queste tre fasi in questo ordine, ma alcune fasi possono avere durata zero. Quando viene chiamato ToolHead._process_moves(), tutto ci\u00f2 che riguarda lo spostamento \u00e8 noto: la sua posizione iniziale, la sua posizione finale, la sua accelerazione, la sua velocit\u00e0 di inizio/crociera/finale e la distanza percorsa durante l'accelerazione/crociera/decelerazione. Tutte le informazioni sono memorizzate nella classe Move() e sono nello spazio cartesiano in unit\u00e0 di millimetri e secondi. Klipper utilizza un risolutore iterativo per generare i tempi di passaggio per ogni stepper. Per motivi di efficienza, i tempi di impulso stepper sono generati in codice C. I movimenti vengono prima posizionati su una \"coda di movimento trapezoidale\": ToolHead._process_moves() -> trapq_append() (in klippy/chelper/trapq.c). Vengono quindi generati i tempi di passaggio: ToolHead._process_moves() -> ToolHead._update_move_time() -> MCU_Stepper.generate_steps() -> itersolve_generate_steps() -> itersolve_gen_steps_range() (in klippy/chelper/itersolve.c). L'obiettivo del risolutore iterativo \u00e8 trovare i tempi di passaggio data una funzione che calcola una posizione passo-passo da un tempo. Questo viene fatto \"indovinando\" ripetutamente varie volte fino a quando la formula della posizione dello stepper non restituisce la posizione desiderata del passaggio successivo sullo stepper. Il feedback prodotto da ciascuna ipotesi viene utilizzato per migliorare le ipotesi future in modo che il processo converga rapidamente al tempo desiderato. Le formule della posizione dello stepper cinematico si trovano nella directory klippy/chelper/ (ad es. kin_cart.c, kin_corexy.c, kin_delta.c, kin_extruder.c). Si noti che l'estrusore \u00e8 gestito nella propria classe cinematica: ToolHead._process_moves() -> PrinterExtruder.move() . Poich\u00e9 la classe Move() specifica l'esatto tempo di movimento e poich\u00e9 gli impulsi di passo vengono inviati al microcontrollore con una tempistica specifica, i movimenti passo-passo prodotti dalla classe estrusore saranno sincronizzati con il movimento della testa anche se il codice viene mantenuto separato. Dopo che il risolutore iterativo ha calcolato i tempi di passaggio, questi vengono aggiunti a un array: itersolve_gen_steps_range() -> stepcompress_append() (in klippy/chelper/stepcompress.c). L'array (struct stepcompress.queue) memorizza i corrispondenti tempi del contatore dell'orologio del microcontrollore per ogni passaggio. Qui il valore del \"contatore orologio del microcontrollore\" corrisponde direttamente al contatore hardware del microcontrollore - \u00e8 relativo a quando il microcontrollore \u00e8 stato acceso l'ultima volta. Il prossimo passo importante \u00e8 comprimere i passaggi: stepcompress_flush() -> compress_bisect_add() (in klippy/chelper/stepcompress.c). Questo codice genera e codifica una serie di comandi \"queue_step\" del microcontrollore che corrispondono all'elenco dei tempi di stepper compilati nella fase precedente. Questi comandi \"queue_step\" vengono quindi accodati, assegnati a priorit\u00e0 e inviati al microcontrollore (tramite stepcompress.c:steppersync e serialqueue.c:serialqueue). L'elaborazione dei comandi queue_step sul microcontrollore inizia in src/command.c che analizza il comando e chiama command_queue_step() . Il codice command_queue_step() (in src/stepper.c) aggiunge semplicemente i parametri di ogni comando queue_step a una coda per stepper. In condizioni normali, il comando queue_step viene analizzato e messo in coda almeno 100 ms prima dell'ora del suo primo passaggio. Infine, la generazione degli eventi stepper viene eseguita in stepper_event() . Viene chiamato dall'interruzione del timer hardware all'ora pianificata del primo passaggio. Il codice stepper_event() genera un impulso di passaggio e quindi si riprogramma per essere eseguito al momento dell'impulso di passaggio successivo per i parametri queue_step specificati. I parametri per ogni comando queue_step sono \"interval\", \"count\" e \"add\". Ad alto livello, stepper_event() esegue quanto segue, 'count' volte: do_step(); next_wake_time = last_wake_time + intervallo; intervallo += aggiungi; Quanto sopra pu\u00f2 sembrare un sacco di complessit\u00e0 per eseguire un movimento. Tuttavia, le uniche parti veramente interessanti sono nelle classi ToolHead e cinematica. \u00c8 questa parte del codice che specifica i movimenti e le loro tempistiche. Le restanti parti dell'elaborazione sono per lo pi\u00f9 solo comunicazioni e collegamenti. Aggiunta di un modulo host \u00b6 Il codice host Klippy ha una capacit\u00e0 di caricamento dinamico dei moduli. Se nel file di configurazione della stampante viene trovata una sezione di configurazione denominata \"[my_module]\", il software tenter\u00e0 automaticamente di caricare il modulo python klippy/extras/my_module.py . Questo sistema di moduli \u00e8 il metodo preferito per aggiungere nuove funzionalit\u00e0 a Klipper. Il modo pi\u00f9 semplice per aggiungere un nuovo modulo \u00e8 utilizzare un modulo esistente come riferimento - vedere klippy/extras/servo.py come esempio. Possono essere utili anche: L'esecuzione del modulo inizia nella funzione load_config() a livello di modulo (per le sezioni di configurazione del modulo [my_module]) o in load_config_prefix() (per le sezioni di configurazione del modulo [my_module my_name]). A questa funzione viene passato un oggetto \"config\" e deve restituire un nuovo \"oggetto stampante\" associato alla sezione di configurazione specificata. Durante il processo di creazione di un'istanza di un nuovo oggetto stampante, l'oggetto di configurazione pu\u00f2 essere utilizzato per leggere i parametri dalla sezione di configurazione specificata. Questo viene fatto usando i metodi config.get() , config.getfloat() , config.getint() , ecc. Assicurati di leggere tutti i valori dalla configurazione durante la costruzione dell'oggetto stampante: se l'utente specifica un parametro di configurazione che non viene letto durante questa fase, si presumer\u00e0 che si tratti di un errore di battitura nella configurazione e verr\u00e0 generato un errore. Usa il metodo config.get_printer() per ottenere un riferimento alla classe principale \"printer\". Questa classe \"stampante\" memorizza i riferimenti a tutti gli \"oggetti stampante\" di cui \u00e8 stata creata un'istanza. Usa il metodo printer.lookup_object() per trovare riferimenti ad altri oggetti stampante. Quasi tutte le funzionalit\u00e0 (anche i moduli cinematici principali) sono incapsulate in uno di questi oggetti stampante. Si noti, tuttavia, che quando viene istanziato un nuovo modulo, non saranno stati istanziati tutti gli altri oggetti stampante. I moduli \"gcode\" e \"pins\" saranno sempre disponibili, ma per altri moduli \u00e8 una buona idea rinviare la ricerca. Registra i gestori di eventi usando il metodo printer.register_event_handler() se il codice deve essere chiamato durante gli \"events\" generati da altri oggetti stampante. Ogni nome di evento \u00e8 una stringa e, per convenzione, \u00e8 il nome del modulo sorgente principale che genera l'evento insieme a un nome breve per l'azione che si sta verificando (ad esempio, \"klippy:connect\"). I parametri passati a ciascun gestore di eventi sono specifici dell'evento dato (cos\u00ec come la gestione delle eccezioni e il contesto di esecuzione). Due eventi di avvio comuni sono: klippy:connect - Questo evento viene generato dopo che tutti gli oggetti stampante sono stati istanziati. Viene comunemente utilizzato per cercare altri oggetti stampante, verificare le impostazioni di configurazione ed eseguire un \"handshake\" iniziale con l'hardware della stampante. klippy:ready - Questo evento viene generato dopo che tutti i gestori di connessione sono stati completati correttamente. Indica che la stampante sta passando a uno stato pronto per gestire le normali operazioni. Non generare un errore in questo callback. Se c'\u00e8 un errore nella configurazione dell'utente, assicurati di sollevarlo durante le fasi load_config() o \"connect event\". Utilizzare raise config.error(\"my error\") o raise printer.config_error (\"my error\") per segnalare l'errore. Utilizzare il modulo \"pin\" per configurare un pin su un microcontrollore. Questo \u00e8 in genere fatto con qualcosa di simile a printer.lookup_object(\"pins\").setup_pin(\"pwm\", config.get(\"my_pin\")) . L'oggetto restituito pu\u00f2 quindi essere comandato in fase di esecuzione. Se l'oggetto stampante definisce un metodo get_status() , il modulo pu\u00f2 esportare informazioni sullo stato tramite macro e tramite Server API . Il metodo get_status() deve restituire un dizionario Python con chiavi che sono stringhe e valori che sono interi, float, stringhe, elenchi, dizionari, True, False o None. \u00c8 possibile utilizzare anche tuple (e tuple con nome) (appaiono come elenchi quando si accede tramite il server API). Gli elenchi e i dizionari esportati devono essere trattati come \"immutabili\" - se il loro contenuto cambia, \u00e8 necessario restituire un nuovo oggetto da get_status() , altrimenti il server API non rilever\u00e0 tali modifiche. Se il modulo necessita dell'accesso alla temporizzazione del sistema o a descrittori di file esterni, utilizzare printer.get_reactor() per ottenere l'accesso alla classe globale \"event reactor\". Questa classe reattore consente di programmare i timer, attendere l'input sui descrittori di file e di \"sopprimere\" il codice host. Non utilizzare variabili globali. Tutto lo stato dovrebbe essere memorizzato nell'oggetto stampante restituito dalla funzione load_config() . Questo \u00e8 importante, altrimenti il comando RESTART potrebbe non funzionare come previsto. Inoltre, per ragioni simili, se vengono aperti file (o socket) esterni, assicurati di registrare un gestore di eventi \"klippy:disconnect\" e chiuderli da quella richiamata. Evitare di accedere alle variabili dei membri interni (o di chiamare metodi che iniziano con un trattino basso) di altri oggetti stampante. L'osservanza di questa convenzione semplifica la gestione delle modifiche future. Si consiglia di assegnare un valore a tutte le variabili membro nel costruttore Python delle classi Python. (E quindi evita di utilizzare la capacit\u00e0 di Python di creare dinamicamente nuove variabili membro.) Se una variabile Python deve memorizzare un valore in virgola mobile, si consiglia di assegnare e manipolare sempre quella variabile con costanti in virgola mobile (e non utilizzare mai costanti intere). Ad esempio, preferisci self.speed = 1. su self.speed = 1 e preferisci self.speed = 2. * x su self.speed = 2 * x . L'uso coerente di valori in virgola mobile pu\u00f2 evitare difficolt\u00e0 di debug nelle conversioni di tipo Python. Se invii il modulo per l'inclusione nel codice Klipper principale, assicurati di inserire un avviso di copyright nella parte superiore del modulo. Vedere i moduli esistenti per il formato preferito. Aggiunta di una nuova cinematica \u00b6 Questa sezione fornisce alcuni suggerimenti sull'aggiunta del supporto a Klipper per ulteriori tipi di cinematica della stampante. Questo tipo di attivit\u00e0 richiede un'ottima comprensione delle formule matematiche per la cinematica di destinazione. Richiede anche capacit\u00e0 di sviluppo software, sebbene sia necessario solo aggiornare il software host. Passi utili: Inizia studiando la sezione \" flusso di codice di un movimento \" e il documento di cinematica . Esaminare le classi cinematiche esistenti nella directory klippy/kinematics/. Le classi cinematiche hanno il compito di convertire una mossa in coordinate cartesiane nel movimento su ogni stepper. Si dovrebbe essere in grado di copiare uno di questi file come punto di partenza. Implementa in C le funzioni di posizione cinematica dello stepper per ogni stepper se non sono gi\u00e0 disponibili (vedi kin_cart.c, kin_corexy.c e kin_delta.c in klippy/chelper/). La funzione dovrebbe chiamare move_get_coord() per convertire un dato tempo di spostamento (in secondi) in una coordinata cartesiana (in millimetri), e quindi calcolare la posizione dello stepper desiderata (in millimetri) da quella coordinata cartesiana. Implementa il metodo calc_position() nella nuova classe cinematica. Questo metodo calcola la posizione della testa di stampa in coordinate cartesiane dalla posizione di ogni stepper. Non \u00e8 necessario che sia efficiente poich\u00e9 in genere viene chiamato solo durante le operazioni di homing e probing. Altri metodi. Implementa i metodi check_move() , get_status() , get_steppers() , home() e set_position() . Queste funzioni sono in genere utilizzate per fornire verifiche cinematiche specifiche. Tuttavia, all'inizio dello sviluppo \u00e8 possibile utilizzare il codice boilerplate qui. Implementare casi di prova. Crea un file g-code con una serie di movimenti che possono testare casi importanti per la cinematica data. Segui la documentazione di debug per convertire questo file di codice G in comandi del microcontrollore. Questo \u00e8 utile per esercitare corner case e per verificare la presenza di regressioni. Porting su un nuovo microcontrollore \u00b6 Questa sezione fornisce alcuni suggerimenti sul porting del codice del microcontrollore di Klipper su una nuova architettura. Questo tipo di attivit\u00e0 richiede una buona conoscenza dello sviluppo embedded e un accesso diretto al microcontrollore di destinazione. Passi utili: Inizia identificando eventuali librerie di terze parti che verranno utilizzate durante il trasferimento. Esempi comuni includono wrapper \"CMSIS\" e librerie \"HAL\" del produttore. Tutto il codice di terze parti deve essere compatibile con GNU GPLv3. Il codice di terze parti dovrebbe essere salvato nella directory lib/ di Klipper. Aggiorna il file lib/README con informazioni su dove e quando \u00e8 stata ottenuta la libreria. \u00c8 preferibile copiare il codice nel repository di Klipper senza modifiche, ma se sono necessarie modifiche, tali modifiche dovrebbero essere elencate esplicitamente nel file lib/README. Crea una nuova sottodirectory di architettura nella directory src/ e aggiungi il supporto iniziale di Kconfig e Makefile. Utilizzare le architetture esistenti come guida. src/simulator fornisce un esempio di base di un punto di partenza minimo. Il primo compito di programmazione \u00e8 portare il supporto di comunicazione alla scheda di destinazione. Questo \u00e8 il passo pi\u00f9 difficile in un nuovo porting. Una volta che la comunicazione di base funziona, i passaggi rimanenti tendono a essere molto pi\u00f9 semplici. \u00c8 tipico utilizzare un dispositivo seriale di tipo UART durante lo sviluppo iniziale poich\u00e9 questi tipi di dispositivi hardware sono generalmente pi\u00f9 facili da abilitare e controllare. Durante questa fase, fai un uso generoso del codice di supporto dalla directory src/generic/ (controlla come src/simulator/Makefile include il codice C generico nella build). \u00c8 inoltre necessario definire timer_read_time() (che restituisce l'orologio di sistema corrente) in questa fase, ma non \u00e8 necessario supportare completamente la gestione di timer irq. Acquisisci familiarit\u00e0 con lo strumento console.py (come descritto nel documento di debug ) e verifica la connettivit\u00e0 al microcontrollore con esso. Questo strumento traduce il protocollo di comunicazione del microcontrollore di basso livello in un formato leggibile dall'uomo. Aggiungi il supporto per l'invio del timer da interrupt hardware. Vedere Klipper commit 970831ee come esempio dei passaggi 1-5 eseguiti per l'architettura LPC176x. Visualizza il supporto di input e output GPIO di base. Vedi Klipper commit c78b9076 come esempio di questo. Riporta periferiche aggiuntive, ad esempio consulta il commit di Klipper 65613aed , c812a40a , e c381d03a . Crea un file di configurazione di Klipper di esempio nella directory config/. Testare il microcontrollore con il programma principale klippy.py. Prendi in considerazione l'aggiunta di build test case nella directory test/. Ulteriori suggerimenti per la programmazione: Evitare di utilizzare \"C bitfields\" per accedere ai registri IO; preferire operazioni di lettura e scrittura dirette di numeri interi a 32 bit, 16 bit o 8 bit. Le specifiche del linguaggio C non specificano chiaramente come il compilatore deve implementare campi di bit C (ad esempio, endianness e layout di bit), ed \u00e8 difficile determinare quali operazioni di I/O si verificheranno su un campo di bit C letto o scritto. Preferibilmente scrivere valori espliciti nei registri IO invece di usare operazioni di lettura-modifica-scrittura. Cio\u00e8, se si aggiorna un campo in un registro IO in cui gli altri campi hanno valori noti, \u00e8 preferibile scrivere in modo esplicito il contenuto completo del registro. Le scritture esplicite producono codice pi\u00f9 piccolo, pi\u00f9 veloce e pi\u00f9 facile da eseguire il debug. Sistemi di coordinate \u00b6 Internamente, Klipper tiene traccia principalmente della posizione della testa di stampa in coordinate cartesiane relative al sistema di coordinate specificato nel file di configurazione. Cio\u00e8, la maggior parte del codice Klipper non subir\u00e0 mai un cambiamento nei sistemi di coordinate. Se l'utente fa una richiesta per cambiare l'origine (ad esempio, un comando G92 ), allora quell'effetto si ottiene traducendo i comandi futuri nel sistema di coordinate primario. Tuttavia, in alcuni casi \u00e8 utile ottenere la posizione della testa di stampa in qualche altro sistema di coordinate e Klipper ha diversi strumenti per facilitarlo. Questo pu\u00f2 essere visto eseguendo il comando GET_POSITION. Per esempio: Send: GET_POSITION Recv: // mcu: stepper_a:-2060 stepper_b:-1169 stepper_c:-1613 Recv: // stepper: stepper_a:457.254159 stepper_b:466.085669 stepper_c:465.382132 Recv: // kinematic: X:8.339144 Y:-3.131558 Z:233.347121 Recv: // toolhead: X:8.338078 Y:-3.123175 Z:233.347878 E:0.000000 Recv: // gcode: X:8.338078 Y:-3.123175 Z:233.347878 E:0.000000 Recv: // gcode base: X:0.000000 Y:0.000000 Z:0.000000 E:0.000000 Recv: // gcode homing: X:0.000000 Y:0.000000 Z:0.000000 La posizione \"mcu\" ( stepper.get_mcu_position() nel codice) \u00e8 il numero totale di passaggi che il microcontrollore ha emesso in direzione positiva meno il numero di passaggi emessi in direzione negativa dall'ultimo microcontrollore Ripristina. Se il robot \u00e8 in movimento quando viene emessa la query, il valore riportato include le mosse memorizzate nel buffer del microcontrollore, ma non include le mosse nella coda di previsione. La posizione \"stepper\" ( stepper.get_commanded_position() ) \u00e8 la posizione del dato stepper come tracciato dal codice della cinematica. Questo corrisponde generalmente alla posizione (in mm) del carrello lungo il suo binario, rispetto a position_endstop specificato nel file di configurazione. (Alcune cinematiche tracciano le posizioni dello stepper in radianti anzich\u00e9 in millimetri.) Se il robot \u00e8 in movimento quando viene emessa la query, il valore riportato include i movimenti memorizzati nel buffer del microcontrollore, ma non include i movimenti sulla coda di previsione. Si possono usare le chiamate toolhead.flush_step_generation() o toolhead.wait_moves() per svuotare completamente il codice look-ahead e generazione di passaggi. La posizione \"cinematica\" ( kin.calc_position() ) \u00e8 la posizione cartesiana della testa di stampa come derivata dalle posizioni \"stepper\" ed \u00e8 relativa al sistema di coordinate specificato nel file di configurazione. Questo pu\u00f2 differire dalla posizione cartesiana richiesta a causa della granularit\u00e0 dei motori passo-passo. Se il robot \u00e8 in movimento quando vengono prese le posizioni \"stepper\", il valore riportato include i movimenti memorizzati nel buffer del microcontrollore, ma non include i movimenti sulla coda di previsione. Si possono usare le chiamate toolhead.flush_step_generation() o toolhead.wait_moves() per svuotare completamente il codice look-ahead e generazione di passaggi. La posizione della \"testa di stampa\" ( toolhead.get_position() ) \u00e8 l'ultima posizione richiesta della testa di stampa in coordinate cartesiane rispetto al sistema di coordinate specificato nel file di configurazione. Se il robot \u00e8 in movimento quando viene emessa la richiesta, il valore riportato include tutti i movimenti richiesti (anche quelli nei buffer in attesa di essere inviati ai driver del motore passo-passo). La posizione \"gcode\" \u00e8 l'ultima posizione richiesta da un comando G1 (o G0 ) in coordinate cartesiane relative al sistema di coordinate specificato nel file di configurazione. Questo pu\u00f2 differire dalla posizione \"toolhead\" se \u00e8 attiva una trasformazione del g-code (ad es. bed_mesh, bed_tilt, skew_correction). Questo pu\u00f2 differire dalle coordinate effettive specificate nell'ultimo comando G1 se l'origine del g-code \u00e8 stata modificata (ad esempio, G92 , SET_GCODE_OFFSET , M221 ). Il comando M114 ( gcode_move.get_status()['gcode_position'] ) riporter\u00e0 l'ultima posizione del g-code rispetto al sistema di coordinate del g-code corrente. La \"gcode base\" \u00e8 la posizione dell'origine del codice g in coordinate cartesiane rispetto al sistema di coordinate specificato nel file di configurazione. Comandi come G92 , SET_GCODE_OFFSET e M221 alterano questo valore. Il \"gcode homing\" \u00e8 la posizione da usare per l'origine del g-code (in coordinate cartesiane relative al sistema di coordinate specificato nel file di configurazione) dopo un comando home G28 . Il comando SET_GCODE_OFFSET pu\u00f2 alterare questo valore. Time \u00b6 Fondamentale per il funzionamento di Klipper \u00e8 la gestione di orologi, orari e timestamp. Klipper esegue azioni sulla stampante programmando eventi che si verificheranno nel prossimo futuro. Ad esempio, per accendere una ventola, il codice potrebbe programmare una modifica a un pin GPIO in 100 ms. \u00c8 raro che il codice tenti di eseguire un'azione istantanea. Pertanto, la gestione del tempo all'interno di Klipper \u00e8 fondamentale per il corretto funzionamento. Esistono tre tipi di tempi tracciati internamente nel software host di Klipper: Ora di sistema. L'ora del sistema utilizza l'orologio del sistema: \u00e8 un numero in virgola mobile memorizzato come secondi ed \u00e8 (generalmente) relativo all'ultimo avvio del computer host. I tempi di sistema hanno un uso limitato nel software: vengono utilizzati principalmente durante l'interazione con il sistema operativo. All'interno del codice host, gli orari di sistema sono spesso archiviati in variabili denominate eventtime o curtime . Tempo di stampa. Il tempo di stampa \u00e8 sincronizzato con l'orologio principale del microcontrollore (il microcontrollore definito nella sezione di configurazione \"[mcu]\"). \u00c8 un numero in virgola mobile memorizzato come secondi ed \u00e8 relativo all'ultimo riavvio dell'mcu principale. \u00c8 possibile convertire da un \"tempo di stampa\" all'orologio hardware del microcontrollore principale moltiplicando il tempo di stampa per la frequenza di frequenza configurata staticamente dell'mcu. Il codice host di alto livello utilizza i tempi di stampa per calcolare quasi tutte le azioni fisiche (ad es. movimento della testa, modifiche del riscaldatore, ecc.). All'interno del codice host, i tempi di stampa sono generalmente memorizzati in variabili denominate print_time o move_time . Orologio MCU. Questo \u00e8 il contatore dell'orologio hardware su ogni microcontrollore. Viene memorizzato come numero intero e la sua velocit\u00e0 di aggiornamento \u00e8 relativa alla frequenza del microcontrollore specificato. Il software host traduce i suoi tempi interni in orologi prima della trasmissione all'mcu. Il codice mcu tiene traccia del tempo solo in tick dell'orologio. All'interno del codice host, i valori di clock vengono tracciati come interi a 64 bit, mentre il codice mcu utilizza interi a 32 bit. All'interno del codice host, gli orologi sono generalmente memorizzati in variabili con nomi contenenti clock o tick . La conversione tra i diversi formati dell'ora \u00e8 implementata principalmente nel codice klippy/clocksync.py . Alcune cose da tenere presenti durante la revisione del codice: Orologi a 32 bit e 64 bit: per ridurre la larghezza di banda e migliorare l'efficienza del microcontrollore, gli orologi sul microcontrollore vengono tracciati come numeri interi a 32 bit. Quando si confrontano due orologi nel codice mcu, la funzione timer_is_before() deve essere sempre utilizzata per garantire che i rollover interi siano gestiti correttamente. Il software host converte gli orologi a 32 bit in orologi a 64 bit aggiungendo i bit di ordine superiore dall'ultimo timestamp mcu che ha ricevuto - nessun messaggio dall'mcu \u00e8 mai pi\u00f9 di 2^31 tick di clock in futuro o nel passato, quindi questa conversione non \u00e8 mai ambigua . L'host converte da clock a 64 bit a clock a 32 bit semplicemente troncando i bit di ordine superiore. Per garantire che non vi siano ambiguit\u00e0 in questa conversione, il codice klippy/chelper/serialqueue.c memorizza i messaggi nel buffer finch\u00e9 non si trovano entro 2^31 tick di clock dall'ora target. Microcontrollori multipli: il software host supporta l'utilizzo di pi\u00f9 microcontrollori su una singola stampante. In questo caso, il \"clock MCU\" di ogni microcontrollore viene tracciato separatamente. Il codice clocksync.py gestisce la deriva dell'orologio tra i microcontrollori modificando il modo in cui converte da \"tempo di stampa\" a \"orologio MCU\". Sul mcus secondario, la frequenza mcu utilizzata in questa conversione viene regolarmente aggiornata per tenere conto della deriva misurata.","title":"Panoramica del codice"},{"location":"Code_Overview.html#panoramica-del-codice","text":"Questo documento descrive il formato generale del codice e il flusso principale del codice di Klipper.","title":"Panoramica del codice"},{"location":"Code_Overview.html#directory-layout","text":"La directory src/ contiene il sorgente C per il codice del microcontrollore. src/atsam/ , src/atsamd/ , src/avr/ , src/linux/ , src/lpc176x/ , src/ Le directory pru/ e src/stm32/ contengono il codice del microcontrollore specifico dell'architettura. src/simulator/ contiene stub di codice che consentono la compilazione di test del microcontrollore su altre architetture. La directory src/generic/ contiene codice di supporto che pu\u00f2 essere utile in diverse architetture. La build fa in modo che le include di \"board/somefile.h\" guardino prima nella directory dell'architettura corrente (ad esempio, src/avr/somefile.h) e poi nella directory generica (ad esempio, src/generic/somefile.h). La directory klippy/ contiene il software host. La maggior parte del software host \u00e8 scritto in Python, tuttavia la directory klippy/chelper/ contiene alcuni helper del codice C. La directory klippy/kinematics/ contiene il codice della cinematica del robot. La directory klippy/extras/ contiene i \"moduli\" estensibili del codice host. La directory lib/ contiene il codice della libreria di terze parti esterne necessarie per creare alcune destinazioni. La directory config/ contiene file di configurazione della stampante di esempio. La directory scripts/ contiene script di build-time utili per compilare il codice del microcontrollore. La directory test/ contiene test case automatizzati. Durante la compilazione, la build potrebbe creare una directory out/ . Questa contiene oggetti temporanei di compilazione. L'oggetto microcontrollore finale che viene creato \u00e8 out/klipper.elf.hex su AVR e out/klipper.bin su ARM.","title":"Directory Layout"},{"location":"Code_Overview.html#flusso-del-codice-del-microcontrollore","text":"L'esecuzione del codice del microcontrollore inizia nel codice specifico dell'architettura (ad esempio, src/avr/main.c ) che alla fine chiama sched_main() che si trova in src/sched.c . Il codice sched_main() inizia eseguendo tutte le funzioni che sono state contrassegnate con la macro DECL_INIT(). Quindi continua a eseguire ripetutamente tutte le funzioni contrassegnate con la macro DECL_TASK(). Una delle principali funzioni dell'attivit\u00e0 \u00e8 command_dispatch() che si trova in src/command.c . Questa funzione viene richiamata dal codice input/output specifico della scheda (es. src/avr/serial.c , src/generic/serial_irq.c ) ed esegue le funzioni di comando associate ai comandi trovati nel flusso di input. Le funzioni di comando vengono dichiarate utilizzando la macro DECL_COMMAND() (consultare il documento protocol per ulteriori informazioni). Le funzioni task, init e comando vengono sempre eseguite con gli interrupt abilitati (tuttavia, possono disabilitare temporaneamente gli interrupt se necessario). Queste funzioni dovrebbero evitare lunghe pause, ritardi o eseguire lavori che durano un tempo significativo. (Lunghi ritardi in queste funzioni di \"attivit\u00e0\" provocano un jitter di pianificazione per altre \"attivit\u00e0\" - ritardi superiori a 100us possono diventare evidenti, ritardi superiori a 500us possono causare ritrasmissioni dei comandi, ritardi superiori a 100 ms possono causare riavvii del watchdog.) Queste funzioni pianificano il lavoro a orari specifici programmando i timer. Le funzioni timer vengono pianificate chiamando sched_add_timer() (che si trova in src/sched.c ). Il codice di pianificazione far\u00e0 in modo che la funzione data venga chiamata all'ora richiesta. Gli interrupt timer sono inizialmente gestiti in un gestore di interrupt specifico dell'architettura (ad esempio, src/avr/timer.c ) che chiama sched_timer_dispatch() situato in src/sched.c . L'interruzione del timer porta all'esecuzione delle funzioni del timer di pianificazione. Le funzioni timer vengono eseguite sempre con gli interrupt disabilitati. Le funzioni del timer dovrebbero sempre completarsi entro pochi microsecondi. Al completamento dell'evento timer, la funzione pu\u00f2 scegliere di riprogrammare se stessa. Nel caso in cui venga rilevato un errore, il codice pu\u00f2 invocare shutdown() (una macro che chiama sched_shutdown() situata in src/sched.c ). Il richiamo di shutdown() provoca l'esecuzione di tutte le funzioni contrassegnate con la macro DECL_SHUTDOWN(). Le funzioni di spegnimento vengono eseguite sempre con gli interrupt disabilitati. Gran parte delle funzionalit\u00e0 del microcontrollore implica il lavoro con pin di input/output per uso generico (GPIO). Per astrarre il codice specifico dell'architettura di basso livello dal codice dell'attivit\u00e0 di alto livello, tutti gli eventi GPIO sono implementati in wrapper specifici dell'architettura (ad esempio, src/avr/gpio.c ). Il codice \u00e8 compilato con l'ottimizzazione \"-flto -fwhole-program\" di gcc che fa un ottimo lavoro di inlining delle funzioni tra le unit\u00e0 di compilazione, quindi la maggior parte di queste minuscole funzioni gpio sono integrate nei loro chiamanti e non ci sono costi di runtime per l'utilizzo loro.","title":"Flusso del codice del microcontrollore"},{"location":"Code_Overview.html#panoramica-del-codice-klippy","text":"Il codice host (Klippy) deve essere eseguito su un computer a basso costo (come un Raspberry Pi) abbinato al microcontrollore. Il codice \u00e8 scritto principalmente in Python, tuttavia utilizza CFFI per implementare alcune funzionalit\u00e0 nel codice C. L'esecuzione iniziale comincia in klippy/klippy.py . Questo legge gli argomenti della riga di comando, apre il file di configurazione della stampante, crea un'istanza degli oggetti principali della stampante e avvia la connessione seriale. L'esecuzione principale dei comandi G-code \u00e8 nel metodo process_commands() in klippy/gcode.py . Questo codice traduce i comandi del codice G in chiamate a oggetti stampante, che spesso traducono le azioni in comandi da eseguire sul microcontrollore (come dichiarato tramite la macro DECL_COMMAND nel codice del microcontrollore). Ci sono quattro thread nel codice host di Klippy. Il thread principale gestisce i comandi gcode in arrivo. Un secondo thread (che risiede interamente nel codice C klippy/chelper/serialqueue.c ) gestisce l'IO di basso livello con la porta seriale. Il terzo thread viene utilizzato per elaborare i messaggi di risposta dal microcontrollore nel codice Python (vedi klippy/serialhdl.py ). Il quarto thread scrive i messaggi di debug nel log (vedi klippy/queuelogger.py ) in modo che gli altri thread non blocchino mai le scritture del log.","title":"Panoramica del codice Klippy"},{"location":"Code_Overview.html#flusso-di-codice-di-un-comando-di-spostamento","text":"Un tipico movimento della stampante inizia quando viene inviato un comando \"G1\" all'host Klippy e si completa quando vengono prodotti i corrispondenti impulsi di passo sul microcontrollore. Questa sezione delinea il flusso di codice di un tipico comando di spostamento. Il documento cinematica fornisce ulteriori informazioni sulla meccanica dei movimenti. L'elaborazione di un comando di spostamento inizia in gcode.py. L'obiettivo di gcode.py \u00e8 tradurre il G-code in chiamate interne. Un comando G1 invocher\u00e0 cmd_G1() in klippy/extras/gcode_move.py. Il codice gcode_move.py gestisce le modifiche all'origine (ad esempio, G92), le modifiche alle posizioni relative rispetto a quelle assolute (ad esempio, G90) e le modifiche alle unit\u00e0 (ad esempio, F6000=100mm/s). Il percorso del codice per una mossa \u00e8: _process_data() -> _process_commands() -> cmd_G1() . Infine viene invocata la classe ToolHead per eseguire la richiesta effettiva: cmd_G1() -> ToolHead.move() La classe ToolHead (in toolhead.py) gestisce \"look-ahead\" e tiene traccia dei tempi delle azioni di stampa. Il percorso di codice principale per una mossa \u00e8: ToolHead.move() -> MoveQueue.add_move() -> MoveQueue.flush() -> Move.set_junction() -> ToolHead._process_moves() . ToolHead.move() crea un oggetto Move() con i parametri del movimento (in spazio cartesiano e in unit\u00e0 di secondi e millimetri). Alla classe cinematica viene data l'opportunit\u00e0 di controllare ogni movimento ( ToolHead.move() -> kin.check_move() ). Le classi cinematiche si trovano nella directory klippy/cinematica/. Il codice check_move() pu\u00f2 generare un errore se il movimento non \u00e8 valida. Se check_move() viene completato correttamente, la cinematica sottostante deve essere in grado di gestire lo spostamento. MoveQueue.add_move() posiziona l'oggetto di spostamento nella coda \"look-ahead\". MoveQueue.flush() determina le velocit\u00e0 di inizio e fine di ogni movimento. Move.set_junction() implementa il \"generatore di trapezi\" per il movimento. Il \"generatore trapezoidale\" suddivide ogni movimento in tre parti: una fase di accelerazione costante, seguita da una fase di velocit\u00e0 costante, seguita da una fase di decelerazione costante. Ogni mossa contiene queste tre fasi in questo ordine, ma alcune fasi possono avere durata zero. Quando viene chiamato ToolHead._process_moves(), tutto ci\u00f2 che riguarda lo spostamento \u00e8 noto: la sua posizione iniziale, la sua posizione finale, la sua accelerazione, la sua velocit\u00e0 di inizio/crociera/finale e la distanza percorsa durante l'accelerazione/crociera/decelerazione. Tutte le informazioni sono memorizzate nella classe Move() e sono nello spazio cartesiano in unit\u00e0 di millimetri e secondi. Klipper utilizza un risolutore iterativo per generare i tempi di passaggio per ogni stepper. Per motivi di efficienza, i tempi di impulso stepper sono generati in codice C. I movimenti vengono prima posizionati su una \"coda di movimento trapezoidale\": ToolHead._process_moves() -> trapq_append() (in klippy/chelper/trapq.c). Vengono quindi generati i tempi di passaggio: ToolHead._process_moves() -> ToolHead._update_move_time() -> MCU_Stepper.generate_steps() -> itersolve_generate_steps() -> itersolve_gen_steps_range() (in klippy/chelper/itersolve.c). L'obiettivo del risolutore iterativo \u00e8 trovare i tempi di passaggio data una funzione che calcola una posizione passo-passo da un tempo. Questo viene fatto \"indovinando\" ripetutamente varie volte fino a quando la formula della posizione dello stepper non restituisce la posizione desiderata del passaggio successivo sullo stepper. Il feedback prodotto da ciascuna ipotesi viene utilizzato per migliorare le ipotesi future in modo che il processo converga rapidamente al tempo desiderato. Le formule della posizione dello stepper cinematico si trovano nella directory klippy/chelper/ (ad es. kin_cart.c, kin_corexy.c, kin_delta.c, kin_extruder.c). Si noti che l'estrusore \u00e8 gestito nella propria classe cinematica: ToolHead._process_moves() -> PrinterExtruder.move() . Poich\u00e9 la classe Move() specifica l'esatto tempo di movimento e poich\u00e9 gli impulsi di passo vengono inviati al microcontrollore con una tempistica specifica, i movimenti passo-passo prodotti dalla classe estrusore saranno sincronizzati con il movimento della testa anche se il codice viene mantenuto separato. Dopo che il risolutore iterativo ha calcolato i tempi di passaggio, questi vengono aggiunti a un array: itersolve_gen_steps_range() -> stepcompress_append() (in klippy/chelper/stepcompress.c). L'array (struct stepcompress.queue) memorizza i corrispondenti tempi del contatore dell'orologio del microcontrollore per ogni passaggio. Qui il valore del \"contatore orologio del microcontrollore\" corrisponde direttamente al contatore hardware del microcontrollore - \u00e8 relativo a quando il microcontrollore \u00e8 stato acceso l'ultima volta. Il prossimo passo importante \u00e8 comprimere i passaggi: stepcompress_flush() -> compress_bisect_add() (in klippy/chelper/stepcompress.c). Questo codice genera e codifica una serie di comandi \"queue_step\" del microcontrollore che corrispondono all'elenco dei tempi di stepper compilati nella fase precedente. Questi comandi \"queue_step\" vengono quindi accodati, assegnati a priorit\u00e0 e inviati al microcontrollore (tramite stepcompress.c:steppersync e serialqueue.c:serialqueue). L'elaborazione dei comandi queue_step sul microcontrollore inizia in src/command.c che analizza il comando e chiama command_queue_step() . Il codice command_queue_step() (in src/stepper.c) aggiunge semplicemente i parametri di ogni comando queue_step a una coda per stepper. In condizioni normali, il comando queue_step viene analizzato e messo in coda almeno 100 ms prima dell'ora del suo primo passaggio. Infine, la generazione degli eventi stepper viene eseguita in stepper_event() . Viene chiamato dall'interruzione del timer hardware all'ora pianificata del primo passaggio. Il codice stepper_event() genera un impulso di passaggio e quindi si riprogramma per essere eseguito al momento dell'impulso di passaggio successivo per i parametri queue_step specificati. I parametri per ogni comando queue_step sono \"interval\", \"count\" e \"add\". Ad alto livello, stepper_event() esegue quanto segue, 'count' volte: do_step(); next_wake_time = last_wake_time + intervallo; intervallo += aggiungi; Quanto sopra pu\u00f2 sembrare un sacco di complessit\u00e0 per eseguire un movimento. Tuttavia, le uniche parti veramente interessanti sono nelle classi ToolHead e cinematica. \u00c8 questa parte del codice che specifica i movimenti e le loro tempistiche. Le restanti parti dell'elaborazione sono per lo pi\u00f9 solo comunicazioni e collegamenti.","title":"Flusso di codice di un comando di spostamento"},{"location":"Code_Overview.html#aggiunta-di-un-modulo-host","text":"Il codice host Klippy ha una capacit\u00e0 di caricamento dinamico dei moduli. Se nel file di configurazione della stampante viene trovata una sezione di configurazione denominata \"[my_module]\", il software tenter\u00e0 automaticamente di caricare il modulo python klippy/extras/my_module.py . Questo sistema di moduli \u00e8 il metodo preferito per aggiungere nuove funzionalit\u00e0 a Klipper. Il modo pi\u00f9 semplice per aggiungere un nuovo modulo \u00e8 utilizzare un modulo esistente come riferimento - vedere klippy/extras/servo.py come esempio. Possono essere utili anche: L'esecuzione del modulo inizia nella funzione load_config() a livello di modulo (per le sezioni di configurazione del modulo [my_module]) o in load_config_prefix() (per le sezioni di configurazione del modulo [my_module my_name]). A questa funzione viene passato un oggetto \"config\" e deve restituire un nuovo \"oggetto stampante\" associato alla sezione di configurazione specificata. Durante il processo di creazione di un'istanza di un nuovo oggetto stampante, l'oggetto di configurazione pu\u00f2 essere utilizzato per leggere i parametri dalla sezione di configurazione specificata. Questo viene fatto usando i metodi config.get() , config.getfloat() , config.getint() , ecc. Assicurati di leggere tutti i valori dalla configurazione durante la costruzione dell'oggetto stampante: se l'utente specifica un parametro di configurazione che non viene letto durante questa fase, si presumer\u00e0 che si tratti di un errore di battitura nella configurazione e verr\u00e0 generato un errore. Usa il metodo config.get_printer() per ottenere un riferimento alla classe principale \"printer\". Questa classe \"stampante\" memorizza i riferimenti a tutti gli \"oggetti stampante\" di cui \u00e8 stata creata un'istanza. Usa il metodo printer.lookup_object() per trovare riferimenti ad altri oggetti stampante. Quasi tutte le funzionalit\u00e0 (anche i moduli cinematici principali) sono incapsulate in uno di questi oggetti stampante. Si noti, tuttavia, che quando viene istanziato un nuovo modulo, non saranno stati istanziati tutti gli altri oggetti stampante. I moduli \"gcode\" e \"pins\" saranno sempre disponibili, ma per altri moduli \u00e8 una buona idea rinviare la ricerca. Registra i gestori di eventi usando il metodo printer.register_event_handler() se il codice deve essere chiamato durante gli \"events\" generati da altri oggetti stampante. Ogni nome di evento \u00e8 una stringa e, per convenzione, \u00e8 il nome del modulo sorgente principale che genera l'evento insieme a un nome breve per l'azione che si sta verificando (ad esempio, \"klippy:connect\"). I parametri passati a ciascun gestore di eventi sono specifici dell'evento dato (cos\u00ec come la gestione delle eccezioni e il contesto di esecuzione). Due eventi di avvio comuni sono: klippy:connect - Questo evento viene generato dopo che tutti gli oggetti stampante sono stati istanziati. Viene comunemente utilizzato per cercare altri oggetti stampante, verificare le impostazioni di configurazione ed eseguire un \"handshake\" iniziale con l'hardware della stampante. klippy:ready - Questo evento viene generato dopo che tutti i gestori di connessione sono stati completati correttamente. Indica che la stampante sta passando a uno stato pronto per gestire le normali operazioni. Non generare un errore in questo callback. Se c'\u00e8 un errore nella configurazione dell'utente, assicurati di sollevarlo durante le fasi load_config() o \"connect event\". Utilizzare raise config.error(\"my error\") o raise printer.config_error (\"my error\") per segnalare l'errore. Utilizzare il modulo \"pin\" per configurare un pin su un microcontrollore. Questo \u00e8 in genere fatto con qualcosa di simile a printer.lookup_object(\"pins\").setup_pin(\"pwm\", config.get(\"my_pin\")) . L'oggetto restituito pu\u00f2 quindi essere comandato in fase di esecuzione. Se l'oggetto stampante definisce un metodo get_status() , il modulo pu\u00f2 esportare informazioni sullo stato tramite macro e tramite Server API . Il metodo get_status() deve restituire un dizionario Python con chiavi che sono stringhe e valori che sono interi, float, stringhe, elenchi, dizionari, True, False o None. \u00c8 possibile utilizzare anche tuple (e tuple con nome) (appaiono come elenchi quando si accede tramite il server API). Gli elenchi e i dizionari esportati devono essere trattati come \"immutabili\" - se il loro contenuto cambia, \u00e8 necessario restituire un nuovo oggetto da get_status() , altrimenti il server API non rilever\u00e0 tali modifiche. Se il modulo necessita dell'accesso alla temporizzazione del sistema o a descrittori di file esterni, utilizzare printer.get_reactor() per ottenere l'accesso alla classe globale \"event reactor\". Questa classe reattore consente di programmare i timer, attendere l'input sui descrittori di file e di \"sopprimere\" il codice host. Non utilizzare variabili globali. Tutto lo stato dovrebbe essere memorizzato nell'oggetto stampante restituito dalla funzione load_config() . Questo \u00e8 importante, altrimenti il comando RESTART potrebbe non funzionare come previsto. Inoltre, per ragioni simili, se vengono aperti file (o socket) esterni, assicurati di registrare un gestore di eventi \"klippy:disconnect\" e chiuderli da quella richiamata. Evitare di accedere alle variabili dei membri interni (o di chiamare metodi che iniziano con un trattino basso) di altri oggetti stampante. L'osservanza di questa convenzione semplifica la gestione delle modifiche future. Si consiglia di assegnare un valore a tutte le variabili membro nel costruttore Python delle classi Python. (E quindi evita di utilizzare la capacit\u00e0 di Python di creare dinamicamente nuove variabili membro.) Se una variabile Python deve memorizzare un valore in virgola mobile, si consiglia di assegnare e manipolare sempre quella variabile con costanti in virgola mobile (e non utilizzare mai costanti intere). Ad esempio, preferisci self.speed = 1. su self.speed = 1 e preferisci self.speed = 2. * x su self.speed = 2 * x . L'uso coerente di valori in virgola mobile pu\u00f2 evitare difficolt\u00e0 di debug nelle conversioni di tipo Python. Se invii il modulo per l'inclusione nel codice Klipper principale, assicurati di inserire un avviso di copyright nella parte superiore del modulo. Vedere i moduli esistenti per il formato preferito.","title":"Aggiunta di un modulo host"},{"location":"Code_Overview.html#aggiunta-di-una-nuova-cinematica","text":"Questa sezione fornisce alcuni suggerimenti sull'aggiunta del supporto a Klipper per ulteriori tipi di cinematica della stampante. Questo tipo di attivit\u00e0 richiede un'ottima comprensione delle formule matematiche per la cinematica di destinazione. Richiede anche capacit\u00e0 di sviluppo software, sebbene sia necessario solo aggiornare il software host. Passi utili: Inizia studiando la sezione \" flusso di codice di un movimento \" e il documento di cinematica . Esaminare le classi cinematiche esistenti nella directory klippy/kinematics/. Le classi cinematiche hanno il compito di convertire una mossa in coordinate cartesiane nel movimento su ogni stepper. Si dovrebbe essere in grado di copiare uno di questi file come punto di partenza. Implementa in C le funzioni di posizione cinematica dello stepper per ogni stepper se non sono gi\u00e0 disponibili (vedi kin_cart.c, kin_corexy.c e kin_delta.c in klippy/chelper/). La funzione dovrebbe chiamare move_get_coord() per convertire un dato tempo di spostamento (in secondi) in una coordinata cartesiana (in millimetri), e quindi calcolare la posizione dello stepper desiderata (in millimetri) da quella coordinata cartesiana. Implementa il metodo calc_position() nella nuova classe cinematica. Questo metodo calcola la posizione della testa di stampa in coordinate cartesiane dalla posizione di ogni stepper. Non \u00e8 necessario che sia efficiente poich\u00e9 in genere viene chiamato solo durante le operazioni di homing e probing. Altri metodi. Implementa i metodi check_move() , get_status() , get_steppers() , home() e set_position() . Queste funzioni sono in genere utilizzate per fornire verifiche cinematiche specifiche. Tuttavia, all'inizio dello sviluppo \u00e8 possibile utilizzare il codice boilerplate qui. Implementare casi di prova. Crea un file g-code con una serie di movimenti che possono testare casi importanti per la cinematica data. Segui la documentazione di debug per convertire questo file di codice G in comandi del microcontrollore. Questo \u00e8 utile per esercitare corner case e per verificare la presenza di regressioni.","title":"Aggiunta di una nuova cinematica"},{"location":"Code_Overview.html#porting-su-un-nuovo-microcontrollore","text":"Questa sezione fornisce alcuni suggerimenti sul porting del codice del microcontrollore di Klipper su una nuova architettura. Questo tipo di attivit\u00e0 richiede una buona conoscenza dello sviluppo embedded e un accesso diretto al microcontrollore di destinazione. Passi utili: Inizia identificando eventuali librerie di terze parti che verranno utilizzate durante il trasferimento. Esempi comuni includono wrapper \"CMSIS\" e librerie \"HAL\" del produttore. Tutto il codice di terze parti deve essere compatibile con GNU GPLv3. Il codice di terze parti dovrebbe essere salvato nella directory lib/ di Klipper. Aggiorna il file lib/README con informazioni su dove e quando \u00e8 stata ottenuta la libreria. \u00c8 preferibile copiare il codice nel repository di Klipper senza modifiche, ma se sono necessarie modifiche, tali modifiche dovrebbero essere elencate esplicitamente nel file lib/README. Crea una nuova sottodirectory di architettura nella directory src/ e aggiungi il supporto iniziale di Kconfig e Makefile. Utilizzare le architetture esistenti come guida. src/simulator fornisce un esempio di base di un punto di partenza minimo. Il primo compito di programmazione \u00e8 portare il supporto di comunicazione alla scheda di destinazione. Questo \u00e8 il passo pi\u00f9 difficile in un nuovo porting. Una volta che la comunicazione di base funziona, i passaggi rimanenti tendono a essere molto pi\u00f9 semplici. \u00c8 tipico utilizzare un dispositivo seriale di tipo UART durante lo sviluppo iniziale poich\u00e9 questi tipi di dispositivi hardware sono generalmente pi\u00f9 facili da abilitare e controllare. Durante questa fase, fai un uso generoso del codice di supporto dalla directory src/generic/ (controlla come src/simulator/Makefile include il codice C generico nella build). \u00c8 inoltre necessario definire timer_read_time() (che restituisce l'orologio di sistema corrente) in questa fase, ma non \u00e8 necessario supportare completamente la gestione di timer irq. Acquisisci familiarit\u00e0 con lo strumento console.py (come descritto nel documento di debug ) e verifica la connettivit\u00e0 al microcontrollore con esso. Questo strumento traduce il protocollo di comunicazione del microcontrollore di basso livello in un formato leggibile dall'uomo. Aggiungi il supporto per l'invio del timer da interrupt hardware. Vedere Klipper commit 970831ee come esempio dei passaggi 1-5 eseguiti per l'architettura LPC176x. Visualizza il supporto di input e output GPIO di base. Vedi Klipper commit c78b9076 come esempio di questo. Riporta periferiche aggiuntive, ad esempio consulta il commit di Klipper 65613aed , c812a40a , e c381d03a . Crea un file di configurazione di Klipper di esempio nella directory config/. Testare il microcontrollore con il programma principale klippy.py. Prendi in considerazione l'aggiunta di build test case nella directory test/. Ulteriori suggerimenti per la programmazione: Evitare di utilizzare \"C bitfields\" per accedere ai registri IO; preferire operazioni di lettura e scrittura dirette di numeri interi a 32 bit, 16 bit o 8 bit. Le specifiche del linguaggio C non specificano chiaramente come il compilatore deve implementare campi di bit C (ad esempio, endianness e layout di bit), ed \u00e8 difficile determinare quali operazioni di I/O si verificheranno su un campo di bit C letto o scritto. Preferibilmente scrivere valori espliciti nei registri IO invece di usare operazioni di lettura-modifica-scrittura. Cio\u00e8, se si aggiorna un campo in un registro IO in cui gli altri campi hanno valori noti, \u00e8 preferibile scrivere in modo esplicito il contenuto completo del registro. Le scritture esplicite producono codice pi\u00f9 piccolo, pi\u00f9 veloce e pi\u00f9 facile da eseguire il debug.","title":"Porting su un nuovo microcontrollore"},{"location":"Code_Overview.html#sistemi-di-coordinate","text":"Internamente, Klipper tiene traccia principalmente della posizione della testa di stampa in coordinate cartesiane relative al sistema di coordinate specificato nel file di configurazione. Cio\u00e8, la maggior parte del codice Klipper non subir\u00e0 mai un cambiamento nei sistemi di coordinate. Se l'utente fa una richiesta per cambiare l'origine (ad esempio, un comando G92 ), allora quell'effetto si ottiene traducendo i comandi futuri nel sistema di coordinate primario. Tuttavia, in alcuni casi \u00e8 utile ottenere la posizione della testa di stampa in qualche altro sistema di coordinate e Klipper ha diversi strumenti per facilitarlo. Questo pu\u00f2 essere visto eseguendo il comando GET_POSITION. Per esempio: Send: GET_POSITION Recv: // mcu: stepper_a:-2060 stepper_b:-1169 stepper_c:-1613 Recv: // stepper: stepper_a:457.254159 stepper_b:466.085669 stepper_c:465.382132 Recv: // kinematic: X:8.339144 Y:-3.131558 Z:233.347121 Recv: // toolhead: X:8.338078 Y:-3.123175 Z:233.347878 E:0.000000 Recv: // gcode: X:8.338078 Y:-3.123175 Z:233.347878 E:0.000000 Recv: // gcode base: X:0.000000 Y:0.000000 Z:0.000000 E:0.000000 Recv: // gcode homing: X:0.000000 Y:0.000000 Z:0.000000 La posizione \"mcu\" ( stepper.get_mcu_position() nel codice) \u00e8 il numero totale di passaggi che il microcontrollore ha emesso in direzione positiva meno il numero di passaggi emessi in direzione negativa dall'ultimo microcontrollore Ripristina. Se il robot \u00e8 in movimento quando viene emessa la query, il valore riportato include le mosse memorizzate nel buffer del microcontrollore, ma non include le mosse nella coda di previsione. La posizione \"stepper\" ( stepper.get_commanded_position() ) \u00e8 la posizione del dato stepper come tracciato dal codice della cinematica. Questo corrisponde generalmente alla posizione (in mm) del carrello lungo il suo binario, rispetto a position_endstop specificato nel file di configurazione. (Alcune cinematiche tracciano le posizioni dello stepper in radianti anzich\u00e9 in millimetri.) Se il robot \u00e8 in movimento quando viene emessa la query, il valore riportato include i movimenti memorizzati nel buffer del microcontrollore, ma non include i movimenti sulla coda di previsione. Si possono usare le chiamate toolhead.flush_step_generation() o toolhead.wait_moves() per svuotare completamente il codice look-ahead e generazione di passaggi. La posizione \"cinematica\" ( kin.calc_position() ) \u00e8 la posizione cartesiana della testa di stampa come derivata dalle posizioni \"stepper\" ed \u00e8 relativa al sistema di coordinate specificato nel file di configurazione. Questo pu\u00f2 differire dalla posizione cartesiana richiesta a causa della granularit\u00e0 dei motori passo-passo. Se il robot \u00e8 in movimento quando vengono prese le posizioni \"stepper\", il valore riportato include i movimenti memorizzati nel buffer del microcontrollore, ma non include i movimenti sulla coda di previsione. Si possono usare le chiamate toolhead.flush_step_generation() o toolhead.wait_moves() per svuotare completamente il codice look-ahead e generazione di passaggi. La posizione della \"testa di stampa\" ( toolhead.get_position() ) \u00e8 l'ultima posizione richiesta della testa di stampa in coordinate cartesiane rispetto al sistema di coordinate specificato nel file di configurazione. Se il robot \u00e8 in movimento quando viene emessa la richiesta, il valore riportato include tutti i movimenti richiesti (anche quelli nei buffer in attesa di essere inviati ai driver del motore passo-passo). La posizione \"gcode\" \u00e8 l'ultima posizione richiesta da un comando G1 (o G0 ) in coordinate cartesiane relative al sistema di coordinate specificato nel file di configurazione. Questo pu\u00f2 differire dalla posizione \"toolhead\" se \u00e8 attiva una trasformazione del g-code (ad es. bed_mesh, bed_tilt, skew_correction). Questo pu\u00f2 differire dalle coordinate effettive specificate nell'ultimo comando G1 se l'origine del g-code \u00e8 stata modificata (ad esempio, G92 , SET_GCODE_OFFSET , M221 ). Il comando M114 ( gcode_move.get_status()['gcode_position'] ) riporter\u00e0 l'ultima posizione del g-code rispetto al sistema di coordinate del g-code corrente. La \"gcode base\" \u00e8 la posizione dell'origine del codice g in coordinate cartesiane rispetto al sistema di coordinate specificato nel file di configurazione. Comandi come G92 , SET_GCODE_OFFSET e M221 alterano questo valore. Il \"gcode homing\" \u00e8 la posizione da usare per l'origine del g-code (in coordinate cartesiane relative al sistema di coordinate specificato nel file di configurazione) dopo un comando home G28 . Il comando SET_GCODE_OFFSET pu\u00f2 alterare questo valore.","title":"Sistemi di coordinate"},{"location":"Code_Overview.html#time","text":"Fondamentale per il funzionamento di Klipper \u00e8 la gestione di orologi, orari e timestamp. Klipper esegue azioni sulla stampante programmando eventi che si verificheranno nel prossimo futuro. Ad esempio, per accendere una ventola, il codice potrebbe programmare una modifica a un pin GPIO in 100 ms. \u00c8 raro che il codice tenti di eseguire un'azione istantanea. Pertanto, la gestione del tempo all'interno di Klipper \u00e8 fondamentale per il corretto funzionamento. Esistono tre tipi di tempi tracciati internamente nel software host di Klipper: Ora di sistema. L'ora del sistema utilizza l'orologio del sistema: \u00e8 un numero in virgola mobile memorizzato come secondi ed \u00e8 (generalmente) relativo all'ultimo avvio del computer host. I tempi di sistema hanno un uso limitato nel software: vengono utilizzati principalmente durante l'interazione con il sistema operativo. All'interno del codice host, gli orari di sistema sono spesso archiviati in variabili denominate eventtime o curtime . Tempo di stampa. Il tempo di stampa \u00e8 sincronizzato con l'orologio principale del microcontrollore (il microcontrollore definito nella sezione di configurazione \"[mcu]\"). \u00c8 un numero in virgola mobile memorizzato come secondi ed \u00e8 relativo all'ultimo riavvio dell'mcu principale. \u00c8 possibile convertire da un \"tempo di stampa\" all'orologio hardware del microcontrollore principale moltiplicando il tempo di stampa per la frequenza di frequenza configurata staticamente dell'mcu. Il codice host di alto livello utilizza i tempi di stampa per calcolare quasi tutte le azioni fisiche (ad es. movimento della testa, modifiche del riscaldatore, ecc.). All'interno del codice host, i tempi di stampa sono generalmente memorizzati in variabili denominate print_time o move_time . Orologio MCU. Questo \u00e8 il contatore dell'orologio hardware su ogni microcontrollore. Viene memorizzato come numero intero e la sua velocit\u00e0 di aggiornamento \u00e8 relativa alla frequenza del microcontrollore specificato. Il software host traduce i suoi tempi interni in orologi prima della trasmissione all'mcu. Il codice mcu tiene traccia del tempo solo in tick dell'orologio. All'interno del codice host, i valori di clock vengono tracciati come interi a 64 bit, mentre il codice mcu utilizza interi a 32 bit. All'interno del codice host, gli orologi sono generalmente memorizzati in variabili con nomi contenenti clock o tick . La conversione tra i diversi formati dell'ora \u00e8 implementata principalmente nel codice klippy/clocksync.py . Alcune cose da tenere presenti durante la revisione del codice: Orologi a 32 bit e 64 bit: per ridurre la larghezza di banda e migliorare l'efficienza del microcontrollore, gli orologi sul microcontrollore vengono tracciati come numeri interi a 32 bit. Quando si confrontano due orologi nel codice mcu, la funzione timer_is_before() deve essere sempre utilizzata per garantire che i rollover interi siano gestiti correttamente. Il software host converte gli orologi a 32 bit in orologi a 64 bit aggiungendo i bit di ordine superiore dall'ultimo timestamp mcu che ha ricevuto - nessun messaggio dall'mcu \u00e8 mai pi\u00f9 di 2^31 tick di clock in futuro o nel passato, quindi questa conversione non \u00e8 mai ambigua . L'host converte da clock a 64 bit a clock a 32 bit semplicemente troncando i bit di ordine superiore. Per garantire che non vi siano ambiguit\u00e0 in questa conversione, il codice klippy/chelper/serialqueue.c memorizza i messaggi nel buffer finch\u00e9 non si trovano entro 2^31 tick di clock dall'ora target. Microcontrollori multipli: il software host supporta l'utilizzo di pi\u00f9 microcontrollori su una singola stampante. In questo caso, il \"clock MCU\" di ogni microcontrollore viene tracciato separatamente. Il codice clocksync.py gestisce la deriva dell'orologio tra i microcontrollori modificando il modo in cui converte da \"tempo di stampa\" a \"orologio MCU\". Sul mcus secondario, la frequenza mcu utilizzata in questa conversione viene regolarmente aggiornata per tenere conto della deriva misurata.","title":"Time"},{"location":"Command_Templates.html","text":"Modelli di comandi \u00b6 Questo documento fornisce informazioni sull'implementazione di sequenze di comandi G-Code nelle sezioni di configurazione gcode_macro (e simili). Denominazione macro G-Code \u00b6 Le maiuscole non sono importanti per il nome della macro G-Code: MY_MACRO e my_macro saranno considerate allo stesso modo e possono essere chiamati in maiuscolo o minuscolo. Se nel nome della macro vengono utilizzati dei numeri, devono trovarsi tutti alla fine del nome (ad es. TEST_MACRO25 \u00e8 valido, ma MACRO25_TEST3 non lo \u00e8). Formattazione di G-Code nel config \u00b6 L'indentazione \u00e8 importante quando si definisce una macro nel file di configurazione. Per specificare una sequenza G-Code su pi\u00f9 righe \u00e8 importante che ogni riga abbia un'indentazione adeguata. Per esempio: [gcode_macro led_lampeggiante] gcode: SET_PIN PIN=my_led VALUE=1 G4 P2000 SET_PIN PIN=my_led VALUE=0 Nota come l'opzione di configurazione gcode: inizia sempre all'inizio della riga e le righe successive nella macro G-Code non iniziano mai all'inizio. Aggiungi una descrizione alla tua macro \u00b6 Per aiutare a identificare la funzionalit\u00e0 \u00e8 possibile aggiungere una breve descrizione. Aggiungi descrizione: con un breve testo per descrivere la funzionalit\u00e0. L'impostazione predefinita \u00e8 \"Macro codice G\" se non specificato. Per esempio: [gcode_macro led_lampeggiante] description: Esegue lampeggio del led una volta gcode: SET_PIN PIN=my_led VALUE=1 G4 P2000 SET_PIN PIN=my_led VALUE=0 Il terminale visualizzer\u00e0 la descrizione quando si utilizza il comando HELP o la funzione di completamento automatico. Salva/ripristina lo stato per i movimenti G-Code \u00b6 Sfortunatamente, il linguaggio di comando G-Code pu\u00f2 essere difficile da usare. Il meccanismo standard per spostare la testa di stampa \u00e8 tramite il comando G1 (il comando G0 \u00e8 un alias per G1 e pu\u00f2 essere usato in modo intercambiabile con esso). Tuttavia, questo comando si basa sull'impostazione dello \"stato di analisi del codice G\" da M82 , M83 , G90 , G91 , G92 e precedenti comandi G1 . Quando si crea una macro G-Code \u00e8 una buona idea impostare sempre in modo esplicito lo stato di analisi del G-Code prima di emettere un comando G1 . (Altrimenti, c'\u00e8 il rischio che il comando G1 faccia una richiesta indesiderabile.) Un modo comune per farlo \u00e8 avvolgere le mosse G1 in SAVE_GCODE_STATE , G91 e RESTORE_GCODE_STATE . Per esempio: [gcode_macro MOVE_UP] gcode: SAVE_GCODE_STATE NAME=my_move_up_state G91 G1 Z10 F300 RESTORE_GCODE_STATE NAME=my_move_up_state Il comando G91 pone lo stato di analisi del codice G in \"modalit\u00e0 di spostamento relativo\" e il comando RESTORE_GCODE_STATE ripristina lo stato a quello che era prima di entrare nella macro. Assicurati di specificare una velocit\u00e0 esplicita (tramite il parametro F ) sul primo comando G1 . Espansione del modello \u00b6 La sezione di configurazione di gcode_macro gcode: viene valutata utilizzando il linguaggio del modello Jinja2. \u00c8 possibile valutare le espressioni in fase di esecuzione racchiudendole in caratteri { } o utilizzando istruzioni condizionali racchiuse in {% %} . Vedere la documentazione Jinja2 per ulteriori informazioni sulla sintassi. Un esempio di macro complessa: [gcode_macro clean_nozzle] gcode: {% set wipe_count = 8 %} SAVE_GCODE_STATE NAME=clean_nozzle_state G90 G0 Z15 F300 {% for wipe in range(wipe_count) %} {% for coordinate in [(275, 4),(235, 4)] %} G0 X{coordinate[0]} Y{coordinate[1] + 0.25 * wipe} Z9.7 F12000 {% endfor %} {% endfor %} RESTORE_GCODE_STATE NAME=clean_nozzle_state Parametri Macro \u00b6 Spesso \u00e8 utile controllare i parametri passati alla macro quando viene chiamata. Questi parametri sono disponibili tramite la pseudo-variabile params . Ad esempio, se la macro: [gcode_macro SET_PERCENT] gcode: M117 Now at { params.VALUE|float * 100 }% sono stati invocati come SET_PERCENT VALUE=.2 verrebbero valutati in M117 Now at 20% . Si noti che i nomi dei parametri sono sempre in maiuscolo quando vengono valutati nella macro e vengono sempre passati come stringhe. Se si eseguono calcoli matematici, devono essere convertiti esplicitamente in numeri interi o float. \u00c8 comune usare la direttiva Jinja2 set per usare un parametro predefinito e assegnare il risultato a un nome locale. Per esempio: [gcode_macro SET_BED_TEMPERATURE] gcode: {% set bed_temp = params.TEMPERATURE|default(40)|float %} M140 S{bed_temp La variabile \"rawparams\" \u00b6 \u00c8 possibile accedere ai parametri completi non analizzati per la macro in esecuzione tramite la pseudo-variabile rawparams . Nota che questo includer\u00e0 tutti i commenti che facevano parte del comando originale. Vedere il file sample-macros.cfg per un esempio che mostra come sovrascrivere il comando M117 usando rawparams . La variabile \"printer\" \u00b6 \u00c8 possibile ispezionare (e modificare) lo stato corrente della stampante tramite la pseudo-variabile printer . Per esempio: [gcode_macro slow_fan] gcode: M106 S{ printer.fan.speed * 0.9 * 255} I campi disponibili sono definiti nel documento Status Reference . Importante! Le macro vengono prima valutate per intero e solo dopo vengono eseguiti i comandi risultanti. Se una macro emette un comando che altera lo stato della stampante, i risultati di tale cambiamento di stato non saranno visibili durante la valutazione della macro. Ci\u00f2 pu\u00f2 anche comportare un comportamento impercettibile quando una macro genera comandi che chiamano altre macro, poich\u00e9 la macro chiamata viene valutata quando viene richiamata (che avviene dopo l'intera valutazione della macro chiamante). Per convenzione, il nome immediatamente successivo a printer \u00e8 il nome di una sezione di configurazione. Quindi, ad esempio, printer.fan si riferisce all'oggetto fan creato dalla sezione di configurazione [fan] . Ci sono alcune eccezioni a questa regola, in particolare gli oggetti gcode_move e toolhead . Se la sezione di configurazione contiene spazi, \u00e8 possibile accedervi tramite l'accessor [ ] , ad esempio: printer[\"generic_heater my_chamber_heater\"].temperature . Si noti che la direttiva Jinja2 set pu\u00f2 assegnare un nome locale a un oggetto nella gerarchia printer . Ci\u00f2 pu\u00f2 rendere le macro pi\u00f9 leggibili e ridurre la digitazione. Per esempio: [gcode_macro QUERY_HTU21D] gcode: {% set sensor = printer[\"htu21d my_sensor\"] %} M117 Temp:{sensor.temperature} Humidity:{sensor.humidity} Azioni \u00b6 Sono disponibili alcuni comandi che possono alterare lo stato della stampante. Ad esempio, { action_emergency_stop() } provocherebbe l'arresto della stampante. Si noti che queste azioni vengono eseguite nel momento in cui viene valutata la macro, il che potrebbe richiedere un periodo di tempo significativo prima dell'esecuzione dei comandi g-code generati. Comandi \"azione\" disponibili: action_respond_info(msg) : scrive il dato msg sullo pseudo-terminale /tmp/printer. Ogni riga di msg verr\u00e0 inviata con un prefisso \"//\". action_raise_error(msg) : annulla la macro corrente (e qualsiasi macro chiamante) e scrivie il dato msg sullo pseudo-terminale /tmp/printer. La prima riga di msg verr\u00e0 inviata con un prefisso \"!!\" e le righe successive avranno un prefisso \"//\". action_emergency_stop(msg) : fa passare la stampante a uno stato di spegnimento. Il parametro msg \u00e8 opzionale, pu\u00f2 essere utile per descrivere il motivo dell'arresto. action_call_remote_method(method_name) : chiama un metodo registrato da un client remoto. Se il metodo accetta parametri, questi dovrebbero essere forniti tramite argomenti chiave, ad esempio: action_call_remote_method(\"print_stuff\", my_arg=\"hello_world\") Variabili \u00b6 Il comando SET_GCODE_VARIABLE pu\u00f2 essere utile per salvare lo stato tra le chiamate di macro. I nomi delle variabili non possono contenere caratteri maiuscoli. Per esempio: [gcode_macro start_probe] variable_bed_temp: 0 gcode: # Salva la temperatura target nella variabile bed_temp SET_GCODE_VARIABLE MACRO=start_probe VARIABLE=bed_temp VALUE={printer.heater_bed.target} # Disattiva il riscaldamento del piatto M140 # Esegue sonda PROBE # Chiama la macro finish_probe al completamento finish_probe [gcode_macro finish_probe] gcode: # Ripristinare la temperatura del piatto M140 S{printer[\"gcode_macro start_probe\"].bed_temp} Assicurarsi di tenere in considerazione i tempi della valutazione della macro e dell'esecuzione dei comandi quando si utilizza SET_GCODE_VARIABLE. Gcode ritardati \u00b6 L'opzione di configurazione [delayed_gcode] pu\u00f2 essere utilizzata per eseguire una sequenza gcode ritardata: [delayed_gcode clear_display] gcode: M117 [gcode_macro load_filament] gcode: G91 G1 E50 G90 M400 M117 Load Complete! UPDATE_DELAYED_GCODE ID=clear_display DURATION=10 Quando viene eseguita la macro load_filament sopra, visualizzer\u00e0 un \"Load Complete!\" messaggio al termine dell'estrusione. L'ultima riga di gcode abilita il delay_gcode \"clear_display\", impostato per essere eseguito in 10 secondi. L'opzione di configurazione initial_duration pu\u00f2 essere impostata per eseguire il delay_gcode all'avvio della stampante. Il conto alla rovescia inizia quando la stampante entra nello stato \"ready\". Ad esempio, il codice delay_g riportato di seguito verr\u00e0 eseguito 5 secondi dopo che la stampante \u00e8 pronta, inizializzando il display con un messaggio\"Welcome!\": [delayed_gcode welcome] initial_duration: 5. gcode: M117 Welcome! \u00c8 possibile che un gcode ritardato si ripeta aggiornandosi nell'opzione gcode: [delayed_gcode report_temp] initial_duration: 2. gcode: {action_respond_info(\"Extruder Temp: %.1f\" % (printer.extruder0.temperature))} UPDATE_DELAYED_GCODE ID=report_temp DURATION=2 Il codice delayed_gcode sopra riportato invier\u00e0 \"// Extruder Temp: [ex0_temp]\" a Octoprint ogni 2 secondi. Questo pu\u00f2 essere annullato con il seguente gcode: UPDATE_DELAYED_GCODE ID=report_temp DURATION=0 Modelli di menu \u00b6 Se \u00e8 abilitata una sezione di configurazione display , \u00e8 possibile personalizzare il menu con le sezioni di configurazione menu . I seguenti attributi di sola lettura sono disponibili nei modelli di menu: menu.width - larghezza dell'elemento (numero di colonne di visualizzazione) menu.ns - namespace del elemento menu.event - nome dell'evento che ha attivato lo script menu.input - valore di input, disponibile solo nel contesto dello script di input Le seguenti azioni sono disponibili nei modelli di menu: menu.back(force, update) : eseguir\u00e0 il comando menu back, parametri booleani opzionali <force> e <update> . Quando <force> \u00e8 impostato su True, interromper\u00e0 anche la modifica. Il valore predefinito \u00e8 False. Quando <update> \u00e8 impostato su False, gli elementi del contenitore padre non vengono aggiornati. Il valore predefinito \u00e8 True. menu.exit(force) - eseguir\u00e0 il comando di uscita dal menu, parametro booleano opzionale <force> valore predefinito False. Quando <force> \u00e8 impostato su True, interromper\u00e0 anche la modifica. Il valore predefinito \u00e8 False. Salvare variabili su disco \u00b6 Se \u00e8 stata abilitata una sezione di configurazione save_variables , SAVE_VARIABLE VARIABLE=<nome> VALUE=<valore> pu\u00f2 essere utilizzato per salvare la variabile su disco in modo che possa essere utilizzata tra i riavvii. Tutte le variabili memorizzate vengono caricate nel dict printer.save_variables.variables all'avvio e possono essere utilizzate nelle macro gcode. per evitare righe troppo lunghe puoi aggiungere quanto segue nella parte superiore della macro: {% set svv = printer.save_variables.variables %} Ad esempio, potrebbe essere utilizzato per salvare lo stato dell'hotend 2-in-1-out e quando si avvia una stampa assicurarsi che venga utilizzato l'estrusore attivo, anzich\u00e9 T0: [gcode_macro T1] gcode: ACTIVATE_EXTRUDER extruder=extruder1 SAVE_VARIABLE VARIABLE=currentextruder VALUE='\"extruder1\"' [gcode_macro T0] gcode: ACTIVATE_EXTRUDER extruder=extruder SAVE_VARIABLE VARIABLE=currentextruder VALUE='\"extruder\"' [gcode_macro START_GCODE] gcode: {% set svv = printer.save_variables.variables %} ACTIVATE_EXTRUDER extruder={svv.currentextruder}","title":"Modelli di comandi"},{"location":"Command_Templates.html#modelli-di-comandi","text":"Questo documento fornisce informazioni sull'implementazione di sequenze di comandi G-Code nelle sezioni di configurazione gcode_macro (e simili).","title":"Modelli di comandi"},{"location":"Command_Templates.html#denominazione-macro-g-code","text":"Le maiuscole non sono importanti per il nome della macro G-Code: MY_MACRO e my_macro saranno considerate allo stesso modo e possono essere chiamati in maiuscolo o minuscolo. Se nel nome della macro vengono utilizzati dei numeri, devono trovarsi tutti alla fine del nome (ad es. TEST_MACRO25 \u00e8 valido, ma MACRO25_TEST3 non lo \u00e8).","title":"Denominazione macro G-Code"},{"location":"Command_Templates.html#formattazione-di-g-code-nel-config","text":"L'indentazione \u00e8 importante quando si definisce una macro nel file di configurazione. Per specificare una sequenza G-Code su pi\u00f9 righe \u00e8 importante che ogni riga abbia un'indentazione adeguata. Per esempio: [gcode_macro led_lampeggiante] gcode: SET_PIN PIN=my_led VALUE=1 G4 P2000 SET_PIN PIN=my_led VALUE=0 Nota come l'opzione di configurazione gcode: inizia sempre all'inizio della riga e le righe successive nella macro G-Code non iniziano mai all'inizio.","title":"Formattazione di G-Code nel config"},{"location":"Command_Templates.html#aggiungi-una-descrizione-alla-tua-macro","text":"Per aiutare a identificare la funzionalit\u00e0 \u00e8 possibile aggiungere una breve descrizione. Aggiungi descrizione: con un breve testo per descrivere la funzionalit\u00e0. L'impostazione predefinita \u00e8 \"Macro codice G\" se non specificato. Per esempio: [gcode_macro led_lampeggiante] description: Esegue lampeggio del led una volta gcode: SET_PIN PIN=my_led VALUE=1 G4 P2000 SET_PIN PIN=my_led VALUE=0 Il terminale visualizzer\u00e0 la descrizione quando si utilizza il comando HELP o la funzione di completamento automatico.","title":"Aggiungi una descrizione alla tua macro"},{"location":"Command_Templates.html#salvaripristina-lo-stato-per-i-movimenti-g-code","text":"Sfortunatamente, il linguaggio di comando G-Code pu\u00f2 essere difficile da usare. Il meccanismo standard per spostare la testa di stampa \u00e8 tramite il comando G1 (il comando G0 \u00e8 un alias per G1 e pu\u00f2 essere usato in modo intercambiabile con esso). Tuttavia, questo comando si basa sull'impostazione dello \"stato di analisi del codice G\" da M82 , M83 , G90 , G91 , G92 e precedenti comandi G1 . Quando si crea una macro G-Code \u00e8 una buona idea impostare sempre in modo esplicito lo stato di analisi del G-Code prima di emettere un comando G1 . (Altrimenti, c'\u00e8 il rischio che il comando G1 faccia una richiesta indesiderabile.) Un modo comune per farlo \u00e8 avvolgere le mosse G1 in SAVE_GCODE_STATE , G91 e RESTORE_GCODE_STATE . Per esempio: [gcode_macro MOVE_UP] gcode: SAVE_GCODE_STATE NAME=my_move_up_state G91 G1 Z10 F300 RESTORE_GCODE_STATE NAME=my_move_up_state Il comando G91 pone lo stato di analisi del codice G in \"modalit\u00e0 di spostamento relativo\" e il comando RESTORE_GCODE_STATE ripristina lo stato a quello che era prima di entrare nella macro. Assicurati di specificare una velocit\u00e0 esplicita (tramite il parametro F ) sul primo comando G1 .","title":"Salva/ripristina lo stato per i movimenti G-Code"},{"location":"Command_Templates.html#espansione-del-modello","text":"La sezione di configurazione di gcode_macro gcode: viene valutata utilizzando il linguaggio del modello Jinja2. \u00c8 possibile valutare le espressioni in fase di esecuzione racchiudendole in caratteri { } o utilizzando istruzioni condizionali racchiuse in {% %} . Vedere la documentazione Jinja2 per ulteriori informazioni sulla sintassi. Un esempio di macro complessa: [gcode_macro clean_nozzle] gcode: {% set wipe_count = 8 %} SAVE_GCODE_STATE NAME=clean_nozzle_state G90 G0 Z15 F300 {% for wipe in range(wipe_count) %} {% for coordinate in [(275, 4),(235, 4)] %} G0 X{coordinate[0]} Y{coordinate[1] + 0.25 * wipe} Z9.7 F12000 {% endfor %} {% endfor %} RESTORE_GCODE_STATE NAME=clean_nozzle_state","title":"Espansione del modello"},{"location":"Command_Templates.html#parametri-macro","text":"Spesso \u00e8 utile controllare i parametri passati alla macro quando viene chiamata. Questi parametri sono disponibili tramite la pseudo-variabile params . Ad esempio, se la macro: [gcode_macro SET_PERCENT] gcode: M117 Now at { params.VALUE|float * 100 }% sono stati invocati come SET_PERCENT VALUE=.2 verrebbero valutati in M117 Now at 20% . Si noti che i nomi dei parametri sono sempre in maiuscolo quando vengono valutati nella macro e vengono sempre passati come stringhe. Se si eseguono calcoli matematici, devono essere convertiti esplicitamente in numeri interi o float. \u00c8 comune usare la direttiva Jinja2 set per usare un parametro predefinito e assegnare il risultato a un nome locale. Per esempio: [gcode_macro SET_BED_TEMPERATURE] gcode: {% set bed_temp = params.TEMPERATURE|default(40)|float %} M140 S{bed_temp","title":"Parametri Macro"},{"location":"Command_Templates.html#la-variabile-rawparams","text":"\u00c8 possibile accedere ai parametri completi non analizzati per la macro in esecuzione tramite la pseudo-variabile rawparams . Nota che questo includer\u00e0 tutti i commenti che facevano parte del comando originale. Vedere il file sample-macros.cfg per un esempio che mostra come sovrascrivere il comando M117 usando rawparams .","title":"La variabile \"rawparams\""},{"location":"Command_Templates.html#la-variabile-printer","text":"\u00c8 possibile ispezionare (e modificare) lo stato corrente della stampante tramite la pseudo-variabile printer . Per esempio: [gcode_macro slow_fan] gcode: M106 S{ printer.fan.speed * 0.9 * 255} I campi disponibili sono definiti nel documento Status Reference . Importante! Le macro vengono prima valutate per intero e solo dopo vengono eseguiti i comandi risultanti. Se una macro emette un comando che altera lo stato della stampante, i risultati di tale cambiamento di stato non saranno visibili durante la valutazione della macro. Ci\u00f2 pu\u00f2 anche comportare un comportamento impercettibile quando una macro genera comandi che chiamano altre macro, poich\u00e9 la macro chiamata viene valutata quando viene richiamata (che avviene dopo l'intera valutazione della macro chiamante). Per convenzione, il nome immediatamente successivo a printer \u00e8 il nome di una sezione di configurazione. Quindi, ad esempio, printer.fan si riferisce all'oggetto fan creato dalla sezione di configurazione [fan] . Ci sono alcune eccezioni a questa regola, in particolare gli oggetti gcode_move e toolhead . Se la sezione di configurazione contiene spazi, \u00e8 possibile accedervi tramite l'accessor [ ] , ad esempio: printer[\"generic_heater my_chamber_heater\"].temperature . Si noti che la direttiva Jinja2 set pu\u00f2 assegnare un nome locale a un oggetto nella gerarchia printer . Ci\u00f2 pu\u00f2 rendere le macro pi\u00f9 leggibili e ridurre la digitazione. Per esempio: [gcode_macro QUERY_HTU21D] gcode: {% set sensor = printer[\"htu21d my_sensor\"] %} M117 Temp:{sensor.temperature} Humidity:{sensor.humidity}","title":"La variabile \"printer\""},{"location":"Command_Templates.html#azioni","text":"Sono disponibili alcuni comandi che possono alterare lo stato della stampante. Ad esempio, { action_emergency_stop() } provocherebbe l'arresto della stampante. Si noti che queste azioni vengono eseguite nel momento in cui viene valutata la macro, il che potrebbe richiedere un periodo di tempo significativo prima dell'esecuzione dei comandi g-code generati. Comandi \"azione\" disponibili: action_respond_info(msg) : scrive il dato msg sullo pseudo-terminale /tmp/printer. Ogni riga di msg verr\u00e0 inviata con un prefisso \"//\". action_raise_error(msg) : annulla la macro corrente (e qualsiasi macro chiamante) e scrivie il dato msg sullo pseudo-terminale /tmp/printer. La prima riga di msg verr\u00e0 inviata con un prefisso \"!!\" e le righe successive avranno un prefisso \"//\". action_emergency_stop(msg) : fa passare la stampante a uno stato di spegnimento. Il parametro msg \u00e8 opzionale, pu\u00f2 essere utile per descrivere il motivo dell'arresto. action_call_remote_method(method_name) : chiama un metodo registrato da un client remoto. Se il metodo accetta parametri, questi dovrebbero essere forniti tramite argomenti chiave, ad esempio: action_call_remote_method(\"print_stuff\", my_arg=\"hello_world\")","title":"Azioni"},{"location":"Command_Templates.html#variabili","text":"Il comando SET_GCODE_VARIABLE pu\u00f2 essere utile per salvare lo stato tra le chiamate di macro. I nomi delle variabili non possono contenere caratteri maiuscoli. Per esempio: [gcode_macro start_probe] variable_bed_temp: 0 gcode: # Salva la temperatura target nella variabile bed_temp SET_GCODE_VARIABLE MACRO=start_probe VARIABLE=bed_temp VALUE={printer.heater_bed.target} # Disattiva il riscaldamento del piatto M140 # Esegue sonda PROBE # Chiama la macro finish_probe al completamento finish_probe [gcode_macro finish_probe] gcode: # Ripristinare la temperatura del piatto M140 S{printer[\"gcode_macro start_probe\"].bed_temp} Assicurarsi di tenere in considerazione i tempi della valutazione della macro e dell'esecuzione dei comandi quando si utilizza SET_GCODE_VARIABLE.","title":"Variabili"},{"location":"Command_Templates.html#gcode-ritardati","text":"L'opzione di configurazione [delayed_gcode] pu\u00f2 essere utilizzata per eseguire una sequenza gcode ritardata: [delayed_gcode clear_display] gcode: M117 [gcode_macro load_filament] gcode: G91 G1 E50 G90 M400 M117 Load Complete! UPDATE_DELAYED_GCODE ID=clear_display DURATION=10 Quando viene eseguita la macro load_filament sopra, visualizzer\u00e0 un \"Load Complete!\" messaggio al termine dell'estrusione. L'ultima riga di gcode abilita il delay_gcode \"clear_display\", impostato per essere eseguito in 10 secondi. L'opzione di configurazione initial_duration pu\u00f2 essere impostata per eseguire il delay_gcode all'avvio della stampante. Il conto alla rovescia inizia quando la stampante entra nello stato \"ready\". Ad esempio, il codice delay_g riportato di seguito verr\u00e0 eseguito 5 secondi dopo che la stampante \u00e8 pronta, inizializzando il display con un messaggio\"Welcome!\": [delayed_gcode welcome] initial_duration: 5. gcode: M117 Welcome! \u00c8 possibile che un gcode ritardato si ripeta aggiornandosi nell'opzione gcode: [delayed_gcode report_temp] initial_duration: 2. gcode: {action_respond_info(\"Extruder Temp: %.1f\" % (printer.extruder0.temperature))} UPDATE_DELAYED_GCODE ID=report_temp DURATION=2 Il codice delayed_gcode sopra riportato invier\u00e0 \"// Extruder Temp: [ex0_temp]\" a Octoprint ogni 2 secondi. Questo pu\u00f2 essere annullato con il seguente gcode: UPDATE_DELAYED_GCODE ID=report_temp DURATION=0","title":"Gcode ritardati"},{"location":"Command_Templates.html#modelli-di-menu","text":"Se \u00e8 abilitata una sezione di configurazione display , \u00e8 possibile personalizzare il menu con le sezioni di configurazione menu . I seguenti attributi di sola lettura sono disponibili nei modelli di menu: menu.width - larghezza dell'elemento (numero di colonne di visualizzazione) menu.ns - namespace del elemento menu.event - nome dell'evento che ha attivato lo script menu.input - valore di input, disponibile solo nel contesto dello script di input Le seguenti azioni sono disponibili nei modelli di menu: menu.back(force, update) : eseguir\u00e0 il comando menu back, parametri booleani opzionali <force> e <update> . Quando <force> \u00e8 impostato su True, interromper\u00e0 anche la modifica. Il valore predefinito \u00e8 False. Quando <update> \u00e8 impostato su False, gli elementi del contenitore padre non vengono aggiornati. Il valore predefinito \u00e8 True. menu.exit(force) - eseguir\u00e0 il comando di uscita dal menu, parametro booleano opzionale <force> valore predefinito False. Quando <force> \u00e8 impostato su True, interromper\u00e0 anche la modifica. Il valore predefinito \u00e8 False.","title":"Modelli di menu"},{"location":"Command_Templates.html#salvare-variabili-su-disco","text":"Se \u00e8 stata abilitata una sezione di configurazione save_variables , SAVE_VARIABLE VARIABLE=<nome> VALUE=<valore> pu\u00f2 essere utilizzato per salvare la variabile su disco in modo che possa essere utilizzata tra i riavvii. Tutte le variabili memorizzate vengono caricate nel dict printer.save_variables.variables all'avvio e possono essere utilizzate nelle macro gcode. per evitare righe troppo lunghe puoi aggiungere quanto segue nella parte superiore della macro: {% set svv = printer.save_variables.variables %} Ad esempio, potrebbe essere utilizzato per salvare lo stato dell'hotend 2-in-1-out e quando si avvia una stampa assicurarsi che venga utilizzato l'estrusore attivo, anzich\u00e9 T0: [gcode_macro T1] gcode: ACTIVATE_EXTRUDER extruder=extruder1 SAVE_VARIABLE VARIABLE=currentextruder VALUE='\"extruder1\"' [gcode_macro T0] gcode: ACTIVATE_EXTRUDER extruder=extruder SAVE_VARIABLE VARIABLE=currentextruder VALUE='\"extruder\"' [gcode_macro START_GCODE] gcode: {% set svv = printer.save_variables.variables %} ACTIVATE_EXTRUDER extruder={svv.currentextruder}","title":"Salvare variabili su disco"},{"location":"Config_Changes.html","text":"Modifiche alla configurazione \u00b6 Questo documento copre le modifiche software recenti al file di configurazione che non sono compatibili con le versioni precedenti. \u00c8 una buona idea rivedere questo documento durante l'aggiornamento del software Klipper. Tutte le date in questo documento sono approssimative. Cambiamenti \u00b6 20230201: The [bed_mesh] module no longer loads the default profile on startup. It is recommended that users who use the default profile add BED_MESH_PROFILE LOAD=default to their START_PRINT macro (or to their slicer's \"Start G-Code\" configuration when applicable). 20230103: It is now possible with the flash-sdcard.sh script to flash both variants of the Bigtreetech SKR-2, STM32F407 and STM32F429. This means that the original tag of btt-skr2 now has changed to either btt-skr-2-f407 or btt-skr-2-f429. 20221128: Klipper v0.11.0 released. 20221122: In precedenza, con safe_z_home, era possibile che z_hop dopo l'homing g28 andasse nella direzione z negativa. Ora, uno z_hop viene eseguito dopo g28 solo se risulta in un hop positivo, rispecchiando il comportamento dello z_hop che si verifica prima dell'homing g28. 20220616: in precedenza era possibile eseguire il flashing di un rp2040 in modalit\u00e0 bootloader eseguendo make flash FLASH_DEVICE=first . Il comando equivalente \u00e8 ora make flash FLASH_DEVICE=2e8a:0003 . 20220612: Il microcontrollore rp2040 ora ha una soluzione alternativa per l'errata USB \"rp2040-e5\". Ci\u00f2 dovrebbe rendere pi\u00f9 affidabili le connessioni USB iniziali. Tuttavia, potrebbe comportare un cambiamento nel comportamento del pin gpio15. \u00c8 improbabile che il cambiamento di comportamento di gpio15 sia evidente. 20220407: l'opzione di configurazione temperature_fan pid_integral_max \u00e8 stata rimossa (era deprecata su 20210612). 20220407: L'ordine dei colori predefinito per i LED pca9632 \u00e8 ora \"RGBW\". Aggiungi un'impostazione esplicita color_order: RBGW alla sezione di configurazione di pca9632 per ottenere il comportamento precedente. 20220330: Il formato delle informazioni di stato printer.neopixel.color_data per i moduli neopixel e dotstar \u00e8 cambiato. Le informazioni sono ora memorizzate come un elenco di elenchi di colori (invece di un elenco di dizionari). Per i dettagli, vedere il riferimento dello stato . 20220307: M73 non imposter\u00e0 pi\u00f9 l'avanzamento della stampa su 0 se manca P . 20220304: Non esiste pi\u00f9 un valore predefinito per il parametro extruder delle sezioni di configurazione extruder_stepper . Se lo si desidera, specificare esplicitamente extruder: extruder per associare il motore passo-passo alla coda di movimento \"estrusore\" all'avvio. 20220210: Il comando SYNC_STEPPER_TO_EXTRUDER \u00e8 deprecato; il comando SET_EXTRUDER_STEP_DISTANCE \u00e8 deprecato; l'opzione di configurazione extruder shared_heater \u00e8 deprecata. Queste funzionalit\u00e0 verranno rimosse nel prossimo futuro. Sostituisci SET_EXTRUDER_STEP_DISTANCE con SET_EXTRUDER_ROTATION_DISTANCE . Sostituisci SYNC_STEPPER_TO_EXTRUDER con SYNC_EXTRUDER_MOTION . Sostituisci le sezioni di configurazione dell'estrusore usando shared_heater con le sezioni di configurazione extruder_stepper e aggiorna le macro di attivazione per usare SYNC_EXTRUDER_MOTION . 20220116: Il codice di calcolo della run_current per tmc2130, tmc2208, tmc2209 e tmc2660 \u00e8 cambiato. Per alcune impostazioni di run_current i driver possono ora essere configurati in modo diverso. Questa nuova configurazione dovrebbe essere pi\u00f9 accurata, ma potrebbe invalidare la precedente ottimizzazione del driver tmc. 20211230: Gli script per ottimizzare l'input shaper ( scripts/calibrate_shaper.py e scripts/graph_accelerometer.py ) sono stati migrati per utilizzare Python3 per impostazione predefinita. Di conseguenza, gli utenti devono installare le versioni Python3 di determinati pacchetti (ad esempio sudo apt install python3-numpy python3-matplotlib ) per continuare a utilizzare questi script. Per maggiori dettagli, fare riferimento a Installazione del software . In alternativa, gli utenti possono forzare temporaneamente l'esecuzione di questi script in Python 2 chiamando esplicitamente l'interprete Python2 nella console: python2 ~/klipper/scripts/calibrate_shaper.py ... 20211110: Il sensore di temperatura \"NTC 100K beta 3950\" \u00e8 obsoleto. Questo sensore verr\u00e0 rimosso nel prossimo futuro. La maggior parte degli utenti trover\u00e0 il sensore di temperatura \"Generico 3950\" pi\u00f9 accurato. Per continuare a utilizzare la definizione precedente (in genere meno accurata), definire un termistore personalizzato con temperature1: 25 , resistance1: 100000 e beta: 3950 . 20211104: L'opzione \"step pulse duration\" in \"make menuconfig\" \u00e8 stata rimossa. La durata del passaggio predefinita per i driver TMC configurati in modalit\u00e0 UART o SPI \u00e8 ora di 100 ns. Una nuova impostazione step_pulse_duration nella sezione stepper config dovrebbe essere impostata per tutti gli stepper che necessitano di una durata dell'impulso personalizzata. 20211102: diverse funzionalit\u00e0 deprecate sono state rimosse. L'opzione stepper step_distance \u00e8 stata rimossa (obsoleta nel 20201222). L'alias del sensore rpi_temperature \u00e8 stato rimosso (obsoleto il 20210219). L'opzione mcu pin_map \u00e8 stata rimossa (deprecata su 20210325). La gcode_macro default_parameter_<name> e l'accesso macro ai parametri dei comandi diversi dalla pseudo-variabile params sono stati rimossi (deprecato in 20210503). L'opzione del riscaldatore pid_integral_max \u00e8 stata rimossa (obsoleta il 20210612). 20210929: Klipper v0.10.0 rilasciato. 20210903: Il valore predefinito smooth_time per i riscaldatori \u00e8 cambiato in 1 secondo (da 2 secondi). Per la maggior parte delle stampanti ci\u00f2 si tradurr\u00e0 in un controllo della temperatura pi\u00f9 stabile. 20210830: il nome adxl345 predefinito \u00e8 ora \"adxl345\". Il parametro CHIP predefinito per ACCELEROMETER_MEASURE e ACCELEROMETER_QUERY ora \u00e8 \"adxl345\". 20210830: il comando adxl345 ACCELEROMETER_MEASURE non supporta pi\u00f9 un parametro RATE. Per modificare la frequenza delle query, aggiornare il file printer.cfg ed eseguire un comando RESTART. 20210821: Diverse impostazioni di configurazione in printer.configfile.settings verranno ora riportate come elenchi anzich\u00e9 come stringhe grezze. Se si desidera la stringa grezza effettiva, utilizzare invece printer.configfile.config . 20210819: In alcuni casi, un movimento di riferimento G28 pu\u00f2 terminare in una posizione che \u00e8 nominalmente al di fuori dell'intervallo di movimento valido. In rare situazioni ci\u00f2 pu\u00f2 causare errori di \"spostamento fuori portata\" confusi dopo l'homing. In tal caso, modificare gli script di avvio per spostare la testa utensile in una posizione valida subito dopo l'homing. 20210814: Gli pseudo-pin solo analogici su atmega168 e atmega328 sono stati rinominati da PE0/PE1 a PE2/PE3. 20210720: una sezione controller_fan ora monitora tutti i motori passo-passo per impostazione predefinita (non solo i motori passo-passo cinematici). Se si desidera il comportamento precedente, vedere l'opzione di configurazione stepper nel riferimento di configurazione . 20210703: Una sezione di configurazione samd_sercom deve ora specificare il bus sercom che sta configurando tramite l'opzione sercom . 20210612: L'opzione di configurazione pid_integral_max nelle sezioni riscaldatore e temperature_fan \u00e8 obsoleta. L'opzione verr\u00e0 rimossa nel prossimo futuro. 20210503: The gcode_macro default_parameter_<name> config option is deprecated. Use the params pseudo-variable to access macro parameters. Other methods for accessing macro parameters will be removed in the near future. Most users can replace a default_parameter_NAME: VALUE config option with a line like the following in the start of the macro: {% set NAME = params.NAME|default(VALUE)|float %} . See the Command Templates document for examples. 20210430: il comando SET_VELOCITY_LIMIT (e M204) ora pu\u00f2 impostare una velocit\u00e0, un'accelerazione e una square_corner_velocity maggiori dei valori specificati nel file di configurazione. 20210325: il supporto per l'opzione di configurazione pin_map \u00e8 deprecato. Utilizzare il file sample-aliases.cfg per tradurre i nomi dei pin del microcontroller effettivi. L'opzione di configurazione pin_map verr\u00e0 rimossa nel prossimo futuro. 20210313: Il supporto di Klipper per i microcontrollori che comunicano con il bus CAN \u00e8 cambiato. Se si utilizza il bus CAN, \u00e8 necessario eseguire nuovamente il flashing di tutti i microcontrollori e la configurazione di Klipper deve essere aggiornata . 20210310: Il valore predefinito TMC2660 per driver_SFILT \u00e8 stato modificato da 1 a 0. 20210227: I driver del motore passo-passo TMC in modalit\u00e0 UART o SPI ora vengono interrogati una volta al secondo ogni volta che sono abilitati - se il driver non pu\u00f2 essere contattato o se il driver segnala un errore, Klipper passer\u00e0 allo stato di spegnimento. 20210219: Il modulo rpi_temperature \u00e8 stato rinominato in temperature_host . Sostituisci tutte le occorrenze di sensor_type: rpi_temperature con sensor_type: temperature_host . Il percorso del file di temperatura pu\u00f2 essere specificato nella variabile di configurazione sensor_path . Il nome rpi_temperature \u00e8 deprecato e verr\u00e0 rimosso nel prossimo futuro. 20210201: Il comando TEST_RESONANCES ora disabiliter\u00e0 l'input shaping se era stato precedentemente abilitato (e lo riattiver\u00e0 dopo il test). Per ignorare questo comportamento e mantenere abilitato lo shaping dell'input, \u00e8 possibile passare un parametro aggiuntivo INPUT_SHAPING=1 al comando. 20210201: Il comando ACCELEROMETER_MEASURE aggiunger\u00e0 ora il nome del chip dell'accelerometro al nome del file di output se al chip \u00e8 stato assegnato un nome nella corrispondente sezione adxl345 di printer.cfg. 20201222: L'impostazione step_distance nelle sezioni di configurazione dello stepper \u00e8 obsoleta. Si consiglia di aggiornare la configurazione per utilizzare l'impostazione rotation_distance . Il supporto per step_distance verr\u00e0 rimosso nel prossimo futuro. 20201218: L'impostazione endstop_phase nel modulo endstop_phase \u00e8 stata sostituita con trigger_phase . Se si utilizza il modulo fasi endstop, sar\u00e0 necessario convertire in rotation_distance e ricalibrare eventuali fasi endstop eseguendo il comando ENDSTOP_PHASE_CALIBRATE. 20201218: le stampanti rotanti delta e polari ora devono specificare un gear_ratio per i loro stepper rotanti e potrebbero non specificare pi\u00f9 un parametro step_distance . Vedere il riferimento di configurazione per il formato del nuovo parametro gear_ratio. 20201213: Non \u00e8 valido specificare una Z \"position_endstop\" quando si utilizza \"probe:z_virtual_endstop\". Verr\u00e0 ora generato un errore se viene specificata una Z \"position_endstop\" con \"probe:z_virtual_endstop\". Rimuovere la definizione Z \"position_endstop\" per correggere l'errore. 20201120: La sezione di configurazione [board_pins] ora specifica il nome mcu in un parametro esplicito mcu: . Se si utilizza board_pins per un mcu secondario, \u00e8 necessario aggiornare la configurazione per specificare quel nome. Vedere il riferimento di configurazione per ulteriori dettagli. 20201112: Il tempo riportato da print_stats.print_duration \u00e8 cambiato. La durata precedente alla prima estrusione rilevata \u00e8 ora esclusa. 20201029: L'opzione di configurazione color_order_GRB di neopixel \u00e8 stata rimossa. Se necessario, aggiorna la configurazione per impostare la nuova opzione color_order su RGB, GRB, RGBW o GRBW. 20201029: L'opzione seriale nella sezione di configurazione di mcu non \u00e8 pi\u00f9 impostata su /dev/ttyS0. Nella rara situazione in cui /dev/ttyS0 \u00e8 la porta seriale desiderata, deve essere specificata esplicitamente. 20201020: Klipper v0.9.0 rilasciato. 20200902: Il calcolo della resistenza-to-temperatura dell'RTD per i convertitori MAX31865 \u00e8 stato corretto in modo che non fosse basso. Se si utilizza un dispositivo di questo tipo, \u00e8 necessario ricalibrare la temperatura di stampa e le impostazioni PID. 20200816: L'oggetto printer.gcode della macro gcode \u00e8 stato rinominato in printer.gcode_move . Diverse variabili non documentate in printer.toolhead e printer.gcode sono state rimosse. Vedere docs/Command_Templates.md per un elenco delle variabili di modello disponibili. 20200816: Il sistema \"action_\" della macro gcode \u00e8 cambiato. Sostituisci tutte le chiamate a printer.gcode.action_emergency_stop() con action_emergency_stop() , printer.gcode.action_respond_info() con action_respond_info() e printer.gcode.action_respond_error() con action_raise_error( ) . 20200809: Il sistema di menu \u00e8 stato riscritto. Se il menu \u00e8 stato personalizzato sar\u00e0 necessario aggiornare alla nuova configurazione. Vedere config/example-menu.cfg per i dettagli di configurazione e vedere klippy/extras/display/menu.cfg per esempi. 20200731: Il comportamento dell'attributo progress riportato dall'oggetto stampante virtual_sdcard \u00e8 cambiato. L'avanzamento non viene pi\u00f9 reimpostato su 0 quando una stampa viene sospesa. Ora riporter\u00e0 sempre lo stato di avanzamento in base alla posizione interna del file o 0 se nessun file \u00e8 attualmente caricato. 20200725: Il parametro di configurazione servo enable e il parametro SET_SERVO ENABLE sono stati rimossi. Aggiorna qualsiasi macro per usare SET_SERVO SERVO=my_servo WIDTH=0 per disabilitare un servo. 20200608: Il supporto del display LCD ha cambiato il nome di alcuni \"glifi\" interni. Se \u00e8 stato implementato un layout di visualizzazione personalizzato, potrebbe essere necessario aggiornare ai nomi dei glifi pi\u00f9 recenti (consultare klippy/extras/display/display.cfg per un elenco dei glifi disponibili). 20200606: i nomi dei pin su Linux Mcu sono cambiati. I pin ora hanno nomi nella forma gpiochip<chipid>/gpio<gpio> . Per gpiochip0 puoi anche usare un breve gpio<gpio> . Ad esempio, ci\u00f2 che prima veniva chiamato P20 ora diventa gpio20 o gpiochip0/gpio20 . 20200603: il layout LCD 16x4 predefinito non mostrer\u00e0 pi\u00f9 il tempo rimanente stimato in una stampa. (Verr\u00e0 mostrato solo il tempo trascorso.) Se si desidera il vecchio comportamento, \u00e8 possibile personalizzare la visualizzazione del menu con tali informazioni (vedere la descrizione di display_data in config/example-extras.cfg per i dettagli). 20200531: l'ID prodotto/fornitore USB predefinito \u00e8 ora 0x1d50/0x614e. Questi nuovi ID sono riservati a Klipper (grazie al progetto openmoko). Questa modifica non dovrebbe richiedere alcuna modifica alla configurazione, ma i nuovi ID potrebbero essere visualizzati nei registri di sistema. 20200524: Il valore predefinito per il campo tmc5160 pwm_freq \u00e8 ora zero (anzich\u00e9 uno). 20200425: La variabile del modello di comando gcode_macro printer.heater \u00e8 stata rinominata printer.heaters . 20200313: Il layout lcd predefinito per le stampanti multiestrusore con schermo 16x4 \u00e8 cambiato. Il layout dello schermo del singolo estrusore \u00e8 ora quello predefinito e mostrer\u00e0 l'estrusore attualmente attivo. Per utilizzare il layout di visualizzazione precedente, impostare \"display_group: _multiextruder_16x4\" nella sezione [display] del file printer.cfg. 20200308: La voce di menu predefinita __test \u00e8 stata rimossa. Se il file di configurazione ha un menu personalizzato, assicurati di rimuovere tutti i riferimenti a questa voce di menu __test . 20200308: le opzioni del menu \"deck\" e \"card\" sono state rimosse. Per personalizzare il layout di uno schermo lcd utilizzare le nuove sezioni display_data config (vedi config/example-extras.cfg per i dettagli). 20200109: Il modulo bed_mesh ora fa riferimento alla posizione della sonda per la configurazione della mesh. Pertanto, alcune opzioni di configurazione sono state rinominate per riflettere in modo pi\u00f9 accurato la funzionalit\u00e0 prevista. Per i piatti rettangolari, min_point e max_point sono stati rinominati rispettivamente in mesh_min e mesh_max . Per i piatti rotondi, bed_radius \u00e8 stato rinominato in mesh_radius . \u00c8 stata aggiunta anche una nuova opzione mesh_origin per i piatti rotondi. Si noti che queste modifiche sono anche incompatibili con i profili mesh salvati in precedenza. Se viene rilevato un profilo incompatibile, verr\u00e0 ignorato e pianificato per la rimozione. Il processo di rimozione pu\u00f2 essere completato emettendo il comando SAVE_CONFIG. L'utente dovr\u00e0 ricalibrare ogni profilo. 20191218: la sezione di configurazione del display non supporta pi\u00f9 \"lcd_type: st7567\". Usa invece il tipo di visualizzazione \"uc1701\" - imposta \"lcd_type: uc1701\" e cambia \"rs_pin: some_pin\" in \"rst_pin: some_pin\". Potrebbe anche essere necessario aggiungere un'impostazione di configurazione \"contrasto: 60\". 20191210: I comandi integrati T0, T1, T2, ... sono stati rimossi. Le opzioni di configurazione activate_gcode e deactivate_gcode dell'estrusore sono state rimosse. Se questi comandi (e script) sono necessari, definire le singole macro di stile [gcode_macro T0] che chiamano il comando ACTIVATE_EXTRUDER. Vedere i file config/sample-idex.cfg e sample-multi-extruder.cfg per esempi. 20191210: il supporto per il comando M206 \u00e8 stato rimosso. Sostituisci con chiamate a SET_GCODE_OFFSET. Se \u00e8 necessario il supporto per M206, aggiungere una sezione di configurazione [gcode_macro M206] che richiami SET_GCODE_OFFSET. (Ad esempio \"SET_GCODE_OFFSET Z=-{params.Z}\".) 20191202: il supporto per il parametro \"S\" non documentato del comando \"G4\" \u00e8 stato rimosso. Sostituire eventuali occorrenze di S con il parametro \"P\" standard (il ritardo specificato in millisecondi). 20191126: i nomi USB sono cambiati sui microcontrollori con supporto USB nativo. Ora usano un ID chip univoco per impostazione predefinita (ove disponibile). Se una sezione di configurazione \"mcu\" utilizza un'impostazione \"serial\" che inizia con \"/dev/serial/by-id/\", potrebbe essere necessario aggiornare la configurazione. Esegui \"ls /dev/serial/by-id/*\" in un terminale ssh per determinare il nuovo ID. 20191121: il parametro pressure_advance_lookahead_time \u00e8 stato rimosso. Vedere example.cfg per impostazioni di configurazione alternative. 20191112: la funzionalit\u00e0 di abilitazione virtuale del driver stepper tmc \u00e8 ora abilitata automaticamente se lo stepper non dispone di un pin di abilitazione stepper dedicato. Rimuovere i riferimenti a tmcXXXX:virtual_enable dal file config. La possibilit\u00e0 di controllare pi\u00f9 pin nella configurazione stepper enable_pin \u00e8 stata rimossa. Se sono necessari pi\u00f9 pin, utilizzare una sezione di configurazione multi_pin. 20191107: La sezione di configurazione dell'estrusore primario deve essere specificata come \"extruder\" e non pu\u00f2 pi\u00f9 essere specificata come \"extruder0\". I modelli di comando Gcode che richiedono lo stato dell'estrusore sono ora accessibili tramite \"{printer.extruder}\". 20191021: Klipper v0.8.0 rilasciato 20191003: L'opzione move_to_previous in [safe_z_homing] ora \u00e8 impostata su False. (Era effettivamente Falso prima del 20190918.) 20190918: L'opzione zhop in [safe_z_homing] viene sempre riapplicata dopo il completamento dell'homing dell'asse Z. Ci\u00f2 potrebbe richiedere agli utenti di aggiornare gli script personalizzati basati su questo modulo. 20190806: Il comando SET_NEOPIXEL \u00e8 stato rinominato in SET_LED. 20190726: il codice del dac mcp4728 \u00e8 cambiato. L'indirizzo i2c predefinito \u00e8 ora 0x60 e il riferimento di tensione \u00e8 ora relativo al riferimento interno di 2,048 volt del mcp4728. 20190710: l'opzione z_hop \u00e8 stata rimossa dalla sezione di configurazione [firmware_retract]. Il supporto z_hop era incompleto e potrebbe causare un comportamento errato con diversi filtri dei dati comuni. 20190710: I parametri opzionali del comando PROBE_ACCURACY sono stati modificati. Potrebbe essere necessario aggiornare eventuali macro o script che utilizzano quel comando. 20190628: tutte le opzioni di configurazione sono state rimosse dalla sezione [skew_correction]. La configurazione per skew_correction viene ora eseguita tramite il gcode SET_SKEW. Vedere Correzione inclinazione per l'utilizzo consigliato. 20190607: I parametri \"variable_X\" di gcode_macro (insieme al parametro VALUE di SET_GCODE_VARIABLE) vengono ora analizzati come valori literals di Python. Se \u00e8 necessario assegnare un valore a una stringa, racchiudere il valore tra virgolette in modo che venga valutato come una stringa. 20190606: le opzioni di configurazione \"samples\", \"samples_result\" e \"sample_retract_dist\" sono state spostate nella sezione di configurazione \"probe\". Queste opzioni non sono pi\u00f9 supportate nelle sezioni di configurazione \"delta_calibrate\", \"bed_tilt\", \"bed_mesh\", \"screws_tilt_adjust\", \"z_tilt\" o \"quad_gantry_level\". 20190528: La variabile magica \"status\" nella valutazione del modello gcode_macro \u00e8 stata rinominata \"printer\". 20190520: Il comando SET_GCODE_OFFSET \u00e8 stato modificato; aggiorna tutte le macro del codice g di conseguenza. Il comando non applicher\u00e0 pi\u00f9 l'offset richiesto al successivo comando G1. Il vecchio comportamento pu\u00f2 essere approssimato utilizzando il nuovo parametro \"MOVE=1\". 20190404: i pacchetti software host Python sono stati aggiornati. Gli utenti dovranno eseguire nuovamente lo script ~/klipper/scripts/install-octopi.sh (o in altro modo aggiornare le dipendenze di Python se non si utilizza un'installazione OctoPi standard). 20190404: I parametri i2c_bus e spi_bus (in varie sezioni di configurazione) ora prendono un nome bus anzich\u00e9 un numero. 20190404: I parametri di configurazione sx1509 sono stati modificati. Il parametro 'address' ora \u00e8 'i2c_address' e deve essere specificato come numero decimale. Dove 0x3E \u00e8 stato utilizzato in precedenza, specificare 62. 20190328: Il valore min_speed nella configurazione [temperature_fan] verr\u00e0 ora rispettato e la ventola funzioner\u00e0 sempre a questa velocit\u00e0 o superiore in modalit\u00e0 PID. 20190322: il valore predefinito per \"driver_HEND\" nelle sezioni di configurazione [tmc2660] \u00e8 stato modificato da 6 a 3. Il campo \"driver_VSENSE\" \u00e8 stato rimosso (ora viene calcolato automaticamente da run_current). 20190310: La sezione di configurazione [controller_fan] ora prende sempre un nome (come [controller_fan my_controller_fan]). 20190308: Il campo \"driver_BLANK_TIME_SELECT\" nelle sezioni di configurazione [tmc2130] e [tmc2208] \u00e8 stato rinominato in \"driver_TBL\". 20190308: la sezione di configurazione [tmc2660] \u00e8 stata modificata. Ora deve essere fornito un nuovo parametro di configurazione sense_resistor. Il significato di molti dei parametri driver_XXX \u00e8 cambiato. 20190228: gli utenti di SPI o I2C su schede SAMD21 devono ora specificare i pin del bus tramite una sezione di configurazione [samd_sercom]. 20190224: l'opzione bed_shape \u00e8 stata rimossa da bed_mesh. L'opzione raggio \u00e8 stata rinominata bed_radius. Gli utenti con letti rotondi dovrebbero fornire le opzioni bed_radius e round_probe_count. 20190107: il parametro i2c_address nella sezione di configurazione mcp4451 \u00e8 stato modificato. Questa \u00e8 un'impostazione comune su Smoothieboards. Il nuovo valore \u00e8 la met\u00e0 del vecchio valore (88 dovrebbe essere cambiato in 44 e 90 dovrebbe essere cambiato in 45). 20181220: Klipper v0.7.0 rilasciato","title":"Modifiche alla configurazione"},{"location":"Config_Changes.html#modifiche-alla-configurazione","text":"Questo documento copre le modifiche software recenti al file di configurazione che non sono compatibili con le versioni precedenti. \u00c8 una buona idea rivedere questo documento durante l'aggiornamento del software Klipper. Tutte le date in questo documento sono approssimative.","title":"Modifiche alla configurazione"},{"location":"Config_Changes.html#cambiamenti","text":"20230201: The [bed_mesh] module no longer loads the default profile on startup. It is recommended that users who use the default profile add BED_MESH_PROFILE LOAD=default to their START_PRINT macro (or to their slicer's \"Start G-Code\" configuration when applicable). 20230103: It is now possible with the flash-sdcard.sh script to flash both variants of the Bigtreetech SKR-2, STM32F407 and STM32F429. This means that the original tag of btt-skr2 now has changed to either btt-skr-2-f407 or btt-skr-2-f429. 20221128: Klipper v0.11.0 released. 20221122: In precedenza, con safe_z_home, era possibile che z_hop dopo l'homing g28 andasse nella direzione z negativa. Ora, uno z_hop viene eseguito dopo g28 solo se risulta in un hop positivo, rispecchiando il comportamento dello z_hop che si verifica prima dell'homing g28. 20220616: in precedenza era possibile eseguire il flashing di un rp2040 in modalit\u00e0 bootloader eseguendo make flash FLASH_DEVICE=first . Il comando equivalente \u00e8 ora make flash FLASH_DEVICE=2e8a:0003 . 20220612: Il microcontrollore rp2040 ora ha una soluzione alternativa per l'errata USB \"rp2040-e5\". Ci\u00f2 dovrebbe rendere pi\u00f9 affidabili le connessioni USB iniziali. Tuttavia, potrebbe comportare un cambiamento nel comportamento del pin gpio15. \u00c8 improbabile che il cambiamento di comportamento di gpio15 sia evidente. 20220407: l'opzione di configurazione temperature_fan pid_integral_max \u00e8 stata rimossa (era deprecata su 20210612). 20220407: L'ordine dei colori predefinito per i LED pca9632 \u00e8 ora \"RGBW\". Aggiungi un'impostazione esplicita color_order: RBGW alla sezione di configurazione di pca9632 per ottenere il comportamento precedente. 20220330: Il formato delle informazioni di stato printer.neopixel.color_data per i moduli neopixel e dotstar \u00e8 cambiato. Le informazioni sono ora memorizzate come un elenco di elenchi di colori (invece di un elenco di dizionari). Per i dettagli, vedere il riferimento dello stato . 20220307: M73 non imposter\u00e0 pi\u00f9 l'avanzamento della stampa su 0 se manca P . 20220304: Non esiste pi\u00f9 un valore predefinito per il parametro extruder delle sezioni di configurazione extruder_stepper . Se lo si desidera, specificare esplicitamente extruder: extruder per associare il motore passo-passo alla coda di movimento \"estrusore\" all'avvio. 20220210: Il comando SYNC_STEPPER_TO_EXTRUDER \u00e8 deprecato; il comando SET_EXTRUDER_STEP_DISTANCE \u00e8 deprecato; l'opzione di configurazione extruder shared_heater \u00e8 deprecata. Queste funzionalit\u00e0 verranno rimosse nel prossimo futuro. Sostituisci SET_EXTRUDER_STEP_DISTANCE con SET_EXTRUDER_ROTATION_DISTANCE . Sostituisci SYNC_STEPPER_TO_EXTRUDER con SYNC_EXTRUDER_MOTION . Sostituisci le sezioni di configurazione dell'estrusore usando shared_heater con le sezioni di configurazione extruder_stepper e aggiorna le macro di attivazione per usare SYNC_EXTRUDER_MOTION . 20220116: Il codice di calcolo della run_current per tmc2130, tmc2208, tmc2209 e tmc2660 \u00e8 cambiato. Per alcune impostazioni di run_current i driver possono ora essere configurati in modo diverso. Questa nuova configurazione dovrebbe essere pi\u00f9 accurata, ma potrebbe invalidare la precedente ottimizzazione del driver tmc. 20211230: Gli script per ottimizzare l'input shaper ( scripts/calibrate_shaper.py e scripts/graph_accelerometer.py ) sono stati migrati per utilizzare Python3 per impostazione predefinita. Di conseguenza, gli utenti devono installare le versioni Python3 di determinati pacchetti (ad esempio sudo apt install python3-numpy python3-matplotlib ) per continuare a utilizzare questi script. Per maggiori dettagli, fare riferimento a Installazione del software . In alternativa, gli utenti possono forzare temporaneamente l'esecuzione di questi script in Python 2 chiamando esplicitamente l'interprete Python2 nella console: python2 ~/klipper/scripts/calibrate_shaper.py ... 20211110: Il sensore di temperatura \"NTC 100K beta 3950\" \u00e8 obsoleto. Questo sensore verr\u00e0 rimosso nel prossimo futuro. La maggior parte degli utenti trover\u00e0 il sensore di temperatura \"Generico 3950\" pi\u00f9 accurato. Per continuare a utilizzare la definizione precedente (in genere meno accurata), definire un termistore personalizzato con temperature1: 25 , resistance1: 100000 e beta: 3950 . 20211104: L'opzione \"step pulse duration\" in \"make menuconfig\" \u00e8 stata rimossa. La durata del passaggio predefinita per i driver TMC configurati in modalit\u00e0 UART o SPI \u00e8 ora di 100 ns. Una nuova impostazione step_pulse_duration nella sezione stepper config dovrebbe essere impostata per tutti gli stepper che necessitano di una durata dell'impulso personalizzata. 20211102: diverse funzionalit\u00e0 deprecate sono state rimosse. L'opzione stepper step_distance \u00e8 stata rimossa (obsoleta nel 20201222). L'alias del sensore rpi_temperature \u00e8 stato rimosso (obsoleto il 20210219). L'opzione mcu pin_map \u00e8 stata rimossa (deprecata su 20210325). La gcode_macro default_parameter_<name> e l'accesso macro ai parametri dei comandi diversi dalla pseudo-variabile params sono stati rimossi (deprecato in 20210503). L'opzione del riscaldatore pid_integral_max \u00e8 stata rimossa (obsoleta il 20210612). 20210929: Klipper v0.10.0 rilasciato. 20210903: Il valore predefinito smooth_time per i riscaldatori \u00e8 cambiato in 1 secondo (da 2 secondi). Per la maggior parte delle stampanti ci\u00f2 si tradurr\u00e0 in un controllo della temperatura pi\u00f9 stabile. 20210830: il nome adxl345 predefinito \u00e8 ora \"adxl345\". Il parametro CHIP predefinito per ACCELEROMETER_MEASURE e ACCELEROMETER_QUERY ora \u00e8 \"adxl345\". 20210830: il comando adxl345 ACCELEROMETER_MEASURE non supporta pi\u00f9 un parametro RATE. Per modificare la frequenza delle query, aggiornare il file printer.cfg ed eseguire un comando RESTART. 20210821: Diverse impostazioni di configurazione in printer.configfile.settings verranno ora riportate come elenchi anzich\u00e9 come stringhe grezze. Se si desidera la stringa grezza effettiva, utilizzare invece printer.configfile.config . 20210819: In alcuni casi, un movimento di riferimento G28 pu\u00f2 terminare in una posizione che \u00e8 nominalmente al di fuori dell'intervallo di movimento valido. In rare situazioni ci\u00f2 pu\u00f2 causare errori di \"spostamento fuori portata\" confusi dopo l'homing. In tal caso, modificare gli script di avvio per spostare la testa utensile in una posizione valida subito dopo l'homing. 20210814: Gli pseudo-pin solo analogici su atmega168 e atmega328 sono stati rinominati da PE0/PE1 a PE2/PE3. 20210720: una sezione controller_fan ora monitora tutti i motori passo-passo per impostazione predefinita (non solo i motori passo-passo cinematici). Se si desidera il comportamento precedente, vedere l'opzione di configurazione stepper nel riferimento di configurazione . 20210703: Una sezione di configurazione samd_sercom deve ora specificare il bus sercom che sta configurando tramite l'opzione sercom . 20210612: L'opzione di configurazione pid_integral_max nelle sezioni riscaldatore e temperature_fan \u00e8 obsoleta. L'opzione verr\u00e0 rimossa nel prossimo futuro. 20210503: The gcode_macro default_parameter_<name> config option is deprecated. Use the params pseudo-variable to access macro parameters. Other methods for accessing macro parameters will be removed in the near future. Most users can replace a default_parameter_NAME: VALUE config option with a line like the following in the start of the macro: {% set NAME = params.NAME|default(VALUE)|float %} . See the Command Templates document for examples. 20210430: il comando SET_VELOCITY_LIMIT (e M204) ora pu\u00f2 impostare una velocit\u00e0, un'accelerazione e una square_corner_velocity maggiori dei valori specificati nel file di configurazione. 20210325: il supporto per l'opzione di configurazione pin_map \u00e8 deprecato. Utilizzare il file sample-aliases.cfg per tradurre i nomi dei pin del microcontroller effettivi. L'opzione di configurazione pin_map verr\u00e0 rimossa nel prossimo futuro. 20210313: Il supporto di Klipper per i microcontrollori che comunicano con il bus CAN \u00e8 cambiato. Se si utilizza il bus CAN, \u00e8 necessario eseguire nuovamente il flashing di tutti i microcontrollori e la configurazione di Klipper deve essere aggiornata . 20210310: Il valore predefinito TMC2660 per driver_SFILT \u00e8 stato modificato da 1 a 0. 20210227: I driver del motore passo-passo TMC in modalit\u00e0 UART o SPI ora vengono interrogati una volta al secondo ogni volta che sono abilitati - se il driver non pu\u00f2 essere contattato o se il driver segnala un errore, Klipper passer\u00e0 allo stato di spegnimento. 20210219: Il modulo rpi_temperature \u00e8 stato rinominato in temperature_host . Sostituisci tutte le occorrenze di sensor_type: rpi_temperature con sensor_type: temperature_host . Il percorso del file di temperatura pu\u00f2 essere specificato nella variabile di configurazione sensor_path . Il nome rpi_temperature \u00e8 deprecato e verr\u00e0 rimosso nel prossimo futuro. 20210201: Il comando TEST_RESONANCES ora disabiliter\u00e0 l'input shaping se era stato precedentemente abilitato (e lo riattiver\u00e0 dopo il test). Per ignorare questo comportamento e mantenere abilitato lo shaping dell'input, \u00e8 possibile passare un parametro aggiuntivo INPUT_SHAPING=1 al comando. 20210201: Il comando ACCELEROMETER_MEASURE aggiunger\u00e0 ora il nome del chip dell'accelerometro al nome del file di output se al chip \u00e8 stato assegnato un nome nella corrispondente sezione adxl345 di printer.cfg. 20201222: L'impostazione step_distance nelle sezioni di configurazione dello stepper \u00e8 obsoleta. Si consiglia di aggiornare la configurazione per utilizzare l'impostazione rotation_distance . Il supporto per step_distance verr\u00e0 rimosso nel prossimo futuro. 20201218: L'impostazione endstop_phase nel modulo endstop_phase \u00e8 stata sostituita con trigger_phase . Se si utilizza il modulo fasi endstop, sar\u00e0 necessario convertire in rotation_distance e ricalibrare eventuali fasi endstop eseguendo il comando ENDSTOP_PHASE_CALIBRATE. 20201218: le stampanti rotanti delta e polari ora devono specificare un gear_ratio per i loro stepper rotanti e potrebbero non specificare pi\u00f9 un parametro step_distance . Vedere il riferimento di configurazione per il formato del nuovo parametro gear_ratio. 20201213: Non \u00e8 valido specificare una Z \"position_endstop\" quando si utilizza \"probe:z_virtual_endstop\". Verr\u00e0 ora generato un errore se viene specificata una Z \"position_endstop\" con \"probe:z_virtual_endstop\". Rimuovere la definizione Z \"position_endstop\" per correggere l'errore. 20201120: La sezione di configurazione [board_pins] ora specifica il nome mcu in un parametro esplicito mcu: . Se si utilizza board_pins per un mcu secondario, \u00e8 necessario aggiornare la configurazione per specificare quel nome. Vedere il riferimento di configurazione per ulteriori dettagli. 20201112: Il tempo riportato da print_stats.print_duration \u00e8 cambiato. La durata precedente alla prima estrusione rilevata \u00e8 ora esclusa. 20201029: L'opzione di configurazione color_order_GRB di neopixel \u00e8 stata rimossa. Se necessario, aggiorna la configurazione per impostare la nuova opzione color_order su RGB, GRB, RGBW o GRBW. 20201029: L'opzione seriale nella sezione di configurazione di mcu non \u00e8 pi\u00f9 impostata su /dev/ttyS0. Nella rara situazione in cui /dev/ttyS0 \u00e8 la porta seriale desiderata, deve essere specificata esplicitamente. 20201020: Klipper v0.9.0 rilasciato. 20200902: Il calcolo della resistenza-to-temperatura dell'RTD per i convertitori MAX31865 \u00e8 stato corretto in modo che non fosse basso. Se si utilizza un dispositivo di questo tipo, \u00e8 necessario ricalibrare la temperatura di stampa e le impostazioni PID. 20200816: L'oggetto printer.gcode della macro gcode \u00e8 stato rinominato in printer.gcode_move . Diverse variabili non documentate in printer.toolhead e printer.gcode sono state rimosse. Vedere docs/Command_Templates.md per un elenco delle variabili di modello disponibili. 20200816: Il sistema \"action_\" della macro gcode \u00e8 cambiato. Sostituisci tutte le chiamate a printer.gcode.action_emergency_stop() con action_emergency_stop() , printer.gcode.action_respond_info() con action_respond_info() e printer.gcode.action_respond_error() con action_raise_error( ) . 20200809: Il sistema di menu \u00e8 stato riscritto. Se il menu \u00e8 stato personalizzato sar\u00e0 necessario aggiornare alla nuova configurazione. Vedere config/example-menu.cfg per i dettagli di configurazione e vedere klippy/extras/display/menu.cfg per esempi. 20200731: Il comportamento dell'attributo progress riportato dall'oggetto stampante virtual_sdcard \u00e8 cambiato. L'avanzamento non viene pi\u00f9 reimpostato su 0 quando una stampa viene sospesa. Ora riporter\u00e0 sempre lo stato di avanzamento in base alla posizione interna del file o 0 se nessun file \u00e8 attualmente caricato. 20200725: Il parametro di configurazione servo enable e il parametro SET_SERVO ENABLE sono stati rimossi. Aggiorna qualsiasi macro per usare SET_SERVO SERVO=my_servo WIDTH=0 per disabilitare un servo. 20200608: Il supporto del display LCD ha cambiato il nome di alcuni \"glifi\" interni. Se \u00e8 stato implementato un layout di visualizzazione personalizzato, potrebbe essere necessario aggiornare ai nomi dei glifi pi\u00f9 recenti (consultare klippy/extras/display/display.cfg per un elenco dei glifi disponibili). 20200606: i nomi dei pin su Linux Mcu sono cambiati. I pin ora hanno nomi nella forma gpiochip<chipid>/gpio<gpio> . Per gpiochip0 puoi anche usare un breve gpio<gpio> . Ad esempio, ci\u00f2 che prima veniva chiamato P20 ora diventa gpio20 o gpiochip0/gpio20 . 20200603: il layout LCD 16x4 predefinito non mostrer\u00e0 pi\u00f9 il tempo rimanente stimato in una stampa. (Verr\u00e0 mostrato solo il tempo trascorso.) Se si desidera il vecchio comportamento, \u00e8 possibile personalizzare la visualizzazione del menu con tali informazioni (vedere la descrizione di display_data in config/example-extras.cfg per i dettagli). 20200531: l'ID prodotto/fornitore USB predefinito \u00e8 ora 0x1d50/0x614e. Questi nuovi ID sono riservati a Klipper (grazie al progetto openmoko). Questa modifica non dovrebbe richiedere alcuna modifica alla configurazione, ma i nuovi ID potrebbero essere visualizzati nei registri di sistema. 20200524: Il valore predefinito per il campo tmc5160 pwm_freq \u00e8 ora zero (anzich\u00e9 uno). 20200425: La variabile del modello di comando gcode_macro printer.heater \u00e8 stata rinominata printer.heaters . 20200313: Il layout lcd predefinito per le stampanti multiestrusore con schermo 16x4 \u00e8 cambiato. Il layout dello schermo del singolo estrusore \u00e8 ora quello predefinito e mostrer\u00e0 l'estrusore attualmente attivo. Per utilizzare il layout di visualizzazione precedente, impostare \"display_group: _multiextruder_16x4\" nella sezione [display] del file printer.cfg. 20200308: La voce di menu predefinita __test \u00e8 stata rimossa. Se il file di configurazione ha un menu personalizzato, assicurati di rimuovere tutti i riferimenti a questa voce di menu __test . 20200308: le opzioni del menu \"deck\" e \"card\" sono state rimosse. Per personalizzare il layout di uno schermo lcd utilizzare le nuove sezioni display_data config (vedi config/example-extras.cfg per i dettagli). 20200109: Il modulo bed_mesh ora fa riferimento alla posizione della sonda per la configurazione della mesh. Pertanto, alcune opzioni di configurazione sono state rinominate per riflettere in modo pi\u00f9 accurato la funzionalit\u00e0 prevista. Per i piatti rettangolari, min_point e max_point sono stati rinominati rispettivamente in mesh_min e mesh_max . Per i piatti rotondi, bed_radius \u00e8 stato rinominato in mesh_radius . \u00c8 stata aggiunta anche una nuova opzione mesh_origin per i piatti rotondi. Si noti che queste modifiche sono anche incompatibili con i profili mesh salvati in precedenza. Se viene rilevato un profilo incompatibile, verr\u00e0 ignorato e pianificato per la rimozione. Il processo di rimozione pu\u00f2 essere completato emettendo il comando SAVE_CONFIG. L'utente dovr\u00e0 ricalibrare ogni profilo. 20191218: la sezione di configurazione del display non supporta pi\u00f9 \"lcd_type: st7567\". Usa invece il tipo di visualizzazione \"uc1701\" - imposta \"lcd_type: uc1701\" e cambia \"rs_pin: some_pin\" in \"rst_pin: some_pin\". Potrebbe anche essere necessario aggiungere un'impostazione di configurazione \"contrasto: 60\". 20191210: I comandi integrati T0, T1, T2, ... sono stati rimossi. Le opzioni di configurazione activate_gcode e deactivate_gcode dell'estrusore sono state rimosse. Se questi comandi (e script) sono necessari, definire le singole macro di stile [gcode_macro T0] che chiamano il comando ACTIVATE_EXTRUDER. Vedere i file config/sample-idex.cfg e sample-multi-extruder.cfg per esempi. 20191210: il supporto per il comando M206 \u00e8 stato rimosso. Sostituisci con chiamate a SET_GCODE_OFFSET. Se \u00e8 necessario il supporto per M206, aggiungere una sezione di configurazione [gcode_macro M206] che richiami SET_GCODE_OFFSET. (Ad esempio \"SET_GCODE_OFFSET Z=-{params.Z}\".) 20191202: il supporto per il parametro \"S\" non documentato del comando \"G4\" \u00e8 stato rimosso. Sostituire eventuali occorrenze di S con il parametro \"P\" standard (il ritardo specificato in millisecondi). 20191126: i nomi USB sono cambiati sui microcontrollori con supporto USB nativo. Ora usano un ID chip univoco per impostazione predefinita (ove disponibile). Se una sezione di configurazione \"mcu\" utilizza un'impostazione \"serial\" che inizia con \"/dev/serial/by-id/\", potrebbe essere necessario aggiornare la configurazione. Esegui \"ls /dev/serial/by-id/*\" in un terminale ssh per determinare il nuovo ID. 20191121: il parametro pressure_advance_lookahead_time \u00e8 stato rimosso. Vedere example.cfg per impostazioni di configurazione alternative. 20191112: la funzionalit\u00e0 di abilitazione virtuale del driver stepper tmc \u00e8 ora abilitata automaticamente se lo stepper non dispone di un pin di abilitazione stepper dedicato. Rimuovere i riferimenti a tmcXXXX:virtual_enable dal file config. La possibilit\u00e0 di controllare pi\u00f9 pin nella configurazione stepper enable_pin \u00e8 stata rimossa. Se sono necessari pi\u00f9 pin, utilizzare una sezione di configurazione multi_pin. 20191107: La sezione di configurazione dell'estrusore primario deve essere specificata come \"extruder\" e non pu\u00f2 pi\u00f9 essere specificata come \"extruder0\". I modelli di comando Gcode che richiedono lo stato dell'estrusore sono ora accessibili tramite \"{printer.extruder}\". 20191021: Klipper v0.8.0 rilasciato 20191003: L'opzione move_to_previous in [safe_z_homing] ora \u00e8 impostata su False. (Era effettivamente Falso prima del 20190918.) 20190918: L'opzione zhop in [safe_z_homing] viene sempre riapplicata dopo il completamento dell'homing dell'asse Z. Ci\u00f2 potrebbe richiedere agli utenti di aggiornare gli script personalizzati basati su questo modulo. 20190806: Il comando SET_NEOPIXEL \u00e8 stato rinominato in SET_LED. 20190726: il codice del dac mcp4728 \u00e8 cambiato. L'indirizzo i2c predefinito \u00e8 ora 0x60 e il riferimento di tensione \u00e8 ora relativo al riferimento interno di 2,048 volt del mcp4728. 20190710: l'opzione z_hop \u00e8 stata rimossa dalla sezione di configurazione [firmware_retract]. Il supporto z_hop era incompleto e potrebbe causare un comportamento errato con diversi filtri dei dati comuni. 20190710: I parametri opzionali del comando PROBE_ACCURACY sono stati modificati. Potrebbe essere necessario aggiornare eventuali macro o script che utilizzano quel comando. 20190628: tutte le opzioni di configurazione sono state rimosse dalla sezione [skew_correction]. La configurazione per skew_correction viene ora eseguita tramite il gcode SET_SKEW. Vedere Correzione inclinazione per l'utilizzo consigliato. 20190607: I parametri \"variable_X\" di gcode_macro (insieme al parametro VALUE di SET_GCODE_VARIABLE) vengono ora analizzati come valori literals di Python. Se \u00e8 necessario assegnare un valore a una stringa, racchiudere il valore tra virgolette in modo che venga valutato come una stringa. 20190606: le opzioni di configurazione \"samples\", \"samples_result\" e \"sample_retract_dist\" sono state spostate nella sezione di configurazione \"probe\". Queste opzioni non sono pi\u00f9 supportate nelle sezioni di configurazione \"delta_calibrate\", \"bed_tilt\", \"bed_mesh\", \"screws_tilt_adjust\", \"z_tilt\" o \"quad_gantry_level\". 20190528: La variabile magica \"status\" nella valutazione del modello gcode_macro \u00e8 stata rinominata \"printer\". 20190520: Il comando SET_GCODE_OFFSET \u00e8 stato modificato; aggiorna tutte le macro del codice g di conseguenza. Il comando non applicher\u00e0 pi\u00f9 l'offset richiesto al successivo comando G1. Il vecchio comportamento pu\u00f2 essere approssimato utilizzando il nuovo parametro \"MOVE=1\". 20190404: i pacchetti software host Python sono stati aggiornati. Gli utenti dovranno eseguire nuovamente lo script ~/klipper/scripts/install-octopi.sh (o in altro modo aggiornare le dipendenze di Python se non si utilizza un'installazione OctoPi standard). 20190404: I parametri i2c_bus e spi_bus (in varie sezioni di configurazione) ora prendono un nome bus anzich\u00e9 un numero. 20190404: I parametri di configurazione sx1509 sono stati modificati. Il parametro 'address' ora \u00e8 'i2c_address' e deve essere specificato come numero decimale. Dove 0x3E \u00e8 stato utilizzato in precedenza, specificare 62. 20190328: Il valore min_speed nella configurazione [temperature_fan] verr\u00e0 ora rispettato e la ventola funzioner\u00e0 sempre a questa velocit\u00e0 o superiore in modalit\u00e0 PID. 20190322: il valore predefinito per \"driver_HEND\" nelle sezioni di configurazione [tmc2660] \u00e8 stato modificato da 6 a 3. Il campo \"driver_VSENSE\" \u00e8 stato rimosso (ora viene calcolato automaticamente da run_current). 20190310: La sezione di configurazione [controller_fan] ora prende sempre un nome (come [controller_fan my_controller_fan]). 20190308: Il campo \"driver_BLANK_TIME_SELECT\" nelle sezioni di configurazione [tmc2130] e [tmc2208] \u00e8 stato rinominato in \"driver_TBL\". 20190308: la sezione di configurazione [tmc2660] \u00e8 stata modificata. Ora deve essere fornito un nuovo parametro di configurazione sense_resistor. Il significato di molti dei parametri driver_XXX \u00e8 cambiato. 20190228: gli utenti di SPI o I2C su schede SAMD21 devono ora specificare i pin del bus tramite una sezione di configurazione [samd_sercom]. 20190224: l'opzione bed_shape \u00e8 stata rimossa da bed_mesh. L'opzione raggio \u00e8 stata rinominata bed_radius. Gli utenti con letti rotondi dovrebbero fornire le opzioni bed_radius e round_probe_count. 20190107: il parametro i2c_address nella sezione di configurazione mcp4451 \u00e8 stato modificato. Questa \u00e8 un'impostazione comune su Smoothieboards. Il nuovo valore \u00e8 la met\u00e0 del vecchio valore (88 dovrebbe essere cambiato in 44 e 90 dovrebbe essere cambiato in 45). 20181220: Klipper v0.7.0 rilasciato","title":"Cambiamenti"},{"location":"Config_Reference.html","text":"Riferimenti configurazione \u00b6 Questo documento \u00e8 un riferimento per le opzioni disponibili nel file di configurazione di Klipper. Le descrizioni in questo documento sono formattate in modo che sia possibile tagliarle e incollarle in un file di configurazione della stampante. Consulta il documento di installazione per informazioni sulla configurazione di Klipper e sulla scelta di un file di configurazione iniziale. Configurazione del microcontrollore \u00b6 Formato dei nomi dei pin del microcontrollore \u00b6 Molte opzioni di configurazione richiedono il nome di un pin del microcontrollore. Klipper usa i nomi hardware per questi pin, ad esempio \"PA4\". I nomi dei pin possono essere preceduti da ! per indicare che deve essere utilizzata una polarit\u00e0 inversa (ad esempio, trigger su basso anzich\u00e9 alto). I pin di input possono essere preceduti da ^ per indicare che un resistore di pull-up hardware deve essere abilitato per il pin. Se il microcontrollore supporta resistori pull-down, un pin di ingresso pu\u00f2 in alternativa essere preceduto da ~ . Nota, alcune sezioni di configurazione potrebbero \"creare\" pin aggiuntivi. Quando ci\u00f2 si verifica, la sezione di configurazione che definisce i pin deve essere elencata nel file di configurazione prima di qualsiasi sezione che utilizza tali pin. [mcu] \u00b6 Configurazione del microcontrollore primario. [mcu] serial: # La porta seriale per la connessione all'MCU. In caso di dubbi (o se # cambia) vedere \"Dov'\u00e8 la mia porta seriale?\" sezione delle FAQ. # Questo parametro deve essere fornito quando si utilizza una # porta seriale. #baud: 250000 # La velocit\u00e0 di trasmissione da utilizzare. Il valore predefinito \u00e8 250000. #canbus_uuid: # Se si utilizza un dispositivo collegato a un bus CAN, questo imposta # l'identificatore univoco del chip a cui connettersi. Questo valore deve # essere fornito quando si utilizza il bus CAN per la comunicazione. #canbus_interface: # Se si utilizza un dispositivo collegato a un bus CAN, viene impostata # l'interfaccia di rete CAN da utilizzare. L'impostazione predefinita \u00e8 'can0'. #restart_method: # Questo controlla il meccanismo che l'host utilizzer\u00e0 per reimpostare # il microcontrollore. Le scelte sono \"arduino\", \"cheetah\", \"rpi_usb\" e # \"command\". Il metodo 'arduino' (attiva/disattiva DTR) \u00e8 comune su # schede Arduino e cloni. Il metodo 'cheetah' \u00e8 un metodo speciale # necessario per alcune schede Fysetc Cheetah. Il metodo \"rpi_usb\" # \u00e8 utile sulle schede Raspberry Pi con microcontrollori alimentati # tramite USB: disabilita brevemente l'alimentazione a tutte le porte # USB per eseguire un ripristino del microcontrollore. Il metodo # \"comando\" prevede l'invio di un comando Klipper al microcontrollore # in modo che possa reimpostarsi. L'impostazione predefinita \u00e8 # 'arduino' se il microcontrollore comunica su una porta seriale, # altrimenti 'comando'. [mcu my_extra_mcu] \u00b6 Microcontrollori aggiuntivi (si pu\u00f2 definire un numero qualsiasi di sezioni con un prefisso \"mcu\"). Microcontrollori aggiuntivi introducono pin aggiuntivi che possono essere configurati come riscaldatori, stepper, ventole, ecc. Ad esempio, se viene introdotta una sezione \"[mcu extra_mcu]\", i pin come \"extra_mcu:ar9\" possono quindi essere utilizzati altrove nella configurazione (dove \"ar9\" \u00e8 un nome pin hardware o un nome alias sul dato mcu). [mcu my_extra_mcu] # Vedere la sezione \"mcu\" per i parametri di configurazione. Impostazioni cinematiche comuni \u00b6 [printer] \u00b6 La sezione printer controlla le impostazioni di alto livello della stampante. [printer] kinematics: # Il tipo di stampante in uso. Questa opzione pu\u00f2 essere una delle # seguenti: cartesian, corexy, corexz, hybrid_corexy, hybrid_corexz, # rotary_delta, delta, deltesian, polar, winch o nessuno. # Questo parametro deve essere specificato. max_velocity: # Velocit\u00e0 massima (in mm/s) della testa di stampa (relativa alla stampa). # Questo parametro deve essere specificato. max_accel: # Accelerazione massima (in mm/s^2) della testina (relativa alla stampa). # Questo parametro deve essere specificato. #max_accel_to_decel: # Una pseudo accelerazione (in mm/s^2) che controlla la velocit\u00e0 con cui # la testa di stampa pu\u00f2 passare dall'accelerazione alla decelerazione. Viene # utilizzato per ridurre la velocit\u00e0 massima di brevi movimenti a zig-zag # (e quindi ridurre le vibrazioni della stampante dovute a questi movimenti). # Il valore predefinito \u00e8 met\u00e0 di max_accel. #square_corner_velocity: 5.0 # La velocit\u00e0 massima (in mm/s) alla quale la testa di stampa pu\u00f2 viaggiare # su un angolo di 90 gradi. Un valore diverso da zero pu\u00f2 ridurre le variazioni # delle portate dell'estrusore consentendo variazioni istantanee della velocit\u00e0 # della testa utensile durante le curve. Questo valore configura l'algoritmo # interno di cornering della velocit\u00e0 centripeta; gli angoli con angoli maggiori # di 90 gradi avranno una velocit\u00e0 in curva maggiore mentre gli angoli con # angoli inferiori a 90 gradi avranno una velocit\u00e0 in curva inferiore. Se questo # \u00e8 impostato su zero, la testa utensile decelerer\u00e0 fino a zero ad ogni angolo. # Il valore predefinito \u00e8 5 mm/s. [stepper] \u00b6 Definizioni di motori passo-passo. Diversi tipi di stampante (come specificato dall'opzione \"cinematica\" nella sezione di configurazione [stampante]) richiedono nomi diversi per lo stepper (ad esempio, stepper_x vs stepper_a ). Di seguito sono riportate le definizioni comuni di stepper. Vedere il documento distanza di rotazione per informazioni sul calcolo del parametro rotation_distance . Consultare il documento Multi-MCU homing per informazioni sull'homing utilizzando pi\u00f9 microcontrollori. [stepper_x] step_pin: # Pin GPIO Step (attivato in alto) . Questo parametro deve essere fornito. dir_pin: # Pin GPIO di direzione (alto indica una direzione positiva). # Questo parametro deve essere fornito. enable_pin: # Pin GPIO di abilitazione (l'impostazione predefinita \u00e8 abilita alto; usa ! # per indicare abilita basso). Se questo parametro non viene fornito, il # driver del motore passo-passo deve essere sempre abilitato. rotation_distance: # Distanza (in mm) che l'asse percorre con una rotazione completa del # motore passo-passo (o viene specificata la marcia finale del rapporto di # trasmissione). Questo parametro deve essere fornito. microsteps: # Il numero di micropassi utilizzati dal driver del motore passo-passo. # Questo parametro deve essere fornito. #full_steps_per_rotation: 200 # Il numero di passi completi per una rotazione del motore passo-passo. # Impostarlo su 200 per un motore passo-passo da 1.8 gradi o su 400 per # un motore da 0.9 gradi. Il valore predefinito \u00e8 200. #gear_ratio: # Il rapporto di trasmissione se il motore passo-passo \u00e8 collegato all'asse # tramite un riduttore. Ad esempio, si pu\u00f2 specificare \"5:1\" se \u00e8 in uso un # riduttore 5 a 1. Se l'asse ha pi\u00f9 riduttori, \u00e8 possibile specificare un elenco # di rapporti di trasmissione separati da virgole (ad esempio, \"57:11, 2:1\"). # Se viene specificato gear_ratio, rotation_distance specifica la distanza # percorsa dall'asse per una rotazione completa dell'ingranaggio finale. # L'impostazione predefinita \u00e8 di non utilizzare un rapporto di trasmissione. #step_pulse_duration: # Il tempo minimo tra il fronte del segnale dell'impulso del passo e il # successivo fronte del segnale \"non passo\". Viene utilizzato anche per # impostare il tempo minimo tra un impulso di passo e un segnale di cambio # di direzione. L'impostazione predefinita \u00e8 0.000000100 (100ns) per gli # stepper TMC configurati in modalit\u00e0 UART o SPI e l'impostazione # predefinita \u00e8 0.000002 (che \u00e8 2us) per tutti gli altri stepper. endstop_pin: # Pin di rilevamento interruttore di fine corsa. Se questo pin di fine corsa # si trova su un mcu diverso dal motore passo-passo, abilita il # \"homing multi-mcu\". Questo parametro deve essere fornito per gli # stepper X, Y e Z su stampanti in stile cartesiano. #position_min: 0 # Distanza minima valida (in mm) alla quale l'utente pu\u00f2 comandare # il movimento dello stepper. Il valore predefinito \u00e8 0 mm. position_endstop: # Posizione del finecorsa (in mm). Questo parametro deve essere fornito # per gli stepper X, Y e Z su stampanti in stile cartesiano. position_max: # Distanza massima valida (in mm) alla quale l'utente pu\u00f2 comandare lo # spostamento dello stepper. Questo parametro deve essere fornito per # gli stepper X, Y e Z su stampanti in stile cartesiano. #homing_speed: 5.0 # Velocit\u00e0 massima (in mm/s) dello stepper durante l'homing. # Il valore predefinito \u00e8 5 mm/s. #homing_retract_dist: 5.0 # Distanza dall'arretramento (in mm) prima della corsa di riferimento # una seconda volta durante la corsa di riferimento. Impostalo a zero per # disabilitare la seconda casa. Il valore predefinito \u00e8 5 mm. #homing_retract_speed: # Velocit\u00e0 da utilizzare nella corsa di ritorno dopo l'homing nel caso in # cui questa dovesse essere diversa dalla velocit\u00e0 di homing, che \u00e8 # l'impostazione predefinita per questo parametro #second_homing_speed: # Velocit\u00e0 (in mm/s) dello stepper durante l'esecuzione del secondo # homing. L'impostazione predefinita \u00e8 homing_speed/2. #homing_positive_dir: # Se true, l'homing far\u00e0 muovere lo stepper in una direzione positiva # (allontanandosi da zero); se falso, home verso zero. \u00c8 meglio utilizzare # l'impostazione predefinita piuttosto che specificare questo parametro. # Il valore predefinito \u00e8 true se position_endstop \u00e8 vicino a position_max # false se vicino a position_min. Cinematica cartesiana \u00b6 Vedere example-cartesian.cfg per un file di configurazione della cinematica cartesiana di esempio. Qui sono descritti solo i parametri specifici delle stampanti cartesiane - vedere impostazioni cinematiche comuni per i parametri disponibili. [printer] kinematics: cartesian max_z_velocity: # Imposta la velocit\u00e0 massima (in mm/s) di movimento lungo # l'asse z. Questa impostazione pu\u00f2 essere utilizzata per limitare # la velocit\u00e0 massima del motore passo-passo z. L'impostazione # predefinita \u00e8 utilizzare max_velocity per max_z_velocity. max_z_accel: # Imposta l'accelerazione massima (in mm/s^2) del movimento # lungo l'asse z. Limita l'accelerazione del motore passo-passo z. # L'impostazione predefinita \u00e8 utilizzare max_accel per max_z_accel. # La sezione stepper_x viene utilizzata per descrivere lo stepper # che controlla l'asse X in un robot cartesiano. [stepper_x] # La sezione stepper_y viene utilizzata per descrivere lo stepper # che controlla l'asse Y in un robot cartesiano. [stepper_y] # La sezione stepper_z viene utilizzata per descrivere lo stepper # che controlla l'asse Z in un robot cartesiano. [stepper_z] Cinematica Delta lineare \u00b6 Vedere example-delta.cfg per un file di configurazione della cinematica delta lineare di esempio. Consultare la guida alla calibrazione delta per informazioni sulla calibrazione. Qui vengono descritti solo i parametri specifici per le stampanti delta lineari - vedere impostazioni cinematiche comuni per i parametri disponibili. [printer] kinematics: delta max_z_velocity: # Per le stampanti delta questo limita la velocit\u00e0 massima (in mm/s) dei # movimenti con movimento dell'asse z. Questa impostazione pu\u00f2 essere # utilizzata per ridurre la velocit\u00e0 massima dei movimenti su/gi\u00f9 (che # richiedono una velocit\u00e0 di incremento maggiore rispetto ad altri # movimenti su una stampante delta). L'impostazione predefinita \u00e8 # utilizzare max_velocity per max_z_velocity. #max_z_accel: # Imposta l'accelerazione massima (in mm/s^2) del movimento lungo # l'asse z. L'impostazione pu\u00f2 essere utile se la stampante pu\u00f2 # raggiungere un'accelerazione maggiore sui movimenti XY rispetto ai # movimenti Z (ad esempio, quando si utilizza l'input shaper). # L'impostazione predefinita \u00e8 utilizzare max_accel per max_z_accel. #minimum_z_position: 0 # La posizione Z minima in cui l'utente pu\u00f2 comandare alla testa di # spostarsi. Il valore predefinito \u00e8 0. delta_radius: # Raggio (in mm) del cerchio orizzontale formato dalle tre torri ad # asse lineare. Questo parametro pu\u00f2 anche essere calcolato come: # delta_radius = smooth_rod_offset - effector_offset - carriage_offset # Questo parametro deve essere fornito. #print_radius: # Il raggio (in mm) delle coordinate XY della testa di stampa valide. # \u00c8 possibile utilizzare questa impostazione per personalizzare il # controllo dell'intervallo dei movimenti della testa. Se qui # viene specificato un valore elevato, potrebbe essere possibile # comandare la collisione della testa di stampa con una torre. # L'impostazione predefinita \u00e8 usare delta_radius per print_radius # (che normalmente impedirebbe una collisione con torri). # La sezione stepper_a descrive lo stepper che controlla la torre # anteriore sinistra (a 210 gradi). Questa sezione controlla anche i # parametri di homing (velocit\u00e0 di homing, homing retract_dist) # per tutte le torri. [stepper_a] position_endstop: # Distanza (in mm) tra l'ugello e il piatto quando l'ugello si trova al # centro dell'area di costruzione e si attiva il finecorsa. Questo # parametro deve essere fornito per stepper_a; per stepper_b e # stepper_c questo parametro \u00e8 predefinito sul valore specificato # per stepper_a. arm_length: # Lunghezza (in mm) dell'asta diagonale che collega questa torre # alla testa di stampa. Questo parametro deve essere fornito per # stepper_a; per stepper_b e stepper_c questo parametro \u00e8 predefinito sul valore specificato per stepper_a. #angle: # Questa opzione specifica l'angolo (in gradi) a cui si trova la torre. # Il valore predefinito \u00e8 210 per stepper_a, 330 per stepper_b e 90 # per stepper_c. # La sezione stepper_b descrive lo stepper che controlla la torre # anteriore destra (a 330 gradi). [stepper_b] # La sezione stepper_c descrive lo stepper che controlla la torre # posteriore (a 90 gradi). [stepper_c] # La sezione delta_calibrate abilita un comando G-code esteso # DELTA_CALIBRATE in grado di calibrare le posizioni e gli angoli # dei finecorsa della torre. [delta_calibrate] radius: # Raggio (in mm) dell'area che pu\u00f2 essere sondata. Questo \u00e8 # il raggio delle coordinate dell'ugello da sondare; se si utilizza # una sonda automatica con un offset XY, scegliere un raggio # sufficientemente piccolo in modo che la sonda si adatti sempre # al piatto. Questo parametro deve essere fornito. #speed: 50 # La velocit\u00e0 (in mm/s) degli spostamenti senza probing durante # la calibrazione. Il valore predefinito \u00e8 50. #horizontal_move_z: 5 # L'altezza (in mm) a cui la testa deve essere comandata di # spostarsi appena prima di avviare un'operazione di sonda. # L'impostazione predefinita \u00e8 5. Cinematica Deltesiana \u00b6 Vedere example-deltesian.cfg per un esempio di file di configurazione della cinematica deltesiana. Qui sono descritti solo i parametri specifici per le stampanti deltesiane - vedere impostazioni cinematiche comuni per i parametri disponibili. [printer] kinematics: deltesian max_z_velocity: # Per le stampanti deltesiane, ci\u00f2 limita la velocit\u00e0 massima (in mm/s) # dei movimenti con movimento dell'asse z. Questa impostazione pu\u00f2 # essere utilizzata per ridurre la velocit\u00e0 massima dei movimenti su/gi\u00f9 # (che richiedono una velocit\u00e0 di incremento maggiore rispetto ad altri # movimenti su una stampante deltesiana). L'impostazione predefinita # \u00e8 utilizzare max_velocity per max_z_velocity. #max_z_accel: # Imposta l'accelerazione massima (in mm/s^2) del movimento lungo # l'asse z. L'impostazione pu\u00f2 essere utile se la stampante pu\u00f2 raggiungere # un'accelerazione maggiore sui movimenti XY rispetto ai movimenti Z # (ad esempio, quando si utilizza l'input shaper). L'impostazione # predefinita \u00e8 utilizzare max_accel per max_z_accel. #minimum_z_position: 0 # La posizione Z minima in cui l'utente pu\u00f2 comandare alla testa di # spostarsi. Il valore predefinito \u00e8 0. #min_angle: 5 # Questo rappresenta l'angolo minimo (in gradi) rispetto all'orizzontale # che le braccia deltesiane possono raggiungere. Questo parametro ha lo # scopo di impedire che i bracci diventino completamente orizzontali, il # che rischierebbe l'inversione accidentale dell'asse XZ. # L'impostazione predefinita \u00e8 5. #print_width: # La distanza (in mm) delle coordinate X della testa utensile valide. # \u00c8 possibile utilizzare questa impostazione per personalizzare il # controllo dell'intervallo dei movimenti della testa utensile. Se # qui viene specificato un valore elevato, potrebbe essere possibile # comandare la collisione della testa utensile con una torre. Questa # impostazione di solito corrisponde alla larghezza del piatto (in mm). #slow_ratio: 3 # Il rapporto utilizzato per limitare la velocit\u00e0 e l'accelerazione sui # movimenti vicini agli estremi dell'asse X. Se la distanza verticale # divisa per la distanza orizzontale supera il valore di slow_ratio, la # velocit\u00e0 e l'accelerazione sono limitate alla met\u00e0 dei loro valori # nominali. Se la distanza verticale divisa per la distanza orizzontale # supera il doppio del valore di slow_ratio, la velocit\u00e0 e l'accelerazione # sono limitate a un quarto dei loro valori nominali. # Il valore predefinito \u00e8 3. # la sezione stepper_left \u00e8 usata per descrivere lo stepper che controlla # la torre di sinistra. Questa sezione controlla anche i parametri di # homing (velocit\u00e0 di homing, homing retract_dist) per tutte le torri. [stepper_left] position_endstop: # Distanza (in mm) tra l'ugello e il piatto quando l'ugello si trova al # centro dell'area di costruzione e vengono attivati i finecorsa. Questo # parametro deve essere fornito per stepper_left; per stepper_right # questo parametro \u00e8 predefinito sul valore specificato per stepper_left. arm_length: # Lunghezza (in mm) dell'asta diagonale che collega il carrello torre # alla testina di stampa. Questo parametro deve essere fornito per # stepper_left; per stepper_right, questo parametro per impostazione # predefinita \u00e8 il valore specificato per stepper_left. arm_x_length: # Distanza orizzontale tra la testina di stampa e la torre quando le # stampanti \u00e8 in homing. Questo parametro deve essere fornito # per stepper_left; per stepper_right, questo parametro per impostazione # predefinita \u00e8 il valore specificato per stepper_left. # La sezione stepper_right \u00e8 usata per descrivere lo stepper che # controlla la torre destra. [stepper_right] # La sezione stepper_y viene utilizzata per descrivere lo stepper che # controlla l'asse Y in un robot deltesiano. [stepper_y] Cinematica CoreXY \u00b6 Vedere example-corexy.cfg per un file cinematico corexy (e h-bot) di esempio. Qui sono descritti solo i parametri specifici per le stampanti corexy - vedere impostazioni cinematiche comuni per i parametri disponibili. [printer] kinematics: corexy max_z_velocity: # Imposta la velocit\u00e0 massima (in mm/s) di movimento lungo l'asse z. # Questa impostazione pu\u00f2 essere utilizzata per limitare la velocit\u00e0 # massima del motore passo-passo z. L'impostazione predefinita \u00e8 # utilizzare max_velocity per max_z_velocity. max_z_accel: # Imposta l'accelerazione massima (in mm/s^2) del movimento # lungo l'asse z. Limita l'accelerazione del motore passo-passo z. # L'impostazione predefinita \u00e8 utilizzare max_accel per max_z_accel. # La sezione stepper_x viene utilizzata per descrivere l'asse X e lo # stepper che controlla il movimento X+Y. [stepper_x] # La sezione stepper_y viene utilizzata per descrivere l'asse Y e lo # stepper che controlla il movimento X+Y. [stepper_y] # La sezione stepper_z viene utilizzata per descrivere l'asse Z [stepper_z] Cinematica CoreXZ \u00b6 Vedere example-corexz.cfg per un file di configurazione della cinematica corexz di esempio. Qui sono descritti solo i parametri specifici per le stampanti corexz - vedere impostazioni cinematiche comuni per i parametri disponibili. [printer] kinematics: corexz max_z_velocity: # Imposta la velocit\u00e0 massima (in mm/s) di movimento lungo l'asse z. # L'impostazione predefinita \u00e8 utilizzare max_velocity per # max_z_velocity. max_z_accel: # Imposta l'accelerazione massima (in mm/s^2) del movimento lungo # l'asse z. L'impostazione predefinita \u00e8 utilizzare max_accel per # max_z_accel. # La sezione stepper_x viene utilizzata per descrivere l'asse X e lo # stepper che controlla il movimento X+Z. [stepper_x] # La sezione stepper_y viene utilizzata per descrivere l'asse Y [stepper_y] # La sezione stepper_z viene utilizzata per descrivere l'asse Z e lo # stepper che controlla il movimento X+Z. [stepper_z] Cinematica Hybrid-CoreXY \u00b6 Vedere example-hybrid-corexy.cfg per un file di configurazione della cinematica corexy ibrida di esempio. Questa cinematica \u00e8 anche nota come cinematica Markforged. Qui vengono descritti solo i parametri specifici delle stampanti corexy ibride, vedere impostazioni cinematiche comuni per i parametri disponibili. [printer] kinematics: hybrid_corexy max_z_velocity: # Imposta la velocit\u00e0 massima (in mm/s) di movimento lungo # l'asse z. L'impostazione predefinita \u00e8 utilizzare max_velocity # per max_z_velocity. max_z_accel: # Imposta l'accelerazione massima (in mm/s^2) del movimento # lungo l'asse z. L'impostazione predefinita \u00e8 utilizzare max_accel # per max_z_accel. # La sezione stepper_x viene utilizzata per descrivere l'asse X e lo # stepper che controlla il movimento X-Y. [stepper_x] # La sezione stepper_y viene utilizzata per descrivere lo stepper # che controlla l'asse Y. [stepper_y] # La sezione stepper_z viene utilizzata per descrivere lo stepper # che controlla l'asse Z. [stepper_z] Cinematica Hybrid-CoreXZ \u00b6 Vedere example-hybrid-corexz.cfg per un file di configurazione della cinematica corexz ibrido di esempio. Questa cinematica \u00e8 anche nota come cinematica Markforged. Qui vengono descritti solo i parametri specifici delle stampanti corexy ibride, vedere impostazioni cinematiche comuni per i parametri disponibili. [printer] kinematics: hybrid_corexz max_z_velocity: # Questo imposta la velocit\u00e0 massima (in mm/s) di movimento lungo # l'asse z. L'impostazione predefinita \u00e8 utilizzare max_velocity per # max_z_velocity. max_z_accel: # Imposta l'accelerazione massima (in mm/s^2) del movimento lungo # l'asse z. L'impostazione predefinita \u00e8 utilizzare max_accel per # max_z_accel. # La sezione stepper_x viene utilizzata per descrivere l'asse X e lo # stepper che controlla il movimento X-Z. [stepper_x] # La sezione stepper_y viene utilizzata per descrivere lo stepper che # controlla l'asse Y. [stepper_y] # La sezione stepper_z viene utilizzata per descrivere lo stepper che # controlla l'asse Z. [stepper_z] Cinematica polare \u00b6 Vedere example-polar.cfg per un file di configurazione della cinematica polare di esempio. Qui sono descritti solo i parametri specifici per le stampanti polari - vedere impostazioni cinematiche comuni per i parametri disponibili. LA CINEMATICA POLARE \u00c8 UN LAVORO IN CORSO. \u00c8 noto che i movimenti intorno alla posizione 0, 0 non funzionano correttamente. [printer] kinematics: polar max_z_velocity: # Imposta la velocit\u00e0 massima (in mm/s) di movimento lungo l'asse z. # Questa impostazione pu\u00f2 essere utilizzata per limitare la velocit\u00e0 # massima del motore passo-passo z. L'impostazione predefinita \u00e8 # utilizzare max_velocity per max_z_velocity. max_z_accel: # Questo imposta l'accelerazione massima (in mm/s^2) del # movimento lungo l'asse z. Limita l'accelerazione del motore # passo-passo z. L'impostazione predefinita \u00e8 utilizzare max_accel # per max_z_accel. # La sezione stepper_bed viene utilizzata per descrivere lo stepper # che controlla il piatto [stepper_bed] gear_ratio: # \u00c8 necessario specificare un gear_ratio e rotation_distance # potrebbe non essere specificato. Ad esempio, se il piatto ha una # ruota a 80 denti azionata da uno stepper con una ruota a 16 # denti, si dovrebbe specificare un rapporto di trasmissione di \"80:16\". # Questo parametro deve essere fornito. # La sezione stepper_arm \u00e8 usata per descrivere lo stepper che # controlla il carrello sul braccio. [stepper_arm] # La sezione stepper_z viene utilizzata per descrivere lo stepper che # controlla l'asse Z. [stepper_z] Rotary delta Kinematics \u00b6 See example-rotary-delta.cfg for an example rotary delta kinematics config file. Qui vengono descritti solo i parametri specifici delle stampanti delta rotative - vedere impostazioni cinematiche comuni per i parametri disponibili. ROTARY DELTA KINEMATICS ARE A WORK IN PROGRESS. Homing moves may timeout and some boundary checks are not implemented. [printer] kinematics: rotary_delta max_z_velocity: # For delta printers this limits the maximum velocity (in mm/s) of # moves with z axis movement. This setting can be used to reduce the # maximum speed of up/down moves (which require a higher step rate # than other moves on a delta printer). The default is to use # max_velocity for max_z_velocity. #minimum_z_position: 0 # The minimum Z position that the user may command the head to move # to. The default is 0. shoulder_radius: # Radius (in mm) of the horizontal circle formed by the three # shoulder joints, minus the radius of the circle formed by the # effector joints. This parameter may also be calculated as: # shoulder_radius = (delta_f - delta_e) / sqrt(12) # This parameter must be provided. shoulder_height: # Distance (in mm) of the shoulder joints from the bed, minus the # effector toolhead height. This parameter must be provided. # The stepper_a section describes the stepper controlling the rear # right arm (at 30 degrees). This section also controls the homing # parameters (homing_speed, homing_retract_dist) for all arms. [stepper_a] gear_ratio: # A gear_ratio must be specified and rotation_distance may not be # specified. For example, if the arm has an 80 toothed pulley driven # by a pulley with 16 teeth, which is in turn connected to a 60 # toothed pulley driven by a stepper with a 16 toothed pulley, then # one would specify a gear ratio of \"80:16, 60:16\". This parameter # must be provided. position_endstop: # Distance (in mm) between the nozzle and the bed when the nozzle is # in the center of the build area and the endstop triggers. This # parameter must be provided for stepper_a; for stepper_b and # stepper_c this parameter defaults to the value specified for # stepper_a. upper_arm_length: # Length (in mm) of the arm connecting the \"shoulder joint\" to the # \"elbow joint\". This parameter must be provided for stepper_a; for # stepper_b and stepper_c this parameter defaults to the value # specified for stepper_a. lower_arm_length: # Length (in mm) of the arm connecting the \"elbow joint\" to the # \"effector joint\". This parameter must be provided for stepper_a; # for stepper_b and stepper_c this parameter defaults to the value # specified for stepper_a. #angle: # This option specifies the angle (in degrees) that the arm is at. # The default is 30 for stepper_a, 150 for stepper_b, and 270 for # stepper_c. # The stepper_b section describes the stepper controlling the rear # left arm (at 150 degrees). [stepper_b] # The stepper_c section describes the stepper controlling the front # arm (at 270 degrees). [stepper_c] # The delta_calibrate section enables a DELTA_CALIBRATE extended # g-code command that can calibrate the shoulder endstop positions. [delta_calibrate] radius: # Radius (in mm) of the area that may be probed. This is the radius # of nozzle coordinates to be probed; if using an automatic probe # with an XY offset then choose a radius small enough so that the # probe always fits over the bed. This parameter must be provided. #speed: 50 # The speed (in mm/s) of non-probing moves during the calibration. # The default is 50. #horizontal_move_z: 5 # The height (in mm) that the head should be commanded to move to # just prior to starting a probe operation. The default is 5. Cable winch Kinematics \u00b6 Vedere example-winch.cfg per un esempio di file di configurazione della cinematica con verricello, cable winch. Qui sono descritti solo i parametri specifici per le stampanti cavo verricello - vedere impostazioni comuni cinematiche per i parametri disponibili. CABLE WINCH SUPPORT IS EXPERIMENTAL. Homing is not implemented on cable winch kinematics. In order to home the printer, manually send movement commands until the toolhead is at 0, 0, 0 and then issue a G28 command. [printer] kinematics: winch # The stepper_a section describes the stepper connected to the first # cable winch. A minimum of 3 and a maximum of 26 cable winches may be # defined (stepper_a to stepper_z) though it is common to define 4. [stepper_a] rotation_distance: # The rotation_distance is the nominal distance (in mm) the toolhead # moves towards the cable winch for each full rotation of the # stepper motor. This parameter must be provided. anchor_x: anchor_y: anchor_z: # The X, Y, and Z position of the cable winch in cartesian space. # These parameters must be provided. Nessuna cinematica \u00b6 \u00c8 possibile definire una cinematica speciale \"none\" per disabilitare il supporto cinematico in Klipper. Questo pu\u00f2 essere utile per controllare dispositivi che non sono le tipiche stampanti 3D o per scopi di debug. [printer] kinematics: none max_velocity: 1 max_accel: 1 # \u00c8 necessario definire i parametri max_velocity e max_accel. I valori # non vengono utilizzati per la cinematica \"none\". Supporto per estrusore e piatto riscaldato comuni \u00b6 [extruder] \u00b6 La sezione dell'estrusore viene utilizzata per descrivere i parametri del riscaldatore per l'hotend dell'ugello insieme allo stepper che controlla l'estrusore. Per ulteriori informazioni, vedere riferimento comando . Consultare la Guida all'avanzamento della pressione per informazioni sulla regolazione dell'anticipo della pressione. [extruder] step_pin: dir_pin: enable_pin: microsteps: rotation_distance: #full_steps_per_rotation: #gear_ratio: # Vedere la sezione \"stepper\" per una descrizione di quanto sopra # Se nessuno dei parametri precedenti \u00e8 specificato, nessuno stepper # sar\u00e0 associato all'hotend dell'ugello (sebbene un comando # SYNC_EXTRUDER_MOTION possa associarne uno in fase di esecuzione). nozzle_diameter: # Diametro dell'orifizio dell'ugello (in mm). Questo parametro deve essere fornito. filament_diameter:: # Il diametro nominale del filamento grezzo (in mm) quando # entra nell'estrusore. Questo parametro deve essere fornito. #max_extrude_cross_section: # Area massima (in mm^2) di una sezione trasversale dell'estrusione # (ad es. larghezza dell'estrusione moltiplicata per l'altezza dello strato). # Questa impostazione previene quantit\u00e0 eccessive di estrusione # durante spostamenti XY relativamente piccoli. # Se un movimento richiede una velocit\u00e0 di estrusione che supererebbe questo valore # causer\u00e0 la restituzione di un errore. L'impostazione predefinita # \u00e8: 4.0 * diametro_ugello^2 instantaneous_corner_velocity: 1.000 # La variazione di velocit\u00e0 istantanea massima (in mm/s) del # estrusore durante il collegamento di due movimenti. Il valore predefinito \u00e8 1 mm/s. #max_extrude_only_distance: 50.0 # Lunghezza massima (in mm di filamento grezzo) che pu\u00f2 avere un movimento # di retrazione o di sola estrusione. Se uno spostamento di retrazione # o di sola estrusione richiede una distanza maggiore di questo valore, # verr\u00e0 restituito un errore. Il valore predefinito \u00e8 50 mm. #max_extrude_only_velocity: #max_extrude_only_accel: # Velocit\u00e0 massima (in mm/s) e accelerazione (in mm/s^2) del # motore estrusore per retrazioni e movimenti di sola estrusione. # Queste impostazioni non hanno alcun impatto sui normali movimenti di stampa. # Se non specificati, vengono calcolati per corrispondere al limite che avrebbe # un movimento di stampa XY con una sezione trasversale di 4,0*diametro_ugello^2. #pressure_advance: 0.0 # La quantit\u00e0 di filamento grezzo da spingere nell'estrusore durante # accelerazione dell'estrusore. Una uguale quantit\u00e0 di filamento viene # retratta durante la decelerazione. Si misura in millimetri per # millimetro/secondo. Il valore predefinito \u00e8 0, che disabilita l'avanzamento della pressione. #pressure_advance_smooth_time: 0,040 # Un intervallo di tempo (in secondi) da utilizzare per calcolare la velocit\u00e0 media # dell'estrusore per l'avanzamento della pressione. Un valore maggiore si traduce # in movimenti pi\u00f9 fluidi dell'estrusore. Questo parametro non pu\u00f2 superare i 200 ms. # Questa impostazione si applica solo se pressure_advance \u00e8 diverso da zero. # Il valore predefinito \u00e8 0,040 (40 millisecondi). # # Le restanti variabili descrivono il riscaldatore dell'estrusore. heater_pin: # Pin di uscita PWM che controlla il riscaldatore. Questo parametro deve essere fornito. #max_power: 1.0 # La potenza massima (espressa come un valore compreso tra 0,0 e 1,0) a cui # pu\u00f2 essere impostato il riscaldatore_pin. Il valore 1.0 consente di impostare il pin # completamente abilitato per periodi prolungati, mentre un valore di 0,5 # consentirebbe di abilitare il pin per non pi\u00f9 della met\u00e0 del tempo. Questo # l'impostazione pu\u00f2 essere utilizzata per limitare la potenza totale # (per periodi prolungati) al riscaldatore. L'impostazione predefinita \u00e8 1.0. sensor_type: # Tipo di sensore - i termistori comuni sono \"EPCOS 100K B57560G104F\", # \"ATC Semitec 104GT-2\", \"ATC Semitec 104NT-4-R025H42G\", \"Generico # 3950\",\"Honeywell 100K 135-104LAG-J01\", \"NTC 100K MGB18-104F39050L32\", # \"SliceEngineering 450\" e \"TDK NTCG104LH104JT1\". Vedere la sezione # \"Sensori di temperatura\" per altri sensori. Questo parametro deve essere fornito. sensor_pin: # Pin di ingresso analogico collegato al sensore. Questo parametro deve essere fornito. #pullup_resistor: 4700 # La resistenza (in ohm) del pullup collegato al termistore. Questo parametro # \u00e8 valido solo quando il sensore \u00e8 un termistore. Il valore predefinito \u00e8 4700 ohm. #smooth_time: 1.0 # Un valore di tempo (in secondi) durante il quale le misurazioni della # temperatura verranno uniformate per ridurre l'impatto del rumore # di misurazione. Il valore predefinito \u00e8 1 secondo. control: # Algoritmo di controllo (pid o filigrana). Questo parametro deve # essere fornito. pid_Kp: pid_Ki: pid_Kd: # Il proporzionale (pid_Kp), l'integrale (pid_Ki) e la derivata # (pid_Kd) impostazioni per il sistema di controllo del feedback PID. Klipper # valuta le impostazioni PID con la seguente formula generale: # riscaldatore_pwm = (Kp*errore + Ki*integrale(errore) - Kd*derivato(errore)) / 255 # Dove \"errore\" \u00e8 \"temperatura_richiesta - temperatura_misurata\" # e \"heater_pwm\" \u00e8 la velocit\u00e0 di riscaldamento richiesta con 0,0 completamente # off e 1.0 completamente on. Prendi in considerazione l'utilizzo di PID_CALIBRATE # comando per ottenere questi parametri. pid_Kp, pid_Ki e pid_Kd # i parametri devono essere forniti per i riscaldatori PID. #delta_max: 2.0 # Sui riscaldatori controllati questo \u00e8 il numero di gradi in # Celsius al di sopra della temperatura target prima di disattivare il riscaldatore # cos\u00ec come il numero di gradi sotto il target prima # riattivare il riscaldatore. L'impostazione predefinita \u00e8 2 gradi Celsius. #pwm_cycle_time: 0,100 # Tempo in secondi per ogni ciclo PWM software del riscaldatore. # non \u00e8 consigliabile impostarlo a meno che non ci sia necessario come # requisito accendere il riscaldatore pi\u00f9 velocemente di 10 volte al secondo. # Il valore predefinito \u00e8 0,100 secondi. #min_extrude_temp: 170 # La temperatura minima (in gradi Celsius) alla quale possono essere # impartiti comandi all'estrusore. L'impostazione predefinita \u00e8 170 gradi Celsius. min_temp: max_temp: # L'intervallo massimo di temperature valide (in gradi Celsius) in cui # il riscaldatore deve rimanere all'interno. Questo controlla una funzione di sicurezza # implementata nel codice del microcontrollore , la temperatura # non cadr\u00e0 mai al di fuori di questo intervallo, altrimenti il microcontrollore # entrer\u00e0 in uno stato di arresto. Questo controllo pu\u00f2 aiutare a rilevarne alcuni # guasti hardware del riscaldatore e del sensore. Imposta questo intervallo solo in modo ampio # abbastanza in modo che temperature ragionevoli non si traducano in un errore. # Questi parametri devono essere forniti. [heater_bed] \u00b6 La sezione heater_bed descrive un piatto riscaldato. Utilizza le stesse impostazioni del riscaldatore descritte nella sezione \"extruder\". [heater_bed] heater_pin: sensor_type: sensor_pin: control: min_temp: max_temp: # Vedere la sezione \"extruder\" per una descrizione dei parametri sopra. Supporto livellamento del piatto \u00b6 [bed_mesh] \u00b6 Mesh Bed Leveling. Si pu\u00f2 definire una sezione di configurazione bed_mesh per abilitare trasformazioni di spostamento che sfalsano l'asse z in base a una mesh generata da punti sondati. Quando si utilizza una sonda per la posizione di riferimento sull'asse z, si consiglia di definire una sezione safe_z_home in printer.cfg per la posizione di riferimento verso il centro dell'area di stampa. Per ulteriori informazioni, vedere la bed mesh guide e riferimento del comando . Esempi visivi: rectangular bed, probe_count = 3, 3: x---x---x (max_point) | x---x---x | (min_point) x---x---x round bed, round_probe_count = 5, bed_radius = r: x (0, r) end / x---x---x \\ (-r, 0) x---x---x---x---x (r, 0) \\ x---x---x / x (0, -r) start [bed_mesh] #speed: 50 # The speed (in mm/s) of non-probing moves during the calibration. # The default is 50. #horizontal_move_z: 5 # The height (in mm) that the head should be commanded to move to # just prior to starting a probe operation. The default is 5. #mesh_radius: # Defines the radius of the mesh to probe for round beds. Note that # the radius is relative to the coordinate specified by the # mesh_origin option. This parameter must be provided for round beds # and omitted for rectangular beds. #mesh_origin: # Defines the center X, Y coordinate of the mesh for round beds. This # coordinate is relative to the probe's location. It may be useful # to adjust the mesh_origin in an effort to maximize the size of the # mesh radius. Default is 0, 0. This parameter must be omitted for # rectangular beds. #mesh_min: # Defines the minimum X, Y coordinate of the mesh for rectangular # beds. This coordinate is relative to the probe's location. This # will be the first point probed, nearest to the origin. This # parameter must be provided for rectangular beds. #mesh_max: # Defines the maximum X, Y coordinate of the mesh for rectangular # beds. Adheres to the same principle as mesh_min, however this will # be the furthest point probed from the bed's origin. This parameter # must be provided for rectangular beds. #probe_count: 3, 3 # For rectangular beds, this is a comma separate pair of integer # values X, Y defining the number of points to probe along each # axis. A single value is also valid, in which case that value will # be applied to both axes. Default is 3, 3. #round_probe_count: 5 # For round beds, this integer value defines the maximum number of # points to probe along each axis. This value must be an odd number. # Default is 5. #fade_start: 1.0 # The gcode z position in which to start phasing out z-adjustment # when fade is enabled. Default is 1.0. #fade_end: 0.0 # The gcode z position in which phasing out completes. When set to a # value below fade_start, fade is disabled. It should be noted that # fade may add unwanted scaling along the z-axis of a print. If a # user wishes to enable fade, a value of 10.0 is recommended. # Default is 0.0, which disables fade. #fade_target: # The z position in which fade should converge. When this value is # set to a non-zero value it must be within the range of z-values in # the mesh. Users that wish to converge to the z homing position # should set this to 0. Default is the average z value of the mesh. #split_delta_z: .025 # The amount of Z difference (in mm) along a move that will trigger # a split. Default is .025. #move_check_distance: 5.0 # The distance (in mm) along a move to check for split_delta_z. # This is also the minimum length that a move can be split. Default # is 5.0. #mesh_pps: 2, 2 # A comma separated pair of integers X, Y defining the number of # points per segment to interpolate in the mesh along each axis. A # \"segment\" can be defined as the space between each probed point. # The user may enter a single value which will be applied to both # axes. Default is 2, 2. #algorithm: lagrange # The interpolation algorithm to use. May be either \"lagrange\" or # \"bicubic\". This option will not affect 3x3 grids, which are forced # to use lagrange sampling. Default is lagrange. #bicubic_tension: .2 # When using the bicubic algorithm the tension parameter above may # be applied to change the amount of slope interpolated. Larger # numbers will increase the amount of slope, which results in more # curvature in the mesh. Default is .2. #relative_reference_index: # A point index in the mesh to reference all z values to. Enabling # this parameter produces a mesh relative to the probed z position # at the provided index. #faulty_region_1_min: #faulty_region_1_max: # Optional points that define a faulty region. See docs/Bed_Mesh.md # for details on faulty regions. Up to 99 faulty regions may be added. # By default no faulty regions are set. [bed_tilt] \u00b6 Compensazione dell'inclinazione del piatto. Si pu\u00f2 definire una sezione di configurazione bed_tilt per abilitare le trasformazioni di movimento che tengono conto di un piatto inclinato. Nota che bed_mesh e bed_tilt sono incompatibili; entrambi non possono essere definiti. Per ulteriori informazioni, vedere riferimento comando . [bed_tilt] #x_adjust: 0 # The amount to add to each move's Z height for each mm on the X # axis. The default is 0. #y_adjust: 0 # The amount to add to each move's Z height for each mm on the Y # axis. The default is 0. #z_adjust: 0 # The amount to add to the Z height when the nozzle is nominally at # 0, 0. The default is 0. # The remaining parameters control a BED_TILT_CALIBRATE extended # g-code command that may be used to calibrate appropriate x and y # adjustment parameters. #points: # A list of X, Y coordinates (one per line; subsequent lines # indented) that should be probed during a BED_TILT_CALIBRATE # command. Specify coordinates of the nozzle and be sure the probe # is above the bed at the given nozzle coordinates. The default is # to not enable the command. #speed: 50 # The speed (in mm/s) of non-probing moves during the calibration. # The default is 50. #horizontal_move_z: 5 # The height (in mm) that the head should be commanded to move to # just prior to starting a probe operation. The default is 5. [bed_screws] \u00b6 Strumento per aiutare a regolare le viti di livellamento del letto. Si pu\u00f2 definire una sezione di configurazione [bed_screws] per abilitare un comando g-code BED_SCREWS_ADJUST. Per ulteriori informazioni, vedere la guida al livellamento e il riferimento al comando . [bed_screws] #screw1: # The X, Y coordinate of the first bed leveling screw. This is a # position to command the nozzle to that is directly above the bed # screw (or as close as possible while still being above the bed). # This parameter must be provided. #screw1_name: # An arbitrary name for the given screw. This name is displayed when # the helper script runs. The default is to use a name based upon # the screw XY location. #screw1_fine_adjust: # An X, Y coordinate to command the nozzle to so that one can fine # tune the bed leveling screw. The default is to not perform fine # adjustments on the bed screw. #screw2: #screw2_name: #screw2_fine_adjust: #... # Additional bed leveling screws. At least three screws must be # defined. #horizontal_move_z: 5 # The height (in mm) that the head should be commanded to move to # when moving from one screw location to the next. The default is 5. #probe_height: 0 # The height of the probe (in mm) after adjusting for the thermal # expansion of bed and nozzle. The default is zero. #speed: 50 # The speed (in mm/s) of non-probing moves during the calibration. # The default is 50. #probe_speed: 5 # The speed (in mm/s) when moving from a horizontal_move_z position # to a probe_height position. The default is 5. [screws_tilt_adjust] \u00b6 Strumento per aiutare a regolare l'inclinazione delle viti del piatto utilizzando la sonda Z. Si pu\u00f2 definire una sezione di configurazione Screws_tilt_adjust per abilitare un comando g-code SCREWS_TILT_CALCULATE. Per ulteriori informazioni, vedere la guida al livellamento e riferimento al comando . [screws_tilt_adjust] #screw1: # La coordinata (X, Y) della prima vite di livellamento del piatto. Questa # \u00e8 una posizione in cui comandare l'ugello in modo che la sonda sia # direttamente sopra la vite del piatto (o il pi\u00f9 vicino possibile mentre si # trova ancora sopra il piatto). Questa \u00e8 la vite di base utilizzata nei calcoli. # Questo parametro deve essere fornito. #screw1_name: # Un nome arbitrario per la vite data. Questo nome viene visualizzato # quando viene eseguito lo script di supporto. L'impostazione predefinita # prevede l'utilizzo di un nome basato sulla posizione XY della vite. #screw2: #screw2_name: #... # Viti di livellamento del piatto aggiuntive. Devono essere definite # almeno due viti. #speed: 50 # La velocit\u00e0 (in mm/s) degli spostamenti senza probing durante la # calibrazione. Il valore predefinito \u00e8 50. #horizontal_move_z: 5 # L'altezza (in mm) a cui la testa deve essere spostata appena prima # di avviare un'operazione di sonda. L'impostazione predefinita \u00e8 5. #screw_thread: CW-M3 # Il tipo di vite utilizzata per il livello del piatto, M3, M4 o M5 e la # direzione della manopola utilizzata per livellare il letto, in senso orario # decrementa in senso antiorario decrementa. Valori accettati: CW-M3, # CCW-M3, CW-M4, CCW-M4, CW-M5, CCW-M5. Il valore predefinito \u00e8 # CW-M3, la maggior parte delle stampanti utilizza una vite M3 e # ruotando la manopola in senso orario diminuisce la distanza. [z_tilt] \u00b6 Regolazione multipla dell'inclinazione dello stepper Z. Questa funzione consente la regolazione indipendente di pi\u00f9 stepper z (vedere la sezione \"stepper_z1\") per regolare l'inclinazione. Se questa sezione \u00e8 presente, diventa disponibile un comando G-Code esteso Z_TILT_ADJUST. [z_tilt] #z_positions: # Un elenco di coordinate X, Y (una per riga; le righe successive # identate) che descrivono la posizione di ciascun \"pivot point\" # del piattotto. Il \"pivot point\" \u00e8 il punto in cui il piatto si attacca # al dato stepper Z. Viene descritto utilizzando le coordinate dell'ugello # (la posizione X, Y dell'ugello se potesse spostarsi direttamente sopra # il punto). La prima voce corrisponde a stepper_z, la seconda a # stepper_z1, la terza a stepper_z2, ecc. # Questo parametro deve essere fornito. #points: # Un elenco di coordinate X, Y (una per riga; righe successive identate) # che devono essere rilevate durante un comando Z_TILT_ADJUST. # Specificare le coordinate dell'ugello e assicurarsi che la sonda sia # sopra il piatto alle coordinate dell'ugello date. # Questo parametro deve essere fornito. #speed: 50 # La velocit\u00e0 (in mm/s) degli spostamenti senza probing durante # la calibrazione. Il valore predefinito \u00e8 50. #horizontal_move_z: 5 # L'altezza (in mm) a cui la testa deve essere comandata per spostarsi # appena prima di avviare un'operazione di probing. # L'impostazione predefinita \u00e8 5. #retries: 0 # Numero di volte per riprovare se i punti rilevati non sono all'interno # della tolleranza. #retry_tolerance: 0 # Se i tentativi sono abilitati, riprovare se i punti sondati pi\u00f9 grande e # pi\u00f9 piccolo differiscono pi\u00f9 di retry_tolerance. Nota che l'unit\u00e0 di # modifica pi\u00f9 piccola qui sarebbe un singolo passaggio. # Tuttavia, se stai sondando pi\u00f9 punti rispetto agli stepper, # probabilmente avrai un valore minimo fisso per l'intervallo di punti # sondati che puoi apprendere osservando l'output del comando. [quad_gantry_level] \u00b6 Moving gantry leveling using 4 independently controlled Z motors. Corrects hyperbolic parabola effects (potato chip) on moving gantry which is more flexible. WARNING: Using this on a moving bed may lead to undesirable results. If this section is present then a QUAD_GANTRY_LEVEL extended G-Code command becomes available. This routine assumes the following Z motor configuration: ---------------- |Z1 Z2| | --------- | | | | | | | | | | x-------- | |Z Z3| ---------------- Dove x \u00e8 il punto 0, 0 sul piatto [quad_gantry_level] #gantry_corners: # A newline separated list of X, Y coordinates describing the two # opposing corners of the gantry. The first entry corresponds to Z, # the second to Z2. This parameter must be provided. #points: # A newline separated list of four X, Y points that should be probed # during a QUAD_GANTRY_LEVEL command. Order of the locations is # important, and should correspond to Z, Z1, Z2, and Z3 location in # order. This parameter must be provided. For maximum accuracy, # ensure your probe offsets are configured. #speed: 50 # The speed (in mm/s) of non-probing moves during the calibration. # The default is 50. #horizontal_move_z: 5 # The height (in mm) that the head should be commanded to move to # just prior to starting a probe operation. The default is 5. #max_adjust: 4 # Safety limit if an adjustment greater than this value is requested # quad_gantry_level will abort. #retries: 0 # Number of times to retry if the probed points aren't within # tolerance. #retry_tolerance: 0 # If retries are enabled then retry if largest and smallest probed # points differ more than retry_tolerance. [skew_correction] \u00b6 Correzione dell'inclinazione della stampante. \u00c8 possibile utilizzare il software per correggere l'inclinazione della stampante su 3 piani, xy, xz, yz. Questo viene fatto stampando un modello di calibrazione lungo un piano e misurando tre lunghezze. A causa della natura della correzione dell'inclinazione, queste lunghezze vengono impostate tramite gcode. Per i dettagli, vedere Correzione inclinazione e Command Reference . [skew_correction] [z_thermal_adjust] \u00b6 Regolazione della posizione Z della testa di stampa in funzione della temperatura. Compensare il movimento verticale della testina utensile causato dall'espansione termica del telaio della stampante in tempo reale utilizzando un sensore di temperatura (tipicamente accoppiato a una sezione verticale del telaio). Vedi anche: comandi g-code estesi . [z_thermal_adjust] #temp_coeff: # Il coefficiente di dilatazione della temperatura, in mm/degC. Ad esempio, un # temp_coeff di 0,01 mm/degC sposter\u00e0 l'asse Z verso il basso di 0,01 mm per ogni # grado Celsius di auemnto del sensore di temperatura . Il valore predefinito \u00e8 # 0,0 mm/degC, che non applica alcuna regolazione. #smooth_time: # Finestra di smoothing applicata al sensore di temperatura, in secondi. Pu\u00f2 # ridurre il rumore del motore da piccole correzioni eccessive in risposta al # rumore del sensore. Il valore predefinito \u00e8 2,0 secondi. #z_adjust_off_above: # Disattiva le regolazioni al di sopra di questa altezza Z [mm]. L'ultima correzione # calcolata rimarr\u00e0 applicata finch\u00e9 la testa utensile non si sposter\u00e0 nuovamente # al di sotto dell'altezza Z specificata. # Il valore predefinito \u00e8 99999999,0 mm (sempre attivo). #max_z_adjustment: # Massima regolazione assoluta applicabile all'asse Z [mm]. Il valore predefinito # \u00e8 99999999,0 mm (illimitato). #sensor_type: #sensor_pin: #min_temp: #max_temp: # Configurazione del sensore di temperatura. Vedere la sezione \"extruder\" per # la definizione dei parametri di cui sopra. #gcode_id: # Vedere la sezione \"heater_generic\" per la definizione di questo parametro. Homing personalizzato \u00b6 [safe_z_home] \u00b6 Homing Z sicuro. Si pu\u00f2 utilizzare questo meccanismo per posizionare l'asse Z su una specifica coordinata X, Y. Ci\u00f2 \u00e8 utile se la testa portautensili, ad esempio, deve spostarsi al centro del letto prima che Z possa essere riposizionato. [safe_z_home] home_xy_position: # Una coordinata X, Y (ad es. 100, 100) dove deve essere eseguita # homing Z. Questo parametro deve essere fornito. #speed: 50.0 # Velocit\u00e0 alla quale la testa di stampa viene spostata sulla # coordinata Z sicura. Il valore predefinito \u00e8 50 mm/s #z_hop: # Distanza (in mm) per sollevare l'asse Z prima dell'homing. # Questo si applica a qualsiasi comando di homing, anche se non # si trova sull'asse Z. Se l'asse Z \u00e8 gi\u00e0 azzerato e la posizione Z # corrente \u00e8 inferiore a z_hop, questo sollever\u00e0 la testa a un'altezza # di z_hop. Se l'asse Z non \u00e8 gi\u00e0 azzerato la testina viene sollevata # di z_hop. L'impostazione predefinita \u00e8 di non implementare Z hop. #z_hop_speed: 15.0 # Velocit\u00e0 (in mm/s) alla quale l'asse Z viene sollevato prima # del homing. Il valore predefinito \u00e8 15 mm/s. #move_to_previous: False # Quando \u00e8 impostato su True, gli assi X e Y vengono ripristinati alle # posizioni precedenti dopo l'homing dell'asse Z. # L'impostazione predefinita \u00e8 False. [homing_override] \u00b6 Homing Override. Si pu\u00f2 utilizzare questo meccanismo per eseguire una serie di comandi g-code al posto di un G28 che si trova nel normale input di g-code. Questo pu\u00f2 essere utile su stampanti che richiedono una procedura specifica per l'home della macchina. [homing_override] gcode: # Un elenco di comandi G-Code da eseguire al posto dei comandi # G28 trovati nel normale input di G-Code. # Vedi docs/Command_Templates.md per il formato G-Code. # Se un G28 \u00e8 contenuto in questo elenco di comandi, invocher\u00e0 # la normale procedura di homing per la stampante. I comandi # qui elencati devono eseguire l'home di tutti gli assi. # Questo parametro deve essere fornito. #axes: xyz # Gli assi da sovrascrivere. Ad esempio, se questo \u00e8 impostato # su \"z\", lo script di override verr\u00e0 eseguito solo quando l'asse z # \u00e8 azzerato (ad esempio, tramite un comando \"G28\" o \"G28 Z0\"). # Nota, lo script di sovrascrittura dovrebbe comunque ospitare # tutti gli assi. L'impostazione predefinita \u00e8 \"xyz\" che fa s\u00ec che lo # script di override venga eseguito al posto di tutti i comandi G28. #set_position_x: #set_position_y: #set_position_z: # Se specificato, la stampante presumer\u00e0 che l'asse si trovi # nella posizione specificata prima di eseguire i comandi g-code # precedenti. L'impostazione di questa opzione disabilita i # controlli di riferimento per quell'asse. Questo pu\u00f2 essere utile # se la testa deve muoversi prima di invocare il normale # meccanismo G28 per un asse. L'impostazione predefinita \u00e8 # di non forzare una posizione per un asse. [endstop_phase] \u00b6 Finecorsa regolati in fase stepper. Per utilizzare questa funzione, definire una sezione di configurazione con un prefisso \"endstop_phase\" seguito dal nome della corrispondente sezione di configurazione dello stepper (ad esempio, \"[endstop_phase stepper_z]\"). Questa funzione pu\u00f2 migliorare la precisione degli interruttori di fine corsa. Aggiungi una semplice dichiarazione \"[endstop_phase]\" per abilitare il comando ENDSTOP_PHASE_CALIBRATE. Per ulteriori informazioni, vedere la endstop phases guide e command reference . [endstop_phase stepper_z] #endstop_accuracy: # Imposta la precisione prevista (in mm) del finecorsa. Questo rappresenta # la distanza massima di errore che il finecorsa pu\u00f2 attivare (ad es. se un # finecorsa pu\u00f2 occasionalmente attivarsi 100um in anticipo o fino a 100um in ritardo # quindi impostalo su 0,200 per 200 um). L'impostazione predefinita \u00e8 # 4*distanza_rotazione/passi_completi_per_rotazione. #trigger_phase: # Questo specifica la fase del driver del motore passo-passo da aspettarsi # quando si raggiunge il finecorsa. \u00c8 composto da due numeri separati # da un '/' - la fase e il numero totale di # fasi (ad es. \"7/64\"). Impostare questo valore solo se si \u00e8 sicuri che il # driver del motore passo-passo viene ripristinato ogni volta che viene ripristinato l'mcu. Se questo # non \u00e8 impostato, la prima fase verr\u00e0 rilevata al primo home # e quella fase sar\u00e0 utilizzata su tutte le abitazioni successive. #endstop_align_zero: False # Se true, la posizione_endstop dell'asse sar\u00e0 effettivamente # modificato in modo che la posizione zero dell'asse avvenga a passo pieno # sul motore. (Se utilizzato sull'asse Z e la stampa # l'altezza del livello \u00e8 un multiplo di una distanza di un passo intero, allora ogni # layer si eseguir\u00e0 in un step completo.) L'impostazione predefinita \u00e8 False. Macro ed eventi G-Code \u00b6 [gcode_macro] \u00b6 Macro G-Code (\u00e8 possibile definire un numero qualsiasi di sezioni con un prefisso \"gcode_macro\"). Per ulteriori informazioni, consulta la Guida ai modelli di comando . [gcode_macro my_cmd] #gcode: # Un elenco di comandi G-Code da eseguire al posto di \"my_cmd\". # Vedi docs/Command_Templates.md per il formato G-Code. # Questo parametro deve essere fornito. #variable_<name>: # Si pu\u00f2 specificare un numero qualsiasi di opzioni con un prefisso # \"variable_\". Al nome della variabile data verr\u00e0 assegnato il valore dato # (analizzato come un valore letterale Python) e sar\u00e0 disponibile durante # l'espansione della macro. Ad esempio, una configurazione con # \"variable_fan_speed = 75\" potrebbe avere comandi gcode contenenti # \"M106 S{ fan_speed * 255 }\". Le variabili possono essere modificate in # fase di esecuzione utilizzando il comando SET_GCODE_VARIABLE # (consultare docs/Command_Templates.md per i dettagli). # I nomi delle variabili potrebbero non utilizzare caratteri maiuscoli. #rename_existing: # Questa opzione far\u00e0 s\u00ec che la macro ignori un comando G-Code # esistente e fornisca la definizione precedente del comando tramite # il nome fornito qui. Questo pu\u00f2 essere usato per sovrascrivere i # comandi G-Code integrati. Prestare attenzione quando si ignorano # i comandi poich\u00e9 possono causare risultati complessi e imprevisti. # L'impostazione predefinita \u00e8 di non sovrascrivere un comando # G-Code esistente. #description: G-Code macro # Ci\u00f2 aggiunger\u00e0 una breve descrizione utilizzata al comando HELP # o durante l'utilizzo della funzione di completamento automatico. # Predefinito \"G-Code macro\" [delayed_gcode] \u00b6 Esegui un gcode con un ritardo impostato. Per ulteriori informazioni, consulta la Guida template dei comandi e riferimento al comando . [delayed_gcode my_delayed_gcode] gcode: # A list of G-Code commands to execute when the delay duration has # elapsed. G-Code templates are supported. This parameter must be # provided. #initial_duration: 0.0 # The duration of the initial delay (in seconds). If set to a # non-zero value the delayed_gcode will execute the specified number # of seconds after the printer enters the \"ready\" state. This can be # useful for initialization procedures or a repeating delayed_gcode. # If set to 0 the delayed_gcode will not execute on startup. # Default is 0. [save_variables] \u00b6 Supporta il salvataggio delle variabili su disco in modo che vengano mantenute durante i riavvii. Per ulteriori informazioni, vedere template dei comandi e G-Code reference . [save_variables] filename: # Richiesto: fornire un nome file che verrebbe utilizzato per salvare # le variabili su disco, ad es. ~/variables.cfg [idle_timeout] \u00b6 Timeout di inattivit\u00e0. Viene automaticamente abilitato un timeout di inattivit\u00e0: aggiungi una sezione di configurazione di idle_timeout esplicita per modificare le impostazioni predefinite. [idle_timeout] #gcode: # Un elenco di comandi G-Code da eseguire in un timeout di # inattivit\u00e0. Vedi docs/Command Templates.md per il formato # G-Code. L'impostazione predefinita \u00e8 # eseguire \"TURN_OFF HEATERS\" e \"M84\". #timeout: 600 # Tempo di inattivit\u00e0 (in secondi) da attendere prima di eseguire # i comandi G-Code sopra. Il valore predefinito \u00e8 600 secondi. Funzionalit\u00e0 opzionali G-Code \u00b6 [virtual_sdcard] \u00b6 Una scheda SD virtuale pu\u00f2 essere utile se la macchina host non \u00e8 abbastanza veloce per eseguire bene OctoPrint. Consente al software host Klipper di stampare direttamente i file gcode archiviati in una directory sull'host utilizzando i comandi G-Code standard (ad esempio, M24). [virtual_sdcard] path: # Il percorso della directory locale sulla macchina host per cercare # i file di Gcode. Questa \u00e8 una directory di sola lettura (le scritture # di file sdcard non sono supportate). Si pu\u00f2 indicare questo alla # directory di caricamento di OctoPrint # (generalmente ~/.octoprint/uploads/ ). # Questo parametro deve essere fornito. #on_error_gcode: # Un elenco di comandi G-Code da eseguire quando viene segnalato # un errore. [sdcard_loop] \u00b6 Alcune stampanti con funzionalit\u00e0 di pulizia del piatto, come un espulsore di parti o una stampante a nastro, possono trovare impiego nelle sezioni di loop del file sdcard. (Ad esempio, per stampare la stessa parte pi\u00f9 e pi\u00f9 volte, o ripetere la sezione a di una parte per una catena o un altro motivo ripetuto). Consulta il command reference per i comandi supportati. Vedere il file sample-macros.cfg per una macro M808 G-Code compatibile con Marlin. [sdcard_loop] [force_move] \u00b6 Supporta lo spostamento manuale dei motori passo-passo per scopi diagnostici. Nota, l'utilizzo di questa funzione potrebbe mettere la stampante in uno stato non valido - vedere il command reference per dettagli importanti. [force_move] #enable_force_move: False # Impostare su True per abilitare FORCE_MOVE e SET_KINEMATIC_POSITION # i comandi G-Code estesi. L'impostazione predefinita \u00e8 False. [pause_resume] \u00b6 Funzionalit\u00e0 di Pause/Resume con supporto di acquisizione e ripristino della posizione. Per ulteriori informazioni, vedere riferimento comando . [pause_resume] #recover_velocity: 50. # Quando si abilita pause_resume, la velocit\u00e0 con cui tornare alla # posizione catturata (in mm/s). Il valore predefinito \u00e8 50,0 mm/s. [firmware_retraction] \u00b6 Retrazione del filamento del firmware. Ci\u00f2 abilita i comandi GCODE G10 (ritiro) e G11 (non ritirati) emessi da molti slicer. I parametri seguenti forniscono le impostazioni predefinite di avvio, sebbene i valori possano essere regolati tramite il [comando] SET_RETRACTION (G-Codes.md#firmware_retraction)), consentendo l'impostazione e l'ottimizzazione del filamento a runtime. [firmware_retraction] #retract_length: 0 # La lunghezza del filamento (in mm) da ritrarre quando G10 # \u00e8 attivato e da ritrarre quando G11 \u00e8 attivato (ma vedere # unretract_extra_length di seguito). I# l valore predefinito \u00e8 0 mm. #retract_speed: 20 # La velocit\u00e0 di retrazione, in mm/s. # Il valore predefinito \u00e8 20 mm/s. #unretract_extra_length: 0 # La lunghezza (in mm) del filamento *aggiuntivo* da # sommare quando non si ritrae. #unretract_speed: 10 # La velocit\u00e0 di srotolamento, in mm/s. # Il valore predefinito \u00e8 10 mm/s. [gcode_arcs] \u00b6 Supporto per i comandi Gcode arc (G2/G3). [gcode_arcs] #resolution: 1.0 # Un arco sar\u00e0 diviso in segmenti. La lunghezza di ciascun segmento # sar\u00e0 uguale alla risoluzione in mm impostata sopra. Valori pi\u00f9 bassi # produrranno un arco pi\u00f9 fine, ma anche pi\u00f9 lavoro per la tua macchina. # Archi pi\u00f9 piccoli del valore configurato diventer\u00e0 linee rette. # L'impostazione predefinita \u00e8 # 1mm. [respond] \u00b6 Abilita i comandi estesi \"M118\" e \"RESPOND\" commands . [respond] #default_type: echo # Imposta il prefisso predefinito dell'output \"M118\" e \"RESPOND\" su uno dei seguenti: # echo: \"echo: \" (Questa \u00e8 l'impostazione predefinita) # command: \"// \" # error: \"!! \" #default_prefix: echo: # Imposta direttamente il prefisso predefinito. Se presente # questo valore sovrascriver\u00e0 il \"default_type\". [exclude_object] \u00b6 Abilita il supporto per escludere o cancellare singoli oggetti durante il processo di stampa. Per ulteriori informazioni, vedere la guida escludi oggetti e riferimento ai comandi . Vedere il file sample-macros.cfg per una macro G-Code M486 compatibile con Marlin/RepRapFirmware. [exclude_object] Compensazione della risonanza \u00b6 [input_shaper] \u00b6 Abilita compensazione della risonanza . Vedere anche il command reference . [input_shaper] #shaper_freq_x: 0 # Una frequenza (in Hz) dell'input shaper per l'asse X. Questa \u00e8 # solitamente una frequenza di risonanza dell'asse X che l'input # shaper dovrebbe sopprimere. Per shaper pi\u00f9 complessi, come # shaper di input EI a 2 e 3 gobbe, questo parametro pu\u00f2 essere # impostato in base a diverse considerazioni. # Il valore predefinito \u00e8 0, che disabilita la modellatura dell'input # per l'asse X. #shaper_freq_y: 0 # Una frequenza (in Hz) dell'input shaper per l'asse Y. Questa \u00e8 # solitamente una frequenza di risonanza dell'asse Y che l'input # shaper dovrebbe sopprimere. Per shaper pi\u00f9 complessi, come # shaper di input EI a 2 e 3 gobbe, questo parametro pu\u00f2 essere # impostato in base a diverse considerazioni. Il valore predefinito # \u00e8 0, che disabilita la modellatura dell'input per l'asse Y. #shaper_type: mzv # Un tipo di input shaper da utilizzare per entrambi gli assi X e Y. # Gli shaper supportati sono zv, mzv, zvd, ei, 2hump_ei e # 3hump_ei. L'impostazione predefinita \u00e8 mzv input shaper. #shaper_type_x: #shaper_type_y: # Se shaper_type non \u00e8 impostato, questi due parametri possono # essere utilizzati per configurare diversi shaper di input per gli # assi X e Y. Sono supportati gli stessi valori del parametro # shaper_type. #damping_ratio_x: 0.1 #damping_ratio_y: 0.1 # Rapporti di smorzamento delle vibrazioni degli assi X e Y # utilizzati dagli shaper di input per migliorare la soppressione # delle vibrazioni. Il valore predefinito \u00e8 0,1, un buon valore per la # maggior parte delle stampanti. Nella maggior parte dei casi # questo parametro non richiede ottimizzazione e # non deve essere modificato. [adxl345] \u00b6 Supporto per accelerometri ADXL345. Questo supporto consente di interrogare le misurazioni dell'accelerometro dal sensore. Ci\u00f2 abilita un comando ACCELEROMETER_MEASURE (consultare G-Codes per ulteriori informazioni). Il nome del chip predefinito \u00e8 \"predefinito\", ma \u00e8 possibile specificare un nome esplicito (ad esempio, [adxl345 my_chip_name]). [adxl345] cs_pin: # The SPI enable pin for the sensor. This parameter must be provided. #spi_speed: 5000000 # The SPI speed (in hz) to use when communicating with the chip. # The default is 5000000. #spi_bus: #spi_software_sclk_pin: #spi_software_mosi_pin: #spi_software_miso_pin: # See the \"common SPI settings\" section for a description of the # above parameters. #axes_map: x, y, z # The accelerometer axis for each of the printer's X, Y, and Z axes. # This may be useful if the accelerometer is mounted in an # orientation that does not match the printer orientation. For # example, one could set this to \"y, x, z\" to swap the X and Y axes. # It is also possible to negate an axis if the accelerometer # direction is reversed (eg, \"x, z, -y\"). The default is \"x, y, z\". #rate: 3200 # Output data rate for ADXL345. ADXL345 supports the following data # rates: 3200, 1600, 800, 400, 200, 100, 50, and 25. Note that it is # not recommended to change this rate from the default 3200, and # rates below 800 will considerably affect the quality of resonance # measurements. [mpu9250] \u00b6 Support for MPU-9250, MPU-9255, MPU-6515, MPU-6050, and MPU-6500 accelerometers (one may define any number of sections with an \"mpu9250\" prefix). [mpu9250 my_accelerometer] #i2c_address: # Default is 104 (0x68). If AD0 is high, it would be 0x69 instead. #i2c_mcu: #i2c_bus: #i2c_speed: 400000 # See the \"common I2C settings\" section for a description of the # above parameters. The default \"i2c_speed\" is 400000. #axes_map: x, y, z # See the \"adxl345\" section for information on this parameter. [resonance_tester] \u00b6 Supporto per test di risonanza e calibrazione automatica del input shaper. Per utilizzare la maggior parte delle funzionalit\u00e0 di questo modulo, devono essere installate dipendenze software aggiuntive; fare riferimento a Measuring Resonances e al command reference per ulteriori informazioni. Per ulteriori informazioni sul parametro max_smoothing e sul suo utilizzo, vedere la sezione Max smoothing della guida alla misurazione delle risonanze. [resonance_tester] #probe_points: # Un elenco di coordinate X, Y, Z di punti (un punto per linea) in cui # testare le risonanze. Almeno un punto \u00e8 richiesto. Assicurati che tutti # i punti con un margine di sicurezza nel piano XY (~ pochi centimetri) # siano raggiungibili dalla testa di stampa. #accel_chip: # Un nome del chip dell'accelerometro da utilizzare per le misurazioni. # Se il chip adxl345 \u00e8 stato definito senza un nome esplicito, questo # parametro pu\u00f2 semplicemente fare riferimento ad esso come # \"accel_chip: adxl345\", altrimenti deve essere fornito anche un nome # esplicito, ad es. \"accel_chip: adxl345 mio_chip_nome\". \u00c8 necessario # impostare questo o i due parametri successivi. #accel_chip_x: #accel_chip_y: # Nomi dei chip dell'accelerometro da utilizzare per le misurazioni per # ciascuno degli assi. Pu\u00f2 essere utile, ad esempio, su una stampante con # piatto, se due accelerometri separati sono montati sul piatto (per l'asse Y) # e sulla testa di stampa (per l'asse X). Questi parametri hanno lo stesso # formato del parametro 'accel_chip'. # \u00c8 necessario fornire solo 'accel_chip' o questi due parametri. #max_smoothing: # Maximum input shaper smoothing to allow for each axis during shaper # auto-calibration (with 'SHAPER_CALIBRATE' command). By default no # maximum smoothing is specified. Refer to Measuring_Resonances guide # for more details on using this feature. #min_freq: 5 # Frequenza minima per testare le risonanze. L'impostazione \u00e8 5 Hz. #max_freq: 133.33 # Frequenza massima per testare le risonanze. L'impostazione \u00e8 133,33 Hz. #accel_per_hz: 75 # Questo parametro viene utilizzato per determinare quale accelerazione # utilizzare per testare una frequenza specifica: accel = accel_per_hz * freq. # Maggiore \u00e8 il valore, maggiore \u00e8 l'energia delle oscillazioni. Pu\u00f2 essere # impostato su un valore inferiore al valore predefinito se le risonanze # diventano troppo forti sulla stampante. Tuttavia, valori pi\u00f9 bassi rendono # le misurazioni delle risonanze ad alta frequenza meno precise. # Il valore predefinito \u00e8 75 (mm/sec). #hz_per_sec: 1 # Determina la velocit\u00e0 del test. Quando si testano tutte le frequenze # nell'intervallo [freq_min, freq_max], ogni secondo la frequenza aumenta # di hz_per_sec. Valori piccoli rallentano il test e valori grandi diminuiscono # la precisione del test. Il valore predefinito \u00e8 1,0 (Hz/sec == sec^-2). Helper per i file di configurazione \u00b6 [board_pins] \u00b6 Alias pin board (si pu\u00f2 definire un numero qualsiasi di sezioni con un prefisso \"board_pins\"). Usalo per definire gli alias per i pin su un microcontrollore. [board_pins my_aliases] mcu: mcu # A comma separated list of micro-controllers that may use the # aliases. The default is to apply the aliases to the main \"mcu\". aliases: aliases_<name>: # A comma separated list of \"name=value\" aliases to create for the # given micro-controller. For example, \"EXP1_1=PE6\" would create an # \"EXP1_1\" alias for the \"PE6\" pin. However, if \"value\" is enclosed # in \"<>\" then \"name\" is created as a reserved pin (for example, # \"EXP1_9=<GND>\" would reserve \"EXP1_9\"). Any number of options # starting with \"aliases_\" may be specified. [include] \u00b6 Supporto per includere i file. Uno pu\u00f2 includere un file di configurazione aggiuntivo dal file di configurazione della stampante principale. Possono essere utilizzati anche caratteri jolly (ad es. \"configs/*.cfg\"). [include my_other_config.cfg] [duplicate_pin_override] \u00b6 Questo strumento consente di definire pi\u00f9 volte un singolo pin del microcontrollore in un file di configurazione senza il normale controllo degli errori. Questo \u00e8 inteso per scopi diagnostici e di debug. Questa sezione non \u00e8 necessaria laddove Klipper supporta l'utilizzo dello stesso pin pi\u00f9 volte e l'utilizzo di questa sostituzione pu\u00f2 causare risultati confusi e imprevisti. [duplicate_pin_override] pins: # Un elenco di pin separato da virgole che possono essere utilizzati pi\u00f9 volte in # un file di configurazione senza normali controlli degli errori. Questo parametro deve essere # fornito. Hardware per probing del piatto \u00b6 [probe] \u00b6 Sonda di altezza Z. Si pu\u00f2 definire questa sezione per abilitare l'hardware di rilevamento dell'altezza Z. Quando questa sezione \u00e8 abilitata, i comandi estesi PROBE e QUERY_PROBE comandi g-code diventano disponibili. Inoltre, vedere la Guida alla calibrazione della sonda . La sezione probe crea anche un pin virtuale \"probe:z_virtual_endstop\". Si pu\u00f2 impostare stepper_z endstop_pin su questo pin virtuale su stampanti in stile cartesiano che utilizzano la sonda al posto di un endstop z. Se si utilizza \"probe:z_virtual_endstop\", non definire un position_endstop nella sezione di configurazione stepper_z. [probe] pin: # Pin di rilevamento della sonda. Se il pin si trova su un # microcontrollore diverso rispetto agli stepper Z, abilita # \"homing multi-mcu\". Questo parametro deve essere fornito. #deactivate_on_each_sample: True # Questo determina se Klipper deve eseguire la disattivazione # gcode tra ogni tentativo di esplorazione durante l'esecuzione di # una sequenza di probe multiple. L'impostazione predefinita \u00e8 True. #x_offset: 0.0 # La distanza (in mm) tra la sonda e l'ugello lungo l'asse x. # Il valore predefinito \u00e8 0. #y_offset: 0.0 # La distanza (in mm) tra la sonda e l'ugello lungo l'asse y. # Il valore predefinito \u00e8 0. z_offset: # La distanza (in mm) tra il piatto e l'ugello quando la sonda si attiva. # Questo parametro deve essere fornito. #speed: 5.0 # Velocit\u00e0 (in mm/s) dell'asse Z durante probing. # Il valore predefinito \u00e8 5 mm/s. #samples: 1 # Il numero di volte in cui sondare ciascun punto. I valori z sondati # verranno mediati. L'impostazione predefinita \u00e8 sondare 1 volta. #sample_retract_dist: 2.0 # La distanza (in mm) per sollevare la testa di stampa tra ciascun # campione (se si esegue il campionamento pi\u00f9 di una volta). # Il valore predefinito \u00e8 2 mm. #lift_speed: # Velocit\u00e0 (in mm/s) dell'asse Z durante il sollevamento della sonda # tra i campioni. L'impostazione predefinita prevede l'utilizzo dello # stesso valore del parametro 'speed'. #samples_result: average # Il metodo di calcolo durante il campionamento pi\u00f9 di una volta: # \"median\" o \"average\". L'impostazione predefinita \u00e8 average. #samples_tolerance: 0.100 # La distanza Z massima (in mm) che un campione pu\u00f2 differire da # altri campioni. Se questa tolleranza viene superata, viene segnalato # un errore o il tentativo viene riavviato # (vedere samples_tolerance_retries). Il valore predefinito \u00e8 0,100 mm. #samples_tolerance_retries: 0 # Il numero di tentativi per riprovare se viene trovato un campione che # supera samples_tolerance. In un nuovo tentativo, tutti i campioni # correnti vengono eliminati e il tentativo di sonda viene riavviato. # Se non si ottiene un insieme valido di campioni nel numero di tentativi # specificato, viene segnalato un errore. Il valore predefinito \u00e8 zero che # causa la segnalazione di un errore sul primo campione che supera # samples_tolerance. #activate_gcode: # Un elenco di comandi G-Code da eseguire prima di ogni tentativo di # esplorazione. Vedi docs/Command_Templates.md per il formato # G-Code. Questo pu\u00f2 essere utile se la sonda deve essere attivata in # qualche modo. Non impartire qui alcun comando che sposti la testa # di stampa (ad es. G1). L'impostazione predefinita \u00e8 di non eseguire # alcun comando G-Code speciale all'attivazione. #deactivate_gcode: # Un elenco di comandi G-Code da eseguire dopo il completamento di # ogni tentativo di esplorazione. Vedi docs/Command_Templates.md # per il formato G-Code. Non impartire qui alcun comando che sposti # la testina. L'impostazione predefinita \u00e8 di non eseguire alcun # comando G-Code speciale alla disattivazione. [bltouch] \u00b6 Sonda BLTouch. Si pu\u00f2 definire questa sezione (anzich\u00e9 una sezione sonda) per abilitare una sonda BLTouch. Per ulteriori informazioni, vedere BL-Touch guide e command reference .. Viene anche creato un pin virtuale \"probe:z_virtual_endstop\" (consultare la sezione \"probe\" per i dettagli). [bltouch] sensor_pin: # Pin connected to the BLTouch sensor pin. Most BLTouch devices # require a pullup on the sensor pin (prefix the pin name with \"^\"). # This parameter must be provided. control_pin: # Pin connected to the BLTouch control pin. This parameter must be # provided. #pin_move_time: 0.680 # The amount of time (in seconds) to wait for the BLTouch pin to # move up or down. The default is 0.680 seconds. #stow_on_each_sample: True # This determines if Klipper should command the pin to move up # between each probe attempt when performing a multiple probe # sequence. Read the directions in docs/BLTouch.md before setting # this to False. The default is True. #probe_with_touch_mode: False # If this is set to True then Klipper will probe with the device in # \"touch_mode\". The default is False (probing in \"pin_down\" mode). #pin_up_reports_not_triggered: True # Set if the BLTouch consistently reports the probe in a \"not # triggered\" state after a successful \"pin_up\" command. This should # be True for all genuine BLTouch devices. Read the directions in # docs/BLTouch.md before setting this to False. The default is True. #pin_up_touch_mode_reports_triggered: True # Set if the BLTouch consistently reports a \"triggered\" state after # the commands \"pin_up\" followed by \"touch_mode\". This should be # True for all genuine BLTouch devices. Read the directions in # docs/BLTouch.md before setting this to False. The default is True. #set_output_mode: # Request a specific sensor pin output mode on the BLTouch V3.0 (and # later). This setting should not be used on other types of probes. # Set to \"5V\" to request a sensor pin output of 5 Volts (only use if # the controller board needs 5V mode and is 5V tolerant on its input # signal line). Set to \"OD\" to request the sensor pin output use # open drain mode. The default is to not request an output mode. #x_offset: #y_offset: #z_offset: #speed: #lift_speed: #samples: #sample_retract_dist: #samples_result: #samples_tolerance: #samples_tolerance_retries: # See the \"probe\" section for information on these parameters. [smart_effector] \u00b6 Lo \"Smart Effector\" di Duet3d implementa una sonda Z utilizzando un sensore di forza. Si pu\u00f2 definire questa sezione invece di [probe] per abilitare le funzioni specifiche di Smart Effector. Ci\u00f2 consente anche a comandi di runtime di regolare i parametri di Smart Effector in fase di esecuzione. [smart_effector] pin: # Pin collegato al pin di uscita della sonda Z Smart Effector (pin 5). Si noti # che la resistenza di pullup sulla scheda generalmente non \u00e8 richiesta. # Tuttavia, se il pin di uscita \u00e8 collegato al pin della scheda con un resistore # di pullup, tale resistore deve essere di valore elevato (ad es. 10K Ohm o pi\u00f9). # Alcune schede hanno un resistore di pullup di basso valore sull'ingresso # della sonda Z, che probabilmente far\u00e0 risultare in uno stato di sonda sempre # attivato. In questo caso, collegare lo Smart Effector a un pin diverso sulla # scheda. Questo parametro \u00e8 obbligatorio. #control_pin: # Pin collegato al pin di ingresso di controllo Smart Effector (pin 7). Se fornito, # diventano disponibili i comandi di programmazione della sensibilit\u00e0 # di Smart Effector. #probe_accel: # Se impostato, limita l'accelerazione dei movimenti di tastatura (in mm/sec^2). # Un'improvvisa grande accelerazione all'inizio del movimento di esplorazione # pu\u00f2 causare l'attivazione spuria della sonda, specialmente se l'hotend \u00e8 pesante. # Per evitarlo, potrebbe essere necessario ridurre l'accelerazione dei movimenti # di tastatura tramite questo parametro. #recovery_time: 0.4 # Un ritardo tra i movimenti di spostamento e tastatura in secondi. Un # movimento veloce prima della tastatura pu\u00f2 causare l'attivazione spuria della # sonda. Ci\u00f2 pu\u00f2 causare errori \"Sonda attivata prima del movimento\" se non # \u00e8 impostato alcun ritardo. Il valore 0 disabilita il ritardo di ripristino. # Il valore predefinito \u00e8 0.4. #x_offset: #y_offset: # Dovrebbe essere lasciato non impostato (o impostato su 0). z_offset: # Altezza di attivazione della sonda. Inizia con -0.1 (mm) e regola in seguito # usando il comando `PROBE_CALIBRATE`. Questo parametro deve essere fornito. #speed: # Velocit\u00e0 (in mm/s) dell'asse Z durante la tastatura. Si consiglia di iniziare con la # velocit\u00e0 di tastatura di 20 mm/s e di regolarla secondo necessit\u00e0 per migliorare la # precisione e la ripetibilit\u00e0 dell'attivazione della sonda. #samples: #sample_retract_dist: #samples_result: #samples_tolerance: #samples_tolerance_retries: #activate_gcode: #deactivate_gcode: #deactivate_on_each_sample: # Vedere la sezione \"probe\" per ulteriori informazioni sui parametri di cui sopra. Motori passo-passo ed estrusori aggiuntivi \u00b6 [stepper_z1] \u00b6 Assi multi-stepper. Su una stampante in stile cartesiano, lo stepper che controlla un dato asse pu\u00f2 avere blocchi di configurazione aggiuntivi che definiscono gli stepper che dovrebbero essere azionati insieme allo stepper primario. Si pu\u00f2 definire un numero qualsiasi di sezioni con un suffisso numerico che inizia da 1 (ad esempio, \"stepper_z1\", \"stepper_z2\", ecc.). [stepper_z1] #step_pin: #dir_pin: #enable_pin: #microsteps: #rotation_distance: # Vedere la sezione \"stepper\" per la definizione dei parametri di cui sopra. #endstop_pin: # Se viene definito un endstop_pin per lo stepper aggiuntivo, lo stepper # si fermer\u00e0 fino all'attivazione dell'endstop. In caso contrario, lo stepper # si fermer\u00e0 fino a quando non verr\u00e0 attivato il finecorsa sullo stepper # primario per l'asse. [extruder1] \u00b6 In una stampante multiestrusore aggiungere una sezione estrusore aggiuntiva per ogni estrusore aggiuntivo. Le sezioni aggiuntive dell'estrusore devono essere denominate \"extruder1\", \"extruder2\", \"extruder3\" e cos\u00ec via. Vedere la sezione \"extruder\" per una descrizione dei parametri disponibili. Vedere sample-multi-extruder.cfg per un esempio di configurazione. [extruder1] #step_pin: #dir_pin: #... # Vedere la sezione \"estrusore\" per i parametri per lo stepper e il riscaldatore # disponibili. #shared_heater: # Questa opzione \u00e8 obsoleta e non deve pi\u00f9 essere specificata. [dual_carriage] \u00b6 Supporto per stampanti cartesiane con doppi carrelli su un unico asse. Il carrello attivo viene impostato tramite il comando G-code esteso SET_DUAL_CARRIAGE. Il comando \"SET_DUAL_CARRIAGE CARRIAGE=1\" attiver\u00e0 il carrello definito in questa sezione (CARRIAGE=0 riporter\u00e0 l'attivazione al carrello principale). Il supporto del doppio carrello \u00e8 in genere combinato con estrusori extra: il comando SET_DUAL_CARRIAGE viene spesso chiamato contemporaneamente al comando ACTIVATE_EXTRUDER. Assicurati di parcheggiare i carrelli durante la disattivazione. Vedere sample-idex.cfg per un esempio di configurazione. [dual_carriage] axis: # L'asse su cui si trova questo carrello aggiuntivo (x o y). Questo parametro # deve essere fornito #step_pin: #dir_pin: #enable_pin: #microsteps: #rotation_distance: #endstop_pin: #position_endstop: #position_min: #position_max: # Vedere la sezione \"stepper\" per la definizione dei parametri di cui sopra. [extruder_stepper] \u00b6 Supporto per stepper aggiuntivi sincronizzati al movimento di un estrusore (si pu\u00f2 definire un numero qualsiasi di sezioni con un prefisso \"extruder_stepper\"). Per ulteriori informazioni, vedere riferimento comando . [extruder_stepper my_extra_stepper] extruder: # L'estrusore con cui \u00e8 sincronizzato questo stepper. Se questo \u00e8 impostato su # una stringa vuota, lo stepper non verr\u00e0 sincronizzato con un # estrusore. Questo parametro deve essere fornito. #step_pin: #dir_pin: #enable_pin: #microsteps: #rotation_distance: # Vedere la sezione \"stepper\" per la definizione dei parametri sopra. # . [Stepper manuali] \u00b6 Stepper manuali (\u00e8 possibile definire un numero qualsiasi di sezioni con un prefisso \"manual_stepper\"). Questi sono stepper controllati dal comando g-code MANUAL_STEPPER. Ad esempio: \"MANUAL_STEPPER STEPPER=my_stepper MOVE=10 SPEED=5\". Vedere il file G-Codes per una descrizione del comando MANUAL_STEPPER. Gli stepper non sono collegati alla normale cinematica della stampante. [manual_stepper my_stepper] #step_pin: #dir_pin: #enable_pin: #microsteps: #rotation_distance: # Vedere la sezione \"stepper\" per una descrizione di questi parametri. #velocity: # Impostare la velocit\u00e0 predefinita (in mm/s) per lo stepper. Questo # valore verr\u00e0 utilizzato se un comando MANUAL_STEPPER non specifica # un parametro SPEED. Il valore predefinito \u00e8 5 mm/s. #accel: # Imposta l'accelerazione predefinita (in mm/s^2) per lo stepper. # Un'accelerazione pari a zero non risulter\u00e0 in nessuna accelerazione. # Questo valore verr\u00e0 utilizzato se un comando MANUAL_STEPPER non # specifica un parametro ACCEL. Il valore predefinito \u00e8 zero. #endstop_pin: # Pin di rilevamento interruttore di fine corsa. Se specificato, \u00e8 possibile # eseguire \"movimenti di riferimento\" aggiungendo un parametro # STOP_ON_ENDSTOP ai comandi di movimento MANUAL_STEPPER. Riscaldatori e sensori personalizzati \u00b6 [verify_heater] \u00b6 Verifica riscaldatore e sensore di temperatura. La verifica del riscaldatore viene abilitata automaticamente per ogni riscaldatore configurato sulla stampante. Usa le sezioni di verifica_riscaldatore per modificare le impostazioni predefinite. [verify_heater heater_config_name] #max_error: 120 # Il massimo \"errore di temperatura cumulativo\" prima di generare un # errore. Valori pi\u00f9 piccoli comportano un controllo pi\u00f9 rigoroso e valori # pi\u00f9 grandi consentono pi\u00f9 tempo prima che venga segnalato un errore. # Nello specifico la temperatura viene osservata una volta al secondo e # se \u00e8 prossima alla temperatura target viene azzerato un \"contatore errori\" # interno; in caso contrario, se la temperatura \u00e8 inferiore all'intervallo target, # il contatore viene aumentato della quantit\u00e0 in cui la temperatura riportata # differisce da tale intervallo. Se il contatore supera questo \"errore_max\", # viene generato un errore. Il valore predefinito \u00e8 120. #check_gain_time: # Questo controlla la verifica del riscaldatore durante il riscaldamento # iniziale. Valori pi\u00f9 piccoli comportano un controllo pi\u00f9 rigoroso e valori # pi\u00f9 grandi consentono pi\u00f9 tempo prima che venga segnalato un errore. # In particolare, durante il riscaldamento iniziale, fintanto che il riscaldatore # aumenta di temperatura entro questo intervallo di tempo (specificato in # secondi), il \"contatore errori\" interno viene azzerato. Il valore predefinito # \u00e8 20 secondi per gli estrusori e 60 secondi per heater_bed. #hysteresis: 5 # La differenza di temperatura massima (in gradi Celsius) rispetto a una # temperatura target considerata nell'intervallo del target. Questo controlla # nell'intervallo max_error. \u00c8 raro personalizzare questo valore. # L'impostazione predefinita \u00e8 5. #heating_gain: 2 # La temperatura minima (in gradi Celsius) di cui il riscaldatore deve # aumentare durante il check_gain_time. \u00c8 raro personalizzare questo valore. # L'impostazione predefinita \u00e8 2. [homing_heaters] \u00b6 Strumento per disabilitare i riscaldatori durante l'homing o la probing di un asse. [homing_heaters] #steppers: # Un elenco separato da virgole di stepper che dovrebbero causare # la disattivazione dei riscaldatori. L'impostazione predefinita \u00e8 # disabilitare i riscaldatori per qualsiasi spostamento di homing/sonda. # Esempio tipico: stepper_z #heaters: # Un elenco separato da virgole di riscaldatori da disabilitare # durante i movimenti di homing/probing. L'impostazione # predefinita \u00e8 disabilitare tutti i riscaldatori. # Esempio tipico: estrusore, letto riscaldatore [thermistor] \u00b6 Termistori personalizzati (si pu\u00f2 definire un numero qualsiasi di sezioni con un prefisso \"thermistor\"). \u00c8 possibile utilizzare un termistore personalizzato nel campo sensor_type di una sezione di configurazione del riscaldatore. (Ad esempio, se si definisce una sezione \"[thermistor my_thermistor]\", \u00e8 possibile utilizzare un \"sensor_type: my_thermistor\" quando si definisce un riscaldatore.) Assicurati di posizionare la sezione del termistore nel file di configurazione sopra il suo primo utilizzo in una sezione del riscaldatore . [thermistor my_thermistor] #temperature1: #resistance1: #temperature2: #resistance2: #temperature3: #resistance3: # Tre misure di resistenza (in Ohm) alle temperature date (in Celsius). # Le tre misurazioni verranno utilizzate per calcolare i coefficienti di # Steinhart-Hart per il termistore. Questi parametri devono essere # forniti quando si utilizza Steinhart-Hart per definire il termistore. #beta: # In alternativa, \u00e8 possibile definire temperatura1, resistenza1 e beta # per definire i parametri del termistore. Questo parametro deve # essere fornito quando si utilizza \"beta\" per definire il termistore. [adc_temperature] \u00b6 Sensori di temperatura ADC personalizzati (si pu\u00f2 definire un numero qualsiasi di sezioni con un prefisso \"adc_temperature\"). Ci\u00f2 consente di definire un sensore di temperatura personalizzato che misura una tensione su un pin del convertitore da analogico a digitale (ADC) e utilizza l'interpolazione lineare tra una serie di misurazioni di temperatura/tensione (o temperatura/resistenza) configurate per determinare la temperatura. Il sensore risultante pu\u00f2 essere utilizzato come tipo_sensore in una sezione riscaldatore. (Ad esempio, se si definisce una sezione \"[adc_temperature my_sensor]\", \u00e8 possibile utilizzare un \"sensor_type: my_sensor\" quando si definisce un riscaldatore.) Assicurati di posizionare la sezione del sensore nel file di configurazione sopra il suo primo utilizzo in una sezione del riscaldatore. [adc_temperature my_sensor] #temperature1: #voltage1: #temperature2: #voltage2: #... # A set of temperatures (in Celsius) and voltages (in Volts) to use # as reference when converting a temperature. A heater section using # this sensor may also specify adc_voltage and voltage_offset # parameters to define the ADC voltage (see \"Common temperature # amplifiers\" section for details). At least two measurements must # be provided. #temperature1: #resistance1: #temperature2: #resistance2: #... # Alternatively one may specify a set of temperatures (in Celsius) # and resistance (in Ohms) to use as reference when converting a # temperature. A heater section using this sensor may also specify a # pullup_resistor parameter (see \"extruder\" section for details). At # least two measurements must be provided. [heater_generic] \u00b6 Riscaldatori generici (si pu\u00f2 definire un numero qualsiasi di sezioni con il prefisso \"riscaldatore_generico\"). Questi riscaldatori si comportano in modo simile ai riscaldatori standard (estrusori, piatti riscaldati). Utilizzare il comando SET_HEATER_TEMPERATURE (consultare G-Codes per i dettagli) per impostare la temperatura target. [heater_generic my_generic_heater] #gcode_id: # L'ID da utilizzare quando si riporta la temperatura nel comando M105. # Questo parametro deve essere fornito. #max_power: #sensor_type: #sensor_pin: #smooth_time: #control: #pid_Kp: #pid_Ki: #pid_Kd: #pwm_cycle_time: #min_temp: #max_temp: # Vedere la sezione \"extruder\" per la definizione dei parametri sopra. [temperature_sensor] \u00b6 Sensori di temperatura generici. \u00c8 possibile definire un numero qualsiasi di sensori di temperatura aggiuntivi che vengono riportati tramite il comando M105. [temperature_sensor my_sensor] #sensor_type: #sensor_pin: #min_temp: #max_temp: # Vedi la sezione \"extruder\" per la definizione dei parametri # sopra indicati. #gcode_id: # Vedi la sezione \"heater_generic\" per la definizione dei # parametri sopra indicati. Sensori di temperatura \u00b6 Klipper include definizioni per molti tipi di sensori di temperatura. Questi sensori possono essere utilizzati in qualsiasi sezione di configurazione che richieda un sensore di temperatura (come una sezione [extruder] o [heater_bed] ). Termistori comuni \u00b6 Termistori comuni. I seguenti parametri sono disponibili nelle sezioni del riscaldatore che utilizzano uno di questi sensori. sensor_type: # Uno di \"EPCOS 100K B57560G104F\", \"ATC Semitec 104GT-2\", # \"ATC Semitec 104NT-4-R025H42G\", \"Generic 3950\", # \"Honeywell 100K 135-104LAG-J01\", \"NTC 100K MGB18-104F39050L32\", # \"SliceEngineering 450\", o \"TDK NTCG104LH104JT1\" sensor_pin: # Pin di ingresso analogico collegato al termistore. # Questo parametro deve essere fornito. #pullup_resistor: 4700 # La resistenza (in ohm) del pullup collegato al termistore. # Il valore predefinito \u00e8 4700 ohm. #inline_resistor: 0 # La resistenza (in ohm) di un resistore aggiuntivo (non a variazione di # calore) posizionato in linea con il termistore. \u00c8 raro impostare questo. # Il valore predefinito \u00e8 0 ohm. Amplificatori di temperatura comuni \u00b6 Amplificatori di temperatura comuni. I seguenti parametri sono disponibili nelle sezioni del riscaldatore che utilizzano uno di questi sensori. sensor_type: # Uno tra \"PT100 INA826\", \"AD595\", \"AD597\", \"AD8494\", \"AD8495\", # \"AD8496\", o \"AD8497\". sensor_pin: # Pin di ingresso analogico collegato al sensore. Questo parametro # deve essere fornito. #adc_voltage: 5.0 # La tensione di confronto dell'ADC (in Volt). Il valore predefinito # \u00e8 5 volt. #voltage_offset: 0 # L'offset di tensione ADC (in Volt). Il valore predefinito \u00e8 0. Sensore PT1000 collegato direttamente \u00b6 Sensore PT1000 collegato direttamente. I seguenti parametri sono disponibili nelle sezioni del riscaldatore che utilizzano uno di questi sensori. sensor_type: PT1000 sensor_pin: # Pin di ingresso analogico collegato al sensore. Questo parametro # deve essere fornito. #pullup_resistor: 4700 # La resistenza (in ohm) del pullup collegato al sensore. Il valore # predefinito \u00e8 4700 ohm. Sensori di temperatura MAXxxxxx \u00b6 Sensori temperatura MAXxxxxx con interfaccia periferica seriale (SPI). I seguenti parametri sono disponibili nelle sezioni del riscaldatore che utilizzano uno di questi tipi di sensore. sensor_type: # Uno tra \"MAX6675\", \"MAX31855\", \"MAX31856\", o \"MAX31865\". sensor_pin: # Il pin mcu collegato al pin di selezione del chip del sensore. # Questo parametro deve essere fornito. #spi_speed: 4000000 # La velocit\u00e0 SPI (in hz) da utilizzare durante la comunicazione # con il chip. Il valore predefinito \u00e8 4000000. #spi_bus: #spi_software_sclk_pin: #spi_software_mosi_pin: #spi_software_miso_pin: # Vedere la sezione \"impostazioni comuni SPI\" per una # descrizione dei parametri di cui sopra. #tc_type: K #tc_use_50Hz_filter: False #tc_averaging_count: 1 # I parametri di cui sopra controllano i parametri del sensore # dei chip MAX31856. I valori predefiniti per ciascun parametro # sono accanto al nome del parametro nell'elenco precedente. #rtd_nominal_r: 100 #rtd_reference_r: 430 #rtd_num_of_wires: 2 #rtd_use_50Hz_filter: False # I parametri di cui sopra controllano i parametri del sensore dei # chip MAX31865. I valori predefiniti per ciascun parametro sono # accanto al nome del parametro nell'elenco precedente. Sensore di temperatura BMP280/BME280/BME680 \u00b6 Sensori ambientali BMP280/BME280/BME680 con interfaccia I2C. Si noti che questi sensori non sono destinati all'uso con estrusori e letti riscaldanti, ma piuttosto per il monitoraggio della temperatura ambiente (C), della pressione (hPa), dell'umidit\u00e0 relativa (%)e di livello del gas per il BME680. Vedere sample-macros.cfg per una gcode_macro che pu\u00f2 essere utilizzata per riportare la pressione e l'umidit\u00e0 oltre alla temperatura. sensor_type: BME280 #i2c_address: # Il valore predefinito \u00e8 118 (0x76). Alcuni sensori BME280 hanno un # indirizzo di 119 (0x77). #i2c_mcu: #i2c_bus: #i2c_speed: # Vedere la sezione \"impostazioni comuni I2C\" per una descrizione # dei parametri di cui sopra. Sensore HTU21D \u00b6 Sensore ambientale con interfaccia a due fili (I2C) della famiglia HTU21D. Si noti che questo sensore non \u00e8 destinato all'uso con estrusori e letti riscaldanti, ma piuttosto per il monitoraggio della temperatura ambiente (C) e dell'umidit\u00e0 relativa(%). Vedere sample-macros.cfg per una gcode_macro che pu\u00f2 essere utilizzata per riportare l'umidit\u00e0 oltre alla temperatura. sensor_type: # Deve essere \"HTU21D\", \"SI7013\", \"SI7020\", \"SI7021\" o \"SHT21\" #i2c_address: # Il valore predefinito \u00e8 64 (0x40). #i2c_mcu: #i2c_bus: #i2c_speed: # Vedere la sezione \"impostazioni comuni I2C\" per una # descrizione dei parametri di cui sopra. #htu21d_hold_master: # Se il sensore pu\u00f2 trattenere il buf I2C durante la lettura. Se # True nessun'altra comunicazione bus pu\u00f2 essere eseguita mentre # la lettura \u00e8 in corso. L'impostazione predefinita \u00e8 False. #htu21d_resolution: # La risoluzione della lettura di temperatura e umidit\u00e0. # I valori validi sono: # 'TEMP14_HUM12' -> 14bit per Temp e 12bit per umidit\u00e0 # 'TEMP13_HUM10' -> 13bit per Temp e 10bit per umidit\u00e0 # 'TEMP12_HUM08' -> 12bit per Temp e 08bit per umidit\u00e0 # 'TEMP11_HUM11' -> 11bit per Temp e 11bit per umidit\u00e0 # L'impostazione predefinita \u00e8: \"TEMP11_HUM11\" #htu21d_report_time: # Intervallo in secondi tra le letture. Il valore predefinito \u00e8 30 Sensore di temperatura LM75 \u00b6 Sensori di temperatura (I2C) LM75/LM75A. Questi sensori hanno una gamma di -55~125 C, quindi sono utilizzabili ad es. monitoraggio della temperatura della camera. Possono anche funzionare come semplici controller per ventole/riscaldatori. sensor_type: LM75 #i2c_address: # Il valore predefinito \u00e8 72 (0x48). L'intervallo normale \u00e8 72-79 # (0x48-0x4F) e i 3 bit bassi dell'indirizzo sono configurati tramite # pin sul chip (di solito con ponticelli o cablati). #i2c_mcu: #i2c_bus: #i2c_speed: # Vedere la sezione \"impostazioni comuni I2C\" per una descrizione # dei parametri di cui sopra. #lm75_report_time: # Intervallo in secondi tra le letture. Il valore predefinito \u00e8 0.8 # con il minimo 0.5. Sensore di temperatura integrato nel microcontrollore \u00b6 I microcontrollori atsam, atsamd e stm32 contengono un sensore di temperatura interno. \u00c8 possibile utilizzare il sensore \"temperature_mcu\" per monitorare queste temperature. sensor_type: temperature_mcu #sensor_mcu: mcu # Il microcontrollore da cui leggere. L'impostazione predefinita \u00e8 \"mcu\". #sensor_temperature1: #sensor_adc1: # Specificare i due parametri precedenti (una temperatura in gradi # Celsius e un valore ADC come float compreso tra 0,0 e 1,0) per # calibrare la temperatura del microcontrollore. Ci\u00f2 potrebbe # migliorare la precisione della temperatura riportata su alcuni chip. # Un modo tipico per ottenere queste informazioni di calibrazione # consiste nel rimuovere completamente l'alimentazione dalla # stampante per alcune ore (per assicurarsi che sia alla temperatura # ambiente), quindi accenderla e utilizzare il comando QUERY_ADC # per ottenere una misurazione ADC. Utilizzare un altro sensore di # temperatura sulla stampante per trovare la temperatura ambiente # corrispondente. L'impostazione predefinita consiste nell'utilizzare # i dati di calibrazione di fabbrica sul microcontrollore (se applicabile) # o i valori nominali dalle specifiche del microcontrollore. #sensor_temperature2: #sensor_adc2: # Se viene specificato sensor_temperature1/sensor_adc1, \u00e8 anche # possibile specificare i dati di calibrazione sensor_temperature2/sensor_adc2. # Ci\u00f2 potrebbe fornire informazioni calibrate sulla \"curva della # temperatura\". L'impostazione predefinita consiste nell'utilizzare i dati # di calibrazione di fabbrica sul microcontrollore (se applicabile) o i # valori nominali dalle specifiche del microcontrollore. Sensore di temperatura host \u00b6 Temperatura dalla macchina (es. Raspberry Pi) che esegue il software host. sensor_type: temperature_host #sensor_path: # il percorso del file di sistema della temperatura. L'impostazione # predefinita \u00e8 \"/sys/class/thermal/thermal_zone0/temp\" che \u00e8 il file di # sistema della temperatura su un computer Raspberry Pi. Sensore di temperatura DS18B20 \u00b6 DS18B20 \u00e8 un sensore di temperatura digitale a 1 filo (w1). Si noti che questo sensore non \u00e8 destinato all'uso con estrusori e letti riscaldanti, ma piuttosto per il monitoraggio della temperatura ambiente (C). Questi sensori hanno una portata fino a 125 C, quindi sono utilizzabili ad es. monitoraggio della temperatura della camera. Possono anche funzionare come semplici controller per ventole/riscaldatori. I sensori DS18B20 sono supportati solo su \"host mcu\", ad es. il Raspberry Pi. \u00c8 necessario installare il modulo del kernel Linux w1-gpio. sensor_type: DS18B20 serial_no: # Ogni dispositivo a 1 filo ha un numero di serie univoco utilizzato per # identificare il dispositivo, solitamente nel formato 28-031674b175ff. Questo # parametro deve essere fornito. I dispositivi collegati a 1 filo possono essere # elencati utilizzando il seguente comando Linux: ls /sys/bus/w1/devices/ #ds18_report_time: # Intervallo in secondi tra le letture. Il valore predefinito \u00e8 3.0, con un # minimo di 1.0 #sensor_mcu: # Il microcontrollore da cui leggere. Deve essere host_mcu Ventole \u00b6 [fan] \u00b6 Ventola di raffreddamento della stampa. [fan] pin: # Pin di output che controlla la ventola. Questo parametro deve essere fornito. #max_power: 1.0 # La potenza massima (espressa come un valore compreso tra 0.0 e 1.0) a # cui pu\u00f2 essere impostato il pin. Il valore 1.0 consente di impostare il pin # completamente abilitato per periodi prolungati, mentre un valore di 0.5 # consentirebbe di abilitare il pin per non pi\u00f9 della met\u00e0 del tempo. Questa # impostazione pu\u00f2 essere utilizzata per limitare la potenza totale (per # periodi prolungati) della ventola. Se questo valore \u00e8 inferiore a 1.0, le # richieste di velocit\u00e0 della ventola verranno ridimensionate tra zero e # max_power (ad esempio, se max_power \u00e8 0.9 e viene richiesta una # velocit\u00e0 della ventola dell'80%, la potenza della ventola verr\u00e0 impostata # su 72%). L'impostazione predefinita \u00e8 1.0. #shutdown_speed: 0 # La velocit\u00e0 della ventola desiderata (espressa come valore da 0.0 a # 1.0) se il software del microcontrollore entra in uno stato di errore. # Il valore predefinito \u00e8 0. #cycle_time: 0.010 # La quantit\u00e0 di tempo (in secondi) per ogni ciclo di alimentazione PWM # alla ventola. Si consiglia di essere pari o superiore a 10 millisecondi # quando si utilizza il PWM basato su software. # Il valore predefinito \u00e8 0,010 secondi. #hardware_pwm: False # Abilitare questa opzione per utilizzare PWM hardware anzich\u00e9 PWM # software. La maggior parte delle ventole non funziona bene con PWM # hardware, quindi non \u00e8 consigliabile abilitarlo a meno che non vi sia # un requisito elettrico per passare a velocit\u00e0 molto elevate. Quando # si utilizza l'hardware PWM, il tempo di ciclo effettivo \u00e8 vincolato # dall'implementazione e pu\u00f2 essere notevolmente diverso dal tempo # di ciclo richiesto. L'impostazione predefinita \u00e8 False. #kick_start_time: 0.100 # Tempo (in secondi) per far funzionare la ventola a piena velocit\u00e0 # quando la si abilita per la prima volta o la si aumenta di oltre il 50% # (aiuta a far girare la ventola). Il valore predefinito \u00e8 0,100 secondi. #off_below: 0.0 # La velocit\u00e0 minima in input che alimenter\u00e0 la ventola (espressa # come un valore da 0.0 a 1.0). Quando viene richiesta una velocit\u00e0 # inferiore a off_below la ventola verr\u00e0 invece spenta. Questa # impostazione pu\u00f2 essere utilizzata per prevenire lo stallo della # ventola e per garantire che i kick start siano efficaci. # Il valore predefinito \u00e8 0.0. # # Questa impostazione deve essere ricalibrata ogni volta che # max_power viene regolato. Per calibrare questa impostazione, # inizia con off_below impostato su 0.0 e la ventola gira. Abbassare # gradualmente la velocit\u00e0 della ventola per determinare la velocit\u00e0 # di ingresso pi\u00f9 bassa che aziona la ventola in modo affidabile senza # stalli. Impostare off_below al duty cycle corrispondente a questo # valore (ad esempio, 12% -> 0,12) o leggermente superiore. #tachometer_pin: # Pin di ingresso contagiri per il monitoraggio della velocit\u00e0 della # ventola. In genere \u00e8 richiesto un pullup. Questo parametro \u00e8 facoltativo. #tachometer_ppr: 2 # Quando viene specificato tachometer_pin, questo \u00e8 il numero di # impulsi per giro del segnale del tachimetro. Per una ventola BLDC # questo \u00e8 normalmente la met\u00e0 del numero di poli. # L'impostazione predefinita \u00e8 2. #tachometer_poll_interval: 0.0015 # Quando viene specificato tachometer_pin, questo \u00e8 il periodo di polling # del pin del contagiri, in secondi. Il valore predefinito \u00e8 0.0015, che \u00e8 # abbastanza veloce per le ventole al di sotto di 10000 RPM a 2 PPR. Deve # essere inferiore a 30/(tachometer_ppr*rpm), con un certo margine, # dove rpm \u00e8 la velocit\u00e0 massima (in RPM) della ventola. #enable_pin: # Pin opzionale per abilitare l'alimentazione alla ventola. Questo pu\u00f2 # essere utile per le ventole con ingressi PWM dedicati. Alcune di queste # ventole rimangono accese anche allo 0% di ingresso PWM. In tal caso, # il pin PWM pu\u00f2 essere utilizzato normalmente e ad es. un FET commutato # a terra (pin della ventola standard) pu\u00f2 essere utilizzato per controllare # l'alimentazione alla ventola. [heater_fan] \u00b6 Ventole di raffreddamento del riscaldatore (si pu\u00f2 definire un numero qualsiasi di sezioni con un prefisso \"heater_fan\"). Una \"ventola riscaldatore\" \u00e8 una ventola che verr\u00e0 abilitata ogni volta che il riscaldatore associato \u00e8 attivo. Per impostazione predefinita, un heater_fan ha una velocit\u00e0 di spegnimento pari a max_power. [heater_fan my_nozzle_fan] #pin: #max_power: #shutdown_speed: #cycle_time: #hardware_pwm: #kick_start_time: #off_below: #tachometer_pin: #tachometer_ppr: #tachometer_poll_interval: #enable_pin: # Vedere la sezione \"fan\" per una descrizione dei parametri di cui sopra. #heater: extruder # Nome della sezione di configurazione che definisce il riscaldatore a cui # \u00e8 associato questa ventola. Se qui viene fornito un elenco di nomi di # riscaldatori separati da virgole, la ventola verr\u00e0 abilitata quando uno # qualsiasi dei riscaldatori indicati \u00e8 abilitato. # L'impostazione predefinita \u00e8 \"extruder\". #heater_temp: 50.0 # Una temperatura (in gradi Celsius) sotto la quale il riscaldatore deve # scendere prima che la ventola venga disattivata. # L'impostazione predefinita \u00e8 50 gradi Celsius. #fan_speed: 1.0 # La velocit\u00e0 della ventola (espressa come un valore compreso tra 0.0 e # 1.0) a cui verr\u00e0 impostato la ventola quando viene abilitato il relativo # riscaldatore. L'impostazione predefinita \u00e8 1.0 [controller_fan] \u00b6 Ventola di raffreddamento del controller (\u00e8 possibile definire un numero qualsiasi di sezioni con il prefisso \"controller_fan\"). Una \"ventola del controller\" \u00e8 una ventola che verr\u00e0 abilitata ogni volta che il riscaldatore associato o il driver stepper associato \u00e8 attivo. La ventola si fermer\u00e0 ogni volta che viene raggiunto un idle_timeout per garantire che non si verifichi alcun surriscaldamento dopo la disattivazione di un componente osservato. [controller_fan my_controller_fan] #pin: #max_power: #shutdown_speed: #cycle_time: #hardware_pwm: #kick_start_time: #off_below: #tachometer_pin: #tachometer_ppr: #tachometer_poll_interval: #enable_pin: # Vedere la sezione \"fan\" per una descrizione dei parametri di cui sopra. #fan_speed: 1.0 # La velocit\u00e0 della ventola (espressa come un valore compreso tra 0.0 e # 1.0) a cui verr\u00e0 impostata la ventola quando \u00e8 attivo un riscaldatore # o un driver passo-passo. L'impostazione predefinita \u00e8 1.0 #idle_timeout: # La quantit\u00e0 di tempo (in secondi) dopo che un driver passo-passo o # un riscaldatore \u00e8 stato attivo per la quale la ventola deve essere tenuta # in funzione. L'impostazione predefinita \u00e8 30 secondi. #idle_speed: # La velocit\u00e0 della ventola (espressa come un valore compreso tra 0.0 # e 1.0) a cui verr\u00e0 impostata la ventola quando era attivo un riscaldatore # o un driver passo-passo e prima che venga raggiunto l'idle_timeout. # L'impostazione predefinita \u00e8 fan_speed. #heater: #stepper: # Nome della sezione di configurazione che definisce il riscaldatore/ # stepper a cui \u00e8 associata questa ventola. Se qui viene fornito un # elenco separato da virgole di nomi di riscaldatori/stepper, la ventola # sar\u00e0 abilitata quando uno qualsiasi dei riscaldatori/stepper indicati # \u00e8 abilitato. Il riscaldatore predefinito \u00e8 \"estrusore\", lo stepper # predefinito sono tutti. [temperature_fan] \u00b6 Ventole di raffreddamento attivate dalla temperatura (\u00e8 possibile definire un numero qualsiasi di sezioni con un prefisso \"temperature_fan\"). Una \"ventola di temperatura\" \u00e8 una ventola che verr\u00e0 abilitata ogni volta che il sensore associato \u00e8 al di sopra di una temperatura impostata. Per impostazione predefinita, una ventola_temperatura ha una velocit\u00e0_di_arresto pari a potenza_massima. Per ulteriori informazioni, vedere command reference . [temperature_fan my_temp_fan] #pin: #max_power: #shutdown_speed: #cycle_time: #hardware_pwm: #kick_start_time: #off_below: #tachometer_pin: #tachometer_ppr: #tachometer_poll_interval: #enable_pin: # Vedere la sezione \"fan\" per una descrizione dei parametri di cui sopra. #sensor_type: #sensor_pin: #control: #max_delta: #min_temp: #max_temp: # Vedere la sezione \"extruder\" per una descrizione dei parametri di cui sopra. #pid_Kp: #pid_Ki: #pid_Kd: # Le impostazioni proporzionale (pid_Kp), integrale (pid_Ki) e derivata (pid_Kd) # per il sistema di controllo del feedback PID. Klipper valuta le impostazioni PID # con la seguente formula generale: fan_pwm = max_power - (Kp*e + Ki*integral(e) # - Kd*derivative(e)) / 255 Dove \"e\" \u00e8 \"target_temperature - measure_temperature\" # e \"fan_pwm\" \u00e8 la frequenza della ventola richiesta con 0.0 per spento e 1.0 al # massimo. I parametri pid_Kp, pid_Ki e pid_Kd devono essere forniti quando l# 'algoritmo di controllo PID \u00e8 abilitato. #pid_deriv_time: 2.0 # Un valore di tempo (in secondi) su cui le misurazioni della temperatura verranno # livellate quando si utilizza l'algoritmo di controllo PID. Ci\u00f2 pu\u00f2 ridurre l'impatto # del rumore di misurazione. Il valore predefinito \u00e8 2 secondi. #target_temp: 40.0 # Una temperatura (in Celsius) che sar\u00e0 la temperatura target. # L'impostazione predefinita \u00e8 40 gradi. #max_speed: 1.0 # La velocit\u00e0 della ventola (espressa come un valore compreso tra 0.0 e 1.0) a cui # verr\u00e0 impostata la ventola quando la temperatura del sensore supera il valore # impostato. L'impostazione predefinita \u00e8 1.0. #min_speed: 0.3 # La velocit\u00e0 minima della ventola (espressa come un valore compreso tra 0.0 e # 1.0) alla quale la ventola verr\u00e0 impostata per le ventole con temperatura PID. # Il valore predefinito \u00e8 0.3. #gcode_id: # Se impostata, la temperatura verr\u00e0 riportata nelle query M105 utilizzando l'id # fornito. L'impostazione predefinita \u00e8 di non riportare la temperatura tramite M105. [fan_generic] \u00b6 Ventola a controllo manuale (si pu\u00f2 definire un numero qualsiasi di sezioni con il prefisso \"fan_generic\"). La velocit\u00e0 di una ventola controllata manualmente viene impostata con SET_FAN_SPEED comando gcode . [fan_generic extruder_partfan] #pin: #max_power: #shutdown_speed: #cycle_time: #hardware_pwm: #kick_start_time: #off_below: #tachometer_pin: #tachometer_ppr: #tachometer_poll_interval: #enable_pin: # Vedere la sezione \"fan\" per una descrizione dei parametri di cui sopra. LEDs \u00b6 [led] \u00b6 Supporto per LED (e strisce LED) controllati tramite pin PWM del microcontrollore (si pu\u00f2 definire un numero qualsiasi di sezioni con un prefisso \"led\"). Per ulteriori informazioni, vedere command reference . [led my_led] #red_pin: #green_pin: #blue_pin: #white_pin: # Il pin che controlla il colore del LED specificato. Deve essere fornito # almeno uno dei parametri sopra indicati. #cycle_time: 0.010 # La quantit\u00e0 di tempo (in secondi) per ciclo PWM. Si consiglia che sia # pari o superiore a 10 millisecondi quando si utilizza il PWM basato # su software. Il valore predefinito \u00e8 0,010 secondi. #hardware_pwm: False # Abilitare questa opzione per utilizzare PWM hardware anzich\u00e9 PWM # software. Quando si utilizza l'hardware PWM, il tempo di ciclo effettivo # \u00e8 vincolato dall'implementazione e pu\u00f2 essere notevolmente diverso # dal tempo di ciclo richiesto. L'impostazione predefinita \u00e8 Falso. #initial_RED: 0.0 #initial_GREEN: 0.0 #initial_BLUE: 0.0 #initial_WHITE: 0.0 # Imposta il colore iniziale del LED. Ciascun valore deve essere # compreso tra 0,0 e 1,0. Il valore predefinito per ogni colore \u00e8 0. [neopixel] \u00b6 Supporto LED Neopixel (aka WS2812) (si pu\u00f2 definire un numero qualsiasi di sezioni con un prefisso \"neopixel\"). Per ulteriori informazioni, vedere riferimento comando . Si noti che l'implementazione di linux mcu non supporta attualmente i neopixel collegati direttamente. L'attuale design che utilizza l'interfaccia del kernel Linux non consente questo scenario perch\u00e9 l'interfaccia GPIO del kernel non \u00e8 sufficientemente veloce da fornire le frequenze di impulso richieste. [neopixel my_neopixel] pin: # Il pin collegato al neopixel. Questo parametro deve essere fornito. #chain_count: # Il numero di chip Neopixel che sono \"collegati a margherita\" al # pin fornito. Il valore predefinito \u00e8 1 (che indica che un solo # Neopixel \u00e8 collegato al pin). #color_order: GRB # Impostare l'ordine dei pixel richiesto dall'hardware del LED # (utilizzando una stringa contenente le lettere R, G, B, W con W # opzionale). In alternativa, questo pu\u00f2 essere un elenco separato # da virgole di pixel, uno per ogni LED nella catena. # L'impostazione predefinita \u00e8 GRB. #initial_RED: 0.0 #initial_GREEN: 0.0 #initial_BLUE: 0.0 #initial_WHITE: 0.0 # Vedere la sezione \"led\" per informazioni su questi parametri. [dotstar] \u00b6 Supporto LED Dotstar (conosciuti anche come APA102) (si pu\u00f2 definire un numero qualsiasi di sezioni con un prefisso \"dotstar\"). Per ulteriori informazioni, vedere command reference . [dotstar my_dotstar] data_pin: # Il pin connesso alla data line del dotstar. Questo parametro # deve essere fornito. clock_pin: # Il pin connesso alla clock line del dotstar. Questo parametro # deve essere fornito. #chain_count: # Vedere la sezione \"neopixel\" per informazioni su questo parametro. #initial_RED: 0.0 #initial_GREEN: 0.0 #initial_BLUE: 0.0 # Vedere la sezione \"led\" per informazioni su questo parametro. [pca9533] \u00b6 PCA9533 Supporto LED. Il PCA9533 viene utilizzato sulla scheda mightyboard. [pca9533 my_pca9533] #i2c_address: 98 # L'indirizzo i2c utilizzato dal chip sul bus i2c. Utilizzare 98 per # PCA9533/1, 99 per PCA9533/2. Il valore predefinito \u00e8 98. #i2c_mcu: #i2c_bus: #i2c_speed: # Vedere la sezione \"impostazioni comuni I2C\" per una # descrizione dei parametri di cui sopra. #initial_RED: 0.0 #initial_GREEN: 0.0 #initial_BLUE: 0.0 #initial_WHITE: 0.0 # Vedere la sezione \"led\" per informazioni su questi parametri. [pca9632] \u00b6 Supporto LED PCA9632. Il PCA9632 viene utilizzato su FlashForge Dreamer. [pca9632 my_pca9632] #i2c_address: 98 # L'indirizzo i2c utilizzato dal chip sul bus i2c. Pu\u00f2 essere 96, # 97, 98 o 99. Il valore predefinito \u00e8 98. #i2c_mcu: #i2c_bus: #i2c_speed: # Vedere la sezione \"impostazioni I2C comuni\" per una # descrizione dei parametri di cui sopra. #scl_pin: #sda_pin: # In alternativa, se il pca9632 non \u00e8 collegato a un bus I2C # hardware, \u00e8 possibile specificare i pin \"clock\" (pin scl) e \"data\" # (pin sda). L'impostazione predefinita prevede l'utilizzo # dell'hardware I2C. #color_order: RGBW # Impostare l'ordine dei pixel del LED (usando una stringa # contenente le lettere R, G, B, W). L'impostazione predefinita # \u00e8 RGBW. #initial_RED: 0.0 #initial_GREEN: 0.0 #initial_BLUE: 0.0 #initial_WHITE: 0.0 # Vedere la sezione \"led\" per informazioni su questi parametri. Servocomandi aggiuntivi, pulsanti e altri pin \u00b6 [servo] \u00b6 Servo (si pu\u00f2 definire un numero qualsiasi di sezioni con un prefisso \"servo\"). I servo possono essere controllati usando SET_SERVO comando g-code . Ad esempio: SET_SERVO SERVO=my_servo ANGLE=180 [servo my_servo] pin: # Pin di uscita PWM che controlla il servo. Questo parametro deve # essere fornito. #maximum_servo_angle: 180 # L'angolo massimo (in gradi) a cui questo servo pu\u00f2 essere impostato. # L'impostazione predefinita \u00e8 180 gradi. #minimum_pulse_width: 0.001 # La durata minima dell'impulso (in secondi). Questo dovrebbe # corrispondere a un angolo di 0 gradi. Il valore predefinito \u00e8 0.001 secondi. #maximum_pulse_width: 0.002 # La durata massima dell'impulso (in secondi). Questo dovrebbe # corrispondere a un angolo di maximum_servo_angle. Il valore # predefinito \u00e8 0.002 secondi. #initial_angle: # Angolo iniziale (in gradi) su cui impostare il servo. L'impostazione # predefinita \u00e8 di non inviare alcun segnale all'avvio. #initial_pulse_width: # Durata iniziale dell'impulso (in secondi) su cui impostare il servo. # (Questo \u00e8 valido solo se initial_angle non \u00e8 impostato.) # L'impostazione predefinita \u00e8 di non inviare alcun segnale all'avvio. [gcode_button] \u00b6 Esegui gcode quando un pulsante viene premuto o rilasciato (o quando un pin cambia stato). Puoi controllare lo stato del pulsante usando QUERY_BUTTON button=my_gcode_button . [gcode_button my_gcode_button] pin: # Il pin su cui \u00e8 collegato il pulsante. Questo parametro deve essere fornito. #analog_range: # Due resistenze separate da virgole (in Ohm) che specificano l'intervallo # di resistenza minimo e massimo per il pulsante. Se viene fornito # analog_range, il pin deve essere un pin con capacit\u00e0 analogica. # L'impostazione predefinita \u00e8 utilizzare digital gpio per il pulsante. #analog_pullup_resistor: # La resistenza di pullup (in Ohm) quando \u00e8 specificato analog_range. # Il valore predefinito \u00e8 4700 ohm. #press_gcode: # Un elenco di comandi G-Code da eseguire quando si preme il pulsante. # I modelli G-Code sono supportati. Questo parametro deve essere fornito. #release_gcode: # Un elenco di comandi G-Code da eseguire quando il pulsante viene # rilasciato. I modelli G-Code sono supportati. L'impostazione predefinita # \u00e8 di non eseguire alcun comando al rilascio di un pulsante. [output_pin] \u00b6 Pin di uscita configurabili in fase di run-time (\u00e8 possibile definire un numero qualsiasi di sezioni con un prefisso \"output_pin\"). I pin configurati qui verranno impostati come pin di output e sar\u00e0 possibile modificarli in fase di esecuzione utilizzando il comando esteso \"SET_PIN PIN=my_pin VALUE=.1\" comandi g-code . [output_pin my_pin] pin: # Il pin da configurare come output. # Questo parametro deve essere fornito. #pwm: False # Impostare se il pin di uscita deve essere in grado di modulare la # larghezza di impulso PWM. Se questo \u00e8 True, i campi del valore # dovrebbero essere compresi tra 0 e 1; se \u00e8 False i campi del valore # devono essere 0 o 1. Il valore predefinito \u00e8 False. #static_value: # Se \u00e8 valorizzato, il pin viene assegnato a questo valore all'avvio e # il pin non pu\u00f2 essere modificato durante il runtime. Un pin statico # utilizza una ram leggermente inferiore nel microcontrollore. # L'impostazione predefinita prevede l'utilizzo della configurazione # di runtime dei pin. #value: # Il valore su cui impostare inizialmente il pin durante la # configurazione dell'MCU. Il valore predefinito \u00e8 0 (per bassa tensione). #shutdown_value: # Il valore su cui impostare il pin su un evento di arresto dell'MCU. # Il valore predefinito \u00e8 0 (per bassa tensione). #maximum_mcu_duration: # La durata massima di un valore di non spegnimento pu\u00f2 essere # determinato dall'MCU senza un riconoscimento da parte dell'host. # Se l'host non riesce a tenere il passo con un aggiornamento, l'MCU # si spegner\u00e0 e imposter\u00e0 tutti i pin sui rispettivi valori di spegnimento. # Default: 0 (disabilitato) I valori abituali sono circa 5 secondi. #cycle_time: 0.100 # La quantit\u00e0 di tempo (in secondi) per ciclo PWM. Si consiglia di # essere pari o superiore a 10 millisecondi quando si utilizza il PWM # basato su software. Il valore predefinito \u00e8 0.100 secondi per i pin pwm. #hardware_pwm: False # Abilitare questa opzione per utilizzare PWM hardware anzich\u00e9 PWM # software. Quando si utilizza l'hardware PWM, il tempo di ciclo effettivo # \u00e8 vincolato dall'implementazione e pu\u00f2 essere notevolmente diverso # dal tempo di ciclo richiesto. L'impostazione predefinita \u00e8 Falso. #scale: # Questo parametro pu\u00f2 essere utilizzato per modificare il modo in cui # i parametri 'value' e 'shutdown_value' vengono interpretati per i pin # pwm. Se fornito, il parametro 'value' deve essere compreso tra 0.0 e # 'scale'. Questo pu\u00f2 essere utile quando si configura un pin PWM che # controlla un riferimento di tensione stepper. La \"scala\" pu\u00f2 essere # impostata sull'amperaggio dello stepper equivalente se il PWM fosse # completamente abilitato, quindi il parametro \"value\" pu\u00f2 essere # specificato utilizzando l'amperaggio desiderato per lo stepper. # L'impostazione predefinita \u00e8 di non ridimensionare il parametro 'value'. [static_digital_output] \u00b6 Pin di uscita digitali configurati staticamente (\u00e8 possibile definire un numero qualsiasi di sezioni con un prefisso \"static_digital_output\"). I pin configurati qui verranno impostati come uscita GPIO durante la configurazione dell'MCU. Non possono essere modificati in fase di esecuzione. [static_digital_output my_output_pins] pins: # Un elenco separato da virgole di pin da impostare come pin di # output GPIO. Il pin verr\u00e0 impostato su un livello alto a meno che il # nome del pin non sia preceduto da \"!\". Questo parametro deve # essere fornito. [multi_pin] \u00b6 Uscite a pin multipli (si pu\u00f2 definire un numero qualsiasi di sezioni con un prefisso \"multi_pin\"). Un output multi_pin crea un alias pin interno che pu\u00f2 modificare pi\u00f9 pin di output ogni volta che viene impostato il pin alias. Ad esempio, si potrebbe definire un oggetto \"[multi_pin my_fan]\" contenente due pin e quindi impostare \"pin=multi_pin:my_fan\" nella sezione \"[fan]\" - ad ogni cambio di ventola entrambi i pin di output verrebbero aggiornati. Questi alias non possono essere utilizzati con i pin del motore passo-passo. [multi_pin my_multi_pin] pins: # Un elenco separato da virgole di pin associati a questo alias. # Questo parametro deve essere fornito. Configurazione del driver TMC per stepper \u00b6 Configurazione dei driver per motori passo-passo Trinamic in modalit\u00e0 UART/SPI. Ulteriori informazioni si trovano nella TMC Drivers guide e nel command reference . [tmc2130] \u00b6 Configurare un driver per motore passo-passo TMC2130 tramite bus SPI. Per utilizzare questa funzione, definire una sezione di configurazione con un prefisso \"tmc2130\" seguito dal nome della sezione di configurazione dello stepper corrispondente (ad esempio, \"[tmc2130 stepper_x]\"). [tmc2130 stepper_x] cs_pin: # The pin corresponding to the TMC2130 chip select line. This pin # will be set to low at the start of SPI messages and raised to high # after the message completes. This parameter must be provided. #spi_speed: #spi_bus: #spi_software_sclk_pin: #spi_software_mosi_pin: #spi_software_miso_pin: # See the \"common SPI settings\" section for a description of the # above parameters. #chain_position: #chain_length: # These parameters configure an SPI daisy chain. The two parameters # define the stepper position in the chain and the total chain length. # Position 1 corresponds to the stepper that connects to the MOSI signal. # The default is to not use an SPI daisy chain. #interpolate: True # If true, enable step interpolation (the driver will internally # step at a rate of 256 micro-steps). This interpolation does # introduce a small systemic positional deviation - see # TMC_Drivers.md for details. The default is True. run_current: # The amount of current (in amps RMS) to configure the driver to use # during stepper movement. This parameter must be provided. #hold_current: # The amount of current (in amps RMS) to configure the driver to use # when the stepper is not moving. Setting a hold_current is not # recommended (see TMC_Drivers.md for details). The default is to # not reduce the current. #sense_resistor: 0.110 # The resistance (in ohms) of the motor sense resistor. The default # is 0.110 ohms. #stealthchop_threshold: 0 # The velocity (in mm/s) to set the \"stealthChop\" threshold to. When # set, \"stealthChop\" mode will be enabled if the stepper motor # velocity is below this value. The default is 0, which disables # \"stealthChop\" mode. #driver_MSLUT0: 2863314260 #driver_MSLUT1: 1251300522 #driver_MSLUT2: 608774441 #driver_MSLUT3: 269500962 #driver_MSLUT4: 4227858431 #driver_MSLUT5: 3048961917 #driver_MSLUT6: 1227445590 #driver_MSLUT7: 4211234 #driver_W0: 2 #driver_W1: 1 #driver_W2: 1 #driver_W3: 1 #driver_X1: 128 #driver_X2: 255 #driver_X3: 255 #driver_START_SIN: 0 #driver_START_SIN90: 247 # These fields control the Microstep Table registers directly. The optimal # wave table is specific to each motor and might vary with current. An # optimal configuration will have minimal print artifacts caused by # non-linear stepper movement. The values specified above are the default # values used by the driver. The value must be specified as a decimal integer # (hex form is not supported). In order to compute the wave table fields, # see the tmc2130 \"Calculation Sheet\" from the Trinamic website. #driver_IHOLDDELAY: 8 #driver_TPOWERDOWN: 0 #driver_TBL: 1 #driver_TOFF: 4 #driver_HEND: 7 #driver_HSTRT: 0 #driver_PWM_AUTOSCALE: True #driver_PWM_FREQ: 1 #driver_PWM_GRAD: 4 #driver_PWM_AMPL: 128 #driver_SGT: 0 # Set the given register during the configuration of the TMC2130 # chip. This may be used to set custom motor parameters. The # defaults for each parameter are next to the parameter name in the # above list. #diag0_pin: #diag1_pin: # The micro-controller pin attached to one of the DIAG lines of the # TMC2130 chip. Only a single diag pin should be specified. The pin # is \"active low\" and is thus normally prefaced with \"^!\". Setting # this creates a \"tmc2130_stepper_x:virtual_endstop\" virtual pin # which may be used as the stepper's endstop_pin. Doing this enables # \"sensorless homing\". (Be sure to also set driver_SGT to an # appropriate sensitivity value.) The default is to not enable # sensorless homing. [tmc2208] \u00b6 Configurare un driver per motore passo-passo TMC2208 (o TMC2224) tramite UART a filo singolo. Per utilizzare questa funzione, definire una sezione di configurazione con un prefisso \"tmc2208\" seguito dal nome della sezione di configurazione dello stepper corrispondente (ad esempio, \"[tmc2208 stepper_x]\"). [tmc2208 stepper_x] uart_pin: # Il pin collegato al PDN_UART del TMC2208 . # Questo parametro deve essere fornito. #tx_pin: # Se si utilizzano linee di ricezione e trasmissione separate per # comunicare con il driver, impostare uart_pin sul pin di ricezione e # tx_pin sul pin di trasmissione. L'impostazione predefinita \u00e8 usare uart_pin sia per la lettura che per la scrittura. #select_pins: # Un elenco separato da virgole di pin da impostare prima di accedere # all'UART tmc2208. Questo pu\u00f2 essere utile per configurare un mux # analogico per la comunicazione UART. L'impostazione predefinita \u00e8 # di non configurare alcun pin. #interpolate: True # Se True, abilita l'interpolazione del passo (il driver eseguir\u00e0 un passo # intero con 256 micropassi). Questa interpolazione # introduce una piccola deviazione posizionale sistemica - vedere # TMC_Drivers.md per i dettagli. L'impostazione predefinita \u00e8 True. run_current: # La quantit\u00e0 di corrente (in ampere RMS) per configurare il driver da # utilizzare durante il movimento passo-passo. # Questo parametro deve essere fornito. #hold_current: # La quantit\u00e0 di corrente (in ampere RMS) per configurare il driver da # utilizzare quando lo stepper non \u00e8 in movimento. L'impostazione di # hold_current non \u00e8 consigliata (consultare TMC_Drivers.md per i # dettagli). L'impostazione predefinita \u00e8 di non ridurre la corrente. #sense_resistor: 0.110 # La resistenza (in ohm) del resistore di rilevamento del motore. # Il valore predefinito \u00e8 0,110 ohm. #stealthchop_threshold: 0 # La velocit\u00e0 (in mm/s) su cui impostare la soglia \"stealthChop\". Se # impostata, la modalit\u00e0 \"stealthChop\" sar\u00e0 abilitata se la velocit\u00e0 del # motore passo-passo \u00e8 inferiore a questo valore. Il valore predefinito # \u00e8 0, che disabilita la modalit\u00e0 \"stealthChop\". #driver_IHOLDDELAY: 8 #driver_TPOWERDOWN: 20 #driver_TBL: 2 #driver_TOFF: 3 #driver_HEND: 0 #driver_HSTRT: 5 #driver_PWM_AUTOGRAD: True #driver_PWM_AUTOSCALE: True #driver_PWM_LIM: 12 #driver_PWM_REG: 8 #driver_PWM_FREQ: 1 #driver_PWM_GRAD: 14 #driver_PWM_OFS: 36 # Impostare il registro dato durante la configurazione del chip TMC2208. # Pu\u00f2 essere utilizzato per impostare parametri motore personalizzati. # I valori predefiniti per ciascun parametro sono accanto al nome del # parametro nell'elenco precedente. [tmc2209] \u00b6 Configurare un driver per motore passo-passo TMC2209 tramite UART a filo singolo. Per utilizzare questa funzione, definire una sezione di configurazione con un prefisso \"tmc2209\" seguito dal nome della sezione di configurazione dello stepper corrispondente (ad esempio, \"[tmc2209 stepper_x]\"). [tmc2209 stepper_x] uart_pin: #tx_pin: #select_pins: #interpolate: True run_current: #hold_current: #sense_resistor: 0.110 #stealthchop_threshold: 0 # Vedere la sezione \"tmc2208\" per la definizione di questi parametri. #uart_address: # L'indirizzo del chip TMC2209 per i messaggi UART (un numero intero # compreso tra 0 e 3). Viene in genere utilizzato quando pi\u00f9 chip TMC2209 # sono collegati allo stesso pin UART. Il valore predefinito \u00e8 zero #driver_IHOLDDELAY: 8 #driver_TPOWERDOWN: 20 #driver_TBL: 2 #driver_TOFF: 3 #driver_HEND: 0 #driver_HSTRT: 5 #driver_PWM_AUTOGRAD: True #driver_PWM_AUTOSCALE: True #driver_PWM_LIM: 12 #driver_PWM_REG: 8 #driver_PWM_FREQ: 1 #driver_PWM_GRAD: 14 #driver_PWM_OFS: 36 #driver_SGTHRS: 0 # Impostare il registro dato durante la configurazione del chip TMC2209. # Pu\u00f2 essere utilizzato per impostare parametri motore personalizzati. I # valori predefiniti per ciascun parametro sono accanto al nome del # parametro nell'elenco precedente. #diag_pin: # Il pin del microcontrollore collegato alla linea DIAG del chip TMC2209. # Il pin \u00e8 normalmente preceduto da \"^\" per abilitare un pullup. # L'impostazione di questo crea un pin virtuale \"tmc2209_stepper_x:virtual_endstop\" # che pu\u00f2 essere utilizzato come endstop_pin dello stepper. In questo modo # si abilita l'\"homing sensorless\". (Assicurarsi di impostare anche driver_SGTHRS # su un valore di sensibilit\u00e0 appropriato.) L'impostazione predefinita \u00e8 di non # abilitare l'homing sensorless. [tmc2660] \u00b6 Configurare un driver per motore passo-passo TMC2660 tramite bus SPI. Per utilizzare questa funzione, definire una sezione di configurazione con un prefisso tmc2660 seguito dal nome della sezione di configurazione dello stepper corrispondente (ad esempio, \"[tmc2660 stepper_x]\"). [tmc2660 stepper_x] cs_pin: # Il pin corrispondente al pin di selezione del chip TMC2660. Questo pin # verr\u00e0 impostato su basso all'inizio dei messaggi SPI e impostato su # alto al termine del trasferimento del messaggio. Questo parametro # deve essere fornito. #spi_speed: 4000000 # Frequenza bus SPI utilizzata per comunicare con il driver # passo-passo TMC2660. Il valore predefinito \u00e8 4000000. #spi_bus: #spi_software_sclk_pin: #spi_software_mosi_pin: #spi_software_miso_pin: # Vedere la sezione \"impostazioni comuni SPI\" per una descrizione # dei parametri di cui sopra. #interpolate: True # Se true, abilita l'interpolazione del passo (il driver eseguir\u00e0 un passo # interno a una velocit\u00e0 di 256 micropassi). Funziona solo se microsteps # \u00e8 impostato su 16. L'interpolazione introduce una piccola deviazione # posizionale sistemica - vedere TMC_Drivers.md per i dettagli. # L'impostazione predefinita \u00e8 Vero. run_current: # La quantit\u00e0 di corrente (in ampere RMS) utilizzata dal driver durante # il movimento passo-passo. Questo parametro deve essere fornito. #sense_resistor: # La resistenza (in ohm) del resistore di rilevamento del motore. # Questo parametro deve essere fornito. #idle_current_percent: 100 # La percentuale di run_current a cui il driver stepper sar\u00e0 ridotto allo # scadere del timeout di inattivit\u00e0 (\u00e8 necessario impostare il timeout # utilizzando una sezione di configurazione [idle_timeout]). La corrente # verr\u00e0 nuovamente aumentata una volta che lo stepper dovr\u00e0 muoversi # di nuovo. Assicurati di impostarlo su un valore sufficientemente alto in # modo che gli stepper non perdano la loro posizione. C'\u00e8 anche un piccolo # ritardo fino a quando la corrente non viene nuovamente aumentata, # quindi tienine conto quando comandi mosse veloci mentre lo stepper \u00e8 # al minimo. Il valore predefinito \u00e8 100 (nessuna riduzione). #driver_TBL: 2 #driver_RNDTF: 0 #driver_HDEC: 0 #driver_CHM: 0 #driver_HEND: 3 #driver_HSTRT: 3 #driver_TOFF: 4 #driver_SEIMIN: 0 #driver_SEDN: 0 #driver_SEMAX: 0 #driver_SEUP: 0 #driver_SEMIN: 0 #driver_SFILT: 0 #driver_SGT: 0 #driver_SLPH: 0 #driver_SLPL: 0 #driver_DISS2G: 0 #driver_TS2G: 3 # Imposta il parametro indicato durante la configurazione del chip TMC2660. # Questo pu\u00f2 essere utilizzato per impostare parametri del driver personalizzati. # Le impostazioni predefinite per ogni parametro sono accanto al nome del # parametro nell'elenco sopra. Vedere la scheda tecnica del TMC2660 su cosa # fa ogni parametro e quali sono le restrizioni sulle combinazioni di parametri. # Prestare particolare attenzione al registro CHOPCONF, dove l'impostazione # di CHM su zero o uno comporter\u00e0 modifiche al layout (il primo bit di HDEC) # viene interpretato come MSB di HSTRT in questo caso). [tmc5160] \u00b6 Configurare un driver per motore passo-passo TMC5160 tramite bus SPI. Per utilizzare questa funzione, definire una sezione di configurazione con un prefisso \"tmc5160\" seguito dal nome della sezione di configurazione dello stepper corrispondente (ad esempio, \"[tmc5160 stepper_x]\"). [tmc5160 stepper_x] cs_pin: # The pin corresponding to the TMC5160 chip select line. This pin # will be set to low at the start of SPI messages and raised to high # after the message completes. This parameter must be provided. #spi_speed: #spi_bus: #spi_software_sclk_pin: #spi_software_mosi_pin: #spi_software_miso_pin: # See the \"common SPI settings\" section for a description of the # above parameters. #chain_position: #chain_length: # These parameters configure an SPI daisy chain. The two parameters # define the stepper position in the chain and the total chain length. # Position 1 corresponds to the stepper that connects to the MOSI signal. # The default is to not use an SPI daisy chain. #interpolate: True # If true, enable step interpolation (the driver will internally # step at a rate of 256 micro-steps). The default is True. run_current: # The amount of current (in amps RMS) to configure the driver to use # during stepper movement. This parameter must be provided. #hold_current: # The amount of current (in amps RMS) to configure the driver to use # when the stepper is not moving. Setting a hold_current is not # recommended (see TMC_Drivers.md for details). The default is to # not reduce the current. #sense_resistor: 0.075 # The resistance (in ohms) of the motor sense resistor. The default # is 0.075 ohms. #stealthchop_threshold: 0 # The velocity (in mm/s) to set the \"stealthChop\" threshold to. When # set, \"stealthChop\" mode will be enabled if the stepper motor # velocity is below this value. The default is 0, which disables # \"stealthChop\" mode. #driver_MSLUT0: 2863314260 #driver_MSLUT1: 1251300522 #driver_MSLUT2: 608774441 #driver_MSLUT3: 269500962 #driver_MSLUT4: 4227858431 #driver_MSLUT5: 3048961917 #driver_MSLUT6: 1227445590 #driver_MSLUT7: 4211234 #driver_W0: 2 #driver_W1: 1 #driver_W2: 1 #driver_W3: 1 #driver_X1: 128 #driver_X2: 255 #driver_X3: 255 #driver_START_SIN: 0 #driver_START_SIN90: 247 # These fields control the Microstep Table registers directly. The optimal # wave table is specific to each motor and might vary with current. An # optimal configuration will have minimal print artifacts caused by # non-linear stepper movement. The values specified above are the default # values used by the driver. The value must be specified as a decimal integer # (hex form is not supported). In order to compute the wave table fields, # see the tmc2130 \"Calculation Sheet\" from the Trinamic website. #driver_IHOLDDELAY: 6 #driver_TPOWERDOWN: 10 #driver_TBL: 2 #driver_TOFF: 3 #driver_HEND: 2 #driver_HSTRT: 5 #driver_FD3: 0 #driver_TPFD: 4 #driver_CHM: 0 #driver_VHIGHFS: 0 #driver_VHIGHCHM: 0 #driver_DISS2G: 0 #driver_DISS2VS: 0 #driver_PWM_AUTOSCALE: True #driver_PWM_AUTOGRAD: True #driver_PWM_FREQ: 0 #driver_FREEWHEEL: 0 #driver_PWM_GRAD: 0 #driver_PWM_OFS: 30 #driver_PWM_REG: 4 #driver_PWM_LIM: 12 #driver_SGT: 0 #driver_SEMIN: 0 #driver_SEUP: 0 #driver_SEMAX: 0 #driver_SEDN: 0 #driver_SEIMIN: 0 #driver_SFILT: 0 # Set the given register during the configuration of the TMC5160 # chip. This may be used to set custom motor parameters. The # defaults for each parameter are next to the parameter name in the # above list. #diag0_pin: #diag1_pin: # The micro-controller pin attached to one of the DIAG lines of the # TMC5160 chip. Only a single diag pin should be specified. The pin # is \"active low\" and is thus normally prefaced with \"^!\". Setting # this creates a \"tmc5160_stepper_x:virtual_endstop\" virtual pin # which may be used as the stepper's endstop_pin. Doing this enables # \"sensorless homing\". (Be sure to also set driver_SGT to an # appropriate sensitivity value.) The default is to not enable # sensorless homing. Configurazione della corrente del motore passo-passo a run-time \u00b6 [ad5206] \u00b6 Digipot AD5206 configurati staticamente collegati tramite bus SPI (si pu\u00f2 definire un numero qualsiasi di sezioni con un prefisso \"ad5206\"). [ad5206 my_digipot] enable_pin: # The pin corresponding to the AD5206 chip select line. This pin # will be set to low at the start of SPI messages and raised to high # after the message completes. This parameter must be provided. #spi_speed: #spi_bus: #spi_software_sclk_pin: #spi_software_mosi_pin: #spi_software_miso_pin: # See the \"common SPI settings\" section for a description of the # above parameters. #channel_1: #channel_2: #channel_3: #channel_4: #channel_5: #channel_6: # The value to statically set the given AD5206 channel to. This is # typically set to a number between 0.0 and 1.0 with 1.0 being the # highest resistance and 0.0 being the lowest resistance. However, # the range may be changed with the 'scale' parameter (see below). # If a channel is not specified then it is left unconfigured. #scale: # This parameter can be used to alter how the 'channel_x' parameters # are interpreted. If provided, then the 'channel_x' parameters # should be between 0.0 and 'scale'. This may be useful when the # AD5206 is used to set stepper voltage references. The 'scale' can # be set to the equivalent stepper amperage if the AD5206 were at # its highest resistance, and then the 'channel_x' parameters can be # specified using the desired amperage value for the stepper. The # default is to not scale the 'channel_x' parameters. [mcp4451] \u00b6 Digipot MCP4451 configurato staticamente collegato tramite bus I2C (si pu\u00f2 definire un numero qualsiasi di sezioni con un prefisso \"mcp4451\"). [mcp4451 my_digipot] i2c_address: # L'indirizzo i2c utilizzato dal chip sul bus i2c. Questo parametro deve # essere fornito. #i2c_mcu: #i2c_bus: #i2c_speed: # Vedere la sezione \"impostazioni I2C comuni\" per una descrizione # dei parametri di cui sopra. #wiper_0: #wiper_1: #wiper_2: #wiper_3: # Il valore su cui impostare staticamente il \"wiper\" MCP4451 # specificato. Questo \u00e8 in genere impostato su un numero compreso # tra 0,0 e 1,0 con 1,0 come resistenza pi\u00f9 alta e 0,0 come resistenza # pi\u00f9 bassa. Tuttavia, l'intervallo pu\u00f2 essere modificato con il parametro # 'scale' (vedi sotto). Se non viene specificato un wiper, non viene # configurato. #scale: # Questo parametro pu\u00f2 essere utilizzato per modificare il modo in # cui vengono interpretati i parametri 'wiper_x'. Se forniti, i parametri # 'wiper_x' dovrebbero essere compresi tra 0.0 e 'scale'. Questo pu\u00f2 # essere utile quando l'MCP4451 viene utilizzato per impostare i # riferimenti di tensione stepper. La \"scala\" pu\u00f2 essere impostata # sull'amperaggio stepper equivalente se l'MCP4451 fosse alla sua # massima resistenza, quindi i parametri \"wiper_x\" possono essere # specificati utilizzando il valore di amperaggio desiderato per lo # stepper. L'impostazione predefinita \u00e8 di non ridimensionare i # parametri 'wiper_x'. [mcp4728] \u00b6 Convertitore digitale-analogico MCP4728 in configurazione statica collegato tramite bus I2C (\u00e8 possibile definire un numero qualsiasi di sezioni con prefisso \"mcp4728\"). [mcp4728 my_dac] #i2c_address: 96 # L'indirizzo i2c utilizzato dal chip sul bus i2c. Il valore predefinito # \u00e8 96. #i2c_mcu: #i2c_bus: #i2c_speed: # Vedere la sezione \"impostazioni I2C comuni\" per una descrizione # dei parametri di cui sopra. #channel_a: #channel_b: #channel_c: #channel_d: # Il valore su cui impostare staticamente il canale MCP4728 # specificato. Questo \u00e8 in genere impostato su un numero compreso # tra 0,0 e 1,0 con 1,0 come tensione pi\u00f9 alta (2,048 V) e 0,0 come # tensione pi\u00f9 bassa. Tuttavia, l'intervallo pu\u00f2 essere modificato con # il parametro 'scale' (vedi sotto). Se un canale non \u00e8 specificato, # non viene configurato. #scale: # Questo parametro pu\u00f2 essere utilizzato per modificare il modo # in cui vengono interpretati i parametri 'channel_x'. Se forniti, i # parametri 'channel_x' dovrebbero essere compresi tra 0.0 e 'scale'. # Questo pu\u00f2 essere utile quando l'MCP4728 viene utilizzato per # impostare i riferimenti di tensione stepper. La \"scala\" pu\u00f2 essere # impostata sull'amperaggio stepper equivalente se l'MCP4728 # fosse alla sua tensione pi\u00f9 alta (2,048 V), e quindi i parametri # \"channel_x\" possono essere specificati utilizzando il valore di # amperaggio desiderato per lo stepper. L'impostazione # predefinita \u00e8 di non ridimensionare i parametri 'channel_x'. [mcp4018] \u00b6 Digipot MCP4018 configurato staticamente collegato tramite due pin gpio \"bit banging\" (si pu\u00f2 definire un numero qualsiasi di sezioni con un prefisso \"mcp4018\"). [mcp4018 my_digipot] scl_pin: # Il pin \"clock\" SCL. Questo parametro deve essere fornito. sda_pin: # Il pin \"dati\" SDA. Questo parametro deve essere fornito. wiper: # Il valore su cui impostare staticamente il \"Wiper\" MCP4018 # specificato. Questo \u00e8 in genere impostato su un numero compreso # tra 0,0 e 1,0 con 1,0 come resistenza pi\u00f9 alta e 0,0 come resistenza # pi\u00f9 bassa. Tuttavia, l'intervallo pu\u00f2 essere modificato con il # parametro 'scale' (vedi sotto). Questo parametro deve essere fornito. #scale: # Questo parametro pu\u00f2 essere utilizzato per modificare il modo in # cui viene interpretato il parametro 'wiper'. Se fornito, il parametro # 'wiper' dovrebbe essere compreso tra 0.0 e 'scale'. Questo pu\u00f2 essere # utile quando l'MCP4018 viene utilizzato per impostare i riferimenti di # tensione stepper. La \"scala\" pu\u00f2 essere impostata sull'amperaggio # stepper equivalente se l'MCP4018 \u00e8 alla sua massima resistenza, # quindi \u00e8 possibile specificare il parametro \"wiper\" utilizzando il # valore di amperaggio desiderato per lo stepper. L'impostazione # predefinita \u00e8 di non ridimensionare il parametro 'wiper'. Supporto display \u00b6 [display] \u00b6 Supporto per un display collegato al microcontrollore. [display] lcd_type: # The type of LCD chip in use. This may be \"hd44780\", \"hd44780_spi\", # \"st7920\", \"emulated_st7920\", \"uc1701\", \"ssd1306\", or \"sh1106\". # See the display sections below for information on each type and # additional parameters they provide. This parameter must be # provided. #display_group: # The name of the display_data group to show on the display. This # controls the content of the screen (see the \"display_data\" section # for more information). The default is _default_20x4 for hd44780 # displays and _default_16x4 for other displays. #menu_timeout: # Timeout for menu. Being inactive this amount of seconds will # trigger menu exit or return to root menu when having autorun # enabled. The default is 0 seconds (disabled) #menu_root: # Name of the main menu section to show when clicking the encoder # on the home screen. The defaults is __main, and this shows the # the default menus as defined in klippy/extras/display/menu.cfg #menu_reverse_navigation: # When enabled it will reverse up and down directions for list # navigation. The default is False. This parameter is optional. #encoder_pins: # The pins connected to encoder. 2 pins must be provided when using # encoder. This parameter must be provided when using menu. #encoder_steps_per_detent: # How many steps the encoder emits per detent (\"click\"). If the # encoder takes two detents to move between entries or moves two # entries from one detent, try changing this. Allowed values are 2 # (half-stepping) or 4 (full-stepping). The default is 4. #click_pin: # The pin connected to 'enter' button or encoder 'click'. This # parameter must be provided when using menu. The presence of an # 'analog_range_click_pin' config parameter turns this parameter # from digital to analog. #back_pin: # The pin connected to 'back' button. This parameter is optional, # menu can be used without it. The presence of an # 'analog_range_back_pin' config parameter turns this parameter from # digital to analog. #up_pin: # The pin connected to 'up' button. This parameter must be provided # when using menu without encoder. The presence of an # 'analog_range_up_pin' config parameter turns this parameter from # digital to analog. #down_pin: # The pin connected to 'down' button. This parameter must be # provided when using menu without encoder. The presence of an # 'analog_range_down_pin' config parameter turns this parameter from # digital to analog. #kill_pin: # The pin connected to 'kill' button. This button will call # emergency stop. The presence of an 'analog_range_kill_pin' config # parameter turns this parameter from digital to analog. #analog_pullup_resistor: 4700 # The resistance (in ohms) of the pullup attached to the analog # button. The default is 4700 ohms. #analog_range_click_pin: # The resistance range for a 'enter' button. Range minimum and # maximum comma-separated values must be provided when using analog # button. #analog_range_back_pin: # The resistance range for a 'back' button. Range minimum and # maximum comma-separated values must be provided when using analog # button. #analog_range_up_pin: # The resistance range for a 'up' button. Range minimum and maximum # comma-separated values must be provided when using analog button. #analog_range_down_pin: # The resistance range for a 'down' button. Range minimum and # maximum comma-separated values must be provided when using analog # button. #analog_range_kill_pin: # The resistance range for a 'kill' button. Range minimum and # maximum comma-separated values must be provided when using analog # button. display hd44780 \u00b6 Informazioni sulla configurazione dei display hd44780 (utilizzati nei display di tipo \"RepRapDiscount 2004 Smart Controller\"). [display] lcd_type: hd44780 # Set to \"hd44780\" for hd44780 displays. rs_pin: e_pin: d4_pin: d5_pin: d6_pin: d7_pin: # The pins connected to an hd44780 type lcd. These parameters must # be provided. #hd44780_protocol_init: True # Perform 8-bit/4-bit protocol initialization on an hd44780 display. # This is necessary on real hd44780 devices. However, one may need # to disable this on some \"clone\" devices. The default is True. #line_length: # Set the number of characters per line for an hd44780 type lcd. # Possible values are 20 (default) and 16. The number of lines is # fixed to 4. ... display hd44780_spi \u00b6 Informazioni sulla configurazione di un display hd44780_spi - un display 20x04 controllato tramite uno \"shift register\" hardware (che viene utilizzato nelle stampanti basate su mightyboard). [display] lcd_type: hd44780_spi # Set to \"hd44780_spi\" for hd44780_spi displays. latch_pin: spi_software_sclk_pin: spi_software_mosi_pin: spi_software_miso_pin: # The pins connected to the shift register controlling the display. # The spi_software_miso_pin needs to be set to an unused pin of the # printer mainboard as the shift register does not have a MISO pin, # but the software spi implementation requires this pin to be # configured. #hd44780_protocol_init: True # Perform 8-bit/4-bit protocol initialization on an hd44780 display. # This is necessary on real hd44780 devices. However, one may need # to disable this on some \"clone\" devices. The default is True. #line_length: # Set the number of characters per line for an hd44780 type lcd. # Possible values are 20 (default) and 16. The number of lines is # fixed to 4. ... display st7920 \u00b6 Informazioni sulla configurazione dei display st7920 (utilizzati nei display di tipo \"RepRapDiscount 12864 Full Graphic Smart Controller\"). [display] lcd_type: st7920 # Set to \"st7920\" for st7920 displays. cs_pin: sclk_pin: sid_pin: # The pins connected to an st7920 type lcd. These parameters must be # provided. ... display emulazione emulated_st7920 \u00b6 Informazioni sulla configurazione di un display st7920 emulato, presenti in alcuni \"dispositivi touchscreen da 2,4 pollici\" e simili. [display] lcd_type: emulated_st7920 # Set to \"emulated_st7920\" for emulated_st7920 displays. en_pin: spi_software_sclk_pin: spi_software_mosi_pin: spi_software_miso_pin: # The pins connected to an emulated_st7920 type lcd. The en_pin # corresponds to the cs_pin of the st7920 type lcd, # spi_software_sclk_pin corresponds to sclk_pin and # spi_software_mosi_pin corresponds to sid_pin. The # spi_software_miso_pin needs to be set to an unused pin of the # printer mainboard as the st7920 as no MISO pin but the software # spi implementation requires this pin to be configured. ... display uc1701 \u00b6 Informazioni sulla configurazione dei display uc1701 (utilizzati nei display di tipo \"MKS Mini 12864\"). [display] lcd_type: uc1701 # Set to \"uc1701\" for uc1701 displays. cs_pin: a0_pin: # The pins connected to a uc1701 type lcd. These parameters must be # provided. #rst_pin: # The pin connected to the \"rst\" pin on the lcd. If it is not # specified then the hardware must have a pull-up on the # corresponding lcd line. #contrast: # The contrast to set. The value may range from 0 to 63 and the # default is 40. ... display ssd1306 e sh1106 \u00b6 Informazioni sulla configurazione dei display ssd1306 e sh1106. [display] lcd_type: # Set to either \"ssd1306\" or \"sh1106\" for the given display type. #i2c_mcu: #i2c_bus: #i2c_speed: # Optional parameters available for displays connected via an i2c # bus. See the \"common I2C settings\" section for a description of # the above parameters. #cs_pin: #dc_pin: #spi_speed: #spi_bus: #spi_software_sclk_pin: #spi_software_mosi_pin: #spi_software_miso_pin: # The pins connected to the lcd when in \"4-wire\" spi mode. See the # \"common SPI settings\" section for a description of the parameters # that start with \"spi_\". The default is to use i2c mode for the # display. #reset_pin: # A reset pin may be specified on the display. If it is not # specified then the hardware must have a pull-up on the # corresponding lcd line. #contrast: # The contrast to set. The value may range from 0 to 256 and the # default is 239. #vcomh: 0 # Set the Vcomh value on the display. This value is associated with # a \"smearing\" effect on some OLED displays. The value may range # from 0 to 63. Default is 0. #invert: False # TRUE inverts the pixels on certain OLED displays. The default is # False. #x_offset: 0 # Set the horizontal offset value on SH1106 displays. The default is # 0. ... [display_data] \u00b6 Supporto per la visualizzazione di dati personalizzati su uno schermo LCD. \u00c8 possibile creare un numero qualsiasi di gruppi di visualizzazione e un numero qualsiasi di elementi di dati in quei gruppi. Il display mostrer\u00e0 tutti gli elementi di dati per un determinato gruppo se l'opzione display_group nella sezione [display] \u00e8 impostata sul nome del gruppo specificato. Viene creato automaticamente un default set of display groups . \u00c8 possibile sostituire o estendere questi elementi display_data sovrascrivendo i valori predefiniti nel file di configurazione principale printer.cfg . [display_data my_group_name my_data_name] position: # Comma separated row and column of the display position that should # be used to display the information. This parameter must be # provided. text: # The text to show at the given position. This field is evaluated # using command templates (see docs/Command_Templates.md). This # parameter must be provided. [display_template] \u00b6 Visualizza il testo dei dati \"macro\" (\u00e8 possibile definire un numero qualsiasi di sezioni con un prefisso display_template). Per informazioni sul template, vedere il documento template di comandi . Questa funzione consente di ridurre le definizioni ripetitive nelle sezioni display_data. Si pu\u00f2 usare la funzione incorporata render() nelle sezioni display_data per valutare un template. Per esempio, se si dovesse definire [display_template my_template] allora si potrebbe usare { render('my_template') } in una sezione display_data. Questa funzione pu\u00f2 essere utilizzata anche per aggiornamenti LED continui utilizzando il comando SET_LED_TEMPLATE . [display_template my_template_name] #param_<name>: # One may specify any number of options with a \"param_\" prefix. The # given name will be assigned the given value (parsed as a Python # literal) and will be available during macro expansion. If the # parameter is passed in the call to render() then that value will # be used during macro expansion. For example, a config with # \"param_speed = 75\" might have a caller with # \"render('my_template_name', param_speed=80)\". Parameter names may # not use upper case characters. text: # The text to return when the this template is rendered. This field # is evaluated using command templates (see # docs/Command_Templates.md). This parameter must be provided. [display_glyph] \u00b6 Visualizza un glifo personalizzato sui display che lo supportano. Al nome dato verranno assegnati i dati di visualizzazione dati che possono quindi essere referenziati nei modelli di visualizzazione con il loro nome circondato da due simboli \"tilde\" per esempio ~my_display_glyph~ Vedere sample-glyphs.cfg per alcuni esempi. [display_glyph my_display_glyph] #data: # The display data, stored as 16 lines consisting of 16 bits (1 per # pixel) where '.' is a blank pixel and '*' is an on pixel (e.g., # \"****************\" to display a solid horizontal line). # Alternatively, one can use '0' for a blank pixel and '1' for an on # pixel. Put each display line into a separate config line. The # glyph must consist of exactly 16 lines with 16 bits each. This # parameter is optional. #hd44780_data: # Glyph to use on 20x4 hd44780 displays. The glyph must consist of # exactly 8 lines with 5 bits each. This parameter is optional. #hd44780_slot: # The hd44780 hardware index (0..7) to store the glyph at. If # multiple distinct images use the same slot then make sure to only # use one of those images in any given screen. This parameter is # required if hd44780_data is specified. [display my_extra_display] \u00b6 Se in printer.cfg \u00e8 stata definita una sezione primaria [display] come mostrato sopra, \u00e8 possibile definire pi\u00f9 display ausiliari. Si noti che i display ausiliari attualmente non supportano la funzionalit\u00e0 del menu, quindi non supportano le opzioni del \"menu\" o la configurazione dei pulsanti. [display my_extra_display] # Vedere la sezione \"display\" per i parametri disponibili. [menu] \u00b6 Menu display lcd personalizzabili. Viene creato automaticamente un default set of menus . \u00c8 possibile sostituire o estendere il menu sovrascrivendo le impostazioni predefinite nel file di configurazione principale printer.cfg . Consulta il command template document per informazioni sugli attributi di menu disponibili durante il rendering del modello. # Common parameters available for all menu config sections. #[menu __some_list __some_name] #type: disabled # Permanently disabled menu element, only required attribute is 'type'. # Allows you to easily disable/hide existing menu items. #[menu some_name] #type: # One of command, input, list, text: # command - basic menu element with various script triggers # input - same like 'command' but has value changing capabilities. # Press will start/stop edit mode. # list - it allows for menu items to be grouped together in a # scrollable list. Add to the list by creating menu # configurations using \"some_list\" as a prefix - for # example: [menu some_list some_item_in_the_list] # vsdlist - same as 'list' but will append files from virtual sdcard # (will be removed in the future) #name: # Name of menu item - evaluated as a template. #enable: # Template that evaluates to True or False. #index: # Position where an item needs to be inserted in list. By default # the item is added at the end. #[menu some_list] #type: list #name: #enable: # See above for a description of these parameters. #[menu some_list some_command] #type: command #name: #enable: # See above for a description of these parameters. #gcode: # Script to run on button click or long click. Evaluated as a # template. #[menu some_list some_input] #type: input #name: #enable: # See above for a description of these parameters. #input: # Initial value to use when editing - evaluated as a template. # Result must be float. #input_min: # Minimum value of range - evaluated as a template. Default -99999. #input_max: # Maximum value of range - evaluated as a template. Default 99999. #input_step: # Editing step - Must be a positive integer or float value. It has # internal fast rate step. When \"(input_max - input_min) / # input_step > 100\" then fast rate step is 10 * input_step else fast # rate step is same input_step. #realtime: # This attribute accepts static boolean value. When enabled then # gcode script is run after each value change. The default is False. #gcode: # Script to run on button click, long click or value change. # Evaluated as a template. The button click will trigger the edit # mode start or end. Sensori di filamento \u00b6 [filament_switch_sensor] \u00b6 Sensore del filamento a interruttore. Supporto per l'inserimento del filamento e il rilevamento dell'esaurimento tramite un sensore interruttore, come un interruttore di fine corsa. Per ulteriori informazioni, vedere command reference . [filament_switch_sensor my_sensor] #pause_on_runout: True # Se impostato su True, verr\u00e0 eseguita una PAUSA immediatamente # dopo il rilevamento di un'eccentricit\u00e0. Si noti che se pause_on_runout # \u00e8 False e runout_gcode viene omesso, il rilevamento dell'eccentricit\u00e0 # \u00e8 disabilitato. L'impostazione predefinita \u00e8 Vero. #runout_gcode: # Un elenco di comandi G-Code da eseguire dopo il rilevamento di # un'esaurimento del filamento. Vedi docs/Command_Templates.md # per il formato G-Code. Se pause_on_runout \u00e8 impostato su True, # questo codice G verr\u00e0 eseguito al termine della PAUSA. # L'impostazione predefinita \u00e8 di non eseguire alcun comando G-Code. #insert_gcode: # Un elenco di comandi G-Code da eseguire dopo il rilevamento # dell'inserimento di filamento. Vedi docs/Command_Templates.md # per il formato G-Code. L'impostazione predefinita non prevede # l'esecuzione di alcun comando G-Code, che disabilita il rilevamento # dell'inserimento. #event_delay: 3.0 # Il tempo minimo in secondi per ritardare tra gli eventi. Gli eventi # attivati durante questo periodo di tempo verranno ignorati # silenziosamente. L'impostazione predefinita \u00e8 3 secondi. #pause_delay: 0.5 # Il tempo di ritardo, in secondi, tra l'invio del comando pause e # l'esecuzione di runout_gcode. Potrebbe essere utile aumentare # questo ritardo se OctoPrint mostra uno strano comportamento # di pausa. Il valore predefinito \u00e8 0,5 secondi. #switch_pin: # Il pin su cui \u00e8 collegato l'interruttore. # Questo parametro deve essere fornito. [filament_motion_sensor] \u00b6 Sensore di movimento del filamento. Supporto per l'inserimento del filamento e il rilevamento dell'esaurimento mediante un codificatore che commuta il pin di uscita durante il movimento del filamento attraverso il sensore. Per ulteriori informazioni, vedere command reference . [filament_motion_sensor my_sensor] detection_length: 7.0 # La lunghezza minima di filamento tirato attraverso il sensore # per attivare un cambio di stato su switch_pin # Il default \u00e8 7 mm. extruder: # Nome della sezione extruder section con cui questo sensore \u00e8 associato. # Questo parametro deve essere fornito. switch_pin: #pause_on_runout: #runout_gcode: #insert_gcode: #event_delay: #pause_delay: # Vedere la sezione \"filament_switch_sensor\" per la descrizione dei # parametri riportati sopra. [tsl1401cl_filament_width_sensor] \u00b6 Sensore di larghezza del filamento basato su TSLl401CL. Consulta la guida per ulteriori informazioni. sl1401cl_filament_width_sensor] #pin: #diametro nominale del filamento predefinito: 1,75 (mm) # Differenza massima consentita del diametro del filamento in mm. #max_difference: 0.2 # La distanza dal sensore alla camera di fusione in mm. #measurement_delay: 100 [hall_filament_width_sensor] \u00b6 Sensore di larghezza del filamento ad effetto Hall (vedere Sensore di larghezza del filamento Hall ). [hall_filament_width_sensor] adc1: adc2: # Pin di ingresso analogico collegati al sensore. # Questi parametri devono essere forniti. #cal_dia1: 1.50 #cal_dia2: 2.00 # I valori di calibrazione (in mm) per i sensori. Il valore predefinito # \u00e8 1.50 per cal_dia1 e 2.00 per cal_dia2. #raw_dia1: 9500 #raw_dia2: 10500 # I valori di calibrazione grezzi per i sensori. Il valore predefinito \u00e8 # 9500 per raw_dia1 e 10500 per raw_dia2. #default_nominal_filament_diameter: 1.75 # Il diametro nominale del filamento. # Questo parametro deve essere fornito. #max_difference: 0.200 # Differenza massima consentita del diametro del filamento in # millimetri (mm). Se la differenza tra il diametro nominale del # filamento e l'uscita del sensore \u00e8 maggiore di +- max_difference, # il moltiplicatore di estrusione viene riportato a %100. # Il valore predefinito \u00e8 0,200. #measurement_delay: 70 # La distanza dal sensore alla camera di fusione/hot-end in # millimetri (mm). Il filamento tra il sensore e l'hot-end verr\u00e0 # trattato come default_nominal_filament_diameter. Il modulo # host funziona con la logica FIFO. Mantiene ogni valore e posizione # del sensore in un array e li riporta nella posizione corretta. # Questo parametro deve essere fornito. #enable: False # Sensore abilitato o disabilitato dopo l'accensione. L'impostazione predefinita \u00e8 disabilitare. #measurement_interval: 10 # La distanza approssimativa (in mm) tra le letture del sensore. # Il valore predefinito \u00e8 10 mm. #logging: False # Il log esterno al terminale e klipper.log pu\u00f2 essere # attivato|off tramite comando. #min_diameter: 1.0 # Diametro minimo per trigger filament_switch_sensor virtuale. #use_current_dia_while_delay: False # Utilizzare il diametro attuale invece del diametro nominale # mentre il ritardo di misurazione non \u00e8 trascorso. #pause_on_runout: #runout_gcode: #insert_gcode: #event_delay: #pause_delay: # Vedere la sezione \"filament_switch_sensor\" per una # descrizione dei parametri di cui sopra. Supporto hardware per specifica scheda \u00b6 [sx1509] \u00b6 Configurare un'espansione SX1509 da I2C a GPIO. A causa del ritardo dovuto alla comunicazione I2C, NON utilizzare i pin SX1509 come abilitazione stepper, pin step o dir o qualsiasi altro pin che richieda un bit banging veloce. Sono utilizzati al meglio come uscite digitali statiche o controllate da gcode o pin hardware-pwm per es. fan. Si pu\u00f2 definire un numero qualsiasi di sezioni con un prefisso \"sx1509\". Ogni espansione fornisce un set di 16 pin (da sx1509_my_sx1509:PIN_0 a sx1509_my_sx1509:PIN_15) che possono essere utilizzati nella configurazione della stampante. Per un esempio, vedere il file generic-duet2-duex.cfg . [sx1509 my_sx1509] i2c_address: # Indirizzo I2C utilizzato da questa espansione. A seconda dei # ponticelli hardware \u00e8 uno dei seguenti indirizzi: 62 63 112 113. # Questo parametro deve essere fornito. #i2c_mcu: #i2c_bus: #i2c_speed: # Vedere la sezione \"impostazioni comuni I2C\" per una # escrizione dei parametri di cui sopra. #i2c_bus: # Se l'implementazione I2C del tuo microcontrollore supporta # pi\u00f9 bus I2C, puoi specificare qui il nome del bus. L'impostazione # predefinita prevede l'utilizzo del bus i2c del microcontrollore # predefinito. [samd_sercom] \u00b6 Configurazione SAMD SERCOM per specificare quali pin utilizzare su un determinato SERCOM. Si pu\u00f2 definire un numero qualsiasi di sezioni con un prefisso \"samd_sercom\". Ogni SERCOM deve essere configurato prima di utilizzarlo come periferica SPI o I2C. Posiziona questa sezione di configurazione sopra qualsiasi altra sezione che fa uso di bus SPI o I2C. [samd_sercom my_sercom] sercom: # Il nome del bus Sercom da configurare nel microcontrollore. I nomi # disponibili sono \"sercom0\", \"sercom1\", ecc. # Questo parametro deve essere fornito. tx_pin: # Pin MOSI per la comunicazione SPI o pin SDA (dati) per la # comunicazione I2C. Il pin deve avere una configurazione pinmux # valida per la specifica periferica SERCOM. # Questo parametro deve essere fornito. #rx_pin: # Pin MISO per la comunicazione SPI. Questo pin non viene utilizzato # per la comunicazione I2C (I2C utilizza tx_pin sia per l'invio che per la # ricezione). Il pin deve avere una configurazione pinmux valida per la # specifica periferica SERCOM. Questo parametro \u00e8 facoltativo. clk_pin: # Pin CLK per la comunicazione SPI o pin SCL (clock) per la # comunicazione I2C. Il pin deve avere una configurazione pinmux # valida per la specifica periferica SERCOM. Questo parametro deve # essere fornito. [adc_scaled] \u00b6 Scaling analogico di Duet2 Maestro tramite letture vref e vssa. La definizione di una sezione adc_scaled abilita pin adc virtuali (come \"my_name:PB0\") che vengono regolati automaticamente dai pin di monitoraggio vref e vssa della scheda. Assicurati di definire questa sezione di configurazione sopra qualsiasi sezione di configurazione che utilizza uno di questi pin virtuali. Per un esempio, vedere il file generic-duet2-maestro.cfg . [adc_scaled my_name] vref_pin: # The ADC pin to use for VREF monitoring. This parameter must be # provided. vssa_pin: # The ADC pin to use for VSSA monitoring. This parameter must be # provided. #smooth_time: 2.0 # A time value (in seconds) over which the vref and vssa # measurements will be smoothed to reduce the impact of measurement # noise. The default is 2 seconds. [replicape] \u00b6 Supporto per Replicape: vedere la guida beaglebone e il file generic-replicape.cfg per un esempio. # La sezione di configurazione \"replicape\" aggiunge i pin di abilitazione # dello stepper virtuale \"replicape: stepper_x_enable\" (per stepper X, Y, Z, # E e H) e i pin di uscita PWM \"replicape: power_x\" (per hotbed, e, h, fan0, # fan1 , fan2 e fan3) che possono quindi essere utilizzati altrove nel file # di configurazione. [replicape] revision: # La revisione dell'hardware di replicape. Attualmente \u00e8 supportata solo # la revisione \"B3\". Questo parametro deve essere fornito. #enable_pin: !gpio0_20 # Il pin di abilitazione globale dei replicape. L'impostazione predefinita # \u00e8 !gpio0_20 (aka P9_41). host_mcu: # Il nome della sezione mcu config che comunica con l'istanza mcu # \"linux process\" di Klipper. Questo parametro deve essere fornito. #standstill_power_down: False # Questo parametro controlla la linea CFG6_ENN su tutti i motori # passo-passo. True imposta le righe di abilitazione su \"open\". # L'impostazione predefinita \u00e8 Falso. #stepper_x_microstep_mode: #stepper_y_microstep_mode: #stepper_z_microstep_mode: #stepper_e_microstep_mode: #stepper_h_microstep_mode: # Questo parametro controlla i pin CFG1 e CFG2 del driver del motore # passo-passo specificato. Le opzioni disponibili sono: disabilita, 1, 2, # spread2, 4, 16, spread4, spread16, stealth4 e stealth16. L'impostazione # predefinita \u00e8 disabilitata. #stepper_x_current: #stepper_y_current: #stepper_z_current: #stepper_e_current: #stepper_h_current: # La corrente massima configurata (in Amp) del driver del motore # passo-passo. Questo parametro deve essere fornito se lo stepper non # \u00e8 in modalit\u00e0 disabilitazione. #stepper_x_chopper_off_time_high: #stepper_y_chopper_off_time_high: #stepper_z_chopper_off_time_high: #stepper_e_chopper_off_time_high: #stepper_h_chopper_off_time_high: # Questo parametro controlla il pin CFG0 del driver del motore # passo-passo (True imposta CFG0 alto, False lo imposta basso). # L'impostazione predefinita \u00e8 False. #stepper_x_chopper_hysteresis_high: #stepper_y_chopper_hysteresis_high: #stepper_z_chopper_hysteresis_high: #stepper_e_chopper_hysteresis_high: #stepper_h_chopper_hysteresis_high: # Questo parametro controlla il pin CFG4 del driver del motore # passo-passo (True imposta CFG4 alto, False lo imposta basso). # L'impostazione predefinita \u00e8 False. #stepper_x_chopper_blank_time_high: #stepper_y_chopper_blank_time_high: #stepper_z_chopper_blank_time_high: #stepper_e_chopper_blank_time_high: #stepper_h_chopper_blank_time_high: # Questo parametro controlla il pin CFG5 del driver del motore # passo-passo (True imposta CFG5 alto, False lo imposta basso). # L'impostazione predefinita \u00e8 True. Altri moduli personalizzati \u00b6 [palette2] \u00b6 Supporto multimateriale Palette 2: fornisce un'integrazione pi\u00f9 stretta supportando i dispositivi Palette 2 in modalit\u00e0 connessa. Questo modulo richiede anche [virtual_sdcard] e [pause_resume] per la piena funzionalit\u00e0. Se si utilizza questo modulo, non utilizzare il plug-in Palette 2 per Octoprint poich\u00e9 entreranno in conflitto e 1 non si inizializzer\u00e0 correttamente, probabilmente interrompendo la stampa. Se utilizzi Octoprint e esegui lo streaming di gcode sulla porta seriale invece di stampare da virtual_sd, rimuovere M1 e M0 da Pausa dei comandi in Impostazioni > Connessione seriale > Firmware e protocollo eviter\u00e0 la necessit\u00e0 per avviare la stampa sulla tavolozza 2 e riattivare la pausa in Octoprint per avviare la stampa. [palette2] serial: # La porta seriale per la connessione alla Palette 2. #baud: 115200 # La velocit\u00e0 da utilizzare. Il valore predefinito \u00e8 115200. #feedrate_splice: 0.8 # L'avanzamento da utilizzare durante la giunzione # il valore predefinito \u00e8 0.8 #feedrate_normal: 1.0 # L'avanzamento da utilizzare dopo la giunzione # il valore predefinito \u00e8 1.0 #auto_load_speed: 2 # Avanzamento di estrusione durante il caricamento automatico # il valore predefinito \u00e8 2 (mm/s) #auto_cancel_variation: 0.1 # Annullamento automatico della stampa quando la variazione # del ping \u00e8 superiore a questa soglia [angle] \u00b6 Supporto per sensore magnetico Hall per la lettura delle misurazioni dell'angolo del motore passo-passo utilizzando i chip SPI a1333, as5047d o tle5012b. Le misurazioni sono disponibili tramite Server API e strumento di analisi del movimento . Vedere il Riferimento G-Code per i comandi disponibili. [angle my_angle_sensor] sensor_type: # The type of the magnetic hall sensor chip. Available choices are # \"a1333\", \"as5047d\", and \"tle5012b\". This parameter must be # specified. #sample_period: 0.000400 # The query period (in seconds) to use during measurements. The # default is 0.000400 (which is 2500 samples per second). #stepper: # The name of the stepper that the angle sensor is attached to (eg, # \"stepper_x\"). Setting this value enables an angle calibration # tool. To use this feature, the Python \"numpy\" package must be # installed. The default is to not enable angle calibration for the # angle sensor. cs_pin: # The SPI enable pin for the sensor. This parameter must be provided. #spi_speed: #spi_bus: #spi_software_sclk_pin: #spi_software_mosi_pin: #spi_software_miso_pin: # See the \"common SPI settings\" section for a description of the # above parameters. Parametri bus comuni \u00b6 Impostazioni SPI comuni \u00b6 I seguenti parametri sono generalmente disponibili per i dispositivi che utilizzano un bus SPI. #spi_speed: # La velocit\u00e0 SPI (in Hz) da utilizzare durante la comunicazione con il # dispositivo. L'impostazione predefinita dipende dal tipo di dispositivo. #spi_bus: # Se il microcontrollore supporta pi\u00f9 bus SPI, \u00e8 possibile specificare # qui il nome del bus del microcontrollore. L'impostazione predefinita # dipende dal tipo di microcontrollore. #spi_software_sclk_pin: #spi_software_mosi_pin: #spi_software_miso_pin: # Specificare i parametri di cui sopra per utilizzare \"SPI basato su # software\". Questa modalit\u00e0 non richiede il supporto hardware del # microcontrollore (in genere \u00e8 possibile utilizzare qualsiasi pin generico). # L'impostazione predefinita \u00e8 di non utilizzare \"spi software\". Impostazioni I2C comuni \u00b6 I seguenti parametri sono generalmente disponibili per i dispositivi che utilizzano un bus I2C. Si noti che l'attuale supporto del microcontrollore di Klipper per i2c generalmente non tollera il rumore di linea. Errori imprevisti sui cavi i2c possono causare la generazione di un errore di runtime da parte di Klipper. Il supporto di Klipper per il ripristino degli errori varia a seconda del tipo di microcontrollore. In genere si consiglia di utilizzare solo dispositivi i2c che si trovano sulla stessa scheda a circuito stampato del microcontrollore. La maggior parte delle implementazioni del microcontrollore Klipper supporta solo un i2c_speed di 100000. Il microcontrollore \"linux\" Klipper supporta una velocit\u00e0 400000, ma deve essere impostato nel sistema operativo e il parametro i2c_speed viene altrimenti ignorato. Il microcontrollore Klipper \"rp2040\" supporta una velocit\u00e0 di 400000 tramite il parametro i2c_speed . Tutti gli altri microcontrollori Klipper utilizzano una frequenza di 100000 e ignorano il parametro i2c_speed . #i2c_address: # L'indirizzo i2c del dispositivo. Questo deve essere specificato # come numero decimale (non in esadecimale). L'impostazione # predefinita dipende dal tipo di dispositivo. #i2c_mcu: # Il nome del microcontrollore a cui \u00e8 collegato il chip. # L'impostazione predefinita \u00e8 \"mcu\". #i2c_bus: # Se il microcontrollore supporta pi\u00f9 bus I2C, \u00e8 possibile # specificare qui il nome del bus del microcontrollore. # L'impostazione predefinita dipende dal tipo di microcontrollore. #i2c_speed: # La velocit\u00e0 I2C (in Hz) da utilizzare durante la comunicazione # con il dispositivo. L'implementazione di Klipper sulla maggior # parte dei microcontrollori \u00e8 codificata a 100000 e la modifica # di questo valore non ha alcun effetto. # Il valore predefinito \u00e8 100000.","title":"Riferimenti configurazione"},{"location":"Config_Reference.html#riferimenti-configurazione","text":"Questo documento \u00e8 un riferimento per le opzioni disponibili nel file di configurazione di Klipper. Le descrizioni in questo documento sono formattate in modo che sia possibile tagliarle e incollarle in un file di configurazione della stampante. Consulta il documento di installazione per informazioni sulla configurazione di Klipper e sulla scelta di un file di configurazione iniziale.","title":"Riferimenti configurazione"},{"location":"Config_Reference.html#configurazione-del-microcontrollore","text":"","title":"Configurazione del microcontrollore"},{"location":"Config_Reference.html#formato-dei-nomi-dei-pin-del-microcontrollore","text":"Molte opzioni di configurazione richiedono il nome di un pin del microcontrollore. Klipper usa i nomi hardware per questi pin, ad esempio \"PA4\". I nomi dei pin possono essere preceduti da ! per indicare che deve essere utilizzata una polarit\u00e0 inversa (ad esempio, trigger su basso anzich\u00e9 alto). I pin di input possono essere preceduti da ^ per indicare che un resistore di pull-up hardware deve essere abilitato per il pin. Se il microcontrollore supporta resistori pull-down, un pin di ingresso pu\u00f2 in alternativa essere preceduto da ~ . Nota, alcune sezioni di configurazione potrebbero \"creare\" pin aggiuntivi. Quando ci\u00f2 si verifica, la sezione di configurazione che definisce i pin deve essere elencata nel file di configurazione prima di qualsiasi sezione che utilizza tali pin.","title":"Formato dei nomi dei pin del microcontrollore"},{"location":"Config_Reference.html#mcu","text":"Configurazione del microcontrollore primario. [mcu] serial: # La porta seriale per la connessione all'MCU. In caso di dubbi (o se # cambia) vedere \"Dov'\u00e8 la mia porta seriale?\" sezione delle FAQ. # Questo parametro deve essere fornito quando si utilizza una # porta seriale. #baud: 250000 # La velocit\u00e0 di trasmissione da utilizzare. Il valore predefinito \u00e8 250000. #canbus_uuid: # Se si utilizza un dispositivo collegato a un bus CAN, questo imposta # l'identificatore univoco del chip a cui connettersi. Questo valore deve # essere fornito quando si utilizza il bus CAN per la comunicazione. #canbus_interface: # Se si utilizza un dispositivo collegato a un bus CAN, viene impostata # l'interfaccia di rete CAN da utilizzare. L'impostazione predefinita \u00e8 'can0'. #restart_method: # Questo controlla il meccanismo che l'host utilizzer\u00e0 per reimpostare # il microcontrollore. Le scelte sono \"arduino\", \"cheetah\", \"rpi_usb\" e # \"command\". Il metodo 'arduino' (attiva/disattiva DTR) \u00e8 comune su # schede Arduino e cloni. Il metodo 'cheetah' \u00e8 un metodo speciale # necessario per alcune schede Fysetc Cheetah. Il metodo \"rpi_usb\" # \u00e8 utile sulle schede Raspberry Pi con microcontrollori alimentati # tramite USB: disabilita brevemente l'alimentazione a tutte le porte # USB per eseguire un ripristino del microcontrollore. Il metodo # \"comando\" prevede l'invio di un comando Klipper al microcontrollore # in modo che possa reimpostarsi. L'impostazione predefinita \u00e8 # 'arduino' se il microcontrollore comunica su una porta seriale, # altrimenti 'comando'.","title":"[mcu]"},{"location":"Config_Reference.html#mcu-my_extra_mcu","text":"Microcontrollori aggiuntivi (si pu\u00f2 definire un numero qualsiasi di sezioni con un prefisso \"mcu\"). Microcontrollori aggiuntivi introducono pin aggiuntivi che possono essere configurati come riscaldatori, stepper, ventole, ecc. Ad esempio, se viene introdotta una sezione \"[mcu extra_mcu]\", i pin come \"extra_mcu:ar9\" possono quindi essere utilizzati altrove nella configurazione (dove \"ar9\" \u00e8 un nome pin hardware o un nome alias sul dato mcu). [mcu my_extra_mcu] # Vedere la sezione \"mcu\" per i parametri di configurazione.","title":"[mcu my_extra_mcu]"},{"location":"Config_Reference.html#impostazioni-cinematiche-comuni","text":"","title":"Impostazioni cinematiche comuni"},{"location":"Config_Reference.html#printer","text":"La sezione printer controlla le impostazioni di alto livello della stampante. [printer] kinematics: # Il tipo di stampante in uso. Questa opzione pu\u00f2 essere una delle # seguenti: cartesian, corexy, corexz, hybrid_corexy, hybrid_corexz, # rotary_delta, delta, deltesian, polar, winch o nessuno. # Questo parametro deve essere specificato. max_velocity: # Velocit\u00e0 massima (in mm/s) della testa di stampa (relativa alla stampa). # Questo parametro deve essere specificato. max_accel: # Accelerazione massima (in mm/s^2) della testina (relativa alla stampa). # Questo parametro deve essere specificato. #max_accel_to_decel: # Una pseudo accelerazione (in mm/s^2) che controlla la velocit\u00e0 con cui # la testa di stampa pu\u00f2 passare dall'accelerazione alla decelerazione. Viene # utilizzato per ridurre la velocit\u00e0 massima di brevi movimenti a zig-zag # (e quindi ridurre le vibrazioni della stampante dovute a questi movimenti). # Il valore predefinito \u00e8 met\u00e0 di max_accel. #square_corner_velocity: 5.0 # La velocit\u00e0 massima (in mm/s) alla quale la testa di stampa pu\u00f2 viaggiare # su un angolo di 90 gradi. Un valore diverso da zero pu\u00f2 ridurre le variazioni # delle portate dell'estrusore consentendo variazioni istantanee della velocit\u00e0 # della testa utensile durante le curve. Questo valore configura l'algoritmo # interno di cornering della velocit\u00e0 centripeta; gli angoli con angoli maggiori # di 90 gradi avranno una velocit\u00e0 in curva maggiore mentre gli angoli con # angoli inferiori a 90 gradi avranno una velocit\u00e0 in curva inferiore. Se questo # \u00e8 impostato su zero, la testa utensile decelerer\u00e0 fino a zero ad ogni angolo. # Il valore predefinito \u00e8 5 mm/s.","title":"[printer]"},{"location":"Config_Reference.html#stepper","text":"Definizioni di motori passo-passo. Diversi tipi di stampante (come specificato dall'opzione \"cinematica\" nella sezione di configurazione [stampante]) richiedono nomi diversi per lo stepper (ad esempio, stepper_x vs stepper_a ). Di seguito sono riportate le definizioni comuni di stepper. Vedere il documento distanza di rotazione per informazioni sul calcolo del parametro rotation_distance . Consultare il documento Multi-MCU homing per informazioni sull'homing utilizzando pi\u00f9 microcontrollori. [stepper_x] step_pin: # Pin GPIO Step (attivato in alto) . Questo parametro deve essere fornito. dir_pin: # Pin GPIO di direzione (alto indica una direzione positiva). # Questo parametro deve essere fornito. enable_pin: # Pin GPIO di abilitazione (l'impostazione predefinita \u00e8 abilita alto; usa ! # per indicare abilita basso). Se questo parametro non viene fornito, il # driver del motore passo-passo deve essere sempre abilitato. rotation_distance: # Distanza (in mm) che l'asse percorre con una rotazione completa del # motore passo-passo (o viene specificata la marcia finale del rapporto di # trasmissione). Questo parametro deve essere fornito. microsteps: # Il numero di micropassi utilizzati dal driver del motore passo-passo. # Questo parametro deve essere fornito. #full_steps_per_rotation: 200 # Il numero di passi completi per una rotazione del motore passo-passo. # Impostarlo su 200 per un motore passo-passo da 1.8 gradi o su 400 per # un motore da 0.9 gradi. Il valore predefinito \u00e8 200. #gear_ratio: # Il rapporto di trasmissione se il motore passo-passo \u00e8 collegato all'asse # tramite un riduttore. Ad esempio, si pu\u00f2 specificare \"5:1\" se \u00e8 in uso un # riduttore 5 a 1. Se l'asse ha pi\u00f9 riduttori, \u00e8 possibile specificare un elenco # di rapporti di trasmissione separati da virgole (ad esempio, \"57:11, 2:1\"). # Se viene specificato gear_ratio, rotation_distance specifica la distanza # percorsa dall'asse per una rotazione completa dell'ingranaggio finale. # L'impostazione predefinita \u00e8 di non utilizzare un rapporto di trasmissione. #step_pulse_duration: # Il tempo minimo tra il fronte del segnale dell'impulso del passo e il # successivo fronte del segnale \"non passo\". Viene utilizzato anche per # impostare il tempo minimo tra un impulso di passo e un segnale di cambio # di direzione. L'impostazione predefinita \u00e8 0.000000100 (100ns) per gli # stepper TMC configurati in modalit\u00e0 UART o SPI e l'impostazione # predefinita \u00e8 0.000002 (che \u00e8 2us) per tutti gli altri stepper. endstop_pin: # Pin di rilevamento interruttore di fine corsa. Se questo pin di fine corsa # si trova su un mcu diverso dal motore passo-passo, abilita il # \"homing multi-mcu\". Questo parametro deve essere fornito per gli # stepper X, Y e Z su stampanti in stile cartesiano. #position_min: 0 # Distanza minima valida (in mm) alla quale l'utente pu\u00f2 comandare # il movimento dello stepper. Il valore predefinito \u00e8 0 mm. position_endstop: # Posizione del finecorsa (in mm). Questo parametro deve essere fornito # per gli stepper X, Y e Z su stampanti in stile cartesiano. position_max: # Distanza massima valida (in mm) alla quale l'utente pu\u00f2 comandare lo # spostamento dello stepper. Questo parametro deve essere fornito per # gli stepper X, Y e Z su stampanti in stile cartesiano. #homing_speed: 5.0 # Velocit\u00e0 massima (in mm/s) dello stepper durante l'homing. # Il valore predefinito \u00e8 5 mm/s. #homing_retract_dist: 5.0 # Distanza dall'arretramento (in mm) prima della corsa di riferimento # una seconda volta durante la corsa di riferimento. Impostalo a zero per # disabilitare la seconda casa. Il valore predefinito \u00e8 5 mm. #homing_retract_speed: # Velocit\u00e0 da utilizzare nella corsa di ritorno dopo l'homing nel caso in # cui questa dovesse essere diversa dalla velocit\u00e0 di homing, che \u00e8 # l'impostazione predefinita per questo parametro #second_homing_speed: # Velocit\u00e0 (in mm/s) dello stepper durante l'esecuzione del secondo # homing. L'impostazione predefinita \u00e8 homing_speed/2. #homing_positive_dir: # Se true, l'homing far\u00e0 muovere lo stepper in una direzione positiva # (allontanandosi da zero); se falso, home verso zero. \u00c8 meglio utilizzare # l'impostazione predefinita piuttosto che specificare questo parametro. # Il valore predefinito \u00e8 true se position_endstop \u00e8 vicino a position_max # false se vicino a position_min.","title":"[stepper]"},{"location":"Config_Reference.html#cinematica-cartesiana","text":"Vedere example-cartesian.cfg per un file di configurazione della cinematica cartesiana di esempio. Qui sono descritti solo i parametri specifici delle stampanti cartesiane - vedere impostazioni cinematiche comuni per i parametri disponibili. [printer] kinematics: cartesian max_z_velocity: # Imposta la velocit\u00e0 massima (in mm/s) di movimento lungo # l'asse z. Questa impostazione pu\u00f2 essere utilizzata per limitare # la velocit\u00e0 massima del motore passo-passo z. L'impostazione # predefinita \u00e8 utilizzare max_velocity per max_z_velocity. max_z_accel: # Imposta l'accelerazione massima (in mm/s^2) del movimento # lungo l'asse z. Limita l'accelerazione del motore passo-passo z. # L'impostazione predefinita \u00e8 utilizzare max_accel per max_z_accel. # La sezione stepper_x viene utilizzata per descrivere lo stepper # che controlla l'asse X in un robot cartesiano. [stepper_x] # La sezione stepper_y viene utilizzata per descrivere lo stepper # che controlla l'asse Y in un robot cartesiano. [stepper_y] # La sezione stepper_z viene utilizzata per descrivere lo stepper # che controlla l'asse Z in un robot cartesiano. [stepper_z]","title":"Cinematica cartesiana"},{"location":"Config_Reference.html#cinematica-delta-lineare","text":"Vedere example-delta.cfg per un file di configurazione della cinematica delta lineare di esempio. Consultare la guida alla calibrazione delta per informazioni sulla calibrazione. Qui vengono descritti solo i parametri specifici per le stampanti delta lineari - vedere impostazioni cinematiche comuni per i parametri disponibili. [printer] kinematics: delta max_z_velocity: # Per le stampanti delta questo limita la velocit\u00e0 massima (in mm/s) dei # movimenti con movimento dell'asse z. Questa impostazione pu\u00f2 essere # utilizzata per ridurre la velocit\u00e0 massima dei movimenti su/gi\u00f9 (che # richiedono una velocit\u00e0 di incremento maggiore rispetto ad altri # movimenti su una stampante delta). L'impostazione predefinita \u00e8 # utilizzare max_velocity per max_z_velocity. #max_z_accel: # Imposta l'accelerazione massima (in mm/s^2) del movimento lungo # l'asse z. L'impostazione pu\u00f2 essere utile se la stampante pu\u00f2 # raggiungere un'accelerazione maggiore sui movimenti XY rispetto ai # movimenti Z (ad esempio, quando si utilizza l'input shaper). # L'impostazione predefinita \u00e8 utilizzare max_accel per max_z_accel. #minimum_z_position: 0 # La posizione Z minima in cui l'utente pu\u00f2 comandare alla testa di # spostarsi. Il valore predefinito \u00e8 0. delta_radius: # Raggio (in mm) del cerchio orizzontale formato dalle tre torri ad # asse lineare. Questo parametro pu\u00f2 anche essere calcolato come: # delta_radius = smooth_rod_offset - effector_offset - carriage_offset # Questo parametro deve essere fornito. #print_radius: # Il raggio (in mm) delle coordinate XY della testa di stampa valide. # \u00c8 possibile utilizzare questa impostazione per personalizzare il # controllo dell'intervallo dei movimenti della testa. Se qui # viene specificato un valore elevato, potrebbe essere possibile # comandare la collisione della testa di stampa con una torre. # L'impostazione predefinita \u00e8 usare delta_radius per print_radius # (che normalmente impedirebbe una collisione con torri). # La sezione stepper_a descrive lo stepper che controlla la torre # anteriore sinistra (a 210 gradi). Questa sezione controlla anche i # parametri di homing (velocit\u00e0 di homing, homing retract_dist) # per tutte le torri. [stepper_a] position_endstop: # Distanza (in mm) tra l'ugello e il piatto quando l'ugello si trova al # centro dell'area di costruzione e si attiva il finecorsa. Questo # parametro deve essere fornito per stepper_a; per stepper_b e # stepper_c questo parametro \u00e8 predefinito sul valore specificato # per stepper_a. arm_length: # Lunghezza (in mm) dell'asta diagonale che collega questa torre # alla testa di stampa. Questo parametro deve essere fornito per # stepper_a; per stepper_b e stepper_c questo parametro \u00e8 predefinito sul valore specificato per stepper_a. #angle: # Questa opzione specifica l'angolo (in gradi) a cui si trova la torre. # Il valore predefinito \u00e8 210 per stepper_a, 330 per stepper_b e 90 # per stepper_c. # La sezione stepper_b descrive lo stepper che controlla la torre # anteriore destra (a 330 gradi). [stepper_b] # La sezione stepper_c descrive lo stepper che controlla la torre # posteriore (a 90 gradi). [stepper_c] # La sezione delta_calibrate abilita un comando G-code esteso # DELTA_CALIBRATE in grado di calibrare le posizioni e gli angoli # dei finecorsa della torre. [delta_calibrate] radius: # Raggio (in mm) dell'area che pu\u00f2 essere sondata. Questo \u00e8 # il raggio delle coordinate dell'ugello da sondare; se si utilizza # una sonda automatica con un offset XY, scegliere un raggio # sufficientemente piccolo in modo che la sonda si adatti sempre # al piatto. Questo parametro deve essere fornito. #speed: 50 # La velocit\u00e0 (in mm/s) degli spostamenti senza probing durante # la calibrazione. Il valore predefinito \u00e8 50. #horizontal_move_z: 5 # L'altezza (in mm) a cui la testa deve essere comandata di # spostarsi appena prima di avviare un'operazione di sonda. # L'impostazione predefinita \u00e8 5.","title":"Cinematica Delta lineare"},{"location":"Config_Reference.html#cinematica-deltesiana","text":"Vedere example-deltesian.cfg per un esempio di file di configurazione della cinematica deltesiana. Qui sono descritti solo i parametri specifici per le stampanti deltesiane - vedere impostazioni cinematiche comuni per i parametri disponibili. [printer] kinematics: deltesian max_z_velocity: # Per le stampanti deltesiane, ci\u00f2 limita la velocit\u00e0 massima (in mm/s) # dei movimenti con movimento dell'asse z. Questa impostazione pu\u00f2 # essere utilizzata per ridurre la velocit\u00e0 massima dei movimenti su/gi\u00f9 # (che richiedono una velocit\u00e0 di incremento maggiore rispetto ad altri # movimenti su una stampante deltesiana). L'impostazione predefinita # \u00e8 utilizzare max_velocity per max_z_velocity. #max_z_accel: # Imposta l'accelerazione massima (in mm/s^2) del movimento lungo # l'asse z. L'impostazione pu\u00f2 essere utile se la stampante pu\u00f2 raggiungere # un'accelerazione maggiore sui movimenti XY rispetto ai movimenti Z # (ad esempio, quando si utilizza l'input shaper). L'impostazione # predefinita \u00e8 utilizzare max_accel per max_z_accel. #minimum_z_position: 0 # La posizione Z minima in cui l'utente pu\u00f2 comandare alla testa di # spostarsi. Il valore predefinito \u00e8 0. #min_angle: 5 # Questo rappresenta l'angolo minimo (in gradi) rispetto all'orizzontale # che le braccia deltesiane possono raggiungere. Questo parametro ha lo # scopo di impedire che i bracci diventino completamente orizzontali, il # che rischierebbe l'inversione accidentale dell'asse XZ. # L'impostazione predefinita \u00e8 5. #print_width: # La distanza (in mm) delle coordinate X della testa utensile valide. # \u00c8 possibile utilizzare questa impostazione per personalizzare il # controllo dell'intervallo dei movimenti della testa utensile. Se # qui viene specificato un valore elevato, potrebbe essere possibile # comandare la collisione della testa utensile con una torre. Questa # impostazione di solito corrisponde alla larghezza del piatto (in mm). #slow_ratio: 3 # Il rapporto utilizzato per limitare la velocit\u00e0 e l'accelerazione sui # movimenti vicini agli estremi dell'asse X. Se la distanza verticale # divisa per la distanza orizzontale supera il valore di slow_ratio, la # velocit\u00e0 e l'accelerazione sono limitate alla met\u00e0 dei loro valori # nominali. Se la distanza verticale divisa per la distanza orizzontale # supera il doppio del valore di slow_ratio, la velocit\u00e0 e l'accelerazione # sono limitate a un quarto dei loro valori nominali. # Il valore predefinito \u00e8 3. # la sezione stepper_left \u00e8 usata per descrivere lo stepper che controlla # la torre di sinistra. Questa sezione controlla anche i parametri di # homing (velocit\u00e0 di homing, homing retract_dist) per tutte le torri. [stepper_left] position_endstop: # Distanza (in mm) tra l'ugello e il piatto quando l'ugello si trova al # centro dell'area di costruzione e vengono attivati i finecorsa. Questo # parametro deve essere fornito per stepper_left; per stepper_right # questo parametro \u00e8 predefinito sul valore specificato per stepper_left. arm_length: # Lunghezza (in mm) dell'asta diagonale che collega il carrello torre # alla testina di stampa. Questo parametro deve essere fornito per # stepper_left; per stepper_right, questo parametro per impostazione # predefinita \u00e8 il valore specificato per stepper_left. arm_x_length: # Distanza orizzontale tra la testina di stampa e la torre quando le # stampanti \u00e8 in homing. Questo parametro deve essere fornito # per stepper_left; per stepper_right, questo parametro per impostazione # predefinita \u00e8 il valore specificato per stepper_left. # La sezione stepper_right \u00e8 usata per descrivere lo stepper che # controlla la torre destra. [stepper_right] # La sezione stepper_y viene utilizzata per descrivere lo stepper che # controlla l'asse Y in un robot deltesiano. [stepper_y]","title":"Cinematica Deltesiana"},{"location":"Config_Reference.html#cinematica-corexy","text":"Vedere example-corexy.cfg per un file cinematico corexy (e h-bot) di esempio. Qui sono descritti solo i parametri specifici per le stampanti corexy - vedere impostazioni cinematiche comuni per i parametri disponibili. [printer] kinematics: corexy max_z_velocity: # Imposta la velocit\u00e0 massima (in mm/s) di movimento lungo l'asse z. # Questa impostazione pu\u00f2 essere utilizzata per limitare la velocit\u00e0 # massima del motore passo-passo z. L'impostazione predefinita \u00e8 # utilizzare max_velocity per max_z_velocity. max_z_accel: # Imposta l'accelerazione massima (in mm/s^2) del movimento # lungo l'asse z. Limita l'accelerazione del motore passo-passo z. # L'impostazione predefinita \u00e8 utilizzare max_accel per max_z_accel. # La sezione stepper_x viene utilizzata per descrivere l'asse X e lo # stepper che controlla il movimento X+Y. [stepper_x] # La sezione stepper_y viene utilizzata per descrivere l'asse Y e lo # stepper che controlla il movimento X+Y. [stepper_y] # La sezione stepper_z viene utilizzata per descrivere l'asse Z [stepper_z]","title":"Cinematica CoreXY"},{"location":"Config_Reference.html#cinematica-corexz","text":"Vedere example-corexz.cfg per un file di configurazione della cinematica corexz di esempio. Qui sono descritti solo i parametri specifici per le stampanti corexz - vedere impostazioni cinematiche comuni per i parametri disponibili. [printer] kinematics: corexz max_z_velocity: # Imposta la velocit\u00e0 massima (in mm/s) di movimento lungo l'asse z. # L'impostazione predefinita \u00e8 utilizzare max_velocity per # max_z_velocity. max_z_accel: # Imposta l'accelerazione massima (in mm/s^2) del movimento lungo # l'asse z. L'impostazione predefinita \u00e8 utilizzare max_accel per # max_z_accel. # La sezione stepper_x viene utilizzata per descrivere l'asse X e lo # stepper che controlla il movimento X+Z. [stepper_x] # La sezione stepper_y viene utilizzata per descrivere l'asse Y [stepper_y] # La sezione stepper_z viene utilizzata per descrivere l'asse Z e lo # stepper che controlla il movimento X+Z. [stepper_z]","title":"Cinematica CoreXZ"},{"location":"Config_Reference.html#cinematica-hybrid-corexy","text":"Vedere example-hybrid-corexy.cfg per un file di configurazione della cinematica corexy ibrida di esempio. Questa cinematica \u00e8 anche nota come cinematica Markforged. Qui vengono descritti solo i parametri specifici delle stampanti corexy ibride, vedere impostazioni cinematiche comuni per i parametri disponibili. [printer] kinematics: hybrid_corexy max_z_velocity: # Imposta la velocit\u00e0 massima (in mm/s) di movimento lungo # l'asse z. L'impostazione predefinita \u00e8 utilizzare max_velocity # per max_z_velocity. max_z_accel: # Imposta l'accelerazione massima (in mm/s^2) del movimento # lungo l'asse z. L'impostazione predefinita \u00e8 utilizzare max_accel # per max_z_accel. # La sezione stepper_x viene utilizzata per descrivere l'asse X e lo # stepper che controlla il movimento X-Y. [stepper_x] # La sezione stepper_y viene utilizzata per descrivere lo stepper # che controlla l'asse Y. [stepper_y] # La sezione stepper_z viene utilizzata per descrivere lo stepper # che controlla l'asse Z. [stepper_z]","title":"Cinematica Hybrid-CoreXY"},{"location":"Config_Reference.html#cinematica-hybrid-corexz","text":"Vedere example-hybrid-corexz.cfg per un file di configurazione della cinematica corexz ibrido di esempio. Questa cinematica \u00e8 anche nota come cinematica Markforged. Qui vengono descritti solo i parametri specifici delle stampanti corexy ibride, vedere impostazioni cinematiche comuni per i parametri disponibili. [printer] kinematics: hybrid_corexz max_z_velocity: # Questo imposta la velocit\u00e0 massima (in mm/s) di movimento lungo # l'asse z. L'impostazione predefinita \u00e8 utilizzare max_velocity per # max_z_velocity. max_z_accel: # Imposta l'accelerazione massima (in mm/s^2) del movimento lungo # l'asse z. L'impostazione predefinita \u00e8 utilizzare max_accel per # max_z_accel. # La sezione stepper_x viene utilizzata per descrivere l'asse X e lo # stepper che controlla il movimento X-Z. [stepper_x] # La sezione stepper_y viene utilizzata per descrivere lo stepper che # controlla l'asse Y. [stepper_y] # La sezione stepper_z viene utilizzata per descrivere lo stepper che # controlla l'asse Z. [stepper_z]","title":"Cinematica Hybrid-CoreXZ"},{"location":"Config_Reference.html#cinematica-polare","text":"Vedere example-polar.cfg per un file di configurazione della cinematica polare di esempio. Qui sono descritti solo i parametri specifici per le stampanti polari - vedere impostazioni cinematiche comuni per i parametri disponibili. LA CINEMATICA POLARE \u00c8 UN LAVORO IN CORSO. \u00c8 noto che i movimenti intorno alla posizione 0, 0 non funzionano correttamente. [printer] kinematics: polar max_z_velocity: # Imposta la velocit\u00e0 massima (in mm/s) di movimento lungo l'asse z. # Questa impostazione pu\u00f2 essere utilizzata per limitare la velocit\u00e0 # massima del motore passo-passo z. L'impostazione predefinita \u00e8 # utilizzare max_velocity per max_z_velocity. max_z_accel: # Questo imposta l'accelerazione massima (in mm/s^2) del # movimento lungo l'asse z. Limita l'accelerazione del motore # passo-passo z. L'impostazione predefinita \u00e8 utilizzare max_accel # per max_z_accel. # La sezione stepper_bed viene utilizzata per descrivere lo stepper # che controlla il piatto [stepper_bed] gear_ratio: # \u00c8 necessario specificare un gear_ratio e rotation_distance # potrebbe non essere specificato. Ad esempio, se il piatto ha una # ruota a 80 denti azionata da uno stepper con una ruota a 16 # denti, si dovrebbe specificare un rapporto di trasmissione di \"80:16\". # Questo parametro deve essere fornito. # La sezione stepper_arm \u00e8 usata per descrivere lo stepper che # controlla il carrello sul braccio. [stepper_arm] # La sezione stepper_z viene utilizzata per descrivere lo stepper che # controlla l'asse Z. [stepper_z]","title":"Cinematica polare"},{"location":"Config_Reference.html#rotary-delta-kinematics","text":"See example-rotary-delta.cfg for an example rotary delta kinematics config file. Qui vengono descritti solo i parametri specifici delle stampanti delta rotative - vedere impostazioni cinematiche comuni per i parametri disponibili. ROTARY DELTA KINEMATICS ARE A WORK IN PROGRESS. Homing moves may timeout and some boundary checks are not implemented. [printer] kinematics: rotary_delta max_z_velocity: # For delta printers this limits the maximum velocity (in mm/s) of # moves with z axis movement. This setting can be used to reduce the # maximum speed of up/down moves (which require a higher step rate # than other moves on a delta printer). The default is to use # max_velocity for max_z_velocity. #minimum_z_position: 0 # The minimum Z position that the user may command the head to move # to. The default is 0. shoulder_radius: # Radius (in mm) of the horizontal circle formed by the three # shoulder joints, minus the radius of the circle formed by the # effector joints. This parameter may also be calculated as: # shoulder_radius = (delta_f - delta_e) / sqrt(12) # This parameter must be provided. shoulder_height: # Distance (in mm) of the shoulder joints from the bed, minus the # effector toolhead height. This parameter must be provided. # The stepper_a section describes the stepper controlling the rear # right arm (at 30 degrees). This section also controls the homing # parameters (homing_speed, homing_retract_dist) for all arms. [stepper_a] gear_ratio: # A gear_ratio must be specified and rotation_distance may not be # specified. For example, if the arm has an 80 toothed pulley driven # by a pulley with 16 teeth, which is in turn connected to a 60 # toothed pulley driven by a stepper with a 16 toothed pulley, then # one would specify a gear ratio of \"80:16, 60:16\". This parameter # must be provided. position_endstop: # Distance (in mm) between the nozzle and the bed when the nozzle is # in the center of the build area and the endstop triggers. This # parameter must be provided for stepper_a; for stepper_b and # stepper_c this parameter defaults to the value specified for # stepper_a. upper_arm_length: # Length (in mm) of the arm connecting the \"shoulder joint\" to the # \"elbow joint\". This parameter must be provided for stepper_a; for # stepper_b and stepper_c this parameter defaults to the value # specified for stepper_a. lower_arm_length: # Length (in mm) of the arm connecting the \"elbow joint\" to the # \"effector joint\". This parameter must be provided for stepper_a; # for stepper_b and stepper_c this parameter defaults to the value # specified for stepper_a. #angle: # This option specifies the angle (in degrees) that the arm is at. # The default is 30 for stepper_a, 150 for stepper_b, and 270 for # stepper_c. # The stepper_b section describes the stepper controlling the rear # left arm (at 150 degrees). [stepper_b] # The stepper_c section describes the stepper controlling the front # arm (at 270 degrees). [stepper_c] # The delta_calibrate section enables a DELTA_CALIBRATE extended # g-code command that can calibrate the shoulder endstop positions. [delta_calibrate] radius: # Radius (in mm) of the area that may be probed. This is the radius # of nozzle coordinates to be probed; if using an automatic probe # with an XY offset then choose a radius small enough so that the # probe always fits over the bed. This parameter must be provided. #speed: 50 # The speed (in mm/s) of non-probing moves during the calibration. # The default is 50. #horizontal_move_z: 5 # The height (in mm) that the head should be commanded to move to # just prior to starting a probe operation. The default is 5.","title":"Rotary delta Kinematics"},{"location":"Config_Reference.html#cable-winch-kinematics","text":"Vedere example-winch.cfg per un esempio di file di configurazione della cinematica con verricello, cable winch. Qui sono descritti solo i parametri specifici per le stampanti cavo verricello - vedere impostazioni comuni cinematiche per i parametri disponibili. CABLE WINCH SUPPORT IS EXPERIMENTAL. Homing is not implemented on cable winch kinematics. In order to home the printer, manually send movement commands until the toolhead is at 0, 0, 0 and then issue a G28 command. [printer] kinematics: winch # The stepper_a section describes the stepper connected to the first # cable winch. A minimum of 3 and a maximum of 26 cable winches may be # defined (stepper_a to stepper_z) though it is common to define 4. [stepper_a] rotation_distance: # The rotation_distance is the nominal distance (in mm) the toolhead # moves towards the cable winch for each full rotation of the # stepper motor. This parameter must be provided. anchor_x: anchor_y: anchor_z: # The X, Y, and Z position of the cable winch in cartesian space. # These parameters must be provided.","title":"Cable winch Kinematics"},{"location":"Config_Reference.html#nessuna-cinematica","text":"\u00c8 possibile definire una cinematica speciale \"none\" per disabilitare il supporto cinematico in Klipper. Questo pu\u00f2 essere utile per controllare dispositivi che non sono le tipiche stampanti 3D o per scopi di debug. [printer] kinematics: none max_velocity: 1 max_accel: 1 # \u00c8 necessario definire i parametri max_velocity e max_accel. I valori # non vengono utilizzati per la cinematica \"none\".","title":"Nessuna cinematica"},{"location":"Config_Reference.html#supporto-per-estrusore-e-piatto-riscaldato-comuni","text":"","title":"Supporto per estrusore e piatto riscaldato comuni"},{"location":"Config_Reference.html#extruder","text":"La sezione dell'estrusore viene utilizzata per descrivere i parametri del riscaldatore per l'hotend dell'ugello insieme allo stepper che controlla l'estrusore. Per ulteriori informazioni, vedere riferimento comando . Consultare la Guida all'avanzamento della pressione per informazioni sulla regolazione dell'anticipo della pressione. [extruder] step_pin: dir_pin: enable_pin: microsteps: rotation_distance: #full_steps_per_rotation: #gear_ratio: # Vedere la sezione \"stepper\" per una descrizione di quanto sopra # Se nessuno dei parametri precedenti \u00e8 specificato, nessuno stepper # sar\u00e0 associato all'hotend dell'ugello (sebbene un comando # SYNC_EXTRUDER_MOTION possa associarne uno in fase di esecuzione). nozzle_diameter: # Diametro dell'orifizio dell'ugello (in mm). Questo parametro deve essere fornito. filament_diameter:: # Il diametro nominale del filamento grezzo (in mm) quando # entra nell'estrusore. Questo parametro deve essere fornito. #max_extrude_cross_section: # Area massima (in mm^2) di una sezione trasversale dell'estrusione # (ad es. larghezza dell'estrusione moltiplicata per l'altezza dello strato). # Questa impostazione previene quantit\u00e0 eccessive di estrusione # durante spostamenti XY relativamente piccoli. # Se un movimento richiede una velocit\u00e0 di estrusione che supererebbe questo valore # causer\u00e0 la restituzione di un errore. L'impostazione predefinita # \u00e8: 4.0 * diametro_ugello^2 instantaneous_corner_velocity: 1.000 # La variazione di velocit\u00e0 istantanea massima (in mm/s) del # estrusore durante il collegamento di due movimenti. Il valore predefinito \u00e8 1 mm/s. #max_extrude_only_distance: 50.0 # Lunghezza massima (in mm di filamento grezzo) che pu\u00f2 avere un movimento # di retrazione o di sola estrusione. Se uno spostamento di retrazione # o di sola estrusione richiede una distanza maggiore di questo valore, # verr\u00e0 restituito un errore. Il valore predefinito \u00e8 50 mm. #max_extrude_only_velocity: #max_extrude_only_accel: # Velocit\u00e0 massima (in mm/s) e accelerazione (in mm/s^2) del # motore estrusore per retrazioni e movimenti di sola estrusione. # Queste impostazioni non hanno alcun impatto sui normali movimenti di stampa. # Se non specificati, vengono calcolati per corrispondere al limite che avrebbe # un movimento di stampa XY con una sezione trasversale di 4,0*diametro_ugello^2. #pressure_advance: 0.0 # La quantit\u00e0 di filamento grezzo da spingere nell'estrusore durante # accelerazione dell'estrusore. Una uguale quantit\u00e0 di filamento viene # retratta durante la decelerazione. Si misura in millimetri per # millimetro/secondo. Il valore predefinito \u00e8 0, che disabilita l'avanzamento della pressione. #pressure_advance_smooth_time: 0,040 # Un intervallo di tempo (in secondi) da utilizzare per calcolare la velocit\u00e0 media # dell'estrusore per l'avanzamento della pressione. Un valore maggiore si traduce # in movimenti pi\u00f9 fluidi dell'estrusore. Questo parametro non pu\u00f2 superare i 200 ms. # Questa impostazione si applica solo se pressure_advance \u00e8 diverso da zero. # Il valore predefinito \u00e8 0,040 (40 millisecondi). # # Le restanti variabili descrivono il riscaldatore dell'estrusore. heater_pin: # Pin di uscita PWM che controlla il riscaldatore. Questo parametro deve essere fornito. #max_power: 1.0 # La potenza massima (espressa come un valore compreso tra 0,0 e 1,0) a cui # pu\u00f2 essere impostato il riscaldatore_pin. Il valore 1.0 consente di impostare il pin # completamente abilitato per periodi prolungati, mentre un valore di 0,5 # consentirebbe di abilitare il pin per non pi\u00f9 della met\u00e0 del tempo. Questo # l'impostazione pu\u00f2 essere utilizzata per limitare la potenza totale # (per periodi prolungati) al riscaldatore. L'impostazione predefinita \u00e8 1.0. sensor_type: # Tipo di sensore - i termistori comuni sono \"EPCOS 100K B57560G104F\", # \"ATC Semitec 104GT-2\", \"ATC Semitec 104NT-4-R025H42G\", \"Generico # 3950\",\"Honeywell 100K 135-104LAG-J01\", \"NTC 100K MGB18-104F39050L32\", # \"SliceEngineering 450\" e \"TDK NTCG104LH104JT1\". Vedere la sezione # \"Sensori di temperatura\" per altri sensori. Questo parametro deve essere fornito. sensor_pin: # Pin di ingresso analogico collegato al sensore. Questo parametro deve essere fornito. #pullup_resistor: 4700 # La resistenza (in ohm) del pullup collegato al termistore. Questo parametro # \u00e8 valido solo quando il sensore \u00e8 un termistore. Il valore predefinito \u00e8 4700 ohm. #smooth_time: 1.0 # Un valore di tempo (in secondi) durante il quale le misurazioni della # temperatura verranno uniformate per ridurre l'impatto del rumore # di misurazione. Il valore predefinito \u00e8 1 secondo. control: # Algoritmo di controllo (pid o filigrana). Questo parametro deve # essere fornito. pid_Kp: pid_Ki: pid_Kd: # Il proporzionale (pid_Kp), l'integrale (pid_Ki) e la derivata # (pid_Kd) impostazioni per il sistema di controllo del feedback PID. Klipper # valuta le impostazioni PID con la seguente formula generale: # riscaldatore_pwm = (Kp*errore + Ki*integrale(errore) - Kd*derivato(errore)) / 255 # Dove \"errore\" \u00e8 \"temperatura_richiesta - temperatura_misurata\" # e \"heater_pwm\" \u00e8 la velocit\u00e0 di riscaldamento richiesta con 0,0 completamente # off e 1.0 completamente on. Prendi in considerazione l'utilizzo di PID_CALIBRATE # comando per ottenere questi parametri. pid_Kp, pid_Ki e pid_Kd # i parametri devono essere forniti per i riscaldatori PID. #delta_max: 2.0 # Sui riscaldatori controllati questo \u00e8 il numero di gradi in # Celsius al di sopra della temperatura target prima di disattivare il riscaldatore # cos\u00ec come il numero di gradi sotto il target prima # riattivare il riscaldatore. L'impostazione predefinita \u00e8 2 gradi Celsius. #pwm_cycle_time: 0,100 # Tempo in secondi per ogni ciclo PWM software del riscaldatore. # non \u00e8 consigliabile impostarlo a meno che non ci sia necessario come # requisito accendere il riscaldatore pi\u00f9 velocemente di 10 volte al secondo. # Il valore predefinito \u00e8 0,100 secondi. #min_extrude_temp: 170 # La temperatura minima (in gradi Celsius) alla quale possono essere # impartiti comandi all'estrusore. L'impostazione predefinita \u00e8 170 gradi Celsius. min_temp: max_temp: # L'intervallo massimo di temperature valide (in gradi Celsius) in cui # il riscaldatore deve rimanere all'interno. Questo controlla una funzione di sicurezza # implementata nel codice del microcontrollore , la temperatura # non cadr\u00e0 mai al di fuori di questo intervallo, altrimenti il microcontrollore # entrer\u00e0 in uno stato di arresto. Questo controllo pu\u00f2 aiutare a rilevarne alcuni # guasti hardware del riscaldatore e del sensore. Imposta questo intervallo solo in modo ampio # abbastanza in modo che temperature ragionevoli non si traducano in un errore. # Questi parametri devono essere forniti.","title":"[extruder]"},{"location":"Config_Reference.html#heater_bed","text":"La sezione heater_bed descrive un piatto riscaldato. Utilizza le stesse impostazioni del riscaldatore descritte nella sezione \"extruder\". [heater_bed] heater_pin: sensor_type: sensor_pin: control: min_temp: max_temp: # Vedere la sezione \"extruder\" per una descrizione dei parametri sopra.","title":"[heater_bed]"},{"location":"Config_Reference.html#supporto-livellamento-del-piatto","text":"","title":"Supporto livellamento del piatto"},{"location":"Config_Reference.html#bed_mesh","text":"Mesh Bed Leveling. Si pu\u00f2 definire una sezione di configurazione bed_mesh per abilitare trasformazioni di spostamento che sfalsano l'asse z in base a una mesh generata da punti sondati. Quando si utilizza una sonda per la posizione di riferimento sull'asse z, si consiglia di definire una sezione safe_z_home in printer.cfg per la posizione di riferimento verso il centro dell'area di stampa. Per ulteriori informazioni, vedere la bed mesh guide e riferimento del comando . Esempi visivi: rectangular bed, probe_count = 3, 3: x---x---x (max_point) | x---x---x | (min_point) x---x---x round bed, round_probe_count = 5, bed_radius = r: x (0, r) end / x---x---x \\ (-r, 0) x---x---x---x---x (r, 0) \\ x---x---x / x (0, -r) start [bed_mesh] #speed: 50 # The speed (in mm/s) of non-probing moves during the calibration. # The default is 50. #horizontal_move_z: 5 # The height (in mm) that the head should be commanded to move to # just prior to starting a probe operation. The default is 5. #mesh_radius: # Defines the radius of the mesh to probe for round beds. Note that # the radius is relative to the coordinate specified by the # mesh_origin option. This parameter must be provided for round beds # and omitted for rectangular beds. #mesh_origin: # Defines the center X, Y coordinate of the mesh for round beds. This # coordinate is relative to the probe's location. It may be useful # to adjust the mesh_origin in an effort to maximize the size of the # mesh radius. Default is 0, 0. This parameter must be omitted for # rectangular beds. #mesh_min: # Defines the minimum X, Y coordinate of the mesh for rectangular # beds. This coordinate is relative to the probe's location. This # will be the first point probed, nearest to the origin. This # parameter must be provided for rectangular beds. #mesh_max: # Defines the maximum X, Y coordinate of the mesh for rectangular # beds. Adheres to the same principle as mesh_min, however this will # be the furthest point probed from the bed's origin. This parameter # must be provided for rectangular beds. #probe_count: 3, 3 # For rectangular beds, this is a comma separate pair of integer # values X, Y defining the number of points to probe along each # axis. A single value is also valid, in which case that value will # be applied to both axes. Default is 3, 3. #round_probe_count: 5 # For round beds, this integer value defines the maximum number of # points to probe along each axis. This value must be an odd number. # Default is 5. #fade_start: 1.0 # The gcode z position in which to start phasing out z-adjustment # when fade is enabled. Default is 1.0. #fade_end: 0.0 # The gcode z position in which phasing out completes. When set to a # value below fade_start, fade is disabled. It should be noted that # fade may add unwanted scaling along the z-axis of a print. If a # user wishes to enable fade, a value of 10.0 is recommended. # Default is 0.0, which disables fade. #fade_target: # The z position in which fade should converge. When this value is # set to a non-zero value it must be within the range of z-values in # the mesh. Users that wish to converge to the z homing position # should set this to 0. Default is the average z value of the mesh. #split_delta_z: .025 # The amount of Z difference (in mm) along a move that will trigger # a split. Default is .025. #move_check_distance: 5.0 # The distance (in mm) along a move to check for split_delta_z. # This is also the minimum length that a move can be split. Default # is 5.0. #mesh_pps: 2, 2 # A comma separated pair of integers X, Y defining the number of # points per segment to interpolate in the mesh along each axis. A # \"segment\" can be defined as the space between each probed point. # The user may enter a single value which will be applied to both # axes. Default is 2, 2. #algorithm: lagrange # The interpolation algorithm to use. May be either \"lagrange\" or # \"bicubic\". This option will not affect 3x3 grids, which are forced # to use lagrange sampling. Default is lagrange. #bicubic_tension: .2 # When using the bicubic algorithm the tension parameter above may # be applied to change the amount of slope interpolated. Larger # numbers will increase the amount of slope, which results in more # curvature in the mesh. Default is .2. #relative_reference_index: # A point index in the mesh to reference all z values to. Enabling # this parameter produces a mesh relative to the probed z position # at the provided index. #faulty_region_1_min: #faulty_region_1_max: # Optional points that define a faulty region. See docs/Bed_Mesh.md # for details on faulty regions. Up to 99 faulty regions may be added. # By default no faulty regions are set.","title":"[bed_mesh]"},{"location":"Config_Reference.html#bed_tilt","text":"Compensazione dell'inclinazione del piatto. Si pu\u00f2 definire una sezione di configurazione bed_tilt per abilitare le trasformazioni di movimento che tengono conto di un piatto inclinato. Nota che bed_mesh e bed_tilt sono incompatibili; entrambi non possono essere definiti. Per ulteriori informazioni, vedere riferimento comando . [bed_tilt] #x_adjust: 0 # The amount to add to each move's Z height for each mm on the X # axis. The default is 0. #y_adjust: 0 # The amount to add to each move's Z height for each mm on the Y # axis. The default is 0. #z_adjust: 0 # The amount to add to the Z height when the nozzle is nominally at # 0, 0. The default is 0. # The remaining parameters control a BED_TILT_CALIBRATE extended # g-code command that may be used to calibrate appropriate x and y # adjustment parameters. #points: # A list of X, Y coordinates (one per line; subsequent lines # indented) that should be probed during a BED_TILT_CALIBRATE # command. Specify coordinates of the nozzle and be sure the probe # is above the bed at the given nozzle coordinates. The default is # to not enable the command. #speed: 50 # The speed (in mm/s) of non-probing moves during the calibration. # The default is 50. #horizontal_move_z: 5 # The height (in mm) that the head should be commanded to move to # just prior to starting a probe operation. The default is 5.","title":"[bed_tilt]"},{"location":"Config_Reference.html#bed_screws","text":"Strumento per aiutare a regolare le viti di livellamento del letto. Si pu\u00f2 definire una sezione di configurazione [bed_screws] per abilitare un comando g-code BED_SCREWS_ADJUST. Per ulteriori informazioni, vedere la guida al livellamento e il riferimento al comando . [bed_screws] #screw1: # The X, Y coordinate of the first bed leveling screw. This is a # position to command the nozzle to that is directly above the bed # screw (or as close as possible while still being above the bed). # This parameter must be provided. #screw1_name: # An arbitrary name for the given screw. This name is displayed when # the helper script runs. The default is to use a name based upon # the screw XY location. #screw1_fine_adjust: # An X, Y coordinate to command the nozzle to so that one can fine # tune the bed leveling screw. The default is to not perform fine # adjustments on the bed screw. #screw2: #screw2_name: #screw2_fine_adjust: #... # Additional bed leveling screws. At least three screws must be # defined. #horizontal_move_z: 5 # The height (in mm) that the head should be commanded to move to # when moving from one screw location to the next. The default is 5. #probe_height: 0 # The height of the probe (in mm) after adjusting for the thermal # expansion of bed and nozzle. The default is zero. #speed: 50 # The speed (in mm/s) of non-probing moves during the calibration. # The default is 50. #probe_speed: 5 # The speed (in mm/s) when moving from a horizontal_move_z position # to a probe_height position. The default is 5.","title":"[bed_screws]"},{"location":"Config_Reference.html#screws_tilt_adjust","text":"Strumento per aiutare a regolare l'inclinazione delle viti del piatto utilizzando la sonda Z. Si pu\u00f2 definire una sezione di configurazione Screws_tilt_adjust per abilitare un comando g-code SCREWS_TILT_CALCULATE. Per ulteriori informazioni, vedere la guida al livellamento e riferimento al comando . [screws_tilt_adjust] #screw1: # La coordinata (X, Y) della prima vite di livellamento del piatto. Questa # \u00e8 una posizione in cui comandare l'ugello in modo che la sonda sia # direttamente sopra la vite del piatto (o il pi\u00f9 vicino possibile mentre si # trova ancora sopra il piatto). Questa \u00e8 la vite di base utilizzata nei calcoli. # Questo parametro deve essere fornito. #screw1_name: # Un nome arbitrario per la vite data. Questo nome viene visualizzato # quando viene eseguito lo script di supporto. L'impostazione predefinita # prevede l'utilizzo di un nome basato sulla posizione XY della vite. #screw2: #screw2_name: #... # Viti di livellamento del piatto aggiuntive. Devono essere definite # almeno due viti. #speed: 50 # La velocit\u00e0 (in mm/s) degli spostamenti senza probing durante la # calibrazione. Il valore predefinito \u00e8 50. #horizontal_move_z: 5 # L'altezza (in mm) a cui la testa deve essere spostata appena prima # di avviare un'operazione di sonda. L'impostazione predefinita \u00e8 5. #screw_thread: CW-M3 # Il tipo di vite utilizzata per il livello del piatto, M3, M4 o M5 e la # direzione della manopola utilizzata per livellare il letto, in senso orario # decrementa in senso antiorario decrementa. Valori accettati: CW-M3, # CCW-M3, CW-M4, CCW-M4, CW-M5, CCW-M5. Il valore predefinito \u00e8 # CW-M3, la maggior parte delle stampanti utilizza una vite M3 e # ruotando la manopola in senso orario diminuisce la distanza.","title":"[screws_tilt_adjust]"},{"location":"Config_Reference.html#z_tilt","text":"Regolazione multipla dell'inclinazione dello stepper Z. Questa funzione consente la regolazione indipendente di pi\u00f9 stepper z (vedere la sezione \"stepper_z1\") per regolare l'inclinazione. Se questa sezione \u00e8 presente, diventa disponibile un comando G-Code esteso Z_TILT_ADJUST. [z_tilt] #z_positions: # Un elenco di coordinate X, Y (una per riga; le righe successive # identate) che descrivono la posizione di ciascun \"pivot point\" # del piattotto. Il \"pivot point\" \u00e8 il punto in cui il piatto si attacca # al dato stepper Z. Viene descritto utilizzando le coordinate dell'ugello # (la posizione X, Y dell'ugello se potesse spostarsi direttamente sopra # il punto). La prima voce corrisponde a stepper_z, la seconda a # stepper_z1, la terza a stepper_z2, ecc. # Questo parametro deve essere fornito. #points: # Un elenco di coordinate X, Y (una per riga; righe successive identate) # che devono essere rilevate durante un comando Z_TILT_ADJUST. # Specificare le coordinate dell'ugello e assicurarsi che la sonda sia # sopra il piatto alle coordinate dell'ugello date. # Questo parametro deve essere fornito. #speed: 50 # La velocit\u00e0 (in mm/s) degli spostamenti senza probing durante # la calibrazione. Il valore predefinito \u00e8 50. #horizontal_move_z: 5 # L'altezza (in mm) a cui la testa deve essere comandata per spostarsi # appena prima di avviare un'operazione di probing. # L'impostazione predefinita \u00e8 5. #retries: 0 # Numero di volte per riprovare se i punti rilevati non sono all'interno # della tolleranza. #retry_tolerance: 0 # Se i tentativi sono abilitati, riprovare se i punti sondati pi\u00f9 grande e # pi\u00f9 piccolo differiscono pi\u00f9 di retry_tolerance. Nota che l'unit\u00e0 di # modifica pi\u00f9 piccola qui sarebbe un singolo passaggio. # Tuttavia, se stai sondando pi\u00f9 punti rispetto agli stepper, # probabilmente avrai un valore minimo fisso per l'intervallo di punti # sondati che puoi apprendere osservando l'output del comando.","title":"[z_tilt]"},{"location":"Config_Reference.html#quad_gantry_level","text":"Moving gantry leveling using 4 independently controlled Z motors. Corrects hyperbolic parabola effects (potato chip) on moving gantry which is more flexible. WARNING: Using this on a moving bed may lead to undesirable results. If this section is present then a QUAD_GANTRY_LEVEL extended G-Code command becomes available. This routine assumes the following Z motor configuration: ---------------- |Z1 Z2| | --------- | | | | | | | | | | x-------- | |Z Z3| ---------------- Dove x \u00e8 il punto 0, 0 sul piatto [quad_gantry_level] #gantry_corners: # A newline separated list of X, Y coordinates describing the two # opposing corners of the gantry. The first entry corresponds to Z, # the second to Z2. This parameter must be provided. #points: # A newline separated list of four X, Y points that should be probed # during a QUAD_GANTRY_LEVEL command. Order of the locations is # important, and should correspond to Z, Z1, Z2, and Z3 location in # order. This parameter must be provided. For maximum accuracy, # ensure your probe offsets are configured. #speed: 50 # The speed (in mm/s) of non-probing moves during the calibration. # The default is 50. #horizontal_move_z: 5 # The height (in mm) that the head should be commanded to move to # just prior to starting a probe operation. The default is 5. #max_adjust: 4 # Safety limit if an adjustment greater than this value is requested # quad_gantry_level will abort. #retries: 0 # Number of times to retry if the probed points aren't within # tolerance. #retry_tolerance: 0 # If retries are enabled then retry if largest and smallest probed # points differ more than retry_tolerance.","title":"[quad_gantry_level]"},{"location":"Config_Reference.html#skew_correction","text":"Correzione dell'inclinazione della stampante. \u00c8 possibile utilizzare il software per correggere l'inclinazione della stampante su 3 piani, xy, xz, yz. Questo viene fatto stampando un modello di calibrazione lungo un piano e misurando tre lunghezze. A causa della natura della correzione dell'inclinazione, queste lunghezze vengono impostate tramite gcode. Per i dettagli, vedere Correzione inclinazione e Command Reference . [skew_correction]","title":"[skew_correction]"},{"location":"Config_Reference.html#z_thermal_adjust","text":"Regolazione della posizione Z della testa di stampa in funzione della temperatura. Compensare il movimento verticale della testina utensile causato dall'espansione termica del telaio della stampante in tempo reale utilizzando un sensore di temperatura (tipicamente accoppiato a una sezione verticale del telaio). Vedi anche: comandi g-code estesi . [z_thermal_adjust] #temp_coeff: # Il coefficiente di dilatazione della temperatura, in mm/degC. Ad esempio, un # temp_coeff di 0,01 mm/degC sposter\u00e0 l'asse Z verso il basso di 0,01 mm per ogni # grado Celsius di auemnto del sensore di temperatura . Il valore predefinito \u00e8 # 0,0 mm/degC, che non applica alcuna regolazione. #smooth_time: # Finestra di smoothing applicata al sensore di temperatura, in secondi. Pu\u00f2 # ridurre il rumore del motore da piccole correzioni eccessive in risposta al # rumore del sensore. Il valore predefinito \u00e8 2,0 secondi. #z_adjust_off_above: # Disattiva le regolazioni al di sopra di questa altezza Z [mm]. L'ultima correzione # calcolata rimarr\u00e0 applicata finch\u00e9 la testa utensile non si sposter\u00e0 nuovamente # al di sotto dell'altezza Z specificata. # Il valore predefinito \u00e8 99999999,0 mm (sempre attivo). #max_z_adjustment: # Massima regolazione assoluta applicabile all'asse Z [mm]. Il valore predefinito # \u00e8 99999999,0 mm (illimitato). #sensor_type: #sensor_pin: #min_temp: #max_temp: # Configurazione del sensore di temperatura. Vedere la sezione \"extruder\" per # la definizione dei parametri di cui sopra. #gcode_id: # Vedere la sezione \"heater_generic\" per la definizione di questo parametro.","title":"[z_thermal_adjust]"},{"location":"Config_Reference.html#homing-personalizzato","text":"","title":"Homing personalizzato"},{"location":"Config_Reference.html#safe_z_home","text":"Homing Z sicuro. Si pu\u00f2 utilizzare questo meccanismo per posizionare l'asse Z su una specifica coordinata X, Y. Ci\u00f2 \u00e8 utile se la testa portautensili, ad esempio, deve spostarsi al centro del letto prima che Z possa essere riposizionato. [safe_z_home] home_xy_position: # Una coordinata X, Y (ad es. 100, 100) dove deve essere eseguita # homing Z. Questo parametro deve essere fornito. #speed: 50.0 # Velocit\u00e0 alla quale la testa di stampa viene spostata sulla # coordinata Z sicura. Il valore predefinito \u00e8 50 mm/s #z_hop: # Distanza (in mm) per sollevare l'asse Z prima dell'homing. # Questo si applica a qualsiasi comando di homing, anche se non # si trova sull'asse Z. Se l'asse Z \u00e8 gi\u00e0 azzerato e la posizione Z # corrente \u00e8 inferiore a z_hop, questo sollever\u00e0 la testa a un'altezza # di z_hop. Se l'asse Z non \u00e8 gi\u00e0 azzerato la testina viene sollevata # di z_hop. L'impostazione predefinita \u00e8 di non implementare Z hop. #z_hop_speed: 15.0 # Velocit\u00e0 (in mm/s) alla quale l'asse Z viene sollevato prima # del homing. Il valore predefinito \u00e8 15 mm/s. #move_to_previous: False # Quando \u00e8 impostato su True, gli assi X e Y vengono ripristinati alle # posizioni precedenti dopo l'homing dell'asse Z. # L'impostazione predefinita \u00e8 False.","title":"[safe_z_home]"},{"location":"Config_Reference.html#homing_override","text":"Homing Override. Si pu\u00f2 utilizzare questo meccanismo per eseguire una serie di comandi g-code al posto di un G28 che si trova nel normale input di g-code. Questo pu\u00f2 essere utile su stampanti che richiedono una procedura specifica per l'home della macchina. [homing_override] gcode: # Un elenco di comandi G-Code da eseguire al posto dei comandi # G28 trovati nel normale input di G-Code. # Vedi docs/Command_Templates.md per il formato G-Code. # Se un G28 \u00e8 contenuto in questo elenco di comandi, invocher\u00e0 # la normale procedura di homing per la stampante. I comandi # qui elencati devono eseguire l'home di tutti gli assi. # Questo parametro deve essere fornito. #axes: xyz # Gli assi da sovrascrivere. Ad esempio, se questo \u00e8 impostato # su \"z\", lo script di override verr\u00e0 eseguito solo quando l'asse z # \u00e8 azzerato (ad esempio, tramite un comando \"G28\" o \"G28 Z0\"). # Nota, lo script di sovrascrittura dovrebbe comunque ospitare # tutti gli assi. L'impostazione predefinita \u00e8 \"xyz\" che fa s\u00ec che lo # script di override venga eseguito al posto di tutti i comandi G28. #set_position_x: #set_position_y: #set_position_z: # Se specificato, la stampante presumer\u00e0 che l'asse si trovi # nella posizione specificata prima di eseguire i comandi g-code # precedenti. L'impostazione di questa opzione disabilita i # controlli di riferimento per quell'asse. Questo pu\u00f2 essere utile # se la testa deve muoversi prima di invocare il normale # meccanismo G28 per un asse. L'impostazione predefinita \u00e8 # di non forzare una posizione per un asse.","title":"[homing_override]"},{"location":"Config_Reference.html#endstop_phase","text":"Finecorsa regolati in fase stepper. Per utilizzare questa funzione, definire una sezione di configurazione con un prefisso \"endstop_phase\" seguito dal nome della corrispondente sezione di configurazione dello stepper (ad esempio, \"[endstop_phase stepper_z]\"). Questa funzione pu\u00f2 migliorare la precisione degli interruttori di fine corsa. Aggiungi una semplice dichiarazione \"[endstop_phase]\" per abilitare il comando ENDSTOP_PHASE_CALIBRATE. Per ulteriori informazioni, vedere la endstop phases guide e command reference . [endstop_phase stepper_z] #endstop_accuracy: # Imposta la precisione prevista (in mm) del finecorsa. Questo rappresenta # la distanza massima di errore che il finecorsa pu\u00f2 attivare (ad es. se un # finecorsa pu\u00f2 occasionalmente attivarsi 100um in anticipo o fino a 100um in ritardo # quindi impostalo su 0,200 per 200 um). L'impostazione predefinita \u00e8 # 4*distanza_rotazione/passi_completi_per_rotazione. #trigger_phase: # Questo specifica la fase del driver del motore passo-passo da aspettarsi # quando si raggiunge il finecorsa. \u00c8 composto da due numeri separati # da un '/' - la fase e il numero totale di # fasi (ad es. \"7/64\"). Impostare questo valore solo se si \u00e8 sicuri che il # driver del motore passo-passo viene ripristinato ogni volta che viene ripristinato l'mcu. Se questo # non \u00e8 impostato, la prima fase verr\u00e0 rilevata al primo home # e quella fase sar\u00e0 utilizzata su tutte le abitazioni successive. #endstop_align_zero: False # Se true, la posizione_endstop dell'asse sar\u00e0 effettivamente # modificato in modo che la posizione zero dell'asse avvenga a passo pieno # sul motore. (Se utilizzato sull'asse Z e la stampa # l'altezza del livello \u00e8 un multiplo di una distanza di un passo intero, allora ogni # layer si eseguir\u00e0 in un step completo.) L'impostazione predefinita \u00e8 False.","title":"[endstop_phase]"},{"location":"Config_Reference.html#macro-ed-eventi-g-code","text":"","title":"Macro ed eventi G-Code"},{"location":"Config_Reference.html#gcode_macro","text":"Macro G-Code (\u00e8 possibile definire un numero qualsiasi di sezioni con un prefisso \"gcode_macro\"). Per ulteriori informazioni, consulta la Guida ai modelli di comando . [gcode_macro my_cmd] #gcode: # Un elenco di comandi G-Code da eseguire al posto di \"my_cmd\". # Vedi docs/Command_Templates.md per il formato G-Code. # Questo parametro deve essere fornito. #variable_<name>: # Si pu\u00f2 specificare un numero qualsiasi di opzioni con un prefisso # \"variable_\". Al nome della variabile data verr\u00e0 assegnato il valore dato # (analizzato come un valore letterale Python) e sar\u00e0 disponibile durante # l'espansione della macro. Ad esempio, una configurazione con # \"variable_fan_speed = 75\" potrebbe avere comandi gcode contenenti # \"M106 S{ fan_speed * 255 }\". Le variabili possono essere modificate in # fase di esecuzione utilizzando il comando SET_GCODE_VARIABLE # (consultare docs/Command_Templates.md per i dettagli). # I nomi delle variabili potrebbero non utilizzare caratteri maiuscoli. #rename_existing: # Questa opzione far\u00e0 s\u00ec che la macro ignori un comando G-Code # esistente e fornisca la definizione precedente del comando tramite # il nome fornito qui. Questo pu\u00f2 essere usato per sovrascrivere i # comandi G-Code integrati. Prestare attenzione quando si ignorano # i comandi poich\u00e9 possono causare risultati complessi e imprevisti. # L'impostazione predefinita \u00e8 di non sovrascrivere un comando # G-Code esistente. #description: G-Code macro # Ci\u00f2 aggiunger\u00e0 una breve descrizione utilizzata al comando HELP # o durante l'utilizzo della funzione di completamento automatico. # Predefinito \"G-Code macro\"","title":"[gcode_macro]"},{"location":"Config_Reference.html#delayed_gcode","text":"Esegui un gcode con un ritardo impostato. Per ulteriori informazioni, consulta la Guida template dei comandi e riferimento al comando . [delayed_gcode my_delayed_gcode] gcode: # A list of G-Code commands to execute when the delay duration has # elapsed. G-Code templates are supported. This parameter must be # provided. #initial_duration: 0.0 # The duration of the initial delay (in seconds). If set to a # non-zero value the delayed_gcode will execute the specified number # of seconds after the printer enters the \"ready\" state. This can be # useful for initialization procedures or a repeating delayed_gcode. # If set to 0 the delayed_gcode will not execute on startup. # Default is 0.","title":"[delayed_gcode]"},{"location":"Config_Reference.html#save_variables","text":"Supporta il salvataggio delle variabili su disco in modo che vengano mantenute durante i riavvii. Per ulteriori informazioni, vedere template dei comandi e G-Code reference . [save_variables] filename: # Richiesto: fornire un nome file che verrebbe utilizzato per salvare # le variabili su disco, ad es. ~/variables.cfg","title":"[save_variables]"},{"location":"Config_Reference.html#idle_timeout","text":"Timeout di inattivit\u00e0. Viene automaticamente abilitato un timeout di inattivit\u00e0: aggiungi una sezione di configurazione di idle_timeout esplicita per modificare le impostazioni predefinite. [idle_timeout] #gcode: # Un elenco di comandi G-Code da eseguire in un timeout di # inattivit\u00e0. Vedi docs/Command Templates.md per il formato # G-Code. L'impostazione predefinita \u00e8 # eseguire \"TURN_OFF HEATERS\" e \"M84\". #timeout: 600 # Tempo di inattivit\u00e0 (in secondi) da attendere prima di eseguire # i comandi G-Code sopra. Il valore predefinito \u00e8 600 secondi.","title":"[idle_timeout]"},{"location":"Config_Reference.html#funzionalita-opzionali-g-code","text":"","title":"Funzionalit\u00e0 opzionali G-Code"},{"location":"Config_Reference.html#virtual_sdcard","text":"Una scheda SD virtuale pu\u00f2 essere utile se la macchina host non \u00e8 abbastanza veloce per eseguire bene OctoPrint. Consente al software host Klipper di stampare direttamente i file gcode archiviati in una directory sull'host utilizzando i comandi G-Code standard (ad esempio, M24). [virtual_sdcard] path: # Il percorso della directory locale sulla macchina host per cercare # i file di Gcode. Questa \u00e8 una directory di sola lettura (le scritture # di file sdcard non sono supportate). Si pu\u00f2 indicare questo alla # directory di caricamento di OctoPrint # (generalmente ~/.octoprint/uploads/ ). # Questo parametro deve essere fornito. #on_error_gcode: # Un elenco di comandi G-Code da eseguire quando viene segnalato # un errore.","title":"[virtual_sdcard]"},{"location":"Config_Reference.html#sdcard_loop","text":"Alcune stampanti con funzionalit\u00e0 di pulizia del piatto, come un espulsore di parti o una stampante a nastro, possono trovare impiego nelle sezioni di loop del file sdcard. (Ad esempio, per stampare la stessa parte pi\u00f9 e pi\u00f9 volte, o ripetere la sezione a di una parte per una catena o un altro motivo ripetuto). Consulta il command reference per i comandi supportati. Vedere il file sample-macros.cfg per una macro M808 G-Code compatibile con Marlin. [sdcard_loop]","title":"[sdcard_loop]"},{"location":"Config_Reference.html#force_move","text":"Supporta lo spostamento manuale dei motori passo-passo per scopi diagnostici. Nota, l'utilizzo di questa funzione potrebbe mettere la stampante in uno stato non valido - vedere il command reference per dettagli importanti. [force_move] #enable_force_move: False # Impostare su True per abilitare FORCE_MOVE e SET_KINEMATIC_POSITION # i comandi G-Code estesi. L'impostazione predefinita \u00e8 False.","title":"[force_move]"},{"location":"Config_Reference.html#pause_resume","text":"Funzionalit\u00e0 di Pause/Resume con supporto di acquisizione e ripristino della posizione. Per ulteriori informazioni, vedere riferimento comando . [pause_resume] #recover_velocity: 50. # Quando si abilita pause_resume, la velocit\u00e0 con cui tornare alla # posizione catturata (in mm/s). Il valore predefinito \u00e8 50,0 mm/s.","title":"[pause_resume]"},{"location":"Config_Reference.html#firmware_retraction","text":"Retrazione del filamento del firmware. Ci\u00f2 abilita i comandi GCODE G10 (ritiro) e G11 (non ritirati) emessi da molti slicer. I parametri seguenti forniscono le impostazioni predefinite di avvio, sebbene i valori possano essere regolati tramite il [comando] SET_RETRACTION (G-Codes.md#firmware_retraction)), consentendo l'impostazione e l'ottimizzazione del filamento a runtime. [firmware_retraction] #retract_length: 0 # La lunghezza del filamento (in mm) da ritrarre quando G10 # \u00e8 attivato e da ritrarre quando G11 \u00e8 attivato (ma vedere # unretract_extra_length di seguito). I# l valore predefinito \u00e8 0 mm. #retract_speed: 20 # La velocit\u00e0 di retrazione, in mm/s. # Il valore predefinito \u00e8 20 mm/s. #unretract_extra_length: 0 # La lunghezza (in mm) del filamento *aggiuntivo* da # sommare quando non si ritrae. #unretract_speed: 10 # La velocit\u00e0 di srotolamento, in mm/s. # Il valore predefinito \u00e8 10 mm/s.","title":"[firmware_retraction]"},{"location":"Config_Reference.html#gcode_arcs","text":"Supporto per i comandi Gcode arc (G2/G3). [gcode_arcs] #resolution: 1.0 # Un arco sar\u00e0 diviso in segmenti. La lunghezza di ciascun segmento # sar\u00e0 uguale alla risoluzione in mm impostata sopra. Valori pi\u00f9 bassi # produrranno un arco pi\u00f9 fine, ma anche pi\u00f9 lavoro per la tua macchina. # Archi pi\u00f9 piccoli del valore configurato diventer\u00e0 linee rette. # L'impostazione predefinita \u00e8 # 1mm.","title":"[gcode_arcs]"},{"location":"Config_Reference.html#respond","text":"Abilita i comandi estesi \"M118\" e \"RESPOND\" commands . [respond] #default_type: echo # Imposta il prefisso predefinito dell'output \"M118\" e \"RESPOND\" su uno dei seguenti: # echo: \"echo: \" (Questa \u00e8 l'impostazione predefinita) # command: \"// \" # error: \"!! \" #default_prefix: echo: # Imposta direttamente il prefisso predefinito. Se presente # questo valore sovrascriver\u00e0 il \"default_type\".","title":"[respond]"},{"location":"Config_Reference.html#exclude_object","text":"Abilita il supporto per escludere o cancellare singoli oggetti durante il processo di stampa. Per ulteriori informazioni, vedere la guida escludi oggetti e riferimento ai comandi . Vedere il file sample-macros.cfg per una macro G-Code M486 compatibile con Marlin/RepRapFirmware. [exclude_object]","title":"[exclude_object]"},{"location":"Config_Reference.html#compensazione-della-risonanza","text":"","title":"Compensazione della risonanza"},{"location":"Config_Reference.html#input_shaper","text":"Abilita compensazione della risonanza . Vedere anche il command reference . [input_shaper] #shaper_freq_x: 0 # Una frequenza (in Hz) dell'input shaper per l'asse X. Questa \u00e8 # solitamente una frequenza di risonanza dell'asse X che l'input # shaper dovrebbe sopprimere. Per shaper pi\u00f9 complessi, come # shaper di input EI a 2 e 3 gobbe, questo parametro pu\u00f2 essere # impostato in base a diverse considerazioni. # Il valore predefinito \u00e8 0, che disabilita la modellatura dell'input # per l'asse X. #shaper_freq_y: 0 # Una frequenza (in Hz) dell'input shaper per l'asse Y. Questa \u00e8 # solitamente una frequenza di risonanza dell'asse Y che l'input # shaper dovrebbe sopprimere. Per shaper pi\u00f9 complessi, come # shaper di input EI a 2 e 3 gobbe, questo parametro pu\u00f2 essere # impostato in base a diverse considerazioni. Il valore predefinito # \u00e8 0, che disabilita la modellatura dell'input per l'asse Y. #shaper_type: mzv # Un tipo di input shaper da utilizzare per entrambi gli assi X e Y. # Gli shaper supportati sono zv, mzv, zvd, ei, 2hump_ei e # 3hump_ei. L'impostazione predefinita \u00e8 mzv input shaper. #shaper_type_x: #shaper_type_y: # Se shaper_type non \u00e8 impostato, questi due parametri possono # essere utilizzati per configurare diversi shaper di input per gli # assi X e Y. Sono supportati gli stessi valori del parametro # shaper_type. #damping_ratio_x: 0.1 #damping_ratio_y: 0.1 # Rapporti di smorzamento delle vibrazioni degli assi X e Y # utilizzati dagli shaper di input per migliorare la soppressione # delle vibrazioni. Il valore predefinito \u00e8 0,1, un buon valore per la # maggior parte delle stampanti. Nella maggior parte dei casi # questo parametro non richiede ottimizzazione e # non deve essere modificato.","title":"[input_shaper]"},{"location":"Config_Reference.html#adxl345","text":"Supporto per accelerometri ADXL345. Questo supporto consente di interrogare le misurazioni dell'accelerometro dal sensore. Ci\u00f2 abilita un comando ACCELEROMETER_MEASURE (consultare G-Codes per ulteriori informazioni). Il nome del chip predefinito \u00e8 \"predefinito\", ma \u00e8 possibile specificare un nome esplicito (ad esempio, [adxl345 my_chip_name]). [adxl345] cs_pin: # The SPI enable pin for the sensor. This parameter must be provided. #spi_speed: 5000000 # The SPI speed (in hz) to use when communicating with the chip. # The default is 5000000. #spi_bus: #spi_software_sclk_pin: #spi_software_mosi_pin: #spi_software_miso_pin: # See the \"common SPI settings\" section for a description of the # above parameters. #axes_map: x, y, z # The accelerometer axis for each of the printer's X, Y, and Z axes. # This may be useful if the accelerometer is mounted in an # orientation that does not match the printer orientation. For # example, one could set this to \"y, x, z\" to swap the X and Y axes. # It is also possible to negate an axis if the accelerometer # direction is reversed (eg, \"x, z, -y\"). The default is \"x, y, z\". #rate: 3200 # Output data rate for ADXL345. ADXL345 supports the following data # rates: 3200, 1600, 800, 400, 200, 100, 50, and 25. Note that it is # not recommended to change this rate from the default 3200, and # rates below 800 will considerably affect the quality of resonance # measurements.","title":"[adxl345]"},{"location":"Config_Reference.html#mpu9250","text":"Support for MPU-9250, MPU-9255, MPU-6515, MPU-6050, and MPU-6500 accelerometers (one may define any number of sections with an \"mpu9250\" prefix). [mpu9250 my_accelerometer] #i2c_address: # Default is 104 (0x68). If AD0 is high, it would be 0x69 instead. #i2c_mcu: #i2c_bus: #i2c_speed: 400000 # See the \"common I2C settings\" section for a description of the # above parameters. The default \"i2c_speed\" is 400000. #axes_map: x, y, z # See the \"adxl345\" section for information on this parameter.","title":"[mpu9250]"},{"location":"Config_Reference.html#resonance_tester","text":"Supporto per test di risonanza e calibrazione automatica del input shaper. Per utilizzare la maggior parte delle funzionalit\u00e0 di questo modulo, devono essere installate dipendenze software aggiuntive; fare riferimento a Measuring Resonances e al command reference per ulteriori informazioni. Per ulteriori informazioni sul parametro max_smoothing e sul suo utilizzo, vedere la sezione Max smoothing della guida alla misurazione delle risonanze. [resonance_tester] #probe_points: # Un elenco di coordinate X, Y, Z di punti (un punto per linea) in cui # testare le risonanze. Almeno un punto \u00e8 richiesto. Assicurati che tutti # i punti con un margine di sicurezza nel piano XY (~ pochi centimetri) # siano raggiungibili dalla testa di stampa. #accel_chip: # Un nome del chip dell'accelerometro da utilizzare per le misurazioni. # Se il chip adxl345 \u00e8 stato definito senza un nome esplicito, questo # parametro pu\u00f2 semplicemente fare riferimento ad esso come # \"accel_chip: adxl345\", altrimenti deve essere fornito anche un nome # esplicito, ad es. \"accel_chip: adxl345 mio_chip_nome\". \u00c8 necessario # impostare questo o i due parametri successivi. #accel_chip_x: #accel_chip_y: # Nomi dei chip dell'accelerometro da utilizzare per le misurazioni per # ciascuno degli assi. Pu\u00f2 essere utile, ad esempio, su una stampante con # piatto, se due accelerometri separati sono montati sul piatto (per l'asse Y) # e sulla testa di stampa (per l'asse X). Questi parametri hanno lo stesso # formato del parametro 'accel_chip'. # \u00c8 necessario fornire solo 'accel_chip' o questi due parametri. #max_smoothing: # Maximum input shaper smoothing to allow for each axis during shaper # auto-calibration (with 'SHAPER_CALIBRATE' command). By default no # maximum smoothing is specified. Refer to Measuring_Resonances guide # for more details on using this feature. #min_freq: 5 # Frequenza minima per testare le risonanze. L'impostazione \u00e8 5 Hz. #max_freq: 133.33 # Frequenza massima per testare le risonanze. L'impostazione \u00e8 133,33 Hz. #accel_per_hz: 75 # Questo parametro viene utilizzato per determinare quale accelerazione # utilizzare per testare una frequenza specifica: accel = accel_per_hz * freq. # Maggiore \u00e8 il valore, maggiore \u00e8 l'energia delle oscillazioni. Pu\u00f2 essere # impostato su un valore inferiore al valore predefinito se le risonanze # diventano troppo forti sulla stampante. Tuttavia, valori pi\u00f9 bassi rendono # le misurazioni delle risonanze ad alta frequenza meno precise. # Il valore predefinito \u00e8 75 (mm/sec). #hz_per_sec: 1 # Determina la velocit\u00e0 del test. Quando si testano tutte le frequenze # nell'intervallo [freq_min, freq_max], ogni secondo la frequenza aumenta # di hz_per_sec. Valori piccoli rallentano il test e valori grandi diminuiscono # la precisione del test. Il valore predefinito \u00e8 1,0 (Hz/sec == sec^-2).","title":"[resonance_tester]"},{"location":"Config_Reference.html#helper-per-i-file-di-configurazione","text":"","title":"Helper per i file di configurazione"},{"location":"Config_Reference.html#board_pins","text":"Alias pin board (si pu\u00f2 definire un numero qualsiasi di sezioni con un prefisso \"board_pins\"). Usalo per definire gli alias per i pin su un microcontrollore. [board_pins my_aliases] mcu: mcu # A comma separated list of micro-controllers that may use the # aliases. The default is to apply the aliases to the main \"mcu\". aliases: aliases_<name>: # A comma separated list of \"name=value\" aliases to create for the # given micro-controller. For example, \"EXP1_1=PE6\" would create an # \"EXP1_1\" alias for the \"PE6\" pin. However, if \"value\" is enclosed # in \"<>\" then \"name\" is created as a reserved pin (for example, # \"EXP1_9=<GND>\" would reserve \"EXP1_9\"). Any number of options # starting with \"aliases_\" may be specified.","title":"[board_pins]"},{"location":"Config_Reference.html#include","text":"Supporto per includere i file. Uno pu\u00f2 includere un file di configurazione aggiuntivo dal file di configurazione della stampante principale. Possono essere utilizzati anche caratteri jolly (ad es. \"configs/*.cfg\"). [include my_other_config.cfg]","title":"[include]"},{"location":"Config_Reference.html#duplicate_pin_override","text":"Questo strumento consente di definire pi\u00f9 volte un singolo pin del microcontrollore in un file di configurazione senza il normale controllo degli errori. Questo \u00e8 inteso per scopi diagnostici e di debug. Questa sezione non \u00e8 necessaria laddove Klipper supporta l'utilizzo dello stesso pin pi\u00f9 volte e l'utilizzo di questa sostituzione pu\u00f2 causare risultati confusi e imprevisti. [duplicate_pin_override] pins: # Un elenco di pin separato da virgole che possono essere utilizzati pi\u00f9 volte in # un file di configurazione senza normali controlli degli errori. Questo parametro deve essere # fornito.","title":"[duplicate_pin_override]"},{"location":"Config_Reference.html#hardware-per-probing-del-piatto","text":"","title":"Hardware per probing del piatto"},{"location":"Config_Reference.html#probe","text":"Sonda di altezza Z. Si pu\u00f2 definire questa sezione per abilitare l'hardware di rilevamento dell'altezza Z. Quando questa sezione \u00e8 abilitata, i comandi estesi PROBE e QUERY_PROBE comandi g-code diventano disponibili. Inoltre, vedere la Guida alla calibrazione della sonda . La sezione probe crea anche un pin virtuale \"probe:z_virtual_endstop\". Si pu\u00f2 impostare stepper_z endstop_pin su questo pin virtuale su stampanti in stile cartesiano che utilizzano la sonda al posto di un endstop z. Se si utilizza \"probe:z_virtual_endstop\", non definire un position_endstop nella sezione di configurazione stepper_z. [probe] pin: # Pin di rilevamento della sonda. Se il pin si trova su un # microcontrollore diverso rispetto agli stepper Z, abilita # \"homing multi-mcu\". Questo parametro deve essere fornito. #deactivate_on_each_sample: True # Questo determina se Klipper deve eseguire la disattivazione # gcode tra ogni tentativo di esplorazione durante l'esecuzione di # una sequenza di probe multiple. L'impostazione predefinita \u00e8 True. #x_offset: 0.0 # La distanza (in mm) tra la sonda e l'ugello lungo l'asse x. # Il valore predefinito \u00e8 0. #y_offset: 0.0 # La distanza (in mm) tra la sonda e l'ugello lungo l'asse y. # Il valore predefinito \u00e8 0. z_offset: # La distanza (in mm) tra il piatto e l'ugello quando la sonda si attiva. # Questo parametro deve essere fornito. #speed: 5.0 # Velocit\u00e0 (in mm/s) dell'asse Z durante probing. # Il valore predefinito \u00e8 5 mm/s. #samples: 1 # Il numero di volte in cui sondare ciascun punto. I valori z sondati # verranno mediati. L'impostazione predefinita \u00e8 sondare 1 volta. #sample_retract_dist: 2.0 # La distanza (in mm) per sollevare la testa di stampa tra ciascun # campione (se si esegue il campionamento pi\u00f9 di una volta). # Il valore predefinito \u00e8 2 mm. #lift_speed: # Velocit\u00e0 (in mm/s) dell'asse Z durante il sollevamento della sonda # tra i campioni. L'impostazione predefinita prevede l'utilizzo dello # stesso valore del parametro 'speed'. #samples_result: average # Il metodo di calcolo durante il campionamento pi\u00f9 di una volta: # \"median\" o \"average\". L'impostazione predefinita \u00e8 average. #samples_tolerance: 0.100 # La distanza Z massima (in mm) che un campione pu\u00f2 differire da # altri campioni. Se questa tolleranza viene superata, viene segnalato # un errore o il tentativo viene riavviato # (vedere samples_tolerance_retries). Il valore predefinito \u00e8 0,100 mm. #samples_tolerance_retries: 0 # Il numero di tentativi per riprovare se viene trovato un campione che # supera samples_tolerance. In un nuovo tentativo, tutti i campioni # correnti vengono eliminati e il tentativo di sonda viene riavviato. # Se non si ottiene un insieme valido di campioni nel numero di tentativi # specificato, viene segnalato un errore. Il valore predefinito \u00e8 zero che # causa la segnalazione di un errore sul primo campione che supera # samples_tolerance. #activate_gcode: # Un elenco di comandi G-Code da eseguire prima di ogni tentativo di # esplorazione. Vedi docs/Command_Templates.md per il formato # G-Code. Questo pu\u00f2 essere utile se la sonda deve essere attivata in # qualche modo. Non impartire qui alcun comando che sposti la testa # di stampa (ad es. G1). L'impostazione predefinita \u00e8 di non eseguire # alcun comando G-Code speciale all'attivazione. #deactivate_gcode: # Un elenco di comandi G-Code da eseguire dopo il completamento di # ogni tentativo di esplorazione. Vedi docs/Command_Templates.md # per il formato G-Code. Non impartire qui alcun comando che sposti # la testina. L'impostazione predefinita \u00e8 di non eseguire alcun # comando G-Code speciale alla disattivazione.","title":"[probe]"},{"location":"Config_Reference.html#bltouch","text":"Sonda BLTouch. Si pu\u00f2 definire questa sezione (anzich\u00e9 una sezione sonda) per abilitare una sonda BLTouch. Per ulteriori informazioni, vedere BL-Touch guide e command reference .. Viene anche creato un pin virtuale \"probe:z_virtual_endstop\" (consultare la sezione \"probe\" per i dettagli). [bltouch] sensor_pin: # Pin connected to the BLTouch sensor pin. Most BLTouch devices # require a pullup on the sensor pin (prefix the pin name with \"^\"). # This parameter must be provided. control_pin: # Pin connected to the BLTouch control pin. This parameter must be # provided. #pin_move_time: 0.680 # The amount of time (in seconds) to wait for the BLTouch pin to # move up or down. The default is 0.680 seconds. #stow_on_each_sample: True # This determines if Klipper should command the pin to move up # between each probe attempt when performing a multiple probe # sequence. Read the directions in docs/BLTouch.md before setting # this to False. The default is True. #probe_with_touch_mode: False # If this is set to True then Klipper will probe with the device in # \"touch_mode\". The default is False (probing in \"pin_down\" mode). #pin_up_reports_not_triggered: True # Set if the BLTouch consistently reports the probe in a \"not # triggered\" state after a successful \"pin_up\" command. This should # be True for all genuine BLTouch devices. Read the directions in # docs/BLTouch.md before setting this to False. The default is True. #pin_up_touch_mode_reports_triggered: True # Set if the BLTouch consistently reports a \"triggered\" state after # the commands \"pin_up\" followed by \"touch_mode\". This should be # True for all genuine BLTouch devices. Read the directions in # docs/BLTouch.md before setting this to False. The default is True. #set_output_mode: # Request a specific sensor pin output mode on the BLTouch V3.0 (and # later). This setting should not be used on other types of probes. # Set to \"5V\" to request a sensor pin output of 5 Volts (only use if # the controller board needs 5V mode and is 5V tolerant on its input # signal line). Set to \"OD\" to request the sensor pin output use # open drain mode. The default is to not request an output mode. #x_offset: #y_offset: #z_offset: #speed: #lift_speed: #samples: #sample_retract_dist: #samples_result: #samples_tolerance: #samples_tolerance_retries: # See the \"probe\" section for information on these parameters.","title":"[bltouch]"},{"location":"Config_Reference.html#smart_effector","text":"Lo \"Smart Effector\" di Duet3d implementa una sonda Z utilizzando un sensore di forza. Si pu\u00f2 definire questa sezione invece di [probe] per abilitare le funzioni specifiche di Smart Effector. Ci\u00f2 consente anche a comandi di runtime di regolare i parametri di Smart Effector in fase di esecuzione. [smart_effector] pin: # Pin collegato al pin di uscita della sonda Z Smart Effector (pin 5). Si noti # che la resistenza di pullup sulla scheda generalmente non \u00e8 richiesta. # Tuttavia, se il pin di uscita \u00e8 collegato al pin della scheda con un resistore # di pullup, tale resistore deve essere di valore elevato (ad es. 10K Ohm o pi\u00f9). # Alcune schede hanno un resistore di pullup di basso valore sull'ingresso # della sonda Z, che probabilmente far\u00e0 risultare in uno stato di sonda sempre # attivato. In questo caso, collegare lo Smart Effector a un pin diverso sulla # scheda. Questo parametro \u00e8 obbligatorio. #control_pin: # Pin collegato al pin di ingresso di controllo Smart Effector (pin 7). Se fornito, # diventano disponibili i comandi di programmazione della sensibilit\u00e0 # di Smart Effector. #probe_accel: # Se impostato, limita l'accelerazione dei movimenti di tastatura (in mm/sec^2). # Un'improvvisa grande accelerazione all'inizio del movimento di esplorazione # pu\u00f2 causare l'attivazione spuria della sonda, specialmente se l'hotend \u00e8 pesante. # Per evitarlo, potrebbe essere necessario ridurre l'accelerazione dei movimenti # di tastatura tramite questo parametro. #recovery_time: 0.4 # Un ritardo tra i movimenti di spostamento e tastatura in secondi. Un # movimento veloce prima della tastatura pu\u00f2 causare l'attivazione spuria della # sonda. Ci\u00f2 pu\u00f2 causare errori \"Sonda attivata prima del movimento\" se non # \u00e8 impostato alcun ritardo. Il valore 0 disabilita il ritardo di ripristino. # Il valore predefinito \u00e8 0.4. #x_offset: #y_offset: # Dovrebbe essere lasciato non impostato (o impostato su 0). z_offset: # Altezza di attivazione della sonda. Inizia con -0.1 (mm) e regola in seguito # usando il comando `PROBE_CALIBRATE`. Questo parametro deve essere fornito. #speed: # Velocit\u00e0 (in mm/s) dell'asse Z durante la tastatura. Si consiglia di iniziare con la # velocit\u00e0 di tastatura di 20 mm/s e di regolarla secondo necessit\u00e0 per migliorare la # precisione e la ripetibilit\u00e0 dell'attivazione della sonda. #samples: #sample_retract_dist: #samples_result: #samples_tolerance: #samples_tolerance_retries: #activate_gcode: #deactivate_gcode: #deactivate_on_each_sample: # Vedere la sezione \"probe\" per ulteriori informazioni sui parametri di cui sopra.","title":"[smart_effector]"},{"location":"Config_Reference.html#motori-passo-passo-ed-estrusori-aggiuntivi","text":"","title":"Motori passo-passo ed estrusori aggiuntivi"},{"location":"Config_Reference.html#stepper_z1","text":"Assi multi-stepper. Su una stampante in stile cartesiano, lo stepper che controlla un dato asse pu\u00f2 avere blocchi di configurazione aggiuntivi che definiscono gli stepper che dovrebbero essere azionati insieme allo stepper primario. Si pu\u00f2 definire un numero qualsiasi di sezioni con un suffisso numerico che inizia da 1 (ad esempio, \"stepper_z1\", \"stepper_z2\", ecc.). [stepper_z1] #step_pin: #dir_pin: #enable_pin: #microsteps: #rotation_distance: # Vedere la sezione \"stepper\" per la definizione dei parametri di cui sopra. #endstop_pin: # Se viene definito un endstop_pin per lo stepper aggiuntivo, lo stepper # si fermer\u00e0 fino all'attivazione dell'endstop. In caso contrario, lo stepper # si fermer\u00e0 fino a quando non verr\u00e0 attivato il finecorsa sullo stepper # primario per l'asse.","title":"[stepper_z1]"},{"location":"Config_Reference.html#extruder1","text":"In una stampante multiestrusore aggiungere una sezione estrusore aggiuntiva per ogni estrusore aggiuntivo. Le sezioni aggiuntive dell'estrusore devono essere denominate \"extruder1\", \"extruder2\", \"extruder3\" e cos\u00ec via. Vedere la sezione \"extruder\" per una descrizione dei parametri disponibili. Vedere sample-multi-extruder.cfg per un esempio di configurazione. [extruder1] #step_pin: #dir_pin: #... # Vedere la sezione \"estrusore\" per i parametri per lo stepper e il riscaldatore # disponibili. #shared_heater: # Questa opzione \u00e8 obsoleta e non deve pi\u00f9 essere specificata.","title":"[extruder1]"},{"location":"Config_Reference.html#dual_carriage","text":"Supporto per stampanti cartesiane con doppi carrelli su un unico asse. Il carrello attivo viene impostato tramite il comando G-code esteso SET_DUAL_CARRIAGE. Il comando \"SET_DUAL_CARRIAGE CARRIAGE=1\" attiver\u00e0 il carrello definito in questa sezione (CARRIAGE=0 riporter\u00e0 l'attivazione al carrello principale). Il supporto del doppio carrello \u00e8 in genere combinato con estrusori extra: il comando SET_DUAL_CARRIAGE viene spesso chiamato contemporaneamente al comando ACTIVATE_EXTRUDER. Assicurati di parcheggiare i carrelli durante la disattivazione. Vedere sample-idex.cfg per un esempio di configurazione. [dual_carriage] axis: # L'asse su cui si trova questo carrello aggiuntivo (x o y). Questo parametro # deve essere fornito #step_pin: #dir_pin: #enable_pin: #microsteps: #rotation_distance: #endstop_pin: #position_endstop: #position_min: #position_max: # Vedere la sezione \"stepper\" per la definizione dei parametri di cui sopra.","title":"[dual_carriage]"},{"location":"Config_Reference.html#extruder_stepper","text":"Supporto per stepper aggiuntivi sincronizzati al movimento di un estrusore (si pu\u00f2 definire un numero qualsiasi di sezioni con un prefisso \"extruder_stepper\"). Per ulteriori informazioni, vedere riferimento comando . [extruder_stepper my_extra_stepper] extruder: # L'estrusore con cui \u00e8 sincronizzato questo stepper. Se questo \u00e8 impostato su # una stringa vuota, lo stepper non verr\u00e0 sincronizzato con un # estrusore. Questo parametro deve essere fornito. #step_pin: #dir_pin: #enable_pin: #microsteps: #rotation_distance: # Vedere la sezione \"stepper\" per la definizione dei parametri sopra. # .","title":"[extruder_stepper]"},{"location":"Config_Reference.html#stepper-manuali","text":"Stepper manuali (\u00e8 possibile definire un numero qualsiasi di sezioni con un prefisso \"manual_stepper\"). Questi sono stepper controllati dal comando g-code MANUAL_STEPPER. Ad esempio: \"MANUAL_STEPPER STEPPER=my_stepper MOVE=10 SPEED=5\". Vedere il file G-Codes per una descrizione del comando MANUAL_STEPPER. Gli stepper non sono collegati alla normale cinematica della stampante. [manual_stepper my_stepper] #step_pin: #dir_pin: #enable_pin: #microsteps: #rotation_distance: # Vedere la sezione \"stepper\" per una descrizione di questi parametri. #velocity: # Impostare la velocit\u00e0 predefinita (in mm/s) per lo stepper. Questo # valore verr\u00e0 utilizzato se un comando MANUAL_STEPPER non specifica # un parametro SPEED. Il valore predefinito \u00e8 5 mm/s. #accel: # Imposta l'accelerazione predefinita (in mm/s^2) per lo stepper. # Un'accelerazione pari a zero non risulter\u00e0 in nessuna accelerazione. # Questo valore verr\u00e0 utilizzato se un comando MANUAL_STEPPER non # specifica un parametro ACCEL. Il valore predefinito \u00e8 zero. #endstop_pin: # Pin di rilevamento interruttore di fine corsa. Se specificato, \u00e8 possibile # eseguire \"movimenti di riferimento\" aggiungendo un parametro # STOP_ON_ENDSTOP ai comandi di movimento MANUAL_STEPPER.","title":"[Stepper manuali]"},{"location":"Config_Reference.html#riscaldatori-e-sensori-personalizzati","text":"","title":"Riscaldatori e sensori personalizzati"},{"location":"Config_Reference.html#verify_heater","text":"Verifica riscaldatore e sensore di temperatura. La verifica del riscaldatore viene abilitata automaticamente per ogni riscaldatore configurato sulla stampante. Usa le sezioni di verifica_riscaldatore per modificare le impostazioni predefinite. [verify_heater heater_config_name] #max_error: 120 # Il massimo \"errore di temperatura cumulativo\" prima di generare un # errore. Valori pi\u00f9 piccoli comportano un controllo pi\u00f9 rigoroso e valori # pi\u00f9 grandi consentono pi\u00f9 tempo prima che venga segnalato un errore. # Nello specifico la temperatura viene osservata una volta al secondo e # se \u00e8 prossima alla temperatura target viene azzerato un \"contatore errori\" # interno; in caso contrario, se la temperatura \u00e8 inferiore all'intervallo target, # il contatore viene aumentato della quantit\u00e0 in cui la temperatura riportata # differisce da tale intervallo. Se il contatore supera questo \"errore_max\", # viene generato un errore. Il valore predefinito \u00e8 120. #check_gain_time: # Questo controlla la verifica del riscaldatore durante il riscaldamento # iniziale. Valori pi\u00f9 piccoli comportano un controllo pi\u00f9 rigoroso e valori # pi\u00f9 grandi consentono pi\u00f9 tempo prima che venga segnalato un errore. # In particolare, durante il riscaldamento iniziale, fintanto che il riscaldatore # aumenta di temperatura entro questo intervallo di tempo (specificato in # secondi), il \"contatore errori\" interno viene azzerato. Il valore predefinito # \u00e8 20 secondi per gli estrusori e 60 secondi per heater_bed. #hysteresis: 5 # La differenza di temperatura massima (in gradi Celsius) rispetto a una # temperatura target considerata nell'intervallo del target. Questo controlla # nell'intervallo max_error. \u00c8 raro personalizzare questo valore. # L'impostazione predefinita \u00e8 5. #heating_gain: 2 # La temperatura minima (in gradi Celsius) di cui il riscaldatore deve # aumentare durante il check_gain_time. \u00c8 raro personalizzare questo valore. # L'impostazione predefinita \u00e8 2.","title":"[verify_heater]"},{"location":"Config_Reference.html#homing_heaters","text":"Strumento per disabilitare i riscaldatori durante l'homing o la probing di un asse. [homing_heaters] #steppers: # Un elenco separato da virgole di stepper che dovrebbero causare # la disattivazione dei riscaldatori. L'impostazione predefinita \u00e8 # disabilitare i riscaldatori per qualsiasi spostamento di homing/sonda. # Esempio tipico: stepper_z #heaters: # Un elenco separato da virgole di riscaldatori da disabilitare # durante i movimenti di homing/probing. L'impostazione # predefinita \u00e8 disabilitare tutti i riscaldatori. # Esempio tipico: estrusore, letto riscaldatore","title":"[homing_heaters]"},{"location":"Config_Reference.html#thermistor","text":"Termistori personalizzati (si pu\u00f2 definire un numero qualsiasi di sezioni con un prefisso \"thermistor\"). \u00c8 possibile utilizzare un termistore personalizzato nel campo sensor_type di una sezione di configurazione del riscaldatore. (Ad esempio, se si definisce una sezione \"[thermistor my_thermistor]\", \u00e8 possibile utilizzare un \"sensor_type: my_thermistor\" quando si definisce un riscaldatore.) Assicurati di posizionare la sezione del termistore nel file di configurazione sopra il suo primo utilizzo in una sezione del riscaldatore . [thermistor my_thermistor] #temperature1: #resistance1: #temperature2: #resistance2: #temperature3: #resistance3: # Tre misure di resistenza (in Ohm) alle temperature date (in Celsius). # Le tre misurazioni verranno utilizzate per calcolare i coefficienti di # Steinhart-Hart per il termistore. Questi parametri devono essere # forniti quando si utilizza Steinhart-Hart per definire il termistore. #beta: # In alternativa, \u00e8 possibile definire temperatura1, resistenza1 e beta # per definire i parametri del termistore. Questo parametro deve # essere fornito quando si utilizza \"beta\" per definire il termistore.","title":"[thermistor]"},{"location":"Config_Reference.html#adc_temperature","text":"Sensori di temperatura ADC personalizzati (si pu\u00f2 definire un numero qualsiasi di sezioni con un prefisso \"adc_temperature\"). Ci\u00f2 consente di definire un sensore di temperatura personalizzato che misura una tensione su un pin del convertitore da analogico a digitale (ADC) e utilizza l'interpolazione lineare tra una serie di misurazioni di temperatura/tensione (o temperatura/resistenza) configurate per determinare la temperatura. Il sensore risultante pu\u00f2 essere utilizzato come tipo_sensore in una sezione riscaldatore. (Ad esempio, se si definisce una sezione \"[adc_temperature my_sensor]\", \u00e8 possibile utilizzare un \"sensor_type: my_sensor\" quando si definisce un riscaldatore.) Assicurati di posizionare la sezione del sensore nel file di configurazione sopra il suo primo utilizzo in una sezione del riscaldatore. [adc_temperature my_sensor] #temperature1: #voltage1: #temperature2: #voltage2: #... # A set of temperatures (in Celsius) and voltages (in Volts) to use # as reference when converting a temperature. A heater section using # this sensor may also specify adc_voltage and voltage_offset # parameters to define the ADC voltage (see \"Common temperature # amplifiers\" section for details). At least two measurements must # be provided. #temperature1: #resistance1: #temperature2: #resistance2: #... # Alternatively one may specify a set of temperatures (in Celsius) # and resistance (in Ohms) to use as reference when converting a # temperature. A heater section using this sensor may also specify a # pullup_resistor parameter (see \"extruder\" section for details). At # least two measurements must be provided.","title":"[adc_temperature]"},{"location":"Config_Reference.html#heater_generic","text":"Riscaldatori generici (si pu\u00f2 definire un numero qualsiasi di sezioni con il prefisso \"riscaldatore_generico\"). Questi riscaldatori si comportano in modo simile ai riscaldatori standard (estrusori, piatti riscaldati). Utilizzare il comando SET_HEATER_TEMPERATURE (consultare G-Codes per i dettagli) per impostare la temperatura target. [heater_generic my_generic_heater] #gcode_id: # L'ID da utilizzare quando si riporta la temperatura nel comando M105. # Questo parametro deve essere fornito. #max_power: #sensor_type: #sensor_pin: #smooth_time: #control: #pid_Kp: #pid_Ki: #pid_Kd: #pwm_cycle_time: #min_temp: #max_temp: # Vedere la sezione \"extruder\" per la definizione dei parametri sopra.","title":"[heater_generic]"},{"location":"Config_Reference.html#temperature_sensor","text":"Sensori di temperatura generici. \u00c8 possibile definire un numero qualsiasi di sensori di temperatura aggiuntivi che vengono riportati tramite il comando M105. [temperature_sensor my_sensor] #sensor_type: #sensor_pin: #min_temp: #max_temp: # Vedi la sezione \"extruder\" per la definizione dei parametri # sopra indicati. #gcode_id: # Vedi la sezione \"heater_generic\" per la definizione dei # parametri sopra indicati.","title":"[temperature_sensor]"},{"location":"Config_Reference.html#sensori-di-temperatura","text":"Klipper include definizioni per molti tipi di sensori di temperatura. Questi sensori possono essere utilizzati in qualsiasi sezione di configurazione che richieda un sensore di temperatura (come una sezione [extruder] o [heater_bed] ).","title":"Sensori di temperatura"},{"location":"Config_Reference.html#termistori-comuni","text":"Termistori comuni. I seguenti parametri sono disponibili nelle sezioni del riscaldatore che utilizzano uno di questi sensori. sensor_type: # Uno di \"EPCOS 100K B57560G104F\", \"ATC Semitec 104GT-2\", # \"ATC Semitec 104NT-4-R025H42G\", \"Generic 3950\", # \"Honeywell 100K 135-104LAG-J01\", \"NTC 100K MGB18-104F39050L32\", # \"SliceEngineering 450\", o \"TDK NTCG104LH104JT1\" sensor_pin: # Pin di ingresso analogico collegato al termistore. # Questo parametro deve essere fornito. #pullup_resistor: 4700 # La resistenza (in ohm) del pullup collegato al termistore. # Il valore predefinito \u00e8 4700 ohm. #inline_resistor: 0 # La resistenza (in ohm) di un resistore aggiuntivo (non a variazione di # calore) posizionato in linea con il termistore. \u00c8 raro impostare questo. # Il valore predefinito \u00e8 0 ohm.","title":"Termistori comuni"},{"location":"Config_Reference.html#amplificatori-di-temperatura-comuni","text":"Amplificatori di temperatura comuni. I seguenti parametri sono disponibili nelle sezioni del riscaldatore che utilizzano uno di questi sensori. sensor_type: # Uno tra \"PT100 INA826\", \"AD595\", \"AD597\", \"AD8494\", \"AD8495\", # \"AD8496\", o \"AD8497\". sensor_pin: # Pin di ingresso analogico collegato al sensore. Questo parametro # deve essere fornito. #adc_voltage: 5.0 # La tensione di confronto dell'ADC (in Volt). Il valore predefinito # \u00e8 5 volt. #voltage_offset: 0 # L'offset di tensione ADC (in Volt). Il valore predefinito \u00e8 0.","title":"Amplificatori di temperatura comuni"},{"location":"Config_Reference.html#sensore-pt1000-collegato-direttamente","text":"Sensore PT1000 collegato direttamente. I seguenti parametri sono disponibili nelle sezioni del riscaldatore che utilizzano uno di questi sensori. sensor_type: PT1000 sensor_pin: # Pin di ingresso analogico collegato al sensore. Questo parametro # deve essere fornito. #pullup_resistor: 4700 # La resistenza (in ohm) del pullup collegato al sensore. Il valore # predefinito \u00e8 4700 ohm.","title":"Sensore PT1000 collegato direttamente"},{"location":"Config_Reference.html#sensori-di-temperatura-maxxxxxx","text":"Sensori temperatura MAXxxxxx con interfaccia periferica seriale (SPI). I seguenti parametri sono disponibili nelle sezioni del riscaldatore che utilizzano uno di questi tipi di sensore. sensor_type: # Uno tra \"MAX6675\", \"MAX31855\", \"MAX31856\", o \"MAX31865\". sensor_pin: # Il pin mcu collegato al pin di selezione del chip del sensore. # Questo parametro deve essere fornito. #spi_speed: 4000000 # La velocit\u00e0 SPI (in hz) da utilizzare durante la comunicazione # con il chip. Il valore predefinito \u00e8 4000000. #spi_bus: #spi_software_sclk_pin: #spi_software_mosi_pin: #spi_software_miso_pin: # Vedere la sezione \"impostazioni comuni SPI\" per una # descrizione dei parametri di cui sopra. #tc_type: K #tc_use_50Hz_filter: False #tc_averaging_count: 1 # I parametri di cui sopra controllano i parametri del sensore # dei chip MAX31856. I valori predefiniti per ciascun parametro # sono accanto al nome del parametro nell'elenco precedente. #rtd_nominal_r: 100 #rtd_reference_r: 430 #rtd_num_of_wires: 2 #rtd_use_50Hz_filter: False # I parametri di cui sopra controllano i parametri del sensore dei # chip MAX31865. I valori predefiniti per ciascun parametro sono # accanto al nome del parametro nell'elenco precedente.","title":"Sensori di temperatura MAXxxxxx"},{"location":"Config_Reference.html#sensore-di-temperatura-bmp280bme280bme680","text":"Sensori ambientali BMP280/BME280/BME680 con interfaccia I2C. Si noti che questi sensori non sono destinati all'uso con estrusori e letti riscaldanti, ma piuttosto per il monitoraggio della temperatura ambiente (C), della pressione (hPa), dell'umidit\u00e0 relativa (%)e di livello del gas per il BME680. Vedere sample-macros.cfg per una gcode_macro che pu\u00f2 essere utilizzata per riportare la pressione e l'umidit\u00e0 oltre alla temperatura. sensor_type: BME280 #i2c_address: # Il valore predefinito \u00e8 118 (0x76). Alcuni sensori BME280 hanno un # indirizzo di 119 (0x77). #i2c_mcu: #i2c_bus: #i2c_speed: # Vedere la sezione \"impostazioni comuni I2C\" per una descrizione # dei parametri di cui sopra.","title":"Sensore di temperatura BMP280/BME280/BME680"},{"location":"Config_Reference.html#sensore-htu21d","text":"Sensore ambientale con interfaccia a due fili (I2C) della famiglia HTU21D. Si noti che questo sensore non \u00e8 destinato all'uso con estrusori e letti riscaldanti, ma piuttosto per il monitoraggio della temperatura ambiente (C) e dell'umidit\u00e0 relativa(%). Vedere sample-macros.cfg per una gcode_macro che pu\u00f2 essere utilizzata per riportare l'umidit\u00e0 oltre alla temperatura. sensor_type: # Deve essere \"HTU21D\", \"SI7013\", \"SI7020\", \"SI7021\" o \"SHT21\" #i2c_address: # Il valore predefinito \u00e8 64 (0x40). #i2c_mcu: #i2c_bus: #i2c_speed: # Vedere la sezione \"impostazioni comuni I2C\" per una # descrizione dei parametri di cui sopra. #htu21d_hold_master: # Se il sensore pu\u00f2 trattenere il buf I2C durante la lettura. Se # True nessun'altra comunicazione bus pu\u00f2 essere eseguita mentre # la lettura \u00e8 in corso. L'impostazione predefinita \u00e8 False. #htu21d_resolution: # La risoluzione della lettura di temperatura e umidit\u00e0. # I valori validi sono: # 'TEMP14_HUM12' -> 14bit per Temp e 12bit per umidit\u00e0 # 'TEMP13_HUM10' -> 13bit per Temp e 10bit per umidit\u00e0 # 'TEMP12_HUM08' -> 12bit per Temp e 08bit per umidit\u00e0 # 'TEMP11_HUM11' -> 11bit per Temp e 11bit per umidit\u00e0 # L'impostazione predefinita \u00e8: \"TEMP11_HUM11\" #htu21d_report_time: # Intervallo in secondi tra le letture. Il valore predefinito \u00e8 30","title":"Sensore HTU21D"},{"location":"Config_Reference.html#sensore-di-temperatura-lm75","text":"Sensori di temperatura (I2C) LM75/LM75A. Questi sensori hanno una gamma di -55~125 C, quindi sono utilizzabili ad es. monitoraggio della temperatura della camera. Possono anche funzionare come semplici controller per ventole/riscaldatori. sensor_type: LM75 #i2c_address: # Il valore predefinito \u00e8 72 (0x48). L'intervallo normale \u00e8 72-79 # (0x48-0x4F) e i 3 bit bassi dell'indirizzo sono configurati tramite # pin sul chip (di solito con ponticelli o cablati). #i2c_mcu: #i2c_bus: #i2c_speed: # Vedere la sezione \"impostazioni comuni I2C\" per una descrizione # dei parametri di cui sopra. #lm75_report_time: # Intervallo in secondi tra le letture. Il valore predefinito \u00e8 0.8 # con il minimo 0.5.","title":"Sensore di temperatura LM75"},{"location":"Config_Reference.html#sensore-di-temperatura-integrato-nel-microcontrollore","text":"I microcontrollori atsam, atsamd e stm32 contengono un sensore di temperatura interno. \u00c8 possibile utilizzare il sensore \"temperature_mcu\" per monitorare queste temperature. sensor_type: temperature_mcu #sensor_mcu: mcu # Il microcontrollore da cui leggere. L'impostazione predefinita \u00e8 \"mcu\". #sensor_temperature1: #sensor_adc1: # Specificare i due parametri precedenti (una temperatura in gradi # Celsius e un valore ADC come float compreso tra 0,0 e 1,0) per # calibrare la temperatura del microcontrollore. Ci\u00f2 potrebbe # migliorare la precisione della temperatura riportata su alcuni chip. # Un modo tipico per ottenere queste informazioni di calibrazione # consiste nel rimuovere completamente l'alimentazione dalla # stampante per alcune ore (per assicurarsi che sia alla temperatura # ambiente), quindi accenderla e utilizzare il comando QUERY_ADC # per ottenere una misurazione ADC. Utilizzare un altro sensore di # temperatura sulla stampante per trovare la temperatura ambiente # corrispondente. L'impostazione predefinita consiste nell'utilizzare # i dati di calibrazione di fabbrica sul microcontrollore (se applicabile) # o i valori nominali dalle specifiche del microcontrollore. #sensor_temperature2: #sensor_adc2: # Se viene specificato sensor_temperature1/sensor_adc1, \u00e8 anche # possibile specificare i dati di calibrazione sensor_temperature2/sensor_adc2. # Ci\u00f2 potrebbe fornire informazioni calibrate sulla \"curva della # temperatura\". L'impostazione predefinita consiste nell'utilizzare i dati # di calibrazione di fabbrica sul microcontrollore (se applicabile) o i # valori nominali dalle specifiche del microcontrollore.","title":"Sensore di temperatura integrato nel microcontrollore"},{"location":"Config_Reference.html#sensore-di-temperatura-host","text":"Temperatura dalla macchina (es. Raspberry Pi) che esegue il software host. sensor_type: temperature_host #sensor_path: # il percorso del file di sistema della temperatura. L'impostazione # predefinita \u00e8 \"/sys/class/thermal/thermal_zone0/temp\" che \u00e8 il file di # sistema della temperatura su un computer Raspberry Pi.","title":"Sensore di temperatura host"},{"location":"Config_Reference.html#sensore-di-temperatura-ds18b20","text":"DS18B20 \u00e8 un sensore di temperatura digitale a 1 filo (w1). Si noti che questo sensore non \u00e8 destinato all'uso con estrusori e letti riscaldanti, ma piuttosto per il monitoraggio della temperatura ambiente (C). Questi sensori hanno una portata fino a 125 C, quindi sono utilizzabili ad es. monitoraggio della temperatura della camera. Possono anche funzionare come semplici controller per ventole/riscaldatori. I sensori DS18B20 sono supportati solo su \"host mcu\", ad es. il Raspberry Pi. \u00c8 necessario installare il modulo del kernel Linux w1-gpio. sensor_type: DS18B20 serial_no: # Ogni dispositivo a 1 filo ha un numero di serie univoco utilizzato per # identificare il dispositivo, solitamente nel formato 28-031674b175ff. Questo # parametro deve essere fornito. I dispositivi collegati a 1 filo possono essere # elencati utilizzando il seguente comando Linux: ls /sys/bus/w1/devices/ #ds18_report_time: # Intervallo in secondi tra le letture. Il valore predefinito \u00e8 3.0, con un # minimo di 1.0 #sensor_mcu: # Il microcontrollore da cui leggere. Deve essere host_mcu","title":"Sensore di temperatura DS18B20"},{"location":"Config_Reference.html#ventole","text":"","title":"Ventole"},{"location":"Config_Reference.html#fan","text":"Ventola di raffreddamento della stampa. [fan] pin: # Pin di output che controlla la ventola. Questo parametro deve essere fornito. #max_power: 1.0 # La potenza massima (espressa come un valore compreso tra 0.0 e 1.0) a # cui pu\u00f2 essere impostato il pin. Il valore 1.0 consente di impostare il pin # completamente abilitato per periodi prolungati, mentre un valore di 0.5 # consentirebbe di abilitare il pin per non pi\u00f9 della met\u00e0 del tempo. Questa # impostazione pu\u00f2 essere utilizzata per limitare la potenza totale (per # periodi prolungati) della ventola. Se questo valore \u00e8 inferiore a 1.0, le # richieste di velocit\u00e0 della ventola verranno ridimensionate tra zero e # max_power (ad esempio, se max_power \u00e8 0.9 e viene richiesta una # velocit\u00e0 della ventola dell'80%, la potenza della ventola verr\u00e0 impostata # su 72%). L'impostazione predefinita \u00e8 1.0. #shutdown_speed: 0 # La velocit\u00e0 della ventola desiderata (espressa come valore da 0.0 a # 1.0) se il software del microcontrollore entra in uno stato di errore. # Il valore predefinito \u00e8 0. #cycle_time: 0.010 # La quantit\u00e0 di tempo (in secondi) per ogni ciclo di alimentazione PWM # alla ventola. Si consiglia di essere pari o superiore a 10 millisecondi # quando si utilizza il PWM basato su software. # Il valore predefinito \u00e8 0,010 secondi. #hardware_pwm: False # Abilitare questa opzione per utilizzare PWM hardware anzich\u00e9 PWM # software. La maggior parte delle ventole non funziona bene con PWM # hardware, quindi non \u00e8 consigliabile abilitarlo a meno che non vi sia # un requisito elettrico per passare a velocit\u00e0 molto elevate. Quando # si utilizza l'hardware PWM, il tempo di ciclo effettivo \u00e8 vincolato # dall'implementazione e pu\u00f2 essere notevolmente diverso dal tempo # di ciclo richiesto. L'impostazione predefinita \u00e8 False. #kick_start_time: 0.100 # Tempo (in secondi) per far funzionare la ventola a piena velocit\u00e0 # quando la si abilita per la prima volta o la si aumenta di oltre il 50% # (aiuta a far girare la ventola). Il valore predefinito \u00e8 0,100 secondi. #off_below: 0.0 # La velocit\u00e0 minima in input che alimenter\u00e0 la ventola (espressa # come un valore da 0.0 a 1.0). Quando viene richiesta una velocit\u00e0 # inferiore a off_below la ventola verr\u00e0 invece spenta. Questa # impostazione pu\u00f2 essere utilizzata per prevenire lo stallo della # ventola e per garantire che i kick start siano efficaci. # Il valore predefinito \u00e8 0.0. # # Questa impostazione deve essere ricalibrata ogni volta che # max_power viene regolato. Per calibrare questa impostazione, # inizia con off_below impostato su 0.0 e la ventola gira. Abbassare # gradualmente la velocit\u00e0 della ventola per determinare la velocit\u00e0 # di ingresso pi\u00f9 bassa che aziona la ventola in modo affidabile senza # stalli. Impostare off_below al duty cycle corrispondente a questo # valore (ad esempio, 12% -> 0,12) o leggermente superiore. #tachometer_pin: # Pin di ingresso contagiri per il monitoraggio della velocit\u00e0 della # ventola. In genere \u00e8 richiesto un pullup. Questo parametro \u00e8 facoltativo. #tachometer_ppr: 2 # Quando viene specificato tachometer_pin, questo \u00e8 il numero di # impulsi per giro del segnale del tachimetro. Per una ventola BLDC # questo \u00e8 normalmente la met\u00e0 del numero di poli. # L'impostazione predefinita \u00e8 2. #tachometer_poll_interval: 0.0015 # Quando viene specificato tachometer_pin, questo \u00e8 il periodo di polling # del pin del contagiri, in secondi. Il valore predefinito \u00e8 0.0015, che \u00e8 # abbastanza veloce per le ventole al di sotto di 10000 RPM a 2 PPR. Deve # essere inferiore a 30/(tachometer_ppr*rpm), con un certo margine, # dove rpm \u00e8 la velocit\u00e0 massima (in RPM) della ventola. #enable_pin: # Pin opzionale per abilitare l'alimentazione alla ventola. Questo pu\u00f2 # essere utile per le ventole con ingressi PWM dedicati. Alcune di queste # ventole rimangono accese anche allo 0% di ingresso PWM. In tal caso, # il pin PWM pu\u00f2 essere utilizzato normalmente e ad es. un FET commutato # a terra (pin della ventola standard) pu\u00f2 essere utilizzato per controllare # l'alimentazione alla ventola.","title":"[fan]"},{"location":"Config_Reference.html#heater_fan","text":"Ventole di raffreddamento del riscaldatore (si pu\u00f2 definire un numero qualsiasi di sezioni con un prefisso \"heater_fan\"). Una \"ventola riscaldatore\" \u00e8 una ventola che verr\u00e0 abilitata ogni volta che il riscaldatore associato \u00e8 attivo. Per impostazione predefinita, un heater_fan ha una velocit\u00e0 di spegnimento pari a max_power. [heater_fan my_nozzle_fan] #pin: #max_power: #shutdown_speed: #cycle_time: #hardware_pwm: #kick_start_time: #off_below: #tachometer_pin: #tachometer_ppr: #tachometer_poll_interval: #enable_pin: # Vedere la sezione \"fan\" per una descrizione dei parametri di cui sopra. #heater: extruder # Nome della sezione di configurazione che definisce il riscaldatore a cui # \u00e8 associato questa ventola. Se qui viene fornito un elenco di nomi di # riscaldatori separati da virgole, la ventola verr\u00e0 abilitata quando uno # qualsiasi dei riscaldatori indicati \u00e8 abilitato. # L'impostazione predefinita \u00e8 \"extruder\". #heater_temp: 50.0 # Una temperatura (in gradi Celsius) sotto la quale il riscaldatore deve # scendere prima che la ventola venga disattivata. # L'impostazione predefinita \u00e8 50 gradi Celsius. #fan_speed: 1.0 # La velocit\u00e0 della ventola (espressa come un valore compreso tra 0.0 e # 1.0) a cui verr\u00e0 impostato la ventola quando viene abilitato il relativo # riscaldatore. L'impostazione predefinita \u00e8 1.0","title":"[heater_fan]"},{"location":"Config_Reference.html#controller_fan","text":"Ventola di raffreddamento del controller (\u00e8 possibile definire un numero qualsiasi di sezioni con il prefisso \"controller_fan\"). Una \"ventola del controller\" \u00e8 una ventola che verr\u00e0 abilitata ogni volta che il riscaldatore associato o il driver stepper associato \u00e8 attivo. La ventola si fermer\u00e0 ogni volta che viene raggiunto un idle_timeout per garantire che non si verifichi alcun surriscaldamento dopo la disattivazione di un componente osservato. [controller_fan my_controller_fan] #pin: #max_power: #shutdown_speed: #cycle_time: #hardware_pwm: #kick_start_time: #off_below: #tachometer_pin: #tachometer_ppr: #tachometer_poll_interval: #enable_pin: # Vedere la sezione \"fan\" per una descrizione dei parametri di cui sopra. #fan_speed: 1.0 # La velocit\u00e0 della ventola (espressa come un valore compreso tra 0.0 e # 1.0) a cui verr\u00e0 impostata la ventola quando \u00e8 attivo un riscaldatore # o un driver passo-passo. L'impostazione predefinita \u00e8 1.0 #idle_timeout: # La quantit\u00e0 di tempo (in secondi) dopo che un driver passo-passo o # un riscaldatore \u00e8 stato attivo per la quale la ventola deve essere tenuta # in funzione. L'impostazione predefinita \u00e8 30 secondi. #idle_speed: # La velocit\u00e0 della ventola (espressa come un valore compreso tra 0.0 # e 1.0) a cui verr\u00e0 impostata la ventola quando era attivo un riscaldatore # o un driver passo-passo e prima che venga raggiunto l'idle_timeout. # L'impostazione predefinita \u00e8 fan_speed. #heater: #stepper: # Nome della sezione di configurazione che definisce il riscaldatore/ # stepper a cui \u00e8 associata questa ventola. Se qui viene fornito un # elenco separato da virgole di nomi di riscaldatori/stepper, la ventola # sar\u00e0 abilitata quando uno qualsiasi dei riscaldatori/stepper indicati # \u00e8 abilitato. Il riscaldatore predefinito \u00e8 \"estrusore\", lo stepper # predefinito sono tutti.","title":"[controller_fan]"},{"location":"Config_Reference.html#temperature_fan","text":"Ventole di raffreddamento attivate dalla temperatura (\u00e8 possibile definire un numero qualsiasi di sezioni con un prefisso \"temperature_fan\"). Una \"ventola di temperatura\" \u00e8 una ventola che verr\u00e0 abilitata ogni volta che il sensore associato \u00e8 al di sopra di una temperatura impostata. Per impostazione predefinita, una ventola_temperatura ha una velocit\u00e0_di_arresto pari a potenza_massima. Per ulteriori informazioni, vedere command reference . [temperature_fan my_temp_fan] #pin: #max_power: #shutdown_speed: #cycle_time: #hardware_pwm: #kick_start_time: #off_below: #tachometer_pin: #tachometer_ppr: #tachometer_poll_interval: #enable_pin: # Vedere la sezione \"fan\" per una descrizione dei parametri di cui sopra. #sensor_type: #sensor_pin: #control: #max_delta: #min_temp: #max_temp: # Vedere la sezione \"extruder\" per una descrizione dei parametri di cui sopra. #pid_Kp: #pid_Ki: #pid_Kd: # Le impostazioni proporzionale (pid_Kp), integrale (pid_Ki) e derivata (pid_Kd) # per il sistema di controllo del feedback PID. Klipper valuta le impostazioni PID # con la seguente formula generale: fan_pwm = max_power - (Kp*e + Ki*integral(e) # - Kd*derivative(e)) / 255 Dove \"e\" \u00e8 \"target_temperature - measure_temperature\" # e \"fan_pwm\" \u00e8 la frequenza della ventola richiesta con 0.0 per spento e 1.0 al # massimo. I parametri pid_Kp, pid_Ki e pid_Kd devono essere forniti quando l# 'algoritmo di controllo PID \u00e8 abilitato. #pid_deriv_time: 2.0 # Un valore di tempo (in secondi) su cui le misurazioni della temperatura verranno # livellate quando si utilizza l'algoritmo di controllo PID. Ci\u00f2 pu\u00f2 ridurre l'impatto # del rumore di misurazione. Il valore predefinito \u00e8 2 secondi. #target_temp: 40.0 # Una temperatura (in Celsius) che sar\u00e0 la temperatura target. # L'impostazione predefinita \u00e8 40 gradi. #max_speed: 1.0 # La velocit\u00e0 della ventola (espressa come un valore compreso tra 0.0 e 1.0) a cui # verr\u00e0 impostata la ventola quando la temperatura del sensore supera il valore # impostato. L'impostazione predefinita \u00e8 1.0. #min_speed: 0.3 # La velocit\u00e0 minima della ventola (espressa come un valore compreso tra 0.0 e # 1.0) alla quale la ventola verr\u00e0 impostata per le ventole con temperatura PID. # Il valore predefinito \u00e8 0.3. #gcode_id: # Se impostata, la temperatura verr\u00e0 riportata nelle query M105 utilizzando l'id # fornito. L'impostazione predefinita \u00e8 di non riportare la temperatura tramite M105.","title":"[temperature_fan]"},{"location":"Config_Reference.html#fan_generic","text":"Ventola a controllo manuale (si pu\u00f2 definire un numero qualsiasi di sezioni con il prefisso \"fan_generic\"). La velocit\u00e0 di una ventola controllata manualmente viene impostata con SET_FAN_SPEED comando gcode . [fan_generic extruder_partfan] #pin: #max_power: #shutdown_speed: #cycle_time: #hardware_pwm: #kick_start_time: #off_below: #tachometer_pin: #tachometer_ppr: #tachometer_poll_interval: #enable_pin: # Vedere la sezione \"fan\" per una descrizione dei parametri di cui sopra.","title":"[fan_generic]"},{"location":"Config_Reference.html#leds","text":"","title":"LEDs"},{"location":"Config_Reference.html#led","text":"Supporto per LED (e strisce LED) controllati tramite pin PWM del microcontrollore (si pu\u00f2 definire un numero qualsiasi di sezioni con un prefisso \"led\"). Per ulteriori informazioni, vedere command reference . [led my_led] #red_pin: #green_pin: #blue_pin: #white_pin: # Il pin che controlla il colore del LED specificato. Deve essere fornito # almeno uno dei parametri sopra indicati. #cycle_time: 0.010 # La quantit\u00e0 di tempo (in secondi) per ciclo PWM. Si consiglia che sia # pari o superiore a 10 millisecondi quando si utilizza il PWM basato # su software. Il valore predefinito \u00e8 0,010 secondi. #hardware_pwm: False # Abilitare questa opzione per utilizzare PWM hardware anzich\u00e9 PWM # software. Quando si utilizza l'hardware PWM, il tempo di ciclo effettivo # \u00e8 vincolato dall'implementazione e pu\u00f2 essere notevolmente diverso # dal tempo di ciclo richiesto. L'impostazione predefinita \u00e8 Falso. #initial_RED: 0.0 #initial_GREEN: 0.0 #initial_BLUE: 0.0 #initial_WHITE: 0.0 # Imposta il colore iniziale del LED. Ciascun valore deve essere # compreso tra 0,0 e 1,0. Il valore predefinito per ogni colore \u00e8 0.","title":"[led]"},{"location":"Config_Reference.html#neopixel","text":"Supporto LED Neopixel (aka WS2812) (si pu\u00f2 definire un numero qualsiasi di sezioni con un prefisso \"neopixel\"). Per ulteriori informazioni, vedere riferimento comando . Si noti che l'implementazione di linux mcu non supporta attualmente i neopixel collegati direttamente. L'attuale design che utilizza l'interfaccia del kernel Linux non consente questo scenario perch\u00e9 l'interfaccia GPIO del kernel non \u00e8 sufficientemente veloce da fornire le frequenze di impulso richieste. [neopixel my_neopixel] pin: # Il pin collegato al neopixel. Questo parametro deve essere fornito. #chain_count: # Il numero di chip Neopixel che sono \"collegati a margherita\" al # pin fornito. Il valore predefinito \u00e8 1 (che indica che un solo # Neopixel \u00e8 collegato al pin). #color_order: GRB # Impostare l'ordine dei pixel richiesto dall'hardware del LED # (utilizzando una stringa contenente le lettere R, G, B, W con W # opzionale). In alternativa, questo pu\u00f2 essere un elenco separato # da virgole di pixel, uno per ogni LED nella catena. # L'impostazione predefinita \u00e8 GRB. #initial_RED: 0.0 #initial_GREEN: 0.0 #initial_BLUE: 0.0 #initial_WHITE: 0.0 # Vedere la sezione \"led\" per informazioni su questi parametri.","title":"[neopixel]"},{"location":"Config_Reference.html#dotstar","text":"Supporto LED Dotstar (conosciuti anche come APA102) (si pu\u00f2 definire un numero qualsiasi di sezioni con un prefisso \"dotstar\"). Per ulteriori informazioni, vedere command reference . [dotstar my_dotstar] data_pin: # Il pin connesso alla data line del dotstar. Questo parametro # deve essere fornito. clock_pin: # Il pin connesso alla clock line del dotstar. Questo parametro # deve essere fornito. #chain_count: # Vedere la sezione \"neopixel\" per informazioni su questo parametro. #initial_RED: 0.0 #initial_GREEN: 0.0 #initial_BLUE: 0.0 # Vedere la sezione \"led\" per informazioni su questo parametro.","title":"[dotstar]"},{"location":"Config_Reference.html#pca9533","text":"PCA9533 Supporto LED. Il PCA9533 viene utilizzato sulla scheda mightyboard. [pca9533 my_pca9533] #i2c_address: 98 # L'indirizzo i2c utilizzato dal chip sul bus i2c. Utilizzare 98 per # PCA9533/1, 99 per PCA9533/2. Il valore predefinito \u00e8 98. #i2c_mcu: #i2c_bus: #i2c_speed: # Vedere la sezione \"impostazioni comuni I2C\" per una # descrizione dei parametri di cui sopra. #initial_RED: 0.0 #initial_GREEN: 0.0 #initial_BLUE: 0.0 #initial_WHITE: 0.0 # Vedere la sezione \"led\" per informazioni su questi parametri.","title":"[pca9533]"},{"location":"Config_Reference.html#pca9632","text":"Supporto LED PCA9632. Il PCA9632 viene utilizzato su FlashForge Dreamer. [pca9632 my_pca9632] #i2c_address: 98 # L'indirizzo i2c utilizzato dal chip sul bus i2c. Pu\u00f2 essere 96, # 97, 98 o 99. Il valore predefinito \u00e8 98. #i2c_mcu: #i2c_bus: #i2c_speed: # Vedere la sezione \"impostazioni I2C comuni\" per una # descrizione dei parametri di cui sopra. #scl_pin: #sda_pin: # In alternativa, se il pca9632 non \u00e8 collegato a un bus I2C # hardware, \u00e8 possibile specificare i pin \"clock\" (pin scl) e \"data\" # (pin sda). L'impostazione predefinita prevede l'utilizzo # dell'hardware I2C. #color_order: RGBW # Impostare l'ordine dei pixel del LED (usando una stringa # contenente le lettere R, G, B, W). L'impostazione predefinita # \u00e8 RGBW. #initial_RED: 0.0 #initial_GREEN: 0.0 #initial_BLUE: 0.0 #initial_WHITE: 0.0 # Vedere la sezione \"led\" per informazioni su questi parametri.","title":"[pca9632]"},{"location":"Config_Reference.html#servocomandi-aggiuntivi-pulsanti-e-altri-pin","text":"","title":"Servocomandi aggiuntivi, pulsanti e altri pin"},{"location":"Config_Reference.html#servo","text":"Servo (si pu\u00f2 definire un numero qualsiasi di sezioni con un prefisso \"servo\"). I servo possono essere controllati usando SET_SERVO comando g-code . Ad esempio: SET_SERVO SERVO=my_servo ANGLE=180 [servo my_servo] pin: # Pin di uscita PWM che controlla il servo. Questo parametro deve # essere fornito. #maximum_servo_angle: 180 # L'angolo massimo (in gradi) a cui questo servo pu\u00f2 essere impostato. # L'impostazione predefinita \u00e8 180 gradi. #minimum_pulse_width: 0.001 # La durata minima dell'impulso (in secondi). Questo dovrebbe # corrispondere a un angolo di 0 gradi. Il valore predefinito \u00e8 0.001 secondi. #maximum_pulse_width: 0.002 # La durata massima dell'impulso (in secondi). Questo dovrebbe # corrispondere a un angolo di maximum_servo_angle. Il valore # predefinito \u00e8 0.002 secondi. #initial_angle: # Angolo iniziale (in gradi) su cui impostare il servo. L'impostazione # predefinita \u00e8 di non inviare alcun segnale all'avvio. #initial_pulse_width: # Durata iniziale dell'impulso (in secondi) su cui impostare il servo. # (Questo \u00e8 valido solo se initial_angle non \u00e8 impostato.) # L'impostazione predefinita \u00e8 di non inviare alcun segnale all'avvio.","title":"[servo]"},{"location":"Config_Reference.html#gcode_button","text":"Esegui gcode quando un pulsante viene premuto o rilasciato (o quando un pin cambia stato). Puoi controllare lo stato del pulsante usando QUERY_BUTTON button=my_gcode_button . [gcode_button my_gcode_button] pin: # Il pin su cui \u00e8 collegato il pulsante. Questo parametro deve essere fornito. #analog_range: # Due resistenze separate da virgole (in Ohm) che specificano l'intervallo # di resistenza minimo e massimo per il pulsante. Se viene fornito # analog_range, il pin deve essere un pin con capacit\u00e0 analogica. # L'impostazione predefinita \u00e8 utilizzare digital gpio per il pulsante. #analog_pullup_resistor: # La resistenza di pullup (in Ohm) quando \u00e8 specificato analog_range. # Il valore predefinito \u00e8 4700 ohm. #press_gcode: # Un elenco di comandi G-Code da eseguire quando si preme il pulsante. # I modelli G-Code sono supportati. Questo parametro deve essere fornito. #release_gcode: # Un elenco di comandi G-Code da eseguire quando il pulsante viene # rilasciato. I modelli G-Code sono supportati. L'impostazione predefinita # \u00e8 di non eseguire alcun comando al rilascio di un pulsante.","title":"[gcode_button]"},{"location":"Config_Reference.html#output_pin","text":"Pin di uscita configurabili in fase di run-time (\u00e8 possibile definire un numero qualsiasi di sezioni con un prefisso \"output_pin\"). I pin configurati qui verranno impostati come pin di output e sar\u00e0 possibile modificarli in fase di esecuzione utilizzando il comando esteso \"SET_PIN PIN=my_pin VALUE=.1\" comandi g-code . [output_pin my_pin] pin: # Il pin da configurare come output. # Questo parametro deve essere fornito. #pwm: False # Impostare se il pin di uscita deve essere in grado di modulare la # larghezza di impulso PWM. Se questo \u00e8 True, i campi del valore # dovrebbero essere compresi tra 0 e 1; se \u00e8 False i campi del valore # devono essere 0 o 1. Il valore predefinito \u00e8 False. #static_value: # Se \u00e8 valorizzato, il pin viene assegnato a questo valore all'avvio e # il pin non pu\u00f2 essere modificato durante il runtime. Un pin statico # utilizza una ram leggermente inferiore nel microcontrollore. # L'impostazione predefinita prevede l'utilizzo della configurazione # di runtime dei pin. #value: # Il valore su cui impostare inizialmente il pin durante la # configurazione dell'MCU. Il valore predefinito \u00e8 0 (per bassa tensione). #shutdown_value: # Il valore su cui impostare il pin su un evento di arresto dell'MCU. # Il valore predefinito \u00e8 0 (per bassa tensione). #maximum_mcu_duration: # La durata massima di un valore di non spegnimento pu\u00f2 essere # determinato dall'MCU senza un riconoscimento da parte dell'host. # Se l'host non riesce a tenere il passo con un aggiornamento, l'MCU # si spegner\u00e0 e imposter\u00e0 tutti i pin sui rispettivi valori di spegnimento. # Default: 0 (disabilitato) I valori abituali sono circa 5 secondi. #cycle_time: 0.100 # La quantit\u00e0 di tempo (in secondi) per ciclo PWM. Si consiglia di # essere pari o superiore a 10 millisecondi quando si utilizza il PWM # basato su software. Il valore predefinito \u00e8 0.100 secondi per i pin pwm. #hardware_pwm: False # Abilitare questa opzione per utilizzare PWM hardware anzich\u00e9 PWM # software. Quando si utilizza l'hardware PWM, il tempo di ciclo effettivo # \u00e8 vincolato dall'implementazione e pu\u00f2 essere notevolmente diverso # dal tempo di ciclo richiesto. L'impostazione predefinita \u00e8 Falso. #scale: # Questo parametro pu\u00f2 essere utilizzato per modificare il modo in cui # i parametri 'value' e 'shutdown_value' vengono interpretati per i pin # pwm. Se fornito, il parametro 'value' deve essere compreso tra 0.0 e # 'scale'. Questo pu\u00f2 essere utile quando si configura un pin PWM che # controlla un riferimento di tensione stepper. La \"scala\" pu\u00f2 essere # impostata sull'amperaggio dello stepper equivalente se il PWM fosse # completamente abilitato, quindi il parametro \"value\" pu\u00f2 essere # specificato utilizzando l'amperaggio desiderato per lo stepper. # L'impostazione predefinita \u00e8 di non ridimensionare il parametro 'value'.","title":"[output_pin]"},{"location":"Config_Reference.html#static_digital_output","text":"Pin di uscita digitali configurati staticamente (\u00e8 possibile definire un numero qualsiasi di sezioni con un prefisso \"static_digital_output\"). I pin configurati qui verranno impostati come uscita GPIO durante la configurazione dell'MCU. Non possono essere modificati in fase di esecuzione. [static_digital_output my_output_pins] pins: # Un elenco separato da virgole di pin da impostare come pin di # output GPIO. Il pin verr\u00e0 impostato su un livello alto a meno che il # nome del pin non sia preceduto da \"!\". Questo parametro deve # essere fornito.","title":"[static_digital_output]"},{"location":"Config_Reference.html#multi_pin","text":"Uscite a pin multipli (si pu\u00f2 definire un numero qualsiasi di sezioni con un prefisso \"multi_pin\"). Un output multi_pin crea un alias pin interno che pu\u00f2 modificare pi\u00f9 pin di output ogni volta che viene impostato il pin alias. Ad esempio, si potrebbe definire un oggetto \"[multi_pin my_fan]\" contenente due pin e quindi impostare \"pin=multi_pin:my_fan\" nella sezione \"[fan]\" - ad ogni cambio di ventola entrambi i pin di output verrebbero aggiornati. Questi alias non possono essere utilizzati con i pin del motore passo-passo. [multi_pin my_multi_pin] pins: # Un elenco separato da virgole di pin associati a questo alias. # Questo parametro deve essere fornito.","title":"[multi_pin]"},{"location":"Config_Reference.html#configurazione-del-driver-tmc-per-stepper","text":"Configurazione dei driver per motori passo-passo Trinamic in modalit\u00e0 UART/SPI. Ulteriori informazioni si trovano nella TMC Drivers guide e nel command reference .","title":"Configurazione del driver TMC per stepper"},{"location":"Config_Reference.html#tmc2130","text":"Configurare un driver per motore passo-passo TMC2130 tramite bus SPI. Per utilizzare questa funzione, definire una sezione di configurazione con un prefisso \"tmc2130\" seguito dal nome della sezione di configurazione dello stepper corrispondente (ad esempio, \"[tmc2130 stepper_x]\"). [tmc2130 stepper_x] cs_pin: # The pin corresponding to the TMC2130 chip select line. This pin # will be set to low at the start of SPI messages and raised to high # after the message completes. This parameter must be provided. #spi_speed: #spi_bus: #spi_software_sclk_pin: #spi_software_mosi_pin: #spi_software_miso_pin: # See the \"common SPI settings\" section for a description of the # above parameters. #chain_position: #chain_length: # These parameters configure an SPI daisy chain. The two parameters # define the stepper position in the chain and the total chain length. # Position 1 corresponds to the stepper that connects to the MOSI signal. # The default is to not use an SPI daisy chain. #interpolate: True # If true, enable step interpolation (the driver will internally # step at a rate of 256 micro-steps). This interpolation does # introduce a small systemic positional deviation - see # TMC_Drivers.md for details. The default is True. run_current: # The amount of current (in amps RMS) to configure the driver to use # during stepper movement. This parameter must be provided. #hold_current: # The amount of current (in amps RMS) to configure the driver to use # when the stepper is not moving. Setting a hold_current is not # recommended (see TMC_Drivers.md for details). The default is to # not reduce the current. #sense_resistor: 0.110 # The resistance (in ohms) of the motor sense resistor. The default # is 0.110 ohms. #stealthchop_threshold: 0 # The velocity (in mm/s) to set the \"stealthChop\" threshold to. When # set, \"stealthChop\" mode will be enabled if the stepper motor # velocity is below this value. The default is 0, which disables # \"stealthChop\" mode. #driver_MSLUT0: 2863314260 #driver_MSLUT1: 1251300522 #driver_MSLUT2: 608774441 #driver_MSLUT3: 269500962 #driver_MSLUT4: 4227858431 #driver_MSLUT5: 3048961917 #driver_MSLUT6: 1227445590 #driver_MSLUT7: 4211234 #driver_W0: 2 #driver_W1: 1 #driver_W2: 1 #driver_W3: 1 #driver_X1: 128 #driver_X2: 255 #driver_X3: 255 #driver_START_SIN: 0 #driver_START_SIN90: 247 # These fields control the Microstep Table registers directly. The optimal # wave table is specific to each motor and might vary with current. An # optimal configuration will have minimal print artifacts caused by # non-linear stepper movement. The values specified above are the default # values used by the driver. The value must be specified as a decimal integer # (hex form is not supported). In order to compute the wave table fields, # see the tmc2130 \"Calculation Sheet\" from the Trinamic website. #driver_IHOLDDELAY: 8 #driver_TPOWERDOWN: 0 #driver_TBL: 1 #driver_TOFF: 4 #driver_HEND: 7 #driver_HSTRT: 0 #driver_PWM_AUTOSCALE: True #driver_PWM_FREQ: 1 #driver_PWM_GRAD: 4 #driver_PWM_AMPL: 128 #driver_SGT: 0 # Set the given register during the configuration of the TMC2130 # chip. This may be used to set custom motor parameters. The # defaults for each parameter are next to the parameter name in the # above list. #diag0_pin: #diag1_pin: # The micro-controller pin attached to one of the DIAG lines of the # TMC2130 chip. Only a single diag pin should be specified. The pin # is \"active low\" and is thus normally prefaced with \"^!\". Setting # this creates a \"tmc2130_stepper_x:virtual_endstop\" virtual pin # which may be used as the stepper's endstop_pin. Doing this enables # \"sensorless homing\". (Be sure to also set driver_SGT to an # appropriate sensitivity value.) The default is to not enable # sensorless homing.","title":"[tmc2130]"},{"location":"Config_Reference.html#tmc2208","text":"Configurare un driver per motore passo-passo TMC2208 (o TMC2224) tramite UART a filo singolo. Per utilizzare questa funzione, definire una sezione di configurazione con un prefisso \"tmc2208\" seguito dal nome della sezione di configurazione dello stepper corrispondente (ad esempio, \"[tmc2208 stepper_x]\"). [tmc2208 stepper_x] uart_pin: # Il pin collegato al PDN_UART del TMC2208 . # Questo parametro deve essere fornito. #tx_pin: # Se si utilizzano linee di ricezione e trasmissione separate per # comunicare con il driver, impostare uart_pin sul pin di ricezione e # tx_pin sul pin di trasmissione. L'impostazione predefinita \u00e8 usare uart_pin sia per la lettura che per la scrittura. #select_pins: # Un elenco separato da virgole di pin da impostare prima di accedere # all'UART tmc2208. Questo pu\u00f2 essere utile per configurare un mux # analogico per la comunicazione UART. L'impostazione predefinita \u00e8 # di non configurare alcun pin. #interpolate: True # Se True, abilita l'interpolazione del passo (il driver eseguir\u00e0 un passo # intero con 256 micropassi). Questa interpolazione # introduce una piccola deviazione posizionale sistemica - vedere # TMC_Drivers.md per i dettagli. L'impostazione predefinita \u00e8 True. run_current: # La quantit\u00e0 di corrente (in ampere RMS) per configurare il driver da # utilizzare durante il movimento passo-passo. # Questo parametro deve essere fornito. #hold_current: # La quantit\u00e0 di corrente (in ampere RMS) per configurare il driver da # utilizzare quando lo stepper non \u00e8 in movimento. L'impostazione di # hold_current non \u00e8 consigliata (consultare TMC_Drivers.md per i # dettagli). L'impostazione predefinita \u00e8 di non ridurre la corrente. #sense_resistor: 0.110 # La resistenza (in ohm) del resistore di rilevamento del motore. # Il valore predefinito \u00e8 0,110 ohm. #stealthchop_threshold: 0 # La velocit\u00e0 (in mm/s) su cui impostare la soglia \"stealthChop\". Se # impostata, la modalit\u00e0 \"stealthChop\" sar\u00e0 abilitata se la velocit\u00e0 del # motore passo-passo \u00e8 inferiore a questo valore. Il valore predefinito # \u00e8 0, che disabilita la modalit\u00e0 \"stealthChop\". #driver_IHOLDDELAY: 8 #driver_TPOWERDOWN: 20 #driver_TBL: 2 #driver_TOFF: 3 #driver_HEND: 0 #driver_HSTRT: 5 #driver_PWM_AUTOGRAD: True #driver_PWM_AUTOSCALE: True #driver_PWM_LIM: 12 #driver_PWM_REG: 8 #driver_PWM_FREQ: 1 #driver_PWM_GRAD: 14 #driver_PWM_OFS: 36 # Impostare il registro dato durante la configurazione del chip TMC2208. # Pu\u00f2 essere utilizzato per impostare parametri motore personalizzati. # I valori predefiniti per ciascun parametro sono accanto al nome del # parametro nell'elenco precedente.","title":"[tmc2208]"},{"location":"Config_Reference.html#tmc2209","text":"Configurare un driver per motore passo-passo TMC2209 tramite UART a filo singolo. Per utilizzare questa funzione, definire una sezione di configurazione con un prefisso \"tmc2209\" seguito dal nome della sezione di configurazione dello stepper corrispondente (ad esempio, \"[tmc2209 stepper_x]\"). [tmc2209 stepper_x] uart_pin: #tx_pin: #select_pins: #interpolate: True run_current: #hold_current: #sense_resistor: 0.110 #stealthchop_threshold: 0 # Vedere la sezione \"tmc2208\" per la definizione di questi parametri. #uart_address: # L'indirizzo del chip TMC2209 per i messaggi UART (un numero intero # compreso tra 0 e 3). Viene in genere utilizzato quando pi\u00f9 chip TMC2209 # sono collegati allo stesso pin UART. Il valore predefinito \u00e8 zero #driver_IHOLDDELAY: 8 #driver_TPOWERDOWN: 20 #driver_TBL: 2 #driver_TOFF: 3 #driver_HEND: 0 #driver_HSTRT: 5 #driver_PWM_AUTOGRAD: True #driver_PWM_AUTOSCALE: True #driver_PWM_LIM: 12 #driver_PWM_REG: 8 #driver_PWM_FREQ: 1 #driver_PWM_GRAD: 14 #driver_PWM_OFS: 36 #driver_SGTHRS: 0 # Impostare il registro dato durante la configurazione del chip TMC2209. # Pu\u00f2 essere utilizzato per impostare parametri motore personalizzati. I # valori predefiniti per ciascun parametro sono accanto al nome del # parametro nell'elenco precedente. #diag_pin: # Il pin del microcontrollore collegato alla linea DIAG del chip TMC2209. # Il pin \u00e8 normalmente preceduto da \"^\" per abilitare un pullup. # L'impostazione di questo crea un pin virtuale \"tmc2209_stepper_x:virtual_endstop\" # che pu\u00f2 essere utilizzato come endstop_pin dello stepper. In questo modo # si abilita l'\"homing sensorless\". (Assicurarsi di impostare anche driver_SGTHRS # su un valore di sensibilit\u00e0 appropriato.) L'impostazione predefinita \u00e8 di non # abilitare l'homing sensorless.","title":"[tmc2209]"},{"location":"Config_Reference.html#tmc2660","text":"Configurare un driver per motore passo-passo TMC2660 tramite bus SPI. Per utilizzare questa funzione, definire una sezione di configurazione con un prefisso tmc2660 seguito dal nome della sezione di configurazione dello stepper corrispondente (ad esempio, \"[tmc2660 stepper_x]\"). [tmc2660 stepper_x] cs_pin: # Il pin corrispondente al pin di selezione del chip TMC2660. Questo pin # verr\u00e0 impostato su basso all'inizio dei messaggi SPI e impostato su # alto al termine del trasferimento del messaggio. Questo parametro # deve essere fornito. #spi_speed: 4000000 # Frequenza bus SPI utilizzata per comunicare con il driver # passo-passo TMC2660. Il valore predefinito \u00e8 4000000. #spi_bus: #spi_software_sclk_pin: #spi_software_mosi_pin: #spi_software_miso_pin: # Vedere la sezione \"impostazioni comuni SPI\" per una descrizione # dei parametri di cui sopra. #interpolate: True # Se true, abilita l'interpolazione del passo (il driver eseguir\u00e0 un passo # interno a una velocit\u00e0 di 256 micropassi). Funziona solo se microsteps # \u00e8 impostato su 16. L'interpolazione introduce una piccola deviazione # posizionale sistemica - vedere TMC_Drivers.md per i dettagli. # L'impostazione predefinita \u00e8 Vero. run_current: # La quantit\u00e0 di corrente (in ampere RMS) utilizzata dal driver durante # il movimento passo-passo. Questo parametro deve essere fornito. #sense_resistor: # La resistenza (in ohm) del resistore di rilevamento del motore. # Questo parametro deve essere fornito. #idle_current_percent: 100 # La percentuale di run_current a cui il driver stepper sar\u00e0 ridotto allo # scadere del timeout di inattivit\u00e0 (\u00e8 necessario impostare il timeout # utilizzando una sezione di configurazione [idle_timeout]). La corrente # verr\u00e0 nuovamente aumentata una volta che lo stepper dovr\u00e0 muoversi # di nuovo. Assicurati di impostarlo su un valore sufficientemente alto in # modo che gli stepper non perdano la loro posizione. C'\u00e8 anche un piccolo # ritardo fino a quando la corrente non viene nuovamente aumentata, # quindi tienine conto quando comandi mosse veloci mentre lo stepper \u00e8 # al minimo. Il valore predefinito \u00e8 100 (nessuna riduzione). #driver_TBL: 2 #driver_RNDTF: 0 #driver_HDEC: 0 #driver_CHM: 0 #driver_HEND: 3 #driver_HSTRT: 3 #driver_TOFF: 4 #driver_SEIMIN: 0 #driver_SEDN: 0 #driver_SEMAX: 0 #driver_SEUP: 0 #driver_SEMIN: 0 #driver_SFILT: 0 #driver_SGT: 0 #driver_SLPH: 0 #driver_SLPL: 0 #driver_DISS2G: 0 #driver_TS2G: 3 # Imposta il parametro indicato durante la configurazione del chip TMC2660. # Questo pu\u00f2 essere utilizzato per impostare parametri del driver personalizzati. # Le impostazioni predefinite per ogni parametro sono accanto al nome del # parametro nell'elenco sopra. Vedere la scheda tecnica del TMC2660 su cosa # fa ogni parametro e quali sono le restrizioni sulle combinazioni di parametri. # Prestare particolare attenzione al registro CHOPCONF, dove l'impostazione # di CHM su zero o uno comporter\u00e0 modifiche al layout (il primo bit di HDEC) # viene interpretato come MSB di HSTRT in questo caso).","title":"[tmc2660]"},{"location":"Config_Reference.html#tmc5160","text":"Configurare un driver per motore passo-passo TMC5160 tramite bus SPI. Per utilizzare questa funzione, definire una sezione di configurazione con un prefisso \"tmc5160\" seguito dal nome della sezione di configurazione dello stepper corrispondente (ad esempio, \"[tmc5160 stepper_x]\"). [tmc5160 stepper_x] cs_pin: # The pin corresponding to the TMC5160 chip select line. This pin # will be set to low at the start of SPI messages and raised to high # after the message completes. This parameter must be provided. #spi_speed: #spi_bus: #spi_software_sclk_pin: #spi_software_mosi_pin: #spi_software_miso_pin: # See the \"common SPI settings\" section for a description of the # above parameters. #chain_position: #chain_length: # These parameters configure an SPI daisy chain. The two parameters # define the stepper position in the chain and the total chain length. # Position 1 corresponds to the stepper that connects to the MOSI signal. # The default is to not use an SPI daisy chain. #interpolate: True # If true, enable step interpolation (the driver will internally # step at a rate of 256 micro-steps). The default is True. run_current: # The amount of current (in amps RMS) to configure the driver to use # during stepper movement. This parameter must be provided. #hold_current: # The amount of current (in amps RMS) to configure the driver to use # when the stepper is not moving. Setting a hold_current is not # recommended (see TMC_Drivers.md for details). The default is to # not reduce the current. #sense_resistor: 0.075 # The resistance (in ohms) of the motor sense resistor. The default # is 0.075 ohms. #stealthchop_threshold: 0 # The velocity (in mm/s) to set the \"stealthChop\" threshold to. When # set, \"stealthChop\" mode will be enabled if the stepper motor # velocity is below this value. The default is 0, which disables # \"stealthChop\" mode. #driver_MSLUT0: 2863314260 #driver_MSLUT1: 1251300522 #driver_MSLUT2: 608774441 #driver_MSLUT3: 269500962 #driver_MSLUT4: 4227858431 #driver_MSLUT5: 3048961917 #driver_MSLUT6: 1227445590 #driver_MSLUT7: 4211234 #driver_W0: 2 #driver_W1: 1 #driver_W2: 1 #driver_W3: 1 #driver_X1: 128 #driver_X2: 255 #driver_X3: 255 #driver_START_SIN: 0 #driver_START_SIN90: 247 # These fields control the Microstep Table registers directly. The optimal # wave table is specific to each motor and might vary with current. An # optimal configuration will have minimal print artifacts caused by # non-linear stepper movement. The values specified above are the default # values used by the driver. The value must be specified as a decimal integer # (hex form is not supported). In order to compute the wave table fields, # see the tmc2130 \"Calculation Sheet\" from the Trinamic website. #driver_IHOLDDELAY: 6 #driver_TPOWERDOWN: 10 #driver_TBL: 2 #driver_TOFF: 3 #driver_HEND: 2 #driver_HSTRT: 5 #driver_FD3: 0 #driver_TPFD: 4 #driver_CHM: 0 #driver_VHIGHFS: 0 #driver_VHIGHCHM: 0 #driver_DISS2G: 0 #driver_DISS2VS: 0 #driver_PWM_AUTOSCALE: True #driver_PWM_AUTOGRAD: True #driver_PWM_FREQ: 0 #driver_FREEWHEEL: 0 #driver_PWM_GRAD: 0 #driver_PWM_OFS: 30 #driver_PWM_REG: 4 #driver_PWM_LIM: 12 #driver_SGT: 0 #driver_SEMIN: 0 #driver_SEUP: 0 #driver_SEMAX: 0 #driver_SEDN: 0 #driver_SEIMIN: 0 #driver_SFILT: 0 # Set the given register during the configuration of the TMC5160 # chip. This may be used to set custom motor parameters. The # defaults for each parameter are next to the parameter name in the # above list. #diag0_pin: #diag1_pin: # The micro-controller pin attached to one of the DIAG lines of the # TMC5160 chip. Only a single diag pin should be specified. The pin # is \"active low\" and is thus normally prefaced with \"^!\". Setting # this creates a \"tmc5160_stepper_x:virtual_endstop\" virtual pin # which may be used as the stepper's endstop_pin. Doing this enables # \"sensorless homing\". (Be sure to also set driver_SGT to an # appropriate sensitivity value.) The default is to not enable # sensorless homing.","title":"[tmc5160]"},{"location":"Config_Reference.html#configurazione-della-corrente-del-motore-passo-passo-a-run-time","text":"","title":"Configurazione della corrente del motore passo-passo a run-time"},{"location":"Config_Reference.html#ad5206","text":"Digipot AD5206 configurati staticamente collegati tramite bus SPI (si pu\u00f2 definire un numero qualsiasi di sezioni con un prefisso \"ad5206\"). [ad5206 my_digipot] enable_pin: # The pin corresponding to the AD5206 chip select line. This pin # will be set to low at the start of SPI messages and raised to high # after the message completes. This parameter must be provided. #spi_speed: #spi_bus: #spi_software_sclk_pin: #spi_software_mosi_pin: #spi_software_miso_pin: # See the \"common SPI settings\" section for a description of the # above parameters. #channel_1: #channel_2: #channel_3: #channel_4: #channel_5: #channel_6: # The value to statically set the given AD5206 channel to. This is # typically set to a number between 0.0 and 1.0 with 1.0 being the # highest resistance and 0.0 being the lowest resistance. However, # the range may be changed with the 'scale' parameter (see below). # If a channel is not specified then it is left unconfigured. #scale: # This parameter can be used to alter how the 'channel_x' parameters # are interpreted. If provided, then the 'channel_x' parameters # should be between 0.0 and 'scale'. This may be useful when the # AD5206 is used to set stepper voltage references. The 'scale' can # be set to the equivalent stepper amperage if the AD5206 were at # its highest resistance, and then the 'channel_x' parameters can be # specified using the desired amperage value for the stepper. The # default is to not scale the 'channel_x' parameters.","title":"[ad5206]"},{"location":"Config_Reference.html#mcp4451","text":"Digipot MCP4451 configurato staticamente collegato tramite bus I2C (si pu\u00f2 definire un numero qualsiasi di sezioni con un prefisso \"mcp4451\"). [mcp4451 my_digipot] i2c_address: # L'indirizzo i2c utilizzato dal chip sul bus i2c. Questo parametro deve # essere fornito. #i2c_mcu: #i2c_bus: #i2c_speed: # Vedere la sezione \"impostazioni I2C comuni\" per una descrizione # dei parametri di cui sopra. #wiper_0: #wiper_1: #wiper_2: #wiper_3: # Il valore su cui impostare staticamente il \"wiper\" MCP4451 # specificato. Questo \u00e8 in genere impostato su un numero compreso # tra 0,0 e 1,0 con 1,0 come resistenza pi\u00f9 alta e 0,0 come resistenza # pi\u00f9 bassa. Tuttavia, l'intervallo pu\u00f2 essere modificato con il parametro # 'scale' (vedi sotto). Se non viene specificato un wiper, non viene # configurato. #scale: # Questo parametro pu\u00f2 essere utilizzato per modificare il modo in # cui vengono interpretati i parametri 'wiper_x'. Se forniti, i parametri # 'wiper_x' dovrebbero essere compresi tra 0.0 e 'scale'. Questo pu\u00f2 # essere utile quando l'MCP4451 viene utilizzato per impostare i # riferimenti di tensione stepper. La \"scala\" pu\u00f2 essere impostata # sull'amperaggio stepper equivalente se l'MCP4451 fosse alla sua # massima resistenza, quindi i parametri \"wiper_x\" possono essere # specificati utilizzando il valore di amperaggio desiderato per lo # stepper. L'impostazione predefinita \u00e8 di non ridimensionare i # parametri 'wiper_x'.","title":"[mcp4451]"},{"location":"Config_Reference.html#mcp4728","text":"Convertitore digitale-analogico MCP4728 in configurazione statica collegato tramite bus I2C (\u00e8 possibile definire un numero qualsiasi di sezioni con prefisso \"mcp4728\"). [mcp4728 my_dac] #i2c_address: 96 # L'indirizzo i2c utilizzato dal chip sul bus i2c. Il valore predefinito # \u00e8 96. #i2c_mcu: #i2c_bus: #i2c_speed: # Vedere la sezione \"impostazioni I2C comuni\" per una descrizione # dei parametri di cui sopra. #channel_a: #channel_b: #channel_c: #channel_d: # Il valore su cui impostare staticamente il canale MCP4728 # specificato. Questo \u00e8 in genere impostato su un numero compreso # tra 0,0 e 1,0 con 1,0 come tensione pi\u00f9 alta (2,048 V) e 0,0 come # tensione pi\u00f9 bassa. Tuttavia, l'intervallo pu\u00f2 essere modificato con # il parametro 'scale' (vedi sotto). Se un canale non \u00e8 specificato, # non viene configurato. #scale: # Questo parametro pu\u00f2 essere utilizzato per modificare il modo # in cui vengono interpretati i parametri 'channel_x'. Se forniti, i # parametri 'channel_x' dovrebbero essere compresi tra 0.0 e 'scale'. # Questo pu\u00f2 essere utile quando l'MCP4728 viene utilizzato per # impostare i riferimenti di tensione stepper. La \"scala\" pu\u00f2 essere # impostata sull'amperaggio stepper equivalente se l'MCP4728 # fosse alla sua tensione pi\u00f9 alta (2,048 V), e quindi i parametri # \"channel_x\" possono essere specificati utilizzando il valore di # amperaggio desiderato per lo stepper. L'impostazione # predefinita \u00e8 di non ridimensionare i parametri 'channel_x'.","title":"[mcp4728]"},{"location":"Config_Reference.html#mcp4018","text":"Digipot MCP4018 configurato staticamente collegato tramite due pin gpio \"bit banging\" (si pu\u00f2 definire un numero qualsiasi di sezioni con un prefisso \"mcp4018\"). [mcp4018 my_digipot] scl_pin: # Il pin \"clock\" SCL. Questo parametro deve essere fornito. sda_pin: # Il pin \"dati\" SDA. Questo parametro deve essere fornito. wiper: # Il valore su cui impostare staticamente il \"Wiper\" MCP4018 # specificato. Questo \u00e8 in genere impostato su un numero compreso # tra 0,0 e 1,0 con 1,0 come resistenza pi\u00f9 alta e 0,0 come resistenza # pi\u00f9 bassa. Tuttavia, l'intervallo pu\u00f2 essere modificato con il # parametro 'scale' (vedi sotto). Questo parametro deve essere fornito. #scale: # Questo parametro pu\u00f2 essere utilizzato per modificare il modo in # cui viene interpretato il parametro 'wiper'. Se fornito, il parametro # 'wiper' dovrebbe essere compreso tra 0.0 e 'scale'. Questo pu\u00f2 essere # utile quando l'MCP4018 viene utilizzato per impostare i riferimenti di # tensione stepper. La \"scala\" pu\u00f2 essere impostata sull'amperaggio # stepper equivalente se l'MCP4018 \u00e8 alla sua massima resistenza, # quindi \u00e8 possibile specificare il parametro \"wiper\" utilizzando il # valore di amperaggio desiderato per lo stepper. L'impostazione # predefinita \u00e8 di non ridimensionare il parametro 'wiper'.","title":"[mcp4018]"},{"location":"Config_Reference.html#supporto-display","text":"","title":"Supporto display"},{"location":"Config_Reference.html#display","text":"Supporto per un display collegato al microcontrollore. [display] lcd_type: # The type of LCD chip in use. This may be \"hd44780\", \"hd44780_spi\", # \"st7920\", \"emulated_st7920\", \"uc1701\", \"ssd1306\", or \"sh1106\". # See the display sections below for information on each type and # additional parameters they provide. This parameter must be # provided. #display_group: # The name of the display_data group to show on the display. This # controls the content of the screen (see the \"display_data\" section # for more information). The default is _default_20x4 for hd44780 # displays and _default_16x4 for other displays. #menu_timeout: # Timeout for menu. Being inactive this amount of seconds will # trigger menu exit or return to root menu when having autorun # enabled. The default is 0 seconds (disabled) #menu_root: # Name of the main menu section to show when clicking the encoder # on the home screen. The defaults is __main, and this shows the # the default menus as defined in klippy/extras/display/menu.cfg #menu_reverse_navigation: # When enabled it will reverse up and down directions for list # navigation. The default is False. This parameter is optional. #encoder_pins: # The pins connected to encoder. 2 pins must be provided when using # encoder. This parameter must be provided when using menu. #encoder_steps_per_detent: # How many steps the encoder emits per detent (\"click\"). If the # encoder takes two detents to move between entries or moves two # entries from one detent, try changing this. Allowed values are 2 # (half-stepping) or 4 (full-stepping). The default is 4. #click_pin: # The pin connected to 'enter' button or encoder 'click'. This # parameter must be provided when using menu. The presence of an # 'analog_range_click_pin' config parameter turns this parameter # from digital to analog. #back_pin: # The pin connected to 'back' button. This parameter is optional, # menu can be used without it. The presence of an # 'analog_range_back_pin' config parameter turns this parameter from # digital to analog. #up_pin: # The pin connected to 'up' button. This parameter must be provided # when using menu without encoder. The presence of an # 'analog_range_up_pin' config parameter turns this parameter from # digital to analog. #down_pin: # The pin connected to 'down' button. This parameter must be # provided when using menu without encoder. The presence of an # 'analog_range_down_pin' config parameter turns this parameter from # digital to analog. #kill_pin: # The pin connected to 'kill' button. This button will call # emergency stop. The presence of an 'analog_range_kill_pin' config # parameter turns this parameter from digital to analog. #analog_pullup_resistor: 4700 # The resistance (in ohms) of the pullup attached to the analog # button. The default is 4700 ohms. #analog_range_click_pin: # The resistance range for a 'enter' button. Range minimum and # maximum comma-separated values must be provided when using analog # button. #analog_range_back_pin: # The resistance range for a 'back' button. Range minimum and # maximum comma-separated values must be provided when using analog # button. #analog_range_up_pin: # The resistance range for a 'up' button. Range minimum and maximum # comma-separated values must be provided when using analog button. #analog_range_down_pin: # The resistance range for a 'down' button. Range minimum and # maximum comma-separated values must be provided when using analog # button. #analog_range_kill_pin: # The resistance range for a 'kill' button. Range minimum and # maximum comma-separated values must be provided when using analog # button.","title":"[display]"},{"location":"Config_Reference.html#display-hd44780","text":"Informazioni sulla configurazione dei display hd44780 (utilizzati nei display di tipo \"RepRapDiscount 2004 Smart Controller\"). [display] lcd_type: hd44780 # Set to \"hd44780\" for hd44780 displays. rs_pin: e_pin: d4_pin: d5_pin: d6_pin: d7_pin: # The pins connected to an hd44780 type lcd. These parameters must # be provided. #hd44780_protocol_init: True # Perform 8-bit/4-bit protocol initialization on an hd44780 display. # This is necessary on real hd44780 devices. However, one may need # to disable this on some \"clone\" devices. The default is True. #line_length: # Set the number of characters per line for an hd44780 type lcd. # Possible values are 20 (default) and 16. The number of lines is # fixed to 4. ...","title":"display hd44780"},{"location":"Config_Reference.html#display-hd44780_spi","text":"Informazioni sulla configurazione di un display hd44780_spi - un display 20x04 controllato tramite uno \"shift register\" hardware (che viene utilizzato nelle stampanti basate su mightyboard). [display] lcd_type: hd44780_spi # Set to \"hd44780_spi\" for hd44780_spi displays. latch_pin: spi_software_sclk_pin: spi_software_mosi_pin: spi_software_miso_pin: # The pins connected to the shift register controlling the display. # The spi_software_miso_pin needs to be set to an unused pin of the # printer mainboard as the shift register does not have a MISO pin, # but the software spi implementation requires this pin to be # configured. #hd44780_protocol_init: True # Perform 8-bit/4-bit protocol initialization on an hd44780 display. # This is necessary on real hd44780 devices. However, one may need # to disable this on some \"clone\" devices. The default is True. #line_length: # Set the number of characters per line for an hd44780 type lcd. # Possible values are 20 (default) and 16. The number of lines is # fixed to 4. ...","title":"display hd44780_spi"},{"location":"Config_Reference.html#display-st7920","text":"Informazioni sulla configurazione dei display st7920 (utilizzati nei display di tipo \"RepRapDiscount 12864 Full Graphic Smart Controller\"). [display] lcd_type: st7920 # Set to \"st7920\" for st7920 displays. cs_pin: sclk_pin: sid_pin: # The pins connected to an st7920 type lcd. These parameters must be # provided. ...","title":"display st7920"},{"location":"Config_Reference.html#display-emulazione-emulated_st7920","text":"Informazioni sulla configurazione di un display st7920 emulato, presenti in alcuni \"dispositivi touchscreen da 2,4 pollici\" e simili. [display] lcd_type: emulated_st7920 # Set to \"emulated_st7920\" for emulated_st7920 displays. en_pin: spi_software_sclk_pin: spi_software_mosi_pin: spi_software_miso_pin: # The pins connected to an emulated_st7920 type lcd. The en_pin # corresponds to the cs_pin of the st7920 type lcd, # spi_software_sclk_pin corresponds to sclk_pin and # spi_software_mosi_pin corresponds to sid_pin. The # spi_software_miso_pin needs to be set to an unused pin of the # printer mainboard as the st7920 as no MISO pin but the software # spi implementation requires this pin to be configured. ...","title":"display emulazione emulated_st7920"},{"location":"Config_Reference.html#display-uc1701","text":"Informazioni sulla configurazione dei display uc1701 (utilizzati nei display di tipo \"MKS Mini 12864\"). [display] lcd_type: uc1701 # Set to \"uc1701\" for uc1701 displays. cs_pin: a0_pin: # The pins connected to a uc1701 type lcd. These parameters must be # provided. #rst_pin: # The pin connected to the \"rst\" pin on the lcd. If it is not # specified then the hardware must have a pull-up on the # corresponding lcd line. #contrast: # The contrast to set. The value may range from 0 to 63 and the # default is 40. ...","title":"display uc1701"},{"location":"Config_Reference.html#display-ssd1306-e-sh1106","text":"Informazioni sulla configurazione dei display ssd1306 e sh1106. [display] lcd_type: # Set to either \"ssd1306\" or \"sh1106\" for the given display type. #i2c_mcu: #i2c_bus: #i2c_speed: # Optional parameters available for displays connected via an i2c # bus. See the \"common I2C settings\" section for a description of # the above parameters. #cs_pin: #dc_pin: #spi_speed: #spi_bus: #spi_software_sclk_pin: #spi_software_mosi_pin: #spi_software_miso_pin: # The pins connected to the lcd when in \"4-wire\" spi mode. See the # \"common SPI settings\" section for a description of the parameters # that start with \"spi_\". The default is to use i2c mode for the # display. #reset_pin: # A reset pin may be specified on the display. If it is not # specified then the hardware must have a pull-up on the # corresponding lcd line. #contrast: # The contrast to set. The value may range from 0 to 256 and the # default is 239. #vcomh: 0 # Set the Vcomh value on the display. This value is associated with # a \"smearing\" effect on some OLED displays. The value may range # from 0 to 63. Default is 0. #invert: False # TRUE inverts the pixels on certain OLED displays. The default is # False. #x_offset: 0 # Set the horizontal offset value on SH1106 displays. The default is # 0. ...","title":"display ssd1306 e sh1106"},{"location":"Config_Reference.html#display_data","text":"Supporto per la visualizzazione di dati personalizzati su uno schermo LCD. \u00c8 possibile creare un numero qualsiasi di gruppi di visualizzazione e un numero qualsiasi di elementi di dati in quei gruppi. Il display mostrer\u00e0 tutti gli elementi di dati per un determinato gruppo se l'opzione display_group nella sezione [display] \u00e8 impostata sul nome del gruppo specificato. Viene creato automaticamente un default set of display groups . \u00c8 possibile sostituire o estendere questi elementi display_data sovrascrivendo i valori predefiniti nel file di configurazione principale printer.cfg . [display_data my_group_name my_data_name] position: # Comma separated row and column of the display position that should # be used to display the information. This parameter must be # provided. text: # The text to show at the given position. This field is evaluated # using command templates (see docs/Command_Templates.md). This # parameter must be provided.","title":"[display_data]"},{"location":"Config_Reference.html#display_template","text":"Visualizza il testo dei dati \"macro\" (\u00e8 possibile definire un numero qualsiasi di sezioni con un prefisso display_template). Per informazioni sul template, vedere il documento template di comandi . Questa funzione consente di ridurre le definizioni ripetitive nelle sezioni display_data. Si pu\u00f2 usare la funzione incorporata render() nelle sezioni display_data per valutare un template. Per esempio, se si dovesse definire [display_template my_template] allora si potrebbe usare { render('my_template') } in una sezione display_data. Questa funzione pu\u00f2 essere utilizzata anche per aggiornamenti LED continui utilizzando il comando SET_LED_TEMPLATE . [display_template my_template_name] #param_<name>: # One may specify any number of options with a \"param_\" prefix. The # given name will be assigned the given value (parsed as a Python # literal) and will be available during macro expansion. If the # parameter is passed in the call to render() then that value will # be used during macro expansion. For example, a config with # \"param_speed = 75\" might have a caller with # \"render('my_template_name', param_speed=80)\". Parameter names may # not use upper case characters. text: # The text to return when the this template is rendered. This field # is evaluated using command templates (see # docs/Command_Templates.md). This parameter must be provided.","title":"[display_template]"},{"location":"Config_Reference.html#display_glyph","text":"Visualizza un glifo personalizzato sui display che lo supportano. Al nome dato verranno assegnati i dati di visualizzazione dati che possono quindi essere referenziati nei modelli di visualizzazione con il loro nome circondato da due simboli \"tilde\" per esempio ~my_display_glyph~ Vedere sample-glyphs.cfg per alcuni esempi. [display_glyph my_display_glyph] #data: # The display data, stored as 16 lines consisting of 16 bits (1 per # pixel) where '.' is a blank pixel and '*' is an on pixel (e.g., # \"****************\" to display a solid horizontal line). # Alternatively, one can use '0' for a blank pixel and '1' for an on # pixel. Put each display line into a separate config line. The # glyph must consist of exactly 16 lines with 16 bits each. This # parameter is optional. #hd44780_data: # Glyph to use on 20x4 hd44780 displays. The glyph must consist of # exactly 8 lines with 5 bits each. This parameter is optional. #hd44780_slot: # The hd44780 hardware index (0..7) to store the glyph at. If # multiple distinct images use the same slot then make sure to only # use one of those images in any given screen. This parameter is # required if hd44780_data is specified.","title":"[display_glyph]"},{"location":"Config_Reference.html#display-my_extra_display","text":"Se in printer.cfg \u00e8 stata definita una sezione primaria [display] come mostrato sopra, \u00e8 possibile definire pi\u00f9 display ausiliari. Si noti che i display ausiliari attualmente non supportano la funzionalit\u00e0 del menu, quindi non supportano le opzioni del \"menu\" o la configurazione dei pulsanti. [display my_extra_display] # Vedere la sezione \"display\" per i parametri disponibili.","title":"[display my_extra_display]"},{"location":"Config_Reference.html#menu","text":"Menu display lcd personalizzabili. Viene creato automaticamente un default set of menus . \u00c8 possibile sostituire o estendere il menu sovrascrivendo le impostazioni predefinite nel file di configurazione principale printer.cfg . Consulta il command template document per informazioni sugli attributi di menu disponibili durante il rendering del modello. # Common parameters available for all menu config sections. #[menu __some_list __some_name] #type: disabled # Permanently disabled menu element, only required attribute is 'type'. # Allows you to easily disable/hide existing menu items. #[menu some_name] #type: # One of command, input, list, text: # command - basic menu element with various script triggers # input - same like 'command' but has value changing capabilities. # Press will start/stop edit mode. # list - it allows for menu items to be grouped together in a # scrollable list. Add to the list by creating menu # configurations using \"some_list\" as a prefix - for # example: [menu some_list some_item_in_the_list] # vsdlist - same as 'list' but will append files from virtual sdcard # (will be removed in the future) #name: # Name of menu item - evaluated as a template. #enable: # Template that evaluates to True or False. #index: # Position where an item needs to be inserted in list. By default # the item is added at the end. #[menu some_list] #type: list #name: #enable: # See above for a description of these parameters. #[menu some_list some_command] #type: command #name: #enable: # See above for a description of these parameters. #gcode: # Script to run on button click or long click. Evaluated as a # template. #[menu some_list some_input] #type: input #name: #enable: # See above for a description of these parameters. #input: # Initial value to use when editing - evaluated as a template. # Result must be float. #input_min: # Minimum value of range - evaluated as a template. Default -99999. #input_max: # Maximum value of range - evaluated as a template. Default 99999. #input_step: # Editing step - Must be a positive integer or float value. It has # internal fast rate step. When \"(input_max - input_min) / # input_step > 100\" then fast rate step is 10 * input_step else fast # rate step is same input_step. #realtime: # This attribute accepts static boolean value. When enabled then # gcode script is run after each value change. The default is False. #gcode: # Script to run on button click, long click or value change. # Evaluated as a template. The button click will trigger the edit # mode start or end.","title":"[menu]"},{"location":"Config_Reference.html#sensori-di-filamento","text":"","title":"Sensori di filamento"},{"location":"Config_Reference.html#filament_switch_sensor","text":"Sensore del filamento a interruttore. Supporto per l'inserimento del filamento e il rilevamento dell'esaurimento tramite un sensore interruttore, come un interruttore di fine corsa. Per ulteriori informazioni, vedere command reference . [filament_switch_sensor my_sensor] #pause_on_runout: True # Se impostato su True, verr\u00e0 eseguita una PAUSA immediatamente # dopo il rilevamento di un'eccentricit\u00e0. Si noti che se pause_on_runout # \u00e8 False e runout_gcode viene omesso, il rilevamento dell'eccentricit\u00e0 # \u00e8 disabilitato. L'impostazione predefinita \u00e8 Vero. #runout_gcode: # Un elenco di comandi G-Code da eseguire dopo il rilevamento di # un'esaurimento del filamento. Vedi docs/Command_Templates.md # per il formato G-Code. Se pause_on_runout \u00e8 impostato su True, # questo codice G verr\u00e0 eseguito al termine della PAUSA. # L'impostazione predefinita \u00e8 di non eseguire alcun comando G-Code. #insert_gcode: # Un elenco di comandi G-Code da eseguire dopo il rilevamento # dell'inserimento di filamento. Vedi docs/Command_Templates.md # per il formato G-Code. L'impostazione predefinita non prevede # l'esecuzione di alcun comando G-Code, che disabilita il rilevamento # dell'inserimento. #event_delay: 3.0 # Il tempo minimo in secondi per ritardare tra gli eventi. Gli eventi # attivati durante questo periodo di tempo verranno ignorati # silenziosamente. L'impostazione predefinita \u00e8 3 secondi. #pause_delay: 0.5 # Il tempo di ritardo, in secondi, tra l'invio del comando pause e # l'esecuzione di runout_gcode. Potrebbe essere utile aumentare # questo ritardo se OctoPrint mostra uno strano comportamento # di pausa. Il valore predefinito \u00e8 0,5 secondi. #switch_pin: # Il pin su cui \u00e8 collegato l'interruttore. # Questo parametro deve essere fornito.","title":"[filament_switch_sensor]"},{"location":"Config_Reference.html#filament_motion_sensor","text":"Sensore di movimento del filamento. Supporto per l'inserimento del filamento e il rilevamento dell'esaurimento mediante un codificatore che commuta il pin di uscita durante il movimento del filamento attraverso il sensore. Per ulteriori informazioni, vedere command reference . [filament_motion_sensor my_sensor] detection_length: 7.0 # La lunghezza minima di filamento tirato attraverso il sensore # per attivare un cambio di stato su switch_pin # Il default \u00e8 7 mm. extruder: # Nome della sezione extruder section con cui questo sensore \u00e8 associato. # Questo parametro deve essere fornito. switch_pin: #pause_on_runout: #runout_gcode: #insert_gcode: #event_delay: #pause_delay: # Vedere la sezione \"filament_switch_sensor\" per la descrizione dei # parametri riportati sopra.","title":"[filament_motion_sensor]"},{"location":"Config_Reference.html#tsl1401cl_filament_width_sensor","text":"Sensore di larghezza del filamento basato su TSLl401CL. Consulta la guida per ulteriori informazioni. sl1401cl_filament_width_sensor] #pin: #diametro nominale del filamento predefinito: 1,75 (mm) # Differenza massima consentita del diametro del filamento in mm. #max_difference: 0.2 # La distanza dal sensore alla camera di fusione in mm. #measurement_delay: 100","title":"[tsl1401cl_filament_width_sensor]"},{"location":"Config_Reference.html#hall_filament_width_sensor","text":"Sensore di larghezza del filamento ad effetto Hall (vedere Sensore di larghezza del filamento Hall ). [hall_filament_width_sensor] adc1: adc2: # Pin di ingresso analogico collegati al sensore. # Questi parametri devono essere forniti. #cal_dia1: 1.50 #cal_dia2: 2.00 # I valori di calibrazione (in mm) per i sensori. Il valore predefinito # \u00e8 1.50 per cal_dia1 e 2.00 per cal_dia2. #raw_dia1: 9500 #raw_dia2: 10500 # I valori di calibrazione grezzi per i sensori. Il valore predefinito \u00e8 # 9500 per raw_dia1 e 10500 per raw_dia2. #default_nominal_filament_diameter: 1.75 # Il diametro nominale del filamento. # Questo parametro deve essere fornito. #max_difference: 0.200 # Differenza massima consentita del diametro del filamento in # millimetri (mm). Se la differenza tra il diametro nominale del # filamento e l'uscita del sensore \u00e8 maggiore di +- max_difference, # il moltiplicatore di estrusione viene riportato a %100. # Il valore predefinito \u00e8 0,200. #measurement_delay: 70 # La distanza dal sensore alla camera di fusione/hot-end in # millimetri (mm). Il filamento tra il sensore e l'hot-end verr\u00e0 # trattato come default_nominal_filament_diameter. Il modulo # host funziona con la logica FIFO. Mantiene ogni valore e posizione # del sensore in un array e li riporta nella posizione corretta. # Questo parametro deve essere fornito. #enable: False # Sensore abilitato o disabilitato dopo l'accensione. L'impostazione predefinita \u00e8 disabilitare. #measurement_interval: 10 # La distanza approssimativa (in mm) tra le letture del sensore. # Il valore predefinito \u00e8 10 mm. #logging: False # Il log esterno al terminale e klipper.log pu\u00f2 essere # attivato|off tramite comando. #min_diameter: 1.0 # Diametro minimo per trigger filament_switch_sensor virtuale. #use_current_dia_while_delay: False # Utilizzare il diametro attuale invece del diametro nominale # mentre il ritardo di misurazione non \u00e8 trascorso. #pause_on_runout: #runout_gcode: #insert_gcode: #event_delay: #pause_delay: # Vedere la sezione \"filament_switch_sensor\" per una # descrizione dei parametri di cui sopra.","title":"[hall_filament_width_sensor]"},{"location":"Config_Reference.html#supporto-hardware-per-specifica-scheda","text":"","title":"Supporto hardware per specifica scheda"},{"location":"Config_Reference.html#sx1509","text":"Configurare un'espansione SX1509 da I2C a GPIO. A causa del ritardo dovuto alla comunicazione I2C, NON utilizzare i pin SX1509 come abilitazione stepper, pin step o dir o qualsiasi altro pin che richieda un bit banging veloce. Sono utilizzati al meglio come uscite digitali statiche o controllate da gcode o pin hardware-pwm per es. fan. Si pu\u00f2 definire un numero qualsiasi di sezioni con un prefisso \"sx1509\". Ogni espansione fornisce un set di 16 pin (da sx1509_my_sx1509:PIN_0 a sx1509_my_sx1509:PIN_15) che possono essere utilizzati nella configurazione della stampante. Per un esempio, vedere il file generic-duet2-duex.cfg . [sx1509 my_sx1509] i2c_address: # Indirizzo I2C utilizzato da questa espansione. A seconda dei # ponticelli hardware \u00e8 uno dei seguenti indirizzi: 62 63 112 113. # Questo parametro deve essere fornito. #i2c_mcu: #i2c_bus: #i2c_speed: # Vedere la sezione \"impostazioni comuni I2C\" per una # escrizione dei parametri di cui sopra. #i2c_bus: # Se l'implementazione I2C del tuo microcontrollore supporta # pi\u00f9 bus I2C, puoi specificare qui il nome del bus. L'impostazione # predefinita prevede l'utilizzo del bus i2c del microcontrollore # predefinito.","title":"[sx1509]"},{"location":"Config_Reference.html#samd_sercom","text":"Configurazione SAMD SERCOM per specificare quali pin utilizzare su un determinato SERCOM. Si pu\u00f2 definire un numero qualsiasi di sezioni con un prefisso \"samd_sercom\". Ogni SERCOM deve essere configurato prima di utilizzarlo come periferica SPI o I2C. Posiziona questa sezione di configurazione sopra qualsiasi altra sezione che fa uso di bus SPI o I2C. [samd_sercom my_sercom] sercom: # Il nome del bus Sercom da configurare nel microcontrollore. I nomi # disponibili sono \"sercom0\", \"sercom1\", ecc. # Questo parametro deve essere fornito. tx_pin: # Pin MOSI per la comunicazione SPI o pin SDA (dati) per la # comunicazione I2C. Il pin deve avere una configurazione pinmux # valida per la specifica periferica SERCOM. # Questo parametro deve essere fornito. #rx_pin: # Pin MISO per la comunicazione SPI. Questo pin non viene utilizzato # per la comunicazione I2C (I2C utilizza tx_pin sia per l'invio che per la # ricezione). Il pin deve avere una configurazione pinmux valida per la # specifica periferica SERCOM. Questo parametro \u00e8 facoltativo. clk_pin: # Pin CLK per la comunicazione SPI o pin SCL (clock) per la # comunicazione I2C. Il pin deve avere una configurazione pinmux # valida per la specifica periferica SERCOM. Questo parametro deve # essere fornito.","title":"[samd_sercom]"},{"location":"Config_Reference.html#adc_scaled","text":"Scaling analogico di Duet2 Maestro tramite letture vref e vssa. La definizione di una sezione adc_scaled abilita pin adc virtuali (come \"my_name:PB0\") che vengono regolati automaticamente dai pin di monitoraggio vref e vssa della scheda. Assicurati di definire questa sezione di configurazione sopra qualsiasi sezione di configurazione che utilizza uno di questi pin virtuali. Per un esempio, vedere il file generic-duet2-maestro.cfg . [adc_scaled my_name] vref_pin: # The ADC pin to use for VREF monitoring. This parameter must be # provided. vssa_pin: # The ADC pin to use for VSSA monitoring. This parameter must be # provided. #smooth_time: 2.0 # A time value (in seconds) over which the vref and vssa # measurements will be smoothed to reduce the impact of measurement # noise. The default is 2 seconds.","title":"[adc_scaled]"},{"location":"Config_Reference.html#replicape","text":"Supporto per Replicape: vedere la guida beaglebone e il file generic-replicape.cfg per un esempio. # La sezione di configurazione \"replicape\" aggiunge i pin di abilitazione # dello stepper virtuale \"replicape: stepper_x_enable\" (per stepper X, Y, Z, # E e H) e i pin di uscita PWM \"replicape: power_x\" (per hotbed, e, h, fan0, # fan1 , fan2 e fan3) che possono quindi essere utilizzati altrove nel file # di configurazione. [replicape] revision: # La revisione dell'hardware di replicape. Attualmente \u00e8 supportata solo # la revisione \"B3\". Questo parametro deve essere fornito. #enable_pin: !gpio0_20 # Il pin di abilitazione globale dei replicape. L'impostazione predefinita # \u00e8 !gpio0_20 (aka P9_41). host_mcu: # Il nome della sezione mcu config che comunica con l'istanza mcu # \"linux process\" di Klipper. Questo parametro deve essere fornito. #standstill_power_down: False # Questo parametro controlla la linea CFG6_ENN su tutti i motori # passo-passo. True imposta le righe di abilitazione su \"open\". # L'impostazione predefinita \u00e8 Falso. #stepper_x_microstep_mode: #stepper_y_microstep_mode: #stepper_z_microstep_mode: #stepper_e_microstep_mode: #stepper_h_microstep_mode: # Questo parametro controlla i pin CFG1 e CFG2 del driver del motore # passo-passo specificato. Le opzioni disponibili sono: disabilita, 1, 2, # spread2, 4, 16, spread4, spread16, stealth4 e stealth16. L'impostazione # predefinita \u00e8 disabilitata. #stepper_x_current: #stepper_y_current: #stepper_z_current: #stepper_e_current: #stepper_h_current: # La corrente massima configurata (in Amp) del driver del motore # passo-passo. Questo parametro deve essere fornito se lo stepper non # \u00e8 in modalit\u00e0 disabilitazione. #stepper_x_chopper_off_time_high: #stepper_y_chopper_off_time_high: #stepper_z_chopper_off_time_high: #stepper_e_chopper_off_time_high: #stepper_h_chopper_off_time_high: # Questo parametro controlla il pin CFG0 del driver del motore # passo-passo (True imposta CFG0 alto, False lo imposta basso). # L'impostazione predefinita \u00e8 False. #stepper_x_chopper_hysteresis_high: #stepper_y_chopper_hysteresis_high: #stepper_z_chopper_hysteresis_high: #stepper_e_chopper_hysteresis_high: #stepper_h_chopper_hysteresis_high: # Questo parametro controlla il pin CFG4 del driver del motore # passo-passo (True imposta CFG4 alto, False lo imposta basso). # L'impostazione predefinita \u00e8 False. #stepper_x_chopper_blank_time_high: #stepper_y_chopper_blank_time_high: #stepper_z_chopper_blank_time_high: #stepper_e_chopper_blank_time_high: #stepper_h_chopper_blank_time_high: # Questo parametro controlla il pin CFG5 del driver del motore # passo-passo (True imposta CFG5 alto, False lo imposta basso). # L'impostazione predefinita \u00e8 True.","title":"[replicape]"},{"location":"Config_Reference.html#altri-moduli-personalizzati","text":"","title":"Altri moduli personalizzati"},{"location":"Config_Reference.html#palette2","text":"Supporto multimateriale Palette 2: fornisce un'integrazione pi\u00f9 stretta supportando i dispositivi Palette 2 in modalit\u00e0 connessa. Questo modulo richiede anche [virtual_sdcard] e [pause_resume] per la piena funzionalit\u00e0. Se si utilizza questo modulo, non utilizzare il plug-in Palette 2 per Octoprint poich\u00e9 entreranno in conflitto e 1 non si inizializzer\u00e0 correttamente, probabilmente interrompendo la stampa. Se utilizzi Octoprint e esegui lo streaming di gcode sulla porta seriale invece di stampare da virtual_sd, rimuovere M1 e M0 da Pausa dei comandi in Impostazioni > Connessione seriale > Firmware e protocollo eviter\u00e0 la necessit\u00e0 per avviare la stampa sulla tavolozza 2 e riattivare la pausa in Octoprint per avviare la stampa. [palette2] serial: # La porta seriale per la connessione alla Palette 2. #baud: 115200 # La velocit\u00e0 da utilizzare. Il valore predefinito \u00e8 115200. #feedrate_splice: 0.8 # L'avanzamento da utilizzare durante la giunzione # il valore predefinito \u00e8 0.8 #feedrate_normal: 1.0 # L'avanzamento da utilizzare dopo la giunzione # il valore predefinito \u00e8 1.0 #auto_load_speed: 2 # Avanzamento di estrusione durante il caricamento automatico # il valore predefinito \u00e8 2 (mm/s) #auto_cancel_variation: 0.1 # Annullamento automatico della stampa quando la variazione # del ping \u00e8 superiore a questa soglia","title":"[palette2]"},{"location":"Config_Reference.html#angle","text":"Supporto per sensore magnetico Hall per la lettura delle misurazioni dell'angolo del motore passo-passo utilizzando i chip SPI a1333, as5047d o tle5012b. Le misurazioni sono disponibili tramite Server API e strumento di analisi del movimento . Vedere il Riferimento G-Code per i comandi disponibili. [angle my_angle_sensor] sensor_type: # The type of the magnetic hall sensor chip. Available choices are # \"a1333\", \"as5047d\", and \"tle5012b\". This parameter must be # specified. #sample_period: 0.000400 # The query period (in seconds) to use during measurements. The # default is 0.000400 (which is 2500 samples per second). #stepper: # The name of the stepper that the angle sensor is attached to (eg, # \"stepper_x\"). Setting this value enables an angle calibration # tool. To use this feature, the Python \"numpy\" package must be # installed. The default is to not enable angle calibration for the # angle sensor. cs_pin: # The SPI enable pin for the sensor. This parameter must be provided. #spi_speed: #spi_bus: #spi_software_sclk_pin: #spi_software_mosi_pin: #spi_software_miso_pin: # See the \"common SPI settings\" section for a description of the # above parameters.","title":"[angle]"},{"location":"Config_Reference.html#parametri-bus-comuni","text":"","title":"Parametri bus comuni"},{"location":"Config_Reference.html#impostazioni-spi-comuni","text":"I seguenti parametri sono generalmente disponibili per i dispositivi che utilizzano un bus SPI. #spi_speed: # La velocit\u00e0 SPI (in Hz) da utilizzare durante la comunicazione con il # dispositivo. L'impostazione predefinita dipende dal tipo di dispositivo. #spi_bus: # Se il microcontrollore supporta pi\u00f9 bus SPI, \u00e8 possibile specificare # qui il nome del bus del microcontrollore. L'impostazione predefinita # dipende dal tipo di microcontrollore. #spi_software_sclk_pin: #spi_software_mosi_pin: #spi_software_miso_pin: # Specificare i parametri di cui sopra per utilizzare \"SPI basato su # software\". Questa modalit\u00e0 non richiede il supporto hardware del # microcontrollore (in genere \u00e8 possibile utilizzare qualsiasi pin generico). # L'impostazione predefinita \u00e8 di non utilizzare \"spi software\".","title":"Impostazioni SPI comuni"},{"location":"Config_Reference.html#impostazioni-i2c-comuni","text":"I seguenti parametri sono generalmente disponibili per i dispositivi che utilizzano un bus I2C. Si noti che l'attuale supporto del microcontrollore di Klipper per i2c generalmente non tollera il rumore di linea. Errori imprevisti sui cavi i2c possono causare la generazione di un errore di runtime da parte di Klipper. Il supporto di Klipper per il ripristino degli errori varia a seconda del tipo di microcontrollore. In genere si consiglia di utilizzare solo dispositivi i2c che si trovano sulla stessa scheda a circuito stampato del microcontrollore. La maggior parte delle implementazioni del microcontrollore Klipper supporta solo un i2c_speed di 100000. Il microcontrollore \"linux\" Klipper supporta una velocit\u00e0 400000, ma deve essere impostato nel sistema operativo e il parametro i2c_speed viene altrimenti ignorato. Il microcontrollore Klipper \"rp2040\" supporta una velocit\u00e0 di 400000 tramite il parametro i2c_speed . Tutti gli altri microcontrollori Klipper utilizzano una frequenza di 100000 e ignorano il parametro i2c_speed . #i2c_address: # L'indirizzo i2c del dispositivo. Questo deve essere specificato # come numero decimale (non in esadecimale). L'impostazione # predefinita dipende dal tipo di dispositivo. #i2c_mcu: # Il nome del microcontrollore a cui \u00e8 collegato il chip. # L'impostazione predefinita \u00e8 \"mcu\". #i2c_bus: # Se il microcontrollore supporta pi\u00f9 bus I2C, \u00e8 possibile # specificare qui il nome del bus del microcontrollore. # L'impostazione predefinita dipende dal tipo di microcontrollore. #i2c_speed: # La velocit\u00e0 I2C (in Hz) da utilizzare durante la comunicazione # con il dispositivo. L'implementazione di Klipper sulla maggior # parte dei microcontrollori \u00e8 codificata a 100000 e la modifica # di questo valore non ha alcun effetto. # Il valore predefinito \u00e8 100000.","title":"Impostazioni I2C comuni"},{"location":"Config_checks.html","text":"Controlli della configurazione \u00b6 Questo documento fornisce una lista di step per confermare le impostazioni dei pin nel file printer.cfg di Klipper. \u00c8 una buona idea eseguire questi passi dopo aver seguito i passi nel documento di installazione . In alcuni passaggi di questa guida, potrebbe essere necessario modificare il file di configurazione di Klipper. Assicuratevi di dare il comando RESTART, dopo ogni modifica al file di configurazione, per accertarsi che le modifiche abbiano effetto(scrivere \"restart\" nella scheda del terminale di Octoprint e cliccare su INVIA). E' anche consigliabile utilizzare il comando STATUS, dopo ogni RESTART, per verificare che il file di configurazione sia stato caricato correttamente. Verifica delle temperature \u00b6 Iniziare verificando che le temperature siano correttamente riportate. Navigare alla scheda temperature di Octoprint. eseguire l'istruzione Verificare che la temperatura dell'ugello e del piatto(se presente) siano presenti e non stiano aumentando. Se stessero aumentando staccare l'alimentazione alla stampante. Se le temperature non sono precise, rivedere le impostazioni \"sensor_type\" e \"sensor_pin\" per l'ugello e/o il piatto. Verifica M112 \u00b6 Da terminale dare il comando M112. Questo comando richiede a Klipper di porsi in uno stato di spengnimento. Questo causer\u00e0 la disconnessione di Octoprint da Klipper - selezionate il menu connessione e premete il pulsante \"Connetti\" per riconnettere Octoprint. Selezionate poi la scheda temperatura e verificate che le temperature si stiano aggiornando e che non stiano aumentando. Se stanno aumentando, staccate l'alimentazione della stampante. Il comando M112 mette Klipper in uno stato di spegnimento. Per farlo uscire da questo stato, dare il comando FIRMWARE_RESTART sempre da terminale di Octoprint. Verifica i riscaldatori \u00b6 Passare alla pagina della temperatura su Octoprint . Nella casella della temperatura \"Tool\", digitare 50 seguito dal tasto enter .La temperatura dell'estrusore indicata nel grafico, dovrebbe iniziare ad aumentare (entro 30 secondi circa). Quindi vai alla casella a scorrimento della temperatura \"Tool\" e seleziona \"Off\". Dopo alcuni minuti la temperatura dovrebbe tornare al valore di temperatura ambiente iniziale. Se la temperatura non aumenta, verifica l'impostazione \"heater_pin\" nella configurazione. Se la stampante ha il piatto riscaldato, eseguire nuovamente il test indicato in precedenza ma per il piatto. Verifica il pin di abilitazione del motore passo-passo \u00b6 Verificare che tutti gli assi della stampante possano muoversi manualmente in modo libero (con i motori passo-passo sono disabilitati). In caso contrario, inserire un comando M84 per disabilitare i motori. Se uno degli assi non pu\u00f2 ancora muoversi in modo libero, verificare la configurazione \"enable_pin\" del driver del motore passo-passo corrispondente. Sulla maggior parte dei driver per motori passo-passo, il pin di abilitazione del motore \u00e8 \"attivo basso\" e quindi il pin di abilitazione dovrebbe avere un \"!\" prima del pin (ad esempio, \"enable_pin: !ar38\"). Verifica i finecorsa \u00b6 Spostare manualmente tutti gli assi della stampante in modo che nessuno di essi sia a contatto con un finecorsa. Invia un comando QUERY_ENDSTOPS tramite il terminale di Octoprint. Dovrebbe visualizzare lo stato corrente di tutti i finecorsa configurati e gli stessi dovrebbero essere nello stato di \"aperto\". Per ciascuno degli finecorsa, eseguire nuovamente il comando QUERY_ENDSTOPS mentre si attiva manualmente il finecorsa corrispondente, dovrebbe rispondere con \"TRIGGERED\". Se il finecorsa \u00e8 invertito (viene indicato \"aperto\" quando \u00e8 attivato e viceversa), aggiungere un \"!\" alla definizione del pin (ad esempio, \"endstop_pin: ^!ar3\"), oppure togliere \"!\" se invece \u00e8 presente. Se il segnale del finecorsa non cambia , pu\u00f2 significare che il fine corsa \u00e8 collegato a un pin diverso. Tuttavia, potrebbe essere necessaria una modifica all'impostazione pullup del pin (il '^' all'inizio del istruzione \"endstop_pin\".La maggior parte delle stampanti utilizzano un resistore pullup e l'istruzione '^' dovrebbe essere presente). Verifica dei motori passo-passo \u00b6 Utilizzare il comando STEPPER_BUZZ per verificare le connessioni di ciascun motore passo-passo. Inizia posizionando manualmente in un punto intermedio dell'asse, quindi esegui l'istruzione STEPPER_BUZZ STEPPER=stepper_x . Il comando STEPPER_BUZZ far\u00e0 muovere il motore passo-passo di un millimetro in direzione avanti e poi torner\u00e0 in posizione iniziale. (Se il finecorsa \u00e8 definito come position_endstop=0, all'inizio di ogni movimento lo motore passo-passo si allontaner\u00e0 dal finecorsa.) Eseguir\u00e0 questa movimento oscillatorio per dieci volte. Se il motore passo-passo non si muove , verifica le impostazioni \"enable_pin\" e \"step_pin\" sul driver. Se il motore passo-passo si muove ma non torna nella sua posizione originale, verificare l'impostazione \"dir_pin\". Se il motore passo-passo oscilla in una direzione errata, generalmente sta a significare che \u00e8 necessario invertire il \"dir_pin\" del l'asse. Questo viene fatto aggiungendo un istruzione '!' alla \"dir_pin\" nel file di configurazione della stampante (o rimuovendolo se ne esiste gi\u00e0 presente). Se il motore passo-passo si muove di pi\u00f9 o di meno di un millimetro, verificare l'impostazione \"rotation_distance\". Eseguire il test sopra descritto per ogni motore passo-passo definito nel file di configurazione. (Impostare il parametro STEPPER del comando STEPPER_BUZZ sul nome della sezione di configurazione da testare.) Se non \u00e8 presente il filamento nell'estrusore, \u00e8 possibile utilizzare STEPPER_BUZZ per verificare la connessione del motore dell'estrusore (usare STEPPER=estrusore). In caso contrario, \u00e8 meglio testare il motore dell'estrusore per conto suo (vedere la sezione successiva). Dopo aver verificato tutti i finecorsa e aver verificato tutti i motori passo-passo, \u00e8 necessario testare il sistema di homing. Scrivere un comando G28 per portare a home tutti gli assi. Rimuovere l'alimentazione dalla stampante se l'istruzione non funziona correttamente. Se necessario, ripetere i passaggi di verifica del finecorsa e del motore passo-passo. Verifica il motore dell'estrusore \u00b6 Per testare il motore dell'estrusore sar\u00e0 necessario riscaldare l'estrusore alla temperatura di stampa. Passare alla pagina della temperatura Octoprint e selezionare una temperatura di target nel men\u00f9 a tendina della temperatura (o inserire manualmente una temperatura opportuna). Attendere che la stampante raggiunga la temperatura desiderata. Quindi vai alla pagina di controllo di Octoprint e fai clic sul pulsante \"Estrudi\". Verificare che il motore dell'estrusore giri nella direzione corretta. In caso contrario, vedere i suggerimenti per la risoluzione dei problemi nella sezione precedente per verificare le impostazioni \"enable_pin\", \"step_pin\" e \"dir_pin\" per l'estrusore. Calibrare le impostazioni del PID \u00b6 Klipper supporta il sistema controllo PID per iriscaldatori dell'estrusore e del piatto. Per utilizzare questo sistema di controllo, \u00e8 necessario calibrare le impostazioni PID su ciascuna stampante (le impostazioni PID presenti in altri firmware o nei file di configurazione di esempio spesso funzionano male). Per calibrare il PID dell'estrusore, accedere alla pagina del terminale OctoPrint ed eseguire il comando PID_CALIBRATE. Ad esempio: PID_CALIBRATE HEATER=estrusore TARGET=170 Al termine del test di ottimizzazione, eseguire l'istruzione SAVE_CONFIG per aggiornare il file printer.cfg con le nuove impostazioni PID. Se la stampante ha un piatto riscaldato ed \u00e8 dotato di azionamento con funzione PWM (Pulse Width Modulation), si consiglia di utilizzare il controllo PID anche per il piatto. (Quando il riscaldatore del piatto \u00e8 controllato utilizzando l'algoritmo PID, potrebbe accendersi e spegnersi dieci volte al secondo, il che potrebbe non essere adatto per i riscaldatori che utilizzano un rel\u00e8 elettromeccanico.) Un tipico comando per calibrazione PID del piatto \u00e8: PID_CALIBRATE HEATER=heater_bed TARGET= 60 Passi sucessivi \u00b6 Questa guida ha lo scopo di aiutare la verifica delle impostazioni di base riferite ai pin presenti nel file di configurazione di Klipper. Assicurati di leggere la guida bed leveling . Consulta anche il documento Slicers per informazioni sulla configurazione di un software slicer con Klipper. Dopo aver verificato che la stampa di base funziona, \u00e8 una buona prassi procedere con la calibrazione avanzamento pressione . Potrebbe essere necessario eseguire altri tipi di calibrazione di dettaglio in riferimento alla stampante: sono disponibili numerose guide online per questo scopo (ad esempio, eseguire una ricerca sul Web per \"calibrazione della stampante 3d\"). Ad esempio, se si verifica l'effetto chiamato risonanza, \u00e8 possibile provare a seguire la calibrazione tramite l'istruzione compensazione della risonanza .","title":"Controlli della configurazione"},{"location":"Config_checks.html#controlli-della-configurazione","text":"Questo documento fornisce una lista di step per confermare le impostazioni dei pin nel file printer.cfg di Klipper. \u00c8 una buona idea eseguire questi passi dopo aver seguito i passi nel documento di installazione . In alcuni passaggi di questa guida, potrebbe essere necessario modificare il file di configurazione di Klipper. Assicuratevi di dare il comando RESTART, dopo ogni modifica al file di configurazione, per accertarsi che le modifiche abbiano effetto(scrivere \"restart\" nella scheda del terminale di Octoprint e cliccare su INVIA). E' anche consigliabile utilizzare il comando STATUS, dopo ogni RESTART, per verificare che il file di configurazione sia stato caricato correttamente.","title":"Controlli della configurazione"},{"location":"Config_checks.html#verifica-delle-temperature","text":"Iniziare verificando che le temperature siano correttamente riportate. Navigare alla scheda temperature di Octoprint. eseguire l'istruzione Verificare che la temperatura dell'ugello e del piatto(se presente) siano presenti e non stiano aumentando. Se stessero aumentando staccare l'alimentazione alla stampante. Se le temperature non sono precise, rivedere le impostazioni \"sensor_type\" e \"sensor_pin\" per l'ugello e/o il piatto.","title":"Verifica delle temperature"},{"location":"Config_checks.html#verifica-m112","text":"Da terminale dare il comando M112. Questo comando richiede a Klipper di porsi in uno stato di spengnimento. Questo causer\u00e0 la disconnessione di Octoprint da Klipper - selezionate il menu connessione e premete il pulsante \"Connetti\" per riconnettere Octoprint. Selezionate poi la scheda temperatura e verificate che le temperature si stiano aggiornando e che non stiano aumentando. Se stanno aumentando, staccate l'alimentazione della stampante. Il comando M112 mette Klipper in uno stato di spegnimento. Per farlo uscire da questo stato, dare il comando FIRMWARE_RESTART sempre da terminale di Octoprint.","title":"Verifica M112"},{"location":"Config_checks.html#verifica-i-riscaldatori","text":"Passare alla pagina della temperatura su Octoprint . Nella casella della temperatura \"Tool\", digitare 50 seguito dal tasto enter .La temperatura dell'estrusore indicata nel grafico, dovrebbe iniziare ad aumentare (entro 30 secondi circa). Quindi vai alla casella a scorrimento della temperatura \"Tool\" e seleziona \"Off\". Dopo alcuni minuti la temperatura dovrebbe tornare al valore di temperatura ambiente iniziale. Se la temperatura non aumenta, verifica l'impostazione \"heater_pin\" nella configurazione. Se la stampante ha il piatto riscaldato, eseguire nuovamente il test indicato in precedenza ma per il piatto.","title":"Verifica i riscaldatori"},{"location":"Config_checks.html#verifica-il-pin-di-abilitazione-del-motore-passo-passo","text":"Verificare che tutti gli assi della stampante possano muoversi manualmente in modo libero (con i motori passo-passo sono disabilitati). In caso contrario, inserire un comando M84 per disabilitare i motori. Se uno degli assi non pu\u00f2 ancora muoversi in modo libero, verificare la configurazione \"enable_pin\" del driver del motore passo-passo corrispondente. Sulla maggior parte dei driver per motori passo-passo, il pin di abilitazione del motore \u00e8 \"attivo basso\" e quindi il pin di abilitazione dovrebbe avere un \"!\" prima del pin (ad esempio, \"enable_pin: !ar38\").","title":"Verifica il pin di abilitazione del motore passo-passo"},{"location":"Config_checks.html#verifica-i-finecorsa","text":"Spostare manualmente tutti gli assi della stampante in modo che nessuno di essi sia a contatto con un finecorsa. Invia un comando QUERY_ENDSTOPS tramite il terminale di Octoprint. Dovrebbe visualizzare lo stato corrente di tutti i finecorsa configurati e gli stessi dovrebbero essere nello stato di \"aperto\". Per ciascuno degli finecorsa, eseguire nuovamente il comando QUERY_ENDSTOPS mentre si attiva manualmente il finecorsa corrispondente, dovrebbe rispondere con \"TRIGGERED\". Se il finecorsa \u00e8 invertito (viene indicato \"aperto\" quando \u00e8 attivato e viceversa), aggiungere un \"!\" alla definizione del pin (ad esempio, \"endstop_pin: ^!ar3\"), oppure togliere \"!\" se invece \u00e8 presente. Se il segnale del finecorsa non cambia , pu\u00f2 significare che il fine corsa \u00e8 collegato a un pin diverso. Tuttavia, potrebbe essere necessaria una modifica all'impostazione pullup del pin (il '^' all'inizio del istruzione \"endstop_pin\".La maggior parte delle stampanti utilizzano un resistore pullup e l'istruzione '^' dovrebbe essere presente).","title":"Verifica i finecorsa"},{"location":"Config_checks.html#verifica-dei-motori-passo-passo","text":"Utilizzare il comando STEPPER_BUZZ per verificare le connessioni di ciascun motore passo-passo. Inizia posizionando manualmente in un punto intermedio dell'asse, quindi esegui l'istruzione STEPPER_BUZZ STEPPER=stepper_x . Il comando STEPPER_BUZZ far\u00e0 muovere il motore passo-passo di un millimetro in direzione avanti e poi torner\u00e0 in posizione iniziale. (Se il finecorsa \u00e8 definito come position_endstop=0, all'inizio di ogni movimento lo motore passo-passo si allontaner\u00e0 dal finecorsa.) Eseguir\u00e0 questa movimento oscillatorio per dieci volte. Se il motore passo-passo non si muove , verifica le impostazioni \"enable_pin\" e \"step_pin\" sul driver. Se il motore passo-passo si muove ma non torna nella sua posizione originale, verificare l'impostazione \"dir_pin\". Se il motore passo-passo oscilla in una direzione errata, generalmente sta a significare che \u00e8 necessario invertire il \"dir_pin\" del l'asse. Questo viene fatto aggiungendo un istruzione '!' alla \"dir_pin\" nel file di configurazione della stampante (o rimuovendolo se ne esiste gi\u00e0 presente). Se il motore passo-passo si muove di pi\u00f9 o di meno di un millimetro, verificare l'impostazione \"rotation_distance\". Eseguire il test sopra descritto per ogni motore passo-passo definito nel file di configurazione. (Impostare il parametro STEPPER del comando STEPPER_BUZZ sul nome della sezione di configurazione da testare.) Se non \u00e8 presente il filamento nell'estrusore, \u00e8 possibile utilizzare STEPPER_BUZZ per verificare la connessione del motore dell'estrusore (usare STEPPER=estrusore). In caso contrario, \u00e8 meglio testare il motore dell'estrusore per conto suo (vedere la sezione successiva). Dopo aver verificato tutti i finecorsa e aver verificato tutti i motori passo-passo, \u00e8 necessario testare il sistema di homing. Scrivere un comando G28 per portare a home tutti gli assi. Rimuovere l'alimentazione dalla stampante se l'istruzione non funziona correttamente. Se necessario, ripetere i passaggi di verifica del finecorsa e del motore passo-passo.","title":"Verifica dei motori passo-passo"},{"location":"Config_checks.html#verifica-il-motore-dellestrusore","text":"Per testare il motore dell'estrusore sar\u00e0 necessario riscaldare l'estrusore alla temperatura di stampa. Passare alla pagina della temperatura Octoprint e selezionare una temperatura di target nel men\u00f9 a tendina della temperatura (o inserire manualmente una temperatura opportuna). Attendere che la stampante raggiunga la temperatura desiderata. Quindi vai alla pagina di controllo di Octoprint e fai clic sul pulsante \"Estrudi\". Verificare che il motore dell'estrusore giri nella direzione corretta. In caso contrario, vedere i suggerimenti per la risoluzione dei problemi nella sezione precedente per verificare le impostazioni \"enable_pin\", \"step_pin\" e \"dir_pin\" per l'estrusore.","title":"Verifica il motore dell'estrusore"},{"location":"Config_checks.html#calibrare-le-impostazioni-del-pid","text":"Klipper supporta il sistema controllo PID per iriscaldatori dell'estrusore e del piatto. Per utilizzare questo sistema di controllo, \u00e8 necessario calibrare le impostazioni PID su ciascuna stampante (le impostazioni PID presenti in altri firmware o nei file di configurazione di esempio spesso funzionano male). Per calibrare il PID dell'estrusore, accedere alla pagina del terminale OctoPrint ed eseguire il comando PID_CALIBRATE. Ad esempio: PID_CALIBRATE HEATER=estrusore TARGET=170 Al termine del test di ottimizzazione, eseguire l'istruzione SAVE_CONFIG per aggiornare il file printer.cfg con le nuove impostazioni PID. Se la stampante ha un piatto riscaldato ed \u00e8 dotato di azionamento con funzione PWM (Pulse Width Modulation), si consiglia di utilizzare il controllo PID anche per il piatto. (Quando il riscaldatore del piatto \u00e8 controllato utilizzando l'algoritmo PID, potrebbe accendersi e spegnersi dieci volte al secondo, il che potrebbe non essere adatto per i riscaldatori che utilizzano un rel\u00e8 elettromeccanico.) Un tipico comando per calibrazione PID del piatto \u00e8: PID_CALIBRATE HEATER=heater_bed TARGET= 60","title":"Calibrare le impostazioni del PID"},{"location":"Config_checks.html#passi-sucessivi","text":"Questa guida ha lo scopo di aiutare la verifica delle impostazioni di base riferite ai pin presenti nel file di configurazione di Klipper. Assicurati di leggere la guida bed leveling . Consulta anche il documento Slicers per informazioni sulla configurazione di un software slicer con Klipper. Dopo aver verificato che la stampa di base funziona, \u00e8 una buona prassi procedere con la calibrazione avanzamento pressione . Potrebbe essere necessario eseguire altri tipi di calibrazione di dettaglio in riferimento alla stampante: sono disponibili numerose guide online per questo scopo (ad esempio, eseguire una ricerca sul Web per \"calibrazione della stampante 3d\"). Ad esempio, se si verifica l'effetto chiamato risonanza, \u00e8 possibile provare a seguire la calibrazione tramite l'istruzione compensazione della risonanza .","title":"Passi sucessivi"},{"location":"Contact.html","text":"Contatti \u00b6 Questo documento fornisce informazioni di contatto per Klipper. Forum della comunit\u00e0 Chat Discord Ho una domanda su Klipper Ho una richiesta per una funzionalit\u00e0 Aiuto! Non funziona! I found a bug in the Klipper software Sto apportando modifiche che vorrei includere in Klipper Klipper github Forum della Comunit\u00e0 \u00b6 C'\u00e8 un server Klipper Community Discourse server per discussioni su Klipper. Chat Discord \u00b6 C'\u00e8 un serve Discord dedicato a Klipper a: https://discord.klipper3d.org . Questo server \u00e8 gestito da una comunit\u00e0 di appassionati di Klipper dediti alle discussioni su Klipper. Consente agli utenti di chattare con altri utenti in tempo reale. Ho una domanda su Klipper \u00b6 Molte domande che riceviamo hanno gi\u00e0 una risposta nella Klipper documentation . Per favore assicurati di leggere la documentazione e di seguire le indicazioni fornite. \u00c8 anche possibile cercare domande simili nel Klipper Community Forum . Se sei interessato a condividere le tue conoscenze ed esperienze con altri utenti di Klipper, puoi unirti al Klipper Community Forum o Klipper Discord Chat . Entrambe sono comunit\u00e0 in cui gli utenti di Klipper possono discutere di Klipper con altri utenti. Molte domande che riceviamo sono domande generiche sulla stampa 3D che non sono specifiche di Klipper. Se hai una domanda generica o stai riscontrando problemi di stampa generici, probabilmente otterrai una risposta migliore chiedendo in un forum generale sulla stampa 3D o in un forum dedicato all'hardware della tua stampante. Ho una richiesta per una funzionalit\u00e0 \u00b6 Tutte le nuove funzionalit\u00e0 richiedono qualcuno interessato e in grado di implementare tale funzionalit\u00e0. Se sei interessato ad aiutare a implementare o testare una nuova funzionalit\u00e0, puoi cercare gli sviluppi coinvolti nel Klipper Community Forum . C'\u00e8 anche Klipper Discord Chat per le discussioni tra i collaboratori. Aiuto! Non funziona! \u00b6 Sfortunatamente, riceviamo molte pi\u00f9 richieste di aiuto di quante potremmo eventualmente rispondere. La maggior parte delle segnalazioni di problemi che vediamo vengono infine rintracciate in: Piccoli nell'hardware, o Non seguendo tutti i passaggi descritti nella documentazione di Klipper. In caso di problemi, ti consigliamo di leggere attentamente la Klipper documentation e di verificare che tutti i passaggi siano stati seguiti. Se si verifica un problema di stampa, si consiglia di ispezionare attentamente l'hardware della stampante (tutti i giunti, i cavi, le viti, ecc.) e verificare che non vi siano anomalie. Scopriamo che la maggior parte dei problemi di stampa non sono correlati al software Klipper. Se trovi un problema con l'hardware della stampante, probabilmente otterrai una risposta migliore cercando in un forum generale di stampa 3D o in un forum dedicato all'hardware della tua stampante. \u00c8 anche possibile cercare problemi simili in Klipper Community Forum . Se sei interessato a condividere le tue conoscenze ed esperienze con altri utenti di Klipper, puoi unirti al Klipper Community Forum o Klipper Discord Chat . Entrambe sono comunit\u00e0 in cui gli utenti di Klipper possono discutere di Klipper con altri utenti. Ho trovato un bug nel software Klipper \u00b6 Klipper \u00e8 un progetto open-source ed apprezziamo quando i collaboratori diagnosticano errori nel software. I problemi devono essere segnalati nel Klipper Community Forum . Ci sono informazioni importanti che saranno necessarie per correggere un bug. Per favore segui questi passaggi: Assicurati di eseguire codice non modificato da https://github.com/Klipper3d/klipper . Se il codice \u00e8 stato modificato o \u00e8 stato ottenuto da un'altra fonte, \u00e8 necessario riprodurre il problema sul codice non modificato da https://github.com/Klipper3d/klipper prima della segnalazione. Se possibile, eseguire un comando M112 immediatamente dopo che si \u00e8 verificato l'evento indesiderato. Ci\u00f2 fa s\u00ec che Klipper entri in uno \"shutdown state\" e causer\u00e0 la scrittura di ulteriori informazioni di debug nel file di registro. Ottieni il log file di Klipper dell'evento. Il file di registro \u00e8 stato progettato per rispondere alle domande pi\u00f9 comuni degli sviluppatori di Klipper sul software e sul suo ambiente (versione del software, tipo di hardware, configurazione, tempistica degli eventi e centinaia di altre domande). Il log file di Klipper si trova in /tmp/klippy.log sul computer \"host\" di Klipper (il Raspberry Pi). Un comando o utility \"scp\" o \"sftp\" \u00e8 necessario per copiare questo file di registro sul computer desktop. L'utilit\u00e0 \"scp\" viene fornita di serie con i desktop Linux e MacOS. Ci sono utilit\u00e0 scp disponibili gratuitamente per altri desktop (ad es. WinSCP). Se si utilizza un'interfaccia grafica scp che non pu\u00f2 copiare direttamente /tmp/klippy.log , fare clic ripetutamente su .. o cartella principale fino ad arrivare alla directory principale, fare clic sulla cartella tmp , quindi seleziona il file klippy.log . Copia il lof file sul desktop in modo che possa essere allegato a una segnalazione di problema. Non modificare in alcun modo il log file; non editare o ritagliare il log file. Solo il file di log completo non modificato fornisce le informazioni necessarie. \u00c8 una buona idea comprimere il file di registro con zip o gzip. Apri un nuovo topic sul Klipper Community Forum e fornisci una descrizione chiara del problema. Altri contributori di Klipper dovranno capire quali passi sono stati compiuti, quale era il risultato desiderato e quale risultato si \u00e8 effettivamente verificato. Il file di registro compresso di Klipper dovrebbe essere allegato a quel topic. Sto apportando modifiche che vorrei includere in Klipper \u00b6 Klipper \u00e8 un software open-source e apprezziamo i nuovi contributi. I nuovi contributi (sia per il codice che per la documentazione) vengono inviati tramite Github Pull Requests. Vedere [ CONTRIBUTING document per informazioni importanti. Ci sono diversi documenti per sviluppatori . Se hai domande sul codice, puoi anche chiedere nel Klipper Community Forum o nella Klipper Community Discord . Klipper github \u00b6 Klipper github pu\u00f2 essere utilizzato dai contributori per condividere lo stato del loro lavoro per migliorare Klipper. Ci si aspetta che la persona che apre un ticket github stia lavorando attivamente all'attivit\u00e0 specificata e sar\u00e0 quella che eseguir\u00e0 tutto il lavoro necessario per realizzarla. Il github di Klipper non viene utilizzato per richieste, n\u00e9 per segnalare bug, n\u00e9 per porre domande. Usa invece il Klipper Community Forum o la Klipper Community Discord .","title":"Contatti"},{"location":"Contact.html#contatti","text":"Questo documento fornisce informazioni di contatto per Klipper. Forum della comunit\u00e0 Chat Discord Ho una domanda su Klipper Ho una richiesta per una funzionalit\u00e0 Aiuto! Non funziona! I found a bug in the Klipper software Sto apportando modifiche che vorrei includere in Klipper Klipper github","title":"Contatti"},{"location":"Contact.html#forum-della-comunita","text":"C'\u00e8 un server Klipper Community Discourse server per discussioni su Klipper.","title":"Forum della Comunit\u00e0"},{"location":"Contact.html#chat-discord","text":"C'\u00e8 un serve Discord dedicato a Klipper a: https://discord.klipper3d.org . Questo server \u00e8 gestito da una comunit\u00e0 di appassionati di Klipper dediti alle discussioni su Klipper. Consente agli utenti di chattare con altri utenti in tempo reale.","title":"Chat Discord"},{"location":"Contact.html#ho-una-domanda-su-klipper","text":"Molte domande che riceviamo hanno gi\u00e0 una risposta nella Klipper documentation . Per favore assicurati di leggere la documentazione e di seguire le indicazioni fornite. \u00c8 anche possibile cercare domande simili nel Klipper Community Forum . Se sei interessato a condividere le tue conoscenze ed esperienze con altri utenti di Klipper, puoi unirti al Klipper Community Forum o Klipper Discord Chat . Entrambe sono comunit\u00e0 in cui gli utenti di Klipper possono discutere di Klipper con altri utenti. Molte domande che riceviamo sono domande generiche sulla stampa 3D che non sono specifiche di Klipper. Se hai una domanda generica o stai riscontrando problemi di stampa generici, probabilmente otterrai una risposta migliore chiedendo in un forum generale sulla stampa 3D o in un forum dedicato all'hardware della tua stampante.","title":"Ho una domanda su Klipper"},{"location":"Contact.html#ho-una-richiesta-per-una-funzionalita","text":"Tutte le nuove funzionalit\u00e0 richiedono qualcuno interessato e in grado di implementare tale funzionalit\u00e0. Se sei interessato ad aiutare a implementare o testare una nuova funzionalit\u00e0, puoi cercare gli sviluppi coinvolti nel Klipper Community Forum . C'\u00e8 anche Klipper Discord Chat per le discussioni tra i collaboratori.","title":"Ho una richiesta per una funzionalit\u00e0"},{"location":"Contact.html#aiuto-non-funziona","text":"Sfortunatamente, riceviamo molte pi\u00f9 richieste di aiuto di quante potremmo eventualmente rispondere. La maggior parte delle segnalazioni di problemi che vediamo vengono infine rintracciate in: Piccoli nell'hardware, o Non seguendo tutti i passaggi descritti nella documentazione di Klipper. In caso di problemi, ti consigliamo di leggere attentamente la Klipper documentation e di verificare che tutti i passaggi siano stati seguiti. Se si verifica un problema di stampa, si consiglia di ispezionare attentamente l'hardware della stampante (tutti i giunti, i cavi, le viti, ecc.) e verificare che non vi siano anomalie. Scopriamo che la maggior parte dei problemi di stampa non sono correlati al software Klipper. Se trovi un problema con l'hardware della stampante, probabilmente otterrai una risposta migliore cercando in un forum generale di stampa 3D o in un forum dedicato all'hardware della tua stampante. \u00c8 anche possibile cercare problemi simili in Klipper Community Forum . Se sei interessato a condividere le tue conoscenze ed esperienze con altri utenti di Klipper, puoi unirti al Klipper Community Forum o Klipper Discord Chat . Entrambe sono comunit\u00e0 in cui gli utenti di Klipper possono discutere di Klipper con altri utenti.","title":"Aiuto! Non funziona!"},{"location":"Contact.html#ho-trovato-un-bug-nel-software-klipper","text":"Klipper \u00e8 un progetto open-source ed apprezziamo quando i collaboratori diagnosticano errori nel software. I problemi devono essere segnalati nel Klipper Community Forum . Ci sono informazioni importanti che saranno necessarie per correggere un bug. Per favore segui questi passaggi: Assicurati di eseguire codice non modificato da https://github.com/Klipper3d/klipper . Se il codice \u00e8 stato modificato o \u00e8 stato ottenuto da un'altra fonte, \u00e8 necessario riprodurre il problema sul codice non modificato da https://github.com/Klipper3d/klipper prima della segnalazione. Se possibile, eseguire un comando M112 immediatamente dopo che si \u00e8 verificato l'evento indesiderato. Ci\u00f2 fa s\u00ec che Klipper entri in uno \"shutdown state\" e causer\u00e0 la scrittura di ulteriori informazioni di debug nel file di registro. Ottieni il log file di Klipper dell'evento. Il file di registro \u00e8 stato progettato per rispondere alle domande pi\u00f9 comuni degli sviluppatori di Klipper sul software e sul suo ambiente (versione del software, tipo di hardware, configurazione, tempistica degli eventi e centinaia di altre domande). Il log file di Klipper si trova in /tmp/klippy.log sul computer \"host\" di Klipper (il Raspberry Pi). Un comando o utility \"scp\" o \"sftp\" \u00e8 necessario per copiare questo file di registro sul computer desktop. L'utilit\u00e0 \"scp\" viene fornita di serie con i desktop Linux e MacOS. Ci sono utilit\u00e0 scp disponibili gratuitamente per altri desktop (ad es. WinSCP). Se si utilizza un'interfaccia grafica scp che non pu\u00f2 copiare direttamente /tmp/klippy.log , fare clic ripetutamente su .. o cartella principale fino ad arrivare alla directory principale, fare clic sulla cartella tmp , quindi seleziona il file klippy.log . Copia il lof file sul desktop in modo che possa essere allegato a una segnalazione di problema. Non modificare in alcun modo il log file; non editare o ritagliare il log file. Solo il file di log completo non modificato fornisce le informazioni necessarie. \u00c8 una buona idea comprimere il file di registro con zip o gzip. Apri un nuovo topic sul Klipper Community Forum e fornisci una descrizione chiara del problema. Altri contributori di Klipper dovranno capire quali passi sono stati compiuti, quale era il risultato desiderato e quale risultato si \u00e8 effettivamente verificato. Il file di registro compresso di Klipper dovrebbe essere allegato a quel topic.","title":"Ho trovato un bug nel software Klipper"},{"location":"Contact.html#sto-apportando-modifiche-che-vorrei-includere-in-klipper","text":"Klipper \u00e8 un software open-source e apprezziamo i nuovi contributi. I nuovi contributi (sia per il codice che per la documentazione) vengono inviati tramite Github Pull Requests. Vedere [ CONTRIBUTING document per informazioni importanti. Ci sono diversi documenti per sviluppatori . Se hai domande sul codice, puoi anche chiedere nel Klipper Community Forum o nella Klipper Community Discord .","title":"Sto apportando modifiche che vorrei includere in Klipper"},{"location":"Contact.html#klipper-github","text":"Klipper github pu\u00f2 essere utilizzato dai contributori per condividere lo stato del loro lavoro per migliorare Klipper. Ci si aspetta che la persona che apre un ticket github stia lavorando attivamente all'attivit\u00e0 specificata e sar\u00e0 quella che eseguir\u00e0 tutto il lavoro necessario per realizzarla. Il github di Klipper non viene utilizzato per richieste, n\u00e9 per segnalare bug, n\u00e9 per porre domande. Usa invece il Klipper Community Forum o la Klipper Community Discord .","title":"Klipper github"},{"location":"Debugging.html","text":"Debugging \u00b6 Questo documento descrive alcuni degli strumenti di debug di Klipper. Esecuzione dei test di regressione \u00b6 Il repository principale di Klipper GitHub utilizza \"github actions\" per eseguire una serie di test di regressione. Pu\u00f2 essere utile eseguire alcuni di questi test in locale. Il sorgente \"controllo spazi bianchi\" pu\u00f2 essere eseguito con: ./scripts/check_whitespace.sh La suite di test di regressione Klippy richiede \"dizionari di dati\" da molte piattaforme. Il modo pi\u00f9 semplice per ottenerli \u00e8 scaricarli da github . Una volta scaricati i dizionari di dati, utilizzare quanto segue per eseguire la suite di regressione: tar xfz klipper-dict-20??????.tar.gz ~/klippy-env/bin/python ~/klipper/scripts/test_klippy.py -d dict/ ~/klipper/test/klippy/*.test Invio manuale di comandi al microcontrollore \u00b6 Normalmente, il processo host klippy.py verrebbe utilizzato per tradurre i comandi gcode in comandi del microcontrollore Klipper. Tuttavia, \u00e8 anche possibile inviare manualmente questi comandi MCU (funzioni contrassegnate con la macro DECL_COMMAND() nel codice sorgente di Klipper). Per farlo, esegui: ~/klippy-env/bin/python ./klippy/console.py /tmp/pseudoserial Vedere il comando \"HELP\" all'interno dello strumento per ulteriori informazioni sulla sua funzionalit\u00e0. Sono disponibili alcune opzioni della riga di comando. Per ulteriori informazioni esegui: ~/klippy-env/bin/python ./klippy/console.py --help Traduzione di file gcode in comandi del microcontrollore \u00b6 Il codice host Klippy pu\u00f2 essere eseguito in modalit\u00e0 batch per produrre i comandi del microcontrollore di basso livello associati a un file gcode. L'ispezione di questi comandi di basso livello \u00e8 utile quando si cerca di comprendere le azioni dell'hardware di basso livello. Pu\u00f2 anche essere utile confrontare la differenza nei comandi del microcontrollore dopo una modifica del codice. Per eseguire Klippy in questa modalit\u00e0 batch, \u00e8 necessario un passaggio per generare il \"dizionario dati\" del microcontrollore. Questo viene fatto compilando il codice del microcontrollore per ottenere il file out/klipper.dict : make menuconfig make Una volta fatto quanto sopra \u00e8 possibile eseguire Klipper in modalit\u00e0 batch (vedi installazione per i passaggi necessari per costruire l'ambiente virtuale python e un file printer.cfg): ~/klippy-env/bin/python ./klippy/klippy.py ~/printer.cfg -i test.gcode -o test.serial -v -d out/klipper.dict Quanto sopra produrr\u00e0 un file test.serial con output seriale binario. Questo output pu\u00f2 essere tradotto in testo leggibile con: ~/klippy-env/bin/python ./klippy/parsedump.py out/klipper.dict test.serial > test.txt Il file risultante test.txt contiene un elenco leggibile di comandi del microcontrollore. La modalit\u00e0 batch disabilita alcuni comandi di risposta/richiesta per funzionare. Di conseguenza, ci saranno alcune differenze tra i comandi effettivi e l'output sopra. I dati generati sono utili per il test e l'ispezione; non \u00e8 utile per l'invio a un vero microcontrollore. Analisi del movimento e registrazione dei dati \u00b6 Klipper supporta la registrazione della cronologia dei movimenti interni, che pu\u00f2 essere analizzata in seguito. Per utilizzare questa funzione, Klipper deve essere avviato con Server API abilitato. La registrazione dei dati \u00e8 abilitata con lo strumento data_logger.py . Per esempio: ~/klipper/scripts/motan/data_logger.py /tmp/klippy_uds mylog Questo comando si collegher\u00e0 al Klipper API Server, sottoscriver\u00e0 le informazioni sullo stato e sul movimento e registrer\u00e0 i risultati. Vengono generati due file: un file di dati compresso e un file di indice (ad esempio, mylog.json.gz e mylog.index.gz ). Dopo aver avviato la registrazione, \u00e8 possibile completare le stampe e altre azioni: la registrazione continuer\u00e0 in background. Al termine della registrazione, premi ctrl-c per uscire dallo strumento data_logger.py . I file risultanti possono essere letti e rappresentati graficamente utilizzando lo strumento motan_graph.py . Per generare grafici su un Raspberry Pi, \u00e8 necessario un passaggio per installare il pacchetto \"matplotlib\": sudo apt-get update sudo apt-get install python-matplotlib Tuttavia, potrebbe essere pi\u00f9 conveniente copiare i file di dati su una macchina di classe desktop insieme al codice Python nella directory scripts/motan/ . Gli script di analisi del movimento dovrebbero essere eseguiti su qualsiasi macchina con una versione recente di Python e Matplotlib installata. I grafici possono essere generati con un comando come il seguente: ~/klipper/scripts/motan/motan_graph.py mylog -o mygraph.png One can use the -g option to specify the datasets to graph (it takes a Python literal containing a list of lists). For example: ~/klipper/scripts/motan/motan_graph.py mylog -g '[[\"trapq(toolhead,velocity)\"], [\"trapq(toolhead,accel)\"]]' L'elenco dei set di dati disponibili pu\u00f2 essere trovato usando l'opzione -l , ad esempio: ~/klipper/scripts/motan/motan_graph.py -l \u00c8 anche possibile specificare le opzioni di stampa matplotlib per ogni set di dati: ~/klipper/scripts/motan/motan_graph.py mylog -g '[[\"trapq(toolhead,velocity)?color=red&alpha=0.4\"]]' Sono disponibili molte opzioni di matplotlib; alcuni esempi sono \"color\", \"label\", \"alpha\" e \"linestyle\". Lo strumento motan_graph.py supporta molte altre opzioni della riga di comando: usa l'opzione --help per vedere un elenco. Pu\u00f2 anche essere conveniente visualizzare/modificare lo stesso script motan_graph.py . I log di dati grezzi prodotti dallo strumento data_logger.py seguono il formato descritto in Server API . Pu\u00f2 essere utile ispezionare i dati con un comando Unix come il seguente: gunzip < mylog.json.gz | tr '\\03' '\\n' | less Generare di grafici di carico \u00b6 Il file di registro di Klippy (/tmp/klippy.log) memorizza le statistiche sulla larghezza di banda, sul carico del microcontrollore e sul carico del buffer dell'host. Pu\u00f2 essere utile rappresentare graficamente queste statistiche dopo una stampa. Per generare un grafico, \u00e8 necessario un passaggio una tantum per installare il pacchetto \"matplotlib\": sudo apt-get update sudo apt-get install python-matplotlib Quindi i grafici possono essere prodotti con: ~/klipper/scripts/graphstats.py /tmp/klippy.log -o loadgraph.png Si pu\u00f2 quindi visualizzare il file loadgraph.png risultante. Possono essere prodotti diversi grafici. Per ulteriori informazioni esegui: ~/klipper/scripts/graphstats.py --help Estrazione di informazioni dal file klippy.log \u00b6 Anche il file di registro di Klippy (/tmp/klippy.log) contiene informazioni di debug. Esiste uno script logextract.py che pu\u00f2 essere utile quando si analizza l'arresto di un microcontrollore o un problema simile. In genere viene eseguito con qualcosa come: mkdir work_directory cd work_directory cp /tmp/klippy.log . ~/klipper/scripts/logextract.py ./klippy.log Lo script estrarr\u00e0 il file di configurazione della stampante ed estrarr\u00e0 le informazioni di arresto dell'MCU. I dump delle informazioni da un arresto dell'MCU (se presente) verranno riordinati in base al timestamp per facilitare la diagnosi degli scenari di causa ed effetto. Test con simulavr \u00b6 Lo strumento simulavr consente di simulare un microcontrollore Atmel ATmega. Questa sezione descrive come eseguire test di file gcode tramite simulavr. Si consiglia di eseguirlo su una macchina di classe desktop (non un Raspberry Pi) poich\u00e9 richiede una CPU significativa per funzionare in modo efficiente. Per utilizzare simulavr, scarica il pacchetto simulavr e compila con il supporto python. Nota che il sistema di build potrebbe aver bisogno di alcuni pacchetti (come swig) installati per costruire il modulo python. git clone git://git.savannah.nongnu.org/simulavr.git cd simulavr make python make build Assicurati che un file come ./build/pysimulavr/_pysimulavr.*.so sia presente dopo la compilazione di cui sopra: ls ./build/pysimulavr/_pysimulavr.*.so Questo comando dovrebbe segnalare un file specifico (ad es. ./build/pysimulavr/_pysimulavr.cpython-39-x86_64-linux-gnu.so ) e non un errore. Se utilizzi un sistema basato su Debian (Debian, Ubuntu, ecc.) puoi installare i seguenti pacchetti e generare file *.deb per l'installazione di simulavr a livello di sistema: sudo apt update sudo apt install g++ make cmake swig rst2pdf help2man texinfo make cfgclean python debian sudo dpkg -i build/debian/python3-simulavr*.deb Per compilare Klipper per l'uso in simulavr, eseguire: cd /path/to/klipper make menuconfig e compilare il software del microcontrollore per un AVR atmega644p e selezionare il supporto per l'emulazione del software SIMULAVR. Quindi si pu\u00f2 compilare Klipper (eseguire make ) e quindi avviare la simulazione con: PYTHONPATH=/path/to/simulavr/build/pysimulavr/ ./scripts/avrsim.py out/klipper.elf Nota che se hai installato python3-simulavr a livello di sistema, non \u00e8 necessario impostare PYTHONPATH e puoi semplicemente eseguire il simulatore come ./scripts/avrsim.py out/klipper.elf Quindi, con simulavr in esecuzione in un'altra finestra, \u00e8 possibile eseguire quanto segue per leggere gcode da un file (ad es. \"test.gcode\"), elaborarlo con Klippy e inviarlo a Klipper in esecuzione in simulavr (vedere installazione per i passaggi necessari per costruire l'ambiente virtuale Python): ~/klippy-env/bin/python ./klippy/klippy.py config/generic-simulavr.cfg -i test.gcode -v Utilizzo di simulavr con gtkwave \u00b6 Una caratteristica utile di simulavr \u00e8 la sua capacit\u00e0 di creare file di generazione di onde di segnale con l'esatta sincronizzazione degli eventi. Per fare ci\u00f2, segui le istruzioni sopra, ma esegui avrsim.py con una riga di comando come la seguente: PYTHONPATH=/path/to/simulavr/src/python/ ./scripts/avrsim.py out/klipper.elf -t PORTA.PORT,PORTC.PORT Quanto sopra creerebbe un file avrsim.vcd con informazioni su ogni modifica ai GPIO su PORTA e PORTB. Questo potrebbe quindi essere visualizzato usando gtkwave con: gtkwave avrsim.vcd","title":"Debugging"},{"location":"Debugging.html#debugging","text":"Questo documento descrive alcuni degli strumenti di debug di Klipper.","title":"Debugging"},{"location":"Debugging.html#esecuzione-dei-test-di-regressione","text":"Il repository principale di Klipper GitHub utilizza \"github actions\" per eseguire una serie di test di regressione. Pu\u00f2 essere utile eseguire alcuni di questi test in locale. Il sorgente \"controllo spazi bianchi\" pu\u00f2 essere eseguito con: ./scripts/check_whitespace.sh La suite di test di regressione Klippy richiede \"dizionari di dati\" da molte piattaforme. Il modo pi\u00f9 semplice per ottenerli \u00e8 scaricarli da github . Una volta scaricati i dizionari di dati, utilizzare quanto segue per eseguire la suite di regressione: tar xfz klipper-dict-20??????.tar.gz ~/klippy-env/bin/python ~/klipper/scripts/test_klippy.py -d dict/ ~/klipper/test/klippy/*.test","title":"Esecuzione dei test di regressione"},{"location":"Debugging.html#invio-manuale-di-comandi-al-microcontrollore","text":"Normalmente, il processo host klippy.py verrebbe utilizzato per tradurre i comandi gcode in comandi del microcontrollore Klipper. Tuttavia, \u00e8 anche possibile inviare manualmente questi comandi MCU (funzioni contrassegnate con la macro DECL_COMMAND() nel codice sorgente di Klipper). Per farlo, esegui: ~/klippy-env/bin/python ./klippy/console.py /tmp/pseudoserial Vedere il comando \"HELP\" all'interno dello strumento per ulteriori informazioni sulla sua funzionalit\u00e0. Sono disponibili alcune opzioni della riga di comando. Per ulteriori informazioni esegui: ~/klippy-env/bin/python ./klippy/console.py --help","title":"Invio manuale di comandi al microcontrollore"},{"location":"Debugging.html#traduzione-di-file-gcode-in-comandi-del-microcontrollore","text":"Il codice host Klippy pu\u00f2 essere eseguito in modalit\u00e0 batch per produrre i comandi del microcontrollore di basso livello associati a un file gcode. L'ispezione di questi comandi di basso livello \u00e8 utile quando si cerca di comprendere le azioni dell'hardware di basso livello. Pu\u00f2 anche essere utile confrontare la differenza nei comandi del microcontrollore dopo una modifica del codice. Per eseguire Klippy in questa modalit\u00e0 batch, \u00e8 necessario un passaggio per generare il \"dizionario dati\" del microcontrollore. Questo viene fatto compilando il codice del microcontrollore per ottenere il file out/klipper.dict : make menuconfig make Una volta fatto quanto sopra \u00e8 possibile eseguire Klipper in modalit\u00e0 batch (vedi installazione per i passaggi necessari per costruire l'ambiente virtuale python e un file printer.cfg): ~/klippy-env/bin/python ./klippy/klippy.py ~/printer.cfg -i test.gcode -o test.serial -v -d out/klipper.dict Quanto sopra produrr\u00e0 un file test.serial con output seriale binario. Questo output pu\u00f2 essere tradotto in testo leggibile con: ~/klippy-env/bin/python ./klippy/parsedump.py out/klipper.dict test.serial > test.txt Il file risultante test.txt contiene un elenco leggibile di comandi del microcontrollore. La modalit\u00e0 batch disabilita alcuni comandi di risposta/richiesta per funzionare. Di conseguenza, ci saranno alcune differenze tra i comandi effettivi e l'output sopra. I dati generati sono utili per il test e l'ispezione; non \u00e8 utile per l'invio a un vero microcontrollore.","title":"Traduzione di file gcode in comandi del microcontrollore"},{"location":"Debugging.html#analisi-del-movimento-e-registrazione-dei-dati","text":"Klipper supporta la registrazione della cronologia dei movimenti interni, che pu\u00f2 essere analizzata in seguito. Per utilizzare questa funzione, Klipper deve essere avviato con Server API abilitato. La registrazione dei dati \u00e8 abilitata con lo strumento data_logger.py . Per esempio: ~/klipper/scripts/motan/data_logger.py /tmp/klippy_uds mylog Questo comando si collegher\u00e0 al Klipper API Server, sottoscriver\u00e0 le informazioni sullo stato e sul movimento e registrer\u00e0 i risultati. Vengono generati due file: un file di dati compresso e un file di indice (ad esempio, mylog.json.gz e mylog.index.gz ). Dopo aver avviato la registrazione, \u00e8 possibile completare le stampe e altre azioni: la registrazione continuer\u00e0 in background. Al termine della registrazione, premi ctrl-c per uscire dallo strumento data_logger.py . I file risultanti possono essere letti e rappresentati graficamente utilizzando lo strumento motan_graph.py . Per generare grafici su un Raspberry Pi, \u00e8 necessario un passaggio per installare il pacchetto \"matplotlib\": sudo apt-get update sudo apt-get install python-matplotlib Tuttavia, potrebbe essere pi\u00f9 conveniente copiare i file di dati su una macchina di classe desktop insieme al codice Python nella directory scripts/motan/ . Gli script di analisi del movimento dovrebbero essere eseguiti su qualsiasi macchina con una versione recente di Python e Matplotlib installata. I grafici possono essere generati con un comando come il seguente: ~/klipper/scripts/motan/motan_graph.py mylog -o mygraph.png One can use the -g option to specify the datasets to graph (it takes a Python literal containing a list of lists). For example: ~/klipper/scripts/motan/motan_graph.py mylog -g '[[\"trapq(toolhead,velocity)\"], [\"trapq(toolhead,accel)\"]]' L'elenco dei set di dati disponibili pu\u00f2 essere trovato usando l'opzione -l , ad esempio: ~/klipper/scripts/motan/motan_graph.py -l \u00c8 anche possibile specificare le opzioni di stampa matplotlib per ogni set di dati: ~/klipper/scripts/motan/motan_graph.py mylog -g '[[\"trapq(toolhead,velocity)?color=red&alpha=0.4\"]]' Sono disponibili molte opzioni di matplotlib; alcuni esempi sono \"color\", \"label\", \"alpha\" e \"linestyle\". Lo strumento motan_graph.py supporta molte altre opzioni della riga di comando: usa l'opzione --help per vedere un elenco. Pu\u00f2 anche essere conveniente visualizzare/modificare lo stesso script motan_graph.py . I log di dati grezzi prodotti dallo strumento data_logger.py seguono il formato descritto in Server API . Pu\u00f2 essere utile ispezionare i dati con un comando Unix come il seguente: gunzip < mylog.json.gz | tr '\\03' '\\n' | less","title":"Analisi del movimento e registrazione dei dati"},{"location":"Debugging.html#generare-di-grafici-di-carico","text":"Il file di registro di Klippy (/tmp/klippy.log) memorizza le statistiche sulla larghezza di banda, sul carico del microcontrollore e sul carico del buffer dell'host. Pu\u00f2 essere utile rappresentare graficamente queste statistiche dopo una stampa. Per generare un grafico, \u00e8 necessario un passaggio una tantum per installare il pacchetto \"matplotlib\": sudo apt-get update sudo apt-get install python-matplotlib Quindi i grafici possono essere prodotti con: ~/klipper/scripts/graphstats.py /tmp/klippy.log -o loadgraph.png Si pu\u00f2 quindi visualizzare il file loadgraph.png risultante. Possono essere prodotti diversi grafici. Per ulteriori informazioni esegui: ~/klipper/scripts/graphstats.py --help","title":"Generare di grafici di carico"},{"location":"Debugging.html#estrazione-di-informazioni-dal-file-klippylog","text":"Anche il file di registro di Klippy (/tmp/klippy.log) contiene informazioni di debug. Esiste uno script logextract.py che pu\u00f2 essere utile quando si analizza l'arresto di un microcontrollore o un problema simile. In genere viene eseguito con qualcosa come: mkdir work_directory cd work_directory cp /tmp/klippy.log . ~/klipper/scripts/logextract.py ./klippy.log Lo script estrarr\u00e0 il file di configurazione della stampante ed estrarr\u00e0 le informazioni di arresto dell'MCU. I dump delle informazioni da un arresto dell'MCU (se presente) verranno riordinati in base al timestamp per facilitare la diagnosi degli scenari di causa ed effetto.","title":"Estrazione di informazioni dal file klippy.log"},{"location":"Debugging.html#test-con-simulavr","text":"Lo strumento simulavr consente di simulare un microcontrollore Atmel ATmega. Questa sezione descrive come eseguire test di file gcode tramite simulavr. Si consiglia di eseguirlo su una macchina di classe desktop (non un Raspberry Pi) poich\u00e9 richiede una CPU significativa per funzionare in modo efficiente. Per utilizzare simulavr, scarica il pacchetto simulavr e compila con il supporto python. Nota che il sistema di build potrebbe aver bisogno di alcuni pacchetti (come swig) installati per costruire il modulo python. git clone git://git.savannah.nongnu.org/simulavr.git cd simulavr make python make build Assicurati che un file come ./build/pysimulavr/_pysimulavr.*.so sia presente dopo la compilazione di cui sopra: ls ./build/pysimulavr/_pysimulavr.*.so Questo comando dovrebbe segnalare un file specifico (ad es. ./build/pysimulavr/_pysimulavr.cpython-39-x86_64-linux-gnu.so ) e non un errore. Se utilizzi un sistema basato su Debian (Debian, Ubuntu, ecc.) puoi installare i seguenti pacchetti e generare file *.deb per l'installazione di simulavr a livello di sistema: sudo apt update sudo apt install g++ make cmake swig rst2pdf help2man texinfo make cfgclean python debian sudo dpkg -i build/debian/python3-simulavr*.deb Per compilare Klipper per l'uso in simulavr, eseguire: cd /path/to/klipper make menuconfig e compilare il software del microcontrollore per un AVR atmega644p e selezionare il supporto per l'emulazione del software SIMULAVR. Quindi si pu\u00f2 compilare Klipper (eseguire make ) e quindi avviare la simulazione con: PYTHONPATH=/path/to/simulavr/build/pysimulavr/ ./scripts/avrsim.py out/klipper.elf Nota che se hai installato python3-simulavr a livello di sistema, non \u00e8 necessario impostare PYTHONPATH e puoi semplicemente eseguire il simulatore come ./scripts/avrsim.py out/klipper.elf Quindi, con simulavr in esecuzione in un'altra finestra, \u00e8 possibile eseguire quanto segue per leggere gcode da un file (ad es. \"test.gcode\"), elaborarlo con Klippy e inviarlo a Klipper in esecuzione in simulavr (vedere installazione per i passaggi necessari per costruire l'ambiente virtuale Python): ~/klippy-env/bin/python ./klippy/klippy.py config/generic-simulavr.cfg -i test.gcode -v","title":"Test con simulavr"},{"location":"Debugging.html#utilizzo-di-simulavr-con-gtkwave","text":"Una caratteristica utile di simulavr \u00e8 la sua capacit\u00e0 di creare file di generazione di onde di segnale con l'esatta sincronizzazione degli eventi. Per fare ci\u00f2, segui le istruzioni sopra, ma esegui avrsim.py con una riga di comando come la seguente: PYTHONPATH=/path/to/simulavr/src/python/ ./scripts/avrsim.py out/klipper.elf -t PORTA.PORT,PORTC.PORT Quanto sopra creerebbe un file avrsim.vcd con informazioni su ogni modifica ai GPIO su PORTA e PORTB. Questo potrebbe quindi essere visualizzato usando gtkwave con: gtkwave avrsim.vcd","title":"Utilizzo di simulavr con gtkwave"},{"location":"Delta_Calibrate.html","text":"Calibrazione delta \u00b6 Questo documento descrive il sistema di calibrazione automatica di Klipper per stampanti \"delta\". La calibrazione delta implica la ricerca delle posizioni dei finecorsa della torre, degli angoli della torre, del raggio delta e delle lunghezze del braccio delta. Queste impostazioni controllano il movimento della stampante su una stampante delta. Ognuno di questi parametri ha un impatto non evidente e non lineare ed \u00e8 difficile calibrarli manualmente. Al contrario, il codice di calibrazione del software pu\u00f2 fornire risultati eccellenti in pochi minuti di tempo. Non \u00e8 necessario alcun hardware di rilevamento speciale. In definitiva, la calibrazione delta dipende dalla precisione degli interruttori di fine corsa della torre. Se si utilizzano i driver per motori passo-passo Trinamic, considerare l'abilitazione del rilevamento fase endstop per migliorare la precisione di tali interruttori. Sonda automatica vs manuale \u00b6 Klipper supporta la calibrazione dei parametri delta tramite un metodo di sonda manuale o tramite una sonda Z automatica. Numerosi kit di stampanti delta sono dotati di sonde Z automatiche che non sono sufficientemente accurate (in particolare, piccole differenze nella lunghezza del braccio possono causare l'inclinazione dell'effettore che pu\u00f2 distorcere una sonda automatica). Se si utilizza una sonda automatica, prima calibrare la sonda e quindi verificare la presenza di un bias posizione sonda . Se la sonda automatica ha una polarizzazione superiore a 25 micron (0,025 mm), utilizzare invece la sonda manuale. Il probing manuale richiede solo pochi minuti ed elimina l'errore introdotto dalla sonda. Se si utilizza una sonda montata sul lato dell'hotend (ovvero ha un offset X o Y), tenere presente che l'esecuzione della calibrazione delta invalider\u00e0 i risultati della calibrazione della sonda. Questi tipi di sonde sono raramente adatti per l'uso su un delta (poich\u00e9 una minore inclinazione dell'effettore risulter\u00e0 in una distorsione della posizione della sonda). Se si utilizza comunque la sonda, assicurarsi di eseguire nuovamente la calibrazione della sonda dopo qualsiasi calibrazione delta. Calibrazione delta di base \u00b6 Klipper ha un comando DELTA_CALIBRATE che pu\u00f2 eseguire la calibrazione delta di base. Questo comando sonda sette diversi punti sul letto e calcola nuovi valori per gli angoli della torre, i punti terminali della torre e il raggio delta. Per eseguire questa calibrazione devono essere forniti i parametri delta iniziali (lunghezze dei bracci, raggio e posizioni dei finecorsa) e devono avere una precisione di pochi millimetri. La maggior parte dei kit della stampante delta fornisce questi parametri: configurare la stampante con queste impostazioni predefinite iniziali e quindi eseguire il comando DELTA_CALIBRATE come descritto di seguito. Se non sono disponibili impostazioni predefinite, cercare online una guida alla calibrazione delta che possa fornire un punto di partenza di base. Durante il processo di calibrazione delta potrebbe essere necessario che la stampante sondi al di sotto di quello che altrimenti sarebbe considerato il piano del piatto. \u00c8 tipico consentire ci\u00f2 durante la calibrazione aggiornando la configurazione in modo che minimum_z_position=-5 della stampante. (Una volta completata la calibrazione, \u00e8 possibile rimuovere questa impostazione dalla configurazione.) Ci sono due modi per eseguire la procedura: probing manuale ( DELTA_CALIBRATE METHOD=manual ) e automatica ( DELTA_CALIBRATE ). Il metodo di rilevamento manuale sposter\u00e0 la testa vicino al piatto e quindi attender\u00e0 che l'utente segua i passaggi descritti in \"test della carta\" per determinare la distanza effettiva tra l'ugello e letto nel luogo indicato. Per eseguire la misura di base, assicurati che la configurazione abbia una sezione [delta_calibrate] definita e quindi esegui lo strumento: G28 DELTA_CALIBRATE METHOD=manual Dopo aver sondato i sette punti verranno calcolati i nuovi parametri delta. Salva e applica questi parametri eseguendo: SAVE_CONFIG La calibrazione di base dovrebbe fornire parametri delta sufficientemente accurati per la stampa di base. Se si tratta di una nuova stampante, questo \u00e8 un buon momento per stampare alcuni oggetti di base e verificarne la funzionalit\u00e0 generale. Calibrazione delta migliorata \u00b6 La calibrazione delta di base generalmente fa un buon lavoro nel calcolo dei parametri delta in modo tale che l'ugello sia alla distanza corretta dal letto. Tuttavia, non tenta di calibrare la precisione dimensionale X e Y. \u00c8 una buona idea eseguire una calibrazione delta avanzata per verificare l'accuratezza dimensionale. Questa procedura di calibrazione richiede la stampa di un oggetto di prova e la misurazione di parti di tale oggetto di prova con un calibro digitale. Prima di eseguire una calibrazione delta avanzata, \u00e8 necessario eseguire la calibrazione delta di base (tramite il comando DELTA_CALIBRATE) e salvare i risultati (tramite il comando SAVE_CONFIG). Assicurati che non siano state apportate modifiche degne di nota alla configurazione della stampante n\u00e9 all'hardware dall'ultima esecuzione di una calibrazione delta di base (se non sei sicuro, esegui nuovamente la calibrazione delta di base , incluso SAVE_CONFIG, appena prima della stampa l'oggetto di prova descritto di seguito.) Usa uno slicer per generare il G-code dal file docs/prints/calibrate_size.stl . Estrudere l'oggetto a bassa velocit\u00e0 (ad es. 40 mm/s). Se possibile, usa una plastica rigida (come il PLA) per l'oggetto. L'oggetto ha un diametro di 140 mm. Se questo \u00e8 troppo grande per la stampante, \u00e8 possibile ridimensionarlo (ma assicurati di ridimensionare uniformemente entrambi gli assi X e Y). Se la stampante supporta stampe significativamente pi\u00f9 grandi, \u00e8 anche possibile aumentare le dimensioni di questo oggetto. Un formato pi\u00f9 grande pu\u00f2 migliorare la precisione della misurazione, ma una buona adesione di stampa \u00e8 pi\u00f9 importante di un formato di stampa pi\u00f9 grande. Stampa l'oggetto di prova e attendi che si raffreddi completamente. I comandi descritti di seguito devono essere eseguiti con le stesse impostazioni della stampante utilizzate per stampare l'oggetto di calibrazione (non eseguire DELTA_CALIBRATE tra la stampa e la misurazione, o fare qualcosa che altrimenti modificherebbe la configurazione della stampante). Se possibile, esegui le misurazioni descritte di seguito mentre l'oggetto \u00e8 ancora attaccato al piano di stampa, ma non preoccuparti se la parte si stacca dal letto: cerca solo di evitare di piegare l'oggetto durante l'esecuzione delle misurazioni. Inizia misurando la distanza tra il pilastro centrale e il pilastro accanto all'etichetta \"A\" (che dovrebbe anche puntare verso la torre \"A\"). Quindi procedere in senso antiorario e misurare le distanze tra il pilastro centrale e gli altri pilastri (distanza dal centro al pilastro attraverso l'etichetta C, distanza dal centro al pilastro con l'etichetta B, ecc.). Inserisci questi parametri in Klipper con un elenco separato da virgole di numeri in virgola mobile: DELTA_ANALYZE CENTER_DISTS=<a_dist>,<far_c_dist>,<b_dist>,<far_a_dist>,<c_dist>,<far_b_dist> Fornisci i valori senza spazi tra di loro. Quindi misurare la distanza tra il montante A e il montante di fronte all'etichetta C. Quindi andare in senso antiorario e misurare la distanza tra il pilastro di fronte a C e il pilastro B, la distanza tra il pilastro B e il pilastro di fronte a A, e cos\u00ec via. Inserisci questi parametri in Klipper: DELTA_ANALYZE OUTER_DISTS=<a_to_far_c>,<far_c_to_b>,<b_to_far_a>,<far_a_to_c>,<c_to_far_b>,<far_b_to_a> A questo punto va bene rimuovere l'oggetto dal letto. Le misure finali sono dei pilastri stessi. Misurare la dimensione del pilastro centrale lungo il raggio A, poi il raggio B e poi il raggio C. Inseriscili in Klipper: DELTA_ANALYZE CENTER_PILLAR_WIDTHS=<a>,<b>,<c> Le misure finali sono dei pilastri esterni. Inizia misurando la distanza del pilastro A lungo la linea da A al pilastro di fronte a C. Quindi andare in senso antiorario e misurare i restanti pilastri esterni (pilastro di fronte a C lungo la linea a B, pilastro B lungo la linea a pilastro di fronte ad A, ecc.). E inseriscili in Klipper: DELTA_ANALYZE OUTER_PILLAR_WIDTHS=<a>,<far_c>,<b>,<far_a>,<c>,<far_b> Se l'oggetto \u00e8 stato ridimensionato a una dimensione inferiore o superiore, fornire il fattore di scala utilizzato durante il taglio dell'oggetto: DELTA_ANALYZE SCALE=1.0 (Un valore di scala di 2,0 significherebbe che l'oggetto \u00e8 il doppio della sua dimensione originale, 0,5 sarebbe la met\u00e0 della sua dimensione originale.) Infine, esegui la calibrazione delta avanzata eseguendo: DELTA_ANALYZE CALIBRATE=extended Il completamento di questo comando pu\u00f2 richiedere diversi minuti. Dopo il completamento, calcoler\u00e0 i parametri delta aggiornati (raggio delta, angoli della torre, posizioni dei finecorsa e lunghezze dei bracci). Utilizzare il comando SAVE_CONFIG per salvare e applicare le impostazioni: SAVE_CONFIG Il comando SAVE_CONFIG salver\u00e0 sia i parametri delta aggiornati che le informazioni dalle misurazioni della distanza. Anche i futuri comandi DELTA_CALIBRATE utilizzeranno queste informazioni sulla distanza. Non tentare di reinserire le misurazioni grezze della distanza dopo aver eseguito SAVE_CONFIG, poich\u00e9 questo comando modifica la configurazione della stampante e le misurazioni grezze non vengono pi\u00f9 applicate. Note aggiuntive \u00b6 Se la stampante delta ha una buona precisione dimensionale, la distanza tra due pilastri qualsiasi dovrebbe essere di circa 74 mm e la larghezza di ogni pilastro dovrebbe essere di circa 9 mm. (In particolare, l'obiettivo \u00e8 che la distanza tra due pilastri qualsiasi meno la larghezza di uno dei pilastri sia esattamente 65 mm.) In caso di imprecisione dimensionale nella parte, la routine DELTA_ANALYZE calcoler\u00e0 nuovi parametri delta utilizzando entrambe le misurazioni della distanza e le misurazioni dell'altezza precedenti dall'ultimo comando DELTA_CALIBRATE. DELTA_ANALYZE pu\u00f2 produrre parametri delta sorprendenti. Ad esempio, pu\u00f2 suggerire lunghezze dei bracci che non corrispondono alle lunghezze effettive dei bracci della stampante. Nonostante ci\u00f2, i test hanno dimostrato che DELTA_ANALYZE produce spesso risultati superiori. Si ritiene che i parametri delta calcolati siano in grado di tenere conto di lievi errori in altre parti dell'hardware. Ad esempio, piccole differenze nella lunghezza del braccio possono comportare un'inclinazione dell'effettore e parte di tale inclinazione pu\u00f2 essere spiegata regolando i parametri della lunghezza del braccio. Utilizzo della mesh del piatto su un delta \u00b6 \u00c8 possibile utilizzare bed mesh su un delta. Tuttavia, \u00e8 importante ottenere una buona calibrazione delta prima di abilitare una mesh del letto. L'esecuzione della mesh del letto con una scarsa calibrazione delta comporter\u00e0 risultati confusi e scarsi. Si noti che l'esecuzione della calibrazione delta invalider\u00e0 qualsiasi mesh del piatto precedentemente ottenuto. Dopo aver eseguito una nuova calibrazione delta, assicurati di eseguire nuovamente BED_MESH_CALIBRATE.","title":"Calibrazione delta"},{"location":"Delta_Calibrate.html#calibrazione-delta","text":"Questo documento descrive il sistema di calibrazione automatica di Klipper per stampanti \"delta\". La calibrazione delta implica la ricerca delle posizioni dei finecorsa della torre, degli angoli della torre, del raggio delta e delle lunghezze del braccio delta. Queste impostazioni controllano il movimento della stampante su una stampante delta. Ognuno di questi parametri ha un impatto non evidente e non lineare ed \u00e8 difficile calibrarli manualmente. Al contrario, il codice di calibrazione del software pu\u00f2 fornire risultati eccellenti in pochi minuti di tempo. Non \u00e8 necessario alcun hardware di rilevamento speciale. In definitiva, la calibrazione delta dipende dalla precisione degli interruttori di fine corsa della torre. Se si utilizzano i driver per motori passo-passo Trinamic, considerare l'abilitazione del rilevamento fase endstop per migliorare la precisione di tali interruttori.","title":"Calibrazione delta"},{"location":"Delta_Calibrate.html#sonda-automatica-vs-manuale","text":"Klipper supporta la calibrazione dei parametri delta tramite un metodo di sonda manuale o tramite una sonda Z automatica. Numerosi kit di stampanti delta sono dotati di sonde Z automatiche che non sono sufficientemente accurate (in particolare, piccole differenze nella lunghezza del braccio possono causare l'inclinazione dell'effettore che pu\u00f2 distorcere una sonda automatica). Se si utilizza una sonda automatica, prima calibrare la sonda e quindi verificare la presenza di un bias posizione sonda . Se la sonda automatica ha una polarizzazione superiore a 25 micron (0,025 mm), utilizzare invece la sonda manuale. Il probing manuale richiede solo pochi minuti ed elimina l'errore introdotto dalla sonda. Se si utilizza una sonda montata sul lato dell'hotend (ovvero ha un offset X o Y), tenere presente che l'esecuzione della calibrazione delta invalider\u00e0 i risultati della calibrazione della sonda. Questi tipi di sonde sono raramente adatti per l'uso su un delta (poich\u00e9 una minore inclinazione dell'effettore risulter\u00e0 in una distorsione della posizione della sonda). Se si utilizza comunque la sonda, assicurarsi di eseguire nuovamente la calibrazione della sonda dopo qualsiasi calibrazione delta.","title":"Sonda automatica vs manuale"},{"location":"Delta_Calibrate.html#calibrazione-delta-di-base","text":"Klipper ha un comando DELTA_CALIBRATE che pu\u00f2 eseguire la calibrazione delta di base. Questo comando sonda sette diversi punti sul letto e calcola nuovi valori per gli angoli della torre, i punti terminali della torre e il raggio delta. Per eseguire questa calibrazione devono essere forniti i parametri delta iniziali (lunghezze dei bracci, raggio e posizioni dei finecorsa) e devono avere una precisione di pochi millimetri. La maggior parte dei kit della stampante delta fornisce questi parametri: configurare la stampante con queste impostazioni predefinite iniziali e quindi eseguire il comando DELTA_CALIBRATE come descritto di seguito. Se non sono disponibili impostazioni predefinite, cercare online una guida alla calibrazione delta che possa fornire un punto di partenza di base. Durante il processo di calibrazione delta potrebbe essere necessario che la stampante sondi al di sotto di quello che altrimenti sarebbe considerato il piano del piatto. \u00c8 tipico consentire ci\u00f2 durante la calibrazione aggiornando la configurazione in modo che minimum_z_position=-5 della stampante. (Una volta completata la calibrazione, \u00e8 possibile rimuovere questa impostazione dalla configurazione.) Ci sono due modi per eseguire la procedura: probing manuale ( DELTA_CALIBRATE METHOD=manual ) e automatica ( DELTA_CALIBRATE ). Il metodo di rilevamento manuale sposter\u00e0 la testa vicino al piatto e quindi attender\u00e0 che l'utente segua i passaggi descritti in \"test della carta\" per determinare la distanza effettiva tra l'ugello e letto nel luogo indicato. Per eseguire la misura di base, assicurati che la configurazione abbia una sezione [delta_calibrate] definita e quindi esegui lo strumento: G28 DELTA_CALIBRATE METHOD=manual Dopo aver sondato i sette punti verranno calcolati i nuovi parametri delta. Salva e applica questi parametri eseguendo: SAVE_CONFIG La calibrazione di base dovrebbe fornire parametri delta sufficientemente accurati per la stampa di base. Se si tratta di una nuova stampante, questo \u00e8 un buon momento per stampare alcuni oggetti di base e verificarne la funzionalit\u00e0 generale.","title":"Calibrazione delta di base"},{"location":"Delta_Calibrate.html#calibrazione-delta-migliorata","text":"La calibrazione delta di base generalmente fa un buon lavoro nel calcolo dei parametri delta in modo tale che l'ugello sia alla distanza corretta dal letto. Tuttavia, non tenta di calibrare la precisione dimensionale X e Y. \u00c8 una buona idea eseguire una calibrazione delta avanzata per verificare l'accuratezza dimensionale. Questa procedura di calibrazione richiede la stampa di un oggetto di prova e la misurazione di parti di tale oggetto di prova con un calibro digitale. Prima di eseguire una calibrazione delta avanzata, \u00e8 necessario eseguire la calibrazione delta di base (tramite il comando DELTA_CALIBRATE) e salvare i risultati (tramite il comando SAVE_CONFIG). Assicurati che non siano state apportate modifiche degne di nota alla configurazione della stampante n\u00e9 all'hardware dall'ultima esecuzione di una calibrazione delta di base (se non sei sicuro, esegui nuovamente la calibrazione delta di base , incluso SAVE_CONFIG, appena prima della stampa l'oggetto di prova descritto di seguito.) Usa uno slicer per generare il G-code dal file docs/prints/calibrate_size.stl . Estrudere l'oggetto a bassa velocit\u00e0 (ad es. 40 mm/s). Se possibile, usa una plastica rigida (come il PLA) per l'oggetto. L'oggetto ha un diametro di 140 mm. Se questo \u00e8 troppo grande per la stampante, \u00e8 possibile ridimensionarlo (ma assicurati di ridimensionare uniformemente entrambi gli assi X e Y). Se la stampante supporta stampe significativamente pi\u00f9 grandi, \u00e8 anche possibile aumentare le dimensioni di questo oggetto. Un formato pi\u00f9 grande pu\u00f2 migliorare la precisione della misurazione, ma una buona adesione di stampa \u00e8 pi\u00f9 importante di un formato di stampa pi\u00f9 grande. Stampa l'oggetto di prova e attendi che si raffreddi completamente. I comandi descritti di seguito devono essere eseguiti con le stesse impostazioni della stampante utilizzate per stampare l'oggetto di calibrazione (non eseguire DELTA_CALIBRATE tra la stampa e la misurazione, o fare qualcosa che altrimenti modificherebbe la configurazione della stampante). Se possibile, esegui le misurazioni descritte di seguito mentre l'oggetto \u00e8 ancora attaccato al piano di stampa, ma non preoccuparti se la parte si stacca dal letto: cerca solo di evitare di piegare l'oggetto durante l'esecuzione delle misurazioni. Inizia misurando la distanza tra il pilastro centrale e il pilastro accanto all'etichetta \"A\" (che dovrebbe anche puntare verso la torre \"A\"). Quindi procedere in senso antiorario e misurare le distanze tra il pilastro centrale e gli altri pilastri (distanza dal centro al pilastro attraverso l'etichetta C, distanza dal centro al pilastro con l'etichetta B, ecc.). Inserisci questi parametri in Klipper con un elenco separato da virgole di numeri in virgola mobile: DELTA_ANALYZE CENTER_DISTS=<a_dist>,<far_c_dist>,<b_dist>,<far_a_dist>,<c_dist>,<far_b_dist> Fornisci i valori senza spazi tra di loro. Quindi misurare la distanza tra il montante A e il montante di fronte all'etichetta C. Quindi andare in senso antiorario e misurare la distanza tra il pilastro di fronte a C e il pilastro B, la distanza tra il pilastro B e il pilastro di fronte a A, e cos\u00ec via. Inserisci questi parametri in Klipper: DELTA_ANALYZE OUTER_DISTS=<a_to_far_c>,<far_c_to_b>,<b_to_far_a>,<far_a_to_c>,<c_to_far_b>,<far_b_to_a> A questo punto va bene rimuovere l'oggetto dal letto. Le misure finali sono dei pilastri stessi. Misurare la dimensione del pilastro centrale lungo il raggio A, poi il raggio B e poi il raggio C. Inseriscili in Klipper: DELTA_ANALYZE CENTER_PILLAR_WIDTHS=<a>,<b>,<c> Le misure finali sono dei pilastri esterni. Inizia misurando la distanza del pilastro A lungo la linea da A al pilastro di fronte a C. Quindi andare in senso antiorario e misurare i restanti pilastri esterni (pilastro di fronte a C lungo la linea a B, pilastro B lungo la linea a pilastro di fronte ad A, ecc.). E inseriscili in Klipper: DELTA_ANALYZE OUTER_PILLAR_WIDTHS=<a>,<far_c>,<b>,<far_a>,<c>,<far_b> Se l'oggetto \u00e8 stato ridimensionato a una dimensione inferiore o superiore, fornire il fattore di scala utilizzato durante il taglio dell'oggetto: DELTA_ANALYZE SCALE=1.0 (Un valore di scala di 2,0 significherebbe che l'oggetto \u00e8 il doppio della sua dimensione originale, 0,5 sarebbe la met\u00e0 della sua dimensione originale.) Infine, esegui la calibrazione delta avanzata eseguendo: DELTA_ANALYZE CALIBRATE=extended Il completamento di questo comando pu\u00f2 richiedere diversi minuti. Dopo il completamento, calcoler\u00e0 i parametri delta aggiornati (raggio delta, angoli della torre, posizioni dei finecorsa e lunghezze dei bracci). Utilizzare il comando SAVE_CONFIG per salvare e applicare le impostazioni: SAVE_CONFIG Il comando SAVE_CONFIG salver\u00e0 sia i parametri delta aggiornati che le informazioni dalle misurazioni della distanza. Anche i futuri comandi DELTA_CALIBRATE utilizzeranno queste informazioni sulla distanza. Non tentare di reinserire le misurazioni grezze della distanza dopo aver eseguito SAVE_CONFIG, poich\u00e9 questo comando modifica la configurazione della stampante e le misurazioni grezze non vengono pi\u00f9 applicate.","title":"Calibrazione delta migliorata"},{"location":"Delta_Calibrate.html#note-aggiuntive","text":"Se la stampante delta ha una buona precisione dimensionale, la distanza tra due pilastri qualsiasi dovrebbe essere di circa 74 mm e la larghezza di ogni pilastro dovrebbe essere di circa 9 mm. (In particolare, l'obiettivo \u00e8 che la distanza tra due pilastri qualsiasi meno la larghezza di uno dei pilastri sia esattamente 65 mm.) In caso di imprecisione dimensionale nella parte, la routine DELTA_ANALYZE calcoler\u00e0 nuovi parametri delta utilizzando entrambe le misurazioni della distanza e le misurazioni dell'altezza precedenti dall'ultimo comando DELTA_CALIBRATE. DELTA_ANALYZE pu\u00f2 produrre parametri delta sorprendenti. Ad esempio, pu\u00f2 suggerire lunghezze dei bracci che non corrispondono alle lunghezze effettive dei bracci della stampante. Nonostante ci\u00f2, i test hanno dimostrato che DELTA_ANALYZE produce spesso risultati superiori. Si ritiene che i parametri delta calcolati siano in grado di tenere conto di lievi errori in altre parti dell'hardware. Ad esempio, piccole differenze nella lunghezza del braccio possono comportare un'inclinazione dell'effettore e parte di tale inclinazione pu\u00f2 essere spiegata regolando i parametri della lunghezza del braccio.","title":"Note aggiuntive"},{"location":"Delta_Calibrate.html#utilizzo-della-mesh-del-piatto-su-un-delta","text":"\u00c8 possibile utilizzare bed mesh su un delta. Tuttavia, \u00e8 importante ottenere una buona calibrazione delta prima di abilitare una mesh del letto. L'esecuzione della mesh del letto con una scarsa calibrazione delta comporter\u00e0 risultati confusi e scarsi. Si noti che l'esecuzione della calibrazione delta invalider\u00e0 qualsiasi mesh del piatto precedentemente ottenuto. Dopo aver eseguito una nuova calibrazione delta, assicurati di eseguire nuovamente BED_MESH_CALIBRATE.","title":"Utilizzo della mesh del piatto su un delta"},{"location":"Endstop_Phase.html","text":"Fase di fine corsa \u00b6 Questo documento descrive il sistema di finecorsa di Klipper regolato sulla fase degli stepper. Questa funzionalit\u00e0 pu\u00f2 migliorare la precisione degli interruttori di fine corsa tradizionali. \u00c8 particolarmente utile quando si utilizza un driver per motori passo-passo Trinamic con configurazione runtime. Un tipico interruttore di fine corsa ha una precisione di circa 100 micron. (Ogni volta l'interruttore pu\u00f2 attivarsi leggermente prima o leggermente dopo.) Sebbene si tratti di un errore relativamente piccolo, pu\u00f2 causare artefatti indesiderati. In particolare, questa deviazione di posizione pu\u00f2 essere evidente quando si stampa il primo strato di un oggetto. Al contrario, i tipici motori passo-passo possono ottenere una precisione significativamente maggiore. Il meccanismo di fine corsa con regolazione della fase pu\u00f2 utilizzare la precisione dei motori passo-passo per migliorare la precisione degli interruttori di fine corsa. Un motore passo-passo si muove ciclicamente attraverso una serie di fasi fino a completare quattro \"passi completi\". Quindi, un motore passo-passo che utilizza 16 micro-passi avrebbe 64 fasi e quando si muove in direzione positiva passerebbe in rassegna le fasi: 0, 1, 2, ... 61, 62, 63, 0, 1, 2, ecc. Fondamentalmente, quando il motore passo-passo si trova in una posizione particolare su una guida lineare, dovrebbe essere sempre nella stessa fase passo-passo. Pertanto, quando un carrello fa scattare l'interruttore di fine corsa, lo stepper che controlla quel carrello dovrebbe essere sempre nella stessa fase del motore passo-passo. Il sistema di fase finecorsa di Klipper combina la fase del motore con l'attivazione del finecorsa per migliorare la precisione. Per utilizzare questa funzionalit\u00e0 \u00e8 necessario essere in grado di identificare la fase del motore passo-passo. Se si utilizzano i driver Trinamic TMC2130, TMC2208, TMC2224 o TMC2660 in modalit\u00e0 di configurazione runtime (cio\u00e8 non in modalit\u00e0 stand-alone), Klipper pu\u00f2 interrogare la fase stepper dal driver. (\u00c8 anche possibile utilizzare questo sistema su driver stepper tradizionali se \u00e8 possibile ripristinare in modo affidabile i driver stepper - vedere sotto per i dettagli.) Taratura fasi dei finecorsa \u00b6 Se si utilizzano driver Trinamic per motori passo-passo in configurazione runtime, \u00e8 possibile calibrare le fasi di fine corsa utilizzando il comando ENDSTOP_PHASE_CALIBRATE. Inizia aggiungendo quanto segue al file di configurazione: [endstop_phase] Quindi RIAVVIARE la stampante ed eseguire un comando G28 seguito da un comando ENDSTOP_PHASE_CALIBRATE . Quindi spostare la testina in una nuova posizione ed eseguire nuovamente G28 . Prova a spostare la testina in diverse posizioni ed esegui nuovamente G28 da ciascuna posizione. Esegui almeno cinque comandi G28 . Dopo aver eseguito quanto sopra, il comando ENDSTOP_PHASE_CALIBRATE riporter\u00e0 spesso la stessa (o quasi) fase per lo stepper. Questa fase pu\u00f2 essere salvata nel file di configurazione in modo che tutti i futuri comandi G28 utilizzino quella fase. (Quindi, nelle future operazioni di homing, Klipper otterr\u00e0 la stessa posizione anche se il finecorsa si attiva un po' prima o un po' dopo.) Per salvare la fase di fine corsa per un particolare motore passo-passo, eseguire qualcosa di simile a: ENDSTOP_PHASE_CALIBRATE STEPPER=stepper_z Esegui quanto sopra per tutti gli stepper che desideri salvare. Tipicamente, si usa questo su stepper_z per stampanti cartesiane e corexy e per stepper_a, stepper_b e stepper_c su stampanti delta. Infine, eseguire quanto segue per aggiornare il file di configurazione con i dati: SAVE_CONFIG Note aggiuntive \u00b6 Questa funzione \u00e8 particolarmente utile sulle stampanti delta e sul fine corsa Z delle stampanti cartesiane/corexy. \u00c8 possibile utilizzare questa funzione sui fine corsa XY delle stampanti cartesiane, ma ci\u00f2 non \u00e8 particolarmente utile poich\u00e9 \u00e8 improbabile che un errore minore nella posizione dell'arresto X/Y influisca sulla qualit\u00e0 di stampa. Non \u00e8 valido utilizzare questa funzione sugli arresti XY delle stampanti corexy (poich\u00e9 la posizione XY non \u00e8 determinata da un singolo stepper sulla cinematica corexy). Non \u00e8 valido utilizzare questa funzione su una stampante che utilizza un fine corsa Z \"probe:z_virtual_endstop\" (poich\u00e9 la fase stepper \u00e8 stabile solo se il fine corsa si trova in una posizione statica su una guida). Dopo aver calibrato la fase del finecorsa, se il finecorsa viene successivamente spostato o regolato, sar\u00e0 necessario ricalibrarlo. Rimuovere i dati di calibrazione dal file di configurazione ed eseguire nuovamente i passaggi precedenti. Per utilizzare questo sistema, il finecorsa deve essere sufficientemente preciso da identificare la posizione dello stepper entro due \"passi completi\". Quindi, ad esempio, se uno stepper utilizza 16 micropassi con una distanza del passo di 0,005 mm, il finecorsa deve avere una precisione di almeno 0,160 mm. Se si ottengono messaggi di errore di tipo \"Finecorsa stepper_z non corretto\", potrebbero essere dovuti a un finecorsa che non \u00e8 sufficientemente accurato. Se la ricalibrazione non aiuta, disabilitare le regolazioni della fase finecorsa rimuovendole dal file di configurazione. Se si utilizza un tradizionale asse Z controllato da stepper (come su una stampante cartesiana o corexy) insieme alle tradizionali viti di livellamento del letto, \u00e8 anche possibile utilizzare questo sistema per fare in modo che ogni strato di stampa venga eseguito su un confine \"passo completo\" . Per abilitare questa funzione, assicurati che lo slicer del G-Code sia configurato con un'altezza del livello che sia un multiplo di un \"passo completo\", abilita manualmente l'opzione endstop_align_zero nella sezione di configurazione endstop_phase (vedi config reference per ulteriori dettagli), quindi livellare nuovamente le viti del piatto. \u00c8 possibile utilizzare questo sistema con driver per motori passo-passo tradizionali (non Trinamici). Tuttavia, per fare ci\u00f2 \u00e8 necessario assicurarsi che i driver del motore passo-passo vengano ripristinati ogni volta che viene ripristinato il microcontrollore. (Se i due vengono sempre ripristinati insieme, Klipper pu\u00f2 determinare la fase dello stepper tracciando il numero totale di passaggi che ha comandato allo stepper di muoversi.) Attualmente, l'unico modo per farlo in modo affidabile \u00e8 se sia il microcontrollore che il motore passo-passo i driver siano alimentati esclusivamente da USB e che l'alimentazione USB sia fornita da un host in esecuzione su un Raspberry Pi. In questa situazione \u00e8 possibile specificare una configurazione mcu con \"restart_method: rpi_usb\" - quell'opzione far\u00e0 in modo che il microcontrollore venga sempre ripristinato tramite un ripristino dell'alimentazione USB, il che farebbe in modo che sia il microcontrollore che i driver del motore passo-passo siano resettare insieme. Se si utilizza questo meccanismo, \u00e8 necessario configurare manualmente le sezioni di configurazione \"trigger_phase\" (consultare config reference per i dettagli).","title":"Fase di fine corsa"},{"location":"Endstop_Phase.html#fase-di-fine-corsa","text":"Questo documento descrive il sistema di finecorsa di Klipper regolato sulla fase degli stepper. Questa funzionalit\u00e0 pu\u00f2 migliorare la precisione degli interruttori di fine corsa tradizionali. \u00c8 particolarmente utile quando si utilizza un driver per motori passo-passo Trinamic con configurazione runtime. Un tipico interruttore di fine corsa ha una precisione di circa 100 micron. (Ogni volta l'interruttore pu\u00f2 attivarsi leggermente prima o leggermente dopo.) Sebbene si tratti di un errore relativamente piccolo, pu\u00f2 causare artefatti indesiderati. In particolare, questa deviazione di posizione pu\u00f2 essere evidente quando si stampa il primo strato di un oggetto. Al contrario, i tipici motori passo-passo possono ottenere una precisione significativamente maggiore. Il meccanismo di fine corsa con regolazione della fase pu\u00f2 utilizzare la precisione dei motori passo-passo per migliorare la precisione degli interruttori di fine corsa. Un motore passo-passo si muove ciclicamente attraverso una serie di fasi fino a completare quattro \"passi completi\". Quindi, un motore passo-passo che utilizza 16 micro-passi avrebbe 64 fasi e quando si muove in direzione positiva passerebbe in rassegna le fasi: 0, 1, 2, ... 61, 62, 63, 0, 1, 2, ecc. Fondamentalmente, quando il motore passo-passo si trova in una posizione particolare su una guida lineare, dovrebbe essere sempre nella stessa fase passo-passo. Pertanto, quando un carrello fa scattare l'interruttore di fine corsa, lo stepper che controlla quel carrello dovrebbe essere sempre nella stessa fase del motore passo-passo. Il sistema di fase finecorsa di Klipper combina la fase del motore con l'attivazione del finecorsa per migliorare la precisione. Per utilizzare questa funzionalit\u00e0 \u00e8 necessario essere in grado di identificare la fase del motore passo-passo. Se si utilizzano i driver Trinamic TMC2130, TMC2208, TMC2224 o TMC2660 in modalit\u00e0 di configurazione runtime (cio\u00e8 non in modalit\u00e0 stand-alone), Klipper pu\u00f2 interrogare la fase stepper dal driver. (\u00c8 anche possibile utilizzare questo sistema su driver stepper tradizionali se \u00e8 possibile ripristinare in modo affidabile i driver stepper - vedere sotto per i dettagli.)","title":"Fase di fine corsa"},{"location":"Endstop_Phase.html#taratura-fasi-dei-finecorsa","text":"Se si utilizzano driver Trinamic per motori passo-passo in configurazione runtime, \u00e8 possibile calibrare le fasi di fine corsa utilizzando il comando ENDSTOP_PHASE_CALIBRATE. Inizia aggiungendo quanto segue al file di configurazione: [endstop_phase] Quindi RIAVVIARE la stampante ed eseguire un comando G28 seguito da un comando ENDSTOP_PHASE_CALIBRATE . Quindi spostare la testina in una nuova posizione ed eseguire nuovamente G28 . Prova a spostare la testina in diverse posizioni ed esegui nuovamente G28 da ciascuna posizione. Esegui almeno cinque comandi G28 . Dopo aver eseguito quanto sopra, il comando ENDSTOP_PHASE_CALIBRATE riporter\u00e0 spesso la stessa (o quasi) fase per lo stepper. Questa fase pu\u00f2 essere salvata nel file di configurazione in modo che tutti i futuri comandi G28 utilizzino quella fase. (Quindi, nelle future operazioni di homing, Klipper otterr\u00e0 la stessa posizione anche se il finecorsa si attiva un po' prima o un po' dopo.) Per salvare la fase di fine corsa per un particolare motore passo-passo, eseguire qualcosa di simile a: ENDSTOP_PHASE_CALIBRATE STEPPER=stepper_z Esegui quanto sopra per tutti gli stepper che desideri salvare. Tipicamente, si usa questo su stepper_z per stampanti cartesiane e corexy e per stepper_a, stepper_b e stepper_c su stampanti delta. Infine, eseguire quanto segue per aggiornare il file di configurazione con i dati: SAVE_CONFIG","title":"Taratura fasi dei finecorsa"},{"location":"Endstop_Phase.html#note-aggiuntive","text":"Questa funzione \u00e8 particolarmente utile sulle stampanti delta e sul fine corsa Z delle stampanti cartesiane/corexy. \u00c8 possibile utilizzare questa funzione sui fine corsa XY delle stampanti cartesiane, ma ci\u00f2 non \u00e8 particolarmente utile poich\u00e9 \u00e8 improbabile che un errore minore nella posizione dell'arresto X/Y influisca sulla qualit\u00e0 di stampa. Non \u00e8 valido utilizzare questa funzione sugli arresti XY delle stampanti corexy (poich\u00e9 la posizione XY non \u00e8 determinata da un singolo stepper sulla cinematica corexy). Non \u00e8 valido utilizzare questa funzione su una stampante che utilizza un fine corsa Z \"probe:z_virtual_endstop\" (poich\u00e9 la fase stepper \u00e8 stabile solo se il fine corsa si trova in una posizione statica su una guida). Dopo aver calibrato la fase del finecorsa, se il finecorsa viene successivamente spostato o regolato, sar\u00e0 necessario ricalibrarlo. Rimuovere i dati di calibrazione dal file di configurazione ed eseguire nuovamente i passaggi precedenti. Per utilizzare questo sistema, il finecorsa deve essere sufficientemente preciso da identificare la posizione dello stepper entro due \"passi completi\". Quindi, ad esempio, se uno stepper utilizza 16 micropassi con una distanza del passo di 0,005 mm, il finecorsa deve avere una precisione di almeno 0,160 mm. Se si ottengono messaggi di errore di tipo \"Finecorsa stepper_z non corretto\", potrebbero essere dovuti a un finecorsa che non \u00e8 sufficientemente accurato. Se la ricalibrazione non aiuta, disabilitare le regolazioni della fase finecorsa rimuovendole dal file di configurazione. Se si utilizza un tradizionale asse Z controllato da stepper (come su una stampante cartesiana o corexy) insieme alle tradizionali viti di livellamento del letto, \u00e8 anche possibile utilizzare questo sistema per fare in modo che ogni strato di stampa venga eseguito su un confine \"passo completo\" . Per abilitare questa funzione, assicurati che lo slicer del G-Code sia configurato con un'altezza del livello che sia un multiplo di un \"passo completo\", abilita manualmente l'opzione endstop_align_zero nella sezione di configurazione endstop_phase (vedi config reference per ulteriori dettagli), quindi livellare nuovamente le viti del piatto. \u00c8 possibile utilizzare questo sistema con driver per motori passo-passo tradizionali (non Trinamici). Tuttavia, per fare ci\u00f2 \u00e8 necessario assicurarsi che i driver del motore passo-passo vengano ripristinati ogni volta che viene ripristinato il microcontrollore. (Se i due vengono sempre ripristinati insieme, Klipper pu\u00f2 determinare la fase dello stepper tracciando il numero totale di passaggi che ha comandato allo stepper di muoversi.) Attualmente, l'unico modo per farlo in modo affidabile \u00e8 se sia il microcontrollore che il motore passo-passo i driver siano alimentati esclusivamente da USB e che l'alimentazione USB sia fornita da un host in esecuzione su un Raspberry Pi. In questa situazione \u00e8 possibile specificare una configurazione mcu con \"restart_method: rpi_usb\" - quell'opzione far\u00e0 in modo che il microcontrollore venga sempre ripristinato tramite un ripristino dell'alimentazione USB, il che farebbe in modo che sia il microcontrollore che i driver del motore passo-passo siano resettare insieme. Se si utilizza questo meccanismo, \u00e8 necessario configurare manualmente le sezioni di configurazione \"trigger_phase\" (consultare config reference per i dettagli).","title":"Note aggiuntive"},{"location":"Example_Configs.html","text":"Esempi di configurazioni \u00b6 Questo documento contiene le linee guida per contribuire a creare un esempio di configurazione di Klipper nella repository github di Klipper (situato nella directory config ). Nota che il server Klipper Community Discourse \u00e8 anche una risorsa utile per trovare e condividere file di configurazione. Linee guida \u00b6 Seleziona il prefisso del nome del file di configurazione appropriato: Il prefisso printer viene utilizzato per le stampanti stock vendute da un produttore tradizionale. Il prefisso generic viene utilizzato per una scheda per stampante 3d che pu\u00f2 essere utilizzata in molti diversi tipi di stampanti. Il prefisso kit \u00e8 per le stampanti 3d assemblate secondo una specifica ampiamente utilizzata. Queste stampanti \"kit\" sono generalmente distinte dalle normali \"stampanti\" in quanto non sono vendute da un produttore. Il prefisso sample viene utilizzato per i \"ritagli\" di configurazione che \u00e8 possibile copiare e incollare nel file di configurazione principale. Il prefisso example viene utilizzato per descrivere la cinematica della stampante. Questo tipo di configurazione viene in genere aggiunto solo insieme al codice per un nuovo tipo di cinematica della stampante. Tutti i file di configurazione devono terminare con un suffisso .cfg . I file di configurazione della stampante devono terminare con un anno seguito da .cfg (ad es. -2019.cfg ). In questo caso, l'anno \u00e8 un anno approssimativo in cui \u00e8 stata venduta la stampante specificata. Non utilizzare spazi o caratteri speciali nel nome del file di configurazione. Il nome del file deve contenere solo i caratteri A-Z , a-z , 0-9 , - e . . Klipper deve essere in grado di avviare il file di configurazione di esempio printer , generic e kit senza errori. Questi file di configurazione devono essere aggiunti al test di regressione test/klippy/printers.test . Aggiungi nuovi file di configurazione a quel test case nella sezione appropriata e in ordine alfabetico all'interno di quella sezione. La configurazione di esempio dovrebbe essere per la configurazione \"stock\" della stampante. (Ci sono troppe configurazioni \"personalizzate\" da tenere traccia nel repository principale di Klipper.) Allo stesso modo, aggiungiamo solo file di configurazione di esempio per stampanti, kit e schede che hanno la popolarit\u00e0 principale (ad esempio, dovrebbero essercene almeno 100 in uso attivo). Prendi in considerazione l'utilizzo del server Klipper Community Discourse per altre configurazioni. Only specify those devices present on the given printer or board. Do not specify settings specific to your particular setup. For generic config files, only those devices on the mainboard should be described. For example, it would not make sense to add a display config section to a \"generic\" config as there is no way to know if the board will be attached to that type of display. If the board has a specific hardware port to facilitate an optional peripheral (eg, a bltouch port) then one can add a \"commented out\" config section for the given device. Non specificare pressure_advance in una configurazione di esempio, poich\u00e9 quel valore \u00e8 specifico del filamento, non dell'hardware della stampante. Allo stesso modo, non specificare le impostazioni max_extrude_only_velocity n\u00e9 max_extrude_only_accel . Non specificare una sezione di configurazione contenente un percorso host o hardware host. Ad esempio, non specificare le sezioni di configurazione [virtual_sdcard] n\u00e9 [temperature_host] . Definire solo le macro che utilizzano funzionalit\u00e0 specifiche per la stampante specificata o per definire i G-code comunemente emessi dagli slicer configurati per la stampante specificata. Where possible, it is best to use the same wording, phrasing, indentation, and section ordering as the existing config files. The top of each config file should list the type of micro-controller the user should select during \"make menuconfig\". It should also have a reference to \"docs/Config_Reference.md\". Non copiare la documentazione sul campo nei file di configurazione di esempio. (In questo modo si crea un onere di manutenzione poich\u00e9 un aggiornamento della documentazione richiederebbe quindi la modifica in molti punti.) I file di configurazione di esempio non devono contenere una sezione \"SAVE_CONFIG\". Se necessario, copiare i campi rilevanti dalla sezione SAVE_CONFIG alla sezione appropriata nell'area di configurazione principale. Usa la sintassi field: value invece di field=value . Quando si aggiunge la rotation_distance a un estrusore \u00e8 preferibile specificare un gear_ratio se l'estrusore ha un meccanismo di ingranaggi. Ci aspettiamo che la rotation_distance nelle configurazioni di esempio sia correlata alla circonferenza dell'ingranaggio nell'estrusore: normalmente \u00e8 nell'intervallo da 20 a 35 mm. Quando si specifica un gear_ratio \u00e8 preferibile specificare gli ingranaggi effettivi sul meccanismo (ad esempio, preferire gear_ratio: 80:20 su gear_ratio: 4:1 ). Per ulteriori informazioni, vedere il documento sulla distanza di rotazione . Evitare di definire valori di campo impostati sul valore predefinito. Ad esempio, non si dovrebbe specificare min_extrude_temp: 170 poich\u00e9 questo \u00e8 gi\u00e0 il valore predefinito. Ove possibile, le righe non devono superare le 80 colonne. Evita di aggiungere messaggi di attribuzione o revisione ai file di configurazione. (Ad esempio, evita di aggiungere righe come \"questo file \u00e8 stato creato da...\".) Inserisci l'attribuzione e cambia la cronologia nel messaggio di commit git. Non utilizzare alcuna funzionalit\u00e0 deprecata nel file di configurazione di esempio. Non disabilitare un sistema di sicurezza predefinito in un file di configurazione di esempio. Ad esempio, una configurazione non dovrebbe specificare una max_extrude_cross_section personalizzata. Non abilitare le funzionalit\u00e0 di debug. Ad esempio, non dovrebbe esserci una sezione di configurazione force_move . Tutte le schede note supportate da Klipper possono utilizzare la velocit\u00e0 di trasmissione seriale predefinita di 250000. Non consigliare una velocit\u00e0 di trasmissione diversa in un file di configurazione di esempio. I file di configurazione di esempio vengono inviati creando una \"richiesta pull\" di github. Si prega di seguire anche le indicazioni nel documento per contributi .","title":"Esempi di configurazioni"},{"location":"Example_Configs.html#esempi-di-configurazioni","text":"Questo documento contiene le linee guida per contribuire a creare un esempio di configurazione di Klipper nella repository github di Klipper (situato nella directory config ). Nota che il server Klipper Community Discourse \u00e8 anche una risorsa utile per trovare e condividere file di configurazione.","title":"Esempi di configurazioni"},{"location":"Example_Configs.html#linee-guida","text":"Seleziona il prefisso del nome del file di configurazione appropriato: Il prefisso printer viene utilizzato per le stampanti stock vendute da un produttore tradizionale. Il prefisso generic viene utilizzato per una scheda per stampante 3d che pu\u00f2 essere utilizzata in molti diversi tipi di stampanti. Il prefisso kit \u00e8 per le stampanti 3d assemblate secondo una specifica ampiamente utilizzata. Queste stampanti \"kit\" sono generalmente distinte dalle normali \"stampanti\" in quanto non sono vendute da un produttore. Il prefisso sample viene utilizzato per i \"ritagli\" di configurazione che \u00e8 possibile copiare e incollare nel file di configurazione principale. Il prefisso example viene utilizzato per descrivere la cinematica della stampante. Questo tipo di configurazione viene in genere aggiunto solo insieme al codice per un nuovo tipo di cinematica della stampante. Tutti i file di configurazione devono terminare con un suffisso .cfg . I file di configurazione della stampante devono terminare con un anno seguito da .cfg (ad es. -2019.cfg ). In questo caso, l'anno \u00e8 un anno approssimativo in cui \u00e8 stata venduta la stampante specificata. Non utilizzare spazi o caratteri speciali nel nome del file di configurazione. Il nome del file deve contenere solo i caratteri A-Z , a-z , 0-9 , - e . . Klipper deve essere in grado di avviare il file di configurazione di esempio printer , generic e kit senza errori. Questi file di configurazione devono essere aggiunti al test di regressione test/klippy/printers.test . Aggiungi nuovi file di configurazione a quel test case nella sezione appropriata e in ordine alfabetico all'interno di quella sezione. La configurazione di esempio dovrebbe essere per la configurazione \"stock\" della stampante. (Ci sono troppe configurazioni \"personalizzate\" da tenere traccia nel repository principale di Klipper.) Allo stesso modo, aggiungiamo solo file di configurazione di esempio per stampanti, kit e schede che hanno la popolarit\u00e0 principale (ad esempio, dovrebbero essercene almeno 100 in uso attivo). Prendi in considerazione l'utilizzo del server Klipper Community Discourse per altre configurazioni. Only specify those devices present on the given printer or board. Do not specify settings specific to your particular setup. For generic config files, only those devices on the mainboard should be described. For example, it would not make sense to add a display config section to a \"generic\" config as there is no way to know if the board will be attached to that type of display. If the board has a specific hardware port to facilitate an optional peripheral (eg, a bltouch port) then one can add a \"commented out\" config section for the given device. Non specificare pressure_advance in una configurazione di esempio, poich\u00e9 quel valore \u00e8 specifico del filamento, non dell'hardware della stampante. Allo stesso modo, non specificare le impostazioni max_extrude_only_velocity n\u00e9 max_extrude_only_accel . Non specificare una sezione di configurazione contenente un percorso host o hardware host. Ad esempio, non specificare le sezioni di configurazione [virtual_sdcard] n\u00e9 [temperature_host] . Definire solo le macro che utilizzano funzionalit\u00e0 specifiche per la stampante specificata o per definire i G-code comunemente emessi dagli slicer configurati per la stampante specificata. Where possible, it is best to use the same wording, phrasing, indentation, and section ordering as the existing config files. The top of each config file should list the type of micro-controller the user should select during \"make menuconfig\". It should also have a reference to \"docs/Config_Reference.md\". Non copiare la documentazione sul campo nei file di configurazione di esempio. (In questo modo si crea un onere di manutenzione poich\u00e9 un aggiornamento della documentazione richiederebbe quindi la modifica in molti punti.) I file di configurazione di esempio non devono contenere una sezione \"SAVE_CONFIG\". Se necessario, copiare i campi rilevanti dalla sezione SAVE_CONFIG alla sezione appropriata nell'area di configurazione principale. Usa la sintassi field: value invece di field=value . Quando si aggiunge la rotation_distance a un estrusore \u00e8 preferibile specificare un gear_ratio se l'estrusore ha un meccanismo di ingranaggi. Ci aspettiamo che la rotation_distance nelle configurazioni di esempio sia correlata alla circonferenza dell'ingranaggio nell'estrusore: normalmente \u00e8 nell'intervallo da 20 a 35 mm. Quando si specifica un gear_ratio \u00e8 preferibile specificare gli ingranaggi effettivi sul meccanismo (ad esempio, preferire gear_ratio: 80:20 su gear_ratio: 4:1 ). Per ulteriori informazioni, vedere il documento sulla distanza di rotazione . Evitare di definire valori di campo impostati sul valore predefinito. Ad esempio, non si dovrebbe specificare min_extrude_temp: 170 poich\u00e9 questo \u00e8 gi\u00e0 il valore predefinito. Ove possibile, le righe non devono superare le 80 colonne. Evita di aggiungere messaggi di attribuzione o revisione ai file di configurazione. (Ad esempio, evita di aggiungere righe come \"questo file \u00e8 stato creato da...\".) Inserisci l'attribuzione e cambia la cronologia nel messaggio di commit git. Non utilizzare alcuna funzionalit\u00e0 deprecata nel file di configurazione di esempio. Non disabilitare un sistema di sicurezza predefinito in un file di configurazione di esempio. Ad esempio, una configurazione non dovrebbe specificare una max_extrude_cross_section personalizzata. Non abilitare le funzionalit\u00e0 di debug. Ad esempio, non dovrebbe esserci una sezione di configurazione force_move . Tutte le schede note supportate da Klipper possono utilizzare la velocit\u00e0 di trasmissione seriale predefinita di 250000. Non consigliare una velocit\u00e0 di trasmissione diversa in un file di configurazione di esempio. I file di configurazione di esempio vengono inviati creando una \"richiesta pull\" di github. Si prega di seguire anche le indicazioni nel documento per contributi .","title":"Linee guida"},{"location":"Exclude_Object.html","text":"Escludi oggetti \u00b6 The [exclude_object] module allows Klipper to exclude objects while a print is in progress. To enable this feature include an exclude_object config section (also see the command reference and sample-macros.cfg file for a Marlin/RepRapFirmware compatible M486 G-Code macro.) A differenza di altre opzioni del firmware della stampante 3D, una stampante che esegue Klipper utilizza una suite di componenti e gli utenti hanno molte opzioni tra cui scegliere. Pertanto, al fine di fornire un'esperienza utente coerente, il modulo [exclude_object] stabilir\u00e0 un contratto o una sorta di API. Il contratto copre il contenuto del file gcode, come viene controllato lo stato interno del modulo e come tale stato viene fornito ai client. Panoramica del flusso di lavoro \u00b6 Un tipico flusso di lavoro per la stampa di un file potrebbe essere simile a: Lo slicing \u00e8 completato e il file viene caricato per la stampa. Durante il caricamento, il file viene elaborato e gli indicatori [exclude_object] vengono aggiunti al file. In alternativa, i filtri dei dati possono essere configurati per preparare i marcatori di esclusione degli oggetti in modo nativo o nella propria fase di pre-elaborazione. All'avvio della stampa, Klipper ripristiner\u00e0 [exclude_object] status . Quando Klipper elabora il blocco EXCLUDE_OBJECT_DEFINE , aggiorner\u00e0 lo stato con gli oggetti conosciuti e lo passer\u00e0 ai client. Il client pu\u00f2 utilizzare tali informazioni per presentare un'interfaccia all'utente in modo che sia possibile tenere traccia dei progressi. Klipper aggiorner\u00e0 lo stato per includere l'oggetto attualmente in stampa che il client pu\u00f2 utilizzare per scopi di visualizzazione. Se l'utente richiede la cancellazione di un oggetto, il client invier\u00e0 un comando EXCLUDE_OBJECT NAME=<nome> a Klipper. Quando Klipper elabora il comando, aggiunger\u00e0 l'oggetto all'elenco degli oggetti esclusi e aggiorner\u00e0 lo stato per i client. Il client ricever\u00e0 lo stato aggiornato da Klipper e potr\u00e0 utilizzare tali informazioni per aggiornare lo stato dell'oggetto nell'interfaccia utente. Al termine della stampa, lo stato [exclude_object] continuer\u00e0 a essere disponibile fino a quando un'altra azione non lo reimposta. Il file GCode \u00b6 L'elaborazione specializzata del gcode necessaria per supportare l'esclusione di oggetti non rientra negli obiettivi di progettazione principali di Klipper. Pertanto, questo modulo richiede che il file venga elaborato prima di essere inviato a Klipper per la stampa. L'utilizzo di uno script di post-elaborazione nello slicer o il middleware che elabora il file durante il caricamento sono due possibilit\u00e0 per preparare il file per Klipper. Uno script di post-elaborazione di riferimento \u00e8 disponibile sia come eseguibile che come libreria Python, vedere cancelobject-preprocessor . Definizioni di oggetti \u00b6 Il comando EXCLUDE_OBJECT_DEFINE viene utilizzato per fornire un riepilogo di ogni oggetto nel file gcode da stampare. Fornisce un riepilogo di un oggetto nel file. Gli oggetti non hanno bisogno di essere definiti per essere referenziati da altri comandi. Lo scopo principale di questo comando \u00e8 fornire informazioni all'interfaccia utente senza dover analizzare l'intero file gcode. Le definizioni degli oggetti sono denominate per consentire agli utenti di selezionare facilmente un oggetto da escludere e possono essere forniti metadati aggiuntivi per consentire la visualizzazione grafica dell'annullamento. I metadati attualmente definiti includono una coordinata X,Y \"CENTRO\" e un elenco \"POLYGON\" di punti X,Y che rappresentano un contorno minimo dell'oggetto. Potrebbe trattarsi di un semplice riquadro di delimitazione o di uno guscio complicato per mostrare visualizzazioni pi\u00f9 dettagliate degli oggetti stampati. Soprattutto quando i file gcode includono pi\u00f9 parti con regioni di delimitazione sovrapposte, i punti centrali diventano difficili da distinguere visivamente. POLYGONS deve essere un array compatibile con json di tuple punto [X,Y] senza spazi. Ulteriori parametri verranno salvati come stringhe nella definizione dell'oggetto e forniti negli aggiornamenti di stato. EXCLUDE_OBJECT_DEFINE NAME=calibration_pyramid CENTER=50,50 POLYGON=[[40,40],[50,60],[60,40]] All available G-Code commands are documented in the G-Code Reference Informazioni sullo stato \u00b6 The state of this module is provided to clients by the exclude_object status . Lo stato viene ripristinato quando: Il firmware di Klipper viene riavviato. C'\u00e8 un reset della [virtual_sdcard] . In particolare, questo viene ripristinato da Klipper all'inizio di una stampa. Quando viene emesso un comando EXCLUDE_OBJECT_DEFINE RESET=1 . L'elenco degli oggetti definiti \u00e8 rappresentato nel campo di stato exclude_object.objects . In un file gcode ben definito, questo sar\u00e0 fatto con i comandi EXCLUDE_OBJECT_DEFINE all'inizio del file. Ci\u00f2 fornir\u00e0 ai client i nomi e le coordinate degli oggetti in modo che l'interfaccia utente possa fornire una rappresentazione grafica degli oggetti, se lo si desidera. Man mano che la stampa procede, il campo di stato exclude_object.current_object verr\u00e0 aggiornato mentre Klipper elabora i comandi EXCLUDE_OBJECT_START e EXCLUDE_OBJECT_END . Il campo oggetto_corrente sar\u00e0 impostato anche se l'oggetto \u00e8 stato escluso. Gli oggetti non definiti contrassegnati con un EXCLUDE_OBJECT_START verranno aggiunti agli oggetti conosciuti per facilitare i suggerimenti dell'interfaccia utente, senza metadati aggiuntivi. Quando vengono emessi i comandi EXCLUDE_OBJECT , l'elenco degli oggetti esclusi viene fornito nell'array exclude_object.excluded_objects . Poich\u00e9 Klipper guarda avanti per elaborare il prossimo gcode, potrebbe esserci un ritardo tra l'emissione del comando e l'aggiornamento dello stato.","title":"Escludi oggetti"},{"location":"Exclude_Object.html#escludi-oggetti","text":"The [exclude_object] module allows Klipper to exclude objects while a print is in progress. To enable this feature include an exclude_object config section (also see the command reference and sample-macros.cfg file for a Marlin/RepRapFirmware compatible M486 G-Code macro.) A differenza di altre opzioni del firmware della stampante 3D, una stampante che esegue Klipper utilizza una suite di componenti e gli utenti hanno molte opzioni tra cui scegliere. Pertanto, al fine di fornire un'esperienza utente coerente, il modulo [exclude_object] stabilir\u00e0 un contratto o una sorta di API. Il contratto copre il contenuto del file gcode, come viene controllato lo stato interno del modulo e come tale stato viene fornito ai client.","title":"Escludi oggetti"},{"location":"Exclude_Object.html#panoramica-del-flusso-di-lavoro","text":"Un tipico flusso di lavoro per la stampa di un file potrebbe essere simile a: Lo slicing \u00e8 completato e il file viene caricato per la stampa. Durante il caricamento, il file viene elaborato e gli indicatori [exclude_object] vengono aggiunti al file. In alternativa, i filtri dei dati possono essere configurati per preparare i marcatori di esclusione degli oggetti in modo nativo o nella propria fase di pre-elaborazione. All'avvio della stampa, Klipper ripristiner\u00e0 [exclude_object] status . Quando Klipper elabora il blocco EXCLUDE_OBJECT_DEFINE , aggiorner\u00e0 lo stato con gli oggetti conosciuti e lo passer\u00e0 ai client. Il client pu\u00f2 utilizzare tali informazioni per presentare un'interfaccia all'utente in modo che sia possibile tenere traccia dei progressi. Klipper aggiorner\u00e0 lo stato per includere l'oggetto attualmente in stampa che il client pu\u00f2 utilizzare per scopi di visualizzazione. Se l'utente richiede la cancellazione di un oggetto, il client invier\u00e0 un comando EXCLUDE_OBJECT NAME=<nome> a Klipper. Quando Klipper elabora il comando, aggiunger\u00e0 l'oggetto all'elenco degli oggetti esclusi e aggiorner\u00e0 lo stato per i client. Il client ricever\u00e0 lo stato aggiornato da Klipper e potr\u00e0 utilizzare tali informazioni per aggiornare lo stato dell'oggetto nell'interfaccia utente. Al termine della stampa, lo stato [exclude_object] continuer\u00e0 a essere disponibile fino a quando un'altra azione non lo reimposta.","title":"Panoramica del flusso di lavoro"},{"location":"Exclude_Object.html#il-file-gcode","text":"L'elaborazione specializzata del gcode necessaria per supportare l'esclusione di oggetti non rientra negli obiettivi di progettazione principali di Klipper. Pertanto, questo modulo richiede che il file venga elaborato prima di essere inviato a Klipper per la stampa. L'utilizzo di uno script di post-elaborazione nello slicer o il middleware che elabora il file durante il caricamento sono due possibilit\u00e0 per preparare il file per Klipper. Uno script di post-elaborazione di riferimento \u00e8 disponibile sia come eseguibile che come libreria Python, vedere cancelobject-preprocessor .","title":"Il file GCode"},{"location":"Exclude_Object.html#definizioni-di-oggetti","text":"Il comando EXCLUDE_OBJECT_DEFINE viene utilizzato per fornire un riepilogo di ogni oggetto nel file gcode da stampare. Fornisce un riepilogo di un oggetto nel file. Gli oggetti non hanno bisogno di essere definiti per essere referenziati da altri comandi. Lo scopo principale di questo comando \u00e8 fornire informazioni all'interfaccia utente senza dover analizzare l'intero file gcode. Le definizioni degli oggetti sono denominate per consentire agli utenti di selezionare facilmente un oggetto da escludere e possono essere forniti metadati aggiuntivi per consentire la visualizzazione grafica dell'annullamento. I metadati attualmente definiti includono una coordinata X,Y \"CENTRO\" e un elenco \"POLYGON\" di punti X,Y che rappresentano un contorno minimo dell'oggetto. Potrebbe trattarsi di un semplice riquadro di delimitazione o di uno guscio complicato per mostrare visualizzazioni pi\u00f9 dettagliate degli oggetti stampati. Soprattutto quando i file gcode includono pi\u00f9 parti con regioni di delimitazione sovrapposte, i punti centrali diventano difficili da distinguere visivamente. POLYGONS deve essere un array compatibile con json di tuple punto [X,Y] senza spazi. Ulteriori parametri verranno salvati come stringhe nella definizione dell'oggetto e forniti negli aggiornamenti di stato. EXCLUDE_OBJECT_DEFINE NAME=calibration_pyramid CENTER=50,50 POLYGON=[[40,40],[50,60],[60,40]] All available G-Code commands are documented in the G-Code Reference","title":"Definizioni di oggetti"},{"location":"Exclude_Object.html#informazioni-sullo-stato","text":"The state of this module is provided to clients by the exclude_object status . Lo stato viene ripristinato quando: Il firmware di Klipper viene riavviato. C'\u00e8 un reset della [virtual_sdcard] . In particolare, questo viene ripristinato da Klipper all'inizio di una stampa. Quando viene emesso un comando EXCLUDE_OBJECT_DEFINE RESET=1 . L'elenco degli oggetti definiti \u00e8 rappresentato nel campo di stato exclude_object.objects . In un file gcode ben definito, questo sar\u00e0 fatto con i comandi EXCLUDE_OBJECT_DEFINE all'inizio del file. Ci\u00f2 fornir\u00e0 ai client i nomi e le coordinate degli oggetti in modo che l'interfaccia utente possa fornire una rappresentazione grafica degli oggetti, se lo si desidera. Man mano che la stampa procede, il campo di stato exclude_object.current_object verr\u00e0 aggiornato mentre Klipper elabora i comandi EXCLUDE_OBJECT_START e EXCLUDE_OBJECT_END . Il campo oggetto_corrente sar\u00e0 impostato anche se l'oggetto \u00e8 stato escluso. Gli oggetti non definiti contrassegnati con un EXCLUDE_OBJECT_START verranno aggiunti agli oggetti conosciuti per facilitare i suggerimenti dell'interfaccia utente, senza metadati aggiuntivi. Quando vengono emessi i comandi EXCLUDE_OBJECT , l'elenco degli oggetti esclusi viene fornito nell'array exclude_object.excluded_objects . Poich\u00e9 Klipper guarda avanti per elaborare il prossimo gcode, potrebbe esserci un ritardo tra l'emissione del comando e l'aggiornamento dello stato.","title":"Informazioni sullo stato"},{"location":"FAQ.html","text":"Domande frequenti \u00b6 Come posso donare al progetto? \u00b6 Grazie per il vostro sostegno. Per informazioni, vedere la Pagina degli sponsor . Come faccio a calcolare il parametro di configurazione rotation_distance? \u00b6 Vedere il rotation distance document . Dov'\u00e8 la mia porta seriale? \u00b6 Il modo generico per trovare una porta seriale USB \u00e8 eseguire ls /dev/serial/by-id/* da un terminale ssh sulla macchina host. Probabilmente produrr\u00e0 un output simile al seguente: /dev/serial/by-id/usb-1a86_USB2.0-Serial-if00-port0 Il nome trovato nel comando precedente \u00e8 stabile ed \u00e8 possibile utilizzarlo nel file di configurazione e durante il flashing del codice del microcontrollore. Ad esempio, un comando flash potrebbe essere simile a: sudo service klipper stop make flash FLASH_DEVICE=/dev/serial/by-id/usb-1a86_USB2.0-Serial-if00-port0 sudo service klipper start e la configurazione aggiornata potrebbe essere simile a: [mcu] serial: /dev/serial/by-id/usb-1a86_USB2.0-Serial-if00-port0 Assicurati di copiare e incollare il nome dal comando \"ls\" che hai eseguito sopra poich\u00e9 il nome sar\u00e0 diverso per ciascuna stampante. Se stai usando pi\u00f9 microcontrollori e non hanno ID univoci (comune sulle schede con un chip USB CH340), segui invece le indicazioni sopra usando il comando ls /dev/serial/by-path/* . Quando il microcontrollore si riavvia, il dispositivo cambia in /dev/ttyUSB1 \u00b6 egui le istruzioni nella sezione \" Where's my serial port? \" per evitare che ci\u00f2 accada. Il comando \"make flash\" non funziona \u00b6 Il codice tenta di eseguire il flashing del dispositivo utilizzando il metodo pi\u00f9 comune per ciascuna piattaforma. Sfortunatamente, c'\u00e8 molta variabilit\u00e0 nei metodi di flashing, quindi il comando \"make flash\" potrebbe non funzionare su tutte le schede. Se si verifica un errore intermittente o si dispone di una configurazione standard, ricontrolla che Klipper non sia in esecuzione durante il flashing (sudo service klipper stop), assicurati che OctoPrint non stia tentando di connettersi direttamente al dispositivo (apri il scheda Connessione nella pagina Web e fare clic su Disconnetti se la porta seriale \u00e8 impostata sul dispositivo) e assicurarsi che FLASH_DEVICE sia impostato correttamente per la scheda (consultare la question above . Tuttavia, se \"make flash\" non funziona per la tua scheda, dovrai eseguire il flashing manualmente. Verificare se nella config directory \u00e8 presente un file di configurazione con istruzioni specifiche per il flashing del dispositivo. Inoltre, controlla la documentazione del produttore della scheda per vedere se descrive come eseguire il flashing del dispositivo. Infine, potrebbe essere possibile eseguire manualmente il flashing del dispositivo utilizzando strumenti come \"avrdude\" o \"bossac\" - vedere il bootloader document per ulteriori informazioni. Come posso modificare la velocit\u00e0 di trasmissione seriale? \u00b6 Il baud rate consigliato per Klipper \u00e8 250000. Questo baud rate funziona bene su tutte le schede di microcontrollore supportate da Klipper. Se hai trovato una guida online che consiglia una velocit\u00e0 di trasmissione diversa, ignora quella parte della guida e continua con il valore predefinito di 250000. Se si desidera comunque modificare il baud rate, sar\u00e0 necessario configurare la nuova velocit\u00e0 nel microcontrollore (durante make menuconfig ) e il codice aggiornato dovr\u00e0 essere compilato e flashato sul microcontrollore. Anche il file Klipper printer.cfg dovr\u00e0 essere aggiornato in modo che corrisponda a tale velocit\u00e0 di trasmissione (consultare il config reference per i dettagli). Per esempio: [mcu] baud: 250000 La velocit\u00e0 di trasmissione mostrata sulla pagina Web di OctoPrint non ha alcun impatto sulla velocit\u00e0 di trasmissione interna del microcontrollore Klipper. Impostare sempre la velocit\u00e0 di trasmissione OctoPrint su 250000 quando si utilizza Klipper. La velocit\u00e0 in baud del microcontrollore Klipper non \u00e8 correlata alla velocit\u00e0 in baud del bootloader del microcontrollore. Vedere il bootloader document per ulteriori informazioni sui bootloader. Posso eseguire Klipper su qualcosa di diverso da un Raspberry Pi 3? \u00b6 L'hardware consigliato \u00e8 un Raspberry Pi 2, Raspberry Pi 3 o Raspberry Pi 4. Klipper funzioner\u00e0 su un Raspberry Pi 1 e su Raspberry Pi Zero, ma queste schede non hanno una potenza di elaborazione sufficiente per eseguire bene OctoPrint. \u00c8 normale che si verifichino interruzioni di stampa su queste macchine pi\u00f9 lente quando si stampa direttamente da OctoPrint. (La stampante potrebbe muoversi pi\u00f9 velocemente di quanto OctoPrint possa inviare comandi di movimento.) Se desideri comunque eseguire su una di queste schede pi\u00f9 lente, considera l'utilizzo della funzione \"virtual_sdcard\" durante la stampa (consulta config reference per dettagli). Per l'esecuzione su Beaglebone, vedere le Istruzioni di installazione specifiche di Beaglebone . Klipper \u00e8 stato eseguito su altre macchine. Il software host Klipper richiede solo Python in esecuzione su un computer Linux (o simile). Tuttavia, se desideri eseguirlo su una macchina diversa, avrai bisogno della conoscenza dell'amministratore Linux per installare i prerequisiti di sistema per quella particolare macchina. Consulta lo script install-octopi.sh per ulteriori informazioni sui passaggi necessari. Se stai cercando di eseguire il software host Klipper su un chip di fascia bassa, tieni presente che, come minimo, \u00e8 necessaria una macchina con hardware a \"virgola mobile a doppia precisione\". Se stai cercando di eseguire il software host Klipper su un desktop generico condiviso o una macchina di classe server, tieni presente che Klipper ha alcuni requisiti di scheduling in tempo reale. Se, durante una stampa, il computer host esegue anche un'intensa attivit\u00e0 di elaborazione generica (come deframmentazione di un disco rigido, rendering 3D, scambi pesanti e cos\u00ec via), Klipper potrebbe segnalare errori di stampa. Nota: se non stai utilizzando un'immagine OctoPi, tieni presente che diverse distribuzioni Linux abilitano un pacchetto \"ModemManager\" (o simile) che pu\u00f2 interrompere la comunicazione seriale. (Il che pu\u00f2 far s\u00ec che Klipper riporti errori apparentemente casuali \"Comunicazione persa con MCU\".) Se installi Klipper su una di queste distribuzioni potresti dover disabilitare quel pacchetto. Posso eseguire pi\u00f9 istanze di Klipper sulla stessa macchina host? \u00b6 \u00c8 possibile eseguire pi\u00f9 istanze del software host Klipper, ma per farlo \u00e8 necessaria la conoscenza dell'amministratore Linux. Gli script di installazione di Klipper determinano l'esecuzione del seguente comando Unix: ~/klippy-env/bin/python ~/klipper/klippy/klippy.py ~/printer.cfg -l /tmp/klippy.log \u00c8 possibile eseguire pi\u00f9 istanze del comando precedente purch\u00e9 ogni istanza abbia il proprio file di configurazione della stampante, il proprio file di registro e il proprio pseudo-tty. Per esempio: ~/klippy-env/bin/python ~/klipper/klippy/klippy.py ~/printer2.cfg -l /tmp/klippy2.log -I /tmp/printer2 Se scegli di farlo, dovrai implementare gli script di avvio, arresto e installazione necessari (se presenti). Lo script install-octopi.sh e lo script klipper-start.sh possono essere utili come esempi. Devo usare OctoPrint? \u00b6 Il software Klipper non dipende da OctoPrint. \u00c8 possibile utilizzare un software alternativo per inviare comandi a Klipper, ma ci\u00f2 richiede la conoscenza dell'amministratore Linux. Klipper crea una \"porta seriale virtuale\" tramite il file \"/tmp/printer\" ed emula una classica interfaccia seriale per stampante 3D tramite quel file. In generale, un software alternativo pu\u00f2 funzionare con Klipper purch\u00e9 possa essere configurato per utilizzare \"/tmp/printer\" per la porta seriale della stampante. Perch\u00e9 non riesco a spostare lo stepper prima di riposizionare la stampante? \u00b6 Il codice fa questo per ridurre la possibilit\u00e0 di comandare accidentalmente la testa nel piatto o altri limiti. Una volta che la stampante \u00e8 stata localizzata, il software tenta di verificare che ogni mossa rientri nella posizione_min/max definita nel file di configurazione. Se i motori sono disabilitati (tramite un comando M84 o M18), i motori dovranno essere nuovamente riposizionati prima del movimento. Se desideri spostare la testina dopo aver annullato una stampa tramite OctoPrint, considera di modificare la sequenza di annullamento di OctoPrint per farlo per te. \u00c8 configurato in OctoPrint tramite un browser web in: Impostazioni-> Script GCODE | Settings->GCODE Scripts Se desideri spostare la testina al termine di una stampa, considera di aggiungere il movimento desiderato alla sezione \"G-code personalizzato\" del tuo slicer. Se la stampante richiede un movimento aggiuntivo come parte del processo stesso di homing (o fondamentalmente non ha un processo di homing), considera l'utilizzo di una sezione safe_z_home o homing_override nel file di configurazione. Se \u00e8 necessario spostare uno stepper per scopi diagnostici o di debug, considerare l'aggiunta di una sezione force_move al file di configurazione. Vedere config reference per ulteriori dettagli su queste opzioni. Perch\u00e9 Z position_endstop \u00e8 impostato su 0.5 nelle configurazioni predefinite? \u00b6 Per le stampanti cartesiane Z position_endstop specifica la distanza dell'ugello dal piatto quando si attiva ilfinecorsa. Se possibile, si consiglia di utilizzare un finecorsa Z-max e di tornare a casa lontano dal piatto (in quanto ci\u00f2 riduce il rischio di collisioni con il piatto). Tuttavia, se ci si deve avvicinare al piatto, si consiglia di posizionare il finecorsa in modo che si attivi quando la bocchetta \u00e8 ancora a una piccola distanza dal piatto. In questo modo, durante l'homing dell'asse, si fermer\u00e0 prima che l'ugello tocchi il letto. Per ulteriori informazioni, vedere il bed level document . Ho convertito la mia configurazione da Marlin e gli assi X/Y funzionano bene, ma ottengo solo un rumore stridente durante homing dell'asse Z \u00b6 Risposta breve: in primo luogo, assicurati di aver verificato la configurazione dello stepper come descritto nel config check document . Se il problema persiste, provare a ridurre l'impostazione max_z_velocity nella configurazione della stampante. Risposta lunga: in pratica Marlin pu\u00f2 in genere fare solo un passo a una velocit\u00e0 di circa 10000 passi al secondo. Se gli viene richiesto di muoversi a una velocit\u00e0 che richiederebbe una velocit\u00e0 di passo pi\u00f9 alta, Marlin generalmente far\u00e0 un passo pi\u00f9 veloce possibile. Klipper \u00e8 in grado di raggiungere velocit\u00e0 di passo molto pi\u00f9 elevate, ma il motore passo-passo potrebbe non avere una coppia sufficiente per muoversi a una velocit\u00e0 pi\u00f9 elevata. Quindi, per un asse Z con un rapporto di trasmissione elevato o un'impostazione di micropassi elevata, l'effettiva velocit\u00e0 max_z_ottenibile potrebbe essere inferiore a quella configurata in Marlin. Il mio driver TMC del motore si spegne nel mezzo di una stampa \u00b6 Se si utilizza il driver TMC2208 (o TMC2224) in \"modalit\u00e0 standalone\", assicurarsi di utilizzare l' latest version of Klipper . Una soluzione alternativa per un problema del driver \"stealthchop\" TMC2208 \u00e8 stata aggiunta a Klipper a met\u00e0 marzo del 2020. Continuo a ricevere errori casuali \"Comunicazione persa con MCU\" |\"Lost communication with MCU\" \u00b6 Ci\u00f2 \u00e8 comunemente causato da errori hardware sulla connessione USB tra la macchina host e il microcontrollore. Cose da cercare: Utilizzare un cavo USB di buona qualit\u00e0 tra la macchina host e il microcontrollore. Assicurati che i connettori siano ben saldi. Se si utilizza un Raspberry Pi, utilizzare un alimentatore di buona qualit\u00e0 per il Raspberry Pi e utilizzare un cavo USB di buona qualit\u00e0 per collegare quell'alimentatore al Pi. Se ricevi avvisi di \"sottotensione\" da OctoPrint, questo \u00e8 correlato all'alimentatore e deve essere risolto. Assicurarsi che l'alimentazione della stampante non sia sovraccarica. (Le fluttuazioni di alimentazione del chip USB del microcontrollore possono comportare il reset di quel chip.) Verificare che i cavi dello stepper, del riscaldatore e di altri cavi della stampante non siano arricciati o sfilacciati. (Il movimento della stampante pu\u00f2 sollecitare un cavo difettoso causandone la perdita di contatto, un cortocircuito breve o la generazione di rumore eccessivo.) Sono stati segnalati rumori USB elevati quando sia l'alimentazione della stampante che l'alimentazione a 5 V dell'host sono mescolate. (Se si scopre che il microcontrollore si accende quando l'alimentazione della stampante \u00e8 accesa o il cavo USB \u00e8 collegato, significa che gli alimentatori da 5 V vengono mescolati.) Pu\u00f2 essere utile configurare il microcontrollore da utilizzare alimentazione da una sola fonte. (In alternativa, se la scheda del microcontrollore non \u00e8 in grado di configurare la sua fonte di alimentazione, \u00e8 possibile modificare un cavo USB in modo che non trasmetta alimentazione a 5V tra l'host e il microcontrollore.) Il mio Raspberry Pi continua a riavviarsi durante le stampe \u00b6 Questo \u00e8 molto probabilmente dovuto alle fluttuazioni di tensione. Segui gli stessi passaggi per la risoluzione dei problemi per un errore \"Comunicazione persa con MCU\" . Quando imposto restart_method=command il mio dispositivo AVR si blocca al riavvio \u00b6 Alcune vecchie versioni del bootloader AVR hanno un bug noto nella gestione degli eventi di watchdog. Questo in genere si manifesta quando il file printer.cfg ha restart_method impostato su \"command\". Quando si verifica il bug, il dispositivo AVR non risponder\u00e0 fino a quando l'alimentazione non viene rimossa e ricollegata al dispositivo (anche i LED di alimentazione o di stato potrebbero lampeggiare ripetutamente fino a quando l'alimentazione non viene rimossa). La soluzione alternativa \u00e8 utilizzare un restart_method diverso da \"command\" o eseguire il flashing di un bootloader aggiornato sul dispositivo AVR. Il flashing di un nuovo bootloader \u00e8 un passaggio che in genere richiede un programmatore esterno: vedere Bootloaders per ulteriori dettagli. I riscaldatori verranno lasciati accesi se il Raspberry Pi si arresta in modo anomalo? \u00b6 Il software \u00e8 stato progettato per impedirlo. Una volta che l'host abilita un riscaldatore, il software host deve confermare tale abilitazione ogni 5 secondi. Se il microcontrollore non riceve una conferma ogni 5 secondi, entra in uno stato di \"spegnimento\" progettato per spegnere tutti i riscaldatori e i motori passo-passo. Per ulteriori dettagli, vedere il comando \"config_digital_out\" nel documento Comandi MCU . Inoltre, il software del microcontrollore \u00e8 configurato con un intervallo di temperatura minimo e massimo per ciascun riscaldatore all'avvio (consultare i parametri min_temp e max_temp in config reference per i dettagli). Se il microcontrollore rileva che la temperatura \u00e8 al di fuori di tale intervallo, entrer\u00e0 anche in uno stato di \"spegnimento\". Separatamente, il software host implementa anche il codice per verificare che i riscaldatori e i sensori di temperatura funzionino correttamente. Vedere il riferimento di configurazione per ulteriori dettagli. Come posso convertire un numero di pin Marlin in un nome pin di Klipper? \u00b6 Risposta breve: una mappatura \u00e8 disponibile nel file sample-aliases.cfg . Usa quel file come guida per trovare i nomi effettivi dei pin del microcontrollorei. (\u00c8 anche possibile copiare la relativa sezione di configurazione board_pins nel file di configurazione e utilizzare gli alias nella configurazione, ma \u00e8 preferibile tradurre e utilizzare i nomi dei pin del microcontrollore effettivi.) Nota che il file sample-aliases.cfg usa nomi di pin che iniziano con il prefisso \"ar\" invece di \"D\" (ad esempio, il pin Arduino D23 \u00e8 alias Klipper ar23 ) e il prefisso \"analog\" invece di \"A \" (ad esempio, il pin Arduino A14 \u00e8 alias di Klipper analog14 ). Risposta lunga: Klipper utilizza i nomi dei pin standard definiti dal microcontrollore. Sui chip Atmega questi pin hardware hanno nomi come PA4 , PC7 o PD2 . Tempo fa, il progetto Arduino ha deciso di evitare di utilizzare i nomi hardware standard a favore dei propri nomi pin basati su numeri incrementali: questi nomi Arduino generalmente assomigliano a \"D23\" o \"A14\". Questa \u00e8 stata una scelta sfortunata che ha portato a una grande confusione. In particolare, i numeri dei pin di Arduino spesso non si traducono negli stessi nomi hardware. Ad esempio, D21 \u00e8 PD0 su una comune scheda Arduino, ma \u00e8 PC7 su un'altra comune scheda Arduino. Per evitare questa confusione, il codice di base di Klipper utilizza i nomi dei pin standard definiti dal microcontrollore. Devo collegare il mio dispositivo a un tipo specifico di pin del microcontrollore? \u00b6 Dipende dal tipo di dispositivo e dal tipo di pin: Pin ADC (o pin analogici): per termistori e sensori \"analogici\" simili, il dispositivo deve essere collegato a un pin compatibile con \"analogico\" o \"ADC\" sul microcontrollore. Se configuri Klipper per utilizzare un pin che non \u00e8 compatibile con l'analogico, Klipper segnaler\u00e0 un errore \"Non un pin ADC valido\". Pin PWM (o pin Timer): Klipper non utilizza PWM hardware per impostazione predefinita per nessun dispositivo. Quindi, in generale, \u00e8 possibile collegare riscaldatori, ventole e dispositivi simili a qualsiasi pin IO generico. Tuttavia, le ventole e i dispositivi output_pin possono essere opzionalmente configurati per utilizzare hardware_pwm: True , nel qual caso il microcontrollore deve supportare PWM hardware sul pin (altrimenti, Klipper segnaler\u00e0 un errore \"pin PWM non valido\"). Pin IRQ (o pin di interrupt): Klipper non utilizza gli interrupt hardware sui pin IO, quindi non \u00e8 mai necessario collegare un dispositivo a uno di questi pin del microcontrollore. Pin SPI: quando si utilizza l'SPI hardware, \u00e8 necessario collegare i pin ai pin SPI del microcontrollore. Tuttavia, la maggior parte dei dispositivi pu\u00f2 essere configurata per utilizzare \"SPI software\", nel qual caso \u00e8 possibile utilizzare qualsiasi pin IO generico. Pin I2C: quando si utilizza I2C \u00e8 necessario collegare i pin ai pin compatibili con I2C del microcontrollore. Altri dispositivi possono essere collegati a qualsiasi pin IO generico. Ad esempio, stepper, riscaldatori, ventole, sonde Z, servocomandi, LED, comuni display LCD hd44780/st7920, la linea di controllo Trinamic UART pu\u00f2 essere collegata a qualsiasi pin IO generico. Come posso annullare una richiesta di \"attesa temperatura\" M109/M190? \u00b6 Passare alla scheda del terminale OctoPrint ed emettere un comando M112 nel terminale. Il comando M112 far\u00e0 entrare Klipper in uno stato di \"arresto\" e causer\u00e0 la disconnessione di OctoPrint da Klipper. Passare all'area di connessione di OctoPrint e fare clic su \"Connetti\" per fare in modo che OctoPrint si riconnetta. Torna alla scheda del terminale ed emetti un comando FIRMWARE_RESTART per cancellare lo stato di errore di Klipper. Dopo aver completato questa sequenza, la precedente richiesta di riscaldamento verr\u00e0 annullata e potrebbe essere avviata una nuova stampa. Posso scoprire se la stampante ha perso dei passaggi? \u00b6 In un certo senso s\u00ec. Avviare la stampante, emettere un comando GET_POSITION , eseguire la stampa, tornare a casa ed emettere un altro GET_POSITION . Quindi confronta i valori nella riga mcu: . Questo potrebbe essere utile per regolare impostazioni come correnti, accelerazioni e velocit\u00e0 del motore passo-passo senza dover effettivamente stampare qualcosa e sprecare il filamento: basta eseguire alcuni movimenti ad alta velocit\u00e0 tra i comandi GET_POSITION . Si noti che gli stessi interruttori di fine corsa tendono a attivarsi in posizioni leggermente diverse, quindi una differenza di un paio di micropassi \u00e8 probabilmente il risultato di imprecisioni di fine corsa. Un motore passo-passo stesso pu\u00f2 perdere passi solo con incrementi di 4 passi completi. (Quindi, se si utilizzano 16 micropassi, un passo perso sullo stepper comporterebbe lo spegnimento del contatore di passi \"mcu:\" di un multiplo di 64 micropassi.) Perch\u00e9 Klipper segnala errori? Ho perso la mia stampa! \u00b6 Risposta breve: vogliamo sapere se le nostre stampanti rilevano un problema in modo che il problema sottostante possa essere risolto e possiamo ottenere stampe di ottima qualit\u00e0. Non vogliamo assolutamente che le nostre stampanti producano in silenzio stampe di bassa qualit\u00e0. Risposta lunga: Klipper \u00e8 stato progettato per risolvere automaticamente molti problemi transitori. Ad esempio, rileva automaticamente gli errori di comunicazione e li ritrasmette; pianifica le azioni in anticipo e bufferizza i comandi su pi\u00f9 livelli per consentire tempi precisi anche con interferenze intermittenti. Tuttavia, se il software rileva un errore dal quale non pu\u00f2 essere ripristinato, se gli viene ordinato di eseguire un'azione non valida o se rileva che \u00e8 irrimediabilmente incapace di eseguire l'attivit\u00e0 comandata, Klipper segnaler\u00e0 un errore. In queste situazioni c'\u00e8 un alto rischio di produrre una stampa di bassa qualit\u00e0 (o peggio). Si spera che avvisare gli utenti consentir\u00e0 loro di risolvere il problema sottostante e migliorare la qualit\u00e0 complessiva delle loro stampe. Ci sono alcune domande correlate: perch\u00e9 Klipper non mette invece in pausa la stampa? Segnalare invece un avviso? Verificare la presenza di errori prima della stampa? Ignorare gli errori nei comandi digitati dall'utente? eccetera? Attualmente Klipper legge i comandi utilizzando il protocollo G-Code e sfortunatamente il protocollo di comando G-Code non \u00e8 sufficientemente flessibile per rendere pratiche queste alternative oggi. C'\u00e8 l'interesse degli sviluppatori nel migliorare l'esperienza dell'utente durante eventi anomali, ma si prevede che ci\u00f2 richieder\u00e0 un notevole lavoro infrastrutturale (incluso un passaggio dal G-Code). Come si esegue l'aggiornamento al software pi\u00f9 recente? \u00b6 Il primo passaggio per l'aggiornamento del software consiste nell'esaminare l'ultimo documento config changes . A volte, vengono apportate modifiche al software che richiedono agli utenti di aggiornare le proprie impostazioni come parte di un aggiornamento del software. \u00c8 una buona idea rivedere questo documento prima dell'aggiornamento. Quando sei pronto per l'aggiornamento, il metodo generale \u00e8 quello di entrare in Raspberry Pi ed eseguire: cd ~/klipper git pull ~/klipper/scripts/install-octopi.sh Quindi si pu\u00f2 ricompilare e flashare il codice del microcontrollore. Per esempio: make menuconfig make clean make sudo service klipper stop make flash FLASH_DEVICE=/dev/ttyACM0 sudo service klipper start Tuttavia, capita spesso che cambi solo il software host. In questo caso \u00e8 possibile aggiornare e riavviare solo il software host con: cd ~/klipper git pull sudo service klipper restart Se dopo aver utilizzato questo collegamento il software avverte della necessit\u00e0 di eseguire il reflash del microcontrollore o si verifica qualche altro errore insolito, seguire i passaggi completi di aggiornamento descritti sopra. Se gli errori persistono, ricontrolla il documento config changes , poich\u00e9 potrebbe essere necessario modificare la configurazione della stampante. Si noti che i comandi g-code RESTART e FIRMWARE_RESTART non caricano il nuovo software: i comandi \"sudo service klipper restart\" e \"make flash\" di cui sopra sono necessari affinch\u00e9 una modifica del software abbia effetto. Come faccio a disinstallare Klipper? \u00b6 Dal alto del firmware, non deve succedere nulla di speciale. Basta seguire le indicazioni per il flashing del nuovo firmware. Dal lato del raspberry pi, uno script di disinstallazione \u00e8 disponibile in scripts/klipper-uninstall.sh . Per esempio: sudo ~/klipper/scripts/klipper-uninstall.sh rm -rf ~/klippy-env ~/klipper","title":"Domande frequenti"},{"location":"FAQ.html#domande-frequenti","text":"","title":"Domande frequenti"},{"location":"FAQ.html#come-posso-donare-al-progetto","text":"Grazie per il vostro sostegno. Per informazioni, vedere la Pagina degli sponsor .","title":"Come posso donare al progetto?"},{"location":"FAQ.html#come-faccio-a-calcolare-il-parametro-di-configurazione-rotation_distance","text":"Vedere il rotation distance document .","title":"Come faccio a calcolare il parametro di configurazione rotation_distance?"},{"location":"FAQ.html#dove-la-mia-porta-seriale","text":"Il modo generico per trovare una porta seriale USB \u00e8 eseguire ls /dev/serial/by-id/* da un terminale ssh sulla macchina host. Probabilmente produrr\u00e0 un output simile al seguente: /dev/serial/by-id/usb-1a86_USB2.0-Serial-if00-port0 Il nome trovato nel comando precedente \u00e8 stabile ed \u00e8 possibile utilizzarlo nel file di configurazione e durante il flashing del codice del microcontrollore. Ad esempio, un comando flash potrebbe essere simile a: sudo service klipper stop make flash FLASH_DEVICE=/dev/serial/by-id/usb-1a86_USB2.0-Serial-if00-port0 sudo service klipper start e la configurazione aggiornata potrebbe essere simile a: [mcu] serial: /dev/serial/by-id/usb-1a86_USB2.0-Serial-if00-port0 Assicurati di copiare e incollare il nome dal comando \"ls\" che hai eseguito sopra poich\u00e9 il nome sar\u00e0 diverso per ciascuna stampante. Se stai usando pi\u00f9 microcontrollori e non hanno ID univoci (comune sulle schede con un chip USB CH340), segui invece le indicazioni sopra usando il comando ls /dev/serial/by-path/* .","title":"Dov'\u00e8 la mia porta seriale?"},{"location":"FAQ.html#quando-il-microcontrollore-si-riavvia-il-dispositivo-cambia-in-devttyusb1","text":"egui le istruzioni nella sezione \" Where's my serial port? \" per evitare che ci\u00f2 accada.","title":"Quando il microcontrollore si riavvia, il dispositivo cambia in /dev/ttyUSB1"},{"location":"FAQ.html#il-comando-make-flash-non-funziona","text":"Il codice tenta di eseguire il flashing del dispositivo utilizzando il metodo pi\u00f9 comune per ciascuna piattaforma. Sfortunatamente, c'\u00e8 molta variabilit\u00e0 nei metodi di flashing, quindi il comando \"make flash\" potrebbe non funzionare su tutte le schede. Se si verifica un errore intermittente o si dispone di una configurazione standard, ricontrolla che Klipper non sia in esecuzione durante il flashing (sudo service klipper stop), assicurati che OctoPrint non stia tentando di connettersi direttamente al dispositivo (apri il scheda Connessione nella pagina Web e fare clic su Disconnetti se la porta seriale \u00e8 impostata sul dispositivo) e assicurarsi che FLASH_DEVICE sia impostato correttamente per la scheda (consultare la question above . Tuttavia, se \"make flash\" non funziona per la tua scheda, dovrai eseguire il flashing manualmente. Verificare se nella config directory \u00e8 presente un file di configurazione con istruzioni specifiche per il flashing del dispositivo. Inoltre, controlla la documentazione del produttore della scheda per vedere se descrive come eseguire il flashing del dispositivo. Infine, potrebbe essere possibile eseguire manualmente il flashing del dispositivo utilizzando strumenti come \"avrdude\" o \"bossac\" - vedere il bootloader document per ulteriori informazioni.","title":"Il comando \"make flash\" non funziona"},{"location":"FAQ.html#come-posso-modificare-la-velocita-di-trasmissione-seriale","text":"Il baud rate consigliato per Klipper \u00e8 250000. Questo baud rate funziona bene su tutte le schede di microcontrollore supportate da Klipper. Se hai trovato una guida online che consiglia una velocit\u00e0 di trasmissione diversa, ignora quella parte della guida e continua con il valore predefinito di 250000. Se si desidera comunque modificare il baud rate, sar\u00e0 necessario configurare la nuova velocit\u00e0 nel microcontrollore (durante make menuconfig ) e il codice aggiornato dovr\u00e0 essere compilato e flashato sul microcontrollore. Anche il file Klipper printer.cfg dovr\u00e0 essere aggiornato in modo che corrisponda a tale velocit\u00e0 di trasmissione (consultare il config reference per i dettagli). Per esempio: [mcu] baud: 250000 La velocit\u00e0 di trasmissione mostrata sulla pagina Web di OctoPrint non ha alcun impatto sulla velocit\u00e0 di trasmissione interna del microcontrollore Klipper. Impostare sempre la velocit\u00e0 di trasmissione OctoPrint su 250000 quando si utilizza Klipper. La velocit\u00e0 in baud del microcontrollore Klipper non \u00e8 correlata alla velocit\u00e0 in baud del bootloader del microcontrollore. Vedere il bootloader document per ulteriori informazioni sui bootloader.","title":"Come posso modificare la velocit\u00e0 di trasmissione seriale?"},{"location":"FAQ.html#posso-eseguire-klipper-su-qualcosa-di-diverso-da-un-raspberry-pi-3","text":"L'hardware consigliato \u00e8 un Raspberry Pi 2, Raspberry Pi 3 o Raspberry Pi 4. Klipper funzioner\u00e0 su un Raspberry Pi 1 e su Raspberry Pi Zero, ma queste schede non hanno una potenza di elaborazione sufficiente per eseguire bene OctoPrint. \u00c8 normale che si verifichino interruzioni di stampa su queste macchine pi\u00f9 lente quando si stampa direttamente da OctoPrint. (La stampante potrebbe muoversi pi\u00f9 velocemente di quanto OctoPrint possa inviare comandi di movimento.) Se desideri comunque eseguire su una di queste schede pi\u00f9 lente, considera l'utilizzo della funzione \"virtual_sdcard\" durante la stampa (consulta config reference per dettagli). Per l'esecuzione su Beaglebone, vedere le Istruzioni di installazione specifiche di Beaglebone . Klipper \u00e8 stato eseguito su altre macchine. Il software host Klipper richiede solo Python in esecuzione su un computer Linux (o simile). Tuttavia, se desideri eseguirlo su una macchina diversa, avrai bisogno della conoscenza dell'amministratore Linux per installare i prerequisiti di sistema per quella particolare macchina. Consulta lo script install-octopi.sh per ulteriori informazioni sui passaggi necessari. Se stai cercando di eseguire il software host Klipper su un chip di fascia bassa, tieni presente che, come minimo, \u00e8 necessaria una macchina con hardware a \"virgola mobile a doppia precisione\". Se stai cercando di eseguire il software host Klipper su un desktop generico condiviso o una macchina di classe server, tieni presente che Klipper ha alcuni requisiti di scheduling in tempo reale. Se, durante una stampa, il computer host esegue anche un'intensa attivit\u00e0 di elaborazione generica (come deframmentazione di un disco rigido, rendering 3D, scambi pesanti e cos\u00ec via), Klipper potrebbe segnalare errori di stampa. Nota: se non stai utilizzando un'immagine OctoPi, tieni presente che diverse distribuzioni Linux abilitano un pacchetto \"ModemManager\" (o simile) che pu\u00f2 interrompere la comunicazione seriale. (Il che pu\u00f2 far s\u00ec che Klipper riporti errori apparentemente casuali \"Comunicazione persa con MCU\".) Se installi Klipper su una di queste distribuzioni potresti dover disabilitare quel pacchetto.","title":"Posso eseguire Klipper su qualcosa di diverso da un Raspberry Pi 3?"},{"location":"FAQ.html#posso-eseguire-piu-istanze-di-klipper-sulla-stessa-macchina-host","text":"\u00c8 possibile eseguire pi\u00f9 istanze del software host Klipper, ma per farlo \u00e8 necessaria la conoscenza dell'amministratore Linux. Gli script di installazione di Klipper determinano l'esecuzione del seguente comando Unix: ~/klippy-env/bin/python ~/klipper/klippy/klippy.py ~/printer.cfg -l /tmp/klippy.log \u00c8 possibile eseguire pi\u00f9 istanze del comando precedente purch\u00e9 ogni istanza abbia il proprio file di configurazione della stampante, il proprio file di registro e il proprio pseudo-tty. Per esempio: ~/klippy-env/bin/python ~/klipper/klippy/klippy.py ~/printer2.cfg -l /tmp/klippy2.log -I /tmp/printer2 Se scegli di farlo, dovrai implementare gli script di avvio, arresto e installazione necessari (se presenti). Lo script install-octopi.sh e lo script klipper-start.sh possono essere utili come esempi.","title":"Posso eseguire pi\u00f9 istanze di Klipper sulla stessa macchina host?"},{"location":"FAQ.html#devo-usare-octoprint","text":"Il software Klipper non dipende da OctoPrint. \u00c8 possibile utilizzare un software alternativo per inviare comandi a Klipper, ma ci\u00f2 richiede la conoscenza dell'amministratore Linux. Klipper crea una \"porta seriale virtuale\" tramite il file \"/tmp/printer\" ed emula una classica interfaccia seriale per stampante 3D tramite quel file. In generale, un software alternativo pu\u00f2 funzionare con Klipper purch\u00e9 possa essere configurato per utilizzare \"/tmp/printer\" per la porta seriale della stampante.","title":"Devo usare OctoPrint?"},{"location":"FAQ.html#perche-non-riesco-a-spostare-lo-stepper-prima-di-riposizionare-la-stampante","text":"Il codice fa questo per ridurre la possibilit\u00e0 di comandare accidentalmente la testa nel piatto o altri limiti. Una volta che la stampante \u00e8 stata localizzata, il software tenta di verificare che ogni mossa rientri nella posizione_min/max definita nel file di configurazione. Se i motori sono disabilitati (tramite un comando M84 o M18), i motori dovranno essere nuovamente riposizionati prima del movimento. Se desideri spostare la testina dopo aver annullato una stampa tramite OctoPrint, considera di modificare la sequenza di annullamento di OctoPrint per farlo per te. \u00c8 configurato in OctoPrint tramite un browser web in: Impostazioni-> Script GCODE | Settings->GCODE Scripts Se desideri spostare la testina al termine di una stampa, considera di aggiungere il movimento desiderato alla sezione \"G-code personalizzato\" del tuo slicer. Se la stampante richiede un movimento aggiuntivo come parte del processo stesso di homing (o fondamentalmente non ha un processo di homing), considera l'utilizzo di una sezione safe_z_home o homing_override nel file di configurazione. Se \u00e8 necessario spostare uno stepper per scopi diagnostici o di debug, considerare l'aggiunta di una sezione force_move al file di configurazione. Vedere config reference per ulteriori dettagli su queste opzioni.","title":"Perch\u00e9 non riesco a spostare lo stepper prima di riposizionare la stampante?"},{"location":"FAQ.html#perche-z-position_endstop-e-impostato-su-05-nelle-configurazioni-predefinite","text":"Per le stampanti cartesiane Z position_endstop specifica la distanza dell'ugello dal piatto quando si attiva ilfinecorsa. Se possibile, si consiglia di utilizzare un finecorsa Z-max e di tornare a casa lontano dal piatto (in quanto ci\u00f2 riduce il rischio di collisioni con il piatto). Tuttavia, se ci si deve avvicinare al piatto, si consiglia di posizionare il finecorsa in modo che si attivi quando la bocchetta \u00e8 ancora a una piccola distanza dal piatto. In questo modo, durante l'homing dell'asse, si fermer\u00e0 prima che l'ugello tocchi il letto. Per ulteriori informazioni, vedere il bed level document .","title":"Perch\u00e9 Z position_endstop \u00e8 impostato su 0.5 nelle configurazioni predefinite?"},{"location":"FAQ.html#ho-convertito-la-mia-configurazione-da-marlin-e-gli-assi-xy-funzionano-bene-ma-ottengo-solo-un-rumore-stridente-durante-homing-dellasse-z","text":"Risposta breve: in primo luogo, assicurati di aver verificato la configurazione dello stepper come descritto nel config check document . Se il problema persiste, provare a ridurre l'impostazione max_z_velocity nella configurazione della stampante. Risposta lunga: in pratica Marlin pu\u00f2 in genere fare solo un passo a una velocit\u00e0 di circa 10000 passi al secondo. Se gli viene richiesto di muoversi a una velocit\u00e0 che richiederebbe una velocit\u00e0 di passo pi\u00f9 alta, Marlin generalmente far\u00e0 un passo pi\u00f9 veloce possibile. Klipper \u00e8 in grado di raggiungere velocit\u00e0 di passo molto pi\u00f9 elevate, ma il motore passo-passo potrebbe non avere una coppia sufficiente per muoversi a una velocit\u00e0 pi\u00f9 elevata. Quindi, per un asse Z con un rapporto di trasmissione elevato o un'impostazione di micropassi elevata, l'effettiva velocit\u00e0 max_z_ottenibile potrebbe essere inferiore a quella configurata in Marlin.","title":"Ho convertito la mia configurazione da Marlin e gli assi X/Y funzionano bene, ma ottengo solo un rumore stridente durante homing dell'asse Z"},{"location":"FAQ.html#il-mio-driver-tmc-del-motore-si-spegne-nel-mezzo-di-una-stampa","text":"Se si utilizza il driver TMC2208 (o TMC2224) in \"modalit\u00e0 standalone\", assicurarsi di utilizzare l' latest version of Klipper . Una soluzione alternativa per un problema del driver \"stealthchop\" TMC2208 \u00e8 stata aggiunta a Klipper a met\u00e0 marzo del 2020.","title":"Il mio driver TMC del motore si spegne nel mezzo di una stampa"},{"location":"FAQ.html#continuo-a-ricevere-errori-casuali-comunicazione-persa-con-mcu-lost-communication-with-mcu","text":"Ci\u00f2 \u00e8 comunemente causato da errori hardware sulla connessione USB tra la macchina host e il microcontrollore. Cose da cercare: Utilizzare un cavo USB di buona qualit\u00e0 tra la macchina host e il microcontrollore. Assicurati che i connettori siano ben saldi. Se si utilizza un Raspberry Pi, utilizzare un alimentatore di buona qualit\u00e0 per il Raspberry Pi e utilizzare un cavo USB di buona qualit\u00e0 per collegare quell'alimentatore al Pi. Se ricevi avvisi di \"sottotensione\" da OctoPrint, questo \u00e8 correlato all'alimentatore e deve essere risolto. Assicurarsi che l'alimentazione della stampante non sia sovraccarica. (Le fluttuazioni di alimentazione del chip USB del microcontrollore possono comportare il reset di quel chip.) Verificare che i cavi dello stepper, del riscaldatore e di altri cavi della stampante non siano arricciati o sfilacciati. (Il movimento della stampante pu\u00f2 sollecitare un cavo difettoso causandone la perdita di contatto, un cortocircuito breve o la generazione di rumore eccessivo.) Sono stati segnalati rumori USB elevati quando sia l'alimentazione della stampante che l'alimentazione a 5 V dell'host sono mescolate. (Se si scopre che il microcontrollore si accende quando l'alimentazione della stampante \u00e8 accesa o il cavo USB \u00e8 collegato, significa che gli alimentatori da 5 V vengono mescolati.) Pu\u00f2 essere utile configurare il microcontrollore da utilizzare alimentazione da una sola fonte. (In alternativa, se la scheda del microcontrollore non \u00e8 in grado di configurare la sua fonte di alimentazione, \u00e8 possibile modificare un cavo USB in modo che non trasmetta alimentazione a 5V tra l'host e il microcontrollore.)","title":"Continuo a ricevere errori casuali \"Comunicazione persa con MCU\" |\"Lost communication with MCU\""},{"location":"FAQ.html#il-mio-raspberry-pi-continua-a-riavviarsi-durante-le-stampe","text":"Questo \u00e8 molto probabilmente dovuto alle fluttuazioni di tensione. Segui gli stessi passaggi per la risoluzione dei problemi per un errore \"Comunicazione persa con MCU\" .","title":"Il mio Raspberry Pi continua a riavviarsi durante le stampe"},{"location":"FAQ.html#quando-imposto-restart_methodcommand-il-mio-dispositivo-avr-si-blocca-al-riavvio","text":"Alcune vecchie versioni del bootloader AVR hanno un bug noto nella gestione degli eventi di watchdog. Questo in genere si manifesta quando il file printer.cfg ha restart_method impostato su \"command\". Quando si verifica il bug, il dispositivo AVR non risponder\u00e0 fino a quando l'alimentazione non viene rimossa e ricollegata al dispositivo (anche i LED di alimentazione o di stato potrebbero lampeggiare ripetutamente fino a quando l'alimentazione non viene rimossa). La soluzione alternativa \u00e8 utilizzare un restart_method diverso da \"command\" o eseguire il flashing di un bootloader aggiornato sul dispositivo AVR. Il flashing di un nuovo bootloader \u00e8 un passaggio che in genere richiede un programmatore esterno: vedere Bootloaders per ulteriori dettagli.","title":"Quando imposto restart_method=command il mio dispositivo AVR si blocca al riavvio"},{"location":"FAQ.html#i-riscaldatori-verranno-lasciati-accesi-se-il-raspberry-pi-si-arresta-in-modo-anomalo","text":"Il software \u00e8 stato progettato per impedirlo. Una volta che l'host abilita un riscaldatore, il software host deve confermare tale abilitazione ogni 5 secondi. Se il microcontrollore non riceve una conferma ogni 5 secondi, entra in uno stato di \"spegnimento\" progettato per spegnere tutti i riscaldatori e i motori passo-passo. Per ulteriori dettagli, vedere il comando \"config_digital_out\" nel documento Comandi MCU . Inoltre, il software del microcontrollore \u00e8 configurato con un intervallo di temperatura minimo e massimo per ciascun riscaldatore all'avvio (consultare i parametri min_temp e max_temp in config reference per i dettagli). Se il microcontrollore rileva che la temperatura \u00e8 al di fuori di tale intervallo, entrer\u00e0 anche in uno stato di \"spegnimento\". Separatamente, il software host implementa anche il codice per verificare che i riscaldatori e i sensori di temperatura funzionino correttamente. Vedere il riferimento di configurazione per ulteriori dettagli.","title":"I riscaldatori verranno lasciati accesi se il Raspberry Pi si arresta in modo anomalo?"},{"location":"FAQ.html#come-posso-convertire-un-numero-di-pin-marlin-in-un-nome-pin-di-klipper","text":"Risposta breve: una mappatura \u00e8 disponibile nel file sample-aliases.cfg . Usa quel file come guida per trovare i nomi effettivi dei pin del microcontrollorei. (\u00c8 anche possibile copiare la relativa sezione di configurazione board_pins nel file di configurazione e utilizzare gli alias nella configurazione, ma \u00e8 preferibile tradurre e utilizzare i nomi dei pin del microcontrollore effettivi.) Nota che il file sample-aliases.cfg usa nomi di pin che iniziano con il prefisso \"ar\" invece di \"D\" (ad esempio, il pin Arduino D23 \u00e8 alias Klipper ar23 ) e il prefisso \"analog\" invece di \"A \" (ad esempio, il pin Arduino A14 \u00e8 alias di Klipper analog14 ). Risposta lunga: Klipper utilizza i nomi dei pin standard definiti dal microcontrollore. Sui chip Atmega questi pin hardware hanno nomi come PA4 , PC7 o PD2 . Tempo fa, il progetto Arduino ha deciso di evitare di utilizzare i nomi hardware standard a favore dei propri nomi pin basati su numeri incrementali: questi nomi Arduino generalmente assomigliano a \"D23\" o \"A14\". Questa \u00e8 stata una scelta sfortunata che ha portato a una grande confusione. In particolare, i numeri dei pin di Arduino spesso non si traducono negli stessi nomi hardware. Ad esempio, D21 \u00e8 PD0 su una comune scheda Arduino, ma \u00e8 PC7 su un'altra comune scheda Arduino. Per evitare questa confusione, il codice di base di Klipper utilizza i nomi dei pin standard definiti dal microcontrollore.","title":"Come posso convertire un numero di pin Marlin in un nome pin di Klipper?"},{"location":"FAQ.html#devo-collegare-il-mio-dispositivo-a-un-tipo-specifico-di-pin-del-microcontrollore","text":"Dipende dal tipo di dispositivo e dal tipo di pin: Pin ADC (o pin analogici): per termistori e sensori \"analogici\" simili, il dispositivo deve essere collegato a un pin compatibile con \"analogico\" o \"ADC\" sul microcontrollore. Se configuri Klipper per utilizzare un pin che non \u00e8 compatibile con l'analogico, Klipper segnaler\u00e0 un errore \"Non un pin ADC valido\". Pin PWM (o pin Timer): Klipper non utilizza PWM hardware per impostazione predefinita per nessun dispositivo. Quindi, in generale, \u00e8 possibile collegare riscaldatori, ventole e dispositivi simili a qualsiasi pin IO generico. Tuttavia, le ventole e i dispositivi output_pin possono essere opzionalmente configurati per utilizzare hardware_pwm: True , nel qual caso il microcontrollore deve supportare PWM hardware sul pin (altrimenti, Klipper segnaler\u00e0 un errore \"pin PWM non valido\"). Pin IRQ (o pin di interrupt): Klipper non utilizza gli interrupt hardware sui pin IO, quindi non \u00e8 mai necessario collegare un dispositivo a uno di questi pin del microcontrollore. Pin SPI: quando si utilizza l'SPI hardware, \u00e8 necessario collegare i pin ai pin SPI del microcontrollore. Tuttavia, la maggior parte dei dispositivi pu\u00f2 essere configurata per utilizzare \"SPI software\", nel qual caso \u00e8 possibile utilizzare qualsiasi pin IO generico. Pin I2C: quando si utilizza I2C \u00e8 necessario collegare i pin ai pin compatibili con I2C del microcontrollore. Altri dispositivi possono essere collegati a qualsiasi pin IO generico. Ad esempio, stepper, riscaldatori, ventole, sonde Z, servocomandi, LED, comuni display LCD hd44780/st7920, la linea di controllo Trinamic UART pu\u00f2 essere collegata a qualsiasi pin IO generico.","title":"Devo collegare il mio dispositivo a un tipo specifico di pin del microcontrollore?"},{"location":"FAQ.html#come-posso-annullare-una-richiesta-di-attesa-temperatura-m109m190","text":"Passare alla scheda del terminale OctoPrint ed emettere un comando M112 nel terminale. Il comando M112 far\u00e0 entrare Klipper in uno stato di \"arresto\" e causer\u00e0 la disconnessione di OctoPrint da Klipper. Passare all'area di connessione di OctoPrint e fare clic su \"Connetti\" per fare in modo che OctoPrint si riconnetta. Torna alla scheda del terminale ed emetti un comando FIRMWARE_RESTART per cancellare lo stato di errore di Klipper. Dopo aver completato questa sequenza, la precedente richiesta di riscaldamento verr\u00e0 annullata e potrebbe essere avviata una nuova stampa.","title":"Come posso annullare una richiesta di \"attesa temperatura\" M109/M190?"},{"location":"FAQ.html#posso-scoprire-se-la-stampante-ha-perso-dei-passaggi","text":"In un certo senso s\u00ec. Avviare la stampante, emettere un comando GET_POSITION , eseguire la stampa, tornare a casa ed emettere un altro GET_POSITION . Quindi confronta i valori nella riga mcu: . Questo potrebbe essere utile per regolare impostazioni come correnti, accelerazioni e velocit\u00e0 del motore passo-passo senza dover effettivamente stampare qualcosa e sprecare il filamento: basta eseguire alcuni movimenti ad alta velocit\u00e0 tra i comandi GET_POSITION . Si noti che gli stessi interruttori di fine corsa tendono a attivarsi in posizioni leggermente diverse, quindi una differenza di un paio di micropassi \u00e8 probabilmente il risultato di imprecisioni di fine corsa. Un motore passo-passo stesso pu\u00f2 perdere passi solo con incrementi di 4 passi completi. (Quindi, se si utilizzano 16 micropassi, un passo perso sullo stepper comporterebbe lo spegnimento del contatore di passi \"mcu:\" di un multiplo di 64 micropassi.)","title":"Posso scoprire se la stampante ha perso dei passaggi?"},{"location":"FAQ.html#perche-klipper-segnala-errori-ho-perso-la-mia-stampa","text":"Risposta breve: vogliamo sapere se le nostre stampanti rilevano un problema in modo che il problema sottostante possa essere risolto e possiamo ottenere stampe di ottima qualit\u00e0. Non vogliamo assolutamente che le nostre stampanti producano in silenzio stampe di bassa qualit\u00e0. Risposta lunga: Klipper \u00e8 stato progettato per risolvere automaticamente molti problemi transitori. Ad esempio, rileva automaticamente gli errori di comunicazione e li ritrasmette; pianifica le azioni in anticipo e bufferizza i comandi su pi\u00f9 livelli per consentire tempi precisi anche con interferenze intermittenti. Tuttavia, se il software rileva un errore dal quale non pu\u00f2 essere ripristinato, se gli viene ordinato di eseguire un'azione non valida o se rileva che \u00e8 irrimediabilmente incapace di eseguire l'attivit\u00e0 comandata, Klipper segnaler\u00e0 un errore. In queste situazioni c'\u00e8 un alto rischio di produrre una stampa di bassa qualit\u00e0 (o peggio). Si spera che avvisare gli utenti consentir\u00e0 loro di risolvere il problema sottostante e migliorare la qualit\u00e0 complessiva delle loro stampe. Ci sono alcune domande correlate: perch\u00e9 Klipper non mette invece in pausa la stampa? Segnalare invece un avviso? Verificare la presenza di errori prima della stampa? Ignorare gli errori nei comandi digitati dall'utente? eccetera? Attualmente Klipper legge i comandi utilizzando il protocollo G-Code e sfortunatamente il protocollo di comando G-Code non \u00e8 sufficientemente flessibile per rendere pratiche queste alternative oggi. C'\u00e8 l'interesse degli sviluppatori nel migliorare l'esperienza dell'utente durante eventi anomali, ma si prevede che ci\u00f2 richieder\u00e0 un notevole lavoro infrastrutturale (incluso un passaggio dal G-Code).","title":"Perch\u00e9 Klipper segnala errori? Ho perso la mia stampa!"},{"location":"FAQ.html#come-si-esegue-laggiornamento-al-software-piu-recente","text":"Il primo passaggio per l'aggiornamento del software consiste nell'esaminare l'ultimo documento config changes . A volte, vengono apportate modifiche al software che richiedono agli utenti di aggiornare le proprie impostazioni come parte di un aggiornamento del software. \u00c8 una buona idea rivedere questo documento prima dell'aggiornamento. Quando sei pronto per l'aggiornamento, il metodo generale \u00e8 quello di entrare in Raspberry Pi ed eseguire: cd ~/klipper git pull ~/klipper/scripts/install-octopi.sh Quindi si pu\u00f2 ricompilare e flashare il codice del microcontrollore. Per esempio: make menuconfig make clean make sudo service klipper stop make flash FLASH_DEVICE=/dev/ttyACM0 sudo service klipper start Tuttavia, capita spesso che cambi solo il software host. In questo caso \u00e8 possibile aggiornare e riavviare solo il software host con: cd ~/klipper git pull sudo service klipper restart Se dopo aver utilizzato questo collegamento il software avverte della necessit\u00e0 di eseguire il reflash del microcontrollore o si verifica qualche altro errore insolito, seguire i passaggi completi di aggiornamento descritti sopra. Se gli errori persistono, ricontrolla il documento config changes , poich\u00e9 potrebbe essere necessario modificare la configurazione della stampante. Si noti che i comandi g-code RESTART e FIRMWARE_RESTART non caricano il nuovo software: i comandi \"sudo service klipper restart\" e \"make flash\" di cui sopra sono necessari affinch\u00e9 una modifica del software abbia effetto.","title":"Come si esegue l'aggiornamento al software pi\u00f9 recente?"},{"location":"FAQ.html#come-faccio-a-disinstallare-klipper","text":"Dal alto del firmware, non deve succedere nulla di speciale. Basta seguire le indicazioni per il flashing del nuovo firmware. Dal lato del raspberry pi, uno script di disinstallazione \u00e8 disponibile in scripts/klipper-uninstall.sh . Per esempio: sudo ~/klipper/scripts/klipper-uninstall.sh rm -rf ~/klippy-env ~/klipper","title":"Come faccio a disinstallare Klipper?"},{"location":"Features.html","text":"Caratteristiche \u00b6 Klipper ha diverse caratteristiche interessanti: Movimento passo-passo di alta precisione. Klipper utilizza un processore applicativo (come un Raspberry Pi a basso costo) per calcolare i movimenti della stampante. Il processore dell'applicazione determina quando far avanzare ciascun motore passo-passo, comprime quegli eventi, li trasmette al microcontrollore e quindi il microcontrollore esegue ogni evento all'ora richiesta. Ogni evento stepper \u00e8 programmato con una precisione di 25 microsecondi o superiore. Il software non utilizza stime cinematiche (come l'algoritmo di Bresenham), ma calcola tempi di passo precisi in base alla fisica dell'accelerazione e alla fisica della cinematica della macchina. Il movimento passo-passo pi\u00f9 preciso garantisce un funzionamento della stampante pi\u00f9 silenzioso e stabile. Le migliori prestazioni della classe. Klipper \u00e8 in grado di raggiungere elevate velocit\u00e0 di stepping su microcontrollori nuovi e vecchi. Anche i vecchi microcontrollori a 8 bit possono ottenere velocit\u00e0 di oltre 175.000 passi al secondo. Sui microcontrollori pi\u00f9 recenti sono possibili diversi milioni di passi al secondo. Velocit\u00e0 stepper pi\u00f9 elevate consentono velocit\u00e0 di stampa pi\u00f9 elevate. Il timing dell'evento stepper rimane preciso anche a velocit\u00e0 elevate, migliorando la stabilit\u00e0 generale. Klipper supporta stampanti con pi\u00f9 microcontrollori. Ad esempio, un microcontrollore potrebbe essere utilizzato per controllare un estrusore, mentre un altro controlla i riscaldatori della stampante, mentre un terzo controlla il resto della stampante. Il software host Klipper implementa la sincronizzazione dell'orologio per tenere conto della deriva dell'orologio tra i microcontrollori. Non \u00e8 necessario alcun codice speciale per abilitare pi\u00f9 microcontrollori: sono necessarie solo alcune righe in pi\u00f9 nel file di configurazione. Configurazione tramite semplice file. Non \u00e8 necessario eseguire il reflash del microcontrollore per modificare un'impostazione. Tutta la configurazione di Klipper \u00e8 memorizzata in un file di configurazione standard che pu\u00f2 essere facilmente modificato. Ci\u00f2 semplifica la configurazione e la manutenzione dell'hardware. Klipper supporta \"Smooth Pressure Advance\", un meccanismo per tenere conto degli effetti della pressione all'interno di un estrusore. Ci\u00f2 riduce la \"melma\" dell'estrusore e migliora la qualit\u00e0 degli angoli di stampa. L'implementazione di Klipper non introduce variazioni istantanee della velocit\u00e0 dell'estrusore, il che migliora la stabilit\u00e0 e la robustezza complessive. Klipper supporta \"Input Shaping\" per ridurre l'impatto delle vibrazioni sulla qualit\u00e0 di stampa. Ci\u00f2 pu\u00f2 ridurre o eliminare il \"ringing\" (noto anche come \"ghosting\", \"eco\" o \"increspatura\") nelle stampe. Pu\u00f2 anche consentire di ottenere velocit\u00e0 di stampa pi\u00f9 elevate pur mantenendo un'elevata qualit\u00e0 di stampa. Klipper utilizza un \"risolutore iterativo\" per calcolare sequenze temporali precisi da semplici equazioni cinematiche. Ci\u00f2 semplifica il porting di Klipper su nuovi tipi di robot e mantiene i tempi precisi anche con cinematiche complesse (non \u00e8 necessaria la \"segmentazione della linea\"). Klipper \u00e8 indipendente dall'hardware. Si dovrebbe ottenere la stessa tempistica precisa indipendentemente dall'hardware dell'elettronica di basso livello. Il codice del microcontrollore Klipper \u00e8 progettato per seguire fedelmente la pianificazione fornita dal software host Klipper (o avvisare in modo evidente l'utente se non \u00e8 in grado di farlo). Ci\u00f2 semplifica l'utilizzo dell'hardware disponibile, l'aggiornamento al nuovo hardware e la fiducia nell'hardware. Codice portatile. Klipper funziona su microcontrollori basati su ARM, AVR e PRU. Le stampanti esistenti in stile \"reprap\" possono eseguire Klipper senza modifiche hardware: basta aggiungere un Raspberry Pi. Il layout del codice interno di Klipper semplifica il supporto anche di altre architetture di microcontrollori. Codice pi\u00f9 semplice. Klipper utilizza un linguaggio di alto livello (Python) per la maggior parte del codice. Gli algoritmi cinematici, l'analisi del G-code, gli algoritmi di riscaldamento e termistore, ecc. sono tutti scritti in Python. Ci\u00f2 semplifica lo sviluppo di nuove funzionalit\u00e0. Macro programmabili personalizzate. \u00c8 possibile definire nuovi comandi G-Code nel file di configurazione della stampante (non sono necessarie modifiche al codice). Questi comandi sono programmabili, consentendo loro di produrre azioni diverse a seconda dello stato della stampante. Server API integrato. Oltre all'interfaccia G-Code standard, Klipper supporta una ricca interfaccia applicativa basata su JSON. Ci\u00f2 consente ai programmatori di creare applicazioni esterne con un controllo dettagliato della stampante. Caratteristiche aggiuntive \u00b6 Klipper supporta molte funzionalit\u00e0 standard della stampante 3D: Diverse interfacce web disponibili. Funziona con Randa, Fluidd, OctoPrint e altri. Ci\u00f2 consente di controllare la stampante utilizzando un normale browser web. Lo stesso Raspberry Pi che esegue Klipper pu\u00f2 anche eseguire l'interfaccia web. Supporto G-code standard. Sono supportati i comandi G-code comuni prodotti dai tipici \"slicer\" (SuperSlicer, Cura, PrusaSlicer, ecc.). Supporto per pi\u00f9 estrusori. Sono supportati anche estrusori con riscaldatori condivisi ed estrusori su carrelli indipendenti (IDEX). Supporto per stampanti cartesiane, delta, corexy, corexz, hybrid-corexy, hybrid-corexz, deltesian, rotary delta, polar e cable winch. Supporto per il livellamento automatico del letto. Klipper pu\u00f2 essere configurato per il rilevamento di base dell'inclinazione del piatto o per il livellamento del piatto a mesh completa. Se il piatto utilizza pi\u00f9 stepper Z, Klipper pu\u00f2 anche livellare manipolando in modo indipendente gli stepper Z. Sono supportate la maggior parte delle sonde di altezza Z, comprese le sonde BL-Touch e le sonde servoattivate. Supporto per la calibrazione delta automatica. Lo strumento di calibrazione pu\u00f2 eseguire la calibrazione dell'altezza di base e una calibrazione avanzata delle dimensioni X e Y. La calibrazione pu\u00f2 essere eseguita con una sonda di altezza Z o tramite tastatura manuale. Supporto \"escludi oggetto\" in fase di esecuzione. Se configurato, questo modulo pu\u00f2 facilitare l'annullamento di un solo oggetto in una stampa multiparte. Supporto per sensori di temperatura comuni (ad es. termistori comuni, AD595, AD597, AD849x, PT100, PT1000, MAX6675, MAX31855, MAX31856, MAX31865, BME280, HTU21D, DS18B20 e LM75). \u00c8 inoltre possibile configurare termistori personalizzati e sensori di temperatura analogici personalizzati. \u00c8 possibile monitorare il sensore di temperatura del microcontrollore interno e il sensore di temperatura interna di un Raspberry Pi. Protezione del riscaldatore termico di base abilitata di default. Supporto per ventole standard, ventole per ugelli e ventole a temperatura controllata. Non \u00e8 necessario mantenere le ventole in funzione quando la stampante \u00e8 inattiva. La velocit\u00e0 della ventola pu\u00f2 essere monitorata su ventole dotate di contagiri. Supporto per la configurazione in fase di esecuzione dei driver per motori passo-passo TMC2130, TMC2208/TMC2224, TMC2209, TMC2660 e TMC5160. \u00c8 inoltre disponibile il supporto per il controllo corrente dei tradizionali driver passo-passo tramite i pin AD5206, DAC084S085, MCP4451, MCP4728, MCP4018 e PWM. Supporto per comuni display LCD collegati direttamente alla stampante. \u00c8 disponibile anche un menu predefinito. Il contenuto del display e del menu pu\u00f2 essere completamente personalizzato tramite il file di configurazione. Accelerazione costante e supporto \"look-ahead\". Tutti i movimenti della stampante accelereranno gradualmente dall'arresto alla velocit\u00e0 di crociera, quindi decelereranno fino all'arresto. Il flusso in entrata dei comandi di movimento del G-code viene messo in coda e analizzato: l'accelerazione tra i movimenti in una direzione simile sar\u00e0 ottimizzata per ridurre gli arresti di stampa e migliorare il tempo di stampa complessivo. Klipper implementa un algoritmo \"stepper phase endstop\" che pu\u00f2 migliorare la precisione dei tipici interruttori endstop. Se regolato correttamente, pu\u00f2 migliorare l'adesione del primo strato di stampa. Supporto per sensori di presenza del filamento, sensori di movimento del filamento e sensori di larghezza del filamento. Supporto per misurare e registrare l'accelerazione utilizzando gli accelerometri adxl345, mpu9250 e mpu6050. Supporto per limitare la velocit\u00e0 massima di brevi spostamenti a \"zigzag\" per ridurre le vibrazioni e il rumore della stampante. Per ulteriori informazioni, vedere il documento cinematica . Sono disponibili file di configurazione di esempio per molte stampanti comuni. Controllare la directory di configurazione per un elenco. Per iniziare con Klipper, leggi la guida installazione . Benchmark dei passi \u00b6 Di seguito sono riportati i risultati dei test delle prestazioni degli stepper. I numeri visualizzati rappresentano il numero totale di passi al secondo sul microcontrollore. Microcontrollore 1 stepper attivo 3 stepper attivi 16Mhz AVR 157K 99K 20Mhz AVR 196K 123K SAMD21 686K 471K STM32F042 814K 578K Beaglebone PRU 866K 708K STM32G0B1 1103K 790K STM32F103 1180K 818K SAM3X8E 1273K 981K SAM4S8C 1690K 1385K LPC1768 1923K 1351K LPC1769 2353K 1622K RP2040 2400K 1636K SAM4E8E 2500K 1674K SAMD51 3077K 1885K STM32F407 3652K 2459K STM32F446 3913K 2634K STM32H743 9091K 6061K Se non sei sicuro del microcontrollore su una particolare scheda, trova il file di configurazione appropriato e cerca il nome del microcontrollore nei commenti nella parte superiore di quel file. Ulteriori dettagli sui benchmark sono disponibili nel documento Benchmarks .","title":"Caratteristiche"},{"location":"Features.html#caratteristiche","text":"Klipper ha diverse caratteristiche interessanti: Movimento passo-passo di alta precisione. Klipper utilizza un processore applicativo (come un Raspberry Pi a basso costo) per calcolare i movimenti della stampante. Il processore dell'applicazione determina quando far avanzare ciascun motore passo-passo, comprime quegli eventi, li trasmette al microcontrollore e quindi il microcontrollore esegue ogni evento all'ora richiesta. Ogni evento stepper \u00e8 programmato con una precisione di 25 microsecondi o superiore. Il software non utilizza stime cinematiche (come l'algoritmo di Bresenham), ma calcola tempi di passo precisi in base alla fisica dell'accelerazione e alla fisica della cinematica della macchina. Il movimento passo-passo pi\u00f9 preciso garantisce un funzionamento della stampante pi\u00f9 silenzioso e stabile. Le migliori prestazioni della classe. Klipper \u00e8 in grado di raggiungere elevate velocit\u00e0 di stepping su microcontrollori nuovi e vecchi. Anche i vecchi microcontrollori a 8 bit possono ottenere velocit\u00e0 di oltre 175.000 passi al secondo. Sui microcontrollori pi\u00f9 recenti sono possibili diversi milioni di passi al secondo. Velocit\u00e0 stepper pi\u00f9 elevate consentono velocit\u00e0 di stampa pi\u00f9 elevate. Il timing dell'evento stepper rimane preciso anche a velocit\u00e0 elevate, migliorando la stabilit\u00e0 generale. Klipper supporta stampanti con pi\u00f9 microcontrollori. Ad esempio, un microcontrollore potrebbe essere utilizzato per controllare un estrusore, mentre un altro controlla i riscaldatori della stampante, mentre un terzo controlla il resto della stampante. Il software host Klipper implementa la sincronizzazione dell'orologio per tenere conto della deriva dell'orologio tra i microcontrollori. Non \u00e8 necessario alcun codice speciale per abilitare pi\u00f9 microcontrollori: sono necessarie solo alcune righe in pi\u00f9 nel file di configurazione. Configurazione tramite semplice file. Non \u00e8 necessario eseguire il reflash del microcontrollore per modificare un'impostazione. Tutta la configurazione di Klipper \u00e8 memorizzata in un file di configurazione standard che pu\u00f2 essere facilmente modificato. Ci\u00f2 semplifica la configurazione e la manutenzione dell'hardware. Klipper supporta \"Smooth Pressure Advance\", un meccanismo per tenere conto degli effetti della pressione all'interno di un estrusore. Ci\u00f2 riduce la \"melma\" dell'estrusore e migliora la qualit\u00e0 degli angoli di stampa. L'implementazione di Klipper non introduce variazioni istantanee della velocit\u00e0 dell'estrusore, il che migliora la stabilit\u00e0 e la robustezza complessive. Klipper supporta \"Input Shaping\" per ridurre l'impatto delle vibrazioni sulla qualit\u00e0 di stampa. Ci\u00f2 pu\u00f2 ridurre o eliminare il \"ringing\" (noto anche come \"ghosting\", \"eco\" o \"increspatura\") nelle stampe. Pu\u00f2 anche consentire di ottenere velocit\u00e0 di stampa pi\u00f9 elevate pur mantenendo un'elevata qualit\u00e0 di stampa. Klipper utilizza un \"risolutore iterativo\" per calcolare sequenze temporali precisi da semplici equazioni cinematiche. Ci\u00f2 semplifica il porting di Klipper su nuovi tipi di robot e mantiene i tempi precisi anche con cinematiche complesse (non \u00e8 necessaria la \"segmentazione della linea\"). Klipper \u00e8 indipendente dall'hardware. Si dovrebbe ottenere la stessa tempistica precisa indipendentemente dall'hardware dell'elettronica di basso livello. Il codice del microcontrollore Klipper \u00e8 progettato per seguire fedelmente la pianificazione fornita dal software host Klipper (o avvisare in modo evidente l'utente se non \u00e8 in grado di farlo). Ci\u00f2 semplifica l'utilizzo dell'hardware disponibile, l'aggiornamento al nuovo hardware e la fiducia nell'hardware. Codice portatile. Klipper funziona su microcontrollori basati su ARM, AVR e PRU. Le stampanti esistenti in stile \"reprap\" possono eseguire Klipper senza modifiche hardware: basta aggiungere un Raspberry Pi. Il layout del codice interno di Klipper semplifica il supporto anche di altre architetture di microcontrollori. Codice pi\u00f9 semplice. Klipper utilizza un linguaggio di alto livello (Python) per la maggior parte del codice. Gli algoritmi cinematici, l'analisi del G-code, gli algoritmi di riscaldamento e termistore, ecc. sono tutti scritti in Python. Ci\u00f2 semplifica lo sviluppo di nuove funzionalit\u00e0. Macro programmabili personalizzate. \u00c8 possibile definire nuovi comandi G-Code nel file di configurazione della stampante (non sono necessarie modifiche al codice). Questi comandi sono programmabili, consentendo loro di produrre azioni diverse a seconda dello stato della stampante. Server API integrato. Oltre all'interfaccia G-Code standard, Klipper supporta una ricca interfaccia applicativa basata su JSON. Ci\u00f2 consente ai programmatori di creare applicazioni esterne con un controllo dettagliato della stampante.","title":"Caratteristiche"},{"location":"Features.html#caratteristiche-aggiuntive","text":"Klipper supporta molte funzionalit\u00e0 standard della stampante 3D: Diverse interfacce web disponibili. Funziona con Randa, Fluidd, OctoPrint e altri. Ci\u00f2 consente di controllare la stampante utilizzando un normale browser web. Lo stesso Raspberry Pi che esegue Klipper pu\u00f2 anche eseguire l'interfaccia web. Supporto G-code standard. Sono supportati i comandi G-code comuni prodotti dai tipici \"slicer\" (SuperSlicer, Cura, PrusaSlicer, ecc.). Supporto per pi\u00f9 estrusori. Sono supportati anche estrusori con riscaldatori condivisi ed estrusori su carrelli indipendenti (IDEX). Supporto per stampanti cartesiane, delta, corexy, corexz, hybrid-corexy, hybrid-corexz, deltesian, rotary delta, polar e cable winch. Supporto per il livellamento automatico del letto. Klipper pu\u00f2 essere configurato per il rilevamento di base dell'inclinazione del piatto o per il livellamento del piatto a mesh completa. Se il piatto utilizza pi\u00f9 stepper Z, Klipper pu\u00f2 anche livellare manipolando in modo indipendente gli stepper Z. Sono supportate la maggior parte delle sonde di altezza Z, comprese le sonde BL-Touch e le sonde servoattivate. Supporto per la calibrazione delta automatica. Lo strumento di calibrazione pu\u00f2 eseguire la calibrazione dell'altezza di base e una calibrazione avanzata delle dimensioni X e Y. La calibrazione pu\u00f2 essere eseguita con una sonda di altezza Z o tramite tastatura manuale. Supporto \"escludi oggetto\" in fase di esecuzione. Se configurato, questo modulo pu\u00f2 facilitare l'annullamento di un solo oggetto in una stampa multiparte. Supporto per sensori di temperatura comuni (ad es. termistori comuni, AD595, AD597, AD849x, PT100, PT1000, MAX6675, MAX31855, MAX31856, MAX31865, BME280, HTU21D, DS18B20 e LM75). \u00c8 inoltre possibile configurare termistori personalizzati e sensori di temperatura analogici personalizzati. \u00c8 possibile monitorare il sensore di temperatura del microcontrollore interno e il sensore di temperatura interna di un Raspberry Pi. Protezione del riscaldatore termico di base abilitata di default. Supporto per ventole standard, ventole per ugelli e ventole a temperatura controllata. Non \u00e8 necessario mantenere le ventole in funzione quando la stampante \u00e8 inattiva. La velocit\u00e0 della ventola pu\u00f2 essere monitorata su ventole dotate di contagiri. Supporto per la configurazione in fase di esecuzione dei driver per motori passo-passo TMC2130, TMC2208/TMC2224, TMC2209, TMC2660 e TMC5160. \u00c8 inoltre disponibile il supporto per il controllo corrente dei tradizionali driver passo-passo tramite i pin AD5206, DAC084S085, MCP4451, MCP4728, MCP4018 e PWM. Supporto per comuni display LCD collegati direttamente alla stampante. \u00c8 disponibile anche un menu predefinito. Il contenuto del display e del menu pu\u00f2 essere completamente personalizzato tramite il file di configurazione. Accelerazione costante e supporto \"look-ahead\". Tutti i movimenti della stampante accelereranno gradualmente dall'arresto alla velocit\u00e0 di crociera, quindi decelereranno fino all'arresto. Il flusso in entrata dei comandi di movimento del G-code viene messo in coda e analizzato: l'accelerazione tra i movimenti in una direzione simile sar\u00e0 ottimizzata per ridurre gli arresti di stampa e migliorare il tempo di stampa complessivo. Klipper implementa un algoritmo \"stepper phase endstop\" che pu\u00f2 migliorare la precisione dei tipici interruttori endstop. Se regolato correttamente, pu\u00f2 migliorare l'adesione del primo strato di stampa. Supporto per sensori di presenza del filamento, sensori di movimento del filamento e sensori di larghezza del filamento. Supporto per misurare e registrare l'accelerazione utilizzando gli accelerometri adxl345, mpu9250 e mpu6050. Supporto per limitare la velocit\u00e0 massima di brevi spostamenti a \"zigzag\" per ridurre le vibrazioni e il rumore della stampante. Per ulteriori informazioni, vedere il documento cinematica . Sono disponibili file di configurazione di esempio per molte stampanti comuni. Controllare la directory di configurazione per un elenco. Per iniziare con Klipper, leggi la guida installazione .","title":"Caratteristiche aggiuntive"},{"location":"Features.html#benchmark-dei-passi","text":"Di seguito sono riportati i risultati dei test delle prestazioni degli stepper. I numeri visualizzati rappresentano il numero totale di passi al secondo sul microcontrollore. Microcontrollore 1 stepper attivo 3 stepper attivi 16Mhz AVR 157K 99K 20Mhz AVR 196K 123K SAMD21 686K 471K STM32F042 814K 578K Beaglebone PRU 866K 708K STM32G0B1 1103K 790K STM32F103 1180K 818K SAM3X8E 1273K 981K SAM4S8C 1690K 1385K LPC1768 1923K 1351K LPC1769 2353K 1622K RP2040 2400K 1636K SAM4E8E 2500K 1674K SAMD51 3077K 1885K STM32F407 3652K 2459K STM32F446 3913K 2634K STM32H743 9091K 6061K Se non sei sicuro del microcontrollore su una particolare scheda, trova il file di configurazione appropriato e cerca il nome del microcontrollore nei commenti nella parte superiore di quel file. Ulteriori dettagli sui benchmark sono disponibili nel documento Benchmarks .","title":"Benchmark dei passi"},{"location":"G-Codes.html","text":"G-Codes \u00b6 Questo documento descrive i comandi che Klipper supporta. Questi sono i comandi che si possono inserire nella scheda del terminale OctoPrint. Comandi G-Code \u00b6 Klipper supporta i seguenti comandi G-Code standard: Movimento (G0 or G1): G1 [X<pos>] [Y<pos>] [Z<pos>] [E<pos>] [F<speed>] Sosta: G4 P<millisecondi> Sposta all'origine: G28 [X] [Y] [Z] Spegnere i motori: M18 o M84 Attendi che li movimenti correnti finiscano: M400 Utilizzare distanze assolute/relative per l'estrusione: M82 , M83 Usa coordinate assolute/relative: G90 , G91 Impostare la posizione: G92 [X<pos>] [Y<pos>] [Z<pos>] [E<pos>] Impostare la percentuale di override del fattore di velocit\u00e0: M220 S<percentuale> Imposta la percentuale di sostituzione del fattore di estrusione: M221 S<percentuale> Impostare l'accelerazione: M204 S<valore> OPPURE M204 P<valore> T<valore> Nota: se S non viene specificato e vengono specificati sia P che T, l'accelerazione viene impostata al minimo di P e T. Se viene specificato solo uno di P o T, il comando non ha effetto. Ottieni la temperatura dell'estrusore: M105 Imposta la temperatura dell'estrusore: M104 [T<index>] [S<temperatura>] Imposta la temperatura dell'estrusore e attende: M109 [T<index>] S<temperatura> Nota: M109 attende sempre che la temperatura si assesti al valore richiesto Imposta la temperatura del piatto: M140 [S<temperatura>] Imposta la temperatura del piatto e attende: M190 S<temperatura> Nota: M190 attende sempre che la temperatura si assesti al valore richiesto Imposta la velocit\u00e0 della ventola: M106 S<valore> Spegnere la ventola: M107 Arresto di emergenza: M112 Ottieni la posizione attuale: M114 Ottieni la versione del firmware: M115 Per ulteriori dettagli sui comandi precedenti, vedere la documentazione RepRap G-Code . L'obiettivo di Klipper \u00e8 supportare i comandi G-Code prodotti da comuni software di terze parti (ad es. OctoPrint, Printrun, Slic3r, Cura, ecc.) nelle loro configurazioni standard. Non \u00e8 un obiettivo supportare ogni possibile comando G-Code. Invece, Klipper preferisce comandi leggibili dall'uomo \"comandi G-Code estesi\" . Allo stesso modo, l'output del terminale G-Code \u00e8 inteso solo per essere leggibile dall'uomo - vedere il documento del server API se si controlla Klipper da un software esterno. Se si necessita di un comando G-Code meno comune, potrebbe essere possibile implementarlo con una [sezione di configurazione gcode_macro] personalizzata (Config_Reference.md#gcode_macro). Ad esempio, si potrebbe usare questo per implementare: G12 , G29 , G30 , G31 , M42 , M80 , M81 , T1 , ecc. Comandi aggiuntivi \u00b6 Klipper utilizza comandi G-Code \"estesi\" per la configurazione e lo stato generale. Questi comandi estesi seguono tutti un formato simile: iniziano con un nome di comando e possono essere seguiti da uno o pi\u00f9 parametri. Ad esempio: SET_SERVO SERVO=mioservo ANGLE=5.3 . In questo documento, i comandi ed i parametri sono mostrati in maiuscolo, tuttavia non fanno distinzione tra maiuscole e minuscole. (Quindi, \"SET_SERVO\" e \"set_servo\" eseguono entrambi lo stesso comando.) Questa sezione \u00e8 organizzata in base al nome del modulo Klipper, che generalmente segue i nomi delle sezioni specificati nel file di configurazione della stampante . Si noti che alcuni moduli vengono caricati automaticamente. [adxl345] \u00b6 I seguenti comandi sono disponibili quando una sezione di configurazione adxl345 \u00e8 abilitata. ACCELEROMETER_MEASURE \u00b6 ACCELEROMETER_MEASURE [CHIP=<config_name>] [NAME=<value>] : Avvia le misurazioni dell'accelerometro al numero richiesto di campioni al secondo. Se CHIP non \u00e8 specificato, il valore predefinito \u00e8 \"adxl345\". Il comando funziona in modalit\u00e0 start-stop: alla prima esecuzione avvia le misure, alla successiva esecuzione le interrompe. I risultati delle misurazioni vengono scritti in un file denominato /tmp/adxl345-<chip>-<name>.csv dove <chip> \u00e8 il nome del chip dell'accelerometro ( my_chip_name da [adxl345 my_chip_name] ) e <name> \u00e8 il parametro NAME facoltativo. Se NAME non \u00e8 specificato, il valore predefinito \u00e8 l'ora corrente nel formato \"AAAAMMGG_HHMMSS\". Se l'accelerometro non ha un nome nella sua sezione di configurazione (semplicemente [adxl345] ), allora la parte <chip> del nome non viene generata. ACCELEROMETER_QUERY \u00b6 ACCELEROMETER_QUERY [CHIP=<config_name>] [RATE=<value>] : interroga l'accelerometro per il valore corrente. Se CHIP non \u00e8 specificato, il valore predefinito \u00e8 \"adxl345\". Se RATE non \u00e8 specificato, viene utilizzato il valore predefinito. Questo comando \u00e8 utile per testare la connessione all'accelerometro ADXL345: uno dei valori restituiti dovrebbe essere un'accelerazione di caduta libera (+/- un po' di rumore del chip). ACCELEROMETER_DEBUG_READ \u00b6 ACCELEROMETER_DEBUG_READ [CHIP=<config_name>] REG=<register> : interroga l'ADXL345 register \"register\" (es. 44 o 0x2C). Pu\u00f2 essere utile per scopi di debug. ACCELEROMETER_DEBUG_WRITE \u00b6 ACCELEROMETER_DEBUG_WRITE [CHIP=<nome_config>] REG=<register> VAL=<value> : Scrive il valore \"value\" grezzo in un registro \"register\". Sia \"value\" che \"registrer\" possono essere un numero intero decimale o esadecimale. Usare con cura e fare riferimento alla scheda tecnica ADXL345 per riferimento. [angle] \u00b6 I seguenti comandi sono disponibili quando una sezione di configurazione dell'angolo \u00e8 abilitata. ANGLE_CALIBRATE \u00b6 ANGLE_CALIBRATE CHIP=<chip_name> : Esegue la calibrazione dell'angolo sul sensore dato (deve esserci una sezione di configurazione [angle chip_name] che ha specificato un parametro stepper ). IMPORTANTE - questo strumento comander\u00e0 al motore passo-passo di muoversi senza controllare i normali limiti della cinematica. Idealmente, il motore dovrebbe essere scollegato da qualsiasi carrello della stampante prima di eseguire la calibrazione. Se non \u00e8 possibile scollegare lo stepper dalla stampante, assicurarsi che il carrello sia vicino al centro della sua guida prima di iniziare la calibrazione. (Il motore passo-passo pu\u00f2 spostarsi avanti o indietro di due rotazioni complete durante questo test.) Dopo aver completato questo test, utilizzare il comando SAVE_CONFIG per salvare i dati di calibrazione nel file di configurazione. Per utilizzare questo strumento \u00e8 necessario installare il pacchetto Python \"numpy\" (consultare il measuring resonance document per ulteriori informazioni). ANGLE_DEBUG_READ \u00b6 ANGLE_DEBUG_READ CHIP=<config_name> REG=<register> : Interroga il registro del sensore \"register\" (ad es. 44 o 0x2C). Pu\u00f2 essere utile per scopi di debug. Questo \u00e8 disponibile solo per i chip tle5012b. ANGLE_DEBUG_WRITE \u00b6 ANGLE_DEBUG_WRITE CHIP=<config_name> REG=<register> VAL=<value> : scrive il valore \"value\" grezzo nel registro \"register\". Sia \"value\" che \"register\" possono essere un numero intero decimale o esadecimale. Usare con cautela e fare riferimento alla scheda tecnica del sensore per riferimento. Questo \u00e8 disponibile solo per i chip tle5012b. [bed_mesh] \u00b6 I seguenti comandi sono disponibili quando la sezione di configurazione bed_mesh \u00e8 abilitata (consultare anche la guida della mesh del letto ). BED_MESH_CALIBRATE \u00b6 BED_MESH_CALIBRATE [METHOD=manual] [<probe_parameter>=<value>] [<mesh_parameter>=<value>] : Questo comando sonda il piatto utilizzando i punti generati specificati dai parametri nella configurazione. Dopo il sondaggio, viene generata una mesh e il movimento z viene regolato in base alla mesh. Vedere il comando PROBE per i dettagli sui parametri della sonda opzionali. Se viene specificato METHOD=manual, lo strumento di probing manuale \u00e8 attivato - vedere il comando MANUAL_PROBE per quanti riguarda per i dettagli sui comandi aggiuntivi disponibili mentre questo strumento \u00e8 attivo. BED_MESH_OUTPUT \u00b6 BED_MESH_OUTPUT PGP=[<0:1>] : questo comando restituisce i valori z sondati e i valori mesh correnti al terminale. Se viene specificato PGP=1, le coordinate X, Y generate da bed_mesh, insieme ai relativi indici associati, verranno inviate al terminale. BED_MESH_MAP \u00b6 BED_MESH_MAP : Come per BED_MESH_OUTPUT, questo comando stampa lo stato corrente della mesh sul terminale. Invece di stampare i valori in un formato leggibile, lo stato viene serializzato in formato json. Ci\u00f2 consente ai plug-in di Octoprint di acquisire facilmente i dati e generare mappe di altezza che si approssimano la superficie del piatto. BED_MESH_CLEAR \u00b6 BED_MESH_CLEAR : questo comando cancella la mesh e rimuove tutte le regolazioni z. Si consiglia di inserirlo nella parte finale del gcode. BED_MESH_PROFILE \u00b6 BED_MESH_PROFILE LOAD=<name> SAVE=<name> REMOVE=<name> : questo comando fornisce la gestione del profilo per lo stato della mesh. LOAD ripristiner\u00e0 lo stato della mesh dal profilo corrispondente al nome fornito. SAVE salver\u00e0 lo stato della mesh corrente in un profilo che corrisponde al nome fornito. Rimuovi eliminer\u00e0 il profilo corrispondente al nome fornito dalla memoria persistente. Si noti che dopo aver eseguito le operazioni SAVE o REMOVE \u00e8 necessario eseguire il gcode SAVE_CONFIG per rendere permanenti le modifiche alla memoria persistente. BED_MESH_OFFSET \u00b6 BED_MESH_OFFSET [X=<value>] [Y=<value>] : applica gli offset X e/o Y alla ricerca della mesh. Ci\u00f2 \u00e8 utile per le stampanti con estrusori indipendenti, poich\u00e9 \u00e8 necessario un offset per produrre la corretta regolazione Z dopo un cambio utensile. [bed_screws] \u00b6 I seguenti comandi sono disponibili quando la sezione di configurazione bed_screws \u00e8 abilitata (consultare anche la manual level guide ). BED_SCREWS_ADJUST \u00b6 BED_SCREWS_ADJUST : questo comando richiamer\u00e0 lo strumento di regolazione delle viti del piatto. Comander\u00e0 l'ugello in posizioni diverse (come definito nel file di configurazione) e consentir\u00e0 di effettuare regolazioni alle viti del piatto in modo che il piatto sia a una distanza costante dall'ugello. [bed_tilt] \u00b6 I seguenti comandi sono disponibili quando la sezione di configurazione inclinazione_piatto \u00e8 abilitata. BED_TILT_CALIBRATE \u00b6 BED_TILT_CALIBRATE [METHOD=manual] [<probe_parameter>=<value>] : Questo comando sonder\u00e0 i punti specificati nella configurazione e quindi consiglier\u00e0 le regolazioni dell'inclinazione x e y aggiornate. Vedere il comando PROBE per i dettagli sui parametri della sonda opzionali. Se viene specificato METHOD=manual, lo strumento di probing manuale \u00e8 attivato - vedere il comando MANUAL_PROBE sopra per i dettagli sui comandi aggiuntivi disponibili mentre questo strumento \u00e8 attivo. [bltouch] \u00b6 Il comando seguente \u00e8 disponibile quando \u00e8 abilitata una sezione di configurazione bltouch (vedere anche la Guida BL-Touch ). BLTOUCH_DEBUG \u00b6 BLTOUCH_DEBUG COMMAND=<command> : Invia un comando al BLTouch. Pu\u00f2 essere utile per il debug. I comandi disponibili sono: pin_down , touch_mode , pin_up , self_test , reset . Un BL-Touch V3.0 o V3.1 pu\u00f2 anche supportare i comandi set_5V_output_mode , set_OD_output_mode , output_mode_store . BLTOUCH_STORE \u00b6 BLTOUCH_STORE MODE=<output_mode> : memorizza una modalit\u00e0 di output nella EEPROM di un BLTouch V3.1 Le modalit\u00e0 di output disponibili sono: 5V , OD [configfile] \u00b6 Il modulo configfile viene caricato automaticamente. SAVE_CONFIG \u00b6 SAVE_CONFIG : questo comando sovrascriver\u00e0 il file di configurazione della stampante principale e riavvier\u00e0 il software host. Questo comando viene utilizzato insieme ad altri comandi di calibrazione per memorizzare i risultati dei test di calibrazione. [delayed_gcode] \u00b6 Il comando seguente \u00e8 abilitato se \u00e8 stata abilitata una sezione di configurazione di gcode ritardata (consultare anche la guida ai modelli ). UPDATE_DELAYED_GCODE \u00b6 UPDATE_DELAYED_GCODE [ID=<nome>] [DURATION=<secondi>] : aggiorna la durata del ritardo per il [gcode_ritardato] identificato e avvia il timer per l'esecuzione di gcode. Un valore di 0 annuller\u00e0 l'esecuzione di un gcode ritardato in sospeso. [delta_calibrate] \u00b6 I seguenti comandi sono disponibili quando la sezione di configurazione delta_calibrate \u00e8 abilitata (consultare anche la guida alla calibrazione delta ). DELTA_CALIBRATE \u00b6 DELTA_CALIBRATE [METHOD=manual] [<probe_parameter>=<value>] : questo comando sonder\u00e0 sette punti sul piatto e consiglier\u00e0 posizioni di finecorsa, angoli della torre e raggio aggiornati. Vedere il comando PROBE per i dettagli sui parametri della sonda opzionali. Se viene specificato METHOD=manual, lo strumento di probe manuale \u00e8 attivato - vedere il comando MANUAL_PROBE precedente per i dettagli sui comandi aggiuntivi disponibili mentre questo strumento \u00e8 attivo. DELTA_ANALYZE \u00b6 DELTA_ANALYZE : questo comando viene utilizzato durante la calibrazione avanzata delle stampanti delta. Vedere Delta Calibrate per i dettagli. [display] \u00b6 Il comando seguente \u00e8 disponibile quando \u00e8 abilitata una sezione di configurazione display . SET_DISPLAY_GROUP \u00b6 SET_DISPLAY_GROUP [DISPLAY=<display>] GROUP=<group> : Imposta il gruppo di visualizzazione attivo di un display LCD. Ci\u00f2 consente di definire pi\u00f9 gruppi di dati di visualizzazione nella configurazione, ad es. [display_data <group> <elementname>] e passare da uno all'altro usando questo comando gcode esteso. Se DISPLAY non \u00e8 specificato, l'impostazione predefinita \u00e8 \"display\" (il display principale). [display_status] \u00b6 Il modulo display_status viene caricato automaticamente se una sezione di configurazione display \u00e8 abilitata. Fornisce i seguenti comandi G-Code standard: Messaggio visualizzato: M117 <messaggio> Imposta la percentuale di costruzione: M73 P<percentuale> Viene inoltre fornito il seguente comando G-Code esteso: SET_DISPLAY_TEXT MSG=<messaggio> : esegue l'equivalente di M117, impostando il MSG fornito come messaggio visualizzato. Se MSG viene omesso, il display verr\u00e0 cancellato. [dual_carriage] \u00b6 Il comando seguente \u00e8 disponibile quando la sezione di configurazione dual_carriage \u00e8 abilitata. SET_DUAL_CARRIAGE \u00b6 SET_DUAL_CARRIAGE CARRIAGE=[0|1] : Questo comando imposter\u00e0 il carrello attivo. Viene in genere richiamato dai campi activate_gcode e deactivate_gcode in una configurazione a pi\u00f9 estrusori. [endstop_phase] \u00b6 I seguenti comandi sono disponibili quando una sezione di configurazione endstop_phase \u00e8 abilitata (consultare anche la guida alla fase endstop ). ENDSTOP_PHASE_CALIBRATE \u00b6 ENDSTOP_PHASE_CALIBRATE [STEPPER=<config_name>] : Se non viene fornito alcun parametro STEPPER, questo comando riporter\u00e0 le statistiche sulle fasi stepper dell'arresto durante le precedenti operazioni di homing. Quando viene fornito un parametro STEPPER, fa in modo che l'impostazione della fase di fine corsa fornita sia scritta nel file di configurazione (insieme al comando SAVE_CONFIG). [exclude_object] \u00b6 I seguenti comandi sono disponibili quando \u00e8 abilitata una exclude_object config section (consultare anche la exclude object guide ): EXCLUDE_OBJECT \u00b6 EXCLUDE_OBJECT [NAME=object_name] [CURRENT=1] [RESET=1] : Senza parametri, questo restituir\u00e0 un elenco di tutti gli oggetti attualmente esclusi. Quando viene fornito il parametro NAME , l'oggetto denominato verr\u00e0 escluso dalla stampa. Quando viene fornito il parametro CURRENT , l'oggetto corrente verr\u00e0 escluso dalla stampa. Quando viene fornito il parametro RESET l'elenco degli oggetti esclusi verr\u00e0 cancellato. Inoltre l'inclusione di NAME ripristiner\u00e0 solo l'oggetto denominato. Questo pu\u00f2 causare errori di stampa, se i livelli sono gi\u00e0 stati saltati. EXCLUDE_OBJECT_DEFINE \u00b6 EXCLUDE_OBJECT_DEFINE [NAME=object_name [CENTER=X,Y] [POLYGON=[[x,y],...]] [RESET=1] [JSON=1] : fornisce un riepilogo di un oggetto nel file. Senza parametri forniti, questo elencher\u00e0 gli oggetti definiti noti a Klipper. Restituisce un elenco di stringhe, a meno che non venga fornito il parametro JSON , quando restituir\u00e0 i dettagli dell'oggetto in formato json. Quando il parametro NAME \u00e8 incluso, definisce un oggetto da escludere. NAME : questo parametro \u00e8 obbligatorio. \u00c8 l'identificatore utilizzato da altri comandi in questo modulo. CENTER : una coordinata X,Y per l'oggetto. POLYGON : Un array di coordinate X,Y che fornisce un contorno per l'oggetto. Quando viene fornito il parametro RESET , tutti gli oggetti definiti verranno cancellati e il modulo [exclude_object] verr\u00e0 ripristinato. EXCLUDE_OBJECT_START \u00b6 EXCLUDE_OBJECT_START NAME=object_name : questo comando prende un parametro NAME e marca l'inizio del gcode per un oggetto sul livello corrente. EXCLUDE_OBJECT_END \u00b6 EXCLUDE_OBJECT_END [NAME=object_name] : Denota la fine del gcode dell'oggetto per il livello. \u00c8 accoppiato con EXCLUDE_OBJECT_START . Un parametro NAME \u00e8 facoltativo e avviser\u00e0 solo quando il nome fornito non corrisponde all'oggetto corrente. [extruder] \u00b6 I seguenti comandi sono disponibili se una sezione di configurazione dell'estrusore \u00e8 abilitata: ACTIVATE_EXTRUDER \u00b6 ACTIVATE_EXTRUDER EXTRUDER=<config_name> : in una stampante con pi\u00f9 sezioni di configurazione extruder , questo comando cambia l'hotend attivo. SET_PRESSURE_ADVANCE \u00b6 SET_PRESSURE_ADVANCE [EXTRUDER=<config_name>] [ADVANCE=<pressure_advance>] [SMOOTH_TIME=<pressure_advance_smooth_time>] : Imposta i parametri di pressure advance delleo stepper di un estrusore (come definito in un estrusore o [ extruder_stepper] (sezione di configurazione Config_Reference.md#extruder_stepper). Se EXTRUDER non \u00e8 specificato, per impostazione predefinita viene utilizzato lo stepper definito nell'hotend attivo. SET_EXTRUDER_ROTATION_DISTANCE \u00b6 SET_EXTRUDER_ROTATION_DISTANCE EXTRUDER=<config_name> [DISTANCE=<distance>] : Imposta un nuovo valore per la \"distanza di rotazione\" dello stepper dell'estrusore fornito (come definito in un extruder o extruder_stepper sezione di configurazione). Se la distanza di rotazione \u00e8 un numero negativo, il movimento passo-passo verr\u00e0 invertito (rispetto alla direzione passo-passo specificata nel file di configurazione). Le impostazioni modificate non vengono mantenute al ripristino di Klipper. Usare con cautela poich\u00e9 piccole modifiche possono causare una pressione eccessiva tra l'estrusore e l'hotend. Eseguire una corretta calibrazione con il filamento prima dell'uso. Se il valore 'DISTANZA' non viene fornito, questo comando restituir\u00e0 la distanza di rotazione corrente. SYNC_EXTRUDER_MOTION \u00b6 SYNC_EXTRUDER_MOTION EXTRUDER=<nome> MOTION_QUEUE=<nome> : questo comando attiver\u00e0 lo stepper specificato da EXTRUDER (come definito in un extruder o extruder_stepper config sezione) per sincronizzarsi con il movimento di un estrusore specificato da MOTION_QUEUE (come definito in una sezione di configurazione estrusore ). Se MOTION_QUEUE \u00e8 una stringa vuota, lo stepper verr\u00e0 desincronizzato da tutti i movimenti dell'estrusore. SET_EXTRUDER_STEP_DISTANCE \u00b6 Questo comando \u00e8 deprecato e verr\u00e0 rimosso nel prossimo futuro. SYNC_STEPPER_TO_EXTRUDER \u00b6 Questo comando \u00e8 deprecato e verr\u00e0 rimosso nel prossimo futuro. [fan_generic] \u00b6 Il comando seguente \u00e8 disponibile quando una sezione di configurazione fan_generic \u00e8 abilitata. SET_FAN_SPEED \u00b6 SET_FAN_SPEED FAN=config_name SPEED=<velocit\u00e0> Questo comando imposta la velocit\u00e0 di una ventola. \"velocit\u00e0\" deve essere compresa tra 0.0 e 1.0. [filament_switch_sensor] \u00b6 Il comando seguente \u00e8 disponibile quando \u00e8 abilitata una sezione di configurazione filament_switch_sensor o filament_motion_sensor . QUERY_FILAMENT_SENSOR \u00b6 QUERY_FILAMENT_SENSOR SENSOR=<sensor_name> : Interroga lo stato del sensore di filamento. I dati visualizzati sul terminale dipenderanno dal tipo di sensore definito nella configurazione. SET_FILAMENT_SENSOR \u00b6 SET_FILAMENT_SENSOR SENSOR=<nome_sensore> ENABLE=[0|1] : Attiva/disattiva il sensore di filamento. Se ENABLE \u00e8 impostato su 0, il sensore di filamento sar\u00e0 disabilitato, se impostato su 1 sar\u00e0 abilitato. [firmware_retraction] \u00b6 I seguenti comandi G-Code standard sono disponibili quando la sezione di configurazione firmware_retraction \u00e8 abilitata. Questi comandi consentono di utilizzare la funzione di retraction del firmware disponibile in molti slicer, per ridurre lo stringing durante gli spostamenti di non estrusione da una parte all'altra della stampa. Configurando opportunamente la pressure advance si riduce la lunghezza della retrazione richiesta. G10 : Ritrae l'estrusore utilizzando i parametri attualmente configurati. G11 : Ritira l'estrusore utilizzando i parametri attualmente configurati. Sono inoltre disponibili i seguenti comandi aggiuntivi. SET_RETRACTION \u00b6 SET_RETRACTION [RETRACT_LENGTH=<mm>] [RETRACT_SPEED=<mm/s>] [UNRETRACT_EXTRA_LENGTH=<mm>] [UNRETRACT_SPEED=<mm/s>] : regola i parametri utilizzati dalla retrazione. RETRACT_LENGTH determina la lunghezza del filamento da ritrarre e estrudere. La velocit\u00e0 di retrazione viene regolata tramite RETRACT_SPEED, ed \u00e8 generalmente impostata su un valore relativamente alto. La velocit\u00e0 di annullamento viene regolata tramite UNRETRACT_SPEED e non \u00e8 particolarmente critica, sebbene spesso inferiore a RETRACT_SPEED. In alcuni casi \u00e8 utile aggiungere una piccola quantit\u00e0 di lunghezza aggiuntiva all'annullamento della retrazione, e questa viene impostata tramite UNRETRACT_EXTRA_LENGTH. SET_RETRACTION \u00e8 comunemente impostato come parte della configurazione dello slicer per filamento, poich\u00e9 filamenti diversi richiedono impostazioni dei parametri diverse. GET_RETRACTION \u00b6 GET_RETRACTION : interroga i parametri correnti utilizzati dal firmware per retrazione e li visualizza sul terminale. [force_move] \u00b6 Il modulo force_move viene caricato automaticamente, tuttavia alcuni comandi richiedono l'impostazione di enable_force_move in printer config . STEPPER_BUZZ \u00b6 STEPPER_BUZZ STEPPER=<nome_config> : sposta lo stepper dato in avanti di 1 mm e poi indietro di 1 mm, ripetuto 10 volte. Questo \u00e8 uno strumento diagnostico per aiutare a verificare la connettivit\u00e0 stepper. FORCE_MOVE \u00b6 FORCE_MOVE STEPPER=<nome_config> DISTANCE=<value> VELOCITY=<value> [ACCEL=<value>] : Questo comando sposter\u00e0 forzatamente lo stepper dato della distanza data (in mm) alla velocit\u00e0 costante data (in mm/ S). Se viene specificato ACCEL ed \u00e8 maggiore di zero, verr\u00e0 utilizzata l'accelerazione data (in mm/s^2); altrimenti non viene eseguita alcuna accelerazione. Non vengono effettuati controlli sui limiti; non vengono effettuati aggiornamenti cinematici; altri stepper paralleli su un asse non verranno spostati. Prestare attenzione poich\u00e9 un comando errato potrebbe causare danni! L'uso di questo comando metter\u00e0 quasi sicuramente la cinematica di basso livello in uno stato errato; emettere un G28 in seguito per ripristinare la cinematica. Questo comando \u00e8 destinato alla diagnostica e al debug di basso livello. SET_KINEMATIC_POSITION \u00b6 SET_KINEMATIC_POSITION [X=<valore>] [Y=<valore>] [Z=<valore>] : forza il codice cinematico di basso livello a credere che la testa di stampa si trovi nella posizione cartesiana data. Questo \u00e8 un comando diagnostico e di debug; utilizzare SET_GCODE_OFFSET e/o G92 per le normali trasformazioni degli assi. Se un asse non \u00e8 specificato, verr\u00e0 impostato automaticamente sulla posizione in cui la testa \u00e8 stata comandata l'ultima volta. L'impostazione di una posizione errata o non valida pu\u00f2 causare errori software interni. Questo comando potrebbe invalidare futuri controlli sui confini; emettere un G28 in seguito per ripristinare la cinematica. [gcode] \u00b6 Il modulo gcode viene caricato automaticamente. RESTART \u00b6 RESTART : Ci\u00f2 far\u00e0 s\u00ec che il software host ricarichi la sua configurazione ed esegua un ripristino interno. Questo comando non canceller\u00e0 lo stato di errore dal microcontrollore (vedi FIRMWARE_RESTART) n\u00e9 caricher\u00e0 nuovo software (vedi FAQ ) . FIRMWARE_RESTART \u00b6 FIRMWARE_RESTART : Questo \u00e8 simile a un comando RESTART, ma cancella anche qualsiasi stato di errore dal microcontrollore. STATUS \u00b6 STATUS : segnala lo stato del software host di Klipper. HELP \u00b6 HELP : riporta l'elenco dei comandi G-Code estesi disponibili. [gcode_arcs] \u00b6 I seguenti comandi G-Code standard sono disponibili se una sezione di configurazione gcode_arcs \u00e8 abilitata: Movimento dell'arco in senso orario (G2), Movimento dell'arco in senso antiorario (G3): G2|G3 [X<pos>] [Y<pos>] [Z<pos>] [E<pos>] [F<velocit\u00e0>] I<valore> J<valore>|I<valore> K<valore>|J<valore> K<valore> Selezione del piano dell'arco: G17 (piano XY), G18 (piano XZ), G19 (piano YZ) [gcode_macro] \u00b6 Il comando seguente \u00e8 disponibile quando \u00e8 abilitata una sezione di configurazione gcode_macro (consultare anche la guida ai modelli di comando ). SET_GCODE_VARIABLE \u00b6 SET_GCODE_VARIABLE MACRO=<nome_macro> VARIABLE=<nome> VALUE=<valore> : questo comando consente di modificare il valore di una variabile gcode_macro in fase di esecuzione. Il VALUE fornito viene analizzato come un valore literal in Python. [gcode_move] \u00b6 Il modulo gcode_move viene caricato automaticamente. GET_POSITION \u00b6 GET_POSITION`: Restituisce informazioni sulla posizione corrente della testa di stampa. Per ulteriori informazioni, vedere la documentazione per gli sviluppatori di GET_POSITION output . SET_GCODE_OFFSET \u00b6 SET_GCODE_OFFSET [X=<pos>|X_ADJUST=<regola>] [Y=<pos>|Y_ADJUST=<regola>] [Z=<pos>|Z_ADJUST=<regola>] [MOVE=1 [MOVE_SPEED=<velocit\u00e0 >]] : imposta un offset di posizione da applicare ai futuri comandi G-Code. Questo \u00e8 comunemente usato per cambiare virtualmente l'offset del letto Z o per impostare gli offset XY degli ugelli quando si cambia estrusore. Ad esempio, se viene inviato \"SET_GCODE_OFFSET Z=0.2\", i futuri movimenti G-Code avranno 0.2 mm aggiunti alla loro altezza Z. Se vengono utilizzati i parametri di stile X_ADJUST, la regolazione verr\u00e0 aggiunta a qualsiasi offset esistente (ad esempio, \"SET_GCODE_OFFSET Z=-0.2\" seguito da \"SET_GCODE_OFFSET Z_ADJUST=0.3\" risulter\u00e0 in un offset Z totale di 0.1). Se viene specificato \"MOVE=1\", verr\u00e0 emesso un movimento della testa di stampa per applicare l'offset specificato (altrimenti l'offset avr\u00e0 effetto sul successivo movimento assoluto del codice G che specifica l'asse dato). Se viene specificato \"MOVE_SPEED\", lo spostamento della testa utensile verr\u00e0 eseguito con la velocit\u00e0 data (in mm/s); in caso contrario, il movimento della testa utensile utilizzer\u00e0 l'ultima velocit\u00e0 del G-code specificata. SAVE_GCODE_STATE \u00b6 SAVE_GCODE_STATE [NAME=<nome_stato>] : salva lo stato di analisi delle coordinate del G-code corrente. Il salvataggio e il ripristino dello stato del G-code \u00e8 utile negli script e nelle macro. Questo comando salva la modalit\u00e0 di coordinate assolute del G-code corrente (G90/G91), la modalit\u00e0 di estrusione assoluta (M82/M83), l'origine (G92), l'offset (SET_GCODE_OFFSET), l'override della velocit\u00e0 (M220), l'override dell'estrusore (M221), la velocit\u00e0 di spostamento , la posizione XYZ corrente e la posizione relativa dell'estrusore \"E\". Se viene fornito NAME, consente di assegnare un nome allo stato salvato alla stringa data. Se NAME non viene fornito, il valore predefinito \u00e8 \"predefinito\". RESTORE_GCODE_STATE \u00b6 RESTORE_GCODE_STATE [NAME=<nome_stato>] [MOVE=1 [MOVE_SPEED=<velocit\u00e0>]] : ripristina uno stato precedentemente salvato tramite SAVE_GCODE_STATE. Se viene specificato \"MOVE=1\", verr\u00e0 emesso un movimento della testa utensile per tornare alla posizione XYZ precedente. Se viene specificato \"MOVE_SPEED\", lo spostamento della testa utensile verr\u00e0 eseguito con la velocit\u00e0 data (in mm/s); in caso contrario, lo spostamento della testa utensile utilizzer\u00e0 la velocit\u00e0 del codice g ripristinata. [hall_filament_width_sensor] \u00b6 I seguenti comandi sono disponibili quando la sezione di configurazione del sensore di larghezza del filamento tsl1401cl o sezione di configurazione del sensore di larghezza del filamento hall \u00e8 abilitata (consultare anche Sensore di larghezza del filamento TSLl401CL e Hall Filament Width Sensor ): QUERY_FILAMENT_WIDTH \u00b6 QUERY_FILAMENT_WIDTH : Restituisce lo spessore del filamento misurato. RESET_FILAMENT_WIDTH_SENSOR \u00b6 RESET_FILAMENT_WIDTH_SENSOR : Cancella tutte le letture del sensore. Utile dopo il cambio del filamento. DISABLE_FILAMENT_WIDTH_SENSOR \u00b6 DISABLE_FILAMENT_WIDTH_SENSOR : Spegnere il sensore di larghezza del filamento e smettere di usarlo per il controllo del flusso. ENABLE_FILAMENT_WIDTH_SENSOR \u00b6 ENABLE_FILAMENT_WIDTH_SENSOR : attiva il sensore di larghezza del filamento e inizia a usarlo per il controllo del flusso. QUERY_RAW_FILAMENT_WIDTH \u00b6 QUERY_RAW_FILAMENT_WIDTH : Restituisce le letture del canale ADC corrente e il valore grezzo (raw) del sensore per i punti di calibrazione. ENABLE_FILAMENT_WIDTH_LOG \u00b6 ENABLE_FILAMENT_WIDTH_LOG : attiva la registrazione del diametro del filamento. DISABLE_FILAMENT_WIDTH_LOG \u00b6 DISABLE_FILAMENT_WIDTH_LOG : Disattiva la registrazione del diametro del filamento. [heaters] \u00b6 Il modulo heaters viene caricato automaticamente se un riscaldatore \u00e8 definito nel file di configurazione. TURN_OFF_HEATERS \u00b6 TURN_OFF_HEATERS : Spegni tutti i riscaldatori. TEMPERATURE_WAIT \u00b6 TEMPERATURE_WAIT SENSOR=<config_name> [MINIMUM=<target>] [MAXIMUM=<target>] : Attendere fino a quando il sensore di temperatura specificato \u00e8 pari o superiore al MINIMO fornito e/o pari o inferiore al MASSIMO fornito. SET_HEATER_TEMPERATURE \u00b6 SET_HEATER_TEMPERATURE HEATER=<nome_riscaldatore> [TARGET=<temperatura_destinata>] : Imposta la temperatura target per un riscaldatore. Se non viene fornita una temperatura target, il target \u00e8 0. [idle_timeout] \u00b6 Il modulo idle_timeout viene caricato automaticamente. SET_IDLE_TIMEOUT \u00b6 SET_IDLE_TIMEOUT [TIMEOUT=<timeout>] : consente all'utente di impostare il timeout di inattivit\u00e0 (in secondi). [input_shaper] \u00b6 Il comando seguente \u00e8 abilitato se \u00e8 stata abilitata una sezione di configurazione di input_shaper (consultare anche la guida alla compensazione della risonanza ). SET_INPUT_SHAPER \u00b6 SET_INPUT_SHAPER [SHAPER_FREQ_X=<shaper_freq_x>] [SHAPER_FREQ_Y=<shaper_freq_y>] [DAMPING_RATIO_X=<damping_ratio_x>] [DAMPING_RATIO_Y=<damping_ratio_y>] [SHAPER_TYPE=<shaper>] [SHAPER_TYPE_X=<shaper_type_x>] [SHAPER_TYPE=<shaper_TYPE_X=<shaper_type_x>] [SHAPER_TYPE=<shaper_type_y=<shaper_type_x> ] : Modifica i parametri dell'input shaper. Si noti che il parametro SHAPER_TYPE reimposta l'input shaper per entrambi gli assi X e Y anche se sono stati configurati tipi di shaper diversi nella sezione [input_shaper]. SHAPER_TYPE non pu\u00f2 essere utilizzato insieme a uno dei parametri SHAPER_TYPE_X e SHAPER_TYPE_Y. Vedere config reference per maggiori dettagli su ciascuno di questi parametri. [manual_probe] \u00b6 Il modulo manual_probe viene caricato automaticamente. MANUAL_PROBE \u00b6 MANUAL_PROBE [SPEED=<speed>] : esegue uno script di supporto utile per misurare l'altezza dell'ugello in una determinata posizione. Se viene specificato SPEED, imposta la velocit\u00e0 dei comandi TESTZ (il valore predefinito \u00e8 5mm/s). Durante una sonda manuale, sono disponibili i seguenti comandi aggiuntivi: ACCEPT : questo comando accetta la posizione Z corrente e conclude il probing manuale. ABORT : questo comando termina lo strumento di probing manuale. TESTZ Z=<valore> : questo comando sposta l'ugello verso l'alto o verso il basso della quantit\u00e0 specificata in \"valore\". Ad esempio, TESTZ Z=-.1 sposterebbe l'ugello verso il basso di .1 mm mentre TESTZ Z=.1 sposterebbe l'ugello verso l'alto di .1 mm. Il valore pu\u00f2 anche essere + , - , ++ o -- per spostare l'ugello verso l'alto o verso il basso di un importo rispetto ai tentativi precedenti. Z_ENDSTOP_CALIBRATE \u00b6 Z_ENDSTOP_CALIBRATE [SPEED=<speed>] : esegue uno script di supporto utile per calibrare un'impostazione di configurazione Z position_endstop. Vedere il comando MANUAL_PROBE per i dettagli sui parametri e sui comandi aggiuntivi disponibili mentre lo strumento \u00e8 attivo. Z_OFFSET_APPLY_ENDSTOP \u00b6 Z_OFFSET_APPLY_ENDSTOP : prende l'offset Z Gcode corrente (noto anche come babystepping) e lo sottrae da stepper_z endstop_position. Questa azione per prendere un valore di babystep utilizzato di frequente e \"renderlo permanente\". Richiede un SAVE_CONFIG per avere effetto. [Stepper manuali] \u00b6 Il comando seguente \u00e8 disponibile quando una sezione di configurazione stepper_manuale \u00e8 abilitata. MANUAL_STEPPER \u00b6 MANUAL_STEPPER STEPPER=nome_config [ENABLE=[0|1]] [SET_POSITION=<pos>] [SPEED=<velocit\u00e0>] [ACCEL=<accelerazione>] [MOVE=<pos> [STOP_ON_ENDSTOP=[1|2|- 1|-2]] [SYNC=0]] : Questo comando alterer\u00e0 lo stato dello stepper. Utilizzare il parametro ENABLE per abilitare/disabilitare lo stepper. Utilizzare il parametro SET_POSITION per forzare lo stepper a pensare di trovarsi nella posizione data. Utilizzare il parametro MOVE per richiedere un movimento alla posizione data. Se viene specificato SPEED e/o ACCEL, verranno utilizzati i valori forniti al posto dei valori predefiniti specificati nel file di configurazione. Se viene specificato un ACCEL pari a zero, non verr\u00e0 eseguita alcuna accelerazione. Se viene specificato STOP_ON_ENDSTOP=1, lo spostamento terminer\u00e0 in anticipo se l'endstop segnala come attivato (usa STOP_ON_ENDSTOP=2 per completare lo spostamento senza errori anche se l'endstop non si attiva, usa -1 o -2 per interrompere quando l'endstop segnala non innescato). Normalmente i futuri comandi G-Code verranno programmati per essere eseguiti dopo il completamento del movimento passo-passo, tuttavia se un movimento passo-passo manuale utilizza SYNC=0, i futuri comandi di movimento G-Code potrebbero essere eseguiti in parallelo con il movimento passo-passo. [mcp4018] \u00b6 Il comando seguente \u00e8 disponibile quando una sezione di configurazione mcp4018 \u00e8 abilitata. SET_DIGIPOT \u00b6 SET_DIGIPOT DIGIPOT=config_name WIPER=<value> : Questo comando cambier\u00e0 il valore corrente del digipot. Questo valore dovrebbe essere in genere compreso tra 0.0 e 1.0, a meno che non sia definita una 'scale' nella configurazione. Quando viene definita 'scale', questo valore dovrebbe essere compreso tra 0,0 e 'scale'. [led] \u00b6 Il comando seguente \u00e8 disponibile quando una qualsiasi delle sezioni di configurazione led \u00e8 abilitata. SET_LED \u00b6 SET_LED LED=<nome_config> ROSSO=<valore> VERDE=<valore> BLU=<valore> BIANCO=<valore> [INDEX=<indice>] [TRANSMIT=0] [SYNC=1] : Imposta il LED in output. Ogni colore <valore> deve essere compreso tra 0,0 e 1,0. L'opzione BIANCO \u00e8 valida solo su LED RGBW. Se il LED supporta pi\u00f9 chip in una catena daisy-chain, \u00e8 possibile specificare INDEX per modificare il colore del solo chip specificato (1 per il primo chip, 2 per il secondo, ecc.). Se INDEX non viene fornito, tutti i LED nella catena verranno impostati sul colore fornito. Se viene specificato TRANSMIT=0, il cambio colore verr\u00e0 effettuato solo sul successivo comando SET_LED che non specifica TRANSMIT=0; questo pu\u00f2 essere utile in combinazione con il parametro INDEX per raggruppare pi\u00f9 aggiornamenti in una catena. Per impostazione predefinita, il comando SET_LED sincronizzer\u00e0 le modifiche con altri comandi gcode in corso. Ci\u00f2 pu\u00f2 comportare un comportamento indesiderato se i LED vengono impostati mentre la stampante non sta stampando in quanto reimposta il timeout di inattivit\u00e0. Se non \u00e8 necessaria una tempistica attenta, \u00e8 possibile specificare il parametro SYNC=0 opzionale per applicare le modifiche senza ripristinare il timeout di inattivit\u00e0. SET_LED_TEMPLATE \u00b6 SET_LED_TEMPLATE LED=<nome_led> TEMPLATE=<nome_modello> [<param_x>=<letterale>] [INDEX=<indice>] : Assegna un modello_visualizzazione a un dato LED . Ad esempio, se si definisce una sezione di configurazione [display_template my_led_template] allora si potrebbe assegnare TEMPLATE=my_led_template qui. Il display_template dovrebbe produrre una stringa separata da virgole contenente quattro numeri in virgola mobile corrispondenti alle impostazioni dei colori rosso, verde, blu e bianco. Il modello verr\u00e0 continuamente valutato e il LED verr\u00e0 impostato automaticamente sui colori risultanti. \u00c8 possibile impostare i parametri display_template da utilizzare durante la valutazione del modello (i parametri verranno analizzati come valori letterali Python). Se INDEX non \u00e8 specificato, tutti i chip nella catena dei LED verranno impostati sul modello, altrimenti verr\u00e0 aggiornato solo il chip con l'indice specificato. Se TEMPLATE \u00e8 una stringa vuota, questo comando canceller\u00e0 qualsiasi modello precedente assegnato al LED (\u00e8 quindi possibile utilizzare i comandi SET_LED per gestire le impostazioni del colore del LED). [output_pin] \u00b6 Il comando seguente \u00e8 disponibile quando una sezione di configurazione pin_output \u00e8 abilitata. SET_PIN \u00b6 SET_PIN PIN=config_name VALUE=<value> [CYCLE_TIME=<cycle_time>] : Set the pin to the given output VALUE . VALUE should be 0 or 1 for \"digital\" output pins. For PWM pins, set to a value between 0.0 and 1.0, or between 0.0 and scale if a scale is configured in the output_pin config section. Some pins (currently only \"soft PWM\" pins) support setting an explicit cycle time using the CYCLE_TIME parameter (specified in seconds). Note that the CYCLE_TIME parameter is not stored between SET_PIN commands (any SET_PIN command without an explicit CYCLE_TIME parameter will use the cycle_time specified in the output_pin config section). [palette2] \u00b6 I seguenti comandi sono disponibili quando la sezione di configurazione della palette2 \u00e8 abilitata. Le stampe di Palette funzionano incorporando speciali OCodes (Codici Omega) nel file GCode: O1 ... O32 : Questi codici vengono letti dal flusso GCode ed elaborati da questo modulo e passati al dispositivo Palette 2. Sono inoltre disponibili i seguenti comandi aggiuntivi. PALETTE_CONNECT \u00b6 PALETTE_CONNECT : questo comando inizializza la connessione con la Palette 2. PALETTE_DISCONNECT \u00b6 PALETTE_DISCONNECT : questo comando si disconnette dalla Palette 2. PALETTE_CLEAR \u00b6 PALETTE_CLEAR : questo comando indica alla Palette 2 di cancellare tutti i percorsi di input e output del filamento. PALETTE_CUT \u00b6 PALETTE_CUT : Questo comando indica alla Palette 2 di tagliare il filamento attualmente caricato nello splice core. PALETTE_SMART_LOAD \u00b6 PALETTE_SMART_LOAD : Questo comando avvia la sequenza di caricamento intelligente sulla Palette 2. Il filamento viene caricato automaticamente estrudendolo alla distanza calibrata sul dispositivo per la stampante e istruisce la Palette 2 una volta completato il caricamento. Questo comando equivale a premere Smart Load direttamente sullo schermo della Palette 2 dopo che il caricamento del filamento \u00e8 stato completato. [pid_calibrate] \u00b6 Il modulo pid_calibrate viene caricato automaticamente se nel file di configurazione \u00e8 definito un riscaldatore. PID_CALIBRATE \u00b6 PID_CALIBRATE HEATER=<nome_config> TARGET=<temperatura> [WRITE_FILE=1] : esegue un test di calibrazione PID. Il riscaldatore specificato verr\u00e0 abilitato fino al raggiungimento della temperatura target specificata, quindi il riscaldatore verr\u00e0 spento e acceso per diversi cicli. Se il parametro WRITE_FILE \u00e8 abilitato, verr\u00e0 creato il file /tmp/heattest.txt con un log di tutti i campioni di temperatura prelevati durante il test. [pause_resume] \u00b6 I seguenti comandi sono disponibili quando la pause_resume config section \u00e8 abilitata: PAUSE \u00b6 PAUSE : mette in pausa la stampa corrente. La posizione attuale viene acquisita per la ripresa al ripristino. RESUME \u00b6 RESUME [VELOCITY=<value>] : riprende la stampa da una pausa, ripristinando prima la posizione precedentemente acquisita. Il parametro VELOCITY determina la velocit\u00e0 alla quale l'utensile deve tornare alla posizione originale acquisita. CLEAR_PAUSE \u00b6 CLEAR_PAUSE : cancella lo stato di pausa corrente senza riprendere la stampa. Questo \u00e8 utile se si decide di annullare una stampa dopo un PAUSE. Si consiglia di aggiungerlo al gcode iniziale per assicurarsi che lo stato in pausa sia aggiornato per ogni stampa. CANCEL_PRINT \u00b6 CANCEL_PRINT : Annulla la stampa corrente. [print_stats] \u00b6 Il modulo print_stats viene caricato automaticamente. SET_PRINT_STATS_INFO \u00b6 SET_PRINT_STATS_INFO [TOTAL_LAYER=<total_layer_count>] [CURRENT_LAYER= <current_layer>] : passa le informazioni sulo slicer come il layer attivo ed il totale a Klipper. Aggiungi SET_PRINT_STATS_INFO [TOTAL_LAYER=<total_layer_count>] alla sezione gcode di inizio del tuo slicer e SET_PRINT_STATS_INFO [CURRENT_LAYER= <current_layer>] alla sezione gcode di cambio livello per passare le informazioni sul livello dal tuo slicer a Klipper. [probe] \u00b6 I seguenti comandi sono disponibili quando \u00e8 abilitata una sezione di configurazione della sonda o una sezione di configurazione di bltouch (consultare anche la guida alla calibrazione della sonda ). sonda \u00b6 PROBE [PROBE_SPEED=<mm/s>] [LIFT_SPEED=<mm/s>] [SAMPLES=<count>] [SAMPLE_RETRACT_DIST=<mm>] [SAMPLES_TOLERANCE=<mm>] [SAMPLES_TOLERANCE_RETRIES=<count>] [SAMPLES_RESULT=median|average] : Sposta il nozzle verso il basso finch\u00e9 la sonda non scatta. Se viene fornito uno qualsiasi dei parametri opzionali, sovrascrive l'impostazione equivalente nella sezione probe config section . QUERY_PROBE \u00b6 QUERY_PROBE : Riporta lo stato corrente della sonda (\"triggered\" o \"open\"). PROBE_ACCURACY \u00b6 PROBE_ACCURACY [PROBE_SPEED=<mm/s>] [SAMPLES=<count>] [SAMPLE_RETRACT_DIST=<mm>] : Calcola la deviazione massima, minima, media, mediana e standard di pi\u00f9 campionamentidella sonda. Per impostazione predefinita, vengono presi 10 CAMPIONI. In caso contrario, i parametri opzionali sono impostati per default sulla loro impostazione equivalente nella sezione di configurazione della sonda. PROBE_CALIBRATE \u00b6 PROBE_CALIBRATE [SPEED=<speed>] [<probe_parameter>=<value>] : Eseguire uno script di aiuto utile per calibrare l'offset z della sonda. Vedere il comando PROBE per i dettagli sui parametri opzionali della sonda. Vedere il comando MANUAL_PROBE per i dettagli del parametro SPEED e sui comandi aggiuntivi disponibili mentre lo strumento \u00e8 attivo. Nota che il comando PROBE_CALIBRATE utilizza la variabile di velocit\u00e0 per spostarsi in direzione XY e Z. Z_OFFSET_APPLY_PROBE \u00b6 Z_OFFSET_APPLY_PROBE : prende l'offset Z Gcode corrente (aka, babystepping) e lo sottrae dallo z_offset della sonda. Questo per prendere un valore di babystep utilizzato di frequente e \"renderlo permanente\". Richiede un SAVE_CONFIG per avere effetto. [query_adc] \u00b6 Il modulo query_adc viene caricato automaticamente. QUERY_ADC \u00b6 QUERY_ADC [NAME=<config_name>] [PULLUP=<value>] : Riporta l'ultimo valore analogico ricevuto per un pin analogico configurato. Se NAME non viene fornito, viene riportato l'elenco dei nomi dei convertitori adc disponibili. Se viene fornito PULLUP (come valore in Ohm), viene riportato il valore analogico grezzo insieme alla resistenza equivalente dato quel pullup specificato. [query_endstops] \u00b6 Il modulo query_endstops viene caricato automaticamente. I seguenti comandi G-Code standard sono attualmente disponibili, ma non \u00e8 consigliabile utilizzarli: Ottieni lo stato del finecorsa: M119 (usa invece QUERY_ENDSTOPS.) QUERY_ENDSTOPS \u00b6 QUERY_ENDSTOPS : Rilevare i finecorsa degli assi e segnala se sono \"attivate\" o in uno stato \"aperto\". Questo comando viene in genere utilizzato per verificare che un finecorsa funzioni correttamente. [resonance_tester] \u00b6 I seguenti comandi sono disponibili quando una sezione di configurazione di tester_risonanza \u00e8 abilitata (consultare anche la guida alle risonanze di misurazione ). MEASURE_AXES_NOISE \u00b6 MEASURE_AXES_NOISE : misura ed riporta il rumore per tutti gli assi di tutti i chip dell'accelerometro abilitati. TEST_RESONANCES \u00b6 TEST_RESONANCES AXIS=<asse> OUTPUT=<risonanze,dati_grezzi> [NAME=<nome>] [FREQ_START=<freq_min>] [FREQ_END=<freq_max>] [HZ_PER_SEC=<hz_per_sec>] [CHIPS=<adxl345_chip_name>] [ POINT=x,y,z] [INPUT_SHAPING=[<0:1>]] : esegue il test di risonanza in tutti i punti sonda configurati per l'\"asse\" richiesto e misura l'accelerazione utilizzando i chip dell'accelerometro configurati per il rispettivo asse. \"asse\" pu\u00f2 essere X o Y, oppure specificare una direzione arbitraria come AXIS=dx,dy , dove dx e dy sono numeri in virgola mobile che definiscono un vettore di direzione (es. AXIS=X , AXIS=Y , o AXIS=1,-1 per definire una direzione diagonale). Nota che AXIS=dx,dy e AXIS=-dx,-dy sono equivalenti. adxl345_chip_name pu\u00f2 essere uno o pi\u00f9 chip adxl345 configurati, delimitati da virgole, ad esempio CHIPS=\"adxl345, adxl345 rpi\" . Nota che adxl345 pu\u00f2 essere omesso dai chip adxl345 denominati. Se POINT \u00e8 specificato, sovrascriver\u00e0 i punti configurati in [resonance_tester] . Se INPUT_SHAPING=0 o non impostato (predefinito), disabilita l'input shaping per il test di risonanza, perch\u00e9 non \u00e8 valido eseguire il test di risonanza con input shaper abilitato. Il parametro OUTPUT \u00e8 un elenco separato da virgole di cui verranno scritti gli output. Se viene richiesto raw_data , i dati grezzi dell'accelerometro vengono scritti in un file o in una serie di file /tmp/raw_data_<asse>_[<nome_chip>_][<punto>_]<nome>.csv con ( <punto>_ parte del nome generata solo se \u00e8 configurato pi\u00f9 di 1 punto sonda o \u00e8 specificato PUNTO). Se viene specificato resonances , la risposta in frequenza viene calcolata (su tutti i punti sonda) e scritta nel file /tmp/resonances_<asse>_<nome>.csv . Se non \u00e8 impostato, OUTPUT \u00e8 impostato su risonanze e NAME \u00e8 impostato sull'ora corrente nel formato \"AAAAMMGG_HHMMSS\". SHAPER_CALIBRATE \u00b6 SHAPER_CALIBRATE [AXIS=<asse>] [NAME=<nome>] [FREQ_START=<freq_min>] [FREQ_END=<freq_max>] [HZ_PER_SEC=<hz_per_sec>] [MAX_SMOOTHING=<livellamento_max>] : simile a TEST_RESONANCES , esegue il test di risonanza come configurato e cerca di trovare i parametri ottimali di input shaper per l'asse richiesto (o entrambi gli assi X e Y se il parametro AXIS non \u00e8 impostato). Se MAX_SMOOTHING non \u00e8 impostato, il suo valore viene preso dalla sezione [resonance_tester] , con l'impostazione predefinita non impostata. Per ulteriori informazioni sull'uso di questa funzione, vedere il Max smoothing della guida alla misurazione delle risonanze. I risultati dell'ottimizzazione vengono stampati sulla console e le risposte in frequenza e i diversi valori degli shaper di input vengono scritti in uno o pi\u00f9 file CSV /tmp/calibration_data_<asse>_<nome>.csv . A meno che non sia specificato, NAME imposta l'ora corrente nel formato \"AAAAMMGG_HHMMSS\". Nota che i parametri di input shaper suggeriti possono essere mantenuti nella configurazione eseguendo il comando SAVE_CONFIG . [respond] \u00b6 I seguenti comandi G-Code standard sono disponibili quando la sezione di configurazione di risposta \u00e8 abilitata: M118 <messaggio> : fa eco al messaggio preceduto dal prefisso predefinito configurato (o echo: se non \u00e8 configurato alcun prefisso). Sono inoltre disponibili i seguenti comandi aggiuntivi. RESPOND \u00b6 RESPOND MSG=\"<message>\" : echo il messaggio preceduto dal prefisso predefinito configurato (o echo: se non \u00e8 configurato alcun prefisso). RESPOND TYPE=echo MSG=\"<message>\" : echo del messaggio preceduto da echo: . RESPOND TYPE=echo_no_space MSG=\"<messaggio>\" : fa eco al messaggio preceduto da echo: senza uno spazio tra prefisso e messaggio, utile per la compatibilit\u00e0 con alcuni plugin di octoprint che prevedono una formattazione molto specifica. RESPOND TYPE=command MSG=\"<message>\" : echo il messaggio preceduto da // . OctoPrint pu\u00f2 essere configurato per rispondere a questi messaggi (ad es. RESPOND TYPE=command MSG=action:pause ). RESPOND TYPE=error MSG=\"<messaggio>\" : fa eco al messaggio preceduto da !! . RESPOND PREFIX=<prefix> MSG=\"<message>\" : echo il messaggio preceduto da <prefix> . (Il parametro PREFIX avr\u00e0 la priorit\u00e0 sul parametro TYPE ) [save_variables] \u00b6 Il comando seguente \u00e8 abilitato se \u00e8 stata abilitata una sezione di configurazione save_variables . SAVE_VARIABLE \u00b6 SAVE_VARIABLE VARIABLE=<nome> VALUE=<valore> : salva la variabile su disco in modo che possa essere utilizzata tra i riavvii. Tutte le variabili memorizzate vengono caricate nel dict printer.save_variables.variables all'avvio e possono essere utilizzate nelle macro gcode. Il VALUE fornito viene analizzato come un valore letterale Python. [screws_tilt_adjust] \u00b6 I seguenti comandi sono disponibili quando la sezione di configurazione viti_tilt_adjust \u00e8 abilitata (consultare anche la manual level guide ). SCREWS_TILT_CALCULATE \u00b6 SCREWS_TILT_CALCULATE [DIRECTION=CW|CCW] [MAX_DEVIATION=<value>] [<probe_parameter>=<value>] : Questo comando richiamer\u00e0 lo strumento di regolazione delle viti del piatto. Comander\u00e0 l'ugello in diverse posizioni (come definito nel file di configurazione) sondando l'altezza z e calcoler\u00e0 il numero di giri della manopola per regolare il livello del piatto. Se si specifica DIRECTION, le rotazioni della manopola saranno tutte nella stessa direzione, in senso orario (CW) o in senso antiorario (CCW). Vedere il comando PROBE per i dettagli sui parametri della sonda opzionali. IMPORTANTE: DEVI sempre eseguire un G28 prima di utilizzare questo comando. Se viene specificato MAX_DEVIATION, il comando generer\u00e0 un errore gcode se qualsiasi differenza nell'altezza della vite rispetto all'altezza della vite di base \u00e8 maggiore del valore fornito. [sdcard_loop] \u00b6 Quando la sezione di configurazione sdcard_loop \u00e8 abilitata, sono disponibili i seguenti comandi estesi. SDCARD_LOOP_BEGIN \u00b6 SDCARD_LOOP_BEGIN COUNT=<count> : inizia una sezione in loop nella stampa SD. Un conteggio pari a 0 indica che la sezione deve essere ripetuta indefinitamente. SDCARD_LOOP_END \u00b6 SDCARD_LOOP_END : termina una sezione in loop nella stampa SD. SDCARD_LOOP_DESIST \u00b6 SDCARD_LOOP_DESIST : completa i loop esistenti senza ulteriori iterazioni. [servo] \u00b6 I seguenti comandi sono disponibili quando una sezione di configurazione servo \u00e8 abilitata. SET_SERVO \u00b6 SET_SERVO SERVO=nome_config [ANGLE=<gradi> | WIDTH=<secondi>] : Imposta la posizione del servo sull'angolo dato (in gradi) o sulla larghezza dell'impulso (in secondi). Usa WIDTH=0 per disabilitare l'uscita servo. [skew_correction] \u00b6 I seguenti comandi sono disponibili quando \u00e8 abilitata la sezione config_correzione_asimmetria (consultare anche la guida Correzione_asimmetria ). SET_SKEW \u00b6 SET_SKEW [XY=<ac_length,bd_length,ad_length>] [XZ=<ac,bd,ad>] [YZ=<ac,bd,ad>] [CLEAR=<0|1>] : Configura il modulo [correzione_inclinazione ] con misure (in mm) tratte da una stampa di calibrazione. Si possono inserire misure per qualsiasi combinazione di piani, i piani non inseriti manterranno il loro valore attuale. Se viene immesso CLEAR=1 , tutta la correzione dell'inclinazione sar\u00e0 disabilitata. GET_CURRENT_SKEW \u00b6 GET_CURRENT_SKEW : Riporta l'inclinazione corrente della stampante per ciascun piano sia in radianti che in gradi. L'inclinazione viene calcolata in base ai parametri forniti tramite il gcode SET_SKEW . CALC_MEASURED_SKEW \u00b6 CALC_MEASURED_SKEW [AC=<ac_length>] [BD=<bd_length>] [AD=<ad_length>] : calcola e riporta l'inclinazione (in radianti e gradi) in base a una stampa di test misurata. Questo pu\u00f2 essere utile per determinare l'inclinazione corrente della stampante dopo che \u00e8 stata applicata la correzione. Pu\u00f2 anche essere utile prima di applicare la correzione per determinare se \u00e8 necessaria la correzione dell'inclinazione. Vedere Correzione inclinazione per i dettagli su oggetti e misurazioni di calibrazione inclinazione. SKEW_PROFILE \u00b6 SKEW_PROFILE [LOAD=<nome>] [SAVE=<nome>] [REMOVE=<nome>] : Gestione del profilo per correzione_inclinazione. LOAD ripristiner\u00e0 lo stato di inclinazione dal profilo corrispondente al nome fornito. SAVE salver\u00e0 lo stato di inclinazione corrente in un profilo che corrisponde al nome fornito. REMOVE eliminer\u00e0 il profilo corrispondente al nome fornito dalla memoria persistente. Si noti che dopo aver eseguito le operazioni SAVE o REMOVE \u00e8 necessario eseguire il gcode SAVE_CONFIG per rendere permanenti le modifiche alla memoria persistente. [smart_effector] \u00b6 Sono disponibili diversi comandi quando una sezione di configurazione smart_effector \u00e8 abilitata. Assicurati di controllare la documentazione ufficiale per Smart Effector su Duet3D Wiki prima di modificare i parametri di Smart Effector. Controllare anche la guida alla calibrazione della sonda . SET_SMART_EFFECTOR \u00b6 SET_SMART_EFFECTOR [SENSITIVITY=<sensibilit\u00e0>] [ACCEL=<accel>] [RECOVERY_TIME=<tempo>] : imposta i parametri di Smart Effector. Quando viene specificato SENSITIVITY , il rispettivo valore viene scritto nella EEPROM dello SmartEffector (richiede che sia fornito control_pin ). I valori di <sensibilit\u00e0> accettabili sono 0..255, il valore predefinito \u00e8 50. Valori inferiori richiedono una minore forza di contatto dell'ugello per attivarsi (ma esiste un rischio maggiore di falso trigger a causa delle vibrazioni durante la tastatura) e valori pi\u00f9 alti riducono il falso trigger (ma richiede una maggiore forza di contatto per attivarsi). Poich\u00e9 la sensibilit\u00e0 viene scritta nella EEPROM, viene conservata dopo lo spegnimento e quindi non \u00e8 necessario configurarla ad ogni avvio della stampante. ACCEL e RECOVERY_TIME consentono di sovrascrivere i parametri corrispondenti in fase di esecuzione, vedere la sezione di configurazione di Smart Effector per maggiori informazioni su quei parametri. RESET_SMART_EFFECTOR \u00b6 RESET_SMART_EFFECTOR : Ripristina la sensibilit\u00e0 di Smart Effector alle impostazioni di fabbrica. Richiede che il relativo control_pin sia fornito nella sezione di configurazione. [stepper_enable] \u00b6 Il modulo stepper_enable viene caricato automaticamente. SET_STEPPER_ENABLE \u00b6 SET_STEPPER_ENABLE STEPPER=<nome_config> ENABLE=[0|1] : Abilita o disabilita solo lo stepper dato. Questo \u00e8 uno strumento diagnostico e di debug e deve essere utilizzato con cautela. La disabilitazione di un motore dell'asse non ripristina le informazioni di homing. Lo spostamento manuale di uno stepper disabilitato pu\u00f2 causare l'azionamento del motore della macchina al di fuori dei limiti di sicurezza. Ci\u00f2 pu\u00f2 causare danni ai componenti dell'asse, al hotend e alla superficie di stampa. [temperature_fan] \u00b6 Il comando seguente \u00e8 disponibile quando una sezione di configurazione della ventola_temperatura \u00e8 abilitata. SET_TEMPERATURE_FAN_TARGET \u00b6 SET_TEMPERATURE_FAN_TARGET temperature_fan=<temperature_fan_name> [target=<target_temperature>] [min_speed=<min_speed>] [max_speed=<max_speed>] : Imposta la temperatura target per una temperature_fan. Se non viene fornito un target, viene impostato sulla temperatura specificata nel file di configurazione. Se le velocit\u00e0 non vengono fornite, non viene applicata alcuna modifica. [tmcXXXX] \u00b6 I seguenti comandi sono disponibili quando una qualsiasi delle tmcXXXX config section \u00e8 abilitata. DUMP_TMC \u00b6 DUMP_TMC STEPPER=<nome> : questo comando legger\u00e0 i registri del driver TMC e ne riporter\u00e0 i valori. INIT_TMC \u00b6 INIT_TMC STEPPER=<nome> : questo comando inizializzer\u00e0 i registri TMC. Necessario per riattivare il driver se l'alimentazione al chip viene spenta e poi riaccesa. SET_TMC_CURRENT \u00b6 SET_TMC_CURRENT STEPPER=<nome> CURRENT=<amps> HOLDCURRENT=<amps> : Questo regoler\u00e0 le correnti di funzionamento e di mantenimento del driver TMC. (HOLDCURRENT non \u00e8 applicabile ai driver tmc2660.) SET_TMC_FIELD \u00b6 SET_TMC_FIELD STEPPER=<nome> FIELD=<campo> VALUE=<valore> : Questo alterer\u00e0 il valore del campo del registro specificato del driver TMC. Questo comando \u00e8 destinato alla diagnostica e al debug di basso livello solo perch\u00e9 la modifica dei campi durante l'esecuzione pu\u00f2 causare comportamenti indesiderati e potenzialmente pericolosi della stampante. Le modifiche permanenti dovrebbero invece essere apportate utilizzando il file di configurazione della stampante. Non vengono eseguiti controlli di integrit\u00e0 per i valori indicati. [toolhead] \u00b6 Il modulo toolhead viene caricato automaticamente. SET_VELOCITY_LIMIT \u00b6 SET_VELOCITY_LIMIT [VELOCITY=<valore>] [ACCEL=<valore>] [ACCEL_TO_DECEL=<valore>] [SQUARE_CORNER_VELOCITY=<valore>] : Modifica i limiti di velocit\u00e0 della stampante. [tuning_tower] \u00b6 Il modulo tuning_tower viene caricato automaticamente. TUNING_TOWER \u00b6 TUNING_TOWER COMMAND=<comando> PARAMETER=<nome> START=<valore> [SKIP=<valore>] [FACTOR=<valore> [BAND=<valore>]] | [STEP_DELTA=<valore> STEP_HEIGHT=<valore>] : Uno strumento per regolare un parametro su ciascuna altezza Z durante una stampa. Lo strumento eseguir\u00e0 il dato COMMAND con il dato PARAMETER assegnato a un valore che varia con Z secondo una formula. Usa FACTOR se utilizzerai un righello o calibri per misurare l'altezza Z del valore ottimale, o STEP_DELTA e STEP_HEIGHT se il modello della torre di regolazione ha bande di valori discreti come \u00e8 comune con le torri della temperatura. Se viene specificato SKIP=<valore> , il processo di ottimizzazione non inizia finch\u00e9 non viene raggiunta l'altezza Z <valore> , e al di sotto di essa il valore sar\u00e0 impostato su START ; in questo caso, la z_height usata nelle formule seguenti \u00e8 in realt\u00e0 max(z - skip, 0) . Ci sono tre possibili combinazioni di opzioni: FACTOR : Il valore cambia a una velocit\u00e0 di factor per millimetro. La formula utilizzata \u00e8: valore = inizio + fattore * z_altezza . \u00c8 possibile inserire l'altezza Z ottimale direttamente nella formula per determinare il valore del parametro ottimale. FACTOR e BAND : il valore cambia a una velocit\u00e0 media di factor per millimetro, ma in bande discrete in cui la regolazione verr\u00e0 effettuata solo ogni BAND millimetri di altezza Z. La formula utilizzata \u00e8: value = start + factor * ((floor(z_height / band) + .5) * band) . STEP_DELTA e STEP_HEIGHT : il valore cambia di STEP_DELTA ogni STEP_HEIGHT millimetri. La formula utilizzata \u00e8: value = start + step_delta * floor(z_height / step_height) . Puoi semplicemente contare le bande o leggere le etichette della torre di tuning per determinare il valore ottimale. [virtual_sdcard] \u00b6 Klipper supporta i seguenti comandi G-Code standard se la sezione di configurazione di virtual_sdcard \u00e8 abilitata: Elenco scheda SD: M20 Inizializza scheda SD: M21 Selezionare il file SD: M23 <nomefile> Avvia/riprendi la stampa SD: M24 Sospendi la stampa SD: M25 Impostare la posizione SD: M26 S<offset> Riporta lo stato di stampa SD: M27 Inoltre, quando la sezione di configurazione \"virtual_sdcard\" \u00e8 abilitata, sono disponibili i seguenti comandi estesi. SDCARD_PRINT_FILE \u00b6 SDCARD_PRINT_FILE FILENAME=<nomefile> : carica un file e avvia la stampa SD. SDCARD_RESET_FILE \u00b6 SDCARD_RESET_FILE : Scarica il file e cancella lo stato SD. [z_thermal_adjust] \u00b6 I seguenti comandi sono disponibili quando la sezione z_thermal_adjust config \u00e8 abilitata. SET_Z_THERMAL_ADJUST \u00b6 SET_Z_THERMAL_ADJUST [ENABLE=<0:1>] [TEMP_COEFF=<valore>] [REF_TEMP=<valore>] : Abilita o disabilita la regolazione termica Z con ENABLE . La disabilitazione non rimuove alcuna regolazione gi\u00e0 applicata, ma congela il valore di regolazione corrente - questo impedisce il movimento Z verso il basso potenzialmente pericoloso. La riattivazione pu\u00f2 potenzialmente causare il movimento dell'utensile verso l'alto quando la regolazione viene aggiornata e applicata. TEMP_COEFF consente la regolazione in tempo reale del coefficiente di temperatura di regolazione (cio\u00e8 il parametro di configurazione TEMP_COEFF ). I valori TEMP_COEFF non vengono salvati nella configurazione. REF_TEMP sovrascrive manualmente la temperatura di riferimento tipicamente impostata durante l'homing (per l'uso, ad esempio, in routine di homing non standard) - verr\u00e0 ripristinata automaticamente durante l'homing. [z_tilt] \u00b6 I seguenti comandi sono disponibili quando la sezione z_tilt config \u00e8 abilitata. Z_TILT_ADJUST \u00b6 Z_TILT_ADJUST [<probe_parameter>=<value>] : questo comando sonder\u00e0 i punti specificati nella configurazione e quindi apporter\u00e0 regolazioni indipendenti a ciascuno Z stepper per compensare l'inclinazione. Vedere il comando PROBE per i dettagli sui parametri opzionali della sonda.","title":"G-Codes"},{"location":"G-Codes.html#g-codes","text":"Questo documento descrive i comandi che Klipper supporta. Questi sono i comandi che si possono inserire nella scheda del terminale OctoPrint.","title":"G-Codes"},{"location":"G-Codes.html#comandi-g-code","text":"Klipper supporta i seguenti comandi G-Code standard: Movimento (G0 or G1): G1 [X<pos>] [Y<pos>] [Z<pos>] [E<pos>] [F<speed>] Sosta: G4 P<millisecondi> Sposta all'origine: G28 [X] [Y] [Z] Spegnere i motori: M18 o M84 Attendi che li movimenti correnti finiscano: M400 Utilizzare distanze assolute/relative per l'estrusione: M82 , M83 Usa coordinate assolute/relative: G90 , G91 Impostare la posizione: G92 [X<pos>] [Y<pos>] [Z<pos>] [E<pos>] Impostare la percentuale di override del fattore di velocit\u00e0: M220 S<percentuale> Imposta la percentuale di sostituzione del fattore di estrusione: M221 S<percentuale> Impostare l'accelerazione: M204 S<valore> OPPURE M204 P<valore> T<valore> Nota: se S non viene specificato e vengono specificati sia P che T, l'accelerazione viene impostata al minimo di P e T. Se viene specificato solo uno di P o T, il comando non ha effetto. Ottieni la temperatura dell'estrusore: M105 Imposta la temperatura dell'estrusore: M104 [T<index>] [S<temperatura>] Imposta la temperatura dell'estrusore e attende: M109 [T<index>] S<temperatura> Nota: M109 attende sempre che la temperatura si assesti al valore richiesto Imposta la temperatura del piatto: M140 [S<temperatura>] Imposta la temperatura del piatto e attende: M190 S<temperatura> Nota: M190 attende sempre che la temperatura si assesti al valore richiesto Imposta la velocit\u00e0 della ventola: M106 S<valore> Spegnere la ventola: M107 Arresto di emergenza: M112 Ottieni la posizione attuale: M114 Ottieni la versione del firmware: M115 Per ulteriori dettagli sui comandi precedenti, vedere la documentazione RepRap G-Code . L'obiettivo di Klipper \u00e8 supportare i comandi G-Code prodotti da comuni software di terze parti (ad es. OctoPrint, Printrun, Slic3r, Cura, ecc.) nelle loro configurazioni standard. Non \u00e8 un obiettivo supportare ogni possibile comando G-Code. Invece, Klipper preferisce comandi leggibili dall'uomo \"comandi G-Code estesi\" . Allo stesso modo, l'output del terminale G-Code \u00e8 inteso solo per essere leggibile dall'uomo - vedere il documento del server API se si controlla Klipper da un software esterno. Se si necessita di un comando G-Code meno comune, potrebbe essere possibile implementarlo con una [sezione di configurazione gcode_macro] personalizzata (Config_Reference.md#gcode_macro). Ad esempio, si potrebbe usare questo per implementare: G12 , G29 , G30 , G31 , M42 , M80 , M81 , T1 , ecc.","title":"Comandi G-Code"},{"location":"G-Codes.html#comandi-aggiuntivi","text":"Klipper utilizza comandi G-Code \"estesi\" per la configurazione e lo stato generale. Questi comandi estesi seguono tutti un formato simile: iniziano con un nome di comando e possono essere seguiti da uno o pi\u00f9 parametri. Ad esempio: SET_SERVO SERVO=mioservo ANGLE=5.3 . In questo documento, i comandi ed i parametri sono mostrati in maiuscolo, tuttavia non fanno distinzione tra maiuscole e minuscole. (Quindi, \"SET_SERVO\" e \"set_servo\" eseguono entrambi lo stesso comando.) Questa sezione \u00e8 organizzata in base al nome del modulo Klipper, che generalmente segue i nomi delle sezioni specificati nel file di configurazione della stampante . Si noti che alcuni moduli vengono caricati automaticamente.","title":"Comandi aggiuntivi"},{"location":"G-Codes.html#adxl345","text":"I seguenti comandi sono disponibili quando una sezione di configurazione adxl345 \u00e8 abilitata.","title":"[adxl345]"},{"location":"G-Codes.html#accelerometer_measure","text":"ACCELEROMETER_MEASURE [CHIP=<config_name>] [NAME=<value>] : Avvia le misurazioni dell'accelerometro al numero richiesto di campioni al secondo. Se CHIP non \u00e8 specificato, il valore predefinito \u00e8 \"adxl345\". Il comando funziona in modalit\u00e0 start-stop: alla prima esecuzione avvia le misure, alla successiva esecuzione le interrompe. I risultati delle misurazioni vengono scritti in un file denominato /tmp/adxl345-<chip>-<name>.csv dove <chip> \u00e8 il nome del chip dell'accelerometro ( my_chip_name da [adxl345 my_chip_name] ) e <name> \u00e8 il parametro NAME facoltativo. Se NAME non \u00e8 specificato, il valore predefinito \u00e8 l'ora corrente nel formato \"AAAAMMGG_HHMMSS\". Se l'accelerometro non ha un nome nella sua sezione di configurazione (semplicemente [adxl345] ), allora la parte <chip> del nome non viene generata.","title":"ACCELEROMETER_MEASURE"},{"location":"G-Codes.html#accelerometer_query","text":"ACCELEROMETER_QUERY [CHIP=<config_name>] [RATE=<value>] : interroga l'accelerometro per il valore corrente. Se CHIP non \u00e8 specificato, il valore predefinito \u00e8 \"adxl345\". Se RATE non \u00e8 specificato, viene utilizzato il valore predefinito. Questo comando \u00e8 utile per testare la connessione all'accelerometro ADXL345: uno dei valori restituiti dovrebbe essere un'accelerazione di caduta libera (+/- un po' di rumore del chip).","title":"ACCELEROMETER_QUERY"},{"location":"G-Codes.html#accelerometer_debug_read","text":"ACCELEROMETER_DEBUG_READ [CHIP=<config_name>] REG=<register> : interroga l'ADXL345 register \"register\" (es. 44 o 0x2C). Pu\u00f2 essere utile per scopi di debug.","title":"ACCELEROMETER_DEBUG_READ"},{"location":"G-Codes.html#accelerometer_debug_write","text":"ACCELEROMETER_DEBUG_WRITE [CHIP=<nome_config>] REG=<register> VAL=<value> : Scrive il valore \"value\" grezzo in un registro \"register\". Sia \"value\" che \"registrer\" possono essere un numero intero decimale o esadecimale. Usare con cura e fare riferimento alla scheda tecnica ADXL345 per riferimento.","title":"ACCELEROMETER_DEBUG_WRITE"},{"location":"G-Codes.html#angle","text":"I seguenti comandi sono disponibili quando una sezione di configurazione dell'angolo \u00e8 abilitata.","title":"[angle]"},{"location":"G-Codes.html#angle_calibrate","text":"ANGLE_CALIBRATE CHIP=<chip_name> : Esegue la calibrazione dell'angolo sul sensore dato (deve esserci una sezione di configurazione [angle chip_name] che ha specificato un parametro stepper ). IMPORTANTE - questo strumento comander\u00e0 al motore passo-passo di muoversi senza controllare i normali limiti della cinematica. Idealmente, il motore dovrebbe essere scollegato da qualsiasi carrello della stampante prima di eseguire la calibrazione. Se non \u00e8 possibile scollegare lo stepper dalla stampante, assicurarsi che il carrello sia vicino al centro della sua guida prima di iniziare la calibrazione. (Il motore passo-passo pu\u00f2 spostarsi avanti o indietro di due rotazioni complete durante questo test.) Dopo aver completato questo test, utilizzare il comando SAVE_CONFIG per salvare i dati di calibrazione nel file di configurazione. Per utilizzare questo strumento \u00e8 necessario installare il pacchetto Python \"numpy\" (consultare il measuring resonance document per ulteriori informazioni).","title":"ANGLE_CALIBRATE"},{"location":"G-Codes.html#angle_debug_read","text":"ANGLE_DEBUG_READ CHIP=<config_name> REG=<register> : Interroga il registro del sensore \"register\" (ad es. 44 o 0x2C). Pu\u00f2 essere utile per scopi di debug. Questo \u00e8 disponibile solo per i chip tle5012b.","title":"ANGLE_DEBUG_READ"},{"location":"G-Codes.html#angle_debug_write","text":"ANGLE_DEBUG_WRITE CHIP=<config_name> REG=<register> VAL=<value> : scrive il valore \"value\" grezzo nel registro \"register\". Sia \"value\" che \"register\" possono essere un numero intero decimale o esadecimale. Usare con cautela e fare riferimento alla scheda tecnica del sensore per riferimento. Questo \u00e8 disponibile solo per i chip tle5012b.","title":"ANGLE_DEBUG_WRITE"},{"location":"G-Codes.html#bed_mesh","text":"I seguenti comandi sono disponibili quando la sezione di configurazione bed_mesh \u00e8 abilitata (consultare anche la guida della mesh del letto ).","title":"[bed_mesh]"},{"location":"G-Codes.html#bed_mesh_calibrate","text":"BED_MESH_CALIBRATE [METHOD=manual] [<probe_parameter>=<value>] [<mesh_parameter>=<value>] : Questo comando sonda il piatto utilizzando i punti generati specificati dai parametri nella configurazione. Dopo il sondaggio, viene generata una mesh e il movimento z viene regolato in base alla mesh. Vedere il comando PROBE per i dettagli sui parametri della sonda opzionali. Se viene specificato METHOD=manual, lo strumento di probing manuale \u00e8 attivato - vedere il comando MANUAL_PROBE per quanti riguarda per i dettagli sui comandi aggiuntivi disponibili mentre questo strumento \u00e8 attivo.","title":"BED_MESH_CALIBRATE"},{"location":"G-Codes.html#bed_mesh_output","text":"BED_MESH_OUTPUT PGP=[<0:1>] : questo comando restituisce i valori z sondati e i valori mesh correnti al terminale. Se viene specificato PGP=1, le coordinate X, Y generate da bed_mesh, insieme ai relativi indici associati, verranno inviate al terminale.","title":"BED_MESH_OUTPUT"},{"location":"G-Codes.html#bed_mesh_map","text":"BED_MESH_MAP : Come per BED_MESH_OUTPUT, questo comando stampa lo stato corrente della mesh sul terminale. Invece di stampare i valori in un formato leggibile, lo stato viene serializzato in formato json. Ci\u00f2 consente ai plug-in di Octoprint di acquisire facilmente i dati e generare mappe di altezza che si approssimano la superficie del piatto.","title":"BED_MESH_MAP"},{"location":"G-Codes.html#bed_mesh_clear","text":"BED_MESH_CLEAR : questo comando cancella la mesh e rimuove tutte le regolazioni z. Si consiglia di inserirlo nella parte finale del gcode.","title":"BED_MESH_CLEAR"},{"location":"G-Codes.html#bed_mesh_profile","text":"BED_MESH_PROFILE LOAD=<name> SAVE=<name> REMOVE=<name> : questo comando fornisce la gestione del profilo per lo stato della mesh. LOAD ripristiner\u00e0 lo stato della mesh dal profilo corrispondente al nome fornito. SAVE salver\u00e0 lo stato della mesh corrente in un profilo che corrisponde al nome fornito. Rimuovi eliminer\u00e0 il profilo corrispondente al nome fornito dalla memoria persistente. Si noti che dopo aver eseguito le operazioni SAVE o REMOVE \u00e8 necessario eseguire il gcode SAVE_CONFIG per rendere permanenti le modifiche alla memoria persistente.","title":"BED_MESH_PROFILE"},{"location":"G-Codes.html#bed_mesh_offset","text":"BED_MESH_OFFSET [X=<value>] [Y=<value>] : applica gli offset X e/o Y alla ricerca della mesh. Ci\u00f2 \u00e8 utile per le stampanti con estrusori indipendenti, poich\u00e9 \u00e8 necessario un offset per produrre la corretta regolazione Z dopo un cambio utensile.","title":"BED_MESH_OFFSET"},{"location":"G-Codes.html#bed_screws","text":"I seguenti comandi sono disponibili quando la sezione di configurazione bed_screws \u00e8 abilitata (consultare anche la manual level guide ).","title":"[bed_screws]"},{"location":"G-Codes.html#bed_screws_adjust","text":"BED_SCREWS_ADJUST : questo comando richiamer\u00e0 lo strumento di regolazione delle viti del piatto. Comander\u00e0 l'ugello in posizioni diverse (come definito nel file di configurazione) e consentir\u00e0 di effettuare regolazioni alle viti del piatto in modo che il piatto sia a una distanza costante dall'ugello.","title":"BED_SCREWS_ADJUST"},{"location":"G-Codes.html#bed_tilt","text":"I seguenti comandi sono disponibili quando la sezione di configurazione inclinazione_piatto \u00e8 abilitata.","title":"[bed_tilt]"},{"location":"G-Codes.html#bed_tilt_calibrate","text":"BED_TILT_CALIBRATE [METHOD=manual] [<probe_parameter>=<value>] : Questo comando sonder\u00e0 i punti specificati nella configurazione e quindi consiglier\u00e0 le regolazioni dell'inclinazione x e y aggiornate. Vedere il comando PROBE per i dettagli sui parametri della sonda opzionali. Se viene specificato METHOD=manual, lo strumento di probing manuale \u00e8 attivato - vedere il comando MANUAL_PROBE sopra per i dettagli sui comandi aggiuntivi disponibili mentre questo strumento \u00e8 attivo.","title":"BED_TILT_CALIBRATE"},{"location":"G-Codes.html#bltouch","text":"Il comando seguente \u00e8 disponibile quando \u00e8 abilitata una sezione di configurazione bltouch (vedere anche la Guida BL-Touch ).","title":"[bltouch]"},{"location":"G-Codes.html#bltouch_debug","text":"BLTOUCH_DEBUG COMMAND=<command> : Invia un comando al BLTouch. Pu\u00f2 essere utile per il debug. I comandi disponibili sono: pin_down , touch_mode , pin_up , self_test , reset . Un BL-Touch V3.0 o V3.1 pu\u00f2 anche supportare i comandi set_5V_output_mode , set_OD_output_mode , output_mode_store .","title":"BLTOUCH_DEBUG"},{"location":"G-Codes.html#bltouch_store","text":"BLTOUCH_STORE MODE=<output_mode> : memorizza una modalit\u00e0 di output nella EEPROM di un BLTouch V3.1 Le modalit\u00e0 di output disponibili sono: 5V , OD","title":"BLTOUCH_STORE"},{"location":"G-Codes.html#configfile","text":"Il modulo configfile viene caricato automaticamente.","title":"[configfile]"},{"location":"G-Codes.html#save_config","text":"SAVE_CONFIG : questo comando sovrascriver\u00e0 il file di configurazione della stampante principale e riavvier\u00e0 il software host. Questo comando viene utilizzato insieme ad altri comandi di calibrazione per memorizzare i risultati dei test di calibrazione.","title":"SAVE_CONFIG"},{"location":"G-Codes.html#delayed_gcode","text":"Il comando seguente \u00e8 abilitato se \u00e8 stata abilitata una sezione di configurazione di gcode ritardata (consultare anche la guida ai modelli ).","title":"[delayed_gcode]"},{"location":"G-Codes.html#update_delayed_gcode","text":"UPDATE_DELAYED_GCODE [ID=<nome>] [DURATION=<secondi>] : aggiorna la durata del ritardo per il [gcode_ritardato] identificato e avvia il timer per l'esecuzione di gcode. Un valore di 0 annuller\u00e0 l'esecuzione di un gcode ritardato in sospeso.","title":"UPDATE_DELAYED_GCODE"},{"location":"G-Codes.html#delta_calibrate","text":"I seguenti comandi sono disponibili quando la sezione di configurazione delta_calibrate \u00e8 abilitata (consultare anche la guida alla calibrazione delta ).","title":"[delta_calibrate]"},{"location":"G-Codes.html#delta_calibrate_1","text":"DELTA_CALIBRATE [METHOD=manual] [<probe_parameter>=<value>] : questo comando sonder\u00e0 sette punti sul piatto e consiglier\u00e0 posizioni di finecorsa, angoli della torre e raggio aggiornati. Vedere il comando PROBE per i dettagli sui parametri della sonda opzionali. Se viene specificato METHOD=manual, lo strumento di probe manuale \u00e8 attivato - vedere il comando MANUAL_PROBE precedente per i dettagli sui comandi aggiuntivi disponibili mentre questo strumento \u00e8 attivo.","title":"DELTA_CALIBRATE"},{"location":"G-Codes.html#delta_analyze","text":"DELTA_ANALYZE : questo comando viene utilizzato durante la calibrazione avanzata delle stampanti delta. Vedere Delta Calibrate per i dettagli.","title":"DELTA_ANALYZE"},{"location":"G-Codes.html#display","text":"Il comando seguente \u00e8 disponibile quando \u00e8 abilitata una sezione di configurazione display .","title":"[display]"},{"location":"G-Codes.html#set_display_group","text":"SET_DISPLAY_GROUP [DISPLAY=<display>] GROUP=<group> : Imposta il gruppo di visualizzazione attivo di un display LCD. Ci\u00f2 consente di definire pi\u00f9 gruppi di dati di visualizzazione nella configurazione, ad es. [display_data <group> <elementname>] e passare da uno all'altro usando questo comando gcode esteso. Se DISPLAY non \u00e8 specificato, l'impostazione predefinita \u00e8 \"display\" (il display principale).","title":"SET_DISPLAY_GROUP"},{"location":"G-Codes.html#display_status","text":"Il modulo display_status viene caricato automaticamente se una sezione di configurazione display \u00e8 abilitata. Fornisce i seguenti comandi G-Code standard: Messaggio visualizzato: M117 <messaggio> Imposta la percentuale di costruzione: M73 P<percentuale> Viene inoltre fornito il seguente comando G-Code esteso: SET_DISPLAY_TEXT MSG=<messaggio> : esegue l'equivalente di M117, impostando il MSG fornito come messaggio visualizzato. Se MSG viene omesso, il display verr\u00e0 cancellato.","title":"[display_status]"},{"location":"G-Codes.html#dual_carriage","text":"Il comando seguente \u00e8 disponibile quando la sezione di configurazione dual_carriage \u00e8 abilitata.","title":"[dual_carriage]"},{"location":"G-Codes.html#set_dual_carriage","text":"SET_DUAL_CARRIAGE CARRIAGE=[0|1] : Questo comando imposter\u00e0 il carrello attivo. Viene in genere richiamato dai campi activate_gcode e deactivate_gcode in una configurazione a pi\u00f9 estrusori.","title":"SET_DUAL_CARRIAGE"},{"location":"G-Codes.html#endstop_phase","text":"I seguenti comandi sono disponibili quando una sezione di configurazione endstop_phase \u00e8 abilitata (consultare anche la guida alla fase endstop ).","title":"[endstop_phase]"},{"location":"G-Codes.html#endstop_phase_calibrate","text":"ENDSTOP_PHASE_CALIBRATE [STEPPER=<config_name>] : Se non viene fornito alcun parametro STEPPER, questo comando riporter\u00e0 le statistiche sulle fasi stepper dell'arresto durante le precedenti operazioni di homing. Quando viene fornito un parametro STEPPER, fa in modo che l'impostazione della fase di fine corsa fornita sia scritta nel file di configurazione (insieme al comando SAVE_CONFIG).","title":"ENDSTOP_PHASE_CALIBRATE"},{"location":"G-Codes.html#exclude_object","text":"I seguenti comandi sono disponibili quando \u00e8 abilitata una exclude_object config section (consultare anche la exclude object guide ):","title":"[exclude_object]"},{"location":"G-Codes.html#exclude_object_1","text":"EXCLUDE_OBJECT [NAME=object_name] [CURRENT=1] [RESET=1] : Senza parametri, questo restituir\u00e0 un elenco di tutti gli oggetti attualmente esclusi. Quando viene fornito il parametro NAME , l'oggetto denominato verr\u00e0 escluso dalla stampa. Quando viene fornito il parametro CURRENT , l'oggetto corrente verr\u00e0 escluso dalla stampa. Quando viene fornito il parametro RESET l'elenco degli oggetti esclusi verr\u00e0 cancellato. Inoltre l'inclusione di NAME ripristiner\u00e0 solo l'oggetto denominato. Questo pu\u00f2 causare errori di stampa, se i livelli sono gi\u00e0 stati saltati.","title":"EXCLUDE_OBJECT"},{"location":"G-Codes.html#exclude_object_define","text":"EXCLUDE_OBJECT_DEFINE [NAME=object_name [CENTER=X,Y] [POLYGON=[[x,y],...]] [RESET=1] [JSON=1] : fornisce un riepilogo di un oggetto nel file. Senza parametri forniti, questo elencher\u00e0 gli oggetti definiti noti a Klipper. Restituisce un elenco di stringhe, a meno che non venga fornito il parametro JSON , quando restituir\u00e0 i dettagli dell'oggetto in formato json. Quando il parametro NAME \u00e8 incluso, definisce un oggetto da escludere. NAME : questo parametro \u00e8 obbligatorio. \u00c8 l'identificatore utilizzato da altri comandi in questo modulo. CENTER : una coordinata X,Y per l'oggetto. POLYGON : Un array di coordinate X,Y che fornisce un contorno per l'oggetto. Quando viene fornito il parametro RESET , tutti gli oggetti definiti verranno cancellati e il modulo [exclude_object] verr\u00e0 ripristinato.","title":"EXCLUDE_OBJECT_DEFINE"},{"location":"G-Codes.html#exclude_object_start","text":"EXCLUDE_OBJECT_START NAME=object_name : questo comando prende un parametro NAME e marca l'inizio del gcode per un oggetto sul livello corrente.","title":"EXCLUDE_OBJECT_START"},{"location":"G-Codes.html#exclude_object_end","text":"EXCLUDE_OBJECT_END [NAME=object_name] : Denota la fine del gcode dell'oggetto per il livello. \u00c8 accoppiato con EXCLUDE_OBJECT_START . Un parametro NAME \u00e8 facoltativo e avviser\u00e0 solo quando il nome fornito non corrisponde all'oggetto corrente.","title":"EXCLUDE_OBJECT_END"},{"location":"G-Codes.html#extruder","text":"I seguenti comandi sono disponibili se una sezione di configurazione dell'estrusore \u00e8 abilitata:","title":"[extruder]"},{"location":"G-Codes.html#activate_extruder","text":"ACTIVATE_EXTRUDER EXTRUDER=<config_name> : in una stampante con pi\u00f9 sezioni di configurazione extruder , questo comando cambia l'hotend attivo.","title":"ACTIVATE_EXTRUDER"},{"location":"G-Codes.html#set_pressure_advance","text":"SET_PRESSURE_ADVANCE [EXTRUDER=<config_name>] [ADVANCE=<pressure_advance>] [SMOOTH_TIME=<pressure_advance_smooth_time>] : Imposta i parametri di pressure advance delleo stepper di un estrusore (come definito in un estrusore o [ extruder_stepper] (sezione di configurazione Config_Reference.md#extruder_stepper). Se EXTRUDER non \u00e8 specificato, per impostazione predefinita viene utilizzato lo stepper definito nell'hotend attivo.","title":"SET_PRESSURE_ADVANCE"},{"location":"G-Codes.html#set_extruder_rotation_distance","text":"SET_EXTRUDER_ROTATION_DISTANCE EXTRUDER=<config_name> [DISTANCE=<distance>] : Imposta un nuovo valore per la \"distanza di rotazione\" dello stepper dell'estrusore fornito (come definito in un extruder o extruder_stepper sezione di configurazione). Se la distanza di rotazione \u00e8 un numero negativo, il movimento passo-passo verr\u00e0 invertito (rispetto alla direzione passo-passo specificata nel file di configurazione). Le impostazioni modificate non vengono mantenute al ripristino di Klipper. Usare con cautela poich\u00e9 piccole modifiche possono causare una pressione eccessiva tra l'estrusore e l'hotend. Eseguire una corretta calibrazione con il filamento prima dell'uso. Se il valore 'DISTANZA' non viene fornito, questo comando restituir\u00e0 la distanza di rotazione corrente.","title":"SET_EXTRUDER_ROTATION_DISTANCE"},{"location":"G-Codes.html#sync_extruder_motion","text":"SYNC_EXTRUDER_MOTION EXTRUDER=<nome> MOTION_QUEUE=<nome> : questo comando attiver\u00e0 lo stepper specificato da EXTRUDER (come definito in un extruder o extruder_stepper config sezione) per sincronizzarsi con il movimento di un estrusore specificato da MOTION_QUEUE (come definito in una sezione di configurazione estrusore ). Se MOTION_QUEUE \u00e8 una stringa vuota, lo stepper verr\u00e0 desincronizzato da tutti i movimenti dell'estrusore.","title":"SYNC_EXTRUDER_MOTION"},{"location":"G-Codes.html#set_extruder_step_distance","text":"Questo comando \u00e8 deprecato e verr\u00e0 rimosso nel prossimo futuro.","title":"SET_EXTRUDER_STEP_DISTANCE"},{"location":"G-Codes.html#sync_stepper_to_extruder","text":"Questo comando \u00e8 deprecato e verr\u00e0 rimosso nel prossimo futuro.","title":"SYNC_STEPPER_TO_EXTRUDER"},{"location":"G-Codes.html#fan_generic","text":"Il comando seguente \u00e8 disponibile quando una sezione di configurazione fan_generic \u00e8 abilitata.","title":"[fan_generic]"},{"location":"G-Codes.html#set_fan_speed","text":"SET_FAN_SPEED FAN=config_name SPEED=<velocit\u00e0> Questo comando imposta la velocit\u00e0 di una ventola. \"velocit\u00e0\" deve essere compresa tra 0.0 e 1.0.","title":"SET_FAN_SPEED"},{"location":"G-Codes.html#filament_switch_sensor","text":"Il comando seguente \u00e8 disponibile quando \u00e8 abilitata una sezione di configurazione filament_switch_sensor o filament_motion_sensor .","title":"[filament_switch_sensor]"},{"location":"G-Codes.html#query_filament_sensor","text":"QUERY_FILAMENT_SENSOR SENSOR=<sensor_name> : Interroga lo stato del sensore di filamento. I dati visualizzati sul terminale dipenderanno dal tipo di sensore definito nella configurazione.","title":"QUERY_FILAMENT_SENSOR"},{"location":"G-Codes.html#set_filament_sensor","text":"SET_FILAMENT_SENSOR SENSOR=<nome_sensore> ENABLE=[0|1] : Attiva/disattiva il sensore di filamento. Se ENABLE \u00e8 impostato su 0, il sensore di filamento sar\u00e0 disabilitato, se impostato su 1 sar\u00e0 abilitato.","title":"SET_FILAMENT_SENSOR"},{"location":"G-Codes.html#firmware_retraction","text":"I seguenti comandi G-Code standard sono disponibili quando la sezione di configurazione firmware_retraction \u00e8 abilitata. Questi comandi consentono di utilizzare la funzione di retraction del firmware disponibile in molti slicer, per ridurre lo stringing durante gli spostamenti di non estrusione da una parte all'altra della stampa. Configurando opportunamente la pressure advance si riduce la lunghezza della retrazione richiesta. G10 : Ritrae l'estrusore utilizzando i parametri attualmente configurati. G11 : Ritira l'estrusore utilizzando i parametri attualmente configurati. Sono inoltre disponibili i seguenti comandi aggiuntivi.","title":"[firmware_retraction]"},{"location":"G-Codes.html#set_retraction","text":"SET_RETRACTION [RETRACT_LENGTH=<mm>] [RETRACT_SPEED=<mm/s>] [UNRETRACT_EXTRA_LENGTH=<mm>] [UNRETRACT_SPEED=<mm/s>] : regola i parametri utilizzati dalla retrazione. RETRACT_LENGTH determina la lunghezza del filamento da ritrarre e estrudere. La velocit\u00e0 di retrazione viene regolata tramite RETRACT_SPEED, ed \u00e8 generalmente impostata su un valore relativamente alto. La velocit\u00e0 di annullamento viene regolata tramite UNRETRACT_SPEED e non \u00e8 particolarmente critica, sebbene spesso inferiore a RETRACT_SPEED. In alcuni casi \u00e8 utile aggiungere una piccola quantit\u00e0 di lunghezza aggiuntiva all'annullamento della retrazione, e questa viene impostata tramite UNRETRACT_EXTRA_LENGTH. SET_RETRACTION \u00e8 comunemente impostato come parte della configurazione dello slicer per filamento, poich\u00e9 filamenti diversi richiedono impostazioni dei parametri diverse.","title":"SET_RETRACTION"},{"location":"G-Codes.html#get_retraction","text":"GET_RETRACTION : interroga i parametri correnti utilizzati dal firmware per retrazione e li visualizza sul terminale.","title":"GET_RETRACTION"},{"location":"G-Codes.html#force_move","text":"Il modulo force_move viene caricato automaticamente, tuttavia alcuni comandi richiedono l'impostazione di enable_force_move in printer config .","title":"[force_move]"},{"location":"G-Codes.html#stepper_buzz","text":"STEPPER_BUZZ STEPPER=<nome_config> : sposta lo stepper dato in avanti di 1 mm e poi indietro di 1 mm, ripetuto 10 volte. Questo \u00e8 uno strumento diagnostico per aiutare a verificare la connettivit\u00e0 stepper.","title":"STEPPER_BUZZ"},{"location":"G-Codes.html#force_move_1","text":"FORCE_MOVE STEPPER=<nome_config> DISTANCE=<value> VELOCITY=<value> [ACCEL=<value>] : Questo comando sposter\u00e0 forzatamente lo stepper dato della distanza data (in mm) alla velocit\u00e0 costante data (in mm/ S). Se viene specificato ACCEL ed \u00e8 maggiore di zero, verr\u00e0 utilizzata l'accelerazione data (in mm/s^2); altrimenti non viene eseguita alcuna accelerazione. Non vengono effettuati controlli sui limiti; non vengono effettuati aggiornamenti cinematici; altri stepper paralleli su un asse non verranno spostati. Prestare attenzione poich\u00e9 un comando errato potrebbe causare danni! L'uso di questo comando metter\u00e0 quasi sicuramente la cinematica di basso livello in uno stato errato; emettere un G28 in seguito per ripristinare la cinematica. Questo comando \u00e8 destinato alla diagnostica e al debug di basso livello.","title":"FORCE_MOVE"},{"location":"G-Codes.html#set_kinematic_position","text":"SET_KINEMATIC_POSITION [X=<valore>] [Y=<valore>] [Z=<valore>] : forza il codice cinematico di basso livello a credere che la testa di stampa si trovi nella posizione cartesiana data. Questo \u00e8 un comando diagnostico e di debug; utilizzare SET_GCODE_OFFSET e/o G92 per le normali trasformazioni degli assi. Se un asse non \u00e8 specificato, verr\u00e0 impostato automaticamente sulla posizione in cui la testa \u00e8 stata comandata l'ultima volta. L'impostazione di una posizione errata o non valida pu\u00f2 causare errori software interni. Questo comando potrebbe invalidare futuri controlli sui confini; emettere un G28 in seguito per ripristinare la cinematica.","title":"SET_KINEMATIC_POSITION"},{"location":"G-Codes.html#gcode","text":"Il modulo gcode viene caricato automaticamente.","title":"[gcode]"},{"location":"G-Codes.html#restart","text":"RESTART : Ci\u00f2 far\u00e0 s\u00ec che il software host ricarichi la sua configurazione ed esegua un ripristino interno. Questo comando non canceller\u00e0 lo stato di errore dal microcontrollore (vedi FIRMWARE_RESTART) n\u00e9 caricher\u00e0 nuovo software (vedi FAQ ) .","title":"RESTART"},{"location":"G-Codes.html#firmware_restart","text":"FIRMWARE_RESTART : Questo \u00e8 simile a un comando RESTART, ma cancella anche qualsiasi stato di errore dal microcontrollore.","title":"FIRMWARE_RESTART"},{"location":"G-Codes.html#status","text":"STATUS : segnala lo stato del software host di Klipper.","title":"STATUS"},{"location":"G-Codes.html#help","text":"HELP : riporta l'elenco dei comandi G-Code estesi disponibili.","title":"HELP"},{"location":"G-Codes.html#gcode_arcs","text":"I seguenti comandi G-Code standard sono disponibili se una sezione di configurazione gcode_arcs \u00e8 abilitata: Movimento dell'arco in senso orario (G2), Movimento dell'arco in senso antiorario (G3): G2|G3 [X<pos>] [Y<pos>] [Z<pos>] [E<pos>] [F<velocit\u00e0>] I<valore> J<valore>|I<valore> K<valore>|J<valore> K<valore> Selezione del piano dell'arco: G17 (piano XY), G18 (piano XZ), G19 (piano YZ)","title":"[gcode_arcs]"},{"location":"G-Codes.html#gcode_macro","text":"Il comando seguente \u00e8 disponibile quando \u00e8 abilitata una sezione di configurazione gcode_macro (consultare anche la guida ai modelli di comando ).","title":"[gcode_macro]"},{"location":"G-Codes.html#set_gcode_variable","text":"SET_GCODE_VARIABLE MACRO=<nome_macro> VARIABLE=<nome> VALUE=<valore> : questo comando consente di modificare il valore di una variabile gcode_macro in fase di esecuzione. Il VALUE fornito viene analizzato come un valore literal in Python.","title":"SET_GCODE_VARIABLE"},{"location":"G-Codes.html#gcode_move","text":"Il modulo gcode_move viene caricato automaticamente.","title":"[gcode_move]"},{"location":"G-Codes.html#get_position","text":"GET_POSITION`: Restituisce informazioni sulla posizione corrente della testa di stampa. Per ulteriori informazioni, vedere la documentazione per gli sviluppatori di GET_POSITION output .","title":"GET_POSITION"},{"location":"G-Codes.html#set_gcode_offset","text":"SET_GCODE_OFFSET [X=<pos>|X_ADJUST=<regola>] [Y=<pos>|Y_ADJUST=<regola>] [Z=<pos>|Z_ADJUST=<regola>] [MOVE=1 [MOVE_SPEED=<velocit\u00e0 >]] : imposta un offset di posizione da applicare ai futuri comandi G-Code. Questo \u00e8 comunemente usato per cambiare virtualmente l'offset del letto Z o per impostare gli offset XY degli ugelli quando si cambia estrusore. Ad esempio, se viene inviato \"SET_GCODE_OFFSET Z=0.2\", i futuri movimenti G-Code avranno 0.2 mm aggiunti alla loro altezza Z. Se vengono utilizzati i parametri di stile X_ADJUST, la regolazione verr\u00e0 aggiunta a qualsiasi offset esistente (ad esempio, \"SET_GCODE_OFFSET Z=-0.2\" seguito da \"SET_GCODE_OFFSET Z_ADJUST=0.3\" risulter\u00e0 in un offset Z totale di 0.1). Se viene specificato \"MOVE=1\", verr\u00e0 emesso un movimento della testa di stampa per applicare l'offset specificato (altrimenti l'offset avr\u00e0 effetto sul successivo movimento assoluto del codice G che specifica l'asse dato). Se viene specificato \"MOVE_SPEED\", lo spostamento della testa utensile verr\u00e0 eseguito con la velocit\u00e0 data (in mm/s); in caso contrario, il movimento della testa utensile utilizzer\u00e0 l'ultima velocit\u00e0 del G-code specificata.","title":"SET_GCODE_OFFSET"},{"location":"G-Codes.html#save_gcode_state","text":"SAVE_GCODE_STATE [NAME=<nome_stato>] : salva lo stato di analisi delle coordinate del G-code corrente. Il salvataggio e il ripristino dello stato del G-code \u00e8 utile negli script e nelle macro. Questo comando salva la modalit\u00e0 di coordinate assolute del G-code corrente (G90/G91), la modalit\u00e0 di estrusione assoluta (M82/M83), l'origine (G92), l'offset (SET_GCODE_OFFSET), l'override della velocit\u00e0 (M220), l'override dell'estrusore (M221), la velocit\u00e0 di spostamento , la posizione XYZ corrente e la posizione relativa dell'estrusore \"E\". Se viene fornito NAME, consente di assegnare un nome allo stato salvato alla stringa data. Se NAME non viene fornito, il valore predefinito \u00e8 \"predefinito\".","title":"SAVE_GCODE_STATE"},{"location":"G-Codes.html#restore_gcode_state","text":"RESTORE_GCODE_STATE [NAME=<nome_stato>] [MOVE=1 [MOVE_SPEED=<velocit\u00e0>]] : ripristina uno stato precedentemente salvato tramite SAVE_GCODE_STATE. Se viene specificato \"MOVE=1\", verr\u00e0 emesso un movimento della testa utensile per tornare alla posizione XYZ precedente. Se viene specificato \"MOVE_SPEED\", lo spostamento della testa utensile verr\u00e0 eseguito con la velocit\u00e0 data (in mm/s); in caso contrario, lo spostamento della testa utensile utilizzer\u00e0 la velocit\u00e0 del codice g ripristinata.","title":"RESTORE_GCODE_STATE"},{"location":"G-Codes.html#hall_filament_width_sensor","text":"I seguenti comandi sono disponibili quando la sezione di configurazione del sensore di larghezza del filamento tsl1401cl o sezione di configurazione del sensore di larghezza del filamento hall \u00e8 abilitata (consultare anche Sensore di larghezza del filamento TSLl401CL e Hall Filament Width Sensor ):","title":"[hall_filament_width_sensor]"},{"location":"G-Codes.html#query_filament_width","text":"QUERY_FILAMENT_WIDTH : Restituisce lo spessore del filamento misurato.","title":"QUERY_FILAMENT_WIDTH"},{"location":"G-Codes.html#reset_filament_width_sensor","text":"RESET_FILAMENT_WIDTH_SENSOR : Cancella tutte le letture del sensore. Utile dopo il cambio del filamento.","title":"RESET_FILAMENT_WIDTH_SENSOR"},{"location":"G-Codes.html#disable_filament_width_sensor","text":"DISABLE_FILAMENT_WIDTH_SENSOR : Spegnere il sensore di larghezza del filamento e smettere di usarlo per il controllo del flusso.","title":"DISABLE_FILAMENT_WIDTH_SENSOR"},{"location":"G-Codes.html#enable_filament_width_sensor","text":"ENABLE_FILAMENT_WIDTH_SENSOR : attiva il sensore di larghezza del filamento e inizia a usarlo per il controllo del flusso.","title":"ENABLE_FILAMENT_WIDTH_SENSOR"},{"location":"G-Codes.html#query_raw_filament_width","text":"QUERY_RAW_FILAMENT_WIDTH : Restituisce le letture del canale ADC corrente e il valore grezzo (raw) del sensore per i punti di calibrazione.","title":"QUERY_RAW_FILAMENT_WIDTH"},{"location":"G-Codes.html#enable_filament_width_log","text":"ENABLE_FILAMENT_WIDTH_LOG : attiva la registrazione del diametro del filamento.","title":"ENABLE_FILAMENT_WIDTH_LOG"},{"location":"G-Codes.html#disable_filament_width_log","text":"DISABLE_FILAMENT_WIDTH_LOG : Disattiva la registrazione del diametro del filamento.","title":"DISABLE_FILAMENT_WIDTH_LOG"},{"location":"G-Codes.html#heaters","text":"Il modulo heaters viene caricato automaticamente se un riscaldatore \u00e8 definito nel file di configurazione.","title":"[heaters]"},{"location":"G-Codes.html#turn_off_heaters","text":"TURN_OFF_HEATERS : Spegni tutti i riscaldatori.","title":"TURN_OFF_HEATERS"},{"location":"G-Codes.html#temperature_wait","text":"TEMPERATURE_WAIT SENSOR=<config_name> [MINIMUM=<target>] [MAXIMUM=<target>] : Attendere fino a quando il sensore di temperatura specificato \u00e8 pari o superiore al MINIMO fornito e/o pari o inferiore al MASSIMO fornito.","title":"TEMPERATURE_WAIT"},{"location":"G-Codes.html#set_heater_temperature","text":"SET_HEATER_TEMPERATURE HEATER=<nome_riscaldatore> [TARGET=<temperatura_destinata>] : Imposta la temperatura target per un riscaldatore. Se non viene fornita una temperatura target, il target \u00e8 0.","title":"SET_HEATER_TEMPERATURE"},{"location":"G-Codes.html#idle_timeout","text":"Il modulo idle_timeout viene caricato automaticamente.","title":"[idle_timeout]"},{"location":"G-Codes.html#set_idle_timeout","text":"SET_IDLE_TIMEOUT [TIMEOUT=<timeout>] : consente all'utente di impostare il timeout di inattivit\u00e0 (in secondi).","title":"SET_IDLE_TIMEOUT"},{"location":"G-Codes.html#input_shaper","text":"Il comando seguente \u00e8 abilitato se \u00e8 stata abilitata una sezione di configurazione di input_shaper (consultare anche la guida alla compensazione della risonanza ).","title":"[input_shaper]"},{"location":"G-Codes.html#set_input_shaper","text":"SET_INPUT_SHAPER [SHAPER_FREQ_X=<shaper_freq_x>] [SHAPER_FREQ_Y=<shaper_freq_y>] [DAMPING_RATIO_X=<damping_ratio_x>] [DAMPING_RATIO_Y=<damping_ratio_y>] [SHAPER_TYPE=<shaper>] [SHAPER_TYPE_X=<shaper_type_x>] [SHAPER_TYPE=<shaper_TYPE_X=<shaper_type_x>] [SHAPER_TYPE=<shaper_type_y=<shaper_type_x> ] : Modifica i parametri dell'input shaper. Si noti che il parametro SHAPER_TYPE reimposta l'input shaper per entrambi gli assi X e Y anche se sono stati configurati tipi di shaper diversi nella sezione [input_shaper]. SHAPER_TYPE non pu\u00f2 essere utilizzato insieme a uno dei parametri SHAPER_TYPE_X e SHAPER_TYPE_Y. Vedere config reference per maggiori dettagli su ciascuno di questi parametri.","title":"SET_INPUT_SHAPER"},{"location":"G-Codes.html#manual_probe","text":"Il modulo manual_probe viene caricato automaticamente.","title":"[manual_probe]"},{"location":"G-Codes.html#manual_probe_1","text":"MANUAL_PROBE [SPEED=<speed>] : esegue uno script di supporto utile per misurare l'altezza dell'ugello in una determinata posizione. Se viene specificato SPEED, imposta la velocit\u00e0 dei comandi TESTZ (il valore predefinito \u00e8 5mm/s). Durante una sonda manuale, sono disponibili i seguenti comandi aggiuntivi: ACCEPT : questo comando accetta la posizione Z corrente e conclude il probing manuale. ABORT : questo comando termina lo strumento di probing manuale. TESTZ Z=<valore> : questo comando sposta l'ugello verso l'alto o verso il basso della quantit\u00e0 specificata in \"valore\". Ad esempio, TESTZ Z=-.1 sposterebbe l'ugello verso il basso di .1 mm mentre TESTZ Z=.1 sposterebbe l'ugello verso l'alto di .1 mm. Il valore pu\u00f2 anche essere + , - , ++ o -- per spostare l'ugello verso l'alto o verso il basso di un importo rispetto ai tentativi precedenti.","title":"MANUAL_PROBE"},{"location":"G-Codes.html#z_endstop_calibrate","text":"Z_ENDSTOP_CALIBRATE [SPEED=<speed>] : esegue uno script di supporto utile per calibrare un'impostazione di configurazione Z position_endstop. Vedere il comando MANUAL_PROBE per i dettagli sui parametri e sui comandi aggiuntivi disponibili mentre lo strumento \u00e8 attivo.","title":"Z_ENDSTOP_CALIBRATE"},{"location":"G-Codes.html#z_offset_apply_endstop","text":"Z_OFFSET_APPLY_ENDSTOP : prende l'offset Z Gcode corrente (noto anche come babystepping) e lo sottrae da stepper_z endstop_position. Questa azione per prendere un valore di babystep utilizzato di frequente e \"renderlo permanente\". Richiede un SAVE_CONFIG per avere effetto.","title":"Z_OFFSET_APPLY_ENDSTOP"},{"location":"G-Codes.html#stepper-manuali","text":"Il comando seguente \u00e8 disponibile quando una sezione di configurazione stepper_manuale \u00e8 abilitata.","title":"[Stepper manuali]"},{"location":"G-Codes.html#manual_stepper","text":"MANUAL_STEPPER STEPPER=nome_config [ENABLE=[0|1]] [SET_POSITION=<pos>] [SPEED=<velocit\u00e0>] [ACCEL=<accelerazione>] [MOVE=<pos> [STOP_ON_ENDSTOP=[1|2|- 1|-2]] [SYNC=0]] : Questo comando alterer\u00e0 lo stato dello stepper. Utilizzare il parametro ENABLE per abilitare/disabilitare lo stepper. Utilizzare il parametro SET_POSITION per forzare lo stepper a pensare di trovarsi nella posizione data. Utilizzare il parametro MOVE per richiedere un movimento alla posizione data. Se viene specificato SPEED e/o ACCEL, verranno utilizzati i valori forniti al posto dei valori predefiniti specificati nel file di configurazione. Se viene specificato un ACCEL pari a zero, non verr\u00e0 eseguita alcuna accelerazione. Se viene specificato STOP_ON_ENDSTOP=1, lo spostamento terminer\u00e0 in anticipo se l'endstop segnala come attivato (usa STOP_ON_ENDSTOP=2 per completare lo spostamento senza errori anche se l'endstop non si attiva, usa -1 o -2 per interrompere quando l'endstop segnala non innescato). Normalmente i futuri comandi G-Code verranno programmati per essere eseguiti dopo il completamento del movimento passo-passo, tuttavia se un movimento passo-passo manuale utilizza SYNC=0, i futuri comandi di movimento G-Code potrebbero essere eseguiti in parallelo con il movimento passo-passo.","title":"MANUAL_STEPPER"},{"location":"G-Codes.html#mcp4018","text":"Il comando seguente \u00e8 disponibile quando una sezione di configurazione mcp4018 \u00e8 abilitata.","title":"[mcp4018]"},{"location":"G-Codes.html#set_digipot","text":"SET_DIGIPOT DIGIPOT=config_name WIPER=<value> : Questo comando cambier\u00e0 il valore corrente del digipot. Questo valore dovrebbe essere in genere compreso tra 0.0 e 1.0, a meno che non sia definita una 'scale' nella configurazione. Quando viene definita 'scale', questo valore dovrebbe essere compreso tra 0,0 e 'scale'.","title":"SET_DIGIPOT"},{"location":"G-Codes.html#led","text":"Il comando seguente \u00e8 disponibile quando una qualsiasi delle sezioni di configurazione led \u00e8 abilitata.","title":"[led]"},{"location":"G-Codes.html#set_led","text":"SET_LED LED=<nome_config> ROSSO=<valore> VERDE=<valore> BLU=<valore> BIANCO=<valore> [INDEX=<indice>] [TRANSMIT=0] [SYNC=1] : Imposta il LED in output. Ogni colore <valore> deve essere compreso tra 0,0 e 1,0. L'opzione BIANCO \u00e8 valida solo su LED RGBW. Se il LED supporta pi\u00f9 chip in una catena daisy-chain, \u00e8 possibile specificare INDEX per modificare il colore del solo chip specificato (1 per il primo chip, 2 per il secondo, ecc.). Se INDEX non viene fornito, tutti i LED nella catena verranno impostati sul colore fornito. Se viene specificato TRANSMIT=0, il cambio colore verr\u00e0 effettuato solo sul successivo comando SET_LED che non specifica TRANSMIT=0; questo pu\u00f2 essere utile in combinazione con il parametro INDEX per raggruppare pi\u00f9 aggiornamenti in una catena. Per impostazione predefinita, il comando SET_LED sincronizzer\u00e0 le modifiche con altri comandi gcode in corso. Ci\u00f2 pu\u00f2 comportare un comportamento indesiderato se i LED vengono impostati mentre la stampante non sta stampando in quanto reimposta il timeout di inattivit\u00e0. Se non \u00e8 necessaria una tempistica attenta, \u00e8 possibile specificare il parametro SYNC=0 opzionale per applicare le modifiche senza ripristinare il timeout di inattivit\u00e0.","title":"SET_LED"},{"location":"G-Codes.html#set_led_template","text":"SET_LED_TEMPLATE LED=<nome_led> TEMPLATE=<nome_modello> [<param_x>=<letterale>] [INDEX=<indice>] : Assegna un modello_visualizzazione a un dato LED . Ad esempio, se si definisce una sezione di configurazione [display_template my_led_template] allora si potrebbe assegnare TEMPLATE=my_led_template qui. Il display_template dovrebbe produrre una stringa separata da virgole contenente quattro numeri in virgola mobile corrispondenti alle impostazioni dei colori rosso, verde, blu e bianco. Il modello verr\u00e0 continuamente valutato e il LED verr\u00e0 impostato automaticamente sui colori risultanti. \u00c8 possibile impostare i parametri display_template da utilizzare durante la valutazione del modello (i parametri verranno analizzati come valori letterali Python). Se INDEX non \u00e8 specificato, tutti i chip nella catena dei LED verranno impostati sul modello, altrimenti verr\u00e0 aggiornato solo il chip con l'indice specificato. Se TEMPLATE \u00e8 una stringa vuota, questo comando canceller\u00e0 qualsiasi modello precedente assegnato al LED (\u00e8 quindi possibile utilizzare i comandi SET_LED per gestire le impostazioni del colore del LED).","title":"SET_LED_TEMPLATE"},{"location":"G-Codes.html#output_pin","text":"Il comando seguente \u00e8 disponibile quando una sezione di configurazione pin_output \u00e8 abilitata.","title":"[output_pin]"},{"location":"G-Codes.html#set_pin","text":"SET_PIN PIN=config_name VALUE=<value> [CYCLE_TIME=<cycle_time>] : Set the pin to the given output VALUE . VALUE should be 0 or 1 for \"digital\" output pins. For PWM pins, set to a value between 0.0 and 1.0, or between 0.0 and scale if a scale is configured in the output_pin config section. Some pins (currently only \"soft PWM\" pins) support setting an explicit cycle time using the CYCLE_TIME parameter (specified in seconds). Note that the CYCLE_TIME parameter is not stored between SET_PIN commands (any SET_PIN command without an explicit CYCLE_TIME parameter will use the cycle_time specified in the output_pin config section).","title":"SET_PIN"},{"location":"G-Codes.html#palette2","text":"I seguenti comandi sono disponibili quando la sezione di configurazione della palette2 \u00e8 abilitata. Le stampe di Palette funzionano incorporando speciali OCodes (Codici Omega) nel file GCode: O1 ... O32 : Questi codici vengono letti dal flusso GCode ed elaborati da questo modulo e passati al dispositivo Palette 2. Sono inoltre disponibili i seguenti comandi aggiuntivi.","title":"[palette2]"},{"location":"G-Codes.html#palette_connect","text":"PALETTE_CONNECT : questo comando inizializza la connessione con la Palette 2.","title":"PALETTE_CONNECT"},{"location":"G-Codes.html#palette_disconnect","text":"PALETTE_DISCONNECT : questo comando si disconnette dalla Palette 2.","title":"PALETTE_DISCONNECT"},{"location":"G-Codes.html#palette_clear","text":"PALETTE_CLEAR : questo comando indica alla Palette 2 di cancellare tutti i percorsi di input e output del filamento.","title":"PALETTE_CLEAR"},{"location":"G-Codes.html#palette_cut","text":"PALETTE_CUT : Questo comando indica alla Palette 2 di tagliare il filamento attualmente caricato nello splice core.","title":"PALETTE_CUT"},{"location":"G-Codes.html#palette_smart_load","text":"PALETTE_SMART_LOAD : Questo comando avvia la sequenza di caricamento intelligente sulla Palette 2. Il filamento viene caricato automaticamente estrudendolo alla distanza calibrata sul dispositivo per la stampante e istruisce la Palette 2 una volta completato il caricamento. Questo comando equivale a premere Smart Load direttamente sullo schermo della Palette 2 dopo che il caricamento del filamento \u00e8 stato completato.","title":"PALETTE_SMART_LOAD"},{"location":"G-Codes.html#pid_calibrate","text":"Il modulo pid_calibrate viene caricato automaticamente se nel file di configurazione \u00e8 definito un riscaldatore.","title":"[pid_calibrate]"},{"location":"G-Codes.html#pid_calibrate_1","text":"PID_CALIBRATE HEATER=<nome_config> TARGET=<temperatura> [WRITE_FILE=1] : esegue un test di calibrazione PID. Il riscaldatore specificato verr\u00e0 abilitato fino al raggiungimento della temperatura target specificata, quindi il riscaldatore verr\u00e0 spento e acceso per diversi cicli. Se il parametro WRITE_FILE \u00e8 abilitato, verr\u00e0 creato il file /tmp/heattest.txt con un log di tutti i campioni di temperatura prelevati durante il test.","title":"PID_CALIBRATE"},{"location":"G-Codes.html#pause_resume","text":"I seguenti comandi sono disponibili quando la pause_resume config section \u00e8 abilitata:","title":"[pause_resume]"},{"location":"G-Codes.html#pause","text":"PAUSE : mette in pausa la stampa corrente. La posizione attuale viene acquisita per la ripresa al ripristino.","title":"PAUSE"},{"location":"G-Codes.html#resume","text":"RESUME [VELOCITY=<value>] : riprende la stampa da una pausa, ripristinando prima la posizione precedentemente acquisita. Il parametro VELOCITY determina la velocit\u00e0 alla quale l'utensile deve tornare alla posizione originale acquisita.","title":"RESUME"},{"location":"G-Codes.html#clear_pause","text":"CLEAR_PAUSE : cancella lo stato di pausa corrente senza riprendere la stampa. Questo \u00e8 utile se si decide di annullare una stampa dopo un PAUSE. Si consiglia di aggiungerlo al gcode iniziale per assicurarsi che lo stato in pausa sia aggiornato per ogni stampa.","title":"CLEAR_PAUSE"},{"location":"G-Codes.html#cancel_print","text":"CANCEL_PRINT : Annulla la stampa corrente.","title":"CANCEL_PRINT"},{"location":"G-Codes.html#print_stats","text":"Il modulo print_stats viene caricato automaticamente.","title":"[print_stats]"},{"location":"G-Codes.html#set_print_stats_info","text":"SET_PRINT_STATS_INFO [TOTAL_LAYER=<total_layer_count>] [CURRENT_LAYER= <current_layer>] : passa le informazioni sulo slicer come il layer attivo ed il totale a Klipper. Aggiungi SET_PRINT_STATS_INFO [TOTAL_LAYER=<total_layer_count>] alla sezione gcode di inizio del tuo slicer e SET_PRINT_STATS_INFO [CURRENT_LAYER= <current_layer>] alla sezione gcode di cambio livello per passare le informazioni sul livello dal tuo slicer a Klipper.","title":"SET_PRINT_STATS_INFO"},{"location":"G-Codes.html#probe","text":"I seguenti comandi sono disponibili quando \u00e8 abilitata una sezione di configurazione della sonda o una sezione di configurazione di bltouch (consultare anche la guida alla calibrazione della sonda ).","title":"[probe]"},{"location":"G-Codes.html#sonda","text":"PROBE [PROBE_SPEED=<mm/s>] [LIFT_SPEED=<mm/s>] [SAMPLES=<count>] [SAMPLE_RETRACT_DIST=<mm>] [SAMPLES_TOLERANCE=<mm>] [SAMPLES_TOLERANCE_RETRIES=<count>] [SAMPLES_RESULT=median|average] : Sposta il nozzle verso il basso finch\u00e9 la sonda non scatta. Se viene fornito uno qualsiasi dei parametri opzionali, sovrascrive l'impostazione equivalente nella sezione probe config section .","title":"sonda"},{"location":"G-Codes.html#query_probe","text":"QUERY_PROBE : Riporta lo stato corrente della sonda (\"triggered\" o \"open\").","title":"QUERY_PROBE"},{"location":"G-Codes.html#probe_accuracy","text":"PROBE_ACCURACY [PROBE_SPEED=<mm/s>] [SAMPLES=<count>] [SAMPLE_RETRACT_DIST=<mm>] : Calcola la deviazione massima, minima, media, mediana e standard di pi\u00f9 campionamentidella sonda. Per impostazione predefinita, vengono presi 10 CAMPIONI. In caso contrario, i parametri opzionali sono impostati per default sulla loro impostazione equivalente nella sezione di configurazione della sonda.","title":"PROBE_ACCURACY"},{"location":"G-Codes.html#probe_calibrate","text":"PROBE_CALIBRATE [SPEED=<speed>] [<probe_parameter>=<value>] : Eseguire uno script di aiuto utile per calibrare l'offset z della sonda. Vedere il comando PROBE per i dettagli sui parametri opzionali della sonda. Vedere il comando MANUAL_PROBE per i dettagli del parametro SPEED e sui comandi aggiuntivi disponibili mentre lo strumento \u00e8 attivo. Nota che il comando PROBE_CALIBRATE utilizza la variabile di velocit\u00e0 per spostarsi in direzione XY e Z.","title":"PROBE_CALIBRATE"},{"location":"G-Codes.html#z_offset_apply_probe","text":"Z_OFFSET_APPLY_PROBE : prende l'offset Z Gcode corrente (aka, babystepping) e lo sottrae dallo z_offset della sonda. Questo per prendere un valore di babystep utilizzato di frequente e \"renderlo permanente\". Richiede un SAVE_CONFIG per avere effetto.","title":"Z_OFFSET_APPLY_PROBE"},{"location":"G-Codes.html#query_adc","text":"Il modulo query_adc viene caricato automaticamente.","title":"[query_adc]"},{"location":"G-Codes.html#query_adc_1","text":"QUERY_ADC [NAME=<config_name>] [PULLUP=<value>] : Riporta l'ultimo valore analogico ricevuto per un pin analogico configurato. Se NAME non viene fornito, viene riportato l'elenco dei nomi dei convertitori adc disponibili. Se viene fornito PULLUP (come valore in Ohm), viene riportato il valore analogico grezzo insieme alla resistenza equivalente dato quel pullup specificato.","title":"QUERY_ADC"},{"location":"G-Codes.html#query_endstops","text":"Il modulo query_endstops viene caricato automaticamente. I seguenti comandi G-Code standard sono attualmente disponibili, ma non \u00e8 consigliabile utilizzarli: Ottieni lo stato del finecorsa: M119 (usa invece QUERY_ENDSTOPS.)","title":"[query_endstops]"},{"location":"G-Codes.html#query_endstops_1","text":"QUERY_ENDSTOPS : Rilevare i finecorsa degli assi e segnala se sono \"attivate\" o in uno stato \"aperto\". Questo comando viene in genere utilizzato per verificare che un finecorsa funzioni correttamente.","title":"QUERY_ENDSTOPS"},{"location":"G-Codes.html#resonance_tester","text":"I seguenti comandi sono disponibili quando una sezione di configurazione di tester_risonanza \u00e8 abilitata (consultare anche la guida alle risonanze di misurazione ).","title":"[resonance_tester]"},{"location":"G-Codes.html#measure_axes_noise","text":"MEASURE_AXES_NOISE : misura ed riporta il rumore per tutti gli assi di tutti i chip dell'accelerometro abilitati.","title":"MEASURE_AXES_NOISE"},{"location":"G-Codes.html#test_resonances","text":"TEST_RESONANCES AXIS=<asse> OUTPUT=<risonanze,dati_grezzi> [NAME=<nome>] [FREQ_START=<freq_min>] [FREQ_END=<freq_max>] [HZ_PER_SEC=<hz_per_sec>] [CHIPS=<adxl345_chip_name>] [ POINT=x,y,z] [INPUT_SHAPING=[<0:1>]] : esegue il test di risonanza in tutti i punti sonda configurati per l'\"asse\" richiesto e misura l'accelerazione utilizzando i chip dell'accelerometro configurati per il rispettivo asse. \"asse\" pu\u00f2 essere X o Y, oppure specificare una direzione arbitraria come AXIS=dx,dy , dove dx e dy sono numeri in virgola mobile che definiscono un vettore di direzione (es. AXIS=X , AXIS=Y , o AXIS=1,-1 per definire una direzione diagonale). Nota che AXIS=dx,dy e AXIS=-dx,-dy sono equivalenti. adxl345_chip_name pu\u00f2 essere uno o pi\u00f9 chip adxl345 configurati, delimitati da virgole, ad esempio CHIPS=\"adxl345, adxl345 rpi\" . Nota che adxl345 pu\u00f2 essere omesso dai chip adxl345 denominati. Se POINT \u00e8 specificato, sovrascriver\u00e0 i punti configurati in [resonance_tester] . Se INPUT_SHAPING=0 o non impostato (predefinito), disabilita l'input shaping per il test di risonanza, perch\u00e9 non \u00e8 valido eseguire il test di risonanza con input shaper abilitato. Il parametro OUTPUT \u00e8 un elenco separato da virgole di cui verranno scritti gli output. Se viene richiesto raw_data , i dati grezzi dell'accelerometro vengono scritti in un file o in una serie di file /tmp/raw_data_<asse>_[<nome_chip>_][<punto>_]<nome>.csv con ( <punto>_ parte del nome generata solo se \u00e8 configurato pi\u00f9 di 1 punto sonda o \u00e8 specificato PUNTO). Se viene specificato resonances , la risposta in frequenza viene calcolata (su tutti i punti sonda) e scritta nel file /tmp/resonances_<asse>_<nome>.csv . Se non \u00e8 impostato, OUTPUT \u00e8 impostato su risonanze e NAME \u00e8 impostato sull'ora corrente nel formato \"AAAAMMGG_HHMMSS\".","title":"TEST_RESONANCES"},{"location":"G-Codes.html#shaper_calibrate","text":"SHAPER_CALIBRATE [AXIS=<asse>] [NAME=<nome>] [FREQ_START=<freq_min>] [FREQ_END=<freq_max>] [HZ_PER_SEC=<hz_per_sec>] [MAX_SMOOTHING=<livellamento_max>] : simile a TEST_RESONANCES , esegue il test di risonanza come configurato e cerca di trovare i parametri ottimali di input shaper per l'asse richiesto (o entrambi gli assi X e Y se il parametro AXIS non \u00e8 impostato). Se MAX_SMOOTHING non \u00e8 impostato, il suo valore viene preso dalla sezione [resonance_tester] , con l'impostazione predefinita non impostata. Per ulteriori informazioni sull'uso di questa funzione, vedere il Max smoothing della guida alla misurazione delle risonanze. I risultati dell'ottimizzazione vengono stampati sulla console e le risposte in frequenza e i diversi valori degli shaper di input vengono scritti in uno o pi\u00f9 file CSV /tmp/calibration_data_<asse>_<nome>.csv . A meno che non sia specificato, NAME imposta l'ora corrente nel formato \"AAAAMMGG_HHMMSS\". Nota che i parametri di input shaper suggeriti possono essere mantenuti nella configurazione eseguendo il comando SAVE_CONFIG .","title":"SHAPER_CALIBRATE"},{"location":"G-Codes.html#respond","text":"I seguenti comandi G-Code standard sono disponibili quando la sezione di configurazione di risposta \u00e8 abilitata: M118 <messaggio> : fa eco al messaggio preceduto dal prefisso predefinito configurato (o echo: se non \u00e8 configurato alcun prefisso). Sono inoltre disponibili i seguenti comandi aggiuntivi.","title":"[respond]"},{"location":"G-Codes.html#respond_1","text":"RESPOND MSG=\"<message>\" : echo il messaggio preceduto dal prefisso predefinito configurato (o echo: se non \u00e8 configurato alcun prefisso). RESPOND TYPE=echo MSG=\"<message>\" : echo del messaggio preceduto da echo: . RESPOND TYPE=echo_no_space MSG=\"<messaggio>\" : fa eco al messaggio preceduto da echo: senza uno spazio tra prefisso e messaggio, utile per la compatibilit\u00e0 con alcuni plugin di octoprint che prevedono una formattazione molto specifica. RESPOND TYPE=command MSG=\"<message>\" : echo il messaggio preceduto da // . OctoPrint pu\u00f2 essere configurato per rispondere a questi messaggi (ad es. RESPOND TYPE=command MSG=action:pause ). RESPOND TYPE=error MSG=\"<messaggio>\" : fa eco al messaggio preceduto da !! . RESPOND PREFIX=<prefix> MSG=\"<message>\" : echo il messaggio preceduto da <prefix> . (Il parametro PREFIX avr\u00e0 la priorit\u00e0 sul parametro TYPE )","title":"RESPOND"},{"location":"G-Codes.html#save_variables","text":"Il comando seguente \u00e8 abilitato se \u00e8 stata abilitata una sezione di configurazione save_variables .","title":"[save_variables]"},{"location":"G-Codes.html#save_variable","text":"SAVE_VARIABLE VARIABLE=<nome> VALUE=<valore> : salva la variabile su disco in modo che possa essere utilizzata tra i riavvii. Tutte le variabili memorizzate vengono caricate nel dict printer.save_variables.variables all'avvio e possono essere utilizzate nelle macro gcode. Il VALUE fornito viene analizzato come un valore letterale Python.","title":"SAVE_VARIABLE"},{"location":"G-Codes.html#screws_tilt_adjust","text":"I seguenti comandi sono disponibili quando la sezione di configurazione viti_tilt_adjust \u00e8 abilitata (consultare anche la manual level guide ).","title":"[screws_tilt_adjust]"},{"location":"G-Codes.html#screws_tilt_calculate","text":"SCREWS_TILT_CALCULATE [DIRECTION=CW|CCW] [MAX_DEVIATION=<value>] [<probe_parameter>=<value>] : Questo comando richiamer\u00e0 lo strumento di regolazione delle viti del piatto. Comander\u00e0 l'ugello in diverse posizioni (come definito nel file di configurazione) sondando l'altezza z e calcoler\u00e0 il numero di giri della manopola per regolare il livello del piatto. Se si specifica DIRECTION, le rotazioni della manopola saranno tutte nella stessa direzione, in senso orario (CW) o in senso antiorario (CCW). Vedere il comando PROBE per i dettagli sui parametri della sonda opzionali. IMPORTANTE: DEVI sempre eseguire un G28 prima di utilizzare questo comando. Se viene specificato MAX_DEVIATION, il comando generer\u00e0 un errore gcode se qualsiasi differenza nell'altezza della vite rispetto all'altezza della vite di base \u00e8 maggiore del valore fornito.","title":"SCREWS_TILT_CALCULATE"},{"location":"G-Codes.html#sdcard_loop","text":"Quando la sezione di configurazione sdcard_loop \u00e8 abilitata, sono disponibili i seguenti comandi estesi.","title":"[sdcard_loop]"},{"location":"G-Codes.html#sdcard_loop_begin","text":"SDCARD_LOOP_BEGIN COUNT=<count> : inizia una sezione in loop nella stampa SD. Un conteggio pari a 0 indica che la sezione deve essere ripetuta indefinitamente.","title":"SDCARD_LOOP_BEGIN"},{"location":"G-Codes.html#sdcard_loop_end","text":"SDCARD_LOOP_END : termina una sezione in loop nella stampa SD.","title":"SDCARD_LOOP_END"},{"location":"G-Codes.html#sdcard_loop_desist","text":"SDCARD_LOOP_DESIST : completa i loop esistenti senza ulteriori iterazioni.","title":"SDCARD_LOOP_DESIST"},{"location":"G-Codes.html#servo","text":"I seguenti comandi sono disponibili quando una sezione di configurazione servo \u00e8 abilitata.","title":"[servo]"},{"location":"G-Codes.html#set_servo","text":"SET_SERVO SERVO=nome_config [ANGLE=<gradi> | WIDTH=<secondi>] : Imposta la posizione del servo sull'angolo dato (in gradi) o sulla larghezza dell'impulso (in secondi). Usa WIDTH=0 per disabilitare l'uscita servo.","title":"SET_SERVO"},{"location":"G-Codes.html#skew_correction","text":"I seguenti comandi sono disponibili quando \u00e8 abilitata la sezione config_correzione_asimmetria (consultare anche la guida Correzione_asimmetria ).","title":"[skew_correction]"},{"location":"G-Codes.html#set_skew","text":"SET_SKEW [XY=<ac_length,bd_length,ad_length>] [XZ=<ac,bd,ad>] [YZ=<ac,bd,ad>] [CLEAR=<0|1>] : Configura il modulo [correzione_inclinazione ] con misure (in mm) tratte da una stampa di calibrazione. Si possono inserire misure per qualsiasi combinazione di piani, i piani non inseriti manterranno il loro valore attuale. Se viene immesso CLEAR=1 , tutta la correzione dell'inclinazione sar\u00e0 disabilitata.","title":"SET_SKEW"},{"location":"G-Codes.html#get_current_skew","text":"GET_CURRENT_SKEW : Riporta l'inclinazione corrente della stampante per ciascun piano sia in radianti che in gradi. L'inclinazione viene calcolata in base ai parametri forniti tramite il gcode SET_SKEW .","title":"GET_CURRENT_SKEW"},{"location":"G-Codes.html#calc_measured_skew","text":"CALC_MEASURED_SKEW [AC=<ac_length>] [BD=<bd_length>] [AD=<ad_length>] : calcola e riporta l'inclinazione (in radianti e gradi) in base a una stampa di test misurata. Questo pu\u00f2 essere utile per determinare l'inclinazione corrente della stampante dopo che \u00e8 stata applicata la correzione. Pu\u00f2 anche essere utile prima di applicare la correzione per determinare se \u00e8 necessaria la correzione dell'inclinazione. Vedere Correzione inclinazione per i dettagli su oggetti e misurazioni di calibrazione inclinazione.","title":"CALC_MEASURED_SKEW"},{"location":"G-Codes.html#skew_profile","text":"SKEW_PROFILE [LOAD=<nome>] [SAVE=<nome>] [REMOVE=<nome>] : Gestione del profilo per correzione_inclinazione. LOAD ripristiner\u00e0 lo stato di inclinazione dal profilo corrispondente al nome fornito. SAVE salver\u00e0 lo stato di inclinazione corrente in un profilo che corrisponde al nome fornito. REMOVE eliminer\u00e0 il profilo corrispondente al nome fornito dalla memoria persistente. Si noti che dopo aver eseguito le operazioni SAVE o REMOVE \u00e8 necessario eseguire il gcode SAVE_CONFIG per rendere permanenti le modifiche alla memoria persistente.","title":"SKEW_PROFILE"},{"location":"G-Codes.html#smart_effector","text":"Sono disponibili diversi comandi quando una sezione di configurazione smart_effector \u00e8 abilitata. Assicurati di controllare la documentazione ufficiale per Smart Effector su Duet3D Wiki prima di modificare i parametri di Smart Effector. Controllare anche la guida alla calibrazione della sonda .","title":"[smart_effector]"},{"location":"G-Codes.html#set_smart_effector","text":"SET_SMART_EFFECTOR [SENSITIVITY=<sensibilit\u00e0>] [ACCEL=<accel>] [RECOVERY_TIME=<tempo>] : imposta i parametri di Smart Effector. Quando viene specificato SENSITIVITY , il rispettivo valore viene scritto nella EEPROM dello SmartEffector (richiede che sia fornito control_pin ). I valori di <sensibilit\u00e0> accettabili sono 0..255, il valore predefinito \u00e8 50. Valori inferiori richiedono una minore forza di contatto dell'ugello per attivarsi (ma esiste un rischio maggiore di falso trigger a causa delle vibrazioni durante la tastatura) e valori pi\u00f9 alti riducono il falso trigger (ma richiede una maggiore forza di contatto per attivarsi). Poich\u00e9 la sensibilit\u00e0 viene scritta nella EEPROM, viene conservata dopo lo spegnimento e quindi non \u00e8 necessario configurarla ad ogni avvio della stampante. ACCEL e RECOVERY_TIME consentono di sovrascrivere i parametri corrispondenti in fase di esecuzione, vedere la sezione di configurazione di Smart Effector per maggiori informazioni su quei parametri.","title":"SET_SMART_EFFECTOR"},{"location":"G-Codes.html#reset_smart_effector","text":"RESET_SMART_EFFECTOR : Ripristina la sensibilit\u00e0 di Smart Effector alle impostazioni di fabbrica. Richiede che il relativo control_pin sia fornito nella sezione di configurazione.","title":"RESET_SMART_EFFECTOR"},{"location":"G-Codes.html#stepper_enable","text":"Il modulo stepper_enable viene caricato automaticamente.","title":"[stepper_enable]"},{"location":"G-Codes.html#set_stepper_enable","text":"SET_STEPPER_ENABLE STEPPER=<nome_config> ENABLE=[0|1] : Abilita o disabilita solo lo stepper dato. Questo \u00e8 uno strumento diagnostico e di debug e deve essere utilizzato con cautela. La disabilitazione di un motore dell'asse non ripristina le informazioni di homing. Lo spostamento manuale di uno stepper disabilitato pu\u00f2 causare l'azionamento del motore della macchina al di fuori dei limiti di sicurezza. Ci\u00f2 pu\u00f2 causare danni ai componenti dell'asse, al hotend e alla superficie di stampa.","title":"SET_STEPPER_ENABLE"},{"location":"G-Codes.html#temperature_fan","text":"Il comando seguente \u00e8 disponibile quando una sezione di configurazione della ventola_temperatura \u00e8 abilitata.","title":"[temperature_fan]"},{"location":"G-Codes.html#set_temperature_fan_target","text":"SET_TEMPERATURE_FAN_TARGET temperature_fan=<temperature_fan_name> [target=<target_temperature>] [min_speed=<min_speed>] [max_speed=<max_speed>] : Imposta la temperatura target per una temperature_fan. Se non viene fornito un target, viene impostato sulla temperatura specificata nel file di configurazione. Se le velocit\u00e0 non vengono fornite, non viene applicata alcuna modifica.","title":"SET_TEMPERATURE_FAN_TARGET"},{"location":"G-Codes.html#tmcxxxx","text":"I seguenti comandi sono disponibili quando una qualsiasi delle tmcXXXX config section \u00e8 abilitata.","title":"[tmcXXXX]"},{"location":"G-Codes.html#dump_tmc","text":"DUMP_TMC STEPPER=<nome> : questo comando legger\u00e0 i registri del driver TMC e ne riporter\u00e0 i valori.","title":"DUMP_TMC"},{"location":"G-Codes.html#init_tmc","text":"INIT_TMC STEPPER=<nome> : questo comando inizializzer\u00e0 i registri TMC. Necessario per riattivare il driver se l'alimentazione al chip viene spenta e poi riaccesa.","title":"INIT_TMC"},{"location":"G-Codes.html#set_tmc_current","text":"SET_TMC_CURRENT STEPPER=<nome> CURRENT=<amps> HOLDCURRENT=<amps> : Questo regoler\u00e0 le correnti di funzionamento e di mantenimento del driver TMC. (HOLDCURRENT non \u00e8 applicabile ai driver tmc2660.)","title":"SET_TMC_CURRENT"},{"location":"G-Codes.html#set_tmc_field","text":"SET_TMC_FIELD STEPPER=<nome> FIELD=<campo> VALUE=<valore> : Questo alterer\u00e0 il valore del campo del registro specificato del driver TMC. Questo comando \u00e8 destinato alla diagnostica e al debug di basso livello solo perch\u00e9 la modifica dei campi durante l'esecuzione pu\u00f2 causare comportamenti indesiderati e potenzialmente pericolosi della stampante. Le modifiche permanenti dovrebbero invece essere apportate utilizzando il file di configurazione della stampante. Non vengono eseguiti controlli di integrit\u00e0 per i valori indicati.","title":"SET_TMC_FIELD"},{"location":"G-Codes.html#toolhead","text":"Il modulo toolhead viene caricato automaticamente.","title":"[toolhead]"},{"location":"G-Codes.html#set_velocity_limit","text":"SET_VELOCITY_LIMIT [VELOCITY=<valore>] [ACCEL=<valore>] [ACCEL_TO_DECEL=<valore>] [SQUARE_CORNER_VELOCITY=<valore>] : Modifica i limiti di velocit\u00e0 della stampante.","title":"SET_VELOCITY_LIMIT"},{"location":"G-Codes.html#tuning_tower","text":"Il modulo tuning_tower viene caricato automaticamente.","title":"[tuning_tower]"},{"location":"G-Codes.html#tuning_tower_1","text":"TUNING_TOWER COMMAND=<comando> PARAMETER=<nome> START=<valore> [SKIP=<valore>] [FACTOR=<valore> [BAND=<valore>]] | [STEP_DELTA=<valore> STEP_HEIGHT=<valore>] : Uno strumento per regolare un parametro su ciascuna altezza Z durante una stampa. Lo strumento eseguir\u00e0 il dato COMMAND con il dato PARAMETER assegnato a un valore che varia con Z secondo una formula. Usa FACTOR se utilizzerai un righello o calibri per misurare l'altezza Z del valore ottimale, o STEP_DELTA e STEP_HEIGHT se il modello della torre di regolazione ha bande di valori discreti come \u00e8 comune con le torri della temperatura. Se viene specificato SKIP=<valore> , il processo di ottimizzazione non inizia finch\u00e9 non viene raggiunta l'altezza Z <valore> , e al di sotto di essa il valore sar\u00e0 impostato su START ; in questo caso, la z_height usata nelle formule seguenti \u00e8 in realt\u00e0 max(z - skip, 0) . Ci sono tre possibili combinazioni di opzioni: FACTOR : Il valore cambia a una velocit\u00e0 di factor per millimetro. La formula utilizzata \u00e8: valore = inizio + fattore * z_altezza . \u00c8 possibile inserire l'altezza Z ottimale direttamente nella formula per determinare il valore del parametro ottimale. FACTOR e BAND : il valore cambia a una velocit\u00e0 media di factor per millimetro, ma in bande discrete in cui la regolazione verr\u00e0 effettuata solo ogni BAND millimetri di altezza Z. La formula utilizzata \u00e8: value = start + factor * ((floor(z_height / band) + .5) * band) . STEP_DELTA e STEP_HEIGHT : il valore cambia di STEP_DELTA ogni STEP_HEIGHT millimetri. La formula utilizzata \u00e8: value = start + step_delta * floor(z_height / step_height) . Puoi semplicemente contare le bande o leggere le etichette della torre di tuning per determinare il valore ottimale.","title":"TUNING_TOWER"},{"location":"G-Codes.html#virtual_sdcard","text":"Klipper supporta i seguenti comandi G-Code standard se la sezione di configurazione di virtual_sdcard \u00e8 abilitata: Elenco scheda SD: M20 Inizializza scheda SD: M21 Selezionare il file SD: M23 <nomefile> Avvia/riprendi la stampa SD: M24 Sospendi la stampa SD: M25 Impostare la posizione SD: M26 S<offset> Riporta lo stato di stampa SD: M27 Inoltre, quando la sezione di configurazione \"virtual_sdcard\" \u00e8 abilitata, sono disponibili i seguenti comandi estesi.","title":"[virtual_sdcard]"},{"location":"G-Codes.html#sdcard_print_file","text":"SDCARD_PRINT_FILE FILENAME=<nomefile> : carica un file e avvia la stampa SD.","title":"SDCARD_PRINT_FILE"},{"location":"G-Codes.html#sdcard_reset_file","text":"SDCARD_RESET_FILE : Scarica il file e cancella lo stato SD.","title":"SDCARD_RESET_FILE"},{"location":"G-Codes.html#z_thermal_adjust","text":"I seguenti comandi sono disponibili quando la sezione z_thermal_adjust config \u00e8 abilitata.","title":"[z_thermal_adjust]"},{"location":"G-Codes.html#set_z_thermal_adjust","text":"SET_Z_THERMAL_ADJUST [ENABLE=<0:1>] [TEMP_COEFF=<valore>] [REF_TEMP=<valore>] : Abilita o disabilita la regolazione termica Z con ENABLE . La disabilitazione non rimuove alcuna regolazione gi\u00e0 applicata, ma congela il valore di regolazione corrente - questo impedisce il movimento Z verso il basso potenzialmente pericoloso. La riattivazione pu\u00f2 potenzialmente causare il movimento dell'utensile verso l'alto quando la regolazione viene aggiornata e applicata. TEMP_COEFF consente la regolazione in tempo reale del coefficiente di temperatura di regolazione (cio\u00e8 il parametro di configurazione TEMP_COEFF ). I valori TEMP_COEFF non vengono salvati nella configurazione. REF_TEMP sovrascrive manualmente la temperatura di riferimento tipicamente impostata durante l'homing (per l'uso, ad esempio, in routine di homing non standard) - verr\u00e0 ripristinata automaticamente durante l'homing.","title":"SET_Z_THERMAL_ADJUST"},{"location":"G-Codes.html#z_tilt","text":"I seguenti comandi sono disponibili quando la sezione z_tilt config \u00e8 abilitata.","title":"[z_tilt]"},{"location":"G-Codes.html#z_tilt_adjust","text":"Z_TILT_ADJUST [<probe_parameter>=<value>] : questo comando sonder\u00e0 i punti specificati nella configurazione e quindi apporter\u00e0 regolazioni indipendenti a ciascuno Z stepper per compensare l'inclinazione. Vedere il comando PROBE per i dettagli sui parametri opzionali della sonda.","title":"Z_TILT_ADJUST"},{"location":"Hall_Filament_Width_Sensor.html","text":"Sensore di Hall per larghezza del filamento \u00b6 Questo documento descrive il modulo host del sensore di larghezza del filamento Filament Width Sensor. L'hardware utilizzato per lo sviluppo di questo modulo host si basa su due sensori lineari Hall (ad esempio ss49e). I sensori nel corpo si trovano ai lati opposti. Principio di funzionamento: due sensori Hall funzionano in modalit\u00e0 differenziale, la stessa deriva di temperatura per il sensore. Non \u00e8 necessaria una speciale compensazione della temperatura. Puoi trovare i design su Thingiverse , un video di assemblaggio \u00e8 disponibile anche su Youtube Per utilizzare il sensore di larghezza del filamento Hall, leggere Config Reference e G-Code documentation . Come funziona? \u00b6 Il sensore genera due uscite analogiche in base alla larghezza del filamento calcolata. La somma della tensione di uscita \u00e8 sempre uguale alla larghezza del filamento rilevata. Il modulo host monitora le variazioni di tensione e regola il moltiplicatore di estrusione. Uso il connettore aux2 su una scheda simile a rampe analog11 e analog12 pin. Puoi usare diversi pin e diverse schede. Modello per variabili di menu \u00b6 [menu __main __filament __width_current] type: command enable: {'hall_filament_width_sensor' in printer} name: Dia: {'%.2F' % printer.hall_filament_width_sensor.Diameter} index: 0 [menu __main __filament __raw_width_current] type: command enable: {'hall_filament_width_sensor' in printer} name: Raw: {'%4.0F' % printer.hall_filament_width_sensor.Raw} index: 1 Procedura di calibrazione \u00b6 Per ottenere il valore grezzo del sensore \u00e8 possibile utilizzare la voce di menu o il comando QUERY_RAW_FILAMENT_WIDTH nel terminale. Inserire la prima barra di calibrazione (dimensione 1,5 mm) ottenere il primo valore grezzo del sensore Inserire la seconda barra di calibrazione (dimensione 2,0 mm) per ottenere il secondo valore grezzo del sensore Salva i valori grezzi del sensore nel parametro di configurazione Raw_dia1 e Raw_dia2 Come abilitare il sensore \u00b6 Per impostazione predefinita, il sensore \u00e8 disabilitato all'accensione. Per abilitare il sensore, emettere il comando ENABLE_FILAMENT_WIDTH_SENSOR o impostare il parametro enable su true . Registrazione \u00b6 Per impostazione predefinita, la registrazione del diametro \u00e8 disabilitata all'accensione. Emettere il comando ENABLE_FILAMENT_WIDTH_LOG per avviare la registrazione ed emettere il comando DISABLE_FILAMENT_WIDTH_LOG per interrompere la registrazione. Per abilitare la registrazione all'accensione, impostare il parametro logging su true . Il diametro del filamento viene registrato con un intervallo di misurazione (10 mm per impostazione predefinita).","title":"Sensore di Hall per larghezza del filamento"},{"location":"Hall_Filament_Width_Sensor.html#sensore-di-hall-per-larghezza-del-filamento","text":"Questo documento descrive il modulo host del sensore di larghezza del filamento Filament Width Sensor. L'hardware utilizzato per lo sviluppo di questo modulo host si basa su due sensori lineari Hall (ad esempio ss49e). I sensori nel corpo si trovano ai lati opposti. Principio di funzionamento: due sensori Hall funzionano in modalit\u00e0 differenziale, la stessa deriva di temperatura per il sensore. Non \u00e8 necessaria una speciale compensazione della temperatura. Puoi trovare i design su Thingiverse , un video di assemblaggio \u00e8 disponibile anche su Youtube Per utilizzare il sensore di larghezza del filamento Hall, leggere Config Reference e G-Code documentation .","title":"Sensore di Hall per larghezza del filamento"},{"location":"Hall_Filament_Width_Sensor.html#come-funziona","text":"Il sensore genera due uscite analogiche in base alla larghezza del filamento calcolata. La somma della tensione di uscita \u00e8 sempre uguale alla larghezza del filamento rilevata. Il modulo host monitora le variazioni di tensione e regola il moltiplicatore di estrusione. Uso il connettore aux2 su una scheda simile a rampe analog11 e analog12 pin. Puoi usare diversi pin e diverse schede.","title":"Come funziona?"},{"location":"Hall_Filament_Width_Sensor.html#modello-per-variabili-di-menu","text":"[menu __main __filament __width_current] type: command enable: {'hall_filament_width_sensor' in printer} name: Dia: {'%.2F' % printer.hall_filament_width_sensor.Diameter} index: 0 [menu __main __filament __raw_width_current] type: command enable: {'hall_filament_width_sensor' in printer} name: Raw: {'%4.0F' % printer.hall_filament_width_sensor.Raw} index: 1","title":"Modello per variabili di menu"},{"location":"Hall_Filament_Width_Sensor.html#procedura-di-calibrazione","text":"Per ottenere il valore grezzo del sensore \u00e8 possibile utilizzare la voce di menu o il comando QUERY_RAW_FILAMENT_WIDTH nel terminale. Inserire la prima barra di calibrazione (dimensione 1,5 mm) ottenere il primo valore grezzo del sensore Inserire la seconda barra di calibrazione (dimensione 2,0 mm) per ottenere il secondo valore grezzo del sensore Salva i valori grezzi del sensore nel parametro di configurazione Raw_dia1 e Raw_dia2","title":"Procedura di calibrazione"},{"location":"Hall_Filament_Width_Sensor.html#come-abilitare-il-sensore","text":"Per impostazione predefinita, il sensore \u00e8 disabilitato all'accensione. Per abilitare il sensore, emettere il comando ENABLE_FILAMENT_WIDTH_SENSOR o impostare il parametro enable su true .","title":"Come abilitare il sensore"},{"location":"Hall_Filament_Width_Sensor.html#registrazione","text":"Per impostazione predefinita, la registrazione del diametro \u00e8 disabilitata all'accensione. Emettere il comando ENABLE_FILAMENT_WIDTH_LOG per avviare la registrazione ed emettere il comando DISABLE_FILAMENT_WIDTH_LOG per interrompere la registrazione. Per abilitare la registrazione all'accensione, impostare il parametro logging su true . Il diametro del filamento viene registrato con un intervallo di misurazione (10 mm per impostazione predefinita).","title":"Registrazione"},{"location":"Installation.html","text":"Installazione \u00b6 Queste istruzioni partono dal presupposto che Klipper girer\u00e0 su un Raspberry Pi con OctoPrint. \u00c8 consigliato l'utilizzo di un Raspberry Pi 2, 3 o 4 (vedi la FAQ per utilizzare un hardware diverso). Ottenere un file di configurazione di Klipper \u00b6 La maggior parte delle impostazioni di Klipper sono determinate da un \"file di configurazione della stampante\" che verr\u00e0 archiviato sul Raspberry Pi. Un file di configurazione appropriato pu\u00f2 spesso essere trovato cercando in Klipper directory config 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. Se non c'\u00e8 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. Se non \u00e8 possibile trovare alcun file di configurazione per la stampante, ma si conosce il tipo di scheda di controllo della stampante, cercare un file di configurazione 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\u00e0 completa della stampante. \u00c8 anche possibile definire da zero una nuova configurazione della stampante. Tuttavia, ci\u00f2 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\u00f9 vicino file di configurazione e utilizzare Klipper riferimento alla configurazione per ulteriori informazioni. Preparazione dell'immagine del sistema operativo \u00b6 Iniziate installando OctoPi sul computer Raspberry Pi. Usa OctoPi v0.17.0 o successivo - vedi OctoPi releases 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. Dopo aver installato OctoPi ed aver aggiornato OctoPrint all'ultima versione sar\u00e0 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\u00e0 essere installato sul tuo sistema. Esistono vari client ssh disponibili (ad esempio PuTTY ). Usa il programma ssh per connetterti al Raspberry Pi (ssh pi@octopi -- la password \u00e8 \"raspberry\") ed esegui questi comandi: git clone https://github.com/Klipper3d/klipper ./klipper/scripts/install-octopi.sh Questo scaricher\u00e0 Klipper, installer\u00e0 alcune dipendenze, imposter\u00e0 Klipper per essere eseguito all'avvio del sistema e avvier\u00f2 il programma host Klipper. Sar\u00e0 necessario che il Raspberry abbia accesso ad internet e richeder\u00e0 alcuni minuti. Compilare il firmware e flashare il microcontrollore \u00b6 Per compilare il firmware per il microcontrollore, iniziamo lanciando questi comandi sul Raspberry: cd ~/klipper/ make menuconfig I commenti nella parte superiore del file di configurazione della stampante dovrebbero descrivere le impostazioni che devono essere impostate durante \"make menuconfig\". Apri il file in un browser web o in un editor di testo e cerca queste istruzioni nella parte superiore del file. Una volta configurate le impostazioni \"menuconfig\" appropriate, premere \"Q\" per uscire, quindi \"Y\" per salvare. Quindi esegui: make Se i commenti nella parte superiore del file di configurazione della stampante descrivono i passaggi personalizzati per il \"flash\" dell'immagine finale sulla scheda di controllo della stampante, segui questi passaggi e poi procedi con configurazione OctoPrint . In caso contrario, i seguenti passaggi vengono spesso utilizzati per eseguire il \"flash\" della scheda di controllo della stampante. Innanzitutto \u00e8 necessario determinare la porta seriale collegata al microcontrollore. Esegui quanto segue: ls /dev/serial/by-id/* Dovrebbe venire riportato qualcosa di simile a questo: /dev/serial/by-id/usb-1a86_USB2.0-Serial-if00-port0 \u00c8 abbastanza comune che ogni stampante 3D abbia il suo nome univoco elencato come porta seriale. Questo nome sar\u00e0 utilizzato quando flasheremo il microcontrollore. \u00c8 possibile che ci possano essere pi\u00f9 righe nell'elenco sopraccitato, se \u00e8 cos\u00ec seleziona la riga cosrrispondente al microcontrollore (vedi le FAQ per maggiori informazioni). Per i microcontrollori pi\u00f9 comuni, il firmware pu\u00f2 essere flashato con comandi tipo: sudo service klipper stop make flash FLASH_DEVICE=/dev/serial/by-id/usb-1a86_USB2.0-Serial-if00-port0 sudo service klipper start Assicurati di mettere al posto di FLASH_DEVICE il nome della porta seriale associato alla stampante. 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\"). Configurare OctoPrint per usare Klipper \u00b6 Il sistema OctoPrint deve essere configurato per comunicare con il sistema Klipper. Loggati su OctoPrint e confogura queste parti: Naviga nella scheda Impostazioni (la chiave inglese in cima alla pagina). Dentro \"Serial Connection\", \"Additional serial ports\" aggiungi \"/tmp/printer\". Poi fai \"Save\". Vai nella scheda Impostazioni e sotto \"Serial Connection\" cambia la \"Serial Port\" in \"/tmp/printer\". Nella scheda Impostazioni, vai in \"Behavior\" e seleziona l'opzione \"Cancel any ongoing prints but stay connected to the printer\", poi \"Save\". 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 \u00e8 visualizzata prova a ricaricare la pagina. 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\u00e0 un messaggio di errore sull'apertura del file config, questo significa che OctoPrint sta comunicando correttamente con Klipper. Possiamo proseguire. Configurare Klipper \u00b6 Il passaggio successivo consiste nel copiare il file di configurazione della stampante sul Raspberry Pi. Probabilmente il modo pi\u00f9 semplice per impostare il file di configurazione di Klipper \u00e8 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). In alternativa, si pu\u00f2 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): cp ~/klipper/config/example-cartesian.cfg ~/printer.cfg nano ~/printer.cfg \u00c8 comune che ogni stampante abbia il proprio nome univoco per il microcontrollore. Il nome potrebbe cambiare dopo aver eseguito il flashing di Klipper, quindi ripeti questi passaggi anche se erano gi\u00e0 stati eseguiti durante il flashing. Eseguire: ls /dev/serial/by-id/* Dovrebbe venire riportato qualcosa di simile a questo: /dev/serial/by-id/usb-1a86_USB2.0-Serial-if00-port0 Quindi aggiorna il file di configurazione con il nome univoco. Ad esempio, aggiorna la sezione [mcu] in modo che assomigli a qualcosa di simile a: [mcu] serial: /dev/serial/by-id/usb-1a86_USB2.0-Serial-if00-port0 Dopo aver creato e modificato il file sar\u00e0 necessario emettere un comando di \"restart\" nel terminale web di OctoPrint per caricare il file config. Un comando \"status\" segnaler\u00e0 che la stampante \u00e8 pronta se il file di configurazione di Klipper viene letto correttamente e il microcontrollore \u00e8 stato trovato e configurato correttamente. Quando si personalizza il file di configurazione della stampante, non \u00e8 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\u00e9 \"status\" non segnala che la stampante \u00e8 pronta. Klipper riferisce i messaggi di errore tramite il terminale di OctoPrint. Il comando \"status\" pu\u00f2 essere usato per visualizzare nuovamente eventuali messaggi di errore. Lo script di startup di default di Klipper generer\u00e0 un log sotto /tmp/klippy.log , questo fornir\u00e0 informazioni pi\u00f9 dettagliate. Dopo che Klipper ha segnalato che la stampante \u00e8 pronta, vai al config check document per eseguire alcuni controlli di base sulle definizioni nel file di configurazione. Vedere i documentation reference per altre informazioni.","title":"Installazione"},{"location":"Installation.html#installazione","text":"Queste istruzioni partono dal presupposto che Klipper girer\u00e0 su un Raspberry Pi con OctoPrint. \u00c8 consigliato l'utilizzo di un Raspberry Pi 2, 3 o 4 (vedi la FAQ per utilizzare un hardware diverso).","title":"Installazione"},{"location":"Installation.html#ottenere-un-file-di-configurazione-di-klipper","text":"La maggior parte delle impostazioni di Klipper sono determinate da un \"file di configurazione della stampante\" che verr\u00e0 archiviato sul Raspberry Pi. Un file di configurazione appropriato pu\u00f2 spesso essere trovato cercando in Klipper directory config 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. Se non c'\u00e8 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. Se non \u00e8 possibile trovare alcun file di configurazione per la stampante, ma si conosce il tipo di scheda di controllo della stampante, cercare un file di configurazione 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\u00e0 completa della stampante. \u00c8 anche possibile definire da zero una nuova configurazione della stampante. Tuttavia, ci\u00f2 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\u00f9 vicino file di configurazione e utilizzare Klipper riferimento alla configurazione per ulteriori informazioni.","title":"Ottenere un file di configurazione di Klipper"},{"location":"Installation.html#preparazione-dellimmagine-del-sistema-operativo","text":"Iniziate installando OctoPi sul computer Raspberry Pi. Usa OctoPi v0.17.0 o successivo - vedi OctoPi releases 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. Dopo aver installato OctoPi ed aver aggiornato OctoPrint all'ultima versione sar\u00e0 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\u00e0 essere installato sul tuo sistema. Esistono vari client ssh disponibili (ad esempio PuTTY ). Usa il programma ssh per connetterti al Raspberry Pi (ssh pi@octopi -- la password \u00e8 \"raspberry\") ed esegui questi comandi: git clone https://github.com/Klipper3d/klipper ./klipper/scripts/install-octopi.sh Questo scaricher\u00e0 Klipper, installer\u00e0 alcune dipendenze, imposter\u00e0 Klipper per essere eseguito all'avvio del sistema e avvier\u00f2 il programma host Klipper. Sar\u00e0 necessario che il Raspberry abbia accesso ad internet e richeder\u00e0 alcuni minuti.","title":"Preparazione dell'immagine del sistema operativo"},{"location":"Installation.html#compilare-il-firmware-e-flashare-il-microcontrollore","text":"Per compilare il firmware per il microcontrollore, iniziamo lanciando questi comandi sul Raspberry: cd ~/klipper/ make menuconfig I commenti nella parte superiore del file di configurazione della stampante dovrebbero descrivere le impostazioni che devono essere impostate durante \"make menuconfig\". Apri il file in un browser web o in un editor di testo e cerca queste istruzioni nella parte superiore del file. Una volta configurate le impostazioni \"menuconfig\" appropriate, premere \"Q\" per uscire, quindi \"Y\" per salvare. Quindi esegui: make Se i commenti nella parte superiore del file di configurazione della stampante descrivono i passaggi personalizzati per il \"flash\" dell'immagine finale sulla scheda di controllo della stampante, segui questi passaggi e poi procedi con configurazione OctoPrint . In caso contrario, i seguenti passaggi vengono spesso utilizzati per eseguire il \"flash\" della scheda di controllo della stampante. Innanzitutto \u00e8 necessario determinare la porta seriale collegata al microcontrollore. Esegui quanto segue: ls /dev/serial/by-id/* Dovrebbe venire riportato qualcosa di simile a questo: /dev/serial/by-id/usb-1a86_USB2.0-Serial-if00-port0 \u00c8 abbastanza comune che ogni stampante 3D abbia il suo nome univoco elencato come porta seriale. Questo nome sar\u00e0 utilizzato quando flasheremo il microcontrollore. \u00c8 possibile che ci possano essere pi\u00f9 righe nell'elenco sopraccitato, se \u00e8 cos\u00ec seleziona la riga cosrrispondente al microcontrollore (vedi le FAQ per maggiori informazioni). Per i microcontrollori pi\u00f9 comuni, il firmware pu\u00f2 essere flashato con comandi tipo: sudo service klipper stop make flash FLASH_DEVICE=/dev/serial/by-id/usb-1a86_USB2.0-Serial-if00-port0 sudo service klipper start Assicurati di mettere al posto di FLASH_DEVICE il nome della porta seriale associato alla stampante. 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\").","title":"Compilare il firmware e flashare il microcontrollore"},{"location":"Installation.html#configurare-octoprint-per-usare-klipper","text":"Il sistema OctoPrint deve essere configurato per comunicare con il sistema Klipper. Loggati su OctoPrint e confogura queste parti: Naviga nella scheda Impostazioni (la chiave inglese in cima alla pagina). Dentro \"Serial Connection\", \"Additional serial ports\" aggiungi \"/tmp/printer\". Poi fai \"Save\". Vai nella scheda Impostazioni e sotto \"Serial Connection\" cambia la \"Serial Port\" in \"/tmp/printer\". Nella scheda Impostazioni, vai in \"Behavior\" e seleziona l'opzione \"Cancel any ongoing prints but stay connected to the printer\", poi \"Save\". 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 \u00e8 visualizzata prova a ricaricare la pagina. 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\u00e0 un messaggio di errore sull'apertura del file config, questo significa che OctoPrint sta comunicando correttamente con Klipper. Possiamo proseguire.","title":"Configurare OctoPrint per usare Klipper"},{"location":"Installation.html#configurare-klipper","text":"Il passaggio successivo consiste nel copiare il file di configurazione della stampante sul Raspberry Pi. Probabilmente il modo pi\u00f9 semplice per impostare il file di configurazione di Klipper \u00e8 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). In alternativa, si pu\u00f2 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): cp ~/klipper/config/example-cartesian.cfg ~/printer.cfg nano ~/printer.cfg \u00c8 comune che ogni stampante abbia il proprio nome univoco per il microcontrollore. Il nome potrebbe cambiare dopo aver eseguito il flashing di Klipper, quindi ripeti questi passaggi anche se erano gi\u00e0 stati eseguiti durante il flashing. Eseguire: ls /dev/serial/by-id/* Dovrebbe venire riportato qualcosa di simile a questo: /dev/serial/by-id/usb-1a86_USB2.0-Serial-if00-port0 Quindi aggiorna il file di configurazione con il nome univoco. Ad esempio, aggiorna la sezione [mcu] in modo che assomigli a qualcosa di simile a: [mcu] serial: /dev/serial/by-id/usb-1a86_USB2.0-Serial-if00-port0 Dopo aver creato e modificato il file sar\u00e0 necessario emettere un comando di \"restart\" nel terminale web di OctoPrint per caricare il file config. Un comando \"status\" segnaler\u00e0 che la stampante \u00e8 pronta se il file di configurazione di Klipper viene letto correttamente e il microcontrollore \u00e8 stato trovato e configurato correttamente. Quando si personalizza il file di configurazione della stampante, non \u00e8 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\u00e9 \"status\" non segnala che la stampante \u00e8 pronta. Klipper riferisce i messaggi di errore tramite il terminale di OctoPrint. Il comando \"status\" pu\u00f2 essere usato per visualizzare nuovamente eventuali messaggi di errore. Lo script di startup di default di Klipper generer\u00e0 un log sotto /tmp/klippy.log , questo fornir\u00e0 informazioni pi\u00f9 dettagliate. Dopo che Klipper ha segnalato che la stampante \u00e8 pronta, vai al config check document per eseguire alcuni controlli di base sulle definizioni nel file di configurazione. Vedere i documentation reference per altre informazioni.","title":"Configurare Klipper"},{"location":"Kinematics.html","text":"Cinematica \u00b6 Questo documento \u00e8 una panoramica su come Klipper implementa la movimentazione del sistema meccanico(la sua cinematica ). Questi contenuti potrebbero interessare sia gli sviluppatori che intendono lacorare sul software Klipper che gli utenti che desiderano comprendere meglio il funzionamento delle proprie macchine. Accelerazione \u00b6 Klipper utilizza uno schema ad accelerazione costrante ogni qualvolta la testa di stampa cambia velocit\u00e0 - la velocit\u00e0 viene gradualmente variata fino a raggiungere la nuova velocit\u00e0 invece di strattonare direttamente alla nuova velocit\u00e0. Klipper mantiene sempre l'accelerazione tra la testa di stampa e la stampa. Il filamento in uscita dall'ugello pu\u00f2 essere piuttosto fragile, rapidi sobbalzi e/o cambi di flusso di estrusione portano a cattiva qualit\u00e0 di stampa e bassa adesione al piano di stampa. Anche quando non viene estruso filamento, se l'ugello si trova allo stesso livello della stampa, un repentino cambio di velocit\u00e0 potrebbe disturbare il filamento appena depositato. Limitare i cambi di velocit\u00e0 della testa di stampa relativamente alla stampa riduce il rischio di rovinare la stampa. \u00c8 anche importante limitare l'accelerazione in modo da evitare che i motori stepper perdano passi e per ridurre le sollecitazioni alla macchina. Klipper limita la coppia su ciascuno stepper mediante la limitazione dell'accelerazione sulla testina di stampa. Imporre l'accelerazione alla testa di stampa ha la conseguenza naturale di limitare la coppia degli stepper che la muovono (l'inverso non \u00e8 sempre vero). Klipper implementa l'accelerazione costante. La formula chiave per l'accelerazione costante \u00e8: velocit\u00e0(tempo) = velocit\u00e0_inizio + accelerazione*tempo Generatore di trapezoide \u00b6 Klipper utilizza un \"generatore di trapezoide\" di tipo tradizionale per modellare il movimento - ogni movimento ha una velocit\u00e0 iniziale, accelera verso la velocit\u00e0 di crociera ad accelerazione costante, prosegue a velocit\u00e0 costante ed infine decelera fino alla velocit\u00e0 finale ad accelerazione costante. Viene detto \"generatore di trapezoide\" perch\u00e9 il diagramma di velocit\u00e0 del movimento sembra un trapezoide. La velocit\u00e0 di crociera \u00e8 sempre maggiore o uguale sia alla velocit\u00e0 iniziale che a quella finale. La fase di accelerazione potrebbe avere durata zero (se la velocit\u00e0 iniziale \u00e8 uguale alla velocit\u00e0 di crociera), la fase di movimento a valocit\u00e0 costante potrebbe avere durata zero (se il movimento inizia a decelerare subito l'accelerazione) e/o la fase di decelerazione potrebbe avere durata zero (se la velocit\u00e0 finale \u00e8 uguale alla velocit\u00e0 di crociera). Look-ahead (Precalcolo) \u00b6 Il sistema di \"look-ahead\" (precalcolo) \u00e8 usato per determinare le velocit\u00e0 nelle giunzioni tra movimenti (cornering speed). Consideriamo questi due movimenti sul piano XY: Nella situazione sopra descritta \u00e8 possibile decelerare completamente dopo il primo movimento e poi accelerare all'inizio del movimento successivo; per\u00f2 questo non \u00e8 un comportamento ideale dato che continue accelerazioni e decelerazioni aumentano il tempo di stampa e continue variazioni nel flusso dell'estrusore peggiorano la qualit\u00e0 di stampa. Per risolvere questo problema, la funzione \"look-ahead\" (precalcolo) accoda i movimenti da eseguire ed analizza gli angoli tra essi per calcolare la velocit\u00e0 da usare nella giunzione tra due movimenti. Se il prossimo movimento \u00e8 all'incirca nella stessa direzione del precedente, la testina di stampa deve rallentare molto poco (se non per nulla). Se per\u00f2 il prossimo movimento forma un angolo acuto (la testina deve praticamente invertire la direzione di marcia), la velocit\u00e0 alla giunzione sar\u00e0 piccola. Le velocit\u00e0 di giunzione sono determinate utilizzando \"accelerazione centripeta approssimata\". Meglio su descritto dall'autore . Tuttavia, in Klipper, le velocit\u00e0 di giunzione sono configurate specificando la velocit\u00e0 desiderata che dovrebbe avere un angolo di 90\u00b0 (la \"velocit\u00e0 dell'angolo retto\") e da quella vengono derivate le velocit\u00e0 di giunzione per altri angoli. Formula chiave per il look-ahead: velocit\u00e0_finale^2 = velocit\u00e0_iniziale^2 + 2*accelerazione*distanza_movimento Look-ahead ammorbidito \u00b6 Klipper implementa anche un meccanismo per smussare i movimenti di brevi movimenti a \"zigzag\". Considera i seguenti movimenti: In quanto sopra, i frequenti passaggi dall'accelerazione alla decelerazione possono causare vibrazioni della macchina che provocano sollecitazioni e aumentano la rumorosit\u00e0. Per ridurre questo, Klipper tiene traccia sia dell'accelerazione di movimento regolare che di una velocit\u00e0 virtuale di \"accelerazione alla decelerazione\". Utilizzando questo sistema, la velocit\u00e0 massima di questi brevi movimenti a \"zigzag\" \u00e8 limitata per rendere pi\u00f9 fluido il movimento della stampante: In particolare, il codice calcola quale sarebbe la velocit\u00e0 di ogni mossa se fosse limitata a questa velocit\u00e0 di \"accelerazione alla decelerazione\" virtuale (la met\u00e0 della velocit\u00e0 di accelerazione normale per impostazione predefinita). Nell'immagine sopra le linee grigie tratteggiate rappresentano questa velocit\u00e0 di accelerazione virtuale per il primo movimento. Se un movimento non pu\u00f2 raggiungere la sua piena velocit\u00e0 di crociera usando questa velocit\u00e0 di accelerazione virtuale, la sua velocit\u00e0 massima viene ridotta alla velocit\u00e0 massima che potrebbe ottenere a questa velocit\u00e0 di accelerazione virtuale. Per la maggior parte dei movimenti il limite sar\u00e0 pari o superiore ai limiti esistenti del movimento e non verr\u00e0 indotto alcun cambiamento nel comportamento. Per brevi movimenti a zigzag, tuttavia, questo limite riduce la velocit\u00e0 massima. Nota che non cambia l'accelerazione effettiva all'interno del movimento: Il movimento continua a utilizzare lo schema di accelerazione normale fino alla sua velocit\u00e0 massima regolata. Generazione di passi \u00b6 Una volta completato il processo di look-ahead, il movimento della testina di stampa per il dato spostamento \u00e8 completamente noto (tempo, posizione iniziale, posizione finale, velocit\u00e0 in ogni punto) ed \u00e8 possibile generare i tempi di passaggio per lo spostamento. Questo processo viene eseguito all'interno di \"classi cinematiche\" nel codice di Klipper. Al di fuori di queste classi cinematiche, tutto viene tracciato in millimetri, secondi e nello spazio delle coordinate cartesiane. \u00c8 compito delle classi cinematiche convertire da questo sistema di coordinate generico alle specifiche hardware di una particolare stampante. Klipper utilizza un risolutore iterativo per generare i tempi dei passo per ogni stepper. Il codice contiene le formule per calcolare le coordinate cartesiane ideali della testa in ogni momento e ha le formule cinematiche per calcolare le posizioni ideali dello stepper in base a quelle coordinate cartesiane. Con queste formule, Klipper pu\u00f2 determinare il tempo ideale in cui lo stepper dovrebbe trovarsi in ogni posizione del passo. I passaggi indicati vengono quindi programmati in questi orari calcolati. La formula chiave per determinare la distanza che un movimento deve percorrere con un'accelerazione costante \u00e8: distanza_movimento = (velocita_iniziale + .5 * accelerazione *durata_movimento) * durata_movimento e la formula chiave per il movimento a velocit\u00e0 costante \u00e8: distanza_movimento = velocit\u00e0_crociera * durata_movimento Le formule chiave per determinare la coordinata cartesiana di un movimento data una distanza di movimento sono: cartesian_x_position = start_x + move_distance * total_x_movement / total_movement cartesian_y_position = start_y + move_distance * total_y_movement / total_movement cartesian_z_position = start_z + move_distance * total_z_movement / total_movement Robot Cartesiani \u00b6 La generazione di passaggi per stampanti cartesiane \u00e8 il caso pi\u00f9 semplice. Il movimento su ciascun asse \u00e8 direttamente correlato al movimento nello spazio cartesiano. Formule chiave: stepper_x_position = cartesian_x_position stepper_y_position = cartesian_y_position stepper_z_position = cartesian_z_position Robot CoreXY \u00b6 La generazione di passaggi su una macchina CoreXY \u00e8 solo un po' pi\u00f9 complessa dei robot cartesiani di base. Le formule chiave sono: stepper_a_position = cartesian_x_position + cartesian_y_position stepper_b_position = cartesian_x_position - cartesian_y_position stepper_z_position = cartesian_z_position Robot Delta \u00b6 La generazione di passi su un robot delta si basa sul teorema di Pitagora: stepper_position = (sqrt(arm_length^2 - (cartesian_x_position - tower_x_position)^2 - (cartesian_y_position - tower_y_position)^2) + cartesian_z_position) Limiti di accelerazione del motore passo-passo \u00b6 Con la cinematica delta \u00e8 possibile che un movimento che sta accelerando nello spazio cartesiano richieda un'accelerazione su un particolare motore passo-passo maggiore dell'accelerazione del movimento. Ci\u00f2 pu\u00f2 verificarsi quando un braccio dello stepper \u00e8 pi\u00f9 orizzontale che verticale e la linea di movimento passa vicino alla torre dello stepper. Sebbene questi movimenti possano richiedere un'accelerazione del motore passo-passo maggiore dell'accelerazione di movimento massima configurata della stampante, la massa effettiva spostata da quel passo-passo sarebbe inferiore. Pertanto la maggiore accelerazione stepper non si traduce in una coppia stepper significativamente pi\u00f9 elevata ed \u00e8 quindi considerata innocua. Tuttavia, per evitare casi estremi, Klipper impone un limite massimo all'accelerazione stepper di tre volte l'accelerazione di movimento massima configurata della stampante. (Allo stesso modo, la velocit\u00e0 massima dello stepper \u00e8 limitata a tre volte la velocit\u00e0 massima di spostamento.) Per far rispettare questo limite, i movimenti sul bordo estremo dell'inviluppo (dove un braccio dello stepper pu\u00f2 essere quasi orizzontale) avranno un massima accelerazione e velocit\u00e0. Cinematica dell'estrusore \u00b6 Klipper implementa il movimento dell'estrusore nella propria classe cinematica. Poich\u00e9 i tempi e la velocit\u00e0 di ogni movimento della testina di stampa sono completamente noti per ogni movimento, \u00e8 possibile calcolare i tempi di passaggio per l'estrusore indipendentemente dai calcoli del tempo di passaggio del movimento della testina di stampa. Il movimento di base dell'estrusore \u00e8 semplice da calcolare. La generazione del tempo di passaggio utilizza le stesse formule utilizzate dai robot cartesiani: stepper_position = requested_e_position Anticipo di pressione \u00b6 La sperimentazione ha dimostrato che \u00e8 possibile migliorare la modellazione dell'estrusore oltre la formula di base dell'estrusore. Nel caso ideale, mentre un movimento di estrusione avanza, lo stesso volume di filamento dovrebbe essere depositato in ogni punto lungo il movimento e non dovrebbe esserci volume estruso dopo il movimento. Sfortunatamente, \u00e8 comune scoprire che le formule di estrusione di base fanno s\u00ec che una quantit\u00e0 insufficiente di filamento fuoriesca dall'estrusore all'inizio dei movimenti di estrusione e che il filamento in eccesso venga estruso al termine dell'estrusione. Questo \u00e8 spesso indicato come \"melma\" \"ooze\". Il sistema di \"pressure advance\" tenta di spiegare ci\u00f2 utilizzando un modello diverso per l'estrusore. Invece di credere ingenuamente che ogni mm^3 di filamento alimentato nell'estrusore comporter\u00e0 l'uscita immediata di quella quantit\u00e0 di mm^3 dall'estrusore, utilizza un modello basato sulla pressione. La pressione aumenta quando il filamento viene spinto nell'estrusore (come in Legge di Hook ) e la pressione necessaria per estrudere \u00e8 dominata dalla portata attraverso l'orifizio dell'ugello (come nella legge di Poiseuille ). L'idea chiave \u00e8 che la relazione tra filamento, pressione e portata pu\u00f2 essere modellata utilizzando un coefficiente lineare: pa_position = nominal_position + pressure_advance_coefficient * nominal_velocity Per informazioni su come trovare questo coefficiente di anticipo della pressione, vedere il documento Pressure Advance . La formula di base del pressure advance pu\u00f2 far s\u00ec che il motore dell'estrusore apporti improvvisi cambiamenti di velocit\u00e0. Klipper implementa la \"smussatura\" del movimento dell'estrusore per evitarlo. Il grafico sopra mostra un esempio di due movimenti di estrusione con una velocit\u00e0 in curva diversa da zero tra di loro. Si noti che il sistema di pressure advance fa s\u00ec che il filamento aggiuntivo venga spinto nell'estrusore durante l'accelerazione. Maggiore \u00e8 la portata del filamento desiderata, pi\u00f9 filamento deve essere spinto durante l'accelerazione per tenere conto della pressione. Durante la decelerazione della testa il filamento extra viene retratto (l'estrusore avr\u00e0 una velocit\u00e0 negativa). Lo \"smussamento\" viene implementato utilizzando una media pesata della posizione dell'estrusore in un breve periodo di tempo (come specificato dal parametro di configurazione pressure_advance_smooth_time ). Questa media pu\u00f2 estendersi su pi\u00f9 mosse del codice G. Notare come il motore dell'estrusore inizier\u00e0 a muoversi prima dell'inizio nominale del primo movimento di estrusione e continuer\u00e0 a muoversi dopo la fine nominale dell'ultimo movimento di estrusione. Formula chiave per \"smoothed pressure advance\": smooth_pa_position(t) = ( definitive_integral(pa_position(x) * (smooth_time/2 - abs(t - x)) * dx, from=t-smooth_time/2, to=t+smooth_time/2) / (smooth_time/2)^2 )","title":"Cinematica"},{"location":"Kinematics.html#cinematica","text":"Questo documento \u00e8 una panoramica su come Klipper implementa la movimentazione del sistema meccanico(la sua cinematica ). Questi contenuti potrebbero interessare sia gli sviluppatori che intendono lacorare sul software Klipper che gli utenti che desiderano comprendere meglio il funzionamento delle proprie macchine.","title":"Cinematica"},{"location":"Kinematics.html#accelerazione","text":"Klipper utilizza uno schema ad accelerazione costrante ogni qualvolta la testa di stampa cambia velocit\u00e0 - la velocit\u00e0 viene gradualmente variata fino a raggiungere la nuova velocit\u00e0 invece di strattonare direttamente alla nuova velocit\u00e0. Klipper mantiene sempre l'accelerazione tra la testa di stampa e la stampa. Il filamento in uscita dall'ugello pu\u00f2 essere piuttosto fragile, rapidi sobbalzi e/o cambi di flusso di estrusione portano a cattiva qualit\u00e0 di stampa e bassa adesione al piano di stampa. Anche quando non viene estruso filamento, se l'ugello si trova allo stesso livello della stampa, un repentino cambio di velocit\u00e0 potrebbe disturbare il filamento appena depositato. Limitare i cambi di velocit\u00e0 della testa di stampa relativamente alla stampa riduce il rischio di rovinare la stampa. \u00c8 anche importante limitare l'accelerazione in modo da evitare che i motori stepper perdano passi e per ridurre le sollecitazioni alla macchina. Klipper limita la coppia su ciascuno stepper mediante la limitazione dell'accelerazione sulla testina di stampa. Imporre l'accelerazione alla testa di stampa ha la conseguenza naturale di limitare la coppia degli stepper che la muovono (l'inverso non \u00e8 sempre vero). Klipper implementa l'accelerazione costante. La formula chiave per l'accelerazione costante \u00e8: velocit\u00e0(tempo) = velocit\u00e0_inizio + accelerazione*tempo","title":"Accelerazione"},{"location":"Kinematics.html#generatore-di-trapezoide","text":"Klipper utilizza un \"generatore di trapezoide\" di tipo tradizionale per modellare il movimento - ogni movimento ha una velocit\u00e0 iniziale, accelera verso la velocit\u00e0 di crociera ad accelerazione costante, prosegue a velocit\u00e0 costante ed infine decelera fino alla velocit\u00e0 finale ad accelerazione costante. Viene detto \"generatore di trapezoide\" perch\u00e9 il diagramma di velocit\u00e0 del movimento sembra un trapezoide. La velocit\u00e0 di crociera \u00e8 sempre maggiore o uguale sia alla velocit\u00e0 iniziale che a quella finale. La fase di accelerazione potrebbe avere durata zero (se la velocit\u00e0 iniziale \u00e8 uguale alla velocit\u00e0 di crociera), la fase di movimento a valocit\u00e0 costante potrebbe avere durata zero (se il movimento inizia a decelerare subito l'accelerazione) e/o la fase di decelerazione potrebbe avere durata zero (se la velocit\u00e0 finale \u00e8 uguale alla velocit\u00e0 di crociera).","title":"Generatore di trapezoide"},{"location":"Kinematics.html#look-ahead-precalcolo","text":"Il sistema di \"look-ahead\" (precalcolo) \u00e8 usato per determinare le velocit\u00e0 nelle giunzioni tra movimenti (cornering speed). Consideriamo questi due movimenti sul piano XY: Nella situazione sopra descritta \u00e8 possibile decelerare completamente dopo il primo movimento e poi accelerare all'inizio del movimento successivo; per\u00f2 questo non \u00e8 un comportamento ideale dato che continue accelerazioni e decelerazioni aumentano il tempo di stampa e continue variazioni nel flusso dell'estrusore peggiorano la qualit\u00e0 di stampa. Per risolvere questo problema, la funzione \"look-ahead\" (precalcolo) accoda i movimenti da eseguire ed analizza gli angoli tra essi per calcolare la velocit\u00e0 da usare nella giunzione tra due movimenti. Se il prossimo movimento \u00e8 all'incirca nella stessa direzione del precedente, la testina di stampa deve rallentare molto poco (se non per nulla). Se per\u00f2 il prossimo movimento forma un angolo acuto (la testina deve praticamente invertire la direzione di marcia), la velocit\u00e0 alla giunzione sar\u00e0 piccola. Le velocit\u00e0 di giunzione sono determinate utilizzando \"accelerazione centripeta approssimata\". Meglio su descritto dall'autore . Tuttavia, in Klipper, le velocit\u00e0 di giunzione sono configurate specificando la velocit\u00e0 desiderata che dovrebbe avere un angolo di 90\u00b0 (la \"velocit\u00e0 dell'angolo retto\") e da quella vengono derivate le velocit\u00e0 di giunzione per altri angoli. Formula chiave per il look-ahead: velocit\u00e0_finale^2 = velocit\u00e0_iniziale^2 + 2*accelerazione*distanza_movimento","title":"Look-ahead (Precalcolo)"},{"location":"Kinematics.html#look-ahead-ammorbidito","text":"Klipper implementa anche un meccanismo per smussare i movimenti di brevi movimenti a \"zigzag\". Considera i seguenti movimenti: In quanto sopra, i frequenti passaggi dall'accelerazione alla decelerazione possono causare vibrazioni della macchina che provocano sollecitazioni e aumentano la rumorosit\u00e0. Per ridurre questo, Klipper tiene traccia sia dell'accelerazione di movimento regolare che di una velocit\u00e0 virtuale di \"accelerazione alla decelerazione\". Utilizzando questo sistema, la velocit\u00e0 massima di questi brevi movimenti a \"zigzag\" \u00e8 limitata per rendere pi\u00f9 fluido il movimento della stampante: In particolare, il codice calcola quale sarebbe la velocit\u00e0 di ogni mossa se fosse limitata a questa velocit\u00e0 di \"accelerazione alla decelerazione\" virtuale (la met\u00e0 della velocit\u00e0 di accelerazione normale per impostazione predefinita). Nell'immagine sopra le linee grigie tratteggiate rappresentano questa velocit\u00e0 di accelerazione virtuale per il primo movimento. Se un movimento non pu\u00f2 raggiungere la sua piena velocit\u00e0 di crociera usando questa velocit\u00e0 di accelerazione virtuale, la sua velocit\u00e0 massima viene ridotta alla velocit\u00e0 massima che potrebbe ottenere a questa velocit\u00e0 di accelerazione virtuale. Per la maggior parte dei movimenti il limite sar\u00e0 pari o superiore ai limiti esistenti del movimento e non verr\u00e0 indotto alcun cambiamento nel comportamento. Per brevi movimenti a zigzag, tuttavia, questo limite riduce la velocit\u00e0 massima. Nota che non cambia l'accelerazione effettiva all'interno del movimento: Il movimento continua a utilizzare lo schema di accelerazione normale fino alla sua velocit\u00e0 massima regolata.","title":"Look-ahead ammorbidito"},{"location":"Kinematics.html#generazione-di-passi","text":"Una volta completato il processo di look-ahead, il movimento della testina di stampa per il dato spostamento \u00e8 completamente noto (tempo, posizione iniziale, posizione finale, velocit\u00e0 in ogni punto) ed \u00e8 possibile generare i tempi di passaggio per lo spostamento. Questo processo viene eseguito all'interno di \"classi cinematiche\" nel codice di Klipper. Al di fuori di queste classi cinematiche, tutto viene tracciato in millimetri, secondi e nello spazio delle coordinate cartesiane. \u00c8 compito delle classi cinematiche convertire da questo sistema di coordinate generico alle specifiche hardware di una particolare stampante. Klipper utilizza un risolutore iterativo per generare i tempi dei passo per ogni stepper. Il codice contiene le formule per calcolare le coordinate cartesiane ideali della testa in ogni momento e ha le formule cinematiche per calcolare le posizioni ideali dello stepper in base a quelle coordinate cartesiane. Con queste formule, Klipper pu\u00f2 determinare il tempo ideale in cui lo stepper dovrebbe trovarsi in ogni posizione del passo. I passaggi indicati vengono quindi programmati in questi orari calcolati. La formula chiave per determinare la distanza che un movimento deve percorrere con un'accelerazione costante \u00e8: distanza_movimento = (velocita_iniziale + .5 * accelerazione *durata_movimento) * durata_movimento e la formula chiave per il movimento a velocit\u00e0 costante \u00e8: distanza_movimento = velocit\u00e0_crociera * durata_movimento Le formule chiave per determinare la coordinata cartesiana di un movimento data una distanza di movimento sono: cartesian_x_position = start_x + move_distance * total_x_movement / total_movement cartesian_y_position = start_y + move_distance * total_y_movement / total_movement cartesian_z_position = start_z + move_distance * total_z_movement / total_movement","title":"Generazione di passi"},{"location":"Kinematics.html#robot-cartesiani","text":"La generazione di passaggi per stampanti cartesiane \u00e8 il caso pi\u00f9 semplice. Il movimento su ciascun asse \u00e8 direttamente correlato al movimento nello spazio cartesiano. Formule chiave: stepper_x_position = cartesian_x_position stepper_y_position = cartesian_y_position stepper_z_position = cartesian_z_position","title":"Robot Cartesiani"},{"location":"Kinematics.html#robot-corexy","text":"La generazione di passaggi su una macchina CoreXY \u00e8 solo un po' pi\u00f9 complessa dei robot cartesiani di base. Le formule chiave sono: stepper_a_position = cartesian_x_position + cartesian_y_position stepper_b_position = cartesian_x_position - cartesian_y_position stepper_z_position = cartesian_z_position","title":"Robot CoreXY"},{"location":"Kinematics.html#robot-delta","text":"La generazione di passi su un robot delta si basa sul teorema di Pitagora: stepper_position = (sqrt(arm_length^2 - (cartesian_x_position - tower_x_position)^2 - (cartesian_y_position - tower_y_position)^2) + cartesian_z_position)","title":"Robot Delta"},{"location":"Kinematics.html#limiti-di-accelerazione-del-motore-passo-passo","text":"Con la cinematica delta \u00e8 possibile che un movimento che sta accelerando nello spazio cartesiano richieda un'accelerazione su un particolare motore passo-passo maggiore dell'accelerazione del movimento. Ci\u00f2 pu\u00f2 verificarsi quando un braccio dello stepper \u00e8 pi\u00f9 orizzontale che verticale e la linea di movimento passa vicino alla torre dello stepper. Sebbene questi movimenti possano richiedere un'accelerazione del motore passo-passo maggiore dell'accelerazione di movimento massima configurata della stampante, la massa effettiva spostata da quel passo-passo sarebbe inferiore. Pertanto la maggiore accelerazione stepper non si traduce in una coppia stepper significativamente pi\u00f9 elevata ed \u00e8 quindi considerata innocua. Tuttavia, per evitare casi estremi, Klipper impone un limite massimo all'accelerazione stepper di tre volte l'accelerazione di movimento massima configurata della stampante. (Allo stesso modo, la velocit\u00e0 massima dello stepper \u00e8 limitata a tre volte la velocit\u00e0 massima di spostamento.) Per far rispettare questo limite, i movimenti sul bordo estremo dell'inviluppo (dove un braccio dello stepper pu\u00f2 essere quasi orizzontale) avranno un massima accelerazione e velocit\u00e0.","title":"Limiti di accelerazione del motore passo-passo"},{"location":"Kinematics.html#cinematica-dellestrusore","text":"Klipper implementa il movimento dell'estrusore nella propria classe cinematica. Poich\u00e9 i tempi e la velocit\u00e0 di ogni movimento della testina di stampa sono completamente noti per ogni movimento, \u00e8 possibile calcolare i tempi di passaggio per l'estrusore indipendentemente dai calcoli del tempo di passaggio del movimento della testina di stampa. Il movimento di base dell'estrusore \u00e8 semplice da calcolare. La generazione del tempo di passaggio utilizza le stesse formule utilizzate dai robot cartesiani: stepper_position = requested_e_position","title":"Cinematica dell'estrusore"},{"location":"Kinematics.html#anticipo-di-pressione","text":"La sperimentazione ha dimostrato che \u00e8 possibile migliorare la modellazione dell'estrusore oltre la formula di base dell'estrusore. Nel caso ideale, mentre un movimento di estrusione avanza, lo stesso volume di filamento dovrebbe essere depositato in ogni punto lungo il movimento e non dovrebbe esserci volume estruso dopo il movimento. Sfortunatamente, \u00e8 comune scoprire che le formule di estrusione di base fanno s\u00ec che una quantit\u00e0 insufficiente di filamento fuoriesca dall'estrusore all'inizio dei movimenti di estrusione e che il filamento in eccesso venga estruso al termine dell'estrusione. Questo \u00e8 spesso indicato come \"melma\" \"ooze\". Il sistema di \"pressure advance\" tenta di spiegare ci\u00f2 utilizzando un modello diverso per l'estrusore. Invece di credere ingenuamente che ogni mm^3 di filamento alimentato nell'estrusore comporter\u00e0 l'uscita immediata di quella quantit\u00e0 di mm^3 dall'estrusore, utilizza un modello basato sulla pressione. La pressione aumenta quando il filamento viene spinto nell'estrusore (come in Legge di Hook ) e la pressione necessaria per estrudere \u00e8 dominata dalla portata attraverso l'orifizio dell'ugello (come nella legge di Poiseuille ). L'idea chiave \u00e8 che la relazione tra filamento, pressione e portata pu\u00f2 essere modellata utilizzando un coefficiente lineare: pa_position = nominal_position + pressure_advance_coefficient * nominal_velocity Per informazioni su come trovare questo coefficiente di anticipo della pressione, vedere il documento Pressure Advance . La formula di base del pressure advance pu\u00f2 far s\u00ec che il motore dell'estrusore apporti improvvisi cambiamenti di velocit\u00e0. Klipper implementa la \"smussatura\" del movimento dell'estrusore per evitarlo. Il grafico sopra mostra un esempio di due movimenti di estrusione con una velocit\u00e0 in curva diversa da zero tra di loro. Si noti che il sistema di pressure advance fa s\u00ec che il filamento aggiuntivo venga spinto nell'estrusore durante l'accelerazione. Maggiore \u00e8 la portata del filamento desiderata, pi\u00f9 filamento deve essere spinto durante l'accelerazione per tenere conto della pressione. Durante la decelerazione della testa il filamento extra viene retratto (l'estrusore avr\u00e0 una velocit\u00e0 negativa). Lo \"smussamento\" viene implementato utilizzando una media pesata della posizione dell'estrusore in un breve periodo di tempo (come specificato dal parametro di configurazione pressure_advance_smooth_time ). Questa media pu\u00f2 estendersi su pi\u00f9 mosse del codice G. Notare come il motore dell'estrusore inizier\u00e0 a muoversi prima dell'inizio nominale del primo movimento di estrusione e continuer\u00e0 a muoversi dopo la fine nominale dell'ultimo movimento di estrusione. Formula chiave per \"smoothed pressure advance\": smooth_pa_position(t) = ( definitive_integral(pa_position(x) * (smooth_time/2 - abs(t - x)) * dx, from=t-smooth_time/2, to=t+smooth_time/2) / (smooth_time/2)^2 )","title":"Anticipo di pressione"},{"location":"MCU_Commands.html","text":"Comandi MCU \u00b6 Questo documento fornisce informazioni sui comandi di basso livello del microcontrollore che sono inviati dal software \"host\" Klipper e processati dal software del microcontrollore Klipper. Questo documento non \u00e8 un riferimento autorevole per questi comandi, n\u00e9 una lista esclusiva di tutti i comandi disponibili. Questo documento pu\u00f2 essere utile per gli sviluppatori interessati a comprendere i comandi di basso livello del microcontrollore. Vedere il documento protocol per ulteriori informazioni sul formato dei comandi e sulla loro trasmissione. I comandi qui sono descritti usando la loro sintassi di stile \"printf\" - per chi non ha familiarit\u00e0 con quel formato, basta notare che dove si vede una sequenza '%...' dovrebbe essere sostituita con un intero reale. Ad esempio, una descrizione con \"count=%c\" potrebbe essere sostituita con il testo \"count=10\". Si noti che i parametri considerati \"enumerazioni\" (vedere il documento di protocollo sopra) assumono un valore stringa che viene automaticamente convertito in un valore intero per il microcontrollore. Questo \u00e8 comune con i parametri denominati \"pin\" (o che hanno il suffisso \"_pin\"). Comandi di avvio \u00b6 Potrebbe essere necessario eseguire determinate azioni una tantum per configurare il microcontrollore e le sue periferiche. Questa sezione elenca i comandi comuni disponibili a tale scopo. A differenza della maggior parte dei comandi del microcontrollore, questi comandi vengono eseguiti non appena vengono ricevuti e non richiedono alcuna configurazione particolare. Comandi di avvio comuni: set_digital_out pin=%u value=%c : Questo comando configura immediatamente il pin dato come un GPIO di uscita digitale e lo imposta su un livello basso (valore=0) o alto (valore=1). Questo comando pu\u00f2 essere utile per configurare il valore iniziale dei LED e per configurare il valore iniziale dei pin micro-stepping del driver stepper. set_pwm_out pin=%u cycle_ticks=%u value=%hu : Questo comando configurer\u00e0 immediatamente il pin dato per utilizzare la modulazione di larghezza di impulso (PWM) basata sull'hardware con il numero specificato di cycle_tick. Il \"cycle_ticks\" \u00e8 il numero di tick di clock dell'MCU per cui ogni ciclo di accensione e spegnimento dovrebbe durare. \u00c8 possibile utilizzare un valore cycle_ticks pari a 1 per richiedere il tempo di ciclo pi\u00f9 rapido possibile. Il parametro \"value\" \u00e8 compreso tra 0 e 255 con 0 che indica uno stato completamente spento e 255 indica uno stato completamente acceso. Questo comando pu\u00f2 essere utile per abilitare le ventole di raffreddamento della CPU e degli ugelli. Configurazione di basso livello del microcontrollore \u00b6 La maggior parte dei comandi nel microcontrollore richiede una configurazione iniziale prima di poter essere richiamati correttamente. Questa sezione fornisce una panoramica del processo di configurazione. Questa sezione e le sezioni seguenti sono probabilmente di interesse solo per gli sviluppatori interessati ai dettagli interni di Klipper. Quando l'host si connette per la prima volta al microcontrollore, inizia sempre ottenendo un dizionario di dati (vedi protocol per ulteriori informazioni). Dopo aver ottenuto il dizionario dei dati, l'host verificher\u00e0 se il microcontrollore \u00e8 in uno stato \"configurato\" e in caso contrario lo configurer\u00e0. La configurazione prevede le seguenti fasi: get_config : L'host si avvia controllando se il microcontrollore \u00e8 gi\u00e0 configurato. Il microcontrollore risponde a questo comando con un messaggio di risposta \"config\". Il software del microcontrollore si avvia sempre in uno stato non configurato all'accensione. Rimane in questo stato fino a quando l'host non completa i processi di configurazione (emettendo un comando finalize_config). Se il microcontrollore \u00e8 gi\u00e0 configurato da una sessione precedente (ed \u00e8 configurato con le impostazioni desiderate), non sono necessarie ulteriori azioni da parte dell'host e il processo di configurazione termina correttamente. allocate_oids count=%c : Questo comando viene emesso per informare il microcontrollore del numero massimo di ID oggetto (oid) che l'host richiede. \u00c8 valido solo per emettere questo comando una volta. Un oid \u00e8 un identificatore intero allocato a ogni stepper, ogni endstop e ogni pin gpio schedulabile. L'host determina in anticipo il numero di oid necessari per far funzionare l'hardware e lo passa al microcontrollore in modo che possa allocare memoria sufficiente per memorizzare una mappatura dall'oid all'oggetto interno. config_XXX oid=%c ... : Per convenzione qualsiasi comando che inizia con il prefisso \"config_\" crea un nuovo oggetto microcontrollore e gli assegna l'oid dato. Ad esempio, il comando config_digital_out configurer\u00e0 il pin specificato come GPIO di output digitale e creer\u00e0 un oggetto interno che l'host pu\u00f2 utilizzare per pianificare le modifiche al GPIO specificato. Il parametro oid passato al comando config viene selezionato dall'host e deve essere compreso tra zero e il conteggio massimo fornito nel comando allocate_oids. I comandi di configurazione possono essere eseguiti solo quando il microcontrollore non \u00e8 in uno stato configurato (cio\u00e8 prima dell'invio da parte dell'host di finalize_config) e dopo che \u00e8 stato inviato il comando allocate_oids. finalize_config crc=%u : Il comando finalize_config trasferisce il microcontrollore da uno stato non configurato a uno stato configurato. Il parametro crc passato al microcontrollore viene archiviato e restituito all'host nei messaggi di risposta \"config\". Per convenzione, l'host prende un CRC a 32bit della configurazione che richieder\u00e0 e all'avvio delle successive sessioni di comunicazione verifica che il CRC memorizzato nel microcontrollore corrisponda esattamente al CRC desiderato. Se il CRC non corrisponde, l'host sa che il microcontrollore non \u00e8 stato configurato nello stato desiderato dall'host. Oggetti comuni del microcontrollore \u00b6 Questa sezione elenca alcuni comandi di configurazione comunemente usati. config_digital_out oid=%c pin=%u value=%c default_value=%c max_duration=%u : Questo comando crea un oggetto microcontrollore interno per il dato 'pin' GPIO. Il pin verr\u00e0 configurato in modalit\u00e0 di uscita digitale e impostato su un valore iniziale come specificato da 'value' (0 per basso, 1 per alto). La creazione di un oggetto digital_out consente all'host di pianificare gli aggiornamenti GPIO per il pin specificato a orari specificati (consultare il comando queue_digital_out descritto di seguito). Se il software del microcontrollore entra in modalit\u00e0 di spegnimento, tutti gli oggetti digital_out configurati verranno impostati su 'default_value'. Il parametro 'max_duration' viene utilizzato per implementare un controllo di sicurezza: se \u00e8 diverso da zero, \u00e8 il numero massimo di tick di clock che l'host pu\u00f2 impostare il GPIO specificato su un valore non predefinito senza ulteriori aggiornamenti. Ad esempio, se default_value \u00e8 zero e max_duration \u00e8 16000, se l'host imposta gpio su un valore di uno, deve pianificare un altro aggiornamento del pin gpio (su zero o su uno) entro 16000 tick di clock. Questa funzione di sicurezza pu\u00f2 essere utilizzata con i pin del riscaldatore per garantire che l'host non abiliti il riscaldatore e quindi vada offline. config_pwm_out oid=%c pin=%u cycle_ticks=%u value=%hu default_value=%hu max_duration=%u : Questo comando crea un oggetto interno per i pin PWM hardware per i quali l'host pu\u00f2 pianificare gli aggiornamenti. Il suo utilizzo \u00e8 analogo a config_digital_out - vedere la descrizione dei comandi 'set_pwm_out' e 'config_digital_out' per la descrizione dei parametri. config_analog_in oid=%c pin=%u : Questo comando viene utilizzato per configurare un pin nella modalit\u00e0 di campionamento analogico. Una volta configurato, il pin pu\u00f2 essere campionato a intervalli regolari utilizzando il comando query_analog_in (vedi sotto). config_stepper oid=%c step_pin=%c dir_pin=%c invert_step=%c step_pulse_ticks=%u : Questo comando crea un oggetto stepper interno. I parametri 'step_pin' e 'dir_pin' specificano rispettivamente i pin del passo e della direzione; questo comando li configurer\u00e0 in modalit\u00e0 uscita digitale. Il parametro 'invert_step' specifica se un passo si verifica su un fronte di salita (invert_step=0) o discendente (invert_step=1). Il parametro 'step_pulse_ticks' specifica la durata minima dell'impulso di passo. Se l'mcu esporta la costante 'STEPPER_BOTH_EDGE=1', l'impostazione di step_pulse_ticks=0 e invert_step=-1 imposter\u00e0 il passaggio su entrambi i fronti di salita e di discesa dello step pin. config_endstop oid=%c pin=%c pull_up=%c stepper_count=%c : Questo comando crea un oggetto \"finecorsa\" interno. Viene utilizzato per specificare i relativi pin e per abilitare le operazioni di \"homing\" (vedere il comando endstop_home di seguito). Il comando configurer\u00e0 il pin specificato nella modalit\u00e0 di input digitale. Il parametro 'pull_up' determina se i resistori pullup forniti dall'hardware per il pin (se disponibili) saranno abilitati. Il parametro 'stepper_count' specifica il numero massimo di stepper che potrebbe essere necessario arrestare questo endstop durante un'operazione di homing (vedere endstop_home di seguito). config_spi oid=%c bus=%u pin=%u mode=%u rate=%u shutdown_msg=%*s : Questo comando crea un oggetto SPI interno. Viene utilizzato con i comandi spi_transfer e spi_send (vedi sotto). Il \"bus\" identifica il bus SPI da utilizzare (se il microcontrollore ha pi\u00f9 di un bus SPI disponibile). Il \"pin\" specifica il pin di selezione del chip (CS) per il dispositivo. La \"modalit\u00e0\" \u00e8 la modalit\u00e0 SPI (dovrebbe essere compresa tra 0 e 3). Il parametro \"rate\" specifica la velocit\u00e0 del bus SPI (in cicli al secondo). Infine, \"shutdown_msg\" \u00e8 un comando SPI da inviare al dispositivo specificato se il microcontrollore entra in uno stato di spegnimento. config_spi_without_cs oid=%c bus=%u mode=%u rate=%u shutdown_msg=%*s : Questo comando \u00e8 simile a config_spi, ma senza una definizione di pin CS. \u00c8 utile per i dispositivi SPI che non dispongono di una linea di selezione del chip. Comandi comuni \u00b6 Questa sezione elenca alcuni comandi comunemente usati durante il run-time. \u00c8 probabilmente di interesse solo per gli sviluppatori che cercano di ottenere informazioni su Klipper. set_digital_out_pwm_cycle oid=%c cycle_ticks=%u : Questo comando configura un pin come uscita digitale (come creato da config_digital_out) per usare \"software PWM\". 'cycle_ticks' \u00e8 il numero di tick di clock per il ciclo PWM. Poich\u00e9 la commutazione dell'uscita \u00e8 implementata nel software del microcontrollore, si consiglia che 'cycle_ticks' corrisponda a un tempo di 10 ms o superiore. queue_digital_out oid=%c clock=%u on_ticks=%u : Questo comando pianificher\u00e0 una modifica a un pin GPIO dell'uscita digitale per un orario specifico. Per utilizzare questo comando \u00e8 necessario che durante la configurazione del microcontrollore sia stato emesso un comando 'config_digital_out' con lo stesso parametro 'oid'. Se \u00e8 stato chiamato 'set_digital_out_pwm_cycle', allora 'on_ticks' \u00e8 la durata di attivazione (in tick di clock) per il ciclo pwm. Altrimenti, 'on_ticks' dovrebbe essere 0 (per bassa tensione) o 1 (per alta tensione). queue_pwm_out oid=%c clock=%u value=%hu : Pianifica una modifica a un pin di uscita PWM hardware. Per ulteriori informazioni, vedere i comandi 'queue_digital_out' e 'config_pwm_out'. query_analog_in oid=%c clock=%u sample_ticks=%u sample_count=%c rest_ticks=%u min_value=%hu max_value=%hu : Questo comando imposta una pianificazione ricorrente di campionamenti di un ingresso analogico. Per utilizzare questo comando \u00e8 necessario che durante la configurazione del microcontrollore sia stato emesso un comando 'config_analog_in' con lo stesso parametro 'oid'. I campioni inizieranno a partire dall'ora 'clock', riporter\u00e0 sul valore ottenuto ogni tick di clock 'rest_ticks', sovracampioner\u00e0 il numero di 'sample_count' e metter\u00e0 in pausa il numero di tick di clock 'sample_ticks' tra i sovacampionamenti. I parametri 'min_value' e 'max_value' implementano una funzione di sicurezza: il software del microcontrollore verificher\u00e0 che il valore campionato (dopo qualsiasi sovracampionamento) sia sempre compreso nell'intervallo fornito. Questo \u00e8 destinato all'uso con pin collegati a termistori che controllano i riscaldatori: pu\u00f2 essere utilizzato per verificare che un riscaldatore rientri in un intervallo di temperatura. get_clock : Questo comando fa s\u00ec che il microcontrollore generi un messaggio di risposta \"clock\". L'host invia questo comando una volta al secondo per ottenere il valore dell'orologio del microcontrollore e per stimare la deriva tra gli orologi dell'host e del microcontrollore. Consente all'host di stimare con precisione l'orologio del microcontrollore. Comandi motori passopasso \u00b6 queue_step oid=%c interval=%u count=%hu add=%hi : Questo comando pianifica il 'conteggio' del numero di passi per il dato stepper, con 'intervallo' il numero di tick di clock tra ogni passo. Il primo passo sar\u00e0 il numero \"intervallo\" di tick di clock dall'ultimo passo programmato per il dato stepper. Se 'add' \u00e8 diverso da zero, l'intervallo verr\u00e0 regolato in base all'importo di 'add' dopo ogni passaggio. Questo comando aggiunge la sequenza intervallo/conteggio/aggiunta data a una coda per stepper. Potrebbero esserci centinaia di queste sequenze in coda durante il normale funzionamento. La nuova sequenza viene aggiunta alla fine della coda e quando ogni sequenza completa il suo numero di \"conteggi\" di passaggi viene estratta dalla parte anteriore della coda. Questo sistema consente al microcontrollore di mettere in coda potenzialmente centinaia di migliaia di passaggi, il tutto con tempi di pianificazione affidabili e prevedibili. set_next_step_dir oid=%c dir=%c : Questo comando specifica il valore del dir_pin che verr\u00e0 utilizzato dal comando queue_step successivo. reset_step_clock oid=%c clock=%u : Normalmente, la temporizzazione del passo \u00e8 relativo all'ultimo passo per un dato stepper. Questo comando azzera l'orologio in modo che il passo successivo sia relativo all'ora fornita. L'host di solito invia questo comando solo all'inizio di una stampa. stepper_get_position oid=%c : Questo comando fa s\u00ec che il microcontrollore generi un messaggio di risposta \"stepper_position\" con la posizione corrente dello stepper. La posizione \u00e8 il numero totale di passi generati con dir=1 meno il numero totale di passi generati con dir=0. endstop_home oid=%c clock=%u sample_ticks=%u sample_count=%c rest_ticks=%u pin_value=%c : Questo comando viene utilizzato durante le operazioni di \"homing\" dello stepper. Per utilizzare questo comando \u00e8 necessario che durante la configurazione del microcontrollore sia stato emesso un comando 'config_endstop' con lo stesso parametro 'oid'. Quando viene invocato questo comando, il microcontrollore campiona il pin finecorsa ogni tick di clock \"rest_ticks\" e controlla se ha un valore uguale a \"pin_value\". Se il valore corrisponde (e continua a corrispondere per 'sample_count' campioni aggiuntivi separati da 'sample_ticks'), la coda di movimento per lo stepper associato verr\u00e0 cancellata e lo stepper si arrester\u00e0 immediatamente. L'host utilizza questo comando per implementare l'homing: l'host indica al finecorsa di eseguire il campionamento per il trigger endstop e quindi emette una serie di comandi queue_step per spostare uno stepper verso il finecorsa. Una volta che lo stepper raggiunge il finecorsa, il trigger verr\u00e0 rilevato, il movimento verr\u00e0 interrotto e l'host verr\u00e0 informato. Coda movimento \u00b6 Ogni comando queue_step utilizza una voce nella \"coda di movimento\" del microcontrollore. Questa coda viene allocata quando riceve il comando \"finalize_config\" e segnala il numero di voci di coda disponibili nei messaggi di risposta \"config\". \u00c8 responsabilit\u00e0 dell'host assicurarsi che ci sia spazio disponibile nella coda prima di inviare un comando queue_step. L'host esegue questa operazione calcolando il completamento di ciascun comando queue_step e pianificando di conseguenza i nuovi comandi queue_step. Comandi SPI \u00b6 spi_transfer oid=%c data=%*s : questo comando fa s\u00ec che il microcontrollore invii dati 'data' al dispositivo spi specificato da 'oid' e genera un messaggio di risposta \"spi_transfer_response\" con i dati restituiti durante la trasmissione . spi_send oid=%c data=%*s : Questo comando \u00e8 simile a \"spi_transfer\", ma non genera un messaggio \"spi_transfer_response\".","title":"Comandi MCU"},{"location":"MCU_Commands.html#comandi-mcu","text":"Questo documento fornisce informazioni sui comandi di basso livello del microcontrollore che sono inviati dal software \"host\" Klipper e processati dal software del microcontrollore Klipper. Questo documento non \u00e8 un riferimento autorevole per questi comandi, n\u00e9 una lista esclusiva di tutti i comandi disponibili. Questo documento pu\u00f2 essere utile per gli sviluppatori interessati a comprendere i comandi di basso livello del microcontrollore. Vedere il documento protocol per ulteriori informazioni sul formato dei comandi e sulla loro trasmissione. I comandi qui sono descritti usando la loro sintassi di stile \"printf\" - per chi non ha familiarit\u00e0 con quel formato, basta notare che dove si vede una sequenza '%...' dovrebbe essere sostituita con un intero reale. Ad esempio, una descrizione con \"count=%c\" potrebbe essere sostituita con il testo \"count=10\". Si noti che i parametri considerati \"enumerazioni\" (vedere il documento di protocollo sopra) assumono un valore stringa che viene automaticamente convertito in un valore intero per il microcontrollore. Questo \u00e8 comune con i parametri denominati \"pin\" (o che hanno il suffisso \"_pin\").","title":"Comandi MCU"},{"location":"MCU_Commands.html#comandi-di-avvio","text":"Potrebbe essere necessario eseguire determinate azioni una tantum per configurare il microcontrollore e le sue periferiche. Questa sezione elenca i comandi comuni disponibili a tale scopo. A differenza della maggior parte dei comandi del microcontrollore, questi comandi vengono eseguiti non appena vengono ricevuti e non richiedono alcuna configurazione particolare. Comandi di avvio comuni: set_digital_out pin=%u value=%c : Questo comando configura immediatamente il pin dato come un GPIO di uscita digitale e lo imposta su un livello basso (valore=0) o alto (valore=1). Questo comando pu\u00f2 essere utile per configurare il valore iniziale dei LED e per configurare il valore iniziale dei pin micro-stepping del driver stepper. set_pwm_out pin=%u cycle_ticks=%u value=%hu : Questo comando configurer\u00e0 immediatamente il pin dato per utilizzare la modulazione di larghezza di impulso (PWM) basata sull'hardware con il numero specificato di cycle_tick. Il \"cycle_ticks\" \u00e8 il numero di tick di clock dell'MCU per cui ogni ciclo di accensione e spegnimento dovrebbe durare. \u00c8 possibile utilizzare un valore cycle_ticks pari a 1 per richiedere il tempo di ciclo pi\u00f9 rapido possibile. Il parametro \"value\" \u00e8 compreso tra 0 e 255 con 0 che indica uno stato completamente spento e 255 indica uno stato completamente acceso. Questo comando pu\u00f2 essere utile per abilitare le ventole di raffreddamento della CPU e degli ugelli.","title":"Comandi di avvio"},{"location":"MCU_Commands.html#configurazione-di-basso-livello-del-microcontrollore","text":"La maggior parte dei comandi nel microcontrollore richiede una configurazione iniziale prima di poter essere richiamati correttamente. Questa sezione fornisce una panoramica del processo di configurazione. Questa sezione e le sezioni seguenti sono probabilmente di interesse solo per gli sviluppatori interessati ai dettagli interni di Klipper. Quando l'host si connette per la prima volta al microcontrollore, inizia sempre ottenendo un dizionario di dati (vedi protocol per ulteriori informazioni). Dopo aver ottenuto il dizionario dei dati, l'host verificher\u00e0 se il microcontrollore \u00e8 in uno stato \"configurato\" e in caso contrario lo configurer\u00e0. La configurazione prevede le seguenti fasi: get_config : L'host si avvia controllando se il microcontrollore \u00e8 gi\u00e0 configurato. Il microcontrollore risponde a questo comando con un messaggio di risposta \"config\". Il software del microcontrollore si avvia sempre in uno stato non configurato all'accensione. Rimane in questo stato fino a quando l'host non completa i processi di configurazione (emettendo un comando finalize_config). Se il microcontrollore \u00e8 gi\u00e0 configurato da una sessione precedente (ed \u00e8 configurato con le impostazioni desiderate), non sono necessarie ulteriori azioni da parte dell'host e il processo di configurazione termina correttamente. allocate_oids count=%c : Questo comando viene emesso per informare il microcontrollore del numero massimo di ID oggetto (oid) che l'host richiede. \u00c8 valido solo per emettere questo comando una volta. Un oid \u00e8 un identificatore intero allocato a ogni stepper, ogni endstop e ogni pin gpio schedulabile. L'host determina in anticipo il numero di oid necessari per far funzionare l'hardware e lo passa al microcontrollore in modo che possa allocare memoria sufficiente per memorizzare una mappatura dall'oid all'oggetto interno. config_XXX oid=%c ... : Per convenzione qualsiasi comando che inizia con il prefisso \"config_\" crea un nuovo oggetto microcontrollore e gli assegna l'oid dato. Ad esempio, il comando config_digital_out configurer\u00e0 il pin specificato come GPIO di output digitale e creer\u00e0 un oggetto interno che l'host pu\u00f2 utilizzare per pianificare le modifiche al GPIO specificato. Il parametro oid passato al comando config viene selezionato dall'host e deve essere compreso tra zero e il conteggio massimo fornito nel comando allocate_oids. I comandi di configurazione possono essere eseguiti solo quando il microcontrollore non \u00e8 in uno stato configurato (cio\u00e8 prima dell'invio da parte dell'host di finalize_config) e dopo che \u00e8 stato inviato il comando allocate_oids. finalize_config crc=%u : Il comando finalize_config trasferisce il microcontrollore da uno stato non configurato a uno stato configurato. Il parametro crc passato al microcontrollore viene archiviato e restituito all'host nei messaggi di risposta \"config\". Per convenzione, l'host prende un CRC a 32bit della configurazione che richieder\u00e0 e all'avvio delle successive sessioni di comunicazione verifica che il CRC memorizzato nel microcontrollore corrisponda esattamente al CRC desiderato. Se il CRC non corrisponde, l'host sa che il microcontrollore non \u00e8 stato configurato nello stato desiderato dall'host.","title":"Configurazione di basso livello del microcontrollore"},{"location":"MCU_Commands.html#oggetti-comuni-del-microcontrollore","text":"Questa sezione elenca alcuni comandi di configurazione comunemente usati. config_digital_out oid=%c pin=%u value=%c default_value=%c max_duration=%u : Questo comando crea un oggetto microcontrollore interno per il dato 'pin' GPIO. Il pin verr\u00e0 configurato in modalit\u00e0 di uscita digitale e impostato su un valore iniziale come specificato da 'value' (0 per basso, 1 per alto). La creazione di un oggetto digital_out consente all'host di pianificare gli aggiornamenti GPIO per il pin specificato a orari specificati (consultare il comando queue_digital_out descritto di seguito). Se il software del microcontrollore entra in modalit\u00e0 di spegnimento, tutti gli oggetti digital_out configurati verranno impostati su 'default_value'. Il parametro 'max_duration' viene utilizzato per implementare un controllo di sicurezza: se \u00e8 diverso da zero, \u00e8 il numero massimo di tick di clock che l'host pu\u00f2 impostare il GPIO specificato su un valore non predefinito senza ulteriori aggiornamenti. Ad esempio, se default_value \u00e8 zero e max_duration \u00e8 16000, se l'host imposta gpio su un valore di uno, deve pianificare un altro aggiornamento del pin gpio (su zero o su uno) entro 16000 tick di clock. Questa funzione di sicurezza pu\u00f2 essere utilizzata con i pin del riscaldatore per garantire che l'host non abiliti il riscaldatore e quindi vada offline. config_pwm_out oid=%c pin=%u cycle_ticks=%u value=%hu default_value=%hu max_duration=%u : Questo comando crea un oggetto interno per i pin PWM hardware per i quali l'host pu\u00f2 pianificare gli aggiornamenti. Il suo utilizzo \u00e8 analogo a config_digital_out - vedere la descrizione dei comandi 'set_pwm_out' e 'config_digital_out' per la descrizione dei parametri. config_analog_in oid=%c pin=%u : Questo comando viene utilizzato per configurare un pin nella modalit\u00e0 di campionamento analogico. Una volta configurato, il pin pu\u00f2 essere campionato a intervalli regolari utilizzando il comando query_analog_in (vedi sotto). config_stepper oid=%c step_pin=%c dir_pin=%c invert_step=%c step_pulse_ticks=%u : Questo comando crea un oggetto stepper interno. I parametri 'step_pin' e 'dir_pin' specificano rispettivamente i pin del passo e della direzione; questo comando li configurer\u00e0 in modalit\u00e0 uscita digitale. Il parametro 'invert_step' specifica se un passo si verifica su un fronte di salita (invert_step=0) o discendente (invert_step=1). Il parametro 'step_pulse_ticks' specifica la durata minima dell'impulso di passo. Se l'mcu esporta la costante 'STEPPER_BOTH_EDGE=1', l'impostazione di step_pulse_ticks=0 e invert_step=-1 imposter\u00e0 il passaggio su entrambi i fronti di salita e di discesa dello step pin. config_endstop oid=%c pin=%c pull_up=%c stepper_count=%c : Questo comando crea un oggetto \"finecorsa\" interno. Viene utilizzato per specificare i relativi pin e per abilitare le operazioni di \"homing\" (vedere il comando endstop_home di seguito). Il comando configurer\u00e0 il pin specificato nella modalit\u00e0 di input digitale. Il parametro 'pull_up' determina se i resistori pullup forniti dall'hardware per il pin (se disponibili) saranno abilitati. Il parametro 'stepper_count' specifica il numero massimo di stepper che potrebbe essere necessario arrestare questo endstop durante un'operazione di homing (vedere endstop_home di seguito). config_spi oid=%c bus=%u pin=%u mode=%u rate=%u shutdown_msg=%*s : Questo comando crea un oggetto SPI interno. Viene utilizzato con i comandi spi_transfer e spi_send (vedi sotto). Il \"bus\" identifica il bus SPI da utilizzare (se il microcontrollore ha pi\u00f9 di un bus SPI disponibile). Il \"pin\" specifica il pin di selezione del chip (CS) per il dispositivo. La \"modalit\u00e0\" \u00e8 la modalit\u00e0 SPI (dovrebbe essere compresa tra 0 e 3). Il parametro \"rate\" specifica la velocit\u00e0 del bus SPI (in cicli al secondo). Infine, \"shutdown_msg\" \u00e8 un comando SPI da inviare al dispositivo specificato se il microcontrollore entra in uno stato di spegnimento. config_spi_without_cs oid=%c bus=%u mode=%u rate=%u shutdown_msg=%*s : Questo comando \u00e8 simile a config_spi, ma senza una definizione di pin CS. \u00c8 utile per i dispositivi SPI che non dispongono di una linea di selezione del chip.","title":"Oggetti comuni del microcontrollore"},{"location":"MCU_Commands.html#comandi-comuni","text":"Questa sezione elenca alcuni comandi comunemente usati durante il run-time. \u00c8 probabilmente di interesse solo per gli sviluppatori che cercano di ottenere informazioni su Klipper. set_digital_out_pwm_cycle oid=%c cycle_ticks=%u : Questo comando configura un pin come uscita digitale (come creato da config_digital_out) per usare \"software PWM\". 'cycle_ticks' \u00e8 il numero di tick di clock per il ciclo PWM. Poich\u00e9 la commutazione dell'uscita \u00e8 implementata nel software del microcontrollore, si consiglia che 'cycle_ticks' corrisponda a un tempo di 10 ms o superiore. queue_digital_out oid=%c clock=%u on_ticks=%u : Questo comando pianificher\u00e0 una modifica a un pin GPIO dell'uscita digitale per un orario specifico. Per utilizzare questo comando \u00e8 necessario che durante la configurazione del microcontrollore sia stato emesso un comando 'config_digital_out' con lo stesso parametro 'oid'. Se \u00e8 stato chiamato 'set_digital_out_pwm_cycle', allora 'on_ticks' \u00e8 la durata di attivazione (in tick di clock) per il ciclo pwm. Altrimenti, 'on_ticks' dovrebbe essere 0 (per bassa tensione) o 1 (per alta tensione). queue_pwm_out oid=%c clock=%u value=%hu : Pianifica una modifica a un pin di uscita PWM hardware. Per ulteriori informazioni, vedere i comandi 'queue_digital_out' e 'config_pwm_out'. query_analog_in oid=%c clock=%u sample_ticks=%u sample_count=%c rest_ticks=%u min_value=%hu max_value=%hu : Questo comando imposta una pianificazione ricorrente di campionamenti di un ingresso analogico. Per utilizzare questo comando \u00e8 necessario che durante la configurazione del microcontrollore sia stato emesso un comando 'config_analog_in' con lo stesso parametro 'oid'. I campioni inizieranno a partire dall'ora 'clock', riporter\u00e0 sul valore ottenuto ogni tick di clock 'rest_ticks', sovracampioner\u00e0 il numero di 'sample_count' e metter\u00e0 in pausa il numero di tick di clock 'sample_ticks' tra i sovacampionamenti. I parametri 'min_value' e 'max_value' implementano una funzione di sicurezza: il software del microcontrollore verificher\u00e0 che il valore campionato (dopo qualsiasi sovracampionamento) sia sempre compreso nell'intervallo fornito. Questo \u00e8 destinato all'uso con pin collegati a termistori che controllano i riscaldatori: pu\u00f2 essere utilizzato per verificare che un riscaldatore rientri in un intervallo di temperatura. get_clock : Questo comando fa s\u00ec che il microcontrollore generi un messaggio di risposta \"clock\". L'host invia questo comando una volta al secondo per ottenere il valore dell'orologio del microcontrollore e per stimare la deriva tra gli orologi dell'host e del microcontrollore. Consente all'host di stimare con precisione l'orologio del microcontrollore.","title":"Comandi comuni"},{"location":"MCU_Commands.html#comandi-motori-passopasso","text":"queue_step oid=%c interval=%u count=%hu add=%hi : Questo comando pianifica il 'conteggio' del numero di passi per il dato stepper, con 'intervallo' il numero di tick di clock tra ogni passo. Il primo passo sar\u00e0 il numero \"intervallo\" di tick di clock dall'ultimo passo programmato per il dato stepper. Se 'add' \u00e8 diverso da zero, l'intervallo verr\u00e0 regolato in base all'importo di 'add' dopo ogni passaggio. Questo comando aggiunge la sequenza intervallo/conteggio/aggiunta data a una coda per stepper. Potrebbero esserci centinaia di queste sequenze in coda durante il normale funzionamento. La nuova sequenza viene aggiunta alla fine della coda e quando ogni sequenza completa il suo numero di \"conteggi\" di passaggi viene estratta dalla parte anteriore della coda. Questo sistema consente al microcontrollore di mettere in coda potenzialmente centinaia di migliaia di passaggi, il tutto con tempi di pianificazione affidabili e prevedibili. set_next_step_dir oid=%c dir=%c : Questo comando specifica il valore del dir_pin che verr\u00e0 utilizzato dal comando queue_step successivo. reset_step_clock oid=%c clock=%u : Normalmente, la temporizzazione del passo \u00e8 relativo all'ultimo passo per un dato stepper. Questo comando azzera l'orologio in modo che il passo successivo sia relativo all'ora fornita. L'host di solito invia questo comando solo all'inizio di una stampa. stepper_get_position oid=%c : Questo comando fa s\u00ec che il microcontrollore generi un messaggio di risposta \"stepper_position\" con la posizione corrente dello stepper. La posizione \u00e8 il numero totale di passi generati con dir=1 meno il numero totale di passi generati con dir=0. endstop_home oid=%c clock=%u sample_ticks=%u sample_count=%c rest_ticks=%u pin_value=%c : Questo comando viene utilizzato durante le operazioni di \"homing\" dello stepper. Per utilizzare questo comando \u00e8 necessario che durante la configurazione del microcontrollore sia stato emesso un comando 'config_endstop' con lo stesso parametro 'oid'. Quando viene invocato questo comando, il microcontrollore campiona il pin finecorsa ogni tick di clock \"rest_ticks\" e controlla se ha un valore uguale a \"pin_value\". Se il valore corrisponde (e continua a corrispondere per 'sample_count' campioni aggiuntivi separati da 'sample_ticks'), la coda di movimento per lo stepper associato verr\u00e0 cancellata e lo stepper si arrester\u00e0 immediatamente. L'host utilizza questo comando per implementare l'homing: l'host indica al finecorsa di eseguire il campionamento per il trigger endstop e quindi emette una serie di comandi queue_step per spostare uno stepper verso il finecorsa. Una volta che lo stepper raggiunge il finecorsa, il trigger verr\u00e0 rilevato, il movimento verr\u00e0 interrotto e l'host verr\u00e0 informato.","title":"Comandi motori passopasso"},{"location":"MCU_Commands.html#coda-movimento","text":"Ogni comando queue_step utilizza una voce nella \"coda di movimento\" del microcontrollore. Questa coda viene allocata quando riceve il comando \"finalize_config\" e segnala il numero di voci di coda disponibili nei messaggi di risposta \"config\". \u00c8 responsabilit\u00e0 dell'host assicurarsi che ci sia spazio disponibile nella coda prima di inviare un comando queue_step. L'host esegue questa operazione calcolando il completamento di ciascun comando queue_step e pianificando di conseguenza i nuovi comandi queue_step.","title":"Coda movimento"},{"location":"MCU_Commands.html#comandi-spi","text":"spi_transfer oid=%c data=%*s : questo comando fa s\u00ec che il microcontrollore invii dati 'data' al dispositivo spi specificato da 'oid' e genera un messaggio di risposta \"spi_transfer_response\" con i dati restituiti durante la trasmissione . spi_send oid=%c data=%*s : Questo comando \u00e8 simile a \"spi_transfer\", ma non genera un messaggio \"spi_transfer_response\".","title":"Comandi SPI"},{"location":"Manual_Level.html","text":"Livellamento manuale \u00b6 Questo documento descrive gli strumenti per la calibrazione di un finecorsa Z e per l'esecuzione delle regolazioni delle viti di livellamento del piatto. Calibrazione di un finecorsa Z \u00b6 Una posizione precisa del fine corsa Z \u00e8 fondamentale per ottenere stampe di alta qualit\u00e0. Si noti, tuttavia, che la precisione dell'interruttore di fine corsa Z stesso pu\u00f2 essere un fattore limitante. Se si utilizzano i driver per motori passo-passo Trinamic, considerare l'abilitazione del rilevamento fase finecorsa per migliorare la precisione dell'interruttore. Per eseguire una calibrazione del fine corsa Z, portare la stampante in posizione di partenza, comandare alla testina di spostarsi in una posizione Z che sia almeno cinque millimetri sopra il piatto (se non lo \u00e8 gi\u00e0), comandare alla testina di spostarsi in una posizione XY vicino al centro di piatto, quindi vai alla scheda del terminale OctoPrint ed esegui: Z_ENDSTOP_CALIBRATE Quindi segui i passaggi descritti in \"the paper test\" per determinare la distanza effettiva tra l'ugello e il piatto in una determinata posizione. Una volta completati questi passaggi, \u00e8 possibile \"ACCETTARE\" la posizione e salvare i risultati nel file di configurazione con: SAVE_CONFIG \u00c8 preferibile utilizzare un interruttore di fine corsa Z sull'estremit\u00e0 opposta dell'asse Z rispetto al piatto. (L'allontanamento dal piatto \u00e8 pi\u00f9 robusto in quanto generalmente \u00e8 sempre sicuro mettere a home la Z.) Tuttavia, se si deve tornare a home verso il piatto, si consiglia di regolare il finecorsa in modo che si attivi a una piccola distanza (ad es. 0,5 mm ) sopra il piatto. Quasi tutti gli interruttori di fine corsa possono essere premuti in sicurezza a una piccola distanza oltre il punto di attivazione. Fatto ci\u00f2, si dovrebbe scoprire che il comando Z_ENDSTOP_CALIBRATE riporta un piccolo valore positivo (ad esempio, .5mm) per Z position_endstop. L'attivazione del fine corsa mentre si \u00e8 ancora a una certa distanza dal piatto riduce il rischio di incidenti involontari del piatto. Alcune stampanti hanno la capacit\u00e0 di regolare manualmente la posizione dell'interruttore di fine corsa fisico. Tuttavia, si consiglia di eseguire il posizionamento del finecorsa Z nel software con Klipper: una volta che la posizione fisica del finecorsa \u00e8 in una posizione comoda, \u00e8 possibile apportare ulteriori modifiche eseguendo Z_ENDSTOP_CALIBRATE o aggiornando manualmente Z position_endstop nel file di configurazione. Regolazione delle viti di livellamento del piatto \u00b6 Il segreto per ottenere un buon livellamento del piatto con le viti di livellamento \u00e8 utilizzare il sistema di movimento ad alta precisione della stampante durante il processo di livellamento del piatto stesso. Questo viene fatto comandando l'ugello in una posizione vicino a ciascuna vite del piatto e quindi regolando quella vite fino a quando il piatto non \u00e8 a una distanza prestabilita dall'ugello. Klipper ha uno strumento per aiutare con questo. Per utilizzare lo strumento \u00e8 necessario specificare la posizione XY di ciascuna vite. Questo viene fatto creando una sezione di configurazione [bed_screws] . Ad esempio, potrebbe sembrare qualcosa di simile a: [bed_screws] screw1: 100, 50 screw2: 100, 150 screw3: 150, 100 Se una vite del piatto \u00e8 sotto il piatto, specificare la posizione XY direttamente sopra la vite. Se la vite \u00e8 fuori dal piatto, specificare una posizione XY pi\u00f9 vicina alla vite che sia ancora all'interno del raggio del piatto. Una volta che il file di configurazione \u00e8 pronto, esegui RESTART per caricare quella configurazione, quindi puoi avviare lo strumento eseguendo: BED_SCREWS_ADJUST Questo strumento sposter\u00e0 l'ugello della stampante in ciascuna posizione XY della vite e quindi sposter\u00e0 l'ugello a un'altezza Z=0. A questo punto si pu\u00f2 utilizzare la \"prova della carta\" per regolare la vite del piatto direttamente sotto l'ugello. Vedere le informazioni descritte in \"the paper test\" , ma regolare la vite del piatto invece di comandare l'ugello ad altezze diverse. Regolare la vite del piatto finch\u00e9 non c'\u00e8 una piccola quantit\u00e0 di attrito quando si spinge la carta avanti e indietro. Una volta che la vite \u00e8 stata regolata in modo da avvertire una piccola quantit\u00e0 di attrito, eseguire il comando ACCEPT o ADJUSTED . Utilizzare il comando ADJUSTED se la vite del piatto necessita di una regolazione (in genere qualcosa di pi\u00f9 di circa 1/8 di giro della vite). Utilizzare il comando ACCEPT se non sono necessarie modifiche significative. Entrambi i comandi faranno s\u00ec che lo strumento proceda alla vite successiva. (Quando viene utilizzato un comando ADJUSTED , lo strumento pianificher\u00e0 un ciclo aggiuntivo di regolazioni delle viti di appoggio; lo strumento viene completato correttamente quando tutte le viti di appoggio vengono verificate e non richiedono regolazioni significative.) \u00c8 possibile utilizzare il comando 'ABORT' per uscire lo strumento in anticipo. Questo sistema funziona al meglio quando la stampante ha una superficie di stampa piatta (come il vetro) e ha binari diritti. Dopo aver completato con successo lo strumento di livellamento del piatto, il piatto dovrebbe essere pronto per la stampa. Regolazione fine della vite del piatto \u00b6 Se la stampante utilizza tre viti del piatto e tutte e tre le viti sono sotto il piatto, potrebbe essere possibile eseguire una seconda fase di livellamento del piatto \"ad alta precisione\". Questo viene fatto comandando l'ugello in punti in cui il piatto si sposta di una distanza maggiore con ciascuna regolazione della vite del piatto. Ad esempio, considera un piatto con viti nelle posizioni A, B e C: Per ogni regolazione effettuata alla vite del piatto nella posizione C, il piatto osciller\u00e0 lungo un pendolo definito dalle restanti due viti del piatto (mostrate qui come una linea verde). In questa situazione, ogni regolazione della vite del piatto in C sposter\u00e0 il letto nella posizione D di una quantit\u00e0 maggiore rispetto a C. \u00c8 quindi possibile effettuare una regolazione della vite C migliorata quando l'ugello \u00e8 in posizione D. Per abilitare questa funzione, si dovrebbero determinare le coordinate dell'ugello aggiuntive e aggiungerle al file di configurazione. Ad esempio, potrebbe essere simile a: [bed_screws] screw1: 100, 50 screw1_fine_adjust: 0, 0 screw2: 100, 150 screw2_fine_adjust: 300, 300 screw3: 150, 100 screw3_fine_adjust: 0, 100 Quando questa funzione \u00e8 abilitata, lo strumento BED_SCREWS_ADJUST richieder\u00e0 prima le regolazioni grossolane direttamente sopra ogni posizione della vite e, una volta accettate, richieder\u00e0 le regolazioni fini nelle posizioni aggiuntive. Continua a usare ACCEPT e ADJUSTED in ogni posizione. Regolazione delle viti di livellamento del piatto mediante la sonda del piatto \u00b6 Questo \u00e8 un altro modo per calibrare il livello del piatto utilizzando la sonda del piatto. Per utilizzarlo \u00e8 necessario disporre di una sonda Z (BL Touch, Sensore induttivo, ecc). Per abilitare questa funzione, si dovrebbero determinare le coordinate dell'ugello in modo tale che la sonda Z sia sopra le viti, quindi aggiungerle al file di configurazione. Ad esempio, potrebbe essere simile a: [screws_tilt_adjust] screw1: -5, 30 screw1_name: front left screw screw2: 155, 30 screw2_name: front right screw screw3: 155, 190 screw3_name: rear right screw screw4: -5, 190 screw4_name: rear left screw horizontal_move_z: 10. speed: 50. screw_thread: CW-M3 La vite1 \u00e8 sempre il punto di riferimento per le altre, quindi il sistema presume che la vite1 sia all'altezza corretta. Eseguire sempre prima G28 e poi eseguire SCREWS_TILT_CALCULATE - dovrebbe produrre un output simile a: Send: G28 Recv: ok Send: SCREWS_TILT_CALCULATE Recv: // 01:20 means 1 full turn and 20 minutes, CW=clockwise, CCW=counter-clockwise Recv: // front left screw (base) : x=-5.0, y=30.0, z=2.48750 Recv: // front right screw : x=155.0, y=30.0, z=2.36000 : adjust CW 01:15 Recv: // rear right screw : y=155.0, y=190.0, z=2.71500 : adjust CCW 00:50 Recv: // read left screw : x=-5.0, y=190.0, z=2.47250 : adjust CW 00:02 Recv: ok Ci\u00f2 significa che: la vite anteriore sinistra \u00e8 il punto di riferimento non devi cambiarla. la vite anteriore destra deve essere ruotata in senso orario di 1 giro completo e un quarto di giro la vite posteriore destra deve essere ruotata in senso antiorario per '50 minuti' la vite posteriore sinistra deve essere ruotata in senso orario '2 minuti' (non serve va bene) Si noti che \"minuti\" si riferisce ai \"minuti di un quadrante\". Quindi, ad esempio, 15 minuti sono un quarto di giro completo. Ripeti il processo pi\u00f9 volte fino a ottenere un piatto ben livellato, normalmente quando tutte le regolazioni richiedono meno di 6 minuti. Se si utilizza una sonda montata sul lato dell'hotend (ovvero, ha un offset X o Y), tenere presente che la regolazione dell'inclinazione del piatto invalider\u00e0 qualsiasi precedente calibrazione della sonda eseguita con unpiatto inclinato. Assicurarsi di eseguire calibrazione sonda dopo aver regolato le viti del piatto. Il parametro MAX_DEVIATION \u00e8 utile quando viene utilizzata una mesh del piatto salvata, per garantire che il livello del pitto non si sia spostato troppo lontano da dove si trovava quando \u00e8 stata creata la mesh. Ad esempio, SCREWS_TILT_CALCULATE MAX_DEVIATION=0.01 pu\u00f2 essere aggiunto al gcode iniziale personalizzato dello slicer prima del caricamento della mesh. Interromper\u00e0 la stampa se viene superato il limite configurato (0,01 mm in questo esempio), dando all'utente la possibilit\u00e0 di regolare le viti e riavviare la stampa. Il parametro DIRECTION \u00e8 utile se puoi ruotare le viti di regolazione del piatto in una sola direzione. Ad esempio, potresti avere viti che iniziano a stringere nella posizione pi\u00f9 bassa (o pi\u00f9 alta) possibile, che possono essere ruotate solo in una sola direzione, per alzare (o abbassare) il piatto. Se puoi girare le viti solo in senso orario, esegui SCREWS_TILT_CALCULATE DIRECTION=CW . Se puoi ruotarli solo in senso antiorario, esegui SCREWS_TILT_CALCULATE DIRECTION=CCW . Verr\u00e0 scelto un punto di riferimento idoneo in modo tale che il piatto possa essere livellato ruotando tutte le viti nella direzione indicata.","title":"Livellamento manuale"},{"location":"Manual_Level.html#livellamento-manuale","text":"Questo documento descrive gli strumenti per la calibrazione di un finecorsa Z e per l'esecuzione delle regolazioni delle viti di livellamento del piatto.","title":"Livellamento manuale"},{"location":"Manual_Level.html#calibrazione-di-un-finecorsa-z","text":"Una posizione precisa del fine corsa Z \u00e8 fondamentale per ottenere stampe di alta qualit\u00e0. Si noti, tuttavia, che la precisione dell'interruttore di fine corsa Z stesso pu\u00f2 essere un fattore limitante. Se si utilizzano i driver per motori passo-passo Trinamic, considerare l'abilitazione del rilevamento fase finecorsa per migliorare la precisione dell'interruttore. Per eseguire una calibrazione del fine corsa Z, portare la stampante in posizione di partenza, comandare alla testina di spostarsi in una posizione Z che sia almeno cinque millimetri sopra il piatto (se non lo \u00e8 gi\u00e0), comandare alla testina di spostarsi in una posizione XY vicino al centro di piatto, quindi vai alla scheda del terminale OctoPrint ed esegui: Z_ENDSTOP_CALIBRATE Quindi segui i passaggi descritti in \"the paper test\" per determinare la distanza effettiva tra l'ugello e il piatto in una determinata posizione. Una volta completati questi passaggi, \u00e8 possibile \"ACCETTARE\" la posizione e salvare i risultati nel file di configurazione con: SAVE_CONFIG \u00c8 preferibile utilizzare un interruttore di fine corsa Z sull'estremit\u00e0 opposta dell'asse Z rispetto al piatto. (L'allontanamento dal piatto \u00e8 pi\u00f9 robusto in quanto generalmente \u00e8 sempre sicuro mettere a home la Z.) Tuttavia, se si deve tornare a home verso il piatto, si consiglia di regolare il finecorsa in modo che si attivi a una piccola distanza (ad es. 0,5 mm ) sopra il piatto. Quasi tutti gli interruttori di fine corsa possono essere premuti in sicurezza a una piccola distanza oltre il punto di attivazione. Fatto ci\u00f2, si dovrebbe scoprire che il comando Z_ENDSTOP_CALIBRATE riporta un piccolo valore positivo (ad esempio, .5mm) per Z position_endstop. L'attivazione del fine corsa mentre si \u00e8 ancora a una certa distanza dal piatto riduce il rischio di incidenti involontari del piatto. Alcune stampanti hanno la capacit\u00e0 di regolare manualmente la posizione dell'interruttore di fine corsa fisico. Tuttavia, si consiglia di eseguire il posizionamento del finecorsa Z nel software con Klipper: una volta che la posizione fisica del finecorsa \u00e8 in una posizione comoda, \u00e8 possibile apportare ulteriori modifiche eseguendo Z_ENDSTOP_CALIBRATE o aggiornando manualmente Z position_endstop nel file di configurazione.","title":"Calibrazione di un finecorsa Z"},{"location":"Manual_Level.html#regolazione-delle-viti-di-livellamento-del-piatto","text":"Il segreto per ottenere un buon livellamento del piatto con le viti di livellamento \u00e8 utilizzare il sistema di movimento ad alta precisione della stampante durante il processo di livellamento del piatto stesso. Questo viene fatto comandando l'ugello in una posizione vicino a ciascuna vite del piatto e quindi regolando quella vite fino a quando il piatto non \u00e8 a una distanza prestabilita dall'ugello. Klipper ha uno strumento per aiutare con questo. Per utilizzare lo strumento \u00e8 necessario specificare la posizione XY di ciascuna vite. Questo viene fatto creando una sezione di configurazione [bed_screws] . Ad esempio, potrebbe sembrare qualcosa di simile a: [bed_screws] screw1: 100, 50 screw2: 100, 150 screw3: 150, 100 Se una vite del piatto \u00e8 sotto il piatto, specificare la posizione XY direttamente sopra la vite. Se la vite \u00e8 fuori dal piatto, specificare una posizione XY pi\u00f9 vicina alla vite che sia ancora all'interno del raggio del piatto. Una volta che il file di configurazione \u00e8 pronto, esegui RESTART per caricare quella configurazione, quindi puoi avviare lo strumento eseguendo: BED_SCREWS_ADJUST Questo strumento sposter\u00e0 l'ugello della stampante in ciascuna posizione XY della vite e quindi sposter\u00e0 l'ugello a un'altezza Z=0. A questo punto si pu\u00f2 utilizzare la \"prova della carta\" per regolare la vite del piatto direttamente sotto l'ugello. Vedere le informazioni descritte in \"the paper test\" , ma regolare la vite del piatto invece di comandare l'ugello ad altezze diverse. Regolare la vite del piatto finch\u00e9 non c'\u00e8 una piccola quantit\u00e0 di attrito quando si spinge la carta avanti e indietro. Una volta che la vite \u00e8 stata regolata in modo da avvertire una piccola quantit\u00e0 di attrito, eseguire il comando ACCEPT o ADJUSTED . Utilizzare il comando ADJUSTED se la vite del piatto necessita di una regolazione (in genere qualcosa di pi\u00f9 di circa 1/8 di giro della vite). Utilizzare il comando ACCEPT se non sono necessarie modifiche significative. Entrambi i comandi faranno s\u00ec che lo strumento proceda alla vite successiva. (Quando viene utilizzato un comando ADJUSTED , lo strumento pianificher\u00e0 un ciclo aggiuntivo di regolazioni delle viti di appoggio; lo strumento viene completato correttamente quando tutte le viti di appoggio vengono verificate e non richiedono regolazioni significative.) \u00c8 possibile utilizzare il comando 'ABORT' per uscire lo strumento in anticipo. Questo sistema funziona al meglio quando la stampante ha una superficie di stampa piatta (come il vetro) e ha binari diritti. Dopo aver completato con successo lo strumento di livellamento del piatto, il piatto dovrebbe essere pronto per la stampa.","title":"Regolazione delle viti di livellamento del piatto"},{"location":"Manual_Level.html#regolazione-fine-della-vite-del-piatto","text":"Se la stampante utilizza tre viti del piatto e tutte e tre le viti sono sotto il piatto, potrebbe essere possibile eseguire una seconda fase di livellamento del piatto \"ad alta precisione\". Questo viene fatto comandando l'ugello in punti in cui il piatto si sposta di una distanza maggiore con ciascuna regolazione della vite del piatto. Ad esempio, considera un piatto con viti nelle posizioni A, B e C: Per ogni regolazione effettuata alla vite del piatto nella posizione C, il piatto osciller\u00e0 lungo un pendolo definito dalle restanti due viti del piatto (mostrate qui come una linea verde). In questa situazione, ogni regolazione della vite del piatto in C sposter\u00e0 il letto nella posizione D di una quantit\u00e0 maggiore rispetto a C. \u00c8 quindi possibile effettuare una regolazione della vite C migliorata quando l'ugello \u00e8 in posizione D. Per abilitare questa funzione, si dovrebbero determinare le coordinate dell'ugello aggiuntive e aggiungerle al file di configurazione. Ad esempio, potrebbe essere simile a: [bed_screws] screw1: 100, 50 screw1_fine_adjust: 0, 0 screw2: 100, 150 screw2_fine_adjust: 300, 300 screw3: 150, 100 screw3_fine_adjust: 0, 100 Quando questa funzione \u00e8 abilitata, lo strumento BED_SCREWS_ADJUST richieder\u00e0 prima le regolazioni grossolane direttamente sopra ogni posizione della vite e, una volta accettate, richieder\u00e0 le regolazioni fini nelle posizioni aggiuntive. Continua a usare ACCEPT e ADJUSTED in ogni posizione.","title":"Regolazione fine della vite del piatto"},{"location":"Manual_Level.html#regolazione-delle-viti-di-livellamento-del-piatto-mediante-la-sonda-del-piatto","text":"Questo \u00e8 un altro modo per calibrare il livello del piatto utilizzando la sonda del piatto. Per utilizzarlo \u00e8 necessario disporre di una sonda Z (BL Touch, Sensore induttivo, ecc). Per abilitare questa funzione, si dovrebbero determinare le coordinate dell'ugello in modo tale che la sonda Z sia sopra le viti, quindi aggiungerle al file di configurazione. Ad esempio, potrebbe essere simile a: [screws_tilt_adjust] screw1: -5, 30 screw1_name: front left screw screw2: 155, 30 screw2_name: front right screw screw3: 155, 190 screw3_name: rear right screw screw4: -5, 190 screw4_name: rear left screw horizontal_move_z: 10. speed: 50. screw_thread: CW-M3 La vite1 \u00e8 sempre il punto di riferimento per le altre, quindi il sistema presume che la vite1 sia all'altezza corretta. Eseguire sempre prima G28 e poi eseguire SCREWS_TILT_CALCULATE - dovrebbe produrre un output simile a: Send: G28 Recv: ok Send: SCREWS_TILT_CALCULATE Recv: // 01:20 means 1 full turn and 20 minutes, CW=clockwise, CCW=counter-clockwise Recv: // front left screw (base) : x=-5.0, y=30.0, z=2.48750 Recv: // front right screw : x=155.0, y=30.0, z=2.36000 : adjust CW 01:15 Recv: // rear right screw : y=155.0, y=190.0, z=2.71500 : adjust CCW 00:50 Recv: // read left screw : x=-5.0, y=190.0, z=2.47250 : adjust CW 00:02 Recv: ok Ci\u00f2 significa che: la vite anteriore sinistra \u00e8 il punto di riferimento non devi cambiarla. la vite anteriore destra deve essere ruotata in senso orario di 1 giro completo e un quarto di giro la vite posteriore destra deve essere ruotata in senso antiorario per '50 minuti' la vite posteriore sinistra deve essere ruotata in senso orario '2 minuti' (non serve va bene) Si noti che \"minuti\" si riferisce ai \"minuti di un quadrante\". Quindi, ad esempio, 15 minuti sono un quarto di giro completo. Ripeti il processo pi\u00f9 volte fino a ottenere un piatto ben livellato, normalmente quando tutte le regolazioni richiedono meno di 6 minuti. Se si utilizza una sonda montata sul lato dell'hotend (ovvero, ha un offset X o Y), tenere presente che la regolazione dell'inclinazione del piatto invalider\u00e0 qualsiasi precedente calibrazione della sonda eseguita con unpiatto inclinato. Assicurarsi di eseguire calibrazione sonda dopo aver regolato le viti del piatto. Il parametro MAX_DEVIATION \u00e8 utile quando viene utilizzata una mesh del piatto salvata, per garantire che il livello del pitto non si sia spostato troppo lontano da dove si trovava quando \u00e8 stata creata la mesh. Ad esempio, SCREWS_TILT_CALCULATE MAX_DEVIATION=0.01 pu\u00f2 essere aggiunto al gcode iniziale personalizzato dello slicer prima del caricamento della mesh. Interromper\u00e0 la stampa se viene superato il limite configurato (0,01 mm in questo esempio), dando all'utente la possibilit\u00e0 di regolare le viti e riavviare la stampa. Il parametro DIRECTION \u00e8 utile se puoi ruotare le viti di regolazione del piatto in una sola direzione. Ad esempio, potresti avere viti che iniziano a stringere nella posizione pi\u00f9 bassa (o pi\u00f9 alta) possibile, che possono essere ruotate solo in una sola direzione, per alzare (o abbassare) il piatto. Se puoi girare le viti solo in senso orario, esegui SCREWS_TILT_CALCULATE DIRECTION=CW . Se puoi ruotarli solo in senso antiorario, esegui SCREWS_TILT_CALCULATE DIRECTION=CCW . Verr\u00e0 scelto un punto di riferimento idoneo in modo tale che il piatto possa essere livellato ruotando tutte le viti nella direzione indicata.","title":"Regolazione delle viti di livellamento del piatto mediante la sonda del piatto"},{"location":"Measuring_Resonances.html","text":"Misurazione delle risonanze \u00b6 Klipper ha il supporto integrato per l'accelerometro ADXL345, che pu\u00f2 essere utilizzato per misurare le frequenze di risonanza della stampante per diversi assi, e per l'autotuning input shapers per compensare le risonanze. Si noti che l'utilizzo di ADXL345 richiede alcune operazioni di saldatura e crimpatura. ADXL345 pu\u00f2 essere collegato direttamente a un Raspberry Pi o a un'interfaccia SPI di una scheda MCU (deve essere ragionevolmente veloce). Quando acquisti ADXL345, tieni presente che esiste una variet\u00e0 di diversi design di schede PCB e diversi cloni di essi. Assicurati che la scheda supporti la modalit\u00e0 SPI (un piccolo numero di schede sembra essere configurato in modo rigido per I2C trascinando SDO su GND) e, se deve essere collegato a un MCU per stampante da 5 V, che abbia un regolatore di tensione e un cambio di livello. Istruzioni per l'installazione \u00b6 Cablaggio \u00b6 Si consiglia un cavo Ethernet con doppini intrecciati schermati (cat5e o superiore) per l'integrit\u00e0 del segnale su lunghe distanze. Se si verificano ancora problemi di integrit\u00e0 del segnale (errori SPI/I2C), accorciare il cavo. Collegare la schermatura del cavo Ethernet al gnd/ground della scheda controller RPI. Ricontrolla il cablaggio prima di accendere per evitare di danneggiare il tuo MCU/Raspberry Pi o l'accelerometro. Accelerometri SPI \u00b6 Ordine dei doppini intrecciati suggerito: GND+MISO 3.3V+MOSI SCLK+CS ADXL345 \u00b6 Nota: molti MCU funzionano con un ADXL345 in modalit\u00e0 SPI (ad es. Pi Pico), il cablaggio e la configurazione variano in base alla scheda specifica ed ai pin disponibili. Devi connettere ADXL345 al tuo Raspberry Pi tramite SPI. Si noti che la connessione I2C, suggerita dalla documentazione di ADXL345, ha un throughput troppo basso e non funzioner\u00e0 . Lo schema di connessione consigliato: ADXL345 pin RPi pin Nome pin RPi 3V3 (or VCC) 01 3.3v alimentazione DC GND 06 Ground CS 24 GPIO08 (SPI0_CE0_N) SDO 21 GPIO09 (SPI0_MISO) SDA 19 GPIO10 (SPI0_MOSI) SCL 23 GPIO11 (SPI0_SCLK) Schemi collegamenti Fritzing per alcune delle schede ADXL345: Accelerometri I2C \u00b6 Ordine dei doppini intrecciati suggerito: 3.3V+SDA GND+SCL MPU-9250/MPU-9255/MPU-6515/MPU-6050/MPU-6500 \u00b6 Le alternative all'ADXL345 sono MPU-9250/MPU-9255/MPU-6515/MPU-6050/MPU-6500. Questi accelerometri sono stati testati per funzionare su I2C su RPi o RP2040(pico) a 400kbaud. Schema di connessione consigliato per I2C su Raspberry Pi: pin MPU-9250 RPi pin Nome pin RPi VCC 01 3.3v alimentazione DC GND 09 Ground SDA 03 GPIO02 (SDA1) SCL 05 GPIO03 (SCL1) Schema di connessione consigliato per I2C(i2c0a) su RP2040: pin MPU-9250 pin RP2040 Nome pin RPi VCC 39 3v3 GND 38 Ground SDA 01 GP0 (I2C0 SDA) SCL 02 GP1 (I2C0 SCL) Montaggio dell'accelerometro \u00b6 L'accelerometro deve essere collegato alla testa di stampa. \u00c8 necessario progettare un supporto adeguato che si adatti alla propria stampante 3D. \u00c8 meglio allineare gli assi dell'accelerometro con gli assi della stampante (ma se lo rende pi\u00f9 comodo, gli assi possono essere scambiati - cio\u00e8 non c'\u00e8 bisogno di allineare l'asse X con X e cos\u00ec via - dovrebbe andare bene anche se l'asse Z di l'accelerometro \u00e8 l'asse X della stampante, ecc.). Un esempio di montaggio di ADXL345 su SmartEffect: Si noti che su una stampante con piatto mobile \u00e8 necessario progettare 2 supporti: uno per la testina e uno per il piatto, ed eseguire le misurazioni due volte. Per maggiori dettagli, vedere la sezione corrispondente. Attenzione: assicurati che l'accelerometro e le eventuali viti che lo tengono in posizione non tocchino parti metalliche della stampante. Fondamentalmente, il supporto deve essere progettato in modo tale da garantire l'isolamento elettrico dell'accelerometro dal telaio della stampante. Non riuscendo a garantire che pu\u00f2 creare un loop di massa nel sistema che potrebbe danneggiare l'elettronica. Installazione software \u00b6 Si noti che le misurazioni della risonanza e la calibrazione automatica dello shaper richiedono dipendenze software aggiuntive non installate per impostazione predefinita. Innanzitutto, esegui sul tuo Raspberry Pi i seguenti comandi: sudo apt update sudo apt install python3-numpy python3-matplotlib libatlas-base-dev Quindi, per installare NumPy nell'ambiente Klipper, esegui il comando: ~/klippy-env/bin/pip install -v numpy Nota che, a seconda delle prestazioni della CPU, potrebbe volerci molto tempo, fino a 10-20 minuti. Sii paziente e attendi il completamento dell'installazione. In alcune occasioni, se la scheda ha poca RAM, l'installazione potrebbe non riuscire e sar\u00e0 necessario abilitare la swap. Successivamente, controlla e segui le istruzioni nel documento RPi Microcontroller per configurare \"linux mcu\" sul Raspberry Pi. Configura ADXL345 con RPi \u00b6 Assicurati che il driver SPI di Linux sia abilitato eseguendo sudo raspi-config e abilitando SPI nel menu \"Opzioni di interfaccia\". Aggiungere quanto segue al file printer.cfg: [mcu rpi] serial: /tmp/klipper_host_mcu [adxl345] cs_pin: rpi:None [resonance_tester] accel_chip: adxl345 probe_points: 100, 100, 20 # un esempio Si consiglia di iniziare con 1 punto sonda, al centro del piano di stampa, leggermente al di sopra di esso. Configura la serie MPU-6000/9000 con RPi \u00b6 Assicurati che il driver Linux I2C sia abilitato e che la velocit\u00e0 di trasmissione sia impostata su 400000 (consulta la sezione Abilitazione di I2C per ulteriori dettagli). Quindi, aggiungi quanto segue a printer.cfg: [mcu rpi] serial: /tmp/klipper_host_mcu [mpu9250] i2c_mcu: rpi i2c_bus: i2c.1 [resonance_tester] accel_chip: mpu9250 probe_points: 100, 100, 20 # un esempio Configura la serie MPU-6000/9000 con PICO \u00b6 PICO I2C \u00e8 impostato su 400000 per impostazione predefinita. Aggiungi semplicemente quanto segue a printer.cfg: [mcu pico] serial: /dev/serial/by-id/<ID seriale del tuo PICO> [mpu9250] i2c_mcu: pico i2c_bus: i2c1a [resonance_tester] accel_chip: mpu9250 probe_points: 100, 100, 20 # un esempio [static_digital_output pico_3V3pwm] # Aumenta la stabilit\u00e0 pin:pico:gpio23 Riavvia Klipper tramite il comando RESTART . Misurare le risonanze \u00b6 Controllo della configurazione \u00b6 Ora puoi testare una connessione. Per \"per piatti non scorrevoli\" (es. un accelerometro), in Octoprint, inserisci ACCELEROMETER_QUERY Per \"piatti scorrevoli\" (ad es. pi\u00f9 di un accelerometro), immettere ACCELEROMETER_QUERY CHIP=<chip> dove <chip> \u00e8 il nome del chip immesso, ad es. CHIP=piatto (vedi: bed-slinger ) per tutti i chip dell'accelerometro installati. Dovresti vedere le misurazioni attuali dall'accelerometro, inclusa l'accelerazione di caduta libera, ad es. Recv: // adxl345 values (x, y, z): 470.719200, 941.438400, 9728.196800 Se ricevi un errore come Invalid adxl345 id (got xx vs e5) , dove xx \u00e8 un altro ID, \u00e8 indicativo del problema di connessione con ADXL345 o del sensore difettoso. Ricontrolla l'alimentazione, il cablaggio (che corrisponda agli schemi, nessun filo \u00e8 rotto o allentato, ecc.) e la qualit\u00e0 delle saldature. Se si utilizza l'accelerometro della serie MPU-6000/9000 e viene visualizzato come mpu-unknown , utilizzare con cautela! Probabilmente sono chip ricondizionati! Quindi, prova a eseguire MEASURE_AXES_NOISE in Octoprint, dovresti ottenere alcuni numeri di riferimento per il rumore dell'accelerometro sugli assi (dovrebbe essere compreso tra ~1-100). Un rumore degli assi troppo elevato (ad es. 1000 e pi\u00f9) pu\u00f2 essere indicativo di problemi con il sensore, problemi con la sua alimentazione o ventole sbilanciate troppo rumorose su una stampante 3D. Misurare le risonanze \u00b6 Ora puoi eseguire alcuni test realistici. Esegui il seguente comando: TEST_RESONANCES AXIS=X Nota che creer\u00e0 vibrazioni sull'asse X. Disabiliter\u00e0 anche l'input shaping se era stato abilitato in precedenza, poich\u00e9 non \u00e8 valido eseguire il test di risonanza con l'input shaper abilitato. Attenzione! Assicurati di osservare la stampante per la prima volta, per assicurarti che le vibrazioni non diventino troppo violente (il comando M112 pu\u00f2 essere utilizzato per interrompere il test in caso di emergenza; si spera che non si verifichi questo per\u00f2). Se le vibrazioni diventano troppo forti, puoi provare a specificare un valore inferiore al valore predefinito per il parametro accel_per_hz nella sezione [resonance_tester] , ad es. [resonance_tester] accel_chip: adxl345 accel_per_hz: 50 # default \u00e8 75 probe_points: ... Se funziona per l'asse X, esegui anche per l'asse Y: TEST_RESONANCES AXIS=Y Questo generer\u00e0 2 file CSV ( /tmp/resonances_x_*.csv e /tmp/resonances_y_*.csv ). Questi file possono essere elaborati con lo script autonomo su un Raspberry Pi. Per farlo, esegui i seguenti comandi: ~/klipper/scripts/calibrate_shaper.py /tmp/resonances_x_*.csv -o /tmp/shaper_calibrate_x.png ~/klipper/scripts/calibrate_shaper.py /tmp/resonances_y_*.csv -o /tmp/shaper_calibrate_y.png Questo script generer\u00e0 i grafici /tmp/shaper_calibrate_x.png e /tmp/shaper_calibrate_y.png con le risposte in frequenza. Riceverai anche le frequenze suggerite per ogni input shaper, nonch\u00e9 quale input shaper \u00e8 consigliato per la tua configurazione. Per esempio: Fitted shaper 'zv' frequency = 34.4 Hz (vibrations = 4.0%, smoothing ~= 0.132) To avoid too much smoothing with 'zv', suggested max_accel <= 4500 mm/sec^2 Fitted shaper 'mzv' frequency = 34.6 Hz (vibrations = 0.0%, smoothing ~= 0.170) To avoid too much smoothing with 'mzv', suggested max_accel <= 3500 mm/sec^2 Fitted shaper 'ei' frequency = 41.4 Hz (vibrations = 0.0%, smoothing ~= 0.188) To avoid too much smoothing with 'ei', suggested max_accel <= 3200 mm/sec^2 Fitted shaper '2hump_ei' frequency = 51.8 Hz (vibrations = 0.0%, smoothing ~= 0.201) To avoid too much smoothing with '2hump_ei', suggested max_accel <= 3000 mm/sec^2 Fitted shaper '3hump_ei' frequency = 61.8 Hz (vibrations = 0.0%, smoothing ~= 0.215) To avoid too much smoothing with '3hump_ei', suggested max_accel <= 2800 mm/sec^2 Recommended shaper is mzv @ 34.6 Hz La configurazione suggerita pu\u00f2 essere aggiunta alla sezione [input_shaper] di printer.cfg , ad esempio: [input_shaper] shaper_freq_x: ... shaper_type_x: ... shaper_freq_y: 34.6 shaper_type_y: mzv [printer] max_accel: 3000 # non dovrebbe superare il max_accel stimato per gli assi X e Y oppure puoi scegliere tu stesso un'altra configurazione in base ai grafici generati: i picchi nella densit\u00e0 spettrale di potenza sui grafici corrispondono alle frequenze di risonanza della stampante. Nota che in alternativa puoi eseguire l'autocalibrazione dello input shaper da Klipper directly , che pu\u00f2 essere conveniente, ad esempio, per lo input shaper re-calibration . Stampanti con piatto scorrevole \u00b6 Se la tua stampante ha un piatto scorrevole, dovrai cambiare la posizione dell'accelerometro tra le misurazioni per gli assi X e Y: misurare le risonanze dell'asse X con l'accelerometro collegato alla testa di stampa e le risonanze dell'asse Y - al piatto. Tuttavia, puoi anche collegare due accelerometri contemporaneamente, sebbene debbano essere collegati a schede diverse (ad esempio, a una scheda RPi e MCU della stampante) o a due diverse interfacce SPI fisiche sulla stessa scheda (raramente disponibili). Quindi possono essere configurati nel modo seguente: [adxl345 hotend] # Supponendo che il chip \"hotend\" sia collegato a un RPi cs_pin: rpi:None [adxl345 bed] # Supponendo che il chip `bed` sia collegato a una scheda MCU della stampante cs_pin: ... # Pin di selezione chip SPI (CS) della scheda stampante [resonance_tester] # Assumendo la configurazione tipo della stampante con piatto scorrevole accel_chip_x: adxl345 hotend accel_chip_y: adxl345 bed probe_points: ... Quindi i comandi TEST_RESONANCES AXIS=X e TEST_RESONANCES AXIS=Y utilizzeranno l'accelerometro corretto per ciascun asse. Max smoothing \u00b6 Tieni presente che lo input shaper pu\u00f2 creare un po' di smoothing nelle parti. La regolazione automatica del input shaper eseguita dallo script calibrate_shaper.py o dal comando SHAPER_CALIBRATE cercano di non esacerbare lo smoothing, ma allo stesso tempo cercano di ridurre al minimo le vibrazioni risultanti. A volte possono fare una scelta non ottimale della frequenza dello shaper, o forse semplicemente preferisci avere meno smoothing in alcune parti a scapito di maggiori vibrazioni residue. In questi casi \u00e8 possibile richiedere di limitare lo smoothing massimo dal input shaper. Consideriamo i seguenti risultati della sintonizzazione automatica: Fitted shaper 'zv' frequency = 57.8 Hz (vibrations = 20.3%, smoothing ~= 0.053) To avoid too much smoothing with 'zv', suggested max_accel <= 13000 mm/sec^2 Fitted shaper 'mzv' frequency = 34.8 Hz (vibrations = 3.6%, smoothing ~= 0.168) To avoid too much smoothing with 'mzv', suggested max_accel <= 3600 mm/sec^2 Fitted shaper 'ei' frequency = 48.8 Hz (vibrations = 4.9%, smoothing ~= 0.135) To avoid too much smoothing with 'ei', suggested max_accel <= 4400 mm/sec^2 Fitted shaper '2hump_ei' frequency = 45.2 Hz (vibrations = 0.1%, smoothing ~= 0.264) To avoid too much smoothing with '2hump_ei', suggested max_accel <= 2200 mm/sec^2 Fitted shaper '3hump_ei' frequency = 48.0 Hz (vibrations = 0.0%, smoothing ~= 0.356) To avoid too much smoothing with '3hump_ei', suggested max_accel <= 1500 mm/sec^2 Recommended shaper is 2hump_ei @ 45.2 Hz Si noti che i valori di smoothing riportati sono alcuni valori proiettati. Questi valori possono essere utilizzati per confrontare diverse configurazioni: maggiore \u00e8 il valore, maggiore sar\u00e0 la levigatura creata da uno shaper. Tuttavia, questi punteggi di smoothing non rappresentano alcuna misura reale dello smoothing, perch\u00e9 lo smoothing effettivo dipende dai parametri max_accel e square_corner_velocity . Pertanto, \u00e8 necessario eseguire alcune stampe di prova per vedere quanta smoothing crea esattamente una configurazione scelta. Nell'esempio sopra i parametri dello shaper suggeriti non sono male, ma cosa succede se si desidera ottenere meno smooting sull'asse X? Puoi provare a limitare lo smoothing massimo dello shaper usando il seguente comando: ~/klipper/scripts/calibrate_shaper.py /tmp/resonances_x_*.csv -o /tmp/shaper_calibrate_x.png --max_smoothing=0.2 che limita lo smoothing a un punteggio di 0.2. Ora puoi ottenere il seguente risultato: Fitted shaper 'zv' frequency = 55.4 Hz (vibrations = 19.7%, smoothing ~= 0.057) To avoid too much smoothing with 'zv', suggested max_accel <= 12000 mm/sec^2 Fitted shaper 'mzv' frequency = 34.6 Hz (vibrations = 3.6%, smoothing ~= 0.170) To avoid too much smoothing with 'mzv', suggested max_accel <= 3500 mm/sec^2 Fitted shaper 'ei' frequency = 48.2 Hz (vibrations = 4.8%, smoothing ~= 0.139) To avoid too much smoothing with 'ei', suggested max_accel <= 4300 mm/sec^2 Fitted shaper '2hump_ei' frequency = 52.0 Hz (vibrations = 2.7%, smoothing ~= 0.200) To avoid too much smoothing with '2hump_ei', suggested max_accel <= 3000 mm/sec^2 Fitted shaper '3hump_ei' frequency = 72.6 Hz (vibrations = 1.4%, smoothing ~= 0.155) To avoid too much smoothing with '3hump_ei', suggested max_accel <= 3900 mm/sec^2 Recommended shaper is 3hump_ei @ 72.6 Hz Se si confronta con i parametri suggeriti in precedenza, le vibrazioni sono un po' maggiori, ma lo smoothing \u00e8 notevolmente inferiore rispetto a prima, consentendo un'accelerazione massima maggiore. Quando si decide quale parametro max_smoothing scegliere, \u00e8 possibile utilizzare un approccio per tentativi. Prova alcuni valori diversi e guarda quali risultati ottieni. Si noti che lo smoothing effettivo prodotto dall'input shaper dipende principalmente dalla frequenza di risonanza pi\u00f9 bassa della stampante: maggiore \u00e8 la frequenza della risonanza pi\u00f9 bassa, minore \u00e8 lo smoothing. Pertanto, se si richiede allo script di trovare una configurazione dell'input shaper con lo smoothing irrealisticamente piccolo, sar\u00e0 a scapito di un aumento del ringing alle frequenze di risonanza pi\u00f9 basse (che sono, in genere, anche pi\u00f9 visibili nelle stampe). Quindi, ricontrolla sempre le vibrazioni rimanenti previste riportate dallo script e assicurati che non siano troppo alte. Nota che se hai scelto un buon valore max_smoothing per entrambi gli assi, puoi salvarlo in printer.cfg come [resonance_tester] accel_chip: ... probe_points: ... max_smoothing: 0.25 # un esempio Quindi, se riesegui l'autotuning dello shaper di input usando il comando Klipper SHAPER_CALIBRATE in futuro, utilizzer\u00e0 il valore max_smoothing memorizzato come riferimento. Seleziona max_accel \u00b6 Poich\u00e9 l'input shaper pu\u00f2 creare un po' di smussamento nelle parti, specialmente ad accelerazioni elevate, sar\u00e0 comunque necessario scegliere il valore max_accel che non crei troppo smussamento \"smoothing\" nelle parti stampate. Uno script di calibrazione fornisce una stima per il parametro max_accel che non dovrebbe creare un smoothing eccessivo. Si noti che il max_accel visualizzato dallo script di calibrazione \u00e8 solo un massimo teorico al quale il rispettivo shaper \u00e8 ancora in grado di lavorare senza produrre troppo smoothing. Non \u00e8 affatto una raccomandazione impostare questa accelerazione per la stampa. L'accelerazione massima che la stampante \u00e8 in grado di sostenere dipende dalle sue propriet\u00e0 meccaniche e dalla coppia massima dei motori passo-passo utilizzati. Pertanto, si suggerisce di impostare max_accel nella sezione [printer] che non superi i valori stimati per gli assi X e Y, probabilmente con un margine di sicurezza conservativo. In alternativa, segui questa parte della guida all'ottimizzazione dello input shaper e stampa il modello di test per scegliere sperimentalmente il parametro max_accel . Lo stesso avviso vale per lo input shaper auto-calibration con il comando SHAPER_CALIBRATE : \u00e8 comunque necessario scegliere il giusto valore di max_accel dopo l'auto-calibrazione, e il i limiti di accelerazione non verranno applicati automaticamente. Se stai eseguendo una ricalibrazione dello shaper e lo smoothing riportato per la configurazione dello shaper suggerita \u00e8 quasi lo stesso di quello ottenuto durante la calibrazione precedente, questo passaggio pu\u00f2 essere saltato. Test di assi personalizzati \u00b6 Il comando TEST_RESONANCES supporta assi personalizzati. Anche se questo non \u00e8 molto utile per la calibrazione del input shaper, pu\u00f2 essere utilizzato per studiare in profondit\u00e0 le risonanze della stampante e per controllare, ad esempio, la tensione della cinghia. Per controllare la tensione della cinghia sulle stampanti CoreXY, eseguire TEST_RESONANCES AXIS=1,1 OUTPUT=raw_data TEST_RESONANCES AXIS=1,-1 OUTPUT=raw_data e usa graph_accelerometer.py per elaborare i file generati, ad es. ~/klipper/scripts/graph_accelerometer.py -c /tmp/raw_data_axis*.csv -o /tmp/resonances.png che generer\u00e0 /tmp/resonances.png confrontando le risonanze. Per le stampanti Delta con la posizione della torre predefinita (torre A ~= 210 gradi, B ~= 330 gradi e C ~= 90 gradi), eseguire TEST_RESONANCES AXIS=0,1 OUTPUT=raw_data TEST_RESONANCES AXIS=-0.866025404,-0.5 OUTPUT=raw_data TEST_RESONANCES AXIS=0.866025404,-0.5 OUTPUT=raw_data e quindi utilizzare lo stesso comando ~/klipper/scripts/graph_accelerometer.py -c /tmp/raw_data_axis*.csv -o /tmp/resonances.png per generare /tmp/resonances.png confrontando le risonanze. Calibrazione automatica Input Shaper \u00b6 Oltre a scegliere manualmente i parametri appropriati per la funzione di input shaper, \u00e8 anche possibile eseguire l'autotuning per l'input shaper direttamente da Klipper. Esegui il seguente comando tramite il terminale Octoprint: SHAPER_CALIBRATE Questo eseguir\u00e0 il test completo per entrambi gli assi e generer\u00e0 l'output csv ( /tmp/calibration_data_*.csv per impostazione predefinita) per la risposta in frequenza e gli input shaper suggeriti. Riceverai anche le frequenze suggerite per ciascun input shaper, nonch\u00e9 quale input shaper \u00e8 consigliato per la tua configurazione, sulla console Octoprint. Per esempio: Calculating the best input shaper parameters for y axis Fitted shaper 'zv' frequency = 39.0 Hz (vibrations = 13.2%, smoothing ~= 0.105) To avoid too much smoothing with 'zv', suggested max_accel <= 5900 mm/sec^2 Fitted shaper 'mzv' frequency = 36.8 Hz (vibrations = 1.7%, smoothing ~= 0.150) To avoid too much smoothing with 'mzv', suggested max_accel <= 4000 mm/sec^2 Fitted shaper 'ei' frequency = 36.6 Hz (vibrations = 2.2%, smoothing ~= 0.240) To avoid too much smoothing with 'ei', suggested max_accel <= 2500 mm/sec^2 Fitted shaper '2hump_ei' frequency = 48.0 Hz (vibrations = 0.0%, smoothing ~= 0.234) To avoid too much smoothing with '2hump_ei', suggested max_accel <= 2500 mm/sec^2 Fitted shaper '3hump_ei' frequency = 59.0 Hz (vibrations = 0.0%, smoothing ~= 0.235) To avoid too much smoothing with '3hump_ei', suggested max_accel <= 2500 mm/sec^2 Recommended shaper_type_y = mzv, shaper_freq_y = 36.8 Hz Se sei d'accordo con i parametri suggeriti, puoi eseguire ora SAVE_CONFIG per salvarli e riavviare Klipper. Nota che questo non aggiorner\u00e0 il valore max_accel nella sezione [printer] . Dovresti aggiornarlo manualmente seguendo le considerazioni nella sezione Selecting max_accel . Se la tua stampante \u00e8 una stampante a piatto mobile, puoi specificare quale asse testare, in modo da poter cambiare il punto di montaggio dell'accelerometro tra i test (per impostazione predefinita, il test viene eseguito per entrambi gli assi): SHAPER_CALIBRATE AXIS=Y \u00c8 possibile eseguire SAVE_CONFIG due volte, dopo aver calibrato ciascun asse. Tuttavia, se hai collegato due accelerometri contemporaneamente, esegui semplicemente SHAPER_CALIBRATE senza specificare un asse per calibrare l' input shaper per entrambi gli assi in una volta sola. Input Shaper ricalibrazione \u00b6 Il comando SHAPER_CALIBRATE pu\u00f2 essere utilizzato anche per ricalibrare lo shaper di input in futuro, specialmente se vengono apportate alcune modifiche alla stampante che possono influire sulla sua cinematica. \u00c8 possibile eseguire nuovamente la calibrazione completa utilizzando il comando SHAPER_CALIBRATE , o limitare l'autocalibrazione a un singolo asse fornendo il parametro AXIS= , come SHAPER_CALIBRATE AXIS=X Attenzione! Non \u00e8 consigliabile eseguire l'autocalibrazione dello shaper molto frequentemente (ad es. prima di ogni stampa o ogni giorno). Per determinare le frequenze di risonanza, l'autocalibrazione crea intense vibrazioni su ciascuno degli assi. Generalmente, le stampanti 3D non sono progettate per resistere a un'esposizione prolungata a vibrazioni vicino alle frequenze di risonanza. Ci\u00f2 potrebbe aumentare l'usura dei componenti della stampante e ridurne la durata. C'\u00e8 anche un aumento del rischio che alcune parti si svitino o si allentino. Verificare sempre che tutte le parti della stampante (comprese quelle che normalmente potrebbero non muoversi) siano fissate saldamente in posizione dopo ogni autotuning. Inoltre, a causa di un po' di rumore nelle misurazioni, \u00e8 possibile che i risultati dell'ottimizzazione siano leggermente diversi da una calibrazione all'altra. Tuttavia, non ci si aspetta che il rumore influisca troppo sulla qualit\u00e0 di stampa. Tuttavia, si consiglia comunque di ricontrollare i parametri suggeriti e di stampare alcune stampe di prova prima di utilizzarli per confermare che siano corretti. Elaborazione offline dei dati dell'accelerometro \u00b6 \u00c8 possibile generare i dati grezzi dell'accelerometro ed elaborarli offline (ad esempio su una macchina host), ad esempio per trovare risonanze. Per fare ci\u00f2, esegui i seguenti comandi tramite il terminale Octoprint: SET_INPUT_SHAPER SHAPER_FREQ_X=0 SHAPER_FREQ_Y=0 TEST_RESONANCES AXIS=X OUTPUT=raw_data ignorando eventuali errori per il comando SET_INPUT_SHAPER . Per il comando TEST_RESONANCES , specificare l'asse di test desiderato. I dati grezzi verranno scritti nella directory /tmp sull'RPi. I dati grezzi possono anche essere ottenuti eseguendo il comando ACCELEROMETER_MEASURE due volte durante una normale attivit\u00e0 della stampante: prima per avviare le misurazioni, quindi per interromperle e scrivere il file di output. Fare riferimento a G-Codes per maggiori dettagli. I dati possono essere elaborati successivamente dai seguenti script: scripts/graph_accelerometer.py e scripts/calibrate_shaper.py . Entrambi accettano uno o pi\u00f9 file CSV non elaborati come input a seconda della modalit\u00e0. Lo script graph_accelerometer.py supporta diverse modalit\u00e0 operative: tracciando i dati grezzi dell'accelerometro (usa il parametro -r ), \u00e8 supportato solo 1 input; tracciando una risposta in frequenza (non sono richiesti parametri aggiuntivi), se sono specificati pi\u00f9 ingressi, viene calcolata la risposta in frequenza media; confronto della risposta in frequenza tra pi\u00f9 ingressi (usare il parametro -c ); puoi inoltre specificare quale asse dell'accelerometro considerare tramite il parametro -a x , -a y o -a z (se non specificato, viene utilizzata la somma delle vibrazioni per tutti gli assi); tracciando lo spettrogramma (usare il parametro -s ), \u00e8 supportato solo 1 input; \u00e8 inoltre possibile specificare quale asse dell'accelerometro considerare tramite il parametro -a x , -a y o -a z (se non specificato, viene utilizzata la somma delle vibrazioni per tutti gli assi). Si noti che lo script graph_accelerometer.py supporta solo i file raw_data*.csv e non i file resonances*.csv o calibration_data*.csv. Per esempio, ~/klipper/scripts/graph_accelerometer.py /tmp/raw_data_x_*.csv -o /tmp/resonances_x.png -c -a z traccer\u00e0 il confronto di diversi file /tmp/raw_data_x_*.csv per l'asse Z con il file /tmp/resonances_x.png . Lo script shaper_calibrate.py accetta 1 o pi\u00f9 input e pu\u00f2 eseguire l'ottimizzazione automatica dello shaper di input e suggerire i parametri migliori che funzionano bene per tutti gli input forniti. Stampa i parametri suggeriti sulla console e pu\u00f2 inoltre generare il grafico se viene fornito il parametro -o output.png , o il file CSV se viene specificato il parametro -c output.csv . Fornire diversi input allo script shaper_calibrate.py pu\u00f2 essere utile se si esegue un'ottimizzazione avanzata degli shaper di input, ad esempio: Esecuzione di TEST_RESONANCES AXIS=X OUTPUT=raw_data (e asse Y ) per un singolo asse due volte su una stampante con piatto scorrevole con l'accelerometro collegato alla testa di stampa la prima volta e l'accelerometro collegato al piatto la seconda volta in modo da rilevare le risonanze incrociate degli assi e tentare di cancellarle con gli input shaper. Esecuzione di TEST_RESONANCES AXIS=Y OUTPUT=raw_data due volte su un supporto da piatto con un piatto di vetro e una superficie magnetica (che \u00e8 pi\u00f9 leggera) per trovare i parametri dello shaper di input che funzionano bene per qualsiasi configurazione della superficie di stampa. Combinazione dei dati di risonanza da pi\u00f9 punti di test. Combinando i dati di risonanza da 2 assi (ad es. su una stampante con piatto scorrevole per configurare input_shaper dell'asse X dalle risonanze degli assi X e Y per annullare le vibrazioni del piatto nel caso in cui l'ugello \"cattura\" una stampa quando si sposta nella direzione dell'asse X ).","title":"Misurazione delle risonanze"},{"location":"Measuring_Resonances.html#misurazione-delle-risonanze","text":"Klipper ha il supporto integrato per l'accelerometro ADXL345, che pu\u00f2 essere utilizzato per misurare le frequenze di risonanza della stampante per diversi assi, e per l'autotuning input shapers per compensare le risonanze. Si noti che l'utilizzo di ADXL345 richiede alcune operazioni di saldatura e crimpatura. ADXL345 pu\u00f2 essere collegato direttamente a un Raspberry Pi o a un'interfaccia SPI di una scheda MCU (deve essere ragionevolmente veloce). Quando acquisti ADXL345, tieni presente che esiste una variet\u00e0 di diversi design di schede PCB e diversi cloni di essi. Assicurati che la scheda supporti la modalit\u00e0 SPI (un piccolo numero di schede sembra essere configurato in modo rigido per I2C trascinando SDO su GND) e, se deve essere collegato a un MCU per stampante da 5 V, che abbia un regolatore di tensione e un cambio di livello.","title":"Misurazione delle risonanze"},{"location":"Measuring_Resonances.html#istruzioni-per-linstallazione","text":"","title":"Istruzioni per l'installazione"},{"location":"Measuring_Resonances.html#cablaggio","text":"Si consiglia un cavo Ethernet con doppini intrecciati schermati (cat5e o superiore) per l'integrit\u00e0 del segnale su lunghe distanze. Se si verificano ancora problemi di integrit\u00e0 del segnale (errori SPI/I2C), accorciare il cavo. Collegare la schermatura del cavo Ethernet al gnd/ground della scheda controller RPI. Ricontrolla il cablaggio prima di accendere per evitare di danneggiare il tuo MCU/Raspberry Pi o l'accelerometro.","title":"Cablaggio"},{"location":"Measuring_Resonances.html#accelerometri-spi","text":"Ordine dei doppini intrecciati suggerito: GND+MISO 3.3V+MOSI SCLK+CS","title":"Accelerometri SPI"},{"location":"Measuring_Resonances.html#adxl345","text":"Nota: molti MCU funzionano con un ADXL345 in modalit\u00e0 SPI (ad es. Pi Pico), il cablaggio e la configurazione variano in base alla scheda specifica ed ai pin disponibili. Devi connettere ADXL345 al tuo Raspberry Pi tramite SPI. Si noti che la connessione I2C, suggerita dalla documentazione di ADXL345, ha un throughput troppo basso e non funzioner\u00e0 . Lo schema di connessione consigliato: ADXL345 pin RPi pin Nome pin RPi 3V3 (or VCC) 01 3.3v alimentazione DC GND 06 Ground CS 24 GPIO08 (SPI0_CE0_N) SDO 21 GPIO09 (SPI0_MISO) SDA 19 GPIO10 (SPI0_MOSI) SCL 23 GPIO11 (SPI0_SCLK) Schemi collegamenti Fritzing per alcune delle schede ADXL345:","title":"ADXL345"},{"location":"Measuring_Resonances.html#accelerometri-i2c","text":"Ordine dei doppini intrecciati suggerito: 3.3V+SDA GND+SCL","title":"Accelerometri I2C"},{"location":"Measuring_Resonances.html#mpu-9250mpu-9255mpu-6515mpu-6050mpu-6500","text":"Le alternative all'ADXL345 sono MPU-9250/MPU-9255/MPU-6515/MPU-6050/MPU-6500. Questi accelerometri sono stati testati per funzionare su I2C su RPi o RP2040(pico) a 400kbaud. Schema di connessione consigliato per I2C su Raspberry Pi: pin MPU-9250 RPi pin Nome pin RPi VCC 01 3.3v alimentazione DC GND 09 Ground SDA 03 GPIO02 (SDA1) SCL 05 GPIO03 (SCL1) Schema di connessione consigliato per I2C(i2c0a) su RP2040: pin MPU-9250 pin RP2040 Nome pin RPi VCC 39 3v3 GND 38 Ground SDA 01 GP0 (I2C0 SDA) SCL 02 GP1 (I2C0 SCL)","title":"MPU-9250/MPU-9255/MPU-6515/MPU-6050/MPU-6500"},{"location":"Measuring_Resonances.html#montaggio-dellaccelerometro","text":"L'accelerometro deve essere collegato alla testa di stampa. \u00c8 necessario progettare un supporto adeguato che si adatti alla propria stampante 3D. \u00c8 meglio allineare gli assi dell'accelerometro con gli assi della stampante (ma se lo rende pi\u00f9 comodo, gli assi possono essere scambiati - cio\u00e8 non c'\u00e8 bisogno di allineare l'asse X con X e cos\u00ec via - dovrebbe andare bene anche se l'asse Z di l'accelerometro \u00e8 l'asse X della stampante, ecc.). Un esempio di montaggio di ADXL345 su SmartEffect: Si noti che su una stampante con piatto mobile \u00e8 necessario progettare 2 supporti: uno per la testina e uno per il piatto, ed eseguire le misurazioni due volte. Per maggiori dettagli, vedere la sezione corrispondente. Attenzione: assicurati che l'accelerometro e le eventuali viti che lo tengono in posizione non tocchino parti metalliche della stampante. Fondamentalmente, il supporto deve essere progettato in modo tale da garantire l'isolamento elettrico dell'accelerometro dal telaio della stampante. Non riuscendo a garantire che pu\u00f2 creare un loop di massa nel sistema che potrebbe danneggiare l'elettronica.","title":"Montaggio dell'accelerometro"},{"location":"Measuring_Resonances.html#installazione-software","text":"Si noti che le misurazioni della risonanza e la calibrazione automatica dello shaper richiedono dipendenze software aggiuntive non installate per impostazione predefinita. Innanzitutto, esegui sul tuo Raspberry Pi i seguenti comandi: sudo apt update sudo apt install python3-numpy python3-matplotlib libatlas-base-dev Quindi, per installare NumPy nell'ambiente Klipper, esegui il comando: ~/klippy-env/bin/pip install -v numpy Nota che, a seconda delle prestazioni della CPU, potrebbe volerci molto tempo, fino a 10-20 minuti. Sii paziente e attendi il completamento dell'installazione. In alcune occasioni, se la scheda ha poca RAM, l'installazione potrebbe non riuscire e sar\u00e0 necessario abilitare la swap. Successivamente, controlla e segui le istruzioni nel documento RPi Microcontroller per configurare \"linux mcu\" sul Raspberry Pi.","title":"Installazione software"},{"location":"Measuring_Resonances.html#configura-adxl345-con-rpi","text":"Assicurati che il driver SPI di Linux sia abilitato eseguendo sudo raspi-config e abilitando SPI nel menu \"Opzioni di interfaccia\". Aggiungere quanto segue al file printer.cfg: [mcu rpi] serial: /tmp/klipper_host_mcu [adxl345] cs_pin: rpi:None [resonance_tester] accel_chip: adxl345 probe_points: 100, 100, 20 # un esempio Si consiglia di iniziare con 1 punto sonda, al centro del piano di stampa, leggermente al di sopra di esso.","title":"Configura ADXL345 con RPi"},{"location":"Measuring_Resonances.html#configura-la-serie-mpu-60009000-con-rpi","text":"Assicurati che il driver Linux I2C sia abilitato e che la velocit\u00e0 di trasmissione sia impostata su 400000 (consulta la sezione Abilitazione di I2C per ulteriori dettagli). Quindi, aggiungi quanto segue a printer.cfg: [mcu rpi] serial: /tmp/klipper_host_mcu [mpu9250] i2c_mcu: rpi i2c_bus: i2c.1 [resonance_tester] accel_chip: mpu9250 probe_points: 100, 100, 20 # un esempio","title":"Configura la serie MPU-6000/9000 con RPi"},{"location":"Measuring_Resonances.html#configura-la-serie-mpu-60009000-con-pico","text":"PICO I2C \u00e8 impostato su 400000 per impostazione predefinita. Aggiungi semplicemente quanto segue a printer.cfg: [mcu pico] serial: /dev/serial/by-id/<ID seriale del tuo PICO> [mpu9250] i2c_mcu: pico i2c_bus: i2c1a [resonance_tester] accel_chip: mpu9250 probe_points: 100, 100, 20 # un esempio [static_digital_output pico_3V3pwm] # Aumenta la stabilit\u00e0 pin:pico:gpio23 Riavvia Klipper tramite il comando RESTART .","title":"Configura la serie MPU-6000/9000 con PICO"},{"location":"Measuring_Resonances.html#misurare-le-risonanze","text":"","title":"Misurare le risonanze"},{"location":"Measuring_Resonances.html#controllo-della-configurazione","text":"Ora puoi testare una connessione. Per \"per piatti non scorrevoli\" (es. un accelerometro), in Octoprint, inserisci ACCELEROMETER_QUERY Per \"piatti scorrevoli\" (ad es. pi\u00f9 di un accelerometro), immettere ACCELEROMETER_QUERY CHIP=<chip> dove <chip> \u00e8 il nome del chip immesso, ad es. CHIP=piatto (vedi: bed-slinger ) per tutti i chip dell'accelerometro installati. Dovresti vedere le misurazioni attuali dall'accelerometro, inclusa l'accelerazione di caduta libera, ad es. Recv: // adxl345 values (x, y, z): 470.719200, 941.438400, 9728.196800 Se ricevi un errore come Invalid adxl345 id (got xx vs e5) , dove xx \u00e8 un altro ID, \u00e8 indicativo del problema di connessione con ADXL345 o del sensore difettoso. Ricontrolla l'alimentazione, il cablaggio (che corrisponda agli schemi, nessun filo \u00e8 rotto o allentato, ecc.) e la qualit\u00e0 delle saldature. Se si utilizza l'accelerometro della serie MPU-6000/9000 e viene visualizzato come mpu-unknown , utilizzare con cautela! Probabilmente sono chip ricondizionati! Quindi, prova a eseguire MEASURE_AXES_NOISE in Octoprint, dovresti ottenere alcuni numeri di riferimento per il rumore dell'accelerometro sugli assi (dovrebbe essere compreso tra ~1-100). Un rumore degli assi troppo elevato (ad es. 1000 e pi\u00f9) pu\u00f2 essere indicativo di problemi con il sensore, problemi con la sua alimentazione o ventole sbilanciate troppo rumorose su una stampante 3D.","title":"Controllo della configurazione"},{"location":"Measuring_Resonances.html#misurare-le-risonanze_1","text":"Ora puoi eseguire alcuni test realistici. Esegui il seguente comando: TEST_RESONANCES AXIS=X Nota che creer\u00e0 vibrazioni sull'asse X. Disabiliter\u00e0 anche l'input shaping se era stato abilitato in precedenza, poich\u00e9 non \u00e8 valido eseguire il test di risonanza con l'input shaper abilitato. Attenzione! Assicurati di osservare la stampante per la prima volta, per assicurarti che le vibrazioni non diventino troppo violente (il comando M112 pu\u00f2 essere utilizzato per interrompere il test in caso di emergenza; si spera che non si verifichi questo per\u00f2). Se le vibrazioni diventano troppo forti, puoi provare a specificare un valore inferiore al valore predefinito per il parametro accel_per_hz nella sezione [resonance_tester] , ad es. [resonance_tester] accel_chip: adxl345 accel_per_hz: 50 # default \u00e8 75 probe_points: ... Se funziona per l'asse X, esegui anche per l'asse Y: TEST_RESONANCES AXIS=Y Questo generer\u00e0 2 file CSV ( /tmp/resonances_x_*.csv e /tmp/resonances_y_*.csv ). Questi file possono essere elaborati con lo script autonomo su un Raspberry Pi. Per farlo, esegui i seguenti comandi: ~/klipper/scripts/calibrate_shaper.py /tmp/resonances_x_*.csv -o /tmp/shaper_calibrate_x.png ~/klipper/scripts/calibrate_shaper.py /tmp/resonances_y_*.csv -o /tmp/shaper_calibrate_y.png Questo script generer\u00e0 i grafici /tmp/shaper_calibrate_x.png e /tmp/shaper_calibrate_y.png con le risposte in frequenza. Riceverai anche le frequenze suggerite per ogni input shaper, nonch\u00e9 quale input shaper \u00e8 consigliato per la tua configurazione. Per esempio: Fitted shaper 'zv' frequency = 34.4 Hz (vibrations = 4.0%, smoothing ~= 0.132) To avoid too much smoothing with 'zv', suggested max_accel <= 4500 mm/sec^2 Fitted shaper 'mzv' frequency = 34.6 Hz (vibrations = 0.0%, smoothing ~= 0.170) To avoid too much smoothing with 'mzv', suggested max_accel <= 3500 mm/sec^2 Fitted shaper 'ei' frequency = 41.4 Hz (vibrations = 0.0%, smoothing ~= 0.188) To avoid too much smoothing with 'ei', suggested max_accel <= 3200 mm/sec^2 Fitted shaper '2hump_ei' frequency = 51.8 Hz (vibrations = 0.0%, smoothing ~= 0.201) To avoid too much smoothing with '2hump_ei', suggested max_accel <= 3000 mm/sec^2 Fitted shaper '3hump_ei' frequency = 61.8 Hz (vibrations = 0.0%, smoothing ~= 0.215) To avoid too much smoothing with '3hump_ei', suggested max_accel <= 2800 mm/sec^2 Recommended shaper is mzv @ 34.6 Hz La configurazione suggerita pu\u00f2 essere aggiunta alla sezione [input_shaper] di printer.cfg , ad esempio: [input_shaper] shaper_freq_x: ... shaper_type_x: ... shaper_freq_y: 34.6 shaper_type_y: mzv [printer] max_accel: 3000 # non dovrebbe superare il max_accel stimato per gli assi X e Y oppure puoi scegliere tu stesso un'altra configurazione in base ai grafici generati: i picchi nella densit\u00e0 spettrale di potenza sui grafici corrispondono alle frequenze di risonanza della stampante. Nota che in alternativa puoi eseguire l'autocalibrazione dello input shaper da Klipper directly , che pu\u00f2 essere conveniente, ad esempio, per lo input shaper re-calibration .","title":"Misurare le risonanze"},{"location":"Measuring_Resonances.html#stampanti-con-piatto-scorrevole","text":"Se la tua stampante ha un piatto scorrevole, dovrai cambiare la posizione dell'accelerometro tra le misurazioni per gli assi X e Y: misurare le risonanze dell'asse X con l'accelerometro collegato alla testa di stampa e le risonanze dell'asse Y - al piatto. Tuttavia, puoi anche collegare due accelerometri contemporaneamente, sebbene debbano essere collegati a schede diverse (ad esempio, a una scheda RPi e MCU della stampante) o a due diverse interfacce SPI fisiche sulla stessa scheda (raramente disponibili). Quindi possono essere configurati nel modo seguente: [adxl345 hotend] # Supponendo che il chip \"hotend\" sia collegato a un RPi cs_pin: rpi:None [adxl345 bed] # Supponendo che il chip `bed` sia collegato a una scheda MCU della stampante cs_pin: ... # Pin di selezione chip SPI (CS) della scheda stampante [resonance_tester] # Assumendo la configurazione tipo della stampante con piatto scorrevole accel_chip_x: adxl345 hotend accel_chip_y: adxl345 bed probe_points: ... Quindi i comandi TEST_RESONANCES AXIS=X e TEST_RESONANCES AXIS=Y utilizzeranno l'accelerometro corretto per ciascun asse.","title":"Stampanti con piatto scorrevole"},{"location":"Measuring_Resonances.html#max-smoothing","text":"Tieni presente che lo input shaper pu\u00f2 creare un po' di smoothing nelle parti. La regolazione automatica del input shaper eseguita dallo script calibrate_shaper.py o dal comando SHAPER_CALIBRATE cercano di non esacerbare lo smoothing, ma allo stesso tempo cercano di ridurre al minimo le vibrazioni risultanti. A volte possono fare una scelta non ottimale della frequenza dello shaper, o forse semplicemente preferisci avere meno smoothing in alcune parti a scapito di maggiori vibrazioni residue. In questi casi \u00e8 possibile richiedere di limitare lo smoothing massimo dal input shaper. Consideriamo i seguenti risultati della sintonizzazione automatica: Fitted shaper 'zv' frequency = 57.8 Hz (vibrations = 20.3%, smoothing ~= 0.053) To avoid too much smoothing with 'zv', suggested max_accel <= 13000 mm/sec^2 Fitted shaper 'mzv' frequency = 34.8 Hz (vibrations = 3.6%, smoothing ~= 0.168) To avoid too much smoothing with 'mzv', suggested max_accel <= 3600 mm/sec^2 Fitted shaper 'ei' frequency = 48.8 Hz (vibrations = 4.9%, smoothing ~= 0.135) To avoid too much smoothing with 'ei', suggested max_accel <= 4400 mm/sec^2 Fitted shaper '2hump_ei' frequency = 45.2 Hz (vibrations = 0.1%, smoothing ~= 0.264) To avoid too much smoothing with '2hump_ei', suggested max_accel <= 2200 mm/sec^2 Fitted shaper '3hump_ei' frequency = 48.0 Hz (vibrations = 0.0%, smoothing ~= 0.356) To avoid too much smoothing with '3hump_ei', suggested max_accel <= 1500 mm/sec^2 Recommended shaper is 2hump_ei @ 45.2 Hz Si noti che i valori di smoothing riportati sono alcuni valori proiettati. Questi valori possono essere utilizzati per confrontare diverse configurazioni: maggiore \u00e8 il valore, maggiore sar\u00e0 la levigatura creata da uno shaper. Tuttavia, questi punteggi di smoothing non rappresentano alcuna misura reale dello smoothing, perch\u00e9 lo smoothing effettivo dipende dai parametri max_accel e square_corner_velocity . Pertanto, \u00e8 necessario eseguire alcune stampe di prova per vedere quanta smoothing crea esattamente una configurazione scelta. Nell'esempio sopra i parametri dello shaper suggeriti non sono male, ma cosa succede se si desidera ottenere meno smooting sull'asse X? Puoi provare a limitare lo smoothing massimo dello shaper usando il seguente comando: ~/klipper/scripts/calibrate_shaper.py /tmp/resonances_x_*.csv -o /tmp/shaper_calibrate_x.png --max_smoothing=0.2 che limita lo smoothing a un punteggio di 0.2. Ora puoi ottenere il seguente risultato: Fitted shaper 'zv' frequency = 55.4 Hz (vibrations = 19.7%, smoothing ~= 0.057) To avoid too much smoothing with 'zv', suggested max_accel <= 12000 mm/sec^2 Fitted shaper 'mzv' frequency = 34.6 Hz (vibrations = 3.6%, smoothing ~= 0.170) To avoid too much smoothing with 'mzv', suggested max_accel <= 3500 mm/sec^2 Fitted shaper 'ei' frequency = 48.2 Hz (vibrations = 4.8%, smoothing ~= 0.139) To avoid too much smoothing with 'ei', suggested max_accel <= 4300 mm/sec^2 Fitted shaper '2hump_ei' frequency = 52.0 Hz (vibrations = 2.7%, smoothing ~= 0.200) To avoid too much smoothing with '2hump_ei', suggested max_accel <= 3000 mm/sec^2 Fitted shaper '3hump_ei' frequency = 72.6 Hz (vibrations = 1.4%, smoothing ~= 0.155) To avoid too much smoothing with '3hump_ei', suggested max_accel <= 3900 mm/sec^2 Recommended shaper is 3hump_ei @ 72.6 Hz Se si confronta con i parametri suggeriti in precedenza, le vibrazioni sono un po' maggiori, ma lo smoothing \u00e8 notevolmente inferiore rispetto a prima, consentendo un'accelerazione massima maggiore. Quando si decide quale parametro max_smoothing scegliere, \u00e8 possibile utilizzare un approccio per tentativi. Prova alcuni valori diversi e guarda quali risultati ottieni. Si noti che lo smoothing effettivo prodotto dall'input shaper dipende principalmente dalla frequenza di risonanza pi\u00f9 bassa della stampante: maggiore \u00e8 la frequenza della risonanza pi\u00f9 bassa, minore \u00e8 lo smoothing. Pertanto, se si richiede allo script di trovare una configurazione dell'input shaper con lo smoothing irrealisticamente piccolo, sar\u00e0 a scapito di un aumento del ringing alle frequenze di risonanza pi\u00f9 basse (che sono, in genere, anche pi\u00f9 visibili nelle stampe). Quindi, ricontrolla sempre le vibrazioni rimanenti previste riportate dallo script e assicurati che non siano troppo alte. Nota che se hai scelto un buon valore max_smoothing per entrambi gli assi, puoi salvarlo in printer.cfg come [resonance_tester] accel_chip: ... probe_points: ... max_smoothing: 0.25 # un esempio Quindi, se riesegui l'autotuning dello shaper di input usando il comando Klipper SHAPER_CALIBRATE in futuro, utilizzer\u00e0 il valore max_smoothing memorizzato come riferimento.","title":"Max smoothing"},{"location":"Measuring_Resonances.html#seleziona-max_accel","text":"Poich\u00e9 l'input shaper pu\u00f2 creare un po' di smussamento nelle parti, specialmente ad accelerazioni elevate, sar\u00e0 comunque necessario scegliere il valore max_accel che non crei troppo smussamento \"smoothing\" nelle parti stampate. Uno script di calibrazione fornisce una stima per il parametro max_accel che non dovrebbe creare un smoothing eccessivo. Si noti che il max_accel visualizzato dallo script di calibrazione \u00e8 solo un massimo teorico al quale il rispettivo shaper \u00e8 ancora in grado di lavorare senza produrre troppo smoothing. Non \u00e8 affatto una raccomandazione impostare questa accelerazione per la stampa. L'accelerazione massima che la stampante \u00e8 in grado di sostenere dipende dalle sue propriet\u00e0 meccaniche e dalla coppia massima dei motori passo-passo utilizzati. Pertanto, si suggerisce di impostare max_accel nella sezione [printer] che non superi i valori stimati per gli assi X e Y, probabilmente con un margine di sicurezza conservativo. In alternativa, segui questa parte della guida all'ottimizzazione dello input shaper e stampa il modello di test per scegliere sperimentalmente il parametro max_accel . Lo stesso avviso vale per lo input shaper auto-calibration con il comando SHAPER_CALIBRATE : \u00e8 comunque necessario scegliere il giusto valore di max_accel dopo l'auto-calibrazione, e il i limiti di accelerazione non verranno applicati automaticamente. Se stai eseguendo una ricalibrazione dello shaper e lo smoothing riportato per la configurazione dello shaper suggerita \u00e8 quasi lo stesso di quello ottenuto durante la calibrazione precedente, questo passaggio pu\u00f2 essere saltato.","title":"Seleziona max_accel"},{"location":"Measuring_Resonances.html#test-di-assi-personalizzati","text":"Il comando TEST_RESONANCES supporta assi personalizzati. Anche se questo non \u00e8 molto utile per la calibrazione del input shaper, pu\u00f2 essere utilizzato per studiare in profondit\u00e0 le risonanze della stampante e per controllare, ad esempio, la tensione della cinghia. Per controllare la tensione della cinghia sulle stampanti CoreXY, eseguire TEST_RESONANCES AXIS=1,1 OUTPUT=raw_data TEST_RESONANCES AXIS=1,-1 OUTPUT=raw_data e usa graph_accelerometer.py per elaborare i file generati, ad es. ~/klipper/scripts/graph_accelerometer.py -c /tmp/raw_data_axis*.csv -o /tmp/resonances.png che generer\u00e0 /tmp/resonances.png confrontando le risonanze. Per le stampanti Delta con la posizione della torre predefinita (torre A ~= 210 gradi, B ~= 330 gradi e C ~= 90 gradi), eseguire TEST_RESONANCES AXIS=0,1 OUTPUT=raw_data TEST_RESONANCES AXIS=-0.866025404,-0.5 OUTPUT=raw_data TEST_RESONANCES AXIS=0.866025404,-0.5 OUTPUT=raw_data e quindi utilizzare lo stesso comando ~/klipper/scripts/graph_accelerometer.py -c /tmp/raw_data_axis*.csv -o /tmp/resonances.png per generare /tmp/resonances.png confrontando le risonanze.","title":"Test di assi personalizzati"},{"location":"Measuring_Resonances.html#calibrazione-automatica-input-shaper","text":"Oltre a scegliere manualmente i parametri appropriati per la funzione di input shaper, \u00e8 anche possibile eseguire l'autotuning per l'input shaper direttamente da Klipper. Esegui il seguente comando tramite il terminale Octoprint: SHAPER_CALIBRATE Questo eseguir\u00e0 il test completo per entrambi gli assi e generer\u00e0 l'output csv ( /tmp/calibration_data_*.csv per impostazione predefinita) per la risposta in frequenza e gli input shaper suggeriti. Riceverai anche le frequenze suggerite per ciascun input shaper, nonch\u00e9 quale input shaper \u00e8 consigliato per la tua configurazione, sulla console Octoprint. Per esempio: Calculating the best input shaper parameters for y axis Fitted shaper 'zv' frequency = 39.0 Hz (vibrations = 13.2%, smoothing ~= 0.105) To avoid too much smoothing with 'zv', suggested max_accel <= 5900 mm/sec^2 Fitted shaper 'mzv' frequency = 36.8 Hz (vibrations = 1.7%, smoothing ~= 0.150) To avoid too much smoothing with 'mzv', suggested max_accel <= 4000 mm/sec^2 Fitted shaper 'ei' frequency = 36.6 Hz (vibrations = 2.2%, smoothing ~= 0.240) To avoid too much smoothing with 'ei', suggested max_accel <= 2500 mm/sec^2 Fitted shaper '2hump_ei' frequency = 48.0 Hz (vibrations = 0.0%, smoothing ~= 0.234) To avoid too much smoothing with '2hump_ei', suggested max_accel <= 2500 mm/sec^2 Fitted shaper '3hump_ei' frequency = 59.0 Hz (vibrations = 0.0%, smoothing ~= 0.235) To avoid too much smoothing with '3hump_ei', suggested max_accel <= 2500 mm/sec^2 Recommended shaper_type_y = mzv, shaper_freq_y = 36.8 Hz Se sei d'accordo con i parametri suggeriti, puoi eseguire ora SAVE_CONFIG per salvarli e riavviare Klipper. Nota che questo non aggiorner\u00e0 il valore max_accel nella sezione [printer] . Dovresti aggiornarlo manualmente seguendo le considerazioni nella sezione Selecting max_accel . Se la tua stampante \u00e8 una stampante a piatto mobile, puoi specificare quale asse testare, in modo da poter cambiare il punto di montaggio dell'accelerometro tra i test (per impostazione predefinita, il test viene eseguito per entrambi gli assi): SHAPER_CALIBRATE AXIS=Y \u00c8 possibile eseguire SAVE_CONFIG due volte, dopo aver calibrato ciascun asse. Tuttavia, se hai collegato due accelerometri contemporaneamente, esegui semplicemente SHAPER_CALIBRATE senza specificare un asse per calibrare l' input shaper per entrambi gli assi in una volta sola.","title":"Calibrazione automatica Input Shaper"},{"location":"Measuring_Resonances.html#input-shaper-ricalibrazione","text":"Il comando SHAPER_CALIBRATE pu\u00f2 essere utilizzato anche per ricalibrare lo shaper di input in futuro, specialmente se vengono apportate alcune modifiche alla stampante che possono influire sulla sua cinematica. \u00c8 possibile eseguire nuovamente la calibrazione completa utilizzando il comando SHAPER_CALIBRATE , o limitare l'autocalibrazione a un singolo asse fornendo il parametro AXIS= , come SHAPER_CALIBRATE AXIS=X Attenzione! Non \u00e8 consigliabile eseguire l'autocalibrazione dello shaper molto frequentemente (ad es. prima di ogni stampa o ogni giorno). Per determinare le frequenze di risonanza, l'autocalibrazione crea intense vibrazioni su ciascuno degli assi. Generalmente, le stampanti 3D non sono progettate per resistere a un'esposizione prolungata a vibrazioni vicino alle frequenze di risonanza. Ci\u00f2 potrebbe aumentare l'usura dei componenti della stampante e ridurne la durata. C'\u00e8 anche un aumento del rischio che alcune parti si svitino o si allentino. Verificare sempre che tutte le parti della stampante (comprese quelle che normalmente potrebbero non muoversi) siano fissate saldamente in posizione dopo ogni autotuning. Inoltre, a causa di un po' di rumore nelle misurazioni, \u00e8 possibile che i risultati dell'ottimizzazione siano leggermente diversi da una calibrazione all'altra. Tuttavia, non ci si aspetta che il rumore influisca troppo sulla qualit\u00e0 di stampa. Tuttavia, si consiglia comunque di ricontrollare i parametri suggeriti e di stampare alcune stampe di prova prima di utilizzarli per confermare che siano corretti.","title":"Input Shaper ricalibrazione"},{"location":"Measuring_Resonances.html#elaborazione-offline-dei-dati-dellaccelerometro","text":"\u00c8 possibile generare i dati grezzi dell'accelerometro ed elaborarli offline (ad esempio su una macchina host), ad esempio per trovare risonanze. Per fare ci\u00f2, esegui i seguenti comandi tramite il terminale Octoprint: SET_INPUT_SHAPER SHAPER_FREQ_X=0 SHAPER_FREQ_Y=0 TEST_RESONANCES AXIS=X OUTPUT=raw_data ignorando eventuali errori per il comando SET_INPUT_SHAPER . Per il comando TEST_RESONANCES , specificare l'asse di test desiderato. I dati grezzi verranno scritti nella directory /tmp sull'RPi. I dati grezzi possono anche essere ottenuti eseguendo il comando ACCELEROMETER_MEASURE due volte durante una normale attivit\u00e0 della stampante: prima per avviare le misurazioni, quindi per interromperle e scrivere il file di output. Fare riferimento a G-Codes per maggiori dettagli. I dati possono essere elaborati successivamente dai seguenti script: scripts/graph_accelerometer.py e scripts/calibrate_shaper.py . Entrambi accettano uno o pi\u00f9 file CSV non elaborati come input a seconda della modalit\u00e0. Lo script graph_accelerometer.py supporta diverse modalit\u00e0 operative: tracciando i dati grezzi dell'accelerometro (usa il parametro -r ), \u00e8 supportato solo 1 input; tracciando una risposta in frequenza (non sono richiesti parametri aggiuntivi), se sono specificati pi\u00f9 ingressi, viene calcolata la risposta in frequenza media; confronto della risposta in frequenza tra pi\u00f9 ingressi (usare il parametro -c ); puoi inoltre specificare quale asse dell'accelerometro considerare tramite il parametro -a x , -a y o -a z (se non specificato, viene utilizzata la somma delle vibrazioni per tutti gli assi); tracciando lo spettrogramma (usare il parametro -s ), \u00e8 supportato solo 1 input; \u00e8 inoltre possibile specificare quale asse dell'accelerometro considerare tramite il parametro -a x , -a y o -a z (se non specificato, viene utilizzata la somma delle vibrazioni per tutti gli assi). Si noti che lo script graph_accelerometer.py supporta solo i file raw_data*.csv e non i file resonances*.csv o calibration_data*.csv. Per esempio, ~/klipper/scripts/graph_accelerometer.py /tmp/raw_data_x_*.csv -o /tmp/resonances_x.png -c -a z traccer\u00e0 il confronto di diversi file /tmp/raw_data_x_*.csv per l'asse Z con il file /tmp/resonances_x.png . Lo script shaper_calibrate.py accetta 1 o pi\u00f9 input e pu\u00f2 eseguire l'ottimizzazione automatica dello shaper di input e suggerire i parametri migliori che funzionano bene per tutti gli input forniti. Stampa i parametri suggeriti sulla console e pu\u00f2 inoltre generare il grafico se viene fornito il parametro -o output.png , o il file CSV se viene specificato il parametro -c output.csv . Fornire diversi input allo script shaper_calibrate.py pu\u00f2 essere utile se si esegue un'ottimizzazione avanzata degli shaper di input, ad esempio: Esecuzione di TEST_RESONANCES AXIS=X OUTPUT=raw_data (e asse Y ) per un singolo asse due volte su una stampante con piatto scorrevole con l'accelerometro collegato alla testa di stampa la prima volta e l'accelerometro collegato al piatto la seconda volta in modo da rilevare le risonanze incrociate degli assi e tentare di cancellarle con gli input shaper. Esecuzione di TEST_RESONANCES AXIS=Y OUTPUT=raw_data due volte su un supporto da piatto con un piatto di vetro e una superficie magnetica (che \u00e8 pi\u00f9 leggera) per trovare i parametri dello shaper di input che funzionano bene per qualsiasi configurazione della superficie di stampa. Combinazione dei dati di risonanza da pi\u00f9 punti di test. Combinando i dati di risonanza da 2 assi (ad es. su una stampante con piatto scorrevole per configurare input_shaper dell'asse X dalle risonanze degli assi X e Y per annullare le vibrazioni del piatto nel caso in cui l'ugello \"cattura\" una stampa quando si sposta nella direzione dell'asse X ).","title":"Elaborazione offline dei dati dell'accelerometro"},{"location":"Multi_MCU_Homing.html","text":"Homing e Probing con microcontrollore multiplo \u00b6 Klipper sopporta un meccanismo per homing con un fine corsa collegato a un micro controllore mentre i motori passo-passo sono collegati ad un controllore diverso. Questa modalit\u00e0 \u00e8 definita Homing multi-mcu. Questa funzione \u00e8 usata quando una sonda Z \u00e8 collegata ad un differente controllore rispetto ai motori dell'asse Z. Questa funzione pu\u00f2 essere utile per semplificare il cablaggio, poich\u00e9 potrebbe essere pi\u00f9 conveniente collegare un finecorsa o una sonda a un microcontrollore pi\u00f9 vicino. Tuttavia, l'utilizzo di questa funzione pu\u00f2 comportare un \"overshoot\" dei motori passo-passo durante le operazioni di homing o con sonda. L' 'overshoot' si verifica a causa di possibili ritardi nella trasmissione del messaggio tra il microcontrollore che controlla il finecorsa e i microcontrollori che muovono i motori passo-passo. Il codice Klipper \u00e8 progettato per limitare questo ritardo a non pi\u00f9 di 25 ms. (Quando \u00e8 attivato l'homing multi-mcu, i microcontrollori inviano messaggi di stato periodici e controllano che i messaggi di stato corrispondenti vengano ricevuti entro 25 ms.) Quindi, ad esempio, se si esegue l'homing a 10 mm/s, \u00e8 possibile un superamento fino a 0,250 mm (10 mm/s * .025s == 0,250 mm). \u00c8 necessario prestare attenzione durante la configurazione dell'homing multi-mcu per tenere conto di questo tipo di overshoot. L'uso di velocit\u00e0 di riferimento o di sonda pi\u00f9 lente pu\u00f2 ridurre la sovraelongazione (overshot). La sovraelongazione 'overshot' del motore passo-passo non dovrebbe influire negativamente sulla precisione della procedura di homing e di sonda. Il codice Klipper rilever\u00e0 il superamento e ne terr\u00e0 conto nei suoi calcoli. Tuttavia, \u00e8 importante che il design dell'hardware sia in grado di gestire l'overshoot senza causare danni alla macchina. Se Klipper dovesse rilevare un problema di comunicazione tra i microcontrollori durante l'homing multi-mcu, generer\u00e0 un errore \"Timeout di comunicazione durante l'homing\". Si noti che un asse con pi\u00f9 stepper (ad esempio, stepper_z e stepper_z1 ) deve trovarsi sullo stesso microcontrollore per poter utilizzare l'homing multi-mcu. Ad esempio, se un endstop si trova su un microcontrollore separato da stepper_z allora stepper_z1 deve trovarsi sullo stesso microcontrollore di stepper_z .","title":"Homing e Probing con microcontrollore multiplo"},{"location":"Multi_MCU_Homing.html#homing-e-probing-con-microcontrollore-multiplo","text":"Klipper sopporta un meccanismo per homing con un fine corsa collegato a un micro controllore mentre i motori passo-passo sono collegati ad un controllore diverso. Questa modalit\u00e0 \u00e8 definita Homing multi-mcu. Questa funzione \u00e8 usata quando una sonda Z \u00e8 collegata ad un differente controllore rispetto ai motori dell'asse Z. Questa funzione pu\u00f2 essere utile per semplificare il cablaggio, poich\u00e9 potrebbe essere pi\u00f9 conveniente collegare un finecorsa o una sonda a un microcontrollore pi\u00f9 vicino. Tuttavia, l'utilizzo di questa funzione pu\u00f2 comportare un \"overshoot\" dei motori passo-passo durante le operazioni di homing o con sonda. L' 'overshoot' si verifica a causa di possibili ritardi nella trasmissione del messaggio tra il microcontrollore che controlla il finecorsa e i microcontrollori che muovono i motori passo-passo. Il codice Klipper \u00e8 progettato per limitare questo ritardo a non pi\u00f9 di 25 ms. (Quando \u00e8 attivato l'homing multi-mcu, i microcontrollori inviano messaggi di stato periodici e controllano che i messaggi di stato corrispondenti vengano ricevuti entro 25 ms.) Quindi, ad esempio, se si esegue l'homing a 10 mm/s, \u00e8 possibile un superamento fino a 0,250 mm (10 mm/s * .025s == 0,250 mm). \u00c8 necessario prestare attenzione durante la configurazione dell'homing multi-mcu per tenere conto di questo tipo di overshoot. L'uso di velocit\u00e0 di riferimento o di sonda pi\u00f9 lente pu\u00f2 ridurre la sovraelongazione (overshot). La sovraelongazione 'overshot' del motore passo-passo non dovrebbe influire negativamente sulla precisione della procedura di homing e di sonda. Il codice Klipper rilever\u00e0 il superamento e ne terr\u00e0 conto nei suoi calcoli. Tuttavia, \u00e8 importante che il design dell'hardware sia in grado di gestire l'overshoot senza causare danni alla macchina. Se Klipper dovesse rilevare un problema di comunicazione tra i microcontrollori durante l'homing multi-mcu, generer\u00e0 un errore \"Timeout di comunicazione durante l'homing\". Si noti che un asse con pi\u00f9 stepper (ad esempio, stepper_z e stepper_z1 ) deve trovarsi sullo stesso microcontrollore per poter utilizzare l'homing multi-mcu. Ad esempio, se un endstop si trova su un microcontrollore separato da stepper_z allora stepper_z1 deve trovarsi sullo stesso microcontrollore di stepper_z .","title":"Homing e Probing con microcontrollore multiplo"},{"location":"Navigation.html","text":"Documentazione Klipper Installazione e configurazione Riferimenti di configurazione Livello del piatto Compensazione della risonanza Template dei comandi Documentazione per sviluppatori Documenti specifici del dispositivo","title":"Navigation"},{"location":"Overview.html","text":"Panoramica \u00b6 Benvenuto nella documentazione di Klipper. Se sei nuovo di Klipper, inizia con i documenti features e installation . Informazioni generali \u00b6 Caratteristiche : un elenco di funzionalit\u00e0 di alto livello in Klipper. FAQ : Domande frequenti. Releases : La storia delle versioni di Klipper. Modifiche alla configurazione : recenti modifiche al software che potrebbero richiedere agli utenti di aggiornare il file di configurazione della stampante. Contatto : Informazioni sulla segnalazione di bug e comunicazione generale con gli sviluppatori di Klipper. Installazione e configurazione \u00b6 Installazione : Guida all'installazione di Klipper. Riferimento di configurazione : Descrizione dei parametri di configurazione. Distanza di rotazione : Calcolo del parametro stepper rotation_distance. Controlli di configurazione : verifica le impostazioni di base dei pin nel file di configurazione. Livello del piatto : Informazioni sul \"livellamento del piatto\" in Klipper. Calibrazione Delta : Calibrazione della cinematica delta. Calibrazione sonda : Calibrazione di sonde Z automatiche. BL-Touch : Configurare una sonda Z \"BL-Touch\". Livello manuale : Calibrazione dei finecorsa Z (e simili). Maglia del letto : Correzione dell'altezza del piatto basata sulle posizioni XY. Endstop phase : Posizionamento finecorsa Z assistito da stepper. Compensazione della risonanza : Uno strumento per ridurre le risonanze nelle stampe. Misurare le risonanze : Informazioni sull'uso dell'hardware dell'accelerometro adxl345 per misurare le risonanze. Avanzamento pressione : Calibra la pressione dell'estrusore. Codici G : Informazioni sui comandi supportati da Klipper. Modelli di comando : Macro G-Code e valutazione condizionale. Riferimento stato : informazioni disponibili per le macro (e simili). Driver TMC : Uso dei driver Trinamic per motori passo-passo con Klipper. Multi-MCU Homing : Homing e probing utilizzando pi\u00f9 microcontrollori. Slicers : Configurare il software \"slicer\" per Klipper. Correzione dell'inclinazione : Regolazioni per assi non perfettamente squadrati. Strumenti PWM : Guida su come usare gli strumenti controllati da PWM come i laser o i mandrini. Exclude Object : La guida all'implementazione di Exclude Objects. Documentazione per sviluppatori \u00b6 Panoramica del codice : Gli sviluppatori dovrebbero leggere prima questo. Cinematica : Dettagli tecnici su come Klipper implementa il movimento. Protocollo : Informazioni sul protocollo di messaggistica di basso livello tra host e microcontrollore. Server API : Informazioni sulle API di comando e controllo di Klipper. Comandi MCU : Una descrizione dei comandi di basso livello implementati nel software del microcontrollore. Protocollo bus CAN : formato del messaggio Klipper CAN bus. Debug : Informazioni su come testare e fare il debug di Klipper. Benchmarks : Informazioni sul metodo di benchmark Klipper. Contribuire : Informazioni su come presentare miglioramenti a Klipper. Packaging : informazioni sulla creazione di pacchetti del sistema operativo. Documenti specifici del dispositivo \u00b6 Configurazioni di esempio : Informazioni su come aggiungere un file di configurazione di esempio a Klipper. Aggiornamenti SDCard : esegui il flashing di un microcontrollore copiando un file binario su una scheda SD nel microcontrollore. Raspberry Pi come microcontrollore : Dettagli per controllare i dispositivi collegati ai pin GPIO di un Raspberry Pi. Beaglebone : Dettagli per l'esecuzione di Klipper sulla PRU Beaglebone. Bootloaders : Informazioni per gli sviluppatori sul flashing del microcontrollore. CAN bus : Informazioni sull'uso del CAN bus con Klipper. Sensore larghezza filamento TSL1401CL Sensore di larghezza del filamento Hall","title":"Panoramica"},{"location":"Overview.html#panoramica","text":"Benvenuto nella documentazione di Klipper. Se sei nuovo di Klipper, inizia con i documenti features e installation .","title":"Panoramica"},{"location":"Overview.html#informazioni-generali","text":"Caratteristiche : un elenco di funzionalit\u00e0 di alto livello in Klipper. FAQ : Domande frequenti. Releases : La storia delle versioni di Klipper. Modifiche alla configurazione : recenti modifiche al software che potrebbero richiedere agli utenti di aggiornare il file di configurazione della stampante. Contatto : Informazioni sulla segnalazione di bug e comunicazione generale con gli sviluppatori di Klipper.","title":"Informazioni generali"},{"location":"Overview.html#installazione-e-configurazione","text":"Installazione : Guida all'installazione di Klipper. Riferimento di configurazione : Descrizione dei parametri di configurazione. Distanza di rotazione : Calcolo del parametro stepper rotation_distance. Controlli di configurazione : verifica le impostazioni di base dei pin nel file di configurazione. Livello del piatto : Informazioni sul \"livellamento del piatto\" in Klipper. Calibrazione Delta : Calibrazione della cinematica delta. Calibrazione sonda : Calibrazione di sonde Z automatiche. BL-Touch : Configurare una sonda Z \"BL-Touch\". Livello manuale : Calibrazione dei finecorsa Z (e simili). Maglia del letto : Correzione dell'altezza del piatto basata sulle posizioni XY. Endstop phase : Posizionamento finecorsa Z assistito da stepper. Compensazione della risonanza : Uno strumento per ridurre le risonanze nelle stampe. Misurare le risonanze : Informazioni sull'uso dell'hardware dell'accelerometro adxl345 per misurare le risonanze. Avanzamento pressione : Calibra la pressione dell'estrusore. Codici G : Informazioni sui comandi supportati da Klipper. Modelli di comando : Macro G-Code e valutazione condizionale. Riferimento stato : informazioni disponibili per le macro (e simili). Driver TMC : Uso dei driver Trinamic per motori passo-passo con Klipper. Multi-MCU Homing : Homing e probing utilizzando pi\u00f9 microcontrollori. Slicers : Configurare il software \"slicer\" per Klipper. Correzione dell'inclinazione : Regolazioni per assi non perfettamente squadrati. Strumenti PWM : Guida su come usare gli strumenti controllati da PWM come i laser o i mandrini. Exclude Object : La guida all'implementazione di Exclude Objects.","title":"Installazione e configurazione"},{"location":"Overview.html#documentazione-per-sviluppatori","text":"Panoramica del codice : Gli sviluppatori dovrebbero leggere prima questo. Cinematica : Dettagli tecnici su come Klipper implementa il movimento. Protocollo : Informazioni sul protocollo di messaggistica di basso livello tra host e microcontrollore. Server API : Informazioni sulle API di comando e controllo di Klipper. Comandi MCU : Una descrizione dei comandi di basso livello implementati nel software del microcontrollore. Protocollo bus CAN : formato del messaggio Klipper CAN bus. Debug : Informazioni su come testare e fare il debug di Klipper. Benchmarks : Informazioni sul metodo di benchmark Klipper. Contribuire : Informazioni su come presentare miglioramenti a Klipper. Packaging : informazioni sulla creazione di pacchetti del sistema operativo.","title":"Documentazione per sviluppatori"},{"location":"Overview.html#documenti-specifici-del-dispositivo","text":"Configurazioni di esempio : Informazioni su come aggiungere un file di configurazione di esempio a Klipper. Aggiornamenti SDCard : esegui il flashing di un microcontrollore copiando un file binario su una scheda SD nel microcontrollore. Raspberry Pi come microcontrollore : Dettagli per controllare i dispositivi collegati ai pin GPIO di un Raspberry Pi. Beaglebone : Dettagli per l'esecuzione di Klipper sulla PRU Beaglebone. Bootloaders : Informazioni per gli sviluppatori sul flashing del microcontrollore. CAN bus : Informazioni sull'uso del CAN bus con Klipper. Sensore larghezza filamento TSL1401CL Sensore di larghezza del filamento Hall","title":"Documenti specifici del dispositivo"},{"location":"Packaging.html","text":"Klipper packaging \u00b6 Klipper \u00e8 in qualche modo un'anomalia tra i programmi Python per quanto riguarda impacchettamento, in quanto non usa setuptools per costruire e installare. Alcune note riguardanti il modo migliore per impacchettarlo sono le seguenti: Moduli C \u00b6 Klipper utilizza un modulo C per gestire pi\u00f9 rapidamente alcuni calcoli cinematici. Questo modulo deve essere compilato al momento per evitare di introdurre una dipendenza di runtime da un compilatore. Per compilare il modulo C, esegui python2 klippy/chelper/__init__.py . Compilazione di codice python \u00b6 Molte distribuzioni hanno una politica di compilazione di tutto il codice Python prima del packaging per migliorare i tempi di avvio. Puoi farlo eseguendo python2 -m compileall klippy . Versione \u00b6 Se stai compilando un pacchetto di Klipper da git, \u00e8 normale non spedire una directory .git, quindi il controllo delle versioni deve essere gestito senza git. Per fare ci\u00f2, usa lo script fornito in scripts/make_version.py che dovrebbe essere eseguito come segue: python2 scripts/make_version.py YOURDISTRONAME > klippy/.version . Esempio di script di packaging \u00b6 klipper-git \u00e8 un pacchetto per Arch Linux e ha un PKGBUILD (script di compilazione del pacchetto) disponibile su Arch User Repositiory .","title":"Klipper packaging"},{"location":"Packaging.html#klipper-packaging","text":"Klipper \u00e8 in qualche modo un'anomalia tra i programmi Python per quanto riguarda impacchettamento, in quanto non usa setuptools per costruire e installare. Alcune note riguardanti il modo migliore per impacchettarlo sono le seguenti:","title":"Klipper packaging"},{"location":"Packaging.html#moduli-c","text":"Klipper utilizza un modulo C per gestire pi\u00f9 rapidamente alcuni calcoli cinematici. Questo modulo deve essere compilato al momento per evitare di introdurre una dipendenza di runtime da un compilatore. Per compilare il modulo C, esegui python2 klippy/chelper/__init__.py .","title":"Moduli C"},{"location":"Packaging.html#compilazione-di-codice-python","text":"Molte distribuzioni hanno una politica di compilazione di tutto il codice Python prima del packaging per migliorare i tempi di avvio. Puoi farlo eseguendo python2 -m compileall klippy .","title":"Compilazione di codice python"},{"location":"Packaging.html#versione","text":"Se stai compilando un pacchetto di Klipper da git, \u00e8 normale non spedire una directory .git, quindi il controllo delle versioni deve essere gestito senza git. Per fare ci\u00f2, usa lo script fornito in scripts/make_version.py che dovrebbe essere eseguito come segue: python2 scripts/make_version.py YOURDISTRONAME > klippy/.version .","title":"Versione"},{"location":"Packaging.html#esempio-di-script-di-packaging","text":"klipper-git \u00e8 un pacchetto per Arch Linux e ha un PKGBUILD (script di compilazione del pacchetto) disponibile su Arch User Repositiory .","title":"Esempio di script di packaging"},{"location":"Pressure_Advance.html","text":"Anticipo di pressione \u00b6 Questo documento fornisce informazioni sulla messa a punto della variabile di regolazione del \"pressure advance\" per un particolare ugello e filamento. La funzione di anticipo della pressione pu\u00f2 essere utile per ridurre le colature. Per maggiori informazioni su come viene implementato l'anticipo di pressione, vedere il documento kinematics . Regolazione della pressure advance \u00b6 Pressure advance fa due cose utili: riduce le colature durante i movimenti senza estrusione e riduce il blobbing durante le curve. Questa guida utilizza la seconda funzione (riduzione del blobbing durante le curve) come meccanismo per la messa a punto. Per calibrare la pressure advance, la stampante deve essere configurata e operativa poich\u00e9 il test di ottimizzazione prevede la stampa e l'ispezione di un oggetto di prova. \u00c8 una buona idea leggere questo documento per intero prima di eseguire il test. Usa uno slicer per generare il codice G per il grande cubo vuoto che si trova in docs/prints/square_tower.stl . Utilizzare una velocit\u00e0 elevata (ad es. 100 mm/s), riempimento zero e un'altezza dello strato grossolana (l'altezza dello strato dovrebbe essere circa il 75% del diametro dell'ugello). Assicurati che qualsiasi \"controllo dinamico dell'accelerazione\" sia disabilitato nello slicer. Prepararsi per il test emettendo il seguente comando G-Code: SET_VELOCITY_LIMIT SQUARE_CORNER_VELOCITY=1 ACCEL=500 Questo comando fa viaggiare l'ugello pi\u00f9 lentamente attraverso gli angoli per enfatizzare gli effetti della pressione dell'estrusore. Quindi per le stampanti con un estrusore a trasmissione diretta eseguire il comando: TUNING_TOWER COMMAND=SET_PRESSURE_ADVANCE PARAMETER=ADVANCE START=0 FACTOR=.005 Per estrusori bowden lunghi utilizzare: TUNING_TOWER COMMAND=SET_PRESSURE_ADVANCE PARAMETER=ADVANCE START=0 FACTOR=.020 Quindi stampare l'oggetto. Una volta stampata completamente, la stampa di prova avr\u00e0 il seguente aspetto: Il comando TUNING_TOWER sopra indica a Klipper di modificare l'impostazione pressure_advance su ogni strato della stampa. Gli strati pi\u00f9 alti nella stampa avranno un valore di anticipo della pressione maggiore impostato. Gli strati al di sotto dell'impostazione pressione_anticipo ideale avranno macchie agli angoli e gli strati al di sopra dell'impostazione ideale possono portare a angoli arrotondati e una scarsa estrusione all'angolo. \u00c8 possibile annullare la stampa in anticipo se si osserva che gli angoli non vengono pi\u00f9 stampati bene (e quindi si pu\u00f2 evitare di stampare livelli noti per essere al di sopra del valore di pressione_avanzamento ideale). Ispeziona la stampa e quindi utilizza un calibro digitale per trovare l'altezza con gli angoli della migliore qualit\u00e0. In caso di dubbio, preferire un'altezza inferiore. Il valore pressure_advance pu\u00f2 quindi essere calcolato come pressure_advance = <inizio> + <altezza_misurata> * <fattore> . (Ad esempio, 0 + 12.90 * .020 sarebbe .258 .) \u00c8 possibile scegliere impostazioni personalizzate per START e FACTOR se ci\u00f2 aiuta a identificare la migliore impostazione di anticipo della pressione. Quando si esegue questa operazione, assicurarsi di emettere il comando TUNING_TOWER all'inizio di ogni stampa di prova. I valori tipici di pressure advance sono compresi tra 0,050 e 1,000 (la fascia alta di solito solo con estrusori bowden). Se non vi \u00e8 alcun miglioramento significativo con un pressure advance fino a 1.000, \u00e8 improbabile che la pressure advance migliori la qualit\u00e0 delle stampe. Ritorno ad una configurazione di default con pressure advance disabilitato. Sebbene questo esercizio di messa a punto migliori direttamente la qualit\u00e0 degli angoli, vale la pena ricordare che una buona configurazione del pressure advance riduce anche gli ooze durante la stampa. Al termine di questo test, impostare pressure_advance = <calculated_value> nella sezione [extruder] del file di configurazione ed emettere un comando RESTART. Il comando RESTART canceller\u00e0 lo stato di test e riporter\u00e0 le velocit\u00e0 di accelerazione e in curva ai valori normali. Note importanti \u00b6 Il valore di pressure advance dipende dall'estrusore, dall'ugello e dal filamento. \u00c8 comune che filamenti di produttori diversi o con pigmenti diversi richiedano valori di pressure advance significativamente diversi. Pertanto, si dovrebbe calibrare pressure advance su ciascuna stampante e con ogni bobina di filamento. La temperatura di stampa e le velocit\u00e0 di estrusione possono influire sulla pressure advance. Assicurati di regolare extruder rotation_distance e nozzle temperature prima di regolare l'avanzamento della pressione. La stampa di prova \u00e8 progettata per funzionare con un'elevata portata dell'estrusore, ma per il resto con impostazioni dello slicer \"normali\". Un'elevata portata si ottiene utilizzando un'elevata velocit\u00e0 di stampa (ad es. 100 mm/s) e un'altezza dello strato grossolano (tipicamente circa il 75% del diametro dell'ugello). Altre impostazioni dello slicer dovrebbero essere simili alle loro impostazioni predefinite (ad esempio, perimetri di 2 o 3 linee, quantit\u00e0 di retrazione normale). Pu\u00f2 essere utile impostare la velocit\u00e0 del perimetro esterno in modo che sia la stessa velocit\u00e0 del resto della stampa, ma non \u00e8 un requisito. \u00c8 comune che la stampa di prova mostri un comportamento diverso su ciascun angolo. Spesso lo slicer provveder\u00e0 a cambiare i livelli in un angolo, il che pu\u00f2 comportare che quell'angolo sia significativamente diverso dai restanti tre angoli. Se ci\u00f2 si verifica, ignora quell'angolo e regola pressure advance utilizzando gli altri tre angoli. \u00c8 anche comune che gli angoli rimanenti varino leggermente. (Ci\u00f2 pu\u00f2 verificarsi a causa di piccole differenze nel modo in cui il telaio della stampante reagisce alle curve in determinate direzioni.) Prova a scegliere un valore che funzioni bene per tutti gli angoli rimanenti. In caso di dubbio, preferire un valore di pressure advance inferiore. Se viene utilizzato un valore di pressure advance (ad esempio, superiore a 0.200), \u00e8 possibile che l'estrusore salti quando torna alla normale accelerazione della stampante. Il sistema di pressure advance tiene conto della pressione spingendo il filamento extra durante l'accelerazione e ritraendo quel filamento durante la decelerazione. Con un'elevata accelerazione e un'elevata pressione di anticipo, l'estrusore potrebbe non avere una coppia sufficiente per spingere il filamento richiesto. In tal caso, utilizzare un valore di accelerazione inferiore o disattivare la pressure advance. Una volta che pressure advance \u00e8 stato regolato in Klipper, pu\u00f2 essere comunque utile configurare un piccolo valore di retrazione nello slicer (ad es. 0,75 mm) e utilizzare l'opzione \"pulizia in retrazione\" dello slicer, se disponibile. Queste impostazioni dello slicer possono aiutare a contrastare la trasudazione causata dalla coesione del filamento ( estratto dall'ugello a causa della viscosit\u00e0 della plastica). Si consiglia di disabilitare l'opzione \"Z-lift in retrazione\" dello slicer. Il sistema di pressure advance non modifica i tempi o il percorso della testa di stampa. Una stampa con pressure advance abilitato richieder\u00e0 lo stesso tempo di una stampa senza pressure advance. Inoltre, pressure advance non modifica la quantit\u00e0 totale di filamento estruso durante una stampa. L a pressure advance determina un movimento extra dell'estrusore durante l'accelerazione e la decelerazione del movimento. Un'impostazione di pressure advance molto elevata risulter\u00e0 in una quantit\u00e0 molto grande di movimento dell'estrusore durante l'accelerazione e la decelerazione e nessuna impostazione di configurazione pone un limite alla quantit\u00e0 di tale movimento.","title":"Anticipo di pressione"},{"location":"Pressure_Advance.html#anticipo-di-pressione","text":"Questo documento fornisce informazioni sulla messa a punto della variabile di regolazione del \"pressure advance\" per un particolare ugello e filamento. La funzione di anticipo della pressione pu\u00f2 essere utile per ridurre le colature. Per maggiori informazioni su come viene implementato l'anticipo di pressione, vedere il documento kinematics .","title":"Anticipo di pressione"},{"location":"Pressure_Advance.html#regolazione-della-pressure-advance","text":"Pressure advance fa due cose utili: riduce le colature durante i movimenti senza estrusione e riduce il blobbing durante le curve. Questa guida utilizza la seconda funzione (riduzione del blobbing durante le curve) come meccanismo per la messa a punto. Per calibrare la pressure advance, la stampante deve essere configurata e operativa poich\u00e9 il test di ottimizzazione prevede la stampa e l'ispezione di un oggetto di prova. \u00c8 una buona idea leggere questo documento per intero prima di eseguire il test. Usa uno slicer per generare il codice G per il grande cubo vuoto che si trova in docs/prints/square_tower.stl . Utilizzare una velocit\u00e0 elevata (ad es. 100 mm/s), riempimento zero e un'altezza dello strato grossolana (l'altezza dello strato dovrebbe essere circa il 75% del diametro dell'ugello). Assicurati che qualsiasi \"controllo dinamico dell'accelerazione\" sia disabilitato nello slicer. Prepararsi per il test emettendo il seguente comando G-Code: SET_VELOCITY_LIMIT SQUARE_CORNER_VELOCITY=1 ACCEL=500 Questo comando fa viaggiare l'ugello pi\u00f9 lentamente attraverso gli angoli per enfatizzare gli effetti della pressione dell'estrusore. Quindi per le stampanti con un estrusore a trasmissione diretta eseguire il comando: TUNING_TOWER COMMAND=SET_PRESSURE_ADVANCE PARAMETER=ADVANCE START=0 FACTOR=.005 Per estrusori bowden lunghi utilizzare: TUNING_TOWER COMMAND=SET_PRESSURE_ADVANCE PARAMETER=ADVANCE START=0 FACTOR=.020 Quindi stampare l'oggetto. Una volta stampata completamente, la stampa di prova avr\u00e0 il seguente aspetto: Il comando TUNING_TOWER sopra indica a Klipper di modificare l'impostazione pressure_advance su ogni strato della stampa. Gli strati pi\u00f9 alti nella stampa avranno un valore di anticipo della pressione maggiore impostato. Gli strati al di sotto dell'impostazione pressione_anticipo ideale avranno macchie agli angoli e gli strati al di sopra dell'impostazione ideale possono portare a angoli arrotondati e una scarsa estrusione all'angolo. \u00c8 possibile annullare la stampa in anticipo se si osserva che gli angoli non vengono pi\u00f9 stampati bene (e quindi si pu\u00f2 evitare di stampare livelli noti per essere al di sopra del valore di pressione_avanzamento ideale). Ispeziona la stampa e quindi utilizza un calibro digitale per trovare l'altezza con gli angoli della migliore qualit\u00e0. In caso di dubbio, preferire un'altezza inferiore. Il valore pressure_advance pu\u00f2 quindi essere calcolato come pressure_advance = <inizio> + <altezza_misurata> * <fattore> . (Ad esempio, 0 + 12.90 * .020 sarebbe .258 .) \u00c8 possibile scegliere impostazioni personalizzate per START e FACTOR se ci\u00f2 aiuta a identificare la migliore impostazione di anticipo della pressione. Quando si esegue questa operazione, assicurarsi di emettere il comando TUNING_TOWER all'inizio di ogni stampa di prova. I valori tipici di pressure advance sono compresi tra 0,050 e 1,000 (la fascia alta di solito solo con estrusori bowden). Se non vi \u00e8 alcun miglioramento significativo con un pressure advance fino a 1.000, \u00e8 improbabile che la pressure advance migliori la qualit\u00e0 delle stampe. Ritorno ad una configurazione di default con pressure advance disabilitato. Sebbene questo esercizio di messa a punto migliori direttamente la qualit\u00e0 degli angoli, vale la pena ricordare che una buona configurazione del pressure advance riduce anche gli ooze durante la stampa. Al termine di questo test, impostare pressure_advance = <calculated_value> nella sezione [extruder] del file di configurazione ed emettere un comando RESTART. Il comando RESTART canceller\u00e0 lo stato di test e riporter\u00e0 le velocit\u00e0 di accelerazione e in curva ai valori normali.","title":"Regolazione della pressure advance"},{"location":"Pressure_Advance.html#note-importanti","text":"Il valore di pressure advance dipende dall'estrusore, dall'ugello e dal filamento. \u00c8 comune che filamenti di produttori diversi o con pigmenti diversi richiedano valori di pressure advance significativamente diversi. Pertanto, si dovrebbe calibrare pressure advance su ciascuna stampante e con ogni bobina di filamento. La temperatura di stampa e le velocit\u00e0 di estrusione possono influire sulla pressure advance. Assicurati di regolare extruder rotation_distance e nozzle temperature prima di regolare l'avanzamento della pressione. La stampa di prova \u00e8 progettata per funzionare con un'elevata portata dell'estrusore, ma per il resto con impostazioni dello slicer \"normali\". Un'elevata portata si ottiene utilizzando un'elevata velocit\u00e0 di stampa (ad es. 100 mm/s) e un'altezza dello strato grossolano (tipicamente circa il 75% del diametro dell'ugello). Altre impostazioni dello slicer dovrebbero essere simili alle loro impostazioni predefinite (ad esempio, perimetri di 2 o 3 linee, quantit\u00e0 di retrazione normale). Pu\u00f2 essere utile impostare la velocit\u00e0 del perimetro esterno in modo che sia la stessa velocit\u00e0 del resto della stampa, ma non \u00e8 un requisito. \u00c8 comune che la stampa di prova mostri un comportamento diverso su ciascun angolo. Spesso lo slicer provveder\u00e0 a cambiare i livelli in un angolo, il che pu\u00f2 comportare che quell'angolo sia significativamente diverso dai restanti tre angoli. Se ci\u00f2 si verifica, ignora quell'angolo e regola pressure advance utilizzando gli altri tre angoli. \u00c8 anche comune che gli angoli rimanenti varino leggermente. (Ci\u00f2 pu\u00f2 verificarsi a causa di piccole differenze nel modo in cui il telaio della stampante reagisce alle curve in determinate direzioni.) Prova a scegliere un valore che funzioni bene per tutti gli angoli rimanenti. In caso di dubbio, preferire un valore di pressure advance inferiore. Se viene utilizzato un valore di pressure advance (ad esempio, superiore a 0.200), \u00e8 possibile che l'estrusore salti quando torna alla normale accelerazione della stampante. Il sistema di pressure advance tiene conto della pressione spingendo il filamento extra durante l'accelerazione e ritraendo quel filamento durante la decelerazione. Con un'elevata accelerazione e un'elevata pressione di anticipo, l'estrusore potrebbe non avere una coppia sufficiente per spingere il filamento richiesto. In tal caso, utilizzare un valore di accelerazione inferiore o disattivare la pressure advance. Una volta che pressure advance \u00e8 stato regolato in Klipper, pu\u00f2 essere comunque utile configurare un piccolo valore di retrazione nello slicer (ad es. 0,75 mm) e utilizzare l'opzione \"pulizia in retrazione\" dello slicer, se disponibile. Queste impostazioni dello slicer possono aiutare a contrastare la trasudazione causata dalla coesione del filamento ( estratto dall'ugello a causa della viscosit\u00e0 della plastica). Si consiglia di disabilitare l'opzione \"Z-lift in retrazione\" dello slicer. Il sistema di pressure advance non modifica i tempi o il percorso della testa di stampa. Una stampa con pressure advance abilitato richieder\u00e0 lo stesso tempo di una stampa senza pressure advance. Inoltre, pressure advance non modifica la quantit\u00e0 totale di filamento estruso durante una stampa. L a pressure advance determina un movimento extra dell'estrusore durante l'accelerazione e la decelerazione del movimento. Un'impostazione di pressure advance molto elevata risulter\u00e0 in una quantit\u00e0 molto grande di movimento dell'estrusore durante l'accelerazione e la decelerazione e nessuna impostazione di configurazione pone un limite alla quantit\u00e0 di tale movimento.","title":"Note importanti"},{"location":"Probe_Calibrate.html","text":"Calibrazione sonda \u00b6 Questo documento descrive il metodo per calibrare gli offset X, Y e Z di una \"sonda z automatica\" in Klipper. Questo \u00e8 utile per gli utenti che hanno una sezione [probe] o [bltouch] nel loro file di configurazione. Calibrazione degli offset X e Y della sonda \u00b6 Per calibrare l'offset X e Y, vai alla scheda \"Controllo\" di OctoPrint, avvia la stampante, quindi usa i pulsanti di spostamento di OctoPrint per spostare la testa in una posizione vicino al centro del piatto. Metti un pezzo di nastro adesivo blu (o simile) sul piatto sotto la sonda. Passare alla scheda \"Terminale\" di OctoPrint ed emettere un comando PROBE: PROBE Metti un segno sul nastro direttamente sotto il punto in cui si trova la sonda (o usa un metodo simile per annotare la posizione sul letto). Emettere un comando GET_POSITION e registrare la posizione XY della testa riportata da quel comando. Ad esempio se si vede: Recv: // toolhead: X:46.500000 Y:27.000000 Z:15.000000 E:0.000000 quindi si registrerebbe una posizione X della sonda di 46,5 e una posizione Y della sonda di 27. Dopo aver registrato la posizione della sonda, emettere una serie di comandi G1 fino a quando l'ugello si trova direttamente sopra il segno sul letto. Ad esempio, si potrebbe emettere: G1 F300 X57 Y30 Z15 per spostare l'ugello in una posizione X di 57 e Y di 30. Una volta trovata la posizione direttamente sopra il segno, utilizzare il comando GET_POSITION per segnalare quella posizione. Questa \u00e8 la posizione dell'ugello. L'offset_x \u00e8 quindi posizione_x_ugello - posizione_x_sonda e l'offset_y \u00e8 analogamente a posizione_y_ugello - posizione_y_sonda . Aggiorna il file printer.cfg con i valori indicati, rimuovi il nastro con i riferimento dal piatto, quindi esegui un comando RESTART in modo che i nuovi valori diventino effettivi. Calibrazione Z offset sonda \u00b6 Inserire una z_offset accurata per la sonda \u00e8 fondamentale per ottenere stampe di alta qualit\u00e0. Lo z_offset \u00e8 la distanza tra l'ugello e il letto quando la sonda si attiva. Lo strumento Klipper PROBE_CALIBRATE pu\u00f2 essere utilizzato per ottenere questo valore: eseguir\u00e0 una sonda automatica per misurare la posizione di trigger Z della sonda e quindi avvier\u00e0 una sonda manuale per ottenere l'altezza Z dell'ugello. La sonda z_offset verr\u00e0 quindi calcolata da queste misurazioni. Inizia spostando testa in una posizione vicino al centro del piatto. Passare alla scheda del terminale OctoPrint ed eseguire il comando PROBE_CALIBRATE per avviare lo strumento. Questo strumento eseguir\u00e0 una misura automatica con la sonda, quindi sollever\u00e0 la testina, sposter\u00e0 l'ugello sulla posizione del punto sonda e avvier\u00e0 lo strumento sonda manuale. Se l'ugello non si sposta in una posizione al di sopra del punto della sonda automatica, allora ANNULLA lo strumento sonda manuale ed eseguire la calibrazione dell'offset della sonda XY descritta sopra. Una volta avviata manualmente la sonda, seguire i passaggi descritti in \"the paper test\" per determinare la distanza effettiva tra l'ugello e il letto in una determinata posizione. Una volta completati questi passaggi, \u00e8 possibile ACCEPT la posizione e salvare i risultati nel file di configurazione con: SAVE_CONFIG Si noti che se viene apportata una modifica al sistema di movimento della stampante, alla posizione dell'hotend o alla posizione della sonda, i risultati di PROBE_CALIBRATE verranno invalidati. Se la sonda ha un offset X o Y e l'inclinazione del letto viene modificata (ad es. regolando le viti del letto, eseguendo DELTA_CALIBRATE, eseguendo Z_TILT_ADJUST, eseguendo QUAD_GANTRY_LEVEL o simili), i risultati di PROBE_CALIBRATE verranno invalidati. Dopo aver apportato una qualsiasi delle modifiche di cui sopra, sar\u00e0 necessario eseguire nuovamente PROBE_CALIBRATE. Se i risultati di PROBE_CALIBRATE vengono invalidati, anche tutti i risultati precedenti di bed mesh ottenuti utilizzando la sonda vengono invalidati: sar\u00e0 necessario eseguire nuovamente BED_MESH_CALIBRATE dopo aver ricalibrato la sonda. Verifica di ripetibilit\u00e0 \u00b6 Dopo aver calibrato gli offset X, Y e Z della sonda, \u00e8 una buona idea verificare che la sonda fornisca risultati ripetibili. Inizia portando a home la stampante e quindi sposta la testa in una posizione vicino al centro del letto. Passare al terminale di OctoPrint ed eseguire il comando PROBE_ACCURACY . Questo comando eseguir\u00e0 il test con la sonda dieci volte e produrr\u00e0 un output simile al seguente: Recv: // probe accuracy: at X:0.000 Y:0.000 Z:10.000 Recv: // and read 10 times with speed of 5 mm/s Recv: // probe at -0.003,0.005 is z=2.506948 Recv: // probe at -0.003,0.005 is z=2.519448 Recv: // probe at -0.003,0.005 is z=2.519448 Recv: // probe at -0.003,0.005 is z=2.506948 Recv: // probe at -0.003,0.005 is z=2.519448 Recv: // probe at -0.003,0.005 is z=2.519448 Recv: // probe at -0.003,0.005 is z=2.506948 Recv: // probe at -0.003,0.005 is z=2.506948 Recv: // probe at -0.003,0.005 is z=2.519448 Recv: // probe at -0.003,0.005 is z=2.506948 Recv: // probe accuracy results: maximum 2.519448, minimum 2.506948, range 0.012500, average 2.513198, median 2.513198, standard deviation 0.006250 Idealmente lo strumento riporter\u00e0 un valore massimo e minimo identico. (Ovvero, idealmente la sonda ottiene un risultato identico su tutte e dieci le prove.) Tuttavia, \u00e8 normale che i valori minimo e massimo differiscano di una \"distanza di passo\" Z o fino a 5 micron (0,005 mm). Una \"distanza passo\" \u00e8 rotation_distance/(full_steps_per_rotation*microsteps) . La distanza tra il valore minimo e quello massimo \u00e8 chiamata intervallo. Quindi, nell'esempio precedente, poich\u00e9 la stampante utilizza una distanza di passo Z di 0,0125, un intervallo di 0,012500 sarebbe considerato normale. Se i risultati del test mostrano un valore di intervallo maggiore di 25 micron (0,025 mm), la sonda non ha una precisione sufficiente per le procedure tipiche di livellamento del piatto. Potrebbe essere possibile regolare la velocit\u00e0 della sonda e/o l'altezza di inizio della sonda per migliorare la ripetibilit\u00e0 della sonda. Il comando PROBE_ACCURACY consente di eseguire test con parametri diversi per vederne l'impatto - vedere il documento G-Codes per ulteriori dettagli. Se la sonda generalmente ottiene risultati ripetibili ma presenta un valore anomalo occasionale, potrebbe essere possibile tenerne conto utilizzando pi\u00f9 campioni su ciascuna sonda - leggere la descrizione dei parametri di configurazione dei campioni della sonda in riferimento di configurazione per maggiori dettagli. Se sono necessarie una nuova velocit\u00e0 della sonda, diversa quantit\u00e0 di campioni o altre impostazioni, aggiornare il file printer.cfg ed eseguire un comando RESTART . In tal caso, \u00e8 una buona idea anche calibrare z_offset di nuovo. Se non \u00e8 possibile ottenere risultati ripetibili, non utilizzare la sonda per livellare il letto. Klipper ha diversi strumenti manuali che possono essere utilizzati in alternativa: vedere il Bed Level document per ulteriori dettagli. Verifica scostamenti di posizione \u00b6 Alcune sonde possono avere una distorsione sistematica che altera i risultati della sonda in determinate posizioni della testa. Ad esempio, se il supporto della sonda si inclina leggermente durante lo spostamento lungo l'asse Y, la sonda potrebbe riportare risultati distorti in differenti posizioni Y. Questo \u00e8 un problema comune con le sonde sulle stampanti delta, tuttavia pu\u00f2 verificarsi su tutte le stampanti. Si pu\u00f2 verificare una distorsione di posizione utilizzando il comando PROBE_CALIBRATE per misurare l'offset z della sonda in varie posizioni X e Y. Idealmente, il probe z_offset sarebbe un valore costante in ogni posizione della stampante. Per le stampanti delta, prova a misurare z_offset in una posizione vicino alla torre A, in una posizione vicino alla torre B e in una posizione vicino alla torre C. Per stampanti cartesiane, corexy e simili, prova a misurare z_offset in posizioni vicino ai quattro angoli del letto. Prima di iniziare questo test, calibrare prima gli offset della sonda X, Y e Z come descritto all'inizio di questo documento. Quindi porta a home la stampante e vai alla prima posizione XY. Seguire i passaggi in calibrazione dell'offset Z della sonda per eseguire il comando PROBE_CALIBRATE , i comandi TESTZ e il comando ACCETTA , ma non eseguire SAVE_CONFIG . Nota lo z_offset segnalato trovato. Quindi passare alle altre posizioni XY, ripetere questi passaggi PROBE_CALIBRATE e annotare lo z_offset riportato. Se la differenza tra l'offset z minimo riportato e l'offset z massimo riportato \u00e8 maggiore di 25 micron (0,025 mm), la sonda non \u00e8 adatta per le tipiche procedure di livellamento del letto. Consultare il Bed Level document per sonde alternative manuali. Scostamenti per temperatura \u00b6 Molte sonde hanno una distorsione sistemica quando misurano a temperature diverse. Ad esempio, la sonda pu\u00f2 attivarsi costantemente a un'altezza inferiore quando la sonda si trova a una temperatura pi\u00f9 elevata. Si consiglia di eseguire le procedure di livellamento del piatto a una temperatura costante per tenere conto di questa distorsione. Ad esempio, usare sempre la sonda quando la stampante \u00e8 a temperatura ambiente oppure eseguire sempre la procedura dopo che la stampante ha raggiunto una temperatura costante. In entrambi i casi, \u00e8 una buona idea attendere diversi minuti dopo che \u00e8 stata raggiunta la temperatura desiderata, in modo che tutto apparato stampante sia alla temperatura desiderata costantemente. Per verificare la presenza di un errore per temperatura, iniziare con la stampante a temperatura ambiente e poi portare a home la stampante, spostare la testina in una posizione vicino al centro del letto ed eseguire il comando PROBE_ACCURACY . Nota i risultati. Quindi, senza eseguire l'homing o disabilitare i motori passo-passo, riscaldare l'ugello della stampante e il piatto alla temperatura di stampa ed eseguire nuovamente il comando PROBE_ACCURACY . Idealmente, il comando riporter\u00e0 risultati identici. Come sopra, se la sonda ha un errore causato dalla temperatura, fare attenzione a usare sempre la sonda a una temperatura costante stabile.","title":"Calibrazione sonda"},{"location":"Probe_Calibrate.html#calibrazione-sonda","text":"Questo documento descrive il metodo per calibrare gli offset X, Y e Z di una \"sonda z automatica\" in Klipper. Questo \u00e8 utile per gli utenti che hanno una sezione [probe] o [bltouch] nel loro file di configurazione.","title":"Calibrazione sonda"},{"location":"Probe_Calibrate.html#calibrazione-degli-offset-x-e-y-della-sonda","text":"Per calibrare l'offset X e Y, vai alla scheda \"Controllo\" di OctoPrint, avvia la stampante, quindi usa i pulsanti di spostamento di OctoPrint per spostare la testa in una posizione vicino al centro del piatto. Metti un pezzo di nastro adesivo blu (o simile) sul piatto sotto la sonda. Passare alla scheda \"Terminale\" di OctoPrint ed emettere un comando PROBE: PROBE Metti un segno sul nastro direttamente sotto il punto in cui si trova la sonda (o usa un metodo simile per annotare la posizione sul letto). Emettere un comando GET_POSITION e registrare la posizione XY della testa riportata da quel comando. Ad esempio se si vede: Recv: // toolhead: X:46.500000 Y:27.000000 Z:15.000000 E:0.000000 quindi si registrerebbe una posizione X della sonda di 46,5 e una posizione Y della sonda di 27. Dopo aver registrato la posizione della sonda, emettere una serie di comandi G1 fino a quando l'ugello si trova direttamente sopra il segno sul letto. Ad esempio, si potrebbe emettere: G1 F300 X57 Y30 Z15 per spostare l'ugello in una posizione X di 57 e Y di 30. Una volta trovata la posizione direttamente sopra il segno, utilizzare il comando GET_POSITION per segnalare quella posizione. Questa \u00e8 la posizione dell'ugello. L'offset_x \u00e8 quindi posizione_x_ugello - posizione_x_sonda e l'offset_y \u00e8 analogamente a posizione_y_ugello - posizione_y_sonda . Aggiorna il file printer.cfg con i valori indicati, rimuovi il nastro con i riferimento dal piatto, quindi esegui un comando RESTART in modo che i nuovi valori diventino effettivi.","title":"Calibrazione degli offset X e Y della sonda"},{"location":"Probe_Calibrate.html#calibrazione-z-offset-sonda","text":"Inserire una z_offset accurata per la sonda \u00e8 fondamentale per ottenere stampe di alta qualit\u00e0. Lo z_offset \u00e8 la distanza tra l'ugello e il letto quando la sonda si attiva. Lo strumento Klipper PROBE_CALIBRATE pu\u00f2 essere utilizzato per ottenere questo valore: eseguir\u00e0 una sonda automatica per misurare la posizione di trigger Z della sonda e quindi avvier\u00e0 una sonda manuale per ottenere l'altezza Z dell'ugello. La sonda z_offset verr\u00e0 quindi calcolata da queste misurazioni. Inizia spostando testa in una posizione vicino al centro del piatto. Passare alla scheda del terminale OctoPrint ed eseguire il comando PROBE_CALIBRATE per avviare lo strumento. Questo strumento eseguir\u00e0 una misura automatica con la sonda, quindi sollever\u00e0 la testina, sposter\u00e0 l'ugello sulla posizione del punto sonda e avvier\u00e0 lo strumento sonda manuale. Se l'ugello non si sposta in una posizione al di sopra del punto della sonda automatica, allora ANNULLA lo strumento sonda manuale ed eseguire la calibrazione dell'offset della sonda XY descritta sopra. Una volta avviata manualmente la sonda, seguire i passaggi descritti in \"the paper test\" per determinare la distanza effettiva tra l'ugello e il letto in una determinata posizione. Una volta completati questi passaggi, \u00e8 possibile ACCEPT la posizione e salvare i risultati nel file di configurazione con: SAVE_CONFIG Si noti che se viene apportata una modifica al sistema di movimento della stampante, alla posizione dell'hotend o alla posizione della sonda, i risultati di PROBE_CALIBRATE verranno invalidati. Se la sonda ha un offset X o Y e l'inclinazione del letto viene modificata (ad es. regolando le viti del letto, eseguendo DELTA_CALIBRATE, eseguendo Z_TILT_ADJUST, eseguendo QUAD_GANTRY_LEVEL o simili), i risultati di PROBE_CALIBRATE verranno invalidati. Dopo aver apportato una qualsiasi delle modifiche di cui sopra, sar\u00e0 necessario eseguire nuovamente PROBE_CALIBRATE. Se i risultati di PROBE_CALIBRATE vengono invalidati, anche tutti i risultati precedenti di bed mesh ottenuti utilizzando la sonda vengono invalidati: sar\u00e0 necessario eseguire nuovamente BED_MESH_CALIBRATE dopo aver ricalibrato la sonda.","title":"Calibrazione Z offset sonda"},{"location":"Probe_Calibrate.html#verifica-di-ripetibilita","text":"Dopo aver calibrato gli offset X, Y e Z della sonda, \u00e8 una buona idea verificare che la sonda fornisca risultati ripetibili. Inizia portando a home la stampante e quindi sposta la testa in una posizione vicino al centro del letto. Passare al terminale di OctoPrint ed eseguire il comando PROBE_ACCURACY . Questo comando eseguir\u00e0 il test con la sonda dieci volte e produrr\u00e0 un output simile al seguente: Recv: // probe accuracy: at X:0.000 Y:0.000 Z:10.000 Recv: // and read 10 times with speed of 5 mm/s Recv: // probe at -0.003,0.005 is z=2.506948 Recv: // probe at -0.003,0.005 is z=2.519448 Recv: // probe at -0.003,0.005 is z=2.519448 Recv: // probe at -0.003,0.005 is z=2.506948 Recv: // probe at -0.003,0.005 is z=2.519448 Recv: // probe at -0.003,0.005 is z=2.519448 Recv: // probe at -0.003,0.005 is z=2.506948 Recv: // probe at -0.003,0.005 is z=2.506948 Recv: // probe at -0.003,0.005 is z=2.519448 Recv: // probe at -0.003,0.005 is z=2.506948 Recv: // probe accuracy results: maximum 2.519448, minimum 2.506948, range 0.012500, average 2.513198, median 2.513198, standard deviation 0.006250 Idealmente lo strumento riporter\u00e0 un valore massimo e minimo identico. (Ovvero, idealmente la sonda ottiene un risultato identico su tutte e dieci le prove.) Tuttavia, \u00e8 normale che i valori minimo e massimo differiscano di una \"distanza di passo\" Z o fino a 5 micron (0,005 mm). Una \"distanza passo\" \u00e8 rotation_distance/(full_steps_per_rotation*microsteps) . La distanza tra il valore minimo e quello massimo \u00e8 chiamata intervallo. Quindi, nell'esempio precedente, poich\u00e9 la stampante utilizza una distanza di passo Z di 0,0125, un intervallo di 0,012500 sarebbe considerato normale. Se i risultati del test mostrano un valore di intervallo maggiore di 25 micron (0,025 mm), la sonda non ha una precisione sufficiente per le procedure tipiche di livellamento del piatto. Potrebbe essere possibile regolare la velocit\u00e0 della sonda e/o l'altezza di inizio della sonda per migliorare la ripetibilit\u00e0 della sonda. Il comando PROBE_ACCURACY consente di eseguire test con parametri diversi per vederne l'impatto - vedere il documento G-Codes per ulteriori dettagli. Se la sonda generalmente ottiene risultati ripetibili ma presenta un valore anomalo occasionale, potrebbe essere possibile tenerne conto utilizzando pi\u00f9 campioni su ciascuna sonda - leggere la descrizione dei parametri di configurazione dei campioni della sonda in riferimento di configurazione per maggiori dettagli. Se sono necessarie una nuova velocit\u00e0 della sonda, diversa quantit\u00e0 di campioni o altre impostazioni, aggiornare il file printer.cfg ed eseguire un comando RESTART . In tal caso, \u00e8 una buona idea anche calibrare z_offset di nuovo. Se non \u00e8 possibile ottenere risultati ripetibili, non utilizzare la sonda per livellare il letto. Klipper ha diversi strumenti manuali che possono essere utilizzati in alternativa: vedere il Bed Level document per ulteriori dettagli.","title":"Verifica di ripetibilit\u00e0"},{"location":"Probe_Calibrate.html#verifica-scostamenti-di-posizione","text":"Alcune sonde possono avere una distorsione sistematica che altera i risultati della sonda in determinate posizioni della testa. Ad esempio, se il supporto della sonda si inclina leggermente durante lo spostamento lungo l'asse Y, la sonda potrebbe riportare risultati distorti in differenti posizioni Y. Questo \u00e8 un problema comune con le sonde sulle stampanti delta, tuttavia pu\u00f2 verificarsi su tutte le stampanti. Si pu\u00f2 verificare una distorsione di posizione utilizzando il comando PROBE_CALIBRATE per misurare l'offset z della sonda in varie posizioni X e Y. Idealmente, il probe z_offset sarebbe un valore costante in ogni posizione della stampante. Per le stampanti delta, prova a misurare z_offset in una posizione vicino alla torre A, in una posizione vicino alla torre B e in una posizione vicino alla torre C. Per stampanti cartesiane, corexy e simili, prova a misurare z_offset in posizioni vicino ai quattro angoli del letto. Prima di iniziare questo test, calibrare prima gli offset della sonda X, Y e Z come descritto all'inizio di questo documento. Quindi porta a home la stampante e vai alla prima posizione XY. Seguire i passaggi in calibrazione dell'offset Z della sonda per eseguire il comando PROBE_CALIBRATE , i comandi TESTZ e il comando ACCETTA , ma non eseguire SAVE_CONFIG . Nota lo z_offset segnalato trovato. Quindi passare alle altre posizioni XY, ripetere questi passaggi PROBE_CALIBRATE e annotare lo z_offset riportato. Se la differenza tra l'offset z minimo riportato e l'offset z massimo riportato \u00e8 maggiore di 25 micron (0,025 mm), la sonda non \u00e8 adatta per le tipiche procedure di livellamento del letto. Consultare il Bed Level document per sonde alternative manuali.","title":"Verifica scostamenti di posizione"},{"location":"Probe_Calibrate.html#scostamenti-per-temperatura","text":"Molte sonde hanno una distorsione sistemica quando misurano a temperature diverse. Ad esempio, la sonda pu\u00f2 attivarsi costantemente a un'altezza inferiore quando la sonda si trova a una temperatura pi\u00f9 elevata. Si consiglia di eseguire le procedure di livellamento del piatto a una temperatura costante per tenere conto di questa distorsione. Ad esempio, usare sempre la sonda quando la stampante \u00e8 a temperatura ambiente oppure eseguire sempre la procedura dopo che la stampante ha raggiunto una temperatura costante. In entrambi i casi, \u00e8 una buona idea attendere diversi minuti dopo che \u00e8 stata raggiunta la temperatura desiderata, in modo che tutto apparato stampante sia alla temperatura desiderata costantemente. Per verificare la presenza di un errore per temperatura, iniziare con la stampante a temperatura ambiente e poi portare a home la stampante, spostare la testina in una posizione vicino al centro del letto ed eseguire il comando PROBE_ACCURACY . Nota i risultati. Quindi, senza eseguire l'homing o disabilitare i motori passo-passo, riscaldare l'ugello della stampante e il piatto alla temperatura di stampa ed eseguire nuovamente il comando PROBE_ACCURACY . Idealmente, il comando riporter\u00e0 risultati identici. Come sopra, se la sonda ha un errore causato dalla temperatura, fare attenzione a usare sempre la sonda a una temperatura costante stabile.","title":"Scostamenti per temperatura"},{"location":"Protocol.html","text":"Protocollo \u00b6 Il protocollo di messaggistica Klipper viene utilizzato per la comunicazione di basso livello tra il software host Klipper e il software microcontrollore Klipper. Ad alto livello il protocollo pu\u00f2 essere pensato come una serie di stringhe di comando e risposta che vengono compresse, trasmesse e quindi elaborate sul lato ricevente. Una serie di esempio di comandi in formato non compresso leggibile dall'uomo potrebbe essere simile a: set_digital_out pin=PA3 value=1 set_digital_out pin=PA7 value=1 schedule_digital_out oid=8 clock=4000000 value=0 queue_step oid=7 interval=7458 count=10 add=331 queue_step oid=7 interval=11717 count=4 add=1281 Vedere il documento mcu commands per informazioni sui comandi disponibili. Vedere il documento debugging per informazioni su come tradurre un file G-Code nei corrispondenti comandi del microcontrollore leggibili dall'uomo. Questa pagina fornisce una descrizione di alto livello del protocollo di messaggistica Klipper. Descrive come i messaggi sono dichiarati, codificati in formato binario (lo schema di \"compressione\") e trasmessi. L'obiettivo del protocollo \u00e8 abilitare un canale di comunicazione privo di errori tra l'host e il microcontrollore che sia a bassa latenza, bassa larghezza di banda e bassa complessit\u00e0 per il microcontrollore. Interfaccia microcontrollore \u00b6 Il protocollo di trasmissione Klipper pu\u00f2 essere pensato come un meccanismo RPC tra microcontrollore e host. Il software del microcontrollore dichiara i comandi che l'host pu\u00f2 richiamare insieme ai messaggi di risposta che pu\u00f2 generare. L'host utilizza tali informazioni per comandare al microcontrollore di eseguire azioni e interpretare i risultati. Dichiarazione dei comandi \u00b6 Il software del microcontrollore dichiara un \"comando\" utilizzando la macro DECL_COMMAND() nel codice C. Per esempio: DECL_COMMAND(command_update_digital_out, \"update_digital_out oid=%c value=%c\"); Quanto sopra dichiara un comando denominato \"update_digital_out\". Ci\u00f2 consente all'host di \"richiamare\" questo comando che causerebbe l'esecuzione della funzione C command_update_digital_out() nel microcontrollore. Quanto sopra indica anche che il comando accetta due parametri interi. Quando viene eseguito il codice C command_update_digital_out(), verr\u00e0 passata una matrice contenente questi due numeri interi: il primo corrispondente all'\"oid\" e il secondo corrispondente al \"valore\". In generale, i parametri sono descritti con la sintassi di stile printf() (ad esempio, \"%u\"). La formattazione corrisponde direttamente alla visualizzazione leggibile dei comandi (ad es. \"update_digital_out oid=7 value=1\"). Nell'esempio precedente, \"value=\" \u00e8 un nome di parametro e \"%c\" indica che il parametro \u00e8 un numero intero. Internamente, il nome del parametro viene utilizzato solo come documentazione. In questo esempio, \"%c\" viene utilizzato anche come documentazione per indicare che l'intero previsto ha una dimensione di 1 byte (la dimensione intera dichiarata non influisce sull'analisi o sulla codifica). La build del microcontrollore raccoglier\u00e0 tutti i comandi dichiarati con DECL_COMMAND(), ne determiner\u00e0 i parametri e far\u00e0 in modo che siano richiamabili. Declaring responses \u00b6 Per inviare informazioni dal microcontrollore all'host viene generata una \"risposta\". Questi sono sia dichiarati che trasmessi usando la macro C sendf(). Per esempio: sendf(\"status clock=%u status=%c\", sched_read_time(), sched_is_shutdown()); Quanto sopra trasmette un messaggio di risposta di \"stato\" che contiene due parametri interi (\"clock\" e \"status\"). La build del microcontrollore trova automaticamente tutte le chiamate sendf() e genera codificatori per esse. Il primo parametro della funzione sendf() descrive la risposta ed \u00e8 nello stesso formato delle dichiarazioni di comando. L'host pu\u00f2 organizzare la registrazione di una funzione di richiamata per ogni risposta. Quindi, in effetti, i comandi consentono all'host di invocare le funzioni C nel microcontrollore e le risposte consentono al software del microcontrollore di richiamare il codice nell'host. La macro sendf() deve essere invocata solo da gestori di comandi o attivit\u00e0 e non deve essere invocata da interrupt o timer. Il codice non ha bisogno di emettere un sendf() in risposta a un comando ricevuto, non \u00e8 limitato nel numero di volte in cui sendf() pu\u00f2 essere invocato e pu\u00f2 invocare sendf() in qualsiasi momento da un task handler. Risposte in output \u00b6 Per semplificare il debug, esiste anche una funzione C output(). Per esempio: output(\"Il valore di%u \u00e8 %s con dimensione %u.\", x, buf, buf_len); La funzione output() \u00e8 simile nell'uso a printf() - \u00e8 intesa per generare e formattare messaggi arbitrari per il 'consumo umano'. Dichiarazione di enumerazioni \u00b6 Le enumerazioni consentono al codice host di utilizzare identificatori di stringa per i parametri che il microcontrollore gestisce come numeri interi. Sono dichiarati nel codice del microcontrollore, ad esempio: DECL_ENUMERATION(\"spi_bus\", \"spi\", 0); DECL_ENUMERATION_RANGE(\"pin\", \"PC0\", 16, 8); Se il primo esempio, la macro DECL_ENUMERATION() definisce un'enumerazione per qualsiasi messaggio di comando/risposta con nome parametro \"spi_bus\" o nome parametro con suffisso \"_spi_bus\". Per quei parametri la stringa \"spi\" \u00e8 un valore valido e verr\u00e0 trasmessa con un valore intero pari a zero. \u00c8 anche possibile dichiarare un intervallo di enumerazione. Nel secondo esempio, un parametro \"pin\" (o qualsiasi parametro con suffisso \"_pin\") accetterebbe PC0, PC1, PC2, ..., PC7 come valori validi. Le stringhe verranno trasmesse con numeri interi 16, 17, 18, ..., 23. Dichiarazione di costanti \u00b6 Le costanti possono anche essere esportate. Ad esempio, quanto segue: DECL_CONSTANT(\"SERIAL_BAUD\", 250000); esporterebbe una costante denominata \"SERIAL_BAUD\" con un valore di 250000 dal microcontrollore all'host. \u00c8 anche possibile dichiarare una costante che \u00e8 una stringa, ad esempio: DECL_CONSTANT_STR(\"MCU\", \"pru\"); Codifica dei messaggi di basso livello \u00b6 Per realizzare il meccanismo RPC di cui sopra, ogni comando e risposta viene codificato in un formato binario per la trasmissione. Questa sezione descrive il sistema di trasmissione. Blocchi di messaggi \u00b6 Tutti i dati inviati dall'host al microcontrollore e viceversa sono contenuti in \"blocchi di messaggi\". Un blocco di messaggi ha un'intestazione di due byte e un trailer di tre byte. Il formato di un blocco di messaggi \u00e8: <1 byte lunghezza><1 byte sequenza><n-byte contenuto><2 byte crc><1 byte sync> Il byte di lunghezza contiene il numero di byte nel blocco di messaggi inclusi i byte di intestazione e trailer (quindi la lunghezza minima del messaggio \u00e8 5 byte). La lunghezza massima del blocco di messaggi \u00e8 attualmente di 64 byte. Il byte di sequenza contiene un numero di sequenza di 4 bit nei bit di ordine inferiore e i bit di ordine superiore contengono sempre 0x10 (i bit di ordine superiore sono riservati per un uso futuro). I byte di contenuto contengono dati arbitrari e il relativo formato \u00e8 descritto nella sezione seguente. I byte crc contengono un CCITT CRC a 16 bit del blocco di messaggi inclusi i byte di intestazione ma esclusi i byte di trailer. Il byte di sincronizzazione \u00e8 0x7e. Il formato del blocco di messaggi si ispira ai telegrammi HDLC . Come in HDLC, il blocco di messaggi pu\u00f2 contenere facoltativamente un carattere di sincronizzazione aggiuntivo all'inizio del blocco. A differenza di HDLC, un carattere di sincronizzazione non \u00e8 esclusivo del framing e pu\u00f2 essere presente nel contenuto del blocco di messaggi. Contenuto del blocco messaggi \u00b6 Ogni blocco di messaggi inviato dall'host al microcontrollore contiene una serie di zero o pi\u00f9 comandi di messaggi. Ogni comando inizia con un Quantit\u00e0 a lunghezza variabile (VLQ) command-id seguito da zero o pi\u00f9 parametri VLQ per il comando dato. Ad esempio, i seguenti quattro comandi possono essere inseriti in un unico blocco di messaggi: update_digital_out oid=6 value=1 update_digital_out oid=5 value=0 get_config get_clock e codificato nei seguenti otto interi VLQ: <id_update_digital_out><6><1><id_update_digital_out><5><0><id_get_config><id_get_clock> Per codificare e analizzare il contenuto del messaggio, sia l'host che il microcontrollore devono concordare gli ID comando e il numero di parametri di ciascun comando. Quindi, nell'esempio sopra, sia l'host che il microcontrollore saprebbero che \"id_update_digital_out\" \u00e8 sempre seguito da due parametri e \"id_get_config\" e \"id_get_clock\" hanno zero parametri. L'host e il microcontrollore condividono un \"dizionario dei dati\" che mappa le descrizioni dei comandi (ad esempio, \"update_digital_out oid=%c value=%c\") ai loro ID di comando interi. Durante l'elaborazione dei dati, il parser sapr\u00e0 di aspettarsi un numero specifico di parametri codificati VLQ a seguito di un determinato ID comando. Il contenuto del messaggio per i blocchi inviati dal microcontrollore all'host segue lo stesso formato. Gli identificatori in questi messaggi sono \"ID di risposta\", ma servono allo stesso scopo e seguono le stesse regole di codifica. In pratica, i blocchi di messaggi inviati dal microcontrollore all'host non contengono mai pi\u00f9 di una risposta nel contenuto del blocco di messaggi. Quantit\u00e0 di lunghezza variabile \u00b6 Consulta l' articolo di Wikipedia per ulteriori informazioni sul formato generale degli interi codificati VLQ. Klipper utilizza uno schema di codifica che supporta numeri interi positivi e negativi. Gli interi prossimi allo zero utilizzano meno byte per codificare e gli interi positivi in genere codificano utilizzando meno byte degli interi negativi. La tabella seguente mostra il numero di byte che ogni intero impiega per codificare: Intero Dimensione codificata -32 .. 95 1 -4096 .. 12287 2 -524288 .. 1572863 3 -67108864 .. 201326591 4 -2147483648 .. 4294967295 5 Stringhe di lunghezza variabile \u00b6 Come eccezione alle regole di codifica precedenti, se un parametro di un comando o di una risposta \u00e8 una stringa dinamica, il parametro non viene codificato come un semplice intero VLQ. Invece viene codificato trasmettendo la lunghezza come intero codificato VLQ seguito dal contenuto stesso: <VLQ encoded length><n-byte contents> Le descrizioni dei comandi che si trovano nel dizionario dei dati consentono sia all'host che al microcontrollore di sapere quali parametri del comando utilizzano la semplice codifica VLQ e quali parametri utilizzano la codifica delle stringhe. Dizionario dati \u00b6 Affinch\u00e9 vengano stabilite comunicazioni significative tra microcontrollore e host, entrambe le parti devono concordare un \"dizionario dei dati\". Questo dizionario di dati contiene gli identificatori interi per comandi e risposte insieme alle relative descrizioni. La build del microcontrollore utilizza il contenuto delle macro DECL_COMMAND() e sendf() per generare il dizionario dei dati. La build assegna automaticamente identificatori univoci a ciascun comando e risposta. Questo sistema consente sia all'host che al codice del microcontrollore di utilizzare senza problemi nomi descrittivi leggibili dall'uomo pur utilizzando una larghezza di banda minima. L'host interroga il dizionario dei dati quando si connette per la prima volta al microcontrollore. Una volta che l'host ha scaricato il dizionario dei dati dal microcontrollore, utilizza quel dizionario dei dati per codificare tutti i comandi e per analizzare tutte le risposte dal microcontrollore. L'host deve quindi gestire un dizionario di dati dinamico. Tuttavia, per mantenere semplice il software del microcontrollore, il microcontrollore utilizza sempre il suo dizionario dati statico (compilato). Il dizionario dei dati viene interrogato inviando i comandi \"identify\" al microcontrollore. Il microcontrollore risponder\u00e0 a ogni comando di identificazione con un messaggio \"identify_response\". Poich\u00e9 questi due comandi sono necessari prima di ottenere il dizionario dei dati, i loro ID interi e tipi di parametri sono codificati sia nel microcontrollore che nell'host. L'ID della risposta \"identify_response\" \u00e8 0, l'ID del comando \"identify\" \u00e8 1. Oltre ad avere ID hardcoded, il comando di identificazione e la relativa risposta vengono dichiarati e trasmessi allo stesso modo degli altri comandi e risposte. Nessun altro comando o risposta \u00e8 hardcoded. Il formato del dizionario dei dati trasmessi stesso \u00e8 una stringa JSON compressa zlib. Il processo di compilazione del microcontrollore genera la stringa, la comprime e la memorizza nella sezione di testo del flash del microcontrollore. Il dizionario dei dati pu\u00f2 essere molto pi\u00f9 grande della dimensione massima del blocco del messaggio: l'host lo scarica inviando pi\u00f9 comandi di identificazione che richiedono blocchi progressivi del dizionario dei dati. Una volta ottenuti tutti i blocchi, l'host assembler\u00e0 i blocchi, decomprimer\u00e0 i dati e analizzer\u00e0 il contenuto. Oltre alle informazioni sul protocollo di comunicazione, il dizionario dei dati contiene anche la versione del software, le enumerazioni (come definite da DECL_ENUMERATION) e le costanti (come definite da DECL_CONSTANT). Flusso di messaggi \u00b6 I comandi dei messaggi inviati dall'host al microcontrollore sono concepiti per essere privi di errori. Il microcontrollore controller\u00e0 il CRC e i numeri di sequenza in ciascun blocco di messaggi per garantire che i comandi siano accurati e in ordine. Il microcontrollore elabora sempre i blocchi di messaggi in ordine - se riceve un blocco fuori ordine, lo scarter\u00e0 e tutti gli altri blocchi fuori ordine fino a quando non riceve blocchi con la sequenza corretta. Il codice host di basso livello implementa un sistema di ritrasmissione automatica per i blocchi di messaggi persi e corrotti inviati al microcontrollore. Per facilitare ci\u00f2, il microcontrollore trasmette un \"ack message block\" dopo ogni blocco di messaggio ricevuto con successo. L'host pianifica un timeout dopo l'invio di ogni blocco e lo ritrasmetter\u00e0 se il timeout scade senza ricevere un corrispondente \"ack\". Inoltre, se il microcontrollore rileva un blocco corrotto o fuori servizio, pu\u00f2 trasmettere un \"nak message block\" per facilitare una rapida ritrasmissione. Un \"ack\" \u00e8 un blocco di messaggi con contenuto vuoto (cio\u00e8 un blocco di messaggi di 5 byte) e un numero di sequenza maggiore dell'ultimo numero di sequenza dell'host ricevuto. Un \"nak\" \u00e8 un blocco di messaggi con contenuto vuoto e un numero di sequenza inferiore all'ultimo numero di sequenza host ricevuto. Il protocollo facilita un sistema di trasmissione \"finestra\" in modo che l'host possa avere molti blocchi di messaggi in sospeso in viaggio alla volta. (Questo \u00e8 in aggiunta ai molti comandi che possono essere presenti in un determinato blocco di messaggi.) Ci\u00f2 consente il massimo utilizzo della larghezza di banda anche in caso di latenza di trasmissione. Il meccanismo di timeout, ritrasmissione, windowing e ack si ispira a meccanismi simili in TCP . Nell'altra direzione, i blocchi di messaggi inviati dal microcontrollore all'host sono progettati per essere privi di errori, ma non hanno una trasmissione sicura. (Le risposte non dovrebbero essere danneggiate, ma potrebbero scomparire.) Questo viene fatto per mantenere semplice l'implementazione nel microcontrollore. Non esiste un sistema di ritrasmissione automatica delle risposte: ci si aspetta che il codice di alto livello sia in grado di gestire una risposta mancante occasionale (di solito richiedendo nuovamente il contenuto o impostando un programma ricorrente di trasmissione della risposta). Il campo del numero di sequenza nei blocchi di messaggi inviati all'host \u00e8 sempre uno maggiore dell'ultimo numero di sequenza di blocchi di messaggi ricevuti dall'host. Non viene utilizzato per tenere traccia di sequenze di blocchi di messaggi di risposta.","title":"Protocollo"},{"location":"Protocol.html#protocollo","text":"Il protocollo di messaggistica Klipper viene utilizzato per la comunicazione di basso livello tra il software host Klipper e il software microcontrollore Klipper. Ad alto livello il protocollo pu\u00f2 essere pensato come una serie di stringhe di comando e risposta che vengono compresse, trasmesse e quindi elaborate sul lato ricevente. Una serie di esempio di comandi in formato non compresso leggibile dall'uomo potrebbe essere simile a: set_digital_out pin=PA3 value=1 set_digital_out pin=PA7 value=1 schedule_digital_out oid=8 clock=4000000 value=0 queue_step oid=7 interval=7458 count=10 add=331 queue_step oid=7 interval=11717 count=4 add=1281 Vedere il documento mcu commands per informazioni sui comandi disponibili. Vedere il documento debugging per informazioni su come tradurre un file G-Code nei corrispondenti comandi del microcontrollore leggibili dall'uomo. Questa pagina fornisce una descrizione di alto livello del protocollo di messaggistica Klipper. Descrive come i messaggi sono dichiarati, codificati in formato binario (lo schema di \"compressione\") e trasmessi. L'obiettivo del protocollo \u00e8 abilitare un canale di comunicazione privo di errori tra l'host e il microcontrollore che sia a bassa latenza, bassa larghezza di banda e bassa complessit\u00e0 per il microcontrollore.","title":"Protocollo"},{"location":"Protocol.html#interfaccia-microcontrollore","text":"Il protocollo di trasmissione Klipper pu\u00f2 essere pensato come un meccanismo RPC tra microcontrollore e host. Il software del microcontrollore dichiara i comandi che l'host pu\u00f2 richiamare insieme ai messaggi di risposta che pu\u00f2 generare. L'host utilizza tali informazioni per comandare al microcontrollore di eseguire azioni e interpretare i risultati.","title":"Interfaccia microcontrollore"},{"location":"Protocol.html#dichiarazione-dei-comandi","text":"Il software del microcontrollore dichiara un \"comando\" utilizzando la macro DECL_COMMAND() nel codice C. Per esempio: DECL_COMMAND(command_update_digital_out, \"update_digital_out oid=%c value=%c\"); Quanto sopra dichiara un comando denominato \"update_digital_out\". Ci\u00f2 consente all'host di \"richiamare\" questo comando che causerebbe l'esecuzione della funzione C command_update_digital_out() nel microcontrollore. Quanto sopra indica anche che il comando accetta due parametri interi. Quando viene eseguito il codice C command_update_digital_out(), verr\u00e0 passata una matrice contenente questi due numeri interi: il primo corrispondente all'\"oid\" e il secondo corrispondente al \"valore\". In generale, i parametri sono descritti con la sintassi di stile printf() (ad esempio, \"%u\"). La formattazione corrisponde direttamente alla visualizzazione leggibile dei comandi (ad es. \"update_digital_out oid=7 value=1\"). Nell'esempio precedente, \"value=\" \u00e8 un nome di parametro e \"%c\" indica che il parametro \u00e8 un numero intero. Internamente, il nome del parametro viene utilizzato solo come documentazione. In questo esempio, \"%c\" viene utilizzato anche come documentazione per indicare che l'intero previsto ha una dimensione di 1 byte (la dimensione intera dichiarata non influisce sull'analisi o sulla codifica). La build del microcontrollore raccoglier\u00e0 tutti i comandi dichiarati con DECL_COMMAND(), ne determiner\u00e0 i parametri e far\u00e0 in modo che siano richiamabili.","title":"Dichiarazione dei comandi"},{"location":"Protocol.html#declaring-responses","text":"Per inviare informazioni dal microcontrollore all'host viene generata una \"risposta\". Questi sono sia dichiarati che trasmessi usando la macro C sendf(). Per esempio: sendf(\"status clock=%u status=%c\", sched_read_time(), sched_is_shutdown()); Quanto sopra trasmette un messaggio di risposta di \"stato\" che contiene due parametri interi (\"clock\" e \"status\"). La build del microcontrollore trova automaticamente tutte le chiamate sendf() e genera codificatori per esse. Il primo parametro della funzione sendf() descrive la risposta ed \u00e8 nello stesso formato delle dichiarazioni di comando. L'host pu\u00f2 organizzare la registrazione di una funzione di richiamata per ogni risposta. Quindi, in effetti, i comandi consentono all'host di invocare le funzioni C nel microcontrollore e le risposte consentono al software del microcontrollore di richiamare il codice nell'host. La macro sendf() deve essere invocata solo da gestori di comandi o attivit\u00e0 e non deve essere invocata da interrupt o timer. Il codice non ha bisogno di emettere un sendf() in risposta a un comando ricevuto, non \u00e8 limitato nel numero di volte in cui sendf() pu\u00f2 essere invocato e pu\u00f2 invocare sendf() in qualsiasi momento da un task handler.","title":"Declaring responses"},{"location":"Protocol.html#risposte-in-output","text":"Per semplificare il debug, esiste anche una funzione C output(). Per esempio: output(\"Il valore di%u \u00e8 %s con dimensione %u.\", x, buf, buf_len); La funzione output() \u00e8 simile nell'uso a printf() - \u00e8 intesa per generare e formattare messaggi arbitrari per il 'consumo umano'.","title":"Risposte in output"},{"location":"Protocol.html#dichiarazione-di-enumerazioni","text":"Le enumerazioni consentono al codice host di utilizzare identificatori di stringa per i parametri che il microcontrollore gestisce come numeri interi. Sono dichiarati nel codice del microcontrollore, ad esempio: DECL_ENUMERATION(\"spi_bus\", \"spi\", 0); DECL_ENUMERATION_RANGE(\"pin\", \"PC0\", 16, 8); Se il primo esempio, la macro DECL_ENUMERATION() definisce un'enumerazione per qualsiasi messaggio di comando/risposta con nome parametro \"spi_bus\" o nome parametro con suffisso \"_spi_bus\". Per quei parametri la stringa \"spi\" \u00e8 un valore valido e verr\u00e0 trasmessa con un valore intero pari a zero. \u00c8 anche possibile dichiarare un intervallo di enumerazione. Nel secondo esempio, un parametro \"pin\" (o qualsiasi parametro con suffisso \"_pin\") accetterebbe PC0, PC1, PC2, ..., PC7 come valori validi. Le stringhe verranno trasmesse con numeri interi 16, 17, 18, ..., 23.","title":"Dichiarazione di enumerazioni"},{"location":"Protocol.html#dichiarazione-di-costanti","text":"Le costanti possono anche essere esportate. Ad esempio, quanto segue: DECL_CONSTANT(\"SERIAL_BAUD\", 250000); esporterebbe una costante denominata \"SERIAL_BAUD\" con un valore di 250000 dal microcontrollore all'host. \u00c8 anche possibile dichiarare una costante che \u00e8 una stringa, ad esempio: DECL_CONSTANT_STR(\"MCU\", \"pru\");","title":"Dichiarazione di costanti"},{"location":"Protocol.html#codifica-dei-messaggi-di-basso-livello","text":"Per realizzare il meccanismo RPC di cui sopra, ogni comando e risposta viene codificato in un formato binario per la trasmissione. Questa sezione descrive il sistema di trasmissione.","title":"Codifica dei messaggi di basso livello"},{"location":"Protocol.html#blocchi-di-messaggi","text":"Tutti i dati inviati dall'host al microcontrollore e viceversa sono contenuti in \"blocchi di messaggi\". Un blocco di messaggi ha un'intestazione di due byte e un trailer di tre byte. Il formato di un blocco di messaggi \u00e8: <1 byte lunghezza><1 byte sequenza><n-byte contenuto><2 byte crc><1 byte sync> Il byte di lunghezza contiene il numero di byte nel blocco di messaggi inclusi i byte di intestazione e trailer (quindi la lunghezza minima del messaggio \u00e8 5 byte). La lunghezza massima del blocco di messaggi \u00e8 attualmente di 64 byte. Il byte di sequenza contiene un numero di sequenza di 4 bit nei bit di ordine inferiore e i bit di ordine superiore contengono sempre 0x10 (i bit di ordine superiore sono riservati per un uso futuro). I byte di contenuto contengono dati arbitrari e il relativo formato \u00e8 descritto nella sezione seguente. I byte crc contengono un CCITT CRC a 16 bit del blocco di messaggi inclusi i byte di intestazione ma esclusi i byte di trailer. Il byte di sincronizzazione \u00e8 0x7e. Il formato del blocco di messaggi si ispira ai telegrammi HDLC . Come in HDLC, il blocco di messaggi pu\u00f2 contenere facoltativamente un carattere di sincronizzazione aggiuntivo all'inizio del blocco. A differenza di HDLC, un carattere di sincronizzazione non \u00e8 esclusivo del framing e pu\u00f2 essere presente nel contenuto del blocco di messaggi.","title":"Blocchi di messaggi"},{"location":"Protocol.html#contenuto-del-blocco-messaggi","text":"Ogni blocco di messaggi inviato dall'host al microcontrollore contiene una serie di zero o pi\u00f9 comandi di messaggi. Ogni comando inizia con un Quantit\u00e0 a lunghezza variabile (VLQ) command-id seguito da zero o pi\u00f9 parametri VLQ per il comando dato. Ad esempio, i seguenti quattro comandi possono essere inseriti in un unico blocco di messaggi: update_digital_out oid=6 value=1 update_digital_out oid=5 value=0 get_config get_clock e codificato nei seguenti otto interi VLQ: <id_update_digital_out><6><1><id_update_digital_out><5><0><id_get_config><id_get_clock> Per codificare e analizzare il contenuto del messaggio, sia l'host che il microcontrollore devono concordare gli ID comando e il numero di parametri di ciascun comando. Quindi, nell'esempio sopra, sia l'host che il microcontrollore saprebbero che \"id_update_digital_out\" \u00e8 sempre seguito da due parametri e \"id_get_config\" e \"id_get_clock\" hanno zero parametri. L'host e il microcontrollore condividono un \"dizionario dei dati\" che mappa le descrizioni dei comandi (ad esempio, \"update_digital_out oid=%c value=%c\") ai loro ID di comando interi. Durante l'elaborazione dei dati, il parser sapr\u00e0 di aspettarsi un numero specifico di parametri codificati VLQ a seguito di un determinato ID comando. Il contenuto del messaggio per i blocchi inviati dal microcontrollore all'host segue lo stesso formato. Gli identificatori in questi messaggi sono \"ID di risposta\", ma servono allo stesso scopo e seguono le stesse regole di codifica. In pratica, i blocchi di messaggi inviati dal microcontrollore all'host non contengono mai pi\u00f9 di una risposta nel contenuto del blocco di messaggi.","title":"Contenuto del blocco messaggi"},{"location":"Protocol.html#quantita-di-lunghezza-variabile","text":"Consulta l' articolo di Wikipedia per ulteriori informazioni sul formato generale degli interi codificati VLQ. Klipper utilizza uno schema di codifica che supporta numeri interi positivi e negativi. Gli interi prossimi allo zero utilizzano meno byte per codificare e gli interi positivi in genere codificano utilizzando meno byte degli interi negativi. La tabella seguente mostra il numero di byte che ogni intero impiega per codificare: Intero Dimensione codificata -32 .. 95 1 -4096 .. 12287 2 -524288 .. 1572863 3 -67108864 .. 201326591 4 -2147483648 .. 4294967295 5","title":"Quantit\u00e0 di lunghezza variabile"},{"location":"Protocol.html#stringhe-di-lunghezza-variabile","text":"Come eccezione alle regole di codifica precedenti, se un parametro di un comando o di una risposta \u00e8 una stringa dinamica, il parametro non viene codificato come un semplice intero VLQ. Invece viene codificato trasmettendo la lunghezza come intero codificato VLQ seguito dal contenuto stesso: <VLQ encoded length><n-byte contents> Le descrizioni dei comandi che si trovano nel dizionario dei dati consentono sia all'host che al microcontrollore di sapere quali parametri del comando utilizzano la semplice codifica VLQ e quali parametri utilizzano la codifica delle stringhe.","title":"Stringhe di lunghezza variabile"},{"location":"Protocol.html#dizionario-dati","text":"Affinch\u00e9 vengano stabilite comunicazioni significative tra microcontrollore e host, entrambe le parti devono concordare un \"dizionario dei dati\". Questo dizionario di dati contiene gli identificatori interi per comandi e risposte insieme alle relative descrizioni. La build del microcontrollore utilizza il contenuto delle macro DECL_COMMAND() e sendf() per generare il dizionario dei dati. La build assegna automaticamente identificatori univoci a ciascun comando e risposta. Questo sistema consente sia all'host che al codice del microcontrollore di utilizzare senza problemi nomi descrittivi leggibili dall'uomo pur utilizzando una larghezza di banda minima. L'host interroga il dizionario dei dati quando si connette per la prima volta al microcontrollore. Una volta che l'host ha scaricato il dizionario dei dati dal microcontrollore, utilizza quel dizionario dei dati per codificare tutti i comandi e per analizzare tutte le risposte dal microcontrollore. L'host deve quindi gestire un dizionario di dati dinamico. Tuttavia, per mantenere semplice il software del microcontrollore, il microcontrollore utilizza sempre il suo dizionario dati statico (compilato). Il dizionario dei dati viene interrogato inviando i comandi \"identify\" al microcontrollore. Il microcontrollore risponder\u00e0 a ogni comando di identificazione con un messaggio \"identify_response\". Poich\u00e9 questi due comandi sono necessari prima di ottenere il dizionario dei dati, i loro ID interi e tipi di parametri sono codificati sia nel microcontrollore che nell'host. L'ID della risposta \"identify_response\" \u00e8 0, l'ID del comando \"identify\" \u00e8 1. Oltre ad avere ID hardcoded, il comando di identificazione e la relativa risposta vengono dichiarati e trasmessi allo stesso modo degli altri comandi e risposte. Nessun altro comando o risposta \u00e8 hardcoded. Il formato del dizionario dei dati trasmessi stesso \u00e8 una stringa JSON compressa zlib. Il processo di compilazione del microcontrollore genera la stringa, la comprime e la memorizza nella sezione di testo del flash del microcontrollore. Il dizionario dei dati pu\u00f2 essere molto pi\u00f9 grande della dimensione massima del blocco del messaggio: l'host lo scarica inviando pi\u00f9 comandi di identificazione che richiedono blocchi progressivi del dizionario dei dati. Una volta ottenuti tutti i blocchi, l'host assembler\u00e0 i blocchi, decomprimer\u00e0 i dati e analizzer\u00e0 il contenuto. Oltre alle informazioni sul protocollo di comunicazione, il dizionario dei dati contiene anche la versione del software, le enumerazioni (come definite da DECL_ENUMERATION) e le costanti (come definite da DECL_CONSTANT).","title":"Dizionario dati"},{"location":"Protocol.html#flusso-di-messaggi","text":"I comandi dei messaggi inviati dall'host al microcontrollore sono concepiti per essere privi di errori. Il microcontrollore controller\u00e0 il CRC e i numeri di sequenza in ciascun blocco di messaggi per garantire che i comandi siano accurati e in ordine. Il microcontrollore elabora sempre i blocchi di messaggi in ordine - se riceve un blocco fuori ordine, lo scarter\u00e0 e tutti gli altri blocchi fuori ordine fino a quando non riceve blocchi con la sequenza corretta. Il codice host di basso livello implementa un sistema di ritrasmissione automatica per i blocchi di messaggi persi e corrotti inviati al microcontrollore. Per facilitare ci\u00f2, il microcontrollore trasmette un \"ack message block\" dopo ogni blocco di messaggio ricevuto con successo. L'host pianifica un timeout dopo l'invio di ogni blocco e lo ritrasmetter\u00e0 se il timeout scade senza ricevere un corrispondente \"ack\". Inoltre, se il microcontrollore rileva un blocco corrotto o fuori servizio, pu\u00f2 trasmettere un \"nak message block\" per facilitare una rapida ritrasmissione. Un \"ack\" \u00e8 un blocco di messaggi con contenuto vuoto (cio\u00e8 un blocco di messaggi di 5 byte) e un numero di sequenza maggiore dell'ultimo numero di sequenza dell'host ricevuto. Un \"nak\" \u00e8 un blocco di messaggi con contenuto vuoto e un numero di sequenza inferiore all'ultimo numero di sequenza host ricevuto. Il protocollo facilita un sistema di trasmissione \"finestra\" in modo che l'host possa avere molti blocchi di messaggi in sospeso in viaggio alla volta. (Questo \u00e8 in aggiunta ai molti comandi che possono essere presenti in un determinato blocco di messaggi.) Ci\u00f2 consente il massimo utilizzo della larghezza di banda anche in caso di latenza di trasmissione. Il meccanismo di timeout, ritrasmissione, windowing e ack si ispira a meccanismi simili in TCP . Nell'altra direzione, i blocchi di messaggi inviati dal microcontrollore all'host sono progettati per essere privi di errori, ma non hanno una trasmissione sicura. (Le risposte non dovrebbero essere danneggiate, ma potrebbero scomparire.) Questo viene fatto per mantenere semplice l'implementazione nel microcontrollore. Non esiste un sistema di ritrasmissione automatica delle risposte: ci si aspetta che il codice di alto livello sia in grado di gestire una risposta mancante occasionale (di solito richiedendo nuovamente il contenuto o impostando un programma ricorrente di trasmissione della risposta). Il campo del numero di sequenza nei blocchi di messaggi inviati all'host \u00e8 sempre uno maggiore dell'ultimo numero di sequenza di blocchi di messaggi ricevuti dall'host. Non viene utilizzato per tenere traccia di sequenze di blocchi di messaggi di risposta.","title":"Flusso di messaggi"},{"location":"RPi_microcontroller.html","text":"Microcontrollore RPi \u00b6 Questo documento descrive il processo di esecuzione di Klipper su un RPi e usa lo stesso RPi come mcu secondario. Perch\u00e9 usare RPi come MCU secondario? \u00b6 Spesso gli MCU dedicati al controllo delle stampanti 3D hanno un numero limitato e preconfigurato di pin esposti per gestire le principali funzioni di stampa (resistenze termiche, estrusori, stepper...). L'utilizzo dell'RPi dove Klipper \u00e8 installato come MCU secondario d\u00e0 la possibilit\u00e0 di utilizzare direttamente i GPIO e i bus (i2c, spi) dell'RPi all'interno di klipper senza utilizzare plugin Octoprint (se utilizzati) o programmi esterni dando la possibilit\u00e0 di controllare tutto all'interno del GCODE di stampa. Attenzione : Se la tua piattaforma \u00e8 un Beaglebone e hai seguito correttamente i passi di installazione, la mcu linux \u00e8 gi\u00e0 installata e configurata per il tuo sistema. Installa lo script rc \u00b6 Se si desidera utilizzare l'host come MCU secondario, il processo di klipper_mcu deve essere eseguito prima del processo klippy. Dopo aver installato Klipper, installare lo script. eseguire: cd ~/klipper/ sudo cp ./scripts/klipper-mcu.service /etc/systemd/system/ sudo systemctl enable klipper-mcu.service Creazione del codice del microcontrollore \u00b6 Per compilare il codice del microcontrollore Klipper, iniziate configurandolo per il \"processo Linux\": cd ~/klipper/ make menuconfig Nel menu, impostate \"Microcontroller Architecture\" su \"Linux process\", poi salvate e uscite. Per compilare e installare il nuovo codice del microcontrollore, eseguire: sudo service klipper stop make flash sudo service klipper start Se klippy.log segnala un errore \"Autorizzazione negata\" quando si tenta di connettersi a /tmp/klipper_host_mcu , \u00e8 necessario aggiungere l'utente al gruppo tty. Il seguente comando aggiunger\u00e0 l'utente \"pi\" al gruppo tty: sudo usermod -a -G tty pi Configurazione rimanente \u00b6 Completare l'installazione configurando l'MCU secondario di Klipper seguendo le istruzioni in RaspberryPi sample config e Multi MCU sample config . Facoltativo: abilitazione di SPI \u00b6 Assicurati che il driver SPI di Linux sia abilitato eseguendo sudo raspi-config e abilitando SPI nel menu \"Opzioni di interfaccia\". Opzionale: abilitazione di I2C \u00b6 Assicurati che l'interfaccia Linux I2C sia abilitato eseguendo sudo raspi-config e abilitando I2C nel menu \"Opzioni di interfaccia\". Se si intende utilizzare I2C per l'accelerometro MPU, \u00e8 anche necessario impostare il baud rate su 400000: aggiungendo/deselezionando dtparam=i2c_arm=on,i2c_arm_baudrate=400000 in /boot/config.txt (o / boot/firmware/config.txt in alcune distribuzioni). Opzionale: Identificare il gpiochip corretto \u00b6 Su Raspberry Pi e su molti cloni i pin esposti sul GPIO appartengono al primo gpiochip. Possono quindi essere utilizzati su klipper semplicemente riferendoli con il nome gpio0..n . Tuttavia, ci sono casi in cui i pin esposti appartengono a gpiochip diversi dal primo. Ad esempio nel caso di alcuni modelli OrangePi o se viene utilizzato un Port Expander. In questi casi \u00e8 utile utilizzare i comandi per accedere al dispositivo a caratteri GPIO Linux per verificarne la configurazione. Per installare il Linux GPIO character device - binary su una distro basata su debian come octopi eseguire: sudo apt-get install gpiod Per controllare i gpiochip disponibili eseguire: gpiodetect Per verificare il numero di pin e la disponibilit\u00e0 dei pin: gpioinfo Il pin scelto pu\u00f2 quindi essere utilizzato all'interno della configurazione come gpiochip<n>/gpio<o> dove n \u00e8 il numero del chip visto dal comando gpiodetect e o \u00e8 il numero di riga visto dal comando gpioinfo . Attenzione: solo i gpio contrassegnati come inutilizzati possono essere utilizzati. Non \u00e8 possibile che una linea sia usata da pi\u00f9 processi contemporaneamente. Per esempio su un RPi 3B+ dove klipper usa il GPIO20 per un interruttore: $ gpiodetect gpiochip0 [pinctrl-bcm2835] (54 lines) gpiochip1 [raspberrypi-exp-gpio] (8 lines) $ gpioinfo gpiochip0 - 54 lines: line 0: unnamed unused input active-high line 1: unnamed unused input active-high line 2: unnamed unused input active-high line 3: unnamed unused input active-high line 4: unnamed unused input active-high line 5: unnamed unused input active-high line 6: unnamed unused input active-high line 7: unnamed unused input active-high line 8: unnamed unused input active-high line 9: unnamed unused input active-high line 10: unnamed unused input active-high line 11: unnamed unused input active-high line 12: unnamed unused input active-high line 13: unnamed unused input active-high line 14: unnamed unused input active-high line 15: unnamed unused input active-high line 16: unnamed unused input active-high line 17: unnamed unused input active-high line 18: unnamed unused input active-high line 19: unnamed unused input active-high line 20: unnamed \"klipper\" output active-high [used] line 21: unnamed unused input active-high line 22: unnamed unused input active-high line 23: unnamed unused input active-high line 24: unnamed unused input active-high line 25: unnamed unused input active-high line 26: unnamed unused input active-high line 27: unnamed unused input active-high line 28: unnamed unused input active-high line 29: unnamed \"led0\" output active-high [used] line 30: unnamed unused input active-high line 31: unnamed unused input active-high line 32: unnamed unused input active-high line 33: unnamed unused input active-high line 34: unnamed unused input active-high line 35: unnamed unused input active-high line 36: unnamed unused input active-high line 37: unnamed unused input active-high line 38: unnamed unused input active-high line 39: unnamed unused input active-high line 40: unnamed unused input active-high line 41: unnamed unused input active-high line 42: unnamed unused input active-high line 43: unnamed unused input active-high line 44: unnamed unused input active-high line 45: unnamed unused input active-high line 46: unnamed unused input active-high line 47: unnamed unused input active-high line 48: unnamed unused input active-high line 49: unnamed unused input active-high line 50: unnamed unused input active-high line 51: unnamed unused input active-high line 52: unnamed unused input active-high line 53: unnamed unused input active-high gpiochip1 - 8 lines: line 0: unnamed unused input active-high line 1: unnamed unused input active-high line 2: unnamed \"led1\" output active-low [used] line 3: unnamed unused input active-high line 4: unnamed unused input active-high line 5: unnamed unused input active-high line 6: unnamed unused input active-high line 7: unnamed unused input active-high Opzionale: Hardware PWM \u00b6 I Raspberry Pi hanno due canali PWM (PWM0 e PWM1) che sono esposti sull'intestazione o, in caso contrario, possono essere instradati ai pin gpio esistenti. Il demone mcu Linux utilizza l'interfaccia sysfs pwmchip per controllare i dispositivi hardware pwm sugli host Linux. L'interfaccia sysfs pwm non \u00e8 esposta per impostazione predefinita su un Raspberry e pu\u00f2 essere attivata aggiungendo una riga a /boot/config.txt : # Abilita l'interfaccia sysfs di pwmchip dtoverlay=pwm,pin=12,func=4 Questo esempio abilita solo PWM0 e lo indirizza a gpio12. Se entrambi i canali PWM devono essere abilitati potete usare pwm-2chan . L'overlay non espone la riga pwm sui sysfs all'avvio e deve essere esportata facendo eco al numero del canale pwm in /sys/class/pwm/pwmchip0/export : echo 0 > /sys/class/pwm/pwmchip0/export Questo creer\u00e0 il dispositivo /sys/class/pwm/pwmchip0/pwm0 nel filesystem. Il modo pi\u00f9 semplice per farlo \u00e8 aggiungerlo a /etc/rc.local prima della riga exit 0 . Con il sysfs a posto, potete ora utilizzare il canale o i canali pwm aggiungendo il seguente pezzo di configurazione al vostro printer.cfg : [output_pin caselight] pin: host:pwmchip0/pwm0 pwm: True hardware_pwm: True cycle_time: 0.000001 Questo aggiunger\u00e0 il controllo pwm hardware a gpio12 sul Pi (perch\u00e9 l'overlay \u00e8 stato configurato per instradare pwm0 a pin = 12). PWM0 pu\u00f2 essere indirizzato su gpio12 e gpio18, PWM1 pu\u00f2 essere indirizzato su gpio13 e gpio19: PWM gpio PIN Func 0 12 4 0 18 2 1 13 4 1 19 2","title":"Microcontrollore RPi"},{"location":"RPi_microcontroller.html#microcontrollore-rpi","text":"Questo documento descrive il processo di esecuzione di Klipper su un RPi e usa lo stesso RPi come mcu secondario.","title":"Microcontrollore RPi"},{"location":"RPi_microcontroller.html#perche-usare-rpi-come-mcu-secondario","text":"Spesso gli MCU dedicati al controllo delle stampanti 3D hanno un numero limitato e preconfigurato di pin esposti per gestire le principali funzioni di stampa (resistenze termiche, estrusori, stepper...). L'utilizzo dell'RPi dove Klipper \u00e8 installato come MCU secondario d\u00e0 la possibilit\u00e0 di utilizzare direttamente i GPIO e i bus (i2c, spi) dell'RPi all'interno di klipper senza utilizzare plugin Octoprint (se utilizzati) o programmi esterni dando la possibilit\u00e0 di controllare tutto all'interno del GCODE di stampa. Attenzione : Se la tua piattaforma \u00e8 un Beaglebone e hai seguito correttamente i passi di installazione, la mcu linux \u00e8 gi\u00e0 installata e configurata per il tuo sistema.","title":"Perch\u00e9 usare RPi come MCU secondario?"},{"location":"RPi_microcontroller.html#installa-lo-script-rc","text":"Se si desidera utilizzare l'host come MCU secondario, il processo di klipper_mcu deve essere eseguito prima del processo klippy. Dopo aver installato Klipper, installare lo script. eseguire: cd ~/klipper/ sudo cp ./scripts/klipper-mcu.service /etc/systemd/system/ sudo systemctl enable klipper-mcu.service","title":"Installa lo script rc"},{"location":"RPi_microcontroller.html#creazione-del-codice-del-microcontrollore","text":"Per compilare il codice del microcontrollore Klipper, iniziate configurandolo per il \"processo Linux\": cd ~/klipper/ make menuconfig Nel menu, impostate \"Microcontroller Architecture\" su \"Linux process\", poi salvate e uscite. Per compilare e installare il nuovo codice del microcontrollore, eseguire: sudo service klipper stop make flash sudo service klipper start Se klippy.log segnala un errore \"Autorizzazione negata\" quando si tenta di connettersi a /tmp/klipper_host_mcu , \u00e8 necessario aggiungere l'utente al gruppo tty. Il seguente comando aggiunger\u00e0 l'utente \"pi\" al gruppo tty: sudo usermod -a -G tty pi","title":"Creazione del codice del microcontrollore"},{"location":"RPi_microcontroller.html#configurazione-rimanente","text":"Completare l'installazione configurando l'MCU secondario di Klipper seguendo le istruzioni in RaspberryPi sample config e Multi MCU sample config .","title":"Configurazione rimanente"},{"location":"RPi_microcontroller.html#facoltativo-abilitazione-di-spi","text":"Assicurati che il driver SPI di Linux sia abilitato eseguendo sudo raspi-config e abilitando SPI nel menu \"Opzioni di interfaccia\".","title":"Facoltativo: abilitazione di SPI"},{"location":"RPi_microcontroller.html#opzionale-abilitazione-di-i2c","text":"Assicurati che l'interfaccia Linux I2C sia abilitato eseguendo sudo raspi-config e abilitando I2C nel menu \"Opzioni di interfaccia\". Se si intende utilizzare I2C per l'accelerometro MPU, \u00e8 anche necessario impostare il baud rate su 400000: aggiungendo/deselezionando dtparam=i2c_arm=on,i2c_arm_baudrate=400000 in /boot/config.txt (o / boot/firmware/config.txt in alcune distribuzioni).","title":"Opzionale: abilitazione di I2C"},{"location":"RPi_microcontroller.html#opzionale-identificare-il-gpiochip-corretto","text":"Su Raspberry Pi e su molti cloni i pin esposti sul GPIO appartengono al primo gpiochip. Possono quindi essere utilizzati su klipper semplicemente riferendoli con il nome gpio0..n . Tuttavia, ci sono casi in cui i pin esposti appartengono a gpiochip diversi dal primo. Ad esempio nel caso di alcuni modelli OrangePi o se viene utilizzato un Port Expander. In questi casi \u00e8 utile utilizzare i comandi per accedere al dispositivo a caratteri GPIO Linux per verificarne la configurazione. Per installare il Linux GPIO character device - binary su una distro basata su debian come octopi eseguire: sudo apt-get install gpiod Per controllare i gpiochip disponibili eseguire: gpiodetect Per verificare il numero di pin e la disponibilit\u00e0 dei pin: gpioinfo Il pin scelto pu\u00f2 quindi essere utilizzato all'interno della configurazione come gpiochip<n>/gpio<o> dove n \u00e8 il numero del chip visto dal comando gpiodetect e o \u00e8 il numero di riga visto dal comando gpioinfo . Attenzione: solo i gpio contrassegnati come inutilizzati possono essere utilizzati. Non \u00e8 possibile che una linea sia usata da pi\u00f9 processi contemporaneamente. Per esempio su un RPi 3B+ dove klipper usa il GPIO20 per un interruttore: $ gpiodetect gpiochip0 [pinctrl-bcm2835] (54 lines) gpiochip1 [raspberrypi-exp-gpio] (8 lines) $ gpioinfo gpiochip0 - 54 lines: line 0: unnamed unused input active-high line 1: unnamed unused input active-high line 2: unnamed unused input active-high line 3: unnamed unused input active-high line 4: unnamed unused input active-high line 5: unnamed unused input active-high line 6: unnamed unused input active-high line 7: unnamed unused input active-high line 8: unnamed unused input active-high line 9: unnamed unused input active-high line 10: unnamed unused input active-high line 11: unnamed unused input active-high line 12: unnamed unused input active-high line 13: unnamed unused input active-high line 14: unnamed unused input active-high line 15: unnamed unused input active-high line 16: unnamed unused input active-high line 17: unnamed unused input active-high line 18: unnamed unused input active-high line 19: unnamed unused input active-high line 20: unnamed \"klipper\" output active-high [used] line 21: unnamed unused input active-high line 22: unnamed unused input active-high line 23: unnamed unused input active-high line 24: unnamed unused input active-high line 25: unnamed unused input active-high line 26: unnamed unused input active-high line 27: unnamed unused input active-high line 28: unnamed unused input active-high line 29: unnamed \"led0\" output active-high [used] line 30: unnamed unused input active-high line 31: unnamed unused input active-high line 32: unnamed unused input active-high line 33: unnamed unused input active-high line 34: unnamed unused input active-high line 35: unnamed unused input active-high line 36: unnamed unused input active-high line 37: unnamed unused input active-high line 38: unnamed unused input active-high line 39: unnamed unused input active-high line 40: unnamed unused input active-high line 41: unnamed unused input active-high line 42: unnamed unused input active-high line 43: unnamed unused input active-high line 44: unnamed unused input active-high line 45: unnamed unused input active-high line 46: unnamed unused input active-high line 47: unnamed unused input active-high line 48: unnamed unused input active-high line 49: unnamed unused input active-high line 50: unnamed unused input active-high line 51: unnamed unused input active-high line 52: unnamed unused input active-high line 53: unnamed unused input active-high gpiochip1 - 8 lines: line 0: unnamed unused input active-high line 1: unnamed unused input active-high line 2: unnamed \"led1\" output active-low [used] line 3: unnamed unused input active-high line 4: unnamed unused input active-high line 5: unnamed unused input active-high line 6: unnamed unused input active-high line 7: unnamed unused input active-high","title":"Opzionale: Identificare il gpiochip corretto"},{"location":"RPi_microcontroller.html#opzionale-hardware-pwm","text":"I Raspberry Pi hanno due canali PWM (PWM0 e PWM1) che sono esposti sull'intestazione o, in caso contrario, possono essere instradati ai pin gpio esistenti. Il demone mcu Linux utilizza l'interfaccia sysfs pwmchip per controllare i dispositivi hardware pwm sugli host Linux. L'interfaccia sysfs pwm non \u00e8 esposta per impostazione predefinita su un Raspberry e pu\u00f2 essere attivata aggiungendo una riga a /boot/config.txt : # Abilita l'interfaccia sysfs di pwmchip dtoverlay=pwm,pin=12,func=4 Questo esempio abilita solo PWM0 e lo indirizza a gpio12. Se entrambi i canali PWM devono essere abilitati potete usare pwm-2chan . L'overlay non espone la riga pwm sui sysfs all'avvio e deve essere esportata facendo eco al numero del canale pwm in /sys/class/pwm/pwmchip0/export : echo 0 > /sys/class/pwm/pwmchip0/export Questo creer\u00e0 il dispositivo /sys/class/pwm/pwmchip0/pwm0 nel filesystem. Il modo pi\u00f9 semplice per farlo \u00e8 aggiungerlo a /etc/rc.local prima della riga exit 0 . Con il sysfs a posto, potete ora utilizzare il canale o i canali pwm aggiungendo il seguente pezzo di configurazione al vostro printer.cfg : [output_pin caselight] pin: host:pwmchip0/pwm0 pwm: True hardware_pwm: True cycle_time: 0.000001 Questo aggiunger\u00e0 il controllo pwm hardware a gpio12 sul Pi (perch\u00e9 l'overlay \u00e8 stato configurato per instradare pwm0 a pin = 12). PWM0 pu\u00f2 essere indirizzato su gpio12 e gpio18, PWM1 pu\u00f2 essere indirizzato su gpio13 e gpio19: PWM gpio PIN Func 0 12 4 0 18 2 1 13 4 1 19 2","title":"Opzionale: Hardware PWM"},{"location":"Releases.html","text":"Versioni \u00b6 Storico delle versioni di Klipper. Vedi installation per informazioni sull'installazione di Klipper. Klipper 0.11.0 \u00b6 Disponibile su 20221128. Modifiche principali in questa versione: Ottimizzazione \"passo su entrambi i lati\" del driver del motore passo-passo Trinamic. Supporto per Python3. Il codice host di Klipper verr\u00e0 eseguito con Python2 o Python3. Supporto bus CAN migliorato. Supporto per bus CAN su chip rp2040, stm32g0, stm32h7, same51 e same54. Supporto per la modalit\u00e0 \"Bridge da USB a CAN bus\". Supporto per il bootloader CanBoot. Supporto per accelerometri mpu9250 e mpu6050. Gestione degli errori migliorata per i sensori di temperatura max31856, max31855, max31865 e max6675. Ora \u00e8 possibile configurare i LED per l'aggiornamento durante i comandi G-Code di lunga durata utilizzando il supporto del \"template\" LED. Diversi miglioramenti del microcontrollore. Nuovo supporto per i chip stm32h743, stm32h750, stm32l412, stm32g0b1, same70, same51 e same54. Supporto per letture i2c su atsamd e stm32f0. Supporto hardware pwm su stm32. Invio di eventi basato sul segnale Linux mcu. Nuovo supporto rp2040 per \"make flash\", i2c ed errata USB rp2040-e5. Aggiunti nuovi moduli: angle, dac084S085, exclude_object, led, mpu9250, pca9632, smart_effector, z_thermal_adjust. Aggiunta nuova cinematica deltesiana. Nuovo strumento dump_mcu aggiunto. Correzione di diversi bug e pulizia del codice. Klipper 0.10.0 \u00b6 Disponibile su 20210929. Principali modifiche in questa versione: Supporto per \"Homing multi-MCU\". \u00c8 ora possibile collegare un motore passo-passo e il relativo fine corsa a microcontrollori separati. Ci\u00f2 semplifica il cablaggio delle sonde Z sulle \"schede portautensili\". Klipper ora ha un Community Discord Server e un Community Discourse Server . Il sito Web di Klipper ora utilizza l'infrastruttura \"mkdocs\". Esiste anche un progetto Klipper Translations . Supporto automatizzato per il flashing del firmware tramite sdcard su molte schede. Nuovo supporto cinematico per le stampanti \"Hybrid CoreXY\" e \"Hybrid CoreXZ\". Klipper ora usa rotation_distance per configurare le distanze di viaggio del motore passo-passo. Il codice host principale di Klipper ora pu\u00f2 comunicare direttamente con i microcontrollori utilizzando il bus CAN. Nuovo sistema di \"analisi del movimento\". Gli aggiornamenti di movimento interni di Klipper e i risultati dei sensori possono essere tracciati e registrati per l'analisi. I driver per motori passo-passo Trinamic sono ora costantemente monitorati per rilevare eventuali condizioni di errore. Supporto per il microcontrollore rp2040 (schede Raspberry Pi Pico). Il sistema \"make menuconfig\" ora utilizza kconfiglib. Molti moduli aggiuntivi aggiunti: ds18b20, duplicate_pin_override, filament_motion_sensor, palette2, motion_report, pca9533, pulse_counter, save_variables, sdcard_loop, temperature_host, temperature_mcu Correzione di diversi bug e pulizia del codice. Klipper 0.9.0 \u00b6 Disponibile su 20201020. Modifiche principali in questa versione: Supporto per \"Input Shaping\" - un meccanismo per contrastare la risonanza della stampante. Pu\u00f2 ridurre o eliminare il \"ringing\" nelle stampe. Nuovo sistema \"Smooth Pressure Advance\". Questo implementa \"Pressure Advance\" senza introdurre variazioni di velocit\u00e0 istantanee. Ora \u00e8 anche possibile regolare l'anticipo della pressione utilizzando un metodo \"Tuning Tower\". Nuovo server API \"webhook\". Ci\u00f2 fornisce un'interfaccia JSON programmabile a Klipper. Il display LCD e il menu sono ora configurabili utilizzando la lingua del modello Jinja2. I driver per motori passo-passo TMC2208 possono ora essere utilizzati in modalit\u00e0 \"standalone\" con Klipper. Supporto BL-Touch v3 migliorato. Identificazione USB migliorata. Klipper ora ha il proprio codice di identificazione USB e i microcontrollori possono ora riportare i loro numeri di serie univoci durante l'identificazione USB. Nuovo supporto cinematico per stampanti \"Rotary Delta\" e \"CoreXZ\". Miglioramenti del microcontrollore: supporto per stm32f070, supporto per stm32f207, supporto per pin GPIO su \"Linux MCU\", supporto per \"bootloader HID\" stm32, supporto per bootloader Chitu, supporto per bootloader MKS Robin. Gestione migliorata degli eventi di \"garbage collection\" di Python. Molti moduli aggiuntivi aggiunti: adc_scaled, adxl345, bme280, display_status, extruder_stepper, fan_generic, hall_filament_width_sensor, htu21d, homing_heaters, input_shaper, lm75, print_stats, resonance_tester, shaper_calibrate, query_adc, graph_accelerometer, graph_extruder, graph_motion, graph_shaper, graph_temp_sensor, whconsole Correzione di diversi bug e pulizia del codice. Klipper 0.9.1 \u00b6 Disponibile su 20201028. Versione contenente solo correzioni di bug. Klipper 0.8.0 \u00b6 Disponibile su 20191021. Modifiche principali in questa versione: Nuovo supporto per il modello dei comandi G-Code. Il G-Code nel file di configurazione viene ora valutato con il linguaggio dei template Jinja2. Miglioramenti ai driver per stepper Trinamic: Nuovo supporto per i driver TMC2209 e TMC5160. Migliorati i comandi G-Code DUMP_TMC, SET_TMC_CURRENT e INIT_TMC. Supporto migliorato per la gestione di TMC UART con un mux analogico. Supporto migliorato per homing, sonda e livellamento del piatto: Aggiunti nuovi moduli manual_probe, bed_screws, Screws_tilt_adjust, skew_correction, safe_z_home. Sondaggio multi-campione migliorato con logica mediana, media e tentativi. Documentazione migliorata per BL-Touch, calibrazione della sonda, calibrazione endstop, calibrazione delta, homing sensorless e calibrazione della fase finecorsa. Supporto della corsa di riferimento migliorato su un asse Z grande. Molti miglioramenti del microcontrollore Klipper: Klipper portato su: SAM3X8C, SAM4S8C, SAMD51, STM32F042, STM32F4 Nuove implementazioni del driver CDC USB su SAM3X, SAM4, STM32F4. Supporto avanzato per il flashing di Klipper su USB. Supporto SPI software. Filtraggio della temperatura notevolmente migliorato sull'LPC176x. Le impostazioni dei pin di uscita possono essere configurate nel microcontrollore. Nuovo sito web con la documentazione di Klipper: http://klipper3d.org/ Klipper ora ha un logo. Supporto sperimentale alla cinematica polare e \"cable winch\". Il file di configurazione ora pu\u00f2 includere altri file di configurazione. Molti moduli aggiuntivi aggiunti: board_pins, controller_fan, delay_gcode, dotstar, filament_switch_sensor, firmware_retraction, gcode_arcs, gcode_button, heater_generic, manual_stepper, mcp4018, mcp4728, neopixel, pause_resume, respond, temperature_sensor tsl1401cl_filament_width_sensor, tuning_tower Molti comandi aggiuntivi aggiunti: RESTORE_GCODE_STATE, SAVE_GCODE_STATE, SET_GCODE_VARIABLE, SET_HEATER_TEMPERATURE, SET_IDLE_TIMEOUT, SET_TEMPERATURE_FAN_TARGET Correzione di diversi bug e pulizia del codice. Klipper 0.7.0 \u00b6 Disponibile su 20181220. Modifiche principali in questa versione: Klipper ora supporta il livellamento del piatto \"mesh\" Nuovo supporto per la calibrazione delta \"potenziata\" (calibra le dimensioni x/y di stampa su stampanti delta) Supporto per la configurazione a runtime dei driver per motori passo-passo Trinamic (tmc2130, tmc2208, tmc2660) Migliorato il supporto del sensore di temperatura: MAX6675, MAX31855, MAX31856, MAX31865, termistori personalizzati, sensori stile pt100 comuni Diversi nuovi moduli: temperature_fan, sx1509, force_move, mcp4451, z_tilt, quad_gantry_level, endstop_phase, bltouch Aggiunti diversi nuovi comandi: SAVE_CONFIG, SET_PRESSURE_ADVANCE, SET_GCODE_OFFSET, SET_VELOCITY_LIMIT, STEPPER_BUZZ, TURN_OFF_HEATERS, M204, macro g-code personalizzate Supporto display LCD esteso: Supporto per i menu a runtime Nuove icone di visualizzazione Supporto per i display \"uc1701\" e \"ssd1306\" Supporto per microcontrollore aggiuntivo: Klipper portato su: LPC176x (Smoothieboards), SAM4E8E (Duet2), SAMD21 (Arduino Zero), STM32F103 (dispositivi \"blue pill\"), atmega32u4 Nuovo driver USB CDC generico implementato su AVR, LPC176x, SAMD21 e STM32F103 Miglioramenti delle prestazioni sui processori ARM Il codice della cinematica \u00e8 stato riscritto per utilizzare un \"risolutore iterativo\" Nuovi test case automatici per il software host Klipper Molti nuovi file di configurazione di esempio per le stampanti standard comuni Aggiornamenti della documentazione per bootloader, benchmarking, porting del microcontroller, controlli di configurazione, mappatura dei pin, impostazioni dello slicer, packaging e altro ancora Diverse correzioni di bug e pulizia del codice Klipper 0.6.0 \u00b6 Disponibile su 20180331. Modifiche principali in questa versione: Controlli avanzati dei guasti hardware del riscaldatore e del termistore Supporto per sonde Z Supporto iniziale per la calibrazione automatica dei parametri sulle delta (tramite un nuovo comando delta_calibrate) Supporto iniziale per la compensazione dell'inclinazione del piatto (tramite il comando bed_tilt_calibrate) Supporto iniziale per \"homing sicuro\" e di homing overrides Supporto iniziale per la visualizzazione dello stato sui display RepRapDiscount stile 2004 e 12864 Nuovi miglioramenti multi-estrusore: Supporto per riscaldatori condivisi Supporto iniziale per carrelli doppi Supporto per la configurazione di pi\u00f9 stepper per asse (ad es. doppia Z) Supporto per pin di output digitali e pwm personalizzati (con un nuovo comando SET_PIN) Supporto iniziale per una \"sdcard virtuale\" che consente di stampare direttamente da Klipper (aiuta su macchine troppo lente per eseguire bene OctoPrint) Supporto per impostare diverse lunghezze del braccio su ciascuna torre di una delta Supporto per i comandi G-Code M220/M221 (override del fattore di velocit\u00e0/override del fattore di estrusione) Diversi aggiornamenti della documentazione: Molti nuovi file di configurazione di esempio per le stampanti standard comuni Nuovo esempio di configurazione di MCU multipli Nuovo esempio di configurazione del sensore bltouch Nuove FAQ, controllo della configurazione e documenti G-Code Supporto iniziale per test di integrazione continui su tutti i commit di github Diverse correzioni di bug e pulizia del codice Klipper 0.5.0 \u00b6 Disponibile su 20171025. Modifiche principali in questa versione: Supporto per stampanti con pi\u00f9 estrusori. Supporto iniziale per l'esecuzione su Beaglebone PRU. Supporto iniziale per la scheda Replicape. Supporto iniziale per l'esecuzione del codice del microcontrollore in un processo Linux in tempo reale. Supporto per microcontrollori multipli. (Ad esempio, si potrebbe controllare un estrusore con un microcontrollore e il resto della stampante con un altro.) La sincronizzazione dell'orologio del software \u00e8 implementata per coordinare le azioni tra i microcontrollori. Miglioramenti delle prestazioni stepper (AVR da 20 Mhz fino a 189.000 passi al secondo). Supporto per il controllo dei servocomandi e supporto per la definizione delle ventole di raffreddamento degli ugelli. Diverse correzioni di bug e pulizia del codice Klipper 0.4.0 \u00b6 Disponibile su 20170503. Modifiche principali in questa versione: Installazione migliorata su macchine Raspberry Pi. La maggior parte dell'installazione \u00e8 ora basata su script. Supporto per la cinematica corexy Aggiornamenti della documentazione: nuovo documento Cinematica, nuova guida all'ottimizzazione di Pressure Advance, nuovi file di configurazione di esempio e altro ancora Miglioramenti delle prestazioni dello stepper (AVR da 20 Mhz su 175.000 passi al secondo, Arduino Due oltre 460.000) Supporto per il ripristino automatico del microcontrollore. Supporto per il ripristino tramite l'attivazione dell'alimentazione USB su Raspberry Pi. L'algoritmo di avanzamento della pressione ora funziona con il look-ahead per ridurre le variazioni di pressione in curva. Supporto per limitare la velocit\u00e0 massima di brevi movimenti a zigzag Supporto per sensori AD595 Diverse correzioni di bug e pulizia del codice Klipper 0.3.0 \u00b6 Disponibile su 20161223. Modifiche principali in questa versione: Documentazione migliorata Supporto per robot con cinematica delta Supporto per microcontrollore Arduino Due (ARM cortex-M3) Supporto USB per microcontrollori basati su AVR Supporto per l'algoritmo di \"pressure advance\": riduce la trasudazione durante le stampe. Nuova funzione \"stopper phased based\" - consente una maggiore precisione sull'homing. Supporto per comandi \"extended g-code\" come \"help\", \"restart\" e \"status\". Supporto per ricaricare la configurazione di Klipper e riavviare il software host emettendo un comando di \"restart\" dal terminale. Miglioramenti delle prestazioni stepper (AVR da 20 Mhz fino a 158.000 passi al secondo). Segnalazione errori migliorata. La maggior parte degli errori ora viene mostrata tramite il terminale insieme all'aiuto su come risolverli. Diverse correzioni di bug e pulizia del codice Klipper 0.2.0 \u00b6 Rilascio iniziale di Klipper. Disponibile su 20160525. Le principali funzionalit\u00e0 disponibili nella versione iniziale includono: Supporto di base per stampanti cartesiane (stepper, estrusore, piatto riscaldato, ventola di raffreddamento). Supporto per i comandi g-code comuni. Supporto per interfacciarsi con OctoPrint. Accelerazione e gestione lookahead Supporto per microcontrollori AVR tramite porte seriali standard","title":"Versioni"},{"location":"Releases.html#versioni","text":"Storico delle versioni di Klipper. Vedi installation per informazioni sull'installazione di Klipper.","title":"Versioni"},{"location":"Releases.html#klipper-0110","text":"Disponibile su 20221128. Modifiche principali in questa versione: Ottimizzazione \"passo su entrambi i lati\" del driver del motore passo-passo Trinamic. Supporto per Python3. Il codice host di Klipper verr\u00e0 eseguito con Python2 o Python3. Supporto bus CAN migliorato. Supporto per bus CAN su chip rp2040, stm32g0, stm32h7, same51 e same54. Supporto per la modalit\u00e0 \"Bridge da USB a CAN bus\". Supporto per il bootloader CanBoot. Supporto per accelerometri mpu9250 e mpu6050. Gestione degli errori migliorata per i sensori di temperatura max31856, max31855, max31865 e max6675. Ora \u00e8 possibile configurare i LED per l'aggiornamento durante i comandi G-Code di lunga durata utilizzando il supporto del \"template\" LED. Diversi miglioramenti del microcontrollore. Nuovo supporto per i chip stm32h743, stm32h750, stm32l412, stm32g0b1, same70, same51 e same54. Supporto per letture i2c su atsamd e stm32f0. Supporto hardware pwm su stm32. Invio di eventi basato sul segnale Linux mcu. Nuovo supporto rp2040 per \"make flash\", i2c ed errata USB rp2040-e5. Aggiunti nuovi moduli: angle, dac084S085, exclude_object, led, mpu9250, pca9632, smart_effector, z_thermal_adjust. Aggiunta nuova cinematica deltesiana. Nuovo strumento dump_mcu aggiunto. Correzione di diversi bug e pulizia del codice.","title":"Klipper 0.11.0"},{"location":"Releases.html#klipper-0100","text":"Disponibile su 20210929. Principali modifiche in questa versione: Supporto per \"Homing multi-MCU\". \u00c8 ora possibile collegare un motore passo-passo e il relativo fine corsa a microcontrollori separati. Ci\u00f2 semplifica il cablaggio delle sonde Z sulle \"schede portautensili\". Klipper ora ha un Community Discord Server e un Community Discourse Server . Il sito Web di Klipper ora utilizza l'infrastruttura \"mkdocs\". Esiste anche un progetto Klipper Translations . Supporto automatizzato per il flashing del firmware tramite sdcard su molte schede. Nuovo supporto cinematico per le stampanti \"Hybrid CoreXY\" e \"Hybrid CoreXZ\". Klipper ora usa rotation_distance per configurare le distanze di viaggio del motore passo-passo. Il codice host principale di Klipper ora pu\u00f2 comunicare direttamente con i microcontrollori utilizzando il bus CAN. Nuovo sistema di \"analisi del movimento\". Gli aggiornamenti di movimento interni di Klipper e i risultati dei sensori possono essere tracciati e registrati per l'analisi. I driver per motori passo-passo Trinamic sono ora costantemente monitorati per rilevare eventuali condizioni di errore. Supporto per il microcontrollore rp2040 (schede Raspberry Pi Pico). Il sistema \"make menuconfig\" ora utilizza kconfiglib. Molti moduli aggiuntivi aggiunti: ds18b20, duplicate_pin_override, filament_motion_sensor, palette2, motion_report, pca9533, pulse_counter, save_variables, sdcard_loop, temperature_host, temperature_mcu Correzione di diversi bug e pulizia del codice.","title":"Klipper 0.10.0"},{"location":"Releases.html#klipper-090","text":"Disponibile su 20201020. Modifiche principali in questa versione: Supporto per \"Input Shaping\" - un meccanismo per contrastare la risonanza della stampante. Pu\u00f2 ridurre o eliminare il \"ringing\" nelle stampe. Nuovo sistema \"Smooth Pressure Advance\". Questo implementa \"Pressure Advance\" senza introdurre variazioni di velocit\u00e0 istantanee. Ora \u00e8 anche possibile regolare l'anticipo della pressione utilizzando un metodo \"Tuning Tower\". Nuovo server API \"webhook\". Ci\u00f2 fornisce un'interfaccia JSON programmabile a Klipper. Il display LCD e il menu sono ora configurabili utilizzando la lingua del modello Jinja2. I driver per motori passo-passo TMC2208 possono ora essere utilizzati in modalit\u00e0 \"standalone\" con Klipper. Supporto BL-Touch v3 migliorato. Identificazione USB migliorata. Klipper ora ha il proprio codice di identificazione USB e i microcontrollori possono ora riportare i loro numeri di serie univoci durante l'identificazione USB. Nuovo supporto cinematico per stampanti \"Rotary Delta\" e \"CoreXZ\". Miglioramenti del microcontrollore: supporto per stm32f070, supporto per stm32f207, supporto per pin GPIO su \"Linux MCU\", supporto per \"bootloader HID\" stm32, supporto per bootloader Chitu, supporto per bootloader MKS Robin. Gestione migliorata degli eventi di \"garbage collection\" di Python. Molti moduli aggiuntivi aggiunti: adc_scaled, adxl345, bme280, display_status, extruder_stepper, fan_generic, hall_filament_width_sensor, htu21d, homing_heaters, input_shaper, lm75, print_stats, resonance_tester, shaper_calibrate, query_adc, graph_accelerometer, graph_extruder, graph_motion, graph_shaper, graph_temp_sensor, whconsole Correzione di diversi bug e pulizia del codice.","title":"Klipper 0.9.0"},{"location":"Releases.html#klipper-091","text":"Disponibile su 20201028. Versione contenente solo correzioni di bug.","title":"Klipper 0.9.1"},{"location":"Releases.html#klipper-080","text":"Disponibile su 20191021. Modifiche principali in questa versione: Nuovo supporto per il modello dei comandi G-Code. Il G-Code nel file di configurazione viene ora valutato con il linguaggio dei template Jinja2. Miglioramenti ai driver per stepper Trinamic: Nuovo supporto per i driver TMC2209 e TMC5160. Migliorati i comandi G-Code DUMP_TMC, SET_TMC_CURRENT e INIT_TMC. Supporto migliorato per la gestione di TMC UART con un mux analogico. Supporto migliorato per homing, sonda e livellamento del piatto: Aggiunti nuovi moduli manual_probe, bed_screws, Screws_tilt_adjust, skew_correction, safe_z_home. Sondaggio multi-campione migliorato con logica mediana, media e tentativi. Documentazione migliorata per BL-Touch, calibrazione della sonda, calibrazione endstop, calibrazione delta, homing sensorless e calibrazione della fase finecorsa. Supporto della corsa di riferimento migliorato su un asse Z grande. Molti miglioramenti del microcontrollore Klipper: Klipper portato su: SAM3X8C, SAM4S8C, SAMD51, STM32F042, STM32F4 Nuove implementazioni del driver CDC USB su SAM3X, SAM4, STM32F4. Supporto avanzato per il flashing di Klipper su USB. Supporto SPI software. Filtraggio della temperatura notevolmente migliorato sull'LPC176x. Le impostazioni dei pin di uscita possono essere configurate nel microcontrollore. Nuovo sito web con la documentazione di Klipper: http://klipper3d.org/ Klipper ora ha un logo. Supporto sperimentale alla cinematica polare e \"cable winch\". Il file di configurazione ora pu\u00f2 includere altri file di configurazione. Molti moduli aggiuntivi aggiunti: board_pins, controller_fan, delay_gcode, dotstar, filament_switch_sensor, firmware_retraction, gcode_arcs, gcode_button, heater_generic, manual_stepper, mcp4018, mcp4728, neopixel, pause_resume, respond, temperature_sensor tsl1401cl_filament_width_sensor, tuning_tower Molti comandi aggiuntivi aggiunti: RESTORE_GCODE_STATE, SAVE_GCODE_STATE, SET_GCODE_VARIABLE, SET_HEATER_TEMPERATURE, SET_IDLE_TIMEOUT, SET_TEMPERATURE_FAN_TARGET Correzione di diversi bug e pulizia del codice.","title":"Klipper 0.8.0"},{"location":"Releases.html#klipper-070","text":"Disponibile su 20181220. Modifiche principali in questa versione: Klipper ora supporta il livellamento del piatto \"mesh\" Nuovo supporto per la calibrazione delta \"potenziata\" (calibra le dimensioni x/y di stampa su stampanti delta) Supporto per la configurazione a runtime dei driver per motori passo-passo Trinamic (tmc2130, tmc2208, tmc2660) Migliorato il supporto del sensore di temperatura: MAX6675, MAX31855, MAX31856, MAX31865, termistori personalizzati, sensori stile pt100 comuni Diversi nuovi moduli: temperature_fan, sx1509, force_move, mcp4451, z_tilt, quad_gantry_level, endstop_phase, bltouch Aggiunti diversi nuovi comandi: SAVE_CONFIG, SET_PRESSURE_ADVANCE, SET_GCODE_OFFSET, SET_VELOCITY_LIMIT, STEPPER_BUZZ, TURN_OFF_HEATERS, M204, macro g-code personalizzate Supporto display LCD esteso: Supporto per i menu a runtime Nuove icone di visualizzazione Supporto per i display \"uc1701\" e \"ssd1306\" Supporto per microcontrollore aggiuntivo: Klipper portato su: LPC176x (Smoothieboards), SAM4E8E (Duet2), SAMD21 (Arduino Zero), STM32F103 (dispositivi \"blue pill\"), atmega32u4 Nuovo driver USB CDC generico implementato su AVR, LPC176x, SAMD21 e STM32F103 Miglioramenti delle prestazioni sui processori ARM Il codice della cinematica \u00e8 stato riscritto per utilizzare un \"risolutore iterativo\" Nuovi test case automatici per il software host Klipper Molti nuovi file di configurazione di esempio per le stampanti standard comuni Aggiornamenti della documentazione per bootloader, benchmarking, porting del microcontroller, controlli di configurazione, mappatura dei pin, impostazioni dello slicer, packaging e altro ancora Diverse correzioni di bug e pulizia del codice","title":"Klipper 0.7.0"},{"location":"Releases.html#klipper-060","text":"Disponibile su 20180331. Modifiche principali in questa versione: Controlli avanzati dei guasti hardware del riscaldatore e del termistore Supporto per sonde Z Supporto iniziale per la calibrazione automatica dei parametri sulle delta (tramite un nuovo comando delta_calibrate) Supporto iniziale per la compensazione dell'inclinazione del piatto (tramite il comando bed_tilt_calibrate) Supporto iniziale per \"homing sicuro\" e di homing overrides Supporto iniziale per la visualizzazione dello stato sui display RepRapDiscount stile 2004 e 12864 Nuovi miglioramenti multi-estrusore: Supporto per riscaldatori condivisi Supporto iniziale per carrelli doppi Supporto per la configurazione di pi\u00f9 stepper per asse (ad es. doppia Z) Supporto per pin di output digitali e pwm personalizzati (con un nuovo comando SET_PIN) Supporto iniziale per una \"sdcard virtuale\" che consente di stampare direttamente da Klipper (aiuta su macchine troppo lente per eseguire bene OctoPrint) Supporto per impostare diverse lunghezze del braccio su ciascuna torre di una delta Supporto per i comandi G-Code M220/M221 (override del fattore di velocit\u00e0/override del fattore di estrusione) Diversi aggiornamenti della documentazione: Molti nuovi file di configurazione di esempio per le stampanti standard comuni Nuovo esempio di configurazione di MCU multipli Nuovo esempio di configurazione del sensore bltouch Nuove FAQ, controllo della configurazione e documenti G-Code Supporto iniziale per test di integrazione continui su tutti i commit di github Diverse correzioni di bug e pulizia del codice","title":"Klipper 0.6.0"},{"location":"Releases.html#klipper-050","text":"Disponibile su 20171025. Modifiche principali in questa versione: Supporto per stampanti con pi\u00f9 estrusori. Supporto iniziale per l'esecuzione su Beaglebone PRU. Supporto iniziale per la scheda Replicape. Supporto iniziale per l'esecuzione del codice del microcontrollore in un processo Linux in tempo reale. Supporto per microcontrollori multipli. (Ad esempio, si potrebbe controllare un estrusore con un microcontrollore e il resto della stampante con un altro.) La sincronizzazione dell'orologio del software \u00e8 implementata per coordinare le azioni tra i microcontrollori. Miglioramenti delle prestazioni stepper (AVR da 20 Mhz fino a 189.000 passi al secondo). Supporto per il controllo dei servocomandi e supporto per la definizione delle ventole di raffreddamento degli ugelli. Diverse correzioni di bug e pulizia del codice","title":"Klipper 0.5.0"},{"location":"Releases.html#klipper-040","text":"Disponibile su 20170503. Modifiche principali in questa versione: Installazione migliorata su macchine Raspberry Pi. La maggior parte dell'installazione \u00e8 ora basata su script. Supporto per la cinematica corexy Aggiornamenti della documentazione: nuovo documento Cinematica, nuova guida all'ottimizzazione di Pressure Advance, nuovi file di configurazione di esempio e altro ancora Miglioramenti delle prestazioni dello stepper (AVR da 20 Mhz su 175.000 passi al secondo, Arduino Due oltre 460.000) Supporto per il ripristino automatico del microcontrollore. Supporto per il ripristino tramite l'attivazione dell'alimentazione USB su Raspberry Pi. L'algoritmo di avanzamento della pressione ora funziona con il look-ahead per ridurre le variazioni di pressione in curva. Supporto per limitare la velocit\u00e0 massima di brevi movimenti a zigzag Supporto per sensori AD595 Diverse correzioni di bug e pulizia del codice","title":"Klipper 0.4.0"},{"location":"Releases.html#klipper-030","text":"Disponibile su 20161223. Modifiche principali in questa versione: Documentazione migliorata Supporto per robot con cinematica delta Supporto per microcontrollore Arduino Due (ARM cortex-M3) Supporto USB per microcontrollori basati su AVR Supporto per l'algoritmo di \"pressure advance\": riduce la trasudazione durante le stampe. Nuova funzione \"stopper phased based\" - consente una maggiore precisione sull'homing. Supporto per comandi \"extended g-code\" come \"help\", \"restart\" e \"status\". Supporto per ricaricare la configurazione di Klipper e riavviare il software host emettendo un comando di \"restart\" dal terminale. Miglioramenti delle prestazioni stepper (AVR da 20 Mhz fino a 158.000 passi al secondo). Segnalazione errori migliorata. La maggior parte degli errori ora viene mostrata tramite il terminale insieme all'aiuto su come risolverli. Diverse correzioni di bug e pulizia del codice","title":"Klipper 0.3.0"},{"location":"Releases.html#klipper-020","text":"Rilascio iniziale di Klipper. Disponibile su 20160525. Le principali funzionalit\u00e0 disponibili nella versione iniziale includono: Supporto di base per stampanti cartesiane (stepper, estrusore, piatto riscaldato, ventola di raffreddamento). Supporto per i comandi g-code comuni. Supporto per interfacciarsi con OctoPrint. Accelerazione e gestione lookahead Supporto per microcontrollori AVR tramite porte seriali standard","title":"Klipper 0.2.0"},{"location":"Resonance_Compensation.html","text":"Compensazione della risonanza \u00b6 Klipper supporta Input Shaping, una tecnica che pu\u00f2 essere utilizzata per ridurre il ringing (noti anche come echoing, ghosting o increspature) nelle stampe. Il ringing \u00e8 un difetto di stampa della superficie quando, in genere, elementi come i bordi si ripetono su una superficie stampata come un sottile \"eco\": | | | I ringing sono causati da vibrazioni meccaniche nella stampante dovute a rapidi cambiamenti della direzione di stampa. Si noti che il ringing di solito ha origini meccaniche: telaio della stampante non sufficientemente rigido, cinghie non tese o troppo elastiche, problemi di allineamento delle parti meccaniche, massa in movimento pesante, ecc. Questi dovrebbero essere prima controllati e riparati, se possibile. Input shaping \u00e8 una tecnica di controllo ad anello aperto che crea un segnale di comando che annulla le proprie vibrazioni. La modellatura dell'ingresso richiede alcune regolazioni e misurazioni prima di poter essere abilitata. Oltre al ringing, Input Shaping riduce in genere le vibrazioni e le vibrazioni della stampante in generale e pu\u00f2 anche migliorare l'affidabilit\u00e0 della modalit\u00e0 StealthChop dei driver stepper Trinamic. Messa a punto \u00b6 La regolazione di base richiede la misurazione delle frequenze di ringing della stampante stampando un modello di prova. Carica il modello di prova per il ringing, che pu\u00f2 essere trovato in docs/prints/ringing_tower.stl , nello slicer: L'altezza dello strato (layer) consigliata \u00e8 0,2 o 0,25 mm. I livelli di riempimento e superiori possono essere impostati su 0. Usa 1-2 perimetri, o meglio ancora la modalit\u00e0 vaso liscio con base da 1-2 mm. Utilizzare velocit\u00e0 sufficientemente elevate, circa 80-100 mm/sec, per i perimetri esterni . Assicurati che il tempo minimo per lo strato sia al massimo 3 secondi. Assicurati che qualsiasi \"controllo dinamico dell'accelerazione\" sia disabilitato nello slicer. Non girare il modello. Il modello ha segni X e Y sul retro del modello. Nota la posizione insolita dei segni rispetto agli assi della stampante: non \u00e8 un errore. I contrassegni possono essere utilizzati successivamente nel processo di ottimizzazione come riferimento, poich\u00e9 mostrano a quale asse corrispondono le misurazioni. Frequenza di ringing \u00b6 Innanzitutto, misura la frequenza di ringing . Se il parametro square_corner_velocity \u00e8 stato modificato, ripristinalo a 5.0 . Non \u00e8 consigliabile aumentarlo quando si utilizza l'input shaper perch\u00e9 pu\u00f2 causare un maggiore smussamento smoothing delle parti: \u00e8 invece meglio utilizzare un valore di accelerazione pi\u00f9 elevato. Aumenta max_accel_to_decel inserendo il seguente comando: SET_VELOCITY_LIMIT ACCEL_TO_DECEL=7000 Disabilita la Pressure Advance: SET_PRESSURE_ADVANCE ADVANCE=0 Se hai gi\u00e0 aggiunto la sezione [input_shaper] a printer.cfg, esegui il comando SET_INPUT_SHAPER SHAPER_FREQ_X=0 SHAPER_FREQ_Y=0 . Se ricevi l'errore \"Comando sconosciuto- Unknown command\", puoi tranquillamente ignorarlo a questo punto e continuare con le misurazioni. Eseguire il comando: TUNING_TOWER COMMAND=SET_VELOCITY_LIMIT PARAMETER=ACCEL START=1500 STEP_DELTA=500 STEP_HEIGHT=5 Fondamentalmente, cerchiamo di rendere pi\u00f9 pronunciato il ringing impostando diversi valori elevati per l'accelerazione. Questo comando aumenter\u00e0 l'accelerazione ogni 5 mm a partire da 1500 mm/sec^2: 1500 mm/sec^2, 2000 mm/sec^2, 2500 mm/sec^2 e cos\u00ec via fino a 7000 mm/sec^2 per l'ultima fascia. Stampa il modello di test sliced con i parametri suggeriti. Puoi interrompere la stampa prima se il ringing \u00e8 chiaramente visibile e vedi che l'accelerazione diventa troppo alta per la tua stampante (ad es. la stampante trema troppo o inizia a saltare i passaggi). Utilizzare i segni X e Y sul retro del modello come riferimento. Le misurazioni dal lato con il contrassegno X devono essere utilizzate per la configurazione dell'asse X e il contrassegno Y - per la configurazione dell'asse Y. Misurare la distanza D (in mm) tra pi\u00f9 oscillazioni sulla parte con il segno X, in prossimit\u00e0 delle tacche, preferibilmente saltando la prima o due oscillazioni. Per misurare pi\u00f9 facilmente la distanza tra le oscillazioni, contrassegnare prima le oscillazioni, quindi misurare la distanza tra i segni con un righello o un calibro:| | | Contare a quante oscillazioni N corrisponde la distanza misurata D . Se non sei sicuro di come contare le oscillazioni, fai riferimento all'immagine sopra, che mostra N = 6 oscillazioni. Calcola la frequenza di squillo dell'asse X come V \u00b7 N / D (Hz), dove V \u00e8 la velocit\u00e0 per i perimetri esterni (mm/sec). Per l'esempio sopra, abbiamo contrassegnato 6 oscillazioni e il test \u00e8 stato stampato a una velocit\u00e0 di 100 mm/sec, quindi la frequenza \u00e8 100 * 6 / 12,14 \u2248 49,4 Hz. Esegui (8) - (10) anche per il segno Y. Si noti che il ringing sulla stampa di prova dovrebbe seguire lo schema delle tacche curve, come nell'immagine sopra. In caso contrario, questo difetto non \u00e8 in realt\u00e0 un ringing e ha un'origine diversa: un problema meccanico o dell'estrusore. Dovrebbe essere risolto prima di abilitare e regolare gli shaper di input. Se le misurazioni non sono affidabili perch\u00e9, ad esempio, la distanza tra le oscillazioni non \u00e8 stabile, potrebbe significare che la stampante ha pi\u00f9 frequenze di risonanza sullo stesso asse. Si pu\u00f2 invece provare a seguire il processo di sintonizzazione descritto nella sezione Misurazioni inaffidabili delle frequenze di ringing e ottenere comunque qualcosa dalla tecnica di input shaping . La frequenza dei ringing pu\u00f2 dipendere dalla posizione del modello all'interno della piastra di stampa e dall'altezza Z, soprattutto sulle stampanti delta ; puoi controllare se vedi le differenze di frequenza in diverse posizioni lungo i lati del modello di prova e ad altezze diverse. \u00c8 possibile calcolare le frequenze di squillo medie sugli assi X e Y, se questo \u00e8 il caso. Se la frequenza di ringing misurata \u00e8 molto bassa (inferiore a circa 20-25 Hz), potrebbe essere una buona idea investire nell'irrigidire la stampante o nel diminuire la massa mobile, a seconda di ci\u00f2 che \u00e8 applicabile nel tuo caso, prima di procedere con l'ulteriore input shaping e rimisurare le frequenze in seguito. Per molti modelli di stampanti popolari spesso sono gi\u00e0 disponibili alcune soluzioni. Si noti che le frequenze di ringing possono cambiare se alla stampante vengono apportate modifiche che influiscono sulla massa in movimento o modificano la rigidit\u00e0 del sistema, ad esempio: Alcuni strumenti vengono installati, rimossi o sostituiti sulla testa di stampa che ne modificano la massa, ad es. viene installato un nuovo motore passo-passo (pi\u00f9 pesante o pi\u00f9 leggero) per estrusore diretto o viene installato un nuovo hotend, viene aggiunta una ventola pesante con un condotto, ecc. Le cinghie sono tese. Sono installati alcuni componenti aggiuntivi per aumentare la rigidit\u00e0 del telaio. Un piatto diverso \u00e8 installato su una stampante a piatto mobile o aggiunto un vetro, ecc. Se vengono apportate tali modifiche, \u00e8 una buona idea misurare almeno le frequenze di ringing per vedere se sono cambiate. Configurazione del Input shaper \u00b6 Dopo aver misurato le frequenze di ringing per gli assi X e Y, puoi aggiungere la seguente sezione al tuo printer.cfg : [input_shaper] shaper_freq_x: ... # frequenza per il segno X del modello di prova shaper_freq_y: ... # frequenza per il segno Y del modello di prova Per l'esempio sopra, otteniamo shaper_freq_x/y = 49.4. Scelta del input shaper \u00b6 Klipper supporta diversi input shaper. Si differenziano per la loro sensibilit\u00e0 agli errori che determinano la frequenza di risonanza e quanto smussamento provocano nelle parti stampate. Inoltre, alcuni degli shaper come 2HUMP_EI e 3HUMP_EI di solito non dovrebbero essere usati con shaper_freq = frequenza di risonanza: sono configurati in base a diverse considerazioni per ridurre diverse risonanze contemporaneamente. Per la maggior parte delle stampanti, possono essere consigliati shaper MZV o EI. Questa sezione descrive un processo di test per scegliere tra di loro e capire alcuni altri parametri correlati. Stampare il modello di prova di ringing come segue: Riavviare il firmware: RESTART Prepararsi per il test: SET_VELOCITY_LIMIT ACCEL_TO_DECEL=7000 Disabilita la Pressure Advance: SET_PRESSURE_ADVANCE ADVANCE=0 Eseguire: SET_INPUT_SHAPER SHAPER_TYPE=MZV Eseguire il comando: TUNING_TOWER COMMAND=SET_VELOCITY_LIMIT PARAMETER=ACCEL START=1500 STEP_DELTA=500 STEP_HEIGHT=5 Stampa il modello di test sliced con i parametri suggeriti. Se a questo punto non si vede alcun ringing, \u00e8 possibile consigliare l'uso dello shaper MZV. Se vedi dei ringing, rimisura le frequenze usando i passaggi (8)-(10) descritti nella sezione Frequenza ringing . Se le frequenze differiscono in modo significativo dai valori ottenuti in precedenza, \u00e8 necessaria una configurazione dello shaper di input pi\u00f9 complessa. Puoi fare riferimento ai dettagli tecnici della sezione Input shapers . In caso contrario, procedere al passaggio successivo. Ora prova l'input shaper EI. Per provarlo, ripeti i passaggi (1)-(6) da sopra, ma eseguendo invece al passaggio 4 il seguente comando : SET_INPUT_SHAPER SHAPER_TYPE=EI . Confronta due stampe con input shaper MZV e EI. Se EI mostra risultati notevolmente migliori rispetto a MZV, utilizzare EI shaper, altrimenti preferire MZV. Si noti che lo shaper EI causer\u00e0 una maggiore levigatura 'smoothing' nelle parti stampate (vedere la sezione successiva per ulteriori dettagli). Aggiungi il parametro shaper_type: mzv (o ei) alla sezione [input_shaper], ad esempio: [input_shaper] shaper_freq_x: ... shaper_freq_y: ... shaper_type: mzv Alcune note sulla scelta dello shaper: Lo shaper EI pu\u00f2 essere pi\u00f9 adatto per le stampanti a piatto mobile (se la frequenza di risonanza e il conseguente livellamento lo consentono): man mano che si deposita pi\u00f9 filamento sul piatto mobile, la massa del piatto aumenta e la frequenza di risonanza diminuisce. Poich\u00e9 lo shaper EI \u00e8 pi\u00f9 robusto alle variazioni della frequenza di risonanza, potrebbe funzionare meglio quando si stampano parti di grandi dimensioni. A causa della natura della cinematica delta, le frequenze di risonanza possono differire molto in diverse parti del volume di costruzione. Pertanto, lo shaper EI pu\u00f2 adattarsi meglio alle stampanti delta piuttosto che a MZV o ZV e dovrebbe essere considerato per l'uso. Se la frequenza di risonanza \u00e8 sufficientemente grande (pi\u00f9 di 50-60 Hz), si pu\u00f2 anche provare a testare lo shaper 2HUMP_EI (eseguendo il test suggerito sopra con SET_INPUT_SHAPER SHAPER_TYPE=2HUMP_EI ), ma controllare le considerazioni nella sezione sotto prima di abilitarlo. Seleziona max_accel \u00b6 Dovresti avere un test stampato per lo shaper che hai scelto dal passaggio precedente (se non lo fai, stampa il modello di test affettato con i parametri suggeriti con l'anticipo di pressione disabilitato SET_PRESSURE_ADVANCE ADVANCE=0 e con la torre di regolazione abilitata come TUNING_TOWER COMMAND=SET_VELOCITY_LIMIT PARAMETER=ACCEL START=1500 STEP_DELTA=500 STEP_HEIGHT=5 ). Si noti che ad accelerazioni molto elevate, a seconda della frequenza di risonanza e dell'input shaper scelto (ad es. EI shaper crea pi\u00f9 smussamento di MZV), l'input shaping pu\u00f2 causare un'eccessiva levigatura -smoothing- e arrotondamento delle parti. Quindi, max_accel dovrebbe essere scelto in modo tale da impedirlo. Un altro parametro che pu\u00f2 influire sul livellamento \u00e8 square_corner_velocity , quindi non \u00e8 consigliabile aumentarlo al di sopra del valore predefinito di 5 mm/sec per evitare un aumento del livellamento smooting. Per selezionare un valore max_accel adatto, ispezionare il modello per lo shaper di input scelto. Per prima cosa, prendi nota a quale accelerazione il ringing \u00e8 ancora piccolo - che ti vada bene. Quindi, controlla la levigatura - smoothing. Per aiutare in questo, il modello di prova ha un piccolo spazio nel muro (0,15 mm): All'aumentare dell'accelerazione, aumenta anche la levigatura-smoothing e lo spazio effettivo nella stampa si allarga: In questa immagine, l'accelerazione aumenta da sinistra a destra e il gap inizia a crescere a partire da 3500 mm/sec^2 (quinta banda da sinistra). Quindi il buon valore per max_accel = 3000 (mm/sec^2) in questo caso per evitare l'eccessivo smoothing. Nota l'accelerazione quando lo spazio \u00e8 ancora molto piccolo nella stampa di prova. Se vedi rigonfiamenti, ma nessun vuoto nel muro, anche ad alte accelerazioni, potrebbe essere dovuto all'avanzamento della pressione disabilitato, specialmente sugli estrusori Bowden. In tal caso, potrebbe essere necessario ripetere la stampa con il PA abilitato. Potrebbe anche essere il risultato di un flusso di filamento non calibrato (troppo alto), quindi \u00e8 una buona idea controllare anche quello. Scegli il minimo tra i due valori di accelerazione (da ringing e smoothing) e inseriscilo come max_accel in printer.cfg. Come nota, pu\u00f2 succedere, specialmente a basse frequenze di ringing, che lo shaper EI provochi un'eccessiva attenuazione anche a basse accelerazioni. In questo caso, MZV potrebbe essere una scelta migliore, perch\u00e9 potrebbe consentire valori di accelerazione pi\u00f9 elevati. A frequenze di ringing molto basse (~25 Hz e inferiori) anche lo shaper MZV pu\u00f2 creare un effetto smussato eccessivo. In tal caso, puoi anche provare a ripetere i passaggi nella sezione Scegliere input shaper con shaper ZV, usando invece il comando SET_INPUT_SHAPER SHAPER_TYPE=ZV . Lo shaper ZV dovrebbe mostrare un livellamento ancora inferiore rispetto a MZV, ma \u00e8 pi\u00f9 sensibile agli errori nella misurazione delle frequenze di ringing. Un'altra considerazione \u00e8 che se una frequenza di risonanza \u00e8 troppo bassa (inferiore a 20-25 Hz), potrebbe essere una buona idea aumentare la rigidit\u00e0 della stampante o ridurre la massa in movimento. In caso contrario, l'accelerazione e la velocit\u00e0 di stampa potrebbero essere limitate a causa di un'eccessivo smoothing invece del ringing. Regolazione fine delle frequenze di risonanza \u00b6 Si noti che la precisione delle misurazioni delle frequenze di risonanza utilizzando il modello di test di ringing \u00e8 sufficiente per la maggior parte degli scopi, quindi si sconsiglia un'ulteriore messa a punto. Se vuoi ancora provare a ricontrollare i tuoi risultati (ad esempio se vedi ancora del ringing dopo aver stampato un modello di prova con un input shaper a tua scelta con le stesse frequenze che hai misurato in precedenza), puoi seguire i passaggi in questo sezione. Nota che se vedi ringing a frequenze diverse dopo aver abilitato [input_shaper], questa sezione non ti aiuter\u00e0. Supponendo di aver suddiviso il modello di ringing con i parametri suggeriti, completare i seguenti passaggi per ciascuno degli assi X e Y: Prepararsi per il test: SET_VELOCITY_LIMIT ACCEL_TO_DECEL=7000 Assicurati che Pressure Advance sia disabilitato: SET_PRESSURE_ADVANCE ADVANCE=0 Eseguire: SET_INPUT_SHAPER SHAPER_TYPE=ZV Dal modello di prova di ringing esistente con lo shaper di input scelto, seleziona l'accelerazione che mostra sufficientemente bene il ringing e impostala con: SET_VELOCITY_LIMIT ACCEL=... Calcola i parametri necessari per il comando TUNING_TOWER per ottimizzare il parametro shaper_freq_x come segue: start = shaper_freq_x * 83 / 132 e factor = shaper_freq_x / 66, dove qui shaper_freq_x \u00e8 il valore corrente in printer.cfg . Eseguire il comando: TUNING_TOWER COMMAND=SET_INPUT_SHAPER PARAMETER=SHAPER_FREQ_X START=start FACTOR=factor BAND=5 usando i valori start e factor calcolati al punto (5). Stampa il modello di prova. Reimposta il valore della frequenza originale: SET_INPUT_SHAPER SHAPER_FREQ_X=... . Trova la fascia che mostra meno ringing e conta il suo numero dal basso partendo da 1. Calcola il nuovo valore shaper_freq_x tramite il vecchio shaper_freq_x * (39 + 5 * #band-number) / 66. Ripetere questi passaggi per l'asse Y allo stesso modo, sostituendo i riferimenti all'asse X con l'asse Y (ad es. sostituire shaper_freq_x con shaper_freq_y nelle formule e nel comando TUNING_TOWER ). Ad esempio, supponiamo di aver misurato la frequenza di ringing per uno degli assi pari a 45 Hz. Questo d\u00e0 start = 45 * 83 / 132 = 28,30 e factor = 45 / 66 = 0,6818 valori per il comando TUNING_TOWER . Supponiamo ora che dopo aver stampato il modello di prova, la quarta fascia dal basso dia il minimo squillo. Questo d\u00e0 lo shaper_freq_^ aggiornato al valore pari a 45 * (39 + 5 * 4) / 66 \u2248 40,23. Dopo aver calcolato entrambi i nuovi parametri shaper_freq_x e shaper_freq_y , puoi aggiornare la sezione [input_shaper] in printer.cfg con i nuovi valori shaper_freq_x e shaper_freq_y . Pressure Advance \u00b6 Se si utilizza Pressure Advance, potrebbe essere necessario risintonizzarlo. Seguire le istruzioni per trovare il nuovo valore, se diverso dal precedente. Assicurati di riavviare Klipper prima di regolare Pressure Advance. Misurazioni inaffidabili delle frequenze di ringing \u00b6 Se non \u00e8 possibile misurare le frequenze di ringing, ad es. se la distanza tra le oscillazioni non \u00e8 stabile, potresti comunque essere in grado di sfruttare le tecniche di input shaping, ma i risultati potrebbero non essere buoni come con misurazioni corrette delle frequenze e richieder\u00e0 un po' pi\u00f9 di messa a punto e stampa del test modello. Si noti che un'altra possibilit\u00e0 \u00e8 acquistare e installare un accelerometro e misurare le risonanze con esso (fare riferimento a docs che descrive l'hardware richiesto e il processo di installazione), ma questa opzione richiede un po' di crimpatura e saldatura. Per l'ottimizzazione, aggiungi la sezione [input_shaper] vuota al tuo printer.cfg . Quindi, supponendo di aver fattolo slicing il modello di ringing con i parametri suggeriti, stampare il modello di prova 3 volte come segue. La prima volta, prima della stampa, eseguire RESTART SET_VELOCITY_LIMIT ACCEL_TO_DECEL=7000 SET_PRESSURE_ADVANCE ADVANCE=0 SET_INPUT_SHAPER SHAPER_TYPE=2HUMP_EI SHAPER_FREQ_X=60 SHAPER_FREQ_Y=60 TUNING_TOWER COMMAND=SET_VELOCITY_LIMIT PARAMETER=ACCEL START=1500 STEP_DELTA=500 STEP_HEIGHT=5 e stampa il modello. Quindi stampare di nuovo il modello, ma prima di eseguire la stampa invece SET_INPUT_SHAPER SHAPER_TYPE=2HUMP_EI SHAPER_FREQ_X=50 SHAPER_FREQ_Y=50 TUNING_TOWER COMMAND=SET_VELOCITY_LIMIT PARAMETER=ACCEL START=1500 STEP_DELTA=500 STEP_HEIGHT=5 Quindi stampa il modello per la terza volta, ma ora esegui SET_INPUT_SHAPER SHAPER_TYPE=2HUMP_EI SHAPER_FREQ_X=40 SHAPER_FREQ_Y=40 TUNING_TOWER COMMAND=SET_VELOCITY_LIMIT PARAMETER=ACCEL START=1500 STEP_DELTA=500 STEP_HEIGHT=5 In sostanza, stiamo stampando il modello di prova di ringing con TUNING_TOWER utilizzando lo shaper 2HUMP_EI con shaper_freq = 60 Hz, 50 Hz e 40 Hz. Se nessuno dei modelli mostra miglioramenti nel ringing, allora, sfortunatamente non sembra che le tecniche di modellazione dell'input possano aiutare con il tuo caso. Altrimenti, \u00e8 possibile che tutti i modelli non mostrino ringing, o alcuni mostrino ringing e altri non cos\u00ec tanto. Scegli il modello di test con la frequenza pi\u00f9 alta che mostra comunque buoni miglioramenti nel ringing. Ad esempio, se i modelli a 40 Hz e 50 Hz non mostrano quasi nessuno ringing e il modello a 60 Hz mostra gi\u00e0 un po' pi\u00f9 di ringing, attenersi a 50 Hz. Ora controlla se lo shaper EI sarebbe abbastanza buono nel tuo caso. Scegli la frequenza dello shaper EI in base alla frequenza dello shaper 2HUMP_EI che hai scelto: Per lo shaper 2HUMP_EI 60 Hz, utilizzare lo shaper EI con shaper_freq = 50 Hz. Per lo shaper 2HUMP_EI 50 Hz, utilizzare lo shaper EI con shaper_freq = 40 Hz. Per lo shaper 2HUMP_EI 40 Hz, utilizzare lo shaper EI con shaper_freq = 33 Hz. Ora stampa il modello di prova ancora una volta, eseguendola SET_INPUT_SHAPER SHAPER_TYPE=EI SHAPER_FREQ_X=... SHAPER_FREQ_Y=... TUNING_TOWER COMMAND=SET_VELOCITY_LIMIT PARAMETER=ACCEL START=1500 STEP_DELTA=500 STEP_HEIGHT=5 fornendo shaper_freq_x=... e shaper_freq_y=... come determinato in precedenza. Se lo shaper EI mostra buoni risultati comparabili con lo shaper 2HUMP_EI, attenersi con lo shaper EI e la frequenza determinata in precedenza, altrimenti utilizzare lo shaper 2HUMP_EI con la frequenza corrispondente. Aggiungi i risultati a printer.cfg come, ad es. [input_shaper] shaper_freq_x: 50 shaper_freq_y: 50 shaper_type: 2hump_ei Continua l'ottimizzazione con la sezione Selecting max_accel . Risoluzione dei problemi e domande frequenti \u00b6 Non riesco a ottenere misurazioni affidabili delle frequenze di risonanza \u00b6 Innanzitutto, assicurati che non ci siano altri problemi con la stampante invece del ringing. Se le misurazioni non sono affidabili perch\u00e9, ad esempio, la distanza tra le oscillazioni non \u00e8 stabile, potrebbe significare che la stampante ha pi\u00f9 frequenze di risonanza sullo stesso asse. Si pu\u00f2 provare a seguire il processo di sintonizzazione descritto nella sezione Misurazioni inaffidabili delle frequenze di ringing e ottenere comunque qualcosa dalla tecnica di modellatura dell'input. Un'altra possibilit\u00e0 \u00e8 installare un accelerometro, misurare le risonanze con esso e regolare automaticamente lo shaper di input utilizzando i risultati di tali misurazioni. Dopo aver abilitato [input_shaper], ottengo parti stampate troppo levigate e i dettagli fini vengono persi \u00b6 Controllare le considerazioni nella sezione Selecting max_accel . Se la frequenza di risonanza \u00e8 bassa, non si dovrebbero impostare max_accel troppo alti o aumentare i parametri square_corner_velocity. Potrebbe anche essere meglio scegliere gli shaper di input MZV o anche ZV su EI (o gli shaper 2HUMP_EI e 3HUMP_EI). Dopo aver stampato correttamente per un po' di tempo senza ringing, sembra tornare \u00b6 \u00c8 possibile che dopo qualche tempo le frequenze di risonanza siano cambiate. Per esempio. forse la tensione delle cinghie \u00e8 cambiata (le cinghie si sono allentate di pi\u00f9), ecc. \u00c8 una buona idea controllare e rimisurare le frequenze di ringing come descritto nella sezione Frequenza di ringing e aggiornare il file di configurazione se necessario . La configurazione a doppio carrello \u00e8 supportata con gli input shaper? \u00b6 Non esiste un supporto dedicato per doppi carrelli con input shaper, ma ci\u00f2 non significa che questa configurazione non funzioner\u00e0. Si dovrebbe eseguire la messa a punto due volte per ciascuno dei carrelli e calcolare le frequenze di ringing per gli assi X e Y per ciascuno dei carrelli in modo indipendente. Quindi inserisci i valori per il carrello 0 nella sezione [input_shaper] e modifica i valori al volo quando si cambiano i carrelli, ad es. come parte di alcune macro: SET_DUAL_CARRIAGE CARRIAGE=1 SET_INPUT_SHAPER SHAPER_FREQ_X=... SHAPER_FREQ_Y=... E allo stesso modo quando si torna al carrello 0. L'input_shaper influisce sul tempo di stampa? \u00b6 No, la funzione input_shaper non ha praticamente alcun impatto sui tempi di stampa da sola. Tuttavia, il valore di max_accel lo fa certamente (regolazione di questo parametro descritta in questa sezione ). Dettagli tecnici \u00b6 Input shaper \u00b6 Gli shaper di input utilizzati in Klipper sono piuttosto standard e si pu\u00f2 trovare una panoramica pi\u00f9 approfondita negli articoli che descrivono gli shaper corrispondenti. Questa sezione contiene una breve panoramica di alcuni aspetti tecnici degli input shaper supportati. La tabella seguente mostra alcuni parametri (solitamente approssimativi) di ciascun shaper. Input shaper Shaper duration Riduzione delle vibrazioni 20x (5% di tolleranza alle vibrazioni) Riduzione delle vibrazioni 10 volte (tolleranza alle vibrazioni del 10%) ZV 0.5 / shaper_freq N/A \u00b1 5% shaper_freq MZV 0.75 / shaper_freq \u00b1 4% shaper_freq -10%...+15% shaper_freq ZVD 1 / shaper_freq \u00b1 15% shaper_freq \u00b1 22% shaper_freq EI 1 / shaper_freq \u00b1 20% shaper_freq \u00b1 25% shaper_freq 2HUMP_EI 1.5 / shaper_freq \u00b1 35% shaper_freq \u00b1 40 shaper_freq 3HUMP_EI 2 / shaper_freq -45...+50% shaper_freq -50%...+55% shaper_freq Una nota sulla riduzione delle vibrazioni: i valori nella tabella sopra sono approssimativi. Se il rapporto di smorzamento della stampante \u00e8 noto per ciascun asse, lo shaper pu\u00f2 essere configurato in modo pi\u00f9 preciso e ridurr\u00e0 quindi le risonanze in una gamma di frequenze leggermente pi\u00f9 ampia. Tuttavia, il rapporto di smorzamento \u00e8 solitamente sconosciuto ed \u00e8 difficile da stimare senza un'attrezzatura speciale, quindi Klipper utilizza il valore 0,1 per impostazione predefinita, che \u00e8 un buon valore a tutto tondo. Le gamme di frequenza nella tabella coprono un numero di diversi possibili rapporti di smorzamento attorno a quel valore (da 0,05 a 0,2 circa). Si noti inoltre che EI, 2HUMP_EI e 3HUMP_EI sono sintonizzati per ridurre le vibrazioni al 5%, quindi i valori per la tolleranza alle vibrazioni del 10% sono forniti solo per riferimento. Come utilizzare questa tabella: La durata dello shaper influisce sull0 smoothing delle parti: pi\u00f9 \u00e8 grande, pi\u00f9 le parti sono lisce. Questa dipendenza non \u00e8 lineare, ma pu\u00f2 dare un'idea di quali shaper \"levigano\" di pi\u00f9 per la stessa frequenza. L'ordinamento per smoothing \u00e8 il seguente: ZV < MZV < ZVD \u2248 EI < 2HUMP_EI < 3HUMP_EI. Inoltre, raramente \u00e8 pratico impostare shaper_freq = resonance freq per gli shaper 2HUMP_EI e 3HUMP_EI (dovrebbero essere usati per ridurre le vibrazioni per diverse frequenze). Si pu\u00f2 stimare una gamma di frequenze in cui lo shaper riduce le vibrazioni. Ad esempio, MZV con shaper_freq = 35 Hz riduce le vibrazioni al 5% per le frequenze [33,6, 36,4] Hz. 3HUMP_EI con shaper_freq = 50 Hz riduce le vibrazioni al 5% nell'intervallo [27,5, 75] Hz. Si pu\u00f2 usare questa tabella per verificare quale shaper dovrebbero usare se hanno bisogno di ridurre le vibrazioni a diverse frequenze. Ad esempio, se si hanno risonanze a 35 Hz e 60 Hz sullo stesso asse: a) EI shaper deve avere shaper_freq = 35 / (1 - 0,2) = 43,75 Hz, e ridurr\u00e0 le risonanze fino a 43,75 * (1 + 0,2 ) = 52,5 Hz, quindi non \u00e8 sufficiente; b) 2HUMP_EI shaper deve avere shaper_freq = 35 / (1 - 0,35) = 53,85 Hz e ridurr\u00e0 le vibrazioni fino a 53,85 * (1 + 0,35) = 72,7 Hz - quindi questa \u00e8 una configurazione accettabile. Cerca sempre di usare shaper_freq il pi\u00f9 alto possibile per un dato shaper (magari con un certo margine di sicurezza, quindi in questo esempio shaper_freq \u2248 50-52 Hz funzionerebbe meglio), e prova a usare uno shaper con la minor durata possibile dello shaper. Se \u00e8 necessario ridurre le vibrazioni a diverse frequenze molto diverse (ad esempio, 30 Hz e 100 Hz), \u00e8 possibile che la tabella sopra non fornisca informazioni sufficienti. In questo caso si pu\u00f2 avere pi\u00f9 fortuna con lo script scripts/graph_shaper.py , che \u00e8 pi\u00f9 flessibile.","title":"Compensazione della risonanza"},{"location":"Resonance_Compensation.html#compensazione-della-risonanza","text":"Klipper supporta Input Shaping, una tecnica che pu\u00f2 essere utilizzata per ridurre il ringing (noti anche come echoing, ghosting o increspature) nelle stampe. Il ringing \u00e8 un difetto di stampa della superficie quando, in genere, elementi come i bordi si ripetono su una superficie stampata come un sottile \"eco\": | | | I ringing sono causati da vibrazioni meccaniche nella stampante dovute a rapidi cambiamenti della direzione di stampa. Si noti che il ringing di solito ha origini meccaniche: telaio della stampante non sufficientemente rigido, cinghie non tese o troppo elastiche, problemi di allineamento delle parti meccaniche, massa in movimento pesante, ecc. Questi dovrebbero essere prima controllati e riparati, se possibile. Input shaping \u00e8 una tecnica di controllo ad anello aperto che crea un segnale di comando che annulla le proprie vibrazioni. La modellatura dell'ingresso richiede alcune regolazioni e misurazioni prima di poter essere abilitata. Oltre al ringing, Input Shaping riduce in genere le vibrazioni e le vibrazioni della stampante in generale e pu\u00f2 anche migliorare l'affidabilit\u00e0 della modalit\u00e0 StealthChop dei driver stepper Trinamic.","title":"Compensazione della risonanza"},{"location":"Resonance_Compensation.html#messa-a-punto","text":"La regolazione di base richiede la misurazione delle frequenze di ringing della stampante stampando un modello di prova. Carica il modello di prova per il ringing, che pu\u00f2 essere trovato in docs/prints/ringing_tower.stl , nello slicer: L'altezza dello strato (layer) consigliata \u00e8 0,2 o 0,25 mm. I livelli di riempimento e superiori possono essere impostati su 0. Usa 1-2 perimetri, o meglio ancora la modalit\u00e0 vaso liscio con base da 1-2 mm. Utilizzare velocit\u00e0 sufficientemente elevate, circa 80-100 mm/sec, per i perimetri esterni . Assicurati che il tempo minimo per lo strato sia al massimo 3 secondi. Assicurati che qualsiasi \"controllo dinamico dell'accelerazione\" sia disabilitato nello slicer. Non girare il modello. Il modello ha segni X e Y sul retro del modello. Nota la posizione insolita dei segni rispetto agli assi della stampante: non \u00e8 un errore. I contrassegni possono essere utilizzati successivamente nel processo di ottimizzazione come riferimento, poich\u00e9 mostrano a quale asse corrispondono le misurazioni.","title":"Messa a punto"},{"location":"Resonance_Compensation.html#frequenza-di-ringing","text":"Innanzitutto, misura la frequenza di ringing . Se il parametro square_corner_velocity \u00e8 stato modificato, ripristinalo a 5.0 . Non \u00e8 consigliabile aumentarlo quando si utilizza l'input shaper perch\u00e9 pu\u00f2 causare un maggiore smussamento smoothing delle parti: \u00e8 invece meglio utilizzare un valore di accelerazione pi\u00f9 elevato. Aumenta max_accel_to_decel inserendo il seguente comando: SET_VELOCITY_LIMIT ACCEL_TO_DECEL=7000 Disabilita la Pressure Advance: SET_PRESSURE_ADVANCE ADVANCE=0 Se hai gi\u00e0 aggiunto la sezione [input_shaper] a printer.cfg, esegui il comando SET_INPUT_SHAPER SHAPER_FREQ_X=0 SHAPER_FREQ_Y=0 . Se ricevi l'errore \"Comando sconosciuto- Unknown command\", puoi tranquillamente ignorarlo a questo punto e continuare con le misurazioni. Eseguire il comando: TUNING_TOWER COMMAND=SET_VELOCITY_LIMIT PARAMETER=ACCEL START=1500 STEP_DELTA=500 STEP_HEIGHT=5 Fondamentalmente, cerchiamo di rendere pi\u00f9 pronunciato il ringing impostando diversi valori elevati per l'accelerazione. Questo comando aumenter\u00e0 l'accelerazione ogni 5 mm a partire da 1500 mm/sec^2: 1500 mm/sec^2, 2000 mm/sec^2, 2500 mm/sec^2 e cos\u00ec via fino a 7000 mm/sec^2 per l'ultima fascia. Stampa il modello di test sliced con i parametri suggeriti. Puoi interrompere la stampa prima se il ringing \u00e8 chiaramente visibile e vedi che l'accelerazione diventa troppo alta per la tua stampante (ad es. la stampante trema troppo o inizia a saltare i passaggi). Utilizzare i segni X e Y sul retro del modello come riferimento. Le misurazioni dal lato con il contrassegno X devono essere utilizzate per la configurazione dell'asse X e il contrassegno Y - per la configurazione dell'asse Y. Misurare la distanza D (in mm) tra pi\u00f9 oscillazioni sulla parte con il segno X, in prossimit\u00e0 delle tacche, preferibilmente saltando la prima o due oscillazioni. Per misurare pi\u00f9 facilmente la distanza tra le oscillazioni, contrassegnare prima le oscillazioni, quindi misurare la distanza tra i segni con un righello o un calibro:| | | Contare a quante oscillazioni N corrisponde la distanza misurata D . Se non sei sicuro di come contare le oscillazioni, fai riferimento all'immagine sopra, che mostra N = 6 oscillazioni. Calcola la frequenza di squillo dell'asse X come V \u00b7 N / D (Hz), dove V \u00e8 la velocit\u00e0 per i perimetri esterni (mm/sec). Per l'esempio sopra, abbiamo contrassegnato 6 oscillazioni e il test \u00e8 stato stampato a una velocit\u00e0 di 100 mm/sec, quindi la frequenza \u00e8 100 * 6 / 12,14 \u2248 49,4 Hz. Esegui (8) - (10) anche per il segno Y. Si noti che il ringing sulla stampa di prova dovrebbe seguire lo schema delle tacche curve, come nell'immagine sopra. In caso contrario, questo difetto non \u00e8 in realt\u00e0 un ringing e ha un'origine diversa: un problema meccanico o dell'estrusore. Dovrebbe essere risolto prima di abilitare e regolare gli shaper di input. Se le misurazioni non sono affidabili perch\u00e9, ad esempio, la distanza tra le oscillazioni non \u00e8 stabile, potrebbe significare che la stampante ha pi\u00f9 frequenze di risonanza sullo stesso asse. Si pu\u00f2 invece provare a seguire il processo di sintonizzazione descritto nella sezione Misurazioni inaffidabili delle frequenze di ringing e ottenere comunque qualcosa dalla tecnica di input shaping . La frequenza dei ringing pu\u00f2 dipendere dalla posizione del modello all'interno della piastra di stampa e dall'altezza Z, soprattutto sulle stampanti delta ; puoi controllare se vedi le differenze di frequenza in diverse posizioni lungo i lati del modello di prova e ad altezze diverse. \u00c8 possibile calcolare le frequenze di squillo medie sugli assi X e Y, se questo \u00e8 il caso. Se la frequenza di ringing misurata \u00e8 molto bassa (inferiore a circa 20-25 Hz), potrebbe essere una buona idea investire nell'irrigidire la stampante o nel diminuire la massa mobile, a seconda di ci\u00f2 che \u00e8 applicabile nel tuo caso, prima di procedere con l'ulteriore input shaping e rimisurare le frequenze in seguito. Per molti modelli di stampanti popolari spesso sono gi\u00e0 disponibili alcune soluzioni. Si noti che le frequenze di ringing possono cambiare se alla stampante vengono apportate modifiche che influiscono sulla massa in movimento o modificano la rigidit\u00e0 del sistema, ad esempio: Alcuni strumenti vengono installati, rimossi o sostituiti sulla testa di stampa che ne modificano la massa, ad es. viene installato un nuovo motore passo-passo (pi\u00f9 pesante o pi\u00f9 leggero) per estrusore diretto o viene installato un nuovo hotend, viene aggiunta una ventola pesante con un condotto, ecc. Le cinghie sono tese. Sono installati alcuni componenti aggiuntivi per aumentare la rigidit\u00e0 del telaio. Un piatto diverso \u00e8 installato su una stampante a piatto mobile o aggiunto un vetro, ecc. Se vengono apportate tali modifiche, \u00e8 una buona idea misurare almeno le frequenze di ringing per vedere se sono cambiate.","title":"Frequenza di ringing"},{"location":"Resonance_Compensation.html#configurazione-del-input-shaper","text":"Dopo aver misurato le frequenze di ringing per gli assi X e Y, puoi aggiungere la seguente sezione al tuo printer.cfg : [input_shaper] shaper_freq_x: ... # frequenza per il segno X del modello di prova shaper_freq_y: ... # frequenza per il segno Y del modello di prova Per l'esempio sopra, otteniamo shaper_freq_x/y = 49.4.","title":"Configurazione del Input shaper"},{"location":"Resonance_Compensation.html#scelta-del-input-shaper","text":"Klipper supporta diversi input shaper. Si differenziano per la loro sensibilit\u00e0 agli errori che determinano la frequenza di risonanza e quanto smussamento provocano nelle parti stampate. Inoltre, alcuni degli shaper come 2HUMP_EI e 3HUMP_EI di solito non dovrebbero essere usati con shaper_freq = frequenza di risonanza: sono configurati in base a diverse considerazioni per ridurre diverse risonanze contemporaneamente. Per la maggior parte delle stampanti, possono essere consigliati shaper MZV o EI. Questa sezione descrive un processo di test per scegliere tra di loro e capire alcuni altri parametri correlati. Stampare il modello di prova di ringing come segue: Riavviare il firmware: RESTART Prepararsi per il test: SET_VELOCITY_LIMIT ACCEL_TO_DECEL=7000 Disabilita la Pressure Advance: SET_PRESSURE_ADVANCE ADVANCE=0 Eseguire: SET_INPUT_SHAPER SHAPER_TYPE=MZV Eseguire il comando: TUNING_TOWER COMMAND=SET_VELOCITY_LIMIT PARAMETER=ACCEL START=1500 STEP_DELTA=500 STEP_HEIGHT=5 Stampa il modello di test sliced con i parametri suggeriti. Se a questo punto non si vede alcun ringing, \u00e8 possibile consigliare l'uso dello shaper MZV. Se vedi dei ringing, rimisura le frequenze usando i passaggi (8)-(10) descritti nella sezione Frequenza ringing . Se le frequenze differiscono in modo significativo dai valori ottenuti in precedenza, \u00e8 necessaria una configurazione dello shaper di input pi\u00f9 complessa. Puoi fare riferimento ai dettagli tecnici della sezione Input shapers . In caso contrario, procedere al passaggio successivo. Ora prova l'input shaper EI. Per provarlo, ripeti i passaggi (1)-(6) da sopra, ma eseguendo invece al passaggio 4 il seguente comando : SET_INPUT_SHAPER SHAPER_TYPE=EI . Confronta due stampe con input shaper MZV e EI. Se EI mostra risultati notevolmente migliori rispetto a MZV, utilizzare EI shaper, altrimenti preferire MZV. Si noti che lo shaper EI causer\u00e0 una maggiore levigatura 'smoothing' nelle parti stampate (vedere la sezione successiva per ulteriori dettagli). Aggiungi il parametro shaper_type: mzv (o ei) alla sezione [input_shaper], ad esempio: [input_shaper] shaper_freq_x: ... shaper_freq_y: ... shaper_type: mzv Alcune note sulla scelta dello shaper: Lo shaper EI pu\u00f2 essere pi\u00f9 adatto per le stampanti a piatto mobile (se la frequenza di risonanza e il conseguente livellamento lo consentono): man mano che si deposita pi\u00f9 filamento sul piatto mobile, la massa del piatto aumenta e la frequenza di risonanza diminuisce. Poich\u00e9 lo shaper EI \u00e8 pi\u00f9 robusto alle variazioni della frequenza di risonanza, potrebbe funzionare meglio quando si stampano parti di grandi dimensioni. A causa della natura della cinematica delta, le frequenze di risonanza possono differire molto in diverse parti del volume di costruzione. Pertanto, lo shaper EI pu\u00f2 adattarsi meglio alle stampanti delta piuttosto che a MZV o ZV e dovrebbe essere considerato per l'uso. Se la frequenza di risonanza \u00e8 sufficientemente grande (pi\u00f9 di 50-60 Hz), si pu\u00f2 anche provare a testare lo shaper 2HUMP_EI (eseguendo il test suggerito sopra con SET_INPUT_SHAPER SHAPER_TYPE=2HUMP_EI ), ma controllare le considerazioni nella sezione sotto prima di abilitarlo.","title":"Scelta del input shaper"},{"location":"Resonance_Compensation.html#seleziona-max_accel","text":"Dovresti avere un test stampato per lo shaper che hai scelto dal passaggio precedente (se non lo fai, stampa il modello di test affettato con i parametri suggeriti con l'anticipo di pressione disabilitato SET_PRESSURE_ADVANCE ADVANCE=0 e con la torre di regolazione abilitata come TUNING_TOWER COMMAND=SET_VELOCITY_LIMIT PARAMETER=ACCEL START=1500 STEP_DELTA=500 STEP_HEIGHT=5 ). Si noti che ad accelerazioni molto elevate, a seconda della frequenza di risonanza e dell'input shaper scelto (ad es. EI shaper crea pi\u00f9 smussamento di MZV), l'input shaping pu\u00f2 causare un'eccessiva levigatura -smoothing- e arrotondamento delle parti. Quindi, max_accel dovrebbe essere scelto in modo tale da impedirlo. Un altro parametro che pu\u00f2 influire sul livellamento \u00e8 square_corner_velocity , quindi non \u00e8 consigliabile aumentarlo al di sopra del valore predefinito di 5 mm/sec per evitare un aumento del livellamento smooting. Per selezionare un valore max_accel adatto, ispezionare il modello per lo shaper di input scelto. Per prima cosa, prendi nota a quale accelerazione il ringing \u00e8 ancora piccolo - che ti vada bene. Quindi, controlla la levigatura - smoothing. Per aiutare in questo, il modello di prova ha un piccolo spazio nel muro (0,15 mm): All'aumentare dell'accelerazione, aumenta anche la levigatura-smoothing e lo spazio effettivo nella stampa si allarga: In questa immagine, l'accelerazione aumenta da sinistra a destra e il gap inizia a crescere a partire da 3500 mm/sec^2 (quinta banda da sinistra). Quindi il buon valore per max_accel = 3000 (mm/sec^2) in questo caso per evitare l'eccessivo smoothing. Nota l'accelerazione quando lo spazio \u00e8 ancora molto piccolo nella stampa di prova. Se vedi rigonfiamenti, ma nessun vuoto nel muro, anche ad alte accelerazioni, potrebbe essere dovuto all'avanzamento della pressione disabilitato, specialmente sugli estrusori Bowden. In tal caso, potrebbe essere necessario ripetere la stampa con il PA abilitato. Potrebbe anche essere il risultato di un flusso di filamento non calibrato (troppo alto), quindi \u00e8 una buona idea controllare anche quello. Scegli il minimo tra i due valori di accelerazione (da ringing e smoothing) e inseriscilo come max_accel in printer.cfg. Come nota, pu\u00f2 succedere, specialmente a basse frequenze di ringing, che lo shaper EI provochi un'eccessiva attenuazione anche a basse accelerazioni. In questo caso, MZV potrebbe essere una scelta migliore, perch\u00e9 potrebbe consentire valori di accelerazione pi\u00f9 elevati. A frequenze di ringing molto basse (~25 Hz e inferiori) anche lo shaper MZV pu\u00f2 creare un effetto smussato eccessivo. In tal caso, puoi anche provare a ripetere i passaggi nella sezione Scegliere input shaper con shaper ZV, usando invece il comando SET_INPUT_SHAPER SHAPER_TYPE=ZV . Lo shaper ZV dovrebbe mostrare un livellamento ancora inferiore rispetto a MZV, ma \u00e8 pi\u00f9 sensibile agli errori nella misurazione delle frequenze di ringing. Un'altra considerazione \u00e8 che se una frequenza di risonanza \u00e8 troppo bassa (inferiore a 20-25 Hz), potrebbe essere una buona idea aumentare la rigidit\u00e0 della stampante o ridurre la massa in movimento. In caso contrario, l'accelerazione e la velocit\u00e0 di stampa potrebbero essere limitate a causa di un'eccessivo smoothing invece del ringing.","title":"Seleziona max_accel"},{"location":"Resonance_Compensation.html#regolazione-fine-delle-frequenze-di-risonanza","text":"Si noti che la precisione delle misurazioni delle frequenze di risonanza utilizzando il modello di test di ringing \u00e8 sufficiente per la maggior parte degli scopi, quindi si sconsiglia un'ulteriore messa a punto. Se vuoi ancora provare a ricontrollare i tuoi risultati (ad esempio se vedi ancora del ringing dopo aver stampato un modello di prova con un input shaper a tua scelta con le stesse frequenze che hai misurato in precedenza), puoi seguire i passaggi in questo sezione. Nota che se vedi ringing a frequenze diverse dopo aver abilitato [input_shaper], questa sezione non ti aiuter\u00e0. Supponendo di aver suddiviso il modello di ringing con i parametri suggeriti, completare i seguenti passaggi per ciascuno degli assi X e Y: Prepararsi per il test: SET_VELOCITY_LIMIT ACCEL_TO_DECEL=7000 Assicurati che Pressure Advance sia disabilitato: SET_PRESSURE_ADVANCE ADVANCE=0 Eseguire: SET_INPUT_SHAPER SHAPER_TYPE=ZV Dal modello di prova di ringing esistente con lo shaper di input scelto, seleziona l'accelerazione che mostra sufficientemente bene il ringing e impostala con: SET_VELOCITY_LIMIT ACCEL=... Calcola i parametri necessari per il comando TUNING_TOWER per ottimizzare il parametro shaper_freq_x come segue: start = shaper_freq_x * 83 / 132 e factor = shaper_freq_x / 66, dove qui shaper_freq_x \u00e8 il valore corrente in printer.cfg . Eseguire il comando: TUNING_TOWER COMMAND=SET_INPUT_SHAPER PARAMETER=SHAPER_FREQ_X START=start FACTOR=factor BAND=5 usando i valori start e factor calcolati al punto (5). Stampa il modello di prova. Reimposta il valore della frequenza originale: SET_INPUT_SHAPER SHAPER_FREQ_X=... . Trova la fascia che mostra meno ringing e conta il suo numero dal basso partendo da 1. Calcola il nuovo valore shaper_freq_x tramite il vecchio shaper_freq_x * (39 + 5 * #band-number) / 66. Ripetere questi passaggi per l'asse Y allo stesso modo, sostituendo i riferimenti all'asse X con l'asse Y (ad es. sostituire shaper_freq_x con shaper_freq_y nelle formule e nel comando TUNING_TOWER ). Ad esempio, supponiamo di aver misurato la frequenza di ringing per uno degli assi pari a 45 Hz. Questo d\u00e0 start = 45 * 83 / 132 = 28,30 e factor = 45 / 66 = 0,6818 valori per il comando TUNING_TOWER . Supponiamo ora che dopo aver stampato il modello di prova, la quarta fascia dal basso dia il minimo squillo. Questo d\u00e0 lo shaper_freq_^ aggiornato al valore pari a 45 * (39 + 5 * 4) / 66 \u2248 40,23. Dopo aver calcolato entrambi i nuovi parametri shaper_freq_x e shaper_freq_y , puoi aggiornare la sezione [input_shaper] in printer.cfg con i nuovi valori shaper_freq_x e shaper_freq_y .","title":"Regolazione fine delle frequenze di risonanza"},{"location":"Resonance_Compensation.html#pressure-advance","text":"Se si utilizza Pressure Advance, potrebbe essere necessario risintonizzarlo. Seguire le istruzioni per trovare il nuovo valore, se diverso dal precedente. Assicurati di riavviare Klipper prima di regolare Pressure Advance.","title":"Pressure Advance"},{"location":"Resonance_Compensation.html#misurazioni-inaffidabili-delle-frequenze-di-ringing","text":"Se non \u00e8 possibile misurare le frequenze di ringing, ad es. se la distanza tra le oscillazioni non \u00e8 stabile, potresti comunque essere in grado di sfruttare le tecniche di input shaping, ma i risultati potrebbero non essere buoni come con misurazioni corrette delle frequenze e richieder\u00e0 un po' pi\u00f9 di messa a punto e stampa del test modello. Si noti che un'altra possibilit\u00e0 \u00e8 acquistare e installare un accelerometro e misurare le risonanze con esso (fare riferimento a docs che descrive l'hardware richiesto e il processo di installazione), ma questa opzione richiede un po' di crimpatura e saldatura. Per l'ottimizzazione, aggiungi la sezione [input_shaper] vuota al tuo printer.cfg . Quindi, supponendo di aver fattolo slicing il modello di ringing con i parametri suggeriti, stampare il modello di prova 3 volte come segue. La prima volta, prima della stampa, eseguire RESTART SET_VELOCITY_LIMIT ACCEL_TO_DECEL=7000 SET_PRESSURE_ADVANCE ADVANCE=0 SET_INPUT_SHAPER SHAPER_TYPE=2HUMP_EI SHAPER_FREQ_X=60 SHAPER_FREQ_Y=60 TUNING_TOWER COMMAND=SET_VELOCITY_LIMIT PARAMETER=ACCEL START=1500 STEP_DELTA=500 STEP_HEIGHT=5 e stampa il modello. Quindi stampare di nuovo il modello, ma prima di eseguire la stampa invece SET_INPUT_SHAPER SHAPER_TYPE=2HUMP_EI SHAPER_FREQ_X=50 SHAPER_FREQ_Y=50 TUNING_TOWER COMMAND=SET_VELOCITY_LIMIT PARAMETER=ACCEL START=1500 STEP_DELTA=500 STEP_HEIGHT=5 Quindi stampa il modello per la terza volta, ma ora esegui SET_INPUT_SHAPER SHAPER_TYPE=2HUMP_EI SHAPER_FREQ_X=40 SHAPER_FREQ_Y=40 TUNING_TOWER COMMAND=SET_VELOCITY_LIMIT PARAMETER=ACCEL START=1500 STEP_DELTA=500 STEP_HEIGHT=5 In sostanza, stiamo stampando il modello di prova di ringing con TUNING_TOWER utilizzando lo shaper 2HUMP_EI con shaper_freq = 60 Hz, 50 Hz e 40 Hz. Se nessuno dei modelli mostra miglioramenti nel ringing, allora, sfortunatamente non sembra che le tecniche di modellazione dell'input possano aiutare con il tuo caso. Altrimenti, \u00e8 possibile che tutti i modelli non mostrino ringing, o alcuni mostrino ringing e altri non cos\u00ec tanto. Scegli il modello di test con la frequenza pi\u00f9 alta che mostra comunque buoni miglioramenti nel ringing. Ad esempio, se i modelli a 40 Hz e 50 Hz non mostrano quasi nessuno ringing e il modello a 60 Hz mostra gi\u00e0 un po' pi\u00f9 di ringing, attenersi a 50 Hz. Ora controlla se lo shaper EI sarebbe abbastanza buono nel tuo caso. Scegli la frequenza dello shaper EI in base alla frequenza dello shaper 2HUMP_EI che hai scelto: Per lo shaper 2HUMP_EI 60 Hz, utilizzare lo shaper EI con shaper_freq = 50 Hz. Per lo shaper 2HUMP_EI 50 Hz, utilizzare lo shaper EI con shaper_freq = 40 Hz. Per lo shaper 2HUMP_EI 40 Hz, utilizzare lo shaper EI con shaper_freq = 33 Hz. Ora stampa il modello di prova ancora una volta, eseguendola SET_INPUT_SHAPER SHAPER_TYPE=EI SHAPER_FREQ_X=... SHAPER_FREQ_Y=... TUNING_TOWER COMMAND=SET_VELOCITY_LIMIT PARAMETER=ACCEL START=1500 STEP_DELTA=500 STEP_HEIGHT=5 fornendo shaper_freq_x=... e shaper_freq_y=... come determinato in precedenza. Se lo shaper EI mostra buoni risultati comparabili con lo shaper 2HUMP_EI, attenersi con lo shaper EI e la frequenza determinata in precedenza, altrimenti utilizzare lo shaper 2HUMP_EI con la frequenza corrispondente. Aggiungi i risultati a printer.cfg come, ad es. [input_shaper] shaper_freq_x: 50 shaper_freq_y: 50 shaper_type: 2hump_ei Continua l'ottimizzazione con la sezione Selecting max_accel .","title":"Misurazioni inaffidabili delle frequenze di ringing"},{"location":"Resonance_Compensation.html#risoluzione-dei-problemi-e-domande-frequenti","text":"","title":"Risoluzione dei problemi e domande frequenti"},{"location":"Resonance_Compensation.html#non-riesco-a-ottenere-misurazioni-affidabili-delle-frequenze-di-risonanza","text":"Innanzitutto, assicurati che non ci siano altri problemi con la stampante invece del ringing. Se le misurazioni non sono affidabili perch\u00e9, ad esempio, la distanza tra le oscillazioni non \u00e8 stabile, potrebbe significare che la stampante ha pi\u00f9 frequenze di risonanza sullo stesso asse. Si pu\u00f2 provare a seguire il processo di sintonizzazione descritto nella sezione Misurazioni inaffidabili delle frequenze di ringing e ottenere comunque qualcosa dalla tecnica di modellatura dell'input. Un'altra possibilit\u00e0 \u00e8 installare un accelerometro, misurare le risonanze con esso e regolare automaticamente lo shaper di input utilizzando i risultati di tali misurazioni.","title":"Non riesco a ottenere misurazioni affidabili delle frequenze di risonanza"},{"location":"Resonance_Compensation.html#dopo-aver-abilitato-input_shaper-ottengo-parti-stampate-troppo-levigate-e-i-dettagli-fini-vengono-persi","text":"Controllare le considerazioni nella sezione Selecting max_accel . Se la frequenza di risonanza \u00e8 bassa, non si dovrebbero impostare max_accel troppo alti o aumentare i parametri square_corner_velocity. Potrebbe anche essere meglio scegliere gli shaper di input MZV o anche ZV su EI (o gli shaper 2HUMP_EI e 3HUMP_EI).","title":"Dopo aver abilitato [input_shaper], ottengo parti stampate troppo levigate e i dettagli fini vengono persi"},{"location":"Resonance_Compensation.html#dopo-aver-stampato-correttamente-per-un-po-di-tempo-senza-ringing-sembra-tornare","text":"\u00c8 possibile che dopo qualche tempo le frequenze di risonanza siano cambiate. Per esempio. forse la tensione delle cinghie \u00e8 cambiata (le cinghie si sono allentate di pi\u00f9), ecc. \u00c8 una buona idea controllare e rimisurare le frequenze di ringing come descritto nella sezione Frequenza di ringing e aggiornare il file di configurazione se necessario .","title":"Dopo aver stampato correttamente per un po' di tempo senza ringing, sembra tornare"},{"location":"Resonance_Compensation.html#la-configurazione-a-doppio-carrello-e-supportata-con-gli-input-shaper","text":"Non esiste un supporto dedicato per doppi carrelli con input shaper, ma ci\u00f2 non significa che questa configurazione non funzioner\u00e0. Si dovrebbe eseguire la messa a punto due volte per ciascuno dei carrelli e calcolare le frequenze di ringing per gli assi X e Y per ciascuno dei carrelli in modo indipendente. Quindi inserisci i valori per il carrello 0 nella sezione [input_shaper] e modifica i valori al volo quando si cambiano i carrelli, ad es. come parte di alcune macro: SET_DUAL_CARRIAGE CARRIAGE=1 SET_INPUT_SHAPER SHAPER_FREQ_X=... SHAPER_FREQ_Y=... E allo stesso modo quando si torna al carrello 0.","title":"La configurazione a doppio carrello \u00e8 supportata con gli input shaper?"},{"location":"Resonance_Compensation.html#linput_shaper-influisce-sul-tempo-di-stampa","text":"No, la funzione input_shaper non ha praticamente alcun impatto sui tempi di stampa da sola. Tuttavia, il valore di max_accel lo fa certamente (regolazione di questo parametro descritta in questa sezione ).","title":"L'input_shaper influisce sul tempo di stampa?"},{"location":"Resonance_Compensation.html#dettagli-tecnici","text":"","title":"Dettagli tecnici"},{"location":"Resonance_Compensation.html#input-shaper","text":"Gli shaper di input utilizzati in Klipper sono piuttosto standard e si pu\u00f2 trovare una panoramica pi\u00f9 approfondita negli articoli che descrivono gli shaper corrispondenti. Questa sezione contiene una breve panoramica di alcuni aspetti tecnici degli input shaper supportati. La tabella seguente mostra alcuni parametri (solitamente approssimativi) di ciascun shaper. Input shaper Shaper duration Riduzione delle vibrazioni 20x (5% di tolleranza alle vibrazioni) Riduzione delle vibrazioni 10 volte (tolleranza alle vibrazioni del 10%) ZV 0.5 / shaper_freq N/A \u00b1 5% shaper_freq MZV 0.75 / shaper_freq \u00b1 4% shaper_freq -10%...+15% shaper_freq ZVD 1 / shaper_freq \u00b1 15% shaper_freq \u00b1 22% shaper_freq EI 1 / shaper_freq \u00b1 20% shaper_freq \u00b1 25% shaper_freq 2HUMP_EI 1.5 / shaper_freq \u00b1 35% shaper_freq \u00b1 40 shaper_freq 3HUMP_EI 2 / shaper_freq -45...+50% shaper_freq -50%...+55% shaper_freq Una nota sulla riduzione delle vibrazioni: i valori nella tabella sopra sono approssimativi. Se il rapporto di smorzamento della stampante \u00e8 noto per ciascun asse, lo shaper pu\u00f2 essere configurato in modo pi\u00f9 preciso e ridurr\u00e0 quindi le risonanze in una gamma di frequenze leggermente pi\u00f9 ampia. Tuttavia, il rapporto di smorzamento \u00e8 solitamente sconosciuto ed \u00e8 difficile da stimare senza un'attrezzatura speciale, quindi Klipper utilizza il valore 0,1 per impostazione predefinita, che \u00e8 un buon valore a tutto tondo. Le gamme di frequenza nella tabella coprono un numero di diversi possibili rapporti di smorzamento attorno a quel valore (da 0,05 a 0,2 circa). Si noti inoltre che EI, 2HUMP_EI e 3HUMP_EI sono sintonizzati per ridurre le vibrazioni al 5%, quindi i valori per la tolleranza alle vibrazioni del 10% sono forniti solo per riferimento. Come utilizzare questa tabella: La durata dello shaper influisce sull0 smoothing delle parti: pi\u00f9 \u00e8 grande, pi\u00f9 le parti sono lisce. Questa dipendenza non \u00e8 lineare, ma pu\u00f2 dare un'idea di quali shaper \"levigano\" di pi\u00f9 per la stessa frequenza. L'ordinamento per smoothing \u00e8 il seguente: ZV < MZV < ZVD \u2248 EI < 2HUMP_EI < 3HUMP_EI. Inoltre, raramente \u00e8 pratico impostare shaper_freq = resonance freq per gli shaper 2HUMP_EI e 3HUMP_EI (dovrebbero essere usati per ridurre le vibrazioni per diverse frequenze). Si pu\u00f2 stimare una gamma di frequenze in cui lo shaper riduce le vibrazioni. Ad esempio, MZV con shaper_freq = 35 Hz riduce le vibrazioni al 5% per le frequenze [33,6, 36,4] Hz. 3HUMP_EI con shaper_freq = 50 Hz riduce le vibrazioni al 5% nell'intervallo [27,5, 75] Hz. Si pu\u00f2 usare questa tabella per verificare quale shaper dovrebbero usare se hanno bisogno di ridurre le vibrazioni a diverse frequenze. Ad esempio, se si hanno risonanze a 35 Hz e 60 Hz sullo stesso asse: a) EI shaper deve avere shaper_freq = 35 / (1 - 0,2) = 43,75 Hz, e ridurr\u00e0 le risonanze fino a 43,75 * (1 + 0,2 ) = 52,5 Hz, quindi non \u00e8 sufficiente; b) 2HUMP_EI shaper deve avere shaper_freq = 35 / (1 - 0,35) = 53,85 Hz e ridurr\u00e0 le vibrazioni fino a 53,85 * (1 + 0,35) = 72,7 Hz - quindi questa \u00e8 una configurazione accettabile. Cerca sempre di usare shaper_freq il pi\u00f9 alto possibile per un dato shaper (magari con un certo margine di sicurezza, quindi in questo esempio shaper_freq \u2248 50-52 Hz funzionerebbe meglio), e prova a usare uno shaper con la minor durata possibile dello shaper. Se \u00e8 necessario ridurre le vibrazioni a diverse frequenze molto diverse (ad esempio, 30 Hz e 100 Hz), \u00e8 possibile che la tabella sopra non fornisca informazioni sufficienti. In questo caso si pu\u00f2 avere pi\u00f9 fortuna con lo script scripts/graph_shaper.py , che \u00e8 pi\u00f9 flessibile.","title":"Input shaper"},{"location":"Rotation_Distance.html","text":"Rotation distance \u00b6 I driver per motori passo-passo su Klipper richiedono un parametro rotation_distance in ciascuna stepper config section . La distanza_rotazione \u00e8 la distanza percorsa dall'asse con un giro completo del motore passo-passo relativo. Questo documento descrive come configurare questo valore. Ottenere rotation_distance da steps_per_mm (o step_distance) \u00b6 I progettisti della tua stampante 3d hanno originariamente calcolato steps_per_mm da una distanza di rotazione. Se conosci i passi_per_mm, \u00e8 possibile utilizzare questa formula generale per ottenere la distanza di rotazione originale: rotation_distance = <passi_completi_per_rotazione> * <micropassi> / <passi_per_mm> Oppure, se hai una configurazione di Klipper precedente e conosci il parametro step_distance puoi usare questa formula: rotation_distance = <passi_completi_per_rotazione> * <micropassi> * <distanza_passo> L'impostazione <full_steps_per_rotation> \u00e8 determinata dal tipo di motore passo-passo. La maggior parte dei motori passo-passo sono \"passi passo a 1,8 gradi\" e quindi hanno 200 passi completi per rotazione (360 diviso 1,8 fa 200). Alcuni motori passo passo sono \"passo passo a 0,9 gradi\" e quindi hanno 400 passi completi per rotazione. Altri motori passo-passo sono rari. In caso di dubbi, non impostare full_steps_per_rotation nel file di configurazione e utilizzare 200 nella formula sopra. L'impostazione <microsteps> \u00e8 determinata dal driver del motore passo-passo. La maggior parte dei driver utilizza 16 micropassi. Se non sei sicuro, imposta microsteps: 16 nella configurazione e usa 16 nella formula sopra. Quasi tutte le stampanti dovrebbero avere un numero intero per rotation_distance sugli assi di tipo X, Y e Z. Se la formula precedente risulta in una distanza_rotazione che \u00e8 entro .01 da un numero intero, arrotonda il valore finale a quel numero_intero. Calibrazione rotation_distance sugli estrusori \u00b6 Su un estrusore, la rotation_distance \u00e8 la distanza percorsa dal filamento per una rotazione completa del motore passo-passo. Il modo migliore per ottenere un valore accurato per questa impostazione \u00e8 utilizzare una procedura di \"misura e ritaglio\". Innanzitutto inizia con un'ipotesi iniziale per la distanza di rotazione. Questo pu\u00f2 essere ottenuto da steps_per_mm o ispezionando l'hardware . Quindi utilizzare la seguente procedura per \"misurare e tagliare\": Assicurati che l'estrusore contenga del filamento, che l'hotend sia riscaldato a una temperatura appropriata e che la stampante sia pronta per l'estrusione. Utilizzare un pennarello per posizionare un segno sul filamento a circa 70 mm dall'ingresso del corpo dell'estrusore. Quindi usa un calibro digitale per misurare la distanza effettiva di quel segno nel modo pi\u00f9 preciso possibile. Nota questo come <initial_mark_distance> . Estrudere 50 mm di filamento con la seguente sequenza di comandi: G91 seguito da G1 E50 F60 . Nota 50 mm come <distanza_estrusione_richiesta> . Attendi che l'estrusore finisca il movimento (ci vorranno circa 50 secondi). \u00c8 importante utilizzare la velocit\u00e0 di estrusione lenta per questo test poich\u00e9 una velocit\u00e0 pi\u00f9 elevata pu\u00f2 causare una pressione elevata nell'estrusore che distorce i risultati. (Non utilizzare il \"pulsante estrudi\" sui front-end grafici per questo test poich\u00e9 si estrudono a una velocit\u00e0 elevata.) Utilizzare un calibro digitale per misurare la nuova distanza tra il corpo dell'estrusore e il segno sul filamento. Annota questa come <subsequent_mark_distance> . Quindi calcola: actual_extrude_distance = <initial_mark_distance> - <subsequent_mark_distance> Calcola rotation_distance come: rotation_distance = <rotation_distance_precedente> * <actual_extrude_distance> / <requested_extrude_distance> Arrotonda la nuova rotation_distance a tre cifre decimali. Se la distanza_di_estrusione effettiva differisce dalla distanza_di_estrusione richiesta di oltre 2 mm circa, \u00e8 una buona idea eseguire i passaggi precedenti una seconda volta. Nota: non utilizzare un metodo di tipo \"misura e ritaglia\" per calibrare gli assi di tipo x, y o z. Il metodo \"misura e taglia\" non \u00e8 sufficientemente accurato per quegli assi e probabilmente porter\u00e0 a una configurazione peggiore. Invece, se necessario, quegli assi possono essere determinati measuring the belts, pulleys, and lead screw hardware . Ottenere la rotation_distance ispezionando l'hardware \u00b6 E' possibile calcolare rotation_distance conoscendo i motori passo-passo e la cinematica della stampante. Questo pu\u00f2 essere utile se i passi_per_mm non sono noti o se si sta progettando una nuova stampante. Assi con trasmissione a cinghia \u00b6 \u00c8 facile calcolare rotation_distance per un asse lineare che utilizza una cinghia e una puleggia. Per prima cosa determinare il tipo di cinghia. La maggior parte delle stampanti utilizza un passo della cinghia di 2 mm (ovvero, ogni dente sulla cinghia \u00e8 a 2 mm di distanza). Quindi contare il numero di denti sulla puleggia del motore passo-passo. La distanza_rotazione viene quindi calcolata come: rotation_distance = <passo_cinghia> * <numero_di_denti_sulla_puleggia> Ad esempio, se una stampante ha una cinghia da 2 mm e utilizza una puleggia con 20 denti, la distanza di rotazione \u00e8 40. Assi con vite di comando \u00b6 \u00c8 facile calcolare la rotation_distance per le comuni viti di trasmissione utilizzando la seguente formula: rotation_distance = <passo_vite> * <numero_di_filetti_separati> Ad esempio, la comune \"madrevite T8\" ha una rotation distance di 8 (ha un passo di 2 mm e ha 4 filetti separati). Le stampanti pi\u00f9 vecchie con \"barre filettate\" hanno un solo \"filo\" sulla vite di comando e quindi la rotation distance \u00e8 il passo della vite. (Il passo della vite \u00e8 la distanza tra ciascuna scanalatura sulla vite.) Quindi, ad esempio, un'asta metrica M6 ha una rotation distance di 1 e un'asta M8 ha una rotation distance di 1,25. Estrusore \u00b6 \u00c8 possibile ottenere una distanza di rotazione iniziale per gli estrusori misurando il diametro del \"bullone dentato\" che spinge il filamento e utilizzando la seguente formula: rotation_distance = <diametro> * 3.14 Se l'estrusore utilizza ingranaggi, sar\u00e0 anche necessario determinare e impostare gear_ratio per l'estrusore. La rotation distance effettiva su un estrusore varier\u00e0 da stampante a stampante, perch\u00e9 la presa del \"bullone dentato\" che impegna il filamento pu\u00f2 variare. Pu\u00f2 anche variare tra le bobine di filamento. Dopo aver ottenuto una rotation distance iniziale, utilizzare la procedura di misurazione e ritaglio per ottenere un'impostazione pi\u00f9 accurata. Usando un gear_ratio \u00b6 L'impostazione di un gear_ratio pu\u00f2 semplificare la configurazione di rotation_distance su stepper a cui \u00e8 collegato un gear box (o simile). La maggior parte degli stepper non ha un gear box - se non sei sicuro, non impostare gear_ratio nella configurazione. Quando gear_ratio \u00e8 impostato, rotation_distance rappresenta la distanza percorsa dall'asse con una rotazione completa dell'ingranaggio finale sulla scatola ingranaggi. Se, ad esempio, si utilizza un riduttore con un rapporto \"5:1\", \u00e8 possibile calcolare la distanza_rotazione con conoscenza dell'hardware e quindi aggiungere gear_ratio: 5:1 alla configurazione. Per gli ingranaggi realizzati con cinghie e pulegge, \u00e8 possibile determinare il gear_ratio contando i denti sulle pulegge. Ad esempio, se uno stepper con una puleggia a 16 denti guida la puleggia successiva con 80 denti, si utilizzer\u00e0 gear_ratio: 80:16 . In effetti, si potrebbe aprire una comune \"scatola del cambio\" pronta all'uso e contare i denti al suo interno per confermare il suo rapporto di trasmissione. Si noti che a volte un gear-box avr\u00e0 un rapporto di trasmissione leggermente diverso da quello in cui \u00e8 pubblicizzato. I comuni ingranaggi del motore dell'estrusore BMG ne sono un esempio: sono pubblicizzati come \"3:1\" ma in realt\u00e0 utilizzano ingranaggi \"50:17\". (L'uso di numeri di denti senza un denominatore comune pu\u00f2 migliorare l'usura complessiva degli ingranaggi poich\u00e9 i denti non sempre ingranano allo stesso modo ad ogni giro.) Il comune \"riduttore epicicloidale 5.18:1\" \u00e8 configurato in modo pi\u00f9 accurato con gear_ratio: 57:11 . Se su un asse vengono utilizzati pi\u00f9 ingranaggi, \u00e8 possibile fornire un elenco separato da virgole nel gear_ratio. Ad esempio, un cambio \"5:1\" che guida una puleggia da 16 a 80 denti potrebbe utilizzare gear_ratio: 5:1, 80:16 . Nella maggior parte dei casi, gear_ratio dovrebbe essere definito con numeri interi poich\u00e9 ingranaggi e pulegge comuni hanno un numero intero di denti su di essi. Tuttavia, nei casi in cui una cinghia aziona una puleggia usando l'attrito invece dei denti, pu\u00f2 avere senso utilizzare un numero in virgola mobile nel rapporto di trasmissione (ad esempio, gear_ratio: 107.237:16 ).","title":"Rotation distance"},{"location":"Rotation_Distance.html#rotation-distance","text":"I driver per motori passo-passo su Klipper richiedono un parametro rotation_distance in ciascuna stepper config section . La distanza_rotazione \u00e8 la distanza percorsa dall'asse con un giro completo del motore passo-passo relativo. Questo documento descrive come configurare questo valore.","title":"Rotation distance"},{"location":"Rotation_Distance.html#ottenere-rotation_distance-da-steps_per_mm-o-step_distance","text":"I progettisti della tua stampante 3d hanno originariamente calcolato steps_per_mm da una distanza di rotazione. Se conosci i passi_per_mm, \u00e8 possibile utilizzare questa formula generale per ottenere la distanza di rotazione originale: rotation_distance = <passi_completi_per_rotazione> * <micropassi> / <passi_per_mm> Oppure, se hai una configurazione di Klipper precedente e conosci il parametro step_distance puoi usare questa formula: rotation_distance = <passi_completi_per_rotazione> * <micropassi> * <distanza_passo> L'impostazione <full_steps_per_rotation> \u00e8 determinata dal tipo di motore passo-passo. La maggior parte dei motori passo-passo sono \"passi passo a 1,8 gradi\" e quindi hanno 200 passi completi per rotazione (360 diviso 1,8 fa 200). Alcuni motori passo passo sono \"passo passo a 0,9 gradi\" e quindi hanno 400 passi completi per rotazione. Altri motori passo-passo sono rari. In caso di dubbi, non impostare full_steps_per_rotation nel file di configurazione e utilizzare 200 nella formula sopra. L'impostazione <microsteps> \u00e8 determinata dal driver del motore passo-passo. La maggior parte dei driver utilizza 16 micropassi. Se non sei sicuro, imposta microsteps: 16 nella configurazione e usa 16 nella formula sopra. Quasi tutte le stampanti dovrebbero avere un numero intero per rotation_distance sugli assi di tipo X, Y e Z. Se la formula precedente risulta in una distanza_rotazione che \u00e8 entro .01 da un numero intero, arrotonda il valore finale a quel numero_intero.","title":"Ottenere rotation_distance da steps_per_mm (o step_distance)"},{"location":"Rotation_Distance.html#calibrazione-rotation_distance-sugli-estrusori","text":"Su un estrusore, la rotation_distance \u00e8 la distanza percorsa dal filamento per una rotazione completa del motore passo-passo. Il modo migliore per ottenere un valore accurato per questa impostazione \u00e8 utilizzare una procedura di \"misura e ritaglio\". Innanzitutto inizia con un'ipotesi iniziale per la distanza di rotazione. Questo pu\u00f2 essere ottenuto da steps_per_mm o ispezionando l'hardware . Quindi utilizzare la seguente procedura per \"misurare e tagliare\": Assicurati che l'estrusore contenga del filamento, che l'hotend sia riscaldato a una temperatura appropriata e che la stampante sia pronta per l'estrusione. Utilizzare un pennarello per posizionare un segno sul filamento a circa 70 mm dall'ingresso del corpo dell'estrusore. Quindi usa un calibro digitale per misurare la distanza effettiva di quel segno nel modo pi\u00f9 preciso possibile. Nota questo come <initial_mark_distance> . Estrudere 50 mm di filamento con la seguente sequenza di comandi: G91 seguito da G1 E50 F60 . Nota 50 mm come <distanza_estrusione_richiesta> . Attendi che l'estrusore finisca il movimento (ci vorranno circa 50 secondi). \u00c8 importante utilizzare la velocit\u00e0 di estrusione lenta per questo test poich\u00e9 una velocit\u00e0 pi\u00f9 elevata pu\u00f2 causare una pressione elevata nell'estrusore che distorce i risultati. (Non utilizzare il \"pulsante estrudi\" sui front-end grafici per questo test poich\u00e9 si estrudono a una velocit\u00e0 elevata.) Utilizzare un calibro digitale per misurare la nuova distanza tra il corpo dell'estrusore e il segno sul filamento. Annota questa come <subsequent_mark_distance> . Quindi calcola: actual_extrude_distance = <initial_mark_distance> - <subsequent_mark_distance> Calcola rotation_distance come: rotation_distance = <rotation_distance_precedente> * <actual_extrude_distance> / <requested_extrude_distance> Arrotonda la nuova rotation_distance a tre cifre decimali. Se la distanza_di_estrusione effettiva differisce dalla distanza_di_estrusione richiesta di oltre 2 mm circa, \u00e8 una buona idea eseguire i passaggi precedenti una seconda volta. Nota: non utilizzare un metodo di tipo \"misura e ritaglia\" per calibrare gli assi di tipo x, y o z. Il metodo \"misura e taglia\" non \u00e8 sufficientemente accurato per quegli assi e probabilmente porter\u00e0 a una configurazione peggiore. Invece, se necessario, quegli assi possono essere determinati measuring the belts, pulleys, and lead screw hardware .","title":"Calibrazione rotation_distance sugli estrusori"},{"location":"Rotation_Distance.html#ottenere-la-rotation_distance-ispezionando-lhardware","text":"E' possibile calcolare rotation_distance conoscendo i motori passo-passo e la cinematica della stampante. Questo pu\u00f2 essere utile se i passi_per_mm non sono noti o se si sta progettando una nuova stampante.","title":"Ottenere la rotation_distance ispezionando l'hardware"},{"location":"Rotation_Distance.html#assi-con-trasmissione-a-cinghia","text":"\u00c8 facile calcolare rotation_distance per un asse lineare che utilizza una cinghia e una puleggia. Per prima cosa determinare il tipo di cinghia. La maggior parte delle stampanti utilizza un passo della cinghia di 2 mm (ovvero, ogni dente sulla cinghia \u00e8 a 2 mm di distanza). Quindi contare il numero di denti sulla puleggia del motore passo-passo. La distanza_rotazione viene quindi calcolata come: rotation_distance = <passo_cinghia> * <numero_di_denti_sulla_puleggia> Ad esempio, se una stampante ha una cinghia da 2 mm e utilizza una puleggia con 20 denti, la distanza di rotazione \u00e8 40.","title":"Assi con trasmissione a cinghia"},{"location":"Rotation_Distance.html#assi-con-vite-di-comando","text":"\u00c8 facile calcolare la rotation_distance per le comuni viti di trasmissione utilizzando la seguente formula: rotation_distance = <passo_vite> * <numero_di_filetti_separati> Ad esempio, la comune \"madrevite T8\" ha una rotation distance di 8 (ha un passo di 2 mm e ha 4 filetti separati). Le stampanti pi\u00f9 vecchie con \"barre filettate\" hanno un solo \"filo\" sulla vite di comando e quindi la rotation distance \u00e8 il passo della vite. (Il passo della vite \u00e8 la distanza tra ciascuna scanalatura sulla vite.) Quindi, ad esempio, un'asta metrica M6 ha una rotation distance di 1 e un'asta M8 ha una rotation distance di 1,25.","title":"Assi con vite di comando"},{"location":"Rotation_Distance.html#estrusore","text":"\u00c8 possibile ottenere una distanza di rotazione iniziale per gli estrusori misurando il diametro del \"bullone dentato\" che spinge il filamento e utilizzando la seguente formula: rotation_distance = <diametro> * 3.14 Se l'estrusore utilizza ingranaggi, sar\u00e0 anche necessario determinare e impostare gear_ratio per l'estrusore. La rotation distance effettiva su un estrusore varier\u00e0 da stampante a stampante, perch\u00e9 la presa del \"bullone dentato\" che impegna il filamento pu\u00f2 variare. Pu\u00f2 anche variare tra le bobine di filamento. Dopo aver ottenuto una rotation distance iniziale, utilizzare la procedura di misurazione e ritaglio per ottenere un'impostazione pi\u00f9 accurata.","title":"Estrusore"},{"location":"Rotation_Distance.html#usando-un-gear_ratio","text":"L'impostazione di un gear_ratio pu\u00f2 semplificare la configurazione di rotation_distance su stepper a cui \u00e8 collegato un gear box (o simile). La maggior parte degli stepper non ha un gear box - se non sei sicuro, non impostare gear_ratio nella configurazione. Quando gear_ratio \u00e8 impostato, rotation_distance rappresenta la distanza percorsa dall'asse con una rotazione completa dell'ingranaggio finale sulla scatola ingranaggi. Se, ad esempio, si utilizza un riduttore con un rapporto \"5:1\", \u00e8 possibile calcolare la distanza_rotazione con conoscenza dell'hardware e quindi aggiungere gear_ratio: 5:1 alla configurazione. Per gli ingranaggi realizzati con cinghie e pulegge, \u00e8 possibile determinare il gear_ratio contando i denti sulle pulegge. Ad esempio, se uno stepper con una puleggia a 16 denti guida la puleggia successiva con 80 denti, si utilizzer\u00e0 gear_ratio: 80:16 . In effetti, si potrebbe aprire una comune \"scatola del cambio\" pronta all'uso e contare i denti al suo interno per confermare il suo rapporto di trasmissione. Si noti che a volte un gear-box avr\u00e0 un rapporto di trasmissione leggermente diverso da quello in cui \u00e8 pubblicizzato. I comuni ingranaggi del motore dell'estrusore BMG ne sono un esempio: sono pubblicizzati come \"3:1\" ma in realt\u00e0 utilizzano ingranaggi \"50:17\". (L'uso di numeri di denti senza un denominatore comune pu\u00f2 migliorare l'usura complessiva degli ingranaggi poich\u00e9 i denti non sempre ingranano allo stesso modo ad ogni giro.) Il comune \"riduttore epicicloidale 5.18:1\" \u00e8 configurato in modo pi\u00f9 accurato con gear_ratio: 57:11 . Se su un asse vengono utilizzati pi\u00f9 ingranaggi, \u00e8 possibile fornire un elenco separato da virgole nel gear_ratio. Ad esempio, un cambio \"5:1\" che guida una puleggia da 16 a 80 denti potrebbe utilizzare gear_ratio: 5:1, 80:16 . Nella maggior parte dei casi, gear_ratio dovrebbe essere definito con numeri interi poich\u00e9 ingranaggi e pulegge comuni hanno un numero intero di denti su di essi. Tuttavia, nei casi in cui una cinghia aziona una puleggia usando l'attrito invece dei denti, pu\u00f2 avere senso utilizzare un numero in virgola mobile nel rapporto di trasmissione (ad esempio, gear_ratio: 107.237:16 ).","title":"Usando un gear_ratio"},{"location":"SDCard_Updates.html","text":"Aggiornamenti scheda SD \u00b6 Molte delle schede controller oggi popolari vengono fornite con un bootloader in grado di aggiornare il firmware tramite scheda SD. Sebbene ci\u00f2 sia conveniente in molte circostanze, questi bootloader in genere non forniscono altro modo per aggiornare il firmware. Questo pu\u00f2 essere un fastidio se la tua scheda \u00e8 montata in una posizione di difficile accesso o se devi aggiornare spesso il firmware. Dopo che Klipper \u00e8 stato inizialmente flashato su un controller, \u00e8 possibile trasferire il nuovo firmware sulla scheda SD e avviare la procedura di flashing tramite ssh. Procedura di aggiornamento tipica \u00b6 La procedura per aggiornare il firmware dell'MCU utilizzando la scheda SD \u00e8 simile a quella di altri metodi. Invece di usare make flash \u00e8 necessario eseguire uno script di supporto, flash-sdcard.sh . L'aggiornamento di un BigTreeTech SKR 1.3 potrebbe essere simile al seguente: sudo service klipper stop cd ~/klipper git pull make clean make menuconfig make ./scripts/flash-sdcard.sh /dev/ttyACM0 btt-skr-v1.3 sudo service klipper start Spetta all'utente determinare la posizione del dispositivo e il nome della scheda. Se un utente ha bisogno di eseguire il flashing di pi\u00f9 schede, flash-sdcard.sh (o make flash se appropriato) dovrebbe essere eseguito per ciascuna scheda prima di riavviare il servizio Klipper. Le schede supportate possono essere elencate con il seguente comando: ./scripts/flash-sdcard.sh -l Se non vedi la tua scheda elencata, potrebbe essere necessario aggiungere una nuova definizione di scheda come descritto di seguito . Utilizzo avanzato \u00b6 I comandi precedenti presuppongono che l'MCU si connetta alla velocit\u00e0 di trasmissione predefinita di 250000 e che il firmware si trovi in ~/klipper/out/klipper.bin . Lo script flash-sdcard.sh fornisce opzioni per modificare queste impostazioni predefinite. Tutte le opzioni possono essere visualizzate dalla schermata della guida: ./scripts/flash-sdcard.sh -h SD Card upload utility for Klipper usage: flash_sdcard.sh [-h] [-l] [-c] [-b <baud>] [-f <firmware>] <device> <board> positional arguments: <device> device serial port <board> board type optional arguments: -h show this message -l list available boards -c run flash check/verify only (skip upload) -b <baud> serial baud rate (default is 250000) -f <firmware> path to klipper.bin Se la tua scheda \u00e8 stata flashata con un firmware che si connette a un baud rate personalizzato, \u00e8 possibile eseguire l'aggiornamento specificando l'opzione -b : ./scripts/flash-sdcard.sh -b 115200 /dev/ttyAMA0 btt-skr-v1.3 Se desideri eseguire il flashing di una build di Klipper situata in un luogo diverso da quello predefinito, puoi farlo specificando l'opzione -f : ./scripts/flash-sdcard.sh -f ~/downloads/klipper.bin /dev/ttyAMA0 btt-skr-v1.3 Nota che quando si aggiorna un MKS Robin E3 non \u00e8 necessario eseguire manualmente update_mks_robin.py e fornire il binario risultante a flash-sdcard.sh . Questa procedura \u00e8 automatizzata durante il processo di caricamento. L'opzione -c viene utilizzata per eseguire un controllo o un'operazione di sola verifica per testare se la scheda esegue correttamente il firmware specificato. Questa opzione \u00e8 destinata principalmente ai casi in cui \u00e8 necessario un ciclo di alimentazione manuale per completare la procedura di flashing, ad esempio con i bootloader che utilizzano la modalit\u00e0 SDIO anzich\u00e9 SPI per accedere alle proprie schede SD. (Vedi avvertenze di seguito) Ma pu\u00f2 anche essere utilizzato in qualsiasi momento per verificare se il codice visualizzato nella scheda corrisponde alla versione nella cartella build su qualsiasi scheda supportata. Avvertenze \u00b6 Come accennato nell'introduzione, questo metodo funziona solo per l'aggiornamento del firmware. La procedura di flashing iniziale deve essere eseguita manualmente secondo le istruzioni che si applicano alla scheda del controller. Sebbene sia possibile eseguire il flashing di una build che modifica il baud seriale o l'interfaccia di connessione (ad esempio: da USB a UART), la verifica avr\u00e0 sempre esito negativo poich\u00e9 lo script non sar\u00e0 in grado di riconnettersi all'MCU per verificare la versione corrente. Sono supportate solo le schede che utilizzano SPI per la comunicazione con scheda SD. Le schede che utilizzano SDIO, come Flymaker Flyboard e MKS Robin Nano V1/V2, non funzioneranno in modalit\u00e0 SDIO. Tuttavia, di solito \u00e8 possibile eseguire il flashing di tali schede utilizzando invece la modalit\u00e0 Software SPI. Ma se il bootloader della scheda utilizza solo la modalit\u00e0 SDIO per accedere alla scheda SD, sar\u00e0 necessario un ciclo di alimentazione della scheda e della scheda SD in modo che la modalit\u00e0 possa tornare da SPI a SDIO per completare il reflashing. Tali schede dovrebbero essere definite con skip_verify abilitato per saltare il passaggio di verifica immediatamente dopo il flashing. Quindi, dopo il ciclo di spegnimento manuale, \u00e8 possibile eseguire nuovamente lo stesso identico comando ./scripts/flash-sdcard.sh , ma aggiungere l'opzione -c per completare l'operazione di controllo/verifica. Vedere Flashing Boards that use SDIO per esempi. Definizioni della scheda \u00b6 Dovrebbero essere disponibili le schede pi\u00f9 comuni, tuttavia \u00e8 possibile aggiungere una nuova definizione di scheda, se necessario. Le definizioni delle schede si trovano in ~/klipper/scripts/spi_flash/board_defs.py . Le definizioni sono memorizzate nel dizionario, ad esempio: BOARD_DEFS = { 'generic-lpc1768' : { 'mcu' : \"lpc1768\" , 'spi_bus' : \"ssp1\" , \"cs_pin\" : \"P0.6\" }, ...< further definitions > } Possono essere specificati i seguenti campi: mcu : il tipo di mcu. Questo pu\u00f2 essere recuperato dopo aver configurato la build tramite make menuconfig eseguendo cat .config | grep CONFIG_MCU . Questo campo \u00e8 obbligatorio. spi_bus : il bus SPI collegato alla scheda SD. Questo dovrebbe essere recuperato dallo schema della scheda. Questo campo \u00e8 obbligatorio. cs_pin : il pin di selezione del chip collegato alla scheda SD. Questo dovrebbe essere recuperato dallo schema della scheda. Questo campo \u00e8 obbligatorio. firmware_path : il percorso sulla scheda SD in cui trasferire il firmware. L'impostazione predefinita \u00e8 firmware.bin . current_firmware_path : il percorso sulla scheda SD in cui si trova il file del firmware rinominato dopo un flash riuscito. L'impostazione predefinita \u00e8 'firmware.cur'. skip_verify : Definisce un valore booleano che dice agli script di saltare il passaggio di verifica del firmware durante il processo di flashing. L'impostazione predefinita \u00e8 False . Pu\u00f2 essere impostato su True per le schede che richiedono un ciclo di alimentazione manuale per completare il flashing. Per verificare il firmware in seguito, eseguire nuovamente lo script con l'opzione -c per eseguire lo step di verifica. Vedi le avvertenze con le schede SDIO Se \u00e8 richiesto il software SPI, il campo spi_bus deve essere impostato su swspi e deve essere specificato il seguente campo aggiuntivo: spi_pins : Dovrebbero essere 3 pin separati da virgola che sono collegati alla scheda SD nel formato miso,mosi,sclk`. Dovrebbe essere estremamente raro che sia necessario Software SPI, in genere solo le schede con errori di progettazione o le schede che normalmente supportano solo la modalit\u00e0 SDIO per la loro scheda SD lo richiederanno. La definizione della scheda btt-skr-pro fornisce un esempio della prima, e la definizione della scheda btt-octopus-f446-v1 fornisce un esempio della seconda. Prima di creare una nuova definizione di scheda, \u00e8 necessario verificare se una definizione di scheda esistente soddisfa i criteri necessari per la nuova scheda. Se questo \u00e8 il caso, pu\u00f2 essere specificato un BOARD_ALIAS . Ad esempio, \u00e8 possibile aggiungere il seguente alias per specificare my-new-board come alias per generic-lpc1768 : BOARD_ALIASES = { ...< previous aliases > , 'my-new-board' : BOARD_DEFS [ 'generic-lpc1768' ], } Se hai bisogno di una nuova definizione di scheda e ti senti a disagio con la procedura descritta sopra, ti consigliamo di rivolgerti a Klipper Community Discord . Flashing di schede che utilizzano SDIO \u00b6 Come menzionato nelle avvertenze , le schede il cui bootloader utilizza la modalit\u00e0 SDIO per accedere alla scheda SD richiedono un ciclo di alimentazione della scheda, e in particolare della scheda SD stessa, per passare dalla modalit\u00e0 SPI utilizzata durante la scrittura il file sulla scheda SD di nuovo in modalit\u00e0 SDIO affinch\u00e9 il bootloader lo inserisca nella scheda. Queste definizioni della scheda utilizzeranno il flag skip_verify , che indica allo strumento di flashing di interrompersi dopo aver scritto il firmware sulla scheda SD in modo che la scheda possa essere spenta e riaccesa manualmente e il passaggio di verifica posticipato fino al completamento. Esistono due scenari -- uno con l'host RPi in esecuzione su un alimentatore separato e l'altro quando l'host RPi \u00e8 in esecuzione con lo stesso alimentatore della scheda principale sottoposta a flashing. La differenza \u00e8 se \u00e8 necessario o meno spegnere anche l'RPi e quindi ssh di nuovo dopo che il flashing \u00e8 completo per eseguire il passaggio di verifica, o se la verifica pu\u00f2 essere eseguita immediatamente. Ecco alcuni esempi dei due scenari: Programmazione SDIO con RPi su alimentazione separata \u00b6 Una sessione tipica con l'RPi su un alimentatore separato \u00e8 simile alla seguente. Ovviamente, dovrai utilizzare il percorso del dispositivo e il nome della scheda corretti: sudo service klipper stop cd ~/klipper git pull make clean make menuconfig make ./scripts/flash-sdcard.sh /dev/ttyACM0 btt-octopus-f446-v1 [[[manually power-cycle the printer board here when instructed]]] ./scripts/flash-sdcard.sh -c /dev/ttyACM0 btt-octopus-f446-v1 sudo service klipper start Programmazione SDIO con RPi sullo stesso alimentatore \u00b6 Una sessione tipica con l'RPi sullo stesso alimentatore \u00e8 simile alla seguente. Ovviamente, dovrai utilizzare il percorso del dispositivo e il nome della scheda corretti: sudo service klipper stop cd ~/klipper git pull make clean make menuconfig make ./scripts/flash-sdcard.sh /dev/ttyACM0 btt-octopus-f446-v1 sudo shutdown -h now [[[wait for the RPi to shutdown, then power-cycle and ssh again to the RPi when it restarts]]] sudo service klipper stop cd ~/klipper ./scripts/flash-sdcard.sh -c /dev/ttyACM0 btt-octopus-f446-v1 sudo service klipper start In questo caso, poich\u00e9 \u00e8 in corso il riavvio dell'RPi Host, che riavvier\u00e0 il servizio klipper , \u00e8 necessario arrestare nuovamente klipper prima di eseguire il passaggio di verifica e riavviarlo al termine della verifica. Mappatura pin da SDIO a SPI \u00b6 Se lo schema della tua scheda utilizza SDIO per la sua scheda SD, puoi mappare i pin come descritto nella tabella seguente per determinare i pin SPI del software compatibili da assegnare nel file board_defs.py : Pin della scheda SD Pin della scheda micro SD Nome PIN SDIO Nome Pin SPI 9 1 DATA2 None (PU)* 1 2 CD/DATA3 CS 2 3 CMD MOSI 4 4 +3.3V (VDD) +3.3V (VDD) 5 5 CLK SCLK 3 6 GND (VSS) GND (VSS) 7 7 DATA0 MISO 8 8 DATA1 None (PU)* N/A 9 Card Detect (CD) Card Detect (CD) 6 10 GND GND * None (PU) indica un pin inutilizzato con una resistenza di pull-up","title":"Aggiornamenti scheda SD"},{"location":"SDCard_Updates.html#aggiornamenti-scheda-sd","text":"Molte delle schede controller oggi popolari vengono fornite con un bootloader in grado di aggiornare il firmware tramite scheda SD. Sebbene ci\u00f2 sia conveniente in molte circostanze, questi bootloader in genere non forniscono altro modo per aggiornare il firmware. Questo pu\u00f2 essere un fastidio se la tua scheda \u00e8 montata in una posizione di difficile accesso o se devi aggiornare spesso il firmware. Dopo che Klipper \u00e8 stato inizialmente flashato su un controller, \u00e8 possibile trasferire il nuovo firmware sulla scheda SD e avviare la procedura di flashing tramite ssh.","title":"Aggiornamenti scheda SD"},{"location":"SDCard_Updates.html#procedura-di-aggiornamento-tipica","text":"La procedura per aggiornare il firmware dell'MCU utilizzando la scheda SD \u00e8 simile a quella di altri metodi. Invece di usare make flash \u00e8 necessario eseguire uno script di supporto, flash-sdcard.sh . L'aggiornamento di un BigTreeTech SKR 1.3 potrebbe essere simile al seguente: sudo service klipper stop cd ~/klipper git pull make clean make menuconfig make ./scripts/flash-sdcard.sh /dev/ttyACM0 btt-skr-v1.3 sudo service klipper start Spetta all'utente determinare la posizione del dispositivo e il nome della scheda. Se un utente ha bisogno di eseguire il flashing di pi\u00f9 schede, flash-sdcard.sh (o make flash se appropriato) dovrebbe essere eseguito per ciascuna scheda prima di riavviare il servizio Klipper. Le schede supportate possono essere elencate con il seguente comando: ./scripts/flash-sdcard.sh -l Se non vedi la tua scheda elencata, potrebbe essere necessario aggiungere una nuova definizione di scheda come descritto di seguito .","title":"Procedura di aggiornamento tipica"},{"location":"SDCard_Updates.html#utilizzo-avanzato","text":"I comandi precedenti presuppongono che l'MCU si connetta alla velocit\u00e0 di trasmissione predefinita di 250000 e che il firmware si trovi in ~/klipper/out/klipper.bin . Lo script flash-sdcard.sh fornisce opzioni per modificare queste impostazioni predefinite. Tutte le opzioni possono essere visualizzate dalla schermata della guida: ./scripts/flash-sdcard.sh -h SD Card upload utility for Klipper usage: flash_sdcard.sh [-h] [-l] [-c] [-b <baud>] [-f <firmware>] <device> <board> positional arguments: <device> device serial port <board> board type optional arguments: -h show this message -l list available boards -c run flash check/verify only (skip upload) -b <baud> serial baud rate (default is 250000) -f <firmware> path to klipper.bin Se la tua scheda \u00e8 stata flashata con un firmware che si connette a un baud rate personalizzato, \u00e8 possibile eseguire l'aggiornamento specificando l'opzione -b : ./scripts/flash-sdcard.sh -b 115200 /dev/ttyAMA0 btt-skr-v1.3 Se desideri eseguire il flashing di una build di Klipper situata in un luogo diverso da quello predefinito, puoi farlo specificando l'opzione -f : ./scripts/flash-sdcard.sh -f ~/downloads/klipper.bin /dev/ttyAMA0 btt-skr-v1.3 Nota che quando si aggiorna un MKS Robin E3 non \u00e8 necessario eseguire manualmente update_mks_robin.py e fornire il binario risultante a flash-sdcard.sh . Questa procedura \u00e8 automatizzata durante il processo di caricamento. L'opzione -c viene utilizzata per eseguire un controllo o un'operazione di sola verifica per testare se la scheda esegue correttamente il firmware specificato. Questa opzione \u00e8 destinata principalmente ai casi in cui \u00e8 necessario un ciclo di alimentazione manuale per completare la procedura di flashing, ad esempio con i bootloader che utilizzano la modalit\u00e0 SDIO anzich\u00e9 SPI per accedere alle proprie schede SD. (Vedi avvertenze di seguito) Ma pu\u00f2 anche essere utilizzato in qualsiasi momento per verificare se il codice visualizzato nella scheda corrisponde alla versione nella cartella build su qualsiasi scheda supportata.","title":"Utilizzo avanzato"},{"location":"SDCard_Updates.html#avvertenze","text":"Come accennato nell'introduzione, questo metodo funziona solo per l'aggiornamento del firmware. La procedura di flashing iniziale deve essere eseguita manualmente secondo le istruzioni che si applicano alla scheda del controller. Sebbene sia possibile eseguire il flashing di una build che modifica il baud seriale o l'interfaccia di connessione (ad esempio: da USB a UART), la verifica avr\u00e0 sempre esito negativo poich\u00e9 lo script non sar\u00e0 in grado di riconnettersi all'MCU per verificare la versione corrente. Sono supportate solo le schede che utilizzano SPI per la comunicazione con scheda SD. Le schede che utilizzano SDIO, come Flymaker Flyboard e MKS Robin Nano V1/V2, non funzioneranno in modalit\u00e0 SDIO. Tuttavia, di solito \u00e8 possibile eseguire il flashing di tali schede utilizzando invece la modalit\u00e0 Software SPI. Ma se il bootloader della scheda utilizza solo la modalit\u00e0 SDIO per accedere alla scheda SD, sar\u00e0 necessario un ciclo di alimentazione della scheda e della scheda SD in modo che la modalit\u00e0 possa tornare da SPI a SDIO per completare il reflashing. Tali schede dovrebbero essere definite con skip_verify abilitato per saltare il passaggio di verifica immediatamente dopo il flashing. Quindi, dopo il ciclo di spegnimento manuale, \u00e8 possibile eseguire nuovamente lo stesso identico comando ./scripts/flash-sdcard.sh , ma aggiungere l'opzione -c per completare l'operazione di controllo/verifica. Vedere Flashing Boards that use SDIO per esempi.","title":"Avvertenze"},{"location":"SDCard_Updates.html#definizioni-della-scheda","text":"Dovrebbero essere disponibili le schede pi\u00f9 comuni, tuttavia \u00e8 possibile aggiungere una nuova definizione di scheda, se necessario. Le definizioni delle schede si trovano in ~/klipper/scripts/spi_flash/board_defs.py . Le definizioni sono memorizzate nel dizionario, ad esempio: BOARD_DEFS = { 'generic-lpc1768' : { 'mcu' : \"lpc1768\" , 'spi_bus' : \"ssp1\" , \"cs_pin\" : \"P0.6\" }, ...< further definitions > } Possono essere specificati i seguenti campi: mcu : il tipo di mcu. Questo pu\u00f2 essere recuperato dopo aver configurato la build tramite make menuconfig eseguendo cat .config | grep CONFIG_MCU . Questo campo \u00e8 obbligatorio. spi_bus : il bus SPI collegato alla scheda SD. Questo dovrebbe essere recuperato dallo schema della scheda. Questo campo \u00e8 obbligatorio. cs_pin : il pin di selezione del chip collegato alla scheda SD. Questo dovrebbe essere recuperato dallo schema della scheda. Questo campo \u00e8 obbligatorio. firmware_path : il percorso sulla scheda SD in cui trasferire il firmware. L'impostazione predefinita \u00e8 firmware.bin . current_firmware_path : il percorso sulla scheda SD in cui si trova il file del firmware rinominato dopo un flash riuscito. L'impostazione predefinita \u00e8 'firmware.cur'. skip_verify : Definisce un valore booleano che dice agli script di saltare il passaggio di verifica del firmware durante il processo di flashing. L'impostazione predefinita \u00e8 False . Pu\u00f2 essere impostato su True per le schede che richiedono un ciclo di alimentazione manuale per completare il flashing. Per verificare il firmware in seguito, eseguire nuovamente lo script con l'opzione -c per eseguire lo step di verifica. Vedi le avvertenze con le schede SDIO Se \u00e8 richiesto il software SPI, il campo spi_bus deve essere impostato su swspi e deve essere specificato il seguente campo aggiuntivo: spi_pins : Dovrebbero essere 3 pin separati da virgola che sono collegati alla scheda SD nel formato miso,mosi,sclk`. Dovrebbe essere estremamente raro che sia necessario Software SPI, in genere solo le schede con errori di progettazione o le schede che normalmente supportano solo la modalit\u00e0 SDIO per la loro scheda SD lo richiederanno. La definizione della scheda btt-skr-pro fornisce un esempio della prima, e la definizione della scheda btt-octopus-f446-v1 fornisce un esempio della seconda. Prima di creare una nuova definizione di scheda, \u00e8 necessario verificare se una definizione di scheda esistente soddisfa i criteri necessari per la nuova scheda. Se questo \u00e8 il caso, pu\u00f2 essere specificato un BOARD_ALIAS . Ad esempio, \u00e8 possibile aggiungere il seguente alias per specificare my-new-board come alias per generic-lpc1768 : BOARD_ALIASES = { ...< previous aliases > , 'my-new-board' : BOARD_DEFS [ 'generic-lpc1768' ], } Se hai bisogno di una nuova definizione di scheda e ti senti a disagio con la procedura descritta sopra, ti consigliamo di rivolgerti a Klipper Community Discord .","title":"Definizioni della scheda"},{"location":"SDCard_Updates.html#flashing-di-schede-che-utilizzano-sdio","text":"Come menzionato nelle avvertenze , le schede il cui bootloader utilizza la modalit\u00e0 SDIO per accedere alla scheda SD richiedono un ciclo di alimentazione della scheda, e in particolare della scheda SD stessa, per passare dalla modalit\u00e0 SPI utilizzata durante la scrittura il file sulla scheda SD di nuovo in modalit\u00e0 SDIO affinch\u00e9 il bootloader lo inserisca nella scheda. Queste definizioni della scheda utilizzeranno il flag skip_verify , che indica allo strumento di flashing di interrompersi dopo aver scritto il firmware sulla scheda SD in modo che la scheda possa essere spenta e riaccesa manualmente e il passaggio di verifica posticipato fino al completamento. Esistono due scenari -- uno con l'host RPi in esecuzione su un alimentatore separato e l'altro quando l'host RPi \u00e8 in esecuzione con lo stesso alimentatore della scheda principale sottoposta a flashing. La differenza \u00e8 se \u00e8 necessario o meno spegnere anche l'RPi e quindi ssh di nuovo dopo che il flashing \u00e8 completo per eseguire il passaggio di verifica, o se la verifica pu\u00f2 essere eseguita immediatamente. Ecco alcuni esempi dei due scenari:","title":"Flashing di schede che utilizzano SDIO"},{"location":"SDCard_Updates.html#programmazione-sdio-con-rpi-su-alimentazione-separata","text":"Una sessione tipica con l'RPi su un alimentatore separato \u00e8 simile alla seguente. Ovviamente, dovrai utilizzare il percorso del dispositivo e il nome della scheda corretti: sudo service klipper stop cd ~/klipper git pull make clean make menuconfig make ./scripts/flash-sdcard.sh /dev/ttyACM0 btt-octopus-f446-v1 [[[manually power-cycle the printer board here when instructed]]] ./scripts/flash-sdcard.sh -c /dev/ttyACM0 btt-octopus-f446-v1 sudo service klipper start","title":"Programmazione SDIO con RPi su alimentazione separata"},{"location":"SDCard_Updates.html#programmazione-sdio-con-rpi-sullo-stesso-alimentatore","text":"Una sessione tipica con l'RPi sullo stesso alimentatore \u00e8 simile alla seguente. Ovviamente, dovrai utilizzare il percorso del dispositivo e il nome della scheda corretti: sudo service klipper stop cd ~/klipper git pull make clean make menuconfig make ./scripts/flash-sdcard.sh /dev/ttyACM0 btt-octopus-f446-v1 sudo shutdown -h now [[[wait for the RPi to shutdown, then power-cycle and ssh again to the RPi when it restarts]]] sudo service klipper stop cd ~/klipper ./scripts/flash-sdcard.sh -c /dev/ttyACM0 btt-octopus-f446-v1 sudo service klipper start In questo caso, poich\u00e9 \u00e8 in corso il riavvio dell'RPi Host, che riavvier\u00e0 il servizio klipper , \u00e8 necessario arrestare nuovamente klipper prima di eseguire il passaggio di verifica e riavviarlo al termine della verifica.","title":"Programmazione SDIO con RPi sullo stesso alimentatore"},{"location":"SDCard_Updates.html#mappatura-pin-da-sdio-a-spi","text":"Se lo schema della tua scheda utilizza SDIO per la sua scheda SD, puoi mappare i pin come descritto nella tabella seguente per determinare i pin SPI del software compatibili da assegnare nel file board_defs.py : Pin della scheda SD Pin della scheda micro SD Nome PIN SDIO Nome Pin SPI 9 1 DATA2 None (PU)* 1 2 CD/DATA3 CS 2 3 CMD MOSI 4 4 +3.3V (VDD) +3.3V (VDD) 5 5 CLK SCLK 3 6 GND (VSS) GND (VSS) 7 7 DATA0 MISO 8 8 DATA1 None (PU)* N/A 9 Card Detect (CD) Card Detect (CD) 6 10 GND GND * None (PU) indica un pin inutilizzato con una resistenza di pull-up","title":"Mappatura pin da SDIO a SPI"},{"location":"Skew_Correction.html","text":"Correzione dell'inclinazione \u00b6 La correzione dell'inclinazione basata su software pu\u00f2 aiutare a risolvere le imprecisioni dimensionali risultanti da un gruppo stampante non perfettamente in squadrato. Si noti che se la stampante \u00e8 notevolmente inclinata, si consiglia vivamente di utilizzare prima mezzi meccanici per ottenere la stampante il pi\u00f9 squadrata possibile prima di applicare la correzione basata sul software. Stampa un oggetto di calibrazione \u00b6 Il primo passaggio per correggere l'inclinazione \u00e8 stampare un calibration object lungo il piano che si desidera correggere. C'\u00e8 anche un calibration object che include tutti i piani in un modello. Vuoi che l'oggetto sia orientato in modo che l'angolo A sia verso l'origine del piano. Assicurarsi che durante questa stampa non venga applicata alcuna correzione dell'inclinazione. Puoi farlo rimuovendo il modulo [skew_correction] da printer.cfg o inserendo un gcode SET_SKEW CLEAR=1 . Prendi le tue misure \u00b6 Il modulo [skew_correcton] richiede 3 misurazioni per ogni piano che vuoi correggere; la lunghezza dall'angolo A all'angolo C, la lunghezza dall'angolo B all'angolo D e la lunghezza dall'angolo A all'angolo D. Quando si misura la lunghezza AD non includere i piani sugli angoli forniti da alcuni oggetti di prova. Configura la tua inclinazione \u00b6 Assicurati che la sezione [skew_correction] sia in printer.cfg. Ora puoi usare il gcode SET_SKEW per configurare skew_correcton. Ad esempio, se le lunghezze misurate lungo XY sono le seguenti: Length AC = 140.4 Length BD = 142.8 Length AD = 99.8 SET_SKEW pu\u00f2 essere utilizzato per configurare la correzione dell'inclinazione per il piano XY. SET_SKEW XY=140.4,142.8,99.8 Puoi anche aggiungere misure per XZ e YZ al gcode: SET_SKEW XY=140.4,142.8,99.8 XZ=141.6,141.4,99.8 YZ=142.4,140.5,99.5 Il modulo [skew_correction] supporta anche la gestione del profilo in un modo simile a [bed_mesh] . Dopo aver impostato l'inclinazione usando il gcode SET_SKEW , puoi usare il gcode SKEW_PROFILE per salvarlo: SKEW_PROFILE SAVE=my_skew_profile Dopo questo comando ti verr\u00e0 chiesto di emettere un gcode SAVE_CONFIG per salvare il profilo nella memoria permanente. Se nessun profilo \u00e8 denominato my_skew_profile , verr\u00e0 creato un nuovo profilo. Se il profilo indicato esiste, verr\u00e0 sovrascritto. Una volta che hai un profilo salvato, puoi caricarlo: SKEW_PROFILE LOAD=my_skew_profile \u00c8 anche possibile rimuovere un profilo vecchio o superato: SKEW_PROFILE REMOVE=my_skew_profile Dopo aver rimosso un profilo, ti verr\u00e0 chiesto di emettere un SAVE_CONFIG per far s\u00ec che questa modifica persista. Verifica della tua correzione \u00b6 Dopo aver configurato skew_correction \u00e8 possibile ristampare la parte di calibrazione con la correzione abilitata. Usa il seguente gcode per controllare la tua inclinazione su ciascun piano. I risultati dovrebbero essere inferiori a quelli riportati tramite GET_CURRENT_SKEW . CALC_MEASURED_SKEW AC=<ac_length> BD=<bd_length> AD=<ad_length> Avvertenze \u00b6 A causa della natura della correzione dell'inclinazione, si consiglia di configurare l'inclinazione nel codice g iniziale, dopo l'homing e qualsiasi tipo di movimento che si sposta vicino al bordo dell'area di stampa, come uno spurgo o una pulizia degli ugelli. \u00c8 possibile utilizzare i codici g \"SET_SKEW\" o \"SKEW_PROFILE\" per ottenere ci\u00f2. Si consiglia inoltre di emettere un SET_SKEW CLEAR=1 alla fine del gcode. Tenere presente che \u00e8 possibile che [skew_correction] generi una correzione che sposti la testa oltre i limiti della stampante sugli assi X e/o Y. Si consiglia di disporre le parti lontano dai bordi quando si utilizza [skew_correction] .","title":"Correzione dell'inclinazione"},{"location":"Skew_Correction.html#correzione-dellinclinazione","text":"La correzione dell'inclinazione basata su software pu\u00f2 aiutare a risolvere le imprecisioni dimensionali risultanti da un gruppo stampante non perfettamente in squadrato. Si noti che se la stampante \u00e8 notevolmente inclinata, si consiglia vivamente di utilizzare prima mezzi meccanici per ottenere la stampante il pi\u00f9 squadrata possibile prima di applicare la correzione basata sul software.","title":"Correzione dell'inclinazione"},{"location":"Skew_Correction.html#stampa-un-oggetto-di-calibrazione","text":"Il primo passaggio per correggere l'inclinazione \u00e8 stampare un calibration object lungo il piano che si desidera correggere. C'\u00e8 anche un calibration object che include tutti i piani in un modello. Vuoi che l'oggetto sia orientato in modo che l'angolo A sia verso l'origine del piano. Assicurarsi che durante questa stampa non venga applicata alcuna correzione dell'inclinazione. Puoi farlo rimuovendo il modulo [skew_correction] da printer.cfg o inserendo un gcode SET_SKEW CLEAR=1 .","title":"Stampa un oggetto di calibrazione"},{"location":"Skew_Correction.html#prendi-le-tue-misure","text":"Il modulo [skew_correcton] richiede 3 misurazioni per ogni piano che vuoi correggere; la lunghezza dall'angolo A all'angolo C, la lunghezza dall'angolo B all'angolo D e la lunghezza dall'angolo A all'angolo D. Quando si misura la lunghezza AD non includere i piani sugli angoli forniti da alcuni oggetti di prova.","title":"Prendi le tue misure"},{"location":"Skew_Correction.html#configura-la-tua-inclinazione","text":"Assicurati che la sezione [skew_correction] sia in printer.cfg. Ora puoi usare il gcode SET_SKEW per configurare skew_correcton. Ad esempio, se le lunghezze misurate lungo XY sono le seguenti: Length AC = 140.4 Length BD = 142.8 Length AD = 99.8 SET_SKEW pu\u00f2 essere utilizzato per configurare la correzione dell'inclinazione per il piano XY. SET_SKEW XY=140.4,142.8,99.8 Puoi anche aggiungere misure per XZ e YZ al gcode: SET_SKEW XY=140.4,142.8,99.8 XZ=141.6,141.4,99.8 YZ=142.4,140.5,99.5 Il modulo [skew_correction] supporta anche la gestione del profilo in un modo simile a [bed_mesh] . Dopo aver impostato l'inclinazione usando il gcode SET_SKEW , puoi usare il gcode SKEW_PROFILE per salvarlo: SKEW_PROFILE SAVE=my_skew_profile Dopo questo comando ti verr\u00e0 chiesto di emettere un gcode SAVE_CONFIG per salvare il profilo nella memoria permanente. Se nessun profilo \u00e8 denominato my_skew_profile , verr\u00e0 creato un nuovo profilo. Se il profilo indicato esiste, verr\u00e0 sovrascritto. Una volta che hai un profilo salvato, puoi caricarlo: SKEW_PROFILE LOAD=my_skew_profile \u00c8 anche possibile rimuovere un profilo vecchio o superato: SKEW_PROFILE REMOVE=my_skew_profile Dopo aver rimosso un profilo, ti verr\u00e0 chiesto di emettere un SAVE_CONFIG per far s\u00ec che questa modifica persista.","title":"Configura la tua inclinazione"},{"location":"Skew_Correction.html#verifica-della-tua-correzione","text":"Dopo aver configurato skew_correction \u00e8 possibile ristampare la parte di calibrazione con la correzione abilitata. Usa il seguente gcode per controllare la tua inclinazione su ciascun piano. I risultati dovrebbero essere inferiori a quelli riportati tramite GET_CURRENT_SKEW . CALC_MEASURED_SKEW AC=<ac_length> BD=<bd_length> AD=<ad_length>","title":"Verifica della tua correzione"},{"location":"Skew_Correction.html#avvertenze","text":"A causa della natura della correzione dell'inclinazione, si consiglia di configurare l'inclinazione nel codice g iniziale, dopo l'homing e qualsiasi tipo di movimento che si sposta vicino al bordo dell'area di stampa, come uno spurgo o una pulizia degli ugelli. \u00c8 possibile utilizzare i codici g \"SET_SKEW\" o \"SKEW_PROFILE\" per ottenere ci\u00f2. Si consiglia inoltre di emettere un SET_SKEW CLEAR=1 alla fine del gcode. Tenere presente che \u00e8 possibile che [skew_correction] generi una correzione che sposti la testa oltre i limiti della stampante sugli assi X e/o Y. Si consiglia di disporre le parti lontano dai bordi quando si utilizza [skew_correction] .","title":"Avvertenze"},{"location":"Slicers.html","text":"slicer \u00b6 Questo documento fornisce alcuni suggerimenti per configurare un'applicazione \"slicer\" da usare con Klipper. Gli slicer comuni usati con Klipper sono Slic3r, Cura, Simplify3D, ecc. Imposta il Gcode su variante Marlin \u00b6 Molti slicer hanno un'opzione per configurare il \"gusto G-Code\" o G-Code flavor. L'impostazione predefinita \u00e8 spesso \"Marlin\" e funziona bene con Klipper. L'impostazione \"Smoothieware\" funziona bene anche con Klipper. Klipper gcode_macro \u00b6 Gli slicer spesso consentono di configurare le sequenze \"Start G-Code\" e \"End G-Code\". Spesso \u00e8 invece conveniente definire macro personalizzate nel file di configurazione di Klipper, come ad esempio: [gcode_macro START_PRINT] e [gcode_macro END_PRINT] . Quindi puoi semplicemente eseguire START_PRINT e END_PRINT nella configurazione dello slicer. La definizione di queste azioni nella configurazione di Klipper pu\u00f2 rendere pi\u00f9 semplice modificare i passaggi iniziali e finali della stampante poich\u00e9 le modifiche non richiedono il re-slicing. Vedere sample-macros.cfg ad esempio le macro START_PRINT e END_PRINT. Vedere il config reference per i dettagli sulla definizione di una macro gcode. Impostazioni di retrazione di grandi dimensioni potrebbero richiedere la messa a punto di Klipper \u00b6 La velocit\u00e0 massima e l'accelerazione dei movimenti di ritrazione sono controllate in Klipper dalle impostazioni di configurazione max_extrude_only_velocity e max_extrude_only_accel . Queste impostazioni hanno un valore predefinito che dovrebbe funzionare bene su molte stampanti. Tuttavia, se si \u00e8 configurata una grande retrazione nello slicer (ad es. 5 mm o superiore), \u00e8 possibile che limitino la velocit\u00e0 di retrazione desiderata. Se si utilizza una grande retrazione, prendere in considerazione l'ottimizzazione di pressure advance di Klipper. Altrimenti, se si scopre che la testa di stampa sembra \"mettersi in pausa\" durante la retrazione e il priming, allora considerare di definire esplicitamente max_extrude_only_velocity e max_extrude_only_accel nel file di configurazione di Klipper. Non abilitare \"coasting\" -costeggiando- \u00b6 \u00c8 probabile che la funzione \"coasting\" si traduca in stampe di scarsa qualit\u00e0 con Klipper. Prendi in considerazione l'utilizzo di pressure advance di Klipper. In particolare, se lo slicer cambia drasticamente la velocit\u00e0 di estrusione tra i movimenti, Klipper eseguir\u00e0 la decelerazione e l'accelerazione tra i movimenti. \u00c8 probabile che questo renda il blobbing peggiore, non migliore. Al contrario, va bene (e spesso utile) utilizzare l'impostazione ritiro \"retract\" , l'impostazione pulire \"wipe\" e/o l'impostazione pulire alla retrazione \"wipe on retract\". Non utilizzare la \"distanza di riavvio extra\"- \"extra restart distance\"su Simplify3d \u00b6 Questa impostazione pu\u00f2 causare cambiamenti radicali alle velocit\u00e0 di estrusione che possono attivare il controllo della sezione trasversale di estrusione massima di Klipper. Prendi in considerazione l'utilizzo dell' pressure advance di Klipper o della normale impostazione di retrazione Simplify3d. Disabilita \"PreloadVE\" su KISSlicer \u00b6 Se si utilizza il software di slicing KISSlicer, impostare \"PreloadVE\" su zero. Prendi in considerazione l'utilizzo di pressure advance di Klipper. Disattiva le impostazioni di \"pressione dell'estrusore avanzata\"-\"advanced extruder pressure\" \u00b6 Alcune affettatrici pubblicizzano una capacit\u00e0 di \"pressione dell'estrusore avanzata\" - \"advanced extruder pressure\". Si consiglia di mantenere queste opzioni disabilitate quando si utilizza Klipper poich\u00e9 \u00e8 probabile che si traducano in stampe di scarsa qualit\u00e0. Prendi in considerazione l'utilizzo di pressure advance di Klipper. In particolare, queste impostazioni dello slicer possono indicare al firmware di apportare modifiche alla velocit\u00e0 di estrusione nella speranza che il firmware si avvicini a tali richieste e che la stampante ottenga approssimativamente una pressione dell'estrusore desiderabile. Klipper, tuttavia, utilizza calcoli cinematici e tempi precisi. Quando a Klipper viene comandato di apportare modifiche significative alla velocit\u00e0 di estrusione, pianificher\u00e0 le modifiche corrispondenti a velocit\u00e0, accelerazione e movimento dell'estrusore, il che non \u00e8 l'intento dello slicer. Lo slicer pu\u00f2 anche comandare velocit\u00e0 di estrusione eccessive al punto da attivare il controllo della sezione trasversale di estrusione massima di Klipper. Al contrario, va bene (e spesso utile) utilizzare l'impostazione ritiro \"retract\" , l'impostazione pulire \"wipe\" e/o l'impostazione pulire alla retrazione \"wipe on retract\".","title":"slicer"},{"location":"Slicers.html#slicer","text":"Questo documento fornisce alcuni suggerimenti per configurare un'applicazione \"slicer\" da usare con Klipper. Gli slicer comuni usati con Klipper sono Slic3r, Cura, Simplify3D, ecc.","title":"slicer"},{"location":"Slicers.html#imposta-il-gcode-su-variante-marlin","text":"Molti slicer hanno un'opzione per configurare il \"gusto G-Code\" o G-Code flavor. L'impostazione predefinita \u00e8 spesso \"Marlin\" e funziona bene con Klipper. L'impostazione \"Smoothieware\" funziona bene anche con Klipper.","title":"Imposta il Gcode su variante Marlin"},{"location":"Slicers.html#klipper-gcode_macro","text":"Gli slicer spesso consentono di configurare le sequenze \"Start G-Code\" e \"End G-Code\". Spesso \u00e8 invece conveniente definire macro personalizzate nel file di configurazione di Klipper, come ad esempio: [gcode_macro START_PRINT] e [gcode_macro END_PRINT] . Quindi puoi semplicemente eseguire START_PRINT e END_PRINT nella configurazione dello slicer. La definizione di queste azioni nella configurazione di Klipper pu\u00f2 rendere pi\u00f9 semplice modificare i passaggi iniziali e finali della stampante poich\u00e9 le modifiche non richiedono il re-slicing. Vedere sample-macros.cfg ad esempio le macro START_PRINT e END_PRINT. Vedere il config reference per i dettagli sulla definizione di una macro gcode.","title":"Klipper gcode_macro"},{"location":"Slicers.html#impostazioni-di-retrazione-di-grandi-dimensioni-potrebbero-richiedere-la-messa-a-punto-di-klipper","text":"La velocit\u00e0 massima e l'accelerazione dei movimenti di ritrazione sono controllate in Klipper dalle impostazioni di configurazione max_extrude_only_velocity e max_extrude_only_accel . Queste impostazioni hanno un valore predefinito che dovrebbe funzionare bene su molte stampanti. Tuttavia, se si \u00e8 configurata una grande retrazione nello slicer (ad es. 5 mm o superiore), \u00e8 possibile che limitino la velocit\u00e0 di retrazione desiderata. Se si utilizza una grande retrazione, prendere in considerazione l'ottimizzazione di pressure advance di Klipper. Altrimenti, se si scopre che la testa di stampa sembra \"mettersi in pausa\" durante la retrazione e il priming, allora considerare di definire esplicitamente max_extrude_only_velocity e max_extrude_only_accel nel file di configurazione di Klipper.","title":"Impostazioni di retrazione di grandi dimensioni potrebbero richiedere la messa a punto di Klipper"},{"location":"Slicers.html#non-abilitare-coasting-costeggiando-","text":"\u00c8 probabile che la funzione \"coasting\" si traduca in stampe di scarsa qualit\u00e0 con Klipper. Prendi in considerazione l'utilizzo di pressure advance di Klipper. In particolare, se lo slicer cambia drasticamente la velocit\u00e0 di estrusione tra i movimenti, Klipper eseguir\u00e0 la decelerazione e l'accelerazione tra i movimenti. \u00c8 probabile che questo renda il blobbing peggiore, non migliore. Al contrario, va bene (e spesso utile) utilizzare l'impostazione ritiro \"retract\" , l'impostazione pulire \"wipe\" e/o l'impostazione pulire alla retrazione \"wipe on retract\".","title":"Non abilitare \"coasting\" -costeggiando-"},{"location":"Slicers.html#non-utilizzare-la-distanza-di-riavvio-extra-extra-restart-distancesu-simplify3d","text":"Questa impostazione pu\u00f2 causare cambiamenti radicali alle velocit\u00e0 di estrusione che possono attivare il controllo della sezione trasversale di estrusione massima di Klipper. Prendi in considerazione l'utilizzo dell' pressure advance di Klipper o della normale impostazione di retrazione Simplify3d.","title":"Non utilizzare la \"distanza di riavvio extra\"- \"extra restart distance\"su Simplify3d"},{"location":"Slicers.html#disabilita-preloadve-su-kisslicer","text":"Se si utilizza il software di slicing KISSlicer, impostare \"PreloadVE\" su zero. Prendi in considerazione l'utilizzo di pressure advance di Klipper.","title":"Disabilita \"PreloadVE\" su KISSlicer"},{"location":"Slicers.html#disattiva-le-impostazioni-di-pressione-dellestrusore-avanzata-advanced-extruder-pressure","text":"Alcune affettatrici pubblicizzano una capacit\u00e0 di \"pressione dell'estrusore avanzata\" - \"advanced extruder pressure\". Si consiglia di mantenere queste opzioni disabilitate quando si utilizza Klipper poich\u00e9 \u00e8 probabile che si traducano in stampe di scarsa qualit\u00e0. Prendi in considerazione l'utilizzo di pressure advance di Klipper. In particolare, queste impostazioni dello slicer possono indicare al firmware di apportare modifiche alla velocit\u00e0 di estrusione nella speranza che il firmware si avvicini a tali richieste e che la stampante ottenga approssimativamente una pressione dell'estrusore desiderabile. Klipper, tuttavia, utilizza calcoli cinematici e tempi precisi. Quando a Klipper viene comandato di apportare modifiche significative alla velocit\u00e0 di estrusione, pianificher\u00e0 le modifiche corrispondenti a velocit\u00e0, accelerazione e movimento dell'estrusore, il che non \u00e8 l'intento dello slicer. Lo slicer pu\u00f2 anche comandare velocit\u00e0 di estrusione eccessive al punto da attivare il controllo della sezione trasversale di estrusione massima di Klipper. Al contrario, va bene (e spesso utile) utilizzare l'impostazione ritiro \"retract\" , l'impostazione pulire \"wipe\" e/o l'impostazione pulire alla retrazione \"wipe on retract\".","title":"Disattiva le impostazioni di \"pressione dell'estrusore avanzata\"-\"advanced extruder pressure\""},{"location":"Sponsors.html","text":"Sponsors \u00b6 Klipper \u00e8 un software libero. Dipendiamo dal generoso supporto degli sponsor. Considera la possibilit\u00e0 di sponsorizzare Klipper o di supportare i nostri sponsor. BIGTREETECH \u00b6 [ BIGTREETECH \u00e8 lo sponsor ufficiale della scheda madre di Klipper. BIGTREETECH si impegna a sviluppare prodotti innovativi e competitivi per servire meglio la comunit\u00e0 della stampa 3D. Seguili su Facebook o Twitter . Sviluppatori Klipper \u00b6 Kevin O'Connor \u00b6 Kevin \u00e8 l'autore originale e l'attuale manutentore di Klipper. Fai una donazione su: https://ko-fi.com/koconnor o https://www.patreon.com/koconnor Eric Callahan \u00b6 Eric \u00e8 l'autore di bed_mesh, spi_flash e molti altri moduli Klipper. Eric ha una pagina per le donazioni : https://ko-fi.com/arksine Progetti correlati a Klipper \u00b6 Klipper \u00e8 spesso utilizzato con altri software gratuiti. Prendi in considerazione l'utilizzo o il supporto di questi progetti. Moonraker Mainsail Fluidd OctoPrint KlipperScreen","title":"Sponsors"},{"location":"Sponsors.html#sponsors","text":"Klipper \u00e8 un software libero. Dipendiamo dal generoso supporto degli sponsor. Considera la possibilit\u00e0 di sponsorizzare Klipper o di supportare i nostri sponsor.","title":"Sponsors"},{"location":"Sponsors.html#bigtreetech","text":"[ BIGTREETECH \u00e8 lo sponsor ufficiale della scheda madre di Klipper. BIGTREETECH si impegna a sviluppare prodotti innovativi e competitivi per servire meglio la comunit\u00e0 della stampa 3D. Seguili su Facebook o Twitter .","title":"BIGTREETECH"},{"location":"Sponsors.html#sviluppatori-klipper","text":"","title":"Sviluppatori Klipper"},{"location":"Sponsors.html#kevin-oconnor","text":"Kevin \u00e8 l'autore originale e l'attuale manutentore di Klipper. Fai una donazione su: https://ko-fi.com/koconnor o https://www.patreon.com/koconnor","title":"Kevin O'Connor"},{"location":"Sponsors.html#eric-callahan","text":"Eric \u00e8 l'autore di bed_mesh, spi_flash e molti altri moduli Klipper. Eric ha una pagina per le donazioni : https://ko-fi.com/arksine","title":"Eric Callahan"},{"location":"Sponsors.html#progetti-correlati-a-klipper","text":"Klipper \u00e8 spesso utilizzato con altri software gratuiti. Prendi in considerazione l'utilizzo o il supporto di questi progetti. Moonraker Mainsail Fluidd OctoPrint KlipperScreen","title":"Progetti correlati a Klipper"},{"location":"Status_Reference.html","text":"Status reference \u00b6 Questo documento \u00e8 un riferimento alle informazioni sullo stato della stampante disponibili in Klipper macro , display fields e tramite API Server . I campi in questo documento sono soggetti a modifiche: se si utilizza un attributo, assicurarsi di rivedere il documento Modifiche alla configurazione durante l'aggiornamento del software Klipper. angle \u00b6 Le seguenti informazioni sono disponibili negli oggetti angle some_name : temperature : l'ultima lettura della temperatura (in gradi Celsius) da un sensore magnetico Hall tle5012b. Questo valore \u00e8 disponibile solo se il sensore angolare \u00e8 un chip tle5012b e se le misurazioni sono in corso (altrimenti segnala None ). bed_mesh \u00b6 Le seguenti informazioni sono disponibili in bed_mesh : profile_name , mesh_min , mesh_max , probed_matrix , mesh_matrix : informazioni sulla bed_mesh attualmente attiva. profiles : l'insieme dei profili attualmente definiti come setup usando BED_MESH_PROFILE. bed_screws \u00b6 Le seguenti informazioni sono disponibili nell'oggetto Config_Reference.md#bed_screws : is_active : Restituisce True se lo strumento di regolazione delle viti del letto \u00e8 attualmente attivo. state : lo stato dello strumento di regolazione delle viti del piatto. \u00c8 una delle seguenti stringhe: \"adjust\", \"fine\". current_screw : l'indice per la vite corrente in corso di regolazione. accepted_screws : il numero di viti accettate. configfile \u00b6 Le seguenti informazioni sono disponibili nell'oggetto configfile (questo oggetto \u00e8 sempre disponibile): settings.<section>.<option> : Restituisce l'impostazione del file di configurazione data (o il valore predefinito) durante l'ultimo avvio o riavvio del software. (Qualsiasi impostazione modificata in fase di esecuzione non si rifletter\u00e0 qui.) config.<section>.<option> : Restituisce l'impostazione del file di configurazione non elaborato come letta da Klipper durante l'ultimo avvio o riavvio del software. (Qualsiasi impostazione modificata in fase di esecuzione non si rifletter\u00e0 qui.) Tutti i valori vengono restituiti come stringhe. save_config_pending : Restituisce vero se ci sono aggiornamenti che un comando SAVE_CONFIG potrebbe rendere persistenti sul disco. save_config_pending_items : contiene le sezioni e le opzioni che sono state modificate e sarebbero mantenute da un SAVE_CONFIG . warnings : un elenco di avvisi sulle opzioni di configurazione. Ogni voce nell'elenco sar\u00e0 un dizionario contenente un campo type e message (entrambe le stringhe). Ulteriori campi potrebbero essere disponibili a seconda del tipo di avviso. display_status \u00b6 Le seguenti informazioni sono disponibili nell'oggetto display_status (questo oggetto \u00e8 automaticamente disponibile se \u00e8 definita una sezione di configurazione display ): progress : il valore di avanzamento dell'ultimo comando G-Code M73 (o virtual_sdcard.progress se non \u00e8 stato ricevuto alcun M73 recente). message : il messaggio contenuto nell'ultimo comando G-Code M117 . endstop_phase \u00b6 Le seguenti informazioni sono disponibili nell'oggetto endstop_phase : last_home.<nome stepper>.phase : La fase del motore passo-passo al termine dell'ultimo tentativo di home. last_home.<stepper name>.phases : il numero totale di fasi disponibili sul motore passo-passo. last_home.<stepper name>.mcu_position : la posizione (tracciata dal microcontrollore) del motore passo-passo alla fine dell'ultimo tentativo di home. La posizione \u00e8 il numero totale di passi effettuati in avanti meno il numero totale di passi effettuati in senso inverso dall'ultimo riavvio del microcontrollore. exclude_object \u00b6 Le seguenti informazioni sono disponibili nell'oggetto exclude_object : objects : un array di oggetti conosciuti come fornito dal comando EXCLUDE_OBJECT_DEFINE . Queste sono le stesse informazioni fornite dal comando EXCLUDE_OBJECT VERBOSE=1 . I campi center e polygon saranno presenti solo se forniti nell'originale EXCLUDE_OBJECT_DEFINE Ecco un esempio JSON: [ { \"polygon\": [ [ 156.25, 146.2511675 ], [ 156.25, 153.7488325 ], [ 163.75, 153.7488325 ], [ 163.75, 146.2511675 ] ], \"name\": \"CYLINDER_2_STL_ID_2_COPY_0\", \"center\": [ 160, 150 ] }, { \"polygon\": [ [ 146.25, 146.2511675 ], [ 146.25, 153.7488325 ], [ 153.75, 153.7488325 ], [ 153.75, 146.2511675 ] ], \"name\": \"CYLINDER_2_STL_ID_1_COPY_0\", \"center\": [ 150, 150 ] } ] excluded_objects : un array di stringhe che elenca i nomi degli oggetti esclusi. current_object : il nome dell'oggetto attualmente in fase di stampa. extruder_stepper \u00b6 Le seguenti informazioni sono disponibili per gli oggetti extruder_stepper (cos\u00ec come per gli oggetti extruder ): pressure_advance : il valore corrente di pressure advance . smooth_time : il tempo di avanzamento graduale della pressure advance corrente. fan \u00b6 Le seguenti informazioni sono disponibili negli oggetti fan , heater_fan some_name e controller_fan some_name : speed : La velocit\u00e0 della ventola come float tra 0.0 e 1.0. rpm : la velocit\u00e0 della ventola misurata in rotazioni al minuto se la ventola ha un pin tachimetro definito. filament_switch_sensor \u00b6 Le seguenti informazioni sono disponibili negli oggetti filament_switch_sensor some_name : enabled : Restituisce True se il sensore interruttore \u00e8 attualmente abilitato. filament_detected : restituisce True se il sensore \u00e8 in uno stato attivato. filament_motion_sensor \u00b6 Le seguenti informazioni sono disponibili negli oggetti filament_motion_sensor some_name : abilitato : Restituisce True se il sensore di movimento \u00e8 attualmente abilitato. filament_detected : restituisce True se il sensore \u00e8 in uno stato attivato. firmware_retraction \u00b6 Le seguenti informazioni sono disponibili nell'oggetto firmware_retraction : retract_length , retract_speed , unretract_extra_length , unretract_speed : le impostazioni correnti per il modulo firmware_retraction. Queste impostazioni possono differire dal file di configurazione se un comando SET_RETRACTION le altera. gcode_macro \u00b6 Le seguenti informazioni sono disponibili negli oggetti gcode_macro some_name : <variabile> : il valore corrente di una variabile gcode_macro . gcode_move \u00b6 Le seguenti informazioni sono disponibili nell'oggetto gcode_move (questo oggetto \u00e8 sempre disponibile): gcode_position : la posizione corrente della testa di stampa rispetto all'origine del Gcode corrente. Cio\u00e8, posizioni che si potrebbero inviare direttamente a un comando G1 . \u00c8 possibile accedere ai componenti x, y, z ed e di questa posizione (ad esempio, gcode_position.x ). position : l'ultima posizione comandata della testina utilizzando il sistema di coordinate specificato nel file di configurazione. \u00c8 possibile accedere alle componenti x, y, z ed e di questa posizione (ad esempio, position.x ). homing_origin : l'origine del sistema di coordinate gcode (relativo al sistema di coordinate specificato nel file di configurazione) da utilizzare dopo un comando G28 . Il comando SET_GCODE_OFFSET pu\u00f2 alterare questa posizione. \u00c8 possibile accedere ai componenti x, y e z di questa posizione (ad esempio, homing_origin.x ). speed : l'ultima velocit\u00e0 impostata in un comando G1 (in mm/s). speed_factor : La\"speed factor override\" come impostato da un comando M220 . Questo \u00e8 un valore in virgola mobile tale che 1,0 significa nessun override e, ad esempio, 2,0 raddoppierebbe la velocit\u00e0 richiesta. extrude_factor : L'\"extrude factor override\" come impostato da un comando M221 . Questo \u00e8 un valore in virgola mobile tale che 1,0 significa nessun override ad esempio 2,0 raddoppierebbe le estrusioni richieste. absolute_coordinates : restituisce True se in modalit\u00e0 coordinate assolute G90 o False se in modalit\u00e0 relativa G91 . absolute_extrude : restituisce True se in modalit\u00e0 di estrusione assoluta M82 o False se in modalit\u00e0 relativa M83 . hall_filament_width_sensor \u00b6 Le seguenti informazioni sono disponibili nell'oggetto hall_filament_width_sensor : is_active : Restituisce True se il sensore \u00e8 attualmente attivo. Diameter : l'ultima lettura dal sensore in mm. Raw : l'ultima lettura grezza dell'ADC dal sensore. Riscaldatore \u00b6 Le seguenti informazioni sono disponibili per oggetti riscaldatore come extruder , heater_bed e heater_generic : temperature : l'ultima temperatura riportata (in gradi Celsius come float) per il dato riscaldatore. target : la temperatura target attuale (in gradi Celsius come float) per il riscaldatore dato. power : l'ultima impostazione del pin PWM (un valore compreso tra 0.0 e 1.0) associato al riscaldatore. can_extrude : Se l'estrusore pu\u00f2 estrudere (definito da min_extrude_temp ), disponibile solo per extruder Riscaldatori \u00b6 Le seguenti informazioni sono disponibili nell'oggetto heaters (questo oggetto \u00e8 disponibile se \u00e8 definito un riscaldatore): disponibili_riscaldatori : restituisce un elenco di tutti i riscaldatori attualmente disponibili in base ai nomi completi delle sezioni di configurazione, ad es. [\"extruder\", \"heater_bed\", \"heater_generic my_custom_heater\"] . available_sensors : restituisce un elenco di tutti i riscaldatori attualmente disponibili in base ai nomi completi delle sezioni di configurazione, ad es. [\"extruder\", \"heater_bed\", \"heater_generic my_custom_heater\"] . idle_timeout \u00b6 Le seguenti informazioni sono disponibili nell'oggetto idle_timeout (questo oggetto \u00e8 sempre disponibile): state : lo stato corrente della stampante monitorato dal modulo idle_timeout. \u00c8 una delle seguenti stringhe: \"Idle\", \"Printing\", \"Ready\". printing_time : la quantit\u00e0 di tempo (in secondi) in cui la stampante \u00e8 rimasta nello stato \"Printing\" (come tracciato dal modulo idle_timeout). led \u00b6 Le seguenti informazioni sono disponibili per ogni sezione di configurazione [led led_name] , [neopixel led_name] , [dotstar led_name] , [pca9533 led_name] e [pca9632 led_name] definita in printer.cfg: color_data : un elenco di lista di colori contenenti i valori RGBW per ogni led nella catena. Ogni valore \u00e8 rappresentato come un float da 0,0 a 1,0. Ciascuna lista di colori contiene 4 voci (rosso, verde, blu, bianco) anche se il LED sottostante supporta meno canali di colore. Ad esempio, \u00e8 possibile accedere al valore blu (3\u00b0 elemento nell'elenco dei colori) del secondo neopixel in una catena in printer[\"neopixel <config_name>\"].color_data[1][2] . manual_probe \u00b6 Le seguenti informazioni sono disponibili nell'oggetto manual_probe : is_active : Restituisce True se \u00e8 attualmente attivo uno script di supporto per il rilevamento manuale. z_position : l'altezza corrente dell'ugello (come la sta attualmente interpretando la stampante). z_position_lower : ultimo tentativo di sonda appena inferiore all'altezza corrente. z_position_upper : ultimo tentativo di sonda appena maggiore dell'altezza corrente. mcu \u00b6 Le seguenti informazioni sono disponibili negli oggetti mcu e mcu some_name : mcu_version : la versione del codice Klipper riportata dal microcontrollore. mcu_build_versions : informazioni sugli strumenti di compilazione utilizzati per generare il codice del microcontrollore (come riportato dal microcontrollore). mcu_constants.<constant_name> : Elenca le costanti di tempo riportate dal microcontrollore. Le costanti disponibili possono differire tra le architetture del microcontrollore e con ogni revisione del codice. last_stats.<statistics_name> : informazioni statistiche sulla connessione del microcontrollore. motion_report \u00b6 Le seguenti informazioni sono disponibili nell'oggetto motion_report (questo oggetto \u00e8 automaticamente disponibile se \u00e8 definita una sezione di configurazione stepper): live_position : la posizione richiesta della testa di stampa interpolata all'ora corrente. live_velocity : la velocit\u00e0 della testa di stampa richiesta (in mm/s) al momento attuale. live_extruder_velocity : la velocit\u00e0 dell'estrusore richiesta (in mm/s) al momento attuale. output_pin \u00b6 Le seguenti informazioni sono disponibili negli oggetti output_pin some_name : value : Il \"valore\" del pin, come impostato da un comando SET_PIN . palette2 \u00b6 Le seguenti informazioni sono disponibili nell'oggetto palette2 : ping : Valore dell'ultimo ping di Palette 2 riportato in percentuale. remaining_load_length : Quando si avvia una stampa della Palette 2, questa sar\u00e0 la quantit\u00e0 di filamento da caricare nell'estrusore. is_splicing : Vero quando la Palette 2 sta giuntando il filamento. pause_resume \u00b6 Le seguenti informazioni sono disponibili nell'oggetto pause_resume : is_paused : Restituisce vero se un comando PAUSE \u00e8 stato eseguito senza un corrispondente RESUME. print_stats \u00b6 Le seguenti informazioni sono disponibili nell'oggetto print_stats (questo oggetto \u00e8 automaticamente disponibile se \u00e8 definita una sezione di configurazione virtual_sdcard ): filename , total_duration , print_duration , filament_used , state , message : informazioni stimate sulla stampa corrente quando \u00e8 attiva una stampa da virtual_sdcard. info.total_layer : Il valore totale del layer dell'ultimo comando G-Code SET_PRINT_STATS_INFO TOTAL_LAYER=<valore> . info.current_layer : il valore del layer corrente dell'ultimo comando G-Code SET_PRINT_STATS_INFO CURRENT_LAYER=<valore> . probe \u00b6 Le seguenti informazioni sono disponibili nell'oggetto probe (questo oggetto \u00e8 disponibile anche se \u00e8 definita una sezione di configurazione bltouch ): last_query : Restituisce True se il probe \u00e8 stato segnalato come \"attivato\" durante l'ultimo comando QUERY_PROBE. Nota, se questo viene utilizzato in una macro, a causa dell'ordine di espansione del modello, il comando QUERY_PROBE deve essere eseguito prima della macro contenente questo riferimento. last_z_result : Restituisce il valore del risultato Z dell'ultimo comando PROBE. Nota, se questo viene utilizzato in una macro, a causa dell'ordine di espansione del modello, il comando PROBE (o simile) deve essere eseguito prima della macro contenente questo riferimento. quad_gantry_level \u00b6 Le seguenti informazioni sono disponibili nell'oggetto quad_gantry_level (questo oggetto \u00e8 disponibile se quad_gantry_level \u00e8 definito): applied : Vero se il processo di livellamento del gantry \u00e8 stato eseguito e completato con successo. query_endstops \u00b6 Le seguenti informazioni sono disponibili nell'oggetto query_endstops (questo oggetto \u00e8 disponibile se \u00e8 definito un finecorsa): last_query[\"<endstop>\"] : Restituisce True se l'endstop specificato \u00e8 stato segnalato come \"attivato-triggered\" durante l'ultimo comando QUERY_ENDSTOP. Nota, se questo viene utilizzato in una macro, a causa dell'ordine di espansione del modello, il comando QUERY_ENDSTOP deve essere eseguito prima della macro contenente questo riferimento. screws_tilt_adjust \u00b6 Le seguenti informazioni sono disponibili nell'oggetto screws_tilt_adjust : error : restituisce True se il comando SCREWS_TILT_CALCULATE pi\u00f9 recente includeva il parametro MAX_DEVIATION e uno qualsiasi dei punti della vite rilevati superava il MAX_DEVIATION specificato. results : un elenco delle posizioni delle viti rilevate. Ogni voce nell'elenco sar\u00e0 un dizionario contenente le seguenti chiavi: name : il nome della vite come specificato nel file di configurazione. x : la coordinata X della vite come specificato nel file di configurazione. y : la coordinata Y della vite come specificato nel file di configurazione. z : L'altezza Z misurata della posizione della vite. sign : Una stringa che specifica la direzione da girare per avvitare per la regolazione necessaria. O \"CW\" per senso orario o \"CCW\" per senso antiorario. La vite di base non avr\u00e0 una chiave di \"segno\". adjust : il numero di giri di vite per regolare la vite, dato nel formato \"HH:MM\", dove \"HH\" \u00e8 il numero di giri di vite completi e \"MM\" \u00e8 il numero di \"minuti di un quadrante di orologio\" che rappresenta un giro di vite parziale. (Es. \"01:15\" significherebbe girare la vite di un giro e un quarto.) servo \u00b6 Le seguenti informazioni sono disponibili negli oggetti servo some_name : printer[\"servo <config_name>\"].value : l'ultima impostazione del pin PWM (un valore compreso tra 0.0 e 1.0) associata al servo. system_stats \u00b6 Le seguenti informazioni sono disponibili nell'oggetto system_stats (questo oggetto \u00e8 sempre disponibile): sysload , cputime , memavail : informazioni sul sistema operativo del host e sul carico del processo. sensori di temperatura \u00b6 Le seguenti informazioni sono disponibili in bme280 config_section_name , htu21d config_section_name , lm75 config_section_name e temperature_host config_section_name : temperature : l'ultima temperatura letta dal sensore. humidity , pressure , gas : gli ultimi valori letti dal sensore (solo sui sensori bme280, htu21d e lm75). temperature_fan \u00b6 Le seguenti informazioni sono disponibili negli oggetti temperature_fan some_name : temperature : l'ultima temperatura letta dal sensore. target : La temperatura target per la ventola. temperature_sensor \u00b6 Le seguenti informazioni sono disponibili negli oggetti temperature_sensor some_nome : temperature : l'ultima temperatura letta dal sensore. measured_min_temp , measured_max_temp : la temperatura pi\u00f9 bassa e pi\u00f9 alta vista dal sensore dall'ultimo riavvio del software host Klipper. driver tmc \u00b6 Le seguenti informazioni sono disponibili negli oggetti TMC stepper driver (ad esempio, [tmc2208 stepper_x] ): mcu_phase_offset : La posizione dello stepper del microcontrollore corrispondente alla fase \"zero\" del driver. Questo campo pu\u00f2 essere nullo se l'offset di fase non \u00e8 noto. phase_offset_position : La \"posizione comandata\" corrispondente alla fase \"zero\" del driver. Questo campo pu\u00f2 essere nullo se l'offset di fase non \u00e8 noto. drv_status : i risultati dell'ultima query sullo stato del driver. (Sono riportati solo i campi diversi da zero.) Questo campo sar\u00e0 nullo se il driver non \u00e8 abilitato (e quindi non viene interrogato periodicamente). run_current : La corrente di esecuzione attualmente impostata. hold_current : La corrente di mantenimento attualmente impostata. toolhead \u00b6 Le seguenti informazioni sono disponibili nell'oggetto toolhead (questo oggetto \u00e8 sempre disponibile): position : l'ultima posizione comandata della testa di stampa relativa al sistema di coordinate specificato nel file di configurazione. \u00c8 possibile accedere alle componenti x, y, z di questa posizione (ad esempio, position.x ). extruder : il nome dell'estrusore attualmente attivo. Ad esempio, in una macro si potrebbe usare printer[printer.toolhead.extruder].target per ottenere la temperatura target dell'estrusore corrente. homed_axes : Gli assi cartesiani correnti considerati in uno stato \"homed\". Questa \u00e8 una stringa contenente uno o pi\u00f9 di \"x\", \"y\", \"z\". axis_minimum , axis_maximum : i limiti di corsa dell'asse (mm) dopo la corsa di homing. \u00c8 possibile accedere alle componenti x, y, z di questo valore limite (ad es. axis_minimum.x , axis_minimum.z ). Per le stampanti Delta, cone_start_z \u00e8 l'altezza z massima al raggio massimo ( printer.toolhead.cone_start_z ). max_velocity , max_accel , max_accel_to_decel , square_corner_velocity : gli attuali limiti di stampa in vigore. Questo pu\u00f2 differire dalle impostazioni del file di configurazione se un comando SET_VELOCITY_LIMIT (o M204 ) le altera in fase di esecuzione. stalls : il numero totale di volte (dall'ultimo riavvio) che la stampante ha dovuto essere messa in pausa perch\u00e9 la testina si muoveva pi\u00f9 velocemente di quanto fosse possibile leggere i movimenti dall'input del G-code. dual_carriage \u00b6 Le seguenti informazioni sono disponibili in dual_carriage su una macchina hybrid_corexy o hybrid_corexz mode : la modalit\u00e0 corrente. I valori possibili sono: \"FULL_CONTROL\" active_carriage : il carrello attivo corrente. I valori possibili sono: \"CARRIAGE_0\", \"CARRIAGE_1\" virtual_sdcard \u00b6 Le seguenti informazioni sono disponibili nell'oggetto virtual_sdcard : is_active : Restituisce True se una stampa da file \u00e8 attualmente attiva. progress : una stima dello stato di avanzamento della stampa corrente (in base alla dimensione del file e alla posizione del file). file_path : un percorso completo del file per il file attualmente caricato. file_position : la posizione corrente (in byte) di una stampa attiva. file_size : la dimensione (in byte) del file attualmente caricato. webhooks \u00b6 Le seguenti informazioni sono disponibili nell'oggetto webhooks (questo oggetto \u00e8 sempre disponibile): state : restituisce una stringa che indica lo stato corrente di Klipper. I valori possibili sono: \"ready\", \"startup\", \"shutdown\", \"error\". state_message : una stringa leggibile dall'uomo che fornisce un contesto aggiuntivo sullo stato corrente di Klipper. z_thermal_adjust \u00b6 Le seguenti informazioni sono disponibili nell'oggetto z_thermal_adjust (questo oggetto \u00e8 disponibile se z_thermal_adjust \u00e8 definito). enabled : Restituisce True se la regolazione \u00e8 abilitata. temperature : temperatura attuale (livellata) del sensore definito. [grado C] measured_min_temp : temperatura minima misurata. [degC] measured_max_temp : Temperatura massima misurata. [degC] current_z_adjust : Ultima regolazione Z calcolata [mm]. z_adjust_ref_temperature :Temperatura di riferimento corrente utilizzata per il calcolo di Z current_z_adjust [degC]. z_tilt \u00b6 Le seguenti informazioni sono disponibili nell'oggetto z_tilt (questo oggetto \u00e8 disponibile se z_tilt \u00e8 definito): applied : Vero se il processo di livellamento z-tilt \u00e8 stato eseguito e completato con successo.","title":"Status reference"},{"location":"Status_Reference.html#status-reference","text":"Questo documento \u00e8 un riferimento alle informazioni sullo stato della stampante disponibili in Klipper macro , display fields e tramite API Server . I campi in questo documento sono soggetti a modifiche: se si utilizza un attributo, assicurarsi di rivedere il documento Modifiche alla configurazione durante l'aggiornamento del software Klipper.","title":"Status reference"},{"location":"Status_Reference.html#angle","text":"Le seguenti informazioni sono disponibili negli oggetti angle some_name : temperature : l'ultima lettura della temperatura (in gradi Celsius) da un sensore magnetico Hall tle5012b. Questo valore \u00e8 disponibile solo se il sensore angolare \u00e8 un chip tle5012b e se le misurazioni sono in corso (altrimenti segnala None ).","title":"angle"},{"location":"Status_Reference.html#bed_mesh","text":"Le seguenti informazioni sono disponibili in bed_mesh : profile_name , mesh_min , mesh_max , probed_matrix , mesh_matrix : informazioni sulla bed_mesh attualmente attiva. profiles : l'insieme dei profili attualmente definiti come setup usando BED_MESH_PROFILE.","title":"bed_mesh"},{"location":"Status_Reference.html#bed_screws","text":"Le seguenti informazioni sono disponibili nell'oggetto Config_Reference.md#bed_screws : is_active : Restituisce True se lo strumento di regolazione delle viti del letto \u00e8 attualmente attivo. state : lo stato dello strumento di regolazione delle viti del piatto. \u00c8 una delle seguenti stringhe: \"adjust\", \"fine\". current_screw : l'indice per la vite corrente in corso di regolazione. accepted_screws : il numero di viti accettate.","title":"bed_screws"},{"location":"Status_Reference.html#configfile","text":"Le seguenti informazioni sono disponibili nell'oggetto configfile (questo oggetto \u00e8 sempre disponibile): settings.<section>.<option> : Restituisce l'impostazione del file di configurazione data (o il valore predefinito) durante l'ultimo avvio o riavvio del software. (Qualsiasi impostazione modificata in fase di esecuzione non si rifletter\u00e0 qui.) config.<section>.<option> : Restituisce l'impostazione del file di configurazione non elaborato come letta da Klipper durante l'ultimo avvio o riavvio del software. (Qualsiasi impostazione modificata in fase di esecuzione non si rifletter\u00e0 qui.) Tutti i valori vengono restituiti come stringhe. save_config_pending : Restituisce vero se ci sono aggiornamenti che un comando SAVE_CONFIG potrebbe rendere persistenti sul disco. save_config_pending_items : contiene le sezioni e le opzioni che sono state modificate e sarebbero mantenute da un SAVE_CONFIG . warnings : un elenco di avvisi sulle opzioni di configurazione. Ogni voce nell'elenco sar\u00e0 un dizionario contenente un campo type e message (entrambe le stringhe). Ulteriori campi potrebbero essere disponibili a seconda del tipo di avviso.","title":"configfile"},{"location":"Status_Reference.html#display_status","text":"Le seguenti informazioni sono disponibili nell'oggetto display_status (questo oggetto \u00e8 automaticamente disponibile se \u00e8 definita una sezione di configurazione display ): progress : il valore di avanzamento dell'ultimo comando G-Code M73 (o virtual_sdcard.progress se non \u00e8 stato ricevuto alcun M73 recente). message : il messaggio contenuto nell'ultimo comando G-Code M117 .","title":"display_status"},{"location":"Status_Reference.html#endstop_phase","text":"Le seguenti informazioni sono disponibili nell'oggetto endstop_phase : last_home.<nome stepper>.phase : La fase del motore passo-passo al termine dell'ultimo tentativo di home. last_home.<stepper name>.phases : il numero totale di fasi disponibili sul motore passo-passo. last_home.<stepper name>.mcu_position : la posizione (tracciata dal microcontrollore) del motore passo-passo alla fine dell'ultimo tentativo di home. La posizione \u00e8 il numero totale di passi effettuati in avanti meno il numero totale di passi effettuati in senso inverso dall'ultimo riavvio del microcontrollore.","title":"endstop_phase"},{"location":"Status_Reference.html#exclude_object","text":"Le seguenti informazioni sono disponibili nell'oggetto exclude_object : objects : un array di oggetti conosciuti come fornito dal comando EXCLUDE_OBJECT_DEFINE . Queste sono le stesse informazioni fornite dal comando EXCLUDE_OBJECT VERBOSE=1 . I campi center e polygon saranno presenti solo se forniti nell'originale EXCLUDE_OBJECT_DEFINE Ecco un esempio JSON: [ { \"polygon\": [ [ 156.25, 146.2511675 ], [ 156.25, 153.7488325 ], [ 163.75, 153.7488325 ], [ 163.75, 146.2511675 ] ], \"name\": \"CYLINDER_2_STL_ID_2_COPY_0\", \"center\": [ 160, 150 ] }, { \"polygon\": [ [ 146.25, 146.2511675 ], [ 146.25, 153.7488325 ], [ 153.75, 153.7488325 ], [ 153.75, 146.2511675 ] ], \"name\": \"CYLINDER_2_STL_ID_1_COPY_0\", \"center\": [ 150, 150 ] } ] excluded_objects : un array di stringhe che elenca i nomi degli oggetti esclusi. current_object : il nome dell'oggetto attualmente in fase di stampa.","title":"exclude_object"},{"location":"Status_Reference.html#extruder_stepper","text":"Le seguenti informazioni sono disponibili per gli oggetti extruder_stepper (cos\u00ec come per gli oggetti extruder ): pressure_advance : il valore corrente di pressure advance . smooth_time : il tempo di avanzamento graduale della pressure advance corrente.","title":"extruder_stepper"},{"location":"Status_Reference.html#fan","text":"Le seguenti informazioni sono disponibili negli oggetti fan , heater_fan some_name e controller_fan some_name : speed : La velocit\u00e0 della ventola come float tra 0.0 e 1.0. rpm : la velocit\u00e0 della ventola misurata in rotazioni al minuto se la ventola ha un pin tachimetro definito.","title":"fan"},{"location":"Status_Reference.html#filament_switch_sensor","text":"Le seguenti informazioni sono disponibili negli oggetti filament_switch_sensor some_name : enabled : Restituisce True se il sensore interruttore \u00e8 attualmente abilitato. filament_detected : restituisce True se il sensore \u00e8 in uno stato attivato.","title":"filament_switch_sensor"},{"location":"Status_Reference.html#filament_motion_sensor","text":"Le seguenti informazioni sono disponibili negli oggetti filament_motion_sensor some_name : abilitato : Restituisce True se il sensore di movimento \u00e8 attualmente abilitato. filament_detected : restituisce True se il sensore \u00e8 in uno stato attivato.","title":"filament_motion_sensor"},{"location":"Status_Reference.html#firmware_retraction","text":"Le seguenti informazioni sono disponibili nell'oggetto firmware_retraction : retract_length , retract_speed , unretract_extra_length , unretract_speed : le impostazioni correnti per il modulo firmware_retraction. Queste impostazioni possono differire dal file di configurazione se un comando SET_RETRACTION le altera.","title":"firmware_retraction"},{"location":"Status_Reference.html#gcode_macro","text":"Le seguenti informazioni sono disponibili negli oggetti gcode_macro some_name : <variabile> : il valore corrente di una variabile gcode_macro .","title":"gcode_macro"},{"location":"Status_Reference.html#gcode_move","text":"Le seguenti informazioni sono disponibili nell'oggetto gcode_move (questo oggetto \u00e8 sempre disponibile): gcode_position : la posizione corrente della testa di stampa rispetto all'origine del Gcode corrente. Cio\u00e8, posizioni che si potrebbero inviare direttamente a un comando G1 . \u00c8 possibile accedere ai componenti x, y, z ed e di questa posizione (ad esempio, gcode_position.x ). position : l'ultima posizione comandata della testina utilizzando il sistema di coordinate specificato nel file di configurazione. \u00c8 possibile accedere alle componenti x, y, z ed e di questa posizione (ad esempio, position.x ). homing_origin : l'origine del sistema di coordinate gcode (relativo al sistema di coordinate specificato nel file di configurazione) da utilizzare dopo un comando G28 . Il comando SET_GCODE_OFFSET pu\u00f2 alterare questa posizione. \u00c8 possibile accedere ai componenti x, y e z di questa posizione (ad esempio, homing_origin.x ). speed : l'ultima velocit\u00e0 impostata in un comando G1 (in mm/s). speed_factor : La\"speed factor override\" come impostato da un comando M220 . Questo \u00e8 un valore in virgola mobile tale che 1,0 significa nessun override e, ad esempio, 2,0 raddoppierebbe la velocit\u00e0 richiesta. extrude_factor : L'\"extrude factor override\" come impostato da un comando M221 . Questo \u00e8 un valore in virgola mobile tale che 1,0 significa nessun override ad esempio 2,0 raddoppierebbe le estrusioni richieste. absolute_coordinates : restituisce True se in modalit\u00e0 coordinate assolute G90 o False se in modalit\u00e0 relativa G91 . absolute_extrude : restituisce True se in modalit\u00e0 di estrusione assoluta M82 o False se in modalit\u00e0 relativa M83 .","title":"gcode_move"},{"location":"Status_Reference.html#hall_filament_width_sensor","text":"Le seguenti informazioni sono disponibili nell'oggetto hall_filament_width_sensor : is_active : Restituisce True se il sensore \u00e8 attualmente attivo. Diameter : l'ultima lettura dal sensore in mm. Raw : l'ultima lettura grezza dell'ADC dal sensore.","title":"hall_filament_width_sensor"},{"location":"Status_Reference.html#riscaldatore","text":"Le seguenti informazioni sono disponibili per oggetti riscaldatore come extruder , heater_bed e heater_generic : temperature : l'ultima temperatura riportata (in gradi Celsius come float) per il dato riscaldatore. target : la temperatura target attuale (in gradi Celsius come float) per il riscaldatore dato. power : l'ultima impostazione del pin PWM (un valore compreso tra 0.0 e 1.0) associato al riscaldatore. can_extrude : Se l'estrusore pu\u00f2 estrudere (definito da min_extrude_temp ), disponibile solo per extruder","title":"Riscaldatore"},{"location":"Status_Reference.html#riscaldatori","text":"Le seguenti informazioni sono disponibili nell'oggetto heaters (questo oggetto \u00e8 disponibile se \u00e8 definito un riscaldatore): disponibili_riscaldatori : restituisce un elenco di tutti i riscaldatori attualmente disponibili in base ai nomi completi delle sezioni di configurazione, ad es. [\"extruder\", \"heater_bed\", \"heater_generic my_custom_heater\"] . available_sensors : restituisce un elenco di tutti i riscaldatori attualmente disponibili in base ai nomi completi delle sezioni di configurazione, ad es. [\"extruder\", \"heater_bed\", \"heater_generic my_custom_heater\"] .","title":"Riscaldatori"},{"location":"Status_Reference.html#idle_timeout","text":"Le seguenti informazioni sono disponibili nell'oggetto idle_timeout (questo oggetto \u00e8 sempre disponibile): state : lo stato corrente della stampante monitorato dal modulo idle_timeout. \u00c8 una delle seguenti stringhe: \"Idle\", \"Printing\", \"Ready\". printing_time : la quantit\u00e0 di tempo (in secondi) in cui la stampante \u00e8 rimasta nello stato \"Printing\" (come tracciato dal modulo idle_timeout).","title":"idle_timeout"},{"location":"Status_Reference.html#led","text":"Le seguenti informazioni sono disponibili per ogni sezione di configurazione [led led_name] , [neopixel led_name] , [dotstar led_name] , [pca9533 led_name] e [pca9632 led_name] definita in printer.cfg: color_data : un elenco di lista di colori contenenti i valori RGBW per ogni led nella catena. Ogni valore \u00e8 rappresentato come un float da 0,0 a 1,0. Ciascuna lista di colori contiene 4 voci (rosso, verde, blu, bianco) anche se il LED sottostante supporta meno canali di colore. Ad esempio, \u00e8 possibile accedere al valore blu (3\u00b0 elemento nell'elenco dei colori) del secondo neopixel in una catena in printer[\"neopixel <config_name>\"].color_data[1][2] .","title":"led"},{"location":"Status_Reference.html#manual_probe","text":"Le seguenti informazioni sono disponibili nell'oggetto manual_probe : is_active : Restituisce True se \u00e8 attualmente attivo uno script di supporto per il rilevamento manuale. z_position : l'altezza corrente dell'ugello (come la sta attualmente interpretando la stampante). z_position_lower : ultimo tentativo di sonda appena inferiore all'altezza corrente. z_position_upper : ultimo tentativo di sonda appena maggiore dell'altezza corrente.","title":"manual_probe"},{"location":"Status_Reference.html#mcu","text":"Le seguenti informazioni sono disponibili negli oggetti mcu e mcu some_name : mcu_version : la versione del codice Klipper riportata dal microcontrollore. mcu_build_versions : informazioni sugli strumenti di compilazione utilizzati per generare il codice del microcontrollore (come riportato dal microcontrollore). mcu_constants.<constant_name> : Elenca le costanti di tempo riportate dal microcontrollore. Le costanti disponibili possono differire tra le architetture del microcontrollore e con ogni revisione del codice. last_stats.<statistics_name> : informazioni statistiche sulla connessione del microcontrollore.","title":"mcu"},{"location":"Status_Reference.html#motion_report","text":"Le seguenti informazioni sono disponibili nell'oggetto motion_report (questo oggetto \u00e8 automaticamente disponibile se \u00e8 definita una sezione di configurazione stepper): live_position : la posizione richiesta della testa di stampa interpolata all'ora corrente. live_velocity : la velocit\u00e0 della testa di stampa richiesta (in mm/s) al momento attuale. live_extruder_velocity : la velocit\u00e0 dell'estrusore richiesta (in mm/s) al momento attuale.","title":"motion_report"},{"location":"Status_Reference.html#output_pin","text":"Le seguenti informazioni sono disponibili negli oggetti output_pin some_name : value : Il \"valore\" del pin, come impostato da un comando SET_PIN .","title":"output_pin"},{"location":"Status_Reference.html#palette2","text":"Le seguenti informazioni sono disponibili nell'oggetto palette2 : ping : Valore dell'ultimo ping di Palette 2 riportato in percentuale. remaining_load_length : Quando si avvia una stampa della Palette 2, questa sar\u00e0 la quantit\u00e0 di filamento da caricare nell'estrusore. is_splicing : Vero quando la Palette 2 sta giuntando il filamento.","title":"palette2"},{"location":"Status_Reference.html#pause_resume","text":"Le seguenti informazioni sono disponibili nell'oggetto pause_resume : is_paused : Restituisce vero se un comando PAUSE \u00e8 stato eseguito senza un corrispondente RESUME.","title":"pause_resume"},{"location":"Status_Reference.html#print_stats","text":"Le seguenti informazioni sono disponibili nell'oggetto print_stats (questo oggetto \u00e8 automaticamente disponibile se \u00e8 definita una sezione di configurazione virtual_sdcard ): filename , total_duration , print_duration , filament_used , state , message : informazioni stimate sulla stampa corrente quando \u00e8 attiva una stampa da virtual_sdcard. info.total_layer : Il valore totale del layer dell'ultimo comando G-Code SET_PRINT_STATS_INFO TOTAL_LAYER=<valore> . info.current_layer : il valore del layer corrente dell'ultimo comando G-Code SET_PRINT_STATS_INFO CURRENT_LAYER=<valore> .","title":"print_stats"},{"location":"Status_Reference.html#probe","text":"Le seguenti informazioni sono disponibili nell'oggetto probe (questo oggetto \u00e8 disponibile anche se \u00e8 definita una sezione di configurazione bltouch ): last_query : Restituisce True se il probe \u00e8 stato segnalato come \"attivato\" durante l'ultimo comando QUERY_PROBE. Nota, se questo viene utilizzato in una macro, a causa dell'ordine di espansione del modello, il comando QUERY_PROBE deve essere eseguito prima della macro contenente questo riferimento. last_z_result : Restituisce il valore del risultato Z dell'ultimo comando PROBE. Nota, se questo viene utilizzato in una macro, a causa dell'ordine di espansione del modello, il comando PROBE (o simile) deve essere eseguito prima della macro contenente questo riferimento.","title":"probe"},{"location":"Status_Reference.html#quad_gantry_level","text":"Le seguenti informazioni sono disponibili nell'oggetto quad_gantry_level (questo oggetto \u00e8 disponibile se quad_gantry_level \u00e8 definito): applied : Vero se il processo di livellamento del gantry \u00e8 stato eseguito e completato con successo.","title":"quad_gantry_level"},{"location":"Status_Reference.html#query_endstops","text":"Le seguenti informazioni sono disponibili nell'oggetto query_endstops (questo oggetto \u00e8 disponibile se \u00e8 definito un finecorsa): last_query[\"<endstop>\"] : Restituisce True se l'endstop specificato \u00e8 stato segnalato come \"attivato-triggered\" durante l'ultimo comando QUERY_ENDSTOP. Nota, se questo viene utilizzato in una macro, a causa dell'ordine di espansione del modello, il comando QUERY_ENDSTOP deve essere eseguito prima della macro contenente questo riferimento.","title":"query_endstops"},{"location":"Status_Reference.html#screws_tilt_adjust","text":"Le seguenti informazioni sono disponibili nell'oggetto screws_tilt_adjust : error : restituisce True se il comando SCREWS_TILT_CALCULATE pi\u00f9 recente includeva il parametro MAX_DEVIATION e uno qualsiasi dei punti della vite rilevati superava il MAX_DEVIATION specificato. results : un elenco delle posizioni delle viti rilevate. Ogni voce nell'elenco sar\u00e0 un dizionario contenente le seguenti chiavi: name : il nome della vite come specificato nel file di configurazione. x : la coordinata X della vite come specificato nel file di configurazione. y : la coordinata Y della vite come specificato nel file di configurazione. z : L'altezza Z misurata della posizione della vite. sign : Una stringa che specifica la direzione da girare per avvitare per la regolazione necessaria. O \"CW\" per senso orario o \"CCW\" per senso antiorario. La vite di base non avr\u00e0 una chiave di \"segno\". adjust : il numero di giri di vite per regolare la vite, dato nel formato \"HH:MM\", dove \"HH\" \u00e8 il numero di giri di vite completi e \"MM\" \u00e8 il numero di \"minuti di un quadrante di orologio\" che rappresenta un giro di vite parziale. (Es. \"01:15\" significherebbe girare la vite di un giro e un quarto.)","title":"screws_tilt_adjust"},{"location":"Status_Reference.html#servo","text":"Le seguenti informazioni sono disponibili negli oggetti servo some_name : printer[\"servo <config_name>\"].value : l'ultima impostazione del pin PWM (un valore compreso tra 0.0 e 1.0) associata al servo.","title":"servo"},{"location":"Status_Reference.html#system_stats","text":"Le seguenti informazioni sono disponibili nell'oggetto system_stats (questo oggetto \u00e8 sempre disponibile): sysload , cputime , memavail : informazioni sul sistema operativo del host e sul carico del processo.","title":"system_stats"},{"location":"Status_Reference.html#sensori-di-temperatura","text":"Le seguenti informazioni sono disponibili in bme280 config_section_name , htu21d config_section_name , lm75 config_section_name e temperature_host config_section_name : temperature : l'ultima temperatura letta dal sensore. humidity , pressure , gas : gli ultimi valori letti dal sensore (solo sui sensori bme280, htu21d e lm75).","title":"sensori di temperatura"},{"location":"Status_Reference.html#temperature_fan","text":"Le seguenti informazioni sono disponibili negli oggetti temperature_fan some_name : temperature : l'ultima temperatura letta dal sensore. target : La temperatura target per la ventola.","title":"temperature_fan"},{"location":"Status_Reference.html#temperature_sensor","text":"Le seguenti informazioni sono disponibili negli oggetti temperature_sensor some_nome : temperature : l'ultima temperatura letta dal sensore. measured_min_temp , measured_max_temp : la temperatura pi\u00f9 bassa e pi\u00f9 alta vista dal sensore dall'ultimo riavvio del software host Klipper.","title":"temperature_sensor"},{"location":"Status_Reference.html#driver-tmc","text":"Le seguenti informazioni sono disponibili negli oggetti TMC stepper driver (ad esempio, [tmc2208 stepper_x] ): mcu_phase_offset : La posizione dello stepper del microcontrollore corrispondente alla fase \"zero\" del driver. Questo campo pu\u00f2 essere nullo se l'offset di fase non \u00e8 noto. phase_offset_position : La \"posizione comandata\" corrispondente alla fase \"zero\" del driver. Questo campo pu\u00f2 essere nullo se l'offset di fase non \u00e8 noto. drv_status : i risultati dell'ultima query sullo stato del driver. (Sono riportati solo i campi diversi da zero.) Questo campo sar\u00e0 nullo se il driver non \u00e8 abilitato (e quindi non viene interrogato periodicamente). run_current : La corrente di esecuzione attualmente impostata. hold_current : La corrente di mantenimento attualmente impostata.","title":"driver tmc"},{"location":"Status_Reference.html#toolhead","text":"Le seguenti informazioni sono disponibili nell'oggetto toolhead (questo oggetto \u00e8 sempre disponibile): position : l'ultima posizione comandata della testa di stampa relativa al sistema di coordinate specificato nel file di configurazione. \u00c8 possibile accedere alle componenti x, y, z di questa posizione (ad esempio, position.x ). extruder : il nome dell'estrusore attualmente attivo. Ad esempio, in una macro si potrebbe usare printer[printer.toolhead.extruder].target per ottenere la temperatura target dell'estrusore corrente. homed_axes : Gli assi cartesiani correnti considerati in uno stato \"homed\". Questa \u00e8 una stringa contenente uno o pi\u00f9 di \"x\", \"y\", \"z\". axis_minimum , axis_maximum : i limiti di corsa dell'asse (mm) dopo la corsa di homing. \u00c8 possibile accedere alle componenti x, y, z di questo valore limite (ad es. axis_minimum.x , axis_minimum.z ). Per le stampanti Delta, cone_start_z \u00e8 l'altezza z massima al raggio massimo ( printer.toolhead.cone_start_z ). max_velocity , max_accel , max_accel_to_decel , square_corner_velocity : gli attuali limiti di stampa in vigore. Questo pu\u00f2 differire dalle impostazioni del file di configurazione se un comando SET_VELOCITY_LIMIT (o M204 ) le altera in fase di esecuzione. stalls : il numero totale di volte (dall'ultimo riavvio) che la stampante ha dovuto essere messa in pausa perch\u00e9 la testina si muoveva pi\u00f9 velocemente di quanto fosse possibile leggere i movimenti dall'input del G-code.","title":"toolhead"},{"location":"Status_Reference.html#dual_carriage","text":"Le seguenti informazioni sono disponibili in dual_carriage su una macchina hybrid_corexy o hybrid_corexz mode : la modalit\u00e0 corrente. I valori possibili sono: \"FULL_CONTROL\" active_carriage : il carrello attivo corrente. I valori possibili sono: \"CARRIAGE_0\", \"CARRIAGE_1\"","title":"dual_carriage"},{"location":"Status_Reference.html#virtual_sdcard","text":"Le seguenti informazioni sono disponibili nell'oggetto virtual_sdcard : is_active : Restituisce True se una stampa da file \u00e8 attualmente attiva. progress : una stima dello stato di avanzamento della stampa corrente (in base alla dimensione del file e alla posizione del file). file_path : un percorso completo del file per il file attualmente caricato. file_position : la posizione corrente (in byte) di una stampa attiva. file_size : la dimensione (in byte) del file attualmente caricato.","title":"virtual_sdcard"},{"location":"Status_Reference.html#webhooks","text":"Le seguenti informazioni sono disponibili nell'oggetto webhooks (questo oggetto \u00e8 sempre disponibile): state : restituisce una stringa che indica lo stato corrente di Klipper. I valori possibili sono: \"ready\", \"startup\", \"shutdown\", \"error\". state_message : una stringa leggibile dall'uomo che fornisce un contesto aggiuntivo sullo stato corrente di Klipper.","title":"webhooks"},{"location":"Status_Reference.html#z_thermal_adjust","text":"Le seguenti informazioni sono disponibili nell'oggetto z_thermal_adjust (questo oggetto \u00e8 disponibile se z_thermal_adjust \u00e8 definito). enabled : Restituisce True se la regolazione \u00e8 abilitata. temperature : temperatura attuale (livellata) del sensore definito. [grado C] measured_min_temp : temperatura minima misurata. [degC] measured_max_temp : Temperatura massima misurata. [degC] current_z_adjust : Ultima regolazione Z calcolata [mm]. z_adjust_ref_temperature :Temperatura di riferimento corrente utilizzata per il calcolo di Z current_z_adjust [degC].","title":"z_thermal_adjust"},{"location":"Status_Reference.html#z_tilt","text":"Le seguenti informazioni sono disponibili nell'oggetto z_tilt (questo oggetto \u00e8 disponibile se z_tilt \u00e8 definito): applied : Vero se il processo di livellamento z-tilt \u00e8 stato eseguito e completato con successo.","title":"z_tilt"},{"location":"TMC_Drivers.html","text":"Driver TMC \u00b6 Questo documento fornisce informazioni sull'utilizzo dei driver Trinamic per motori stepper in modalit\u00e0 SPI/UART su Klipper. Klipper pu\u00f2 anche utilizzare i driver Trinamic nella loro \"modalit\u00e0 standalone\". Tuttavia, quando i driver sono in questa modalit\u00e0, non \u00e8 necessaria alcuna configurazione speciale di Klipper e le funzionalit\u00e0 avanzate di Klipper discusse in questo documento non sono disponibili. Oltre a questo documento, assicurati di rivedere il riferimento alla configurazione del driver TMC . Regolazione della corrente del motore \u00b6 Una corrente pi\u00f9 alta del driver aumenta la precisione del posizionamento e la coppia. Tuttavia, una corrente pi\u00f9 elevata aumenta anche il calore prodotto dal motore passo-passo e dal driver del motore passo-passo. Se il driver del motore passo-passo si surriscalda, si disabiliter\u00e0 e Klipper segnaler\u00e0 un errore. Se il motore passo-passo si surriscalda, perde coppia e precisione di posizionamento. (Se diventa molto caldo, potrebbe anche fondere le parti di plastica attaccate o vicino ad esso.) Come consiglio generale per l'ottimizzazione, preferire valori di corrente pi\u00f9 elevati purch\u00e9 il motore passo-passo non si surriscaldi troppo e il driver del motore passo-passo non segnali avvisi o errori. In generale, va bene che il motore passo-passo sia caldo, ma non dovrebbe diventare cos\u00ec caldo da risultare doloroso al tatto. Preferibilmente non specificare un hold_current \u00b6 Se si configura un hold_current , il driver TMC pu\u00f2 ridurre la corrente al motore passo-passo quando rileva che il passo-passo non si sta muovendo. Tuttavia, la variazione della corrente del motore pu\u00f2 di per s\u00e9 introdurre il movimento del motore. Ci\u00f2 pu\u00f2 verificarsi a causa di \"forze di arresto\" all'interno del motore passo-passo (il magnete permanente nel rotore tira verso i denti di ferro nello statore) o a causa di forze esterne sul carrello dell'asse. La maggior parte dei motori passo-passo non otterr\u00e0 un beneficio significativo dalla riduzione della corrente durante le normali stampe, perch\u00e9 pochi movimenti di stampa lasceranno un motore passo-passo inattivo per un tempo sufficientemente lungo da attivare la funzione hold_current . Ed \u00e8 improbabile che si vogliano introdurre sottili artefatti di stampa nelle poche mosse di stampa che lasciano uno stepper inattivo sufficientemente a lungo. Se si desidera ridurre la corrente ai motori durante le routine di avvio della stampa, considerare l'emissione di comandi SET_TMC_CURRENT in una START_PRINT macro per regolare la corrente prima e dopo i normali spostamenti di stampa. Alcune stampanti con motori Z dedicati che sono inattivi durante i normali movimenti di stampa (nessuna bed_mesho, nessuna inclinazione_piatto, nessuna correzione_inclinazione Z, nessuna stampa in \"modalit\u00e0 vaso\", ecc.) potrebbero scoprire che i motori Z funzionano a temperature pi\u00f9 basse con un hold_current . Se si implementa questo, assicurarsi di prendere in considerazione questo tipo di movimento dell'asse Z non comandato durante il livellamento del piatto, il rilevamento del piatto, la calibrazione della sonda e simili. Anche driver_TPOWERDOWN e driver_IHOLDDELAY dovrebbero essere calibrati di conseguenza. Se non sei sicuro, preferisci non specificare un hold_current . Impostazione della modalit\u00e0 \"spreadCycle\" rispetto a \"stealthChop\" \u00b6 Per impostazione predefinita, Klipper mette i driver TMC in modalit\u00e0 \"spreadCycle\". Se il driver supporta \"stealthChop\", pu\u00f2 essere abilitato aggiungendo stealthchop_threshold: 999999 alla sezione di configurazione di TMC. In generale, la modalit\u00e0 SpreadCycle fornisce una coppia maggiore e una maggiore precisione di posizionamento rispetto alla modalit\u00e0 StealthChop. Tuttavia, la modalit\u00e0 StealthChop pu\u00f2 produrre un rumore udibile notevolmente inferiore su alcune stampanti. I test di confronto delle modalit\u00e0 hanno mostrato un \"ritardo posizionale\" aumentato di circa il 75% di un passo completo durante i movimenti a velocit\u00e0 costante quando si utilizza la modalit\u00e0 StealthChop (ad esempio, su una stampante con distanza_rotazione di 40 mm e 200 passi_per_rotazione, la deviazione di posizione dei movimenti a velocit\u00e0 costante \u00e8 aumentata di ~0,150 mm). Tuttavia, questo \"ritardo nell'ottenimento della posizione richiesta\" potrebbe non manifestarsi come un difetto di stampa significativo e si potrebbe preferire il comportamento pi\u00f9 silenzioso della modalit\u00e0 stealthChop. Si consiglia di utilizzare sempre la modalit\u00e0 \"spreadCycle\" (non specificando stealthchop_threshold ) o di utilizzare sempre la modalit\u00e0 \"stealthChop\" (impostando stealthchop_threshold su 999999). Sfortunatamente, i driver spesso producono risultati scadenti e confusi se la modalit\u00e0 cambia mentre il motore \u00e8 a una velocit\u00e0 diversa da zero. L'impostazione dell'interpolazione TMC introduce una piccola deviazione di posizione \u00b6 L'impostazione interpolate del driver TMC pu\u00f2 ridurre il rumore udibile del movimento della stampante a costo di introdurre un piccolo errore di posizione sistemico. Questo errore di posizione sistematico deriva dal ritardo del driver nell'esecuzione dei \"passi\" inviati da Klipper. Durante i movimenti a velocit\u00e0 costante, questo ritardo si traduce in un errore di posizione di quasi mezzo micropasso configurato (pi\u00f9 precisamente, l'errore \u00e8 di mezzo micropasso meno un 512esimo di un passo intero). Ad esempio, su un asse con una distanza_rotazione di 40 mm, 200 passi_per_rotazione e 16 micropassi, l'errore sistemico introdotto durante i movimenti a velocit\u00e0 costante \u00e8 ~0,006 mm. Per una migliore precisione di posizionamento, considerare l'utilizzo della modalit\u00e0 SpreadCycle e disabilitare l'interpolazione (impostare interpolate: False nella configurazione del driver TMC). Se configurato in questo modo, \u00e8 possibile aumentare l'impostazione microstep per ridurre il rumore udibile durante il movimento del passo-passo. Tipicamente, un'impostazione microstep di 64 o 128 avr\u00e0 un rumore udibile simile all'interpolazione e lo far\u00e0 senza introdurre un errore posizionale sistemico. Se si utilizza la modalit\u00e0 StealthChop, l'imprecisione posizionale dell'interpolazione \u00e8 piccola rispetto all'imprecisione posizionale introdotta dalla modalit\u00e0 StealthChop. Pertanto l'interpolazione dell'ottimizzazione non \u00e8 considerata utile in modalit\u00e0 StealthChop e si pu\u00f2 lasciare l'interpolazione nel suo stato predefinito. Homing Sensorless \u00b6 L'homing senza sensori consente di posizionare un asse senza la necessit\u00e0 di un finecorsa fisico. Invece, il carrello sull'asse viene spostato nel finecorsa meccanico facendo perdere passi al motore passo-passo. Il driver stepper rileva i passi persi e lo indica all'MCU di controllo (Klipper) attivando un pin. Queste informazioni possono essere utilizzate da Klipper come fine corsa per l'asse. Questa guida illustra l'impostazione dell'homing sensorless per l'asse X della stampante (cartesiana). Tuttavia, funziona allo stesso modo con tutti gli altri assi (che richiedono un fine corsa). Dovresti configurarlo e sintonizzarlo per un asse alla volta. Limitazioni \u00b6 Assicurati che i tuoi componenti meccanici siano in grado di sopportare il carico del carrello che urta ripetutamente il limite dell'asse. Soprattutto le viti di comando potrebbero generare molta forza. L'homing di un asse Z facendo urtare l'ugello sulla superficie di stampa potrebbe non essere una buona idea. Per ottenere i migliori risultati, verificare che il carrello dell'asse stabilisca un contatto stabile con il limite dell'asse. Inoltre, l'homing sensorless potrebbe non essere sufficientemente preciso per la tua stampante. Sebbene l'homing degli assi X e Y su una macchina cartesiana possa funzionare bene, l'homing dell'asse Z in genere non \u00e8 sufficientemente preciso e pu\u00f2 comportare un'altezza del primo strato incoerente. L'homing di una stampante delta sensorless non \u00e8 consigliabile a causa della mancanza di precisione. Inoltre, il rilevamento dello stallo del driver passo-passo dipende dal carico meccanico sul motore, dalla corrente del motore e dalla temperatura del motore (resistenza della bobina). L'homing sensorless funziona meglio a velocit\u00e0 medie del motore. Per velocit\u00e0 molto basse (inferiori a 10 giri/min) il motore non genera una significativa EMF di ritorno e il TMC non \u00e8 in grado di rilevare in modo affidabile gli stalli del motore. Inoltre, a velocit\u00e0 molto elevate, l'EMF di ritorno del motore si avvicina alla tensione di alimentazione del motore, quindi il TMC non \u00e8 pi\u00f9 in grado di rilevare gli stalli. Si consiglia di dare un'occhiata alla scheda tecnica del proprio TMC specifico. L\u00ec puoi anche trovare maggiori dettagli sulle limitazioni di questa configurazione. Prerequisiti \u00b6 Sono necessari alcuni prerequisiti per utilizzare l'homing sensorless: Driver passo-passo TMC compatibile con stallGuard (tmc2130, tmc2209, tmc2660 o tmc5160). Interfaccia SPI/UART del driver TMC cablata al microcontrollore (la modalit\u00e0 stand-alone non funziona). Il pin \"DIAG\" o \"SG_TST\" appropriato del driver TMC collegato al microcontrollore. I passaggi nel documento config checks devono essere eseguiti per confermare che i motori passo-passo siano configurati e funzionino correttamente. Messa a punto \u00b6 La procedura qui descritta prevede sei passaggi principali: Scegli una velocit\u00e0 di homing. Configura il file printer.cfg per abilitare l'homing sensorless. Trova l'impostazione stallguard con la massima sensibilit\u00e0 che funziona con successo. Trova l'impostazione stallguard con la sensibilit\u00e0 pi\u00f9 bassa che effettua homing con successo con un solo tocco. Aggiorna il printer.cfg con l'impostazione di stallguard desiderata. Crea o aggiorna le macro printer.cfg per homing in modo coerente. Scegli la velocit\u00e0 di homing \u00b6 La velocit\u00e0 di homing \u00e8 una scelta importante quando si esegue l'homing senza sensori. \u00c8 consigliabile utilizzare una velocit\u00e0 di riferimento bassa in modo che il carrello non eserciti una forza eccessiva sul telaio quando entra in contatto con l'estremit\u00e0 della rotaia. Tuttavia, i driver TMC non sono in grado di rilevare in modo affidabile uno stallo a velocit\u00e0 molto basse. Un buon punto di partenza per la velocit\u00e0 di homing \u00e8 che il motore passo-passo esegua una rotazione completa ogni due secondi. Per molti assi questa sar\u00e0 la rotation_distance divisa per due. Per esempio: [stepper_x] rotation_distance: 40 homing_speed: 20 ... Configura printer.cfg per l'homing sensorless \u00b6 L'impostazione homing_retract_dist deve essere impostata su zero nella sezione di configurazione stepper_x per disabilitare il secondo movimento di homing. Il secondo tentativo di homing non aggiunge valore quando si utilizza l'homing sensorless, non funzioner\u00e0 in modo affidabile e confonder\u00e0 il processo di ottimizzazione. Assicurati che un'impostazione hold_current non sia specificata nella sezione del driver TMC del file config. (Se viene impostata una hold_current, dopo che \u00e8 stato stabilito il contatto, il motore si arresta mentre il carrello viene premuto contro l'estremit\u00e0 del binario e la riduzione della corrente mentre si trova in quella posizione pu\u00f2 causare il movimento del carrello, il che si traduce in prestazioni scadenti e confonde il processo di regolazione.) \u00c8 necessario configurare i pin di homing sensorless e configurare le impostazioni iniziali di \"stallguard\". Una configurazione di esempio tmc2209 per un asse X potrebbe essere simile a: [tmc2209 stepper_x] diag_pin: ^PA1 # Impostare sul pin MCU collegato al pin TMC DIAG driver_SGTHRS: 255 #255 \u00e8 il valore pi\u00f9 sensibile, 0 \u00e8 il meno sensibile ... [stepper_x] endstop_pin: tmc2209_stepper_x:virtual_endstop homing_retract_dist: 0 ... Un esempio di configurazione tmc2130 o tmc5160 potrebbe essere simile a: [tmc2130 stepper_x] diag1_pin: ^!PA1 # Pin collegato al pin TMC DIAG1 (o utilizzare pin diag0_pin / DIAG0) driver_SGT: -64 # -64 \u00e8 il valore pi\u00f9 sensibile, 63 \u00e8 il meno sensibile ... [stepper_x] endstop_pin: tmc2130_stepper_x:virtual_endstop homing_retract_dist: 0 ... Un esempio di configurazione di tmc2660 potrebbe essere simile a: [tmc2660 stepper_x] driver_SGT: -64 # -64 \u00e8 il valore pi\u00f9 sensibile, 63 \u00e8 il meno sensibile ... [stepper_x] endstop_pin: ^PA1 # Pin collegato al pin TMC SG_TST homing_retract_dist: 0 ... Gli esempi sopra mostrano solo le impostazioni specifiche per l'homing sensorless. Vedere il riferimento alla configurazione per tutte le opzioni disponibili. Trova la massima sensibilit\u00e0 che porta a homing con successo \u00b6 Posizionare il carrello vicino al centro del binario. Utilizzare il comando SET_TMC_FIELD per impostare la sensibilit\u00e0 pi\u00f9 alta. Per tmc2209: SET_TMC_FIELD STEPPER=stepper_x FIELD=SGTHRS VALUE=255 Per tmc2130, tmc5160 e tmc2660: SET_TMC_FIELD STEPPER=stepper_x FIELD=sgt VALUE=-64 Quindi inviare un comando G28 X0 e verificare che l'asse non si muova affatto o smetta rapidamente di muoversi. Se l'asse non si ferma, inviare un M112 per fermare la stampante - qualcosa non \u00e8 corretto con il cablaggio o la configurazione dei pin diag/sg_tst e deve essere corretto prima di continuare. Quindi, diminuire progressivamente la sensibilit\u00e0 dell'impostazione VALUE ed eseguire nuovamente i comandi SET_TMC_FIELD G28 X0 per trovare la sensibilit\u00e0 pi\u00f9 alta che fa s\u00ec che il carrello si muova con successo fino all'arresto e si arresti. (Per i driver tmc2209 questo diminuir\u00e0 SGTHRS, per altri conducenti aumenter\u00e0 il sgt.) Assicurati di iniziare ogni tentativo con il carrello vicino al centro del binario (se necessario, emetti M84 e quindi sposta manualmente il carrello sul centro). Dovrebbe essere possibile trovare la sensibilit\u00e0 pi\u00f9 alta che si adatta in modo affidabile (le impostazioni con una sensibilit\u00e0 pi\u00f9 alta comportano movimenti piccoli o nulli). Nota il valore trovato come sensibilit\u00e0_massima . (Se si ottiene la sensibilit\u00e0 minima possibile (SGTHRS=0 o sgt=63) senza alcun movimento del carrello, allora qualcosa non \u00e8 corretto con il cablaggio o la configurazione dei pin diag/sg_tst e deve essere corretto prima di continuare.) Quando si cerca la sensibilit\u00e0_massima, pu\u00f2 essere conveniente passare a diverse impostazioni VALUE (in modo da dividere in due il parametro VALUE). In tal caso, prepararsi a emettere un comando M112 per arrestare la stampante, poich\u00e9 un'impostazione con una sensibilit\u00e0 molto bassa potrebbe far \"sbattere\" ripetutamente l'asse contro l'estremit\u00e0 del binario. Assicurati di attendere un paio di secondi tra ogni tentativo di homing. Dopo che il driver TMC ha rilevato uno stallo, potrebbe volerci un po' di tempo per cancellare il suo indicatore interno ed essere in grado di rilevare un altro stallo. Durante questi test di ottimizzazione, se un comando G28 X0 non si sposta fino al limite dell'asse, prestare attenzione nell'emettere qualsiasi comando di movimento regolare (ad es. G1 ). Klipper non avr\u00e0 una corretta comprensione della posizione del carrello e un comando di spostamento potrebbe causare risultati indesiderati e confusi. Trova la sensibilit\u00e0 pi\u00f9 bassa che porta a homing con un solo tocco \u00b6 Quando si effettua l'homing con il valore maximum_sensitivity trovato, l'asse dovrebbe spostarsi all'estremit\u00e0 del binario e fermarsi con un \"tocco singolo\", ovvero non dovrebbe esserci un \"clic\" o un \"sbattere\". (Se c'\u00e8 un suono che sbatte o scatta alla sensibilit\u00e0_massima, allora la velocit\u00e0 di riferimento potrebbe essere troppo bassa, la corrente del driver potrebbe essere troppo bassa o la corsa di riferimento senza sensore potrebbe non essere una buona scelta per l'asse.) Il passo successivo \u00e8 spostare di nuovo continuamente il carrello in una posizione vicino al centro della rotaia, diminuire la sensibilit\u00e0 ed eseguire i comandi SET_TMC_FIELD G28 X0 - l'obiettivo ora \u00e8 trovare la sensibilit\u00e0 pi\u00f9 bassa che risulti ancora nel la carrozza torna con successo al punto di riferimento con un \"tocco singolo\". Cio\u00e8, non \"sbatte\" o \"clic\" quando viene a contatto con l'estremit\u00e0 del binario. Nota il valore trovato come sensibilit\u00e0_minima . Aggiorna printer.cfg con il valore della sensibilit\u00e0 \u00b6 Dopo aver trovato sensibilit\u00e0_massima e sensibilit\u00e0_minima , utilizzare una calcolatrice per ottenere la sensibilit\u00e0 consigliata come sensibilit\u00e0_minima + (sensibilit\u00e0_massima - sensibilit\u00e0_minima)/3 . La sensibilit\u00e0 consigliata dovrebbe essere compresa tra il minimo e il massimo, ma leggermente pi\u00f9 vicino al minimo. Arrotonda il valore finale al valore intero pi\u00f9 vicino. Per tmc2209 impostalo nella configurazione come driver_SGTHRS , per altri driver TMC impostalo nella configurazione come driver_SGT . Se l'intervallo tra sensibilit\u00e0_massima e sensibilit\u00e0_minima \u00e8 piccolo (ad esempio, inferiore a 5), potrebbe risultare in un homing instabile. Una velocit\u00e0 di riferimento pi\u00f9 elevata pu\u00f2 aumentare il range e rendere l'operazione pi\u00f9 stabile. Si noti che se viene apportata una modifica alla corrente del driver, alla velocit\u00e0 di riferimento o viene apportata una modifica notevole all'hardware della stampante, sar\u00e0 necessario eseguire nuovamente il processo di ottimizzazione. Utilizzo delle macro durante l'homing \u00b6 Dopo aver completato l'homing senza sensori, il carrello verr\u00e0 premuto contro l'estremit\u00e0 del binario e lo stepper eserciter\u00e0 una forza sul telaio fino a quando il carrello non si allontana. \u00c8 una buona idea creare una macro per posizionare l'asse e allontanare immediatamente il carrello dall'estremit\u00e0 della rotaia. \u00c8 una buona idea che la macro si metta in pausa di almeno 2 secondi prima di iniziare l'homing sensorless (o altrimenti assicurarsi che non ci siano stati movimenti sullo stepper per 2 secondi). Senza ritardo \u00e8 possibile che il flag di stallo interno del driver sia ancora impostato da un movimento precedente. Pu\u00f2 anche essere utile fare in modo che quella macro imposti la corrente del driver prima della corsa di riferimento e imposti una nuova corrente dopo che il carrello si \u00e8 allontanato. Una macro di esempio potrebbe assomigliare a: [gcode_macro SENSORLESS_HOME_X] gcode: {% set HOME_CUR = 0.700 %} {% set driver_config = printer.configfile.settings['tmc2209 stepper_x'] %} {% set RUN_CUR = driver_config.run_current %} # Imposta la corrente per l'homing sensorless SET_TMC_CURRENT STEPPER=stepper_x CURRENT={HOME_CUR} # Fai una pausa per assicurarti che il flag di stallo del driver sia clear G4 P2000 # Home G28 X0 # Spostamento G90 G1 X5 F1200 # Imposta corrente durante la stampa SET_TMC_CURRENT STEPPER=stepper_x CURRENT={RUN_CUR} La macro risultante pu\u00f2 essere chiamata da una sezione di configurazione homing_override o da una START_PRINT macro . Si noti che se viene modificata la corrente del driver durante l'homing, il processo di ottimizzazione dovrebbe essere eseguito nuovamente. Suggerimenti per l'homing sensorless su CoreXY \u00b6 \u00c8 possibile utilizzare l'homing sensorless sui carrelli X e Y di una stampante CoreXY. Klipper usa lo stepper [stepper_x] per rilevare gli stalli durante l'homing del carrello X e usa lo stepper [stepper_y] per rilevare gli stalli durante l'homing del carrello Y. Utilizzare la guida alla messa a punto sopra descritta per trovare la \"sensibilit\u00e0 allo stallo\" appropriata per ciascun carrello, ma prestare attenzione alle seguenti restrizioni: Quando si utilizza l'homing sensorless su CoreXY, assicurarsi che non sia configurato hold_current per nessuno dei due stepper. Durante la messa a punto, assicurati che entrambi i carrelli X e Y siano vicini al centro dei loro binari prima di ogni tentativo di homing. Al termine dell'ottimizzazione, quando si esegue l'homing sia di X che Y, utilizzare le macro per assicurarsi che un asse sia homed per primo, quindi spostare il carrello lontano dal limite dell'asse, fare una pausa per almeno 2 secondi, quindi avviare l'orientamento dell'altro carrello. L'allontanamento dall'asse evita l'homing di un asse mentre l'altro viene premuto contro il limite dell'asse (cosa potrebbe distorcere il rilevamento dello stallo). La pausa \u00e8 necessaria per garantire che il flag di stallo del driver sia cancellata prima del homing. Un esempio di macro homing CoreXY potrebbe essere simile a: [gcode_macro HOME] gcode: G90 # Home Z G28 Z0 G1 Z10 F1200 # Home Y G28 Y0 G1 Y5 F1200 # Home X G4 P2000 G28 X0 G1 X5 F1200 Interrogazione e diagnosi delle impostazioni del driver \u00b6 Il comando DUMP_TMC \u00e8 uno strumento utile durante la configurazione e la diagnosi dei driver. Riporter\u00e0 tutti i campi configurati da Klipper cos\u00ec come tutti i campi che possono essere interrogati dal driver. Tutti i campi riportati sono definiti nella scheda tecnica Trinamic per ciascun driver. Queste schede tecniche possono essere trovate sul sito web Trinamic . Ottenere e rivedere i dati Trinamic affinch\u00e9 il conducente interpreti i risultati di DUMP_TMC. Configurazione delle impostazioni driver_XXX \u00b6 Klipper supporta la configurazione di molti campi driver di basso livello usando le impostazioni driver_XXX . Il Riferimento alla configurazione del driver TMC contiene l'elenco completo dei campi disponibili per ogni tipo di driver. Inoltre, quasi tutti i campi possono essere modificati in fase di esecuzione utilizzando il comando SET_TMC_FIELD . Ciascuno di questi campi \u00e8 definito nella scheda tecnica Trinamic per ciascun driver. Queste schede tecniche possono essere trovate sul sito web Trinamic . Si noti che i fogli dati Trinamic a volte utilizzano un'espressione che pu\u00f2 confondere un'impostazione di alto livello (come \"fine isteresi\") con un valore di campo di basso livello (ad esempio, \"HEND\"). In Klipper, driver_XXX e SET_TMC_FIELD impostano sempre il valore del campo di basso livello che viene effettivamente scritto nel driver. Quindi, ad esempio, se il foglio dati Trinamic afferma che \u00e8 necessario scrivere un valore di 3 nel campo HEND per ottenere una \"fine dell'isteresi\" di 0, impostare driver_HEND=3 per ottenere il valore di alto livello di 0. Domande comuni \u00b6 Posso usare la modalit\u00e0 StealthChop su un estrusore con anticipo della pressione? \u00b6 Molte persone usano con successo la modalit\u00e0 \"stealthChop\" con pressure advance di Klipper. Klipper implementa Smooth Pressure Advance che non introduce variazioni di velocit\u00e0 istantanee. Tuttavia, la modalit\u00e0 \"stealthChop\" pu\u00f2 produrre una coppia del motore inferiore e/o produrre un maggiore calore del motore. Potrebbe essere o meno una modalit\u00e0 adeguata per la tua particolare stampante. Continuo a ricevere gli errori \"Impossibile leggere tmc uart 'stepper_x' register IFCNT\"? \u00b6 Ci\u00f2 si verifica quando Klipper non \u00e8 in grado di comunicare con un driver tmc2208 o tmc2209. Assicurarsi che l'alimentazione del motore sia abilitata, poich\u00e9 il driver del motore passo-passo generalmente necessita dell'alimentazione del motore prima di poter comunicare con il microcontrollore. Se questo errore si verifica dopo aver eseguito il flashing di Klipper per la prima volta, \u00e8 possibile che il driver stepper sia stato precedentemente programmato in uno stato non compatibile con Klipper. Per ripristinare lo stato, rimuovere tutta l'alimentazione dalla stampante per alcuni secondi (scollegare fisicamente sia USB che le spine di alimentazione). In caso contrario, questo errore \u00e8 in genere il risultato di un cablaggio errato del pin UART o di una configurazione Klipper errata delle impostazioni del pin UART. Continuo a ricevere errori \"Unable to write tmc spi 'stepper_x' register ...\"? \u00b6 Ci\u00f2 si verifica quando Klipper non \u00e8 in grado di comunicare con un driver tmc2130 o tmc5160. Assicurarsi che l'alimentazione del motore sia abilitata, poich\u00e9 il driver del motore passo-passo generalmente necessita dell'alimentazione del motore prima di poter comunicare con il microcontrollore. In caso contrario, questo errore \u00e8 in genere il risultato di un cablaggio SPI errato, una configurazione Klipper errata delle impostazioni SPI o una configurazione incompleta dei dispositivi su un bus SPI. Nota che se il driver si trova su un bus SPI condiviso con pi\u00f9 dispositivi, assicurati di configurare completamente ogni dispositivo su quel bus SPI condiviso in Klipper. Se un dispositivo su un bus SPI condiviso non \u00e8 configurato, potrebbe rispondere in modo errato a comandi non previsti e danneggiare la comunicazione con il dispositivo previsto. Se \u00e8 presente un dispositivo su un bus SPI condiviso che non pu\u00f2 essere configurato in Klipper, utilizzare una sezione di configurazione static_digital_output per impostare il pin CS del dispositivo inutilizzato alto (in modo che non tenti utilizzare il bus SPI). Lo schema della scheda \u00e8 spesso un utile riferimento per trovare quali dispositivi si trovano su un bus SPI e i pin associati. Perch\u00e9 ho ricevuto un errore \"TMC reports error: ...\"? \u00b6 Questo tipo di errore indica che il driver TMC ha rilevato un problema e si \u00e8 disabilitato. Cio\u00e8, il conducente ha smesso di mantenere la sua posizione e ha ignorato i comandi di movimento. Se Klipper rileva che un driver attivo si \u00e8 disabilitato, la stampante passer\u00e0 allo stato di \"spegnimento\". \u00c8 anche possibile che si verifichi un arresto TMC segnala errore a causa di errori SPI che impediscono la comunicazione con il driver (su tmc2130, tmc5160 o tmc2660). Se ci\u00f2 si verifica, \u00e8 normale che lo stato del driver riportato mostri 00000000 o ffffffff , ad esempio: TMC reports error: DRV_STATUS: ffffffff ... O TMC reports error: READRSP@RDSEL2: 00000000 ... . Tale errore pu\u00f2 essere dovuto a un problema di cablaggio SPI o pu\u00f2 essere dovuto a un ripristino automatico o a un guasto del driver TMC. Alcuni errori comuni e suggerimenti per diagnosticarli: TMC segnala l'errore: ... ot=1(OvertempError!) \u00b6 Ci\u00f2 indica che il driver del motore si \u00e8 disabilitato perch\u00e9 \u00e8 diventato troppo caldo. Le soluzioni tipiche consistono nel ridurre la corrente del motore passo-passo, aumentare il raffreddamento sul driver del motore passo-passo e/o aumentare il raffreddamento sul motore passo-passo. TMC segnala un errore: ... ShortToGND O LowSideShort \u00b6 Ci\u00f2 indica che il driver si \u00e8 disabilitato perch\u00e9 ha rilevato una corrente molto elevata che passa attraverso il driver. Ci\u00f2 potrebbe indicare un filo allentato o in cortocircuito al motore passo-passo o all'interno del motore passo-passo stesso. Questo errore pu\u00f2 verificarsi anche se si utilizza la modalit\u00e0 StealthChop e il driver TMC non \u00e8 in grado di prevedere con precisione il carico meccanico del motore. (Se il driver fa una previsione scadente, potrebbe inviare troppa corrente attraverso il motore e attivare il proprio rilevamento di sovracorrente.) Per verificarlo, disabilitare la modalit\u00e0 StealthChop e verificare se gli errori continuano a verificarsi. TMC segnala un errore: ... reset=1(Reset) OR CS_ACTUAL=0(Reset?) OR SE=0(Reset?) \u00b6 Ci\u00f2 indica che il driver si \u00e8 ripristinato durante la stampa. Ci\u00f2 potrebbe essere dovuto a problemi di tensione o cablaggio. TMC segnala l'errore: ... uv_cp=1(Undervoltage!) \u00b6 Ci\u00f2 indica che il driver ha rilevato un evento di bassa tensione e si \u00e8 disabilitato. Ci\u00f2 potrebbe essere dovuto a problemi di cablaggio o alimentazione. Come si regola la modalit\u00e0 spreadCycle/coolStep/etc. sui miei driver? \u00b6 Il sito web Trinamic contiene guide sulla configurazione dei driver. Queste guide sono spesso tecniche, di basso livello e potrebbero richiedere hardware specializzato. In ogni caso, sono la migliore fonte di informazioni.","title":"Driver TMC"},{"location":"TMC_Drivers.html#driver-tmc","text":"Questo documento fornisce informazioni sull'utilizzo dei driver Trinamic per motori stepper in modalit\u00e0 SPI/UART su Klipper. Klipper pu\u00f2 anche utilizzare i driver Trinamic nella loro \"modalit\u00e0 standalone\". Tuttavia, quando i driver sono in questa modalit\u00e0, non \u00e8 necessaria alcuna configurazione speciale di Klipper e le funzionalit\u00e0 avanzate di Klipper discusse in questo documento non sono disponibili. Oltre a questo documento, assicurati di rivedere il riferimento alla configurazione del driver TMC .","title":"Driver TMC"},{"location":"TMC_Drivers.html#regolazione-della-corrente-del-motore","text":"Una corrente pi\u00f9 alta del driver aumenta la precisione del posizionamento e la coppia. Tuttavia, una corrente pi\u00f9 elevata aumenta anche il calore prodotto dal motore passo-passo e dal driver del motore passo-passo. Se il driver del motore passo-passo si surriscalda, si disabiliter\u00e0 e Klipper segnaler\u00e0 un errore. Se il motore passo-passo si surriscalda, perde coppia e precisione di posizionamento. (Se diventa molto caldo, potrebbe anche fondere le parti di plastica attaccate o vicino ad esso.) Come consiglio generale per l'ottimizzazione, preferire valori di corrente pi\u00f9 elevati purch\u00e9 il motore passo-passo non si surriscaldi troppo e il driver del motore passo-passo non segnali avvisi o errori. In generale, va bene che il motore passo-passo sia caldo, ma non dovrebbe diventare cos\u00ec caldo da risultare doloroso al tatto.","title":"Regolazione della corrente del motore"},{"location":"TMC_Drivers.html#preferibilmente-non-specificare-un-hold_current","text":"Se si configura un hold_current , il driver TMC pu\u00f2 ridurre la corrente al motore passo-passo quando rileva che il passo-passo non si sta muovendo. Tuttavia, la variazione della corrente del motore pu\u00f2 di per s\u00e9 introdurre il movimento del motore. Ci\u00f2 pu\u00f2 verificarsi a causa di \"forze di arresto\" all'interno del motore passo-passo (il magnete permanente nel rotore tira verso i denti di ferro nello statore) o a causa di forze esterne sul carrello dell'asse. La maggior parte dei motori passo-passo non otterr\u00e0 un beneficio significativo dalla riduzione della corrente durante le normali stampe, perch\u00e9 pochi movimenti di stampa lasceranno un motore passo-passo inattivo per un tempo sufficientemente lungo da attivare la funzione hold_current . Ed \u00e8 improbabile che si vogliano introdurre sottili artefatti di stampa nelle poche mosse di stampa che lasciano uno stepper inattivo sufficientemente a lungo. Se si desidera ridurre la corrente ai motori durante le routine di avvio della stampa, considerare l'emissione di comandi SET_TMC_CURRENT in una START_PRINT macro per regolare la corrente prima e dopo i normali spostamenti di stampa. Alcune stampanti con motori Z dedicati che sono inattivi durante i normali movimenti di stampa (nessuna bed_mesho, nessuna inclinazione_piatto, nessuna correzione_inclinazione Z, nessuna stampa in \"modalit\u00e0 vaso\", ecc.) potrebbero scoprire che i motori Z funzionano a temperature pi\u00f9 basse con un hold_current . Se si implementa questo, assicurarsi di prendere in considerazione questo tipo di movimento dell'asse Z non comandato durante il livellamento del piatto, il rilevamento del piatto, la calibrazione della sonda e simili. Anche driver_TPOWERDOWN e driver_IHOLDDELAY dovrebbero essere calibrati di conseguenza. Se non sei sicuro, preferisci non specificare un hold_current .","title":"Preferibilmente non specificare un hold_current"},{"location":"TMC_Drivers.html#impostazione-della-modalita-spreadcycle-rispetto-a-stealthchop","text":"Per impostazione predefinita, Klipper mette i driver TMC in modalit\u00e0 \"spreadCycle\". Se il driver supporta \"stealthChop\", pu\u00f2 essere abilitato aggiungendo stealthchop_threshold: 999999 alla sezione di configurazione di TMC. In generale, la modalit\u00e0 SpreadCycle fornisce una coppia maggiore e una maggiore precisione di posizionamento rispetto alla modalit\u00e0 StealthChop. Tuttavia, la modalit\u00e0 StealthChop pu\u00f2 produrre un rumore udibile notevolmente inferiore su alcune stampanti. I test di confronto delle modalit\u00e0 hanno mostrato un \"ritardo posizionale\" aumentato di circa il 75% di un passo completo durante i movimenti a velocit\u00e0 costante quando si utilizza la modalit\u00e0 StealthChop (ad esempio, su una stampante con distanza_rotazione di 40 mm e 200 passi_per_rotazione, la deviazione di posizione dei movimenti a velocit\u00e0 costante \u00e8 aumentata di ~0,150 mm). Tuttavia, questo \"ritardo nell'ottenimento della posizione richiesta\" potrebbe non manifestarsi come un difetto di stampa significativo e si potrebbe preferire il comportamento pi\u00f9 silenzioso della modalit\u00e0 stealthChop. Si consiglia di utilizzare sempre la modalit\u00e0 \"spreadCycle\" (non specificando stealthchop_threshold ) o di utilizzare sempre la modalit\u00e0 \"stealthChop\" (impostando stealthchop_threshold su 999999). Sfortunatamente, i driver spesso producono risultati scadenti e confusi se la modalit\u00e0 cambia mentre il motore \u00e8 a una velocit\u00e0 diversa da zero.","title":"Impostazione della modalit\u00e0 \"spreadCycle\" rispetto a \"stealthChop\""},{"location":"TMC_Drivers.html#limpostazione-dellinterpolazione-tmc-introduce-una-piccola-deviazione-di-posizione","text":"L'impostazione interpolate del driver TMC pu\u00f2 ridurre il rumore udibile del movimento della stampante a costo di introdurre un piccolo errore di posizione sistemico. Questo errore di posizione sistematico deriva dal ritardo del driver nell'esecuzione dei \"passi\" inviati da Klipper. Durante i movimenti a velocit\u00e0 costante, questo ritardo si traduce in un errore di posizione di quasi mezzo micropasso configurato (pi\u00f9 precisamente, l'errore \u00e8 di mezzo micropasso meno un 512esimo di un passo intero). Ad esempio, su un asse con una distanza_rotazione di 40 mm, 200 passi_per_rotazione e 16 micropassi, l'errore sistemico introdotto durante i movimenti a velocit\u00e0 costante \u00e8 ~0,006 mm. Per una migliore precisione di posizionamento, considerare l'utilizzo della modalit\u00e0 SpreadCycle e disabilitare l'interpolazione (impostare interpolate: False nella configurazione del driver TMC). Se configurato in questo modo, \u00e8 possibile aumentare l'impostazione microstep per ridurre il rumore udibile durante il movimento del passo-passo. Tipicamente, un'impostazione microstep di 64 o 128 avr\u00e0 un rumore udibile simile all'interpolazione e lo far\u00e0 senza introdurre un errore posizionale sistemico. Se si utilizza la modalit\u00e0 StealthChop, l'imprecisione posizionale dell'interpolazione \u00e8 piccola rispetto all'imprecisione posizionale introdotta dalla modalit\u00e0 StealthChop. Pertanto l'interpolazione dell'ottimizzazione non \u00e8 considerata utile in modalit\u00e0 StealthChop e si pu\u00f2 lasciare l'interpolazione nel suo stato predefinito.","title":"L'impostazione dell'interpolazione TMC introduce una piccola deviazione di posizione"},{"location":"TMC_Drivers.html#homing-sensorless","text":"L'homing senza sensori consente di posizionare un asse senza la necessit\u00e0 di un finecorsa fisico. Invece, il carrello sull'asse viene spostato nel finecorsa meccanico facendo perdere passi al motore passo-passo. Il driver stepper rileva i passi persi e lo indica all'MCU di controllo (Klipper) attivando un pin. Queste informazioni possono essere utilizzate da Klipper come fine corsa per l'asse. Questa guida illustra l'impostazione dell'homing sensorless per l'asse X della stampante (cartesiana). Tuttavia, funziona allo stesso modo con tutti gli altri assi (che richiedono un fine corsa). Dovresti configurarlo e sintonizzarlo per un asse alla volta.","title":"Homing Sensorless"},{"location":"TMC_Drivers.html#limitazioni","text":"Assicurati che i tuoi componenti meccanici siano in grado di sopportare il carico del carrello che urta ripetutamente il limite dell'asse. Soprattutto le viti di comando potrebbero generare molta forza. L'homing di un asse Z facendo urtare l'ugello sulla superficie di stampa potrebbe non essere una buona idea. Per ottenere i migliori risultati, verificare che il carrello dell'asse stabilisca un contatto stabile con il limite dell'asse. Inoltre, l'homing sensorless potrebbe non essere sufficientemente preciso per la tua stampante. Sebbene l'homing degli assi X e Y su una macchina cartesiana possa funzionare bene, l'homing dell'asse Z in genere non \u00e8 sufficientemente preciso e pu\u00f2 comportare un'altezza del primo strato incoerente. L'homing di una stampante delta sensorless non \u00e8 consigliabile a causa della mancanza di precisione. Inoltre, il rilevamento dello stallo del driver passo-passo dipende dal carico meccanico sul motore, dalla corrente del motore e dalla temperatura del motore (resistenza della bobina). L'homing sensorless funziona meglio a velocit\u00e0 medie del motore. Per velocit\u00e0 molto basse (inferiori a 10 giri/min) il motore non genera una significativa EMF di ritorno e il TMC non \u00e8 in grado di rilevare in modo affidabile gli stalli del motore. Inoltre, a velocit\u00e0 molto elevate, l'EMF di ritorno del motore si avvicina alla tensione di alimentazione del motore, quindi il TMC non \u00e8 pi\u00f9 in grado di rilevare gli stalli. Si consiglia di dare un'occhiata alla scheda tecnica del proprio TMC specifico. L\u00ec puoi anche trovare maggiori dettagli sulle limitazioni di questa configurazione.","title":"Limitazioni"},{"location":"TMC_Drivers.html#prerequisiti","text":"Sono necessari alcuni prerequisiti per utilizzare l'homing sensorless: Driver passo-passo TMC compatibile con stallGuard (tmc2130, tmc2209, tmc2660 o tmc5160). Interfaccia SPI/UART del driver TMC cablata al microcontrollore (la modalit\u00e0 stand-alone non funziona). Il pin \"DIAG\" o \"SG_TST\" appropriato del driver TMC collegato al microcontrollore. I passaggi nel documento config checks devono essere eseguiti per confermare che i motori passo-passo siano configurati e funzionino correttamente.","title":"Prerequisiti"},{"location":"TMC_Drivers.html#messa-a-punto","text":"La procedura qui descritta prevede sei passaggi principali: Scegli una velocit\u00e0 di homing. Configura il file printer.cfg per abilitare l'homing sensorless. Trova l'impostazione stallguard con la massima sensibilit\u00e0 che funziona con successo. Trova l'impostazione stallguard con la sensibilit\u00e0 pi\u00f9 bassa che effettua homing con successo con un solo tocco. Aggiorna il printer.cfg con l'impostazione di stallguard desiderata. Crea o aggiorna le macro printer.cfg per homing in modo coerente.","title":"Messa a punto"},{"location":"TMC_Drivers.html#scegli-la-velocita-di-homing","text":"La velocit\u00e0 di homing \u00e8 una scelta importante quando si esegue l'homing senza sensori. \u00c8 consigliabile utilizzare una velocit\u00e0 di riferimento bassa in modo che il carrello non eserciti una forza eccessiva sul telaio quando entra in contatto con l'estremit\u00e0 della rotaia. Tuttavia, i driver TMC non sono in grado di rilevare in modo affidabile uno stallo a velocit\u00e0 molto basse. Un buon punto di partenza per la velocit\u00e0 di homing \u00e8 che il motore passo-passo esegua una rotazione completa ogni due secondi. Per molti assi questa sar\u00e0 la rotation_distance divisa per due. Per esempio: [stepper_x] rotation_distance: 40 homing_speed: 20 ...","title":"Scegli la velocit\u00e0 di homing"},{"location":"TMC_Drivers.html#configura-printercfg-per-lhoming-sensorless","text":"L'impostazione homing_retract_dist deve essere impostata su zero nella sezione di configurazione stepper_x per disabilitare il secondo movimento di homing. Il secondo tentativo di homing non aggiunge valore quando si utilizza l'homing sensorless, non funzioner\u00e0 in modo affidabile e confonder\u00e0 il processo di ottimizzazione. Assicurati che un'impostazione hold_current non sia specificata nella sezione del driver TMC del file config. (Se viene impostata una hold_current, dopo che \u00e8 stato stabilito il contatto, il motore si arresta mentre il carrello viene premuto contro l'estremit\u00e0 del binario e la riduzione della corrente mentre si trova in quella posizione pu\u00f2 causare il movimento del carrello, il che si traduce in prestazioni scadenti e confonde il processo di regolazione.) \u00c8 necessario configurare i pin di homing sensorless e configurare le impostazioni iniziali di \"stallguard\". Una configurazione di esempio tmc2209 per un asse X potrebbe essere simile a: [tmc2209 stepper_x] diag_pin: ^PA1 # Impostare sul pin MCU collegato al pin TMC DIAG driver_SGTHRS: 255 #255 \u00e8 il valore pi\u00f9 sensibile, 0 \u00e8 il meno sensibile ... [stepper_x] endstop_pin: tmc2209_stepper_x:virtual_endstop homing_retract_dist: 0 ... Un esempio di configurazione tmc2130 o tmc5160 potrebbe essere simile a: [tmc2130 stepper_x] diag1_pin: ^!PA1 # Pin collegato al pin TMC DIAG1 (o utilizzare pin diag0_pin / DIAG0) driver_SGT: -64 # -64 \u00e8 il valore pi\u00f9 sensibile, 63 \u00e8 il meno sensibile ... [stepper_x] endstop_pin: tmc2130_stepper_x:virtual_endstop homing_retract_dist: 0 ... Un esempio di configurazione di tmc2660 potrebbe essere simile a: [tmc2660 stepper_x] driver_SGT: -64 # -64 \u00e8 il valore pi\u00f9 sensibile, 63 \u00e8 il meno sensibile ... [stepper_x] endstop_pin: ^PA1 # Pin collegato al pin TMC SG_TST homing_retract_dist: 0 ... Gli esempi sopra mostrano solo le impostazioni specifiche per l'homing sensorless. Vedere il riferimento alla configurazione per tutte le opzioni disponibili.","title":"Configura printer.cfg per l'homing sensorless"},{"location":"TMC_Drivers.html#trova-la-massima-sensibilita-che-porta-a-homing-con-successo","text":"Posizionare il carrello vicino al centro del binario. Utilizzare il comando SET_TMC_FIELD per impostare la sensibilit\u00e0 pi\u00f9 alta. Per tmc2209: SET_TMC_FIELD STEPPER=stepper_x FIELD=SGTHRS VALUE=255 Per tmc2130, tmc5160 e tmc2660: SET_TMC_FIELD STEPPER=stepper_x FIELD=sgt VALUE=-64 Quindi inviare un comando G28 X0 e verificare che l'asse non si muova affatto o smetta rapidamente di muoversi. Se l'asse non si ferma, inviare un M112 per fermare la stampante - qualcosa non \u00e8 corretto con il cablaggio o la configurazione dei pin diag/sg_tst e deve essere corretto prima di continuare. Quindi, diminuire progressivamente la sensibilit\u00e0 dell'impostazione VALUE ed eseguire nuovamente i comandi SET_TMC_FIELD G28 X0 per trovare la sensibilit\u00e0 pi\u00f9 alta che fa s\u00ec che il carrello si muova con successo fino all'arresto e si arresti. (Per i driver tmc2209 questo diminuir\u00e0 SGTHRS, per altri conducenti aumenter\u00e0 il sgt.) Assicurati di iniziare ogni tentativo con il carrello vicino al centro del binario (se necessario, emetti M84 e quindi sposta manualmente il carrello sul centro). Dovrebbe essere possibile trovare la sensibilit\u00e0 pi\u00f9 alta che si adatta in modo affidabile (le impostazioni con una sensibilit\u00e0 pi\u00f9 alta comportano movimenti piccoli o nulli). Nota il valore trovato come sensibilit\u00e0_massima . (Se si ottiene la sensibilit\u00e0 minima possibile (SGTHRS=0 o sgt=63) senza alcun movimento del carrello, allora qualcosa non \u00e8 corretto con il cablaggio o la configurazione dei pin diag/sg_tst e deve essere corretto prima di continuare.) Quando si cerca la sensibilit\u00e0_massima, pu\u00f2 essere conveniente passare a diverse impostazioni VALUE (in modo da dividere in due il parametro VALUE). In tal caso, prepararsi a emettere un comando M112 per arrestare la stampante, poich\u00e9 un'impostazione con una sensibilit\u00e0 molto bassa potrebbe far \"sbattere\" ripetutamente l'asse contro l'estremit\u00e0 del binario. Assicurati di attendere un paio di secondi tra ogni tentativo di homing. Dopo che il driver TMC ha rilevato uno stallo, potrebbe volerci un po' di tempo per cancellare il suo indicatore interno ed essere in grado di rilevare un altro stallo. Durante questi test di ottimizzazione, se un comando G28 X0 non si sposta fino al limite dell'asse, prestare attenzione nell'emettere qualsiasi comando di movimento regolare (ad es. G1 ). Klipper non avr\u00e0 una corretta comprensione della posizione del carrello e un comando di spostamento potrebbe causare risultati indesiderati e confusi.","title":"Trova la massima sensibilit\u00e0 che porta a homing con successo"},{"location":"TMC_Drivers.html#trova-la-sensibilita-piu-bassa-che-porta-a-homing-con-un-solo-tocco","text":"Quando si effettua l'homing con il valore maximum_sensitivity trovato, l'asse dovrebbe spostarsi all'estremit\u00e0 del binario e fermarsi con un \"tocco singolo\", ovvero non dovrebbe esserci un \"clic\" o un \"sbattere\". (Se c'\u00e8 un suono che sbatte o scatta alla sensibilit\u00e0_massima, allora la velocit\u00e0 di riferimento potrebbe essere troppo bassa, la corrente del driver potrebbe essere troppo bassa o la corsa di riferimento senza sensore potrebbe non essere una buona scelta per l'asse.) Il passo successivo \u00e8 spostare di nuovo continuamente il carrello in una posizione vicino al centro della rotaia, diminuire la sensibilit\u00e0 ed eseguire i comandi SET_TMC_FIELD G28 X0 - l'obiettivo ora \u00e8 trovare la sensibilit\u00e0 pi\u00f9 bassa che risulti ancora nel la carrozza torna con successo al punto di riferimento con un \"tocco singolo\". Cio\u00e8, non \"sbatte\" o \"clic\" quando viene a contatto con l'estremit\u00e0 del binario. Nota il valore trovato come sensibilit\u00e0_minima .","title":"Trova la sensibilit\u00e0 pi\u00f9 bassa che porta a homing con un solo tocco"},{"location":"TMC_Drivers.html#aggiorna-printercfg-con-il-valore-della-sensibilita","text":"Dopo aver trovato sensibilit\u00e0_massima e sensibilit\u00e0_minima , utilizzare una calcolatrice per ottenere la sensibilit\u00e0 consigliata come sensibilit\u00e0_minima + (sensibilit\u00e0_massima - sensibilit\u00e0_minima)/3 . La sensibilit\u00e0 consigliata dovrebbe essere compresa tra il minimo e il massimo, ma leggermente pi\u00f9 vicino al minimo. Arrotonda il valore finale al valore intero pi\u00f9 vicino. Per tmc2209 impostalo nella configurazione come driver_SGTHRS , per altri driver TMC impostalo nella configurazione come driver_SGT . Se l'intervallo tra sensibilit\u00e0_massima e sensibilit\u00e0_minima \u00e8 piccolo (ad esempio, inferiore a 5), potrebbe risultare in un homing instabile. Una velocit\u00e0 di riferimento pi\u00f9 elevata pu\u00f2 aumentare il range e rendere l'operazione pi\u00f9 stabile. Si noti che se viene apportata una modifica alla corrente del driver, alla velocit\u00e0 di riferimento o viene apportata una modifica notevole all'hardware della stampante, sar\u00e0 necessario eseguire nuovamente il processo di ottimizzazione.","title":"Aggiorna printer.cfg con il valore della sensibilit\u00e0"},{"location":"TMC_Drivers.html#utilizzo-delle-macro-durante-lhoming","text":"Dopo aver completato l'homing senza sensori, il carrello verr\u00e0 premuto contro l'estremit\u00e0 del binario e lo stepper eserciter\u00e0 una forza sul telaio fino a quando il carrello non si allontana. \u00c8 una buona idea creare una macro per posizionare l'asse e allontanare immediatamente il carrello dall'estremit\u00e0 della rotaia. \u00c8 una buona idea che la macro si metta in pausa di almeno 2 secondi prima di iniziare l'homing sensorless (o altrimenti assicurarsi che non ci siano stati movimenti sullo stepper per 2 secondi). Senza ritardo \u00e8 possibile che il flag di stallo interno del driver sia ancora impostato da un movimento precedente. Pu\u00f2 anche essere utile fare in modo che quella macro imposti la corrente del driver prima della corsa di riferimento e imposti una nuova corrente dopo che il carrello si \u00e8 allontanato. Una macro di esempio potrebbe assomigliare a: [gcode_macro SENSORLESS_HOME_X] gcode: {% set HOME_CUR = 0.700 %} {% set driver_config = printer.configfile.settings['tmc2209 stepper_x'] %} {% set RUN_CUR = driver_config.run_current %} # Imposta la corrente per l'homing sensorless SET_TMC_CURRENT STEPPER=stepper_x CURRENT={HOME_CUR} # Fai una pausa per assicurarti che il flag di stallo del driver sia clear G4 P2000 # Home G28 X0 # Spostamento G90 G1 X5 F1200 # Imposta corrente durante la stampa SET_TMC_CURRENT STEPPER=stepper_x CURRENT={RUN_CUR} La macro risultante pu\u00f2 essere chiamata da una sezione di configurazione homing_override o da una START_PRINT macro . Si noti che se viene modificata la corrente del driver durante l'homing, il processo di ottimizzazione dovrebbe essere eseguito nuovamente.","title":"Utilizzo delle macro durante l'homing"},{"location":"TMC_Drivers.html#suggerimenti-per-lhoming-sensorless-su-corexy","text":"\u00c8 possibile utilizzare l'homing sensorless sui carrelli X e Y di una stampante CoreXY. Klipper usa lo stepper [stepper_x] per rilevare gli stalli durante l'homing del carrello X e usa lo stepper [stepper_y] per rilevare gli stalli durante l'homing del carrello Y. Utilizzare la guida alla messa a punto sopra descritta per trovare la \"sensibilit\u00e0 allo stallo\" appropriata per ciascun carrello, ma prestare attenzione alle seguenti restrizioni: Quando si utilizza l'homing sensorless su CoreXY, assicurarsi che non sia configurato hold_current per nessuno dei due stepper. Durante la messa a punto, assicurati che entrambi i carrelli X e Y siano vicini al centro dei loro binari prima di ogni tentativo di homing. Al termine dell'ottimizzazione, quando si esegue l'homing sia di X che Y, utilizzare le macro per assicurarsi che un asse sia homed per primo, quindi spostare il carrello lontano dal limite dell'asse, fare una pausa per almeno 2 secondi, quindi avviare l'orientamento dell'altro carrello. L'allontanamento dall'asse evita l'homing di un asse mentre l'altro viene premuto contro il limite dell'asse (cosa potrebbe distorcere il rilevamento dello stallo). La pausa \u00e8 necessaria per garantire che il flag di stallo del driver sia cancellata prima del homing. Un esempio di macro homing CoreXY potrebbe essere simile a: [gcode_macro HOME] gcode: G90 # Home Z G28 Z0 G1 Z10 F1200 # Home Y G28 Y0 G1 Y5 F1200 # Home X G4 P2000 G28 X0 G1 X5 F1200","title":"Suggerimenti per l'homing sensorless su CoreXY"},{"location":"TMC_Drivers.html#interrogazione-e-diagnosi-delle-impostazioni-del-driver","text":"Il comando DUMP_TMC \u00e8 uno strumento utile durante la configurazione e la diagnosi dei driver. Riporter\u00e0 tutti i campi configurati da Klipper cos\u00ec come tutti i campi che possono essere interrogati dal driver. Tutti i campi riportati sono definiti nella scheda tecnica Trinamic per ciascun driver. Queste schede tecniche possono essere trovate sul sito web Trinamic . Ottenere e rivedere i dati Trinamic affinch\u00e9 il conducente interpreti i risultati di DUMP_TMC.","title":"Interrogazione e diagnosi delle impostazioni del driver"},{"location":"TMC_Drivers.html#configurazione-delle-impostazioni-driver_xxx","text":"Klipper supporta la configurazione di molti campi driver di basso livello usando le impostazioni driver_XXX . Il Riferimento alla configurazione del driver TMC contiene l'elenco completo dei campi disponibili per ogni tipo di driver. Inoltre, quasi tutti i campi possono essere modificati in fase di esecuzione utilizzando il comando SET_TMC_FIELD . Ciascuno di questi campi \u00e8 definito nella scheda tecnica Trinamic per ciascun driver. Queste schede tecniche possono essere trovate sul sito web Trinamic . Si noti che i fogli dati Trinamic a volte utilizzano un'espressione che pu\u00f2 confondere un'impostazione di alto livello (come \"fine isteresi\") con un valore di campo di basso livello (ad esempio, \"HEND\"). In Klipper, driver_XXX e SET_TMC_FIELD impostano sempre il valore del campo di basso livello che viene effettivamente scritto nel driver. Quindi, ad esempio, se il foglio dati Trinamic afferma che \u00e8 necessario scrivere un valore di 3 nel campo HEND per ottenere una \"fine dell'isteresi\" di 0, impostare driver_HEND=3 per ottenere il valore di alto livello di 0.","title":"Configurazione delle impostazioni driver_XXX"},{"location":"TMC_Drivers.html#domande-comuni","text":"","title":"Domande comuni"},{"location":"TMC_Drivers.html#posso-usare-la-modalita-stealthchop-su-un-estrusore-con-anticipo-della-pressione","text":"Molte persone usano con successo la modalit\u00e0 \"stealthChop\" con pressure advance di Klipper. Klipper implementa Smooth Pressure Advance che non introduce variazioni di velocit\u00e0 istantanee. Tuttavia, la modalit\u00e0 \"stealthChop\" pu\u00f2 produrre una coppia del motore inferiore e/o produrre un maggiore calore del motore. Potrebbe essere o meno una modalit\u00e0 adeguata per la tua particolare stampante.","title":"Posso usare la modalit\u00e0 StealthChop su un estrusore con anticipo della pressione?"},{"location":"TMC_Drivers.html#continuo-a-ricevere-gli-errori-impossibile-leggere-tmc-uart-stepper_x-register-ifcnt","text":"Ci\u00f2 si verifica quando Klipper non \u00e8 in grado di comunicare con un driver tmc2208 o tmc2209. Assicurarsi che l'alimentazione del motore sia abilitata, poich\u00e9 il driver del motore passo-passo generalmente necessita dell'alimentazione del motore prima di poter comunicare con il microcontrollore. Se questo errore si verifica dopo aver eseguito il flashing di Klipper per la prima volta, \u00e8 possibile che il driver stepper sia stato precedentemente programmato in uno stato non compatibile con Klipper. Per ripristinare lo stato, rimuovere tutta l'alimentazione dalla stampante per alcuni secondi (scollegare fisicamente sia USB che le spine di alimentazione). In caso contrario, questo errore \u00e8 in genere il risultato di un cablaggio errato del pin UART o di una configurazione Klipper errata delle impostazioni del pin UART.","title":"Continuo a ricevere gli errori \"Impossibile leggere tmc uart 'stepper_x' register IFCNT\"?"},{"location":"TMC_Drivers.html#continuo-a-ricevere-errori-unable-to-write-tmc-spi-stepper_x-register","text":"Ci\u00f2 si verifica quando Klipper non \u00e8 in grado di comunicare con un driver tmc2130 o tmc5160. Assicurarsi che l'alimentazione del motore sia abilitata, poich\u00e9 il driver del motore passo-passo generalmente necessita dell'alimentazione del motore prima di poter comunicare con il microcontrollore. In caso contrario, questo errore \u00e8 in genere il risultato di un cablaggio SPI errato, una configurazione Klipper errata delle impostazioni SPI o una configurazione incompleta dei dispositivi su un bus SPI. Nota che se il driver si trova su un bus SPI condiviso con pi\u00f9 dispositivi, assicurati di configurare completamente ogni dispositivo su quel bus SPI condiviso in Klipper. Se un dispositivo su un bus SPI condiviso non \u00e8 configurato, potrebbe rispondere in modo errato a comandi non previsti e danneggiare la comunicazione con il dispositivo previsto. Se \u00e8 presente un dispositivo su un bus SPI condiviso che non pu\u00f2 essere configurato in Klipper, utilizzare una sezione di configurazione static_digital_output per impostare il pin CS del dispositivo inutilizzato alto (in modo che non tenti utilizzare il bus SPI). Lo schema della scheda \u00e8 spesso un utile riferimento per trovare quali dispositivi si trovano su un bus SPI e i pin associati.","title":"Continuo a ricevere errori \"Unable to write tmc spi 'stepper_x' register ...\"?"},{"location":"TMC_Drivers.html#perche-ho-ricevuto-un-errore-tmc-reports-error","text":"Questo tipo di errore indica che il driver TMC ha rilevato un problema e si \u00e8 disabilitato. Cio\u00e8, il conducente ha smesso di mantenere la sua posizione e ha ignorato i comandi di movimento. Se Klipper rileva che un driver attivo si \u00e8 disabilitato, la stampante passer\u00e0 allo stato di \"spegnimento\". \u00c8 anche possibile che si verifichi un arresto TMC segnala errore a causa di errori SPI che impediscono la comunicazione con il driver (su tmc2130, tmc5160 o tmc2660). Se ci\u00f2 si verifica, \u00e8 normale che lo stato del driver riportato mostri 00000000 o ffffffff , ad esempio: TMC reports error: DRV_STATUS: ffffffff ... O TMC reports error: READRSP@RDSEL2: 00000000 ... . Tale errore pu\u00f2 essere dovuto a un problema di cablaggio SPI o pu\u00f2 essere dovuto a un ripristino automatico o a un guasto del driver TMC. Alcuni errori comuni e suggerimenti per diagnosticarli:","title":"Perch\u00e9 ho ricevuto un errore \"TMC reports error: ...\"?"},{"location":"TMC_Drivers.html#tmc-segnala-lerrore-ot1overtemperror","text":"Ci\u00f2 indica che il driver del motore si \u00e8 disabilitato perch\u00e9 \u00e8 diventato troppo caldo. Le soluzioni tipiche consistono nel ridurre la corrente del motore passo-passo, aumentare il raffreddamento sul driver del motore passo-passo e/o aumentare il raffreddamento sul motore passo-passo.","title":"TMC segnala l'errore: ... ot=1(OvertempError!)"},{"location":"TMC_Drivers.html#tmc-segnala-un-errore-shorttognd-o-lowsideshort","text":"Ci\u00f2 indica che il driver si \u00e8 disabilitato perch\u00e9 ha rilevato una corrente molto elevata che passa attraverso il driver. Ci\u00f2 potrebbe indicare un filo allentato o in cortocircuito al motore passo-passo o all'interno del motore passo-passo stesso. Questo errore pu\u00f2 verificarsi anche se si utilizza la modalit\u00e0 StealthChop e il driver TMC non \u00e8 in grado di prevedere con precisione il carico meccanico del motore. (Se il driver fa una previsione scadente, potrebbe inviare troppa corrente attraverso il motore e attivare il proprio rilevamento di sovracorrente.) Per verificarlo, disabilitare la modalit\u00e0 StealthChop e verificare se gli errori continuano a verificarsi.","title":"TMC segnala un errore: ... ShortToGND O LowSideShort"},{"location":"TMC_Drivers.html#tmc-segnala-un-errore-reset1reset-or-cs_actual0reset-or-se0reset","text":"Ci\u00f2 indica che il driver si \u00e8 ripristinato durante la stampa. Ci\u00f2 potrebbe essere dovuto a problemi di tensione o cablaggio.","title":"TMC segnala un errore: ... reset=1(Reset) OR CS_ACTUAL=0(Reset?) OR SE=0(Reset?)"},{"location":"TMC_Drivers.html#tmc-segnala-lerrore-uv_cp1undervoltage","text":"Ci\u00f2 indica che il driver ha rilevato un evento di bassa tensione e si \u00e8 disabilitato. Ci\u00f2 potrebbe essere dovuto a problemi di cablaggio o alimentazione.","title":"TMC segnala l'errore: ... uv_cp=1(Undervoltage!)"},{"location":"TMC_Drivers.html#come-si-regola-la-modalita-spreadcyclecoolstepetc-sui-miei-driver","text":"Il sito web Trinamic contiene guide sulla configurazione dei driver. Queste guide sono spesso tecniche, di basso livello e potrebbero richiedere hardware specializzato. In ogni caso, sono la migliore fonte di informazioni.","title":"Come si regola la modalit\u00e0 spreadCycle/coolStep/etc. sui miei driver?"},{"location":"TSL1401CL_Filament_Width_Sensor.html","text":"Sensore TSL1401CL di larghezza del filamento \u00b6 Questo documento descrive il modulo host del sensore di larghezza del filamento (Filament Width Sensor). L'hardware utilizzato per lo sviluppo di questo modulo host si basa sull'array di sensori lineari TSL1401CL, ma pu\u00f2 funzionare con qualsiasi array di sensori dotato di uscita analogica. Puoi trovare design su Thingiverse . Per utilizzare un array di sensori come sensore di larghezza del filamento, leggere Config Reference e G-Code documentation . Come funziona? \u00b6 Il sensore genera un'uscita analogica in base alla larghezza calcolata del filamento. La tensione di uscita \u00e8 sempre uguale alla larghezza del filamento rilevata (es. 1.65v, 1.70v, 3.0v). Il modulo host monitora le variazioni di tensione e regola il moltiplicatore di estrusione. Note: \u00b6 Letture del sensore eseguite con intervalli di 10 mm predefiniti Se necessario, sei libero di modificare questa impostazione modificando il parametro MEASUREMENT_INTERVAL_MM nel file filament_width_sensor.py .","title":"Sensore TSL1401CL di larghezza del filamento"},{"location":"TSL1401CL_Filament_Width_Sensor.html#sensore-tsl1401cl-di-larghezza-del-filamento","text":"Questo documento descrive il modulo host del sensore di larghezza del filamento (Filament Width Sensor). L'hardware utilizzato per lo sviluppo di questo modulo host si basa sull'array di sensori lineari TSL1401CL, ma pu\u00f2 funzionare con qualsiasi array di sensori dotato di uscita analogica. Puoi trovare design su Thingiverse . Per utilizzare un array di sensori come sensore di larghezza del filamento, leggere Config Reference e G-Code documentation .","title":"Sensore TSL1401CL di larghezza del filamento"},{"location":"TSL1401CL_Filament_Width_Sensor.html#come-funziona","text":"Il sensore genera un'uscita analogica in base alla larghezza calcolata del filamento. La tensione di uscita \u00e8 sempre uguale alla larghezza del filamento rilevata (es. 1.65v, 1.70v, 3.0v). Il modulo host monitora le variazioni di tensione e regola il moltiplicatore di estrusione.","title":"Come funziona?"},{"location":"TSL1401CL_Filament_Width_Sensor.html#note","text":"Letture del sensore eseguite con intervalli di 10 mm predefiniti Se necessario, sei libero di modificare questa impostazione modificando il parametro MEASUREMENT_INTERVAL_MM nel file filament_width_sensor.py .","title":"Note:"},{"location":"Using_PWM_Tools.html","text":"Utilizzo dei strumenti PWM \u00b6 Questo documento descrive come impostare un laser o un mandrino controllato da PWM usando output_pin e alcune macro. Come funziona? \u00b6 Riutilizzando l'output pwm della ventola della testina di stampa, \u00e8 possibile controllare laser o mandrini. Ci\u00f2 \u00e8 utile se si utilizzano testine di stampa intercambiabili, ad esempio il cambio utensile E3D o una soluzione fai-da-te. Di solito, gli strumenti cam come LaserWeb possono essere configurati per utilizzare i comandi M3-M5 , che stanno per velocit\u00e0 mandrino CW ( M3 S[0-255] ), velocit\u00e0 mandrino CCW ( M4 S[ 0-255] ) e arresto mandrino ( M5 ). Attenzione: Quando utilizzi un laser, mantieni tutte le precauzioni di sicurezza che ti vengono in mente! I laser a diodi sono generalmente invertiti. Ci\u00f2 significa che quando l'MCU si riavvia, il laser sar\u00e0 completamente acceso per il tempo necessario al riavvio dell'MCU. Per buona misura, si raccomanda di indossare sempre occhiali laser appropriati della giusta lunghezza d'onda se il laser \u00e8 alimentato e per disconnettere il laser quando non \u00e8 necessario. Inoltre, dovresti configurare un timeout di sicurezza, in modo che quando l'host o l'MCU riscontrano un errore, lo strumento si arresti. Per un esempio di configurazione, vedere config/sample-pwm-tool.cfg . Limitazioni attuali \u00b6 Esiste una limitazione della frequenza degli aggiornamenti PWM. Pur essendo molto preciso, un aggiornamento PWM pu\u00f2 verificarsi solo ogni 0,1 secondi, rendendolo quasi inutile per l'incisione raster. Tuttavia, esiste un ramo sperimentale con i propri compromessi. A lungo termine, si prevede di aggiungere questa funzionalit\u00e0 al klipper principale. Comandi \u00b6 M3/M4 S<value> : Imposta il duty-cycle PWM. Valori compresi tra 0 e 255. M5 : Arresta l'uscita PWM al valore di spegnimento. Configurazione Laserweb \u00b6 Se utilizzi Laserweb, una configurazione funzionante sarebbe: GCODE START: M5 ; Disabilita Laser G21 ; Set units to mm G90 ; Absolute positioning G0 Z0 F7000 ; Set Non-Cutting speed GCODE END: M5 ; Disabilita Laser G91 ; relative G0 Z+20 F4000 ; G90 ; absolute GCODE HOMING: M5 ; Disabilita Laser G28 ; Home all axis TOOL ON: M3 $INTENSITY TOOL OFF: M5 ; Disabilita Laser LASER INTENSITY: S","title":"Utilizzo dei strumenti PWM"},{"location":"Using_PWM_Tools.html#utilizzo-dei-strumenti-pwm","text":"Questo documento descrive come impostare un laser o un mandrino controllato da PWM usando output_pin e alcune macro.","title":"Utilizzo dei strumenti PWM"},{"location":"Using_PWM_Tools.html#come-funziona","text":"Riutilizzando l'output pwm della ventola della testina di stampa, \u00e8 possibile controllare laser o mandrini. Ci\u00f2 \u00e8 utile se si utilizzano testine di stampa intercambiabili, ad esempio il cambio utensile E3D o una soluzione fai-da-te. Di solito, gli strumenti cam come LaserWeb possono essere configurati per utilizzare i comandi M3-M5 , che stanno per velocit\u00e0 mandrino CW ( M3 S[0-255] ), velocit\u00e0 mandrino CCW ( M4 S[ 0-255] ) e arresto mandrino ( M5 ). Attenzione: Quando utilizzi un laser, mantieni tutte le precauzioni di sicurezza che ti vengono in mente! I laser a diodi sono generalmente invertiti. Ci\u00f2 significa che quando l'MCU si riavvia, il laser sar\u00e0 completamente acceso per il tempo necessario al riavvio dell'MCU. Per buona misura, si raccomanda di indossare sempre occhiali laser appropriati della giusta lunghezza d'onda se il laser \u00e8 alimentato e per disconnettere il laser quando non \u00e8 necessario. Inoltre, dovresti configurare un timeout di sicurezza, in modo che quando l'host o l'MCU riscontrano un errore, lo strumento si arresti. Per un esempio di configurazione, vedere config/sample-pwm-tool.cfg .","title":"Come funziona?"},{"location":"Using_PWM_Tools.html#limitazioni-attuali","text":"Esiste una limitazione della frequenza degli aggiornamenti PWM. Pur essendo molto preciso, un aggiornamento PWM pu\u00f2 verificarsi solo ogni 0,1 secondi, rendendolo quasi inutile per l'incisione raster. Tuttavia, esiste un ramo sperimentale con i propri compromessi. A lungo termine, si prevede di aggiungere questa funzionalit\u00e0 al klipper principale.","title":"Limitazioni attuali"},{"location":"Using_PWM_Tools.html#comandi","text":"M3/M4 S<value> : Imposta il duty-cycle PWM. Valori compresi tra 0 e 255. M5 : Arresta l'uscita PWM al valore di spegnimento.","title":"Comandi"},{"location":"Using_PWM_Tools.html#configurazione-laserweb","text":"Se utilizzi Laserweb, una configurazione funzionante sarebbe: GCODE START: M5 ; Disabilita Laser G21 ; Set units to mm G90 ; Absolute positioning G0 Z0 F7000 ; Set Non-Cutting speed GCODE END: M5 ; Disabilita Laser G91 ; relative G0 Z+20 F4000 ; G90 ; absolute GCODE HOMING: M5 ; Disabilita Laser G28 ; Home all axis TOOL ON: M3 $INTENSITY TOOL OFF: M5 ; Disabilita Laser LASER INTENSITY: S","title":"Configurazione Laserweb"}]}
\ No newline at end of file
+{"config":{"indexing":"full","lang":["it"],"min_search_length":3,"prebuild_index":false,"separator":"[\\s\\-]+"},"docs":[{"location":"index.html","text":"Klipper \u00e8 un firmware per stampanti 3D. Combina la potenza di un computer con uno o pi\u00f9 microntrollori. Leggi la pagina sulle funzionalit\u00e0 per avere pi\u00f9 informazioni sul perch\u00e9 usare Klipper. Per iniziare ad usare Klipper comincia con la sua installazione . Klipper \u00e8 un software libero. Leggi la documentazione o visualizza il codice Klipper su github . Dipendiamo dal generoso supporto dei nostri sponsor .","title":"Benvenuto"},{"location":"API_Server.html","text":"Server API \u00b6 Questo documento descrive l'Application Programmer Interface (API) di Klipper. Questa interfaccia consente alle applicazioni esterne di interrogare e controllare il software host Klipper. Abilitazione del socket API \u00b6 Per utilizzare il server API, il software host klippy.py deve essere avviato con il parametro -a . Per esempio: ~/klippy-env/bin/python ~/klipper/klippy/klippy.py ~/printer.cfg -a /tmp/klippy_uds -l /tmp/klippy.log Ci\u00f2 fa s\u00ec che il software host crei un socket di dominio Unix. Un client pu\u00f2 quindi aprire una connessione su quel socket e inviare comandi a Klipper. Consulta il progetto Moonraker per uno strumento popolare in grado di inoltrare richieste HTTP all'API Server Unix Domain Socket di Klipper. Formato richiesta \u00b6 I messaggi inviati e ricevuti sul socket sono stringhe codificate JSON terminate da un carattere ASCII 0x03: <json_object_1><0x03><json_object_2><0x03>... Klipper contiene uno strumento scripts/whconsole.py che pu\u00f2 eseguire il framing dei messaggi sopra. Per esempio: ~/klipper/scripts/whconsole.py /tmp/klippy_uds Questo strumento pu\u00f2 leggere una serie di comandi JSON da stdin, inviarli a Klipper e riportare i risultati. Lo strumento prevede che ogni comando JSON si trovi su una singola riga e aggiunger\u00e0 automaticamente il terminatore 0x03 durante la trasmissione di una richiesta. (Il server dell'API Klipper non ha un requisito di newline.) Protocollo API \u00b6 Il protocollo dei comandi utilizzato sul socket di comunicazione \u00e8 ispirato a json-rpc . Una richiesta potrebbe essere simile a: {\"id\": 123, \"method\": \"info\", \"params\": {}} e una risposta potrebbe essere simile a: {\"id\": 123, \"result\": {\"state_message\": \"Printer is ready\", \"klipper_path\": \"/home/pi/klipper\", \"config_file\": \"/home/pi/printer.cfg\", \"software_version\": \"v0.8.0-823-g883b1cb6\", \"hostname\": \"octopi\", \"cpu_info\": \"4 core ARMv7 Processor rev 4 (v7l)\", \"state\": \"ready\", \"python_path\": \"/home/pi/klippy-env/bin/python\", \"log_file\": \"/tmp/klippy.log\"}} Ogni richiesta deve essere un dizionario JSON. (Questo documento usa il termine Python \"dizionario\" per descrivere un \"oggetto JSON\" - una mappatura di coppie chiave/valore contenute in {} .) Il dizionario di richiesta deve contenere un parametro \"method\" che \u00e8 il nome stringa di un \"endpoint\" di Klipper disponibile. Il dizionario della richiesta pu\u00f2 contenere un parametro \"params\" che deve essere di tipo dizionario. I \"parametri\" forniscono ulteriori informazioni sui parametri all'\"endpoint\" di Klipper che gestisce la richiesta. Il suo contenuto \u00e8 specifico dell'\"endpoint\". Il dizionario delle richieste pu\u00f2 contenere un parametro \"id\" che pu\u00f2 essere di qualsiasi tipo JSON. Se \u00e8 presente \"id\", Klipper risponder\u00e0 alla richiesta con un messaggio di risposta contenente tale \"id\". Se \"id\" viene omesso (o impostato su un valore JSON \"null\"), Klipper non fornir\u00e0 alcuna risposta alla richiesta. Un messaggio di risposta \u00e8 un dizionario JSON contenente \"id\" e \"result\". Il \"risultato\" \u00e8 sempre un dizionario: i suoi contenuti sono specifici dell'\"endpoint\" che gestisce la richiesta. Se l'elaborazione di una richiesta genera un errore, il messaggio di risposta conterr\u00e0 un campo \"errore\" anzich\u00e9 un campo \"risultato\". Ad esempio, la richiesta: {\"id\": 123, \"method\": \"gcode/script\", \"params\": {\"script\": \"G1 X200\"}} potrebbe generare una risposta di errore come: {\"id\": 123, \"error\": {\"message\": \"Deve prima posizionare l'asse: 200.000 0.000 0.000 [0.000]\", \"error\": \"WebRequestError\"}} Klipper inizier\u00e0 sempre a elaborare le richieste nell'ordine in cui sono state ricevute. Tuttavia, alcune richieste potrebbero non essere completate immediatamente, il che potrebbe causare l'invio di una risposta associata non conforme rispetto alle risposte di altre richieste. Una richiesta JSON non sospender\u00e0 mai l'elaborazione di future richieste JSON. Sottoscrizioni \u00b6 Alcune richieste di \"endpoint\" di Klipper consentono di \"iscriversi\" a futuri messaggi di aggiornamento asincrono. Per esempio: {\"id\": 123, \"method\": \"gcode/subscribe_output\", \"params\": {\"response_template\":{\"key\": 345}}} inizialmente pu\u00f2 rispondere con: {\"id\": 123, \"result\": {}} e fare in modo che Klipper invii messaggi futuri simili a: {\"params\": {\"response\": \"ok B:22.8 /0.0 T0:22.4 /0.0\"}, \"key\": 345} Una richiesta di sottoscrizione accetta un dizionario \"response_template\" nel campo \"params\" della richiesta. Quel dizionario \"response_template\" viene utilizzato come modello per futuri messaggi asincroni: pu\u00f2 contenere coppie chiave/valore arbitrarie. Quando invier\u00e0 questi futuri messaggi asincroni, Klipper aggiunger\u00e0 un campo \"params\" contenente un dizionario con contenuti specifici per \"endpoint\" al modello di risposta e quindi invier\u00e0 quel modello. Se non viene fornito un campo \"response_template\", il valore predefinito \u00e8 un dizionario vuoto ( {} ). \"endpoint\" disponibili \u00b6 Per convenzione, gli \"endpoint\" di Klipper sono nella forma <module_name>/<some_name> . Quando si effettua una richiesta a un \"endpoint\", il nome completo deve essere impostato nel parametro \"method\" del dizionario di richiesta (ad esempio, {\"method\"=\"gcode/restart\"} ). info \u00b6 L'endpoint \"info\" viene utilizzato per ottenere informazioni sul sistema e sulla versione da Klipper. Viene anche utilizzato per fornire a Klipper le informazioni sulla versione del client. Ad esempio: {\"id\": 123, \"method\": \"info\", \"params\": { \"client_info\": { \"version\": \"v1\"}}} Se presente, il parametro \"client_info\" deve essere un dizionario, ma quel dizionario potrebbe avere contenuti arbitrari. I clienti sono incoraggiati a fornire il nome del client e la sua versione del software quando si connettono per la prima volta al server dell'API Klipper. emergency_stop \u00b6 L'endpoint \"emergency_stop\" viene utilizzato per indicare a Klipper di passare allo stato di \"spegnimento\". Si comporta in modo simile al comando G-Code M112 . Ad esempio: {\"id\": 123, \"method\": \"emergency_stop\"} register_remote_method \u00b6 Questo endpoint consente ai client di registrare metodi che possono essere chiamati da klipper. Restituir\u00e0 un oggetto vuoto in caso di successo. Per esempio: {\"id\": 123, \"method\": \"register_remote_method\", \"params\": {\"response_template\": {\"action\": \"run_paneldue_beep\"}, \"remote_method\": \"paneldue_beep\"}} will return: {\"id\": 123, \"result\": {}} Il metodo remoto paneldue_beep ora pu\u00f2 essere chiamato da Klipper. Nota che se il metodo accetta parametri, dovrebbero essere forniti come argomenti di parole chiave. Di seguito \u00e8 riportato un esempio di come pu\u00f2 essere chiamato da una gcode_macro: [gcode_macro PANELDUE_BEEP] gcode: {action_call_remote_method(\"paneldue_beep\", frequency=300, duration=1.0)} Quando viene eseguita la macro gcode PANELDUE_BEEP, Klipper invia qualcosa di simile al seguente tramite il socket: {\"action\": \"run_paneldue_beep\", \"params\": {\"frequency\": 300, \"duration\": 1.0}} oggetti/elenco \u00b6 Questo endpoint interroga l'elenco degli \"oggetti\" della stampante disponibili che \u00e8 possibile interrogare (tramite l'endpoint \"objects/query\"). Ad esempio: {\"id\": 123, \"method\": \"objects/list\"} potrebbe restituire: {\"id\": 123, \"result\": {\"objects\": [\"webhooks\", \"configfile\" , \"heaters\", \"gcode_move\", \"query_endstops\", \"idle_timeout\", \"toolhead\", \"extruder\"]}} oggetti/interrogazione \u00b6 Questo endpoint consente di interrogare informazioni da oggetti. Ad esempio: {\"id\": 123, \"method\": \"objects/query\", \"params\": {\"objects\": {\"toolhead\": [\"position\"], \"webhooks\": null}}} potrebbe restituire: {\"id\": 123, \"result\": {\"status\": {\"webhooks\": {\"state\": \"ready\", \"state_message\": \"Printer is ready\"}, \"toolhead\": { \"position\": [0.0, 0.0, 0.0, 0.0]}}, \"eventtime\": 3051555.377933684}} Il parametro \"objects\" nella richiesta deve essere un dizionario contenente gli oggetti stampante che devono essere interrogati - la chiave contiene il nome dell'oggetto stampante e il valore \u00e8 \"null\" (per interrogare tutti i campi) o un elenco di nomi di campo. Il messaggio di risposta conterr\u00e0 un campo \"status\" contenente un dizionario con le informazioni richieste: la chiave contiene il nome dell'oggetto stampante e il valore \u00e8 un dizionario contenente i suoi campi. Il messaggio di risposta conterr\u00e0 anche un campo \"eventtime\" contenente il timestamp da quando \u00e8 stata eseguita la query. I campi disponibili sono documentati nel documento Status Reference . oggetti/subscribe \u00b6 Questo endpoint consente di eseguire query e quindi iscriversi alle informazioni dagli oggetti stampante. La richiesta e la risposta dell'endpoint sono identiche all'endpoint \"objects/query\". Ad esempio: {\"id\": 123, \"method\": \"objects/subscribe\", \"params\": {\"objects\":{\"toolhead\": [\"position\"], \"webhooks\": [\"state\"] }, \"response_template\":{}}} potrebbe restituire: {\"id\": 123, \"result\": {\"status\": {\"webhooks\": {\"state\": \"ready\"}, \"toolhead\": {\"position\": [0.0, 0.0, 0.0, 0.0]}}, \"eventtime\": 3052153.382083195}} e generare messaggi asincroni successivi come: {\"params\": {\"status\": {\"webhooks\": {\"state\": \"shutdown\"}}, \"eventtime\": 3052165.418815847}} gcode/help \u00b6 Questo endpoint consente di interrogare i comandi G-Code disponibili che hanno una stringa di aiuto definita. Ad esempio: {\"id\": 123, \"method\": \"gcode/help\"} potrebbe restituire: {\"id\": 123, \"result\": {\"RESTORE_GCODE_STATE\": \"Restore a previously saved G-Code state\", \"PID_CALIBRATE\": \"Run PID calibration test\", \"QUERY_ADC\": \"Report the last value of an analog pin\", ...}} gcode/script \u00b6 Questo endpoint consente di eseguire una serie di comandi G-Code. Ad esempio: {\"id\": 123, \"method\": \"gcode/script\", \"params\": {\"script\": \"G90\"}} Se lo script G-Code fornito genera un errore, allora viene generata una risposta di errore. Tuttavia, se il comando G-Code produce un output del terminale, tale output del terminale non viene fornito nella risposta. (Utilizzare l'endpoint \"gcode/subscribe_output\" per ottenere l'output del terminale G-Code.) Se c'\u00e8 un comando G-Code in elaborazione quando viene ricevuta questa richiesta, lo script fornito verr\u00e0 messo in coda. Questo ritardo potrebbe essere significativo (ad esempio, se \u00e8 in esecuzione un comando di attesa del codice G per la temperatura). Il messaggio di risposta JSON viene inviato al completamento dell'elaborazione dello script. gcode/restart \u00b6 Questo endpoint consente di richiedere un riavvio: \u00e8 simile all'esecuzione del comando \"RESTART\" del codice G. Ad esempio: {\"id\": 123, \"method\": \"gcode/restart\"} Come con l'endpoint \"gcode/script\", questo endpoint viene completato solo dopo il completamento di tutti i comandi G-Code in sospeso. gcode/firmware_restart \u00b6 Questo \u00e8 simile all'endpoint \"gcode/restart\": implementa il comando G-Code \"FIRMWARE_RESTART\". Ad esempio: {\"id\": 123, \"method\": \"gcode/firmware_restart\"} Come con l'endpoint \"gcode/script\", questo endpoint viene completato solo dopo il completamento di tutti i comandi G-Code in sospeso. gcode/subscribe_output \u00b6 Questo endpoint viene utilizzato per iscriversi ai messaggi del terminale G-Code generati da Klipper. Ad esempio: {\"id\": 123, \"method\": \"gcode/subscribe_output\", \"params\": {\"response_template\":{}}} potrebbe in seguito produrre messaggi asincroni come: {\"params\": { \"response\": \"// Klipper state: Shutdown\"}} Questo endpoint ha lo scopo di supportare l'interazione umana tramite un'interfaccia \"finestra di terminale\". L'analisi del contenuto dall'output del terminale G-Code \u00e8 sconsigliata. Usa l'endpoint \"objects/subscribe\" per ottenere aggiornamenti sullo stato di Klipper. motion_report/dump_stepper \u00b6 Questo endpoint viene utilizzato per iscriversi al flusso di comandi queue_step interno di Klipper per uno stepper. L'ottenimento di questi aggiornamenti di movimento di basso livello pu\u00f2 essere utile per scopi diagnostici e di debug. L'utilizzo di questo endpoint pu\u00f2 aumentare il carico di sistema di Klipper. Una richiesta pu\u00f2 essere simile a: {\"id\": 123, \"method\":\"motion_report/dump_stepper\", \"params\": {\"name\": \"stepper_x\", \"response_template\": {}}} e potrebbe restituire: {\"id\": 123, \"result\": {\"header\": [\"interval\", \"count\", \"add\"]}} e potrebbe in seguito produrre messaggi asincroni come: {\"params\": {\" first_clock\": 179601081, \"first_time\": 8.98, \"first_position\": 0, \"last_clock\": 219686097, \"last_time\": 10.984, \"data\": [[179601081, 1, 0], [29573, 2, -8685] , [16230, 4, -1525], [10559, 6, -160], [10000, 976, 0], [10000, 1000, 0], [10000, 1000, 0], [10000, 1000, 0] , [9855, 5, 187], [11632, 4, 1534], [20756, 2, 9442]]}} Il campo \"intestazione\" nella risposta alla query iniziale viene utilizzato per descrivere i campi trovati nelle risposte \"dati\" successive. motion_report/dump_trapq \u00b6 Questo endpoint viene utilizzato per iscriversi alla \"coda di movimento trapezoidale\" interna di Klipper. L'ottenimento di questi aggiornamenti di movimento di basso livello pu\u00f2 essere utile per scopi diagnostici e di debug. L'utilizzo di questo endpoint pu\u00f2 aumentare il carico di sistema di Klipper. Una richiesta pu\u00f2 essere simile a: {\"id\": 123, \"method\": \"motion_report/dump_trapq\", \"params\": {\"name\": \"toolhead\", \"response_template\":{}}} e potrebbe restituire: {\"id\": 1, \"result\": {\"header\": [\"time\", \"duration\", \"start_velocity\", \"acceleration\", \"start_position\", \"direction\"]}} e potrebbero in seguito produrre messaggi asincroni quali: {\"params\": {\"data\": [[4.05, 1.0, 0.0, 0.0, [300.0, 0.0, 0.0], [0.0, 0.0, 0.0]], [5.054, 0.001, 0.0, 3000.0 , [300.0, 0.0, 0.0], [-1.0, 0.0, 0.0]]]}} Il campo \"intestazione\" nella risposta alla query iniziale viene utilizzato per descrivere i campi trovati nelle risposte \"dati\" successive. adxl345/dump_adxl345 \u00b6 Questo endpoint viene utilizzato per la sottoscrizione ai dati dell'accelerometro ADXL345. L'ottenimento di questi aggiornamenti di movimento di basso livello pu\u00f2 essere utile per scopi diagnostici e di debug. L'utilizzo di questo endpoint pu\u00f2 aumentare il carico di sistema di Klipper. Una richiesta pu\u00f2 essere simile a: {\"id\": 123, \"method\":\"adxl345/dump_adxl345\", \"params\": {\"sensor\": \"adxl345\", \"response_template\": {}}} e potrebbe restituire: {\"id\": 123,\"result\":{\"header\":[\"time\",\"x_acceleration\",\"y_acceleration\", \"z_acceleration\"]}} e potrebbe in seguito produrre messaggi asincroni come: {\"params \":{\"overflow\":0,\"data\":[[3292.432935,-535.44309,-1529.8374,9561.4], [3292.433256,-382.45935,-1606.32927,9561.48375]]}} Il campo \"intestazione\" nella risposta alla query iniziale viene utilizzato per descrivere i campi trovati nelle risposte \"dati\" successive. angle/dump_angle \u00b6 Questo endpoint viene utilizzato per iscriversi a dati del sensore angolare . L'ottenimento di questi aggiornamenti di movimento di basso livello pu\u00f2 essere utile per scopi diagnostici e di debug. L'utilizzo di questo endpoint pu\u00f2 aumentare il carico di sistema di Klipper. Una richiesta pu\u00f2 essere simile a: {\"id\": 123, \"method\":\"angle/dump_angle\", \"params\": {\"sensor\": \"my_angle_sensor\", \"response_template\": {}}} e potrebbe restituire: {\"id\": 123,\"result\":{\"header\":[\"time\",\"angle\"]}} e potrebbe in seguito produrre messaggi asincroni come: {\"params\":{\"position_offset\":3.151562 ,\"errori\":0, \"dati\":[[1290.951905,-5063],[1290.952321,-5065]]}} Il campo \"intestazione\" nella risposta alla query iniziale viene utilizzato per descrivere i campi trovati nelle risposte \"dati\" successive. pause_resume/cancel \u00b6 Questo endpoint \u00e8 simile all'esecuzione del comando G-Code \"PRINT_CANCEL\". Ad esempio: {\"id\": 123, \"method\": \"pause_resume/cancel\"} Come con l'endpoint \"gcode/script\", questo endpoint viene completato solo dopo il completamento di tutti i comandi G-Code in sospeso. pause_resume/pause \u00b6 Questo endpoint \u00e8 simile all'esecuzione del comando G-Code \"PAUSE\". Ad esempio: {\"id\": 123, \"method\": \"pause_resume/pause\"} Come con l'endpoint \"gcode/script\", questo endpoint viene completato solo dopo il completamento di tutti i comandi G-Code in sospeso. pause_resume/resume \u00b6 Questo endpoint \u00e8 simile all'esecuzione del comando G-Code \"RESUME\". Ad esempio: {\"id\": 123, \"method\": \"pause_resume/resume\"} Come con l'endpoint \"gcode/script\", questo endpoint viene completato solo dopo il completamento di tutti i comandi G-Code in sospeso. query_endstops/status \u00b6 Questo endpoint eseguir\u00e0 una query sugli endpoint attivi e restituir\u00e0 il loro stato. Ad esempio: {\"id\": 123, \"method\": \"query_endstops/status\"} potrebbe restituire: {\"id\": 123, \"result\": {\"y\": \"open\", \"x\": \"aperto\", \"z\": \"TRIGGERED\"}} Come con l'endpoint \"gcode/script\", questo endpoint viene completato solo dopo il completamento di tutti i comandi G-Code in sospeso.","title":"Server API"},{"location":"API_Server.html#server-api","text":"Questo documento descrive l'Application Programmer Interface (API) di Klipper. Questa interfaccia consente alle applicazioni esterne di interrogare e controllare il software host Klipper.","title":"Server API"},{"location":"API_Server.html#abilitazione-del-socket-api","text":"Per utilizzare il server API, il software host klippy.py deve essere avviato con il parametro -a . Per esempio: ~/klippy-env/bin/python ~/klipper/klippy/klippy.py ~/printer.cfg -a /tmp/klippy_uds -l /tmp/klippy.log Ci\u00f2 fa s\u00ec che il software host crei un socket di dominio Unix. Un client pu\u00f2 quindi aprire una connessione su quel socket e inviare comandi a Klipper. Consulta il progetto Moonraker per uno strumento popolare in grado di inoltrare richieste HTTP all'API Server Unix Domain Socket di Klipper.","title":"Abilitazione del socket API"},{"location":"API_Server.html#formato-richiesta","text":"I messaggi inviati e ricevuti sul socket sono stringhe codificate JSON terminate da un carattere ASCII 0x03: <json_object_1><0x03><json_object_2><0x03>... Klipper contiene uno strumento scripts/whconsole.py che pu\u00f2 eseguire il framing dei messaggi sopra. Per esempio: ~/klipper/scripts/whconsole.py /tmp/klippy_uds Questo strumento pu\u00f2 leggere una serie di comandi JSON da stdin, inviarli a Klipper e riportare i risultati. Lo strumento prevede che ogni comando JSON si trovi su una singola riga e aggiunger\u00e0 automaticamente il terminatore 0x03 durante la trasmissione di una richiesta. (Il server dell'API Klipper non ha un requisito di newline.)","title":"Formato richiesta"},{"location":"API_Server.html#protocollo-api","text":"Il protocollo dei comandi utilizzato sul socket di comunicazione \u00e8 ispirato a json-rpc . Una richiesta potrebbe essere simile a: {\"id\": 123, \"method\": \"info\", \"params\": {}} e una risposta potrebbe essere simile a: {\"id\": 123, \"result\": {\"state_message\": \"Printer is ready\", \"klipper_path\": \"/home/pi/klipper\", \"config_file\": \"/home/pi/printer.cfg\", \"software_version\": \"v0.8.0-823-g883b1cb6\", \"hostname\": \"octopi\", \"cpu_info\": \"4 core ARMv7 Processor rev 4 (v7l)\", \"state\": \"ready\", \"python_path\": \"/home/pi/klippy-env/bin/python\", \"log_file\": \"/tmp/klippy.log\"}} Ogni richiesta deve essere un dizionario JSON. (Questo documento usa il termine Python \"dizionario\" per descrivere un \"oggetto JSON\" - una mappatura di coppie chiave/valore contenute in {} .) Il dizionario di richiesta deve contenere un parametro \"method\" che \u00e8 il nome stringa di un \"endpoint\" di Klipper disponibile. Il dizionario della richiesta pu\u00f2 contenere un parametro \"params\" che deve essere di tipo dizionario. I \"parametri\" forniscono ulteriori informazioni sui parametri all'\"endpoint\" di Klipper che gestisce la richiesta. Il suo contenuto \u00e8 specifico dell'\"endpoint\". Il dizionario delle richieste pu\u00f2 contenere un parametro \"id\" che pu\u00f2 essere di qualsiasi tipo JSON. Se \u00e8 presente \"id\", Klipper risponder\u00e0 alla richiesta con un messaggio di risposta contenente tale \"id\". Se \"id\" viene omesso (o impostato su un valore JSON \"null\"), Klipper non fornir\u00e0 alcuna risposta alla richiesta. Un messaggio di risposta \u00e8 un dizionario JSON contenente \"id\" e \"result\". Il \"risultato\" \u00e8 sempre un dizionario: i suoi contenuti sono specifici dell'\"endpoint\" che gestisce la richiesta. Se l'elaborazione di una richiesta genera un errore, il messaggio di risposta conterr\u00e0 un campo \"errore\" anzich\u00e9 un campo \"risultato\". Ad esempio, la richiesta: {\"id\": 123, \"method\": \"gcode/script\", \"params\": {\"script\": \"G1 X200\"}} potrebbe generare una risposta di errore come: {\"id\": 123, \"error\": {\"message\": \"Deve prima posizionare l'asse: 200.000 0.000 0.000 [0.000]\", \"error\": \"WebRequestError\"}} Klipper inizier\u00e0 sempre a elaborare le richieste nell'ordine in cui sono state ricevute. Tuttavia, alcune richieste potrebbero non essere completate immediatamente, il che potrebbe causare l'invio di una risposta associata non conforme rispetto alle risposte di altre richieste. Una richiesta JSON non sospender\u00e0 mai l'elaborazione di future richieste JSON.","title":"Protocollo API"},{"location":"API_Server.html#sottoscrizioni","text":"Alcune richieste di \"endpoint\" di Klipper consentono di \"iscriversi\" a futuri messaggi di aggiornamento asincrono. Per esempio: {\"id\": 123, \"method\": \"gcode/subscribe_output\", \"params\": {\"response_template\":{\"key\": 345}}} inizialmente pu\u00f2 rispondere con: {\"id\": 123, \"result\": {}} e fare in modo che Klipper invii messaggi futuri simili a: {\"params\": {\"response\": \"ok B:22.8 /0.0 T0:22.4 /0.0\"}, \"key\": 345} Una richiesta di sottoscrizione accetta un dizionario \"response_template\" nel campo \"params\" della richiesta. Quel dizionario \"response_template\" viene utilizzato come modello per futuri messaggi asincroni: pu\u00f2 contenere coppie chiave/valore arbitrarie. Quando invier\u00e0 questi futuri messaggi asincroni, Klipper aggiunger\u00e0 un campo \"params\" contenente un dizionario con contenuti specifici per \"endpoint\" al modello di risposta e quindi invier\u00e0 quel modello. Se non viene fornito un campo \"response_template\", il valore predefinito \u00e8 un dizionario vuoto ( {} ).","title":"Sottoscrizioni"},{"location":"API_Server.html#endpoint-disponibili","text":"Per convenzione, gli \"endpoint\" di Klipper sono nella forma <module_name>/<some_name> . Quando si effettua una richiesta a un \"endpoint\", il nome completo deve essere impostato nel parametro \"method\" del dizionario di richiesta (ad esempio, {\"method\"=\"gcode/restart\"} ).","title":"\"endpoint\" disponibili"},{"location":"API_Server.html#info","text":"L'endpoint \"info\" viene utilizzato per ottenere informazioni sul sistema e sulla versione da Klipper. Viene anche utilizzato per fornire a Klipper le informazioni sulla versione del client. Ad esempio: {\"id\": 123, \"method\": \"info\", \"params\": { \"client_info\": { \"version\": \"v1\"}}} Se presente, il parametro \"client_info\" deve essere un dizionario, ma quel dizionario potrebbe avere contenuti arbitrari. I clienti sono incoraggiati a fornire il nome del client e la sua versione del software quando si connettono per la prima volta al server dell'API Klipper.","title":"info"},{"location":"API_Server.html#emergency_stop","text":"L'endpoint \"emergency_stop\" viene utilizzato per indicare a Klipper di passare allo stato di \"spegnimento\". Si comporta in modo simile al comando G-Code M112 . Ad esempio: {\"id\": 123, \"method\": \"emergency_stop\"}","title":"emergency_stop"},{"location":"API_Server.html#register_remote_method","text":"Questo endpoint consente ai client di registrare metodi che possono essere chiamati da klipper. Restituir\u00e0 un oggetto vuoto in caso di successo. Per esempio: {\"id\": 123, \"method\": \"register_remote_method\", \"params\": {\"response_template\": {\"action\": \"run_paneldue_beep\"}, \"remote_method\": \"paneldue_beep\"}} will return: {\"id\": 123, \"result\": {}} Il metodo remoto paneldue_beep ora pu\u00f2 essere chiamato da Klipper. Nota che se il metodo accetta parametri, dovrebbero essere forniti come argomenti di parole chiave. Di seguito \u00e8 riportato un esempio di come pu\u00f2 essere chiamato da una gcode_macro: [gcode_macro PANELDUE_BEEP] gcode: {action_call_remote_method(\"paneldue_beep\", frequency=300, duration=1.0)} Quando viene eseguita la macro gcode PANELDUE_BEEP, Klipper invia qualcosa di simile al seguente tramite il socket: {\"action\": \"run_paneldue_beep\", \"params\": {\"frequency\": 300, \"duration\": 1.0}}","title":"register_remote_method"},{"location":"API_Server.html#oggettielenco","text":"Questo endpoint interroga l'elenco degli \"oggetti\" della stampante disponibili che \u00e8 possibile interrogare (tramite l'endpoint \"objects/query\"). Ad esempio: {\"id\": 123, \"method\": \"objects/list\"} potrebbe restituire: {\"id\": 123, \"result\": {\"objects\": [\"webhooks\", \"configfile\" , \"heaters\", \"gcode_move\", \"query_endstops\", \"idle_timeout\", \"toolhead\", \"extruder\"]}}","title":"oggetti/elenco"},{"location":"API_Server.html#oggettiinterrogazione","text":"Questo endpoint consente di interrogare informazioni da oggetti. Ad esempio: {\"id\": 123, \"method\": \"objects/query\", \"params\": {\"objects\": {\"toolhead\": [\"position\"], \"webhooks\": null}}} potrebbe restituire: {\"id\": 123, \"result\": {\"status\": {\"webhooks\": {\"state\": \"ready\", \"state_message\": \"Printer is ready\"}, \"toolhead\": { \"position\": [0.0, 0.0, 0.0, 0.0]}}, \"eventtime\": 3051555.377933684}} Il parametro \"objects\" nella richiesta deve essere un dizionario contenente gli oggetti stampante che devono essere interrogati - la chiave contiene il nome dell'oggetto stampante e il valore \u00e8 \"null\" (per interrogare tutti i campi) o un elenco di nomi di campo. Il messaggio di risposta conterr\u00e0 un campo \"status\" contenente un dizionario con le informazioni richieste: la chiave contiene il nome dell'oggetto stampante e il valore \u00e8 un dizionario contenente i suoi campi. Il messaggio di risposta conterr\u00e0 anche un campo \"eventtime\" contenente il timestamp da quando \u00e8 stata eseguita la query. I campi disponibili sono documentati nel documento Status Reference .","title":"oggetti/interrogazione"},{"location":"API_Server.html#oggettisubscribe","text":"Questo endpoint consente di eseguire query e quindi iscriversi alle informazioni dagli oggetti stampante. La richiesta e la risposta dell'endpoint sono identiche all'endpoint \"objects/query\". Ad esempio: {\"id\": 123, \"method\": \"objects/subscribe\", \"params\": {\"objects\":{\"toolhead\": [\"position\"], \"webhooks\": [\"state\"] }, \"response_template\":{}}} potrebbe restituire: {\"id\": 123, \"result\": {\"status\": {\"webhooks\": {\"state\": \"ready\"}, \"toolhead\": {\"position\": [0.0, 0.0, 0.0, 0.0]}}, \"eventtime\": 3052153.382083195}} e generare messaggi asincroni successivi come: {\"params\": {\"status\": {\"webhooks\": {\"state\": \"shutdown\"}}, \"eventtime\": 3052165.418815847}}","title":"oggetti/subscribe"},{"location":"API_Server.html#gcodehelp","text":"Questo endpoint consente di interrogare i comandi G-Code disponibili che hanno una stringa di aiuto definita. Ad esempio: {\"id\": 123, \"method\": \"gcode/help\"} potrebbe restituire: {\"id\": 123, \"result\": {\"RESTORE_GCODE_STATE\": \"Restore a previously saved G-Code state\", \"PID_CALIBRATE\": \"Run PID calibration test\", \"QUERY_ADC\": \"Report the last value of an analog pin\", ...}}","title":"gcode/help"},{"location":"API_Server.html#gcodescript","text":"Questo endpoint consente di eseguire una serie di comandi G-Code. Ad esempio: {\"id\": 123, \"method\": \"gcode/script\", \"params\": {\"script\": \"G90\"}} Se lo script G-Code fornito genera un errore, allora viene generata una risposta di errore. Tuttavia, se il comando G-Code produce un output del terminale, tale output del terminale non viene fornito nella risposta. (Utilizzare l'endpoint \"gcode/subscribe_output\" per ottenere l'output del terminale G-Code.) Se c'\u00e8 un comando G-Code in elaborazione quando viene ricevuta questa richiesta, lo script fornito verr\u00e0 messo in coda. Questo ritardo potrebbe essere significativo (ad esempio, se \u00e8 in esecuzione un comando di attesa del codice G per la temperatura). Il messaggio di risposta JSON viene inviato al completamento dell'elaborazione dello script.","title":"gcode/script"},{"location":"API_Server.html#gcoderestart","text":"Questo endpoint consente di richiedere un riavvio: \u00e8 simile all'esecuzione del comando \"RESTART\" del codice G. Ad esempio: {\"id\": 123, \"method\": \"gcode/restart\"} Come con l'endpoint \"gcode/script\", questo endpoint viene completato solo dopo il completamento di tutti i comandi G-Code in sospeso.","title":"gcode/restart"},{"location":"API_Server.html#gcodefirmware_restart","text":"Questo \u00e8 simile all'endpoint \"gcode/restart\": implementa il comando G-Code \"FIRMWARE_RESTART\". Ad esempio: {\"id\": 123, \"method\": \"gcode/firmware_restart\"} Come con l'endpoint \"gcode/script\", questo endpoint viene completato solo dopo il completamento di tutti i comandi G-Code in sospeso.","title":"gcode/firmware_restart"},{"location":"API_Server.html#gcodesubscribe_output","text":"Questo endpoint viene utilizzato per iscriversi ai messaggi del terminale G-Code generati da Klipper. Ad esempio: {\"id\": 123, \"method\": \"gcode/subscribe_output\", \"params\": {\"response_template\":{}}} potrebbe in seguito produrre messaggi asincroni come: {\"params\": { \"response\": \"// Klipper state: Shutdown\"}} Questo endpoint ha lo scopo di supportare l'interazione umana tramite un'interfaccia \"finestra di terminale\". L'analisi del contenuto dall'output del terminale G-Code \u00e8 sconsigliata. Usa l'endpoint \"objects/subscribe\" per ottenere aggiornamenti sullo stato di Klipper.","title":"gcode/subscribe_output"},{"location":"API_Server.html#motion_reportdump_stepper","text":"Questo endpoint viene utilizzato per iscriversi al flusso di comandi queue_step interno di Klipper per uno stepper. L'ottenimento di questi aggiornamenti di movimento di basso livello pu\u00f2 essere utile per scopi diagnostici e di debug. L'utilizzo di questo endpoint pu\u00f2 aumentare il carico di sistema di Klipper. Una richiesta pu\u00f2 essere simile a: {\"id\": 123, \"method\":\"motion_report/dump_stepper\", \"params\": {\"name\": \"stepper_x\", \"response_template\": {}}} e potrebbe restituire: {\"id\": 123, \"result\": {\"header\": [\"interval\", \"count\", \"add\"]}} e potrebbe in seguito produrre messaggi asincroni come: {\"params\": {\" first_clock\": 179601081, \"first_time\": 8.98, \"first_position\": 0, \"last_clock\": 219686097, \"last_time\": 10.984, \"data\": [[179601081, 1, 0], [29573, 2, -8685] , [16230, 4, -1525], [10559, 6, -160], [10000, 976, 0], [10000, 1000, 0], [10000, 1000, 0], [10000, 1000, 0] , [9855, 5, 187], [11632, 4, 1534], [20756, 2, 9442]]}} Il campo \"intestazione\" nella risposta alla query iniziale viene utilizzato per descrivere i campi trovati nelle risposte \"dati\" successive.","title":"motion_report/dump_stepper"},{"location":"API_Server.html#motion_reportdump_trapq","text":"Questo endpoint viene utilizzato per iscriversi alla \"coda di movimento trapezoidale\" interna di Klipper. L'ottenimento di questi aggiornamenti di movimento di basso livello pu\u00f2 essere utile per scopi diagnostici e di debug. L'utilizzo di questo endpoint pu\u00f2 aumentare il carico di sistema di Klipper. Una richiesta pu\u00f2 essere simile a: {\"id\": 123, \"method\": \"motion_report/dump_trapq\", \"params\": {\"name\": \"toolhead\", \"response_template\":{}}} e potrebbe restituire: {\"id\": 1, \"result\": {\"header\": [\"time\", \"duration\", \"start_velocity\", \"acceleration\", \"start_position\", \"direction\"]}} e potrebbero in seguito produrre messaggi asincroni quali: {\"params\": {\"data\": [[4.05, 1.0, 0.0, 0.0, [300.0, 0.0, 0.0], [0.0, 0.0, 0.0]], [5.054, 0.001, 0.0, 3000.0 , [300.0, 0.0, 0.0], [-1.0, 0.0, 0.0]]]}} Il campo \"intestazione\" nella risposta alla query iniziale viene utilizzato per descrivere i campi trovati nelle risposte \"dati\" successive.","title":"motion_report/dump_trapq"},{"location":"API_Server.html#adxl345dump_adxl345","text":"Questo endpoint viene utilizzato per la sottoscrizione ai dati dell'accelerometro ADXL345. L'ottenimento di questi aggiornamenti di movimento di basso livello pu\u00f2 essere utile per scopi diagnostici e di debug. L'utilizzo di questo endpoint pu\u00f2 aumentare il carico di sistema di Klipper. Una richiesta pu\u00f2 essere simile a: {\"id\": 123, \"method\":\"adxl345/dump_adxl345\", \"params\": {\"sensor\": \"adxl345\", \"response_template\": {}}} e potrebbe restituire: {\"id\": 123,\"result\":{\"header\":[\"time\",\"x_acceleration\",\"y_acceleration\", \"z_acceleration\"]}} e potrebbe in seguito produrre messaggi asincroni come: {\"params \":{\"overflow\":0,\"data\":[[3292.432935,-535.44309,-1529.8374,9561.4], [3292.433256,-382.45935,-1606.32927,9561.48375]]}} Il campo \"intestazione\" nella risposta alla query iniziale viene utilizzato per descrivere i campi trovati nelle risposte \"dati\" successive.","title":"adxl345/dump_adxl345"},{"location":"API_Server.html#angledump_angle","text":"Questo endpoint viene utilizzato per iscriversi a dati del sensore angolare . L'ottenimento di questi aggiornamenti di movimento di basso livello pu\u00f2 essere utile per scopi diagnostici e di debug. L'utilizzo di questo endpoint pu\u00f2 aumentare il carico di sistema di Klipper. Una richiesta pu\u00f2 essere simile a: {\"id\": 123, \"method\":\"angle/dump_angle\", \"params\": {\"sensor\": \"my_angle_sensor\", \"response_template\": {}}} e potrebbe restituire: {\"id\": 123,\"result\":{\"header\":[\"time\",\"angle\"]}} e potrebbe in seguito produrre messaggi asincroni come: {\"params\":{\"position_offset\":3.151562 ,\"errori\":0, \"dati\":[[1290.951905,-5063],[1290.952321,-5065]]}} Il campo \"intestazione\" nella risposta alla query iniziale viene utilizzato per descrivere i campi trovati nelle risposte \"dati\" successive.","title":"angle/dump_angle"},{"location":"API_Server.html#pause_resumecancel","text":"Questo endpoint \u00e8 simile all'esecuzione del comando G-Code \"PRINT_CANCEL\". Ad esempio: {\"id\": 123, \"method\": \"pause_resume/cancel\"} Come con l'endpoint \"gcode/script\", questo endpoint viene completato solo dopo il completamento di tutti i comandi G-Code in sospeso.","title":"pause_resume/cancel"},{"location":"API_Server.html#pause_resumepause","text":"Questo endpoint \u00e8 simile all'esecuzione del comando G-Code \"PAUSE\". Ad esempio: {\"id\": 123, \"method\": \"pause_resume/pause\"} Come con l'endpoint \"gcode/script\", questo endpoint viene completato solo dopo il completamento di tutti i comandi G-Code in sospeso.","title":"pause_resume/pause"},{"location":"API_Server.html#pause_resumeresume","text":"Questo endpoint \u00e8 simile all'esecuzione del comando G-Code \"RESUME\". Ad esempio: {\"id\": 123, \"method\": \"pause_resume/resume\"} Come con l'endpoint \"gcode/script\", questo endpoint viene completato solo dopo il completamento di tutti i comandi G-Code in sospeso.","title":"pause_resume/resume"},{"location":"API_Server.html#query_endstopsstatus","text":"Questo endpoint eseguir\u00e0 una query sugli endpoint attivi e restituir\u00e0 il loro stato. Ad esempio: {\"id\": 123, \"method\": \"query_endstops/status\"} potrebbe restituire: {\"id\": 123, \"result\": {\"y\": \"open\", \"x\": \"aperto\", \"z\": \"TRIGGERED\"}} Come con l'endpoint \"gcode/script\", questo endpoint viene completato solo dopo il completamento di tutti i comandi G-Code in sospeso.","title":"query_endstops/status"},{"location":"BLTouch.html","text":"BL-Touch \u00b6 Collegare BL-Touch \u00b6 Attenzione warning prima di cominciare : Evita di toccare la punta del BL-Touch a mani nude, \u00e8 molto sensibili al sebo delle dita. Se sei costretto usa dei guanti ed evita di spingerla o piegarla. Collega il connettore \"servo\" BL-Touch a un control_pin secondo la documentazione BL-Touch o la documentazione MCU. Usando il cablaggio originale, il filo giallo del triplo \u00e8 il control_pin e il filo bianco della coppia \u00e8 il sensor_pin . \u00c8 necessario configurare questi pin in base al cablaggio. La maggior parte dei dispositivi BL-Touch richiede un pullup sul pin del sensore (prefissare il nome del pin con \"^\"). Per esempio: [bltouch] sensor_pin: ^P1.24 control_pin: P1.26 Se il BL-Touch verr\u00e0 utilizzato per l'home dell'asse Z, impostare endstop_pin: probe:z_virtual_endstop e rimuovere position_endstop nella sezione di configurazione [stepper_z] , quindi aggiungere una sezione di configurazione [safe_z_home] per aumentare il asse z, posiziona gli assi xy, spostati al centro del letto e posizionati sull'asse z. Per esempio: [safe_z_home] home_xy_position: 100, 100 # Cambiare le coordinate per il centro del tuo piatto speed: 50 z_hop: 10 # Move up 10mm z_hop_speed: 5 \u00c8 importante che il movimento z_hop in safe_z_home sia sufficientemente alto in mode che la sonda non colpisca nulla anche se il pin della sonda si trova nel suo stato pi\u00f9 basso. Test iniziali \u00b6 Prima di proseguire, verificare che il BL-Touch sia montato all'altezza corretta, il perno dovrebbe trovarsi a circa 2 mm sopra il nozzle quando \u00e8 retratto Quando si accende la stampante, la sonda BL-Touch dovrebbe eseguire un autotest e spostare il pin su e gi\u00f9 un paio di volte. Una volta completato l'autotest, il perno deve essere retratto e il LED rosso sulla sonda deve essere acceso. In caso di errori, ad esempio la sonda lampeggia in rosso o il pin \u00e8 in basso anzich\u00e9 in alto, spegnere la stampante e controllare il cablaggio e la configurazione. Se quanto sopra sembra buono, \u00e8 il momento di verificare che il pin di controllo funzioni correttamente. Per prima cosa esegui BLTOUCH_DEBUG COMMAND=pin_down nel terminale della tua stampante. Verificare che il pin si abbassi e che il LED rosso sulla sonda si spenga. In caso contrario, controllare nuovamente il cablaggio e la configurazione. Quindi emettere un BLTOUCH_DEBUG COMMAND=pin_up , verificare che il pin si muova verso l'alto e che la luce rossa si accenda di nuovo. Se lampeggia allora c'\u00e8 qualche problema. Il passaggio successivo \u00e8 confermare che il pin del sensore funzioni correttamente. Esegui BLTOUCH_DEBUG COMMAND=pin_down , verifica che il pin si sposti verso il basso, esegui BLTOUCH_DEBUG COMMAND=touch_mode , esegui QUERY_PROBE e verifica che il comando riporti \"probe: open\". Quindi, spingendo leggermente verso l'alto il perno con l'unghia del dito, eseguire nuovamente QUERY_PROBE . Verificare che il comando riporti \"probe: TRIGGERED\". Se una delle query non riporta il messaggio corretto, di solito indica un cablaggio o una configurazione errati (sebbene alcuni clones potrebbero richiedere una gestione speciale). Al completamento di questo test, eseguire BLTOUCH_DEBUG COMMAND=pin_up e verificare che il pin si muova verso l'alto. Dopo aver completato i test del pin di controllo BL-Touch e del pin del sensore, \u00e8 ora il momento di testare il rilevamento, ma con una svolta. Invece di lasciare che il perno della sonda tocchi il piano di stampa, lascia che tocchi l'unghia del dito. Posizionare la testina lontano dal letto, emettere un G28 (o PROBE se non si utilizza probe:z_virtual_endstop), attendere che la testina inizi a muoversi verso il basso e interrompere il movimento toccando molto delicatamente il perno con l'unghia. Potrebbe essere necessario farlo due volte, poich\u00e9 la configurazione di homing predefinita esegue due sonde. Preparati a spegnere la stampante se non si ferma quando tocchi il perno. Se ha avuto successo, esegui un altro G28 (o PROBE ) ma questa volta lascia che tocchi il letto come dovrebbe. BL-Touch andato male \u00b6 Una volta che il BL-Touch \u00e8 in uno stato incoerente, inizia a lampeggiare in rosso. Puoi forzarlo a lasciare quello stato emettendo: BLTOUCH_DEBUG COMMAND=reset Ci\u00f2 pu\u00f2 accadere se la sua calibrazione viene interrotta dal blocco dell'estrazione della sonda. Tuttavia, anche il BL-Touch potrebbe non essere pi\u00f9 in grado di calibrarsi. Ci\u00f2 accade se la vite sulla sua sommit\u00e0 \u00e8 nella posizione sbagliata o se il nucleo magnetico all'interno del perno della sonda si \u00e8 spostato. Se si \u00e8 alzato in modo che si attacchi alla vite, potrebbe non essere pi\u00f9 in grado di abbassare il perno. Con questo comportamento \u00e8 necessario aprire la vite e utilizzare una penna a sfera per spingerla delicatamente in posizione. Reinserire il perno nel BL-Touch in modo che cada nella posizione estratta. Riposizionare con cura la vite senza testa in posizione. \u00c8 necessario trovare la posizione giusta in modo che sia in grado di abbassare e alzare il perno e la luce rossa si accende e si spegne. Usa i comandi reset , pin_up e pin_down per raggiungere questo obiettivo. BL-Touch \"cloni\" \u00b6 Molti dispositivi \"clone\" BL-Touch funzionano correttamente con Klipper utilizzando la configurazione predefinita. Tuttavia, alcuni dispositivi \"clone\" potrebbero non supportare il comando QUERY_PROBE e alcuni dispositivi \"clone\" potrebbero richiedere la configurazione di pin_up_reports_not_triggered o pin_up_touch_mode_reports_triggered . Importante! Non configurare pin_up_reports_not_triggered o pin_up_touch_mode_reports_triggered su False senza prima seguire queste indicazioni. Non configurare nessuno di questi su False su un BL-Touch originale. Un'impostazione errata di questi valori su False pu\u00f2 aumentare il tempo di ispezione e pu\u00f2 aumentare il rischio di danneggiare la stampante. Alcuni dispositivi \"clone\" non supportano touch_mode e di conseguenza il comando QUERY_PROBE non funziona. Nonostante ci\u00f2, potrebbe essere ancora possibile eseguire il rilevamento e l'homing con questi dispositivi. Su questi dispositivi il comando QUERY_PROBE durante i initial tests non avr\u00e0 esito positivo, tuttavia il successivo test G28 (o PROBE ) riesce. Potrebbe essere possibile utilizzare questi dispositivi \"clone\" con Klipper se non si utilizza il comando QUERY_PROBE e se non si abilita la funzione probe_with_touch_mode . Alcuni dispositivi \"clone\" non sono in grado di eseguire il test di verifica del sensore interno di Klipper. Su questi dispositivi, i tentativi di home o probe possono far s\u00ec che Klipper riporti un errore \"BLTouch non \u00e8 riuscito a verificare lo stato del sensore\". In tal caso, eseguire manualmente i passaggi per verificare che il pin del sensore funzioni come descritto nella initial tests section . Se i comandi QUERY_PROBE in quel test producono sempre i risultati attesi e si verificano ancora gli errori \"BLTouch non \u00e8 riuscito a verificare lo stato del sensore\", potrebbe essere necessario impostare pin_up_touch_mode_reports_triggered su False nel file di configurazione di Klipper. Un raro numero di vecchi dispositivi \"clone\" non \u00e8 in grado di segnalare quando hanno sollevato con successo la sonda. Su questi dispositivi Klipper segnaler\u00e0 un errore \"BLTouch non \u00e8 riuscito a sollevare la sonda\" dopo ogni tentativo di home o probe. Si pu\u00f2 testare questi dispositivi: spostare la testa lontano dal letto, eseguire BLTOUCH_DEBUG COMMAND=pin_down , verificare che il pin si sia spostato verso il basso, eseguire QUERY_PROBE , verificare che il comando riporti \"probe: open\", eseguire BLTOUCH_DEBUG COMMAND= pin_up , verifica che il pin sia stato spostato in alto ed esegui QUERY_PROBE . Se il pin rimane attivo, il dispositivo non entra in uno stato di errore e la prima query riporta \"probe: open\" mentre la seconda query riporta \"probe: TRIGGERED\", quindi indica che pin_up_reports_not_triggered dovrebbe essere impostato su False in Klipper file di configurazione. BL-Touch v3 \u00b6 Alcuni dispositivi BL-Touch v3.0 e BL-Touch 3.1 potrebbero richiedere la configurazione di probe_with_touch_mode nel file di configurazione della stampante. Se il BL-Touch v3.0 ha il cavo del segnale collegato a un pin endstop (con un condensatore di filtraggio del rumore), il BL-Touch v3.0 potrebbe non essere in grado di inviare un segnale in modo coerente durante l'homing e il probe. Se i comandi QUERY_PROBE nella initial tests section producono sempre i risultati attesi, ma il toolhead non si ferma sempre durante i comandi G28/PROBE, allora \u00e8 indicativo di questo problema. Una soluzione alternativa consiste nell'impostare probe_with_touch_mode: True nel file di configurazione. Il BL-Touch v3.1 potrebbe entrare erroneamente in uno stato di errore dopo un tentativo di probe riuscito. I sintomi sono una luce lampeggiante occasionale sul BL-Touch v3.1 che dura per un paio di secondi dopo che \u00e8 entrato in contatto con successo con il letto. Klipper dovrebbe cancellare questo errore automaticamente ed \u00e8 generalmente innocuo. Tuttavia, \u00e8 possibile impostare probe_with_touch_mode nel file di configurazione per evitare questo problema. Importante! Alcuni dispositivi \"clone\" e BL-Touch v2.0 (e precedenti) potrebbero avere una precisione ridotta quando probe_with_touch_mode \u00e8 impostato su True. L'impostazione su True aumenta anche il tempo necessario per distribuire la sonda. Se si configura questo valore su un dispositivo BL-Touch \"clone\" o precedente, assicurarsi di testare l'accuratezza della sonda prima e dopo aver impostato questo valore (utilizzare il comando PROBE_ACCURACY per eseguire il test). Multi-sondaggio senza riporre \u00b6 Per impostazione predefinita, Klipper rilascia la sonda all'inizio di ogni tentativo di sonda e poi riporr\u00e0 la sonda in seguito. Questo dispiegamento e stivaggio ripetitivo della sonda pu\u00f2 aumentare il tempo totale delle sequenze di calibrazione che coinvolgono molte misurazioni della sonda. Klipper consente di lasciare la sonda dispiegata tra test consecutivi, il che pu\u00f2 ridurre il tempo totale di rilevamento. Questa modalit\u00e0 \u00e8 abilitata configurando stow_on_each_sample su False nel file di configurazione. Importante! L'impostazione di stow_on_each_sample su False pu\u00f2 portare Klipper a fare movimenti orizzontali della testa utensile mentre la sonda \u00e8 estesa. Assicurarsi di verificare che tutte le operazioni con la probe abbiano un gioco Z sufficiente prima di impostare questo valore su False. Se lo spazio libero \u00e8 insufficiente, uno spostamento orizzontale pu\u00f2 causare l'intrappolamento del perno in un'ostruzione e causare danni alla stampante. Importante! Si consiglia di utilizzare probe_with_touch_mode configurato su True quando si utilizza stow_on_each_sample configurato su False. Alcuni dispositivi \"clone\" potrebbero non rilevare un successivo contatto con il piatto se probe_with_touch_mode non \u00e8 impostato. Su tutti i dispositivi, l'utilizzo della combinazione di queste due impostazioni semplifica la segnalazione del dispositivo, che pu\u00f2 migliorare la stabilit\u00e0 generale. Si noti, tuttavia, che alcuni dispositivi \"clone\" e BL-Touch v2.0 (e precedenti) potrebbero avere una precisione ridotta quando probe_with_touch_mode \u00e8 impostato su True. Su questi dispositivi \u00e8 una buona idea testare l'accuratezza della sonda prima e dopo aver impostato probe_with_touch_mode (usare il comando di test PROBE_ACCURACY ). Calibrazione degli offset BL-Touch \u00b6 Seguire le istruzioni nella guida Probe Calibrate per impostare i parametri di configurazione x_offset, y_offset e z_offset. \u00c8 una buona idea verificare che l'offset Z sia vicino a 1 mm. In caso contrario, probabilmente vorrai spostare la sonda su o gi\u00f9 per risolvere il problema. Si desidera che si attivi ben prima che l'ugello colpisca il piatto, in modo che un possibile filamento bloccato o un piatto deformato non influisca sull'azione della sonda. Ma allo stesso tempo, si desidera che la posizione retratta sia il pi\u00f9 possibile al di sopra dell'ugello per evitare che tocchi le parti stampate. Se viene effettuata una regolazione della posizione della sonda, eseguire nuovamente i passaggi di calibrazione della sonda. Modalit\u00e0 di output BL-Touch \u00b6 Un BL-Touch V3.0 supporta l'impostazione di una modalit\u00e0 di uscita 5V o OPEN-DRAIN, un BL-Touch V3.1 supporta anche questo, ma pu\u00f2 anche memorizzarlo nella sua EEPROM interna. Se la tua scheda controller ha bisogno del livello logico alto 5V fisso della modalit\u00e0 5V, puoi impostare il parametro 'set_output_mode' nella sezione [bltouch] del file di configurazione della stampante su \"5V\". Utilizzare la modalit\u00e0 5V solo se la linea di ingresso della scheda controller \u00e8 tollerante a 5V. Ecco perch\u00e9 la configurazione di default di queste versioni BL-Touch \u00e8 la modalit\u00e0 OPEN-DRAIN. Potresti potenzialmente danneggiare la CPU delle tue schede di controllo Quindi: se una scheda controller HA BISOGNO della modalit\u00e0 5V ED \u00e8 tollerante a 5V sulla sua linea del segnale di ingresso E se si dispone di un BL-Touch Smart V3.0, \u00e8 necessario utilizzare il parametro 'set_output_mode: 5V' per garantire questa impostazione ad ogni avvio, poich\u00e9 la sonda non ricorda l'impostazione necessaria. hai un BL-Touch Smart V3.1, puoi scegliere di usare 'set_output_mode: 5V' o memorizzare la modalit\u00e0 una volta usando un comando 'BLTOUCH_STORE MODE=5V' manualmente e NON usando il parametro 'set_output_mode:'. hai qualche altra sonda: alcune sonde hanno una traccia sul circuito stampato da tagliare o un ponticello da impostare per impostare (permanentemente) la modalit\u00e0 di uscita. In tal caso, omettere completamente il parametro 'set_output_mode'. Se hai una V3.1, non automatizzare o ripetere la memorizzazione della modalit\u00e0 di output per evitare di consumare la EEPROM della sonda. La BLTouch EEPROM \u00e8 valida per circa 100.000 aggiornamenti. 100 memorizzazioni al giorno aggiungerebbero fino a circa 3 anni di attivit\u00e0 prima di logorarlo. Pertanto, la memorizzazione della modalit\u00e0 di output in una V3.1 \u00e8 progettata dal fornitore per essere un'operazione complicata (l'impostazione predefinita di fabbrica \u00e8 una modalit\u00e0 OPEN DRAIN sicura) e non \u00e8 adatta per essere emessa ripetutamente da qualsiasi slicer, macro o altro, esso \u00e8 preferibilmente da utilizzare solo quando si integra per la prima volta la sonda nell'elettronica di una stampante.","title":"BL-Touch"},{"location":"BLTouch.html#bl-touch","text":"","title":"BL-Touch"},{"location":"BLTouch.html#collegare-bl-touch","text":"Attenzione warning prima di cominciare : Evita di toccare la punta del BL-Touch a mani nude, \u00e8 molto sensibili al sebo delle dita. Se sei costretto usa dei guanti ed evita di spingerla o piegarla. Collega il connettore \"servo\" BL-Touch a un control_pin secondo la documentazione BL-Touch o la documentazione MCU. Usando il cablaggio originale, il filo giallo del triplo \u00e8 il control_pin e il filo bianco della coppia \u00e8 il sensor_pin . \u00c8 necessario configurare questi pin in base al cablaggio. La maggior parte dei dispositivi BL-Touch richiede un pullup sul pin del sensore (prefissare il nome del pin con \"^\"). Per esempio: [bltouch] sensor_pin: ^P1.24 control_pin: P1.26 Se il BL-Touch verr\u00e0 utilizzato per l'home dell'asse Z, impostare endstop_pin: probe:z_virtual_endstop e rimuovere position_endstop nella sezione di configurazione [stepper_z] , quindi aggiungere una sezione di configurazione [safe_z_home] per aumentare il asse z, posiziona gli assi xy, spostati al centro del letto e posizionati sull'asse z. Per esempio: [safe_z_home] home_xy_position: 100, 100 # Cambiare le coordinate per il centro del tuo piatto speed: 50 z_hop: 10 # Move up 10mm z_hop_speed: 5 \u00c8 importante che il movimento z_hop in safe_z_home sia sufficientemente alto in mode che la sonda non colpisca nulla anche se il pin della sonda si trova nel suo stato pi\u00f9 basso.","title":"Collegare BL-Touch"},{"location":"BLTouch.html#test-iniziali","text":"Prima di proseguire, verificare che il BL-Touch sia montato all'altezza corretta, il perno dovrebbe trovarsi a circa 2 mm sopra il nozzle quando \u00e8 retratto Quando si accende la stampante, la sonda BL-Touch dovrebbe eseguire un autotest e spostare il pin su e gi\u00f9 un paio di volte. Una volta completato l'autotest, il perno deve essere retratto e il LED rosso sulla sonda deve essere acceso. In caso di errori, ad esempio la sonda lampeggia in rosso o il pin \u00e8 in basso anzich\u00e9 in alto, spegnere la stampante e controllare il cablaggio e la configurazione. Se quanto sopra sembra buono, \u00e8 il momento di verificare che il pin di controllo funzioni correttamente. Per prima cosa esegui BLTOUCH_DEBUG COMMAND=pin_down nel terminale della tua stampante. Verificare che il pin si abbassi e che il LED rosso sulla sonda si spenga. In caso contrario, controllare nuovamente il cablaggio e la configurazione. Quindi emettere un BLTOUCH_DEBUG COMMAND=pin_up , verificare che il pin si muova verso l'alto e che la luce rossa si accenda di nuovo. Se lampeggia allora c'\u00e8 qualche problema. Il passaggio successivo \u00e8 confermare che il pin del sensore funzioni correttamente. Esegui BLTOUCH_DEBUG COMMAND=pin_down , verifica che il pin si sposti verso il basso, esegui BLTOUCH_DEBUG COMMAND=touch_mode , esegui QUERY_PROBE e verifica che il comando riporti \"probe: open\". Quindi, spingendo leggermente verso l'alto il perno con l'unghia del dito, eseguire nuovamente QUERY_PROBE . Verificare che il comando riporti \"probe: TRIGGERED\". Se una delle query non riporta il messaggio corretto, di solito indica un cablaggio o una configurazione errati (sebbene alcuni clones potrebbero richiedere una gestione speciale). Al completamento di questo test, eseguire BLTOUCH_DEBUG COMMAND=pin_up e verificare che il pin si muova verso l'alto. Dopo aver completato i test del pin di controllo BL-Touch e del pin del sensore, \u00e8 ora il momento di testare il rilevamento, ma con una svolta. Invece di lasciare che il perno della sonda tocchi il piano di stampa, lascia che tocchi l'unghia del dito. Posizionare la testina lontano dal letto, emettere un G28 (o PROBE se non si utilizza probe:z_virtual_endstop), attendere che la testina inizi a muoversi verso il basso e interrompere il movimento toccando molto delicatamente il perno con l'unghia. Potrebbe essere necessario farlo due volte, poich\u00e9 la configurazione di homing predefinita esegue due sonde. Preparati a spegnere la stampante se non si ferma quando tocchi il perno. Se ha avuto successo, esegui un altro G28 (o PROBE ) ma questa volta lascia che tocchi il letto come dovrebbe.","title":"Test iniziali"},{"location":"BLTouch.html#bl-touch-andato-male","text":"Una volta che il BL-Touch \u00e8 in uno stato incoerente, inizia a lampeggiare in rosso. Puoi forzarlo a lasciare quello stato emettendo: BLTOUCH_DEBUG COMMAND=reset Ci\u00f2 pu\u00f2 accadere se la sua calibrazione viene interrotta dal blocco dell'estrazione della sonda. Tuttavia, anche il BL-Touch potrebbe non essere pi\u00f9 in grado di calibrarsi. Ci\u00f2 accade se la vite sulla sua sommit\u00e0 \u00e8 nella posizione sbagliata o se il nucleo magnetico all'interno del perno della sonda si \u00e8 spostato. Se si \u00e8 alzato in modo che si attacchi alla vite, potrebbe non essere pi\u00f9 in grado di abbassare il perno. Con questo comportamento \u00e8 necessario aprire la vite e utilizzare una penna a sfera per spingerla delicatamente in posizione. Reinserire il perno nel BL-Touch in modo che cada nella posizione estratta. Riposizionare con cura la vite senza testa in posizione. \u00c8 necessario trovare la posizione giusta in modo che sia in grado di abbassare e alzare il perno e la luce rossa si accende e si spegne. Usa i comandi reset , pin_up e pin_down per raggiungere questo obiettivo.","title":"BL-Touch andato male"},{"location":"BLTouch.html#bl-touch-cloni","text":"Molti dispositivi \"clone\" BL-Touch funzionano correttamente con Klipper utilizzando la configurazione predefinita. Tuttavia, alcuni dispositivi \"clone\" potrebbero non supportare il comando QUERY_PROBE e alcuni dispositivi \"clone\" potrebbero richiedere la configurazione di pin_up_reports_not_triggered o pin_up_touch_mode_reports_triggered . Importante! Non configurare pin_up_reports_not_triggered o pin_up_touch_mode_reports_triggered su False senza prima seguire queste indicazioni. Non configurare nessuno di questi su False su un BL-Touch originale. Un'impostazione errata di questi valori su False pu\u00f2 aumentare il tempo di ispezione e pu\u00f2 aumentare il rischio di danneggiare la stampante. Alcuni dispositivi \"clone\" non supportano touch_mode e di conseguenza il comando QUERY_PROBE non funziona. Nonostante ci\u00f2, potrebbe essere ancora possibile eseguire il rilevamento e l'homing con questi dispositivi. Su questi dispositivi il comando QUERY_PROBE durante i initial tests non avr\u00e0 esito positivo, tuttavia il successivo test G28 (o PROBE ) riesce. Potrebbe essere possibile utilizzare questi dispositivi \"clone\" con Klipper se non si utilizza il comando QUERY_PROBE e se non si abilita la funzione probe_with_touch_mode . Alcuni dispositivi \"clone\" non sono in grado di eseguire il test di verifica del sensore interno di Klipper. Su questi dispositivi, i tentativi di home o probe possono far s\u00ec che Klipper riporti un errore \"BLTouch non \u00e8 riuscito a verificare lo stato del sensore\". In tal caso, eseguire manualmente i passaggi per verificare che il pin del sensore funzioni come descritto nella initial tests section . Se i comandi QUERY_PROBE in quel test producono sempre i risultati attesi e si verificano ancora gli errori \"BLTouch non \u00e8 riuscito a verificare lo stato del sensore\", potrebbe essere necessario impostare pin_up_touch_mode_reports_triggered su False nel file di configurazione di Klipper. Un raro numero di vecchi dispositivi \"clone\" non \u00e8 in grado di segnalare quando hanno sollevato con successo la sonda. Su questi dispositivi Klipper segnaler\u00e0 un errore \"BLTouch non \u00e8 riuscito a sollevare la sonda\" dopo ogni tentativo di home o probe. Si pu\u00f2 testare questi dispositivi: spostare la testa lontano dal letto, eseguire BLTOUCH_DEBUG COMMAND=pin_down , verificare che il pin si sia spostato verso il basso, eseguire QUERY_PROBE , verificare che il comando riporti \"probe: open\", eseguire BLTOUCH_DEBUG COMMAND= pin_up , verifica che il pin sia stato spostato in alto ed esegui QUERY_PROBE . Se il pin rimane attivo, il dispositivo non entra in uno stato di errore e la prima query riporta \"probe: open\" mentre la seconda query riporta \"probe: TRIGGERED\", quindi indica che pin_up_reports_not_triggered dovrebbe essere impostato su False in Klipper file di configurazione.","title":"BL-Touch \"cloni\""},{"location":"BLTouch.html#bl-touch-v3","text":"Alcuni dispositivi BL-Touch v3.0 e BL-Touch 3.1 potrebbero richiedere la configurazione di probe_with_touch_mode nel file di configurazione della stampante. Se il BL-Touch v3.0 ha il cavo del segnale collegato a un pin endstop (con un condensatore di filtraggio del rumore), il BL-Touch v3.0 potrebbe non essere in grado di inviare un segnale in modo coerente durante l'homing e il probe. Se i comandi QUERY_PROBE nella initial tests section producono sempre i risultati attesi, ma il toolhead non si ferma sempre durante i comandi G28/PROBE, allora \u00e8 indicativo di questo problema. Una soluzione alternativa consiste nell'impostare probe_with_touch_mode: True nel file di configurazione. Il BL-Touch v3.1 potrebbe entrare erroneamente in uno stato di errore dopo un tentativo di probe riuscito. I sintomi sono una luce lampeggiante occasionale sul BL-Touch v3.1 che dura per un paio di secondi dopo che \u00e8 entrato in contatto con successo con il letto. Klipper dovrebbe cancellare questo errore automaticamente ed \u00e8 generalmente innocuo. Tuttavia, \u00e8 possibile impostare probe_with_touch_mode nel file di configurazione per evitare questo problema. Importante! Alcuni dispositivi \"clone\" e BL-Touch v2.0 (e precedenti) potrebbero avere una precisione ridotta quando probe_with_touch_mode \u00e8 impostato su True. L'impostazione su True aumenta anche il tempo necessario per distribuire la sonda. Se si configura questo valore su un dispositivo BL-Touch \"clone\" o precedente, assicurarsi di testare l'accuratezza della sonda prima e dopo aver impostato questo valore (utilizzare il comando PROBE_ACCURACY per eseguire il test).","title":"BL-Touch v3"},{"location":"BLTouch.html#multi-sondaggio-senza-riporre","text":"Per impostazione predefinita, Klipper rilascia la sonda all'inizio di ogni tentativo di sonda e poi riporr\u00e0 la sonda in seguito. Questo dispiegamento e stivaggio ripetitivo della sonda pu\u00f2 aumentare il tempo totale delle sequenze di calibrazione che coinvolgono molte misurazioni della sonda. Klipper consente di lasciare la sonda dispiegata tra test consecutivi, il che pu\u00f2 ridurre il tempo totale di rilevamento. Questa modalit\u00e0 \u00e8 abilitata configurando stow_on_each_sample su False nel file di configurazione. Importante! L'impostazione di stow_on_each_sample su False pu\u00f2 portare Klipper a fare movimenti orizzontali della testa utensile mentre la sonda \u00e8 estesa. Assicurarsi di verificare che tutte le operazioni con la probe abbiano un gioco Z sufficiente prima di impostare questo valore su False. Se lo spazio libero \u00e8 insufficiente, uno spostamento orizzontale pu\u00f2 causare l'intrappolamento del perno in un'ostruzione e causare danni alla stampante. Importante! Si consiglia di utilizzare probe_with_touch_mode configurato su True quando si utilizza stow_on_each_sample configurato su False. Alcuni dispositivi \"clone\" potrebbero non rilevare un successivo contatto con il piatto se probe_with_touch_mode non \u00e8 impostato. Su tutti i dispositivi, l'utilizzo della combinazione di queste due impostazioni semplifica la segnalazione del dispositivo, che pu\u00f2 migliorare la stabilit\u00e0 generale. Si noti, tuttavia, che alcuni dispositivi \"clone\" e BL-Touch v2.0 (e precedenti) potrebbero avere una precisione ridotta quando probe_with_touch_mode \u00e8 impostato su True. Su questi dispositivi \u00e8 una buona idea testare l'accuratezza della sonda prima e dopo aver impostato probe_with_touch_mode (usare il comando di test PROBE_ACCURACY ).","title":"Multi-sondaggio senza riporre"},{"location":"BLTouch.html#calibrazione-degli-offset-bl-touch","text":"Seguire le istruzioni nella guida Probe Calibrate per impostare i parametri di configurazione x_offset, y_offset e z_offset. \u00c8 una buona idea verificare che l'offset Z sia vicino a 1 mm. In caso contrario, probabilmente vorrai spostare la sonda su o gi\u00f9 per risolvere il problema. Si desidera che si attivi ben prima che l'ugello colpisca il piatto, in modo che un possibile filamento bloccato o un piatto deformato non influisca sull'azione della sonda. Ma allo stesso tempo, si desidera che la posizione retratta sia il pi\u00f9 possibile al di sopra dell'ugello per evitare che tocchi le parti stampate. Se viene effettuata una regolazione della posizione della sonda, eseguire nuovamente i passaggi di calibrazione della sonda.","title":"Calibrazione degli offset BL-Touch"},{"location":"BLTouch.html#modalita-di-output-bl-touch","text":"Un BL-Touch V3.0 supporta l'impostazione di una modalit\u00e0 di uscita 5V o OPEN-DRAIN, un BL-Touch V3.1 supporta anche questo, ma pu\u00f2 anche memorizzarlo nella sua EEPROM interna. Se la tua scheda controller ha bisogno del livello logico alto 5V fisso della modalit\u00e0 5V, puoi impostare il parametro 'set_output_mode' nella sezione [bltouch] del file di configurazione della stampante su \"5V\". Utilizzare la modalit\u00e0 5V solo se la linea di ingresso della scheda controller \u00e8 tollerante a 5V. Ecco perch\u00e9 la configurazione di default di queste versioni BL-Touch \u00e8 la modalit\u00e0 OPEN-DRAIN. Potresti potenzialmente danneggiare la CPU delle tue schede di controllo Quindi: se una scheda controller HA BISOGNO della modalit\u00e0 5V ED \u00e8 tollerante a 5V sulla sua linea del segnale di ingresso E se si dispone di un BL-Touch Smart V3.0, \u00e8 necessario utilizzare il parametro 'set_output_mode: 5V' per garantire questa impostazione ad ogni avvio, poich\u00e9 la sonda non ricorda l'impostazione necessaria. hai un BL-Touch Smart V3.1, puoi scegliere di usare 'set_output_mode: 5V' o memorizzare la modalit\u00e0 una volta usando un comando 'BLTOUCH_STORE MODE=5V' manualmente e NON usando il parametro 'set_output_mode:'. hai qualche altra sonda: alcune sonde hanno una traccia sul circuito stampato da tagliare o un ponticello da impostare per impostare (permanentemente) la modalit\u00e0 di uscita. In tal caso, omettere completamente il parametro 'set_output_mode'. Se hai una V3.1, non automatizzare o ripetere la memorizzazione della modalit\u00e0 di output per evitare di consumare la EEPROM della sonda. La BLTouch EEPROM \u00e8 valida per circa 100.000 aggiornamenti. 100 memorizzazioni al giorno aggiungerebbero fino a circa 3 anni di attivit\u00e0 prima di logorarlo. Pertanto, la memorizzazione della modalit\u00e0 di output in una V3.1 \u00e8 progettata dal fornitore per essere un'operazione complicata (l'impostazione predefinita di fabbrica \u00e8 una modalit\u00e0 OPEN DRAIN sicura) e non \u00e8 adatta per essere emessa ripetutamente da qualsiasi slicer, macro o altro, esso \u00e8 preferibilmente da utilizzare solo quando si integra per la prima volta la sonda nell'elettronica di una stampante.","title":"Modalit\u00e0 di output BL-Touch"},{"location":"Beaglebone.html","text":"Beaglebone \u00b6 Questo documento descrive il processo di esecuzione di Klipper su una PRU Beaglebone. Creazione di un'immagine del sistema operativo \u00b6 Inizia installando l'immagine Debian 9.9 2019-08-03 4GB SD IoT . \u00c8 possibile eseguire l'immagine da una scheda micro-SD o dall'eMMC integrato. Se si utilizza l'eMMC, installarlo ora nell'eMMC seguendo le istruzioni dal collegamento sopra. Quindi loggati ssh nella macchina Beaglebone ( ssh debian@beaglebone -- la password \u00e8 temppwd ) e installa Klipper eseguendo i seguenti comandi: git clone https://github.com/Klipper3d/klipper ./klipper/scripts/install-beaglebone.sh Installare Octoprint \u00b6 Si pu\u00f2 quindi installare Octoprint: git clone https://github.com/foosel/OctoPrint.git cd OctoPrint/ virtualenv venv ./venv/bin/python setup.py install E configura OctoPrint per l'avvio all'avvio: sudo cp ~/OctoPrint/scripts/octoprint.init /etc/init.d/octoprint sudo chmod +x /etc/init.d/octoprint sudo cp ~/OctoPrint/scripts/octoprint.default /etc/default/octoprint sudo update-rc.d octoprint defaults \u00c8 necessario modificare il file di configurazione /etc/default/octoprint di OctoPrint. Si deve cambiare l'utente OCTOPRINT_USER in debian , cambiare NICELEVEL in 0 , togliere il commento alle impostazioni di BASEDIR , CONFIGFILE e DAEMON e cambiare i riferimenti della home da /home/pi/ a /home/debian/ : sudo nano /etc/default/octoprint Quindi avvia il servizio Octoprint: sudo systemctl start octoprint Assicurati che il server web OctoPrint sia accessibile - dovrebbe trovarsi su: http://beaglebone:5000/ Creazione del codice del microcontrollore \u00b6 Per compilare il codice del microcontrollore Klipper, inizia configurandolo per il \"Beaglebone PRU\": cd ~/klipper/ make menuconfig Per compilare e installare il nuovo codice del microcontrollore, eseguire: sudo service klipper stop make flash sudo service klipper start \u00c8 inoltre necessario compilare e installare il codice del microcontrollore per un processo host Linux. Configuralo per un \"processo Linux\": make menuconfig Quindi installa anche questo codice del microcontrollore: sudo service klipper stop make flash sudo service klipper start Configurazione rimanente \u00b6 Completare l'installazione configurando Klipper e Octoprint seguendo le istruzioni nel documento principale Installation . Stampa sul Beaglebone \u00b6 Sfortunatamente, il processore Beaglebone a volte pu\u00f2 avere difficolt\u00e0 a far funzionare bene OctoPrint. \u00c8 noto che i blocchi di stampa si verificano su stampe complesse (la stampante potrebbe muoversi pi\u00f9 velocemente di quanto OctoPrint possa inviare comandi di movimento). In questo caso, considera l'utilizzo della funzione \"virtual_sdcard\" (consulta Config Reference per i dettagli) per stampare direttamente da Klipper.","title":"Beaglebone"},{"location":"Beaglebone.html#beaglebone","text":"Questo documento descrive il processo di esecuzione di Klipper su una PRU Beaglebone.","title":"Beaglebone"},{"location":"Beaglebone.html#creazione-di-unimmagine-del-sistema-operativo","text":"Inizia installando l'immagine Debian 9.9 2019-08-03 4GB SD IoT . \u00c8 possibile eseguire l'immagine da una scheda micro-SD o dall'eMMC integrato. Se si utilizza l'eMMC, installarlo ora nell'eMMC seguendo le istruzioni dal collegamento sopra. Quindi loggati ssh nella macchina Beaglebone ( ssh debian@beaglebone -- la password \u00e8 temppwd ) e installa Klipper eseguendo i seguenti comandi: git clone https://github.com/Klipper3d/klipper ./klipper/scripts/install-beaglebone.sh","title":"Creazione di un'immagine del sistema operativo"},{"location":"Beaglebone.html#installare-octoprint","text":"Si pu\u00f2 quindi installare Octoprint: git clone https://github.com/foosel/OctoPrint.git cd OctoPrint/ virtualenv venv ./venv/bin/python setup.py install E configura OctoPrint per l'avvio all'avvio: sudo cp ~/OctoPrint/scripts/octoprint.init /etc/init.d/octoprint sudo chmod +x /etc/init.d/octoprint sudo cp ~/OctoPrint/scripts/octoprint.default /etc/default/octoprint sudo update-rc.d octoprint defaults \u00c8 necessario modificare il file di configurazione /etc/default/octoprint di OctoPrint. Si deve cambiare l'utente OCTOPRINT_USER in debian , cambiare NICELEVEL in 0 , togliere il commento alle impostazioni di BASEDIR , CONFIGFILE e DAEMON e cambiare i riferimenti della home da /home/pi/ a /home/debian/ : sudo nano /etc/default/octoprint Quindi avvia il servizio Octoprint: sudo systemctl start octoprint Assicurati che il server web OctoPrint sia accessibile - dovrebbe trovarsi su: http://beaglebone:5000/","title":"Installare Octoprint"},{"location":"Beaglebone.html#creazione-del-codice-del-microcontrollore","text":"Per compilare il codice del microcontrollore Klipper, inizia configurandolo per il \"Beaglebone PRU\": cd ~/klipper/ make menuconfig Per compilare e installare il nuovo codice del microcontrollore, eseguire: sudo service klipper stop make flash sudo service klipper start \u00c8 inoltre necessario compilare e installare il codice del microcontrollore per un processo host Linux. Configuralo per un \"processo Linux\": make menuconfig Quindi installa anche questo codice del microcontrollore: sudo service klipper stop make flash sudo service klipper start","title":"Creazione del codice del microcontrollore"},{"location":"Beaglebone.html#configurazione-rimanente","text":"Completare l'installazione configurando Klipper e Octoprint seguendo le istruzioni nel documento principale Installation .","title":"Configurazione rimanente"},{"location":"Beaglebone.html#stampa-sul-beaglebone","text":"Sfortunatamente, il processore Beaglebone a volte pu\u00f2 avere difficolt\u00e0 a far funzionare bene OctoPrint. \u00c8 noto che i blocchi di stampa si verificano su stampe complesse (la stampante potrebbe muoversi pi\u00f9 velocemente di quanto OctoPrint possa inviare comandi di movimento). In questo caso, considera l'utilizzo della funzione \"virtual_sdcard\" (consulta Config Reference per i dettagli) per stampare direttamente da Klipper.","title":"Stampa sul Beaglebone"},{"location":"Bed_Level.html","text":"Livellamento del piatto \u00b6 La livellatura del piatto \u00e8 fondamentale per ottenere stampe di alta qualit\u00e0. Se un piatto non \u00e8 adeguatamente \"livellato\" pu\u00f2 portare a una scarsa adesione sul piatto, a una \"deformazione\" e a problemi minori durante la stampa. Questo documento serve come guida per eseguire il livellamento del piatto in Klipper. \u00c8 importante comprendere l'obiettivo del livellamento del piatto. Se alla stampante viene comandata una posizione X0 Y0 Z10 durante una stampa, l'obiettivo \u00e8 che l'ugello della stampante si trovi esattamente a 10 mm dal piatto della stampante. Inoltre, se poi la stampante dovesse essere comandata in una posizione di X50 Z10 , l'obiettivo \u00e8 che l'ugello mantenga una distanza esatta di 10 mm dal piatto durante l'intero movimento orizzontale. Per ottenere stampe di buona qualit\u00e0, la stampante deve essere calibrata in modo che le distanze Z siano precise entro circa 25 micron (0,025 mm). Questa \u00e8 una piccola distanza, significativamente pi\u00f9 piccola della larghezza di un tipico capello umano. Questa scala non pu\u00f2 essere misurata \"a occhio\". Gli effetti sottili (come l'espansione del calore) influiscono sulle misurazioni a questa scala. Il segreto per ottenere un'elevata precisione \u00e8 utilizzare un processo ripetibile e un metodo di livellamento che sfrutti l'elevata precisione del sistema di movimento della stampante. Scegliere il meccanismo di calibrazione appropriato \u00b6 Diversi tipi di stampanti utilizzano metodi diversi per eseguire il livellamento del piatto. Tutti alla fine dipendono dal \"test cartaceo\" (descritto di seguito). Tuttavia, il processo effettivo per un particolare tipo di stampante \u00e8 descritto in altri documenti. Prima di eseguire uno di questi strumenti di calibrazione, assicurarsi di eseguire i controlli descritti nel documento check di configurazione . \u00c8 necessario verificare il movimento di base della stampante prima di eseguire il livellamento del piatto. Per le stampanti con una \"sonda Z automatica\", assicurarsi di calibrare la sonda seguendo le istruzioni nel documento Probe Calibrate . Per le stampanti delta, vedere il documento Delta Calibrate . Per le stampanti con viti di fissaggio e fermi Z tradizionali, vedere il documento Manual Level . Durante la calibrazione potrebbe essere necessario impostare la Z position_min della stampante su un numero negativo (ad esempio, position_min = -2 ). La stampante applica i controlli dei confini anche durante le routine di calibrazione. L'impostazione di un numero negativo consente alla stampante di spostarsi al di sotto della posizione nominale del piatto, il che pu\u00f2 aiutare quando si tenta di determinare la posizione effettiva del piatto. Il \"test con la carta\" \u00b6 Il meccanismo primario di calibrazione del piatto primario \u00e8 il \"test della carta\". Si tratta di posizionare un normale pezzo di \"carta per fotocopiatrice\" tra il piatto della stampante e l'ugello, quindi comandare l'ugello a diverse altezze Z finch\u00e9 non si avverte una piccola quantit\u00e0 di attrito quando si spinge la carta avanti e indietro. \u00c8 importante comprendere il \"test della carta\" anche se si dispone di una \"sonda Z automatica\". La sonda stessa deve spesso essere calibrata per ottenere buoni risultati. La calibrazione della sonda viene eseguita utilizzando questo \"test della carta\". Per eseguire il test della carta, taglia un piccolo pezzo di carta rettangolare usando un paio di forbici (es. 5x3 cm). La carta ha generalmente uno spessore di circa 100 micron (0,100 mm). (Lo spessore esatto della carta non \u00e8 cruciale.) Il primo passaggio del test della carta consiste nell'ispezione dell'ugello e del piatto della stampante. Assicurati che non ci sia plastica (o altri detriti) sull'ugello o sul letto. Ispeziona l'ugello e il piatto per assicurarti che non sia presente plastica! Se si stampa sempre su un determinato nastro o superficie di stampa, \u00e8 possibile eseguire il test della carta con quel nastro/superficie in posizione. Tuttavia, tieni presente che il nastro stesso ha uno spessore e nastri diversi (o qualsiasi altra superficie di stampa) influiranno sulle misurazioni Z. Assicurati di eseguire nuovamente il test della carta per misurare ogni tipo di superficie in uso. Se c'\u00e8 della plastica sull'ugello, riscalda l'estrusore e usa una pinzetta di metallo per rimuovere quella plastica. Attendere che l'estrusore si raffreddi completamente a temperatura ambiente prima di continuare con il test della carta. Mentre l'ugello si sta raffreddando, usa le pinzette di metallo per rimuovere la plastica che potrebbe fuoriuscire. Esegui sempre il test della carta quando sia l'ugello che il letto sono a temperatura ambiente! Quando l'ugello \u00e8 riscaldato, la sua posizione (rispetto al piatto) cambia a causa dell'espansione termica. Questa espansione termica \u00e8 in genere di circa 100 micron, che ha all'incirca lo stesso spessore di un tipico pezzo di carta per stampante. L'esatta quantit\u00e0 di espansione termica non \u00e8 cruciale, cos\u00ec come lo spessore esatto della carta non \u00e8 cruciale. Inizia con il presupposto che i due siano uguali (vedi sotto per un metodo per determinare la differenza tra le due distanze). Pu\u00f2 sembrare strano calibrare la distanza a temperatura ambiente quando l'obiettivo \u00e8 avere una distanza costante quando riscaldata. Tuttavia, se si calibra quando l'ugello \u00e8 riscaldato, tende a rilasciare piccole quantit\u00e0 di plastica fusa alla carta, il che cambia la quantit\u00e0 di attrito sentito. Ci\u00f2 rende pi\u00f9 difficile ottenere una buona calibrazione. La calibrazione mentre il letto/ugello \u00e8 caldo aumenta notevolmente anche il rischio di ustione. La quantit\u00e0 di espansione termica \u00e8 stabile, quindi \u00e8 facilmente contabilizzabile pi\u00f9 avanti nel processo di calibrazione. Utilizza uno strumento automatizzato per determinare l'altezza Z precisa! Klipper ha diversi script di supporto disponibili (ad esempio, MANUAL_PROBE, Z_ENDSTOP_CALIBRATE, PROBE_CALIBRATE, DELTA_CALIBRATE). Consulta i documenti descritti sopra per sceglierne uno. Eseguire il comando appropriato nella finestra del terminale di OctoPrint. Lo script richieder\u00e0 l'interazione dell'utente nell'output del terminale OctoPrint. Sembrer\u00e0 qualcosa come: Recv: // Starting manual Z probe. Use TESTZ to adjust position. Recv: // Finish with ACCEPT or ABORT command. Recv: // Z position: ?????? --> 5.000 <-- ?????? L'altezza attuale dell'ugello (come la intende attualmente la stampante) \u00e8 mostrata tra \"--> <--\". Il numero a destra \u00e8 l'altezza dell'ultimo tentativo di sonda appena maggiore dell'altezza attuale e a sinistra \u00e8 l'ultimo tentativo di sonda inferiore all'altezza attuale (o ?????? se non \u00e8 stato effettuato alcun tentativo). Metti la carta tra l'ugello e il letto. Pu\u00f2 essere utile piegare un angolo della carta in modo che sia pi\u00f9 facile da afferrare. (Cerca di non spingere il piatto quando muovi la carta avanti e indietro.) Utilizzare il comando TESTZ per richiedere all'ugello di avvicinarsi alla carta. Per esempio: TESTZ Z=-.1 Il comando TESTZ sposter\u00e0 l'ugello di una distanza relativa dalla posizione corrente dell'ugello. (Quindi, Z=-.1 richiede che l'ugello si avvicini al piatto di 0,1 mm.) Dopo che l'ugello ha smesso di muoversi, spingere la carta avanti e indietro per controllare se l'ugello \u00e8 in contatto con la carta e per sentire la quantit\u00e0 di attrito. Continua a emettere comandi TESTZ finch\u00e9 non si avverte una piccola quantit\u00e0 di attrito durante il test con la carta. Se si trova troppo attrito, \u00e8 possibile utilizzare un valore Z positivo per spostare l'ugello verso l'alto. \u00c8 anche possibile utilizzare TESTZ Z=+ o TESTZ Z=- per \"sezionare in due\" l'ultima posizione, ovvero per spostarsi in una posizione a met\u00e0 strada tra due posizioni. Ad esempio, se si riceve il seguente prompt da un comando TESTZ: Recv: // Z position: 0.130 --> 0.230 <-- 0.280 Quindi un TESTZ Z=- sposterebbe l'ugello in una posizione Z di 0,180 (a met\u00e0 strada tra 0,130 e 0,230). \u00c8 possibile utilizzare questa funzione per ridurre rapidamente a un attrito costante. \u00c8 anche possibile usare Z=++ e Z=-- per tornare direttamente a una misurazione passata - per esempio, dopo il prompt sopra un comando TESTZ Z=-- sposterebbe l'ugello su una Z posizione di 0,130. Dopo aver trovato una piccola quantit\u00e0 di attrito, eseguire il comando ACCETTA: ACCEPT Questo accetter\u00e0 l'altezza Z data e proceder\u00e0 con lo strumento di calibrazione fornito. L'esatta quantit\u00e0 di attrito percepito non \u00e8 cruciale, cos\u00ec come la quantit\u00e0 di espansione termica e l'esatta larghezza della carta non sono cruciali. Cerca solo di ottenere la stessa quantit\u00e0 di attrito ogni volta che esegui il test. Se qualcosa va storto durante il test, \u00e8 possibile utilizzare il comando ABORT per uscire dallo strumento di calibrazione. Determinare l'espansione termica \u00b6 Dopo aver eseguito con successo il livellamento del piatto, si pu\u00f2 continuare a calcolare un valore pi\u00f9 preciso per l'impatto combinato di \"espansione termica\", \"spessore della carta\" e \"quantit\u00e0 di attrito sentito durante il test della carta\". Questo tipo di calcolo generalmente non \u00e8 necessario poich\u00e9 la maggior parte degli utenti ritiene che il semplice \"test cartaceo\" fornisca buoni risultati. Il modo pi\u00f9 semplice per eseguire questo calcolo \u00e8 stampare un oggetto di prova con pareti dritte su tutti i lati. Il cubo vuoto che si trova in docs/prints/square.stl pu\u00f2 essere usato per questo. Quando si fa lo slicing l'oggetto, assicurarsi che lo slicer utilizzi la stessa altezza del livello e la stessa larghezza di estrusione per il primo livello che utilizza per tutti i livelli successivi. Utilizzare un'altezza dello strato grossolana (l'altezza dello strato dovrebbe essere circa il 75% del diametro dell'ugello) e non utilizzare un bordo o una raft. Stampa l'oggetto di prova, attendi che si raffreddi e rimuovilo dal piatto. Ispeziona lo strato pi\u00f9 basso dell'oggetto. (Pu\u00f2 anche essere utile far scorrere un dito o un'unghia lungo il bordo inferiore.) Se si scopre che lo strato inferiore si gonfia leggermente lungo tutti i lati dell'oggetto, significa che l'ugello era leggermente pi\u00f9 vicino al piatto di quanto dovrebbe essere. Si pu\u00f2 emettere un comando SET_GCODE_OFFSET Z=+.010 per aumentare l'altezza. Nelle stampe successive \u00e8 possibile controllare questo comportamento e apportare ulteriori modifiche secondo necessit\u00e0. Le regolazioni di questo tipo sono in genere in 10 micron (0,010 mm). Se il livello inferiore appare costantemente pi\u00f9 stretto dei livelli successivi, \u00e8 possibile utilizzare il comando SET_GCODE_OFFSET per effettuare una regolazione Z negativa. Se non si \u00e8 sicuri, \u00e8 possibile diminuire la regolazione Z finch\u00e9 lo strato inferiore delle stampe non mostra un piccolo rigonfiamento, quindi arretrare finch\u00e9 non scompare. Il modo pi\u00f9 semplice per applicare la regolazione Z desiderata \u00e8 creare una macro di G-code START_PRINT, fare in modo che lo slicer chiami quella macro all'inizio di ogni stampa e aggiungere un comando SET_GCODE_OFFSET a quella macro. Per ulteriori dettagli, vedere il documento slicers .","title":"Livellamento del piatto"},{"location":"Bed_Level.html#livellamento-del-piatto","text":"La livellatura del piatto \u00e8 fondamentale per ottenere stampe di alta qualit\u00e0. Se un piatto non \u00e8 adeguatamente \"livellato\" pu\u00f2 portare a una scarsa adesione sul piatto, a una \"deformazione\" e a problemi minori durante la stampa. Questo documento serve come guida per eseguire il livellamento del piatto in Klipper. \u00c8 importante comprendere l'obiettivo del livellamento del piatto. Se alla stampante viene comandata una posizione X0 Y0 Z10 durante una stampa, l'obiettivo \u00e8 che l'ugello della stampante si trovi esattamente a 10 mm dal piatto della stampante. Inoltre, se poi la stampante dovesse essere comandata in una posizione di X50 Z10 , l'obiettivo \u00e8 che l'ugello mantenga una distanza esatta di 10 mm dal piatto durante l'intero movimento orizzontale. Per ottenere stampe di buona qualit\u00e0, la stampante deve essere calibrata in modo che le distanze Z siano precise entro circa 25 micron (0,025 mm). Questa \u00e8 una piccola distanza, significativamente pi\u00f9 piccola della larghezza di un tipico capello umano. Questa scala non pu\u00f2 essere misurata \"a occhio\". Gli effetti sottili (come l'espansione del calore) influiscono sulle misurazioni a questa scala. Il segreto per ottenere un'elevata precisione \u00e8 utilizzare un processo ripetibile e un metodo di livellamento che sfrutti l'elevata precisione del sistema di movimento della stampante.","title":"Livellamento del piatto"},{"location":"Bed_Level.html#scegliere-il-meccanismo-di-calibrazione-appropriato","text":"Diversi tipi di stampanti utilizzano metodi diversi per eseguire il livellamento del piatto. Tutti alla fine dipendono dal \"test cartaceo\" (descritto di seguito). Tuttavia, il processo effettivo per un particolare tipo di stampante \u00e8 descritto in altri documenti. Prima di eseguire uno di questi strumenti di calibrazione, assicurarsi di eseguire i controlli descritti nel documento check di configurazione . \u00c8 necessario verificare il movimento di base della stampante prima di eseguire il livellamento del piatto. Per le stampanti con una \"sonda Z automatica\", assicurarsi di calibrare la sonda seguendo le istruzioni nel documento Probe Calibrate . Per le stampanti delta, vedere il documento Delta Calibrate . Per le stampanti con viti di fissaggio e fermi Z tradizionali, vedere il documento Manual Level . Durante la calibrazione potrebbe essere necessario impostare la Z position_min della stampante su un numero negativo (ad esempio, position_min = -2 ). La stampante applica i controlli dei confini anche durante le routine di calibrazione. L'impostazione di un numero negativo consente alla stampante di spostarsi al di sotto della posizione nominale del piatto, il che pu\u00f2 aiutare quando si tenta di determinare la posizione effettiva del piatto.","title":"Scegliere il meccanismo di calibrazione appropriato"},{"location":"Bed_Level.html#il-test-con-la-carta","text":"Il meccanismo primario di calibrazione del piatto primario \u00e8 il \"test della carta\". Si tratta di posizionare un normale pezzo di \"carta per fotocopiatrice\" tra il piatto della stampante e l'ugello, quindi comandare l'ugello a diverse altezze Z finch\u00e9 non si avverte una piccola quantit\u00e0 di attrito quando si spinge la carta avanti e indietro. \u00c8 importante comprendere il \"test della carta\" anche se si dispone di una \"sonda Z automatica\". La sonda stessa deve spesso essere calibrata per ottenere buoni risultati. La calibrazione della sonda viene eseguita utilizzando questo \"test della carta\". Per eseguire il test della carta, taglia un piccolo pezzo di carta rettangolare usando un paio di forbici (es. 5x3 cm). La carta ha generalmente uno spessore di circa 100 micron (0,100 mm). (Lo spessore esatto della carta non \u00e8 cruciale.) Il primo passaggio del test della carta consiste nell'ispezione dell'ugello e del piatto della stampante. Assicurati che non ci sia plastica (o altri detriti) sull'ugello o sul letto. Ispeziona l'ugello e il piatto per assicurarti che non sia presente plastica! Se si stampa sempre su un determinato nastro o superficie di stampa, \u00e8 possibile eseguire il test della carta con quel nastro/superficie in posizione. Tuttavia, tieni presente che il nastro stesso ha uno spessore e nastri diversi (o qualsiasi altra superficie di stampa) influiranno sulle misurazioni Z. Assicurati di eseguire nuovamente il test della carta per misurare ogni tipo di superficie in uso. Se c'\u00e8 della plastica sull'ugello, riscalda l'estrusore e usa una pinzetta di metallo per rimuovere quella plastica. Attendere che l'estrusore si raffreddi completamente a temperatura ambiente prima di continuare con il test della carta. Mentre l'ugello si sta raffreddando, usa le pinzette di metallo per rimuovere la plastica che potrebbe fuoriuscire. Esegui sempre il test della carta quando sia l'ugello che il letto sono a temperatura ambiente! Quando l'ugello \u00e8 riscaldato, la sua posizione (rispetto al piatto) cambia a causa dell'espansione termica. Questa espansione termica \u00e8 in genere di circa 100 micron, che ha all'incirca lo stesso spessore di un tipico pezzo di carta per stampante. L'esatta quantit\u00e0 di espansione termica non \u00e8 cruciale, cos\u00ec come lo spessore esatto della carta non \u00e8 cruciale. Inizia con il presupposto che i due siano uguali (vedi sotto per un metodo per determinare la differenza tra le due distanze). Pu\u00f2 sembrare strano calibrare la distanza a temperatura ambiente quando l'obiettivo \u00e8 avere una distanza costante quando riscaldata. Tuttavia, se si calibra quando l'ugello \u00e8 riscaldato, tende a rilasciare piccole quantit\u00e0 di plastica fusa alla carta, il che cambia la quantit\u00e0 di attrito sentito. Ci\u00f2 rende pi\u00f9 difficile ottenere una buona calibrazione. La calibrazione mentre il letto/ugello \u00e8 caldo aumenta notevolmente anche il rischio di ustione. La quantit\u00e0 di espansione termica \u00e8 stabile, quindi \u00e8 facilmente contabilizzabile pi\u00f9 avanti nel processo di calibrazione. Utilizza uno strumento automatizzato per determinare l'altezza Z precisa! Klipper ha diversi script di supporto disponibili (ad esempio, MANUAL_PROBE, Z_ENDSTOP_CALIBRATE, PROBE_CALIBRATE, DELTA_CALIBRATE). Consulta i documenti descritti sopra per sceglierne uno. Eseguire il comando appropriato nella finestra del terminale di OctoPrint. Lo script richieder\u00e0 l'interazione dell'utente nell'output del terminale OctoPrint. Sembrer\u00e0 qualcosa come: Recv: // Starting manual Z probe. Use TESTZ to adjust position. Recv: // Finish with ACCEPT or ABORT command. Recv: // Z position: ?????? --> 5.000 <-- ?????? L'altezza attuale dell'ugello (come la intende attualmente la stampante) \u00e8 mostrata tra \"--> <--\". Il numero a destra \u00e8 l'altezza dell'ultimo tentativo di sonda appena maggiore dell'altezza attuale e a sinistra \u00e8 l'ultimo tentativo di sonda inferiore all'altezza attuale (o ?????? se non \u00e8 stato effettuato alcun tentativo). Metti la carta tra l'ugello e il letto. Pu\u00f2 essere utile piegare un angolo della carta in modo che sia pi\u00f9 facile da afferrare. (Cerca di non spingere il piatto quando muovi la carta avanti e indietro.) Utilizzare il comando TESTZ per richiedere all'ugello di avvicinarsi alla carta. Per esempio: TESTZ Z=-.1 Il comando TESTZ sposter\u00e0 l'ugello di una distanza relativa dalla posizione corrente dell'ugello. (Quindi, Z=-.1 richiede che l'ugello si avvicini al piatto di 0,1 mm.) Dopo che l'ugello ha smesso di muoversi, spingere la carta avanti e indietro per controllare se l'ugello \u00e8 in contatto con la carta e per sentire la quantit\u00e0 di attrito. Continua a emettere comandi TESTZ finch\u00e9 non si avverte una piccola quantit\u00e0 di attrito durante il test con la carta. Se si trova troppo attrito, \u00e8 possibile utilizzare un valore Z positivo per spostare l'ugello verso l'alto. \u00c8 anche possibile utilizzare TESTZ Z=+ o TESTZ Z=- per \"sezionare in due\" l'ultima posizione, ovvero per spostarsi in una posizione a met\u00e0 strada tra due posizioni. Ad esempio, se si riceve il seguente prompt da un comando TESTZ: Recv: // Z position: 0.130 --> 0.230 <-- 0.280 Quindi un TESTZ Z=- sposterebbe l'ugello in una posizione Z di 0,180 (a met\u00e0 strada tra 0,130 e 0,230). \u00c8 possibile utilizzare questa funzione per ridurre rapidamente a un attrito costante. \u00c8 anche possibile usare Z=++ e Z=-- per tornare direttamente a una misurazione passata - per esempio, dopo il prompt sopra un comando TESTZ Z=-- sposterebbe l'ugello su una Z posizione di 0,130. Dopo aver trovato una piccola quantit\u00e0 di attrito, eseguire il comando ACCETTA: ACCEPT Questo accetter\u00e0 l'altezza Z data e proceder\u00e0 con lo strumento di calibrazione fornito. L'esatta quantit\u00e0 di attrito percepito non \u00e8 cruciale, cos\u00ec come la quantit\u00e0 di espansione termica e l'esatta larghezza della carta non sono cruciali. Cerca solo di ottenere la stessa quantit\u00e0 di attrito ogni volta che esegui il test. Se qualcosa va storto durante il test, \u00e8 possibile utilizzare il comando ABORT per uscire dallo strumento di calibrazione.","title":"Il \"test con la carta\""},{"location":"Bed_Level.html#determinare-lespansione-termica","text":"Dopo aver eseguito con successo il livellamento del piatto, si pu\u00f2 continuare a calcolare un valore pi\u00f9 preciso per l'impatto combinato di \"espansione termica\", \"spessore della carta\" e \"quantit\u00e0 di attrito sentito durante il test della carta\". Questo tipo di calcolo generalmente non \u00e8 necessario poich\u00e9 la maggior parte degli utenti ritiene che il semplice \"test cartaceo\" fornisca buoni risultati. Il modo pi\u00f9 semplice per eseguire questo calcolo \u00e8 stampare un oggetto di prova con pareti dritte su tutti i lati. Il cubo vuoto che si trova in docs/prints/square.stl pu\u00f2 essere usato per questo. Quando si fa lo slicing l'oggetto, assicurarsi che lo slicer utilizzi la stessa altezza del livello e la stessa larghezza di estrusione per il primo livello che utilizza per tutti i livelli successivi. Utilizzare un'altezza dello strato grossolana (l'altezza dello strato dovrebbe essere circa il 75% del diametro dell'ugello) e non utilizzare un bordo o una raft. Stampa l'oggetto di prova, attendi che si raffreddi e rimuovilo dal piatto. Ispeziona lo strato pi\u00f9 basso dell'oggetto. (Pu\u00f2 anche essere utile far scorrere un dito o un'unghia lungo il bordo inferiore.) Se si scopre che lo strato inferiore si gonfia leggermente lungo tutti i lati dell'oggetto, significa che l'ugello era leggermente pi\u00f9 vicino al piatto di quanto dovrebbe essere. Si pu\u00f2 emettere un comando SET_GCODE_OFFSET Z=+.010 per aumentare l'altezza. Nelle stampe successive \u00e8 possibile controllare questo comportamento e apportare ulteriori modifiche secondo necessit\u00e0. Le regolazioni di questo tipo sono in genere in 10 micron (0,010 mm). Se il livello inferiore appare costantemente pi\u00f9 stretto dei livelli successivi, \u00e8 possibile utilizzare il comando SET_GCODE_OFFSET per effettuare una regolazione Z negativa. Se non si \u00e8 sicuri, \u00e8 possibile diminuire la regolazione Z finch\u00e9 lo strato inferiore delle stampe non mostra un piccolo rigonfiamento, quindi arretrare finch\u00e9 non scompare. Il modo pi\u00f9 semplice per applicare la regolazione Z desiderata \u00e8 creare una macro di G-code START_PRINT, fare in modo che lo slicer chiami quella macro all'inizio di ogni stampa e aggiungere un comando SET_GCODE_OFFSET a quella macro. Per ulteriori dettagli, vedere il documento slicers .","title":"Determinare l'espansione termica"},{"location":"Bed_Mesh.html","text":"Matrice del Piatto \u00b6 Il modulo rete piatto (bed mesh) pu\u00f2 essere usato per compensare le irregolarit\u00e0 della superficie del piatto e per ottenere un primo strato migliore su tutto il piatto. Va notato che la correzione basata sul software non raggiunger\u00e0 risultati perfetti, pu\u00f2 solo approssimare la forma del piatto. Bed mesh inoltre non pu\u00f2 compensare i problemi meccanici ed elettrici. Se un asse \u00e8 obliquo o una sonda non \u00e8 accurata, il modulo Bed mesh non ricever\u00e0 risultati accurati dal processo di ispezione. Prima della calibrazione della mesh dovrai assicurarti che l'offset Z della tua sonda sia calibrato. Se si utilizza un fine corsa per l'homing Z, anche questo dovr\u00e0 essere calibrato. Per ulteriori informazioni, vedere Probe Calibrate e Z_ENDSTOP_CALIBRATE in Manual Level . Configurazione base \u00b6 Piatti rettangolari \u00b6 Questo esempio presuppone una stampante con un piatto rettangolare di 250 mm x 220 mm e una sonda con un offset x di 24 mm e un offset y di 5 mm. [bed_mesh] speed: 120 horizontal_move_z: 5 mesh_min: 35, 6 mesh_max: 240, 198 probe_count: 5, 3 speed: 120 Valore predefinito: 50 La velocit\u00e0 con cui la testa di stampa si sposta tra i punti. horizontal_move_z: 5 Valore predefinito: 5 La coordinata Z a cui si solleva la sonda prima di spostarsi tra i punti. mesh_min: 35, 6 Richiesto La prima coordinata rilevata, pi\u00f9 vicina all'origine. Questa coordinata \u00e8 relativa alla posizione della sonda. mesh_max: 240, 198 Richiesto La coordinata rilevata pi\u00f9 lontana dall'origine. Questo non \u00e8 necessariamente l'ultimo punto sondato, poich\u00e9 il processo di rilevamento avviene a zig-zag. Come per mesh_min , questa coordinata \u00e8 relativa alla posizione della sonda. probe_count: 5, 3 Valore predefinito: 3, 3 Il numero di punti da sondare su ciascun asse, specificato come valori interi X, Y. In questo esempio verranno tastati 5 punti lungo l'asse X, con 3 punti lungo l'asse Y, per un totale di 15 punti tastati. Nota che se desideri una griglia quadrata, ad esempio 3x3, questo potrebbe essere specificato come un singolo valore intero che viene utilizzato per entrambi gli assi, ad esempio probe_count: 3 . Si noti che una mesh richiede un probe_count minimo di 3 lungo ciascun asse. L'illustrazione seguente mostra come le opzioni mesh_min , mesh_max e probe_count vengono utilizzate per generare punti sonda. Le frecce indicano la direzione della procedura di probing, a partire da mesh_min . Per riferimento, quando la sonda \u00e8 a mesh_min , l'ugello sar\u00e0 a (11, 1), e quando la sonda \u00e8 a mesh_max , l'ugello sar\u00e0 a (206, 193). Piatti rotondi \u00b6 Questo esempio presuppone una stampante dotata di un raggio del piatto rotondo di 100 mm. Utilizzeremo gli stessi offset della sonda dell'esempio rettangolare, 24 mm su X e 5 mm su Y. [bed_mesh] speed: 120 horizontal_move_z: 5 mesh_radius: 75 mesh_origin: 0, 0 round_probe_count: 5 mesh_radius: 75 Obbligatorio Il raggio della mesh sondata in mm, relativo a mesh_origin . Si noti che gli offset della sonda limitano la dimensione del raggio della mesh. In questo esempio, un raggio maggiore di 76 sposterebbe lo strumento oltre il range della stampante. mesh_origin: 0, 0 Valore predefinito: 0, 0 Il punto centrale della mesh. Questa coordinata \u00e8 relativa alla posizione della sonda. Sebbene il valore predefinito sia 0, 0, pu\u00f2 essere utile regolare l'origine nel tentativo di sondare una porzione pi\u00f9 ampia del letto. Vedi l'illustrazione qui sotto. round_probe_count: 5 Valore predefinito: 5 Questo \u00e8 un valore intero che definisce il numero massimo di punti sondati lungo gli assi X e Y. Per \"massimo\" si intende il numero di punti tastati lungo l'origine della mesh. Questo valore deve essere un numero dispari, in quanto \u00e8 necessario che venga sondato il centro della mesh. L'illustrazione seguente mostra come vengono generati i punti sondati. Come puoi vedere, l'impostazione di mesh_origin su (-10, 0) ci consente di specificare un raggio di mesh maggiore di 85. Configurazione avanzata \u00b6 Di seguito vengono spiegate in dettaglio le opzioni di configurazione pi\u00f9 avanzate. Ciascun esempio si baser\u00e0 sulla configurazione base del piatto rettangolare mostrata sopra. Ciascuna delle opzioni avanzate si applica allo stesso modo ai piatti rotondi. Interpolazione mesh \u00b6 Sebbene sia possibile campionare la matrice sondata direttamente utilizzando una semplice interpolazione bilineare per determinare i valori Z tra i punti sondati, \u00e8 spesso utile interpolare punti extra utilizzando algoritmi di interpolazione pi\u00f9 avanzati per aumentare la densit\u00e0 della mesh. Questi algoritmi aggiungono curvatura alla mesh, tentando di simulare le propriet\u00e0 del materiale del piatto. Bed Mesh offre l'interpolazione lagrange e bicubica per ottenere questo risultato. [bed_mesh] speed: 120 horizontal_move_z: 5 mesh_min: 35, 6 mesh_max: 240, 198 probe_count: 5, 3 mesh_pps: 2, 3 algorithm: bicubic bicubic_tension: 0.2 mesh_pps: 2, 3 Valore predefinito: 2, 2 L'opzione mesh_pps \u00e8 un'abbreviazione per Mesh Points Per Segment. Questa opzione specifica quanti punti interpolare per ciascun segmento lungo gli assi X e Y. Considera un \"segmento\" come lo spazio tra ogni punto sondato. Come probe_count , mesh_pps \u00e8 specificato come una coppia di interi X, Y e pu\u00f2 anche essere specificato un singolo intero che viene applicato a entrambi gli assi. In questo esempio ci sono 4 segmenti lungo l'asse X e 2 segmenti lungo l'asse Y. Questo restituisce 8 punti interpolati lungo X, 6 punti interpolati lungo Y, che si traduce in una mesh 13x8. Si noti che se mesh_pps \u00e8 impostato su 0, l'interpolazione della mesh \u00e8 disabilitata e la matrice sondata verr\u00e0 campionata direttamente. algoritmo: lagrange Valore predefinito: lagrange L'algoritmo utilizzato per interpolare la mesh. Pu\u00f2 essere \"lagrange\" o \"bicubico\". L'interpolazione Lagrange \u00e8 limitata a 6 punti sondati poich\u00e9 tende a verificarsi l'oscillazione con un numero maggiore di campioni. L'interpolazione bicubica richiede un minimo di 4 punti sondati lungo ciascun asse, se vengono specificati meno di 4 punti, viene forzato il campionamento lagrange. Se mesh_pps \u00e8 impostato su 0, questo valore viene ignorato poich\u00e9 non viene eseguita alcuna interpolazione della mesh. bicubic_tension: 0.2 Valore predefinito: 0.2 Se l'opzione algorithm \u00e8 impostata su bicubic \u00e8 possibile specificare il valore della tensione. Maggiore \u00e8 la tensione, maggiore \u00e8 la pendenza interpolata. Prestare attenzione durante la regolazione, poich\u00e9 valori pi\u00f9 elevati creano anche una maggiore sovraelongazione, che risulter\u00e0 in valori interpolati superiori o inferiori rispetto ai punti rilevati. L'illustrazione seguente mostra come vengono utilizzate le opzioni precedenti per generare una mesh interpolata. Divisione dei movimenti \u00b6 Bed Mesh funziona intercettando i comandi di spostamento di gcode e applicando una trasformazione alla loro coordinata Z. I movimenti lunghi devono essere suddivisi in movimenti pi\u00f9 piccoli per seguire correttamente la forma del piatto. Le opzioni seguenti controllano il comportamento di divisione. [bed_mesh] speed: 120 horizontal_move_z: 5 mesh_min: 35, 6 mesh_max: 240, 198 probe_count: 5, 3 move_check_distance: 5 split_delta_z: .025 move_check_distance: 5 Valore predefinito: 5 La distanza minima per verificare la modifica desiderata in Z prima di eseguire una divisione. In questo esempio, un movimento pi\u00f9 lungo di 5 mm verr\u00e0 eseguito dall'algoritmo. Ogni 5 mm si verificher\u00e0 una ricerca Z della mesh, confrontandola con il valore Z del movimento precedente. Se il delta raggiunge la soglia impostata da split_delta_z , il movimento sar\u00e0 diviso e l'attraversamento continuer\u00e0. Questo processo si ripete fino al raggiungimento della fine del movimento, dove verr\u00e0 applicato un aggiustamento finale. I movimenti pi\u00f9 brevi di move_check_distance hanno la correzione Z corretta applicata direttamente alla mossa senza attraversamento o divisione. split_delta_z: .025 Valore predefinito: .025 Come accennato in precedenza, questa \u00e8 la deviazione minima richiesta per attivare una divisione del movimento. In questo esempio, qualsiasi valore Z con una deviazione +/- 0,025 mm attiver\u00e0 una divisione. Generalmente i valori di default per queste opzioni sono sufficienti, infatti il valore di default di 5mm per il move_check_distance potrebbe essere eccessivo. Tuttavia, un utente esperto potrebbe voler sperimentare queste opzioni nel tentativo di spremere un primo layer ottimale. Dissolvenza Mesh \u00b6 Quando la \"dissolvenza\" \u00e8 abilitata, la regolazione Z viene gradualmente eliminata su una distanza definita dalla configurazione. Ci\u00f2 si ottiene applicando piccole regolazioni all'altezza dello strato, aumentando o diminuendo a seconda della forma del letto. Quando la dissolvenza \u00e8 completata, la regolazione Z non viene pi\u00f9 applicata, consentendo alla parte superiore della stampa di essere piatta anzich\u00e9 rispecchiare la forma del letto. La dissolvenza pu\u00f2 anche avere alcuni tratti indesiderati, se dissolve troppo rapidamente pu\u00f2 causare artefatti visibili sulla stampa. Inoltre, se il tuo letto \u00e8 notevolmente deformato, la dissolvenza pu\u00f2 ridurre o allungare l'altezza Z della stampa. In quanto tale, la dissolvenza \u00e8 disabilitata per impostazione predefinita. [bed_mesh] speed: 120 horizontal_move_z: 5 mesh_min: 35, 6 mesh_max: 240, 198 probe_count: 5, 3 fade_start: 1 fade_end: 10 fade_target: 0 fade_start: 1 Valore predefinito: 1 L'altezza Z in cui iniziare la regolazione graduale. \u00c8 una buona idea avere alcuni layer prima di iniziare il processo di dissolvenza. fade_end: 10 Valore predefinito: 0 L'altezza Z in cui deve essere completata la dissolvenza. Se questo valore \u00e8 inferiore a fade_start , la dissolvenza \u00e8 disabilitata. Questo valore pu\u00f2 essere regolato a seconda di quanto \u00e8 deformata la superficie di stampa. Una superficie notevolmente deformata dovrebbe dissolvere su una distanza maggiore. Una superficie quasi piatta potrebbe essere in grado di ridurre questo valore per eliminarlo gradualmente pi\u00f9 rapidamente. 10mm \u00e8 un valore ragionevole per cominciare se si utilizza il valore predefinito di 1 per fade_start . fade_target: 0 Valore predefinito: il valore Z medio della mesh Il fade_target pu\u00f2 essere pensato come un offset Z aggiuntivo applicato all'intero letto dopo il completamento della dissolvenza. In generale, vorremmo che questo valore fosse 0, tuttavia ci sono circostanze in cui non dovrebbe essere. Ad esempio, supponiamo che la tua posizione di riferimento sul letto sia un valore anomalo, 0,2 mm inferiore all'altezza media rilevata del letto. Se fade_target \u00e8 0, la dissolvenza ridurr\u00e0 la stampa di una media di 0,2 mm sul letto. Impostando fade_target su .2, l'area homed si espander\u00e0 di .2 mm, tuttavia il resto del letto avr\u00e0 una dimensione precisa. Generalmente \u00e8 una buona idea lasciare fade_target fuori dalla configurazione in modo che venga utilizzata l'altezza media della mesh, tuttavia potrebbe essere desiderabile regolare manualmente il target di dissolvenza se si desidera stampare su una parte specifica del letto. L'Indice di Riferimento Relativo \u00b6 La maggior parte delle sonde \u00e8 suscettibile alla deriva, cio\u00e8: imprecisioni nel sondaggio introdotte da calore o interferenza. Ci\u00f2 pu\u00f2 rendere difficile il calcolo dell'offset z della sonda, in particolare a diverse temperature del letto. In quanto tali, alcune stampanti utilizzano un fine corsa per l'homing dell'asse Z e una sonda per calibrare la mesh. Queste stampanti possono trarre vantaggio dalla configurazione del relativo indice di riferimento. [bed_mesh] speed: 120 horizontal_move_z: 5 mesh_min: 35, 6 mesh_max: 240, 198 probe_count: 5, 3 relative_reference_index: 7 relative_reference_index: 7 Valore predefinito: Nessuno (disabilitato) Quando i punti sondati vengono generati, a ciascuno viene assegnato un indice. Puoi cercare questo indice in klippy.log o usando BED_MESH_OUTPUT (vedi la sezione sui GCodes Bed Mesh di seguito per maggiori informazioni). Se si assegna un indice all'opzione relative_reference_index , il valore rilevato a questa coordinata sostituir\u00e0 lo z_offset del probe. Questo rende effettivamente questa coordinata il riferimento \"zero\" per la mesh. Quando si utilizza l'indice di riferimento relativo, \u00e8 necessario scegliere l'indice pi\u00f9 vicino al punto sul letto in cui \u00e8 stata eseguita la calibrazione del fine corsa Z. Nota che quando cerchi l'indice usando il log o BED_MESH_OUTPUT, dovresti usare le coordinate elencate sotto l'intestazione \"Probe\" per trovare l'indice corretto. Regioni difettose \u00b6 \u00c8 possibile che alcune aree di un piatto riportino risultati imprecisi durante il sondaggio a causa di un \"guasto\" in punti specifici. Il miglior esempio di ci\u00f2 sono i piatti con serie di magneti integrati utilizzati per trattenere le lamiere di acciaio rimovibili. Il campo magnetico su e intorno a questi magneti pu\u00f2 causare l'attivazione di una sonda induttiva a una distanza maggiore o minore di quanto sarebbe altrimenti, risultando in una mesh che non rappresenta accuratamente la superficie in queste posizioni. Nota: questo non deve essere confuso con la distorsione della posizione della sonda, che produce risultati imprecisi sull'intero letto. Le opzioni faulty_region possono essere configurate per compensare questo effetto. Se un punto generato si trova all'interno di una regione difettosa, la mesh del letto tenter\u00e0 di sondare fino a 4 punti ai confini di questa regione. Questi valori sondati verranno mediati e inseriti nella mesh come valore Z alla coordinata generata (X, Y). [bed_mesh] speed: 120 horizontal_move_z: 5 mesh_min: 35, 6 mesh_max: 240, 198 probe_count: 5, 3 faulty_region_1_min: 130.0, 0.0 faulty_region_1_max: 145.0, 40.0 faulty_region_2_min: 225.0, 0.0 faulty_region_2_max: 250.0, 25.0 faulty_region_3_min: 165.0, 95.0 faulty_region_3_max: 205.0, 110.0 faulty_region_4_min: 30.0, 170.0 faulty_region_4_max: 45.0, 210.0 faulty_region_{1...99}_min faulty_region_{1..99}_max Valore predefinito: Nessuno (disabilitato) Le regioni difettose sono definite in modo simile a quello della mesh stessa, dove minimo e massimo (X , Y) delle coordinate devono essere specificate per ciascuna regione. Una regione difettosa pu\u00f2 estendersi al di fuori di una mesh, tuttavia i punti alternativi generati saranno sempre all'interno del confine della mesh. Non possono sovrapporsi due regioni. L'immagine seguente illustra come vengono generati i punti di sostituzione quando un punto generato si trova all'interno di una regione difettosa. Le regioni mostrate corrispondono a quelle nella configurazione di esempio sopra. I punti di sostituzione e le relative coordinate sono identificati in verde. GCodes della mesh del piatto \u00b6 Calibrazione \u00b6 BED_MESH_CALIBRATE PROFILE=<nome> METHOD=[manuale | automatico] [<parametro_sonda>=<valore>] [<mesh_parameter>=<valore>] Profilo predefinito: default Metodo predefinito: automatico se viene rilevata una sonda, altrimenti manuale Avvia la procedura di sondaggio per la calibrazione della mesh del piatto. La mesh verr\u00e0 salvata in un profilo specificato dal parametro PROFILE , o default se non specificato. Se viene selezionato METHOD=manual , si verificher\u00e0 il rilevamento manuale. Quando si passa dal probing automatico a quello manuale, i punti mesh generati verranno regolati automaticamente. \u00c8 possibile specificare parametri mesh per modificare l'area sondata. Sono disponibili i seguenti parametri: Piatti rettangolari (cartesiani): MESH_MIN MESH_MAX PROBE_COUNT Piatti rotondi (delta): MESH_RADIUS MESH_ORIGIN ROUND_PROBE_COUNT Tutti i piatti: RELATIVE_REFERNCE_INDEX ALGORITHM Vedere la documentazione di configurazione sopra per i dettagli su come ogni parametro si applica alla mesh. Profili \u00b6 BED_MESH_PROFILE SAVE=<name> LOAD=<name> REMOVE=<name> Dopo aver eseguito un BED_MESH_CALIBRATE, \u00e8 possibile salvare lo stato della mesh corrente in un profilo denominato. Ci\u00f2 consente di caricare una mesh senza risondare il piatto. Dopo che un profilo \u00e8 stato salvato usando BED_MESH_PROFILE SAVE=<nome> \u00e8 possibile eseguire il gcode SAVE_CONFIG per scrivere il profilo su printer.cfg. I profili possono essere caricati eseguendo BED_MESH_PROFILE LOAD=<name> . Va notato che ogni volta che si verifica un BED_MESH_CALIBRATE, lo stato corrente viene automaticamente salvato nel profilo predefinito . Se questo profilo esiste, viene caricato automaticamente all'avvio di Klipper. Se questo comportamento non \u00e8 desiderabile, il profilo predefinito pu\u00f2 essere rimosso come segue: BED_MESH_PROFILE REMOVE=default Qualsiasi altro profilo salvato pu\u00f2 essere rimosso allo stesso modo, sostituendo default con il nome del profilo che desideri rimuovere. Caricamento del profilo predefinito \u00b6 Le versioni precedenti di bed_mesh caricavano sempre il profilo denominato default all'avvio se era presente. Questo comportamento \u00e8 stato rimosso per consentire all'utente di determinare quando viene caricato un profilo. Se un utente desidera caricare il profilo predefinito , si consiglia di aggiungere BED_MESH_PROFILE LOAD=default alla macro START_PRINT o alla configurazione \"Start G-Code\" del proprio slicer, a seconda di quale sia applicabile. In alternativa, il vecchio comportamento di caricamento di un profilo all'avvio pu\u00f2 essere ripristinato con un [delayed_gcode] : [delayed_gcode bed_mesh_init] initial_duration : .01 gcode : BED_MESH_PROFILE LOAD = default Output \u00b6 BED_MESH_OUTPUT PGP=[0 | 1] Invia lo stato della mesh corrente al terminale. Si noti che viene emessa la mesh stessa Il parametro PGP \u00e8 un'abbreviazione per \"Print Generated Points\". Se \u00e8 impostato PGP=1 , i punti sondati generati verranno inviati al terminale: // bed_mesh: generated points // Index | Tool Adjusted | Probe // 0 | (11.0, 1.0) | (35.0, 6.0) // 1 | (62.2, 1.0) | (86.2, 6.0) // 2 | (113.5, 1.0) | (137.5, 6.0) // 3 | (164.8, 1.0) | (188.8, 6.0) // 4 | (216.0, 1.0) | (240.0, 6.0) // 5 | (216.0, 97.0) | (240.0, 102.0) // 6 | (164.8, 97.0) | (188.8, 102.0) // 7 | (113.5, 97.0) | (137.5, 102.0) // 8 | (62.2, 97.0) | (86.2, 102.0) // 9 | (11.0, 97.0) | (35.0, 102.0) // 10 | (11.0, 193.0) | (35.0, 198.0) // 11 | (62.2, 193.0) | (86.2, 198.0) // 12 | (113.5, 193.0) | (137.5, 198.0) // 13 | (164.8, 193.0) | (188.8, 198.0) // 14 | (216.0, 193.0) | (240.0, 198.0) I punti \"Tool Adjusted\" si riferiscono alla posizione dell'ugello per ciascun punto e i punti \"Probe\" si riferiscono alla posizione della sonda. Si noti che quando il probing \u00e8 manuale i punti \"sonda\" si riferiscono sia alla posizione dell'utensile che dell'ugello. Cancella stato mesh \u00b6 BED_MESH_CLEAR Questo gcode pu\u00f2 essere utilizzato per cancellare lo stato della mesh interna. Applicare gli offset X/Y \u00b6 BED_MESH_OFFSET [X=<value>] [Y=<value>] Ci\u00f2 \u00e8 utile per le stampanti con pi\u00f9 estrusori indipendenti, poich\u00e9 \u00e8 necessario un offset per produrre la corretta regolazione Z dopo un cambio utensile. Gli offset devono essere specificati rispetto all'estrusore primario. Vale a dire, \u00e8 necessario specificare un offset X positivo se l'estrusore secondario \u00e8 montato a destra dell'estrusore primario e un offset Y positivo se l'estrusore secondario \u00e8 montato \"dietro\" l'estrusore primario.","title":"Matrice del Piatto"},{"location":"Bed_Mesh.html#matrice-del-piatto","text":"Il modulo rete piatto (bed mesh) pu\u00f2 essere usato per compensare le irregolarit\u00e0 della superficie del piatto e per ottenere un primo strato migliore su tutto il piatto. Va notato che la correzione basata sul software non raggiunger\u00e0 risultati perfetti, pu\u00f2 solo approssimare la forma del piatto. Bed mesh inoltre non pu\u00f2 compensare i problemi meccanici ed elettrici. Se un asse \u00e8 obliquo o una sonda non \u00e8 accurata, il modulo Bed mesh non ricever\u00e0 risultati accurati dal processo di ispezione. Prima della calibrazione della mesh dovrai assicurarti che l'offset Z della tua sonda sia calibrato. Se si utilizza un fine corsa per l'homing Z, anche questo dovr\u00e0 essere calibrato. Per ulteriori informazioni, vedere Probe Calibrate e Z_ENDSTOP_CALIBRATE in Manual Level .","title":"Matrice del Piatto"},{"location":"Bed_Mesh.html#configurazione-base","text":"","title":"Configurazione base"},{"location":"Bed_Mesh.html#piatti-rettangolari","text":"Questo esempio presuppone una stampante con un piatto rettangolare di 250 mm x 220 mm e una sonda con un offset x di 24 mm e un offset y di 5 mm. [bed_mesh] speed: 120 horizontal_move_z: 5 mesh_min: 35, 6 mesh_max: 240, 198 probe_count: 5, 3 speed: 120 Valore predefinito: 50 La velocit\u00e0 con cui la testa di stampa si sposta tra i punti. horizontal_move_z: 5 Valore predefinito: 5 La coordinata Z a cui si solleva la sonda prima di spostarsi tra i punti. mesh_min: 35, 6 Richiesto La prima coordinata rilevata, pi\u00f9 vicina all'origine. Questa coordinata \u00e8 relativa alla posizione della sonda. mesh_max: 240, 198 Richiesto La coordinata rilevata pi\u00f9 lontana dall'origine. Questo non \u00e8 necessariamente l'ultimo punto sondato, poich\u00e9 il processo di rilevamento avviene a zig-zag. Come per mesh_min , questa coordinata \u00e8 relativa alla posizione della sonda. probe_count: 5, 3 Valore predefinito: 3, 3 Il numero di punti da sondare su ciascun asse, specificato come valori interi X, Y. In questo esempio verranno tastati 5 punti lungo l'asse X, con 3 punti lungo l'asse Y, per un totale di 15 punti tastati. Nota che se desideri una griglia quadrata, ad esempio 3x3, questo potrebbe essere specificato come un singolo valore intero che viene utilizzato per entrambi gli assi, ad esempio probe_count: 3 . Si noti che una mesh richiede un probe_count minimo di 3 lungo ciascun asse. L'illustrazione seguente mostra come le opzioni mesh_min , mesh_max e probe_count vengono utilizzate per generare punti sonda. Le frecce indicano la direzione della procedura di probing, a partire da mesh_min . Per riferimento, quando la sonda \u00e8 a mesh_min , l'ugello sar\u00e0 a (11, 1), e quando la sonda \u00e8 a mesh_max , l'ugello sar\u00e0 a (206, 193).","title":"Piatti rettangolari"},{"location":"Bed_Mesh.html#piatti-rotondi","text":"Questo esempio presuppone una stampante dotata di un raggio del piatto rotondo di 100 mm. Utilizzeremo gli stessi offset della sonda dell'esempio rettangolare, 24 mm su X e 5 mm su Y. [bed_mesh] speed: 120 horizontal_move_z: 5 mesh_radius: 75 mesh_origin: 0, 0 round_probe_count: 5 mesh_radius: 75 Obbligatorio Il raggio della mesh sondata in mm, relativo a mesh_origin . Si noti che gli offset della sonda limitano la dimensione del raggio della mesh. In questo esempio, un raggio maggiore di 76 sposterebbe lo strumento oltre il range della stampante. mesh_origin: 0, 0 Valore predefinito: 0, 0 Il punto centrale della mesh. Questa coordinata \u00e8 relativa alla posizione della sonda. Sebbene il valore predefinito sia 0, 0, pu\u00f2 essere utile regolare l'origine nel tentativo di sondare una porzione pi\u00f9 ampia del letto. Vedi l'illustrazione qui sotto. round_probe_count: 5 Valore predefinito: 5 Questo \u00e8 un valore intero che definisce il numero massimo di punti sondati lungo gli assi X e Y. Per \"massimo\" si intende il numero di punti tastati lungo l'origine della mesh. Questo valore deve essere un numero dispari, in quanto \u00e8 necessario che venga sondato il centro della mesh. L'illustrazione seguente mostra come vengono generati i punti sondati. Come puoi vedere, l'impostazione di mesh_origin su (-10, 0) ci consente di specificare un raggio di mesh maggiore di 85.","title":"Piatti rotondi"},{"location":"Bed_Mesh.html#configurazione-avanzata","text":"Di seguito vengono spiegate in dettaglio le opzioni di configurazione pi\u00f9 avanzate. Ciascun esempio si baser\u00e0 sulla configurazione base del piatto rettangolare mostrata sopra. Ciascuna delle opzioni avanzate si applica allo stesso modo ai piatti rotondi.","title":"Configurazione avanzata"},{"location":"Bed_Mesh.html#interpolazione-mesh","text":"Sebbene sia possibile campionare la matrice sondata direttamente utilizzando una semplice interpolazione bilineare per determinare i valori Z tra i punti sondati, \u00e8 spesso utile interpolare punti extra utilizzando algoritmi di interpolazione pi\u00f9 avanzati per aumentare la densit\u00e0 della mesh. Questi algoritmi aggiungono curvatura alla mesh, tentando di simulare le propriet\u00e0 del materiale del piatto. Bed Mesh offre l'interpolazione lagrange e bicubica per ottenere questo risultato. [bed_mesh] speed: 120 horizontal_move_z: 5 mesh_min: 35, 6 mesh_max: 240, 198 probe_count: 5, 3 mesh_pps: 2, 3 algorithm: bicubic bicubic_tension: 0.2 mesh_pps: 2, 3 Valore predefinito: 2, 2 L'opzione mesh_pps \u00e8 un'abbreviazione per Mesh Points Per Segment. Questa opzione specifica quanti punti interpolare per ciascun segmento lungo gli assi X e Y. Considera un \"segmento\" come lo spazio tra ogni punto sondato. Come probe_count , mesh_pps \u00e8 specificato come una coppia di interi X, Y e pu\u00f2 anche essere specificato un singolo intero che viene applicato a entrambi gli assi. In questo esempio ci sono 4 segmenti lungo l'asse X e 2 segmenti lungo l'asse Y. Questo restituisce 8 punti interpolati lungo X, 6 punti interpolati lungo Y, che si traduce in una mesh 13x8. Si noti che se mesh_pps \u00e8 impostato su 0, l'interpolazione della mesh \u00e8 disabilitata e la matrice sondata verr\u00e0 campionata direttamente. algoritmo: lagrange Valore predefinito: lagrange L'algoritmo utilizzato per interpolare la mesh. Pu\u00f2 essere \"lagrange\" o \"bicubico\". L'interpolazione Lagrange \u00e8 limitata a 6 punti sondati poich\u00e9 tende a verificarsi l'oscillazione con un numero maggiore di campioni. L'interpolazione bicubica richiede un minimo di 4 punti sondati lungo ciascun asse, se vengono specificati meno di 4 punti, viene forzato il campionamento lagrange. Se mesh_pps \u00e8 impostato su 0, questo valore viene ignorato poich\u00e9 non viene eseguita alcuna interpolazione della mesh. bicubic_tension: 0.2 Valore predefinito: 0.2 Se l'opzione algorithm \u00e8 impostata su bicubic \u00e8 possibile specificare il valore della tensione. Maggiore \u00e8 la tensione, maggiore \u00e8 la pendenza interpolata. Prestare attenzione durante la regolazione, poich\u00e9 valori pi\u00f9 elevati creano anche una maggiore sovraelongazione, che risulter\u00e0 in valori interpolati superiori o inferiori rispetto ai punti rilevati. L'illustrazione seguente mostra come vengono utilizzate le opzioni precedenti per generare una mesh interpolata.","title":"Interpolazione mesh"},{"location":"Bed_Mesh.html#divisione-dei-movimenti","text":"Bed Mesh funziona intercettando i comandi di spostamento di gcode e applicando una trasformazione alla loro coordinata Z. I movimenti lunghi devono essere suddivisi in movimenti pi\u00f9 piccoli per seguire correttamente la forma del piatto. Le opzioni seguenti controllano il comportamento di divisione. [bed_mesh] speed: 120 horizontal_move_z: 5 mesh_min: 35, 6 mesh_max: 240, 198 probe_count: 5, 3 move_check_distance: 5 split_delta_z: .025 move_check_distance: 5 Valore predefinito: 5 La distanza minima per verificare la modifica desiderata in Z prima di eseguire una divisione. In questo esempio, un movimento pi\u00f9 lungo di 5 mm verr\u00e0 eseguito dall'algoritmo. Ogni 5 mm si verificher\u00e0 una ricerca Z della mesh, confrontandola con il valore Z del movimento precedente. Se il delta raggiunge la soglia impostata da split_delta_z , il movimento sar\u00e0 diviso e l'attraversamento continuer\u00e0. Questo processo si ripete fino al raggiungimento della fine del movimento, dove verr\u00e0 applicato un aggiustamento finale. I movimenti pi\u00f9 brevi di move_check_distance hanno la correzione Z corretta applicata direttamente alla mossa senza attraversamento o divisione. split_delta_z: .025 Valore predefinito: .025 Come accennato in precedenza, questa \u00e8 la deviazione minima richiesta per attivare una divisione del movimento. In questo esempio, qualsiasi valore Z con una deviazione +/- 0,025 mm attiver\u00e0 una divisione. Generalmente i valori di default per queste opzioni sono sufficienti, infatti il valore di default di 5mm per il move_check_distance potrebbe essere eccessivo. Tuttavia, un utente esperto potrebbe voler sperimentare queste opzioni nel tentativo di spremere un primo layer ottimale.","title":"Divisione dei movimenti"},{"location":"Bed_Mesh.html#dissolvenza-mesh","text":"Quando la \"dissolvenza\" \u00e8 abilitata, la regolazione Z viene gradualmente eliminata su una distanza definita dalla configurazione. Ci\u00f2 si ottiene applicando piccole regolazioni all'altezza dello strato, aumentando o diminuendo a seconda della forma del letto. Quando la dissolvenza \u00e8 completata, la regolazione Z non viene pi\u00f9 applicata, consentendo alla parte superiore della stampa di essere piatta anzich\u00e9 rispecchiare la forma del letto. La dissolvenza pu\u00f2 anche avere alcuni tratti indesiderati, se dissolve troppo rapidamente pu\u00f2 causare artefatti visibili sulla stampa. Inoltre, se il tuo letto \u00e8 notevolmente deformato, la dissolvenza pu\u00f2 ridurre o allungare l'altezza Z della stampa. In quanto tale, la dissolvenza \u00e8 disabilitata per impostazione predefinita. [bed_mesh] speed: 120 horizontal_move_z: 5 mesh_min: 35, 6 mesh_max: 240, 198 probe_count: 5, 3 fade_start: 1 fade_end: 10 fade_target: 0 fade_start: 1 Valore predefinito: 1 L'altezza Z in cui iniziare la regolazione graduale. \u00c8 una buona idea avere alcuni layer prima di iniziare il processo di dissolvenza. fade_end: 10 Valore predefinito: 0 L'altezza Z in cui deve essere completata la dissolvenza. Se questo valore \u00e8 inferiore a fade_start , la dissolvenza \u00e8 disabilitata. Questo valore pu\u00f2 essere regolato a seconda di quanto \u00e8 deformata la superficie di stampa. Una superficie notevolmente deformata dovrebbe dissolvere su una distanza maggiore. Una superficie quasi piatta potrebbe essere in grado di ridurre questo valore per eliminarlo gradualmente pi\u00f9 rapidamente. 10mm \u00e8 un valore ragionevole per cominciare se si utilizza il valore predefinito di 1 per fade_start . fade_target: 0 Valore predefinito: il valore Z medio della mesh Il fade_target pu\u00f2 essere pensato come un offset Z aggiuntivo applicato all'intero letto dopo il completamento della dissolvenza. In generale, vorremmo che questo valore fosse 0, tuttavia ci sono circostanze in cui non dovrebbe essere. Ad esempio, supponiamo che la tua posizione di riferimento sul letto sia un valore anomalo, 0,2 mm inferiore all'altezza media rilevata del letto. Se fade_target \u00e8 0, la dissolvenza ridurr\u00e0 la stampa di una media di 0,2 mm sul letto. Impostando fade_target su .2, l'area homed si espander\u00e0 di .2 mm, tuttavia il resto del letto avr\u00e0 una dimensione precisa. Generalmente \u00e8 una buona idea lasciare fade_target fuori dalla configurazione in modo che venga utilizzata l'altezza media della mesh, tuttavia potrebbe essere desiderabile regolare manualmente il target di dissolvenza se si desidera stampare su una parte specifica del letto.","title":"Dissolvenza Mesh"},{"location":"Bed_Mesh.html#lindice-di-riferimento-relativo","text":"La maggior parte delle sonde \u00e8 suscettibile alla deriva, cio\u00e8: imprecisioni nel sondaggio introdotte da calore o interferenza. Ci\u00f2 pu\u00f2 rendere difficile il calcolo dell'offset z della sonda, in particolare a diverse temperature del letto. In quanto tali, alcune stampanti utilizzano un fine corsa per l'homing dell'asse Z e una sonda per calibrare la mesh. Queste stampanti possono trarre vantaggio dalla configurazione del relativo indice di riferimento. [bed_mesh] speed: 120 horizontal_move_z: 5 mesh_min: 35, 6 mesh_max: 240, 198 probe_count: 5, 3 relative_reference_index: 7 relative_reference_index: 7 Valore predefinito: Nessuno (disabilitato) Quando i punti sondati vengono generati, a ciascuno viene assegnato un indice. Puoi cercare questo indice in klippy.log o usando BED_MESH_OUTPUT (vedi la sezione sui GCodes Bed Mesh di seguito per maggiori informazioni). Se si assegna un indice all'opzione relative_reference_index , il valore rilevato a questa coordinata sostituir\u00e0 lo z_offset del probe. Questo rende effettivamente questa coordinata il riferimento \"zero\" per la mesh. Quando si utilizza l'indice di riferimento relativo, \u00e8 necessario scegliere l'indice pi\u00f9 vicino al punto sul letto in cui \u00e8 stata eseguita la calibrazione del fine corsa Z. Nota che quando cerchi l'indice usando il log o BED_MESH_OUTPUT, dovresti usare le coordinate elencate sotto l'intestazione \"Probe\" per trovare l'indice corretto.","title":"L'Indice di Riferimento Relativo"},{"location":"Bed_Mesh.html#regioni-difettose","text":"\u00c8 possibile che alcune aree di un piatto riportino risultati imprecisi durante il sondaggio a causa di un \"guasto\" in punti specifici. Il miglior esempio di ci\u00f2 sono i piatti con serie di magneti integrati utilizzati per trattenere le lamiere di acciaio rimovibili. Il campo magnetico su e intorno a questi magneti pu\u00f2 causare l'attivazione di una sonda induttiva a una distanza maggiore o minore di quanto sarebbe altrimenti, risultando in una mesh che non rappresenta accuratamente la superficie in queste posizioni. Nota: questo non deve essere confuso con la distorsione della posizione della sonda, che produce risultati imprecisi sull'intero letto. Le opzioni faulty_region possono essere configurate per compensare questo effetto. Se un punto generato si trova all'interno di una regione difettosa, la mesh del letto tenter\u00e0 di sondare fino a 4 punti ai confini di questa regione. Questi valori sondati verranno mediati e inseriti nella mesh come valore Z alla coordinata generata (X, Y). [bed_mesh] speed: 120 horizontal_move_z: 5 mesh_min: 35, 6 mesh_max: 240, 198 probe_count: 5, 3 faulty_region_1_min: 130.0, 0.0 faulty_region_1_max: 145.0, 40.0 faulty_region_2_min: 225.0, 0.0 faulty_region_2_max: 250.0, 25.0 faulty_region_3_min: 165.0, 95.0 faulty_region_3_max: 205.0, 110.0 faulty_region_4_min: 30.0, 170.0 faulty_region_4_max: 45.0, 210.0 faulty_region_{1...99}_min faulty_region_{1..99}_max Valore predefinito: Nessuno (disabilitato) Le regioni difettose sono definite in modo simile a quello della mesh stessa, dove minimo e massimo (X , Y) delle coordinate devono essere specificate per ciascuna regione. Una regione difettosa pu\u00f2 estendersi al di fuori di una mesh, tuttavia i punti alternativi generati saranno sempre all'interno del confine della mesh. Non possono sovrapporsi due regioni. L'immagine seguente illustra come vengono generati i punti di sostituzione quando un punto generato si trova all'interno di una regione difettosa. Le regioni mostrate corrispondono a quelle nella configurazione di esempio sopra. I punti di sostituzione e le relative coordinate sono identificati in verde.","title":"Regioni difettose"},{"location":"Bed_Mesh.html#gcodes-della-mesh-del-piatto","text":"","title":"GCodes della mesh del piatto"},{"location":"Bed_Mesh.html#calibrazione","text":"BED_MESH_CALIBRATE PROFILE=<nome> METHOD=[manuale | automatico] [<parametro_sonda>=<valore>] [<mesh_parameter>=<valore>] Profilo predefinito: default Metodo predefinito: automatico se viene rilevata una sonda, altrimenti manuale Avvia la procedura di sondaggio per la calibrazione della mesh del piatto. La mesh verr\u00e0 salvata in un profilo specificato dal parametro PROFILE , o default se non specificato. Se viene selezionato METHOD=manual , si verificher\u00e0 il rilevamento manuale. Quando si passa dal probing automatico a quello manuale, i punti mesh generati verranno regolati automaticamente. \u00c8 possibile specificare parametri mesh per modificare l'area sondata. Sono disponibili i seguenti parametri: Piatti rettangolari (cartesiani): MESH_MIN MESH_MAX PROBE_COUNT Piatti rotondi (delta): MESH_RADIUS MESH_ORIGIN ROUND_PROBE_COUNT Tutti i piatti: RELATIVE_REFERNCE_INDEX ALGORITHM Vedere la documentazione di configurazione sopra per i dettagli su come ogni parametro si applica alla mesh.","title":"Calibrazione"},{"location":"Bed_Mesh.html#profili","text":"BED_MESH_PROFILE SAVE=<name> LOAD=<name> REMOVE=<name> Dopo aver eseguito un BED_MESH_CALIBRATE, \u00e8 possibile salvare lo stato della mesh corrente in un profilo denominato. Ci\u00f2 consente di caricare una mesh senza risondare il piatto. Dopo che un profilo \u00e8 stato salvato usando BED_MESH_PROFILE SAVE=<nome> \u00e8 possibile eseguire il gcode SAVE_CONFIG per scrivere il profilo su printer.cfg. I profili possono essere caricati eseguendo BED_MESH_PROFILE LOAD=<name> . Va notato che ogni volta che si verifica un BED_MESH_CALIBRATE, lo stato corrente viene automaticamente salvato nel profilo predefinito . Se questo profilo esiste, viene caricato automaticamente all'avvio di Klipper. Se questo comportamento non \u00e8 desiderabile, il profilo predefinito pu\u00f2 essere rimosso come segue: BED_MESH_PROFILE REMOVE=default Qualsiasi altro profilo salvato pu\u00f2 essere rimosso allo stesso modo, sostituendo default con il nome del profilo che desideri rimuovere.","title":"Profili"},{"location":"Bed_Mesh.html#caricamento-del-profilo-predefinito","text":"Le versioni precedenti di bed_mesh caricavano sempre il profilo denominato default all'avvio se era presente. Questo comportamento \u00e8 stato rimosso per consentire all'utente di determinare quando viene caricato un profilo. Se un utente desidera caricare il profilo predefinito , si consiglia di aggiungere BED_MESH_PROFILE LOAD=default alla macro START_PRINT o alla configurazione \"Start G-Code\" del proprio slicer, a seconda di quale sia applicabile. In alternativa, il vecchio comportamento di caricamento di un profilo all'avvio pu\u00f2 essere ripristinato con un [delayed_gcode] : [delayed_gcode bed_mesh_init] initial_duration : .01 gcode : BED_MESH_PROFILE LOAD = default","title":"Caricamento del profilo predefinito"},{"location":"Bed_Mesh.html#output","text":"BED_MESH_OUTPUT PGP=[0 | 1] Invia lo stato della mesh corrente al terminale. Si noti che viene emessa la mesh stessa Il parametro PGP \u00e8 un'abbreviazione per \"Print Generated Points\". Se \u00e8 impostato PGP=1 , i punti sondati generati verranno inviati al terminale: // bed_mesh: generated points // Index | Tool Adjusted | Probe // 0 | (11.0, 1.0) | (35.0, 6.0) // 1 | (62.2, 1.0) | (86.2, 6.0) // 2 | (113.5, 1.0) | (137.5, 6.0) // 3 | (164.8, 1.0) | (188.8, 6.0) // 4 | (216.0, 1.0) | (240.0, 6.0) // 5 | (216.0, 97.0) | (240.0, 102.0) // 6 | (164.8, 97.0) | (188.8, 102.0) // 7 | (113.5, 97.0) | (137.5, 102.0) // 8 | (62.2, 97.0) | (86.2, 102.0) // 9 | (11.0, 97.0) | (35.0, 102.0) // 10 | (11.0, 193.0) | (35.0, 198.0) // 11 | (62.2, 193.0) | (86.2, 198.0) // 12 | (113.5, 193.0) | (137.5, 198.0) // 13 | (164.8, 193.0) | (188.8, 198.0) // 14 | (216.0, 193.0) | (240.0, 198.0) I punti \"Tool Adjusted\" si riferiscono alla posizione dell'ugello per ciascun punto e i punti \"Probe\" si riferiscono alla posizione della sonda. Si noti che quando il probing \u00e8 manuale i punti \"sonda\" si riferiscono sia alla posizione dell'utensile che dell'ugello.","title":"Output"},{"location":"Bed_Mesh.html#cancella-stato-mesh","text":"BED_MESH_CLEAR Questo gcode pu\u00f2 essere utilizzato per cancellare lo stato della mesh interna.","title":"Cancella stato mesh"},{"location":"Bed_Mesh.html#applicare-gli-offset-xy","text":"BED_MESH_OFFSET [X=<value>] [Y=<value>] Ci\u00f2 \u00e8 utile per le stampanti con pi\u00f9 estrusori indipendenti, poich\u00e9 \u00e8 necessario un offset per produrre la corretta regolazione Z dopo un cambio utensile. Gli offset devono essere specificati rispetto all'estrusore primario. Vale a dire, \u00e8 necessario specificare un offset X positivo se l'estrusore secondario \u00e8 montato a destra dell'estrusore primario e un offset Y positivo se l'estrusore secondario \u00e8 montato \"dietro\" l'estrusore primario.","title":"Applicare gli offset X/Y"},{"location":"Benchmarks.html","text":"Benchmark \u00b6 Questo documento descrive i benchmark di Klipper. Benchmark del microcontrollore \u00b6 Questa sezione descrive il meccanismo utilizzato per generare i benchmark della velocit\u00e0 di passaggio del microcontrollore Klipper. L'obiettivo principale dei benchmark \u00e8 fornire un meccanismo coerente per misurare l'impatto delle modifiche alla codifica all'interno del software. Un obiettivo secondario \u00e8 fornire metriche di alto livello per confrontare le prestazioni tra i chip e tra le piattaforme software. Il benchmark dello step rate \u00e8 progettato per trovare la velocit\u00e0 di stepping massima che l'hardware e il software possono raggiungere. Questa velocit\u00e0 di stepping del benchmark non \u00e8 raggiungibile nell'uso quotidiano poich\u00e9 Klipper ha bisogno di eseguire altre attivit\u00e0 (ad esempio, comunicazione mcu/host, lettura della temperatura, controllo endstop) in qualsiasi utilizzo nel mondo reale. In generale, i pin per i test di benchmark sono scelti per far lampeggiare LED o altri pin innocui. Verifica sempre che sia sicuro guidare i pin configurati prima di eseguire un benchmark. Non \u00e8 consigliabile pilotare uno stepper reale durante un benchmark. Test di riferimento della frequenza di passi \u00b6 Il test viene eseguito utilizzando lo strumento console.py (descritto in ). Il microcontrollore \u00e8 configurato per la particolare piattaforma hardware (vedi sotto) e quindi quanto segue viene tagliato e incollato nella finestra del terminale console.py: SET start_clock {clock+freq} SET ticks 1000 reset_step_clock oid=0 clock={start_clock} set_next_step_dir oid=0 dir=0 queue_step oid=0 interval={ticks} count=60000 add=0 set_next_step_dir oid=0 dir=1 queue_step oid=0 interval=3000 count=1 add=0 reset_step_clock oid=1 clock={start_clock} set_next_step_dir oid=1 dir=0 queue_step oid=1 interval={ticks} count=60000 add=0 set_next_step_dir oid=1 dir=1 queue_step oid=1 interval=3000 count=1 add=0 reset_step_clock oid=2 clock={start_clock} set_next_step_dir oid=2 dir=0 queue_step oid=2 interval={ticks} count=60000 add=0 set_next_step_dir oid=2 dir=1 queue_step oid=2 interval=3000 count=1 add=0 Quanto sopra testa tre stepper che fanno un passo simultaneo. Se l'esecuzione di quanto sopra comporta un errore \"Rescheduled timer in the past\" o \"Stepper too far in past\", indica che il parametro ticks \u00e8 troppo basso (risulta in una velocit\u00e0 di incremento troppo veloce). L'obiettivo \u00e8 trovare l'impostazione pi\u00f9 bassa del parametro tick che si traduca in modo affidabile in un completamento positivo del test. Dovrebbe essere possibile dividere in due il parametro tick fino a trovare un valore stabile. In caso di errore, \u00e8 possibile copiare e incollare quanto segue per cancellare l'errore in preparazione per il test successivo: clear_shutdown Per ottenere i benchmark del singolo stepper, viene utilizzata la stessa sequenza di configurazione, ma solo il primo blocco del test precedente viene tagliato e incollato nella finestra di console.py. Per produrre i benchmark trovati nel documento Features , il numero totale di passi al secondo viene calcolato moltiplicando il numero di stepper attivi per la frequenza nominale mcu e dividendo per il parametro tick finale. I risultati vengono arrotondati alla K pi\u00f9 vicina. Ad esempio, con tre stepper attivi: ECHO Test result is: {\"%.0fK\" % (3. * freq / ticks / 1000.)} I benchmark vengono eseguiti con parametri adatti ai driver TMC. Per i microcontrollori che supportano STEPPER_BOTH_EDGE=1 (come riportato nella riga MCU config al primo avvio di console.py) usa step_pulse_duration=0 e invert_step=-1 per abilitare lo stepping ottimizzato su entrambi i bordi del impulso di passo. Per altri microcontrollori usa un step_pulse_duration corrispondente a 100ns. Benchmark rateo passi AVR \u00b6 La seguente sequenza di configurazione viene utilizzata sui chip AVR: allocate_oids count=3 config_stepper oid=0 step_pin=PA5 dir_pin=PA4 invert_step=0 step_pulse_ticks=32 config_stepper oid=1 step_pin=PA3 dir_pin=PA2 invert_step=0 step_pulse_ticks=32 config_stepper oid=2 step_pin=PC7 dir_pin=PC6 invert_step=0 step_pulse_ticks=32 finalize_config crc=0 Il test \u00e8 stato eseguito l'ultima volta su commit 59314d99 con versione gcc avr-gcc (GCC) 5.4.0 . Entrambi i test a 16Mhz e 20Mhz sono stati eseguiti utilizzando simulavr configurato per un atmega644p (i test precedenti hanno confermato i risultati del simulavr match test su entrambi un 16Mhz at90usb e un 16Mhz atmega2560). avr ticks 1 stepper 102 3 stepper 486 Benchmark rateo passi Arduino Due \u00b6 Sul Due viene utilizzata la seguente sequenza di configurazione: allocate_oids count=3 config_stepper oid=0 step_pin=PB27 dir_pin=PA21 invert_step=-1 step_pulse_ticks=0 config_stepper oid=1 step_pin=PB26 dir_pin=PC30 invert_step=-1 step_pulse_ticks=0 config_stepper oid=2 step_pin=PA21 dir_pin=PC30 invert_step=-1 step_pulse_ticks=0 finalize_config crc=0 Il test \u00e8 stato eseguito l'ultima volta su commit 59314d99 con versione gcc arm-none-eabi-gcc (Fedora 10.2.0-4.fc34) 10.2.0 . sam3x8e ticks 1 stepper 66 3 stepper 257 Benchmark step rate Duet Maestro \u00b6 La seguente sequenza di configurazione viene utilizzata su Duet Maestro: allocate_oids count=3 config_stepper oid=0 step_pin=PC26 dir_pin=PC18 invert_step=-1 step_pulse_ticks=0 config_stepper oid=1 step_pin=PC26 dir_pin=PA8 invert_step=-1 step_pulse_ticks=0 config_stepper oid=2 step_pin=PC26 dir_pin=PB4 invert_step=-1 step_pulse_ticks=0 finalize_config crc=0 Il test \u00e8 stato eseguito l'ultima volta su commit 59314d99 con versione gcc arm-none-eabi-gcc (Fedora 10.2.0-4.fc34) 10.2.0 . sam4s8c ticks 1 stepper 71 3 stepper 260 Benchmark step rate Duet Wifi \u00b6 La seguente sequenza di configurazione viene utilizzata su Duet Wifi: allocate_oids count=3 config_stepper oid=0 step_pin=PD6 dir_pin=PD11 invert_step=-1 step_pulse_ticks=0 config_stepper oid=1 step_pin=PD7 dir_pin=PD12 invert_step=-1 step_pulse_ticks=0 config_stepper oid=2 step_pin=PD8 dir_pin=PD13 invert_step=-1 step_pulse_ticks=0 finalize_config crc=0 Il test \u00e8 stato eseguito l'ultima volta su commit 59314d99 con gcc versione gcc versione 10.3.1 20210621 (rilascio) (GNU Arm Embedded Toolchain 10.3-2021.07) . sam4e8e ticks 1 stepper 48 3 stepper 215 Benchmark step rate Beaglebone PRU \u00b6 Sulla PRU viene utilizzata la seguente sequenza di configurazione: allocate_oids count=3 config_stepper oid=0 step_pin=gpio0_23 dir_pin=gpio1_12 invert_step=0 step_pulse_ticks=20 config_stepper oid=1 step_pin=gpio1_15 dir_pin=gpio0_26 invert_step=0 step_pulse_ticks=20 config_stepper oid=2 step_pin=gpio0_22 dir_pin=gpio2_1 invert_step=0 step_pulse_ticks=20 finalize_config crc=0 Il test \u00e8 stato eseguito l'ultima volta su commit 59314d99 con versione gcc pru-gcc (GCC) 8.0.0 20170530 (sperimentale) . pru ticks 1 stepper 231 3 stepper 847 Benchmark step rate STM32F042 \u00b6 La seguente sequenza di configurazione viene utilizzata sull'STM32F042: allocate_oids count=3 config_stepper oid=0 step_pin=PA1 dir_pin=PA2 invert_step=-1 step_pulse_ticks=0 config_stepper oid=1 step_pin=PA3 dir_pin=PA2 invert_step=-1 step_pulse_ticks=0 config_stepper oid=2 step_pin=PB8 dir_pin=PA2 invert_step=-1 step_pulse_ticks=0 finalize_config crc=0 Il test \u00e8 stato eseguito l'ultima volta su commit 59314d99 con versione gcc arm-none-eabi-gcc (Fedora 10.2.0-4.fc34) 10.2.0 . stm32f042 ticks 1 stepper 59 3 stepper 249 Benchmark step rate STM32F103 \u00b6 Sull'STM32F103 viene utilizzata la seguente sequenza di configurazione: allocate_oids count=3 config_stepper oid=0 step_pin=PC13 dir_pin=PB5 invert_step=-1 step_pulse_ticks=0 config_stepper oid=1 step_pin=PB3 dir_pin=PB6 invert_step=-1 step_pulse_ticks=0 config_stepper oid=2 step_pin=PA4 dir_pin=PB7 invert_step=-1 step_pulse_ticks=0 finalize_config crc=0 Il test \u00e8 stato eseguito l'ultima volta su commit 59314d99 con versione gcc arm-none-eabi-gcc (Fedora 10.2.0-4.fc34) 10.2.0 . stm32f103 ticks 1 stepper 61 3 stepper 264 Benchmark step rate STM32F4 \u00b6 Sull'STM32F4 viene utilizzata la seguente sequenza di configurazione: allocate_oids count=3 config_stepper oid=0 step_pin=PA5 dir_pin=PB5 invert_step=-1 step_pulse_ticks=0 config_stepper oid=1 step_pin=PB2 dir_pin=PB6 invert_step=-1 step_pulse_ticks=0 config_stepper oid=2 step_pin=PB3 dir_pin=PB7 invert_step=-1 step_pulse_ticks=0 finalize_config crc=0 Il test \u00e8 stato eseguito l'ultima volta su commit 59314d99 con versione gcc arm-none-eabi-gcc (Fedora 10.2.0-4.fc34) 10.2.0 . I risultati dell'STM32F407 sono stati ottenuti eseguendo un binario STM32F407 su un STM32F446 (e quindi utilizzando un clock a 168 Mhz). stm32f446 ticks 1 stepper 46 3 stepper 205 stm32f407 ticks 1 stepper 46 3 stepper 205 STM32H7 benchmark della velocit\u00e0 di step \u00b6 La seguente sequenza di configurazione viene utilizzata su un STM32H743VIT6: allocate_oids count=3 config_stepper oid=0 step_pin=PD4 dir_pin=PD3 invert_step=-1 step_pulse_ticks=0 config_stepper oid=1 step_pin=PA15 dir_pin=PA8 invert_step=-1 step_pulse_ticks=0 config_stepper oid=2 step_pin=PE2 dir_pin=PE3 invert_step=-1 step_pulse_ticks=0 finalize_config crc=0 Il test \u00e8 stato eseguito l'ultima volta su commit 00191b5c con versione gcc arm-none-eabi-gcc (15:8-2019-q3-1+b1) 8.3.1 20190703 (release) [gcc-8-branch revisione 273027] . stm32h7 ticks 1 stepper 44 3 stepper 198 Benchmark step rate STM32G0B1 \u00b6 Sull'STM32G0B1 viene utilizzata la seguente sequenza di configurazione: allocate_oids count=3 config_stepper oid=0 step_pin=PB13 dir_pin=PB12 invert_step=-1 step_pulse_ticks=0 config_stepper oid=1 step_pin=PB10 dir_pin=PB2 invert_step=-1 step_pulse_ticks=0 config_stepper oid=2 step_pin=PB0 dir_pin=PC5 invert_step=-1 step_pulse_ticks=0 finalize_config crc=0 Il test \u00e8 stato eseguito l'ultima volta su commit 247cd753 con versione gcc arm-none-eabi-gcc (Fedora 10.2.0-4.fc34) 10.2.0 . stm32g0b1 ticks 1 stepper 58 3 stepper 243 Benchmark step rate LPC176x \u00b6 La seguente sequenza di configurazione viene utilizzata sull'LPC176x: allocate_oids count=3 config_stepper oid=0 step_pin=P1.20 dir_pin=P1.18 invert_step=-1 step_pulse_ticks=0 config_stepper oid=1 step_pin=P1.21 dir_pin=P1.18 invert_step=-1 step_pulse_ticks=0 config_stepper oid=2 step_pin=P1.23 dir_pin=P1.18 invert_step=-1 step_pulse_ticks=0 finalize_config crc=0 Il test \u00e8 stato eseguito l'ultima volta su commit 59314d99 con versione gcc arm-none-eabi-gcc (Fedora 10.2.0-4.fc34) 10.2.0 . I risultati a 120 Mhz LPC1769 sono stati ottenuti overclockando un LPC1768 a 120 Mhz. lpc1768 ticks 1 stepper 52 3 stepper 222 lpc1769 ticks 1 stepper 51 3 stepper 222 Benchmark step rate SAMD21 \u00b6 La seguente sequenza di configurazione viene utilizzata sul SAMD21: allocate_oids count=3 config_stepper oid=0 step_pin=PA27 dir_pin=PA20 invert_step=-1 step_pulse_ticks=0 config_stepper oid=1 step_pin=PB3 dir_pin=PA21 invert_step=-1 step_pulse_ticks=0 config_stepper oid=2 step_pin=PA17 dir_pin=PA21 invert_step=-1 step_pulse_ticks=0 finalize_config crc=0 Il test \u00e8 stato eseguito l'ultima volta su commit 59314d99 con versione gcc arm-none-eabi-gcc (Fedora 10.2.0-4.fc34) 10.2.0 su un microcontrollore SAMD21G18. samd21 ticks 1 stepper 70 3 stepper 306 Benchmark step rate SAMD51 \u00b6 La seguente sequenza di configurazione viene utilizzata sul SAMD51: allocate_oids count=3 config_stepper oid=0 step_pin=PA22 dir_pin=PA20 invert_step=-1 step_pulse_ticks=0 config_stepper oid=1 step_pin=PA22 dir_pin=PA21 invert_step=-1 step_pulse_ticks=0 config_stepper oid=2 step_pin=PA22 dir_pin=PA19 invert_step=-1 step_pulse_ticks=0 finalize_config crc=0 Il test \u00e8 stato eseguito l'ultima volta su commit 59314d99 con versione gcc arm-none-eabi-gcc (Fedora 10.2.0-4.fc34) 10.2.0 su un microcontrollore SAMD51J19A. samd51 ticks 1 stepper 39 3 stepper 191 1 stepper (200Mhz) 39 3 stepper (200Mhz) 181 Benchmark step rate RP2040 \u00b6 Sull'RP2040 viene utilizzata la seguente sequenza di configurazione: allocate_oids count=3 config_stepper oid=0 step_pin=gpio25 dir_pin=gpio3 invert_step=-1 step_pulse_ticks=0 config_stepper oid=1 step_pin=gpio26 dir_pin=gpio4 invert_step=-1 step_pulse_ticks=0 config_stepper oid=2 step_pin=gpio27 dir_pin=gpio5 invert_step=-1 step_pulse_ticks=0 finalize_config crc=0 Il test \u00e8 stato eseguito l'ultima volta su commit 59314d99 con versione gcc arm-none-eabi-gcc (Fedora 10.2.0-4.fc34) 10.2.0 su una scheda Raspberry Pi Pico. rp2040 ticks 1 stepper 5 3 stepper 22 Benchmark step rate MCU Linux \u00b6 La seguente sequenza di configurazione viene utilizzata su un Raspberry Pi: allocate_oids count=3 config_stepper oid=0 step_pin=gpio2 dir_pin=gpio3 invert_step=0 step_pulse_ticks=5 config_stepper oid=1 step_pin=gpio4 dir_pin=gpio5 invert_step=0 step_pulse_ticks=5 config_stepper oid=2 step_pin=gpio6 dir_pin=gpio17 invert_step=0 step_pulse_ticks=5 finalize_config crc=0 Il test \u00e8 stato eseguito l'ultima volta su commit 59314d99 con versione gcc gcc (Raspbian 8.3.0-6+rpi1) 8.3.0 su un Raspberry Pi 3 (revisione a02082). \u00c8 stato difficile ottenere risultati stabili in questo benchmark. Linux (RPi3) ticks 1 stepper 160 3 stepper 380 Benchmark dispacciamento comandi \u00b6 Il benchmark di invio dei comandi verifica quanti comandi \"fittizi\" possono elaborare il microcontrollore. \u00c8 principalmente un test del meccanismo di comunicazione hardware. Il test viene eseguito utilizzando lo strumento console.py (descritto in ). Quanto segue \u00e8 taglia e incolla nella finestra del terminale console.py: DELAY {clock + 2*freq} get_uptime FLOOD 100000 0.0 debug_nop get_uptime Al termine del test, determinare la differenza tra gli orologi riportati nei due messaggi di risposta \"uptime\". Il numero totale di comandi al secondo \u00e8 quindi 100000 * mcu_frequency / clock_diff . Nota che questo test potrebbe saturare la capacit\u00e0 USB/CPU di un Raspberry Pi. Se \u00e8 in esecuzione su un computer host Raspberry Pi, Beaglebone o simile, aumenta il ritardo (ad esempio, DELAY {clock + 20*freq} get_uptime ). Ove applicabile, i benchmark seguenti riguardano console.py in esecuzione su una macchina di classe desktop con il dispositivo connesso tramite un hub ad alta velocit\u00e0. MCU Rateo Build Build compiler stm32f042 (CAN) 18K c105adc8 arm-none-eabi-gcc (GNU Tools 7-2018-q3-update) 7.3.1 atmega2560 (serial) 23K b161a69e avr-gcc (GCC) 4.8.1 sam3x8e (serial) 23K b161a69e arm-none-eabi-gcc (Fedora 7.1.0-5.fc27) 7.1.0 at90usb1286 (USB) 75K 01d2183f avr-gcc (GCC) 5.4.0 samd21 (USB) 223K 01d2183f arm-none-eabi-gcc (Fedora 7.4.0-1.fc30) 7.4.0 pru (shared memory) 260K c5968a08 pru-gcc (GCC) 8.0.0 20170530 (experimental) stm32f103 (USB) 355K 01d2183f arm-none-eabi-gcc (Fedora 7.4.0-1.fc30) 7.4.0 sam3x8e (USB) 418K 01d2183f arm-none-eabi-gcc (Fedora 7.4.0-1.fc30) 7.4.0 lpc1768 (USB) 534K 01d2183f arm-none-eabi-gcc (Fedora 7.4.0-1.fc30) 7.4.0 lpc1769 (USB) 628K 01d2183f arm-none-eabi-gcc (Fedora 7.4.0-1.fc30) 7.4.0 sam4s8c (USB) 650K 8d4a5c16 arm-none-eabi-gcc (Fedora 7.4.0-1.fc30) 7.4.0 samd51 (USB) 864K 01d2183f arm-none-eabi-gcc (Fedora 7.4.0-1.fc30) 7.4.0 stm32f446 (USB) 870K 01d2183f arm-none-eabi-gcc (Fedora 7.4.0-1.fc30) 7.4.0 rp2040 (USB) 873K c5667193 arm-none-eabi-gcc (Fedora 10.2.0-4.fc34) 10.2.0 Benchmark Host \u00b6 \u00c8 possibile eseguire test di temporizzazione sul software host utilizzando il meccanismo di elaborazione \"batch mode\" (descritto in ). Questo viene in genere fatto scegliendo un file G-Code grande e complesso e calcolando il tempo impiegato dal software host per elaborarlo. Per esempio: time ~/klippy-env/bin/python ./klippy/klippy.py config/example-cartesian.cfg -i something_complex.gcode -o /dev/null -d out/klipper.dict","title":"Benchmark"},{"location":"Benchmarks.html#benchmark","text":"Questo documento descrive i benchmark di Klipper.","title":"Benchmark"},{"location":"Benchmarks.html#benchmark-del-microcontrollore","text":"Questa sezione descrive il meccanismo utilizzato per generare i benchmark della velocit\u00e0 di passaggio del microcontrollore Klipper. L'obiettivo principale dei benchmark \u00e8 fornire un meccanismo coerente per misurare l'impatto delle modifiche alla codifica all'interno del software. Un obiettivo secondario \u00e8 fornire metriche di alto livello per confrontare le prestazioni tra i chip e tra le piattaforme software. Il benchmark dello step rate \u00e8 progettato per trovare la velocit\u00e0 di stepping massima che l'hardware e il software possono raggiungere. Questa velocit\u00e0 di stepping del benchmark non \u00e8 raggiungibile nell'uso quotidiano poich\u00e9 Klipper ha bisogno di eseguire altre attivit\u00e0 (ad esempio, comunicazione mcu/host, lettura della temperatura, controllo endstop) in qualsiasi utilizzo nel mondo reale. In generale, i pin per i test di benchmark sono scelti per far lampeggiare LED o altri pin innocui. Verifica sempre che sia sicuro guidare i pin configurati prima di eseguire un benchmark. Non \u00e8 consigliabile pilotare uno stepper reale durante un benchmark.","title":"Benchmark del microcontrollore"},{"location":"Benchmarks.html#test-di-riferimento-della-frequenza-di-passi","text":"Il test viene eseguito utilizzando lo strumento console.py (descritto in ). Il microcontrollore \u00e8 configurato per la particolare piattaforma hardware (vedi sotto) e quindi quanto segue viene tagliato e incollato nella finestra del terminale console.py: SET start_clock {clock+freq} SET ticks 1000 reset_step_clock oid=0 clock={start_clock} set_next_step_dir oid=0 dir=0 queue_step oid=0 interval={ticks} count=60000 add=0 set_next_step_dir oid=0 dir=1 queue_step oid=0 interval=3000 count=1 add=0 reset_step_clock oid=1 clock={start_clock} set_next_step_dir oid=1 dir=0 queue_step oid=1 interval={ticks} count=60000 add=0 set_next_step_dir oid=1 dir=1 queue_step oid=1 interval=3000 count=1 add=0 reset_step_clock oid=2 clock={start_clock} set_next_step_dir oid=2 dir=0 queue_step oid=2 interval={ticks} count=60000 add=0 set_next_step_dir oid=2 dir=1 queue_step oid=2 interval=3000 count=1 add=0 Quanto sopra testa tre stepper che fanno un passo simultaneo. Se l'esecuzione di quanto sopra comporta un errore \"Rescheduled timer in the past\" o \"Stepper too far in past\", indica che il parametro ticks \u00e8 troppo basso (risulta in una velocit\u00e0 di incremento troppo veloce). L'obiettivo \u00e8 trovare l'impostazione pi\u00f9 bassa del parametro tick che si traduca in modo affidabile in un completamento positivo del test. Dovrebbe essere possibile dividere in due il parametro tick fino a trovare un valore stabile. In caso di errore, \u00e8 possibile copiare e incollare quanto segue per cancellare l'errore in preparazione per il test successivo: clear_shutdown Per ottenere i benchmark del singolo stepper, viene utilizzata la stessa sequenza di configurazione, ma solo il primo blocco del test precedente viene tagliato e incollato nella finestra di console.py. Per produrre i benchmark trovati nel documento Features , il numero totale di passi al secondo viene calcolato moltiplicando il numero di stepper attivi per la frequenza nominale mcu e dividendo per il parametro tick finale. I risultati vengono arrotondati alla K pi\u00f9 vicina. Ad esempio, con tre stepper attivi: ECHO Test result is: {\"%.0fK\" % (3. * freq / ticks / 1000.)} I benchmark vengono eseguiti con parametri adatti ai driver TMC. Per i microcontrollori che supportano STEPPER_BOTH_EDGE=1 (come riportato nella riga MCU config al primo avvio di console.py) usa step_pulse_duration=0 e invert_step=-1 per abilitare lo stepping ottimizzato su entrambi i bordi del impulso di passo. Per altri microcontrollori usa un step_pulse_duration corrispondente a 100ns.","title":"Test di riferimento della frequenza di passi"},{"location":"Benchmarks.html#benchmark-rateo-passi-avr","text":"La seguente sequenza di configurazione viene utilizzata sui chip AVR: allocate_oids count=3 config_stepper oid=0 step_pin=PA5 dir_pin=PA4 invert_step=0 step_pulse_ticks=32 config_stepper oid=1 step_pin=PA3 dir_pin=PA2 invert_step=0 step_pulse_ticks=32 config_stepper oid=2 step_pin=PC7 dir_pin=PC6 invert_step=0 step_pulse_ticks=32 finalize_config crc=0 Il test \u00e8 stato eseguito l'ultima volta su commit 59314d99 con versione gcc avr-gcc (GCC) 5.4.0 . Entrambi i test a 16Mhz e 20Mhz sono stati eseguiti utilizzando simulavr configurato per un atmega644p (i test precedenti hanno confermato i risultati del simulavr match test su entrambi un 16Mhz at90usb e un 16Mhz atmega2560). avr ticks 1 stepper 102 3 stepper 486","title":"Benchmark rateo passi AVR"},{"location":"Benchmarks.html#benchmark-rateo-passi-arduino-due","text":"Sul Due viene utilizzata la seguente sequenza di configurazione: allocate_oids count=3 config_stepper oid=0 step_pin=PB27 dir_pin=PA21 invert_step=-1 step_pulse_ticks=0 config_stepper oid=1 step_pin=PB26 dir_pin=PC30 invert_step=-1 step_pulse_ticks=0 config_stepper oid=2 step_pin=PA21 dir_pin=PC30 invert_step=-1 step_pulse_ticks=0 finalize_config crc=0 Il test \u00e8 stato eseguito l'ultima volta su commit 59314d99 con versione gcc arm-none-eabi-gcc (Fedora 10.2.0-4.fc34) 10.2.0 . sam3x8e ticks 1 stepper 66 3 stepper 257","title":"Benchmark rateo passi Arduino Due"},{"location":"Benchmarks.html#benchmark-step-rate-duet-maestro","text":"La seguente sequenza di configurazione viene utilizzata su Duet Maestro: allocate_oids count=3 config_stepper oid=0 step_pin=PC26 dir_pin=PC18 invert_step=-1 step_pulse_ticks=0 config_stepper oid=1 step_pin=PC26 dir_pin=PA8 invert_step=-1 step_pulse_ticks=0 config_stepper oid=2 step_pin=PC26 dir_pin=PB4 invert_step=-1 step_pulse_ticks=0 finalize_config crc=0 Il test \u00e8 stato eseguito l'ultima volta su commit 59314d99 con versione gcc arm-none-eabi-gcc (Fedora 10.2.0-4.fc34) 10.2.0 . sam4s8c ticks 1 stepper 71 3 stepper 260","title":"Benchmark step rate Duet Maestro"},{"location":"Benchmarks.html#benchmark-step-rate-duet-wifi","text":"La seguente sequenza di configurazione viene utilizzata su Duet Wifi: allocate_oids count=3 config_stepper oid=0 step_pin=PD6 dir_pin=PD11 invert_step=-1 step_pulse_ticks=0 config_stepper oid=1 step_pin=PD7 dir_pin=PD12 invert_step=-1 step_pulse_ticks=0 config_stepper oid=2 step_pin=PD8 dir_pin=PD13 invert_step=-1 step_pulse_ticks=0 finalize_config crc=0 Il test \u00e8 stato eseguito l'ultima volta su commit 59314d99 con gcc versione gcc versione 10.3.1 20210621 (rilascio) (GNU Arm Embedded Toolchain 10.3-2021.07) . sam4e8e ticks 1 stepper 48 3 stepper 215","title":"Benchmark step rate Duet Wifi"},{"location":"Benchmarks.html#benchmark-step-rate-beaglebone-pru","text":"Sulla PRU viene utilizzata la seguente sequenza di configurazione: allocate_oids count=3 config_stepper oid=0 step_pin=gpio0_23 dir_pin=gpio1_12 invert_step=0 step_pulse_ticks=20 config_stepper oid=1 step_pin=gpio1_15 dir_pin=gpio0_26 invert_step=0 step_pulse_ticks=20 config_stepper oid=2 step_pin=gpio0_22 dir_pin=gpio2_1 invert_step=0 step_pulse_ticks=20 finalize_config crc=0 Il test \u00e8 stato eseguito l'ultima volta su commit 59314d99 con versione gcc pru-gcc (GCC) 8.0.0 20170530 (sperimentale) . pru ticks 1 stepper 231 3 stepper 847","title":"Benchmark step rate Beaglebone PRU"},{"location":"Benchmarks.html#benchmark-step-rate-stm32f042","text":"La seguente sequenza di configurazione viene utilizzata sull'STM32F042: allocate_oids count=3 config_stepper oid=0 step_pin=PA1 dir_pin=PA2 invert_step=-1 step_pulse_ticks=0 config_stepper oid=1 step_pin=PA3 dir_pin=PA2 invert_step=-1 step_pulse_ticks=0 config_stepper oid=2 step_pin=PB8 dir_pin=PA2 invert_step=-1 step_pulse_ticks=0 finalize_config crc=0 Il test \u00e8 stato eseguito l'ultima volta su commit 59314d99 con versione gcc arm-none-eabi-gcc (Fedora 10.2.0-4.fc34) 10.2.0 . stm32f042 ticks 1 stepper 59 3 stepper 249","title":"Benchmark step rate STM32F042"},{"location":"Benchmarks.html#benchmark-step-rate-stm32f103","text":"Sull'STM32F103 viene utilizzata la seguente sequenza di configurazione: allocate_oids count=3 config_stepper oid=0 step_pin=PC13 dir_pin=PB5 invert_step=-1 step_pulse_ticks=0 config_stepper oid=1 step_pin=PB3 dir_pin=PB6 invert_step=-1 step_pulse_ticks=0 config_stepper oid=2 step_pin=PA4 dir_pin=PB7 invert_step=-1 step_pulse_ticks=0 finalize_config crc=0 Il test \u00e8 stato eseguito l'ultima volta su commit 59314d99 con versione gcc arm-none-eabi-gcc (Fedora 10.2.0-4.fc34) 10.2.0 . stm32f103 ticks 1 stepper 61 3 stepper 264","title":"Benchmark step rate STM32F103"},{"location":"Benchmarks.html#benchmark-step-rate-stm32f4","text":"Sull'STM32F4 viene utilizzata la seguente sequenza di configurazione: allocate_oids count=3 config_stepper oid=0 step_pin=PA5 dir_pin=PB5 invert_step=-1 step_pulse_ticks=0 config_stepper oid=1 step_pin=PB2 dir_pin=PB6 invert_step=-1 step_pulse_ticks=0 config_stepper oid=2 step_pin=PB3 dir_pin=PB7 invert_step=-1 step_pulse_ticks=0 finalize_config crc=0 Il test \u00e8 stato eseguito l'ultima volta su commit 59314d99 con versione gcc arm-none-eabi-gcc (Fedora 10.2.0-4.fc34) 10.2.0 . I risultati dell'STM32F407 sono stati ottenuti eseguendo un binario STM32F407 su un STM32F446 (e quindi utilizzando un clock a 168 Mhz). stm32f446 ticks 1 stepper 46 3 stepper 205 stm32f407 ticks 1 stepper 46 3 stepper 205","title":"Benchmark step rate STM32F4"},{"location":"Benchmarks.html#stm32h7-benchmark-della-velocita-di-step","text":"La seguente sequenza di configurazione viene utilizzata su un STM32H743VIT6: allocate_oids count=3 config_stepper oid=0 step_pin=PD4 dir_pin=PD3 invert_step=-1 step_pulse_ticks=0 config_stepper oid=1 step_pin=PA15 dir_pin=PA8 invert_step=-1 step_pulse_ticks=0 config_stepper oid=2 step_pin=PE2 dir_pin=PE3 invert_step=-1 step_pulse_ticks=0 finalize_config crc=0 Il test \u00e8 stato eseguito l'ultima volta su commit 00191b5c con versione gcc arm-none-eabi-gcc (15:8-2019-q3-1+b1) 8.3.1 20190703 (release) [gcc-8-branch revisione 273027] . stm32h7 ticks 1 stepper 44 3 stepper 198","title":"STM32H7 benchmark della velocit\u00e0 di step"},{"location":"Benchmarks.html#benchmark-step-rate-stm32g0b1","text":"Sull'STM32G0B1 viene utilizzata la seguente sequenza di configurazione: allocate_oids count=3 config_stepper oid=0 step_pin=PB13 dir_pin=PB12 invert_step=-1 step_pulse_ticks=0 config_stepper oid=1 step_pin=PB10 dir_pin=PB2 invert_step=-1 step_pulse_ticks=0 config_stepper oid=2 step_pin=PB0 dir_pin=PC5 invert_step=-1 step_pulse_ticks=0 finalize_config crc=0 Il test \u00e8 stato eseguito l'ultima volta su commit 247cd753 con versione gcc arm-none-eabi-gcc (Fedora 10.2.0-4.fc34) 10.2.0 . stm32g0b1 ticks 1 stepper 58 3 stepper 243","title":"Benchmark step rate STM32G0B1"},{"location":"Benchmarks.html#benchmark-step-rate-lpc176x","text":"La seguente sequenza di configurazione viene utilizzata sull'LPC176x: allocate_oids count=3 config_stepper oid=0 step_pin=P1.20 dir_pin=P1.18 invert_step=-1 step_pulse_ticks=0 config_stepper oid=1 step_pin=P1.21 dir_pin=P1.18 invert_step=-1 step_pulse_ticks=0 config_stepper oid=2 step_pin=P1.23 dir_pin=P1.18 invert_step=-1 step_pulse_ticks=0 finalize_config crc=0 Il test \u00e8 stato eseguito l'ultima volta su commit 59314d99 con versione gcc arm-none-eabi-gcc (Fedora 10.2.0-4.fc34) 10.2.0 . I risultati a 120 Mhz LPC1769 sono stati ottenuti overclockando un LPC1768 a 120 Mhz. lpc1768 ticks 1 stepper 52 3 stepper 222 lpc1769 ticks 1 stepper 51 3 stepper 222","title":"Benchmark step rate LPC176x"},{"location":"Benchmarks.html#benchmark-step-rate-samd21","text":"La seguente sequenza di configurazione viene utilizzata sul SAMD21: allocate_oids count=3 config_stepper oid=0 step_pin=PA27 dir_pin=PA20 invert_step=-1 step_pulse_ticks=0 config_stepper oid=1 step_pin=PB3 dir_pin=PA21 invert_step=-1 step_pulse_ticks=0 config_stepper oid=2 step_pin=PA17 dir_pin=PA21 invert_step=-1 step_pulse_ticks=0 finalize_config crc=0 Il test \u00e8 stato eseguito l'ultima volta su commit 59314d99 con versione gcc arm-none-eabi-gcc (Fedora 10.2.0-4.fc34) 10.2.0 su un microcontrollore SAMD21G18. samd21 ticks 1 stepper 70 3 stepper 306","title":"Benchmark step rate SAMD21"},{"location":"Benchmarks.html#benchmark-step-rate-samd51","text":"La seguente sequenza di configurazione viene utilizzata sul SAMD51: allocate_oids count=3 config_stepper oid=0 step_pin=PA22 dir_pin=PA20 invert_step=-1 step_pulse_ticks=0 config_stepper oid=1 step_pin=PA22 dir_pin=PA21 invert_step=-1 step_pulse_ticks=0 config_stepper oid=2 step_pin=PA22 dir_pin=PA19 invert_step=-1 step_pulse_ticks=0 finalize_config crc=0 Il test \u00e8 stato eseguito l'ultima volta su commit 59314d99 con versione gcc arm-none-eabi-gcc (Fedora 10.2.0-4.fc34) 10.2.0 su un microcontrollore SAMD51J19A. samd51 ticks 1 stepper 39 3 stepper 191 1 stepper (200Mhz) 39 3 stepper (200Mhz) 181","title":"Benchmark step rate SAMD51"},{"location":"Benchmarks.html#benchmark-step-rate-rp2040","text":"Sull'RP2040 viene utilizzata la seguente sequenza di configurazione: allocate_oids count=3 config_stepper oid=0 step_pin=gpio25 dir_pin=gpio3 invert_step=-1 step_pulse_ticks=0 config_stepper oid=1 step_pin=gpio26 dir_pin=gpio4 invert_step=-1 step_pulse_ticks=0 config_stepper oid=2 step_pin=gpio27 dir_pin=gpio5 invert_step=-1 step_pulse_ticks=0 finalize_config crc=0 Il test \u00e8 stato eseguito l'ultima volta su commit 59314d99 con versione gcc arm-none-eabi-gcc (Fedora 10.2.0-4.fc34) 10.2.0 su una scheda Raspberry Pi Pico. rp2040 ticks 1 stepper 5 3 stepper 22","title":"Benchmark step rate RP2040"},{"location":"Benchmarks.html#benchmark-step-rate-mcu-linux","text":"La seguente sequenza di configurazione viene utilizzata su un Raspberry Pi: allocate_oids count=3 config_stepper oid=0 step_pin=gpio2 dir_pin=gpio3 invert_step=0 step_pulse_ticks=5 config_stepper oid=1 step_pin=gpio4 dir_pin=gpio5 invert_step=0 step_pulse_ticks=5 config_stepper oid=2 step_pin=gpio6 dir_pin=gpio17 invert_step=0 step_pulse_ticks=5 finalize_config crc=0 Il test \u00e8 stato eseguito l'ultima volta su commit 59314d99 con versione gcc gcc (Raspbian 8.3.0-6+rpi1) 8.3.0 su un Raspberry Pi 3 (revisione a02082). \u00c8 stato difficile ottenere risultati stabili in questo benchmark. Linux (RPi3) ticks 1 stepper 160 3 stepper 380","title":"Benchmark step rate MCU Linux"},{"location":"Benchmarks.html#benchmark-dispacciamento-comandi","text":"Il benchmark di invio dei comandi verifica quanti comandi \"fittizi\" possono elaborare il microcontrollore. \u00c8 principalmente un test del meccanismo di comunicazione hardware. Il test viene eseguito utilizzando lo strumento console.py (descritto in ). Quanto segue \u00e8 taglia e incolla nella finestra del terminale console.py: DELAY {clock + 2*freq} get_uptime FLOOD 100000 0.0 debug_nop get_uptime Al termine del test, determinare la differenza tra gli orologi riportati nei due messaggi di risposta \"uptime\". Il numero totale di comandi al secondo \u00e8 quindi 100000 * mcu_frequency / clock_diff . Nota che questo test potrebbe saturare la capacit\u00e0 USB/CPU di un Raspberry Pi. Se \u00e8 in esecuzione su un computer host Raspberry Pi, Beaglebone o simile, aumenta il ritardo (ad esempio, DELAY {clock + 20*freq} get_uptime ). Ove applicabile, i benchmark seguenti riguardano console.py in esecuzione su una macchina di classe desktop con il dispositivo connesso tramite un hub ad alta velocit\u00e0. MCU Rateo Build Build compiler stm32f042 (CAN) 18K c105adc8 arm-none-eabi-gcc (GNU Tools 7-2018-q3-update) 7.3.1 atmega2560 (serial) 23K b161a69e avr-gcc (GCC) 4.8.1 sam3x8e (serial) 23K b161a69e arm-none-eabi-gcc (Fedora 7.1.0-5.fc27) 7.1.0 at90usb1286 (USB) 75K 01d2183f avr-gcc (GCC) 5.4.0 samd21 (USB) 223K 01d2183f arm-none-eabi-gcc (Fedora 7.4.0-1.fc30) 7.4.0 pru (shared memory) 260K c5968a08 pru-gcc (GCC) 8.0.0 20170530 (experimental) stm32f103 (USB) 355K 01d2183f arm-none-eabi-gcc (Fedora 7.4.0-1.fc30) 7.4.0 sam3x8e (USB) 418K 01d2183f arm-none-eabi-gcc (Fedora 7.4.0-1.fc30) 7.4.0 lpc1768 (USB) 534K 01d2183f arm-none-eabi-gcc (Fedora 7.4.0-1.fc30) 7.4.0 lpc1769 (USB) 628K 01d2183f arm-none-eabi-gcc (Fedora 7.4.0-1.fc30) 7.4.0 sam4s8c (USB) 650K 8d4a5c16 arm-none-eabi-gcc (Fedora 7.4.0-1.fc30) 7.4.0 samd51 (USB) 864K 01d2183f arm-none-eabi-gcc (Fedora 7.4.0-1.fc30) 7.4.0 stm32f446 (USB) 870K 01d2183f arm-none-eabi-gcc (Fedora 7.4.0-1.fc30) 7.4.0 rp2040 (USB) 873K c5667193 arm-none-eabi-gcc (Fedora 10.2.0-4.fc34) 10.2.0","title":"Benchmark dispacciamento comandi"},{"location":"Benchmarks.html#benchmark-host","text":"\u00c8 possibile eseguire test di temporizzazione sul software host utilizzando il meccanismo di elaborazione \"batch mode\" (descritto in ). Questo viene in genere fatto scegliendo un file G-Code grande e complesso e calcolando il tempo impiegato dal software host per elaborarlo. Per esempio: time ~/klippy-env/bin/python ./klippy/klippy.py config/example-cartesian.cfg -i something_complex.gcode -o /dev/null -d out/klipper.dict","title":"Benchmark Host"},{"location":"Bootloaders.html","text":"Bootloader \u00b6 Questo documento fornisce informazioni sui bootloader comuni scoperti sui microcontrollori che sono supportati da Klipper. Il bootloader \u00e8 un software di terze parti che viene eseguito sul microcontrollore quando viene acceso per la prima volta. Viene generalmente utilizzato per eseguire il flashing di una nuova applicazione (ad es. Klipper) sul microcontrollore senza richiedere hardware specializzato. Sfortunatamente, non esiste uno standard a livello di settore per il flashing di un microcontrollore, n\u00e9 esiste un bootloader standard che funzioni su tutti i microcontrollori. Peggio ancora, \u00e8 comune che ogni bootloader richieda una serie di passaggi diversa per eseguire il flashing di un'applicazione. Se si pu\u00f2 eseguire il flashing di un bootloader su un microcontrollore, generalmente si pu\u00f2 anche utilizzare quel meccanismo per eseguire il flashing di un'applicazione, ma \u00e8 necessario prestare attenzione quando si esegue questa operazione poich\u00e9 si potrebbe rimuovere inavvertitamente il bootloader. Al contrario, un bootloader generalmente consentir\u00e0 solo a un utente di eseguire il flashing di un'applicazione. Si consiglia pertanto di utilizzare un bootloader per eseguire il flashing di un'applicazione, ove possibile. Questo documento tenta di descrivere i bootloader comuni, i passaggi necessari per eseguire il flashing di un bootloader e i passaggi necessari per eseguire il flashing di un'applicazione. Questo documento non \u00e8 un riferimento autorevole; \u00e8 inteso come una raccolta di informazioni utili che gli sviluppatori di Klipper hanno accumulato. Microcontrollori AVR \u00b6 In generale, il progetto Arduino \u00e8 un buon riferimento per bootloader e procedure di flashing sui microcontrollori Atmel Atmega a 8 bit. In particolare, il file \"boards.txt\": https://github.com/arduino/Arduino/blob/1.8.5/hardware/arduino/avr/boards.txt \u00e8 un utile riferimento. Per eseguire il flashing di un bootloader, i chip AVR richiedono uno strumento di flashing hardware esterno (che comunica con il chip tramite SPI). Questo strumento pu\u00f2 essere acquistato (ad esempio, eseguire una ricerca sul Web per \"avr isp\", \"arduino isp\" o \"usb tiny isp\"). \u00c8 anche possibile utilizzare un altro Arduino o Raspberry Pi per eseguire il flashing di un bootloader AVR (ad esempio, eseguire una ricerca sul Web per \"programmare un avr utilizzando raspberry pi\"). Gli esempi seguenti sono scritti presupponendo che sia in uso un dispositivo di tipo \"AVR ISP Mk2\". Il programma \"avrdude\" \u00e8 lo strumento pi\u00f9 comune utilizzato per eseguire il flashing dei chip atmega (sia flash del bootloader che flash dell'applicazione). Atmega2560 \u00b6 Questo chip si trova in genere nell'\"Arduino Mega\" ed \u00e8 molto comune nelle schede per stampanti 3D. Per eseguire il flashing del bootloader stesso usa qualcosa come: wget 'https://github.com/arduino/Arduino/raw/1.8.5/hardware/arduino/avr/bootloaders/stk500v2/stk500boot_v2_mega2560.hex' avrdude -cavrispv2 -patmega2560 -P/dev/ttyACM0 -b115200 -e -u -U lock:w:0x3F:m -U efuse:w:0xFD:m -U hfuse:w:0xD8:m -U lfuse:w:0xFF:m avrdude -cavrispv2 -patmega2560 -P/dev/ttyACM0 -b115200 -U flash:w:stk500boot_v2_mega2560.hex avrdude -cavrispv2 -patmega2560 -P/dev/ttyACM0 -b115200 -U lock:w:0x0F:m Per eseguire il flashing di un'applicazione, utilizzare qualcosa come: avrdude -cwiring -patmega2560 -P/dev/ttyACM0 -b115200 -D -Uflash:w:out/klipper.elf.hex:i Atmega1280 \u00b6 Questo chip si trova in genere nelle prime versioni di \"Arduino Mega\". Per eseguire il flashing del bootloader stesso usa qualcosa come: wget 'https://github.com/arduino/Arduino/raw/1.8.5/hardware/arduino/avr/bootloaders/atmega/ATmegaBOOT_168_atmega1280.hex' avrdude -cavrispv2 -patmega1280 -P/dev/ttyACM0 -b115200 -e -u -U lock:w:0x3F:m -U efuse:w:0xF5:m -U hfuse:w:0xDA:m -U lfuse:w:0xFF:m avrdude -cavrispv2 -patmega1280 -P/dev/ttyACM0 -b115200 -U flash:w:ATmegaBOOT_168_atmega1280.hex avrdude -cavrispv2 -patmega1280 -P/dev/ttyACM0 -b115200 -U lock:w:0x0F:m Per eseguire il flashing di un'applicazione, utilizzare qualcosa come: avrdude -carduino -patmega1280 -P/dev/ttyACM0 -b57600 -D -Uflash:w:out/klipper.elf.hex:i Atmega1284p \u00b6 Questo chip si trova comunemente nelle schede per stampanti 3D in stile \"Melzi\". Per eseguire il flashing del bootloader stesso usa qualcosa come: wget 'https://github.com/Lauszus/Sanguino/raw/1.0.2/bootloaders/optiboot/optiboot_atmega1284p.hex' avrdude -cavrispv2 -patmega1284p -P/dev/ttyACM0 -b115200 -e -u -U lock:w:0x3F:m -U efuse:w:0xFD:m -U hfuse:w:0xDE:m -U lfuse:w:0xFF:m avrdude -cavrispv2 -patmega1284p -P/dev/ttyACM0 -b115200 -U flash:w:optiboot_atmega1284p.hex avrdude -cavrispv2 -patmega1284p -P/dev/ttyACM0 -b115200 -U lock:w:0x0F:m Per eseguire il flashing di un'applicazione, utilizzare qualcosa come: avrdude -carduino -patmega1284p -P/dev/ttyACM0 -b115200 -D -Uflash:w:out/klipper.elf.hex:i Si noti che un certo numero di schede in stile \"Melzi\" sono precaricate con un bootloader che utilizza una velocit\u00e0 di trasmissione di 57600 baud. In questo caso, per eseguire il flashing di un'applicazione utilizzare invece qualcosa di simile: avrdude -carduino -patmega1284p -P/dev/ttyACM0 -b57600 -D -Uflash:w:out/klipper.elf.hex:i At90usb1286 \u00b6 Questo documento non copre il metodo per eseguire il flashing di un bootloader su At90usb1286 n\u00e9 copre il flashing di applicazioni generali su questo dispositivo. Il dispositivo Teensy++ di pjrc.com viene fornito con un bootloader proprietario. Richiede uno strumento di flashing personalizzato da https://github.com/PaulStoffregen/teensy_loader_cli . Si pu\u00f2 eseguire il flashing di un'applicazione usando qualcosa come: teensy_loader_cli --mcu=at90usb1286 out/klipper.elf.hex -v Atmega168 \u00b6 L'atmega168 ha uno spazio flash limitato. Se si utilizza un bootloader, si consiglia di utilizzare il bootloader Optiboot. Per eseguire il flashing di quel bootloader usa qualcosa come: wget 'https://github.com/arduino/Arduino/raw/1.8.5/hardware/arduino/avr/bootloaders/optiboot/optiboot_atmega168.hex' avrdude -cavrispv2 -patmega168 -P/dev/ttyACM0 -b115200 -e -u -U lock:w:0x3F:m -U efuse:w:0x04:m -U hfuse:w:0xDD:m -U lfuse:w:0xFF:m avrdude -cavrispv2 -patmega168 -P/dev/ttyACM0 -b115200 -U flash:w:optiboot_atmega168.hex avrdude -cavrispv2 -patmega168 -P/dev/ttyACM0 -b115200 -U lock:w:0x0F:m Per eseguire il flashing di un'applicazione tramite il bootloader Optiboot, utilizzare qualcosa come: avrdude -carduino -patmega168 -P/dev/ttyACM0 -b115200 -D -Uflash:w:out/klipper.elf.hex:i Microcontrollori SAM3 (Arduino Due) \u00b6 Non \u00e8 comune utilizzare un bootloader con l'mcu SAM3. Il chip stesso ha una ROM che permette di programmare il flash da porta seriale 3.3V o da USB. Per abilitare la ROM, il pin \"erase\" viene tenuto alto durante un reset, che cancella il contenuto della flash e fa funzionare la ROM. Su un Arduino Due, questa sequenza pu\u00f2 essere realizzata impostando un baud rate di 1200 sulla \"porta usb di programmazione\" (la porta USB pi\u00f9 vicina all'alimentatore). Il codice in https://github.com/shumatech/BOSSA pu\u00f2 essere utilizzato per programmare il SAM3. Si consiglia di utilizzare la versione 1.9 o successiva. Per eseguire il flashing di un'applicazione, utilizzare qualcosa come: bossac -U -p /dev/ttyACM0 -a -e -w out/klipper.bin -v -b bossac -U -p /dev/ttyACM0 -R Microcontrollori SAM4 (Duet Wifi) \u00b6 Non \u00e8 comune utilizzare un bootloader con l'mcu SAM4. Il chip stesso ha una ROM che permette di programmare la memoria flash da porta seriale 3.3V o da USB. Per abilitare la ROM, il pin \"erase\" viene tenuto alto durante un reset, che cancella il contenuto della memoria flash e fa funzionare la ROM. Il codice in https://github.com/shumatech/BOSSA pu\u00f2 essere utilizzato per programmare il SAM4. \u00c8 necessario utilizzare la versione 1.8.0 o successiva. Per eseguire il flashing di un'applicazione, utilizzare qualcosa come: bossac --port=/dev/ttyACM0 -b -U -e -w -v -R out/klipper.bin Microcontrollori SAMD21 (Arduino Zero) \u00b6 Il bootloader SAMD21 viene caricato in memoria flashing tramite l'interfaccia ARM Serial Wire Debug (SWD). Questo viene fatto comunemente con un dongle hardware SWD dedicato. In alternativa, \u00e8 possibile utilizzare un Raspberry Pi con OpenOCD . Per eseguire il flashing di un bootloader con OpenOCD, utilizzare la seguente configurazione del chip: source [find target/at91samdXX.cfg] Ottieni un bootloader, ad esempio: wget 'https://github.com/arduino/ArduinoCore-samd/raw/1.8.3/bootloaders/zero/samd21_sam_ba.bin' Carica la memoria Flash con comandi OpenOCD simili a: at91samd bootloader 0 program samd21_sam_ba.bin verify Il bootloader pi\u00f9 comune sul SAMD21 \u00e8 quello che si trova sull' \"Arduino Zero\". Utilizza un bootloader da 8KiB (l'applicazione deve essere compilata con un indirizzo iniziale di 8KiB). Si pu\u00f2 entrare in questo bootloader facendo doppio clic sul pulsante di ripristino. Per eseguire il flashing di un'applicazione, utilizzare qualcosa come: bossac -U -p /dev/ttyACM0 --offset=0x2000 -w out/klipper.bin -v -b -R Al contrario, \"Arduino M0\" utilizza un bootloader da 16 KiB (l'applicazione deve essere compilata con un indirizzo iniziale di 16 KiB). Per eseguire il flashing di un'applicazione su questo bootloader, ripristinare il microcontrollore ed eseguire il comando flash entro i primi secondi dall'avvio, qualcosa del tipo: avrdude -c stk500v2 -p atmega2560 -P /dev/ttyACM0 -u -Uflash:w:out/klipper.elf.hex:i Microcontrollori SAMD51 (Adafruit Metro-M4 e simili) \u00b6 Come il SAMD21, il bootloader SAMD51 viene eseguito il flashing tramite l'interfaccia ARM Serial Wire Debug (SWD). Per eseguire il flashing di un bootloader con OpenOCD su un Raspberry Pi utilizzare la seguente configurazione del chip: source [find target/atsame5x.cfg] Ottieni un bootloader: diversi bootloader sono disponibili da https://github.com/adafruit/uf2-samdx1/releases/latest . Per esempio: wget 'https://github.com/adafruit/uf2-samdx1/releases/download/v3.7.0/bootloader-itsybitsy_m4-v3.7.0.bin' Carica la memoria Flash con comandi OpenOCD simili a: at91samd bootloader 0 program bootloader-itsybitsy_m4-v3.7.0.bin verify at91samd bootloader 16384 Il SAMD51 utilizza un bootloader da 16 KiB (l'applicazione deve essere compilata con un indirizzo iniziale di 16 KiB). Per eseguire il flashing di un'applicazione, utilizzare qualcosa come: bossac -U -p /dev/ttyACM0 --offset=0x4000 -w out/klipper.bin -v -b -R Microcontrollori STM32F103 (dispositivi Blue Pill) \u00b6 I dispositivi STM32F103 dispongono di una ROM che pu\u00f2 eseguire il flashing di un bootloader o di un'applicazione tramite seriale a 3,3 V. In genere si collegano i pin PA10 (MCU Rx) e PA9 (MCU Tx) a un adattatore UART da 3,3 V. Per accedere alla ROM, \u00e8 necessario collegare il pin \"boot 0\" in alto e il pin \"boot 1\" in basso, quindi ripristinare il dispositivo. Il pacchetto \"stm32flash\" pu\u00f2 quindi essere utilizzato per eseguire il flashing del dispositivo utilizzando qualcosa come: stm32flash -w out/klipper.bin -v -g 0 /dev/ttyAMA0 Si noti che se si utilizza un Raspberry Pi per la seriale da 3,3 V, il protocollo stm32flash utilizza una modalit\u00e0 di parit\u00e0 seriale che il \"mini UART\" di Raspberry Pi non supporta. Vedere https://www.raspberrypi.com/documentation/computers/configuration.html#configuring-uarts per i dettagli sull'abilitazione dell'uart completo sui pin GPIO di Raspberry Pi. Dopo aver caricato la memoria flash, imposta \"boot 0\" e \"boot 1\" su basso in modo che in futuro ripristini l'avvio da flash. STM32F103 con bootloader stm32duino \u00b6 Il progetto \"stm32duino\" ha un bootloader compatibile con USB - vedere: https://github.com/rogerclarkmelbourne/STM32duino-bootloader Questo bootloader pu\u00f2 essere flashato tramite seriale 3.3V con qualcosa come: wget 'https://github.com/rogerclarkmelbourne/STM32duino-bootloader/raw/master/binaries/generic_boot20_pc13.bin' stm32flash -w generic_boot20_pc13.bin -v -g 0 /dev/ttyAMA0 Questo bootloader utilizza 8KiB di spazio flash (l'applicazione deve essere compilata con un indirizzo iniziale di 8KiB). Caricare in memoria flash un'applicazione con qualcosa come: dfu-util -d 1eaf:0003 -a 2 -R -D out/klipper.bin Il bootloader in genere viene eseguito solo per un breve periodo dopo l'avvio. Potrebbe essere necessario sincronizzare il comando sopra in modo che venga eseguito mentre il bootloader \u00e8 ancora attivo (il bootloader far\u00e0 lampeggiare un led della scheda mentre \u00e8 in esecuzione). In alternativa, imposta il pin \"boot 0\" su basso e il pin \"boot 1\" su alto per rimanere nel bootloader dopo un ripristino. STM32F103 con bootloader HID \u00b6 Il bootloader HID \u00e8 un bootloader compatto e senza driver in grado di eseguire il flashing attraverso USB. \u00c8 inoltre disponibile un fork con build specifiche per SKR Mini E3 1.2 . Per schede STM32F103 generiche come la blue pill \u00e8 possibile eseguire il flashing del bootloader tramite seriale 3.3v utilizzando stm32flash come indicato nella sezione stm32duino sopra, sostituendo il nome del file con il binario del bootloader desiderato (es: hid_generic_pc13.bin per blue pill ). Non \u00e8 possibile utilizzare stm32flash per SKR Mini E3 poich\u00e9 il pin boot0 \u00e8 collegato direttamente a terra e non disponibile tramite pin header. Si consiglia di utilizzare un STLink V2 con STM32Cubeprogrammer per eseguire il flashing del bootloader. Se non hai accesso a un STLink \u00e8 anche possibile utilizzare un Raspberry Pi e OpenOCD con la seguente configurazione del chip: source [find target/stm32f1x.cfg] Se lo desideri puoi fare un backup della flash corrente con il seguente comando. Tieni presente che il completamento potrebbe richiedere del tempo: flash read_bank 0 btt_skr_mini_e3_backup.bin infine, puoi eseguire il flashing con comandi simili a: stm32f1x mass_erase 0 program hid_btt_skr_mini_e3.bin verify 0x08000000 NOTE: L'esempio sopra cancella il chip, quindi programma il bootloader. Indipendentemente dal metodo scelto per eseguire il flashing, si consiglia di cancellare il chip prima del flashing. Prima di eseguire il flashing di SKR Mini E3 con questo bootloader, dovresti essere consapevole che non sarai pi\u00f9 in grado di aggiornare il firmware tramite la sdcard. You may need to hold down the reset button on the board while launching OpenOCD. It should display something like: Open On-Chip Debugger 0.10.0+dev-01204-gc60252ac-dirty (2020-04-27-16:00) Licensed under GNU GPL v2 For bug reports, read http://openocd.org/doc/doxygen/bugs.html DEPRECATED! use 'adapter speed' not 'adapter_khz' Info : BCM2835 GPIO JTAG/SWD bitbang driver Info : JTAG and SWD modes enabled Info : clock speed 40 kHz Info : SWD DPIDR 0x1ba01477 Info : stm32f1x.cpu: hardware has 6 breakpoints, 4 watchpoints Info : stm32f1x.cpu: external reset detected Info : starting gdb server for stm32f1x.cpu on 3333 Info : Listening on port 3333 for gdb connections Dopodich\u00e9 puoi rilasciare il pulsante di reset. Questo bootloader richiede 2KiB di spazio flash (l'applicazione deve essere compilata con un indirizzo iniziale di 2KiB). Il programma hid-flash viene utilizzato per caricare un file binario sul bootloader. \u00c8 possibile installare questo software con i seguenti comandi: sudo apt install libusb-1.0 cd ~/klipper/lib/hidflash make Se il bootloader \u00e8 in esecuzione, puoi eseguire il flash con qualcosa del tipo: ~/klipper/lib/hidflash/hid-flash ~/klipper/out/klipper.bin in alternativa, puoi usare make flash per flashare klipper direttamente: make flash FLASH_DEVICE=1209:BEBA O se klipper \u00e8 stato precedentemente flashato: make flash FLASH_DEVICE=/dev/ttyACM0 Potrebbe essere necessario inserire manualmente il bootloader, questo pu\u00f2 essere fatto impostando \"boot 0\" basso e \"boot 1\" alto. Su SKR Mini E3 \"Boot 1\" non \u00e8 disponibile, quindi pu\u00f2 essere fatto impostando il pin PA2 basso se hai flashato \"hid_btt_skr_mini_e3.bin\". Questo pin \u00e8 etichettato \"TX0\" sull'intestazione TFT nel documento \"PIN\" di SKR Mini E3. C'\u00e8 un pin di massa accanto a PA2 che puoi usare per abbassare PA2. STM32F103/STM32F072 con bootloader MSC \u00b6 Il bootloader MSC \u00e8 un bootloader senza driver in grado di eseguire il flashing su USB. \u00c8 possibile eseguire il flashing del bootloader tramite seriale 3.3v usando stm32flash come indicato nella sezione stm32duino sopra, sostituendo il nome del file con il file binario del bootloader MSC desiderato (es: MSCboot-Bluepill.bin per la Blue pill). Per le schede STM32F072 \u00e8 anche possibile eseguire il flashing del bootloader su USB (tramite DFU) con qualcosa del tipo: dfu-util -d 0483:df11 -a 0 -R -D MSCboot-STM32F072.bin -s0x08000000:leave Questo bootloader utilizza 8KiB o 16KiB di spazio flash, vedere la descrizione del bootloader (l'applicazione deve essere compilata con l'indirizzo iniziale corrispondente). Il bootloader pu\u00f2 essere attivato premendo due volte il pulsante di reset della scheda. Non appena il bootloader viene attivato, la scheda appare come una chiavetta USB su cui \u00e8 possibile copiare il file klipper.bin. STM32F103/STM32F0x2 con bootloader CanBoot \u00b6 Il bootloader CanBoot fornisce un'opzione per caricare il firmware Klipper su CANBUS. Il bootloader stesso \u00e8 derivato dal codice sorgente di Klipper. Attualmente CanBoot supporta i modelli STM32F103, STM32F042 e STM32F072. Si consiglia di utilizzare un programmatore ST-Link per eseguire il flashing di CanBoot, tuttavia dovrebbe essere possibile eseguire il flashing utilizzando stm32flash sui dispositivi STM32F103 e dfu-util sui dispositivi STM32F042/STM32F072. Vedere le sezioni precedenti di questo documento per istruzioni su questi metodi di flashing, sostituendo canboot.bin per il nome del file ove appropriato. Il link al repository CanBoot collegato sopra fornisce istruzioni per la creazione del bootloader. La prima volta che CanBoot \u00e8 stato flashato, dovrebbe rilevare che non \u00e8 presente alcuna applicazione e accedere al bootloader. Se ci\u00f2 non accade \u00e8 possibile entrare nel bootloader premendo due volte di seguito il pulsante di reset. L'utilit\u00e0 flash_can.py fornita nella cartella lib/canboot pu\u00f2 essere utilizzata per caricare il firmware di Klipper. E' necessario l'UUID del dispositivo per eseguire il flashing. Se non si dispone di un UUID \u00e8 possibile interrogare i nodi che attualmente eseguono il bootloader: python3 flash_can.py -q Ci\u00f2 restituir\u00e0 gli UUID per tutti i nodi collegati non attualmente assegnati a un UUID. Questo dovrebbe includere tutti i nodi attualmente nel bootloader. Una volta che hai un UUID, puoi caricare il firmware con il seguente comando: python3 flash_can.py -i can0 -f ~/klipper/out/klipper.bin -u aabbccddeeff Dove aabbccddeeff \u00e8 sostituito dal tuo UUID. Nota che le opzioni -i e -f possono essere omesse, per impostazione predefinita sono rispettivamente can0 e ~/klipper/out/klipper.bin . Quando crei Klipper per l'uso con CanBoot, seleziona l'opzione Bootloader da 8 KiB. Microcontrollori STM32F4 (SKR Pro 1.1) \u00b6 I microcontrollori STM32F4 sono dotati di un bootloader di sistema integrato in grado di eseguire il flashing su USB (tramite DFU), seriale 3.3v e vari altri metodi (consultare il documento STM AN2606 per ulteriori informazioni). Alcune schede STM32F4, come SKR Pro 1.1, non sono in grado di accedere al bootloader DFU. Il bootloader HID \u00e8 disponibile per schede basate su STM32F405/407 nel caso in cui l'utente preferisca eseguire il flashing su USB anzich\u00e9 utilizzare la scheda SD. Tieni presente che potrebbe essere necessario configurare e creare una versione specifica per la tua scheda, una build per SKR Pro 1.1 \u00e8 disponibile qui . A meno che la tua scheda non sia compatibile con DFU, il metodo di flashing pi\u00f9 accessibile \u00e8 probabilmente tramite seriale 3.3v, che segue la stessa procedura di flash dell'STM32F103 usando stm32flash . Per esempio: wget https://github.com/Arksine/STM32_HID_Bootloader/releases/download/v0.5-beta/hid_bootloader_SKR_PRO.bin stm32flash -w hid_bootloader_SKR_PRO.bin -v -g 0 /dev/ttyAMA0 Questo bootloader richiede 16Kib di spazio flash sull'STM32F4 (l'applicazione deve essere compilata con un indirizzo iniziale di 16KiB). Come con l'STM32F1, l'STM32F4 utilizza lo strumento hid-flash per caricare i file binari nell'MCU. Consulta le istruzioni sopra per i dettagli su come creare e utilizzare hid-flash. Potrebbe essere necessario inserire manualmente il bootloader, questo pu\u00f2 essere fatto impostando \"boot 0\" basso, \"boot 1\" alto e collegando il dispositivo. Al termine della programmazione, scollegare il dispositivo e impostare \"boot 1\" su basso in modo che l'applicazione venga caricata. Microcontrollori LPC176x (Smoothieboards) \u00b6 Questo documento non descrive il metodo per eseguire il flashing di un bootloader stesso - vedere: http://smoothieware.org/flashing-the-bootloader per ulteriori informazioni su questo argomento. \u00c8 comune che per le Smoothieboard venga fornito con un bootloader da: https://github.com/triffid/LPC17xx-DFU-Bootloader . Quando si utilizza questo bootloader, l'applicazione deve essere compilata con un indirizzo iniziale di 16 KiB. Il modo pi\u00f9 semplice per eseguire il flashing di un'applicazione con questo bootloader \u00e8 copiare il file dell'applicazione (ad es. out/klipper.bin ) in un file denominato firmware.bin su una scheda SD, quindi riavviare il microcontrollore con quella scheda SD. Eseguire OpenOCD su Raspberry PI \u00b6 OpenOCD \u00e8 un pacchetto software in grado di eseguire il flashing e il debug di chip di basso livello. Pu\u00f2 utilizzare i pin GPIO su un Raspberry Pi per comunicare con una variet\u00e0 di chip ARM. Questa sezione descrive come installare e avviare OpenOCD. \u00c8 derivato dalle istruzioni su: https://learn.adafruit.com/programming-microcontrollers-using-openocd-on-raspberry-pi Inizia scaricando e compilando il software (ogni passaggio pu\u00f2 richiedere diversi minuti e il passaggio \"make\" pu\u00f2 richiedere pi\u00f9 di 30 minuti): sudo apt-get update sudo apt-get install autoconf libtool telnet mkdir ~/openocd cd ~/openocd/ git clone http://openocd.zylin.com/openocd cd openocd ./bootstrap ./configure --enable-sysfsgpio --enable-bcm2835gpio --prefix=/home/pi/openocd/install make make install Configurare OpenOCD \u00b6 Crea un file di configurazione OpenOCD: nano ~/openocd/openocd.cfg Utilizzare una configurazione simile alla seguente: # Uses RPi pins: GPIO25 for SWDCLK, GPIO24 for SWDIO, GPIO18 for nRST source [find interface/raspberrypi2-native.cfg] bcm2835gpio_swd_nums 25 24 bcm2835gpio_srst_num 18 transport select swd # Use hardware reset wire for chip resets reset_config srst_only adapter_nsrst_delay 100 adapter_nsrst_assert_width 100 # Specify the chip type source [find target/atsame5x.cfg] # Set the adapter speed adapter_khz 40 # Connect to chip init targets reset halt Collega il Raspberry Pi al chip di destinazione \u00b6 Spegni sia il Raspberry Pi che il chip di destinazione prima del cablaggio! Verificare che il chip di destinazione utilizzi 3,3 V prima di connettersi a un Raspberry Pi! Collega GND, SWDCLK, SWDIO e RST sul chip di destinazione rispettivamente a GND, GPIO25, GPIO24 e GPIO18 sul Raspberry Pi. Quindi accendi il Raspberry Pi e fornisci alimentazione al chip di destinazione. Eseguire OpenOCD \u00b6 Esegui OpenOCD: cd ~/openocd/ sudo ~/openocd/install/bin/openocd -f ~/openocd/openocd.cfg Quanto sopra dovrebbe far s\u00ec che OpenOCD emetta alcuni messaggi di testo e quindi attenda (non dovrebbe tornare immediatamente al prompt della shell Unix). Se OpenOCD termina da solo o se continua a emettere messaggi di testo, ricontrolla il cablaggio. Una volta che OpenOCD \u00e8 in esecuzione ed \u00e8 stabile, \u00e8 possibile inviargli comandi tramite telnet. Apri un'altra sessione ssh ed esegui quanto segue: telnet 127.0.0.1 4444 (Si pu\u00f2 uscire da telnet premendo ctrl+] e quindi eseguendo il comando \"quit\".) OpenOCD e gdb \u00b6 \u00c8 possibile utilizzare OpenOCD con gdb per eseguire il debug di Klipper. I seguenti comandi presuppongono che uno stia eseguendo gdb su una macchina di classe desktop. Aggiungi quanto segue al file di configurazione di OpenOCD: bindto 0.0.0.0 gdb_port 44444 Riavvia OpenOCD sul Raspberry Pi e quindi esegui il seguente comando Unix sul computer desktop: cd /path/to/klipper/ gdb out/klipper.elf All'interno di gdb esegui: target remote octopi:44444 (Sostituisci \"octopi\" con il nome host del Raspberry Pi.) Una volta che gdb \u00e8 in esecuzione, \u00e8 possibile impostare punti di interruzione e ispezionare i registri.","title":"Bootloader"},{"location":"Bootloaders.html#bootloader","text":"Questo documento fornisce informazioni sui bootloader comuni scoperti sui microcontrollori che sono supportati da Klipper. Il bootloader \u00e8 un software di terze parti che viene eseguito sul microcontrollore quando viene acceso per la prima volta. Viene generalmente utilizzato per eseguire il flashing di una nuova applicazione (ad es. Klipper) sul microcontrollore senza richiedere hardware specializzato. Sfortunatamente, non esiste uno standard a livello di settore per il flashing di un microcontrollore, n\u00e9 esiste un bootloader standard che funzioni su tutti i microcontrollori. Peggio ancora, \u00e8 comune che ogni bootloader richieda una serie di passaggi diversa per eseguire il flashing di un'applicazione. Se si pu\u00f2 eseguire il flashing di un bootloader su un microcontrollore, generalmente si pu\u00f2 anche utilizzare quel meccanismo per eseguire il flashing di un'applicazione, ma \u00e8 necessario prestare attenzione quando si esegue questa operazione poich\u00e9 si potrebbe rimuovere inavvertitamente il bootloader. Al contrario, un bootloader generalmente consentir\u00e0 solo a un utente di eseguire il flashing di un'applicazione. Si consiglia pertanto di utilizzare un bootloader per eseguire il flashing di un'applicazione, ove possibile. Questo documento tenta di descrivere i bootloader comuni, i passaggi necessari per eseguire il flashing di un bootloader e i passaggi necessari per eseguire il flashing di un'applicazione. Questo documento non \u00e8 un riferimento autorevole; \u00e8 inteso come una raccolta di informazioni utili che gli sviluppatori di Klipper hanno accumulato.","title":"Bootloader"},{"location":"Bootloaders.html#microcontrollori-avr","text":"In generale, il progetto Arduino \u00e8 un buon riferimento per bootloader e procedure di flashing sui microcontrollori Atmel Atmega a 8 bit. In particolare, il file \"boards.txt\": https://github.com/arduino/Arduino/blob/1.8.5/hardware/arduino/avr/boards.txt \u00e8 un utile riferimento. Per eseguire il flashing di un bootloader, i chip AVR richiedono uno strumento di flashing hardware esterno (che comunica con il chip tramite SPI). Questo strumento pu\u00f2 essere acquistato (ad esempio, eseguire una ricerca sul Web per \"avr isp\", \"arduino isp\" o \"usb tiny isp\"). \u00c8 anche possibile utilizzare un altro Arduino o Raspberry Pi per eseguire il flashing di un bootloader AVR (ad esempio, eseguire una ricerca sul Web per \"programmare un avr utilizzando raspberry pi\"). Gli esempi seguenti sono scritti presupponendo che sia in uso un dispositivo di tipo \"AVR ISP Mk2\". Il programma \"avrdude\" \u00e8 lo strumento pi\u00f9 comune utilizzato per eseguire il flashing dei chip atmega (sia flash del bootloader che flash dell'applicazione).","title":"Microcontrollori AVR"},{"location":"Bootloaders.html#atmega2560","text":"Questo chip si trova in genere nell'\"Arduino Mega\" ed \u00e8 molto comune nelle schede per stampanti 3D. Per eseguire il flashing del bootloader stesso usa qualcosa come: wget 'https://github.com/arduino/Arduino/raw/1.8.5/hardware/arduino/avr/bootloaders/stk500v2/stk500boot_v2_mega2560.hex' avrdude -cavrispv2 -patmega2560 -P/dev/ttyACM0 -b115200 -e -u -U lock:w:0x3F:m -U efuse:w:0xFD:m -U hfuse:w:0xD8:m -U lfuse:w:0xFF:m avrdude -cavrispv2 -patmega2560 -P/dev/ttyACM0 -b115200 -U flash:w:stk500boot_v2_mega2560.hex avrdude -cavrispv2 -patmega2560 -P/dev/ttyACM0 -b115200 -U lock:w:0x0F:m Per eseguire il flashing di un'applicazione, utilizzare qualcosa come: avrdude -cwiring -patmega2560 -P/dev/ttyACM0 -b115200 -D -Uflash:w:out/klipper.elf.hex:i","title":"Atmega2560"},{"location":"Bootloaders.html#atmega1280","text":"Questo chip si trova in genere nelle prime versioni di \"Arduino Mega\". Per eseguire il flashing del bootloader stesso usa qualcosa come: wget 'https://github.com/arduino/Arduino/raw/1.8.5/hardware/arduino/avr/bootloaders/atmega/ATmegaBOOT_168_atmega1280.hex' avrdude -cavrispv2 -patmega1280 -P/dev/ttyACM0 -b115200 -e -u -U lock:w:0x3F:m -U efuse:w:0xF5:m -U hfuse:w:0xDA:m -U lfuse:w:0xFF:m avrdude -cavrispv2 -patmega1280 -P/dev/ttyACM0 -b115200 -U flash:w:ATmegaBOOT_168_atmega1280.hex avrdude -cavrispv2 -patmega1280 -P/dev/ttyACM0 -b115200 -U lock:w:0x0F:m Per eseguire il flashing di un'applicazione, utilizzare qualcosa come: avrdude -carduino -patmega1280 -P/dev/ttyACM0 -b57600 -D -Uflash:w:out/klipper.elf.hex:i","title":"Atmega1280"},{"location":"Bootloaders.html#atmega1284p","text":"Questo chip si trova comunemente nelle schede per stampanti 3D in stile \"Melzi\". Per eseguire il flashing del bootloader stesso usa qualcosa come: wget 'https://github.com/Lauszus/Sanguino/raw/1.0.2/bootloaders/optiboot/optiboot_atmega1284p.hex' avrdude -cavrispv2 -patmega1284p -P/dev/ttyACM0 -b115200 -e -u -U lock:w:0x3F:m -U efuse:w:0xFD:m -U hfuse:w:0xDE:m -U lfuse:w:0xFF:m avrdude -cavrispv2 -patmega1284p -P/dev/ttyACM0 -b115200 -U flash:w:optiboot_atmega1284p.hex avrdude -cavrispv2 -patmega1284p -P/dev/ttyACM0 -b115200 -U lock:w:0x0F:m Per eseguire il flashing di un'applicazione, utilizzare qualcosa come: avrdude -carduino -patmega1284p -P/dev/ttyACM0 -b115200 -D -Uflash:w:out/klipper.elf.hex:i Si noti che un certo numero di schede in stile \"Melzi\" sono precaricate con un bootloader che utilizza una velocit\u00e0 di trasmissione di 57600 baud. In questo caso, per eseguire il flashing di un'applicazione utilizzare invece qualcosa di simile: avrdude -carduino -patmega1284p -P/dev/ttyACM0 -b57600 -D -Uflash:w:out/klipper.elf.hex:i","title":"Atmega1284p"},{"location":"Bootloaders.html#at90usb1286","text":"Questo documento non copre il metodo per eseguire il flashing di un bootloader su At90usb1286 n\u00e9 copre il flashing di applicazioni generali su questo dispositivo. Il dispositivo Teensy++ di pjrc.com viene fornito con un bootloader proprietario. Richiede uno strumento di flashing personalizzato da https://github.com/PaulStoffregen/teensy_loader_cli . Si pu\u00f2 eseguire il flashing di un'applicazione usando qualcosa come: teensy_loader_cli --mcu=at90usb1286 out/klipper.elf.hex -v","title":"At90usb1286"},{"location":"Bootloaders.html#atmega168","text":"L'atmega168 ha uno spazio flash limitato. Se si utilizza un bootloader, si consiglia di utilizzare il bootloader Optiboot. Per eseguire il flashing di quel bootloader usa qualcosa come: wget 'https://github.com/arduino/Arduino/raw/1.8.5/hardware/arduino/avr/bootloaders/optiboot/optiboot_atmega168.hex' avrdude -cavrispv2 -patmega168 -P/dev/ttyACM0 -b115200 -e -u -U lock:w:0x3F:m -U efuse:w:0x04:m -U hfuse:w:0xDD:m -U lfuse:w:0xFF:m avrdude -cavrispv2 -patmega168 -P/dev/ttyACM0 -b115200 -U flash:w:optiboot_atmega168.hex avrdude -cavrispv2 -patmega168 -P/dev/ttyACM0 -b115200 -U lock:w:0x0F:m Per eseguire il flashing di un'applicazione tramite il bootloader Optiboot, utilizzare qualcosa come: avrdude -carduino -patmega168 -P/dev/ttyACM0 -b115200 -D -Uflash:w:out/klipper.elf.hex:i","title":"Atmega168"},{"location":"Bootloaders.html#microcontrollori-sam3-arduino-due","text":"Non \u00e8 comune utilizzare un bootloader con l'mcu SAM3. Il chip stesso ha una ROM che permette di programmare il flash da porta seriale 3.3V o da USB. Per abilitare la ROM, il pin \"erase\" viene tenuto alto durante un reset, che cancella il contenuto della flash e fa funzionare la ROM. Su un Arduino Due, questa sequenza pu\u00f2 essere realizzata impostando un baud rate di 1200 sulla \"porta usb di programmazione\" (la porta USB pi\u00f9 vicina all'alimentatore). Il codice in https://github.com/shumatech/BOSSA pu\u00f2 essere utilizzato per programmare il SAM3. Si consiglia di utilizzare la versione 1.9 o successiva. Per eseguire il flashing di un'applicazione, utilizzare qualcosa come: bossac -U -p /dev/ttyACM0 -a -e -w out/klipper.bin -v -b bossac -U -p /dev/ttyACM0 -R","title":"Microcontrollori SAM3 (Arduino Due)"},{"location":"Bootloaders.html#microcontrollori-sam4-duet-wifi","text":"Non \u00e8 comune utilizzare un bootloader con l'mcu SAM4. Il chip stesso ha una ROM che permette di programmare la memoria flash da porta seriale 3.3V o da USB. Per abilitare la ROM, il pin \"erase\" viene tenuto alto durante un reset, che cancella il contenuto della memoria flash e fa funzionare la ROM. Il codice in https://github.com/shumatech/BOSSA pu\u00f2 essere utilizzato per programmare il SAM4. \u00c8 necessario utilizzare la versione 1.8.0 o successiva. Per eseguire il flashing di un'applicazione, utilizzare qualcosa come: bossac --port=/dev/ttyACM0 -b -U -e -w -v -R out/klipper.bin","title":"Microcontrollori SAM4 (Duet Wifi)"},{"location":"Bootloaders.html#microcontrollori-samd21-arduino-zero","text":"Il bootloader SAMD21 viene caricato in memoria flashing tramite l'interfaccia ARM Serial Wire Debug (SWD). Questo viene fatto comunemente con un dongle hardware SWD dedicato. In alternativa, \u00e8 possibile utilizzare un Raspberry Pi con OpenOCD . Per eseguire il flashing di un bootloader con OpenOCD, utilizzare la seguente configurazione del chip: source [find target/at91samdXX.cfg] Ottieni un bootloader, ad esempio: wget 'https://github.com/arduino/ArduinoCore-samd/raw/1.8.3/bootloaders/zero/samd21_sam_ba.bin' Carica la memoria Flash con comandi OpenOCD simili a: at91samd bootloader 0 program samd21_sam_ba.bin verify Il bootloader pi\u00f9 comune sul SAMD21 \u00e8 quello che si trova sull' \"Arduino Zero\". Utilizza un bootloader da 8KiB (l'applicazione deve essere compilata con un indirizzo iniziale di 8KiB). Si pu\u00f2 entrare in questo bootloader facendo doppio clic sul pulsante di ripristino. Per eseguire il flashing di un'applicazione, utilizzare qualcosa come: bossac -U -p /dev/ttyACM0 --offset=0x2000 -w out/klipper.bin -v -b -R Al contrario, \"Arduino M0\" utilizza un bootloader da 16 KiB (l'applicazione deve essere compilata con un indirizzo iniziale di 16 KiB). Per eseguire il flashing di un'applicazione su questo bootloader, ripristinare il microcontrollore ed eseguire il comando flash entro i primi secondi dall'avvio, qualcosa del tipo: avrdude -c stk500v2 -p atmega2560 -P /dev/ttyACM0 -u -Uflash:w:out/klipper.elf.hex:i","title":"Microcontrollori SAMD21 (Arduino Zero)"},{"location":"Bootloaders.html#microcontrollori-samd51-adafruit-metro-m4-e-simili","text":"Come il SAMD21, il bootloader SAMD51 viene eseguito il flashing tramite l'interfaccia ARM Serial Wire Debug (SWD). Per eseguire il flashing di un bootloader con OpenOCD su un Raspberry Pi utilizzare la seguente configurazione del chip: source [find target/atsame5x.cfg] Ottieni un bootloader: diversi bootloader sono disponibili da https://github.com/adafruit/uf2-samdx1/releases/latest . Per esempio: wget 'https://github.com/adafruit/uf2-samdx1/releases/download/v3.7.0/bootloader-itsybitsy_m4-v3.7.0.bin' Carica la memoria Flash con comandi OpenOCD simili a: at91samd bootloader 0 program bootloader-itsybitsy_m4-v3.7.0.bin verify at91samd bootloader 16384 Il SAMD51 utilizza un bootloader da 16 KiB (l'applicazione deve essere compilata con un indirizzo iniziale di 16 KiB). Per eseguire il flashing di un'applicazione, utilizzare qualcosa come: bossac -U -p /dev/ttyACM0 --offset=0x4000 -w out/klipper.bin -v -b -R","title":"Microcontrollori SAMD51 (Adafruit Metro-M4 e simili)"},{"location":"Bootloaders.html#microcontrollori-stm32f103-dispositivi-blue-pill","text":"I dispositivi STM32F103 dispongono di una ROM che pu\u00f2 eseguire il flashing di un bootloader o di un'applicazione tramite seriale a 3,3 V. In genere si collegano i pin PA10 (MCU Rx) e PA9 (MCU Tx) a un adattatore UART da 3,3 V. Per accedere alla ROM, \u00e8 necessario collegare il pin \"boot 0\" in alto e il pin \"boot 1\" in basso, quindi ripristinare il dispositivo. Il pacchetto \"stm32flash\" pu\u00f2 quindi essere utilizzato per eseguire il flashing del dispositivo utilizzando qualcosa come: stm32flash -w out/klipper.bin -v -g 0 /dev/ttyAMA0 Si noti che se si utilizza un Raspberry Pi per la seriale da 3,3 V, il protocollo stm32flash utilizza una modalit\u00e0 di parit\u00e0 seriale che il \"mini UART\" di Raspberry Pi non supporta. Vedere https://www.raspberrypi.com/documentation/computers/configuration.html#configuring-uarts per i dettagli sull'abilitazione dell'uart completo sui pin GPIO di Raspberry Pi. Dopo aver caricato la memoria flash, imposta \"boot 0\" e \"boot 1\" su basso in modo che in futuro ripristini l'avvio da flash.","title":"Microcontrollori STM32F103 (dispositivi Blue Pill)"},{"location":"Bootloaders.html#stm32f103-con-bootloader-stm32duino","text":"Il progetto \"stm32duino\" ha un bootloader compatibile con USB - vedere: https://github.com/rogerclarkmelbourne/STM32duino-bootloader Questo bootloader pu\u00f2 essere flashato tramite seriale 3.3V con qualcosa come: wget 'https://github.com/rogerclarkmelbourne/STM32duino-bootloader/raw/master/binaries/generic_boot20_pc13.bin' stm32flash -w generic_boot20_pc13.bin -v -g 0 /dev/ttyAMA0 Questo bootloader utilizza 8KiB di spazio flash (l'applicazione deve essere compilata con un indirizzo iniziale di 8KiB). Caricare in memoria flash un'applicazione con qualcosa come: dfu-util -d 1eaf:0003 -a 2 -R -D out/klipper.bin Il bootloader in genere viene eseguito solo per un breve periodo dopo l'avvio. Potrebbe essere necessario sincronizzare il comando sopra in modo che venga eseguito mentre il bootloader \u00e8 ancora attivo (il bootloader far\u00e0 lampeggiare un led della scheda mentre \u00e8 in esecuzione). In alternativa, imposta il pin \"boot 0\" su basso e il pin \"boot 1\" su alto per rimanere nel bootloader dopo un ripristino.","title":"STM32F103 con bootloader stm32duino"},{"location":"Bootloaders.html#stm32f103-con-bootloader-hid","text":"Il bootloader HID \u00e8 un bootloader compatto e senza driver in grado di eseguire il flashing attraverso USB. \u00c8 inoltre disponibile un fork con build specifiche per SKR Mini E3 1.2 . Per schede STM32F103 generiche come la blue pill \u00e8 possibile eseguire il flashing del bootloader tramite seriale 3.3v utilizzando stm32flash come indicato nella sezione stm32duino sopra, sostituendo il nome del file con il binario del bootloader desiderato (es: hid_generic_pc13.bin per blue pill ). Non \u00e8 possibile utilizzare stm32flash per SKR Mini E3 poich\u00e9 il pin boot0 \u00e8 collegato direttamente a terra e non disponibile tramite pin header. Si consiglia di utilizzare un STLink V2 con STM32Cubeprogrammer per eseguire il flashing del bootloader. Se non hai accesso a un STLink \u00e8 anche possibile utilizzare un Raspberry Pi e OpenOCD con la seguente configurazione del chip: source [find target/stm32f1x.cfg] Se lo desideri puoi fare un backup della flash corrente con il seguente comando. Tieni presente che il completamento potrebbe richiedere del tempo: flash read_bank 0 btt_skr_mini_e3_backup.bin infine, puoi eseguire il flashing con comandi simili a: stm32f1x mass_erase 0 program hid_btt_skr_mini_e3.bin verify 0x08000000 NOTE: L'esempio sopra cancella il chip, quindi programma il bootloader. Indipendentemente dal metodo scelto per eseguire il flashing, si consiglia di cancellare il chip prima del flashing. Prima di eseguire il flashing di SKR Mini E3 con questo bootloader, dovresti essere consapevole che non sarai pi\u00f9 in grado di aggiornare il firmware tramite la sdcard. You may need to hold down the reset button on the board while launching OpenOCD. It should display something like: Open On-Chip Debugger 0.10.0+dev-01204-gc60252ac-dirty (2020-04-27-16:00) Licensed under GNU GPL v2 For bug reports, read http://openocd.org/doc/doxygen/bugs.html DEPRECATED! use 'adapter speed' not 'adapter_khz' Info : BCM2835 GPIO JTAG/SWD bitbang driver Info : JTAG and SWD modes enabled Info : clock speed 40 kHz Info : SWD DPIDR 0x1ba01477 Info : stm32f1x.cpu: hardware has 6 breakpoints, 4 watchpoints Info : stm32f1x.cpu: external reset detected Info : starting gdb server for stm32f1x.cpu on 3333 Info : Listening on port 3333 for gdb connections Dopodich\u00e9 puoi rilasciare il pulsante di reset. Questo bootloader richiede 2KiB di spazio flash (l'applicazione deve essere compilata con un indirizzo iniziale di 2KiB). Il programma hid-flash viene utilizzato per caricare un file binario sul bootloader. \u00c8 possibile installare questo software con i seguenti comandi: sudo apt install libusb-1.0 cd ~/klipper/lib/hidflash make Se il bootloader \u00e8 in esecuzione, puoi eseguire il flash con qualcosa del tipo: ~/klipper/lib/hidflash/hid-flash ~/klipper/out/klipper.bin in alternativa, puoi usare make flash per flashare klipper direttamente: make flash FLASH_DEVICE=1209:BEBA O se klipper \u00e8 stato precedentemente flashato: make flash FLASH_DEVICE=/dev/ttyACM0 Potrebbe essere necessario inserire manualmente il bootloader, questo pu\u00f2 essere fatto impostando \"boot 0\" basso e \"boot 1\" alto. Su SKR Mini E3 \"Boot 1\" non \u00e8 disponibile, quindi pu\u00f2 essere fatto impostando il pin PA2 basso se hai flashato \"hid_btt_skr_mini_e3.bin\". Questo pin \u00e8 etichettato \"TX0\" sull'intestazione TFT nel documento \"PIN\" di SKR Mini E3. C'\u00e8 un pin di massa accanto a PA2 che puoi usare per abbassare PA2.","title":"STM32F103 con bootloader HID"},{"location":"Bootloaders.html#stm32f103stm32f072-con-bootloader-msc","text":"Il bootloader MSC \u00e8 un bootloader senza driver in grado di eseguire il flashing su USB. \u00c8 possibile eseguire il flashing del bootloader tramite seriale 3.3v usando stm32flash come indicato nella sezione stm32duino sopra, sostituendo il nome del file con il file binario del bootloader MSC desiderato (es: MSCboot-Bluepill.bin per la Blue pill). Per le schede STM32F072 \u00e8 anche possibile eseguire il flashing del bootloader su USB (tramite DFU) con qualcosa del tipo: dfu-util -d 0483:df11 -a 0 -R -D MSCboot-STM32F072.bin -s0x08000000:leave Questo bootloader utilizza 8KiB o 16KiB di spazio flash, vedere la descrizione del bootloader (l'applicazione deve essere compilata con l'indirizzo iniziale corrispondente). Il bootloader pu\u00f2 essere attivato premendo due volte il pulsante di reset della scheda. Non appena il bootloader viene attivato, la scheda appare come una chiavetta USB su cui \u00e8 possibile copiare il file klipper.bin.","title":"STM32F103/STM32F072 con bootloader MSC"},{"location":"Bootloaders.html#stm32f103stm32f0x2-con-bootloader-canboot","text":"Il bootloader CanBoot fornisce un'opzione per caricare il firmware Klipper su CANBUS. Il bootloader stesso \u00e8 derivato dal codice sorgente di Klipper. Attualmente CanBoot supporta i modelli STM32F103, STM32F042 e STM32F072. Si consiglia di utilizzare un programmatore ST-Link per eseguire il flashing di CanBoot, tuttavia dovrebbe essere possibile eseguire il flashing utilizzando stm32flash sui dispositivi STM32F103 e dfu-util sui dispositivi STM32F042/STM32F072. Vedere le sezioni precedenti di questo documento per istruzioni su questi metodi di flashing, sostituendo canboot.bin per il nome del file ove appropriato. Il link al repository CanBoot collegato sopra fornisce istruzioni per la creazione del bootloader. La prima volta che CanBoot \u00e8 stato flashato, dovrebbe rilevare che non \u00e8 presente alcuna applicazione e accedere al bootloader. Se ci\u00f2 non accade \u00e8 possibile entrare nel bootloader premendo due volte di seguito il pulsante di reset. L'utilit\u00e0 flash_can.py fornita nella cartella lib/canboot pu\u00f2 essere utilizzata per caricare il firmware di Klipper. E' necessario l'UUID del dispositivo per eseguire il flashing. Se non si dispone di un UUID \u00e8 possibile interrogare i nodi che attualmente eseguono il bootloader: python3 flash_can.py -q Ci\u00f2 restituir\u00e0 gli UUID per tutti i nodi collegati non attualmente assegnati a un UUID. Questo dovrebbe includere tutti i nodi attualmente nel bootloader. Una volta che hai un UUID, puoi caricare il firmware con il seguente comando: python3 flash_can.py -i can0 -f ~/klipper/out/klipper.bin -u aabbccddeeff Dove aabbccddeeff \u00e8 sostituito dal tuo UUID. Nota che le opzioni -i e -f possono essere omesse, per impostazione predefinita sono rispettivamente can0 e ~/klipper/out/klipper.bin . Quando crei Klipper per l'uso con CanBoot, seleziona l'opzione Bootloader da 8 KiB.","title":"STM32F103/STM32F0x2 con bootloader CanBoot"},{"location":"Bootloaders.html#microcontrollori-stm32f4-skr-pro-11","text":"I microcontrollori STM32F4 sono dotati di un bootloader di sistema integrato in grado di eseguire il flashing su USB (tramite DFU), seriale 3.3v e vari altri metodi (consultare il documento STM AN2606 per ulteriori informazioni). Alcune schede STM32F4, come SKR Pro 1.1, non sono in grado di accedere al bootloader DFU. Il bootloader HID \u00e8 disponibile per schede basate su STM32F405/407 nel caso in cui l'utente preferisca eseguire il flashing su USB anzich\u00e9 utilizzare la scheda SD. Tieni presente che potrebbe essere necessario configurare e creare una versione specifica per la tua scheda, una build per SKR Pro 1.1 \u00e8 disponibile qui . A meno che la tua scheda non sia compatibile con DFU, il metodo di flashing pi\u00f9 accessibile \u00e8 probabilmente tramite seriale 3.3v, che segue la stessa procedura di flash dell'STM32F103 usando stm32flash . Per esempio: wget https://github.com/Arksine/STM32_HID_Bootloader/releases/download/v0.5-beta/hid_bootloader_SKR_PRO.bin stm32flash -w hid_bootloader_SKR_PRO.bin -v -g 0 /dev/ttyAMA0 Questo bootloader richiede 16Kib di spazio flash sull'STM32F4 (l'applicazione deve essere compilata con un indirizzo iniziale di 16KiB). Come con l'STM32F1, l'STM32F4 utilizza lo strumento hid-flash per caricare i file binari nell'MCU. Consulta le istruzioni sopra per i dettagli su come creare e utilizzare hid-flash. Potrebbe essere necessario inserire manualmente il bootloader, questo pu\u00f2 essere fatto impostando \"boot 0\" basso, \"boot 1\" alto e collegando il dispositivo. Al termine della programmazione, scollegare il dispositivo e impostare \"boot 1\" su basso in modo che l'applicazione venga caricata.","title":"Microcontrollori STM32F4 (SKR Pro 1.1)"},{"location":"Bootloaders.html#microcontrollori-lpc176x-smoothieboards","text":"Questo documento non descrive il metodo per eseguire il flashing di un bootloader stesso - vedere: http://smoothieware.org/flashing-the-bootloader per ulteriori informazioni su questo argomento. \u00c8 comune che per le Smoothieboard venga fornito con un bootloader da: https://github.com/triffid/LPC17xx-DFU-Bootloader . Quando si utilizza questo bootloader, l'applicazione deve essere compilata con un indirizzo iniziale di 16 KiB. Il modo pi\u00f9 semplice per eseguire il flashing di un'applicazione con questo bootloader \u00e8 copiare il file dell'applicazione (ad es. out/klipper.bin ) in un file denominato firmware.bin su una scheda SD, quindi riavviare il microcontrollore con quella scheda SD.","title":"Microcontrollori LPC176x (Smoothieboards)"},{"location":"Bootloaders.html#eseguire-openocd-su-raspberry-pi","text":"OpenOCD \u00e8 un pacchetto software in grado di eseguire il flashing e il debug di chip di basso livello. Pu\u00f2 utilizzare i pin GPIO su un Raspberry Pi per comunicare con una variet\u00e0 di chip ARM. Questa sezione descrive come installare e avviare OpenOCD. \u00c8 derivato dalle istruzioni su: https://learn.adafruit.com/programming-microcontrollers-using-openocd-on-raspberry-pi Inizia scaricando e compilando il software (ogni passaggio pu\u00f2 richiedere diversi minuti e il passaggio \"make\" pu\u00f2 richiedere pi\u00f9 di 30 minuti): sudo apt-get update sudo apt-get install autoconf libtool telnet mkdir ~/openocd cd ~/openocd/ git clone http://openocd.zylin.com/openocd cd openocd ./bootstrap ./configure --enable-sysfsgpio --enable-bcm2835gpio --prefix=/home/pi/openocd/install make make install","title":"Eseguire OpenOCD su Raspberry PI"},{"location":"Bootloaders.html#configurare-openocd","text":"Crea un file di configurazione OpenOCD: nano ~/openocd/openocd.cfg Utilizzare una configurazione simile alla seguente: # Uses RPi pins: GPIO25 for SWDCLK, GPIO24 for SWDIO, GPIO18 for nRST source [find interface/raspberrypi2-native.cfg] bcm2835gpio_swd_nums 25 24 bcm2835gpio_srst_num 18 transport select swd # Use hardware reset wire for chip resets reset_config srst_only adapter_nsrst_delay 100 adapter_nsrst_assert_width 100 # Specify the chip type source [find target/atsame5x.cfg] # Set the adapter speed adapter_khz 40 # Connect to chip init targets reset halt","title":"Configurare OpenOCD"},{"location":"Bootloaders.html#collega-il-raspberry-pi-al-chip-di-destinazione","text":"Spegni sia il Raspberry Pi che il chip di destinazione prima del cablaggio! Verificare che il chip di destinazione utilizzi 3,3 V prima di connettersi a un Raspberry Pi! Collega GND, SWDCLK, SWDIO e RST sul chip di destinazione rispettivamente a GND, GPIO25, GPIO24 e GPIO18 sul Raspberry Pi. Quindi accendi il Raspberry Pi e fornisci alimentazione al chip di destinazione.","title":"Collega il Raspberry Pi al chip di destinazione"},{"location":"Bootloaders.html#eseguire-openocd","text":"Esegui OpenOCD: cd ~/openocd/ sudo ~/openocd/install/bin/openocd -f ~/openocd/openocd.cfg Quanto sopra dovrebbe far s\u00ec che OpenOCD emetta alcuni messaggi di testo e quindi attenda (non dovrebbe tornare immediatamente al prompt della shell Unix). Se OpenOCD termina da solo o se continua a emettere messaggi di testo, ricontrolla il cablaggio. Una volta che OpenOCD \u00e8 in esecuzione ed \u00e8 stabile, \u00e8 possibile inviargli comandi tramite telnet. Apri un'altra sessione ssh ed esegui quanto segue: telnet 127.0.0.1 4444 (Si pu\u00f2 uscire da telnet premendo ctrl+] e quindi eseguendo il comando \"quit\".)","title":"Eseguire OpenOCD"},{"location":"Bootloaders.html#openocd-e-gdb","text":"\u00c8 possibile utilizzare OpenOCD con gdb per eseguire il debug di Klipper. I seguenti comandi presuppongono che uno stia eseguendo gdb su una macchina di classe desktop. Aggiungi quanto segue al file di configurazione di OpenOCD: bindto 0.0.0.0 gdb_port 44444 Riavvia OpenOCD sul Raspberry Pi e quindi esegui il seguente comando Unix sul computer desktop: cd /path/to/klipper/ gdb out/klipper.elf All'interno di gdb esegui: target remote octopi:44444 (Sostituisci \"octopi\" con il nome host del Raspberry Pi.) Una volta che gdb \u00e8 in esecuzione, \u00e8 possibile impostare punti di interruzione e ispezionare i registri.","title":"OpenOCD e gdb"},{"location":"CANBUS.html","text":"CANBUS \u00b6 Questo documento descrive il supporto del CAN bus di Klipper. Hardware del dispositivo \u00b6 Klipper attualmente supporta CAN su chip stm32, same5x e rp2040. Inoltre, il chip del microcontrollore deve trovarsi su una scheda dotata di un ricetrasmettitore CAN. Per compilare per CAN, eseguire make menuconfig e selezionare \"CAN bus\" come interfaccia di comunicazione. Infine, compila il codice del microcontrollore e flashalo sulla scheda di destinazione. Hardware Host \u00b6 Per utilizzare un bus CAN, \u00e8 necessario disporre di un adattatore sul host. Attualmente ci sono due opzioni comuni: Usa un Waveshare Raspberry Pi CAN o uno dei suoi tanti cloni. Utilizzare un adattatore CAN USB (ad esempio https://hacker-gadgets.com/product/cantact-usb-can-adapter/ ). Sono disponibili molti adattatori diversi da USB a CAN: quando ne scegli uno, ti consigliamo di verificare che possa eseguire il candlelight firmware . (Sfortunatamente, abbiamo riscontrato che alcuni adattatori USB eseguono firmware difettoso e sono bloccati, quindi verifica prima dell'acquisto.) \u00c8 inoltre necessario configurare il sistema operativo host per utilizzare l'adattatore. Questo viene in genere fatto creando un nuovo file chiamato /etc/network/interfaces.d/can0 con il seguente contenuto: auto can0 iface can0 can static bitrate 500000 up ifconfig $IFACE txqueuelen 128 Nota che il \"Raspberry Pi CAN hat\" richiede anche modifiche a config.txt . Resistori di terminazione \u00b6 Un bus CAN dovrebbe avere due resistori da 120 ohm tra i cavi CANH e CANL. Idealmente, un resistore situato a ciascuna estremit\u00e0 del bus. Si noti che alcuni dispositivi hanno un resistore integrato da 120 ohm (ad esempio, il \"Waveshare Raspberry Pi CAN\" ha un resistore saldato che non pu\u00f2 essere rimosso facilmente). Alcuni dispositivi non includono affatto un resistore. Altri dispositivi hanno un meccanismo per selezionare il resistore (in genere collegando un \"ponticello jumper\"). Assicurati di controllare gli schemi di tutti i dispositivi sul bus CAN per verificare che ci siano due e solo due resistori da 120 Ohm sul bus. Per verificare che i resistori siano corretti, \u00e8 possibile rimuovere l'alimentazione alla stampante e utilizzare un multimetro per controllare la resistenza tra i cavi CNH e CANL: dovrebbe riportare ~60 ohm su un bus CAN cablato correttamente. Trovare canbus_uuid per nuovi microcontrollori \u00b6 A ogni microcontrollore sul bus CAN viene assegnato un ID univoco basato sull'identificatore del chip di fabbrica codificato in ciascun microcontrollore. Per trovare l'ID di ciascun dispositivo del microcontrollore, assicurati che l'hardware sia alimentato e cablato correttamente, quindi esegui: ~/klippy-env/bin/python ~/klipper/scripts/canbus_query.py can0 Se vengono rilevati dispositivi CAN non inizializzati, il comando precedente riporter\u00e0 righe come le seguenti: Found canbus_uuid=11aa22bb33cc, Application: Klipper Ogni dispositivo avr\u00e0 un identificatore univoco. Nell'esempio sopra, 11aa22bb33cc \u00e8 il \"canbus_uuid\" del microcontrollore. Nota che lo strumento canbus_query.py riporter\u00e0 solo i dispositivi non inizializzati - se Klipper (o uno strumento simile) configura il dispositivo, non apparir\u00e0 pi\u00f9 nell'elenco. Configurare Klipper \u00b6 Aggiorna Klipper configurazione mcu per utilizzare il bus CAN per comunicare con il dispositivo, ad esempio: [mcu my_can_mcu] canbus_uuid: 11aa22bb33cc Modalit\u00e0 bridge da USB a CAN bus \u00b6 Alcuni microcontrollori supportano la selezione della modalit\u00e0 \"USB to CAN bus bridge\" durante \"make menuconfig\". Questa modalit\u00e0 pu\u00f2 consentire di utilizzare un microcontrollore sia come \"adattatore bus da USB a CAN\" che come nodo Klipper. Quando Klipper utilizza questa modalit\u00e0, il microcontrollore appare come un \"adattatore bus CAN USB\" sotto Linux. Lo stesso \"Klipper bridge mcu\" apparir\u00e0 come se fosse su questo bus CAN - pu\u00f2 essere identificato tramite canbus_query.py e configurato come altri nodi Klipper del bus CAN. Apparir\u00e0 insieme ad altri dispositivi che sono effettivamente sul bus CAN. Alcune note importanti quando si utilizza questa modalit\u00e0: Il \"bridge mcu\" non \u00e8 effettivamente sul bus CAN. I messaggi in entrata e in uscita non consumano larghezza di banda sul bus CAN. L'mcu non pu\u00f2 essere visto da altri adattatori che potrebbero essere sul bus CAN. \u00c8 necessario configurare l'interfaccia can0 (o simile) in Linux per comunicare con il bus. Tuttavia, Klipper ignora la velocit\u00e0 del bus CAN di Linux e le opzioni di temporizzazione del bus CAN. Attualmente, la frequenza del bus CAN viene specificata durante \"make menuconfig\" e la velocit\u00e0 del bus specificata in Linux viene ignorata. Ogni volta che il \"bridge mcu\" viene ripristinato, Linux disabiliter\u00e0 l'interfaccia can0 corrispondente. Per garantire una corretta gestione dei comandi FIRMWARE_RESTART e RESTART, si consiglia di sostituire auto con allow-hotplug nel file /etc/network/interfaces.d/can0 . Per esempio: allow-hotplug can0 iface can0 can static bitrate 500000 up ifconfig $IFACE txqueuelen 128","title":"CANBUS"},{"location":"CANBUS.html#canbus","text":"Questo documento descrive il supporto del CAN bus di Klipper.","title":"CANBUS"},{"location":"CANBUS.html#hardware-del-dispositivo","text":"Klipper attualmente supporta CAN su chip stm32, same5x e rp2040. Inoltre, il chip del microcontrollore deve trovarsi su una scheda dotata di un ricetrasmettitore CAN. Per compilare per CAN, eseguire make menuconfig e selezionare \"CAN bus\" come interfaccia di comunicazione. Infine, compila il codice del microcontrollore e flashalo sulla scheda di destinazione.","title":"Hardware del dispositivo"},{"location":"CANBUS.html#hardware-host","text":"Per utilizzare un bus CAN, \u00e8 necessario disporre di un adattatore sul host. Attualmente ci sono due opzioni comuni: Usa un Waveshare Raspberry Pi CAN o uno dei suoi tanti cloni. Utilizzare un adattatore CAN USB (ad esempio https://hacker-gadgets.com/product/cantact-usb-can-adapter/ ). Sono disponibili molti adattatori diversi da USB a CAN: quando ne scegli uno, ti consigliamo di verificare che possa eseguire il candlelight firmware . (Sfortunatamente, abbiamo riscontrato che alcuni adattatori USB eseguono firmware difettoso e sono bloccati, quindi verifica prima dell'acquisto.) \u00c8 inoltre necessario configurare il sistema operativo host per utilizzare l'adattatore. Questo viene in genere fatto creando un nuovo file chiamato /etc/network/interfaces.d/can0 con il seguente contenuto: auto can0 iface can0 can static bitrate 500000 up ifconfig $IFACE txqueuelen 128 Nota che il \"Raspberry Pi CAN hat\" richiede anche modifiche a config.txt .","title":"Hardware Host"},{"location":"CANBUS.html#resistori-di-terminazione","text":"Un bus CAN dovrebbe avere due resistori da 120 ohm tra i cavi CANH e CANL. Idealmente, un resistore situato a ciascuna estremit\u00e0 del bus. Si noti che alcuni dispositivi hanno un resistore integrato da 120 ohm (ad esempio, il \"Waveshare Raspberry Pi CAN\" ha un resistore saldato che non pu\u00f2 essere rimosso facilmente). Alcuni dispositivi non includono affatto un resistore. Altri dispositivi hanno un meccanismo per selezionare il resistore (in genere collegando un \"ponticello jumper\"). Assicurati di controllare gli schemi di tutti i dispositivi sul bus CAN per verificare che ci siano due e solo due resistori da 120 Ohm sul bus. Per verificare che i resistori siano corretti, \u00e8 possibile rimuovere l'alimentazione alla stampante e utilizzare un multimetro per controllare la resistenza tra i cavi CNH e CANL: dovrebbe riportare ~60 ohm su un bus CAN cablato correttamente.","title":"Resistori di terminazione"},{"location":"CANBUS.html#trovare-canbus_uuid-per-nuovi-microcontrollori","text":"A ogni microcontrollore sul bus CAN viene assegnato un ID univoco basato sull'identificatore del chip di fabbrica codificato in ciascun microcontrollore. Per trovare l'ID di ciascun dispositivo del microcontrollore, assicurati che l'hardware sia alimentato e cablato correttamente, quindi esegui: ~/klippy-env/bin/python ~/klipper/scripts/canbus_query.py can0 Se vengono rilevati dispositivi CAN non inizializzati, il comando precedente riporter\u00e0 righe come le seguenti: Found canbus_uuid=11aa22bb33cc, Application: Klipper Ogni dispositivo avr\u00e0 un identificatore univoco. Nell'esempio sopra, 11aa22bb33cc \u00e8 il \"canbus_uuid\" del microcontrollore. Nota che lo strumento canbus_query.py riporter\u00e0 solo i dispositivi non inizializzati - se Klipper (o uno strumento simile) configura il dispositivo, non apparir\u00e0 pi\u00f9 nell'elenco.","title":"Trovare canbus_uuid per nuovi microcontrollori"},{"location":"CANBUS.html#configurare-klipper","text":"Aggiorna Klipper configurazione mcu per utilizzare il bus CAN per comunicare con il dispositivo, ad esempio: [mcu my_can_mcu] canbus_uuid: 11aa22bb33cc","title":"Configurare Klipper"},{"location":"CANBUS.html#modalita-bridge-da-usb-a-can-bus","text":"Alcuni microcontrollori supportano la selezione della modalit\u00e0 \"USB to CAN bus bridge\" durante \"make menuconfig\". Questa modalit\u00e0 pu\u00f2 consentire di utilizzare un microcontrollore sia come \"adattatore bus da USB a CAN\" che come nodo Klipper. Quando Klipper utilizza questa modalit\u00e0, il microcontrollore appare come un \"adattatore bus CAN USB\" sotto Linux. Lo stesso \"Klipper bridge mcu\" apparir\u00e0 come se fosse su questo bus CAN - pu\u00f2 essere identificato tramite canbus_query.py e configurato come altri nodi Klipper del bus CAN. Apparir\u00e0 insieme ad altri dispositivi che sono effettivamente sul bus CAN. Alcune note importanti quando si utilizza questa modalit\u00e0: Il \"bridge mcu\" non \u00e8 effettivamente sul bus CAN. I messaggi in entrata e in uscita non consumano larghezza di banda sul bus CAN. L'mcu non pu\u00f2 essere visto da altri adattatori che potrebbero essere sul bus CAN. \u00c8 necessario configurare l'interfaccia can0 (o simile) in Linux per comunicare con il bus. Tuttavia, Klipper ignora la velocit\u00e0 del bus CAN di Linux e le opzioni di temporizzazione del bus CAN. Attualmente, la frequenza del bus CAN viene specificata durante \"make menuconfig\" e la velocit\u00e0 del bus specificata in Linux viene ignorata. Ogni volta che il \"bridge mcu\" viene ripristinato, Linux disabiliter\u00e0 l'interfaccia can0 corrispondente. Per garantire una corretta gestione dei comandi FIRMWARE_RESTART e RESTART, si consiglia di sostituire auto con allow-hotplug nel file /etc/network/interfaces.d/can0 . Per esempio: allow-hotplug can0 iface can0 can static bitrate 500000 up ifconfig $IFACE txqueuelen 128","title":"Modalit\u00e0 bridge da USB a CAN bus"},{"location":"CANBUS_protocol.html","text":"Protocollo CANBUS \u00b6 Questo documento descrive il protocollo utilizzato da Klipper per comunicare su CAN bus . Vedere per informazioni sulla configurazione di Klipper con CANBUS. Assegnazione dell'id del microcontrollore \u00b6 Klipper utilizza solo pacchetti CAN bus di dimensioni standard CAN 2.0A, che sono limitati a 8 byte di dati e un identificatore bus CAN a 11 bit. Per supportare una comunicazione efficiente, a ogni microcontrollore viene assegnato in fase di esecuzione un ID nodo bus CAN univoco a 1 byte (\"canbus_nodeid\") per il traffico generale di comandi e risposte Klipper. I messaggi di comando di Klipper che vanno dall'host al microcontrollore utilizzano l'ID bus CAN di canbus_nodeid * 2 + 256 , mentre i messaggi di risposta di Klipper dal microcontrollore all'host usano canbus_nodeid * 2 + 256 + 1 . Ogni microcontrollore ha un identificatore di chip univoco assegnato in fabbrica che viene utilizzato durante l'assegnazione dell'ID. Questo identificatore pu\u00f2 superare la lunghezza di un pacchetto CAN, quindi una funzione hash viene utilizzata per generare un ID univoco a 6 byte ( canbus_uuid ) dall'ID di fabbrica. Messaggi dell'amministratore \u00b6 I messaggi dell'amministratore vengono utilizzati per l'assegnazione dell'ID. I messaggi di amministrazione inviati dall'host al microcontrollore utilizzano l'ID bus CAN \"0x3f0\" e i messaggi inviati dal microcontrollore all'host utilizzano l'ID bus CAN \"0x3f1\". Tutti i microcontrollori ascoltano i messaggi sull'id 0x3f0 ; quell'ID pu\u00f2 essere considerato un \"indirizzo di trasmissione\". messaggio CMD_QUERY_UNASSIGNED \u00b6 Questo comando interroga tutti i microcontrollori a cui non \u00e8 stato ancora assegnato un canbus_nodeid . I microcontrollori non assegnati risponderanno con un messaggio di risposta RESP_NEED_NODEID. Il formato del messaggio CMD_QUERY_UNASSIGNED \u00e8: <1 byte message_id = 0x00> CMD_SET_KLIPPER_NODEID messaggio \u00b6 Questo comando assegna un canbus_nodeid al microcontrollore con un dato canbus_uuid . Il formato del messaggio CMD_SET_KLIPPER_NODEID \u00e8: <1-byte message_id = 0x01><6-byte canbus_uuid><1-byte canbus_nodeid> Messaggio RESP_NEED_NODEID \u00b6 Il formato del messaggio RESP_NEED_NODEID \u00e8: <1-byte message_id = 0x20><6-byte canbus_uuid><1-byte set_klipper_nodeid = 0x01> Pacchetti dati \u00b6 Un microcontrollore a cui \u00e8 stato assegnato un nodeid tramite il comando CMD_SET_KLIPPER_NODEID pu\u00f2 inviare e ricevere pacchetti di dati. I dati del pacchetto nei messaggi che utilizzano l'ID bus CAN di ricezione del nodo ( canbus_nodeid * 2 + 256 ) vengono semplicemente aggiunti a un buffer e quando viene trovato un mcu protocol message completo, il suo contenuto viene analizzato ed elaborato . I dati vengono trattati come un flusso di byte: non \u00e8 necessario che l'inizio di un blocco di messaggi Klipper sia allineato con l'inizio di un pacchetto bus CAN. Allo stesso modo, le risposte ai messaggi del protocollo mcu vengono inviate dal microcontrollore all'host copiando i dati del messaggio in uno o pi\u00f9 pacchetti con l'ID del bus CAN di trasmissione del nodo ( canbus_nodeid * 2 + 256 + 1 ).","title":"Protocollo CANBUS"},{"location":"CANBUS_protocol.html#protocollo-canbus","text":"Questo documento descrive il protocollo utilizzato da Klipper per comunicare su CAN bus . Vedere per informazioni sulla configurazione di Klipper con CANBUS.","title":"Protocollo CANBUS"},{"location":"CANBUS_protocol.html#assegnazione-dellid-del-microcontrollore","text":"Klipper utilizza solo pacchetti CAN bus di dimensioni standard CAN 2.0A, che sono limitati a 8 byte di dati e un identificatore bus CAN a 11 bit. Per supportare una comunicazione efficiente, a ogni microcontrollore viene assegnato in fase di esecuzione un ID nodo bus CAN univoco a 1 byte (\"canbus_nodeid\") per il traffico generale di comandi e risposte Klipper. I messaggi di comando di Klipper che vanno dall'host al microcontrollore utilizzano l'ID bus CAN di canbus_nodeid * 2 + 256 , mentre i messaggi di risposta di Klipper dal microcontrollore all'host usano canbus_nodeid * 2 + 256 + 1 . Ogni microcontrollore ha un identificatore di chip univoco assegnato in fabbrica che viene utilizzato durante l'assegnazione dell'ID. Questo identificatore pu\u00f2 superare la lunghezza di un pacchetto CAN, quindi una funzione hash viene utilizzata per generare un ID univoco a 6 byte ( canbus_uuid ) dall'ID di fabbrica.","title":"Assegnazione dell'id del microcontrollore"},{"location":"CANBUS_protocol.html#messaggi-dellamministratore","text":"I messaggi dell'amministratore vengono utilizzati per l'assegnazione dell'ID. I messaggi di amministrazione inviati dall'host al microcontrollore utilizzano l'ID bus CAN \"0x3f0\" e i messaggi inviati dal microcontrollore all'host utilizzano l'ID bus CAN \"0x3f1\". Tutti i microcontrollori ascoltano i messaggi sull'id 0x3f0 ; quell'ID pu\u00f2 essere considerato un \"indirizzo di trasmissione\".","title":"Messaggi dell'amministratore"},{"location":"CANBUS_protocol.html#messaggio-cmd_query_unassigned","text":"Questo comando interroga tutti i microcontrollori a cui non \u00e8 stato ancora assegnato un canbus_nodeid . I microcontrollori non assegnati risponderanno con un messaggio di risposta RESP_NEED_NODEID. Il formato del messaggio CMD_QUERY_UNASSIGNED \u00e8: <1 byte message_id = 0x00>","title":"messaggio CMD_QUERY_UNASSIGNED"},{"location":"CANBUS_protocol.html#cmd_set_klipper_nodeid-messaggio","text":"Questo comando assegna un canbus_nodeid al microcontrollore con un dato canbus_uuid . Il formato del messaggio CMD_SET_KLIPPER_NODEID \u00e8: <1-byte message_id = 0x01><6-byte canbus_uuid><1-byte canbus_nodeid>","title":"CMD_SET_KLIPPER_NODEID messaggio"},{"location":"CANBUS_protocol.html#messaggio-resp_need_nodeid","text":"Il formato del messaggio RESP_NEED_NODEID \u00e8: <1-byte message_id = 0x20><6-byte canbus_uuid><1-byte set_klipper_nodeid = 0x01>","title":"Messaggio RESP_NEED_NODEID"},{"location":"CANBUS_protocol.html#pacchetti-dati","text":"Un microcontrollore a cui \u00e8 stato assegnato un nodeid tramite il comando CMD_SET_KLIPPER_NODEID pu\u00f2 inviare e ricevere pacchetti di dati. I dati del pacchetto nei messaggi che utilizzano l'ID bus CAN di ricezione del nodo ( canbus_nodeid * 2 + 256 ) vengono semplicemente aggiunti a un buffer e quando viene trovato un mcu protocol message completo, il suo contenuto viene analizzato ed elaborato . I dati vengono trattati come un flusso di byte: non \u00e8 necessario che l'inizio di un blocco di messaggi Klipper sia allineato con l'inizio di un pacchetto bus CAN. Allo stesso modo, le risposte ai messaggi del protocollo mcu vengono inviate dal microcontrollore all'host copiando i dati del messaggio in uno o pi\u00f9 pacchetti con l'ID del bus CAN di trasmissione del nodo ( canbus_nodeid * 2 + 256 + 1 ).","title":"Pacchetti dati"},{"location":"CONTRIBUTING.html","text":"Contribuire a Klipper \u00b6 Grazie per aver contribuito a Klipper! Questo documento descrive il processo per contribuire alle modifiche di Klipper. Consulta la contact page per informazioni sulla segnalazione di un problema o per i dettagli su come contattare gli sviluppatori. Panoramica del processo di contribuzione \u00b6 I contributi a Klipper seguono generalmente un processo di alto livello: Inizia creando una Richiesta pull GitHub quando un proposta \u00e8 pronta per la diffusione. Quando un reviewer \u00e8 disponibile per review l'invio, si assegner\u00e0 la richiesta pull su GitHub. L'obiettivo della revisione \u00e8 cercare i difetti e verificare che la proposta segua linee guida documentate. Dopo una revisione riuscita, il revisore \"approver\u00e0 la revisione\" su GitHub e un maintainer eseguir\u00e0 il commit della modifica al ramo principale di Klipper. Quando lavori sui miglioramenti, considera di iniziare (o contribuire a) un argomento su Klipper Discourse . Una discussione in corso sul forum pu\u00f2 migliorare la visibilit\u00e0 del lavoro di sviluppo e pu\u00f2 attirare altri interessati a testare nuovi lavori. Cosa aspettarsi da una revisione \u00b6 I contributi a Klipper vengono rivisti prima del merging. L'obiettivo principale del processo di revisione \u00e8 verificare la presenza di difetti e verificare che la presentazione segua le linee guida specificate nella documentazione di Klipper. Resta inteso che ci sono molti modi per portare a termine un compito; non \u00e8 intenzione della revisione discutere la \"migliore\" implementazione. Ove possibile, sono preferibili discussioni di revisione incentrate su fatti e misurazioni. La maggior parte degli invii otterr\u00e0 in feedback da una recensione. Preparati a ottenere feedback, fornire ulteriori dettagli e aggiornare l'invio, se necessario. Cose comuni che un revisore cercher\u00e0: L'invio \u00e8 privo di difetti ed \u00e8 pronto per essere diffuso?I realizzatori dei contributi sono tenuti a testare le loro modifiche prima dell'invio. I revisori cercano gli errori, ma in generale non testano gli invii. Un invio accettato viene spesso distribuito a migliaia di stampanti entro poche settimane dall'accettazione. La qualit\u00e0 degli invii \u00e8 quindi considerata una priorit\u00e0. Il repository GitHub principale Klipper3d/klipper non accetta lavori sperimentali. I realizzatori di contributi devono eseguire la sperimentazione, il debug e il test nei propri repository. Il server Klipper Discourse \u00e8 un buon posto per aumentare la consapevolezza del nuovo lavoro e per trovare utenti interessati a fornire feedback nel mondo reale. Gli invii devono superare tutti i test di regressione . Quando si corregge un difetto nel codice, i submitters dovrebbero avere una comprensione generale della causa principale di tale difetto e la correzione dovrebbe mirare a tale causa principale. Gli contributi di codice non devono contenere codice di debug eccessivo, opzioni di debug o registrazione del debug in fase di runtime. I commenti negli invii di codice dovrebbero concentrarsi sul miglioramento della manutenzione del codice. Gli invii non devono contenere \"codice commentato\" n\u00e9 commenti eccessivi che descrivono implementazioni passate. Non dovrebbero esserci commenti \"todo\" eccessivi. Gli aggiornamenti alla documentazione non devono dichiarare che si tratta di un \"work in progress\". L'invio fornisce un vantaggio \"ad alto impatto\" per gli utenti del mondo reale che svolgono attivit\u00e0 nel mondo reale?I revisori devono identificare, almeno nella loro mente, approssimativamente \"chi \u00e8 il pubblico di destinazione\", una scala approssimativa delle \"dimensioni di quel pubblico\", il \"beneficio\" che otterranno, come \"il beneficio viene misurato\" e i \"risultati di tali prove di misurazione\". Nella maggior parte dei casi questo sar\u00e0 ovvio sia per il mittente che per il revisore e non \u00e8 esplicitamente dichiarato durante una revisione. Le proposte al ramo principale di Klipper dovrebbero avere un pubblico di destinazione degno di nota. Come \"regola pratica\" generale, gli invii dovrebbero avere come target una base di utenti di almeno 100 utenti del mondo reale. Se un revisore chiede dettagli sul \"beneficio\" di un invio, non considerarlo una critica. Essere in grado di comprendere i vantaggi reali di un cambiamento \u00e8 una parte naturale di una revisione. Quando si discute dei benefici \u00e8 preferibile discutere di \"fatti e misurazioni\". In generale, i revisori non cercano risposte del modulo \"qualcuno potrebbe trovare utile l'opzione X\", n\u00e9 cercano risposte del modulo \"questo invio aggiunge una funzionalit\u00e0 implementata dal firmware X\". Invece, \u00e8 generalmente preferibile discutere i dettagli su come \u00e8 stato misurato il miglioramento della qualit\u00e0 e quali sono stati i risultati di tali misurazioni, ad esempio \"i test sulle stampanti Acme X1000 mostrano angoli migliorati come si vede in figura...\", o ad esempio \" il tempo di stampa dell'oggetto reale X su una stampante Foomatic X900 \u00e8 passato da 4 ore a 3,5 ore\". Resta inteso che i test di questo tipo possono richiedere molto tempo e sforzi. Alcune delle caratteristiche pi\u00f9 importanti di Klipper hanno richiesto mesi di discussioni, rielaborazioni, test e documentazione prima di essere fuse nel ramo principale. Tutti i nuovi moduli, opzioni di configurazione, comandi, parametri di comando e documenti dovrebbero avere un \"impatto elevato\". Non vogliamo appesantire gli utenti con opzioni che non possono configurare ragionevolmente n\u00e9 vogliamo appesantirli con opzioni che non forniscono un vantaggio notevole. Un revisore pu\u00f2 chiedere chiarimenti su come un utente deve configurare un'opzione - una risposta ideale conterr\u00e0 dettagli sul processo - ad esempio, \"gli utenti del MegaX500 dovrebbero impostare l'opzione X su 99,3 mentre gli utenti dell'Elite100Y dovrebbero calibrare l'opzione X usando la procedura ...\". Se l'obiettivo di un'opzione \u00e8 rendere il codice pi\u00f9 modulare, \u00e8 preferibile utilizzare le costanti del codice invece delle opzioni di configurazione rivolte all'utente. Nuovi moduli, nuove opzioni e nuovi parametri non dovrebbero fornire funzionalit\u00e0 simili ai moduli esistenti: se le differenze sono arbitrarie, \u00e8 preferibile utilizzare il sistema esistente o effettuare refactoring del codice esistente. Il copyright dell'invio \u00e8 chiaro, non gratuito e compatibile?I nuovi file C e Python dovrebbero avere una dichiarazione di copyright univoca. Vedere i file esistenti per il formato preferito. \u00c8 sconsigliato dichiarare un copyright su un file esistente quando si apportano modifiche minori a quel file. Il codice prelevato da fonti di terze parti deve essere compatibile con la licenza Klipper (GNU GPLv3). Grandi aggiunte di codice di terze parti dovrebbero essere aggiunte alla directory lib/ (e seguire il formato descritto in lib/README ). I mittenti devono fornire una Signed-off-line utilizzando il loro vero nome completo. Indica che il mittente \u00e8 d'accordo con il developer certificate of origin . L'invio segue le linee guida specificate nella documentazione di Klipper?In particolare, il codice deve seguire le linee guida in e i file di configurazione devono seguire le linee guida in . La documentazione di Klipper \u00e8 aggiornata per riflettere le nuove modifiche?Come minimo, la documentazione di riferimento deve essere aggiornata con le relative modifiche al codice: Tutti i comandi e i relativi parametri devono essere documentati in . Tutti i moduli rivolti all'utente e i relativi parametri di configurazione devono essere documentati in . Tutte le \"variabili di stato\" esportate devono essere documentate in . Tutti i nuovi \"webhook\" e i relativi parametri devono essere documentati in . Qualsiasi modifica che apporti una modifica non compatibile con le versioni precedenti a un comando o a un'impostazione del file di configurazione deve essere documentata in . I nuovi documenti dovrebbero essere aggiunti a e all'indice del sito web docs/_klipper3d/mkdocs.yml . I commit sono ben formati, affrontano un singolo argomento per commit e sono indipendenti?I messaggi di commit devono seguire il formato preferito . I commit non devono avere un conflitto in fase di merge. Le nuove aggiunte al ramo principale di Klipper vengono sempre eseguite tramite un \"rebase\" o \"squash and rebase\". In genere non \u00e8 necessario che i propositori uniscano nuovamente il loro invio ad ogni aggiornamento al repository principale di Klipper. Tuttavia, se c'\u00e8 un conflitto in fase di merge, si consiglia ai mittenti di usare git rebase per risolvere il conflitto. Ogni commit dovrebbe affrontare una singola modifica di alto livello. Le modifiche di grandi dimensioni dovrebbero essere suddivise in pi\u00f9 commit indipendenti. Ogni commit dovrebbe \"stare in piedi da solo\" in modo che strumenti come git bisect e git revert funzionino in modo affidabile. Le modifiche agli spazi bianchi non devono essere mescolate con le modifiche funzionali. In generale, le modifiche agli spazi bianchi gratuite non sono accettate a meno che non provengano dal \"proprietario\" stabilito del codice da modificare. Klipper non implementa una rigida \"guida allo stile di codifica\", ma le modifiche al codice esistente dovrebbero seguire il flusso di codice di alto livello, lo stile di indentazione del codice e il formato di quel codice esistente. Gli invii di nuovi moduli e sistemi hanno una maggiore flessibilit\u00e0 nello stile di codifica, ma \u00e8 preferibile che il nuovo codice segua uno stile internamente coerente e generalmente segua le norme di codifica. Non \u00e8 un obiettivo di una revisione discutere di \"migliori implementazioni\". Tuttavia, se un revisore ha difficolt\u00e0 a comprendere l'implementazione di un invio, pu\u00f2 richiedere modifiche per rendere l'implementazione pi\u00f9 trasparente. In particolare, se i revisori non riescono a convincersi che un contributo \u00e8 privo di difetti, potrebbero essere necessarie modifiche. Come parte di una revisione, un revisore pu\u00f2 creare una richiesta pull alternativa per un argomento. Questo pu\u00f2 essere fatto per evitare eccessivi \"avanti e indietro\" su elementi procedurali minori e quindi snellire il processo di proposta. Pu\u00f2 anche essere fatto perch\u00e9 la discussione ispira un revisore a costruire un'implementazione alternativa. Entrambe le situazioni sono il normale risultato di una revisione e non devono essere considerate critiche alla proposta originale. Aiutare con le revisioni \u00b6 Apprezziamo l'aiuto con le recensioni! Non \u00e8 necessario essere un revisore elencato per eseguire una revisione. I propositori di richieste pull di GitHub sono inoltre incoraggiati a rivedere i propri invii. Per aiutare con una revisione, segui i passaggi descritti in cosa aspettarsi in una revisione per verificare l'invio. Dopo aver completato la revisione, aggiungi un commento alla richiesta pull di GitHub con i tuoi risultati. Se l'invio supera la revisione, si prega di dichiararlo esplicitamente nel commento, ad esempio qualcosa del tipo \"Ho esaminato questa modifica in base ai passaggi del documento CONTRIBUTING e tutto mi sembra a posto\". Se non \u00e8 possibile completare alcuni passaggi della revisione, indicare esplicitamente quali passaggi sono stati rivisti e quali non sono stati rivisti, ad esempio qualcosa del tipo \"Non ho verificato la presenza di difetti nel codice, ma ho rivisto tutto il resto nel documento CONTRIBUTING e sembra buono\". Apprezziamo anche il test degli invii. Se il codice \u00e8 stato testato, aggiungi un commento alla richiesta pull di GitHub con i risultati del tuo test: successo o fallimento. Si prega di affermare esplicitamente che il codice \u00e8 stato testato e i risultati, ad esempio qualcosa del tipo \"Ho testato questo codice sulla mia stampante Acme900Z con una stampa a vaso e i risultati sono stati buoni\". Revisori \u00b6 I \"revisori\" di Klipper sono: Nome GitHub Id Aree di interesse Dmitry Butyugin @dmbutyugin Input shaping, test di risonanza, cinematica Eric Callahan @Arksine Livellamento del piatto, flashing MCU Kevin O'Connor @KevinOConnor Core motion system, codice microcontrollore Paul McGowan @mental405 File di configurazione, documentazione Si prega di non eseguire il \"ping\" di nessuno dei revisori e di non indirizzare gli invii a loro. Tutti i revisori controllano i forum e le PR e si occuperanno delle revisioni quando ne avranno il tempo. I \"manutentori\" di Klipper sono: Nome nome GitHub Kevin O'Connor @KevinOConnor Formato dei messaggi di commit \u00b6 Ogni commit dovrebbe avere un messaggio di commit formattato in modo simile al seguente: modulo: Riepilogo breve (50 caratteri o meno) in maiuscolo Testo esplicativo pi\u00f9 dettagliato, se necessario. Incolonna a circa 75 caratteri o gi\u00f9 di l\u00ec. In alcuni contesti, la prima riga \u00e8 trattata come l'oggetto di un'e-mail e il resto del testo come corpo. La riga vuota che separa il riassunto dal corpo \u00e8 critica (a meno che non si ometta del tutto il corpo); strumenti come rebase possono confondersi se li metti due insieme. Ulteriori paragrafi vengono dopo le righe vuote.. Firmato da: Il mio nome <myemail@example.org> Nell'esempio sopra, module dovrebbe essere il nome di un file o di una directory nel repository (senza un'estensione di file). Ad esempio, clocksync: fix di errore di battitura nella chiamata pause() al momento della connessione . Lo scopo di specificare un nome di modulo nel messaggio di commit \u00e8 di aiutare a fornire il contesto per i commenti di commit. \u00c8 importante avere una riga \"Signed-off-by\" su ogni commit - certifica che accetti il developer certificate of origin . Deve contenere il tuo vero nome (mi dispiace, niente pseudonimi o contributi anonimi) e contenere un indirizzo email corrente. Contribuire a Traduzioni Klipper \u00b6 Klipper-translations Project \u00e8 un progetto dedicato alla traduzione di Klipper in diverse lingue. Weblate ospita tutte le stringhe Gettext per la traduzione e la revisione. Le impostazioni locali possono essere visualizzate su klipper3d.org una volta che soddisfano i seguenti requisiti: 75% Copertura totale Tutti i titoli (H1) sono tradotti Una gerarchia di navigazione PR aggiornata nelle traduzioni klipper. Per ridurre la frustrazione di tradurre termini specifici del dominio e acquisire consapevolezza delle traduzioni in corso, puoi inviare un PR modificando il Klipper-translations Project readme.md . Una volta che una traduzione \u00e8 pronta, \u00e8 possibile apportare la modifica corrispondente al progetto Klipper. Se una traduzione esiste gi\u00e0 nel repository Klipper e non soddisfa pi\u00f9 l'elenco di controllo di cui sopra, verr\u00e0 contrassegnata come obsoleta dopo un mese senza aggiornamenti. Una volta soddisfatti i requisiti, \u00e8 necessario: aggiorna il repository di klipper-translations active_translations Opzionale: aggiungi un file manual-index.md nella cartella docs\\locals\\<lang> del repository klipper-translations per sostituire index.md specifico della lingua (il file index.md generato non viene visualizzato correttamente). Problemi noti: Al momento, non esiste un metodo per tradurre correttamente le immagini nella documentazione \u00c8 impossibile tradurre i titoli in mkdocs.yml.","title":"Contribuire a Klipper"},{"location":"CONTRIBUTING.html#contribuire-a-klipper","text":"Grazie per aver contribuito a Klipper! Questo documento descrive il processo per contribuire alle modifiche di Klipper. Consulta la contact page per informazioni sulla segnalazione di un problema o per i dettagli su come contattare gli sviluppatori.","title":"Contribuire a Klipper"},{"location":"CONTRIBUTING.html#panoramica-del-processo-di-contribuzione","text":"I contributi a Klipper seguono generalmente un processo di alto livello: Inizia creando una Richiesta pull GitHub quando un proposta \u00e8 pronta per la diffusione. Quando un reviewer \u00e8 disponibile per review l'invio, si assegner\u00e0 la richiesta pull su GitHub. L'obiettivo della revisione \u00e8 cercare i difetti e verificare che la proposta segua linee guida documentate. Dopo una revisione riuscita, il revisore \"approver\u00e0 la revisione\" su GitHub e un maintainer eseguir\u00e0 il commit della modifica al ramo principale di Klipper. Quando lavori sui miglioramenti, considera di iniziare (o contribuire a) un argomento su Klipper Discourse . Una discussione in corso sul forum pu\u00f2 migliorare la visibilit\u00e0 del lavoro di sviluppo e pu\u00f2 attirare altri interessati a testare nuovi lavori.","title":"Panoramica del processo di contribuzione"},{"location":"CONTRIBUTING.html#cosa-aspettarsi-da-una-revisione","text":"I contributi a Klipper vengono rivisti prima del merging. L'obiettivo principale del processo di revisione \u00e8 verificare la presenza di difetti e verificare che la presentazione segua le linee guida specificate nella documentazione di Klipper. Resta inteso che ci sono molti modi per portare a termine un compito; non \u00e8 intenzione della revisione discutere la \"migliore\" implementazione. Ove possibile, sono preferibili discussioni di revisione incentrate su fatti e misurazioni. La maggior parte degli invii otterr\u00e0 in feedback da una recensione. Preparati a ottenere feedback, fornire ulteriori dettagli e aggiornare l'invio, se necessario. Cose comuni che un revisore cercher\u00e0: L'invio \u00e8 privo di difetti ed \u00e8 pronto per essere diffuso?I realizzatori dei contributi sono tenuti a testare le loro modifiche prima dell'invio. I revisori cercano gli errori, ma in generale non testano gli invii. Un invio accettato viene spesso distribuito a migliaia di stampanti entro poche settimane dall'accettazione. La qualit\u00e0 degli invii \u00e8 quindi considerata una priorit\u00e0. Il repository GitHub principale Klipper3d/klipper non accetta lavori sperimentali. I realizzatori di contributi devono eseguire la sperimentazione, il debug e il test nei propri repository. Il server Klipper Discourse \u00e8 un buon posto per aumentare la consapevolezza del nuovo lavoro e per trovare utenti interessati a fornire feedback nel mondo reale. Gli invii devono superare tutti i test di regressione . Quando si corregge un difetto nel codice, i submitters dovrebbero avere una comprensione generale della causa principale di tale difetto e la correzione dovrebbe mirare a tale causa principale. Gli contributi di codice non devono contenere codice di debug eccessivo, opzioni di debug o registrazione del debug in fase di runtime. I commenti negli invii di codice dovrebbero concentrarsi sul miglioramento della manutenzione del codice. Gli invii non devono contenere \"codice commentato\" n\u00e9 commenti eccessivi che descrivono implementazioni passate. Non dovrebbero esserci commenti \"todo\" eccessivi. Gli aggiornamenti alla documentazione non devono dichiarare che si tratta di un \"work in progress\". L'invio fornisce un vantaggio \"ad alto impatto\" per gli utenti del mondo reale che svolgono attivit\u00e0 nel mondo reale?I revisori devono identificare, almeno nella loro mente, approssimativamente \"chi \u00e8 il pubblico di destinazione\", una scala approssimativa delle \"dimensioni di quel pubblico\", il \"beneficio\" che otterranno, come \"il beneficio viene misurato\" e i \"risultati di tali prove di misurazione\". Nella maggior parte dei casi questo sar\u00e0 ovvio sia per il mittente che per il revisore e non \u00e8 esplicitamente dichiarato durante una revisione. Le proposte al ramo principale di Klipper dovrebbero avere un pubblico di destinazione degno di nota. Come \"regola pratica\" generale, gli invii dovrebbero avere come target una base di utenti di almeno 100 utenti del mondo reale. Se un revisore chiede dettagli sul \"beneficio\" di un invio, non considerarlo una critica. Essere in grado di comprendere i vantaggi reali di un cambiamento \u00e8 una parte naturale di una revisione. Quando si discute dei benefici \u00e8 preferibile discutere di \"fatti e misurazioni\". In generale, i revisori non cercano risposte del modulo \"qualcuno potrebbe trovare utile l'opzione X\", n\u00e9 cercano risposte del modulo \"questo invio aggiunge una funzionalit\u00e0 implementata dal firmware X\". Invece, \u00e8 generalmente preferibile discutere i dettagli su come \u00e8 stato misurato il miglioramento della qualit\u00e0 e quali sono stati i risultati di tali misurazioni, ad esempio \"i test sulle stampanti Acme X1000 mostrano angoli migliorati come si vede in figura...\", o ad esempio \" il tempo di stampa dell'oggetto reale X su una stampante Foomatic X900 \u00e8 passato da 4 ore a 3,5 ore\". Resta inteso che i test di questo tipo possono richiedere molto tempo e sforzi. Alcune delle caratteristiche pi\u00f9 importanti di Klipper hanno richiesto mesi di discussioni, rielaborazioni, test e documentazione prima di essere fuse nel ramo principale. Tutti i nuovi moduli, opzioni di configurazione, comandi, parametri di comando e documenti dovrebbero avere un \"impatto elevato\". Non vogliamo appesantire gli utenti con opzioni che non possono configurare ragionevolmente n\u00e9 vogliamo appesantirli con opzioni che non forniscono un vantaggio notevole. Un revisore pu\u00f2 chiedere chiarimenti su come un utente deve configurare un'opzione - una risposta ideale conterr\u00e0 dettagli sul processo - ad esempio, \"gli utenti del MegaX500 dovrebbero impostare l'opzione X su 99,3 mentre gli utenti dell'Elite100Y dovrebbero calibrare l'opzione X usando la procedura ...\". Se l'obiettivo di un'opzione \u00e8 rendere il codice pi\u00f9 modulare, \u00e8 preferibile utilizzare le costanti del codice invece delle opzioni di configurazione rivolte all'utente. Nuovi moduli, nuove opzioni e nuovi parametri non dovrebbero fornire funzionalit\u00e0 simili ai moduli esistenti: se le differenze sono arbitrarie, \u00e8 preferibile utilizzare il sistema esistente o effettuare refactoring del codice esistente. Il copyright dell'invio \u00e8 chiaro, non gratuito e compatibile?I nuovi file C e Python dovrebbero avere una dichiarazione di copyright univoca. Vedere i file esistenti per il formato preferito. \u00c8 sconsigliato dichiarare un copyright su un file esistente quando si apportano modifiche minori a quel file. Il codice prelevato da fonti di terze parti deve essere compatibile con la licenza Klipper (GNU GPLv3). Grandi aggiunte di codice di terze parti dovrebbero essere aggiunte alla directory lib/ (e seguire il formato descritto in lib/README ). I mittenti devono fornire una Signed-off-line utilizzando il loro vero nome completo. Indica che il mittente \u00e8 d'accordo con il developer certificate of origin . L'invio segue le linee guida specificate nella documentazione di Klipper?In particolare, il codice deve seguire le linee guida in e i file di configurazione devono seguire le linee guida in . La documentazione di Klipper \u00e8 aggiornata per riflettere le nuove modifiche?Come minimo, la documentazione di riferimento deve essere aggiornata con le relative modifiche al codice: Tutti i comandi e i relativi parametri devono essere documentati in . Tutti i moduli rivolti all'utente e i relativi parametri di configurazione devono essere documentati in . Tutte le \"variabili di stato\" esportate devono essere documentate in . Tutti i nuovi \"webhook\" e i relativi parametri devono essere documentati in . Qualsiasi modifica che apporti una modifica non compatibile con le versioni precedenti a un comando o a un'impostazione del file di configurazione deve essere documentata in . I nuovi documenti dovrebbero essere aggiunti a e all'indice del sito web docs/_klipper3d/mkdocs.yml . I commit sono ben formati, affrontano un singolo argomento per commit e sono indipendenti?I messaggi di commit devono seguire il formato preferito . I commit non devono avere un conflitto in fase di merge. Le nuove aggiunte al ramo principale di Klipper vengono sempre eseguite tramite un \"rebase\" o \"squash and rebase\". In genere non \u00e8 necessario che i propositori uniscano nuovamente il loro invio ad ogni aggiornamento al repository principale di Klipper. Tuttavia, se c'\u00e8 un conflitto in fase di merge, si consiglia ai mittenti di usare git rebase per risolvere il conflitto. Ogni commit dovrebbe affrontare una singola modifica di alto livello. Le modifiche di grandi dimensioni dovrebbero essere suddivise in pi\u00f9 commit indipendenti. Ogni commit dovrebbe \"stare in piedi da solo\" in modo che strumenti come git bisect e git revert funzionino in modo affidabile. Le modifiche agli spazi bianchi non devono essere mescolate con le modifiche funzionali. In generale, le modifiche agli spazi bianchi gratuite non sono accettate a meno che non provengano dal \"proprietario\" stabilito del codice da modificare. Klipper non implementa una rigida \"guida allo stile di codifica\", ma le modifiche al codice esistente dovrebbero seguire il flusso di codice di alto livello, lo stile di indentazione del codice e il formato di quel codice esistente. Gli invii di nuovi moduli e sistemi hanno una maggiore flessibilit\u00e0 nello stile di codifica, ma \u00e8 preferibile che il nuovo codice segua uno stile internamente coerente e generalmente segua le norme di codifica. Non \u00e8 un obiettivo di una revisione discutere di \"migliori implementazioni\". Tuttavia, se un revisore ha difficolt\u00e0 a comprendere l'implementazione di un invio, pu\u00f2 richiedere modifiche per rendere l'implementazione pi\u00f9 trasparente. In particolare, se i revisori non riescono a convincersi che un contributo \u00e8 privo di difetti, potrebbero essere necessarie modifiche. Come parte di una revisione, un revisore pu\u00f2 creare una richiesta pull alternativa per un argomento. Questo pu\u00f2 essere fatto per evitare eccessivi \"avanti e indietro\" su elementi procedurali minori e quindi snellire il processo di proposta. Pu\u00f2 anche essere fatto perch\u00e9 la discussione ispira un revisore a costruire un'implementazione alternativa. Entrambe le situazioni sono il normale risultato di una revisione e non devono essere considerate critiche alla proposta originale.","title":"Cosa aspettarsi da una revisione"},{"location":"CONTRIBUTING.html#aiutare-con-le-revisioni","text":"Apprezziamo l'aiuto con le recensioni! Non \u00e8 necessario essere un revisore elencato per eseguire una revisione. I propositori di richieste pull di GitHub sono inoltre incoraggiati a rivedere i propri invii. Per aiutare con una revisione, segui i passaggi descritti in cosa aspettarsi in una revisione per verificare l'invio. Dopo aver completato la revisione, aggiungi un commento alla richiesta pull di GitHub con i tuoi risultati. Se l'invio supera la revisione, si prega di dichiararlo esplicitamente nel commento, ad esempio qualcosa del tipo \"Ho esaminato questa modifica in base ai passaggi del documento CONTRIBUTING e tutto mi sembra a posto\". Se non \u00e8 possibile completare alcuni passaggi della revisione, indicare esplicitamente quali passaggi sono stati rivisti e quali non sono stati rivisti, ad esempio qualcosa del tipo \"Non ho verificato la presenza di difetti nel codice, ma ho rivisto tutto il resto nel documento CONTRIBUTING e sembra buono\". Apprezziamo anche il test degli invii. Se il codice \u00e8 stato testato, aggiungi un commento alla richiesta pull di GitHub con i risultati del tuo test: successo o fallimento. Si prega di affermare esplicitamente che il codice \u00e8 stato testato e i risultati, ad esempio qualcosa del tipo \"Ho testato questo codice sulla mia stampante Acme900Z con una stampa a vaso e i risultati sono stati buoni\".","title":"Aiutare con le revisioni"},{"location":"CONTRIBUTING.html#revisori","text":"I \"revisori\" di Klipper sono: Nome GitHub Id Aree di interesse Dmitry Butyugin @dmbutyugin Input shaping, test di risonanza, cinematica Eric Callahan @Arksine Livellamento del piatto, flashing MCU Kevin O'Connor @KevinOConnor Core motion system, codice microcontrollore Paul McGowan @mental405 File di configurazione, documentazione Si prega di non eseguire il \"ping\" di nessuno dei revisori e di non indirizzare gli invii a loro. Tutti i revisori controllano i forum e le PR e si occuperanno delle revisioni quando ne avranno il tempo. I \"manutentori\" di Klipper sono: Nome nome GitHub Kevin O'Connor @KevinOConnor","title":"Revisori"},{"location":"CONTRIBUTING.html#formato-dei-messaggi-di-commit","text":"Ogni commit dovrebbe avere un messaggio di commit formattato in modo simile al seguente: modulo: Riepilogo breve (50 caratteri o meno) in maiuscolo Testo esplicativo pi\u00f9 dettagliato, se necessario. Incolonna a circa 75 caratteri o gi\u00f9 di l\u00ec. In alcuni contesti, la prima riga \u00e8 trattata come l'oggetto di un'e-mail e il resto del testo come corpo. La riga vuota che separa il riassunto dal corpo \u00e8 critica (a meno che non si ometta del tutto il corpo); strumenti come rebase possono confondersi se li metti due insieme. Ulteriori paragrafi vengono dopo le righe vuote.. Firmato da: Il mio nome <myemail@example.org> Nell'esempio sopra, module dovrebbe essere il nome di un file o di una directory nel repository (senza un'estensione di file). Ad esempio, clocksync: fix di errore di battitura nella chiamata pause() al momento della connessione . Lo scopo di specificare un nome di modulo nel messaggio di commit \u00e8 di aiutare a fornire il contesto per i commenti di commit. \u00c8 importante avere una riga \"Signed-off-by\" su ogni commit - certifica che accetti il developer certificate of origin . Deve contenere il tuo vero nome (mi dispiace, niente pseudonimi o contributi anonimi) e contenere un indirizzo email corrente.","title":"Formato dei messaggi di commit"},{"location":"CONTRIBUTING.html#contribuire-a-traduzioni-klipper","text":"Klipper-translations Project \u00e8 un progetto dedicato alla traduzione di Klipper in diverse lingue. Weblate ospita tutte le stringhe Gettext per la traduzione e la revisione. Le impostazioni locali possono essere visualizzate su klipper3d.org una volta che soddisfano i seguenti requisiti: 75% Copertura totale Tutti i titoli (H1) sono tradotti Una gerarchia di navigazione PR aggiornata nelle traduzioni klipper. Per ridurre la frustrazione di tradurre termini specifici del dominio e acquisire consapevolezza delle traduzioni in corso, puoi inviare un PR modificando il Klipper-translations Project readme.md . Una volta che una traduzione \u00e8 pronta, \u00e8 possibile apportare la modifica corrispondente al progetto Klipper. Se una traduzione esiste gi\u00e0 nel repository Klipper e non soddisfa pi\u00f9 l'elenco di controllo di cui sopra, verr\u00e0 contrassegnata come obsoleta dopo un mese senza aggiornamenti. Una volta soddisfatti i requisiti, \u00e8 necessario: aggiorna il repository di klipper-translations active_translations Opzionale: aggiungi un file manual-index.md nella cartella docs\\locals\\<lang> del repository klipper-translations per sostituire index.md specifico della lingua (il file index.md generato non viene visualizzato correttamente). Problemi noti: Al momento, non esiste un metodo per tradurre correttamente le immagini nella documentazione \u00c8 impossibile tradurre i titoli in mkdocs.yml.","title":"Contribuire a Traduzioni Klipper"},{"location":"Code_Overview.html","text":"Panoramica del codice \u00b6 Questo documento descrive il formato generale del codice e il flusso principale del codice di Klipper. Directory Layout \u00b6 La directory src/ contiene il sorgente C per il codice del microcontrollore. src/atsam/ , src/atsamd/ , src/avr/ , src/linux/ , src/lpc176x/ , src/ Le directory pru/ e src/stm32/ contengono il codice del microcontrollore specifico dell'architettura. src/simulator/ contiene stub di codice che consentono la compilazione di test del microcontrollore su altre architetture. La directory src/generic/ contiene codice di supporto che pu\u00f2 essere utile in diverse architetture. La build fa in modo che le include di \"board/somefile.h\" guardino prima nella directory dell'architettura corrente (ad esempio, src/avr/somefile.h) e poi nella directory generica (ad esempio, src/generic/somefile.h). La directory klippy/ contiene il software host. La maggior parte del software host \u00e8 scritto in Python, tuttavia la directory klippy/chelper/ contiene alcuni helper del codice C. La directory klippy/kinematics/ contiene il codice della cinematica del robot. La directory klippy/extras/ contiene i \"moduli\" estensibili del codice host. La directory lib/ contiene il codice della libreria di terze parti esterne necessarie per creare alcune destinazioni. La directory config/ contiene file di configurazione della stampante di esempio. La directory scripts/ contiene script di build-time utili per compilare il codice del microcontrollore. La directory test/ contiene test case automatizzati. Durante la compilazione, la build potrebbe creare una directory out/ . Questa contiene oggetti temporanei di compilazione. L'oggetto microcontrollore finale che viene creato \u00e8 out/klipper.elf.hex su AVR e out/klipper.bin su ARM. Flusso del codice del microcontrollore \u00b6 L'esecuzione del codice del microcontrollore inizia nel codice specifico dell'architettura (ad esempio, src/avr/main.c ) che alla fine chiama sched_main() che si trova in src/sched.c . Il codice sched_main() inizia eseguendo tutte le funzioni che sono state contrassegnate con la macro DECL_INIT(). Quindi continua a eseguire ripetutamente tutte le funzioni contrassegnate con la macro DECL_TASK(). Una delle principali funzioni dell'attivit\u00e0 \u00e8 command_dispatch() che si trova in src/command.c . Questa funzione viene richiamata dal codice input/output specifico della scheda (es. src/avr/serial.c , src/generic/serial_irq.c ) ed esegue le funzioni di comando associate ai comandi trovati nel flusso di input. Le funzioni di comando vengono dichiarate utilizzando la macro DECL_COMMAND() (consultare il documento protocol per ulteriori informazioni). Le funzioni task, init e comando vengono sempre eseguite con gli interrupt abilitati (tuttavia, possono disabilitare temporaneamente gli interrupt se necessario). Queste funzioni dovrebbero evitare lunghe pause, ritardi o eseguire lavori che durano un tempo significativo. (Lunghi ritardi in queste funzioni di \"attivit\u00e0\" provocano un jitter di pianificazione per altre \"attivit\u00e0\" - ritardi superiori a 100us possono diventare evidenti, ritardi superiori a 500us possono causare ritrasmissioni dei comandi, ritardi superiori a 100 ms possono causare riavvii del watchdog.) Queste funzioni pianificano il lavoro a orari specifici programmando i timer. Le funzioni timer vengono pianificate chiamando sched_add_timer() (che si trova in src/sched.c ). Il codice di pianificazione far\u00e0 in modo che la funzione data venga chiamata all'ora richiesta. Gli interrupt timer sono inizialmente gestiti in un gestore di interrupt specifico dell'architettura (ad esempio, src/avr/timer.c ) che chiama sched_timer_dispatch() situato in src/sched.c . L'interruzione del timer porta all'esecuzione delle funzioni del timer di pianificazione. Le funzioni timer vengono eseguite sempre con gli interrupt disabilitati. Le funzioni del timer dovrebbero sempre completarsi entro pochi microsecondi. Al completamento dell'evento timer, la funzione pu\u00f2 scegliere di riprogrammare se stessa. Nel caso in cui venga rilevato un errore, il codice pu\u00f2 invocare shutdown() (una macro che chiama sched_shutdown() situata in src/sched.c ). Il richiamo di shutdown() provoca l'esecuzione di tutte le funzioni contrassegnate con la macro DECL_SHUTDOWN(). Le funzioni di spegnimento vengono eseguite sempre con gli interrupt disabilitati. Gran parte delle funzionalit\u00e0 del microcontrollore implica il lavoro con pin di input/output per uso generico (GPIO). Per astrarre il codice specifico dell'architettura di basso livello dal codice dell'attivit\u00e0 di alto livello, tutti gli eventi GPIO sono implementati in wrapper specifici dell'architettura (ad esempio, src/avr/gpio.c ). Il codice \u00e8 compilato con l'ottimizzazione \"-flto -fwhole-program\" di gcc che fa un ottimo lavoro di inlining delle funzioni tra le unit\u00e0 di compilazione, quindi la maggior parte di queste minuscole funzioni gpio sono integrate nei loro chiamanti e non ci sono costi di runtime per l'utilizzo loro. Panoramica del codice Klippy \u00b6 Il codice host (Klippy) deve essere eseguito su un computer a basso costo (come un Raspberry Pi) abbinato al microcontrollore. Il codice \u00e8 scritto principalmente in Python, tuttavia utilizza CFFI per implementare alcune funzionalit\u00e0 nel codice C. L'esecuzione iniziale comincia in klippy/klippy.py . Questo legge gli argomenti della riga di comando, apre il file di configurazione della stampante, crea un'istanza degli oggetti principali della stampante e avvia la connessione seriale. L'esecuzione principale dei comandi G-code \u00e8 nel metodo process_commands() in klippy/gcode.py . Questo codice traduce i comandi del codice G in chiamate a oggetti stampante, che spesso traducono le azioni in comandi da eseguire sul microcontrollore (come dichiarato tramite la macro DECL_COMMAND nel codice del microcontrollore). Ci sono quattro thread nel codice host di Klippy. Il thread principale gestisce i comandi gcode in arrivo. Un secondo thread (che risiede interamente nel codice C klippy/chelper/serialqueue.c ) gestisce l'IO di basso livello con la porta seriale. Il terzo thread viene utilizzato per elaborare i messaggi di risposta dal microcontrollore nel codice Python (vedi klippy/serialhdl.py ). Il quarto thread scrive i messaggi di debug nel log (vedi klippy/queuelogger.py ) in modo che gli altri thread non blocchino mai le scritture del log. Flusso di codice di un comando di spostamento \u00b6 Un tipico movimento della stampante inizia quando viene inviato un comando \"G1\" all'host Klippy e si completa quando vengono prodotti i corrispondenti impulsi di passo sul microcontrollore. Questa sezione delinea il flusso di codice di un tipico comando di spostamento. Il documento cinematica fornisce ulteriori informazioni sulla meccanica dei movimenti. L'elaborazione di un comando di spostamento inizia in gcode.py. L'obiettivo di gcode.py \u00e8 tradurre il G-code in chiamate interne. Un comando G1 invocher\u00e0 cmd_G1() in klippy/extras/gcode_move.py. Il codice gcode_move.py gestisce le modifiche all'origine (ad esempio, G92), le modifiche alle posizioni relative rispetto a quelle assolute (ad esempio, G90) e le modifiche alle unit\u00e0 (ad esempio, F6000=100mm/s). Il percorso del codice per una mossa \u00e8: _process_data() -> _process_commands() -> cmd_G1() . Infine viene invocata la classe ToolHead per eseguire la richiesta effettiva: cmd_G1() -> ToolHead.move() La classe ToolHead (in toolhead.py) gestisce \"look-ahead\" e tiene traccia dei tempi delle azioni di stampa. Il percorso di codice principale per una mossa \u00e8: ToolHead.move() -> MoveQueue.add_move() -> MoveQueue.flush() -> Move.set_junction() -> ToolHead._process_moves() . ToolHead.move() crea un oggetto Move() con i parametri del movimento (in spazio cartesiano e in unit\u00e0 di secondi e millimetri). Alla classe cinematica viene data l'opportunit\u00e0 di controllare ogni movimento ( ToolHead.move() -> kin.check_move() ). Le classi cinematiche si trovano nella directory klippy/cinematica/. Il codice check_move() pu\u00f2 generare un errore se il movimento non \u00e8 valida. Se check_move() viene completato correttamente, la cinematica sottostante deve essere in grado di gestire lo spostamento. MoveQueue.add_move() posiziona l'oggetto di spostamento nella coda \"look-ahead\". MoveQueue.flush() determina le velocit\u00e0 di inizio e fine di ogni movimento. Move.set_junction() implementa il \"generatore di trapezi\" per il movimento. Il \"generatore trapezoidale\" suddivide ogni movimento in tre parti: una fase di accelerazione costante, seguita da una fase di velocit\u00e0 costante, seguita da una fase di decelerazione costante. Ogni mossa contiene queste tre fasi in questo ordine, ma alcune fasi possono avere durata zero. Quando viene chiamato ToolHead._process_moves(), tutto ci\u00f2 che riguarda lo spostamento \u00e8 noto: la sua posizione iniziale, la sua posizione finale, la sua accelerazione, la sua velocit\u00e0 di inizio/crociera/finale e la distanza percorsa durante l'accelerazione/crociera/decelerazione. Tutte le informazioni sono memorizzate nella classe Move() e sono nello spazio cartesiano in unit\u00e0 di millimetri e secondi. Klipper utilizza un risolutore iterativo per generare i tempi di passaggio per ogni stepper. Per motivi di efficienza, i tempi di impulso stepper sono generati in codice C. I movimenti vengono prima posizionati su una \"coda di movimento trapezoidale\": ToolHead._process_moves() -> trapq_append() (in klippy/chelper/trapq.c). Vengono quindi generati i tempi di passaggio: ToolHead._process_moves() -> ToolHead._update_move_time() -> MCU_Stepper.generate_steps() -> itersolve_generate_steps() -> itersolve_gen_steps_range() (in klippy/chelper/itersolve.c). L'obiettivo del risolutore iterativo \u00e8 trovare i tempi di passaggio data una funzione che calcola una posizione passo-passo da un tempo. Questo viene fatto \"indovinando\" ripetutamente varie volte fino a quando la formula della posizione dello stepper non restituisce la posizione desiderata del passaggio successivo sullo stepper. Il feedback prodotto da ciascuna ipotesi viene utilizzato per migliorare le ipotesi future in modo che il processo converga rapidamente al tempo desiderato. Le formule della posizione dello stepper cinematico si trovano nella directory klippy/chelper/ (ad es. kin_cart.c, kin_corexy.c, kin_delta.c, kin_extruder.c). Si noti che l'estrusore \u00e8 gestito nella propria classe cinematica: ToolHead._process_moves() -> PrinterExtruder.move() . Poich\u00e9 la classe Move() specifica l'esatto tempo di movimento e poich\u00e9 gli impulsi di passo vengono inviati al microcontrollore con una tempistica specifica, i movimenti passo-passo prodotti dalla classe estrusore saranno sincronizzati con il movimento della testa anche se il codice viene mantenuto separato. Dopo che il risolutore iterativo ha calcolato i tempi di passaggio, questi vengono aggiunti a un array: itersolve_gen_steps_range() -> stepcompress_append() (in klippy/chelper/stepcompress.c). L'array (struct stepcompress.queue) memorizza i corrispondenti tempi del contatore dell'orologio del microcontrollore per ogni passaggio. Qui il valore del \"contatore orologio del microcontrollore\" corrisponde direttamente al contatore hardware del microcontrollore - \u00e8 relativo a quando il microcontrollore \u00e8 stato acceso l'ultima volta. Il prossimo passo importante \u00e8 comprimere i passaggi: stepcompress_flush() -> compress_bisect_add() (in klippy/chelper/stepcompress.c). Questo codice genera e codifica una serie di comandi \"queue_step\" del microcontrollore che corrispondono all'elenco dei tempi di stepper compilati nella fase precedente. Questi comandi \"queue_step\" vengono quindi accodati, assegnati a priorit\u00e0 e inviati al microcontrollore (tramite stepcompress.c:steppersync e serialqueue.c:serialqueue). L'elaborazione dei comandi queue_step sul microcontrollore inizia in src/command.c che analizza il comando e chiama command_queue_step() . Il codice command_queue_step() (in src/stepper.c) aggiunge semplicemente i parametri di ogni comando queue_step a una coda per stepper. In condizioni normali, il comando queue_step viene analizzato e messo in coda almeno 100 ms prima dell'ora del suo primo passaggio. Infine, la generazione degli eventi stepper viene eseguita in stepper_event() . Viene chiamato dall'interruzione del timer hardware all'ora pianificata del primo passaggio. Il codice stepper_event() genera un impulso di passaggio e quindi si riprogramma per essere eseguito al momento dell'impulso di passaggio successivo per i parametri queue_step specificati. I parametri per ogni comando queue_step sono \"interval\", \"count\" e \"add\". Ad alto livello, stepper_event() esegue quanto segue, 'count' volte: do_step(); next_wake_time = last_wake_time + intervallo; intervallo += aggiungi; Quanto sopra pu\u00f2 sembrare un sacco di complessit\u00e0 per eseguire un movimento. Tuttavia, le uniche parti veramente interessanti sono nelle classi ToolHead e cinematica. \u00c8 questa parte del codice che specifica i movimenti e le loro tempistiche. Le restanti parti dell'elaborazione sono per lo pi\u00f9 solo comunicazioni e collegamenti. Aggiunta di un modulo host \u00b6 Il codice host Klippy ha una capacit\u00e0 di caricamento dinamico dei moduli. Se nel file di configurazione della stampante viene trovata una sezione di configurazione denominata \"[my_module]\", il software tenter\u00e0 automaticamente di caricare il modulo python klippy/extras/my_module.py . Questo sistema di moduli \u00e8 il metodo preferito per aggiungere nuove funzionalit\u00e0 a Klipper. Il modo pi\u00f9 semplice per aggiungere un nuovo modulo \u00e8 utilizzare un modulo esistente come riferimento - vedere klippy/extras/servo.py come esempio. Possono essere utili anche: L'esecuzione del modulo inizia nella funzione load_config() a livello di modulo (per le sezioni di configurazione del modulo [my_module]) o in load_config_prefix() (per le sezioni di configurazione del modulo [my_module my_name]). A questa funzione viene passato un oggetto \"config\" e deve restituire un nuovo \"oggetto stampante\" associato alla sezione di configurazione specificata. Durante il processo di creazione di un'istanza di un nuovo oggetto stampante, l'oggetto di configurazione pu\u00f2 essere utilizzato per leggere i parametri dalla sezione di configurazione specificata. Questo viene fatto usando i metodi config.get() , config.getfloat() , config.getint() , ecc. Assicurati di leggere tutti i valori dalla configurazione durante la costruzione dell'oggetto stampante: se l'utente specifica un parametro di configurazione che non viene letto durante questa fase, si presumer\u00e0 che si tratti di un errore di battitura nella configurazione e verr\u00e0 generato un errore. Usa il metodo config.get_printer() per ottenere un riferimento alla classe principale \"printer\". Questa classe \"stampante\" memorizza i riferimenti a tutti gli \"oggetti stampante\" di cui \u00e8 stata creata un'istanza. Usa il metodo printer.lookup_object() per trovare riferimenti ad altri oggetti stampante. Quasi tutte le funzionalit\u00e0 (anche i moduli cinematici principali) sono incapsulate in uno di questi oggetti stampante. Si noti, tuttavia, che quando viene istanziato un nuovo modulo, non saranno stati istanziati tutti gli altri oggetti stampante. I moduli \"gcode\" e \"pins\" saranno sempre disponibili, ma per altri moduli \u00e8 una buona idea rinviare la ricerca. Registra i gestori di eventi usando il metodo printer.register_event_handler() se il codice deve essere chiamato durante gli \"events\" generati da altri oggetti stampante. Ogni nome di evento \u00e8 una stringa e, per convenzione, \u00e8 il nome del modulo sorgente principale che genera l'evento insieme a un nome breve per l'azione che si sta verificando (ad esempio, \"klippy:connect\"). I parametri passati a ciascun gestore di eventi sono specifici dell'evento dato (cos\u00ec come la gestione delle eccezioni e il contesto di esecuzione). Due eventi di avvio comuni sono: klippy:connect - Questo evento viene generato dopo che tutti gli oggetti stampante sono stati istanziati. Viene comunemente utilizzato per cercare altri oggetti stampante, verificare le impostazioni di configurazione ed eseguire un \"handshake\" iniziale con l'hardware della stampante. klippy:ready - Questo evento viene generato dopo che tutti i gestori di connessione sono stati completati correttamente. Indica che la stampante sta passando a uno stato pronto per gestire le normali operazioni. Non generare un errore in questo callback. Se c'\u00e8 un errore nella configurazione dell'utente, assicurati di sollevarlo durante le fasi load_config() o \"connect event\". Utilizzare raise config.error(\"my error\") o raise printer.config_error (\"my error\") per segnalare l'errore. Utilizzare il modulo \"pin\" per configurare un pin su un microcontrollore. Questo \u00e8 in genere fatto con qualcosa di simile a printer.lookup_object(\"pins\").setup_pin(\"pwm\", config.get(\"my_pin\")) . L'oggetto restituito pu\u00f2 quindi essere comandato in fase di esecuzione. Se l'oggetto stampante definisce un metodo get_status() , il modulo pu\u00f2 esportare informazioni sullo stato tramite macro e tramite Server API . Il metodo get_status() deve restituire un dizionario Python con chiavi che sono stringhe e valori che sono interi, float, stringhe, elenchi, dizionari, True, False o None. \u00c8 possibile utilizzare anche tuple (e tuple con nome) (appaiono come elenchi quando si accede tramite il server API). Gli elenchi e i dizionari esportati devono essere trattati come \"immutabili\" - se il loro contenuto cambia, \u00e8 necessario restituire un nuovo oggetto da get_status() , altrimenti il server API non rilever\u00e0 tali modifiche. Se il modulo necessita dell'accesso alla temporizzazione del sistema o a descrittori di file esterni, utilizzare printer.get_reactor() per ottenere l'accesso alla classe globale \"event reactor\". Questa classe reattore consente di programmare i timer, attendere l'input sui descrittori di file e di \"sopprimere\" il codice host. Non utilizzare variabili globali. Tutto lo stato dovrebbe essere memorizzato nell'oggetto stampante restituito dalla funzione load_config() . Questo \u00e8 importante, altrimenti il comando RESTART potrebbe non funzionare come previsto. Inoltre, per ragioni simili, se vengono aperti file (o socket) esterni, assicurati di registrare un gestore di eventi \"klippy:disconnect\" e chiuderli da quella richiamata. Evitare di accedere alle variabili dei membri interni (o di chiamare metodi che iniziano con un trattino basso) di altri oggetti stampante. L'osservanza di questa convenzione semplifica la gestione delle modifiche future. Si consiglia di assegnare un valore a tutte le variabili membro nel costruttore Python delle classi Python. (E quindi evita di utilizzare la capacit\u00e0 di Python di creare dinamicamente nuove variabili membro.) Se una variabile Python deve memorizzare un valore in virgola mobile, si consiglia di assegnare e manipolare sempre quella variabile con costanti in virgola mobile (e non utilizzare mai costanti intere). Ad esempio, preferisci self.speed = 1. su self.speed = 1 e preferisci self.speed = 2. * x su self.speed = 2 * x . L'uso coerente di valori in virgola mobile pu\u00f2 evitare difficolt\u00e0 di debug nelle conversioni di tipo Python. Se invii il modulo per l'inclusione nel codice Klipper principale, assicurati di inserire un avviso di copyright nella parte superiore del modulo. Vedere i moduli esistenti per il formato preferito. Aggiunta di una nuova cinematica \u00b6 Questa sezione fornisce alcuni suggerimenti sull'aggiunta del supporto a Klipper per ulteriori tipi di cinematica della stampante. Questo tipo di attivit\u00e0 richiede un'ottima comprensione delle formule matematiche per la cinematica di destinazione. Richiede anche capacit\u00e0 di sviluppo software, sebbene sia necessario solo aggiornare il software host. Passi utili: Inizia studiando la sezione \" flusso di codice di un movimento \" e il documento di cinematica . Esaminare le classi cinematiche esistenti nella directory klippy/kinematics/. Le classi cinematiche hanno il compito di convertire una mossa in coordinate cartesiane nel movimento su ogni stepper. Si dovrebbe essere in grado di copiare uno di questi file come punto di partenza. Implementa in C le funzioni di posizione cinematica dello stepper per ogni stepper se non sono gi\u00e0 disponibili (vedi kin_cart.c, kin_corexy.c e kin_delta.c in klippy/chelper/). La funzione dovrebbe chiamare move_get_coord() per convertire un dato tempo di spostamento (in secondi) in una coordinata cartesiana (in millimetri), e quindi calcolare la posizione dello stepper desiderata (in millimetri) da quella coordinata cartesiana. Implementa il metodo calc_position() nella nuova classe cinematica. Questo metodo calcola la posizione della testa di stampa in coordinate cartesiane dalla posizione di ogni stepper. Non \u00e8 necessario che sia efficiente poich\u00e9 in genere viene chiamato solo durante le operazioni di homing e probing. Altri metodi. Implementa i metodi check_move() , get_status() , get_steppers() , home() e set_position() . Queste funzioni sono in genere utilizzate per fornire verifiche cinematiche specifiche. Tuttavia, all'inizio dello sviluppo \u00e8 possibile utilizzare il codice boilerplate qui. Implementare casi di prova. Crea un file g-code con una serie di movimenti che possono testare casi importanti per la cinematica data. Segui la documentazione di debug per convertire questo file di codice G in comandi del microcontrollore. Questo \u00e8 utile per esercitare corner case e per verificare la presenza di regressioni. Porting su un nuovo microcontrollore \u00b6 Questa sezione fornisce alcuni suggerimenti sul porting del codice del microcontrollore di Klipper su una nuova architettura. Questo tipo di attivit\u00e0 richiede una buona conoscenza dello sviluppo embedded e un accesso diretto al microcontrollore di destinazione. Passi utili: Inizia identificando eventuali librerie di terze parti che verranno utilizzate durante il trasferimento. Esempi comuni includono wrapper \"CMSIS\" e librerie \"HAL\" del produttore. Tutto il codice di terze parti deve essere compatibile con GNU GPLv3. Il codice di terze parti dovrebbe essere salvato nella directory lib/ di Klipper. Aggiorna il file lib/README con informazioni su dove e quando \u00e8 stata ottenuta la libreria. \u00c8 preferibile copiare il codice nel repository di Klipper senza modifiche, ma se sono necessarie modifiche, tali modifiche dovrebbero essere elencate esplicitamente nel file lib/README. Crea una nuova sottodirectory di architettura nella directory src/ e aggiungi il supporto iniziale di Kconfig e Makefile. Utilizzare le architetture esistenti come guida. src/simulator fornisce un esempio di base di un punto di partenza minimo. Il primo compito di programmazione \u00e8 portare il supporto di comunicazione alla scheda di destinazione. Questo \u00e8 il passo pi\u00f9 difficile in un nuovo porting. Una volta che la comunicazione di base funziona, i passaggi rimanenti tendono a essere molto pi\u00f9 semplici. \u00c8 tipico utilizzare un dispositivo seriale di tipo UART durante lo sviluppo iniziale poich\u00e9 questi tipi di dispositivi hardware sono generalmente pi\u00f9 facili da abilitare e controllare. Durante questa fase, fai un uso generoso del codice di supporto dalla directory src/generic/ (controlla come src/simulator/Makefile include il codice C generico nella build). \u00c8 inoltre necessario definire timer_read_time() (che restituisce l'orologio di sistema corrente) in questa fase, ma non \u00e8 necessario supportare completamente la gestione di timer irq. Acquisisci familiarit\u00e0 con lo strumento console.py (come descritto nel documento di debug ) e verifica la connettivit\u00e0 al microcontrollore con esso. Questo strumento traduce il protocollo di comunicazione del microcontrollore di basso livello in un formato leggibile dall'uomo. Aggiungi il supporto per l'invio del timer da interrupt hardware. Vedere Klipper commit 970831ee come esempio dei passaggi 1-5 eseguiti per l'architettura LPC176x. Visualizza il supporto di input e output GPIO di base. Vedi Klipper commit c78b9076 come esempio di questo. Riporta periferiche aggiuntive, ad esempio consulta il commit di Klipper 65613aed , c812a40a , e c381d03a . Crea un file di configurazione di Klipper di esempio nella directory config/. Testare il microcontrollore con il programma principale klippy.py. Prendi in considerazione l'aggiunta di build test case nella directory test/. Ulteriori suggerimenti per la programmazione: Evitare di utilizzare \"C bitfields\" per accedere ai registri IO; preferire operazioni di lettura e scrittura dirette di numeri interi a 32 bit, 16 bit o 8 bit. Le specifiche del linguaggio C non specificano chiaramente come il compilatore deve implementare campi di bit C (ad esempio, endianness e layout di bit), ed \u00e8 difficile determinare quali operazioni di I/O si verificheranno su un campo di bit C letto o scritto. Preferibilmente scrivere valori espliciti nei registri IO invece di usare operazioni di lettura-modifica-scrittura. Cio\u00e8, se si aggiorna un campo in un registro IO in cui gli altri campi hanno valori noti, \u00e8 preferibile scrivere in modo esplicito il contenuto completo del registro. Le scritture esplicite producono codice pi\u00f9 piccolo, pi\u00f9 veloce e pi\u00f9 facile da eseguire il debug. Sistemi di coordinate \u00b6 Internamente, Klipper tiene traccia principalmente della posizione della testa di stampa in coordinate cartesiane relative al sistema di coordinate specificato nel file di configurazione. Cio\u00e8, la maggior parte del codice Klipper non subir\u00e0 mai un cambiamento nei sistemi di coordinate. Se l'utente fa una richiesta per cambiare l'origine (ad esempio, un comando G92 ), allora quell'effetto si ottiene traducendo i comandi futuri nel sistema di coordinate primario. Tuttavia, in alcuni casi \u00e8 utile ottenere la posizione della testa di stampa in qualche altro sistema di coordinate e Klipper ha diversi strumenti per facilitarlo. Questo pu\u00f2 essere visto eseguendo il comando GET_POSITION. Per esempio: Send: GET_POSITION Recv: // mcu: stepper_a:-2060 stepper_b:-1169 stepper_c:-1613 Recv: // stepper: stepper_a:457.254159 stepper_b:466.085669 stepper_c:465.382132 Recv: // kinematic: X:8.339144 Y:-3.131558 Z:233.347121 Recv: // toolhead: X:8.338078 Y:-3.123175 Z:233.347878 E:0.000000 Recv: // gcode: X:8.338078 Y:-3.123175 Z:233.347878 E:0.000000 Recv: // gcode base: X:0.000000 Y:0.000000 Z:0.000000 E:0.000000 Recv: // gcode homing: X:0.000000 Y:0.000000 Z:0.000000 La posizione \"mcu\" ( stepper.get_mcu_position() nel codice) \u00e8 il numero totale di passaggi che il microcontrollore ha emesso in direzione positiva meno il numero di passaggi emessi in direzione negativa dall'ultimo microcontrollore Ripristina. Se il robot \u00e8 in movimento quando viene emessa la query, il valore riportato include le mosse memorizzate nel buffer del microcontrollore, ma non include le mosse nella coda di previsione. La posizione \"stepper\" ( stepper.get_commanded_position() ) \u00e8 la posizione del dato stepper come tracciato dal codice della cinematica. Questo corrisponde generalmente alla posizione (in mm) del carrello lungo il suo binario, rispetto a position_endstop specificato nel file di configurazione. (Alcune cinematiche tracciano le posizioni dello stepper in radianti anzich\u00e9 in millimetri.) Se il robot \u00e8 in movimento quando viene emessa la query, il valore riportato include i movimenti memorizzati nel buffer del microcontrollore, ma non include i movimenti sulla coda di previsione. Si possono usare le chiamate toolhead.flush_step_generation() o toolhead.wait_moves() per svuotare completamente il codice look-ahead e generazione di passaggi. La posizione \"cinematica\" ( kin.calc_position() ) \u00e8 la posizione cartesiana della testa di stampa come derivata dalle posizioni \"stepper\" ed \u00e8 relativa al sistema di coordinate specificato nel file di configurazione. Questo pu\u00f2 differire dalla posizione cartesiana richiesta a causa della granularit\u00e0 dei motori passo-passo. Se il robot \u00e8 in movimento quando vengono prese le posizioni \"stepper\", il valore riportato include i movimenti memorizzati nel buffer del microcontrollore, ma non include i movimenti sulla coda di previsione. Si possono usare le chiamate toolhead.flush_step_generation() o toolhead.wait_moves() per svuotare completamente il codice look-ahead e generazione di passaggi. La posizione della \"testa di stampa\" ( toolhead.get_position() ) \u00e8 l'ultima posizione richiesta della testa di stampa in coordinate cartesiane rispetto al sistema di coordinate specificato nel file di configurazione. Se il robot \u00e8 in movimento quando viene emessa la richiesta, il valore riportato include tutti i movimenti richiesti (anche quelli nei buffer in attesa di essere inviati ai driver del motore passo-passo). La posizione \"gcode\" \u00e8 l'ultima posizione richiesta da un comando G1 (o G0 ) in coordinate cartesiane relative al sistema di coordinate specificato nel file di configurazione. Questo pu\u00f2 differire dalla posizione \"toolhead\" se \u00e8 attiva una trasformazione del g-code (ad es. bed_mesh, bed_tilt, skew_correction). Questo pu\u00f2 differire dalle coordinate effettive specificate nell'ultimo comando G1 se l'origine del g-code \u00e8 stata modificata (ad esempio, G92 , SET_GCODE_OFFSET , M221 ). Il comando M114 ( gcode_move.get_status()['gcode_position'] ) riporter\u00e0 l'ultima posizione del g-code rispetto al sistema di coordinate del g-code corrente. La \"gcode base\" \u00e8 la posizione dell'origine del codice g in coordinate cartesiane rispetto al sistema di coordinate specificato nel file di configurazione. Comandi come G92 , SET_GCODE_OFFSET e M221 alterano questo valore. Il \"gcode homing\" \u00e8 la posizione da usare per l'origine del g-code (in coordinate cartesiane relative al sistema di coordinate specificato nel file di configurazione) dopo un comando home G28 . Il comando SET_GCODE_OFFSET pu\u00f2 alterare questo valore. Time \u00b6 Fondamentale per il funzionamento di Klipper \u00e8 la gestione di orologi, orari e timestamp. Klipper esegue azioni sulla stampante programmando eventi che si verificheranno nel prossimo futuro. Ad esempio, per accendere una ventola, il codice potrebbe programmare una modifica a un pin GPIO in 100 ms. \u00c8 raro che il codice tenti di eseguire un'azione istantanea. Pertanto, la gestione del tempo all'interno di Klipper \u00e8 fondamentale per il corretto funzionamento. Esistono tre tipi di tempi tracciati internamente nel software host di Klipper: Ora di sistema. L'ora del sistema utilizza l'orologio del sistema: \u00e8 un numero in virgola mobile memorizzato come secondi ed \u00e8 (generalmente) relativo all'ultimo avvio del computer host. I tempi di sistema hanno un uso limitato nel software: vengono utilizzati principalmente durante l'interazione con il sistema operativo. All'interno del codice host, gli orari di sistema sono spesso archiviati in variabili denominate eventtime o curtime . Tempo di stampa. Il tempo di stampa \u00e8 sincronizzato con l'orologio principale del microcontrollore (il microcontrollore definito nella sezione di configurazione \"[mcu]\"). \u00c8 un numero in virgola mobile memorizzato come secondi ed \u00e8 relativo all'ultimo riavvio dell'mcu principale. \u00c8 possibile convertire da un \"tempo di stampa\" all'orologio hardware del microcontrollore principale moltiplicando il tempo di stampa per la frequenza di frequenza configurata staticamente dell'mcu. Il codice host di alto livello utilizza i tempi di stampa per calcolare quasi tutte le azioni fisiche (ad es. movimento della testa, modifiche del riscaldatore, ecc.). All'interno del codice host, i tempi di stampa sono generalmente memorizzati in variabili denominate print_time o move_time . Orologio MCU. Questo \u00e8 il contatore dell'orologio hardware su ogni microcontrollore. Viene memorizzato come numero intero e la sua velocit\u00e0 di aggiornamento \u00e8 relativa alla frequenza del microcontrollore specificato. Il software host traduce i suoi tempi interni in orologi prima della trasmissione all'mcu. Il codice mcu tiene traccia del tempo solo in tick dell'orologio. All'interno del codice host, i valori di clock vengono tracciati come interi a 64 bit, mentre il codice mcu utilizza interi a 32 bit. All'interno del codice host, gli orologi sono generalmente memorizzati in variabili con nomi contenenti clock o tick . La conversione tra i diversi formati dell'ora \u00e8 implementata principalmente nel codice klippy/clocksync.py . Alcune cose da tenere presenti durante la revisione del codice: Orologi a 32 bit e 64 bit: per ridurre la larghezza di banda e migliorare l'efficienza del microcontrollore, gli orologi sul microcontrollore vengono tracciati come numeri interi a 32 bit. Quando si confrontano due orologi nel codice mcu, la funzione timer_is_before() deve essere sempre utilizzata per garantire che i rollover interi siano gestiti correttamente. Il software host converte gli orologi a 32 bit in orologi a 64 bit aggiungendo i bit di ordine superiore dall'ultimo timestamp mcu che ha ricevuto - nessun messaggio dall'mcu \u00e8 mai pi\u00f9 di 2^31 tick di clock in futuro o nel passato, quindi questa conversione non \u00e8 mai ambigua . L'host converte da clock a 64 bit a clock a 32 bit semplicemente troncando i bit di ordine superiore. Per garantire che non vi siano ambiguit\u00e0 in questa conversione, il codice klippy/chelper/serialqueue.c memorizza i messaggi nel buffer finch\u00e9 non si trovano entro 2^31 tick di clock dall'ora target. Microcontrollori multipli: il software host supporta l'utilizzo di pi\u00f9 microcontrollori su una singola stampante. In questo caso, il \"clock MCU\" di ogni microcontrollore viene tracciato separatamente. Il codice clocksync.py gestisce la deriva dell'orologio tra i microcontrollori modificando il modo in cui converte da \"tempo di stampa\" a \"orologio MCU\". Sul mcus secondario, la frequenza mcu utilizzata in questa conversione viene regolarmente aggiornata per tenere conto della deriva misurata.","title":"Panoramica del codice"},{"location":"Code_Overview.html#panoramica-del-codice","text":"Questo documento descrive il formato generale del codice e il flusso principale del codice di Klipper.","title":"Panoramica del codice"},{"location":"Code_Overview.html#directory-layout","text":"La directory src/ contiene il sorgente C per il codice del microcontrollore. src/atsam/ , src/atsamd/ , src/avr/ , src/linux/ , src/lpc176x/ , src/ Le directory pru/ e src/stm32/ contengono il codice del microcontrollore specifico dell'architettura. src/simulator/ contiene stub di codice che consentono la compilazione di test del microcontrollore su altre architetture. La directory src/generic/ contiene codice di supporto che pu\u00f2 essere utile in diverse architetture. La build fa in modo che le include di \"board/somefile.h\" guardino prima nella directory dell'architettura corrente (ad esempio, src/avr/somefile.h) e poi nella directory generica (ad esempio, src/generic/somefile.h). La directory klippy/ contiene il software host. La maggior parte del software host \u00e8 scritto in Python, tuttavia la directory klippy/chelper/ contiene alcuni helper del codice C. La directory klippy/kinematics/ contiene il codice della cinematica del robot. La directory klippy/extras/ contiene i \"moduli\" estensibili del codice host. La directory lib/ contiene il codice della libreria di terze parti esterne necessarie per creare alcune destinazioni. La directory config/ contiene file di configurazione della stampante di esempio. La directory scripts/ contiene script di build-time utili per compilare il codice del microcontrollore. La directory test/ contiene test case automatizzati. Durante la compilazione, la build potrebbe creare una directory out/ . Questa contiene oggetti temporanei di compilazione. L'oggetto microcontrollore finale che viene creato \u00e8 out/klipper.elf.hex su AVR e out/klipper.bin su ARM.","title":"Directory Layout"},{"location":"Code_Overview.html#flusso-del-codice-del-microcontrollore","text":"L'esecuzione del codice del microcontrollore inizia nel codice specifico dell'architettura (ad esempio, src/avr/main.c ) che alla fine chiama sched_main() che si trova in src/sched.c . Il codice sched_main() inizia eseguendo tutte le funzioni che sono state contrassegnate con la macro DECL_INIT(). Quindi continua a eseguire ripetutamente tutte le funzioni contrassegnate con la macro DECL_TASK(). Una delle principali funzioni dell'attivit\u00e0 \u00e8 command_dispatch() che si trova in src/command.c . Questa funzione viene richiamata dal codice input/output specifico della scheda (es. src/avr/serial.c , src/generic/serial_irq.c ) ed esegue le funzioni di comando associate ai comandi trovati nel flusso di input. Le funzioni di comando vengono dichiarate utilizzando la macro DECL_COMMAND() (consultare il documento protocol per ulteriori informazioni). Le funzioni task, init e comando vengono sempre eseguite con gli interrupt abilitati (tuttavia, possono disabilitare temporaneamente gli interrupt se necessario). Queste funzioni dovrebbero evitare lunghe pause, ritardi o eseguire lavori che durano un tempo significativo. (Lunghi ritardi in queste funzioni di \"attivit\u00e0\" provocano un jitter di pianificazione per altre \"attivit\u00e0\" - ritardi superiori a 100us possono diventare evidenti, ritardi superiori a 500us possono causare ritrasmissioni dei comandi, ritardi superiori a 100 ms possono causare riavvii del watchdog.) Queste funzioni pianificano il lavoro a orari specifici programmando i timer. Le funzioni timer vengono pianificate chiamando sched_add_timer() (che si trova in src/sched.c ). Il codice di pianificazione far\u00e0 in modo che la funzione data venga chiamata all'ora richiesta. Gli interrupt timer sono inizialmente gestiti in un gestore di interrupt specifico dell'architettura (ad esempio, src/avr/timer.c ) che chiama sched_timer_dispatch() situato in src/sched.c . L'interruzione del timer porta all'esecuzione delle funzioni del timer di pianificazione. Le funzioni timer vengono eseguite sempre con gli interrupt disabilitati. Le funzioni del timer dovrebbero sempre completarsi entro pochi microsecondi. Al completamento dell'evento timer, la funzione pu\u00f2 scegliere di riprogrammare se stessa. Nel caso in cui venga rilevato un errore, il codice pu\u00f2 invocare shutdown() (una macro che chiama sched_shutdown() situata in src/sched.c ). Il richiamo di shutdown() provoca l'esecuzione di tutte le funzioni contrassegnate con la macro DECL_SHUTDOWN(). Le funzioni di spegnimento vengono eseguite sempre con gli interrupt disabilitati. Gran parte delle funzionalit\u00e0 del microcontrollore implica il lavoro con pin di input/output per uso generico (GPIO). Per astrarre il codice specifico dell'architettura di basso livello dal codice dell'attivit\u00e0 di alto livello, tutti gli eventi GPIO sono implementati in wrapper specifici dell'architettura (ad esempio, src/avr/gpio.c ). Il codice \u00e8 compilato con l'ottimizzazione \"-flto -fwhole-program\" di gcc che fa un ottimo lavoro di inlining delle funzioni tra le unit\u00e0 di compilazione, quindi la maggior parte di queste minuscole funzioni gpio sono integrate nei loro chiamanti e non ci sono costi di runtime per l'utilizzo loro.","title":"Flusso del codice del microcontrollore"},{"location":"Code_Overview.html#panoramica-del-codice-klippy","text":"Il codice host (Klippy) deve essere eseguito su un computer a basso costo (come un Raspberry Pi) abbinato al microcontrollore. Il codice \u00e8 scritto principalmente in Python, tuttavia utilizza CFFI per implementare alcune funzionalit\u00e0 nel codice C. L'esecuzione iniziale comincia in klippy/klippy.py . Questo legge gli argomenti della riga di comando, apre il file di configurazione della stampante, crea un'istanza degli oggetti principali della stampante e avvia la connessione seriale. L'esecuzione principale dei comandi G-code \u00e8 nel metodo process_commands() in klippy/gcode.py . Questo codice traduce i comandi del codice G in chiamate a oggetti stampante, che spesso traducono le azioni in comandi da eseguire sul microcontrollore (come dichiarato tramite la macro DECL_COMMAND nel codice del microcontrollore). Ci sono quattro thread nel codice host di Klippy. Il thread principale gestisce i comandi gcode in arrivo. Un secondo thread (che risiede interamente nel codice C klippy/chelper/serialqueue.c ) gestisce l'IO di basso livello con la porta seriale. Il terzo thread viene utilizzato per elaborare i messaggi di risposta dal microcontrollore nel codice Python (vedi klippy/serialhdl.py ). Il quarto thread scrive i messaggi di debug nel log (vedi klippy/queuelogger.py ) in modo che gli altri thread non blocchino mai le scritture del log.","title":"Panoramica del codice Klippy"},{"location":"Code_Overview.html#flusso-di-codice-di-un-comando-di-spostamento","text":"Un tipico movimento della stampante inizia quando viene inviato un comando \"G1\" all'host Klippy e si completa quando vengono prodotti i corrispondenti impulsi di passo sul microcontrollore. Questa sezione delinea il flusso di codice di un tipico comando di spostamento. Il documento cinematica fornisce ulteriori informazioni sulla meccanica dei movimenti. L'elaborazione di un comando di spostamento inizia in gcode.py. L'obiettivo di gcode.py \u00e8 tradurre il G-code in chiamate interne. Un comando G1 invocher\u00e0 cmd_G1() in klippy/extras/gcode_move.py. Il codice gcode_move.py gestisce le modifiche all'origine (ad esempio, G92), le modifiche alle posizioni relative rispetto a quelle assolute (ad esempio, G90) e le modifiche alle unit\u00e0 (ad esempio, F6000=100mm/s). Il percorso del codice per una mossa \u00e8: _process_data() -> _process_commands() -> cmd_G1() . Infine viene invocata la classe ToolHead per eseguire la richiesta effettiva: cmd_G1() -> ToolHead.move() La classe ToolHead (in toolhead.py) gestisce \"look-ahead\" e tiene traccia dei tempi delle azioni di stampa. Il percorso di codice principale per una mossa \u00e8: ToolHead.move() -> MoveQueue.add_move() -> MoveQueue.flush() -> Move.set_junction() -> ToolHead._process_moves() . ToolHead.move() crea un oggetto Move() con i parametri del movimento (in spazio cartesiano e in unit\u00e0 di secondi e millimetri). Alla classe cinematica viene data l'opportunit\u00e0 di controllare ogni movimento ( ToolHead.move() -> kin.check_move() ). Le classi cinematiche si trovano nella directory klippy/cinematica/. Il codice check_move() pu\u00f2 generare un errore se il movimento non \u00e8 valida. Se check_move() viene completato correttamente, la cinematica sottostante deve essere in grado di gestire lo spostamento. MoveQueue.add_move() posiziona l'oggetto di spostamento nella coda \"look-ahead\". MoveQueue.flush() determina le velocit\u00e0 di inizio e fine di ogni movimento. Move.set_junction() implementa il \"generatore di trapezi\" per il movimento. Il \"generatore trapezoidale\" suddivide ogni movimento in tre parti: una fase di accelerazione costante, seguita da una fase di velocit\u00e0 costante, seguita da una fase di decelerazione costante. Ogni mossa contiene queste tre fasi in questo ordine, ma alcune fasi possono avere durata zero. Quando viene chiamato ToolHead._process_moves(), tutto ci\u00f2 che riguarda lo spostamento \u00e8 noto: la sua posizione iniziale, la sua posizione finale, la sua accelerazione, la sua velocit\u00e0 di inizio/crociera/finale e la distanza percorsa durante l'accelerazione/crociera/decelerazione. Tutte le informazioni sono memorizzate nella classe Move() e sono nello spazio cartesiano in unit\u00e0 di millimetri e secondi. Klipper utilizza un risolutore iterativo per generare i tempi di passaggio per ogni stepper. Per motivi di efficienza, i tempi di impulso stepper sono generati in codice C. I movimenti vengono prima posizionati su una \"coda di movimento trapezoidale\": ToolHead._process_moves() -> trapq_append() (in klippy/chelper/trapq.c). Vengono quindi generati i tempi di passaggio: ToolHead._process_moves() -> ToolHead._update_move_time() -> MCU_Stepper.generate_steps() -> itersolve_generate_steps() -> itersolve_gen_steps_range() (in klippy/chelper/itersolve.c). L'obiettivo del risolutore iterativo \u00e8 trovare i tempi di passaggio data una funzione che calcola una posizione passo-passo da un tempo. Questo viene fatto \"indovinando\" ripetutamente varie volte fino a quando la formula della posizione dello stepper non restituisce la posizione desiderata del passaggio successivo sullo stepper. Il feedback prodotto da ciascuna ipotesi viene utilizzato per migliorare le ipotesi future in modo che il processo converga rapidamente al tempo desiderato. Le formule della posizione dello stepper cinematico si trovano nella directory klippy/chelper/ (ad es. kin_cart.c, kin_corexy.c, kin_delta.c, kin_extruder.c). Si noti che l'estrusore \u00e8 gestito nella propria classe cinematica: ToolHead._process_moves() -> PrinterExtruder.move() . Poich\u00e9 la classe Move() specifica l'esatto tempo di movimento e poich\u00e9 gli impulsi di passo vengono inviati al microcontrollore con una tempistica specifica, i movimenti passo-passo prodotti dalla classe estrusore saranno sincronizzati con il movimento della testa anche se il codice viene mantenuto separato. Dopo che il risolutore iterativo ha calcolato i tempi di passaggio, questi vengono aggiunti a un array: itersolve_gen_steps_range() -> stepcompress_append() (in klippy/chelper/stepcompress.c). L'array (struct stepcompress.queue) memorizza i corrispondenti tempi del contatore dell'orologio del microcontrollore per ogni passaggio. Qui il valore del \"contatore orologio del microcontrollore\" corrisponde direttamente al contatore hardware del microcontrollore - \u00e8 relativo a quando il microcontrollore \u00e8 stato acceso l'ultima volta. Il prossimo passo importante \u00e8 comprimere i passaggi: stepcompress_flush() -> compress_bisect_add() (in klippy/chelper/stepcompress.c). Questo codice genera e codifica una serie di comandi \"queue_step\" del microcontrollore che corrispondono all'elenco dei tempi di stepper compilati nella fase precedente. Questi comandi \"queue_step\" vengono quindi accodati, assegnati a priorit\u00e0 e inviati al microcontrollore (tramite stepcompress.c:steppersync e serialqueue.c:serialqueue). L'elaborazione dei comandi queue_step sul microcontrollore inizia in src/command.c che analizza il comando e chiama command_queue_step() . Il codice command_queue_step() (in src/stepper.c) aggiunge semplicemente i parametri di ogni comando queue_step a una coda per stepper. In condizioni normali, il comando queue_step viene analizzato e messo in coda almeno 100 ms prima dell'ora del suo primo passaggio. Infine, la generazione degli eventi stepper viene eseguita in stepper_event() . Viene chiamato dall'interruzione del timer hardware all'ora pianificata del primo passaggio. Il codice stepper_event() genera un impulso di passaggio e quindi si riprogramma per essere eseguito al momento dell'impulso di passaggio successivo per i parametri queue_step specificati. I parametri per ogni comando queue_step sono \"interval\", \"count\" e \"add\". Ad alto livello, stepper_event() esegue quanto segue, 'count' volte: do_step(); next_wake_time = last_wake_time + intervallo; intervallo += aggiungi; Quanto sopra pu\u00f2 sembrare un sacco di complessit\u00e0 per eseguire un movimento. Tuttavia, le uniche parti veramente interessanti sono nelle classi ToolHead e cinematica. \u00c8 questa parte del codice che specifica i movimenti e le loro tempistiche. Le restanti parti dell'elaborazione sono per lo pi\u00f9 solo comunicazioni e collegamenti.","title":"Flusso di codice di un comando di spostamento"},{"location":"Code_Overview.html#aggiunta-di-un-modulo-host","text":"Il codice host Klippy ha una capacit\u00e0 di caricamento dinamico dei moduli. Se nel file di configurazione della stampante viene trovata una sezione di configurazione denominata \"[my_module]\", il software tenter\u00e0 automaticamente di caricare il modulo python klippy/extras/my_module.py . Questo sistema di moduli \u00e8 il metodo preferito per aggiungere nuove funzionalit\u00e0 a Klipper. Il modo pi\u00f9 semplice per aggiungere un nuovo modulo \u00e8 utilizzare un modulo esistente come riferimento - vedere klippy/extras/servo.py come esempio. Possono essere utili anche: L'esecuzione del modulo inizia nella funzione load_config() a livello di modulo (per le sezioni di configurazione del modulo [my_module]) o in load_config_prefix() (per le sezioni di configurazione del modulo [my_module my_name]). A questa funzione viene passato un oggetto \"config\" e deve restituire un nuovo \"oggetto stampante\" associato alla sezione di configurazione specificata. Durante il processo di creazione di un'istanza di un nuovo oggetto stampante, l'oggetto di configurazione pu\u00f2 essere utilizzato per leggere i parametri dalla sezione di configurazione specificata. Questo viene fatto usando i metodi config.get() , config.getfloat() , config.getint() , ecc. Assicurati di leggere tutti i valori dalla configurazione durante la costruzione dell'oggetto stampante: se l'utente specifica un parametro di configurazione che non viene letto durante questa fase, si presumer\u00e0 che si tratti di un errore di battitura nella configurazione e verr\u00e0 generato un errore. Usa il metodo config.get_printer() per ottenere un riferimento alla classe principale \"printer\". Questa classe \"stampante\" memorizza i riferimenti a tutti gli \"oggetti stampante\" di cui \u00e8 stata creata un'istanza. Usa il metodo printer.lookup_object() per trovare riferimenti ad altri oggetti stampante. Quasi tutte le funzionalit\u00e0 (anche i moduli cinematici principali) sono incapsulate in uno di questi oggetti stampante. Si noti, tuttavia, che quando viene istanziato un nuovo modulo, non saranno stati istanziati tutti gli altri oggetti stampante. I moduli \"gcode\" e \"pins\" saranno sempre disponibili, ma per altri moduli \u00e8 una buona idea rinviare la ricerca. Registra i gestori di eventi usando il metodo printer.register_event_handler() se il codice deve essere chiamato durante gli \"events\" generati da altri oggetti stampante. Ogni nome di evento \u00e8 una stringa e, per convenzione, \u00e8 il nome del modulo sorgente principale che genera l'evento insieme a un nome breve per l'azione che si sta verificando (ad esempio, \"klippy:connect\"). I parametri passati a ciascun gestore di eventi sono specifici dell'evento dato (cos\u00ec come la gestione delle eccezioni e il contesto di esecuzione). Due eventi di avvio comuni sono: klippy:connect - Questo evento viene generato dopo che tutti gli oggetti stampante sono stati istanziati. Viene comunemente utilizzato per cercare altri oggetti stampante, verificare le impostazioni di configurazione ed eseguire un \"handshake\" iniziale con l'hardware della stampante. klippy:ready - Questo evento viene generato dopo che tutti i gestori di connessione sono stati completati correttamente. Indica che la stampante sta passando a uno stato pronto per gestire le normali operazioni. Non generare un errore in questo callback. Se c'\u00e8 un errore nella configurazione dell'utente, assicurati di sollevarlo durante le fasi load_config() o \"connect event\". Utilizzare raise config.error(\"my error\") o raise printer.config_error (\"my error\") per segnalare l'errore. Utilizzare il modulo \"pin\" per configurare un pin su un microcontrollore. Questo \u00e8 in genere fatto con qualcosa di simile a printer.lookup_object(\"pins\").setup_pin(\"pwm\", config.get(\"my_pin\")) . L'oggetto restituito pu\u00f2 quindi essere comandato in fase di esecuzione. Se l'oggetto stampante definisce un metodo get_status() , il modulo pu\u00f2 esportare informazioni sullo stato tramite macro e tramite Server API . Il metodo get_status() deve restituire un dizionario Python con chiavi che sono stringhe e valori che sono interi, float, stringhe, elenchi, dizionari, True, False o None. \u00c8 possibile utilizzare anche tuple (e tuple con nome) (appaiono come elenchi quando si accede tramite il server API). Gli elenchi e i dizionari esportati devono essere trattati come \"immutabili\" - se il loro contenuto cambia, \u00e8 necessario restituire un nuovo oggetto da get_status() , altrimenti il server API non rilever\u00e0 tali modifiche. Se il modulo necessita dell'accesso alla temporizzazione del sistema o a descrittori di file esterni, utilizzare printer.get_reactor() per ottenere l'accesso alla classe globale \"event reactor\". Questa classe reattore consente di programmare i timer, attendere l'input sui descrittori di file e di \"sopprimere\" il codice host. Non utilizzare variabili globali. Tutto lo stato dovrebbe essere memorizzato nell'oggetto stampante restituito dalla funzione load_config() . Questo \u00e8 importante, altrimenti il comando RESTART potrebbe non funzionare come previsto. Inoltre, per ragioni simili, se vengono aperti file (o socket) esterni, assicurati di registrare un gestore di eventi \"klippy:disconnect\" e chiuderli da quella richiamata. Evitare di accedere alle variabili dei membri interni (o di chiamare metodi che iniziano con un trattino basso) di altri oggetti stampante. L'osservanza di questa convenzione semplifica la gestione delle modifiche future. Si consiglia di assegnare un valore a tutte le variabili membro nel costruttore Python delle classi Python. (E quindi evita di utilizzare la capacit\u00e0 di Python di creare dinamicamente nuove variabili membro.) Se una variabile Python deve memorizzare un valore in virgola mobile, si consiglia di assegnare e manipolare sempre quella variabile con costanti in virgola mobile (e non utilizzare mai costanti intere). Ad esempio, preferisci self.speed = 1. su self.speed = 1 e preferisci self.speed = 2. * x su self.speed = 2 * x . L'uso coerente di valori in virgola mobile pu\u00f2 evitare difficolt\u00e0 di debug nelle conversioni di tipo Python. Se invii il modulo per l'inclusione nel codice Klipper principale, assicurati di inserire un avviso di copyright nella parte superiore del modulo. Vedere i moduli esistenti per il formato preferito.","title":"Aggiunta di un modulo host"},{"location":"Code_Overview.html#aggiunta-di-una-nuova-cinematica","text":"Questa sezione fornisce alcuni suggerimenti sull'aggiunta del supporto a Klipper per ulteriori tipi di cinematica della stampante. Questo tipo di attivit\u00e0 richiede un'ottima comprensione delle formule matematiche per la cinematica di destinazione. Richiede anche capacit\u00e0 di sviluppo software, sebbene sia necessario solo aggiornare il software host. Passi utili: Inizia studiando la sezione \" flusso di codice di un movimento \" e il documento di cinematica . Esaminare le classi cinematiche esistenti nella directory klippy/kinematics/. Le classi cinematiche hanno il compito di convertire una mossa in coordinate cartesiane nel movimento su ogni stepper. Si dovrebbe essere in grado di copiare uno di questi file come punto di partenza. Implementa in C le funzioni di posizione cinematica dello stepper per ogni stepper se non sono gi\u00e0 disponibili (vedi kin_cart.c, kin_corexy.c e kin_delta.c in klippy/chelper/). La funzione dovrebbe chiamare move_get_coord() per convertire un dato tempo di spostamento (in secondi) in una coordinata cartesiana (in millimetri), e quindi calcolare la posizione dello stepper desiderata (in millimetri) da quella coordinata cartesiana. Implementa il metodo calc_position() nella nuova classe cinematica. Questo metodo calcola la posizione della testa di stampa in coordinate cartesiane dalla posizione di ogni stepper. Non \u00e8 necessario che sia efficiente poich\u00e9 in genere viene chiamato solo durante le operazioni di homing e probing. Altri metodi. Implementa i metodi check_move() , get_status() , get_steppers() , home() e set_position() . Queste funzioni sono in genere utilizzate per fornire verifiche cinematiche specifiche. Tuttavia, all'inizio dello sviluppo \u00e8 possibile utilizzare il codice boilerplate qui. Implementare casi di prova. Crea un file g-code con una serie di movimenti che possono testare casi importanti per la cinematica data. Segui la documentazione di debug per convertire questo file di codice G in comandi del microcontrollore. Questo \u00e8 utile per esercitare corner case e per verificare la presenza di regressioni.","title":"Aggiunta di una nuova cinematica"},{"location":"Code_Overview.html#porting-su-un-nuovo-microcontrollore","text":"Questa sezione fornisce alcuni suggerimenti sul porting del codice del microcontrollore di Klipper su una nuova architettura. Questo tipo di attivit\u00e0 richiede una buona conoscenza dello sviluppo embedded e un accesso diretto al microcontrollore di destinazione. Passi utili: Inizia identificando eventuali librerie di terze parti che verranno utilizzate durante il trasferimento. Esempi comuni includono wrapper \"CMSIS\" e librerie \"HAL\" del produttore. Tutto il codice di terze parti deve essere compatibile con GNU GPLv3. Il codice di terze parti dovrebbe essere salvato nella directory lib/ di Klipper. Aggiorna il file lib/README con informazioni su dove e quando \u00e8 stata ottenuta la libreria. \u00c8 preferibile copiare il codice nel repository di Klipper senza modifiche, ma se sono necessarie modifiche, tali modifiche dovrebbero essere elencate esplicitamente nel file lib/README. Crea una nuova sottodirectory di architettura nella directory src/ e aggiungi il supporto iniziale di Kconfig e Makefile. Utilizzare le architetture esistenti come guida. src/simulator fornisce un esempio di base di un punto di partenza minimo. Il primo compito di programmazione \u00e8 portare il supporto di comunicazione alla scheda di destinazione. Questo \u00e8 il passo pi\u00f9 difficile in un nuovo porting. Una volta che la comunicazione di base funziona, i passaggi rimanenti tendono a essere molto pi\u00f9 semplici. \u00c8 tipico utilizzare un dispositivo seriale di tipo UART durante lo sviluppo iniziale poich\u00e9 questi tipi di dispositivi hardware sono generalmente pi\u00f9 facili da abilitare e controllare. Durante questa fase, fai un uso generoso del codice di supporto dalla directory src/generic/ (controlla come src/simulator/Makefile include il codice C generico nella build). \u00c8 inoltre necessario definire timer_read_time() (che restituisce l'orologio di sistema corrente) in questa fase, ma non \u00e8 necessario supportare completamente la gestione di timer irq. Acquisisci familiarit\u00e0 con lo strumento console.py (come descritto nel documento di debug ) e verifica la connettivit\u00e0 al microcontrollore con esso. Questo strumento traduce il protocollo di comunicazione del microcontrollore di basso livello in un formato leggibile dall'uomo. Aggiungi il supporto per l'invio del timer da interrupt hardware. Vedere Klipper commit 970831ee come esempio dei passaggi 1-5 eseguiti per l'architettura LPC176x. Visualizza il supporto di input e output GPIO di base. Vedi Klipper commit c78b9076 come esempio di questo. Riporta periferiche aggiuntive, ad esempio consulta il commit di Klipper 65613aed , c812a40a , e c381d03a . Crea un file di configurazione di Klipper di esempio nella directory config/. Testare il microcontrollore con il programma principale klippy.py. Prendi in considerazione l'aggiunta di build test case nella directory test/. Ulteriori suggerimenti per la programmazione: Evitare di utilizzare \"C bitfields\" per accedere ai registri IO; preferire operazioni di lettura e scrittura dirette di numeri interi a 32 bit, 16 bit o 8 bit. Le specifiche del linguaggio C non specificano chiaramente come il compilatore deve implementare campi di bit C (ad esempio, endianness e layout di bit), ed \u00e8 difficile determinare quali operazioni di I/O si verificheranno su un campo di bit C letto o scritto. Preferibilmente scrivere valori espliciti nei registri IO invece di usare operazioni di lettura-modifica-scrittura. Cio\u00e8, se si aggiorna un campo in un registro IO in cui gli altri campi hanno valori noti, \u00e8 preferibile scrivere in modo esplicito il contenuto completo del registro. Le scritture esplicite producono codice pi\u00f9 piccolo, pi\u00f9 veloce e pi\u00f9 facile da eseguire il debug.","title":"Porting su un nuovo microcontrollore"},{"location":"Code_Overview.html#sistemi-di-coordinate","text":"Internamente, Klipper tiene traccia principalmente della posizione della testa di stampa in coordinate cartesiane relative al sistema di coordinate specificato nel file di configurazione. Cio\u00e8, la maggior parte del codice Klipper non subir\u00e0 mai un cambiamento nei sistemi di coordinate. Se l'utente fa una richiesta per cambiare l'origine (ad esempio, un comando G92 ), allora quell'effetto si ottiene traducendo i comandi futuri nel sistema di coordinate primario. Tuttavia, in alcuni casi \u00e8 utile ottenere la posizione della testa di stampa in qualche altro sistema di coordinate e Klipper ha diversi strumenti per facilitarlo. Questo pu\u00f2 essere visto eseguendo il comando GET_POSITION. Per esempio: Send: GET_POSITION Recv: // mcu: stepper_a:-2060 stepper_b:-1169 stepper_c:-1613 Recv: // stepper: stepper_a:457.254159 stepper_b:466.085669 stepper_c:465.382132 Recv: // kinematic: X:8.339144 Y:-3.131558 Z:233.347121 Recv: // toolhead: X:8.338078 Y:-3.123175 Z:233.347878 E:0.000000 Recv: // gcode: X:8.338078 Y:-3.123175 Z:233.347878 E:0.000000 Recv: // gcode base: X:0.000000 Y:0.000000 Z:0.000000 E:0.000000 Recv: // gcode homing: X:0.000000 Y:0.000000 Z:0.000000 La posizione \"mcu\" ( stepper.get_mcu_position() nel codice) \u00e8 il numero totale di passaggi che il microcontrollore ha emesso in direzione positiva meno il numero di passaggi emessi in direzione negativa dall'ultimo microcontrollore Ripristina. Se il robot \u00e8 in movimento quando viene emessa la query, il valore riportato include le mosse memorizzate nel buffer del microcontrollore, ma non include le mosse nella coda di previsione. La posizione \"stepper\" ( stepper.get_commanded_position() ) \u00e8 la posizione del dato stepper come tracciato dal codice della cinematica. Questo corrisponde generalmente alla posizione (in mm) del carrello lungo il suo binario, rispetto a position_endstop specificato nel file di configurazione. (Alcune cinematiche tracciano le posizioni dello stepper in radianti anzich\u00e9 in millimetri.) Se il robot \u00e8 in movimento quando viene emessa la query, il valore riportato include i movimenti memorizzati nel buffer del microcontrollore, ma non include i movimenti sulla coda di previsione. Si possono usare le chiamate toolhead.flush_step_generation() o toolhead.wait_moves() per svuotare completamente il codice look-ahead e generazione di passaggi. La posizione \"cinematica\" ( kin.calc_position() ) \u00e8 la posizione cartesiana della testa di stampa come derivata dalle posizioni \"stepper\" ed \u00e8 relativa al sistema di coordinate specificato nel file di configurazione. Questo pu\u00f2 differire dalla posizione cartesiana richiesta a causa della granularit\u00e0 dei motori passo-passo. Se il robot \u00e8 in movimento quando vengono prese le posizioni \"stepper\", il valore riportato include i movimenti memorizzati nel buffer del microcontrollore, ma non include i movimenti sulla coda di previsione. Si possono usare le chiamate toolhead.flush_step_generation() o toolhead.wait_moves() per svuotare completamente il codice look-ahead e generazione di passaggi. La posizione della \"testa di stampa\" ( toolhead.get_position() ) \u00e8 l'ultima posizione richiesta della testa di stampa in coordinate cartesiane rispetto al sistema di coordinate specificato nel file di configurazione. Se il robot \u00e8 in movimento quando viene emessa la richiesta, il valore riportato include tutti i movimenti richiesti (anche quelli nei buffer in attesa di essere inviati ai driver del motore passo-passo). La posizione \"gcode\" \u00e8 l'ultima posizione richiesta da un comando G1 (o G0 ) in coordinate cartesiane relative al sistema di coordinate specificato nel file di configurazione. Questo pu\u00f2 differire dalla posizione \"toolhead\" se \u00e8 attiva una trasformazione del g-code (ad es. bed_mesh, bed_tilt, skew_correction). Questo pu\u00f2 differire dalle coordinate effettive specificate nell'ultimo comando G1 se l'origine del g-code \u00e8 stata modificata (ad esempio, G92 , SET_GCODE_OFFSET , M221 ). Il comando M114 ( gcode_move.get_status()['gcode_position'] ) riporter\u00e0 l'ultima posizione del g-code rispetto al sistema di coordinate del g-code corrente. La \"gcode base\" \u00e8 la posizione dell'origine del codice g in coordinate cartesiane rispetto al sistema di coordinate specificato nel file di configurazione. Comandi come G92 , SET_GCODE_OFFSET e M221 alterano questo valore. Il \"gcode homing\" \u00e8 la posizione da usare per l'origine del g-code (in coordinate cartesiane relative al sistema di coordinate specificato nel file di configurazione) dopo un comando home G28 . Il comando SET_GCODE_OFFSET pu\u00f2 alterare questo valore.","title":"Sistemi di coordinate"},{"location":"Code_Overview.html#time","text":"Fondamentale per il funzionamento di Klipper \u00e8 la gestione di orologi, orari e timestamp. Klipper esegue azioni sulla stampante programmando eventi che si verificheranno nel prossimo futuro. Ad esempio, per accendere una ventola, il codice potrebbe programmare una modifica a un pin GPIO in 100 ms. \u00c8 raro che il codice tenti di eseguire un'azione istantanea. Pertanto, la gestione del tempo all'interno di Klipper \u00e8 fondamentale per il corretto funzionamento. Esistono tre tipi di tempi tracciati internamente nel software host di Klipper: Ora di sistema. L'ora del sistema utilizza l'orologio del sistema: \u00e8 un numero in virgola mobile memorizzato come secondi ed \u00e8 (generalmente) relativo all'ultimo avvio del computer host. I tempi di sistema hanno un uso limitato nel software: vengono utilizzati principalmente durante l'interazione con il sistema operativo. All'interno del codice host, gli orari di sistema sono spesso archiviati in variabili denominate eventtime o curtime . Tempo di stampa. Il tempo di stampa \u00e8 sincronizzato con l'orologio principale del microcontrollore (il microcontrollore definito nella sezione di configurazione \"[mcu]\"). \u00c8 un numero in virgola mobile memorizzato come secondi ed \u00e8 relativo all'ultimo riavvio dell'mcu principale. \u00c8 possibile convertire da un \"tempo di stampa\" all'orologio hardware del microcontrollore principale moltiplicando il tempo di stampa per la frequenza di frequenza configurata staticamente dell'mcu. Il codice host di alto livello utilizza i tempi di stampa per calcolare quasi tutte le azioni fisiche (ad es. movimento della testa, modifiche del riscaldatore, ecc.). All'interno del codice host, i tempi di stampa sono generalmente memorizzati in variabili denominate print_time o move_time . Orologio MCU. Questo \u00e8 il contatore dell'orologio hardware su ogni microcontrollore. Viene memorizzato come numero intero e la sua velocit\u00e0 di aggiornamento \u00e8 relativa alla frequenza del microcontrollore specificato. Il software host traduce i suoi tempi interni in orologi prima della trasmissione all'mcu. Il codice mcu tiene traccia del tempo solo in tick dell'orologio. All'interno del codice host, i valori di clock vengono tracciati come interi a 64 bit, mentre il codice mcu utilizza interi a 32 bit. All'interno del codice host, gli orologi sono generalmente memorizzati in variabili con nomi contenenti clock o tick . La conversione tra i diversi formati dell'ora \u00e8 implementata principalmente nel codice klippy/clocksync.py . Alcune cose da tenere presenti durante la revisione del codice: Orologi a 32 bit e 64 bit: per ridurre la larghezza di banda e migliorare l'efficienza del microcontrollore, gli orologi sul microcontrollore vengono tracciati come numeri interi a 32 bit. Quando si confrontano due orologi nel codice mcu, la funzione timer_is_before() deve essere sempre utilizzata per garantire che i rollover interi siano gestiti correttamente. Il software host converte gli orologi a 32 bit in orologi a 64 bit aggiungendo i bit di ordine superiore dall'ultimo timestamp mcu che ha ricevuto - nessun messaggio dall'mcu \u00e8 mai pi\u00f9 di 2^31 tick di clock in futuro o nel passato, quindi questa conversione non \u00e8 mai ambigua . L'host converte da clock a 64 bit a clock a 32 bit semplicemente troncando i bit di ordine superiore. Per garantire che non vi siano ambiguit\u00e0 in questa conversione, il codice klippy/chelper/serialqueue.c memorizza i messaggi nel buffer finch\u00e9 non si trovano entro 2^31 tick di clock dall'ora target. Microcontrollori multipli: il software host supporta l'utilizzo di pi\u00f9 microcontrollori su una singola stampante. In questo caso, il \"clock MCU\" di ogni microcontrollore viene tracciato separatamente. Il codice clocksync.py gestisce la deriva dell'orologio tra i microcontrollori modificando il modo in cui converte da \"tempo di stampa\" a \"orologio MCU\". Sul mcus secondario, la frequenza mcu utilizzata in questa conversione viene regolarmente aggiornata per tenere conto della deriva misurata.","title":"Time"},{"location":"Command_Templates.html","text":"Modelli di comandi \u00b6 Questo documento fornisce informazioni sull'implementazione di sequenze di comandi G-Code nelle sezioni di configurazione gcode_macro (e simili). Denominazione macro G-Code \u00b6 Le maiuscole non sono importanti per il nome della macro G-Code: MY_MACRO e my_macro saranno considerate allo stesso modo e possono essere chiamati in maiuscolo o minuscolo. Se nel nome della macro vengono utilizzati dei numeri, devono trovarsi tutti alla fine del nome (ad es. TEST_MACRO25 \u00e8 valido, ma MACRO25_TEST3 non lo \u00e8). Formattazione di G-Code nel config \u00b6 L'indentazione \u00e8 importante quando si definisce una macro nel file di configurazione. Per specificare una sequenza G-Code su pi\u00f9 righe \u00e8 importante che ogni riga abbia un'indentazione adeguata. Per esempio: [gcode_macro led_lampeggiante] gcode: SET_PIN PIN=my_led VALUE=1 G4 P2000 SET_PIN PIN=my_led VALUE=0 Nota come l'opzione di configurazione gcode: inizia sempre all'inizio della riga e le righe successive nella macro G-Code non iniziano mai all'inizio. Aggiungi una descrizione alla tua macro \u00b6 Per aiutare a identificare la funzionalit\u00e0 \u00e8 possibile aggiungere una breve descrizione. Aggiungi descrizione: con un breve testo per descrivere la funzionalit\u00e0. L'impostazione predefinita \u00e8 \"Macro codice G\" se non specificato. Per esempio: [gcode_macro led_lampeggiante] description: Esegue lampeggio del led una volta gcode: SET_PIN PIN=my_led VALUE=1 G4 P2000 SET_PIN PIN=my_led VALUE=0 Il terminale visualizzer\u00e0 la descrizione quando si utilizza il comando HELP o la funzione di completamento automatico. Salva/ripristina lo stato per i movimenti G-Code \u00b6 Sfortunatamente, il linguaggio di comando G-Code pu\u00f2 essere difficile da usare. Il meccanismo standard per spostare la testa di stampa \u00e8 tramite il comando G1 (il comando G0 \u00e8 un alias per G1 e pu\u00f2 essere usato in modo intercambiabile con esso). Tuttavia, questo comando si basa sull'impostazione dello \"stato di analisi del codice G\" da M82 , M83 , G90 , G91 , G92 e precedenti comandi G1 . Quando si crea una macro G-Code \u00e8 una buona idea impostare sempre in modo esplicito lo stato di analisi del G-Code prima di emettere un comando G1 . (Altrimenti, c'\u00e8 il rischio che il comando G1 faccia una richiesta indesiderabile.) Un modo comune per farlo \u00e8 avvolgere le mosse G1 in SAVE_GCODE_STATE , G91 e RESTORE_GCODE_STATE . Per esempio: [gcode_macro MOVE_UP] gcode: SAVE_GCODE_STATE NAME=my_move_up_state G91 G1 Z10 F300 RESTORE_GCODE_STATE NAME=my_move_up_state Il comando G91 pone lo stato di analisi del codice G in \"modalit\u00e0 di spostamento relativo\" e il comando RESTORE_GCODE_STATE ripristina lo stato a quello che era prima di entrare nella macro. Assicurati di specificare una velocit\u00e0 esplicita (tramite il parametro F ) sul primo comando G1 . Espansione del modello \u00b6 La sezione di configurazione di gcode_macro gcode: viene valutata utilizzando il linguaggio del modello Jinja2. \u00c8 possibile valutare le espressioni in fase di esecuzione racchiudendole in caratteri { } o utilizzando istruzioni condizionali racchiuse in {% %} . Vedere la documentazione Jinja2 per ulteriori informazioni sulla sintassi. Un esempio di macro complessa: [gcode_macro clean_nozzle] gcode: {% set wipe_count = 8 %} SAVE_GCODE_STATE NAME=clean_nozzle_state G90 G0 Z15 F300 {% for wipe in range(wipe_count) %} {% for coordinate in [(275, 4),(235, 4)] %} G0 X{coordinate[0]} Y{coordinate[1] + 0.25 * wipe} Z9.7 F12000 {% endfor %} {% endfor %} RESTORE_GCODE_STATE NAME=clean_nozzle_state Parametri Macro \u00b6 Spesso \u00e8 utile controllare i parametri passati alla macro quando viene chiamata. Questi parametri sono disponibili tramite la pseudo-variabile params . Ad esempio, se la macro: [gcode_macro SET_PERCENT] gcode: M117 Now at { params.VALUE|float * 100 }% sono stati invocati come SET_PERCENT VALUE=.2 verrebbero valutati in M117 Now at 20% . Si noti che i nomi dei parametri sono sempre in maiuscolo quando vengono valutati nella macro e vengono sempre passati come stringhe. Se si eseguono calcoli matematici, devono essere convertiti esplicitamente in numeri interi o float. \u00c8 comune usare la direttiva Jinja2 set per usare un parametro predefinito e assegnare il risultato a un nome locale. Per esempio: [gcode_macro SET_BED_TEMPERATURE] gcode: {% set bed_temp = params.TEMPERATURE|default(40)|float %} M140 S{bed_temp La variabile \"rawparams\" \u00b6 \u00c8 possibile accedere ai parametri completi non analizzati per la macro in esecuzione tramite la pseudo-variabile rawparams . Nota che questo includer\u00e0 tutti i commenti che facevano parte del comando originale. Vedere il file sample-macros.cfg per un esempio che mostra come sovrascrivere il comando M117 usando rawparams . La variabile \"printer\" \u00b6 \u00c8 possibile ispezionare (e modificare) lo stato corrente della stampante tramite la pseudo-variabile printer . Per esempio: [gcode_macro slow_fan] gcode: M106 S{ printer.fan.speed * 0.9 * 255} I campi disponibili sono definiti nel documento Status Reference . Importante! Le macro vengono prima valutate per intero e solo dopo vengono eseguiti i comandi risultanti. Se una macro emette un comando che altera lo stato della stampante, i risultati di tale cambiamento di stato non saranno visibili durante la valutazione della macro. Ci\u00f2 pu\u00f2 anche comportare un comportamento impercettibile quando una macro genera comandi che chiamano altre macro, poich\u00e9 la macro chiamata viene valutata quando viene richiamata (che avviene dopo l'intera valutazione della macro chiamante). Per convenzione, il nome immediatamente successivo a printer \u00e8 il nome di una sezione di configurazione. Quindi, ad esempio, printer.fan si riferisce all'oggetto fan creato dalla sezione di configurazione [fan] . Ci sono alcune eccezioni a questa regola, in particolare gli oggetti gcode_move e toolhead . Se la sezione di configurazione contiene spazi, \u00e8 possibile accedervi tramite l'accessor [ ] , ad esempio: printer[\"generic_heater my_chamber_heater\"].temperature . Si noti che la direttiva Jinja2 set pu\u00f2 assegnare un nome locale a un oggetto nella gerarchia printer . Ci\u00f2 pu\u00f2 rendere le macro pi\u00f9 leggibili e ridurre la digitazione. Per esempio: [gcode_macro QUERY_HTU21D] gcode: {% set sensor = printer[\"htu21d my_sensor\"] %} M117 Temp:{sensor.temperature} Humidity:{sensor.humidity} Azioni \u00b6 Sono disponibili alcuni comandi che possono alterare lo stato della stampante. Ad esempio, { action_emergency_stop() } provocherebbe l'arresto della stampante. Si noti che queste azioni vengono eseguite nel momento in cui viene valutata la macro, il che potrebbe richiedere un periodo di tempo significativo prima dell'esecuzione dei comandi g-code generati. Comandi \"azione\" disponibili: action_respond_info(msg) : scrive il dato msg sullo pseudo-terminale /tmp/printer. Ogni riga di msg verr\u00e0 inviata con un prefisso \"//\". action_raise_error(msg) : annulla la macro corrente (e qualsiasi macro chiamante) e scrivie il dato msg sullo pseudo-terminale /tmp/printer. La prima riga di msg verr\u00e0 inviata con un prefisso \"!!\" e le righe successive avranno un prefisso \"//\". action_emergency_stop(msg) : fa passare la stampante a uno stato di spegnimento. Il parametro msg \u00e8 opzionale, pu\u00f2 essere utile per descrivere il motivo dell'arresto. action_call_remote_method(method_name) : chiama un metodo registrato da un client remoto. Se il metodo accetta parametri, questi dovrebbero essere forniti tramite argomenti chiave, ad esempio: action_call_remote_method(\"print_stuff\", my_arg=\"hello_world\") Variabili \u00b6 Il comando SET_GCODE_VARIABLE pu\u00f2 essere utile per salvare lo stato tra le chiamate di macro. I nomi delle variabili non possono contenere caratteri maiuscoli. Per esempio: [gcode_macro start_probe] variable_bed_temp: 0 gcode: # Salva la temperatura target nella variabile bed_temp SET_GCODE_VARIABLE MACRO=start_probe VARIABLE=bed_temp VALUE={printer.heater_bed.target} # Disattiva il riscaldamento del piatto M140 # Esegue sonda PROBE # Chiama la macro finish_probe al completamento finish_probe [gcode_macro finish_probe] gcode: # Ripristinare la temperatura del piatto M140 S{printer[\"gcode_macro start_probe\"].bed_temp} Assicurarsi di tenere in considerazione i tempi della valutazione della macro e dell'esecuzione dei comandi quando si utilizza SET_GCODE_VARIABLE. Gcode ritardati \u00b6 L'opzione di configurazione [delayed_gcode] pu\u00f2 essere utilizzata per eseguire una sequenza gcode ritardata: [delayed_gcode clear_display] gcode: M117 [gcode_macro load_filament] gcode: G91 G1 E50 G90 M400 M117 Load Complete! UPDATE_DELAYED_GCODE ID=clear_display DURATION=10 Quando viene eseguita la macro load_filament sopra, visualizzer\u00e0 un \"Load Complete!\" messaggio al termine dell'estrusione. L'ultima riga di gcode abilita il delay_gcode \"clear_display\", impostato per essere eseguito in 10 secondi. L'opzione di configurazione initial_duration pu\u00f2 essere impostata per eseguire il delay_gcode all'avvio della stampante. Il conto alla rovescia inizia quando la stampante entra nello stato \"ready\". Ad esempio, il codice delay_g riportato di seguito verr\u00e0 eseguito 5 secondi dopo che la stampante \u00e8 pronta, inizializzando il display con un messaggio\"Welcome!\": [delayed_gcode welcome] initial_duration: 5. gcode: M117 Welcome! \u00c8 possibile che un gcode ritardato si ripeta aggiornandosi nell'opzione gcode: [delayed_gcode report_temp] initial_duration: 2. gcode: {action_respond_info(\"Extruder Temp: %.1f\" % (printer.extruder0.temperature))} UPDATE_DELAYED_GCODE ID=report_temp DURATION=2 Il codice delayed_gcode sopra riportato invier\u00e0 \"// Extruder Temp: [ex0_temp]\" a Octoprint ogni 2 secondi. Questo pu\u00f2 essere annullato con il seguente gcode: UPDATE_DELAYED_GCODE ID=report_temp DURATION=0 Modelli di menu \u00b6 Se \u00e8 abilitata una sezione di configurazione display , \u00e8 possibile personalizzare il menu con le sezioni di configurazione menu . I seguenti attributi di sola lettura sono disponibili nei modelli di menu: menu.width - larghezza dell'elemento (numero di colonne di visualizzazione) menu.ns - namespace del elemento menu.event - nome dell'evento che ha attivato lo script menu.input - valore di input, disponibile solo nel contesto dello script di input Le seguenti azioni sono disponibili nei modelli di menu: menu.back(force, update) : eseguir\u00e0 il comando menu back, parametri booleani opzionali <force> e <update> . Quando <force> \u00e8 impostato su True, interromper\u00e0 anche la modifica. Il valore predefinito \u00e8 False. Quando <update> \u00e8 impostato su False, gli elementi del contenitore padre non vengono aggiornati. Il valore predefinito \u00e8 True. menu.exit(force) - eseguir\u00e0 il comando di uscita dal menu, parametro booleano opzionale <force> valore predefinito False. Quando <force> \u00e8 impostato su True, interromper\u00e0 anche la modifica. Il valore predefinito \u00e8 False. Salvare variabili su disco \u00b6 Se \u00e8 stata abilitata una sezione di configurazione save_variables , SAVE_VARIABLE VARIABLE=<nome> VALUE=<valore> pu\u00f2 essere utilizzato per salvare la variabile su disco in modo che possa essere utilizzata tra i riavvii. Tutte le variabili memorizzate vengono caricate nel dict printer.save_variables.variables all'avvio e possono essere utilizzate nelle macro gcode. per evitare righe troppo lunghe puoi aggiungere quanto segue nella parte superiore della macro: {% set svv = printer.save_variables.variables %} Ad esempio, potrebbe essere utilizzato per salvare lo stato dell'hotend 2-in-1-out e quando si avvia una stampa assicurarsi che venga utilizzato l'estrusore attivo, anzich\u00e9 T0: [gcode_macro T1] gcode: ACTIVATE_EXTRUDER extruder=extruder1 SAVE_VARIABLE VARIABLE=currentextruder VALUE='\"extruder1\"' [gcode_macro T0] gcode: ACTIVATE_EXTRUDER extruder=extruder SAVE_VARIABLE VARIABLE=currentextruder VALUE='\"extruder\"' [gcode_macro START_GCODE] gcode: {% set svv = printer.save_variables.variables %} ACTIVATE_EXTRUDER extruder={svv.currentextruder}","title":"Modelli di comandi"},{"location":"Command_Templates.html#modelli-di-comandi","text":"Questo documento fornisce informazioni sull'implementazione di sequenze di comandi G-Code nelle sezioni di configurazione gcode_macro (e simili).","title":"Modelli di comandi"},{"location":"Command_Templates.html#denominazione-macro-g-code","text":"Le maiuscole non sono importanti per il nome della macro G-Code: MY_MACRO e my_macro saranno considerate allo stesso modo e possono essere chiamati in maiuscolo o minuscolo. Se nel nome della macro vengono utilizzati dei numeri, devono trovarsi tutti alla fine del nome (ad es. TEST_MACRO25 \u00e8 valido, ma MACRO25_TEST3 non lo \u00e8).","title":"Denominazione macro G-Code"},{"location":"Command_Templates.html#formattazione-di-g-code-nel-config","text":"L'indentazione \u00e8 importante quando si definisce una macro nel file di configurazione. Per specificare una sequenza G-Code su pi\u00f9 righe \u00e8 importante che ogni riga abbia un'indentazione adeguata. Per esempio: [gcode_macro led_lampeggiante] gcode: SET_PIN PIN=my_led VALUE=1 G4 P2000 SET_PIN PIN=my_led VALUE=0 Nota come l'opzione di configurazione gcode: inizia sempre all'inizio della riga e le righe successive nella macro G-Code non iniziano mai all'inizio.","title":"Formattazione di G-Code nel config"},{"location":"Command_Templates.html#aggiungi-una-descrizione-alla-tua-macro","text":"Per aiutare a identificare la funzionalit\u00e0 \u00e8 possibile aggiungere una breve descrizione. Aggiungi descrizione: con un breve testo per descrivere la funzionalit\u00e0. L'impostazione predefinita \u00e8 \"Macro codice G\" se non specificato. Per esempio: [gcode_macro led_lampeggiante] description: Esegue lampeggio del led una volta gcode: SET_PIN PIN=my_led VALUE=1 G4 P2000 SET_PIN PIN=my_led VALUE=0 Il terminale visualizzer\u00e0 la descrizione quando si utilizza il comando HELP o la funzione di completamento automatico.","title":"Aggiungi una descrizione alla tua macro"},{"location":"Command_Templates.html#salvaripristina-lo-stato-per-i-movimenti-g-code","text":"Sfortunatamente, il linguaggio di comando G-Code pu\u00f2 essere difficile da usare. Il meccanismo standard per spostare la testa di stampa \u00e8 tramite il comando G1 (il comando G0 \u00e8 un alias per G1 e pu\u00f2 essere usato in modo intercambiabile con esso). Tuttavia, questo comando si basa sull'impostazione dello \"stato di analisi del codice G\" da M82 , M83 , G90 , G91 , G92 e precedenti comandi G1 . Quando si crea una macro G-Code \u00e8 una buona idea impostare sempre in modo esplicito lo stato di analisi del G-Code prima di emettere un comando G1 . (Altrimenti, c'\u00e8 il rischio che il comando G1 faccia una richiesta indesiderabile.) Un modo comune per farlo \u00e8 avvolgere le mosse G1 in SAVE_GCODE_STATE , G91 e RESTORE_GCODE_STATE . Per esempio: [gcode_macro MOVE_UP] gcode: SAVE_GCODE_STATE NAME=my_move_up_state G91 G1 Z10 F300 RESTORE_GCODE_STATE NAME=my_move_up_state Il comando G91 pone lo stato di analisi del codice G in \"modalit\u00e0 di spostamento relativo\" e il comando RESTORE_GCODE_STATE ripristina lo stato a quello che era prima di entrare nella macro. Assicurati di specificare una velocit\u00e0 esplicita (tramite il parametro F ) sul primo comando G1 .","title":"Salva/ripristina lo stato per i movimenti G-Code"},{"location":"Command_Templates.html#espansione-del-modello","text":"La sezione di configurazione di gcode_macro gcode: viene valutata utilizzando il linguaggio del modello Jinja2. \u00c8 possibile valutare le espressioni in fase di esecuzione racchiudendole in caratteri { } o utilizzando istruzioni condizionali racchiuse in {% %} . Vedere la documentazione Jinja2 per ulteriori informazioni sulla sintassi. Un esempio di macro complessa: [gcode_macro clean_nozzle] gcode: {% set wipe_count = 8 %} SAVE_GCODE_STATE NAME=clean_nozzle_state G90 G0 Z15 F300 {% for wipe in range(wipe_count) %} {% for coordinate in [(275, 4),(235, 4)] %} G0 X{coordinate[0]} Y{coordinate[1] + 0.25 * wipe} Z9.7 F12000 {% endfor %} {% endfor %} RESTORE_GCODE_STATE NAME=clean_nozzle_state","title":"Espansione del modello"},{"location":"Command_Templates.html#parametri-macro","text":"Spesso \u00e8 utile controllare i parametri passati alla macro quando viene chiamata. Questi parametri sono disponibili tramite la pseudo-variabile params . Ad esempio, se la macro: [gcode_macro SET_PERCENT] gcode: M117 Now at { params.VALUE|float * 100 }% sono stati invocati come SET_PERCENT VALUE=.2 verrebbero valutati in M117 Now at 20% . Si noti che i nomi dei parametri sono sempre in maiuscolo quando vengono valutati nella macro e vengono sempre passati come stringhe. Se si eseguono calcoli matematici, devono essere convertiti esplicitamente in numeri interi o float. \u00c8 comune usare la direttiva Jinja2 set per usare un parametro predefinito e assegnare il risultato a un nome locale. Per esempio: [gcode_macro SET_BED_TEMPERATURE] gcode: {% set bed_temp = params.TEMPERATURE|default(40)|float %} M140 S{bed_temp","title":"Parametri Macro"},{"location":"Command_Templates.html#la-variabile-rawparams","text":"\u00c8 possibile accedere ai parametri completi non analizzati per la macro in esecuzione tramite la pseudo-variabile rawparams . Nota che questo includer\u00e0 tutti i commenti che facevano parte del comando originale. Vedere il file sample-macros.cfg per un esempio che mostra come sovrascrivere il comando M117 usando rawparams .","title":"La variabile \"rawparams\""},{"location":"Command_Templates.html#la-variabile-printer","text":"\u00c8 possibile ispezionare (e modificare) lo stato corrente della stampante tramite la pseudo-variabile printer . Per esempio: [gcode_macro slow_fan] gcode: M106 S{ printer.fan.speed * 0.9 * 255} I campi disponibili sono definiti nel documento Status Reference . Importante! Le macro vengono prima valutate per intero e solo dopo vengono eseguiti i comandi risultanti. Se una macro emette un comando che altera lo stato della stampante, i risultati di tale cambiamento di stato non saranno visibili durante la valutazione della macro. Ci\u00f2 pu\u00f2 anche comportare un comportamento impercettibile quando una macro genera comandi che chiamano altre macro, poich\u00e9 la macro chiamata viene valutata quando viene richiamata (che avviene dopo l'intera valutazione della macro chiamante). Per convenzione, il nome immediatamente successivo a printer \u00e8 il nome di una sezione di configurazione. Quindi, ad esempio, printer.fan si riferisce all'oggetto fan creato dalla sezione di configurazione [fan] . Ci sono alcune eccezioni a questa regola, in particolare gli oggetti gcode_move e toolhead . Se la sezione di configurazione contiene spazi, \u00e8 possibile accedervi tramite l'accessor [ ] , ad esempio: printer[\"generic_heater my_chamber_heater\"].temperature . Si noti che la direttiva Jinja2 set pu\u00f2 assegnare un nome locale a un oggetto nella gerarchia printer . Ci\u00f2 pu\u00f2 rendere le macro pi\u00f9 leggibili e ridurre la digitazione. Per esempio: [gcode_macro QUERY_HTU21D] gcode: {% set sensor = printer[\"htu21d my_sensor\"] %} M117 Temp:{sensor.temperature} Humidity:{sensor.humidity}","title":"La variabile \"printer\""},{"location":"Command_Templates.html#azioni","text":"Sono disponibili alcuni comandi che possono alterare lo stato della stampante. Ad esempio, { action_emergency_stop() } provocherebbe l'arresto della stampante. Si noti che queste azioni vengono eseguite nel momento in cui viene valutata la macro, il che potrebbe richiedere un periodo di tempo significativo prima dell'esecuzione dei comandi g-code generati. Comandi \"azione\" disponibili: action_respond_info(msg) : scrive il dato msg sullo pseudo-terminale /tmp/printer. Ogni riga di msg verr\u00e0 inviata con un prefisso \"//\". action_raise_error(msg) : annulla la macro corrente (e qualsiasi macro chiamante) e scrivie il dato msg sullo pseudo-terminale /tmp/printer. La prima riga di msg verr\u00e0 inviata con un prefisso \"!!\" e le righe successive avranno un prefisso \"//\". action_emergency_stop(msg) : fa passare la stampante a uno stato di spegnimento. Il parametro msg \u00e8 opzionale, pu\u00f2 essere utile per descrivere il motivo dell'arresto. action_call_remote_method(method_name) : chiama un metodo registrato da un client remoto. Se il metodo accetta parametri, questi dovrebbero essere forniti tramite argomenti chiave, ad esempio: action_call_remote_method(\"print_stuff\", my_arg=\"hello_world\")","title":"Azioni"},{"location":"Command_Templates.html#variabili","text":"Il comando SET_GCODE_VARIABLE pu\u00f2 essere utile per salvare lo stato tra le chiamate di macro. I nomi delle variabili non possono contenere caratteri maiuscoli. Per esempio: [gcode_macro start_probe] variable_bed_temp: 0 gcode: # Salva la temperatura target nella variabile bed_temp SET_GCODE_VARIABLE MACRO=start_probe VARIABLE=bed_temp VALUE={printer.heater_bed.target} # Disattiva il riscaldamento del piatto M140 # Esegue sonda PROBE # Chiama la macro finish_probe al completamento finish_probe [gcode_macro finish_probe] gcode: # Ripristinare la temperatura del piatto M140 S{printer[\"gcode_macro start_probe\"].bed_temp} Assicurarsi di tenere in considerazione i tempi della valutazione della macro e dell'esecuzione dei comandi quando si utilizza SET_GCODE_VARIABLE.","title":"Variabili"},{"location":"Command_Templates.html#gcode-ritardati","text":"L'opzione di configurazione [delayed_gcode] pu\u00f2 essere utilizzata per eseguire una sequenza gcode ritardata: [delayed_gcode clear_display] gcode: M117 [gcode_macro load_filament] gcode: G91 G1 E50 G90 M400 M117 Load Complete! UPDATE_DELAYED_GCODE ID=clear_display DURATION=10 Quando viene eseguita la macro load_filament sopra, visualizzer\u00e0 un \"Load Complete!\" messaggio al termine dell'estrusione. L'ultima riga di gcode abilita il delay_gcode \"clear_display\", impostato per essere eseguito in 10 secondi. L'opzione di configurazione initial_duration pu\u00f2 essere impostata per eseguire il delay_gcode all'avvio della stampante. Il conto alla rovescia inizia quando la stampante entra nello stato \"ready\". Ad esempio, il codice delay_g riportato di seguito verr\u00e0 eseguito 5 secondi dopo che la stampante \u00e8 pronta, inizializzando il display con un messaggio\"Welcome!\": [delayed_gcode welcome] initial_duration: 5. gcode: M117 Welcome! \u00c8 possibile che un gcode ritardato si ripeta aggiornandosi nell'opzione gcode: [delayed_gcode report_temp] initial_duration: 2. gcode: {action_respond_info(\"Extruder Temp: %.1f\" % (printer.extruder0.temperature))} UPDATE_DELAYED_GCODE ID=report_temp DURATION=2 Il codice delayed_gcode sopra riportato invier\u00e0 \"// Extruder Temp: [ex0_temp]\" a Octoprint ogni 2 secondi. Questo pu\u00f2 essere annullato con il seguente gcode: UPDATE_DELAYED_GCODE ID=report_temp DURATION=0","title":"Gcode ritardati"},{"location":"Command_Templates.html#modelli-di-menu","text":"Se \u00e8 abilitata una sezione di configurazione display , \u00e8 possibile personalizzare il menu con le sezioni di configurazione menu . I seguenti attributi di sola lettura sono disponibili nei modelli di menu: menu.width - larghezza dell'elemento (numero di colonne di visualizzazione) menu.ns - namespace del elemento menu.event - nome dell'evento che ha attivato lo script menu.input - valore di input, disponibile solo nel contesto dello script di input Le seguenti azioni sono disponibili nei modelli di menu: menu.back(force, update) : eseguir\u00e0 il comando menu back, parametri booleani opzionali <force> e <update> . Quando <force> \u00e8 impostato su True, interromper\u00e0 anche la modifica. Il valore predefinito \u00e8 False. Quando <update> \u00e8 impostato su False, gli elementi del contenitore padre non vengono aggiornati. Il valore predefinito \u00e8 True. menu.exit(force) - eseguir\u00e0 il comando di uscita dal menu, parametro booleano opzionale <force> valore predefinito False. Quando <force> \u00e8 impostato su True, interromper\u00e0 anche la modifica. Il valore predefinito \u00e8 False.","title":"Modelli di menu"},{"location":"Command_Templates.html#salvare-variabili-su-disco","text":"Se \u00e8 stata abilitata una sezione di configurazione save_variables , SAVE_VARIABLE VARIABLE=<nome> VALUE=<valore> pu\u00f2 essere utilizzato per salvare la variabile su disco in modo che possa essere utilizzata tra i riavvii. Tutte le variabili memorizzate vengono caricate nel dict printer.save_variables.variables all'avvio e possono essere utilizzate nelle macro gcode. per evitare righe troppo lunghe puoi aggiungere quanto segue nella parte superiore della macro: {% set svv = printer.save_variables.variables %} Ad esempio, potrebbe essere utilizzato per salvare lo stato dell'hotend 2-in-1-out e quando si avvia una stampa assicurarsi che venga utilizzato l'estrusore attivo, anzich\u00e9 T0: [gcode_macro T1] gcode: ACTIVATE_EXTRUDER extruder=extruder1 SAVE_VARIABLE VARIABLE=currentextruder VALUE='\"extruder1\"' [gcode_macro T0] gcode: ACTIVATE_EXTRUDER extruder=extruder SAVE_VARIABLE VARIABLE=currentextruder VALUE='\"extruder\"' [gcode_macro START_GCODE] gcode: {% set svv = printer.save_variables.variables %} ACTIVATE_EXTRUDER extruder={svv.currentextruder}","title":"Salvare variabili su disco"},{"location":"Config_Changes.html","text":"Modifiche alla configurazione \u00b6 Questo documento copre le modifiche software recenti al file di configurazione che non sono compatibili con le versioni precedenti. \u00c8 una buona idea rivedere questo documento durante l'aggiornamento del software Klipper. Tutte le date in questo documento sono approssimative. Cambiamenti \u00b6 20230201: Il modulo [bed_mesh] non carica pi\u00f9 il profilo default all'avvio. Si consiglia agli utenti che usano il profilo default di aggiungere BED_MESH_PROFILE LOAD=default alla loro macro START_PRINT (o alla configurazione \"Start G-Code\" del loro slicer quando applicabile). 20230103: Ora \u00e8 possibile con lo script flash-sdcard.sh eseguire il flashing di entrambe le varianti di Bigtreetech SKR-2, STM32F407 e STM32F429. Ci\u00f2 significa che il tag originale di btt-skr2 ora \u00e8 cambiato in btt-skr-2-f407 o btt-skr-2-f429. 20221128: rilascio di Klipper v0.11.0. 20221122: In precedenza, con safe_z_home, era possibile che z_hop dopo l'homing g28 andasse nella direzione z negativa. Ora, uno z_hop viene eseguito dopo g28 solo se risulta in un hop positivo, rispecchiando il comportamento dello z_hop che si verifica prima dell'homing g28. 20220616: in precedenza era possibile eseguire il flashing di un rp2040 in modalit\u00e0 bootloader eseguendo make flash FLASH_DEVICE=first . Il comando equivalente \u00e8 ora make flash FLASH_DEVICE=2e8a:0003 . 20220612: Il microcontrollore rp2040 ora ha una soluzione alternativa per l'errata USB \"rp2040-e5\". Ci\u00f2 dovrebbe rendere pi\u00f9 affidabili le connessioni USB iniziali. Tuttavia, potrebbe comportare un cambiamento nel comportamento del pin gpio15. \u00c8 improbabile che il cambiamento di comportamento di gpio15 sia evidente. 20220407: l'opzione di configurazione temperature_fan pid_integral_max \u00e8 stata rimossa (era deprecata su 20210612). 20220407: L'ordine dei colori predefinito per i LED pca9632 \u00e8 ora \"RGBW\". Aggiungi un'impostazione esplicita color_order: RBGW alla sezione di configurazione di pca9632 per ottenere il comportamento precedente. 20220330: Il formato delle informazioni di stato printer.neopixel.color_data per i moduli neopixel e dotstar \u00e8 cambiato. Le informazioni sono ora memorizzate come un elenco di elenchi di colori (invece di un elenco di dizionari). Per i dettagli, vedere il riferimento dello stato . 20220307: M73 non imposter\u00e0 pi\u00f9 l'avanzamento della stampa su 0 se manca P . 20220304: Non esiste pi\u00f9 un valore predefinito per il parametro extruder delle sezioni di configurazione extruder_stepper . Se lo si desidera, specificare esplicitamente extruder: extruder per associare il motore passo-passo alla coda di movimento \"estrusore\" all'avvio. 20220210: Il comando SYNC_STEPPER_TO_EXTRUDER \u00e8 deprecato; il comando SET_EXTRUDER_STEP_DISTANCE \u00e8 deprecato; l'opzione di configurazione extruder shared_heater \u00e8 deprecata. Queste funzionalit\u00e0 verranno rimosse nel prossimo futuro. Sostituisci SET_EXTRUDER_STEP_DISTANCE con SET_EXTRUDER_ROTATION_DISTANCE . Sostituisci SYNC_STEPPER_TO_EXTRUDER con SYNC_EXTRUDER_MOTION . Sostituisci le sezioni di configurazione dell'estrusore usando shared_heater con le sezioni di configurazione extruder_stepper e aggiorna le macro di attivazione per usare SYNC_EXTRUDER_MOTION . 20220116: Il codice di calcolo della run_current per tmc2130, tmc2208, tmc2209 e tmc2660 \u00e8 cambiato. Per alcune impostazioni di run_current i driver possono ora essere configurati in modo diverso. Questa nuova configurazione dovrebbe essere pi\u00f9 accurata, ma potrebbe invalidare la precedente ottimizzazione del driver tmc. 20211230: Gli script per ottimizzare l'input shaper ( scripts/calibrate_shaper.py e scripts/graph_accelerometer.py ) sono stati migrati per utilizzare Python3 per impostazione predefinita. Di conseguenza, gli utenti devono installare le versioni Python3 di determinati pacchetti (ad esempio sudo apt install python3-numpy python3-matplotlib ) per continuare a utilizzare questi script. Per maggiori dettagli, fare riferimento a Installazione del software . In alternativa, gli utenti possono forzare temporaneamente l'esecuzione di questi script in Python 2 chiamando esplicitamente l'interprete Python2 nella console: python2 ~/klipper/scripts/calibrate_shaper.py ... 20211110: Il sensore di temperatura \"NTC 100K beta 3950\" \u00e8 obsoleto. Questo sensore verr\u00e0 rimosso nel prossimo futuro. La maggior parte degli utenti trover\u00e0 il sensore di temperatura \"Generico 3950\" pi\u00f9 accurato. Per continuare a utilizzare la definizione precedente (in genere meno accurata), definire un termistore personalizzato con temperature1: 25 , resistance1: 100000 e beta: 3950 . 20211104: L'opzione \"step pulse duration\" in \"make menuconfig\" \u00e8 stata rimossa. La durata del passaggio predefinita per i driver TMC configurati in modalit\u00e0 UART o SPI \u00e8 ora di 100 ns. Una nuova impostazione step_pulse_duration nella sezione stepper config dovrebbe essere impostata per tutti gli stepper che necessitano di una durata dell'impulso personalizzata. 20211102: diverse funzionalit\u00e0 deprecate sono state rimosse. L'opzione stepper step_distance \u00e8 stata rimossa (obsoleta nel 20201222). L'alias del sensore rpi_temperature \u00e8 stato rimosso (obsoleto il 20210219). L'opzione mcu pin_map \u00e8 stata rimossa (deprecata su 20210325). La gcode_macro default_parameter_<name> e l'accesso macro ai parametri dei comandi diversi dalla pseudo-variabile params sono stati rimossi (deprecato in 20210503). L'opzione del riscaldatore pid_integral_max \u00e8 stata rimossa (obsoleta il 20210612). 20210929: Klipper v0.10.0 rilasciato. 20210903: Il valore predefinito smooth_time per i riscaldatori \u00e8 cambiato in 1 secondo (da 2 secondi). Per la maggior parte delle stampanti ci\u00f2 si tradurr\u00e0 in un controllo della temperatura pi\u00f9 stabile. 20210830: il nome adxl345 predefinito \u00e8 ora \"adxl345\". Il parametro CHIP predefinito per ACCELEROMETER_MEASURE e ACCELEROMETER_QUERY ora \u00e8 \"adxl345\". 20210830: il comando adxl345 ACCELEROMETER_MEASURE non supporta pi\u00f9 un parametro RATE. Per modificare la frequenza delle query, aggiornare il file printer.cfg ed eseguire un comando RESTART. 20210821: Diverse impostazioni di configurazione in printer.configfile.settings verranno ora riportate come elenchi anzich\u00e9 come stringhe grezze. Se si desidera la stringa grezza effettiva, utilizzare invece printer.configfile.config . 20210819: In alcuni casi, un movimento di riferimento G28 pu\u00f2 terminare in una posizione che \u00e8 nominalmente al di fuori dell'intervallo di movimento valido. In rare situazioni ci\u00f2 pu\u00f2 causare errori di \"spostamento fuori portata\" confusi dopo l'homing. In tal caso, modificare gli script di avvio per spostare la testa utensile in una posizione valida subito dopo l'homing. 20210814: Gli pseudo-pin solo analogici su atmega168 e atmega328 sono stati rinominati da PE0/PE1 a PE2/PE3. 20210720: una sezione controller_fan ora monitora tutti i motori passo-passo per impostazione predefinita (non solo i motori passo-passo cinematici). Se si desidera il comportamento precedente, vedere l'opzione di configurazione stepper nel riferimento di configurazione . 20210703: Una sezione di configurazione samd_sercom deve ora specificare il bus sercom che sta configurando tramite l'opzione sercom . 20210612: L'opzione di configurazione pid_integral_max nelle sezioni riscaldatore e temperature_fan \u00e8 obsoleta. L'opzione verr\u00e0 rimossa nel prossimo futuro. 20210503: The gcode_macro default_parameter_<name> config option is deprecated. Use the params pseudo-variable to access macro parameters. Other methods for accessing macro parameters will be removed in the near future. Most users can replace a default_parameter_NAME: VALUE config option with a line like the following in the start of the macro: {% set NAME = params.NAME|default(VALUE)|float %} . See the Command Templates document for examples. 20210430: il comando SET_VELOCITY_LIMIT (e M204) ora pu\u00f2 impostare una velocit\u00e0, un'accelerazione e una square_corner_velocity maggiori dei valori specificati nel file di configurazione. 20210325: il supporto per l'opzione di configurazione pin_map \u00e8 deprecato. Utilizzare il file sample-aliases.cfg per tradurre i nomi dei pin del microcontroller effettivi. L'opzione di configurazione pin_map verr\u00e0 rimossa nel prossimo futuro. 20210313: Il supporto di Klipper per i microcontrollori che comunicano con il bus CAN \u00e8 cambiato. Se si utilizza il bus CAN, \u00e8 necessario eseguire nuovamente il flashing di tutti i microcontrollori e la configurazione di Klipper deve essere aggiornata . 20210310: Il valore predefinito TMC2660 per driver_SFILT \u00e8 stato modificato da 1 a 0. 20210227: I driver del motore passo-passo TMC in modalit\u00e0 UART o SPI ora vengono interrogati una volta al secondo ogni volta che sono abilitati - se il driver non pu\u00f2 essere contattato o se il driver segnala un errore, Klipper passer\u00e0 allo stato di spegnimento. 20210219: Il modulo rpi_temperature \u00e8 stato rinominato in temperature_host . Sostituisci tutte le occorrenze di sensor_type: rpi_temperature con sensor_type: temperature_host . Il percorso del file di temperatura pu\u00f2 essere specificato nella variabile di configurazione sensor_path . Il nome rpi_temperature \u00e8 deprecato e verr\u00e0 rimosso nel prossimo futuro. 20210201: Il comando TEST_RESONANCES ora disabiliter\u00e0 l'input shaping se era stato precedentemente abilitato (e lo riattiver\u00e0 dopo il test). Per ignorare questo comportamento e mantenere abilitato lo shaping dell'input, \u00e8 possibile passare un parametro aggiuntivo INPUT_SHAPING=1 al comando. 20210201: Il comando ACCELEROMETER_MEASURE aggiunger\u00e0 ora il nome del chip dell'accelerometro al nome del file di output se al chip \u00e8 stato assegnato un nome nella corrispondente sezione adxl345 di printer.cfg. 20201222: L'impostazione step_distance nelle sezioni di configurazione dello stepper \u00e8 obsoleta. Si consiglia di aggiornare la configurazione per utilizzare l'impostazione rotation_distance . Il supporto per step_distance verr\u00e0 rimosso nel prossimo futuro. 20201218: L'impostazione endstop_phase nel modulo endstop_phase \u00e8 stata sostituita con trigger_phase . Se si utilizza il modulo fasi endstop, sar\u00e0 necessario convertire in rotation_distance e ricalibrare eventuali fasi endstop eseguendo il comando ENDSTOP_PHASE_CALIBRATE. 20201218: le stampanti rotanti delta e polari ora devono specificare un gear_ratio per i loro stepper rotanti e potrebbero non specificare pi\u00f9 un parametro step_distance . Vedere il riferimento di configurazione per il formato del nuovo parametro gear_ratio. 20201213: Non \u00e8 valido specificare una Z \"position_endstop\" quando si utilizza \"probe:z_virtual_endstop\". Verr\u00e0 ora generato un errore se viene specificata una Z \"position_endstop\" con \"probe:z_virtual_endstop\". Rimuovere la definizione Z \"position_endstop\" per correggere l'errore. 20201120: La sezione di configurazione [board_pins] ora specifica il nome mcu in un parametro esplicito mcu: . Se si utilizza board_pins per un mcu secondario, \u00e8 necessario aggiornare la configurazione per specificare quel nome. Vedere il riferimento di configurazione per ulteriori dettagli. 20201112: Il tempo riportato da print_stats.print_duration \u00e8 cambiato. La durata precedente alla prima estrusione rilevata \u00e8 ora esclusa. 20201029: L'opzione di configurazione color_order_GRB di neopixel \u00e8 stata rimossa. Se necessario, aggiorna la configurazione per impostare la nuova opzione color_order su RGB, GRB, RGBW o GRBW. 20201029: L'opzione seriale nella sezione di configurazione di mcu non \u00e8 pi\u00f9 impostata su /dev/ttyS0. Nella rara situazione in cui /dev/ttyS0 \u00e8 la porta seriale desiderata, deve essere specificata esplicitamente. 20201020: Klipper v0.9.0 rilasciato. 20200902: Il calcolo della resistenza-to-temperatura dell'RTD per i convertitori MAX31865 \u00e8 stato corretto in modo che non fosse basso. Se si utilizza un dispositivo di questo tipo, \u00e8 necessario ricalibrare la temperatura di stampa e le impostazioni PID. 20200816: L'oggetto printer.gcode della macro gcode \u00e8 stato rinominato in printer.gcode_move . Diverse variabili non documentate in printer.toolhead e printer.gcode sono state rimosse. Vedere docs/Command_Templates.md per un elenco delle variabili di modello disponibili. 20200816: Il sistema \"action_\" della macro gcode \u00e8 cambiato. Sostituisci tutte le chiamate a printer.gcode.action_emergency_stop() con action_emergency_stop() , printer.gcode.action_respond_info() con action_respond_info() e printer.gcode.action_respond_error() con action_raise_error( ) . 20200809: Il sistema di menu \u00e8 stato riscritto. Se il menu \u00e8 stato personalizzato sar\u00e0 necessario aggiornare alla nuova configurazione. Vedere config/example-menu.cfg per i dettagli di configurazione e vedere klippy/extras/display/menu.cfg per esempi. 20200731: Il comportamento dell'attributo progress riportato dall'oggetto stampante virtual_sdcard \u00e8 cambiato. L'avanzamento non viene pi\u00f9 reimpostato su 0 quando una stampa viene sospesa. Ora riporter\u00e0 sempre lo stato di avanzamento in base alla posizione interna del file o 0 se nessun file \u00e8 attualmente caricato. 20200725: Il parametro di configurazione servo enable e il parametro SET_SERVO ENABLE sono stati rimossi. Aggiorna qualsiasi macro per usare SET_SERVO SERVO=my_servo WIDTH=0 per disabilitare un servo. 20200608: Il supporto del display LCD ha cambiato il nome di alcuni \"glifi\" interni. Se \u00e8 stato implementato un layout di visualizzazione personalizzato, potrebbe essere necessario aggiornare ai nomi dei glifi pi\u00f9 recenti (consultare klippy/extras/display/display.cfg per un elenco dei glifi disponibili). 20200606: i nomi dei pin su Linux Mcu sono cambiati. I pin ora hanno nomi nella forma gpiochip<chipid>/gpio<gpio> . Per gpiochip0 puoi anche usare un breve gpio<gpio> . Ad esempio, ci\u00f2 che prima veniva chiamato P20 ora diventa gpio20 o gpiochip0/gpio20 . 20200603: il layout LCD 16x4 predefinito non mostrer\u00e0 pi\u00f9 il tempo rimanente stimato in una stampa. (Verr\u00e0 mostrato solo il tempo trascorso.) Se si desidera il vecchio comportamento, \u00e8 possibile personalizzare la visualizzazione del menu con tali informazioni (vedere la descrizione di display_data in config/example-extras.cfg per i dettagli). 20200531: l'ID prodotto/fornitore USB predefinito \u00e8 ora 0x1d50/0x614e. Questi nuovi ID sono riservati a Klipper (grazie al progetto openmoko). Questa modifica non dovrebbe richiedere alcuna modifica alla configurazione, ma i nuovi ID potrebbero essere visualizzati nei registri di sistema. 20200524: Il valore predefinito per il campo tmc5160 pwm_freq \u00e8 ora zero (anzich\u00e9 uno). 20200425: La variabile del modello di comando gcode_macro printer.heater \u00e8 stata rinominata printer.heaters . 20200313: Il layout lcd predefinito per le stampanti multiestrusore con schermo 16x4 \u00e8 cambiato. Il layout dello schermo del singolo estrusore \u00e8 ora quello predefinito e mostrer\u00e0 l'estrusore attualmente attivo. Per utilizzare il layout di visualizzazione precedente, impostare \"display_group: _multiextruder_16x4\" nella sezione [display] del file printer.cfg. 20200308: La voce di menu predefinita __test \u00e8 stata rimossa. Se il file di configurazione ha un menu personalizzato, assicurati di rimuovere tutti i riferimenti a questa voce di menu __test . 20200308: le opzioni del menu \"deck\" e \"card\" sono state rimosse. Per personalizzare il layout di uno schermo lcd utilizzare le nuove sezioni display_data config (vedi config/example-extras.cfg per i dettagli). 20200109: Il modulo bed_mesh ora fa riferimento alla posizione della sonda per la configurazione della mesh. Pertanto, alcune opzioni di configurazione sono state rinominate per riflettere in modo pi\u00f9 accurato la funzionalit\u00e0 prevista. Per i piatti rettangolari, min_point e max_point sono stati rinominati rispettivamente in mesh_min e mesh_max . Per i piatti rotondi, bed_radius \u00e8 stato rinominato in mesh_radius . \u00c8 stata aggiunta anche una nuova opzione mesh_origin per i piatti rotondi. Si noti che queste modifiche sono anche incompatibili con i profili mesh salvati in precedenza. Se viene rilevato un profilo incompatibile, verr\u00e0 ignorato e pianificato per la rimozione. Il processo di rimozione pu\u00f2 essere completato emettendo il comando SAVE_CONFIG. L'utente dovr\u00e0 ricalibrare ogni profilo. 20191218: la sezione di configurazione del display non supporta pi\u00f9 \"lcd_type: st7567\". Usa invece il tipo di visualizzazione \"uc1701\" - imposta \"lcd_type: uc1701\" e cambia \"rs_pin: some_pin\" in \"rst_pin: some_pin\". Potrebbe anche essere necessario aggiungere un'impostazione di configurazione \"contrasto: 60\". 20191210: I comandi integrati T0, T1, T2, ... sono stati rimossi. Le opzioni di configurazione activate_gcode e deactivate_gcode dell'estrusore sono state rimosse. Se questi comandi (e script) sono necessari, definire le singole macro di stile [gcode_macro T0] che chiamano il comando ACTIVATE_EXTRUDER. Vedere i file config/sample-idex.cfg e sample-multi-extruder.cfg per esempi. 20191210: il supporto per il comando M206 \u00e8 stato rimosso. Sostituisci con chiamate a SET_GCODE_OFFSET. Se \u00e8 necessario il supporto per M206, aggiungere una sezione di configurazione [gcode_macro M206] che richiami SET_GCODE_OFFSET. (Ad esempio \"SET_GCODE_OFFSET Z=-{params.Z}\".) 20191202: il supporto per il parametro \"S\" non documentato del comando \"G4\" \u00e8 stato rimosso. Sostituire eventuali occorrenze di S con il parametro \"P\" standard (il ritardo specificato in millisecondi). 20191126: i nomi USB sono cambiati sui microcontrollori con supporto USB nativo. Ora usano un ID chip univoco per impostazione predefinita (ove disponibile). Se una sezione di configurazione \"mcu\" utilizza un'impostazione \"serial\" che inizia con \"/dev/serial/by-id/\", potrebbe essere necessario aggiornare la configurazione. Esegui \"ls /dev/serial/by-id/*\" in un terminale ssh per determinare il nuovo ID. 20191121: il parametro pressure_advance_lookahead_time \u00e8 stato rimosso. Vedere example.cfg per impostazioni di configurazione alternative. 20191112: la funzionalit\u00e0 di abilitazione virtuale del driver stepper tmc \u00e8 ora abilitata automaticamente se lo stepper non dispone di un pin di abilitazione stepper dedicato. Rimuovere i riferimenti a tmcXXXX:virtual_enable dal file config. La possibilit\u00e0 di controllare pi\u00f9 pin nella configurazione stepper enable_pin \u00e8 stata rimossa. Se sono necessari pi\u00f9 pin, utilizzare una sezione di configurazione multi_pin. 20191107: La sezione di configurazione dell'estrusore primario deve essere specificata come \"extruder\" e non pu\u00f2 pi\u00f9 essere specificata come \"extruder0\". I modelli di comando Gcode che richiedono lo stato dell'estrusore sono ora accessibili tramite \"{printer.extruder}\". 20191021: Klipper v0.8.0 rilasciato 20191003: L'opzione move_to_previous in [safe_z_homing] ora \u00e8 impostata su False. (Era effettivamente Falso prima del 20190918.) 20190918: L'opzione zhop in [safe_z_homing] viene sempre riapplicata dopo il completamento dell'homing dell'asse Z. Ci\u00f2 potrebbe richiedere agli utenti di aggiornare gli script personalizzati basati su questo modulo. 20190806: Il comando SET_NEOPIXEL \u00e8 stato rinominato in SET_LED. 20190726: il codice del dac mcp4728 \u00e8 cambiato. L'indirizzo i2c predefinito \u00e8 ora 0x60 e il riferimento di tensione \u00e8 ora relativo al riferimento interno di 2,048 volt del mcp4728. 20190710: l'opzione z_hop \u00e8 stata rimossa dalla sezione di configurazione [firmware_retract]. Il supporto z_hop era incompleto e potrebbe causare un comportamento errato con diversi filtri dei dati comuni. 20190710: I parametri opzionali del comando PROBE_ACCURACY sono stati modificati. Potrebbe essere necessario aggiornare eventuali macro o script che utilizzano quel comando. 20190628: tutte le opzioni di configurazione sono state rimosse dalla sezione [skew_correction]. La configurazione per skew_correction viene ora eseguita tramite il gcode SET_SKEW. Vedere Correzione inclinazione per l'utilizzo consigliato. 20190607: I parametri \"variable_X\" di gcode_macro (insieme al parametro VALUE di SET_GCODE_VARIABLE) vengono ora analizzati come valori literals di Python. Se \u00e8 necessario assegnare un valore a una stringa, racchiudere il valore tra virgolette in modo che venga valutato come una stringa. 20190606: le opzioni di configurazione \"samples\", \"samples_result\" e \"sample_retract_dist\" sono state spostate nella sezione di configurazione \"probe\". Queste opzioni non sono pi\u00f9 supportate nelle sezioni di configurazione \"delta_calibrate\", \"bed_tilt\", \"bed_mesh\", \"screws_tilt_adjust\", \"z_tilt\" o \"quad_gantry_level\". 20190528: La variabile magica \"status\" nella valutazione del modello gcode_macro \u00e8 stata rinominata \"printer\". 20190520: Il comando SET_GCODE_OFFSET \u00e8 stato modificato; aggiorna tutte le macro del codice g di conseguenza. Il comando non applicher\u00e0 pi\u00f9 l'offset richiesto al successivo comando G1. Il vecchio comportamento pu\u00f2 essere approssimato utilizzando il nuovo parametro \"MOVE=1\". 20190404: i pacchetti software host Python sono stati aggiornati. Gli utenti dovranno eseguire nuovamente lo script ~/klipper/scripts/install-octopi.sh (o in altro modo aggiornare le dipendenze di Python se non si utilizza un'installazione OctoPi standard). 20190404: I parametri i2c_bus e spi_bus (in varie sezioni di configurazione) ora prendono un nome bus anzich\u00e9 un numero. 20190404: I parametri di configurazione sx1509 sono stati modificati. Il parametro 'address' ora \u00e8 'i2c_address' e deve essere specificato come numero decimale. Dove 0x3E \u00e8 stato utilizzato in precedenza, specificare 62. 20190328: Il valore min_speed nella configurazione [temperature_fan] verr\u00e0 ora rispettato e la ventola funzioner\u00e0 sempre a questa velocit\u00e0 o superiore in modalit\u00e0 PID. 20190322: il valore predefinito per \"driver_HEND\" nelle sezioni di configurazione [tmc2660] \u00e8 stato modificato da 6 a 3. Il campo \"driver_VSENSE\" \u00e8 stato rimosso (ora viene calcolato automaticamente da run_current). 20190310: La sezione di configurazione [controller_fan] ora prende sempre un nome (come [controller_fan my_controller_fan]). 20190308: Il campo \"driver_BLANK_TIME_SELECT\" nelle sezioni di configurazione [tmc2130] e [tmc2208] \u00e8 stato rinominato in \"driver_TBL\". 20190308: la sezione di configurazione [tmc2660] \u00e8 stata modificata. Ora deve essere fornito un nuovo parametro di configurazione sense_resistor. Il significato di molti dei parametri driver_XXX \u00e8 cambiato. 20190228: gli utenti di SPI o I2C su schede SAMD21 devono ora specificare i pin del bus tramite una sezione di configurazione [samd_sercom]. 20190224: l'opzione bed_shape \u00e8 stata rimossa da bed_mesh. L'opzione raggio \u00e8 stata rinominata bed_radius. Gli utenti con letti rotondi dovrebbero fornire le opzioni bed_radius e round_probe_count. 20190107: il parametro i2c_address nella sezione di configurazione mcp4451 \u00e8 stato modificato. Questa \u00e8 un'impostazione comune su Smoothieboards. Il nuovo valore \u00e8 la met\u00e0 del vecchio valore (88 dovrebbe essere cambiato in 44 e 90 dovrebbe essere cambiato in 45). 20181220: Klipper v0.7.0 rilasciato","title":"Modifiche alla configurazione"},{"location":"Config_Changes.html#modifiche-alla-configurazione","text":"Questo documento copre le modifiche software recenti al file di configurazione che non sono compatibili con le versioni precedenti. \u00c8 una buona idea rivedere questo documento durante l'aggiornamento del software Klipper. Tutte le date in questo documento sono approssimative.","title":"Modifiche alla configurazione"},{"location":"Config_Changes.html#cambiamenti","text":"20230201: Il modulo [bed_mesh] non carica pi\u00f9 il profilo default all'avvio. Si consiglia agli utenti che usano il profilo default di aggiungere BED_MESH_PROFILE LOAD=default alla loro macro START_PRINT (o alla configurazione \"Start G-Code\" del loro slicer quando applicabile). 20230103: Ora \u00e8 possibile con lo script flash-sdcard.sh eseguire il flashing di entrambe le varianti di Bigtreetech SKR-2, STM32F407 e STM32F429. Ci\u00f2 significa che il tag originale di btt-skr2 ora \u00e8 cambiato in btt-skr-2-f407 o btt-skr-2-f429. 20221128: rilascio di Klipper v0.11.0. 20221122: In precedenza, con safe_z_home, era possibile che z_hop dopo l'homing g28 andasse nella direzione z negativa. Ora, uno z_hop viene eseguito dopo g28 solo se risulta in un hop positivo, rispecchiando il comportamento dello z_hop che si verifica prima dell'homing g28. 20220616: in precedenza era possibile eseguire il flashing di un rp2040 in modalit\u00e0 bootloader eseguendo make flash FLASH_DEVICE=first . Il comando equivalente \u00e8 ora make flash FLASH_DEVICE=2e8a:0003 . 20220612: Il microcontrollore rp2040 ora ha una soluzione alternativa per l'errata USB \"rp2040-e5\". Ci\u00f2 dovrebbe rendere pi\u00f9 affidabili le connessioni USB iniziali. Tuttavia, potrebbe comportare un cambiamento nel comportamento del pin gpio15. \u00c8 improbabile che il cambiamento di comportamento di gpio15 sia evidente. 20220407: l'opzione di configurazione temperature_fan pid_integral_max \u00e8 stata rimossa (era deprecata su 20210612). 20220407: L'ordine dei colori predefinito per i LED pca9632 \u00e8 ora \"RGBW\". Aggiungi un'impostazione esplicita color_order: RBGW alla sezione di configurazione di pca9632 per ottenere il comportamento precedente. 20220330: Il formato delle informazioni di stato printer.neopixel.color_data per i moduli neopixel e dotstar \u00e8 cambiato. Le informazioni sono ora memorizzate come un elenco di elenchi di colori (invece di un elenco di dizionari). Per i dettagli, vedere il riferimento dello stato . 20220307: M73 non imposter\u00e0 pi\u00f9 l'avanzamento della stampa su 0 se manca P . 20220304: Non esiste pi\u00f9 un valore predefinito per il parametro extruder delle sezioni di configurazione extruder_stepper . Se lo si desidera, specificare esplicitamente extruder: extruder per associare il motore passo-passo alla coda di movimento \"estrusore\" all'avvio. 20220210: Il comando SYNC_STEPPER_TO_EXTRUDER \u00e8 deprecato; il comando SET_EXTRUDER_STEP_DISTANCE \u00e8 deprecato; l'opzione di configurazione extruder shared_heater \u00e8 deprecata. Queste funzionalit\u00e0 verranno rimosse nel prossimo futuro. Sostituisci SET_EXTRUDER_STEP_DISTANCE con SET_EXTRUDER_ROTATION_DISTANCE . Sostituisci SYNC_STEPPER_TO_EXTRUDER con SYNC_EXTRUDER_MOTION . Sostituisci le sezioni di configurazione dell'estrusore usando shared_heater con le sezioni di configurazione extruder_stepper e aggiorna le macro di attivazione per usare SYNC_EXTRUDER_MOTION . 20220116: Il codice di calcolo della run_current per tmc2130, tmc2208, tmc2209 e tmc2660 \u00e8 cambiato. Per alcune impostazioni di run_current i driver possono ora essere configurati in modo diverso. Questa nuova configurazione dovrebbe essere pi\u00f9 accurata, ma potrebbe invalidare la precedente ottimizzazione del driver tmc. 20211230: Gli script per ottimizzare l'input shaper ( scripts/calibrate_shaper.py e scripts/graph_accelerometer.py ) sono stati migrati per utilizzare Python3 per impostazione predefinita. Di conseguenza, gli utenti devono installare le versioni Python3 di determinati pacchetti (ad esempio sudo apt install python3-numpy python3-matplotlib ) per continuare a utilizzare questi script. Per maggiori dettagli, fare riferimento a Installazione del software . In alternativa, gli utenti possono forzare temporaneamente l'esecuzione di questi script in Python 2 chiamando esplicitamente l'interprete Python2 nella console: python2 ~/klipper/scripts/calibrate_shaper.py ... 20211110: Il sensore di temperatura \"NTC 100K beta 3950\" \u00e8 obsoleto. Questo sensore verr\u00e0 rimosso nel prossimo futuro. La maggior parte degli utenti trover\u00e0 il sensore di temperatura \"Generico 3950\" pi\u00f9 accurato. Per continuare a utilizzare la definizione precedente (in genere meno accurata), definire un termistore personalizzato con temperature1: 25 , resistance1: 100000 e beta: 3950 . 20211104: L'opzione \"step pulse duration\" in \"make menuconfig\" \u00e8 stata rimossa. La durata del passaggio predefinita per i driver TMC configurati in modalit\u00e0 UART o SPI \u00e8 ora di 100 ns. Una nuova impostazione step_pulse_duration nella sezione stepper config dovrebbe essere impostata per tutti gli stepper che necessitano di una durata dell'impulso personalizzata. 20211102: diverse funzionalit\u00e0 deprecate sono state rimosse. L'opzione stepper step_distance \u00e8 stata rimossa (obsoleta nel 20201222). L'alias del sensore rpi_temperature \u00e8 stato rimosso (obsoleto il 20210219). L'opzione mcu pin_map \u00e8 stata rimossa (deprecata su 20210325). La gcode_macro default_parameter_<name> e l'accesso macro ai parametri dei comandi diversi dalla pseudo-variabile params sono stati rimossi (deprecato in 20210503). L'opzione del riscaldatore pid_integral_max \u00e8 stata rimossa (obsoleta il 20210612). 20210929: Klipper v0.10.0 rilasciato. 20210903: Il valore predefinito smooth_time per i riscaldatori \u00e8 cambiato in 1 secondo (da 2 secondi). Per la maggior parte delle stampanti ci\u00f2 si tradurr\u00e0 in un controllo della temperatura pi\u00f9 stabile. 20210830: il nome adxl345 predefinito \u00e8 ora \"adxl345\". Il parametro CHIP predefinito per ACCELEROMETER_MEASURE e ACCELEROMETER_QUERY ora \u00e8 \"adxl345\". 20210830: il comando adxl345 ACCELEROMETER_MEASURE non supporta pi\u00f9 un parametro RATE. Per modificare la frequenza delle query, aggiornare il file printer.cfg ed eseguire un comando RESTART. 20210821: Diverse impostazioni di configurazione in printer.configfile.settings verranno ora riportate come elenchi anzich\u00e9 come stringhe grezze. Se si desidera la stringa grezza effettiva, utilizzare invece printer.configfile.config . 20210819: In alcuni casi, un movimento di riferimento G28 pu\u00f2 terminare in una posizione che \u00e8 nominalmente al di fuori dell'intervallo di movimento valido. In rare situazioni ci\u00f2 pu\u00f2 causare errori di \"spostamento fuori portata\" confusi dopo l'homing. In tal caso, modificare gli script di avvio per spostare la testa utensile in una posizione valida subito dopo l'homing. 20210814: Gli pseudo-pin solo analogici su atmega168 e atmega328 sono stati rinominati da PE0/PE1 a PE2/PE3. 20210720: una sezione controller_fan ora monitora tutti i motori passo-passo per impostazione predefinita (non solo i motori passo-passo cinematici). Se si desidera il comportamento precedente, vedere l'opzione di configurazione stepper nel riferimento di configurazione . 20210703: Una sezione di configurazione samd_sercom deve ora specificare il bus sercom che sta configurando tramite l'opzione sercom . 20210612: L'opzione di configurazione pid_integral_max nelle sezioni riscaldatore e temperature_fan \u00e8 obsoleta. L'opzione verr\u00e0 rimossa nel prossimo futuro. 20210503: The gcode_macro default_parameter_<name> config option is deprecated. Use the params pseudo-variable to access macro parameters. Other methods for accessing macro parameters will be removed in the near future. Most users can replace a default_parameter_NAME: VALUE config option with a line like the following in the start of the macro: {% set NAME = params.NAME|default(VALUE)|float %} . See the Command Templates document for examples. 20210430: il comando SET_VELOCITY_LIMIT (e M204) ora pu\u00f2 impostare una velocit\u00e0, un'accelerazione e una square_corner_velocity maggiori dei valori specificati nel file di configurazione. 20210325: il supporto per l'opzione di configurazione pin_map \u00e8 deprecato. Utilizzare il file sample-aliases.cfg per tradurre i nomi dei pin del microcontroller effettivi. L'opzione di configurazione pin_map verr\u00e0 rimossa nel prossimo futuro. 20210313: Il supporto di Klipper per i microcontrollori che comunicano con il bus CAN \u00e8 cambiato. Se si utilizza il bus CAN, \u00e8 necessario eseguire nuovamente il flashing di tutti i microcontrollori e la configurazione di Klipper deve essere aggiornata . 20210310: Il valore predefinito TMC2660 per driver_SFILT \u00e8 stato modificato da 1 a 0. 20210227: I driver del motore passo-passo TMC in modalit\u00e0 UART o SPI ora vengono interrogati una volta al secondo ogni volta che sono abilitati - se il driver non pu\u00f2 essere contattato o se il driver segnala un errore, Klipper passer\u00e0 allo stato di spegnimento. 20210219: Il modulo rpi_temperature \u00e8 stato rinominato in temperature_host . Sostituisci tutte le occorrenze di sensor_type: rpi_temperature con sensor_type: temperature_host . Il percorso del file di temperatura pu\u00f2 essere specificato nella variabile di configurazione sensor_path . Il nome rpi_temperature \u00e8 deprecato e verr\u00e0 rimosso nel prossimo futuro. 20210201: Il comando TEST_RESONANCES ora disabiliter\u00e0 l'input shaping se era stato precedentemente abilitato (e lo riattiver\u00e0 dopo il test). Per ignorare questo comportamento e mantenere abilitato lo shaping dell'input, \u00e8 possibile passare un parametro aggiuntivo INPUT_SHAPING=1 al comando. 20210201: Il comando ACCELEROMETER_MEASURE aggiunger\u00e0 ora il nome del chip dell'accelerometro al nome del file di output se al chip \u00e8 stato assegnato un nome nella corrispondente sezione adxl345 di printer.cfg. 20201222: L'impostazione step_distance nelle sezioni di configurazione dello stepper \u00e8 obsoleta. Si consiglia di aggiornare la configurazione per utilizzare l'impostazione rotation_distance . Il supporto per step_distance verr\u00e0 rimosso nel prossimo futuro. 20201218: L'impostazione endstop_phase nel modulo endstop_phase \u00e8 stata sostituita con trigger_phase . Se si utilizza il modulo fasi endstop, sar\u00e0 necessario convertire in rotation_distance e ricalibrare eventuali fasi endstop eseguendo il comando ENDSTOP_PHASE_CALIBRATE. 20201218: le stampanti rotanti delta e polari ora devono specificare un gear_ratio per i loro stepper rotanti e potrebbero non specificare pi\u00f9 un parametro step_distance . Vedere il riferimento di configurazione per il formato del nuovo parametro gear_ratio. 20201213: Non \u00e8 valido specificare una Z \"position_endstop\" quando si utilizza \"probe:z_virtual_endstop\". Verr\u00e0 ora generato un errore se viene specificata una Z \"position_endstop\" con \"probe:z_virtual_endstop\". Rimuovere la definizione Z \"position_endstop\" per correggere l'errore. 20201120: La sezione di configurazione [board_pins] ora specifica il nome mcu in un parametro esplicito mcu: . Se si utilizza board_pins per un mcu secondario, \u00e8 necessario aggiornare la configurazione per specificare quel nome. Vedere il riferimento di configurazione per ulteriori dettagli. 20201112: Il tempo riportato da print_stats.print_duration \u00e8 cambiato. La durata precedente alla prima estrusione rilevata \u00e8 ora esclusa. 20201029: L'opzione di configurazione color_order_GRB di neopixel \u00e8 stata rimossa. Se necessario, aggiorna la configurazione per impostare la nuova opzione color_order su RGB, GRB, RGBW o GRBW. 20201029: L'opzione seriale nella sezione di configurazione di mcu non \u00e8 pi\u00f9 impostata su /dev/ttyS0. Nella rara situazione in cui /dev/ttyS0 \u00e8 la porta seriale desiderata, deve essere specificata esplicitamente. 20201020: Klipper v0.9.0 rilasciato. 20200902: Il calcolo della resistenza-to-temperatura dell'RTD per i convertitori MAX31865 \u00e8 stato corretto in modo che non fosse basso. Se si utilizza un dispositivo di questo tipo, \u00e8 necessario ricalibrare la temperatura di stampa e le impostazioni PID. 20200816: L'oggetto printer.gcode della macro gcode \u00e8 stato rinominato in printer.gcode_move . Diverse variabili non documentate in printer.toolhead e printer.gcode sono state rimosse. Vedere docs/Command_Templates.md per un elenco delle variabili di modello disponibili. 20200816: Il sistema \"action_\" della macro gcode \u00e8 cambiato. Sostituisci tutte le chiamate a printer.gcode.action_emergency_stop() con action_emergency_stop() , printer.gcode.action_respond_info() con action_respond_info() e printer.gcode.action_respond_error() con action_raise_error( ) . 20200809: Il sistema di menu \u00e8 stato riscritto. Se il menu \u00e8 stato personalizzato sar\u00e0 necessario aggiornare alla nuova configurazione. Vedere config/example-menu.cfg per i dettagli di configurazione e vedere klippy/extras/display/menu.cfg per esempi. 20200731: Il comportamento dell'attributo progress riportato dall'oggetto stampante virtual_sdcard \u00e8 cambiato. L'avanzamento non viene pi\u00f9 reimpostato su 0 quando una stampa viene sospesa. Ora riporter\u00e0 sempre lo stato di avanzamento in base alla posizione interna del file o 0 se nessun file \u00e8 attualmente caricato. 20200725: Il parametro di configurazione servo enable e il parametro SET_SERVO ENABLE sono stati rimossi. Aggiorna qualsiasi macro per usare SET_SERVO SERVO=my_servo WIDTH=0 per disabilitare un servo. 20200608: Il supporto del display LCD ha cambiato il nome di alcuni \"glifi\" interni. Se \u00e8 stato implementato un layout di visualizzazione personalizzato, potrebbe essere necessario aggiornare ai nomi dei glifi pi\u00f9 recenti (consultare klippy/extras/display/display.cfg per un elenco dei glifi disponibili). 20200606: i nomi dei pin su Linux Mcu sono cambiati. I pin ora hanno nomi nella forma gpiochip<chipid>/gpio<gpio> . Per gpiochip0 puoi anche usare un breve gpio<gpio> . Ad esempio, ci\u00f2 che prima veniva chiamato P20 ora diventa gpio20 o gpiochip0/gpio20 . 20200603: il layout LCD 16x4 predefinito non mostrer\u00e0 pi\u00f9 il tempo rimanente stimato in una stampa. (Verr\u00e0 mostrato solo il tempo trascorso.) Se si desidera il vecchio comportamento, \u00e8 possibile personalizzare la visualizzazione del menu con tali informazioni (vedere la descrizione di display_data in config/example-extras.cfg per i dettagli). 20200531: l'ID prodotto/fornitore USB predefinito \u00e8 ora 0x1d50/0x614e. Questi nuovi ID sono riservati a Klipper (grazie al progetto openmoko). Questa modifica non dovrebbe richiedere alcuna modifica alla configurazione, ma i nuovi ID potrebbero essere visualizzati nei registri di sistema. 20200524: Il valore predefinito per il campo tmc5160 pwm_freq \u00e8 ora zero (anzich\u00e9 uno). 20200425: La variabile del modello di comando gcode_macro printer.heater \u00e8 stata rinominata printer.heaters . 20200313: Il layout lcd predefinito per le stampanti multiestrusore con schermo 16x4 \u00e8 cambiato. Il layout dello schermo del singolo estrusore \u00e8 ora quello predefinito e mostrer\u00e0 l'estrusore attualmente attivo. Per utilizzare il layout di visualizzazione precedente, impostare \"display_group: _multiextruder_16x4\" nella sezione [display] del file printer.cfg. 20200308: La voce di menu predefinita __test \u00e8 stata rimossa. Se il file di configurazione ha un menu personalizzato, assicurati di rimuovere tutti i riferimenti a questa voce di menu __test . 20200308: le opzioni del menu \"deck\" e \"card\" sono state rimosse. Per personalizzare il layout di uno schermo lcd utilizzare le nuove sezioni display_data config (vedi config/example-extras.cfg per i dettagli). 20200109: Il modulo bed_mesh ora fa riferimento alla posizione della sonda per la configurazione della mesh. Pertanto, alcune opzioni di configurazione sono state rinominate per riflettere in modo pi\u00f9 accurato la funzionalit\u00e0 prevista. Per i piatti rettangolari, min_point e max_point sono stati rinominati rispettivamente in mesh_min e mesh_max . Per i piatti rotondi, bed_radius \u00e8 stato rinominato in mesh_radius . \u00c8 stata aggiunta anche una nuova opzione mesh_origin per i piatti rotondi. Si noti che queste modifiche sono anche incompatibili con i profili mesh salvati in precedenza. Se viene rilevato un profilo incompatibile, verr\u00e0 ignorato e pianificato per la rimozione. Il processo di rimozione pu\u00f2 essere completato emettendo il comando SAVE_CONFIG. L'utente dovr\u00e0 ricalibrare ogni profilo. 20191218: la sezione di configurazione del display non supporta pi\u00f9 \"lcd_type: st7567\". Usa invece il tipo di visualizzazione \"uc1701\" - imposta \"lcd_type: uc1701\" e cambia \"rs_pin: some_pin\" in \"rst_pin: some_pin\". Potrebbe anche essere necessario aggiungere un'impostazione di configurazione \"contrasto: 60\". 20191210: I comandi integrati T0, T1, T2, ... sono stati rimossi. Le opzioni di configurazione activate_gcode e deactivate_gcode dell'estrusore sono state rimosse. Se questi comandi (e script) sono necessari, definire le singole macro di stile [gcode_macro T0] che chiamano il comando ACTIVATE_EXTRUDER. Vedere i file config/sample-idex.cfg e sample-multi-extruder.cfg per esempi. 20191210: il supporto per il comando M206 \u00e8 stato rimosso. Sostituisci con chiamate a SET_GCODE_OFFSET. Se \u00e8 necessario il supporto per M206, aggiungere una sezione di configurazione [gcode_macro M206] che richiami SET_GCODE_OFFSET. (Ad esempio \"SET_GCODE_OFFSET Z=-{params.Z}\".) 20191202: il supporto per il parametro \"S\" non documentato del comando \"G4\" \u00e8 stato rimosso. Sostituire eventuali occorrenze di S con il parametro \"P\" standard (il ritardo specificato in millisecondi). 20191126: i nomi USB sono cambiati sui microcontrollori con supporto USB nativo. Ora usano un ID chip univoco per impostazione predefinita (ove disponibile). Se una sezione di configurazione \"mcu\" utilizza un'impostazione \"serial\" che inizia con \"/dev/serial/by-id/\", potrebbe essere necessario aggiornare la configurazione. Esegui \"ls /dev/serial/by-id/*\" in un terminale ssh per determinare il nuovo ID. 20191121: il parametro pressure_advance_lookahead_time \u00e8 stato rimosso. Vedere example.cfg per impostazioni di configurazione alternative. 20191112: la funzionalit\u00e0 di abilitazione virtuale del driver stepper tmc \u00e8 ora abilitata automaticamente se lo stepper non dispone di un pin di abilitazione stepper dedicato. Rimuovere i riferimenti a tmcXXXX:virtual_enable dal file config. La possibilit\u00e0 di controllare pi\u00f9 pin nella configurazione stepper enable_pin \u00e8 stata rimossa. Se sono necessari pi\u00f9 pin, utilizzare una sezione di configurazione multi_pin. 20191107: La sezione di configurazione dell'estrusore primario deve essere specificata come \"extruder\" e non pu\u00f2 pi\u00f9 essere specificata come \"extruder0\". I modelli di comando Gcode che richiedono lo stato dell'estrusore sono ora accessibili tramite \"{printer.extruder}\". 20191021: Klipper v0.8.0 rilasciato 20191003: L'opzione move_to_previous in [safe_z_homing] ora \u00e8 impostata su False. (Era effettivamente Falso prima del 20190918.) 20190918: L'opzione zhop in [safe_z_homing] viene sempre riapplicata dopo il completamento dell'homing dell'asse Z. Ci\u00f2 potrebbe richiedere agli utenti di aggiornare gli script personalizzati basati su questo modulo. 20190806: Il comando SET_NEOPIXEL \u00e8 stato rinominato in SET_LED. 20190726: il codice del dac mcp4728 \u00e8 cambiato. L'indirizzo i2c predefinito \u00e8 ora 0x60 e il riferimento di tensione \u00e8 ora relativo al riferimento interno di 2,048 volt del mcp4728. 20190710: l'opzione z_hop \u00e8 stata rimossa dalla sezione di configurazione [firmware_retract]. Il supporto z_hop era incompleto e potrebbe causare un comportamento errato con diversi filtri dei dati comuni. 20190710: I parametri opzionali del comando PROBE_ACCURACY sono stati modificati. Potrebbe essere necessario aggiornare eventuali macro o script che utilizzano quel comando. 20190628: tutte le opzioni di configurazione sono state rimosse dalla sezione [skew_correction]. La configurazione per skew_correction viene ora eseguita tramite il gcode SET_SKEW. Vedere Correzione inclinazione per l'utilizzo consigliato. 20190607: I parametri \"variable_X\" di gcode_macro (insieme al parametro VALUE di SET_GCODE_VARIABLE) vengono ora analizzati come valori literals di Python. Se \u00e8 necessario assegnare un valore a una stringa, racchiudere il valore tra virgolette in modo che venga valutato come una stringa. 20190606: le opzioni di configurazione \"samples\", \"samples_result\" e \"sample_retract_dist\" sono state spostate nella sezione di configurazione \"probe\". Queste opzioni non sono pi\u00f9 supportate nelle sezioni di configurazione \"delta_calibrate\", \"bed_tilt\", \"bed_mesh\", \"screws_tilt_adjust\", \"z_tilt\" o \"quad_gantry_level\". 20190528: La variabile magica \"status\" nella valutazione del modello gcode_macro \u00e8 stata rinominata \"printer\". 20190520: Il comando SET_GCODE_OFFSET \u00e8 stato modificato; aggiorna tutte le macro del codice g di conseguenza. Il comando non applicher\u00e0 pi\u00f9 l'offset richiesto al successivo comando G1. Il vecchio comportamento pu\u00f2 essere approssimato utilizzando il nuovo parametro \"MOVE=1\". 20190404: i pacchetti software host Python sono stati aggiornati. Gli utenti dovranno eseguire nuovamente lo script ~/klipper/scripts/install-octopi.sh (o in altro modo aggiornare le dipendenze di Python se non si utilizza un'installazione OctoPi standard). 20190404: I parametri i2c_bus e spi_bus (in varie sezioni di configurazione) ora prendono un nome bus anzich\u00e9 un numero. 20190404: I parametri di configurazione sx1509 sono stati modificati. Il parametro 'address' ora \u00e8 'i2c_address' e deve essere specificato come numero decimale. Dove 0x3E \u00e8 stato utilizzato in precedenza, specificare 62. 20190328: Il valore min_speed nella configurazione [temperature_fan] verr\u00e0 ora rispettato e la ventola funzioner\u00e0 sempre a questa velocit\u00e0 o superiore in modalit\u00e0 PID. 20190322: il valore predefinito per \"driver_HEND\" nelle sezioni di configurazione [tmc2660] \u00e8 stato modificato da 6 a 3. Il campo \"driver_VSENSE\" \u00e8 stato rimosso (ora viene calcolato automaticamente da run_current). 20190310: La sezione di configurazione [controller_fan] ora prende sempre un nome (come [controller_fan my_controller_fan]). 20190308: Il campo \"driver_BLANK_TIME_SELECT\" nelle sezioni di configurazione [tmc2130] e [tmc2208] \u00e8 stato rinominato in \"driver_TBL\". 20190308: la sezione di configurazione [tmc2660] \u00e8 stata modificata. Ora deve essere fornito un nuovo parametro di configurazione sense_resistor. Il significato di molti dei parametri driver_XXX \u00e8 cambiato. 20190228: gli utenti di SPI o I2C su schede SAMD21 devono ora specificare i pin del bus tramite una sezione di configurazione [samd_sercom]. 20190224: l'opzione bed_shape \u00e8 stata rimossa da bed_mesh. L'opzione raggio \u00e8 stata rinominata bed_radius. Gli utenti con letti rotondi dovrebbero fornire le opzioni bed_radius e round_probe_count. 20190107: il parametro i2c_address nella sezione di configurazione mcp4451 \u00e8 stato modificato. Questa \u00e8 un'impostazione comune su Smoothieboards. Il nuovo valore \u00e8 la met\u00e0 del vecchio valore (88 dovrebbe essere cambiato in 44 e 90 dovrebbe essere cambiato in 45). 20181220: Klipper v0.7.0 rilasciato","title":"Cambiamenti"},{"location":"Config_Reference.html","text":"Riferimenti configurazione \u00b6 Questo documento \u00e8 un riferimento per le opzioni disponibili nel file di configurazione di Klipper. Le descrizioni in questo documento sono formattate in modo che sia possibile tagliarle e incollarle in un file di configurazione della stampante. Consulta il documento di installazione per informazioni sulla configurazione di Klipper e sulla scelta di un file di configurazione iniziale. Configurazione del microcontrollore \u00b6 Formato dei nomi dei pin del microcontrollore \u00b6 Molte opzioni di configurazione richiedono il nome di un pin del microcontrollore. Klipper usa i nomi hardware per questi pin, ad esempio \"PA4\". I nomi dei pin possono essere preceduti da ! per indicare che deve essere utilizzata una polarit\u00e0 inversa (ad esempio, trigger su basso anzich\u00e9 alto). I pin di input possono essere preceduti da ^ per indicare che un resistore di pull-up hardware deve essere abilitato per il pin. Se il microcontrollore supporta resistori pull-down, un pin di ingresso pu\u00f2 in alternativa essere preceduto da ~ . Nota, alcune sezioni di configurazione potrebbero \"creare\" pin aggiuntivi. Quando ci\u00f2 si verifica, la sezione di configurazione che definisce i pin deve essere elencata nel file di configurazione prima di qualsiasi sezione che utilizza tali pin. [mcu] \u00b6 Configurazione del microcontrollore primario. [mcu] serial: # La porta seriale per la connessione all'MCU. In caso di dubbi (o se # cambia) vedere \"Dov'\u00e8 la mia porta seriale?\" sezione delle FAQ. # Questo parametro deve essere fornito quando si utilizza una # porta seriale. #baud: 250000 # La velocit\u00e0 di trasmissione da utilizzare. Il valore predefinito \u00e8 250000. #canbus_uuid: # Se si utilizza un dispositivo collegato a un bus CAN, questo imposta # l'identificatore univoco del chip a cui connettersi. Questo valore deve # essere fornito quando si utilizza il bus CAN per la comunicazione. #canbus_interface: # Se si utilizza un dispositivo collegato a un bus CAN, viene impostata # l'interfaccia di rete CAN da utilizzare. L'impostazione predefinita \u00e8 'can0'. #restart_method: # Questo controlla il meccanismo che l'host utilizzer\u00e0 per reimpostare # il microcontrollore. Le scelte sono \"arduino\", \"cheetah\", \"rpi_usb\" e # \"command\". Il metodo 'arduino' (attiva/disattiva DTR) \u00e8 comune su # schede Arduino e cloni. Il metodo 'cheetah' \u00e8 un metodo speciale # necessario per alcune schede Fysetc Cheetah. Il metodo \"rpi_usb\" # \u00e8 utile sulle schede Raspberry Pi con microcontrollori alimentati # tramite USB: disabilita brevemente l'alimentazione a tutte le porte # USB per eseguire un ripristino del microcontrollore. Il metodo # \"comando\" prevede l'invio di un comando Klipper al microcontrollore # in modo che possa reimpostarsi. L'impostazione predefinita \u00e8 # 'arduino' se il microcontrollore comunica su una porta seriale, # altrimenti 'comando'. [mcu my_extra_mcu] \u00b6 Microcontrollori aggiuntivi (si pu\u00f2 definire un numero qualsiasi di sezioni con un prefisso \"mcu\"). Microcontrollori aggiuntivi introducono pin aggiuntivi che possono essere configurati come riscaldatori, stepper, ventole, ecc. Ad esempio, se viene introdotta una sezione \"[mcu extra_mcu]\", i pin come \"extra_mcu:ar9\" possono quindi essere utilizzati altrove nella configurazione (dove \"ar9\" \u00e8 un nome pin hardware o un nome alias sul dato mcu). [mcu my_extra_mcu] # Vedere la sezione \"mcu\" per i parametri di configurazione. Impostazioni cinematiche comuni \u00b6 [printer] \u00b6 La sezione printer controlla le impostazioni di alto livello della stampante. [printer] kinematics: # Il tipo di stampante in uso. Questa opzione pu\u00f2 essere una delle # seguenti: cartesian, corexy, corexz, hybrid_corexy, hybrid_corexz, # rotary_delta, delta, deltesian, polar, winch o nessuno. # Questo parametro deve essere specificato. max_velocity: # Velocit\u00e0 massima (in mm/s) della testa di stampa (relativa alla stampa). # Questo parametro deve essere specificato. max_accel: # Accelerazione massima (in mm/s^2) della testina (relativa alla stampa). # Questo parametro deve essere specificato. #max_accel_to_decel: # Una pseudo accelerazione (in mm/s^2) che controlla la velocit\u00e0 con cui # la testa di stampa pu\u00f2 passare dall'accelerazione alla decelerazione. Viene # utilizzato per ridurre la velocit\u00e0 massima di brevi movimenti a zig-zag # (e quindi ridurre le vibrazioni della stampante dovute a questi movimenti). # Il valore predefinito \u00e8 met\u00e0 di max_accel. #square_corner_velocity: 5.0 # La velocit\u00e0 massima (in mm/s) alla quale la testa di stampa pu\u00f2 viaggiare # su un angolo di 90 gradi. Un valore diverso da zero pu\u00f2 ridurre le variazioni # delle portate dell'estrusore consentendo variazioni istantanee della velocit\u00e0 # della testa utensile durante le curve. Questo valore configura l'algoritmo # interno di cornering della velocit\u00e0 centripeta; gli angoli con angoli maggiori # di 90 gradi avranno una velocit\u00e0 in curva maggiore mentre gli angoli con # angoli inferiori a 90 gradi avranno una velocit\u00e0 in curva inferiore. Se questo # \u00e8 impostato su zero, la testa utensile decelerer\u00e0 fino a zero ad ogni angolo. # Il valore predefinito \u00e8 5 mm/s. [stepper] \u00b6 Definizioni di motori passo-passo. Diversi tipi di stampante (come specificato dall'opzione \"cinematica\" nella sezione di configurazione [stampante]) richiedono nomi diversi per lo stepper (ad esempio, stepper_x vs stepper_a ). Di seguito sono riportate le definizioni comuni di stepper. Vedere il documento distanza di rotazione per informazioni sul calcolo del parametro rotation_distance . Consultare il documento Multi-MCU homing per informazioni sull'homing utilizzando pi\u00f9 microcontrollori. [stepper_x] step_pin: # Pin GPIO Step (attivato in alto) . Questo parametro deve essere fornito. dir_pin: # Pin GPIO di direzione (alto indica una direzione positiva). # Questo parametro deve essere fornito. enable_pin: # Pin GPIO di abilitazione (l'impostazione predefinita \u00e8 abilita alto; usa ! # per indicare abilita basso). Se questo parametro non viene fornito, il # driver del motore passo-passo deve essere sempre abilitato. rotation_distance: # Distanza (in mm) che l'asse percorre con una rotazione completa del # motore passo-passo (o viene specificata la marcia finale del rapporto di # trasmissione). Questo parametro deve essere fornito. microsteps: # Il numero di micropassi utilizzati dal driver del motore passo-passo. # Questo parametro deve essere fornito. #full_steps_per_rotation: 200 # Il numero di passi completi per una rotazione del motore passo-passo. # Impostarlo su 200 per un motore passo-passo da 1.8 gradi o su 400 per # un motore da 0.9 gradi. Il valore predefinito \u00e8 200. #gear_ratio: # Il rapporto di trasmissione se il motore passo-passo \u00e8 collegato all'asse # tramite un riduttore. Ad esempio, si pu\u00f2 specificare \"5:1\" se \u00e8 in uso un # riduttore 5 a 1. Se l'asse ha pi\u00f9 riduttori, \u00e8 possibile specificare un elenco # di rapporti di trasmissione separati da virgole (ad esempio, \"57:11, 2:1\"). # Se viene specificato gear_ratio, rotation_distance specifica la distanza # percorsa dall'asse per una rotazione completa dell'ingranaggio finale. # L'impostazione predefinita \u00e8 di non utilizzare un rapporto di trasmissione. #step_pulse_duration: # Il tempo minimo tra il fronte del segnale dell'impulso del passo e il # successivo fronte del segnale \"non passo\". Viene utilizzato anche per # impostare il tempo minimo tra un impulso di passo e un segnale di cambio # di direzione. L'impostazione predefinita \u00e8 0.000000100 (100ns) per gli # stepper TMC configurati in modalit\u00e0 UART o SPI e l'impostazione # predefinita \u00e8 0.000002 (che \u00e8 2us) per tutti gli altri stepper. endstop_pin: # Pin di rilevamento interruttore di fine corsa. Se questo pin di fine corsa # si trova su un mcu diverso dal motore passo-passo, abilita il # \"homing multi-mcu\". Questo parametro deve essere fornito per gli # stepper X, Y e Z su stampanti in stile cartesiano. #position_min: 0 # Distanza minima valida (in mm) alla quale l'utente pu\u00f2 comandare # il movimento dello stepper. Il valore predefinito \u00e8 0 mm. position_endstop: # Posizione del finecorsa (in mm). Questo parametro deve essere fornito # per gli stepper X, Y e Z su stampanti in stile cartesiano. position_max: # Distanza massima valida (in mm) alla quale l'utente pu\u00f2 comandare lo # spostamento dello stepper. Questo parametro deve essere fornito per # gli stepper X, Y e Z su stampanti in stile cartesiano. #homing_speed: 5.0 # Velocit\u00e0 massima (in mm/s) dello stepper durante l'homing. # Il valore predefinito \u00e8 5 mm/s. #homing_retract_dist: 5.0 # Distanza dall'arretramento (in mm) prima della corsa di riferimento # una seconda volta durante la corsa di riferimento. Impostalo a zero per # disabilitare la seconda casa. Il valore predefinito \u00e8 5 mm. #homing_retract_speed: # Velocit\u00e0 da utilizzare nella corsa di ritorno dopo l'homing nel caso in # cui questa dovesse essere diversa dalla velocit\u00e0 di homing, che \u00e8 # l'impostazione predefinita per questo parametro #second_homing_speed: # Velocit\u00e0 (in mm/s) dello stepper durante l'esecuzione del secondo # homing. L'impostazione predefinita \u00e8 homing_speed/2. #homing_positive_dir: # Se true, l'homing far\u00e0 muovere lo stepper in una direzione positiva # (allontanandosi da zero); se falso, home verso zero. \u00c8 meglio utilizzare # l'impostazione predefinita piuttosto che specificare questo parametro. # Il valore predefinito \u00e8 true se position_endstop \u00e8 vicino a position_max # false se vicino a position_min. Cinematica cartesiana \u00b6 Vedere example-cartesian.cfg per un file di configurazione della cinematica cartesiana di esempio. Qui sono descritti solo i parametri specifici delle stampanti cartesiane - vedere impostazioni cinematiche comuni per i parametri disponibili. [printer] kinematics: cartesian max_z_velocity: # Imposta la velocit\u00e0 massima (in mm/s) di movimento lungo # l'asse z. Questa impostazione pu\u00f2 essere utilizzata per limitare # la velocit\u00e0 massima del motore passo-passo z. L'impostazione # predefinita \u00e8 utilizzare max_velocity per max_z_velocity. max_z_accel: # Imposta l'accelerazione massima (in mm/s^2) del movimento # lungo l'asse z. Limita l'accelerazione del motore passo-passo z. # L'impostazione predefinita \u00e8 utilizzare max_accel per max_z_accel. # La sezione stepper_x viene utilizzata per descrivere lo stepper # che controlla l'asse X in un robot cartesiano. [stepper_x] # La sezione stepper_y viene utilizzata per descrivere lo stepper # che controlla l'asse Y in un robot cartesiano. [stepper_y] # La sezione stepper_z viene utilizzata per descrivere lo stepper # che controlla l'asse Z in un robot cartesiano. [stepper_z] Cinematica Delta lineare \u00b6 Vedere example-delta.cfg per un file di configurazione della cinematica delta lineare di esempio. Consultare la guida alla calibrazione delta per informazioni sulla calibrazione. Qui vengono descritti solo i parametri specifici per le stampanti delta lineari - vedere impostazioni cinematiche comuni per i parametri disponibili. [printer] kinematics: delta max_z_velocity: # Per le stampanti delta questo limita la velocit\u00e0 massima (in mm/s) dei # movimenti con movimento dell'asse z. Questa impostazione pu\u00f2 essere # utilizzata per ridurre la velocit\u00e0 massima dei movimenti su/gi\u00f9 (che # richiedono una velocit\u00e0 di incremento maggiore rispetto ad altri # movimenti su una stampante delta). L'impostazione predefinita \u00e8 # utilizzare max_velocity per max_z_velocity. #max_z_accel: # Imposta l'accelerazione massima (in mm/s^2) del movimento lungo # l'asse z. L'impostazione pu\u00f2 essere utile se la stampante pu\u00f2 # raggiungere un'accelerazione maggiore sui movimenti XY rispetto ai # movimenti Z (ad esempio, quando si utilizza l'input shaper). # L'impostazione predefinita \u00e8 utilizzare max_accel per max_z_accel. #minimum_z_position: 0 # La posizione Z minima in cui l'utente pu\u00f2 comandare alla testa di # spostarsi. Il valore predefinito \u00e8 0. delta_radius: # Raggio (in mm) del cerchio orizzontale formato dalle tre torri ad # asse lineare. Questo parametro pu\u00f2 anche essere calcolato come: # delta_radius = smooth_rod_offset - effector_offset - carriage_offset # Questo parametro deve essere fornito. #print_radius: # Il raggio (in mm) delle coordinate XY della testa di stampa valide. # \u00c8 possibile utilizzare questa impostazione per personalizzare il # controllo dell'intervallo dei movimenti della testa. Se qui # viene specificato un valore elevato, potrebbe essere possibile # comandare la collisione della testa di stampa con una torre. # L'impostazione predefinita \u00e8 usare delta_radius per print_radius # (che normalmente impedirebbe una collisione con torri). # La sezione stepper_a descrive lo stepper che controlla la torre # anteriore sinistra (a 210 gradi). Questa sezione controlla anche i # parametri di homing (velocit\u00e0 di homing, homing retract_dist) # per tutte le torri. [stepper_a] position_endstop: # Distanza (in mm) tra l'ugello e il piatto quando l'ugello si trova al # centro dell'area di costruzione e si attiva il finecorsa. Questo # parametro deve essere fornito per stepper_a; per stepper_b e # stepper_c questo parametro \u00e8 predefinito sul valore specificato # per stepper_a. arm_length: # Lunghezza (in mm) dell'asta diagonale che collega questa torre # alla testa di stampa. Questo parametro deve essere fornito per # stepper_a; per stepper_b e stepper_c questo parametro \u00e8 predefinito sul valore specificato per stepper_a. #angle: # Questa opzione specifica l'angolo (in gradi) a cui si trova la torre. # Il valore predefinito \u00e8 210 per stepper_a, 330 per stepper_b e 90 # per stepper_c. # La sezione stepper_b descrive lo stepper che controlla la torre # anteriore destra (a 330 gradi). [stepper_b] # La sezione stepper_c descrive lo stepper che controlla la torre # posteriore (a 90 gradi). [stepper_c] # La sezione delta_calibrate abilita un comando G-code esteso # DELTA_CALIBRATE in grado di calibrare le posizioni e gli angoli # dei finecorsa della torre. [delta_calibrate] radius: # Raggio (in mm) dell'area che pu\u00f2 essere sondata. Questo \u00e8 # il raggio delle coordinate dell'ugello da sondare; se si utilizza # una sonda automatica con un offset XY, scegliere un raggio # sufficientemente piccolo in modo che la sonda si adatti sempre # al piatto. Questo parametro deve essere fornito. #speed: 50 # La velocit\u00e0 (in mm/s) degli spostamenti senza probing durante # la calibrazione. Il valore predefinito \u00e8 50. #horizontal_move_z: 5 # L'altezza (in mm) a cui la testa deve essere comandata di # spostarsi appena prima di avviare un'operazione di sonda. # L'impostazione predefinita \u00e8 5. Cinematica Deltesiana \u00b6 Vedere example-deltesian.cfg per un esempio di file di configurazione della cinematica deltesiana. Qui sono descritti solo i parametri specifici per le stampanti deltesiane - vedere impostazioni cinematiche comuni per i parametri disponibili. [printer] kinematics: deltesian max_z_velocity: # Per le stampanti deltesiane, ci\u00f2 limita la velocit\u00e0 massima (in mm/s) # dei movimenti con movimento dell'asse z. Questa impostazione pu\u00f2 # essere utilizzata per ridurre la velocit\u00e0 massima dei movimenti su/gi\u00f9 # (che richiedono una velocit\u00e0 di incremento maggiore rispetto ad altri # movimenti su una stampante deltesiana). L'impostazione predefinita # \u00e8 utilizzare max_velocity per max_z_velocity. #max_z_accel: # Imposta l'accelerazione massima (in mm/s^2) del movimento lungo # l'asse z. L'impostazione pu\u00f2 essere utile se la stampante pu\u00f2 raggiungere # un'accelerazione maggiore sui movimenti XY rispetto ai movimenti Z # (ad esempio, quando si utilizza l'input shaper). L'impostazione # predefinita \u00e8 utilizzare max_accel per max_z_accel. #minimum_z_position: 0 # La posizione Z minima in cui l'utente pu\u00f2 comandare alla testa di # spostarsi. Il valore predefinito \u00e8 0. #min_angle: 5 # Questo rappresenta l'angolo minimo (in gradi) rispetto all'orizzontale # che le braccia deltesiane possono raggiungere. Questo parametro ha lo # scopo di impedire che i bracci diventino completamente orizzontali, il # che rischierebbe l'inversione accidentale dell'asse XZ. # L'impostazione predefinita \u00e8 5. #print_width: # La distanza (in mm) delle coordinate X della testa utensile valide. # \u00c8 possibile utilizzare questa impostazione per personalizzare il # controllo dell'intervallo dei movimenti della testa utensile. Se # qui viene specificato un valore elevato, potrebbe essere possibile # comandare la collisione della testa utensile con una torre. Questa # impostazione di solito corrisponde alla larghezza del piatto (in mm). #slow_ratio: 3 # Il rapporto utilizzato per limitare la velocit\u00e0 e l'accelerazione sui # movimenti vicini agli estremi dell'asse X. Se la distanza verticale # divisa per la distanza orizzontale supera il valore di slow_ratio, la # velocit\u00e0 e l'accelerazione sono limitate alla met\u00e0 dei loro valori # nominali. Se la distanza verticale divisa per la distanza orizzontale # supera il doppio del valore di slow_ratio, la velocit\u00e0 e l'accelerazione # sono limitate a un quarto dei loro valori nominali. # Il valore predefinito \u00e8 3. # la sezione stepper_left \u00e8 usata per descrivere lo stepper che controlla # la torre di sinistra. Questa sezione controlla anche i parametri di # homing (velocit\u00e0 di homing, homing retract_dist) per tutte le torri. [stepper_left] position_endstop: # Distanza (in mm) tra l'ugello e il piatto quando l'ugello si trova al # centro dell'area di costruzione e vengono attivati i finecorsa. Questo # parametro deve essere fornito per stepper_left; per stepper_right # questo parametro \u00e8 predefinito sul valore specificato per stepper_left. arm_length: # Lunghezza (in mm) dell'asta diagonale che collega il carrello torre # alla testina di stampa. Questo parametro deve essere fornito per # stepper_left; per stepper_right, questo parametro per impostazione # predefinita \u00e8 il valore specificato per stepper_left. arm_x_length: # Distanza orizzontale tra la testina di stampa e la torre quando le # stampanti \u00e8 in homing. Questo parametro deve essere fornito # per stepper_left; per stepper_right, questo parametro per impostazione # predefinita \u00e8 il valore specificato per stepper_left. # La sezione stepper_right \u00e8 usata per descrivere lo stepper che # controlla la torre destra. [stepper_right] # La sezione stepper_y viene utilizzata per descrivere lo stepper che # controlla l'asse Y in un robot deltesiano. [stepper_y] Cinematica CoreXY \u00b6 Vedere example-corexy.cfg per un file cinematico corexy (e h-bot) di esempio. Qui sono descritti solo i parametri specifici per le stampanti corexy - vedere impostazioni cinematiche comuni per i parametri disponibili. [printer] kinematics: corexy max_z_velocity: # Imposta la velocit\u00e0 massima (in mm/s) di movimento lungo l'asse z. # Questa impostazione pu\u00f2 essere utilizzata per limitare la velocit\u00e0 # massima del motore passo-passo z. L'impostazione predefinita \u00e8 # utilizzare max_velocity per max_z_velocity. max_z_accel: # Imposta l'accelerazione massima (in mm/s^2) del movimento # lungo l'asse z. Limita l'accelerazione del motore passo-passo z. # L'impostazione predefinita \u00e8 utilizzare max_accel per max_z_accel. # La sezione stepper_x viene utilizzata per descrivere l'asse X e lo # stepper che controlla il movimento X+Y. [stepper_x] # La sezione stepper_y viene utilizzata per descrivere l'asse Y e lo # stepper che controlla il movimento X+Y. [stepper_y] # La sezione stepper_z viene utilizzata per descrivere l'asse Z [stepper_z] Cinematica CoreXZ \u00b6 Vedere example-corexz.cfg per un file di configurazione della cinematica corexz di esempio. Qui sono descritti solo i parametri specifici per le stampanti corexz - vedere impostazioni cinematiche comuni per i parametri disponibili. [printer] kinematics: corexz max_z_velocity: # Imposta la velocit\u00e0 massima (in mm/s) di movimento lungo l'asse z. # L'impostazione predefinita \u00e8 utilizzare max_velocity per # max_z_velocity. max_z_accel: # Imposta l'accelerazione massima (in mm/s^2) del movimento lungo # l'asse z. L'impostazione predefinita \u00e8 utilizzare max_accel per # max_z_accel. # La sezione stepper_x viene utilizzata per descrivere l'asse X e lo # stepper che controlla il movimento X+Z. [stepper_x] # La sezione stepper_y viene utilizzata per descrivere l'asse Y [stepper_y] # La sezione stepper_z viene utilizzata per descrivere l'asse Z e lo # stepper che controlla il movimento X+Z. [stepper_z] Cinematica Hybrid-CoreXY \u00b6 Vedere example-hybrid-corexy.cfg per un file di configurazione della cinematica corexy ibrida di esempio. Questa cinematica \u00e8 anche nota come cinematica Markforged. Qui vengono descritti solo i parametri specifici delle stampanti corexy ibride, vedere impostazioni cinematiche comuni per i parametri disponibili. [printer] kinematics: hybrid_corexy max_z_velocity: # Imposta la velocit\u00e0 massima (in mm/s) di movimento lungo # l'asse z. L'impostazione predefinita \u00e8 utilizzare max_velocity # per max_z_velocity. max_z_accel: # Imposta l'accelerazione massima (in mm/s^2) del movimento # lungo l'asse z. L'impostazione predefinita \u00e8 utilizzare max_accel # per max_z_accel. # La sezione stepper_x viene utilizzata per descrivere l'asse X e lo # stepper che controlla il movimento X-Y. [stepper_x] # La sezione stepper_y viene utilizzata per descrivere lo stepper # che controlla l'asse Y. [stepper_y] # La sezione stepper_z viene utilizzata per descrivere lo stepper # che controlla l'asse Z. [stepper_z] Cinematica Hybrid-CoreXZ \u00b6 Vedere example-hybrid-corexz.cfg per un file di configurazione della cinematica corexz ibrido di esempio. Questa cinematica \u00e8 anche nota come cinematica Markforged. Qui vengono descritti solo i parametri specifici delle stampanti corexy ibride, vedere impostazioni cinematiche comuni per i parametri disponibili. [printer] kinematics: hybrid_corexz max_z_velocity: # Questo imposta la velocit\u00e0 massima (in mm/s) di movimento lungo # l'asse z. L'impostazione predefinita \u00e8 utilizzare max_velocity per # max_z_velocity. max_z_accel: # Imposta l'accelerazione massima (in mm/s^2) del movimento lungo # l'asse z. L'impostazione predefinita \u00e8 utilizzare max_accel per # max_z_accel. # La sezione stepper_x viene utilizzata per descrivere l'asse X e lo # stepper che controlla il movimento X-Z. [stepper_x] # La sezione stepper_y viene utilizzata per descrivere lo stepper che # controlla l'asse Y. [stepper_y] # La sezione stepper_z viene utilizzata per descrivere lo stepper che # controlla l'asse Z. [stepper_z] Cinematica polare \u00b6 Vedere example-polar.cfg per un file di configurazione della cinematica polare di esempio. Qui sono descritti solo i parametri specifici per le stampanti polari - vedere impostazioni cinematiche comuni per i parametri disponibili. LA CINEMATICA POLARE \u00c8 UN LAVORO IN CORSO. \u00c8 noto che i movimenti intorno alla posizione 0, 0 non funzionano correttamente. [printer] kinematics: polar max_z_velocity: # Imposta la velocit\u00e0 massima (in mm/s) di movimento lungo l'asse z. # Questa impostazione pu\u00f2 essere utilizzata per limitare la velocit\u00e0 # massima del motore passo-passo z. L'impostazione predefinita \u00e8 # utilizzare max_velocity per max_z_velocity. max_z_accel: # Questo imposta l'accelerazione massima (in mm/s^2) del # movimento lungo l'asse z. Limita l'accelerazione del motore # passo-passo z. L'impostazione predefinita \u00e8 utilizzare max_accel # per max_z_accel. # La sezione stepper_bed viene utilizzata per descrivere lo stepper # che controlla il piatto [stepper_bed] gear_ratio: # \u00c8 necessario specificare un gear_ratio e rotation_distance # potrebbe non essere specificato. Ad esempio, se il piatto ha una # ruota a 80 denti azionata da uno stepper con una ruota a 16 # denti, si dovrebbe specificare un rapporto di trasmissione di \"80:16\". # Questo parametro deve essere fornito. # La sezione stepper_arm \u00e8 usata per descrivere lo stepper che # controlla il carrello sul braccio. [stepper_arm] # La sezione stepper_z viene utilizzata per descrivere lo stepper che # controlla l'asse Z. [stepper_z] Rotary delta Kinematics \u00b6 See example-rotary-delta.cfg for an example rotary delta kinematics config file. Qui vengono descritti solo i parametri specifici delle stampanti delta rotative - vedere impostazioni cinematiche comuni per i parametri disponibili. ROTARY DELTA KINEMATICS ARE A WORK IN PROGRESS. Homing moves may timeout and some boundary checks are not implemented. [printer] kinematics: rotary_delta max_z_velocity: # For delta printers this limits the maximum velocity (in mm/s) of # moves with z axis movement. This setting can be used to reduce the # maximum speed of up/down moves (which require a higher step rate # than other moves on a delta printer). The default is to use # max_velocity for max_z_velocity. #minimum_z_position: 0 # The minimum Z position that the user may command the head to move # to. The default is 0. shoulder_radius: # Radius (in mm) of the horizontal circle formed by the three # shoulder joints, minus the radius of the circle formed by the # effector joints. This parameter may also be calculated as: # shoulder_radius = (delta_f - delta_e) / sqrt(12) # This parameter must be provided. shoulder_height: # Distance (in mm) of the shoulder joints from the bed, minus the # effector toolhead height. This parameter must be provided. # The stepper_a section describes the stepper controlling the rear # right arm (at 30 degrees). This section also controls the homing # parameters (homing_speed, homing_retract_dist) for all arms. [stepper_a] gear_ratio: # A gear_ratio must be specified and rotation_distance may not be # specified. For example, if the arm has an 80 toothed pulley driven # by a pulley with 16 teeth, which is in turn connected to a 60 # toothed pulley driven by a stepper with a 16 toothed pulley, then # one would specify a gear ratio of \"80:16, 60:16\". This parameter # must be provided. position_endstop: # Distance (in mm) between the nozzle and the bed when the nozzle is # in the center of the build area and the endstop triggers. This # parameter must be provided for stepper_a; for stepper_b and # stepper_c this parameter defaults to the value specified for # stepper_a. upper_arm_length: # Length (in mm) of the arm connecting the \"shoulder joint\" to the # \"elbow joint\". This parameter must be provided for stepper_a; for # stepper_b and stepper_c this parameter defaults to the value # specified for stepper_a. lower_arm_length: # Length (in mm) of the arm connecting the \"elbow joint\" to the # \"effector joint\". This parameter must be provided for stepper_a; # for stepper_b and stepper_c this parameter defaults to the value # specified for stepper_a. #angle: # This option specifies the angle (in degrees) that the arm is at. # The default is 30 for stepper_a, 150 for stepper_b, and 270 for # stepper_c. # The stepper_b section describes the stepper controlling the rear # left arm (at 150 degrees). [stepper_b] # The stepper_c section describes the stepper controlling the front # arm (at 270 degrees). [stepper_c] # The delta_calibrate section enables a DELTA_CALIBRATE extended # g-code command that can calibrate the shoulder endstop positions. [delta_calibrate] radius: # Radius (in mm) of the area that may be probed. This is the radius # of nozzle coordinates to be probed; if using an automatic probe # with an XY offset then choose a radius small enough so that the # probe always fits over the bed. This parameter must be provided. #speed: 50 # The speed (in mm/s) of non-probing moves during the calibration. # The default is 50. #horizontal_move_z: 5 # The height (in mm) that the head should be commanded to move to # just prior to starting a probe operation. The default is 5. Cable winch Kinematics \u00b6 Vedere example-winch.cfg per un esempio di file di configurazione della cinematica con verricello, cable winch. Qui sono descritti solo i parametri specifici per le stampanti cavo verricello - vedere impostazioni comuni cinematiche per i parametri disponibili. CABLE WINCH SUPPORT IS EXPERIMENTAL. Homing is not implemented on cable winch kinematics. In order to home the printer, manually send movement commands until the toolhead is at 0, 0, 0 and then issue a G28 command. [printer] kinematics: winch # The stepper_a section describes the stepper connected to the first # cable winch. A minimum of 3 and a maximum of 26 cable winches may be # defined (stepper_a to stepper_z) though it is common to define 4. [stepper_a] rotation_distance: # The rotation_distance is the nominal distance (in mm) the toolhead # moves towards the cable winch for each full rotation of the # stepper motor. This parameter must be provided. anchor_x: anchor_y: anchor_z: # The X, Y, and Z position of the cable winch in cartesian space. # These parameters must be provided. Nessuna cinematica \u00b6 \u00c8 possibile definire una cinematica speciale \"none\" per disabilitare il supporto cinematico in Klipper. Questo pu\u00f2 essere utile per controllare dispositivi che non sono le tipiche stampanti 3D o per scopi di debug. [printer] kinematics: none max_velocity: 1 max_accel: 1 # \u00c8 necessario definire i parametri max_velocity e max_accel. I valori # non vengono utilizzati per la cinematica \"none\". Supporto per estrusore e piatto riscaldato comuni \u00b6 [extruder] \u00b6 La sezione dell'estrusore viene utilizzata per descrivere i parametri del riscaldatore per l'hotend dell'ugello insieme allo stepper che controlla l'estrusore. Per ulteriori informazioni, vedere riferimento comando . Consultare la Guida all'avanzamento della pressione per informazioni sulla regolazione dell'anticipo della pressione. [extruder] step_pin: dir_pin: enable_pin: microsteps: rotation_distance: #full_steps_per_rotation: #gear_ratio: # Vedere la sezione \"stepper\" per una descrizione di quanto sopra # Se nessuno dei parametri precedenti \u00e8 specificato, nessuno stepper # sar\u00e0 associato all'hotend dell'ugello (sebbene un comando # SYNC_EXTRUDER_MOTION possa associarne uno in fase di esecuzione). nozzle_diameter: # Diametro dell'orifizio dell'ugello (in mm). Questo parametro deve essere fornito. filament_diameter:: # Il diametro nominale del filamento grezzo (in mm) quando # entra nell'estrusore. Questo parametro deve essere fornito. #max_extrude_cross_section: # Area massima (in mm^2) di una sezione trasversale dell'estrusione # (ad es. larghezza dell'estrusione moltiplicata per l'altezza dello strato). # Questa impostazione previene quantit\u00e0 eccessive di estrusione # durante spostamenti XY relativamente piccoli. # Se un movimento richiede una velocit\u00e0 di estrusione che supererebbe questo valore # causer\u00e0 la restituzione di un errore. L'impostazione predefinita # \u00e8: 4.0 * diametro_ugello^2 instantaneous_corner_velocity: 1.000 # La variazione di velocit\u00e0 istantanea massima (in mm/s) del # estrusore durante il collegamento di due movimenti. Il valore predefinito \u00e8 1 mm/s. #max_extrude_only_distance: 50.0 # Lunghezza massima (in mm di filamento grezzo) che pu\u00f2 avere un movimento # di retrazione o di sola estrusione. Se uno spostamento di retrazione # o di sola estrusione richiede una distanza maggiore di questo valore, # verr\u00e0 restituito un errore. Il valore predefinito \u00e8 50 mm. #max_extrude_only_velocity: #max_extrude_only_accel: # Velocit\u00e0 massima (in mm/s) e accelerazione (in mm/s^2) del # motore estrusore per retrazioni e movimenti di sola estrusione. # Queste impostazioni non hanno alcun impatto sui normali movimenti di stampa. # Se non specificati, vengono calcolati per corrispondere al limite che avrebbe # un movimento di stampa XY con una sezione trasversale di 4,0*diametro_ugello^2. #pressure_advance: 0.0 # La quantit\u00e0 di filamento grezzo da spingere nell'estrusore durante # accelerazione dell'estrusore. Una uguale quantit\u00e0 di filamento viene # retratta durante la decelerazione. Si misura in millimetri per # millimetro/secondo. Il valore predefinito \u00e8 0, che disabilita l'avanzamento della pressione. #pressure_advance_smooth_time: 0,040 # Un intervallo di tempo (in secondi) da utilizzare per calcolare la velocit\u00e0 media # dell'estrusore per l'avanzamento della pressione. Un valore maggiore si traduce # in movimenti pi\u00f9 fluidi dell'estrusore. Questo parametro non pu\u00f2 superare i 200 ms. # Questa impostazione si applica solo se pressure_advance \u00e8 diverso da zero. # Il valore predefinito \u00e8 0,040 (40 millisecondi). # # Le restanti variabili descrivono il riscaldatore dell'estrusore. heater_pin: # Pin di uscita PWM che controlla il riscaldatore. Questo parametro deve essere fornito. #max_power: 1.0 # La potenza massima (espressa come un valore compreso tra 0,0 e 1,0) a cui # pu\u00f2 essere impostato il riscaldatore_pin. Il valore 1.0 consente di impostare il pin # completamente abilitato per periodi prolungati, mentre un valore di 0,5 # consentirebbe di abilitare il pin per non pi\u00f9 della met\u00e0 del tempo. Questo # l'impostazione pu\u00f2 essere utilizzata per limitare la potenza totale # (per periodi prolungati) al riscaldatore. L'impostazione predefinita \u00e8 1.0. sensor_type: # Tipo di sensore - i termistori comuni sono \"EPCOS 100K B57560G104F\", # \"ATC Semitec 104GT-2\", \"ATC Semitec 104NT-4-R025H42G\", \"Generico # 3950\",\"Honeywell 100K 135-104LAG-J01\", \"NTC 100K MGB18-104F39050L32\", # \"SliceEngineering 450\" e \"TDK NTCG104LH104JT1\". Vedere la sezione # \"Sensori di temperatura\" per altri sensori. Questo parametro deve essere fornito. sensor_pin: # Pin di ingresso analogico collegato al sensore. Questo parametro deve essere fornito. #pullup_resistor: 4700 # La resistenza (in ohm) del pullup collegato al termistore. Questo parametro # \u00e8 valido solo quando il sensore \u00e8 un termistore. Il valore predefinito \u00e8 4700 ohm. #smooth_time: 1.0 # Un valore di tempo (in secondi) durante il quale le misurazioni della # temperatura verranno uniformate per ridurre l'impatto del rumore # di misurazione. Il valore predefinito \u00e8 1 secondo. control: # Algoritmo di controllo (pid o filigrana). Questo parametro deve # essere fornito. pid_Kp: pid_Ki: pid_Kd: # Il proporzionale (pid_Kp), l'integrale (pid_Ki) e la derivata # (pid_Kd) impostazioni per il sistema di controllo del feedback PID. Klipper # valuta le impostazioni PID con la seguente formula generale: # riscaldatore_pwm = (Kp*errore + Ki*integrale(errore) - Kd*derivato(errore)) / 255 # Dove \"errore\" \u00e8 \"temperatura_richiesta - temperatura_misurata\" # e \"heater_pwm\" \u00e8 la velocit\u00e0 di riscaldamento richiesta con 0,0 completamente # off e 1.0 completamente on. Prendi in considerazione l'utilizzo di PID_CALIBRATE # comando per ottenere questi parametri. pid_Kp, pid_Ki e pid_Kd # i parametri devono essere forniti per i riscaldatori PID. #delta_max: 2.0 # Sui riscaldatori controllati questo \u00e8 il numero di gradi in # Celsius al di sopra della temperatura target prima di disattivare il riscaldatore # cos\u00ec come il numero di gradi sotto il target prima # riattivare il riscaldatore. L'impostazione predefinita \u00e8 2 gradi Celsius. #pwm_cycle_time: 0,100 # Tempo in secondi per ogni ciclo PWM software del riscaldatore. # non \u00e8 consigliabile impostarlo a meno che non ci sia necessario come # requisito accendere il riscaldatore pi\u00f9 velocemente di 10 volte al secondo. # Il valore predefinito \u00e8 0,100 secondi. #min_extrude_temp: 170 # La temperatura minima (in gradi Celsius) alla quale possono essere # impartiti comandi all'estrusore. L'impostazione predefinita \u00e8 170 gradi Celsius. min_temp: max_temp: # L'intervallo massimo di temperature valide (in gradi Celsius) in cui # il riscaldatore deve rimanere all'interno. Questo controlla una funzione di sicurezza # implementata nel codice del microcontrollore , la temperatura # non cadr\u00e0 mai al di fuori di questo intervallo, altrimenti il microcontrollore # entrer\u00e0 in uno stato di arresto. Questo controllo pu\u00f2 aiutare a rilevarne alcuni # guasti hardware del riscaldatore e del sensore. Imposta questo intervallo solo in modo ampio # abbastanza in modo che temperature ragionevoli non si traducano in un errore. # Questi parametri devono essere forniti. [heater_bed] \u00b6 La sezione heater_bed descrive un piatto riscaldato. Utilizza le stesse impostazioni del riscaldatore descritte nella sezione \"extruder\". [heater_bed] heater_pin: sensor_type: sensor_pin: control: min_temp: max_temp: # Vedere la sezione \"extruder\" per una descrizione dei parametri sopra. Supporto livellamento del piatto \u00b6 [bed_mesh] \u00b6 Mesh Bed Leveling. Si pu\u00f2 definire una sezione di configurazione bed_mesh per abilitare trasformazioni di spostamento che sfalsano l'asse z in base a una mesh generata da punti sondati. Quando si utilizza una sonda per la posizione di riferimento sull'asse z, si consiglia di definire una sezione safe_z_home in printer.cfg per la posizione di riferimento verso il centro dell'area di stampa. Per ulteriori informazioni, vedere la bed mesh guide e riferimento del comando . Esempi visivi: rectangular bed, probe_count = 3, 3: x---x---x (max_point) | x---x---x | (min_point) x---x---x round bed, round_probe_count = 5, bed_radius = r: x (0, r) end / x---x---x \\ (-r, 0) x---x---x---x---x (r, 0) \\ x---x---x / x (0, -r) start [bed_mesh] #speed: 50 # The speed (in mm/s) of non-probing moves during the calibration. # The default is 50. #horizontal_move_z: 5 # The height (in mm) that the head should be commanded to move to # just prior to starting a probe operation. The default is 5. #mesh_radius: # Defines the radius of the mesh to probe for round beds. Note that # the radius is relative to the coordinate specified by the # mesh_origin option. This parameter must be provided for round beds # and omitted for rectangular beds. #mesh_origin: # Defines the center X, Y coordinate of the mesh for round beds. This # coordinate is relative to the probe's location. It may be useful # to adjust the mesh_origin in an effort to maximize the size of the # mesh radius. Default is 0, 0. This parameter must be omitted for # rectangular beds. #mesh_min: # Defines the minimum X, Y coordinate of the mesh for rectangular # beds. This coordinate is relative to the probe's location. This # will be the first point probed, nearest to the origin. This # parameter must be provided for rectangular beds. #mesh_max: # Defines the maximum X, Y coordinate of the mesh for rectangular # beds. Adheres to the same principle as mesh_min, however this will # be the furthest point probed from the bed's origin. This parameter # must be provided for rectangular beds. #probe_count: 3, 3 # For rectangular beds, this is a comma separate pair of integer # values X, Y defining the number of points to probe along each # axis. A single value is also valid, in which case that value will # be applied to both axes. Default is 3, 3. #round_probe_count: 5 # For round beds, this integer value defines the maximum number of # points to probe along each axis. This value must be an odd number. # Default is 5. #fade_start: 1.0 # The gcode z position in which to start phasing out z-adjustment # when fade is enabled. Default is 1.0. #fade_end: 0.0 # The gcode z position in which phasing out completes. When set to a # value below fade_start, fade is disabled. It should be noted that # fade may add unwanted scaling along the z-axis of a print. If a # user wishes to enable fade, a value of 10.0 is recommended. # Default is 0.0, which disables fade. #fade_target: # The z position in which fade should converge. When this value is # set to a non-zero value it must be within the range of z-values in # the mesh. Users that wish to converge to the z homing position # should set this to 0. Default is the average z value of the mesh. #split_delta_z: .025 # The amount of Z difference (in mm) along a move that will trigger # a split. Default is .025. #move_check_distance: 5.0 # The distance (in mm) along a move to check for split_delta_z. # This is also the minimum length that a move can be split. Default # is 5.0. #mesh_pps: 2, 2 # A comma separated pair of integers X, Y defining the number of # points per segment to interpolate in the mesh along each axis. A # \"segment\" can be defined as the space between each probed point. # The user may enter a single value which will be applied to both # axes. Default is 2, 2. #algorithm: lagrange # The interpolation algorithm to use. May be either \"lagrange\" or # \"bicubic\". This option will not affect 3x3 grids, which are forced # to use lagrange sampling. Default is lagrange. #bicubic_tension: .2 # When using the bicubic algorithm the tension parameter above may # be applied to change the amount of slope interpolated. Larger # numbers will increase the amount of slope, which results in more # curvature in the mesh. Default is .2. #relative_reference_index: # A point index in the mesh to reference all z values to. Enabling # this parameter produces a mesh relative to the probed z position # at the provided index. #faulty_region_1_min: #faulty_region_1_max: # Optional points that define a faulty region. See docs/Bed_Mesh.md # for details on faulty regions. Up to 99 faulty regions may be added. # By default no faulty regions are set. [bed_tilt] \u00b6 Compensazione dell'inclinazione del piatto. Si pu\u00f2 definire una sezione di configurazione bed_tilt per abilitare le trasformazioni di movimento che tengono conto di un piatto inclinato. Nota che bed_mesh e bed_tilt sono incompatibili; entrambi non possono essere definiti. Per ulteriori informazioni, vedere riferimento comando . [bed_tilt] #x_adjust: 0 # The amount to add to each move's Z height for each mm on the X # axis. The default is 0. #y_adjust: 0 # The amount to add to each move's Z height for each mm on the Y # axis. The default is 0. #z_adjust: 0 # The amount to add to the Z height when the nozzle is nominally at # 0, 0. The default is 0. # The remaining parameters control a BED_TILT_CALIBRATE extended # g-code command that may be used to calibrate appropriate x and y # adjustment parameters. #points: # A list of X, Y coordinates (one per line; subsequent lines # indented) that should be probed during a BED_TILT_CALIBRATE # command. Specify coordinates of the nozzle and be sure the probe # is above the bed at the given nozzle coordinates. The default is # to not enable the command. #speed: 50 # The speed (in mm/s) of non-probing moves during the calibration. # The default is 50. #horizontal_move_z: 5 # The height (in mm) that the head should be commanded to move to # just prior to starting a probe operation. The default is 5. [bed_screws] \u00b6 Strumento per aiutare a regolare le viti di livellamento del letto. Si pu\u00f2 definire una sezione di configurazione [bed_screws] per abilitare un comando g-code BED_SCREWS_ADJUST. Per ulteriori informazioni, vedere la guida al livellamento e il riferimento al comando . [bed_screws] #screw1: # The X, Y coordinate of the first bed leveling screw. This is a # position to command the nozzle to that is directly above the bed # screw (or as close as possible while still being above the bed). # This parameter must be provided. #screw1_name: # An arbitrary name for the given screw. This name is displayed when # the helper script runs. The default is to use a name based upon # the screw XY location. #screw1_fine_adjust: # An X, Y coordinate to command the nozzle to so that one can fine # tune the bed leveling screw. The default is to not perform fine # adjustments on the bed screw. #screw2: #screw2_name: #screw2_fine_adjust: #... # Additional bed leveling screws. At least three screws must be # defined. #horizontal_move_z: 5 # The height (in mm) that the head should be commanded to move to # when moving from one screw location to the next. The default is 5. #probe_height: 0 # The height of the probe (in mm) after adjusting for the thermal # expansion of bed and nozzle. The default is zero. #speed: 50 # The speed (in mm/s) of non-probing moves during the calibration. # The default is 50. #probe_speed: 5 # The speed (in mm/s) when moving from a horizontal_move_z position # to a probe_height position. The default is 5. [screws_tilt_adjust] \u00b6 Strumento per aiutare a regolare l'inclinazione delle viti del piatto utilizzando la sonda Z. Si pu\u00f2 definire una sezione di configurazione Screws_tilt_adjust per abilitare un comando g-code SCREWS_TILT_CALCULATE. Per ulteriori informazioni, vedere la guida al livellamento e riferimento al comando . [screws_tilt_adjust] #screw1: # La coordinata (X, Y) della prima vite di livellamento del piatto. Questa # \u00e8 una posizione in cui comandare l'ugello in modo che la sonda sia # direttamente sopra la vite del piatto (o il pi\u00f9 vicino possibile mentre si # trova ancora sopra il piatto). Questa \u00e8 la vite di base utilizzata nei calcoli. # Questo parametro deve essere fornito. #screw1_name: # Un nome arbitrario per la vite data. Questo nome viene visualizzato # quando viene eseguito lo script di supporto. L'impostazione predefinita # prevede l'utilizzo di un nome basato sulla posizione XY della vite. #screw2: #screw2_name: #... # Viti di livellamento del piatto aggiuntive. Devono essere definite # almeno due viti. #speed: 50 # La velocit\u00e0 (in mm/s) degli spostamenti senza probing durante la # calibrazione. Il valore predefinito \u00e8 50. #horizontal_move_z: 5 # L'altezza (in mm) a cui la testa deve essere spostata appena prima # di avviare un'operazione di sonda. L'impostazione predefinita \u00e8 5. #screw_thread: CW-M3 # Il tipo di vite utilizzata per il livello del piatto, M3, M4 o M5 e la # direzione della manopola utilizzata per livellare il letto, in senso orario # decrementa in senso antiorario decrementa. Valori accettati: CW-M3, # CCW-M3, CW-M4, CCW-M4, CW-M5, CCW-M5. Il valore predefinito \u00e8 # CW-M3, la maggior parte delle stampanti utilizza una vite M3 e # ruotando la manopola in senso orario diminuisce la distanza. [z_tilt] \u00b6 Regolazione multipla dell'inclinazione dello stepper Z. Questa funzione consente la regolazione indipendente di pi\u00f9 stepper z (vedere la sezione \"stepper_z1\") per regolare l'inclinazione. Se questa sezione \u00e8 presente, diventa disponibile un comando G-Code esteso Z_TILT_ADJUST. [z_tilt] #z_positions: # Un elenco di coordinate X, Y (una per riga; le righe successive # identate) che descrivono la posizione di ciascun \"pivot point\" # del piattotto. Il \"pivot point\" \u00e8 il punto in cui il piatto si attacca # al dato stepper Z. Viene descritto utilizzando le coordinate dell'ugello # (la posizione X, Y dell'ugello se potesse spostarsi direttamente sopra # il punto). La prima voce corrisponde a stepper_z, la seconda a # stepper_z1, la terza a stepper_z2, ecc. # Questo parametro deve essere fornito. #points: # Un elenco di coordinate X, Y (una per riga; righe successive identate) # che devono essere rilevate durante un comando Z_TILT_ADJUST. # Specificare le coordinate dell'ugello e assicurarsi che la sonda sia # sopra il piatto alle coordinate dell'ugello date. # Questo parametro deve essere fornito. #speed: 50 # La velocit\u00e0 (in mm/s) degli spostamenti senza probing durante # la calibrazione. Il valore predefinito \u00e8 50. #horizontal_move_z: 5 # L'altezza (in mm) a cui la testa deve essere comandata per spostarsi # appena prima di avviare un'operazione di probing. # L'impostazione predefinita \u00e8 5. #retries: 0 # Numero di volte per riprovare se i punti rilevati non sono all'interno # della tolleranza. #retry_tolerance: 0 # Se i tentativi sono abilitati, riprovare se i punti sondati pi\u00f9 grande e # pi\u00f9 piccolo differiscono pi\u00f9 di retry_tolerance. Nota che l'unit\u00e0 di # modifica pi\u00f9 piccola qui sarebbe un singolo passaggio. # Tuttavia, se stai sondando pi\u00f9 punti rispetto agli stepper, # probabilmente avrai un valore minimo fisso per l'intervallo di punti # sondati che puoi apprendere osservando l'output del comando. [quad_gantry_level] \u00b6 Moving gantry leveling using 4 independently controlled Z motors. Corrects hyperbolic parabola effects (potato chip) on moving gantry which is more flexible. WARNING: Using this on a moving bed may lead to undesirable results. If this section is present then a QUAD_GANTRY_LEVEL extended G-Code command becomes available. This routine assumes the following Z motor configuration: ---------------- |Z1 Z2| | --------- | | | | | | | | | | x-------- | |Z Z3| ---------------- Dove x \u00e8 il punto 0, 0 sul piatto [quad_gantry_level] #gantry_corners: # A newline separated list of X, Y coordinates describing the two # opposing corners of the gantry. The first entry corresponds to Z, # the second to Z2. This parameter must be provided. #points: # A newline separated list of four X, Y points that should be probed # during a QUAD_GANTRY_LEVEL command. Order of the locations is # important, and should correspond to Z, Z1, Z2, and Z3 location in # order. This parameter must be provided. For maximum accuracy, # ensure your probe offsets are configured. #speed: 50 # The speed (in mm/s) of non-probing moves during the calibration. # The default is 50. #horizontal_move_z: 5 # The height (in mm) that the head should be commanded to move to # just prior to starting a probe operation. The default is 5. #max_adjust: 4 # Safety limit if an adjustment greater than this value is requested # quad_gantry_level will abort. #retries: 0 # Number of times to retry if the probed points aren't within # tolerance. #retry_tolerance: 0 # If retries are enabled then retry if largest and smallest probed # points differ more than retry_tolerance. [skew_correction] \u00b6 Correzione dell'inclinazione della stampante. \u00c8 possibile utilizzare il software per correggere l'inclinazione della stampante su 3 piani, xy, xz, yz. Questo viene fatto stampando un modello di calibrazione lungo un piano e misurando tre lunghezze. A causa della natura della correzione dell'inclinazione, queste lunghezze vengono impostate tramite gcode. Per i dettagli, vedere Correzione inclinazione e Command Reference . [skew_correction] [z_thermal_adjust] \u00b6 Regolazione della posizione Z della testa di stampa in funzione della temperatura. Compensare il movimento verticale della testina utensile causato dall'espansione termica del telaio della stampante in tempo reale utilizzando un sensore di temperatura (tipicamente accoppiato a una sezione verticale del telaio). Vedi anche: comandi g-code estesi . [z_thermal_adjust] #temp_coeff: # Il coefficiente di dilatazione della temperatura, in mm/degC. Ad esempio, un # temp_coeff di 0,01 mm/degC sposter\u00e0 l'asse Z verso il basso di 0,01 mm per ogni # grado Celsius di auemnto del sensore di temperatura . Il valore predefinito \u00e8 # 0,0 mm/degC, che non applica alcuna regolazione. #smooth_time: # Finestra di smoothing applicata al sensore di temperatura, in secondi. Pu\u00f2 # ridurre il rumore del motore da piccole correzioni eccessive in risposta al # rumore del sensore. Il valore predefinito \u00e8 2,0 secondi. #z_adjust_off_above: # Disattiva le regolazioni al di sopra di questa altezza Z [mm]. L'ultima correzione # calcolata rimarr\u00e0 applicata finch\u00e9 la testa utensile non si sposter\u00e0 nuovamente # al di sotto dell'altezza Z specificata. # Il valore predefinito \u00e8 99999999,0 mm (sempre attivo). #max_z_adjustment: # Massima regolazione assoluta applicabile all'asse Z [mm]. Il valore predefinito # \u00e8 99999999,0 mm (illimitato). #sensor_type: #sensor_pin: #min_temp: #max_temp: # Configurazione del sensore di temperatura. Vedere la sezione \"extruder\" per # la definizione dei parametri di cui sopra. #gcode_id: # Vedere la sezione \"heater_generic\" per la definizione di questo parametro. Homing personalizzato \u00b6 [safe_z_home] \u00b6 Homing Z sicuro. Si pu\u00f2 utilizzare questo meccanismo per posizionare l'asse Z su una specifica coordinata X, Y. Ci\u00f2 \u00e8 utile se la testa portautensili, ad esempio, deve spostarsi al centro del letto prima che Z possa essere riposizionato. [safe_z_home] home_xy_position: # Una coordinata X, Y (ad es. 100, 100) dove deve essere eseguita # homing Z. Questo parametro deve essere fornito. #speed: 50.0 # Velocit\u00e0 alla quale la testa di stampa viene spostata sulla # coordinata Z sicura. Il valore predefinito \u00e8 50 mm/s #z_hop: # Distanza (in mm) per sollevare l'asse Z prima dell'homing. # Questo si applica a qualsiasi comando di homing, anche se non # si trova sull'asse Z. Se l'asse Z \u00e8 gi\u00e0 azzerato e la posizione Z # corrente \u00e8 inferiore a z_hop, questo sollever\u00e0 la testa a un'altezza # di z_hop. Se l'asse Z non \u00e8 gi\u00e0 azzerato la testina viene sollevata # di z_hop. L'impostazione predefinita \u00e8 di non implementare Z hop. #z_hop_speed: 15.0 # Velocit\u00e0 (in mm/s) alla quale l'asse Z viene sollevato prima # del homing. Il valore predefinito \u00e8 15 mm/s. #move_to_previous: False # Quando \u00e8 impostato su True, gli assi X e Y vengono ripristinati alle # posizioni precedenti dopo l'homing dell'asse Z. # L'impostazione predefinita \u00e8 False. [homing_override] \u00b6 Homing Override. Si pu\u00f2 utilizzare questo meccanismo per eseguire una serie di comandi g-code al posto di un G28 che si trova nel normale input di g-code. Questo pu\u00f2 essere utile su stampanti che richiedono una procedura specifica per l'home della macchina. [homing_override] gcode: # Un elenco di comandi G-Code da eseguire al posto dei comandi # G28 trovati nel normale input di G-Code. # Vedi docs/Command_Templates.md per il formato G-Code. # Se un G28 \u00e8 contenuto in questo elenco di comandi, invocher\u00e0 # la normale procedura di homing per la stampante. I comandi # qui elencati devono eseguire l'home di tutti gli assi. # Questo parametro deve essere fornito. #axes: xyz # Gli assi da sovrascrivere. Ad esempio, se questo \u00e8 impostato # su \"z\", lo script di override verr\u00e0 eseguito solo quando l'asse z # \u00e8 azzerato (ad esempio, tramite un comando \"G28\" o \"G28 Z0\"). # Nota, lo script di sovrascrittura dovrebbe comunque ospitare # tutti gli assi. L'impostazione predefinita \u00e8 \"xyz\" che fa s\u00ec che lo # script di override venga eseguito al posto di tutti i comandi G28. #set_position_x: #set_position_y: #set_position_z: # Se specificato, la stampante presumer\u00e0 che l'asse si trovi # nella posizione specificata prima di eseguire i comandi g-code # precedenti. L'impostazione di questa opzione disabilita i # controlli di riferimento per quell'asse. Questo pu\u00f2 essere utile # se la testa deve muoversi prima di invocare il normale # meccanismo G28 per un asse. L'impostazione predefinita \u00e8 # di non forzare una posizione per un asse. [endstop_phase] \u00b6 Finecorsa regolati in fase stepper. Per utilizzare questa funzione, definire una sezione di configurazione con un prefisso \"endstop_phase\" seguito dal nome della corrispondente sezione di configurazione dello stepper (ad esempio, \"[endstop_phase stepper_z]\"). Questa funzione pu\u00f2 migliorare la precisione degli interruttori di fine corsa. Aggiungi una semplice dichiarazione \"[endstop_phase]\" per abilitare il comando ENDSTOP_PHASE_CALIBRATE. Per ulteriori informazioni, vedere la endstop phases guide e command reference . [endstop_phase stepper_z] #endstop_accuracy: # Imposta la precisione prevista (in mm) del finecorsa. Questo rappresenta # la distanza massima di errore che il finecorsa pu\u00f2 attivare (ad es. se un # finecorsa pu\u00f2 occasionalmente attivarsi 100um in anticipo o fino a 100um in ritardo # quindi impostalo su 0,200 per 200 um). L'impostazione predefinita \u00e8 # 4*distanza_rotazione/passi_completi_per_rotazione. #trigger_phase: # Questo specifica la fase del driver del motore passo-passo da aspettarsi # quando si raggiunge il finecorsa. \u00c8 composto da due numeri separati # da un '/' - la fase e il numero totale di # fasi (ad es. \"7/64\"). Impostare questo valore solo se si \u00e8 sicuri che il # driver del motore passo-passo viene ripristinato ogni volta che viene ripristinato l'mcu. Se questo # non \u00e8 impostato, la prima fase verr\u00e0 rilevata al primo home # e quella fase sar\u00e0 utilizzata su tutte le abitazioni successive. #endstop_align_zero: False # Se true, la posizione_endstop dell'asse sar\u00e0 effettivamente # modificato in modo che la posizione zero dell'asse avvenga a passo pieno # sul motore. (Se utilizzato sull'asse Z e la stampa # l'altezza del livello \u00e8 un multiplo di una distanza di un passo intero, allora ogni # layer si eseguir\u00e0 in un step completo.) L'impostazione predefinita \u00e8 False. Macro ed eventi G-Code \u00b6 [gcode_macro] \u00b6 Macro G-Code (\u00e8 possibile definire un numero qualsiasi di sezioni con un prefisso \"gcode_macro\"). Per ulteriori informazioni, consulta la Guida ai modelli di comando . [gcode_macro my_cmd] #gcode: # Un elenco di comandi G-Code da eseguire al posto di \"my_cmd\". # Vedi docs/Command_Templates.md per il formato G-Code. # Questo parametro deve essere fornito. #variable_<name>: # Si pu\u00f2 specificare un numero qualsiasi di opzioni con un prefisso # \"variable_\". Al nome della variabile data verr\u00e0 assegnato il valore dato # (analizzato come un valore letterale Python) e sar\u00e0 disponibile durante # l'espansione della macro. Ad esempio, una configurazione con # \"variable_fan_speed = 75\" potrebbe avere comandi gcode contenenti # \"M106 S{ fan_speed * 255 }\". Le variabili possono essere modificate in # fase di esecuzione utilizzando il comando SET_GCODE_VARIABLE # (consultare docs/Command_Templates.md per i dettagli). # I nomi delle variabili potrebbero non utilizzare caratteri maiuscoli. #rename_existing: # Questa opzione far\u00e0 s\u00ec che la macro ignori un comando G-Code # esistente e fornisca la definizione precedente del comando tramite # il nome fornito qui. Questo pu\u00f2 essere usato per sovrascrivere i # comandi G-Code integrati. Prestare attenzione quando si ignorano # i comandi poich\u00e9 possono causare risultati complessi e imprevisti. # L'impostazione predefinita \u00e8 di non sovrascrivere un comando # G-Code esistente. #description: G-Code macro # Ci\u00f2 aggiunger\u00e0 una breve descrizione utilizzata al comando HELP # o durante l'utilizzo della funzione di completamento automatico. # Predefinito \"G-Code macro\" [delayed_gcode] \u00b6 Esegui un gcode con un ritardo impostato. Per ulteriori informazioni, consulta la Guida template dei comandi e riferimento al comando . [delayed_gcode my_delayed_gcode] gcode: # A list of G-Code commands to execute when the delay duration has # elapsed. G-Code templates are supported. This parameter must be # provided. #initial_duration: 0.0 # The duration of the initial delay (in seconds). If set to a # non-zero value the delayed_gcode will execute the specified number # of seconds after the printer enters the \"ready\" state. This can be # useful for initialization procedures or a repeating delayed_gcode. # If set to 0 the delayed_gcode will not execute on startup. # Default is 0. [save_variables] \u00b6 Supporta il salvataggio delle variabili su disco in modo che vengano mantenute durante i riavvii. Per ulteriori informazioni, vedere template dei comandi e G-Code reference . [save_variables] filename: # Richiesto: fornire un nome file che verrebbe utilizzato per salvare # le variabili su disco, ad es. ~/variables.cfg [idle_timeout] \u00b6 Timeout di inattivit\u00e0. Viene automaticamente abilitato un timeout di inattivit\u00e0: aggiungi una sezione di configurazione di idle_timeout esplicita per modificare le impostazioni predefinite. [idle_timeout] #gcode: # Un elenco di comandi G-Code da eseguire in un timeout di # inattivit\u00e0. Vedi docs/Command Templates.md per il formato # G-Code. L'impostazione predefinita \u00e8 # eseguire \"TURN_OFF HEATERS\" e \"M84\". #timeout: 600 # Tempo di inattivit\u00e0 (in secondi) da attendere prima di eseguire # i comandi G-Code sopra. Il valore predefinito \u00e8 600 secondi. Funzionalit\u00e0 opzionali G-Code \u00b6 [virtual_sdcard] \u00b6 Una scheda SD virtuale pu\u00f2 essere utile se la macchina host non \u00e8 abbastanza veloce per eseguire bene OctoPrint. Consente al software host Klipper di stampare direttamente i file gcode archiviati in una directory sull'host utilizzando i comandi G-Code standard (ad esempio, M24). [virtual_sdcard] path: # Il percorso della directory locale sulla macchina host per cercare # i file di Gcode. Questa \u00e8 una directory di sola lettura (le scritture # di file sdcard non sono supportate). Si pu\u00f2 indicare questo alla # directory di caricamento di OctoPrint # (generalmente ~/.octoprint/uploads/ ). # Questo parametro deve essere fornito. #on_error_gcode: # Un elenco di comandi G-Code da eseguire quando viene segnalato # un errore. [sdcard_loop] \u00b6 Alcune stampanti con funzionalit\u00e0 di pulizia del piatto, come un espulsore di parti o una stampante a nastro, possono trovare impiego nelle sezioni di loop del file sdcard. (Ad esempio, per stampare la stessa parte pi\u00f9 e pi\u00f9 volte, o ripetere la sezione a di una parte per una catena o un altro motivo ripetuto). Consulta il command reference per i comandi supportati. Vedere il file sample-macros.cfg per una macro M808 G-Code compatibile con Marlin. [sdcard_loop] [force_move] \u00b6 Supporta lo spostamento manuale dei motori passo-passo per scopi diagnostici. Nota, l'utilizzo di questa funzione potrebbe mettere la stampante in uno stato non valido - vedere il command reference per dettagli importanti. [force_move] #enable_force_move: False # Impostare su True per abilitare FORCE_MOVE e SET_KINEMATIC_POSITION # i comandi G-Code estesi. L'impostazione predefinita \u00e8 False. [pause_resume] \u00b6 Funzionalit\u00e0 di Pause/Resume con supporto di acquisizione e ripristino della posizione. Per ulteriori informazioni, vedere riferimento comando . [pause_resume] #recover_velocity: 50. # Quando si abilita pause_resume, la velocit\u00e0 con cui tornare alla # posizione catturata (in mm/s). Il valore predefinito \u00e8 50,0 mm/s. [firmware_retraction] \u00b6 Retrazione del filamento del firmware. Ci\u00f2 abilita i comandi GCODE G10 (ritiro) e G11 (non ritirati) emessi da molti slicer. I parametri seguenti forniscono le impostazioni predefinite di avvio, sebbene i valori possano essere regolati tramite il [comando] SET_RETRACTION (G-Codes.md#firmware_retraction)), consentendo l'impostazione e l'ottimizzazione del filamento a runtime. [firmware_retraction] #retract_length: 0 # La lunghezza del filamento (in mm) da ritrarre quando G10 # \u00e8 attivato e da ritrarre quando G11 \u00e8 attivato (ma vedere # unretract_extra_length di seguito). I# l valore predefinito \u00e8 0 mm. #retract_speed: 20 # La velocit\u00e0 di retrazione, in mm/s. # Il valore predefinito \u00e8 20 mm/s. #unretract_extra_length: 0 # La lunghezza (in mm) del filamento *aggiuntivo* da # sommare quando non si ritrae. #unretract_speed: 10 # La velocit\u00e0 di srotolamento, in mm/s. # Il valore predefinito \u00e8 10 mm/s. [gcode_arcs] \u00b6 Supporto per i comandi Gcode arc (G2/G3). [gcode_arcs] #resolution: 1.0 # Un arco sar\u00e0 diviso in segmenti. La lunghezza di ciascun segmento # sar\u00e0 uguale alla risoluzione in mm impostata sopra. Valori pi\u00f9 bassi # produrranno un arco pi\u00f9 fine, ma anche pi\u00f9 lavoro per la tua macchina. # Archi pi\u00f9 piccoli del valore configurato diventer\u00e0 linee rette. # L'impostazione predefinita \u00e8 # 1mm. [respond] \u00b6 Abilita i comandi estesi \"M118\" e \"RESPOND\" commands . [respond] #default_type: echo # Imposta il prefisso predefinito dell'output \"M118\" e \"RESPOND\" su uno dei seguenti: # echo: \"echo: \" (Questa \u00e8 l'impostazione predefinita) # command: \"// \" # error: \"!! \" #default_prefix: echo: # Imposta direttamente il prefisso predefinito. Se presente # questo valore sovrascriver\u00e0 il \"default_type\". [exclude_object] \u00b6 Abilita il supporto per escludere o cancellare singoli oggetti durante il processo di stampa. Per ulteriori informazioni, vedere la guida escludi oggetti e riferimento ai comandi . Vedere il file sample-macros.cfg per una macro G-Code M486 compatibile con Marlin/RepRapFirmware. [exclude_object] Compensazione della risonanza \u00b6 [input_shaper] \u00b6 Abilita compensazione della risonanza . Vedere anche il command reference . [input_shaper] #shaper_freq_x: 0 # Una frequenza (in Hz) dell'input shaper per l'asse X. Questa \u00e8 # solitamente una frequenza di risonanza dell'asse X che l'input # shaper dovrebbe sopprimere. Per shaper pi\u00f9 complessi, come # shaper di input EI a 2 e 3 gobbe, questo parametro pu\u00f2 essere # impostato in base a diverse considerazioni. # Il valore predefinito \u00e8 0, che disabilita la modellatura dell'input # per l'asse X. #shaper_freq_y: 0 # Una frequenza (in Hz) dell'input shaper per l'asse Y. Questa \u00e8 # solitamente una frequenza di risonanza dell'asse Y che l'input # shaper dovrebbe sopprimere. Per shaper pi\u00f9 complessi, come # shaper di input EI a 2 e 3 gobbe, questo parametro pu\u00f2 essere # impostato in base a diverse considerazioni. Il valore predefinito # \u00e8 0, che disabilita la modellatura dell'input per l'asse Y. #shaper_type: mzv # Un tipo di input shaper da utilizzare per entrambi gli assi X e Y. # Gli shaper supportati sono zv, mzv, zvd, ei, 2hump_ei e # 3hump_ei. L'impostazione predefinita \u00e8 mzv input shaper. #shaper_type_x: #shaper_type_y: # Se shaper_type non \u00e8 impostato, questi due parametri possono # essere utilizzati per configurare diversi shaper di input per gli # assi X e Y. Sono supportati gli stessi valori del parametro # shaper_type. #damping_ratio_x: 0.1 #damping_ratio_y: 0.1 # Rapporti di smorzamento delle vibrazioni degli assi X e Y # utilizzati dagli shaper di input per migliorare la soppressione # delle vibrazioni. Il valore predefinito \u00e8 0,1, un buon valore per la # maggior parte delle stampanti. Nella maggior parte dei casi # questo parametro non richiede ottimizzazione e # non deve essere modificato. [adxl345] \u00b6 Supporto per accelerometri ADXL345. Questo supporto consente di interrogare le misurazioni dell'accelerometro dal sensore. Ci\u00f2 abilita un comando ACCELEROMETER_MEASURE (consultare G-Codes per ulteriori informazioni). Il nome del chip predefinito \u00e8 \"predefinito\", ma \u00e8 possibile specificare un nome esplicito (ad esempio, [adxl345 my_chip_name]). [adxl345] cs_pin: # The SPI enable pin for the sensor. This parameter must be provided. #spi_speed: 5000000 # The SPI speed (in hz) to use when communicating with the chip. # The default is 5000000. #spi_bus: #spi_software_sclk_pin: #spi_software_mosi_pin: #spi_software_miso_pin: # See the \"common SPI settings\" section for a description of the # above parameters. #axes_map: x, y, z # The accelerometer axis for each of the printer's X, Y, and Z axes. # This may be useful if the accelerometer is mounted in an # orientation that does not match the printer orientation. For # example, one could set this to \"y, x, z\" to swap the X and Y axes. # It is also possible to negate an axis if the accelerometer # direction is reversed (eg, \"x, z, -y\"). The default is \"x, y, z\". #rate: 3200 # Output data rate for ADXL345. ADXL345 supports the following data # rates: 3200, 1600, 800, 400, 200, 100, 50, and 25. Note that it is # not recommended to change this rate from the default 3200, and # rates below 800 will considerably affect the quality of resonance # measurements. [mpu9250] \u00b6 Support for MPU-9250, MPU-9255, MPU-6515, MPU-6050, and MPU-6500 accelerometers (one may define any number of sections with an \"mpu9250\" prefix). [mpu9250 my_accelerometer] #i2c_address: # Default is 104 (0x68). If AD0 is high, it would be 0x69 instead. #i2c_mcu: #i2c_bus: #i2c_speed: 400000 # See the \"common I2C settings\" section for a description of the # above parameters. The default \"i2c_speed\" is 400000. #axes_map: x, y, z # See the \"adxl345\" section for information on this parameter. [resonance_tester] \u00b6 Supporto per test di risonanza e calibrazione automatica del input shaper. Per utilizzare la maggior parte delle funzionalit\u00e0 di questo modulo, devono essere installate dipendenze software aggiuntive; fare riferimento a Measuring Resonances e al command reference per ulteriori informazioni. Per ulteriori informazioni sul parametro max_smoothing e sul suo utilizzo, vedere la sezione Max smoothing della guida alla misurazione delle risonanze. [resonance_tester] #probe_points: # Un elenco di coordinate X, Y, Z di punti (un punto per linea) in cui # testare le risonanze. Almeno un punto \u00e8 richiesto. Assicurati che tutti # i punti con un margine di sicurezza nel piano XY (~ pochi centimetri) # siano raggiungibili dalla testa di stampa. #accel_chip: # Un nome del chip dell'accelerometro da utilizzare per le misurazioni. # Se il chip adxl345 \u00e8 stato definito senza un nome esplicito, questo # parametro pu\u00f2 semplicemente fare riferimento ad esso come # \"accel_chip: adxl345\", altrimenti deve essere fornito anche un nome # esplicito, ad es. \"accel_chip: adxl345 mio_chip_nome\". \u00c8 necessario # impostare questo o i due parametri successivi. #accel_chip_x: #accel_chip_y: # Nomi dei chip dell'accelerometro da utilizzare per le misurazioni per # ciascuno degli assi. Pu\u00f2 essere utile, ad esempio, su una stampante con # piatto, se due accelerometri separati sono montati sul piatto (per l'asse Y) # e sulla testa di stampa (per l'asse X). Questi parametri hanno lo stesso # formato del parametro 'accel_chip'. # \u00c8 necessario fornire solo 'accel_chip' o questi due parametri. #max_smoothing: # Maximum input shaper smoothing to allow for each axis during shaper # auto-calibration (with 'SHAPER_CALIBRATE' command). By default no # maximum smoothing is specified. Refer to Measuring_Resonances guide # for more details on using this feature. #min_freq: 5 # Frequenza minima per testare le risonanze. L'impostazione \u00e8 5 Hz. #max_freq: 133.33 # Frequenza massima per testare le risonanze. L'impostazione \u00e8 133,33 Hz. #accel_per_hz: 75 # Questo parametro viene utilizzato per determinare quale accelerazione # utilizzare per testare una frequenza specifica: accel = accel_per_hz * freq. # Maggiore \u00e8 il valore, maggiore \u00e8 l'energia delle oscillazioni. Pu\u00f2 essere # impostato su un valore inferiore al valore predefinito se le risonanze # diventano troppo forti sulla stampante. Tuttavia, valori pi\u00f9 bassi rendono # le misurazioni delle risonanze ad alta frequenza meno precise. # Il valore predefinito \u00e8 75 (mm/sec). #hz_per_sec: 1 # Determina la velocit\u00e0 del test. Quando si testano tutte le frequenze # nell'intervallo [freq_min, freq_max], ogni secondo la frequenza aumenta # di hz_per_sec. Valori piccoli rallentano il test e valori grandi diminuiscono # la precisione del test. Il valore predefinito \u00e8 1,0 (Hz/sec == sec^-2). Helper per i file di configurazione \u00b6 [board_pins] \u00b6 Alias pin board (si pu\u00f2 definire un numero qualsiasi di sezioni con un prefisso \"board_pins\"). Usalo per definire gli alias per i pin su un microcontrollore. [board_pins my_aliases] mcu: mcu # A comma separated list of micro-controllers that may use the # aliases. The default is to apply the aliases to the main \"mcu\". aliases: aliases_<name>: # A comma separated list of \"name=value\" aliases to create for the # given micro-controller. For example, \"EXP1_1=PE6\" would create an # \"EXP1_1\" alias for the \"PE6\" pin. However, if \"value\" is enclosed # in \"<>\" then \"name\" is created as a reserved pin (for example, # \"EXP1_9=<GND>\" would reserve \"EXP1_9\"). Any number of options # starting with \"aliases_\" may be specified. [include] \u00b6 Supporto per includere i file. Uno pu\u00f2 includere un file di configurazione aggiuntivo dal file di configurazione della stampante principale. Possono essere utilizzati anche caratteri jolly (ad es. \"configs/*.cfg\"). [include my_other_config.cfg] [duplicate_pin_override] \u00b6 Questo strumento consente di definire pi\u00f9 volte un singolo pin del microcontrollore in un file di configurazione senza il normale controllo degli errori. Questo \u00e8 inteso per scopi diagnostici e di debug. Questa sezione non \u00e8 necessaria laddove Klipper supporta l'utilizzo dello stesso pin pi\u00f9 volte e l'utilizzo di questa sostituzione pu\u00f2 causare risultati confusi e imprevisti. [duplicate_pin_override] pins: # Un elenco di pin separato da virgole che possono essere utilizzati pi\u00f9 volte in # un file di configurazione senza normali controlli degli errori. Questo parametro deve essere # fornito. Hardware per probing del piatto \u00b6 [probe] \u00b6 Sonda di altezza Z. Si pu\u00f2 definire questa sezione per abilitare l'hardware di rilevamento dell'altezza Z. Quando questa sezione \u00e8 abilitata, i comandi estesi PROBE e QUERY_PROBE comandi g-code diventano disponibili. Inoltre, vedere la Guida alla calibrazione della sonda . La sezione probe crea anche un pin virtuale \"probe:z_virtual_endstop\". Si pu\u00f2 impostare stepper_z endstop_pin su questo pin virtuale su stampanti in stile cartesiano che utilizzano la sonda al posto di un endstop z. Se si utilizza \"probe:z_virtual_endstop\", non definire un position_endstop nella sezione di configurazione stepper_z. [probe] pin: # Pin di rilevamento della sonda. Se il pin si trova su un # microcontrollore diverso rispetto agli stepper Z, abilita # \"homing multi-mcu\". Questo parametro deve essere fornito. #deactivate_on_each_sample: True # Questo determina se Klipper deve eseguire la disattivazione # gcode tra ogni tentativo di esplorazione durante l'esecuzione di # una sequenza di probe multiple. L'impostazione predefinita \u00e8 True. #x_offset: 0.0 # La distanza (in mm) tra la sonda e l'ugello lungo l'asse x. # Il valore predefinito \u00e8 0. #y_offset: 0.0 # La distanza (in mm) tra la sonda e l'ugello lungo l'asse y. # Il valore predefinito \u00e8 0. z_offset: # La distanza (in mm) tra il piatto e l'ugello quando la sonda si attiva. # Questo parametro deve essere fornito. #speed: 5.0 # Velocit\u00e0 (in mm/s) dell'asse Z durante probing. # Il valore predefinito \u00e8 5 mm/s. #samples: 1 # Il numero di volte in cui sondare ciascun punto. I valori z sondati # verranno mediati. L'impostazione predefinita \u00e8 sondare 1 volta. #sample_retract_dist: 2.0 # La distanza (in mm) per sollevare la testa di stampa tra ciascun # campione (se si esegue il campionamento pi\u00f9 di una volta). # Il valore predefinito \u00e8 2 mm. #lift_speed: # Velocit\u00e0 (in mm/s) dell'asse Z durante il sollevamento della sonda # tra i campioni. L'impostazione predefinita prevede l'utilizzo dello # stesso valore del parametro 'speed'. #samples_result: average # Il metodo di calcolo durante il campionamento pi\u00f9 di una volta: # \"median\" o \"average\". L'impostazione predefinita \u00e8 average. #samples_tolerance: 0.100 # La distanza Z massima (in mm) che un campione pu\u00f2 differire da # altri campioni. Se questa tolleranza viene superata, viene segnalato # un errore o il tentativo viene riavviato # (vedere samples_tolerance_retries). Il valore predefinito \u00e8 0,100 mm. #samples_tolerance_retries: 0 # Il numero di tentativi per riprovare se viene trovato un campione che # supera samples_tolerance. In un nuovo tentativo, tutti i campioni # correnti vengono eliminati e il tentativo di sonda viene riavviato. # Se non si ottiene un insieme valido di campioni nel numero di tentativi # specificato, viene segnalato un errore. Il valore predefinito \u00e8 zero che # causa la segnalazione di un errore sul primo campione che supera # samples_tolerance. #activate_gcode: # Un elenco di comandi G-Code da eseguire prima di ogni tentativo di # esplorazione. Vedi docs/Command_Templates.md per il formato # G-Code. Questo pu\u00f2 essere utile se la sonda deve essere attivata in # qualche modo. Non impartire qui alcun comando che sposti la testa # di stampa (ad es. G1). L'impostazione predefinita \u00e8 di non eseguire # alcun comando G-Code speciale all'attivazione. #deactivate_gcode: # Un elenco di comandi G-Code da eseguire dopo il completamento di # ogni tentativo di esplorazione. Vedi docs/Command_Templates.md # per il formato G-Code. Non impartire qui alcun comando che sposti # la testina. L'impostazione predefinita \u00e8 di non eseguire alcun # comando G-Code speciale alla disattivazione. [bltouch] \u00b6 Sonda BLTouch. Si pu\u00f2 definire questa sezione (anzich\u00e9 una sezione sonda) per abilitare una sonda BLTouch. Per ulteriori informazioni, vedere BL-Touch guide e command reference .. Viene anche creato un pin virtuale \"probe:z_virtual_endstop\" (consultare la sezione \"probe\" per i dettagli). [bltouch] sensor_pin: # Pin connected to the BLTouch sensor pin. Most BLTouch devices # require a pullup on the sensor pin (prefix the pin name with \"^\"). # This parameter must be provided. control_pin: # Pin connected to the BLTouch control pin. This parameter must be # provided. #pin_move_time: 0.680 # The amount of time (in seconds) to wait for the BLTouch pin to # move up or down. The default is 0.680 seconds. #stow_on_each_sample: True # This determines if Klipper should command the pin to move up # between each probe attempt when performing a multiple probe # sequence. Read the directions in docs/BLTouch.md before setting # this to False. The default is True. #probe_with_touch_mode: False # If this is set to True then Klipper will probe with the device in # \"touch_mode\". The default is False (probing in \"pin_down\" mode). #pin_up_reports_not_triggered: True # Set if the BLTouch consistently reports the probe in a \"not # triggered\" state after a successful \"pin_up\" command. This should # be True for all genuine BLTouch devices. Read the directions in # docs/BLTouch.md before setting this to False. The default is True. #pin_up_touch_mode_reports_triggered: True # Set if the BLTouch consistently reports a \"triggered\" state after # the commands \"pin_up\" followed by \"touch_mode\". This should be # True for all genuine BLTouch devices. Read the directions in # docs/BLTouch.md before setting this to False. The default is True. #set_output_mode: # Request a specific sensor pin output mode on the BLTouch V3.0 (and # later). This setting should not be used on other types of probes. # Set to \"5V\" to request a sensor pin output of 5 Volts (only use if # the controller board needs 5V mode and is 5V tolerant on its input # signal line). Set to \"OD\" to request the sensor pin output use # open drain mode. The default is to not request an output mode. #x_offset: #y_offset: #z_offset: #speed: #lift_speed: #samples: #sample_retract_dist: #samples_result: #samples_tolerance: #samples_tolerance_retries: # See the \"probe\" section for information on these parameters. [smart_effector] \u00b6 Lo \"Smart Effector\" di Duet3d implementa una sonda Z utilizzando un sensore di forza. Si pu\u00f2 definire questa sezione invece di [probe] per abilitare le funzioni specifiche di Smart Effector. Ci\u00f2 consente anche a comandi di runtime di regolare i parametri di Smart Effector in fase di esecuzione. [smart_effector] pin: # Pin collegato al pin di uscita della sonda Z Smart Effector (pin 5). Si noti # che la resistenza di pullup sulla scheda generalmente non \u00e8 richiesta. # Tuttavia, se il pin di uscita \u00e8 collegato al pin della scheda con un resistore # di pullup, tale resistore deve essere di valore elevato (ad es. 10K Ohm o pi\u00f9). # Alcune schede hanno un resistore di pullup di basso valore sull'ingresso # della sonda Z, che probabilmente far\u00e0 risultare in uno stato di sonda sempre # attivato. In questo caso, collegare lo Smart Effector a un pin diverso sulla # scheda. Questo parametro \u00e8 obbligatorio. #control_pin: # Pin collegato al pin di ingresso di controllo Smart Effector (pin 7). Se fornito, # diventano disponibili i comandi di programmazione della sensibilit\u00e0 # di Smart Effector. #probe_accel: # Se impostato, limita l'accelerazione dei movimenti di tastatura (in mm/sec^2). # Un'improvvisa grande accelerazione all'inizio del movimento di esplorazione # pu\u00f2 causare l'attivazione spuria della sonda, specialmente se l'hotend \u00e8 pesante. # Per evitarlo, potrebbe essere necessario ridurre l'accelerazione dei movimenti # di tastatura tramite questo parametro. #recovery_time: 0.4 # Un ritardo tra i movimenti di spostamento e tastatura in secondi. Un # movimento veloce prima della tastatura pu\u00f2 causare l'attivazione spuria della # sonda. Ci\u00f2 pu\u00f2 causare errori \"Sonda attivata prima del movimento\" se non # \u00e8 impostato alcun ritardo. Il valore 0 disabilita il ritardo di ripristino. # Il valore predefinito \u00e8 0.4. #x_offset: #y_offset: # Dovrebbe essere lasciato non impostato (o impostato su 0). z_offset: # Altezza di attivazione della sonda. Inizia con -0.1 (mm) e regola in seguito # usando il comando `PROBE_CALIBRATE`. Questo parametro deve essere fornito. #speed: # Velocit\u00e0 (in mm/s) dell'asse Z durante la tastatura. Si consiglia di iniziare con la # velocit\u00e0 di tastatura di 20 mm/s e di regolarla secondo necessit\u00e0 per migliorare la # precisione e la ripetibilit\u00e0 dell'attivazione della sonda. #samples: #sample_retract_dist: #samples_result: #samples_tolerance: #samples_tolerance_retries: #activate_gcode: #deactivate_gcode: #deactivate_on_each_sample: # Vedere la sezione \"probe\" per ulteriori informazioni sui parametri di cui sopra. Motori passo-passo ed estrusori aggiuntivi \u00b6 [stepper_z1] \u00b6 Assi multi-stepper. Su una stampante in stile cartesiano, lo stepper che controlla un dato asse pu\u00f2 avere blocchi di configurazione aggiuntivi che definiscono gli stepper che dovrebbero essere azionati insieme allo stepper primario. Si pu\u00f2 definire un numero qualsiasi di sezioni con un suffisso numerico che inizia da 1 (ad esempio, \"stepper_z1\", \"stepper_z2\", ecc.). [stepper_z1] #step_pin: #dir_pin: #enable_pin: #microsteps: #rotation_distance: # Vedere la sezione \"stepper\" per la definizione dei parametri di cui sopra. #endstop_pin: # Se viene definito un endstop_pin per lo stepper aggiuntivo, lo stepper # si fermer\u00e0 fino all'attivazione dell'endstop. In caso contrario, lo stepper # si fermer\u00e0 fino a quando non verr\u00e0 attivato il finecorsa sullo stepper # primario per l'asse. [extruder1] \u00b6 In una stampante multiestrusore aggiungere una sezione estrusore aggiuntiva per ogni estrusore aggiuntivo. Le sezioni aggiuntive dell'estrusore devono essere denominate \"extruder1\", \"extruder2\", \"extruder3\" e cos\u00ec via. Vedere la sezione \"extruder\" per una descrizione dei parametri disponibili. Vedere sample-multi-extruder.cfg per un esempio di configurazione. [extruder1] #step_pin: #dir_pin: #... # Vedere la sezione \"estrusore\" per i parametri per lo stepper e il riscaldatore # disponibili. #shared_heater: # Questa opzione \u00e8 obsoleta e non deve pi\u00f9 essere specificata. [dual_carriage] \u00b6 Supporto per stampanti cartesiane con doppi carrelli su un unico asse. Il carrello attivo viene impostato tramite il comando G-code esteso SET_DUAL_CARRIAGE. Il comando \"SET_DUAL_CARRIAGE CARRIAGE=1\" attiver\u00e0 il carrello definito in questa sezione (CARRIAGE=0 riporter\u00e0 l'attivazione al carrello principale). Il supporto del doppio carrello \u00e8 in genere combinato con estrusori extra: il comando SET_DUAL_CARRIAGE viene spesso chiamato contemporaneamente al comando ACTIVATE_EXTRUDER. Assicurati di parcheggiare i carrelli durante la disattivazione. Vedere sample-idex.cfg per un esempio di configurazione. [dual_carriage] axis: # L'asse su cui si trova questo carrello aggiuntivo (x o y). Questo parametro # deve essere fornito #step_pin: #dir_pin: #enable_pin: #microsteps: #rotation_distance: #endstop_pin: #position_endstop: #position_min: #position_max: # Vedere la sezione \"stepper\" per la definizione dei parametri di cui sopra. [extruder_stepper] \u00b6 Supporto per stepper aggiuntivi sincronizzati al movimento di un estrusore (si pu\u00f2 definire un numero qualsiasi di sezioni con un prefisso \"extruder_stepper\"). Per ulteriori informazioni, vedere riferimento comando . [extruder_stepper my_extra_stepper] extruder: # L'estrusore con cui \u00e8 sincronizzato questo stepper. Se questo \u00e8 impostato su # una stringa vuota, lo stepper non verr\u00e0 sincronizzato con un # estrusore. Questo parametro deve essere fornito. #step_pin: #dir_pin: #enable_pin: #microsteps: #rotation_distance: # Vedere la sezione \"stepper\" per la definizione dei parametri sopra. # . [Stepper manuali] \u00b6 Stepper manuali (\u00e8 possibile definire un numero qualsiasi di sezioni con un prefisso \"manual_stepper\"). Questi sono stepper controllati dal comando g-code MANUAL_STEPPER. Ad esempio: \"MANUAL_STEPPER STEPPER=my_stepper MOVE=10 SPEED=5\". Vedere il file G-Codes per una descrizione del comando MANUAL_STEPPER. Gli stepper non sono collegati alla normale cinematica della stampante. [manual_stepper my_stepper] #step_pin: #dir_pin: #enable_pin: #microsteps: #rotation_distance: # Vedere la sezione \"stepper\" per una descrizione di questi parametri. #velocity: # Impostare la velocit\u00e0 predefinita (in mm/s) per lo stepper. Questo # valore verr\u00e0 utilizzato se un comando MANUAL_STEPPER non specifica # un parametro SPEED. Il valore predefinito \u00e8 5 mm/s. #accel: # Imposta l'accelerazione predefinita (in mm/s^2) per lo stepper. # Un'accelerazione pari a zero non risulter\u00e0 in nessuna accelerazione. # Questo valore verr\u00e0 utilizzato se un comando MANUAL_STEPPER non # specifica un parametro ACCEL. Il valore predefinito \u00e8 zero. #endstop_pin: # Pin di rilevamento interruttore di fine corsa. Se specificato, \u00e8 possibile # eseguire \"movimenti di riferimento\" aggiungendo un parametro # STOP_ON_ENDSTOP ai comandi di movimento MANUAL_STEPPER. Riscaldatori e sensori personalizzati \u00b6 [verify_heater] \u00b6 Verifica riscaldatore e sensore di temperatura. La verifica del riscaldatore viene abilitata automaticamente per ogni riscaldatore configurato sulla stampante. Usa le sezioni di verifica_riscaldatore per modificare le impostazioni predefinite. [verify_heater heater_config_name] #max_error: 120 # Il massimo \"errore di temperatura cumulativo\" prima di generare un # errore. Valori pi\u00f9 piccoli comportano un controllo pi\u00f9 rigoroso e valori # pi\u00f9 grandi consentono pi\u00f9 tempo prima che venga segnalato un errore. # Nello specifico la temperatura viene osservata una volta al secondo e # se \u00e8 prossima alla temperatura target viene azzerato un \"contatore errori\" # interno; in caso contrario, se la temperatura \u00e8 inferiore all'intervallo target, # il contatore viene aumentato della quantit\u00e0 in cui la temperatura riportata # differisce da tale intervallo. Se il contatore supera questo \"errore_max\", # viene generato un errore. Il valore predefinito \u00e8 120. #check_gain_time: # Questo controlla la verifica del riscaldatore durante il riscaldamento # iniziale. Valori pi\u00f9 piccoli comportano un controllo pi\u00f9 rigoroso e valori # pi\u00f9 grandi consentono pi\u00f9 tempo prima che venga segnalato un errore. # In particolare, durante il riscaldamento iniziale, fintanto che il riscaldatore # aumenta di temperatura entro questo intervallo di tempo (specificato in # secondi), il \"contatore errori\" interno viene azzerato. Il valore predefinito # \u00e8 20 secondi per gli estrusori e 60 secondi per heater_bed. #hysteresis: 5 # La differenza di temperatura massima (in gradi Celsius) rispetto a una # temperatura target considerata nell'intervallo del target. Questo controlla # nell'intervallo max_error. \u00c8 raro personalizzare questo valore. # L'impostazione predefinita \u00e8 5. #heating_gain: 2 # La temperatura minima (in gradi Celsius) di cui il riscaldatore deve # aumentare durante il check_gain_time. \u00c8 raro personalizzare questo valore. # L'impostazione predefinita \u00e8 2. [homing_heaters] \u00b6 Strumento per disabilitare i riscaldatori durante l'homing o la probing di un asse. [homing_heaters] #steppers: # Un elenco separato da virgole di stepper che dovrebbero causare # la disattivazione dei riscaldatori. L'impostazione predefinita \u00e8 # disabilitare i riscaldatori per qualsiasi spostamento di homing/sonda. # Esempio tipico: stepper_z #heaters: # Un elenco separato da virgole di riscaldatori da disabilitare # durante i movimenti di homing/probing. L'impostazione # predefinita \u00e8 disabilitare tutti i riscaldatori. # Esempio tipico: estrusore, letto riscaldatore [thermistor] \u00b6 Termistori personalizzati (si pu\u00f2 definire un numero qualsiasi di sezioni con un prefisso \"thermistor\"). \u00c8 possibile utilizzare un termistore personalizzato nel campo sensor_type di una sezione di configurazione del riscaldatore. (Ad esempio, se si definisce una sezione \"[thermistor my_thermistor]\", \u00e8 possibile utilizzare un \"sensor_type: my_thermistor\" quando si definisce un riscaldatore.) Assicurati di posizionare la sezione del termistore nel file di configurazione sopra il suo primo utilizzo in una sezione del riscaldatore . [thermistor my_thermistor] #temperature1: #resistance1: #temperature2: #resistance2: #temperature3: #resistance3: # Tre misure di resistenza (in Ohm) alle temperature date (in Celsius). # Le tre misurazioni verranno utilizzate per calcolare i coefficienti di # Steinhart-Hart per il termistore. Questi parametri devono essere # forniti quando si utilizza Steinhart-Hart per definire il termistore. #beta: # In alternativa, \u00e8 possibile definire temperatura1, resistenza1 e beta # per definire i parametri del termistore. Questo parametro deve # essere fornito quando si utilizza \"beta\" per definire il termistore. [adc_temperature] \u00b6 Sensori di temperatura ADC personalizzati (si pu\u00f2 definire un numero qualsiasi di sezioni con un prefisso \"adc_temperature\"). Ci\u00f2 consente di definire un sensore di temperatura personalizzato che misura una tensione su un pin del convertitore da analogico a digitale (ADC) e utilizza l'interpolazione lineare tra una serie di misurazioni di temperatura/tensione (o temperatura/resistenza) configurate per determinare la temperatura. Il sensore risultante pu\u00f2 essere utilizzato come tipo_sensore in una sezione riscaldatore. (Ad esempio, se si definisce una sezione \"[adc_temperature my_sensor]\", \u00e8 possibile utilizzare un \"sensor_type: my_sensor\" quando si definisce un riscaldatore.) Assicurati di posizionare la sezione del sensore nel file di configurazione sopra il suo primo utilizzo in una sezione del riscaldatore. [adc_temperature my_sensor] #temperature1: #voltage1: #temperature2: #voltage2: #... # A set of temperatures (in Celsius) and voltages (in Volts) to use # as reference when converting a temperature. A heater section using # this sensor may also specify adc_voltage and voltage_offset # parameters to define the ADC voltage (see \"Common temperature # amplifiers\" section for details). At least two measurements must # be provided. #temperature1: #resistance1: #temperature2: #resistance2: #... # Alternatively one may specify a set of temperatures (in Celsius) # and resistance (in Ohms) to use as reference when converting a # temperature. A heater section using this sensor may also specify a # pullup_resistor parameter (see \"extruder\" section for details). At # least two measurements must be provided. [heater_generic] \u00b6 Riscaldatori generici (si pu\u00f2 definire un numero qualsiasi di sezioni con il prefisso \"riscaldatore_generico\"). Questi riscaldatori si comportano in modo simile ai riscaldatori standard (estrusori, piatti riscaldati). Utilizzare il comando SET_HEATER_TEMPERATURE (consultare G-Codes per i dettagli) per impostare la temperatura target. [heater_generic my_generic_heater] #gcode_id: # L'ID da utilizzare quando si riporta la temperatura nel comando M105. # Questo parametro deve essere fornito. #max_power: #sensor_type: #sensor_pin: #smooth_time: #control: #pid_Kp: #pid_Ki: #pid_Kd: #pwm_cycle_time: #min_temp: #max_temp: # Vedere la sezione \"extruder\" per la definizione dei parametri sopra. [temperature_sensor] \u00b6 Sensori di temperatura generici. \u00c8 possibile definire un numero qualsiasi di sensori di temperatura aggiuntivi che vengono riportati tramite il comando M105. [temperature_sensor my_sensor] #sensor_type: #sensor_pin: #min_temp: #max_temp: # Vedi la sezione \"extruder\" per la definizione dei parametri # sopra indicati. #gcode_id: # Vedi la sezione \"heater_generic\" per la definizione dei # parametri sopra indicati. Sensori di temperatura \u00b6 Klipper include definizioni per molti tipi di sensori di temperatura. Questi sensori possono essere utilizzati in qualsiasi sezione di configurazione che richieda un sensore di temperatura (come una sezione [extruder] o [heater_bed] ). Termistori comuni \u00b6 Termistori comuni. I seguenti parametri sono disponibili nelle sezioni del riscaldatore che utilizzano uno di questi sensori. sensor_type: # Uno di \"EPCOS 100K B57560G104F\", \"ATC Semitec 104GT-2\", # \"ATC Semitec 104NT-4-R025H42G\", \"Generic 3950\", # \"Honeywell 100K 135-104LAG-J01\", \"NTC 100K MGB18-104F39050L32\", # \"SliceEngineering 450\", o \"TDK NTCG104LH104JT1\" sensor_pin: # Pin di ingresso analogico collegato al termistore. # Questo parametro deve essere fornito. #pullup_resistor: 4700 # La resistenza (in ohm) del pullup collegato al termistore. # Il valore predefinito \u00e8 4700 ohm. #inline_resistor: 0 # La resistenza (in ohm) di un resistore aggiuntivo (non a variazione di # calore) posizionato in linea con il termistore. \u00c8 raro impostare questo. # Il valore predefinito \u00e8 0 ohm. Amplificatori di temperatura comuni \u00b6 Amplificatori di temperatura comuni. I seguenti parametri sono disponibili nelle sezioni del riscaldatore che utilizzano uno di questi sensori. sensor_type: # Uno tra \"PT100 INA826\", \"AD595\", \"AD597\", \"AD8494\", \"AD8495\", # \"AD8496\", o \"AD8497\". sensor_pin: # Pin di ingresso analogico collegato al sensore. Questo parametro # deve essere fornito. #adc_voltage: 5.0 # La tensione di confronto dell'ADC (in Volt). Il valore predefinito # \u00e8 5 volt. #voltage_offset: 0 # L'offset di tensione ADC (in Volt). Il valore predefinito \u00e8 0. Sensore PT1000 collegato direttamente \u00b6 Sensore PT1000 collegato direttamente. I seguenti parametri sono disponibili nelle sezioni del riscaldatore che utilizzano uno di questi sensori. sensor_type: PT1000 sensor_pin: # Pin di ingresso analogico collegato al sensore. Questo parametro # deve essere fornito. #pullup_resistor: 4700 # La resistenza (in ohm) del pullup collegato al sensore. Il valore # predefinito \u00e8 4700 ohm. Sensori di temperatura MAXxxxxx \u00b6 Sensori temperatura MAXxxxxx con interfaccia periferica seriale (SPI). I seguenti parametri sono disponibili nelle sezioni del riscaldatore che utilizzano uno di questi tipi di sensore. sensor_type: # Uno tra \"MAX6675\", \"MAX31855\", \"MAX31856\", o \"MAX31865\". sensor_pin: # Il pin mcu collegato al pin di selezione del chip del sensore. # Questo parametro deve essere fornito. #spi_speed: 4000000 # La velocit\u00e0 SPI (in hz) da utilizzare durante la comunicazione # con il chip. Il valore predefinito \u00e8 4000000. #spi_bus: #spi_software_sclk_pin: #spi_software_mosi_pin: #spi_software_miso_pin: # Vedere la sezione \"impostazioni comuni SPI\" per una # descrizione dei parametri di cui sopra. #tc_type: K #tc_use_50Hz_filter: False #tc_averaging_count: 1 # I parametri di cui sopra controllano i parametri del sensore # dei chip MAX31856. I valori predefiniti per ciascun parametro # sono accanto al nome del parametro nell'elenco precedente. #rtd_nominal_r: 100 #rtd_reference_r: 430 #rtd_num_of_wires: 2 #rtd_use_50Hz_filter: False # I parametri di cui sopra controllano i parametri del sensore dei # chip MAX31865. I valori predefiniti per ciascun parametro sono # accanto al nome del parametro nell'elenco precedente. Sensore di temperatura BMP280/BME280/BME680 \u00b6 Sensori ambientali BMP280/BME280/BME680 con interfaccia I2C. Si noti che questi sensori non sono destinati all'uso con estrusori e letti riscaldanti, ma piuttosto per il monitoraggio della temperatura ambiente (C), della pressione (hPa), dell'umidit\u00e0 relativa (%)e di livello del gas per il BME680. Vedere sample-macros.cfg per una gcode_macro che pu\u00f2 essere utilizzata per riportare la pressione e l'umidit\u00e0 oltre alla temperatura. sensor_type: BME280 #i2c_address: # Il valore predefinito \u00e8 118 (0x76). Alcuni sensori BME280 hanno un # indirizzo di 119 (0x77). #i2c_mcu: #i2c_bus: #i2c_speed: # Vedere la sezione \"impostazioni comuni I2C\" per una descrizione # dei parametri di cui sopra. Sensore HTU21D \u00b6 Sensore ambientale con interfaccia a due fili (I2C) della famiglia HTU21D. Si noti che questo sensore non \u00e8 destinato all'uso con estrusori e letti riscaldanti, ma piuttosto per il monitoraggio della temperatura ambiente (C) e dell'umidit\u00e0 relativa(%). Vedere sample-macros.cfg per una gcode_macro che pu\u00f2 essere utilizzata per riportare l'umidit\u00e0 oltre alla temperatura. sensor_type: # Deve essere \"HTU21D\", \"SI7013\", \"SI7020\", \"SI7021\" o \"SHT21\" #i2c_address: # Il valore predefinito \u00e8 64 (0x40). #i2c_mcu: #i2c_bus: #i2c_speed: # Vedere la sezione \"impostazioni comuni I2C\" per una # descrizione dei parametri di cui sopra. #htu21d_hold_master: # Se il sensore pu\u00f2 trattenere il buf I2C durante la lettura. Se # True nessun'altra comunicazione bus pu\u00f2 essere eseguita mentre # la lettura \u00e8 in corso. L'impostazione predefinita \u00e8 False. #htu21d_resolution: # La risoluzione della lettura di temperatura e umidit\u00e0. # I valori validi sono: # 'TEMP14_HUM12' -> 14bit per Temp e 12bit per umidit\u00e0 # 'TEMP13_HUM10' -> 13bit per Temp e 10bit per umidit\u00e0 # 'TEMP12_HUM08' -> 12bit per Temp e 08bit per umidit\u00e0 # 'TEMP11_HUM11' -> 11bit per Temp e 11bit per umidit\u00e0 # L'impostazione predefinita \u00e8: \"TEMP11_HUM11\" #htu21d_report_time: # Intervallo in secondi tra le letture. Il valore predefinito \u00e8 30 Sensore di temperatura LM75 \u00b6 Sensori di temperatura (I2C) LM75/LM75A. Questi sensori hanno una gamma di -55~125 C, quindi sono utilizzabili ad es. monitoraggio della temperatura della camera. Possono anche funzionare come semplici controller per ventole/riscaldatori. sensor_type: LM75 #i2c_address: # Il valore predefinito \u00e8 72 (0x48). L'intervallo normale \u00e8 72-79 # (0x48-0x4F) e i 3 bit bassi dell'indirizzo sono configurati tramite # pin sul chip (di solito con ponticelli o cablati). #i2c_mcu: #i2c_bus: #i2c_speed: # Vedere la sezione \"impostazioni comuni I2C\" per una descrizione # dei parametri di cui sopra. #lm75_report_time: # Intervallo in secondi tra le letture. Il valore predefinito \u00e8 0.8 # con il minimo 0.5. Sensore di temperatura integrato nel microcontrollore \u00b6 I microcontrollori atsam, atsamd e stm32 contengono un sensore di temperatura interno. \u00c8 possibile utilizzare il sensore \"temperature_mcu\" per monitorare queste temperature. sensor_type: temperature_mcu #sensor_mcu: mcu # Il microcontrollore da cui leggere. L'impostazione predefinita \u00e8 \"mcu\". #sensor_temperature1: #sensor_adc1: # Specificare i due parametri precedenti (una temperatura in gradi # Celsius e un valore ADC come float compreso tra 0,0 e 1,0) per # calibrare la temperatura del microcontrollore. Ci\u00f2 potrebbe # migliorare la precisione della temperatura riportata su alcuni chip. # Un modo tipico per ottenere queste informazioni di calibrazione # consiste nel rimuovere completamente l'alimentazione dalla # stampante per alcune ore (per assicurarsi che sia alla temperatura # ambiente), quindi accenderla e utilizzare il comando QUERY_ADC # per ottenere una misurazione ADC. Utilizzare un altro sensore di # temperatura sulla stampante per trovare la temperatura ambiente # corrispondente. L'impostazione predefinita consiste nell'utilizzare # i dati di calibrazione di fabbrica sul microcontrollore (se applicabile) # o i valori nominali dalle specifiche del microcontrollore. #sensor_temperature2: #sensor_adc2: # Se viene specificato sensor_temperature1/sensor_adc1, \u00e8 anche # possibile specificare i dati di calibrazione sensor_temperature2/sensor_adc2. # Ci\u00f2 potrebbe fornire informazioni calibrate sulla \"curva della # temperatura\". L'impostazione predefinita consiste nell'utilizzare i dati # di calibrazione di fabbrica sul microcontrollore (se applicabile) o i # valori nominali dalle specifiche del microcontrollore. Sensore di temperatura host \u00b6 Temperatura dalla macchina (es. Raspberry Pi) che esegue il software host. sensor_type: temperature_host #sensor_path: # il percorso del file di sistema della temperatura. L'impostazione # predefinita \u00e8 \"/sys/class/thermal/thermal_zone0/temp\" che \u00e8 il file di # sistema della temperatura su un computer Raspberry Pi. Sensore di temperatura DS18B20 \u00b6 DS18B20 \u00e8 un sensore di temperatura digitale a 1 filo (w1). Si noti che questo sensore non \u00e8 destinato all'uso con estrusori e letti riscaldanti, ma piuttosto per il monitoraggio della temperatura ambiente (C). Questi sensori hanno una portata fino a 125 C, quindi sono utilizzabili ad es. monitoraggio della temperatura della camera. Possono anche funzionare come semplici controller per ventole/riscaldatori. I sensori DS18B20 sono supportati solo su \"host mcu\", ad es. il Raspberry Pi. \u00c8 necessario installare il modulo del kernel Linux w1-gpio. sensor_type: DS18B20 serial_no: # Ogni dispositivo a 1 filo ha un numero di serie univoco utilizzato per # identificare il dispositivo, solitamente nel formato 28-031674b175ff. Questo # parametro deve essere fornito. I dispositivi collegati a 1 filo possono essere # elencati utilizzando il seguente comando Linux: ls /sys/bus/w1/devices/ #ds18_report_time: # Intervallo in secondi tra le letture. Il valore predefinito \u00e8 3.0, con un # minimo di 1.0 #sensor_mcu: # Il microcontrollore da cui leggere. Deve essere host_mcu Ventole \u00b6 [fan] \u00b6 Ventola di raffreddamento della stampa. [fan] pin: # Pin di output che controlla la ventola. Questo parametro deve essere fornito. #max_power: 1.0 # La potenza massima (espressa come un valore compreso tra 0.0 e 1.0) a # cui pu\u00f2 essere impostato il pin. Il valore 1.0 consente di impostare il pin # completamente abilitato per periodi prolungati, mentre un valore di 0.5 # consentirebbe di abilitare il pin per non pi\u00f9 della met\u00e0 del tempo. Questa # impostazione pu\u00f2 essere utilizzata per limitare la potenza totale (per # periodi prolungati) della ventola. Se questo valore \u00e8 inferiore a 1.0, le # richieste di velocit\u00e0 della ventola verranno ridimensionate tra zero e # max_power (ad esempio, se max_power \u00e8 0.9 e viene richiesta una # velocit\u00e0 della ventola dell'80%, la potenza della ventola verr\u00e0 impostata # su 72%). L'impostazione predefinita \u00e8 1.0. #shutdown_speed: 0 # La velocit\u00e0 della ventola desiderata (espressa come valore da 0.0 a # 1.0) se il software del microcontrollore entra in uno stato di errore. # Il valore predefinito \u00e8 0. #cycle_time: 0.010 # La quantit\u00e0 di tempo (in secondi) per ogni ciclo di alimentazione PWM # alla ventola. Si consiglia di essere pari o superiore a 10 millisecondi # quando si utilizza il PWM basato su software. # Il valore predefinito \u00e8 0,010 secondi. #hardware_pwm: False # Abilitare questa opzione per utilizzare PWM hardware anzich\u00e9 PWM # software. La maggior parte delle ventole non funziona bene con PWM # hardware, quindi non \u00e8 consigliabile abilitarlo a meno che non vi sia # un requisito elettrico per passare a velocit\u00e0 molto elevate. Quando # si utilizza l'hardware PWM, il tempo di ciclo effettivo \u00e8 vincolato # dall'implementazione e pu\u00f2 essere notevolmente diverso dal tempo # di ciclo richiesto. L'impostazione predefinita \u00e8 False. #kick_start_time: 0.100 # Tempo (in secondi) per far funzionare la ventola a piena velocit\u00e0 # quando la si abilita per la prima volta o la si aumenta di oltre il 50% # (aiuta a far girare la ventola). Il valore predefinito \u00e8 0,100 secondi. #off_below: 0.0 # La velocit\u00e0 minima in input che alimenter\u00e0 la ventola (espressa # come un valore da 0.0 a 1.0). Quando viene richiesta una velocit\u00e0 # inferiore a off_below la ventola verr\u00e0 invece spenta. Questa # impostazione pu\u00f2 essere utilizzata per prevenire lo stallo della # ventola e per garantire che i kick start siano efficaci. # Il valore predefinito \u00e8 0.0. # # Questa impostazione deve essere ricalibrata ogni volta che # max_power viene regolato. Per calibrare questa impostazione, # inizia con off_below impostato su 0.0 e la ventola gira. Abbassare # gradualmente la velocit\u00e0 della ventola per determinare la velocit\u00e0 # di ingresso pi\u00f9 bassa che aziona la ventola in modo affidabile senza # stalli. Impostare off_below al duty cycle corrispondente a questo # valore (ad esempio, 12% -> 0,12) o leggermente superiore. #tachometer_pin: # Pin di ingresso contagiri per il monitoraggio della velocit\u00e0 della # ventola. In genere \u00e8 richiesto un pullup. Questo parametro \u00e8 facoltativo. #tachometer_ppr: 2 # Quando viene specificato tachometer_pin, questo \u00e8 il numero di # impulsi per giro del segnale del tachimetro. Per una ventola BLDC # questo \u00e8 normalmente la met\u00e0 del numero di poli. # L'impostazione predefinita \u00e8 2. #tachometer_poll_interval: 0.0015 # Quando viene specificato tachometer_pin, questo \u00e8 il periodo di polling # del pin del contagiri, in secondi. Il valore predefinito \u00e8 0.0015, che \u00e8 # abbastanza veloce per le ventole al di sotto di 10000 RPM a 2 PPR. Deve # essere inferiore a 30/(tachometer_ppr*rpm), con un certo margine, # dove rpm \u00e8 la velocit\u00e0 massima (in RPM) della ventola. #enable_pin: # Pin opzionale per abilitare l'alimentazione alla ventola. Questo pu\u00f2 # essere utile per le ventole con ingressi PWM dedicati. Alcune di queste # ventole rimangono accese anche allo 0% di ingresso PWM. In tal caso, # il pin PWM pu\u00f2 essere utilizzato normalmente e ad es. un FET commutato # a terra (pin della ventola standard) pu\u00f2 essere utilizzato per controllare # l'alimentazione alla ventola. [heater_fan] \u00b6 Ventole di raffreddamento del riscaldatore (si pu\u00f2 definire un numero qualsiasi di sezioni con un prefisso \"heater_fan\"). Una \"ventola riscaldatore\" \u00e8 una ventola che verr\u00e0 abilitata ogni volta che il riscaldatore associato \u00e8 attivo. Per impostazione predefinita, un heater_fan ha una velocit\u00e0 di spegnimento pari a max_power. [heater_fan my_nozzle_fan] #pin: #max_power: #shutdown_speed: #cycle_time: #hardware_pwm: #kick_start_time: #off_below: #tachometer_pin: #tachometer_ppr: #tachometer_poll_interval: #enable_pin: # Vedere la sezione \"fan\" per una descrizione dei parametri di cui sopra. #heater: extruder # Nome della sezione di configurazione che definisce il riscaldatore a cui # \u00e8 associato questa ventola. Se qui viene fornito un elenco di nomi di # riscaldatori separati da virgole, la ventola verr\u00e0 abilitata quando uno # qualsiasi dei riscaldatori indicati \u00e8 abilitato. # L'impostazione predefinita \u00e8 \"extruder\". #heater_temp: 50.0 # Una temperatura (in gradi Celsius) sotto la quale il riscaldatore deve # scendere prima che la ventola venga disattivata. # L'impostazione predefinita \u00e8 50 gradi Celsius. #fan_speed: 1.0 # La velocit\u00e0 della ventola (espressa come un valore compreso tra 0.0 e # 1.0) a cui verr\u00e0 impostato la ventola quando viene abilitato il relativo # riscaldatore. L'impostazione predefinita \u00e8 1.0 [controller_fan] \u00b6 Ventola di raffreddamento del controller (\u00e8 possibile definire un numero qualsiasi di sezioni con il prefisso \"controller_fan\"). Una \"ventola del controller\" \u00e8 una ventola che verr\u00e0 abilitata ogni volta che il riscaldatore associato o il driver stepper associato \u00e8 attivo. La ventola si fermer\u00e0 ogni volta che viene raggiunto un idle_timeout per garantire che non si verifichi alcun surriscaldamento dopo la disattivazione di un componente osservato. [controller_fan my_controller_fan] #pin: #max_power: #shutdown_speed: #cycle_time: #hardware_pwm: #kick_start_time: #off_below: #tachometer_pin: #tachometer_ppr: #tachometer_poll_interval: #enable_pin: # Vedere la sezione \"fan\" per una descrizione dei parametri di cui sopra. #fan_speed: 1.0 # La velocit\u00e0 della ventola (espressa come un valore compreso tra 0.0 e # 1.0) a cui verr\u00e0 impostata la ventola quando \u00e8 attivo un riscaldatore # o un driver passo-passo. L'impostazione predefinita \u00e8 1.0 #idle_timeout: # La quantit\u00e0 di tempo (in secondi) dopo che un driver passo-passo o # un riscaldatore \u00e8 stato attivo per la quale la ventola deve essere tenuta # in funzione. L'impostazione predefinita \u00e8 30 secondi. #idle_speed: # La velocit\u00e0 della ventola (espressa come un valore compreso tra 0.0 # e 1.0) a cui verr\u00e0 impostata la ventola quando era attivo un riscaldatore # o un driver passo-passo e prima che venga raggiunto l'idle_timeout. # L'impostazione predefinita \u00e8 fan_speed. #heater: #stepper: # Nome della sezione di configurazione che definisce il riscaldatore/ # stepper a cui \u00e8 associata questa ventola. Se qui viene fornito un # elenco separato da virgole di nomi di riscaldatori/stepper, la ventola # sar\u00e0 abilitata quando uno qualsiasi dei riscaldatori/stepper indicati # \u00e8 abilitato. Il riscaldatore predefinito \u00e8 \"estrusore\", lo stepper # predefinito sono tutti. [temperature_fan] \u00b6 Ventole di raffreddamento attivate dalla temperatura (\u00e8 possibile definire un numero qualsiasi di sezioni con un prefisso \"temperature_fan\"). Una \"ventola di temperatura\" \u00e8 una ventola che verr\u00e0 abilitata ogni volta che il sensore associato \u00e8 al di sopra di una temperatura impostata. Per impostazione predefinita, una ventola_temperatura ha una velocit\u00e0_di_arresto pari a potenza_massima. Per ulteriori informazioni, vedere command reference . [temperature_fan my_temp_fan] #pin: #max_power: #shutdown_speed: #cycle_time: #hardware_pwm: #kick_start_time: #off_below: #tachometer_pin: #tachometer_ppr: #tachometer_poll_interval: #enable_pin: # Vedere la sezione \"fan\" per una descrizione dei parametri di cui sopra. #sensor_type: #sensor_pin: #control: #max_delta: #min_temp: #max_temp: # Vedere la sezione \"extruder\" per una descrizione dei parametri di cui sopra. #pid_Kp: #pid_Ki: #pid_Kd: # Le impostazioni proporzionale (pid_Kp), integrale (pid_Ki) e derivata (pid_Kd) # per il sistema di controllo del feedback PID. Klipper valuta le impostazioni PID # con la seguente formula generale: fan_pwm = max_power - (Kp*e + Ki*integral(e) # - Kd*derivative(e)) / 255 Dove \"e\" \u00e8 \"target_temperature - measure_temperature\" # e \"fan_pwm\" \u00e8 la frequenza della ventola richiesta con 0.0 per spento e 1.0 al # massimo. I parametri pid_Kp, pid_Ki e pid_Kd devono essere forniti quando l# 'algoritmo di controllo PID \u00e8 abilitato. #pid_deriv_time: 2.0 # Un valore di tempo (in secondi) su cui le misurazioni della temperatura verranno # livellate quando si utilizza l'algoritmo di controllo PID. Ci\u00f2 pu\u00f2 ridurre l'impatto # del rumore di misurazione. Il valore predefinito \u00e8 2 secondi. #target_temp: 40.0 # Una temperatura (in Celsius) che sar\u00e0 la temperatura target. # L'impostazione predefinita \u00e8 40 gradi. #max_speed: 1.0 # La velocit\u00e0 della ventola (espressa come un valore compreso tra 0.0 e 1.0) a cui # verr\u00e0 impostata la ventola quando la temperatura del sensore supera il valore # impostato. L'impostazione predefinita \u00e8 1.0. #min_speed: 0.3 # La velocit\u00e0 minima della ventola (espressa come un valore compreso tra 0.0 e # 1.0) alla quale la ventola verr\u00e0 impostata per le ventole con temperatura PID. # Il valore predefinito \u00e8 0.3. #gcode_id: # Se impostata, la temperatura verr\u00e0 riportata nelle query M105 utilizzando l'id # fornito. L'impostazione predefinita \u00e8 di non riportare la temperatura tramite M105. [fan_generic] \u00b6 Ventola a controllo manuale (si pu\u00f2 definire un numero qualsiasi di sezioni con il prefisso \"fan_generic\"). La velocit\u00e0 di una ventola controllata manualmente viene impostata con SET_FAN_SPEED comando gcode . [fan_generic extruder_partfan] #pin: #max_power: #shutdown_speed: #cycle_time: #hardware_pwm: #kick_start_time: #off_below: #tachometer_pin: #tachometer_ppr: #tachometer_poll_interval: #enable_pin: # Vedere la sezione \"fan\" per una descrizione dei parametri di cui sopra. LEDs \u00b6 [led] \u00b6 Supporto per LED (e strisce LED) controllati tramite pin PWM del microcontrollore (si pu\u00f2 definire un numero qualsiasi di sezioni con un prefisso \"led\"). Per ulteriori informazioni, vedere command reference . [led my_led] #red_pin: #green_pin: #blue_pin: #white_pin: # Il pin che controlla il colore del LED specificato. Deve essere fornito # almeno uno dei parametri sopra indicati. #cycle_time: 0.010 # La quantit\u00e0 di tempo (in secondi) per ciclo PWM. Si consiglia che sia # pari o superiore a 10 millisecondi quando si utilizza il PWM basato # su software. Il valore predefinito \u00e8 0,010 secondi. #hardware_pwm: False # Abilitare questa opzione per utilizzare PWM hardware anzich\u00e9 PWM # software. Quando si utilizza l'hardware PWM, il tempo di ciclo effettivo # \u00e8 vincolato dall'implementazione e pu\u00f2 essere notevolmente diverso # dal tempo di ciclo richiesto. L'impostazione predefinita \u00e8 Falso. #initial_RED: 0.0 #initial_GREEN: 0.0 #initial_BLUE: 0.0 #initial_WHITE: 0.0 # Imposta il colore iniziale del LED. Ciascun valore deve essere # compreso tra 0,0 e 1,0. Il valore predefinito per ogni colore \u00e8 0. [neopixel] \u00b6 Supporto LED Neopixel (aka WS2812) (si pu\u00f2 definire un numero qualsiasi di sezioni con un prefisso \"neopixel\"). Per ulteriori informazioni, vedere riferimento comando . Si noti che l'implementazione di linux mcu non supporta attualmente i neopixel collegati direttamente. L'attuale design che utilizza l'interfaccia del kernel Linux non consente questo scenario perch\u00e9 l'interfaccia GPIO del kernel non \u00e8 sufficientemente veloce da fornire le frequenze di impulso richieste. [neopixel my_neopixel] pin: # Il pin collegato al neopixel. Questo parametro deve essere fornito. #chain_count: # Il numero di chip Neopixel che sono \"collegati a margherita\" al # pin fornito. Il valore predefinito \u00e8 1 (che indica che un solo # Neopixel \u00e8 collegato al pin). #color_order: GRB # Impostare l'ordine dei pixel richiesto dall'hardware del LED # (utilizzando una stringa contenente le lettere R, G, B, W con W # opzionale). In alternativa, questo pu\u00f2 essere un elenco separato # da virgole di pixel, uno per ogni LED nella catena. # L'impostazione predefinita \u00e8 GRB. #initial_RED: 0.0 #initial_GREEN: 0.0 #initial_BLUE: 0.0 #initial_WHITE: 0.0 # Vedere la sezione \"led\" per informazioni su questi parametri. [dotstar] \u00b6 Supporto LED Dotstar (conosciuti anche come APA102) (si pu\u00f2 definire un numero qualsiasi di sezioni con un prefisso \"dotstar\"). Per ulteriori informazioni, vedere command reference . [dotstar my_dotstar] data_pin: # Il pin connesso alla data line del dotstar. Questo parametro # deve essere fornito. clock_pin: # Il pin connesso alla clock line del dotstar. Questo parametro # deve essere fornito. #chain_count: # Vedere la sezione \"neopixel\" per informazioni su questo parametro. #initial_RED: 0.0 #initial_GREEN: 0.0 #initial_BLUE: 0.0 # Vedere la sezione \"led\" per informazioni su questo parametro. [pca9533] \u00b6 PCA9533 Supporto LED. Il PCA9533 viene utilizzato sulla scheda mightyboard. [pca9533 my_pca9533] #i2c_address: 98 # L'indirizzo i2c utilizzato dal chip sul bus i2c. Utilizzare 98 per # PCA9533/1, 99 per PCA9533/2. Il valore predefinito \u00e8 98. #i2c_mcu: #i2c_bus: #i2c_speed: # Vedere la sezione \"impostazioni comuni I2C\" per una # descrizione dei parametri di cui sopra. #initial_RED: 0.0 #initial_GREEN: 0.0 #initial_BLUE: 0.0 #initial_WHITE: 0.0 # Vedere la sezione \"led\" per informazioni su questi parametri. [pca9632] \u00b6 Supporto LED PCA9632. Il PCA9632 viene utilizzato su FlashForge Dreamer. [pca9632 my_pca9632] #i2c_address: 98 # L'indirizzo i2c utilizzato dal chip sul bus i2c. Pu\u00f2 essere 96, # 97, 98 o 99. Il valore predefinito \u00e8 98. #i2c_mcu: #i2c_bus: #i2c_speed: # Vedere la sezione \"impostazioni I2C comuni\" per una # descrizione dei parametri di cui sopra. #scl_pin: #sda_pin: # In alternativa, se il pca9632 non \u00e8 collegato a un bus I2C # hardware, \u00e8 possibile specificare i pin \"clock\" (pin scl) e \"data\" # (pin sda). L'impostazione predefinita prevede l'utilizzo # dell'hardware I2C. #color_order: RGBW # Impostare l'ordine dei pixel del LED (usando una stringa # contenente le lettere R, G, B, W). L'impostazione predefinita # \u00e8 RGBW. #initial_RED: 0.0 #initial_GREEN: 0.0 #initial_BLUE: 0.0 #initial_WHITE: 0.0 # Vedere la sezione \"led\" per informazioni su questi parametri. Servocomandi aggiuntivi, pulsanti e altri pin \u00b6 [servo] \u00b6 Servo (si pu\u00f2 definire un numero qualsiasi di sezioni con un prefisso \"servo\"). I servo possono essere controllati usando SET_SERVO comando g-code . Ad esempio: SET_SERVO SERVO=my_servo ANGLE=180 [servo my_servo] pin: # Pin di uscita PWM che controlla il servo. Questo parametro deve # essere fornito. #maximum_servo_angle: 180 # L'angolo massimo (in gradi) a cui questo servo pu\u00f2 essere impostato. # L'impostazione predefinita \u00e8 180 gradi. #minimum_pulse_width: 0.001 # La durata minima dell'impulso (in secondi). Questo dovrebbe # corrispondere a un angolo di 0 gradi. Il valore predefinito \u00e8 0.001 secondi. #maximum_pulse_width: 0.002 # La durata massima dell'impulso (in secondi). Questo dovrebbe # corrispondere a un angolo di maximum_servo_angle. Il valore # predefinito \u00e8 0.002 secondi. #initial_angle: # Angolo iniziale (in gradi) su cui impostare il servo. L'impostazione # predefinita \u00e8 di non inviare alcun segnale all'avvio. #initial_pulse_width: # Durata iniziale dell'impulso (in secondi) su cui impostare il servo. # (Questo \u00e8 valido solo se initial_angle non \u00e8 impostato.) # L'impostazione predefinita \u00e8 di non inviare alcun segnale all'avvio. [gcode_button] \u00b6 Esegui gcode quando un pulsante viene premuto o rilasciato (o quando un pin cambia stato). Puoi controllare lo stato del pulsante usando QUERY_BUTTON button=my_gcode_button . [gcode_button my_gcode_button] pin: # Il pin su cui \u00e8 collegato il pulsante. Questo parametro deve essere fornito. #analog_range: # Due resistenze separate da virgole (in Ohm) che specificano l'intervallo # di resistenza minimo e massimo per il pulsante. Se viene fornito # analog_range, il pin deve essere un pin con capacit\u00e0 analogica. # L'impostazione predefinita \u00e8 utilizzare digital gpio per il pulsante. #analog_pullup_resistor: # La resistenza di pullup (in Ohm) quando \u00e8 specificato analog_range. # Il valore predefinito \u00e8 4700 ohm. #press_gcode: # Un elenco di comandi G-Code da eseguire quando si preme il pulsante. # I modelli G-Code sono supportati. Questo parametro deve essere fornito. #release_gcode: # Un elenco di comandi G-Code da eseguire quando il pulsante viene # rilasciato. I modelli G-Code sono supportati. L'impostazione predefinita # \u00e8 di non eseguire alcun comando al rilascio di un pulsante. [output_pin] \u00b6 Pin di uscita configurabili in fase di run-time (\u00e8 possibile definire un numero qualsiasi di sezioni con un prefisso \"output_pin\"). I pin configurati qui verranno impostati come pin di output e sar\u00e0 possibile modificarli in fase di esecuzione utilizzando il comando esteso \"SET_PIN PIN=my_pin VALUE=.1\" comandi g-code . [output_pin my_pin] pin: # Il pin da configurare come output. # Questo parametro deve essere fornito. #pwm: False # Impostare se il pin di uscita deve essere in grado di modulare la # larghezza di impulso PWM. Se questo \u00e8 True, i campi del valore # dovrebbero essere compresi tra 0 e 1; se \u00e8 False i campi del valore # devono essere 0 o 1. Il valore predefinito \u00e8 False. #static_value: # Se \u00e8 valorizzato, il pin viene assegnato a questo valore all'avvio e # il pin non pu\u00f2 essere modificato durante il runtime. Un pin statico # utilizza una ram leggermente inferiore nel microcontrollore. # L'impostazione predefinita prevede l'utilizzo della configurazione # di runtime dei pin. #value: # Il valore su cui impostare inizialmente il pin durante la # configurazione dell'MCU. Il valore predefinito \u00e8 0 (per bassa tensione). #shutdown_value: # Il valore su cui impostare il pin su un evento di arresto dell'MCU. # Il valore predefinito \u00e8 0 (per bassa tensione). #maximum_mcu_duration: # La durata massima di un valore di non spegnimento pu\u00f2 essere # determinato dall'MCU senza un riconoscimento da parte dell'host. # Se l'host non riesce a tenere il passo con un aggiornamento, l'MCU # si spegner\u00e0 e imposter\u00e0 tutti i pin sui rispettivi valori di spegnimento. # Default: 0 (disabilitato) I valori abituali sono circa 5 secondi. #cycle_time: 0.100 # La quantit\u00e0 di tempo (in secondi) per ciclo PWM. Si consiglia di # essere pari o superiore a 10 millisecondi quando si utilizza il PWM # basato su software. Il valore predefinito \u00e8 0.100 secondi per i pin pwm. #hardware_pwm: False # Abilitare questa opzione per utilizzare PWM hardware anzich\u00e9 PWM # software. Quando si utilizza l'hardware PWM, il tempo di ciclo effettivo # \u00e8 vincolato dall'implementazione e pu\u00f2 essere notevolmente diverso # dal tempo di ciclo richiesto. L'impostazione predefinita \u00e8 Falso. #scale: # Questo parametro pu\u00f2 essere utilizzato per modificare il modo in cui # i parametri 'value' e 'shutdown_value' vengono interpretati per i pin # pwm. Se fornito, il parametro 'value' deve essere compreso tra 0.0 e # 'scale'. Questo pu\u00f2 essere utile quando si configura un pin PWM che # controlla un riferimento di tensione stepper. La \"scala\" pu\u00f2 essere # impostata sull'amperaggio dello stepper equivalente se il PWM fosse # completamente abilitato, quindi il parametro \"value\" pu\u00f2 essere # specificato utilizzando l'amperaggio desiderato per lo stepper. # L'impostazione predefinita \u00e8 di non ridimensionare il parametro 'value'. [static_digital_output] \u00b6 Pin di uscita digitali configurati staticamente (\u00e8 possibile definire un numero qualsiasi di sezioni con un prefisso \"static_digital_output\"). I pin configurati qui verranno impostati come uscita GPIO durante la configurazione dell'MCU. Non possono essere modificati in fase di esecuzione. [static_digital_output my_output_pins] pins: # Un elenco separato da virgole di pin da impostare come pin di # output GPIO. Il pin verr\u00e0 impostato su un livello alto a meno che il # nome del pin non sia preceduto da \"!\". Questo parametro deve # essere fornito. [multi_pin] \u00b6 Uscite a pin multipli (si pu\u00f2 definire un numero qualsiasi di sezioni con un prefisso \"multi_pin\"). Un output multi_pin crea un alias pin interno che pu\u00f2 modificare pi\u00f9 pin di output ogni volta che viene impostato il pin alias. Ad esempio, si potrebbe definire un oggetto \"[multi_pin my_fan]\" contenente due pin e quindi impostare \"pin=multi_pin:my_fan\" nella sezione \"[fan]\" - ad ogni cambio di ventola entrambi i pin di output verrebbero aggiornati. Questi alias non possono essere utilizzati con i pin del motore passo-passo. [multi_pin my_multi_pin] pins: # Un elenco separato da virgole di pin associati a questo alias. # Questo parametro deve essere fornito. Configurazione del driver TMC per stepper \u00b6 Configurazione dei driver per motori passo-passo Trinamic in modalit\u00e0 UART/SPI. Ulteriori informazioni si trovano nella TMC Drivers guide e nel command reference . [tmc2130] \u00b6 Configurare un driver per motore passo-passo TMC2130 tramite bus SPI. Per utilizzare questa funzione, definire una sezione di configurazione con un prefisso \"tmc2130\" seguito dal nome della sezione di configurazione dello stepper corrispondente (ad esempio, \"[tmc2130 stepper_x]\"). [tmc2130 stepper_x] cs_pin: # The pin corresponding to the TMC2130 chip select line. This pin # will be set to low at the start of SPI messages and raised to high # after the message completes. This parameter must be provided. #spi_speed: #spi_bus: #spi_software_sclk_pin: #spi_software_mosi_pin: #spi_software_miso_pin: # See the \"common SPI settings\" section for a description of the # above parameters. #chain_position: #chain_length: # These parameters configure an SPI daisy chain. The two parameters # define the stepper position in the chain and the total chain length. # Position 1 corresponds to the stepper that connects to the MOSI signal. # The default is to not use an SPI daisy chain. #interpolate: True # If true, enable step interpolation (the driver will internally # step at a rate of 256 micro-steps). This interpolation does # introduce a small systemic positional deviation - see # TMC_Drivers.md for details. The default is True. run_current: # The amount of current (in amps RMS) to configure the driver to use # during stepper movement. This parameter must be provided. #hold_current: # The amount of current (in amps RMS) to configure the driver to use # when the stepper is not moving. Setting a hold_current is not # recommended (see TMC_Drivers.md for details). The default is to # not reduce the current. #sense_resistor: 0.110 # The resistance (in ohms) of the motor sense resistor. The default # is 0.110 ohms. #stealthchop_threshold: 0 # The velocity (in mm/s) to set the \"stealthChop\" threshold to. When # set, \"stealthChop\" mode will be enabled if the stepper motor # velocity is below this value. The default is 0, which disables # \"stealthChop\" mode. #driver_MSLUT0: 2863314260 #driver_MSLUT1: 1251300522 #driver_MSLUT2: 608774441 #driver_MSLUT3: 269500962 #driver_MSLUT4: 4227858431 #driver_MSLUT5: 3048961917 #driver_MSLUT6: 1227445590 #driver_MSLUT7: 4211234 #driver_W0: 2 #driver_W1: 1 #driver_W2: 1 #driver_W3: 1 #driver_X1: 128 #driver_X2: 255 #driver_X3: 255 #driver_START_SIN: 0 #driver_START_SIN90: 247 # These fields control the Microstep Table registers directly. The optimal # wave table is specific to each motor and might vary with current. An # optimal configuration will have minimal print artifacts caused by # non-linear stepper movement. The values specified above are the default # values used by the driver. The value must be specified as a decimal integer # (hex form is not supported). In order to compute the wave table fields, # see the tmc2130 \"Calculation Sheet\" from the Trinamic website. #driver_IHOLDDELAY: 8 #driver_TPOWERDOWN: 0 #driver_TBL: 1 #driver_TOFF: 4 #driver_HEND: 7 #driver_HSTRT: 0 #driver_PWM_AUTOSCALE: True #driver_PWM_FREQ: 1 #driver_PWM_GRAD: 4 #driver_PWM_AMPL: 128 #driver_SGT: 0 # Set the given register during the configuration of the TMC2130 # chip. This may be used to set custom motor parameters. The # defaults for each parameter are next to the parameter name in the # above list. #diag0_pin: #diag1_pin: # The micro-controller pin attached to one of the DIAG lines of the # TMC2130 chip. Only a single diag pin should be specified. The pin # is \"active low\" and is thus normally prefaced with \"^!\". Setting # this creates a \"tmc2130_stepper_x:virtual_endstop\" virtual pin # which may be used as the stepper's endstop_pin. Doing this enables # \"sensorless homing\". (Be sure to also set driver_SGT to an # appropriate sensitivity value.) The default is to not enable # sensorless homing. [tmc2208] \u00b6 Configurare un driver per motore passo-passo TMC2208 (o TMC2224) tramite UART a filo singolo. Per utilizzare questa funzione, definire una sezione di configurazione con un prefisso \"tmc2208\" seguito dal nome della sezione di configurazione dello stepper corrispondente (ad esempio, \"[tmc2208 stepper_x]\"). [tmc2208 stepper_x] uart_pin: # Il pin collegato al PDN_UART del TMC2208 . # Questo parametro deve essere fornito. #tx_pin: # Se si utilizzano linee di ricezione e trasmissione separate per # comunicare con il driver, impostare uart_pin sul pin di ricezione e # tx_pin sul pin di trasmissione. L'impostazione predefinita \u00e8 usare uart_pin sia per la lettura che per la scrittura. #select_pins: # Un elenco separato da virgole di pin da impostare prima di accedere # all'UART tmc2208. Questo pu\u00f2 essere utile per configurare un mux # analogico per la comunicazione UART. L'impostazione predefinita \u00e8 # di non configurare alcun pin. #interpolate: True # Se True, abilita l'interpolazione del passo (il driver eseguir\u00e0 un passo # intero con 256 micropassi). Questa interpolazione # introduce una piccola deviazione posizionale sistemica - vedere # TMC_Drivers.md per i dettagli. L'impostazione predefinita \u00e8 True. run_current: # La quantit\u00e0 di corrente (in ampere RMS) per configurare il driver da # utilizzare durante il movimento passo-passo. # Questo parametro deve essere fornito. #hold_current: # La quantit\u00e0 di corrente (in ampere RMS) per configurare il driver da # utilizzare quando lo stepper non \u00e8 in movimento. L'impostazione di # hold_current non \u00e8 consigliata (consultare TMC_Drivers.md per i # dettagli). L'impostazione predefinita \u00e8 di non ridurre la corrente. #sense_resistor: 0.110 # La resistenza (in ohm) del resistore di rilevamento del motore. # Il valore predefinito \u00e8 0,110 ohm. #stealthchop_threshold: 0 # La velocit\u00e0 (in mm/s) su cui impostare la soglia \"stealthChop\". Se # impostata, la modalit\u00e0 \"stealthChop\" sar\u00e0 abilitata se la velocit\u00e0 del # motore passo-passo \u00e8 inferiore a questo valore. Il valore predefinito # \u00e8 0, che disabilita la modalit\u00e0 \"stealthChop\". #driver_IHOLDDELAY: 8 #driver_TPOWERDOWN: 20 #driver_TBL: 2 #driver_TOFF: 3 #driver_HEND: 0 #driver_HSTRT: 5 #driver_PWM_AUTOGRAD: True #driver_PWM_AUTOSCALE: True #driver_PWM_LIM: 12 #driver_PWM_REG: 8 #driver_PWM_FREQ: 1 #driver_PWM_GRAD: 14 #driver_PWM_OFS: 36 # Impostare il registro dato durante la configurazione del chip TMC2208. # Pu\u00f2 essere utilizzato per impostare parametri motore personalizzati. # I valori predefiniti per ciascun parametro sono accanto al nome del # parametro nell'elenco precedente. [tmc2209] \u00b6 Configurare un driver per motore passo-passo TMC2209 tramite UART a filo singolo. Per utilizzare questa funzione, definire una sezione di configurazione con un prefisso \"tmc2209\" seguito dal nome della sezione di configurazione dello stepper corrispondente (ad esempio, \"[tmc2209 stepper_x]\"). [tmc2209 stepper_x] uart_pin: #tx_pin: #select_pins: #interpolate: True run_current: #hold_current: #sense_resistor: 0.110 #stealthchop_threshold: 0 # Vedere la sezione \"tmc2208\" per la definizione di questi parametri. #uart_address: # L'indirizzo del chip TMC2209 per i messaggi UART (un numero intero # compreso tra 0 e 3). Viene in genere utilizzato quando pi\u00f9 chip TMC2209 # sono collegati allo stesso pin UART. Il valore predefinito \u00e8 zero #driver_IHOLDDELAY: 8 #driver_TPOWERDOWN: 20 #driver_TBL: 2 #driver_TOFF: 3 #driver_HEND: 0 #driver_HSTRT: 5 #driver_PWM_AUTOGRAD: True #driver_PWM_AUTOSCALE: True #driver_PWM_LIM: 12 #driver_PWM_REG: 8 #driver_PWM_FREQ: 1 #driver_PWM_GRAD: 14 #driver_PWM_OFS: 36 #driver_SGTHRS: 0 # Impostare il registro dato durante la configurazione del chip TMC2209. # Pu\u00f2 essere utilizzato per impostare parametri motore personalizzati. I # valori predefiniti per ciascun parametro sono accanto al nome del # parametro nell'elenco precedente. #diag_pin: # Il pin del microcontrollore collegato alla linea DIAG del chip TMC2209. # Il pin \u00e8 normalmente preceduto da \"^\" per abilitare un pullup. # L'impostazione di questo crea un pin virtuale \"tmc2209_stepper_x:virtual_endstop\" # che pu\u00f2 essere utilizzato come endstop_pin dello stepper. In questo modo # si abilita l'\"homing sensorless\". (Assicurarsi di impostare anche driver_SGTHRS # su un valore di sensibilit\u00e0 appropriato.) L'impostazione predefinita \u00e8 di non # abilitare l'homing sensorless. [tmc2660] \u00b6 Configurare un driver per motore passo-passo TMC2660 tramite bus SPI. Per utilizzare questa funzione, definire una sezione di configurazione con un prefisso tmc2660 seguito dal nome della sezione di configurazione dello stepper corrispondente (ad esempio, \"[tmc2660 stepper_x]\"). [tmc2660 stepper_x] cs_pin: # Il pin corrispondente al pin di selezione del chip TMC2660. Questo pin # verr\u00e0 impostato su basso all'inizio dei messaggi SPI e impostato su # alto al termine del trasferimento del messaggio. Questo parametro # deve essere fornito. #spi_speed: 4000000 # Frequenza bus SPI utilizzata per comunicare con il driver # passo-passo TMC2660. Il valore predefinito \u00e8 4000000. #spi_bus: #spi_software_sclk_pin: #spi_software_mosi_pin: #spi_software_miso_pin: # Vedere la sezione \"impostazioni comuni SPI\" per una descrizione # dei parametri di cui sopra. #interpolate: True # Se true, abilita l'interpolazione del passo (il driver eseguir\u00e0 un passo # interno a una velocit\u00e0 di 256 micropassi). Funziona solo se microsteps # \u00e8 impostato su 16. L'interpolazione introduce una piccola deviazione # posizionale sistemica - vedere TMC_Drivers.md per i dettagli. # L'impostazione predefinita \u00e8 Vero. run_current: # La quantit\u00e0 di corrente (in ampere RMS) utilizzata dal driver durante # il movimento passo-passo. Questo parametro deve essere fornito. #sense_resistor: # La resistenza (in ohm) del resistore di rilevamento del motore. # Questo parametro deve essere fornito. #idle_current_percent: 100 # La percentuale di run_current a cui il driver stepper sar\u00e0 ridotto allo # scadere del timeout di inattivit\u00e0 (\u00e8 necessario impostare il timeout # utilizzando una sezione di configurazione [idle_timeout]). La corrente # verr\u00e0 nuovamente aumentata una volta che lo stepper dovr\u00e0 muoversi # di nuovo. Assicurati di impostarlo su un valore sufficientemente alto in # modo che gli stepper non perdano la loro posizione. C'\u00e8 anche un piccolo # ritardo fino a quando la corrente non viene nuovamente aumentata, # quindi tienine conto quando comandi mosse veloci mentre lo stepper \u00e8 # al minimo. Il valore predefinito \u00e8 100 (nessuna riduzione). #driver_TBL: 2 #driver_RNDTF: 0 #driver_HDEC: 0 #driver_CHM: 0 #driver_HEND: 3 #driver_HSTRT: 3 #driver_TOFF: 4 #driver_SEIMIN: 0 #driver_SEDN: 0 #driver_SEMAX: 0 #driver_SEUP: 0 #driver_SEMIN: 0 #driver_SFILT: 0 #driver_SGT: 0 #driver_SLPH: 0 #driver_SLPL: 0 #driver_DISS2G: 0 #driver_TS2G: 3 # Imposta il parametro indicato durante la configurazione del chip TMC2660. # Questo pu\u00f2 essere utilizzato per impostare parametri del driver personalizzati. # Le impostazioni predefinite per ogni parametro sono accanto al nome del # parametro nell'elenco sopra. Vedere la scheda tecnica del TMC2660 su cosa # fa ogni parametro e quali sono le restrizioni sulle combinazioni di parametri. # Prestare particolare attenzione al registro CHOPCONF, dove l'impostazione # di CHM su zero o uno comporter\u00e0 modifiche al layout (il primo bit di HDEC) # viene interpretato come MSB di HSTRT in questo caso). [tmc5160] \u00b6 Configurare un driver per motore passo-passo TMC5160 tramite bus SPI. Per utilizzare questa funzione, definire una sezione di configurazione con un prefisso \"tmc5160\" seguito dal nome della sezione di configurazione dello stepper corrispondente (ad esempio, \"[tmc5160 stepper_x]\"). [tmc5160 stepper_x] cs_pin: # The pin corresponding to the TMC5160 chip select line. This pin # will be set to low at the start of SPI messages and raised to high # after the message completes. This parameter must be provided. #spi_speed: #spi_bus: #spi_software_sclk_pin: #spi_software_mosi_pin: #spi_software_miso_pin: # See the \"common SPI settings\" section for a description of the # above parameters. #chain_position: #chain_length: # These parameters configure an SPI daisy chain. The two parameters # define the stepper position in the chain and the total chain length. # Position 1 corresponds to the stepper that connects to the MOSI signal. # The default is to not use an SPI daisy chain. #interpolate: True # If true, enable step interpolation (the driver will internally # step at a rate of 256 micro-steps). The default is True. run_current: # The amount of current (in amps RMS) to configure the driver to use # during stepper movement. This parameter must be provided. #hold_current: # The amount of current (in amps RMS) to configure the driver to use # when the stepper is not moving. Setting a hold_current is not # recommended (see TMC_Drivers.md for details). The default is to # not reduce the current. #sense_resistor: 0.075 # The resistance (in ohms) of the motor sense resistor. The default # is 0.075 ohms. #stealthchop_threshold: 0 # The velocity (in mm/s) to set the \"stealthChop\" threshold to. When # set, \"stealthChop\" mode will be enabled if the stepper motor # velocity is below this value. The default is 0, which disables # \"stealthChop\" mode. #driver_MSLUT0: 2863314260 #driver_MSLUT1: 1251300522 #driver_MSLUT2: 608774441 #driver_MSLUT3: 269500962 #driver_MSLUT4: 4227858431 #driver_MSLUT5: 3048961917 #driver_MSLUT6: 1227445590 #driver_MSLUT7: 4211234 #driver_W0: 2 #driver_W1: 1 #driver_W2: 1 #driver_W3: 1 #driver_X1: 128 #driver_X2: 255 #driver_X3: 255 #driver_START_SIN: 0 #driver_START_SIN90: 247 # These fields control the Microstep Table registers directly. The optimal # wave table is specific to each motor and might vary with current. An # optimal configuration will have minimal print artifacts caused by # non-linear stepper movement. The values specified above are the default # values used by the driver. The value must be specified as a decimal integer # (hex form is not supported). In order to compute the wave table fields, # see the tmc2130 \"Calculation Sheet\" from the Trinamic website. #driver_IHOLDDELAY: 6 #driver_TPOWERDOWN: 10 #driver_TBL: 2 #driver_TOFF: 3 #driver_HEND: 2 #driver_HSTRT: 5 #driver_FD3: 0 #driver_TPFD: 4 #driver_CHM: 0 #driver_VHIGHFS: 0 #driver_VHIGHCHM: 0 #driver_DISS2G: 0 #driver_DISS2VS: 0 #driver_PWM_AUTOSCALE: True #driver_PWM_AUTOGRAD: True #driver_PWM_FREQ: 0 #driver_FREEWHEEL: 0 #driver_PWM_GRAD: 0 #driver_PWM_OFS: 30 #driver_PWM_REG: 4 #driver_PWM_LIM: 12 #driver_SGT: 0 #driver_SEMIN: 0 #driver_SEUP: 0 #driver_SEMAX: 0 #driver_SEDN: 0 #driver_SEIMIN: 0 #driver_SFILT: 0 # Set the given register during the configuration of the TMC5160 # chip. This may be used to set custom motor parameters. The # defaults for each parameter are next to the parameter name in the # above list. #diag0_pin: #diag1_pin: # The micro-controller pin attached to one of the DIAG lines of the # TMC5160 chip. Only a single diag pin should be specified. The pin # is \"active low\" and is thus normally prefaced with \"^!\". Setting # this creates a \"tmc5160_stepper_x:virtual_endstop\" virtual pin # which may be used as the stepper's endstop_pin. Doing this enables # \"sensorless homing\". (Be sure to also set driver_SGT to an # appropriate sensitivity value.) The default is to not enable # sensorless homing. Configurazione della corrente del motore passo-passo a run-time \u00b6 [ad5206] \u00b6 Digipot AD5206 configurati staticamente collegati tramite bus SPI (si pu\u00f2 definire un numero qualsiasi di sezioni con un prefisso \"ad5206\"). [ad5206 my_digipot] enable_pin: # The pin corresponding to the AD5206 chip select line. This pin # will be set to low at the start of SPI messages and raised to high # after the message completes. This parameter must be provided. #spi_speed: #spi_bus: #spi_software_sclk_pin: #spi_software_mosi_pin: #spi_software_miso_pin: # See the \"common SPI settings\" section for a description of the # above parameters. #channel_1: #channel_2: #channel_3: #channel_4: #channel_5: #channel_6: # The value to statically set the given AD5206 channel to. This is # typically set to a number between 0.0 and 1.0 with 1.0 being the # highest resistance and 0.0 being the lowest resistance. However, # the range may be changed with the 'scale' parameter (see below). # If a channel is not specified then it is left unconfigured. #scale: # This parameter can be used to alter how the 'channel_x' parameters # are interpreted. If provided, then the 'channel_x' parameters # should be between 0.0 and 'scale'. This may be useful when the # AD5206 is used to set stepper voltage references. The 'scale' can # be set to the equivalent stepper amperage if the AD5206 were at # its highest resistance, and then the 'channel_x' parameters can be # specified using the desired amperage value for the stepper. The # default is to not scale the 'channel_x' parameters. [mcp4451] \u00b6 Digipot MCP4451 configurato staticamente collegato tramite bus I2C (si pu\u00f2 definire un numero qualsiasi di sezioni con un prefisso \"mcp4451\"). [mcp4451 my_digipot] i2c_address: # L'indirizzo i2c utilizzato dal chip sul bus i2c. Questo parametro deve # essere fornito. #i2c_mcu: #i2c_bus: #i2c_speed: # Vedere la sezione \"impostazioni I2C comuni\" per una descrizione # dei parametri di cui sopra. #wiper_0: #wiper_1: #wiper_2: #wiper_3: # Il valore su cui impostare staticamente il \"wiper\" MCP4451 # specificato. Questo \u00e8 in genere impostato su un numero compreso # tra 0,0 e 1,0 con 1,0 come resistenza pi\u00f9 alta e 0,0 come resistenza # pi\u00f9 bassa. Tuttavia, l'intervallo pu\u00f2 essere modificato con il parametro # 'scale' (vedi sotto). Se non viene specificato un wiper, non viene # configurato. #scale: # Questo parametro pu\u00f2 essere utilizzato per modificare il modo in # cui vengono interpretati i parametri 'wiper_x'. Se forniti, i parametri # 'wiper_x' dovrebbero essere compresi tra 0.0 e 'scale'. Questo pu\u00f2 # essere utile quando l'MCP4451 viene utilizzato per impostare i # riferimenti di tensione stepper. La \"scala\" pu\u00f2 essere impostata # sull'amperaggio stepper equivalente se l'MCP4451 fosse alla sua # massima resistenza, quindi i parametri \"wiper_x\" possono essere # specificati utilizzando il valore di amperaggio desiderato per lo # stepper. L'impostazione predefinita \u00e8 di non ridimensionare i # parametri 'wiper_x'. [mcp4728] \u00b6 Convertitore digitale-analogico MCP4728 in configurazione statica collegato tramite bus I2C (\u00e8 possibile definire un numero qualsiasi di sezioni con prefisso \"mcp4728\"). [mcp4728 my_dac] #i2c_address: 96 # L'indirizzo i2c utilizzato dal chip sul bus i2c. Il valore predefinito # \u00e8 96. #i2c_mcu: #i2c_bus: #i2c_speed: # Vedere la sezione \"impostazioni I2C comuni\" per una descrizione # dei parametri di cui sopra. #channel_a: #channel_b: #channel_c: #channel_d: # Il valore su cui impostare staticamente il canale MCP4728 # specificato. Questo \u00e8 in genere impostato su un numero compreso # tra 0,0 e 1,0 con 1,0 come tensione pi\u00f9 alta (2,048 V) e 0,0 come # tensione pi\u00f9 bassa. Tuttavia, l'intervallo pu\u00f2 essere modificato con # il parametro 'scale' (vedi sotto). Se un canale non \u00e8 specificato, # non viene configurato. #scale: # Questo parametro pu\u00f2 essere utilizzato per modificare il modo # in cui vengono interpretati i parametri 'channel_x'. Se forniti, i # parametri 'channel_x' dovrebbero essere compresi tra 0.0 e 'scale'. # Questo pu\u00f2 essere utile quando l'MCP4728 viene utilizzato per # impostare i riferimenti di tensione stepper. La \"scala\" pu\u00f2 essere # impostata sull'amperaggio stepper equivalente se l'MCP4728 # fosse alla sua tensione pi\u00f9 alta (2,048 V), e quindi i parametri # \"channel_x\" possono essere specificati utilizzando il valore di # amperaggio desiderato per lo stepper. L'impostazione # predefinita \u00e8 di non ridimensionare i parametri 'channel_x'. [mcp4018] \u00b6 Digipot MCP4018 configurato staticamente collegato tramite due pin gpio \"bit banging\" (si pu\u00f2 definire un numero qualsiasi di sezioni con un prefisso \"mcp4018\"). [mcp4018 my_digipot] scl_pin: # Il pin \"clock\" SCL. Questo parametro deve essere fornito. sda_pin: # Il pin \"dati\" SDA. Questo parametro deve essere fornito. wiper: # Il valore su cui impostare staticamente il \"Wiper\" MCP4018 # specificato. Questo \u00e8 in genere impostato su un numero compreso # tra 0,0 e 1,0 con 1,0 come resistenza pi\u00f9 alta e 0,0 come resistenza # pi\u00f9 bassa. Tuttavia, l'intervallo pu\u00f2 essere modificato con il # parametro 'scale' (vedi sotto). Questo parametro deve essere fornito. #scale: # Questo parametro pu\u00f2 essere utilizzato per modificare il modo in # cui viene interpretato il parametro 'wiper'. Se fornito, il parametro # 'wiper' dovrebbe essere compreso tra 0.0 e 'scale'. Questo pu\u00f2 essere # utile quando l'MCP4018 viene utilizzato per impostare i riferimenti di # tensione stepper. La \"scala\" pu\u00f2 essere impostata sull'amperaggio # stepper equivalente se l'MCP4018 \u00e8 alla sua massima resistenza, # quindi \u00e8 possibile specificare il parametro \"wiper\" utilizzando il # valore di amperaggio desiderato per lo stepper. L'impostazione # predefinita \u00e8 di non ridimensionare il parametro 'wiper'. Supporto display \u00b6 [display] \u00b6 Supporto per un display collegato al microcontrollore. [display] lcd_type: # The type of LCD chip in use. This may be \"hd44780\", \"hd44780_spi\", # \"st7920\", \"emulated_st7920\", \"uc1701\", \"ssd1306\", or \"sh1106\". # See the display sections below for information on each type and # additional parameters they provide. This parameter must be # provided. #display_group: # The name of the display_data group to show on the display. This # controls the content of the screen (see the \"display_data\" section # for more information). The default is _default_20x4 for hd44780 # displays and _default_16x4 for other displays. #menu_timeout: # Timeout for menu. Being inactive this amount of seconds will # trigger menu exit or return to root menu when having autorun # enabled. The default is 0 seconds (disabled) #menu_root: # Name of the main menu section to show when clicking the encoder # on the home screen. The defaults is __main, and this shows the # the default menus as defined in klippy/extras/display/menu.cfg #menu_reverse_navigation: # When enabled it will reverse up and down directions for list # navigation. The default is False. This parameter is optional. #encoder_pins: # The pins connected to encoder. 2 pins must be provided when using # encoder. This parameter must be provided when using menu. #encoder_steps_per_detent: # How many steps the encoder emits per detent (\"click\"). If the # encoder takes two detents to move between entries or moves two # entries from one detent, try changing this. Allowed values are 2 # (half-stepping) or 4 (full-stepping). The default is 4. #click_pin: # The pin connected to 'enter' button or encoder 'click'. This # parameter must be provided when using menu. The presence of an # 'analog_range_click_pin' config parameter turns this parameter # from digital to analog. #back_pin: # The pin connected to 'back' button. This parameter is optional, # menu can be used without it. The presence of an # 'analog_range_back_pin' config parameter turns this parameter from # digital to analog. #up_pin: # The pin connected to 'up' button. This parameter must be provided # when using menu without encoder. The presence of an # 'analog_range_up_pin' config parameter turns this parameter from # digital to analog. #down_pin: # The pin connected to 'down' button. This parameter must be # provided when using menu without encoder. The presence of an # 'analog_range_down_pin' config parameter turns this parameter from # digital to analog. #kill_pin: # The pin connected to 'kill' button. This button will call # emergency stop. The presence of an 'analog_range_kill_pin' config # parameter turns this parameter from digital to analog. #analog_pullup_resistor: 4700 # The resistance (in ohms) of the pullup attached to the analog # button. The default is 4700 ohms. #analog_range_click_pin: # The resistance range for a 'enter' button. Range minimum and # maximum comma-separated values must be provided when using analog # button. #analog_range_back_pin: # The resistance range for a 'back' button. Range minimum and # maximum comma-separated values must be provided when using analog # button. #analog_range_up_pin: # The resistance range for a 'up' button. Range minimum and maximum # comma-separated values must be provided when using analog button. #analog_range_down_pin: # The resistance range for a 'down' button. Range minimum and # maximum comma-separated values must be provided when using analog # button. #analog_range_kill_pin: # The resistance range for a 'kill' button. Range minimum and # maximum comma-separated values must be provided when using analog # button. display hd44780 \u00b6 Informazioni sulla configurazione dei display hd44780 (utilizzati nei display di tipo \"RepRapDiscount 2004 Smart Controller\"). [display] lcd_type: hd44780 # Set to \"hd44780\" for hd44780 displays. rs_pin: e_pin: d4_pin: d5_pin: d6_pin: d7_pin: # The pins connected to an hd44780 type lcd. These parameters must # be provided. #hd44780_protocol_init: True # Perform 8-bit/4-bit protocol initialization on an hd44780 display. # This is necessary on real hd44780 devices. However, one may need # to disable this on some \"clone\" devices. The default is True. #line_length: # Set the number of characters per line for an hd44780 type lcd. # Possible values are 20 (default) and 16. The number of lines is # fixed to 4. ... display hd44780_spi \u00b6 Informazioni sulla configurazione di un display hd44780_spi - un display 20x04 controllato tramite uno \"shift register\" hardware (che viene utilizzato nelle stampanti basate su mightyboard). [display] lcd_type: hd44780_spi # Set to \"hd44780_spi\" for hd44780_spi displays. latch_pin: spi_software_sclk_pin: spi_software_mosi_pin: spi_software_miso_pin: # The pins connected to the shift register controlling the display. # The spi_software_miso_pin needs to be set to an unused pin of the # printer mainboard as the shift register does not have a MISO pin, # but the software spi implementation requires this pin to be # configured. #hd44780_protocol_init: True # Perform 8-bit/4-bit protocol initialization on an hd44780 display. # This is necessary on real hd44780 devices. However, one may need # to disable this on some \"clone\" devices. The default is True. #line_length: # Set the number of characters per line for an hd44780 type lcd. # Possible values are 20 (default) and 16. The number of lines is # fixed to 4. ... display st7920 \u00b6 Informazioni sulla configurazione dei display st7920 (utilizzati nei display di tipo \"RepRapDiscount 12864 Full Graphic Smart Controller\"). [display] lcd_type: st7920 # Set to \"st7920\" for st7920 displays. cs_pin: sclk_pin: sid_pin: # The pins connected to an st7920 type lcd. These parameters must be # provided. ... display emulazione emulated_st7920 \u00b6 Informazioni sulla configurazione di un display st7920 emulato, presenti in alcuni \"dispositivi touchscreen da 2,4 pollici\" e simili. [display] lcd_type: emulated_st7920 # Set to \"emulated_st7920\" for emulated_st7920 displays. en_pin: spi_software_sclk_pin: spi_software_mosi_pin: spi_software_miso_pin: # The pins connected to an emulated_st7920 type lcd. The en_pin # corresponds to the cs_pin of the st7920 type lcd, # spi_software_sclk_pin corresponds to sclk_pin and # spi_software_mosi_pin corresponds to sid_pin. The # spi_software_miso_pin needs to be set to an unused pin of the # printer mainboard as the st7920 as no MISO pin but the software # spi implementation requires this pin to be configured. ... display uc1701 \u00b6 Informazioni sulla configurazione dei display uc1701 (utilizzati nei display di tipo \"MKS Mini 12864\"). [display] lcd_type: uc1701 # Set to \"uc1701\" for uc1701 displays. cs_pin: a0_pin: # The pins connected to a uc1701 type lcd. These parameters must be # provided. #rst_pin: # The pin connected to the \"rst\" pin on the lcd. If it is not # specified then the hardware must have a pull-up on the # corresponding lcd line. #contrast: # The contrast to set. The value may range from 0 to 63 and the # default is 40. ... display ssd1306 e sh1106 \u00b6 Informazioni sulla configurazione dei display ssd1306 e sh1106. [display] lcd_type: # Set to either \"ssd1306\" or \"sh1106\" for the given display type. #i2c_mcu: #i2c_bus: #i2c_speed: # Optional parameters available for displays connected via an i2c # bus. See the \"common I2C settings\" section for a description of # the above parameters. #cs_pin: #dc_pin: #spi_speed: #spi_bus: #spi_software_sclk_pin: #spi_software_mosi_pin: #spi_software_miso_pin: # The pins connected to the lcd when in \"4-wire\" spi mode. See the # \"common SPI settings\" section for a description of the parameters # that start with \"spi_\". The default is to use i2c mode for the # display. #reset_pin: # A reset pin may be specified on the display. If it is not # specified then the hardware must have a pull-up on the # corresponding lcd line. #contrast: # The contrast to set. The value may range from 0 to 256 and the # default is 239. #vcomh: 0 # Set the Vcomh value on the display. This value is associated with # a \"smearing\" effect on some OLED displays. The value may range # from 0 to 63. Default is 0. #invert: False # TRUE inverts the pixels on certain OLED displays. The default is # False. #x_offset: 0 # Set the horizontal offset value on SH1106 displays. The default is # 0. ... [display_data] \u00b6 Supporto per la visualizzazione di dati personalizzati su uno schermo LCD. \u00c8 possibile creare un numero qualsiasi di gruppi di visualizzazione e un numero qualsiasi di elementi di dati in quei gruppi. Il display mostrer\u00e0 tutti gli elementi di dati per un determinato gruppo se l'opzione display_group nella sezione [display] \u00e8 impostata sul nome del gruppo specificato. Viene creato automaticamente un default set of display groups . \u00c8 possibile sostituire o estendere questi elementi display_data sovrascrivendo i valori predefiniti nel file di configurazione principale printer.cfg . [display_data my_group_name my_data_name] position: # Comma separated row and column of the display position that should # be used to display the information. This parameter must be # provided. text: # The text to show at the given position. This field is evaluated # using command templates (see docs/Command_Templates.md). This # parameter must be provided. [display_template] \u00b6 Visualizza il testo dei dati \"macro\" (\u00e8 possibile definire un numero qualsiasi di sezioni con un prefisso display_template). Per informazioni sul template, vedere il documento template di comandi . Questa funzione consente di ridurre le definizioni ripetitive nelle sezioni display_data. Si pu\u00f2 usare la funzione incorporata render() nelle sezioni display_data per valutare un template. Per esempio, se si dovesse definire [display_template my_template] allora si potrebbe usare { render('my_template') } in una sezione display_data. Questa funzione pu\u00f2 essere utilizzata anche per aggiornamenti LED continui utilizzando il comando SET_LED_TEMPLATE . [display_template my_template_name] #param_<name>: # One may specify any number of options with a \"param_\" prefix. The # given name will be assigned the given value (parsed as a Python # literal) and will be available during macro expansion. If the # parameter is passed in the call to render() then that value will # be used during macro expansion. For example, a config with # \"param_speed = 75\" might have a caller with # \"render('my_template_name', param_speed=80)\". Parameter names may # not use upper case characters. text: # The text to return when the this template is rendered. This field # is evaluated using command templates (see # docs/Command_Templates.md). This parameter must be provided. [display_glyph] \u00b6 Visualizza un glifo personalizzato sui display che lo supportano. Al nome dato verranno assegnati i dati di visualizzazione dati che possono quindi essere referenziati nei modelli di visualizzazione con il loro nome circondato da due simboli \"tilde\" per esempio ~my_display_glyph~ Vedere sample-glyphs.cfg per alcuni esempi. [display_glyph my_display_glyph] #data: # The display data, stored as 16 lines consisting of 16 bits (1 per # pixel) where '.' is a blank pixel and '*' is an on pixel (e.g., # \"****************\" to display a solid horizontal line). # Alternatively, one can use '0' for a blank pixel and '1' for an on # pixel. Put each display line into a separate config line. The # glyph must consist of exactly 16 lines with 16 bits each. This # parameter is optional. #hd44780_data: # Glyph to use on 20x4 hd44780 displays. The glyph must consist of # exactly 8 lines with 5 bits each. This parameter is optional. #hd44780_slot: # The hd44780 hardware index (0..7) to store the glyph at. If # multiple distinct images use the same slot then make sure to only # use one of those images in any given screen. This parameter is # required if hd44780_data is specified. [display my_extra_display] \u00b6 Se in printer.cfg \u00e8 stata definita una sezione primaria [display] come mostrato sopra, \u00e8 possibile definire pi\u00f9 display ausiliari. Si noti che i display ausiliari attualmente non supportano la funzionalit\u00e0 del menu, quindi non supportano le opzioni del \"menu\" o la configurazione dei pulsanti. [display my_extra_display] # Vedere la sezione \"display\" per i parametri disponibili. [menu] \u00b6 Menu display lcd personalizzabili. Viene creato automaticamente un default set of menus . \u00c8 possibile sostituire o estendere il menu sovrascrivendo le impostazioni predefinite nel file di configurazione principale printer.cfg . Consulta il command template document per informazioni sugli attributi di menu disponibili durante il rendering del modello. # Common parameters available for all menu config sections. #[menu __some_list __some_name] #type: disabled # Permanently disabled menu element, only required attribute is 'type'. # Allows you to easily disable/hide existing menu items. #[menu some_name] #type: # One of command, input, list, text: # command - basic menu element with various script triggers # input - same like 'command' but has value changing capabilities. # Press will start/stop edit mode. # list - it allows for menu items to be grouped together in a # scrollable list. Add to the list by creating menu # configurations using \"some_list\" as a prefix - for # example: [menu some_list some_item_in_the_list] # vsdlist - same as 'list' but will append files from virtual sdcard # (will be removed in the future) #name: # Name of menu item - evaluated as a template. #enable: # Template that evaluates to True or False. #index: # Position where an item needs to be inserted in list. By default # the item is added at the end. #[menu some_list] #type: list #name: #enable: # See above for a description of these parameters. #[menu some_list some_command] #type: command #name: #enable: # See above for a description of these parameters. #gcode: # Script to run on button click or long click. Evaluated as a # template. #[menu some_list some_input] #type: input #name: #enable: # See above for a description of these parameters. #input: # Initial value to use when editing - evaluated as a template. # Result must be float. #input_min: # Minimum value of range - evaluated as a template. Default -99999. #input_max: # Maximum value of range - evaluated as a template. Default 99999. #input_step: # Editing step - Must be a positive integer or float value. It has # internal fast rate step. When \"(input_max - input_min) / # input_step > 100\" then fast rate step is 10 * input_step else fast # rate step is same input_step. #realtime: # This attribute accepts static boolean value. When enabled then # gcode script is run after each value change. The default is False. #gcode: # Script to run on button click, long click or value change. # Evaluated as a template. The button click will trigger the edit # mode start or end. Sensori di filamento \u00b6 [filament_switch_sensor] \u00b6 Sensore del filamento a interruttore. Supporto per l'inserimento del filamento e il rilevamento dell'esaurimento tramite un sensore interruttore, come un interruttore di fine corsa. Per ulteriori informazioni, vedere command reference . [filament_switch_sensor my_sensor] #pause_on_runout: True # Se impostato su True, verr\u00e0 eseguita una PAUSA immediatamente # dopo il rilevamento di un'eccentricit\u00e0. Si noti che se pause_on_runout # \u00e8 False e runout_gcode viene omesso, il rilevamento dell'eccentricit\u00e0 # \u00e8 disabilitato. L'impostazione predefinita \u00e8 Vero. #runout_gcode: # Un elenco di comandi G-Code da eseguire dopo il rilevamento di # un'esaurimento del filamento. Vedi docs/Command_Templates.md # per il formato G-Code. Se pause_on_runout \u00e8 impostato su True, # questo codice G verr\u00e0 eseguito al termine della PAUSA. # L'impostazione predefinita \u00e8 di non eseguire alcun comando G-Code. #insert_gcode: # Un elenco di comandi G-Code da eseguire dopo il rilevamento # dell'inserimento di filamento. Vedi docs/Command_Templates.md # per il formato G-Code. L'impostazione predefinita non prevede # l'esecuzione di alcun comando G-Code, che disabilita il rilevamento # dell'inserimento. #event_delay: 3.0 # Il tempo minimo in secondi per ritardare tra gli eventi. Gli eventi # attivati durante questo periodo di tempo verranno ignorati # silenziosamente. L'impostazione predefinita \u00e8 3 secondi. #pause_delay: 0.5 # Il tempo di ritardo, in secondi, tra l'invio del comando pause e # l'esecuzione di runout_gcode. Potrebbe essere utile aumentare # questo ritardo se OctoPrint mostra uno strano comportamento # di pausa. Il valore predefinito \u00e8 0,5 secondi. #switch_pin: # Il pin su cui \u00e8 collegato l'interruttore. # Questo parametro deve essere fornito. [filament_motion_sensor] \u00b6 Sensore di movimento del filamento. Supporto per l'inserimento del filamento e il rilevamento dell'esaurimento mediante un codificatore che commuta il pin di uscita durante il movimento del filamento attraverso il sensore. Per ulteriori informazioni, vedere command reference . [filament_motion_sensor my_sensor] detection_length: 7.0 # La lunghezza minima di filamento tirato attraverso il sensore # per attivare un cambio di stato su switch_pin # Il default \u00e8 7 mm. extruder: # Nome della sezione extruder section con cui questo sensore \u00e8 associato. # Questo parametro deve essere fornito. switch_pin: #pause_on_runout: #runout_gcode: #insert_gcode: #event_delay: #pause_delay: # Vedere la sezione \"filament_switch_sensor\" per la descrizione dei # parametri riportati sopra. [tsl1401cl_filament_width_sensor] \u00b6 Sensore di larghezza del filamento basato su TSLl401CL. Consulta la guida per ulteriori informazioni. sl1401cl_filament_width_sensor] #pin: #diametro nominale del filamento predefinito: 1,75 (mm) # Differenza massima consentita del diametro del filamento in mm. #max_difference: 0.2 # La distanza dal sensore alla camera di fusione in mm. #measurement_delay: 100 [hall_filament_width_sensor] \u00b6 Sensore di larghezza del filamento ad effetto Hall (vedere Sensore di larghezza del filamento Hall ). [hall_filament_width_sensor] adc1: adc2: # Pin di ingresso analogico collegati al sensore. # Questi parametri devono essere forniti. #cal_dia1: 1.50 #cal_dia2: 2.00 # I valori di calibrazione (in mm) per i sensori. Il valore predefinito # \u00e8 1.50 per cal_dia1 e 2.00 per cal_dia2. #raw_dia1: 9500 #raw_dia2: 10500 # I valori di calibrazione grezzi per i sensori. Il valore predefinito \u00e8 # 9500 per raw_dia1 e 10500 per raw_dia2. #default_nominal_filament_diameter: 1.75 # Il diametro nominale del filamento. # Questo parametro deve essere fornito. #max_difference: 0.200 # Differenza massima consentita del diametro del filamento in # millimetri (mm). Se la differenza tra il diametro nominale del # filamento e l'uscita del sensore \u00e8 maggiore di +- max_difference, # il moltiplicatore di estrusione viene riportato a %100. # Il valore predefinito \u00e8 0,200. #measurement_delay: 70 # La distanza dal sensore alla camera di fusione/hot-end in # millimetri (mm). Il filamento tra il sensore e l'hot-end verr\u00e0 # trattato come default_nominal_filament_diameter. Il modulo # host funziona con la logica FIFO. Mantiene ogni valore e posizione # del sensore in un array e li riporta nella posizione corretta. # Questo parametro deve essere fornito. #enable: False # Sensore abilitato o disabilitato dopo l'accensione. L'impostazione predefinita \u00e8 disabilitare. #measurement_interval: 10 # La distanza approssimativa (in mm) tra le letture del sensore. # Il valore predefinito \u00e8 10 mm. #logging: False # Il log esterno al terminale e klipper.log pu\u00f2 essere # attivato|off tramite comando. #min_diameter: 1.0 # Diametro minimo per trigger filament_switch_sensor virtuale. #use_current_dia_while_delay: False # Utilizzare il diametro attuale invece del diametro nominale # mentre il ritardo di misurazione non \u00e8 trascorso. #pause_on_runout: #runout_gcode: #insert_gcode: #event_delay: #pause_delay: # Vedere la sezione \"filament_switch_sensor\" per una # descrizione dei parametri di cui sopra. Supporto hardware per specifica scheda \u00b6 [sx1509] \u00b6 Configurare un'espansione SX1509 da I2C a GPIO. A causa del ritardo dovuto alla comunicazione I2C, NON utilizzare i pin SX1509 come abilitazione stepper, pin step o dir o qualsiasi altro pin che richieda un bit banging veloce. Sono utilizzati al meglio come uscite digitali statiche o controllate da gcode o pin hardware-pwm per es. fan. Si pu\u00f2 definire un numero qualsiasi di sezioni con un prefisso \"sx1509\". Ogni espansione fornisce un set di 16 pin (da sx1509_my_sx1509:PIN_0 a sx1509_my_sx1509:PIN_15) che possono essere utilizzati nella configurazione della stampante. Per un esempio, vedere il file generic-duet2-duex.cfg . [sx1509 my_sx1509] i2c_address: # Indirizzo I2C utilizzato da questa espansione. A seconda dei # ponticelli hardware \u00e8 uno dei seguenti indirizzi: 62 63 112 113. # Questo parametro deve essere fornito. #i2c_mcu: #i2c_bus: #i2c_speed: # Vedere la sezione \"impostazioni comuni I2C\" per una # escrizione dei parametri di cui sopra. #i2c_bus: # Se l'implementazione I2C del tuo microcontrollore supporta # pi\u00f9 bus I2C, puoi specificare qui il nome del bus. L'impostazione # predefinita prevede l'utilizzo del bus i2c del microcontrollore # predefinito. [samd_sercom] \u00b6 Configurazione SAMD SERCOM per specificare quali pin utilizzare su un determinato SERCOM. Si pu\u00f2 definire un numero qualsiasi di sezioni con un prefisso \"samd_sercom\". Ogni SERCOM deve essere configurato prima di utilizzarlo come periferica SPI o I2C. Posiziona questa sezione di configurazione sopra qualsiasi altra sezione che fa uso di bus SPI o I2C. [samd_sercom my_sercom] sercom: # Il nome del bus Sercom da configurare nel microcontrollore. I nomi # disponibili sono \"sercom0\", \"sercom1\", ecc. # Questo parametro deve essere fornito. tx_pin: # Pin MOSI per la comunicazione SPI o pin SDA (dati) per la # comunicazione I2C. Il pin deve avere una configurazione pinmux # valida per la specifica periferica SERCOM. # Questo parametro deve essere fornito. #rx_pin: # Pin MISO per la comunicazione SPI. Questo pin non viene utilizzato # per la comunicazione I2C (I2C utilizza tx_pin sia per l'invio che per la # ricezione). Il pin deve avere una configurazione pinmux valida per la # specifica periferica SERCOM. Questo parametro \u00e8 facoltativo. clk_pin: # Pin CLK per la comunicazione SPI o pin SCL (clock) per la # comunicazione I2C. Il pin deve avere una configurazione pinmux # valida per la specifica periferica SERCOM. Questo parametro deve # essere fornito. [adc_scaled] \u00b6 Scaling analogico di Duet2 Maestro tramite letture vref e vssa. La definizione di una sezione adc_scaled abilita pin adc virtuali (come \"my_name:PB0\") che vengono regolati automaticamente dai pin di monitoraggio vref e vssa della scheda. Assicurati di definire questa sezione di configurazione sopra qualsiasi sezione di configurazione che utilizza uno di questi pin virtuali. Per un esempio, vedere il file generic-duet2-maestro.cfg . [adc_scaled my_name] vref_pin: # The ADC pin to use for VREF monitoring. This parameter must be # provided. vssa_pin: # The ADC pin to use for VSSA monitoring. This parameter must be # provided. #smooth_time: 2.0 # A time value (in seconds) over which the vref and vssa # measurements will be smoothed to reduce the impact of measurement # noise. The default is 2 seconds. [replicape] \u00b6 Supporto per Replicape: vedere la guida beaglebone e il file generic-replicape.cfg per un esempio. # La sezione di configurazione \"replicape\" aggiunge i pin di abilitazione # dello stepper virtuale \"replicape: stepper_x_enable\" (per stepper X, Y, Z, # E e H) e i pin di uscita PWM \"replicape: power_x\" (per hotbed, e, h, fan0, # fan1 , fan2 e fan3) che possono quindi essere utilizzati altrove nel file # di configurazione. [replicape] revision: # La revisione dell'hardware di replicape. Attualmente \u00e8 supportata solo # la revisione \"B3\". Questo parametro deve essere fornito. #enable_pin: !gpio0_20 # Il pin di abilitazione globale dei replicape. L'impostazione predefinita # \u00e8 !gpio0_20 (aka P9_41). host_mcu: # Il nome della sezione mcu config che comunica con l'istanza mcu # \"linux process\" di Klipper. Questo parametro deve essere fornito. #standstill_power_down: False # Questo parametro controlla la linea CFG6_ENN su tutti i motori # passo-passo. True imposta le righe di abilitazione su \"open\". # L'impostazione predefinita \u00e8 Falso. #stepper_x_microstep_mode: #stepper_y_microstep_mode: #stepper_z_microstep_mode: #stepper_e_microstep_mode: #stepper_h_microstep_mode: # Questo parametro controlla i pin CFG1 e CFG2 del driver del motore # passo-passo specificato. Le opzioni disponibili sono: disabilita, 1, 2, # spread2, 4, 16, spread4, spread16, stealth4 e stealth16. L'impostazione # predefinita \u00e8 disabilitata. #stepper_x_current: #stepper_y_current: #stepper_z_current: #stepper_e_current: #stepper_h_current: # La corrente massima configurata (in Amp) del driver del motore # passo-passo. Questo parametro deve essere fornito se lo stepper non # \u00e8 in modalit\u00e0 disabilitazione. #stepper_x_chopper_off_time_high: #stepper_y_chopper_off_time_high: #stepper_z_chopper_off_time_high: #stepper_e_chopper_off_time_high: #stepper_h_chopper_off_time_high: # Questo parametro controlla il pin CFG0 del driver del motore # passo-passo (True imposta CFG0 alto, False lo imposta basso). # L'impostazione predefinita \u00e8 False. #stepper_x_chopper_hysteresis_high: #stepper_y_chopper_hysteresis_high: #stepper_z_chopper_hysteresis_high: #stepper_e_chopper_hysteresis_high: #stepper_h_chopper_hysteresis_high: # Questo parametro controlla il pin CFG4 del driver del motore # passo-passo (True imposta CFG4 alto, False lo imposta basso). # L'impostazione predefinita \u00e8 False. #stepper_x_chopper_blank_time_high: #stepper_y_chopper_blank_time_high: #stepper_z_chopper_blank_time_high: #stepper_e_chopper_blank_time_high: #stepper_h_chopper_blank_time_high: # Questo parametro controlla il pin CFG5 del driver del motore # passo-passo (True imposta CFG5 alto, False lo imposta basso). # L'impostazione predefinita \u00e8 True. Altri moduli personalizzati \u00b6 [palette2] \u00b6 Supporto multimateriale Palette 2: fornisce un'integrazione pi\u00f9 stretta supportando i dispositivi Palette 2 in modalit\u00e0 connessa. Questo modulo richiede anche [virtual_sdcard] e [pause_resume] per la piena funzionalit\u00e0. Se si utilizza questo modulo, non utilizzare il plug-in Palette 2 per Octoprint poich\u00e9 entreranno in conflitto e 1 non si inizializzer\u00e0 correttamente, probabilmente interrompendo la stampa. Se utilizzi Octoprint e esegui lo streaming di gcode sulla porta seriale invece di stampare da virtual_sd, rimuovere M1 e M0 da Pausa dei comandi in Impostazioni > Connessione seriale > Firmware e protocollo eviter\u00e0 la necessit\u00e0 per avviare la stampa sulla tavolozza 2 e riattivare la pausa in Octoprint per avviare la stampa. [palette2] serial: # La porta seriale per la connessione alla Palette 2. #baud: 115200 # La velocit\u00e0 da utilizzare. Il valore predefinito \u00e8 115200. #feedrate_splice: 0.8 # L'avanzamento da utilizzare durante la giunzione # il valore predefinito \u00e8 0.8 #feedrate_normal: 1.0 # L'avanzamento da utilizzare dopo la giunzione # il valore predefinito \u00e8 1.0 #auto_load_speed: 2 # Avanzamento di estrusione durante il caricamento automatico # il valore predefinito \u00e8 2 (mm/s) #auto_cancel_variation: 0.1 # Annullamento automatico della stampa quando la variazione # del ping \u00e8 superiore a questa soglia [angle] \u00b6 Supporto per sensore magnetico Hall per la lettura delle misurazioni dell'angolo del motore passo-passo utilizzando i chip SPI a1333, as5047d o tle5012b. Le misurazioni sono disponibili tramite Server API e strumento di analisi del movimento . Vedere il Riferimento G-Code per i comandi disponibili. [angle my_angle_sensor] sensor_type: # The type of the magnetic hall sensor chip. Available choices are # \"a1333\", \"as5047d\", and \"tle5012b\". This parameter must be # specified. #sample_period: 0.000400 # The query period (in seconds) to use during measurements. The # default is 0.000400 (which is 2500 samples per second). #stepper: # The name of the stepper that the angle sensor is attached to (eg, # \"stepper_x\"). Setting this value enables an angle calibration # tool. To use this feature, the Python \"numpy\" package must be # installed. The default is to not enable angle calibration for the # angle sensor. cs_pin: # The SPI enable pin for the sensor. This parameter must be provided. #spi_speed: #spi_bus: #spi_software_sclk_pin: #spi_software_mosi_pin: #spi_software_miso_pin: # See the \"common SPI settings\" section for a description of the # above parameters. Parametri bus comuni \u00b6 Impostazioni SPI comuni \u00b6 I seguenti parametri sono generalmente disponibili per i dispositivi che utilizzano un bus SPI. #spi_speed: # La velocit\u00e0 SPI (in Hz) da utilizzare durante la comunicazione con il # dispositivo. L'impostazione predefinita dipende dal tipo di dispositivo. #spi_bus: # Se il microcontrollore supporta pi\u00f9 bus SPI, \u00e8 possibile specificare # qui il nome del bus del microcontrollore. L'impostazione predefinita # dipende dal tipo di microcontrollore. #spi_software_sclk_pin: #spi_software_mosi_pin: #spi_software_miso_pin: # Specificare i parametri di cui sopra per utilizzare \"SPI basato su # software\". Questa modalit\u00e0 non richiede il supporto hardware del # microcontrollore (in genere \u00e8 possibile utilizzare qualsiasi pin generico). # L'impostazione predefinita \u00e8 di non utilizzare \"spi software\". Impostazioni I2C comuni \u00b6 I seguenti parametri sono generalmente disponibili per i dispositivi che utilizzano un bus I2C. Si noti che l'attuale supporto del microcontrollore di Klipper per i2c generalmente non tollera il rumore di linea. Errori imprevisti sui cavi i2c possono causare la generazione di un errore di runtime da parte di Klipper. Il supporto di Klipper per il ripristino degli errori varia a seconda del tipo di microcontrollore. In genere si consiglia di utilizzare solo dispositivi i2c che si trovano sulla stessa scheda a circuito stampato del microcontrollore. La maggior parte delle implementazioni del microcontrollore Klipper supporta solo un i2c_speed di 100000. Il microcontrollore \"linux\" Klipper supporta una velocit\u00e0 400000, ma deve essere impostato nel sistema operativo e il parametro i2c_speed viene altrimenti ignorato. Il microcontrollore Klipper \"rp2040\" supporta una velocit\u00e0 di 400000 tramite il parametro i2c_speed . Tutti gli altri microcontrollori Klipper utilizzano una frequenza di 100000 e ignorano il parametro i2c_speed . #i2c_address: # L'indirizzo i2c del dispositivo. Questo deve essere specificato # come numero decimale (non in esadecimale). L'impostazione # predefinita dipende dal tipo di dispositivo. #i2c_mcu: # Il nome del microcontrollore a cui \u00e8 collegato il chip. # L'impostazione predefinita \u00e8 \"mcu\". #i2c_bus: # Se il microcontrollore supporta pi\u00f9 bus I2C, \u00e8 possibile # specificare qui il nome del bus del microcontrollore. # L'impostazione predefinita dipende dal tipo di microcontrollore. #i2c_speed: # La velocit\u00e0 I2C (in Hz) da utilizzare durante la comunicazione # con il dispositivo. L'implementazione di Klipper sulla maggior # parte dei microcontrollori \u00e8 codificata a 100000 e la modifica # di questo valore non ha alcun effetto. # Il valore predefinito \u00e8 100000.","title":"Riferimenti configurazione"},{"location":"Config_Reference.html#riferimenti-configurazione","text":"Questo documento \u00e8 un riferimento per le opzioni disponibili nel file di configurazione di Klipper. Le descrizioni in questo documento sono formattate in modo che sia possibile tagliarle e incollarle in un file di configurazione della stampante. Consulta il documento di installazione per informazioni sulla configurazione di Klipper e sulla scelta di un file di configurazione iniziale.","title":"Riferimenti configurazione"},{"location":"Config_Reference.html#configurazione-del-microcontrollore","text":"","title":"Configurazione del microcontrollore"},{"location":"Config_Reference.html#formato-dei-nomi-dei-pin-del-microcontrollore","text":"Molte opzioni di configurazione richiedono il nome di un pin del microcontrollore. Klipper usa i nomi hardware per questi pin, ad esempio \"PA4\". I nomi dei pin possono essere preceduti da ! per indicare che deve essere utilizzata una polarit\u00e0 inversa (ad esempio, trigger su basso anzich\u00e9 alto). I pin di input possono essere preceduti da ^ per indicare che un resistore di pull-up hardware deve essere abilitato per il pin. Se il microcontrollore supporta resistori pull-down, un pin di ingresso pu\u00f2 in alternativa essere preceduto da ~ . Nota, alcune sezioni di configurazione potrebbero \"creare\" pin aggiuntivi. Quando ci\u00f2 si verifica, la sezione di configurazione che definisce i pin deve essere elencata nel file di configurazione prima di qualsiasi sezione che utilizza tali pin.","title":"Formato dei nomi dei pin del microcontrollore"},{"location":"Config_Reference.html#mcu","text":"Configurazione del microcontrollore primario. [mcu] serial: # La porta seriale per la connessione all'MCU. In caso di dubbi (o se # cambia) vedere \"Dov'\u00e8 la mia porta seriale?\" sezione delle FAQ. # Questo parametro deve essere fornito quando si utilizza una # porta seriale. #baud: 250000 # La velocit\u00e0 di trasmissione da utilizzare. Il valore predefinito \u00e8 250000. #canbus_uuid: # Se si utilizza un dispositivo collegato a un bus CAN, questo imposta # l'identificatore univoco del chip a cui connettersi. Questo valore deve # essere fornito quando si utilizza il bus CAN per la comunicazione. #canbus_interface: # Se si utilizza un dispositivo collegato a un bus CAN, viene impostata # l'interfaccia di rete CAN da utilizzare. L'impostazione predefinita \u00e8 'can0'. #restart_method: # Questo controlla il meccanismo che l'host utilizzer\u00e0 per reimpostare # il microcontrollore. Le scelte sono \"arduino\", \"cheetah\", \"rpi_usb\" e # \"command\". Il metodo 'arduino' (attiva/disattiva DTR) \u00e8 comune su # schede Arduino e cloni. Il metodo 'cheetah' \u00e8 un metodo speciale # necessario per alcune schede Fysetc Cheetah. Il metodo \"rpi_usb\" # \u00e8 utile sulle schede Raspberry Pi con microcontrollori alimentati # tramite USB: disabilita brevemente l'alimentazione a tutte le porte # USB per eseguire un ripristino del microcontrollore. Il metodo # \"comando\" prevede l'invio di un comando Klipper al microcontrollore # in modo che possa reimpostarsi. L'impostazione predefinita \u00e8 # 'arduino' se il microcontrollore comunica su una porta seriale, # altrimenti 'comando'.","title":"[mcu]"},{"location":"Config_Reference.html#mcu-my_extra_mcu","text":"Microcontrollori aggiuntivi (si pu\u00f2 definire un numero qualsiasi di sezioni con un prefisso \"mcu\"). Microcontrollori aggiuntivi introducono pin aggiuntivi che possono essere configurati come riscaldatori, stepper, ventole, ecc. Ad esempio, se viene introdotta una sezione \"[mcu extra_mcu]\", i pin come \"extra_mcu:ar9\" possono quindi essere utilizzati altrove nella configurazione (dove \"ar9\" \u00e8 un nome pin hardware o un nome alias sul dato mcu). [mcu my_extra_mcu] # Vedere la sezione \"mcu\" per i parametri di configurazione.","title":"[mcu my_extra_mcu]"},{"location":"Config_Reference.html#impostazioni-cinematiche-comuni","text":"","title":"Impostazioni cinematiche comuni"},{"location":"Config_Reference.html#printer","text":"La sezione printer controlla le impostazioni di alto livello della stampante. [printer] kinematics: # Il tipo di stampante in uso. Questa opzione pu\u00f2 essere una delle # seguenti: cartesian, corexy, corexz, hybrid_corexy, hybrid_corexz, # rotary_delta, delta, deltesian, polar, winch o nessuno. # Questo parametro deve essere specificato. max_velocity: # Velocit\u00e0 massima (in mm/s) della testa di stampa (relativa alla stampa). # Questo parametro deve essere specificato. max_accel: # Accelerazione massima (in mm/s^2) della testina (relativa alla stampa). # Questo parametro deve essere specificato. #max_accel_to_decel: # Una pseudo accelerazione (in mm/s^2) che controlla la velocit\u00e0 con cui # la testa di stampa pu\u00f2 passare dall'accelerazione alla decelerazione. Viene # utilizzato per ridurre la velocit\u00e0 massima di brevi movimenti a zig-zag # (e quindi ridurre le vibrazioni della stampante dovute a questi movimenti). # Il valore predefinito \u00e8 met\u00e0 di max_accel. #square_corner_velocity: 5.0 # La velocit\u00e0 massima (in mm/s) alla quale la testa di stampa pu\u00f2 viaggiare # su un angolo di 90 gradi. Un valore diverso da zero pu\u00f2 ridurre le variazioni # delle portate dell'estrusore consentendo variazioni istantanee della velocit\u00e0 # della testa utensile durante le curve. Questo valore configura l'algoritmo # interno di cornering della velocit\u00e0 centripeta; gli angoli con angoli maggiori # di 90 gradi avranno una velocit\u00e0 in curva maggiore mentre gli angoli con # angoli inferiori a 90 gradi avranno una velocit\u00e0 in curva inferiore. Se questo # \u00e8 impostato su zero, la testa utensile decelerer\u00e0 fino a zero ad ogni angolo. # Il valore predefinito \u00e8 5 mm/s.","title":"[printer]"},{"location":"Config_Reference.html#stepper","text":"Definizioni di motori passo-passo. Diversi tipi di stampante (come specificato dall'opzione \"cinematica\" nella sezione di configurazione [stampante]) richiedono nomi diversi per lo stepper (ad esempio, stepper_x vs stepper_a ). Di seguito sono riportate le definizioni comuni di stepper. Vedere il documento distanza di rotazione per informazioni sul calcolo del parametro rotation_distance . Consultare il documento Multi-MCU homing per informazioni sull'homing utilizzando pi\u00f9 microcontrollori. [stepper_x] step_pin: # Pin GPIO Step (attivato in alto) . Questo parametro deve essere fornito. dir_pin: # Pin GPIO di direzione (alto indica una direzione positiva). # Questo parametro deve essere fornito. enable_pin: # Pin GPIO di abilitazione (l'impostazione predefinita \u00e8 abilita alto; usa ! # per indicare abilita basso). Se questo parametro non viene fornito, il # driver del motore passo-passo deve essere sempre abilitato. rotation_distance: # Distanza (in mm) che l'asse percorre con una rotazione completa del # motore passo-passo (o viene specificata la marcia finale del rapporto di # trasmissione). Questo parametro deve essere fornito. microsteps: # Il numero di micropassi utilizzati dal driver del motore passo-passo. # Questo parametro deve essere fornito. #full_steps_per_rotation: 200 # Il numero di passi completi per una rotazione del motore passo-passo. # Impostarlo su 200 per un motore passo-passo da 1.8 gradi o su 400 per # un motore da 0.9 gradi. Il valore predefinito \u00e8 200. #gear_ratio: # Il rapporto di trasmissione se il motore passo-passo \u00e8 collegato all'asse # tramite un riduttore. Ad esempio, si pu\u00f2 specificare \"5:1\" se \u00e8 in uso un # riduttore 5 a 1. Se l'asse ha pi\u00f9 riduttori, \u00e8 possibile specificare un elenco # di rapporti di trasmissione separati da virgole (ad esempio, \"57:11, 2:1\"). # Se viene specificato gear_ratio, rotation_distance specifica la distanza # percorsa dall'asse per una rotazione completa dell'ingranaggio finale. # L'impostazione predefinita \u00e8 di non utilizzare un rapporto di trasmissione. #step_pulse_duration: # Il tempo minimo tra il fronte del segnale dell'impulso del passo e il # successivo fronte del segnale \"non passo\". Viene utilizzato anche per # impostare il tempo minimo tra un impulso di passo e un segnale di cambio # di direzione. L'impostazione predefinita \u00e8 0.000000100 (100ns) per gli # stepper TMC configurati in modalit\u00e0 UART o SPI e l'impostazione # predefinita \u00e8 0.000002 (che \u00e8 2us) per tutti gli altri stepper. endstop_pin: # Pin di rilevamento interruttore di fine corsa. Se questo pin di fine corsa # si trova su un mcu diverso dal motore passo-passo, abilita il # \"homing multi-mcu\". Questo parametro deve essere fornito per gli # stepper X, Y e Z su stampanti in stile cartesiano. #position_min: 0 # Distanza minima valida (in mm) alla quale l'utente pu\u00f2 comandare # il movimento dello stepper. Il valore predefinito \u00e8 0 mm. position_endstop: # Posizione del finecorsa (in mm). Questo parametro deve essere fornito # per gli stepper X, Y e Z su stampanti in stile cartesiano. position_max: # Distanza massima valida (in mm) alla quale l'utente pu\u00f2 comandare lo # spostamento dello stepper. Questo parametro deve essere fornito per # gli stepper X, Y e Z su stampanti in stile cartesiano. #homing_speed: 5.0 # Velocit\u00e0 massima (in mm/s) dello stepper durante l'homing. # Il valore predefinito \u00e8 5 mm/s. #homing_retract_dist: 5.0 # Distanza dall'arretramento (in mm) prima della corsa di riferimento # una seconda volta durante la corsa di riferimento. Impostalo a zero per # disabilitare la seconda casa. Il valore predefinito \u00e8 5 mm. #homing_retract_speed: # Velocit\u00e0 da utilizzare nella corsa di ritorno dopo l'homing nel caso in # cui questa dovesse essere diversa dalla velocit\u00e0 di homing, che \u00e8 # l'impostazione predefinita per questo parametro #second_homing_speed: # Velocit\u00e0 (in mm/s) dello stepper durante l'esecuzione del secondo # homing. L'impostazione predefinita \u00e8 homing_speed/2. #homing_positive_dir: # Se true, l'homing far\u00e0 muovere lo stepper in una direzione positiva # (allontanandosi da zero); se falso, home verso zero. \u00c8 meglio utilizzare # l'impostazione predefinita piuttosto che specificare questo parametro. # Il valore predefinito \u00e8 true se position_endstop \u00e8 vicino a position_max # false se vicino a position_min.","title":"[stepper]"},{"location":"Config_Reference.html#cinematica-cartesiana","text":"Vedere example-cartesian.cfg per un file di configurazione della cinematica cartesiana di esempio. Qui sono descritti solo i parametri specifici delle stampanti cartesiane - vedere impostazioni cinematiche comuni per i parametri disponibili. [printer] kinematics: cartesian max_z_velocity: # Imposta la velocit\u00e0 massima (in mm/s) di movimento lungo # l'asse z. Questa impostazione pu\u00f2 essere utilizzata per limitare # la velocit\u00e0 massima del motore passo-passo z. L'impostazione # predefinita \u00e8 utilizzare max_velocity per max_z_velocity. max_z_accel: # Imposta l'accelerazione massima (in mm/s^2) del movimento # lungo l'asse z. Limita l'accelerazione del motore passo-passo z. # L'impostazione predefinita \u00e8 utilizzare max_accel per max_z_accel. # La sezione stepper_x viene utilizzata per descrivere lo stepper # che controlla l'asse X in un robot cartesiano. [stepper_x] # La sezione stepper_y viene utilizzata per descrivere lo stepper # che controlla l'asse Y in un robot cartesiano. [stepper_y] # La sezione stepper_z viene utilizzata per descrivere lo stepper # che controlla l'asse Z in un robot cartesiano. [stepper_z]","title":"Cinematica cartesiana"},{"location":"Config_Reference.html#cinematica-delta-lineare","text":"Vedere example-delta.cfg per un file di configurazione della cinematica delta lineare di esempio. Consultare la guida alla calibrazione delta per informazioni sulla calibrazione. Qui vengono descritti solo i parametri specifici per le stampanti delta lineari - vedere impostazioni cinematiche comuni per i parametri disponibili. [printer] kinematics: delta max_z_velocity: # Per le stampanti delta questo limita la velocit\u00e0 massima (in mm/s) dei # movimenti con movimento dell'asse z. Questa impostazione pu\u00f2 essere # utilizzata per ridurre la velocit\u00e0 massima dei movimenti su/gi\u00f9 (che # richiedono una velocit\u00e0 di incremento maggiore rispetto ad altri # movimenti su una stampante delta). L'impostazione predefinita \u00e8 # utilizzare max_velocity per max_z_velocity. #max_z_accel: # Imposta l'accelerazione massima (in mm/s^2) del movimento lungo # l'asse z. L'impostazione pu\u00f2 essere utile se la stampante pu\u00f2 # raggiungere un'accelerazione maggiore sui movimenti XY rispetto ai # movimenti Z (ad esempio, quando si utilizza l'input shaper). # L'impostazione predefinita \u00e8 utilizzare max_accel per max_z_accel. #minimum_z_position: 0 # La posizione Z minima in cui l'utente pu\u00f2 comandare alla testa di # spostarsi. Il valore predefinito \u00e8 0. delta_radius: # Raggio (in mm) del cerchio orizzontale formato dalle tre torri ad # asse lineare. Questo parametro pu\u00f2 anche essere calcolato come: # delta_radius = smooth_rod_offset - effector_offset - carriage_offset # Questo parametro deve essere fornito. #print_radius: # Il raggio (in mm) delle coordinate XY della testa di stampa valide. # \u00c8 possibile utilizzare questa impostazione per personalizzare il # controllo dell'intervallo dei movimenti della testa. Se qui # viene specificato un valore elevato, potrebbe essere possibile # comandare la collisione della testa di stampa con una torre. # L'impostazione predefinita \u00e8 usare delta_radius per print_radius # (che normalmente impedirebbe una collisione con torri). # La sezione stepper_a descrive lo stepper che controlla la torre # anteriore sinistra (a 210 gradi). Questa sezione controlla anche i # parametri di homing (velocit\u00e0 di homing, homing retract_dist) # per tutte le torri. [stepper_a] position_endstop: # Distanza (in mm) tra l'ugello e il piatto quando l'ugello si trova al # centro dell'area di costruzione e si attiva il finecorsa. Questo # parametro deve essere fornito per stepper_a; per stepper_b e # stepper_c questo parametro \u00e8 predefinito sul valore specificato # per stepper_a. arm_length: # Lunghezza (in mm) dell'asta diagonale che collega questa torre # alla testa di stampa. Questo parametro deve essere fornito per # stepper_a; per stepper_b e stepper_c questo parametro \u00e8 predefinito sul valore specificato per stepper_a. #angle: # Questa opzione specifica l'angolo (in gradi) a cui si trova la torre. # Il valore predefinito \u00e8 210 per stepper_a, 330 per stepper_b e 90 # per stepper_c. # La sezione stepper_b descrive lo stepper che controlla la torre # anteriore destra (a 330 gradi). [stepper_b] # La sezione stepper_c descrive lo stepper che controlla la torre # posteriore (a 90 gradi). [stepper_c] # La sezione delta_calibrate abilita un comando G-code esteso # DELTA_CALIBRATE in grado di calibrare le posizioni e gli angoli # dei finecorsa della torre. [delta_calibrate] radius: # Raggio (in mm) dell'area che pu\u00f2 essere sondata. Questo \u00e8 # il raggio delle coordinate dell'ugello da sondare; se si utilizza # una sonda automatica con un offset XY, scegliere un raggio # sufficientemente piccolo in modo che la sonda si adatti sempre # al piatto. Questo parametro deve essere fornito. #speed: 50 # La velocit\u00e0 (in mm/s) degli spostamenti senza probing durante # la calibrazione. Il valore predefinito \u00e8 50. #horizontal_move_z: 5 # L'altezza (in mm) a cui la testa deve essere comandata di # spostarsi appena prima di avviare un'operazione di sonda. # L'impostazione predefinita \u00e8 5.","title":"Cinematica Delta lineare"},{"location":"Config_Reference.html#cinematica-deltesiana","text":"Vedere example-deltesian.cfg per un esempio di file di configurazione della cinematica deltesiana. Qui sono descritti solo i parametri specifici per le stampanti deltesiane - vedere impostazioni cinematiche comuni per i parametri disponibili. [printer] kinematics: deltesian max_z_velocity: # Per le stampanti deltesiane, ci\u00f2 limita la velocit\u00e0 massima (in mm/s) # dei movimenti con movimento dell'asse z. Questa impostazione pu\u00f2 # essere utilizzata per ridurre la velocit\u00e0 massima dei movimenti su/gi\u00f9 # (che richiedono una velocit\u00e0 di incremento maggiore rispetto ad altri # movimenti su una stampante deltesiana). L'impostazione predefinita # \u00e8 utilizzare max_velocity per max_z_velocity. #max_z_accel: # Imposta l'accelerazione massima (in mm/s^2) del movimento lungo # l'asse z. L'impostazione pu\u00f2 essere utile se la stampante pu\u00f2 raggiungere # un'accelerazione maggiore sui movimenti XY rispetto ai movimenti Z # (ad esempio, quando si utilizza l'input shaper). L'impostazione # predefinita \u00e8 utilizzare max_accel per max_z_accel. #minimum_z_position: 0 # La posizione Z minima in cui l'utente pu\u00f2 comandare alla testa di # spostarsi. Il valore predefinito \u00e8 0. #min_angle: 5 # Questo rappresenta l'angolo minimo (in gradi) rispetto all'orizzontale # che le braccia deltesiane possono raggiungere. Questo parametro ha lo # scopo di impedire che i bracci diventino completamente orizzontali, il # che rischierebbe l'inversione accidentale dell'asse XZ. # L'impostazione predefinita \u00e8 5. #print_width: # La distanza (in mm) delle coordinate X della testa utensile valide. # \u00c8 possibile utilizzare questa impostazione per personalizzare il # controllo dell'intervallo dei movimenti della testa utensile. Se # qui viene specificato un valore elevato, potrebbe essere possibile # comandare la collisione della testa utensile con una torre. Questa # impostazione di solito corrisponde alla larghezza del piatto (in mm). #slow_ratio: 3 # Il rapporto utilizzato per limitare la velocit\u00e0 e l'accelerazione sui # movimenti vicini agli estremi dell'asse X. Se la distanza verticale # divisa per la distanza orizzontale supera il valore di slow_ratio, la # velocit\u00e0 e l'accelerazione sono limitate alla met\u00e0 dei loro valori # nominali. Se la distanza verticale divisa per la distanza orizzontale # supera il doppio del valore di slow_ratio, la velocit\u00e0 e l'accelerazione # sono limitate a un quarto dei loro valori nominali. # Il valore predefinito \u00e8 3. # la sezione stepper_left \u00e8 usata per descrivere lo stepper che controlla # la torre di sinistra. Questa sezione controlla anche i parametri di # homing (velocit\u00e0 di homing, homing retract_dist) per tutte le torri. [stepper_left] position_endstop: # Distanza (in mm) tra l'ugello e il piatto quando l'ugello si trova al # centro dell'area di costruzione e vengono attivati i finecorsa. Questo # parametro deve essere fornito per stepper_left; per stepper_right # questo parametro \u00e8 predefinito sul valore specificato per stepper_left. arm_length: # Lunghezza (in mm) dell'asta diagonale che collega il carrello torre # alla testina di stampa. Questo parametro deve essere fornito per # stepper_left; per stepper_right, questo parametro per impostazione # predefinita \u00e8 il valore specificato per stepper_left. arm_x_length: # Distanza orizzontale tra la testina di stampa e la torre quando le # stampanti \u00e8 in homing. Questo parametro deve essere fornito # per stepper_left; per stepper_right, questo parametro per impostazione # predefinita \u00e8 il valore specificato per stepper_left. # La sezione stepper_right \u00e8 usata per descrivere lo stepper che # controlla la torre destra. [stepper_right] # La sezione stepper_y viene utilizzata per descrivere lo stepper che # controlla l'asse Y in un robot deltesiano. [stepper_y]","title":"Cinematica Deltesiana"},{"location":"Config_Reference.html#cinematica-corexy","text":"Vedere example-corexy.cfg per un file cinematico corexy (e h-bot) di esempio. Qui sono descritti solo i parametri specifici per le stampanti corexy - vedere impostazioni cinematiche comuni per i parametri disponibili. [printer] kinematics: corexy max_z_velocity: # Imposta la velocit\u00e0 massima (in mm/s) di movimento lungo l'asse z. # Questa impostazione pu\u00f2 essere utilizzata per limitare la velocit\u00e0 # massima del motore passo-passo z. L'impostazione predefinita \u00e8 # utilizzare max_velocity per max_z_velocity. max_z_accel: # Imposta l'accelerazione massima (in mm/s^2) del movimento # lungo l'asse z. Limita l'accelerazione del motore passo-passo z. # L'impostazione predefinita \u00e8 utilizzare max_accel per max_z_accel. # La sezione stepper_x viene utilizzata per descrivere l'asse X e lo # stepper che controlla il movimento X+Y. [stepper_x] # La sezione stepper_y viene utilizzata per descrivere l'asse Y e lo # stepper che controlla il movimento X+Y. [stepper_y] # La sezione stepper_z viene utilizzata per descrivere l'asse Z [stepper_z]","title":"Cinematica CoreXY"},{"location":"Config_Reference.html#cinematica-corexz","text":"Vedere example-corexz.cfg per un file di configurazione della cinematica corexz di esempio. Qui sono descritti solo i parametri specifici per le stampanti corexz - vedere impostazioni cinematiche comuni per i parametri disponibili. [printer] kinematics: corexz max_z_velocity: # Imposta la velocit\u00e0 massima (in mm/s) di movimento lungo l'asse z. # L'impostazione predefinita \u00e8 utilizzare max_velocity per # max_z_velocity. max_z_accel: # Imposta l'accelerazione massima (in mm/s^2) del movimento lungo # l'asse z. L'impostazione predefinita \u00e8 utilizzare max_accel per # max_z_accel. # La sezione stepper_x viene utilizzata per descrivere l'asse X e lo # stepper che controlla il movimento X+Z. [stepper_x] # La sezione stepper_y viene utilizzata per descrivere l'asse Y [stepper_y] # La sezione stepper_z viene utilizzata per descrivere l'asse Z e lo # stepper che controlla il movimento X+Z. [stepper_z]","title":"Cinematica CoreXZ"},{"location":"Config_Reference.html#cinematica-hybrid-corexy","text":"Vedere example-hybrid-corexy.cfg per un file di configurazione della cinematica corexy ibrida di esempio. Questa cinematica \u00e8 anche nota come cinematica Markforged. Qui vengono descritti solo i parametri specifici delle stampanti corexy ibride, vedere impostazioni cinematiche comuni per i parametri disponibili. [printer] kinematics: hybrid_corexy max_z_velocity: # Imposta la velocit\u00e0 massima (in mm/s) di movimento lungo # l'asse z. L'impostazione predefinita \u00e8 utilizzare max_velocity # per max_z_velocity. max_z_accel: # Imposta l'accelerazione massima (in mm/s^2) del movimento # lungo l'asse z. L'impostazione predefinita \u00e8 utilizzare max_accel # per max_z_accel. # La sezione stepper_x viene utilizzata per descrivere l'asse X e lo # stepper che controlla il movimento X-Y. [stepper_x] # La sezione stepper_y viene utilizzata per descrivere lo stepper # che controlla l'asse Y. [stepper_y] # La sezione stepper_z viene utilizzata per descrivere lo stepper # che controlla l'asse Z. [stepper_z]","title":"Cinematica Hybrid-CoreXY"},{"location":"Config_Reference.html#cinematica-hybrid-corexz","text":"Vedere example-hybrid-corexz.cfg per un file di configurazione della cinematica corexz ibrido di esempio. Questa cinematica \u00e8 anche nota come cinematica Markforged. Qui vengono descritti solo i parametri specifici delle stampanti corexy ibride, vedere impostazioni cinematiche comuni per i parametri disponibili. [printer] kinematics: hybrid_corexz max_z_velocity: # Questo imposta la velocit\u00e0 massima (in mm/s) di movimento lungo # l'asse z. L'impostazione predefinita \u00e8 utilizzare max_velocity per # max_z_velocity. max_z_accel: # Imposta l'accelerazione massima (in mm/s^2) del movimento lungo # l'asse z. L'impostazione predefinita \u00e8 utilizzare max_accel per # max_z_accel. # La sezione stepper_x viene utilizzata per descrivere l'asse X e lo # stepper che controlla il movimento X-Z. [stepper_x] # La sezione stepper_y viene utilizzata per descrivere lo stepper che # controlla l'asse Y. [stepper_y] # La sezione stepper_z viene utilizzata per descrivere lo stepper che # controlla l'asse Z. [stepper_z]","title":"Cinematica Hybrid-CoreXZ"},{"location":"Config_Reference.html#cinematica-polare","text":"Vedere example-polar.cfg per un file di configurazione della cinematica polare di esempio. Qui sono descritti solo i parametri specifici per le stampanti polari - vedere impostazioni cinematiche comuni per i parametri disponibili. LA CINEMATICA POLARE \u00c8 UN LAVORO IN CORSO. \u00c8 noto che i movimenti intorno alla posizione 0, 0 non funzionano correttamente. [printer] kinematics: polar max_z_velocity: # Imposta la velocit\u00e0 massima (in mm/s) di movimento lungo l'asse z. # Questa impostazione pu\u00f2 essere utilizzata per limitare la velocit\u00e0 # massima del motore passo-passo z. L'impostazione predefinita \u00e8 # utilizzare max_velocity per max_z_velocity. max_z_accel: # Questo imposta l'accelerazione massima (in mm/s^2) del # movimento lungo l'asse z. Limita l'accelerazione del motore # passo-passo z. L'impostazione predefinita \u00e8 utilizzare max_accel # per max_z_accel. # La sezione stepper_bed viene utilizzata per descrivere lo stepper # che controlla il piatto [stepper_bed] gear_ratio: # \u00c8 necessario specificare un gear_ratio e rotation_distance # potrebbe non essere specificato. Ad esempio, se il piatto ha una # ruota a 80 denti azionata da uno stepper con una ruota a 16 # denti, si dovrebbe specificare un rapporto di trasmissione di \"80:16\". # Questo parametro deve essere fornito. # La sezione stepper_arm \u00e8 usata per descrivere lo stepper che # controlla il carrello sul braccio. [stepper_arm] # La sezione stepper_z viene utilizzata per descrivere lo stepper che # controlla l'asse Z. [stepper_z]","title":"Cinematica polare"},{"location":"Config_Reference.html#rotary-delta-kinematics","text":"See example-rotary-delta.cfg for an example rotary delta kinematics config file. Qui vengono descritti solo i parametri specifici delle stampanti delta rotative - vedere impostazioni cinematiche comuni per i parametri disponibili. ROTARY DELTA KINEMATICS ARE A WORK IN PROGRESS. Homing moves may timeout and some boundary checks are not implemented. [printer] kinematics: rotary_delta max_z_velocity: # For delta printers this limits the maximum velocity (in mm/s) of # moves with z axis movement. This setting can be used to reduce the # maximum speed of up/down moves (which require a higher step rate # than other moves on a delta printer). The default is to use # max_velocity for max_z_velocity. #minimum_z_position: 0 # The minimum Z position that the user may command the head to move # to. The default is 0. shoulder_radius: # Radius (in mm) of the horizontal circle formed by the three # shoulder joints, minus the radius of the circle formed by the # effector joints. This parameter may also be calculated as: # shoulder_radius = (delta_f - delta_e) / sqrt(12) # This parameter must be provided. shoulder_height: # Distance (in mm) of the shoulder joints from the bed, minus the # effector toolhead height. This parameter must be provided. # The stepper_a section describes the stepper controlling the rear # right arm (at 30 degrees). This section also controls the homing # parameters (homing_speed, homing_retract_dist) for all arms. [stepper_a] gear_ratio: # A gear_ratio must be specified and rotation_distance may not be # specified. For example, if the arm has an 80 toothed pulley driven # by a pulley with 16 teeth, which is in turn connected to a 60 # toothed pulley driven by a stepper with a 16 toothed pulley, then # one would specify a gear ratio of \"80:16, 60:16\". This parameter # must be provided. position_endstop: # Distance (in mm) between the nozzle and the bed when the nozzle is # in the center of the build area and the endstop triggers. This # parameter must be provided for stepper_a; for stepper_b and # stepper_c this parameter defaults to the value specified for # stepper_a. upper_arm_length: # Length (in mm) of the arm connecting the \"shoulder joint\" to the # \"elbow joint\". This parameter must be provided for stepper_a; for # stepper_b and stepper_c this parameter defaults to the value # specified for stepper_a. lower_arm_length: # Length (in mm) of the arm connecting the \"elbow joint\" to the # \"effector joint\". This parameter must be provided for stepper_a; # for stepper_b and stepper_c this parameter defaults to the value # specified for stepper_a. #angle: # This option specifies the angle (in degrees) that the arm is at. # The default is 30 for stepper_a, 150 for stepper_b, and 270 for # stepper_c. # The stepper_b section describes the stepper controlling the rear # left arm (at 150 degrees). [stepper_b] # The stepper_c section describes the stepper controlling the front # arm (at 270 degrees). [stepper_c] # The delta_calibrate section enables a DELTA_CALIBRATE extended # g-code command that can calibrate the shoulder endstop positions. [delta_calibrate] radius: # Radius (in mm) of the area that may be probed. This is the radius # of nozzle coordinates to be probed; if using an automatic probe # with an XY offset then choose a radius small enough so that the # probe always fits over the bed. This parameter must be provided. #speed: 50 # The speed (in mm/s) of non-probing moves during the calibration. # The default is 50. #horizontal_move_z: 5 # The height (in mm) that the head should be commanded to move to # just prior to starting a probe operation. The default is 5.","title":"Rotary delta Kinematics"},{"location":"Config_Reference.html#cable-winch-kinematics","text":"Vedere example-winch.cfg per un esempio di file di configurazione della cinematica con verricello, cable winch. Qui sono descritti solo i parametri specifici per le stampanti cavo verricello - vedere impostazioni comuni cinematiche per i parametri disponibili. CABLE WINCH SUPPORT IS EXPERIMENTAL. Homing is not implemented on cable winch kinematics. In order to home the printer, manually send movement commands until the toolhead is at 0, 0, 0 and then issue a G28 command. [printer] kinematics: winch # The stepper_a section describes the stepper connected to the first # cable winch. A minimum of 3 and a maximum of 26 cable winches may be # defined (stepper_a to stepper_z) though it is common to define 4. [stepper_a] rotation_distance: # The rotation_distance is the nominal distance (in mm) the toolhead # moves towards the cable winch for each full rotation of the # stepper motor. This parameter must be provided. anchor_x: anchor_y: anchor_z: # The X, Y, and Z position of the cable winch in cartesian space. # These parameters must be provided.","title":"Cable winch Kinematics"},{"location":"Config_Reference.html#nessuna-cinematica","text":"\u00c8 possibile definire una cinematica speciale \"none\" per disabilitare il supporto cinematico in Klipper. Questo pu\u00f2 essere utile per controllare dispositivi che non sono le tipiche stampanti 3D o per scopi di debug. [printer] kinematics: none max_velocity: 1 max_accel: 1 # \u00c8 necessario definire i parametri max_velocity e max_accel. I valori # non vengono utilizzati per la cinematica \"none\".","title":"Nessuna cinematica"},{"location":"Config_Reference.html#supporto-per-estrusore-e-piatto-riscaldato-comuni","text":"","title":"Supporto per estrusore e piatto riscaldato comuni"},{"location":"Config_Reference.html#extruder","text":"La sezione dell'estrusore viene utilizzata per descrivere i parametri del riscaldatore per l'hotend dell'ugello insieme allo stepper che controlla l'estrusore. Per ulteriori informazioni, vedere riferimento comando . Consultare la Guida all'avanzamento della pressione per informazioni sulla regolazione dell'anticipo della pressione. [extruder] step_pin: dir_pin: enable_pin: microsteps: rotation_distance: #full_steps_per_rotation: #gear_ratio: # Vedere la sezione \"stepper\" per una descrizione di quanto sopra # Se nessuno dei parametri precedenti \u00e8 specificato, nessuno stepper # sar\u00e0 associato all'hotend dell'ugello (sebbene un comando # SYNC_EXTRUDER_MOTION possa associarne uno in fase di esecuzione). nozzle_diameter: # Diametro dell'orifizio dell'ugello (in mm). Questo parametro deve essere fornito. filament_diameter:: # Il diametro nominale del filamento grezzo (in mm) quando # entra nell'estrusore. Questo parametro deve essere fornito. #max_extrude_cross_section: # Area massima (in mm^2) di una sezione trasversale dell'estrusione # (ad es. larghezza dell'estrusione moltiplicata per l'altezza dello strato). # Questa impostazione previene quantit\u00e0 eccessive di estrusione # durante spostamenti XY relativamente piccoli. # Se un movimento richiede una velocit\u00e0 di estrusione che supererebbe questo valore # causer\u00e0 la restituzione di un errore. L'impostazione predefinita # \u00e8: 4.0 * diametro_ugello^2 instantaneous_corner_velocity: 1.000 # La variazione di velocit\u00e0 istantanea massima (in mm/s) del # estrusore durante il collegamento di due movimenti. Il valore predefinito \u00e8 1 mm/s. #max_extrude_only_distance: 50.0 # Lunghezza massima (in mm di filamento grezzo) che pu\u00f2 avere un movimento # di retrazione o di sola estrusione. Se uno spostamento di retrazione # o di sola estrusione richiede una distanza maggiore di questo valore, # verr\u00e0 restituito un errore. Il valore predefinito \u00e8 50 mm. #max_extrude_only_velocity: #max_extrude_only_accel: # Velocit\u00e0 massima (in mm/s) e accelerazione (in mm/s^2) del # motore estrusore per retrazioni e movimenti di sola estrusione. # Queste impostazioni non hanno alcun impatto sui normali movimenti di stampa. # Se non specificati, vengono calcolati per corrispondere al limite che avrebbe # un movimento di stampa XY con una sezione trasversale di 4,0*diametro_ugello^2. #pressure_advance: 0.0 # La quantit\u00e0 di filamento grezzo da spingere nell'estrusore durante # accelerazione dell'estrusore. Una uguale quantit\u00e0 di filamento viene # retratta durante la decelerazione. Si misura in millimetri per # millimetro/secondo. Il valore predefinito \u00e8 0, che disabilita l'avanzamento della pressione. #pressure_advance_smooth_time: 0,040 # Un intervallo di tempo (in secondi) da utilizzare per calcolare la velocit\u00e0 media # dell'estrusore per l'avanzamento della pressione. Un valore maggiore si traduce # in movimenti pi\u00f9 fluidi dell'estrusore. Questo parametro non pu\u00f2 superare i 200 ms. # Questa impostazione si applica solo se pressure_advance \u00e8 diverso da zero. # Il valore predefinito \u00e8 0,040 (40 millisecondi). # # Le restanti variabili descrivono il riscaldatore dell'estrusore. heater_pin: # Pin di uscita PWM che controlla il riscaldatore. Questo parametro deve essere fornito. #max_power: 1.0 # La potenza massima (espressa come un valore compreso tra 0,0 e 1,0) a cui # pu\u00f2 essere impostato il riscaldatore_pin. Il valore 1.0 consente di impostare il pin # completamente abilitato per periodi prolungati, mentre un valore di 0,5 # consentirebbe di abilitare il pin per non pi\u00f9 della met\u00e0 del tempo. Questo # l'impostazione pu\u00f2 essere utilizzata per limitare la potenza totale # (per periodi prolungati) al riscaldatore. L'impostazione predefinita \u00e8 1.0. sensor_type: # Tipo di sensore - i termistori comuni sono \"EPCOS 100K B57560G104F\", # \"ATC Semitec 104GT-2\", \"ATC Semitec 104NT-4-R025H42G\", \"Generico # 3950\",\"Honeywell 100K 135-104LAG-J01\", \"NTC 100K MGB18-104F39050L32\", # \"SliceEngineering 450\" e \"TDK NTCG104LH104JT1\". Vedere la sezione # \"Sensori di temperatura\" per altri sensori. Questo parametro deve essere fornito. sensor_pin: # Pin di ingresso analogico collegato al sensore. Questo parametro deve essere fornito. #pullup_resistor: 4700 # La resistenza (in ohm) del pullup collegato al termistore. Questo parametro # \u00e8 valido solo quando il sensore \u00e8 un termistore. Il valore predefinito \u00e8 4700 ohm. #smooth_time: 1.0 # Un valore di tempo (in secondi) durante il quale le misurazioni della # temperatura verranno uniformate per ridurre l'impatto del rumore # di misurazione. Il valore predefinito \u00e8 1 secondo. control: # Algoritmo di controllo (pid o filigrana). Questo parametro deve # essere fornito. pid_Kp: pid_Ki: pid_Kd: # Il proporzionale (pid_Kp), l'integrale (pid_Ki) e la derivata # (pid_Kd) impostazioni per il sistema di controllo del feedback PID. Klipper # valuta le impostazioni PID con la seguente formula generale: # riscaldatore_pwm = (Kp*errore + Ki*integrale(errore) - Kd*derivato(errore)) / 255 # Dove \"errore\" \u00e8 \"temperatura_richiesta - temperatura_misurata\" # e \"heater_pwm\" \u00e8 la velocit\u00e0 di riscaldamento richiesta con 0,0 completamente # off e 1.0 completamente on. Prendi in considerazione l'utilizzo di PID_CALIBRATE # comando per ottenere questi parametri. pid_Kp, pid_Ki e pid_Kd # i parametri devono essere forniti per i riscaldatori PID. #delta_max: 2.0 # Sui riscaldatori controllati questo \u00e8 il numero di gradi in # Celsius al di sopra della temperatura target prima di disattivare il riscaldatore # cos\u00ec come il numero di gradi sotto il target prima # riattivare il riscaldatore. L'impostazione predefinita \u00e8 2 gradi Celsius. #pwm_cycle_time: 0,100 # Tempo in secondi per ogni ciclo PWM software del riscaldatore. # non \u00e8 consigliabile impostarlo a meno che non ci sia necessario come # requisito accendere il riscaldatore pi\u00f9 velocemente di 10 volte al secondo. # Il valore predefinito \u00e8 0,100 secondi. #min_extrude_temp: 170 # La temperatura minima (in gradi Celsius) alla quale possono essere # impartiti comandi all'estrusore. L'impostazione predefinita \u00e8 170 gradi Celsius. min_temp: max_temp: # L'intervallo massimo di temperature valide (in gradi Celsius) in cui # il riscaldatore deve rimanere all'interno. Questo controlla una funzione di sicurezza # implementata nel codice del microcontrollore , la temperatura # non cadr\u00e0 mai al di fuori di questo intervallo, altrimenti il microcontrollore # entrer\u00e0 in uno stato di arresto. Questo controllo pu\u00f2 aiutare a rilevarne alcuni # guasti hardware del riscaldatore e del sensore. Imposta questo intervallo solo in modo ampio # abbastanza in modo che temperature ragionevoli non si traducano in un errore. # Questi parametri devono essere forniti.","title":"[extruder]"},{"location":"Config_Reference.html#heater_bed","text":"La sezione heater_bed descrive un piatto riscaldato. Utilizza le stesse impostazioni del riscaldatore descritte nella sezione \"extruder\". [heater_bed] heater_pin: sensor_type: sensor_pin: control: min_temp: max_temp: # Vedere la sezione \"extruder\" per una descrizione dei parametri sopra.","title":"[heater_bed]"},{"location":"Config_Reference.html#supporto-livellamento-del-piatto","text":"","title":"Supporto livellamento del piatto"},{"location":"Config_Reference.html#bed_mesh","text":"Mesh Bed Leveling. Si pu\u00f2 definire una sezione di configurazione bed_mesh per abilitare trasformazioni di spostamento che sfalsano l'asse z in base a una mesh generata da punti sondati. Quando si utilizza una sonda per la posizione di riferimento sull'asse z, si consiglia di definire una sezione safe_z_home in printer.cfg per la posizione di riferimento verso il centro dell'area di stampa. Per ulteriori informazioni, vedere la bed mesh guide e riferimento del comando . Esempi visivi: rectangular bed, probe_count = 3, 3: x---x---x (max_point) | x---x---x | (min_point) x---x---x round bed, round_probe_count = 5, bed_radius = r: x (0, r) end / x---x---x \\ (-r, 0) x---x---x---x---x (r, 0) \\ x---x---x / x (0, -r) start [bed_mesh] #speed: 50 # The speed (in mm/s) of non-probing moves during the calibration. # The default is 50. #horizontal_move_z: 5 # The height (in mm) that the head should be commanded to move to # just prior to starting a probe operation. The default is 5. #mesh_radius: # Defines the radius of the mesh to probe for round beds. Note that # the radius is relative to the coordinate specified by the # mesh_origin option. This parameter must be provided for round beds # and omitted for rectangular beds. #mesh_origin: # Defines the center X, Y coordinate of the mesh for round beds. This # coordinate is relative to the probe's location. It may be useful # to adjust the mesh_origin in an effort to maximize the size of the # mesh radius. Default is 0, 0. This parameter must be omitted for # rectangular beds. #mesh_min: # Defines the minimum X, Y coordinate of the mesh for rectangular # beds. This coordinate is relative to the probe's location. This # will be the first point probed, nearest to the origin. This # parameter must be provided for rectangular beds. #mesh_max: # Defines the maximum X, Y coordinate of the mesh for rectangular # beds. Adheres to the same principle as mesh_min, however this will # be the furthest point probed from the bed's origin. This parameter # must be provided for rectangular beds. #probe_count: 3, 3 # For rectangular beds, this is a comma separate pair of integer # values X, Y defining the number of points to probe along each # axis. A single value is also valid, in which case that value will # be applied to both axes. Default is 3, 3. #round_probe_count: 5 # For round beds, this integer value defines the maximum number of # points to probe along each axis. This value must be an odd number. # Default is 5. #fade_start: 1.0 # The gcode z position in which to start phasing out z-adjustment # when fade is enabled. Default is 1.0. #fade_end: 0.0 # The gcode z position in which phasing out completes. When set to a # value below fade_start, fade is disabled. It should be noted that # fade may add unwanted scaling along the z-axis of a print. If a # user wishes to enable fade, a value of 10.0 is recommended. # Default is 0.0, which disables fade. #fade_target: # The z position in which fade should converge. When this value is # set to a non-zero value it must be within the range of z-values in # the mesh. Users that wish to converge to the z homing position # should set this to 0. Default is the average z value of the mesh. #split_delta_z: .025 # The amount of Z difference (in mm) along a move that will trigger # a split. Default is .025. #move_check_distance: 5.0 # The distance (in mm) along a move to check for split_delta_z. # This is also the minimum length that a move can be split. Default # is 5.0. #mesh_pps: 2, 2 # A comma separated pair of integers X, Y defining the number of # points per segment to interpolate in the mesh along each axis. A # \"segment\" can be defined as the space between each probed point. # The user may enter a single value which will be applied to both # axes. Default is 2, 2. #algorithm: lagrange # The interpolation algorithm to use. May be either \"lagrange\" or # \"bicubic\". This option will not affect 3x3 grids, which are forced # to use lagrange sampling. Default is lagrange. #bicubic_tension: .2 # When using the bicubic algorithm the tension parameter above may # be applied to change the amount of slope interpolated. Larger # numbers will increase the amount of slope, which results in more # curvature in the mesh. Default is .2. #relative_reference_index: # A point index in the mesh to reference all z values to. Enabling # this parameter produces a mesh relative to the probed z position # at the provided index. #faulty_region_1_min: #faulty_region_1_max: # Optional points that define a faulty region. See docs/Bed_Mesh.md # for details on faulty regions. Up to 99 faulty regions may be added. # By default no faulty regions are set.","title":"[bed_mesh]"},{"location":"Config_Reference.html#bed_tilt","text":"Compensazione dell'inclinazione del piatto. Si pu\u00f2 definire una sezione di configurazione bed_tilt per abilitare le trasformazioni di movimento che tengono conto di un piatto inclinato. Nota che bed_mesh e bed_tilt sono incompatibili; entrambi non possono essere definiti. Per ulteriori informazioni, vedere riferimento comando . [bed_tilt] #x_adjust: 0 # The amount to add to each move's Z height for each mm on the X # axis. The default is 0. #y_adjust: 0 # The amount to add to each move's Z height for each mm on the Y # axis. The default is 0. #z_adjust: 0 # The amount to add to the Z height when the nozzle is nominally at # 0, 0. The default is 0. # The remaining parameters control a BED_TILT_CALIBRATE extended # g-code command that may be used to calibrate appropriate x and y # adjustment parameters. #points: # A list of X, Y coordinates (one per line; subsequent lines # indented) that should be probed during a BED_TILT_CALIBRATE # command. Specify coordinates of the nozzle and be sure the probe # is above the bed at the given nozzle coordinates. The default is # to not enable the command. #speed: 50 # The speed (in mm/s) of non-probing moves during the calibration. # The default is 50. #horizontal_move_z: 5 # The height (in mm) that the head should be commanded to move to # just prior to starting a probe operation. The default is 5.","title":"[bed_tilt]"},{"location":"Config_Reference.html#bed_screws","text":"Strumento per aiutare a regolare le viti di livellamento del letto. Si pu\u00f2 definire una sezione di configurazione [bed_screws] per abilitare un comando g-code BED_SCREWS_ADJUST. Per ulteriori informazioni, vedere la guida al livellamento e il riferimento al comando . [bed_screws] #screw1: # The X, Y coordinate of the first bed leveling screw. This is a # position to command the nozzle to that is directly above the bed # screw (or as close as possible while still being above the bed). # This parameter must be provided. #screw1_name: # An arbitrary name for the given screw. This name is displayed when # the helper script runs. The default is to use a name based upon # the screw XY location. #screw1_fine_adjust: # An X, Y coordinate to command the nozzle to so that one can fine # tune the bed leveling screw. The default is to not perform fine # adjustments on the bed screw. #screw2: #screw2_name: #screw2_fine_adjust: #... # Additional bed leveling screws. At least three screws must be # defined. #horizontal_move_z: 5 # The height (in mm) that the head should be commanded to move to # when moving from one screw location to the next. The default is 5. #probe_height: 0 # The height of the probe (in mm) after adjusting for the thermal # expansion of bed and nozzle. The default is zero. #speed: 50 # The speed (in mm/s) of non-probing moves during the calibration. # The default is 50. #probe_speed: 5 # The speed (in mm/s) when moving from a horizontal_move_z position # to a probe_height position. The default is 5.","title":"[bed_screws]"},{"location":"Config_Reference.html#screws_tilt_adjust","text":"Strumento per aiutare a regolare l'inclinazione delle viti del piatto utilizzando la sonda Z. Si pu\u00f2 definire una sezione di configurazione Screws_tilt_adjust per abilitare un comando g-code SCREWS_TILT_CALCULATE. Per ulteriori informazioni, vedere la guida al livellamento e riferimento al comando . [screws_tilt_adjust] #screw1: # La coordinata (X, Y) della prima vite di livellamento del piatto. Questa # \u00e8 una posizione in cui comandare l'ugello in modo che la sonda sia # direttamente sopra la vite del piatto (o il pi\u00f9 vicino possibile mentre si # trova ancora sopra il piatto). Questa \u00e8 la vite di base utilizzata nei calcoli. # Questo parametro deve essere fornito. #screw1_name: # Un nome arbitrario per la vite data. Questo nome viene visualizzato # quando viene eseguito lo script di supporto. L'impostazione predefinita # prevede l'utilizzo di un nome basato sulla posizione XY della vite. #screw2: #screw2_name: #... # Viti di livellamento del piatto aggiuntive. Devono essere definite # almeno due viti. #speed: 50 # La velocit\u00e0 (in mm/s) degli spostamenti senza probing durante la # calibrazione. Il valore predefinito \u00e8 50. #horizontal_move_z: 5 # L'altezza (in mm) a cui la testa deve essere spostata appena prima # di avviare un'operazione di sonda. L'impostazione predefinita \u00e8 5. #screw_thread: CW-M3 # Il tipo di vite utilizzata per il livello del piatto, M3, M4 o M5 e la # direzione della manopola utilizzata per livellare il letto, in senso orario # decrementa in senso antiorario decrementa. Valori accettati: CW-M3, # CCW-M3, CW-M4, CCW-M4, CW-M5, CCW-M5. Il valore predefinito \u00e8 # CW-M3, la maggior parte delle stampanti utilizza una vite M3 e # ruotando la manopola in senso orario diminuisce la distanza.","title":"[screws_tilt_adjust]"},{"location":"Config_Reference.html#z_tilt","text":"Regolazione multipla dell'inclinazione dello stepper Z. Questa funzione consente la regolazione indipendente di pi\u00f9 stepper z (vedere la sezione \"stepper_z1\") per regolare l'inclinazione. Se questa sezione \u00e8 presente, diventa disponibile un comando G-Code esteso Z_TILT_ADJUST. [z_tilt] #z_positions: # Un elenco di coordinate X, Y (una per riga; le righe successive # identate) che descrivono la posizione di ciascun \"pivot point\" # del piattotto. Il \"pivot point\" \u00e8 il punto in cui il piatto si attacca # al dato stepper Z. Viene descritto utilizzando le coordinate dell'ugello # (la posizione X, Y dell'ugello se potesse spostarsi direttamente sopra # il punto). La prima voce corrisponde a stepper_z, la seconda a # stepper_z1, la terza a stepper_z2, ecc. # Questo parametro deve essere fornito. #points: # Un elenco di coordinate X, Y (una per riga; righe successive identate) # che devono essere rilevate durante un comando Z_TILT_ADJUST. # Specificare le coordinate dell'ugello e assicurarsi che la sonda sia # sopra il piatto alle coordinate dell'ugello date. # Questo parametro deve essere fornito. #speed: 50 # La velocit\u00e0 (in mm/s) degli spostamenti senza probing durante # la calibrazione. Il valore predefinito \u00e8 50. #horizontal_move_z: 5 # L'altezza (in mm) a cui la testa deve essere comandata per spostarsi # appena prima di avviare un'operazione di probing. # L'impostazione predefinita \u00e8 5. #retries: 0 # Numero di volte per riprovare se i punti rilevati non sono all'interno # della tolleranza. #retry_tolerance: 0 # Se i tentativi sono abilitati, riprovare se i punti sondati pi\u00f9 grande e # pi\u00f9 piccolo differiscono pi\u00f9 di retry_tolerance. Nota che l'unit\u00e0 di # modifica pi\u00f9 piccola qui sarebbe un singolo passaggio. # Tuttavia, se stai sondando pi\u00f9 punti rispetto agli stepper, # probabilmente avrai un valore minimo fisso per l'intervallo di punti # sondati che puoi apprendere osservando l'output del comando.","title":"[z_tilt]"},{"location":"Config_Reference.html#quad_gantry_level","text":"Moving gantry leveling using 4 independently controlled Z motors. Corrects hyperbolic parabola effects (potato chip) on moving gantry which is more flexible. WARNING: Using this on a moving bed may lead to undesirable results. If this section is present then a QUAD_GANTRY_LEVEL extended G-Code command becomes available. This routine assumes the following Z motor configuration: ---------------- |Z1 Z2| | --------- | | | | | | | | | | x-------- | |Z Z3| ---------------- Dove x \u00e8 il punto 0, 0 sul piatto [quad_gantry_level] #gantry_corners: # A newline separated list of X, Y coordinates describing the two # opposing corners of the gantry. The first entry corresponds to Z, # the second to Z2. This parameter must be provided. #points: # A newline separated list of four X, Y points that should be probed # during a QUAD_GANTRY_LEVEL command. Order of the locations is # important, and should correspond to Z, Z1, Z2, and Z3 location in # order. This parameter must be provided. For maximum accuracy, # ensure your probe offsets are configured. #speed: 50 # The speed (in mm/s) of non-probing moves during the calibration. # The default is 50. #horizontal_move_z: 5 # The height (in mm) that the head should be commanded to move to # just prior to starting a probe operation. The default is 5. #max_adjust: 4 # Safety limit if an adjustment greater than this value is requested # quad_gantry_level will abort. #retries: 0 # Number of times to retry if the probed points aren't within # tolerance. #retry_tolerance: 0 # If retries are enabled then retry if largest and smallest probed # points differ more than retry_tolerance.","title":"[quad_gantry_level]"},{"location":"Config_Reference.html#skew_correction","text":"Correzione dell'inclinazione della stampante. \u00c8 possibile utilizzare il software per correggere l'inclinazione della stampante su 3 piani, xy, xz, yz. Questo viene fatto stampando un modello di calibrazione lungo un piano e misurando tre lunghezze. A causa della natura della correzione dell'inclinazione, queste lunghezze vengono impostate tramite gcode. Per i dettagli, vedere Correzione inclinazione e Command Reference . [skew_correction]","title":"[skew_correction]"},{"location":"Config_Reference.html#z_thermal_adjust","text":"Regolazione della posizione Z della testa di stampa in funzione della temperatura. Compensare il movimento verticale della testina utensile causato dall'espansione termica del telaio della stampante in tempo reale utilizzando un sensore di temperatura (tipicamente accoppiato a una sezione verticale del telaio). Vedi anche: comandi g-code estesi . [z_thermal_adjust] #temp_coeff: # Il coefficiente di dilatazione della temperatura, in mm/degC. Ad esempio, un # temp_coeff di 0,01 mm/degC sposter\u00e0 l'asse Z verso il basso di 0,01 mm per ogni # grado Celsius di auemnto del sensore di temperatura . Il valore predefinito \u00e8 # 0,0 mm/degC, che non applica alcuna regolazione. #smooth_time: # Finestra di smoothing applicata al sensore di temperatura, in secondi. Pu\u00f2 # ridurre il rumore del motore da piccole correzioni eccessive in risposta al # rumore del sensore. Il valore predefinito \u00e8 2,0 secondi. #z_adjust_off_above: # Disattiva le regolazioni al di sopra di questa altezza Z [mm]. L'ultima correzione # calcolata rimarr\u00e0 applicata finch\u00e9 la testa utensile non si sposter\u00e0 nuovamente # al di sotto dell'altezza Z specificata. # Il valore predefinito \u00e8 99999999,0 mm (sempre attivo). #max_z_adjustment: # Massima regolazione assoluta applicabile all'asse Z [mm]. Il valore predefinito # \u00e8 99999999,0 mm (illimitato). #sensor_type: #sensor_pin: #min_temp: #max_temp: # Configurazione del sensore di temperatura. Vedere la sezione \"extruder\" per # la definizione dei parametri di cui sopra. #gcode_id: # Vedere la sezione \"heater_generic\" per la definizione di questo parametro.","title":"[z_thermal_adjust]"},{"location":"Config_Reference.html#homing-personalizzato","text":"","title":"Homing personalizzato"},{"location":"Config_Reference.html#safe_z_home","text":"Homing Z sicuro. Si pu\u00f2 utilizzare questo meccanismo per posizionare l'asse Z su una specifica coordinata X, Y. Ci\u00f2 \u00e8 utile se la testa portautensili, ad esempio, deve spostarsi al centro del letto prima che Z possa essere riposizionato. [safe_z_home] home_xy_position: # Una coordinata X, Y (ad es. 100, 100) dove deve essere eseguita # homing Z. Questo parametro deve essere fornito. #speed: 50.0 # Velocit\u00e0 alla quale la testa di stampa viene spostata sulla # coordinata Z sicura. Il valore predefinito \u00e8 50 mm/s #z_hop: # Distanza (in mm) per sollevare l'asse Z prima dell'homing. # Questo si applica a qualsiasi comando di homing, anche se non # si trova sull'asse Z. Se l'asse Z \u00e8 gi\u00e0 azzerato e la posizione Z # corrente \u00e8 inferiore a z_hop, questo sollever\u00e0 la testa a un'altezza # di z_hop. Se l'asse Z non \u00e8 gi\u00e0 azzerato la testina viene sollevata # di z_hop. L'impostazione predefinita \u00e8 di non implementare Z hop. #z_hop_speed: 15.0 # Velocit\u00e0 (in mm/s) alla quale l'asse Z viene sollevato prima # del homing. Il valore predefinito \u00e8 15 mm/s. #move_to_previous: False # Quando \u00e8 impostato su True, gli assi X e Y vengono ripristinati alle # posizioni precedenti dopo l'homing dell'asse Z. # L'impostazione predefinita \u00e8 False.","title":"[safe_z_home]"},{"location":"Config_Reference.html#homing_override","text":"Homing Override. Si pu\u00f2 utilizzare questo meccanismo per eseguire una serie di comandi g-code al posto di un G28 che si trova nel normale input di g-code. Questo pu\u00f2 essere utile su stampanti che richiedono una procedura specifica per l'home della macchina. [homing_override] gcode: # Un elenco di comandi G-Code da eseguire al posto dei comandi # G28 trovati nel normale input di G-Code. # Vedi docs/Command_Templates.md per il formato G-Code. # Se un G28 \u00e8 contenuto in questo elenco di comandi, invocher\u00e0 # la normale procedura di homing per la stampante. I comandi # qui elencati devono eseguire l'home di tutti gli assi. # Questo parametro deve essere fornito. #axes: xyz # Gli assi da sovrascrivere. Ad esempio, se questo \u00e8 impostato # su \"z\", lo script di override verr\u00e0 eseguito solo quando l'asse z # \u00e8 azzerato (ad esempio, tramite un comando \"G28\" o \"G28 Z0\"). # Nota, lo script di sovrascrittura dovrebbe comunque ospitare # tutti gli assi. L'impostazione predefinita \u00e8 \"xyz\" che fa s\u00ec che lo # script di override venga eseguito al posto di tutti i comandi G28. #set_position_x: #set_position_y: #set_position_z: # Se specificato, la stampante presumer\u00e0 che l'asse si trovi # nella posizione specificata prima di eseguire i comandi g-code # precedenti. L'impostazione di questa opzione disabilita i # controlli di riferimento per quell'asse. Questo pu\u00f2 essere utile # se la testa deve muoversi prima di invocare il normale # meccanismo G28 per un asse. L'impostazione predefinita \u00e8 # di non forzare una posizione per un asse.","title":"[homing_override]"},{"location":"Config_Reference.html#endstop_phase","text":"Finecorsa regolati in fase stepper. Per utilizzare questa funzione, definire una sezione di configurazione con un prefisso \"endstop_phase\" seguito dal nome della corrispondente sezione di configurazione dello stepper (ad esempio, \"[endstop_phase stepper_z]\"). Questa funzione pu\u00f2 migliorare la precisione degli interruttori di fine corsa. Aggiungi una semplice dichiarazione \"[endstop_phase]\" per abilitare il comando ENDSTOP_PHASE_CALIBRATE. Per ulteriori informazioni, vedere la endstop phases guide e command reference . [endstop_phase stepper_z] #endstop_accuracy: # Imposta la precisione prevista (in mm) del finecorsa. Questo rappresenta # la distanza massima di errore che il finecorsa pu\u00f2 attivare (ad es. se un # finecorsa pu\u00f2 occasionalmente attivarsi 100um in anticipo o fino a 100um in ritardo # quindi impostalo su 0,200 per 200 um). L'impostazione predefinita \u00e8 # 4*distanza_rotazione/passi_completi_per_rotazione. #trigger_phase: # Questo specifica la fase del driver del motore passo-passo da aspettarsi # quando si raggiunge il finecorsa. \u00c8 composto da due numeri separati # da un '/' - la fase e il numero totale di # fasi (ad es. \"7/64\"). Impostare questo valore solo se si \u00e8 sicuri che il # driver del motore passo-passo viene ripristinato ogni volta che viene ripristinato l'mcu. Se questo # non \u00e8 impostato, la prima fase verr\u00e0 rilevata al primo home # e quella fase sar\u00e0 utilizzata su tutte le abitazioni successive. #endstop_align_zero: False # Se true, la posizione_endstop dell'asse sar\u00e0 effettivamente # modificato in modo che la posizione zero dell'asse avvenga a passo pieno # sul motore. (Se utilizzato sull'asse Z e la stampa # l'altezza del livello \u00e8 un multiplo di una distanza di un passo intero, allora ogni # layer si eseguir\u00e0 in un step completo.) L'impostazione predefinita \u00e8 False.","title":"[endstop_phase]"},{"location":"Config_Reference.html#macro-ed-eventi-g-code","text":"","title":"Macro ed eventi G-Code"},{"location":"Config_Reference.html#gcode_macro","text":"Macro G-Code (\u00e8 possibile definire un numero qualsiasi di sezioni con un prefisso \"gcode_macro\"). Per ulteriori informazioni, consulta la Guida ai modelli di comando . [gcode_macro my_cmd] #gcode: # Un elenco di comandi G-Code da eseguire al posto di \"my_cmd\". # Vedi docs/Command_Templates.md per il formato G-Code. # Questo parametro deve essere fornito. #variable_<name>: # Si pu\u00f2 specificare un numero qualsiasi di opzioni con un prefisso # \"variable_\". Al nome della variabile data verr\u00e0 assegnato il valore dato # (analizzato come un valore letterale Python) e sar\u00e0 disponibile durante # l'espansione della macro. Ad esempio, una configurazione con # \"variable_fan_speed = 75\" potrebbe avere comandi gcode contenenti # \"M106 S{ fan_speed * 255 }\". Le variabili possono essere modificate in # fase di esecuzione utilizzando il comando SET_GCODE_VARIABLE # (consultare docs/Command_Templates.md per i dettagli). # I nomi delle variabili potrebbero non utilizzare caratteri maiuscoli. #rename_existing: # Questa opzione far\u00e0 s\u00ec che la macro ignori un comando G-Code # esistente e fornisca la definizione precedente del comando tramite # il nome fornito qui. Questo pu\u00f2 essere usato per sovrascrivere i # comandi G-Code integrati. Prestare attenzione quando si ignorano # i comandi poich\u00e9 possono causare risultati complessi e imprevisti. # L'impostazione predefinita \u00e8 di non sovrascrivere un comando # G-Code esistente. #description: G-Code macro # Ci\u00f2 aggiunger\u00e0 una breve descrizione utilizzata al comando HELP # o durante l'utilizzo della funzione di completamento automatico. # Predefinito \"G-Code macro\"","title":"[gcode_macro]"},{"location":"Config_Reference.html#delayed_gcode","text":"Esegui un gcode con un ritardo impostato. Per ulteriori informazioni, consulta la Guida template dei comandi e riferimento al comando . [delayed_gcode my_delayed_gcode] gcode: # A list of G-Code commands to execute when the delay duration has # elapsed. G-Code templates are supported. This parameter must be # provided. #initial_duration: 0.0 # The duration of the initial delay (in seconds). If set to a # non-zero value the delayed_gcode will execute the specified number # of seconds after the printer enters the \"ready\" state. This can be # useful for initialization procedures or a repeating delayed_gcode. # If set to 0 the delayed_gcode will not execute on startup. # Default is 0.","title":"[delayed_gcode]"},{"location":"Config_Reference.html#save_variables","text":"Supporta il salvataggio delle variabili su disco in modo che vengano mantenute durante i riavvii. Per ulteriori informazioni, vedere template dei comandi e G-Code reference . [save_variables] filename: # Richiesto: fornire un nome file che verrebbe utilizzato per salvare # le variabili su disco, ad es. ~/variables.cfg","title":"[save_variables]"},{"location":"Config_Reference.html#idle_timeout","text":"Timeout di inattivit\u00e0. Viene automaticamente abilitato un timeout di inattivit\u00e0: aggiungi una sezione di configurazione di idle_timeout esplicita per modificare le impostazioni predefinite. [idle_timeout] #gcode: # Un elenco di comandi G-Code da eseguire in un timeout di # inattivit\u00e0. Vedi docs/Command Templates.md per il formato # G-Code. L'impostazione predefinita \u00e8 # eseguire \"TURN_OFF HEATERS\" e \"M84\". #timeout: 600 # Tempo di inattivit\u00e0 (in secondi) da attendere prima di eseguire # i comandi G-Code sopra. Il valore predefinito \u00e8 600 secondi.","title":"[idle_timeout]"},{"location":"Config_Reference.html#funzionalita-opzionali-g-code","text":"","title":"Funzionalit\u00e0 opzionali G-Code"},{"location":"Config_Reference.html#virtual_sdcard","text":"Una scheda SD virtuale pu\u00f2 essere utile se la macchina host non \u00e8 abbastanza veloce per eseguire bene OctoPrint. Consente al software host Klipper di stampare direttamente i file gcode archiviati in una directory sull'host utilizzando i comandi G-Code standard (ad esempio, M24). [virtual_sdcard] path: # Il percorso della directory locale sulla macchina host per cercare # i file di Gcode. Questa \u00e8 una directory di sola lettura (le scritture # di file sdcard non sono supportate). Si pu\u00f2 indicare questo alla # directory di caricamento di OctoPrint # (generalmente ~/.octoprint/uploads/ ). # Questo parametro deve essere fornito. #on_error_gcode: # Un elenco di comandi G-Code da eseguire quando viene segnalato # un errore.","title":"[virtual_sdcard]"},{"location":"Config_Reference.html#sdcard_loop","text":"Alcune stampanti con funzionalit\u00e0 di pulizia del piatto, come un espulsore di parti o una stampante a nastro, possono trovare impiego nelle sezioni di loop del file sdcard. (Ad esempio, per stampare la stessa parte pi\u00f9 e pi\u00f9 volte, o ripetere la sezione a di una parte per una catena o un altro motivo ripetuto). Consulta il command reference per i comandi supportati. Vedere il file sample-macros.cfg per una macro M808 G-Code compatibile con Marlin. [sdcard_loop]","title":"[sdcard_loop]"},{"location":"Config_Reference.html#force_move","text":"Supporta lo spostamento manuale dei motori passo-passo per scopi diagnostici. Nota, l'utilizzo di questa funzione potrebbe mettere la stampante in uno stato non valido - vedere il command reference per dettagli importanti. [force_move] #enable_force_move: False # Impostare su True per abilitare FORCE_MOVE e SET_KINEMATIC_POSITION # i comandi G-Code estesi. L'impostazione predefinita \u00e8 False.","title":"[force_move]"},{"location":"Config_Reference.html#pause_resume","text":"Funzionalit\u00e0 di Pause/Resume con supporto di acquisizione e ripristino della posizione. Per ulteriori informazioni, vedere riferimento comando . [pause_resume] #recover_velocity: 50. # Quando si abilita pause_resume, la velocit\u00e0 con cui tornare alla # posizione catturata (in mm/s). Il valore predefinito \u00e8 50,0 mm/s.","title":"[pause_resume]"},{"location":"Config_Reference.html#firmware_retraction","text":"Retrazione del filamento del firmware. Ci\u00f2 abilita i comandi GCODE G10 (ritiro) e G11 (non ritirati) emessi da molti slicer. I parametri seguenti forniscono le impostazioni predefinite di avvio, sebbene i valori possano essere regolati tramite il [comando] SET_RETRACTION (G-Codes.md#firmware_retraction)), consentendo l'impostazione e l'ottimizzazione del filamento a runtime. [firmware_retraction] #retract_length: 0 # La lunghezza del filamento (in mm) da ritrarre quando G10 # \u00e8 attivato e da ritrarre quando G11 \u00e8 attivato (ma vedere # unretract_extra_length di seguito). I# l valore predefinito \u00e8 0 mm. #retract_speed: 20 # La velocit\u00e0 di retrazione, in mm/s. # Il valore predefinito \u00e8 20 mm/s. #unretract_extra_length: 0 # La lunghezza (in mm) del filamento *aggiuntivo* da # sommare quando non si ritrae. #unretract_speed: 10 # La velocit\u00e0 di srotolamento, in mm/s. # Il valore predefinito \u00e8 10 mm/s.","title":"[firmware_retraction]"},{"location":"Config_Reference.html#gcode_arcs","text":"Supporto per i comandi Gcode arc (G2/G3). [gcode_arcs] #resolution: 1.0 # Un arco sar\u00e0 diviso in segmenti. La lunghezza di ciascun segmento # sar\u00e0 uguale alla risoluzione in mm impostata sopra. Valori pi\u00f9 bassi # produrranno un arco pi\u00f9 fine, ma anche pi\u00f9 lavoro per la tua macchina. # Archi pi\u00f9 piccoli del valore configurato diventer\u00e0 linee rette. # L'impostazione predefinita \u00e8 # 1mm.","title":"[gcode_arcs]"},{"location":"Config_Reference.html#respond","text":"Abilita i comandi estesi \"M118\" e \"RESPOND\" commands . [respond] #default_type: echo # Imposta il prefisso predefinito dell'output \"M118\" e \"RESPOND\" su uno dei seguenti: # echo: \"echo: \" (Questa \u00e8 l'impostazione predefinita) # command: \"// \" # error: \"!! \" #default_prefix: echo: # Imposta direttamente il prefisso predefinito. Se presente # questo valore sovrascriver\u00e0 il \"default_type\".","title":"[respond]"},{"location":"Config_Reference.html#exclude_object","text":"Abilita il supporto per escludere o cancellare singoli oggetti durante il processo di stampa. Per ulteriori informazioni, vedere la guida escludi oggetti e riferimento ai comandi . Vedere il file sample-macros.cfg per una macro G-Code M486 compatibile con Marlin/RepRapFirmware. [exclude_object]","title":"[exclude_object]"},{"location":"Config_Reference.html#compensazione-della-risonanza","text":"","title":"Compensazione della risonanza"},{"location":"Config_Reference.html#input_shaper","text":"Abilita compensazione della risonanza . Vedere anche il command reference . [input_shaper] #shaper_freq_x: 0 # Una frequenza (in Hz) dell'input shaper per l'asse X. Questa \u00e8 # solitamente una frequenza di risonanza dell'asse X che l'input # shaper dovrebbe sopprimere. Per shaper pi\u00f9 complessi, come # shaper di input EI a 2 e 3 gobbe, questo parametro pu\u00f2 essere # impostato in base a diverse considerazioni. # Il valore predefinito \u00e8 0, che disabilita la modellatura dell'input # per l'asse X. #shaper_freq_y: 0 # Una frequenza (in Hz) dell'input shaper per l'asse Y. Questa \u00e8 # solitamente una frequenza di risonanza dell'asse Y che l'input # shaper dovrebbe sopprimere. Per shaper pi\u00f9 complessi, come # shaper di input EI a 2 e 3 gobbe, questo parametro pu\u00f2 essere # impostato in base a diverse considerazioni. Il valore predefinito # \u00e8 0, che disabilita la modellatura dell'input per l'asse Y. #shaper_type: mzv # Un tipo di input shaper da utilizzare per entrambi gli assi X e Y. # Gli shaper supportati sono zv, mzv, zvd, ei, 2hump_ei e # 3hump_ei. L'impostazione predefinita \u00e8 mzv input shaper. #shaper_type_x: #shaper_type_y: # Se shaper_type non \u00e8 impostato, questi due parametri possono # essere utilizzati per configurare diversi shaper di input per gli # assi X e Y. Sono supportati gli stessi valori del parametro # shaper_type. #damping_ratio_x: 0.1 #damping_ratio_y: 0.1 # Rapporti di smorzamento delle vibrazioni degli assi X e Y # utilizzati dagli shaper di input per migliorare la soppressione # delle vibrazioni. Il valore predefinito \u00e8 0,1, un buon valore per la # maggior parte delle stampanti. Nella maggior parte dei casi # questo parametro non richiede ottimizzazione e # non deve essere modificato.","title":"[input_shaper]"},{"location":"Config_Reference.html#adxl345","text":"Supporto per accelerometri ADXL345. Questo supporto consente di interrogare le misurazioni dell'accelerometro dal sensore. Ci\u00f2 abilita un comando ACCELEROMETER_MEASURE (consultare G-Codes per ulteriori informazioni). Il nome del chip predefinito \u00e8 \"predefinito\", ma \u00e8 possibile specificare un nome esplicito (ad esempio, [adxl345 my_chip_name]). [adxl345] cs_pin: # The SPI enable pin for the sensor. This parameter must be provided. #spi_speed: 5000000 # The SPI speed (in hz) to use when communicating with the chip. # The default is 5000000. #spi_bus: #spi_software_sclk_pin: #spi_software_mosi_pin: #spi_software_miso_pin: # See the \"common SPI settings\" section for a description of the # above parameters. #axes_map: x, y, z # The accelerometer axis for each of the printer's X, Y, and Z axes. # This may be useful if the accelerometer is mounted in an # orientation that does not match the printer orientation. For # example, one could set this to \"y, x, z\" to swap the X and Y axes. # It is also possible to negate an axis if the accelerometer # direction is reversed (eg, \"x, z, -y\"). The default is \"x, y, z\". #rate: 3200 # Output data rate for ADXL345. ADXL345 supports the following data # rates: 3200, 1600, 800, 400, 200, 100, 50, and 25. Note that it is # not recommended to change this rate from the default 3200, and # rates below 800 will considerably affect the quality of resonance # measurements.","title":"[adxl345]"},{"location":"Config_Reference.html#mpu9250","text":"Support for MPU-9250, MPU-9255, MPU-6515, MPU-6050, and MPU-6500 accelerometers (one may define any number of sections with an \"mpu9250\" prefix). [mpu9250 my_accelerometer] #i2c_address: # Default is 104 (0x68). If AD0 is high, it would be 0x69 instead. #i2c_mcu: #i2c_bus: #i2c_speed: 400000 # See the \"common I2C settings\" section for a description of the # above parameters. The default \"i2c_speed\" is 400000. #axes_map: x, y, z # See the \"adxl345\" section for information on this parameter.","title":"[mpu9250]"},{"location":"Config_Reference.html#resonance_tester","text":"Supporto per test di risonanza e calibrazione automatica del input shaper. Per utilizzare la maggior parte delle funzionalit\u00e0 di questo modulo, devono essere installate dipendenze software aggiuntive; fare riferimento a Measuring Resonances e al command reference per ulteriori informazioni. Per ulteriori informazioni sul parametro max_smoothing e sul suo utilizzo, vedere la sezione Max smoothing della guida alla misurazione delle risonanze. [resonance_tester] #probe_points: # Un elenco di coordinate X, Y, Z di punti (un punto per linea) in cui # testare le risonanze. Almeno un punto \u00e8 richiesto. Assicurati che tutti # i punti con un margine di sicurezza nel piano XY (~ pochi centimetri) # siano raggiungibili dalla testa di stampa. #accel_chip: # Un nome del chip dell'accelerometro da utilizzare per le misurazioni. # Se il chip adxl345 \u00e8 stato definito senza un nome esplicito, questo # parametro pu\u00f2 semplicemente fare riferimento ad esso come # \"accel_chip: adxl345\", altrimenti deve essere fornito anche un nome # esplicito, ad es. \"accel_chip: adxl345 mio_chip_nome\". \u00c8 necessario # impostare questo o i due parametri successivi. #accel_chip_x: #accel_chip_y: # Nomi dei chip dell'accelerometro da utilizzare per le misurazioni per # ciascuno degli assi. Pu\u00f2 essere utile, ad esempio, su una stampante con # piatto, se due accelerometri separati sono montati sul piatto (per l'asse Y) # e sulla testa di stampa (per l'asse X). Questi parametri hanno lo stesso # formato del parametro 'accel_chip'. # \u00c8 necessario fornire solo 'accel_chip' o questi due parametri. #max_smoothing: # Maximum input shaper smoothing to allow for each axis during shaper # auto-calibration (with 'SHAPER_CALIBRATE' command). By default no # maximum smoothing is specified. Refer to Measuring_Resonances guide # for more details on using this feature. #min_freq: 5 # Frequenza minima per testare le risonanze. L'impostazione \u00e8 5 Hz. #max_freq: 133.33 # Frequenza massima per testare le risonanze. L'impostazione \u00e8 133,33 Hz. #accel_per_hz: 75 # Questo parametro viene utilizzato per determinare quale accelerazione # utilizzare per testare una frequenza specifica: accel = accel_per_hz * freq. # Maggiore \u00e8 il valore, maggiore \u00e8 l'energia delle oscillazioni. Pu\u00f2 essere # impostato su un valore inferiore al valore predefinito se le risonanze # diventano troppo forti sulla stampante. Tuttavia, valori pi\u00f9 bassi rendono # le misurazioni delle risonanze ad alta frequenza meno precise. # Il valore predefinito \u00e8 75 (mm/sec). #hz_per_sec: 1 # Determina la velocit\u00e0 del test. Quando si testano tutte le frequenze # nell'intervallo [freq_min, freq_max], ogni secondo la frequenza aumenta # di hz_per_sec. Valori piccoli rallentano il test e valori grandi diminuiscono # la precisione del test. Il valore predefinito \u00e8 1,0 (Hz/sec == sec^-2).","title":"[resonance_tester]"},{"location":"Config_Reference.html#helper-per-i-file-di-configurazione","text":"","title":"Helper per i file di configurazione"},{"location":"Config_Reference.html#board_pins","text":"Alias pin board (si pu\u00f2 definire un numero qualsiasi di sezioni con un prefisso \"board_pins\"). Usalo per definire gli alias per i pin su un microcontrollore. [board_pins my_aliases] mcu: mcu # A comma separated list of micro-controllers that may use the # aliases. The default is to apply the aliases to the main \"mcu\". aliases: aliases_<name>: # A comma separated list of \"name=value\" aliases to create for the # given micro-controller. For example, \"EXP1_1=PE6\" would create an # \"EXP1_1\" alias for the \"PE6\" pin. However, if \"value\" is enclosed # in \"<>\" then \"name\" is created as a reserved pin (for example, # \"EXP1_9=<GND>\" would reserve \"EXP1_9\"). Any number of options # starting with \"aliases_\" may be specified.","title":"[board_pins]"},{"location":"Config_Reference.html#include","text":"Supporto per includere i file. Uno pu\u00f2 includere un file di configurazione aggiuntivo dal file di configurazione della stampante principale. Possono essere utilizzati anche caratteri jolly (ad es. \"configs/*.cfg\"). [include my_other_config.cfg]","title":"[include]"},{"location":"Config_Reference.html#duplicate_pin_override","text":"Questo strumento consente di definire pi\u00f9 volte un singolo pin del microcontrollore in un file di configurazione senza il normale controllo degli errori. Questo \u00e8 inteso per scopi diagnostici e di debug. Questa sezione non \u00e8 necessaria laddove Klipper supporta l'utilizzo dello stesso pin pi\u00f9 volte e l'utilizzo di questa sostituzione pu\u00f2 causare risultati confusi e imprevisti. [duplicate_pin_override] pins: # Un elenco di pin separato da virgole che possono essere utilizzati pi\u00f9 volte in # un file di configurazione senza normali controlli degli errori. Questo parametro deve essere # fornito.","title":"[duplicate_pin_override]"},{"location":"Config_Reference.html#hardware-per-probing-del-piatto","text":"","title":"Hardware per probing del piatto"},{"location":"Config_Reference.html#probe","text":"Sonda di altezza Z. Si pu\u00f2 definire questa sezione per abilitare l'hardware di rilevamento dell'altezza Z. Quando questa sezione \u00e8 abilitata, i comandi estesi PROBE e QUERY_PROBE comandi g-code diventano disponibili. Inoltre, vedere la Guida alla calibrazione della sonda . La sezione probe crea anche un pin virtuale \"probe:z_virtual_endstop\". Si pu\u00f2 impostare stepper_z endstop_pin su questo pin virtuale su stampanti in stile cartesiano che utilizzano la sonda al posto di un endstop z. Se si utilizza \"probe:z_virtual_endstop\", non definire un position_endstop nella sezione di configurazione stepper_z. [probe] pin: # Pin di rilevamento della sonda. Se il pin si trova su un # microcontrollore diverso rispetto agli stepper Z, abilita # \"homing multi-mcu\". Questo parametro deve essere fornito. #deactivate_on_each_sample: True # Questo determina se Klipper deve eseguire la disattivazione # gcode tra ogni tentativo di esplorazione durante l'esecuzione di # una sequenza di probe multiple. L'impostazione predefinita \u00e8 True. #x_offset: 0.0 # La distanza (in mm) tra la sonda e l'ugello lungo l'asse x. # Il valore predefinito \u00e8 0. #y_offset: 0.0 # La distanza (in mm) tra la sonda e l'ugello lungo l'asse y. # Il valore predefinito \u00e8 0. z_offset: # La distanza (in mm) tra il piatto e l'ugello quando la sonda si attiva. # Questo parametro deve essere fornito. #speed: 5.0 # Velocit\u00e0 (in mm/s) dell'asse Z durante probing. # Il valore predefinito \u00e8 5 mm/s. #samples: 1 # Il numero di volte in cui sondare ciascun punto. I valori z sondati # verranno mediati. L'impostazione predefinita \u00e8 sondare 1 volta. #sample_retract_dist: 2.0 # La distanza (in mm) per sollevare la testa di stampa tra ciascun # campione (se si esegue il campionamento pi\u00f9 di una volta). # Il valore predefinito \u00e8 2 mm. #lift_speed: # Velocit\u00e0 (in mm/s) dell'asse Z durante il sollevamento della sonda # tra i campioni. L'impostazione predefinita prevede l'utilizzo dello # stesso valore del parametro 'speed'. #samples_result: average # Il metodo di calcolo durante il campionamento pi\u00f9 di una volta: # \"median\" o \"average\". L'impostazione predefinita \u00e8 average. #samples_tolerance: 0.100 # La distanza Z massima (in mm) che un campione pu\u00f2 differire da # altri campioni. Se questa tolleranza viene superata, viene segnalato # un errore o il tentativo viene riavviato # (vedere samples_tolerance_retries). Il valore predefinito \u00e8 0,100 mm. #samples_tolerance_retries: 0 # Il numero di tentativi per riprovare se viene trovato un campione che # supera samples_tolerance. In un nuovo tentativo, tutti i campioni # correnti vengono eliminati e il tentativo di sonda viene riavviato. # Se non si ottiene un insieme valido di campioni nel numero di tentativi # specificato, viene segnalato un errore. Il valore predefinito \u00e8 zero che # causa la segnalazione di un errore sul primo campione che supera # samples_tolerance. #activate_gcode: # Un elenco di comandi G-Code da eseguire prima di ogni tentativo di # esplorazione. Vedi docs/Command_Templates.md per il formato # G-Code. Questo pu\u00f2 essere utile se la sonda deve essere attivata in # qualche modo. Non impartire qui alcun comando che sposti la testa # di stampa (ad es. G1). L'impostazione predefinita \u00e8 di non eseguire # alcun comando G-Code speciale all'attivazione. #deactivate_gcode: # Un elenco di comandi G-Code da eseguire dopo il completamento di # ogni tentativo di esplorazione. Vedi docs/Command_Templates.md # per il formato G-Code. Non impartire qui alcun comando che sposti # la testina. L'impostazione predefinita \u00e8 di non eseguire alcun # comando G-Code speciale alla disattivazione.","title":"[probe]"},{"location":"Config_Reference.html#bltouch","text":"Sonda BLTouch. Si pu\u00f2 definire questa sezione (anzich\u00e9 una sezione sonda) per abilitare una sonda BLTouch. Per ulteriori informazioni, vedere BL-Touch guide e command reference .. Viene anche creato un pin virtuale \"probe:z_virtual_endstop\" (consultare la sezione \"probe\" per i dettagli). [bltouch] sensor_pin: # Pin connected to the BLTouch sensor pin. Most BLTouch devices # require a pullup on the sensor pin (prefix the pin name with \"^\"). # This parameter must be provided. control_pin: # Pin connected to the BLTouch control pin. This parameter must be # provided. #pin_move_time: 0.680 # The amount of time (in seconds) to wait for the BLTouch pin to # move up or down. The default is 0.680 seconds. #stow_on_each_sample: True # This determines if Klipper should command the pin to move up # between each probe attempt when performing a multiple probe # sequence. Read the directions in docs/BLTouch.md before setting # this to False. The default is True. #probe_with_touch_mode: False # If this is set to True then Klipper will probe with the device in # \"touch_mode\". The default is False (probing in \"pin_down\" mode). #pin_up_reports_not_triggered: True # Set if the BLTouch consistently reports the probe in a \"not # triggered\" state after a successful \"pin_up\" command. This should # be True for all genuine BLTouch devices. Read the directions in # docs/BLTouch.md before setting this to False. The default is True. #pin_up_touch_mode_reports_triggered: True # Set if the BLTouch consistently reports a \"triggered\" state after # the commands \"pin_up\" followed by \"touch_mode\". This should be # True for all genuine BLTouch devices. Read the directions in # docs/BLTouch.md before setting this to False. The default is True. #set_output_mode: # Request a specific sensor pin output mode on the BLTouch V3.0 (and # later). This setting should not be used on other types of probes. # Set to \"5V\" to request a sensor pin output of 5 Volts (only use if # the controller board needs 5V mode and is 5V tolerant on its input # signal line). Set to \"OD\" to request the sensor pin output use # open drain mode. The default is to not request an output mode. #x_offset: #y_offset: #z_offset: #speed: #lift_speed: #samples: #sample_retract_dist: #samples_result: #samples_tolerance: #samples_tolerance_retries: # See the \"probe\" section for information on these parameters.","title":"[bltouch]"},{"location":"Config_Reference.html#smart_effector","text":"Lo \"Smart Effector\" di Duet3d implementa una sonda Z utilizzando un sensore di forza. Si pu\u00f2 definire questa sezione invece di [probe] per abilitare le funzioni specifiche di Smart Effector. Ci\u00f2 consente anche a comandi di runtime di regolare i parametri di Smart Effector in fase di esecuzione. [smart_effector] pin: # Pin collegato al pin di uscita della sonda Z Smart Effector (pin 5). Si noti # che la resistenza di pullup sulla scheda generalmente non \u00e8 richiesta. # Tuttavia, se il pin di uscita \u00e8 collegato al pin della scheda con un resistore # di pullup, tale resistore deve essere di valore elevato (ad es. 10K Ohm o pi\u00f9). # Alcune schede hanno un resistore di pullup di basso valore sull'ingresso # della sonda Z, che probabilmente far\u00e0 risultare in uno stato di sonda sempre # attivato. In questo caso, collegare lo Smart Effector a un pin diverso sulla # scheda. Questo parametro \u00e8 obbligatorio. #control_pin: # Pin collegato al pin di ingresso di controllo Smart Effector (pin 7). Se fornito, # diventano disponibili i comandi di programmazione della sensibilit\u00e0 # di Smart Effector. #probe_accel: # Se impostato, limita l'accelerazione dei movimenti di tastatura (in mm/sec^2). # Un'improvvisa grande accelerazione all'inizio del movimento di esplorazione # pu\u00f2 causare l'attivazione spuria della sonda, specialmente se l'hotend \u00e8 pesante. # Per evitarlo, potrebbe essere necessario ridurre l'accelerazione dei movimenti # di tastatura tramite questo parametro. #recovery_time: 0.4 # Un ritardo tra i movimenti di spostamento e tastatura in secondi. Un # movimento veloce prima della tastatura pu\u00f2 causare l'attivazione spuria della # sonda. Ci\u00f2 pu\u00f2 causare errori \"Sonda attivata prima del movimento\" se non # \u00e8 impostato alcun ritardo. Il valore 0 disabilita il ritardo di ripristino. # Il valore predefinito \u00e8 0.4. #x_offset: #y_offset: # Dovrebbe essere lasciato non impostato (o impostato su 0). z_offset: # Altezza di attivazione della sonda. Inizia con -0.1 (mm) e regola in seguito # usando il comando `PROBE_CALIBRATE`. Questo parametro deve essere fornito. #speed: # Velocit\u00e0 (in mm/s) dell'asse Z durante la tastatura. Si consiglia di iniziare con la # velocit\u00e0 di tastatura di 20 mm/s e di regolarla secondo necessit\u00e0 per migliorare la # precisione e la ripetibilit\u00e0 dell'attivazione della sonda. #samples: #sample_retract_dist: #samples_result: #samples_tolerance: #samples_tolerance_retries: #activate_gcode: #deactivate_gcode: #deactivate_on_each_sample: # Vedere la sezione \"probe\" per ulteriori informazioni sui parametri di cui sopra.","title":"[smart_effector]"},{"location":"Config_Reference.html#motori-passo-passo-ed-estrusori-aggiuntivi","text":"","title":"Motori passo-passo ed estrusori aggiuntivi"},{"location":"Config_Reference.html#stepper_z1","text":"Assi multi-stepper. Su una stampante in stile cartesiano, lo stepper che controlla un dato asse pu\u00f2 avere blocchi di configurazione aggiuntivi che definiscono gli stepper che dovrebbero essere azionati insieme allo stepper primario. Si pu\u00f2 definire un numero qualsiasi di sezioni con un suffisso numerico che inizia da 1 (ad esempio, \"stepper_z1\", \"stepper_z2\", ecc.). [stepper_z1] #step_pin: #dir_pin: #enable_pin: #microsteps: #rotation_distance: # Vedere la sezione \"stepper\" per la definizione dei parametri di cui sopra. #endstop_pin: # Se viene definito un endstop_pin per lo stepper aggiuntivo, lo stepper # si fermer\u00e0 fino all'attivazione dell'endstop. In caso contrario, lo stepper # si fermer\u00e0 fino a quando non verr\u00e0 attivato il finecorsa sullo stepper # primario per l'asse.","title":"[stepper_z1]"},{"location":"Config_Reference.html#extruder1","text":"In una stampante multiestrusore aggiungere una sezione estrusore aggiuntiva per ogni estrusore aggiuntivo. Le sezioni aggiuntive dell'estrusore devono essere denominate \"extruder1\", \"extruder2\", \"extruder3\" e cos\u00ec via. Vedere la sezione \"extruder\" per una descrizione dei parametri disponibili. Vedere sample-multi-extruder.cfg per un esempio di configurazione. [extruder1] #step_pin: #dir_pin: #... # Vedere la sezione \"estrusore\" per i parametri per lo stepper e il riscaldatore # disponibili. #shared_heater: # Questa opzione \u00e8 obsoleta e non deve pi\u00f9 essere specificata.","title":"[extruder1]"},{"location":"Config_Reference.html#dual_carriage","text":"Supporto per stampanti cartesiane con doppi carrelli su un unico asse. Il carrello attivo viene impostato tramite il comando G-code esteso SET_DUAL_CARRIAGE. Il comando \"SET_DUAL_CARRIAGE CARRIAGE=1\" attiver\u00e0 il carrello definito in questa sezione (CARRIAGE=0 riporter\u00e0 l'attivazione al carrello principale). Il supporto del doppio carrello \u00e8 in genere combinato con estrusori extra: il comando SET_DUAL_CARRIAGE viene spesso chiamato contemporaneamente al comando ACTIVATE_EXTRUDER. Assicurati di parcheggiare i carrelli durante la disattivazione. Vedere sample-idex.cfg per un esempio di configurazione. [dual_carriage] axis: # L'asse su cui si trova questo carrello aggiuntivo (x o y). Questo parametro # deve essere fornito #step_pin: #dir_pin: #enable_pin: #microsteps: #rotation_distance: #endstop_pin: #position_endstop: #position_min: #position_max: # Vedere la sezione \"stepper\" per la definizione dei parametri di cui sopra.","title":"[dual_carriage]"},{"location":"Config_Reference.html#extruder_stepper","text":"Supporto per stepper aggiuntivi sincronizzati al movimento di un estrusore (si pu\u00f2 definire un numero qualsiasi di sezioni con un prefisso \"extruder_stepper\"). Per ulteriori informazioni, vedere riferimento comando . [extruder_stepper my_extra_stepper] extruder: # L'estrusore con cui \u00e8 sincronizzato questo stepper. Se questo \u00e8 impostato su # una stringa vuota, lo stepper non verr\u00e0 sincronizzato con un # estrusore. Questo parametro deve essere fornito. #step_pin: #dir_pin: #enable_pin: #microsteps: #rotation_distance: # Vedere la sezione \"stepper\" per la definizione dei parametri sopra. # .","title":"[extruder_stepper]"},{"location":"Config_Reference.html#stepper-manuali","text":"Stepper manuali (\u00e8 possibile definire un numero qualsiasi di sezioni con un prefisso \"manual_stepper\"). Questi sono stepper controllati dal comando g-code MANUAL_STEPPER. Ad esempio: \"MANUAL_STEPPER STEPPER=my_stepper MOVE=10 SPEED=5\". Vedere il file G-Codes per una descrizione del comando MANUAL_STEPPER. Gli stepper non sono collegati alla normale cinematica della stampante. [manual_stepper my_stepper] #step_pin: #dir_pin: #enable_pin: #microsteps: #rotation_distance: # Vedere la sezione \"stepper\" per una descrizione di questi parametri. #velocity: # Impostare la velocit\u00e0 predefinita (in mm/s) per lo stepper. Questo # valore verr\u00e0 utilizzato se un comando MANUAL_STEPPER non specifica # un parametro SPEED. Il valore predefinito \u00e8 5 mm/s. #accel: # Imposta l'accelerazione predefinita (in mm/s^2) per lo stepper. # Un'accelerazione pari a zero non risulter\u00e0 in nessuna accelerazione. # Questo valore verr\u00e0 utilizzato se un comando MANUAL_STEPPER non # specifica un parametro ACCEL. Il valore predefinito \u00e8 zero. #endstop_pin: # Pin di rilevamento interruttore di fine corsa. Se specificato, \u00e8 possibile # eseguire \"movimenti di riferimento\" aggiungendo un parametro # STOP_ON_ENDSTOP ai comandi di movimento MANUAL_STEPPER.","title":"[Stepper manuali]"},{"location":"Config_Reference.html#riscaldatori-e-sensori-personalizzati","text":"","title":"Riscaldatori e sensori personalizzati"},{"location":"Config_Reference.html#verify_heater","text":"Verifica riscaldatore e sensore di temperatura. La verifica del riscaldatore viene abilitata automaticamente per ogni riscaldatore configurato sulla stampante. Usa le sezioni di verifica_riscaldatore per modificare le impostazioni predefinite. [verify_heater heater_config_name] #max_error: 120 # Il massimo \"errore di temperatura cumulativo\" prima di generare un # errore. Valori pi\u00f9 piccoli comportano un controllo pi\u00f9 rigoroso e valori # pi\u00f9 grandi consentono pi\u00f9 tempo prima che venga segnalato un errore. # Nello specifico la temperatura viene osservata una volta al secondo e # se \u00e8 prossima alla temperatura target viene azzerato un \"contatore errori\" # interno; in caso contrario, se la temperatura \u00e8 inferiore all'intervallo target, # il contatore viene aumentato della quantit\u00e0 in cui la temperatura riportata # differisce da tale intervallo. Se il contatore supera questo \"errore_max\", # viene generato un errore. Il valore predefinito \u00e8 120. #check_gain_time: # Questo controlla la verifica del riscaldatore durante il riscaldamento # iniziale. Valori pi\u00f9 piccoli comportano un controllo pi\u00f9 rigoroso e valori # pi\u00f9 grandi consentono pi\u00f9 tempo prima che venga segnalato un errore. # In particolare, durante il riscaldamento iniziale, fintanto che il riscaldatore # aumenta di temperatura entro questo intervallo di tempo (specificato in # secondi), il \"contatore errori\" interno viene azzerato. Il valore predefinito # \u00e8 20 secondi per gli estrusori e 60 secondi per heater_bed. #hysteresis: 5 # La differenza di temperatura massima (in gradi Celsius) rispetto a una # temperatura target considerata nell'intervallo del target. Questo controlla # nell'intervallo max_error. \u00c8 raro personalizzare questo valore. # L'impostazione predefinita \u00e8 5. #heating_gain: 2 # La temperatura minima (in gradi Celsius) di cui il riscaldatore deve # aumentare durante il check_gain_time. \u00c8 raro personalizzare questo valore. # L'impostazione predefinita \u00e8 2.","title":"[verify_heater]"},{"location":"Config_Reference.html#homing_heaters","text":"Strumento per disabilitare i riscaldatori durante l'homing o la probing di un asse. [homing_heaters] #steppers: # Un elenco separato da virgole di stepper che dovrebbero causare # la disattivazione dei riscaldatori. L'impostazione predefinita \u00e8 # disabilitare i riscaldatori per qualsiasi spostamento di homing/sonda. # Esempio tipico: stepper_z #heaters: # Un elenco separato da virgole di riscaldatori da disabilitare # durante i movimenti di homing/probing. L'impostazione # predefinita \u00e8 disabilitare tutti i riscaldatori. # Esempio tipico: estrusore, letto riscaldatore","title":"[homing_heaters]"},{"location":"Config_Reference.html#thermistor","text":"Termistori personalizzati (si pu\u00f2 definire un numero qualsiasi di sezioni con un prefisso \"thermistor\"). \u00c8 possibile utilizzare un termistore personalizzato nel campo sensor_type di una sezione di configurazione del riscaldatore. (Ad esempio, se si definisce una sezione \"[thermistor my_thermistor]\", \u00e8 possibile utilizzare un \"sensor_type: my_thermistor\" quando si definisce un riscaldatore.) Assicurati di posizionare la sezione del termistore nel file di configurazione sopra il suo primo utilizzo in una sezione del riscaldatore . [thermistor my_thermistor] #temperature1: #resistance1: #temperature2: #resistance2: #temperature3: #resistance3: # Tre misure di resistenza (in Ohm) alle temperature date (in Celsius). # Le tre misurazioni verranno utilizzate per calcolare i coefficienti di # Steinhart-Hart per il termistore. Questi parametri devono essere # forniti quando si utilizza Steinhart-Hart per definire il termistore. #beta: # In alternativa, \u00e8 possibile definire temperatura1, resistenza1 e beta # per definire i parametri del termistore. Questo parametro deve # essere fornito quando si utilizza \"beta\" per definire il termistore.","title":"[thermistor]"},{"location":"Config_Reference.html#adc_temperature","text":"Sensori di temperatura ADC personalizzati (si pu\u00f2 definire un numero qualsiasi di sezioni con un prefisso \"adc_temperature\"). Ci\u00f2 consente di definire un sensore di temperatura personalizzato che misura una tensione su un pin del convertitore da analogico a digitale (ADC) e utilizza l'interpolazione lineare tra una serie di misurazioni di temperatura/tensione (o temperatura/resistenza) configurate per determinare la temperatura. Il sensore risultante pu\u00f2 essere utilizzato come tipo_sensore in una sezione riscaldatore. (Ad esempio, se si definisce una sezione \"[adc_temperature my_sensor]\", \u00e8 possibile utilizzare un \"sensor_type: my_sensor\" quando si definisce un riscaldatore.) Assicurati di posizionare la sezione del sensore nel file di configurazione sopra il suo primo utilizzo in una sezione del riscaldatore. [adc_temperature my_sensor] #temperature1: #voltage1: #temperature2: #voltage2: #... # A set of temperatures (in Celsius) and voltages (in Volts) to use # as reference when converting a temperature. A heater section using # this sensor may also specify adc_voltage and voltage_offset # parameters to define the ADC voltage (see \"Common temperature # amplifiers\" section for details). At least two measurements must # be provided. #temperature1: #resistance1: #temperature2: #resistance2: #... # Alternatively one may specify a set of temperatures (in Celsius) # and resistance (in Ohms) to use as reference when converting a # temperature. A heater section using this sensor may also specify a # pullup_resistor parameter (see \"extruder\" section for details). At # least two measurements must be provided.","title":"[adc_temperature]"},{"location":"Config_Reference.html#heater_generic","text":"Riscaldatori generici (si pu\u00f2 definire un numero qualsiasi di sezioni con il prefisso \"riscaldatore_generico\"). Questi riscaldatori si comportano in modo simile ai riscaldatori standard (estrusori, piatti riscaldati). Utilizzare il comando SET_HEATER_TEMPERATURE (consultare G-Codes per i dettagli) per impostare la temperatura target. [heater_generic my_generic_heater] #gcode_id: # L'ID da utilizzare quando si riporta la temperatura nel comando M105. # Questo parametro deve essere fornito. #max_power: #sensor_type: #sensor_pin: #smooth_time: #control: #pid_Kp: #pid_Ki: #pid_Kd: #pwm_cycle_time: #min_temp: #max_temp: # Vedere la sezione \"extruder\" per la definizione dei parametri sopra.","title":"[heater_generic]"},{"location":"Config_Reference.html#temperature_sensor","text":"Sensori di temperatura generici. \u00c8 possibile definire un numero qualsiasi di sensori di temperatura aggiuntivi che vengono riportati tramite il comando M105. [temperature_sensor my_sensor] #sensor_type: #sensor_pin: #min_temp: #max_temp: # Vedi la sezione \"extruder\" per la definizione dei parametri # sopra indicati. #gcode_id: # Vedi la sezione \"heater_generic\" per la definizione dei # parametri sopra indicati.","title":"[temperature_sensor]"},{"location":"Config_Reference.html#sensori-di-temperatura","text":"Klipper include definizioni per molti tipi di sensori di temperatura. Questi sensori possono essere utilizzati in qualsiasi sezione di configurazione che richieda un sensore di temperatura (come una sezione [extruder] o [heater_bed] ).","title":"Sensori di temperatura"},{"location":"Config_Reference.html#termistori-comuni","text":"Termistori comuni. I seguenti parametri sono disponibili nelle sezioni del riscaldatore che utilizzano uno di questi sensori. sensor_type: # Uno di \"EPCOS 100K B57560G104F\", \"ATC Semitec 104GT-2\", # \"ATC Semitec 104NT-4-R025H42G\", \"Generic 3950\", # \"Honeywell 100K 135-104LAG-J01\", \"NTC 100K MGB18-104F39050L32\", # \"SliceEngineering 450\", o \"TDK NTCG104LH104JT1\" sensor_pin: # Pin di ingresso analogico collegato al termistore. # Questo parametro deve essere fornito. #pullup_resistor: 4700 # La resistenza (in ohm) del pullup collegato al termistore. # Il valore predefinito \u00e8 4700 ohm. #inline_resistor: 0 # La resistenza (in ohm) di un resistore aggiuntivo (non a variazione di # calore) posizionato in linea con il termistore. \u00c8 raro impostare questo. # Il valore predefinito \u00e8 0 ohm.","title":"Termistori comuni"},{"location":"Config_Reference.html#amplificatori-di-temperatura-comuni","text":"Amplificatori di temperatura comuni. I seguenti parametri sono disponibili nelle sezioni del riscaldatore che utilizzano uno di questi sensori. sensor_type: # Uno tra \"PT100 INA826\", \"AD595\", \"AD597\", \"AD8494\", \"AD8495\", # \"AD8496\", o \"AD8497\". sensor_pin: # Pin di ingresso analogico collegato al sensore. Questo parametro # deve essere fornito. #adc_voltage: 5.0 # La tensione di confronto dell'ADC (in Volt). Il valore predefinito # \u00e8 5 volt. #voltage_offset: 0 # L'offset di tensione ADC (in Volt). Il valore predefinito \u00e8 0.","title":"Amplificatori di temperatura comuni"},{"location":"Config_Reference.html#sensore-pt1000-collegato-direttamente","text":"Sensore PT1000 collegato direttamente. I seguenti parametri sono disponibili nelle sezioni del riscaldatore che utilizzano uno di questi sensori. sensor_type: PT1000 sensor_pin: # Pin di ingresso analogico collegato al sensore. Questo parametro # deve essere fornito. #pullup_resistor: 4700 # La resistenza (in ohm) del pullup collegato al sensore. Il valore # predefinito \u00e8 4700 ohm.","title":"Sensore PT1000 collegato direttamente"},{"location":"Config_Reference.html#sensori-di-temperatura-maxxxxxx","text":"Sensori temperatura MAXxxxxx con interfaccia periferica seriale (SPI). I seguenti parametri sono disponibili nelle sezioni del riscaldatore che utilizzano uno di questi tipi di sensore. sensor_type: # Uno tra \"MAX6675\", \"MAX31855\", \"MAX31856\", o \"MAX31865\". sensor_pin: # Il pin mcu collegato al pin di selezione del chip del sensore. # Questo parametro deve essere fornito. #spi_speed: 4000000 # La velocit\u00e0 SPI (in hz) da utilizzare durante la comunicazione # con il chip. Il valore predefinito \u00e8 4000000. #spi_bus: #spi_software_sclk_pin: #spi_software_mosi_pin: #spi_software_miso_pin: # Vedere la sezione \"impostazioni comuni SPI\" per una # descrizione dei parametri di cui sopra. #tc_type: K #tc_use_50Hz_filter: False #tc_averaging_count: 1 # I parametri di cui sopra controllano i parametri del sensore # dei chip MAX31856. I valori predefiniti per ciascun parametro # sono accanto al nome del parametro nell'elenco precedente. #rtd_nominal_r: 100 #rtd_reference_r: 430 #rtd_num_of_wires: 2 #rtd_use_50Hz_filter: False # I parametri di cui sopra controllano i parametri del sensore dei # chip MAX31865. I valori predefiniti per ciascun parametro sono # accanto al nome del parametro nell'elenco precedente.","title":"Sensori di temperatura MAXxxxxx"},{"location":"Config_Reference.html#sensore-di-temperatura-bmp280bme280bme680","text":"Sensori ambientali BMP280/BME280/BME680 con interfaccia I2C. Si noti che questi sensori non sono destinati all'uso con estrusori e letti riscaldanti, ma piuttosto per il monitoraggio della temperatura ambiente (C), della pressione (hPa), dell'umidit\u00e0 relativa (%)e di livello del gas per il BME680. Vedere sample-macros.cfg per una gcode_macro che pu\u00f2 essere utilizzata per riportare la pressione e l'umidit\u00e0 oltre alla temperatura. sensor_type: BME280 #i2c_address: # Il valore predefinito \u00e8 118 (0x76). Alcuni sensori BME280 hanno un # indirizzo di 119 (0x77). #i2c_mcu: #i2c_bus: #i2c_speed: # Vedere la sezione \"impostazioni comuni I2C\" per una descrizione # dei parametri di cui sopra.","title":"Sensore di temperatura BMP280/BME280/BME680"},{"location":"Config_Reference.html#sensore-htu21d","text":"Sensore ambientale con interfaccia a due fili (I2C) della famiglia HTU21D. Si noti che questo sensore non \u00e8 destinato all'uso con estrusori e letti riscaldanti, ma piuttosto per il monitoraggio della temperatura ambiente (C) e dell'umidit\u00e0 relativa(%). Vedere sample-macros.cfg per una gcode_macro che pu\u00f2 essere utilizzata per riportare l'umidit\u00e0 oltre alla temperatura. sensor_type: # Deve essere \"HTU21D\", \"SI7013\", \"SI7020\", \"SI7021\" o \"SHT21\" #i2c_address: # Il valore predefinito \u00e8 64 (0x40). #i2c_mcu: #i2c_bus: #i2c_speed: # Vedere la sezione \"impostazioni comuni I2C\" per una # descrizione dei parametri di cui sopra. #htu21d_hold_master: # Se il sensore pu\u00f2 trattenere il buf I2C durante la lettura. Se # True nessun'altra comunicazione bus pu\u00f2 essere eseguita mentre # la lettura \u00e8 in corso. L'impostazione predefinita \u00e8 False. #htu21d_resolution: # La risoluzione della lettura di temperatura e umidit\u00e0. # I valori validi sono: # 'TEMP14_HUM12' -> 14bit per Temp e 12bit per umidit\u00e0 # 'TEMP13_HUM10' -> 13bit per Temp e 10bit per umidit\u00e0 # 'TEMP12_HUM08' -> 12bit per Temp e 08bit per umidit\u00e0 # 'TEMP11_HUM11' -> 11bit per Temp e 11bit per umidit\u00e0 # L'impostazione predefinita \u00e8: \"TEMP11_HUM11\" #htu21d_report_time: # Intervallo in secondi tra le letture. Il valore predefinito \u00e8 30","title":"Sensore HTU21D"},{"location":"Config_Reference.html#sensore-di-temperatura-lm75","text":"Sensori di temperatura (I2C) LM75/LM75A. Questi sensori hanno una gamma di -55~125 C, quindi sono utilizzabili ad es. monitoraggio della temperatura della camera. Possono anche funzionare come semplici controller per ventole/riscaldatori. sensor_type: LM75 #i2c_address: # Il valore predefinito \u00e8 72 (0x48). L'intervallo normale \u00e8 72-79 # (0x48-0x4F) e i 3 bit bassi dell'indirizzo sono configurati tramite # pin sul chip (di solito con ponticelli o cablati). #i2c_mcu: #i2c_bus: #i2c_speed: # Vedere la sezione \"impostazioni comuni I2C\" per una descrizione # dei parametri di cui sopra. #lm75_report_time: # Intervallo in secondi tra le letture. Il valore predefinito \u00e8 0.8 # con il minimo 0.5.","title":"Sensore di temperatura LM75"},{"location":"Config_Reference.html#sensore-di-temperatura-integrato-nel-microcontrollore","text":"I microcontrollori atsam, atsamd e stm32 contengono un sensore di temperatura interno. \u00c8 possibile utilizzare il sensore \"temperature_mcu\" per monitorare queste temperature. sensor_type: temperature_mcu #sensor_mcu: mcu # Il microcontrollore da cui leggere. L'impostazione predefinita \u00e8 \"mcu\". #sensor_temperature1: #sensor_adc1: # Specificare i due parametri precedenti (una temperatura in gradi # Celsius e un valore ADC come float compreso tra 0,0 e 1,0) per # calibrare la temperatura del microcontrollore. Ci\u00f2 potrebbe # migliorare la precisione della temperatura riportata su alcuni chip. # Un modo tipico per ottenere queste informazioni di calibrazione # consiste nel rimuovere completamente l'alimentazione dalla # stampante per alcune ore (per assicurarsi che sia alla temperatura # ambiente), quindi accenderla e utilizzare il comando QUERY_ADC # per ottenere una misurazione ADC. Utilizzare un altro sensore di # temperatura sulla stampante per trovare la temperatura ambiente # corrispondente. L'impostazione predefinita consiste nell'utilizzare # i dati di calibrazione di fabbrica sul microcontrollore (se applicabile) # o i valori nominali dalle specifiche del microcontrollore. #sensor_temperature2: #sensor_adc2: # Se viene specificato sensor_temperature1/sensor_adc1, \u00e8 anche # possibile specificare i dati di calibrazione sensor_temperature2/sensor_adc2. # Ci\u00f2 potrebbe fornire informazioni calibrate sulla \"curva della # temperatura\". L'impostazione predefinita consiste nell'utilizzare i dati # di calibrazione di fabbrica sul microcontrollore (se applicabile) o i # valori nominali dalle specifiche del microcontrollore.","title":"Sensore di temperatura integrato nel microcontrollore"},{"location":"Config_Reference.html#sensore-di-temperatura-host","text":"Temperatura dalla macchina (es. Raspberry Pi) che esegue il software host. sensor_type: temperature_host #sensor_path: # il percorso del file di sistema della temperatura. L'impostazione # predefinita \u00e8 \"/sys/class/thermal/thermal_zone0/temp\" che \u00e8 il file di # sistema della temperatura su un computer Raspberry Pi.","title":"Sensore di temperatura host"},{"location":"Config_Reference.html#sensore-di-temperatura-ds18b20","text":"DS18B20 \u00e8 un sensore di temperatura digitale a 1 filo (w1). Si noti che questo sensore non \u00e8 destinato all'uso con estrusori e letti riscaldanti, ma piuttosto per il monitoraggio della temperatura ambiente (C). Questi sensori hanno una portata fino a 125 C, quindi sono utilizzabili ad es. monitoraggio della temperatura della camera. Possono anche funzionare come semplici controller per ventole/riscaldatori. I sensori DS18B20 sono supportati solo su \"host mcu\", ad es. il Raspberry Pi. \u00c8 necessario installare il modulo del kernel Linux w1-gpio. sensor_type: DS18B20 serial_no: # Ogni dispositivo a 1 filo ha un numero di serie univoco utilizzato per # identificare il dispositivo, solitamente nel formato 28-031674b175ff. Questo # parametro deve essere fornito. I dispositivi collegati a 1 filo possono essere # elencati utilizzando il seguente comando Linux: ls /sys/bus/w1/devices/ #ds18_report_time: # Intervallo in secondi tra le letture. Il valore predefinito \u00e8 3.0, con un # minimo di 1.0 #sensor_mcu: # Il microcontrollore da cui leggere. Deve essere host_mcu","title":"Sensore di temperatura DS18B20"},{"location":"Config_Reference.html#ventole","text":"","title":"Ventole"},{"location":"Config_Reference.html#fan","text":"Ventola di raffreddamento della stampa. [fan] pin: # Pin di output che controlla la ventola. Questo parametro deve essere fornito. #max_power: 1.0 # La potenza massima (espressa come un valore compreso tra 0.0 e 1.0) a # cui pu\u00f2 essere impostato il pin. Il valore 1.0 consente di impostare il pin # completamente abilitato per periodi prolungati, mentre un valore di 0.5 # consentirebbe di abilitare il pin per non pi\u00f9 della met\u00e0 del tempo. Questa # impostazione pu\u00f2 essere utilizzata per limitare la potenza totale (per # periodi prolungati) della ventola. Se questo valore \u00e8 inferiore a 1.0, le # richieste di velocit\u00e0 della ventola verranno ridimensionate tra zero e # max_power (ad esempio, se max_power \u00e8 0.9 e viene richiesta una # velocit\u00e0 della ventola dell'80%, la potenza della ventola verr\u00e0 impostata # su 72%). L'impostazione predefinita \u00e8 1.0. #shutdown_speed: 0 # La velocit\u00e0 della ventola desiderata (espressa come valore da 0.0 a # 1.0) se il software del microcontrollore entra in uno stato di errore. # Il valore predefinito \u00e8 0. #cycle_time: 0.010 # La quantit\u00e0 di tempo (in secondi) per ogni ciclo di alimentazione PWM # alla ventola. Si consiglia di essere pari o superiore a 10 millisecondi # quando si utilizza il PWM basato su software. # Il valore predefinito \u00e8 0,010 secondi. #hardware_pwm: False # Abilitare questa opzione per utilizzare PWM hardware anzich\u00e9 PWM # software. La maggior parte delle ventole non funziona bene con PWM # hardware, quindi non \u00e8 consigliabile abilitarlo a meno che non vi sia # un requisito elettrico per passare a velocit\u00e0 molto elevate. Quando # si utilizza l'hardware PWM, il tempo di ciclo effettivo \u00e8 vincolato # dall'implementazione e pu\u00f2 essere notevolmente diverso dal tempo # di ciclo richiesto. L'impostazione predefinita \u00e8 False. #kick_start_time: 0.100 # Tempo (in secondi) per far funzionare la ventola a piena velocit\u00e0 # quando la si abilita per la prima volta o la si aumenta di oltre il 50% # (aiuta a far girare la ventola). Il valore predefinito \u00e8 0,100 secondi. #off_below: 0.0 # La velocit\u00e0 minima in input che alimenter\u00e0 la ventola (espressa # come un valore da 0.0 a 1.0). Quando viene richiesta una velocit\u00e0 # inferiore a off_below la ventola verr\u00e0 invece spenta. Questa # impostazione pu\u00f2 essere utilizzata per prevenire lo stallo della # ventola e per garantire che i kick start siano efficaci. # Il valore predefinito \u00e8 0.0. # # Questa impostazione deve essere ricalibrata ogni volta che # max_power viene regolato. Per calibrare questa impostazione, # inizia con off_below impostato su 0.0 e la ventola gira. Abbassare # gradualmente la velocit\u00e0 della ventola per determinare la velocit\u00e0 # di ingresso pi\u00f9 bassa che aziona la ventola in modo affidabile senza # stalli. Impostare off_below al duty cycle corrispondente a questo # valore (ad esempio, 12% -> 0,12) o leggermente superiore. #tachometer_pin: # Pin di ingresso contagiri per il monitoraggio della velocit\u00e0 della # ventola. In genere \u00e8 richiesto un pullup. Questo parametro \u00e8 facoltativo. #tachometer_ppr: 2 # Quando viene specificato tachometer_pin, questo \u00e8 il numero di # impulsi per giro del segnale del tachimetro. Per una ventola BLDC # questo \u00e8 normalmente la met\u00e0 del numero di poli. # L'impostazione predefinita \u00e8 2. #tachometer_poll_interval: 0.0015 # Quando viene specificato tachometer_pin, questo \u00e8 il periodo di polling # del pin del contagiri, in secondi. Il valore predefinito \u00e8 0.0015, che \u00e8 # abbastanza veloce per le ventole al di sotto di 10000 RPM a 2 PPR. Deve # essere inferiore a 30/(tachometer_ppr*rpm), con un certo margine, # dove rpm \u00e8 la velocit\u00e0 massima (in RPM) della ventola. #enable_pin: # Pin opzionale per abilitare l'alimentazione alla ventola. Questo pu\u00f2 # essere utile per le ventole con ingressi PWM dedicati. Alcune di queste # ventole rimangono accese anche allo 0% di ingresso PWM. In tal caso, # il pin PWM pu\u00f2 essere utilizzato normalmente e ad es. un FET commutato # a terra (pin della ventola standard) pu\u00f2 essere utilizzato per controllare # l'alimentazione alla ventola.","title":"[fan]"},{"location":"Config_Reference.html#heater_fan","text":"Ventole di raffreddamento del riscaldatore (si pu\u00f2 definire un numero qualsiasi di sezioni con un prefisso \"heater_fan\"). Una \"ventola riscaldatore\" \u00e8 una ventola che verr\u00e0 abilitata ogni volta che il riscaldatore associato \u00e8 attivo. Per impostazione predefinita, un heater_fan ha una velocit\u00e0 di spegnimento pari a max_power. [heater_fan my_nozzle_fan] #pin: #max_power: #shutdown_speed: #cycle_time: #hardware_pwm: #kick_start_time: #off_below: #tachometer_pin: #tachometer_ppr: #tachometer_poll_interval: #enable_pin: # Vedere la sezione \"fan\" per una descrizione dei parametri di cui sopra. #heater: extruder # Nome della sezione di configurazione che definisce il riscaldatore a cui # \u00e8 associato questa ventola. Se qui viene fornito un elenco di nomi di # riscaldatori separati da virgole, la ventola verr\u00e0 abilitata quando uno # qualsiasi dei riscaldatori indicati \u00e8 abilitato. # L'impostazione predefinita \u00e8 \"extruder\". #heater_temp: 50.0 # Una temperatura (in gradi Celsius) sotto la quale il riscaldatore deve # scendere prima che la ventola venga disattivata. # L'impostazione predefinita \u00e8 50 gradi Celsius. #fan_speed: 1.0 # La velocit\u00e0 della ventola (espressa come un valore compreso tra 0.0 e # 1.0) a cui verr\u00e0 impostato la ventola quando viene abilitato il relativo # riscaldatore. L'impostazione predefinita \u00e8 1.0","title":"[heater_fan]"},{"location":"Config_Reference.html#controller_fan","text":"Ventola di raffreddamento del controller (\u00e8 possibile definire un numero qualsiasi di sezioni con il prefisso \"controller_fan\"). Una \"ventola del controller\" \u00e8 una ventola che verr\u00e0 abilitata ogni volta che il riscaldatore associato o il driver stepper associato \u00e8 attivo. La ventola si fermer\u00e0 ogni volta che viene raggiunto un idle_timeout per garantire che non si verifichi alcun surriscaldamento dopo la disattivazione di un componente osservato. [controller_fan my_controller_fan] #pin: #max_power: #shutdown_speed: #cycle_time: #hardware_pwm: #kick_start_time: #off_below: #tachometer_pin: #tachometer_ppr: #tachometer_poll_interval: #enable_pin: # Vedere la sezione \"fan\" per una descrizione dei parametri di cui sopra. #fan_speed: 1.0 # La velocit\u00e0 della ventola (espressa come un valore compreso tra 0.0 e # 1.0) a cui verr\u00e0 impostata la ventola quando \u00e8 attivo un riscaldatore # o un driver passo-passo. L'impostazione predefinita \u00e8 1.0 #idle_timeout: # La quantit\u00e0 di tempo (in secondi) dopo che un driver passo-passo o # un riscaldatore \u00e8 stato attivo per la quale la ventola deve essere tenuta # in funzione. L'impostazione predefinita \u00e8 30 secondi. #idle_speed: # La velocit\u00e0 della ventola (espressa come un valore compreso tra 0.0 # e 1.0) a cui verr\u00e0 impostata la ventola quando era attivo un riscaldatore # o un driver passo-passo e prima che venga raggiunto l'idle_timeout. # L'impostazione predefinita \u00e8 fan_speed. #heater: #stepper: # Nome della sezione di configurazione che definisce il riscaldatore/ # stepper a cui \u00e8 associata questa ventola. Se qui viene fornito un # elenco separato da virgole di nomi di riscaldatori/stepper, la ventola # sar\u00e0 abilitata quando uno qualsiasi dei riscaldatori/stepper indicati # \u00e8 abilitato. Il riscaldatore predefinito \u00e8 \"estrusore\", lo stepper # predefinito sono tutti.","title":"[controller_fan]"},{"location":"Config_Reference.html#temperature_fan","text":"Ventole di raffreddamento attivate dalla temperatura (\u00e8 possibile definire un numero qualsiasi di sezioni con un prefisso \"temperature_fan\"). Una \"ventola di temperatura\" \u00e8 una ventola che verr\u00e0 abilitata ogni volta che il sensore associato \u00e8 al di sopra di una temperatura impostata. Per impostazione predefinita, una ventola_temperatura ha una velocit\u00e0_di_arresto pari a potenza_massima. Per ulteriori informazioni, vedere command reference . [temperature_fan my_temp_fan] #pin: #max_power: #shutdown_speed: #cycle_time: #hardware_pwm: #kick_start_time: #off_below: #tachometer_pin: #tachometer_ppr: #tachometer_poll_interval: #enable_pin: # Vedere la sezione \"fan\" per una descrizione dei parametri di cui sopra. #sensor_type: #sensor_pin: #control: #max_delta: #min_temp: #max_temp: # Vedere la sezione \"extruder\" per una descrizione dei parametri di cui sopra. #pid_Kp: #pid_Ki: #pid_Kd: # Le impostazioni proporzionale (pid_Kp), integrale (pid_Ki) e derivata (pid_Kd) # per il sistema di controllo del feedback PID. Klipper valuta le impostazioni PID # con la seguente formula generale: fan_pwm = max_power - (Kp*e + Ki*integral(e) # - Kd*derivative(e)) / 255 Dove \"e\" \u00e8 \"target_temperature - measure_temperature\" # e \"fan_pwm\" \u00e8 la frequenza della ventola richiesta con 0.0 per spento e 1.0 al # massimo. I parametri pid_Kp, pid_Ki e pid_Kd devono essere forniti quando l# 'algoritmo di controllo PID \u00e8 abilitato. #pid_deriv_time: 2.0 # Un valore di tempo (in secondi) su cui le misurazioni della temperatura verranno # livellate quando si utilizza l'algoritmo di controllo PID. Ci\u00f2 pu\u00f2 ridurre l'impatto # del rumore di misurazione. Il valore predefinito \u00e8 2 secondi. #target_temp: 40.0 # Una temperatura (in Celsius) che sar\u00e0 la temperatura target. # L'impostazione predefinita \u00e8 40 gradi. #max_speed: 1.0 # La velocit\u00e0 della ventola (espressa come un valore compreso tra 0.0 e 1.0) a cui # verr\u00e0 impostata la ventola quando la temperatura del sensore supera il valore # impostato. L'impostazione predefinita \u00e8 1.0. #min_speed: 0.3 # La velocit\u00e0 minima della ventola (espressa come un valore compreso tra 0.0 e # 1.0) alla quale la ventola verr\u00e0 impostata per le ventole con temperatura PID. # Il valore predefinito \u00e8 0.3. #gcode_id: # Se impostata, la temperatura verr\u00e0 riportata nelle query M105 utilizzando l'id # fornito. L'impostazione predefinita \u00e8 di non riportare la temperatura tramite M105.","title":"[temperature_fan]"},{"location":"Config_Reference.html#fan_generic","text":"Ventola a controllo manuale (si pu\u00f2 definire un numero qualsiasi di sezioni con il prefisso \"fan_generic\"). La velocit\u00e0 di una ventola controllata manualmente viene impostata con SET_FAN_SPEED comando gcode . [fan_generic extruder_partfan] #pin: #max_power: #shutdown_speed: #cycle_time: #hardware_pwm: #kick_start_time: #off_below: #tachometer_pin: #tachometer_ppr: #tachometer_poll_interval: #enable_pin: # Vedere la sezione \"fan\" per una descrizione dei parametri di cui sopra.","title":"[fan_generic]"},{"location":"Config_Reference.html#leds","text":"","title":"LEDs"},{"location":"Config_Reference.html#led","text":"Supporto per LED (e strisce LED) controllati tramite pin PWM del microcontrollore (si pu\u00f2 definire un numero qualsiasi di sezioni con un prefisso \"led\"). Per ulteriori informazioni, vedere command reference . [led my_led] #red_pin: #green_pin: #blue_pin: #white_pin: # Il pin che controlla il colore del LED specificato. Deve essere fornito # almeno uno dei parametri sopra indicati. #cycle_time: 0.010 # La quantit\u00e0 di tempo (in secondi) per ciclo PWM. Si consiglia che sia # pari o superiore a 10 millisecondi quando si utilizza il PWM basato # su software. Il valore predefinito \u00e8 0,010 secondi. #hardware_pwm: False # Abilitare questa opzione per utilizzare PWM hardware anzich\u00e9 PWM # software. Quando si utilizza l'hardware PWM, il tempo di ciclo effettivo # \u00e8 vincolato dall'implementazione e pu\u00f2 essere notevolmente diverso # dal tempo di ciclo richiesto. L'impostazione predefinita \u00e8 Falso. #initial_RED: 0.0 #initial_GREEN: 0.0 #initial_BLUE: 0.0 #initial_WHITE: 0.0 # Imposta il colore iniziale del LED. Ciascun valore deve essere # compreso tra 0,0 e 1,0. Il valore predefinito per ogni colore \u00e8 0.","title":"[led]"},{"location":"Config_Reference.html#neopixel","text":"Supporto LED Neopixel (aka WS2812) (si pu\u00f2 definire un numero qualsiasi di sezioni con un prefisso \"neopixel\"). Per ulteriori informazioni, vedere riferimento comando . Si noti che l'implementazione di linux mcu non supporta attualmente i neopixel collegati direttamente. L'attuale design che utilizza l'interfaccia del kernel Linux non consente questo scenario perch\u00e9 l'interfaccia GPIO del kernel non \u00e8 sufficientemente veloce da fornire le frequenze di impulso richieste. [neopixel my_neopixel] pin: # Il pin collegato al neopixel. Questo parametro deve essere fornito. #chain_count: # Il numero di chip Neopixel che sono \"collegati a margherita\" al # pin fornito. Il valore predefinito \u00e8 1 (che indica che un solo # Neopixel \u00e8 collegato al pin). #color_order: GRB # Impostare l'ordine dei pixel richiesto dall'hardware del LED # (utilizzando una stringa contenente le lettere R, G, B, W con W # opzionale). In alternativa, questo pu\u00f2 essere un elenco separato # da virgole di pixel, uno per ogni LED nella catena. # L'impostazione predefinita \u00e8 GRB. #initial_RED: 0.0 #initial_GREEN: 0.0 #initial_BLUE: 0.0 #initial_WHITE: 0.0 # Vedere la sezione \"led\" per informazioni su questi parametri.","title":"[neopixel]"},{"location":"Config_Reference.html#dotstar","text":"Supporto LED Dotstar (conosciuti anche come APA102) (si pu\u00f2 definire un numero qualsiasi di sezioni con un prefisso \"dotstar\"). Per ulteriori informazioni, vedere command reference . [dotstar my_dotstar] data_pin: # Il pin connesso alla data line del dotstar. Questo parametro # deve essere fornito. clock_pin: # Il pin connesso alla clock line del dotstar. Questo parametro # deve essere fornito. #chain_count: # Vedere la sezione \"neopixel\" per informazioni su questo parametro. #initial_RED: 0.0 #initial_GREEN: 0.0 #initial_BLUE: 0.0 # Vedere la sezione \"led\" per informazioni su questo parametro.","title":"[dotstar]"},{"location":"Config_Reference.html#pca9533","text":"PCA9533 Supporto LED. Il PCA9533 viene utilizzato sulla scheda mightyboard. [pca9533 my_pca9533] #i2c_address: 98 # L'indirizzo i2c utilizzato dal chip sul bus i2c. Utilizzare 98 per # PCA9533/1, 99 per PCA9533/2. Il valore predefinito \u00e8 98. #i2c_mcu: #i2c_bus: #i2c_speed: # Vedere la sezione \"impostazioni comuni I2C\" per una # descrizione dei parametri di cui sopra. #initial_RED: 0.0 #initial_GREEN: 0.0 #initial_BLUE: 0.0 #initial_WHITE: 0.0 # Vedere la sezione \"led\" per informazioni su questi parametri.","title":"[pca9533]"},{"location":"Config_Reference.html#pca9632","text":"Supporto LED PCA9632. Il PCA9632 viene utilizzato su FlashForge Dreamer. [pca9632 my_pca9632] #i2c_address: 98 # L'indirizzo i2c utilizzato dal chip sul bus i2c. Pu\u00f2 essere 96, # 97, 98 o 99. Il valore predefinito \u00e8 98. #i2c_mcu: #i2c_bus: #i2c_speed: # Vedere la sezione \"impostazioni I2C comuni\" per una # descrizione dei parametri di cui sopra. #scl_pin: #sda_pin: # In alternativa, se il pca9632 non \u00e8 collegato a un bus I2C # hardware, \u00e8 possibile specificare i pin \"clock\" (pin scl) e \"data\" # (pin sda). L'impostazione predefinita prevede l'utilizzo # dell'hardware I2C. #color_order: RGBW # Impostare l'ordine dei pixel del LED (usando una stringa # contenente le lettere R, G, B, W). L'impostazione predefinita # \u00e8 RGBW. #initial_RED: 0.0 #initial_GREEN: 0.0 #initial_BLUE: 0.0 #initial_WHITE: 0.0 # Vedere la sezione \"led\" per informazioni su questi parametri.","title":"[pca9632]"},{"location":"Config_Reference.html#servocomandi-aggiuntivi-pulsanti-e-altri-pin","text":"","title":"Servocomandi aggiuntivi, pulsanti e altri pin"},{"location":"Config_Reference.html#servo","text":"Servo (si pu\u00f2 definire un numero qualsiasi di sezioni con un prefisso \"servo\"). I servo possono essere controllati usando SET_SERVO comando g-code . Ad esempio: SET_SERVO SERVO=my_servo ANGLE=180 [servo my_servo] pin: # Pin di uscita PWM che controlla il servo. Questo parametro deve # essere fornito. #maximum_servo_angle: 180 # L'angolo massimo (in gradi) a cui questo servo pu\u00f2 essere impostato. # L'impostazione predefinita \u00e8 180 gradi. #minimum_pulse_width: 0.001 # La durata minima dell'impulso (in secondi). Questo dovrebbe # corrispondere a un angolo di 0 gradi. Il valore predefinito \u00e8 0.001 secondi. #maximum_pulse_width: 0.002 # La durata massima dell'impulso (in secondi). Questo dovrebbe # corrispondere a un angolo di maximum_servo_angle. Il valore # predefinito \u00e8 0.002 secondi. #initial_angle: # Angolo iniziale (in gradi) su cui impostare il servo. L'impostazione # predefinita \u00e8 di non inviare alcun segnale all'avvio. #initial_pulse_width: # Durata iniziale dell'impulso (in secondi) su cui impostare il servo. # (Questo \u00e8 valido solo se initial_angle non \u00e8 impostato.) # L'impostazione predefinita \u00e8 di non inviare alcun segnale all'avvio.","title":"[servo]"},{"location":"Config_Reference.html#gcode_button","text":"Esegui gcode quando un pulsante viene premuto o rilasciato (o quando un pin cambia stato). Puoi controllare lo stato del pulsante usando QUERY_BUTTON button=my_gcode_button . [gcode_button my_gcode_button] pin: # Il pin su cui \u00e8 collegato il pulsante. Questo parametro deve essere fornito. #analog_range: # Due resistenze separate da virgole (in Ohm) che specificano l'intervallo # di resistenza minimo e massimo per il pulsante. Se viene fornito # analog_range, il pin deve essere un pin con capacit\u00e0 analogica. # L'impostazione predefinita \u00e8 utilizzare digital gpio per il pulsante. #analog_pullup_resistor: # La resistenza di pullup (in Ohm) quando \u00e8 specificato analog_range. # Il valore predefinito \u00e8 4700 ohm. #press_gcode: # Un elenco di comandi G-Code da eseguire quando si preme il pulsante. # I modelli G-Code sono supportati. Questo parametro deve essere fornito. #release_gcode: # Un elenco di comandi G-Code da eseguire quando il pulsante viene # rilasciato. I modelli G-Code sono supportati. L'impostazione predefinita # \u00e8 di non eseguire alcun comando al rilascio di un pulsante.","title":"[gcode_button]"},{"location":"Config_Reference.html#output_pin","text":"Pin di uscita configurabili in fase di run-time (\u00e8 possibile definire un numero qualsiasi di sezioni con un prefisso \"output_pin\"). I pin configurati qui verranno impostati come pin di output e sar\u00e0 possibile modificarli in fase di esecuzione utilizzando il comando esteso \"SET_PIN PIN=my_pin VALUE=.1\" comandi g-code . [output_pin my_pin] pin: # Il pin da configurare come output. # Questo parametro deve essere fornito. #pwm: False # Impostare se il pin di uscita deve essere in grado di modulare la # larghezza di impulso PWM. Se questo \u00e8 True, i campi del valore # dovrebbero essere compresi tra 0 e 1; se \u00e8 False i campi del valore # devono essere 0 o 1. Il valore predefinito \u00e8 False. #static_value: # Se \u00e8 valorizzato, il pin viene assegnato a questo valore all'avvio e # il pin non pu\u00f2 essere modificato durante il runtime. Un pin statico # utilizza una ram leggermente inferiore nel microcontrollore. # L'impostazione predefinita prevede l'utilizzo della configurazione # di runtime dei pin. #value: # Il valore su cui impostare inizialmente il pin durante la # configurazione dell'MCU. Il valore predefinito \u00e8 0 (per bassa tensione). #shutdown_value: # Il valore su cui impostare il pin su un evento di arresto dell'MCU. # Il valore predefinito \u00e8 0 (per bassa tensione). #maximum_mcu_duration: # La durata massima di un valore di non spegnimento pu\u00f2 essere # determinato dall'MCU senza un riconoscimento da parte dell'host. # Se l'host non riesce a tenere il passo con un aggiornamento, l'MCU # si spegner\u00e0 e imposter\u00e0 tutti i pin sui rispettivi valori di spegnimento. # Default: 0 (disabilitato) I valori abituali sono circa 5 secondi. #cycle_time: 0.100 # La quantit\u00e0 di tempo (in secondi) per ciclo PWM. Si consiglia di # essere pari o superiore a 10 millisecondi quando si utilizza il PWM # basato su software. Il valore predefinito \u00e8 0.100 secondi per i pin pwm. #hardware_pwm: False # Abilitare questa opzione per utilizzare PWM hardware anzich\u00e9 PWM # software. Quando si utilizza l'hardware PWM, il tempo di ciclo effettivo # \u00e8 vincolato dall'implementazione e pu\u00f2 essere notevolmente diverso # dal tempo di ciclo richiesto. L'impostazione predefinita \u00e8 Falso. #scale: # Questo parametro pu\u00f2 essere utilizzato per modificare il modo in cui # i parametri 'value' e 'shutdown_value' vengono interpretati per i pin # pwm. Se fornito, il parametro 'value' deve essere compreso tra 0.0 e # 'scale'. Questo pu\u00f2 essere utile quando si configura un pin PWM che # controlla un riferimento di tensione stepper. La \"scala\" pu\u00f2 essere # impostata sull'amperaggio dello stepper equivalente se il PWM fosse # completamente abilitato, quindi il parametro \"value\" pu\u00f2 essere # specificato utilizzando l'amperaggio desiderato per lo stepper. # L'impostazione predefinita \u00e8 di non ridimensionare il parametro 'value'.","title":"[output_pin]"},{"location":"Config_Reference.html#static_digital_output","text":"Pin di uscita digitali configurati staticamente (\u00e8 possibile definire un numero qualsiasi di sezioni con un prefisso \"static_digital_output\"). I pin configurati qui verranno impostati come uscita GPIO durante la configurazione dell'MCU. Non possono essere modificati in fase di esecuzione. [static_digital_output my_output_pins] pins: # Un elenco separato da virgole di pin da impostare come pin di # output GPIO. Il pin verr\u00e0 impostato su un livello alto a meno che il # nome del pin non sia preceduto da \"!\". Questo parametro deve # essere fornito.","title":"[static_digital_output]"},{"location":"Config_Reference.html#multi_pin","text":"Uscite a pin multipli (si pu\u00f2 definire un numero qualsiasi di sezioni con un prefisso \"multi_pin\"). Un output multi_pin crea un alias pin interno che pu\u00f2 modificare pi\u00f9 pin di output ogni volta che viene impostato il pin alias. Ad esempio, si potrebbe definire un oggetto \"[multi_pin my_fan]\" contenente due pin e quindi impostare \"pin=multi_pin:my_fan\" nella sezione \"[fan]\" - ad ogni cambio di ventola entrambi i pin di output verrebbero aggiornati. Questi alias non possono essere utilizzati con i pin del motore passo-passo. [multi_pin my_multi_pin] pins: # Un elenco separato da virgole di pin associati a questo alias. # Questo parametro deve essere fornito.","title":"[multi_pin]"},{"location":"Config_Reference.html#configurazione-del-driver-tmc-per-stepper","text":"Configurazione dei driver per motori passo-passo Trinamic in modalit\u00e0 UART/SPI. Ulteriori informazioni si trovano nella TMC Drivers guide e nel command reference .","title":"Configurazione del driver TMC per stepper"},{"location":"Config_Reference.html#tmc2130","text":"Configurare un driver per motore passo-passo TMC2130 tramite bus SPI. Per utilizzare questa funzione, definire una sezione di configurazione con un prefisso \"tmc2130\" seguito dal nome della sezione di configurazione dello stepper corrispondente (ad esempio, \"[tmc2130 stepper_x]\"). [tmc2130 stepper_x] cs_pin: # The pin corresponding to the TMC2130 chip select line. This pin # will be set to low at the start of SPI messages and raised to high # after the message completes. This parameter must be provided. #spi_speed: #spi_bus: #spi_software_sclk_pin: #spi_software_mosi_pin: #spi_software_miso_pin: # See the \"common SPI settings\" section for a description of the # above parameters. #chain_position: #chain_length: # These parameters configure an SPI daisy chain. The two parameters # define the stepper position in the chain and the total chain length. # Position 1 corresponds to the stepper that connects to the MOSI signal. # The default is to not use an SPI daisy chain. #interpolate: True # If true, enable step interpolation (the driver will internally # step at a rate of 256 micro-steps). This interpolation does # introduce a small systemic positional deviation - see # TMC_Drivers.md for details. The default is True. run_current: # The amount of current (in amps RMS) to configure the driver to use # during stepper movement. This parameter must be provided. #hold_current: # The amount of current (in amps RMS) to configure the driver to use # when the stepper is not moving. Setting a hold_current is not # recommended (see TMC_Drivers.md for details). The default is to # not reduce the current. #sense_resistor: 0.110 # The resistance (in ohms) of the motor sense resistor. The default # is 0.110 ohms. #stealthchop_threshold: 0 # The velocity (in mm/s) to set the \"stealthChop\" threshold to. When # set, \"stealthChop\" mode will be enabled if the stepper motor # velocity is below this value. The default is 0, which disables # \"stealthChop\" mode. #driver_MSLUT0: 2863314260 #driver_MSLUT1: 1251300522 #driver_MSLUT2: 608774441 #driver_MSLUT3: 269500962 #driver_MSLUT4: 4227858431 #driver_MSLUT5: 3048961917 #driver_MSLUT6: 1227445590 #driver_MSLUT7: 4211234 #driver_W0: 2 #driver_W1: 1 #driver_W2: 1 #driver_W3: 1 #driver_X1: 128 #driver_X2: 255 #driver_X3: 255 #driver_START_SIN: 0 #driver_START_SIN90: 247 # These fields control the Microstep Table registers directly. The optimal # wave table is specific to each motor and might vary with current. An # optimal configuration will have minimal print artifacts caused by # non-linear stepper movement. The values specified above are the default # values used by the driver. The value must be specified as a decimal integer # (hex form is not supported). In order to compute the wave table fields, # see the tmc2130 \"Calculation Sheet\" from the Trinamic website. #driver_IHOLDDELAY: 8 #driver_TPOWERDOWN: 0 #driver_TBL: 1 #driver_TOFF: 4 #driver_HEND: 7 #driver_HSTRT: 0 #driver_PWM_AUTOSCALE: True #driver_PWM_FREQ: 1 #driver_PWM_GRAD: 4 #driver_PWM_AMPL: 128 #driver_SGT: 0 # Set the given register during the configuration of the TMC2130 # chip. This may be used to set custom motor parameters. The # defaults for each parameter are next to the parameter name in the # above list. #diag0_pin: #diag1_pin: # The micro-controller pin attached to one of the DIAG lines of the # TMC2130 chip. Only a single diag pin should be specified. The pin # is \"active low\" and is thus normally prefaced with \"^!\". Setting # this creates a \"tmc2130_stepper_x:virtual_endstop\" virtual pin # which may be used as the stepper's endstop_pin. Doing this enables # \"sensorless homing\". (Be sure to also set driver_SGT to an # appropriate sensitivity value.) The default is to not enable # sensorless homing.","title":"[tmc2130]"},{"location":"Config_Reference.html#tmc2208","text":"Configurare un driver per motore passo-passo TMC2208 (o TMC2224) tramite UART a filo singolo. Per utilizzare questa funzione, definire una sezione di configurazione con un prefisso \"tmc2208\" seguito dal nome della sezione di configurazione dello stepper corrispondente (ad esempio, \"[tmc2208 stepper_x]\"). [tmc2208 stepper_x] uart_pin: # Il pin collegato al PDN_UART del TMC2208 . # Questo parametro deve essere fornito. #tx_pin: # Se si utilizzano linee di ricezione e trasmissione separate per # comunicare con il driver, impostare uart_pin sul pin di ricezione e # tx_pin sul pin di trasmissione. L'impostazione predefinita \u00e8 usare uart_pin sia per la lettura che per la scrittura. #select_pins: # Un elenco separato da virgole di pin da impostare prima di accedere # all'UART tmc2208. Questo pu\u00f2 essere utile per configurare un mux # analogico per la comunicazione UART. L'impostazione predefinita \u00e8 # di non configurare alcun pin. #interpolate: True # Se True, abilita l'interpolazione del passo (il driver eseguir\u00e0 un passo # intero con 256 micropassi). Questa interpolazione # introduce una piccola deviazione posizionale sistemica - vedere # TMC_Drivers.md per i dettagli. L'impostazione predefinita \u00e8 True. run_current: # La quantit\u00e0 di corrente (in ampere RMS) per configurare il driver da # utilizzare durante il movimento passo-passo. # Questo parametro deve essere fornito. #hold_current: # La quantit\u00e0 di corrente (in ampere RMS) per configurare il driver da # utilizzare quando lo stepper non \u00e8 in movimento. L'impostazione di # hold_current non \u00e8 consigliata (consultare TMC_Drivers.md per i # dettagli). L'impostazione predefinita \u00e8 di non ridurre la corrente. #sense_resistor: 0.110 # La resistenza (in ohm) del resistore di rilevamento del motore. # Il valore predefinito \u00e8 0,110 ohm. #stealthchop_threshold: 0 # La velocit\u00e0 (in mm/s) su cui impostare la soglia \"stealthChop\". Se # impostata, la modalit\u00e0 \"stealthChop\" sar\u00e0 abilitata se la velocit\u00e0 del # motore passo-passo \u00e8 inferiore a questo valore. Il valore predefinito # \u00e8 0, che disabilita la modalit\u00e0 \"stealthChop\". #driver_IHOLDDELAY: 8 #driver_TPOWERDOWN: 20 #driver_TBL: 2 #driver_TOFF: 3 #driver_HEND: 0 #driver_HSTRT: 5 #driver_PWM_AUTOGRAD: True #driver_PWM_AUTOSCALE: True #driver_PWM_LIM: 12 #driver_PWM_REG: 8 #driver_PWM_FREQ: 1 #driver_PWM_GRAD: 14 #driver_PWM_OFS: 36 # Impostare il registro dato durante la configurazione del chip TMC2208. # Pu\u00f2 essere utilizzato per impostare parametri motore personalizzati. # I valori predefiniti per ciascun parametro sono accanto al nome del # parametro nell'elenco precedente.","title":"[tmc2208]"},{"location":"Config_Reference.html#tmc2209","text":"Configurare un driver per motore passo-passo TMC2209 tramite UART a filo singolo. Per utilizzare questa funzione, definire una sezione di configurazione con un prefisso \"tmc2209\" seguito dal nome della sezione di configurazione dello stepper corrispondente (ad esempio, \"[tmc2209 stepper_x]\"). [tmc2209 stepper_x] uart_pin: #tx_pin: #select_pins: #interpolate: True run_current: #hold_current: #sense_resistor: 0.110 #stealthchop_threshold: 0 # Vedere la sezione \"tmc2208\" per la definizione di questi parametri. #uart_address: # L'indirizzo del chip TMC2209 per i messaggi UART (un numero intero # compreso tra 0 e 3). Viene in genere utilizzato quando pi\u00f9 chip TMC2209 # sono collegati allo stesso pin UART. Il valore predefinito \u00e8 zero #driver_IHOLDDELAY: 8 #driver_TPOWERDOWN: 20 #driver_TBL: 2 #driver_TOFF: 3 #driver_HEND: 0 #driver_HSTRT: 5 #driver_PWM_AUTOGRAD: True #driver_PWM_AUTOSCALE: True #driver_PWM_LIM: 12 #driver_PWM_REG: 8 #driver_PWM_FREQ: 1 #driver_PWM_GRAD: 14 #driver_PWM_OFS: 36 #driver_SGTHRS: 0 # Impostare il registro dato durante la configurazione del chip TMC2209. # Pu\u00f2 essere utilizzato per impostare parametri motore personalizzati. I # valori predefiniti per ciascun parametro sono accanto al nome del # parametro nell'elenco precedente. #diag_pin: # Il pin del microcontrollore collegato alla linea DIAG del chip TMC2209. # Il pin \u00e8 normalmente preceduto da \"^\" per abilitare un pullup. # L'impostazione di questo crea un pin virtuale \"tmc2209_stepper_x:virtual_endstop\" # che pu\u00f2 essere utilizzato come endstop_pin dello stepper. In questo modo # si abilita l'\"homing sensorless\". (Assicurarsi di impostare anche driver_SGTHRS # su un valore di sensibilit\u00e0 appropriato.) L'impostazione predefinita \u00e8 di non # abilitare l'homing sensorless.","title":"[tmc2209]"},{"location":"Config_Reference.html#tmc2660","text":"Configurare un driver per motore passo-passo TMC2660 tramite bus SPI. Per utilizzare questa funzione, definire una sezione di configurazione con un prefisso tmc2660 seguito dal nome della sezione di configurazione dello stepper corrispondente (ad esempio, \"[tmc2660 stepper_x]\"). [tmc2660 stepper_x] cs_pin: # Il pin corrispondente al pin di selezione del chip TMC2660. Questo pin # verr\u00e0 impostato su basso all'inizio dei messaggi SPI e impostato su # alto al termine del trasferimento del messaggio. Questo parametro # deve essere fornito. #spi_speed: 4000000 # Frequenza bus SPI utilizzata per comunicare con il driver # passo-passo TMC2660. Il valore predefinito \u00e8 4000000. #spi_bus: #spi_software_sclk_pin: #spi_software_mosi_pin: #spi_software_miso_pin: # Vedere la sezione \"impostazioni comuni SPI\" per una descrizione # dei parametri di cui sopra. #interpolate: True # Se true, abilita l'interpolazione del passo (il driver eseguir\u00e0 un passo # interno a una velocit\u00e0 di 256 micropassi). Funziona solo se microsteps # \u00e8 impostato su 16. L'interpolazione introduce una piccola deviazione # posizionale sistemica - vedere TMC_Drivers.md per i dettagli. # L'impostazione predefinita \u00e8 Vero. run_current: # La quantit\u00e0 di corrente (in ampere RMS) utilizzata dal driver durante # il movimento passo-passo. Questo parametro deve essere fornito. #sense_resistor: # La resistenza (in ohm) del resistore di rilevamento del motore. # Questo parametro deve essere fornito. #idle_current_percent: 100 # La percentuale di run_current a cui il driver stepper sar\u00e0 ridotto allo # scadere del timeout di inattivit\u00e0 (\u00e8 necessario impostare il timeout # utilizzando una sezione di configurazione [idle_timeout]). La corrente # verr\u00e0 nuovamente aumentata una volta che lo stepper dovr\u00e0 muoversi # di nuovo. Assicurati di impostarlo su un valore sufficientemente alto in # modo che gli stepper non perdano la loro posizione. C'\u00e8 anche un piccolo # ritardo fino a quando la corrente non viene nuovamente aumentata, # quindi tienine conto quando comandi mosse veloci mentre lo stepper \u00e8 # al minimo. Il valore predefinito \u00e8 100 (nessuna riduzione). #driver_TBL: 2 #driver_RNDTF: 0 #driver_HDEC: 0 #driver_CHM: 0 #driver_HEND: 3 #driver_HSTRT: 3 #driver_TOFF: 4 #driver_SEIMIN: 0 #driver_SEDN: 0 #driver_SEMAX: 0 #driver_SEUP: 0 #driver_SEMIN: 0 #driver_SFILT: 0 #driver_SGT: 0 #driver_SLPH: 0 #driver_SLPL: 0 #driver_DISS2G: 0 #driver_TS2G: 3 # Imposta il parametro indicato durante la configurazione del chip TMC2660. # Questo pu\u00f2 essere utilizzato per impostare parametri del driver personalizzati. # Le impostazioni predefinite per ogni parametro sono accanto al nome del # parametro nell'elenco sopra. Vedere la scheda tecnica del TMC2660 su cosa # fa ogni parametro e quali sono le restrizioni sulle combinazioni di parametri. # Prestare particolare attenzione al registro CHOPCONF, dove l'impostazione # di CHM su zero o uno comporter\u00e0 modifiche al layout (il primo bit di HDEC) # viene interpretato come MSB di HSTRT in questo caso).","title":"[tmc2660]"},{"location":"Config_Reference.html#tmc5160","text":"Configurare un driver per motore passo-passo TMC5160 tramite bus SPI. Per utilizzare questa funzione, definire una sezione di configurazione con un prefisso \"tmc5160\" seguito dal nome della sezione di configurazione dello stepper corrispondente (ad esempio, \"[tmc5160 stepper_x]\"). [tmc5160 stepper_x] cs_pin: # The pin corresponding to the TMC5160 chip select line. This pin # will be set to low at the start of SPI messages and raised to high # after the message completes. This parameter must be provided. #spi_speed: #spi_bus: #spi_software_sclk_pin: #spi_software_mosi_pin: #spi_software_miso_pin: # See the \"common SPI settings\" section for a description of the # above parameters. #chain_position: #chain_length: # These parameters configure an SPI daisy chain. The two parameters # define the stepper position in the chain and the total chain length. # Position 1 corresponds to the stepper that connects to the MOSI signal. # The default is to not use an SPI daisy chain. #interpolate: True # If true, enable step interpolation (the driver will internally # step at a rate of 256 micro-steps). The default is True. run_current: # The amount of current (in amps RMS) to configure the driver to use # during stepper movement. This parameter must be provided. #hold_current: # The amount of current (in amps RMS) to configure the driver to use # when the stepper is not moving. Setting a hold_current is not # recommended (see TMC_Drivers.md for details). The default is to # not reduce the current. #sense_resistor: 0.075 # The resistance (in ohms) of the motor sense resistor. The default # is 0.075 ohms. #stealthchop_threshold: 0 # The velocity (in mm/s) to set the \"stealthChop\" threshold to. When # set, \"stealthChop\" mode will be enabled if the stepper motor # velocity is below this value. The default is 0, which disables # \"stealthChop\" mode. #driver_MSLUT0: 2863314260 #driver_MSLUT1: 1251300522 #driver_MSLUT2: 608774441 #driver_MSLUT3: 269500962 #driver_MSLUT4: 4227858431 #driver_MSLUT5: 3048961917 #driver_MSLUT6: 1227445590 #driver_MSLUT7: 4211234 #driver_W0: 2 #driver_W1: 1 #driver_W2: 1 #driver_W3: 1 #driver_X1: 128 #driver_X2: 255 #driver_X3: 255 #driver_START_SIN: 0 #driver_START_SIN90: 247 # These fields control the Microstep Table registers directly. The optimal # wave table is specific to each motor and might vary with current. An # optimal configuration will have minimal print artifacts caused by # non-linear stepper movement. The values specified above are the default # values used by the driver. The value must be specified as a decimal integer # (hex form is not supported). In order to compute the wave table fields, # see the tmc2130 \"Calculation Sheet\" from the Trinamic website. #driver_IHOLDDELAY: 6 #driver_TPOWERDOWN: 10 #driver_TBL: 2 #driver_TOFF: 3 #driver_HEND: 2 #driver_HSTRT: 5 #driver_FD3: 0 #driver_TPFD: 4 #driver_CHM: 0 #driver_VHIGHFS: 0 #driver_VHIGHCHM: 0 #driver_DISS2G: 0 #driver_DISS2VS: 0 #driver_PWM_AUTOSCALE: True #driver_PWM_AUTOGRAD: True #driver_PWM_FREQ: 0 #driver_FREEWHEEL: 0 #driver_PWM_GRAD: 0 #driver_PWM_OFS: 30 #driver_PWM_REG: 4 #driver_PWM_LIM: 12 #driver_SGT: 0 #driver_SEMIN: 0 #driver_SEUP: 0 #driver_SEMAX: 0 #driver_SEDN: 0 #driver_SEIMIN: 0 #driver_SFILT: 0 # Set the given register during the configuration of the TMC5160 # chip. This may be used to set custom motor parameters. The # defaults for each parameter are next to the parameter name in the # above list. #diag0_pin: #diag1_pin: # The micro-controller pin attached to one of the DIAG lines of the # TMC5160 chip. Only a single diag pin should be specified. The pin # is \"active low\" and is thus normally prefaced with \"^!\". Setting # this creates a \"tmc5160_stepper_x:virtual_endstop\" virtual pin # which may be used as the stepper's endstop_pin. Doing this enables # \"sensorless homing\". (Be sure to also set driver_SGT to an # appropriate sensitivity value.) The default is to not enable # sensorless homing.","title":"[tmc5160]"},{"location":"Config_Reference.html#configurazione-della-corrente-del-motore-passo-passo-a-run-time","text":"","title":"Configurazione della corrente del motore passo-passo a run-time"},{"location":"Config_Reference.html#ad5206","text":"Digipot AD5206 configurati staticamente collegati tramite bus SPI (si pu\u00f2 definire un numero qualsiasi di sezioni con un prefisso \"ad5206\"). [ad5206 my_digipot] enable_pin: # The pin corresponding to the AD5206 chip select line. This pin # will be set to low at the start of SPI messages and raised to high # after the message completes. This parameter must be provided. #spi_speed: #spi_bus: #spi_software_sclk_pin: #spi_software_mosi_pin: #spi_software_miso_pin: # See the \"common SPI settings\" section for a description of the # above parameters. #channel_1: #channel_2: #channel_3: #channel_4: #channel_5: #channel_6: # The value to statically set the given AD5206 channel to. This is # typically set to a number between 0.0 and 1.0 with 1.0 being the # highest resistance and 0.0 being the lowest resistance. However, # the range may be changed with the 'scale' parameter (see below). # If a channel is not specified then it is left unconfigured. #scale: # This parameter can be used to alter how the 'channel_x' parameters # are interpreted. If provided, then the 'channel_x' parameters # should be between 0.0 and 'scale'. This may be useful when the # AD5206 is used to set stepper voltage references. The 'scale' can # be set to the equivalent stepper amperage if the AD5206 were at # its highest resistance, and then the 'channel_x' parameters can be # specified using the desired amperage value for the stepper. The # default is to not scale the 'channel_x' parameters.","title":"[ad5206]"},{"location":"Config_Reference.html#mcp4451","text":"Digipot MCP4451 configurato staticamente collegato tramite bus I2C (si pu\u00f2 definire un numero qualsiasi di sezioni con un prefisso \"mcp4451\"). [mcp4451 my_digipot] i2c_address: # L'indirizzo i2c utilizzato dal chip sul bus i2c. Questo parametro deve # essere fornito. #i2c_mcu: #i2c_bus: #i2c_speed: # Vedere la sezione \"impostazioni I2C comuni\" per una descrizione # dei parametri di cui sopra. #wiper_0: #wiper_1: #wiper_2: #wiper_3: # Il valore su cui impostare staticamente il \"wiper\" MCP4451 # specificato. Questo \u00e8 in genere impostato su un numero compreso # tra 0,0 e 1,0 con 1,0 come resistenza pi\u00f9 alta e 0,0 come resistenza # pi\u00f9 bassa. Tuttavia, l'intervallo pu\u00f2 essere modificato con il parametro # 'scale' (vedi sotto). Se non viene specificato un wiper, non viene # configurato. #scale: # Questo parametro pu\u00f2 essere utilizzato per modificare il modo in # cui vengono interpretati i parametri 'wiper_x'. Se forniti, i parametri # 'wiper_x' dovrebbero essere compresi tra 0.0 e 'scale'. Questo pu\u00f2 # essere utile quando l'MCP4451 viene utilizzato per impostare i # riferimenti di tensione stepper. La \"scala\" pu\u00f2 essere impostata # sull'amperaggio stepper equivalente se l'MCP4451 fosse alla sua # massima resistenza, quindi i parametri \"wiper_x\" possono essere # specificati utilizzando il valore di amperaggio desiderato per lo # stepper. L'impostazione predefinita \u00e8 di non ridimensionare i # parametri 'wiper_x'.","title":"[mcp4451]"},{"location":"Config_Reference.html#mcp4728","text":"Convertitore digitale-analogico MCP4728 in configurazione statica collegato tramite bus I2C (\u00e8 possibile definire un numero qualsiasi di sezioni con prefisso \"mcp4728\"). [mcp4728 my_dac] #i2c_address: 96 # L'indirizzo i2c utilizzato dal chip sul bus i2c. Il valore predefinito # \u00e8 96. #i2c_mcu: #i2c_bus: #i2c_speed: # Vedere la sezione \"impostazioni I2C comuni\" per una descrizione # dei parametri di cui sopra. #channel_a: #channel_b: #channel_c: #channel_d: # Il valore su cui impostare staticamente il canale MCP4728 # specificato. Questo \u00e8 in genere impostato su un numero compreso # tra 0,0 e 1,0 con 1,0 come tensione pi\u00f9 alta (2,048 V) e 0,0 come # tensione pi\u00f9 bassa. Tuttavia, l'intervallo pu\u00f2 essere modificato con # il parametro 'scale' (vedi sotto). Se un canale non \u00e8 specificato, # non viene configurato. #scale: # Questo parametro pu\u00f2 essere utilizzato per modificare il modo # in cui vengono interpretati i parametri 'channel_x'. Se forniti, i # parametri 'channel_x' dovrebbero essere compresi tra 0.0 e 'scale'. # Questo pu\u00f2 essere utile quando l'MCP4728 viene utilizzato per # impostare i riferimenti di tensione stepper. La \"scala\" pu\u00f2 essere # impostata sull'amperaggio stepper equivalente se l'MCP4728 # fosse alla sua tensione pi\u00f9 alta (2,048 V), e quindi i parametri # \"channel_x\" possono essere specificati utilizzando il valore di # amperaggio desiderato per lo stepper. L'impostazione # predefinita \u00e8 di non ridimensionare i parametri 'channel_x'.","title":"[mcp4728]"},{"location":"Config_Reference.html#mcp4018","text":"Digipot MCP4018 configurato staticamente collegato tramite due pin gpio \"bit banging\" (si pu\u00f2 definire un numero qualsiasi di sezioni con un prefisso \"mcp4018\"). [mcp4018 my_digipot] scl_pin: # Il pin \"clock\" SCL. Questo parametro deve essere fornito. sda_pin: # Il pin \"dati\" SDA. Questo parametro deve essere fornito. wiper: # Il valore su cui impostare staticamente il \"Wiper\" MCP4018 # specificato. Questo \u00e8 in genere impostato su un numero compreso # tra 0,0 e 1,0 con 1,0 come resistenza pi\u00f9 alta e 0,0 come resistenza # pi\u00f9 bassa. Tuttavia, l'intervallo pu\u00f2 essere modificato con il # parametro 'scale' (vedi sotto). Questo parametro deve essere fornito. #scale: # Questo parametro pu\u00f2 essere utilizzato per modificare il modo in # cui viene interpretato il parametro 'wiper'. Se fornito, il parametro # 'wiper' dovrebbe essere compreso tra 0.0 e 'scale'. Questo pu\u00f2 essere # utile quando l'MCP4018 viene utilizzato per impostare i riferimenti di # tensione stepper. La \"scala\" pu\u00f2 essere impostata sull'amperaggio # stepper equivalente se l'MCP4018 \u00e8 alla sua massima resistenza, # quindi \u00e8 possibile specificare il parametro \"wiper\" utilizzando il # valore di amperaggio desiderato per lo stepper. L'impostazione # predefinita \u00e8 di non ridimensionare il parametro 'wiper'.","title":"[mcp4018]"},{"location":"Config_Reference.html#supporto-display","text":"","title":"Supporto display"},{"location":"Config_Reference.html#display","text":"Supporto per un display collegato al microcontrollore. [display] lcd_type: # The type of LCD chip in use. This may be \"hd44780\", \"hd44780_spi\", # \"st7920\", \"emulated_st7920\", \"uc1701\", \"ssd1306\", or \"sh1106\". # See the display sections below for information on each type and # additional parameters they provide. This parameter must be # provided. #display_group: # The name of the display_data group to show on the display. This # controls the content of the screen (see the \"display_data\" section # for more information). The default is _default_20x4 for hd44780 # displays and _default_16x4 for other displays. #menu_timeout: # Timeout for menu. Being inactive this amount of seconds will # trigger menu exit or return to root menu when having autorun # enabled. The default is 0 seconds (disabled) #menu_root: # Name of the main menu section to show when clicking the encoder # on the home screen. The defaults is __main, and this shows the # the default menus as defined in klippy/extras/display/menu.cfg #menu_reverse_navigation: # When enabled it will reverse up and down directions for list # navigation. The default is False. This parameter is optional. #encoder_pins: # The pins connected to encoder. 2 pins must be provided when using # encoder. This parameter must be provided when using menu. #encoder_steps_per_detent: # How many steps the encoder emits per detent (\"click\"). If the # encoder takes two detents to move between entries or moves two # entries from one detent, try changing this. Allowed values are 2 # (half-stepping) or 4 (full-stepping). The default is 4. #click_pin: # The pin connected to 'enter' button or encoder 'click'. This # parameter must be provided when using menu. The presence of an # 'analog_range_click_pin' config parameter turns this parameter # from digital to analog. #back_pin: # The pin connected to 'back' button. This parameter is optional, # menu can be used without it. The presence of an # 'analog_range_back_pin' config parameter turns this parameter from # digital to analog. #up_pin: # The pin connected to 'up' button. This parameter must be provided # when using menu without encoder. The presence of an # 'analog_range_up_pin' config parameter turns this parameter from # digital to analog. #down_pin: # The pin connected to 'down' button. This parameter must be # provided when using menu without encoder. The presence of an # 'analog_range_down_pin' config parameter turns this parameter from # digital to analog. #kill_pin: # The pin connected to 'kill' button. This button will call # emergency stop. The presence of an 'analog_range_kill_pin' config # parameter turns this parameter from digital to analog. #analog_pullup_resistor: 4700 # The resistance (in ohms) of the pullup attached to the analog # button. The default is 4700 ohms. #analog_range_click_pin: # The resistance range for a 'enter' button. Range minimum and # maximum comma-separated values must be provided when using analog # button. #analog_range_back_pin: # The resistance range for a 'back' button. Range minimum and # maximum comma-separated values must be provided when using analog # button. #analog_range_up_pin: # The resistance range for a 'up' button. Range minimum and maximum # comma-separated values must be provided when using analog button. #analog_range_down_pin: # The resistance range for a 'down' button. Range minimum and # maximum comma-separated values must be provided when using analog # button. #analog_range_kill_pin: # The resistance range for a 'kill' button. Range minimum and # maximum comma-separated values must be provided when using analog # button.","title":"[display]"},{"location":"Config_Reference.html#display-hd44780","text":"Informazioni sulla configurazione dei display hd44780 (utilizzati nei display di tipo \"RepRapDiscount 2004 Smart Controller\"). [display] lcd_type: hd44780 # Set to \"hd44780\" for hd44780 displays. rs_pin: e_pin: d4_pin: d5_pin: d6_pin: d7_pin: # The pins connected to an hd44780 type lcd. These parameters must # be provided. #hd44780_protocol_init: True # Perform 8-bit/4-bit protocol initialization on an hd44780 display. # This is necessary on real hd44780 devices. However, one may need # to disable this on some \"clone\" devices. The default is True. #line_length: # Set the number of characters per line for an hd44780 type lcd. # Possible values are 20 (default) and 16. The number of lines is # fixed to 4. ...","title":"display hd44780"},{"location":"Config_Reference.html#display-hd44780_spi","text":"Informazioni sulla configurazione di un display hd44780_spi - un display 20x04 controllato tramite uno \"shift register\" hardware (che viene utilizzato nelle stampanti basate su mightyboard). [display] lcd_type: hd44780_spi # Set to \"hd44780_spi\" for hd44780_spi displays. latch_pin: spi_software_sclk_pin: spi_software_mosi_pin: spi_software_miso_pin: # The pins connected to the shift register controlling the display. # The spi_software_miso_pin needs to be set to an unused pin of the # printer mainboard as the shift register does not have a MISO pin, # but the software spi implementation requires this pin to be # configured. #hd44780_protocol_init: True # Perform 8-bit/4-bit protocol initialization on an hd44780 display. # This is necessary on real hd44780 devices. However, one may need # to disable this on some \"clone\" devices. The default is True. #line_length: # Set the number of characters per line for an hd44780 type lcd. # Possible values are 20 (default) and 16. The number of lines is # fixed to 4. ...","title":"display hd44780_spi"},{"location":"Config_Reference.html#display-st7920","text":"Informazioni sulla configurazione dei display st7920 (utilizzati nei display di tipo \"RepRapDiscount 12864 Full Graphic Smart Controller\"). [display] lcd_type: st7920 # Set to \"st7920\" for st7920 displays. cs_pin: sclk_pin: sid_pin: # The pins connected to an st7920 type lcd. These parameters must be # provided. ...","title":"display st7920"},{"location":"Config_Reference.html#display-emulazione-emulated_st7920","text":"Informazioni sulla configurazione di un display st7920 emulato, presenti in alcuni \"dispositivi touchscreen da 2,4 pollici\" e simili. [display] lcd_type: emulated_st7920 # Set to \"emulated_st7920\" for emulated_st7920 displays. en_pin: spi_software_sclk_pin: spi_software_mosi_pin: spi_software_miso_pin: # The pins connected to an emulated_st7920 type lcd. The en_pin # corresponds to the cs_pin of the st7920 type lcd, # spi_software_sclk_pin corresponds to sclk_pin and # spi_software_mosi_pin corresponds to sid_pin. The # spi_software_miso_pin needs to be set to an unused pin of the # printer mainboard as the st7920 as no MISO pin but the software # spi implementation requires this pin to be configured. ...","title":"display emulazione emulated_st7920"},{"location":"Config_Reference.html#display-uc1701","text":"Informazioni sulla configurazione dei display uc1701 (utilizzati nei display di tipo \"MKS Mini 12864\"). [display] lcd_type: uc1701 # Set to \"uc1701\" for uc1701 displays. cs_pin: a0_pin: # The pins connected to a uc1701 type lcd. These parameters must be # provided. #rst_pin: # The pin connected to the \"rst\" pin on the lcd. If it is not # specified then the hardware must have a pull-up on the # corresponding lcd line. #contrast: # The contrast to set. The value may range from 0 to 63 and the # default is 40. ...","title":"display uc1701"},{"location":"Config_Reference.html#display-ssd1306-e-sh1106","text":"Informazioni sulla configurazione dei display ssd1306 e sh1106. [display] lcd_type: # Set to either \"ssd1306\" or \"sh1106\" for the given display type. #i2c_mcu: #i2c_bus: #i2c_speed: # Optional parameters available for displays connected via an i2c # bus. See the \"common I2C settings\" section for a description of # the above parameters. #cs_pin: #dc_pin: #spi_speed: #spi_bus: #spi_software_sclk_pin: #spi_software_mosi_pin: #spi_software_miso_pin: # The pins connected to the lcd when in \"4-wire\" spi mode. See the # \"common SPI settings\" section for a description of the parameters # that start with \"spi_\". The default is to use i2c mode for the # display. #reset_pin: # A reset pin may be specified on the display. If it is not # specified then the hardware must have a pull-up on the # corresponding lcd line. #contrast: # The contrast to set. The value may range from 0 to 256 and the # default is 239. #vcomh: 0 # Set the Vcomh value on the display. This value is associated with # a \"smearing\" effect on some OLED displays. The value may range # from 0 to 63. Default is 0. #invert: False # TRUE inverts the pixels on certain OLED displays. The default is # False. #x_offset: 0 # Set the horizontal offset value on SH1106 displays. The default is # 0. ...","title":"display ssd1306 e sh1106"},{"location":"Config_Reference.html#display_data","text":"Supporto per la visualizzazione di dati personalizzati su uno schermo LCD. \u00c8 possibile creare un numero qualsiasi di gruppi di visualizzazione e un numero qualsiasi di elementi di dati in quei gruppi. Il display mostrer\u00e0 tutti gli elementi di dati per un determinato gruppo se l'opzione display_group nella sezione [display] \u00e8 impostata sul nome del gruppo specificato. Viene creato automaticamente un default set of display groups . \u00c8 possibile sostituire o estendere questi elementi display_data sovrascrivendo i valori predefiniti nel file di configurazione principale printer.cfg . [display_data my_group_name my_data_name] position: # Comma separated row and column of the display position that should # be used to display the information. This parameter must be # provided. text: # The text to show at the given position. This field is evaluated # using command templates (see docs/Command_Templates.md). This # parameter must be provided.","title":"[display_data]"},{"location":"Config_Reference.html#display_template","text":"Visualizza il testo dei dati \"macro\" (\u00e8 possibile definire un numero qualsiasi di sezioni con un prefisso display_template). Per informazioni sul template, vedere il documento template di comandi . Questa funzione consente di ridurre le definizioni ripetitive nelle sezioni display_data. Si pu\u00f2 usare la funzione incorporata render() nelle sezioni display_data per valutare un template. Per esempio, se si dovesse definire [display_template my_template] allora si potrebbe usare { render('my_template') } in una sezione display_data. Questa funzione pu\u00f2 essere utilizzata anche per aggiornamenti LED continui utilizzando il comando SET_LED_TEMPLATE . [display_template my_template_name] #param_<name>: # One may specify any number of options with a \"param_\" prefix. The # given name will be assigned the given value (parsed as a Python # literal) and will be available during macro expansion. If the # parameter is passed in the call to render() then that value will # be used during macro expansion. For example, a config with # \"param_speed = 75\" might have a caller with # \"render('my_template_name', param_speed=80)\". Parameter names may # not use upper case characters. text: # The text to return when the this template is rendered. This field # is evaluated using command templates (see # docs/Command_Templates.md). This parameter must be provided.","title":"[display_template]"},{"location":"Config_Reference.html#display_glyph","text":"Visualizza un glifo personalizzato sui display che lo supportano. Al nome dato verranno assegnati i dati di visualizzazione dati che possono quindi essere referenziati nei modelli di visualizzazione con il loro nome circondato da due simboli \"tilde\" per esempio ~my_display_glyph~ Vedere sample-glyphs.cfg per alcuni esempi. [display_glyph my_display_glyph] #data: # The display data, stored as 16 lines consisting of 16 bits (1 per # pixel) where '.' is a blank pixel and '*' is an on pixel (e.g., # \"****************\" to display a solid horizontal line). # Alternatively, one can use '0' for a blank pixel and '1' for an on # pixel. Put each display line into a separate config line. The # glyph must consist of exactly 16 lines with 16 bits each. This # parameter is optional. #hd44780_data: # Glyph to use on 20x4 hd44780 displays. The glyph must consist of # exactly 8 lines with 5 bits each. This parameter is optional. #hd44780_slot: # The hd44780 hardware index (0..7) to store the glyph at. If # multiple distinct images use the same slot then make sure to only # use one of those images in any given screen. This parameter is # required if hd44780_data is specified.","title":"[display_glyph]"},{"location":"Config_Reference.html#display-my_extra_display","text":"Se in printer.cfg \u00e8 stata definita una sezione primaria [display] come mostrato sopra, \u00e8 possibile definire pi\u00f9 display ausiliari. Si noti che i display ausiliari attualmente non supportano la funzionalit\u00e0 del menu, quindi non supportano le opzioni del \"menu\" o la configurazione dei pulsanti. [display my_extra_display] # Vedere la sezione \"display\" per i parametri disponibili.","title":"[display my_extra_display]"},{"location":"Config_Reference.html#menu","text":"Menu display lcd personalizzabili. Viene creato automaticamente un default set of menus . \u00c8 possibile sostituire o estendere il menu sovrascrivendo le impostazioni predefinite nel file di configurazione principale printer.cfg . Consulta il command template document per informazioni sugli attributi di menu disponibili durante il rendering del modello. # Common parameters available for all menu config sections. #[menu __some_list __some_name] #type: disabled # Permanently disabled menu element, only required attribute is 'type'. # Allows you to easily disable/hide existing menu items. #[menu some_name] #type: # One of command, input, list, text: # command - basic menu element with various script triggers # input - same like 'command' but has value changing capabilities. # Press will start/stop edit mode. # list - it allows for menu items to be grouped together in a # scrollable list. Add to the list by creating menu # configurations using \"some_list\" as a prefix - for # example: [menu some_list some_item_in_the_list] # vsdlist - same as 'list' but will append files from virtual sdcard # (will be removed in the future) #name: # Name of menu item - evaluated as a template. #enable: # Template that evaluates to True or False. #index: # Position where an item needs to be inserted in list. By default # the item is added at the end. #[menu some_list] #type: list #name: #enable: # See above for a description of these parameters. #[menu some_list some_command] #type: command #name: #enable: # See above for a description of these parameters. #gcode: # Script to run on button click or long click. Evaluated as a # template. #[menu some_list some_input] #type: input #name: #enable: # See above for a description of these parameters. #input: # Initial value to use when editing - evaluated as a template. # Result must be float. #input_min: # Minimum value of range - evaluated as a template. Default -99999. #input_max: # Maximum value of range - evaluated as a template. Default 99999. #input_step: # Editing step - Must be a positive integer or float value. It has # internal fast rate step. When \"(input_max - input_min) / # input_step > 100\" then fast rate step is 10 * input_step else fast # rate step is same input_step. #realtime: # This attribute accepts static boolean value. When enabled then # gcode script is run after each value change. The default is False. #gcode: # Script to run on button click, long click or value change. # Evaluated as a template. The button click will trigger the edit # mode start or end.","title":"[menu]"},{"location":"Config_Reference.html#sensori-di-filamento","text":"","title":"Sensori di filamento"},{"location":"Config_Reference.html#filament_switch_sensor","text":"Sensore del filamento a interruttore. Supporto per l'inserimento del filamento e il rilevamento dell'esaurimento tramite un sensore interruttore, come un interruttore di fine corsa. Per ulteriori informazioni, vedere command reference . [filament_switch_sensor my_sensor] #pause_on_runout: True # Se impostato su True, verr\u00e0 eseguita una PAUSA immediatamente # dopo il rilevamento di un'eccentricit\u00e0. Si noti che se pause_on_runout # \u00e8 False e runout_gcode viene omesso, il rilevamento dell'eccentricit\u00e0 # \u00e8 disabilitato. L'impostazione predefinita \u00e8 Vero. #runout_gcode: # Un elenco di comandi G-Code da eseguire dopo il rilevamento di # un'esaurimento del filamento. Vedi docs/Command_Templates.md # per il formato G-Code. Se pause_on_runout \u00e8 impostato su True, # questo codice G verr\u00e0 eseguito al termine della PAUSA. # L'impostazione predefinita \u00e8 di non eseguire alcun comando G-Code. #insert_gcode: # Un elenco di comandi G-Code da eseguire dopo il rilevamento # dell'inserimento di filamento. Vedi docs/Command_Templates.md # per il formato G-Code. L'impostazione predefinita non prevede # l'esecuzione di alcun comando G-Code, che disabilita il rilevamento # dell'inserimento. #event_delay: 3.0 # Il tempo minimo in secondi per ritardare tra gli eventi. Gli eventi # attivati durante questo periodo di tempo verranno ignorati # silenziosamente. L'impostazione predefinita \u00e8 3 secondi. #pause_delay: 0.5 # Il tempo di ritardo, in secondi, tra l'invio del comando pause e # l'esecuzione di runout_gcode. Potrebbe essere utile aumentare # questo ritardo se OctoPrint mostra uno strano comportamento # di pausa. Il valore predefinito \u00e8 0,5 secondi. #switch_pin: # Il pin su cui \u00e8 collegato l'interruttore. # Questo parametro deve essere fornito.","title":"[filament_switch_sensor]"},{"location":"Config_Reference.html#filament_motion_sensor","text":"Sensore di movimento del filamento. Supporto per l'inserimento del filamento e il rilevamento dell'esaurimento mediante un codificatore che commuta il pin di uscita durante il movimento del filamento attraverso il sensore. Per ulteriori informazioni, vedere command reference . [filament_motion_sensor my_sensor] detection_length: 7.0 # La lunghezza minima di filamento tirato attraverso il sensore # per attivare un cambio di stato su switch_pin # Il default \u00e8 7 mm. extruder: # Nome della sezione extruder section con cui questo sensore \u00e8 associato. # Questo parametro deve essere fornito. switch_pin: #pause_on_runout: #runout_gcode: #insert_gcode: #event_delay: #pause_delay: # Vedere la sezione \"filament_switch_sensor\" per la descrizione dei # parametri riportati sopra.","title":"[filament_motion_sensor]"},{"location":"Config_Reference.html#tsl1401cl_filament_width_sensor","text":"Sensore di larghezza del filamento basato su TSLl401CL. Consulta la guida per ulteriori informazioni. sl1401cl_filament_width_sensor] #pin: #diametro nominale del filamento predefinito: 1,75 (mm) # Differenza massima consentita del diametro del filamento in mm. #max_difference: 0.2 # La distanza dal sensore alla camera di fusione in mm. #measurement_delay: 100","title":"[tsl1401cl_filament_width_sensor]"},{"location":"Config_Reference.html#hall_filament_width_sensor","text":"Sensore di larghezza del filamento ad effetto Hall (vedere Sensore di larghezza del filamento Hall ). [hall_filament_width_sensor] adc1: adc2: # Pin di ingresso analogico collegati al sensore. # Questi parametri devono essere forniti. #cal_dia1: 1.50 #cal_dia2: 2.00 # I valori di calibrazione (in mm) per i sensori. Il valore predefinito # \u00e8 1.50 per cal_dia1 e 2.00 per cal_dia2. #raw_dia1: 9500 #raw_dia2: 10500 # I valori di calibrazione grezzi per i sensori. Il valore predefinito \u00e8 # 9500 per raw_dia1 e 10500 per raw_dia2. #default_nominal_filament_diameter: 1.75 # Il diametro nominale del filamento. # Questo parametro deve essere fornito. #max_difference: 0.200 # Differenza massima consentita del diametro del filamento in # millimetri (mm). Se la differenza tra il diametro nominale del # filamento e l'uscita del sensore \u00e8 maggiore di +- max_difference, # il moltiplicatore di estrusione viene riportato a %100. # Il valore predefinito \u00e8 0,200. #measurement_delay: 70 # La distanza dal sensore alla camera di fusione/hot-end in # millimetri (mm). Il filamento tra il sensore e l'hot-end verr\u00e0 # trattato come default_nominal_filament_diameter. Il modulo # host funziona con la logica FIFO. Mantiene ogni valore e posizione # del sensore in un array e li riporta nella posizione corretta. # Questo parametro deve essere fornito. #enable: False # Sensore abilitato o disabilitato dopo l'accensione. L'impostazione predefinita \u00e8 disabilitare. #measurement_interval: 10 # La distanza approssimativa (in mm) tra le letture del sensore. # Il valore predefinito \u00e8 10 mm. #logging: False # Il log esterno al terminale e klipper.log pu\u00f2 essere # attivato|off tramite comando. #min_diameter: 1.0 # Diametro minimo per trigger filament_switch_sensor virtuale. #use_current_dia_while_delay: False # Utilizzare il diametro attuale invece del diametro nominale # mentre il ritardo di misurazione non \u00e8 trascorso. #pause_on_runout: #runout_gcode: #insert_gcode: #event_delay: #pause_delay: # Vedere la sezione \"filament_switch_sensor\" per una # descrizione dei parametri di cui sopra.","title":"[hall_filament_width_sensor]"},{"location":"Config_Reference.html#supporto-hardware-per-specifica-scheda","text":"","title":"Supporto hardware per specifica scheda"},{"location":"Config_Reference.html#sx1509","text":"Configurare un'espansione SX1509 da I2C a GPIO. A causa del ritardo dovuto alla comunicazione I2C, NON utilizzare i pin SX1509 come abilitazione stepper, pin step o dir o qualsiasi altro pin che richieda un bit banging veloce. Sono utilizzati al meglio come uscite digitali statiche o controllate da gcode o pin hardware-pwm per es. fan. Si pu\u00f2 definire un numero qualsiasi di sezioni con un prefisso \"sx1509\". Ogni espansione fornisce un set di 16 pin (da sx1509_my_sx1509:PIN_0 a sx1509_my_sx1509:PIN_15) che possono essere utilizzati nella configurazione della stampante. Per un esempio, vedere il file generic-duet2-duex.cfg . [sx1509 my_sx1509] i2c_address: # Indirizzo I2C utilizzato da questa espansione. A seconda dei # ponticelli hardware \u00e8 uno dei seguenti indirizzi: 62 63 112 113. # Questo parametro deve essere fornito. #i2c_mcu: #i2c_bus: #i2c_speed: # Vedere la sezione \"impostazioni comuni I2C\" per una # escrizione dei parametri di cui sopra. #i2c_bus: # Se l'implementazione I2C del tuo microcontrollore supporta # pi\u00f9 bus I2C, puoi specificare qui il nome del bus. L'impostazione # predefinita prevede l'utilizzo del bus i2c del microcontrollore # predefinito.","title":"[sx1509]"},{"location":"Config_Reference.html#samd_sercom","text":"Configurazione SAMD SERCOM per specificare quali pin utilizzare su un determinato SERCOM. Si pu\u00f2 definire un numero qualsiasi di sezioni con un prefisso \"samd_sercom\". Ogni SERCOM deve essere configurato prima di utilizzarlo come periferica SPI o I2C. Posiziona questa sezione di configurazione sopra qualsiasi altra sezione che fa uso di bus SPI o I2C. [samd_sercom my_sercom] sercom: # Il nome del bus Sercom da configurare nel microcontrollore. I nomi # disponibili sono \"sercom0\", \"sercom1\", ecc. # Questo parametro deve essere fornito. tx_pin: # Pin MOSI per la comunicazione SPI o pin SDA (dati) per la # comunicazione I2C. Il pin deve avere una configurazione pinmux # valida per la specifica periferica SERCOM. # Questo parametro deve essere fornito. #rx_pin: # Pin MISO per la comunicazione SPI. Questo pin non viene utilizzato # per la comunicazione I2C (I2C utilizza tx_pin sia per l'invio che per la # ricezione). Il pin deve avere una configurazione pinmux valida per la # specifica periferica SERCOM. Questo parametro \u00e8 facoltativo. clk_pin: # Pin CLK per la comunicazione SPI o pin SCL (clock) per la # comunicazione I2C. Il pin deve avere una configurazione pinmux # valida per la specifica periferica SERCOM. Questo parametro deve # essere fornito.","title":"[samd_sercom]"},{"location":"Config_Reference.html#adc_scaled","text":"Scaling analogico di Duet2 Maestro tramite letture vref e vssa. La definizione di una sezione adc_scaled abilita pin adc virtuali (come \"my_name:PB0\") che vengono regolati automaticamente dai pin di monitoraggio vref e vssa della scheda. Assicurati di definire questa sezione di configurazione sopra qualsiasi sezione di configurazione che utilizza uno di questi pin virtuali. Per un esempio, vedere il file generic-duet2-maestro.cfg . [adc_scaled my_name] vref_pin: # The ADC pin to use for VREF monitoring. This parameter must be # provided. vssa_pin: # The ADC pin to use for VSSA monitoring. This parameter must be # provided. #smooth_time: 2.0 # A time value (in seconds) over which the vref and vssa # measurements will be smoothed to reduce the impact of measurement # noise. The default is 2 seconds.","title":"[adc_scaled]"},{"location":"Config_Reference.html#replicape","text":"Supporto per Replicape: vedere la guida beaglebone e il file generic-replicape.cfg per un esempio. # La sezione di configurazione \"replicape\" aggiunge i pin di abilitazione # dello stepper virtuale \"replicape: stepper_x_enable\" (per stepper X, Y, Z, # E e H) e i pin di uscita PWM \"replicape: power_x\" (per hotbed, e, h, fan0, # fan1 , fan2 e fan3) che possono quindi essere utilizzati altrove nel file # di configurazione. [replicape] revision: # La revisione dell'hardware di replicape. Attualmente \u00e8 supportata solo # la revisione \"B3\". Questo parametro deve essere fornito. #enable_pin: !gpio0_20 # Il pin di abilitazione globale dei replicape. L'impostazione predefinita # \u00e8 !gpio0_20 (aka P9_41). host_mcu: # Il nome della sezione mcu config che comunica con l'istanza mcu # \"linux process\" di Klipper. Questo parametro deve essere fornito. #standstill_power_down: False # Questo parametro controlla la linea CFG6_ENN su tutti i motori # passo-passo. True imposta le righe di abilitazione su \"open\". # L'impostazione predefinita \u00e8 Falso. #stepper_x_microstep_mode: #stepper_y_microstep_mode: #stepper_z_microstep_mode: #stepper_e_microstep_mode: #stepper_h_microstep_mode: # Questo parametro controlla i pin CFG1 e CFG2 del driver del motore # passo-passo specificato. Le opzioni disponibili sono: disabilita, 1, 2, # spread2, 4, 16, spread4, spread16, stealth4 e stealth16. L'impostazione # predefinita \u00e8 disabilitata. #stepper_x_current: #stepper_y_current: #stepper_z_current: #stepper_e_current: #stepper_h_current: # La corrente massima configurata (in Amp) del driver del motore # passo-passo. Questo parametro deve essere fornito se lo stepper non # \u00e8 in modalit\u00e0 disabilitazione. #stepper_x_chopper_off_time_high: #stepper_y_chopper_off_time_high: #stepper_z_chopper_off_time_high: #stepper_e_chopper_off_time_high: #stepper_h_chopper_off_time_high: # Questo parametro controlla il pin CFG0 del driver del motore # passo-passo (True imposta CFG0 alto, False lo imposta basso). # L'impostazione predefinita \u00e8 False. #stepper_x_chopper_hysteresis_high: #stepper_y_chopper_hysteresis_high: #stepper_z_chopper_hysteresis_high: #stepper_e_chopper_hysteresis_high: #stepper_h_chopper_hysteresis_high: # Questo parametro controlla il pin CFG4 del driver del motore # passo-passo (True imposta CFG4 alto, False lo imposta basso). # L'impostazione predefinita \u00e8 False. #stepper_x_chopper_blank_time_high: #stepper_y_chopper_blank_time_high: #stepper_z_chopper_blank_time_high: #stepper_e_chopper_blank_time_high: #stepper_h_chopper_blank_time_high: # Questo parametro controlla il pin CFG5 del driver del motore # passo-passo (True imposta CFG5 alto, False lo imposta basso). # L'impostazione predefinita \u00e8 True.","title":"[replicape]"},{"location":"Config_Reference.html#altri-moduli-personalizzati","text":"","title":"Altri moduli personalizzati"},{"location":"Config_Reference.html#palette2","text":"Supporto multimateriale Palette 2: fornisce un'integrazione pi\u00f9 stretta supportando i dispositivi Palette 2 in modalit\u00e0 connessa. Questo modulo richiede anche [virtual_sdcard] e [pause_resume] per la piena funzionalit\u00e0. Se si utilizza questo modulo, non utilizzare il plug-in Palette 2 per Octoprint poich\u00e9 entreranno in conflitto e 1 non si inizializzer\u00e0 correttamente, probabilmente interrompendo la stampa. Se utilizzi Octoprint e esegui lo streaming di gcode sulla porta seriale invece di stampare da virtual_sd, rimuovere M1 e M0 da Pausa dei comandi in Impostazioni > Connessione seriale > Firmware e protocollo eviter\u00e0 la necessit\u00e0 per avviare la stampa sulla tavolozza 2 e riattivare la pausa in Octoprint per avviare la stampa. [palette2] serial: # La porta seriale per la connessione alla Palette 2. #baud: 115200 # La velocit\u00e0 da utilizzare. Il valore predefinito \u00e8 115200. #feedrate_splice: 0.8 # L'avanzamento da utilizzare durante la giunzione # il valore predefinito \u00e8 0.8 #feedrate_normal: 1.0 # L'avanzamento da utilizzare dopo la giunzione # il valore predefinito \u00e8 1.0 #auto_load_speed: 2 # Avanzamento di estrusione durante il caricamento automatico # il valore predefinito \u00e8 2 (mm/s) #auto_cancel_variation: 0.1 # Annullamento automatico della stampa quando la variazione # del ping \u00e8 superiore a questa soglia","title":"[palette2]"},{"location":"Config_Reference.html#angle","text":"Supporto per sensore magnetico Hall per la lettura delle misurazioni dell'angolo del motore passo-passo utilizzando i chip SPI a1333, as5047d o tle5012b. Le misurazioni sono disponibili tramite Server API e strumento di analisi del movimento . Vedere il Riferimento G-Code per i comandi disponibili. [angle my_angle_sensor] sensor_type: # The type of the magnetic hall sensor chip. Available choices are # \"a1333\", \"as5047d\", and \"tle5012b\". This parameter must be # specified. #sample_period: 0.000400 # The query period (in seconds) to use during measurements. The # default is 0.000400 (which is 2500 samples per second). #stepper: # The name of the stepper that the angle sensor is attached to (eg, # \"stepper_x\"). Setting this value enables an angle calibration # tool. To use this feature, the Python \"numpy\" package must be # installed. The default is to not enable angle calibration for the # angle sensor. cs_pin: # The SPI enable pin for the sensor. This parameter must be provided. #spi_speed: #spi_bus: #spi_software_sclk_pin: #spi_software_mosi_pin: #spi_software_miso_pin: # See the \"common SPI settings\" section for a description of the # above parameters.","title":"[angle]"},{"location":"Config_Reference.html#parametri-bus-comuni","text":"","title":"Parametri bus comuni"},{"location":"Config_Reference.html#impostazioni-spi-comuni","text":"I seguenti parametri sono generalmente disponibili per i dispositivi che utilizzano un bus SPI. #spi_speed: # La velocit\u00e0 SPI (in Hz) da utilizzare durante la comunicazione con il # dispositivo. L'impostazione predefinita dipende dal tipo di dispositivo. #spi_bus: # Se il microcontrollore supporta pi\u00f9 bus SPI, \u00e8 possibile specificare # qui il nome del bus del microcontrollore. L'impostazione predefinita # dipende dal tipo di microcontrollore. #spi_software_sclk_pin: #spi_software_mosi_pin: #spi_software_miso_pin: # Specificare i parametri di cui sopra per utilizzare \"SPI basato su # software\". Questa modalit\u00e0 non richiede il supporto hardware del # microcontrollore (in genere \u00e8 possibile utilizzare qualsiasi pin generico). # L'impostazione predefinita \u00e8 di non utilizzare \"spi software\".","title":"Impostazioni SPI comuni"},{"location":"Config_Reference.html#impostazioni-i2c-comuni","text":"I seguenti parametri sono generalmente disponibili per i dispositivi che utilizzano un bus I2C. Si noti che l'attuale supporto del microcontrollore di Klipper per i2c generalmente non tollera il rumore di linea. Errori imprevisti sui cavi i2c possono causare la generazione di un errore di runtime da parte di Klipper. Il supporto di Klipper per il ripristino degli errori varia a seconda del tipo di microcontrollore. In genere si consiglia di utilizzare solo dispositivi i2c che si trovano sulla stessa scheda a circuito stampato del microcontrollore. La maggior parte delle implementazioni del microcontrollore Klipper supporta solo un i2c_speed di 100000. Il microcontrollore \"linux\" Klipper supporta una velocit\u00e0 400000, ma deve essere impostato nel sistema operativo e il parametro i2c_speed viene altrimenti ignorato. Il microcontrollore Klipper \"rp2040\" supporta una velocit\u00e0 di 400000 tramite il parametro i2c_speed . Tutti gli altri microcontrollori Klipper utilizzano una frequenza di 100000 e ignorano il parametro i2c_speed . #i2c_address: # L'indirizzo i2c del dispositivo. Questo deve essere specificato # come numero decimale (non in esadecimale). L'impostazione # predefinita dipende dal tipo di dispositivo. #i2c_mcu: # Il nome del microcontrollore a cui \u00e8 collegato il chip. # L'impostazione predefinita \u00e8 \"mcu\". #i2c_bus: # Se il microcontrollore supporta pi\u00f9 bus I2C, \u00e8 possibile # specificare qui il nome del bus del microcontrollore. # L'impostazione predefinita dipende dal tipo di microcontrollore. #i2c_speed: # La velocit\u00e0 I2C (in Hz) da utilizzare durante la comunicazione # con il dispositivo. L'implementazione di Klipper sulla maggior # parte dei microcontrollori \u00e8 codificata a 100000 e la modifica # di questo valore non ha alcun effetto. # Il valore predefinito \u00e8 100000.","title":"Impostazioni I2C comuni"},{"location":"Config_checks.html","text":"Controlli della configurazione \u00b6 Questo documento fornisce una lista di step per confermare le impostazioni dei pin nel file printer.cfg di Klipper. \u00c8 una buona idea eseguire questi passi dopo aver seguito i passi nel documento di installazione . In alcuni passaggi di questa guida, potrebbe essere necessario modificare il file di configurazione di Klipper. Assicuratevi di dare il comando RESTART, dopo ogni modifica al file di configurazione, per accertarsi che le modifiche abbiano effetto(scrivere \"restart\" nella scheda del terminale di Octoprint e cliccare su INVIA). E' anche consigliabile utilizzare il comando STATUS, dopo ogni RESTART, per verificare che il file di configurazione sia stato caricato correttamente. Verifica delle temperature \u00b6 Iniziare verificando che le temperature siano correttamente riportate. Navigare alla scheda temperature di Octoprint. eseguire l'istruzione Verificare che la temperatura dell'ugello e del piatto(se presente) siano presenti e non stiano aumentando. Se stessero aumentando staccare l'alimentazione alla stampante. Se le temperature non sono precise, rivedere le impostazioni \"sensor_type\" e \"sensor_pin\" per l'ugello e/o il piatto. Verifica M112 \u00b6 Da terminale dare il comando M112. Questo comando richiede a Klipper di porsi in uno stato di spengnimento. Questo causer\u00e0 la disconnessione di Octoprint da Klipper - selezionate il menu connessione e premete il pulsante \"Connetti\" per riconnettere Octoprint. Selezionate poi la scheda temperatura e verificate che le temperature si stiano aggiornando e che non stiano aumentando. Se stanno aumentando, staccate l'alimentazione della stampante. Il comando M112 mette Klipper in uno stato di spegnimento. Per farlo uscire da questo stato, dare il comando FIRMWARE_RESTART sempre da terminale di Octoprint. Verifica i riscaldatori \u00b6 Passare alla pagina della temperatura su Octoprint . Nella casella della temperatura \"Tool\", digitare 50 seguito dal tasto enter .La temperatura dell'estrusore indicata nel grafico, dovrebbe iniziare ad aumentare (entro 30 secondi circa). Quindi vai alla casella a scorrimento della temperatura \"Tool\" e seleziona \"Off\". Dopo alcuni minuti la temperatura dovrebbe tornare al valore di temperatura ambiente iniziale. Se la temperatura non aumenta, verifica l'impostazione \"heater_pin\" nella configurazione. Se la stampante ha il piatto riscaldato, eseguire nuovamente il test indicato in precedenza ma per il piatto. Verifica il pin di abilitazione del motore passo-passo \u00b6 Verificare che tutti gli assi della stampante possano muoversi manualmente in modo libero (con i motori passo-passo sono disabilitati). In caso contrario, inserire un comando M84 per disabilitare i motori. Se uno degli assi non pu\u00f2 ancora muoversi in modo libero, verificare la configurazione \"enable_pin\" del driver del motore passo-passo corrispondente. Sulla maggior parte dei driver per motori passo-passo, il pin di abilitazione del motore \u00e8 \"attivo basso\" e quindi il pin di abilitazione dovrebbe avere un \"!\" prima del pin (ad esempio, \"enable_pin: !ar38\"). Verifica i finecorsa \u00b6 Spostare manualmente tutti gli assi della stampante in modo che nessuno di essi sia a contatto con un finecorsa. Invia un comando QUERY_ENDSTOPS tramite il terminale di Octoprint. Dovrebbe visualizzare lo stato corrente di tutti i finecorsa configurati e gli stessi dovrebbero essere nello stato di \"aperto\". Per ciascuno degli finecorsa, eseguire nuovamente il comando QUERY_ENDSTOPS mentre si attiva manualmente il finecorsa corrispondente, dovrebbe rispondere con \"TRIGGERED\". Se il finecorsa \u00e8 invertito (viene indicato \"aperto\" quando \u00e8 attivato e viceversa), aggiungere un \"!\" alla definizione del pin (ad esempio, \"endstop_pin: ^!ar3\"), oppure togliere \"!\" se invece \u00e8 presente. Se il segnale del finecorsa non cambia , pu\u00f2 significare che il fine corsa \u00e8 collegato a un pin diverso. Tuttavia, potrebbe essere necessaria una modifica all'impostazione pullup del pin (il '^' all'inizio del istruzione \"endstop_pin\".La maggior parte delle stampanti utilizzano un resistore pullup e l'istruzione '^' dovrebbe essere presente). Verifica dei motori passo-passo \u00b6 Utilizzare il comando STEPPER_BUZZ per verificare le connessioni di ciascun motore passo-passo. Inizia posizionando manualmente in un punto intermedio dell'asse, quindi esegui l'istruzione STEPPER_BUZZ STEPPER=stepper_x . Il comando STEPPER_BUZZ far\u00e0 muovere il motore passo-passo di un millimetro in direzione avanti e poi torner\u00e0 in posizione iniziale. (Se il finecorsa \u00e8 definito come position_endstop=0, all'inizio di ogni movimento lo motore passo-passo si allontaner\u00e0 dal finecorsa.) Eseguir\u00e0 questa movimento oscillatorio per dieci volte. Se il motore passo-passo non si muove , verifica le impostazioni \"enable_pin\" e \"step_pin\" sul driver. Se il motore passo-passo si muove ma non torna nella sua posizione originale, verificare l'impostazione \"dir_pin\". Se il motore passo-passo oscilla in una direzione errata, generalmente sta a significare che \u00e8 necessario invertire il \"dir_pin\" del l'asse. Questo viene fatto aggiungendo un istruzione '!' alla \"dir_pin\" nel file di configurazione della stampante (o rimuovendolo se ne esiste gi\u00e0 presente). Se il motore passo-passo si muove di pi\u00f9 o di meno di un millimetro, verificare l'impostazione \"rotation_distance\". Eseguire il test sopra descritto per ogni motore passo-passo definito nel file di configurazione. (Impostare il parametro STEPPER del comando STEPPER_BUZZ sul nome della sezione di configurazione da testare.) Se non \u00e8 presente il filamento nell'estrusore, \u00e8 possibile utilizzare STEPPER_BUZZ per verificare la connessione del motore dell'estrusore (usare STEPPER=estrusore). In caso contrario, \u00e8 meglio testare il motore dell'estrusore per conto suo (vedere la sezione successiva). Dopo aver verificato tutti i finecorsa e aver verificato tutti i motori passo-passo, \u00e8 necessario testare il sistema di homing. Scrivere un comando G28 per portare a home tutti gli assi. Rimuovere l'alimentazione dalla stampante se l'istruzione non funziona correttamente. Se necessario, ripetere i passaggi di verifica del finecorsa e del motore passo-passo. Verifica il motore dell'estrusore \u00b6 Per testare il motore dell'estrusore sar\u00e0 necessario riscaldare l'estrusore alla temperatura di stampa. Passare alla pagina della temperatura Octoprint e selezionare una temperatura di target nel men\u00f9 a tendina della temperatura (o inserire manualmente una temperatura opportuna). Attendere che la stampante raggiunga la temperatura desiderata. Quindi vai alla pagina di controllo di Octoprint e fai clic sul pulsante \"Estrudi\". Verificare che il motore dell'estrusore giri nella direzione corretta. In caso contrario, vedere i suggerimenti per la risoluzione dei problemi nella sezione precedente per verificare le impostazioni \"enable_pin\", \"step_pin\" e \"dir_pin\" per l'estrusore. Calibrare le impostazioni del PID \u00b6 Klipper supporta il sistema controllo PID per iriscaldatori dell'estrusore e del piatto. Per utilizzare questo sistema di controllo, \u00e8 necessario calibrare le impostazioni PID su ciascuna stampante (le impostazioni PID presenti in altri firmware o nei file di configurazione di esempio spesso funzionano male). Per calibrare il PID dell'estrusore, accedere alla pagina del terminale OctoPrint ed eseguire il comando PID_CALIBRATE. Ad esempio: PID_CALIBRATE HEATER=estrusore TARGET=170 Al termine del test di ottimizzazione, eseguire l'istruzione SAVE_CONFIG per aggiornare il file printer.cfg con le nuove impostazioni PID. Se la stampante ha un piatto riscaldato ed \u00e8 dotato di azionamento con funzione PWM (Pulse Width Modulation), si consiglia di utilizzare il controllo PID anche per il piatto. (Quando il riscaldatore del piatto \u00e8 controllato utilizzando l'algoritmo PID, potrebbe accendersi e spegnersi dieci volte al secondo, il che potrebbe non essere adatto per i riscaldatori che utilizzano un rel\u00e8 elettromeccanico.) Un tipico comando per calibrazione PID del piatto \u00e8: PID_CALIBRATE HEATER=heater_bed TARGET= 60 Passi sucessivi \u00b6 Questa guida ha lo scopo di aiutare la verifica delle impostazioni di base riferite ai pin presenti nel file di configurazione di Klipper. Assicurati di leggere la guida bed leveling . Consulta anche il documento Slicers per informazioni sulla configurazione di un software slicer con Klipper. Dopo aver verificato che la stampa di base funziona, \u00e8 una buona prassi procedere con la calibrazione avanzamento pressione . Potrebbe essere necessario eseguire altri tipi di calibrazione di dettaglio in riferimento alla stampante: sono disponibili numerose guide online per questo scopo (ad esempio, eseguire una ricerca sul Web per \"calibrazione della stampante 3d\"). Ad esempio, se si verifica l'effetto chiamato risonanza, \u00e8 possibile provare a seguire la calibrazione tramite l'istruzione compensazione della risonanza .","title":"Controlli della configurazione"},{"location":"Config_checks.html#controlli-della-configurazione","text":"Questo documento fornisce una lista di step per confermare le impostazioni dei pin nel file printer.cfg di Klipper. \u00c8 una buona idea eseguire questi passi dopo aver seguito i passi nel documento di installazione . In alcuni passaggi di questa guida, potrebbe essere necessario modificare il file di configurazione di Klipper. Assicuratevi di dare il comando RESTART, dopo ogni modifica al file di configurazione, per accertarsi che le modifiche abbiano effetto(scrivere \"restart\" nella scheda del terminale di Octoprint e cliccare su INVIA). E' anche consigliabile utilizzare il comando STATUS, dopo ogni RESTART, per verificare che il file di configurazione sia stato caricato correttamente.","title":"Controlli della configurazione"},{"location":"Config_checks.html#verifica-delle-temperature","text":"Iniziare verificando che le temperature siano correttamente riportate. Navigare alla scheda temperature di Octoprint. eseguire l'istruzione Verificare che la temperatura dell'ugello e del piatto(se presente) siano presenti e non stiano aumentando. Se stessero aumentando staccare l'alimentazione alla stampante. Se le temperature non sono precise, rivedere le impostazioni \"sensor_type\" e \"sensor_pin\" per l'ugello e/o il piatto.","title":"Verifica delle temperature"},{"location":"Config_checks.html#verifica-m112","text":"Da terminale dare il comando M112. Questo comando richiede a Klipper di porsi in uno stato di spengnimento. Questo causer\u00e0 la disconnessione di Octoprint da Klipper - selezionate il menu connessione e premete il pulsante \"Connetti\" per riconnettere Octoprint. Selezionate poi la scheda temperatura e verificate che le temperature si stiano aggiornando e che non stiano aumentando. Se stanno aumentando, staccate l'alimentazione della stampante. Il comando M112 mette Klipper in uno stato di spegnimento. Per farlo uscire da questo stato, dare il comando FIRMWARE_RESTART sempre da terminale di Octoprint.","title":"Verifica M112"},{"location":"Config_checks.html#verifica-i-riscaldatori","text":"Passare alla pagina della temperatura su Octoprint . Nella casella della temperatura \"Tool\", digitare 50 seguito dal tasto enter .La temperatura dell'estrusore indicata nel grafico, dovrebbe iniziare ad aumentare (entro 30 secondi circa). Quindi vai alla casella a scorrimento della temperatura \"Tool\" e seleziona \"Off\". Dopo alcuni minuti la temperatura dovrebbe tornare al valore di temperatura ambiente iniziale. Se la temperatura non aumenta, verifica l'impostazione \"heater_pin\" nella configurazione. Se la stampante ha il piatto riscaldato, eseguire nuovamente il test indicato in precedenza ma per il piatto.","title":"Verifica i riscaldatori"},{"location":"Config_checks.html#verifica-il-pin-di-abilitazione-del-motore-passo-passo","text":"Verificare che tutti gli assi della stampante possano muoversi manualmente in modo libero (con i motori passo-passo sono disabilitati). In caso contrario, inserire un comando M84 per disabilitare i motori. Se uno degli assi non pu\u00f2 ancora muoversi in modo libero, verificare la configurazione \"enable_pin\" del driver del motore passo-passo corrispondente. Sulla maggior parte dei driver per motori passo-passo, il pin di abilitazione del motore \u00e8 \"attivo basso\" e quindi il pin di abilitazione dovrebbe avere un \"!\" prima del pin (ad esempio, \"enable_pin: !ar38\").","title":"Verifica il pin di abilitazione del motore passo-passo"},{"location":"Config_checks.html#verifica-i-finecorsa","text":"Spostare manualmente tutti gli assi della stampante in modo che nessuno di essi sia a contatto con un finecorsa. Invia un comando QUERY_ENDSTOPS tramite il terminale di Octoprint. Dovrebbe visualizzare lo stato corrente di tutti i finecorsa configurati e gli stessi dovrebbero essere nello stato di \"aperto\". Per ciascuno degli finecorsa, eseguire nuovamente il comando QUERY_ENDSTOPS mentre si attiva manualmente il finecorsa corrispondente, dovrebbe rispondere con \"TRIGGERED\". Se il finecorsa \u00e8 invertito (viene indicato \"aperto\" quando \u00e8 attivato e viceversa), aggiungere un \"!\" alla definizione del pin (ad esempio, \"endstop_pin: ^!ar3\"), oppure togliere \"!\" se invece \u00e8 presente. Se il segnale del finecorsa non cambia , pu\u00f2 significare che il fine corsa \u00e8 collegato a un pin diverso. Tuttavia, potrebbe essere necessaria una modifica all'impostazione pullup del pin (il '^' all'inizio del istruzione \"endstop_pin\".La maggior parte delle stampanti utilizzano un resistore pullup e l'istruzione '^' dovrebbe essere presente).","title":"Verifica i finecorsa"},{"location":"Config_checks.html#verifica-dei-motori-passo-passo","text":"Utilizzare il comando STEPPER_BUZZ per verificare le connessioni di ciascun motore passo-passo. Inizia posizionando manualmente in un punto intermedio dell'asse, quindi esegui l'istruzione STEPPER_BUZZ STEPPER=stepper_x . Il comando STEPPER_BUZZ far\u00e0 muovere il motore passo-passo di un millimetro in direzione avanti e poi torner\u00e0 in posizione iniziale. (Se il finecorsa \u00e8 definito come position_endstop=0, all'inizio di ogni movimento lo motore passo-passo si allontaner\u00e0 dal finecorsa.) Eseguir\u00e0 questa movimento oscillatorio per dieci volte. Se il motore passo-passo non si muove , verifica le impostazioni \"enable_pin\" e \"step_pin\" sul driver. Se il motore passo-passo si muove ma non torna nella sua posizione originale, verificare l'impostazione \"dir_pin\". Se il motore passo-passo oscilla in una direzione errata, generalmente sta a significare che \u00e8 necessario invertire il \"dir_pin\" del l'asse. Questo viene fatto aggiungendo un istruzione '!' alla \"dir_pin\" nel file di configurazione della stampante (o rimuovendolo se ne esiste gi\u00e0 presente). Se il motore passo-passo si muove di pi\u00f9 o di meno di un millimetro, verificare l'impostazione \"rotation_distance\". Eseguire il test sopra descritto per ogni motore passo-passo definito nel file di configurazione. (Impostare il parametro STEPPER del comando STEPPER_BUZZ sul nome della sezione di configurazione da testare.) Se non \u00e8 presente il filamento nell'estrusore, \u00e8 possibile utilizzare STEPPER_BUZZ per verificare la connessione del motore dell'estrusore (usare STEPPER=estrusore). In caso contrario, \u00e8 meglio testare il motore dell'estrusore per conto suo (vedere la sezione successiva). Dopo aver verificato tutti i finecorsa e aver verificato tutti i motori passo-passo, \u00e8 necessario testare il sistema di homing. Scrivere un comando G28 per portare a home tutti gli assi. Rimuovere l'alimentazione dalla stampante se l'istruzione non funziona correttamente. Se necessario, ripetere i passaggi di verifica del finecorsa e del motore passo-passo.","title":"Verifica dei motori passo-passo"},{"location":"Config_checks.html#verifica-il-motore-dellestrusore","text":"Per testare il motore dell'estrusore sar\u00e0 necessario riscaldare l'estrusore alla temperatura di stampa. Passare alla pagina della temperatura Octoprint e selezionare una temperatura di target nel men\u00f9 a tendina della temperatura (o inserire manualmente una temperatura opportuna). Attendere che la stampante raggiunga la temperatura desiderata. Quindi vai alla pagina di controllo di Octoprint e fai clic sul pulsante \"Estrudi\". Verificare che il motore dell'estrusore giri nella direzione corretta. In caso contrario, vedere i suggerimenti per la risoluzione dei problemi nella sezione precedente per verificare le impostazioni \"enable_pin\", \"step_pin\" e \"dir_pin\" per l'estrusore.","title":"Verifica il motore dell'estrusore"},{"location":"Config_checks.html#calibrare-le-impostazioni-del-pid","text":"Klipper supporta il sistema controllo PID per iriscaldatori dell'estrusore e del piatto. Per utilizzare questo sistema di controllo, \u00e8 necessario calibrare le impostazioni PID su ciascuna stampante (le impostazioni PID presenti in altri firmware o nei file di configurazione di esempio spesso funzionano male). Per calibrare il PID dell'estrusore, accedere alla pagina del terminale OctoPrint ed eseguire il comando PID_CALIBRATE. Ad esempio: PID_CALIBRATE HEATER=estrusore TARGET=170 Al termine del test di ottimizzazione, eseguire l'istruzione SAVE_CONFIG per aggiornare il file printer.cfg con le nuove impostazioni PID. Se la stampante ha un piatto riscaldato ed \u00e8 dotato di azionamento con funzione PWM (Pulse Width Modulation), si consiglia di utilizzare il controllo PID anche per il piatto. (Quando il riscaldatore del piatto \u00e8 controllato utilizzando l'algoritmo PID, potrebbe accendersi e spegnersi dieci volte al secondo, il che potrebbe non essere adatto per i riscaldatori che utilizzano un rel\u00e8 elettromeccanico.) Un tipico comando per calibrazione PID del piatto \u00e8: PID_CALIBRATE HEATER=heater_bed TARGET= 60","title":"Calibrare le impostazioni del PID"},{"location":"Config_checks.html#passi-sucessivi","text":"Questa guida ha lo scopo di aiutare la verifica delle impostazioni di base riferite ai pin presenti nel file di configurazione di Klipper. Assicurati di leggere la guida bed leveling . Consulta anche il documento Slicers per informazioni sulla configurazione di un software slicer con Klipper. Dopo aver verificato che la stampa di base funziona, \u00e8 una buona prassi procedere con la calibrazione avanzamento pressione . Potrebbe essere necessario eseguire altri tipi di calibrazione di dettaglio in riferimento alla stampante: sono disponibili numerose guide online per questo scopo (ad esempio, eseguire una ricerca sul Web per \"calibrazione della stampante 3d\"). Ad esempio, se si verifica l'effetto chiamato risonanza, \u00e8 possibile provare a seguire la calibrazione tramite l'istruzione compensazione della risonanza .","title":"Passi sucessivi"},{"location":"Contact.html","text":"Contatti \u00b6 Questo documento fornisce informazioni di contatto per Klipper. Forum della comunit\u00e0 Chat Discord Ho una domanda su Klipper Ho una richiesta per una funzionalit\u00e0 Aiuto! Non funziona! I found a bug in the Klipper software Sto apportando modifiche che vorrei includere in Klipper Klipper github Forum della Comunit\u00e0 \u00b6 C'\u00e8 un server Klipper Community Discourse server per discussioni su Klipper. Chat Discord \u00b6 C'\u00e8 un serve Discord dedicato a Klipper a: https://discord.klipper3d.org . Questo server \u00e8 gestito da una comunit\u00e0 di appassionati di Klipper dediti alle discussioni su Klipper. Consente agli utenti di chattare con altri utenti in tempo reale. Ho una domanda su Klipper \u00b6 Molte domande che riceviamo hanno gi\u00e0 una risposta nella Klipper documentation . Per favore assicurati di leggere la documentazione e di seguire le indicazioni fornite. \u00c8 anche possibile cercare domande simili nel Klipper Community Forum . Se sei interessato a condividere le tue conoscenze ed esperienze con altri utenti di Klipper, puoi unirti al Klipper Community Forum o Klipper Discord Chat . Entrambe sono comunit\u00e0 in cui gli utenti di Klipper possono discutere di Klipper con altri utenti. Molte domande che riceviamo sono domande generiche sulla stampa 3D che non sono specifiche di Klipper. Se hai una domanda generica o stai riscontrando problemi di stampa generici, probabilmente otterrai una risposta migliore chiedendo in un forum generale sulla stampa 3D o in un forum dedicato all'hardware della tua stampante. Ho una richiesta per una funzionalit\u00e0 \u00b6 Tutte le nuove funzionalit\u00e0 richiedono qualcuno interessato e in grado di implementare tale funzionalit\u00e0. Se sei interessato ad aiutare a implementare o testare una nuova funzionalit\u00e0, puoi cercare gli sviluppi coinvolti nel Klipper Community Forum . C'\u00e8 anche Klipper Discord Chat per le discussioni tra i collaboratori. Aiuto! Non funziona! \u00b6 Sfortunatamente, riceviamo molte pi\u00f9 richieste di aiuto di quante potremmo eventualmente rispondere. La maggior parte delle segnalazioni di problemi che vediamo vengono infine rintracciate in: Piccoli nell'hardware, o Non seguendo tutti i passaggi descritti nella documentazione di Klipper. In caso di problemi, ti consigliamo di leggere attentamente la Klipper documentation e di verificare che tutti i passaggi siano stati seguiti. Se si verifica un problema di stampa, si consiglia di ispezionare attentamente l'hardware della stampante (tutti i giunti, i cavi, le viti, ecc.) e verificare che non vi siano anomalie. Scopriamo che la maggior parte dei problemi di stampa non sono correlati al software Klipper. Se trovi un problema con l'hardware della stampante, probabilmente otterrai una risposta migliore cercando in un forum generale di stampa 3D o in un forum dedicato all'hardware della tua stampante. \u00c8 anche possibile cercare problemi simili in Klipper Community Forum . Se sei interessato a condividere le tue conoscenze ed esperienze con altri utenti di Klipper, puoi unirti al Klipper Community Forum o Klipper Discord Chat . Entrambe sono comunit\u00e0 in cui gli utenti di Klipper possono discutere di Klipper con altri utenti. Ho trovato un bug nel software Klipper \u00b6 Klipper \u00e8 un progetto open-source ed apprezziamo quando i collaboratori diagnosticano errori nel software. I problemi devono essere segnalati nel Klipper Community Forum . Ci sono informazioni importanti che saranno necessarie per correggere un bug. Per favore segui questi passaggi: Assicurati di eseguire codice non modificato da https://github.com/Klipper3d/klipper . Se il codice \u00e8 stato modificato o \u00e8 stato ottenuto da un'altra fonte, \u00e8 necessario riprodurre il problema sul codice non modificato da https://github.com/Klipper3d/klipper prima della segnalazione. Se possibile, eseguire un comando M112 immediatamente dopo che si \u00e8 verificato l'evento indesiderato. Ci\u00f2 fa s\u00ec che Klipper entri in uno \"shutdown state\" e causer\u00e0 la scrittura di ulteriori informazioni di debug nel file di registro. Ottieni il log file di Klipper dell'evento. Il file di registro \u00e8 stato progettato per rispondere alle domande pi\u00f9 comuni degli sviluppatori di Klipper sul software e sul suo ambiente (versione del software, tipo di hardware, configurazione, tempistica degli eventi e centinaia di altre domande). Il log file di Klipper si trova in /tmp/klippy.log sul computer \"host\" di Klipper (il Raspberry Pi). Un comando o utility \"scp\" o \"sftp\" \u00e8 necessario per copiare questo file di registro sul computer desktop. L'utilit\u00e0 \"scp\" viene fornita di serie con i desktop Linux e MacOS. Ci sono utilit\u00e0 scp disponibili gratuitamente per altri desktop (ad es. WinSCP). Se si utilizza un'interfaccia grafica scp che non pu\u00f2 copiare direttamente /tmp/klippy.log , fare clic ripetutamente su .. o cartella principale fino ad arrivare alla directory principale, fare clic sulla cartella tmp , quindi seleziona il file klippy.log . Copia il lof file sul desktop in modo che possa essere allegato a una segnalazione di problema. Non modificare in alcun modo il log file; non editare o ritagliare il log file. Solo il file di log completo non modificato fornisce le informazioni necessarie. \u00c8 una buona idea comprimere il file di registro con zip o gzip. Apri un nuovo topic sul Klipper Community Forum e fornisci una descrizione chiara del problema. Altri contributori di Klipper dovranno capire quali passi sono stati compiuti, quale era il risultato desiderato e quale risultato si \u00e8 effettivamente verificato. Il file di registro compresso di Klipper dovrebbe essere allegato a quel topic. Sto apportando modifiche che vorrei includere in Klipper \u00b6 Klipper \u00e8 un software open-source e apprezziamo i nuovi contributi. I nuovi contributi (sia per il codice che per la documentazione) vengono inviati tramite Github Pull Requests. Vedere [ CONTRIBUTING document per informazioni importanti. Ci sono diversi documenti per sviluppatori . Se hai domande sul codice, puoi anche chiedere nel Klipper Community Forum o nella Klipper Community Discord . Klipper github \u00b6 Klipper github pu\u00f2 essere utilizzato dai contributori per condividere lo stato del loro lavoro per migliorare Klipper. Ci si aspetta che la persona che apre un ticket github stia lavorando attivamente all'attivit\u00e0 specificata e sar\u00e0 quella che eseguir\u00e0 tutto il lavoro necessario per realizzarla. Il github di Klipper non viene utilizzato per richieste, n\u00e9 per segnalare bug, n\u00e9 per porre domande. Usa invece il Klipper Community Forum o la Klipper Community Discord .","title":"Contatti"},{"location":"Contact.html#contatti","text":"Questo documento fornisce informazioni di contatto per Klipper. Forum della comunit\u00e0 Chat Discord Ho una domanda su Klipper Ho una richiesta per una funzionalit\u00e0 Aiuto! Non funziona! I found a bug in the Klipper software Sto apportando modifiche che vorrei includere in Klipper Klipper github","title":"Contatti"},{"location":"Contact.html#forum-della-comunita","text":"C'\u00e8 un server Klipper Community Discourse server per discussioni su Klipper.","title":"Forum della Comunit\u00e0"},{"location":"Contact.html#chat-discord","text":"C'\u00e8 un serve Discord dedicato a Klipper a: https://discord.klipper3d.org . Questo server \u00e8 gestito da una comunit\u00e0 di appassionati di Klipper dediti alle discussioni su Klipper. Consente agli utenti di chattare con altri utenti in tempo reale.","title":"Chat Discord"},{"location":"Contact.html#ho-una-domanda-su-klipper","text":"Molte domande che riceviamo hanno gi\u00e0 una risposta nella Klipper documentation . Per favore assicurati di leggere la documentazione e di seguire le indicazioni fornite. \u00c8 anche possibile cercare domande simili nel Klipper Community Forum . Se sei interessato a condividere le tue conoscenze ed esperienze con altri utenti di Klipper, puoi unirti al Klipper Community Forum o Klipper Discord Chat . Entrambe sono comunit\u00e0 in cui gli utenti di Klipper possono discutere di Klipper con altri utenti. Molte domande che riceviamo sono domande generiche sulla stampa 3D che non sono specifiche di Klipper. Se hai una domanda generica o stai riscontrando problemi di stampa generici, probabilmente otterrai una risposta migliore chiedendo in un forum generale sulla stampa 3D o in un forum dedicato all'hardware della tua stampante.","title":"Ho una domanda su Klipper"},{"location":"Contact.html#ho-una-richiesta-per-una-funzionalita","text":"Tutte le nuove funzionalit\u00e0 richiedono qualcuno interessato e in grado di implementare tale funzionalit\u00e0. Se sei interessato ad aiutare a implementare o testare una nuova funzionalit\u00e0, puoi cercare gli sviluppi coinvolti nel Klipper Community Forum . C'\u00e8 anche Klipper Discord Chat per le discussioni tra i collaboratori.","title":"Ho una richiesta per una funzionalit\u00e0"},{"location":"Contact.html#aiuto-non-funziona","text":"Sfortunatamente, riceviamo molte pi\u00f9 richieste di aiuto di quante potremmo eventualmente rispondere. La maggior parte delle segnalazioni di problemi che vediamo vengono infine rintracciate in: Piccoli nell'hardware, o Non seguendo tutti i passaggi descritti nella documentazione di Klipper. In caso di problemi, ti consigliamo di leggere attentamente la Klipper documentation e di verificare che tutti i passaggi siano stati seguiti. Se si verifica un problema di stampa, si consiglia di ispezionare attentamente l'hardware della stampante (tutti i giunti, i cavi, le viti, ecc.) e verificare che non vi siano anomalie. Scopriamo che la maggior parte dei problemi di stampa non sono correlati al software Klipper. Se trovi un problema con l'hardware della stampante, probabilmente otterrai una risposta migliore cercando in un forum generale di stampa 3D o in un forum dedicato all'hardware della tua stampante. \u00c8 anche possibile cercare problemi simili in Klipper Community Forum . Se sei interessato a condividere le tue conoscenze ed esperienze con altri utenti di Klipper, puoi unirti al Klipper Community Forum o Klipper Discord Chat . Entrambe sono comunit\u00e0 in cui gli utenti di Klipper possono discutere di Klipper con altri utenti.","title":"Aiuto! Non funziona!"},{"location":"Contact.html#ho-trovato-un-bug-nel-software-klipper","text":"Klipper \u00e8 un progetto open-source ed apprezziamo quando i collaboratori diagnosticano errori nel software. I problemi devono essere segnalati nel Klipper Community Forum . Ci sono informazioni importanti che saranno necessarie per correggere un bug. Per favore segui questi passaggi: Assicurati di eseguire codice non modificato da https://github.com/Klipper3d/klipper . Se il codice \u00e8 stato modificato o \u00e8 stato ottenuto da un'altra fonte, \u00e8 necessario riprodurre il problema sul codice non modificato da https://github.com/Klipper3d/klipper prima della segnalazione. Se possibile, eseguire un comando M112 immediatamente dopo che si \u00e8 verificato l'evento indesiderato. Ci\u00f2 fa s\u00ec che Klipper entri in uno \"shutdown state\" e causer\u00e0 la scrittura di ulteriori informazioni di debug nel file di registro. Ottieni il log file di Klipper dell'evento. Il file di registro \u00e8 stato progettato per rispondere alle domande pi\u00f9 comuni degli sviluppatori di Klipper sul software e sul suo ambiente (versione del software, tipo di hardware, configurazione, tempistica degli eventi e centinaia di altre domande). Il log file di Klipper si trova in /tmp/klippy.log sul computer \"host\" di Klipper (il Raspberry Pi). Un comando o utility \"scp\" o \"sftp\" \u00e8 necessario per copiare questo file di registro sul computer desktop. L'utilit\u00e0 \"scp\" viene fornita di serie con i desktop Linux e MacOS. Ci sono utilit\u00e0 scp disponibili gratuitamente per altri desktop (ad es. WinSCP). Se si utilizza un'interfaccia grafica scp che non pu\u00f2 copiare direttamente /tmp/klippy.log , fare clic ripetutamente su .. o cartella principale fino ad arrivare alla directory principale, fare clic sulla cartella tmp , quindi seleziona il file klippy.log . Copia il lof file sul desktop in modo che possa essere allegato a una segnalazione di problema. Non modificare in alcun modo il log file; non editare o ritagliare il log file. Solo il file di log completo non modificato fornisce le informazioni necessarie. \u00c8 una buona idea comprimere il file di registro con zip o gzip. Apri un nuovo topic sul Klipper Community Forum e fornisci una descrizione chiara del problema. Altri contributori di Klipper dovranno capire quali passi sono stati compiuti, quale era il risultato desiderato e quale risultato si \u00e8 effettivamente verificato. Il file di registro compresso di Klipper dovrebbe essere allegato a quel topic.","title":"Ho trovato un bug nel software Klipper"},{"location":"Contact.html#sto-apportando-modifiche-che-vorrei-includere-in-klipper","text":"Klipper \u00e8 un software open-source e apprezziamo i nuovi contributi. I nuovi contributi (sia per il codice che per la documentazione) vengono inviati tramite Github Pull Requests. Vedere [ CONTRIBUTING document per informazioni importanti. Ci sono diversi documenti per sviluppatori . Se hai domande sul codice, puoi anche chiedere nel Klipper Community Forum o nella Klipper Community Discord .","title":"Sto apportando modifiche che vorrei includere in Klipper"},{"location":"Contact.html#klipper-github","text":"Klipper github pu\u00f2 essere utilizzato dai contributori per condividere lo stato del loro lavoro per migliorare Klipper. Ci si aspetta che la persona che apre un ticket github stia lavorando attivamente all'attivit\u00e0 specificata e sar\u00e0 quella che eseguir\u00e0 tutto il lavoro necessario per realizzarla. Il github di Klipper non viene utilizzato per richieste, n\u00e9 per segnalare bug, n\u00e9 per porre domande. Usa invece il Klipper Community Forum o la Klipper Community Discord .","title":"Klipper github"},{"location":"Debugging.html","text":"Debugging \u00b6 Questo documento descrive alcuni degli strumenti di debug di Klipper. Esecuzione dei test di regressione \u00b6 Il repository principale di Klipper GitHub utilizza \"github actions\" per eseguire una serie di test di regressione. Pu\u00f2 essere utile eseguire alcuni di questi test in locale. Il sorgente \"controllo spazi bianchi\" pu\u00f2 essere eseguito con: ./scripts/check_whitespace.sh La suite di test di regressione Klippy richiede \"dizionari di dati\" da molte piattaforme. Il modo pi\u00f9 semplice per ottenerli \u00e8 scaricarli da github . Una volta scaricati i dizionari di dati, utilizzare quanto segue per eseguire la suite di regressione: tar xfz klipper-dict-20??????.tar.gz ~/klippy-env/bin/python ~/klipper/scripts/test_klippy.py -d dict/ ~/klipper/test/klippy/*.test Invio manuale di comandi al microcontrollore \u00b6 Normalmente, il processo host klippy.py verrebbe utilizzato per tradurre i comandi gcode in comandi del microcontrollore Klipper. Tuttavia, \u00e8 anche possibile inviare manualmente questi comandi MCU (funzioni contrassegnate con la macro DECL_COMMAND() nel codice sorgente di Klipper). Per farlo, esegui: ~/klippy-env/bin/python ./klippy/console.py /tmp/pseudoserial Vedere il comando \"HELP\" all'interno dello strumento per ulteriori informazioni sulla sua funzionalit\u00e0. Sono disponibili alcune opzioni della riga di comando. Per ulteriori informazioni esegui: ~/klippy-env/bin/python ./klippy/console.py --help Traduzione di file gcode in comandi del microcontrollore \u00b6 Il codice host Klippy pu\u00f2 essere eseguito in modalit\u00e0 batch per produrre i comandi del microcontrollore di basso livello associati a un file gcode. L'ispezione di questi comandi di basso livello \u00e8 utile quando si cerca di comprendere le azioni dell'hardware di basso livello. Pu\u00f2 anche essere utile confrontare la differenza nei comandi del microcontrollore dopo una modifica del codice. Per eseguire Klippy in questa modalit\u00e0 batch, \u00e8 necessario un passaggio per generare il \"dizionario dati\" del microcontrollore. Questo viene fatto compilando il codice del microcontrollore per ottenere il file out/klipper.dict : make menuconfig make Una volta fatto quanto sopra \u00e8 possibile eseguire Klipper in modalit\u00e0 batch (vedi installazione per i passaggi necessari per costruire l'ambiente virtuale python e un file printer.cfg): ~/klippy-env/bin/python ./klippy/klippy.py ~/printer.cfg -i test.gcode -o test.serial -v -d out/klipper.dict Quanto sopra produrr\u00e0 un file test.serial con output seriale binario. Questo output pu\u00f2 essere tradotto in testo leggibile con: ~/klippy-env/bin/python ./klippy/parsedump.py out/klipper.dict test.serial > test.txt Il file risultante test.txt contiene un elenco leggibile di comandi del microcontrollore. La modalit\u00e0 batch disabilita alcuni comandi di risposta/richiesta per funzionare. Di conseguenza, ci saranno alcune differenze tra i comandi effettivi e l'output sopra. I dati generati sono utili per il test e l'ispezione; non \u00e8 utile per l'invio a un vero microcontrollore. Analisi del movimento e registrazione dei dati \u00b6 Klipper supporta la registrazione della cronologia dei movimenti interni, che pu\u00f2 essere analizzata in seguito. Per utilizzare questa funzione, Klipper deve essere avviato con Server API abilitato. La registrazione dei dati \u00e8 abilitata con lo strumento data_logger.py . Per esempio: ~/klipper/scripts/motan/data_logger.py /tmp/klippy_uds mylog Questo comando si collegher\u00e0 al Klipper API Server, sottoscriver\u00e0 le informazioni sullo stato e sul movimento e registrer\u00e0 i risultati. Vengono generati due file: un file di dati compresso e un file di indice (ad esempio, mylog.json.gz e mylog.index.gz ). Dopo aver avviato la registrazione, \u00e8 possibile completare le stampe e altre azioni: la registrazione continuer\u00e0 in background. Al termine della registrazione, premi ctrl-c per uscire dallo strumento data_logger.py . I file risultanti possono essere letti e rappresentati graficamente utilizzando lo strumento motan_graph.py . Per generare grafici su un Raspberry Pi, \u00e8 necessario un passaggio per installare il pacchetto \"matplotlib\": sudo apt-get update sudo apt-get install python-matplotlib Tuttavia, potrebbe essere pi\u00f9 conveniente copiare i file di dati su una macchina di classe desktop insieme al codice Python nella directory scripts/motan/ . Gli script di analisi del movimento dovrebbero essere eseguiti su qualsiasi macchina con una versione recente di Python e Matplotlib installata. I grafici possono essere generati con un comando come il seguente: ~/klipper/scripts/motan/motan_graph.py mylog -o mygraph.png One can use the -g option to specify the datasets to graph (it takes a Python literal containing a list of lists). For example: ~/klipper/scripts/motan/motan_graph.py mylog -g '[[\"trapq(toolhead,velocity)\"], [\"trapq(toolhead,accel)\"]]' L'elenco dei set di dati disponibili pu\u00f2 essere trovato usando l'opzione -l , ad esempio: ~/klipper/scripts/motan/motan_graph.py -l \u00c8 anche possibile specificare le opzioni di stampa matplotlib per ogni set di dati: ~/klipper/scripts/motan/motan_graph.py mylog -g '[[\"trapq(toolhead,velocity)?color=red&alpha=0.4\"]]' Sono disponibili molte opzioni di matplotlib; alcuni esempi sono \"color\", \"label\", \"alpha\" e \"linestyle\". Lo strumento motan_graph.py supporta molte altre opzioni della riga di comando: usa l'opzione --help per vedere un elenco. Pu\u00f2 anche essere conveniente visualizzare/modificare lo stesso script motan_graph.py . I log di dati grezzi prodotti dallo strumento data_logger.py seguono il formato descritto in Server API . Pu\u00f2 essere utile ispezionare i dati con un comando Unix come il seguente: gunzip < mylog.json.gz | tr '\\03' '\\n' | less Generare di grafici di carico \u00b6 Il file di registro di Klippy (/tmp/klippy.log) memorizza le statistiche sulla larghezza di banda, sul carico del microcontrollore e sul carico del buffer dell'host. Pu\u00f2 essere utile rappresentare graficamente queste statistiche dopo una stampa. Per generare un grafico, \u00e8 necessario un passaggio una tantum per installare il pacchetto \"matplotlib\": sudo apt-get update sudo apt-get install python-matplotlib Quindi i grafici possono essere prodotti con: ~/klipper/scripts/graphstats.py /tmp/klippy.log -o loadgraph.png Si pu\u00f2 quindi visualizzare il file loadgraph.png risultante. Possono essere prodotti diversi grafici. Per ulteriori informazioni esegui: ~/klipper/scripts/graphstats.py --help Estrazione di informazioni dal file klippy.log \u00b6 Anche il file di registro di Klippy (/tmp/klippy.log) contiene informazioni di debug. Esiste uno script logextract.py che pu\u00f2 essere utile quando si analizza l'arresto di un microcontrollore o un problema simile. In genere viene eseguito con qualcosa come: mkdir work_directory cd work_directory cp /tmp/klippy.log . ~/klipper/scripts/logextract.py ./klippy.log Lo script estrarr\u00e0 il file di configurazione della stampante ed estrarr\u00e0 le informazioni di arresto dell'MCU. I dump delle informazioni da un arresto dell'MCU (se presente) verranno riordinati in base al timestamp per facilitare la diagnosi degli scenari di causa ed effetto. Test con simulavr \u00b6 Lo strumento simulavr consente di simulare un microcontrollore Atmel ATmega. Questa sezione descrive come eseguire test di file gcode tramite simulavr. Si consiglia di eseguirlo su una macchina di classe desktop (non un Raspberry Pi) poich\u00e9 richiede una CPU significativa per funzionare in modo efficiente. Per utilizzare simulavr, scarica il pacchetto simulavr e compila con il supporto python. Nota che il sistema di build potrebbe aver bisogno di alcuni pacchetti (come swig) installati per costruire il modulo python. git clone git://git.savannah.nongnu.org/simulavr.git cd simulavr make python make build Assicurati che un file come ./build/pysimulavr/_pysimulavr.*.so sia presente dopo la compilazione di cui sopra: ls ./build/pysimulavr/_pysimulavr.*.so Questo comando dovrebbe segnalare un file specifico (ad es. ./build/pysimulavr/_pysimulavr.cpython-39-x86_64-linux-gnu.so ) e non un errore. Se utilizzi un sistema basato su Debian (Debian, Ubuntu, ecc.) puoi installare i seguenti pacchetti e generare file *.deb per l'installazione di simulavr a livello di sistema: sudo apt update sudo apt install g++ make cmake swig rst2pdf help2man texinfo make cfgclean python debian sudo dpkg -i build/debian/python3-simulavr*.deb Per compilare Klipper per l'uso in simulavr, eseguire: cd /path/to/klipper make menuconfig e compilare il software del microcontrollore per un AVR atmega644p e selezionare il supporto per l'emulazione del software SIMULAVR. Quindi si pu\u00f2 compilare Klipper (eseguire make ) e quindi avviare la simulazione con: PYTHONPATH=/path/to/simulavr/build/pysimulavr/ ./scripts/avrsim.py out/klipper.elf Nota che se hai installato python3-simulavr a livello di sistema, non \u00e8 necessario impostare PYTHONPATH e puoi semplicemente eseguire il simulatore come ./scripts/avrsim.py out/klipper.elf Quindi, con simulavr in esecuzione in un'altra finestra, \u00e8 possibile eseguire quanto segue per leggere gcode da un file (ad es. \"test.gcode\"), elaborarlo con Klippy e inviarlo a Klipper in esecuzione in simulavr (vedere installazione per i passaggi necessari per costruire l'ambiente virtuale Python): ~/klippy-env/bin/python ./klippy/klippy.py config/generic-simulavr.cfg -i test.gcode -v Utilizzo di simulavr con gtkwave \u00b6 Una caratteristica utile di simulavr \u00e8 la sua capacit\u00e0 di creare file di generazione di onde di segnale con l'esatta sincronizzazione degli eventi. Per fare ci\u00f2, segui le istruzioni sopra, ma esegui avrsim.py con una riga di comando come la seguente: PYTHONPATH=/path/to/simulavr/src/python/ ./scripts/avrsim.py out/klipper.elf -t PORTA.PORT,PORTC.PORT Quanto sopra creerebbe un file avrsim.vcd con informazioni su ogni modifica ai GPIO su PORTA e PORTB. Questo potrebbe quindi essere visualizzato usando gtkwave con: gtkwave avrsim.vcd","title":"Debugging"},{"location":"Debugging.html#debugging","text":"Questo documento descrive alcuni degli strumenti di debug di Klipper.","title":"Debugging"},{"location":"Debugging.html#esecuzione-dei-test-di-regressione","text":"Il repository principale di Klipper GitHub utilizza \"github actions\" per eseguire una serie di test di regressione. Pu\u00f2 essere utile eseguire alcuni di questi test in locale. Il sorgente \"controllo spazi bianchi\" pu\u00f2 essere eseguito con: ./scripts/check_whitespace.sh La suite di test di regressione Klippy richiede \"dizionari di dati\" da molte piattaforme. Il modo pi\u00f9 semplice per ottenerli \u00e8 scaricarli da github . Una volta scaricati i dizionari di dati, utilizzare quanto segue per eseguire la suite di regressione: tar xfz klipper-dict-20??????.tar.gz ~/klippy-env/bin/python ~/klipper/scripts/test_klippy.py -d dict/ ~/klipper/test/klippy/*.test","title":"Esecuzione dei test di regressione"},{"location":"Debugging.html#invio-manuale-di-comandi-al-microcontrollore","text":"Normalmente, il processo host klippy.py verrebbe utilizzato per tradurre i comandi gcode in comandi del microcontrollore Klipper. Tuttavia, \u00e8 anche possibile inviare manualmente questi comandi MCU (funzioni contrassegnate con la macro DECL_COMMAND() nel codice sorgente di Klipper). Per farlo, esegui: ~/klippy-env/bin/python ./klippy/console.py /tmp/pseudoserial Vedere il comando \"HELP\" all'interno dello strumento per ulteriori informazioni sulla sua funzionalit\u00e0. Sono disponibili alcune opzioni della riga di comando. Per ulteriori informazioni esegui: ~/klippy-env/bin/python ./klippy/console.py --help","title":"Invio manuale di comandi al microcontrollore"},{"location":"Debugging.html#traduzione-di-file-gcode-in-comandi-del-microcontrollore","text":"Il codice host Klippy pu\u00f2 essere eseguito in modalit\u00e0 batch per produrre i comandi del microcontrollore di basso livello associati a un file gcode. L'ispezione di questi comandi di basso livello \u00e8 utile quando si cerca di comprendere le azioni dell'hardware di basso livello. Pu\u00f2 anche essere utile confrontare la differenza nei comandi del microcontrollore dopo una modifica del codice. Per eseguire Klippy in questa modalit\u00e0 batch, \u00e8 necessario un passaggio per generare il \"dizionario dati\" del microcontrollore. Questo viene fatto compilando il codice del microcontrollore per ottenere il file out/klipper.dict : make menuconfig make Una volta fatto quanto sopra \u00e8 possibile eseguire Klipper in modalit\u00e0 batch (vedi installazione per i passaggi necessari per costruire l'ambiente virtuale python e un file printer.cfg): ~/klippy-env/bin/python ./klippy/klippy.py ~/printer.cfg -i test.gcode -o test.serial -v -d out/klipper.dict Quanto sopra produrr\u00e0 un file test.serial con output seriale binario. Questo output pu\u00f2 essere tradotto in testo leggibile con: ~/klippy-env/bin/python ./klippy/parsedump.py out/klipper.dict test.serial > test.txt Il file risultante test.txt contiene un elenco leggibile di comandi del microcontrollore. La modalit\u00e0 batch disabilita alcuni comandi di risposta/richiesta per funzionare. Di conseguenza, ci saranno alcune differenze tra i comandi effettivi e l'output sopra. I dati generati sono utili per il test e l'ispezione; non \u00e8 utile per l'invio a un vero microcontrollore.","title":"Traduzione di file gcode in comandi del microcontrollore"},{"location":"Debugging.html#analisi-del-movimento-e-registrazione-dei-dati","text":"Klipper supporta la registrazione della cronologia dei movimenti interni, che pu\u00f2 essere analizzata in seguito. Per utilizzare questa funzione, Klipper deve essere avviato con Server API abilitato. La registrazione dei dati \u00e8 abilitata con lo strumento data_logger.py . Per esempio: ~/klipper/scripts/motan/data_logger.py /tmp/klippy_uds mylog Questo comando si collegher\u00e0 al Klipper API Server, sottoscriver\u00e0 le informazioni sullo stato e sul movimento e registrer\u00e0 i risultati. Vengono generati due file: un file di dati compresso e un file di indice (ad esempio, mylog.json.gz e mylog.index.gz ). Dopo aver avviato la registrazione, \u00e8 possibile completare le stampe e altre azioni: la registrazione continuer\u00e0 in background. Al termine della registrazione, premi ctrl-c per uscire dallo strumento data_logger.py . I file risultanti possono essere letti e rappresentati graficamente utilizzando lo strumento motan_graph.py . Per generare grafici su un Raspberry Pi, \u00e8 necessario un passaggio per installare il pacchetto \"matplotlib\": sudo apt-get update sudo apt-get install python-matplotlib Tuttavia, potrebbe essere pi\u00f9 conveniente copiare i file di dati su una macchina di classe desktop insieme al codice Python nella directory scripts/motan/ . Gli script di analisi del movimento dovrebbero essere eseguiti su qualsiasi macchina con una versione recente di Python e Matplotlib installata. I grafici possono essere generati con un comando come il seguente: ~/klipper/scripts/motan/motan_graph.py mylog -o mygraph.png One can use the -g option to specify the datasets to graph (it takes a Python literal containing a list of lists). For example: ~/klipper/scripts/motan/motan_graph.py mylog -g '[[\"trapq(toolhead,velocity)\"], [\"trapq(toolhead,accel)\"]]' L'elenco dei set di dati disponibili pu\u00f2 essere trovato usando l'opzione -l , ad esempio: ~/klipper/scripts/motan/motan_graph.py -l \u00c8 anche possibile specificare le opzioni di stampa matplotlib per ogni set di dati: ~/klipper/scripts/motan/motan_graph.py mylog -g '[[\"trapq(toolhead,velocity)?color=red&alpha=0.4\"]]' Sono disponibili molte opzioni di matplotlib; alcuni esempi sono \"color\", \"label\", \"alpha\" e \"linestyle\". Lo strumento motan_graph.py supporta molte altre opzioni della riga di comando: usa l'opzione --help per vedere un elenco. Pu\u00f2 anche essere conveniente visualizzare/modificare lo stesso script motan_graph.py . I log di dati grezzi prodotti dallo strumento data_logger.py seguono il formato descritto in Server API . Pu\u00f2 essere utile ispezionare i dati con un comando Unix come il seguente: gunzip < mylog.json.gz | tr '\\03' '\\n' | less","title":"Analisi del movimento e registrazione dei dati"},{"location":"Debugging.html#generare-di-grafici-di-carico","text":"Il file di registro di Klippy (/tmp/klippy.log) memorizza le statistiche sulla larghezza di banda, sul carico del microcontrollore e sul carico del buffer dell'host. Pu\u00f2 essere utile rappresentare graficamente queste statistiche dopo una stampa. Per generare un grafico, \u00e8 necessario un passaggio una tantum per installare il pacchetto \"matplotlib\": sudo apt-get update sudo apt-get install python-matplotlib Quindi i grafici possono essere prodotti con: ~/klipper/scripts/graphstats.py /tmp/klippy.log -o loadgraph.png Si pu\u00f2 quindi visualizzare il file loadgraph.png risultante. Possono essere prodotti diversi grafici. Per ulteriori informazioni esegui: ~/klipper/scripts/graphstats.py --help","title":"Generare di grafici di carico"},{"location":"Debugging.html#estrazione-di-informazioni-dal-file-klippylog","text":"Anche il file di registro di Klippy (/tmp/klippy.log) contiene informazioni di debug. Esiste uno script logextract.py che pu\u00f2 essere utile quando si analizza l'arresto di un microcontrollore o un problema simile. In genere viene eseguito con qualcosa come: mkdir work_directory cd work_directory cp /tmp/klippy.log . ~/klipper/scripts/logextract.py ./klippy.log Lo script estrarr\u00e0 il file di configurazione della stampante ed estrarr\u00e0 le informazioni di arresto dell'MCU. I dump delle informazioni da un arresto dell'MCU (se presente) verranno riordinati in base al timestamp per facilitare la diagnosi degli scenari di causa ed effetto.","title":"Estrazione di informazioni dal file klippy.log"},{"location":"Debugging.html#test-con-simulavr","text":"Lo strumento simulavr consente di simulare un microcontrollore Atmel ATmega. Questa sezione descrive come eseguire test di file gcode tramite simulavr. Si consiglia di eseguirlo su una macchina di classe desktop (non un Raspberry Pi) poich\u00e9 richiede una CPU significativa per funzionare in modo efficiente. Per utilizzare simulavr, scarica il pacchetto simulavr e compila con il supporto python. Nota che il sistema di build potrebbe aver bisogno di alcuni pacchetti (come swig) installati per costruire il modulo python. git clone git://git.savannah.nongnu.org/simulavr.git cd simulavr make python make build Assicurati che un file come ./build/pysimulavr/_pysimulavr.*.so sia presente dopo la compilazione di cui sopra: ls ./build/pysimulavr/_pysimulavr.*.so Questo comando dovrebbe segnalare un file specifico (ad es. ./build/pysimulavr/_pysimulavr.cpython-39-x86_64-linux-gnu.so ) e non un errore. Se utilizzi un sistema basato su Debian (Debian, Ubuntu, ecc.) puoi installare i seguenti pacchetti e generare file *.deb per l'installazione di simulavr a livello di sistema: sudo apt update sudo apt install g++ make cmake swig rst2pdf help2man texinfo make cfgclean python debian sudo dpkg -i build/debian/python3-simulavr*.deb Per compilare Klipper per l'uso in simulavr, eseguire: cd /path/to/klipper make menuconfig e compilare il software del microcontrollore per un AVR atmega644p e selezionare il supporto per l'emulazione del software SIMULAVR. Quindi si pu\u00f2 compilare Klipper (eseguire make ) e quindi avviare la simulazione con: PYTHONPATH=/path/to/simulavr/build/pysimulavr/ ./scripts/avrsim.py out/klipper.elf Nota che se hai installato python3-simulavr a livello di sistema, non \u00e8 necessario impostare PYTHONPATH e puoi semplicemente eseguire il simulatore come ./scripts/avrsim.py out/klipper.elf Quindi, con simulavr in esecuzione in un'altra finestra, \u00e8 possibile eseguire quanto segue per leggere gcode da un file (ad es. \"test.gcode\"), elaborarlo con Klippy e inviarlo a Klipper in esecuzione in simulavr (vedere installazione per i passaggi necessari per costruire l'ambiente virtuale Python): ~/klippy-env/bin/python ./klippy/klippy.py config/generic-simulavr.cfg -i test.gcode -v","title":"Test con simulavr"},{"location":"Debugging.html#utilizzo-di-simulavr-con-gtkwave","text":"Una caratteristica utile di simulavr \u00e8 la sua capacit\u00e0 di creare file di generazione di onde di segnale con l'esatta sincronizzazione degli eventi. Per fare ci\u00f2, segui le istruzioni sopra, ma esegui avrsim.py con una riga di comando come la seguente: PYTHONPATH=/path/to/simulavr/src/python/ ./scripts/avrsim.py out/klipper.elf -t PORTA.PORT,PORTC.PORT Quanto sopra creerebbe un file avrsim.vcd con informazioni su ogni modifica ai GPIO su PORTA e PORTB. Questo potrebbe quindi essere visualizzato usando gtkwave con: gtkwave avrsim.vcd","title":"Utilizzo di simulavr con gtkwave"},{"location":"Delta_Calibrate.html","text":"Calibrazione delta \u00b6 Questo documento descrive il sistema di calibrazione automatica di Klipper per stampanti \"delta\". La calibrazione delta implica la ricerca delle posizioni dei finecorsa della torre, degli angoli della torre, del raggio delta e delle lunghezze del braccio delta. Queste impostazioni controllano il movimento della stampante su una stampante delta. Ognuno di questi parametri ha un impatto non evidente e non lineare ed \u00e8 difficile calibrarli manualmente. Al contrario, il codice di calibrazione del software pu\u00f2 fornire risultati eccellenti in pochi minuti di tempo. Non \u00e8 necessario alcun hardware di rilevamento speciale. In definitiva, la calibrazione delta dipende dalla precisione degli interruttori di fine corsa della torre. Se si utilizzano i driver per motori passo-passo Trinamic, considerare l'abilitazione del rilevamento fase endstop per migliorare la precisione di tali interruttori. Sonda automatica vs manuale \u00b6 Klipper supporta la calibrazione dei parametri delta tramite un metodo di sonda manuale o tramite una sonda Z automatica. Numerosi kit di stampanti delta sono dotati di sonde Z automatiche che non sono sufficientemente accurate (in particolare, piccole differenze nella lunghezza del braccio possono causare l'inclinazione dell'effettore che pu\u00f2 distorcere una sonda automatica). Se si utilizza una sonda automatica, prima calibrare la sonda e quindi verificare la presenza di un bias posizione sonda . Se la sonda automatica ha una polarizzazione superiore a 25 micron (0,025 mm), utilizzare invece la sonda manuale. Il probing manuale richiede solo pochi minuti ed elimina l'errore introdotto dalla sonda. Se si utilizza una sonda montata sul lato dell'hotend (ovvero ha un offset X o Y), tenere presente che l'esecuzione della calibrazione delta invalider\u00e0 i risultati della calibrazione della sonda. Questi tipi di sonde sono raramente adatti per l'uso su un delta (poich\u00e9 una minore inclinazione dell'effettore risulter\u00e0 in una distorsione della posizione della sonda). Se si utilizza comunque la sonda, assicurarsi di eseguire nuovamente la calibrazione della sonda dopo qualsiasi calibrazione delta. Calibrazione delta di base \u00b6 Klipper ha un comando DELTA_CALIBRATE che pu\u00f2 eseguire la calibrazione delta di base. Questo comando sonda sette diversi punti sul letto e calcola nuovi valori per gli angoli della torre, i punti terminali della torre e il raggio delta. Per eseguire questa calibrazione devono essere forniti i parametri delta iniziali (lunghezze dei bracci, raggio e posizioni dei finecorsa) e devono avere una precisione di pochi millimetri. La maggior parte dei kit della stampante delta fornisce questi parametri: configurare la stampante con queste impostazioni predefinite iniziali e quindi eseguire il comando DELTA_CALIBRATE come descritto di seguito. Se non sono disponibili impostazioni predefinite, cercare online una guida alla calibrazione delta che possa fornire un punto di partenza di base. Durante il processo di calibrazione delta potrebbe essere necessario che la stampante sondi al di sotto di quello che altrimenti sarebbe considerato il piano del piatto. \u00c8 tipico consentire ci\u00f2 durante la calibrazione aggiornando la configurazione in modo che minimum_z_position=-5 della stampante. (Una volta completata la calibrazione, \u00e8 possibile rimuovere questa impostazione dalla configurazione.) Ci sono due modi per eseguire la procedura: probing manuale ( DELTA_CALIBRATE METHOD=manual ) e automatica ( DELTA_CALIBRATE ). Il metodo di rilevamento manuale sposter\u00e0 la testa vicino al piatto e quindi attender\u00e0 che l'utente segua i passaggi descritti in \"test della carta\" per determinare la distanza effettiva tra l'ugello e letto nel luogo indicato. Per eseguire la misura di base, assicurati che la configurazione abbia una sezione [delta_calibrate] definita e quindi esegui lo strumento: G28 DELTA_CALIBRATE METHOD=manual Dopo aver sondato i sette punti verranno calcolati i nuovi parametri delta. Salva e applica questi parametri eseguendo: SAVE_CONFIG La calibrazione di base dovrebbe fornire parametri delta sufficientemente accurati per la stampa di base. Se si tratta di una nuova stampante, questo \u00e8 un buon momento per stampare alcuni oggetti di base e verificarne la funzionalit\u00e0 generale. Calibrazione delta migliorata \u00b6 La calibrazione delta di base generalmente fa un buon lavoro nel calcolo dei parametri delta in modo tale che l'ugello sia alla distanza corretta dal letto. Tuttavia, non tenta di calibrare la precisione dimensionale X e Y. \u00c8 una buona idea eseguire una calibrazione delta avanzata per verificare l'accuratezza dimensionale. Questa procedura di calibrazione richiede la stampa di un oggetto di prova e la misurazione di parti di tale oggetto di prova con un calibro digitale. Prima di eseguire una calibrazione delta avanzata, \u00e8 necessario eseguire la calibrazione delta di base (tramite il comando DELTA_CALIBRATE) e salvare i risultati (tramite il comando SAVE_CONFIG). Assicurati che non siano state apportate modifiche degne di nota alla configurazione della stampante n\u00e9 all'hardware dall'ultima esecuzione di una calibrazione delta di base (se non sei sicuro, esegui nuovamente la calibrazione delta di base , incluso SAVE_CONFIG, appena prima della stampa l'oggetto di prova descritto di seguito.) Usa uno slicer per generare il G-code dal file docs/prints/calibrate_size.stl . Estrudere l'oggetto a bassa velocit\u00e0 (ad es. 40 mm/s). Se possibile, usa una plastica rigida (come il PLA) per l'oggetto. L'oggetto ha un diametro di 140 mm. Se questo \u00e8 troppo grande per la stampante, \u00e8 possibile ridimensionarlo (ma assicurati di ridimensionare uniformemente entrambi gli assi X e Y). Se la stampante supporta stampe significativamente pi\u00f9 grandi, \u00e8 anche possibile aumentare le dimensioni di questo oggetto. Un formato pi\u00f9 grande pu\u00f2 migliorare la precisione della misurazione, ma una buona adesione di stampa \u00e8 pi\u00f9 importante di un formato di stampa pi\u00f9 grande. Stampa l'oggetto di prova e attendi che si raffreddi completamente. I comandi descritti di seguito devono essere eseguiti con le stesse impostazioni della stampante utilizzate per stampare l'oggetto di calibrazione (non eseguire DELTA_CALIBRATE tra la stampa e la misurazione, o fare qualcosa che altrimenti modificherebbe la configurazione della stampante). Se possibile, esegui le misurazioni descritte di seguito mentre l'oggetto \u00e8 ancora attaccato al piano di stampa, ma non preoccuparti se la parte si stacca dal letto: cerca solo di evitare di piegare l'oggetto durante l'esecuzione delle misurazioni. Inizia misurando la distanza tra il pilastro centrale e il pilastro accanto all'etichetta \"A\" (che dovrebbe anche puntare verso la torre \"A\"). Quindi procedere in senso antiorario e misurare le distanze tra il pilastro centrale e gli altri pilastri (distanza dal centro al pilastro attraverso l'etichetta C, distanza dal centro al pilastro con l'etichetta B, ecc.). Inserisci questi parametri in Klipper con un elenco separato da virgole di numeri in virgola mobile: DELTA_ANALYZE CENTER_DISTS=<a_dist>,<far_c_dist>,<b_dist>,<far_a_dist>,<c_dist>,<far_b_dist> Fornisci i valori senza spazi tra di loro. Quindi misurare la distanza tra il montante A e il montante di fronte all'etichetta C. Quindi andare in senso antiorario e misurare la distanza tra il pilastro di fronte a C e il pilastro B, la distanza tra il pilastro B e il pilastro di fronte a A, e cos\u00ec via. Inserisci questi parametri in Klipper: DELTA_ANALYZE OUTER_DISTS=<a_to_far_c>,<far_c_to_b>,<b_to_far_a>,<far_a_to_c>,<c_to_far_b>,<far_b_to_a> A questo punto va bene rimuovere l'oggetto dal letto. Le misure finali sono dei pilastri stessi. Misurare la dimensione del pilastro centrale lungo il raggio A, poi il raggio B e poi il raggio C. Inseriscili in Klipper: DELTA_ANALYZE CENTER_PILLAR_WIDTHS=<a>,<b>,<c> Le misure finali sono dei pilastri esterni. Inizia misurando la distanza del pilastro A lungo la linea da A al pilastro di fronte a C. Quindi andare in senso antiorario e misurare i restanti pilastri esterni (pilastro di fronte a C lungo la linea a B, pilastro B lungo la linea a pilastro di fronte ad A, ecc.). E inseriscili in Klipper: DELTA_ANALYZE OUTER_PILLAR_WIDTHS=<a>,<far_c>,<b>,<far_a>,<c>,<far_b> Se l'oggetto \u00e8 stato ridimensionato a una dimensione inferiore o superiore, fornire il fattore di scala utilizzato durante il taglio dell'oggetto: DELTA_ANALYZE SCALE=1.0 (Un valore di scala di 2,0 significherebbe che l'oggetto \u00e8 il doppio della sua dimensione originale, 0,5 sarebbe la met\u00e0 della sua dimensione originale.) Infine, esegui la calibrazione delta avanzata eseguendo: DELTA_ANALYZE CALIBRATE=extended Il completamento di questo comando pu\u00f2 richiedere diversi minuti. Dopo il completamento, calcoler\u00e0 i parametri delta aggiornati (raggio delta, angoli della torre, posizioni dei finecorsa e lunghezze dei bracci). Utilizzare il comando SAVE_CONFIG per salvare e applicare le impostazioni: SAVE_CONFIG Il comando SAVE_CONFIG salver\u00e0 sia i parametri delta aggiornati che le informazioni dalle misurazioni della distanza. Anche i futuri comandi DELTA_CALIBRATE utilizzeranno queste informazioni sulla distanza. Non tentare di reinserire le misurazioni grezze della distanza dopo aver eseguito SAVE_CONFIG, poich\u00e9 questo comando modifica la configurazione della stampante e le misurazioni grezze non vengono pi\u00f9 applicate. Note aggiuntive \u00b6 Se la stampante delta ha una buona precisione dimensionale, la distanza tra due pilastri qualsiasi dovrebbe essere di circa 74 mm e la larghezza di ogni pilastro dovrebbe essere di circa 9 mm. (In particolare, l'obiettivo \u00e8 che la distanza tra due pilastri qualsiasi meno la larghezza di uno dei pilastri sia esattamente 65 mm.) In caso di imprecisione dimensionale nella parte, la routine DELTA_ANALYZE calcoler\u00e0 nuovi parametri delta utilizzando entrambe le misurazioni della distanza e le misurazioni dell'altezza precedenti dall'ultimo comando DELTA_CALIBRATE. DELTA_ANALYZE pu\u00f2 produrre parametri delta sorprendenti. Ad esempio, pu\u00f2 suggerire lunghezze dei bracci che non corrispondono alle lunghezze effettive dei bracci della stampante. Nonostante ci\u00f2, i test hanno dimostrato che DELTA_ANALYZE produce spesso risultati superiori. Si ritiene che i parametri delta calcolati siano in grado di tenere conto di lievi errori in altre parti dell'hardware. Ad esempio, piccole differenze nella lunghezza del braccio possono comportare un'inclinazione dell'effettore e parte di tale inclinazione pu\u00f2 essere spiegata regolando i parametri della lunghezza del braccio. Utilizzo della mesh del piatto su un delta \u00b6 \u00c8 possibile utilizzare bed mesh su un delta. Tuttavia, \u00e8 importante ottenere una buona calibrazione delta prima di abilitare una mesh del letto. L'esecuzione della mesh del letto con una scarsa calibrazione delta comporter\u00e0 risultati confusi e scarsi. Si noti che l'esecuzione della calibrazione delta invalider\u00e0 qualsiasi mesh del piatto precedentemente ottenuto. Dopo aver eseguito una nuova calibrazione delta, assicurati di eseguire nuovamente BED_MESH_CALIBRATE.","title":"Calibrazione delta"},{"location":"Delta_Calibrate.html#calibrazione-delta","text":"Questo documento descrive il sistema di calibrazione automatica di Klipper per stampanti \"delta\". La calibrazione delta implica la ricerca delle posizioni dei finecorsa della torre, degli angoli della torre, del raggio delta e delle lunghezze del braccio delta. Queste impostazioni controllano il movimento della stampante su una stampante delta. Ognuno di questi parametri ha un impatto non evidente e non lineare ed \u00e8 difficile calibrarli manualmente. Al contrario, il codice di calibrazione del software pu\u00f2 fornire risultati eccellenti in pochi minuti di tempo. Non \u00e8 necessario alcun hardware di rilevamento speciale. In definitiva, la calibrazione delta dipende dalla precisione degli interruttori di fine corsa della torre. Se si utilizzano i driver per motori passo-passo Trinamic, considerare l'abilitazione del rilevamento fase endstop per migliorare la precisione di tali interruttori.","title":"Calibrazione delta"},{"location":"Delta_Calibrate.html#sonda-automatica-vs-manuale","text":"Klipper supporta la calibrazione dei parametri delta tramite un metodo di sonda manuale o tramite una sonda Z automatica. Numerosi kit di stampanti delta sono dotati di sonde Z automatiche che non sono sufficientemente accurate (in particolare, piccole differenze nella lunghezza del braccio possono causare l'inclinazione dell'effettore che pu\u00f2 distorcere una sonda automatica). Se si utilizza una sonda automatica, prima calibrare la sonda e quindi verificare la presenza di un bias posizione sonda . Se la sonda automatica ha una polarizzazione superiore a 25 micron (0,025 mm), utilizzare invece la sonda manuale. Il probing manuale richiede solo pochi minuti ed elimina l'errore introdotto dalla sonda. Se si utilizza una sonda montata sul lato dell'hotend (ovvero ha un offset X o Y), tenere presente che l'esecuzione della calibrazione delta invalider\u00e0 i risultati della calibrazione della sonda. Questi tipi di sonde sono raramente adatti per l'uso su un delta (poich\u00e9 una minore inclinazione dell'effettore risulter\u00e0 in una distorsione della posizione della sonda). Se si utilizza comunque la sonda, assicurarsi di eseguire nuovamente la calibrazione della sonda dopo qualsiasi calibrazione delta.","title":"Sonda automatica vs manuale"},{"location":"Delta_Calibrate.html#calibrazione-delta-di-base","text":"Klipper ha un comando DELTA_CALIBRATE che pu\u00f2 eseguire la calibrazione delta di base. Questo comando sonda sette diversi punti sul letto e calcola nuovi valori per gli angoli della torre, i punti terminali della torre e il raggio delta. Per eseguire questa calibrazione devono essere forniti i parametri delta iniziali (lunghezze dei bracci, raggio e posizioni dei finecorsa) e devono avere una precisione di pochi millimetri. La maggior parte dei kit della stampante delta fornisce questi parametri: configurare la stampante con queste impostazioni predefinite iniziali e quindi eseguire il comando DELTA_CALIBRATE come descritto di seguito. Se non sono disponibili impostazioni predefinite, cercare online una guida alla calibrazione delta che possa fornire un punto di partenza di base. Durante il processo di calibrazione delta potrebbe essere necessario che la stampante sondi al di sotto di quello che altrimenti sarebbe considerato il piano del piatto. \u00c8 tipico consentire ci\u00f2 durante la calibrazione aggiornando la configurazione in modo che minimum_z_position=-5 della stampante. (Una volta completata la calibrazione, \u00e8 possibile rimuovere questa impostazione dalla configurazione.) Ci sono due modi per eseguire la procedura: probing manuale ( DELTA_CALIBRATE METHOD=manual ) e automatica ( DELTA_CALIBRATE ). Il metodo di rilevamento manuale sposter\u00e0 la testa vicino al piatto e quindi attender\u00e0 che l'utente segua i passaggi descritti in \"test della carta\" per determinare la distanza effettiva tra l'ugello e letto nel luogo indicato. Per eseguire la misura di base, assicurati che la configurazione abbia una sezione [delta_calibrate] definita e quindi esegui lo strumento: G28 DELTA_CALIBRATE METHOD=manual Dopo aver sondato i sette punti verranno calcolati i nuovi parametri delta. Salva e applica questi parametri eseguendo: SAVE_CONFIG La calibrazione di base dovrebbe fornire parametri delta sufficientemente accurati per la stampa di base. Se si tratta di una nuova stampante, questo \u00e8 un buon momento per stampare alcuni oggetti di base e verificarne la funzionalit\u00e0 generale.","title":"Calibrazione delta di base"},{"location":"Delta_Calibrate.html#calibrazione-delta-migliorata","text":"La calibrazione delta di base generalmente fa un buon lavoro nel calcolo dei parametri delta in modo tale che l'ugello sia alla distanza corretta dal letto. Tuttavia, non tenta di calibrare la precisione dimensionale X e Y. \u00c8 una buona idea eseguire una calibrazione delta avanzata per verificare l'accuratezza dimensionale. Questa procedura di calibrazione richiede la stampa di un oggetto di prova e la misurazione di parti di tale oggetto di prova con un calibro digitale. Prima di eseguire una calibrazione delta avanzata, \u00e8 necessario eseguire la calibrazione delta di base (tramite il comando DELTA_CALIBRATE) e salvare i risultati (tramite il comando SAVE_CONFIG). Assicurati che non siano state apportate modifiche degne di nota alla configurazione della stampante n\u00e9 all'hardware dall'ultima esecuzione di una calibrazione delta di base (se non sei sicuro, esegui nuovamente la calibrazione delta di base , incluso SAVE_CONFIG, appena prima della stampa l'oggetto di prova descritto di seguito.) Usa uno slicer per generare il G-code dal file docs/prints/calibrate_size.stl . Estrudere l'oggetto a bassa velocit\u00e0 (ad es. 40 mm/s). Se possibile, usa una plastica rigida (come il PLA) per l'oggetto. L'oggetto ha un diametro di 140 mm. Se questo \u00e8 troppo grande per la stampante, \u00e8 possibile ridimensionarlo (ma assicurati di ridimensionare uniformemente entrambi gli assi X e Y). Se la stampante supporta stampe significativamente pi\u00f9 grandi, \u00e8 anche possibile aumentare le dimensioni di questo oggetto. Un formato pi\u00f9 grande pu\u00f2 migliorare la precisione della misurazione, ma una buona adesione di stampa \u00e8 pi\u00f9 importante di un formato di stampa pi\u00f9 grande. Stampa l'oggetto di prova e attendi che si raffreddi completamente. I comandi descritti di seguito devono essere eseguiti con le stesse impostazioni della stampante utilizzate per stampare l'oggetto di calibrazione (non eseguire DELTA_CALIBRATE tra la stampa e la misurazione, o fare qualcosa che altrimenti modificherebbe la configurazione della stampante). Se possibile, esegui le misurazioni descritte di seguito mentre l'oggetto \u00e8 ancora attaccato al piano di stampa, ma non preoccuparti se la parte si stacca dal letto: cerca solo di evitare di piegare l'oggetto durante l'esecuzione delle misurazioni. Inizia misurando la distanza tra il pilastro centrale e il pilastro accanto all'etichetta \"A\" (che dovrebbe anche puntare verso la torre \"A\"). Quindi procedere in senso antiorario e misurare le distanze tra il pilastro centrale e gli altri pilastri (distanza dal centro al pilastro attraverso l'etichetta C, distanza dal centro al pilastro con l'etichetta B, ecc.). Inserisci questi parametri in Klipper con un elenco separato da virgole di numeri in virgola mobile: DELTA_ANALYZE CENTER_DISTS=<a_dist>,<far_c_dist>,<b_dist>,<far_a_dist>,<c_dist>,<far_b_dist> Fornisci i valori senza spazi tra di loro. Quindi misurare la distanza tra il montante A e il montante di fronte all'etichetta C. Quindi andare in senso antiorario e misurare la distanza tra il pilastro di fronte a C e il pilastro B, la distanza tra il pilastro B e il pilastro di fronte a A, e cos\u00ec via. Inserisci questi parametri in Klipper: DELTA_ANALYZE OUTER_DISTS=<a_to_far_c>,<far_c_to_b>,<b_to_far_a>,<far_a_to_c>,<c_to_far_b>,<far_b_to_a> A questo punto va bene rimuovere l'oggetto dal letto. Le misure finali sono dei pilastri stessi. Misurare la dimensione del pilastro centrale lungo il raggio A, poi il raggio B e poi il raggio C. Inseriscili in Klipper: DELTA_ANALYZE CENTER_PILLAR_WIDTHS=<a>,<b>,<c> Le misure finali sono dei pilastri esterni. Inizia misurando la distanza del pilastro A lungo la linea da A al pilastro di fronte a C. Quindi andare in senso antiorario e misurare i restanti pilastri esterni (pilastro di fronte a C lungo la linea a B, pilastro B lungo la linea a pilastro di fronte ad A, ecc.). E inseriscili in Klipper: DELTA_ANALYZE OUTER_PILLAR_WIDTHS=<a>,<far_c>,<b>,<far_a>,<c>,<far_b> Se l'oggetto \u00e8 stato ridimensionato a una dimensione inferiore o superiore, fornire il fattore di scala utilizzato durante il taglio dell'oggetto: DELTA_ANALYZE SCALE=1.0 (Un valore di scala di 2,0 significherebbe che l'oggetto \u00e8 il doppio della sua dimensione originale, 0,5 sarebbe la met\u00e0 della sua dimensione originale.) Infine, esegui la calibrazione delta avanzata eseguendo: DELTA_ANALYZE CALIBRATE=extended Il completamento di questo comando pu\u00f2 richiedere diversi minuti. Dopo il completamento, calcoler\u00e0 i parametri delta aggiornati (raggio delta, angoli della torre, posizioni dei finecorsa e lunghezze dei bracci). Utilizzare il comando SAVE_CONFIG per salvare e applicare le impostazioni: SAVE_CONFIG Il comando SAVE_CONFIG salver\u00e0 sia i parametri delta aggiornati che le informazioni dalle misurazioni della distanza. Anche i futuri comandi DELTA_CALIBRATE utilizzeranno queste informazioni sulla distanza. Non tentare di reinserire le misurazioni grezze della distanza dopo aver eseguito SAVE_CONFIG, poich\u00e9 questo comando modifica la configurazione della stampante e le misurazioni grezze non vengono pi\u00f9 applicate.","title":"Calibrazione delta migliorata"},{"location":"Delta_Calibrate.html#note-aggiuntive","text":"Se la stampante delta ha una buona precisione dimensionale, la distanza tra due pilastri qualsiasi dovrebbe essere di circa 74 mm e la larghezza di ogni pilastro dovrebbe essere di circa 9 mm. (In particolare, l'obiettivo \u00e8 che la distanza tra due pilastri qualsiasi meno la larghezza di uno dei pilastri sia esattamente 65 mm.) In caso di imprecisione dimensionale nella parte, la routine DELTA_ANALYZE calcoler\u00e0 nuovi parametri delta utilizzando entrambe le misurazioni della distanza e le misurazioni dell'altezza precedenti dall'ultimo comando DELTA_CALIBRATE. DELTA_ANALYZE pu\u00f2 produrre parametri delta sorprendenti. Ad esempio, pu\u00f2 suggerire lunghezze dei bracci che non corrispondono alle lunghezze effettive dei bracci della stampante. Nonostante ci\u00f2, i test hanno dimostrato che DELTA_ANALYZE produce spesso risultati superiori. Si ritiene che i parametri delta calcolati siano in grado di tenere conto di lievi errori in altre parti dell'hardware. Ad esempio, piccole differenze nella lunghezza del braccio possono comportare un'inclinazione dell'effettore e parte di tale inclinazione pu\u00f2 essere spiegata regolando i parametri della lunghezza del braccio.","title":"Note aggiuntive"},{"location":"Delta_Calibrate.html#utilizzo-della-mesh-del-piatto-su-un-delta","text":"\u00c8 possibile utilizzare bed mesh su un delta. Tuttavia, \u00e8 importante ottenere una buona calibrazione delta prima di abilitare una mesh del letto. L'esecuzione della mesh del letto con una scarsa calibrazione delta comporter\u00e0 risultati confusi e scarsi. Si noti che l'esecuzione della calibrazione delta invalider\u00e0 qualsiasi mesh del piatto precedentemente ottenuto. Dopo aver eseguito una nuova calibrazione delta, assicurati di eseguire nuovamente BED_MESH_CALIBRATE.","title":"Utilizzo della mesh del piatto su un delta"},{"location":"Endstop_Phase.html","text":"Fase di fine corsa \u00b6 Questo documento descrive il sistema di finecorsa di Klipper regolato sulla fase degli stepper. Questa funzionalit\u00e0 pu\u00f2 migliorare la precisione degli interruttori di fine corsa tradizionali. \u00c8 particolarmente utile quando si utilizza un driver per motori passo-passo Trinamic con configurazione runtime. Un tipico interruttore di fine corsa ha una precisione di circa 100 micron. (Ogni volta l'interruttore pu\u00f2 attivarsi leggermente prima o leggermente dopo.) Sebbene si tratti di un errore relativamente piccolo, pu\u00f2 causare artefatti indesiderati. In particolare, questa deviazione di posizione pu\u00f2 essere evidente quando si stampa il primo strato di un oggetto. Al contrario, i tipici motori passo-passo possono ottenere una precisione significativamente maggiore. Il meccanismo di fine corsa con regolazione della fase pu\u00f2 utilizzare la precisione dei motori passo-passo per migliorare la precisione degli interruttori di fine corsa. Un motore passo-passo si muove ciclicamente attraverso una serie di fasi fino a completare quattro \"passi completi\". Quindi, un motore passo-passo che utilizza 16 micro-passi avrebbe 64 fasi e quando si muove in direzione positiva passerebbe in rassegna le fasi: 0, 1, 2, ... 61, 62, 63, 0, 1, 2, ecc. Fondamentalmente, quando il motore passo-passo si trova in una posizione particolare su una guida lineare, dovrebbe essere sempre nella stessa fase passo-passo. Pertanto, quando un carrello fa scattare l'interruttore di fine corsa, lo stepper che controlla quel carrello dovrebbe essere sempre nella stessa fase del motore passo-passo. Il sistema di fase finecorsa di Klipper combina la fase del motore con l'attivazione del finecorsa per migliorare la precisione. Per utilizzare questa funzionalit\u00e0 \u00e8 necessario essere in grado di identificare la fase del motore passo-passo. Se si utilizzano i driver Trinamic TMC2130, TMC2208, TMC2224 o TMC2660 in modalit\u00e0 di configurazione runtime (cio\u00e8 non in modalit\u00e0 stand-alone), Klipper pu\u00f2 interrogare la fase stepper dal driver. (\u00c8 anche possibile utilizzare questo sistema su driver stepper tradizionali se \u00e8 possibile ripristinare in modo affidabile i driver stepper - vedere sotto per i dettagli.) Taratura fasi dei finecorsa \u00b6 Se si utilizzano driver Trinamic per motori passo-passo in configurazione runtime, \u00e8 possibile calibrare le fasi di fine corsa utilizzando il comando ENDSTOP_PHASE_CALIBRATE. Inizia aggiungendo quanto segue al file di configurazione: [endstop_phase] Quindi RIAVVIARE la stampante ed eseguire un comando G28 seguito da un comando ENDSTOP_PHASE_CALIBRATE . Quindi spostare la testina in una nuova posizione ed eseguire nuovamente G28 . Prova a spostare la testina in diverse posizioni ed esegui nuovamente G28 da ciascuna posizione. Esegui almeno cinque comandi G28 . Dopo aver eseguito quanto sopra, il comando ENDSTOP_PHASE_CALIBRATE riporter\u00e0 spesso la stessa (o quasi) fase per lo stepper. Questa fase pu\u00f2 essere salvata nel file di configurazione in modo che tutti i futuri comandi G28 utilizzino quella fase. (Quindi, nelle future operazioni di homing, Klipper otterr\u00e0 la stessa posizione anche se il finecorsa si attiva un po' prima o un po' dopo.) Per salvare la fase di fine corsa per un particolare motore passo-passo, eseguire qualcosa di simile a: ENDSTOP_PHASE_CALIBRATE STEPPER=stepper_z Esegui quanto sopra per tutti gli stepper che desideri salvare. Tipicamente, si usa questo su stepper_z per stampanti cartesiane e corexy e per stepper_a, stepper_b e stepper_c su stampanti delta. Infine, eseguire quanto segue per aggiornare il file di configurazione con i dati: SAVE_CONFIG Note aggiuntive \u00b6 Questa funzione \u00e8 particolarmente utile sulle stampanti delta e sul fine corsa Z delle stampanti cartesiane/corexy. \u00c8 possibile utilizzare questa funzione sui fine corsa XY delle stampanti cartesiane, ma ci\u00f2 non \u00e8 particolarmente utile poich\u00e9 \u00e8 improbabile che un errore minore nella posizione dell'arresto X/Y influisca sulla qualit\u00e0 di stampa. Non \u00e8 valido utilizzare questa funzione sugli arresti XY delle stampanti corexy (poich\u00e9 la posizione XY non \u00e8 determinata da un singolo stepper sulla cinematica corexy). Non \u00e8 valido utilizzare questa funzione su una stampante che utilizza un fine corsa Z \"probe:z_virtual_endstop\" (poich\u00e9 la fase stepper \u00e8 stabile solo se il fine corsa si trova in una posizione statica su una guida). Dopo aver calibrato la fase del finecorsa, se il finecorsa viene successivamente spostato o regolato, sar\u00e0 necessario ricalibrarlo. Rimuovere i dati di calibrazione dal file di configurazione ed eseguire nuovamente i passaggi precedenti. Per utilizzare questo sistema, il finecorsa deve essere sufficientemente preciso da identificare la posizione dello stepper entro due \"passi completi\". Quindi, ad esempio, se uno stepper utilizza 16 micropassi con una distanza del passo di 0,005 mm, il finecorsa deve avere una precisione di almeno 0,160 mm. Se si ottengono messaggi di errore di tipo \"Finecorsa stepper_z non corretto\", potrebbero essere dovuti a un finecorsa che non \u00e8 sufficientemente accurato. Se la ricalibrazione non aiuta, disabilitare le regolazioni della fase finecorsa rimuovendole dal file di configurazione. Se si utilizza un tradizionale asse Z controllato da stepper (come su una stampante cartesiana o corexy) insieme alle tradizionali viti di livellamento del letto, \u00e8 anche possibile utilizzare questo sistema per fare in modo che ogni strato di stampa venga eseguito su un confine \"passo completo\" . Per abilitare questa funzione, assicurati che lo slicer del G-Code sia configurato con un'altezza del livello che sia un multiplo di un \"passo completo\", abilita manualmente l'opzione endstop_align_zero nella sezione di configurazione endstop_phase (vedi config reference per ulteriori dettagli), quindi livellare nuovamente le viti del piatto. \u00c8 possibile utilizzare questo sistema con driver per motori passo-passo tradizionali (non Trinamici). Tuttavia, per fare ci\u00f2 \u00e8 necessario assicurarsi che i driver del motore passo-passo vengano ripristinati ogni volta che viene ripristinato il microcontrollore. (Se i due vengono sempre ripristinati insieme, Klipper pu\u00f2 determinare la fase dello stepper tracciando il numero totale di passaggi che ha comandato allo stepper di muoversi.) Attualmente, l'unico modo per farlo in modo affidabile \u00e8 se sia il microcontrollore che il motore passo-passo i driver siano alimentati esclusivamente da USB e che l'alimentazione USB sia fornita da un host in esecuzione su un Raspberry Pi. In questa situazione \u00e8 possibile specificare una configurazione mcu con \"restart_method: rpi_usb\" - quell'opzione far\u00e0 in modo che il microcontrollore venga sempre ripristinato tramite un ripristino dell'alimentazione USB, il che farebbe in modo che sia il microcontrollore che i driver del motore passo-passo siano resettare insieme. Se si utilizza questo meccanismo, \u00e8 necessario configurare manualmente le sezioni di configurazione \"trigger_phase\" (consultare config reference per i dettagli).","title":"Fase di fine corsa"},{"location":"Endstop_Phase.html#fase-di-fine-corsa","text":"Questo documento descrive il sistema di finecorsa di Klipper regolato sulla fase degli stepper. Questa funzionalit\u00e0 pu\u00f2 migliorare la precisione degli interruttori di fine corsa tradizionali. \u00c8 particolarmente utile quando si utilizza un driver per motori passo-passo Trinamic con configurazione runtime. Un tipico interruttore di fine corsa ha una precisione di circa 100 micron. (Ogni volta l'interruttore pu\u00f2 attivarsi leggermente prima o leggermente dopo.) Sebbene si tratti di un errore relativamente piccolo, pu\u00f2 causare artefatti indesiderati. In particolare, questa deviazione di posizione pu\u00f2 essere evidente quando si stampa il primo strato di un oggetto. Al contrario, i tipici motori passo-passo possono ottenere una precisione significativamente maggiore. Il meccanismo di fine corsa con regolazione della fase pu\u00f2 utilizzare la precisione dei motori passo-passo per migliorare la precisione degli interruttori di fine corsa. Un motore passo-passo si muove ciclicamente attraverso una serie di fasi fino a completare quattro \"passi completi\". Quindi, un motore passo-passo che utilizza 16 micro-passi avrebbe 64 fasi e quando si muove in direzione positiva passerebbe in rassegna le fasi: 0, 1, 2, ... 61, 62, 63, 0, 1, 2, ecc. Fondamentalmente, quando il motore passo-passo si trova in una posizione particolare su una guida lineare, dovrebbe essere sempre nella stessa fase passo-passo. Pertanto, quando un carrello fa scattare l'interruttore di fine corsa, lo stepper che controlla quel carrello dovrebbe essere sempre nella stessa fase del motore passo-passo. Il sistema di fase finecorsa di Klipper combina la fase del motore con l'attivazione del finecorsa per migliorare la precisione. Per utilizzare questa funzionalit\u00e0 \u00e8 necessario essere in grado di identificare la fase del motore passo-passo. Se si utilizzano i driver Trinamic TMC2130, TMC2208, TMC2224 o TMC2660 in modalit\u00e0 di configurazione runtime (cio\u00e8 non in modalit\u00e0 stand-alone), Klipper pu\u00f2 interrogare la fase stepper dal driver. (\u00c8 anche possibile utilizzare questo sistema su driver stepper tradizionali se \u00e8 possibile ripristinare in modo affidabile i driver stepper - vedere sotto per i dettagli.)","title":"Fase di fine corsa"},{"location":"Endstop_Phase.html#taratura-fasi-dei-finecorsa","text":"Se si utilizzano driver Trinamic per motori passo-passo in configurazione runtime, \u00e8 possibile calibrare le fasi di fine corsa utilizzando il comando ENDSTOP_PHASE_CALIBRATE. Inizia aggiungendo quanto segue al file di configurazione: [endstop_phase] Quindi RIAVVIARE la stampante ed eseguire un comando G28 seguito da un comando ENDSTOP_PHASE_CALIBRATE . Quindi spostare la testina in una nuova posizione ed eseguire nuovamente G28 . Prova a spostare la testina in diverse posizioni ed esegui nuovamente G28 da ciascuna posizione. Esegui almeno cinque comandi G28 . Dopo aver eseguito quanto sopra, il comando ENDSTOP_PHASE_CALIBRATE riporter\u00e0 spesso la stessa (o quasi) fase per lo stepper. Questa fase pu\u00f2 essere salvata nel file di configurazione in modo che tutti i futuri comandi G28 utilizzino quella fase. (Quindi, nelle future operazioni di homing, Klipper otterr\u00e0 la stessa posizione anche se il finecorsa si attiva un po' prima o un po' dopo.) Per salvare la fase di fine corsa per un particolare motore passo-passo, eseguire qualcosa di simile a: ENDSTOP_PHASE_CALIBRATE STEPPER=stepper_z Esegui quanto sopra per tutti gli stepper che desideri salvare. Tipicamente, si usa questo su stepper_z per stampanti cartesiane e corexy e per stepper_a, stepper_b e stepper_c su stampanti delta. Infine, eseguire quanto segue per aggiornare il file di configurazione con i dati: SAVE_CONFIG","title":"Taratura fasi dei finecorsa"},{"location":"Endstop_Phase.html#note-aggiuntive","text":"Questa funzione \u00e8 particolarmente utile sulle stampanti delta e sul fine corsa Z delle stampanti cartesiane/corexy. \u00c8 possibile utilizzare questa funzione sui fine corsa XY delle stampanti cartesiane, ma ci\u00f2 non \u00e8 particolarmente utile poich\u00e9 \u00e8 improbabile che un errore minore nella posizione dell'arresto X/Y influisca sulla qualit\u00e0 di stampa. Non \u00e8 valido utilizzare questa funzione sugli arresti XY delle stampanti corexy (poich\u00e9 la posizione XY non \u00e8 determinata da un singolo stepper sulla cinematica corexy). Non \u00e8 valido utilizzare questa funzione su una stampante che utilizza un fine corsa Z \"probe:z_virtual_endstop\" (poich\u00e9 la fase stepper \u00e8 stabile solo se il fine corsa si trova in una posizione statica su una guida). Dopo aver calibrato la fase del finecorsa, se il finecorsa viene successivamente spostato o regolato, sar\u00e0 necessario ricalibrarlo. Rimuovere i dati di calibrazione dal file di configurazione ed eseguire nuovamente i passaggi precedenti. Per utilizzare questo sistema, il finecorsa deve essere sufficientemente preciso da identificare la posizione dello stepper entro due \"passi completi\". Quindi, ad esempio, se uno stepper utilizza 16 micropassi con una distanza del passo di 0,005 mm, il finecorsa deve avere una precisione di almeno 0,160 mm. Se si ottengono messaggi di errore di tipo \"Finecorsa stepper_z non corretto\", potrebbero essere dovuti a un finecorsa che non \u00e8 sufficientemente accurato. Se la ricalibrazione non aiuta, disabilitare le regolazioni della fase finecorsa rimuovendole dal file di configurazione. Se si utilizza un tradizionale asse Z controllato da stepper (come su una stampante cartesiana o corexy) insieme alle tradizionali viti di livellamento del letto, \u00e8 anche possibile utilizzare questo sistema per fare in modo che ogni strato di stampa venga eseguito su un confine \"passo completo\" . Per abilitare questa funzione, assicurati che lo slicer del G-Code sia configurato con un'altezza del livello che sia un multiplo di un \"passo completo\", abilita manualmente l'opzione endstop_align_zero nella sezione di configurazione endstop_phase (vedi config reference per ulteriori dettagli), quindi livellare nuovamente le viti del piatto. \u00c8 possibile utilizzare questo sistema con driver per motori passo-passo tradizionali (non Trinamici). Tuttavia, per fare ci\u00f2 \u00e8 necessario assicurarsi che i driver del motore passo-passo vengano ripristinati ogni volta che viene ripristinato il microcontrollore. (Se i due vengono sempre ripristinati insieme, Klipper pu\u00f2 determinare la fase dello stepper tracciando il numero totale di passaggi che ha comandato allo stepper di muoversi.) Attualmente, l'unico modo per farlo in modo affidabile \u00e8 se sia il microcontrollore che il motore passo-passo i driver siano alimentati esclusivamente da USB e che l'alimentazione USB sia fornita da un host in esecuzione su un Raspberry Pi. In questa situazione \u00e8 possibile specificare una configurazione mcu con \"restart_method: rpi_usb\" - quell'opzione far\u00e0 in modo che il microcontrollore venga sempre ripristinato tramite un ripristino dell'alimentazione USB, il che farebbe in modo che sia il microcontrollore che i driver del motore passo-passo siano resettare insieme. Se si utilizza questo meccanismo, \u00e8 necessario configurare manualmente le sezioni di configurazione \"trigger_phase\" (consultare config reference per i dettagli).","title":"Note aggiuntive"},{"location":"Example_Configs.html","text":"Esempi di configurazioni \u00b6 Questo documento contiene le linee guida per contribuire a creare un esempio di configurazione di Klipper nella repository github di Klipper (situato nella directory config ). Nota che il server Klipper Community Discourse \u00e8 anche una risorsa utile per trovare e condividere file di configurazione. Linee guida \u00b6 Seleziona il prefisso del nome del file di configurazione appropriato: Il prefisso printer viene utilizzato per le stampanti stock vendute da un produttore tradizionale. Il prefisso generic viene utilizzato per una scheda per stampante 3d che pu\u00f2 essere utilizzata in molti diversi tipi di stampanti. Il prefisso kit \u00e8 per le stampanti 3d assemblate secondo una specifica ampiamente utilizzata. Queste stampanti \"kit\" sono generalmente distinte dalle normali \"stampanti\" in quanto non sono vendute da un produttore. Il prefisso sample viene utilizzato per i \"ritagli\" di configurazione che \u00e8 possibile copiare e incollare nel file di configurazione principale. Il prefisso example viene utilizzato per descrivere la cinematica della stampante. Questo tipo di configurazione viene in genere aggiunto solo insieme al codice per un nuovo tipo di cinematica della stampante. Tutti i file di configurazione devono terminare con un suffisso .cfg . I file di configurazione della stampante devono terminare con un anno seguito da .cfg (ad es. -2019.cfg ). In questo caso, l'anno \u00e8 un anno approssimativo in cui \u00e8 stata venduta la stampante specificata. Non utilizzare spazi o caratteri speciali nel nome del file di configurazione. Il nome del file deve contenere solo i caratteri A-Z , a-z , 0-9 , - e . . Klipper deve essere in grado di avviare il file di configurazione di esempio printer , generic e kit senza errori. Questi file di configurazione devono essere aggiunti al test di regressione test/klippy/printers.test . Aggiungi nuovi file di configurazione a quel test case nella sezione appropriata e in ordine alfabetico all'interno di quella sezione. La configurazione di esempio dovrebbe essere per la configurazione \"stock\" della stampante. (Ci sono troppe configurazioni \"personalizzate\" da tenere traccia nel repository principale di Klipper.) Allo stesso modo, aggiungiamo solo file di configurazione di esempio per stampanti, kit e schede che hanno la popolarit\u00e0 principale (ad esempio, dovrebbero essercene almeno 100 in uso attivo). Prendi in considerazione l'utilizzo del server Klipper Community Discourse per altre configurazioni. Only specify those devices present on the given printer or board. Do not specify settings specific to your particular setup. For generic config files, only those devices on the mainboard should be described. For example, it would not make sense to add a display config section to a \"generic\" config as there is no way to know if the board will be attached to that type of display. If the board has a specific hardware port to facilitate an optional peripheral (eg, a bltouch port) then one can add a \"commented out\" config section for the given device. Non specificare pressure_advance in una configurazione di esempio, poich\u00e9 quel valore \u00e8 specifico del filamento, non dell'hardware della stampante. Allo stesso modo, non specificare le impostazioni max_extrude_only_velocity n\u00e9 max_extrude_only_accel . Non specificare una sezione di configurazione contenente un percorso host o hardware host. Ad esempio, non specificare le sezioni di configurazione [virtual_sdcard] n\u00e9 [temperature_host] . Definire solo le macro che utilizzano funzionalit\u00e0 specifiche per la stampante specificata o per definire i G-code comunemente emessi dagli slicer configurati per la stampante specificata. Where possible, it is best to use the same wording, phrasing, indentation, and section ordering as the existing config files. The top of each config file should list the type of micro-controller the user should select during \"make menuconfig\". It should also have a reference to \"docs/Config_Reference.md\". Non copiare la documentazione sul campo nei file di configurazione di esempio. (In questo modo si crea un onere di manutenzione poich\u00e9 un aggiornamento della documentazione richiederebbe quindi la modifica in molti punti.) I file di configurazione di esempio non devono contenere una sezione \"SAVE_CONFIG\". Se necessario, copiare i campi rilevanti dalla sezione SAVE_CONFIG alla sezione appropriata nell'area di configurazione principale. Usa la sintassi field: value invece di field=value . Quando si aggiunge la rotation_distance a un estrusore \u00e8 preferibile specificare un gear_ratio se l'estrusore ha un meccanismo di ingranaggi. Ci aspettiamo che la rotation_distance nelle configurazioni di esempio sia correlata alla circonferenza dell'ingranaggio nell'estrusore: normalmente \u00e8 nell'intervallo da 20 a 35 mm. Quando si specifica un gear_ratio \u00e8 preferibile specificare gli ingranaggi effettivi sul meccanismo (ad esempio, preferire gear_ratio: 80:20 su gear_ratio: 4:1 ). Per ulteriori informazioni, vedere il documento sulla distanza di rotazione . Evitare di definire valori di campo impostati sul valore predefinito. Ad esempio, non si dovrebbe specificare min_extrude_temp: 170 poich\u00e9 questo \u00e8 gi\u00e0 il valore predefinito. Ove possibile, le righe non devono superare le 80 colonne. Evita di aggiungere messaggi di attribuzione o revisione ai file di configurazione. (Ad esempio, evita di aggiungere righe come \"questo file \u00e8 stato creato da...\".) Inserisci l'attribuzione e cambia la cronologia nel messaggio di commit git. Non utilizzare alcuna funzionalit\u00e0 deprecata nel file di configurazione di esempio. Non disabilitare un sistema di sicurezza predefinito in un file di configurazione di esempio. Ad esempio, una configurazione non dovrebbe specificare una max_extrude_cross_section personalizzata. Non abilitare le funzionalit\u00e0 di debug. Ad esempio, non dovrebbe esserci una sezione di configurazione force_move . Tutte le schede note supportate da Klipper possono utilizzare la velocit\u00e0 di trasmissione seriale predefinita di 250000. Non consigliare una velocit\u00e0 di trasmissione diversa in un file di configurazione di esempio. I file di configurazione di esempio vengono inviati creando una \"richiesta pull\" di github. Si prega di seguire anche le indicazioni nel documento per contributi .","title":"Esempi di configurazioni"},{"location":"Example_Configs.html#esempi-di-configurazioni","text":"Questo documento contiene le linee guida per contribuire a creare un esempio di configurazione di Klipper nella repository github di Klipper (situato nella directory config ). Nota che il server Klipper Community Discourse \u00e8 anche una risorsa utile per trovare e condividere file di configurazione.","title":"Esempi di configurazioni"},{"location":"Example_Configs.html#linee-guida","text":"Seleziona il prefisso del nome del file di configurazione appropriato: Il prefisso printer viene utilizzato per le stampanti stock vendute da un produttore tradizionale. Il prefisso generic viene utilizzato per una scheda per stampante 3d che pu\u00f2 essere utilizzata in molti diversi tipi di stampanti. Il prefisso kit \u00e8 per le stampanti 3d assemblate secondo una specifica ampiamente utilizzata. Queste stampanti \"kit\" sono generalmente distinte dalle normali \"stampanti\" in quanto non sono vendute da un produttore. Il prefisso sample viene utilizzato per i \"ritagli\" di configurazione che \u00e8 possibile copiare e incollare nel file di configurazione principale. Il prefisso example viene utilizzato per descrivere la cinematica della stampante. Questo tipo di configurazione viene in genere aggiunto solo insieme al codice per un nuovo tipo di cinematica della stampante. Tutti i file di configurazione devono terminare con un suffisso .cfg . I file di configurazione della stampante devono terminare con un anno seguito da .cfg (ad es. -2019.cfg ). In questo caso, l'anno \u00e8 un anno approssimativo in cui \u00e8 stata venduta la stampante specificata. Non utilizzare spazi o caratteri speciali nel nome del file di configurazione. Il nome del file deve contenere solo i caratteri A-Z , a-z , 0-9 , - e . . Klipper deve essere in grado di avviare il file di configurazione di esempio printer , generic e kit senza errori. Questi file di configurazione devono essere aggiunti al test di regressione test/klippy/printers.test . Aggiungi nuovi file di configurazione a quel test case nella sezione appropriata e in ordine alfabetico all'interno di quella sezione. La configurazione di esempio dovrebbe essere per la configurazione \"stock\" della stampante. (Ci sono troppe configurazioni \"personalizzate\" da tenere traccia nel repository principale di Klipper.) Allo stesso modo, aggiungiamo solo file di configurazione di esempio per stampanti, kit e schede che hanno la popolarit\u00e0 principale (ad esempio, dovrebbero essercene almeno 100 in uso attivo). Prendi in considerazione l'utilizzo del server Klipper Community Discourse per altre configurazioni. Only specify those devices present on the given printer or board. Do not specify settings specific to your particular setup. For generic config files, only those devices on the mainboard should be described. For example, it would not make sense to add a display config section to a \"generic\" config as there is no way to know if the board will be attached to that type of display. If the board has a specific hardware port to facilitate an optional peripheral (eg, a bltouch port) then one can add a \"commented out\" config section for the given device. Non specificare pressure_advance in una configurazione di esempio, poich\u00e9 quel valore \u00e8 specifico del filamento, non dell'hardware della stampante. Allo stesso modo, non specificare le impostazioni max_extrude_only_velocity n\u00e9 max_extrude_only_accel . Non specificare una sezione di configurazione contenente un percorso host o hardware host. Ad esempio, non specificare le sezioni di configurazione [virtual_sdcard] n\u00e9 [temperature_host] . Definire solo le macro che utilizzano funzionalit\u00e0 specifiche per la stampante specificata o per definire i G-code comunemente emessi dagli slicer configurati per la stampante specificata. Where possible, it is best to use the same wording, phrasing, indentation, and section ordering as the existing config files. The top of each config file should list the type of micro-controller the user should select during \"make menuconfig\". It should also have a reference to \"docs/Config_Reference.md\". Non copiare la documentazione sul campo nei file di configurazione di esempio. (In questo modo si crea un onere di manutenzione poich\u00e9 un aggiornamento della documentazione richiederebbe quindi la modifica in molti punti.) I file di configurazione di esempio non devono contenere una sezione \"SAVE_CONFIG\". Se necessario, copiare i campi rilevanti dalla sezione SAVE_CONFIG alla sezione appropriata nell'area di configurazione principale. Usa la sintassi field: value invece di field=value . Quando si aggiunge la rotation_distance a un estrusore \u00e8 preferibile specificare un gear_ratio se l'estrusore ha un meccanismo di ingranaggi. Ci aspettiamo che la rotation_distance nelle configurazioni di esempio sia correlata alla circonferenza dell'ingranaggio nell'estrusore: normalmente \u00e8 nell'intervallo da 20 a 35 mm. Quando si specifica un gear_ratio \u00e8 preferibile specificare gli ingranaggi effettivi sul meccanismo (ad esempio, preferire gear_ratio: 80:20 su gear_ratio: 4:1 ). Per ulteriori informazioni, vedere il documento sulla distanza di rotazione . Evitare di definire valori di campo impostati sul valore predefinito. Ad esempio, non si dovrebbe specificare min_extrude_temp: 170 poich\u00e9 questo \u00e8 gi\u00e0 il valore predefinito. Ove possibile, le righe non devono superare le 80 colonne. Evita di aggiungere messaggi di attribuzione o revisione ai file di configurazione. (Ad esempio, evita di aggiungere righe come \"questo file \u00e8 stato creato da...\".) Inserisci l'attribuzione e cambia la cronologia nel messaggio di commit git. Non utilizzare alcuna funzionalit\u00e0 deprecata nel file di configurazione di esempio. Non disabilitare un sistema di sicurezza predefinito in un file di configurazione di esempio. Ad esempio, una configurazione non dovrebbe specificare una max_extrude_cross_section personalizzata. Non abilitare le funzionalit\u00e0 di debug. Ad esempio, non dovrebbe esserci una sezione di configurazione force_move . Tutte le schede note supportate da Klipper possono utilizzare la velocit\u00e0 di trasmissione seriale predefinita di 250000. Non consigliare una velocit\u00e0 di trasmissione diversa in un file di configurazione di esempio. I file di configurazione di esempio vengono inviati creando una \"richiesta pull\" di github. Si prega di seguire anche le indicazioni nel documento per contributi .","title":"Linee guida"},{"location":"Exclude_Object.html","text":"Escludi oggetti \u00b6 The [exclude_object] module allows Klipper to exclude objects while a print is in progress. To enable this feature include an exclude_object config section (also see the command reference and sample-macros.cfg file for a Marlin/RepRapFirmware compatible M486 G-Code macro.) A differenza di altre opzioni del firmware della stampante 3D, una stampante che esegue Klipper utilizza una suite di componenti e gli utenti hanno molte opzioni tra cui scegliere. Pertanto, al fine di fornire un'esperienza utente coerente, il modulo [exclude_object] stabilir\u00e0 un contratto o una sorta di API. Il contratto copre il contenuto del file gcode, come viene controllato lo stato interno del modulo e come tale stato viene fornito ai client. Panoramica del flusso di lavoro \u00b6 Un tipico flusso di lavoro per la stampa di un file potrebbe essere simile a: Lo slicing \u00e8 completato e il file viene caricato per la stampa. Durante il caricamento, il file viene elaborato e gli indicatori [exclude_object] vengono aggiunti al file. In alternativa, i filtri dei dati possono essere configurati per preparare i marcatori di esclusione degli oggetti in modo nativo o nella propria fase di pre-elaborazione. All'avvio della stampa, Klipper ripristiner\u00e0 [exclude_object] status . Quando Klipper elabora il blocco EXCLUDE_OBJECT_DEFINE , aggiorner\u00e0 lo stato con gli oggetti conosciuti e lo passer\u00e0 ai client. Il client pu\u00f2 utilizzare tali informazioni per presentare un'interfaccia all'utente in modo che sia possibile tenere traccia dei progressi. Klipper aggiorner\u00e0 lo stato per includere l'oggetto attualmente in stampa che il client pu\u00f2 utilizzare per scopi di visualizzazione. Se l'utente richiede la cancellazione di un oggetto, il client invier\u00e0 un comando EXCLUDE_OBJECT NAME=<nome> a Klipper. Quando Klipper elabora il comando, aggiunger\u00e0 l'oggetto all'elenco degli oggetti esclusi e aggiorner\u00e0 lo stato per i client. Il client ricever\u00e0 lo stato aggiornato da Klipper e potr\u00e0 utilizzare tali informazioni per aggiornare lo stato dell'oggetto nell'interfaccia utente. Al termine della stampa, lo stato [exclude_object] continuer\u00e0 a essere disponibile fino a quando un'altra azione non lo reimposta. Il file GCode \u00b6 L'elaborazione specializzata del gcode necessaria per supportare l'esclusione di oggetti non rientra negli obiettivi di progettazione principali di Klipper. Pertanto, questo modulo richiede che il file venga elaborato prima di essere inviato a Klipper per la stampa. L'utilizzo di uno script di post-elaborazione nello slicer o il middleware che elabora il file durante il caricamento sono due possibilit\u00e0 per preparare il file per Klipper. Uno script di post-elaborazione di riferimento \u00e8 disponibile sia come eseguibile che come libreria Python, vedere cancelobject-preprocessor . Definizioni di oggetti \u00b6 Il comando EXCLUDE_OBJECT_DEFINE viene utilizzato per fornire un riepilogo di ogni oggetto nel file gcode da stampare. Fornisce un riepilogo di un oggetto nel file. Gli oggetti non hanno bisogno di essere definiti per essere referenziati da altri comandi. Lo scopo principale di questo comando \u00e8 fornire informazioni all'interfaccia utente senza dover analizzare l'intero file gcode. Le definizioni degli oggetti sono denominate per consentire agli utenti di selezionare facilmente un oggetto da escludere e possono essere forniti metadati aggiuntivi per consentire la visualizzazione grafica dell'annullamento. I metadati attualmente definiti includono una coordinata X,Y \"CENTRO\" e un elenco \"POLYGON\" di punti X,Y che rappresentano un contorno minimo dell'oggetto. Potrebbe trattarsi di un semplice riquadro di delimitazione o di uno guscio complicato per mostrare visualizzazioni pi\u00f9 dettagliate degli oggetti stampati. Soprattutto quando i file gcode includono pi\u00f9 parti con regioni di delimitazione sovrapposte, i punti centrali diventano difficili da distinguere visivamente. POLYGONS deve essere un array compatibile con json di tuple punto [X,Y] senza spazi. Ulteriori parametri verranno salvati come stringhe nella definizione dell'oggetto e forniti negli aggiornamenti di stato. EXCLUDE_OBJECT_DEFINE NAME=calibration_pyramid CENTER=50,50 POLYGON=[[40,40],[50,60],[60,40]] All available G-Code commands are documented in the G-Code Reference Informazioni sullo stato \u00b6 The state of this module is provided to clients by the exclude_object status . Lo stato viene ripristinato quando: Il firmware di Klipper viene riavviato. C'\u00e8 un reset della [virtual_sdcard] . In particolare, questo viene ripristinato da Klipper all'inizio di una stampa. Quando viene emesso un comando EXCLUDE_OBJECT_DEFINE RESET=1 . L'elenco degli oggetti definiti \u00e8 rappresentato nel campo di stato exclude_object.objects . In un file gcode ben definito, questo sar\u00e0 fatto con i comandi EXCLUDE_OBJECT_DEFINE all'inizio del file. Ci\u00f2 fornir\u00e0 ai client i nomi e le coordinate degli oggetti in modo che l'interfaccia utente possa fornire una rappresentazione grafica degli oggetti, se lo si desidera. Man mano che la stampa procede, il campo di stato exclude_object.current_object verr\u00e0 aggiornato mentre Klipper elabora i comandi EXCLUDE_OBJECT_START e EXCLUDE_OBJECT_END . Il campo oggetto_corrente sar\u00e0 impostato anche se l'oggetto \u00e8 stato escluso. Gli oggetti non definiti contrassegnati con un EXCLUDE_OBJECT_START verranno aggiunti agli oggetti conosciuti per facilitare i suggerimenti dell'interfaccia utente, senza metadati aggiuntivi. Quando vengono emessi i comandi EXCLUDE_OBJECT , l'elenco degli oggetti esclusi viene fornito nell'array exclude_object.excluded_objects . Poich\u00e9 Klipper guarda avanti per elaborare il prossimo gcode, potrebbe esserci un ritardo tra l'emissione del comando e l'aggiornamento dello stato.","title":"Escludi oggetti"},{"location":"Exclude_Object.html#escludi-oggetti","text":"The [exclude_object] module allows Klipper to exclude objects while a print is in progress. To enable this feature include an exclude_object config section (also see the command reference and sample-macros.cfg file for a Marlin/RepRapFirmware compatible M486 G-Code macro.) A differenza di altre opzioni del firmware della stampante 3D, una stampante che esegue Klipper utilizza una suite di componenti e gli utenti hanno molte opzioni tra cui scegliere. Pertanto, al fine di fornire un'esperienza utente coerente, il modulo [exclude_object] stabilir\u00e0 un contratto o una sorta di API. Il contratto copre il contenuto del file gcode, come viene controllato lo stato interno del modulo e come tale stato viene fornito ai client.","title":"Escludi oggetti"},{"location":"Exclude_Object.html#panoramica-del-flusso-di-lavoro","text":"Un tipico flusso di lavoro per la stampa di un file potrebbe essere simile a: Lo slicing \u00e8 completato e il file viene caricato per la stampa. Durante il caricamento, il file viene elaborato e gli indicatori [exclude_object] vengono aggiunti al file. In alternativa, i filtri dei dati possono essere configurati per preparare i marcatori di esclusione degli oggetti in modo nativo o nella propria fase di pre-elaborazione. All'avvio della stampa, Klipper ripristiner\u00e0 [exclude_object] status . Quando Klipper elabora il blocco EXCLUDE_OBJECT_DEFINE , aggiorner\u00e0 lo stato con gli oggetti conosciuti e lo passer\u00e0 ai client. Il client pu\u00f2 utilizzare tali informazioni per presentare un'interfaccia all'utente in modo che sia possibile tenere traccia dei progressi. Klipper aggiorner\u00e0 lo stato per includere l'oggetto attualmente in stampa che il client pu\u00f2 utilizzare per scopi di visualizzazione. Se l'utente richiede la cancellazione di un oggetto, il client invier\u00e0 un comando EXCLUDE_OBJECT NAME=<nome> a Klipper. Quando Klipper elabora il comando, aggiunger\u00e0 l'oggetto all'elenco degli oggetti esclusi e aggiorner\u00e0 lo stato per i client. Il client ricever\u00e0 lo stato aggiornato da Klipper e potr\u00e0 utilizzare tali informazioni per aggiornare lo stato dell'oggetto nell'interfaccia utente. Al termine della stampa, lo stato [exclude_object] continuer\u00e0 a essere disponibile fino a quando un'altra azione non lo reimposta.","title":"Panoramica del flusso di lavoro"},{"location":"Exclude_Object.html#il-file-gcode","text":"L'elaborazione specializzata del gcode necessaria per supportare l'esclusione di oggetti non rientra negli obiettivi di progettazione principali di Klipper. Pertanto, questo modulo richiede che il file venga elaborato prima di essere inviato a Klipper per la stampa. L'utilizzo di uno script di post-elaborazione nello slicer o il middleware che elabora il file durante il caricamento sono due possibilit\u00e0 per preparare il file per Klipper. Uno script di post-elaborazione di riferimento \u00e8 disponibile sia come eseguibile che come libreria Python, vedere cancelobject-preprocessor .","title":"Il file GCode"},{"location":"Exclude_Object.html#definizioni-di-oggetti","text":"Il comando EXCLUDE_OBJECT_DEFINE viene utilizzato per fornire un riepilogo di ogni oggetto nel file gcode da stampare. Fornisce un riepilogo di un oggetto nel file. Gli oggetti non hanno bisogno di essere definiti per essere referenziati da altri comandi. Lo scopo principale di questo comando \u00e8 fornire informazioni all'interfaccia utente senza dover analizzare l'intero file gcode. Le definizioni degli oggetti sono denominate per consentire agli utenti di selezionare facilmente un oggetto da escludere e possono essere forniti metadati aggiuntivi per consentire la visualizzazione grafica dell'annullamento. I metadati attualmente definiti includono una coordinata X,Y \"CENTRO\" e un elenco \"POLYGON\" di punti X,Y che rappresentano un contorno minimo dell'oggetto. Potrebbe trattarsi di un semplice riquadro di delimitazione o di uno guscio complicato per mostrare visualizzazioni pi\u00f9 dettagliate degli oggetti stampati. Soprattutto quando i file gcode includono pi\u00f9 parti con regioni di delimitazione sovrapposte, i punti centrali diventano difficili da distinguere visivamente. POLYGONS deve essere un array compatibile con json di tuple punto [X,Y] senza spazi. Ulteriori parametri verranno salvati come stringhe nella definizione dell'oggetto e forniti negli aggiornamenti di stato. EXCLUDE_OBJECT_DEFINE NAME=calibration_pyramid CENTER=50,50 POLYGON=[[40,40],[50,60],[60,40]] All available G-Code commands are documented in the G-Code Reference","title":"Definizioni di oggetti"},{"location":"Exclude_Object.html#informazioni-sullo-stato","text":"The state of this module is provided to clients by the exclude_object status . Lo stato viene ripristinato quando: Il firmware di Klipper viene riavviato. C'\u00e8 un reset della [virtual_sdcard] . In particolare, questo viene ripristinato da Klipper all'inizio di una stampa. Quando viene emesso un comando EXCLUDE_OBJECT_DEFINE RESET=1 . L'elenco degli oggetti definiti \u00e8 rappresentato nel campo di stato exclude_object.objects . In un file gcode ben definito, questo sar\u00e0 fatto con i comandi EXCLUDE_OBJECT_DEFINE all'inizio del file. Ci\u00f2 fornir\u00e0 ai client i nomi e le coordinate degli oggetti in modo che l'interfaccia utente possa fornire una rappresentazione grafica degli oggetti, se lo si desidera. Man mano che la stampa procede, il campo di stato exclude_object.current_object verr\u00e0 aggiornato mentre Klipper elabora i comandi EXCLUDE_OBJECT_START e EXCLUDE_OBJECT_END . Il campo oggetto_corrente sar\u00e0 impostato anche se l'oggetto \u00e8 stato escluso. Gli oggetti non definiti contrassegnati con un EXCLUDE_OBJECT_START verranno aggiunti agli oggetti conosciuti per facilitare i suggerimenti dell'interfaccia utente, senza metadati aggiuntivi. Quando vengono emessi i comandi EXCLUDE_OBJECT , l'elenco degli oggetti esclusi viene fornito nell'array exclude_object.excluded_objects . Poich\u00e9 Klipper guarda avanti per elaborare il prossimo gcode, potrebbe esserci un ritardo tra l'emissione del comando e l'aggiornamento dello stato.","title":"Informazioni sullo stato"},{"location":"FAQ.html","text":"Domande frequenti \u00b6 Come posso donare al progetto? \u00b6 Grazie per il vostro sostegno. Per informazioni, vedere la Pagina degli sponsor . Come faccio a calcolare il parametro di configurazione rotation_distance? \u00b6 Vedere il rotation distance document . Dov'\u00e8 la mia porta seriale? \u00b6 Il modo generico per trovare una porta seriale USB \u00e8 eseguire ls /dev/serial/by-id/* da un terminale ssh sulla macchina host. Probabilmente produrr\u00e0 un output simile al seguente: /dev/serial/by-id/usb-1a86_USB2.0-Serial-if00-port0 Il nome trovato nel comando precedente \u00e8 stabile ed \u00e8 possibile utilizzarlo nel file di configurazione e durante il flashing del codice del microcontrollore. Ad esempio, un comando flash potrebbe essere simile a: sudo service klipper stop make flash FLASH_DEVICE=/dev/serial/by-id/usb-1a86_USB2.0-Serial-if00-port0 sudo service klipper start e la configurazione aggiornata potrebbe essere simile a: [mcu] serial: /dev/serial/by-id/usb-1a86_USB2.0-Serial-if00-port0 Assicurati di copiare e incollare il nome dal comando \"ls\" che hai eseguito sopra poich\u00e9 il nome sar\u00e0 diverso per ciascuna stampante. Se stai usando pi\u00f9 microcontrollori e non hanno ID univoci (comune sulle schede con un chip USB CH340), segui invece le indicazioni sopra usando il comando ls /dev/serial/by-path/* . Quando il microcontrollore si riavvia, il dispositivo cambia in /dev/ttyUSB1 \u00b6 egui le istruzioni nella sezione \" Where's my serial port? \" per evitare che ci\u00f2 accada. Il comando \"make flash\" non funziona \u00b6 Il codice tenta di eseguire il flashing del dispositivo utilizzando il metodo pi\u00f9 comune per ciascuna piattaforma. Sfortunatamente, c'\u00e8 molta variabilit\u00e0 nei metodi di flashing, quindi il comando \"make flash\" potrebbe non funzionare su tutte le schede. Se si verifica un errore intermittente o si dispone di una configurazione standard, ricontrolla che Klipper non sia in esecuzione durante il flashing (sudo service klipper stop), assicurati che OctoPrint non stia tentando di connettersi direttamente al dispositivo (apri il scheda Connessione nella pagina Web e fare clic su Disconnetti se la porta seriale \u00e8 impostata sul dispositivo) e assicurarsi che FLASH_DEVICE sia impostato correttamente per la scheda (consultare la question above . Tuttavia, se \"make flash\" non funziona per la tua scheda, dovrai eseguire il flashing manualmente. Verificare se nella config directory \u00e8 presente un file di configurazione con istruzioni specifiche per il flashing del dispositivo. Inoltre, controlla la documentazione del produttore della scheda per vedere se descrive come eseguire il flashing del dispositivo. Infine, potrebbe essere possibile eseguire manualmente il flashing del dispositivo utilizzando strumenti come \"avrdude\" o \"bossac\" - vedere il bootloader document per ulteriori informazioni. Come posso modificare la velocit\u00e0 di trasmissione seriale? \u00b6 Il baud rate consigliato per Klipper \u00e8 250000. Questo baud rate funziona bene su tutte le schede di microcontrollore supportate da Klipper. Se hai trovato una guida online che consiglia una velocit\u00e0 di trasmissione diversa, ignora quella parte della guida e continua con il valore predefinito di 250000. Se si desidera comunque modificare il baud rate, sar\u00e0 necessario configurare la nuova velocit\u00e0 nel microcontrollore (durante make menuconfig ) e il codice aggiornato dovr\u00e0 essere compilato e flashato sul microcontrollore. Anche il file Klipper printer.cfg dovr\u00e0 essere aggiornato in modo che corrisponda a tale velocit\u00e0 di trasmissione (consultare il config reference per i dettagli). Per esempio: [mcu] baud: 250000 La velocit\u00e0 di trasmissione mostrata sulla pagina Web di OctoPrint non ha alcun impatto sulla velocit\u00e0 di trasmissione interna del microcontrollore Klipper. Impostare sempre la velocit\u00e0 di trasmissione OctoPrint su 250000 quando si utilizza Klipper. La velocit\u00e0 in baud del microcontrollore Klipper non \u00e8 correlata alla velocit\u00e0 in baud del bootloader del microcontrollore. Vedere il bootloader document per ulteriori informazioni sui bootloader. Posso eseguire Klipper su qualcosa di diverso da un Raspberry Pi 3? \u00b6 L'hardware consigliato \u00e8 un Raspberry Pi 2, Raspberry Pi 3 o Raspberry Pi 4. Klipper funzioner\u00e0 su un Raspberry Pi 1 e su Raspberry Pi Zero, ma queste schede non hanno una potenza di elaborazione sufficiente per eseguire bene OctoPrint. \u00c8 normale che si verifichino interruzioni di stampa su queste macchine pi\u00f9 lente quando si stampa direttamente da OctoPrint. (La stampante potrebbe muoversi pi\u00f9 velocemente di quanto OctoPrint possa inviare comandi di movimento.) Se desideri comunque eseguire su una di queste schede pi\u00f9 lente, considera l'utilizzo della funzione \"virtual_sdcard\" durante la stampa (consulta config reference per dettagli). Per l'esecuzione su Beaglebone, vedere le Istruzioni di installazione specifiche di Beaglebone . Klipper \u00e8 stato eseguito su altre macchine. Il software host Klipper richiede solo Python in esecuzione su un computer Linux (o simile). Tuttavia, se desideri eseguirlo su una macchina diversa, avrai bisogno della conoscenza dell'amministratore Linux per installare i prerequisiti di sistema per quella particolare macchina. Consulta lo script install-octopi.sh per ulteriori informazioni sui passaggi necessari. Se stai cercando di eseguire il software host Klipper su un chip di fascia bassa, tieni presente che, come minimo, \u00e8 necessaria una macchina con hardware a \"virgola mobile a doppia precisione\". Se stai cercando di eseguire il software host Klipper su un desktop generico condiviso o una macchina di classe server, tieni presente che Klipper ha alcuni requisiti di scheduling in tempo reale. Se, durante una stampa, il computer host esegue anche un'intensa attivit\u00e0 di elaborazione generica (come deframmentazione di un disco rigido, rendering 3D, scambi pesanti e cos\u00ec via), Klipper potrebbe segnalare errori di stampa. Nota: se non stai utilizzando un'immagine OctoPi, tieni presente che diverse distribuzioni Linux abilitano un pacchetto \"ModemManager\" (o simile) che pu\u00f2 interrompere la comunicazione seriale. (Il che pu\u00f2 far s\u00ec che Klipper riporti errori apparentemente casuali \"Comunicazione persa con MCU\".) Se installi Klipper su una di queste distribuzioni potresti dover disabilitare quel pacchetto. Posso eseguire pi\u00f9 istanze di Klipper sulla stessa macchina host? \u00b6 \u00c8 possibile eseguire pi\u00f9 istanze del software host Klipper, ma per farlo \u00e8 necessaria la conoscenza dell'amministratore Linux. Gli script di installazione di Klipper determinano l'esecuzione del seguente comando Unix: ~/klippy-env/bin/python ~/klipper/klippy/klippy.py ~/printer.cfg -l /tmp/klippy.log \u00c8 possibile eseguire pi\u00f9 istanze del comando precedente purch\u00e9 ogni istanza abbia il proprio file di configurazione della stampante, il proprio file di registro e il proprio pseudo-tty. Per esempio: ~/klippy-env/bin/python ~/klipper/klippy/klippy.py ~/printer2.cfg -l /tmp/klippy2.log -I /tmp/printer2 Se scegli di farlo, dovrai implementare gli script di avvio, arresto e installazione necessari (se presenti). Lo script install-octopi.sh e lo script klipper-start.sh possono essere utili come esempi. Devo usare OctoPrint? \u00b6 Il software Klipper non dipende da OctoPrint. \u00c8 possibile utilizzare un software alternativo per inviare comandi a Klipper, ma ci\u00f2 richiede la conoscenza dell'amministratore Linux. Klipper crea una \"porta seriale virtuale\" tramite il file \"/tmp/printer\" ed emula una classica interfaccia seriale per stampante 3D tramite quel file. In generale, un software alternativo pu\u00f2 funzionare con Klipper purch\u00e9 possa essere configurato per utilizzare \"/tmp/printer\" per la porta seriale della stampante. Perch\u00e9 non riesco a spostare lo stepper prima di riposizionare la stampante? \u00b6 Il codice fa questo per ridurre la possibilit\u00e0 di comandare accidentalmente la testa nel piatto o altri limiti. Una volta che la stampante \u00e8 stata localizzata, il software tenta di verificare che ogni mossa rientri nella posizione_min/max definita nel file di configurazione. Se i motori sono disabilitati (tramite un comando M84 o M18), i motori dovranno essere nuovamente riposizionati prima del movimento. Se desideri spostare la testina dopo aver annullato una stampa tramite OctoPrint, considera di modificare la sequenza di annullamento di OctoPrint per farlo per te. \u00c8 configurato in OctoPrint tramite un browser web in: Impostazioni-> Script GCODE | Settings->GCODE Scripts Se desideri spostare la testina al termine di una stampa, considera di aggiungere il movimento desiderato alla sezione \"G-code personalizzato\" del tuo slicer. Se la stampante richiede un movimento aggiuntivo come parte del processo stesso di homing (o fondamentalmente non ha un processo di homing), considera l'utilizzo di una sezione safe_z_home o homing_override nel file di configurazione. Se \u00e8 necessario spostare uno stepper per scopi diagnostici o di debug, considerare l'aggiunta di una sezione force_move al file di configurazione. Vedere config reference per ulteriori dettagli su queste opzioni. Perch\u00e9 Z position_endstop \u00e8 impostato su 0.5 nelle configurazioni predefinite? \u00b6 Per le stampanti cartesiane Z position_endstop specifica la distanza dell'ugello dal piatto quando si attiva ilfinecorsa. Se possibile, si consiglia di utilizzare un finecorsa Z-max e di tornare a casa lontano dal piatto (in quanto ci\u00f2 riduce il rischio di collisioni con il piatto). Tuttavia, se ci si deve avvicinare al piatto, si consiglia di posizionare il finecorsa in modo che si attivi quando la bocchetta \u00e8 ancora a una piccola distanza dal piatto. In questo modo, durante l'homing dell'asse, si fermer\u00e0 prima che l'ugello tocchi il letto. Per ulteriori informazioni, vedere il bed level document . Ho convertito la mia configurazione da Marlin e gli assi X/Y funzionano bene, ma ottengo solo un rumore stridente durante homing dell'asse Z \u00b6 Risposta breve: in primo luogo, assicurati di aver verificato la configurazione dello stepper come descritto nel config check document . Se il problema persiste, provare a ridurre l'impostazione max_z_velocity nella configurazione della stampante. Risposta lunga: in pratica Marlin pu\u00f2 in genere fare solo un passo a una velocit\u00e0 di circa 10000 passi al secondo. Se gli viene richiesto di muoversi a una velocit\u00e0 che richiederebbe una velocit\u00e0 di passo pi\u00f9 alta, Marlin generalmente far\u00e0 un passo pi\u00f9 veloce possibile. Klipper \u00e8 in grado di raggiungere velocit\u00e0 di passo molto pi\u00f9 elevate, ma il motore passo-passo potrebbe non avere una coppia sufficiente per muoversi a una velocit\u00e0 pi\u00f9 elevata. Quindi, per un asse Z con un rapporto di trasmissione elevato o un'impostazione di micropassi elevata, l'effettiva velocit\u00e0 max_z_ottenibile potrebbe essere inferiore a quella configurata in Marlin. Il mio driver TMC del motore si spegne nel mezzo di una stampa \u00b6 Se si utilizza il driver TMC2208 (o TMC2224) in \"modalit\u00e0 standalone\", assicurarsi di utilizzare l' latest version of Klipper . Una soluzione alternativa per un problema del driver \"stealthchop\" TMC2208 \u00e8 stata aggiunta a Klipper a met\u00e0 marzo del 2020. Continuo a ricevere errori casuali \"Comunicazione persa con MCU\" |\"Lost communication with MCU\" \u00b6 Ci\u00f2 \u00e8 comunemente causato da errori hardware sulla connessione USB tra la macchina host e il microcontrollore. Cose da cercare: Utilizzare un cavo USB di buona qualit\u00e0 tra la macchina host e il microcontrollore. Assicurati che i connettori siano ben saldi. Se si utilizza un Raspberry Pi, utilizzare un alimentatore di buona qualit\u00e0 per il Raspberry Pi e utilizzare un cavo USB di buona qualit\u00e0 per collegare quell'alimentatore al Pi. Se ricevi avvisi di \"sottotensione\" da OctoPrint, questo \u00e8 correlato all'alimentatore e deve essere risolto. Assicurarsi che l'alimentazione della stampante non sia sovraccarica. (Le fluttuazioni di alimentazione del chip USB del microcontrollore possono comportare il reset di quel chip.) Verificare che i cavi dello stepper, del riscaldatore e di altri cavi della stampante non siano arricciati o sfilacciati. (Il movimento della stampante pu\u00f2 sollecitare un cavo difettoso causandone la perdita di contatto, un cortocircuito breve o la generazione di rumore eccessivo.) Sono stati segnalati rumori USB elevati quando sia l'alimentazione della stampante che l'alimentazione a 5 V dell'host sono mescolate. (Se si scopre che il microcontrollore si accende quando l'alimentazione della stampante \u00e8 accesa o il cavo USB \u00e8 collegato, significa che gli alimentatori da 5 V vengono mescolati.) Pu\u00f2 essere utile configurare il microcontrollore da utilizzare alimentazione da una sola fonte. (In alternativa, se la scheda del microcontrollore non \u00e8 in grado di configurare la sua fonte di alimentazione, \u00e8 possibile modificare un cavo USB in modo che non trasmetta alimentazione a 5V tra l'host e il microcontrollore.) Il mio Raspberry Pi continua a riavviarsi durante le stampe \u00b6 Questo \u00e8 molto probabilmente dovuto alle fluttuazioni di tensione. Segui gli stessi passaggi per la risoluzione dei problemi per un errore \"Comunicazione persa con MCU\" . Quando imposto restart_method=command il mio dispositivo AVR si blocca al riavvio \u00b6 Alcune vecchie versioni del bootloader AVR hanno un bug noto nella gestione degli eventi di watchdog. Questo in genere si manifesta quando il file printer.cfg ha restart_method impostato su \"command\". Quando si verifica il bug, il dispositivo AVR non risponder\u00e0 fino a quando l'alimentazione non viene rimossa e ricollegata al dispositivo (anche i LED di alimentazione o di stato potrebbero lampeggiare ripetutamente fino a quando l'alimentazione non viene rimossa). La soluzione alternativa \u00e8 utilizzare un restart_method diverso da \"command\" o eseguire il flashing di un bootloader aggiornato sul dispositivo AVR. Il flashing di un nuovo bootloader \u00e8 un passaggio che in genere richiede un programmatore esterno: vedere Bootloaders per ulteriori dettagli. I riscaldatori verranno lasciati accesi se il Raspberry Pi si arresta in modo anomalo? \u00b6 Il software \u00e8 stato progettato per impedirlo. Una volta che l'host abilita un riscaldatore, il software host deve confermare tale abilitazione ogni 5 secondi. Se il microcontrollore non riceve una conferma ogni 5 secondi, entra in uno stato di \"spegnimento\" progettato per spegnere tutti i riscaldatori e i motori passo-passo. Per ulteriori dettagli, vedere il comando \"config_digital_out\" nel documento Comandi MCU . Inoltre, il software del microcontrollore \u00e8 configurato con un intervallo di temperatura minimo e massimo per ciascun riscaldatore all'avvio (consultare i parametri min_temp e max_temp in config reference per i dettagli). Se il microcontrollore rileva che la temperatura \u00e8 al di fuori di tale intervallo, entrer\u00e0 anche in uno stato di \"spegnimento\". Separatamente, il software host implementa anche il codice per verificare che i riscaldatori e i sensori di temperatura funzionino correttamente. Vedere il riferimento di configurazione per ulteriori dettagli. Come posso convertire un numero di pin Marlin in un nome pin di Klipper? \u00b6 Risposta breve: una mappatura \u00e8 disponibile nel file sample-aliases.cfg . Usa quel file come guida per trovare i nomi effettivi dei pin del microcontrollorei. (\u00c8 anche possibile copiare la relativa sezione di configurazione board_pins nel file di configurazione e utilizzare gli alias nella configurazione, ma \u00e8 preferibile tradurre e utilizzare i nomi dei pin del microcontrollore effettivi.) Nota che il file sample-aliases.cfg usa nomi di pin che iniziano con il prefisso \"ar\" invece di \"D\" (ad esempio, il pin Arduino D23 \u00e8 alias Klipper ar23 ) e il prefisso \"analog\" invece di \"A \" (ad esempio, il pin Arduino A14 \u00e8 alias di Klipper analog14 ). Risposta lunga: Klipper utilizza i nomi dei pin standard definiti dal microcontrollore. Sui chip Atmega questi pin hardware hanno nomi come PA4 , PC7 o PD2 . Tempo fa, il progetto Arduino ha deciso di evitare di utilizzare i nomi hardware standard a favore dei propri nomi pin basati su numeri incrementali: questi nomi Arduino generalmente assomigliano a \"D23\" o \"A14\". Questa \u00e8 stata una scelta sfortunata che ha portato a una grande confusione. In particolare, i numeri dei pin di Arduino spesso non si traducono negli stessi nomi hardware. Ad esempio, D21 \u00e8 PD0 su una comune scheda Arduino, ma \u00e8 PC7 su un'altra comune scheda Arduino. Per evitare questa confusione, il codice di base di Klipper utilizza i nomi dei pin standard definiti dal microcontrollore. Devo collegare il mio dispositivo a un tipo specifico di pin del microcontrollore? \u00b6 Dipende dal tipo di dispositivo e dal tipo di pin: Pin ADC (o pin analogici): per termistori e sensori \"analogici\" simili, il dispositivo deve essere collegato a un pin compatibile con \"analogico\" o \"ADC\" sul microcontrollore. Se configuri Klipper per utilizzare un pin che non \u00e8 compatibile con l'analogico, Klipper segnaler\u00e0 un errore \"Non un pin ADC valido\". Pin PWM (o pin Timer): Klipper non utilizza PWM hardware per impostazione predefinita per nessun dispositivo. Quindi, in generale, \u00e8 possibile collegare riscaldatori, ventole e dispositivi simili a qualsiasi pin IO generico. Tuttavia, le ventole e i dispositivi output_pin possono essere opzionalmente configurati per utilizzare hardware_pwm: True , nel qual caso il microcontrollore deve supportare PWM hardware sul pin (altrimenti, Klipper segnaler\u00e0 un errore \"pin PWM non valido\"). Pin IRQ (o pin di interrupt): Klipper non utilizza gli interrupt hardware sui pin IO, quindi non \u00e8 mai necessario collegare un dispositivo a uno di questi pin del microcontrollore. Pin SPI: quando si utilizza l'SPI hardware, \u00e8 necessario collegare i pin ai pin SPI del microcontrollore. Tuttavia, la maggior parte dei dispositivi pu\u00f2 essere configurata per utilizzare \"SPI software\", nel qual caso \u00e8 possibile utilizzare qualsiasi pin IO generico. Pin I2C: quando si utilizza I2C \u00e8 necessario collegare i pin ai pin compatibili con I2C del microcontrollore. Altri dispositivi possono essere collegati a qualsiasi pin IO generico. Ad esempio, stepper, riscaldatori, ventole, sonde Z, servocomandi, LED, comuni display LCD hd44780/st7920, la linea di controllo Trinamic UART pu\u00f2 essere collegata a qualsiasi pin IO generico. Come posso annullare una richiesta di \"attesa temperatura\" M109/M190? \u00b6 Passare alla scheda del terminale OctoPrint ed emettere un comando M112 nel terminale. Il comando M112 far\u00e0 entrare Klipper in uno stato di \"arresto\" e causer\u00e0 la disconnessione di OctoPrint da Klipper. Passare all'area di connessione di OctoPrint e fare clic su \"Connetti\" per fare in modo che OctoPrint si riconnetta. Torna alla scheda del terminale ed emetti un comando FIRMWARE_RESTART per cancellare lo stato di errore di Klipper. Dopo aver completato questa sequenza, la precedente richiesta di riscaldamento verr\u00e0 annullata e potrebbe essere avviata una nuova stampa. Posso scoprire se la stampante ha perso dei passaggi? \u00b6 In un certo senso s\u00ec. Avviare la stampante, emettere un comando GET_POSITION , eseguire la stampa, tornare a casa ed emettere un altro GET_POSITION . Quindi confronta i valori nella riga mcu: . Questo potrebbe essere utile per regolare impostazioni come correnti, accelerazioni e velocit\u00e0 del motore passo-passo senza dover effettivamente stampare qualcosa e sprecare il filamento: basta eseguire alcuni movimenti ad alta velocit\u00e0 tra i comandi GET_POSITION . Si noti che gli stessi interruttori di fine corsa tendono a attivarsi in posizioni leggermente diverse, quindi una differenza di un paio di micropassi \u00e8 probabilmente il risultato di imprecisioni di fine corsa. Un motore passo-passo stesso pu\u00f2 perdere passi solo con incrementi di 4 passi completi. (Quindi, se si utilizzano 16 micropassi, un passo perso sullo stepper comporterebbe lo spegnimento del contatore di passi \"mcu:\" di un multiplo di 64 micropassi.) Perch\u00e9 Klipper segnala errori? Ho perso la mia stampa! \u00b6 Risposta breve: vogliamo sapere se le nostre stampanti rilevano un problema in modo che il problema sottostante possa essere risolto e possiamo ottenere stampe di ottima qualit\u00e0. Non vogliamo assolutamente che le nostre stampanti producano in silenzio stampe di bassa qualit\u00e0. Risposta lunga: Klipper \u00e8 stato progettato per risolvere automaticamente molti problemi transitori. Ad esempio, rileva automaticamente gli errori di comunicazione e li ritrasmette; pianifica le azioni in anticipo e bufferizza i comandi su pi\u00f9 livelli per consentire tempi precisi anche con interferenze intermittenti. Tuttavia, se il software rileva un errore dal quale non pu\u00f2 essere ripristinato, se gli viene ordinato di eseguire un'azione non valida o se rileva che \u00e8 irrimediabilmente incapace di eseguire l'attivit\u00e0 comandata, Klipper segnaler\u00e0 un errore. In queste situazioni c'\u00e8 un alto rischio di produrre una stampa di bassa qualit\u00e0 (o peggio). Si spera che avvisare gli utenti consentir\u00e0 loro di risolvere il problema sottostante e migliorare la qualit\u00e0 complessiva delle loro stampe. Ci sono alcune domande correlate: perch\u00e9 Klipper non mette invece in pausa la stampa? Segnalare invece un avviso? Verificare la presenza di errori prima della stampa? Ignorare gli errori nei comandi digitati dall'utente? eccetera? Attualmente Klipper legge i comandi utilizzando il protocollo G-Code e sfortunatamente il protocollo di comando G-Code non \u00e8 sufficientemente flessibile per rendere pratiche queste alternative oggi. C'\u00e8 l'interesse degli sviluppatori nel migliorare l'esperienza dell'utente durante eventi anomali, ma si prevede che ci\u00f2 richieder\u00e0 un notevole lavoro infrastrutturale (incluso un passaggio dal G-Code). Come si esegue l'aggiornamento al software pi\u00f9 recente? \u00b6 Il primo passaggio per l'aggiornamento del software consiste nell'esaminare l'ultimo documento config changes . A volte, vengono apportate modifiche al software che richiedono agli utenti di aggiornare le proprie impostazioni come parte di un aggiornamento del software. \u00c8 una buona idea rivedere questo documento prima dell'aggiornamento. Quando sei pronto per l'aggiornamento, il metodo generale \u00e8 quello di entrare in Raspberry Pi ed eseguire: cd ~/klipper git pull ~/klipper/scripts/install-octopi.sh Quindi si pu\u00f2 ricompilare e flashare il codice del microcontrollore. Per esempio: make menuconfig make clean make sudo service klipper stop make flash FLASH_DEVICE=/dev/ttyACM0 sudo service klipper start Tuttavia, capita spesso che cambi solo il software host. In questo caso \u00e8 possibile aggiornare e riavviare solo il software host con: cd ~/klipper git pull sudo service klipper restart Se dopo aver utilizzato questo collegamento il software avverte della necessit\u00e0 di eseguire il reflash del microcontrollore o si verifica qualche altro errore insolito, seguire i passaggi completi di aggiornamento descritti sopra. Se gli errori persistono, ricontrolla il documento config changes , poich\u00e9 potrebbe essere necessario modificare la configurazione della stampante. Si noti che i comandi g-code RESTART e FIRMWARE_RESTART non caricano il nuovo software: i comandi \"sudo service klipper restart\" e \"make flash\" di cui sopra sono necessari affinch\u00e9 una modifica del software abbia effetto. Come faccio a disinstallare Klipper? \u00b6 Dal alto del firmware, non deve succedere nulla di speciale. Basta seguire le indicazioni per il flashing del nuovo firmware. Dal lato del raspberry pi, uno script di disinstallazione \u00e8 disponibile in scripts/klipper-uninstall.sh . Per esempio: sudo ~/klipper/scripts/klipper-uninstall.sh rm -rf ~/klippy-env ~/klipper","title":"Domande frequenti"},{"location":"FAQ.html#domande-frequenti","text":"","title":"Domande frequenti"},{"location":"FAQ.html#come-posso-donare-al-progetto","text":"Grazie per il vostro sostegno. Per informazioni, vedere la Pagina degli sponsor .","title":"Come posso donare al progetto?"},{"location":"FAQ.html#come-faccio-a-calcolare-il-parametro-di-configurazione-rotation_distance","text":"Vedere il rotation distance document .","title":"Come faccio a calcolare il parametro di configurazione rotation_distance?"},{"location":"FAQ.html#dove-la-mia-porta-seriale","text":"Il modo generico per trovare una porta seriale USB \u00e8 eseguire ls /dev/serial/by-id/* da un terminale ssh sulla macchina host. Probabilmente produrr\u00e0 un output simile al seguente: /dev/serial/by-id/usb-1a86_USB2.0-Serial-if00-port0 Il nome trovato nel comando precedente \u00e8 stabile ed \u00e8 possibile utilizzarlo nel file di configurazione e durante il flashing del codice del microcontrollore. Ad esempio, un comando flash potrebbe essere simile a: sudo service klipper stop make flash FLASH_DEVICE=/dev/serial/by-id/usb-1a86_USB2.0-Serial-if00-port0 sudo service klipper start e la configurazione aggiornata potrebbe essere simile a: [mcu] serial: /dev/serial/by-id/usb-1a86_USB2.0-Serial-if00-port0 Assicurati di copiare e incollare il nome dal comando \"ls\" che hai eseguito sopra poich\u00e9 il nome sar\u00e0 diverso per ciascuna stampante. Se stai usando pi\u00f9 microcontrollori e non hanno ID univoci (comune sulle schede con un chip USB CH340), segui invece le indicazioni sopra usando il comando ls /dev/serial/by-path/* .","title":"Dov'\u00e8 la mia porta seriale?"},{"location":"FAQ.html#quando-il-microcontrollore-si-riavvia-il-dispositivo-cambia-in-devttyusb1","text":"egui le istruzioni nella sezione \" Where's my serial port? \" per evitare che ci\u00f2 accada.","title":"Quando il microcontrollore si riavvia, il dispositivo cambia in /dev/ttyUSB1"},{"location":"FAQ.html#il-comando-make-flash-non-funziona","text":"Il codice tenta di eseguire il flashing del dispositivo utilizzando il metodo pi\u00f9 comune per ciascuna piattaforma. Sfortunatamente, c'\u00e8 molta variabilit\u00e0 nei metodi di flashing, quindi il comando \"make flash\" potrebbe non funzionare su tutte le schede. Se si verifica un errore intermittente o si dispone di una configurazione standard, ricontrolla che Klipper non sia in esecuzione durante il flashing (sudo service klipper stop), assicurati che OctoPrint non stia tentando di connettersi direttamente al dispositivo (apri il scheda Connessione nella pagina Web e fare clic su Disconnetti se la porta seriale \u00e8 impostata sul dispositivo) e assicurarsi che FLASH_DEVICE sia impostato correttamente per la scheda (consultare la question above . Tuttavia, se \"make flash\" non funziona per la tua scheda, dovrai eseguire il flashing manualmente. Verificare se nella config directory \u00e8 presente un file di configurazione con istruzioni specifiche per il flashing del dispositivo. Inoltre, controlla la documentazione del produttore della scheda per vedere se descrive come eseguire il flashing del dispositivo. Infine, potrebbe essere possibile eseguire manualmente il flashing del dispositivo utilizzando strumenti come \"avrdude\" o \"bossac\" - vedere il bootloader document per ulteriori informazioni.","title":"Il comando \"make flash\" non funziona"},{"location":"FAQ.html#come-posso-modificare-la-velocita-di-trasmissione-seriale","text":"Il baud rate consigliato per Klipper \u00e8 250000. Questo baud rate funziona bene su tutte le schede di microcontrollore supportate da Klipper. Se hai trovato una guida online che consiglia una velocit\u00e0 di trasmissione diversa, ignora quella parte della guida e continua con il valore predefinito di 250000. Se si desidera comunque modificare il baud rate, sar\u00e0 necessario configurare la nuova velocit\u00e0 nel microcontrollore (durante make menuconfig ) e il codice aggiornato dovr\u00e0 essere compilato e flashato sul microcontrollore. Anche il file Klipper printer.cfg dovr\u00e0 essere aggiornato in modo che corrisponda a tale velocit\u00e0 di trasmissione (consultare il config reference per i dettagli). Per esempio: [mcu] baud: 250000 La velocit\u00e0 di trasmissione mostrata sulla pagina Web di OctoPrint non ha alcun impatto sulla velocit\u00e0 di trasmissione interna del microcontrollore Klipper. Impostare sempre la velocit\u00e0 di trasmissione OctoPrint su 250000 quando si utilizza Klipper. La velocit\u00e0 in baud del microcontrollore Klipper non \u00e8 correlata alla velocit\u00e0 in baud del bootloader del microcontrollore. Vedere il bootloader document per ulteriori informazioni sui bootloader.","title":"Come posso modificare la velocit\u00e0 di trasmissione seriale?"},{"location":"FAQ.html#posso-eseguire-klipper-su-qualcosa-di-diverso-da-un-raspberry-pi-3","text":"L'hardware consigliato \u00e8 un Raspberry Pi 2, Raspberry Pi 3 o Raspberry Pi 4. Klipper funzioner\u00e0 su un Raspberry Pi 1 e su Raspberry Pi Zero, ma queste schede non hanno una potenza di elaborazione sufficiente per eseguire bene OctoPrint. \u00c8 normale che si verifichino interruzioni di stampa su queste macchine pi\u00f9 lente quando si stampa direttamente da OctoPrint. (La stampante potrebbe muoversi pi\u00f9 velocemente di quanto OctoPrint possa inviare comandi di movimento.) Se desideri comunque eseguire su una di queste schede pi\u00f9 lente, considera l'utilizzo della funzione \"virtual_sdcard\" durante la stampa (consulta config reference per dettagli). Per l'esecuzione su Beaglebone, vedere le Istruzioni di installazione specifiche di Beaglebone . Klipper \u00e8 stato eseguito su altre macchine. Il software host Klipper richiede solo Python in esecuzione su un computer Linux (o simile). Tuttavia, se desideri eseguirlo su una macchina diversa, avrai bisogno della conoscenza dell'amministratore Linux per installare i prerequisiti di sistema per quella particolare macchina. Consulta lo script install-octopi.sh per ulteriori informazioni sui passaggi necessari. Se stai cercando di eseguire il software host Klipper su un chip di fascia bassa, tieni presente che, come minimo, \u00e8 necessaria una macchina con hardware a \"virgola mobile a doppia precisione\". Se stai cercando di eseguire il software host Klipper su un desktop generico condiviso o una macchina di classe server, tieni presente che Klipper ha alcuni requisiti di scheduling in tempo reale. Se, durante una stampa, il computer host esegue anche un'intensa attivit\u00e0 di elaborazione generica (come deframmentazione di un disco rigido, rendering 3D, scambi pesanti e cos\u00ec via), Klipper potrebbe segnalare errori di stampa. Nota: se non stai utilizzando un'immagine OctoPi, tieni presente che diverse distribuzioni Linux abilitano un pacchetto \"ModemManager\" (o simile) che pu\u00f2 interrompere la comunicazione seriale. (Il che pu\u00f2 far s\u00ec che Klipper riporti errori apparentemente casuali \"Comunicazione persa con MCU\".) Se installi Klipper su una di queste distribuzioni potresti dover disabilitare quel pacchetto.","title":"Posso eseguire Klipper su qualcosa di diverso da un Raspberry Pi 3?"},{"location":"FAQ.html#posso-eseguire-piu-istanze-di-klipper-sulla-stessa-macchina-host","text":"\u00c8 possibile eseguire pi\u00f9 istanze del software host Klipper, ma per farlo \u00e8 necessaria la conoscenza dell'amministratore Linux. Gli script di installazione di Klipper determinano l'esecuzione del seguente comando Unix: ~/klippy-env/bin/python ~/klipper/klippy/klippy.py ~/printer.cfg -l /tmp/klippy.log \u00c8 possibile eseguire pi\u00f9 istanze del comando precedente purch\u00e9 ogni istanza abbia il proprio file di configurazione della stampante, il proprio file di registro e il proprio pseudo-tty. Per esempio: ~/klippy-env/bin/python ~/klipper/klippy/klippy.py ~/printer2.cfg -l /tmp/klippy2.log -I /tmp/printer2 Se scegli di farlo, dovrai implementare gli script di avvio, arresto e installazione necessari (se presenti). Lo script install-octopi.sh e lo script klipper-start.sh possono essere utili come esempi.","title":"Posso eseguire pi\u00f9 istanze di Klipper sulla stessa macchina host?"},{"location":"FAQ.html#devo-usare-octoprint","text":"Il software Klipper non dipende da OctoPrint. \u00c8 possibile utilizzare un software alternativo per inviare comandi a Klipper, ma ci\u00f2 richiede la conoscenza dell'amministratore Linux. Klipper crea una \"porta seriale virtuale\" tramite il file \"/tmp/printer\" ed emula una classica interfaccia seriale per stampante 3D tramite quel file. In generale, un software alternativo pu\u00f2 funzionare con Klipper purch\u00e9 possa essere configurato per utilizzare \"/tmp/printer\" per la porta seriale della stampante.","title":"Devo usare OctoPrint?"},{"location":"FAQ.html#perche-non-riesco-a-spostare-lo-stepper-prima-di-riposizionare-la-stampante","text":"Il codice fa questo per ridurre la possibilit\u00e0 di comandare accidentalmente la testa nel piatto o altri limiti. Una volta che la stampante \u00e8 stata localizzata, il software tenta di verificare che ogni mossa rientri nella posizione_min/max definita nel file di configurazione. Se i motori sono disabilitati (tramite un comando M84 o M18), i motori dovranno essere nuovamente riposizionati prima del movimento. Se desideri spostare la testina dopo aver annullato una stampa tramite OctoPrint, considera di modificare la sequenza di annullamento di OctoPrint per farlo per te. \u00c8 configurato in OctoPrint tramite un browser web in: Impostazioni-> Script GCODE | Settings->GCODE Scripts Se desideri spostare la testina al termine di una stampa, considera di aggiungere il movimento desiderato alla sezione \"G-code personalizzato\" del tuo slicer. Se la stampante richiede un movimento aggiuntivo come parte del processo stesso di homing (o fondamentalmente non ha un processo di homing), considera l'utilizzo di una sezione safe_z_home o homing_override nel file di configurazione. Se \u00e8 necessario spostare uno stepper per scopi diagnostici o di debug, considerare l'aggiunta di una sezione force_move al file di configurazione. Vedere config reference per ulteriori dettagli su queste opzioni.","title":"Perch\u00e9 non riesco a spostare lo stepper prima di riposizionare la stampante?"},{"location":"FAQ.html#perche-z-position_endstop-e-impostato-su-05-nelle-configurazioni-predefinite","text":"Per le stampanti cartesiane Z position_endstop specifica la distanza dell'ugello dal piatto quando si attiva ilfinecorsa. Se possibile, si consiglia di utilizzare un finecorsa Z-max e di tornare a casa lontano dal piatto (in quanto ci\u00f2 riduce il rischio di collisioni con il piatto). Tuttavia, se ci si deve avvicinare al piatto, si consiglia di posizionare il finecorsa in modo che si attivi quando la bocchetta \u00e8 ancora a una piccola distanza dal piatto. In questo modo, durante l'homing dell'asse, si fermer\u00e0 prima che l'ugello tocchi il letto. Per ulteriori informazioni, vedere il bed level document .","title":"Perch\u00e9 Z position_endstop \u00e8 impostato su 0.5 nelle configurazioni predefinite?"},{"location":"FAQ.html#ho-convertito-la-mia-configurazione-da-marlin-e-gli-assi-xy-funzionano-bene-ma-ottengo-solo-un-rumore-stridente-durante-homing-dellasse-z","text":"Risposta breve: in primo luogo, assicurati di aver verificato la configurazione dello stepper come descritto nel config check document . Se il problema persiste, provare a ridurre l'impostazione max_z_velocity nella configurazione della stampante. Risposta lunga: in pratica Marlin pu\u00f2 in genere fare solo un passo a una velocit\u00e0 di circa 10000 passi al secondo. Se gli viene richiesto di muoversi a una velocit\u00e0 che richiederebbe una velocit\u00e0 di passo pi\u00f9 alta, Marlin generalmente far\u00e0 un passo pi\u00f9 veloce possibile. Klipper \u00e8 in grado di raggiungere velocit\u00e0 di passo molto pi\u00f9 elevate, ma il motore passo-passo potrebbe non avere una coppia sufficiente per muoversi a una velocit\u00e0 pi\u00f9 elevata. Quindi, per un asse Z con un rapporto di trasmissione elevato o un'impostazione di micropassi elevata, l'effettiva velocit\u00e0 max_z_ottenibile potrebbe essere inferiore a quella configurata in Marlin.","title":"Ho convertito la mia configurazione da Marlin e gli assi X/Y funzionano bene, ma ottengo solo un rumore stridente durante homing dell'asse Z"},{"location":"FAQ.html#il-mio-driver-tmc-del-motore-si-spegne-nel-mezzo-di-una-stampa","text":"Se si utilizza il driver TMC2208 (o TMC2224) in \"modalit\u00e0 standalone\", assicurarsi di utilizzare l' latest version of Klipper . Una soluzione alternativa per un problema del driver \"stealthchop\" TMC2208 \u00e8 stata aggiunta a Klipper a met\u00e0 marzo del 2020.","title":"Il mio driver TMC del motore si spegne nel mezzo di una stampa"},{"location":"FAQ.html#continuo-a-ricevere-errori-casuali-comunicazione-persa-con-mcu-lost-communication-with-mcu","text":"Ci\u00f2 \u00e8 comunemente causato da errori hardware sulla connessione USB tra la macchina host e il microcontrollore. Cose da cercare: Utilizzare un cavo USB di buona qualit\u00e0 tra la macchina host e il microcontrollore. Assicurati che i connettori siano ben saldi. Se si utilizza un Raspberry Pi, utilizzare un alimentatore di buona qualit\u00e0 per il Raspberry Pi e utilizzare un cavo USB di buona qualit\u00e0 per collegare quell'alimentatore al Pi. Se ricevi avvisi di \"sottotensione\" da OctoPrint, questo \u00e8 correlato all'alimentatore e deve essere risolto. Assicurarsi che l'alimentazione della stampante non sia sovraccarica. (Le fluttuazioni di alimentazione del chip USB del microcontrollore possono comportare il reset di quel chip.) Verificare che i cavi dello stepper, del riscaldatore e di altri cavi della stampante non siano arricciati o sfilacciati. (Il movimento della stampante pu\u00f2 sollecitare un cavo difettoso causandone la perdita di contatto, un cortocircuito breve o la generazione di rumore eccessivo.) Sono stati segnalati rumori USB elevati quando sia l'alimentazione della stampante che l'alimentazione a 5 V dell'host sono mescolate. (Se si scopre che il microcontrollore si accende quando l'alimentazione della stampante \u00e8 accesa o il cavo USB \u00e8 collegato, significa che gli alimentatori da 5 V vengono mescolati.) Pu\u00f2 essere utile configurare il microcontrollore da utilizzare alimentazione da una sola fonte. (In alternativa, se la scheda del microcontrollore non \u00e8 in grado di configurare la sua fonte di alimentazione, \u00e8 possibile modificare un cavo USB in modo che non trasmetta alimentazione a 5V tra l'host e il microcontrollore.)","title":"Continuo a ricevere errori casuali \"Comunicazione persa con MCU\" |\"Lost communication with MCU\""},{"location":"FAQ.html#il-mio-raspberry-pi-continua-a-riavviarsi-durante-le-stampe","text":"Questo \u00e8 molto probabilmente dovuto alle fluttuazioni di tensione. Segui gli stessi passaggi per la risoluzione dei problemi per un errore \"Comunicazione persa con MCU\" .","title":"Il mio Raspberry Pi continua a riavviarsi durante le stampe"},{"location":"FAQ.html#quando-imposto-restart_methodcommand-il-mio-dispositivo-avr-si-blocca-al-riavvio","text":"Alcune vecchie versioni del bootloader AVR hanno un bug noto nella gestione degli eventi di watchdog. Questo in genere si manifesta quando il file printer.cfg ha restart_method impostato su \"command\". Quando si verifica il bug, il dispositivo AVR non risponder\u00e0 fino a quando l'alimentazione non viene rimossa e ricollegata al dispositivo (anche i LED di alimentazione o di stato potrebbero lampeggiare ripetutamente fino a quando l'alimentazione non viene rimossa). La soluzione alternativa \u00e8 utilizzare un restart_method diverso da \"command\" o eseguire il flashing di un bootloader aggiornato sul dispositivo AVR. Il flashing di un nuovo bootloader \u00e8 un passaggio che in genere richiede un programmatore esterno: vedere Bootloaders per ulteriori dettagli.","title":"Quando imposto restart_method=command il mio dispositivo AVR si blocca al riavvio"},{"location":"FAQ.html#i-riscaldatori-verranno-lasciati-accesi-se-il-raspberry-pi-si-arresta-in-modo-anomalo","text":"Il software \u00e8 stato progettato per impedirlo. Una volta che l'host abilita un riscaldatore, il software host deve confermare tale abilitazione ogni 5 secondi. Se il microcontrollore non riceve una conferma ogni 5 secondi, entra in uno stato di \"spegnimento\" progettato per spegnere tutti i riscaldatori e i motori passo-passo. Per ulteriori dettagli, vedere il comando \"config_digital_out\" nel documento Comandi MCU . Inoltre, il software del microcontrollore \u00e8 configurato con un intervallo di temperatura minimo e massimo per ciascun riscaldatore all'avvio (consultare i parametri min_temp e max_temp in config reference per i dettagli). Se il microcontrollore rileva che la temperatura \u00e8 al di fuori di tale intervallo, entrer\u00e0 anche in uno stato di \"spegnimento\". Separatamente, il software host implementa anche il codice per verificare che i riscaldatori e i sensori di temperatura funzionino correttamente. Vedere il riferimento di configurazione per ulteriori dettagli.","title":"I riscaldatori verranno lasciati accesi se il Raspberry Pi si arresta in modo anomalo?"},{"location":"FAQ.html#come-posso-convertire-un-numero-di-pin-marlin-in-un-nome-pin-di-klipper","text":"Risposta breve: una mappatura \u00e8 disponibile nel file sample-aliases.cfg . Usa quel file come guida per trovare i nomi effettivi dei pin del microcontrollorei. (\u00c8 anche possibile copiare la relativa sezione di configurazione board_pins nel file di configurazione e utilizzare gli alias nella configurazione, ma \u00e8 preferibile tradurre e utilizzare i nomi dei pin del microcontrollore effettivi.) Nota che il file sample-aliases.cfg usa nomi di pin che iniziano con il prefisso \"ar\" invece di \"D\" (ad esempio, il pin Arduino D23 \u00e8 alias Klipper ar23 ) e il prefisso \"analog\" invece di \"A \" (ad esempio, il pin Arduino A14 \u00e8 alias di Klipper analog14 ). Risposta lunga: Klipper utilizza i nomi dei pin standard definiti dal microcontrollore. Sui chip Atmega questi pin hardware hanno nomi come PA4 , PC7 o PD2 . Tempo fa, il progetto Arduino ha deciso di evitare di utilizzare i nomi hardware standard a favore dei propri nomi pin basati su numeri incrementali: questi nomi Arduino generalmente assomigliano a \"D23\" o \"A14\". Questa \u00e8 stata una scelta sfortunata che ha portato a una grande confusione. In particolare, i numeri dei pin di Arduino spesso non si traducono negli stessi nomi hardware. Ad esempio, D21 \u00e8 PD0 su una comune scheda Arduino, ma \u00e8 PC7 su un'altra comune scheda Arduino. Per evitare questa confusione, il codice di base di Klipper utilizza i nomi dei pin standard definiti dal microcontrollore.","title":"Come posso convertire un numero di pin Marlin in un nome pin di Klipper?"},{"location":"FAQ.html#devo-collegare-il-mio-dispositivo-a-un-tipo-specifico-di-pin-del-microcontrollore","text":"Dipende dal tipo di dispositivo e dal tipo di pin: Pin ADC (o pin analogici): per termistori e sensori \"analogici\" simili, il dispositivo deve essere collegato a un pin compatibile con \"analogico\" o \"ADC\" sul microcontrollore. Se configuri Klipper per utilizzare un pin che non \u00e8 compatibile con l'analogico, Klipper segnaler\u00e0 un errore \"Non un pin ADC valido\". Pin PWM (o pin Timer): Klipper non utilizza PWM hardware per impostazione predefinita per nessun dispositivo. Quindi, in generale, \u00e8 possibile collegare riscaldatori, ventole e dispositivi simili a qualsiasi pin IO generico. Tuttavia, le ventole e i dispositivi output_pin possono essere opzionalmente configurati per utilizzare hardware_pwm: True , nel qual caso il microcontrollore deve supportare PWM hardware sul pin (altrimenti, Klipper segnaler\u00e0 un errore \"pin PWM non valido\"). Pin IRQ (o pin di interrupt): Klipper non utilizza gli interrupt hardware sui pin IO, quindi non \u00e8 mai necessario collegare un dispositivo a uno di questi pin del microcontrollore. Pin SPI: quando si utilizza l'SPI hardware, \u00e8 necessario collegare i pin ai pin SPI del microcontrollore. Tuttavia, la maggior parte dei dispositivi pu\u00f2 essere configurata per utilizzare \"SPI software\", nel qual caso \u00e8 possibile utilizzare qualsiasi pin IO generico. Pin I2C: quando si utilizza I2C \u00e8 necessario collegare i pin ai pin compatibili con I2C del microcontrollore. Altri dispositivi possono essere collegati a qualsiasi pin IO generico. Ad esempio, stepper, riscaldatori, ventole, sonde Z, servocomandi, LED, comuni display LCD hd44780/st7920, la linea di controllo Trinamic UART pu\u00f2 essere collegata a qualsiasi pin IO generico.","title":"Devo collegare il mio dispositivo a un tipo specifico di pin del microcontrollore?"},{"location":"FAQ.html#come-posso-annullare-una-richiesta-di-attesa-temperatura-m109m190","text":"Passare alla scheda del terminale OctoPrint ed emettere un comando M112 nel terminale. Il comando M112 far\u00e0 entrare Klipper in uno stato di \"arresto\" e causer\u00e0 la disconnessione di OctoPrint da Klipper. Passare all'area di connessione di OctoPrint e fare clic su \"Connetti\" per fare in modo che OctoPrint si riconnetta. Torna alla scheda del terminale ed emetti un comando FIRMWARE_RESTART per cancellare lo stato di errore di Klipper. Dopo aver completato questa sequenza, la precedente richiesta di riscaldamento verr\u00e0 annullata e potrebbe essere avviata una nuova stampa.","title":"Come posso annullare una richiesta di \"attesa temperatura\" M109/M190?"},{"location":"FAQ.html#posso-scoprire-se-la-stampante-ha-perso-dei-passaggi","text":"In un certo senso s\u00ec. Avviare la stampante, emettere un comando GET_POSITION , eseguire la stampa, tornare a casa ed emettere un altro GET_POSITION . Quindi confronta i valori nella riga mcu: . Questo potrebbe essere utile per regolare impostazioni come correnti, accelerazioni e velocit\u00e0 del motore passo-passo senza dover effettivamente stampare qualcosa e sprecare il filamento: basta eseguire alcuni movimenti ad alta velocit\u00e0 tra i comandi GET_POSITION . Si noti che gli stessi interruttori di fine corsa tendono a attivarsi in posizioni leggermente diverse, quindi una differenza di un paio di micropassi \u00e8 probabilmente il risultato di imprecisioni di fine corsa. Un motore passo-passo stesso pu\u00f2 perdere passi solo con incrementi di 4 passi completi. (Quindi, se si utilizzano 16 micropassi, un passo perso sullo stepper comporterebbe lo spegnimento del contatore di passi \"mcu:\" di un multiplo di 64 micropassi.)","title":"Posso scoprire se la stampante ha perso dei passaggi?"},{"location":"FAQ.html#perche-klipper-segnala-errori-ho-perso-la-mia-stampa","text":"Risposta breve: vogliamo sapere se le nostre stampanti rilevano un problema in modo che il problema sottostante possa essere risolto e possiamo ottenere stampe di ottima qualit\u00e0. Non vogliamo assolutamente che le nostre stampanti producano in silenzio stampe di bassa qualit\u00e0. Risposta lunga: Klipper \u00e8 stato progettato per risolvere automaticamente molti problemi transitori. Ad esempio, rileva automaticamente gli errori di comunicazione e li ritrasmette; pianifica le azioni in anticipo e bufferizza i comandi su pi\u00f9 livelli per consentire tempi precisi anche con interferenze intermittenti. Tuttavia, se il software rileva un errore dal quale non pu\u00f2 essere ripristinato, se gli viene ordinato di eseguire un'azione non valida o se rileva che \u00e8 irrimediabilmente incapace di eseguire l'attivit\u00e0 comandata, Klipper segnaler\u00e0 un errore. In queste situazioni c'\u00e8 un alto rischio di produrre una stampa di bassa qualit\u00e0 (o peggio). Si spera che avvisare gli utenti consentir\u00e0 loro di risolvere il problema sottostante e migliorare la qualit\u00e0 complessiva delle loro stampe. Ci sono alcune domande correlate: perch\u00e9 Klipper non mette invece in pausa la stampa? Segnalare invece un avviso? Verificare la presenza di errori prima della stampa? Ignorare gli errori nei comandi digitati dall'utente? eccetera? Attualmente Klipper legge i comandi utilizzando il protocollo G-Code e sfortunatamente il protocollo di comando G-Code non \u00e8 sufficientemente flessibile per rendere pratiche queste alternative oggi. C'\u00e8 l'interesse degli sviluppatori nel migliorare l'esperienza dell'utente durante eventi anomali, ma si prevede che ci\u00f2 richieder\u00e0 un notevole lavoro infrastrutturale (incluso un passaggio dal G-Code).","title":"Perch\u00e9 Klipper segnala errori? Ho perso la mia stampa!"},{"location":"FAQ.html#come-si-esegue-laggiornamento-al-software-piu-recente","text":"Il primo passaggio per l'aggiornamento del software consiste nell'esaminare l'ultimo documento config changes . A volte, vengono apportate modifiche al software che richiedono agli utenti di aggiornare le proprie impostazioni come parte di un aggiornamento del software. \u00c8 una buona idea rivedere questo documento prima dell'aggiornamento. Quando sei pronto per l'aggiornamento, il metodo generale \u00e8 quello di entrare in Raspberry Pi ed eseguire: cd ~/klipper git pull ~/klipper/scripts/install-octopi.sh Quindi si pu\u00f2 ricompilare e flashare il codice del microcontrollore. Per esempio: make menuconfig make clean make sudo service klipper stop make flash FLASH_DEVICE=/dev/ttyACM0 sudo service klipper start Tuttavia, capita spesso che cambi solo il software host. In questo caso \u00e8 possibile aggiornare e riavviare solo il software host con: cd ~/klipper git pull sudo service klipper restart Se dopo aver utilizzato questo collegamento il software avverte della necessit\u00e0 di eseguire il reflash del microcontrollore o si verifica qualche altro errore insolito, seguire i passaggi completi di aggiornamento descritti sopra. Se gli errori persistono, ricontrolla il documento config changes , poich\u00e9 potrebbe essere necessario modificare la configurazione della stampante. Si noti che i comandi g-code RESTART e FIRMWARE_RESTART non caricano il nuovo software: i comandi \"sudo service klipper restart\" e \"make flash\" di cui sopra sono necessari affinch\u00e9 una modifica del software abbia effetto.","title":"Come si esegue l'aggiornamento al software pi\u00f9 recente?"},{"location":"FAQ.html#come-faccio-a-disinstallare-klipper","text":"Dal alto del firmware, non deve succedere nulla di speciale. Basta seguire le indicazioni per il flashing del nuovo firmware. Dal lato del raspberry pi, uno script di disinstallazione \u00e8 disponibile in scripts/klipper-uninstall.sh . Per esempio: sudo ~/klipper/scripts/klipper-uninstall.sh rm -rf ~/klippy-env ~/klipper","title":"Come faccio a disinstallare Klipper?"},{"location":"Features.html","text":"Caratteristiche \u00b6 Klipper ha diverse caratteristiche interessanti: Movimento passo-passo di alta precisione. Klipper utilizza un processore applicativo (come un Raspberry Pi a basso costo) per calcolare i movimenti della stampante. Il processore dell'applicazione determina quando far avanzare ciascun motore passo-passo, comprime quegli eventi, li trasmette al microcontrollore e quindi il microcontrollore esegue ogni evento all'ora richiesta. Ogni evento stepper \u00e8 programmato con una precisione di 25 microsecondi o superiore. Il software non utilizza stime cinematiche (come l'algoritmo di Bresenham), ma calcola tempi di passo precisi in base alla fisica dell'accelerazione e alla fisica della cinematica della macchina. Il movimento passo-passo pi\u00f9 preciso garantisce un funzionamento della stampante pi\u00f9 silenzioso e stabile. Le migliori prestazioni della classe. Klipper \u00e8 in grado di raggiungere elevate velocit\u00e0 di stepping su microcontrollori nuovi e vecchi. Anche i vecchi microcontrollori a 8 bit possono ottenere velocit\u00e0 di oltre 175.000 passi al secondo. Sui microcontrollori pi\u00f9 recenti sono possibili diversi milioni di passi al secondo. Velocit\u00e0 stepper pi\u00f9 elevate consentono velocit\u00e0 di stampa pi\u00f9 elevate. Il timing dell'evento stepper rimane preciso anche a velocit\u00e0 elevate, migliorando la stabilit\u00e0 generale. Klipper supporta stampanti con pi\u00f9 microcontrollori. Ad esempio, un microcontrollore potrebbe essere utilizzato per controllare un estrusore, mentre un altro controlla i riscaldatori della stampante, mentre un terzo controlla il resto della stampante. Il software host Klipper implementa la sincronizzazione dell'orologio per tenere conto della deriva dell'orologio tra i microcontrollori. Non \u00e8 necessario alcun codice speciale per abilitare pi\u00f9 microcontrollori: sono necessarie solo alcune righe in pi\u00f9 nel file di configurazione. Configurazione tramite semplice file. Non \u00e8 necessario eseguire il reflash del microcontrollore per modificare un'impostazione. Tutta la configurazione di Klipper \u00e8 memorizzata in un file di configurazione standard che pu\u00f2 essere facilmente modificato. Ci\u00f2 semplifica la configurazione e la manutenzione dell'hardware. Klipper supporta \"Smooth Pressure Advance\", un meccanismo per tenere conto degli effetti della pressione all'interno di un estrusore. Ci\u00f2 riduce la \"melma\" dell'estrusore e migliora la qualit\u00e0 degli angoli di stampa. L'implementazione di Klipper non introduce variazioni istantanee della velocit\u00e0 dell'estrusore, il che migliora la stabilit\u00e0 e la robustezza complessive. Klipper supporta \"Input Shaping\" per ridurre l'impatto delle vibrazioni sulla qualit\u00e0 di stampa. Ci\u00f2 pu\u00f2 ridurre o eliminare il \"ringing\" (noto anche come \"ghosting\", \"eco\" o \"increspatura\") nelle stampe. Pu\u00f2 anche consentire di ottenere velocit\u00e0 di stampa pi\u00f9 elevate pur mantenendo un'elevata qualit\u00e0 di stampa. Klipper utilizza un \"risolutore iterativo\" per calcolare sequenze temporali precisi da semplici equazioni cinematiche. Ci\u00f2 semplifica il porting di Klipper su nuovi tipi di robot e mantiene i tempi precisi anche con cinematiche complesse (non \u00e8 necessaria la \"segmentazione della linea\"). Klipper \u00e8 indipendente dall'hardware. Si dovrebbe ottenere la stessa tempistica precisa indipendentemente dall'hardware dell'elettronica di basso livello. Il codice del microcontrollore Klipper \u00e8 progettato per seguire fedelmente la pianificazione fornita dal software host Klipper (o avvisare in modo evidente l'utente se non \u00e8 in grado di farlo). Ci\u00f2 semplifica l'utilizzo dell'hardware disponibile, l'aggiornamento al nuovo hardware e la fiducia nell'hardware. Codice portatile. Klipper funziona su microcontrollori basati su ARM, AVR e PRU. Le stampanti esistenti in stile \"reprap\" possono eseguire Klipper senza modifiche hardware: basta aggiungere un Raspberry Pi. Il layout del codice interno di Klipper semplifica il supporto anche di altre architetture di microcontrollori. Codice pi\u00f9 semplice. Klipper utilizza un linguaggio di alto livello (Python) per la maggior parte del codice. Gli algoritmi cinematici, l'analisi del G-code, gli algoritmi di riscaldamento e termistore, ecc. sono tutti scritti in Python. Ci\u00f2 semplifica lo sviluppo di nuove funzionalit\u00e0. Macro programmabili personalizzate. \u00c8 possibile definire nuovi comandi G-Code nel file di configurazione della stampante (non sono necessarie modifiche al codice). Questi comandi sono programmabili, consentendo loro di produrre azioni diverse a seconda dello stato della stampante. Server API integrato. Oltre all'interfaccia G-Code standard, Klipper supporta una ricca interfaccia applicativa basata su JSON. Ci\u00f2 consente ai programmatori di creare applicazioni esterne con un controllo dettagliato della stampante. Caratteristiche aggiuntive \u00b6 Klipper supporta molte funzionalit\u00e0 standard della stampante 3D: Diverse interfacce web disponibili. Funziona con Randa, Fluidd, OctoPrint e altri. Ci\u00f2 consente di controllare la stampante utilizzando un normale browser web. Lo stesso Raspberry Pi che esegue Klipper pu\u00f2 anche eseguire l'interfaccia web. Supporto G-code standard. Sono supportati i comandi G-code comuni prodotti dai tipici \"slicer\" (SuperSlicer, Cura, PrusaSlicer, ecc.). Supporto per pi\u00f9 estrusori. Sono supportati anche estrusori con riscaldatori condivisi ed estrusori su carrelli indipendenti (IDEX). Supporto per stampanti cartesiane, delta, corexy, corexz, hybrid-corexy, hybrid-corexz, deltesian, rotary delta, polar e cable winch. Supporto per il livellamento automatico del letto. Klipper pu\u00f2 essere configurato per il rilevamento di base dell'inclinazione del piatto o per il livellamento del piatto a mesh completa. Se il piatto utilizza pi\u00f9 stepper Z, Klipper pu\u00f2 anche livellare manipolando in modo indipendente gli stepper Z. Sono supportate la maggior parte delle sonde di altezza Z, comprese le sonde BL-Touch e le sonde servoattivate. Supporto per la calibrazione delta automatica. Lo strumento di calibrazione pu\u00f2 eseguire la calibrazione dell'altezza di base e una calibrazione avanzata delle dimensioni X e Y. La calibrazione pu\u00f2 essere eseguita con una sonda di altezza Z o tramite tastatura manuale. Supporto \"escludi oggetto\" in fase di esecuzione. Se configurato, questo modulo pu\u00f2 facilitare l'annullamento di un solo oggetto in una stampa multiparte. Supporto per sensori di temperatura comuni (ad es. termistori comuni, AD595, AD597, AD849x, PT100, PT1000, MAX6675, MAX31855, MAX31856, MAX31865, BME280, HTU21D, DS18B20 e LM75). \u00c8 inoltre possibile configurare termistori personalizzati e sensori di temperatura analogici personalizzati. \u00c8 possibile monitorare il sensore di temperatura del microcontrollore interno e il sensore di temperatura interna di un Raspberry Pi. Protezione del riscaldatore termico di base abilitata di default. Supporto per ventole standard, ventole per ugelli e ventole a temperatura controllata. Non \u00e8 necessario mantenere le ventole in funzione quando la stampante \u00e8 inattiva. La velocit\u00e0 della ventola pu\u00f2 essere monitorata su ventole dotate di contagiri. Supporto per la configurazione in fase di esecuzione dei driver per motori passo-passo TMC2130, TMC2208/TMC2224, TMC2209, TMC2660 e TMC5160. \u00c8 inoltre disponibile il supporto per il controllo corrente dei tradizionali driver passo-passo tramite i pin AD5206, DAC084S085, MCP4451, MCP4728, MCP4018 e PWM. Supporto per comuni display LCD collegati direttamente alla stampante. \u00c8 disponibile anche un menu predefinito. Il contenuto del display e del menu pu\u00f2 essere completamente personalizzato tramite il file di configurazione. Accelerazione costante e supporto \"look-ahead\". Tutti i movimenti della stampante accelereranno gradualmente dall'arresto alla velocit\u00e0 di crociera, quindi decelereranno fino all'arresto. Il flusso in entrata dei comandi di movimento del G-code viene messo in coda e analizzato: l'accelerazione tra i movimenti in una direzione simile sar\u00e0 ottimizzata per ridurre gli arresti di stampa e migliorare il tempo di stampa complessivo. Klipper implementa un algoritmo \"stepper phase endstop\" che pu\u00f2 migliorare la precisione dei tipici interruttori endstop. Se regolato correttamente, pu\u00f2 migliorare l'adesione del primo strato di stampa. Supporto per sensori di presenza del filamento, sensori di movimento del filamento e sensori di larghezza del filamento. Supporto per misurare e registrare l'accelerazione utilizzando gli accelerometri adxl345, mpu9250 e mpu6050. Supporto per limitare la velocit\u00e0 massima di brevi spostamenti a \"zigzag\" per ridurre le vibrazioni e il rumore della stampante. Per ulteriori informazioni, vedere il documento cinematica . Sono disponibili file di configurazione di esempio per molte stampanti comuni. Controllare la directory di configurazione per un elenco. Per iniziare con Klipper, leggi la guida installazione . Benchmark dei passi \u00b6 Di seguito sono riportati i risultati dei test delle prestazioni degli stepper. I numeri visualizzati rappresentano il numero totale di passi al secondo sul microcontrollore. Microcontrollore 1 stepper attivo 3 stepper attivi 16Mhz AVR 157K 99K 20Mhz AVR 196K 123K SAMD21 686K 471K STM32F042 814K 578K Beaglebone PRU 866K 708K STM32G0B1 1103K 790K STM32F103 1180K 818K SAM3X8E 1273K 981K SAM4S8C 1690K 1385K LPC1768 1923K 1351K LPC1769 2353K 1622K RP2040 2400K 1636K SAM4E8E 2500K 1674K SAMD51 3077K 1885K STM32F407 3652K 2459K STM32F446 3913K 2634K STM32H743 9091K 6061K Se non sei sicuro del microcontrollore su una particolare scheda, trova il file di configurazione appropriato e cerca il nome del microcontrollore nei commenti nella parte superiore di quel file. Ulteriori dettagli sui benchmark sono disponibili nel documento Benchmarks .","title":"Caratteristiche"},{"location":"Features.html#caratteristiche","text":"Klipper ha diverse caratteristiche interessanti: Movimento passo-passo di alta precisione. Klipper utilizza un processore applicativo (come un Raspberry Pi a basso costo) per calcolare i movimenti della stampante. Il processore dell'applicazione determina quando far avanzare ciascun motore passo-passo, comprime quegli eventi, li trasmette al microcontrollore e quindi il microcontrollore esegue ogni evento all'ora richiesta. Ogni evento stepper \u00e8 programmato con una precisione di 25 microsecondi o superiore. Il software non utilizza stime cinematiche (come l'algoritmo di Bresenham), ma calcola tempi di passo precisi in base alla fisica dell'accelerazione e alla fisica della cinematica della macchina. Il movimento passo-passo pi\u00f9 preciso garantisce un funzionamento della stampante pi\u00f9 silenzioso e stabile. Le migliori prestazioni della classe. Klipper \u00e8 in grado di raggiungere elevate velocit\u00e0 di stepping su microcontrollori nuovi e vecchi. Anche i vecchi microcontrollori a 8 bit possono ottenere velocit\u00e0 di oltre 175.000 passi al secondo. Sui microcontrollori pi\u00f9 recenti sono possibili diversi milioni di passi al secondo. Velocit\u00e0 stepper pi\u00f9 elevate consentono velocit\u00e0 di stampa pi\u00f9 elevate. Il timing dell'evento stepper rimane preciso anche a velocit\u00e0 elevate, migliorando la stabilit\u00e0 generale. Klipper supporta stampanti con pi\u00f9 microcontrollori. Ad esempio, un microcontrollore potrebbe essere utilizzato per controllare un estrusore, mentre un altro controlla i riscaldatori della stampante, mentre un terzo controlla il resto della stampante. Il software host Klipper implementa la sincronizzazione dell'orologio per tenere conto della deriva dell'orologio tra i microcontrollori. Non \u00e8 necessario alcun codice speciale per abilitare pi\u00f9 microcontrollori: sono necessarie solo alcune righe in pi\u00f9 nel file di configurazione. Configurazione tramite semplice file. Non \u00e8 necessario eseguire il reflash del microcontrollore per modificare un'impostazione. Tutta la configurazione di Klipper \u00e8 memorizzata in un file di configurazione standard che pu\u00f2 essere facilmente modificato. Ci\u00f2 semplifica la configurazione e la manutenzione dell'hardware. Klipper supporta \"Smooth Pressure Advance\", un meccanismo per tenere conto degli effetti della pressione all'interno di un estrusore. Ci\u00f2 riduce la \"melma\" dell'estrusore e migliora la qualit\u00e0 degli angoli di stampa. L'implementazione di Klipper non introduce variazioni istantanee della velocit\u00e0 dell'estrusore, il che migliora la stabilit\u00e0 e la robustezza complessive. Klipper supporta \"Input Shaping\" per ridurre l'impatto delle vibrazioni sulla qualit\u00e0 di stampa. Ci\u00f2 pu\u00f2 ridurre o eliminare il \"ringing\" (noto anche come \"ghosting\", \"eco\" o \"increspatura\") nelle stampe. Pu\u00f2 anche consentire di ottenere velocit\u00e0 di stampa pi\u00f9 elevate pur mantenendo un'elevata qualit\u00e0 di stampa. Klipper utilizza un \"risolutore iterativo\" per calcolare sequenze temporali precisi da semplici equazioni cinematiche. Ci\u00f2 semplifica il porting di Klipper su nuovi tipi di robot e mantiene i tempi precisi anche con cinematiche complesse (non \u00e8 necessaria la \"segmentazione della linea\"). Klipper \u00e8 indipendente dall'hardware. Si dovrebbe ottenere la stessa tempistica precisa indipendentemente dall'hardware dell'elettronica di basso livello. Il codice del microcontrollore Klipper \u00e8 progettato per seguire fedelmente la pianificazione fornita dal software host Klipper (o avvisare in modo evidente l'utente se non \u00e8 in grado di farlo). Ci\u00f2 semplifica l'utilizzo dell'hardware disponibile, l'aggiornamento al nuovo hardware e la fiducia nell'hardware. Codice portatile. Klipper funziona su microcontrollori basati su ARM, AVR e PRU. Le stampanti esistenti in stile \"reprap\" possono eseguire Klipper senza modifiche hardware: basta aggiungere un Raspberry Pi. Il layout del codice interno di Klipper semplifica il supporto anche di altre architetture di microcontrollori. Codice pi\u00f9 semplice. Klipper utilizza un linguaggio di alto livello (Python) per la maggior parte del codice. Gli algoritmi cinematici, l'analisi del G-code, gli algoritmi di riscaldamento e termistore, ecc. sono tutti scritti in Python. Ci\u00f2 semplifica lo sviluppo di nuove funzionalit\u00e0. Macro programmabili personalizzate. \u00c8 possibile definire nuovi comandi G-Code nel file di configurazione della stampante (non sono necessarie modifiche al codice). Questi comandi sono programmabili, consentendo loro di produrre azioni diverse a seconda dello stato della stampante. Server API integrato. Oltre all'interfaccia G-Code standard, Klipper supporta una ricca interfaccia applicativa basata su JSON. Ci\u00f2 consente ai programmatori di creare applicazioni esterne con un controllo dettagliato della stampante.","title":"Caratteristiche"},{"location":"Features.html#caratteristiche-aggiuntive","text":"Klipper supporta molte funzionalit\u00e0 standard della stampante 3D: Diverse interfacce web disponibili. Funziona con Randa, Fluidd, OctoPrint e altri. Ci\u00f2 consente di controllare la stampante utilizzando un normale browser web. Lo stesso Raspberry Pi che esegue Klipper pu\u00f2 anche eseguire l'interfaccia web. Supporto G-code standard. Sono supportati i comandi G-code comuni prodotti dai tipici \"slicer\" (SuperSlicer, Cura, PrusaSlicer, ecc.). Supporto per pi\u00f9 estrusori. Sono supportati anche estrusori con riscaldatori condivisi ed estrusori su carrelli indipendenti (IDEX). Supporto per stampanti cartesiane, delta, corexy, corexz, hybrid-corexy, hybrid-corexz, deltesian, rotary delta, polar e cable winch. Supporto per il livellamento automatico del letto. Klipper pu\u00f2 essere configurato per il rilevamento di base dell'inclinazione del piatto o per il livellamento del piatto a mesh completa. Se il piatto utilizza pi\u00f9 stepper Z, Klipper pu\u00f2 anche livellare manipolando in modo indipendente gli stepper Z. Sono supportate la maggior parte delle sonde di altezza Z, comprese le sonde BL-Touch e le sonde servoattivate. Supporto per la calibrazione delta automatica. Lo strumento di calibrazione pu\u00f2 eseguire la calibrazione dell'altezza di base e una calibrazione avanzata delle dimensioni X e Y. La calibrazione pu\u00f2 essere eseguita con una sonda di altezza Z o tramite tastatura manuale. Supporto \"escludi oggetto\" in fase di esecuzione. Se configurato, questo modulo pu\u00f2 facilitare l'annullamento di un solo oggetto in una stampa multiparte. Supporto per sensori di temperatura comuni (ad es. termistori comuni, AD595, AD597, AD849x, PT100, PT1000, MAX6675, MAX31855, MAX31856, MAX31865, BME280, HTU21D, DS18B20 e LM75). \u00c8 inoltre possibile configurare termistori personalizzati e sensori di temperatura analogici personalizzati. \u00c8 possibile monitorare il sensore di temperatura del microcontrollore interno e il sensore di temperatura interna di un Raspberry Pi. Protezione del riscaldatore termico di base abilitata di default. Supporto per ventole standard, ventole per ugelli e ventole a temperatura controllata. Non \u00e8 necessario mantenere le ventole in funzione quando la stampante \u00e8 inattiva. La velocit\u00e0 della ventola pu\u00f2 essere monitorata su ventole dotate di contagiri. Supporto per la configurazione in fase di esecuzione dei driver per motori passo-passo TMC2130, TMC2208/TMC2224, TMC2209, TMC2660 e TMC5160. \u00c8 inoltre disponibile il supporto per il controllo corrente dei tradizionali driver passo-passo tramite i pin AD5206, DAC084S085, MCP4451, MCP4728, MCP4018 e PWM. Supporto per comuni display LCD collegati direttamente alla stampante. \u00c8 disponibile anche un menu predefinito. Il contenuto del display e del menu pu\u00f2 essere completamente personalizzato tramite il file di configurazione. Accelerazione costante e supporto \"look-ahead\". Tutti i movimenti della stampante accelereranno gradualmente dall'arresto alla velocit\u00e0 di crociera, quindi decelereranno fino all'arresto. Il flusso in entrata dei comandi di movimento del G-code viene messo in coda e analizzato: l'accelerazione tra i movimenti in una direzione simile sar\u00e0 ottimizzata per ridurre gli arresti di stampa e migliorare il tempo di stampa complessivo. Klipper implementa un algoritmo \"stepper phase endstop\" che pu\u00f2 migliorare la precisione dei tipici interruttori endstop. Se regolato correttamente, pu\u00f2 migliorare l'adesione del primo strato di stampa. Supporto per sensori di presenza del filamento, sensori di movimento del filamento e sensori di larghezza del filamento. Supporto per misurare e registrare l'accelerazione utilizzando gli accelerometri adxl345, mpu9250 e mpu6050. Supporto per limitare la velocit\u00e0 massima di brevi spostamenti a \"zigzag\" per ridurre le vibrazioni e il rumore della stampante. Per ulteriori informazioni, vedere il documento cinematica . Sono disponibili file di configurazione di esempio per molte stampanti comuni. Controllare la directory di configurazione per un elenco. Per iniziare con Klipper, leggi la guida installazione .","title":"Caratteristiche aggiuntive"},{"location":"Features.html#benchmark-dei-passi","text":"Di seguito sono riportati i risultati dei test delle prestazioni degli stepper. I numeri visualizzati rappresentano il numero totale di passi al secondo sul microcontrollore. Microcontrollore 1 stepper attivo 3 stepper attivi 16Mhz AVR 157K 99K 20Mhz AVR 196K 123K SAMD21 686K 471K STM32F042 814K 578K Beaglebone PRU 866K 708K STM32G0B1 1103K 790K STM32F103 1180K 818K SAM3X8E 1273K 981K SAM4S8C 1690K 1385K LPC1768 1923K 1351K LPC1769 2353K 1622K RP2040 2400K 1636K SAM4E8E 2500K 1674K SAMD51 3077K 1885K STM32F407 3652K 2459K STM32F446 3913K 2634K STM32H743 9091K 6061K Se non sei sicuro del microcontrollore su una particolare scheda, trova il file di configurazione appropriato e cerca il nome del microcontrollore nei commenti nella parte superiore di quel file. Ulteriori dettagli sui benchmark sono disponibili nel documento Benchmarks .","title":"Benchmark dei passi"},{"location":"G-Codes.html","text":"G-Codes \u00b6 Questo documento descrive i comandi che Klipper supporta. Questi sono i comandi che si possono inserire nella scheda del terminale OctoPrint. Comandi G-Code \u00b6 Klipper supporta i seguenti comandi G-Code standard: Movimento (G0 or G1): G1 [X<pos>] [Y<pos>] [Z<pos>] [E<pos>] [F<speed>] Sosta: G4 P<millisecondi> Sposta all'origine: G28 [X] [Y] [Z] Spegnere i motori: M18 o M84 Attendi che li movimenti correnti finiscano: M400 Utilizzare distanze assolute/relative per l'estrusione: M82 , M83 Usa coordinate assolute/relative: G90 , G91 Impostare la posizione: G92 [X<pos>] [Y<pos>] [Z<pos>] [E<pos>] Impostare la percentuale di override del fattore di velocit\u00e0: M220 S<percentuale> Imposta la percentuale di sostituzione del fattore di estrusione: M221 S<percentuale> Impostare l'accelerazione: M204 S<valore> OPPURE M204 P<valore> T<valore> Nota: se S non viene specificato e vengono specificati sia P che T, l'accelerazione viene impostata al minimo di P e T. Se viene specificato solo uno di P o T, il comando non ha effetto. Ottieni la temperatura dell'estrusore: M105 Imposta la temperatura dell'estrusore: M104 [T<index>] [S<temperatura>] Imposta la temperatura dell'estrusore e attende: M109 [T<index>] S<temperatura> Nota: M109 attende sempre che la temperatura si assesti al valore richiesto Imposta la temperatura del piatto: M140 [S<temperatura>] Imposta la temperatura del piatto e attende: M190 S<temperatura> Nota: M190 attende sempre che la temperatura si assesti al valore richiesto Imposta la velocit\u00e0 della ventola: M106 S<valore> Spegnere la ventola: M107 Arresto di emergenza: M112 Ottieni la posizione attuale: M114 Ottieni la versione del firmware: M115 Per ulteriori dettagli sui comandi precedenti, vedere la documentazione RepRap G-Code . L'obiettivo di Klipper \u00e8 supportare i comandi G-Code prodotti da comuni software di terze parti (ad es. OctoPrint, Printrun, Slic3r, Cura, ecc.) nelle loro configurazioni standard. Non \u00e8 un obiettivo supportare ogni possibile comando G-Code. Invece, Klipper preferisce comandi leggibili dall'uomo \"comandi G-Code estesi\" . Allo stesso modo, l'output del terminale G-Code \u00e8 inteso solo per essere leggibile dall'uomo - vedere il documento del server API se si controlla Klipper da un software esterno. Se si necessita di un comando G-Code meno comune, potrebbe essere possibile implementarlo con una [sezione di configurazione gcode_macro] personalizzata (Config_Reference.md#gcode_macro). Ad esempio, si potrebbe usare questo per implementare: G12 , G29 , G30 , G31 , M42 , M80 , M81 , T1 , ecc. Comandi aggiuntivi \u00b6 Klipper utilizza comandi G-Code \"estesi\" per la configurazione e lo stato generale. Questi comandi estesi seguono tutti un formato simile: iniziano con un nome di comando e possono essere seguiti da uno o pi\u00f9 parametri. Ad esempio: SET_SERVO SERVO=mioservo ANGLE=5.3 . In questo documento, i comandi ed i parametri sono mostrati in maiuscolo, tuttavia non fanno distinzione tra maiuscole e minuscole. (Quindi, \"SET_SERVO\" e \"set_servo\" eseguono entrambi lo stesso comando.) Questa sezione \u00e8 organizzata in base al nome del modulo Klipper, che generalmente segue i nomi delle sezioni specificati nel file di configurazione della stampante . Si noti che alcuni moduli vengono caricati automaticamente. [adxl345] \u00b6 I seguenti comandi sono disponibili quando una sezione di configurazione adxl345 \u00e8 abilitata. ACCELEROMETER_MEASURE \u00b6 ACCELEROMETER_MEASURE [CHIP=<config_name>] [NAME=<value>] : Avvia le misurazioni dell'accelerometro al numero richiesto di campioni al secondo. Se CHIP non \u00e8 specificato, il valore predefinito \u00e8 \"adxl345\". Il comando funziona in modalit\u00e0 start-stop: alla prima esecuzione avvia le misure, alla successiva esecuzione le interrompe. I risultati delle misurazioni vengono scritti in un file denominato /tmp/adxl345-<chip>-<name>.csv dove <chip> \u00e8 il nome del chip dell'accelerometro ( my_chip_name da [adxl345 my_chip_name] ) e <name> \u00e8 il parametro NAME facoltativo. Se NAME non \u00e8 specificato, il valore predefinito \u00e8 l'ora corrente nel formato \"AAAAMMGG_HHMMSS\". Se l'accelerometro non ha un nome nella sua sezione di configurazione (semplicemente [adxl345] ), allora la parte <chip> del nome non viene generata. ACCELEROMETER_QUERY \u00b6 ACCELEROMETER_QUERY [CHIP=<config_name>] [RATE=<value>] : interroga l'accelerometro per il valore corrente. Se CHIP non \u00e8 specificato, il valore predefinito \u00e8 \"adxl345\". Se RATE non \u00e8 specificato, viene utilizzato il valore predefinito. Questo comando \u00e8 utile per testare la connessione all'accelerometro ADXL345: uno dei valori restituiti dovrebbe essere un'accelerazione di caduta libera (+/- un po' di rumore del chip). ACCELEROMETER_DEBUG_READ \u00b6 ACCELEROMETER_DEBUG_READ [CHIP=<config_name>] REG=<register> : interroga l'ADXL345 register \"register\" (es. 44 o 0x2C). Pu\u00f2 essere utile per scopi di debug. ACCELEROMETER_DEBUG_WRITE \u00b6 ACCELEROMETER_DEBUG_WRITE [CHIP=<nome_config>] REG=<register> VAL=<value> : Scrive il valore \"value\" grezzo in un registro \"register\". Sia \"value\" che \"registrer\" possono essere un numero intero decimale o esadecimale. Usare con cura e fare riferimento alla scheda tecnica ADXL345 per riferimento. [angle] \u00b6 I seguenti comandi sono disponibili quando una sezione di configurazione dell'angolo \u00e8 abilitata. ANGLE_CALIBRATE \u00b6 ANGLE_CALIBRATE CHIP=<chip_name> : Esegue la calibrazione dell'angolo sul sensore dato (deve esserci una sezione di configurazione [angle chip_name] che ha specificato un parametro stepper ). IMPORTANTE - questo strumento comander\u00e0 al motore passo-passo di muoversi senza controllare i normali limiti della cinematica. Idealmente, il motore dovrebbe essere scollegato da qualsiasi carrello della stampante prima di eseguire la calibrazione. Se non \u00e8 possibile scollegare lo stepper dalla stampante, assicurarsi che il carrello sia vicino al centro della sua guida prima di iniziare la calibrazione. (Il motore passo-passo pu\u00f2 spostarsi avanti o indietro di due rotazioni complete durante questo test.) Dopo aver completato questo test, utilizzare il comando SAVE_CONFIG per salvare i dati di calibrazione nel file di configurazione. Per utilizzare questo strumento \u00e8 necessario installare il pacchetto Python \"numpy\" (consultare il measuring resonance document per ulteriori informazioni). ANGLE_DEBUG_READ \u00b6 ANGLE_DEBUG_READ CHIP=<config_name> REG=<register> : Interroga il registro del sensore \"register\" (ad es. 44 o 0x2C). Pu\u00f2 essere utile per scopi di debug. Questo \u00e8 disponibile solo per i chip tle5012b. ANGLE_DEBUG_WRITE \u00b6 ANGLE_DEBUG_WRITE CHIP=<config_name> REG=<register> VAL=<value> : scrive il valore \"value\" grezzo nel registro \"register\". Sia \"value\" che \"register\" possono essere un numero intero decimale o esadecimale. Usare con cautela e fare riferimento alla scheda tecnica del sensore per riferimento. Questo \u00e8 disponibile solo per i chip tle5012b. [bed_mesh] \u00b6 I seguenti comandi sono disponibili quando la sezione di configurazione bed_mesh \u00e8 abilitata (consultare anche la guida della mesh del letto ). BED_MESH_CALIBRATE \u00b6 BED_MESH_CALIBRATE [METHOD=manual] [<probe_parameter>=<value>] [<mesh_parameter>=<value>] : Questo comando sonda il piatto utilizzando i punti generati specificati dai parametri nella configurazione. Dopo il sondaggio, viene generata una mesh e il movimento z viene regolato in base alla mesh. Vedere il comando PROBE per i dettagli sui parametri della sonda opzionali. Se viene specificato METHOD=manual, lo strumento di probing manuale \u00e8 attivato - vedere il comando MANUAL_PROBE per quanti riguarda per i dettagli sui comandi aggiuntivi disponibili mentre questo strumento \u00e8 attivo. BED_MESH_OUTPUT \u00b6 BED_MESH_OUTPUT PGP=[<0:1>] : questo comando restituisce i valori z sondati e i valori mesh correnti al terminale. Se viene specificato PGP=1, le coordinate X, Y generate da bed_mesh, insieme ai relativi indici associati, verranno inviate al terminale. BED_MESH_MAP \u00b6 BED_MESH_MAP : Come per BED_MESH_OUTPUT, questo comando stampa lo stato corrente della mesh sul terminale. Invece di stampare i valori in un formato leggibile, lo stato viene serializzato in formato json. Ci\u00f2 consente ai plug-in di Octoprint di acquisire facilmente i dati e generare mappe di altezza che si approssimano la superficie del piatto. BED_MESH_CLEAR \u00b6 BED_MESH_CLEAR : questo comando cancella la mesh e rimuove tutte le regolazioni z. Si consiglia di inserirlo nella parte finale del gcode. BED_MESH_PROFILE \u00b6 BED_MESH_PROFILE LOAD=<name> SAVE=<name> REMOVE=<name> : questo comando fornisce la gestione del profilo per lo stato della mesh. LOAD ripristiner\u00e0 lo stato della mesh dal profilo corrispondente al nome fornito. SAVE salver\u00e0 lo stato della mesh corrente in un profilo che corrisponde al nome fornito. Rimuovi eliminer\u00e0 il profilo corrispondente al nome fornito dalla memoria persistente. Si noti che dopo aver eseguito le operazioni SAVE o REMOVE \u00e8 necessario eseguire il gcode SAVE_CONFIG per rendere permanenti le modifiche alla memoria persistente. BED_MESH_OFFSET \u00b6 BED_MESH_OFFSET [X=<value>] [Y=<value>] : applica gli offset X e/o Y alla ricerca della mesh. Ci\u00f2 \u00e8 utile per le stampanti con estrusori indipendenti, poich\u00e9 \u00e8 necessario un offset per produrre la corretta regolazione Z dopo un cambio utensile. [bed_screws] \u00b6 I seguenti comandi sono disponibili quando la sezione di configurazione bed_screws \u00e8 abilitata (consultare anche la manual level guide ). BED_SCREWS_ADJUST \u00b6 BED_SCREWS_ADJUST : questo comando richiamer\u00e0 lo strumento di regolazione delle viti del piatto. Comander\u00e0 l'ugello in posizioni diverse (come definito nel file di configurazione) e consentir\u00e0 di effettuare regolazioni alle viti del piatto in modo che il piatto sia a una distanza costante dall'ugello. [bed_tilt] \u00b6 I seguenti comandi sono disponibili quando la sezione di configurazione inclinazione_piatto \u00e8 abilitata. BED_TILT_CALIBRATE \u00b6 BED_TILT_CALIBRATE [METHOD=manual] [<probe_parameter>=<value>] : Questo comando sonder\u00e0 i punti specificati nella configurazione e quindi consiglier\u00e0 le regolazioni dell'inclinazione x e y aggiornate. Vedere il comando PROBE per i dettagli sui parametri della sonda opzionali. Se viene specificato METHOD=manual, lo strumento di probing manuale \u00e8 attivato - vedere il comando MANUAL_PROBE sopra per i dettagli sui comandi aggiuntivi disponibili mentre questo strumento \u00e8 attivo. [bltouch] \u00b6 Il comando seguente \u00e8 disponibile quando \u00e8 abilitata una sezione di configurazione bltouch (vedere anche la Guida BL-Touch ). BLTOUCH_DEBUG \u00b6 BLTOUCH_DEBUG COMMAND=<command> : Invia un comando al BLTouch. Pu\u00f2 essere utile per il debug. I comandi disponibili sono: pin_down , touch_mode , pin_up , self_test , reset . Un BL-Touch V3.0 o V3.1 pu\u00f2 anche supportare i comandi set_5V_output_mode , set_OD_output_mode , output_mode_store . BLTOUCH_STORE \u00b6 BLTOUCH_STORE MODE=<output_mode> : memorizza una modalit\u00e0 di output nella EEPROM di un BLTouch V3.1 Le modalit\u00e0 di output disponibili sono: 5V , OD [configfile] \u00b6 Il modulo configfile viene caricato automaticamente. SAVE_CONFIG \u00b6 SAVE_CONFIG : questo comando sovrascriver\u00e0 il file di configurazione della stampante principale e riavvier\u00e0 il software host. Questo comando viene utilizzato insieme ad altri comandi di calibrazione per memorizzare i risultati dei test di calibrazione. [delayed_gcode] \u00b6 Il comando seguente \u00e8 abilitato se \u00e8 stata abilitata una sezione di configurazione di gcode ritardata (consultare anche la guida ai modelli ). UPDATE_DELAYED_GCODE \u00b6 UPDATE_DELAYED_GCODE [ID=<nome>] [DURATION=<secondi>] : aggiorna la durata del ritardo per il [gcode_ritardato] identificato e avvia il timer per l'esecuzione di gcode. Un valore di 0 annuller\u00e0 l'esecuzione di un gcode ritardato in sospeso. [delta_calibrate] \u00b6 I seguenti comandi sono disponibili quando la sezione di configurazione delta_calibrate \u00e8 abilitata (consultare anche la guida alla calibrazione delta ). DELTA_CALIBRATE \u00b6 DELTA_CALIBRATE [METHOD=manual] [<probe_parameter>=<value>] : questo comando sonder\u00e0 sette punti sul piatto e consiglier\u00e0 posizioni di finecorsa, angoli della torre e raggio aggiornati. Vedere il comando PROBE per i dettagli sui parametri della sonda opzionali. Se viene specificato METHOD=manual, lo strumento di probe manuale \u00e8 attivato - vedere il comando MANUAL_PROBE precedente per i dettagli sui comandi aggiuntivi disponibili mentre questo strumento \u00e8 attivo. DELTA_ANALYZE \u00b6 DELTA_ANALYZE : questo comando viene utilizzato durante la calibrazione avanzata delle stampanti delta. Vedere Delta Calibrate per i dettagli. [display] \u00b6 Il comando seguente \u00e8 disponibile quando \u00e8 abilitata una sezione di configurazione display . SET_DISPLAY_GROUP \u00b6 SET_DISPLAY_GROUP [DISPLAY=<display>] GROUP=<group> : Imposta il gruppo di visualizzazione attivo di un display LCD. Ci\u00f2 consente di definire pi\u00f9 gruppi di dati di visualizzazione nella configurazione, ad es. [display_data <group> <elementname>] e passare da uno all'altro usando questo comando gcode esteso. Se DISPLAY non \u00e8 specificato, l'impostazione predefinita \u00e8 \"display\" (il display principale). [display_status] \u00b6 Il modulo display_status viene caricato automaticamente se una sezione di configurazione display \u00e8 abilitata. Fornisce i seguenti comandi G-Code standard: Messaggio visualizzato: M117 <messaggio> Imposta la percentuale di costruzione: M73 P<percentuale> Viene inoltre fornito il seguente comando G-Code esteso: SET_DISPLAY_TEXT MSG=<messaggio> : esegue l'equivalente di M117, impostando il MSG fornito come messaggio visualizzato. Se MSG viene omesso, il display verr\u00e0 cancellato. [dual_carriage] \u00b6 Il comando seguente \u00e8 disponibile quando la sezione di configurazione dual_carriage \u00e8 abilitata. SET_DUAL_CARRIAGE \u00b6 SET_DUAL_CARRIAGE CARRIAGE=[0|1] : Questo comando imposter\u00e0 il carrello attivo. Viene in genere richiamato dai campi activate_gcode e deactivate_gcode in una configurazione a pi\u00f9 estrusori. [endstop_phase] \u00b6 I seguenti comandi sono disponibili quando una sezione di configurazione endstop_phase \u00e8 abilitata (consultare anche la guida alla fase endstop ). ENDSTOP_PHASE_CALIBRATE \u00b6 ENDSTOP_PHASE_CALIBRATE [STEPPER=<config_name>] : Se non viene fornito alcun parametro STEPPER, questo comando riporter\u00e0 le statistiche sulle fasi stepper dell'arresto durante le precedenti operazioni di homing. Quando viene fornito un parametro STEPPER, fa in modo che l'impostazione della fase di fine corsa fornita sia scritta nel file di configurazione (insieme al comando SAVE_CONFIG). [exclude_object] \u00b6 I seguenti comandi sono disponibili quando \u00e8 abilitata una exclude_object config section (consultare anche la exclude object guide ): EXCLUDE_OBJECT \u00b6 EXCLUDE_OBJECT [NAME=object_name] [CURRENT=1] [RESET=1] : Senza parametri, questo restituir\u00e0 un elenco di tutti gli oggetti attualmente esclusi. Quando viene fornito il parametro NAME , l'oggetto denominato verr\u00e0 escluso dalla stampa. Quando viene fornito il parametro CURRENT , l'oggetto corrente verr\u00e0 escluso dalla stampa. Quando viene fornito il parametro RESET l'elenco degli oggetti esclusi verr\u00e0 cancellato. Inoltre l'inclusione di NAME ripristiner\u00e0 solo l'oggetto denominato. Questo pu\u00f2 causare errori di stampa, se i livelli sono gi\u00e0 stati saltati. EXCLUDE_OBJECT_DEFINE \u00b6 EXCLUDE_OBJECT_DEFINE [NAME=object_name [CENTER=X,Y] [POLYGON=[[x,y],...]] [RESET=1] [JSON=1] : fornisce un riepilogo di un oggetto nel file. Senza parametri forniti, questo elencher\u00e0 gli oggetti definiti noti a Klipper. Restituisce un elenco di stringhe, a meno che non venga fornito il parametro JSON , quando restituir\u00e0 i dettagli dell'oggetto in formato json. Quando il parametro NAME \u00e8 incluso, definisce un oggetto da escludere. NAME : questo parametro \u00e8 obbligatorio. \u00c8 l'identificatore utilizzato da altri comandi in questo modulo. CENTER : una coordinata X,Y per l'oggetto. POLYGON : Un array di coordinate X,Y che fornisce un contorno per l'oggetto. Quando viene fornito il parametro RESET , tutti gli oggetti definiti verranno cancellati e il modulo [exclude_object] verr\u00e0 ripristinato. EXCLUDE_OBJECT_START \u00b6 EXCLUDE_OBJECT_START NAME=object_name : questo comando prende un parametro NAME e marca l'inizio del gcode per un oggetto sul livello corrente. EXCLUDE_OBJECT_END \u00b6 EXCLUDE_OBJECT_END [NAME=object_name] : Denota la fine del gcode dell'oggetto per il livello. \u00c8 accoppiato con EXCLUDE_OBJECT_START . Un parametro NAME \u00e8 facoltativo e avviser\u00e0 solo quando il nome fornito non corrisponde all'oggetto corrente. [extruder] \u00b6 I seguenti comandi sono disponibili se una sezione di configurazione dell'estrusore \u00e8 abilitata: ACTIVATE_EXTRUDER \u00b6 ACTIVATE_EXTRUDER EXTRUDER=<config_name> : in una stampante con pi\u00f9 sezioni di configurazione extruder , questo comando cambia l'hotend attivo. SET_PRESSURE_ADVANCE \u00b6 SET_PRESSURE_ADVANCE [EXTRUDER=<config_name>] [ADVANCE=<pressure_advance>] [SMOOTH_TIME=<pressure_advance_smooth_time>] : Imposta i parametri di pressure advance delleo stepper di un estrusore (come definito in un estrusore o [ extruder_stepper] (sezione di configurazione Config_Reference.md#extruder_stepper). Se EXTRUDER non \u00e8 specificato, per impostazione predefinita viene utilizzato lo stepper definito nell'hotend attivo. SET_EXTRUDER_ROTATION_DISTANCE \u00b6 SET_EXTRUDER_ROTATION_DISTANCE EXTRUDER=<config_name> [DISTANCE=<distance>] : Imposta un nuovo valore per la \"distanza di rotazione\" dello stepper dell'estrusore fornito (come definito in un extruder o extruder_stepper sezione di configurazione). Se la distanza di rotazione \u00e8 un numero negativo, il movimento passo-passo verr\u00e0 invertito (rispetto alla direzione passo-passo specificata nel file di configurazione). Le impostazioni modificate non vengono mantenute al ripristino di Klipper. Usare con cautela poich\u00e9 piccole modifiche possono causare una pressione eccessiva tra l'estrusore e l'hotend. Eseguire una corretta calibrazione con il filamento prima dell'uso. Se il valore 'DISTANZA' non viene fornito, questo comando restituir\u00e0 la distanza di rotazione corrente. SYNC_EXTRUDER_MOTION \u00b6 SYNC_EXTRUDER_MOTION EXTRUDER=<nome> MOTION_QUEUE=<nome> : questo comando attiver\u00e0 lo stepper specificato da EXTRUDER (come definito in un extruder o extruder_stepper config sezione) per sincronizzarsi con il movimento di un estrusore specificato da MOTION_QUEUE (come definito in una sezione di configurazione estrusore ). Se MOTION_QUEUE \u00e8 una stringa vuota, lo stepper verr\u00e0 desincronizzato da tutti i movimenti dell'estrusore. SET_EXTRUDER_STEP_DISTANCE \u00b6 Questo comando \u00e8 deprecato e verr\u00e0 rimosso nel prossimo futuro. SYNC_STEPPER_TO_EXTRUDER \u00b6 Questo comando \u00e8 deprecato e verr\u00e0 rimosso nel prossimo futuro. [fan_generic] \u00b6 Il comando seguente \u00e8 disponibile quando una sezione di configurazione fan_generic \u00e8 abilitata. SET_FAN_SPEED \u00b6 SET_FAN_SPEED FAN=config_name SPEED=<velocit\u00e0> Questo comando imposta la velocit\u00e0 di una ventola. \"velocit\u00e0\" deve essere compresa tra 0.0 e 1.0. [filament_switch_sensor] \u00b6 Il comando seguente \u00e8 disponibile quando \u00e8 abilitata una sezione di configurazione filament_switch_sensor o filament_motion_sensor . QUERY_FILAMENT_SENSOR \u00b6 QUERY_FILAMENT_SENSOR SENSOR=<sensor_name> : Interroga lo stato del sensore di filamento. I dati visualizzati sul terminale dipenderanno dal tipo di sensore definito nella configurazione. SET_FILAMENT_SENSOR \u00b6 SET_FILAMENT_SENSOR SENSOR=<nome_sensore> ENABLE=[0|1] : Attiva/disattiva il sensore di filamento. Se ENABLE \u00e8 impostato su 0, il sensore di filamento sar\u00e0 disabilitato, se impostato su 1 sar\u00e0 abilitato. [firmware_retraction] \u00b6 I seguenti comandi G-Code standard sono disponibili quando la sezione di configurazione firmware_retraction \u00e8 abilitata. Questi comandi consentono di utilizzare la funzione di retraction del firmware disponibile in molti slicer, per ridurre lo stringing durante gli spostamenti di non estrusione da una parte all'altra della stampa. Configurando opportunamente la pressure advance si riduce la lunghezza della retrazione richiesta. G10 : Ritrae l'estrusore utilizzando i parametri attualmente configurati. G11 : Ritira l'estrusore utilizzando i parametri attualmente configurati. Sono inoltre disponibili i seguenti comandi aggiuntivi. SET_RETRACTION \u00b6 SET_RETRACTION [RETRACT_LENGTH=<mm>] [RETRACT_SPEED=<mm/s>] [UNRETRACT_EXTRA_LENGTH=<mm>] [UNRETRACT_SPEED=<mm/s>] : regola i parametri utilizzati dalla retrazione. RETRACT_LENGTH determina la lunghezza del filamento da ritrarre e estrudere. La velocit\u00e0 di retrazione viene regolata tramite RETRACT_SPEED, ed \u00e8 generalmente impostata su un valore relativamente alto. La velocit\u00e0 di annullamento viene regolata tramite UNRETRACT_SPEED e non \u00e8 particolarmente critica, sebbene spesso inferiore a RETRACT_SPEED. In alcuni casi \u00e8 utile aggiungere una piccola quantit\u00e0 di lunghezza aggiuntiva all'annullamento della retrazione, e questa viene impostata tramite UNRETRACT_EXTRA_LENGTH. SET_RETRACTION \u00e8 comunemente impostato come parte della configurazione dello slicer per filamento, poich\u00e9 filamenti diversi richiedono impostazioni dei parametri diverse. GET_RETRACTION \u00b6 GET_RETRACTION : interroga i parametri correnti utilizzati dal firmware per retrazione e li visualizza sul terminale. [force_move] \u00b6 Il modulo force_move viene caricato automaticamente, tuttavia alcuni comandi richiedono l'impostazione di enable_force_move in printer config . STEPPER_BUZZ \u00b6 STEPPER_BUZZ STEPPER=<nome_config> : sposta lo stepper dato in avanti di 1 mm e poi indietro di 1 mm, ripetuto 10 volte. Questo \u00e8 uno strumento diagnostico per aiutare a verificare la connettivit\u00e0 stepper. FORCE_MOVE \u00b6 FORCE_MOVE STEPPER=<nome_config> DISTANCE=<value> VELOCITY=<value> [ACCEL=<value>] : Questo comando sposter\u00e0 forzatamente lo stepper dato della distanza data (in mm) alla velocit\u00e0 costante data (in mm/ S). Se viene specificato ACCEL ed \u00e8 maggiore di zero, verr\u00e0 utilizzata l'accelerazione data (in mm/s^2); altrimenti non viene eseguita alcuna accelerazione. Non vengono effettuati controlli sui limiti; non vengono effettuati aggiornamenti cinematici; altri stepper paralleli su un asse non verranno spostati. Prestare attenzione poich\u00e9 un comando errato potrebbe causare danni! L'uso di questo comando metter\u00e0 quasi sicuramente la cinematica di basso livello in uno stato errato; emettere un G28 in seguito per ripristinare la cinematica. Questo comando \u00e8 destinato alla diagnostica e al debug di basso livello. SET_KINEMATIC_POSITION \u00b6 SET_KINEMATIC_POSITION [X=<valore>] [Y=<valore>] [Z=<valore>] : forza il codice cinematico di basso livello a credere che la testa di stampa si trovi nella posizione cartesiana data. Questo \u00e8 un comando diagnostico e di debug; utilizzare SET_GCODE_OFFSET e/o G92 per le normali trasformazioni degli assi. Se un asse non \u00e8 specificato, verr\u00e0 impostato automaticamente sulla posizione in cui la testa \u00e8 stata comandata l'ultima volta. L'impostazione di una posizione errata o non valida pu\u00f2 causare errori software interni. Questo comando potrebbe invalidare futuri controlli sui confini; emettere un G28 in seguito per ripristinare la cinematica. [gcode] \u00b6 Il modulo gcode viene caricato automaticamente. RESTART \u00b6 RESTART : Ci\u00f2 far\u00e0 s\u00ec che il software host ricarichi la sua configurazione ed esegua un ripristino interno. Questo comando non canceller\u00e0 lo stato di errore dal microcontrollore (vedi FIRMWARE_RESTART) n\u00e9 caricher\u00e0 nuovo software (vedi FAQ ) . FIRMWARE_RESTART \u00b6 FIRMWARE_RESTART : Questo \u00e8 simile a un comando RESTART, ma cancella anche qualsiasi stato di errore dal microcontrollore. STATUS \u00b6 STATUS : segnala lo stato del software host di Klipper. HELP \u00b6 HELP : riporta l'elenco dei comandi G-Code estesi disponibili. [gcode_arcs] \u00b6 I seguenti comandi G-Code standard sono disponibili se una sezione di configurazione gcode_arcs \u00e8 abilitata: Movimento dell'arco in senso orario (G2), Movimento dell'arco in senso antiorario (G3): G2|G3 [X<pos>] [Y<pos>] [Z<pos>] [E<pos>] [F<velocit\u00e0>] I<valore> J<valore>|I<valore> K<valore>|J<valore> K<valore> Selezione del piano dell'arco: G17 (piano XY), G18 (piano XZ), G19 (piano YZ) [gcode_macro] \u00b6 Il comando seguente \u00e8 disponibile quando \u00e8 abilitata una sezione di configurazione gcode_macro (consultare anche la guida ai modelli di comando ). SET_GCODE_VARIABLE \u00b6 SET_GCODE_VARIABLE MACRO=<nome_macro> VARIABLE=<nome> VALUE=<valore> : questo comando consente di modificare il valore di una variabile gcode_macro in fase di esecuzione. Il VALUE fornito viene analizzato come un valore literal in Python. [gcode_move] \u00b6 Il modulo gcode_move viene caricato automaticamente. GET_POSITION \u00b6 GET_POSITION`: Restituisce informazioni sulla posizione corrente della testa di stampa. Per ulteriori informazioni, vedere la documentazione per gli sviluppatori di GET_POSITION output . SET_GCODE_OFFSET \u00b6 SET_GCODE_OFFSET [X=<pos>|X_ADJUST=<regola>] [Y=<pos>|Y_ADJUST=<regola>] [Z=<pos>|Z_ADJUST=<regola>] [MOVE=1 [MOVE_SPEED=<velocit\u00e0 >]] : imposta un offset di posizione da applicare ai futuri comandi G-Code. Questo \u00e8 comunemente usato per cambiare virtualmente l'offset del letto Z o per impostare gli offset XY degli ugelli quando si cambia estrusore. Ad esempio, se viene inviato \"SET_GCODE_OFFSET Z=0.2\", i futuri movimenti G-Code avranno 0.2 mm aggiunti alla loro altezza Z. Se vengono utilizzati i parametri di stile X_ADJUST, la regolazione verr\u00e0 aggiunta a qualsiasi offset esistente (ad esempio, \"SET_GCODE_OFFSET Z=-0.2\" seguito da \"SET_GCODE_OFFSET Z_ADJUST=0.3\" risulter\u00e0 in un offset Z totale di 0.1). Se viene specificato \"MOVE=1\", verr\u00e0 emesso un movimento della testa di stampa per applicare l'offset specificato (altrimenti l'offset avr\u00e0 effetto sul successivo movimento assoluto del codice G che specifica l'asse dato). Se viene specificato \"MOVE_SPEED\", lo spostamento della testa utensile verr\u00e0 eseguito con la velocit\u00e0 data (in mm/s); in caso contrario, il movimento della testa utensile utilizzer\u00e0 l'ultima velocit\u00e0 del G-code specificata. SAVE_GCODE_STATE \u00b6 SAVE_GCODE_STATE [NAME=<nome_stato>] : salva lo stato di analisi delle coordinate del G-code corrente. Il salvataggio e il ripristino dello stato del G-code \u00e8 utile negli script e nelle macro. Questo comando salva la modalit\u00e0 di coordinate assolute del G-code corrente (G90/G91), la modalit\u00e0 di estrusione assoluta (M82/M83), l'origine (G92), l'offset (SET_GCODE_OFFSET), l'override della velocit\u00e0 (M220), l'override dell'estrusore (M221), la velocit\u00e0 di spostamento , la posizione XYZ corrente e la posizione relativa dell'estrusore \"E\". Se viene fornito NAME, consente di assegnare un nome allo stato salvato alla stringa data. Se NAME non viene fornito, il valore predefinito \u00e8 \"predefinito\". RESTORE_GCODE_STATE \u00b6 RESTORE_GCODE_STATE [NAME=<nome_stato>] [MOVE=1 [MOVE_SPEED=<velocit\u00e0>]] : ripristina uno stato precedentemente salvato tramite SAVE_GCODE_STATE. Se viene specificato \"MOVE=1\", verr\u00e0 emesso un movimento della testa utensile per tornare alla posizione XYZ precedente. Se viene specificato \"MOVE_SPEED\", lo spostamento della testa utensile verr\u00e0 eseguito con la velocit\u00e0 data (in mm/s); in caso contrario, lo spostamento della testa utensile utilizzer\u00e0 la velocit\u00e0 del codice g ripristinata. [hall_filament_width_sensor] \u00b6 I seguenti comandi sono disponibili quando la sezione di configurazione del sensore di larghezza del filamento tsl1401cl o sezione di configurazione del sensore di larghezza del filamento hall \u00e8 abilitata (consultare anche Sensore di larghezza del filamento TSLl401CL e Hall Filament Width Sensor ): QUERY_FILAMENT_WIDTH \u00b6 QUERY_FILAMENT_WIDTH : Restituisce lo spessore del filamento misurato. RESET_FILAMENT_WIDTH_SENSOR \u00b6 RESET_FILAMENT_WIDTH_SENSOR : Cancella tutte le letture del sensore. Utile dopo il cambio del filamento. DISABLE_FILAMENT_WIDTH_SENSOR \u00b6 DISABLE_FILAMENT_WIDTH_SENSOR : Spegnere il sensore di larghezza del filamento e smettere di usarlo per il controllo del flusso. ENABLE_FILAMENT_WIDTH_SENSOR \u00b6 ENABLE_FILAMENT_WIDTH_SENSOR : attiva il sensore di larghezza del filamento e inizia a usarlo per il controllo del flusso. QUERY_RAW_FILAMENT_WIDTH \u00b6 QUERY_RAW_FILAMENT_WIDTH : Restituisce le letture del canale ADC corrente e il valore grezzo (raw) del sensore per i punti di calibrazione. ENABLE_FILAMENT_WIDTH_LOG \u00b6 ENABLE_FILAMENT_WIDTH_LOG : attiva la registrazione del diametro del filamento. DISABLE_FILAMENT_WIDTH_LOG \u00b6 DISABLE_FILAMENT_WIDTH_LOG : Disattiva la registrazione del diametro del filamento. [heaters] \u00b6 Il modulo heaters viene caricato automaticamente se un riscaldatore \u00e8 definito nel file di configurazione. TURN_OFF_HEATERS \u00b6 TURN_OFF_HEATERS : Spegni tutti i riscaldatori. TEMPERATURE_WAIT \u00b6 TEMPERATURE_WAIT SENSOR=<config_name> [MINIMUM=<target>] [MAXIMUM=<target>] : Attendere fino a quando il sensore di temperatura specificato \u00e8 pari o superiore al MINIMO fornito e/o pari o inferiore al MASSIMO fornito. SET_HEATER_TEMPERATURE \u00b6 SET_HEATER_TEMPERATURE HEATER=<nome_riscaldatore> [TARGET=<temperatura_destinata>] : Imposta la temperatura target per un riscaldatore. Se non viene fornita una temperatura target, il target \u00e8 0. [idle_timeout] \u00b6 Il modulo idle_timeout viene caricato automaticamente. SET_IDLE_TIMEOUT \u00b6 SET_IDLE_TIMEOUT [TIMEOUT=<timeout>] : consente all'utente di impostare il timeout di inattivit\u00e0 (in secondi). [input_shaper] \u00b6 Il comando seguente \u00e8 abilitato se \u00e8 stata abilitata una sezione di configurazione di input_shaper (consultare anche la guida alla compensazione della risonanza ). SET_INPUT_SHAPER \u00b6 SET_INPUT_SHAPER [SHAPER_FREQ_X=<shaper_freq_x>] [SHAPER_FREQ_Y=<shaper_freq_y>] [DAMPING_RATIO_X=<damping_ratio_x>] [DAMPING_RATIO_Y=<damping_ratio_y>] [SHAPER_TYPE=<shaper>] [SHAPER_TYPE_X=<shaper_type_x>] [SHAPER_TYPE=<shaper_TYPE_X=<shaper_type_x>] [SHAPER_TYPE=<shaper_type_y=<shaper_type_x> ] : Modifica i parametri dell'input shaper. Si noti che il parametro SHAPER_TYPE reimposta l'input shaper per entrambi gli assi X e Y anche se sono stati configurati tipi di shaper diversi nella sezione [input_shaper]. SHAPER_TYPE non pu\u00f2 essere utilizzato insieme a uno dei parametri SHAPER_TYPE_X e SHAPER_TYPE_Y. Vedere config reference per maggiori dettagli su ciascuno di questi parametri. [manual_probe] \u00b6 Il modulo manual_probe viene caricato automaticamente. MANUAL_PROBE \u00b6 MANUAL_PROBE [SPEED=<speed>] : esegue uno script di supporto utile per misurare l'altezza dell'ugello in una determinata posizione. Se viene specificato SPEED, imposta la velocit\u00e0 dei comandi TESTZ (il valore predefinito \u00e8 5mm/s). Durante una sonda manuale, sono disponibili i seguenti comandi aggiuntivi: ACCEPT : questo comando accetta la posizione Z corrente e conclude il probing manuale. ABORT : questo comando termina lo strumento di probing manuale. TESTZ Z=<valore> : questo comando sposta l'ugello verso l'alto o verso il basso della quantit\u00e0 specificata in \"valore\". Ad esempio, TESTZ Z=-.1 sposterebbe l'ugello verso il basso di .1 mm mentre TESTZ Z=.1 sposterebbe l'ugello verso l'alto di .1 mm. Il valore pu\u00f2 anche essere + , - , ++ o -- per spostare l'ugello verso l'alto o verso il basso di un importo rispetto ai tentativi precedenti. Z_ENDSTOP_CALIBRATE \u00b6 Z_ENDSTOP_CALIBRATE [SPEED=<speed>] : esegue uno script di supporto utile per calibrare un'impostazione di configurazione Z position_endstop. Vedere il comando MANUAL_PROBE per i dettagli sui parametri e sui comandi aggiuntivi disponibili mentre lo strumento \u00e8 attivo. Z_OFFSET_APPLY_ENDSTOP \u00b6 Z_OFFSET_APPLY_ENDSTOP : prende l'offset Z Gcode corrente (noto anche come babystepping) e lo sottrae da stepper_z endstop_position. Questa azione per prendere un valore di babystep utilizzato di frequente e \"renderlo permanente\". Richiede un SAVE_CONFIG per avere effetto. [Stepper manuali] \u00b6 Il comando seguente \u00e8 disponibile quando una sezione di configurazione stepper_manuale \u00e8 abilitata. MANUAL_STEPPER \u00b6 MANUAL_STEPPER STEPPER=nome_config [ENABLE=[0|1]] [SET_POSITION=<pos>] [SPEED=<velocit\u00e0>] [ACCEL=<accelerazione>] [MOVE=<pos> [STOP_ON_ENDSTOP=[1|2|- 1|-2]] [SYNC=0]] : Questo comando alterer\u00e0 lo stato dello stepper. Utilizzare il parametro ENABLE per abilitare/disabilitare lo stepper. Utilizzare il parametro SET_POSITION per forzare lo stepper a pensare di trovarsi nella posizione data. Utilizzare il parametro MOVE per richiedere un movimento alla posizione data. Se viene specificato SPEED e/o ACCEL, verranno utilizzati i valori forniti al posto dei valori predefiniti specificati nel file di configurazione. Se viene specificato un ACCEL pari a zero, non verr\u00e0 eseguita alcuna accelerazione. Se viene specificato STOP_ON_ENDSTOP=1, lo spostamento terminer\u00e0 in anticipo se l'endstop segnala come attivato (usa STOP_ON_ENDSTOP=2 per completare lo spostamento senza errori anche se l'endstop non si attiva, usa -1 o -2 per interrompere quando l'endstop segnala non innescato). Normalmente i futuri comandi G-Code verranno programmati per essere eseguiti dopo il completamento del movimento passo-passo, tuttavia se un movimento passo-passo manuale utilizza SYNC=0, i futuri comandi di movimento G-Code potrebbero essere eseguiti in parallelo con il movimento passo-passo. [mcp4018] \u00b6 Il comando seguente \u00e8 disponibile quando una sezione di configurazione mcp4018 \u00e8 abilitata. SET_DIGIPOT \u00b6 SET_DIGIPOT DIGIPOT=config_name WIPER=<value> : Questo comando cambier\u00e0 il valore corrente del digipot. Questo valore dovrebbe essere in genere compreso tra 0.0 e 1.0, a meno che non sia definita una 'scale' nella configurazione. Quando viene definita 'scale', questo valore dovrebbe essere compreso tra 0,0 e 'scale'. [led] \u00b6 Il comando seguente \u00e8 disponibile quando una qualsiasi delle sezioni di configurazione led \u00e8 abilitata. SET_LED \u00b6 SET_LED LED=<nome_config> ROSSO=<valore> VERDE=<valore> BLU=<valore> BIANCO=<valore> [INDEX=<indice>] [TRANSMIT=0] [SYNC=1] : Imposta il LED in output. Ogni colore <valore> deve essere compreso tra 0,0 e 1,0. L'opzione BIANCO \u00e8 valida solo su LED RGBW. Se il LED supporta pi\u00f9 chip in una catena daisy-chain, \u00e8 possibile specificare INDEX per modificare il colore del solo chip specificato (1 per il primo chip, 2 per il secondo, ecc.). Se INDEX non viene fornito, tutti i LED nella catena verranno impostati sul colore fornito. Se viene specificato TRANSMIT=0, il cambio colore verr\u00e0 effettuato solo sul successivo comando SET_LED che non specifica TRANSMIT=0; questo pu\u00f2 essere utile in combinazione con il parametro INDEX per raggruppare pi\u00f9 aggiornamenti in una catena. Per impostazione predefinita, il comando SET_LED sincronizzer\u00e0 le modifiche con altri comandi gcode in corso. Ci\u00f2 pu\u00f2 comportare un comportamento indesiderato se i LED vengono impostati mentre la stampante non sta stampando in quanto reimposta il timeout di inattivit\u00e0. Se non \u00e8 necessaria una tempistica attenta, \u00e8 possibile specificare il parametro SYNC=0 opzionale per applicare le modifiche senza ripristinare il timeout di inattivit\u00e0. SET_LED_TEMPLATE \u00b6 SET_LED_TEMPLATE LED=<nome_led> TEMPLATE=<nome_modello> [<param_x>=<letterale>] [INDEX=<indice>] : Assegna un modello_visualizzazione a un dato LED . Ad esempio, se si definisce una sezione di configurazione [display_template my_led_template] allora si potrebbe assegnare TEMPLATE=my_led_template qui. Il display_template dovrebbe produrre una stringa separata da virgole contenente quattro numeri in virgola mobile corrispondenti alle impostazioni dei colori rosso, verde, blu e bianco. Il modello verr\u00e0 continuamente valutato e il LED verr\u00e0 impostato automaticamente sui colori risultanti. \u00c8 possibile impostare i parametri display_template da utilizzare durante la valutazione del modello (i parametri verranno analizzati come valori letterali Python). Se INDEX non \u00e8 specificato, tutti i chip nella catena dei LED verranno impostati sul modello, altrimenti verr\u00e0 aggiornato solo il chip con l'indice specificato. Se TEMPLATE \u00e8 una stringa vuota, questo comando canceller\u00e0 qualsiasi modello precedente assegnato al LED (\u00e8 quindi possibile utilizzare i comandi SET_LED per gestire le impostazioni del colore del LED). [output_pin] \u00b6 Il comando seguente \u00e8 disponibile quando una sezione di configurazione pin_output \u00e8 abilitata. SET_PIN \u00b6 SET_PIN PIN=config_name VALUE=<value> [CYCLE_TIME=<cycle_time>] : Imposta il pin sull'output VALUE . VALUE dovrebbe essere 0 o 1 per i pin di uscita \"digital\". Per i pin PWM, impostare su un valore compreso tra 0.0 e 1.0 o tra 0.0 e scale se \u00e8 configurata una scala nella sezione di configurazione output_pin. Alcuni pin (attualmente solo pin \"soft PWM\") supportano l'impostazione di un tempo di ciclo esplicito utilizzando il parametro CYCLE_TIME (specificato in secondi). Si noti che il parametro CYCLE_TIME non \u00e8 memorizzato tra i comandi SET_PIN (qualsiasi comando SET_PIN senza un parametro CYCLE_TIME esplicito utilizzer\u00e0 il cycle_time specificato nella sezione di configurazione output_pin). [palette2] \u00b6 I seguenti comandi sono disponibili quando la sezione di configurazione della palette2 \u00e8 abilitata. Le stampe di Palette funzionano incorporando speciali OCodes (Codici Omega) nel file GCode: O1 ... O32 : Questi codici vengono letti dal flusso GCode ed elaborati da questo modulo e passati al dispositivo Palette 2. Sono inoltre disponibili i seguenti comandi aggiuntivi. PALETTE_CONNECT \u00b6 PALETTE_CONNECT : questo comando inizializza la connessione con la Palette 2. PALETTE_DISCONNECT \u00b6 PALETTE_DISCONNECT : questo comando si disconnette dalla Palette 2. PALETTE_CLEAR \u00b6 PALETTE_CLEAR : questo comando indica alla Palette 2 di cancellare tutti i percorsi di input e output del filamento. PALETTE_CUT \u00b6 PALETTE_CUT : Questo comando indica alla Palette 2 di tagliare il filamento attualmente caricato nello splice core. PALETTE_SMART_LOAD \u00b6 PALETTE_SMART_LOAD : Questo comando avvia la sequenza di caricamento intelligente sulla Palette 2. Il filamento viene caricato automaticamente estrudendolo alla distanza calibrata sul dispositivo per la stampante e istruisce la Palette 2 una volta completato il caricamento. Questo comando equivale a premere Smart Load direttamente sullo schermo della Palette 2 dopo che il caricamento del filamento \u00e8 stato completato. [pid_calibrate] \u00b6 Il modulo pid_calibrate viene caricato automaticamente se nel file di configurazione \u00e8 definito un riscaldatore. PID_CALIBRATE \u00b6 PID_CALIBRATE HEATER=<nome_config> TARGET=<temperatura> [WRITE_FILE=1] : esegue un test di calibrazione PID. Il riscaldatore specificato verr\u00e0 abilitato fino al raggiungimento della temperatura target specificata, quindi il riscaldatore verr\u00e0 spento e acceso per diversi cicli. Se il parametro WRITE_FILE \u00e8 abilitato, verr\u00e0 creato il file /tmp/heattest.txt con un log di tutti i campioni di temperatura prelevati durante il test. [pause_resume] \u00b6 I seguenti comandi sono disponibili quando la pause_resume config section \u00e8 abilitata: PAUSE \u00b6 PAUSE : mette in pausa la stampa corrente. La posizione attuale viene acquisita per la ripresa al ripristino. RESUME \u00b6 RESUME [VELOCITY=<value>] : riprende la stampa da una pausa, ripristinando prima la posizione precedentemente acquisita. Il parametro VELOCITY determina la velocit\u00e0 alla quale l'utensile deve tornare alla posizione originale acquisita. CLEAR_PAUSE \u00b6 CLEAR_PAUSE : cancella lo stato di pausa corrente senza riprendere la stampa. Questo \u00e8 utile se si decide di annullare una stampa dopo un PAUSE. Si consiglia di aggiungerlo al gcode iniziale per assicurarsi che lo stato in pausa sia aggiornato per ogni stampa. CANCEL_PRINT \u00b6 CANCEL_PRINT : Annulla la stampa corrente. [print_stats] \u00b6 Il modulo print_stats viene caricato automaticamente. SET_PRINT_STATS_INFO \u00b6 SET_PRINT_STATS_INFO [TOTAL_LAYER=<total_layer_count>] [CURRENT_LAYER= <current_layer>] : passa le informazioni sulo slicer come il layer attivo ed il totale a Klipper. Aggiungi SET_PRINT_STATS_INFO [TOTAL_LAYER=<total_layer_count>] alla sezione gcode di inizio del tuo slicer e SET_PRINT_STATS_INFO [CURRENT_LAYER= <current_layer>] alla sezione gcode di cambio livello per passare le informazioni sul livello dal tuo slicer a Klipper. [probe] \u00b6 I seguenti comandi sono disponibili quando \u00e8 abilitata una sezione di configurazione della sonda o una sezione di configurazione di bltouch (consultare anche la guida alla calibrazione della sonda ). sonda \u00b6 PROBE [PROBE_SPEED=<mm/s>] [LIFT_SPEED=<mm/s>] [SAMPLES=<count>] [SAMPLE_RETRACT_DIST=<mm>] [SAMPLES_TOLERANCE=<mm>] [SAMPLES_TOLERANCE_RETRIES=<count>] [SAMPLES_RESULT=median|average] : Sposta il nozzle verso il basso finch\u00e9 la sonda non scatta. Se viene fornito uno qualsiasi dei parametri opzionali, sovrascrive l'impostazione equivalente nella sezione probe config section . QUERY_PROBE \u00b6 QUERY_PROBE : Riporta lo stato corrente della sonda (\"triggered\" o \"open\"). PROBE_ACCURACY \u00b6 PROBE_ACCURACY [PROBE_SPEED=<mm/s>] [SAMPLES=<count>] [SAMPLE_RETRACT_DIST=<mm>] : Calcola la deviazione massima, minima, media, mediana e standard di pi\u00f9 campionamentidella sonda. Per impostazione predefinita, vengono presi 10 CAMPIONI. In caso contrario, i parametri opzionali sono impostati per default sulla loro impostazione equivalente nella sezione di configurazione della sonda. PROBE_CALIBRATE \u00b6 PROBE_CALIBRATE [SPEED=<speed>] [<probe_parameter>=<value>] : Eseguire uno script di aiuto utile per calibrare l'offset z della sonda. Vedere il comando PROBE per i dettagli sui parametri opzionali della sonda. Vedere il comando MANUAL_PROBE per i dettagli del parametro SPEED e sui comandi aggiuntivi disponibili mentre lo strumento \u00e8 attivo. Nota che il comando PROBE_CALIBRATE utilizza la variabile di velocit\u00e0 per spostarsi in direzione XY e Z. Z_OFFSET_APPLY_PROBE \u00b6 Z_OFFSET_APPLY_PROBE : prende l'offset Z Gcode corrente (aka, babystepping) e lo sottrae dallo z_offset della sonda. Questo per prendere un valore di babystep utilizzato di frequente e \"renderlo permanente\". Richiede un SAVE_CONFIG per avere effetto. [query_adc] \u00b6 Il modulo query_adc viene caricato automaticamente. QUERY_ADC \u00b6 QUERY_ADC [NAME=<config_name>] [PULLUP=<value>] : Riporta l'ultimo valore analogico ricevuto per un pin analogico configurato. Se NAME non viene fornito, viene riportato l'elenco dei nomi dei convertitori adc disponibili. Se viene fornito PULLUP (come valore in Ohm), viene riportato il valore analogico grezzo insieme alla resistenza equivalente dato quel pullup specificato. [query_endstops] \u00b6 Il modulo query_endstops viene caricato automaticamente. I seguenti comandi G-Code standard sono attualmente disponibili, ma non \u00e8 consigliabile utilizzarli: Ottieni lo stato del finecorsa: M119 (usa invece QUERY_ENDSTOPS.) QUERY_ENDSTOPS \u00b6 QUERY_ENDSTOPS : Rilevare i finecorsa degli assi e segnala se sono \"attivate\" o in uno stato \"aperto\". Questo comando viene in genere utilizzato per verificare che un finecorsa funzioni correttamente. [resonance_tester] \u00b6 I seguenti comandi sono disponibili quando una sezione di configurazione di tester_risonanza \u00e8 abilitata (consultare anche la guida alle risonanze di misurazione ). MEASURE_AXES_NOISE \u00b6 MEASURE_AXES_NOISE : misura ed riporta il rumore per tutti gli assi di tutti i chip dell'accelerometro abilitati. TEST_RESONANCES \u00b6 TEST_RESONANCES AXIS=<asse> OUTPUT=<risonanze,dati_grezzi> [NAME=<nome>] [FREQ_START=<freq_min>] [FREQ_END=<freq_max>] [HZ_PER_SEC=<hz_per_sec>] [CHIPS=<adxl345_chip_name>] [ POINT=x,y,z] [INPUT_SHAPING=[<0:1>]] : esegue il test di risonanza in tutti i punti sonda configurati per l'\"asse\" richiesto e misura l'accelerazione utilizzando i chip dell'accelerometro configurati per il rispettivo asse. \"asse\" pu\u00f2 essere X o Y, oppure specificare una direzione arbitraria come AXIS=dx,dy , dove dx e dy sono numeri in virgola mobile che definiscono un vettore di direzione (es. AXIS=X , AXIS=Y , o AXIS=1,-1 per definire una direzione diagonale). Nota che AXIS=dx,dy e AXIS=-dx,-dy sono equivalenti. adxl345_chip_name pu\u00f2 essere uno o pi\u00f9 chip adxl345 configurati, delimitati da virgole, ad esempio CHIPS=\"adxl345, adxl345 rpi\" . Nota che adxl345 pu\u00f2 essere omesso dai chip adxl345 denominati. Se POINT \u00e8 specificato, sovrascriver\u00e0 i punti configurati in [resonance_tester] . Se INPUT_SHAPING=0 o non impostato (predefinito), disabilita l'input shaping per il test di risonanza, perch\u00e9 non \u00e8 valido eseguire il test di risonanza con input shaper abilitato. Il parametro OUTPUT \u00e8 un elenco separato da virgole di cui verranno scritti gli output. Se viene richiesto raw_data , i dati grezzi dell'accelerometro vengono scritti in un file o in una serie di file /tmp/raw_data_<asse>_[<nome_chip>_][<punto>_]<nome>.csv con ( <punto>_ parte del nome generata solo se \u00e8 configurato pi\u00f9 di 1 punto sonda o \u00e8 specificato PUNTO). Se viene specificato resonances , la risposta in frequenza viene calcolata (su tutti i punti sonda) e scritta nel file /tmp/resonances_<asse>_<nome>.csv . Se non \u00e8 impostato, OUTPUT \u00e8 impostato su risonanze e NAME \u00e8 impostato sull'ora corrente nel formato \"AAAAMMGG_HHMMSS\". SHAPER_CALIBRATE \u00b6 SHAPER_CALIBRATE [AXIS=<asse>] [NAME=<nome>] [FREQ_START=<freq_min>] [FREQ_END=<freq_max>] [HZ_PER_SEC=<hz_per_sec>] [MAX_SMOOTHING=<livellamento_max>] : simile a TEST_RESONANCES , esegue il test di risonanza come configurato e cerca di trovare i parametri ottimali di input shaper per l'asse richiesto (o entrambi gli assi X e Y se il parametro AXIS non \u00e8 impostato). Se MAX_SMOOTHING non \u00e8 impostato, il suo valore viene preso dalla sezione [resonance_tester] , con l'impostazione predefinita non impostata. Per ulteriori informazioni sull'uso di questa funzione, vedere il Max smoothing della guida alla misurazione delle risonanze. I risultati dell'ottimizzazione vengono stampati sulla console e le risposte in frequenza e i diversi valori degli shaper di input vengono scritti in uno o pi\u00f9 file CSV /tmp/calibration_data_<asse>_<nome>.csv . A meno che non sia specificato, NAME imposta l'ora corrente nel formato \"AAAAMMGG_HHMMSS\". Nota che i parametri di input shaper suggeriti possono essere mantenuti nella configurazione eseguendo il comando SAVE_CONFIG . [respond] \u00b6 I seguenti comandi G-Code standard sono disponibili quando la sezione di configurazione di risposta \u00e8 abilitata: M118 <messaggio> : fa eco al messaggio preceduto dal prefisso predefinito configurato (o echo: se non \u00e8 configurato alcun prefisso). Sono inoltre disponibili i seguenti comandi aggiuntivi. RESPOND \u00b6 RESPOND MSG=\"<message>\" : echo il messaggio preceduto dal prefisso predefinito configurato (o echo: se non \u00e8 configurato alcun prefisso). RESPOND TYPE=echo MSG=\"<message>\" : echo del messaggio preceduto da echo: . RESPOND TYPE=echo_no_space MSG=\"<messaggio>\" : fa eco al messaggio preceduto da echo: senza uno spazio tra prefisso e messaggio, utile per la compatibilit\u00e0 con alcuni plugin di octoprint che prevedono una formattazione molto specifica. RESPOND TYPE=command MSG=\"<message>\" : echo il messaggio preceduto da // . OctoPrint pu\u00f2 essere configurato per rispondere a questi messaggi (ad es. RESPOND TYPE=command MSG=action:pause ). RESPOND TYPE=error MSG=\"<messaggio>\" : fa eco al messaggio preceduto da !! . RESPOND PREFIX=<prefix> MSG=\"<message>\" : echo il messaggio preceduto da <prefix> . (Il parametro PREFIX avr\u00e0 la priorit\u00e0 sul parametro TYPE ) [save_variables] \u00b6 Il comando seguente \u00e8 abilitato se \u00e8 stata abilitata una sezione di configurazione save_variables . SAVE_VARIABLE \u00b6 SAVE_VARIABLE VARIABLE=<nome> VALUE=<valore> : salva la variabile su disco in modo che possa essere utilizzata tra i riavvii. Tutte le variabili memorizzate vengono caricate nel dict printer.save_variables.variables all'avvio e possono essere utilizzate nelle macro gcode. Il VALUE fornito viene analizzato come un valore letterale Python. [screws_tilt_adjust] \u00b6 I seguenti comandi sono disponibili quando la sezione di configurazione viti_tilt_adjust \u00e8 abilitata (consultare anche la manual level guide ). SCREWS_TILT_CALCULATE \u00b6 SCREWS_TILT_CALCULATE [DIRECTION=CW|CCW] [MAX_DEVIATION=<value>] [<probe_parameter>=<value>] : Questo comando richiamer\u00e0 lo strumento di regolazione delle viti del piatto. Comander\u00e0 l'ugello in diverse posizioni (come definito nel file di configurazione) sondando l'altezza z e calcoler\u00e0 il numero di giri della manopola per regolare il livello del piatto. Se si specifica DIRECTION, le rotazioni della manopola saranno tutte nella stessa direzione, in senso orario (CW) o in senso antiorario (CCW). Vedere il comando PROBE per i dettagli sui parametri della sonda opzionali. IMPORTANTE: DEVI sempre eseguire un G28 prima di utilizzare questo comando. Se viene specificato MAX_DEVIATION, il comando generer\u00e0 un errore gcode se qualsiasi differenza nell'altezza della vite rispetto all'altezza della vite di base \u00e8 maggiore del valore fornito. [sdcard_loop] \u00b6 Quando la sezione di configurazione sdcard_loop \u00e8 abilitata, sono disponibili i seguenti comandi estesi. SDCARD_LOOP_BEGIN \u00b6 SDCARD_LOOP_BEGIN COUNT=<count> : inizia una sezione in loop nella stampa SD. Un conteggio pari a 0 indica che la sezione deve essere ripetuta indefinitamente. SDCARD_LOOP_END \u00b6 SDCARD_LOOP_END : termina una sezione in loop nella stampa SD. SDCARD_LOOP_DESIST \u00b6 SDCARD_LOOP_DESIST : completa i loop esistenti senza ulteriori iterazioni. [servo] \u00b6 I seguenti comandi sono disponibili quando una sezione di configurazione servo \u00e8 abilitata. SET_SERVO \u00b6 SET_SERVO SERVO=nome_config [ANGLE=<gradi> | WIDTH=<secondi>] : Imposta la posizione del servo sull'angolo dato (in gradi) o sulla larghezza dell'impulso (in secondi). Usa WIDTH=0 per disabilitare l'uscita servo. [skew_correction] \u00b6 I seguenti comandi sono disponibili quando \u00e8 abilitata la sezione config_correzione_asimmetria (consultare anche la guida Correzione_asimmetria ). SET_SKEW \u00b6 SET_SKEW [XY=<ac_length,bd_length,ad_length>] [XZ=<ac,bd,ad>] [YZ=<ac,bd,ad>] [CLEAR=<0|1>] : Configura il modulo [correzione_inclinazione ] con misure (in mm) tratte da una stampa di calibrazione. Si possono inserire misure per qualsiasi combinazione di piani, i piani non inseriti manterranno il loro valore attuale. Se viene immesso CLEAR=1 , tutta la correzione dell'inclinazione sar\u00e0 disabilitata. GET_CURRENT_SKEW \u00b6 GET_CURRENT_SKEW : Riporta l'inclinazione corrente della stampante per ciascun piano sia in radianti che in gradi. L'inclinazione viene calcolata in base ai parametri forniti tramite il gcode SET_SKEW . CALC_MEASURED_SKEW \u00b6 CALC_MEASURED_SKEW [AC=<ac_length>] [BD=<bd_length>] [AD=<ad_length>] : calcola e riporta l'inclinazione (in radianti e gradi) in base a una stampa di test misurata. Questo pu\u00f2 essere utile per determinare l'inclinazione corrente della stampante dopo che \u00e8 stata applicata la correzione. Pu\u00f2 anche essere utile prima di applicare la correzione per determinare se \u00e8 necessaria la correzione dell'inclinazione. Vedere Correzione inclinazione per i dettagli su oggetti e misurazioni di calibrazione inclinazione. SKEW_PROFILE \u00b6 SKEW_PROFILE [LOAD=<nome>] [SAVE=<nome>] [REMOVE=<nome>] : Gestione del profilo per correzione_inclinazione. LOAD ripristiner\u00e0 lo stato di inclinazione dal profilo corrispondente al nome fornito. SAVE salver\u00e0 lo stato di inclinazione corrente in un profilo che corrisponde al nome fornito. REMOVE eliminer\u00e0 il profilo corrispondente al nome fornito dalla memoria persistente. Si noti che dopo aver eseguito le operazioni SAVE o REMOVE \u00e8 necessario eseguire il gcode SAVE_CONFIG per rendere permanenti le modifiche alla memoria persistente. [smart_effector] \u00b6 Sono disponibili diversi comandi quando una sezione di configurazione smart_effector \u00e8 abilitata. Assicurati di controllare la documentazione ufficiale per Smart Effector su Duet3D Wiki prima di modificare i parametri di Smart Effector. Controllare anche la guida alla calibrazione della sonda . SET_SMART_EFFECTOR \u00b6 SET_SMART_EFFECTOR [SENSITIVITY=<sensibilit\u00e0>] [ACCEL=<accel>] [RECOVERY_TIME=<tempo>] : imposta i parametri di Smart Effector. Quando viene specificato SENSITIVITY , il rispettivo valore viene scritto nella EEPROM dello SmartEffector (richiede che sia fornito control_pin ). I valori di <sensibilit\u00e0> accettabili sono 0..255, il valore predefinito \u00e8 50. Valori inferiori richiedono una minore forza di contatto dell'ugello per attivarsi (ma esiste un rischio maggiore di falso trigger a causa delle vibrazioni durante la tastatura) e valori pi\u00f9 alti riducono il falso trigger (ma richiede una maggiore forza di contatto per attivarsi). Poich\u00e9 la sensibilit\u00e0 viene scritta nella EEPROM, viene conservata dopo lo spegnimento e quindi non \u00e8 necessario configurarla ad ogni avvio della stampante. ACCEL e RECOVERY_TIME consentono di sovrascrivere i parametri corrispondenti in fase di esecuzione, vedere la sezione di configurazione di Smart Effector per maggiori informazioni su quei parametri. RESET_SMART_EFFECTOR \u00b6 RESET_SMART_EFFECTOR : Ripristina la sensibilit\u00e0 di Smart Effector alle impostazioni di fabbrica. Richiede che il relativo control_pin sia fornito nella sezione di configurazione. [stepper_enable] \u00b6 Il modulo stepper_enable viene caricato automaticamente. SET_STEPPER_ENABLE \u00b6 SET_STEPPER_ENABLE STEPPER=<nome_config> ENABLE=[0|1] : Abilita o disabilita solo lo stepper dato. Questo \u00e8 uno strumento diagnostico e di debug e deve essere utilizzato con cautela. La disabilitazione di un motore dell'asse non ripristina le informazioni di homing. Lo spostamento manuale di uno stepper disabilitato pu\u00f2 causare l'azionamento del motore della macchina al di fuori dei limiti di sicurezza. Ci\u00f2 pu\u00f2 causare danni ai componenti dell'asse, al hotend e alla superficie di stampa. [temperature_fan] \u00b6 Il comando seguente \u00e8 disponibile quando una sezione di configurazione della ventola_temperatura \u00e8 abilitata. SET_TEMPERATURE_FAN_TARGET \u00b6 SET_TEMPERATURE_FAN_TARGET temperature_fan=<temperature_fan_name> [target=<target_temperature>] [min_speed=<min_speed>] [max_speed=<max_speed>] : Imposta la temperatura target per una temperature_fan. Se non viene fornito un target, viene impostato sulla temperatura specificata nel file di configurazione. Se le velocit\u00e0 non vengono fornite, non viene applicata alcuna modifica. [tmcXXXX] \u00b6 I seguenti comandi sono disponibili quando una qualsiasi delle tmcXXXX config section \u00e8 abilitata. DUMP_TMC \u00b6 DUMP_TMC STEPPER=<nome> : questo comando legger\u00e0 i registri del driver TMC e ne riporter\u00e0 i valori. INIT_TMC \u00b6 INIT_TMC STEPPER=<nome> : questo comando inizializzer\u00e0 i registri TMC. Necessario per riattivare il driver se l'alimentazione al chip viene spenta e poi riaccesa. SET_TMC_CURRENT \u00b6 SET_TMC_CURRENT STEPPER=<nome> CURRENT=<amps> HOLDCURRENT=<amps> : Questo regoler\u00e0 le correnti di funzionamento e di mantenimento del driver TMC. (HOLDCURRENT non \u00e8 applicabile ai driver tmc2660.) SET_TMC_FIELD \u00b6 SET_TMC_FIELD STEPPER=<nome> FIELD=<campo> VALUE=<valore> : Questo alterer\u00e0 il valore del campo del registro specificato del driver TMC. Questo comando \u00e8 destinato alla diagnostica e al debug di basso livello solo perch\u00e9 la modifica dei campi durante l'esecuzione pu\u00f2 causare comportamenti indesiderati e potenzialmente pericolosi della stampante. Le modifiche permanenti dovrebbero invece essere apportate utilizzando il file di configurazione della stampante. Non vengono eseguiti controlli di integrit\u00e0 per i valori indicati. [toolhead] \u00b6 Il modulo toolhead viene caricato automaticamente. SET_VELOCITY_LIMIT \u00b6 SET_VELOCITY_LIMIT [VELOCITY=<valore>] [ACCEL=<valore>] [ACCEL_TO_DECEL=<valore>] [SQUARE_CORNER_VELOCITY=<valore>] : Modifica i limiti di velocit\u00e0 della stampante. [tuning_tower] \u00b6 Il modulo tuning_tower viene caricato automaticamente. TUNING_TOWER \u00b6 TUNING_TOWER COMMAND=<comando> PARAMETER=<nome> START=<valore> [SKIP=<valore>] [FACTOR=<valore> [BAND=<valore>]] | [STEP_DELTA=<valore> STEP_HEIGHT=<valore>] : Uno strumento per regolare un parametro su ciascuna altezza Z durante una stampa. Lo strumento eseguir\u00e0 il dato COMMAND con il dato PARAMETER assegnato a un valore che varia con Z secondo una formula. Usa FACTOR se utilizzerai un righello o calibri per misurare l'altezza Z del valore ottimale, o STEP_DELTA e STEP_HEIGHT se il modello della torre di regolazione ha bande di valori discreti come \u00e8 comune con le torri della temperatura. Se viene specificato SKIP=<valore> , il processo di ottimizzazione non inizia finch\u00e9 non viene raggiunta l'altezza Z <valore> , e al di sotto di essa il valore sar\u00e0 impostato su START ; in questo caso, la z_height usata nelle formule seguenti \u00e8 in realt\u00e0 max(z - skip, 0) . Ci sono tre possibili combinazioni di opzioni: FACTOR : Il valore cambia a una velocit\u00e0 di factor per millimetro. La formula utilizzata \u00e8: valore = inizio + fattore * z_altezza . \u00c8 possibile inserire l'altezza Z ottimale direttamente nella formula per determinare il valore del parametro ottimale. FACTOR e BAND : il valore cambia a una velocit\u00e0 media di factor per millimetro, ma in bande discrete in cui la regolazione verr\u00e0 effettuata solo ogni BAND millimetri di altezza Z. La formula utilizzata \u00e8: value = start + factor * ((floor(z_height / band) + .5) * band) . STEP_DELTA e STEP_HEIGHT : il valore cambia di STEP_DELTA ogni STEP_HEIGHT millimetri. La formula utilizzata \u00e8: value = start + step_delta * floor(z_height / step_height) . Puoi semplicemente contare le bande o leggere le etichette della torre di tuning per determinare il valore ottimale. [virtual_sdcard] \u00b6 Klipper supporta i seguenti comandi G-Code standard se la sezione di configurazione di virtual_sdcard \u00e8 abilitata: Elenco scheda SD: M20 Inizializza scheda SD: M21 Selezionare il file SD: M23 <nomefile> Avvia/riprendi la stampa SD: M24 Sospendi la stampa SD: M25 Impostare la posizione SD: M26 S<offset> Riporta lo stato di stampa SD: M27 Inoltre, quando la sezione di configurazione \"virtual_sdcard\" \u00e8 abilitata, sono disponibili i seguenti comandi estesi. SDCARD_PRINT_FILE \u00b6 SDCARD_PRINT_FILE FILENAME=<nomefile> : carica un file e avvia la stampa SD. SDCARD_RESET_FILE \u00b6 SDCARD_RESET_FILE : Scarica il file e cancella lo stato SD. [z_thermal_adjust] \u00b6 I seguenti comandi sono disponibili quando la sezione z_thermal_adjust config \u00e8 abilitata. SET_Z_THERMAL_ADJUST \u00b6 SET_Z_THERMAL_ADJUST [ENABLE=<0:1>] [TEMP_COEFF=<valore>] [REF_TEMP=<valore>] : Abilita o disabilita la regolazione termica Z con ENABLE . La disabilitazione non rimuove alcuna regolazione gi\u00e0 applicata, ma congela il valore di regolazione corrente - questo impedisce il movimento Z verso il basso potenzialmente pericoloso. La riattivazione pu\u00f2 potenzialmente causare il movimento dell'utensile verso l'alto quando la regolazione viene aggiornata e applicata. TEMP_COEFF consente la regolazione in tempo reale del coefficiente di temperatura di regolazione (cio\u00e8 il parametro di configurazione TEMP_COEFF ). I valori TEMP_COEFF non vengono salvati nella configurazione. REF_TEMP sovrascrive manualmente la temperatura di riferimento tipicamente impostata durante l'homing (per l'uso, ad esempio, in routine di homing non standard) - verr\u00e0 ripristinata automaticamente durante l'homing. [z_tilt] \u00b6 I seguenti comandi sono disponibili quando la sezione z_tilt config \u00e8 abilitata. Z_TILT_ADJUST \u00b6 Z_TILT_ADJUST [<probe_parameter>=<value>] : questo comando sonder\u00e0 i punti specificati nella configurazione e quindi apporter\u00e0 regolazioni indipendenti a ciascuno Z stepper per compensare l'inclinazione. Vedere il comando PROBE per i dettagli sui parametri opzionali della sonda.","title":"G-Codes"},{"location":"G-Codes.html#g-codes","text":"Questo documento descrive i comandi che Klipper supporta. Questi sono i comandi che si possono inserire nella scheda del terminale OctoPrint.","title":"G-Codes"},{"location":"G-Codes.html#comandi-g-code","text":"Klipper supporta i seguenti comandi G-Code standard: Movimento (G0 or G1): G1 [X<pos>] [Y<pos>] [Z<pos>] [E<pos>] [F<speed>] Sosta: G4 P<millisecondi> Sposta all'origine: G28 [X] [Y] [Z] Spegnere i motori: M18 o M84 Attendi che li movimenti correnti finiscano: M400 Utilizzare distanze assolute/relative per l'estrusione: M82 , M83 Usa coordinate assolute/relative: G90 , G91 Impostare la posizione: G92 [X<pos>] [Y<pos>] [Z<pos>] [E<pos>] Impostare la percentuale di override del fattore di velocit\u00e0: M220 S<percentuale> Imposta la percentuale di sostituzione del fattore di estrusione: M221 S<percentuale> Impostare l'accelerazione: M204 S<valore> OPPURE M204 P<valore> T<valore> Nota: se S non viene specificato e vengono specificati sia P che T, l'accelerazione viene impostata al minimo di P e T. Se viene specificato solo uno di P o T, il comando non ha effetto. Ottieni la temperatura dell'estrusore: M105 Imposta la temperatura dell'estrusore: M104 [T<index>] [S<temperatura>] Imposta la temperatura dell'estrusore e attende: M109 [T<index>] S<temperatura> Nota: M109 attende sempre che la temperatura si assesti al valore richiesto Imposta la temperatura del piatto: M140 [S<temperatura>] Imposta la temperatura del piatto e attende: M190 S<temperatura> Nota: M190 attende sempre che la temperatura si assesti al valore richiesto Imposta la velocit\u00e0 della ventola: M106 S<valore> Spegnere la ventola: M107 Arresto di emergenza: M112 Ottieni la posizione attuale: M114 Ottieni la versione del firmware: M115 Per ulteriori dettagli sui comandi precedenti, vedere la documentazione RepRap G-Code . L'obiettivo di Klipper \u00e8 supportare i comandi G-Code prodotti da comuni software di terze parti (ad es. OctoPrint, Printrun, Slic3r, Cura, ecc.) nelle loro configurazioni standard. Non \u00e8 un obiettivo supportare ogni possibile comando G-Code. Invece, Klipper preferisce comandi leggibili dall'uomo \"comandi G-Code estesi\" . Allo stesso modo, l'output del terminale G-Code \u00e8 inteso solo per essere leggibile dall'uomo - vedere il documento del server API se si controlla Klipper da un software esterno. Se si necessita di un comando G-Code meno comune, potrebbe essere possibile implementarlo con una [sezione di configurazione gcode_macro] personalizzata (Config_Reference.md#gcode_macro). Ad esempio, si potrebbe usare questo per implementare: G12 , G29 , G30 , G31 , M42 , M80 , M81 , T1 , ecc.","title":"Comandi G-Code"},{"location":"G-Codes.html#comandi-aggiuntivi","text":"Klipper utilizza comandi G-Code \"estesi\" per la configurazione e lo stato generale. Questi comandi estesi seguono tutti un formato simile: iniziano con un nome di comando e possono essere seguiti da uno o pi\u00f9 parametri. Ad esempio: SET_SERVO SERVO=mioservo ANGLE=5.3 . In questo documento, i comandi ed i parametri sono mostrati in maiuscolo, tuttavia non fanno distinzione tra maiuscole e minuscole. (Quindi, \"SET_SERVO\" e \"set_servo\" eseguono entrambi lo stesso comando.) Questa sezione \u00e8 organizzata in base al nome del modulo Klipper, che generalmente segue i nomi delle sezioni specificati nel file di configurazione della stampante . Si noti che alcuni moduli vengono caricati automaticamente.","title":"Comandi aggiuntivi"},{"location":"G-Codes.html#adxl345","text":"I seguenti comandi sono disponibili quando una sezione di configurazione adxl345 \u00e8 abilitata.","title":"[adxl345]"},{"location":"G-Codes.html#accelerometer_measure","text":"ACCELEROMETER_MEASURE [CHIP=<config_name>] [NAME=<value>] : Avvia le misurazioni dell'accelerometro al numero richiesto di campioni al secondo. Se CHIP non \u00e8 specificato, il valore predefinito \u00e8 \"adxl345\". Il comando funziona in modalit\u00e0 start-stop: alla prima esecuzione avvia le misure, alla successiva esecuzione le interrompe. I risultati delle misurazioni vengono scritti in un file denominato /tmp/adxl345-<chip>-<name>.csv dove <chip> \u00e8 il nome del chip dell'accelerometro ( my_chip_name da [adxl345 my_chip_name] ) e <name> \u00e8 il parametro NAME facoltativo. Se NAME non \u00e8 specificato, il valore predefinito \u00e8 l'ora corrente nel formato \"AAAAMMGG_HHMMSS\". Se l'accelerometro non ha un nome nella sua sezione di configurazione (semplicemente [adxl345] ), allora la parte <chip> del nome non viene generata.","title":"ACCELEROMETER_MEASURE"},{"location":"G-Codes.html#accelerometer_query","text":"ACCELEROMETER_QUERY [CHIP=<config_name>] [RATE=<value>] : interroga l'accelerometro per il valore corrente. Se CHIP non \u00e8 specificato, il valore predefinito \u00e8 \"adxl345\". Se RATE non \u00e8 specificato, viene utilizzato il valore predefinito. Questo comando \u00e8 utile per testare la connessione all'accelerometro ADXL345: uno dei valori restituiti dovrebbe essere un'accelerazione di caduta libera (+/- un po' di rumore del chip).","title":"ACCELEROMETER_QUERY"},{"location":"G-Codes.html#accelerometer_debug_read","text":"ACCELEROMETER_DEBUG_READ [CHIP=<config_name>] REG=<register> : interroga l'ADXL345 register \"register\" (es. 44 o 0x2C). Pu\u00f2 essere utile per scopi di debug.","title":"ACCELEROMETER_DEBUG_READ"},{"location":"G-Codes.html#accelerometer_debug_write","text":"ACCELEROMETER_DEBUG_WRITE [CHIP=<nome_config>] REG=<register> VAL=<value> : Scrive il valore \"value\" grezzo in un registro \"register\". Sia \"value\" che \"registrer\" possono essere un numero intero decimale o esadecimale. Usare con cura e fare riferimento alla scheda tecnica ADXL345 per riferimento.","title":"ACCELEROMETER_DEBUG_WRITE"},{"location":"G-Codes.html#angle","text":"I seguenti comandi sono disponibili quando una sezione di configurazione dell'angolo \u00e8 abilitata.","title":"[angle]"},{"location":"G-Codes.html#angle_calibrate","text":"ANGLE_CALIBRATE CHIP=<chip_name> : Esegue la calibrazione dell'angolo sul sensore dato (deve esserci una sezione di configurazione [angle chip_name] che ha specificato un parametro stepper ). IMPORTANTE - questo strumento comander\u00e0 al motore passo-passo di muoversi senza controllare i normali limiti della cinematica. Idealmente, il motore dovrebbe essere scollegato da qualsiasi carrello della stampante prima di eseguire la calibrazione. Se non \u00e8 possibile scollegare lo stepper dalla stampante, assicurarsi che il carrello sia vicino al centro della sua guida prima di iniziare la calibrazione. (Il motore passo-passo pu\u00f2 spostarsi avanti o indietro di due rotazioni complete durante questo test.) Dopo aver completato questo test, utilizzare il comando SAVE_CONFIG per salvare i dati di calibrazione nel file di configurazione. Per utilizzare questo strumento \u00e8 necessario installare il pacchetto Python \"numpy\" (consultare il measuring resonance document per ulteriori informazioni).","title":"ANGLE_CALIBRATE"},{"location":"G-Codes.html#angle_debug_read","text":"ANGLE_DEBUG_READ CHIP=<config_name> REG=<register> : Interroga il registro del sensore \"register\" (ad es. 44 o 0x2C). Pu\u00f2 essere utile per scopi di debug. Questo \u00e8 disponibile solo per i chip tle5012b.","title":"ANGLE_DEBUG_READ"},{"location":"G-Codes.html#angle_debug_write","text":"ANGLE_DEBUG_WRITE CHIP=<config_name> REG=<register> VAL=<value> : scrive il valore \"value\" grezzo nel registro \"register\". Sia \"value\" che \"register\" possono essere un numero intero decimale o esadecimale. Usare con cautela e fare riferimento alla scheda tecnica del sensore per riferimento. Questo \u00e8 disponibile solo per i chip tle5012b.","title":"ANGLE_DEBUG_WRITE"},{"location":"G-Codes.html#bed_mesh","text":"I seguenti comandi sono disponibili quando la sezione di configurazione bed_mesh \u00e8 abilitata (consultare anche la guida della mesh del letto ).","title":"[bed_mesh]"},{"location":"G-Codes.html#bed_mesh_calibrate","text":"BED_MESH_CALIBRATE [METHOD=manual] [<probe_parameter>=<value>] [<mesh_parameter>=<value>] : Questo comando sonda il piatto utilizzando i punti generati specificati dai parametri nella configurazione. Dopo il sondaggio, viene generata una mesh e il movimento z viene regolato in base alla mesh. Vedere il comando PROBE per i dettagli sui parametri della sonda opzionali. Se viene specificato METHOD=manual, lo strumento di probing manuale \u00e8 attivato - vedere il comando MANUAL_PROBE per quanti riguarda per i dettagli sui comandi aggiuntivi disponibili mentre questo strumento \u00e8 attivo.","title":"BED_MESH_CALIBRATE"},{"location":"G-Codes.html#bed_mesh_output","text":"BED_MESH_OUTPUT PGP=[<0:1>] : questo comando restituisce i valori z sondati e i valori mesh correnti al terminale. Se viene specificato PGP=1, le coordinate X, Y generate da bed_mesh, insieme ai relativi indici associati, verranno inviate al terminale.","title":"BED_MESH_OUTPUT"},{"location":"G-Codes.html#bed_mesh_map","text":"BED_MESH_MAP : Come per BED_MESH_OUTPUT, questo comando stampa lo stato corrente della mesh sul terminale. Invece di stampare i valori in un formato leggibile, lo stato viene serializzato in formato json. Ci\u00f2 consente ai plug-in di Octoprint di acquisire facilmente i dati e generare mappe di altezza che si approssimano la superficie del piatto.","title":"BED_MESH_MAP"},{"location":"G-Codes.html#bed_mesh_clear","text":"BED_MESH_CLEAR : questo comando cancella la mesh e rimuove tutte le regolazioni z. Si consiglia di inserirlo nella parte finale del gcode.","title":"BED_MESH_CLEAR"},{"location":"G-Codes.html#bed_mesh_profile","text":"BED_MESH_PROFILE LOAD=<name> SAVE=<name> REMOVE=<name> : questo comando fornisce la gestione del profilo per lo stato della mesh. LOAD ripristiner\u00e0 lo stato della mesh dal profilo corrispondente al nome fornito. SAVE salver\u00e0 lo stato della mesh corrente in un profilo che corrisponde al nome fornito. Rimuovi eliminer\u00e0 il profilo corrispondente al nome fornito dalla memoria persistente. Si noti che dopo aver eseguito le operazioni SAVE o REMOVE \u00e8 necessario eseguire il gcode SAVE_CONFIG per rendere permanenti le modifiche alla memoria persistente.","title":"BED_MESH_PROFILE"},{"location":"G-Codes.html#bed_mesh_offset","text":"BED_MESH_OFFSET [X=<value>] [Y=<value>] : applica gli offset X e/o Y alla ricerca della mesh. Ci\u00f2 \u00e8 utile per le stampanti con estrusori indipendenti, poich\u00e9 \u00e8 necessario un offset per produrre la corretta regolazione Z dopo un cambio utensile.","title":"BED_MESH_OFFSET"},{"location":"G-Codes.html#bed_screws","text":"I seguenti comandi sono disponibili quando la sezione di configurazione bed_screws \u00e8 abilitata (consultare anche la manual level guide ).","title":"[bed_screws]"},{"location":"G-Codes.html#bed_screws_adjust","text":"BED_SCREWS_ADJUST : questo comando richiamer\u00e0 lo strumento di regolazione delle viti del piatto. Comander\u00e0 l'ugello in posizioni diverse (come definito nel file di configurazione) e consentir\u00e0 di effettuare regolazioni alle viti del piatto in modo che il piatto sia a una distanza costante dall'ugello.","title":"BED_SCREWS_ADJUST"},{"location":"G-Codes.html#bed_tilt","text":"I seguenti comandi sono disponibili quando la sezione di configurazione inclinazione_piatto \u00e8 abilitata.","title":"[bed_tilt]"},{"location":"G-Codes.html#bed_tilt_calibrate","text":"BED_TILT_CALIBRATE [METHOD=manual] [<probe_parameter>=<value>] : Questo comando sonder\u00e0 i punti specificati nella configurazione e quindi consiglier\u00e0 le regolazioni dell'inclinazione x e y aggiornate. Vedere il comando PROBE per i dettagli sui parametri della sonda opzionali. Se viene specificato METHOD=manual, lo strumento di probing manuale \u00e8 attivato - vedere il comando MANUAL_PROBE sopra per i dettagli sui comandi aggiuntivi disponibili mentre questo strumento \u00e8 attivo.","title":"BED_TILT_CALIBRATE"},{"location":"G-Codes.html#bltouch","text":"Il comando seguente \u00e8 disponibile quando \u00e8 abilitata una sezione di configurazione bltouch (vedere anche la Guida BL-Touch ).","title":"[bltouch]"},{"location":"G-Codes.html#bltouch_debug","text":"BLTOUCH_DEBUG COMMAND=<command> : Invia un comando al BLTouch. Pu\u00f2 essere utile per il debug. I comandi disponibili sono: pin_down , touch_mode , pin_up , self_test , reset . Un BL-Touch V3.0 o V3.1 pu\u00f2 anche supportare i comandi set_5V_output_mode , set_OD_output_mode , output_mode_store .","title":"BLTOUCH_DEBUG"},{"location":"G-Codes.html#bltouch_store","text":"BLTOUCH_STORE MODE=<output_mode> : memorizza una modalit\u00e0 di output nella EEPROM di un BLTouch V3.1 Le modalit\u00e0 di output disponibili sono: 5V , OD","title":"BLTOUCH_STORE"},{"location":"G-Codes.html#configfile","text":"Il modulo configfile viene caricato automaticamente.","title":"[configfile]"},{"location":"G-Codes.html#save_config","text":"SAVE_CONFIG : questo comando sovrascriver\u00e0 il file di configurazione della stampante principale e riavvier\u00e0 il software host. Questo comando viene utilizzato insieme ad altri comandi di calibrazione per memorizzare i risultati dei test di calibrazione.","title":"SAVE_CONFIG"},{"location":"G-Codes.html#delayed_gcode","text":"Il comando seguente \u00e8 abilitato se \u00e8 stata abilitata una sezione di configurazione di gcode ritardata (consultare anche la guida ai modelli ).","title":"[delayed_gcode]"},{"location":"G-Codes.html#update_delayed_gcode","text":"UPDATE_DELAYED_GCODE [ID=<nome>] [DURATION=<secondi>] : aggiorna la durata del ritardo per il [gcode_ritardato] identificato e avvia il timer per l'esecuzione di gcode. Un valore di 0 annuller\u00e0 l'esecuzione di un gcode ritardato in sospeso.","title":"UPDATE_DELAYED_GCODE"},{"location":"G-Codes.html#delta_calibrate","text":"I seguenti comandi sono disponibili quando la sezione di configurazione delta_calibrate \u00e8 abilitata (consultare anche la guida alla calibrazione delta ).","title":"[delta_calibrate]"},{"location":"G-Codes.html#delta_calibrate_1","text":"DELTA_CALIBRATE [METHOD=manual] [<probe_parameter>=<value>] : questo comando sonder\u00e0 sette punti sul piatto e consiglier\u00e0 posizioni di finecorsa, angoli della torre e raggio aggiornati. Vedere il comando PROBE per i dettagli sui parametri della sonda opzionali. Se viene specificato METHOD=manual, lo strumento di probe manuale \u00e8 attivato - vedere il comando MANUAL_PROBE precedente per i dettagli sui comandi aggiuntivi disponibili mentre questo strumento \u00e8 attivo.","title":"DELTA_CALIBRATE"},{"location":"G-Codes.html#delta_analyze","text":"DELTA_ANALYZE : questo comando viene utilizzato durante la calibrazione avanzata delle stampanti delta. Vedere Delta Calibrate per i dettagli.","title":"DELTA_ANALYZE"},{"location":"G-Codes.html#display","text":"Il comando seguente \u00e8 disponibile quando \u00e8 abilitata una sezione di configurazione display .","title":"[display]"},{"location":"G-Codes.html#set_display_group","text":"SET_DISPLAY_GROUP [DISPLAY=<display>] GROUP=<group> : Imposta il gruppo di visualizzazione attivo di un display LCD. Ci\u00f2 consente di definire pi\u00f9 gruppi di dati di visualizzazione nella configurazione, ad es. [display_data <group> <elementname>] e passare da uno all'altro usando questo comando gcode esteso. Se DISPLAY non \u00e8 specificato, l'impostazione predefinita \u00e8 \"display\" (il display principale).","title":"SET_DISPLAY_GROUP"},{"location":"G-Codes.html#display_status","text":"Il modulo display_status viene caricato automaticamente se una sezione di configurazione display \u00e8 abilitata. Fornisce i seguenti comandi G-Code standard: Messaggio visualizzato: M117 <messaggio> Imposta la percentuale di costruzione: M73 P<percentuale> Viene inoltre fornito il seguente comando G-Code esteso: SET_DISPLAY_TEXT MSG=<messaggio> : esegue l'equivalente di M117, impostando il MSG fornito come messaggio visualizzato. Se MSG viene omesso, il display verr\u00e0 cancellato.","title":"[display_status]"},{"location":"G-Codes.html#dual_carriage","text":"Il comando seguente \u00e8 disponibile quando la sezione di configurazione dual_carriage \u00e8 abilitata.","title":"[dual_carriage]"},{"location":"G-Codes.html#set_dual_carriage","text":"SET_DUAL_CARRIAGE CARRIAGE=[0|1] : Questo comando imposter\u00e0 il carrello attivo. Viene in genere richiamato dai campi activate_gcode e deactivate_gcode in una configurazione a pi\u00f9 estrusori.","title":"SET_DUAL_CARRIAGE"},{"location":"G-Codes.html#endstop_phase","text":"I seguenti comandi sono disponibili quando una sezione di configurazione endstop_phase \u00e8 abilitata (consultare anche la guida alla fase endstop ).","title":"[endstop_phase]"},{"location":"G-Codes.html#endstop_phase_calibrate","text":"ENDSTOP_PHASE_CALIBRATE [STEPPER=<config_name>] : Se non viene fornito alcun parametro STEPPER, questo comando riporter\u00e0 le statistiche sulle fasi stepper dell'arresto durante le precedenti operazioni di homing. Quando viene fornito un parametro STEPPER, fa in modo che l'impostazione della fase di fine corsa fornita sia scritta nel file di configurazione (insieme al comando SAVE_CONFIG).","title":"ENDSTOP_PHASE_CALIBRATE"},{"location":"G-Codes.html#exclude_object","text":"I seguenti comandi sono disponibili quando \u00e8 abilitata una exclude_object config section (consultare anche la exclude object guide ):","title":"[exclude_object]"},{"location":"G-Codes.html#exclude_object_1","text":"EXCLUDE_OBJECT [NAME=object_name] [CURRENT=1] [RESET=1] : Senza parametri, questo restituir\u00e0 un elenco di tutti gli oggetti attualmente esclusi. Quando viene fornito il parametro NAME , l'oggetto denominato verr\u00e0 escluso dalla stampa. Quando viene fornito il parametro CURRENT , l'oggetto corrente verr\u00e0 escluso dalla stampa. Quando viene fornito il parametro RESET l'elenco degli oggetti esclusi verr\u00e0 cancellato. Inoltre l'inclusione di NAME ripristiner\u00e0 solo l'oggetto denominato. Questo pu\u00f2 causare errori di stampa, se i livelli sono gi\u00e0 stati saltati.","title":"EXCLUDE_OBJECT"},{"location":"G-Codes.html#exclude_object_define","text":"EXCLUDE_OBJECT_DEFINE [NAME=object_name [CENTER=X,Y] [POLYGON=[[x,y],...]] [RESET=1] [JSON=1] : fornisce un riepilogo di un oggetto nel file. Senza parametri forniti, questo elencher\u00e0 gli oggetti definiti noti a Klipper. Restituisce un elenco di stringhe, a meno che non venga fornito il parametro JSON , quando restituir\u00e0 i dettagli dell'oggetto in formato json. Quando il parametro NAME \u00e8 incluso, definisce un oggetto da escludere. NAME : questo parametro \u00e8 obbligatorio. \u00c8 l'identificatore utilizzato da altri comandi in questo modulo. CENTER : una coordinata X,Y per l'oggetto. POLYGON : Un array di coordinate X,Y che fornisce un contorno per l'oggetto. Quando viene fornito il parametro RESET , tutti gli oggetti definiti verranno cancellati e il modulo [exclude_object] verr\u00e0 ripristinato.","title":"EXCLUDE_OBJECT_DEFINE"},{"location":"G-Codes.html#exclude_object_start","text":"EXCLUDE_OBJECT_START NAME=object_name : questo comando prende un parametro NAME e marca l'inizio del gcode per un oggetto sul livello corrente.","title":"EXCLUDE_OBJECT_START"},{"location":"G-Codes.html#exclude_object_end","text":"EXCLUDE_OBJECT_END [NAME=object_name] : Denota la fine del gcode dell'oggetto per il livello. \u00c8 accoppiato con EXCLUDE_OBJECT_START . Un parametro NAME \u00e8 facoltativo e avviser\u00e0 solo quando il nome fornito non corrisponde all'oggetto corrente.","title":"EXCLUDE_OBJECT_END"},{"location":"G-Codes.html#extruder","text":"I seguenti comandi sono disponibili se una sezione di configurazione dell'estrusore \u00e8 abilitata:","title":"[extruder]"},{"location":"G-Codes.html#activate_extruder","text":"ACTIVATE_EXTRUDER EXTRUDER=<config_name> : in una stampante con pi\u00f9 sezioni di configurazione extruder , questo comando cambia l'hotend attivo.","title":"ACTIVATE_EXTRUDER"},{"location":"G-Codes.html#set_pressure_advance","text":"SET_PRESSURE_ADVANCE [EXTRUDER=<config_name>] [ADVANCE=<pressure_advance>] [SMOOTH_TIME=<pressure_advance_smooth_time>] : Imposta i parametri di pressure advance delleo stepper di un estrusore (come definito in un estrusore o [ extruder_stepper] (sezione di configurazione Config_Reference.md#extruder_stepper). Se EXTRUDER non \u00e8 specificato, per impostazione predefinita viene utilizzato lo stepper definito nell'hotend attivo.","title":"SET_PRESSURE_ADVANCE"},{"location":"G-Codes.html#set_extruder_rotation_distance","text":"SET_EXTRUDER_ROTATION_DISTANCE EXTRUDER=<config_name> [DISTANCE=<distance>] : Imposta un nuovo valore per la \"distanza di rotazione\" dello stepper dell'estrusore fornito (come definito in un extruder o extruder_stepper sezione di configurazione). Se la distanza di rotazione \u00e8 un numero negativo, il movimento passo-passo verr\u00e0 invertito (rispetto alla direzione passo-passo specificata nel file di configurazione). Le impostazioni modificate non vengono mantenute al ripristino di Klipper. Usare con cautela poich\u00e9 piccole modifiche possono causare una pressione eccessiva tra l'estrusore e l'hotend. Eseguire una corretta calibrazione con il filamento prima dell'uso. Se il valore 'DISTANZA' non viene fornito, questo comando restituir\u00e0 la distanza di rotazione corrente.","title":"SET_EXTRUDER_ROTATION_DISTANCE"},{"location":"G-Codes.html#sync_extruder_motion","text":"SYNC_EXTRUDER_MOTION EXTRUDER=<nome> MOTION_QUEUE=<nome> : questo comando attiver\u00e0 lo stepper specificato da EXTRUDER (come definito in un extruder o extruder_stepper config sezione) per sincronizzarsi con il movimento di un estrusore specificato da MOTION_QUEUE (come definito in una sezione di configurazione estrusore ). Se MOTION_QUEUE \u00e8 una stringa vuota, lo stepper verr\u00e0 desincronizzato da tutti i movimenti dell'estrusore.","title":"SYNC_EXTRUDER_MOTION"},{"location":"G-Codes.html#set_extruder_step_distance","text":"Questo comando \u00e8 deprecato e verr\u00e0 rimosso nel prossimo futuro.","title":"SET_EXTRUDER_STEP_DISTANCE"},{"location":"G-Codes.html#sync_stepper_to_extruder","text":"Questo comando \u00e8 deprecato e verr\u00e0 rimosso nel prossimo futuro.","title":"SYNC_STEPPER_TO_EXTRUDER"},{"location":"G-Codes.html#fan_generic","text":"Il comando seguente \u00e8 disponibile quando una sezione di configurazione fan_generic \u00e8 abilitata.","title":"[fan_generic]"},{"location":"G-Codes.html#set_fan_speed","text":"SET_FAN_SPEED FAN=config_name SPEED=<velocit\u00e0> Questo comando imposta la velocit\u00e0 di una ventola. \"velocit\u00e0\" deve essere compresa tra 0.0 e 1.0.","title":"SET_FAN_SPEED"},{"location":"G-Codes.html#filament_switch_sensor","text":"Il comando seguente \u00e8 disponibile quando \u00e8 abilitata una sezione di configurazione filament_switch_sensor o filament_motion_sensor .","title":"[filament_switch_sensor]"},{"location":"G-Codes.html#query_filament_sensor","text":"QUERY_FILAMENT_SENSOR SENSOR=<sensor_name> : Interroga lo stato del sensore di filamento. I dati visualizzati sul terminale dipenderanno dal tipo di sensore definito nella configurazione.","title":"QUERY_FILAMENT_SENSOR"},{"location":"G-Codes.html#set_filament_sensor","text":"SET_FILAMENT_SENSOR SENSOR=<nome_sensore> ENABLE=[0|1] : Attiva/disattiva il sensore di filamento. Se ENABLE \u00e8 impostato su 0, il sensore di filamento sar\u00e0 disabilitato, se impostato su 1 sar\u00e0 abilitato.","title":"SET_FILAMENT_SENSOR"},{"location":"G-Codes.html#firmware_retraction","text":"I seguenti comandi G-Code standard sono disponibili quando la sezione di configurazione firmware_retraction \u00e8 abilitata. Questi comandi consentono di utilizzare la funzione di retraction del firmware disponibile in molti slicer, per ridurre lo stringing durante gli spostamenti di non estrusione da una parte all'altra della stampa. Configurando opportunamente la pressure advance si riduce la lunghezza della retrazione richiesta. G10 : Ritrae l'estrusore utilizzando i parametri attualmente configurati. G11 : Ritira l'estrusore utilizzando i parametri attualmente configurati. Sono inoltre disponibili i seguenti comandi aggiuntivi.","title":"[firmware_retraction]"},{"location":"G-Codes.html#set_retraction","text":"SET_RETRACTION [RETRACT_LENGTH=<mm>] [RETRACT_SPEED=<mm/s>] [UNRETRACT_EXTRA_LENGTH=<mm>] [UNRETRACT_SPEED=<mm/s>] : regola i parametri utilizzati dalla retrazione. RETRACT_LENGTH determina la lunghezza del filamento da ritrarre e estrudere. La velocit\u00e0 di retrazione viene regolata tramite RETRACT_SPEED, ed \u00e8 generalmente impostata su un valore relativamente alto. La velocit\u00e0 di annullamento viene regolata tramite UNRETRACT_SPEED e non \u00e8 particolarmente critica, sebbene spesso inferiore a RETRACT_SPEED. In alcuni casi \u00e8 utile aggiungere una piccola quantit\u00e0 di lunghezza aggiuntiva all'annullamento della retrazione, e questa viene impostata tramite UNRETRACT_EXTRA_LENGTH. SET_RETRACTION \u00e8 comunemente impostato come parte della configurazione dello slicer per filamento, poich\u00e9 filamenti diversi richiedono impostazioni dei parametri diverse.","title":"SET_RETRACTION"},{"location":"G-Codes.html#get_retraction","text":"GET_RETRACTION : interroga i parametri correnti utilizzati dal firmware per retrazione e li visualizza sul terminale.","title":"GET_RETRACTION"},{"location":"G-Codes.html#force_move","text":"Il modulo force_move viene caricato automaticamente, tuttavia alcuni comandi richiedono l'impostazione di enable_force_move in printer config .","title":"[force_move]"},{"location":"G-Codes.html#stepper_buzz","text":"STEPPER_BUZZ STEPPER=<nome_config> : sposta lo stepper dato in avanti di 1 mm e poi indietro di 1 mm, ripetuto 10 volte. Questo \u00e8 uno strumento diagnostico per aiutare a verificare la connettivit\u00e0 stepper.","title":"STEPPER_BUZZ"},{"location":"G-Codes.html#force_move_1","text":"FORCE_MOVE STEPPER=<nome_config> DISTANCE=<value> VELOCITY=<value> [ACCEL=<value>] : Questo comando sposter\u00e0 forzatamente lo stepper dato della distanza data (in mm) alla velocit\u00e0 costante data (in mm/ S). Se viene specificato ACCEL ed \u00e8 maggiore di zero, verr\u00e0 utilizzata l'accelerazione data (in mm/s^2); altrimenti non viene eseguita alcuna accelerazione. Non vengono effettuati controlli sui limiti; non vengono effettuati aggiornamenti cinematici; altri stepper paralleli su un asse non verranno spostati. Prestare attenzione poich\u00e9 un comando errato potrebbe causare danni! L'uso di questo comando metter\u00e0 quasi sicuramente la cinematica di basso livello in uno stato errato; emettere un G28 in seguito per ripristinare la cinematica. Questo comando \u00e8 destinato alla diagnostica e al debug di basso livello.","title":"FORCE_MOVE"},{"location":"G-Codes.html#set_kinematic_position","text":"SET_KINEMATIC_POSITION [X=<valore>] [Y=<valore>] [Z=<valore>] : forza il codice cinematico di basso livello a credere che la testa di stampa si trovi nella posizione cartesiana data. Questo \u00e8 un comando diagnostico e di debug; utilizzare SET_GCODE_OFFSET e/o G92 per le normali trasformazioni degli assi. Se un asse non \u00e8 specificato, verr\u00e0 impostato automaticamente sulla posizione in cui la testa \u00e8 stata comandata l'ultima volta. L'impostazione di una posizione errata o non valida pu\u00f2 causare errori software interni. Questo comando potrebbe invalidare futuri controlli sui confini; emettere un G28 in seguito per ripristinare la cinematica.","title":"SET_KINEMATIC_POSITION"},{"location":"G-Codes.html#gcode","text":"Il modulo gcode viene caricato automaticamente.","title":"[gcode]"},{"location":"G-Codes.html#restart","text":"RESTART : Ci\u00f2 far\u00e0 s\u00ec che il software host ricarichi la sua configurazione ed esegua un ripristino interno. Questo comando non canceller\u00e0 lo stato di errore dal microcontrollore (vedi FIRMWARE_RESTART) n\u00e9 caricher\u00e0 nuovo software (vedi FAQ ) .","title":"RESTART"},{"location":"G-Codes.html#firmware_restart","text":"FIRMWARE_RESTART : Questo \u00e8 simile a un comando RESTART, ma cancella anche qualsiasi stato di errore dal microcontrollore.","title":"FIRMWARE_RESTART"},{"location":"G-Codes.html#status","text":"STATUS : segnala lo stato del software host di Klipper.","title":"STATUS"},{"location":"G-Codes.html#help","text":"HELP : riporta l'elenco dei comandi G-Code estesi disponibili.","title":"HELP"},{"location":"G-Codes.html#gcode_arcs","text":"I seguenti comandi G-Code standard sono disponibili se una sezione di configurazione gcode_arcs \u00e8 abilitata: Movimento dell'arco in senso orario (G2), Movimento dell'arco in senso antiorario (G3): G2|G3 [X<pos>] [Y<pos>] [Z<pos>] [E<pos>] [F<velocit\u00e0>] I<valore> J<valore>|I<valore> K<valore>|J<valore> K<valore> Selezione del piano dell'arco: G17 (piano XY), G18 (piano XZ), G19 (piano YZ)","title":"[gcode_arcs]"},{"location":"G-Codes.html#gcode_macro","text":"Il comando seguente \u00e8 disponibile quando \u00e8 abilitata una sezione di configurazione gcode_macro (consultare anche la guida ai modelli di comando ).","title":"[gcode_macro]"},{"location":"G-Codes.html#set_gcode_variable","text":"SET_GCODE_VARIABLE MACRO=<nome_macro> VARIABLE=<nome> VALUE=<valore> : questo comando consente di modificare il valore di una variabile gcode_macro in fase di esecuzione. Il VALUE fornito viene analizzato come un valore literal in Python.","title":"SET_GCODE_VARIABLE"},{"location":"G-Codes.html#gcode_move","text":"Il modulo gcode_move viene caricato automaticamente.","title":"[gcode_move]"},{"location":"G-Codes.html#get_position","text":"GET_POSITION`: Restituisce informazioni sulla posizione corrente della testa di stampa. Per ulteriori informazioni, vedere la documentazione per gli sviluppatori di GET_POSITION output .","title":"GET_POSITION"},{"location":"G-Codes.html#set_gcode_offset","text":"SET_GCODE_OFFSET [X=<pos>|X_ADJUST=<regola>] [Y=<pos>|Y_ADJUST=<regola>] [Z=<pos>|Z_ADJUST=<regola>] [MOVE=1 [MOVE_SPEED=<velocit\u00e0 >]] : imposta un offset di posizione da applicare ai futuri comandi G-Code. Questo \u00e8 comunemente usato per cambiare virtualmente l'offset del letto Z o per impostare gli offset XY degli ugelli quando si cambia estrusore. Ad esempio, se viene inviato \"SET_GCODE_OFFSET Z=0.2\", i futuri movimenti G-Code avranno 0.2 mm aggiunti alla loro altezza Z. Se vengono utilizzati i parametri di stile X_ADJUST, la regolazione verr\u00e0 aggiunta a qualsiasi offset esistente (ad esempio, \"SET_GCODE_OFFSET Z=-0.2\" seguito da \"SET_GCODE_OFFSET Z_ADJUST=0.3\" risulter\u00e0 in un offset Z totale di 0.1). Se viene specificato \"MOVE=1\", verr\u00e0 emesso un movimento della testa di stampa per applicare l'offset specificato (altrimenti l'offset avr\u00e0 effetto sul successivo movimento assoluto del codice G che specifica l'asse dato). Se viene specificato \"MOVE_SPEED\", lo spostamento della testa utensile verr\u00e0 eseguito con la velocit\u00e0 data (in mm/s); in caso contrario, il movimento della testa utensile utilizzer\u00e0 l'ultima velocit\u00e0 del G-code specificata.","title":"SET_GCODE_OFFSET"},{"location":"G-Codes.html#save_gcode_state","text":"SAVE_GCODE_STATE [NAME=<nome_stato>] : salva lo stato di analisi delle coordinate del G-code corrente. Il salvataggio e il ripristino dello stato del G-code \u00e8 utile negli script e nelle macro. Questo comando salva la modalit\u00e0 di coordinate assolute del G-code corrente (G90/G91), la modalit\u00e0 di estrusione assoluta (M82/M83), l'origine (G92), l'offset (SET_GCODE_OFFSET), l'override della velocit\u00e0 (M220), l'override dell'estrusore (M221), la velocit\u00e0 di spostamento , la posizione XYZ corrente e la posizione relativa dell'estrusore \"E\". Se viene fornito NAME, consente di assegnare un nome allo stato salvato alla stringa data. Se NAME non viene fornito, il valore predefinito \u00e8 \"predefinito\".","title":"SAVE_GCODE_STATE"},{"location":"G-Codes.html#restore_gcode_state","text":"RESTORE_GCODE_STATE [NAME=<nome_stato>] [MOVE=1 [MOVE_SPEED=<velocit\u00e0>]] : ripristina uno stato precedentemente salvato tramite SAVE_GCODE_STATE. Se viene specificato \"MOVE=1\", verr\u00e0 emesso un movimento della testa utensile per tornare alla posizione XYZ precedente. Se viene specificato \"MOVE_SPEED\", lo spostamento della testa utensile verr\u00e0 eseguito con la velocit\u00e0 data (in mm/s); in caso contrario, lo spostamento della testa utensile utilizzer\u00e0 la velocit\u00e0 del codice g ripristinata.","title":"RESTORE_GCODE_STATE"},{"location":"G-Codes.html#hall_filament_width_sensor","text":"I seguenti comandi sono disponibili quando la sezione di configurazione del sensore di larghezza del filamento tsl1401cl o sezione di configurazione del sensore di larghezza del filamento hall \u00e8 abilitata (consultare anche Sensore di larghezza del filamento TSLl401CL e Hall Filament Width Sensor ):","title":"[hall_filament_width_sensor]"},{"location":"G-Codes.html#query_filament_width","text":"QUERY_FILAMENT_WIDTH : Restituisce lo spessore del filamento misurato.","title":"QUERY_FILAMENT_WIDTH"},{"location":"G-Codes.html#reset_filament_width_sensor","text":"RESET_FILAMENT_WIDTH_SENSOR : Cancella tutte le letture del sensore. Utile dopo il cambio del filamento.","title":"RESET_FILAMENT_WIDTH_SENSOR"},{"location":"G-Codes.html#disable_filament_width_sensor","text":"DISABLE_FILAMENT_WIDTH_SENSOR : Spegnere il sensore di larghezza del filamento e smettere di usarlo per il controllo del flusso.","title":"DISABLE_FILAMENT_WIDTH_SENSOR"},{"location":"G-Codes.html#enable_filament_width_sensor","text":"ENABLE_FILAMENT_WIDTH_SENSOR : attiva il sensore di larghezza del filamento e inizia a usarlo per il controllo del flusso.","title":"ENABLE_FILAMENT_WIDTH_SENSOR"},{"location":"G-Codes.html#query_raw_filament_width","text":"QUERY_RAW_FILAMENT_WIDTH : Restituisce le letture del canale ADC corrente e il valore grezzo (raw) del sensore per i punti di calibrazione.","title":"QUERY_RAW_FILAMENT_WIDTH"},{"location":"G-Codes.html#enable_filament_width_log","text":"ENABLE_FILAMENT_WIDTH_LOG : attiva la registrazione del diametro del filamento.","title":"ENABLE_FILAMENT_WIDTH_LOG"},{"location":"G-Codes.html#disable_filament_width_log","text":"DISABLE_FILAMENT_WIDTH_LOG : Disattiva la registrazione del diametro del filamento.","title":"DISABLE_FILAMENT_WIDTH_LOG"},{"location":"G-Codes.html#heaters","text":"Il modulo heaters viene caricato automaticamente se un riscaldatore \u00e8 definito nel file di configurazione.","title":"[heaters]"},{"location":"G-Codes.html#turn_off_heaters","text":"TURN_OFF_HEATERS : Spegni tutti i riscaldatori.","title":"TURN_OFF_HEATERS"},{"location":"G-Codes.html#temperature_wait","text":"TEMPERATURE_WAIT SENSOR=<config_name> [MINIMUM=<target>] [MAXIMUM=<target>] : Attendere fino a quando il sensore di temperatura specificato \u00e8 pari o superiore al MINIMO fornito e/o pari o inferiore al MASSIMO fornito.","title":"TEMPERATURE_WAIT"},{"location":"G-Codes.html#set_heater_temperature","text":"SET_HEATER_TEMPERATURE HEATER=<nome_riscaldatore> [TARGET=<temperatura_destinata>] : Imposta la temperatura target per un riscaldatore. Se non viene fornita una temperatura target, il target \u00e8 0.","title":"SET_HEATER_TEMPERATURE"},{"location":"G-Codes.html#idle_timeout","text":"Il modulo idle_timeout viene caricato automaticamente.","title":"[idle_timeout]"},{"location":"G-Codes.html#set_idle_timeout","text":"SET_IDLE_TIMEOUT [TIMEOUT=<timeout>] : consente all'utente di impostare il timeout di inattivit\u00e0 (in secondi).","title":"SET_IDLE_TIMEOUT"},{"location":"G-Codes.html#input_shaper","text":"Il comando seguente \u00e8 abilitato se \u00e8 stata abilitata una sezione di configurazione di input_shaper (consultare anche la guida alla compensazione della risonanza ).","title":"[input_shaper]"},{"location":"G-Codes.html#set_input_shaper","text":"SET_INPUT_SHAPER [SHAPER_FREQ_X=<shaper_freq_x>] [SHAPER_FREQ_Y=<shaper_freq_y>] [DAMPING_RATIO_X=<damping_ratio_x>] [DAMPING_RATIO_Y=<damping_ratio_y>] [SHAPER_TYPE=<shaper>] [SHAPER_TYPE_X=<shaper_type_x>] [SHAPER_TYPE=<shaper_TYPE_X=<shaper_type_x>] [SHAPER_TYPE=<shaper_type_y=<shaper_type_x> ] : Modifica i parametri dell'input shaper. Si noti che il parametro SHAPER_TYPE reimposta l'input shaper per entrambi gli assi X e Y anche se sono stati configurati tipi di shaper diversi nella sezione [input_shaper]. SHAPER_TYPE non pu\u00f2 essere utilizzato insieme a uno dei parametri SHAPER_TYPE_X e SHAPER_TYPE_Y. Vedere config reference per maggiori dettagli su ciascuno di questi parametri.","title":"SET_INPUT_SHAPER"},{"location":"G-Codes.html#manual_probe","text":"Il modulo manual_probe viene caricato automaticamente.","title":"[manual_probe]"},{"location":"G-Codes.html#manual_probe_1","text":"MANUAL_PROBE [SPEED=<speed>] : esegue uno script di supporto utile per misurare l'altezza dell'ugello in una determinata posizione. Se viene specificato SPEED, imposta la velocit\u00e0 dei comandi TESTZ (il valore predefinito \u00e8 5mm/s). Durante una sonda manuale, sono disponibili i seguenti comandi aggiuntivi: ACCEPT : questo comando accetta la posizione Z corrente e conclude il probing manuale. ABORT : questo comando termina lo strumento di probing manuale. TESTZ Z=<valore> : questo comando sposta l'ugello verso l'alto o verso il basso della quantit\u00e0 specificata in \"valore\". Ad esempio, TESTZ Z=-.1 sposterebbe l'ugello verso il basso di .1 mm mentre TESTZ Z=.1 sposterebbe l'ugello verso l'alto di .1 mm. Il valore pu\u00f2 anche essere + , - , ++ o -- per spostare l'ugello verso l'alto o verso il basso di un importo rispetto ai tentativi precedenti.","title":"MANUAL_PROBE"},{"location":"G-Codes.html#z_endstop_calibrate","text":"Z_ENDSTOP_CALIBRATE [SPEED=<speed>] : esegue uno script di supporto utile per calibrare un'impostazione di configurazione Z position_endstop. Vedere il comando MANUAL_PROBE per i dettagli sui parametri e sui comandi aggiuntivi disponibili mentre lo strumento \u00e8 attivo.","title":"Z_ENDSTOP_CALIBRATE"},{"location":"G-Codes.html#z_offset_apply_endstop","text":"Z_OFFSET_APPLY_ENDSTOP : prende l'offset Z Gcode corrente (noto anche come babystepping) e lo sottrae da stepper_z endstop_position. Questa azione per prendere un valore di babystep utilizzato di frequente e \"renderlo permanente\". Richiede un SAVE_CONFIG per avere effetto.","title":"Z_OFFSET_APPLY_ENDSTOP"},{"location":"G-Codes.html#stepper-manuali","text":"Il comando seguente \u00e8 disponibile quando una sezione di configurazione stepper_manuale \u00e8 abilitata.","title":"[Stepper manuali]"},{"location":"G-Codes.html#manual_stepper","text":"MANUAL_STEPPER STEPPER=nome_config [ENABLE=[0|1]] [SET_POSITION=<pos>] [SPEED=<velocit\u00e0>] [ACCEL=<accelerazione>] [MOVE=<pos> [STOP_ON_ENDSTOP=[1|2|- 1|-2]] [SYNC=0]] : Questo comando alterer\u00e0 lo stato dello stepper. Utilizzare il parametro ENABLE per abilitare/disabilitare lo stepper. Utilizzare il parametro SET_POSITION per forzare lo stepper a pensare di trovarsi nella posizione data. Utilizzare il parametro MOVE per richiedere un movimento alla posizione data. Se viene specificato SPEED e/o ACCEL, verranno utilizzati i valori forniti al posto dei valori predefiniti specificati nel file di configurazione. Se viene specificato un ACCEL pari a zero, non verr\u00e0 eseguita alcuna accelerazione. Se viene specificato STOP_ON_ENDSTOP=1, lo spostamento terminer\u00e0 in anticipo se l'endstop segnala come attivato (usa STOP_ON_ENDSTOP=2 per completare lo spostamento senza errori anche se l'endstop non si attiva, usa -1 o -2 per interrompere quando l'endstop segnala non innescato). Normalmente i futuri comandi G-Code verranno programmati per essere eseguiti dopo il completamento del movimento passo-passo, tuttavia se un movimento passo-passo manuale utilizza SYNC=0, i futuri comandi di movimento G-Code potrebbero essere eseguiti in parallelo con il movimento passo-passo.","title":"MANUAL_STEPPER"},{"location":"G-Codes.html#mcp4018","text":"Il comando seguente \u00e8 disponibile quando una sezione di configurazione mcp4018 \u00e8 abilitata.","title":"[mcp4018]"},{"location":"G-Codes.html#set_digipot","text":"SET_DIGIPOT DIGIPOT=config_name WIPER=<value> : Questo comando cambier\u00e0 il valore corrente del digipot. Questo valore dovrebbe essere in genere compreso tra 0.0 e 1.0, a meno che non sia definita una 'scale' nella configurazione. Quando viene definita 'scale', questo valore dovrebbe essere compreso tra 0,0 e 'scale'.","title":"SET_DIGIPOT"},{"location":"G-Codes.html#led","text":"Il comando seguente \u00e8 disponibile quando una qualsiasi delle sezioni di configurazione led \u00e8 abilitata.","title":"[led]"},{"location":"G-Codes.html#set_led","text":"SET_LED LED=<nome_config> ROSSO=<valore> VERDE=<valore> BLU=<valore> BIANCO=<valore> [INDEX=<indice>] [TRANSMIT=0] [SYNC=1] : Imposta il LED in output. Ogni colore <valore> deve essere compreso tra 0,0 e 1,0. L'opzione BIANCO \u00e8 valida solo su LED RGBW. Se il LED supporta pi\u00f9 chip in una catena daisy-chain, \u00e8 possibile specificare INDEX per modificare il colore del solo chip specificato (1 per il primo chip, 2 per il secondo, ecc.). Se INDEX non viene fornito, tutti i LED nella catena verranno impostati sul colore fornito. Se viene specificato TRANSMIT=0, il cambio colore verr\u00e0 effettuato solo sul successivo comando SET_LED che non specifica TRANSMIT=0; questo pu\u00f2 essere utile in combinazione con il parametro INDEX per raggruppare pi\u00f9 aggiornamenti in una catena. Per impostazione predefinita, il comando SET_LED sincronizzer\u00e0 le modifiche con altri comandi gcode in corso. Ci\u00f2 pu\u00f2 comportare un comportamento indesiderato se i LED vengono impostati mentre la stampante non sta stampando in quanto reimposta il timeout di inattivit\u00e0. Se non \u00e8 necessaria una tempistica attenta, \u00e8 possibile specificare il parametro SYNC=0 opzionale per applicare le modifiche senza ripristinare il timeout di inattivit\u00e0.","title":"SET_LED"},{"location":"G-Codes.html#set_led_template","text":"SET_LED_TEMPLATE LED=<nome_led> TEMPLATE=<nome_modello> [<param_x>=<letterale>] [INDEX=<indice>] : Assegna un modello_visualizzazione a un dato LED . Ad esempio, se si definisce una sezione di configurazione [display_template my_led_template] allora si potrebbe assegnare TEMPLATE=my_led_template qui. Il display_template dovrebbe produrre una stringa separata da virgole contenente quattro numeri in virgola mobile corrispondenti alle impostazioni dei colori rosso, verde, blu e bianco. Il modello verr\u00e0 continuamente valutato e il LED verr\u00e0 impostato automaticamente sui colori risultanti. \u00c8 possibile impostare i parametri display_template da utilizzare durante la valutazione del modello (i parametri verranno analizzati come valori letterali Python). Se INDEX non \u00e8 specificato, tutti i chip nella catena dei LED verranno impostati sul modello, altrimenti verr\u00e0 aggiornato solo il chip con l'indice specificato. Se TEMPLATE \u00e8 una stringa vuota, questo comando canceller\u00e0 qualsiasi modello precedente assegnato al LED (\u00e8 quindi possibile utilizzare i comandi SET_LED per gestire le impostazioni del colore del LED).","title":"SET_LED_TEMPLATE"},{"location":"G-Codes.html#output_pin","text":"Il comando seguente \u00e8 disponibile quando una sezione di configurazione pin_output \u00e8 abilitata.","title":"[output_pin]"},{"location":"G-Codes.html#set_pin","text":"SET_PIN PIN=config_name VALUE=<value> [CYCLE_TIME=<cycle_time>] : Imposta il pin sull'output VALUE . VALUE dovrebbe essere 0 o 1 per i pin di uscita \"digital\". Per i pin PWM, impostare su un valore compreso tra 0.0 e 1.0 o tra 0.0 e scale se \u00e8 configurata una scala nella sezione di configurazione output_pin. Alcuni pin (attualmente solo pin \"soft PWM\") supportano l'impostazione di un tempo di ciclo esplicito utilizzando il parametro CYCLE_TIME (specificato in secondi). Si noti che il parametro CYCLE_TIME non \u00e8 memorizzato tra i comandi SET_PIN (qualsiasi comando SET_PIN senza un parametro CYCLE_TIME esplicito utilizzer\u00e0 il cycle_time specificato nella sezione di configurazione output_pin).","title":"SET_PIN"},{"location":"G-Codes.html#palette2","text":"I seguenti comandi sono disponibili quando la sezione di configurazione della palette2 \u00e8 abilitata. Le stampe di Palette funzionano incorporando speciali OCodes (Codici Omega) nel file GCode: O1 ... O32 : Questi codici vengono letti dal flusso GCode ed elaborati da questo modulo e passati al dispositivo Palette 2. Sono inoltre disponibili i seguenti comandi aggiuntivi.","title":"[palette2]"},{"location":"G-Codes.html#palette_connect","text":"PALETTE_CONNECT : questo comando inizializza la connessione con la Palette 2.","title":"PALETTE_CONNECT"},{"location":"G-Codes.html#palette_disconnect","text":"PALETTE_DISCONNECT : questo comando si disconnette dalla Palette 2.","title":"PALETTE_DISCONNECT"},{"location":"G-Codes.html#palette_clear","text":"PALETTE_CLEAR : questo comando indica alla Palette 2 di cancellare tutti i percorsi di input e output del filamento.","title":"PALETTE_CLEAR"},{"location":"G-Codes.html#palette_cut","text":"PALETTE_CUT : Questo comando indica alla Palette 2 di tagliare il filamento attualmente caricato nello splice core.","title":"PALETTE_CUT"},{"location":"G-Codes.html#palette_smart_load","text":"PALETTE_SMART_LOAD : Questo comando avvia la sequenza di caricamento intelligente sulla Palette 2. Il filamento viene caricato automaticamente estrudendolo alla distanza calibrata sul dispositivo per la stampante e istruisce la Palette 2 una volta completato il caricamento. Questo comando equivale a premere Smart Load direttamente sullo schermo della Palette 2 dopo che il caricamento del filamento \u00e8 stato completato.","title":"PALETTE_SMART_LOAD"},{"location":"G-Codes.html#pid_calibrate","text":"Il modulo pid_calibrate viene caricato automaticamente se nel file di configurazione \u00e8 definito un riscaldatore.","title":"[pid_calibrate]"},{"location":"G-Codes.html#pid_calibrate_1","text":"PID_CALIBRATE HEATER=<nome_config> TARGET=<temperatura> [WRITE_FILE=1] : esegue un test di calibrazione PID. Il riscaldatore specificato verr\u00e0 abilitato fino al raggiungimento della temperatura target specificata, quindi il riscaldatore verr\u00e0 spento e acceso per diversi cicli. Se il parametro WRITE_FILE \u00e8 abilitato, verr\u00e0 creato il file /tmp/heattest.txt con un log di tutti i campioni di temperatura prelevati durante il test.","title":"PID_CALIBRATE"},{"location":"G-Codes.html#pause_resume","text":"I seguenti comandi sono disponibili quando la pause_resume config section \u00e8 abilitata:","title":"[pause_resume]"},{"location":"G-Codes.html#pause","text":"PAUSE : mette in pausa la stampa corrente. La posizione attuale viene acquisita per la ripresa al ripristino.","title":"PAUSE"},{"location":"G-Codes.html#resume","text":"RESUME [VELOCITY=<value>] : riprende la stampa da una pausa, ripristinando prima la posizione precedentemente acquisita. Il parametro VELOCITY determina la velocit\u00e0 alla quale l'utensile deve tornare alla posizione originale acquisita.","title":"RESUME"},{"location":"G-Codes.html#clear_pause","text":"CLEAR_PAUSE : cancella lo stato di pausa corrente senza riprendere la stampa. Questo \u00e8 utile se si decide di annullare una stampa dopo un PAUSE. Si consiglia di aggiungerlo al gcode iniziale per assicurarsi che lo stato in pausa sia aggiornato per ogni stampa.","title":"CLEAR_PAUSE"},{"location":"G-Codes.html#cancel_print","text":"CANCEL_PRINT : Annulla la stampa corrente.","title":"CANCEL_PRINT"},{"location":"G-Codes.html#print_stats","text":"Il modulo print_stats viene caricato automaticamente.","title":"[print_stats]"},{"location":"G-Codes.html#set_print_stats_info","text":"SET_PRINT_STATS_INFO [TOTAL_LAYER=<total_layer_count>] [CURRENT_LAYER= <current_layer>] : passa le informazioni sulo slicer come il layer attivo ed il totale a Klipper. Aggiungi SET_PRINT_STATS_INFO [TOTAL_LAYER=<total_layer_count>] alla sezione gcode di inizio del tuo slicer e SET_PRINT_STATS_INFO [CURRENT_LAYER= <current_layer>] alla sezione gcode di cambio livello per passare le informazioni sul livello dal tuo slicer a Klipper.","title":"SET_PRINT_STATS_INFO"},{"location":"G-Codes.html#probe","text":"I seguenti comandi sono disponibili quando \u00e8 abilitata una sezione di configurazione della sonda o una sezione di configurazione di bltouch (consultare anche la guida alla calibrazione della sonda ).","title":"[probe]"},{"location":"G-Codes.html#sonda","text":"PROBE [PROBE_SPEED=<mm/s>] [LIFT_SPEED=<mm/s>] [SAMPLES=<count>] [SAMPLE_RETRACT_DIST=<mm>] [SAMPLES_TOLERANCE=<mm>] [SAMPLES_TOLERANCE_RETRIES=<count>] [SAMPLES_RESULT=median|average] : Sposta il nozzle verso il basso finch\u00e9 la sonda non scatta. Se viene fornito uno qualsiasi dei parametri opzionali, sovrascrive l'impostazione equivalente nella sezione probe config section .","title":"sonda"},{"location":"G-Codes.html#query_probe","text":"QUERY_PROBE : Riporta lo stato corrente della sonda (\"triggered\" o \"open\").","title":"QUERY_PROBE"},{"location":"G-Codes.html#probe_accuracy","text":"PROBE_ACCURACY [PROBE_SPEED=<mm/s>] [SAMPLES=<count>] [SAMPLE_RETRACT_DIST=<mm>] : Calcola la deviazione massima, minima, media, mediana e standard di pi\u00f9 campionamentidella sonda. Per impostazione predefinita, vengono presi 10 CAMPIONI. In caso contrario, i parametri opzionali sono impostati per default sulla loro impostazione equivalente nella sezione di configurazione della sonda.","title":"PROBE_ACCURACY"},{"location":"G-Codes.html#probe_calibrate","text":"PROBE_CALIBRATE [SPEED=<speed>] [<probe_parameter>=<value>] : Eseguire uno script di aiuto utile per calibrare l'offset z della sonda. Vedere il comando PROBE per i dettagli sui parametri opzionali della sonda. Vedere il comando MANUAL_PROBE per i dettagli del parametro SPEED e sui comandi aggiuntivi disponibili mentre lo strumento \u00e8 attivo. Nota che il comando PROBE_CALIBRATE utilizza la variabile di velocit\u00e0 per spostarsi in direzione XY e Z.","title":"PROBE_CALIBRATE"},{"location":"G-Codes.html#z_offset_apply_probe","text":"Z_OFFSET_APPLY_PROBE : prende l'offset Z Gcode corrente (aka, babystepping) e lo sottrae dallo z_offset della sonda. Questo per prendere un valore di babystep utilizzato di frequente e \"renderlo permanente\". Richiede un SAVE_CONFIG per avere effetto.","title":"Z_OFFSET_APPLY_PROBE"},{"location":"G-Codes.html#query_adc","text":"Il modulo query_adc viene caricato automaticamente.","title":"[query_adc]"},{"location":"G-Codes.html#query_adc_1","text":"QUERY_ADC [NAME=<config_name>] [PULLUP=<value>] : Riporta l'ultimo valore analogico ricevuto per un pin analogico configurato. Se NAME non viene fornito, viene riportato l'elenco dei nomi dei convertitori adc disponibili. Se viene fornito PULLUP (come valore in Ohm), viene riportato il valore analogico grezzo insieme alla resistenza equivalente dato quel pullup specificato.","title":"QUERY_ADC"},{"location":"G-Codes.html#query_endstops","text":"Il modulo query_endstops viene caricato automaticamente. I seguenti comandi G-Code standard sono attualmente disponibili, ma non \u00e8 consigliabile utilizzarli: Ottieni lo stato del finecorsa: M119 (usa invece QUERY_ENDSTOPS.)","title":"[query_endstops]"},{"location":"G-Codes.html#query_endstops_1","text":"QUERY_ENDSTOPS : Rilevare i finecorsa degli assi e segnala se sono \"attivate\" o in uno stato \"aperto\". Questo comando viene in genere utilizzato per verificare che un finecorsa funzioni correttamente.","title":"QUERY_ENDSTOPS"},{"location":"G-Codes.html#resonance_tester","text":"I seguenti comandi sono disponibili quando una sezione di configurazione di tester_risonanza \u00e8 abilitata (consultare anche la guida alle risonanze di misurazione ).","title":"[resonance_tester]"},{"location":"G-Codes.html#measure_axes_noise","text":"MEASURE_AXES_NOISE : misura ed riporta il rumore per tutti gli assi di tutti i chip dell'accelerometro abilitati.","title":"MEASURE_AXES_NOISE"},{"location":"G-Codes.html#test_resonances","text":"TEST_RESONANCES AXIS=<asse> OUTPUT=<risonanze,dati_grezzi> [NAME=<nome>] [FREQ_START=<freq_min>] [FREQ_END=<freq_max>] [HZ_PER_SEC=<hz_per_sec>] [CHIPS=<adxl345_chip_name>] [ POINT=x,y,z] [INPUT_SHAPING=[<0:1>]] : esegue il test di risonanza in tutti i punti sonda configurati per l'\"asse\" richiesto e misura l'accelerazione utilizzando i chip dell'accelerometro configurati per il rispettivo asse. \"asse\" pu\u00f2 essere X o Y, oppure specificare una direzione arbitraria come AXIS=dx,dy , dove dx e dy sono numeri in virgola mobile che definiscono un vettore di direzione (es. AXIS=X , AXIS=Y , o AXIS=1,-1 per definire una direzione diagonale). Nota che AXIS=dx,dy e AXIS=-dx,-dy sono equivalenti. adxl345_chip_name pu\u00f2 essere uno o pi\u00f9 chip adxl345 configurati, delimitati da virgole, ad esempio CHIPS=\"adxl345, adxl345 rpi\" . Nota che adxl345 pu\u00f2 essere omesso dai chip adxl345 denominati. Se POINT \u00e8 specificato, sovrascriver\u00e0 i punti configurati in [resonance_tester] . Se INPUT_SHAPING=0 o non impostato (predefinito), disabilita l'input shaping per il test di risonanza, perch\u00e9 non \u00e8 valido eseguire il test di risonanza con input shaper abilitato. Il parametro OUTPUT \u00e8 un elenco separato da virgole di cui verranno scritti gli output. Se viene richiesto raw_data , i dati grezzi dell'accelerometro vengono scritti in un file o in una serie di file /tmp/raw_data_<asse>_[<nome_chip>_][<punto>_]<nome>.csv con ( <punto>_ parte del nome generata solo se \u00e8 configurato pi\u00f9 di 1 punto sonda o \u00e8 specificato PUNTO). Se viene specificato resonances , la risposta in frequenza viene calcolata (su tutti i punti sonda) e scritta nel file /tmp/resonances_<asse>_<nome>.csv . Se non \u00e8 impostato, OUTPUT \u00e8 impostato su risonanze e NAME \u00e8 impostato sull'ora corrente nel formato \"AAAAMMGG_HHMMSS\".","title":"TEST_RESONANCES"},{"location":"G-Codes.html#shaper_calibrate","text":"SHAPER_CALIBRATE [AXIS=<asse>] [NAME=<nome>] [FREQ_START=<freq_min>] [FREQ_END=<freq_max>] [HZ_PER_SEC=<hz_per_sec>] [MAX_SMOOTHING=<livellamento_max>] : simile a TEST_RESONANCES , esegue il test di risonanza come configurato e cerca di trovare i parametri ottimali di input shaper per l'asse richiesto (o entrambi gli assi X e Y se il parametro AXIS non \u00e8 impostato). Se MAX_SMOOTHING non \u00e8 impostato, il suo valore viene preso dalla sezione [resonance_tester] , con l'impostazione predefinita non impostata. Per ulteriori informazioni sull'uso di questa funzione, vedere il Max smoothing della guida alla misurazione delle risonanze. I risultati dell'ottimizzazione vengono stampati sulla console e le risposte in frequenza e i diversi valori degli shaper di input vengono scritti in uno o pi\u00f9 file CSV /tmp/calibration_data_<asse>_<nome>.csv . A meno che non sia specificato, NAME imposta l'ora corrente nel formato \"AAAAMMGG_HHMMSS\". Nota che i parametri di input shaper suggeriti possono essere mantenuti nella configurazione eseguendo il comando SAVE_CONFIG .","title":"SHAPER_CALIBRATE"},{"location":"G-Codes.html#respond","text":"I seguenti comandi G-Code standard sono disponibili quando la sezione di configurazione di risposta \u00e8 abilitata: M118 <messaggio> : fa eco al messaggio preceduto dal prefisso predefinito configurato (o echo: se non \u00e8 configurato alcun prefisso). Sono inoltre disponibili i seguenti comandi aggiuntivi.","title":"[respond]"},{"location":"G-Codes.html#respond_1","text":"RESPOND MSG=\"<message>\" : echo il messaggio preceduto dal prefisso predefinito configurato (o echo: se non \u00e8 configurato alcun prefisso). RESPOND TYPE=echo MSG=\"<message>\" : echo del messaggio preceduto da echo: . RESPOND TYPE=echo_no_space MSG=\"<messaggio>\" : fa eco al messaggio preceduto da echo: senza uno spazio tra prefisso e messaggio, utile per la compatibilit\u00e0 con alcuni plugin di octoprint che prevedono una formattazione molto specifica. RESPOND TYPE=command MSG=\"<message>\" : echo il messaggio preceduto da // . OctoPrint pu\u00f2 essere configurato per rispondere a questi messaggi (ad es. RESPOND TYPE=command MSG=action:pause ). RESPOND TYPE=error MSG=\"<messaggio>\" : fa eco al messaggio preceduto da !! . RESPOND PREFIX=<prefix> MSG=\"<message>\" : echo il messaggio preceduto da <prefix> . (Il parametro PREFIX avr\u00e0 la priorit\u00e0 sul parametro TYPE )","title":"RESPOND"},{"location":"G-Codes.html#save_variables","text":"Il comando seguente \u00e8 abilitato se \u00e8 stata abilitata una sezione di configurazione save_variables .","title":"[save_variables]"},{"location":"G-Codes.html#save_variable","text":"SAVE_VARIABLE VARIABLE=<nome> VALUE=<valore> : salva la variabile su disco in modo che possa essere utilizzata tra i riavvii. Tutte le variabili memorizzate vengono caricate nel dict printer.save_variables.variables all'avvio e possono essere utilizzate nelle macro gcode. Il VALUE fornito viene analizzato come un valore letterale Python.","title":"SAVE_VARIABLE"},{"location":"G-Codes.html#screws_tilt_adjust","text":"I seguenti comandi sono disponibili quando la sezione di configurazione viti_tilt_adjust \u00e8 abilitata (consultare anche la manual level guide ).","title":"[screws_tilt_adjust]"},{"location":"G-Codes.html#screws_tilt_calculate","text":"SCREWS_TILT_CALCULATE [DIRECTION=CW|CCW] [MAX_DEVIATION=<value>] [<probe_parameter>=<value>] : Questo comando richiamer\u00e0 lo strumento di regolazione delle viti del piatto. Comander\u00e0 l'ugello in diverse posizioni (come definito nel file di configurazione) sondando l'altezza z e calcoler\u00e0 il numero di giri della manopola per regolare il livello del piatto. Se si specifica DIRECTION, le rotazioni della manopola saranno tutte nella stessa direzione, in senso orario (CW) o in senso antiorario (CCW). Vedere il comando PROBE per i dettagli sui parametri della sonda opzionali. IMPORTANTE: DEVI sempre eseguire un G28 prima di utilizzare questo comando. Se viene specificato MAX_DEVIATION, il comando generer\u00e0 un errore gcode se qualsiasi differenza nell'altezza della vite rispetto all'altezza della vite di base \u00e8 maggiore del valore fornito.","title":"SCREWS_TILT_CALCULATE"},{"location":"G-Codes.html#sdcard_loop","text":"Quando la sezione di configurazione sdcard_loop \u00e8 abilitata, sono disponibili i seguenti comandi estesi.","title":"[sdcard_loop]"},{"location":"G-Codes.html#sdcard_loop_begin","text":"SDCARD_LOOP_BEGIN COUNT=<count> : inizia una sezione in loop nella stampa SD. Un conteggio pari a 0 indica che la sezione deve essere ripetuta indefinitamente.","title":"SDCARD_LOOP_BEGIN"},{"location":"G-Codes.html#sdcard_loop_end","text":"SDCARD_LOOP_END : termina una sezione in loop nella stampa SD.","title":"SDCARD_LOOP_END"},{"location":"G-Codes.html#sdcard_loop_desist","text":"SDCARD_LOOP_DESIST : completa i loop esistenti senza ulteriori iterazioni.","title":"SDCARD_LOOP_DESIST"},{"location":"G-Codes.html#servo","text":"I seguenti comandi sono disponibili quando una sezione di configurazione servo \u00e8 abilitata.","title":"[servo]"},{"location":"G-Codes.html#set_servo","text":"SET_SERVO SERVO=nome_config [ANGLE=<gradi> | WIDTH=<secondi>] : Imposta la posizione del servo sull'angolo dato (in gradi) o sulla larghezza dell'impulso (in secondi). Usa WIDTH=0 per disabilitare l'uscita servo.","title":"SET_SERVO"},{"location":"G-Codes.html#skew_correction","text":"I seguenti comandi sono disponibili quando \u00e8 abilitata la sezione config_correzione_asimmetria (consultare anche la guida Correzione_asimmetria ).","title":"[skew_correction]"},{"location":"G-Codes.html#set_skew","text":"SET_SKEW [XY=<ac_length,bd_length,ad_length>] [XZ=<ac,bd,ad>] [YZ=<ac,bd,ad>] [CLEAR=<0|1>] : Configura il modulo [correzione_inclinazione ] con misure (in mm) tratte da una stampa di calibrazione. Si possono inserire misure per qualsiasi combinazione di piani, i piani non inseriti manterranno il loro valore attuale. Se viene immesso CLEAR=1 , tutta la correzione dell'inclinazione sar\u00e0 disabilitata.","title":"SET_SKEW"},{"location":"G-Codes.html#get_current_skew","text":"GET_CURRENT_SKEW : Riporta l'inclinazione corrente della stampante per ciascun piano sia in radianti che in gradi. L'inclinazione viene calcolata in base ai parametri forniti tramite il gcode SET_SKEW .","title":"GET_CURRENT_SKEW"},{"location":"G-Codes.html#calc_measured_skew","text":"CALC_MEASURED_SKEW [AC=<ac_length>] [BD=<bd_length>] [AD=<ad_length>] : calcola e riporta l'inclinazione (in radianti e gradi) in base a una stampa di test misurata. Questo pu\u00f2 essere utile per determinare l'inclinazione corrente della stampante dopo che \u00e8 stata applicata la correzione. Pu\u00f2 anche essere utile prima di applicare la correzione per determinare se \u00e8 necessaria la correzione dell'inclinazione. Vedere Correzione inclinazione per i dettagli su oggetti e misurazioni di calibrazione inclinazione.","title":"CALC_MEASURED_SKEW"},{"location":"G-Codes.html#skew_profile","text":"SKEW_PROFILE [LOAD=<nome>] [SAVE=<nome>] [REMOVE=<nome>] : Gestione del profilo per correzione_inclinazione. LOAD ripristiner\u00e0 lo stato di inclinazione dal profilo corrispondente al nome fornito. SAVE salver\u00e0 lo stato di inclinazione corrente in un profilo che corrisponde al nome fornito. REMOVE eliminer\u00e0 il profilo corrispondente al nome fornito dalla memoria persistente. Si noti che dopo aver eseguito le operazioni SAVE o REMOVE \u00e8 necessario eseguire il gcode SAVE_CONFIG per rendere permanenti le modifiche alla memoria persistente.","title":"SKEW_PROFILE"},{"location":"G-Codes.html#smart_effector","text":"Sono disponibili diversi comandi quando una sezione di configurazione smart_effector \u00e8 abilitata. Assicurati di controllare la documentazione ufficiale per Smart Effector su Duet3D Wiki prima di modificare i parametri di Smart Effector. Controllare anche la guida alla calibrazione della sonda .","title":"[smart_effector]"},{"location":"G-Codes.html#set_smart_effector","text":"SET_SMART_EFFECTOR [SENSITIVITY=<sensibilit\u00e0>] [ACCEL=<accel>] [RECOVERY_TIME=<tempo>] : imposta i parametri di Smart Effector. Quando viene specificato SENSITIVITY , il rispettivo valore viene scritto nella EEPROM dello SmartEffector (richiede che sia fornito control_pin ). I valori di <sensibilit\u00e0> accettabili sono 0..255, il valore predefinito \u00e8 50. Valori inferiori richiedono una minore forza di contatto dell'ugello per attivarsi (ma esiste un rischio maggiore di falso trigger a causa delle vibrazioni durante la tastatura) e valori pi\u00f9 alti riducono il falso trigger (ma richiede una maggiore forza di contatto per attivarsi). Poich\u00e9 la sensibilit\u00e0 viene scritta nella EEPROM, viene conservata dopo lo spegnimento e quindi non \u00e8 necessario configurarla ad ogni avvio della stampante. ACCEL e RECOVERY_TIME consentono di sovrascrivere i parametri corrispondenti in fase di esecuzione, vedere la sezione di configurazione di Smart Effector per maggiori informazioni su quei parametri.","title":"SET_SMART_EFFECTOR"},{"location":"G-Codes.html#reset_smart_effector","text":"RESET_SMART_EFFECTOR : Ripristina la sensibilit\u00e0 di Smart Effector alle impostazioni di fabbrica. Richiede che il relativo control_pin sia fornito nella sezione di configurazione.","title":"RESET_SMART_EFFECTOR"},{"location":"G-Codes.html#stepper_enable","text":"Il modulo stepper_enable viene caricato automaticamente.","title":"[stepper_enable]"},{"location":"G-Codes.html#set_stepper_enable","text":"SET_STEPPER_ENABLE STEPPER=<nome_config> ENABLE=[0|1] : Abilita o disabilita solo lo stepper dato. Questo \u00e8 uno strumento diagnostico e di debug e deve essere utilizzato con cautela. La disabilitazione di un motore dell'asse non ripristina le informazioni di homing. Lo spostamento manuale di uno stepper disabilitato pu\u00f2 causare l'azionamento del motore della macchina al di fuori dei limiti di sicurezza. Ci\u00f2 pu\u00f2 causare danni ai componenti dell'asse, al hotend e alla superficie di stampa.","title":"SET_STEPPER_ENABLE"},{"location":"G-Codes.html#temperature_fan","text":"Il comando seguente \u00e8 disponibile quando una sezione di configurazione della ventola_temperatura \u00e8 abilitata.","title":"[temperature_fan]"},{"location":"G-Codes.html#set_temperature_fan_target","text":"SET_TEMPERATURE_FAN_TARGET temperature_fan=<temperature_fan_name> [target=<target_temperature>] [min_speed=<min_speed>] [max_speed=<max_speed>] : Imposta la temperatura target per una temperature_fan. Se non viene fornito un target, viene impostato sulla temperatura specificata nel file di configurazione. Se le velocit\u00e0 non vengono fornite, non viene applicata alcuna modifica.","title":"SET_TEMPERATURE_FAN_TARGET"},{"location":"G-Codes.html#tmcxxxx","text":"I seguenti comandi sono disponibili quando una qualsiasi delle tmcXXXX config section \u00e8 abilitata.","title":"[tmcXXXX]"},{"location":"G-Codes.html#dump_tmc","text":"DUMP_TMC STEPPER=<nome> : questo comando legger\u00e0 i registri del driver TMC e ne riporter\u00e0 i valori.","title":"DUMP_TMC"},{"location":"G-Codes.html#init_tmc","text":"INIT_TMC STEPPER=<nome> : questo comando inizializzer\u00e0 i registri TMC. Necessario per riattivare il driver se l'alimentazione al chip viene spenta e poi riaccesa.","title":"INIT_TMC"},{"location":"G-Codes.html#set_tmc_current","text":"SET_TMC_CURRENT STEPPER=<nome> CURRENT=<amps> HOLDCURRENT=<amps> : Questo regoler\u00e0 le correnti di funzionamento e di mantenimento del driver TMC. (HOLDCURRENT non \u00e8 applicabile ai driver tmc2660.)","title":"SET_TMC_CURRENT"},{"location":"G-Codes.html#set_tmc_field","text":"SET_TMC_FIELD STEPPER=<nome> FIELD=<campo> VALUE=<valore> : Questo alterer\u00e0 il valore del campo del registro specificato del driver TMC. Questo comando \u00e8 destinato alla diagnostica e al debug di basso livello solo perch\u00e9 la modifica dei campi durante l'esecuzione pu\u00f2 causare comportamenti indesiderati e potenzialmente pericolosi della stampante. Le modifiche permanenti dovrebbero invece essere apportate utilizzando il file di configurazione della stampante. Non vengono eseguiti controlli di integrit\u00e0 per i valori indicati.","title":"SET_TMC_FIELD"},{"location":"G-Codes.html#toolhead","text":"Il modulo toolhead viene caricato automaticamente.","title":"[toolhead]"},{"location":"G-Codes.html#set_velocity_limit","text":"SET_VELOCITY_LIMIT [VELOCITY=<valore>] [ACCEL=<valore>] [ACCEL_TO_DECEL=<valore>] [SQUARE_CORNER_VELOCITY=<valore>] : Modifica i limiti di velocit\u00e0 della stampante.","title":"SET_VELOCITY_LIMIT"},{"location":"G-Codes.html#tuning_tower","text":"Il modulo tuning_tower viene caricato automaticamente.","title":"[tuning_tower]"},{"location":"G-Codes.html#tuning_tower_1","text":"TUNING_TOWER COMMAND=<comando> PARAMETER=<nome> START=<valore> [SKIP=<valore>] [FACTOR=<valore> [BAND=<valore>]] | [STEP_DELTA=<valore> STEP_HEIGHT=<valore>] : Uno strumento per regolare un parametro su ciascuna altezza Z durante una stampa. Lo strumento eseguir\u00e0 il dato COMMAND con il dato PARAMETER assegnato a un valore che varia con Z secondo una formula. Usa FACTOR se utilizzerai un righello o calibri per misurare l'altezza Z del valore ottimale, o STEP_DELTA e STEP_HEIGHT se il modello della torre di regolazione ha bande di valori discreti come \u00e8 comune con le torri della temperatura. Se viene specificato SKIP=<valore> , il processo di ottimizzazione non inizia finch\u00e9 non viene raggiunta l'altezza Z <valore> , e al di sotto di essa il valore sar\u00e0 impostato su START ; in questo caso, la z_height usata nelle formule seguenti \u00e8 in realt\u00e0 max(z - skip, 0) . Ci sono tre possibili combinazioni di opzioni: FACTOR : Il valore cambia a una velocit\u00e0 di factor per millimetro. La formula utilizzata \u00e8: valore = inizio + fattore * z_altezza . \u00c8 possibile inserire l'altezza Z ottimale direttamente nella formula per determinare il valore del parametro ottimale. FACTOR e BAND : il valore cambia a una velocit\u00e0 media di factor per millimetro, ma in bande discrete in cui la regolazione verr\u00e0 effettuata solo ogni BAND millimetri di altezza Z. La formula utilizzata \u00e8: value = start + factor * ((floor(z_height / band) + .5) * band) . STEP_DELTA e STEP_HEIGHT : il valore cambia di STEP_DELTA ogni STEP_HEIGHT millimetri. La formula utilizzata \u00e8: value = start + step_delta * floor(z_height / step_height) . Puoi semplicemente contare le bande o leggere le etichette della torre di tuning per determinare il valore ottimale.","title":"TUNING_TOWER"},{"location":"G-Codes.html#virtual_sdcard","text":"Klipper supporta i seguenti comandi G-Code standard se la sezione di configurazione di virtual_sdcard \u00e8 abilitata: Elenco scheda SD: M20 Inizializza scheda SD: M21 Selezionare il file SD: M23 <nomefile> Avvia/riprendi la stampa SD: M24 Sospendi la stampa SD: M25 Impostare la posizione SD: M26 S<offset> Riporta lo stato di stampa SD: M27 Inoltre, quando la sezione di configurazione \"virtual_sdcard\" \u00e8 abilitata, sono disponibili i seguenti comandi estesi.","title":"[virtual_sdcard]"},{"location":"G-Codes.html#sdcard_print_file","text":"SDCARD_PRINT_FILE FILENAME=<nomefile> : carica un file e avvia la stampa SD.","title":"SDCARD_PRINT_FILE"},{"location":"G-Codes.html#sdcard_reset_file","text":"SDCARD_RESET_FILE : Scarica il file e cancella lo stato SD.","title":"SDCARD_RESET_FILE"},{"location":"G-Codes.html#z_thermal_adjust","text":"I seguenti comandi sono disponibili quando la sezione z_thermal_adjust config \u00e8 abilitata.","title":"[z_thermal_adjust]"},{"location":"G-Codes.html#set_z_thermal_adjust","text":"SET_Z_THERMAL_ADJUST [ENABLE=<0:1>] [TEMP_COEFF=<valore>] [REF_TEMP=<valore>] : Abilita o disabilita la regolazione termica Z con ENABLE . La disabilitazione non rimuove alcuna regolazione gi\u00e0 applicata, ma congela il valore di regolazione corrente - questo impedisce il movimento Z verso il basso potenzialmente pericoloso. La riattivazione pu\u00f2 potenzialmente causare il movimento dell'utensile verso l'alto quando la regolazione viene aggiornata e applicata. TEMP_COEFF consente la regolazione in tempo reale del coefficiente di temperatura di regolazione (cio\u00e8 il parametro di configurazione TEMP_COEFF ). I valori TEMP_COEFF non vengono salvati nella configurazione. REF_TEMP sovrascrive manualmente la temperatura di riferimento tipicamente impostata durante l'homing (per l'uso, ad esempio, in routine di homing non standard) - verr\u00e0 ripristinata automaticamente durante l'homing.","title":"SET_Z_THERMAL_ADJUST"},{"location":"G-Codes.html#z_tilt","text":"I seguenti comandi sono disponibili quando la sezione z_tilt config \u00e8 abilitata.","title":"[z_tilt]"},{"location":"G-Codes.html#z_tilt_adjust","text":"Z_TILT_ADJUST [<probe_parameter>=<value>] : questo comando sonder\u00e0 i punti specificati nella configurazione e quindi apporter\u00e0 regolazioni indipendenti a ciascuno Z stepper per compensare l'inclinazione. Vedere il comando PROBE per i dettagli sui parametri opzionali della sonda.","title":"Z_TILT_ADJUST"},{"location":"Hall_Filament_Width_Sensor.html","text":"Sensore di Hall per larghezza del filamento \u00b6 Questo documento descrive il modulo host del sensore di larghezza del filamento Filament Width Sensor. L'hardware utilizzato per lo sviluppo di questo modulo host si basa su due sensori lineari Hall (ad esempio ss49e). I sensori nel corpo si trovano ai lati opposti. Principio di funzionamento: due sensori Hall funzionano in modalit\u00e0 differenziale, la stessa deriva di temperatura per il sensore. Non \u00e8 necessaria una speciale compensazione della temperatura. Puoi trovare i design su Thingiverse , un video di assemblaggio \u00e8 disponibile anche su Youtube Per utilizzare il sensore di larghezza del filamento Hall, leggere Config Reference e G-Code documentation . Come funziona? \u00b6 Il sensore genera due uscite analogiche in base alla larghezza del filamento calcolata. La somma della tensione di uscita \u00e8 sempre uguale alla larghezza del filamento rilevata. Il modulo host monitora le variazioni di tensione e regola il moltiplicatore di estrusione. Uso il connettore aux2 su una scheda simile a rampe analog11 e analog12 pin. Puoi usare diversi pin e diverse schede. Modello per variabili di menu \u00b6 [menu __main __filament __width_current] type: command enable: {'hall_filament_width_sensor' in printer} name: Dia: {'%.2F' % printer.hall_filament_width_sensor.Diameter} index: 0 [menu __main __filament __raw_width_current] type: command enable: {'hall_filament_width_sensor' in printer} name: Raw: {'%4.0F' % printer.hall_filament_width_sensor.Raw} index: 1 Procedura di calibrazione \u00b6 Per ottenere il valore grezzo del sensore \u00e8 possibile utilizzare la voce di menu o il comando QUERY_RAW_FILAMENT_WIDTH nel terminale. Inserire la prima barra di calibrazione (dimensione 1,5 mm) ottenere il primo valore grezzo del sensore Inserire la seconda barra di calibrazione (dimensione 2,0 mm) per ottenere il secondo valore grezzo del sensore Salva i valori grezzi del sensore nel parametro di configurazione Raw_dia1 e Raw_dia2 Come abilitare il sensore \u00b6 Per impostazione predefinita, il sensore \u00e8 disabilitato all'accensione. Per abilitare il sensore, emettere il comando ENABLE_FILAMENT_WIDTH_SENSOR o impostare il parametro enable su true . Registrazione \u00b6 Per impostazione predefinita, la registrazione del diametro \u00e8 disabilitata all'accensione. Emettere il comando ENABLE_FILAMENT_WIDTH_LOG per avviare la registrazione ed emettere il comando DISABLE_FILAMENT_WIDTH_LOG per interrompere la registrazione. Per abilitare la registrazione all'accensione, impostare il parametro logging su true . Il diametro del filamento viene registrato con un intervallo di misurazione (10 mm per impostazione predefinita).","title":"Sensore di Hall per larghezza del filamento"},{"location":"Hall_Filament_Width_Sensor.html#sensore-di-hall-per-larghezza-del-filamento","text":"Questo documento descrive il modulo host del sensore di larghezza del filamento Filament Width Sensor. L'hardware utilizzato per lo sviluppo di questo modulo host si basa su due sensori lineari Hall (ad esempio ss49e). I sensori nel corpo si trovano ai lati opposti. Principio di funzionamento: due sensori Hall funzionano in modalit\u00e0 differenziale, la stessa deriva di temperatura per il sensore. Non \u00e8 necessaria una speciale compensazione della temperatura. Puoi trovare i design su Thingiverse , un video di assemblaggio \u00e8 disponibile anche su Youtube Per utilizzare il sensore di larghezza del filamento Hall, leggere Config Reference e G-Code documentation .","title":"Sensore di Hall per larghezza del filamento"},{"location":"Hall_Filament_Width_Sensor.html#come-funziona","text":"Il sensore genera due uscite analogiche in base alla larghezza del filamento calcolata. La somma della tensione di uscita \u00e8 sempre uguale alla larghezza del filamento rilevata. Il modulo host monitora le variazioni di tensione e regola il moltiplicatore di estrusione. Uso il connettore aux2 su una scheda simile a rampe analog11 e analog12 pin. Puoi usare diversi pin e diverse schede.","title":"Come funziona?"},{"location":"Hall_Filament_Width_Sensor.html#modello-per-variabili-di-menu","text":"[menu __main __filament __width_current] type: command enable: {'hall_filament_width_sensor' in printer} name: Dia: {'%.2F' % printer.hall_filament_width_sensor.Diameter} index: 0 [menu __main __filament __raw_width_current] type: command enable: {'hall_filament_width_sensor' in printer} name: Raw: {'%4.0F' % printer.hall_filament_width_sensor.Raw} index: 1","title":"Modello per variabili di menu"},{"location":"Hall_Filament_Width_Sensor.html#procedura-di-calibrazione","text":"Per ottenere il valore grezzo del sensore \u00e8 possibile utilizzare la voce di menu o il comando QUERY_RAW_FILAMENT_WIDTH nel terminale. Inserire la prima barra di calibrazione (dimensione 1,5 mm) ottenere il primo valore grezzo del sensore Inserire la seconda barra di calibrazione (dimensione 2,0 mm) per ottenere il secondo valore grezzo del sensore Salva i valori grezzi del sensore nel parametro di configurazione Raw_dia1 e Raw_dia2","title":"Procedura di calibrazione"},{"location":"Hall_Filament_Width_Sensor.html#come-abilitare-il-sensore","text":"Per impostazione predefinita, il sensore \u00e8 disabilitato all'accensione. Per abilitare il sensore, emettere il comando ENABLE_FILAMENT_WIDTH_SENSOR o impostare il parametro enable su true .","title":"Come abilitare il sensore"},{"location":"Hall_Filament_Width_Sensor.html#registrazione","text":"Per impostazione predefinita, la registrazione del diametro \u00e8 disabilitata all'accensione. Emettere il comando ENABLE_FILAMENT_WIDTH_LOG per avviare la registrazione ed emettere il comando DISABLE_FILAMENT_WIDTH_LOG per interrompere la registrazione. Per abilitare la registrazione all'accensione, impostare il parametro logging su true . Il diametro del filamento viene registrato con un intervallo di misurazione (10 mm per impostazione predefinita).","title":"Registrazione"},{"location":"Installation.html","text":"Installazione \u00b6 Queste istruzioni partono dal presupposto che Klipper girer\u00e0 su un Raspberry Pi con OctoPrint. \u00c8 consigliato l'utilizzo di un Raspberry Pi 2, 3 o 4 (vedi la FAQ per utilizzare un hardware diverso). Ottenere un file di configurazione di Klipper \u00b6 La maggior parte delle impostazioni di Klipper sono determinate da un \"file di configurazione della stampante\" che verr\u00e0 archiviato sul Raspberry Pi. Un file di configurazione appropriato pu\u00f2 spesso essere trovato cercando in Klipper directory config 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. Se non c'\u00e8 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. Se non \u00e8 possibile trovare alcun file di configurazione per la stampante, ma si conosce il tipo di scheda di controllo della stampante, cercare un file di configurazione 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\u00e0 completa della stampante. \u00c8 anche possibile definire da zero una nuova configurazione della stampante. Tuttavia, ci\u00f2 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\u00f9 vicino file di configurazione e utilizzare Klipper riferimento alla configurazione per ulteriori informazioni. Preparazione dell'immagine del sistema operativo \u00b6 Iniziate installando OctoPi sul computer Raspberry Pi. Usa OctoPi v0.17.0 o successivo - vedi OctoPi releases 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. Dopo aver installato OctoPi ed aver aggiornato OctoPrint all'ultima versione sar\u00e0 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\u00e0 essere installato sul tuo sistema. Esistono vari client ssh disponibili (ad esempio PuTTY ). Usa il programma ssh per connetterti al Raspberry Pi (ssh pi@octopi -- la password \u00e8 \"raspberry\") ed esegui questi comandi: git clone https://github.com/Klipper3d/klipper ./klipper/scripts/install-octopi.sh Questo scaricher\u00e0 Klipper, installer\u00e0 alcune dipendenze, imposter\u00e0 Klipper per essere eseguito all'avvio del sistema e avvier\u00f2 il programma host Klipper. Sar\u00e0 necessario che il Raspberry abbia accesso ad internet e richeder\u00e0 alcuni minuti. Compilare il firmware e flashare il microcontrollore \u00b6 Per compilare il firmware per il microcontrollore, iniziamo lanciando questi comandi sul Raspberry: cd ~/klipper/ make menuconfig I commenti nella parte superiore del file di configurazione della stampante dovrebbero descrivere le impostazioni che devono essere impostate durante \"make menuconfig\". Apri il file in un browser web o in un editor di testo e cerca queste istruzioni nella parte superiore del file. Una volta configurate le impostazioni \"menuconfig\" appropriate, premere \"Q\" per uscire, quindi \"Y\" per salvare. Quindi esegui: make Se i commenti nella parte superiore del file di configurazione della stampante descrivono i passaggi personalizzati per il \"flash\" dell'immagine finale sulla scheda di controllo della stampante, segui questi passaggi e poi procedi con configurazione OctoPrint . In caso contrario, i seguenti passaggi vengono spesso utilizzati per eseguire il \"flash\" della scheda di controllo della stampante. Innanzitutto \u00e8 necessario determinare la porta seriale collegata al microcontrollore. Esegui quanto segue: ls /dev/serial/by-id/* Dovrebbe venire riportato qualcosa di simile a questo: /dev/serial/by-id/usb-1a86_USB2.0-Serial-if00-port0 \u00c8 abbastanza comune che ogni stampante 3D abbia il suo nome univoco elencato come porta seriale. Questo nome sar\u00e0 utilizzato quando flasheremo il microcontrollore. \u00c8 possibile che ci possano essere pi\u00f9 righe nell'elenco sopraccitato, se \u00e8 cos\u00ec seleziona la riga cosrrispondente al microcontrollore (vedi le FAQ per maggiori informazioni). Per i microcontrollori pi\u00f9 comuni, il firmware pu\u00f2 essere flashato con comandi tipo: sudo service klipper stop make flash FLASH_DEVICE=/dev/serial/by-id/usb-1a86_USB2.0-Serial-if00-port0 sudo service klipper start Assicurati di mettere al posto di FLASH_DEVICE il nome della porta seriale associato alla stampante. 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\"). Configurare OctoPrint per usare Klipper \u00b6 Il sistema OctoPrint deve essere configurato per comunicare con il sistema Klipper. Loggati su OctoPrint e confogura queste parti: Naviga nella scheda Impostazioni (la chiave inglese in cima alla pagina). Dentro \"Serial Connection\", \"Additional serial ports\" aggiungi \"/tmp/printer\". Poi fai \"Save\". Vai nella scheda Impostazioni e sotto \"Serial Connection\" cambia la \"Serial Port\" in \"/tmp/printer\". Nella scheda Impostazioni, vai in \"Behavior\" e seleziona l'opzione \"Cancel any ongoing prints but stay connected to the printer\", poi \"Save\". 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 \u00e8 visualizzata prova a ricaricare la pagina. 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\u00e0 un messaggio di errore sull'apertura del file config, questo significa che OctoPrint sta comunicando correttamente con Klipper. Possiamo proseguire. Configurare Klipper \u00b6 Il passaggio successivo consiste nel copiare il file di configurazione della stampante sul Raspberry Pi. Probabilmente il modo pi\u00f9 semplice per impostare il file di configurazione di Klipper \u00e8 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). In alternativa, si pu\u00f2 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): cp ~/klipper/config/example-cartesian.cfg ~/printer.cfg nano ~/printer.cfg \u00c8 comune che ogni stampante abbia il proprio nome univoco per il microcontrollore. Il nome potrebbe cambiare dopo aver eseguito il flashing di Klipper, quindi ripeti questi passaggi anche se erano gi\u00e0 stati eseguiti durante il flashing. Eseguire: ls /dev/serial/by-id/* Dovrebbe venire riportato qualcosa di simile a questo: /dev/serial/by-id/usb-1a86_USB2.0-Serial-if00-port0 Quindi aggiorna il file di configurazione con il nome univoco. Ad esempio, aggiorna la sezione [mcu] in modo che assomigli a qualcosa di simile a: [mcu] serial: /dev/serial/by-id/usb-1a86_USB2.0-Serial-if00-port0 Dopo aver creato e modificato il file sar\u00e0 necessario emettere un comando di \"restart\" nel terminale web di OctoPrint per caricare il file config. Un comando \"status\" segnaler\u00e0 che la stampante \u00e8 pronta se il file di configurazione di Klipper viene letto correttamente e il microcontrollore \u00e8 stato trovato e configurato correttamente. Quando si personalizza il file di configurazione della stampante, non \u00e8 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\u00e9 \"status\" non segnala che la stampante \u00e8 pronta. Klipper riferisce i messaggi di errore tramite il terminale di OctoPrint. Il comando \"status\" pu\u00f2 essere usato per visualizzare nuovamente eventuali messaggi di errore. Lo script di startup di default di Klipper generer\u00e0 un log sotto /tmp/klippy.log , questo fornir\u00e0 informazioni pi\u00f9 dettagliate. Dopo che Klipper ha segnalato che la stampante \u00e8 pronta, vai al config check document per eseguire alcuni controlli di base sulle definizioni nel file di configurazione. Vedere i documentation reference per altre informazioni.","title":"Installazione"},{"location":"Installation.html#installazione","text":"Queste istruzioni partono dal presupposto che Klipper girer\u00e0 su un Raspberry Pi con OctoPrint. \u00c8 consigliato l'utilizzo di un Raspberry Pi 2, 3 o 4 (vedi la FAQ per utilizzare un hardware diverso).","title":"Installazione"},{"location":"Installation.html#ottenere-un-file-di-configurazione-di-klipper","text":"La maggior parte delle impostazioni di Klipper sono determinate da un \"file di configurazione della stampante\" che verr\u00e0 archiviato sul Raspberry Pi. Un file di configurazione appropriato pu\u00f2 spesso essere trovato cercando in Klipper directory config 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. Se non c'\u00e8 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. Se non \u00e8 possibile trovare alcun file di configurazione per la stampante, ma si conosce il tipo di scheda di controllo della stampante, cercare un file di configurazione 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\u00e0 completa della stampante. \u00c8 anche possibile definire da zero una nuova configurazione della stampante. Tuttavia, ci\u00f2 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\u00f9 vicino file di configurazione e utilizzare Klipper riferimento alla configurazione per ulteriori informazioni.","title":"Ottenere un file di configurazione di Klipper"},{"location":"Installation.html#preparazione-dellimmagine-del-sistema-operativo","text":"Iniziate installando OctoPi sul computer Raspberry Pi. Usa OctoPi v0.17.0 o successivo - vedi OctoPi releases 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. Dopo aver installato OctoPi ed aver aggiornato OctoPrint all'ultima versione sar\u00e0 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\u00e0 essere installato sul tuo sistema. Esistono vari client ssh disponibili (ad esempio PuTTY ). Usa il programma ssh per connetterti al Raspberry Pi (ssh pi@octopi -- la password \u00e8 \"raspberry\") ed esegui questi comandi: git clone https://github.com/Klipper3d/klipper ./klipper/scripts/install-octopi.sh Questo scaricher\u00e0 Klipper, installer\u00e0 alcune dipendenze, imposter\u00e0 Klipper per essere eseguito all'avvio del sistema e avvier\u00f2 il programma host Klipper. Sar\u00e0 necessario che il Raspberry abbia accesso ad internet e richeder\u00e0 alcuni minuti.","title":"Preparazione dell'immagine del sistema operativo"},{"location":"Installation.html#compilare-il-firmware-e-flashare-il-microcontrollore","text":"Per compilare il firmware per il microcontrollore, iniziamo lanciando questi comandi sul Raspberry: cd ~/klipper/ make menuconfig I commenti nella parte superiore del file di configurazione della stampante dovrebbero descrivere le impostazioni che devono essere impostate durante \"make menuconfig\". Apri il file in un browser web o in un editor di testo e cerca queste istruzioni nella parte superiore del file. Una volta configurate le impostazioni \"menuconfig\" appropriate, premere \"Q\" per uscire, quindi \"Y\" per salvare. Quindi esegui: make Se i commenti nella parte superiore del file di configurazione della stampante descrivono i passaggi personalizzati per il \"flash\" dell'immagine finale sulla scheda di controllo della stampante, segui questi passaggi e poi procedi con configurazione OctoPrint . In caso contrario, i seguenti passaggi vengono spesso utilizzati per eseguire il \"flash\" della scheda di controllo della stampante. Innanzitutto \u00e8 necessario determinare la porta seriale collegata al microcontrollore. Esegui quanto segue: ls /dev/serial/by-id/* Dovrebbe venire riportato qualcosa di simile a questo: /dev/serial/by-id/usb-1a86_USB2.0-Serial-if00-port0 \u00c8 abbastanza comune che ogni stampante 3D abbia il suo nome univoco elencato come porta seriale. Questo nome sar\u00e0 utilizzato quando flasheremo il microcontrollore. \u00c8 possibile che ci possano essere pi\u00f9 righe nell'elenco sopraccitato, se \u00e8 cos\u00ec seleziona la riga cosrrispondente al microcontrollore (vedi le FAQ per maggiori informazioni). Per i microcontrollori pi\u00f9 comuni, il firmware pu\u00f2 essere flashato con comandi tipo: sudo service klipper stop make flash FLASH_DEVICE=/dev/serial/by-id/usb-1a86_USB2.0-Serial-if00-port0 sudo service klipper start Assicurati di mettere al posto di FLASH_DEVICE il nome della porta seriale associato alla stampante. 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\").","title":"Compilare il firmware e flashare il microcontrollore"},{"location":"Installation.html#configurare-octoprint-per-usare-klipper","text":"Il sistema OctoPrint deve essere configurato per comunicare con il sistema Klipper. Loggati su OctoPrint e confogura queste parti: Naviga nella scheda Impostazioni (la chiave inglese in cima alla pagina). Dentro \"Serial Connection\", \"Additional serial ports\" aggiungi \"/tmp/printer\". Poi fai \"Save\". Vai nella scheda Impostazioni e sotto \"Serial Connection\" cambia la \"Serial Port\" in \"/tmp/printer\". Nella scheda Impostazioni, vai in \"Behavior\" e seleziona l'opzione \"Cancel any ongoing prints but stay connected to the printer\", poi \"Save\". 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 \u00e8 visualizzata prova a ricaricare la pagina. 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\u00e0 un messaggio di errore sull'apertura del file config, questo significa che OctoPrint sta comunicando correttamente con Klipper. Possiamo proseguire.","title":"Configurare OctoPrint per usare Klipper"},{"location":"Installation.html#configurare-klipper","text":"Il passaggio successivo consiste nel copiare il file di configurazione della stampante sul Raspberry Pi. Probabilmente il modo pi\u00f9 semplice per impostare il file di configurazione di Klipper \u00e8 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). In alternativa, si pu\u00f2 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): cp ~/klipper/config/example-cartesian.cfg ~/printer.cfg nano ~/printer.cfg \u00c8 comune che ogni stampante abbia il proprio nome univoco per il microcontrollore. Il nome potrebbe cambiare dopo aver eseguito il flashing di Klipper, quindi ripeti questi passaggi anche se erano gi\u00e0 stati eseguiti durante il flashing. Eseguire: ls /dev/serial/by-id/* Dovrebbe venire riportato qualcosa di simile a questo: /dev/serial/by-id/usb-1a86_USB2.0-Serial-if00-port0 Quindi aggiorna il file di configurazione con il nome univoco. Ad esempio, aggiorna la sezione [mcu] in modo che assomigli a qualcosa di simile a: [mcu] serial: /dev/serial/by-id/usb-1a86_USB2.0-Serial-if00-port0 Dopo aver creato e modificato il file sar\u00e0 necessario emettere un comando di \"restart\" nel terminale web di OctoPrint per caricare il file config. Un comando \"status\" segnaler\u00e0 che la stampante \u00e8 pronta se il file di configurazione di Klipper viene letto correttamente e il microcontrollore \u00e8 stato trovato e configurato correttamente. Quando si personalizza il file di configurazione della stampante, non \u00e8 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\u00e9 \"status\" non segnala che la stampante \u00e8 pronta. Klipper riferisce i messaggi di errore tramite il terminale di OctoPrint. Il comando \"status\" pu\u00f2 essere usato per visualizzare nuovamente eventuali messaggi di errore. Lo script di startup di default di Klipper generer\u00e0 un log sotto /tmp/klippy.log , questo fornir\u00e0 informazioni pi\u00f9 dettagliate. Dopo che Klipper ha segnalato che la stampante \u00e8 pronta, vai al config check document per eseguire alcuni controlli di base sulle definizioni nel file di configurazione. Vedere i documentation reference per altre informazioni.","title":"Configurare Klipper"},{"location":"Kinematics.html","text":"Cinematica \u00b6 Questo documento \u00e8 una panoramica su come Klipper implementa la movimentazione del sistema meccanico(la sua cinematica ). Questi contenuti potrebbero interessare sia gli sviluppatori che intendono lacorare sul software Klipper che gli utenti che desiderano comprendere meglio il funzionamento delle proprie macchine. Accelerazione \u00b6 Klipper utilizza uno schema ad accelerazione costrante ogni qualvolta la testa di stampa cambia velocit\u00e0 - la velocit\u00e0 viene gradualmente variata fino a raggiungere la nuova velocit\u00e0 invece di strattonare direttamente alla nuova velocit\u00e0. Klipper mantiene sempre l'accelerazione tra la testa di stampa e la stampa. Il filamento in uscita dall'ugello pu\u00f2 essere piuttosto fragile, rapidi sobbalzi e/o cambi di flusso di estrusione portano a cattiva qualit\u00e0 di stampa e bassa adesione al piano di stampa. Anche quando non viene estruso filamento, se l'ugello si trova allo stesso livello della stampa, un repentino cambio di velocit\u00e0 potrebbe disturbare il filamento appena depositato. Limitare i cambi di velocit\u00e0 della testa di stampa relativamente alla stampa riduce il rischio di rovinare la stampa. \u00c8 anche importante limitare l'accelerazione in modo da evitare che i motori stepper perdano passi e per ridurre le sollecitazioni alla macchina. Klipper limita la coppia su ciascuno stepper mediante la limitazione dell'accelerazione sulla testina di stampa. Imporre l'accelerazione alla testa di stampa ha la conseguenza naturale di limitare la coppia degli stepper che la muovono (l'inverso non \u00e8 sempre vero). Klipper implementa l'accelerazione costante. La formula chiave per l'accelerazione costante \u00e8: velocit\u00e0(tempo) = velocit\u00e0_inizio + accelerazione*tempo Generatore di trapezoide \u00b6 Klipper utilizza un \"generatore di trapezoide\" di tipo tradizionale per modellare il movimento - ogni movimento ha una velocit\u00e0 iniziale, accelera verso la velocit\u00e0 di crociera ad accelerazione costante, prosegue a velocit\u00e0 costante ed infine decelera fino alla velocit\u00e0 finale ad accelerazione costante. Viene detto \"generatore di trapezoide\" perch\u00e9 il diagramma di velocit\u00e0 del movimento sembra un trapezoide. La velocit\u00e0 di crociera \u00e8 sempre maggiore o uguale sia alla velocit\u00e0 iniziale che a quella finale. La fase di accelerazione potrebbe avere durata zero (se la velocit\u00e0 iniziale \u00e8 uguale alla velocit\u00e0 di crociera), la fase di movimento a valocit\u00e0 costante potrebbe avere durata zero (se il movimento inizia a decelerare subito l'accelerazione) e/o la fase di decelerazione potrebbe avere durata zero (se la velocit\u00e0 finale \u00e8 uguale alla velocit\u00e0 di crociera). Look-ahead (Precalcolo) \u00b6 Il sistema di \"look-ahead\" (precalcolo) \u00e8 usato per determinare le velocit\u00e0 nelle giunzioni tra movimenti (cornering speed). Consideriamo questi due movimenti sul piano XY: Nella situazione sopra descritta \u00e8 possibile decelerare completamente dopo il primo movimento e poi accelerare all'inizio del movimento successivo; per\u00f2 questo non \u00e8 un comportamento ideale dato che continue accelerazioni e decelerazioni aumentano il tempo di stampa e continue variazioni nel flusso dell'estrusore peggiorano la qualit\u00e0 di stampa. Per risolvere questo problema, la funzione \"look-ahead\" (precalcolo) accoda i movimenti da eseguire ed analizza gli angoli tra essi per calcolare la velocit\u00e0 da usare nella giunzione tra due movimenti. Se il prossimo movimento \u00e8 all'incirca nella stessa direzione del precedente, la testina di stampa deve rallentare molto poco (se non per nulla). Se per\u00f2 il prossimo movimento forma un angolo acuto (la testina deve praticamente invertire la direzione di marcia), la velocit\u00e0 alla giunzione sar\u00e0 piccola. Le velocit\u00e0 di giunzione sono determinate utilizzando \"accelerazione centripeta approssimata\". Meglio su descritto dall'autore . Tuttavia, in Klipper, le velocit\u00e0 di giunzione sono configurate specificando la velocit\u00e0 desiderata che dovrebbe avere un angolo di 90\u00b0 (la \"velocit\u00e0 dell'angolo retto\") e da quella vengono derivate le velocit\u00e0 di giunzione per altri angoli. Formula chiave per il look-ahead: velocit\u00e0_finale^2 = velocit\u00e0_iniziale^2 + 2*accelerazione*distanza_movimento Look-ahead ammorbidito \u00b6 Klipper implementa anche un meccanismo per smussare i movimenti di brevi movimenti a \"zigzag\". Considera i seguenti movimenti: In quanto sopra, i frequenti passaggi dall'accelerazione alla decelerazione possono causare vibrazioni della macchina che provocano sollecitazioni e aumentano la rumorosit\u00e0. Per ridurre questo, Klipper tiene traccia sia dell'accelerazione di movimento regolare che di una velocit\u00e0 virtuale di \"accelerazione alla decelerazione\". Utilizzando questo sistema, la velocit\u00e0 massima di questi brevi movimenti a \"zigzag\" \u00e8 limitata per rendere pi\u00f9 fluido il movimento della stampante: In particolare, il codice calcola quale sarebbe la velocit\u00e0 di ogni mossa se fosse limitata a questa velocit\u00e0 di \"accelerazione alla decelerazione\" virtuale (la met\u00e0 della velocit\u00e0 di accelerazione normale per impostazione predefinita). Nell'immagine sopra le linee grigie tratteggiate rappresentano questa velocit\u00e0 di accelerazione virtuale per il primo movimento. Se un movimento non pu\u00f2 raggiungere la sua piena velocit\u00e0 di crociera usando questa velocit\u00e0 di accelerazione virtuale, la sua velocit\u00e0 massima viene ridotta alla velocit\u00e0 massima che potrebbe ottenere a questa velocit\u00e0 di accelerazione virtuale. Per la maggior parte dei movimenti il limite sar\u00e0 pari o superiore ai limiti esistenti del movimento e non verr\u00e0 indotto alcun cambiamento nel comportamento. Per brevi movimenti a zigzag, tuttavia, questo limite riduce la velocit\u00e0 massima. Nota che non cambia l'accelerazione effettiva all'interno del movimento: Il movimento continua a utilizzare lo schema di accelerazione normale fino alla sua velocit\u00e0 massima regolata. Generazione di passi \u00b6 Una volta completato il processo di look-ahead, il movimento della testina di stampa per il dato spostamento \u00e8 completamente noto (tempo, posizione iniziale, posizione finale, velocit\u00e0 in ogni punto) ed \u00e8 possibile generare i tempi di passaggio per lo spostamento. Questo processo viene eseguito all'interno di \"classi cinematiche\" nel codice di Klipper. Al di fuori di queste classi cinematiche, tutto viene tracciato in millimetri, secondi e nello spazio delle coordinate cartesiane. \u00c8 compito delle classi cinematiche convertire da questo sistema di coordinate generico alle specifiche hardware di una particolare stampante. Klipper utilizza un risolutore iterativo per generare i tempi dei passo per ogni stepper. Il codice contiene le formule per calcolare le coordinate cartesiane ideali della testa in ogni momento e ha le formule cinematiche per calcolare le posizioni ideali dello stepper in base a quelle coordinate cartesiane. Con queste formule, Klipper pu\u00f2 determinare il tempo ideale in cui lo stepper dovrebbe trovarsi in ogni posizione del passo. I passaggi indicati vengono quindi programmati in questi orari calcolati. La formula chiave per determinare la distanza che un movimento deve percorrere con un'accelerazione costante \u00e8: distanza_movimento = (velocita_iniziale + .5 * accelerazione *durata_movimento) * durata_movimento e la formula chiave per il movimento a velocit\u00e0 costante \u00e8: distanza_movimento = velocit\u00e0_crociera * durata_movimento Le formule chiave per determinare la coordinata cartesiana di un movimento data una distanza di movimento sono: cartesian_x_position = start_x + move_distance * total_x_movement / total_movement cartesian_y_position = start_y + move_distance * total_y_movement / total_movement cartesian_z_position = start_z + move_distance * total_z_movement / total_movement Robot Cartesiani \u00b6 La generazione di passaggi per stampanti cartesiane \u00e8 il caso pi\u00f9 semplice. Il movimento su ciascun asse \u00e8 direttamente correlato al movimento nello spazio cartesiano. Formule chiave: stepper_x_position = cartesian_x_position stepper_y_position = cartesian_y_position stepper_z_position = cartesian_z_position Robot CoreXY \u00b6 La generazione di passaggi su una macchina CoreXY \u00e8 solo un po' pi\u00f9 complessa dei robot cartesiani di base. Le formule chiave sono: stepper_a_position = cartesian_x_position + cartesian_y_position stepper_b_position = cartesian_x_position - cartesian_y_position stepper_z_position = cartesian_z_position Robot Delta \u00b6 La generazione di passi su un robot delta si basa sul teorema di Pitagora: stepper_position = (sqrt(arm_length^2 - (cartesian_x_position - tower_x_position)^2 - (cartesian_y_position - tower_y_position)^2) + cartesian_z_position) Limiti di accelerazione del motore passo-passo \u00b6 Con la cinematica delta \u00e8 possibile che un movimento che sta accelerando nello spazio cartesiano richieda un'accelerazione su un particolare motore passo-passo maggiore dell'accelerazione del movimento. Ci\u00f2 pu\u00f2 verificarsi quando un braccio dello stepper \u00e8 pi\u00f9 orizzontale che verticale e la linea di movimento passa vicino alla torre dello stepper. Sebbene questi movimenti possano richiedere un'accelerazione del motore passo-passo maggiore dell'accelerazione di movimento massima configurata della stampante, la massa effettiva spostata da quel passo-passo sarebbe inferiore. Pertanto la maggiore accelerazione stepper non si traduce in una coppia stepper significativamente pi\u00f9 elevata ed \u00e8 quindi considerata innocua. Tuttavia, per evitare casi estremi, Klipper impone un limite massimo all'accelerazione stepper di tre volte l'accelerazione di movimento massima configurata della stampante. (Allo stesso modo, la velocit\u00e0 massima dello stepper \u00e8 limitata a tre volte la velocit\u00e0 massima di spostamento.) Per far rispettare questo limite, i movimenti sul bordo estremo dell'inviluppo (dove un braccio dello stepper pu\u00f2 essere quasi orizzontale) avranno un massima accelerazione e velocit\u00e0. Cinematica dell'estrusore \u00b6 Klipper implementa il movimento dell'estrusore nella propria classe cinematica. Poich\u00e9 i tempi e la velocit\u00e0 di ogni movimento della testina di stampa sono completamente noti per ogni movimento, \u00e8 possibile calcolare i tempi di passaggio per l'estrusore indipendentemente dai calcoli del tempo di passaggio del movimento della testina di stampa. Il movimento di base dell'estrusore \u00e8 semplice da calcolare. La generazione del tempo di passaggio utilizza le stesse formule utilizzate dai robot cartesiani: stepper_position = requested_e_position Anticipo di pressione \u00b6 La sperimentazione ha dimostrato che \u00e8 possibile migliorare la modellazione dell'estrusore oltre la formula di base dell'estrusore. Nel caso ideale, mentre un movimento di estrusione avanza, lo stesso volume di filamento dovrebbe essere depositato in ogni punto lungo il movimento e non dovrebbe esserci volume estruso dopo il movimento. Sfortunatamente, \u00e8 comune scoprire che le formule di estrusione di base fanno s\u00ec che una quantit\u00e0 insufficiente di filamento fuoriesca dall'estrusore all'inizio dei movimenti di estrusione e che il filamento in eccesso venga estruso al termine dell'estrusione. Questo \u00e8 spesso indicato come \"melma\" \"ooze\". Il sistema di \"pressure advance\" tenta di spiegare ci\u00f2 utilizzando un modello diverso per l'estrusore. Invece di credere ingenuamente che ogni mm^3 di filamento alimentato nell'estrusore comporter\u00e0 l'uscita immediata di quella quantit\u00e0 di mm^3 dall'estrusore, utilizza un modello basato sulla pressione. La pressione aumenta quando il filamento viene spinto nell'estrusore (come in Legge di Hook ) e la pressione necessaria per estrudere \u00e8 dominata dalla portata attraverso l'orifizio dell'ugello (come nella legge di Poiseuille ). L'idea chiave \u00e8 che la relazione tra filamento, pressione e portata pu\u00f2 essere modellata utilizzando un coefficiente lineare: pa_position = nominal_position + pressure_advance_coefficient * nominal_velocity Per informazioni su come trovare questo coefficiente di anticipo della pressione, vedere il documento Pressure Advance . La formula di base del pressure advance pu\u00f2 far s\u00ec che il motore dell'estrusore apporti improvvisi cambiamenti di velocit\u00e0. Klipper implementa la \"smussatura\" del movimento dell'estrusore per evitarlo. Il grafico sopra mostra un esempio di due movimenti di estrusione con una velocit\u00e0 in curva diversa da zero tra di loro. Si noti che il sistema di pressure advance fa s\u00ec che il filamento aggiuntivo venga spinto nell'estrusore durante l'accelerazione. Maggiore \u00e8 la portata del filamento desiderata, pi\u00f9 filamento deve essere spinto durante l'accelerazione per tenere conto della pressione. Durante la decelerazione della testa il filamento extra viene retratto (l'estrusore avr\u00e0 una velocit\u00e0 negativa). Lo \"smussamento\" viene implementato utilizzando una media pesata della posizione dell'estrusore in un breve periodo di tempo (come specificato dal parametro di configurazione pressure_advance_smooth_time ). Questa media pu\u00f2 estendersi su pi\u00f9 mosse del codice G. Notare come il motore dell'estrusore inizier\u00e0 a muoversi prima dell'inizio nominale del primo movimento di estrusione e continuer\u00e0 a muoversi dopo la fine nominale dell'ultimo movimento di estrusione. Formula chiave per \"smoothed pressure advance\": smooth_pa_position(t) = ( definitive_integral(pa_position(x) * (smooth_time/2 - abs(t - x)) * dx, from=t-smooth_time/2, to=t+smooth_time/2) / (smooth_time/2)^2 )","title":"Cinematica"},{"location":"Kinematics.html#cinematica","text":"Questo documento \u00e8 una panoramica su come Klipper implementa la movimentazione del sistema meccanico(la sua cinematica ). Questi contenuti potrebbero interessare sia gli sviluppatori che intendono lacorare sul software Klipper che gli utenti che desiderano comprendere meglio il funzionamento delle proprie macchine.","title":"Cinematica"},{"location":"Kinematics.html#accelerazione","text":"Klipper utilizza uno schema ad accelerazione costrante ogni qualvolta la testa di stampa cambia velocit\u00e0 - la velocit\u00e0 viene gradualmente variata fino a raggiungere la nuova velocit\u00e0 invece di strattonare direttamente alla nuova velocit\u00e0. Klipper mantiene sempre l'accelerazione tra la testa di stampa e la stampa. Il filamento in uscita dall'ugello pu\u00f2 essere piuttosto fragile, rapidi sobbalzi e/o cambi di flusso di estrusione portano a cattiva qualit\u00e0 di stampa e bassa adesione al piano di stampa. Anche quando non viene estruso filamento, se l'ugello si trova allo stesso livello della stampa, un repentino cambio di velocit\u00e0 potrebbe disturbare il filamento appena depositato. Limitare i cambi di velocit\u00e0 della testa di stampa relativamente alla stampa riduce il rischio di rovinare la stampa. \u00c8 anche importante limitare l'accelerazione in modo da evitare che i motori stepper perdano passi e per ridurre le sollecitazioni alla macchina. Klipper limita la coppia su ciascuno stepper mediante la limitazione dell'accelerazione sulla testina di stampa. Imporre l'accelerazione alla testa di stampa ha la conseguenza naturale di limitare la coppia degli stepper che la muovono (l'inverso non \u00e8 sempre vero). Klipper implementa l'accelerazione costante. La formula chiave per l'accelerazione costante \u00e8: velocit\u00e0(tempo) = velocit\u00e0_inizio + accelerazione*tempo","title":"Accelerazione"},{"location":"Kinematics.html#generatore-di-trapezoide","text":"Klipper utilizza un \"generatore di trapezoide\" di tipo tradizionale per modellare il movimento - ogni movimento ha una velocit\u00e0 iniziale, accelera verso la velocit\u00e0 di crociera ad accelerazione costante, prosegue a velocit\u00e0 costante ed infine decelera fino alla velocit\u00e0 finale ad accelerazione costante. Viene detto \"generatore di trapezoide\" perch\u00e9 il diagramma di velocit\u00e0 del movimento sembra un trapezoide. La velocit\u00e0 di crociera \u00e8 sempre maggiore o uguale sia alla velocit\u00e0 iniziale che a quella finale. La fase di accelerazione potrebbe avere durata zero (se la velocit\u00e0 iniziale \u00e8 uguale alla velocit\u00e0 di crociera), la fase di movimento a valocit\u00e0 costante potrebbe avere durata zero (se il movimento inizia a decelerare subito l'accelerazione) e/o la fase di decelerazione potrebbe avere durata zero (se la velocit\u00e0 finale \u00e8 uguale alla velocit\u00e0 di crociera).","title":"Generatore di trapezoide"},{"location":"Kinematics.html#look-ahead-precalcolo","text":"Il sistema di \"look-ahead\" (precalcolo) \u00e8 usato per determinare le velocit\u00e0 nelle giunzioni tra movimenti (cornering speed). Consideriamo questi due movimenti sul piano XY: Nella situazione sopra descritta \u00e8 possibile decelerare completamente dopo il primo movimento e poi accelerare all'inizio del movimento successivo; per\u00f2 questo non \u00e8 un comportamento ideale dato che continue accelerazioni e decelerazioni aumentano il tempo di stampa e continue variazioni nel flusso dell'estrusore peggiorano la qualit\u00e0 di stampa. Per risolvere questo problema, la funzione \"look-ahead\" (precalcolo) accoda i movimenti da eseguire ed analizza gli angoli tra essi per calcolare la velocit\u00e0 da usare nella giunzione tra due movimenti. Se il prossimo movimento \u00e8 all'incirca nella stessa direzione del precedente, la testina di stampa deve rallentare molto poco (se non per nulla). Se per\u00f2 il prossimo movimento forma un angolo acuto (la testina deve praticamente invertire la direzione di marcia), la velocit\u00e0 alla giunzione sar\u00e0 piccola. Le velocit\u00e0 di giunzione sono determinate utilizzando \"accelerazione centripeta approssimata\". Meglio su descritto dall'autore . Tuttavia, in Klipper, le velocit\u00e0 di giunzione sono configurate specificando la velocit\u00e0 desiderata che dovrebbe avere un angolo di 90\u00b0 (la \"velocit\u00e0 dell'angolo retto\") e da quella vengono derivate le velocit\u00e0 di giunzione per altri angoli. Formula chiave per il look-ahead: velocit\u00e0_finale^2 = velocit\u00e0_iniziale^2 + 2*accelerazione*distanza_movimento","title":"Look-ahead (Precalcolo)"},{"location":"Kinematics.html#look-ahead-ammorbidito","text":"Klipper implementa anche un meccanismo per smussare i movimenti di brevi movimenti a \"zigzag\". Considera i seguenti movimenti: In quanto sopra, i frequenti passaggi dall'accelerazione alla decelerazione possono causare vibrazioni della macchina che provocano sollecitazioni e aumentano la rumorosit\u00e0. Per ridurre questo, Klipper tiene traccia sia dell'accelerazione di movimento regolare che di una velocit\u00e0 virtuale di \"accelerazione alla decelerazione\". Utilizzando questo sistema, la velocit\u00e0 massima di questi brevi movimenti a \"zigzag\" \u00e8 limitata per rendere pi\u00f9 fluido il movimento della stampante: In particolare, il codice calcola quale sarebbe la velocit\u00e0 di ogni mossa se fosse limitata a questa velocit\u00e0 di \"accelerazione alla decelerazione\" virtuale (la met\u00e0 della velocit\u00e0 di accelerazione normale per impostazione predefinita). Nell'immagine sopra le linee grigie tratteggiate rappresentano questa velocit\u00e0 di accelerazione virtuale per il primo movimento. Se un movimento non pu\u00f2 raggiungere la sua piena velocit\u00e0 di crociera usando questa velocit\u00e0 di accelerazione virtuale, la sua velocit\u00e0 massima viene ridotta alla velocit\u00e0 massima che potrebbe ottenere a questa velocit\u00e0 di accelerazione virtuale. Per la maggior parte dei movimenti il limite sar\u00e0 pari o superiore ai limiti esistenti del movimento e non verr\u00e0 indotto alcun cambiamento nel comportamento. Per brevi movimenti a zigzag, tuttavia, questo limite riduce la velocit\u00e0 massima. Nota che non cambia l'accelerazione effettiva all'interno del movimento: Il movimento continua a utilizzare lo schema di accelerazione normale fino alla sua velocit\u00e0 massima regolata.","title":"Look-ahead ammorbidito"},{"location":"Kinematics.html#generazione-di-passi","text":"Una volta completato il processo di look-ahead, il movimento della testina di stampa per il dato spostamento \u00e8 completamente noto (tempo, posizione iniziale, posizione finale, velocit\u00e0 in ogni punto) ed \u00e8 possibile generare i tempi di passaggio per lo spostamento. Questo processo viene eseguito all'interno di \"classi cinematiche\" nel codice di Klipper. Al di fuori di queste classi cinematiche, tutto viene tracciato in millimetri, secondi e nello spazio delle coordinate cartesiane. \u00c8 compito delle classi cinematiche convertire da questo sistema di coordinate generico alle specifiche hardware di una particolare stampante. Klipper utilizza un risolutore iterativo per generare i tempi dei passo per ogni stepper. Il codice contiene le formule per calcolare le coordinate cartesiane ideali della testa in ogni momento e ha le formule cinematiche per calcolare le posizioni ideali dello stepper in base a quelle coordinate cartesiane. Con queste formule, Klipper pu\u00f2 determinare il tempo ideale in cui lo stepper dovrebbe trovarsi in ogni posizione del passo. I passaggi indicati vengono quindi programmati in questi orari calcolati. La formula chiave per determinare la distanza che un movimento deve percorrere con un'accelerazione costante \u00e8: distanza_movimento = (velocita_iniziale + .5 * accelerazione *durata_movimento) * durata_movimento e la formula chiave per il movimento a velocit\u00e0 costante \u00e8: distanza_movimento = velocit\u00e0_crociera * durata_movimento Le formule chiave per determinare la coordinata cartesiana di un movimento data una distanza di movimento sono: cartesian_x_position = start_x + move_distance * total_x_movement / total_movement cartesian_y_position = start_y + move_distance * total_y_movement / total_movement cartesian_z_position = start_z + move_distance * total_z_movement / total_movement","title":"Generazione di passi"},{"location":"Kinematics.html#robot-cartesiani","text":"La generazione di passaggi per stampanti cartesiane \u00e8 il caso pi\u00f9 semplice. Il movimento su ciascun asse \u00e8 direttamente correlato al movimento nello spazio cartesiano. Formule chiave: stepper_x_position = cartesian_x_position stepper_y_position = cartesian_y_position stepper_z_position = cartesian_z_position","title":"Robot Cartesiani"},{"location":"Kinematics.html#robot-corexy","text":"La generazione di passaggi su una macchina CoreXY \u00e8 solo un po' pi\u00f9 complessa dei robot cartesiani di base. Le formule chiave sono: stepper_a_position = cartesian_x_position + cartesian_y_position stepper_b_position = cartesian_x_position - cartesian_y_position stepper_z_position = cartesian_z_position","title":"Robot CoreXY"},{"location":"Kinematics.html#robot-delta","text":"La generazione di passi su un robot delta si basa sul teorema di Pitagora: stepper_position = (sqrt(arm_length^2 - (cartesian_x_position - tower_x_position)^2 - (cartesian_y_position - tower_y_position)^2) + cartesian_z_position)","title":"Robot Delta"},{"location":"Kinematics.html#limiti-di-accelerazione-del-motore-passo-passo","text":"Con la cinematica delta \u00e8 possibile che un movimento che sta accelerando nello spazio cartesiano richieda un'accelerazione su un particolare motore passo-passo maggiore dell'accelerazione del movimento. Ci\u00f2 pu\u00f2 verificarsi quando un braccio dello stepper \u00e8 pi\u00f9 orizzontale che verticale e la linea di movimento passa vicino alla torre dello stepper. Sebbene questi movimenti possano richiedere un'accelerazione del motore passo-passo maggiore dell'accelerazione di movimento massima configurata della stampante, la massa effettiva spostata da quel passo-passo sarebbe inferiore. Pertanto la maggiore accelerazione stepper non si traduce in una coppia stepper significativamente pi\u00f9 elevata ed \u00e8 quindi considerata innocua. Tuttavia, per evitare casi estremi, Klipper impone un limite massimo all'accelerazione stepper di tre volte l'accelerazione di movimento massima configurata della stampante. (Allo stesso modo, la velocit\u00e0 massima dello stepper \u00e8 limitata a tre volte la velocit\u00e0 massima di spostamento.) Per far rispettare questo limite, i movimenti sul bordo estremo dell'inviluppo (dove un braccio dello stepper pu\u00f2 essere quasi orizzontale) avranno un massima accelerazione e velocit\u00e0.","title":"Limiti di accelerazione del motore passo-passo"},{"location":"Kinematics.html#cinematica-dellestrusore","text":"Klipper implementa il movimento dell'estrusore nella propria classe cinematica. Poich\u00e9 i tempi e la velocit\u00e0 di ogni movimento della testina di stampa sono completamente noti per ogni movimento, \u00e8 possibile calcolare i tempi di passaggio per l'estrusore indipendentemente dai calcoli del tempo di passaggio del movimento della testina di stampa. Il movimento di base dell'estrusore \u00e8 semplice da calcolare. La generazione del tempo di passaggio utilizza le stesse formule utilizzate dai robot cartesiani: stepper_position = requested_e_position","title":"Cinematica dell'estrusore"},{"location":"Kinematics.html#anticipo-di-pressione","text":"La sperimentazione ha dimostrato che \u00e8 possibile migliorare la modellazione dell'estrusore oltre la formula di base dell'estrusore. Nel caso ideale, mentre un movimento di estrusione avanza, lo stesso volume di filamento dovrebbe essere depositato in ogni punto lungo il movimento e non dovrebbe esserci volume estruso dopo il movimento. Sfortunatamente, \u00e8 comune scoprire che le formule di estrusione di base fanno s\u00ec che una quantit\u00e0 insufficiente di filamento fuoriesca dall'estrusore all'inizio dei movimenti di estrusione e che il filamento in eccesso venga estruso al termine dell'estrusione. Questo \u00e8 spesso indicato come \"melma\" \"ooze\". Il sistema di \"pressure advance\" tenta di spiegare ci\u00f2 utilizzando un modello diverso per l'estrusore. Invece di credere ingenuamente che ogni mm^3 di filamento alimentato nell'estrusore comporter\u00e0 l'uscita immediata di quella quantit\u00e0 di mm^3 dall'estrusore, utilizza un modello basato sulla pressione. La pressione aumenta quando il filamento viene spinto nell'estrusore (come in Legge di Hook ) e la pressione necessaria per estrudere \u00e8 dominata dalla portata attraverso l'orifizio dell'ugello (come nella legge di Poiseuille ). L'idea chiave \u00e8 che la relazione tra filamento, pressione e portata pu\u00f2 essere modellata utilizzando un coefficiente lineare: pa_position = nominal_position + pressure_advance_coefficient * nominal_velocity Per informazioni su come trovare questo coefficiente di anticipo della pressione, vedere il documento Pressure Advance . La formula di base del pressure advance pu\u00f2 far s\u00ec che il motore dell'estrusore apporti improvvisi cambiamenti di velocit\u00e0. Klipper implementa la \"smussatura\" del movimento dell'estrusore per evitarlo. Il grafico sopra mostra un esempio di due movimenti di estrusione con una velocit\u00e0 in curva diversa da zero tra di loro. Si noti che il sistema di pressure advance fa s\u00ec che il filamento aggiuntivo venga spinto nell'estrusore durante l'accelerazione. Maggiore \u00e8 la portata del filamento desiderata, pi\u00f9 filamento deve essere spinto durante l'accelerazione per tenere conto della pressione. Durante la decelerazione della testa il filamento extra viene retratto (l'estrusore avr\u00e0 una velocit\u00e0 negativa). Lo \"smussamento\" viene implementato utilizzando una media pesata della posizione dell'estrusore in un breve periodo di tempo (come specificato dal parametro di configurazione pressure_advance_smooth_time ). Questa media pu\u00f2 estendersi su pi\u00f9 mosse del codice G. Notare come il motore dell'estrusore inizier\u00e0 a muoversi prima dell'inizio nominale del primo movimento di estrusione e continuer\u00e0 a muoversi dopo la fine nominale dell'ultimo movimento di estrusione. Formula chiave per \"smoothed pressure advance\": smooth_pa_position(t) = ( definitive_integral(pa_position(x) * (smooth_time/2 - abs(t - x)) * dx, from=t-smooth_time/2, to=t+smooth_time/2) / (smooth_time/2)^2 )","title":"Anticipo di pressione"},{"location":"MCU_Commands.html","text":"Comandi MCU \u00b6 Questo documento fornisce informazioni sui comandi di basso livello del microcontrollore che sono inviati dal software \"host\" Klipper e processati dal software del microcontrollore Klipper. Questo documento non \u00e8 un riferimento autorevole per questi comandi, n\u00e9 una lista esclusiva di tutti i comandi disponibili. Questo documento pu\u00f2 essere utile per gli sviluppatori interessati a comprendere i comandi di basso livello del microcontrollore. Vedere il documento protocol per ulteriori informazioni sul formato dei comandi e sulla loro trasmissione. I comandi qui sono descritti usando la loro sintassi di stile \"printf\" - per chi non ha familiarit\u00e0 con quel formato, basta notare che dove si vede una sequenza '%...' dovrebbe essere sostituita con un intero reale. Ad esempio, una descrizione con \"count=%c\" potrebbe essere sostituita con il testo \"count=10\". Si noti che i parametri considerati \"enumerazioni\" (vedere il documento di protocollo sopra) assumono un valore stringa che viene automaticamente convertito in un valore intero per il microcontrollore. Questo \u00e8 comune con i parametri denominati \"pin\" (o che hanno il suffisso \"_pin\"). Comandi di avvio \u00b6 Potrebbe essere necessario eseguire determinate azioni una tantum per configurare il microcontrollore e le sue periferiche. Questa sezione elenca i comandi comuni disponibili a tale scopo. A differenza della maggior parte dei comandi del microcontrollore, questi comandi vengono eseguiti non appena vengono ricevuti e non richiedono alcuna configurazione particolare. Comandi di avvio comuni: set_digital_out pin=%u value=%c : Questo comando configura immediatamente il pin dato come un GPIO di uscita digitale e lo imposta su un livello basso (valore=0) o alto (valore=1). Questo comando pu\u00f2 essere utile per configurare il valore iniziale dei LED e per configurare il valore iniziale dei pin micro-stepping del driver stepper. set_pwm_out pin=%u cycle_ticks=%u value=%hu : Questo comando configurer\u00e0 immediatamente il pin dato per utilizzare la modulazione di larghezza di impulso (PWM) basata sull'hardware con il numero specificato di cycle_tick. Il \"cycle_ticks\" \u00e8 il numero di tick di clock dell'MCU per cui ogni ciclo di accensione e spegnimento dovrebbe durare. \u00c8 possibile utilizzare un valore cycle_ticks pari a 1 per richiedere il tempo di ciclo pi\u00f9 rapido possibile. Il parametro \"value\" \u00e8 compreso tra 0 e 255 con 0 che indica uno stato completamente spento e 255 indica uno stato completamente acceso. Questo comando pu\u00f2 essere utile per abilitare le ventole di raffreddamento della CPU e degli ugelli. Configurazione di basso livello del microcontrollore \u00b6 La maggior parte dei comandi nel microcontrollore richiede una configurazione iniziale prima di poter essere richiamati correttamente. Questa sezione fornisce una panoramica del processo di configurazione. Questa sezione e le sezioni seguenti sono probabilmente di interesse solo per gli sviluppatori interessati ai dettagli interni di Klipper. Quando l'host si connette per la prima volta al microcontrollore, inizia sempre ottenendo un dizionario di dati (vedi protocol per ulteriori informazioni). Dopo aver ottenuto il dizionario dei dati, l'host verificher\u00e0 se il microcontrollore \u00e8 in uno stato \"configurato\" e in caso contrario lo configurer\u00e0. La configurazione prevede le seguenti fasi: get_config : L'host si avvia controllando se il microcontrollore \u00e8 gi\u00e0 configurato. Il microcontrollore risponde a questo comando con un messaggio di risposta \"config\". Il software del microcontrollore si avvia sempre in uno stato non configurato all'accensione. Rimane in questo stato fino a quando l'host non completa i processi di configurazione (emettendo un comando finalize_config). Se il microcontrollore \u00e8 gi\u00e0 configurato da una sessione precedente (ed \u00e8 configurato con le impostazioni desiderate), non sono necessarie ulteriori azioni da parte dell'host e il processo di configurazione termina correttamente. allocate_oids count=%c : Questo comando viene emesso per informare il microcontrollore del numero massimo di ID oggetto (oid) che l'host richiede. \u00c8 valido solo per emettere questo comando una volta. Un oid \u00e8 un identificatore intero allocato a ogni stepper, ogni endstop e ogni pin gpio schedulabile. L'host determina in anticipo il numero di oid necessari per far funzionare l'hardware e lo passa al microcontrollore in modo che possa allocare memoria sufficiente per memorizzare una mappatura dall'oid all'oggetto interno. config_XXX oid=%c ... : Per convenzione qualsiasi comando che inizia con il prefisso \"config_\" crea un nuovo oggetto microcontrollore e gli assegna l'oid dato. Ad esempio, il comando config_digital_out configurer\u00e0 il pin specificato come GPIO di output digitale e creer\u00e0 un oggetto interno che l'host pu\u00f2 utilizzare per pianificare le modifiche al GPIO specificato. Il parametro oid passato al comando config viene selezionato dall'host e deve essere compreso tra zero e il conteggio massimo fornito nel comando allocate_oids. I comandi di configurazione possono essere eseguiti solo quando il microcontrollore non \u00e8 in uno stato configurato (cio\u00e8 prima dell'invio da parte dell'host di finalize_config) e dopo che \u00e8 stato inviato il comando allocate_oids. finalize_config crc=%u : Il comando finalize_config trasferisce il microcontrollore da uno stato non configurato a uno stato configurato. Il parametro crc passato al microcontrollore viene archiviato e restituito all'host nei messaggi di risposta \"config\". Per convenzione, l'host prende un CRC a 32bit della configurazione che richieder\u00e0 e all'avvio delle successive sessioni di comunicazione verifica che il CRC memorizzato nel microcontrollore corrisponda esattamente al CRC desiderato. Se il CRC non corrisponde, l'host sa che il microcontrollore non \u00e8 stato configurato nello stato desiderato dall'host. Oggetti comuni del microcontrollore \u00b6 Questa sezione elenca alcuni comandi di configurazione comunemente usati. config_digital_out oid=%c pin=%u value=%c default_value=%c max_duration=%u : Questo comando crea un oggetto microcontrollore interno per il dato 'pin' GPIO. Il pin verr\u00e0 configurato in modalit\u00e0 di uscita digitale e impostato su un valore iniziale come specificato da 'value' (0 per basso, 1 per alto). La creazione di un oggetto digital_out consente all'host di pianificare gli aggiornamenti GPIO per il pin specificato a orari specificati (consultare il comando queue_digital_out descritto di seguito). Se il software del microcontrollore entra in modalit\u00e0 di spegnimento, tutti gli oggetti digital_out configurati verranno impostati su 'default_value'. Il parametro 'max_duration' viene utilizzato per implementare un controllo di sicurezza: se \u00e8 diverso da zero, \u00e8 il numero massimo di tick di clock che l'host pu\u00f2 impostare il GPIO specificato su un valore non predefinito senza ulteriori aggiornamenti. Ad esempio, se default_value \u00e8 zero e max_duration \u00e8 16000, se l'host imposta gpio su un valore di uno, deve pianificare un altro aggiornamento del pin gpio (su zero o su uno) entro 16000 tick di clock. Questa funzione di sicurezza pu\u00f2 essere utilizzata con i pin del riscaldatore per garantire che l'host non abiliti il riscaldatore e quindi vada offline. config_pwm_out oid=%c pin=%u cycle_ticks=%u value=%hu default_value=%hu max_duration=%u : Questo comando crea un oggetto interno per i pin PWM hardware per i quali l'host pu\u00f2 pianificare gli aggiornamenti. Il suo utilizzo \u00e8 analogo a config_digital_out - vedere la descrizione dei comandi 'set_pwm_out' e 'config_digital_out' per la descrizione dei parametri. config_analog_in oid=%c pin=%u : Questo comando viene utilizzato per configurare un pin nella modalit\u00e0 di campionamento analogico. Una volta configurato, il pin pu\u00f2 essere campionato a intervalli regolari utilizzando il comando query_analog_in (vedi sotto). config_stepper oid=%c step_pin=%c dir_pin=%c invert_step=%c step_pulse_ticks=%u : Questo comando crea un oggetto stepper interno. I parametri 'step_pin' e 'dir_pin' specificano rispettivamente i pin del passo e della direzione; questo comando li configurer\u00e0 in modalit\u00e0 uscita digitale. Il parametro 'invert_step' specifica se un passo si verifica su un fronte di salita (invert_step=0) o discendente (invert_step=1). Il parametro 'step_pulse_ticks' specifica la durata minima dell'impulso di passo. Se l'mcu esporta la costante 'STEPPER_BOTH_EDGE=1', l'impostazione di step_pulse_ticks=0 e invert_step=-1 imposter\u00e0 il passaggio su entrambi i fronti di salita e di discesa dello step pin. config_endstop oid=%c pin=%c pull_up=%c stepper_count=%c : Questo comando crea un oggetto \"finecorsa\" interno. Viene utilizzato per specificare i relativi pin e per abilitare le operazioni di \"homing\" (vedere il comando endstop_home di seguito). Il comando configurer\u00e0 il pin specificato nella modalit\u00e0 di input digitale. Il parametro 'pull_up' determina se i resistori pullup forniti dall'hardware per il pin (se disponibili) saranno abilitati. Il parametro 'stepper_count' specifica il numero massimo di stepper che potrebbe essere necessario arrestare questo endstop durante un'operazione di homing (vedere endstop_home di seguito). config_spi oid=%c bus=%u pin=%u mode=%u rate=%u shutdown_msg=%*s : Questo comando crea un oggetto SPI interno. Viene utilizzato con i comandi spi_transfer e spi_send (vedi sotto). Il \"bus\" identifica il bus SPI da utilizzare (se il microcontrollore ha pi\u00f9 di un bus SPI disponibile). Il \"pin\" specifica il pin di selezione del chip (CS) per il dispositivo. La \"modalit\u00e0\" \u00e8 la modalit\u00e0 SPI (dovrebbe essere compresa tra 0 e 3). Il parametro \"rate\" specifica la velocit\u00e0 del bus SPI (in cicli al secondo). Infine, \"shutdown_msg\" \u00e8 un comando SPI da inviare al dispositivo specificato se il microcontrollore entra in uno stato di spegnimento. config_spi_without_cs oid=%c bus=%u mode=%u rate=%u shutdown_msg=%*s : Questo comando \u00e8 simile a config_spi, ma senza una definizione di pin CS. \u00c8 utile per i dispositivi SPI che non dispongono di una linea di selezione del chip. Comandi comuni \u00b6 Questa sezione elenca alcuni comandi comunemente usati durante il run-time. \u00c8 probabilmente di interesse solo per gli sviluppatori che cercano di ottenere informazioni su Klipper. set_digital_out_pwm_cycle oid=%c cycle_ticks=%u : Questo comando configura un pin come uscita digitale (come creato da config_digital_out) per usare \"software PWM\". 'cycle_ticks' \u00e8 il numero di tick di clock per il ciclo PWM. Poich\u00e9 la commutazione dell'uscita \u00e8 implementata nel software del microcontrollore, si consiglia che 'cycle_ticks' corrisponda a un tempo di 10 ms o superiore. queue_digital_out oid=%c clock=%u on_ticks=%u : Questo comando pianificher\u00e0 una modifica a un pin GPIO dell'uscita digitale per un orario specifico. Per utilizzare questo comando \u00e8 necessario che durante la configurazione del microcontrollore sia stato emesso un comando 'config_digital_out' con lo stesso parametro 'oid'. Se \u00e8 stato chiamato 'set_digital_out_pwm_cycle', allora 'on_ticks' \u00e8 la durata di attivazione (in tick di clock) per il ciclo pwm. Altrimenti, 'on_ticks' dovrebbe essere 0 (per bassa tensione) o 1 (per alta tensione). queue_pwm_out oid=%c clock=%u value=%hu : Pianifica una modifica a un pin di uscita PWM hardware. Per ulteriori informazioni, vedere i comandi 'queue_digital_out' e 'config_pwm_out'. query_analog_in oid=%c clock=%u sample_ticks=%u sample_count=%c rest_ticks=%u min_value=%hu max_value=%hu : Questo comando imposta una pianificazione ricorrente di campionamenti di un ingresso analogico. Per utilizzare questo comando \u00e8 necessario che durante la configurazione del microcontrollore sia stato emesso un comando 'config_analog_in' con lo stesso parametro 'oid'. I campioni inizieranno a partire dall'ora 'clock', riporter\u00e0 sul valore ottenuto ogni tick di clock 'rest_ticks', sovracampioner\u00e0 il numero di 'sample_count' e metter\u00e0 in pausa il numero di tick di clock 'sample_ticks' tra i sovacampionamenti. I parametri 'min_value' e 'max_value' implementano una funzione di sicurezza: il software del microcontrollore verificher\u00e0 che il valore campionato (dopo qualsiasi sovracampionamento) sia sempre compreso nell'intervallo fornito. Questo \u00e8 destinato all'uso con pin collegati a termistori che controllano i riscaldatori: pu\u00f2 essere utilizzato per verificare che un riscaldatore rientri in un intervallo di temperatura. get_clock : Questo comando fa s\u00ec che il microcontrollore generi un messaggio di risposta \"clock\". L'host invia questo comando una volta al secondo per ottenere il valore dell'orologio del microcontrollore e per stimare la deriva tra gli orologi dell'host e del microcontrollore. Consente all'host di stimare con precisione l'orologio del microcontrollore. Comandi motori passopasso \u00b6 queue_step oid=%c interval=%u count=%hu add=%hi : Questo comando pianifica il 'conteggio' del numero di passi per il dato stepper, con 'intervallo' il numero di tick di clock tra ogni passo. Il primo passo sar\u00e0 il numero \"intervallo\" di tick di clock dall'ultimo passo programmato per il dato stepper. Se 'add' \u00e8 diverso da zero, l'intervallo verr\u00e0 regolato in base all'importo di 'add' dopo ogni passaggio. Questo comando aggiunge la sequenza intervallo/conteggio/aggiunta data a una coda per stepper. Potrebbero esserci centinaia di queste sequenze in coda durante il normale funzionamento. La nuova sequenza viene aggiunta alla fine della coda e quando ogni sequenza completa il suo numero di \"conteggi\" di passaggi viene estratta dalla parte anteriore della coda. Questo sistema consente al microcontrollore di mettere in coda potenzialmente centinaia di migliaia di passaggi, il tutto con tempi di pianificazione affidabili e prevedibili. set_next_step_dir oid=%c dir=%c : Questo comando specifica il valore del dir_pin che verr\u00e0 utilizzato dal comando queue_step successivo. reset_step_clock oid=%c clock=%u : Normalmente, la temporizzazione del passo \u00e8 relativo all'ultimo passo per un dato stepper. Questo comando azzera l'orologio in modo che il passo successivo sia relativo all'ora fornita. L'host di solito invia questo comando solo all'inizio di una stampa. stepper_get_position oid=%c : Questo comando fa s\u00ec che il microcontrollore generi un messaggio di risposta \"stepper_position\" con la posizione corrente dello stepper. La posizione \u00e8 il numero totale di passi generati con dir=1 meno il numero totale di passi generati con dir=0. endstop_home oid=%c clock=%u sample_ticks=%u sample_count=%c rest_ticks=%u pin_value=%c : Questo comando viene utilizzato durante le operazioni di \"homing\" dello stepper. Per utilizzare questo comando \u00e8 necessario che durante la configurazione del microcontrollore sia stato emesso un comando 'config_endstop' con lo stesso parametro 'oid'. Quando viene invocato questo comando, il microcontrollore campiona il pin finecorsa ogni tick di clock \"rest_ticks\" e controlla se ha un valore uguale a \"pin_value\". Se il valore corrisponde (e continua a corrispondere per 'sample_count' campioni aggiuntivi separati da 'sample_ticks'), la coda di movimento per lo stepper associato verr\u00e0 cancellata e lo stepper si arrester\u00e0 immediatamente. L'host utilizza questo comando per implementare l'homing: l'host indica al finecorsa di eseguire il campionamento per il trigger endstop e quindi emette una serie di comandi queue_step per spostare uno stepper verso il finecorsa. Una volta che lo stepper raggiunge il finecorsa, il trigger verr\u00e0 rilevato, il movimento verr\u00e0 interrotto e l'host verr\u00e0 informato. Coda movimento \u00b6 Ogni comando queue_step utilizza una voce nella \"coda di movimento\" del microcontrollore. Questa coda viene allocata quando riceve il comando \"finalize_config\" e segnala il numero di voci di coda disponibili nei messaggi di risposta \"config\". \u00c8 responsabilit\u00e0 dell'host assicurarsi che ci sia spazio disponibile nella coda prima di inviare un comando queue_step. L'host esegue questa operazione calcolando il completamento di ciascun comando queue_step e pianificando di conseguenza i nuovi comandi queue_step. Comandi SPI \u00b6 spi_transfer oid=%c data=%*s : questo comando fa s\u00ec che il microcontrollore invii dati 'data' al dispositivo spi specificato da 'oid' e genera un messaggio di risposta \"spi_transfer_response\" con i dati restituiti durante la trasmissione . spi_send oid=%c data=%*s : Questo comando \u00e8 simile a \"spi_transfer\", ma non genera un messaggio \"spi_transfer_response\".","title":"Comandi MCU"},{"location":"MCU_Commands.html#comandi-mcu","text":"Questo documento fornisce informazioni sui comandi di basso livello del microcontrollore che sono inviati dal software \"host\" Klipper e processati dal software del microcontrollore Klipper. Questo documento non \u00e8 un riferimento autorevole per questi comandi, n\u00e9 una lista esclusiva di tutti i comandi disponibili. Questo documento pu\u00f2 essere utile per gli sviluppatori interessati a comprendere i comandi di basso livello del microcontrollore. Vedere il documento protocol per ulteriori informazioni sul formato dei comandi e sulla loro trasmissione. I comandi qui sono descritti usando la loro sintassi di stile \"printf\" - per chi non ha familiarit\u00e0 con quel formato, basta notare che dove si vede una sequenza '%...' dovrebbe essere sostituita con un intero reale. Ad esempio, una descrizione con \"count=%c\" potrebbe essere sostituita con il testo \"count=10\". Si noti che i parametri considerati \"enumerazioni\" (vedere il documento di protocollo sopra) assumono un valore stringa che viene automaticamente convertito in un valore intero per il microcontrollore. Questo \u00e8 comune con i parametri denominati \"pin\" (o che hanno il suffisso \"_pin\").","title":"Comandi MCU"},{"location":"MCU_Commands.html#comandi-di-avvio","text":"Potrebbe essere necessario eseguire determinate azioni una tantum per configurare il microcontrollore e le sue periferiche. Questa sezione elenca i comandi comuni disponibili a tale scopo. A differenza della maggior parte dei comandi del microcontrollore, questi comandi vengono eseguiti non appena vengono ricevuti e non richiedono alcuna configurazione particolare. Comandi di avvio comuni: set_digital_out pin=%u value=%c : Questo comando configura immediatamente il pin dato come un GPIO di uscita digitale e lo imposta su un livello basso (valore=0) o alto (valore=1). Questo comando pu\u00f2 essere utile per configurare il valore iniziale dei LED e per configurare il valore iniziale dei pin micro-stepping del driver stepper. set_pwm_out pin=%u cycle_ticks=%u value=%hu : Questo comando configurer\u00e0 immediatamente il pin dato per utilizzare la modulazione di larghezza di impulso (PWM) basata sull'hardware con il numero specificato di cycle_tick. Il \"cycle_ticks\" \u00e8 il numero di tick di clock dell'MCU per cui ogni ciclo di accensione e spegnimento dovrebbe durare. \u00c8 possibile utilizzare un valore cycle_ticks pari a 1 per richiedere il tempo di ciclo pi\u00f9 rapido possibile. Il parametro \"value\" \u00e8 compreso tra 0 e 255 con 0 che indica uno stato completamente spento e 255 indica uno stato completamente acceso. Questo comando pu\u00f2 essere utile per abilitare le ventole di raffreddamento della CPU e degli ugelli.","title":"Comandi di avvio"},{"location":"MCU_Commands.html#configurazione-di-basso-livello-del-microcontrollore","text":"La maggior parte dei comandi nel microcontrollore richiede una configurazione iniziale prima di poter essere richiamati correttamente. Questa sezione fornisce una panoramica del processo di configurazione. Questa sezione e le sezioni seguenti sono probabilmente di interesse solo per gli sviluppatori interessati ai dettagli interni di Klipper. Quando l'host si connette per la prima volta al microcontrollore, inizia sempre ottenendo un dizionario di dati (vedi protocol per ulteriori informazioni). Dopo aver ottenuto il dizionario dei dati, l'host verificher\u00e0 se il microcontrollore \u00e8 in uno stato \"configurato\" e in caso contrario lo configurer\u00e0. La configurazione prevede le seguenti fasi: get_config : L'host si avvia controllando se il microcontrollore \u00e8 gi\u00e0 configurato. Il microcontrollore risponde a questo comando con un messaggio di risposta \"config\". Il software del microcontrollore si avvia sempre in uno stato non configurato all'accensione. Rimane in questo stato fino a quando l'host non completa i processi di configurazione (emettendo un comando finalize_config). Se il microcontrollore \u00e8 gi\u00e0 configurato da una sessione precedente (ed \u00e8 configurato con le impostazioni desiderate), non sono necessarie ulteriori azioni da parte dell'host e il processo di configurazione termina correttamente. allocate_oids count=%c : Questo comando viene emesso per informare il microcontrollore del numero massimo di ID oggetto (oid) che l'host richiede. \u00c8 valido solo per emettere questo comando una volta. Un oid \u00e8 un identificatore intero allocato a ogni stepper, ogni endstop e ogni pin gpio schedulabile. L'host determina in anticipo il numero di oid necessari per far funzionare l'hardware e lo passa al microcontrollore in modo che possa allocare memoria sufficiente per memorizzare una mappatura dall'oid all'oggetto interno. config_XXX oid=%c ... : Per convenzione qualsiasi comando che inizia con il prefisso \"config_\" crea un nuovo oggetto microcontrollore e gli assegna l'oid dato. Ad esempio, il comando config_digital_out configurer\u00e0 il pin specificato come GPIO di output digitale e creer\u00e0 un oggetto interno che l'host pu\u00f2 utilizzare per pianificare le modifiche al GPIO specificato. Il parametro oid passato al comando config viene selezionato dall'host e deve essere compreso tra zero e il conteggio massimo fornito nel comando allocate_oids. I comandi di configurazione possono essere eseguiti solo quando il microcontrollore non \u00e8 in uno stato configurato (cio\u00e8 prima dell'invio da parte dell'host di finalize_config) e dopo che \u00e8 stato inviato il comando allocate_oids. finalize_config crc=%u : Il comando finalize_config trasferisce il microcontrollore da uno stato non configurato a uno stato configurato. Il parametro crc passato al microcontrollore viene archiviato e restituito all'host nei messaggi di risposta \"config\". Per convenzione, l'host prende un CRC a 32bit della configurazione che richieder\u00e0 e all'avvio delle successive sessioni di comunicazione verifica che il CRC memorizzato nel microcontrollore corrisponda esattamente al CRC desiderato. Se il CRC non corrisponde, l'host sa che il microcontrollore non \u00e8 stato configurato nello stato desiderato dall'host.","title":"Configurazione di basso livello del microcontrollore"},{"location":"MCU_Commands.html#oggetti-comuni-del-microcontrollore","text":"Questa sezione elenca alcuni comandi di configurazione comunemente usati. config_digital_out oid=%c pin=%u value=%c default_value=%c max_duration=%u : Questo comando crea un oggetto microcontrollore interno per il dato 'pin' GPIO. Il pin verr\u00e0 configurato in modalit\u00e0 di uscita digitale e impostato su un valore iniziale come specificato da 'value' (0 per basso, 1 per alto). La creazione di un oggetto digital_out consente all'host di pianificare gli aggiornamenti GPIO per il pin specificato a orari specificati (consultare il comando queue_digital_out descritto di seguito). Se il software del microcontrollore entra in modalit\u00e0 di spegnimento, tutti gli oggetti digital_out configurati verranno impostati su 'default_value'. Il parametro 'max_duration' viene utilizzato per implementare un controllo di sicurezza: se \u00e8 diverso da zero, \u00e8 il numero massimo di tick di clock che l'host pu\u00f2 impostare il GPIO specificato su un valore non predefinito senza ulteriori aggiornamenti. Ad esempio, se default_value \u00e8 zero e max_duration \u00e8 16000, se l'host imposta gpio su un valore di uno, deve pianificare un altro aggiornamento del pin gpio (su zero o su uno) entro 16000 tick di clock. Questa funzione di sicurezza pu\u00f2 essere utilizzata con i pin del riscaldatore per garantire che l'host non abiliti il riscaldatore e quindi vada offline. config_pwm_out oid=%c pin=%u cycle_ticks=%u value=%hu default_value=%hu max_duration=%u : Questo comando crea un oggetto interno per i pin PWM hardware per i quali l'host pu\u00f2 pianificare gli aggiornamenti. Il suo utilizzo \u00e8 analogo a config_digital_out - vedere la descrizione dei comandi 'set_pwm_out' e 'config_digital_out' per la descrizione dei parametri. config_analog_in oid=%c pin=%u : Questo comando viene utilizzato per configurare un pin nella modalit\u00e0 di campionamento analogico. Una volta configurato, il pin pu\u00f2 essere campionato a intervalli regolari utilizzando il comando query_analog_in (vedi sotto). config_stepper oid=%c step_pin=%c dir_pin=%c invert_step=%c step_pulse_ticks=%u : Questo comando crea un oggetto stepper interno. I parametri 'step_pin' e 'dir_pin' specificano rispettivamente i pin del passo e della direzione; questo comando li configurer\u00e0 in modalit\u00e0 uscita digitale. Il parametro 'invert_step' specifica se un passo si verifica su un fronte di salita (invert_step=0) o discendente (invert_step=1). Il parametro 'step_pulse_ticks' specifica la durata minima dell'impulso di passo. Se l'mcu esporta la costante 'STEPPER_BOTH_EDGE=1', l'impostazione di step_pulse_ticks=0 e invert_step=-1 imposter\u00e0 il passaggio su entrambi i fronti di salita e di discesa dello step pin. config_endstop oid=%c pin=%c pull_up=%c stepper_count=%c : Questo comando crea un oggetto \"finecorsa\" interno. Viene utilizzato per specificare i relativi pin e per abilitare le operazioni di \"homing\" (vedere il comando endstop_home di seguito). Il comando configurer\u00e0 il pin specificato nella modalit\u00e0 di input digitale. Il parametro 'pull_up' determina se i resistori pullup forniti dall'hardware per il pin (se disponibili) saranno abilitati. Il parametro 'stepper_count' specifica il numero massimo di stepper che potrebbe essere necessario arrestare questo endstop durante un'operazione di homing (vedere endstop_home di seguito). config_spi oid=%c bus=%u pin=%u mode=%u rate=%u shutdown_msg=%*s : Questo comando crea un oggetto SPI interno. Viene utilizzato con i comandi spi_transfer e spi_send (vedi sotto). Il \"bus\" identifica il bus SPI da utilizzare (se il microcontrollore ha pi\u00f9 di un bus SPI disponibile). Il \"pin\" specifica il pin di selezione del chip (CS) per il dispositivo. La \"modalit\u00e0\" \u00e8 la modalit\u00e0 SPI (dovrebbe essere compresa tra 0 e 3). Il parametro \"rate\" specifica la velocit\u00e0 del bus SPI (in cicli al secondo). Infine, \"shutdown_msg\" \u00e8 un comando SPI da inviare al dispositivo specificato se il microcontrollore entra in uno stato di spegnimento. config_spi_without_cs oid=%c bus=%u mode=%u rate=%u shutdown_msg=%*s : Questo comando \u00e8 simile a config_spi, ma senza una definizione di pin CS. \u00c8 utile per i dispositivi SPI che non dispongono di una linea di selezione del chip.","title":"Oggetti comuni del microcontrollore"},{"location":"MCU_Commands.html#comandi-comuni","text":"Questa sezione elenca alcuni comandi comunemente usati durante il run-time. \u00c8 probabilmente di interesse solo per gli sviluppatori che cercano di ottenere informazioni su Klipper. set_digital_out_pwm_cycle oid=%c cycle_ticks=%u : Questo comando configura un pin come uscita digitale (come creato da config_digital_out) per usare \"software PWM\". 'cycle_ticks' \u00e8 il numero di tick di clock per il ciclo PWM. Poich\u00e9 la commutazione dell'uscita \u00e8 implementata nel software del microcontrollore, si consiglia che 'cycle_ticks' corrisponda a un tempo di 10 ms o superiore. queue_digital_out oid=%c clock=%u on_ticks=%u : Questo comando pianificher\u00e0 una modifica a un pin GPIO dell'uscita digitale per un orario specifico. Per utilizzare questo comando \u00e8 necessario che durante la configurazione del microcontrollore sia stato emesso un comando 'config_digital_out' con lo stesso parametro 'oid'. Se \u00e8 stato chiamato 'set_digital_out_pwm_cycle', allora 'on_ticks' \u00e8 la durata di attivazione (in tick di clock) per il ciclo pwm. Altrimenti, 'on_ticks' dovrebbe essere 0 (per bassa tensione) o 1 (per alta tensione). queue_pwm_out oid=%c clock=%u value=%hu : Pianifica una modifica a un pin di uscita PWM hardware. Per ulteriori informazioni, vedere i comandi 'queue_digital_out' e 'config_pwm_out'. query_analog_in oid=%c clock=%u sample_ticks=%u sample_count=%c rest_ticks=%u min_value=%hu max_value=%hu : Questo comando imposta una pianificazione ricorrente di campionamenti di un ingresso analogico. Per utilizzare questo comando \u00e8 necessario che durante la configurazione del microcontrollore sia stato emesso un comando 'config_analog_in' con lo stesso parametro 'oid'. I campioni inizieranno a partire dall'ora 'clock', riporter\u00e0 sul valore ottenuto ogni tick di clock 'rest_ticks', sovracampioner\u00e0 il numero di 'sample_count' e metter\u00e0 in pausa il numero di tick di clock 'sample_ticks' tra i sovacampionamenti. I parametri 'min_value' e 'max_value' implementano una funzione di sicurezza: il software del microcontrollore verificher\u00e0 che il valore campionato (dopo qualsiasi sovracampionamento) sia sempre compreso nell'intervallo fornito. Questo \u00e8 destinato all'uso con pin collegati a termistori che controllano i riscaldatori: pu\u00f2 essere utilizzato per verificare che un riscaldatore rientri in un intervallo di temperatura. get_clock : Questo comando fa s\u00ec che il microcontrollore generi un messaggio di risposta \"clock\". L'host invia questo comando una volta al secondo per ottenere il valore dell'orologio del microcontrollore e per stimare la deriva tra gli orologi dell'host e del microcontrollore. Consente all'host di stimare con precisione l'orologio del microcontrollore.","title":"Comandi comuni"},{"location":"MCU_Commands.html#comandi-motori-passopasso","text":"queue_step oid=%c interval=%u count=%hu add=%hi : Questo comando pianifica il 'conteggio' del numero di passi per il dato stepper, con 'intervallo' il numero di tick di clock tra ogni passo. Il primo passo sar\u00e0 il numero \"intervallo\" di tick di clock dall'ultimo passo programmato per il dato stepper. Se 'add' \u00e8 diverso da zero, l'intervallo verr\u00e0 regolato in base all'importo di 'add' dopo ogni passaggio. Questo comando aggiunge la sequenza intervallo/conteggio/aggiunta data a una coda per stepper. Potrebbero esserci centinaia di queste sequenze in coda durante il normale funzionamento. La nuova sequenza viene aggiunta alla fine della coda e quando ogni sequenza completa il suo numero di \"conteggi\" di passaggi viene estratta dalla parte anteriore della coda. Questo sistema consente al microcontrollore di mettere in coda potenzialmente centinaia di migliaia di passaggi, il tutto con tempi di pianificazione affidabili e prevedibili. set_next_step_dir oid=%c dir=%c : Questo comando specifica il valore del dir_pin che verr\u00e0 utilizzato dal comando queue_step successivo. reset_step_clock oid=%c clock=%u : Normalmente, la temporizzazione del passo \u00e8 relativo all'ultimo passo per un dato stepper. Questo comando azzera l'orologio in modo che il passo successivo sia relativo all'ora fornita. L'host di solito invia questo comando solo all'inizio di una stampa. stepper_get_position oid=%c : Questo comando fa s\u00ec che il microcontrollore generi un messaggio di risposta \"stepper_position\" con la posizione corrente dello stepper. La posizione \u00e8 il numero totale di passi generati con dir=1 meno il numero totale di passi generati con dir=0. endstop_home oid=%c clock=%u sample_ticks=%u sample_count=%c rest_ticks=%u pin_value=%c : Questo comando viene utilizzato durante le operazioni di \"homing\" dello stepper. Per utilizzare questo comando \u00e8 necessario che durante la configurazione del microcontrollore sia stato emesso un comando 'config_endstop' con lo stesso parametro 'oid'. Quando viene invocato questo comando, il microcontrollore campiona il pin finecorsa ogni tick di clock \"rest_ticks\" e controlla se ha un valore uguale a \"pin_value\". Se il valore corrisponde (e continua a corrispondere per 'sample_count' campioni aggiuntivi separati da 'sample_ticks'), la coda di movimento per lo stepper associato verr\u00e0 cancellata e lo stepper si arrester\u00e0 immediatamente. L'host utilizza questo comando per implementare l'homing: l'host indica al finecorsa di eseguire il campionamento per il trigger endstop e quindi emette una serie di comandi queue_step per spostare uno stepper verso il finecorsa. Una volta che lo stepper raggiunge il finecorsa, il trigger verr\u00e0 rilevato, il movimento verr\u00e0 interrotto e l'host verr\u00e0 informato.","title":"Comandi motori passopasso"},{"location":"MCU_Commands.html#coda-movimento","text":"Ogni comando queue_step utilizza una voce nella \"coda di movimento\" del microcontrollore. Questa coda viene allocata quando riceve il comando \"finalize_config\" e segnala il numero di voci di coda disponibili nei messaggi di risposta \"config\". \u00c8 responsabilit\u00e0 dell'host assicurarsi che ci sia spazio disponibile nella coda prima di inviare un comando queue_step. L'host esegue questa operazione calcolando il completamento di ciascun comando queue_step e pianificando di conseguenza i nuovi comandi queue_step.","title":"Coda movimento"},{"location":"MCU_Commands.html#comandi-spi","text":"spi_transfer oid=%c data=%*s : questo comando fa s\u00ec che il microcontrollore invii dati 'data' al dispositivo spi specificato da 'oid' e genera un messaggio di risposta \"spi_transfer_response\" con i dati restituiti durante la trasmissione . spi_send oid=%c data=%*s : Questo comando \u00e8 simile a \"spi_transfer\", ma non genera un messaggio \"spi_transfer_response\".","title":"Comandi SPI"},{"location":"Manual_Level.html","text":"Livellamento manuale \u00b6 Questo documento descrive gli strumenti per la calibrazione di un finecorsa Z e per l'esecuzione delle regolazioni delle viti di livellamento del piatto. Calibrazione di un finecorsa Z \u00b6 Una posizione precisa del fine corsa Z \u00e8 fondamentale per ottenere stampe di alta qualit\u00e0. Si noti, tuttavia, che la precisione dell'interruttore di fine corsa Z stesso pu\u00f2 essere un fattore limitante. Se si utilizzano i driver per motori passo-passo Trinamic, considerare l'abilitazione del rilevamento fase finecorsa per migliorare la precisione dell'interruttore. Per eseguire una calibrazione del fine corsa Z, portare la stampante in posizione di partenza, comandare alla testina di spostarsi in una posizione Z che sia almeno cinque millimetri sopra il piatto (se non lo \u00e8 gi\u00e0), comandare alla testina di spostarsi in una posizione XY vicino al centro di piatto, quindi vai alla scheda del terminale OctoPrint ed esegui: Z_ENDSTOP_CALIBRATE Quindi segui i passaggi descritti in \"the paper test\" per determinare la distanza effettiva tra l'ugello e il piatto in una determinata posizione. Una volta completati questi passaggi, \u00e8 possibile \"ACCETTARE\" la posizione e salvare i risultati nel file di configurazione con: SAVE_CONFIG \u00c8 preferibile utilizzare un interruttore di fine corsa Z sull'estremit\u00e0 opposta dell'asse Z rispetto al piatto. (L'allontanamento dal piatto \u00e8 pi\u00f9 robusto in quanto generalmente \u00e8 sempre sicuro mettere a home la Z.) Tuttavia, se si deve tornare a home verso il piatto, si consiglia di regolare il finecorsa in modo che si attivi a una piccola distanza (ad es. 0,5 mm ) sopra il piatto. Quasi tutti gli interruttori di fine corsa possono essere premuti in sicurezza a una piccola distanza oltre il punto di attivazione. Fatto ci\u00f2, si dovrebbe scoprire che il comando Z_ENDSTOP_CALIBRATE riporta un piccolo valore positivo (ad esempio, .5mm) per Z position_endstop. L'attivazione del fine corsa mentre si \u00e8 ancora a una certa distanza dal piatto riduce il rischio di incidenti involontari del piatto. Alcune stampanti hanno la capacit\u00e0 di regolare manualmente la posizione dell'interruttore di fine corsa fisico. Tuttavia, si consiglia di eseguire il posizionamento del finecorsa Z nel software con Klipper: una volta che la posizione fisica del finecorsa \u00e8 in una posizione comoda, \u00e8 possibile apportare ulteriori modifiche eseguendo Z_ENDSTOP_CALIBRATE o aggiornando manualmente Z position_endstop nel file di configurazione. Regolazione delle viti di livellamento del piatto \u00b6 Il segreto per ottenere un buon livellamento del piatto con le viti di livellamento \u00e8 utilizzare il sistema di movimento ad alta precisione della stampante durante il processo di livellamento del piatto stesso. Questo viene fatto comandando l'ugello in una posizione vicino a ciascuna vite del piatto e quindi regolando quella vite fino a quando il piatto non \u00e8 a una distanza prestabilita dall'ugello. Klipper ha uno strumento per aiutare con questo. Per utilizzare lo strumento \u00e8 necessario specificare la posizione XY di ciascuna vite. Questo viene fatto creando una sezione di configurazione [bed_screws] . Ad esempio, potrebbe sembrare qualcosa di simile a: [bed_screws] screw1: 100, 50 screw2: 100, 150 screw3: 150, 100 Se una vite del piatto \u00e8 sotto il piatto, specificare la posizione XY direttamente sopra la vite. Se la vite \u00e8 fuori dal piatto, specificare una posizione XY pi\u00f9 vicina alla vite che sia ancora all'interno del raggio del piatto. Una volta che il file di configurazione \u00e8 pronto, esegui RESTART per caricare quella configurazione, quindi puoi avviare lo strumento eseguendo: BED_SCREWS_ADJUST Questo strumento sposter\u00e0 l'ugello della stampante in ciascuna posizione XY della vite e quindi sposter\u00e0 l'ugello a un'altezza Z=0. A questo punto si pu\u00f2 utilizzare la \"prova della carta\" per regolare la vite del piatto direttamente sotto l'ugello. Vedere le informazioni descritte in \"the paper test\" , ma regolare la vite del piatto invece di comandare l'ugello ad altezze diverse. Regolare la vite del piatto finch\u00e9 non c'\u00e8 una piccola quantit\u00e0 di attrito quando si spinge la carta avanti e indietro. Una volta che la vite \u00e8 stata regolata in modo da avvertire una piccola quantit\u00e0 di attrito, eseguire il comando ACCEPT o ADJUSTED . Utilizzare il comando ADJUSTED se la vite del piatto necessita di una regolazione (in genere qualcosa di pi\u00f9 di circa 1/8 di giro della vite). Utilizzare il comando ACCEPT se non sono necessarie modifiche significative. Entrambi i comandi faranno s\u00ec che lo strumento proceda alla vite successiva. (Quando viene utilizzato un comando ADJUSTED , lo strumento pianificher\u00e0 un ciclo aggiuntivo di regolazioni delle viti di appoggio; lo strumento viene completato correttamente quando tutte le viti di appoggio vengono verificate e non richiedono regolazioni significative.) \u00c8 possibile utilizzare il comando 'ABORT' per uscire lo strumento in anticipo. Questo sistema funziona al meglio quando la stampante ha una superficie di stampa piatta (come il vetro) e ha binari diritti. Dopo aver completato con successo lo strumento di livellamento del piatto, il piatto dovrebbe essere pronto per la stampa. Regolazione fine della vite del piatto \u00b6 Se la stampante utilizza tre viti del piatto e tutte e tre le viti sono sotto il piatto, potrebbe essere possibile eseguire una seconda fase di livellamento del piatto \"ad alta precisione\". Questo viene fatto comandando l'ugello in punti in cui il piatto si sposta di una distanza maggiore con ciascuna regolazione della vite del piatto. Ad esempio, considera un piatto con viti nelle posizioni A, B e C: Per ogni regolazione effettuata alla vite del piatto nella posizione C, il piatto osciller\u00e0 lungo un pendolo definito dalle restanti due viti del piatto (mostrate qui come una linea verde). In questa situazione, ogni regolazione della vite del piatto in C sposter\u00e0 il letto nella posizione D di una quantit\u00e0 maggiore rispetto a C. \u00c8 quindi possibile effettuare una regolazione della vite C migliorata quando l'ugello \u00e8 in posizione D. Per abilitare questa funzione, si dovrebbero determinare le coordinate dell'ugello aggiuntive e aggiungerle al file di configurazione. Ad esempio, potrebbe essere simile a: [bed_screws] screw1: 100, 50 screw1_fine_adjust: 0, 0 screw2: 100, 150 screw2_fine_adjust: 300, 300 screw3: 150, 100 screw3_fine_adjust: 0, 100 Quando questa funzione \u00e8 abilitata, lo strumento BED_SCREWS_ADJUST richieder\u00e0 prima le regolazioni grossolane direttamente sopra ogni posizione della vite e, una volta accettate, richieder\u00e0 le regolazioni fini nelle posizioni aggiuntive. Continua a usare ACCEPT e ADJUSTED in ogni posizione. Regolazione delle viti di livellamento del piatto mediante la sonda del piatto \u00b6 Questo \u00e8 un altro modo per calibrare il livello del piatto utilizzando la sonda del piatto. Per utilizzarlo \u00e8 necessario disporre di una sonda Z (BL Touch, Sensore induttivo, ecc). Per abilitare questa funzione, si dovrebbero determinare le coordinate dell'ugello in modo tale che la sonda Z sia sopra le viti, quindi aggiungerle al file di configurazione. Ad esempio, potrebbe essere simile a: [screws_tilt_adjust] screw1: -5, 30 screw1_name: front left screw screw2: 155, 30 screw2_name: front right screw screw3: 155, 190 screw3_name: rear right screw screw4: -5, 190 screw4_name: rear left screw horizontal_move_z: 10. speed: 50. screw_thread: CW-M3 La vite1 \u00e8 sempre il punto di riferimento per le altre, quindi il sistema presume che la vite1 sia all'altezza corretta. Eseguire sempre prima G28 e poi eseguire SCREWS_TILT_CALCULATE - dovrebbe produrre un output simile a: Send: G28 Recv: ok Send: SCREWS_TILT_CALCULATE Recv: // 01:20 means 1 full turn and 20 minutes, CW=clockwise, CCW=counter-clockwise Recv: // front left screw (base) : x=-5.0, y=30.0, z=2.48750 Recv: // front right screw : x=155.0, y=30.0, z=2.36000 : adjust CW 01:15 Recv: // rear right screw : y=155.0, y=190.0, z=2.71500 : adjust CCW 00:50 Recv: // read left screw : x=-5.0, y=190.0, z=2.47250 : adjust CW 00:02 Recv: ok Ci\u00f2 significa che: la vite anteriore sinistra \u00e8 il punto di riferimento non devi cambiarla. la vite anteriore destra deve essere ruotata in senso orario di 1 giro completo e un quarto di giro la vite posteriore destra deve essere ruotata in senso antiorario per '50 minuti' la vite posteriore sinistra deve essere ruotata in senso orario '2 minuti' (non serve va bene) Si noti che \"minuti\" si riferisce ai \"minuti di un quadrante\". Quindi, ad esempio, 15 minuti sono un quarto di giro completo. Ripeti il processo pi\u00f9 volte fino a ottenere un piatto ben livellato, normalmente quando tutte le regolazioni richiedono meno di 6 minuti. Se si utilizza una sonda montata sul lato dell'hotend (ovvero, ha un offset X o Y), tenere presente che la regolazione dell'inclinazione del piatto invalider\u00e0 qualsiasi precedente calibrazione della sonda eseguita con unpiatto inclinato. Assicurarsi di eseguire calibrazione sonda dopo aver regolato le viti del piatto. Il parametro MAX_DEVIATION \u00e8 utile quando viene utilizzata una mesh del piatto salvata, per garantire che il livello del pitto non si sia spostato troppo lontano da dove si trovava quando \u00e8 stata creata la mesh. Ad esempio, SCREWS_TILT_CALCULATE MAX_DEVIATION=0.01 pu\u00f2 essere aggiunto al gcode iniziale personalizzato dello slicer prima del caricamento della mesh. Interromper\u00e0 la stampa se viene superato il limite configurato (0,01 mm in questo esempio), dando all'utente la possibilit\u00e0 di regolare le viti e riavviare la stampa. Il parametro DIRECTION \u00e8 utile se puoi ruotare le viti di regolazione del piatto in una sola direzione. Ad esempio, potresti avere viti che iniziano a stringere nella posizione pi\u00f9 bassa (o pi\u00f9 alta) possibile, che possono essere ruotate solo in una sola direzione, per alzare (o abbassare) il piatto. Se puoi girare le viti solo in senso orario, esegui SCREWS_TILT_CALCULATE DIRECTION=CW . Se puoi ruotarli solo in senso antiorario, esegui SCREWS_TILT_CALCULATE DIRECTION=CCW . Verr\u00e0 scelto un punto di riferimento idoneo in modo tale che il piatto possa essere livellato ruotando tutte le viti nella direzione indicata.","title":"Livellamento manuale"},{"location":"Manual_Level.html#livellamento-manuale","text":"Questo documento descrive gli strumenti per la calibrazione di un finecorsa Z e per l'esecuzione delle regolazioni delle viti di livellamento del piatto.","title":"Livellamento manuale"},{"location":"Manual_Level.html#calibrazione-di-un-finecorsa-z","text":"Una posizione precisa del fine corsa Z \u00e8 fondamentale per ottenere stampe di alta qualit\u00e0. Si noti, tuttavia, che la precisione dell'interruttore di fine corsa Z stesso pu\u00f2 essere un fattore limitante. Se si utilizzano i driver per motori passo-passo Trinamic, considerare l'abilitazione del rilevamento fase finecorsa per migliorare la precisione dell'interruttore. Per eseguire una calibrazione del fine corsa Z, portare la stampante in posizione di partenza, comandare alla testina di spostarsi in una posizione Z che sia almeno cinque millimetri sopra il piatto (se non lo \u00e8 gi\u00e0), comandare alla testina di spostarsi in una posizione XY vicino al centro di piatto, quindi vai alla scheda del terminale OctoPrint ed esegui: Z_ENDSTOP_CALIBRATE Quindi segui i passaggi descritti in \"the paper test\" per determinare la distanza effettiva tra l'ugello e il piatto in una determinata posizione. Una volta completati questi passaggi, \u00e8 possibile \"ACCETTARE\" la posizione e salvare i risultati nel file di configurazione con: SAVE_CONFIG \u00c8 preferibile utilizzare un interruttore di fine corsa Z sull'estremit\u00e0 opposta dell'asse Z rispetto al piatto. (L'allontanamento dal piatto \u00e8 pi\u00f9 robusto in quanto generalmente \u00e8 sempre sicuro mettere a home la Z.) Tuttavia, se si deve tornare a home verso il piatto, si consiglia di regolare il finecorsa in modo che si attivi a una piccola distanza (ad es. 0,5 mm ) sopra il piatto. Quasi tutti gli interruttori di fine corsa possono essere premuti in sicurezza a una piccola distanza oltre il punto di attivazione. Fatto ci\u00f2, si dovrebbe scoprire che il comando Z_ENDSTOP_CALIBRATE riporta un piccolo valore positivo (ad esempio, .5mm) per Z position_endstop. L'attivazione del fine corsa mentre si \u00e8 ancora a una certa distanza dal piatto riduce il rischio di incidenti involontari del piatto. Alcune stampanti hanno la capacit\u00e0 di regolare manualmente la posizione dell'interruttore di fine corsa fisico. Tuttavia, si consiglia di eseguire il posizionamento del finecorsa Z nel software con Klipper: una volta che la posizione fisica del finecorsa \u00e8 in una posizione comoda, \u00e8 possibile apportare ulteriori modifiche eseguendo Z_ENDSTOP_CALIBRATE o aggiornando manualmente Z position_endstop nel file di configurazione.","title":"Calibrazione di un finecorsa Z"},{"location":"Manual_Level.html#regolazione-delle-viti-di-livellamento-del-piatto","text":"Il segreto per ottenere un buon livellamento del piatto con le viti di livellamento \u00e8 utilizzare il sistema di movimento ad alta precisione della stampante durante il processo di livellamento del piatto stesso. Questo viene fatto comandando l'ugello in una posizione vicino a ciascuna vite del piatto e quindi regolando quella vite fino a quando il piatto non \u00e8 a una distanza prestabilita dall'ugello. Klipper ha uno strumento per aiutare con questo. Per utilizzare lo strumento \u00e8 necessario specificare la posizione XY di ciascuna vite. Questo viene fatto creando una sezione di configurazione [bed_screws] . Ad esempio, potrebbe sembrare qualcosa di simile a: [bed_screws] screw1: 100, 50 screw2: 100, 150 screw3: 150, 100 Se una vite del piatto \u00e8 sotto il piatto, specificare la posizione XY direttamente sopra la vite. Se la vite \u00e8 fuori dal piatto, specificare una posizione XY pi\u00f9 vicina alla vite che sia ancora all'interno del raggio del piatto. Una volta che il file di configurazione \u00e8 pronto, esegui RESTART per caricare quella configurazione, quindi puoi avviare lo strumento eseguendo: BED_SCREWS_ADJUST Questo strumento sposter\u00e0 l'ugello della stampante in ciascuna posizione XY della vite e quindi sposter\u00e0 l'ugello a un'altezza Z=0. A questo punto si pu\u00f2 utilizzare la \"prova della carta\" per regolare la vite del piatto direttamente sotto l'ugello. Vedere le informazioni descritte in \"the paper test\" , ma regolare la vite del piatto invece di comandare l'ugello ad altezze diverse. Regolare la vite del piatto finch\u00e9 non c'\u00e8 una piccola quantit\u00e0 di attrito quando si spinge la carta avanti e indietro. Una volta che la vite \u00e8 stata regolata in modo da avvertire una piccola quantit\u00e0 di attrito, eseguire il comando ACCEPT o ADJUSTED . Utilizzare il comando ADJUSTED se la vite del piatto necessita di una regolazione (in genere qualcosa di pi\u00f9 di circa 1/8 di giro della vite). Utilizzare il comando ACCEPT se non sono necessarie modifiche significative. Entrambi i comandi faranno s\u00ec che lo strumento proceda alla vite successiva. (Quando viene utilizzato un comando ADJUSTED , lo strumento pianificher\u00e0 un ciclo aggiuntivo di regolazioni delle viti di appoggio; lo strumento viene completato correttamente quando tutte le viti di appoggio vengono verificate e non richiedono regolazioni significative.) \u00c8 possibile utilizzare il comando 'ABORT' per uscire lo strumento in anticipo. Questo sistema funziona al meglio quando la stampante ha una superficie di stampa piatta (come il vetro) e ha binari diritti. Dopo aver completato con successo lo strumento di livellamento del piatto, il piatto dovrebbe essere pronto per la stampa.","title":"Regolazione delle viti di livellamento del piatto"},{"location":"Manual_Level.html#regolazione-fine-della-vite-del-piatto","text":"Se la stampante utilizza tre viti del piatto e tutte e tre le viti sono sotto il piatto, potrebbe essere possibile eseguire una seconda fase di livellamento del piatto \"ad alta precisione\". Questo viene fatto comandando l'ugello in punti in cui il piatto si sposta di una distanza maggiore con ciascuna regolazione della vite del piatto. Ad esempio, considera un piatto con viti nelle posizioni A, B e C: Per ogni regolazione effettuata alla vite del piatto nella posizione C, il piatto osciller\u00e0 lungo un pendolo definito dalle restanti due viti del piatto (mostrate qui come una linea verde). In questa situazione, ogni regolazione della vite del piatto in C sposter\u00e0 il letto nella posizione D di una quantit\u00e0 maggiore rispetto a C. \u00c8 quindi possibile effettuare una regolazione della vite C migliorata quando l'ugello \u00e8 in posizione D. Per abilitare questa funzione, si dovrebbero determinare le coordinate dell'ugello aggiuntive e aggiungerle al file di configurazione. Ad esempio, potrebbe essere simile a: [bed_screws] screw1: 100, 50 screw1_fine_adjust: 0, 0 screw2: 100, 150 screw2_fine_adjust: 300, 300 screw3: 150, 100 screw3_fine_adjust: 0, 100 Quando questa funzione \u00e8 abilitata, lo strumento BED_SCREWS_ADJUST richieder\u00e0 prima le regolazioni grossolane direttamente sopra ogni posizione della vite e, una volta accettate, richieder\u00e0 le regolazioni fini nelle posizioni aggiuntive. Continua a usare ACCEPT e ADJUSTED in ogni posizione.","title":"Regolazione fine della vite del piatto"},{"location":"Manual_Level.html#regolazione-delle-viti-di-livellamento-del-piatto-mediante-la-sonda-del-piatto","text":"Questo \u00e8 un altro modo per calibrare il livello del piatto utilizzando la sonda del piatto. Per utilizzarlo \u00e8 necessario disporre di una sonda Z (BL Touch, Sensore induttivo, ecc). Per abilitare questa funzione, si dovrebbero determinare le coordinate dell'ugello in modo tale che la sonda Z sia sopra le viti, quindi aggiungerle al file di configurazione. Ad esempio, potrebbe essere simile a: [screws_tilt_adjust] screw1: -5, 30 screw1_name: front left screw screw2: 155, 30 screw2_name: front right screw screw3: 155, 190 screw3_name: rear right screw screw4: -5, 190 screw4_name: rear left screw horizontal_move_z: 10. speed: 50. screw_thread: CW-M3 La vite1 \u00e8 sempre il punto di riferimento per le altre, quindi il sistema presume che la vite1 sia all'altezza corretta. Eseguire sempre prima G28 e poi eseguire SCREWS_TILT_CALCULATE - dovrebbe produrre un output simile a: Send: G28 Recv: ok Send: SCREWS_TILT_CALCULATE Recv: // 01:20 means 1 full turn and 20 minutes, CW=clockwise, CCW=counter-clockwise Recv: // front left screw (base) : x=-5.0, y=30.0, z=2.48750 Recv: // front right screw : x=155.0, y=30.0, z=2.36000 : adjust CW 01:15 Recv: // rear right screw : y=155.0, y=190.0, z=2.71500 : adjust CCW 00:50 Recv: // read left screw : x=-5.0, y=190.0, z=2.47250 : adjust CW 00:02 Recv: ok Ci\u00f2 significa che: la vite anteriore sinistra \u00e8 il punto di riferimento non devi cambiarla. la vite anteriore destra deve essere ruotata in senso orario di 1 giro completo e un quarto di giro la vite posteriore destra deve essere ruotata in senso antiorario per '50 minuti' la vite posteriore sinistra deve essere ruotata in senso orario '2 minuti' (non serve va bene) Si noti che \"minuti\" si riferisce ai \"minuti di un quadrante\". Quindi, ad esempio, 15 minuti sono un quarto di giro completo. Ripeti il processo pi\u00f9 volte fino a ottenere un piatto ben livellato, normalmente quando tutte le regolazioni richiedono meno di 6 minuti. Se si utilizza una sonda montata sul lato dell'hotend (ovvero, ha un offset X o Y), tenere presente che la regolazione dell'inclinazione del piatto invalider\u00e0 qualsiasi precedente calibrazione della sonda eseguita con unpiatto inclinato. Assicurarsi di eseguire calibrazione sonda dopo aver regolato le viti del piatto. Il parametro MAX_DEVIATION \u00e8 utile quando viene utilizzata una mesh del piatto salvata, per garantire che il livello del pitto non si sia spostato troppo lontano da dove si trovava quando \u00e8 stata creata la mesh. Ad esempio, SCREWS_TILT_CALCULATE MAX_DEVIATION=0.01 pu\u00f2 essere aggiunto al gcode iniziale personalizzato dello slicer prima del caricamento della mesh. Interromper\u00e0 la stampa se viene superato il limite configurato (0,01 mm in questo esempio), dando all'utente la possibilit\u00e0 di regolare le viti e riavviare la stampa. Il parametro DIRECTION \u00e8 utile se puoi ruotare le viti di regolazione del piatto in una sola direzione. Ad esempio, potresti avere viti che iniziano a stringere nella posizione pi\u00f9 bassa (o pi\u00f9 alta) possibile, che possono essere ruotate solo in una sola direzione, per alzare (o abbassare) il piatto. Se puoi girare le viti solo in senso orario, esegui SCREWS_TILT_CALCULATE DIRECTION=CW . Se puoi ruotarli solo in senso antiorario, esegui SCREWS_TILT_CALCULATE DIRECTION=CCW . Verr\u00e0 scelto un punto di riferimento idoneo in modo tale che il piatto possa essere livellato ruotando tutte le viti nella direzione indicata.","title":"Regolazione delle viti di livellamento del piatto mediante la sonda del piatto"},{"location":"Measuring_Resonances.html","text":"Misurazione delle risonanze \u00b6 Klipper ha il supporto integrato per l'accelerometro ADXL345, che pu\u00f2 essere utilizzato per misurare le frequenze di risonanza della stampante per diversi assi, e per l'autotuning input shapers per compensare le risonanze. Si noti che l'utilizzo di ADXL345 richiede alcune operazioni di saldatura e crimpatura. ADXL345 pu\u00f2 essere collegato direttamente a un Raspberry Pi o a un'interfaccia SPI di una scheda MCU (deve essere ragionevolmente veloce). Quando acquisti ADXL345, tieni presente che esiste una variet\u00e0 di diversi design di schede PCB e diversi cloni di essi. Assicurati che la scheda supporti la modalit\u00e0 SPI (un piccolo numero di schede sembra essere configurato in modo rigido per I2C trascinando SDO su GND) e, se deve essere collegato a un MCU per stampante da 5 V, che abbia un regolatore di tensione e un cambio di livello. Istruzioni per l'installazione \u00b6 Cablaggio \u00b6 Si consiglia un cavo Ethernet con doppini intrecciati schermati (cat5e o superiore) per l'integrit\u00e0 del segnale su lunghe distanze. Se si verificano ancora problemi di integrit\u00e0 del segnale (errori SPI/I2C), accorciare il cavo. Collegare la schermatura del cavo Ethernet al gnd/ground della scheda controller RPI. Ricontrolla il cablaggio prima di accendere per evitare di danneggiare il tuo MCU/Raspberry Pi o l'accelerometro. Accelerometri SPI \u00b6 Ordine dei doppini intrecciati suggerito: GND+MISO 3.3V+MOSI SCLK+CS ADXL345 \u00b6 Nota: molti MCU funzionano con un ADXL345 in modalit\u00e0 SPI (ad es. Pi Pico), il cablaggio e la configurazione variano in base alla scheda specifica ed ai pin disponibili. Devi connettere ADXL345 al tuo Raspberry Pi tramite SPI. Si noti che la connessione I2C, suggerita dalla documentazione di ADXL345, ha un throughput troppo basso e non funzioner\u00e0 . Lo schema di connessione consigliato: ADXL345 pin RPi pin Nome pin RPi 3V3 (or VCC) 01 3.3v alimentazione DC GND 06 Ground CS 24 GPIO08 (SPI0_CE0_N) SDO 21 GPIO09 (SPI0_MISO) SDA 19 GPIO10 (SPI0_MOSI) SCL 23 GPIO11 (SPI0_SCLK) Schemi collegamenti Fritzing per alcune delle schede ADXL345: Accelerometri I2C \u00b6 Ordine dei doppini intrecciati suggerito: 3.3V+SDA GND+SCL MPU-9250/MPU-9255/MPU-6515/MPU-6050/MPU-6500 \u00b6 Le alternative all'ADXL345 sono MPU-9250/MPU-9255/MPU-6515/MPU-6050/MPU-6500. Questi accelerometri sono stati testati per funzionare su I2C su RPi o RP2040(pico) a 400kbaud. Schema di connessione consigliato per I2C su Raspberry Pi: pin MPU-9250 RPi pin Nome pin RPi VCC 01 3.3v alimentazione DC GND 09 Ground SDA 03 GPIO02 (SDA1) SCL 05 GPIO03 (SCL1) Schema di connessione consigliato per I2C(i2c0a) su RP2040: pin MPU-9250 pin RP2040 Nome pin RPi VCC 39 3v3 GND 38 Ground SDA 01 GP0 (I2C0 SDA) SCL 02 GP1 (I2C0 SCL) Montaggio dell'accelerometro \u00b6 L'accelerometro deve essere collegato alla testa di stampa. \u00c8 necessario progettare un supporto adeguato che si adatti alla propria stampante 3D. \u00c8 meglio allineare gli assi dell'accelerometro con gli assi della stampante (ma se lo rende pi\u00f9 comodo, gli assi possono essere scambiati - cio\u00e8 non c'\u00e8 bisogno di allineare l'asse X con X e cos\u00ec via - dovrebbe andare bene anche se l'asse Z di l'accelerometro \u00e8 l'asse X della stampante, ecc.). Un esempio di montaggio di ADXL345 su SmartEffect: Si noti che su una stampante con piatto mobile \u00e8 necessario progettare 2 supporti: uno per la testina e uno per il piatto, ed eseguire le misurazioni due volte. Per maggiori dettagli, vedere la sezione corrispondente. Attenzione: assicurati che l'accelerometro e le eventuali viti che lo tengono in posizione non tocchino parti metalliche della stampante. Fondamentalmente, il supporto deve essere progettato in modo tale da garantire l'isolamento elettrico dell'accelerometro dal telaio della stampante. Non riuscendo a garantire che pu\u00f2 creare un loop di massa nel sistema che potrebbe danneggiare l'elettronica. Installazione software \u00b6 Si noti che le misurazioni della risonanza e la calibrazione automatica dello shaper richiedono dipendenze software aggiuntive non installate per impostazione predefinita. Innanzitutto, esegui sul tuo Raspberry Pi i seguenti comandi: sudo apt update sudo apt install python3-numpy python3-matplotlib libatlas-base-dev Quindi, per installare NumPy nell'ambiente Klipper, esegui il comando: ~/klippy-env/bin/pip install -v numpy Nota che, a seconda delle prestazioni della CPU, potrebbe volerci molto tempo, fino a 10-20 minuti. Sii paziente e attendi il completamento dell'installazione. In alcune occasioni, se la scheda ha poca RAM, l'installazione potrebbe non riuscire e sar\u00e0 necessario abilitare la swap. Successivamente, controlla e segui le istruzioni nel documento RPi Microcontroller per configurare \"linux mcu\" sul Raspberry Pi. Configura ADXL345 con RPi \u00b6 Assicurati che il driver SPI di Linux sia abilitato eseguendo sudo raspi-config e abilitando SPI nel menu \"Opzioni di interfaccia\". Aggiungere quanto segue al file printer.cfg: [mcu rpi] serial: /tmp/klipper_host_mcu [adxl345] cs_pin: rpi:None [resonance_tester] accel_chip: adxl345 probe_points: 100, 100, 20 # un esempio Si consiglia di iniziare con 1 punto sonda, al centro del piano di stampa, leggermente al di sopra di esso. Configura la serie MPU-6000/9000 con RPi \u00b6 Assicurati che il driver Linux I2C sia abilitato e che la velocit\u00e0 di trasmissione sia impostata su 400000 (consulta la sezione Abilitazione di I2C per ulteriori dettagli). Quindi, aggiungi quanto segue a printer.cfg: [mcu rpi] serial: /tmp/klipper_host_mcu [mpu9250] i2c_mcu: rpi i2c_bus: i2c.1 [resonance_tester] accel_chip: mpu9250 probe_points: 100, 100, 20 # un esempio Configura la serie MPU-6000/9000 con PICO \u00b6 PICO I2C \u00e8 impostato su 400000 per impostazione predefinita. Aggiungi semplicemente quanto segue a printer.cfg: [mcu pico] serial: /dev/serial/by-id/<ID seriale del tuo PICO> [mpu9250] i2c_mcu: pico i2c_bus: i2c1a [resonance_tester] accel_chip: mpu9250 probe_points: 100, 100, 20 # un esempio [static_digital_output pico_3V3pwm] # Aumenta la stabilit\u00e0 pin:pico:gpio23 Riavvia Klipper tramite il comando RESTART . Misurare le risonanze \u00b6 Controllo della configurazione \u00b6 Ora puoi testare una connessione. Per \"per piatti non scorrevoli\" (es. un accelerometro), in Octoprint, inserisci ACCELEROMETER_QUERY Per \"piatti scorrevoli\" (ad es. pi\u00f9 di un accelerometro), immettere ACCELEROMETER_QUERY CHIP=<chip> dove <chip> \u00e8 il nome del chip immesso, ad es. CHIP=piatto (vedi: bed-slinger ) per tutti i chip dell'accelerometro installati. Dovresti vedere le misurazioni attuali dall'accelerometro, inclusa l'accelerazione di caduta libera, ad es. Recv: // adxl345 values (x, y, z): 470.719200, 941.438400, 9728.196800 Se ricevi un errore come Invalid adxl345 id (got xx vs e5) , dove xx \u00e8 un altro ID, \u00e8 indicativo del problema di connessione con ADXL345 o del sensore difettoso. Ricontrolla l'alimentazione, il cablaggio (che corrisponda agli schemi, nessun filo \u00e8 rotto o allentato, ecc.) e la qualit\u00e0 delle saldature. Se si utilizza l'accelerometro della serie MPU-6000/9000 e viene visualizzato come mpu-unknown , utilizzare con cautela! Probabilmente sono chip ricondizionati! Quindi, prova a eseguire MEASURE_AXES_NOISE in Octoprint, dovresti ottenere alcuni numeri di riferimento per il rumore dell'accelerometro sugli assi (dovrebbe essere compreso tra ~1-100). Un rumore degli assi troppo elevato (ad es. 1000 e pi\u00f9) pu\u00f2 essere indicativo di problemi con il sensore, problemi con la sua alimentazione o ventole sbilanciate troppo rumorose su una stampante 3D. Misurare le risonanze \u00b6 Ora puoi eseguire alcuni test realistici. Esegui il seguente comando: TEST_RESONANCES AXIS=X Nota che creer\u00e0 vibrazioni sull'asse X. Disabiliter\u00e0 anche l'input shaping se era stato abilitato in precedenza, poich\u00e9 non \u00e8 valido eseguire il test di risonanza con l'input shaper abilitato. Attenzione! Assicurati di osservare la stampante per la prima volta, per assicurarti che le vibrazioni non diventino troppo violente (il comando M112 pu\u00f2 essere utilizzato per interrompere il test in caso di emergenza; si spera che non si verifichi questo per\u00f2). Se le vibrazioni diventano troppo forti, puoi provare a specificare un valore inferiore al valore predefinito per il parametro accel_per_hz nella sezione [resonance_tester] , ad es. [resonance_tester] accel_chip: adxl345 accel_per_hz: 50 # default \u00e8 75 probe_points: ... Se funziona per l'asse X, esegui anche per l'asse Y: TEST_RESONANCES AXIS=Y Questo generer\u00e0 2 file CSV ( /tmp/resonances_x_*.csv e /tmp/resonances_y_*.csv ). Questi file possono essere elaborati con lo script autonomo su un Raspberry Pi. Per farlo, esegui i seguenti comandi: ~/klipper/scripts/calibrate_shaper.py /tmp/resonances_x_*.csv -o /tmp/shaper_calibrate_x.png ~/klipper/scripts/calibrate_shaper.py /tmp/resonances_y_*.csv -o /tmp/shaper_calibrate_y.png Questo script generer\u00e0 i grafici /tmp/shaper_calibrate_x.png e /tmp/shaper_calibrate_y.png con le risposte in frequenza. Riceverai anche le frequenze suggerite per ogni input shaper, nonch\u00e9 quale input shaper \u00e8 consigliato per la tua configurazione. Per esempio: Fitted shaper 'zv' frequency = 34.4 Hz (vibrations = 4.0%, smoothing ~= 0.132) To avoid too much smoothing with 'zv', suggested max_accel <= 4500 mm/sec^2 Fitted shaper 'mzv' frequency = 34.6 Hz (vibrations = 0.0%, smoothing ~= 0.170) To avoid too much smoothing with 'mzv', suggested max_accel <= 3500 mm/sec^2 Fitted shaper 'ei' frequency = 41.4 Hz (vibrations = 0.0%, smoothing ~= 0.188) To avoid too much smoothing with 'ei', suggested max_accel <= 3200 mm/sec^2 Fitted shaper '2hump_ei' frequency = 51.8 Hz (vibrations = 0.0%, smoothing ~= 0.201) To avoid too much smoothing with '2hump_ei', suggested max_accel <= 3000 mm/sec^2 Fitted shaper '3hump_ei' frequency = 61.8 Hz (vibrations = 0.0%, smoothing ~= 0.215) To avoid too much smoothing with '3hump_ei', suggested max_accel <= 2800 mm/sec^2 Recommended shaper is mzv @ 34.6 Hz La configurazione suggerita pu\u00f2 essere aggiunta alla sezione [input_shaper] di printer.cfg , ad esempio: [input_shaper] shaper_freq_x: ... shaper_type_x: ... shaper_freq_y: 34.6 shaper_type_y: mzv [printer] max_accel: 3000 # non dovrebbe superare il max_accel stimato per gli assi X e Y oppure puoi scegliere tu stesso un'altra configurazione in base ai grafici generati: i picchi nella densit\u00e0 spettrale di potenza sui grafici corrispondono alle frequenze di risonanza della stampante. Nota che in alternativa puoi eseguire l'autocalibrazione dello input shaper da Klipper directly , che pu\u00f2 essere conveniente, ad esempio, per lo input shaper re-calibration . Stampanti con piatto scorrevole \u00b6 Se la tua stampante ha un piatto scorrevole, dovrai cambiare la posizione dell'accelerometro tra le misurazioni per gli assi X e Y: misurare le risonanze dell'asse X con l'accelerometro collegato alla testa di stampa e le risonanze dell'asse Y - al piatto. Tuttavia, puoi anche collegare due accelerometri contemporaneamente, sebbene debbano essere collegati a schede diverse (ad esempio, a una scheda RPi e MCU della stampante) o a due diverse interfacce SPI fisiche sulla stessa scheda (raramente disponibili). Quindi possono essere configurati nel modo seguente: [adxl345 hotend] # Supponendo che il chip \"hotend\" sia collegato a un RPi cs_pin: rpi:None [adxl345 bed] # Supponendo che il chip `bed` sia collegato a una scheda MCU della stampante cs_pin: ... # Pin di selezione chip SPI (CS) della scheda stampante [resonance_tester] # Assumendo la configurazione tipo della stampante con piatto scorrevole accel_chip_x: adxl345 hotend accel_chip_y: adxl345 bed probe_points: ... Quindi i comandi TEST_RESONANCES AXIS=X e TEST_RESONANCES AXIS=Y utilizzeranno l'accelerometro corretto per ciascun asse. Max smoothing \u00b6 Tieni presente che lo input shaper pu\u00f2 creare un po' di smoothing nelle parti. La regolazione automatica del input shaper eseguita dallo script calibrate_shaper.py o dal comando SHAPER_CALIBRATE cercano di non esacerbare lo smoothing, ma allo stesso tempo cercano di ridurre al minimo le vibrazioni risultanti. A volte possono fare una scelta non ottimale della frequenza dello shaper, o forse semplicemente preferisci avere meno smoothing in alcune parti a scapito di maggiori vibrazioni residue. In questi casi \u00e8 possibile richiedere di limitare lo smoothing massimo dal input shaper. Consideriamo i seguenti risultati della sintonizzazione automatica: Fitted shaper 'zv' frequency = 57.8 Hz (vibrations = 20.3%, smoothing ~= 0.053) To avoid too much smoothing with 'zv', suggested max_accel <= 13000 mm/sec^2 Fitted shaper 'mzv' frequency = 34.8 Hz (vibrations = 3.6%, smoothing ~= 0.168) To avoid too much smoothing with 'mzv', suggested max_accel <= 3600 mm/sec^2 Fitted shaper 'ei' frequency = 48.8 Hz (vibrations = 4.9%, smoothing ~= 0.135) To avoid too much smoothing with 'ei', suggested max_accel <= 4400 mm/sec^2 Fitted shaper '2hump_ei' frequency = 45.2 Hz (vibrations = 0.1%, smoothing ~= 0.264) To avoid too much smoothing with '2hump_ei', suggested max_accel <= 2200 mm/sec^2 Fitted shaper '3hump_ei' frequency = 48.0 Hz (vibrations = 0.0%, smoothing ~= 0.356) To avoid too much smoothing with '3hump_ei', suggested max_accel <= 1500 mm/sec^2 Recommended shaper is 2hump_ei @ 45.2 Hz Si noti che i valori di smoothing riportati sono alcuni valori proiettati. Questi valori possono essere utilizzati per confrontare diverse configurazioni: maggiore \u00e8 il valore, maggiore sar\u00e0 la levigatura creata da uno shaper. Tuttavia, questi punteggi di smoothing non rappresentano alcuna misura reale dello smoothing, perch\u00e9 lo smoothing effettivo dipende dai parametri max_accel e square_corner_velocity . Pertanto, \u00e8 necessario eseguire alcune stampe di prova per vedere quanta smoothing crea esattamente una configurazione scelta. Nell'esempio sopra i parametri dello shaper suggeriti non sono male, ma cosa succede se si desidera ottenere meno smooting sull'asse X? Puoi provare a limitare lo smoothing massimo dello shaper usando il seguente comando: ~/klipper/scripts/calibrate_shaper.py /tmp/resonances_x_*.csv -o /tmp/shaper_calibrate_x.png --max_smoothing=0.2 che limita lo smoothing a un punteggio di 0.2. Ora puoi ottenere il seguente risultato: Fitted shaper 'zv' frequency = 55.4 Hz (vibrations = 19.7%, smoothing ~= 0.057) To avoid too much smoothing with 'zv', suggested max_accel <= 12000 mm/sec^2 Fitted shaper 'mzv' frequency = 34.6 Hz (vibrations = 3.6%, smoothing ~= 0.170) To avoid too much smoothing with 'mzv', suggested max_accel <= 3500 mm/sec^2 Fitted shaper 'ei' frequency = 48.2 Hz (vibrations = 4.8%, smoothing ~= 0.139) To avoid too much smoothing with 'ei', suggested max_accel <= 4300 mm/sec^2 Fitted shaper '2hump_ei' frequency = 52.0 Hz (vibrations = 2.7%, smoothing ~= 0.200) To avoid too much smoothing with '2hump_ei', suggested max_accel <= 3000 mm/sec^2 Fitted shaper '3hump_ei' frequency = 72.6 Hz (vibrations = 1.4%, smoothing ~= 0.155) To avoid too much smoothing with '3hump_ei', suggested max_accel <= 3900 mm/sec^2 Recommended shaper is 3hump_ei @ 72.6 Hz Se si confronta con i parametri suggeriti in precedenza, le vibrazioni sono un po' maggiori, ma lo smoothing \u00e8 notevolmente inferiore rispetto a prima, consentendo un'accelerazione massima maggiore. Quando si decide quale parametro max_smoothing scegliere, \u00e8 possibile utilizzare un approccio per tentativi. Prova alcuni valori diversi e guarda quali risultati ottieni. Si noti che lo smoothing effettivo prodotto dall'input shaper dipende principalmente dalla frequenza di risonanza pi\u00f9 bassa della stampante: maggiore \u00e8 la frequenza della risonanza pi\u00f9 bassa, minore \u00e8 lo smoothing. Pertanto, se si richiede allo script di trovare una configurazione dell'input shaper con lo smoothing irrealisticamente piccolo, sar\u00e0 a scapito di un aumento del ringing alle frequenze di risonanza pi\u00f9 basse (che sono, in genere, anche pi\u00f9 visibili nelle stampe). Quindi, ricontrolla sempre le vibrazioni rimanenti previste riportate dallo script e assicurati che non siano troppo alte. Nota che se hai scelto un buon valore max_smoothing per entrambi gli assi, puoi salvarlo in printer.cfg come [resonance_tester] accel_chip: ... probe_points: ... max_smoothing: 0.25 # un esempio Quindi, se riesegui l'autotuning dello shaper di input usando il comando Klipper SHAPER_CALIBRATE in futuro, utilizzer\u00e0 il valore max_smoothing memorizzato come riferimento. Seleziona max_accel \u00b6 Poich\u00e9 l'input shaper pu\u00f2 creare un po' di smussamento nelle parti, specialmente ad accelerazioni elevate, sar\u00e0 comunque necessario scegliere il valore max_accel che non crei troppo smussamento \"smoothing\" nelle parti stampate. Uno script di calibrazione fornisce una stima per il parametro max_accel che non dovrebbe creare un smoothing eccessivo. Si noti che il max_accel visualizzato dallo script di calibrazione \u00e8 solo un massimo teorico al quale il rispettivo shaper \u00e8 ancora in grado di lavorare senza produrre troppo smoothing. Non \u00e8 affatto una raccomandazione impostare questa accelerazione per la stampa. L'accelerazione massima che la stampante \u00e8 in grado di sostenere dipende dalle sue propriet\u00e0 meccaniche e dalla coppia massima dei motori passo-passo utilizzati. Pertanto, si suggerisce di impostare max_accel nella sezione [printer] che non superi i valori stimati per gli assi X e Y, probabilmente con un margine di sicurezza conservativo. In alternativa, segui questa parte della guida all'ottimizzazione dello input shaper e stampa il modello di test per scegliere sperimentalmente il parametro max_accel . Lo stesso avviso vale per lo input shaper auto-calibration con il comando SHAPER_CALIBRATE : \u00e8 comunque necessario scegliere il giusto valore di max_accel dopo l'auto-calibrazione, e il i limiti di accelerazione non verranno applicati automaticamente. Se stai eseguendo una ricalibrazione dello shaper e lo smoothing riportato per la configurazione dello shaper suggerita \u00e8 quasi lo stesso di quello ottenuto durante la calibrazione precedente, questo passaggio pu\u00f2 essere saltato. Test di assi personalizzati \u00b6 Il comando TEST_RESONANCES supporta assi personalizzati. Anche se questo non \u00e8 molto utile per la calibrazione del input shaper, pu\u00f2 essere utilizzato per studiare in profondit\u00e0 le risonanze della stampante e per controllare, ad esempio, la tensione della cinghia. Per controllare la tensione della cinghia sulle stampanti CoreXY, eseguire TEST_RESONANCES AXIS=1,1 OUTPUT=raw_data TEST_RESONANCES AXIS=1,-1 OUTPUT=raw_data e usa graph_accelerometer.py per elaborare i file generati, ad es. ~/klipper/scripts/graph_accelerometer.py -c /tmp/raw_data_axis*.csv -o /tmp/resonances.png che generer\u00e0 /tmp/resonances.png confrontando le risonanze. Per le stampanti Delta con la posizione della torre predefinita (torre A ~= 210 gradi, B ~= 330 gradi e C ~= 90 gradi), eseguire TEST_RESONANCES AXIS=0,1 OUTPUT=raw_data TEST_RESONANCES AXIS=-0.866025404,-0.5 OUTPUT=raw_data TEST_RESONANCES AXIS=0.866025404,-0.5 OUTPUT=raw_data e quindi utilizzare lo stesso comando ~/klipper/scripts/graph_accelerometer.py -c /tmp/raw_data_axis*.csv -o /tmp/resonances.png per generare /tmp/resonances.png confrontando le risonanze. Calibrazione automatica Input Shaper \u00b6 Oltre a scegliere manualmente i parametri appropriati per la funzione di input shaper, \u00e8 anche possibile eseguire l'autotuning per l'input shaper direttamente da Klipper. Esegui il seguente comando tramite il terminale Octoprint: SHAPER_CALIBRATE Questo eseguir\u00e0 il test completo per entrambi gli assi e generer\u00e0 l'output csv ( /tmp/calibration_data_*.csv per impostazione predefinita) per la risposta in frequenza e gli input shaper suggeriti. Riceverai anche le frequenze suggerite per ciascun input shaper, nonch\u00e9 quale input shaper \u00e8 consigliato per la tua configurazione, sulla console Octoprint. Per esempio: Calculating the best input shaper parameters for y axis Fitted shaper 'zv' frequency = 39.0 Hz (vibrations = 13.2%, smoothing ~= 0.105) To avoid too much smoothing with 'zv', suggested max_accel <= 5900 mm/sec^2 Fitted shaper 'mzv' frequency = 36.8 Hz (vibrations = 1.7%, smoothing ~= 0.150) To avoid too much smoothing with 'mzv', suggested max_accel <= 4000 mm/sec^2 Fitted shaper 'ei' frequency = 36.6 Hz (vibrations = 2.2%, smoothing ~= 0.240) To avoid too much smoothing with 'ei', suggested max_accel <= 2500 mm/sec^2 Fitted shaper '2hump_ei' frequency = 48.0 Hz (vibrations = 0.0%, smoothing ~= 0.234) To avoid too much smoothing with '2hump_ei', suggested max_accel <= 2500 mm/sec^2 Fitted shaper '3hump_ei' frequency = 59.0 Hz (vibrations = 0.0%, smoothing ~= 0.235) To avoid too much smoothing with '3hump_ei', suggested max_accel <= 2500 mm/sec^2 Recommended shaper_type_y = mzv, shaper_freq_y = 36.8 Hz Se sei d'accordo con i parametri suggeriti, puoi eseguire ora SAVE_CONFIG per salvarli e riavviare Klipper. Nota che questo non aggiorner\u00e0 il valore max_accel nella sezione [printer] . Dovresti aggiornarlo manualmente seguendo le considerazioni nella sezione Selecting max_accel . Se la tua stampante \u00e8 una stampante a piatto mobile, puoi specificare quale asse testare, in modo da poter cambiare il punto di montaggio dell'accelerometro tra i test (per impostazione predefinita, il test viene eseguito per entrambi gli assi): SHAPER_CALIBRATE AXIS=Y \u00c8 possibile eseguire SAVE_CONFIG due volte, dopo aver calibrato ciascun asse. Tuttavia, se hai collegato due accelerometri contemporaneamente, esegui semplicemente SHAPER_CALIBRATE senza specificare un asse per calibrare l' input shaper per entrambi gli assi in una volta sola. Input Shaper ricalibrazione \u00b6 Il comando SHAPER_CALIBRATE pu\u00f2 essere utilizzato anche per ricalibrare lo shaper di input in futuro, specialmente se vengono apportate alcune modifiche alla stampante che possono influire sulla sua cinematica. \u00c8 possibile eseguire nuovamente la calibrazione completa utilizzando il comando SHAPER_CALIBRATE , o limitare l'autocalibrazione a un singolo asse fornendo il parametro AXIS= , come SHAPER_CALIBRATE AXIS=X Attenzione! Non \u00e8 consigliabile eseguire l'autocalibrazione dello shaper molto frequentemente (ad es. prima di ogni stampa o ogni giorno). Per determinare le frequenze di risonanza, l'autocalibrazione crea intense vibrazioni su ciascuno degli assi. Generalmente, le stampanti 3D non sono progettate per resistere a un'esposizione prolungata a vibrazioni vicino alle frequenze di risonanza. Ci\u00f2 potrebbe aumentare l'usura dei componenti della stampante e ridurne la durata. C'\u00e8 anche un aumento del rischio che alcune parti si svitino o si allentino. Verificare sempre che tutte le parti della stampante (comprese quelle che normalmente potrebbero non muoversi) siano fissate saldamente in posizione dopo ogni autotuning. Inoltre, a causa di un po' di rumore nelle misurazioni, \u00e8 possibile che i risultati dell'ottimizzazione siano leggermente diversi da una calibrazione all'altra. Tuttavia, non ci si aspetta che il rumore influisca troppo sulla qualit\u00e0 di stampa. Tuttavia, si consiglia comunque di ricontrollare i parametri suggeriti e di stampare alcune stampe di prova prima di utilizzarli per confermare che siano corretti. Elaborazione offline dei dati dell'accelerometro \u00b6 \u00c8 possibile generare i dati grezzi dell'accelerometro ed elaborarli offline (ad esempio su una macchina host), ad esempio per trovare risonanze. Per fare ci\u00f2, esegui i seguenti comandi tramite il terminale Octoprint: SET_INPUT_SHAPER SHAPER_FREQ_X=0 SHAPER_FREQ_Y=0 TEST_RESONANCES AXIS=X OUTPUT=raw_data ignorando eventuali errori per il comando SET_INPUT_SHAPER . Per il comando TEST_RESONANCES , specificare l'asse di test desiderato. I dati grezzi verranno scritti nella directory /tmp sull'RPi. I dati grezzi possono anche essere ottenuti eseguendo il comando ACCELEROMETER_MEASURE due volte durante una normale attivit\u00e0 della stampante: prima per avviare le misurazioni, quindi per interromperle e scrivere il file di output. Fare riferimento a G-Codes per maggiori dettagli. I dati possono essere elaborati successivamente dai seguenti script: scripts/graph_accelerometer.py e scripts/calibrate_shaper.py . Entrambi accettano uno o pi\u00f9 file CSV non elaborati come input a seconda della modalit\u00e0. Lo script graph_accelerometer.py supporta diverse modalit\u00e0 operative: tracciando i dati grezzi dell'accelerometro (usa il parametro -r ), \u00e8 supportato solo 1 input; tracciando una risposta in frequenza (non sono richiesti parametri aggiuntivi), se sono specificati pi\u00f9 ingressi, viene calcolata la risposta in frequenza media; confronto della risposta in frequenza tra pi\u00f9 ingressi (usare il parametro -c ); puoi inoltre specificare quale asse dell'accelerometro considerare tramite il parametro -a x , -a y o -a z (se non specificato, viene utilizzata la somma delle vibrazioni per tutti gli assi); tracciando lo spettrogramma (usare il parametro -s ), \u00e8 supportato solo 1 input; \u00e8 inoltre possibile specificare quale asse dell'accelerometro considerare tramite il parametro -a x , -a y o -a z (se non specificato, viene utilizzata la somma delle vibrazioni per tutti gli assi). Si noti che lo script graph_accelerometer.py supporta solo i file raw_data*.csv e non i file resonances*.csv o calibration_data*.csv. Per esempio, ~/klipper/scripts/graph_accelerometer.py /tmp/raw_data_x_*.csv -o /tmp/resonances_x.png -c -a z traccer\u00e0 il confronto di diversi file /tmp/raw_data_x_*.csv per l'asse Z con il file /tmp/resonances_x.png . Lo script shaper_calibrate.py accetta 1 o pi\u00f9 input e pu\u00f2 eseguire l'ottimizzazione automatica dello shaper di input e suggerire i parametri migliori che funzionano bene per tutti gli input forniti. Stampa i parametri suggeriti sulla console e pu\u00f2 inoltre generare il grafico se viene fornito il parametro -o output.png , o il file CSV se viene specificato il parametro -c output.csv . Fornire diversi input allo script shaper_calibrate.py pu\u00f2 essere utile se si esegue un'ottimizzazione avanzata degli shaper di input, ad esempio: Esecuzione di TEST_RESONANCES AXIS=X OUTPUT=raw_data (e asse Y ) per un singolo asse due volte su una stampante con piatto scorrevole con l'accelerometro collegato alla testa di stampa la prima volta e l'accelerometro collegato al piatto la seconda volta in modo da rilevare le risonanze incrociate degli assi e tentare di cancellarle con gli input shaper. Esecuzione di TEST_RESONANCES AXIS=Y OUTPUT=raw_data due volte su un supporto da piatto con un piatto di vetro e una superficie magnetica (che \u00e8 pi\u00f9 leggera) per trovare i parametri dello shaper di input che funzionano bene per qualsiasi configurazione della superficie di stampa. Combinazione dei dati di risonanza da pi\u00f9 punti di test. Combinando i dati di risonanza da 2 assi (ad es. su una stampante con piatto scorrevole per configurare input_shaper dell'asse X dalle risonanze degli assi X e Y per annullare le vibrazioni del piatto nel caso in cui l'ugello \"cattura\" una stampa quando si sposta nella direzione dell'asse X ).","title":"Misurazione delle risonanze"},{"location":"Measuring_Resonances.html#misurazione-delle-risonanze","text":"Klipper ha il supporto integrato per l'accelerometro ADXL345, che pu\u00f2 essere utilizzato per misurare le frequenze di risonanza della stampante per diversi assi, e per l'autotuning input shapers per compensare le risonanze. Si noti che l'utilizzo di ADXL345 richiede alcune operazioni di saldatura e crimpatura. ADXL345 pu\u00f2 essere collegato direttamente a un Raspberry Pi o a un'interfaccia SPI di una scheda MCU (deve essere ragionevolmente veloce). Quando acquisti ADXL345, tieni presente che esiste una variet\u00e0 di diversi design di schede PCB e diversi cloni di essi. Assicurati che la scheda supporti la modalit\u00e0 SPI (un piccolo numero di schede sembra essere configurato in modo rigido per I2C trascinando SDO su GND) e, se deve essere collegato a un MCU per stampante da 5 V, che abbia un regolatore di tensione e un cambio di livello.","title":"Misurazione delle risonanze"},{"location":"Measuring_Resonances.html#istruzioni-per-linstallazione","text":"","title":"Istruzioni per l'installazione"},{"location":"Measuring_Resonances.html#cablaggio","text":"Si consiglia un cavo Ethernet con doppini intrecciati schermati (cat5e o superiore) per l'integrit\u00e0 del segnale su lunghe distanze. Se si verificano ancora problemi di integrit\u00e0 del segnale (errori SPI/I2C), accorciare il cavo. Collegare la schermatura del cavo Ethernet al gnd/ground della scheda controller RPI. Ricontrolla il cablaggio prima di accendere per evitare di danneggiare il tuo MCU/Raspberry Pi o l'accelerometro.","title":"Cablaggio"},{"location":"Measuring_Resonances.html#accelerometri-spi","text":"Ordine dei doppini intrecciati suggerito: GND+MISO 3.3V+MOSI SCLK+CS","title":"Accelerometri SPI"},{"location":"Measuring_Resonances.html#adxl345","text":"Nota: molti MCU funzionano con un ADXL345 in modalit\u00e0 SPI (ad es. Pi Pico), il cablaggio e la configurazione variano in base alla scheda specifica ed ai pin disponibili. Devi connettere ADXL345 al tuo Raspberry Pi tramite SPI. Si noti che la connessione I2C, suggerita dalla documentazione di ADXL345, ha un throughput troppo basso e non funzioner\u00e0 . Lo schema di connessione consigliato: ADXL345 pin RPi pin Nome pin RPi 3V3 (or VCC) 01 3.3v alimentazione DC GND 06 Ground CS 24 GPIO08 (SPI0_CE0_N) SDO 21 GPIO09 (SPI0_MISO) SDA 19 GPIO10 (SPI0_MOSI) SCL 23 GPIO11 (SPI0_SCLK) Schemi collegamenti Fritzing per alcune delle schede ADXL345:","title":"ADXL345"},{"location":"Measuring_Resonances.html#accelerometri-i2c","text":"Ordine dei doppini intrecciati suggerito: 3.3V+SDA GND+SCL","title":"Accelerometri I2C"},{"location":"Measuring_Resonances.html#mpu-9250mpu-9255mpu-6515mpu-6050mpu-6500","text":"Le alternative all'ADXL345 sono MPU-9250/MPU-9255/MPU-6515/MPU-6050/MPU-6500. Questi accelerometri sono stati testati per funzionare su I2C su RPi o RP2040(pico) a 400kbaud. Schema di connessione consigliato per I2C su Raspberry Pi: pin MPU-9250 RPi pin Nome pin RPi VCC 01 3.3v alimentazione DC GND 09 Ground SDA 03 GPIO02 (SDA1) SCL 05 GPIO03 (SCL1) Schema di connessione consigliato per I2C(i2c0a) su RP2040: pin MPU-9250 pin RP2040 Nome pin RPi VCC 39 3v3 GND 38 Ground SDA 01 GP0 (I2C0 SDA) SCL 02 GP1 (I2C0 SCL)","title":"MPU-9250/MPU-9255/MPU-6515/MPU-6050/MPU-6500"},{"location":"Measuring_Resonances.html#montaggio-dellaccelerometro","text":"L'accelerometro deve essere collegato alla testa di stampa. \u00c8 necessario progettare un supporto adeguato che si adatti alla propria stampante 3D. \u00c8 meglio allineare gli assi dell'accelerometro con gli assi della stampante (ma se lo rende pi\u00f9 comodo, gli assi possono essere scambiati - cio\u00e8 non c'\u00e8 bisogno di allineare l'asse X con X e cos\u00ec via - dovrebbe andare bene anche se l'asse Z di l'accelerometro \u00e8 l'asse X della stampante, ecc.). Un esempio di montaggio di ADXL345 su SmartEffect: Si noti che su una stampante con piatto mobile \u00e8 necessario progettare 2 supporti: uno per la testina e uno per il piatto, ed eseguire le misurazioni due volte. Per maggiori dettagli, vedere la sezione corrispondente. Attenzione: assicurati che l'accelerometro e le eventuali viti che lo tengono in posizione non tocchino parti metalliche della stampante. Fondamentalmente, il supporto deve essere progettato in modo tale da garantire l'isolamento elettrico dell'accelerometro dal telaio della stampante. Non riuscendo a garantire che pu\u00f2 creare un loop di massa nel sistema che potrebbe danneggiare l'elettronica.","title":"Montaggio dell'accelerometro"},{"location":"Measuring_Resonances.html#installazione-software","text":"Si noti che le misurazioni della risonanza e la calibrazione automatica dello shaper richiedono dipendenze software aggiuntive non installate per impostazione predefinita. Innanzitutto, esegui sul tuo Raspberry Pi i seguenti comandi: sudo apt update sudo apt install python3-numpy python3-matplotlib libatlas-base-dev Quindi, per installare NumPy nell'ambiente Klipper, esegui il comando: ~/klippy-env/bin/pip install -v numpy Nota che, a seconda delle prestazioni della CPU, potrebbe volerci molto tempo, fino a 10-20 minuti. Sii paziente e attendi il completamento dell'installazione. In alcune occasioni, se la scheda ha poca RAM, l'installazione potrebbe non riuscire e sar\u00e0 necessario abilitare la swap. Successivamente, controlla e segui le istruzioni nel documento RPi Microcontroller per configurare \"linux mcu\" sul Raspberry Pi.","title":"Installazione software"},{"location":"Measuring_Resonances.html#configura-adxl345-con-rpi","text":"Assicurati che il driver SPI di Linux sia abilitato eseguendo sudo raspi-config e abilitando SPI nel menu \"Opzioni di interfaccia\". Aggiungere quanto segue al file printer.cfg: [mcu rpi] serial: /tmp/klipper_host_mcu [adxl345] cs_pin: rpi:None [resonance_tester] accel_chip: adxl345 probe_points: 100, 100, 20 # un esempio Si consiglia di iniziare con 1 punto sonda, al centro del piano di stampa, leggermente al di sopra di esso.","title":"Configura ADXL345 con RPi"},{"location":"Measuring_Resonances.html#configura-la-serie-mpu-60009000-con-rpi","text":"Assicurati che il driver Linux I2C sia abilitato e che la velocit\u00e0 di trasmissione sia impostata su 400000 (consulta la sezione Abilitazione di I2C per ulteriori dettagli). Quindi, aggiungi quanto segue a printer.cfg: [mcu rpi] serial: /tmp/klipper_host_mcu [mpu9250] i2c_mcu: rpi i2c_bus: i2c.1 [resonance_tester] accel_chip: mpu9250 probe_points: 100, 100, 20 # un esempio","title":"Configura la serie MPU-6000/9000 con RPi"},{"location":"Measuring_Resonances.html#configura-la-serie-mpu-60009000-con-pico","text":"PICO I2C \u00e8 impostato su 400000 per impostazione predefinita. Aggiungi semplicemente quanto segue a printer.cfg: [mcu pico] serial: /dev/serial/by-id/<ID seriale del tuo PICO> [mpu9250] i2c_mcu: pico i2c_bus: i2c1a [resonance_tester] accel_chip: mpu9250 probe_points: 100, 100, 20 # un esempio [static_digital_output pico_3V3pwm] # Aumenta la stabilit\u00e0 pin:pico:gpio23 Riavvia Klipper tramite il comando RESTART .","title":"Configura la serie MPU-6000/9000 con PICO"},{"location":"Measuring_Resonances.html#misurare-le-risonanze","text":"","title":"Misurare le risonanze"},{"location":"Measuring_Resonances.html#controllo-della-configurazione","text":"Ora puoi testare una connessione. Per \"per piatti non scorrevoli\" (es. un accelerometro), in Octoprint, inserisci ACCELEROMETER_QUERY Per \"piatti scorrevoli\" (ad es. pi\u00f9 di un accelerometro), immettere ACCELEROMETER_QUERY CHIP=<chip> dove <chip> \u00e8 il nome del chip immesso, ad es. CHIP=piatto (vedi: bed-slinger ) per tutti i chip dell'accelerometro installati. Dovresti vedere le misurazioni attuali dall'accelerometro, inclusa l'accelerazione di caduta libera, ad es. Recv: // adxl345 values (x, y, z): 470.719200, 941.438400, 9728.196800 Se ricevi un errore come Invalid adxl345 id (got xx vs e5) , dove xx \u00e8 un altro ID, \u00e8 indicativo del problema di connessione con ADXL345 o del sensore difettoso. Ricontrolla l'alimentazione, il cablaggio (che corrisponda agli schemi, nessun filo \u00e8 rotto o allentato, ecc.) e la qualit\u00e0 delle saldature. Se si utilizza l'accelerometro della serie MPU-6000/9000 e viene visualizzato come mpu-unknown , utilizzare con cautela! Probabilmente sono chip ricondizionati! Quindi, prova a eseguire MEASURE_AXES_NOISE in Octoprint, dovresti ottenere alcuni numeri di riferimento per il rumore dell'accelerometro sugli assi (dovrebbe essere compreso tra ~1-100). Un rumore degli assi troppo elevato (ad es. 1000 e pi\u00f9) pu\u00f2 essere indicativo di problemi con il sensore, problemi con la sua alimentazione o ventole sbilanciate troppo rumorose su una stampante 3D.","title":"Controllo della configurazione"},{"location":"Measuring_Resonances.html#misurare-le-risonanze_1","text":"Ora puoi eseguire alcuni test realistici. Esegui il seguente comando: TEST_RESONANCES AXIS=X Nota che creer\u00e0 vibrazioni sull'asse X. Disabiliter\u00e0 anche l'input shaping se era stato abilitato in precedenza, poich\u00e9 non \u00e8 valido eseguire il test di risonanza con l'input shaper abilitato. Attenzione! Assicurati di osservare la stampante per la prima volta, per assicurarti che le vibrazioni non diventino troppo violente (il comando M112 pu\u00f2 essere utilizzato per interrompere il test in caso di emergenza; si spera che non si verifichi questo per\u00f2). Se le vibrazioni diventano troppo forti, puoi provare a specificare un valore inferiore al valore predefinito per il parametro accel_per_hz nella sezione [resonance_tester] , ad es. [resonance_tester] accel_chip: adxl345 accel_per_hz: 50 # default \u00e8 75 probe_points: ... Se funziona per l'asse X, esegui anche per l'asse Y: TEST_RESONANCES AXIS=Y Questo generer\u00e0 2 file CSV ( /tmp/resonances_x_*.csv e /tmp/resonances_y_*.csv ). Questi file possono essere elaborati con lo script autonomo su un Raspberry Pi. Per farlo, esegui i seguenti comandi: ~/klipper/scripts/calibrate_shaper.py /tmp/resonances_x_*.csv -o /tmp/shaper_calibrate_x.png ~/klipper/scripts/calibrate_shaper.py /tmp/resonances_y_*.csv -o /tmp/shaper_calibrate_y.png Questo script generer\u00e0 i grafici /tmp/shaper_calibrate_x.png e /tmp/shaper_calibrate_y.png con le risposte in frequenza. Riceverai anche le frequenze suggerite per ogni input shaper, nonch\u00e9 quale input shaper \u00e8 consigliato per la tua configurazione. Per esempio: Fitted shaper 'zv' frequency = 34.4 Hz (vibrations = 4.0%, smoothing ~= 0.132) To avoid too much smoothing with 'zv', suggested max_accel <= 4500 mm/sec^2 Fitted shaper 'mzv' frequency = 34.6 Hz (vibrations = 0.0%, smoothing ~= 0.170) To avoid too much smoothing with 'mzv', suggested max_accel <= 3500 mm/sec^2 Fitted shaper 'ei' frequency = 41.4 Hz (vibrations = 0.0%, smoothing ~= 0.188) To avoid too much smoothing with 'ei', suggested max_accel <= 3200 mm/sec^2 Fitted shaper '2hump_ei' frequency = 51.8 Hz (vibrations = 0.0%, smoothing ~= 0.201) To avoid too much smoothing with '2hump_ei', suggested max_accel <= 3000 mm/sec^2 Fitted shaper '3hump_ei' frequency = 61.8 Hz (vibrations = 0.0%, smoothing ~= 0.215) To avoid too much smoothing with '3hump_ei', suggested max_accel <= 2800 mm/sec^2 Recommended shaper is mzv @ 34.6 Hz La configurazione suggerita pu\u00f2 essere aggiunta alla sezione [input_shaper] di printer.cfg , ad esempio: [input_shaper] shaper_freq_x: ... shaper_type_x: ... shaper_freq_y: 34.6 shaper_type_y: mzv [printer] max_accel: 3000 # non dovrebbe superare il max_accel stimato per gli assi X e Y oppure puoi scegliere tu stesso un'altra configurazione in base ai grafici generati: i picchi nella densit\u00e0 spettrale di potenza sui grafici corrispondono alle frequenze di risonanza della stampante. Nota che in alternativa puoi eseguire l'autocalibrazione dello input shaper da Klipper directly , che pu\u00f2 essere conveniente, ad esempio, per lo input shaper re-calibration .","title":"Misurare le risonanze"},{"location":"Measuring_Resonances.html#stampanti-con-piatto-scorrevole","text":"Se la tua stampante ha un piatto scorrevole, dovrai cambiare la posizione dell'accelerometro tra le misurazioni per gli assi X e Y: misurare le risonanze dell'asse X con l'accelerometro collegato alla testa di stampa e le risonanze dell'asse Y - al piatto. Tuttavia, puoi anche collegare due accelerometri contemporaneamente, sebbene debbano essere collegati a schede diverse (ad esempio, a una scheda RPi e MCU della stampante) o a due diverse interfacce SPI fisiche sulla stessa scheda (raramente disponibili). Quindi possono essere configurati nel modo seguente: [adxl345 hotend] # Supponendo che il chip \"hotend\" sia collegato a un RPi cs_pin: rpi:None [adxl345 bed] # Supponendo che il chip `bed` sia collegato a una scheda MCU della stampante cs_pin: ... # Pin di selezione chip SPI (CS) della scheda stampante [resonance_tester] # Assumendo la configurazione tipo della stampante con piatto scorrevole accel_chip_x: adxl345 hotend accel_chip_y: adxl345 bed probe_points: ... Quindi i comandi TEST_RESONANCES AXIS=X e TEST_RESONANCES AXIS=Y utilizzeranno l'accelerometro corretto per ciascun asse.","title":"Stampanti con piatto scorrevole"},{"location":"Measuring_Resonances.html#max-smoothing","text":"Tieni presente che lo input shaper pu\u00f2 creare un po' di smoothing nelle parti. La regolazione automatica del input shaper eseguita dallo script calibrate_shaper.py o dal comando SHAPER_CALIBRATE cercano di non esacerbare lo smoothing, ma allo stesso tempo cercano di ridurre al minimo le vibrazioni risultanti. A volte possono fare una scelta non ottimale della frequenza dello shaper, o forse semplicemente preferisci avere meno smoothing in alcune parti a scapito di maggiori vibrazioni residue. In questi casi \u00e8 possibile richiedere di limitare lo smoothing massimo dal input shaper. Consideriamo i seguenti risultati della sintonizzazione automatica: Fitted shaper 'zv' frequency = 57.8 Hz (vibrations = 20.3%, smoothing ~= 0.053) To avoid too much smoothing with 'zv', suggested max_accel <= 13000 mm/sec^2 Fitted shaper 'mzv' frequency = 34.8 Hz (vibrations = 3.6%, smoothing ~= 0.168) To avoid too much smoothing with 'mzv', suggested max_accel <= 3600 mm/sec^2 Fitted shaper 'ei' frequency = 48.8 Hz (vibrations = 4.9%, smoothing ~= 0.135) To avoid too much smoothing with 'ei', suggested max_accel <= 4400 mm/sec^2 Fitted shaper '2hump_ei' frequency = 45.2 Hz (vibrations = 0.1%, smoothing ~= 0.264) To avoid too much smoothing with '2hump_ei', suggested max_accel <= 2200 mm/sec^2 Fitted shaper '3hump_ei' frequency = 48.0 Hz (vibrations = 0.0%, smoothing ~= 0.356) To avoid too much smoothing with '3hump_ei', suggested max_accel <= 1500 mm/sec^2 Recommended shaper is 2hump_ei @ 45.2 Hz Si noti che i valori di smoothing riportati sono alcuni valori proiettati. Questi valori possono essere utilizzati per confrontare diverse configurazioni: maggiore \u00e8 il valore, maggiore sar\u00e0 la levigatura creata da uno shaper. Tuttavia, questi punteggi di smoothing non rappresentano alcuna misura reale dello smoothing, perch\u00e9 lo smoothing effettivo dipende dai parametri max_accel e square_corner_velocity . Pertanto, \u00e8 necessario eseguire alcune stampe di prova per vedere quanta smoothing crea esattamente una configurazione scelta. Nell'esempio sopra i parametri dello shaper suggeriti non sono male, ma cosa succede se si desidera ottenere meno smooting sull'asse X? Puoi provare a limitare lo smoothing massimo dello shaper usando il seguente comando: ~/klipper/scripts/calibrate_shaper.py /tmp/resonances_x_*.csv -o /tmp/shaper_calibrate_x.png --max_smoothing=0.2 che limita lo smoothing a un punteggio di 0.2. Ora puoi ottenere il seguente risultato: Fitted shaper 'zv' frequency = 55.4 Hz (vibrations = 19.7%, smoothing ~= 0.057) To avoid too much smoothing with 'zv', suggested max_accel <= 12000 mm/sec^2 Fitted shaper 'mzv' frequency = 34.6 Hz (vibrations = 3.6%, smoothing ~= 0.170) To avoid too much smoothing with 'mzv', suggested max_accel <= 3500 mm/sec^2 Fitted shaper 'ei' frequency = 48.2 Hz (vibrations = 4.8%, smoothing ~= 0.139) To avoid too much smoothing with 'ei', suggested max_accel <= 4300 mm/sec^2 Fitted shaper '2hump_ei' frequency = 52.0 Hz (vibrations = 2.7%, smoothing ~= 0.200) To avoid too much smoothing with '2hump_ei', suggested max_accel <= 3000 mm/sec^2 Fitted shaper '3hump_ei' frequency = 72.6 Hz (vibrations = 1.4%, smoothing ~= 0.155) To avoid too much smoothing with '3hump_ei', suggested max_accel <= 3900 mm/sec^2 Recommended shaper is 3hump_ei @ 72.6 Hz Se si confronta con i parametri suggeriti in precedenza, le vibrazioni sono un po' maggiori, ma lo smoothing \u00e8 notevolmente inferiore rispetto a prima, consentendo un'accelerazione massima maggiore. Quando si decide quale parametro max_smoothing scegliere, \u00e8 possibile utilizzare un approccio per tentativi. Prova alcuni valori diversi e guarda quali risultati ottieni. Si noti che lo smoothing effettivo prodotto dall'input shaper dipende principalmente dalla frequenza di risonanza pi\u00f9 bassa della stampante: maggiore \u00e8 la frequenza della risonanza pi\u00f9 bassa, minore \u00e8 lo smoothing. Pertanto, se si richiede allo script di trovare una configurazione dell'input shaper con lo smoothing irrealisticamente piccolo, sar\u00e0 a scapito di un aumento del ringing alle frequenze di risonanza pi\u00f9 basse (che sono, in genere, anche pi\u00f9 visibili nelle stampe). Quindi, ricontrolla sempre le vibrazioni rimanenti previste riportate dallo script e assicurati che non siano troppo alte. Nota che se hai scelto un buon valore max_smoothing per entrambi gli assi, puoi salvarlo in printer.cfg come [resonance_tester] accel_chip: ... probe_points: ... max_smoothing: 0.25 # un esempio Quindi, se riesegui l'autotuning dello shaper di input usando il comando Klipper SHAPER_CALIBRATE in futuro, utilizzer\u00e0 il valore max_smoothing memorizzato come riferimento.","title":"Max smoothing"},{"location":"Measuring_Resonances.html#seleziona-max_accel","text":"Poich\u00e9 l'input shaper pu\u00f2 creare un po' di smussamento nelle parti, specialmente ad accelerazioni elevate, sar\u00e0 comunque necessario scegliere il valore max_accel che non crei troppo smussamento \"smoothing\" nelle parti stampate. Uno script di calibrazione fornisce una stima per il parametro max_accel che non dovrebbe creare un smoothing eccessivo. Si noti che il max_accel visualizzato dallo script di calibrazione \u00e8 solo un massimo teorico al quale il rispettivo shaper \u00e8 ancora in grado di lavorare senza produrre troppo smoothing. Non \u00e8 affatto una raccomandazione impostare questa accelerazione per la stampa. L'accelerazione massima che la stampante \u00e8 in grado di sostenere dipende dalle sue propriet\u00e0 meccaniche e dalla coppia massima dei motori passo-passo utilizzati. Pertanto, si suggerisce di impostare max_accel nella sezione [printer] che non superi i valori stimati per gli assi X e Y, probabilmente con un margine di sicurezza conservativo. In alternativa, segui questa parte della guida all'ottimizzazione dello input shaper e stampa il modello di test per scegliere sperimentalmente il parametro max_accel . Lo stesso avviso vale per lo input shaper auto-calibration con il comando SHAPER_CALIBRATE : \u00e8 comunque necessario scegliere il giusto valore di max_accel dopo l'auto-calibrazione, e il i limiti di accelerazione non verranno applicati automaticamente. Se stai eseguendo una ricalibrazione dello shaper e lo smoothing riportato per la configurazione dello shaper suggerita \u00e8 quasi lo stesso di quello ottenuto durante la calibrazione precedente, questo passaggio pu\u00f2 essere saltato.","title":"Seleziona max_accel"},{"location":"Measuring_Resonances.html#test-di-assi-personalizzati","text":"Il comando TEST_RESONANCES supporta assi personalizzati. Anche se questo non \u00e8 molto utile per la calibrazione del input shaper, pu\u00f2 essere utilizzato per studiare in profondit\u00e0 le risonanze della stampante e per controllare, ad esempio, la tensione della cinghia. Per controllare la tensione della cinghia sulle stampanti CoreXY, eseguire TEST_RESONANCES AXIS=1,1 OUTPUT=raw_data TEST_RESONANCES AXIS=1,-1 OUTPUT=raw_data e usa graph_accelerometer.py per elaborare i file generati, ad es. ~/klipper/scripts/graph_accelerometer.py -c /tmp/raw_data_axis*.csv -o /tmp/resonances.png che generer\u00e0 /tmp/resonances.png confrontando le risonanze. Per le stampanti Delta con la posizione della torre predefinita (torre A ~= 210 gradi, B ~= 330 gradi e C ~= 90 gradi), eseguire TEST_RESONANCES AXIS=0,1 OUTPUT=raw_data TEST_RESONANCES AXIS=-0.866025404,-0.5 OUTPUT=raw_data TEST_RESONANCES AXIS=0.866025404,-0.5 OUTPUT=raw_data e quindi utilizzare lo stesso comando ~/klipper/scripts/graph_accelerometer.py -c /tmp/raw_data_axis*.csv -o /tmp/resonances.png per generare /tmp/resonances.png confrontando le risonanze.","title":"Test di assi personalizzati"},{"location":"Measuring_Resonances.html#calibrazione-automatica-input-shaper","text":"Oltre a scegliere manualmente i parametri appropriati per la funzione di input shaper, \u00e8 anche possibile eseguire l'autotuning per l'input shaper direttamente da Klipper. Esegui il seguente comando tramite il terminale Octoprint: SHAPER_CALIBRATE Questo eseguir\u00e0 il test completo per entrambi gli assi e generer\u00e0 l'output csv ( /tmp/calibration_data_*.csv per impostazione predefinita) per la risposta in frequenza e gli input shaper suggeriti. Riceverai anche le frequenze suggerite per ciascun input shaper, nonch\u00e9 quale input shaper \u00e8 consigliato per la tua configurazione, sulla console Octoprint. Per esempio: Calculating the best input shaper parameters for y axis Fitted shaper 'zv' frequency = 39.0 Hz (vibrations = 13.2%, smoothing ~= 0.105) To avoid too much smoothing with 'zv', suggested max_accel <= 5900 mm/sec^2 Fitted shaper 'mzv' frequency = 36.8 Hz (vibrations = 1.7%, smoothing ~= 0.150) To avoid too much smoothing with 'mzv', suggested max_accel <= 4000 mm/sec^2 Fitted shaper 'ei' frequency = 36.6 Hz (vibrations = 2.2%, smoothing ~= 0.240) To avoid too much smoothing with 'ei', suggested max_accel <= 2500 mm/sec^2 Fitted shaper '2hump_ei' frequency = 48.0 Hz (vibrations = 0.0%, smoothing ~= 0.234) To avoid too much smoothing with '2hump_ei', suggested max_accel <= 2500 mm/sec^2 Fitted shaper '3hump_ei' frequency = 59.0 Hz (vibrations = 0.0%, smoothing ~= 0.235) To avoid too much smoothing with '3hump_ei', suggested max_accel <= 2500 mm/sec^2 Recommended shaper_type_y = mzv, shaper_freq_y = 36.8 Hz Se sei d'accordo con i parametri suggeriti, puoi eseguire ora SAVE_CONFIG per salvarli e riavviare Klipper. Nota che questo non aggiorner\u00e0 il valore max_accel nella sezione [printer] . Dovresti aggiornarlo manualmente seguendo le considerazioni nella sezione Selecting max_accel . Se la tua stampante \u00e8 una stampante a piatto mobile, puoi specificare quale asse testare, in modo da poter cambiare il punto di montaggio dell'accelerometro tra i test (per impostazione predefinita, il test viene eseguito per entrambi gli assi): SHAPER_CALIBRATE AXIS=Y \u00c8 possibile eseguire SAVE_CONFIG due volte, dopo aver calibrato ciascun asse. Tuttavia, se hai collegato due accelerometri contemporaneamente, esegui semplicemente SHAPER_CALIBRATE senza specificare un asse per calibrare l' input shaper per entrambi gli assi in una volta sola.","title":"Calibrazione automatica Input Shaper"},{"location":"Measuring_Resonances.html#input-shaper-ricalibrazione","text":"Il comando SHAPER_CALIBRATE pu\u00f2 essere utilizzato anche per ricalibrare lo shaper di input in futuro, specialmente se vengono apportate alcune modifiche alla stampante che possono influire sulla sua cinematica. \u00c8 possibile eseguire nuovamente la calibrazione completa utilizzando il comando SHAPER_CALIBRATE , o limitare l'autocalibrazione a un singolo asse fornendo il parametro AXIS= , come SHAPER_CALIBRATE AXIS=X Attenzione! Non \u00e8 consigliabile eseguire l'autocalibrazione dello shaper molto frequentemente (ad es. prima di ogni stampa o ogni giorno). Per determinare le frequenze di risonanza, l'autocalibrazione crea intense vibrazioni su ciascuno degli assi. Generalmente, le stampanti 3D non sono progettate per resistere a un'esposizione prolungata a vibrazioni vicino alle frequenze di risonanza. Ci\u00f2 potrebbe aumentare l'usura dei componenti della stampante e ridurne la durata. C'\u00e8 anche un aumento del rischio che alcune parti si svitino o si allentino. Verificare sempre che tutte le parti della stampante (comprese quelle che normalmente potrebbero non muoversi) siano fissate saldamente in posizione dopo ogni autotuning. Inoltre, a causa di un po' di rumore nelle misurazioni, \u00e8 possibile che i risultati dell'ottimizzazione siano leggermente diversi da una calibrazione all'altra. Tuttavia, non ci si aspetta che il rumore influisca troppo sulla qualit\u00e0 di stampa. Tuttavia, si consiglia comunque di ricontrollare i parametri suggeriti e di stampare alcune stampe di prova prima di utilizzarli per confermare che siano corretti.","title":"Input Shaper ricalibrazione"},{"location":"Measuring_Resonances.html#elaborazione-offline-dei-dati-dellaccelerometro","text":"\u00c8 possibile generare i dati grezzi dell'accelerometro ed elaborarli offline (ad esempio su una macchina host), ad esempio per trovare risonanze. Per fare ci\u00f2, esegui i seguenti comandi tramite il terminale Octoprint: SET_INPUT_SHAPER SHAPER_FREQ_X=0 SHAPER_FREQ_Y=0 TEST_RESONANCES AXIS=X OUTPUT=raw_data ignorando eventuali errori per il comando SET_INPUT_SHAPER . Per il comando TEST_RESONANCES , specificare l'asse di test desiderato. I dati grezzi verranno scritti nella directory /tmp sull'RPi. I dati grezzi possono anche essere ottenuti eseguendo il comando ACCELEROMETER_MEASURE due volte durante una normale attivit\u00e0 della stampante: prima per avviare le misurazioni, quindi per interromperle e scrivere il file di output. Fare riferimento a G-Codes per maggiori dettagli. I dati possono essere elaborati successivamente dai seguenti script: scripts/graph_accelerometer.py e scripts/calibrate_shaper.py . Entrambi accettano uno o pi\u00f9 file CSV non elaborati come input a seconda della modalit\u00e0. Lo script graph_accelerometer.py supporta diverse modalit\u00e0 operative: tracciando i dati grezzi dell'accelerometro (usa il parametro -r ), \u00e8 supportato solo 1 input; tracciando una risposta in frequenza (non sono richiesti parametri aggiuntivi), se sono specificati pi\u00f9 ingressi, viene calcolata la risposta in frequenza media; confronto della risposta in frequenza tra pi\u00f9 ingressi (usare il parametro -c ); puoi inoltre specificare quale asse dell'accelerometro considerare tramite il parametro -a x , -a y o -a z (se non specificato, viene utilizzata la somma delle vibrazioni per tutti gli assi); tracciando lo spettrogramma (usare il parametro -s ), \u00e8 supportato solo 1 input; \u00e8 inoltre possibile specificare quale asse dell'accelerometro considerare tramite il parametro -a x , -a y o -a z (se non specificato, viene utilizzata la somma delle vibrazioni per tutti gli assi). Si noti che lo script graph_accelerometer.py supporta solo i file raw_data*.csv e non i file resonances*.csv o calibration_data*.csv. Per esempio, ~/klipper/scripts/graph_accelerometer.py /tmp/raw_data_x_*.csv -o /tmp/resonances_x.png -c -a z traccer\u00e0 il confronto di diversi file /tmp/raw_data_x_*.csv per l'asse Z con il file /tmp/resonances_x.png . Lo script shaper_calibrate.py accetta 1 o pi\u00f9 input e pu\u00f2 eseguire l'ottimizzazione automatica dello shaper di input e suggerire i parametri migliori che funzionano bene per tutti gli input forniti. Stampa i parametri suggeriti sulla console e pu\u00f2 inoltre generare il grafico se viene fornito il parametro -o output.png , o il file CSV se viene specificato il parametro -c output.csv . Fornire diversi input allo script shaper_calibrate.py pu\u00f2 essere utile se si esegue un'ottimizzazione avanzata degli shaper di input, ad esempio: Esecuzione di TEST_RESONANCES AXIS=X OUTPUT=raw_data (e asse Y ) per un singolo asse due volte su una stampante con piatto scorrevole con l'accelerometro collegato alla testa di stampa la prima volta e l'accelerometro collegato al piatto la seconda volta in modo da rilevare le risonanze incrociate degli assi e tentare di cancellarle con gli input shaper. Esecuzione di TEST_RESONANCES AXIS=Y OUTPUT=raw_data due volte su un supporto da piatto con un piatto di vetro e una superficie magnetica (che \u00e8 pi\u00f9 leggera) per trovare i parametri dello shaper di input che funzionano bene per qualsiasi configurazione della superficie di stampa. Combinazione dei dati di risonanza da pi\u00f9 punti di test. Combinando i dati di risonanza da 2 assi (ad es. su una stampante con piatto scorrevole per configurare input_shaper dell'asse X dalle risonanze degli assi X e Y per annullare le vibrazioni del piatto nel caso in cui l'ugello \"cattura\" una stampa quando si sposta nella direzione dell'asse X ).","title":"Elaborazione offline dei dati dell'accelerometro"},{"location":"Multi_MCU_Homing.html","text":"Homing e Probing con microcontrollore multiplo \u00b6 Klipper sopporta un meccanismo per homing con un fine corsa collegato a un micro controllore mentre i motori passo-passo sono collegati ad un controllore diverso. Questa modalit\u00e0 \u00e8 definita Homing multi-mcu. Questa funzione \u00e8 usata quando una sonda Z \u00e8 collegata ad un differente controllore rispetto ai motori dell'asse Z. Questa funzione pu\u00f2 essere utile per semplificare il cablaggio, poich\u00e9 potrebbe essere pi\u00f9 conveniente collegare un finecorsa o una sonda a un microcontrollore pi\u00f9 vicino. Tuttavia, l'utilizzo di questa funzione pu\u00f2 comportare un \"overshoot\" dei motori passo-passo durante le operazioni di homing o con sonda. L' 'overshoot' si verifica a causa di possibili ritardi nella trasmissione del messaggio tra il microcontrollore che controlla il finecorsa e i microcontrollori che muovono i motori passo-passo. Il codice Klipper \u00e8 progettato per limitare questo ritardo a non pi\u00f9 di 25 ms. (Quando \u00e8 attivato l'homing multi-mcu, i microcontrollori inviano messaggi di stato periodici e controllano che i messaggi di stato corrispondenti vengano ricevuti entro 25 ms.) Quindi, ad esempio, se si esegue l'homing a 10 mm/s, \u00e8 possibile un superamento fino a 0,250 mm (10 mm/s * .025s == 0,250 mm). \u00c8 necessario prestare attenzione durante la configurazione dell'homing multi-mcu per tenere conto di questo tipo di overshoot. L'uso di velocit\u00e0 di riferimento o di sonda pi\u00f9 lente pu\u00f2 ridurre la sovraelongazione (overshot). La sovraelongazione 'overshot' del motore passo-passo non dovrebbe influire negativamente sulla precisione della procedura di homing e di sonda. Il codice Klipper rilever\u00e0 il superamento e ne terr\u00e0 conto nei suoi calcoli. Tuttavia, \u00e8 importante che il design dell'hardware sia in grado di gestire l'overshoot senza causare danni alla macchina. Se Klipper dovesse rilevare un problema di comunicazione tra i microcontrollori durante l'homing multi-mcu, generer\u00e0 un errore \"Timeout di comunicazione durante l'homing\". Si noti che un asse con pi\u00f9 stepper (ad esempio, stepper_z e stepper_z1 ) deve trovarsi sullo stesso microcontrollore per poter utilizzare l'homing multi-mcu. Ad esempio, se un endstop si trova su un microcontrollore separato da stepper_z allora stepper_z1 deve trovarsi sullo stesso microcontrollore di stepper_z .","title":"Homing e Probing con microcontrollore multiplo"},{"location":"Multi_MCU_Homing.html#homing-e-probing-con-microcontrollore-multiplo","text":"Klipper sopporta un meccanismo per homing con un fine corsa collegato a un micro controllore mentre i motori passo-passo sono collegati ad un controllore diverso. Questa modalit\u00e0 \u00e8 definita Homing multi-mcu. Questa funzione \u00e8 usata quando una sonda Z \u00e8 collegata ad un differente controllore rispetto ai motori dell'asse Z. Questa funzione pu\u00f2 essere utile per semplificare il cablaggio, poich\u00e9 potrebbe essere pi\u00f9 conveniente collegare un finecorsa o una sonda a un microcontrollore pi\u00f9 vicino. Tuttavia, l'utilizzo di questa funzione pu\u00f2 comportare un \"overshoot\" dei motori passo-passo durante le operazioni di homing o con sonda. L' 'overshoot' si verifica a causa di possibili ritardi nella trasmissione del messaggio tra il microcontrollore che controlla il finecorsa e i microcontrollori che muovono i motori passo-passo. Il codice Klipper \u00e8 progettato per limitare questo ritardo a non pi\u00f9 di 25 ms. (Quando \u00e8 attivato l'homing multi-mcu, i microcontrollori inviano messaggi di stato periodici e controllano che i messaggi di stato corrispondenti vengano ricevuti entro 25 ms.) Quindi, ad esempio, se si esegue l'homing a 10 mm/s, \u00e8 possibile un superamento fino a 0,250 mm (10 mm/s * .025s == 0,250 mm). \u00c8 necessario prestare attenzione durante la configurazione dell'homing multi-mcu per tenere conto di questo tipo di overshoot. L'uso di velocit\u00e0 di riferimento o di sonda pi\u00f9 lente pu\u00f2 ridurre la sovraelongazione (overshot). La sovraelongazione 'overshot' del motore passo-passo non dovrebbe influire negativamente sulla precisione della procedura di homing e di sonda. Il codice Klipper rilever\u00e0 il superamento e ne terr\u00e0 conto nei suoi calcoli. Tuttavia, \u00e8 importante che il design dell'hardware sia in grado di gestire l'overshoot senza causare danni alla macchina. Se Klipper dovesse rilevare un problema di comunicazione tra i microcontrollori durante l'homing multi-mcu, generer\u00e0 un errore \"Timeout di comunicazione durante l'homing\". Si noti che un asse con pi\u00f9 stepper (ad esempio, stepper_z e stepper_z1 ) deve trovarsi sullo stesso microcontrollore per poter utilizzare l'homing multi-mcu. Ad esempio, se un endstop si trova su un microcontrollore separato da stepper_z allora stepper_z1 deve trovarsi sullo stesso microcontrollore di stepper_z .","title":"Homing e Probing con microcontrollore multiplo"},{"location":"Navigation.html","text":"Documentazione Klipper Installazione e configurazione Riferimenti di configurazione Livello del piatto Compensazione della risonanza Template dei comandi Documentazione per sviluppatori Documenti specifici del dispositivo","title":"Navigation"},{"location":"Overview.html","text":"Panoramica \u00b6 Benvenuto nella documentazione di Klipper. Se sei nuovo di Klipper, inizia con i documenti features e installation . Informazioni generali \u00b6 Caratteristiche : un elenco di funzionalit\u00e0 di alto livello in Klipper. FAQ : Domande frequenti. Releases : La storia delle versioni di Klipper. Modifiche alla configurazione : recenti modifiche al software che potrebbero richiedere agli utenti di aggiornare il file di configurazione della stampante. Contatto : Informazioni sulla segnalazione di bug e comunicazione generale con gli sviluppatori di Klipper. Installazione e configurazione \u00b6 Installazione : Guida all'installazione di Klipper. Riferimento di configurazione : Descrizione dei parametri di configurazione. Distanza di rotazione : Calcolo del parametro stepper rotation_distance. Controlli di configurazione : verifica le impostazioni di base dei pin nel file di configurazione. Livello del piatto : Informazioni sul \"livellamento del piatto\" in Klipper. Calibrazione Delta : Calibrazione della cinematica delta. Calibrazione sonda : Calibrazione di sonde Z automatiche. BL-Touch : Configurare una sonda Z \"BL-Touch\". Livello manuale : Calibrazione dei finecorsa Z (e simili). Maglia del letto : Correzione dell'altezza del piatto basata sulle posizioni XY. Endstop phase : Posizionamento finecorsa Z assistito da stepper. Compensazione della risonanza : Uno strumento per ridurre le risonanze nelle stampe. Misurare le risonanze : Informazioni sull'uso dell'hardware dell'accelerometro adxl345 per misurare le risonanze. Avanzamento pressione : Calibra la pressione dell'estrusore. Codici G : Informazioni sui comandi supportati da Klipper. Modelli di comando : Macro G-Code e valutazione condizionale. Riferimento stato : informazioni disponibili per le macro (e simili). Driver TMC : Uso dei driver Trinamic per motori passo-passo con Klipper. Multi-MCU Homing : Homing e probing utilizzando pi\u00f9 microcontrollori. Slicers : Configurare il software \"slicer\" per Klipper. Correzione dell'inclinazione : Regolazioni per assi non perfettamente squadrati. Strumenti PWM : Guida su come usare gli strumenti controllati da PWM come i laser o i mandrini. Exclude Object : La guida all'implementazione di Exclude Objects. Documentazione per sviluppatori \u00b6 Panoramica del codice : Gli sviluppatori dovrebbero leggere prima questo. Cinematica : Dettagli tecnici su come Klipper implementa il movimento. Protocollo : Informazioni sul protocollo di messaggistica di basso livello tra host e microcontrollore. Server API : Informazioni sulle API di comando e controllo di Klipper. Comandi MCU : Una descrizione dei comandi di basso livello implementati nel software del microcontrollore. Protocollo bus CAN : formato del messaggio Klipper CAN bus. Debug : Informazioni su come testare e fare il debug di Klipper. Benchmarks : Informazioni sul metodo di benchmark Klipper. Contribuire : Informazioni su come presentare miglioramenti a Klipper. Packaging : informazioni sulla creazione di pacchetti del sistema operativo. Documenti specifici del dispositivo \u00b6 Configurazioni di esempio : Informazioni su come aggiungere un file di configurazione di esempio a Klipper. Aggiornamenti SDCard : esegui il flashing di un microcontrollore copiando un file binario su una scheda SD nel microcontrollore. Raspberry Pi come microcontrollore : Dettagli per controllare i dispositivi collegati ai pin GPIO di un Raspberry Pi. Beaglebone : Dettagli per l'esecuzione di Klipper sulla PRU Beaglebone. Bootloaders : Informazioni per gli sviluppatori sul flashing del microcontrollore. CAN bus : Informazioni sull'uso del CAN bus con Klipper. Sensore larghezza filamento TSL1401CL Sensore di larghezza del filamento Hall","title":"Panoramica"},{"location":"Overview.html#panoramica","text":"Benvenuto nella documentazione di Klipper. Se sei nuovo di Klipper, inizia con i documenti features e installation .","title":"Panoramica"},{"location":"Overview.html#informazioni-generali","text":"Caratteristiche : un elenco di funzionalit\u00e0 di alto livello in Klipper. FAQ : Domande frequenti. Releases : La storia delle versioni di Klipper. Modifiche alla configurazione : recenti modifiche al software che potrebbero richiedere agli utenti di aggiornare il file di configurazione della stampante. Contatto : Informazioni sulla segnalazione di bug e comunicazione generale con gli sviluppatori di Klipper.","title":"Informazioni generali"},{"location":"Overview.html#installazione-e-configurazione","text":"Installazione : Guida all'installazione di Klipper. Riferimento di configurazione : Descrizione dei parametri di configurazione. Distanza di rotazione : Calcolo del parametro stepper rotation_distance. Controlli di configurazione : verifica le impostazioni di base dei pin nel file di configurazione. Livello del piatto : Informazioni sul \"livellamento del piatto\" in Klipper. Calibrazione Delta : Calibrazione della cinematica delta. Calibrazione sonda : Calibrazione di sonde Z automatiche. BL-Touch : Configurare una sonda Z \"BL-Touch\". Livello manuale : Calibrazione dei finecorsa Z (e simili). Maglia del letto : Correzione dell'altezza del piatto basata sulle posizioni XY. Endstop phase : Posizionamento finecorsa Z assistito da stepper. Compensazione della risonanza : Uno strumento per ridurre le risonanze nelle stampe. Misurare le risonanze : Informazioni sull'uso dell'hardware dell'accelerometro adxl345 per misurare le risonanze. Avanzamento pressione : Calibra la pressione dell'estrusore. Codici G : Informazioni sui comandi supportati da Klipper. Modelli di comando : Macro G-Code e valutazione condizionale. Riferimento stato : informazioni disponibili per le macro (e simili). Driver TMC : Uso dei driver Trinamic per motori passo-passo con Klipper. Multi-MCU Homing : Homing e probing utilizzando pi\u00f9 microcontrollori. Slicers : Configurare il software \"slicer\" per Klipper. Correzione dell'inclinazione : Regolazioni per assi non perfettamente squadrati. Strumenti PWM : Guida su come usare gli strumenti controllati da PWM come i laser o i mandrini. Exclude Object : La guida all'implementazione di Exclude Objects.","title":"Installazione e configurazione"},{"location":"Overview.html#documentazione-per-sviluppatori","text":"Panoramica del codice : Gli sviluppatori dovrebbero leggere prima questo. Cinematica : Dettagli tecnici su come Klipper implementa il movimento. Protocollo : Informazioni sul protocollo di messaggistica di basso livello tra host e microcontrollore. Server API : Informazioni sulle API di comando e controllo di Klipper. Comandi MCU : Una descrizione dei comandi di basso livello implementati nel software del microcontrollore. Protocollo bus CAN : formato del messaggio Klipper CAN bus. Debug : Informazioni su come testare e fare il debug di Klipper. Benchmarks : Informazioni sul metodo di benchmark Klipper. Contribuire : Informazioni su come presentare miglioramenti a Klipper. Packaging : informazioni sulla creazione di pacchetti del sistema operativo.","title":"Documentazione per sviluppatori"},{"location":"Overview.html#documenti-specifici-del-dispositivo","text":"Configurazioni di esempio : Informazioni su come aggiungere un file di configurazione di esempio a Klipper. Aggiornamenti SDCard : esegui il flashing di un microcontrollore copiando un file binario su una scheda SD nel microcontrollore. Raspberry Pi come microcontrollore : Dettagli per controllare i dispositivi collegati ai pin GPIO di un Raspberry Pi. Beaglebone : Dettagli per l'esecuzione di Klipper sulla PRU Beaglebone. Bootloaders : Informazioni per gli sviluppatori sul flashing del microcontrollore. CAN bus : Informazioni sull'uso del CAN bus con Klipper. Sensore larghezza filamento TSL1401CL Sensore di larghezza del filamento Hall","title":"Documenti specifici del dispositivo"},{"location":"Packaging.html","text":"Klipper packaging \u00b6 Klipper \u00e8 in qualche modo un'anomalia tra i programmi Python per quanto riguarda impacchettamento, in quanto non usa setuptools per costruire e installare. Alcune note riguardanti il modo migliore per impacchettarlo sono le seguenti: Moduli C \u00b6 Klipper utilizza un modulo C per gestire pi\u00f9 rapidamente alcuni calcoli cinematici. Questo modulo deve essere compilato al momento per evitare di introdurre una dipendenza di runtime da un compilatore. Per compilare il modulo C, esegui python2 klippy/chelper/__init__.py . Compilazione di codice python \u00b6 Molte distribuzioni hanno una politica di compilazione di tutto il codice Python prima del packaging per migliorare i tempi di avvio. Puoi farlo eseguendo python2 -m compileall klippy . Versione \u00b6 Se stai compilando un pacchetto di Klipper da git, \u00e8 normale non spedire una directory .git, quindi il controllo delle versioni deve essere gestito senza git. Per fare ci\u00f2, usa lo script fornito in scripts/make_version.py che dovrebbe essere eseguito come segue: python2 scripts/make_version.py YOURDISTRONAME > klippy/.version . Esempio di script di packaging \u00b6 klipper-git \u00e8 un pacchetto per Arch Linux e ha un PKGBUILD (script di compilazione del pacchetto) disponibile su Arch User Repositiory .","title":"Klipper packaging"},{"location":"Packaging.html#klipper-packaging","text":"Klipper \u00e8 in qualche modo un'anomalia tra i programmi Python per quanto riguarda impacchettamento, in quanto non usa setuptools per costruire e installare. Alcune note riguardanti il modo migliore per impacchettarlo sono le seguenti:","title":"Klipper packaging"},{"location":"Packaging.html#moduli-c","text":"Klipper utilizza un modulo C per gestire pi\u00f9 rapidamente alcuni calcoli cinematici. Questo modulo deve essere compilato al momento per evitare di introdurre una dipendenza di runtime da un compilatore. Per compilare il modulo C, esegui python2 klippy/chelper/__init__.py .","title":"Moduli C"},{"location":"Packaging.html#compilazione-di-codice-python","text":"Molte distribuzioni hanno una politica di compilazione di tutto il codice Python prima del packaging per migliorare i tempi di avvio. Puoi farlo eseguendo python2 -m compileall klippy .","title":"Compilazione di codice python"},{"location":"Packaging.html#versione","text":"Se stai compilando un pacchetto di Klipper da git, \u00e8 normale non spedire una directory .git, quindi il controllo delle versioni deve essere gestito senza git. Per fare ci\u00f2, usa lo script fornito in scripts/make_version.py che dovrebbe essere eseguito come segue: python2 scripts/make_version.py YOURDISTRONAME > klippy/.version .","title":"Versione"},{"location":"Packaging.html#esempio-di-script-di-packaging","text":"klipper-git \u00e8 un pacchetto per Arch Linux e ha un PKGBUILD (script di compilazione del pacchetto) disponibile su Arch User Repositiory .","title":"Esempio di script di packaging"},{"location":"Pressure_Advance.html","text":"Anticipo di pressione \u00b6 Questo documento fornisce informazioni sulla messa a punto della variabile di regolazione del \"pressure advance\" per un particolare ugello e filamento. La funzione di anticipo della pressione pu\u00f2 essere utile per ridurre le colature. Per maggiori informazioni su come viene implementato l'anticipo di pressione, vedere il documento kinematics . Regolazione della pressure advance \u00b6 Pressure advance fa due cose utili: riduce le colature durante i movimenti senza estrusione e riduce il blobbing durante le curve. Questa guida utilizza la seconda funzione (riduzione del blobbing durante le curve) come meccanismo per la messa a punto. Per calibrare la pressure advance, la stampante deve essere configurata e operativa poich\u00e9 il test di ottimizzazione prevede la stampa e l'ispezione di un oggetto di prova. \u00c8 una buona idea leggere questo documento per intero prima di eseguire il test. Usa uno slicer per generare il codice G per il grande cubo vuoto che si trova in docs/prints/square_tower.stl . Utilizzare una velocit\u00e0 elevata (ad es. 100 mm/s), riempimento zero e un'altezza dello strato grossolana (l'altezza dello strato dovrebbe essere circa il 75% del diametro dell'ugello). Assicurati che qualsiasi \"controllo dinamico dell'accelerazione\" sia disabilitato nello slicer. Prepararsi per il test emettendo il seguente comando G-Code: SET_VELOCITY_LIMIT SQUARE_CORNER_VELOCITY=1 ACCEL=500 Questo comando fa viaggiare l'ugello pi\u00f9 lentamente attraverso gli angoli per enfatizzare gli effetti della pressione dell'estrusore. Quindi per le stampanti con un estrusore a trasmissione diretta eseguire il comando: TUNING_TOWER COMMAND=SET_PRESSURE_ADVANCE PARAMETER=ADVANCE START=0 FACTOR=.005 Per estrusori bowden lunghi utilizzare: TUNING_TOWER COMMAND=SET_PRESSURE_ADVANCE PARAMETER=ADVANCE START=0 FACTOR=.020 Quindi stampare l'oggetto. Una volta stampata completamente, la stampa di prova avr\u00e0 il seguente aspetto: Il comando TUNING_TOWER sopra indica a Klipper di modificare l'impostazione pressure_advance su ogni strato della stampa. Gli strati pi\u00f9 alti nella stampa avranno un valore di anticipo della pressione maggiore impostato. Gli strati al di sotto dell'impostazione pressione_anticipo ideale avranno macchie agli angoli e gli strati al di sopra dell'impostazione ideale possono portare a angoli arrotondati e una scarsa estrusione all'angolo. \u00c8 possibile annullare la stampa in anticipo se si osserva che gli angoli non vengono pi\u00f9 stampati bene (e quindi si pu\u00f2 evitare di stampare livelli noti per essere al di sopra del valore di pressione_avanzamento ideale). Ispeziona la stampa e quindi utilizza un calibro digitale per trovare l'altezza con gli angoli della migliore qualit\u00e0. In caso di dubbio, preferire un'altezza inferiore. Il valore pressure_advance pu\u00f2 quindi essere calcolato come pressure_advance = <inizio> + <altezza_misurata> * <fattore> . (Ad esempio, 0 + 12.90 * .020 sarebbe .258 .) \u00c8 possibile scegliere impostazioni personalizzate per START e FACTOR se ci\u00f2 aiuta a identificare la migliore impostazione di anticipo della pressione. Quando si esegue questa operazione, assicurarsi di emettere il comando TUNING_TOWER all'inizio di ogni stampa di prova. I valori tipici di pressure advance sono compresi tra 0,050 e 1,000 (la fascia alta di solito solo con estrusori bowden). Se non vi \u00e8 alcun miglioramento significativo con un pressure advance fino a 1.000, \u00e8 improbabile che la pressure advance migliori la qualit\u00e0 delle stampe. Ritorno ad una configurazione di default con pressure advance disabilitato. Sebbene questo esercizio di messa a punto migliori direttamente la qualit\u00e0 degli angoli, vale la pena ricordare che una buona configurazione del pressure advance riduce anche gli ooze durante la stampa. Al termine di questo test, impostare pressure_advance = <calculated_value> nella sezione [extruder] del file di configurazione ed emettere un comando RESTART. Il comando RESTART canceller\u00e0 lo stato di test e riporter\u00e0 le velocit\u00e0 di accelerazione e in curva ai valori normali. Note importanti \u00b6 Il valore di pressure advance dipende dall'estrusore, dall'ugello e dal filamento. \u00c8 comune che filamenti di produttori diversi o con pigmenti diversi richiedano valori di pressure advance significativamente diversi. Pertanto, si dovrebbe calibrare pressure advance su ciascuna stampante e con ogni bobina di filamento. La temperatura di stampa e le velocit\u00e0 di estrusione possono influire sulla pressure advance. Assicurati di regolare extruder rotation_distance e nozzle temperature prima di regolare l'avanzamento della pressione. La stampa di prova \u00e8 progettata per funzionare con un'elevata portata dell'estrusore, ma per il resto con impostazioni dello slicer \"normali\". Un'elevata portata si ottiene utilizzando un'elevata velocit\u00e0 di stampa (ad es. 100 mm/s) e un'altezza dello strato grossolano (tipicamente circa il 75% del diametro dell'ugello). Altre impostazioni dello slicer dovrebbero essere simili alle loro impostazioni predefinite (ad esempio, perimetri di 2 o 3 linee, quantit\u00e0 di retrazione normale). Pu\u00f2 essere utile impostare la velocit\u00e0 del perimetro esterno in modo che sia la stessa velocit\u00e0 del resto della stampa, ma non \u00e8 un requisito. \u00c8 comune che la stampa di prova mostri un comportamento diverso su ciascun angolo. Spesso lo slicer provveder\u00e0 a cambiare i livelli in un angolo, il che pu\u00f2 comportare che quell'angolo sia significativamente diverso dai restanti tre angoli. Se ci\u00f2 si verifica, ignora quell'angolo e regola pressure advance utilizzando gli altri tre angoli. \u00c8 anche comune che gli angoli rimanenti varino leggermente. (Ci\u00f2 pu\u00f2 verificarsi a causa di piccole differenze nel modo in cui il telaio della stampante reagisce alle curve in determinate direzioni.) Prova a scegliere un valore che funzioni bene per tutti gli angoli rimanenti. In caso di dubbio, preferire un valore di pressure advance inferiore. Se viene utilizzato un valore di pressure advance (ad esempio, superiore a 0.200), \u00e8 possibile che l'estrusore salti quando torna alla normale accelerazione della stampante. Il sistema di pressure advance tiene conto della pressione spingendo il filamento extra durante l'accelerazione e ritraendo quel filamento durante la decelerazione. Con un'elevata accelerazione e un'elevata pressione di anticipo, l'estrusore potrebbe non avere una coppia sufficiente per spingere il filamento richiesto. In tal caso, utilizzare un valore di accelerazione inferiore o disattivare la pressure advance. Una volta che pressure advance \u00e8 stato regolato in Klipper, pu\u00f2 essere comunque utile configurare un piccolo valore di retrazione nello slicer (ad es. 0,75 mm) e utilizzare l'opzione \"pulizia in retrazione\" dello slicer, se disponibile. Queste impostazioni dello slicer possono aiutare a contrastare la trasudazione causata dalla coesione del filamento ( estratto dall'ugello a causa della viscosit\u00e0 della plastica). Si consiglia di disabilitare l'opzione \"Z-lift in retrazione\" dello slicer. Il sistema di pressure advance non modifica i tempi o il percorso della testa di stampa. Una stampa con pressure advance abilitato richieder\u00e0 lo stesso tempo di una stampa senza pressure advance. Inoltre, pressure advance non modifica la quantit\u00e0 totale di filamento estruso durante una stampa. L a pressure advance determina un movimento extra dell'estrusore durante l'accelerazione e la decelerazione del movimento. Un'impostazione di pressure advance molto elevata risulter\u00e0 in una quantit\u00e0 molto grande di movimento dell'estrusore durante l'accelerazione e la decelerazione e nessuna impostazione di configurazione pone un limite alla quantit\u00e0 di tale movimento.","title":"Anticipo di pressione"},{"location":"Pressure_Advance.html#anticipo-di-pressione","text":"Questo documento fornisce informazioni sulla messa a punto della variabile di regolazione del \"pressure advance\" per un particolare ugello e filamento. La funzione di anticipo della pressione pu\u00f2 essere utile per ridurre le colature. Per maggiori informazioni su come viene implementato l'anticipo di pressione, vedere il documento kinematics .","title":"Anticipo di pressione"},{"location":"Pressure_Advance.html#regolazione-della-pressure-advance","text":"Pressure advance fa due cose utili: riduce le colature durante i movimenti senza estrusione e riduce il blobbing durante le curve. Questa guida utilizza la seconda funzione (riduzione del blobbing durante le curve) come meccanismo per la messa a punto. Per calibrare la pressure advance, la stampante deve essere configurata e operativa poich\u00e9 il test di ottimizzazione prevede la stampa e l'ispezione di un oggetto di prova. \u00c8 una buona idea leggere questo documento per intero prima di eseguire il test. Usa uno slicer per generare il codice G per il grande cubo vuoto che si trova in docs/prints/square_tower.stl . Utilizzare una velocit\u00e0 elevata (ad es. 100 mm/s), riempimento zero e un'altezza dello strato grossolana (l'altezza dello strato dovrebbe essere circa il 75% del diametro dell'ugello). Assicurati che qualsiasi \"controllo dinamico dell'accelerazione\" sia disabilitato nello slicer. Prepararsi per il test emettendo il seguente comando G-Code: SET_VELOCITY_LIMIT SQUARE_CORNER_VELOCITY=1 ACCEL=500 Questo comando fa viaggiare l'ugello pi\u00f9 lentamente attraverso gli angoli per enfatizzare gli effetti della pressione dell'estrusore. Quindi per le stampanti con un estrusore a trasmissione diretta eseguire il comando: TUNING_TOWER COMMAND=SET_PRESSURE_ADVANCE PARAMETER=ADVANCE START=0 FACTOR=.005 Per estrusori bowden lunghi utilizzare: TUNING_TOWER COMMAND=SET_PRESSURE_ADVANCE PARAMETER=ADVANCE START=0 FACTOR=.020 Quindi stampare l'oggetto. Una volta stampata completamente, la stampa di prova avr\u00e0 il seguente aspetto: Il comando TUNING_TOWER sopra indica a Klipper di modificare l'impostazione pressure_advance su ogni strato della stampa. Gli strati pi\u00f9 alti nella stampa avranno un valore di anticipo della pressione maggiore impostato. Gli strati al di sotto dell'impostazione pressione_anticipo ideale avranno macchie agli angoli e gli strati al di sopra dell'impostazione ideale possono portare a angoli arrotondati e una scarsa estrusione all'angolo. \u00c8 possibile annullare la stampa in anticipo se si osserva che gli angoli non vengono pi\u00f9 stampati bene (e quindi si pu\u00f2 evitare di stampare livelli noti per essere al di sopra del valore di pressione_avanzamento ideale). Ispeziona la stampa e quindi utilizza un calibro digitale per trovare l'altezza con gli angoli della migliore qualit\u00e0. In caso di dubbio, preferire un'altezza inferiore. Il valore pressure_advance pu\u00f2 quindi essere calcolato come pressure_advance = <inizio> + <altezza_misurata> * <fattore> . (Ad esempio, 0 + 12.90 * .020 sarebbe .258 .) \u00c8 possibile scegliere impostazioni personalizzate per START e FACTOR se ci\u00f2 aiuta a identificare la migliore impostazione di anticipo della pressione. Quando si esegue questa operazione, assicurarsi di emettere il comando TUNING_TOWER all'inizio di ogni stampa di prova. I valori tipici di pressure advance sono compresi tra 0,050 e 1,000 (la fascia alta di solito solo con estrusori bowden). Se non vi \u00e8 alcun miglioramento significativo con un pressure advance fino a 1.000, \u00e8 improbabile che la pressure advance migliori la qualit\u00e0 delle stampe. Ritorno ad una configurazione di default con pressure advance disabilitato. Sebbene questo esercizio di messa a punto migliori direttamente la qualit\u00e0 degli angoli, vale la pena ricordare che una buona configurazione del pressure advance riduce anche gli ooze durante la stampa. Al termine di questo test, impostare pressure_advance = <calculated_value> nella sezione [extruder] del file di configurazione ed emettere un comando RESTART. Il comando RESTART canceller\u00e0 lo stato di test e riporter\u00e0 le velocit\u00e0 di accelerazione e in curva ai valori normali.","title":"Regolazione della pressure advance"},{"location":"Pressure_Advance.html#note-importanti","text":"Il valore di pressure advance dipende dall'estrusore, dall'ugello e dal filamento. \u00c8 comune che filamenti di produttori diversi o con pigmenti diversi richiedano valori di pressure advance significativamente diversi. Pertanto, si dovrebbe calibrare pressure advance su ciascuna stampante e con ogni bobina di filamento. La temperatura di stampa e le velocit\u00e0 di estrusione possono influire sulla pressure advance. Assicurati di regolare extruder rotation_distance e nozzle temperature prima di regolare l'avanzamento della pressione. La stampa di prova \u00e8 progettata per funzionare con un'elevata portata dell'estrusore, ma per il resto con impostazioni dello slicer \"normali\". Un'elevata portata si ottiene utilizzando un'elevata velocit\u00e0 di stampa (ad es. 100 mm/s) e un'altezza dello strato grossolano (tipicamente circa il 75% del diametro dell'ugello). Altre impostazioni dello slicer dovrebbero essere simili alle loro impostazioni predefinite (ad esempio, perimetri di 2 o 3 linee, quantit\u00e0 di retrazione normale). Pu\u00f2 essere utile impostare la velocit\u00e0 del perimetro esterno in modo che sia la stessa velocit\u00e0 del resto della stampa, ma non \u00e8 un requisito. \u00c8 comune che la stampa di prova mostri un comportamento diverso su ciascun angolo. Spesso lo slicer provveder\u00e0 a cambiare i livelli in un angolo, il che pu\u00f2 comportare che quell'angolo sia significativamente diverso dai restanti tre angoli. Se ci\u00f2 si verifica, ignora quell'angolo e regola pressure advance utilizzando gli altri tre angoli. \u00c8 anche comune che gli angoli rimanenti varino leggermente. (Ci\u00f2 pu\u00f2 verificarsi a causa di piccole differenze nel modo in cui il telaio della stampante reagisce alle curve in determinate direzioni.) Prova a scegliere un valore che funzioni bene per tutti gli angoli rimanenti. In caso di dubbio, preferire un valore di pressure advance inferiore. Se viene utilizzato un valore di pressure advance (ad esempio, superiore a 0.200), \u00e8 possibile che l'estrusore salti quando torna alla normale accelerazione della stampante. Il sistema di pressure advance tiene conto della pressione spingendo il filamento extra durante l'accelerazione e ritraendo quel filamento durante la decelerazione. Con un'elevata accelerazione e un'elevata pressione di anticipo, l'estrusore potrebbe non avere una coppia sufficiente per spingere il filamento richiesto. In tal caso, utilizzare un valore di accelerazione inferiore o disattivare la pressure advance. Una volta che pressure advance \u00e8 stato regolato in Klipper, pu\u00f2 essere comunque utile configurare un piccolo valore di retrazione nello slicer (ad es. 0,75 mm) e utilizzare l'opzione \"pulizia in retrazione\" dello slicer, se disponibile. Queste impostazioni dello slicer possono aiutare a contrastare la trasudazione causata dalla coesione del filamento ( estratto dall'ugello a causa della viscosit\u00e0 della plastica). Si consiglia di disabilitare l'opzione \"Z-lift in retrazione\" dello slicer. Il sistema di pressure advance non modifica i tempi o il percorso della testa di stampa. Una stampa con pressure advance abilitato richieder\u00e0 lo stesso tempo di una stampa senza pressure advance. Inoltre, pressure advance non modifica la quantit\u00e0 totale di filamento estruso durante una stampa. L a pressure advance determina un movimento extra dell'estrusore durante l'accelerazione e la decelerazione del movimento. Un'impostazione di pressure advance molto elevata risulter\u00e0 in una quantit\u00e0 molto grande di movimento dell'estrusore durante l'accelerazione e la decelerazione e nessuna impostazione di configurazione pone un limite alla quantit\u00e0 di tale movimento.","title":"Note importanti"},{"location":"Probe_Calibrate.html","text":"Calibrazione sonda \u00b6 Questo documento descrive il metodo per calibrare gli offset X, Y e Z di una \"sonda z automatica\" in Klipper. Questo \u00e8 utile per gli utenti che hanno una sezione [probe] o [bltouch] nel loro file di configurazione. Calibrazione degli offset X e Y della sonda \u00b6 Per calibrare l'offset X e Y, vai alla scheda \"Controllo\" di OctoPrint, avvia la stampante, quindi usa i pulsanti di spostamento di OctoPrint per spostare la testa in una posizione vicino al centro del piatto. Metti un pezzo di nastro adesivo blu (o simile) sul piatto sotto la sonda. Passare alla scheda \"Terminale\" di OctoPrint ed emettere un comando PROBE: PROBE Metti un segno sul nastro direttamente sotto il punto in cui si trova la sonda (o usa un metodo simile per annotare la posizione sul letto). Emettere un comando GET_POSITION e registrare la posizione XY della testa riportata da quel comando. Ad esempio se si vede: Recv: // toolhead: X:46.500000 Y:27.000000 Z:15.000000 E:0.000000 quindi si registrerebbe una posizione X della sonda di 46,5 e una posizione Y della sonda di 27. Dopo aver registrato la posizione della sonda, emettere una serie di comandi G1 fino a quando l'ugello si trova direttamente sopra il segno sul letto. Ad esempio, si potrebbe emettere: G1 F300 X57 Y30 Z15 per spostare l'ugello in una posizione X di 57 e Y di 30. Una volta trovata la posizione direttamente sopra il segno, utilizzare il comando GET_POSITION per segnalare quella posizione. Questa \u00e8 la posizione dell'ugello. L'offset_x \u00e8 quindi posizione_x_ugello - posizione_x_sonda e l'offset_y \u00e8 analogamente a posizione_y_ugello - posizione_y_sonda . Aggiorna il file printer.cfg con i valori indicati, rimuovi il nastro con i riferimento dal piatto, quindi esegui un comando RESTART in modo che i nuovi valori diventino effettivi. Calibrazione Z offset sonda \u00b6 Inserire una z_offset accurata per la sonda \u00e8 fondamentale per ottenere stampe di alta qualit\u00e0. Lo z_offset \u00e8 la distanza tra l'ugello e il letto quando la sonda si attiva. Lo strumento Klipper PROBE_CALIBRATE pu\u00f2 essere utilizzato per ottenere questo valore: eseguir\u00e0 una sonda automatica per misurare la posizione di trigger Z della sonda e quindi avvier\u00e0 una sonda manuale per ottenere l'altezza Z dell'ugello. La sonda z_offset verr\u00e0 quindi calcolata da queste misurazioni. Inizia spostando testa in una posizione vicino al centro del piatto. Passare alla scheda del terminale OctoPrint ed eseguire il comando PROBE_CALIBRATE per avviare lo strumento. Questo strumento eseguir\u00e0 una misura automatica con la sonda, quindi sollever\u00e0 la testina, sposter\u00e0 l'ugello sulla posizione del punto sonda e avvier\u00e0 lo strumento sonda manuale. Se l'ugello non si sposta in una posizione al di sopra del punto della sonda automatica, allora ANNULLA lo strumento sonda manuale ed eseguire la calibrazione dell'offset della sonda XY descritta sopra. Una volta avviata manualmente la sonda, seguire i passaggi descritti in \"the paper test\" per determinare la distanza effettiva tra l'ugello e il letto in una determinata posizione. Una volta completati questi passaggi, \u00e8 possibile ACCEPT la posizione e salvare i risultati nel file di configurazione con: SAVE_CONFIG Si noti che se viene apportata una modifica al sistema di movimento della stampante, alla posizione dell'hotend o alla posizione della sonda, i risultati di PROBE_CALIBRATE verranno invalidati. Se la sonda ha un offset X o Y e l'inclinazione del letto viene modificata (ad es. regolando le viti del letto, eseguendo DELTA_CALIBRATE, eseguendo Z_TILT_ADJUST, eseguendo QUAD_GANTRY_LEVEL o simili), i risultati di PROBE_CALIBRATE verranno invalidati. Dopo aver apportato una qualsiasi delle modifiche di cui sopra, sar\u00e0 necessario eseguire nuovamente PROBE_CALIBRATE. Se i risultati di PROBE_CALIBRATE vengono invalidati, anche tutti i risultati precedenti di bed mesh ottenuti utilizzando la sonda vengono invalidati: sar\u00e0 necessario eseguire nuovamente BED_MESH_CALIBRATE dopo aver ricalibrato la sonda. Verifica di ripetibilit\u00e0 \u00b6 Dopo aver calibrato gli offset X, Y e Z della sonda, \u00e8 una buona idea verificare che la sonda fornisca risultati ripetibili. Inizia portando a home la stampante e quindi sposta la testa in una posizione vicino al centro del letto. Passare al terminale di OctoPrint ed eseguire il comando PROBE_ACCURACY . Questo comando eseguir\u00e0 il test con la sonda dieci volte e produrr\u00e0 un output simile al seguente: Recv: // probe accuracy: at X:0.000 Y:0.000 Z:10.000 Recv: // and read 10 times with speed of 5 mm/s Recv: // probe at -0.003,0.005 is z=2.506948 Recv: // probe at -0.003,0.005 is z=2.519448 Recv: // probe at -0.003,0.005 is z=2.519448 Recv: // probe at -0.003,0.005 is z=2.506948 Recv: // probe at -0.003,0.005 is z=2.519448 Recv: // probe at -0.003,0.005 is z=2.519448 Recv: // probe at -0.003,0.005 is z=2.506948 Recv: // probe at -0.003,0.005 is z=2.506948 Recv: // probe at -0.003,0.005 is z=2.519448 Recv: // probe at -0.003,0.005 is z=2.506948 Recv: // probe accuracy results: maximum 2.519448, minimum 2.506948, range 0.012500, average 2.513198, median 2.513198, standard deviation 0.006250 Idealmente lo strumento riporter\u00e0 un valore massimo e minimo identico. (Ovvero, idealmente la sonda ottiene un risultato identico su tutte e dieci le prove.) Tuttavia, \u00e8 normale che i valori minimo e massimo differiscano di una \"distanza di passo\" Z o fino a 5 micron (0,005 mm). Una \"distanza passo\" \u00e8 rotation_distance/(full_steps_per_rotation*microsteps) . La distanza tra il valore minimo e quello massimo \u00e8 chiamata intervallo. Quindi, nell'esempio precedente, poich\u00e9 la stampante utilizza una distanza di passo Z di 0,0125, un intervallo di 0,012500 sarebbe considerato normale. Se i risultati del test mostrano un valore di intervallo maggiore di 25 micron (0,025 mm), la sonda non ha una precisione sufficiente per le procedure tipiche di livellamento del piatto. Potrebbe essere possibile regolare la velocit\u00e0 della sonda e/o l'altezza di inizio della sonda per migliorare la ripetibilit\u00e0 della sonda. Il comando PROBE_ACCURACY consente di eseguire test con parametri diversi per vederne l'impatto - vedere il documento G-Codes per ulteriori dettagli. Se la sonda generalmente ottiene risultati ripetibili ma presenta un valore anomalo occasionale, potrebbe essere possibile tenerne conto utilizzando pi\u00f9 campioni su ciascuna sonda - leggere la descrizione dei parametri di configurazione dei campioni della sonda in riferimento di configurazione per maggiori dettagli. Se sono necessarie una nuova velocit\u00e0 della sonda, diversa quantit\u00e0 di campioni o altre impostazioni, aggiornare il file printer.cfg ed eseguire un comando RESTART . In tal caso, \u00e8 una buona idea anche calibrare z_offset di nuovo. Se non \u00e8 possibile ottenere risultati ripetibili, non utilizzare la sonda per livellare il letto. Klipper ha diversi strumenti manuali che possono essere utilizzati in alternativa: vedere il Bed Level document per ulteriori dettagli. Verifica scostamenti di posizione \u00b6 Alcune sonde possono avere una distorsione sistematica che altera i risultati della sonda in determinate posizioni della testa. Ad esempio, se il supporto della sonda si inclina leggermente durante lo spostamento lungo l'asse Y, la sonda potrebbe riportare risultati distorti in differenti posizioni Y. Questo \u00e8 un problema comune con le sonde sulle stampanti delta, tuttavia pu\u00f2 verificarsi su tutte le stampanti. Si pu\u00f2 verificare una distorsione di posizione utilizzando il comando PROBE_CALIBRATE per misurare l'offset z della sonda in varie posizioni X e Y. Idealmente, il probe z_offset sarebbe un valore costante in ogni posizione della stampante. Per le stampanti delta, prova a misurare z_offset in una posizione vicino alla torre A, in una posizione vicino alla torre B e in una posizione vicino alla torre C. Per stampanti cartesiane, corexy e simili, prova a misurare z_offset in posizioni vicino ai quattro angoli del letto. Prima di iniziare questo test, calibrare prima gli offset della sonda X, Y e Z come descritto all'inizio di questo documento. Quindi porta a home la stampante e vai alla prima posizione XY. Seguire i passaggi in calibrazione dell'offset Z della sonda per eseguire il comando PROBE_CALIBRATE , i comandi TESTZ e il comando ACCETTA , ma non eseguire SAVE_CONFIG . Nota lo z_offset segnalato trovato. Quindi passare alle altre posizioni XY, ripetere questi passaggi PROBE_CALIBRATE e annotare lo z_offset riportato. Se la differenza tra l'offset z minimo riportato e l'offset z massimo riportato \u00e8 maggiore di 25 micron (0,025 mm), la sonda non \u00e8 adatta per le tipiche procedure di livellamento del letto. Consultare il Bed Level document per sonde alternative manuali. Scostamenti per temperatura \u00b6 Molte sonde hanno una distorsione sistemica quando misurano a temperature diverse. Ad esempio, la sonda pu\u00f2 attivarsi costantemente a un'altezza inferiore quando la sonda si trova a una temperatura pi\u00f9 elevata. Si consiglia di eseguire le procedure di livellamento del piatto a una temperatura costante per tenere conto di questa distorsione. Ad esempio, usare sempre la sonda quando la stampante \u00e8 a temperatura ambiente oppure eseguire sempre la procedura dopo che la stampante ha raggiunto una temperatura costante. In entrambi i casi, \u00e8 una buona idea attendere diversi minuti dopo che \u00e8 stata raggiunta la temperatura desiderata, in modo che tutto apparato stampante sia alla temperatura desiderata costantemente. Per verificare la presenza di un errore per temperatura, iniziare con la stampante a temperatura ambiente e poi portare a home la stampante, spostare la testina in una posizione vicino al centro del letto ed eseguire il comando PROBE_ACCURACY . Nota i risultati. Quindi, senza eseguire l'homing o disabilitare i motori passo-passo, riscaldare l'ugello della stampante e il piatto alla temperatura di stampa ed eseguire nuovamente il comando PROBE_ACCURACY . Idealmente, il comando riporter\u00e0 risultati identici. Come sopra, se la sonda ha un errore causato dalla temperatura, fare attenzione a usare sempre la sonda a una temperatura costante stabile.","title":"Calibrazione sonda"},{"location":"Probe_Calibrate.html#calibrazione-sonda","text":"Questo documento descrive il metodo per calibrare gli offset X, Y e Z di una \"sonda z automatica\" in Klipper. Questo \u00e8 utile per gli utenti che hanno una sezione [probe] o [bltouch] nel loro file di configurazione.","title":"Calibrazione sonda"},{"location":"Probe_Calibrate.html#calibrazione-degli-offset-x-e-y-della-sonda","text":"Per calibrare l'offset X e Y, vai alla scheda \"Controllo\" di OctoPrint, avvia la stampante, quindi usa i pulsanti di spostamento di OctoPrint per spostare la testa in una posizione vicino al centro del piatto. Metti un pezzo di nastro adesivo blu (o simile) sul piatto sotto la sonda. Passare alla scheda \"Terminale\" di OctoPrint ed emettere un comando PROBE: PROBE Metti un segno sul nastro direttamente sotto il punto in cui si trova la sonda (o usa un metodo simile per annotare la posizione sul letto). Emettere un comando GET_POSITION e registrare la posizione XY della testa riportata da quel comando. Ad esempio se si vede: Recv: // toolhead: X:46.500000 Y:27.000000 Z:15.000000 E:0.000000 quindi si registrerebbe una posizione X della sonda di 46,5 e una posizione Y della sonda di 27. Dopo aver registrato la posizione della sonda, emettere una serie di comandi G1 fino a quando l'ugello si trova direttamente sopra il segno sul letto. Ad esempio, si potrebbe emettere: G1 F300 X57 Y30 Z15 per spostare l'ugello in una posizione X di 57 e Y di 30. Una volta trovata la posizione direttamente sopra il segno, utilizzare il comando GET_POSITION per segnalare quella posizione. Questa \u00e8 la posizione dell'ugello. L'offset_x \u00e8 quindi posizione_x_ugello - posizione_x_sonda e l'offset_y \u00e8 analogamente a posizione_y_ugello - posizione_y_sonda . Aggiorna il file printer.cfg con i valori indicati, rimuovi il nastro con i riferimento dal piatto, quindi esegui un comando RESTART in modo che i nuovi valori diventino effettivi.","title":"Calibrazione degli offset X e Y della sonda"},{"location":"Probe_Calibrate.html#calibrazione-z-offset-sonda","text":"Inserire una z_offset accurata per la sonda \u00e8 fondamentale per ottenere stampe di alta qualit\u00e0. Lo z_offset \u00e8 la distanza tra l'ugello e il letto quando la sonda si attiva. Lo strumento Klipper PROBE_CALIBRATE pu\u00f2 essere utilizzato per ottenere questo valore: eseguir\u00e0 una sonda automatica per misurare la posizione di trigger Z della sonda e quindi avvier\u00e0 una sonda manuale per ottenere l'altezza Z dell'ugello. La sonda z_offset verr\u00e0 quindi calcolata da queste misurazioni. Inizia spostando testa in una posizione vicino al centro del piatto. Passare alla scheda del terminale OctoPrint ed eseguire il comando PROBE_CALIBRATE per avviare lo strumento. Questo strumento eseguir\u00e0 una misura automatica con la sonda, quindi sollever\u00e0 la testina, sposter\u00e0 l'ugello sulla posizione del punto sonda e avvier\u00e0 lo strumento sonda manuale. Se l'ugello non si sposta in una posizione al di sopra del punto della sonda automatica, allora ANNULLA lo strumento sonda manuale ed eseguire la calibrazione dell'offset della sonda XY descritta sopra. Una volta avviata manualmente la sonda, seguire i passaggi descritti in \"the paper test\" per determinare la distanza effettiva tra l'ugello e il letto in una determinata posizione. Una volta completati questi passaggi, \u00e8 possibile ACCEPT la posizione e salvare i risultati nel file di configurazione con: SAVE_CONFIG Si noti che se viene apportata una modifica al sistema di movimento della stampante, alla posizione dell'hotend o alla posizione della sonda, i risultati di PROBE_CALIBRATE verranno invalidati. Se la sonda ha un offset X o Y e l'inclinazione del letto viene modificata (ad es. regolando le viti del letto, eseguendo DELTA_CALIBRATE, eseguendo Z_TILT_ADJUST, eseguendo QUAD_GANTRY_LEVEL o simili), i risultati di PROBE_CALIBRATE verranno invalidati. Dopo aver apportato una qualsiasi delle modifiche di cui sopra, sar\u00e0 necessario eseguire nuovamente PROBE_CALIBRATE. Se i risultati di PROBE_CALIBRATE vengono invalidati, anche tutti i risultati precedenti di bed mesh ottenuti utilizzando la sonda vengono invalidati: sar\u00e0 necessario eseguire nuovamente BED_MESH_CALIBRATE dopo aver ricalibrato la sonda.","title":"Calibrazione Z offset sonda"},{"location":"Probe_Calibrate.html#verifica-di-ripetibilita","text":"Dopo aver calibrato gli offset X, Y e Z della sonda, \u00e8 una buona idea verificare che la sonda fornisca risultati ripetibili. Inizia portando a home la stampante e quindi sposta la testa in una posizione vicino al centro del letto. Passare al terminale di OctoPrint ed eseguire il comando PROBE_ACCURACY . Questo comando eseguir\u00e0 il test con la sonda dieci volte e produrr\u00e0 un output simile al seguente: Recv: // probe accuracy: at X:0.000 Y:0.000 Z:10.000 Recv: // and read 10 times with speed of 5 mm/s Recv: // probe at -0.003,0.005 is z=2.506948 Recv: // probe at -0.003,0.005 is z=2.519448 Recv: // probe at -0.003,0.005 is z=2.519448 Recv: // probe at -0.003,0.005 is z=2.506948 Recv: // probe at -0.003,0.005 is z=2.519448 Recv: // probe at -0.003,0.005 is z=2.519448 Recv: // probe at -0.003,0.005 is z=2.506948 Recv: // probe at -0.003,0.005 is z=2.506948 Recv: // probe at -0.003,0.005 is z=2.519448 Recv: // probe at -0.003,0.005 is z=2.506948 Recv: // probe accuracy results: maximum 2.519448, minimum 2.506948, range 0.012500, average 2.513198, median 2.513198, standard deviation 0.006250 Idealmente lo strumento riporter\u00e0 un valore massimo e minimo identico. (Ovvero, idealmente la sonda ottiene un risultato identico su tutte e dieci le prove.) Tuttavia, \u00e8 normale che i valori minimo e massimo differiscano di una \"distanza di passo\" Z o fino a 5 micron (0,005 mm). Una \"distanza passo\" \u00e8 rotation_distance/(full_steps_per_rotation*microsteps) . La distanza tra il valore minimo e quello massimo \u00e8 chiamata intervallo. Quindi, nell'esempio precedente, poich\u00e9 la stampante utilizza una distanza di passo Z di 0,0125, un intervallo di 0,012500 sarebbe considerato normale. Se i risultati del test mostrano un valore di intervallo maggiore di 25 micron (0,025 mm), la sonda non ha una precisione sufficiente per le procedure tipiche di livellamento del piatto. Potrebbe essere possibile regolare la velocit\u00e0 della sonda e/o l'altezza di inizio della sonda per migliorare la ripetibilit\u00e0 della sonda. Il comando PROBE_ACCURACY consente di eseguire test con parametri diversi per vederne l'impatto - vedere il documento G-Codes per ulteriori dettagli. Se la sonda generalmente ottiene risultati ripetibili ma presenta un valore anomalo occasionale, potrebbe essere possibile tenerne conto utilizzando pi\u00f9 campioni su ciascuna sonda - leggere la descrizione dei parametri di configurazione dei campioni della sonda in riferimento di configurazione per maggiori dettagli. Se sono necessarie una nuova velocit\u00e0 della sonda, diversa quantit\u00e0 di campioni o altre impostazioni, aggiornare il file printer.cfg ed eseguire un comando RESTART . In tal caso, \u00e8 una buona idea anche calibrare z_offset di nuovo. Se non \u00e8 possibile ottenere risultati ripetibili, non utilizzare la sonda per livellare il letto. Klipper ha diversi strumenti manuali che possono essere utilizzati in alternativa: vedere il Bed Level document per ulteriori dettagli.","title":"Verifica di ripetibilit\u00e0"},{"location":"Probe_Calibrate.html#verifica-scostamenti-di-posizione","text":"Alcune sonde possono avere una distorsione sistematica che altera i risultati della sonda in determinate posizioni della testa. Ad esempio, se il supporto della sonda si inclina leggermente durante lo spostamento lungo l'asse Y, la sonda potrebbe riportare risultati distorti in differenti posizioni Y. Questo \u00e8 un problema comune con le sonde sulle stampanti delta, tuttavia pu\u00f2 verificarsi su tutte le stampanti. Si pu\u00f2 verificare una distorsione di posizione utilizzando il comando PROBE_CALIBRATE per misurare l'offset z della sonda in varie posizioni X e Y. Idealmente, il probe z_offset sarebbe un valore costante in ogni posizione della stampante. Per le stampanti delta, prova a misurare z_offset in una posizione vicino alla torre A, in una posizione vicino alla torre B e in una posizione vicino alla torre C. Per stampanti cartesiane, corexy e simili, prova a misurare z_offset in posizioni vicino ai quattro angoli del letto. Prima di iniziare questo test, calibrare prima gli offset della sonda X, Y e Z come descritto all'inizio di questo documento. Quindi porta a home la stampante e vai alla prima posizione XY. Seguire i passaggi in calibrazione dell'offset Z della sonda per eseguire il comando PROBE_CALIBRATE , i comandi TESTZ e il comando ACCETTA , ma non eseguire SAVE_CONFIG . Nota lo z_offset segnalato trovato. Quindi passare alle altre posizioni XY, ripetere questi passaggi PROBE_CALIBRATE e annotare lo z_offset riportato. Se la differenza tra l'offset z minimo riportato e l'offset z massimo riportato \u00e8 maggiore di 25 micron (0,025 mm), la sonda non \u00e8 adatta per le tipiche procedure di livellamento del letto. Consultare il Bed Level document per sonde alternative manuali.","title":"Verifica scostamenti di posizione"},{"location":"Probe_Calibrate.html#scostamenti-per-temperatura","text":"Molte sonde hanno una distorsione sistemica quando misurano a temperature diverse. Ad esempio, la sonda pu\u00f2 attivarsi costantemente a un'altezza inferiore quando la sonda si trova a una temperatura pi\u00f9 elevata. Si consiglia di eseguire le procedure di livellamento del piatto a una temperatura costante per tenere conto di questa distorsione. Ad esempio, usare sempre la sonda quando la stampante \u00e8 a temperatura ambiente oppure eseguire sempre la procedura dopo che la stampante ha raggiunto una temperatura costante. In entrambi i casi, \u00e8 una buona idea attendere diversi minuti dopo che \u00e8 stata raggiunta la temperatura desiderata, in modo che tutto apparato stampante sia alla temperatura desiderata costantemente. Per verificare la presenza di un errore per temperatura, iniziare con la stampante a temperatura ambiente e poi portare a home la stampante, spostare la testina in una posizione vicino al centro del letto ed eseguire il comando PROBE_ACCURACY . Nota i risultati. Quindi, senza eseguire l'homing o disabilitare i motori passo-passo, riscaldare l'ugello della stampante e il piatto alla temperatura di stampa ed eseguire nuovamente il comando PROBE_ACCURACY . Idealmente, il comando riporter\u00e0 risultati identici. Come sopra, se la sonda ha un errore causato dalla temperatura, fare attenzione a usare sempre la sonda a una temperatura costante stabile.","title":"Scostamenti per temperatura"},{"location":"Protocol.html","text":"Protocollo \u00b6 Il protocollo di messaggistica Klipper viene utilizzato per la comunicazione di basso livello tra il software host Klipper e il software microcontrollore Klipper. Ad alto livello il protocollo pu\u00f2 essere pensato come una serie di stringhe di comando e risposta che vengono compresse, trasmesse e quindi elaborate sul lato ricevente. Una serie di esempio di comandi in formato non compresso leggibile dall'uomo potrebbe essere simile a: set_digital_out pin=PA3 value=1 set_digital_out pin=PA7 value=1 schedule_digital_out oid=8 clock=4000000 value=0 queue_step oid=7 interval=7458 count=10 add=331 queue_step oid=7 interval=11717 count=4 add=1281 Vedere il documento mcu commands per informazioni sui comandi disponibili. Vedere il documento debugging per informazioni su come tradurre un file G-Code nei corrispondenti comandi del microcontrollore leggibili dall'uomo. Questa pagina fornisce una descrizione di alto livello del protocollo di messaggistica Klipper. Descrive come i messaggi sono dichiarati, codificati in formato binario (lo schema di \"compressione\") e trasmessi. L'obiettivo del protocollo \u00e8 abilitare un canale di comunicazione privo di errori tra l'host e il microcontrollore che sia a bassa latenza, bassa larghezza di banda e bassa complessit\u00e0 per il microcontrollore. Interfaccia microcontrollore \u00b6 Il protocollo di trasmissione Klipper pu\u00f2 essere pensato come un meccanismo RPC tra microcontrollore e host. Il software del microcontrollore dichiara i comandi che l'host pu\u00f2 richiamare insieme ai messaggi di risposta che pu\u00f2 generare. L'host utilizza tali informazioni per comandare al microcontrollore di eseguire azioni e interpretare i risultati. Dichiarazione dei comandi \u00b6 Il software del microcontrollore dichiara un \"comando\" utilizzando la macro DECL_COMMAND() nel codice C. Per esempio: DECL_COMMAND(command_update_digital_out, \"update_digital_out oid=%c value=%c\"); Quanto sopra dichiara un comando denominato \"update_digital_out\". Ci\u00f2 consente all'host di \"richiamare\" questo comando che causerebbe l'esecuzione della funzione C command_update_digital_out() nel microcontrollore. Quanto sopra indica anche che il comando accetta due parametri interi. Quando viene eseguito il codice C command_update_digital_out(), verr\u00e0 passata una matrice contenente questi due numeri interi: il primo corrispondente all'\"oid\" e il secondo corrispondente al \"valore\". In generale, i parametri sono descritti con la sintassi di stile printf() (ad esempio, \"%u\"). La formattazione corrisponde direttamente alla visualizzazione leggibile dei comandi (ad es. \"update_digital_out oid=7 value=1\"). Nell'esempio precedente, \"value=\" \u00e8 un nome di parametro e \"%c\" indica che il parametro \u00e8 un numero intero. Internamente, il nome del parametro viene utilizzato solo come documentazione. In questo esempio, \"%c\" viene utilizzato anche come documentazione per indicare che l'intero previsto ha una dimensione di 1 byte (la dimensione intera dichiarata non influisce sull'analisi o sulla codifica). La build del microcontrollore raccoglier\u00e0 tutti i comandi dichiarati con DECL_COMMAND(), ne determiner\u00e0 i parametri e far\u00e0 in modo che siano richiamabili. Declaring responses \u00b6 Per inviare informazioni dal microcontrollore all'host viene generata una \"risposta\". Questi sono sia dichiarati che trasmessi usando la macro C sendf(). Per esempio: sendf(\"status clock=%u status=%c\", sched_read_time(), sched_is_shutdown()); Quanto sopra trasmette un messaggio di risposta di \"stato\" che contiene due parametri interi (\"clock\" e \"status\"). La build del microcontrollore trova automaticamente tutte le chiamate sendf() e genera codificatori per esse. Il primo parametro della funzione sendf() descrive la risposta ed \u00e8 nello stesso formato delle dichiarazioni di comando. L'host pu\u00f2 organizzare la registrazione di una funzione di richiamata per ogni risposta. Quindi, in effetti, i comandi consentono all'host di invocare le funzioni C nel microcontrollore e le risposte consentono al software del microcontrollore di richiamare il codice nell'host. La macro sendf() deve essere invocata solo da gestori di comandi o attivit\u00e0 e non deve essere invocata da interrupt o timer. Il codice non ha bisogno di emettere un sendf() in risposta a un comando ricevuto, non \u00e8 limitato nel numero di volte in cui sendf() pu\u00f2 essere invocato e pu\u00f2 invocare sendf() in qualsiasi momento da un task handler. Risposte in output \u00b6 Per semplificare il debug, esiste anche una funzione C output(). Per esempio: output(\"Il valore di%u \u00e8 %s con dimensione %u.\", x, buf, buf_len); La funzione output() \u00e8 simile nell'uso a printf() - \u00e8 intesa per generare e formattare messaggi arbitrari per il 'consumo umano'. Dichiarazione di enumerazioni \u00b6 Le enumerazioni consentono al codice host di utilizzare identificatori di stringa per i parametri che il microcontrollore gestisce come numeri interi. Sono dichiarati nel codice del microcontrollore, ad esempio: DECL_ENUMERATION(\"spi_bus\", \"spi\", 0); DECL_ENUMERATION_RANGE(\"pin\", \"PC0\", 16, 8); Se il primo esempio, la macro DECL_ENUMERATION() definisce un'enumerazione per qualsiasi messaggio di comando/risposta con nome parametro \"spi_bus\" o nome parametro con suffisso \"_spi_bus\". Per quei parametri la stringa \"spi\" \u00e8 un valore valido e verr\u00e0 trasmessa con un valore intero pari a zero. \u00c8 anche possibile dichiarare un intervallo di enumerazione. Nel secondo esempio, un parametro \"pin\" (o qualsiasi parametro con suffisso \"_pin\") accetterebbe PC0, PC1, PC2, ..., PC7 come valori validi. Le stringhe verranno trasmesse con numeri interi 16, 17, 18, ..., 23. Dichiarazione di costanti \u00b6 Le costanti possono anche essere esportate. Ad esempio, quanto segue: DECL_CONSTANT(\"SERIAL_BAUD\", 250000); esporterebbe una costante denominata \"SERIAL_BAUD\" con un valore di 250000 dal microcontrollore all'host. \u00c8 anche possibile dichiarare una costante che \u00e8 una stringa, ad esempio: DECL_CONSTANT_STR(\"MCU\", \"pru\"); Codifica dei messaggi di basso livello \u00b6 Per realizzare il meccanismo RPC di cui sopra, ogni comando e risposta viene codificato in un formato binario per la trasmissione. Questa sezione descrive il sistema di trasmissione. Blocchi di messaggi \u00b6 Tutti i dati inviati dall'host al microcontrollore e viceversa sono contenuti in \"blocchi di messaggi\". Un blocco di messaggi ha un'intestazione di due byte e un trailer di tre byte. Il formato di un blocco di messaggi \u00e8: <1 byte lunghezza><1 byte sequenza><n-byte contenuto><2 byte crc><1 byte sync> Il byte di lunghezza contiene il numero di byte nel blocco di messaggi inclusi i byte di intestazione e trailer (quindi la lunghezza minima del messaggio \u00e8 5 byte). La lunghezza massima del blocco di messaggi \u00e8 attualmente di 64 byte. Il byte di sequenza contiene un numero di sequenza di 4 bit nei bit di ordine inferiore e i bit di ordine superiore contengono sempre 0x10 (i bit di ordine superiore sono riservati per un uso futuro). I byte di contenuto contengono dati arbitrari e il relativo formato \u00e8 descritto nella sezione seguente. I byte crc contengono un CCITT CRC a 16 bit del blocco di messaggi inclusi i byte di intestazione ma esclusi i byte di trailer. Il byte di sincronizzazione \u00e8 0x7e. Il formato del blocco di messaggi si ispira ai telegrammi HDLC . Come in HDLC, il blocco di messaggi pu\u00f2 contenere facoltativamente un carattere di sincronizzazione aggiuntivo all'inizio del blocco. A differenza di HDLC, un carattere di sincronizzazione non \u00e8 esclusivo del framing e pu\u00f2 essere presente nel contenuto del blocco di messaggi. Contenuto del blocco messaggi \u00b6 Ogni blocco di messaggi inviato dall'host al microcontrollore contiene una serie di zero o pi\u00f9 comandi di messaggi. Ogni comando inizia con un Quantit\u00e0 a lunghezza variabile (VLQ) command-id seguito da zero o pi\u00f9 parametri VLQ per il comando dato. Ad esempio, i seguenti quattro comandi possono essere inseriti in un unico blocco di messaggi: update_digital_out oid=6 value=1 update_digital_out oid=5 value=0 get_config get_clock e codificato nei seguenti otto interi VLQ: <id_update_digital_out><6><1><id_update_digital_out><5><0><id_get_config><id_get_clock> Per codificare e analizzare il contenuto del messaggio, sia l'host che il microcontrollore devono concordare gli ID comando e il numero di parametri di ciascun comando. Quindi, nell'esempio sopra, sia l'host che il microcontrollore saprebbero che \"id_update_digital_out\" \u00e8 sempre seguito da due parametri e \"id_get_config\" e \"id_get_clock\" hanno zero parametri. L'host e il microcontrollore condividono un \"dizionario dei dati\" che mappa le descrizioni dei comandi (ad esempio, \"update_digital_out oid=%c value=%c\") ai loro ID di comando interi. Durante l'elaborazione dei dati, il parser sapr\u00e0 di aspettarsi un numero specifico di parametri codificati VLQ a seguito di un determinato ID comando. Il contenuto del messaggio per i blocchi inviati dal microcontrollore all'host segue lo stesso formato. Gli identificatori in questi messaggi sono \"ID di risposta\", ma servono allo stesso scopo e seguono le stesse regole di codifica. In pratica, i blocchi di messaggi inviati dal microcontrollore all'host non contengono mai pi\u00f9 di una risposta nel contenuto del blocco di messaggi. Quantit\u00e0 di lunghezza variabile \u00b6 Consulta l' articolo di Wikipedia per ulteriori informazioni sul formato generale degli interi codificati VLQ. Klipper utilizza uno schema di codifica che supporta numeri interi positivi e negativi. Gli interi prossimi allo zero utilizzano meno byte per codificare e gli interi positivi in genere codificano utilizzando meno byte degli interi negativi. La tabella seguente mostra il numero di byte che ogni intero impiega per codificare: Intero Dimensione codificata -32 .. 95 1 -4096 .. 12287 2 -524288 .. 1572863 3 -67108864 .. 201326591 4 -2147483648 .. 4294967295 5 Stringhe di lunghezza variabile \u00b6 Come eccezione alle regole di codifica precedenti, se un parametro di un comando o di una risposta \u00e8 una stringa dinamica, il parametro non viene codificato come un semplice intero VLQ. Invece viene codificato trasmettendo la lunghezza come intero codificato VLQ seguito dal contenuto stesso: <VLQ encoded length><n-byte contents> Le descrizioni dei comandi che si trovano nel dizionario dei dati consentono sia all'host che al microcontrollore di sapere quali parametri del comando utilizzano la semplice codifica VLQ e quali parametri utilizzano la codifica delle stringhe. Dizionario dati \u00b6 Affinch\u00e9 vengano stabilite comunicazioni significative tra microcontrollore e host, entrambe le parti devono concordare un \"dizionario dei dati\". Questo dizionario di dati contiene gli identificatori interi per comandi e risposte insieme alle relative descrizioni. La build del microcontrollore utilizza il contenuto delle macro DECL_COMMAND() e sendf() per generare il dizionario dei dati. La build assegna automaticamente identificatori univoci a ciascun comando e risposta. Questo sistema consente sia all'host che al codice del microcontrollore di utilizzare senza problemi nomi descrittivi leggibili dall'uomo pur utilizzando una larghezza di banda minima. L'host interroga il dizionario dei dati quando si connette per la prima volta al microcontrollore. Una volta che l'host ha scaricato il dizionario dei dati dal microcontrollore, utilizza quel dizionario dei dati per codificare tutti i comandi e per analizzare tutte le risposte dal microcontrollore. L'host deve quindi gestire un dizionario di dati dinamico. Tuttavia, per mantenere semplice il software del microcontrollore, il microcontrollore utilizza sempre il suo dizionario dati statico (compilato). Il dizionario dei dati viene interrogato inviando i comandi \"identify\" al microcontrollore. Il microcontrollore risponder\u00e0 a ogni comando di identificazione con un messaggio \"identify_response\". Poich\u00e9 questi due comandi sono necessari prima di ottenere il dizionario dei dati, i loro ID interi e tipi di parametri sono codificati sia nel microcontrollore che nell'host. L'ID della risposta \"identify_response\" \u00e8 0, l'ID del comando \"identify\" \u00e8 1. Oltre ad avere ID hardcoded, il comando di identificazione e la relativa risposta vengono dichiarati e trasmessi allo stesso modo degli altri comandi e risposte. Nessun altro comando o risposta \u00e8 hardcoded. Il formato del dizionario dei dati trasmessi stesso \u00e8 una stringa JSON compressa zlib. Il processo di compilazione del microcontrollore genera la stringa, la comprime e la memorizza nella sezione di testo del flash del microcontrollore. Il dizionario dei dati pu\u00f2 essere molto pi\u00f9 grande della dimensione massima del blocco del messaggio: l'host lo scarica inviando pi\u00f9 comandi di identificazione che richiedono blocchi progressivi del dizionario dei dati. Una volta ottenuti tutti i blocchi, l'host assembler\u00e0 i blocchi, decomprimer\u00e0 i dati e analizzer\u00e0 il contenuto. Oltre alle informazioni sul protocollo di comunicazione, il dizionario dei dati contiene anche la versione del software, le enumerazioni (come definite da DECL_ENUMERATION) e le costanti (come definite da DECL_CONSTANT). Flusso di messaggi \u00b6 I comandi dei messaggi inviati dall'host al microcontrollore sono concepiti per essere privi di errori. Il microcontrollore controller\u00e0 il CRC e i numeri di sequenza in ciascun blocco di messaggi per garantire che i comandi siano accurati e in ordine. Il microcontrollore elabora sempre i blocchi di messaggi in ordine - se riceve un blocco fuori ordine, lo scarter\u00e0 e tutti gli altri blocchi fuori ordine fino a quando non riceve blocchi con la sequenza corretta. Il codice host di basso livello implementa un sistema di ritrasmissione automatica per i blocchi di messaggi persi e corrotti inviati al microcontrollore. Per facilitare ci\u00f2, il microcontrollore trasmette un \"ack message block\" dopo ogni blocco di messaggio ricevuto con successo. L'host pianifica un timeout dopo l'invio di ogni blocco e lo ritrasmetter\u00e0 se il timeout scade senza ricevere un corrispondente \"ack\". Inoltre, se il microcontrollore rileva un blocco corrotto o fuori servizio, pu\u00f2 trasmettere un \"nak message block\" per facilitare una rapida ritrasmissione. Un \"ack\" \u00e8 un blocco di messaggi con contenuto vuoto (cio\u00e8 un blocco di messaggi di 5 byte) e un numero di sequenza maggiore dell'ultimo numero di sequenza dell'host ricevuto. Un \"nak\" \u00e8 un blocco di messaggi con contenuto vuoto e un numero di sequenza inferiore all'ultimo numero di sequenza host ricevuto. Il protocollo facilita un sistema di trasmissione \"finestra\" in modo che l'host possa avere molti blocchi di messaggi in sospeso in viaggio alla volta. (Questo \u00e8 in aggiunta ai molti comandi che possono essere presenti in un determinato blocco di messaggi.) Ci\u00f2 consente il massimo utilizzo della larghezza di banda anche in caso di latenza di trasmissione. Il meccanismo di timeout, ritrasmissione, windowing e ack si ispira a meccanismi simili in TCP . Nell'altra direzione, i blocchi di messaggi inviati dal microcontrollore all'host sono progettati per essere privi di errori, ma non hanno una trasmissione sicura. (Le risposte non dovrebbero essere danneggiate, ma potrebbero scomparire.) Questo viene fatto per mantenere semplice l'implementazione nel microcontrollore. Non esiste un sistema di ritrasmissione automatica delle risposte: ci si aspetta che il codice di alto livello sia in grado di gestire una risposta mancante occasionale (di solito richiedendo nuovamente il contenuto o impostando un programma ricorrente di trasmissione della risposta). Il campo del numero di sequenza nei blocchi di messaggi inviati all'host \u00e8 sempre uno maggiore dell'ultimo numero di sequenza di blocchi di messaggi ricevuti dall'host. Non viene utilizzato per tenere traccia di sequenze di blocchi di messaggi di risposta.","title":"Protocollo"},{"location":"Protocol.html#protocollo","text":"Il protocollo di messaggistica Klipper viene utilizzato per la comunicazione di basso livello tra il software host Klipper e il software microcontrollore Klipper. Ad alto livello il protocollo pu\u00f2 essere pensato come una serie di stringhe di comando e risposta che vengono compresse, trasmesse e quindi elaborate sul lato ricevente. Una serie di esempio di comandi in formato non compresso leggibile dall'uomo potrebbe essere simile a: set_digital_out pin=PA3 value=1 set_digital_out pin=PA7 value=1 schedule_digital_out oid=8 clock=4000000 value=0 queue_step oid=7 interval=7458 count=10 add=331 queue_step oid=7 interval=11717 count=4 add=1281 Vedere il documento mcu commands per informazioni sui comandi disponibili. Vedere il documento debugging per informazioni su come tradurre un file G-Code nei corrispondenti comandi del microcontrollore leggibili dall'uomo. Questa pagina fornisce una descrizione di alto livello del protocollo di messaggistica Klipper. Descrive come i messaggi sono dichiarati, codificati in formato binario (lo schema di \"compressione\") e trasmessi. L'obiettivo del protocollo \u00e8 abilitare un canale di comunicazione privo di errori tra l'host e il microcontrollore che sia a bassa latenza, bassa larghezza di banda e bassa complessit\u00e0 per il microcontrollore.","title":"Protocollo"},{"location":"Protocol.html#interfaccia-microcontrollore","text":"Il protocollo di trasmissione Klipper pu\u00f2 essere pensato come un meccanismo RPC tra microcontrollore e host. Il software del microcontrollore dichiara i comandi che l'host pu\u00f2 richiamare insieme ai messaggi di risposta che pu\u00f2 generare. L'host utilizza tali informazioni per comandare al microcontrollore di eseguire azioni e interpretare i risultati.","title":"Interfaccia microcontrollore"},{"location":"Protocol.html#dichiarazione-dei-comandi","text":"Il software del microcontrollore dichiara un \"comando\" utilizzando la macro DECL_COMMAND() nel codice C. Per esempio: DECL_COMMAND(command_update_digital_out, \"update_digital_out oid=%c value=%c\"); Quanto sopra dichiara un comando denominato \"update_digital_out\". Ci\u00f2 consente all'host di \"richiamare\" questo comando che causerebbe l'esecuzione della funzione C command_update_digital_out() nel microcontrollore. Quanto sopra indica anche che il comando accetta due parametri interi. Quando viene eseguito il codice C command_update_digital_out(), verr\u00e0 passata una matrice contenente questi due numeri interi: il primo corrispondente all'\"oid\" e il secondo corrispondente al \"valore\". In generale, i parametri sono descritti con la sintassi di stile printf() (ad esempio, \"%u\"). La formattazione corrisponde direttamente alla visualizzazione leggibile dei comandi (ad es. \"update_digital_out oid=7 value=1\"). Nell'esempio precedente, \"value=\" \u00e8 un nome di parametro e \"%c\" indica che il parametro \u00e8 un numero intero. Internamente, il nome del parametro viene utilizzato solo come documentazione. In questo esempio, \"%c\" viene utilizzato anche come documentazione per indicare che l'intero previsto ha una dimensione di 1 byte (la dimensione intera dichiarata non influisce sull'analisi o sulla codifica). La build del microcontrollore raccoglier\u00e0 tutti i comandi dichiarati con DECL_COMMAND(), ne determiner\u00e0 i parametri e far\u00e0 in modo che siano richiamabili.","title":"Dichiarazione dei comandi"},{"location":"Protocol.html#declaring-responses","text":"Per inviare informazioni dal microcontrollore all'host viene generata una \"risposta\". Questi sono sia dichiarati che trasmessi usando la macro C sendf(). Per esempio: sendf(\"status clock=%u status=%c\", sched_read_time(), sched_is_shutdown()); Quanto sopra trasmette un messaggio di risposta di \"stato\" che contiene due parametri interi (\"clock\" e \"status\"). La build del microcontrollore trova automaticamente tutte le chiamate sendf() e genera codificatori per esse. Il primo parametro della funzione sendf() descrive la risposta ed \u00e8 nello stesso formato delle dichiarazioni di comando. L'host pu\u00f2 organizzare la registrazione di una funzione di richiamata per ogni risposta. Quindi, in effetti, i comandi consentono all'host di invocare le funzioni C nel microcontrollore e le risposte consentono al software del microcontrollore di richiamare il codice nell'host. La macro sendf() deve essere invocata solo da gestori di comandi o attivit\u00e0 e non deve essere invocata da interrupt o timer. Il codice non ha bisogno di emettere un sendf() in risposta a un comando ricevuto, non \u00e8 limitato nel numero di volte in cui sendf() pu\u00f2 essere invocato e pu\u00f2 invocare sendf() in qualsiasi momento da un task handler.","title":"Declaring responses"},{"location":"Protocol.html#risposte-in-output","text":"Per semplificare il debug, esiste anche una funzione C output(). Per esempio: output(\"Il valore di%u \u00e8 %s con dimensione %u.\", x, buf, buf_len); La funzione output() \u00e8 simile nell'uso a printf() - \u00e8 intesa per generare e formattare messaggi arbitrari per il 'consumo umano'.","title":"Risposte in output"},{"location":"Protocol.html#dichiarazione-di-enumerazioni","text":"Le enumerazioni consentono al codice host di utilizzare identificatori di stringa per i parametri che il microcontrollore gestisce come numeri interi. Sono dichiarati nel codice del microcontrollore, ad esempio: DECL_ENUMERATION(\"spi_bus\", \"spi\", 0); DECL_ENUMERATION_RANGE(\"pin\", \"PC0\", 16, 8); Se il primo esempio, la macro DECL_ENUMERATION() definisce un'enumerazione per qualsiasi messaggio di comando/risposta con nome parametro \"spi_bus\" o nome parametro con suffisso \"_spi_bus\". Per quei parametri la stringa \"spi\" \u00e8 un valore valido e verr\u00e0 trasmessa con un valore intero pari a zero. \u00c8 anche possibile dichiarare un intervallo di enumerazione. Nel secondo esempio, un parametro \"pin\" (o qualsiasi parametro con suffisso \"_pin\") accetterebbe PC0, PC1, PC2, ..., PC7 come valori validi. Le stringhe verranno trasmesse con numeri interi 16, 17, 18, ..., 23.","title":"Dichiarazione di enumerazioni"},{"location":"Protocol.html#dichiarazione-di-costanti","text":"Le costanti possono anche essere esportate. Ad esempio, quanto segue: DECL_CONSTANT(\"SERIAL_BAUD\", 250000); esporterebbe una costante denominata \"SERIAL_BAUD\" con un valore di 250000 dal microcontrollore all'host. \u00c8 anche possibile dichiarare una costante che \u00e8 una stringa, ad esempio: DECL_CONSTANT_STR(\"MCU\", \"pru\");","title":"Dichiarazione di costanti"},{"location":"Protocol.html#codifica-dei-messaggi-di-basso-livello","text":"Per realizzare il meccanismo RPC di cui sopra, ogni comando e risposta viene codificato in un formato binario per la trasmissione. Questa sezione descrive il sistema di trasmissione.","title":"Codifica dei messaggi di basso livello"},{"location":"Protocol.html#blocchi-di-messaggi","text":"Tutti i dati inviati dall'host al microcontrollore e viceversa sono contenuti in \"blocchi di messaggi\". Un blocco di messaggi ha un'intestazione di due byte e un trailer di tre byte. Il formato di un blocco di messaggi \u00e8: <1 byte lunghezza><1 byte sequenza><n-byte contenuto><2 byte crc><1 byte sync> Il byte di lunghezza contiene il numero di byte nel blocco di messaggi inclusi i byte di intestazione e trailer (quindi la lunghezza minima del messaggio \u00e8 5 byte). La lunghezza massima del blocco di messaggi \u00e8 attualmente di 64 byte. Il byte di sequenza contiene un numero di sequenza di 4 bit nei bit di ordine inferiore e i bit di ordine superiore contengono sempre 0x10 (i bit di ordine superiore sono riservati per un uso futuro). I byte di contenuto contengono dati arbitrari e il relativo formato \u00e8 descritto nella sezione seguente. I byte crc contengono un CCITT CRC a 16 bit del blocco di messaggi inclusi i byte di intestazione ma esclusi i byte di trailer. Il byte di sincronizzazione \u00e8 0x7e. Il formato del blocco di messaggi si ispira ai telegrammi HDLC . Come in HDLC, il blocco di messaggi pu\u00f2 contenere facoltativamente un carattere di sincronizzazione aggiuntivo all'inizio del blocco. A differenza di HDLC, un carattere di sincronizzazione non \u00e8 esclusivo del framing e pu\u00f2 essere presente nel contenuto del blocco di messaggi.","title":"Blocchi di messaggi"},{"location":"Protocol.html#contenuto-del-blocco-messaggi","text":"Ogni blocco di messaggi inviato dall'host al microcontrollore contiene una serie di zero o pi\u00f9 comandi di messaggi. Ogni comando inizia con un Quantit\u00e0 a lunghezza variabile (VLQ) command-id seguito da zero o pi\u00f9 parametri VLQ per il comando dato. Ad esempio, i seguenti quattro comandi possono essere inseriti in un unico blocco di messaggi: update_digital_out oid=6 value=1 update_digital_out oid=5 value=0 get_config get_clock e codificato nei seguenti otto interi VLQ: <id_update_digital_out><6><1><id_update_digital_out><5><0><id_get_config><id_get_clock> Per codificare e analizzare il contenuto del messaggio, sia l'host che il microcontrollore devono concordare gli ID comando e il numero di parametri di ciascun comando. Quindi, nell'esempio sopra, sia l'host che il microcontrollore saprebbero che \"id_update_digital_out\" \u00e8 sempre seguito da due parametri e \"id_get_config\" e \"id_get_clock\" hanno zero parametri. L'host e il microcontrollore condividono un \"dizionario dei dati\" che mappa le descrizioni dei comandi (ad esempio, \"update_digital_out oid=%c value=%c\") ai loro ID di comando interi. Durante l'elaborazione dei dati, il parser sapr\u00e0 di aspettarsi un numero specifico di parametri codificati VLQ a seguito di un determinato ID comando. Il contenuto del messaggio per i blocchi inviati dal microcontrollore all'host segue lo stesso formato. Gli identificatori in questi messaggi sono \"ID di risposta\", ma servono allo stesso scopo e seguono le stesse regole di codifica. In pratica, i blocchi di messaggi inviati dal microcontrollore all'host non contengono mai pi\u00f9 di una risposta nel contenuto del blocco di messaggi.","title":"Contenuto del blocco messaggi"},{"location":"Protocol.html#quantita-di-lunghezza-variabile","text":"Consulta l' articolo di Wikipedia per ulteriori informazioni sul formato generale degli interi codificati VLQ. Klipper utilizza uno schema di codifica che supporta numeri interi positivi e negativi. Gli interi prossimi allo zero utilizzano meno byte per codificare e gli interi positivi in genere codificano utilizzando meno byte degli interi negativi. La tabella seguente mostra il numero di byte che ogni intero impiega per codificare: Intero Dimensione codificata -32 .. 95 1 -4096 .. 12287 2 -524288 .. 1572863 3 -67108864 .. 201326591 4 -2147483648 .. 4294967295 5","title":"Quantit\u00e0 di lunghezza variabile"},{"location":"Protocol.html#stringhe-di-lunghezza-variabile","text":"Come eccezione alle regole di codifica precedenti, se un parametro di un comando o di una risposta \u00e8 una stringa dinamica, il parametro non viene codificato come un semplice intero VLQ. Invece viene codificato trasmettendo la lunghezza come intero codificato VLQ seguito dal contenuto stesso: <VLQ encoded length><n-byte contents> Le descrizioni dei comandi che si trovano nel dizionario dei dati consentono sia all'host che al microcontrollore di sapere quali parametri del comando utilizzano la semplice codifica VLQ e quali parametri utilizzano la codifica delle stringhe.","title":"Stringhe di lunghezza variabile"},{"location":"Protocol.html#dizionario-dati","text":"Affinch\u00e9 vengano stabilite comunicazioni significative tra microcontrollore e host, entrambe le parti devono concordare un \"dizionario dei dati\". Questo dizionario di dati contiene gli identificatori interi per comandi e risposte insieme alle relative descrizioni. La build del microcontrollore utilizza il contenuto delle macro DECL_COMMAND() e sendf() per generare il dizionario dei dati. La build assegna automaticamente identificatori univoci a ciascun comando e risposta. Questo sistema consente sia all'host che al codice del microcontrollore di utilizzare senza problemi nomi descrittivi leggibili dall'uomo pur utilizzando una larghezza di banda minima. L'host interroga il dizionario dei dati quando si connette per la prima volta al microcontrollore. Una volta che l'host ha scaricato il dizionario dei dati dal microcontrollore, utilizza quel dizionario dei dati per codificare tutti i comandi e per analizzare tutte le risposte dal microcontrollore. L'host deve quindi gestire un dizionario di dati dinamico. Tuttavia, per mantenere semplice il software del microcontrollore, il microcontrollore utilizza sempre il suo dizionario dati statico (compilato). Il dizionario dei dati viene interrogato inviando i comandi \"identify\" al microcontrollore. Il microcontrollore risponder\u00e0 a ogni comando di identificazione con un messaggio \"identify_response\". Poich\u00e9 questi due comandi sono necessari prima di ottenere il dizionario dei dati, i loro ID interi e tipi di parametri sono codificati sia nel microcontrollore che nell'host. L'ID della risposta \"identify_response\" \u00e8 0, l'ID del comando \"identify\" \u00e8 1. Oltre ad avere ID hardcoded, il comando di identificazione e la relativa risposta vengono dichiarati e trasmessi allo stesso modo degli altri comandi e risposte. Nessun altro comando o risposta \u00e8 hardcoded. Il formato del dizionario dei dati trasmessi stesso \u00e8 una stringa JSON compressa zlib. Il processo di compilazione del microcontrollore genera la stringa, la comprime e la memorizza nella sezione di testo del flash del microcontrollore. Il dizionario dei dati pu\u00f2 essere molto pi\u00f9 grande della dimensione massima del blocco del messaggio: l'host lo scarica inviando pi\u00f9 comandi di identificazione che richiedono blocchi progressivi del dizionario dei dati. Una volta ottenuti tutti i blocchi, l'host assembler\u00e0 i blocchi, decomprimer\u00e0 i dati e analizzer\u00e0 il contenuto. Oltre alle informazioni sul protocollo di comunicazione, il dizionario dei dati contiene anche la versione del software, le enumerazioni (come definite da DECL_ENUMERATION) e le costanti (come definite da DECL_CONSTANT).","title":"Dizionario dati"},{"location":"Protocol.html#flusso-di-messaggi","text":"I comandi dei messaggi inviati dall'host al microcontrollore sono concepiti per essere privi di errori. Il microcontrollore controller\u00e0 il CRC e i numeri di sequenza in ciascun blocco di messaggi per garantire che i comandi siano accurati e in ordine. Il microcontrollore elabora sempre i blocchi di messaggi in ordine - se riceve un blocco fuori ordine, lo scarter\u00e0 e tutti gli altri blocchi fuori ordine fino a quando non riceve blocchi con la sequenza corretta. Il codice host di basso livello implementa un sistema di ritrasmissione automatica per i blocchi di messaggi persi e corrotti inviati al microcontrollore. Per facilitare ci\u00f2, il microcontrollore trasmette un \"ack message block\" dopo ogni blocco di messaggio ricevuto con successo. L'host pianifica un timeout dopo l'invio di ogni blocco e lo ritrasmetter\u00e0 se il timeout scade senza ricevere un corrispondente \"ack\". Inoltre, se il microcontrollore rileva un blocco corrotto o fuori servizio, pu\u00f2 trasmettere un \"nak message block\" per facilitare una rapida ritrasmissione. Un \"ack\" \u00e8 un blocco di messaggi con contenuto vuoto (cio\u00e8 un blocco di messaggi di 5 byte) e un numero di sequenza maggiore dell'ultimo numero di sequenza dell'host ricevuto. Un \"nak\" \u00e8 un blocco di messaggi con contenuto vuoto e un numero di sequenza inferiore all'ultimo numero di sequenza host ricevuto. Il protocollo facilita un sistema di trasmissione \"finestra\" in modo che l'host possa avere molti blocchi di messaggi in sospeso in viaggio alla volta. (Questo \u00e8 in aggiunta ai molti comandi che possono essere presenti in un determinato blocco di messaggi.) Ci\u00f2 consente il massimo utilizzo della larghezza di banda anche in caso di latenza di trasmissione. Il meccanismo di timeout, ritrasmissione, windowing e ack si ispira a meccanismi simili in TCP . Nell'altra direzione, i blocchi di messaggi inviati dal microcontrollore all'host sono progettati per essere privi di errori, ma non hanno una trasmissione sicura. (Le risposte non dovrebbero essere danneggiate, ma potrebbero scomparire.) Questo viene fatto per mantenere semplice l'implementazione nel microcontrollore. Non esiste un sistema di ritrasmissione automatica delle risposte: ci si aspetta che il codice di alto livello sia in grado di gestire una risposta mancante occasionale (di solito richiedendo nuovamente il contenuto o impostando un programma ricorrente di trasmissione della risposta). Il campo del numero di sequenza nei blocchi di messaggi inviati all'host \u00e8 sempre uno maggiore dell'ultimo numero di sequenza di blocchi di messaggi ricevuti dall'host. Non viene utilizzato per tenere traccia di sequenze di blocchi di messaggi di risposta.","title":"Flusso di messaggi"},{"location":"RPi_microcontroller.html","text":"Microcontrollore RPi \u00b6 Questo documento descrive il processo di esecuzione di Klipper su un RPi e usa lo stesso RPi come mcu secondario. Perch\u00e9 usare RPi come MCU secondario? \u00b6 Spesso gli MCU dedicati al controllo delle stampanti 3D hanno un numero limitato e preconfigurato di pin esposti per gestire le principali funzioni di stampa (resistenze termiche, estrusori, stepper...). L'utilizzo dell'RPi dove Klipper \u00e8 installato come MCU secondario d\u00e0 la possibilit\u00e0 di utilizzare direttamente i GPIO e i bus (i2c, spi) dell'RPi all'interno di klipper senza utilizzare plugin Octoprint (se utilizzati) o programmi esterni dando la possibilit\u00e0 di controllare tutto all'interno del GCODE di stampa. Attenzione : Se la tua piattaforma \u00e8 un Beaglebone e hai seguito correttamente i passi di installazione, la mcu linux \u00e8 gi\u00e0 installata e configurata per il tuo sistema. Installa lo script rc \u00b6 Se si desidera utilizzare l'host come MCU secondario, il processo di klipper_mcu deve essere eseguito prima del processo klippy. Dopo aver installato Klipper, installare lo script. eseguire: cd ~/klipper/ sudo cp ./scripts/klipper-mcu.service /etc/systemd/system/ sudo systemctl enable klipper-mcu.service Creazione del codice del microcontrollore \u00b6 Per compilare il codice del microcontrollore Klipper, iniziate configurandolo per il \"processo Linux\": cd ~/klipper/ make menuconfig Nel menu, impostate \"Microcontroller Architecture\" su \"Linux process\", poi salvate e uscite. Per compilare e installare il nuovo codice del microcontrollore, eseguire: sudo service klipper stop make flash sudo service klipper start Se klippy.log segnala un errore \"Autorizzazione negata\" quando si tenta di connettersi a /tmp/klipper_host_mcu , \u00e8 necessario aggiungere l'utente al gruppo tty. Il seguente comando aggiunger\u00e0 l'utente \"pi\" al gruppo tty: sudo usermod -a -G tty pi Configurazione rimanente \u00b6 Completare l'installazione configurando l'MCU secondario di Klipper seguendo le istruzioni in RaspberryPi sample config e Multi MCU sample config . Facoltativo: abilitazione di SPI \u00b6 Assicurati che il driver SPI di Linux sia abilitato eseguendo sudo raspi-config e abilitando SPI nel menu \"Opzioni di interfaccia\". Opzionale: abilitazione di I2C \u00b6 Assicurati che l'interfaccia Linux I2C sia abilitato eseguendo sudo raspi-config e abilitando I2C nel menu \"Opzioni di interfaccia\". Se si intende utilizzare I2C per l'accelerometro MPU, \u00e8 anche necessario impostare il baud rate su 400000: aggiungendo/deselezionando dtparam=i2c_arm=on,i2c_arm_baudrate=400000 in /boot/config.txt (o / boot/firmware/config.txt in alcune distribuzioni). Opzionale: Identificare il gpiochip corretto \u00b6 Su Raspberry Pi e su molti cloni i pin esposti sul GPIO appartengono al primo gpiochip. Possono quindi essere utilizzati su klipper semplicemente riferendoli con il nome gpio0..n . Tuttavia, ci sono casi in cui i pin esposti appartengono a gpiochip diversi dal primo. Ad esempio nel caso di alcuni modelli OrangePi o se viene utilizzato un Port Expander. In questi casi \u00e8 utile utilizzare i comandi per accedere al dispositivo a caratteri GPIO Linux per verificarne la configurazione. Per installare il Linux GPIO character device - binary su una distro basata su debian come octopi eseguire: sudo apt-get install gpiod Per controllare i gpiochip disponibili eseguire: gpiodetect Per verificare il numero di pin e la disponibilit\u00e0 dei pin: gpioinfo Il pin scelto pu\u00f2 quindi essere utilizzato all'interno della configurazione come gpiochip<n>/gpio<o> dove n \u00e8 il numero del chip visto dal comando gpiodetect e o \u00e8 il numero di riga visto dal comando gpioinfo . Attenzione: solo i gpio contrassegnati come inutilizzati possono essere utilizzati. Non \u00e8 possibile che una linea sia usata da pi\u00f9 processi contemporaneamente. Per esempio su un RPi 3B+ dove klipper usa il GPIO20 per un interruttore: $ gpiodetect gpiochip0 [pinctrl-bcm2835] (54 lines) gpiochip1 [raspberrypi-exp-gpio] (8 lines) $ gpioinfo gpiochip0 - 54 lines: line 0: unnamed unused input active-high line 1: unnamed unused input active-high line 2: unnamed unused input active-high line 3: unnamed unused input active-high line 4: unnamed unused input active-high line 5: unnamed unused input active-high line 6: unnamed unused input active-high line 7: unnamed unused input active-high line 8: unnamed unused input active-high line 9: unnamed unused input active-high line 10: unnamed unused input active-high line 11: unnamed unused input active-high line 12: unnamed unused input active-high line 13: unnamed unused input active-high line 14: unnamed unused input active-high line 15: unnamed unused input active-high line 16: unnamed unused input active-high line 17: unnamed unused input active-high line 18: unnamed unused input active-high line 19: unnamed unused input active-high line 20: unnamed \"klipper\" output active-high [used] line 21: unnamed unused input active-high line 22: unnamed unused input active-high line 23: unnamed unused input active-high line 24: unnamed unused input active-high line 25: unnamed unused input active-high line 26: unnamed unused input active-high line 27: unnamed unused input active-high line 28: unnamed unused input active-high line 29: unnamed \"led0\" output active-high [used] line 30: unnamed unused input active-high line 31: unnamed unused input active-high line 32: unnamed unused input active-high line 33: unnamed unused input active-high line 34: unnamed unused input active-high line 35: unnamed unused input active-high line 36: unnamed unused input active-high line 37: unnamed unused input active-high line 38: unnamed unused input active-high line 39: unnamed unused input active-high line 40: unnamed unused input active-high line 41: unnamed unused input active-high line 42: unnamed unused input active-high line 43: unnamed unused input active-high line 44: unnamed unused input active-high line 45: unnamed unused input active-high line 46: unnamed unused input active-high line 47: unnamed unused input active-high line 48: unnamed unused input active-high line 49: unnamed unused input active-high line 50: unnamed unused input active-high line 51: unnamed unused input active-high line 52: unnamed unused input active-high line 53: unnamed unused input active-high gpiochip1 - 8 lines: line 0: unnamed unused input active-high line 1: unnamed unused input active-high line 2: unnamed \"led1\" output active-low [used] line 3: unnamed unused input active-high line 4: unnamed unused input active-high line 5: unnamed unused input active-high line 6: unnamed unused input active-high line 7: unnamed unused input active-high Opzionale: Hardware PWM \u00b6 I Raspberry Pi hanno due canali PWM (PWM0 e PWM1) che sono esposti sull'intestazione o, in caso contrario, possono essere instradati ai pin gpio esistenti. Il demone mcu Linux utilizza l'interfaccia sysfs pwmchip per controllare i dispositivi hardware pwm sugli host Linux. L'interfaccia sysfs pwm non \u00e8 esposta per impostazione predefinita su un Raspberry e pu\u00f2 essere attivata aggiungendo una riga a /boot/config.txt : # Abilita l'interfaccia sysfs di pwmchip dtoverlay=pwm,pin=12,func=4 Questo esempio abilita solo PWM0 e lo indirizza a gpio12. Se entrambi i canali PWM devono essere abilitati potete usare pwm-2chan . L'overlay non espone la riga pwm sui sysfs all'avvio e deve essere esportata facendo eco al numero del canale pwm in /sys/class/pwm/pwmchip0/export : echo 0 > /sys/class/pwm/pwmchip0/export Questo creer\u00e0 il dispositivo /sys/class/pwm/pwmchip0/pwm0 nel filesystem. Il modo pi\u00f9 semplice per farlo \u00e8 aggiungerlo a /etc/rc.local prima della riga exit 0 . Con il sysfs a posto, potete ora utilizzare il canale o i canali pwm aggiungendo il seguente pezzo di configurazione al vostro printer.cfg : [output_pin caselight] pin: host:pwmchip0/pwm0 pwm: True hardware_pwm: True cycle_time: 0.000001 Questo aggiunger\u00e0 il controllo pwm hardware a gpio12 sul Pi (perch\u00e9 l'overlay \u00e8 stato configurato per instradare pwm0 a pin = 12). PWM0 pu\u00f2 essere indirizzato su gpio12 e gpio18, PWM1 pu\u00f2 essere indirizzato su gpio13 e gpio19: PWM gpio PIN Func 0 12 4 0 18 2 1 13 4 1 19 2","title":"Microcontrollore RPi"},{"location":"RPi_microcontroller.html#microcontrollore-rpi","text":"Questo documento descrive il processo di esecuzione di Klipper su un RPi e usa lo stesso RPi come mcu secondario.","title":"Microcontrollore RPi"},{"location":"RPi_microcontroller.html#perche-usare-rpi-come-mcu-secondario","text":"Spesso gli MCU dedicati al controllo delle stampanti 3D hanno un numero limitato e preconfigurato di pin esposti per gestire le principali funzioni di stampa (resistenze termiche, estrusori, stepper...). L'utilizzo dell'RPi dove Klipper \u00e8 installato come MCU secondario d\u00e0 la possibilit\u00e0 di utilizzare direttamente i GPIO e i bus (i2c, spi) dell'RPi all'interno di klipper senza utilizzare plugin Octoprint (se utilizzati) o programmi esterni dando la possibilit\u00e0 di controllare tutto all'interno del GCODE di stampa. Attenzione : Se la tua piattaforma \u00e8 un Beaglebone e hai seguito correttamente i passi di installazione, la mcu linux \u00e8 gi\u00e0 installata e configurata per il tuo sistema.","title":"Perch\u00e9 usare RPi come MCU secondario?"},{"location":"RPi_microcontroller.html#installa-lo-script-rc","text":"Se si desidera utilizzare l'host come MCU secondario, il processo di klipper_mcu deve essere eseguito prima del processo klippy. Dopo aver installato Klipper, installare lo script. eseguire: cd ~/klipper/ sudo cp ./scripts/klipper-mcu.service /etc/systemd/system/ sudo systemctl enable klipper-mcu.service","title":"Installa lo script rc"},{"location":"RPi_microcontroller.html#creazione-del-codice-del-microcontrollore","text":"Per compilare il codice del microcontrollore Klipper, iniziate configurandolo per il \"processo Linux\": cd ~/klipper/ make menuconfig Nel menu, impostate \"Microcontroller Architecture\" su \"Linux process\", poi salvate e uscite. Per compilare e installare il nuovo codice del microcontrollore, eseguire: sudo service klipper stop make flash sudo service klipper start Se klippy.log segnala un errore \"Autorizzazione negata\" quando si tenta di connettersi a /tmp/klipper_host_mcu , \u00e8 necessario aggiungere l'utente al gruppo tty. Il seguente comando aggiunger\u00e0 l'utente \"pi\" al gruppo tty: sudo usermod -a -G tty pi","title":"Creazione del codice del microcontrollore"},{"location":"RPi_microcontroller.html#configurazione-rimanente","text":"Completare l'installazione configurando l'MCU secondario di Klipper seguendo le istruzioni in RaspberryPi sample config e Multi MCU sample config .","title":"Configurazione rimanente"},{"location":"RPi_microcontroller.html#facoltativo-abilitazione-di-spi","text":"Assicurati che il driver SPI di Linux sia abilitato eseguendo sudo raspi-config e abilitando SPI nel menu \"Opzioni di interfaccia\".","title":"Facoltativo: abilitazione di SPI"},{"location":"RPi_microcontroller.html#opzionale-abilitazione-di-i2c","text":"Assicurati che l'interfaccia Linux I2C sia abilitato eseguendo sudo raspi-config e abilitando I2C nel menu \"Opzioni di interfaccia\". Se si intende utilizzare I2C per l'accelerometro MPU, \u00e8 anche necessario impostare il baud rate su 400000: aggiungendo/deselezionando dtparam=i2c_arm=on,i2c_arm_baudrate=400000 in /boot/config.txt (o / boot/firmware/config.txt in alcune distribuzioni).","title":"Opzionale: abilitazione di I2C"},{"location":"RPi_microcontroller.html#opzionale-identificare-il-gpiochip-corretto","text":"Su Raspberry Pi e su molti cloni i pin esposti sul GPIO appartengono al primo gpiochip. Possono quindi essere utilizzati su klipper semplicemente riferendoli con il nome gpio0..n . Tuttavia, ci sono casi in cui i pin esposti appartengono a gpiochip diversi dal primo. Ad esempio nel caso di alcuni modelli OrangePi o se viene utilizzato un Port Expander. In questi casi \u00e8 utile utilizzare i comandi per accedere al dispositivo a caratteri GPIO Linux per verificarne la configurazione. Per installare il Linux GPIO character device - binary su una distro basata su debian come octopi eseguire: sudo apt-get install gpiod Per controllare i gpiochip disponibili eseguire: gpiodetect Per verificare il numero di pin e la disponibilit\u00e0 dei pin: gpioinfo Il pin scelto pu\u00f2 quindi essere utilizzato all'interno della configurazione come gpiochip<n>/gpio<o> dove n \u00e8 il numero del chip visto dal comando gpiodetect e o \u00e8 il numero di riga visto dal comando gpioinfo . Attenzione: solo i gpio contrassegnati come inutilizzati possono essere utilizzati. Non \u00e8 possibile che una linea sia usata da pi\u00f9 processi contemporaneamente. Per esempio su un RPi 3B+ dove klipper usa il GPIO20 per un interruttore: $ gpiodetect gpiochip0 [pinctrl-bcm2835] (54 lines) gpiochip1 [raspberrypi-exp-gpio] (8 lines) $ gpioinfo gpiochip0 - 54 lines: line 0: unnamed unused input active-high line 1: unnamed unused input active-high line 2: unnamed unused input active-high line 3: unnamed unused input active-high line 4: unnamed unused input active-high line 5: unnamed unused input active-high line 6: unnamed unused input active-high line 7: unnamed unused input active-high line 8: unnamed unused input active-high line 9: unnamed unused input active-high line 10: unnamed unused input active-high line 11: unnamed unused input active-high line 12: unnamed unused input active-high line 13: unnamed unused input active-high line 14: unnamed unused input active-high line 15: unnamed unused input active-high line 16: unnamed unused input active-high line 17: unnamed unused input active-high line 18: unnamed unused input active-high line 19: unnamed unused input active-high line 20: unnamed \"klipper\" output active-high [used] line 21: unnamed unused input active-high line 22: unnamed unused input active-high line 23: unnamed unused input active-high line 24: unnamed unused input active-high line 25: unnamed unused input active-high line 26: unnamed unused input active-high line 27: unnamed unused input active-high line 28: unnamed unused input active-high line 29: unnamed \"led0\" output active-high [used] line 30: unnamed unused input active-high line 31: unnamed unused input active-high line 32: unnamed unused input active-high line 33: unnamed unused input active-high line 34: unnamed unused input active-high line 35: unnamed unused input active-high line 36: unnamed unused input active-high line 37: unnamed unused input active-high line 38: unnamed unused input active-high line 39: unnamed unused input active-high line 40: unnamed unused input active-high line 41: unnamed unused input active-high line 42: unnamed unused input active-high line 43: unnamed unused input active-high line 44: unnamed unused input active-high line 45: unnamed unused input active-high line 46: unnamed unused input active-high line 47: unnamed unused input active-high line 48: unnamed unused input active-high line 49: unnamed unused input active-high line 50: unnamed unused input active-high line 51: unnamed unused input active-high line 52: unnamed unused input active-high line 53: unnamed unused input active-high gpiochip1 - 8 lines: line 0: unnamed unused input active-high line 1: unnamed unused input active-high line 2: unnamed \"led1\" output active-low [used] line 3: unnamed unused input active-high line 4: unnamed unused input active-high line 5: unnamed unused input active-high line 6: unnamed unused input active-high line 7: unnamed unused input active-high","title":"Opzionale: Identificare il gpiochip corretto"},{"location":"RPi_microcontroller.html#opzionale-hardware-pwm","text":"I Raspberry Pi hanno due canali PWM (PWM0 e PWM1) che sono esposti sull'intestazione o, in caso contrario, possono essere instradati ai pin gpio esistenti. Il demone mcu Linux utilizza l'interfaccia sysfs pwmchip per controllare i dispositivi hardware pwm sugli host Linux. L'interfaccia sysfs pwm non \u00e8 esposta per impostazione predefinita su un Raspberry e pu\u00f2 essere attivata aggiungendo una riga a /boot/config.txt : # Abilita l'interfaccia sysfs di pwmchip dtoverlay=pwm,pin=12,func=4 Questo esempio abilita solo PWM0 e lo indirizza a gpio12. Se entrambi i canali PWM devono essere abilitati potete usare pwm-2chan . L'overlay non espone la riga pwm sui sysfs all'avvio e deve essere esportata facendo eco al numero del canale pwm in /sys/class/pwm/pwmchip0/export : echo 0 > /sys/class/pwm/pwmchip0/export Questo creer\u00e0 il dispositivo /sys/class/pwm/pwmchip0/pwm0 nel filesystem. Il modo pi\u00f9 semplice per farlo \u00e8 aggiungerlo a /etc/rc.local prima della riga exit 0 . Con il sysfs a posto, potete ora utilizzare il canale o i canali pwm aggiungendo il seguente pezzo di configurazione al vostro printer.cfg : [output_pin caselight] pin: host:pwmchip0/pwm0 pwm: True hardware_pwm: True cycle_time: 0.000001 Questo aggiunger\u00e0 il controllo pwm hardware a gpio12 sul Pi (perch\u00e9 l'overlay \u00e8 stato configurato per instradare pwm0 a pin = 12). PWM0 pu\u00f2 essere indirizzato su gpio12 e gpio18, PWM1 pu\u00f2 essere indirizzato su gpio13 e gpio19: PWM gpio PIN Func 0 12 4 0 18 2 1 13 4 1 19 2","title":"Opzionale: Hardware PWM"},{"location":"Releases.html","text":"Versioni \u00b6 Storico delle versioni di Klipper. Vedi installation per informazioni sull'installazione di Klipper. Klipper 0.11.0 \u00b6 Disponibile su 20221128. Modifiche principali in questa versione: Ottimizzazione \"passo su entrambi i lati\" del driver del motore passo-passo Trinamic. Supporto per Python3. Il codice host di Klipper verr\u00e0 eseguito con Python2 o Python3. Supporto bus CAN migliorato. Supporto per bus CAN su chip rp2040, stm32g0, stm32h7, same51 e same54. Supporto per la modalit\u00e0 \"Bridge da USB a CAN bus\". Supporto per il bootloader CanBoot. Supporto per accelerometri mpu9250 e mpu6050. Gestione degli errori migliorata per i sensori di temperatura max31856, max31855, max31865 e max6675. Ora \u00e8 possibile configurare i LED per l'aggiornamento durante i comandi G-Code di lunga durata utilizzando il supporto del \"template\" LED. Diversi miglioramenti del microcontrollore. Nuovo supporto per i chip stm32h743, stm32h750, stm32l412, stm32g0b1, same70, same51 e same54. Supporto per letture i2c su atsamd e stm32f0. Supporto hardware pwm su stm32. Invio di eventi basato sul segnale Linux mcu. Nuovo supporto rp2040 per \"make flash\", i2c ed errata USB rp2040-e5. Aggiunti nuovi moduli: angle, dac084S085, exclude_object, led, mpu9250, pca9632, smart_effector, z_thermal_adjust. Aggiunta nuova cinematica deltesiana. Nuovo strumento dump_mcu aggiunto. Correzione di diversi bug e pulizia del codice. Klipper 0.10.0 \u00b6 Disponibile su 20210929. Principali modifiche in questa versione: Supporto per \"Homing multi-MCU\". \u00c8 ora possibile collegare un motore passo-passo e il relativo fine corsa a microcontrollori separati. Ci\u00f2 semplifica il cablaggio delle sonde Z sulle \"schede portautensili\". Klipper ora ha un Community Discord Server e un Community Discourse Server . Il sito Web di Klipper ora utilizza l'infrastruttura \"mkdocs\". Esiste anche un progetto Klipper Translations . Supporto automatizzato per il flashing del firmware tramite sdcard su molte schede. Nuovo supporto cinematico per le stampanti \"Hybrid CoreXY\" e \"Hybrid CoreXZ\". Klipper ora usa rotation_distance per configurare le distanze di viaggio del motore passo-passo. Il codice host principale di Klipper ora pu\u00f2 comunicare direttamente con i microcontrollori utilizzando il bus CAN. Nuovo sistema di \"analisi del movimento\". Gli aggiornamenti di movimento interni di Klipper e i risultati dei sensori possono essere tracciati e registrati per l'analisi. I driver per motori passo-passo Trinamic sono ora costantemente monitorati per rilevare eventuali condizioni di errore. Supporto per il microcontrollore rp2040 (schede Raspberry Pi Pico). Il sistema \"make menuconfig\" ora utilizza kconfiglib. Molti moduli aggiuntivi aggiunti: ds18b20, duplicate_pin_override, filament_motion_sensor, palette2, motion_report, pca9533, pulse_counter, save_variables, sdcard_loop, temperature_host, temperature_mcu Correzione di diversi bug e pulizia del codice. Klipper 0.9.0 \u00b6 Disponibile su 20201020. Modifiche principali in questa versione: Supporto per \"Input Shaping\" - un meccanismo per contrastare la risonanza della stampante. Pu\u00f2 ridurre o eliminare il \"ringing\" nelle stampe. Nuovo sistema \"Smooth Pressure Advance\". Questo implementa \"Pressure Advance\" senza introdurre variazioni di velocit\u00e0 istantanee. Ora \u00e8 anche possibile regolare l'anticipo della pressione utilizzando un metodo \"Tuning Tower\". Nuovo server API \"webhook\". Ci\u00f2 fornisce un'interfaccia JSON programmabile a Klipper. Il display LCD e il menu sono ora configurabili utilizzando la lingua del modello Jinja2. I driver per motori passo-passo TMC2208 possono ora essere utilizzati in modalit\u00e0 \"standalone\" con Klipper. Supporto BL-Touch v3 migliorato. Identificazione USB migliorata. Klipper ora ha il proprio codice di identificazione USB e i microcontrollori possono ora riportare i loro numeri di serie univoci durante l'identificazione USB. Nuovo supporto cinematico per stampanti \"Rotary Delta\" e \"CoreXZ\". Miglioramenti del microcontrollore: supporto per stm32f070, supporto per stm32f207, supporto per pin GPIO su \"Linux MCU\", supporto per \"bootloader HID\" stm32, supporto per bootloader Chitu, supporto per bootloader MKS Robin. Gestione migliorata degli eventi di \"garbage collection\" di Python. Molti moduli aggiuntivi aggiunti: adc_scaled, adxl345, bme280, display_status, extruder_stepper, fan_generic, hall_filament_width_sensor, htu21d, homing_heaters, input_shaper, lm75, print_stats, resonance_tester, shaper_calibrate, query_adc, graph_accelerometer, graph_extruder, graph_motion, graph_shaper, graph_temp_sensor, whconsole Correzione di diversi bug e pulizia del codice. Klipper 0.9.1 \u00b6 Disponibile su 20201028. Versione contenente solo correzioni di bug. Klipper 0.8.0 \u00b6 Disponibile su 20191021. Modifiche principali in questa versione: Nuovo supporto per il modello dei comandi G-Code. Il G-Code nel file di configurazione viene ora valutato con il linguaggio dei template Jinja2. Miglioramenti ai driver per stepper Trinamic: Nuovo supporto per i driver TMC2209 e TMC5160. Migliorati i comandi G-Code DUMP_TMC, SET_TMC_CURRENT e INIT_TMC. Supporto migliorato per la gestione di TMC UART con un mux analogico. Supporto migliorato per homing, sonda e livellamento del piatto: Aggiunti nuovi moduli manual_probe, bed_screws, Screws_tilt_adjust, skew_correction, safe_z_home. Sondaggio multi-campione migliorato con logica mediana, media e tentativi. Documentazione migliorata per BL-Touch, calibrazione della sonda, calibrazione endstop, calibrazione delta, homing sensorless e calibrazione della fase finecorsa. Supporto della corsa di riferimento migliorato su un asse Z grande. Molti miglioramenti del microcontrollore Klipper: Klipper portato su: SAM3X8C, SAM4S8C, SAMD51, STM32F042, STM32F4 Nuove implementazioni del driver CDC USB su SAM3X, SAM4, STM32F4. Supporto avanzato per il flashing di Klipper su USB. Supporto SPI software. Filtraggio della temperatura notevolmente migliorato sull'LPC176x. Le impostazioni dei pin di uscita possono essere configurate nel microcontrollore. Nuovo sito web con la documentazione di Klipper: http://klipper3d.org/ Klipper ora ha un logo. Supporto sperimentale alla cinematica polare e \"cable winch\". Il file di configurazione ora pu\u00f2 includere altri file di configurazione. Molti moduli aggiuntivi aggiunti: board_pins, controller_fan, delay_gcode, dotstar, filament_switch_sensor, firmware_retraction, gcode_arcs, gcode_button, heater_generic, manual_stepper, mcp4018, mcp4728, neopixel, pause_resume, respond, temperature_sensor tsl1401cl_filament_width_sensor, tuning_tower Molti comandi aggiuntivi aggiunti: RESTORE_GCODE_STATE, SAVE_GCODE_STATE, SET_GCODE_VARIABLE, SET_HEATER_TEMPERATURE, SET_IDLE_TIMEOUT, SET_TEMPERATURE_FAN_TARGET Correzione di diversi bug e pulizia del codice. Klipper 0.7.0 \u00b6 Disponibile su 20181220. Modifiche principali in questa versione: Klipper ora supporta il livellamento del piatto \"mesh\" Nuovo supporto per la calibrazione delta \"potenziata\" (calibra le dimensioni x/y di stampa su stampanti delta) Supporto per la configurazione a runtime dei driver per motori passo-passo Trinamic (tmc2130, tmc2208, tmc2660) Migliorato il supporto del sensore di temperatura: MAX6675, MAX31855, MAX31856, MAX31865, termistori personalizzati, sensori stile pt100 comuni Diversi nuovi moduli: temperature_fan, sx1509, force_move, mcp4451, z_tilt, quad_gantry_level, endstop_phase, bltouch Aggiunti diversi nuovi comandi: SAVE_CONFIG, SET_PRESSURE_ADVANCE, SET_GCODE_OFFSET, SET_VELOCITY_LIMIT, STEPPER_BUZZ, TURN_OFF_HEATERS, M204, macro g-code personalizzate Supporto display LCD esteso: Supporto per i menu a runtime Nuove icone di visualizzazione Supporto per i display \"uc1701\" e \"ssd1306\" Supporto per microcontrollore aggiuntivo: Klipper portato su: LPC176x (Smoothieboards), SAM4E8E (Duet2), SAMD21 (Arduino Zero), STM32F103 (dispositivi \"blue pill\"), atmega32u4 Nuovo driver USB CDC generico implementato su AVR, LPC176x, SAMD21 e STM32F103 Miglioramenti delle prestazioni sui processori ARM Il codice della cinematica \u00e8 stato riscritto per utilizzare un \"risolutore iterativo\" Nuovi test case automatici per il software host Klipper Molti nuovi file di configurazione di esempio per le stampanti standard comuni Aggiornamenti della documentazione per bootloader, benchmarking, porting del microcontroller, controlli di configurazione, mappatura dei pin, impostazioni dello slicer, packaging e altro ancora Diverse correzioni di bug e pulizia del codice Klipper 0.6.0 \u00b6 Disponibile su 20180331. Modifiche principali in questa versione: Controlli avanzati dei guasti hardware del riscaldatore e del termistore Supporto per sonde Z Supporto iniziale per la calibrazione automatica dei parametri sulle delta (tramite un nuovo comando delta_calibrate) Supporto iniziale per la compensazione dell'inclinazione del piatto (tramite il comando bed_tilt_calibrate) Supporto iniziale per \"homing sicuro\" e di homing overrides Supporto iniziale per la visualizzazione dello stato sui display RepRapDiscount stile 2004 e 12864 Nuovi miglioramenti multi-estrusore: Supporto per riscaldatori condivisi Supporto iniziale per carrelli doppi Supporto per la configurazione di pi\u00f9 stepper per asse (ad es. doppia Z) Supporto per pin di output digitali e pwm personalizzati (con un nuovo comando SET_PIN) Supporto iniziale per una \"sdcard virtuale\" che consente di stampare direttamente da Klipper (aiuta su macchine troppo lente per eseguire bene OctoPrint) Supporto per impostare diverse lunghezze del braccio su ciascuna torre di una delta Supporto per i comandi G-Code M220/M221 (override del fattore di velocit\u00e0/override del fattore di estrusione) Diversi aggiornamenti della documentazione: Molti nuovi file di configurazione di esempio per le stampanti standard comuni Nuovo esempio di configurazione di MCU multipli Nuovo esempio di configurazione del sensore bltouch Nuove FAQ, controllo della configurazione e documenti G-Code Supporto iniziale per test di integrazione continui su tutti i commit di github Diverse correzioni di bug e pulizia del codice Klipper 0.5.0 \u00b6 Disponibile su 20171025. Modifiche principali in questa versione: Supporto per stampanti con pi\u00f9 estrusori. Supporto iniziale per l'esecuzione su Beaglebone PRU. Supporto iniziale per la scheda Replicape. Supporto iniziale per l'esecuzione del codice del microcontrollore in un processo Linux in tempo reale. Supporto per microcontrollori multipli. (Ad esempio, si potrebbe controllare un estrusore con un microcontrollore e il resto della stampante con un altro.) La sincronizzazione dell'orologio del software \u00e8 implementata per coordinare le azioni tra i microcontrollori. Miglioramenti delle prestazioni stepper (AVR da 20 Mhz fino a 189.000 passi al secondo). Supporto per il controllo dei servocomandi e supporto per la definizione delle ventole di raffreddamento degli ugelli. Diverse correzioni di bug e pulizia del codice Klipper 0.4.0 \u00b6 Disponibile su 20170503. Modifiche principali in questa versione: Installazione migliorata su macchine Raspberry Pi. La maggior parte dell'installazione \u00e8 ora basata su script. Supporto per la cinematica corexy Aggiornamenti della documentazione: nuovo documento Cinematica, nuova guida all'ottimizzazione di Pressure Advance, nuovi file di configurazione di esempio e altro ancora Miglioramenti delle prestazioni dello stepper (AVR da 20 Mhz su 175.000 passi al secondo, Arduino Due oltre 460.000) Supporto per il ripristino automatico del microcontrollore. Supporto per il ripristino tramite l'attivazione dell'alimentazione USB su Raspberry Pi. L'algoritmo di avanzamento della pressione ora funziona con il look-ahead per ridurre le variazioni di pressione in curva. Supporto per limitare la velocit\u00e0 massima di brevi movimenti a zigzag Supporto per sensori AD595 Diverse correzioni di bug e pulizia del codice Klipper 0.3.0 \u00b6 Disponibile su 20161223. Modifiche principali in questa versione: Documentazione migliorata Supporto per robot con cinematica delta Supporto per microcontrollore Arduino Due (ARM cortex-M3) Supporto USB per microcontrollori basati su AVR Supporto per l'algoritmo di \"pressure advance\": riduce la trasudazione durante le stampe. Nuova funzione \"stopper phased based\" - consente una maggiore precisione sull'homing. Supporto per comandi \"extended g-code\" come \"help\", \"restart\" e \"status\". Supporto per ricaricare la configurazione di Klipper e riavviare il software host emettendo un comando di \"restart\" dal terminale. Miglioramenti delle prestazioni stepper (AVR da 20 Mhz fino a 158.000 passi al secondo). Segnalazione errori migliorata. La maggior parte degli errori ora viene mostrata tramite il terminale insieme all'aiuto su come risolverli. Diverse correzioni di bug e pulizia del codice Klipper 0.2.0 \u00b6 Rilascio iniziale di Klipper. Disponibile su 20160525. Le principali funzionalit\u00e0 disponibili nella versione iniziale includono: Supporto di base per stampanti cartesiane (stepper, estrusore, piatto riscaldato, ventola di raffreddamento). Supporto per i comandi g-code comuni. Supporto per interfacciarsi con OctoPrint. Accelerazione e gestione lookahead Supporto per microcontrollori AVR tramite porte seriali standard","title":"Versioni"},{"location":"Releases.html#versioni","text":"Storico delle versioni di Klipper. Vedi installation per informazioni sull'installazione di Klipper.","title":"Versioni"},{"location":"Releases.html#klipper-0110","text":"Disponibile su 20221128. Modifiche principali in questa versione: Ottimizzazione \"passo su entrambi i lati\" del driver del motore passo-passo Trinamic. Supporto per Python3. Il codice host di Klipper verr\u00e0 eseguito con Python2 o Python3. Supporto bus CAN migliorato. Supporto per bus CAN su chip rp2040, stm32g0, stm32h7, same51 e same54. Supporto per la modalit\u00e0 \"Bridge da USB a CAN bus\". Supporto per il bootloader CanBoot. Supporto per accelerometri mpu9250 e mpu6050. Gestione degli errori migliorata per i sensori di temperatura max31856, max31855, max31865 e max6675. Ora \u00e8 possibile configurare i LED per l'aggiornamento durante i comandi G-Code di lunga durata utilizzando il supporto del \"template\" LED. Diversi miglioramenti del microcontrollore. Nuovo supporto per i chip stm32h743, stm32h750, stm32l412, stm32g0b1, same70, same51 e same54. Supporto per letture i2c su atsamd e stm32f0. Supporto hardware pwm su stm32. Invio di eventi basato sul segnale Linux mcu. Nuovo supporto rp2040 per \"make flash\", i2c ed errata USB rp2040-e5. Aggiunti nuovi moduli: angle, dac084S085, exclude_object, led, mpu9250, pca9632, smart_effector, z_thermal_adjust. Aggiunta nuova cinematica deltesiana. Nuovo strumento dump_mcu aggiunto. Correzione di diversi bug e pulizia del codice.","title":"Klipper 0.11.0"},{"location":"Releases.html#klipper-0100","text":"Disponibile su 20210929. Principali modifiche in questa versione: Supporto per \"Homing multi-MCU\". \u00c8 ora possibile collegare un motore passo-passo e il relativo fine corsa a microcontrollori separati. Ci\u00f2 semplifica il cablaggio delle sonde Z sulle \"schede portautensili\". Klipper ora ha un Community Discord Server e un Community Discourse Server . Il sito Web di Klipper ora utilizza l'infrastruttura \"mkdocs\". Esiste anche un progetto Klipper Translations . Supporto automatizzato per il flashing del firmware tramite sdcard su molte schede. Nuovo supporto cinematico per le stampanti \"Hybrid CoreXY\" e \"Hybrid CoreXZ\". Klipper ora usa rotation_distance per configurare le distanze di viaggio del motore passo-passo. Il codice host principale di Klipper ora pu\u00f2 comunicare direttamente con i microcontrollori utilizzando il bus CAN. Nuovo sistema di \"analisi del movimento\". Gli aggiornamenti di movimento interni di Klipper e i risultati dei sensori possono essere tracciati e registrati per l'analisi. I driver per motori passo-passo Trinamic sono ora costantemente monitorati per rilevare eventuali condizioni di errore. Supporto per il microcontrollore rp2040 (schede Raspberry Pi Pico). Il sistema \"make menuconfig\" ora utilizza kconfiglib. Molti moduli aggiuntivi aggiunti: ds18b20, duplicate_pin_override, filament_motion_sensor, palette2, motion_report, pca9533, pulse_counter, save_variables, sdcard_loop, temperature_host, temperature_mcu Correzione di diversi bug e pulizia del codice.","title":"Klipper 0.10.0"},{"location":"Releases.html#klipper-090","text":"Disponibile su 20201020. Modifiche principali in questa versione: Supporto per \"Input Shaping\" - un meccanismo per contrastare la risonanza della stampante. Pu\u00f2 ridurre o eliminare il \"ringing\" nelle stampe. Nuovo sistema \"Smooth Pressure Advance\". Questo implementa \"Pressure Advance\" senza introdurre variazioni di velocit\u00e0 istantanee. Ora \u00e8 anche possibile regolare l'anticipo della pressione utilizzando un metodo \"Tuning Tower\". Nuovo server API \"webhook\". Ci\u00f2 fornisce un'interfaccia JSON programmabile a Klipper. Il display LCD e il menu sono ora configurabili utilizzando la lingua del modello Jinja2. I driver per motori passo-passo TMC2208 possono ora essere utilizzati in modalit\u00e0 \"standalone\" con Klipper. Supporto BL-Touch v3 migliorato. Identificazione USB migliorata. Klipper ora ha il proprio codice di identificazione USB e i microcontrollori possono ora riportare i loro numeri di serie univoci durante l'identificazione USB. Nuovo supporto cinematico per stampanti \"Rotary Delta\" e \"CoreXZ\". Miglioramenti del microcontrollore: supporto per stm32f070, supporto per stm32f207, supporto per pin GPIO su \"Linux MCU\", supporto per \"bootloader HID\" stm32, supporto per bootloader Chitu, supporto per bootloader MKS Robin. Gestione migliorata degli eventi di \"garbage collection\" di Python. Molti moduli aggiuntivi aggiunti: adc_scaled, adxl345, bme280, display_status, extruder_stepper, fan_generic, hall_filament_width_sensor, htu21d, homing_heaters, input_shaper, lm75, print_stats, resonance_tester, shaper_calibrate, query_adc, graph_accelerometer, graph_extruder, graph_motion, graph_shaper, graph_temp_sensor, whconsole Correzione di diversi bug e pulizia del codice.","title":"Klipper 0.9.0"},{"location":"Releases.html#klipper-091","text":"Disponibile su 20201028. Versione contenente solo correzioni di bug.","title":"Klipper 0.9.1"},{"location":"Releases.html#klipper-080","text":"Disponibile su 20191021. Modifiche principali in questa versione: Nuovo supporto per il modello dei comandi G-Code. Il G-Code nel file di configurazione viene ora valutato con il linguaggio dei template Jinja2. Miglioramenti ai driver per stepper Trinamic: Nuovo supporto per i driver TMC2209 e TMC5160. Migliorati i comandi G-Code DUMP_TMC, SET_TMC_CURRENT e INIT_TMC. Supporto migliorato per la gestione di TMC UART con un mux analogico. Supporto migliorato per homing, sonda e livellamento del piatto: Aggiunti nuovi moduli manual_probe, bed_screws, Screws_tilt_adjust, skew_correction, safe_z_home. Sondaggio multi-campione migliorato con logica mediana, media e tentativi. Documentazione migliorata per BL-Touch, calibrazione della sonda, calibrazione endstop, calibrazione delta, homing sensorless e calibrazione della fase finecorsa. Supporto della corsa di riferimento migliorato su un asse Z grande. Molti miglioramenti del microcontrollore Klipper: Klipper portato su: SAM3X8C, SAM4S8C, SAMD51, STM32F042, STM32F4 Nuove implementazioni del driver CDC USB su SAM3X, SAM4, STM32F4. Supporto avanzato per il flashing di Klipper su USB. Supporto SPI software. Filtraggio della temperatura notevolmente migliorato sull'LPC176x. Le impostazioni dei pin di uscita possono essere configurate nel microcontrollore. Nuovo sito web con la documentazione di Klipper: http://klipper3d.org/ Klipper ora ha un logo. Supporto sperimentale alla cinematica polare e \"cable winch\". Il file di configurazione ora pu\u00f2 includere altri file di configurazione. Molti moduli aggiuntivi aggiunti: board_pins, controller_fan, delay_gcode, dotstar, filament_switch_sensor, firmware_retraction, gcode_arcs, gcode_button, heater_generic, manual_stepper, mcp4018, mcp4728, neopixel, pause_resume, respond, temperature_sensor tsl1401cl_filament_width_sensor, tuning_tower Molti comandi aggiuntivi aggiunti: RESTORE_GCODE_STATE, SAVE_GCODE_STATE, SET_GCODE_VARIABLE, SET_HEATER_TEMPERATURE, SET_IDLE_TIMEOUT, SET_TEMPERATURE_FAN_TARGET Correzione di diversi bug e pulizia del codice.","title":"Klipper 0.8.0"},{"location":"Releases.html#klipper-070","text":"Disponibile su 20181220. Modifiche principali in questa versione: Klipper ora supporta il livellamento del piatto \"mesh\" Nuovo supporto per la calibrazione delta \"potenziata\" (calibra le dimensioni x/y di stampa su stampanti delta) Supporto per la configurazione a runtime dei driver per motori passo-passo Trinamic (tmc2130, tmc2208, tmc2660) Migliorato il supporto del sensore di temperatura: MAX6675, MAX31855, MAX31856, MAX31865, termistori personalizzati, sensori stile pt100 comuni Diversi nuovi moduli: temperature_fan, sx1509, force_move, mcp4451, z_tilt, quad_gantry_level, endstop_phase, bltouch Aggiunti diversi nuovi comandi: SAVE_CONFIG, SET_PRESSURE_ADVANCE, SET_GCODE_OFFSET, SET_VELOCITY_LIMIT, STEPPER_BUZZ, TURN_OFF_HEATERS, M204, macro g-code personalizzate Supporto display LCD esteso: Supporto per i menu a runtime Nuove icone di visualizzazione Supporto per i display \"uc1701\" e \"ssd1306\" Supporto per microcontrollore aggiuntivo: Klipper portato su: LPC176x (Smoothieboards), SAM4E8E (Duet2), SAMD21 (Arduino Zero), STM32F103 (dispositivi \"blue pill\"), atmega32u4 Nuovo driver USB CDC generico implementato su AVR, LPC176x, SAMD21 e STM32F103 Miglioramenti delle prestazioni sui processori ARM Il codice della cinematica \u00e8 stato riscritto per utilizzare un \"risolutore iterativo\" Nuovi test case automatici per il software host Klipper Molti nuovi file di configurazione di esempio per le stampanti standard comuni Aggiornamenti della documentazione per bootloader, benchmarking, porting del microcontroller, controlli di configurazione, mappatura dei pin, impostazioni dello slicer, packaging e altro ancora Diverse correzioni di bug e pulizia del codice","title":"Klipper 0.7.0"},{"location":"Releases.html#klipper-060","text":"Disponibile su 20180331. Modifiche principali in questa versione: Controlli avanzati dei guasti hardware del riscaldatore e del termistore Supporto per sonde Z Supporto iniziale per la calibrazione automatica dei parametri sulle delta (tramite un nuovo comando delta_calibrate) Supporto iniziale per la compensazione dell'inclinazione del piatto (tramite il comando bed_tilt_calibrate) Supporto iniziale per \"homing sicuro\" e di homing overrides Supporto iniziale per la visualizzazione dello stato sui display RepRapDiscount stile 2004 e 12864 Nuovi miglioramenti multi-estrusore: Supporto per riscaldatori condivisi Supporto iniziale per carrelli doppi Supporto per la configurazione di pi\u00f9 stepper per asse (ad es. doppia Z) Supporto per pin di output digitali e pwm personalizzati (con un nuovo comando SET_PIN) Supporto iniziale per una \"sdcard virtuale\" che consente di stampare direttamente da Klipper (aiuta su macchine troppo lente per eseguire bene OctoPrint) Supporto per impostare diverse lunghezze del braccio su ciascuna torre di una delta Supporto per i comandi G-Code M220/M221 (override del fattore di velocit\u00e0/override del fattore di estrusione) Diversi aggiornamenti della documentazione: Molti nuovi file di configurazione di esempio per le stampanti standard comuni Nuovo esempio di configurazione di MCU multipli Nuovo esempio di configurazione del sensore bltouch Nuove FAQ, controllo della configurazione e documenti G-Code Supporto iniziale per test di integrazione continui su tutti i commit di github Diverse correzioni di bug e pulizia del codice","title":"Klipper 0.6.0"},{"location":"Releases.html#klipper-050","text":"Disponibile su 20171025. Modifiche principali in questa versione: Supporto per stampanti con pi\u00f9 estrusori. Supporto iniziale per l'esecuzione su Beaglebone PRU. Supporto iniziale per la scheda Replicape. Supporto iniziale per l'esecuzione del codice del microcontrollore in un processo Linux in tempo reale. Supporto per microcontrollori multipli. (Ad esempio, si potrebbe controllare un estrusore con un microcontrollore e il resto della stampante con un altro.) La sincronizzazione dell'orologio del software \u00e8 implementata per coordinare le azioni tra i microcontrollori. Miglioramenti delle prestazioni stepper (AVR da 20 Mhz fino a 189.000 passi al secondo). Supporto per il controllo dei servocomandi e supporto per la definizione delle ventole di raffreddamento degli ugelli. Diverse correzioni di bug e pulizia del codice","title":"Klipper 0.5.0"},{"location":"Releases.html#klipper-040","text":"Disponibile su 20170503. Modifiche principali in questa versione: Installazione migliorata su macchine Raspberry Pi. La maggior parte dell'installazione \u00e8 ora basata su script. Supporto per la cinematica corexy Aggiornamenti della documentazione: nuovo documento Cinematica, nuova guida all'ottimizzazione di Pressure Advance, nuovi file di configurazione di esempio e altro ancora Miglioramenti delle prestazioni dello stepper (AVR da 20 Mhz su 175.000 passi al secondo, Arduino Due oltre 460.000) Supporto per il ripristino automatico del microcontrollore. Supporto per il ripristino tramite l'attivazione dell'alimentazione USB su Raspberry Pi. L'algoritmo di avanzamento della pressione ora funziona con il look-ahead per ridurre le variazioni di pressione in curva. Supporto per limitare la velocit\u00e0 massima di brevi movimenti a zigzag Supporto per sensori AD595 Diverse correzioni di bug e pulizia del codice","title":"Klipper 0.4.0"},{"location":"Releases.html#klipper-030","text":"Disponibile su 20161223. Modifiche principali in questa versione: Documentazione migliorata Supporto per robot con cinematica delta Supporto per microcontrollore Arduino Due (ARM cortex-M3) Supporto USB per microcontrollori basati su AVR Supporto per l'algoritmo di \"pressure advance\": riduce la trasudazione durante le stampe. Nuova funzione \"stopper phased based\" - consente una maggiore precisione sull'homing. Supporto per comandi \"extended g-code\" come \"help\", \"restart\" e \"status\". Supporto per ricaricare la configurazione di Klipper e riavviare il software host emettendo un comando di \"restart\" dal terminale. Miglioramenti delle prestazioni stepper (AVR da 20 Mhz fino a 158.000 passi al secondo). Segnalazione errori migliorata. La maggior parte degli errori ora viene mostrata tramite il terminale insieme all'aiuto su come risolverli. Diverse correzioni di bug e pulizia del codice","title":"Klipper 0.3.0"},{"location":"Releases.html#klipper-020","text":"Rilascio iniziale di Klipper. Disponibile su 20160525. Le principali funzionalit\u00e0 disponibili nella versione iniziale includono: Supporto di base per stampanti cartesiane (stepper, estrusore, piatto riscaldato, ventola di raffreddamento). Supporto per i comandi g-code comuni. Supporto per interfacciarsi con OctoPrint. Accelerazione e gestione lookahead Supporto per microcontrollori AVR tramite porte seriali standard","title":"Klipper 0.2.0"},{"location":"Resonance_Compensation.html","text":"Compensazione della risonanza \u00b6 Klipper supporta Input Shaping, una tecnica che pu\u00f2 essere utilizzata per ridurre il ringing (noti anche come echoing, ghosting o increspature) nelle stampe. Il ringing \u00e8 un difetto di stampa della superficie quando, in genere, elementi come i bordi si ripetono su una superficie stampata come un sottile \"eco\": | | | I ringing sono causati da vibrazioni meccaniche nella stampante dovute a rapidi cambiamenti della direzione di stampa. Si noti che il ringing di solito ha origini meccaniche: telaio della stampante non sufficientemente rigido, cinghie non tese o troppo elastiche, problemi di allineamento delle parti meccaniche, massa in movimento pesante, ecc. Questi dovrebbero essere prima controllati e riparati, se possibile. Input shaping \u00e8 una tecnica di controllo ad anello aperto che crea un segnale di comando che annulla le proprie vibrazioni. La modellatura dell'ingresso richiede alcune regolazioni e misurazioni prima di poter essere abilitata. Oltre al ringing, Input Shaping riduce in genere le vibrazioni e le vibrazioni della stampante in generale e pu\u00f2 anche migliorare l'affidabilit\u00e0 della modalit\u00e0 StealthChop dei driver stepper Trinamic. Messa a punto \u00b6 La regolazione di base richiede la misurazione delle frequenze di ringing della stampante stampando un modello di prova. Carica il modello di prova per il ringing, che pu\u00f2 essere trovato in docs/prints/ringing_tower.stl , nello slicer: L'altezza dello strato (layer) consigliata \u00e8 0,2 o 0,25 mm. I livelli di riempimento e superiori possono essere impostati su 0. Usa 1-2 perimetri, o meglio ancora la modalit\u00e0 vaso liscio con base da 1-2 mm. Utilizzare velocit\u00e0 sufficientemente elevate, circa 80-100 mm/sec, per i perimetri esterni . Assicurati che il tempo minimo per lo strato sia al massimo 3 secondi. Assicurati che qualsiasi \"controllo dinamico dell'accelerazione\" sia disabilitato nello slicer. Non girare il modello. Il modello ha segni X e Y sul retro del modello. Nota la posizione insolita dei segni rispetto agli assi della stampante: non \u00e8 un errore. I contrassegni possono essere utilizzati successivamente nel processo di ottimizzazione come riferimento, poich\u00e9 mostrano a quale asse corrispondono le misurazioni. Frequenza di ringing \u00b6 Innanzitutto, misura la frequenza di ringing . Se il parametro square_corner_velocity \u00e8 stato modificato, ripristinalo a 5.0 . Non \u00e8 consigliabile aumentarlo quando si utilizza l'input shaper perch\u00e9 pu\u00f2 causare un maggiore smussamento smoothing delle parti: \u00e8 invece meglio utilizzare un valore di accelerazione pi\u00f9 elevato. Aumenta max_accel_to_decel inserendo il seguente comando: SET_VELOCITY_LIMIT ACCEL_TO_DECEL=7000 Disabilita la Pressure Advance: SET_PRESSURE_ADVANCE ADVANCE=0 Se hai gi\u00e0 aggiunto la sezione [input_shaper] a printer.cfg, esegui il comando SET_INPUT_SHAPER SHAPER_FREQ_X=0 SHAPER_FREQ_Y=0 . Se ricevi l'errore \"Comando sconosciuto- Unknown command\", puoi tranquillamente ignorarlo a questo punto e continuare con le misurazioni. Eseguire il comando: TUNING_TOWER COMMAND=SET_VELOCITY_LIMIT PARAMETER=ACCEL START=1500 STEP_DELTA=500 STEP_HEIGHT=5 Fondamentalmente, cerchiamo di rendere pi\u00f9 pronunciato il ringing impostando diversi valori elevati per l'accelerazione. Questo comando aumenter\u00e0 l'accelerazione ogni 5 mm a partire da 1500 mm/sec^2: 1500 mm/sec^2, 2000 mm/sec^2, 2500 mm/sec^2 e cos\u00ec via fino a 7000 mm/sec^2 per l'ultima fascia. Stampa il modello di test sliced con i parametri suggeriti. Puoi interrompere la stampa prima se il ringing \u00e8 chiaramente visibile e vedi che l'accelerazione diventa troppo alta per la tua stampante (ad es. la stampante trema troppo o inizia a saltare i passaggi). Utilizzare i segni X e Y sul retro del modello come riferimento. Le misurazioni dal lato con il contrassegno X devono essere utilizzate per la configurazione dell'asse X e il contrassegno Y - per la configurazione dell'asse Y. Misurare la distanza D (in mm) tra pi\u00f9 oscillazioni sulla parte con il segno X, in prossimit\u00e0 delle tacche, preferibilmente saltando la prima o due oscillazioni. Per misurare pi\u00f9 facilmente la distanza tra le oscillazioni, contrassegnare prima le oscillazioni, quindi misurare la distanza tra i segni con un righello o un calibro:| | | Contare a quante oscillazioni N corrisponde la distanza misurata D . Se non sei sicuro di come contare le oscillazioni, fai riferimento all'immagine sopra, che mostra N = 6 oscillazioni. Calcola la frequenza di squillo dell'asse X come V \u00b7 N / D (Hz), dove V \u00e8 la velocit\u00e0 per i perimetri esterni (mm/sec). Per l'esempio sopra, abbiamo contrassegnato 6 oscillazioni e il test \u00e8 stato stampato a una velocit\u00e0 di 100 mm/sec, quindi la frequenza \u00e8 100 * 6 / 12,14 \u2248 49,4 Hz. Esegui (8) - (10) anche per il segno Y. Si noti che il ringing sulla stampa di prova dovrebbe seguire lo schema delle tacche curve, come nell'immagine sopra. In caso contrario, questo difetto non \u00e8 in realt\u00e0 un ringing e ha un'origine diversa: un problema meccanico o dell'estrusore. Dovrebbe essere risolto prima di abilitare e regolare gli shaper di input. Se le misurazioni non sono affidabili perch\u00e9, ad esempio, la distanza tra le oscillazioni non \u00e8 stabile, potrebbe significare che la stampante ha pi\u00f9 frequenze di risonanza sullo stesso asse. Si pu\u00f2 invece provare a seguire il processo di sintonizzazione descritto nella sezione Misurazioni inaffidabili delle frequenze di ringing e ottenere comunque qualcosa dalla tecnica di input shaping . La frequenza dei ringing pu\u00f2 dipendere dalla posizione del modello all'interno della piastra di stampa e dall'altezza Z, soprattutto sulle stampanti delta ; puoi controllare se vedi le differenze di frequenza in diverse posizioni lungo i lati del modello di prova e ad altezze diverse. \u00c8 possibile calcolare le frequenze di squillo medie sugli assi X e Y, se questo \u00e8 il caso. Se la frequenza di ringing misurata \u00e8 molto bassa (inferiore a circa 20-25 Hz), potrebbe essere una buona idea investire nell'irrigidire la stampante o nel diminuire la massa mobile, a seconda di ci\u00f2 che \u00e8 applicabile nel tuo caso, prima di procedere con l'ulteriore input shaping e rimisurare le frequenze in seguito. Per molti modelli di stampanti popolari spesso sono gi\u00e0 disponibili alcune soluzioni. Si noti che le frequenze di ringing possono cambiare se alla stampante vengono apportate modifiche che influiscono sulla massa in movimento o modificano la rigidit\u00e0 del sistema, ad esempio: Alcuni strumenti vengono installati, rimossi o sostituiti sulla testa di stampa che ne modificano la massa, ad es. viene installato un nuovo motore passo-passo (pi\u00f9 pesante o pi\u00f9 leggero) per estrusore diretto o viene installato un nuovo hotend, viene aggiunta una ventola pesante con un condotto, ecc. Le cinghie sono tese. Sono installati alcuni componenti aggiuntivi per aumentare la rigidit\u00e0 del telaio. Un piatto diverso \u00e8 installato su una stampante a piatto mobile o aggiunto un vetro, ecc. Se vengono apportate tali modifiche, \u00e8 una buona idea misurare almeno le frequenze di ringing per vedere se sono cambiate. Configurazione del Input shaper \u00b6 Dopo aver misurato le frequenze di ringing per gli assi X e Y, puoi aggiungere la seguente sezione al tuo printer.cfg : [input_shaper] shaper_freq_x: ... # frequenza per il segno X del modello di prova shaper_freq_y: ... # frequenza per il segno Y del modello di prova Per l'esempio sopra, otteniamo shaper_freq_x/y = 49.4. Scelta del input shaper \u00b6 Klipper supporta diversi input shaper. Si differenziano per la loro sensibilit\u00e0 agli errori che determinano la frequenza di risonanza e quanto smussamento provocano nelle parti stampate. Inoltre, alcuni degli shaper come 2HUMP_EI e 3HUMP_EI di solito non dovrebbero essere usati con shaper_freq = frequenza di risonanza: sono configurati in base a diverse considerazioni per ridurre diverse risonanze contemporaneamente. Per la maggior parte delle stampanti, possono essere consigliati shaper MZV o EI. Questa sezione descrive un processo di test per scegliere tra di loro e capire alcuni altri parametri correlati. Stampare il modello di prova di ringing come segue: Riavviare il firmware: RESTART Prepararsi per il test: SET_VELOCITY_LIMIT ACCEL_TO_DECEL=7000 Disabilita la Pressure Advance: SET_PRESSURE_ADVANCE ADVANCE=0 Eseguire: SET_INPUT_SHAPER SHAPER_TYPE=MZV Eseguire il comando: TUNING_TOWER COMMAND=SET_VELOCITY_LIMIT PARAMETER=ACCEL START=1500 STEP_DELTA=500 STEP_HEIGHT=5 Stampa il modello di test sliced con i parametri suggeriti. Se a questo punto non si vede alcun ringing, \u00e8 possibile consigliare l'uso dello shaper MZV. Se vedi dei ringing, rimisura le frequenze usando i passaggi (8)-(10) descritti nella sezione Frequenza ringing . Se le frequenze differiscono in modo significativo dai valori ottenuti in precedenza, \u00e8 necessaria una configurazione dello shaper di input pi\u00f9 complessa. Puoi fare riferimento ai dettagli tecnici della sezione Input shapers . In caso contrario, procedere al passaggio successivo. Ora prova l'input shaper EI. Per provarlo, ripeti i passaggi (1)-(6) da sopra, ma eseguendo invece al passaggio 4 il seguente comando : SET_INPUT_SHAPER SHAPER_TYPE=EI . Confronta due stampe con input shaper MZV e EI. Se EI mostra risultati notevolmente migliori rispetto a MZV, utilizzare EI shaper, altrimenti preferire MZV. Si noti che lo shaper EI causer\u00e0 una maggiore levigatura 'smoothing' nelle parti stampate (vedere la sezione successiva per ulteriori dettagli). Aggiungi il parametro shaper_type: mzv (o ei) alla sezione [input_shaper], ad esempio: [input_shaper] shaper_freq_x: ... shaper_freq_y: ... shaper_type: mzv Alcune note sulla scelta dello shaper: Lo shaper EI pu\u00f2 essere pi\u00f9 adatto per le stampanti a piatto mobile (se la frequenza di risonanza e il conseguente livellamento lo consentono): man mano che si deposita pi\u00f9 filamento sul piatto mobile, la massa del piatto aumenta e la frequenza di risonanza diminuisce. Poich\u00e9 lo shaper EI \u00e8 pi\u00f9 robusto alle variazioni della frequenza di risonanza, potrebbe funzionare meglio quando si stampano parti di grandi dimensioni. A causa della natura della cinematica delta, le frequenze di risonanza possono differire molto in diverse parti del volume di costruzione. Pertanto, lo shaper EI pu\u00f2 adattarsi meglio alle stampanti delta piuttosto che a MZV o ZV e dovrebbe essere considerato per l'uso. Se la frequenza di risonanza \u00e8 sufficientemente grande (pi\u00f9 di 50-60 Hz), si pu\u00f2 anche provare a testare lo shaper 2HUMP_EI (eseguendo il test suggerito sopra con SET_INPUT_SHAPER SHAPER_TYPE=2HUMP_EI ), ma controllare le considerazioni nella sezione sotto prima di abilitarlo. Seleziona max_accel \u00b6 Dovresti avere un test stampato per lo shaper che hai scelto dal passaggio precedente (se non lo fai, stampa il modello di test affettato con i parametri suggeriti con l'anticipo di pressione disabilitato SET_PRESSURE_ADVANCE ADVANCE=0 e con la torre di regolazione abilitata come TUNING_TOWER COMMAND=SET_VELOCITY_LIMIT PARAMETER=ACCEL START=1500 STEP_DELTA=500 STEP_HEIGHT=5 ). Si noti che ad accelerazioni molto elevate, a seconda della frequenza di risonanza e dell'input shaper scelto (ad es. EI shaper crea pi\u00f9 smussamento di MZV), l'input shaping pu\u00f2 causare un'eccessiva levigatura -smoothing- e arrotondamento delle parti. Quindi, max_accel dovrebbe essere scelto in modo tale da impedirlo. Un altro parametro che pu\u00f2 influire sul livellamento \u00e8 square_corner_velocity , quindi non \u00e8 consigliabile aumentarlo al di sopra del valore predefinito di 5 mm/sec per evitare un aumento del livellamento smooting. Per selezionare un valore max_accel adatto, ispezionare il modello per lo shaper di input scelto. Per prima cosa, prendi nota a quale accelerazione il ringing \u00e8 ancora piccolo - che ti vada bene. Quindi, controlla la levigatura - smoothing. Per aiutare in questo, il modello di prova ha un piccolo spazio nel muro (0,15 mm): All'aumentare dell'accelerazione, aumenta anche la levigatura-smoothing e lo spazio effettivo nella stampa si allarga: In questa immagine, l'accelerazione aumenta da sinistra a destra e il gap inizia a crescere a partire da 3500 mm/sec^2 (quinta banda da sinistra). Quindi il buon valore per max_accel = 3000 (mm/sec^2) in questo caso per evitare l'eccessivo smoothing. Nota l'accelerazione quando lo spazio \u00e8 ancora molto piccolo nella stampa di prova. Se vedi rigonfiamenti, ma nessun vuoto nel muro, anche ad alte accelerazioni, potrebbe essere dovuto all'avanzamento della pressione disabilitato, specialmente sugli estrusori Bowden. In tal caso, potrebbe essere necessario ripetere la stampa con il PA abilitato. Potrebbe anche essere il risultato di un flusso di filamento non calibrato (troppo alto), quindi \u00e8 una buona idea controllare anche quello. Scegli il minimo tra i due valori di accelerazione (da ringing e smoothing) e inseriscilo come max_accel in printer.cfg. Come nota, pu\u00f2 succedere, specialmente a basse frequenze di ringing, che lo shaper EI provochi un'eccessiva attenuazione anche a basse accelerazioni. In questo caso, MZV potrebbe essere una scelta migliore, perch\u00e9 potrebbe consentire valori di accelerazione pi\u00f9 elevati. A frequenze di ringing molto basse (~25 Hz e inferiori) anche lo shaper MZV pu\u00f2 creare un effetto smussato eccessivo. In tal caso, puoi anche provare a ripetere i passaggi nella sezione Scegliere input shaper con shaper ZV, usando invece il comando SET_INPUT_SHAPER SHAPER_TYPE=ZV . Lo shaper ZV dovrebbe mostrare un livellamento ancora inferiore rispetto a MZV, ma \u00e8 pi\u00f9 sensibile agli errori nella misurazione delle frequenze di ringing. Un'altra considerazione \u00e8 che se una frequenza di risonanza \u00e8 troppo bassa (inferiore a 20-25 Hz), potrebbe essere una buona idea aumentare la rigidit\u00e0 della stampante o ridurre la massa in movimento. In caso contrario, l'accelerazione e la velocit\u00e0 di stampa potrebbero essere limitate a causa di un'eccessivo smoothing invece del ringing. Regolazione fine delle frequenze di risonanza \u00b6 Si noti che la precisione delle misurazioni delle frequenze di risonanza utilizzando il modello di test di ringing \u00e8 sufficiente per la maggior parte degli scopi, quindi si sconsiglia un'ulteriore messa a punto. Se vuoi ancora provare a ricontrollare i tuoi risultati (ad esempio se vedi ancora del ringing dopo aver stampato un modello di prova con un input shaper a tua scelta con le stesse frequenze che hai misurato in precedenza), puoi seguire i passaggi in questo sezione. Nota che se vedi ringing a frequenze diverse dopo aver abilitato [input_shaper], questa sezione non ti aiuter\u00e0. Supponendo di aver suddiviso il modello di ringing con i parametri suggeriti, completare i seguenti passaggi per ciascuno degli assi X e Y: Prepararsi per il test: SET_VELOCITY_LIMIT ACCEL_TO_DECEL=7000 Assicurati che Pressure Advance sia disabilitato: SET_PRESSURE_ADVANCE ADVANCE=0 Eseguire: SET_INPUT_SHAPER SHAPER_TYPE=ZV Dal modello di prova di ringing esistente con lo shaper di input scelto, seleziona l'accelerazione che mostra sufficientemente bene il ringing e impostala con: SET_VELOCITY_LIMIT ACCEL=... Calcola i parametri necessari per il comando TUNING_TOWER per ottimizzare il parametro shaper_freq_x come segue: start = shaper_freq_x * 83 / 132 e factor = shaper_freq_x / 66, dove qui shaper_freq_x \u00e8 il valore corrente in printer.cfg . Eseguire il comando: TUNING_TOWER COMMAND=SET_INPUT_SHAPER PARAMETER=SHAPER_FREQ_X START=start FACTOR=factor BAND=5 usando i valori start e factor calcolati al punto (5). Stampa il modello di prova. Reimposta il valore della frequenza originale: SET_INPUT_SHAPER SHAPER_FREQ_X=... . Trova la fascia che mostra meno ringing e conta il suo numero dal basso partendo da 1. Calcola il nuovo valore shaper_freq_x tramite il vecchio shaper_freq_x * (39 + 5 * #band-number) / 66. Ripetere questi passaggi per l'asse Y allo stesso modo, sostituendo i riferimenti all'asse X con l'asse Y (ad es. sostituire shaper_freq_x con shaper_freq_y nelle formule e nel comando TUNING_TOWER ). Ad esempio, supponiamo di aver misurato la frequenza di ringing per uno degli assi pari a 45 Hz. Questo d\u00e0 start = 45 * 83 / 132 = 28,30 e factor = 45 / 66 = 0,6818 valori per il comando TUNING_TOWER . Supponiamo ora che dopo aver stampato il modello di prova, la quarta fascia dal basso dia il minimo squillo. Questo d\u00e0 lo shaper_freq_^ aggiornato al valore pari a 45 * (39 + 5 * 4) / 66 \u2248 40,23. Dopo aver calcolato entrambi i nuovi parametri shaper_freq_x e shaper_freq_y , puoi aggiornare la sezione [input_shaper] in printer.cfg con i nuovi valori shaper_freq_x e shaper_freq_y . Pressure Advance \u00b6 Se si utilizza Pressure Advance, potrebbe essere necessario risintonizzarlo. Seguire le istruzioni per trovare il nuovo valore, se diverso dal precedente. Assicurati di riavviare Klipper prima di regolare Pressure Advance. Misurazioni inaffidabili delle frequenze di ringing \u00b6 Se non \u00e8 possibile misurare le frequenze di ringing, ad es. se la distanza tra le oscillazioni non \u00e8 stabile, potresti comunque essere in grado di sfruttare le tecniche di input shaping, ma i risultati potrebbero non essere buoni come con misurazioni corrette delle frequenze e richieder\u00e0 un po' pi\u00f9 di messa a punto e stampa del test modello. Si noti che un'altra possibilit\u00e0 \u00e8 acquistare e installare un accelerometro e misurare le risonanze con esso (fare riferimento a docs che descrive l'hardware richiesto e il processo di installazione), ma questa opzione richiede un po' di crimpatura e saldatura. Per l'ottimizzazione, aggiungi la sezione [input_shaper] vuota al tuo printer.cfg . Quindi, supponendo di aver fattolo slicing il modello di ringing con i parametri suggeriti, stampare il modello di prova 3 volte come segue. La prima volta, prima della stampa, eseguire RESTART SET_VELOCITY_LIMIT ACCEL_TO_DECEL=7000 SET_PRESSURE_ADVANCE ADVANCE=0 SET_INPUT_SHAPER SHAPER_TYPE=2HUMP_EI SHAPER_FREQ_X=60 SHAPER_FREQ_Y=60 TUNING_TOWER COMMAND=SET_VELOCITY_LIMIT PARAMETER=ACCEL START=1500 STEP_DELTA=500 STEP_HEIGHT=5 e stampa il modello. Quindi stampare di nuovo il modello, ma prima di eseguire la stampa invece SET_INPUT_SHAPER SHAPER_TYPE=2HUMP_EI SHAPER_FREQ_X=50 SHAPER_FREQ_Y=50 TUNING_TOWER COMMAND=SET_VELOCITY_LIMIT PARAMETER=ACCEL START=1500 STEP_DELTA=500 STEP_HEIGHT=5 Quindi stampa il modello per la terza volta, ma ora esegui SET_INPUT_SHAPER SHAPER_TYPE=2HUMP_EI SHAPER_FREQ_X=40 SHAPER_FREQ_Y=40 TUNING_TOWER COMMAND=SET_VELOCITY_LIMIT PARAMETER=ACCEL START=1500 STEP_DELTA=500 STEP_HEIGHT=5 In sostanza, stiamo stampando il modello di prova di ringing con TUNING_TOWER utilizzando lo shaper 2HUMP_EI con shaper_freq = 60 Hz, 50 Hz e 40 Hz. Se nessuno dei modelli mostra miglioramenti nel ringing, allora, sfortunatamente non sembra che le tecniche di modellazione dell'input possano aiutare con il tuo caso. Altrimenti, \u00e8 possibile che tutti i modelli non mostrino ringing, o alcuni mostrino ringing e altri non cos\u00ec tanto. Scegli il modello di test con la frequenza pi\u00f9 alta che mostra comunque buoni miglioramenti nel ringing. Ad esempio, se i modelli a 40 Hz e 50 Hz non mostrano quasi nessuno ringing e il modello a 60 Hz mostra gi\u00e0 un po' pi\u00f9 di ringing, attenersi a 50 Hz. Ora controlla se lo shaper EI sarebbe abbastanza buono nel tuo caso. Scegli la frequenza dello shaper EI in base alla frequenza dello shaper 2HUMP_EI che hai scelto: Per lo shaper 2HUMP_EI 60 Hz, utilizzare lo shaper EI con shaper_freq = 50 Hz. Per lo shaper 2HUMP_EI 50 Hz, utilizzare lo shaper EI con shaper_freq = 40 Hz. Per lo shaper 2HUMP_EI 40 Hz, utilizzare lo shaper EI con shaper_freq = 33 Hz. Ora stampa il modello di prova ancora una volta, eseguendola SET_INPUT_SHAPER SHAPER_TYPE=EI SHAPER_FREQ_X=... SHAPER_FREQ_Y=... TUNING_TOWER COMMAND=SET_VELOCITY_LIMIT PARAMETER=ACCEL START=1500 STEP_DELTA=500 STEP_HEIGHT=5 fornendo shaper_freq_x=... e shaper_freq_y=... come determinato in precedenza. Se lo shaper EI mostra buoni risultati comparabili con lo shaper 2HUMP_EI, attenersi con lo shaper EI e la frequenza determinata in precedenza, altrimenti utilizzare lo shaper 2HUMP_EI con la frequenza corrispondente. Aggiungi i risultati a printer.cfg come, ad es. [input_shaper] shaper_freq_x: 50 shaper_freq_y: 50 shaper_type: 2hump_ei Continua l'ottimizzazione con la sezione Selecting max_accel . Risoluzione dei problemi e domande frequenti \u00b6 Non riesco a ottenere misurazioni affidabili delle frequenze di risonanza \u00b6 Innanzitutto, assicurati che non ci siano altri problemi con la stampante invece del ringing. Se le misurazioni non sono affidabili perch\u00e9, ad esempio, la distanza tra le oscillazioni non \u00e8 stabile, potrebbe significare che la stampante ha pi\u00f9 frequenze di risonanza sullo stesso asse. Si pu\u00f2 provare a seguire il processo di sintonizzazione descritto nella sezione Misurazioni inaffidabili delle frequenze di ringing e ottenere comunque qualcosa dalla tecnica di modellatura dell'input. Un'altra possibilit\u00e0 \u00e8 installare un accelerometro, misurare le risonanze con esso e regolare automaticamente lo shaper di input utilizzando i risultati di tali misurazioni. Dopo aver abilitato [input_shaper], ottengo parti stampate troppo levigate e i dettagli fini vengono persi \u00b6 Controllare le considerazioni nella sezione Selecting max_accel . Se la frequenza di risonanza \u00e8 bassa, non si dovrebbero impostare max_accel troppo alti o aumentare i parametri square_corner_velocity. Potrebbe anche essere meglio scegliere gli shaper di input MZV o anche ZV su EI (o gli shaper 2HUMP_EI e 3HUMP_EI). Dopo aver stampato correttamente per un po' di tempo senza ringing, sembra tornare \u00b6 \u00c8 possibile che dopo qualche tempo le frequenze di risonanza siano cambiate. Per esempio. forse la tensione delle cinghie \u00e8 cambiata (le cinghie si sono allentate di pi\u00f9), ecc. \u00c8 una buona idea controllare e rimisurare le frequenze di ringing come descritto nella sezione Frequenza di ringing e aggiornare il file di configurazione se necessario . La configurazione a doppio carrello \u00e8 supportata con gli input shaper? \u00b6 Non esiste un supporto dedicato per doppi carrelli con input shaper, ma ci\u00f2 non significa che questa configurazione non funzioner\u00e0. Si dovrebbe eseguire la messa a punto due volte per ciascuno dei carrelli e calcolare le frequenze di ringing per gli assi X e Y per ciascuno dei carrelli in modo indipendente. Quindi inserisci i valori per il carrello 0 nella sezione [input_shaper] e modifica i valori al volo quando si cambiano i carrelli, ad es. come parte di alcune macro: SET_DUAL_CARRIAGE CARRIAGE=1 SET_INPUT_SHAPER SHAPER_FREQ_X=... SHAPER_FREQ_Y=... E allo stesso modo quando si torna al carrello 0. L'input_shaper influisce sul tempo di stampa? \u00b6 No, la funzione input_shaper non ha praticamente alcun impatto sui tempi di stampa da sola. Tuttavia, il valore di max_accel lo fa certamente (regolazione di questo parametro descritta in questa sezione ). Dettagli tecnici \u00b6 Input shaper \u00b6 Gli shaper di input utilizzati in Klipper sono piuttosto standard e si pu\u00f2 trovare una panoramica pi\u00f9 approfondita negli articoli che descrivono gli shaper corrispondenti. Questa sezione contiene una breve panoramica di alcuni aspetti tecnici degli input shaper supportati. La tabella seguente mostra alcuni parametri (solitamente approssimativi) di ciascun shaper. Input shaper Shaper duration Riduzione delle vibrazioni 20x (5% di tolleranza alle vibrazioni) Riduzione delle vibrazioni 10 volte (tolleranza alle vibrazioni del 10%) ZV 0.5 / shaper_freq N/A \u00b1 5% shaper_freq MZV 0.75 / shaper_freq \u00b1 4% shaper_freq -10%...+15% shaper_freq ZVD 1 / shaper_freq \u00b1 15% shaper_freq \u00b1 22% shaper_freq EI 1 / shaper_freq \u00b1 20% shaper_freq \u00b1 25% shaper_freq 2HUMP_EI 1.5 / shaper_freq \u00b1 35% shaper_freq \u00b1 40 shaper_freq 3HUMP_EI 2 / shaper_freq -45...+50% shaper_freq -50%...+55% shaper_freq Una nota sulla riduzione delle vibrazioni: i valori nella tabella sopra sono approssimativi. Se il rapporto di smorzamento della stampante \u00e8 noto per ciascun asse, lo shaper pu\u00f2 essere configurato in modo pi\u00f9 preciso e ridurr\u00e0 quindi le risonanze in una gamma di frequenze leggermente pi\u00f9 ampia. Tuttavia, il rapporto di smorzamento \u00e8 solitamente sconosciuto ed \u00e8 difficile da stimare senza un'attrezzatura speciale, quindi Klipper utilizza il valore 0,1 per impostazione predefinita, che \u00e8 un buon valore a tutto tondo. Le gamme di frequenza nella tabella coprono un numero di diversi possibili rapporti di smorzamento attorno a quel valore (da 0,05 a 0,2 circa). Si noti inoltre che EI, 2HUMP_EI e 3HUMP_EI sono sintonizzati per ridurre le vibrazioni al 5%, quindi i valori per la tolleranza alle vibrazioni del 10% sono forniti solo per riferimento. Come utilizzare questa tabella: La durata dello shaper influisce sull0 smoothing delle parti: pi\u00f9 \u00e8 grande, pi\u00f9 le parti sono lisce. Questa dipendenza non \u00e8 lineare, ma pu\u00f2 dare un'idea di quali shaper \"levigano\" di pi\u00f9 per la stessa frequenza. L'ordinamento per smoothing \u00e8 il seguente: ZV < MZV < ZVD \u2248 EI < 2HUMP_EI < 3HUMP_EI. Inoltre, raramente \u00e8 pratico impostare shaper_freq = resonance freq per gli shaper 2HUMP_EI e 3HUMP_EI (dovrebbero essere usati per ridurre le vibrazioni per diverse frequenze). Si pu\u00f2 stimare una gamma di frequenze in cui lo shaper riduce le vibrazioni. Ad esempio, MZV con shaper_freq = 35 Hz riduce le vibrazioni al 5% per le frequenze [33,6, 36,4] Hz. 3HUMP_EI con shaper_freq = 50 Hz riduce le vibrazioni al 5% nell'intervallo [27,5, 75] Hz. Si pu\u00f2 usare questa tabella per verificare quale shaper dovrebbero usare se hanno bisogno di ridurre le vibrazioni a diverse frequenze. Ad esempio, se si hanno risonanze a 35 Hz e 60 Hz sullo stesso asse: a) EI shaper deve avere shaper_freq = 35 / (1 - 0,2) = 43,75 Hz, e ridurr\u00e0 le risonanze fino a 43,75 * (1 + 0,2 ) = 52,5 Hz, quindi non \u00e8 sufficiente; b) 2HUMP_EI shaper deve avere shaper_freq = 35 / (1 - 0,35) = 53,85 Hz e ridurr\u00e0 le vibrazioni fino a 53,85 * (1 + 0,35) = 72,7 Hz - quindi questa \u00e8 una configurazione accettabile. Cerca sempre di usare shaper_freq il pi\u00f9 alto possibile per un dato shaper (magari con un certo margine di sicurezza, quindi in questo esempio shaper_freq \u2248 50-52 Hz funzionerebbe meglio), e prova a usare uno shaper con la minor durata possibile dello shaper. Se \u00e8 necessario ridurre le vibrazioni a diverse frequenze molto diverse (ad esempio, 30 Hz e 100 Hz), \u00e8 possibile che la tabella sopra non fornisca informazioni sufficienti. In questo caso si pu\u00f2 avere pi\u00f9 fortuna con lo script scripts/graph_shaper.py , che \u00e8 pi\u00f9 flessibile.","title":"Compensazione della risonanza"},{"location":"Resonance_Compensation.html#compensazione-della-risonanza","text":"Klipper supporta Input Shaping, una tecnica che pu\u00f2 essere utilizzata per ridurre il ringing (noti anche come echoing, ghosting o increspature) nelle stampe. Il ringing \u00e8 un difetto di stampa della superficie quando, in genere, elementi come i bordi si ripetono su una superficie stampata come un sottile \"eco\": | | | I ringing sono causati da vibrazioni meccaniche nella stampante dovute a rapidi cambiamenti della direzione di stampa. Si noti che il ringing di solito ha origini meccaniche: telaio della stampante non sufficientemente rigido, cinghie non tese o troppo elastiche, problemi di allineamento delle parti meccaniche, massa in movimento pesante, ecc. Questi dovrebbero essere prima controllati e riparati, se possibile. Input shaping \u00e8 una tecnica di controllo ad anello aperto che crea un segnale di comando che annulla le proprie vibrazioni. La modellatura dell'ingresso richiede alcune regolazioni e misurazioni prima di poter essere abilitata. Oltre al ringing, Input Shaping riduce in genere le vibrazioni e le vibrazioni della stampante in generale e pu\u00f2 anche migliorare l'affidabilit\u00e0 della modalit\u00e0 StealthChop dei driver stepper Trinamic.","title":"Compensazione della risonanza"},{"location":"Resonance_Compensation.html#messa-a-punto","text":"La regolazione di base richiede la misurazione delle frequenze di ringing della stampante stampando un modello di prova. Carica il modello di prova per il ringing, che pu\u00f2 essere trovato in docs/prints/ringing_tower.stl , nello slicer: L'altezza dello strato (layer) consigliata \u00e8 0,2 o 0,25 mm. I livelli di riempimento e superiori possono essere impostati su 0. Usa 1-2 perimetri, o meglio ancora la modalit\u00e0 vaso liscio con base da 1-2 mm. Utilizzare velocit\u00e0 sufficientemente elevate, circa 80-100 mm/sec, per i perimetri esterni . Assicurati che il tempo minimo per lo strato sia al massimo 3 secondi. Assicurati che qualsiasi \"controllo dinamico dell'accelerazione\" sia disabilitato nello slicer. Non girare il modello. Il modello ha segni X e Y sul retro del modello. Nota la posizione insolita dei segni rispetto agli assi della stampante: non \u00e8 un errore. I contrassegni possono essere utilizzati successivamente nel processo di ottimizzazione come riferimento, poich\u00e9 mostrano a quale asse corrispondono le misurazioni.","title":"Messa a punto"},{"location":"Resonance_Compensation.html#frequenza-di-ringing","text":"Innanzitutto, misura la frequenza di ringing . Se il parametro square_corner_velocity \u00e8 stato modificato, ripristinalo a 5.0 . Non \u00e8 consigliabile aumentarlo quando si utilizza l'input shaper perch\u00e9 pu\u00f2 causare un maggiore smussamento smoothing delle parti: \u00e8 invece meglio utilizzare un valore di accelerazione pi\u00f9 elevato. Aumenta max_accel_to_decel inserendo il seguente comando: SET_VELOCITY_LIMIT ACCEL_TO_DECEL=7000 Disabilita la Pressure Advance: SET_PRESSURE_ADVANCE ADVANCE=0 Se hai gi\u00e0 aggiunto la sezione [input_shaper] a printer.cfg, esegui il comando SET_INPUT_SHAPER SHAPER_FREQ_X=0 SHAPER_FREQ_Y=0 . Se ricevi l'errore \"Comando sconosciuto- Unknown command\", puoi tranquillamente ignorarlo a questo punto e continuare con le misurazioni. Eseguire il comando: TUNING_TOWER COMMAND=SET_VELOCITY_LIMIT PARAMETER=ACCEL START=1500 STEP_DELTA=500 STEP_HEIGHT=5 Fondamentalmente, cerchiamo di rendere pi\u00f9 pronunciato il ringing impostando diversi valori elevati per l'accelerazione. Questo comando aumenter\u00e0 l'accelerazione ogni 5 mm a partire da 1500 mm/sec^2: 1500 mm/sec^2, 2000 mm/sec^2, 2500 mm/sec^2 e cos\u00ec via fino a 7000 mm/sec^2 per l'ultima fascia. Stampa il modello di test sliced con i parametri suggeriti. Puoi interrompere la stampa prima se il ringing \u00e8 chiaramente visibile e vedi che l'accelerazione diventa troppo alta per la tua stampante (ad es. la stampante trema troppo o inizia a saltare i passaggi). Utilizzare i segni X e Y sul retro del modello come riferimento. Le misurazioni dal lato con il contrassegno X devono essere utilizzate per la configurazione dell'asse X e il contrassegno Y - per la configurazione dell'asse Y. Misurare la distanza D (in mm) tra pi\u00f9 oscillazioni sulla parte con il segno X, in prossimit\u00e0 delle tacche, preferibilmente saltando la prima o due oscillazioni. Per misurare pi\u00f9 facilmente la distanza tra le oscillazioni, contrassegnare prima le oscillazioni, quindi misurare la distanza tra i segni con un righello o un calibro:| | | Contare a quante oscillazioni N corrisponde la distanza misurata D . Se non sei sicuro di come contare le oscillazioni, fai riferimento all'immagine sopra, che mostra N = 6 oscillazioni. Calcola la frequenza di squillo dell'asse X come V \u00b7 N / D (Hz), dove V \u00e8 la velocit\u00e0 per i perimetri esterni (mm/sec). Per l'esempio sopra, abbiamo contrassegnato 6 oscillazioni e il test \u00e8 stato stampato a una velocit\u00e0 di 100 mm/sec, quindi la frequenza \u00e8 100 * 6 / 12,14 \u2248 49,4 Hz. Esegui (8) - (10) anche per il segno Y. Si noti che il ringing sulla stampa di prova dovrebbe seguire lo schema delle tacche curve, come nell'immagine sopra. In caso contrario, questo difetto non \u00e8 in realt\u00e0 un ringing e ha un'origine diversa: un problema meccanico o dell'estrusore. Dovrebbe essere risolto prima di abilitare e regolare gli shaper di input. Se le misurazioni non sono affidabili perch\u00e9, ad esempio, la distanza tra le oscillazioni non \u00e8 stabile, potrebbe significare che la stampante ha pi\u00f9 frequenze di risonanza sullo stesso asse. Si pu\u00f2 invece provare a seguire il processo di sintonizzazione descritto nella sezione Misurazioni inaffidabili delle frequenze di ringing e ottenere comunque qualcosa dalla tecnica di input shaping . La frequenza dei ringing pu\u00f2 dipendere dalla posizione del modello all'interno della piastra di stampa e dall'altezza Z, soprattutto sulle stampanti delta ; puoi controllare se vedi le differenze di frequenza in diverse posizioni lungo i lati del modello di prova e ad altezze diverse. \u00c8 possibile calcolare le frequenze di squillo medie sugli assi X e Y, se questo \u00e8 il caso. Se la frequenza di ringing misurata \u00e8 molto bassa (inferiore a circa 20-25 Hz), potrebbe essere una buona idea investire nell'irrigidire la stampante o nel diminuire la massa mobile, a seconda di ci\u00f2 che \u00e8 applicabile nel tuo caso, prima di procedere con l'ulteriore input shaping e rimisurare le frequenze in seguito. Per molti modelli di stampanti popolari spesso sono gi\u00e0 disponibili alcune soluzioni. Si noti che le frequenze di ringing possono cambiare se alla stampante vengono apportate modifiche che influiscono sulla massa in movimento o modificano la rigidit\u00e0 del sistema, ad esempio: Alcuni strumenti vengono installati, rimossi o sostituiti sulla testa di stampa che ne modificano la massa, ad es. viene installato un nuovo motore passo-passo (pi\u00f9 pesante o pi\u00f9 leggero) per estrusore diretto o viene installato un nuovo hotend, viene aggiunta una ventola pesante con un condotto, ecc. Le cinghie sono tese. Sono installati alcuni componenti aggiuntivi per aumentare la rigidit\u00e0 del telaio. Un piatto diverso \u00e8 installato su una stampante a piatto mobile o aggiunto un vetro, ecc. Se vengono apportate tali modifiche, \u00e8 una buona idea misurare almeno le frequenze di ringing per vedere se sono cambiate.","title":"Frequenza di ringing"},{"location":"Resonance_Compensation.html#configurazione-del-input-shaper","text":"Dopo aver misurato le frequenze di ringing per gli assi X e Y, puoi aggiungere la seguente sezione al tuo printer.cfg : [input_shaper] shaper_freq_x: ... # frequenza per il segno X del modello di prova shaper_freq_y: ... # frequenza per il segno Y del modello di prova Per l'esempio sopra, otteniamo shaper_freq_x/y = 49.4.","title":"Configurazione del Input shaper"},{"location":"Resonance_Compensation.html#scelta-del-input-shaper","text":"Klipper supporta diversi input shaper. Si differenziano per la loro sensibilit\u00e0 agli errori che determinano la frequenza di risonanza e quanto smussamento provocano nelle parti stampate. Inoltre, alcuni degli shaper come 2HUMP_EI e 3HUMP_EI di solito non dovrebbero essere usati con shaper_freq = frequenza di risonanza: sono configurati in base a diverse considerazioni per ridurre diverse risonanze contemporaneamente. Per la maggior parte delle stampanti, possono essere consigliati shaper MZV o EI. Questa sezione descrive un processo di test per scegliere tra di loro e capire alcuni altri parametri correlati. Stampare il modello di prova di ringing come segue: Riavviare il firmware: RESTART Prepararsi per il test: SET_VELOCITY_LIMIT ACCEL_TO_DECEL=7000 Disabilita la Pressure Advance: SET_PRESSURE_ADVANCE ADVANCE=0 Eseguire: SET_INPUT_SHAPER SHAPER_TYPE=MZV Eseguire il comando: TUNING_TOWER COMMAND=SET_VELOCITY_LIMIT PARAMETER=ACCEL START=1500 STEP_DELTA=500 STEP_HEIGHT=5 Stampa il modello di test sliced con i parametri suggeriti. Se a questo punto non si vede alcun ringing, \u00e8 possibile consigliare l'uso dello shaper MZV. Se vedi dei ringing, rimisura le frequenze usando i passaggi (8)-(10) descritti nella sezione Frequenza ringing . Se le frequenze differiscono in modo significativo dai valori ottenuti in precedenza, \u00e8 necessaria una configurazione dello shaper di input pi\u00f9 complessa. Puoi fare riferimento ai dettagli tecnici della sezione Input shapers . In caso contrario, procedere al passaggio successivo. Ora prova l'input shaper EI. Per provarlo, ripeti i passaggi (1)-(6) da sopra, ma eseguendo invece al passaggio 4 il seguente comando : SET_INPUT_SHAPER SHAPER_TYPE=EI . Confronta due stampe con input shaper MZV e EI. Se EI mostra risultati notevolmente migliori rispetto a MZV, utilizzare EI shaper, altrimenti preferire MZV. Si noti che lo shaper EI causer\u00e0 una maggiore levigatura 'smoothing' nelle parti stampate (vedere la sezione successiva per ulteriori dettagli). Aggiungi il parametro shaper_type: mzv (o ei) alla sezione [input_shaper], ad esempio: [input_shaper] shaper_freq_x: ... shaper_freq_y: ... shaper_type: mzv Alcune note sulla scelta dello shaper: Lo shaper EI pu\u00f2 essere pi\u00f9 adatto per le stampanti a piatto mobile (se la frequenza di risonanza e il conseguente livellamento lo consentono): man mano che si deposita pi\u00f9 filamento sul piatto mobile, la massa del piatto aumenta e la frequenza di risonanza diminuisce. Poich\u00e9 lo shaper EI \u00e8 pi\u00f9 robusto alle variazioni della frequenza di risonanza, potrebbe funzionare meglio quando si stampano parti di grandi dimensioni. A causa della natura della cinematica delta, le frequenze di risonanza possono differire molto in diverse parti del volume di costruzione. Pertanto, lo shaper EI pu\u00f2 adattarsi meglio alle stampanti delta piuttosto che a MZV o ZV e dovrebbe essere considerato per l'uso. Se la frequenza di risonanza \u00e8 sufficientemente grande (pi\u00f9 di 50-60 Hz), si pu\u00f2 anche provare a testare lo shaper 2HUMP_EI (eseguendo il test suggerito sopra con SET_INPUT_SHAPER SHAPER_TYPE=2HUMP_EI ), ma controllare le considerazioni nella sezione sotto prima di abilitarlo.","title":"Scelta del input shaper"},{"location":"Resonance_Compensation.html#seleziona-max_accel","text":"Dovresti avere un test stampato per lo shaper che hai scelto dal passaggio precedente (se non lo fai, stampa il modello di test affettato con i parametri suggeriti con l'anticipo di pressione disabilitato SET_PRESSURE_ADVANCE ADVANCE=0 e con la torre di regolazione abilitata come TUNING_TOWER COMMAND=SET_VELOCITY_LIMIT PARAMETER=ACCEL START=1500 STEP_DELTA=500 STEP_HEIGHT=5 ). Si noti che ad accelerazioni molto elevate, a seconda della frequenza di risonanza e dell'input shaper scelto (ad es. EI shaper crea pi\u00f9 smussamento di MZV), l'input shaping pu\u00f2 causare un'eccessiva levigatura -smoothing- e arrotondamento delle parti. Quindi, max_accel dovrebbe essere scelto in modo tale da impedirlo. Un altro parametro che pu\u00f2 influire sul livellamento \u00e8 square_corner_velocity , quindi non \u00e8 consigliabile aumentarlo al di sopra del valore predefinito di 5 mm/sec per evitare un aumento del livellamento smooting. Per selezionare un valore max_accel adatto, ispezionare il modello per lo shaper di input scelto. Per prima cosa, prendi nota a quale accelerazione il ringing \u00e8 ancora piccolo - che ti vada bene. Quindi, controlla la levigatura - smoothing. Per aiutare in questo, il modello di prova ha un piccolo spazio nel muro (0,15 mm): All'aumentare dell'accelerazione, aumenta anche la levigatura-smoothing e lo spazio effettivo nella stampa si allarga: In questa immagine, l'accelerazione aumenta da sinistra a destra e il gap inizia a crescere a partire da 3500 mm/sec^2 (quinta banda da sinistra). Quindi il buon valore per max_accel = 3000 (mm/sec^2) in questo caso per evitare l'eccessivo smoothing. Nota l'accelerazione quando lo spazio \u00e8 ancora molto piccolo nella stampa di prova. Se vedi rigonfiamenti, ma nessun vuoto nel muro, anche ad alte accelerazioni, potrebbe essere dovuto all'avanzamento della pressione disabilitato, specialmente sugli estrusori Bowden. In tal caso, potrebbe essere necessario ripetere la stampa con il PA abilitato. Potrebbe anche essere il risultato di un flusso di filamento non calibrato (troppo alto), quindi \u00e8 una buona idea controllare anche quello. Scegli il minimo tra i due valori di accelerazione (da ringing e smoothing) e inseriscilo come max_accel in printer.cfg. Come nota, pu\u00f2 succedere, specialmente a basse frequenze di ringing, che lo shaper EI provochi un'eccessiva attenuazione anche a basse accelerazioni. In questo caso, MZV potrebbe essere una scelta migliore, perch\u00e9 potrebbe consentire valori di accelerazione pi\u00f9 elevati. A frequenze di ringing molto basse (~25 Hz e inferiori) anche lo shaper MZV pu\u00f2 creare un effetto smussato eccessivo. In tal caso, puoi anche provare a ripetere i passaggi nella sezione Scegliere input shaper con shaper ZV, usando invece il comando SET_INPUT_SHAPER SHAPER_TYPE=ZV . Lo shaper ZV dovrebbe mostrare un livellamento ancora inferiore rispetto a MZV, ma \u00e8 pi\u00f9 sensibile agli errori nella misurazione delle frequenze di ringing. Un'altra considerazione \u00e8 che se una frequenza di risonanza \u00e8 troppo bassa (inferiore a 20-25 Hz), potrebbe essere una buona idea aumentare la rigidit\u00e0 della stampante o ridurre la massa in movimento. In caso contrario, l'accelerazione e la velocit\u00e0 di stampa potrebbero essere limitate a causa di un'eccessivo smoothing invece del ringing.","title":"Seleziona max_accel"},{"location":"Resonance_Compensation.html#regolazione-fine-delle-frequenze-di-risonanza","text":"Si noti che la precisione delle misurazioni delle frequenze di risonanza utilizzando il modello di test di ringing \u00e8 sufficiente per la maggior parte degli scopi, quindi si sconsiglia un'ulteriore messa a punto. Se vuoi ancora provare a ricontrollare i tuoi risultati (ad esempio se vedi ancora del ringing dopo aver stampato un modello di prova con un input shaper a tua scelta con le stesse frequenze che hai misurato in precedenza), puoi seguire i passaggi in questo sezione. Nota che se vedi ringing a frequenze diverse dopo aver abilitato [input_shaper], questa sezione non ti aiuter\u00e0. Supponendo di aver suddiviso il modello di ringing con i parametri suggeriti, completare i seguenti passaggi per ciascuno degli assi X e Y: Prepararsi per il test: SET_VELOCITY_LIMIT ACCEL_TO_DECEL=7000 Assicurati che Pressure Advance sia disabilitato: SET_PRESSURE_ADVANCE ADVANCE=0 Eseguire: SET_INPUT_SHAPER SHAPER_TYPE=ZV Dal modello di prova di ringing esistente con lo shaper di input scelto, seleziona l'accelerazione che mostra sufficientemente bene il ringing e impostala con: SET_VELOCITY_LIMIT ACCEL=... Calcola i parametri necessari per il comando TUNING_TOWER per ottimizzare il parametro shaper_freq_x come segue: start = shaper_freq_x * 83 / 132 e factor = shaper_freq_x / 66, dove qui shaper_freq_x \u00e8 il valore corrente in printer.cfg . Eseguire il comando: TUNING_TOWER COMMAND=SET_INPUT_SHAPER PARAMETER=SHAPER_FREQ_X START=start FACTOR=factor BAND=5 usando i valori start e factor calcolati al punto (5). Stampa il modello di prova. Reimposta il valore della frequenza originale: SET_INPUT_SHAPER SHAPER_FREQ_X=... . Trova la fascia che mostra meno ringing e conta il suo numero dal basso partendo da 1. Calcola il nuovo valore shaper_freq_x tramite il vecchio shaper_freq_x * (39 + 5 * #band-number) / 66. Ripetere questi passaggi per l'asse Y allo stesso modo, sostituendo i riferimenti all'asse X con l'asse Y (ad es. sostituire shaper_freq_x con shaper_freq_y nelle formule e nel comando TUNING_TOWER ). Ad esempio, supponiamo di aver misurato la frequenza di ringing per uno degli assi pari a 45 Hz. Questo d\u00e0 start = 45 * 83 / 132 = 28,30 e factor = 45 / 66 = 0,6818 valori per il comando TUNING_TOWER . Supponiamo ora che dopo aver stampato il modello di prova, la quarta fascia dal basso dia il minimo squillo. Questo d\u00e0 lo shaper_freq_^ aggiornato al valore pari a 45 * (39 + 5 * 4) / 66 \u2248 40,23. Dopo aver calcolato entrambi i nuovi parametri shaper_freq_x e shaper_freq_y , puoi aggiornare la sezione [input_shaper] in printer.cfg con i nuovi valori shaper_freq_x e shaper_freq_y .","title":"Regolazione fine delle frequenze di risonanza"},{"location":"Resonance_Compensation.html#pressure-advance","text":"Se si utilizza Pressure Advance, potrebbe essere necessario risintonizzarlo. Seguire le istruzioni per trovare il nuovo valore, se diverso dal precedente. Assicurati di riavviare Klipper prima di regolare Pressure Advance.","title":"Pressure Advance"},{"location":"Resonance_Compensation.html#misurazioni-inaffidabili-delle-frequenze-di-ringing","text":"Se non \u00e8 possibile misurare le frequenze di ringing, ad es. se la distanza tra le oscillazioni non \u00e8 stabile, potresti comunque essere in grado di sfruttare le tecniche di input shaping, ma i risultati potrebbero non essere buoni come con misurazioni corrette delle frequenze e richieder\u00e0 un po' pi\u00f9 di messa a punto e stampa del test modello. Si noti che un'altra possibilit\u00e0 \u00e8 acquistare e installare un accelerometro e misurare le risonanze con esso (fare riferimento a docs che descrive l'hardware richiesto e il processo di installazione), ma questa opzione richiede un po' di crimpatura e saldatura. Per l'ottimizzazione, aggiungi la sezione [input_shaper] vuota al tuo printer.cfg . Quindi, supponendo di aver fattolo slicing il modello di ringing con i parametri suggeriti, stampare il modello di prova 3 volte come segue. La prima volta, prima della stampa, eseguire RESTART SET_VELOCITY_LIMIT ACCEL_TO_DECEL=7000 SET_PRESSURE_ADVANCE ADVANCE=0 SET_INPUT_SHAPER SHAPER_TYPE=2HUMP_EI SHAPER_FREQ_X=60 SHAPER_FREQ_Y=60 TUNING_TOWER COMMAND=SET_VELOCITY_LIMIT PARAMETER=ACCEL START=1500 STEP_DELTA=500 STEP_HEIGHT=5 e stampa il modello. Quindi stampare di nuovo il modello, ma prima di eseguire la stampa invece SET_INPUT_SHAPER SHAPER_TYPE=2HUMP_EI SHAPER_FREQ_X=50 SHAPER_FREQ_Y=50 TUNING_TOWER COMMAND=SET_VELOCITY_LIMIT PARAMETER=ACCEL START=1500 STEP_DELTA=500 STEP_HEIGHT=5 Quindi stampa il modello per la terza volta, ma ora esegui SET_INPUT_SHAPER SHAPER_TYPE=2HUMP_EI SHAPER_FREQ_X=40 SHAPER_FREQ_Y=40 TUNING_TOWER COMMAND=SET_VELOCITY_LIMIT PARAMETER=ACCEL START=1500 STEP_DELTA=500 STEP_HEIGHT=5 In sostanza, stiamo stampando il modello di prova di ringing con TUNING_TOWER utilizzando lo shaper 2HUMP_EI con shaper_freq = 60 Hz, 50 Hz e 40 Hz. Se nessuno dei modelli mostra miglioramenti nel ringing, allora, sfortunatamente non sembra che le tecniche di modellazione dell'input possano aiutare con il tuo caso. Altrimenti, \u00e8 possibile che tutti i modelli non mostrino ringing, o alcuni mostrino ringing e altri non cos\u00ec tanto. Scegli il modello di test con la frequenza pi\u00f9 alta che mostra comunque buoni miglioramenti nel ringing. Ad esempio, se i modelli a 40 Hz e 50 Hz non mostrano quasi nessuno ringing e il modello a 60 Hz mostra gi\u00e0 un po' pi\u00f9 di ringing, attenersi a 50 Hz. Ora controlla se lo shaper EI sarebbe abbastanza buono nel tuo caso. Scegli la frequenza dello shaper EI in base alla frequenza dello shaper 2HUMP_EI che hai scelto: Per lo shaper 2HUMP_EI 60 Hz, utilizzare lo shaper EI con shaper_freq = 50 Hz. Per lo shaper 2HUMP_EI 50 Hz, utilizzare lo shaper EI con shaper_freq = 40 Hz. Per lo shaper 2HUMP_EI 40 Hz, utilizzare lo shaper EI con shaper_freq = 33 Hz. Ora stampa il modello di prova ancora una volta, eseguendola SET_INPUT_SHAPER SHAPER_TYPE=EI SHAPER_FREQ_X=... SHAPER_FREQ_Y=... TUNING_TOWER COMMAND=SET_VELOCITY_LIMIT PARAMETER=ACCEL START=1500 STEP_DELTA=500 STEP_HEIGHT=5 fornendo shaper_freq_x=... e shaper_freq_y=... come determinato in precedenza. Se lo shaper EI mostra buoni risultati comparabili con lo shaper 2HUMP_EI, attenersi con lo shaper EI e la frequenza determinata in precedenza, altrimenti utilizzare lo shaper 2HUMP_EI con la frequenza corrispondente. Aggiungi i risultati a printer.cfg come, ad es. [input_shaper] shaper_freq_x: 50 shaper_freq_y: 50 shaper_type: 2hump_ei Continua l'ottimizzazione con la sezione Selecting max_accel .","title":"Misurazioni inaffidabili delle frequenze di ringing"},{"location":"Resonance_Compensation.html#risoluzione-dei-problemi-e-domande-frequenti","text":"","title":"Risoluzione dei problemi e domande frequenti"},{"location":"Resonance_Compensation.html#non-riesco-a-ottenere-misurazioni-affidabili-delle-frequenze-di-risonanza","text":"Innanzitutto, assicurati che non ci siano altri problemi con la stampante invece del ringing. Se le misurazioni non sono affidabili perch\u00e9, ad esempio, la distanza tra le oscillazioni non \u00e8 stabile, potrebbe significare che la stampante ha pi\u00f9 frequenze di risonanza sullo stesso asse. Si pu\u00f2 provare a seguire il processo di sintonizzazione descritto nella sezione Misurazioni inaffidabili delle frequenze di ringing e ottenere comunque qualcosa dalla tecnica di modellatura dell'input. Un'altra possibilit\u00e0 \u00e8 installare un accelerometro, misurare le risonanze con esso e regolare automaticamente lo shaper di input utilizzando i risultati di tali misurazioni.","title":"Non riesco a ottenere misurazioni affidabili delle frequenze di risonanza"},{"location":"Resonance_Compensation.html#dopo-aver-abilitato-input_shaper-ottengo-parti-stampate-troppo-levigate-e-i-dettagli-fini-vengono-persi","text":"Controllare le considerazioni nella sezione Selecting max_accel . Se la frequenza di risonanza \u00e8 bassa, non si dovrebbero impostare max_accel troppo alti o aumentare i parametri square_corner_velocity. Potrebbe anche essere meglio scegliere gli shaper di input MZV o anche ZV su EI (o gli shaper 2HUMP_EI e 3HUMP_EI).","title":"Dopo aver abilitato [input_shaper], ottengo parti stampate troppo levigate e i dettagli fini vengono persi"},{"location":"Resonance_Compensation.html#dopo-aver-stampato-correttamente-per-un-po-di-tempo-senza-ringing-sembra-tornare","text":"\u00c8 possibile che dopo qualche tempo le frequenze di risonanza siano cambiate. Per esempio. forse la tensione delle cinghie \u00e8 cambiata (le cinghie si sono allentate di pi\u00f9), ecc. \u00c8 una buona idea controllare e rimisurare le frequenze di ringing come descritto nella sezione Frequenza di ringing e aggiornare il file di configurazione se necessario .","title":"Dopo aver stampato correttamente per un po' di tempo senza ringing, sembra tornare"},{"location":"Resonance_Compensation.html#la-configurazione-a-doppio-carrello-e-supportata-con-gli-input-shaper","text":"Non esiste un supporto dedicato per doppi carrelli con input shaper, ma ci\u00f2 non significa che questa configurazione non funzioner\u00e0. Si dovrebbe eseguire la messa a punto due volte per ciascuno dei carrelli e calcolare le frequenze di ringing per gli assi X e Y per ciascuno dei carrelli in modo indipendente. Quindi inserisci i valori per il carrello 0 nella sezione [input_shaper] e modifica i valori al volo quando si cambiano i carrelli, ad es. come parte di alcune macro: SET_DUAL_CARRIAGE CARRIAGE=1 SET_INPUT_SHAPER SHAPER_FREQ_X=... SHAPER_FREQ_Y=... E allo stesso modo quando si torna al carrello 0.","title":"La configurazione a doppio carrello \u00e8 supportata con gli input shaper?"},{"location":"Resonance_Compensation.html#linput_shaper-influisce-sul-tempo-di-stampa","text":"No, la funzione input_shaper non ha praticamente alcun impatto sui tempi di stampa da sola. Tuttavia, il valore di max_accel lo fa certamente (regolazione di questo parametro descritta in questa sezione ).","title":"L'input_shaper influisce sul tempo di stampa?"},{"location":"Resonance_Compensation.html#dettagli-tecnici","text":"","title":"Dettagli tecnici"},{"location":"Resonance_Compensation.html#input-shaper","text":"Gli shaper di input utilizzati in Klipper sono piuttosto standard e si pu\u00f2 trovare una panoramica pi\u00f9 approfondita negli articoli che descrivono gli shaper corrispondenti. Questa sezione contiene una breve panoramica di alcuni aspetti tecnici degli input shaper supportati. La tabella seguente mostra alcuni parametri (solitamente approssimativi) di ciascun shaper. Input shaper Shaper duration Riduzione delle vibrazioni 20x (5% di tolleranza alle vibrazioni) Riduzione delle vibrazioni 10 volte (tolleranza alle vibrazioni del 10%) ZV 0.5 / shaper_freq N/A \u00b1 5% shaper_freq MZV 0.75 / shaper_freq \u00b1 4% shaper_freq -10%...+15% shaper_freq ZVD 1 / shaper_freq \u00b1 15% shaper_freq \u00b1 22% shaper_freq EI 1 / shaper_freq \u00b1 20% shaper_freq \u00b1 25% shaper_freq 2HUMP_EI 1.5 / shaper_freq \u00b1 35% shaper_freq \u00b1 40 shaper_freq 3HUMP_EI 2 / shaper_freq -45...+50% shaper_freq -50%...+55% shaper_freq Una nota sulla riduzione delle vibrazioni: i valori nella tabella sopra sono approssimativi. Se il rapporto di smorzamento della stampante \u00e8 noto per ciascun asse, lo shaper pu\u00f2 essere configurato in modo pi\u00f9 preciso e ridurr\u00e0 quindi le risonanze in una gamma di frequenze leggermente pi\u00f9 ampia. Tuttavia, il rapporto di smorzamento \u00e8 solitamente sconosciuto ed \u00e8 difficile da stimare senza un'attrezzatura speciale, quindi Klipper utilizza il valore 0,1 per impostazione predefinita, che \u00e8 un buon valore a tutto tondo. Le gamme di frequenza nella tabella coprono un numero di diversi possibili rapporti di smorzamento attorno a quel valore (da 0,05 a 0,2 circa). Si noti inoltre che EI, 2HUMP_EI e 3HUMP_EI sono sintonizzati per ridurre le vibrazioni al 5%, quindi i valori per la tolleranza alle vibrazioni del 10% sono forniti solo per riferimento. Come utilizzare questa tabella: La durata dello shaper influisce sull0 smoothing delle parti: pi\u00f9 \u00e8 grande, pi\u00f9 le parti sono lisce. Questa dipendenza non \u00e8 lineare, ma pu\u00f2 dare un'idea di quali shaper \"levigano\" di pi\u00f9 per la stessa frequenza. L'ordinamento per smoothing \u00e8 il seguente: ZV < MZV < ZVD \u2248 EI < 2HUMP_EI < 3HUMP_EI. Inoltre, raramente \u00e8 pratico impostare shaper_freq = resonance freq per gli shaper 2HUMP_EI e 3HUMP_EI (dovrebbero essere usati per ridurre le vibrazioni per diverse frequenze). Si pu\u00f2 stimare una gamma di frequenze in cui lo shaper riduce le vibrazioni. Ad esempio, MZV con shaper_freq = 35 Hz riduce le vibrazioni al 5% per le frequenze [33,6, 36,4] Hz. 3HUMP_EI con shaper_freq = 50 Hz riduce le vibrazioni al 5% nell'intervallo [27,5, 75] Hz. Si pu\u00f2 usare questa tabella per verificare quale shaper dovrebbero usare se hanno bisogno di ridurre le vibrazioni a diverse frequenze. Ad esempio, se si hanno risonanze a 35 Hz e 60 Hz sullo stesso asse: a) EI shaper deve avere shaper_freq = 35 / (1 - 0,2) = 43,75 Hz, e ridurr\u00e0 le risonanze fino a 43,75 * (1 + 0,2 ) = 52,5 Hz, quindi non \u00e8 sufficiente; b) 2HUMP_EI shaper deve avere shaper_freq = 35 / (1 - 0,35) = 53,85 Hz e ridurr\u00e0 le vibrazioni fino a 53,85 * (1 + 0,35) = 72,7 Hz - quindi questa \u00e8 una configurazione accettabile. Cerca sempre di usare shaper_freq il pi\u00f9 alto possibile per un dato shaper (magari con un certo margine di sicurezza, quindi in questo esempio shaper_freq \u2248 50-52 Hz funzionerebbe meglio), e prova a usare uno shaper con la minor durata possibile dello shaper. Se \u00e8 necessario ridurre le vibrazioni a diverse frequenze molto diverse (ad esempio, 30 Hz e 100 Hz), \u00e8 possibile che la tabella sopra non fornisca informazioni sufficienti. In questo caso si pu\u00f2 avere pi\u00f9 fortuna con lo script scripts/graph_shaper.py , che \u00e8 pi\u00f9 flessibile.","title":"Input shaper"},{"location":"Rotation_Distance.html","text":"Rotation distance \u00b6 I driver per motori passo-passo su Klipper richiedono un parametro rotation_distance in ciascuna stepper config section . La distanza_rotazione \u00e8 la distanza percorsa dall'asse con un giro completo del motore passo-passo relativo. Questo documento descrive come configurare questo valore. Ottenere rotation_distance da steps_per_mm (o step_distance) \u00b6 I progettisti della tua stampante 3d hanno originariamente calcolato steps_per_mm da una distanza di rotazione. Se conosci i passi_per_mm, \u00e8 possibile utilizzare questa formula generale per ottenere la distanza di rotazione originale: rotation_distance = <passi_completi_per_rotazione> * <micropassi> / <passi_per_mm> Oppure, se hai una configurazione di Klipper precedente e conosci il parametro step_distance puoi usare questa formula: rotation_distance = <passi_completi_per_rotazione> * <micropassi> * <distanza_passo> L'impostazione <full_steps_per_rotation> \u00e8 determinata dal tipo di motore passo-passo. La maggior parte dei motori passo-passo sono \"passi passo a 1,8 gradi\" e quindi hanno 200 passi completi per rotazione (360 diviso 1,8 fa 200). Alcuni motori passo passo sono \"passo passo a 0,9 gradi\" e quindi hanno 400 passi completi per rotazione. Altri motori passo-passo sono rari. In caso di dubbi, non impostare full_steps_per_rotation nel file di configurazione e utilizzare 200 nella formula sopra. L'impostazione <microsteps> \u00e8 determinata dal driver del motore passo-passo. La maggior parte dei driver utilizza 16 micropassi. Se non sei sicuro, imposta microsteps: 16 nella configurazione e usa 16 nella formula sopra. Quasi tutte le stampanti dovrebbero avere un numero intero per rotation_distance sugli assi di tipo X, Y e Z. Se la formula precedente risulta in una distanza_rotazione che \u00e8 entro .01 da un numero intero, arrotonda il valore finale a quel numero_intero. Calibrazione rotation_distance sugli estrusori \u00b6 Su un estrusore, la rotation_distance \u00e8 la distanza percorsa dal filamento per una rotazione completa del motore passo-passo. Il modo migliore per ottenere un valore accurato per questa impostazione \u00e8 utilizzare una procedura di \"misura e ritaglio\". Innanzitutto inizia con un'ipotesi iniziale per la distanza di rotazione. Questo pu\u00f2 essere ottenuto da steps_per_mm o ispezionando l'hardware . Quindi utilizzare la seguente procedura per \"misurare e tagliare\": Assicurati che l'estrusore contenga del filamento, che l'hotend sia riscaldato a una temperatura appropriata e che la stampante sia pronta per l'estrusione. Utilizzare un pennarello per posizionare un segno sul filamento a circa 70 mm dall'ingresso del corpo dell'estrusore. Quindi usa un calibro digitale per misurare la distanza effettiva di quel segno nel modo pi\u00f9 preciso possibile. Nota questo come <initial_mark_distance> . Estrudere 50 mm di filamento con la seguente sequenza di comandi: G91 seguito da G1 E50 F60 . Nota 50 mm come <distanza_estrusione_richiesta> . Attendi che l'estrusore finisca il movimento (ci vorranno circa 50 secondi). \u00c8 importante utilizzare la velocit\u00e0 di estrusione lenta per questo test poich\u00e9 una velocit\u00e0 pi\u00f9 elevata pu\u00f2 causare una pressione elevata nell'estrusore che distorce i risultati. (Non utilizzare il \"pulsante estrudi\" sui front-end grafici per questo test poich\u00e9 si estrudono a una velocit\u00e0 elevata.) Utilizzare un calibro digitale per misurare la nuova distanza tra il corpo dell'estrusore e il segno sul filamento. Annota questa come <subsequent_mark_distance> . Quindi calcola: actual_extrude_distance = <initial_mark_distance> - <subsequent_mark_distance> Calcola rotation_distance come: rotation_distance = <rotation_distance_precedente> * <actual_extrude_distance> / <requested_extrude_distance> Arrotonda la nuova rotation_distance a tre cifre decimali. Se la distanza_di_estrusione effettiva differisce dalla distanza_di_estrusione richiesta di oltre 2 mm circa, \u00e8 una buona idea eseguire i passaggi precedenti una seconda volta. Nota: non utilizzare un metodo di tipo \"misura e ritaglia\" per calibrare gli assi di tipo x, y o z. Il metodo \"misura e taglia\" non \u00e8 sufficientemente accurato per quegli assi e probabilmente porter\u00e0 a una configurazione peggiore. Invece, se necessario, quegli assi possono essere determinati measuring the belts, pulleys, and lead screw hardware . Ottenere la rotation_distance ispezionando l'hardware \u00b6 E' possibile calcolare rotation_distance conoscendo i motori passo-passo e la cinematica della stampante. Questo pu\u00f2 essere utile se i passi_per_mm non sono noti o se si sta progettando una nuova stampante. Assi con trasmissione a cinghia \u00b6 \u00c8 facile calcolare rotation_distance per un asse lineare che utilizza una cinghia e una puleggia. Per prima cosa determinare il tipo di cinghia. La maggior parte delle stampanti utilizza un passo della cinghia di 2 mm (ovvero, ogni dente sulla cinghia \u00e8 a 2 mm di distanza). Quindi contare il numero di denti sulla puleggia del motore passo-passo. La distanza_rotazione viene quindi calcolata come: rotation_distance = <passo_cinghia> * <numero_di_denti_sulla_puleggia> Ad esempio, se una stampante ha una cinghia da 2 mm e utilizza una puleggia con 20 denti, la distanza di rotazione \u00e8 40. Assi con vite di comando \u00b6 \u00c8 facile calcolare la rotation_distance per le comuni viti di trasmissione utilizzando la seguente formula: rotation_distance = <passo_vite> * <numero_di_filetti_separati> Ad esempio, la comune \"madrevite T8\" ha una rotation distance di 8 (ha un passo di 2 mm e ha 4 filetti separati). Le stampanti pi\u00f9 vecchie con \"barre filettate\" hanno un solo \"filo\" sulla vite di comando e quindi la rotation distance \u00e8 il passo della vite. (Il passo della vite \u00e8 la distanza tra ciascuna scanalatura sulla vite.) Quindi, ad esempio, un'asta metrica M6 ha una rotation distance di 1 e un'asta M8 ha una rotation distance di 1,25. Estrusore \u00b6 \u00c8 possibile ottenere una distanza di rotazione iniziale per gli estrusori misurando il diametro del \"bullone dentato\" che spinge il filamento e utilizzando la seguente formula: rotation_distance = <diametro> * 3.14 Se l'estrusore utilizza ingranaggi, sar\u00e0 anche necessario determinare e impostare gear_ratio per l'estrusore. La rotation distance effettiva su un estrusore varier\u00e0 da stampante a stampante, perch\u00e9 la presa del \"bullone dentato\" che impegna il filamento pu\u00f2 variare. Pu\u00f2 anche variare tra le bobine di filamento. Dopo aver ottenuto una rotation distance iniziale, utilizzare la procedura di misurazione e ritaglio per ottenere un'impostazione pi\u00f9 accurata. Usando un gear_ratio \u00b6 L'impostazione di un gear_ratio pu\u00f2 semplificare la configurazione di rotation_distance su stepper a cui \u00e8 collegato un gear box (o simile). La maggior parte degli stepper non ha un gear box - se non sei sicuro, non impostare gear_ratio nella configurazione. Quando gear_ratio \u00e8 impostato, rotation_distance rappresenta la distanza percorsa dall'asse con una rotazione completa dell'ingranaggio finale sulla scatola ingranaggi. Se, ad esempio, si utilizza un riduttore con un rapporto \"5:1\", \u00e8 possibile calcolare la distanza_rotazione con conoscenza dell'hardware e quindi aggiungere gear_ratio: 5:1 alla configurazione. Per gli ingranaggi realizzati con cinghie e pulegge, \u00e8 possibile determinare il gear_ratio contando i denti sulle pulegge. Ad esempio, se uno stepper con una puleggia a 16 denti guida la puleggia successiva con 80 denti, si utilizzer\u00e0 gear_ratio: 80:16 . In effetti, si potrebbe aprire una comune \"scatola del cambio\" pronta all'uso e contare i denti al suo interno per confermare il suo rapporto di trasmissione. Si noti che a volte un gear-box avr\u00e0 un rapporto di trasmissione leggermente diverso da quello in cui \u00e8 pubblicizzato. I comuni ingranaggi del motore dell'estrusore BMG ne sono un esempio: sono pubblicizzati come \"3:1\" ma in realt\u00e0 utilizzano ingranaggi \"50:17\". (L'uso di numeri di denti senza un denominatore comune pu\u00f2 migliorare l'usura complessiva degli ingranaggi poich\u00e9 i denti non sempre ingranano allo stesso modo ad ogni giro.) Il comune \"riduttore epicicloidale 5.18:1\" \u00e8 configurato in modo pi\u00f9 accurato con gear_ratio: 57:11 . Se su un asse vengono utilizzati pi\u00f9 ingranaggi, \u00e8 possibile fornire un elenco separato da virgole nel gear_ratio. Ad esempio, un cambio \"5:1\" che guida una puleggia da 16 a 80 denti potrebbe utilizzare gear_ratio: 5:1, 80:16 . Nella maggior parte dei casi, gear_ratio dovrebbe essere definito con numeri interi poich\u00e9 ingranaggi e pulegge comuni hanno un numero intero di denti su di essi. Tuttavia, nei casi in cui una cinghia aziona una puleggia usando l'attrito invece dei denti, pu\u00f2 avere senso utilizzare un numero in virgola mobile nel rapporto di trasmissione (ad esempio, gear_ratio: 107.237:16 ).","title":"Rotation distance"},{"location":"Rotation_Distance.html#rotation-distance","text":"I driver per motori passo-passo su Klipper richiedono un parametro rotation_distance in ciascuna stepper config section . La distanza_rotazione \u00e8 la distanza percorsa dall'asse con un giro completo del motore passo-passo relativo. Questo documento descrive come configurare questo valore.","title":"Rotation distance"},{"location":"Rotation_Distance.html#ottenere-rotation_distance-da-steps_per_mm-o-step_distance","text":"I progettisti della tua stampante 3d hanno originariamente calcolato steps_per_mm da una distanza di rotazione. Se conosci i passi_per_mm, \u00e8 possibile utilizzare questa formula generale per ottenere la distanza di rotazione originale: rotation_distance = <passi_completi_per_rotazione> * <micropassi> / <passi_per_mm> Oppure, se hai una configurazione di Klipper precedente e conosci il parametro step_distance puoi usare questa formula: rotation_distance = <passi_completi_per_rotazione> * <micropassi> * <distanza_passo> L'impostazione <full_steps_per_rotation> \u00e8 determinata dal tipo di motore passo-passo. La maggior parte dei motori passo-passo sono \"passi passo a 1,8 gradi\" e quindi hanno 200 passi completi per rotazione (360 diviso 1,8 fa 200). Alcuni motori passo passo sono \"passo passo a 0,9 gradi\" e quindi hanno 400 passi completi per rotazione. Altri motori passo-passo sono rari. In caso di dubbi, non impostare full_steps_per_rotation nel file di configurazione e utilizzare 200 nella formula sopra. L'impostazione <microsteps> \u00e8 determinata dal driver del motore passo-passo. La maggior parte dei driver utilizza 16 micropassi. Se non sei sicuro, imposta microsteps: 16 nella configurazione e usa 16 nella formula sopra. Quasi tutte le stampanti dovrebbero avere un numero intero per rotation_distance sugli assi di tipo X, Y e Z. Se la formula precedente risulta in una distanza_rotazione che \u00e8 entro .01 da un numero intero, arrotonda il valore finale a quel numero_intero.","title":"Ottenere rotation_distance da steps_per_mm (o step_distance)"},{"location":"Rotation_Distance.html#calibrazione-rotation_distance-sugli-estrusori","text":"Su un estrusore, la rotation_distance \u00e8 la distanza percorsa dal filamento per una rotazione completa del motore passo-passo. Il modo migliore per ottenere un valore accurato per questa impostazione \u00e8 utilizzare una procedura di \"misura e ritaglio\". Innanzitutto inizia con un'ipotesi iniziale per la distanza di rotazione. Questo pu\u00f2 essere ottenuto da steps_per_mm o ispezionando l'hardware . Quindi utilizzare la seguente procedura per \"misurare e tagliare\": Assicurati che l'estrusore contenga del filamento, che l'hotend sia riscaldato a una temperatura appropriata e che la stampante sia pronta per l'estrusione. Utilizzare un pennarello per posizionare un segno sul filamento a circa 70 mm dall'ingresso del corpo dell'estrusore. Quindi usa un calibro digitale per misurare la distanza effettiva di quel segno nel modo pi\u00f9 preciso possibile. Nota questo come <initial_mark_distance> . Estrudere 50 mm di filamento con la seguente sequenza di comandi: G91 seguito da G1 E50 F60 . Nota 50 mm come <distanza_estrusione_richiesta> . Attendi che l'estrusore finisca il movimento (ci vorranno circa 50 secondi). \u00c8 importante utilizzare la velocit\u00e0 di estrusione lenta per questo test poich\u00e9 una velocit\u00e0 pi\u00f9 elevata pu\u00f2 causare una pressione elevata nell'estrusore che distorce i risultati. (Non utilizzare il \"pulsante estrudi\" sui front-end grafici per questo test poich\u00e9 si estrudono a una velocit\u00e0 elevata.) Utilizzare un calibro digitale per misurare la nuova distanza tra il corpo dell'estrusore e il segno sul filamento. Annota questa come <subsequent_mark_distance> . Quindi calcola: actual_extrude_distance = <initial_mark_distance> - <subsequent_mark_distance> Calcola rotation_distance come: rotation_distance = <rotation_distance_precedente> * <actual_extrude_distance> / <requested_extrude_distance> Arrotonda la nuova rotation_distance a tre cifre decimali. Se la distanza_di_estrusione effettiva differisce dalla distanza_di_estrusione richiesta di oltre 2 mm circa, \u00e8 una buona idea eseguire i passaggi precedenti una seconda volta. Nota: non utilizzare un metodo di tipo \"misura e ritaglia\" per calibrare gli assi di tipo x, y o z. Il metodo \"misura e taglia\" non \u00e8 sufficientemente accurato per quegli assi e probabilmente porter\u00e0 a una configurazione peggiore. Invece, se necessario, quegli assi possono essere determinati measuring the belts, pulleys, and lead screw hardware .","title":"Calibrazione rotation_distance sugli estrusori"},{"location":"Rotation_Distance.html#ottenere-la-rotation_distance-ispezionando-lhardware","text":"E' possibile calcolare rotation_distance conoscendo i motori passo-passo e la cinematica della stampante. Questo pu\u00f2 essere utile se i passi_per_mm non sono noti o se si sta progettando una nuova stampante.","title":"Ottenere la rotation_distance ispezionando l'hardware"},{"location":"Rotation_Distance.html#assi-con-trasmissione-a-cinghia","text":"\u00c8 facile calcolare rotation_distance per un asse lineare che utilizza una cinghia e una puleggia. Per prima cosa determinare il tipo di cinghia. La maggior parte delle stampanti utilizza un passo della cinghia di 2 mm (ovvero, ogni dente sulla cinghia \u00e8 a 2 mm di distanza). Quindi contare il numero di denti sulla puleggia del motore passo-passo. La distanza_rotazione viene quindi calcolata come: rotation_distance = <passo_cinghia> * <numero_di_denti_sulla_puleggia> Ad esempio, se una stampante ha una cinghia da 2 mm e utilizza una puleggia con 20 denti, la distanza di rotazione \u00e8 40.","title":"Assi con trasmissione a cinghia"},{"location":"Rotation_Distance.html#assi-con-vite-di-comando","text":"\u00c8 facile calcolare la rotation_distance per le comuni viti di trasmissione utilizzando la seguente formula: rotation_distance = <passo_vite> * <numero_di_filetti_separati> Ad esempio, la comune \"madrevite T8\" ha una rotation distance di 8 (ha un passo di 2 mm e ha 4 filetti separati). Le stampanti pi\u00f9 vecchie con \"barre filettate\" hanno un solo \"filo\" sulla vite di comando e quindi la rotation distance \u00e8 il passo della vite. (Il passo della vite \u00e8 la distanza tra ciascuna scanalatura sulla vite.) Quindi, ad esempio, un'asta metrica M6 ha una rotation distance di 1 e un'asta M8 ha una rotation distance di 1,25.","title":"Assi con vite di comando"},{"location":"Rotation_Distance.html#estrusore","text":"\u00c8 possibile ottenere una distanza di rotazione iniziale per gli estrusori misurando il diametro del \"bullone dentato\" che spinge il filamento e utilizzando la seguente formula: rotation_distance = <diametro> * 3.14 Se l'estrusore utilizza ingranaggi, sar\u00e0 anche necessario determinare e impostare gear_ratio per l'estrusore. La rotation distance effettiva su un estrusore varier\u00e0 da stampante a stampante, perch\u00e9 la presa del \"bullone dentato\" che impegna il filamento pu\u00f2 variare. Pu\u00f2 anche variare tra le bobine di filamento. Dopo aver ottenuto una rotation distance iniziale, utilizzare la procedura di misurazione e ritaglio per ottenere un'impostazione pi\u00f9 accurata.","title":"Estrusore"},{"location":"Rotation_Distance.html#usando-un-gear_ratio","text":"L'impostazione di un gear_ratio pu\u00f2 semplificare la configurazione di rotation_distance su stepper a cui \u00e8 collegato un gear box (o simile). La maggior parte degli stepper non ha un gear box - se non sei sicuro, non impostare gear_ratio nella configurazione. Quando gear_ratio \u00e8 impostato, rotation_distance rappresenta la distanza percorsa dall'asse con una rotazione completa dell'ingranaggio finale sulla scatola ingranaggi. Se, ad esempio, si utilizza un riduttore con un rapporto \"5:1\", \u00e8 possibile calcolare la distanza_rotazione con conoscenza dell'hardware e quindi aggiungere gear_ratio: 5:1 alla configurazione. Per gli ingranaggi realizzati con cinghie e pulegge, \u00e8 possibile determinare il gear_ratio contando i denti sulle pulegge. Ad esempio, se uno stepper con una puleggia a 16 denti guida la puleggia successiva con 80 denti, si utilizzer\u00e0 gear_ratio: 80:16 . In effetti, si potrebbe aprire una comune \"scatola del cambio\" pronta all'uso e contare i denti al suo interno per confermare il suo rapporto di trasmissione. Si noti che a volte un gear-box avr\u00e0 un rapporto di trasmissione leggermente diverso da quello in cui \u00e8 pubblicizzato. I comuni ingranaggi del motore dell'estrusore BMG ne sono un esempio: sono pubblicizzati come \"3:1\" ma in realt\u00e0 utilizzano ingranaggi \"50:17\". (L'uso di numeri di denti senza un denominatore comune pu\u00f2 migliorare l'usura complessiva degli ingranaggi poich\u00e9 i denti non sempre ingranano allo stesso modo ad ogni giro.) Il comune \"riduttore epicicloidale 5.18:1\" \u00e8 configurato in modo pi\u00f9 accurato con gear_ratio: 57:11 . Se su un asse vengono utilizzati pi\u00f9 ingranaggi, \u00e8 possibile fornire un elenco separato da virgole nel gear_ratio. Ad esempio, un cambio \"5:1\" che guida una puleggia da 16 a 80 denti potrebbe utilizzare gear_ratio: 5:1, 80:16 . Nella maggior parte dei casi, gear_ratio dovrebbe essere definito con numeri interi poich\u00e9 ingranaggi e pulegge comuni hanno un numero intero di denti su di essi. Tuttavia, nei casi in cui una cinghia aziona una puleggia usando l'attrito invece dei denti, pu\u00f2 avere senso utilizzare un numero in virgola mobile nel rapporto di trasmissione (ad esempio, gear_ratio: 107.237:16 ).","title":"Usando un gear_ratio"},{"location":"SDCard_Updates.html","text":"Aggiornamenti scheda SD \u00b6 Molte delle schede controller oggi popolari vengono fornite con un bootloader in grado di aggiornare il firmware tramite scheda SD. Sebbene ci\u00f2 sia conveniente in molte circostanze, questi bootloader in genere non forniscono altro modo per aggiornare il firmware. Questo pu\u00f2 essere un fastidio se la tua scheda \u00e8 montata in una posizione di difficile accesso o se devi aggiornare spesso il firmware. Dopo che Klipper \u00e8 stato inizialmente flashato su un controller, \u00e8 possibile trasferire il nuovo firmware sulla scheda SD e avviare la procedura di flashing tramite ssh. Procedura di aggiornamento tipica \u00b6 La procedura per aggiornare il firmware dell'MCU utilizzando la scheda SD \u00e8 simile a quella di altri metodi. Invece di usare make flash \u00e8 necessario eseguire uno script di supporto, flash-sdcard.sh . L'aggiornamento di un BigTreeTech SKR 1.3 potrebbe essere simile al seguente: sudo service klipper stop cd ~/klipper git pull make clean make menuconfig make ./scripts/flash-sdcard.sh /dev/ttyACM0 btt-skr-v1.3 sudo service klipper start Spetta all'utente determinare la posizione del dispositivo e il nome della scheda. Se un utente ha bisogno di eseguire il flashing di pi\u00f9 schede, flash-sdcard.sh (o make flash se appropriato) dovrebbe essere eseguito per ciascuna scheda prima di riavviare il servizio Klipper. Le schede supportate possono essere elencate con il seguente comando: ./scripts/flash-sdcard.sh -l Se non vedi la tua scheda elencata, potrebbe essere necessario aggiungere una nuova definizione di scheda come descritto di seguito . Utilizzo avanzato \u00b6 I comandi precedenti presuppongono che l'MCU si connetta alla velocit\u00e0 di trasmissione predefinita di 250000 e che il firmware si trovi in ~/klipper/out/klipper.bin . Lo script flash-sdcard.sh fornisce opzioni per modificare queste impostazioni predefinite. Tutte le opzioni possono essere visualizzate dalla schermata della guida: ./scripts/flash-sdcard.sh -h SD Card upload utility for Klipper usage: flash_sdcard.sh [-h] [-l] [-c] [-b <baud>] [-f <firmware>] <device> <board> positional arguments: <device> device serial port <board> board type optional arguments: -h show this message -l list available boards -c run flash check/verify only (skip upload) -b <baud> serial baud rate (default is 250000) -f <firmware> path to klipper.bin Se la tua scheda \u00e8 stata flashata con un firmware che si connette a un baud rate personalizzato, \u00e8 possibile eseguire l'aggiornamento specificando l'opzione -b : ./scripts/flash-sdcard.sh -b 115200 /dev/ttyAMA0 btt-skr-v1.3 Se desideri eseguire il flashing di una build di Klipper situata in un luogo diverso da quello predefinito, puoi farlo specificando l'opzione -f : ./scripts/flash-sdcard.sh -f ~/downloads/klipper.bin /dev/ttyAMA0 btt-skr-v1.3 Nota che quando si aggiorna un MKS Robin E3 non \u00e8 necessario eseguire manualmente update_mks_robin.py e fornire il binario risultante a flash-sdcard.sh . Questa procedura \u00e8 automatizzata durante il processo di caricamento. L'opzione -c viene utilizzata per eseguire un controllo o un'operazione di sola verifica per testare se la scheda esegue correttamente il firmware specificato. Questa opzione \u00e8 destinata principalmente ai casi in cui \u00e8 necessario un ciclo di alimentazione manuale per completare la procedura di flashing, ad esempio con i bootloader che utilizzano la modalit\u00e0 SDIO anzich\u00e9 SPI per accedere alle proprie schede SD. (Vedi avvertenze di seguito) Ma pu\u00f2 anche essere utilizzato in qualsiasi momento per verificare se il codice visualizzato nella scheda corrisponde alla versione nella cartella build su qualsiasi scheda supportata. Avvertenze \u00b6 Come accennato nell'introduzione, questo metodo funziona solo per l'aggiornamento del firmware. La procedura di flashing iniziale deve essere eseguita manualmente secondo le istruzioni che si applicano alla scheda del controller. Sebbene sia possibile eseguire il flashing di una build che modifica il baud seriale o l'interfaccia di connessione (ad esempio: da USB a UART), la verifica avr\u00e0 sempre esito negativo poich\u00e9 lo script non sar\u00e0 in grado di riconnettersi all'MCU per verificare la versione corrente. Sono supportate solo le schede che utilizzano SPI per la comunicazione con scheda SD. Le schede che utilizzano SDIO, come Flymaker Flyboard e MKS Robin Nano V1/V2, non funzioneranno in modalit\u00e0 SDIO. Tuttavia, di solito \u00e8 possibile eseguire il flashing di tali schede utilizzando invece la modalit\u00e0 Software SPI. Ma se il bootloader della scheda utilizza solo la modalit\u00e0 SDIO per accedere alla scheda SD, sar\u00e0 necessario un ciclo di alimentazione della scheda e della scheda SD in modo che la modalit\u00e0 possa tornare da SPI a SDIO per completare il reflashing. Tali schede dovrebbero essere definite con skip_verify abilitato per saltare il passaggio di verifica immediatamente dopo il flashing. Quindi, dopo il ciclo di spegnimento manuale, \u00e8 possibile eseguire nuovamente lo stesso identico comando ./scripts/flash-sdcard.sh , ma aggiungere l'opzione -c per completare l'operazione di controllo/verifica. Vedere Flashing Boards that use SDIO per esempi. Definizioni della scheda \u00b6 Dovrebbero essere disponibili le schede pi\u00f9 comuni, tuttavia \u00e8 possibile aggiungere una nuova definizione di scheda, se necessario. Le definizioni delle schede si trovano in ~/klipper/scripts/spi_flash/board_defs.py . Le definizioni sono memorizzate nel dizionario, ad esempio: BOARD_DEFS = { 'generic-lpc1768' : { 'mcu' : \"lpc1768\" , 'spi_bus' : \"ssp1\" , \"cs_pin\" : \"P0.6\" }, ...< further definitions > } Possono essere specificati i seguenti campi: mcu : il tipo di mcu. Questo pu\u00f2 essere recuperato dopo aver configurato la build tramite make menuconfig eseguendo cat .config | grep CONFIG_MCU . Questo campo \u00e8 obbligatorio. spi_bus : il bus SPI collegato alla scheda SD. Questo dovrebbe essere recuperato dallo schema della scheda. Questo campo \u00e8 obbligatorio. cs_pin : il pin di selezione del chip collegato alla scheda SD. Questo dovrebbe essere recuperato dallo schema della scheda. Questo campo \u00e8 obbligatorio. firmware_path : il percorso sulla scheda SD in cui trasferire il firmware. L'impostazione predefinita \u00e8 firmware.bin . current_firmware_path : il percorso sulla scheda SD in cui si trova il file del firmware rinominato dopo un flash riuscito. L'impostazione predefinita \u00e8 'firmware.cur'. skip_verify : Definisce un valore booleano che dice agli script di saltare il passaggio di verifica del firmware durante il processo di flashing. L'impostazione predefinita \u00e8 False . Pu\u00f2 essere impostato su True per le schede che richiedono un ciclo di alimentazione manuale per completare il flashing. Per verificare il firmware in seguito, eseguire nuovamente lo script con l'opzione -c per eseguire lo step di verifica. Vedi le avvertenze con le schede SDIO Se \u00e8 richiesto il software SPI, il campo spi_bus deve essere impostato su swspi e deve essere specificato il seguente campo aggiuntivo: spi_pins : Dovrebbero essere 3 pin separati da virgola che sono collegati alla scheda SD nel formato miso,mosi,sclk`. Dovrebbe essere estremamente raro che sia necessario Software SPI, in genere solo le schede con errori di progettazione o le schede che normalmente supportano solo la modalit\u00e0 SDIO per la loro scheda SD lo richiederanno. La definizione della scheda btt-skr-pro fornisce un esempio della prima, e la definizione della scheda btt-octopus-f446-v1 fornisce un esempio della seconda. Prima di creare una nuova definizione di scheda, \u00e8 necessario verificare se una definizione di scheda esistente soddisfa i criteri necessari per la nuova scheda. Se questo \u00e8 il caso, pu\u00f2 essere specificato un BOARD_ALIAS . Ad esempio, \u00e8 possibile aggiungere il seguente alias per specificare my-new-board come alias per generic-lpc1768 : BOARD_ALIASES = { ...< previous aliases > , 'my-new-board' : BOARD_DEFS [ 'generic-lpc1768' ], } Se hai bisogno di una nuova definizione di scheda e ti senti a disagio con la procedura descritta sopra, ti consigliamo di rivolgerti a Klipper Community Discord . Flashing di schede che utilizzano SDIO \u00b6 Come menzionato nelle avvertenze , le schede il cui bootloader utilizza la modalit\u00e0 SDIO per accedere alla scheda SD richiedono un ciclo di alimentazione della scheda, e in particolare della scheda SD stessa, per passare dalla modalit\u00e0 SPI utilizzata durante la scrittura il file sulla scheda SD di nuovo in modalit\u00e0 SDIO affinch\u00e9 il bootloader lo inserisca nella scheda. Queste definizioni della scheda utilizzeranno il flag skip_verify , che indica allo strumento di flashing di interrompersi dopo aver scritto il firmware sulla scheda SD in modo che la scheda possa essere spenta e riaccesa manualmente e il passaggio di verifica posticipato fino al completamento. Esistono due scenari -- uno con l'host RPi in esecuzione su un alimentatore separato e l'altro quando l'host RPi \u00e8 in esecuzione con lo stesso alimentatore della scheda principale sottoposta a flashing. La differenza \u00e8 se \u00e8 necessario o meno spegnere anche l'RPi e quindi ssh di nuovo dopo che il flashing \u00e8 completo per eseguire il passaggio di verifica, o se la verifica pu\u00f2 essere eseguita immediatamente. Ecco alcuni esempi dei due scenari: Programmazione SDIO con RPi su alimentazione separata \u00b6 Una sessione tipica con l'RPi su un alimentatore separato \u00e8 simile alla seguente. Ovviamente, dovrai utilizzare il percorso del dispositivo e il nome della scheda corretti: sudo service klipper stop cd ~/klipper git pull make clean make menuconfig make ./scripts/flash-sdcard.sh /dev/ttyACM0 btt-octopus-f446-v1 [[[manually power-cycle the printer board here when instructed]]] ./scripts/flash-sdcard.sh -c /dev/ttyACM0 btt-octopus-f446-v1 sudo service klipper start Programmazione SDIO con RPi sullo stesso alimentatore \u00b6 Una sessione tipica con l'RPi sullo stesso alimentatore \u00e8 simile alla seguente. Ovviamente, dovrai utilizzare il percorso del dispositivo e il nome della scheda corretti: sudo service klipper stop cd ~/klipper git pull make clean make menuconfig make ./scripts/flash-sdcard.sh /dev/ttyACM0 btt-octopus-f446-v1 sudo shutdown -h now [[[wait for the RPi to shutdown, then power-cycle and ssh again to the RPi when it restarts]]] sudo service klipper stop cd ~/klipper ./scripts/flash-sdcard.sh -c /dev/ttyACM0 btt-octopus-f446-v1 sudo service klipper start In questo caso, poich\u00e9 \u00e8 in corso il riavvio dell'RPi Host, che riavvier\u00e0 il servizio klipper , \u00e8 necessario arrestare nuovamente klipper prima di eseguire il passaggio di verifica e riavviarlo al termine della verifica. Mappatura pin da SDIO a SPI \u00b6 Se lo schema della tua scheda utilizza SDIO per la sua scheda SD, puoi mappare i pin come descritto nella tabella seguente per determinare i pin SPI del software compatibili da assegnare nel file board_defs.py : Pin della scheda SD Pin della scheda micro SD Nome PIN SDIO Nome Pin SPI 9 1 DATA2 None (PU)* 1 2 CD/DATA3 CS 2 3 CMD MOSI 4 4 +3.3V (VDD) +3.3V (VDD) 5 5 CLK SCLK 3 6 GND (VSS) GND (VSS) 7 7 DATA0 MISO 8 8 DATA1 None (PU)* N/A 9 Card Detect (CD) Card Detect (CD) 6 10 GND GND * None (PU) indica un pin inutilizzato con una resistenza di pull-up","title":"Aggiornamenti scheda SD"},{"location":"SDCard_Updates.html#aggiornamenti-scheda-sd","text":"Molte delle schede controller oggi popolari vengono fornite con un bootloader in grado di aggiornare il firmware tramite scheda SD. Sebbene ci\u00f2 sia conveniente in molte circostanze, questi bootloader in genere non forniscono altro modo per aggiornare il firmware. Questo pu\u00f2 essere un fastidio se la tua scheda \u00e8 montata in una posizione di difficile accesso o se devi aggiornare spesso il firmware. Dopo che Klipper \u00e8 stato inizialmente flashato su un controller, \u00e8 possibile trasferire il nuovo firmware sulla scheda SD e avviare la procedura di flashing tramite ssh.","title":"Aggiornamenti scheda SD"},{"location":"SDCard_Updates.html#procedura-di-aggiornamento-tipica","text":"La procedura per aggiornare il firmware dell'MCU utilizzando la scheda SD \u00e8 simile a quella di altri metodi. Invece di usare make flash \u00e8 necessario eseguire uno script di supporto, flash-sdcard.sh . L'aggiornamento di un BigTreeTech SKR 1.3 potrebbe essere simile al seguente: sudo service klipper stop cd ~/klipper git pull make clean make menuconfig make ./scripts/flash-sdcard.sh /dev/ttyACM0 btt-skr-v1.3 sudo service klipper start Spetta all'utente determinare la posizione del dispositivo e il nome della scheda. Se un utente ha bisogno di eseguire il flashing di pi\u00f9 schede, flash-sdcard.sh (o make flash se appropriato) dovrebbe essere eseguito per ciascuna scheda prima di riavviare il servizio Klipper. Le schede supportate possono essere elencate con il seguente comando: ./scripts/flash-sdcard.sh -l Se non vedi la tua scheda elencata, potrebbe essere necessario aggiungere una nuova definizione di scheda come descritto di seguito .","title":"Procedura di aggiornamento tipica"},{"location":"SDCard_Updates.html#utilizzo-avanzato","text":"I comandi precedenti presuppongono che l'MCU si connetta alla velocit\u00e0 di trasmissione predefinita di 250000 e che il firmware si trovi in ~/klipper/out/klipper.bin . Lo script flash-sdcard.sh fornisce opzioni per modificare queste impostazioni predefinite. Tutte le opzioni possono essere visualizzate dalla schermata della guida: ./scripts/flash-sdcard.sh -h SD Card upload utility for Klipper usage: flash_sdcard.sh [-h] [-l] [-c] [-b <baud>] [-f <firmware>] <device> <board> positional arguments: <device> device serial port <board> board type optional arguments: -h show this message -l list available boards -c run flash check/verify only (skip upload) -b <baud> serial baud rate (default is 250000) -f <firmware> path to klipper.bin Se la tua scheda \u00e8 stata flashata con un firmware che si connette a un baud rate personalizzato, \u00e8 possibile eseguire l'aggiornamento specificando l'opzione -b : ./scripts/flash-sdcard.sh -b 115200 /dev/ttyAMA0 btt-skr-v1.3 Se desideri eseguire il flashing di una build di Klipper situata in un luogo diverso da quello predefinito, puoi farlo specificando l'opzione -f : ./scripts/flash-sdcard.sh -f ~/downloads/klipper.bin /dev/ttyAMA0 btt-skr-v1.3 Nota che quando si aggiorna un MKS Robin E3 non \u00e8 necessario eseguire manualmente update_mks_robin.py e fornire il binario risultante a flash-sdcard.sh . Questa procedura \u00e8 automatizzata durante il processo di caricamento. L'opzione -c viene utilizzata per eseguire un controllo o un'operazione di sola verifica per testare se la scheda esegue correttamente il firmware specificato. Questa opzione \u00e8 destinata principalmente ai casi in cui \u00e8 necessario un ciclo di alimentazione manuale per completare la procedura di flashing, ad esempio con i bootloader che utilizzano la modalit\u00e0 SDIO anzich\u00e9 SPI per accedere alle proprie schede SD. (Vedi avvertenze di seguito) Ma pu\u00f2 anche essere utilizzato in qualsiasi momento per verificare se il codice visualizzato nella scheda corrisponde alla versione nella cartella build su qualsiasi scheda supportata.","title":"Utilizzo avanzato"},{"location":"SDCard_Updates.html#avvertenze","text":"Come accennato nell'introduzione, questo metodo funziona solo per l'aggiornamento del firmware. La procedura di flashing iniziale deve essere eseguita manualmente secondo le istruzioni che si applicano alla scheda del controller. Sebbene sia possibile eseguire il flashing di una build che modifica il baud seriale o l'interfaccia di connessione (ad esempio: da USB a UART), la verifica avr\u00e0 sempre esito negativo poich\u00e9 lo script non sar\u00e0 in grado di riconnettersi all'MCU per verificare la versione corrente. Sono supportate solo le schede che utilizzano SPI per la comunicazione con scheda SD. Le schede che utilizzano SDIO, come Flymaker Flyboard e MKS Robin Nano V1/V2, non funzioneranno in modalit\u00e0 SDIO. Tuttavia, di solito \u00e8 possibile eseguire il flashing di tali schede utilizzando invece la modalit\u00e0 Software SPI. Ma se il bootloader della scheda utilizza solo la modalit\u00e0 SDIO per accedere alla scheda SD, sar\u00e0 necessario un ciclo di alimentazione della scheda e della scheda SD in modo che la modalit\u00e0 possa tornare da SPI a SDIO per completare il reflashing. Tali schede dovrebbero essere definite con skip_verify abilitato per saltare il passaggio di verifica immediatamente dopo il flashing. Quindi, dopo il ciclo di spegnimento manuale, \u00e8 possibile eseguire nuovamente lo stesso identico comando ./scripts/flash-sdcard.sh , ma aggiungere l'opzione -c per completare l'operazione di controllo/verifica. Vedere Flashing Boards that use SDIO per esempi.","title":"Avvertenze"},{"location":"SDCard_Updates.html#definizioni-della-scheda","text":"Dovrebbero essere disponibili le schede pi\u00f9 comuni, tuttavia \u00e8 possibile aggiungere una nuova definizione di scheda, se necessario. Le definizioni delle schede si trovano in ~/klipper/scripts/spi_flash/board_defs.py . Le definizioni sono memorizzate nel dizionario, ad esempio: BOARD_DEFS = { 'generic-lpc1768' : { 'mcu' : \"lpc1768\" , 'spi_bus' : \"ssp1\" , \"cs_pin\" : \"P0.6\" }, ...< further definitions > } Possono essere specificati i seguenti campi: mcu : il tipo di mcu. Questo pu\u00f2 essere recuperato dopo aver configurato la build tramite make menuconfig eseguendo cat .config | grep CONFIG_MCU . Questo campo \u00e8 obbligatorio. spi_bus : il bus SPI collegato alla scheda SD. Questo dovrebbe essere recuperato dallo schema della scheda. Questo campo \u00e8 obbligatorio. cs_pin : il pin di selezione del chip collegato alla scheda SD. Questo dovrebbe essere recuperato dallo schema della scheda. Questo campo \u00e8 obbligatorio. firmware_path : il percorso sulla scheda SD in cui trasferire il firmware. L'impostazione predefinita \u00e8 firmware.bin . current_firmware_path : il percorso sulla scheda SD in cui si trova il file del firmware rinominato dopo un flash riuscito. L'impostazione predefinita \u00e8 'firmware.cur'. skip_verify : Definisce un valore booleano che dice agli script di saltare il passaggio di verifica del firmware durante il processo di flashing. L'impostazione predefinita \u00e8 False . Pu\u00f2 essere impostato su True per le schede che richiedono un ciclo di alimentazione manuale per completare il flashing. Per verificare il firmware in seguito, eseguire nuovamente lo script con l'opzione -c per eseguire lo step di verifica. Vedi le avvertenze con le schede SDIO Se \u00e8 richiesto il software SPI, il campo spi_bus deve essere impostato su swspi e deve essere specificato il seguente campo aggiuntivo: spi_pins : Dovrebbero essere 3 pin separati da virgola che sono collegati alla scheda SD nel formato miso,mosi,sclk`. Dovrebbe essere estremamente raro che sia necessario Software SPI, in genere solo le schede con errori di progettazione o le schede che normalmente supportano solo la modalit\u00e0 SDIO per la loro scheda SD lo richiederanno. La definizione della scheda btt-skr-pro fornisce un esempio della prima, e la definizione della scheda btt-octopus-f446-v1 fornisce un esempio della seconda. Prima di creare una nuova definizione di scheda, \u00e8 necessario verificare se una definizione di scheda esistente soddisfa i criteri necessari per la nuova scheda. Se questo \u00e8 il caso, pu\u00f2 essere specificato un BOARD_ALIAS . Ad esempio, \u00e8 possibile aggiungere il seguente alias per specificare my-new-board come alias per generic-lpc1768 : BOARD_ALIASES = { ...< previous aliases > , 'my-new-board' : BOARD_DEFS [ 'generic-lpc1768' ], } Se hai bisogno di una nuova definizione di scheda e ti senti a disagio con la procedura descritta sopra, ti consigliamo di rivolgerti a Klipper Community Discord .","title":"Definizioni della scheda"},{"location":"SDCard_Updates.html#flashing-di-schede-che-utilizzano-sdio","text":"Come menzionato nelle avvertenze , le schede il cui bootloader utilizza la modalit\u00e0 SDIO per accedere alla scheda SD richiedono un ciclo di alimentazione della scheda, e in particolare della scheda SD stessa, per passare dalla modalit\u00e0 SPI utilizzata durante la scrittura il file sulla scheda SD di nuovo in modalit\u00e0 SDIO affinch\u00e9 il bootloader lo inserisca nella scheda. Queste definizioni della scheda utilizzeranno il flag skip_verify , che indica allo strumento di flashing di interrompersi dopo aver scritto il firmware sulla scheda SD in modo che la scheda possa essere spenta e riaccesa manualmente e il passaggio di verifica posticipato fino al completamento. Esistono due scenari -- uno con l'host RPi in esecuzione su un alimentatore separato e l'altro quando l'host RPi \u00e8 in esecuzione con lo stesso alimentatore della scheda principale sottoposta a flashing. La differenza \u00e8 se \u00e8 necessario o meno spegnere anche l'RPi e quindi ssh di nuovo dopo che il flashing \u00e8 completo per eseguire il passaggio di verifica, o se la verifica pu\u00f2 essere eseguita immediatamente. Ecco alcuni esempi dei due scenari:","title":"Flashing di schede che utilizzano SDIO"},{"location":"SDCard_Updates.html#programmazione-sdio-con-rpi-su-alimentazione-separata","text":"Una sessione tipica con l'RPi su un alimentatore separato \u00e8 simile alla seguente. Ovviamente, dovrai utilizzare il percorso del dispositivo e il nome della scheda corretti: sudo service klipper stop cd ~/klipper git pull make clean make menuconfig make ./scripts/flash-sdcard.sh /dev/ttyACM0 btt-octopus-f446-v1 [[[manually power-cycle the printer board here when instructed]]] ./scripts/flash-sdcard.sh -c /dev/ttyACM0 btt-octopus-f446-v1 sudo service klipper start","title":"Programmazione SDIO con RPi su alimentazione separata"},{"location":"SDCard_Updates.html#programmazione-sdio-con-rpi-sullo-stesso-alimentatore","text":"Una sessione tipica con l'RPi sullo stesso alimentatore \u00e8 simile alla seguente. Ovviamente, dovrai utilizzare il percorso del dispositivo e il nome della scheda corretti: sudo service klipper stop cd ~/klipper git pull make clean make menuconfig make ./scripts/flash-sdcard.sh /dev/ttyACM0 btt-octopus-f446-v1 sudo shutdown -h now [[[wait for the RPi to shutdown, then power-cycle and ssh again to the RPi when it restarts]]] sudo service klipper stop cd ~/klipper ./scripts/flash-sdcard.sh -c /dev/ttyACM0 btt-octopus-f446-v1 sudo service klipper start In questo caso, poich\u00e9 \u00e8 in corso il riavvio dell'RPi Host, che riavvier\u00e0 il servizio klipper , \u00e8 necessario arrestare nuovamente klipper prima di eseguire il passaggio di verifica e riavviarlo al termine della verifica.","title":"Programmazione SDIO con RPi sullo stesso alimentatore"},{"location":"SDCard_Updates.html#mappatura-pin-da-sdio-a-spi","text":"Se lo schema della tua scheda utilizza SDIO per la sua scheda SD, puoi mappare i pin come descritto nella tabella seguente per determinare i pin SPI del software compatibili da assegnare nel file board_defs.py : Pin della scheda SD Pin della scheda micro SD Nome PIN SDIO Nome Pin SPI 9 1 DATA2 None (PU)* 1 2 CD/DATA3 CS 2 3 CMD MOSI 4 4 +3.3V (VDD) +3.3V (VDD) 5 5 CLK SCLK 3 6 GND (VSS) GND (VSS) 7 7 DATA0 MISO 8 8 DATA1 None (PU)* N/A 9 Card Detect (CD) Card Detect (CD) 6 10 GND GND * None (PU) indica un pin inutilizzato con una resistenza di pull-up","title":"Mappatura pin da SDIO a SPI"},{"location":"Skew_Correction.html","text":"Correzione dell'inclinazione \u00b6 La correzione dell'inclinazione basata su software pu\u00f2 aiutare a risolvere le imprecisioni dimensionali risultanti da un gruppo stampante non perfettamente in squadrato. Si noti che se la stampante \u00e8 notevolmente inclinata, si consiglia vivamente di utilizzare prima mezzi meccanici per ottenere la stampante il pi\u00f9 squadrata possibile prima di applicare la correzione basata sul software. Stampa un oggetto di calibrazione \u00b6 Il primo passaggio per correggere l'inclinazione \u00e8 stampare un calibration object lungo il piano che si desidera correggere. C'\u00e8 anche un calibration object che include tutti i piani in un modello. Vuoi che l'oggetto sia orientato in modo che l'angolo A sia verso l'origine del piano. Assicurarsi che durante questa stampa non venga applicata alcuna correzione dell'inclinazione. Puoi farlo rimuovendo il modulo [skew_correction] da printer.cfg o inserendo un gcode SET_SKEW CLEAR=1 . Prendi le tue misure \u00b6 Il modulo [skew_correcton] richiede 3 misurazioni per ogni piano che vuoi correggere; la lunghezza dall'angolo A all'angolo C, la lunghezza dall'angolo B all'angolo D e la lunghezza dall'angolo A all'angolo D. Quando si misura la lunghezza AD non includere i piani sugli angoli forniti da alcuni oggetti di prova. Configura la tua inclinazione \u00b6 Assicurati che la sezione [skew_correction] sia in printer.cfg. Ora puoi usare il gcode SET_SKEW per configurare skew_correcton. Ad esempio, se le lunghezze misurate lungo XY sono le seguenti: Length AC = 140.4 Length BD = 142.8 Length AD = 99.8 SET_SKEW pu\u00f2 essere utilizzato per configurare la correzione dell'inclinazione per il piano XY. SET_SKEW XY=140.4,142.8,99.8 Puoi anche aggiungere misure per XZ e YZ al gcode: SET_SKEW XY=140.4,142.8,99.8 XZ=141.6,141.4,99.8 YZ=142.4,140.5,99.5 Il modulo [skew_correction] supporta anche la gestione del profilo in un modo simile a [bed_mesh] . Dopo aver impostato l'inclinazione usando il gcode SET_SKEW , puoi usare il gcode SKEW_PROFILE per salvarlo: SKEW_PROFILE SAVE=my_skew_profile Dopo questo comando ti verr\u00e0 chiesto di emettere un gcode SAVE_CONFIG per salvare il profilo nella memoria permanente. Se nessun profilo \u00e8 denominato my_skew_profile , verr\u00e0 creato un nuovo profilo. Se il profilo indicato esiste, verr\u00e0 sovrascritto. Una volta che hai un profilo salvato, puoi caricarlo: SKEW_PROFILE LOAD=my_skew_profile \u00c8 anche possibile rimuovere un profilo vecchio o superato: SKEW_PROFILE REMOVE=my_skew_profile Dopo aver rimosso un profilo, ti verr\u00e0 chiesto di emettere un SAVE_CONFIG per far s\u00ec che questa modifica persista. Verifica della tua correzione \u00b6 Dopo aver configurato skew_correction \u00e8 possibile ristampare la parte di calibrazione con la correzione abilitata. Usa il seguente gcode per controllare la tua inclinazione su ciascun piano. I risultati dovrebbero essere inferiori a quelli riportati tramite GET_CURRENT_SKEW . CALC_MEASURED_SKEW AC=<ac_length> BD=<bd_length> AD=<ad_length> Avvertenze \u00b6 A causa della natura della correzione dell'inclinazione, si consiglia di configurare l'inclinazione nel codice g iniziale, dopo l'homing e qualsiasi tipo di movimento che si sposta vicino al bordo dell'area di stampa, come uno spurgo o una pulizia degli ugelli. \u00c8 possibile utilizzare i codici g \"SET_SKEW\" o \"SKEW_PROFILE\" per ottenere ci\u00f2. Si consiglia inoltre di emettere un SET_SKEW CLEAR=1 alla fine del gcode. Tenere presente che \u00e8 possibile che [skew_correction] generi una correzione che sposti la testa oltre i limiti della stampante sugli assi X e/o Y. Si consiglia di disporre le parti lontano dai bordi quando si utilizza [skew_correction] .","title":"Correzione dell'inclinazione"},{"location":"Skew_Correction.html#correzione-dellinclinazione","text":"La correzione dell'inclinazione basata su software pu\u00f2 aiutare a risolvere le imprecisioni dimensionali risultanti da un gruppo stampante non perfettamente in squadrato. Si noti che se la stampante \u00e8 notevolmente inclinata, si consiglia vivamente di utilizzare prima mezzi meccanici per ottenere la stampante il pi\u00f9 squadrata possibile prima di applicare la correzione basata sul software.","title":"Correzione dell'inclinazione"},{"location":"Skew_Correction.html#stampa-un-oggetto-di-calibrazione","text":"Il primo passaggio per correggere l'inclinazione \u00e8 stampare un calibration object lungo il piano che si desidera correggere. C'\u00e8 anche un calibration object che include tutti i piani in un modello. Vuoi che l'oggetto sia orientato in modo che l'angolo A sia verso l'origine del piano. Assicurarsi che durante questa stampa non venga applicata alcuna correzione dell'inclinazione. Puoi farlo rimuovendo il modulo [skew_correction] da printer.cfg o inserendo un gcode SET_SKEW CLEAR=1 .","title":"Stampa un oggetto di calibrazione"},{"location":"Skew_Correction.html#prendi-le-tue-misure","text":"Il modulo [skew_correcton] richiede 3 misurazioni per ogni piano che vuoi correggere; la lunghezza dall'angolo A all'angolo C, la lunghezza dall'angolo B all'angolo D e la lunghezza dall'angolo A all'angolo D. Quando si misura la lunghezza AD non includere i piani sugli angoli forniti da alcuni oggetti di prova.","title":"Prendi le tue misure"},{"location":"Skew_Correction.html#configura-la-tua-inclinazione","text":"Assicurati che la sezione [skew_correction] sia in printer.cfg. Ora puoi usare il gcode SET_SKEW per configurare skew_correcton. Ad esempio, se le lunghezze misurate lungo XY sono le seguenti: Length AC = 140.4 Length BD = 142.8 Length AD = 99.8 SET_SKEW pu\u00f2 essere utilizzato per configurare la correzione dell'inclinazione per il piano XY. SET_SKEW XY=140.4,142.8,99.8 Puoi anche aggiungere misure per XZ e YZ al gcode: SET_SKEW XY=140.4,142.8,99.8 XZ=141.6,141.4,99.8 YZ=142.4,140.5,99.5 Il modulo [skew_correction] supporta anche la gestione del profilo in un modo simile a [bed_mesh] . Dopo aver impostato l'inclinazione usando il gcode SET_SKEW , puoi usare il gcode SKEW_PROFILE per salvarlo: SKEW_PROFILE SAVE=my_skew_profile Dopo questo comando ti verr\u00e0 chiesto di emettere un gcode SAVE_CONFIG per salvare il profilo nella memoria permanente. Se nessun profilo \u00e8 denominato my_skew_profile , verr\u00e0 creato un nuovo profilo. Se il profilo indicato esiste, verr\u00e0 sovrascritto. Una volta che hai un profilo salvato, puoi caricarlo: SKEW_PROFILE LOAD=my_skew_profile \u00c8 anche possibile rimuovere un profilo vecchio o superato: SKEW_PROFILE REMOVE=my_skew_profile Dopo aver rimosso un profilo, ti verr\u00e0 chiesto di emettere un SAVE_CONFIG per far s\u00ec che questa modifica persista.","title":"Configura la tua inclinazione"},{"location":"Skew_Correction.html#verifica-della-tua-correzione","text":"Dopo aver configurato skew_correction \u00e8 possibile ristampare la parte di calibrazione con la correzione abilitata. Usa il seguente gcode per controllare la tua inclinazione su ciascun piano. I risultati dovrebbero essere inferiori a quelli riportati tramite GET_CURRENT_SKEW . CALC_MEASURED_SKEW AC=<ac_length> BD=<bd_length> AD=<ad_length>","title":"Verifica della tua correzione"},{"location":"Skew_Correction.html#avvertenze","text":"A causa della natura della correzione dell'inclinazione, si consiglia di configurare l'inclinazione nel codice g iniziale, dopo l'homing e qualsiasi tipo di movimento che si sposta vicino al bordo dell'area di stampa, come uno spurgo o una pulizia degli ugelli. \u00c8 possibile utilizzare i codici g \"SET_SKEW\" o \"SKEW_PROFILE\" per ottenere ci\u00f2. Si consiglia inoltre di emettere un SET_SKEW CLEAR=1 alla fine del gcode. Tenere presente che \u00e8 possibile che [skew_correction] generi una correzione che sposti la testa oltre i limiti della stampante sugli assi X e/o Y. Si consiglia di disporre le parti lontano dai bordi quando si utilizza [skew_correction] .","title":"Avvertenze"},{"location":"Slicers.html","text":"slicer \u00b6 Questo documento fornisce alcuni suggerimenti per configurare un'applicazione \"slicer\" da usare con Klipper. Gli slicer comuni usati con Klipper sono Slic3r, Cura, Simplify3D, ecc. Imposta il Gcode su variante Marlin \u00b6 Molti slicer hanno un'opzione per configurare il \"gusto G-Code\" o G-Code flavor. L'impostazione predefinita \u00e8 spesso \"Marlin\" e funziona bene con Klipper. L'impostazione \"Smoothieware\" funziona bene anche con Klipper. Klipper gcode_macro \u00b6 Gli slicer spesso consentono di configurare le sequenze \"Start G-Code\" e \"End G-Code\". Spesso \u00e8 invece conveniente definire macro personalizzate nel file di configurazione di Klipper, come ad esempio: [gcode_macro START_PRINT] e [gcode_macro END_PRINT] . Quindi puoi semplicemente eseguire START_PRINT e END_PRINT nella configurazione dello slicer. La definizione di queste azioni nella configurazione di Klipper pu\u00f2 rendere pi\u00f9 semplice modificare i passaggi iniziali e finali della stampante poich\u00e9 le modifiche non richiedono il re-slicing. Vedere sample-macros.cfg ad esempio le macro START_PRINT e END_PRINT. Vedere il config reference per i dettagli sulla definizione di una macro gcode. Impostazioni di retrazione di grandi dimensioni potrebbero richiedere la messa a punto di Klipper \u00b6 La velocit\u00e0 massima e l'accelerazione dei movimenti di ritrazione sono controllate in Klipper dalle impostazioni di configurazione max_extrude_only_velocity e max_extrude_only_accel . Queste impostazioni hanno un valore predefinito che dovrebbe funzionare bene su molte stampanti. Tuttavia, se si \u00e8 configurata una grande retrazione nello slicer (ad es. 5 mm o superiore), \u00e8 possibile che limitino la velocit\u00e0 di retrazione desiderata. Se si utilizza una grande retrazione, prendere in considerazione l'ottimizzazione di pressure advance di Klipper. Altrimenti, se si scopre che la testa di stampa sembra \"mettersi in pausa\" durante la retrazione e il priming, allora considerare di definire esplicitamente max_extrude_only_velocity e max_extrude_only_accel nel file di configurazione di Klipper. Non abilitare \"coasting\" -costeggiando- \u00b6 \u00c8 probabile che la funzione \"coasting\" si traduca in stampe di scarsa qualit\u00e0 con Klipper. Prendi in considerazione l'utilizzo di pressure advance di Klipper. In particolare, se lo slicer cambia drasticamente la velocit\u00e0 di estrusione tra i movimenti, Klipper eseguir\u00e0 la decelerazione e l'accelerazione tra i movimenti. \u00c8 probabile che questo renda il blobbing peggiore, non migliore. Al contrario, va bene (e spesso utile) utilizzare l'impostazione ritiro \"retract\" , l'impostazione pulire \"wipe\" e/o l'impostazione pulire alla retrazione \"wipe on retract\". Non utilizzare la \"distanza di riavvio extra\"- \"extra restart distance\"su Simplify3d \u00b6 Questa impostazione pu\u00f2 causare cambiamenti radicali alle velocit\u00e0 di estrusione che possono attivare il controllo della sezione trasversale di estrusione massima di Klipper. Prendi in considerazione l'utilizzo dell' pressure advance di Klipper o della normale impostazione di retrazione Simplify3d. Disabilita \"PreloadVE\" su KISSlicer \u00b6 Se si utilizza il software di slicing KISSlicer, impostare \"PreloadVE\" su zero. Prendi in considerazione l'utilizzo di pressure advance di Klipper. Disattiva le impostazioni di \"pressione dell'estrusore avanzata\"-\"advanced extruder pressure\" \u00b6 Alcune affettatrici pubblicizzano una capacit\u00e0 di \"pressione dell'estrusore avanzata\" - \"advanced extruder pressure\". Si consiglia di mantenere queste opzioni disabilitate quando si utilizza Klipper poich\u00e9 \u00e8 probabile che si traducano in stampe di scarsa qualit\u00e0. Prendi in considerazione l'utilizzo di pressure advance di Klipper. In particolare, queste impostazioni dello slicer possono indicare al firmware di apportare modifiche alla velocit\u00e0 di estrusione nella speranza che il firmware si avvicini a tali richieste e che la stampante ottenga approssimativamente una pressione dell'estrusore desiderabile. Klipper, tuttavia, utilizza calcoli cinematici e tempi precisi. Quando a Klipper viene comandato di apportare modifiche significative alla velocit\u00e0 di estrusione, pianificher\u00e0 le modifiche corrispondenti a velocit\u00e0, accelerazione e movimento dell'estrusore, il che non \u00e8 l'intento dello slicer. Lo slicer pu\u00f2 anche comandare velocit\u00e0 di estrusione eccessive al punto da attivare il controllo della sezione trasversale di estrusione massima di Klipper. Al contrario, va bene (e spesso utile) utilizzare l'impostazione ritiro \"retract\" , l'impostazione pulire \"wipe\" e/o l'impostazione pulire alla retrazione \"wipe on retract\".","title":"slicer"},{"location":"Slicers.html#slicer","text":"Questo documento fornisce alcuni suggerimenti per configurare un'applicazione \"slicer\" da usare con Klipper. Gli slicer comuni usati con Klipper sono Slic3r, Cura, Simplify3D, ecc.","title":"slicer"},{"location":"Slicers.html#imposta-il-gcode-su-variante-marlin","text":"Molti slicer hanno un'opzione per configurare il \"gusto G-Code\" o G-Code flavor. L'impostazione predefinita \u00e8 spesso \"Marlin\" e funziona bene con Klipper. L'impostazione \"Smoothieware\" funziona bene anche con Klipper.","title":"Imposta il Gcode su variante Marlin"},{"location":"Slicers.html#klipper-gcode_macro","text":"Gli slicer spesso consentono di configurare le sequenze \"Start G-Code\" e \"End G-Code\". Spesso \u00e8 invece conveniente definire macro personalizzate nel file di configurazione di Klipper, come ad esempio: [gcode_macro START_PRINT] e [gcode_macro END_PRINT] . Quindi puoi semplicemente eseguire START_PRINT e END_PRINT nella configurazione dello slicer. La definizione di queste azioni nella configurazione di Klipper pu\u00f2 rendere pi\u00f9 semplice modificare i passaggi iniziali e finali della stampante poich\u00e9 le modifiche non richiedono il re-slicing. Vedere sample-macros.cfg ad esempio le macro START_PRINT e END_PRINT. Vedere il config reference per i dettagli sulla definizione di una macro gcode.","title":"Klipper gcode_macro"},{"location":"Slicers.html#impostazioni-di-retrazione-di-grandi-dimensioni-potrebbero-richiedere-la-messa-a-punto-di-klipper","text":"La velocit\u00e0 massima e l'accelerazione dei movimenti di ritrazione sono controllate in Klipper dalle impostazioni di configurazione max_extrude_only_velocity e max_extrude_only_accel . Queste impostazioni hanno un valore predefinito che dovrebbe funzionare bene su molte stampanti. Tuttavia, se si \u00e8 configurata una grande retrazione nello slicer (ad es. 5 mm o superiore), \u00e8 possibile che limitino la velocit\u00e0 di retrazione desiderata. Se si utilizza una grande retrazione, prendere in considerazione l'ottimizzazione di pressure advance di Klipper. Altrimenti, se si scopre che la testa di stampa sembra \"mettersi in pausa\" durante la retrazione e il priming, allora considerare di definire esplicitamente max_extrude_only_velocity e max_extrude_only_accel nel file di configurazione di Klipper.","title":"Impostazioni di retrazione di grandi dimensioni potrebbero richiedere la messa a punto di Klipper"},{"location":"Slicers.html#non-abilitare-coasting-costeggiando-","text":"\u00c8 probabile che la funzione \"coasting\" si traduca in stampe di scarsa qualit\u00e0 con Klipper. Prendi in considerazione l'utilizzo di pressure advance di Klipper. In particolare, se lo slicer cambia drasticamente la velocit\u00e0 di estrusione tra i movimenti, Klipper eseguir\u00e0 la decelerazione e l'accelerazione tra i movimenti. \u00c8 probabile che questo renda il blobbing peggiore, non migliore. Al contrario, va bene (e spesso utile) utilizzare l'impostazione ritiro \"retract\" , l'impostazione pulire \"wipe\" e/o l'impostazione pulire alla retrazione \"wipe on retract\".","title":"Non abilitare \"coasting\" -costeggiando-"},{"location":"Slicers.html#non-utilizzare-la-distanza-di-riavvio-extra-extra-restart-distancesu-simplify3d","text":"Questa impostazione pu\u00f2 causare cambiamenti radicali alle velocit\u00e0 di estrusione che possono attivare il controllo della sezione trasversale di estrusione massima di Klipper. Prendi in considerazione l'utilizzo dell' pressure advance di Klipper o della normale impostazione di retrazione Simplify3d.","title":"Non utilizzare la \"distanza di riavvio extra\"- \"extra restart distance\"su Simplify3d"},{"location":"Slicers.html#disabilita-preloadve-su-kisslicer","text":"Se si utilizza il software di slicing KISSlicer, impostare \"PreloadVE\" su zero. Prendi in considerazione l'utilizzo di pressure advance di Klipper.","title":"Disabilita \"PreloadVE\" su KISSlicer"},{"location":"Slicers.html#disattiva-le-impostazioni-di-pressione-dellestrusore-avanzata-advanced-extruder-pressure","text":"Alcune affettatrici pubblicizzano una capacit\u00e0 di \"pressione dell'estrusore avanzata\" - \"advanced extruder pressure\". Si consiglia di mantenere queste opzioni disabilitate quando si utilizza Klipper poich\u00e9 \u00e8 probabile che si traducano in stampe di scarsa qualit\u00e0. Prendi in considerazione l'utilizzo di pressure advance di Klipper. In particolare, queste impostazioni dello slicer possono indicare al firmware di apportare modifiche alla velocit\u00e0 di estrusione nella speranza che il firmware si avvicini a tali richieste e che la stampante ottenga approssimativamente una pressione dell'estrusore desiderabile. Klipper, tuttavia, utilizza calcoli cinematici e tempi precisi. Quando a Klipper viene comandato di apportare modifiche significative alla velocit\u00e0 di estrusione, pianificher\u00e0 le modifiche corrispondenti a velocit\u00e0, accelerazione e movimento dell'estrusore, il che non \u00e8 l'intento dello slicer. Lo slicer pu\u00f2 anche comandare velocit\u00e0 di estrusione eccessive al punto da attivare il controllo della sezione trasversale di estrusione massima di Klipper. Al contrario, va bene (e spesso utile) utilizzare l'impostazione ritiro \"retract\" , l'impostazione pulire \"wipe\" e/o l'impostazione pulire alla retrazione \"wipe on retract\".","title":"Disattiva le impostazioni di \"pressione dell'estrusore avanzata\"-\"advanced extruder pressure\""},{"location":"Sponsors.html","text":"Sponsors \u00b6 Klipper \u00e8 un software libero. Dipendiamo dal generoso supporto degli sponsor. Considera la possibilit\u00e0 di sponsorizzare Klipper o di supportare i nostri sponsor. BIGTREETECH \u00b6 [ BIGTREETECH \u00e8 lo sponsor ufficiale della scheda madre di Klipper. BIGTREETECH si impegna a sviluppare prodotti innovativi e competitivi per servire meglio la comunit\u00e0 della stampa 3D. Seguili su Facebook o Twitter . Sviluppatori Klipper \u00b6 Kevin O'Connor \u00b6 Kevin \u00e8 l'autore originale e l'attuale manutentore di Klipper. Fai una donazione su: https://ko-fi.com/koconnor o https://www.patreon.com/koconnor Eric Callahan \u00b6 Eric \u00e8 l'autore di bed_mesh, spi_flash e molti altri moduli Klipper. Eric ha una pagina per le donazioni : https://ko-fi.com/arksine Progetti correlati a Klipper \u00b6 Klipper \u00e8 spesso utilizzato con altri software gratuiti. Prendi in considerazione l'utilizzo o il supporto di questi progetti. Moonraker Mainsail Fluidd OctoPrint KlipperScreen","title":"Sponsors"},{"location":"Sponsors.html#sponsors","text":"Klipper \u00e8 un software libero. Dipendiamo dal generoso supporto degli sponsor. Considera la possibilit\u00e0 di sponsorizzare Klipper o di supportare i nostri sponsor.","title":"Sponsors"},{"location":"Sponsors.html#bigtreetech","text":"[ BIGTREETECH \u00e8 lo sponsor ufficiale della scheda madre di Klipper. BIGTREETECH si impegna a sviluppare prodotti innovativi e competitivi per servire meglio la comunit\u00e0 della stampa 3D. Seguili su Facebook o Twitter .","title":"BIGTREETECH"},{"location":"Sponsors.html#sviluppatori-klipper","text":"","title":"Sviluppatori Klipper"},{"location":"Sponsors.html#kevin-oconnor","text":"Kevin \u00e8 l'autore originale e l'attuale manutentore di Klipper. Fai una donazione su: https://ko-fi.com/koconnor o https://www.patreon.com/koconnor","title":"Kevin O'Connor"},{"location":"Sponsors.html#eric-callahan","text":"Eric \u00e8 l'autore di bed_mesh, spi_flash e molti altri moduli Klipper. Eric ha una pagina per le donazioni : https://ko-fi.com/arksine","title":"Eric Callahan"},{"location":"Sponsors.html#progetti-correlati-a-klipper","text":"Klipper \u00e8 spesso utilizzato con altri software gratuiti. Prendi in considerazione l'utilizzo o il supporto di questi progetti. Moonraker Mainsail Fluidd OctoPrint KlipperScreen","title":"Progetti correlati a Klipper"},{"location":"Status_Reference.html","text":"Status reference \u00b6 Questo documento \u00e8 un riferimento alle informazioni sullo stato della stampante disponibili in Klipper macro , display fields e tramite API Server . I campi in questo documento sono soggetti a modifiche: se si utilizza un attributo, assicurarsi di rivedere il documento Modifiche alla configurazione durante l'aggiornamento del software Klipper. angle \u00b6 Le seguenti informazioni sono disponibili negli oggetti angle some_name : temperature : l'ultima lettura della temperatura (in gradi Celsius) da un sensore magnetico Hall tle5012b. Questo valore \u00e8 disponibile solo se il sensore angolare \u00e8 un chip tle5012b e se le misurazioni sono in corso (altrimenti segnala None ). bed_mesh \u00b6 Le seguenti informazioni sono disponibili in bed_mesh : profile_name , mesh_min , mesh_max , probed_matrix , mesh_matrix : informazioni sulla bed_mesh attualmente attiva. profiles : l'insieme dei profili attualmente definiti come setup usando BED_MESH_PROFILE. bed_screws \u00b6 Le seguenti informazioni sono disponibili nell'oggetto Config_Reference.md#bed_screws : is_active : Restituisce True se lo strumento di regolazione delle viti del letto \u00e8 attualmente attivo. state : lo stato dello strumento di regolazione delle viti del piatto. \u00c8 una delle seguenti stringhe: \"adjust\", \"fine\". current_screw : l'indice per la vite corrente in corso di regolazione. accepted_screws : il numero di viti accettate. configfile \u00b6 Le seguenti informazioni sono disponibili nell'oggetto configfile (questo oggetto \u00e8 sempre disponibile): settings.<section>.<option> : Restituisce l'impostazione del file di configurazione data (o il valore predefinito) durante l'ultimo avvio o riavvio del software. (Qualsiasi impostazione modificata in fase di esecuzione non si rifletter\u00e0 qui.) config.<section>.<option> : Restituisce l'impostazione del file di configurazione non elaborato come letta da Klipper durante l'ultimo avvio o riavvio del software. (Qualsiasi impostazione modificata in fase di esecuzione non si rifletter\u00e0 qui.) Tutti i valori vengono restituiti come stringhe. save_config_pending : Restituisce vero se ci sono aggiornamenti che un comando SAVE_CONFIG potrebbe rendere persistenti sul disco. save_config_pending_items : contiene le sezioni e le opzioni che sono state modificate e sarebbero mantenute da un SAVE_CONFIG . warnings : un elenco di avvisi sulle opzioni di configurazione. Ogni voce nell'elenco sar\u00e0 un dizionario contenente un campo type e message (entrambe le stringhe). Ulteriori campi potrebbero essere disponibili a seconda del tipo di avviso. display_status \u00b6 Le seguenti informazioni sono disponibili nell'oggetto display_status (questo oggetto \u00e8 automaticamente disponibile se \u00e8 definita una sezione di configurazione display ): progress : il valore di avanzamento dell'ultimo comando G-Code M73 (o virtual_sdcard.progress se non \u00e8 stato ricevuto alcun M73 recente). message : il messaggio contenuto nell'ultimo comando G-Code M117 . endstop_phase \u00b6 Le seguenti informazioni sono disponibili nell'oggetto endstop_phase : last_home.<nome stepper>.phase : La fase del motore passo-passo al termine dell'ultimo tentativo di home. last_home.<stepper name>.phases : il numero totale di fasi disponibili sul motore passo-passo. last_home.<stepper name>.mcu_position : la posizione (tracciata dal microcontrollore) del motore passo-passo alla fine dell'ultimo tentativo di home. La posizione \u00e8 il numero totale di passi effettuati in avanti meno il numero totale di passi effettuati in senso inverso dall'ultimo riavvio del microcontrollore. exclude_object \u00b6 Le seguenti informazioni sono disponibili nell'oggetto exclude_object : objects : un array di oggetti conosciuti come fornito dal comando EXCLUDE_OBJECT_DEFINE . Queste sono le stesse informazioni fornite dal comando EXCLUDE_OBJECT VERBOSE=1 . I campi center e polygon saranno presenti solo se forniti nell'originale EXCLUDE_OBJECT_DEFINE Ecco un esempio JSON: [ { \"polygon\": [ [ 156.25, 146.2511675 ], [ 156.25, 153.7488325 ], [ 163.75, 153.7488325 ], [ 163.75, 146.2511675 ] ], \"name\": \"CYLINDER_2_STL_ID_2_COPY_0\", \"center\": [ 160, 150 ] }, { \"polygon\": [ [ 146.25, 146.2511675 ], [ 146.25, 153.7488325 ], [ 153.75, 153.7488325 ], [ 153.75, 146.2511675 ] ], \"name\": \"CYLINDER_2_STL_ID_1_COPY_0\", \"center\": [ 150, 150 ] } ] excluded_objects : un array di stringhe che elenca i nomi degli oggetti esclusi. current_object : il nome dell'oggetto attualmente in fase di stampa. extruder_stepper \u00b6 Le seguenti informazioni sono disponibili per gli oggetti extruder_stepper (cos\u00ec come per gli oggetti extruder ): pressure_advance : il valore corrente di pressure advance . smooth_time : il tempo di avanzamento graduale della pressure advance corrente. fan \u00b6 Le seguenti informazioni sono disponibili negli oggetti fan , heater_fan some_name e controller_fan some_name : speed : La velocit\u00e0 della ventola come float tra 0.0 e 1.0. rpm : la velocit\u00e0 della ventola misurata in rotazioni al minuto se la ventola ha un pin tachimetro definito. filament_switch_sensor \u00b6 Le seguenti informazioni sono disponibili negli oggetti filament_switch_sensor some_name : enabled : Restituisce True se il sensore interruttore \u00e8 attualmente abilitato. filament_detected : restituisce True se il sensore \u00e8 in uno stato attivato. filament_motion_sensor \u00b6 Le seguenti informazioni sono disponibili negli oggetti filament_motion_sensor some_name : abilitato : Restituisce True se il sensore di movimento \u00e8 attualmente abilitato. filament_detected : restituisce True se il sensore \u00e8 in uno stato attivato. firmware_retraction \u00b6 Le seguenti informazioni sono disponibili nell'oggetto firmware_retraction : retract_length , retract_speed , unretract_extra_length , unretract_speed : le impostazioni correnti per il modulo firmware_retraction. Queste impostazioni possono differire dal file di configurazione se un comando SET_RETRACTION le altera. gcode_macro \u00b6 Le seguenti informazioni sono disponibili negli oggetti gcode_macro some_name : <variabile> : il valore corrente di una variabile gcode_macro . gcode_move \u00b6 Le seguenti informazioni sono disponibili nell'oggetto gcode_move (questo oggetto \u00e8 sempre disponibile): gcode_position : la posizione corrente della testa di stampa rispetto all'origine del Gcode corrente. Cio\u00e8, posizioni che si potrebbero inviare direttamente a un comando G1 . \u00c8 possibile accedere ai componenti x, y, z ed e di questa posizione (ad esempio, gcode_position.x ). position : l'ultima posizione comandata della testina utilizzando il sistema di coordinate specificato nel file di configurazione. \u00c8 possibile accedere alle componenti x, y, z ed e di questa posizione (ad esempio, position.x ). homing_origin : l'origine del sistema di coordinate gcode (relativo al sistema di coordinate specificato nel file di configurazione) da utilizzare dopo un comando G28 . Il comando SET_GCODE_OFFSET pu\u00f2 alterare questa posizione. \u00c8 possibile accedere ai componenti x, y e z di questa posizione (ad esempio, homing_origin.x ). speed : l'ultima velocit\u00e0 impostata in un comando G1 (in mm/s). speed_factor : La\"speed factor override\" come impostato da un comando M220 . Questo \u00e8 un valore in virgola mobile tale che 1,0 significa nessun override e, ad esempio, 2,0 raddoppierebbe la velocit\u00e0 richiesta. extrude_factor : L'\"extrude factor override\" come impostato da un comando M221 . Questo \u00e8 un valore in virgola mobile tale che 1,0 significa nessun override ad esempio 2,0 raddoppierebbe le estrusioni richieste. absolute_coordinates : restituisce True se in modalit\u00e0 coordinate assolute G90 o False se in modalit\u00e0 relativa G91 . absolute_extrude : restituisce True se in modalit\u00e0 di estrusione assoluta M82 o False se in modalit\u00e0 relativa M83 . hall_filament_width_sensor \u00b6 Le seguenti informazioni sono disponibili nell'oggetto hall_filament_width_sensor : is_active : Restituisce True se il sensore \u00e8 attualmente attivo. Diameter : l'ultima lettura dal sensore in mm. Raw : l'ultima lettura grezza dell'ADC dal sensore. Riscaldatore \u00b6 Le seguenti informazioni sono disponibili per oggetti riscaldatore come extruder , heater_bed e heater_generic : temperature : l'ultima temperatura riportata (in gradi Celsius come float) per il dato riscaldatore. target : la temperatura target attuale (in gradi Celsius come float) per il riscaldatore dato. power : l'ultima impostazione del pin PWM (un valore compreso tra 0.0 e 1.0) associato al riscaldatore. can_extrude : Se l'estrusore pu\u00f2 estrudere (definito da min_extrude_temp ), disponibile solo per extruder Riscaldatori \u00b6 Le seguenti informazioni sono disponibili nell'oggetto heaters (questo oggetto \u00e8 disponibile se \u00e8 definito un riscaldatore): disponibili_riscaldatori : restituisce un elenco di tutti i riscaldatori attualmente disponibili in base ai nomi completi delle sezioni di configurazione, ad es. [\"extruder\", \"heater_bed\", \"heater_generic my_custom_heater\"] . available_sensors : restituisce un elenco di tutti i riscaldatori attualmente disponibili in base ai nomi completi delle sezioni di configurazione, ad es. [\"extruder\", \"heater_bed\", \"heater_generic my_custom_heater\"] . idle_timeout \u00b6 Le seguenti informazioni sono disponibili nell'oggetto idle_timeout (questo oggetto \u00e8 sempre disponibile): state : lo stato corrente della stampante monitorato dal modulo idle_timeout. \u00c8 una delle seguenti stringhe: \"Idle\", \"Printing\", \"Ready\". printing_time : la quantit\u00e0 di tempo (in secondi) in cui la stampante \u00e8 rimasta nello stato \"Printing\" (come tracciato dal modulo idle_timeout). led \u00b6 Le seguenti informazioni sono disponibili per ogni sezione di configurazione [led led_name] , [neopixel led_name] , [dotstar led_name] , [pca9533 led_name] e [pca9632 led_name] definita in printer.cfg: color_data : un elenco di lista di colori contenenti i valori RGBW per ogni led nella catena. Ogni valore \u00e8 rappresentato come un float da 0,0 a 1,0. Ciascuna lista di colori contiene 4 voci (rosso, verde, blu, bianco) anche se il LED sottostante supporta meno canali di colore. Ad esempio, \u00e8 possibile accedere al valore blu (3\u00b0 elemento nell'elenco dei colori) del secondo neopixel in una catena in printer[\"neopixel <config_name>\"].color_data[1][2] . manual_probe \u00b6 Le seguenti informazioni sono disponibili nell'oggetto manual_probe : is_active : Restituisce True se \u00e8 attualmente attivo uno script di supporto per il rilevamento manuale. z_position : l'altezza corrente dell'ugello (come la sta attualmente interpretando la stampante). z_position_lower : ultimo tentativo di sonda appena inferiore all'altezza corrente. z_position_upper : ultimo tentativo di sonda appena maggiore dell'altezza corrente. mcu \u00b6 Le seguenti informazioni sono disponibili negli oggetti mcu e mcu some_name : mcu_version : la versione del codice Klipper riportata dal microcontrollore. mcu_build_versions : informazioni sugli strumenti di compilazione utilizzati per generare il codice del microcontrollore (come riportato dal microcontrollore). mcu_constants.<constant_name> : Elenca le costanti di tempo riportate dal microcontrollore. Le costanti disponibili possono differire tra le architetture del microcontrollore e con ogni revisione del codice. last_stats.<statistics_name> : informazioni statistiche sulla connessione del microcontrollore. motion_report \u00b6 Le seguenti informazioni sono disponibili nell'oggetto motion_report (questo oggetto \u00e8 automaticamente disponibile se \u00e8 definita una sezione di configurazione stepper): live_position : la posizione richiesta della testa di stampa interpolata all'ora corrente. live_velocity : la velocit\u00e0 della testa di stampa richiesta (in mm/s) al momento attuale. live_extruder_velocity : la velocit\u00e0 dell'estrusore richiesta (in mm/s) al momento attuale. output_pin \u00b6 Le seguenti informazioni sono disponibili negli oggetti output_pin some_name : value : Il \"valore\" del pin, come impostato da un comando SET_PIN . palette2 \u00b6 Le seguenti informazioni sono disponibili nell'oggetto palette2 : ping : Valore dell'ultimo ping di Palette 2 riportato in percentuale. remaining_load_length : Quando si avvia una stampa della Palette 2, questa sar\u00e0 la quantit\u00e0 di filamento da caricare nell'estrusore. is_splicing : Vero quando la Palette 2 sta giuntando il filamento. pause_resume \u00b6 Le seguenti informazioni sono disponibili nell'oggetto pause_resume : is_paused : Restituisce vero se un comando PAUSE \u00e8 stato eseguito senza un corrispondente RESUME. print_stats \u00b6 Le seguenti informazioni sono disponibili nell'oggetto print_stats (questo oggetto \u00e8 automaticamente disponibile se \u00e8 definita una sezione di configurazione virtual_sdcard ): filename , total_duration , print_duration , filament_used , state , message : informazioni stimate sulla stampa corrente quando \u00e8 attiva una stampa da virtual_sdcard. info.total_layer : Il valore totale del layer dell'ultimo comando G-Code SET_PRINT_STATS_INFO TOTAL_LAYER=<valore> . info.current_layer : il valore del layer corrente dell'ultimo comando G-Code SET_PRINT_STATS_INFO CURRENT_LAYER=<valore> . probe \u00b6 Le seguenti informazioni sono disponibili nell'oggetto probe (questo oggetto \u00e8 disponibile anche se \u00e8 definita una sezione di configurazione bltouch ): last_query : Restituisce True se il probe \u00e8 stato segnalato come \"attivato\" durante l'ultimo comando QUERY_PROBE. Nota, se questo viene utilizzato in una macro, a causa dell'ordine di espansione del modello, il comando QUERY_PROBE deve essere eseguito prima della macro contenente questo riferimento. last_z_result : Restituisce il valore del risultato Z dell'ultimo comando PROBE. Nota, se questo viene utilizzato in una macro, a causa dell'ordine di espansione del modello, il comando PROBE (o simile) deve essere eseguito prima della macro contenente questo riferimento. quad_gantry_level \u00b6 Le seguenti informazioni sono disponibili nell'oggetto quad_gantry_level (questo oggetto \u00e8 disponibile se quad_gantry_level \u00e8 definito): applied : Vero se il processo di livellamento del gantry \u00e8 stato eseguito e completato con successo. query_endstops \u00b6 Le seguenti informazioni sono disponibili nell'oggetto query_endstops (questo oggetto \u00e8 disponibile se \u00e8 definito un finecorsa): last_query[\"<endstop>\"] : Restituisce True se l'endstop specificato \u00e8 stato segnalato come \"attivato-triggered\" durante l'ultimo comando QUERY_ENDSTOP. Nota, se questo viene utilizzato in una macro, a causa dell'ordine di espansione del modello, il comando QUERY_ENDSTOP deve essere eseguito prima della macro contenente questo riferimento. screws_tilt_adjust \u00b6 Le seguenti informazioni sono disponibili nell'oggetto screws_tilt_adjust : error : restituisce True se il comando SCREWS_TILT_CALCULATE pi\u00f9 recente includeva il parametro MAX_DEVIATION e uno qualsiasi dei punti della vite rilevati superava il MAX_DEVIATION specificato. results : un elenco delle posizioni delle viti rilevate. Ogni voce nell'elenco sar\u00e0 un dizionario contenente le seguenti chiavi: name : il nome della vite come specificato nel file di configurazione. x : la coordinata X della vite come specificato nel file di configurazione. y : la coordinata Y della vite come specificato nel file di configurazione. z : L'altezza Z misurata della posizione della vite. sign : Una stringa che specifica la direzione da girare per avvitare per la regolazione necessaria. O \"CW\" per senso orario o \"CCW\" per senso antiorario. La vite di base non avr\u00e0 una chiave di \"segno\". adjust : il numero di giri di vite per regolare la vite, dato nel formato \"HH:MM\", dove \"HH\" \u00e8 il numero di giri di vite completi e \"MM\" \u00e8 il numero di \"minuti di un quadrante di orologio\" che rappresenta un giro di vite parziale. (Es. \"01:15\" significherebbe girare la vite di un giro e un quarto.) servo \u00b6 Le seguenti informazioni sono disponibili negli oggetti servo some_name : printer[\"servo <config_name>\"].value : l'ultima impostazione del pin PWM (un valore compreso tra 0.0 e 1.0) associata al servo. system_stats \u00b6 Le seguenti informazioni sono disponibili nell'oggetto system_stats (questo oggetto \u00e8 sempre disponibile): sysload , cputime , memavail : informazioni sul sistema operativo del host e sul carico del processo. sensori di temperatura \u00b6 Le seguenti informazioni sono disponibili in bme280 config_section_name , htu21d config_section_name , lm75 config_section_name e temperature_host config_section_name : temperature : l'ultima temperatura letta dal sensore. humidity , pressure , gas : gli ultimi valori letti dal sensore (solo sui sensori bme280, htu21d e lm75). temperature_fan \u00b6 Le seguenti informazioni sono disponibili negli oggetti temperature_fan some_name : temperature : l'ultima temperatura letta dal sensore. target : La temperatura target per la ventola. temperature_sensor \u00b6 Le seguenti informazioni sono disponibili negli oggetti temperature_sensor some_nome : temperature : l'ultima temperatura letta dal sensore. measured_min_temp , measured_max_temp : la temperatura pi\u00f9 bassa e pi\u00f9 alta vista dal sensore dall'ultimo riavvio del software host Klipper. driver tmc \u00b6 Le seguenti informazioni sono disponibili negli oggetti TMC stepper driver (ad esempio, [tmc2208 stepper_x] ): mcu_phase_offset : La posizione dello stepper del microcontrollore corrispondente alla fase \"zero\" del driver. Questo campo pu\u00f2 essere nullo se l'offset di fase non \u00e8 noto. phase_offset_position : La \"posizione comandata\" corrispondente alla fase \"zero\" del driver. Questo campo pu\u00f2 essere nullo se l'offset di fase non \u00e8 noto. drv_status : i risultati dell'ultima query sullo stato del driver. (Sono riportati solo i campi diversi da zero.) Questo campo sar\u00e0 nullo se il driver non \u00e8 abilitato (e quindi non viene interrogato periodicamente). run_current : La corrente di esecuzione attualmente impostata. hold_current : La corrente di mantenimento attualmente impostata. toolhead \u00b6 Le seguenti informazioni sono disponibili nell'oggetto toolhead (questo oggetto \u00e8 sempre disponibile): position : l'ultima posizione comandata della testa di stampa relativa al sistema di coordinate specificato nel file di configurazione. \u00c8 possibile accedere alle componenti x, y, z di questa posizione (ad esempio, position.x ). extruder : il nome dell'estrusore attualmente attivo. Ad esempio, in una macro si potrebbe usare printer[printer.toolhead.extruder].target per ottenere la temperatura target dell'estrusore corrente. homed_axes : Gli assi cartesiani correnti considerati in uno stato \"homed\". Questa \u00e8 una stringa contenente uno o pi\u00f9 di \"x\", \"y\", \"z\". axis_minimum , axis_maximum : i limiti di corsa dell'asse (mm) dopo la corsa di homing. \u00c8 possibile accedere alle componenti x, y, z di questo valore limite (ad es. axis_minimum.x , axis_minimum.z ). Per le stampanti Delta, cone_start_z \u00e8 l'altezza z massima al raggio massimo ( printer.toolhead.cone_start_z ). max_velocity , max_accel , max_accel_to_decel , square_corner_velocity : gli attuali limiti di stampa in vigore. Questo pu\u00f2 differire dalle impostazioni del file di configurazione se un comando SET_VELOCITY_LIMIT (o M204 ) le altera in fase di esecuzione. stalls : il numero totale di volte (dall'ultimo riavvio) che la stampante ha dovuto essere messa in pausa perch\u00e9 la testina si muoveva pi\u00f9 velocemente di quanto fosse possibile leggere i movimenti dall'input del G-code. dual_carriage \u00b6 Le seguenti informazioni sono disponibili in dual_carriage su una macchina hybrid_corexy o hybrid_corexz mode : la modalit\u00e0 corrente. I valori possibili sono: \"FULL_CONTROL\" active_carriage : il carrello attivo corrente. I valori possibili sono: \"CARRIAGE_0\", \"CARRIAGE_1\" virtual_sdcard \u00b6 Le seguenti informazioni sono disponibili nell'oggetto virtual_sdcard : is_active : Restituisce True se una stampa da file \u00e8 attualmente attiva. progress : una stima dello stato di avanzamento della stampa corrente (in base alla dimensione del file e alla posizione del file). file_path : un percorso completo del file per il file attualmente caricato. file_position : la posizione corrente (in byte) di una stampa attiva. file_size : la dimensione (in byte) del file attualmente caricato. webhooks \u00b6 Le seguenti informazioni sono disponibili nell'oggetto webhooks (questo oggetto \u00e8 sempre disponibile): state : restituisce una stringa che indica lo stato corrente di Klipper. I valori possibili sono: \"ready\", \"startup\", \"shutdown\", \"error\". state_message : una stringa leggibile dall'uomo che fornisce un contesto aggiuntivo sullo stato corrente di Klipper. z_thermal_adjust \u00b6 Le seguenti informazioni sono disponibili nell'oggetto z_thermal_adjust (questo oggetto \u00e8 disponibile se z_thermal_adjust \u00e8 definito). enabled : Restituisce True se la regolazione \u00e8 abilitata. temperature : temperatura attuale (livellata) del sensore definito. [grado C] measured_min_temp : temperatura minima misurata. [degC] measured_max_temp : Temperatura massima misurata. [degC] current_z_adjust : Ultima regolazione Z calcolata [mm]. z_adjust_ref_temperature :Temperatura di riferimento corrente utilizzata per il calcolo di Z current_z_adjust [degC]. z_tilt \u00b6 Le seguenti informazioni sono disponibili nell'oggetto z_tilt (questo oggetto \u00e8 disponibile se z_tilt \u00e8 definito): applied : Vero se il processo di livellamento z-tilt \u00e8 stato eseguito e completato con successo.","title":"Status reference"},{"location":"Status_Reference.html#status-reference","text":"Questo documento \u00e8 un riferimento alle informazioni sullo stato della stampante disponibili in Klipper macro , display fields e tramite API Server . I campi in questo documento sono soggetti a modifiche: se si utilizza un attributo, assicurarsi di rivedere il documento Modifiche alla configurazione durante l'aggiornamento del software Klipper.","title":"Status reference"},{"location":"Status_Reference.html#angle","text":"Le seguenti informazioni sono disponibili negli oggetti angle some_name : temperature : l'ultima lettura della temperatura (in gradi Celsius) da un sensore magnetico Hall tle5012b. Questo valore \u00e8 disponibile solo se il sensore angolare \u00e8 un chip tle5012b e se le misurazioni sono in corso (altrimenti segnala None ).","title":"angle"},{"location":"Status_Reference.html#bed_mesh","text":"Le seguenti informazioni sono disponibili in bed_mesh : profile_name , mesh_min , mesh_max , probed_matrix , mesh_matrix : informazioni sulla bed_mesh attualmente attiva. profiles : l'insieme dei profili attualmente definiti come setup usando BED_MESH_PROFILE.","title":"bed_mesh"},{"location":"Status_Reference.html#bed_screws","text":"Le seguenti informazioni sono disponibili nell'oggetto Config_Reference.md#bed_screws : is_active : Restituisce True se lo strumento di regolazione delle viti del letto \u00e8 attualmente attivo. state : lo stato dello strumento di regolazione delle viti del piatto. \u00c8 una delle seguenti stringhe: \"adjust\", \"fine\". current_screw : l'indice per la vite corrente in corso di regolazione. accepted_screws : il numero di viti accettate.","title":"bed_screws"},{"location":"Status_Reference.html#configfile","text":"Le seguenti informazioni sono disponibili nell'oggetto configfile (questo oggetto \u00e8 sempre disponibile): settings.<section>.<option> : Restituisce l'impostazione del file di configurazione data (o il valore predefinito) durante l'ultimo avvio o riavvio del software. (Qualsiasi impostazione modificata in fase di esecuzione non si rifletter\u00e0 qui.) config.<section>.<option> : Restituisce l'impostazione del file di configurazione non elaborato come letta da Klipper durante l'ultimo avvio o riavvio del software. (Qualsiasi impostazione modificata in fase di esecuzione non si rifletter\u00e0 qui.) Tutti i valori vengono restituiti come stringhe. save_config_pending : Restituisce vero se ci sono aggiornamenti che un comando SAVE_CONFIG potrebbe rendere persistenti sul disco. save_config_pending_items : contiene le sezioni e le opzioni che sono state modificate e sarebbero mantenute da un SAVE_CONFIG . warnings : un elenco di avvisi sulle opzioni di configurazione. Ogni voce nell'elenco sar\u00e0 un dizionario contenente un campo type e message (entrambe le stringhe). Ulteriori campi potrebbero essere disponibili a seconda del tipo di avviso.","title":"configfile"},{"location":"Status_Reference.html#display_status","text":"Le seguenti informazioni sono disponibili nell'oggetto display_status (questo oggetto \u00e8 automaticamente disponibile se \u00e8 definita una sezione di configurazione display ): progress : il valore di avanzamento dell'ultimo comando G-Code M73 (o virtual_sdcard.progress se non \u00e8 stato ricevuto alcun M73 recente). message : il messaggio contenuto nell'ultimo comando G-Code M117 .","title":"display_status"},{"location":"Status_Reference.html#endstop_phase","text":"Le seguenti informazioni sono disponibili nell'oggetto endstop_phase : last_home.<nome stepper>.phase : La fase del motore passo-passo al termine dell'ultimo tentativo di home. last_home.<stepper name>.phases : il numero totale di fasi disponibili sul motore passo-passo. last_home.<stepper name>.mcu_position : la posizione (tracciata dal microcontrollore) del motore passo-passo alla fine dell'ultimo tentativo di home. La posizione \u00e8 il numero totale di passi effettuati in avanti meno il numero totale di passi effettuati in senso inverso dall'ultimo riavvio del microcontrollore.","title":"endstop_phase"},{"location":"Status_Reference.html#exclude_object","text":"Le seguenti informazioni sono disponibili nell'oggetto exclude_object : objects : un array di oggetti conosciuti come fornito dal comando EXCLUDE_OBJECT_DEFINE . Queste sono le stesse informazioni fornite dal comando EXCLUDE_OBJECT VERBOSE=1 . I campi center e polygon saranno presenti solo se forniti nell'originale EXCLUDE_OBJECT_DEFINE Ecco un esempio JSON: [ { \"polygon\": [ [ 156.25, 146.2511675 ], [ 156.25, 153.7488325 ], [ 163.75, 153.7488325 ], [ 163.75, 146.2511675 ] ], \"name\": \"CYLINDER_2_STL_ID_2_COPY_0\", \"center\": [ 160, 150 ] }, { \"polygon\": [ [ 146.25, 146.2511675 ], [ 146.25, 153.7488325 ], [ 153.75, 153.7488325 ], [ 153.75, 146.2511675 ] ], \"name\": \"CYLINDER_2_STL_ID_1_COPY_0\", \"center\": [ 150, 150 ] } ] excluded_objects : un array di stringhe che elenca i nomi degli oggetti esclusi. current_object : il nome dell'oggetto attualmente in fase di stampa.","title":"exclude_object"},{"location":"Status_Reference.html#extruder_stepper","text":"Le seguenti informazioni sono disponibili per gli oggetti extruder_stepper (cos\u00ec come per gli oggetti extruder ): pressure_advance : il valore corrente di pressure advance . smooth_time : il tempo di avanzamento graduale della pressure advance corrente.","title":"extruder_stepper"},{"location":"Status_Reference.html#fan","text":"Le seguenti informazioni sono disponibili negli oggetti fan , heater_fan some_name e controller_fan some_name : speed : La velocit\u00e0 della ventola come float tra 0.0 e 1.0. rpm : la velocit\u00e0 della ventola misurata in rotazioni al minuto se la ventola ha un pin tachimetro definito.","title":"fan"},{"location":"Status_Reference.html#filament_switch_sensor","text":"Le seguenti informazioni sono disponibili negli oggetti filament_switch_sensor some_name : enabled : Restituisce True se il sensore interruttore \u00e8 attualmente abilitato. filament_detected : restituisce True se il sensore \u00e8 in uno stato attivato.","title":"filament_switch_sensor"},{"location":"Status_Reference.html#filament_motion_sensor","text":"Le seguenti informazioni sono disponibili negli oggetti filament_motion_sensor some_name : abilitato : Restituisce True se il sensore di movimento \u00e8 attualmente abilitato. filament_detected : restituisce True se il sensore \u00e8 in uno stato attivato.","title":"filament_motion_sensor"},{"location":"Status_Reference.html#firmware_retraction","text":"Le seguenti informazioni sono disponibili nell'oggetto firmware_retraction : retract_length , retract_speed , unretract_extra_length , unretract_speed : le impostazioni correnti per il modulo firmware_retraction. Queste impostazioni possono differire dal file di configurazione se un comando SET_RETRACTION le altera.","title":"firmware_retraction"},{"location":"Status_Reference.html#gcode_macro","text":"Le seguenti informazioni sono disponibili negli oggetti gcode_macro some_name : <variabile> : il valore corrente di una variabile gcode_macro .","title":"gcode_macro"},{"location":"Status_Reference.html#gcode_move","text":"Le seguenti informazioni sono disponibili nell'oggetto gcode_move (questo oggetto \u00e8 sempre disponibile): gcode_position : la posizione corrente della testa di stampa rispetto all'origine del Gcode corrente. Cio\u00e8, posizioni che si potrebbero inviare direttamente a un comando G1 . \u00c8 possibile accedere ai componenti x, y, z ed e di questa posizione (ad esempio, gcode_position.x ). position : l'ultima posizione comandata della testina utilizzando il sistema di coordinate specificato nel file di configurazione. \u00c8 possibile accedere alle componenti x, y, z ed e di questa posizione (ad esempio, position.x ). homing_origin : l'origine del sistema di coordinate gcode (relativo al sistema di coordinate specificato nel file di configurazione) da utilizzare dopo un comando G28 . Il comando SET_GCODE_OFFSET pu\u00f2 alterare questa posizione. \u00c8 possibile accedere ai componenti x, y e z di questa posizione (ad esempio, homing_origin.x ). speed : l'ultima velocit\u00e0 impostata in un comando G1 (in mm/s). speed_factor : La\"speed factor override\" come impostato da un comando M220 . Questo \u00e8 un valore in virgola mobile tale che 1,0 significa nessun override e, ad esempio, 2,0 raddoppierebbe la velocit\u00e0 richiesta. extrude_factor : L'\"extrude factor override\" come impostato da un comando M221 . Questo \u00e8 un valore in virgola mobile tale che 1,0 significa nessun override ad esempio 2,0 raddoppierebbe le estrusioni richieste. absolute_coordinates : restituisce True se in modalit\u00e0 coordinate assolute G90 o False se in modalit\u00e0 relativa G91 . absolute_extrude : restituisce True se in modalit\u00e0 di estrusione assoluta M82 o False se in modalit\u00e0 relativa M83 .","title":"gcode_move"},{"location":"Status_Reference.html#hall_filament_width_sensor","text":"Le seguenti informazioni sono disponibili nell'oggetto hall_filament_width_sensor : is_active : Restituisce True se il sensore \u00e8 attualmente attivo. Diameter : l'ultima lettura dal sensore in mm. Raw : l'ultima lettura grezza dell'ADC dal sensore.","title":"hall_filament_width_sensor"},{"location":"Status_Reference.html#riscaldatore","text":"Le seguenti informazioni sono disponibili per oggetti riscaldatore come extruder , heater_bed e heater_generic : temperature : l'ultima temperatura riportata (in gradi Celsius come float) per il dato riscaldatore. target : la temperatura target attuale (in gradi Celsius come float) per il riscaldatore dato. power : l'ultima impostazione del pin PWM (un valore compreso tra 0.0 e 1.0) associato al riscaldatore. can_extrude : Se l'estrusore pu\u00f2 estrudere (definito da min_extrude_temp ), disponibile solo per extruder","title":"Riscaldatore"},{"location":"Status_Reference.html#riscaldatori","text":"Le seguenti informazioni sono disponibili nell'oggetto heaters (questo oggetto \u00e8 disponibile se \u00e8 definito un riscaldatore): disponibili_riscaldatori : restituisce un elenco di tutti i riscaldatori attualmente disponibili in base ai nomi completi delle sezioni di configurazione, ad es. [\"extruder\", \"heater_bed\", \"heater_generic my_custom_heater\"] . available_sensors : restituisce un elenco di tutti i riscaldatori attualmente disponibili in base ai nomi completi delle sezioni di configurazione, ad es. [\"extruder\", \"heater_bed\", \"heater_generic my_custom_heater\"] .","title":"Riscaldatori"},{"location":"Status_Reference.html#idle_timeout","text":"Le seguenti informazioni sono disponibili nell'oggetto idle_timeout (questo oggetto \u00e8 sempre disponibile): state : lo stato corrente della stampante monitorato dal modulo idle_timeout. \u00c8 una delle seguenti stringhe: \"Idle\", \"Printing\", \"Ready\". printing_time : la quantit\u00e0 di tempo (in secondi) in cui la stampante \u00e8 rimasta nello stato \"Printing\" (come tracciato dal modulo idle_timeout).","title":"idle_timeout"},{"location":"Status_Reference.html#led","text":"Le seguenti informazioni sono disponibili per ogni sezione di configurazione [led led_name] , [neopixel led_name] , [dotstar led_name] , [pca9533 led_name] e [pca9632 led_name] definita in printer.cfg: color_data : un elenco di lista di colori contenenti i valori RGBW per ogni led nella catena. Ogni valore \u00e8 rappresentato come un float da 0,0 a 1,0. Ciascuna lista di colori contiene 4 voci (rosso, verde, blu, bianco) anche se il LED sottostante supporta meno canali di colore. Ad esempio, \u00e8 possibile accedere al valore blu (3\u00b0 elemento nell'elenco dei colori) del secondo neopixel in una catena in printer[\"neopixel <config_name>\"].color_data[1][2] .","title":"led"},{"location":"Status_Reference.html#manual_probe","text":"Le seguenti informazioni sono disponibili nell'oggetto manual_probe : is_active : Restituisce True se \u00e8 attualmente attivo uno script di supporto per il rilevamento manuale. z_position : l'altezza corrente dell'ugello (come la sta attualmente interpretando la stampante). z_position_lower : ultimo tentativo di sonda appena inferiore all'altezza corrente. z_position_upper : ultimo tentativo di sonda appena maggiore dell'altezza corrente.","title":"manual_probe"},{"location":"Status_Reference.html#mcu","text":"Le seguenti informazioni sono disponibili negli oggetti mcu e mcu some_name : mcu_version : la versione del codice Klipper riportata dal microcontrollore. mcu_build_versions : informazioni sugli strumenti di compilazione utilizzati per generare il codice del microcontrollore (come riportato dal microcontrollore). mcu_constants.<constant_name> : Elenca le costanti di tempo riportate dal microcontrollore. Le costanti disponibili possono differire tra le architetture del microcontrollore e con ogni revisione del codice. last_stats.<statistics_name> : informazioni statistiche sulla connessione del microcontrollore.","title":"mcu"},{"location":"Status_Reference.html#motion_report","text":"Le seguenti informazioni sono disponibili nell'oggetto motion_report (questo oggetto \u00e8 automaticamente disponibile se \u00e8 definita una sezione di configurazione stepper): live_position : la posizione richiesta della testa di stampa interpolata all'ora corrente. live_velocity : la velocit\u00e0 della testa di stampa richiesta (in mm/s) al momento attuale. live_extruder_velocity : la velocit\u00e0 dell'estrusore richiesta (in mm/s) al momento attuale.","title":"motion_report"},{"location":"Status_Reference.html#output_pin","text":"Le seguenti informazioni sono disponibili negli oggetti output_pin some_name : value : Il \"valore\" del pin, come impostato da un comando SET_PIN .","title":"output_pin"},{"location":"Status_Reference.html#palette2","text":"Le seguenti informazioni sono disponibili nell'oggetto palette2 : ping : Valore dell'ultimo ping di Palette 2 riportato in percentuale. remaining_load_length : Quando si avvia una stampa della Palette 2, questa sar\u00e0 la quantit\u00e0 di filamento da caricare nell'estrusore. is_splicing : Vero quando la Palette 2 sta giuntando il filamento.","title":"palette2"},{"location":"Status_Reference.html#pause_resume","text":"Le seguenti informazioni sono disponibili nell'oggetto pause_resume : is_paused : Restituisce vero se un comando PAUSE \u00e8 stato eseguito senza un corrispondente RESUME.","title":"pause_resume"},{"location":"Status_Reference.html#print_stats","text":"Le seguenti informazioni sono disponibili nell'oggetto print_stats (questo oggetto \u00e8 automaticamente disponibile se \u00e8 definita una sezione di configurazione virtual_sdcard ): filename , total_duration , print_duration , filament_used , state , message : informazioni stimate sulla stampa corrente quando \u00e8 attiva una stampa da virtual_sdcard. info.total_layer : Il valore totale del layer dell'ultimo comando G-Code SET_PRINT_STATS_INFO TOTAL_LAYER=<valore> . info.current_layer : il valore del layer corrente dell'ultimo comando G-Code SET_PRINT_STATS_INFO CURRENT_LAYER=<valore> .","title":"print_stats"},{"location":"Status_Reference.html#probe","text":"Le seguenti informazioni sono disponibili nell'oggetto probe (questo oggetto \u00e8 disponibile anche se \u00e8 definita una sezione di configurazione bltouch ): last_query : Restituisce True se il probe \u00e8 stato segnalato come \"attivato\" durante l'ultimo comando QUERY_PROBE. Nota, se questo viene utilizzato in una macro, a causa dell'ordine di espansione del modello, il comando QUERY_PROBE deve essere eseguito prima della macro contenente questo riferimento. last_z_result : Restituisce il valore del risultato Z dell'ultimo comando PROBE. Nota, se questo viene utilizzato in una macro, a causa dell'ordine di espansione del modello, il comando PROBE (o simile) deve essere eseguito prima della macro contenente questo riferimento.","title":"probe"},{"location":"Status_Reference.html#quad_gantry_level","text":"Le seguenti informazioni sono disponibili nell'oggetto quad_gantry_level (questo oggetto \u00e8 disponibile se quad_gantry_level \u00e8 definito): applied : Vero se il processo di livellamento del gantry \u00e8 stato eseguito e completato con successo.","title":"quad_gantry_level"},{"location":"Status_Reference.html#query_endstops","text":"Le seguenti informazioni sono disponibili nell'oggetto query_endstops (questo oggetto \u00e8 disponibile se \u00e8 definito un finecorsa): last_query[\"<endstop>\"] : Restituisce True se l'endstop specificato \u00e8 stato segnalato come \"attivato-triggered\" durante l'ultimo comando QUERY_ENDSTOP. Nota, se questo viene utilizzato in una macro, a causa dell'ordine di espansione del modello, il comando QUERY_ENDSTOP deve essere eseguito prima della macro contenente questo riferimento.","title":"query_endstops"},{"location":"Status_Reference.html#screws_tilt_adjust","text":"Le seguenti informazioni sono disponibili nell'oggetto screws_tilt_adjust : error : restituisce True se il comando SCREWS_TILT_CALCULATE pi\u00f9 recente includeva il parametro MAX_DEVIATION e uno qualsiasi dei punti della vite rilevati superava il MAX_DEVIATION specificato. results : un elenco delle posizioni delle viti rilevate. Ogni voce nell'elenco sar\u00e0 un dizionario contenente le seguenti chiavi: name : il nome della vite come specificato nel file di configurazione. x : la coordinata X della vite come specificato nel file di configurazione. y : la coordinata Y della vite come specificato nel file di configurazione. z : L'altezza Z misurata della posizione della vite. sign : Una stringa che specifica la direzione da girare per avvitare per la regolazione necessaria. O \"CW\" per senso orario o \"CCW\" per senso antiorario. La vite di base non avr\u00e0 una chiave di \"segno\". adjust : il numero di giri di vite per regolare la vite, dato nel formato \"HH:MM\", dove \"HH\" \u00e8 il numero di giri di vite completi e \"MM\" \u00e8 il numero di \"minuti di un quadrante di orologio\" che rappresenta un giro di vite parziale. (Es. \"01:15\" significherebbe girare la vite di un giro e un quarto.)","title":"screws_tilt_adjust"},{"location":"Status_Reference.html#servo","text":"Le seguenti informazioni sono disponibili negli oggetti servo some_name : printer[\"servo <config_name>\"].value : l'ultima impostazione del pin PWM (un valore compreso tra 0.0 e 1.0) associata al servo.","title":"servo"},{"location":"Status_Reference.html#system_stats","text":"Le seguenti informazioni sono disponibili nell'oggetto system_stats (questo oggetto \u00e8 sempre disponibile): sysload , cputime , memavail : informazioni sul sistema operativo del host e sul carico del processo.","title":"system_stats"},{"location":"Status_Reference.html#sensori-di-temperatura","text":"Le seguenti informazioni sono disponibili in bme280 config_section_name , htu21d config_section_name , lm75 config_section_name e temperature_host config_section_name : temperature : l'ultima temperatura letta dal sensore. humidity , pressure , gas : gli ultimi valori letti dal sensore (solo sui sensori bme280, htu21d e lm75).","title":"sensori di temperatura"},{"location":"Status_Reference.html#temperature_fan","text":"Le seguenti informazioni sono disponibili negli oggetti temperature_fan some_name : temperature : l'ultima temperatura letta dal sensore. target : La temperatura target per la ventola.","title":"temperature_fan"},{"location":"Status_Reference.html#temperature_sensor","text":"Le seguenti informazioni sono disponibili negli oggetti temperature_sensor some_nome : temperature : l'ultima temperatura letta dal sensore. measured_min_temp , measured_max_temp : la temperatura pi\u00f9 bassa e pi\u00f9 alta vista dal sensore dall'ultimo riavvio del software host Klipper.","title":"temperature_sensor"},{"location":"Status_Reference.html#driver-tmc","text":"Le seguenti informazioni sono disponibili negli oggetti TMC stepper driver (ad esempio, [tmc2208 stepper_x] ): mcu_phase_offset : La posizione dello stepper del microcontrollore corrispondente alla fase \"zero\" del driver. Questo campo pu\u00f2 essere nullo se l'offset di fase non \u00e8 noto. phase_offset_position : La \"posizione comandata\" corrispondente alla fase \"zero\" del driver. Questo campo pu\u00f2 essere nullo se l'offset di fase non \u00e8 noto. drv_status : i risultati dell'ultima query sullo stato del driver. (Sono riportati solo i campi diversi da zero.) Questo campo sar\u00e0 nullo se il driver non \u00e8 abilitato (e quindi non viene interrogato periodicamente). run_current : La corrente di esecuzione attualmente impostata. hold_current : La corrente di mantenimento attualmente impostata.","title":"driver tmc"},{"location":"Status_Reference.html#toolhead","text":"Le seguenti informazioni sono disponibili nell'oggetto toolhead (questo oggetto \u00e8 sempre disponibile): position : l'ultima posizione comandata della testa di stampa relativa al sistema di coordinate specificato nel file di configurazione. \u00c8 possibile accedere alle componenti x, y, z di questa posizione (ad esempio, position.x ). extruder : il nome dell'estrusore attualmente attivo. Ad esempio, in una macro si potrebbe usare printer[printer.toolhead.extruder].target per ottenere la temperatura target dell'estrusore corrente. homed_axes : Gli assi cartesiani correnti considerati in uno stato \"homed\". Questa \u00e8 una stringa contenente uno o pi\u00f9 di \"x\", \"y\", \"z\". axis_minimum , axis_maximum : i limiti di corsa dell'asse (mm) dopo la corsa di homing. \u00c8 possibile accedere alle componenti x, y, z di questo valore limite (ad es. axis_minimum.x , axis_minimum.z ). Per le stampanti Delta, cone_start_z \u00e8 l'altezza z massima al raggio massimo ( printer.toolhead.cone_start_z ). max_velocity , max_accel , max_accel_to_decel , square_corner_velocity : gli attuali limiti di stampa in vigore. Questo pu\u00f2 differire dalle impostazioni del file di configurazione se un comando SET_VELOCITY_LIMIT (o M204 ) le altera in fase di esecuzione. stalls : il numero totale di volte (dall'ultimo riavvio) che la stampante ha dovuto essere messa in pausa perch\u00e9 la testina si muoveva pi\u00f9 velocemente di quanto fosse possibile leggere i movimenti dall'input del G-code.","title":"toolhead"},{"location":"Status_Reference.html#dual_carriage","text":"Le seguenti informazioni sono disponibili in dual_carriage su una macchina hybrid_corexy o hybrid_corexz mode : la modalit\u00e0 corrente. I valori possibili sono: \"FULL_CONTROL\" active_carriage : il carrello attivo corrente. I valori possibili sono: \"CARRIAGE_0\", \"CARRIAGE_1\"","title":"dual_carriage"},{"location":"Status_Reference.html#virtual_sdcard","text":"Le seguenti informazioni sono disponibili nell'oggetto virtual_sdcard : is_active : Restituisce True se una stampa da file \u00e8 attualmente attiva. progress : una stima dello stato di avanzamento della stampa corrente (in base alla dimensione del file e alla posizione del file). file_path : un percorso completo del file per il file attualmente caricato. file_position : la posizione corrente (in byte) di una stampa attiva. file_size : la dimensione (in byte) del file attualmente caricato.","title":"virtual_sdcard"},{"location":"Status_Reference.html#webhooks","text":"Le seguenti informazioni sono disponibili nell'oggetto webhooks (questo oggetto \u00e8 sempre disponibile): state : restituisce una stringa che indica lo stato corrente di Klipper. I valori possibili sono: \"ready\", \"startup\", \"shutdown\", \"error\". state_message : una stringa leggibile dall'uomo che fornisce un contesto aggiuntivo sullo stato corrente di Klipper.","title":"webhooks"},{"location":"Status_Reference.html#z_thermal_adjust","text":"Le seguenti informazioni sono disponibili nell'oggetto z_thermal_adjust (questo oggetto \u00e8 disponibile se z_thermal_adjust \u00e8 definito). enabled : Restituisce True se la regolazione \u00e8 abilitata. temperature : temperatura attuale (livellata) del sensore definito. [grado C] measured_min_temp : temperatura minima misurata. [degC] measured_max_temp : Temperatura massima misurata. [degC] current_z_adjust : Ultima regolazione Z calcolata [mm]. z_adjust_ref_temperature :Temperatura di riferimento corrente utilizzata per il calcolo di Z current_z_adjust [degC].","title":"z_thermal_adjust"},{"location":"Status_Reference.html#z_tilt","text":"Le seguenti informazioni sono disponibili nell'oggetto z_tilt (questo oggetto \u00e8 disponibile se z_tilt \u00e8 definito): applied : Vero se il processo di livellamento z-tilt \u00e8 stato eseguito e completato con successo.","title":"z_tilt"},{"location":"TMC_Drivers.html","text":"Driver TMC \u00b6 Questo documento fornisce informazioni sull'utilizzo dei driver Trinamic per motori stepper in modalit\u00e0 SPI/UART su Klipper. Klipper pu\u00f2 anche utilizzare i driver Trinamic nella loro \"modalit\u00e0 standalone\". Tuttavia, quando i driver sono in questa modalit\u00e0, non \u00e8 necessaria alcuna configurazione speciale di Klipper e le funzionalit\u00e0 avanzate di Klipper discusse in questo documento non sono disponibili. Oltre a questo documento, assicurati di rivedere il riferimento alla configurazione del driver TMC . Regolazione della corrente del motore \u00b6 Una corrente pi\u00f9 alta del driver aumenta la precisione del posizionamento e la coppia. Tuttavia, una corrente pi\u00f9 elevata aumenta anche il calore prodotto dal motore passo-passo e dal driver del motore passo-passo. Se il driver del motore passo-passo si surriscalda, si disabiliter\u00e0 e Klipper segnaler\u00e0 un errore. Se il motore passo-passo si surriscalda, perde coppia e precisione di posizionamento. (Se diventa molto caldo, potrebbe anche fondere le parti di plastica attaccate o vicino ad esso.) Come consiglio generale per l'ottimizzazione, preferire valori di corrente pi\u00f9 elevati purch\u00e9 il motore passo-passo non si surriscaldi troppo e il driver del motore passo-passo non segnali avvisi o errori. In generale, va bene che il motore passo-passo sia caldo, ma non dovrebbe diventare cos\u00ec caldo da risultare doloroso al tatto. Preferibilmente non specificare un hold_current \u00b6 Se si configura un hold_current , il driver TMC pu\u00f2 ridurre la corrente al motore passo-passo quando rileva che il passo-passo non si sta muovendo. Tuttavia, la variazione della corrente del motore pu\u00f2 di per s\u00e9 introdurre il movimento del motore. Ci\u00f2 pu\u00f2 verificarsi a causa di \"forze di arresto\" all'interno del motore passo-passo (il magnete permanente nel rotore tira verso i denti di ferro nello statore) o a causa di forze esterne sul carrello dell'asse. La maggior parte dei motori passo-passo non otterr\u00e0 un beneficio significativo dalla riduzione della corrente durante le normali stampe, perch\u00e9 pochi movimenti di stampa lasceranno un motore passo-passo inattivo per un tempo sufficientemente lungo da attivare la funzione hold_current . Ed \u00e8 improbabile che si vogliano introdurre sottili artefatti di stampa nelle poche mosse di stampa che lasciano uno stepper inattivo sufficientemente a lungo. Se si desidera ridurre la corrente ai motori durante le routine di avvio della stampa, considerare l'emissione di comandi SET_TMC_CURRENT in una START_PRINT macro per regolare la corrente prima e dopo i normali spostamenti di stampa. Alcune stampanti con motori Z dedicati che sono inattivi durante i normali movimenti di stampa (nessuna bed_mesho, nessuna inclinazione_piatto, nessuna correzione_inclinazione Z, nessuna stampa in \"modalit\u00e0 vaso\", ecc.) potrebbero scoprire che i motori Z funzionano a temperature pi\u00f9 basse con un hold_current . Se si implementa questo, assicurarsi di prendere in considerazione questo tipo di movimento dell'asse Z non comandato durante il livellamento del piatto, il rilevamento del piatto, la calibrazione della sonda e simili. Anche driver_TPOWERDOWN e driver_IHOLDDELAY dovrebbero essere calibrati di conseguenza. Se non sei sicuro, preferisci non specificare un hold_current . Impostazione della modalit\u00e0 \"spreadCycle\" rispetto a \"stealthChop\" \u00b6 Per impostazione predefinita, Klipper mette i driver TMC in modalit\u00e0 \"spreadCycle\". Se il driver supporta \"stealthChop\", pu\u00f2 essere abilitato aggiungendo stealthchop_threshold: 999999 alla sezione di configurazione di TMC. In generale, la modalit\u00e0 SpreadCycle fornisce una coppia maggiore e una maggiore precisione di posizionamento rispetto alla modalit\u00e0 StealthChop. Tuttavia, la modalit\u00e0 StealthChop pu\u00f2 produrre un rumore udibile notevolmente inferiore su alcune stampanti. I test di confronto delle modalit\u00e0 hanno mostrato un \"ritardo posizionale\" aumentato di circa il 75% di un passo completo durante i movimenti a velocit\u00e0 costante quando si utilizza la modalit\u00e0 StealthChop (ad esempio, su una stampante con distanza_rotazione di 40 mm e 200 passi_per_rotazione, la deviazione di posizione dei movimenti a velocit\u00e0 costante \u00e8 aumentata di ~0,150 mm). Tuttavia, questo \"ritardo nell'ottenimento della posizione richiesta\" potrebbe non manifestarsi come un difetto di stampa significativo e si potrebbe preferire il comportamento pi\u00f9 silenzioso della modalit\u00e0 stealthChop. Si consiglia di utilizzare sempre la modalit\u00e0 \"spreadCycle\" (non specificando stealthchop_threshold ) o di utilizzare sempre la modalit\u00e0 \"stealthChop\" (impostando stealthchop_threshold su 999999). Sfortunatamente, i driver spesso producono risultati scadenti e confusi se la modalit\u00e0 cambia mentre il motore \u00e8 a una velocit\u00e0 diversa da zero. L'impostazione dell'interpolazione TMC introduce una piccola deviazione di posizione \u00b6 L'impostazione interpolate del driver TMC pu\u00f2 ridurre il rumore udibile del movimento della stampante a costo di introdurre un piccolo errore di posizione sistemico. Questo errore di posizione sistematico deriva dal ritardo del driver nell'esecuzione dei \"passi\" inviati da Klipper. Durante i movimenti a velocit\u00e0 costante, questo ritardo si traduce in un errore di posizione di quasi mezzo micropasso configurato (pi\u00f9 precisamente, l'errore \u00e8 di mezzo micropasso meno un 512esimo di un passo intero). Ad esempio, su un asse con una distanza_rotazione di 40 mm, 200 passi_per_rotazione e 16 micropassi, l'errore sistemico introdotto durante i movimenti a velocit\u00e0 costante \u00e8 ~0,006 mm. Per una migliore precisione di posizionamento, considerare l'utilizzo della modalit\u00e0 SpreadCycle e disabilitare l'interpolazione (impostare interpolate: False nella configurazione del driver TMC). Se configurato in questo modo, \u00e8 possibile aumentare l'impostazione microstep per ridurre il rumore udibile durante il movimento del passo-passo. Tipicamente, un'impostazione microstep di 64 o 128 avr\u00e0 un rumore udibile simile all'interpolazione e lo far\u00e0 senza introdurre un errore posizionale sistemico. Se si utilizza la modalit\u00e0 StealthChop, l'imprecisione posizionale dell'interpolazione \u00e8 piccola rispetto all'imprecisione posizionale introdotta dalla modalit\u00e0 StealthChop. Pertanto l'interpolazione dell'ottimizzazione non \u00e8 considerata utile in modalit\u00e0 StealthChop e si pu\u00f2 lasciare l'interpolazione nel suo stato predefinito. Homing Sensorless \u00b6 L'homing senza sensori consente di posizionare un asse senza la necessit\u00e0 di un finecorsa fisico. Invece, il carrello sull'asse viene spostato nel finecorsa meccanico facendo perdere passi al motore passo-passo. Il driver stepper rileva i passi persi e lo indica all'MCU di controllo (Klipper) attivando un pin. Queste informazioni possono essere utilizzate da Klipper come fine corsa per l'asse. Questa guida illustra l'impostazione dell'homing sensorless per l'asse X della stampante (cartesiana). Tuttavia, funziona allo stesso modo con tutti gli altri assi (che richiedono un fine corsa). Dovresti configurarlo e sintonizzarlo per un asse alla volta. Limitazioni \u00b6 Assicurati che i tuoi componenti meccanici siano in grado di sopportare il carico del carrello che urta ripetutamente il limite dell'asse. Soprattutto le viti di comando potrebbero generare molta forza. L'homing di un asse Z facendo urtare l'ugello sulla superficie di stampa potrebbe non essere una buona idea. Per ottenere i migliori risultati, verificare che il carrello dell'asse stabilisca un contatto stabile con il limite dell'asse. Inoltre, l'homing sensorless potrebbe non essere sufficientemente preciso per la tua stampante. Sebbene l'homing degli assi X e Y su una macchina cartesiana possa funzionare bene, l'homing dell'asse Z in genere non \u00e8 sufficientemente preciso e pu\u00f2 comportare un'altezza del primo strato incoerente. L'homing di una stampante delta sensorless non \u00e8 consigliabile a causa della mancanza di precisione. Inoltre, il rilevamento dello stallo del driver passo-passo dipende dal carico meccanico sul motore, dalla corrente del motore e dalla temperatura del motore (resistenza della bobina). L'homing sensorless funziona meglio a velocit\u00e0 medie del motore. Per velocit\u00e0 molto basse (inferiori a 10 giri/min) il motore non genera una significativa EMF di ritorno e il TMC non \u00e8 in grado di rilevare in modo affidabile gli stalli del motore. Inoltre, a velocit\u00e0 molto elevate, l'EMF di ritorno del motore si avvicina alla tensione di alimentazione del motore, quindi il TMC non \u00e8 pi\u00f9 in grado di rilevare gli stalli. Si consiglia di dare un'occhiata alla scheda tecnica del proprio TMC specifico. L\u00ec puoi anche trovare maggiori dettagli sulle limitazioni di questa configurazione. Prerequisiti \u00b6 Sono necessari alcuni prerequisiti per utilizzare l'homing sensorless: Driver passo-passo TMC compatibile con stallGuard (tmc2130, tmc2209, tmc2660 o tmc5160). Interfaccia SPI/UART del driver TMC cablata al microcontrollore (la modalit\u00e0 stand-alone non funziona). Il pin \"DIAG\" o \"SG_TST\" appropriato del driver TMC collegato al microcontrollore. I passaggi nel documento config checks devono essere eseguiti per confermare che i motori passo-passo siano configurati e funzionino correttamente. Messa a punto \u00b6 La procedura qui descritta prevede sei passaggi principali: Scegli una velocit\u00e0 di homing. Configura il file printer.cfg per abilitare l'homing sensorless. Trova l'impostazione stallguard con la massima sensibilit\u00e0 che funziona con successo. Trova l'impostazione stallguard con la sensibilit\u00e0 pi\u00f9 bassa che effettua homing con successo con un solo tocco. Aggiorna il printer.cfg con l'impostazione di stallguard desiderata. Crea o aggiorna le macro printer.cfg per homing in modo coerente. Scegli la velocit\u00e0 di homing \u00b6 La velocit\u00e0 di homing \u00e8 una scelta importante quando si esegue l'homing senza sensori. \u00c8 consigliabile utilizzare una velocit\u00e0 di riferimento bassa in modo che il carrello non eserciti una forza eccessiva sul telaio quando entra in contatto con l'estremit\u00e0 della rotaia. Tuttavia, i driver TMC non sono in grado di rilevare in modo affidabile uno stallo a velocit\u00e0 molto basse. Un buon punto di partenza per la velocit\u00e0 di homing \u00e8 che il motore passo-passo esegua una rotazione completa ogni due secondi. Per molti assi questa sar\u00e0 la rotation_distance divisa per due. Per esempio: [stepper_x] rotation_distance: 40 homing_speed: 20 ... Configura printer.cfg per l'homing sensorless \u00b6 L'impostazione homing_retract_dist deve essere impostata su zero nella sezione di configurazione stepper_x per disabilitare il secondo movimento di homing. Il secondo tentativo di homing non aggiunge valore quando si utilizza l'homing sensorless, non funzioner\u00e0 in modo affidabile e confonder\u00e0 il processo di ottimizzazione. Assicurati che un'impostazione hold_current non sia specificata nella sezione del driver TMC del file config. (Se viene impostata una hold_current, dopo che \u00e8 stato stabilito il contatto, il motore si arresta mentre il carrello viene premuto contro l'estremit\u00e0 del binario e la riduzione della corrente mentre si trova in quella posizione pu\u00f2 causare il movimento del carrello, il che si traduce in prestazioni scadenti e confonde il processo di regolazione.) \u00c8 necessario configurare i pin di homing sensorless e configurare le impostazioni iniziali di \"stallguard\". Una configurazione di esempio tmc2209 per un asse X potrebbe essere simile a: [tmc2209 stepper_x] diag_pin: ^PA1 # Impostare sul pin MCU collegato al pin TMC DIAG driver_SGTHRS: 255 #255 \u00e8 il valore pi\u00f9 sensibile, 0 \u00e8 il meno sensibile ... [stepper_x] endstop_pin: tmc2209_stepper_x:virtual_endstop homing_retract_dist: 0 ... Un esempio di configurazione tmc2130 o tmc5160 potrebbe essere simile a: [tmc2130 stepper_x] diag1_pin: ^!PA1 # Pin collegato al pin TMC DIAG1 (o utilizzare pin diag0_pin / DIAG0) driver_SGT: -64 # -64 \u00e8 il valore pi\u00f9 sensibile, 63 \u00e8 il meno sensibile ... [stepper_x] endstop_pin: tmc2130_stepper_x:virtual_endstop homing_retract_dist: 0 ... Un esempio di configurazione di tmc2660 potrebbe essere simile a: [tmc2660 stepper_x] driver_SGT: -64 # -64 \u00e8 il valore pi\u00f9 sensibile, 63 \u00e8 il meno sensibile ... [stepper_x] endstop_pin: ^PA1 # Pin collegato al pin TMC SG_TST homing_retract_dist: 0 ... Gli esempi sopra mostrano solo le impostazioni specifiche per l'homing sensorless. Vedere il riferimento alla configurazione per tutte le opzioni disponibili. Trova la massima sensibilit\u00e0 che porta a homing con successo \u00b6 Posizionare il carrello vicino al centro del binario. Utilizzare il comando SET_TMC_FIELD per impostare la sensibilit\u00e0 pi\u00f9 alta. Per tmc2209: SET_TMC_FIELD STEPPER=stepper_x FIELD=SGTHRS VALUE=255 Per tmc2130, tmc5160 e tmc2660: SET_TMC_FIELD STEPPER=stepper_x FIELD=sgt VALUE=-64 Quindi inviare un comando G28 X0 e verificare che l'asse non si muova affatto o smetta rapidamente di muoversi. Se l'asse non si ferma, inviare un M112 per fermare la stampante - qualcosa non \u00e8 corretto con il cablaggio o la configurazione dei pin diag/sg_tst e deve essere corretto prima di continuare. Quindi, diminuire progressivamente la sensibilit\u00e0 dell'impostazione VALUE ed eseguire nuovamente i comandi SET_TMC_FIELD G28 X0 per trovare la sensibilit\u00e0 pi\u00f9 alta che fa s\u00ec che il carrello si muova con successo fino all'arresto e si arresti. (Per i driver tmc2209 questo diminuir\u00e0 SGTHRS, per altri conducenti aumenter\u00e0 il sgt.) Assicurati di iniziare ogni tentativo con il carrello vicino al centro del binario (se necessario, emetti M84 e quindi sposta manualmente il carrello sul centro). Dovrebbe essere possibile trovare la sensibilit\u00e0 pi\u00f9 alta che si adatta in modo affidabile (le impostazioni con una sensibilit\u00e0 pi\u00f9 alta comportano movimenti piccoli o nulli). Nota il valore trovato come sensibilit\u00e0_massima . (Se si ottiene la sensibilit\u00e0 minima possibile (SGTHRS=0 o sgt=63) senza alcun movimento del carrello, allora qualcosa non \u00e8 corretto con il cablaggio o la configurazione dei pin diag/sg_tst e deve essere corretto prima di continuare.) Quando si cerca la sensibilit\u00e0_massima, pu\u00f2 essere conveniente passare a diverse impostazioni VALUE (in modo da dividere in due il parametro VALUE). In tal caso, prepararsi a emettere un comando M112 per arrestare la stampante, poich\u00e9 un'impostazione con una sensibilit\u00e0 molto bassa potrebbe far \"sbattere\" ripetutamente l'asse contro l'estremit\u00e0 del binario. Assicurati di attendere un paio di secondi tra ogni tentativo di homing. Dopo che il driver TMC ha rilevato uno stallo, potrebbe volerci un po' di tempo per cancellare il suo indicatore interno ed essere in grado di rilevare un altro stallo. Durante questi test di ottimizzazione, se un comando G28 X0 non si sposta fino al limite dell'asse, prestare attenzione nell'emettere qualsiasi comando di movimento regolare (ad es. G1 ). Klipper non avr\u00e0 una corretta comprensione della posizione del carrello e un comando di spostamento potrebbe causare risultati indesiderati e confusi. Trova la sensibilit\u00e0 pi\u00f9 bassa che porta a homing con un solo tocco \u00b6 Quando si effettua l'homing con il valore maximum_sensitivity trovato, l'asse dovrebbe spostarsi all'estremit\u00e0 del binario e fermarsi con un \"tocco singolo\", ovvero non dovrebbe esserci un \"clic\" o un \"sbattere\". (Se c'\u00e8 un suono che sbatte o scatta alla sensibilit\u00e0_massima, allora la velocit\u00e0 di riferimento potrebbe essere troppo bassa, la corrente del driver potrebbe essere troppo bassa o la corsa di riferimento senza sensore potrebbe non essere una buona scelta per l'asse.) Il passo successivo \u00e8 spostare di nuovo continuamente il carrello in una posizione vicino al centro della rotaia, diminuire la sensibilit\u00e0 ed eseguire i comandi SET_TMC_FIELD G28 X0 - l'obiettivo ora \u00e8 trovare la sensibilit\u00e0 pi\u00f9 bassa che risulti ancora nel la carrozza torna con successo al punto di riferimento con un \"tocco singolo\". Cio\u00e8, non \"sbatte\" o \"clic\" quando viene a contatto con l'estremit\u00e0 del binario. Nota il valore trovato come sensibilit\u00e0_minima . Aggiorna printer.cfg con il valore della sensibilit\u00e0 \u00b6 Dopo aver trovato sensibilit\u00e0_massima e sensibilit\u00e0_minima , utilizzare una calcolatrice per ottenere la sensibilit\u00e0 consigliata come sensibilit\u00e0_minima + (sensibilit\u00e0_massima - sensibilit\u00e0_minima)/3 . La sensibilit\u00e0 consigliata dovrebbe essere compresa tra il minimo e il massimo, ma leggermente pi\u00f9 vicino al minimo. Arrotonda il valore finale al valore intero pi\u00f9 vicino. Per tmc2209 impostalo nella configurazione come driver_SGTHRS , per altri driver TMC impostalo nella configurazione come driver_SGT . Se l'intervallo tra sensibilit\u00e0_massima e sensibilit\u00e0_minima \u00e8 piccolo (ad esempio, inferiore a 5), potrebbe risultare in un homing instabile. Una velocit\u00e0 di riferimento pi\u00f9 elevata pu\u00f2 aumentare il range e rendere l'operazione pi\u00f9 stabile. Si noti che se viene apportata una modifica alla corrente del driver, alla velocit\u00e0 di riferimento o viene apportata una modifica notevole all'hardware della stampante, sar\u00e0 necessario eseguire nuovamente il processo di ottimizzazione. Utilizzo delle macro durante l'homing \u00b6 Dopo aver completato l'homing senza sensori, il carrello verr\u00e0 premuto contro l'estremit\u00e0 del binario e lo stepper eserciter\u00e0 una forza sul telaio fino a quando il carrello non si allontana. \u00c8 una buona idea creare una macro per posizionare l'asse e allontanare immediatamente il carrello dall'estremit\u00e0 della rotaia. \u00c8 una buona idea che la macro si metta in pausa di almeno 2 secondi prima di iniziare l'homing sensorless (o altrimenti assicurarsi che non ci siano stati movimenti sullo stepper per 2 secondi). Senza ritardo \u00e8 possibile che il flag di stallo interno del driver sia ancora impostato da un movimento precedente. Pu\u00f2 anche essere utile fare in modo che quella macro imposti la corrente del driver prima della corsa di riferimento e imposti una nuova corrente dopo che il carrello si \u00e8 allontanato. Una macro di esempio potrebbe assomigliare a: [gcode_macro SENSORLESS_HOME_X] gcode: {% set HOME_CUR = 0.700 %} {% set driver_config = printer.configfile.settings['tmc2209 stepper_x'] %} {% set RUN_CUR = driver_config.run_current %} # Imposta la corrente per l'homing sensorless SET_TMC_CURRENT STEPPER=stepper_x CURRENT={HOME_CUR} # Fai una pausa per assicurarti che il flag di stallo del driver sia clear G4 P2000 # Home G28 X0 # Spostamento G90 G1 X5 F1200 # Imposta corrente durante la stampa SET_TMC_CURRENT STEPPER=stepper_x CURRENT={RUN_CUR} La macro risultante pu\u00f2 essere chiamata da una sezione di configurazione homing_override o da una START_PRINT macro . Si noti che se viene modificata la corrente del driver durante l'homing, il processo di ottimizzazione dovrebbe essere eseguito nuovamente. Suggerimenti per l'homing sensorless su CoreXY \u00b6 \u00c8 possibile utilizzare l'homing sensorless sui carrelli X e Y di una stampante CoreXY. Klipper usa lo stepper [stepper_x] per rilevare gli stalli durante l'homing del carrello X e usa lo stepper [stepper_y] per rilevare gli stalli durante l'homing del carrello Y. Utilizzare la guida alla messa a punto sopra descritta per trovare la \"sensibilit\u00e0 allo stallo\" appropriata per ciascun carrello, ma prestare attenzione alle seguenti restrizioni: Quando si utilizza l'homing sensorless su CoreXY, assicurarsi che non sia configurato hold_current per nessuno dei due stepper. Durante la messa a punto, assicurati che entrambi i carrelli X e Y siano vicini al centro dei loro binari prima di ogni tentativo di homing. Al termine dell'ottimizzazione, quando si esegue l'homing sia di X che Y, utilizzare le macro per assicurarsi che un asse sia homed per primo, quindi spostare il carrello lontano dal limite dell'asse, fare una pausa per almeno 2 secondi, quindi avviare l'orientamento dell'altro carrello. L'allontanamento dall'asse evita l'homing di un asse mentre l'altro viene premuto contro il limite dell'asse (cosa potrebbe distorcere il rilevamento dello stallo). La pausa \u00e8 necessaria per garantire che il flag di stallo del driver sia cancellata prima del homing. Un esempio di macro homing CoreXY potrebbe essere simile a: [gcode_macro HOME] gcode: G90 # Home Z G28 Z0 G1 Z10 F1200 # Home Y G28 Y0 G1 Y5 F1200 # Home X G4 P2000 G28 X0 G1 X5 F1200 Interrogazione e diagnosi delle impostazioni del driver \u00b6 Il comando DUMP_TMC \u00e8 uno strumento utile durante la configurazione e la diagnosi dei driver. Riporter\u00e0 tutti i campi configurati da Klipper cos\u00ec come tutti i campi che possono essere interrogati dal driver. Tutti i campi riportati sono definiti nella scheda tecnica Trinamic per ciascun driver. Queste schede tecniche possono essere trovate sul sito web Trinamic . Ottenere e rivedere i dati Trinamic affinch\u00e9 il conducente interpreti i risultati di DUMP_TMC. Configurazione delle impostazioni driver_XXX \u00b6 Klipper supporta la configurazione di molti campi driver di basso livello usando le impostazioni driver_XXX . Il Riferimento alla configurazione del driver TMC contiene l'elenco completo dei campi disponibili per ogni tipo di driver. Inoltre, quasi tutti i campi possono essere modificati in fase di esecuzione utilizzando il comando SET_TMC_FIELD . Ciascuno di questi campi \u00e8 definito nella scheda tecnica Trinamic per ciascun driver. Queste schede tecniche possono essere trovate sul sito web Trinamic . Si noti che i fogli dati Trinamic a volte utilizzano un'espressione che pu\u00f2 confondere un'impostazione di alto livello (come \"fine isteresi\") con un valore di campo di basso livello (ad esempio, \"HEND\"). In Klipper, driver_XXX e SET_TMC_FIELD impostano sempre il valore del campo di basso livello che viene effettivamente scritto nel driver. Quindi, ad esempio, se il foglio dati Trinamic afferma che \u00e8 necessario scrivere un valore di 3 nel campo HEND per ottenere una \"fine dell'isteresi\" di 0, impostare driver_HEND=3 per ottenere il valore di alto livello di 0. Domande comuni \u00b6 Posso usare la modalit\u00e0 StealthChop su un estrusore con anticipo della pressione? \u00b6 Molte persone usano con successo la modalit\u00e0 \"stealthChop\" con pressure advance di Klipper. Klipper implementa Smooth Pressure Advance che non introduce variazioni di velocit\u00e0 istantanee. Tuttavia, la modalit\u00e0 \"stealthChop\" pu\u00f2 produrre una coppia del motore inferiore e/o produrre un maggiore calore del motore. Potrebbe essere o meno una modalit\u00e0 adeguata per la tua particolare stampante. Continuo a ricevere gli errori \"Impossibile leggere tmc uart 'stepper_x' register IFCNT\"? \u00b6 Ci\u00f2 si verifica quando Klipper non \u00e8 in grado di comunicare con un driver tmc2208 o tmc2209. Assicurarsi che l'alimentazione del motore sia abilitata, poich\u00e9 il driver del motore passo-passo generalmente necessita dell'alimentazione del motore prima di poter comunicare con il microcontrollore. Se questo errore si verifica dopo aver eseguito il flashing di Klipper per la prima volta, \u00e8 possibile che il driver stepper sia stato precedentemente programmato in uno stato non compatibile con Klipper. Per ripristinare lo stato, rimuovere tutta l'alimentazione dalla stampante per alcuni secondi (scollegare fisicamente sia USB che le spine di alimentazione). In caso contrario, questo errore \u00e8 in genere il risultato di un cablaggio errato del pin UART o di una configurazione Klipper errata delle impostazioni del pin UART. Continuo a ricevere errori \"Unable to write tmc spi 'stepper_x' register ...\"? \u00b6 Ci\u00f2 si verifica quando Klipper non \u00e8 in grado di comunicare con un driver tmc2130 o tmc5160. Assicurarsi che l'alimentazione del motore sia abilitata, poich\u00e9 il driver del motore passo-passo generalmente necessita dell'alimentazione del motore prima di poter comunicare con il microcontrollore. In caso contrario, questo errore \u00e8 in genere il risultato di un cablaggio SPI errato, una configurazione Klipper errata delle impostazioni SPI o una configurazione incompleta dei dispositivi su un bus SPI. Nota che se il driver si trova su un bus SPI condiviso con pi\u00f9 dispositivi, assicurati di configurare completamente ogni dispositivo su quel bus SPI condiviso in Klipper. Se un dispositivo su un bus SPI condiviso non \u00e8 configurato, potrebbe rispondere in modo errato a comandi non previsti e danneggiare la comunicazione con il dispositivo previsto. Se \u00e8 presente un dispositivo su un bus SPI condiviso che non pu\u00f2 essere configurato in Klipper, utilizzare una sezione di configurazione static_digital_output per impostare il pin CS del dispositivo inutilizzato alto (in modo che non tenti utilizzare il bus SPI). Lo schema della scheda \u00e8 spesso un utile riferimento per trovare quali dispositivi si trovano su un bus SPI e i pin associati. Perch\u00e9 ho ricevuto un errore \"TMC reports error: ...\"? \u00b6 Questo tipo di errore indica che il driver TMC ha rilevato un problema e si \u00e8 disabilitato. Cio\u00e8, il conducente ha smesso di mantenere la sua posizione e ha ignorato i comandi di movimento. Se Klipper rileva che un driver attivo si \u00e8 disabilitato, la stampante passer\u00e0 allo stato di \"spegnimento\". \u00c8 anche possibile che si verifichi un arresto TMC segnala errore a causa di errori SPI che impediscono la comunicazione con il driver (su tmc2130, tmc5160 o tmc2660). Se ci\u00f2 si verifica, \u00e8 normale che lo stato del driver riportato mostri 00000000 o ffffffff , ad esempio: TMC reports error: DRV_STATUS: ffffffff ... O TMC reports error: READRSP@RDSEL2: 00000000 ... . Tale errore pu\u00f2 essere dovuto a un problema di cablaggio SPI o pu\u00f2 essere dovuto a un ripristino automatico o a un guasto del driver TMC. Alcuni errori comuni e suggerimenti per diagnosticarli: TMC segnala l'errore: ... ot=1(OvertempError!) \u00b6 Ci\u00f2 indica che il driver del motore si \u00e8 disabilitato perch\u00e9 \u00e8 diventato troppo caldo. Le soluzioni tipiche consistono nel ridurre la corrente del motore passo-passo, aumentare il raffreddamento sul driver del motore passo-passo e/o aumentare il raffreddamento sul motore passo-passo. TMC segnala un errore: ... ShortToGND O LowSideShort \u00b6 Ci\u00f2 indica che il driver si \u00e8 disabilitato perch\u00e9 ha rilevato una corrente molto elevata che passa attraverso il driver. Ci\u00f2 potrebbe indicare un filo allentato o in cortocircuito al motore passo-passo o all'interno del motore passo-passo stesso. Questo errore pu\u00f2 verificarsi anche se si utilizza la modalit\u00e0 StealthChop e il driver TMC non \u00e8 in grado di prevedere con precisione il carico meccanico del motore. (Se il driver fa una previsione scadente, potrebbe inviare troppa corrente attraverso il motore e attivare il proprio rilevamento di sovracorrente.) Per verificarlo, disabilitare la modalit\u00e0 StealthChop e verificare se gli errori continuano a verificarsi. TMC segnala un errore: ... reset=1(Reset) OR CS_ACTUAL=0(Reset?) OR SE=0(Reset?) \u00b6 Ci\u00f2 indica che il driver si \u00e8 ripristinato durante la stampa. Ci\u00f2 potrebbe essere dovuto a problemi di tensione o cablaggio. TMC segnala l'errore: ... uv_cp=1(Undervoltage!) \u00b6 Ci\u00f2 indica che il driver ha rilevato un evento di bassa tensione e si \u00e8 disabilitato. Ci\u00f2 potrebbe essere dovuto a problemi di cablaggio o alimentazione. Come si regola la modalit\u00e0 spreadCycle/coolStep/etc. sui miei driver? \u00b6 Il sito web Trinamic contiene guide sulla configurazione dei driver. Queste guide sono spesso tecniche, di basso livello e potrebbero richiedere hardware specializzato. In ogni caso, sono la migliore fonte di informazioni.","title":"Driver TMC"},{"location":"TMC_Drivers.html#driver-tmc","text":"Questo documento fornisce informazioni sull'utilizzo dei driver Trinamic per motori stepper in modalit\u00e0 SPI/UART su Klipper. Klipper pu\u00f2 anche utilizzare i driver Trinamic nella loro \"modalit\u00e0 standalone\". Tuttavia, quando i driver sono in questa modalit\u00e0, non \u00e8 necessaria alcuna configurazione speciale di Klipper e le funzionalit\u00e0 avanzate di Klipper discusse in questo documento non sono disponibili. Oltre a questo documento, assicurati di rivedere il riferimento alla configurazione del driver TMC .","title":"Driver TMC"},{"location":"TMC_Drivers.html#regolazione-della-corrente-del-motore","text":"Una corrente pi\u00f9 alta del driver aumenta la precisione del posizionamento e la coppia. Tuttavia, una corrente pi\u00f9 elevata aumenta anche il calore prodotto dal motore passo-passo e dal driver del motore passo-passo. Se il driver del motore passo-passo si surriscalda, si disabiliter\u00e0 e Klipper segnaler\u00e0 un errore. Se il motore passo-passo si surriscalda, perde coppia e precisione di posizionamento. (Se diventa molto caldo, potrebbe anche fondere le parti di plastica attaccate o vicino ad esso.) Come consiglio generale per l'ottimizzazione, preferire valori di corrente pi\u00f9 elevati purch\u00e9 il motore passo-passo non si surriscaldi troppo e il driver del motore passo-passo non segnali avvisi o errori. In generale, va bene che il motore passo-passo sia caldo, ma non dovrebbe diventare cos\u00ec caldo da risultare doloroso al tatto.","title":"Regolazione della corrente del motore"},{"location":"TMC_Drivers.html#preferibilmente-non-specificare-un-hold_current","text":"Se si configura un hold_current , il driver TMC pu\u00f2 ridurre la corrente al motore passo-passo quando rileva che il passo-passo non si sta muovendo. Tuttavia, la variazione della corrente del motore pu\u00f2 di per s\u00e9 introdurre il movimento del motore. Ci\u00f2 pu\u00f2 verificarsi a causa di \"forze di arresto\" all'interno del motore passo-passo (il magnete permanente nel rotore tira verso i denti di ferro nello statore) o a causa di forze esterne sul carrello dell'asse. La maggior parte dei motori passo-passo non otterr\u00e0 un beneficio significativo dalla riduzione della corrente durante le normali stampe, perch\u00e9 pochi movimenti di stampa lasceranno un motore passo-passo inattivo per un tempo sufficientemente lungo da attivare la funzione hold_current . Ed \u00e8 improbabile che si vogliano introdurre sottili artefatti di stampa nelle poche mosse di stampa che lasciano uno stepper inattivo sufficientemente a lungo. Se si desidera ridurre la corrente ai motori durante le routine di avvio della stampa, considerare l'emissione di comandi SET_TMC_CURRENT in una START_PRINT macro per regolare la corrente prima e dopo i normali spostamenti di stampa. Alcune stampanti con motori Z dedicati che sono inattivi durante i normali movimenti di stampa (nessuna bed_mesho, nessuna inclinazione_piatto, nessuna correzione_inclinazione Z, nessuna stampa in \"modalit\u00e0 vaso\", ecc.) potrebbero scoprire che i motori Z funzionano a temperature pi\u00f9 basse con un hold_current . Se si implementa questo, assicurarsi di prendere in considerazione questo tipo di movimento dell'asse Z non comandato durante il livellamento del piatto, il rilevamento del piatto, la calibrazione della sonda e simili. Anche driver_TPOWERDOWN e driver_IHOLDDELAY dovrebbero essere calibrati di conseguenza. Se non sei sicuro, preferisci non specificare un hold_current .","title":"Preferibilmente non specificare un hold_current"},{"location":"TMC_Drivers.html#impostazione-della-modalita-spreadcycle-rispetto-a-stealthchop","text":"Per impostazione predefinita, Klipper mette i driver TMC in modalit\u00e0 \"spreadCycle\". Se il driver supporta \"stealthChop\", pu\u00f2 essere abilitato aggiungendo stealthchop_threshold: 999999 alla sezione di configurazione di TMC. In generale, la modalit\u00e0 SpreadCycle fornisce una coppia maggiore e una maggiore precisione di posizionamento rispetto alla modalit\u00e0 StealthChop. Tuttavia, la modalit\u00e0 StealthChop pu\u00f2 produrre un rumore udibile notevolmente inferiore su alcune stampanti. I test di confronto delle modalit\u00e0 hanno mostrato un \"ritardo posizionale\" aumentato di circa il 75% di un passo completo durante i movimenti a velocit\u00e0 costante quando si utilizza la modalit\u00e0 StealthChop (ad esempio, su una stampante con distanza_rotazione di 40 mm e 200 passi_per_rotazione, la deviazione di posizione dei movimenti a velocit\u00e0 costante \u00e8 aumentata di ~0,150 mm). Tuttavia, questo \"ritardo nell'ottenimento della posizione richiesta\" potrebbe non manifestarsi come un difetto di stampa significativo e si potrebbe preferire il comportamento pi\u00f9 silenzioso della modalit\u00e0 stealthChop. Si consiglia di utilizzare sempre la modalit\u00e0 \"spreadCycle\" (non specificando stealthchop_threshold ) o di utilizzare sempre la modalit\u00e0 \"stealthChop\" (impostando stealthchop_threshold su 999999). Sfortunatamente, i driver spesso producono risultati scadenti e confusi se la modalit\u00e0 cambia mentre il motore \u00e8 a una velocit\u00e0 diversa da zero.","title":"Impostazione della modalit\u00e0 \"spreadCycle\" rispetto a \"stealthChop\""},{"location":"TMC_Drivers.html#limpostazione-dellinterpolazione-tmc-introduce-una-piccola-deviazione-di-posizione","text":"L'impostazione interpolate del driver TMC pu\u00f2 ridurre il rumore udibile del movimento della stampante a costo di introdurre un piccolo errore di posizione sistemico. Questo errore di posizione sistematico deriva dal ritardo del driver nell'esecuzione dei \"passi\" inviati da Klipper. Durante i movimenti a velocit\u00e0 costante, questo ritardo si traduce in un errore di posizione di quasi mezzo micropasso configurato (pi\u00f9 precisamente, l'errore \u00e8 di mezzo micropasso meno un 512esimo di un passo intero). Ad esempio, su un asse con una distanza_rotazione di 40 mm, 200 passi_per_rotazione e 16 micropassi, l'errore sistemico introdotto durante i movimenti a velocit\u00e0 costante \u00e8 ~0,006 mm. Per una migliore precisione di posizionamento, considerare l'utilizzo della modalit\u00e0 SpreadCycle e disabilitare l'interpolazione (impostare interpolate: False nella configurazione del driver TMC). Se configurato in questo modo, \u00e8 possibile aumentare l'impostazione microstep per ridurre il rumore udibile durante il movimento del passo-passo. Tipicamente, un'impostazione microstep di 64 o 128 avr\u00e0 un rumore udibile simile all'interpolazione e lo far\u00e0 senza introdurre un errore posizionale sistemico. Se si utilizza la modalit\u00e0 StealthChop, l'imprecisione posizionale dell'interpolazione \u00e8 piccola rispetto all'imprecisione posizionale introdotta dalla modalit\u00e0 StealthChop. Pertanto l'interpolazione dell'ottimizzazione non \u00e8 considerata utile in modalit\u00e0 StealthChop e si pu\u00f2 lasciare l'interpolazione nel suo stato predefinito.","title":"L'impostazione dell'interpolazione TMC introduce una piccola deviazione di posizione"},{"location":"TMC_Drivers.html#homing-sensorless","text":"L'homing senza sensori consente di posizionare un asse senza la necessit\u00e0 di un finecorsa fisico. Invece, il carrello sull'asse viene spostato nel finecorsa meccanico facendo perdere passi al motore passo-passo. Il driver stepper rileva i passi persi e lo indica all'MCU di controllo (Klipper) attivando un pin. Queste informazioni possono essere utilizzate da Klipper come fine corsa per l'asse. Questa guida illustra l'impostazione dell'homing sensorless per l'asse X della stampante (cartesiana). Tuttavia, funziona allo stesso modo con tutti gli altri assi (che richiedono un fine corsa). Dovresti configurarlo e sintonizzarlo per un asse alla volta.","title":"Homing Sensorless"},{"location":"TMC_Drivers.html#limitazioni","text":"Assicurati che i tuoi componenti meccanici siano in grado di sopportare il carico del carrello che urta ripetutamente il limite dell'asse. Soprattutto le viti di comando potrebbero generare molta forza. L'homing di un asse Z facendo urtare l'ugello sulla superficie di stampa potrebbe non essere una buona idea. Per ottenere i migliori risultati, verificare che il carrello dell'asse stabilisca un contatto stabile con il limite dell'asse. Inoltre, l'homing sensorless potrebbe non essere sufficientemente preciso per la tua stampante. Sebbene l'homing degli assi X e Y su una macchina cartesiana possa funzionare bene, l'homing dell'asse Z in genere non \u00e8 sufficientemente preciso e pu\u00f2 comportare un'altezza del primo strato incoerente. L'homing di una stampante delta sensorless non \u00e8 consigliabile a causa della mancanza di precisione. Inoltre, il rilevamento dello stallo del driver passo-passo dipende dal carico meccanico sul motore, dalla corrente del motore e dalla temperatura del motore (resistenza della bobina). L'homing sensorless funziona meglio a velocit\u00e0 medie del motore. Per velocit\u00e0 molto basse (inferiori a 10 giri/min) il motore non genera una significativa EMF di ritorno e il TMC non \u00e8 in grado di rilevare in modo affidabile gli stalli del motore. Inoltre, a velocit\u00e0 molto elevate, l'EMF di ritorno del motore si avvicina alla tensione di alimentazione del motore, quindi il TMC non \u00e8 pi\u00f9 in grado di rilevare gli stalli. Si consiglia di dare un'occhiata alla scheda tecnica del proprio TMC specifico. L\u00ec puoi anche trovare maggiori dettagli sulle limitazioni di questa configurazione.","title":"Limitazioni"},{"location":"TMC_Drivers.html#prerequisiti","text":"Sono necessari alcuni prerequisiti per utilizzare l'homing sensorless: Driver passo-passo TMC compatibile con stallGuard (tmc2130, tmc2209, tmc2660 o tmc5160). Interfaccia SPI/UART del driver TMC cablata al microcontrollore (la modalit\u00e0 stand-alone non funziona). Il pin \"DIAG\" o \"SG_TST\" appropriato del driver TMC collegato al microcontrollore. I passaggi nel documento config checks devono essere eseguiti per confermare che i motori passo-passo siano configurati e funzionino correttamente.","title":"Prerequisiti"},{"location":"TMC_Drivers.html#messa-a-punto","text":"La procedura qui descritta prevede sei passaggi principali: Scegli una velocit\u00e0 di homing. Configura il file printer.cfg per abilitare l'homing sensorless. Trova l'impostazione stallguard con la massima sensibilit\u00e0 che funziona con successo. Trova l'impostazione stallguard con la sensibilit\u00e0 pi\u00f9 bassa che effettua homing con successo con un solo tocco. Aggiorna il printer.cfg con l'impostazione di stallguard desiderata. Crea o aggiorna le macro printer.cfg per homing in modo coerente.","title":"Messa a punto"},{"location":"TMC_Drivers.html#scegli-la-velocita-di-homing","text":"La velocit\u00e0 di homing \u00e8 una scelta importante quando si esegue l'homing senza sensori. \u00c8 consigliabile utilizzare una velocit\u00e0 di riferimento bassa in modo che il carrello non eserciti una forza eccessiva sul telaio quando entra in contatto con l'estremit\u00e0 della rotaia. Tuttavia, i driver TMC non sono in grado di rilevare in modo affidabile uno stallo a velocit\u00e0 molto basse. Un buon punto di partenza per la velocit\u00e0 di homing \u00e8 che il motore passo-passo esegua una rotazione completa ogni due secondi. Per molti assi questa sar\u00e0 la rotation_distance divisa per due. Per esempio: [stepper_x] rotation_distance: 40 homing_speed: 20 ...","title":"Scegli la velocit\u00e0 di homing"},{"location":"TMC_Drivers.html#configura-printercfg-per-lhoming-sensorless","text":"L'impostazione homing_retract_dist deve essere impostata su zero nella sezione di configurazione stepper_x per disabilitare il secondo movimento di homing. Il secondo tentativo di homing non aggiunge valore quando si utilizza l'homing sensorless, non funzioner\u00e0 in modo affidabile e confonder\u00e0 il processo di ottimizzazione. Assicurati che un'impostazione hold_current non sia specificata nella sezione del driver TMC del file config. (Se viene impostata una hold_current, dopo che \u00e8 stato stabilito il contatto, il motore si arresta mentre il carrello viene premuto contro l'estremit\u00e0 del binario e la riduzione della corrente mentre si trova in quella posizione pu\u00f2 causare il movimento del carrello, il che si traduce in prestazioni scadenti e confonde il processo di regolazione.) \u00c8 necessario configurare i pin di homing sensorless e configurare le impostazioni iniziali di \"stallguard\". Una configurazione di esempio tmc2209 per un asse X potrebbe essere simile a: [tmc2209 stepper_x] diag_pin: ^PA1 # Impostare sul pin MCU collegato al pin TMC DIAG driver_SGTHRS: 255 #255 \u00e8 il valore pi\u00f9 sensibile, 0 \u00e8 il meno sensibile ... [stepper_x] endstop_pin: tmc2209_stepper_x:virtual_endstop homing_retract_dist: 0 ... Un esempio di configurazione tmc2130 o tmc5160 potrebbe essere simile a: [tmc2130 stepper_x] diag1_pin: ^!PA1 # Pin collegato al pin TMC DIAG1 (o utilizzare pin diag0_pin / DIAG0) driver_SGT: -64 # -64 \u00e8 il valore pi\u00f9 sensibile, 63 \u00e8 il meno sensibile ... [stepper_x] endstop_pin: tmc2130_stepper_x:virtual_endstop homing_retract_dist: 0 ... Un esempio di configurazione di tmc2660 potrebbe essere simile a: [tmc2660 stepper_x] driver_SGT: -64 # -64 \u00e8 il valore pi\u00f9 sensibile, 63 \u00e8 il meno sensibile ... [stepper_x] endstop_pin: ^PA1 # Pin collegato al pin TMC SG_TST homing_retract_dist: 0 ... Gli esempi sopra mostrano solo le impostazioni specifiche per l'homing sensorless. Vedere il riferimento alla configurazione per tutte le opzioni disponibili.","title":"Configura printer.cfg per l'homing sensorless"},{"location":"TMC_Drivers.html#trova-la-massima-sensibilita-che-porta-a-homing-con-successo","text":"Posizionare il carrello vicino al centro del binario. Utilizzare il comando SET_TMC_FIELD per impostare la sensibilit\u00e0 pi\u00f9 alta. Per tmc2209: SET_TMC_FIELD STEPPER=stepper_x FIELD=SGTHRS VALUE=255 Per tmc2130, tmc5160 e tmc2660: SET_TMC_FIELD STEPPER=stepper_x FIELD=sgt VALUE=-64 Quindi inviare un comando G28 X0 e verificare che l'asse non si muova affatto o smetta rapidamente di muoversi. Se l'asse non si ferma, inviare un M112 per fermare la stampante - qualcosa non \u00e8 corretto con il cablaggio o la configurazione dei pin diag/sg_tst e deve essere corretto prima di continuare. Quindi, diminuire progressivamente la sensibilit\u00e0 dell'impostazione VALUE ed eseguire nuovamente i comandi SET_TMC_FIELD G28 X0 per trovare la sensibilit\u00e0 pi\u00f9 alta che fa s\u00ec che il carrello si muova con successo fino all'arresto e si arresti. (Per i driver tmc2209 questo diminuir\u00e0 SGTHRS, per altri conducenti aumenter\u00e0 il sgt.) Assicurati di iniziare ogni tentativo con il carrello vicino al centro del binario (se necessario, emetti M84 e quindi sposta manualmente il carrello sul centro). Dovrebbe essere possibile trovare la sensibilit\u00e0 pi\u00f9 alta che si adatta in modo affidabile (le impostazioni con una sensibilit\u00e0 pi\u00f9 alta comportano movimenti piccoli o nulli). Nota il valore trovato come sensibilit\u00e0_massima . (Se si ottiene la sensibilit\u00e0 minima possibile (SGTHRS=0 o sgt=63) senza alcun movimento del carrello, allora qualcosa non \u00e8 corretto con il cablaggio o la configurazione dei pin diag/sg_tst e deve essere corretto prima di continuare.) Quando si cerca la sensibilit\u00e0_massima, pu\u00f2 essere conveniente passare a diverse impostazioni VALUE (in modo da dividere in due il parametro VALUE). In tal caso, prepararsi a emettere un comando M112 per arrestare la stampante, poich\u00e9 un'impostazione con una sensibilit\u00e0 molto bassa potrebbe far \"sbattere\" ripetutamente l'asse contro l'estremit\u00e0 del binario. Assicurati di attendere un paio di secondi tra ogni tentativo di homing. Dopo che il driver TMC ha rilevato uno stallo, potrebbe volerci un po' di tempo per cancellare il suo indicatore interno ed essere in grado di rilevare un altro stallo. Durante questi test di ottimizzazione, se un comando G28 X0 non si sposta fino al limite dell'asse, prestare attenzione nell'emettere qualsiasi comando di movimento regolare (ad es. G1 ). Klipper non avr\u00e0 una corretta comprensione della posizione del carrello e un comando di spostamento potrebbe causare risultati indesiderati e confusi.","title":"Trova la massima sensibilit\u00e0 che porta a homing con successo"},{"location":"TMC_Drivers.html#trova-la-sensibilita-piu-bassa-che-porta-a-homing-con-un-solo-tocco","text":"Quando si effettua l'homing con il valore maximum_sensitivity trovato, l'asse dovrebbe spostarsi all'estremit\u00e0 del binario e fermarsi con un \"tocco singolo\", ovvero non dovrebbe esserci un \"clic\" o un \"sbattere\". (Se c'\u00e8 un suono che sbatte o scatta alla sensibilit\u00e0_massima, allora la velocit\u00e0 di riferimento potrebbe essere troppo bassa, la corrente del driver potrebbe essere troppo bassa o la corsa di riferimento senza sensore potrebbe non essere una buona scelta per l'asse.) Il passo successivo \u00e8 spostare di nuovo continuamente il carrello in una posizione vicino al centro della rotaia, diminuire la sensibilit\u00e0 ed eseguire i comandi SET_TMC_FIELD G28 X0 - l'obiettivo ora \u00e8 trovare la sensibilit\u00e0 pi\u00f9 bassa che risulti ancora nel la carrozza torna con successo al punto di riferimento con un \"tocco singolo\". Cio\u00e8, non \"sbatte\" o \"clic\" quando viene a contatto con l'estremit\u00e0 del binario. Nota il valore trovato come sensibilit\u00e0_minima .","title":"Trova la sensibilit\u00e0 pi\u00f9 bassa che porta a homing con un solo tocco"},{"location":"TMC_Drivers.html#aggiorna-printercfg-con-il-valore-della-sensibilita","text":"Dopo aver trovato sensibilit\u00e0_massima e sensibilit\u00e0_minima , utilizzare una calcolatrice per ottenere la sensibilit\u00e0 consigliata come sensibilit\u00e0_minima + (sensibilit\u00e0_massima - sensibilit\u00e0_minima)/3 . La sensibilit\u00e0 consigliata dovrebbe essere compresa tra il minimo e il massimo, ma leggermente pi\u00f9 vicino al minimo. Arrotonda il valore finale al valore intero pi\u00f9 vicino. Per tmc2209 impostalo nella configurazione come driver_SGTHRS , per altri driver TMC impostalo nella configurazione come driver_SGT . Se l'intervallo tra sensibilit\u00e0_massima e sensibilit\u00e0_minima \u00e8 piccolo (ad esempio, inferiore a 5), potrebbe risultare in un homing instabile. Una velocit\u00e0 di riferimento pi\u00f9 elevata pu\u00f2 aumentare il range e rendere l'operazione pi\u00f9 stabile. Si noti che se viene apportata una modifica alla corrente del driver, alla velocit\u00e0 di riferimento o viene apportata una modifica notevole all'hardware della stampante, sar\u00e0 necessario eseguire nuovamente il processo di ottimizzazione.","title":"Aggiorna printer.cfg con il valore della sensibilit\u00e0"},{"location":"TMC_Drivers.html#utilizzo-delle-macro-durante-lhoming","text":"Dopo aver completato l'homing senza sensori, il carrello verr\u00e0 premuto contro l'estremit\u00e0 del binario e lo stepper eserciter\u00e0 una forza sul telaio fino a quando il carrello non si allontana. \u00c8 una buona idea creare una macro per posizionare l'asse e allontanare immediatamente il carrello dall'estremit\u00e0 della rotaia. \u00c8 una buona idea che la macro si metta in pausa di almeno 2 secondi prima di iniziare l'homing sensorless (o altrimenti assicurarsi che non ci siano stati movimenti sullo stepper per 2 secondi). Senza ritardo \u00e8 possibile che il flag di stallo interno del driver sia ancora impostato da un movimento precedente. Pu\u00f2 anche essere utile fare in modo che quella macro imposti la corrente del driver prima della corsa di riferimento e imposti una nuova corrente dopo che il carrello si \u00e8 allontanato. Una macro di esempio potrebbe assomigliare a: [gcode_macro SENSORLESS_HOME_X] gcode: {% set HOME_CUR = 0.700 %} {% set driver_config = printer.configfile.settings['tmc2209 stepper_x'] %} {% set RUN_CUR = driver_config.run_current %} # Imposta la corrente per l'homing sensorless SET_TMC_CURRENT STEPPER=stepper_x CURRENT={HOME_CUR} # Fai una pausa per assicurarti che il flag di stallo del driver sia clear G4 P2000 # Home G28 X0 # Spostamento G90 G1 X5 F1200 # Imposta corrente durante la stampa SET_TMC_CURRENT STEPPER=stepper_x CURRENT={RUN_CUR} La macro risultante pu\u00f2 essere chiamata da una sezione di configurazione homing_override o da una START_PRINT macro . Si noti che se viene modificata la corrente del driver durante l'homing, il processo di ottimizzazione dovrebbe essere eseguito nuovamente.","title":"Utilizzo delle macro durante l'homing"},{"location":"TMC_Drivers.html#suggerimenti-per-lhoming-sensorless-su-corexy","text":"\u00c8 possibile utilizzare l'homing sensorless sui carrelli X e Y di una stampante CoreXY. Klipper usa lo stepper [stepper_x] per rilevare gli stalli durante l'homing del carrello X e usa lo stepper [stepper_y] per rilevare gli stalli durante l'homing del carrello Y. Utilizzare la guida alla messa a punto sopra descritta per trovare la \"sensibilit\u00e0 allo stallo\" appropriata per ciascun carrello, ma prestare attenzione alle seguenti restrizioni: Quando si utilizza l'homing sensorless su CoreXY, assicurarsi che non sia configurato hold_current per nessuno dei due stepper. Durante la messa a punto, assicurati che entrambi i carrelli X e Y siano vicini al centro dei loro binari prima di ogni tentativo di homing. Al termine dell'ottimizzazione, quando si esegue l'homing sia di X che Y, utilizzare le macro per assicurarsi che un asse sia homed per primo, quindi spostare il carrello lontano dal limite dell'asse, fare una pausa per almeno 2 secondi, quindi avviare l'orientamento dell'altro carrello. L'allontanamento dall'asse evita l'homing di un asse mentre l'altro viene premuto contro il limite dell'asse (cosa potrebbe distorcere il rilevamento dello stallo). La pausa \u00e8 necessaria per garantire che il flag di stallo del driver sia cancellata prima del homing. Un esempio di macro homing CoreXY potrebbe essere simile a: [gcode_macro HOME] gcode: G90 # Home Z G28 Z0 G1 Z10 F1200 # Home Y G28 Y0 G1 Y5 F1200 # Home X G4 P2000 G28 X0 G1 X5 F1200","title":"Suggerimenti per l'homing sensorless su CoreXY"},{"location":"TMC_Drivers.html#interrogazione-e-diagnosi-delle-impostazioni-del-driver","text":"Il comando DUMP_TMC \u00e8 uno strumento utile durante la configurazione e la diagnosi dei driver. Riporter\u00e0 tutti i campi configurati da Klipper cos\u00ec come tutti i campi che possono essere interrogati dal driver. Tutti i campi riportati sono definiti nella scheda tecnica Trinamic per ciascun driver. Queste schede tecniche possono essere trovate sul sito web Trinamic . Ottenere e rivedere i dati Trinamic affinch\u00e9 il conducente interpreti i risultati di DUMP_TMC.","title":"Interrogazione e diagnosi delle impostazioni del driver"},{"location":"TMC_Drivers.html#configurazione-delle-impostazioni-driver_xxx","text":"Klipper supporta la configurazione di molti campi driver di basso livello usando le impostazioni driver_XXX . Il Riferimento alla configurazione del driver TMC contiene l'elenco completo dei campi disponibili per ogni tipo di driver. Inoltre, quasi tutti i campi possono essere modificati in fase di esecuzione utilizzando il comando SET_TMC_FIELD . Ciascuno di questi campi \u00e8 definito nella scheda tecnica Trinamic per ciascun driver. Queste schede tecniche possono essere trovate sul sito web Trinamic . Si noti che i fogli dati Trinamic a volte utilizzano un'espressione che pu\u00f2 confondere un'impostazione di alto livello (come \"fine isteresi\") con un valore di campo di basso livello (ad esempio, \"HEND\"). In Klipper, driver_XXX e SET_TMC_FIELD impostano sempre il valore del campo di basso livello che viene effettivamente scritto nel driver. Quindi, ad esempio, se il foglio dati Trinamic afferma che \u00e8 necessario scrivere un valore di 3 nel campo HEND per ottenere una \"fine dell'isteresi\" di 0, impostare driver_HEND=3 per ottenere il valore di alto livello di 0.","title":"Configurazione delle impostazioni driver_XXX"},{"location":"TMC_Drivers.html#domande-comuni","text":"","title":"Domande comuni"},{"location":"TMC_Drivers.html#posso-usare-la-modalita-stealthchop-su-un-estrusore-con-anticipo-della-pressione","text":"Molte persone usano con successo la modalit\u00e0 \"stealthChop\" con pressure advance di Klipper. Klipper implementa Smooth Pressure Advance che non introduce variazioni di velocit\u00e0 istantanee. Tuttavia, la modalit\u00e0 \"stealthChop\" pu\u00f2 produrre una coppia del motore inferiore e/o produrre un maggiore calore del motore. Potrebbe essere o meno una modalit\u00e0 adeguata per la tua particolare stampante.","title":"Posso usare la modalit\u00e0 StealthChop su un estrusore con anticipo della pressione?"},{"location":"TMC_Drivers.html#continuo-a-ricevere-gli-errori-impossibile-leggere-tmc-uart-stepper_x-register-ifcnt","text":"Ci\u00f2 si verifica quando Klipper non \u00e8 in grado di comunicare con un driver tmc2208 o tmc2209. Assicurarsi che l'alimentazione del motore sia abilitata, poich\u00e9 il driver del motore passo-passo generalmente necessita dell'alimentazione del motore prima di poter comunicare con il microcontrollore. Se questo errore si verifica dopo aver eseguito il flashing di Klipper per la prima volta, \u00e8 possibile che il driver stepper sia stato precedentemente programmato in uno stato non compatibile con Klipper. Per ripristinare lo stato, rimuovere tutta l'alimentazione dalla stampante per alcuni secondi (scollegare fisicamente sia USB che le spine di alimentazione). In caso contrario, questo errore \u00e8 in genere il risultato di un cablaggio errato del pin UART o di una configurazione Klipper errata delle impostazioni del pin UART.","title":"Continuo a ricevere gli errori \"Impossibile leggere tmc uart 'stepper_x' register IFCNT\"?"},{"location":"TMC_Drivers.html#continuo-a-ricevere-errori-unable-to-write-tmc-spi-stepper_x-register","text":"Ci\u00f2 si verifica quando Klipper non \u00e8 in grado di comunicare con un driver tmc2130 o tmc5160. Assicurarsi che l'alimentazione del motore sia abilitata, poich\u00e9 il driver del motore passo-passo generalmente necessita dell'alimentazione del motore prima di poter comunicare con il microcontrollore. In caso contrario, questo errore \u00e8 in genere il risultato di un cablaggio SPI errato, una configurazione Klipper errata delle impostazioni SPI o una configurazione incompleta dei dispositivi su un bus SPI. Nota che se il driver si trova su un bus SPI condiviso con pi\u00f9 dispositivi, assicurati di configurare completamente ogni dispositivo su quel bus SPI condiviso in Klipper. Se un dispositivo su un bus SPI condiviso non \u00e8 configurato, potrebbe rispondere in modo errato a comandi non previsti e danneggiare la comunicazione con il dispositivo previsto. Se \u00e8 presente un dispositivo su un bus SPI condiviso che non pu\u00f2 essere configurato in Klipper, utilizzare una sezione di configurazione static_digital_output per impostare il pin CS del dispositivo inutilizzato alto (in modo che non tenti utilizzare il bus SPI). Lo schema della scheda \u00e8 spesso un utile riferimento per trovare quali dispositivi si trovano su un bus SPI e i pin associati.","title":"Continuo a ricevere errori \"Unable to write tmc spi 'stepper_x' register ...\"?"},{"location":"TMC_Drivers.html#perche-ho-ricevuto-un-errore-tmc-reports-error","text":"Questo tipo di errore indica che il driver TMC ha rilevato un problema e si \u00e8 disabilitato. Cio\u00e8, il conducente ha smesso di mantenere la sua posizione e ha ignorato i comandi di movimento. Se Klipper rileva che un driver attivo si \u00e8 disabilitato, la stampante passer\u00e0 allo stato di \"spegnimento\". \u00c8 anche possibile che si verifichi un arresto TMC segnala errore a causa di errori SPI che impediscono la comunicazione con il driver (su tmc2130, tmc5160 o tmc2660). Se ci\u00f2 si verifica, \u00e8 normale che lo stato del driver riportato mostri 00000000 o ffffffff , ad esempio: TMC reports error: DRV_STATUS: ffffffff ... O TMC reports error: READRSP@RDSEL2: 00000000 ... . Tale errore pu\u00f2 essere dovuto a un problema di cablaggio SPI o pu\u00f2 essere dovuto a un ripristino automatico o a un guasto del driver TMC. Alcuni errori comuni e suggerimenti per diagnosticarli:","title":"Perch\u00e9 ho ricevuto un errore \"TMC reports error: ...\"?"},{"location":"TMC_Drivers.html#tmc-segnala-lerrore-ot1overtemperror","text":"Ci\u00f2 indica che il driver del motore si \u00e8 disabilitato perch\u00e9 \u00e8 diventato troppo caldo. Le soluzioni tipiche consistono nel ridurre la corrente del motore passo-passo, aumentare il raffreddamento sul driver del motore passo-passo e/o aumentare il raffreddamento sul motore passo-passo.","title":"TMC segnala l'errore: ... ot=1(OvertempError!)"},{"location":"TMC_Drivers.html#tmc-segnala-un-errore-shorttognd-o-lowsideshort","text":"Ci\u00f2 indica che il driver si \u00e8 disabilitato perch\u00e9 ha rilevato una corrente molto elevata che passa attraverso il driver. Ci\u00f2 potrebbe indicare un filo allentato o in cortocircuito al motore passo-passo o all'interno del motore passo-passo stesso. Questo errore pu\u00f2 verificarsi anche se si utilizza la modalit\u00e0 StealthChop e il driver TMC non \u00e8 in grado di prevedere con precisione il carico meccanico del motore. (Se il driver fa una previsione scadente, potrebbe inviare troppa corrente attraverso il motore e attivare il proprio rilevamento di sovracorrente.) Per verificarlo, disabilitare la modalit\u00e0 StealthChop e verificare se gli errori continuano a verificarsi.","title":"TMC segnala un errore: ... ShortToGND O LowSideShort"},{"location":"TMC_Drivers.html#tmc-segnala-un-errore-reset1reset-or-cs_actual0reset-or-se0reset","text":"Ci\u00f2 indica che il driver si \u00e8 ripristinato durante la stampa. Ci\u00f2 potrebbe essere dovuto a problemi di tensione o cablaggio.","title":"TMC segnala un errore: ... reset=1(Reset) OR CS_ACTUAL=0(Reset?) OR SE=0(Reset?)"},{"location":"TMC_Drivers.html#tmc-segnala-lerrore-uv_cp1undervoltage","text":"Ci\u00f2 indica che il driver ha rilevato un evento di bassa tensione e si \u00e8 disabilitato. Ci\u00f2 potrebbe essere dovuto a problemi di cablaggio o alimentazione.","title":"TMC segnala l'errore: ... uv_cp=1(Undervoltage!)"},{"location":"TMC_Drivers.html#come-si-regola-la-modalita-spreadcyclecoolstepetc-sui-miei-driver","text":"Il sito web Trinamic contiene guide sulla configurazione dei driver. Queste guide sono spesso tecniche, di basso livello e potrebbero richiedere hardware specializzato. In ogni caso, sono la migliore fonte di informazioni.","title":"Come si regola la modalit\u00e0 spreadCycle/coolStep/etc. sui miei driver?"},{"location":"TSL1401CL_Filament_Width_Sensor.html","text":"Sensore TSL1401CL di larghezza del filamento \u00b6 Questo documento descrive il modulo host del sensore di larghezza del filamento (Filament Width Sensor). L'hardware utilizzato per lo sviluppo di questo modulo host si basa sull'array di sensori lineari TSL1401CL, ma pu\u00f2 funzionare con qualsiasi array di sensori dotato di uscita analogica. Puoi trovare design su Thingiverse . Per utilizzare un array di sensori come sensore di larghezza del filamento, leggere Config Reference e G-Code documentation . Come funziona? \u00b6 Il sensore genera un'uscita analogica in base alla larghezza calcolata del filamento. La tensione di uscita \u00e8 sempre uguale alla larghezza del filamento rilevata (es. 1.65v, 1.70v, 3.0v). Il modulo host monitora le variazioni di tensione e regola il moltiplicatore di estrusione. Note: \u00b6 Letture del sensore eseguite con intervalli di 10 mm predefiniti Se necessario, sei libero di modificare questa impostazione modificando il parametro MEASUREMENT_INTERVAL_MM nel file filament_width_sensor.py .","title":"Sensore TSL1401CL di larghezza del filamento"},{"location":"TSL1401CL_Filament_Width_Sensor.html#sensore-tsl1401cl-di-larghezza-del-filamento","text":"Questo documento descrive il modulo host del sensore di larghezza del filamento (Filament Width Sensor). L'hardware utilizzato per lo sviluppo di questo modulo host si basa sull'array di sensori lineari TSL1401CL, ma pu\u00f2 funzionare con qualsiasi array di sensori dotato di uscita analogica. Puoi trovare design su Thingiverse . Per utilizzare un array di sensori come sensore di larghezza del filamento, leggere Config Reference e G-Code documentation .","title":"Sensore TSL1401CL di larghezza del filamento"},{"location":"TSL1401CL_Filament_Width_Sensor.html#come-funziona","text":"Il sensore genera un'uscita analogica in base alla larghezza calcolata del filamento. La tensione di uscita \u00e8 sempre uguale alla larghezza del filamento rilevata (es. 1.65v, 1.70v, 3.0v). Il modulo host monitora le variazioni di tensione e regola il moltiplicatore di estrusione.","title":"Come funziona?"},{"location":"TSL1401CL_Filament_Width_Sensor.html#note","text":"Letture del sensore eseguite con intervalli di 10 mm predefiniti Se necessario, sei libero di modificare questa impostazione modificando il parametro MEASUREMENT_INTERVAL_MM nel file filament_width_sensor.py .","title":"Note:"},{"location":"Using_PWM_Tools.html","text":"Utilizzo dei strumenti PWM \u00b6 Questo documento descrive come impostare un laser o un mandrino controllato da PWM usando output_pin e alcune macro. Come funziona? \u00b6 Riutilizzando l'output pwm della ventola della testina di stampa, \u00e8 possibile controllare laser o mandrini. Ci\u00f2 \u00e8 utile se si utilizzano testine di stampa intercambiabili, ad esempio il cambio utensile E3D o una soluzione fai-da-te. Di solito, gli strumenti cam come LaserWeb possono essere configurati per utilizzare i comandi M3-M5 , che stanno per velocit\u00e0 mandrino CW ( M3 S[0-255] ), velocit\u00e0 mandrino CCW ( M4 S[ 0-255] ) e arresto mandrino ( M5 ). Attenzione: Quando utilizzi un laser, mantieni tutte le precauzioni di sicurezza che ti vengono in mente! I laser a diodi sono generalmente invertiti. Ci\u00f2 significa che quando l'MCU si riavvia, il laser sar\u00e0 completamente acceso per il tempo necessario al riavvio dell'MCU. Per buona misura, si raccomanda di indossare sempre occhiali laser appropriati della giusta lunghezza d'onda se il laser \u00e8 alimentato e per disconnettere il laser quando non \u00e8 necessario. Inoltre, dovresti configurare un timeout di sicurezza, in modo che quando l'host o l'MCU riscontrano un errore, lo strumento si arresti. Per un esempio di configurazione, vedere config/sample-pwm-tool.cfg . Limitazioni attuali \u00b6 Esiste una limitazione della frequenza degli aggiornamenti PWM. Pur essendo molto preciso, un aggiornamento PWM pu\u00f2 verificarsi solo ogni 0,1 secondi, rendendolo quasi inutile per l'incisione raster. Tuttavia, esiste un ramo sperimentale con i propri compromessi. A lungo termine, si prevede di aggiungere questa funzionalit\u00e0 al klipper principale. Comandi \u00b6 M3/M4 S<value> : Imposta il duty-cycle PWM. Valori compresi tra 0 e 255. M5 : Arresta l'uscita PWM al valore di spegnimento. Configurazione Laserweb \u00b6 Se utilizzi Laserweb, una configurazione funzionante sarebbe: GCODE START: M5 ; Disabilita Laser G21 ; Set units to mm G90 ; Absolute positioning G0 Z0 F7000 ; Set Non-Cutting speed GCODE END: M5 ; Disabilita Laser G91 ; relative G0 Z+20 F4000 ; G90 ; absolute GCODE HOMING: M5 ; Disabilita Laser G28 ; Home all axis TOOL ON: M3 $INTENSITY TOOL OFF: M5 ; Disabilita Laser LASER INTENSITY: S","title":"Utilizzo dei strumenti PWM"},{"location":"Using_PWM_Tools.html#utilizzo-dei-strumenti-pwm","text":"Questo documento descrive come impostare un laser o un mandrino controllato da PWM usando output_pin e alcune macro.","title":"Utilizzo dei strumenti PWM"},{"location":"Using_PWM_Tools.html#come-funziona","text":"Riutilizzando l'output pwm della ventola della testina di stampa, \u00e8 possibile controllare laser o mandrini. Ci\u00f2 \u00e8 utile se si utilizzano testine di stampa intercambiabili, ad esempio il cambio utensile E3D o una soluzione fai-da-te. Di solito, gli strumenti cam come LaserWeb possono essere configurati per utilizzare i comandi M3-M5 , che stanno per velocit\u00e0 mandrino CW ( M3 S[0-255] ), velocit\u00e0 mandrino CCW ( M4 S[ 0-255] ) e arresto mandrino ( M5 ). Attenzione: Quando utilizzi un laser, mantieni tutte le precauzioni di sicurezza che ti vengono in mente! I laser a diodi sono generalmente invertiti. Ci\u00f2 significa che quando l'MCU si riavvia, il laser sar\u00e0 completamente acceso per il tempo necessario al riavvio dell'MCU. Per buona misura, si raccomanda di indossare sempre occhiali laser appropriati della giusta lunghezza d'onda se il laser \u00e8 alimentato e per disconnettere il laser quando non \u00e8 necessario. Inoltre, dovresti configurare un timeout di sicurezza, in modo che quando l'host o l'MCU riscontrano un errore, lo strumento si arresti. Per un esempio di configurazione, vedere config/sample-pwm-tool.cfg .","title":"Come funziona?"},{"location":"Using_PWM_Tools.html#limitazioni-attuali","text":"Esiste una limitazione della frequenza degli aggiornamenti PWM. Pur essendo molto preciso, un aggiornamento PWM pu\u00f2 verificarsi solo ogni 0,1 secondi, rendendolo quasi inutile per l'incisione raster. Tuttavia, esiste un ramo sperimentale con i propri compromessi. A lungo termine, si prevede di aggiungere questa funzionalit\u00e0 al klipper principale.","title":"Limitazioni attuali"},{"location":"Using_PWM_Tools.html#comandi","text":"M3/M4 S<value> : Imposta il duty-cycle PWM. Valori compresi tra 0 e 255. M5 : Arresta l'uscita PWM al valore di spegnimento.","title":"Comandi"},{"location":"Using_PWM_Tools.html#configurazione-laserweb","text":"Se utilizzi Laserweb, una configurazione funzionante sarebbe: GCODE START: M5 ; Disabilita Laser G21 ; Set units to mm G90 ; Absolute positioning G0 Z0 F7000 ; Set Non-Cutting speed GCODE END: M5 ; Disabilita Laser G91 ; relative G0 Z+20 F4000 ; G90 ; absolute GCODE HOMING: M5 ; Disabilita Laser G28 ; Home all axis TOOL ON: M3 $INTENSITY TOOL OFF: M5 ; Disabilita Laser LASER INTENSITY: S","title":"Configurazione Laserweb"}]}
\ No newline at end of file
diff --git a/it/sitemap.xml b/it/sitemap.xml
index 589ca26a4..0fca06649 100644
--- a/it/sitemap.xml
+++ b/it/sitemap.xml
@@ -2,252 +2,252 @@
 <urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
 </urlset>
\ No newline at end of file
diff --git a/it/sitemap.xml.gz b/it/sitemap.xml.gz
index 3b2ffe6b9885bb5cae169e88c7be5adc79d47c30..c55e0ece498066bbb1a0806b235d963fac9c698b 100644
GIT binary patch
delta 84
zcmV-a0IUDv0pbBeABzYGYn|a^0{?SqbY*Q}a4vXlYyj=eOAdlC6a~<^t00|2D-Qgm
ql$k?Ex&Q(dNT9{OD!P05#jpjF`zC$8z3GvWLzf5w%AkPP7ytm_86>6v

delta 84
zcmV-a0IUDv0pbBeABzYG^h4ld0{?SqbY*Q}a4vXlYyj=eO%8%E5C!19ry$)!D<(!w
qDLa?0^Z*1ZkU)!_DtdeQi{T0;Z#JF2zVwrkLzf5z@gV}&7ytmaT_P+1

diff --git a/sitemap.xml b/sitemap.xml
index 82903c47a..c93f5dd49 100644
--- a/sitemap.xml
+++ b/sitemap.xml
@@ -2,247 +2,247 @@
 <urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
 </urlset>
\ No newline at end of file
diff --git a/sitemap.xml.gz b/sitemap.xml.gz
index 376be382bb5905caee9926dc7440222381288025..36181a74cdc830c3cb8e95d61130d455a1f47125 100644
GIT binary patch
delta 205
zcmaFJ_>hrZzMF$1dG5oB>~i(&^+Bhey;#EUuz-nk%Z+H)`*Hu0Zp5CCt*WlN<iG6w
zHqN+Pfw{hiwoOcEG~2106|DBA%(k6<+N$1~U2R+V+cqt13B6aYe(v|a{uSSLowe#(
zqiy;0YJuXumKYcJWo8Er9<zTo>&?kor*|#m<ni3U6DH>8E=&@9?<ClsWFImu$2Roz
z>N8V*z5C)U8hN)yC0=#&iF%cS2L~FN+4*EF&>4U1Ypgt~zq0ys?%5P2!N33j%III!

delta 205
zcmaFJ_>hrZzMF&Nwey3C>~i(Oi<eC~d(l(A!GTpMW8?O&eS7~L-LQM!?l0fIESc|f
zKUa9qmc_Sbwd5)vWXdgyzOu~c#@i}Bew|S1pC!DR@;s@|oU8Y|_nY&*RzC1;>FiRG
z$nc_5s~<YmaPI8r^T};WJjVYlSL)`CnAkNJC-vX{rKo)WmeWzCd#y@*N9$JT+_YUa
zEqtct*Sjy<wKnbg>9Nl%ZQ_5A2L~FN+4*EF3eXup>VK3>`1XqXMd63^C<z7z0E0DS
Au>b%7

diff --git a/zh-Hant/_klipper3d/__pycache__/mkdocs_hooks.cpython-38.pyc b/zh-Hant/_klipper3d/__pycache__/mkdocs_hooks.cpython-38.pyc
index 5da67cbb5f7b316a897b1f45ea74add26d185cdc..406a5b31d8ec56dfda96532a8fe45345f0518786 100644
GIT binary patch
delta 20
acmcc4ex02=l$V!_0SH3pKHSKCh8X}iVg;W7

delta 20
acmcc4ex02=l$V!_0SIn6KiJ59h8X}j<ORt9

diff --git a/zh-Hant/sitemap.xml b/zh-Hant/sitemap.xml
index 589ca26a4..0fca06649 100644
--- a/zh-Hant/sitemap.xml
+++ b/zh-Hant/sitemap.xml
@@ -2,252 +2,252 @@
 <urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
 </urlset>
\ No newline at end of file
diff --git a/zh-Hant/sitemap.xml.gz b/zh-Hant/sitemap.xml.gz
index 4569c89053bb56bde52bdd199207bcd9b8f8f089..6a639aaddbc7094dadcc67d9c16f22ca1a50ce72 100644
GIT binary patch
delta 84
zcmV-a0IUDv0pbBeABzYGXPx0=0{?SqbY*Q}a4vXlYyj=eOAdlC6a~<^t00|2D-Qgm
ql$k?Ex&Q(dNT9{OD!P05#jpjF`zC$8z3GvWLzf5w%AkPP7ytm@?IfZA

delta 84
zcmV-a0IUDv0pbBeABzYG@I&BZ0{?SqbY*Q}a4vXlYyj=eO%8%E5C!19ry$)!D<(!w
qDLa?0^Z*1ZkU)!_DtdeQi{T0;Z#JF2zVwrkLzf5z@gV}&7ytmZF(N1c

diff --git a/zh/_klipper3d/__pycache__/mkdocs_hooks.cpython-38.pyc b/zh/_klipper3d/__pycache__/mkdocs_hooks.cpython-38.pyc
index 5da67cbb5f7b316a897b1f45ea74add26d185cdc..406a5b31d8ec56dfda96532a8fe45345f0518786 100644
GIT binary patch
delta 20
acmcc4ex02=l$V!_0SH3pKHSKCh8X}iVg;W7

delta 20
acmcc4ex02=l$V!_0SIn6KiJ59h8X}j<ORt9

diff --git a/zh/sitemap.xml b/zh/sitemap.xml
index 589ca26a4..0fca06649 100644
--- a/zh/sitemap.xml
+++ b/zh/sitemap.xml
@@ -2,252 +2,252 @@
 <urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2023-02-06</lastmod>
+         <lastmod>2023-02-07</lastmod>
          <changefreq>daily</changefreq>
     </url>
 </urlset>
\ No newline at end of file
diff --git a/zh/sitemap.xml.gz b/zh/sitemap.xml.gz
index df1eb0a79a1d0c9539765cc8a5b05f3485046db9..908ef66c7a62693b8fa6fb9737ccbd0b4fe3429b 100644
GIT binary patch
delta 84
zcmV-a0IUDv0pbBeABzYGWu4(;0{?SqbY*Q}a4vXlYyj=eOAdlC6a~<^t00|2D-Qgm
ql$k?Ex&Q(dNT9{OD!P05#jpjF`zC$8z3GvWLzf5w%AkPP7ytm@S0tbS

delta 84
zcmV-a0IUDv0pbBeABzYG?nB^X0{?SqbY*Q}a4vXlYyj=eO%8%E5C!19ry$)!D<(!w
qDLa?0^Z*1ZkU)!_DtdeQi{T0;Z#JF2zVwrkLzf5z@gV}&7ytmYn<6Fv