Общая информация про iotkit-agent : https://github.com/enableiot/iotkit-agent (сервер alterozoom поддерживает большую часть возможностей iotkit-agent).
0)Инициализация
iotkit-admin initialize
Если версия iotkit-agent меньше 1.7.0 (версию можно узнать с помощью команды iotkit-admin version)
то нужно запустить обновление :
npm update -g iotkit-agent
systemctl stop iotkit-agent
systemctl start iotkit-agent
1)Установка протокола (в данном случае rest значит - только HTTP без web socket)
iotkit-admin protocol rest
2)Установка адреса сервера
iotkit-admin host https://alterozoom.com 86
3)Тест связи с сервером
iotkit-admin test
Должно быть показано сообщение:
info: Trying to connect to host ...
info: Connected to alterozoom
info: Environment: development
info: Build: 0.1
4)Регистрация на сайте alterozoom :
https://alterozoom.com/ru/users/sign_up
5)Авторизация c помощью email и пароля alterozoom
на сайте https://alterozoom.com:86/
6)Создание нового аккаунта IoT (можно ввести любое название)
7)Создание нового устройства
Меню слева : Devices -> New device
Device name и Gateway id можно указать любыми
Device id можно получить на устройстве с помощью команды :
iotkit-admin device-id
Пример ответа :
info: Device ID: 74-86-7a-1d-50-d7
8)Активация устройства
8.1)Получение кода активации через веб-интерфейс
Меню слева : Account -> Activation code
Если код уже не действует (новый код действует в течение 1 часа, т.е. 3600 секунд) , то нужно нажать "Renew"
Для просмотра кода нужно нажать "Show"
Пример кода активации : 1BY9IMQJ
8.2)Выполнение на устройстве команды:
iotkit-admin activate ACTIVATION_CODE
Пример ответа в случае успешной активации:
info: Activating ...
info: Saving device token...
info: Updating metadata...
info: Metadata updated.
9)Регистрация компонента (сенсора)
Команда на устройстве :
iotkit-admin register COMP_NAME COMP_TYPE
где COMP_NAME - название сенсора, пример Temperature
COMP_TYPE - тип сенсора, например, temperature.v1.0
10)Тест отправки данных
iotkit-admin observation COMP_NAME VALUE
где COMP_NAME - название сенсора
VALUE - значение (число с десятичной точкой)
11)Интеграция с документами alterozoom (и с любыми веб-страницами)
Получение адреса веб-страницы с графиком измерений компонента (сенсора) :
Меню слева : Devices -> ссылка Components -> значения в столбце Observations URL
Пример адреса : https://alterozoom.com:86/observations/acff4c66-3514-4c5f-b6e9-102e9bcd3ec9/2fb3f843-8ebf-4f7e-9fc5-b3830b125bbc/Temperature
График можно встроить в документ alterozoom и в любую веб страницу с помощью iframe : <iframe src="https://alterozoom.com:86/observations/acff4c66-3514-4c5f-b6e9-102e9bcd3ec9/2fb3f843-8ebf-4f7e-9fc5-b3830b125bbc/Temperature" width="1000" height="700"></iframe>
Пример документа : https://alterozoom.com/ru/documents/18745.html