kenneth-mid / ha-bambulab

A Home Assistant Integration for Bambu Lab Printers

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

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

(:heavy_check_mark: Optional accessory)

Sensors

Sensor	X1C	X1	P1P	P1S
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
Chamber Light	✅	✅	✔️	✅

Buttons

This currently exposes the following Buttons:

Button	X1C	X1	P1P	P1S
Pause	✅	✅	✅	✅
Resume	✅	✅	✅	✅
Stop	✅	✅	✅	✅

AMS

Sensor	X1C	X1	P1P	P1S
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
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
Wifi Signal	✅	✅	✅	✅
HMS Errors	✅	✅	✅	✅
Attributes:
Count	✅	✅	✅	✅
1-Error	✅	✅	✅	✅
1-Wiki	✅	✅	✅	✅
2-Error	✅	✅	✅	✅
2-Wiki	✅	✅	✅	✅
... and so on

Cameras

Camera functionality is currently only supported for the X1C.

If you want to see this changed, please comment and vote on this BambuStudio issue.

Camera	X1C	X1	P1P	P1S
Chamber	✅	✅	❌	❌

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.

• Requires the WLED Home Assistant Integration and the requisite LED lights and ESP device.
• Clink the link below to import the WLED blueprint

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/.

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.

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

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