ha bambulab

Бамбу Лаборатория

Интеграция Home Assistant для принтеров Bambu Lab.

Вклад

Хотите внести свой вклад в развитие ха-бамбулаба? Большой! Но у нас есть несколько небольших вопросов!

• Пожалуйста, создайте свои патчи PR для main ветки.
• Пожалуйста, назовите свои коммиты соответствующим образом и добавьте некоторый контекст относительно того, что вы добавили.

ПРИМЕЧАНИЕ. Ранее мы использовали отдельную ветку develop для начальной проверки. Это уходит на пенсию.

Если вы чувствуете, что эта интеграция была ценной, и хотите поддержать ее другими способами, вы можете купить мне кофе.

Настраивать

Чтобы установить эту интеграцию, добавьте этот репозиторий GitHub в пользовательские репозитории HACS или щелкните значок выше.

Для настройки в идеале вам следует использовать свои учетные данные Bambu для простейшей настройки и большинства функций, поскольку некоторые датчики поддерживаются данными из истории печати вашей облачной учетной записи Bambu. Вы также можете (при необходимости) предоставить локальный IP-адрес принтера, чтобы обеспечить более эффективное и надежное прямое соединение с принтером для передачи данных датчика принтера и включить поддержку изображений камеры P1/A1.

Однако облачное соединение Bambu в настоящее время не поддерживает 2FA и учетные записи социальных сетей без пароля. И он, очевидно, не поддерживает принтеры, явно установленные в режим «Только локальная сеть». Если вы попадаете в любую из этих категорий, выберите вариант подключения «Конфигурация режима локальной сети». Вам нужно будет вручную предоставить:

• Серийный номер принтера — можно узнать в настройках принтера или в Bambu Studio.
• IP-адрес локального принтера — можно найти в сетевых настройках принтера (LAN).
• Код доступа — можно найти в настройках принтера.

Настройка с использованием Bambu Cloud с OAuth

Если вы зарегистрировались с использованием любого метода OAuth, вам необходимо установить пароль для вашей учетной записи Bambu Cloud:

• Войдите в мобильное приложение Bambu, используя OAuth.
• Нажмите значок человечка в правом нижнем углу.
• Нажмите «Безопасность учетной записи» > «Изменить пароль».

Это позволит вам установить пароль. Теперь вы можете войти в систему интеграции HA, используя свое имя пользователя и пароль Bambu вместо OAuth.

Функции

Фанаты

Датчик	Примечания
Вспомогательный
Камера	Нет на A1/A1 Mini.
Охлаждение

Температура

Датчик	Примечания
Кровать
Целевая кровать
Камера	только X1
Сопло
Целевое сопло

Печать данных и прогресса

Датчик	Примечания
Текущий слой
Общее количество слоев
Ход печати
Плотность печати	С полномочиями Бамбу
Длина печати	С полномочиями Бамбу
Тип кровати для печати	Выбор кровати в печатном задании
Время начала	Имитация. Более точно с учетными данными Bambu
Оставшееся время
Конец Времени
Текущий этап
Статус печати
Обложка	С полномочиями Бамбу
Общее количество часов использования	* См. примечание

* Это приблизительная оценка, которая будет неточной. Начальные часы можно прочитать на экране принтера и указать во время первоначальной настройки принтера или обновить позже через процесс настройки. И интеграция должна быть запущена после завершения печати, чтобы обновить значение. Для принтеров, отличных от X1, если интеграция перезапускается во время печати и подключение к облаку Bambu не настроено, часы использования не будут добавлены, поскольку время начала печати не будет известно. Ожидается, что вам придется время от времени корректировать это значение, чтобы исправить отклонение от значения, рассчитанного самим принтером.

Разнообразный

Датчик	Примечания
Диаметр сопла
Тип сопла
Профиль скорости
Таймлапс активен

АМС

Датчик	Примечания
Активный лоток	Если присутствует АМС
Индекс активного лотка	Если присутствует АМС

Элементы управления

Свет	Примечания
Камерный свет
Пауза
Резюме
Останавливаться
Режим ручного обновления	Только P1/A1 и доступно только в локальном режиме MQTT.

АМС

Датчик	Примечания
Индекс влажности
Температура	только X1
Лоток 1
Лоток 2
Лоток 3
Лоток 4

Атрибуты лотка:	Примечания
Цвет
Пустой
К-значение	Только P1/A1
Имя
Максимальная температура сопла
Минимальная температура сопла
Оставшаяся нить
Серийный номер катушки
Тип

Внешняя катушка

Датчик	Примечания
Внешняя катушка

Атрибуты:	Примечания
Цвет
Пустой
К-значение	Только P1/A1
Имя
Максимальная температура сопла
Минимальная температура сопла
Тип

Диагностика

Датчик	Примечания
Дверь корпуса	только X1
Доступно обновление прошивки
Принудительное обновление
Ошибки HMS	Атрибуты содержат коды ошибок, описания и URL-адреса вики.
Режим подключения MQTT	Облако Бамбу или локальное
Онлайн
Сигнал Wi-Fi

Камеры

Датчик	Примечания
Камера	P1/A1/A1Mini — требуется предоставление IP-адреса хоста.
	X1 – обязательно включите на своем принтере режим LAN LiveView.

Триггеры устройств автоматизации

Эта интеграция реализует несколько триггеров устройств, чтобы немного упростить некоторые распространенные сценарии автоматизации. См. триггеры устройства.

Пример панели мониторинга

Вы можете найти замечательный веб-конфигуратор, позволяющий легко создать панель мониторинга для вашего принтера Bambu, подобную приведенной ниже, по адресу https://www.wolfwithsword.com/bambulab-home-assistant-dashboard/.

Проблемы

Диагностический файл

Если у вас возникнут какие-либо проблемы, теперь у нас есть встроенная диагностика. Чтобы получить самую свежую информацию, нажмите кнопку «Принудительное обновление данных» в разделе «Диагностика».

Затем на странице информации об устройстве для объекта принтера вы увидите кнопку «Загрузить диагностику». Обязательно загрузите это в свой билет об ошибке/выпуск GitHub.

Ведение журнала отладки

При регистрации ошибки всегда отправляйте нам журналы отладки.

Если у вас возникли проблемы во время первоначальной настройки интеграции, вам необходимо включить журналы в файле Configuration.yaml, добавив следующее и перезапустив Home Assistant:

 logger:
  default: info
  logs:
    custom_components.bambu_lab: debug

Если вы ранее успешно установили интеграцию, журналы отладки можно включить на странице интеграции в Home Assistant:

Журналы отладки появятся в стандартных журналах Home Assistant.