Визуализируйте данные через нашу бесплатную платформу.

Sigfox Russia предоставляет Вам возможность протестировать Ваши девайсы, используя нашу платформу, разработанную специально для демонстраций и для простых тестов клиентов.



Пошаговая Инструкция Использования Демонстрационной Платформы try.iotagency.sigfox.com



Примечания по инструкции:

- Вам должен быть выдан аккаунт для доступа в backend.sigfox.com и должен быть привязан контракт к Вашему аккаунту. Если Вам его не предоставили свяжитесь со своим контактным лицом из Sigfox или напишите нам на info@sigfoxrussia.com

- Эта инструкция использует регистрацию и настройку девайса AirWits на платформах Sigfox как основа. Настройки других девайсов отличаются соотвественно.

SigFox Russia не несёт ответственность за достоверность информации.

Инструкция
НАСТРОЙКА ДЭШБОРДА
Если у Вас еще не создана группа (Group) или тип девайса (Device Type) и/или не зарегистрирован Ваш девайс, то перейдите сюда или воспользуйтесь раскрывающемся меню слева чтобы выполнить необходимые шаги перед началом настройки дэшборда.
Регистрация на try.iotagency.sigfox
Этап 1. Создайте аккаунт на try.iotagency.sigfox.com

1. Перейдите на эту страничку

2. Нажмите на кнопку "Regsiter Now!"



3. Придумайте название email-а, которое определяет вашу организацию и даёт нам знать что это демонстрационный аккаунт.
i. В конце email-a надо добавить @sigfoxrussia.com (Например: mgu.demo@sigfoxrussia.com)
ii. Придумайте пароль
iii. Нажмите "Create account" (создать аккаунт)

4. Сохраните email и пароль.




Этап 1. Создание callback
Подготовительный этап настройки API
Зайдите в вашу подгруппу (device type) на сайте backend.sigfox.com

- Перейдите на вкладку "Device Type" (8).
- Введите название Вашей подгруппы в поле
Name (i), которые Вы выбрали при регистрации в backend.sigfox.com.

Нажмите в самом правом столбце "Name" на соответствующую ссылку с названием Вашей подгруппы.
Заметьте, нужно нажать на ссылку в столбце Name а не Group, это разные ссылки.
В данном примере справа, мы нажали на название подгруппы "2 prototypes."

9. Перейдите на страницу Callbacks. Вы ее можете найти на предпоследней позиции в меню странички справа.


10. Нажмите на кнопку New

11. Нажмите на кнопку Cutsom callback

12. Оставьте эту страницу открытой, потому что сейчас Вам надо будет переносить данные API с сайта try.iotagency.sigfox.com

Этап 3. Настройка API
На сайте backend введите следующие данные в соотвествующие поля -

Type: DATA, UPLINK
Channel: URL
Custom payload config: оставьте пустым
URL pattern: https://api.try.iotagency.sigfox.com/api/Messages/sigfox
Use HTTP metod: POST


На странице try.iotagency.sigfox.com, откройте вкладку "API." Найдите её внизу, на левом меню страницы.


Нажмите на поле "Manage Tokens" и создайте новый токен (нажмите на зеленую кнопку "+ Create New")

У вас должна открыться похожая строка как на фото

Пролистайте вниз до строки Headers

Скопируйте слово "Authorizations" и вставьте его в поле header (i) на сайте backend.sigfox.com, страница callbacks (смотрите на пример с фото ниже)

Так же скопируйте следующий набор из букв и цифр (токен) и вставьте это в поле value (ii)




Скопированное слово "Authorizations" вставьте в поле header (i) на сайте backend.sigfox.com, страница callbacks

Так же скопированный набор из букв и цифр (токен) вставьте в поле value (ii)

После вставки нажмите на кнопку "Ok"


Вас должно перекинуть на страницу Callbacks, где Вы должны зайти обратно на страницу настройки, нажав на кнопку в столбце Edit


Внесите эти данные с соотвествующие поля на сайте backend.sigfox.com

Content Type: application/json
Body:
{ "deviceId": "{device}", "time": {time}, "seqNumber": {seqNumber}, "data": "{data}" }

Нажмите на кнопку "Ok"

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

На сайте try.iotagency.sigfox.com у вас должен отобразиться девайс в меню странице справа.

Нажмите на "Devices" проверьте устройство.

Этап 4. Парсинг
Нажмите на кнопку с карандашем

Раскройте меню в поле "Parser"

Найдите в раскрывшемся списке Airwits ... (Ваш номер модели R4 или PM или CO2 или iAQ)

Дополнительно:

Во вкладке Operations Вы можете выполнить следующие действия -

Retrieve достанет все данные собранные девайсом за все время

Parse "отпарсит" (или конвертирует коды данных сообщений в читабельный формат) со времени активации девайса

Download позволяет Вам скачать все данные девайса

Share позволяет отослать данные кому либо на имейл

