Environmental and Barometric Solution LoRaWAN Network Server

Network Server and Visualization Configuration

This section outlines the operational steps for connecting the device to the network server in both the LoRaWAN and LTE-M application scenarios, respectively.

Figure 10505: LoRaWAN application scenario

LoRaWAN Application

Cloud Network Server Setup

The cloud network server deployment scenario involves connecting the gateway and devices to third-party cloud network servers. This server integrates visualization applications to manage real-time temperature, humidity and pressure sensor data.

This section provides instructions on creating a Datacake visualization application using the TTN v3 cloud network server.

Figure 10506: Cloud network server deployment solution

Connect Gateway to TTN

For this example, you will use the TTNv3 cloud server and RAK7289 V2 WisGate Edge Lite 2 to demonstrate how to connect the RAK business gateway to a cloud server.

• Register the Gateway

1. Register an account and log in to the TTN v3 website. If you already have a TTN account, you can log in using your The Things ID credentials.

Figure 10507: Log in to the TTN website

2. Once logged into the site, click on Register a gateway to begin the registration process for a new gateway.

Figure 10508: TTN home page

3. Input the Gateway EUI and then click on Confirm to proceed.

The Gateway EUI serves as a distinct 64-bit extended identifier for the gateway. It is accessible from the Overview page of the gateway management platform or the label situated behind the gateway.

Figure 10509: Enter the Gateway EUI

4. Choose the appropriate frequency plan used by the gateway, and click Register gateway to complete the registration process of the gateway.

Figure 10510: Configure the gateway frequency

Your gateway dashboard should look the same with Figure 7.

Figure 10511: Successfully registered the gateway

• Generate a Token

TTNv3 supports TLS server authentication and client tokens, which require trust files and keys to configure the gateway and successfully connect to the network.

1. To generate a key file, navigate to API keys from the Overview page of the registered gateway, then click Add API key.

Figure 10512: Add API keys

2. In the Add API key page, set the Name field, tick off the checkboxes, then click Create API key.

Figure 10513: Configure the API Key

3. A new window pops up with the generated key. Copy the new API key by clicking the icon and then the I have copied the key button.

Figure 10514: Copy and save the API Key

Configure the Gateway

1. Navigate back to the gateway management platform Web UI. Click on the left navigation bar to access the LoRa > Configuration tab. Complete the following settings and save them.
   • Basics Station Server Type: LNS Server
   • Server URL: wss://eu1.cloud.thethings.network
   • Server Port: 8887
   • Authentication Mode: TLS server & Client Token - Authentication
   • Trust (CA Certificate): Click the link to download.
   • Client Token: Copied API Keys

Figure 10515: Configure the gateway

2. After saving the changes, return to the TTN gateway interface, and navigate to the Gateways tab to confirm that the gateway is now connected to TTNv3 as a Basics Station.

Figure 10516: Gateway connected successfully

Connect Sensor Hub to TTN

1. Return to the TTNv3 homepage and select Create an application to add a node.

Figure 10517: Select Create an application

2. Click + Create application to initiate the creation of a node.

Figure 10518: Create a new application

3. Enter the desired Application ID in the provided field, then click on Create application.

Figure 10519: Fill in the Application ID field

4. Click on the + Register end device button to add a new end device to the application.

Figure 10520: Add the end device

5. Set the parameters of the end device, as shown in Figure 17.

Figure 10521: End device parameters

• JoinEUI, DevEUI, and AppKey can be automatically generated by clicking Generate on the TTN web page or customized by the user.

NOTE

Ensure that the three parameters - JoinEUI, DevEUI, and AppKey - are consistent with the parameters set in the WisToolBox application.

6. After completing the settings, return to the WisToolBox app, and click JOIN NETWORK to send the end device network join request.

Figure 10522: Sending end device network join request

7. As shown in Figure 19, the Sensor Hub has successfully joined the TTNv3 network server.

Figure 10523: Successfully joined the TTNv3 network server

Visualize Data Through Datacake

Datacake is a versatile IoT platform. It offers a range of features tailored for effective data visualization and management, making it a preferred choice for IoT projects requiring efficient monitoring and analysis.

Create Datacake Integration

