Sber MQTT Bridge — интеграция Home Assistant со Сбером

Кастомная интеграция для Home Assistant, которая пробрасывает ваши устройства из HA в экосистему умного дома Сбера через MQTT. После настройки устройства появляются в приложении Салют, что позволяет управлять ими удалённо через интернет и голосовым помощником.

Что умеет

• Пробрасывает выбранные устройства HA в приложение Салют
• Поддерживает реле (выключатели, лампы, кнопки, сценарии), розетки с энергомониторингом (мощность, ток, напряжение), кондиционеры (с управлением скоростью вентилятора и направлением потока), увлажнители воздуха, чайники, пылесосы, краны, лампы (яркость, цвет, цветовая температура), рулонные шторы / жалюзи, датчики температуры/влажности, датчики протечки, датчики дыма и сценарные кнопки
• Мгновенно передаёт изменения состояний из HA в Сбер и обратно
• Управляется через удобную панель прямо в интерфейсе Home Assistant

Требования

• Home Assistant 2026.3 или новее
• Логин и пароль MQTT контроллера от Сбера (получается в Sber Studio — см. ниже)
• Long-Lived Access Token вашего пользователя в Home Assistant

Получение логина и пароля MQTT от Сбера

1. Регистрация в Sber Studio

Перейдите на портал разработчика: https://developers.sber.ru/studio/registration и зарегистрируйте учётную запись.

2. Создание проекта

После входа нажмите «Создать проект». В открывшемся окне найдите и выберите тип Smart Home MQTT. Дайте проекту любое название.

3. Создание контроллера

Внутри проекта создайте контроллер — это точка подключения к брокеру Сбера. После создания в карточке контроллера будут видны:

• Логин контроллера (sber-mqtt_login) — используется как логин при подключении к брокеру
• Пароль контроллера (sber-mqtt_password) — не пользовательский пароль от аккаунта, а отдельный пароль контроллера. Если поле пустое — нажмите «Сгенерировать» и сохраните полученное значение.

Если у вас уже есть плагин SberGate — логин и пароль те же самые, новый проект создавать не нужно.

4. Связка Studio с Салютом

В Салюте надо добавить связку с проектом из Studio. Для этого зайдите в Салюте в Профиль пользователя -> Дом от интегратора, введите пользовательский логин и пароль из Studio (из п.1).

Установка

Через HACS

1. Откройте HACS → Интеграции → ⋮ (три точки) → Пользовательские репозитории
2. Вставьте URL репозитория: https://github.com/TohaRG2/MQTT-Sber-HA
3. Тип: Integration → нажмите Добавить
4. Найдите в списке Sber MQTT Bridge → нажмите Скачать
5. Перезапустите Home Assistant

Ручная установка (без HACS)

1. Скачайте репозиторий или архив с релизом
2. Скопируйте папку custom_components/sber_mqtt в /config/custom_components/sber_mqtt/
3. Перезапустите Home Assistant

Настройка интеграции

Перед настройкой подготовьте Long-Lived Access Token:

1. Нажмите на ваш профиль в левом нижнем углу HA
2. Прокрутите страницу вниз до раздела «Долгосрочные токены доступа»
3. Нажмите «Создать токен», введите любое название (например, Sber MQTT)
4. Скопируйте токен — он показывается только один раз

Затем добавьте интеграцию:

1. Перейдите в Настройки → Устройства и службы → + Добавить интеграцию
2. Найдите Sber MQTT Bridge
3. Введите данные для подключения:
   • Логин MQTT — логин контроллера из Sber Studio
   • Пароль MQTT — пароль контроллера из Sber Studio
   • Long-Lived Access Token — токен, созданный выше
   • Брокер и Порт — оставьте по умолчанию
4. Нажмите Отправить — интеграция проверит соединение и добавится в HA

После успешной настройки в боковом меню появится раздел Sber MQTT.

Добавление устройств

Далее перейдите в Home Assistant, откройте панель Sber MQTT в боковом меню и нажмите «+ Добавить устройство». Добавленное устройство должно сразу появится в Салюте. Если не появилось, то возможно в Салюте не добавили связку со Studio (см.выше Связка Studio с Салютом)

---

Управление

Реле

