MikroElektronika LoRa 2 Click Element

The LoRa 2 click element is used to send data over a LoRa network. This element is for using the MikroElektronika LoRa 2 Click board, which on Atmosphere works exclusively through The Things Network.

To send data via The Things Network, the LoRa 2 Click board needs to be registered as a device within an application on The Things Network console, and then a project that includes the application information is created in Atmosphere. When registering a LoRa 2 Click board to The Things Network, the device EUI is needed. This is the universal ID that identifies the device within the LoRa network, and is unique to the board. However, the LoRa 2 Click board doesn’t physically display the device EUI itself and it must be digitally read from the board. To get the EUI, you can have it printed to a debug console or create an app interface in Atmosphere Studio to display the value.

The LoRa 2 click is a protocol element that can be imported into the Element Toolbox through the Add Element Add Element button located in the toolbox from the Embedded tab. When a LoRa 2 click element is added to the canvas, it creates a coupled The Things Network version in the project’s Cloud tab that bridges the element’s functionality between the Embedded tab and Cloud tab.

Due to various hardware requirements, the LoRa 2 Click element is currently only accessible within the following project types:

  • Arduino Mega
  • ESP32 (and all variants)
  • MAX32630 Feather
  • nRF52840-DK
  • PIC-IoT WG

Properties

The following properties can be changed for the LoRa 2 click element:

Name

The name of the element.

UART Driver Instance

Instance of the UART driver to use.

NOTE: The chosen UART driver instance must be exclusive to the click board. It must not be shared with debug print data.

GPIO Driver Instance

Instance of the GPIO driver to use.

Reset Pin

The GPIO pin that resets the Click board. This pin will automatically be used to reset the Click board on startup.

App Key (Custom)

The application key specific for the ­device that is assigned by the user.

Application EUI

The universal ID that identifies the application in The Things Network the device is a part of.

Upstream Data Type

The type of data sent from the LoRa 2 click element to The Things Network.

Downstream Data Type

The type of data received from the network back to the device.

NOTE: Downstream data going back from The Things Network to the device is currently not supported in Atmosphere.

Triggers

The following triggers are available to execute events from within the LoRa 2 click element:

Triggered

Execute an event when the source element connected to the LoRa 2 click triggers.

Data Sent

Execute an event when data is sent from the Click board to The Things Network.

EUI Retrieved

Execute an event when an application EUI is returned.

Abilities

The following abilities are available for the LoRa 2 click element when its source element triggers:

Trigger

Trigger the element(s) that follow the LoRa 2 click element.

Send Data

Send a data payload to The Things Network.

Get EUI

Get the device’s application EUI.

Element Resources

Atmosphere includes a selection of resources for users of all levels that demonstrate using the LoRa 2 click element.

Guides

For a step-by-step guide on creating a project that uses the LoRa 2 click element, click the guide’s name to learn how to use it within a project.

Name Hardware Description
Getting Started with LoRa and Atmosphere PIC-IoT WG Demonstrates a simple project that reads temperature and sends the data over LoRa to The Things Network, where it’s then forwarded to Atmosphere.

Demo Projects

To view the LoRa 2 click element used within a project, click the demo’s name to open the project in Atmosphere and see how the element is set up.

Name Hardware Description
LoRa 2 Click Device EUI Reader PIC-IoT WG Project that reads the device EUI from a LoRa 2 Click board and prints it onto a debug console. Project created for the PIC-IoT WG, but can be built for any hardware compatible with the LoRa 2 Click board.