1. In the TTN console, navigate to Integrations on the sidebar, proceed to the Webhooks section, and then click +Add webhooks to set up an integration.

Figure 10524: Adding an integration

2. From the list of webhook templates, select the Datacake template.

Figure 10525: Select the Datacake template

3. Generate an API key on Datacake to enable webhook authentication. To get started, register a Datacake account, and then log in.

Figure 10526: Datacake IoT platform main page

4. Navigate to the Datacake workspace. Select Members on the sidebar, switch to the API Users tab, then click the Add API User button.

Figure 10527: Add API User

5. Enter the name of the API User, for instance, TTS API. Set the relevant parameters accordingly and click Save to finalize the creation process.

Figure 10528: Set Parameters

6. Click the Copy button to copy the generated Datacake API Token.

Figure 10529: Copy the generated Datacake API Token

7. Back on the TTN website, enter sensorhub in the Webhook ID field (as an example), and paste the Datacake API Token you previously copied into the Token field. Click the Create Datacake Webhook button to generate the Datacake Webhook.

Figure 10530: Create the Datacake Webhook

Add Sensor Hub to Datacake

1. To add a new device, select Devices in the sidebar and click the +Add Device button.

Figure 10531: Add a device

2. Choose LoRaWAN from the options and click Next to proceed.

Figure 10532: Select LoRaWAN

3. As the Sensor Hub is a new device, there is no pre-existing template. Create a template by clicking New Product, enter the Product Name, and click Next to proceed.

Figure 10533: Create a New Product

4. Choose a network server for your device. In this guide, select The Things Stack V3, then click Next to continue.

Figure 10534: Select the Things Stack V3

5. In the STEP 3 Devices tab, enter the device DEVEUI and NAME fields, and click Next to continue.

Figure 10535: Add DEVEUI and Name

6. In Step 4 Plan, select the preferred subscription plan, and click Add 1 device to add the device. For this example, choose Free.

Figure 10536: Select a subscription plan

7. The registered device can now be viewed on the Devices tab.

Figure 10537: Registered device

Create a Payload Decoder

1. Click the successfully registered device and go to the Configuration tab. Scroll down to the Payload Decoder field, then copy and save the decoder code.

Figure 10538: Configuration tab

Figure 10539: Decoder code

Click to view the code

