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 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. |