WisBlock Sensor For LoRaWAN
1.0.0
 |  |  |
|---|
Ini adalah pendekatan baru untuk Wisblock. Ini memindai bus I2C dan serial untuk mendeteksi modul Wisblock mana yang melekat pada pangkalan Wisblock dan menciptakan muatan Lorawan di LPP Cayenne dengan data modul yang ditemukan.
Firmware ini menggunakan WisBlock API V2
Kode ini dapat digunakan tanpa perubahan untuk
| Kit/solusi | Panduan Pengaturan |
|---|---|
| Wisblock Kit 1 | Pengaturan Kit 1 |
| Wisblock Kit 2 | Kit Pengaturan 2 |
| Wisblock Kit 3 | Kit Pengaturan 3 |
| Wisblock Kit 4 | Pengaturan Kit 4 |
| Kit Pengembang RAK | Pengaturan Dev Kit 2 Setup Dev Kit 3 Setup Dev Kit 4 |
| Kit Helium Mapper | Siapkan mapper helium |
| Wisblock GNSS Tracker untuk Lorawan | Siapkan pelacak GNSS |
| Modul | Fungsi | Digunakan dalam kit |
|---|---|---|
| RAK4631 | Modul inti Wisblock | - |
| Rak5005-O | Papan Pangkalan Wisblock | - |
| RAK19007 | Papan Pangkalan Wisblock | - |
| RAK19003 | Papan basis mini Wisblock | - |
| RAK19001 | Papan basis ukuran penuh Wisblock | - |
| RAK1901 | Suhu wisblock dan sensor lembab | Wisblock Kit 1, RAK Developer Kit 2 |
| RAK1902 | Sensor tekanan barometer wisblock | Wisblock Kit 1, RAK Developer Kit 2 |
| RAK1903 | Sensor cahaya ambient wisblock | Wisblock Kit 1, RAK Developer Kit 2 |
| RAK1904 | Sensor Akselerasi Wisblock (digunakan untuk solusi GNSS) | Wisblock Kit 2 & 3, pelacak Wisblock untuk Lorawan, RAK Developer Kit 3 |
| RAK1905 | Wisblock 9 dof sensor | - |
| RAK1906 | Sensor Lingkungan Wisblock | Wisblock Kit 4, RAK Developer Kit 4 |
| RAK1910 | Sensor Wisblock GNSS | Wisblock Kit 2 & 3, RAK Developer Kit 3 |
| RAK1921 | Tampilan wisblock oled | (Tampilan Status) |
| RAK5814 | Modul Enkripsi Wisblock ACC608 | - |
| RAK12002 | Modul RTC Wisblock | - |
| RAK12003 | Sensor Wisblock Fir | - |
| RAK12004 | Sensor gas Wisblock MQ2 | - |
| RAK12008 | Wisblock SCT31 CO2 Sensor Gas | - |
| RAK12009 | Sensor gas alkohol MQ3 Wisblock | - |
| RAK12010 | Sensor cahaya ambient wisblock | - |
| RAK12014 | Wisblock Laser ToF Sensor | - |
| RAK12019 | Wisblock UV Light Sensor | - |
| RAK12025 | Sensor giroskop Wisblock | - |
| RAK12023/RAK12035 | Sensor kelembaban dan suhu tanah Wisblock | Larutan sensor tanah wisblock |
| RAK12027 | Sensor gempa bumi Wisblock | - |
| RAK12032 | Sensor Akselerasi Wisblock | - |
| RAK12034 | Wisblock 9 dof sensor | - |
| RAK12037 | Sensor CO2 Wisblock | - |
| RAK12039 | Sensor materi partikel wisblock | - |
| RAK12040 | Wisblock AMG8833 Sensor Array Suhu | - |
| RAK12047 | Sensor VOC Wisblock | - |
| RAK12052 | Wisblock MLX90640 32x24 Sensor Array Suhu | - |
| RAK12500 | Sensor Wisblock GNSS | Pelacak wisblock untuk lorawan |
| RAK14002 | Wisblock 3 tombol sentuh tombol | - |
| RAK14003 | Tampilan bar led wisblock | - |
| RAK14008 | Sensor Gerakan Wisblock | - |
| RAK15000 | Modul Eeprom Wisblock | - |
| RAK15001 | Modul Flash Wisblock | - |
| RAK14008 | Sensor Gerakan Wisblock | - |
| RAK16000 | Sensor arus Wisblock DC | - |
Transceiver MCU dan Lora masuk ke mode tidur antara siklus pengukuran untuk menghemat daya. Saya bisa mengukur arus tidur 40UA dari seluruh sistem untuk larutan yang memungkinkan tidur. Beberapa solusi, seperti pelacak GNSS atau sensor VOC RAK12047, yang membutuhkan waktu bangun yang lebih lama atau lebih sering bangun, memiliki konsumsi daya yang lebih tinggi.
Selain itu, sensor seperti sensor gas MQ yang menggunakan elemen pemanas akan mengkonsumsi lebih banyak daya juga.
... untuk diperbarui, periksa platformio.ini untuk daftar semua perpustakaan yang digunakan
Proyek ini dikembangkan menggunakan platform IO. Tetapi bagi pengguna yang masih menempel pada Arduino IDE, salinan Sumber Arduino IDE yang kompatibel ada di folder Arduinoide. Kode tidak dikompilasi pada ATM ATM ARDUINO.
Proyek lengkap untuk PIO ada di folder PlatformIO.
Saat menggunakan PlatformIO, semua perpustakaan tercantum di platformio.ini dan secara otomatis diinstal saat proyek dikompilasi. Saat menggunakan Arduino IDE, semua perpustakaan perlu diinstal secara manual menggunakan Arduino Library Manager.
Kompilasi firmware dan memalsukannya pada WisBlock dengan semua modul yang diperlukan yang diinstal.
Terhubung melalui USB untuk mengatur kredensial LPWAN. Gunakan Deveui yang dicetak pada RAK4631, gunakan Appeui dan Appley dari server LPWAN Anda. Jangan mengaktifkan gabungan otomatis. Karena tingkat sensor cuaca tidak berubah sangat cepat, mungkin cukup untuk mengatur frekuensi kirim setiap 10 menit. Frekuensi Kirim diatur dalam hitungan detik, jadi nilainya 10 * 60 ==> 600
Contoh di perintah:
AT+NWM=1
AT+NJM=1
AT+BAND=10
AT+DEVEUI=1000000000000001
AT+APPEUI=AB00AB00AB00AB00
AT+APPKEY=AB00AB00AB00AB00AB00AB00AB00AB00
AT+SENDINT=600
| Memerintah | Penjelasan |
|---|---|
| AT+NWM = 1 | Atur node ke mode Lorawan |
| AT+NJM = 1 | Setel metode gabungan jaringan ke OTAA |
| Di+band = 10 | Atur wilayah LPWAN (di sini AS923-3) Lihat di Manual Komando |
| Di+deveui = 1000000000000001 | Atur perangkat EUI, sebaiknya gunakan deveui yang dicetak pada label modul inti wisblock Anda |
| AT+APPEUI = AB00AB00AB00AB00 | Atur aplikasi EUI, diperlukan di server Lorawan |
| Di+appkey = AB00AB00AB00AB00AB00AB00AB00AB00 | Atur tombol Aplikasi, yang digunakan untuk mengenkripsi paket data selama Jaringan Jaringan |
| AT+SendInt = 600 | Atur interval simpul sensor akan mengirim paket data. 600 == 10 x 60 detik == 10 menit |
Manual untuk semua perintah dapat ditemukan di sini: at-commands.mdAT?
Gunakan kotak alat wisblock
Data paket dibuat kompatibel dengan pengkodean LPP Cayenne yang diperluas dari Electroniccats/Cayennelpp
Konten paket tergantung pada modul yang dipasang pada papan dasar Wisblock:
| Data | Saluran # | ID saluran | Panjang | Komentar | Modul yang diperlukan | Nama Lapangan Decoded |
|---|---|---|---|---|---|---|
| Nilai baterai | 1 | 116 | 2 byte | 0,01 V MSB yang tidak ditandatangani | RAK4631 | voltage_1 |
| Kelembaban | 2 | 104 | 1 byte | Dalam %RH | RAK1901 | kelembaban_2 |
| Suhu | 3 | 103 | 2 byte | dalam ° C. | RAK1901 | suhu_3 |
| Tekanan barometrik | 4 | 115 | 2 byte | di HPA (mbar) | RAK1902 | Barometer_4 |
| Illuminance | 5 | 101 | 2 byte | 1 lux tidak ditandatangani | RAK1903 | Illuminance_5 |
| Kelembaban 2 | 6 | 104 | 1 byte | Dalam %RH | RAK1906 | kelembaban_6 |
| Suhu 2 | 7 | 103 | 2 byte | dalam ° C. | RAK1906 | suhu_7 |
| Tekanan barometrik 2 | 8 | 115 | 2 byte | di HPA (mbar) | RAK1906 | Barometer_8 |
| Resistensi gas 2 | 9 | 2 | 2 byte | 0,01 ditandatangani (kohm) | RAK1906 | analog_9 |
| Stand GNSS. resolusi | 10 | 136 | 9 byte | 3 byte lon/lat 0,0001 °, 3 byte alt 0,01 meter | RAK1910, RAK12500 | GPS_10 |
| GNSS meningkatkan resolusi | 10 | 137 | 11 byte | 4 byte lon/lat 0,000001 °, 3 byte alt 0,01 meter | RAK1910, RAK12500 | GPS_10 |
| Suhu tanah | 11 | 103 | 2 byte | dalam ° C. | RAK12023/RAK12035 | suhu_11 |
| Kelembaban tanah | 12 | 104 | 1 byte | Dalam %RH | RAK12023/RAK12035 | kelembaban_12 |
| Kelembaban tanah mentah | 13 | 2 | 2 byte | 0,01 ditandatangani | RAK12023/RAK12035 | analog_in_13 |
| Data tanah valid | 14 | 102 | 1 byte | bool | RAK12023/RAK12035 | kehadiran_14 |
| Illuminance 2 | 15 | 101 | 2 byte | 1 lux tidak ditandatangani | RAK12010 | Illuminance_15 |
| VOC | 16 | 138 | 2 byte | Indeks VOC | RAK12047 | voc_16 |
| Gas MQ2 | 17 | 2 | 2 byte | 0,01 ditandatangani | RAK12004 | analog_in_17 |
| Persentase gas MQ2 | 18 | 120 | 1 byte | 1-100% tidak ditandatangani | RAK12004 | Persentase_18 |
| Gas MG812 | 19 | 2 | 2 byte | 0,01 ditandatangani | RAK12008 | analog_in_19 |
| Persentase gas MG812 | 20 | 120 | 1 byte | 1-100% tidak ditandatangani | RAK12008 | persentase_20 |
| Gas alkohol MQ3 | 21 | 2 | 2 byte | 0,01 ditandatangani | RAK12009 | analog_in_21 |
| Perc Gas Alkohol MQ3. | 22 | 120 | 1 byte | 1-100% tidak ditandatangani | RAK12009 | persentase_22 |
| Jarak tof | 23 | 2 | 2 byte | 0,01 ditandatangani | RAK12014 | analog_in_23 |
| Data TOF valid | 24 | 102 | 1 byte | bool | RAK12014 | kehadiran_24 |
| Gyro dipicu | 25 | 134 | 6 byte | 2 byte per sumbu, 0,01 °/s | RAK12025 | gyrometer_25 |
| Gerakan terdeteksi | 26 | 0 | 1 byte | 1 byte dengan ID gerakan | RAK14008 | digital_in_26 |
| LTR390 Nilai UVI | 27 | 2 | 2 byte | 0,01 ditandatangani | RAK12019 | analog_in_27 |
| Nilai LTR390 UVS | 28 | 101 | 2 byte | 1 lux tidak ditandatangani | RAK12019 | Illuminance_28 |
| INA219 saat ini | 29 | 2 | 2 byte | 0,01 ditandatangani | RAK16000 | analog_29 |
| Tegangan ina219 | 30 | 2 | 2 byte | 0,01 ditandatangani | RAK16000 | analog_30 |
| Kekuatan ina219 | 31 | 2 | 2 byte | 0,01 ditandatangani | RAK16000 | analog_31 |
| Touchpad pergi | 32 | 102 | 1 byte | bool | RAK14002 | kehadiran_32 |
| Touchpad Middle | 33 | 102 | 1 byte | bool | RAK14002 | kehadiran_33 |
| Touchpad benar | 34 | 102 | 1 byte | bool | RAK14002 | kehadiran_34 |
| Konsentrasi CO2 SCD30 | 35 | 125 | 2 byte | 1 ppm tidak ditandatangani | RAK12037 | konsentrasi_35 |
| Suhu SCD30 | 36 | 103 | 2 byte | dalam ° C. | RAK12037 | suhu_36 |
| Kelembaban SCD30 | 37 | 104 | 1 byte | Dalam %RH | RAK12037 | kelembaban_37 |
| MLX90632 Sensor Temp | 38 | 103 | 2 byte | dalam ° C. | RAK12003 | suhu_38 |
| MLX90632 Temp objek | 39 | 103 | 2 byte | dalam ° C. | RAK12003 | suhu_39 |
| Nilai PM 1.0 | 40 | 103 | 2 byte | dalam UG/M3 | RAK12003 | voc_40 |
| Nilai PM 2.5 | 41 | 103 | 2 byte | dalam UG/M3 | RAK12003 | voc_41 |
| Nilai PM 10 | 42 | 103 | 2 byte | dalam UG/M3 | RAK12003 | voc_42 |
| Peristiwa gempa bumi | 43 | 102 | 1 byte | bool | RAK12027 | kehadiran_43 |
| Nilai SI Gempa Bumi | 44 | 2 | 2 byte | analog 10 * m/s | RAK12027 | analog_44 |
| Nilai PGA gempa bumi | 45 | 2 | 2 byte | Analog 10 * m/s2 | RAK12027 | analog_45 |
| Peringatan shutoff gempa bumi | 46 | 102 | 1 byte | bool | RAK12027 | kehadiran_46 |
| Lpp_channel_eq_collapse | 47 | 102 | 1 byte | bool | RAK12027 | kehadiran_47 |
| Status beralih | 48 | 102 | 1 byte | bool | RAK13011 | kehadiran_48 |
| Kecepatan angin sensorhub | 49 | 190 | 2 byte | 0,01 m/s | SensorHub RK900-09 | wind_speed_49 |
| Arah angin sensorhub | 50 | 191 | 2 byte | 1º | SensorHub RK900-09 | wind_direction_50 |
| Level audio | 49 |
ID saluran dalam Kursive adalah format yang diperluas dan tidak didukung oleh decoder data LPP Cayenne standar.
Contoh Decoder untuk TTN, ChirpStack, Helium, dan Datacake dapat ditemukan di folder Rakwireless_Standardized_Payload repo
File yang dikompilasi terletak di folder ./generasi. Setiap versi kompilasi yang berhasil dinamai sebagai
WisBlock_SENS_Vx.y.z_YYYY.MM.dd.hh.mm.ss
XYZ adalah nomor versi. Nomor versi diatur dalam file ./platformio.ini.
Yyyy.mm.dd.hh.mm.ss adalah cap waktu kompilasi.
File .zip yang dihasilkan dapat digunakan juga untuk memperbarui perangkat lebih baik menggunakan kotak alat wisblock
Saat menggunakan PlatformIO Selain itu, file UF2 untuk RAK4631 dihasilkan. Anda dapat memaksa RAK4631 ke mode bootloader dengan menekan tombol reset ganda. Drive USB baru akan diinstal. Tarik file UF2 ke drive baru untuk mem -flash perangkat.
Output debug dapat dikontrol dengan menentukan di platformio.ini
Lib_debug mengontrol output debug dari perpustakaan Lorawan SX126X-ODUINO
API_DEBUG mengontrol output debug dari perpustakaan Wisblock-API
My_debug mengontrol output debug aplikasi itu sendiri
CFG_DEBUG mengontrol output debug dari BSP NRF52. Disarankan untuk mempertahankannya
[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.pyPanduan ini dapat digunakan untuk Wisblock Kit 1 dan RAK Developer Kit 2
Instal modul di slot yang cocok, mengikuti panduan mulai cepat di Pusat Dokumentasi Rakwireless
Siapkan perangkat menggunakan antarmuka perintah AT atau aplikasi BLE
Panduan ini dapat digunakan untuk Wisblock Kit 2 , Wisblock Kit 3 , Wisblock GNSS Tracker untuk Lorawan dan RAK Developer Kit 3
Modul RAK1904 harus dipasang di
Slot C RAK5005-O, RAK19007, RAK19003 atau RAK19001
Jika menggunakan RAK1910, itu harus dipasang di
Slot a rak5005-o
Slot yang cocok dari RAK19007 atau RAK19001
Jika menggunakan RAK12500, itu dapat dipasang di setiap slot yang cocok dari papan dasar.
RAK1906 dapat dipasang di setiap slot yang cocok dari papan dasar.
Untuk pemandu instalasi, ikuti panduan mulai cepat di Pusat Dokumentasi Rakwireless
Siapkan perangkat menggunakan antarmuka perintah AT atau aplikasi BLE
RAK11700 GNSS Tracker untuk Lorawan adalah mode start default untuk pengaturan ini.
Jika membangun kit helium mapper, mode harus diubah dengan perintah di bawah ini:
Solusinya dapat diatur ke 3 mode kerja yang berbeda menggunakan perintah AT AT+GNSS :
| Memerintah | Parameter input | Nilai pengembalian | Kode pengembalian |
|---|---|---|---|
| Di+GNSS? | - | Get/Set the GNSS precision and format 0 = 4 digit, 1 = 6 digit, 2 = Helium Mapper | OK |
| Di+gnss =? | - | 0 atau 1 atau 2 | OK |
At+gnss = <Input Parameter> | 1 atau 2 atau 3 | - | OK atau AT_PARAM_ERROR |
Format standar Cayenne LPP hanya menggunakan 4 digit untuk presisi lokasi. Format lokasi default ini secara otomatis didukung oleh sebagian besar server Lorawan dan platform visualisasi seperti MyDevices .
Ini adalah default dan diatur dengan perintah AT AT+GNSS=0 .
Menetapkan opsi ini, data masih dikirim dalam format LPP Cayenne, tetapi menggunakan pengidentifikasi data khusus dan 6 digit untuk resolusi garis lintang dan bujur yang lebih tinggi. Diperlukan untuk memecahkan kode ini, diperlukan encoder data khusus. Encoder data untuk TTN, ChirpStack dan DataCake dapat ditemukan di folder Decoder Data Kustom.
Resolusi lokasi yang ditingkatkan diatur dengan perintah AT AT+GNSS=1 .
Opsi ini mengirimkan data dalam format helium mapper, seperti yang dijelaskan dalam membuat mapper helium dengan wisblock.
Decoder paket untuk format ini disediakan dalam artikel di atas.
Fungsionalitas helium mapper diatur dengan perintah AT AT+GNSS=2 .
Panduan ini dapat digunakan untuk Wisblock Kit 4 dan RAK Developer Kit 4
Instal modul di slot yang cocok, mengikuti panduan mulai cepat di Pusat Dokumentasi Rakwireless
Siapkan perangkat menggunakan antarmuka perintah AT atau aplikasi BLE