function lppDecode (bytes) {
var sensor_types = {
	0: { 'size': 1, 'name': 'digital_in', 'signed': false, 'divisor': 1 },
	1: { 'size': 1, 'name': 'digital_out', 'signed': false, 'divisor': 1 },
	2: { 'size': 2, 'name': 'analog_in', 'signed': true, 'divisor': 100 },
	3: { 'size': 2, 'name': 'analog_out', 'signed': true, 'divisor': 100 },
	100: { 'size': 4, 'name': 'generic', 'signed': false, 'divisor': 1 },
	101: { 'size': 2, 'name': 'illuminance', 'signed': false, 'divisor': 1 },
	102: { 'size': 1, 'name': 'presence', 'signed': false, 'divisor': 1 },
	103: { 'size': 2, 'name': 'temperature', 'signed': true, 'divisor': 10 },
	104: { 'size': 1, 'name': 'humidity', 'signed': false, 'divisor': 1 },
	112: { 'size': 2, 'name': 'humidity_prec', 'signed': true, 'divisor': 10 },
	113: { 'size': 6, 'name': 'accelerometer', 'signed': true, 'divisor': 1000 },
	115: { 'size': 2, 'name': 'barometer', 'signed': false, 'divisor': 10 },
	116: { 'size': 2, 'name': 'voltage', 'signed': false, 'divisor': 100 },
	117: { 'size': 2, 'name': 'current', 'signed': false, 'divisor': 1000 },
	118: { 'size': 4, 'name': 'frequency', 'signed': false, 'divisor': 1 },
	120: { 'size': 1, 'name': 'percentage', 'signed': false, 'divisor': 1 },
	121: { 'size': 2, 'name': 'altitude', 'signed': true, 'divisor': 1 },
	125: { 'size': 2, 'name': 'concentration', 'signed': false, 'divisor': 1 },
	128: { 'size': 2, 'name': 'power', 'signed': false, 'divisor': 1 },
	130: { 'size': 4, 'name': 'distance', 'signed': false, 'divisor': 1000 },
	131: { 'size': 4, 'name': 'energy', 'signed': false, 'divisor': 1000 },
	132: { 'size': 2, 'name': 'direction', 'signed': false, 'divisor': 1 },
	133: { 'size': 4, 'name': 'time', 'signed': false, 'divisor': 1 },
	134: { 'size': 6, 'name': 'gyrometer', 'signed': true, 'divisor': 100 },
	135: { 'size': 3, 'name': 'colour', 'signed': false, 'divisor': 1 },
	136: { 'size': 9, 'name': 'gps', 'signed': true, 'divisor': [10000, 10000, 100] },
	137: { 'size': 11, 'name': 'gps', 'signed': true, 'divisor': [1000000, 1000000, 100] },
	138: { 'size': 2, 'name': 'voc', 'signed': false, 'divisor': 1 },
	142: { 'size': 1, 'name': 'switch', 'signed': false, 'divisor': 1 },
	188: { 'size': 2, 'name': 'soil_moist', 'signed': false, 'divisor': 10 },
	190: { 'size': 2, 'name': 'wind_speed', 'signed': false, 'divisor': 100 },
	191: { 'size': 2, 'name': 'wind_direction', 'signed': false, 'divisor': 1 },
	192: { 'size': 2, 'name': 'soil_ec', 'signed': false, 'divisor': 1000 },
	193: { 'size': 2, 'name': 'soil_ph_h', 'signed': false, 'divisor': 100 },
	194: { 'size': 2, 'name': 'soil_ph_l', 'signed': false, 'divisor': 10 },
	195: { 'size': 2, 'name': 'pyranometer', 'signed': false, 'divisor': 1 },
	203: { 'size': 1, 'name': 'light', 'signed': false, 'divisor': 1 },
};


function arrayToDecimal(stream, is_signed, divisor) {


	var value = 0;
	for (var i = 0; i < stream.length; i++) {
		if (stream[i] > 0xFF)
			throw 'Byte value overflow!';
		value = (value << 8) | stream[i];
	}


	if (is_signed) {
		var edge = 1 << (stream.length) * 8;  // 0x1000..
		var max = (edge - 1) >> 1;             // 0x0FFF.. >> 1
		value = (value > max) ? value - edge : value;
	}


	value /= divisor;


	return value;


}


var sensors = [];
var i = 0;
while (i < bytes.length) {


	var s_no = bytes[i++];
	var s_type = bytes[i++];
	if (typeof sensor_types[s_type] == 'undefined') {
		throw 'Sensor type error!: ' + s_type;
	}


	var s_value = 0;
	var type = sensor_types[s_type];
	switch (s_type) {


		case 113:   // Accelerometer
		case 134:   // Gyrometer
			s_value = {
				'x': arrayToDecimal(bytes.slice(i + 0, i + 2), type.signed, type.divisor),
				'y': arrayToDecimal(bytes.slice(i + 2, i + 4), type.signed, type.divisor),
				'z': arrayToDecimal(bytes.slice(i + 4, i + 6), type.signed, type.divisor)
			};
			break;
		case 136:   // GPS Location
			s_value = {
				'latitude': arrayToDecimal(bytes.slice(i + 0, i + 3), type.signed, type.divisor[0]),
				'longitude': arrayToDecimal(bytes.slice(i + 3, i + 6), type.signed, type.divisor[1]),
				'altitude': arrayToDecimal(bytes.slice(i + 6, i + 9), type.signed, type.divisor[2])
			};
			break;
		case 137:   // Precise GPS Location
			s_value = {
				'latitude': arrayToDecimal(bytes.slice(i + 0, i + 4), type.signed, type.divisor[0]),
				'longitude': arrayToDecimal(bytes.slice(i + 4, i + 8), type.signed, type.divisor[1]),
				'altitude': arrayToDecimal(bytes.slice(i + 8, i + 11), type.signed, type.divisor[2])
			};
			sensors.push({
				'channel': s_no,
				'type': s_type,
				'name': 'location',
				'value': "(" + s_value.latitude + "," + s_value.longitude + ")"
			});
			sensors.push({
				'channel': s_no,
				'type': s_type,
				'name': 'altitude',
				'value': s_value.altitude
			});
			break;
		case 135:   // Colour
			s_value = {
				'r': arrayToDecimal(bytes.slice(i + 0, i + 1), type.signed, type.divisor),
				'g': arrayToDecimal(bytes.slice(i + 1, i + 2), type.signed, type.divisor),
				'b': arrayToDecimal(bytes.slice(i + 2, i + 3), type.signed, type.divisor)
			};
			break;


		default:    // All the rest
			s_value = arrayToDecimal(bytes.slice(i, i + type.size), type.signed, type.divisor);
			break;
	}


	sensors.push({
		'channel': s_no,
		'type': s_type,
		'name': type.name,
		'value': s_value
	});


	i += type.size;


}


return sensors;
}


