Настройка¶

Первоначальная настройка подключения¶

Перейдите в Настройки > Устройства и службы > Добавить интеграцию
Найдите "Sber Smart Home MQTT Bridge"
Введите учётные данные MQTT:

Параметр	Обязательный	По умолчанию	Описание
MQTT Логин	Да	--	Логин из проекта Sber Studio
MQTT Пароль	Да	--	Пароль из проекта Sber Studio
MQTT Брокер	Нет	`mqtt-partners.iot.sberdevices.ru`	Адрес брокера
MQTT Порт	Нет	`8883`	Порт брокера (TLS)
Проверять SSL	Нет	Да	Проверка сертификата брокера

SSL-сертификат

По умолчанию интеграция проверяет SSL-сертификат MQTT-брокера Sber. Если вы используете нестандартный CA или испытываете проблемы с подключением, можно отключить проверку.

Выбор устройств (Options Flow)¶

После первоначальной настройки перейдите в параметры интеграции:

Настройки > Устройства и службы > Sber Smart Home MQTT Bridge > Настроить

Вы увидите меню с двумя разделами:

Выбор сущностей — добавить/удалить устройства
Переопределение типов — изменить категорию Sber для отдельных устройств

Режимы выбора сущностей¶

Режим	Описание
Выбрать вручную	Список с поиском. Добавляйте и удаляйте поштучно.
Добавить по категории	Выберите домены (Свет, Датчики...) — добавятся все entity из них.
Добавить по меткам	Выберите HA labels — добавятся все entity с этими метками.
Добавить ВСЕ	Один клик — все поддерживаемые entity в Sber.
Удалить ВСЕ	Очистить весь список.

Метки (Labels)

Для использования меток: в HA перейдите в Настройки > Устройства и службы > выберите entity > Метки > добавьте метку (например sber). Затем в Options Flow выберите "Добавить по меткам" и выберите эту метку.

Умная дедупликация¶

Если одно физическое устройство (например, Zigbee-лампочка) регистрирует несколько сущностей в HA — например, light.кухня и switch.кухня — интеграция автоматически оставит только более функциональный вариант.

Приоритет (от высшего к низшему):

light > cover > climate > humidifier > valve > sensor > switch > script > button

Предварительный просмотр типа устройства (Entity Preview)¶

При выборе или переопределении типа устройства интеграция показывает Entity Preview — список features Sber, которые будут опубликованы для выбранного типа. Это позволяет до сохранения убедиться, что выбранная категория соответствует реальным возможностям устройства.

Entity Preview доступен: - В мастере добавления (Sidebar Panel > Add Device Wizard, шаг 1) - В Options Flow при переопределении типа устройства

Переопределение типа устройства (UI)¶

В меню Options Flow выберите "Переопределение типов устройств". Для каждого экспортируемого entity отображается выпадающий список с доступными Sber-категориями.

Пример: у вас switch.кухня_основной — это свет, но HA определяет его как switch. Выберите для него тип "Light" — и в Sber он появится как лампочка с иконкой и возможностями управления.

Доступные категории:

Категория	Описание	Иконка в Sber
`light`	Свет	Лампочка
`relay`	Реле / переключатель	Переключатель
`socket`	Розетка	Розетка
`curtain`	Шторы	Шторы
`window_blind`	Жалюзи / рольставни	Жалюзи
`gate`	Ворота / гаражные двери	Ворота
`hvac_ac`	Кондиционер	Кондиционер
`hvac_radiator`	Радиатор / обогреватель	Термостат
`valve`	Вентиль (водяной кран)	Кран
`hvac_humidifier`	Увлажнитель воздуха	Увлажнитель
`scenario_button`	Кнопка сценария	Кнопка

Auto

Значение "Auto" означает автоматическое определение типа по домену и device_class сущности HA. Это поведение по умолчанию.

Кастомизация через YAML (configuration.yaml)¶

Помимо UI-настроек, вы можете настроить entity через configuration.yaml. Это удобно для автоматизации и хранения конфигурации в Git.

Базовый синтаксис¶

sber_mqtt_bridge:
  entity_config:
    <entity_id>:
      sber_type: <категория>    # необязательно
      sber_name: "<имя>"        # необязательно
      sber_room: "<комната>"    # необязательно

Параметры¶

Параметр	Тип	Описание
`sber_type`	string	Переопределить категорию устройства в Sber. Доступные значения: `light`, `relay`, `socket`, `curtain`, `window_blind`, `gate`, `hvac_ac`, `hvac_radiator`, `valve`, `hvac_humidifier`, `scenario_button`
`sber_name`	string	Имя устройства, которое будет отображаться в приложении Сбер и при голосовом управлении через Салют
`sber_room`	string	Комната, к которой будет привязано устройство в Сбер. Название должно совпадать с названием комнаты в приложении Сбер

Приоритет настроек¶

Настройки применяются с учётом приоритетов (от высшего к низшему):

Переопределение в приложении Сбер (rename/change_group) — имеет наивысший приоритет для имени и комнаты
Переопределение в UI (Options Flow → Переопределение типов) — для типа устройства
YAML конфигурация (configuration.yaml) — используется если нет UI-переопределения
Автоматическое определение — по домену и device_class HA entity

Примеры¶

Пример 1: Переключатель как свет¶

Zigbee-реле управляет светильником, но HA видит его как switch. Чтобы в Сбер он отображался как лампочка:

sber_mqtt_bridge:
  entity_config:
    switch.kitchen_light:
      sber_type: light
      sber_name: "Свет кухня"
      sber_room: "Кухня"

