Status reference¶

Questo documento è 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¶

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 è disponibile solo se il sensore angolare è un chip tle5012b e se le misurazioni sono in corso (altrimenti segnala None).

bed_mesh¶

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¶

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 è attualmente attivo.
state: lo stato dello strumento di regolazione delle viti del piatto. È 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¶

Le seguenti informazioni sono disponibili nell'oggetto configfile (questo oggetto è 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à 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à 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à un dizionario contenente un campo type e message (entrambe le stringhe). Ulteriori campi potrebbero essere disponibili a seconda del tipo di avviso.

display_status¶

Le seguenti informazioni sono disponibili nell'oggetto display_status (questo oggetto è automaticamente disponibile se è definita una sezione di configurazione display):

progress: il valore di avanzamento dell'ultimo comando G-Code M73 (o virtual_sdcard.progress se non è stato ricevuto alcun M73 recente).
message: il messaggio contenuto nell'ultimo comando G-Code M117.

endstop_phase¶

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 è 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¶

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¶

Le seguenti informazioni sono disponibili per gli oggetti extruder_stepper (così come per gli oggetti extruder):

pressure_advance: il valore corrente di pressure advance.
smooth_time: il tempo di avanzamento graduale della pressure advance corrente.
motion_queue: il nome dell'estrusore con cui è attualmente sincronizzato questo stepper estrusore. Questo viene segnalato come None se lo stepper dell'estrusore non è attualmente associato a un estrusore.

fan¶

Le seguenti informazioni sono disponibili negli oggetti fan, heater_fan some_name e controller_fan some_name:

speed: La velocità della ventola come float tra 0.0 e 1.0.
rpm: la velocità della ventola misurata in rotazioni al minuto se la ventola ha un pin tachimetro definito.

filament_switch_sensor¶

Le seguenti informazioni sono disponibili negli oggetti filament_switch_sensor some_name:

enabled: Restituisce True se il sensore interruttore è attualmente abilitato.
filament_detected: restituisce True se il sensore è in uno stato attivato.

filament_motion_sensor¶

Le seguenti informazioni sono disponibili negli oggetti filament_motion_sensor some_name:

abilitato: Restituisce True se il sensore di movimento è attualmente abilitato.
filament_detected: restituisce True se il sensore è in uno stato attivato.

firmware_retraction¶

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_button¶

The following information is available in gcode_button some_name objects:

state: The current button state returned as "PRESSED" or "RELEASED"

gcode_macro¶

Le seguenti informazioni sono disponibili negli oggetti gcode_macro some_name:

<variabile>: il valore corrente di una variabile gcode_macro.

gcode_move¶

Le seguenti informazioni sono disponibili nell'oggetto gcode_move (questo oggetto è sempre disponibile):

gcode_position: la posizione corrente della testa di stampa rispetto all'origine del Gcode corrente. Cioè, posizioni che si potrebbero inviare direttamente a un comando G1. È 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. È 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ò alterare questa posizione. È possibile accedere ai componenti x, y e z di questa posizione (ad esempio, homing_origin.x).
speed: l'ultima velocità impostata in un comando G1 (in mm/s).
speed_factor: La"speed factor override" come impostato da un comando M220. Questo è un valore in virgola mobile tale che 1,0 significa nessun override e, ad esempio, 2,0 raddoppierebbe la velocità richiesta.
extrude_factor: L'"extrude factor override" come impostato da un comando M221. Questo è 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à coordinate assolute G90 o False se in modalità relativa G91.
absolute_extrude: restituisce True se in modalità di estrusione assoluta M82 o False se in modalità relativa M83.

hall_filament_width_sensor¶

Le seguenti informazioni sono disponibili nell'oggetto hall_filament_width_sensor:

is_active: Restituisce True se il sensore è attualmente attivo.
Diameter: l'ultima lettura dal sensore in mm.
Raw: l'ultima lettura grezza dell'ADC dal sensore.

