--- title: Actions previous: /device-triggers previousTitle: Device Triggers next: /misc/contributing nextTitle: Misc --- For all actions the target device or entity is passed as a data field. In actions involving an AMS or external spool tray, this must be the tray entity id. In all other cases a device id. ```yaml data: device_id: a1b2c3d4e5f6g7h8i9j0 ``` ```yaml data: entity_id: a1b2c3d4e5f6g7h8i9j0 ``` ## Send Command Sends arbitrary GCODE to the printer. Be careful as it does not check if the printer is running a job or not so before invoking this action, you should check the printer state to ensure it is not running a job. ```yaml action: bambu_lab.send_command data: device_id: a1b2c3d4e5f6g7h8i9j0 command: M104 S200 ``` The `data` object should contain the following properties: The command to perform, e.g. `M104 S200` ## Print 3MF project file Prints 3MF file stored on SD card. 3MF file must be stored on SD card root and it must contain gcode (e.g., "Export sliced file" from slicer) ```yaml action: bambu_lab.print_project_file data: device_id: a1b2c3d4e5f6g7h8i9j0 filepath: cache/filename.3mf plate: 1 timelapse: true bed_leveling: false flow_cali: false vibration_cali: false layer_inspect: false use_ams: true ams_mapping: -1,-1,2,-1 ``` The `data` object should contain the following properties: Filename on SD card (e.g. `test.3mf`) --- Plate number to print --- Record timelapse of the print --- Perform bed leveling before print --- Perform flow calibration before print --- Perform vibration calibration (aka XY Mech Sweep) before print --- Perform first layer inspection during print --- Use AMS for print. Uses external spool otherwise --- See [https://community.home-assistant.io/t/bambu-lab-x1-x1c-mqtt/489510/738](https://community.home-assistant.io/t/bambu-lab-x1-x1c-mqtt/489510/738). ie: `2,-1,0` ## Extrude or Retract Filament Extrude or retract filament. ```yaml action: bambu_lab.extrude_retract data: device_id: a1b2c3d4e5f6g7h8i9j0 type: Extrude force: false ``` The `data` object should contain the following properties: The type of action to perform. Can be `Extrude` or `Retract`. --- Perform extrusion or retraction if nozzle temperature is below 170ºC. ## Load Filament Load filament into the extruder from an AMS tray or external spool. ```yaml action: bambu_lab.load_filament data: entity_id: a1b2c3d4e5f6g7h8i9j0 temperature: 220 ``` The `data` object should contain the following properties: Target nozzle temperature once the filament is loaded. If not set, uses the midpoint between min and max temperature of the current filament. ## Retry loading filament from external spool Retry loading filament from external spool. ```yaml action: bambu_lab.retry_load_filament data: device_id: a1b2c3d4e5f6g7h8i9j0 ``` ## Finish loading filament from external spool Once loading filemant from external spool is finished, use this action to tell the printer you are done. Otherwise it will go into error mode. ```yaml action: bambu_lab.done_load_filament data: device_id: a1b2c3d4e5f6g7h8i9j0 ``` ## Unload Filament Unload filament from the nozzle. ```yaml action: bambu_lab.unload_filament data: device_id: a1b2c3d4e5f6g7h8i9j0 ``` ## Set Filament Sets filament type and other data for an AMS tray or the external spool tray. ```yaml action: bambu_lab.set_filament data: entity_id: a1b2c3d4e5f6g7h8i9j0 tray_info_idx: GFL96 tray_color: FF00FF00 tray_type: PLA nozzle_temp_min: 190 nozzle_temp_max: 240 ``` The `data` object should contain the following properties: Bambu's filament ID. E.g. GFL96 is Generic PLA Silk --- RGBA value for the color. E.g. FF0000FF is opaque red. --- Type of filament. E.g. 'PLA' or 'PETG' --- The minimum temperature that it is recommended to print this filament at. --- The maximum temperature that it is recommended to print this filament at. ## Get Filament Data Gets a json string with details about all known filaments ```yaml action: bambu_lab.get_filament_data data: device_id: a1b2c3d4e5f6g7h8i9j0 ``` ## Move Axis Move the printer axis. ```yaml action: bambu_lab.move_axis data: device_id: a1b2c3d4e5f6g7h8i9j0 axis: X distance: 10 ``` The `data` object should contain the following properties: The axis to move. X1 and P1 devices, X and Y move the printhead, Z moves the bed. A1, Z moves the gantry, Y the bed, X the printhead. --- The distance (in mm) to move the axis A negative distance moves Z up, X left, Y forward. ## Skip Objects Skip objects currently being printed. ```yaml action: bambu_lab.skip_objects data: device_id: a1b2c3d4e5f6g7h8i9j0 objects: 409,1463 ``` The `data` object should contain the following properties: Object IDs are available from printable objects entity attributes ## Read AMS RFID target Read the RFID tag on a Bambu spool Triggers the AMS to attempt to re-read the RFID tag on the current spool. You must provide the AMS tray entity. ```yaml action: bambu_lab.read_rfid data: entity_id: a1b2c3d4e5f6g7h8i9j0 ``` ## Start the AMS filament drying Starts AMS filament drying. ```yaml action: bambu_lab.start_filament_drying data: device_id: a1b2c3d4e5f6g7h8i9j0 temp: 65 rotate_tray: false duration: 12 ``` The `data` object should contain the following properties: Heating temperature. AMS 2 max is 65C. AMS HT max is 85C. --- Rotate tray while drying --- Drying time in hours. ## Stops the AMS filament drying Stops AMS filament drying. ```yaml action: bambu_lab.stop_filament_drying data: device_id: a1b2c3d4e5f6g7h8i9j0 ```