// For TTN, Helium and Datacake
function Decoder(bytes, fport) {
// bytes = input.bytes;
// fPort = input.fPort;


// flat output (like original decoder):
var response = {};
lppDecode(bytes, 1).forEach(function (field) {
	response[field['name'] + '_' + field['channel']] = field['value'];
});


// Enable only for Datacake
 response['LORA_RSSI'] = (!!normalizedPayload.gateways && !!normalizedPayload.gateways[0] && normalizedPayload.gateways[0].rssi) || 0;
 response['LORA_SNR'] = (!!normalizedPayload.gateways && !!normalizedPayload.gateways[0] && normalizedPayload.gateways[0].snr) || 0;
 response['LORA_DATARATE'] = normalizedPayload.data_rate;


return response;
}  

2. Complete the fields for the configuration shown in Figure 36.

Figure 10540: Configuration fields

NOTE

• Add the field type under the Type input box. Select Integer for RAK1901, and Float for RAK1902.
• Enter an appropriate name in the Name field.
• The Identifier field will be automatically filled in based on the name.
• When an uplink is received, refresh the page and the CURRENT VALUE field will be updated.
• Leave everything else as default and click Add Field to complete the setup.

3. Repeat the above steps to add the Humidity/Temperature (RAK1902)/ Pressure fields, as shown is Figure 38 when completed.

Figure 10541: Successfully added fields

Create a Dashboard

1. To create a dashboard, click the edit mode switch () on the Dashboard tab of the device on Datacake.

Figure 10542: Turn on the edit mode switch

2. Click +Add Widget to add a visualization widget.

Figure 10543: Add visualization widget

3. Select Value from the menu to create a new dashboard.

Figure 10544: Select Value to create a new dashboard

NOTE

You can select different types of widgets to accommodate various data formats.

4. In the Title field under the Basics tab, name the widget. As an example, the temperature widget of RAK1901 is used, so name it as RAK1901_Temperature.

Figure 10545: Name the widget

5. Under the Data tab, pull down the Field tab bar, select Temperature (for RAK1901), and set the unit to ° C.

Figure 10546: Set the unit

6. Under the Gauge tab, select the gauge type and color, set the range of values for the widget, and then click Save.

Figure 10547: Set the widget type

7. To add another widget, ensure the edit mode switch is ON, then repeat from Step 2-6 for the Humidity, Temperature (RAK1902), and Pressure fields.

Figure 10548: Added Widget

8. When you finish adding the widgets, turn off the edit mode switch to save the edits.

Figure 10549: Save the edits

Built-In Network Server Setup

The RAK gateway comes with a built-in NS, which eliminates the need to deploy NS in the cloud or locally. This gateway is suitable for small-sized industrial application scenarios and offers various advantages such as cost savings, reduced R&D investment, high execution efficiency, and shorter delays.

The built-in network server of the RAK gateway provides MQTT and HTTP integration that allows for post-processing data and implementing solutions based on the needs.

This section will use the public MQTT broker integration as an example to demonstrate how to use the built-in network server to create a visualization application on ThingsBoard.

Figure 10550: Gateway built-in NS application scenario

Configure the ThingsBoard

1. Log in to ThingsBoard. If you don't have an account, create one before proceeding.

Figure 10551: ThingsBoard authentication page

