RAK Logo Registered
About 5G

How to Visualize Your Sensor Data on Datacake Using the Chirpstack Server

Environment Sensor Datacake is a multi-purpose, low-code IoT platform that makes it quite easy to create a custom IoT application. I wanted to give it a try for a simple visualization of my WisBlock Environment application.

Here, I want to show you how simple it is to forward your sensor data from a WisBlock environment sensor node to Datacake and create the visualization.

What is not covered here:

What I will show you here:


Setup the HTTP Integration in the Chirpstack Server

Setting up the HTTP integration to forward data to Datacake is a piece of cake 😃 — literally.


Open your Chirpstack web interface and go to your application. (Again, here I assume you have already setup your Chirpstack server and created an application).


Chirpstack Application Overview

Open your application, so that you see all of your connected devices. At this point, you should write down the Device EUI of the node you want to connect to Datacake. You will need it later in Datacake!


Chirpstack Application Devices

Select the Integrations tab. It will show you the integrations that Chirpstack has already implemented.


Chirpstack Application Integrations

For Datacake, we will use the HTTP integration. Just click on the ADD button.
In the window that opens, we just have to do three things:

  1. Select JSON as Payload marshaler.
  2. Add the Datacake API URL https://api.datacake.co/integrations/lorawan/chirpstack/. The URL's for other LPWAN servers can be found here: Datacake LPWAN Get Started.
  3. Push the UPDATE INTEGRATION button.

Chirpstack Application HTTP Integration

And that's all — as I said, piece of cake. 🍰 😃

From now on, Chirpstack will forward the data coming from your sensor node to Datacake.

Now, it's time to setup your visualization.

Setup a Device in Your Datacake Application

Here, I assume that you have already setup your Datacake account, created your application, and are ready to add a device. If not, please go the documentation of Datacake. They have good tutorials on how to get everything up and running.

In the Datacake application, click on Devices to see an overview of your devices. Click on the Add Device button to start.


Datacake Add Device Step 1

In the next screen, select LoRaWAN and New Product. RAKwireless WisBlock devices are not yet available as templates, but I hope this will change soon.


Datacake Add Device Step 2

Add your Product Name and push the Next button.


Datacake Add Device Step 3

Then, scroll down the window until you see the Network Server section. Search for Chirpstack here, select it, and click the Next button.


Datacake Add Device Step 4

In the next step you have to enter the Dev EUI of your node and a name. The Dev EUI must match the node that you chose earlier in the Chirpstack Application. Once you have entered the information, hit the Next button again.


Datacake Add Device Step 5

Depending your account at Datacake and how many devices you have already registered, select between the different payment options. Luckily for me, I had a coupon, which allowed me to use Extended Free for this new device. Once done here, push the Add 1 device button.


Datacake Add Device Step 6

Okay, we're getting closer. You can now see the new device in the Devices overview screen of Datacake. It is not yet shown as connected because no valid data was received yet.


Datacake Add Device Step 7

Create the Data Parser and Data Fields for Your Sensor Node in Datacake

To finish the configuration of the device, click on it in the overview. In the next window, select Configuration.


Datacake Setup Device Step 1

In configuration, scroll down until you see the LoRaWAN section. Verify here that the DevEUI is correct and that the Network Server is indeed Chirpstack.


Datacake Setup Device Step 2

Continue to scroll down until you see the Payload Decoder section. Here, you'll have to enter our custom payload decoder for the arriving data. As you can see in the image, the decoder is returning a nested JSON array where each JSON entry has two fields: field and value. field will later be needed for the visualization and value is the sensor data.


Datacake Setup Device Step 3

To make things easier, I have a payload decoder prepared that will work with this example and can be easily extended to use with our other WisBlock Solutions.

To save you all the typing, I leave it here for you to copy and paste. Overwrite the example payload decoder with the following:

