How to connect UWB Anchor to ThingsBoard?

Add a gateway on the Chirpstack

We need to add a gateway on the Chirpstack.

To add a gateway, follow next steps:

• Login to Chirpstack server. Go to the “Gateways” page and click on the “Add gateway” button.

• Fill name, Gateway ID (It will be different, you can find it on the gateway control panel) with your data, scroll down and click on the “Submit” button.

• The gateway is added. In gateways tab you can see its status.

Add device profile on the Chirpstack

• Login to Chirpstack server. Go to the “Device profiles” page and click on Add device profile button.

• Fill in the required fields.

• Go to the Codec tab, select JavaScript functions from the Payload codec dropdown menu, and paste the decoder function. Then click the Submit button.

Decode function:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
// UWB Anchor decoder
function decodeUplink(input) {
// bytes
    var bytes = input.bytes;
// type
    var type = (bytes[0] >> 4) & 0x0f;
    switch (type) {
        case 0x01:
            return {data: decodeRegistration(bytes)};
        case 0x02:
            return {data: decodeHeartbeat(bytes)};
        default:
            return;
    }
}

// type: 0x1 Registrationfunction decodeRegistration(bytes) {
var data = {};
data.type = "RegistrationMessage";
data.softwareVersion = ((bytes[1] << 8) & 0xff00) | (bytes[2] & 0xff);
data.hardwareVersion = ((bytes[3] << 8) & 0xff00) | (bytes[4] & 0xff);
data.deviceState =
    (bytes[5] << 24) | (bytes[6] << 16) | (bytes[7] << 8) | bytes[8];
data.lorSynPeriod = bytes[9];
data.lorSynFreq =
    (bytes[10] << 24) | (bytes[11] << 16) | (bytes[12] << 8) | bytes[13];
data.lorSynDr = bytes[14];
data.heartbeatPeriod = ((bytes[15] << 8) & 0xff00) | (bytes[16] & 0xff);
data.messageId = ((bytes[17] << 8) & 0xff00) | (bytes[18] & 0xff);
return data;
}

// type: 0x2 Heartbeat
function decodeHeartbeat(bytes) {
    var data = {};
    data.type = "HeartbeatMessage";
    data.deviceState =
        (bytes[1] << 24) | (bytes[2] << 16) | (bytes[3] << 8) | bytes[4];
    data.powerVol = bytes[5];
    data.powerPersent = bytes[6];
    data.uwbRangeCount = bytes[7];
    data.bleOnCount = bytes[8];
    data.gnssOnCount = bytes[9];
    data.temperature = ((bytes[10] << 8) & 0xff00) | (bytes[11] & 0xff);
    data.movementTime = ((bytes[12] << 8) & 0xff00) | (bytes[13] & 0xff);
    data.wearTime = ((bytes[14] << 8) & 0xff00) | (bytes[15] & 0xff);
    data.chargeTime = ((bytes[16] << 8) & 0xff00) | (bytes[17] & 0xff);
    data.messageId = ((bytes[18] << 8) & 0xff00) | (bytes[19] & 0xff);
    return data;
}

Add a device on the Chirpstack

• Go to the Applications page and click on Add application button.

• Enter name and click Submit button.

• Click Add device.

• Fill in the required fields with your device information and specify the previously created device profile.

• Go to the Variables tab, enter the value for ThingsBoardAccessToken, and click the Submit button.

• Put your Application key to the field and click on Submit button to save the device.

Configure application integration with ThingsBoard

• Go to the Integrations page, find and select the ThingsBoard.

• Enter the URL of your ThingsBoard server and click Submit button.

Create device on ThingsBoard

• Go to the Devices page.

• Click on Add device button.

• Fill in the device name and click the Next: Credentials button.

• Enter the device Access token (previously copied Device EUI value) and click the Add button.

• Click on the device to open device information window.

• Go to the Latest telemetry tab to view device reported data.

Add a gateway on The Things Stack Community Edition

We need to add a gateway on The Things Stack Community Edition.

To add a gateway, you can follow next steps:

• Login to the cloud and open your console.

• Go to the Home page press the “Register gateway” button.

• Put information about the gateway (gateway EUI) and click the “Register gateway“button.

• The gateway is added. You can see its status - disconnected.

Add a device on The Things Stack Community Edition

We need to add a device on The Things Stack Community Edition.

To add a device, you can follow next steps:

• Go to the Applications page. Then select your application and click on its name.

• Click on the Register end device button.

• Put the APP EUI value to the JoinEUI field. Then, press the Confirm button.

• Fill the rest parameters and press Register end device button.

Configure Payload Formatter

Go to the Payload formatters page and select Custom Javascript formatter for Formatter type. Paste the decode function and click Save changes button.

