Állapot referencia¶
Ez a dokumentum a Klipper makrók, megjelenítési mezők és az API Szerver segítségével elérhető nyomtató állapotinformációk referenciája.
Az ebben a dokumentumban szereplő mezők változhatnak. Ha egy attribútumot használsz, a Klipper szoftver frissítésekor mindenképpen nézd át a Konfigurációs változások dokumentumot.
angle¶
A következő információk az angle some_name objektumban érhetők el:
temperature: A tle5012b mágneses hall-érzékelő utolsó hőmérsékleti értéke (Celsiusban). Ez az érték csak akkor érhető el, ha a szögérzékelő egy tle5012b chip, és ha a mérések folyamatban vannak (ellenkező esetbenNone).
bed_mesh¶
A következő információk a bed_mesh objektumban érhetők el:
profile_name,mesh_min,mesh_max,probed_matrix,mesh_matrix: Az aktuálisan aktív bed_mesh-re vonatkozó információk.profiles: A BED_MESH_PROFILE használatával beállított, jelenleg definiált profilok halmaza.
bed_screws¶
A következő információk a Config_Reference.md#bed_screws objektumban találhatók:
is_active: True értéket ad vissza, ha a tárgyasztal csavarok beállítási eszköze jelenleg aktív.state: A tárgyasztal csavarok beállítási szerszámának állapota. A következő karakterláncok egyike: "adjust", "fine".current_screw: Az aktuálisan beállított csavar indexe.accepted_screws: Az elfogadott csavarok száma.
configfile¶
A következő információk a configfile objektumban találhatók (ez az objektum mindig elérhető):
settings.<section>.<option>: Visszaadja az adott konfigurációs fájl beállítását (vagy alapértelmezett értékét) a szoftver utolsó indítása vagy újraindítása során. (A használat közben megváltoztatott beállítások nem jelennek meg itt.)config.<section>.<option>: Visszaadja az adott nyers konfigurációs fájl beállítását, ahogyan azt a Klipper a legutóbbi szoftverindítás vagy újraindítás során beolvasta. (A működés közben megváltoztatott beállítások nem jelennek meg itt.) Minden értéket string-ként ad vissza.save_config_pending: True értéket ad, ha vannak olyan frissítések, amelyeket aSAVE_CONFIGparancs a lemezen is megőrizhet.save_config_pending_items: Tartalmazza azokat a szakaszokat és opciókat, amelyeket megváltoztattak, és amelyeket egySAVE_CONFIGelmenthetne.figyelmeztetések: A konfigurációs beállításokkal kapcsolatos figyelmeztetések listája. A lista minden egyes bejegyzése egy szótár lesz, amely tartalmaz egytypeés egymessagemezőt (mindkettő karakterlánc). A figyelmeztetés típusától függően további mezők is rendelkezésre állhatnak.
display_status¶
A következő információk a display_status objektumban érhetők el (ez az objektum automatikusan elérhető, ha a kijelző konfigurációs szakasz definiálva van):
progress: A legutóbbiM73G-kód parancs előrehaladási érték (vagyvirtual_sdcard.progress, ha nem érkezett legutóbbiM73).message: Az utolsóM117G-kódú parancsban szereplő üzenet.
endstop_phase¶
A következő információk az endstop_phase objektumban érhetők el:
last_home.<stepper name>.phase: A léptetőmotor fázisa az utolsó kezdőpont felvételi kísérlet végén.last_home.<stepper name>.phases: A léptetőmotoron rendelkezésre álló fázisok száma.last_home.<stepper name>.mcu_position: A léptetőmotor pozíciója (ahogyan azt a mikrokontroller követi) a legutóbbi kezdőpont felvételi kísérlet végén. A pozíció az előremenő irányban megtett lépések száma mínusz a mikrokontroller utolsó újraindítása óta visszafelé megtett lépések számával.
exclude_object¶
A következő információk az exclude_object objektumban találhatók:
-
objektumok: AzEXCLUDE_OBJECT_DEFINEparancs által megadott ismert objektumok tömbje. Ez ugyanaz az információ, amelyet azEXCLUDE_OBJECT VERBOSE=1parancs szolgáltat. Acenteréspolygonmezők csak akkor lesznek jelen, ha az eredetiEXCLUDE_OBJECT_DEFINEparancsban szerepelnek.Íme egy JSON-minta:
[
{
"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: A kizárt objektumok neveit felsoroló karakterláncok tömbje.current_object: Az aktuálisan nyomtatott objektum neve.
extruder_stepper¶
Az alábbi információk az extruder_stepper objektumok (valamint az extruder objektumok) esetében állnak rendelkezésre:
pressure_advance: Az aktuális nyomás előtolás érték.smooth_time: Az aktuális nyomás előtolásának simítási ideje.motion_queue: Az extruder neve, amelyhez ez az extruder léptető jelenleg szinkronizálva van. Ezt aNoneértékként kell jelölni, ha az extruder léptető jelenleg nem kapcsolódik extruderhez.
fan¶
A következő információk a ventilátor, heater_fan some_name és controller_fan some_name objektumokban érhetők el:
speed: A ventilátor fordulatszáma lebegőértékben 0.0 és 1.0 között.rpm: A ventilátor mért fordulatszáma percenkénti fordulatszámban, ha a ventilátor rendelkezik tachometer_pin kimenettel.
filament_switch_sensor¶
A következő információk a filament_switch_sensor some_name objektumokban érhetők el:
enabled: True értéket ad vissza, ha a kapcsoló engedélyezve van.filament_detected: True értéket ad ha az érzékelő kioldott állapotban van.
filament_motion_sensor¶
A következő információk a filament_motion_sensor some_name objektumokban érhetők el:
enabled: True értéket ad, ha a mozgásérzékelő engedélyezve van.filament_detected: True értéket ad ha az érzékelő kioldott állapotban van.
firmware_retraction¶
A következő információk a firmware_retraction objektumban találhatók:
retract_length,retract_speed,unretract_extra_length,unretract_speed: A firmware_retraction modul aktuális beállításai. Ezek a beállítások eltérhetnek a konfigurációs állománytól, ha aSET_RETRACTIONparancs megváltoztatja őket.
gcode_button¶
A következő információk a gcode_button some_name objektumokban érhetők el:
állapot: A gomb aktuális állapota, amely "PRESSED" vagy "RELEASED" formában érkezik vissza
gcode_macro¶
A következő információk a gcode_macro some_name objektumokban érhetők el:
<variable>: Egy gcode_macro változó aktuális értéke.
gcode_move¶
A következő információk a gcode_move objektumban érhetők el (ez az objektum mindig elérhető):
gcode_position: A nyomtatófej aktuális pozíciója az aktuális G-kód origóhoz képest. Vagyis olyan pozíciók, amelyeket közvetlenül egyG1parancsnak küldhetünk. Lehetőség van e pozíció X, Y, Z és az E, komponensének elérésére (pl.gcode_position.x).position: A nyomtatófej utolsó kiadott pozíciója a konfigurációs fájlban megadott koordináta rendszerrel. Lehetőség van ennek a pozíciónak az X, Y, Z és az E, komponenséhez hozzáférni (pl.position.x).homing_origin: A G-kód koordináta rendszer origója (a config fájlban megadott koordináta rendszerhez képest), amelyet aG28parancs után használni kell. ASET_GCODE_OFFSETparancs megváltoztathatja ezt a pozíciót. Lehetőség van ennek a pozíciónak az X, Y és Z komponenséhez hozzáférni (pl.homing_origin.x).speed: Az utolsó,G1parancsban beállított sebesség (mm/sec-ben).speed_factor: AzM220parancs által beállított "sebességtényező felülbírálása". Ez egy lebegőpontos érték, így 1.0 azt jelenti, hogy nincs felülbírálat, és például a 2.0 megduplázza a kért sebességet.extrude_factor: AzM221parancs által beállított "extrude factor override". Ez egy lebegőpontos érték, így 1.0 azt jelenti, hogy nincs felülbírálat, és például a 2.0 megduplázza a kért extrudálásokat.absolute_coordinates: True értéket ad, ha aG90abszolút koordináta módban van, vagy False értéket, ha aG91relatív módban van.absolute_extrude: True értéket ad, ha azM82abszolút extrude módban van, vagy False értéket, ha azM83relatív módban van.
hall_filament_width_sensor¶
A következő információk a hall_filament_width_sensor objektumban érhetők el:
is_active: True értéket ad, ha az érzékelő jelenleg aktív.Diameter: Az érzékelő utolsó leolvasása mm-ben.Raw: Az érzékelő utolsó nyers ADC-olvasása.
heater¶
A következő információk az olyan fűtőelemekhez állnak rendelkezésre, mint az extruder, heater_bed és heater_generic:
temperature: Az adott fűtőberendezés legutóbb jelentett hőmérséklete (Celsiusban, lebegőértékben).target: Az adott fűtőberendezés aktuális célhőmérséklete (Celsiusban, lebegőértékben).power: A fűtőtesthez tartozó PWM tű utolsó értéke (0,0 és 1,0 közötti érték).can_extrude: Ha az extruder tud extrudálni (min_extrude_temphatározza meg), csak az extruder esetében elérhető
heaters¶
A következő információk a heaters objektumban érhetők el (ez az objektum akkor érhető el, ha bármilyen fűtőberendezés definiálva van):
available_heaters: Visszaadja az összes jelenleg elérhető fűtőberendezés listáját a teljes config szekció nevével, pl.["extruder", "heater_bed", "heater_generic my_custom_heater"].available_sensors: Visszaadja az összes jelenleg elérhető hőmérséklet érzékelő listáját a teljes config szekció nevével, pl.["extruder", "heater_bed", "heater_generic my_custom_heater", "temperature_sensor electronics_temp"].available_monitors: A jelenleg elérhető összes hőmérséklet-monitor listáját adja vissza a teljes konfigurációs szakasz nevével, pl.["tmc2240 stepper_x"]. Míg egy hőmérséklet-érzékelő mindig olvasható, előfordulhat, hogy egy hőmérséklet-érzékelő nem elérhető, és ilyen esetben null értéket ad vissza.
idle_timeout¶
A következő információk az idle_timeout objektumban érhetők el (ez az objektum mindig elérhető):
state: A nyomtató aktuális állapota, amelyet az idle_timeout modul követ. A következő karakterláncok egyike: "Idle", "Printing", "Ready".printing_time: Az az idő (másodpercben), amíg a nyomtató "nyomtatás" állapotban volt (ahogyan azt az idle_timeout modul követi).
led¶
A következő információk állnak rendelkezésre minden egyes [led led_name], [neopixel led_name esetében, [dotstar led_name], [pca9533 led_name], és [pca9632 led_name] a nyomtatóban meghatározott printer.cfg fájlban:
color_data: A láncban lévő ledek RGBW értékeit tartalmazó színlisták listája. Minden értéket 0,0 és 1,0 közötti lebegőértékben ábrázolunk. Minden színlista 4 elemet tartalmaz (piros, zöld, kék, fehér), még akkor is, ha az alatta lévő LED kevesebb színcsatornát támogat. Például a lánc második neopixelének kék értéke (a színlista 3. eleme) aprinter["neopixel <config_name>"].color_data[1][2]címen érhető el.
manual_probe¶
A következő információk a manual_probe objektumban találhatók:
is_active: True értéket ad vissza, ha egy kézi mérési segédszkript jelenleg aktív.z_position: A fúvóka aktuális magassága (ahogyan azt a nyomtató jelenleg értelmezi).z_position_lower: Az utolsó mérés kísérlet éppen az aktuális magasságnál alacsonyabb.z_position_upper: Az utolsó mérés kísérlet éppen nagyobb, mint az aktuális magasság.
mcu¶
A következő információk az mcu és mcu some_name objektumokban érhetők el:
mcu_version: A mikrokontroller által jelentett Klipper kód verziója.mcu_build_versions: A mikrokontroller kódjának generálásához használt építőeszközökre vonatkozó információk (a mikrokontroller által jelentett módon).mcu_constants.<constant_name>: A mikrokontroller által jelentett fordítási idejű konstansok. A rendelkezésre álló konstansok mikrokontroller architektúránként és kódrevíziónként eltérőek lehetnek.last_stats.<statistics_name>: Statisztikai információk a mikrokontroller kapcsolatról.
motion_report¶
A következő információk a motion_report objektumban érhetők el (ez az objektum automatikusan elérhető, ha bármilyen stepper konfigurációs szakasz definiálva van):
live_position: A nyomtatófej kért pozíciója az aktuális időre interpolálva.live_velocity: A nyomtatófej kért sebessége (mm/sec-ben) az aktuális időpontban.live_extruder_velocity: A kért extruder sebesség (mm/sec-ben) az aktuális időpontban.
output_pin¶
A következő információk a output_pin some_name objektumokban érhetők el:
value: ASET_PINparanccsal beállított "value" a tű értéke.
palette2¶
A következő információk a palette2 objektumban érhetők el:
ping: Az utolsó jelentett Palette 2 ping összege százalékban.remaining_load_length: A Palette 2 nyomtatás indításakor ez lesz a nyomtatófejbe töltendő nyomtatószál mennyisége.is_splicing: True, ha a Palette 2 nyomtatószálat adagol.
pause_resume¶
A következő információk a pause_resume objektumban érhetők el:
is_paused: True, ha egy PAUSE parancsot hajtottunk végre a megfelelő RESUME parancs nélkül.
print_stats¶
A következő információk a print_stats objektumban érhetők el (ez az objektum automatikusan elérhető, ha a virtual_sdcard config szakasz definiálva van):
filename,total_duration,print_duration,filament_used,state,message: Becsült információ az aktuális nyomtatásról, ha egy virtual_sdcard nyomtatás aktív.info.total_layer: Az utolsóSET_PRINT_STATS_INFO TOTAL_LAYER=<value>G-kódú parancs.info.current_layer: Az aktuális réteg értéke az utolsóSET_PRINT_STATS_INFO CURRENT_LAYER=<value>G-kódú parancs.
probe¶
A következő információk a szonda objektumban érhetők el (ez az objektum akkor is elérhető, ha egy bltouch konfigurációs szakasz van definiálva):
name: Visszaadja a használt szonda nevét.last_query: True értéket ad vissza, ha a szondát az utolsó QUERY_PROBE parancs során "triggered" -ként jelentették. Megjegyzés: ha ezt egy makróban használjuk, a sablon bővítési sorrendje miatt a QUERY_PROBE parancsot akkor ezt a hivatkozást tartalmazó makró előtt kell lefuttatni.last_z_result: Az utolsó PROBE parancs Z eredményének értékét adja vissza. Figyelem, ha ezt egy makróban használjuk, a sablon bővítési sorrendje miatt a PROBE (vagy hasonló) parancsot akkor ezt a hivatkozást tartalmazó makró előtt kell lefuttatni.
pwm_cycle_time¶
A következő információk a pwm_cycle_time some_name objektumban érhetők el:
value: ASET_PINparanccsal beállított "value" a tű értéke.
quad_gantry_level¶
A következő információk a quad_gantry_level objektumban érhetők el (ez az objektum akkor érhető el, ha a quad_gantry_level definiálva van):
applied: True, ha a portál szintezési folyamata lefutott és sikeresen befejeződött.
query_endstops¶
A következő információk a query_endstops objektumban érhetők el (ez az objektum akkor érhető el, ha bármilyen végálláskapcsoló definiálva van):
last_query["<endstop>"]: True értéket ad, ha az adott végálláskapcsolót az utolsó QUERY_ENDSTOP parancs során "triggered" -ként jelenti. Megjegyzés: ha ezt egy makróban használjuk, a sablon bővítési sorrendje miatt a QUERY_ENDSTOP parancsot akkor ezt a hivatkozást tartalmazó makró előtt kell lefuttatni.
screws_tilt_adjust¶
A következő információk a screws_tilt_adjust objektumban találhatók:
error: True értéket ad vissza, ha a legutóbbiSCREWS_TILT_CALCULATEparancs tartalmazta aMAX_DEVIATIONparamétert, és bármelyik vizsgált csavarpont meghaladta a megadottMAX_DEVIATIONértéket.max_deviation: A legutóbbiSCREWS_TILT_CALCULATEparancs utolsóMAX_DEVIATIONértékét adja vissza.results["<screw>"]: A következő kulcsokat tartalmazó szótár:z: A csavar helyének mért Z magassága.sign: Egy karakterlánc, amely megadja, hogy a szükséges beállításhoz milyen irányba kell elfordítani a csavart. Vagy "CW" az óramutató járásával megegyező irányban, vagy "CCW" az óramutató járásával ellentétes irányban.adjust: A csavar beállításához szükséges csavarfordítások száma, "HH:MM" formátumban megadva, ahol "HH" a teljes csavarfordítások száma, "MM" pedig a részleges csavarfordítást jelentő "óramutató percek" száma. (Pl. "01:15" azt jelentené, hogy a csavart egy és negyed fordulatot kell elfordítani.)is_base: True értéket ad vissza, ha ez az alapcsavar.
servo¶
A következő információk a szervó some_name objektumokban érhetők el:
printer["servo <config_name>"].value: A szervóhoz tartozó PWM tű utolsó beállítása (0,0 és 1,0 közötti érték).
stepper_enable¶
A következő információk a stepper_enable objektumban érhetők el (ez az objektum akkor érhető el, ha bármilyen léptető definiálva van):
steppers["<stepper>"]: True értéket ad vissza, ha az adott léptető engedélyezve van.
system_stats¶
A következő információk a system_stats objektumban érhetők el (ez az objektum mindig elérhető):
sysload,cputime,memavail: Információ a gazdagép operációs rendszeréről és a folyamatok terheléséről.
hőmérséklet érzékelők¶
A következő információk a következő dokumentumban találhatók
bme280 config_section_name, htu21d config_section_name, lm75 config_section_name, temperature_host config_section_name and temperature_combined config_section_name objektumok:
temperature: Az érzékelőtől utoljára kapott hőmérséklet.humidity,pressure,gas: Az érzékelőtől utoljára kapott értékek (csak a bme280, htu21d és lm75 érzékelők esetében).
temperature_fan¶
A következő információk a temperature_fan some_name objektumokban érhetők el:
temperature: Az érzékelőtől utoljára kapott hőmérséklet.target: A ventilátor célhőmérséklete.
temperature_sensor¶
A következő információk a temperature_sensor some_name objektumokban érhetők el:
temperature: Az érzékelőtől utoljára kapott hőmérséklet.measured_min_temp,measured_max_temp: Az érzékelő által a Klipper gazdagép szoftver utolsó újraindítása óta mért legalacsonyabb és legmagasabb hőmérséklet.
tmc motorvezérlők¶
A következő információk a TMC léptető motorvezérlők objektumban érhetők el (pl. [tmc2208 stepper_x]):
mcu_phase_offset: A mikrokontroller léptető pozíciója, amely megfelel a meghajtó "nulla" fázisának. Ez a mező lehet nulla, ha a fáziseltolás nem ismert.phase_offset_position: A vezető "nulladik" fázisának megfelelő "parancsolt pozíció". Ez a mező lehet nulla, ha a fáziseltolás nem ismert.drv_status: A legutóbbi motorvezérlő állapotlekérdezés eredményei. (Csak a nem nulla mezők kerülnek jelentésre.) Ez a mező nulla lesz, ha a motorvezérlő nincs engedélyezve (és így nem kerül rendszeresen lekérdezésre).hőmérséklet: Az illesztőprogram által jelentett belső hőmérséklet. Ez a mező nulla lesz, ha az illesztőprogram nincs engedélyezve, vagy ha az illesztőprogram nem támogatja a hőmérséklet jelentést.run_current: Az aktuálisan beállított működési áram.hold_current: Az aktuálisan beállított tartóáram.
toolhead¶
A következő információk a toolhead objektumban érhetők el (ez az objektum mindig elérhető):
position: A nyomtatófej utolsó parancsolt pozíciója a konfigurációs fájlban megadott koordináta rendszerhez képest. Lehetőség van ennek a pozíciónak az X, Y, Z és az E, komponenséhez hozzáférni (pl.position.x).extruder: A jelenleg aktív extruder neve. Például egy makróban használhatjuk aprinter[printer.toolhead.extruder].targetparancsot, hogy megkapjuk az aktuális extruder célhőmérsékletét.homed_axes: Az aktuálisan "homed" állapotban lévőnek tekintett cartesian tengelyek. Ez egy karakterlánc, amely egy vagy több "X", "Y", "Z" értéket tartalmaz.axis_minimum,axis_maximum: A tengely mozgásának határai (mm) a kezdőpont felvétel után. Lehetőség van e határérték X, Y, Z összetevőinek elérésére (pl.axis_minimum.x,axis_maximum.z).- A Delta nyomtatók esetében a
cone_start_za maximális sugaraknál mért maximális Z magasság (printer.toolhead.cone_start_z). max_velocity,max_accel,minimum_cruise_ratio,square_corner_velocity: Az aktuálisan érvényben lévő nyomtatási korlátok. Ez eltérhet a konfigurációs fájl beállításaitól, ha aSET_VELOCITY_LIMIT(vagy azM204) parancs futás közben módosítja azokat.stalls: Az összes alkalom száma (az utolsó újraindítás óta), amikor a nyomtatót szüneteltetni kellett, mert a nyomtatófej gyorsabban mozgott, mint ahány mozdulatot a G-kód bemenetről be lehetett olvasni.
dual_carriage¶
A következő információk a dual_carriage menüpontban érhetőek el egy cartesian, hybrid_corexy vagy hybrid_corexz géphez
carriage_0: A kocsi 0. A lehetséges értékek a következők: "INACTIVE" és "PRIMARY".carriage_1: A kocsi 1 üzemmódja. A lehetséges értékek a következők: "INACTIVE", "PRIMARY", "COPY" és "MIRROR".
virtual_sdcard¶
A következő információk a virtual_sdcard objektumban érhetők el:
is_active: True értéket ad, ha a fájlból való nyomtatás aktív.progress: A nyomtatás aktuális előrehaladásának becslése (a fájlméret és a fájl pozíciója alapján).file_path: Az aktuálisan betöltött fájl teljes elérési útja.file_position: Az aktív nyomtatás aktuális pozíciója (bájtokban).file_size: Az aktuálisan betöltött fájl mérete (bájtokban).
webhooks¶
A következő információk a webhooks objektumban érhetők el (ez az objektum mindig elérhető):
state: A Klipper aktuális állapotát jelző karakterláncot adja vissza. A lehetséges értékek: "ready", "startup", "shutdown", "error".state_message: Egy ember által olvasható karakterlánc, amely további kontextust ad az aktuális Klipper állapotról.
z_thermal_adjust¶
A következő információk a z_thermal_adjust parancsal érhetők el (ez a parancs akkor érhető el, ha a z_thermal_adjust definiálva van).
enabled: True értéket ad vissza, ha a beállítás engedélyezve van.temperature: A meghatározott érzékelő aktuális (simított) hőmérséklete. [°C]measured_min_temp: Minimális mért hőmérséklet. [°C]measured_max_temp: Maximális mért hőmérséklet. [°C]current_z_adjust: Utolsó számított Z-beállítás [mm].z_adjust_ref_temperature: A Z kiszámításához használt aktuális referencia-hőmérsékletcurrent_z_adjust[°C].
z_tilt¶
A következő információk a z_tilt objektumban érhetők el (ez az objektum akkor érhető el, ha a z_tilt definiálva van):
applied: True, ha a Z végállás kiegyenlítési folyamat lefutott és sikeresen befejeződött.