2. After successfully logging in, you will be directed to the ThingsBoard homepage.

Figure 10552: ThingsBoard homepage

3. Navigate through Integration center > Integrations > Data converters in the left navigation tree to create a data converter for the uplink.

Figure 10553: Create a data converter

4. Click the Add Data Converter icon () and choose the Create new converter option.

Figure 10554: Create a data converter

5. Enter the name of the decoder in the Name field (for example, Uplink decoder), leave the Type field as Uplink, and select the JavaScript option.

Figure 10555: Add the decoder code

6. Edit the decoder code by copying the following code into the edit box, then click Add to include the uplink decoder.

Click to view the code

/** Decoder **/
//decode payload to string
var payloadStr = decodeToString(payload);
var data = JSON.parse(payloadStr).data;
var bytes = atob(data).split('').map(function (c) {
  return c.charCodeAt(0);
});


var values = {};
let i = 0;
while (i < bytes.length) {
  var channelId = (bytes[i] << 8) | bytes[i + 1];
  var value;
  switch (channelId) {
    case 0x0167:
      value = (bytes[i + 2] << 8) | bytes[i + 3];
      values.temperature1 = value / 10.0;
      i += 4;
      break;
    case 0x0268:
      value = bytes[i + 2];
      values.humidity = value;
      i += 3;
      break;
    case 0x0367:
      value = (bytes[i + 2] << 8) | bytes[i + 3];
      values.temperature2 = value / 10.0;
      i += 4;
      break;
case 0x0473:
      value = (bytes[i + 2] << 8) | bytes[i + 3];
      values.pressure = value / 10.0;
      i += 4;
      break;
    default:
      break;
  }
}


var integrationName = 'MQTT Integration';
var deviceName = ' rak19012';
var result = {
  deviceName: deviceName,
  attributes: {
    integrationName: metadata['integrationName'],
    temperature1: values.temperature1,
    humidity: values.humidity,
	temperature2: values.temperature2,
	pressure: values.pressure,
  },
};


/** Helper functions **/


function decodeToString (payload) {
return String.fromCharCode.apply (String, payload);
}


return result;

NOTE

In the above code, the marked word rak19012 is the device ID, i.e., the device name. This parameter must be consistent with the device name added in Configure the Gateway. In this example, it is rak19012.

7. Navigate to the Integration Center > Integrations menu and click the Add Integration icon () to add the MQTT integration.

Figure 10556: Add the MQTT integration

8. Enter the name of the integration (for example, MQTT Integration) in the Name field and select MQTT in the Type drop-down menu. Click Next to continue.

Figure 10557: Fill in the integration name

9. In the Uplink data converter options, click Select existing to choose the previously created decoder (Uplink Decoder), then click Next.

Figure 10558: Select the created decoder

10. In the Downlink data converter interface, no configuration is necessary and just click Skip to bypass this setup.
11. Configure connection options. Host is the MQTT broker address used for messages. The Host of the external MQTT broker used in this example is broker.hivemq.com. You can choose to use other brokers with a different Host.
12. Enter the address broker.hivemq.com in the Host field, with the port number 1883. Click the Add topic filter button to configure the subscription topic.

Figure 10559: Configure the connection options

Configure the subscription topic

application/{{application_name}}/device/{{device_EUI}}/join
application/{{application_name}}/device/{{device_EUI}}/rx
application/{{application_name}}/device/{{device_EUI}}/tx
application/{{application_name}}/device/{{device_EUI}}/ack
application/{{application_name}}/device/{{device_EUI}}/status

• application_name: The application ID created in the gateway.
• device_EUI: The device EUI of the end device.

13. Modify the parameter values corresponding to the topics based on the actual application created and the device used. After configuring the details, click the Add button to save and complete the settings.

Figure 10560: Configure and add the subscription topics

14. After clicking Add, the settings are saved and completed.

Figure 10561: Configuration completed

Configure the Gateway

This section will use the RAK7268 V2 WisGate Edge Lite 2 as an example.

1. To access the gateway web management platform, refer to the WisGateOS V2 user manual for details.

Figure 10562: WisGate OS Web Management Platform

