WisBlock Sensor For LoRaWAN
1.0.0
 |  |  |
|---|
هذا هو نهج جديد لـ Wisblock. يقوم بمسح حافلة I2C والسلسلة لاكتشاف وحدات Wisblock متصلة بقاعدة Wisblock وإنشاء حمولة Lorawan في Cayenne LPP مع بيانات الوحدات النمطية التي تم العثور عليها.
يستخدم هذا البرنامج الثابت Wisblock API V2
يمكن استخدام هذا الرمز بدون تغييرات
| مجموعة/حل | دليل الإعداد |
|---|---|
| مجموعة Wisblock 1 | مجموعة الإعداد 1 |
| مجموعة Wisblock 2 | مجموعة الإعداد 2 |
| مجموعة Wisblock 3 | مجموعة الإعداد 3 |
| مجموعة Wisblock 4 | مجموعة الإعداد 4 |
| راك المطورين طقم | Setup Dev Kit 2 Setup Dev Kit 3 Setup Dev Kit 4 |
| مجموعة خريطة الهيليوم | الإعداد هيليوم Mapper |
| Wisblock GNSS Tracker لـ Lorawan | إعداد GNSS Tracker |
| الوحدة النمطية | وظيفة | تستخدم في مجموعة |
|---|---|---|
| RAK4631 | الوحدة الأساسية WISBLOCK | - |
| RAK5005-O | لوحة قاعدة Wisblock | - |
| RAK19007 | لوحة قاعدة Wisblock | - |
| RAK19003 | لوحة قاعدة Wisblock Mini | - |
| RAK19001 | Wisblock Fullsize Base Board | - |
| RAK1901 | درجة حرارة Wisblock ومستشعر الترطيب | Wisblock Kit 1 ، Rak Developer Kit 2 |
| RAK1902 | مستشعر ضغط Barometer 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 for Lorawan ، Rak Developer Kit 3 |
| RAK1905 | مستشعر WISBlock 9 DOF | - |
| RAK1906 | مستشعر البيئة Wisblock | Wisblock Kit 4 ، Rak Developer Kit 4 |
| RAK1910 | مستشعر WISBlock GNSS | Wisblock Kit 2 و 3 ، Rak Developer Kit 3 |
| RAK1921 | WISBLOCK OLED شاشة | (عرض الحالة) |
| RAK5814 | وحدة تشفير Wisblock ACC608 | - |
| RAK12002 | وحدة WISBLOCK RTC | - |
| RAK12003 | مستشعر FIR WISBLOCK | - |
| RAK12004 | مستشعر غاز Wisblock MQ2 | - |
| RAK12008 | WISBLOCK SCT31 CO2 Sensor | - |
| RAK12009 | مستشعر غاز الكحول MQ3 WISBLOCK | - |
| RAK12010 | مستشعر الضوء المحيط Wisblock | - |
| RAK12014 | Wisblock Laser Tof Sensor | - |
| RAK12019 | مستشعر ضوء الأشعة فوق البنفسجية Wisblock | - |
| RAK12025 | مستشعر جيروسكوب Wisblock | - |
| RAK12023/RAK12035 | رطوبة التربة Wisblock ومستشعر درجة الحرارة | محلول مستشعر التربة Wisblock |
| RAK12027 | مستشعر زلزال Wisblock | - |
| RAK12032 | مستشعر تسريع Wisblock | - |
| RAK12034 | مستشعر WISBlock 9 DOF | - |
| RAK12037 | مستشعر Wisblock CO2 | - |
| Rak12039 | مستشعر المادة الجسيمات Wisblock | - |
| RAK12040 | Wisblock AMG8833 مستشعر صفيف درجة الحرارة | - |
| RAK12047 | مستشعر VOC Wisblock | - |
| RAK12052 | WISBlock MLX90640 32x24 مستشعر صفيف درجة الحرارة | - |
| RAK12500 | مستشعر WISBlock GNSS | تتبع Wisblock لـ Lorawan |
| RAK14002 | Wisblock 3 زر اللمس وسادة اللمس | - |
| RAK14003 | عرض شريط LED WISBLOCK | - |
| RAK14008 | مستشعر لفتة Wisblock | - |
| RAK15000 | WISBLOCK EEPROM الوحدة النمطية | - |
| RAK15001 | وحدة فلاش Wisblock | - |
| RAK14008 | مستشعر لفتة Wisblock | - |
| RAK16000 | مستشعر Wisblock DC الحالي | - |
يذهب جهاز الإرسال والاستقبال MCU و Lora إلى وضع السكون بين دورات القياس لتوفير الطاقة. يمكنني قياس تيار النوم 40UA من النظام بأكمله لحل يمكّن النوم. بعض الحلول ، مثل أجهزة تتبع GNSS أو مستشعر VOC RAK12047 ، والتي تتطلب أوقاتًا أطول أو استيقاظًا متكررًا ، لها استهلاك طاقة أعلى.
بالإضافة إلى ذلك ، فإن أجهزة استشعار غاز MQ التي تستخدم عنصر التدفئة سوف تستهلك المزيد من الطاقة أيضًا.
... ليتم تحديثها ، تحقق من platformio.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) انظر في دليل القيادة |
| في+deveui = 1000000000000001 | اضبط الجهاز EUI ، الأفضل لاستخدام deveui المطبوعة على ملصق وحدة Wisblock الأساسية الخاصة بك |
| AT+APPEUI = AB00AB00AB00AB00 | قم بتعيين التطبيق EUI ، المطلوب على خادم Lorawan |
| AT+AppKey = AB00AB00AB00AB00AB00AB00AB00AB00 | اضبط مفتاح التطبيق ، المستخدم لتشفير حزمة البيانات أثناء انضمام الشبكة |
| AT+SendInt = 600 | اضبط الفاصل الزمني ، سترسل عقدة المستشعر حزم البيانات. 600 == 10 × 60 ثانية == 10 دقائق |
يمكن العثور على دليل الجميع في الأوامر هنا: at-commands.mdAT?
استخدم صندوق أدوات Wisblock
تصنع بيانات الحزمة متوافقة مع تشفير Cayenne LPP الممتد من ElectronicCats/Cayennelpp
يعتمد محتوى الحزمة على الوحدات النمطية المثبتة على لوحة قاعدة Wisblock:
| بيانات | القناة # | معرف القناة | طول | تعليق | وحدة مطلوبة | اسم الحقل فك التشفير |
|---|---|---|---|---|---|---|
| قيمة البطارية | 1 | 116 | 2 بايت | 0.01 V MSB غير موقعة | RAK4631 | Voltage_1 |
| رطوبة | 2 | 104 | 1 بايت | في ٪ rh | RAK1901 | الرطوبة |
| درجة حرارة | 3 | 103 | 2 بايت | في درجة مئوية | RAK1901 | درجة حرارة_3 |
| الضغط البارومتري | 4 | 115 | 2 بايت | في HPA (MBAR) | RAK1902 | barometer_4 |
| الإضاءة | 5 | 101 | 2 بايت | 1 لوكس غير موقعة | RAK1903 | إضاءة_5 |
| الرطوبة 2 | 6 | 104 | 1 بايت | في ٪ rh | RAK1906 | الرطوبة |
| درجة الحرارة 2 | 7 | 103 | 2 بايت | في درجة مئوية | RAK1906 | درجة الحرارة |
| الضغط البارومتري 2 | 8 | 115 | 2 بايت | في HPA (MBAR) | RAK1906 | Barometer_8 |
| مقاومة الغاز 2 | 9 | 2 | 2 بايت | 0.01 موقعة (KOHM) | RAK1906 | analog_9 |
| GNSS يقف. دقة | 10 | 136 | 9 بايت | 3 بايت لون/لات 0.0001 درجة ، 3 بايت بديل 0.01 متر | Rak1910 ، Rak12500 | GPS_10 |
| GNSS الدقة المحسنة | 10 | 137 | 11 بايت | 4 بايت LON/LAT 0.000001 ° ، 3 بايت بديل 0.01 متر | Rak1910 ، Rak12500 | GPS_10 |
| درجة حرارة التربة | 11 | 103 | 2 بايت | في درجة مئوية | RAK12023/RAK12035 | درجة حرارة_11 |
| رطوبة التربة | 12 | 104 | 1 بايت | في ٪ rh | RAK12023/RAK12035 | الرطوبة |
| رطوبة التربة الخام | 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 | النسبة المئوية |
| MG812 الغاز | 19 | 2 | 2 بايت | 0.01 وقعت | RAK12008 | analog_in_19 |
| MG812 نسبة الغاز | 20 | 120 | 1 بايت | 1-100 ٪ غير موقعة | RAK12008 | النسبة المئوية |
| MQ3 غاز الكحول | 21 | 2 | 2 بايت | 0.01 وقعت | RAK12009 | analog_in_21 |
| MQ3 الكحول GAS PERC. | 22 | 120 | 1 بايت | 1-100 ٪ غير موقعة | RAK12009 | النسبة المئوية |
| المسافة | 23 | 2 | 2 بايت | 0.01 وقعت | RAK12014 | analog_in_23 |
| TOF البيانات صالحة | 24 | 102 | 1 بايت | بول | RAK12014 | التواجد_24 |
| أدى الدوران | 25 | 134 | 6 بايت | 2 بايت لكل محور ، 0.01 درجة/ثانية | RAK12025 | Gyrometer_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 | analog_29 |
| INA219 الجهد | 30 | 2 | 2 بايت | 0.01 وقعت | RAK16000 | analog_30 |
| INA219 السلطة | 31 | 2 | 2 بايت | 0.01 وقعت | RAK16000 | analog_31 |
| لوحة اللمس غادر | 32 | 102 | 1 بايت | بول | RAK14002 | التواجد _32 |
| لوحة اللمس الوسطى | 33 | 102 | 1 بايت | بول | RAK14002 | التواجد_33 |
| لوحة اللمس الحق | 34 | 102 | 1 بايت | بول | RAK14002 | التواجد _34 |
| SCD30 تركيز ثاني أكسيد الكربون | 35 | 125 | 2 بايت | 1 جزء في المليون غير موقعة | RAK12037 | تركيز_35 |
| درجة حرارة SCD30 | 36 | 103 | 2 بايت | في درجة مئوية | RAK12037 | درجة الحرارة_36 |
| SCD30 الرطوبة | 37 | 104 | 1 بايت | في ٪ rh | RAK12037 | الرطوبة _37 |
| MLX90632 استشعار درجة الحرارة | 38 | 103 | 2 بايت | في درجة مئوية | RAK12003 | درجة الحرارة_38 |
| MLX90632 كائن درجة الحرارة | 39 | 103 | 2 بايت | في درجة مئوية | 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 | analog_44 |
| زلزال PGA قيمة | 45 | 2 | 2 بايت | التناظرية 10 * م/S2 | RAK12027 | analog_45 |
| تنبيه زلزال إغلاق | 46 | 102 | 1 بايت | بول | RAK12027 | التواجد _46 |
| lpp_channel_eq_collapse | 47 | 102 | 1 بايت | بول | RAK12027 | التواجد _47 |
| حالة التبديل | 48 | 102 | 1 بايت | بول | Rak13011 | التواجد_48 |
| سرعة الرياح المستشعر | 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 و Helium و Datacake في المجلد Rakwireless_Standardized_Payload Repo
توجد الملفات المترجمة في المجلد. تم تسمية كل نسخة تجميع ناجحة باسم
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 في إخراج تصحيح مكتبة SX126x-arduino lorawan
API_Debug Controls تصحيح تصحيح ناتج مكتبة Wisblock-API
My_debug يتحكم في إخراج التطبيق من التطبيق نفسه
يتحكم 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 من RAK5005-O ، RAK19007 ، RAK19003 أو RAK19001
في حالة استخدام RAK1910 ، يجب تثبيته في
الفتحة A من RAK5005-O
أي فتحة مطابقة لـ Rak19007 أو Rak19001
إذا كنت تستخدم RAK12500 ، فيمكن تثبيتها في أي فتحة مطابقة للوحات الأساسية.
يمكن تثبيت RAK1906 في أي فتحة مطابقة للوحة الأساسية.
لأدلة التثبيت ، بعد أدلة البداية السريعة في مركز الوثائق Rakwireless
قم بإعداد الجهاز باستخدام واجهة AT أو تطبيق BLE
Rak11700 GNSS Tracker لـ Lorawan هو وضع البدء الافتراضي لهذا الإعداد.
إذا كان بناء مجموعة Mapper Helium ، يجب تغيير الوضع مع الأمر أدناه في الأمر:
يمكن ضبط الحل على 3 أوضاع عمل مختلفة باستخدام الأمر AT AT+GNSS :
| يأمر | معلمة الإدخال | قيمة الإرجاع | رمز الإرجاع |
|---|---|---|---|
| في+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 في مجلد وحدة فك ترميز البيانات المخصصة.
يتم تعيين دقة الموقع المحسّنة مع الأمر AT AT+GNSS=1 .
يرسل هذا الخيار البيانات بتنسيق Mapper Helium ، كما هو موضح في Make a Helium Mapper مع Wisblock.
يتم توفير وحدة فك ترميز الحزم لهذا التنسيق في المقالة أعلاه.
يتم تعيين وظيفة Mapper هيليوم مع الأمر AT AT+GNSS=2 .
يمكن استخدام هذا الدليل لـ Wisblock Kit 4 و Rak Developer Kit 4
قم بتثبيت الوحدات في أي فتحة مطابقة ، بعد أدلة البداية السريعة في مركز الوثائق Rakwireless
قم بإعداد الجهاز باستخدام واجهة AT أو تطبيق BLE
