/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