2. After successfully logging in, navigate to the LoRa® menu in the left navigation tree and set the Work mode of the gateway to the Built-in network server.

Figure 10563: Set the Work mode of the gateway

3. Once done with the setting, click the Applications tab, then the Add application button. You can also click add one now text link to add a new application.

Figure 10564: Applications tab

4. Configure the following information: Application name, Application description, and Application Type.

Figure 10565: Configure the Application key

• Unified Application key: Choose this option if all devices will use the same application key. Once selected, a field for the application key appears, where you can manually type in an application key or click the Autogenerate button to generate one.

NOTE

• After enabling the Auto Add Device option, configure the Application EUI option. The value needs to be consistent with the node value. Once you have verified the application EUI and key, the device will be added automatically to the application.

5. Once you've completed the configuration, click on Save Application to add the new application.

6. In the application list, locate the newly created application and navigate to the End devices tab. If you've enabled the Auto Add Device function, the device will be automatically registered upon the addition request.

Figure 10566: End devices tab

7. Click the Add end device button. In the End device information interface, fill in the following information:
   • Activation Mode: Select the activation mode of the device, OTAA or ABP.
     • Choosing ABP mode creates two additional fields: Application Session Key and Network Session Key.
     • In this example, use OTAA activation mode.
   • End device (group) name: Enter the name of the end device or the group it belongs to.
   • End device description (optional): Optionally provide a description for the end device.
   • Class: Select Class A for device’s operating mode.
   • Frame Counter Width: Keep the default value.
   • LoRaWAN MAC Version: The protocol version (v1.0.3) of the end device.

Figure 10567: Add new end devices

8. After completing, click Add end devices to proceed to the next step.

Figure 10568: Add the device to the device list

9. In the Adding end devices interface, enter the device EUI in the End Device EUI (Main) field and select the Add to End Devices list button. Then click Add end devices to complete adding the end device. Then click Add end devices to complete adding the end device.

NOTE

• The device EUI configured here must match the end device. You can either obtain it by querying the end device or entering one (1) EUI and synchronously updating the corresponding value of the end device.
• If the EUI is correct, the device will be displayed in the End devices list.
• If the EUI is incorrect, the device will be displayed in the End devices with an error.

10. After selecting the device in the End devices list at the bottom left, click Add end devices to complete adding the end device.

Figure 10569: Complete the end device addition

11. Click the Add button to confirm adding the device.

Figure 10570: Confirm to add the end device

12. When finished, enter the End devices interface, where you can see the created end device.

Figure 10571: End device created

Connect the Sensor Hub to the Built-In Network Server

For specific configuration on how to connect SensorHub to the server, refer to SensorHub Network Configuration > LoRaWAN Application Scenario.

Once completed, the device will join the network. As shown in Figure 70, the end device SensorHub has successfully connected to the gateway's built-in server.

Figure 10572: Connected to Gateway Built-In Server

Configure the MQTT Integration

1. Go to the LoRa® > Configuration > Integration Interface Parameters section.

2. Toggle the Enable Integration Interface option and select Generic MQTT as the Integration mode.

Figure 10573: Set up MQTT integration

3. In the MQTT Broker Address option, enter broker.hivemq.com then click Save changes.

4. After the device has joined and has been sending uplink data, check the uplink data in ThingsBoard > Integrations > Your Integration > Events.

Figure 10574: View the gateway uplink data

Visualize Data Through ThingsBoard

1. After creating the data converter, integrating, and obtaining some data in the Event tab, check the automatically created devices based on the decoder in the Entities > Devices > Groups tab.

Figure 10575: Check the device

2. Click the group named All in the Device groups menu to automatically create a decoder device.

Figure 10576: Automatically created decoder device

3. Click the device and go to the Attributes tab, where you will see the node data.

Figure 10577: Node data

4. To visualize the data, simply select the values you wish to display, then click the Show on widget button.

Figure 10578: Data visualization

5. On the next page, select the required widget from the Current bundle dropdown menu. In this example, choose Outdoor Environment, and select the appropriate visualization chart for Humidity by clicking the slide icon ().

Figure 10579: Choose an appropriate visualization chart

6. After selecting the widget, click Add to dashboard to proceed.

