Устранение неполадок¶

Частые проблемы¶

Проблема	Решение
Не удаётся подключиться	Проверьте учётные данные в Sber Studio. Убедитесь, что проект активен.
Ошибки SSL	Попробуйте отключить "Проверять SSL" в настройках интеграции.
Устройства не появляются в Сбер	Проверьте Параметры > выберите устройства. Проверьте логи HA.
Устройства появляются и исчезают	Проверьте логи на сообщения о переподключении. Убедитесь в стабильности интернета.
Дублирование устройств	Удалите дубли в ручном режиме. Или "Удалить ВСЕ", затем "Добавить ВСЕ".
Датчики показывают неверные значения	Включите отладочные логи и проверьте маппинг entity.

Отладочные логи¶

Добавьте в configuration.yaml:

logger:
  logs:
    custom_components.sber_mqtt_bridge: debug

После перезагрузки Home Assistant в логах будут видны:

MQTT <- topic (N bytes) -- каждое входящее MQTT-сообщение
Sber -> HA command: entity_id [ключи] -- детали полученной команды от Sber
HA -> Sber state: entity_id = состояние -- публикация состояний в Sber
Entity xxx -> Sber категория (домен, device_class) -- решения маппинга устройств
Sber error (#N): {...} -- ошибки от облака Sber

Совет

Отладочные логи могут быть очень объёмными. Включайте их только для диагностики, после чего не забудьте выключить.

Диагностика¶

Home Assistant предоставляет встроенную функцию диагностики для интеграций.

Как скачать диагностику¶

Перейдите в Настройки > Устройства и службы
Найдите Sber Smart Home MQTT Bridge
Нажмите три точки :material-dots-vertical: > Скачать диагностику

Что содержит файл диагностики¶

Статус подключения -- подключён ли мост к MQTT-брокеру Sber
Время работы (uptime) -- сколько времени мост подключён
Счётчики сообщений -- количество полученных, отправленных сообщений и ошибок
Количество переподключений -- сколько раз мост переподключался
Список подтверждённых устройств -- какие устройства Sber подтвердил
Список неподтверждённых устройств -- устройства, которые Sber ещё не видел
Конфигурация устройств -- полный список экспортируемых сущностей

Конфиденциальность

Учётные данные MQTT (логин и пароль) автоматически маскируются в файле диагностики. Файл безопасно отправлять для помощи в отладке.

Подключение к MQTT¶

Параметры подключения¶

Интеграция подключается к MQTT-брокеру Sber по TLS:

Параметр	Значение
Брокер	`mqtt-partners.iot.sberdevices.ru`
Порт	`8883`
Протокол	MQTT 3.1.1 over TLS
Макс. размер сообщения	1 МБ

Автоматическое переподключение¶

При потере соединения интеграция автоматически переподключается с экспоненциальной задержкой:

1-я попытка: через 5 секунд
2-я попытка: через 10 секунд
3-я попытка: через 20 секунд
...и так далее до максимума 5 минут между попытками

Состояния HA не теряются

Во время переподключения интеграция продолжает отслеживать изменения состояний в HA. После восстановления соединения актуальные состояния будут отправлены в Sber.

Вкладка DevTools в Sidebar Panel — первое место для диагностики без включения debug-логов:

Как использовать DevTools¶

В боковом меню HA откройте панель Sber Smart Home Bridge
Перейдите на вкладку DevTools
Нажмите Raw Config для просмотра JSON-конфигурации, которую интеграция отправляет в Sber
Нажмите Raw States для просмотра текущих состояний устройств в Sber-формате
Включите MQTT Log для просмотра сообщений в реальном времени

Типичные кейсы¶

Ситуация	Что смотреть
Устройство не появляется в Сбер	Raw Config — есть ли оно вообще в конфигурации?
Устройство появляется, но не работает	Raw States — корректны ли значения?
Команды от Салют не приходят	MQTT Log — есть ли входящие сообщения после голосовой команды?
Некорректный тип устройства	Raw Config — проверьте поле `category` для устройства

Связывание entity (Entity Linking) — диагностика¶

Привязанная entity не обновляет основное устройство¶

Убедитесь, что связь настроена: Sidebar Panel > выберите основное устройство > проверьте "Linked entities"
Проверьте, что entity с ролью (battery, signal и др.) существует и имеет состояние (не unavailable)
Включите debug-логи и проверьте сообщения с пометкой linked entity state change

Entity Linking не предлагается в мастере¶

Мастер предлагает связывание только для entity из того же физического устройства (одинаковый device_id в HA). Если entity зарегистрированы в HA как разные устройства — автоматическое предложение не появится. Привязку можно добавить вручную через YAML (sber_parent_id).

Значок "Loading..." в колонке статуса таблицы устройств означает, что HA ещё не получил ни одного состояния от этой entity (entity в статусе unknown).

Причины: - Entity только что добавлена и ещё не опрашивалась - Устройство (Zigbee, Z-Wave и др.) не передало ни одного значения после запуска HA - Entity недоступна (unavailable) с момента запуска

Что делать: подождите несколько минут. Если значок не исчезает — проверьте состояние entity в Настройки > Устройства и службы > найдите entity и посмотрите её текущее состояние.

Важно: значок Loading... не означает ошибку. Логика онлайн-статуса: - Event-based binary_sensors (движение, дверь, протечка): при unknown считаются online (датчик ждёт события) - Value-based сенсоры (температура, влажность): при unknown считаются offline (нет данных — нет связи)

Часто задаваемые вопросы¶

Устройства не появляются в приложении Сбер¶

Убедитесь, что интеграция подключена (проверьте статус в Настройки > Устройства и службы)
Проверьте, что в параметрах интеграции выбраны устройства для экспорта
В приложении Сбер проверьте Настройки > Подключенные сервисы -- MQTT-интеграция должна быть включена
Подождите 10-30 секунд после подключения

Голосовые команды не работают¶

Переименуйте устройства в приложении Сбер -- используйте простые русские названия
Назначьте устройствам комнаты
Попробуйте команду: "Салют, покажи список устройств"

Интеграция постоянно переподключается¶

Проверьте стабильность интернет-соединения
Убедитесь, что проект в Sber Studio активен
Проверьте, не истекли ли учётные данные MQTT
Включите debug-логи для детальной информации

Как обновить учётные данные¶

Если вы сменили пароль в Sber Studio:

Home Assistant покажет уведомление о необходимости реаутентификации
Перейдите в Настройки > Устройства и службы > Sber Smart Home MQTT Bridge
Нажмите Повторная аутентификация и введите новые данные