Decode function:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
// UWB Anchor decoder
function decodeUplink(input) {
// bytes
    var bytes = input.bytes;
// type
    var type = (bytes[0] >> 4) & 0x0f;
    switch (type) {
        case 0x01:
            return {data: decodeRegistration(bytes)};
        case 0x02:
            return {data: decodeHeartbeat(bytes)};
        default:
            return;
    }
}

// type: 0x1 Registration
function decodeRegistration(bytes) {
    var data = {};
    data.type = "RegistrationMessage";
    data.softwareVersion = ((bytes[1] << 8) & 0xff00) | (bytes[2] & 0xff);
    data.hardwareVersion = ((bytes[3] << 8) & 0xff00) | (bytes[4] & 0xff);
    data.deviceState =
        (bytes[5] << 24) | (bytes[6] << 16) | (bytes[7] << 8) | bytes[8];
    data.lorSynPeriod = bytes[9];
    data.lorSynFreq =
        (bytes[10] << 24) | (bytes[11] << 16) | (bytes[12] << 8) | bytes[13];
    data.lorSynDr = bytes[14];
    data.heartbeatPeriod = ((bytes[15] << 8) & 0xff00) | (bytes[16] & 0xff);
    data.messageId = ((bytes[17] << 8) & 0xff00) | (bytes[18] & 0xff);
    return data;
}

// type: 0x2 Heartbeat
function decodeHeartbeat(bytes) {
    var data = {};
    data.type = "HeartbeatMessage";
    data.deviceState =
        (bytes[1] << 24) | (bytes[2] << 16) | (bytes[3] << 8) | bytes[4];
    data.powerVol = bytes[5];
    data.powerPersent = bytes[6];
    data.uwbRangeCount = bytes[7];
    data.bleOnCount = bytes[8];
    data.gnssOnCount = bytes[9];
    data.temperature = ((bytes[10] << 8) & 0xff00) | (bytes[11] & 0xff);
    data.movementTime = ((bytes[12] << 8) & 0xff00) | (bytes[13] & 0xff);
    data.wearTime = ((bytes[14] << 8) & 0xff00) | (bytes[15] & 0xff);
    data.chargeTime = ((bytes[16] << 8) & 0xff00) | (bytes[17] & 0xff);
    data.messageId = ((bytes[18] << 8) & 0xff00) | (bytes[19] & 0xff);
    return data;
}

Create integration in ThingsBoard

Next we will create “The Things Stack” (TTS) integration inside the ThingsBoard.

At first, copy the code, we will need it to create the uplink converter:

1
2
3
4
5
6
7
8
9
10
11
var data = decodeToJson(payload);
var deviceName = data.end_device_ids.device_id;
var deviceType = data.end_device_ids.application_ids.application_id;

var result = {
  deviceName: deviceName,
  deviceType: deviceType,
  telemetry: data.uplink_message.decoded_payload
};

return result;

In the “Connect“step, you will need the following parameters:

• Region: eu1 (region where your application was registered inside The Things Stack Community)
• Username: thingsboard-application-2025-06@ttn (use Username from integration on TTS)
• Password: use Password from integration on The Things Stack Community

Now, navigate to the “Integrations” page under the “Integrations center” section and follow this steps:

• Click “plus” icon in the upper right corner to add new integration. Select type “The Things Stack Community”. Then, click “Next” button.

• Paste the previously copied script to the Decoder function section. Click “Next” button.

• Leave the “Downlink data converter” field empty. Click on “Skip” button.

• Next, fill in the fields with your parameters. After, press “Add” button.

Add a gateway on The Things Industries

We need to add a gateway on The Things Industries cloud.

To add a gateway, you can follow next steps:

• Login to the cloud and open your console.

• Go to the Home page press the “Register gateway” button.

• Put information about the gateway (gateway EUI) and click the “Register gateway“button.

• The gateway is added. You can see its status - disconnected.

Add a device on The Things Industries

We need to add a device on The Things Industries cloud.

To add a device, you can follow next steps:

• Go to the Applications page. Then select your application and click on its name.

• Click on the Register end device button.

• Put the APP EUI value to the JoinEUI field. Then, press the Confirm button.

• Fill the rest parameters and press Register end device button.

Configure Payload Formatter

Go to the Payload formatters page and select Custom JavaScript formatter as the Formatter type. Paste the decode function into the editor and click the Save changes button.

Decode function:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
// UWB Anchor decoder
function decodeUplink(input) {
// bytes
    var bytes = input.bytes;
// type
    var type = (bytes[0] >> 4) & 0x0f;
    switch (type) {
        case 0x01:
            return {data: decodeRegistration(bytes)};
        case 0x02:
            return {data: decodeHeartbeat(bytes)};
        default:
            return;
    }
}