Riscaldatore¶

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ò estrudere (definito da min_extrude_temp), disponibile solo per extruder

Riscaldatori¶

Le seguenti informazioni sono disponibili nell'oggetto heaters (questo oggetto è disponibile se è 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"].
available_monitors: Returns a list of all currently available temperature monitors by their full config section names, e.g. ["tmc2240 stepper_x"]. While a temperature sensor is always available to read, a temperature monitor may not be available and will return null in such case.

idle_timeout¶

Le seguenti informazioni sono disponibili nell'oggetto idle_timeout (questo oggetto è sempre disponibile):

state: lo stato corrente della stampante monitorato dal modulo idle_timeout. È una delle seguenti stringhe: "Idle", "Printing", "Ready".
printing_time: la quantità di tempo (in secondi) in cui la stampante è rimasta nello stato "Printing" (come tracciato dal modulo idle_timeout).

led¶

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 è 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, è possibile accedere al valore blu (3° elemento nell'elenco dei colori) del secondo neopixel in una catena in printer["neopixel <config_name>"].color_data[1][2].

manual_probe¶

Le seguenti informazioni sono disponibili nell'oggetto manual_probe:

is_active: Restituisce True se è 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¶

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¶

Le seguenti informazioni sono disponibili nell'oggetto motion_report (questo oggetto è automaticamente disponibile se è definita una sezione di configurazione stepper):

live_position: la posizione richiesta della testa di stampa interpolata all'ora corrente.
live_velocity: la velocità della testa di stampa richiesta (in mm/s) al momento attuale.
live_extruder_velocity: la velocità dell'estrusore richiesta (in mm/s) al momento attuale.

output_pin¶

Le seguenti informazioni sono disponibili negli oggetti output_pin some_name:

value: Il "valore" del pin, come impostato da un comando SET_PIN.

palette2¶

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à la quantità di filamento da caricare nell'estrusore.
is_splicing: Vero quando la Palette 2 sta giuntando il filamento.

pause_resume¶

Le seguenti informazioni sono disponibili nell'oggetto pause_resume:

is_paused: Restituisce vero se un comando PAUSE è stato eseguito senza un corrispondente RESUME.

print_stats¶

Le seguenti informazioni sono disponibili nell'oggetto print_stats (questo oggetto è automaticamente disponibile se è definita una sezione di configurazione virtual_sdcard):

filename, total_duration, print_duration, filament_used, state, message: informazioni stimate sulla stampa corrente quando è 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¶

Le seguenti informazioni sono disponibili nell'oggetto probe (questo oggetto è disponibile anche se è definita una sezione di configurazione bltouch):

name: restituisce il nome della sonda in uso.
last_query: Restituisce True se il probe è 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.

pwm_cycle_time¶

The following information is available in pwm_cycle_time some_name objects:

value: Il "valore" del pin, come impostato da un comando SET_PIN.

quad_gantry_level¶

Le seguenti informazioni sono disponibili nell'oggetto quad_gantry_level (questo oggetto è disponibile se quad_gantry_level è definito):

applied: Vero se il processo di livellamento del gantry è stato eseguito e completato con successo.

query_endstops¶

Le seguenti informazioni sono disponibili nell'oggetto query_endstops (questo oggetto è disponibile se è definito un finecorsa):

last_query["<endstop>"]: Restituisce True se l'endstop specificato è 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¶

Le seguenti informazioni sono disponibili nell'oggetto screws_tilt_adjust:

error: restituisce True se il comando SCREWS_TILT_CALCULATE più recente includeva il parametro MAX_DEVIATION e uno qualsiasi dei punti della vite rilevati superava il MAX_DEVIATION specificato.
max_deviation: Return the last MAX_DEVIATION value of the most recent SCREWS_TILT_CALCULATE command.
results["<screw>"]: un dizionario contenente le seguenti chiavi:
- z: L'altezza Z misurata della posizione della vite.
- sign: una stringa che specifica la direzione in cui ruotare la vite per la regolazione necessaria. O "CW" per senso orario o "CCW" per senso antiorario.
- adjust: il numero di giri di vite per regolare la vite, dato nel formato "HH:MM", dove "HH" è il numero di giri di vite completi e "MM" è 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.)
- is_base: Restituisce True se questa è la vite di base.

