get_active_material
Reads live tray data from Bambu Lab AMS hardware to return the active filament's type, color, remaining percentage, and temperature range. Returns 'unknown' for non-AMS printers.
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 |