Прокидывает устройства HA в Салют — чтобы их можно было включать и выключать голосом или удалённо через приложение.

Подходит для сущностей с доменами: switch, light, input_boolean, media_player, script, button, input_button.

Примечание: script, button, input_button — запускаются/срабатывают по команде от Сбера, собственного состояния on/off не имеют. media_player — состояние off считается выключенным, все остальные (on, idle, playing, paused) — включённым.

1. Выберите тип Реле
2. Найдите и выберите нужную сущность из списка
3. Задайте имя, ID и комнату — заполняются автоматически из HA
4. Нажмите «Готово»

Розетка

Прокидывает умные розетки в Салют с поддержкой управления питанием и мониторингом энергопотребления.

Подходит для сущностей доменов switch и input_boolean. В отличие от реле, передаёт в Салют текущую мощность, ток и напряжение.

Параметр	Единица	Сенсор HA
Мощность	Вт	sensor с device_class: power
Ток	мА	sensor с device_class: current
Напряжение	В	sensor с device_class: voltage

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

1. Выберите тип Розетка
2. Найдите и выберите нужную сущность из списка
3. Проверьте или выберите сенсоры энергомониторинга
4. Задайте имя, ID и комнату
5. Нажмите «Готово»

Лампа

Прокидывает управляемые лампы HA в Салют. Помимо включения и выключения, поддерживает расширенное управление — в зависимости от возможностей конкретной лампы.

Функция	Описание
Яркость	Регулировка от 0 до 100%
Цвет	Управление цветом в формате HSV
Цветовая температура	От тёплого белого до холодного
Режим	Переключение между белым и цветным режимом

При добавлении интеграция автоматически определяет, какие функции поддерживает лампа.

1. Выберите тип Лампа
2. Найдите и выберите нужную light-сущность
3. Отметьте нужные функции — поддерживаемые лампой будут отмечены автоматически
4. Задайте имя, ID и комнату
5. Нажмите «Готово»

Кондиционер

Подходит для сущностей домена climate. Позволяет управлять кондиционером голосом: включать/выключать, задавать целевую температуру, режим работы, скорость вентилятора и направление потока воздуха.

Режим в HA	Режим в Салюте
cool	Охлаждение
heat	Нагрев
fan_only	Вентиляция
dry	Осушение
auto / heat_cool	Авто

Скорость вентилятора (fan_mode)	В Салюте
auto / low / medium / high	auto / low / medium / high
preset boost	turbo
preset sleep	quiet

Направление потока (swing_mode)	В Салюте
off	Без качания
vertical	Вертикальное
horizontal	Горизонтальное
both	Вращение

Примечание: если у кондиционера изменился набор поддерживаемых режимов — удалите и создайте устройство заново.

1. Выберите тип Кондиционер
2. Найдите и выберите нужную climate-сущность
3. При желании укажите датчик текущей температуры — если не выбрать, используется встроенный датчик кондиционера
4. Задайте имя, ID и комнату
5. Нажмите «Готово»

Увлажнитель воздуха

Подходит для сущностей домена humidifier. Позволяет управлять увлажнителем через Салют: включать/выключать, задавать целевую влажность и режим работы.

Параметр	Описание
Влажность	Текущая и целевая влажность воздуха
Режим / скорость	Соответствует режимам (auto, low, medium, high, turbo, quiet)
Уровень воды	Опционально — сенсор уровня воды в резервуаре
Замена фильтра	Опционально — binary_sensor сигнала о необходимости замены

1. Выберите тип Увлажнитель воздуха
2. Найдите и выберите нужную humidifier-сущность
3. При желании укажите сенсор уровня воды и/или датчик замены фильтра
4. Задайте имя, ID и комнату
5. Нажмите «Готово»

Чайник

Подходит для сущностей домена water_heater. Позволяет включать/выключать чайник, задавать целевую температуру нагрева и отслеживать текущую температуру воды.

Параметр	Описание
Включение / выключение	Управление питанием
Текущая температура	current_temperature из атрибутов сущности
Целевая температура	temperature из атрибутов сущности — диапазон и шаг определяются автоматически из min_temp / max_temp

1. Выберите тип Чайник
2. Найдите и выберите нужную water_heater-сущность
3. Задайте имя, ID и комнату
4. Нажмите «Готово»

