Настройка OSS шаг за шагом

1. Что где на корпусе

• Индикаторы: синий - сотовая связь, жёлтый - Wi-Fi или Bluetooth, зелёный и красный - облако и сервер прошивок.
• Зона NFC - сюда подносят телефон.
• Юбка от дождя - силиконовая, защищает отверстия модуля со встроенными датчиками.
• Модуль датчиков снизу: встроенные датчики или кабель Modbus.
• Внутри: антенны, батарея, слот SIM-карты, магнитный разъём для USB-питания.

2. Монтаж

1. SIM-карта - для моделей с буквой C. В станции уже стоит карта micro-SIM от Tibbo: связь с несколькими операторами в 180+ странах. Подойдёт и карта другого оператора: выверните два винта снизу, выньте внутренний блок и замените карту. При сборке проверьте уплотнительное кольцо.
2. Юбка от дождя - надевается на модуль со встроенными датчиками.
3. На стену - пластиковым кронштейном из комплекта. У Tibbo есть шаблон для разметки отверстий в масштабе 1:1.
4. На трубу диаметром 38-51 мм - металлическими скобами из комплекта.
5. От кражи - стальным тросом 3 мм, как на схеме крепления.

Модуль со встроенными датчиками должен «дышать»: не ставьте станцию под прямое солнце и у выходов вентиляции, если нужен воздух помещения, а не струя из воздуховода. CO2 тяжелее воздуха: в подвалах и птичниках ставьте датчик ниже, на уровне людей или животных.

3. Питание

У моделей с модулем Modbus питание идёт по кабелю в обе стороны:

Выход VMOD включается в приложении: Configure → Sensors → Modbus Power = OSS VMOD.

4. Первая настройка в OSS Companion

Установите OSS Companion из App Store или Google Play. Любое действие начинается с касания: телефон питает NFC-метку станции своим полем, поэтому держите его вплотную к значку NFC. Длинные действия - настройка и прошивка - дальше идут по Bluetooth, можно отойти на несколько метров.

Действия в приложении: Wake Up - разбудить, Configure - настройки, Update Firmware - прошивка, Reset - перезагрузка, Set Password - пароль NFC.

5. Режимы работы и батарея

Always On - станция всегда на связи: мерит каждые Sampling Time минут и сразу отправляет. Для внешнего питания.

Low-Power - станция спит между замерами и выходит на связь, когда накопит Samples to Aggregate замеров. Пример: замер каждые 15 минут, отправка по 4 замера - связь раз в час. Чем реже связь, тем дольше живёт батарея. Время бодрствования за один сеанс ограничено (Maximum Awake Time).

Обновление прошивки через Azure идёт по частям, одна часть за сеанс связи. В примере выше прошивка из 8 частей загрузится примерно за 8 часов, в режиме Always On с замером раз в 15 минут - примерно за 2 часа.

6. Связь

• Wi-Fi with Cellular Backup. Сбоем Wi-Fi считается недоступная точка доступа, ошибка DHCP, нет передачи данных или обрыв связи с облаком. В Low-Power следующий сеанс пойдёт через сотовую сеть, в Always On станция сразу переходит на сотовую связь на 30 минут, затем снова пробует Wi-Fi.
• Какие сотовые сети нужны. Модем OSS работает в LTE-M, NB-IoT и 2G, а обычного 4G-интернета не использует. В России, СНГ и других странах проверьте, какие из этих сетей есть у операторов на месте установки.
• Wi-Fi на складе. Металлические стеллажи и товар сильно глушат Wi-Fi: проверьте уровень сигнала там, где будет висеть станция.

7. Датчики Modbus

Кабель модуля Modbus - 1 м, шесть проводов:

В Configure выберите Sensor Type и укажите Modbus Device ID - адрес датчика. Официальная прошивка опрашивает один датчик на станцию. Сразу работают датчики Tibbo Bus Probes (температура, влажность, освещённость, протечка, оптовход), датчики почвы JXCT, сероводорода, шума, ультрафиолета, осадков и пыли PM2.5. Часть недорогих датчиков с маркетплейсов - копии JXCT с той же картой регистров, они тоже работают сразу: так мы подключали датчик почвы, купленный на Amazon, без доработки прошивки.

Датчик с другими регистрами добавляют в прошивку: исходники OSS открыты, на Tibbo BASIC это обычно несколько десятков строк. Не хотите разбираться сами - напишите нам, обсудим сборку под проект.

8. Куда отправлять данные

Облако Tibbo. В OSS Companion: Devices → Sign in → «+» → имя станции → поднести телефон → настройки → Save → Reboot. Статус Provisioned - станция в облаке. Данные и графики - в приложении и на my.tibbo.com/oss. Станции объединяются в группы, доступ выдаётся на группу: Owner, Admin, Editor, Viewer и другие роли.

Свой Azure IoT Central. Создайте приложение IoT Central, добавьте устройство, перенесите в OSS Companion ID scope, Device ID и Primary Key. Импортируйте шаблон OSS от Tibbo - панель с графиками появится сама. Тревоги задаются правилами IoT Central: условие по телеметрии и письмо или вебхук.

Alibaba Cloud. Своя прошивка OSS от Tibbo. В Configure появляются поля Server URL, Username, Client ID и Primary Key.

Свой сервер. Прошивка для Alibaba со своим сертификатом и брокер MQTT на вашем сервере. Пошагово, с готовым сервером и проверкой - в рецепте «OSS со своим сервером».

9. Калибровка CO2

Датчик CO2 калибруется на заводе Tibbo. Если показания уехали из-за давления или высоты над морем, его калибруют по свежему воздуху, где CO2 около 400 ppm:

1. Вынесите станцию на улицу, отверстия модуля ничем не закрыты.
2. Подождите от 15 минут до часа и не дышите рядом.
3. OSS Companion → Configure → вкладка Advanced → Special Command: CACO2:400 (с учётом регистра).
4. Save, затем перезагрузите станцию. В событиях появится «команда принята».

Ручная калибровка заменяет заводскую навсегда - не делайте её в помещении или рядом с людьми.

10. Обновление прошивки

• На месте: скачайте файл .tcu из репозитория Tibbo на GitHub (tibbotech/OSS_Apps, папка Release_Files), затем OSS Companion → Update Firmware → Select a File → поднести телефон. Файл идёт по Bluetooth, станция перезагрузится сама. Так же загружается и своя сборка.
• Через Azure IoT Central: по частям, станция продолжает мерить. Не отключайте питание во время записи прошивки: при сбое станцию придётся прошивать на месте.
• Со своим сервером прошивку обновляют на месте, с телефона.

11. Частые проблемы