Этап 5. Создание дэшборда и виджетов
Нажмите на зеленых плюс, расположенный в меню странице справа, в правом верхнем углу

Нажмите на кнопку "+ Add widget"

В поле Name введите наименование Вашего виджета (Температуа, Влажность, и т.п.)

Поля Description, Icon можно пропустить

Width параметр размера "6" будет занимать половину ширины дэшборда. "12" будет занимать всю ширину (советуем 12 для таблиц и диаграм)

В меню Type выберите формат презентации данных (линейная/столбчатая диаграммы, таблица, gauge)

Следом, у Вас откроются дополнительные настройки


Нажмите на меню-кнопку "Select devices" и выберите Ваш девайс

Нажмите на стрелочку верх чтоб закрыть меню

Затем нажмите на поле Keys и выберите параметры которые Вы хотите отобразить в этом виджете.

В поле Time Span выберите временной срок за который вы хотите отобразить данные.

Поздравляем! Вы научились создавать дэшборд на платформе try.iotagency.sigfox.com!

На этой платформе будут отображаться данные с Вашего устройства в живом времени.

Инструкция
Настройки в бакенд

Войдите в сайт backend.sigfoxrussia.com, используя предоставленные Вам учетные данные сотрудником Sigfox.

Создание Group

Если вы хотите новый проект
(если проект уже создан, переходите к следующему этапу)
1. Выберите вкладку "Group" в меню на верхней строке



2. Нажмите на кнопку "New" в правом верхнем углу странички



3. Нажмите на "SIGFOX_Russia_Ener..."

Ваш проект будет хранится в главной папке проектов Sigfox Russia. Данные Вашего проекта будут доступны только сотрудникам Sigfox и Вашим коллегам, которым был сделан доступ к бакэнду.



4. Введите идентифицирующие данные о Вашей организации

Name: Наименование
Description: Описание
Timezone: По умолчанию должно стоять Europe Moscow

Client information
Technical contact email:
Напишите сюда имейл контактного лица Вашей организации - это для того чтобы создали доступ для тех поддержка

5. Нажмите "Ok"

6. Cообщите контактному лицу Sigfox название вашей группы, чтоб он/она привязали к Вашей группе обусловленный контракт.


Создание Device Type
Этот этап будет доступен после того как сотрудник Sigfox привяжет контракт соединения к Вашей группе (Group).


Этап - 2 (Создание Device Type)

1. Нажмите на вкладку "Device Type" в меню на верхней строчке

2. Нажмите на кнопку "New" в правом верхнем углу



3. Раскройте главную группу Sigfox Russia Energo нажав на стрелочку справа от названия


4. Найдите свою группу в раскрывшемся справа списке групп.

5. Нажмите на название Вашей группы. Этим действием Вы добавите Ваш Device Type в Вашу группу.
В данном случае, на картинке-примере справа, мы нажимаем на группу с названием "instructions test"



6. Введите название о Device Type (подгруппа девайсов)

Name это название вашей подгруппы девайсов. Придумайте название которое отображает Вашу организацию

Description это не обязательное поле для помощи в опредлении подгруппы девайсов

Keep-alive это настройка времени которое потребуется для оповещения, если девайс перестанет отсылать сообщения. Советуем поставить 120 минут для девайса AirWits

Subscription automatic renewal оставьте галочку в этом поле.

Contracts выберите контракт где есть токены (tokens)

Alert email введите Ваш email для получения оповещений о неисправности девайса

Payload parsing оставьте настройку по умолчанию (regular (raw payload))


7. Нажмите Ok


Регистрация девайса
1. Нажмите на вкладку "Device" в меню на верхней строчке

2. Нажмите на кнопку "New"

3. Раскройте главную группу Sigfox Russia Energo нажав на стрелочку справа от названия


4. Найдите свою группу в раскрывшемся справа списке групп

5. Нажмите на название Вашей группы. Этим действием Вы привяжете девайс к Вашей группе.
В данном случае, на картинке-примере справа, мы добавляем девайс в группу с названием "instructions test"

6. Введите информацию о Вашем устройстве

Identifier (hex!) Перепишите число ID в поле Identifier (hex!). ID девайса Вы сможете найти на задней стороне девайса

Name назовите устройство чтобы вы смогли его определить. Например AirWits

PAC расположен на второй строчке. Перепишите это число в после PAC на сайте

End product certificate нажмите на текст "Where can I find the end product certificate?" и откроется дополнительная информация. Выберите последний пункт "Register as a prototype" (отмечено галочкой на картинке справа)

Type выберите из раскрывающего меню вашу подгруппу (если она не выбрана автоматически)

Lat и Lng оставьте как есть

Так же, оставьте выбранными последние две опции (Subscription automatic renewal, Activable)

7. Нажмите кнопку "Ok"


Подпишитесь на нашу электронную рассылку, чтобы получать новости и предложения Sigfox Russia первыми