7. The Add widget to dashboard window will appear. By default, there is no dashboard in the profile, so you need to select Create new dashboard and enter a name for the dashboard in the new dashboard title field. Additionally, in this dashboard, the user can add more widgets for the device.

Figure 10580: Enter the dashboard name

8. After setting the dashboard name, click the Add button to add more widgets. Alternatively, check the Open dashboard option to automatically open the created dashboard after adding the widget.

Figure 10581: Dashboard created

NOTE

If the Open dashboard option is not selected, you can still easily view the added widgets via Dashboard groups > All > [Group Name].

9. To set the appropriate name and unit of Humidity, click on Edit mode () > Edit widget () and complete the steps below:
   • Select the humidity unit in the Value column, %RH in this example;
   • Click the Apply button to apply the settings;
   • Click the exit icon () in the upper right corner, and click on Save ().

Figure 10582: Edit Dashboard

Figure 10583: Set appropriate name and unit of Humidity

NOTE

ThingsBoard visualization dashboard editor supports adjusting the size and shape of widgets by dragging the edges of the widgets in the Edit mode.

10. If the above settings are correct, the final Dashboard visualization widget should look like Figure 110.

Figure 10584: Visualization widget settings completed

11. After repeating the above steps to complete the visualization of the remaining parameters, the results are as follows:

Figure 10585: Visualization completed

NOTE

• When adding the visualizations of the remaining parameters, in the Add widget to dashboard step, you should click Select existing dashboard to select the previously created dashboard SensorHub_RAK1901&2.

• The visualization parameter values of the RAK1902 barometric pressure sensor (Temperature2 and Barometer) will be automatically rounded due to the different types of widgets selected for the data. If needed, please set the decimals in the icon edit mode.

NB-IoT/LTE CAT-M1 Application

Connect Sensor Hub to MQTT Server

In the Network Server and Visualization Configuration section, the server has been set as a public MQTT broker: broker.hivemq.com. You can also choose other brokers or servers, such as AWS IoT Core (optional), according to the actual usage scenario.

Figure 10586: NB-IoT/LTE CAT-M1 Application Scenario

Visualize Data Through Datacake

In this example, you will use Datacake as the visualization platform. Datacake is a versatile IoT platform designed to visualize data from nodes in a user-friendly manner.

To get started, create an account on the official website and log in.

Add Sensor Hub to Datacake

1. After logging in to your account, navigate to the Devices tab and click + Add Device to proceed with adding the Sensor Hub end device.

Figure 10587: Add the end device, SensorHub

2. Select the API option and click Next to proceed.

Figure 10588: Select API

3. As the device is new and there's no ready-made template, choose New Product from the Datacake Product options. Enter the device name in the Product Name field, then click Next to proceed.

Figure 10589: Select New Product

4. The SERIAL NUMBER field can be left blank. Datacake will randomly generate a serial number for the device, then click Next.

Figure 10590: Keep the serial number

5. Select the preferred subscription plan, then click Add 1 device. For this example, choose Free.

Figure 10591: Select a subscription plan

6. The registered device can now be viewed on the Devices tab.

Figure 10592: Registered device

MQTT Configuration

1. Click the name of the device you just created in the list to enter the interface, then select the Configuration tab.

Figure 10593: Copy the serial number

2. Scroll down to the API Configuration option and copy the Serial number. Save it locally for later use.

Figure 10594: Copy the serial number

3. Continue scrolling down to the MQTT Configuration option and configure the external MQTT Broker.

4. Click +Add new MQTT server and configure the relevant parameters.

Figure 10595: Configure the external MQTT Broker

5. Fill in the relevant information based on the actual server used, then click Test Connection to verify whether Datacake can successfully connect to the MQTT Broker.

Figure 10596: Configure the relevant parameters

NOTE

If SSL/TLS encryption and authentication are set for more secure communication, ensure to configure them accordingly in this section. However, for this example, you can skip this option.

6. If the connection is successful, you will see the message Connection successful. Click Add MQTT Server to complete the addition of the MQTT server.

Figure 10597: Configure the relevant parameters

7. After successfully adding the MQTT server, click on +Add Uplink Decoder to add a decoder.

Figure 10598: Configure the relevant parameters

