Протокол для интеграций MQTT

Обновлено 25 ноября 2022

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

Адрес MQTT-сервера Sber отображается в Studio в проекте интеграции на вкладке

(см. раздел «Получение данных для подключения контроллера к облаку Sber» для MQTT-интеграторов и для DIY-энтузиастов).

Для обмена данными используются топики, перечисленные в таблице ниже. В адресах топиков используется параметр username — это логин, с которым осуществляется подключение к MQTT-серверу Sber. Логин также можно посмотреть в проекте интеграции в Studio.

Формат сообщений в топиках см. в разделе Топики MQTT.

Топик	Чтение/запись	Описание
sberdevices/v1/__config	Чтение	Передача глобальной конфигурации
sberdevices/v1/username/down/commands	Чтение	Передача команд на изменение статуса. По завершению применения изменений необходимо отправить текущий статус устройств
sberdevices/v1/username/down/status_request	Чтение	Запрос статуса устройств. Необходимо отправить текущий статус переданных устройств
sberdevices/v1/username/down/config_request	Чтение	Запрос конфигурации устройств. Необходимо отправить текущую конфигурацию устройств
sberdevices/v1/username/up/status	Запись	Передача статуса устройств
sberdevices/v1/username/up/config	Запись	Передача конфигурации устройств

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