MQTT API
v.1

Общие положения

Запросы к системе выполняются по протоколу MQTTS.

API URL: mqtts://relsibcloud.com:8883

Авторизация

Автооризация производится средствами протокола MQTT. Данные для авторизации (логин и пароль) бреть в интерфейсе облака на странице объекта.

Значения параметров зоны

Внесение текущих показаний

Топик: название топика для отправки данных соответствует логину объекта

Действие:
Вносит массив новых данных с датчиков в БД.

Формат запроса:
Текстовое поле, построчно (в конце каждой строки n) данные с датчиков в формате:

	datetime dev_type dev_serial zone_id param_num:param_type:param_value:err ...
	datetime dev_type dev_serial zone_id param_num:param_type:param_value:err ...
	...

где:
datetime - в формате UNIX TIMESTAMP Если данных нет - поле содержит "0"
dev_type - типа прибора (целое) ^*1 Если данных нет - поле содержит "0"
dev_serial - серийный номер прибора (строка). Если данных нет - поле содержит "-"
zone_id - ИД зоны к оторую передаются измеренные значения (целое)
Повторяющиеся блоки показаний:
param_num - номер параметра (целое 1-4)
param_type - тип значения параметра (целое) ^*2
param_value - значение параметра (целое/вещественное)
err - наличие/отсутствие ошибки (целое 0/номер_ошибки)

^*1 - список типов приборов приведён ниже.
^*2 - список типов значений приведён ниже.

Пример запроса:

2024-08-26T15:14:32 1 D2:62:78:D7:3E:18 2 1:1:26.2:0 2:1:752:1 3:2:752:0

Пояснение:
2024-08-26T15:14:32 1 D2:62:78:D7:3E:18 2 1:1:26.2:0 2:1:752:1 3:2:752:0
------------------- | ----------------- | | | ---- |
  время показаний   | |                 | | | |    ошибка
                    | серийник прибора  | | | |    
                    тип прибора         | | | |    
                                        | | | значение
                                        | | тип зачения
					| номер параметра
                                        ИД зоны

в конце каждой строки обязателен символ перевода строки (n)

Список типов значений

	1  => "температура   (C)",
	2  => "влажность     (%)",
	3  => "co2           (ppm)",
	4  => "давление      (Pa)",
	5  => "освещённость  (lx)",
	6  => "св.поток      (lm)",
	7  => "сопротивление (Om)",
	8  => "напряжение    (Volt)",
	9  => "сила тока     (Amper)",
	10 => "частота       (Hz)",
	11 => "мощность      (Watt)",
	12 => "пыль          (мкг/м3)",
	13 => "контакт       (логич.)",

Список типов приборов

	14 => EClerk-WS-R          - Датчик  открытия/закрытия двери
	13 => EClerk-WS-L          - Датчик протечки, уровня, положения контактов
	8  => EClerk-WS-T          - Датчик температуры
	9  => EClerk-WS-K          - Датчик температуры (термопарный)
	10 => EClerk-WS-HT         - Датчик температуры и влажности
	18 => DVT-03               - Датчик температуры и влажности
	11 => EClerk-WS-QT         - Датчик температуры и уровня освещённости
	12 => EClerk-WS-HTC        - Датчик температуры, влажности, уровня СО2
	15 => EClerk-WS-HTCPm      - Датчик температуры, влажности, уровня СО2, пыли
	17 => IVIT-M               - Измеритель температуры и влажности
	19 => EClerk-Eco-M-RHT-RS  - Измеритель-регистратор температуры и влажности
	20 => EClerk-Eco-M-RHTC-RS - Измеритель-регистратор температуры, влажности, СО2
	24 => PAS-01-V             - Преобразователь напряжения
        23 => PAS-01-mV            - Преобразователь напряжения
        21 => PAS-01-T             - Преобразователь температуры
        22 => PAS-01-I             - Преобразователь тока
        16 => IVIT-1               - Термогигрометр

Просмотров: 14
Сохранено: 15.06.2025

Документация

Типы приборов HTTP API MQTT API HTTP API WebSocket API