- Technical characteristics
- Provisioning the device for Thingsboard
- ThingsBoard configuration
- Additional information
- Next steps
The EXXN IoT Gateway is a versatile device with an ARM processor that can be adapted to a variety of use cases, including monitoring environmental sensors, energy consumption, radon gas levels, marine environments, and edge computing.
This guide outlines the process for integrating an EXXN IoT Gateway with the ThingsBoard platform to enable remote monitoring and management of devices.
An example of a dashboard developed with ThingsBoard that displays metrics captured by an EXXN IoT Gateway.
In this tutorial, we will configure an EXXN IoT Gateway to integrate it with ThingsBoard via the MQTT API. In order to do this we will use:
- EXXN IoT Gateway ‘Cell 1024’;
- We must have connection to the device and the Device have to be connected to the Internet via Ethernet, Modem or Wifi.
The technical specifications of the EXXN IoT Gateway ‘Cell 1024’ used in this guide are:
- ARM Cortex-A53 Quad-Core 64-bit Processor
- GPU Mali 470
- 2GB DDR4
- 8GB eMMC
- 10/100 Mbit/s Ethernet
- Wi-Fi 802.11 b/g/n/AC
- Bluetooth 4.2
- Possibility of hardware development for custom functionalities
Provisioning the device for Thingsboard
Contains instructions that are necessary to connect your device to ThingsBoard.
Open your instance ThingsBoard (local or cloud) in browser and login as tenant administrator.
Go to “Device groups” tab -> “All” and click “plus” button to add a new device.
Enter device name, select existing or create a new device profile and click on “Add” button.
Your device has been created. Open its details and copy auto-generated access token by clicking on the “Copy access token” button.
Open a Browser to the administration web of Cell 1024 using this URL: https://[IP_DEVICE] and go to the ‘Cloud’ tab:
Activate the Cloud control and configure all the parameters to connect the device to the specific ThingsBoard platform via MQTT:
- Cloud Platform: Select ThingsBoard.
- MQTT broker URL: URL to de Broker of the server we want to integrate to.
- MQTT broker port: Number of the port used by the server.
- TLS: Select true if the server use the Transport Layer Security protocol.
- Connection Type: Select ‘Access Token’ option. We will use an Access token previously created in ThingsBoard.
- Access Token: Indicate the Access token previously copyed in ThingsBoard.
Click “Save configuration” button.
To verify that the device is connected correctly to ThingsBoard, go to the Device groups menu -> All devices, select your device. In the device details select client attributes tab and check if the client attributes have been communicated to the device.
If you did everything is correct, we will see client attributes like the serial_number, last_rebbot, device_model, etc.
The EXXN IoT Gateway will connect to ThingsBoard using the MQTT API.
We have previously covered how to configure the device to connect to ThingsBoard. Now, we will show the steps to configure the device in ThingsBoard in order to monitor data and manage the device.
In order to configurate the datalogger options of the EXXN IoT Gateway, we must to create a new JSON ‘Shared’ Attribute for the Device with de key ‘config’.
- Go to devices attributes tab in the device details. Add a new “Shared” attribute with the key “config” of type JSON.
- Expand the content of the attribute to full screen for ease of writing it. Paste the contents of the device configuration file into the attribute value.
An example of this JSON file can be downloaded from this link.
All the information to configure the device correctly through this JSON File can be found in the EXXN IoT Gateway Manual.
- Click “Add” attribute.
Create a dashboard to visualize telemetry values in widgets.
- Go to the Dashboard groups tab -> All. Creat new dashboard by clicking the “plus” button in the upper right corner of the dashboards page. Enter dashboard name and click on “Add” button.
- Create Radial gauge widget from the Analohue gauges bundle. Read more about widgets and their creation in this guide.
All the measures that are ‘enabled’ in the device’s JSON configuration file will be found as metrics with the name specified in the same file.
It is possible to send commands to the device to execute certain tasks. The parameters of the method must be in JSON format.
All the commands that can be sent to the device are explained in the EXXN IoT Gateway manual.
- The most common problem in the integration process is not having a connection with the MQTT Broker. Make sure the device is connected to the internet and is able to communicate with the ThingsBoard Broker.
- Another common problem is not setting the correct Access Token. Check that the provided Access token is configured in ThingsBoard for the device.
Feedback & Contact Us for your integration
For more information, visit our website at EXXN Engineering.
If you have any problems or doubts, please do not hesitate in contact us at: [email protected]
Getting started guides - These guides provide quick overview of main ThingsBoard features. Designed to be completed in 15-30 minutes.
Installation guides - Learn how to setup ThingsBoard on various available operating systems.
Connect your device - Learn how to connect devices based on your connectivity technology or solution.
Data visualization - These guides contain instructions how to configure complex ThingsBoard dashboards.
Data processing & actions - Learn how to use ThingsBoard Rule Engine.
IoT Data analytics - Learn how to use rule engine to perform basic analytics tasks.
Advanced features - Learn about advanced ThingsBoard features.
Contribution and Development - Learn about contribution and development in ThingsBoard.