Пылесос

Подходит для сущностей домена vacuum.

Статус в HA	Статус в Салюте
cleaning	Уборка
docked	На базе
paused / idle / error	Пауза
returning	Возвращение на базу

1. Выберите тип Пылесос
2. Найдите и выберите нужную vacuum-сущность
3. Датчик заряда батареи подтягивается автоматически; при необходимости выберите вручную
4. Задайте имя, ID и комнату
5. Нажмите «Готово»

Кран

Прокидывает краны и вентили в Салют. Подходит для valve и switch. Домен valve дополнительно поддерживает команду stop.

Состояние в HA	Состояние в Салюте
open / opening / on	Открыт
closed / closing / off	Закрыт

1. Выберите тип Кран
2. Найдите и выберите нужную сущность
3. Задайте имя, ID и комнату
4. Нажмите «Готово»

Рулонные шторы / жалюзи

Подходит для сущностей домена cover. Поддерживает открытие, закрытие и позиционирование.

1. Выберите тип Рулонные шторы / жалюзи
2. Найдите и выберите нужную cover-сущность
3. Датчик батареи подтягивается автоматически; при необходимости выберите вручную
4. Задайте имя, ID и комнату
5. Нажмите «Готово»

---

Датчики

Датчик температуры/влажности

1. Выберите тип Датчик температуры/влажности
2. Укажите сенсоры HA (все опциональны, но хотя бы один из первых двух обязателен):
   • 🌡 Температура
   • 💧 Влажность
   • 🔋 Заряд батареи
3. Задайте имя, ID и комнату
4. Нажмите «Готово»

Датчик протечки

Подходит для binary_sensor с device_class: moisture. Когда датчик фиксирует воду (on), Салют получает уведомление.

1. Выберите тип Датчик протечки
2. Найдите и выберите нужный binary_sensor
3. Датчик заряда батареи подтягивается автоматически; при необходимости выберите вручную
4. Задайте имя, ID и комнату
5. Нажмите «Готово»

Датчик дыма

Подходит для binary_sensor с device_class: smoke. Когда датчик фиксирует задымление, Салют получает уведомление.

Параметр	Описание
Задымление	Основной binary_sensor с device_class: smoke
Заряд батареи	Опционально — подтягивается автоматически или вручную
Отключение звука	Опционально — input_boolean или аналогичная сущность

1. Выберите тип Датчик дыма
2. Найдите и выберите нужный binary_sensor
3. При желании укажите сенсор отключения звука
4. Датчик заряда батареи подтягивается автоматически; при необходимости выберите вручную
5. Задайте имя, ID и комнату
6. Нажмите «Готово»

---

Автоматизации

Сценарная кнопка

Прокидывает события из HA в Сбер — чтобы в Салюте можно было запускать сценарии, реагирующие на изменения состояний устройств HA. Т.е. позволяет запускать сценарии в Салюте по нажатию кнопки в HA или включению/выключению какого-либо переключателя.

Подходит для тех же доменов, что и реле: switch, light, input_boolean, media_player, script, button, input_button.

• Включение (on) → click
• Выключение (off) → double_click
• Нажатие кнопки/запуск сценария → click

1. Выберите тип Сценарная кнопка
2. Найдите и выберите нужную сущность
3. Задайте имя, ID и комнату
4. Нажмите «Готово»

---

Управление устройствами

В панели Sber MQTT отображается список всех добавленных устройств с их текущим состоянием.

• Экспорт — скачать все устройства в JSON-файл (резервная копия или перенос на другой экземпляр HA)
• Импорт — загрузить устройства из ранее экспортированного файла
• Обновить в Сбере — принудительно переотправить конфигурацию всех устройств в Сбер. Используйте если устройства пропали из Салюта после перезапуска HA
• Отправить состояния — принудительно отправить текущие состояния всех устройств. Используйте если состояния в Салюте не соответствуют реальным
• ↑ (в строке устройства) — принудительно отправить состояние конкретного устройства
• 🗑 — удалить устройство. После удаления оно пропадёт из приложения Салют

Полезные ссылки

Как работает интеграция Sber

Создание интеграции Sber

Telegram с обсуждением интеграции

История изменений (CHANGELOG)

Лицензия

MIT