servo¶

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.

stepper_enable¶

Le seguenti informazioni sono disponibili nell'oggetto stepper_enable (questo oggetto è disponibile se è definito uno stepper):

steppers["<stepper>"]: Restituisce True se lo stepper specificato è abilitato.

system_stats¶

Le seguenti informazioni sono disponibili nell'oggetto system_stats (questo oggetto è sempre disponibile):

sysload, cputime, memavail: informazioni sul sistema operativo del host e sul carico del processo.

sensori di temperatura¶

Le seguenti informazioni sono disponibili in

bme280 config_section_name, htu21d config_section_name, lm75 config_section_name, temperature_host config_section_name and temperature_combined config_section_name objects:

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¶

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¶

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ù bassa e più alta vista dal sensore dall'ultimo riavvio del software host Klipper.

driver tmc¶

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ò essere nullo se l'offset di fase non è noto.
phase_offset_position: La "posizione comandata" corrispondente alla fase "zero" del driver. Questo campo può essere nullo se l'offset di fase non è noto.
drv_status: i risultati dell'ultima query sullo stato del driver. (Sono riportati solo i campi diversi da zero.) Questo campo sarà nullo se il driver non è abilitato (e quindi non viene interrogato periodicamente).
temperature: The internal temperature reported by the driver. This field will be null if the driver is not enabled or if the driver does not support temperature reporting.
run_current: La corrente di esecuzione attualmente impostata.
hold_current: La corrente di mantenimento attualmente impostata.

toolhead¶

Le seguenti informazioni sono disponibili nell'oggetto toolhead (questo oggetto è sempre disponibile):

position: l'ultima posizione comandata della testa di stampa relativa al sistema di coordinate specificato nel file di configurazione. È 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 è una stringa contenente uno o più di "x", "y", "z".
axis_minimum, axis_maximum: i limiti di corsa dell'asse (mm) dopo la corsa di homing. È 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 è l'altezza z massima al raggio massimo (printer.toolhead.cone_start_z).
max_velocity, max_accel, minimum_cruise_ratio, square_corner_velocity: The current printing limits that are in effect. This may differ from the config file settings if a SET_VELOCITY_LIMIT (or M204) command alters them at run-time.
stalls: il numero totale di volte (dall'ultimo riavvio) che la stampante ha dovuto essere messa in pausa perché la testina si muoveva più velocemente di quanto fosse possibile leggere i movimenti dall'input del G-code.

dual_carriage¶

The following information is available in dual_carriage on a cartesian, hybrid_corexy or hybrid_corexz robot

carriage_0: The mode of the carriage 0. Possible values are: "INACTIVE" and "PRIMARY".
carriage_1: The mode of the carriage 1. Possible values are: "INACTIVE", "PRIMARY", "COPY", and "MIRROR".

virtual_sdcard¶

Le seguenti informazioni sono disponibili nell'oggetto virtual_sdcard:

is_active: Restituisce True se una stampa da file è 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¶

Le seguenti informazioni sono disponibili nell'oggetto webhooks (questo oggetto è 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¶

Le seguenti informazioni sono disponibili nell'oggetto z_thermal_adjust (questo oggetto è disponibile se z_thermal_adjust è definito).

enabled: Restituisce True se la regolazione è 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¶

Le seguenti informazioni sono disponibili nell'oggetto z_tilt (questo oggetto è disponibile se z_tilt è definito):

applied: Vero se il processo di livellamento z-tilt è stato eseguito e completato con successo.