The Things Network Arduino Library (fork)

Note: This is a fork of the now-unmaintained arduino-device-lib with support for the Microchip SAMR34 and tested with ESP32. Intended as a drop-in replacement with backward compatibility.

This is an Arduino Library for Arduino devices like The Things Uno and Node to communicate via The Things Network.

At the moment this library requires devices to feature a Microchip RN2xx3 module. You may also use a SAMR34-based board, for more information on that see SAMR34 Usage.

Installation

• Install the library by Using the Library Manager
• OR by Importing the .zip library using either the master or one of the releases ZIP files.

Documentation

• The Things Network Documentation
• API References:
  • TheThingsNetwork
  • TheThingsMessage

SAMR34 Usage

Compatibility between this library and the SAMR34-based boards is experimental, it has only been tested with the Microchip WLR089 module.

Before usage, please note the following:

1. If using a SAMR34-based board, you must first program your board with the RN Parser firmware. This firmware emulates the behaviour of the RN2xx3 devices on the SAMR34. Specifically, you must use the MLS 1_0_P_6 (Parser_ECC608) firmware contained here, since several bugs that made the firmware unusable where fixed for this release.
2. Some commands available in the RN2xx3 modems are not implemented in the RN Parser firmware for SAMR34. For a complete list of the implemented commands and their possible differences, see the Command User Guide for the RN Parser firmware.
3. The autoBaud feature is not available in the RN parser firmware, but this is easily circumvented by manually modifying the default baud rate in the conf_sio2host.h file within the firmware's source code. Default baud rate is 115200.

Examples

The library comes with examples. After installing the library you need to restart the Arduino IDE before they can be found under File > Examples > TheThingsNetwork.