Результат: в приложении Сбер появится устройство "Свет кухня" с иконкой лампочки в комнате "Кухня". Команда "Салют, включи свет на кухне" будет работать.

Пример 2: Несколько устройств с именами и комнатами¶

sber_mqtt_bridge:
  entity_config:
    # Свет
    light.living_room:
      sber_name: "Люстра"
      sber_room: "Гостиная"

    light.bedroom_lamp:
      sber_name: "Ночник"
      sber_room: "Спальня"

    # Реле → свет
    switch.hallway_relay:
      sber_type: light
      sber_name: "Свет коридор"
      sber_room: "Коридор"

    # Датчики
    sensor.outdoor_temperature:
      sber_name: "Температура на улице"
      sber_room: "Двор"

    # Шторы
    cover.bedroom_curtain:
      sber_name: "Шторы спальня"
      sber_room: "Спальня"

Пример 3: Только имена (без изменения типа)¶

Если тип определяется корректно, но нужны русские имена:

sber_mqtt_bridge:
  entity_config:
    light.0xa4c138827efe2255_l1:
      sber_name: "Кухня основной"
    light.0xa4c138827efe2255_l2:
      sber_name: "Кухня второй свет"
    sensor.temperature_living_room:
      sber_name: "Температура гостиная"

Пример 4: Переопределение комнат для организации в Сбер¶

sber_mqtt_bridge:
  entity_config:
    # Все датчики — в одну "комнату" для удобства
    sensor.temp_bathroom:
      sber_room: "Ванная"
    sensor.humidity_bathroom:
      sber_room: "Ванная"
    binary_sensor.motion_hallway:
      sber_room: "Прихожая"
    binary_sensor.door_front:
      sber_room: "Прихожая"

Перезагрузка

После изменения configuration.yaml необходимо перезагрузить Home Assistant (или перезагрузить интеграцию через UI) для применения изменений.

Совмещение UI и YAML

YAML-конфигурация и UI-настройки работают вместе:

Выбор entity (какие устройства экспортировать) — только через UI (Options Flow)
Тип устройства — можно через UI или YAML (UI приоритетнее)
Имя и комната — можно через YAML или приложение Сбер (Сбер приоритетнее)

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

После добавления устройств:

Откройте приложение Сбер Умный дом
Устройства появятся автоматически (может занять 10-30 секунд)
Переименовать устройство: нажмите на устройство > иконка настроек > измените имя
Назначить комнату: нажмите на устройство > иконка настроек > выберите комнату
Голосовое управление: скажите, например, "Салют, включи свет на кухне"

Примеры голосовых команд:

Команда	Что делает
"Салют, включи свет на кухне"	Включает light.kitchen
"Салют, выключи всё"	Выключает все устройства
"Салют, какая температура в спальне?"	Читает sensor.temp_bedroom
"Салют, закрой шторы"	Закрывает cover.curtain
"Салют, установи температуру 23 градуса"	Устанавливает climate.hvac на 23°C
"Салют, включи увлажнитель"	Включает humidifier.*

Переименования и комнаты из Сбер

Переименования и назначения комнат, сделанные в приложении Сбер, сохраняются локально в интеграции и будут включены в будущие публикации конфигурации. Они имеют приоритет над YAML-настройками sber_name и sber_room.

После установки интеграции в боковом меню Home Assistant появляется встроенная панель управления — Sber Smart Home Bridge (SPA-приложение).

Вкладки панели¶

Devices (Устройства)¶

Таблица всех экспортируемых устройств:

Колонка	Описание
Имя	Отображаемое имя устройства
Entity ID	Идентификатор entity в HA
Категория Sber	Тип устройства в протоколе Sber
Статус	Онлайн / Офлайн / Loading...
Подтверждено	Получено ли подтверждение от облака Sber

Значок "Loading..." означает, что HA ещё не получил ни одного состояния от entity (entity в статусе unknown). После прихода первого состояния значок меняется на Online или Offline согласно логике типа сенсора.

Add Device Wizard (Мастер добавления)¶

Пошаговый мастер для добавления нового устройства:

Шаг 1 — Тип устройства: выбор категории Sber из выпадающего списка. Показывается Entity Preview — предварительный просмотр features, которые будут опубликованы в Sber для выбранного типа.
Шаг 2 — Основная entity: выбор entity из HA. Мастер автоматически находит entity с тем же device_id и предлагает совместимые для привязки (Entity Linking).
Шаг 3 — Имя и подтверждение: задать имя устройства и сохранить.

DevTools (Инструменты разработчика)¶

Вкладка для отладки без перезапуска HA:

Инструмент	Описание
Raw Config	Полная конфигурация устройств в JSON-формате, отправляемом в Sber
Raw States	Текущие состояния всех устройств в Sber-формате
MQTT Log	Лог MQTT-сообщений в реальном времени (входящие и исходящие, с временными метками)

Payloads в MQTT Log сворачиваемые — нажмите для просмотра полного содержимого сообщения.

Entity Linking доступен в мастере добавления (вкладка Add Device Wizard):

Выберите тип устройства и основную entity.
На втором шаге мастер автоматически находит entity с тем же device_id в HA.
Совместимые entity для привязки подсвечены и предвыбраны (зелёные). Несовместимые отображаются серым с пометкой "(not supported)".
Снимите или установите галочки по необходимости.
Подтвердите — привязанные entity исчезнут из списка доступных и будут управляться через основное устройство.

Связи хранятся в config_entry.options и переживают перезапуск HA.

Реаутентификация¶

Если учётные данные MQTT стали недействительны (например, вы сменили пароль в Sber Studio), Home Assistant предложит пройти реаутентификацию. Перейдите в настройки интеграции и обновите пароль.