Устройства

Устройство главный элемент системы, который реализует одностороннюю или двустороннюю связь между VizIoT и вашим физическим устройством.

В качестве физических устройств могут выступать такие устройств как ESP8266, Arduino, Raspberry PI, Персональный компьютер, Смартфон и другие устройства с выходом в интернет.

Управлять (добавлять и редактировать) устройствами можно на странице «Мои устройства».

Чтобы добавить устройство откройте страницу «Мои устройства» в нижнем правом углу будет кнопка добавления устройства . Добавление устройства происходит в два этапа.

На первом этапе задается имя устройства и протокол взаимодействия с устройством после подтверждения устройству присвоится уникальный ключ и пароль доступа которые необходимы для подключения и идентификации физического устройства в системе.

На втором этапе производится настройка параметров, которые будет передавать физическое устройство на сервер. Если устройство передает неизвестный параметр, то он автоматический добавляется в список параметров с типом «Пользовательский», таким образом параметры можно настроить уже после подключения устройства на сервер.

К основным настройкам относятся:

• Название – используется для отображения устройства в системе
• Ключ доступа – генерируется автоматический при создании, является уникальным и используется для идентификации устройства в системе
• Ключ открытого доступа – активен только когда вы разрешите доступ к устройству, позволяет только считывать данные.
• Пароль доступа – генерируется автоматически при создании
• Описание – используется для заметок и выводится только на странице «Мои устройства»
• Передаваемые параметры – используется для обозначения всех передаваемых параметров устройства, присвоения типов данных и понятному для пользователя обозначения параметра (так как зачастую ключ параметра несет мало информации о том, что за данные в нем хранятся)

Ваше устройство должно быть подключено к сети Интернет. Наш сервис поддерживает два типа соединения с сервером через HTTP GET запросы или MQTT клиент.

Для передачи данных по протоколу HTTP GET необходимо отправлять запросы по адресу http://viziot.com:48656/update с параметрами.

• key: ключ доступа вашего устройства
• pass: пароль доступа вашего устройства

• date: используется для указания даты и времени. Значение необходимо указывать в формате Unix Timestamp UTC+0. Если не передавать параметр, то тогда будет использоваться время записи данных на сервере.
• Все остальные параметры считаются параметрами устройства.

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

http://viziot.comdev:48656/update?key=123456789ABCDEFG&pass=123456789ABCDEFGabcd&date=1531486022¶m1=0

Детальнее описано в Разделе Протоколы -> HTTP GET запросы.

Для передачи данных по протоколу MQTT необходимо подключится к нашему MQTT брокеру.

• SERVER: viziot.com
• PORT: 48651
• CLIENTID: любой текст (может совпадать с USERNAME)
• USERNAME: ключ доступа который генерируется при создании устройства
• PASSWORD: пароль доступа который генерируется при создании устройства
• Топик для отправки данных: /devices/USERNAME/packet
• Топик для получения данных: /devices/USERNAME/param/+

При публикация данных полезная нагрузка должна быть в формате JSON. Например, {"date":"1527897593","rsst":"-64","t1":"28.90"}.

Для указания даты и времени используете ключ date со значением в формате Unix Timestamp UTC+0. Если не передавать параметр, то тогда будет использоваться время записи данных на сервере.

Все остальные параметры считаются параметрами устройства.

Детальнее описано в Разделе Протоколы -> MQTT.

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

У каждого параметра есть три настройки:

• Ключ – передает ваше устройство
• Тип – необходим для понимания какие данные хранит данный параметр
• Описание – используется для визуализации в системе вместо ключа так как ключ не всегда понятно описывает содержавшиеся в нем данные (рекомендуемая длина до 10 символов).

Поддерживается такие типы параметров как:

• Пользовательский
• Температура, °C
• Температура, °F
• Температура, K
• Влажность, %
• Атмосферное давление, Pa
• Осадки, mm
• Скорость, m/s
• Азимут, °
• Напряжение, V
• Сила тока, A
• Мощность, W
• Счетчик энергии, Wh
• Мощность сигнала, dBm
• Вкл / выкл, 0-1 – Особый тип так, как только он применяется в виджете переключатели
• Освещенность, lx
• Счётчик воды, m3
• Углекислый газ, ppm
• Высота над уровнем моря, m
• Проценты, %
• Миллисекунды, ms
• Секунды, s
• Минуты, m
• Часы, h
• Дни, Days
• Бит, bit
• Байт, B
• Килобайт, KB
• Мегабайт, MB
• Гигабайт, GB
• Терабайт, TB

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

Чтобы открыть устройство для общего доступа:

1. перейдите на страницу «Мои устройства»
2. найдите нужное устройства и нажмите на кнопку «Настройки доступа»
3. откроется окно «Форма настройки доступа к устройству» и нажмите на галочку «Включить»
4. также на данной форме можно указать описание открытого доступа вашего устройства в нем можно кратко описать что это за устройство какие данные передает.

Все теперь ваше устройство открыто и доступно по ссылке (ссылку можно скопировать специальной кнопкой). Если вы хотите, чтобы ваше устройство было доступно в разделе «Список открытых устройств» то поставьте галочку напротив пункта «Показывать в открытых устройствах».