Deploying to gh-pages from @ Klipper3d/klipper@7b490f3ec1 🚀

it/Config_Reference.html

@@ -1310,6 +1310,20 @@
     [output_pin]
   </a>
   
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#pwm_tool" class="md-nav__link">
+    [pwm_tool]
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#pwm_cycle_time" class="md-nav__link">
+    [pwm_cycle_time]
+  </a>
+  
 </li>
         
           <li class="md-nav__item">
@@ -3322,6 +3336,20 @@
     [output_pin]
   </a>
   
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#pwm_tool" class="md-nav__link">
+    [pwm_tool]
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#pwm_cycle_time" class="md-nav__link">
+    [pwm_cycle_time]
+  </a>
+  
 </li>
         
           <li class="md-nav__item">
@@ -3747,32 +3775,49 @@ serial:
 <p>La sezione printer controlla le impostazioni di alto livello della stampante.</p>
 <div class="highlight"><pre><span></span><code>[printer]
 kinematics:
-#   Il tipo di stampante in uso. Questa opzione può essere una delle
-#   seguenti: cartesian, corexy, corexz, hybrid_corexy, hybrid_corexz,
-#   rotary_delta, delta, deltesian, polar, winch o nessuno.
-#   Questo parametro deve essere specificato.
+#   The type of printer in use. This option may be one of: cartesian,
+#   corexy, corexz, hybrid_corexy, hybrid_corexz, rotary_delta, delta,
+#   deltesian, polar, winch, or none. This parameter must be specified.
 max_velocity:
-#   Velocità massima (in mm/s) della testa di stampa (relativa alla stampa).
-#   Questo parametro deve essere specificato.
+#   Maximum velocity (in mm/s) of the toolhead (relative to the
+#   print). This parameter must be specified.
 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à con cui
-#   la testa di stampa può passare dall&#39;accelerazione alla decelerazione. Viene
-#   utilizzato per ridurre la velocità massima di brevi movimenti a zig-zag
-#   (e quindi ridurre le vibrazioni della stampante dovute a questi movimenti).
-#   Il valore predefinito è metà di max_accel.
+#   Maximum acceleration (in mm/s^2) of the toolhead (relative to the
+#   print). Although this parameter is described as a &quot;maximum&quot;
+#   acceleration, in practice most moves that accelerate or decelerate
+#   will do so at the rate specified here. The value specified here
+#   may be changed at runtime using the SET_VELOCITY_LIMIT command.
+#   This parameter must be specified.
+#minimum_cruise_ratio: 0.5
+#   Most moves will accelerate to a cruising speed, travel at that
+#   cruising speed, and then decelerate. However, some moves that
+#   travel a short distance could nominally accelerate and then
+#   immediately decelerate. This option reduces the top speed of these
+#   moves to ensure there is always a minimum distance traveled at a
+#   cruising speed. That is, it enforces a minimum distance traveled
+#   at cruising speed relative to the total distance traveled. It is
+#   intended to reduce the top speed of short zigzag moves (and thus
+#   reduce printer vibration from these moves). For example, a
+#   minimum_cruise_ratio of 0.5 would ensure that a standalone 1.5mm
+#   move would have a minimum cruising distance of 0.75mm. Specify a
+#   ratio of 0.0 to disable this feature (there would be no minimum
+#   cruising distance enforced between acceleration and deceleration).
+#   The value specified here may be changed at runtime using the
+#   SET_VELOCITY_LIMIT command. The default is 0.5.
 #square_corner_velocity: 5.0
-#   La velocità massima (in mm/s) alla quale la testa di stampa può viaggiare
-#   su un angolo di 90 gradi. Un valore diverso da zero può ridurre le variazioni
-#   delle portate dell&#39;estrusore consentendo variazioni istantanee della velocità
-#   della testa utensile durante le curve. Questo valore configura l&#39;algoritmo
-#   interno di cornering della velocità centripeta; gli angoli con angoli maggiori
-#   di 90 gradi avranno una velocità in curva maggiore mentre gli angoli con
-#   angoli inferiori a 90 gradi avranno una velocità in curva inferiore. Se questo
-#   è impostato su zero, la testa utensile decelererà fino a zero ad ogni angolo.
-#   Il valore predefinito è 5 mm/s.
+#   The maximum velocity (in mm/s) that the toolhead may travel a 90
+#   degree corner at. A non-zero value can reduce changes in extruder
+#   flow rates by enabling instantaneous velocity changes of the
+#   toolhead during cornering. This value configures the internal
+#   centripetal velocity cornering algorithm; corners with angles
+#   larger than 90 degrees will have a higher cornering velocity while
+#   corners with angles less than 90 degrees will have a lower
+#   cornering velocity. If this is set to zero then the toolhead will
+#   decelerate to zero at each corner. The value specified here may be
+#   changed at runtime using the SET_VELOCITY_LIMIT command. The
+#   default is 5mm/s.
+#max_accel_to_decel:
+#   This parameter is deprecated and should no longer be used.
 </code></pre></div>
 
 <h3 id="stepper">[stepper]<a class="headerlink" href="#stepper" title="Permanent link">&para;</a></h3>
