get_active_material
Reads live AMS tray data to retrieve the currently loaded filament's type, colour, remaining percentage, and temperature range. Reports 'unknown' for printers without AMS.
Instructions
Get the filament physically active in the AMS hardware right now (Bambu Lab).
Reads live tray data from the AMS hardware. For the software-tracked
material (what was told to Kiln via ``set_material``), use
``get_material`` instead.
For Bambu Lab printers with an AMS, reads the active tray and
returns its type, colour, remaining percentage, and temperature
range. For non-Bambu printers (or printers without AMS), the
material is reported as ``"unknown"``.
``tray_now == "255"`` normally means external spool. On some
A1/AMS Lite reports it can also mean the active slot was not
reported even though AMS trays are present; in that case Kiln
falls back to selected/target tray metadata or returns the
loaded AMS candidates instead of claiming external spool.
Args:
printer_name: Named printer to query. Omit to use the
default printer.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| printer_name | No |