/ha-bambulab

A Home Assistant Integration for Bambu Lab Printers

Primary LanguagePython

hacs_badge

Bambu Lab

A Home Assistant Integration for Bambu Lab printers

Contribution

Want to contribute to ha-bambulab? Great! We have a few small asks though!

  • Please do not fork and PR against the main branch
  • Use the develop branch, this is our working area. Anything in the main branch should be considered live, released code.
  • Please name your commits accordingly, and add some context as to what you have added.

Setup

Open your Home Assistant instance and open a repository inside the Home Assistant Community Store.

To install, add this Github Repo to the HACS Custom Repositories, or click the badge above.

For now, you will need the following information:

  • Printer IP
  • LAN Access Code (Can be found on the Printer settings)
  • Serial Number (Can be found in the printer settings or in Bambu Studio)

Setup using OAuth

If you signed up using any OAuth method, you need to set a password for your Bambu Cloud account:

  • Login to the Bambu mobile app using OAuth.
  • Tap the person icon at the bottom right.
  • Tap Account Security > Change Password

This will allow you to set a password. Now you can login to the HA integration using your Bambu username and password instead of OAuth.

Features

Sensors

Sensor X1C X1 P1P P1S A1 Mini
Aux Fan Speed
Bed Temperature
Chamber Fan Speed
Chamber Temperature
Cooling Fan Speed
Current Layer
Current Stage
End Time
Heatbreak Fan Speed
Nozzle Target Temperature
Nozzle Temperature
Print Progress
Print Status
Remaining Time
Speed Profile
Start Time
Target Bed Temperature
Total Layer Count
Timelapse Active

Notes:

  • If AMS(s) are present, additional 'Active tray index' and 'Active tray' sensors are present on the Printer device.
  • Start time on the P1P/S is simulated since the printer itself doesn't track that so the integration must be running when the print starts.

Lights

Light X1C X1 P1P P1S A1 Mini
Chamber Light

Buttons

This currently exposes the following Buttons:

Button X1C X1 P1P P1S A1 Mini
Pause
Resume
Stop

AMS

Sensor X1C X1 P1P P1S A1 Mini
Humidity Index
Tray 1
Tray 2
Tray 3
Tray 4
Tray Attributes:
Active
Color
Empty
K Value
Max Nozzle Temp
Min Nozzle Temp
Name
Type

External Spool

Sensor X1C X1 P1P P1S A1 Mini
External Spool
Attributes:
Active
Color
K Value
Max Nozzle Temp
Min Nozzle Temp
Name
Type

Diagnostics

This currently exposes the following Diagnostic Sensors:

Sensor X1C X1 P1P P1S A1 Mini
Wifi Signal
HMS Errors
Attributes:
Count
1-Error
1-Wiki
2-Error
2-Wiki
... and so on

Cameras

Camera X1C X1 P1P P1S A1 Mini
Chamber

P1P/P1S/A1 Mini only support the chamber camera when connected by the local LAN connection mode.

Automation device triggers

This integration implements a handful of device triggers to make some common automation scenarios a little easier. See device triggers.

WLED Lights

Support for adding LED chamber lights via the WLED.

Open your Home Assistant instance and show the blueprint import dialog with a specific blueprint pre-filled.

WLED Features

  • LED lights automatically turn off when Bambu Lida is in use so as to not interfere
  • LED lights turn red when there is an error in the printer
  • LED lights turn blue when bed is auto leveling
  • LED lights turn green when print is finished

Example dashboard

You can find an amazing web configurator to easily create a Dashboard for your Bambu printer like the one below at https://www.wolfwithsword.com/bambulab-home-assistant-dashboard/.

image image image

Issues

Diagnostic File

If you run into any issues, we now have built in diagnostics.
To grab the latest information, hit the "Force Refresh Data" button under the Diagnostic section.

image

Then on the device info page for the printer entity, you will see a "Download Diagnostics" button. Make sure you upload this to your Bug ticket

img.png

Debug Logging

When logging a bug, always ensure you send us the debug logs. These can be enabled from the Integration page itself. The debug logs will appear in the standard Home Assistant logs

img.png