@@ -4522,18 +4567,14 @@ max_temp:
 #   where Z = 0.  When this option is specified the mesh will be offset
 #   so that zero Z adjustment occurs at this location.  The default is
 #   no zero reference.
-#relative_reference_index:
-#   **DEPRECATED, use the &quot;zero_reference_position&quot; option**
-#   The legacy option superceded by the &quot;zero reference position&quot;.
-#   Rather than a coordinate this option takes an integer &quot;index&quot; that
-#   refers to the location of one of the generated points. It is recommended
-#   to use the &quot;zero_reference_position&quot; instead of this option for new
-#   configurations. The default is no relative reference 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.
+#adaptive_margin:
+#   An optional margin (in mm) to be added around the bed area used by
+#   the defined print objects when generating an adaptive mesh.
 </code></pre></div>
 
 <h3 id="bed_tilt">[bed_tilt]<a class="headerlink" href="#bed_tilt" title="Permanent link">&para;</a></h3>
@@ -6193,50 +6234,72 @@ pin:
 <p>Pin di uscita configurabili in fase di run-time (è possibile definire un numero qualsiasi di sezioni con un prefisso "output_pin"). I pin configurati qui verranno impostati come pin di output e sarà possibile modificarli in fase di esecuzione utilizzando il comando esteso "SET_PIN PIN=my_pin VALUE=.1" <a href="G-Codes.html#output_pin">comandi g-code</a>.</p>
 <div class="highlight"><pre><span></span><code>[output_pin my_pin]
 pin:
-#   Il pin da configurare come output.
-#   Questo parametro deve essere fornito.
+#   The pin to configure as an output. This parameter must be
+#   provided.
 #pwm: False
-#   Impostare se il pin di uscita deve essere in grado di modulare la
-#   larghezza di impulso PWM. Se questo è True, i campi del valore
-#   dovrebbero essere compresi tra 0 e 1; se è False i campi del valore
-#   devono essere 0 o 1. Il valore predefinito è False.
-#static_value:
-#   Se è valorizzato, il pin viene assegnato a questo valore all&#39;avvio e
-#   il pin non può essere modificato durante il runtime. Un pin statico
-#   utilizza una ram leggermente inferiore nel microcontrollore.
-#   L&#39;impostazione predefinita prevede l&#39;utilizzo della configurazione
-#   di runtime dei pin.
+#   Set if the output pin should be capable of pulse-width-modulation.
+#   If this is true, the value fields should be between 0 and 1; if it
+#   is false the value fields should be either 0 or 1. The default is
+#   False.
 #value:
-#   Il valore su cui impostare inizialmente il pin durante la
-#   configurazione dell&#39;MCU. Il valore predefinito è 0 (per bassa tensione).
+#   The value to initially set the pin to during MCU configuration.
+#   The default is 0 (for low voltage).
 #shutdown_value:
-#   Il valore su cui impostare il pin su un evento di arresto dell&#39;MCU.
-#   Il valore predefinito è 0 (per bassa tensione).
-#maximum_mcu_duration:
-#   La durata massima di un valore di non spegnimento può essere
-#   determinato dall&#39;MCU senza un riconoscimento da parte dell&#39;host.
-#   Se l&#39;host non riesce a tenere il passo con un aggiornamento, l&#39;MCU
-#   si spegnerà e imposterà tutti i pin sui rispettivi valori di spegnimento.
-#   Default: 0 (disabilitato) I valori abituali sono circa 5 secondi.
+#   The value to set the pin to on an MCU shutdown event. The default
+#   is 0 (for low voltage).
 #cycle_time: 0.100
