WisBlock Sensor For LoRaWAN
1.0.0
 |  |  |
|---|
Это новый подход для Wisblock. Он сканирует автобус и сериал I2C, чтобы обнаружить, какие модули Wisblock прикреплены к основанию Wisblock и создают полезную нагрузку Lorawan в Cayenne LPP с данными найденных модулей.
Эта прошивка использует Wisblock API V2
Этот код можно использовать без изменений для
| Комплект/решение | Руководство по настройке |
|---|---|
| Wisblock Kit 1 | Настройка комплекта 1 |
| Wisblock Kit 2 | Настройка комплекта 2 |
| Wisblock Kit 3 | Настройка набор 3 |
| Wisblock Kit 4 | Настройка комплекта 4 |
| RAK Developer Kit | Настройка Dev Kit 2 Настройка Dev Kit 3 Setup Dev Kit 4 |
| Гелийский комплект Mapper | Настройка гелиевой карты |
| Wisblock GNSS Tracker для Лоравана | Настройка GNSS Tracker |
| Модуль | Функция | Используется в комплекте |
|---|---|---|
| RAK4631 | Wisblock Core Module | - |
| RAK5005-O | Base Board Wisblock | - |
| RAK19007 | Base Board Wisblock | - |
| RAK19003 | Wisblock Mini Base Board | - |
| RAK19001 | Wisblock Fullsize Base Board | - |
| RAK1901 | Температура и датчик влажного | Wisblock Kit 1, Rak Developer Kit 2 |
| RAK1902 | Датчик давления барометра Wisblock | Wisblock Kit 1, Rak Developer Kit 2 |
| RAK1903 | Датчик окружающей среды Wisblock | Wisblock Kit 1, Rak Developer Kit 2 |
| RAK1904 | Датчик ускорения Wisblock (используется для решений GNSS) | Wisblock Kit 2 & 3, Wisblock Tracker для Lorawan, Rak Developer Kit 3 |
| RAK1905 | Wisblock 9 DOF Датчик | - |
| RAK1906 | Wisblock Environment Sensor | Wisblock Kit 4, Rak Developer Kit 4 |
| RAK1910 | Wisblock GNSS Sensor | Wisblock Kit 2 & 3, Rak Developer Kit 3 |
| RAK1921 | Wisblock OLED -дисплей | (Отображение статуса) |
| RAK5814 | Wisblock ACC608 модуль шифрования | - |
| RAK12002 | Wisblock RTC модуль | - |
| RAK12003 | Wisblock Fire Sensor | - |
| RAK12004 | Газовый датчик Wisblock MQ2 | - |
| RAK12008 | Wisblock SCT31 CO2 -датчик газового датчика | - |
| RAK12009 | Датчик алкогольного газа Wisblock MQ3 | - |
| RAK12010 | Датчик окружающей среды Wisblock | - |
| RAK12014 | Wisblock Laser TOF датчик | - |
| RAK12019 | Wisblock UV -датчик света | - |
| RAK12025 | Wisblock Gyroscope Sensor | - |
| Rak12023/rak12035 | Датчик влажности и температуры Wisblock | Раствор датчика почвы Wisblock |
| RAK12027 | Датчик землетрясения Висблока | - |
| RAK12032 | Датчик ускорения Wisblock | - |
| RAK12034 | Wisblock 9 DOF Датчик | - |
| RAK12037 | Wisblock CO2 Датчик | - |
| RAK12039 | Датчик вещества частиц Wisblock | - |
| RAK12040 | Wisblock AMG8833 Датчик массива температуры | - |
| RAK12047 | Wisblock Voc Sensor | - |
| RAK12052 | Wisblock MLX90640 32x24 Датчик температуры | - |
| RAK12500 | Wisblock GNSS Sensor | Wisblock Tracker для Лоравана |
| RAK14002 | Wisblock 3 Button Touch Pad | - |
| RAK14003 | Висблок -светодиодный бар дисплей | - |
| RAK14008 | Wisblock Жестный датчик | - |
| RAK15000 | Wisblock eeprom Module | - |
| RAK15001 | Wisblock Flash Module | - |
| RAK14008 | Wisblock Жестный датчик | - |
| RAK16000 | Датчик тока Wisblock DC | - |
Приемопередатчик MCU и LORA входят в режим сна между циклами измерения, чтобы сохранить мощность. Я мог бы измерить ток сна 40 UA всей системы для решения, который позволяет спать. Некоторые решения, такие как GNSS Trackers или датчик VOC RAK12047, которые требуют более длительного времени пробуждения или более частых пробуждений, имеют более высокое энергопотребление.
Кроме того, датчики, такие как газовые датчики MQ, которые используют нагревательный элемент, также будут потреблять больше мощности.
... чтобы быть обновленным, проверьте Platfortio.ini для списка всех используемых библиотек
Проект был разработан с использованием платформы IO. Но для пользователей, которые все еще придерживаются Arduino IDE, совместимая копия Arduino IDE источников находится в папке Arduinoide. Код не компилируется на Arduino IDE ATM.
Полный проект для PIO находится в папке Platformio.
При использовании Platformio все библиотеки перечислены в platformio.ini и автоматически устанавливаются при составлении проекта. При использовании Arduino IDE все библиотеки должны быть установлены вручную, используя диспетчер библиотеки Arduino.
Скомпилируйте прошивку и проклейте ее на Wisblock с установленными всеми необходимыми модулями.
Подключите USB, чтобы настроить учетные данные LPWAN. Используйте DEVEUI, напечатанный на RAK4631, используйте AppeUi и Appkey с вашего сервера LPWAN. Не активируйте автоматическое соединение. Поскольку уровни датчика погоды не меняются очень быстро, может быть достаточно, чтобы установить частоту отправки на каждые 10 минут. Частота отправки установлена за секунды, поэтому значение будет 10 * 60 ==> 600
Пример в командах:
AT+NWM=1
AT+NJM=1
AT+BAND=10
AT+DEVEUI=1000000000000001
AT+APPEUI=AB00AB00AB00AB00
AT+APPKEY=AB00AB00AB00AB00AB00AB00AB00AB00
AT+SENDINT=600
| Командование | Объяснение |
|---|---|
| AT+NWM = 1 | Установите узел в режим Lorawan |
| AT+NJM = 1 | Установить метод соединения сети в OTAA |
| AT+Band = 10 | Установите регион LPWAN (здесь AS923-3) см. В руководстве по команде |
| AT+DEVEUI = 100000000000000001 | Установите устройство EUI, лучше всего использовать DeVeui, который напечатан на этикетке вашего модуля Wisblock Core Module |
| At+appeui = ab00ab00ab00ab00 | Установите приложение EUI, необходимое на сервере Lorawan |
| At+appkey = ab00ab00ab00ab00ab00ab00ab00ab00 | Установите клавишу приложения, используемый для шифрования пакета данных во время сетевого соединения |
| At+sendint = 600 | Установите интервал. Узел датчика отправит пакеты данных. 600 == 10 x 60 секунд == 10 минут |
Руководство для всех команд можно найти здесь: At-Commands.mdAT?
Используйте набор инструментов Wisblock
Данные пакета сделаны совместимыми с расширенной кодировкой LPP Cayenne от Electronccats/Cayennelpp
Содержание пакета зависит от модулей, установленных на базовой плате Wisblock:
| Данные | Канал # | Идентификатор канала | Длина | Комментарий | Требуемый модуль | Декодированное имя поля |
|---|---|---|---|---|---|---|
| Значение батареи | 1 | 116 | 2 байта | 0,01 В без знака MSB | RAK4631 | voltage_1 |
| Влажность | 2 | 104 | 1 байт | в %rh | RAK1901 | влажность_2 |
| Температура | 3 | 103 | 2 байта | в ° C. | RAK1901 | Температура_3 |
| Барометрическое давление | 4 | 115 | 2 байта | в HPA (MBAR) | RAK1902 | барометр_4 |
| Освещение | 5 | 101 | 2 байта | 1 Люкс без подписи | RAK1903 | Освещение_5 |
| Влажность 2 | 6 | 104 | 1 байт | в %rh | RAK1906 | влажность_6 |
| Температура 2 | 7 | 103 | 2 байта | в ° C. | RAK1906 | Температура_7 |
| Барометрическое давление 2 | 8 | 115 | 2 байта | в HPA (MBAR) | RAK1906 | барометр_8 |
| Газостойкость 2 | 9 | 2 | 2 байта | 0,01 подписано (kohm) | RAK1906 | аналог_9 |
| GNSS стоят. разрешение | 10 | 136 | 9 байтов | 3 байт LON/LAT 0,0001 °, 3 байта ALT 0,01 метра | RAK1910, RAK12500 | GPS_10 |
| Улучшенное разрешение GNSS | 10 | 137 | 11 байтов | 4 байт LON/LAT 0,000001 °, 3 байта ALT 0,01 метра | RAK1910, RAK12500 | GPS_10 |
| Температура почвы | 11 | 103 | 2 байта | в ° C. | Rak12023/rak12035 | Температура_11 |
| Влажность почвы | 12 | 104 | 1 байт | в %rh | Rak12023/rak12035 | влажность_12 |
| Влажность почвы сырой | 13 | 2 | 2 байта | 0,01 подписано | Rak12023/rak12035 | analog_in_13 |
| Данные почвы действительны | 14 | 102 | 1 байт | буль | Rak12023/rak12035 | Присутствие_14 |
| Освещение 2 | 15 | 101 | 2 байта | 1 Люкс без подписи | RAK12010 | Освещение_15 |
| Вокал | 16 | 138 | 2 байта | Индекс ЛОС | RAK12047 | voc_16 |
| MQ2 Газ | 17 | 2 | 2 байта | 0,01 подписано | RAK12004 | analog_in_17 |
| Процент газа MQ2 | 18 | 120 | 1 байт | 1-100% без знака | RAK12004 | процент_18 |
| MG812 Газ | 19 | 2 | 2 байта | 0,01 подписано | RAK12008 | analog_in_19 |
| MG812 Процент газа | 20 | 120 | 1 байт | 1-100% без знака | RAK12008 | процент_20 |
| MQ3 Алкогольный газ | 21 | 2 | 2 байта | 0,01 подписано | RAK12009 | analog_in_21 |
| MQ3 Алкогольный газ Perc. | 22 | 120 | 1 байт | 1-100% без знака | RAK12009 | процент_22 |
| TOF расстояние | 23 | 2 | 2 байта | 0,01 подписано | RAK12014 | analog_in_23 |
| Данные TOF верны | 24 | 102 | 1 байт | буль | RAK12014 | Присутствие_24 |
| Гироскоп вызван | 25 | 134 | 6 байтов | 2 байта на ось, 0,01 °/с | RAK12025 | Гирометр_25 |
| Гест обнаружен | 26 | 0 | 1 байт | 1 байт с удостоверением личности жеста | RAK14008 | Digital_in_26 |
| LTR390 UVI Значение | 27 | 2 | 2 байта | 0,01 подписано | RAK12019 | analog_in_27 |
| LTR390 UVS Значение | 28 | 101 | 2 байта | 1 Люкс без подписи | RAK12019 | Освещение_28 |
| INA219 ток | 29 | 2 | 2 байта | 0,01 подписано | RAK16000 | аналог_29 |
| INA219 напряжение | 30 | 2 | 2 байта | 0,01 подписано | RAK16000 | аналог_30 |
| INA219 Power | 31 | 2 | 2 байта | 0,01 подписано | RAK16000 | аналог_31 |
| Такпад ушел | 32 | 102 | 1 байт | буль | RAK14002 | Присутствие_32 |
| Такпад середина | 33 | 102 | 1 байт | буль | RAK14002 | Присутствие_33 |
| Touchpad Right | 34 | 102 | 1 байт | буль | RAK14002 | Присутствие_34 |
| Концентрация CO2 SCD30 | 35 | 125 | 2 байта | 1 ч / млн без знака | RAK12037 | концентрация_35 |
| SCD30 температура | 36 | 103 | 2 байта | в ° C. | RAK12037 | Температура_36 |
| SCD30 влажность | 37 | 104 | 1 байт | в %rh | RAK12037 | влажность_37 |
| MLX90632 Temp | 38 | 103 | 2 байта | в ° C. | RAK12003 | Температура_38 |
| MLX90632 Объект Temp | 39 | 103 | 2 байта | в ° C. | RAK12003 | Температура_39 |
| PM 1.0 Значение | 40 | 103 | 2 байта | в UG/M3 | RAK12003 | voc_40 |
| PM 2.5 Значение | 41 | 103 | 2 байта | в UG/M3 | RAK12003 | voc_41 |
| PM 10 Значение | 42 | 103 | 2 байта | в UG/M3 | RAK12003 | voc_42 |
| Землетрясение | 43 | 102 | 1 байт | буль | RAK12027 | Присутствие_43 |
| Землетрясение SI Значение | 44 | 2 | 2 байта | аналог 10 * м/с | RAK12027 | аналог_44 |
| Землетрясение PGA | 45 | 2 | 2 байта | аналог 10 * м/с2 | RAK12027 | аналог_45 |
| Землетрясение откладывающее предупреждение | 46 | 102 | 1 байт | буль | RAK12027 | Присутствие_46 |
| Lpp_channel_eq_collapse | 47 | 102 | 1 байт | буль | RAK12027 | Присутствие_47 |
| Статус переключения | 48 | 102 | 1 байт | буль | RAK13011 | Присутствие_48 |
| Sensorhub Wind Speed | 49 | 190 | 2 байта | 0,01 м/с | Sensorhub RK900-09 | wind_speed_49 |
| Сенсоровое направление ветра | 50 | 191 | 2 байта | 1º | Sensorhub RK900-09 | wind_direction_50 |
| Аудио Уровень | 49 |
Идентификаторы канала в курсе являются расширенным форматом и не поддерживаются стандартными декодерами данных Cayenne LPP.
Пример декодеров для ttn, chirpstack, gelium и datacake можно найти в папке Rakwireless_standardized_payload Repo
Скомпилированные файлы расположены в папке ./Generated. Каждая успешная скомпилированная версия названа как
WisBlock_SENS_Vx.y.z_YYYY.MM.dd.hh.mm.ss
XYZ - номер версии. Номер версии настраивается в файле ./platformio.ini.
Yyyy.mm.dd.hh.mm.ss является временной меткой компиляции.
Сгенерированный файл .zip можно также использовать для обновления устройства на BLE с помощью любого набора инструментов Wisblock
При использовании Platformio сгенерируется файл UF2 для RAK4631. Вы можете заставить RAK4631 в режим загрузчика, двойной кнопку сброса. Будет установлен новый USB -диск. Потяните файл UF2 в новый диск, чтобы прошить устройство.
Вывод отладки можно управлять определением в platformio.ini
LIB_DEBUG CONTROLS DENAKUG
API_DEBUG CONTROLS DENAKUG
MY_DEBUG CONTROLS DENAKUG Вывод самого приложения
CFG_DEBUG управляет выходом отладки NRF52 BSP. Рекомендуется держать это
[env:wiscore_rak4631]
platform = nordicnrf52
board = wiscore_rak4631
framework = arduino
build_flags =
; -DCFG_DEBUG=2
- DSW_VERSION_1 =1 ; major version increase on API change / not backwards compatible
- DSW_VERSION_2 =0 ; minor version increase on API change / backward compatible
- DSW_VERSION_3 =0 ; patch version increase on bugfix, no affect on API
- DLIB_DEBUG =0 ; 0 Disable LoRaWAN debug output
- DAPI_DEBUG =0 ; 0 Disable WisBlock API debug output
- DMY_DEBUG =0 ; 0 Disable application debug output
- DNO_BLE_LED =1 ; 1 Disable blue LED as BLE notificator
lib_deps =
beegee-tokyo/SX126x-Arduino
beegee-tokyo/WisBlock-API-V2
sparkfun/SparkFun SHTC3 Humidity and Temperature Sensor Library
adafruit/Adafruit LPS2X
closedcube/ClosedCube OPT3001
sabas1080/CayenneLPP
extra_scripts = pre:rename.pyЭто руководство можно использовать для Wisblock Kit 1 и Rak Developer Kit 2
Установите модули в любом соответствующем слоте, следуя руководствам быстрого начала в центре документации Rakwireless
Настройка устройства с помощью командного интерфейса AT или приложения BLE
Это руководство можно использовать для Wisblock Kit 2 , Wisblock Kit 3 , Wisblock GNSS Tracker для Lorawan и Rak Developer Kit 3
Модуль RAK1904 должен быть установлен в
Слот C of Rak5005-O, RAK19007, RAK19003 или RAK19001
При использовании RAK1910 он должен быть установлен в
Слот a of rak5005-o
Любой соответствующий слот RAK19007 или RAK19001
При использовании RAK12500 он может быть установлен в любом подходящем слоте базовых плат.
RAK1906 может быть установлен в любом подходящем слоте базовой платы.
Для руководств по установке, следуя руководствам быстрого начала в Центре документации Rakwireless
Настройка устройства с помощью командного интерфейса AT или приложения BLE
RAK11700 GNSS Tracker для Lorawan - это режим запуска по умолчанию для этой настройки.
При создании комплекта Helium Mapper режим должен быть изменен с помощью ниже команды:
Решение можно установить на 3 различных рабочих режима, используя команду AT AT+GNSS :
| Командование | Входной параметр | Возвращаемое значение | Вернуть код |
|---|---|---|---|
| AT+GNSS? | - | Get/Set the GNSS precision and format 0 = 4 digit, 1 = 6 digit, 2 = Helium Mapper | OK |
| AT+GNSS =? | - | 0 или 1 или 2 | OK |
At+gnss = <Input Parameter> | 1 или 2 или 3 | - | OK или AT_PARAM_ERROR |
В стандартном формате Cayenne LPP используется только 4 цифра для точности местоположения. Этот формат местоположения по умолчанию автоматически поддерживается большинством серверов Lorawan и платформами визуализации, такими как MyDevices .
Это по умолчанию и установлено с командой AT AT+GNSS=0 .
Установка этой опции, данные по -прежнему отправляются в формате Cayenne LPP, но используют пользовательский идентификатор данных и 6 цифр для более высокой широты и разрешения долготы. Чтобы расшифровать этот формат, требуется индивидуальный энкодер данных. Данные кодеры для TTN, ChiRPStack и DataCake можно найти в папке Data Decoder.
Увеличенное разрешение местоположения устанавливается с командой AT AT+GNSS=1 .
Эта опция отправляет данные в формате Mapper Helium, как объяснено в Make A Helium Mapper с Wisblock.
Декодеры пакетов для этого формата представлены в вышеуказанной статье.
Функциональность гелиевой карты установлена с командой AT AT+GNSS=2 .
Это руководство можно использовать для Wisblock Kit 4 и Rak Developer Kit 4
Установите модули в любом соответствующем слоте, следуя руководствам быстрого начала в центре документации Rakwireless
Настройка устройства с помощью командного интерфейса AT или приложения BLE