// type: 0x1 Registration
function decodeRegistration(bytes) {
    var data = {};
    data.type = "RegistrationMessage";
    data.softwareVersion = ((bytes[1] << 8) & 0xff00) | (bytes[2] & 0xff);
    data.hardwareVersion = ((bytes[3] << 8) & 0xff00) | (bytes[4] & 0xff);
    data.deviceState =
        (bytes[5] << 24) | (bytes[6] << 16) | (bytes[7] << 8) | bytes[8];
    data.lorSynPeriod = bytes[9];
    data.lorSynFreq =
        (bytes[10] << 24) | (bytes[11] << 16) | (bytes[12] << 8) | bytes[13];
    data.lorSynDr = bytes[14];
    data.heartbeatPeriod = ((bytes[15] << 8) & 0xff00) | (bytes[16] & 0xff);
    data.messageId = ((bytes[17] << 8) & 0xff00) | (bytes[18] & 0xff);
    return data;
}

// type: 0x2 Heartbeat
function decodeHeartbeat(bytes) {
    var data = {};
    data.type = "HeartbeatMessage";
    data.deviceState =
        (bytes[1] << 24) | (bytes[2] << 16) | (bytes[3] << 8) | bytes[4];
    data.powerVol = bytes[5];
    data.powerPersent = bytes[6];
    data.uwbRangeCount = bytes[7];
    data.bleOnCount = bytes[8];
    data.gnssOnCount = bytes[9];
    data.temperature = ((bytes[10] << 8) & 0xff00) | (bytes[11] & 0xff);
    data.movementTime = ((bytes[12] << 8) & 0xff00) | (bytes[13] & 0xff);
    data.wearTime = ((bytes[14] << 8) & 0xff00) | (bytes[15] & 0xff);
    data.chargeTime = ((bytes[16] << 8) & 0xff00) | (bytes[17] & 0xff);
    data.messageId = ((bytes[18] << 8) & 0xff00) | (bytes[19] & 0xff);
    return data;
}

Create integration in ThingsBoard

Next, we will create the “TheThingsIndustries” integration inside the ThingsBoard.

At first, copy the code, we will need it to create the uplink converter:

1
2
3
4
5
6
7
8
9
10
11
var data = decodeToJson(payload);
var deviceName = data.end_device_ids.device_id;
var deviceType = data.end_device_ids.application_ids.application_id;

var result = {
  deviceName: deviceName,
  deviceType: deviceType,
  telemetry: data.uplink_message.decoded_payload
};

return result;

In the “Connect“step, you will need the following parameters:

• Region: eu1 (region where your application was registered inside The Things Industries Console);
• Username: thingsboard-application-2025-05@lansitec-testplan (use Username from integration on The Things Stack Industries);
• Password: use Password from integration on The Things Industries.

Now, navigate to the “Integrations” page under the “Integrations center” section and follow this steps:

• Click “plus“icon in the upper right corner to add new integration. Select type “The Things Industries Integration”. Then, click “Next” button.

• Paste the previously copied script to the Decoder function section. Click “Next” button.

• Leave the “Downlink data converter“field empty. Click on “Skip“button.

• Next, fill in the fields with your parameters. After, press “Add” button.

Add a gateway on the Loriot

We need to add a gateway on the Loriot.

To add a gateway, you can follow next steps:

• Login to Loriot server. Open the “Sample network” or create a new one in the “Networks” section.

• Click on the “Add Gateway” button.

• Scroll down and select “MultiTech Conduit AEP”.

• Scroll up and put information about the gateway MAC Address (Just remove FFFF or FFFE in the middle of gateway EUI) into eth0 MAC address and gateway EUI to Custom EUI field.

• The gateway is added. You can see its status - disconnected.

Add a device on the Loriot

We need to add a device on the Loriot.

To add a device, you can follow next steps:

• Login to Loriot server. We use eu2.loriot.io, but it depends on chosen region during registration.

• Go to the “Applications” page in left menu.

• Open your application, in our case it is “SampleApp”.

• Go to the “Enroll Device” page. Fill in the fields, with a configuration from your device. Then click the “Enroll” button.

Create integration in ThingsBoard

Next we will create an integration with Loriot inside the ThingsBoard.

At first, copy the code, we will need it to create the uplink converter:

1
2
3
4
5
6
7
8
9
10
11
var data = decodeToJson(payload);
var deviceName = data.end_device_ids.device_id;
var deviceType = data.end_device_ids.application_ids.application_id;

var result = {
  deviceName: deviceName,
  deviceType: deviceType,
  telemetry: data.uplink_message.decoded_payload
};

return result;

Now, navigate to the “Integrations” page under the “Integrations center” section and follow this steps:

• Click “plus” icon button in the upper right corner to add new integration. Select type “Loriot”. Then, click “Next” button.

• Paste the previously copied script to the Decoder function section. Click “Next” button.

• Leave the “Downlink data converter” field empty. Click on “Skip“button.

• Next, fill in the fields with your parameters. After, press “Add” button.