-#   La quantità 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 è 0.100 secondi per i pin pwm.
+#   The amount of time (in seconds) per PWM cycle. It is recommended
+#   this be 10 milliseconds or greater when using software based PWM.
+#   The default is 0.100 seconds for pwm pins.
 #hardware_pwm: False
-#   Abilitare questa opzione per utilizzare PWM hardware anziché PWM
-#   software. Quando si utilizza l&#39;hardware PWM, il tempo di ciclo effettivo
-#   è vincolato dall&#39;implementazione e può essere notevolmente diverso
-#   dal tempo di ciclo richiesto. L&#39;impostazione predefinita è Falso.
+#   Enable this to use hardware PWM instead of software PWM. When
+#   using hardware PWM the actual cycle time is constrained by the
+#   implementation and may be significantly different than the
+#   requested cycle_time. The default is False.
 #scale:
-#   Questo parametro può essere utilizzato per modificare il modo in cui
-#   i parametri &#39;value&#39; e &#39;shutdown_value&#39; vengono interpretati per i pin
-#   pwm. Se fornito, il parametro &#39;value&#39; deve essere compreso tra 0.0 e
-#   &#39;scale&#39;. Questo può essere utile quando si configura un pin PWM che
-#   controlla un riferimento di tensione stepper. La &quot;scala&quot; può essere
-#   impostata sull&#39;amperaggio dello stepper equivalente se il PWM fosse
-#   completamente abilitato, quindi il parametro &quot;value&quot; può essere
-#   specificato utilizzando l&#39;amperaggio desiderato per lo stepper.
-#   L&#39;impostazione predefinita è di non ridimensionare il parametro &#39;value&#39;.
+#   This parameter can be used to alter how the &#39;value&#39; and
+#   &#39;shutdown_value&#39; parameters are interpreted for pwm pins. If
+#   provided, then the &#39;value&#39; parameter should be between 0.0 and
+#   &#39;scale&#39;. This may be useful when configuring a PWM pin that
+#   controls a stepper voltage reference. The &#39;scale&#39; can be set to
+#   the equivalent stepper amperage if the PWM were fully enabled, and
+#   then the &#39;value&#39; parameter can be specified using the desired
+#   amperage for the stepper. The default is to not scale the &#39;value&#39;
+#   parameter.
+#maximum_mcu_duration:
+#static_value:
+#   These options are deprecated and should no longer be specified.
+</code></pre></div>
+
+<h3 id="pwm_tool">[pwm_tool]<a class="headerlink" href="#pwm_tool" title="Permanent link">&para;</a></h3>
+<p>Pulse width modulation digital output pins capable of high speed updates (one may define any number of sections with an "output_pin" prefix). Pins configured here will be setup as output pins and one may modify them at run-time using "SET_PIN PIN=my_pin VALUE=.1" type extended <a href="G-Codes.html#output_pin">g-code commands</a>.</p>
+<div class="highlight"><pre><span></span><code>[pwm_tool my_tool]
+pin:
+#   The pin to configure as an output. This parameter must be provided.
+#maximum_mcu_duration:
+#   The maximum duration a non-shutdown value may be driven by the MCU
+#   without an acknowledge from the host.
+#   If host can not keep up with an update, the MCU will shutdown
+#   and set all pins to their respective shutdown values.
+#   Default: 0 (disabled)
+#   Usual values are around 5 seconds.
+#value:
+#shutdown_value:
+#cycle_time: 0.100
+#hardware_pwm: False
+#scale:
+#   See the &quot;output_pin&quot; section for the definition of these parameters.
+</code></pre></div>
+
+<h3 id="pwm_cycle_time">[pwm_cycle_time]<a class="headerlink" href="#pwm_cycle_time" title="Permanent link">&para;</a></h3>
+<p>Run-time configurable output pins with dynamic pwm cycle timing (one may define any number of sections with an "pwm_cycle_time" prefix). Pins configured here will be setup as output pins and one may modify them at run-time using "SET_PIN PIN=my_pin VALUE=.1 CYCLE_TIME=0.100" type extended <a href="G-Codes.html#pwm_cycle_time">g-code commands</a>.</p>
+<div class="highlight"><pre><span></span><code>[pwm_cycle_time my_pin]
+pin:
+#value:
+#shutdown_value:
+#cycle_time: 0.100
+#scale:
+#   See the &quot;output_pin&quot; section for information on these parameters.
 </code></pre></div>
 
 <h3 id="static_digital_output">[static_digital_output]<a class="headerlink" href="#static_digital_output" title="Permanent link">&para;</a></h3>