Difference between revisions of "Allwize library"

From AllWize Wiki
Jump to navigation Jump to search
(Code examples)
Line 28: Line 28:
 
* factoryReset: shows how to factory reset the radio module
 
* factoryReset: shows how to factory reset the radio module
 
* lorawan: example on how to use Wize to encapsulate a LoRaWAN frame and send it to The Things Network
 
* lorawan: example on how to use Wize to encapsulate a LoRaWAN frame and send it to The Things Network
** lorawan_gateway: code to use with an ESP8266 to receive a Wize encapsulated LoRaWAN frame and send it to TTN using Semtech Legacy Protocol
+
** lorawan_gateway: code to use with an ESP8266 to receive a Wize encapsulated LoRaWAN frame and send it to TTN using Semtech Legacy Protocol, uses CayenneLPP to build the payload
 
** lorawan_node: code to send a LoRaWAN frame via Wize
 
** lorawan_node: code to send a LoRaWAN frame via Wize
 
* lowpower: example on how to lowpower the radio an microcontroller (AVR, SAMD)
 
* lowpower: example on how to lowpower the radio an microcontroller (AVR, SAMD)
Line 36: Line 36:
 
** master_allwize_k2: AllWize K2 master
 
** master_allwize_k2: AllWize K2 master
 
* moduleInfo: shows radio module configuration and non-volatile memory dump
 
* moduleInfo: shows radio module configuration and non-volatile memory dump
* slave
+
* slave: different examples on how to create a slave node with the library
** slave_allwize_k1_esp32
+
** slave_allwize_k1_esp32: ESP32-based slave
** slave_allwize_k1_esp8266
+
** slave_allwize_k1_esp8266: ESP8266 slave
** slave_allwize_k1_leonardo
+
** slave_allwize_k1_leonardo: Arduino Leonardo slave
** slave_allwize_k1_uno
+
** slave_allwize_k1_uno: Arduino Uno slave
** slave_allwize_k1_zero
+
** slave_allwize_k1_zero: Arduino Zero / Zero Pro slave
** slave_allwize_k2
+
** slave_allwize_k2: AllWize K2 slave
** slave_allwize_k2_mbus
+
** slave_allwize_k2_mbus: AllWize K2 slave using MBUSPayload to build the app payload
* use_cases
+
* use_cases: different slaves using specific sensors for specific use cases
** sensor-bme280
+
** sensor-bme280: BME280 temperature, humidity and pressure sensor
** sensor-hcsr04
+
** sensor-hcsr04: HC-SR04 ultrasound sensor
** sensor-mcp9701
+
** sensor-mcp9701: MCP9701 analog temperature sensor, the one included in the AllWize K1 shield
** sensor-mhz16
+
** sensor-mhz16: MH-Z16 CO2 sensor
** sensor-mics4514
+
** sensor-mics4514: MICS4514 CO & NO sensor
** sensor-si7021
+
** sensor-si7021: SI7021 temperature and humidity sensor
** uc-vineryards
+
** uc-vineryards: BME280 and a soil humidity sensor for agriculture monitoring
** uc-wcpaper
+
** uc-wcpaper: toilet paper sensor :)
* wize2mqtt
+
* wize2mqtt: Wize to MQTT bridge that supports CSV, CayenneLPP and MBUS payload formats. Meant to run on an ESP8266-based board.
* wize2mqtt_mbus
+
* wize2serial: Wize to serial bridge that supports CSV, CayenneLPP and MBUS payload formats.
* wize2serial
+
* wize2thethingsio: Wize to TheThingsIO bridge that supports CSV, CayenneLPP and MBUS payload formats. Meant to run on an ESP8266-based board.
* wize2thethingsio
 
  
 
== Reference links ==
 
== Reference links ==

Revision as of 11:35, 19 August 2019

The AllWize Library is an Arduino compatible library to interface the RadioCrafts RC1701HP-XXX radio module.

The library is available in the Arduino IDE Library Manager:

Arduino IDE Library Manager

And also in the PlatformIO Library Manager:

$ pio lib search allwize
Found 1 libraries:

AllWize
=======
#ID: 5804
Arduino-compatible library to interface RC1701HP-OSP/WIZE radio modules

Keywords: wize, radio, radiocrafts, wmbus4
Compatible frameworks: Arduino
Compatible platforms: Atmel AVR, Atmel SAM, Espressif 32, Espressif 8266
Authors: AllWize.io, Xose Pérez

Code examples

The library provides several examples to learn the different possibilities it offers:

  • factoryReset: shows how to factory reset the radio module
  • lorawan: example on how to use Wize to encapsulate a LoRaWAN frame and send it to The Things Network
    • lorawan_gateway: code to use with an ESP8266 to receive a Wize encapsulated LoRaWAN frame and send it to TTN using Semtech Legacy Protocol, uses CayenneLPP to build the payload
    • lorawan_node: code to send a LoRaWAN frame via Wize
  • lowpower: example on how to lowpower the radio an microcontroller (AVR, SAMD)
  • master: different examples on how to create a master (single channel gateway) with the library
    • master_allwize_k1_esp8266: ESP8266 master
    • master_allwize_k1_leonardo: Arduino Leonardo master
    • master_allwize_k2: AllWize K2 master
  • moduleInfo: shows radio module configuration and non-volatile memory dump
  • slave: different examples on how to create a slave node with the library
    • slave_allwize_k1_esp32: ESP32-based slave
    • slave_allwize_k1_esp8266: ESP8266 slave
    • slave_allwize_k1_leonardo: Arduino Leonardo slave
    • slave_allwize_k1_uno: Arduino Uno slave
    • slave_allwize_k1_zero: Arduino Zero / Zero Pro slave
    • slave_allwize_k2: AllWize K2 slave
    • slave_allwize_k2_mbus: AllWize K2 slave using MBUSPayload to build the app payload
  • use_cases: different slaves using specific sensors for specific use cases
    • sensor-bme280: BME280 temperature, humidity and pressure sensor
    • sensor-hcsr04: HC-SR04 ultrasound sensor
    • sensor-mcp9701: MCP9701 analog temperature sensor, the one included in the AllWize K1 shield
    • sensor-mhz16: MH-Z16 CO2 sensor
    • sensor-mics4514: MICS4514 CO & NO sensor
    • sensor-si7021: SI7021 temperature and humidity sensor
    • uc-vineryards: BME280 and a soil humidity sensor for agriculture monitoring
    • uc-wcpaper: toilet paper sensor :)
  • wize2mqtt: Wize to MQTT bridge that supports CSV, CayenneLPP and MBUS payload formats. Meant to run on an ESP8266-based board.
  • wize2serial: Wize to serial bridge that supports CSV, CayenneLPP and MBUS payload formats.
  • wize2thethingsio: Wize to TheThingsIO bridge that supports CSV, CayenneLPP and MBUS payload formats. Meant to run on an ESP8266-based board.

Reference links