8. A new window will appear, and fill in the fields according to your project.

Figure 10599: Add Uplink Decoder

• Subscribe to topics: Configure the subscription topics, that is, the value of the Publish Topic configured in the Network Server and Visualization Configuration section.
• Decoder function: Copy the following decoding code and paste it into the Decoder function space.

Click to view the code

function decodeToString (payload) {
return payload
.match(/.{2}/g)
.map(function (hex) {
return parseInt (hex, 16);
})
.map(function ( charCode ) {
      return String.fromCharCode(charCode);
    })
    .join("");
}


function Decoder(topic, payload) {
  var decoded = [];
  var payloadStr = decodeToString(payload);
  var data = payloadStr;
  var bytes = Array.prototype.map.call(data, function (char) {
    return char.charCodeAt(0);
  });
  console.log(bytes);


  var values = {};
  var i = 0;
  while (i < bytes.length) {
    var channelId = (bytes[i] << 8) | bytes[i + 1];
    var value;
    switch (channelId) {
      case 0x0167:
        value = (bytes[i + 2] << 8) | bytes[i + 3];
        values.temperature1 = value / 10.0;
        i += 4;
        break;
      case 0x0268:
        value = bytes[i + 2];
        values.humidity = value;
        i += 3;
        break;
      case 0x0367:
        value = (bytes[i + 2] << 8) | bytes[i + 3];
        values.temperature2 = value / 10.0;
        i += 4;
        break;
      case 0x0473:
        value = (bytes[i + 2] << 8) | bytes[i + 3];
        values.barmoeter = value / 10.0;
        i += 4;
        break;
      default:
        break;
    }
  }


  var data = {
    temperature1: values.temperature1,
    humidity: values.humidity,
    temperature2: values.temperature2,
    barmoeter: values.barmoeter,
  };


  for (var key in data) {
    if (data.hasOwnProperty(key)) {
      decoded.push ({
        device: "53f86e9f-24e6-4dd3-bc8b-07c4b7e6feb8" ,
field: key,
value: data[key],
});
}
}
return decoded;
}

NOTE

In the above code, make sure that the parameter serial_number (device: 53f86e9f-24e6-4dd3-bc8b-07c4b7e6feb8) matches the serial number saved locally earlier.

9. Once completed, click Add uplink decoder.
10. In the Fields option, click + Add Field to show the monitoring values of the devices. Each device can create a certain number of fields, also known as a data point.

Figure 10600: Add Field

11. Set the necessary parameters of the Field. For Fields with multiple data points, add them one by one. Once done, click Add Field.

Figure 10601: Set the related parameters of the field

NOTE

The Identifier field will be automatically filled based on the name.

12. Once the uplink data is received, the Current value column in the Fields list will display the current monitoring value from the sensor.

Figure 10602: Added sensor monitoring values

13. Follow Steps 11-12 to add other monitoring parameters.

Figure 10603: Add other monitoring parameters individually

NOTE

Due to the different precision of the RAK1901 and RAK1902 sensors when creating fields, select Integer for RAK1901, and Float for RAK1902.

Create a Dashboard to Visualize Data

Dashboards can be customized depending on the specific needs and preferences of a project. Follow the steps below to add widgets and visualize the data.

1. On the device details page, navigate to the Dashboard tab, then toggle on the edit mode switch ().

2. Click on the + Add Widget button to add a widget for visualizing data.

Figure 10604: Open the edit mode

3. Choose what type of widgets you want to display. For this example, select Value to visualize temperature monitoring values.

Figure 10605: Add widgets for visualizing data

4. Click on the Data tab. Choose the field for visualization from the Field options (for example, Temperature) and set the unit of the field, which is ° C.

Figure 10606: Select the visualization data field

5. After configuring the widget, click Save. You should now see the successfully created widget on the Dashboard interface.

Figure 10607: Successfully created solar radiation widget

6. To add more parameter widgets, click the +Add Widget button again with the edit mode toggle switch ON (), then repeat Steps 4-6.

Figure 10608: Close edit mode to save the settings

7. Once done with the dashboard configuration, turn OFF () the edit mode switch to save the settings.

Figure 10609: Visualization completed1