 |
 |
 |
|---|
The main branch of this repository requires RUI3 V4.1.0.
But RUI3 V4.1.0 does not support the LinkCheck functionality!
In addition the format of API calls for LoRa P2P have changed in RUI3 V4.1.1!
Therefor the RUI3-Signal-Meter-P2P-LPWAN example requires the staging version V4.1.1
The examples for RUI3 V4.1.1 are in the branch V4.1.1.
At the time this code was published, RUI3 V4.1.1 is still in staging. It can be installed by using the Arduino BSP JSON file for the staging version by using https://raw.githubusercontent.com/RAKWireless/RAKwireless-Arduino-BSP-Index/staging/RUI_4.1.1_273/package_rakwireless_com_rui_index.json in the Additional Boards Manager URLs settings in ArduinoIDE.
Installation guides for Arduino IDE and Visual Studio Code can be found in the RAK Documentation Center.
This repo provides additional examples for RUI3. It focuses on low power consumption and practical examples for range tests, location tracking and sensing applications using the WisBlock Modular System.
A collection of tips and tricks about the usage or RUI3 is as well available in the Tips-n-Tricks file.
Due to the limited Flash and RAM size of the RAK3172, some of the examples require code size reduction before they fit into the available memory!
Actions to reduce code size can be
- Limit the supported LoRaWAN regions in the
Arduino Board Manager Menu - Disable the debug output of the examples code. This is done by setting
#define MY_DEBUG 0in the fileapp.hof the examples
All examples are prepared to work in either LoRaWAN or LoRa P2P mode.
All examples are using AT commands for setup of the device instead of hard-coding the parameters with API calls!.
Some of the examples are using RUI3 libraries for the WisBlock modules. These libraries are simplified (to save code space on the RAK3172) and can be downloaded as ZIP files from
- RAKwireless_RAK1901_Temperature_and_Humidity_SHTC3.zip
- RAKwireless_RAK1902_Pressure_LPS22HB.zip
- RAKwireless_RAK1903_Optical_OPT3001.zip
- RAKwireless_RAK1904_Accelerate_LIS3DH.zip
- RAKwireless_RAK1906_Environment_BME680.zip
- RAKwireless_RAK1910_GPS_UBLOX7.zip
- RAKwireless_RAK5860_LTE_NBIoT_Module.zip
The libraries can be installed with the "Install from ZIP" function in the ArduinoIDE Library Manager.
The libraries can be installed as well manually by unzipping the content into the default Arduino Library folder.
The following modules are supported by RUI3:
| WisDuo modules and EVB's | WisBlock Core Modules |
|---|---|
| RAK3172 stamp module | RAK4631-R |
| RAK3272S breakout board | RAK3372 |
| RAK3172 evaluation board | RAK11722 |
| RAK3172-SiP chip | |
| RAK3272-SiP breakout board | |
| RAK4630 stamp module | |
| RAK11720 stamp module | |
| RAK11721 breakout board |
The simpliest example is just showing how to design an application that is event based and keeps the MCU and LoRa transceiver in low power mode whenever possible.
It includes as well a simple example how to implement custom AT commands.
A simple sensor application based on RAK1901 and RAK1902. It reads temperature, humidity and barometric pressure from these sensors and sends them in a configurable interval.
This example is using the Cayenne LPP data format to send the formatted payload.
A simple sensor application based on RAK1906 and optional RAK1903 or RAK12010. It reads temperature, humidity and barometric pressure and environment light from these sensors. It displays the values on the RAK14000 and sends them in a configurable interval.
This example is using the Cayenne LPP data format to send the formatted payload.
Due to the memory required for driving the EPD, when using with the RAK3172, the LoRaWAN regions have to be reduced to a few to have enough flash available.
Same example as RUI3-Sensor-Node-EPD-2.13, but this project uses some of the VSC tricks from the Tips-n-Tricks for Visual Studio Code.
This example uses the RAK12007 ultrasonic sensor module to measure the water level in a water tank.
This example is using the Cayenne LPP data format to send the formatted payload.
A motion based location tracker using the RAK12500 and RAK1904 WisBlock modules. Based on the RUI3-LowPower-Example code.
This example is using the Cayenne LPP data format to send the formatted payload.
A door or window alarm system using the RAK13011 magnetic relay switch module. This examples features the usage of a queue to collect events. For the alarm system (or open/close counter), this was necessary, because events could be triggered faster than the uplink packets can be sent over LoRaWAN.
Example code for using the RAK5811 0-5V analog input module with RUI3. For lowest power consumption, the RAK5811 is powered down until a data reading is required. The interval time for reading the data can be setup with AT command.
A sensor application that combines temperature, humidity, barometric pressure, CO2 and VOC sensing. It detect automatically which sensors are attached and adjusts its payload to the available sensor data. It supports WisBlock RAK1906, RAK12037 and RAK12047 sensor modules
This is a PoC of a very basic signal tester. It works in both LoRa P2P and LoRaWAN mode. It uses a simple OLED display and has no GUI. All settings are done over USB with RUI3 AT commands.
It is a very simple (~30 US$ cheap) device that can help to check LoRa and LoRaWAN coverage. It does not claim to be a super precise instrument, it is just an affordable small instrument to check signal coverage.
A control application that changes the status of a relay depending on a received data packet. This is as well an example how to use LoRaWAN Class C to be able to receive downlink packets from the LoRaWAN server at any time. It supports WisBlock RAK13001 and RAK13007 relay modules
This example is a simple Modbus Master that reads sensor values from a Modbus Slave. For easy testing a Modbus Slave application is available for another WisBlock/WisDuo based module with a temperature, humidity and barometric pressure sensor.
This example uses a modified version of the Modbus-Master-Slave-for-Arduino library. This library was choosen because of its small code size. However, due to some incompatible definitions, it did not compile with RUI3. The library was slightly modified to work with RUI3 and is included as project files RUI3_ModbusRtu.cpp and RUI3_ModbusRtu.h.
The original libray is licensed under the GNU LESSER GENERAL PUBLIC LICENSE Version 2.1
This is a PoC of a simple LoRa Mesh Network. It includes everything to setup a Mesh Network (compatible with WisBlock-API-Mesh).
It supports a limited number of Mesh nodes (15 with the RAK3172 and 30 with the RAK4630 and RAK11720) and sends a dummy data packet.
Beside of packet broadcasting it supports sending data to a specific other node and it is as well possible to define a master node to which all other nodes are sending the packets.
RUI3 code example for the WisBlock Kit 1 which includes RAK1901 (temperature and humidity), RAK1902 (barometric pressure) and RAK1903 (light) sensor support. Ideal if the Kit 1 is changed to use RUI3 for lower the power consumption, specially if the RAK4631 is replaced with a RAK3372 WisBlock Core Module (RAK3172).
RUI3 code example for the WisBlock Kit 4 which uses the RAK1906 (temperature, humidity and barometric pressure) sensor. Ideal if the Kit 4 is changed to use RUI3 for lower the power consumption, specially if the RAK4631 is replaced with a RAK3372 WisBlock Core Module (RAK3172).
Get a RAKwireless RUI3 WisDuo stamp module, breakout board or evaluation board from our store
Get a RAKwireless RUI3 WisBlock Core module from our store