function Decoder(payload, port) {
    if(payload[0] === 0x01) {
        return [
            {
                field: "TEMPERATURE",
                value: (payload[1] << 8 | payload[2]) / 100
            },
            {
                field: "HUMIDITY",
                value: (payload[3] << 8 | + payload[4]) / 100
            },
            {
                field: "PRESSURE",
                value: (payload[8] | (payload[7] << 8) | (payload[6] << 16) | (payload[5] << 24)) / 100
            },
            {
                field: "GAS",
                value: payload[12] | (payload[11] << 8) | (payload[10] << 16) | (payload[9] << 24)
            },
            {
                field: "COUNTER",
                value: payload[16] | (payload[15] << 8) | (payload[14] << 16) | (payload[13] << 24)
            }
        ];
    }
    if(payload[0] === 0x02) {
        return [
            {
                field: "TEMPERATURE",
                value: (payload[1] << 8 | payload[2]) / 100
            },
            {
                field: "HUMIDITY",
                value: (payload[3] << 8 | + payload[4]) / 100
            },
            {
                field: "COUNTER",
                value: payload[8] | (payload[7] << 8) | (payload[6] << 16) | (payload[5] << 24)
            }
        ];
    }
    if(payload[0] === 0x03) {
        return [
            {
                field: "LIGHT",
                value: (payload[4] | (payload[3] << 8) | (payload[2] << 16) | (payload[1] << 24)) / 100
            },
            {
                field: "COUNTER",
                value: payload[8] | (payload[7] << 8) | (payload[6] << 16) | (payload[5] << 24)
            }
        ];
    }
    if(payload[0] === 0x04) {
        return [
            {
                field: "COUNTER",
                value: payload[4] | (payload[3] << 8) | (payload[2] << 16) | (payload[1] << 24)
            }
        ];
    }
}

Datacake Setup Device Step 4

Now, let's check if the decoder works. Scroll further down and hit the Save button to update the decoder.


Datacake Setup Device Step 5

Then, scroll all the way up and select the Debug tab. If your device is online and already sending data, you can see the results of the decoder in the Debug Log.


Datacake Setup Device Step 6

If that works, you'll next have to do some more entry work. Datacake uses the fields to find the correct data for the visualization, but you have to define all of the fields first.

Go back to the configuration tab and scroll down until you see the Fields section. Once you're there, click the Add Field button.


Datacake Setup Device Step 7

In the Add Field window, select the data type, name for the field, and unit.

Important: The Identifier  must match the field name that is assigned in the payload decoder. So, for Temperature, the correct field name is TEMPERATURE.

After entering all information, hit the Add Field button.


Datacake Setup Device Step 8

You have to repeat this step until you've defined all four fields that will contain the sensor data. In the end, your Fields section should look like this:


Datacake Setup Device Step 9

At this point, we're done with the preparations. Now, let's go and show the data with some nice charts.


Setup Your Dashboard to Visualize the Incoming Sensor Data

Get back to your device overview and open the Dashboard tab. For now, it's empty. To add a new widget, click on the small edit icon on the right side.


Datacake Setup Dashboard Step 1

Now, you will see an Add Widget button. Click on it to start.


Datacake Setup Dashboard Step 2

In the next screen, you'll see a selection of different visualization options. I chose Chart here.


Datacake Setup Dashboard Step 3

The next window has four tabs. Start with the Basic tab. You can enter the chart title here.


Datacake Setup Dashboard Step 4

In the Devices tab, click on Add Device.


Datacake Setup Dashboard Step 5

The window will extend and you can select the Field, which represents the data you want to visualize.


Datacake Setup Dashboard Step 6

After selecting Temperature, you can choose a color for this data and change the display name (optional).


Datacake Setup Dashboard Step 7

On the Axis tab, you can define the Unit of the data and set the MIN and MAX values to be displayed (optional). I left it here on 0 for the min value and auto for the max value.


Datacake Setup Dashboard Step 8

In the last tab—the Timeframe tab—you can set how much data should be displayed. Since we just started receiving data here, I chose This hour. You can change this later once more data is available.


Datacake Setup Dashboard Step 9

The preview will now already show some data. Click Save to go back to the dashboard edit window.


Datacake Setup Dashboard Step 10

It will now show your first widget with the temperature data. You can resize it with the small arrow in the lower right corner of the widget.


Datacake Setup Dashboard Step 11

After repeating these steps for other fields—Humidity, Pressure, and Air Quality— you can see the charts with the received data. Click on the yellow icon next to Unsaved changes to go save your work and go back to the main dashboard view.


Datacake Setup Dashboard Step 12

Well, RAKstars, that's all. Now, you have the data from your environment sensor in a nice visualization that you can access and see from anywhere.

I hope this short tutorial was helpful.