如何将 UWB Anchor 连接至 ThingsBoard？

Hardware type: Trackers
Connectivity: LoRaWAN
Industry: Smart Cities, Security, Transportation & Logistics
Use cases: Fleet Tracking
Platforms: Community Edition, Professional Edition, Cloud

前置条件
配置
在ThingsBoard上检查数据
结论

UWB锚点采用LoRaWAN和UWB技术设计。
与周围的UWB追踪器协同计算设备间距离，定期与其他锚点同步时间，并将心跳数据传输至LoRaWAN网关。

前置条件

继续本指南前，需准备以下内容：

配置

仅当该设备通过MQTT直接与ThingsBoard通信时，需使用ThingsBoard Cloud。

使用ThingsBoard集成时，可使用本地部署的ThingsBoard PE或ThingsBoard Cloud。

若要与网络服务器创建集成，请先选择所支持的网络服务器之一：

在ChirpStack上添加网关

我们需要在 ChirpStack 上添加网关。

要添加网关，请按以下步骤操作：

登录ChirpStack服务器。进入“网关”页面，点击“添加网关”按钮。
填写名称、网关ID（根据您的网关而定，可在网关控制面板上查看），向下滚动并点击“提交”按钮。
网关已添加。在网关选项卡中可查看其状态。

登录ChirpStack服务器。进入“网关”页面，点击“添加网关”按钮。 — 登录ChirpStack服务器。进入“网关”页面，点击“**添加网关**”按钮。

填写名称、网关ID（根据您的网关而定，可在网关控制面板上查看），向下滚动并点击“提交”按钮。 — 填写名称、**网关ID**（根据您的网关而定，可在网关控制面板上查看），向下滚动并点击“提交”按钮。

在ChirpStack上添加设备配置

登录ChirpStack服务器。进入“设备配置”页面，点击 添加设备配置 按钮。
填写必填字段。
进入 Codec 选项卡，在 Payload codec 下拉菜单中选择 JavaScript functions，粘贴解码器函数。然后点击提交按钮。

登录ChirpStack服务器。进入“设备配置”页面，点击添加设备配置按钮。 — 登录ChirpStack服务器。进入“**设备配置**”页面，点击 **添加设备配置** 按钮。

进入 Codec 选项卡，在 Payload codec 下拉菜单中选择 JavaScript functions，粘贴解码器函数。然后点击提交按钮。 — 进入 **Codec** 选项卡，在 **Payload codec** 下拉菜单中选择 **JavaScript functions**，粘贴解码器函数。然后点击提交按钮。

解码函数：

// 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;
}

在ChirpStack上添加设备

进入应用页面，点击 添加应用 按钮。
输入名称并点击提交按钮。
点击 添加设备。
使用设备信息填写必填字段，并指定之前创建设备配置。
进入 Variables 选项卡，输入 ThingsBoardAccessToken 的值，点击提交按钮。
将 应用密钥 填入对应字段，点击提交按钮保存设备。

进入应用页面，点击添加应用按钮。 — 进入应用页面，点击 **添加应用** 按钮。

进入 Variables 选项卡，输入 ThingsBoardAccessToken 的值，点击提交按钮。 — 进入 **Variables** 选项卡，输入 **ThingsBoardAccessToken** 的值，点击提交按钮。

将应用密钥填入对应字段，点击提交按钮保存设备。 — 将 **应用密钥** 填入对应字段，点击提交按钮保存设备。

配置应用与ThingsBoard的集成

进入集成页面，找到并选择 ThingsBoard。
输入 ThingsBoard服务器URL，点击提交按钮。

进入集成页面，找到并选择 ThingsBoard。 — 进入集成页面，找到并选择 **ThingsBoard**。

输入 ThingsBoard服务器URL，点击提交按钮。 — 输入 **ThingsBoard服务器URL**，点击提交按钮。

在ThingsBoard上创建设备

进入设备页面。
点击 添加设备 按钮。
填写设备名称并点击 下一步：凭证 按钮。
输入设备 访问令牌（先前复制的 Device EUI 值）并点击添加按钮。
点击设备打开设备信息窗口。
进入 最新遥测数据 选项卡查看设备上报的数据。

填写设备名称并点击下一步：凭证按钮。 — 填写设备名称并点击 **下一步：凭证** 按钮。

输入设备访问令牌（先前复制的 Device EUI 值）并点击添加按钮。 — 输入设备 **访问令牌**（先前复制的 **Device EUI** 值）并点击添加按钮。

进入最新遥测数据选项卡查看设备上报的数据。 — 进入 **最新遥测数据** 选项卡查看设备上报的数据。

在The Things Stack社区版上添加网关

我们需要在 The Things Stack社区版上添加网关。

要添加网关，请按以下步骤操作：

登录云端并打开控制台。
进入主页，点击“注册网关”按钮。
填写网关信息（网关EUI）并点击“注册网关”按钮。
网关已添加。您可看到其状态为已断开连接。

填写网关信息（网关EUI）并点击“注册网关”按钮。 — 填写网关信息（网关EUI）并点击“**注册网关**”按钮。

在The Things Stack社区版上添加设备

我们需要在 The Things Stack社区版上添加设备。

要添加设备，请按以下步骤操作：

进入应用页面。然后选择您的应用并点击其名称。
点击 注册终端设备 按钮。
将 APP EUI 值填入 JoinEUI 字段。然后点击确认按钮。
填写其余参数并点击 注册终端设备 按钮。

将 APP EUI 值填入 JoinEUI 字段。然后点击确认按钮。 — 将 **APP EUI** 值填入 **JoinEUI** 字段。然后点击确认按钮。

填写其余参数并点击注册终端设备按钮。 — 填写其余参数并点击 **注册终端设备** 按钮。

配置Payload Formatter

进入 Payload formatters 页面，为 Formatter type 选择 Custom Javascript formatter。粘贴解码函数并点击 Save changes 按钮。

进入 Payload formatters 页面，为 Formatter type 选择 Custom Javascript formatter。粘贴解码器函数并点击 Save changes 按钮。 — 进入 **Payload formatters** 页面，为 **Formatter type** 选择 **Custom Javascript formatter**。粘贴解码器函数并点击 **Save changes** 按钮。

解码函数：

// 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;
}

在ThingsBoard中创建集成

接下来，我们将在ThingsBoard中创建“The Things Stack”（TTS）集成。

首先，复制以下代码，创建上行数据转换器时需要用到：

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;

在“连接”步骤中，您需要以下参数：

Region（区域）：eu1（在The Things Stack社区中注册应用所在区域）
Username（用户名）：thingsboard-application-2025-06@ttn（使用TTS集成中的 用户名）
Password（密码）：使用The Things Stack社区集成中的密码

现在，进入“集成中心”部分下的“集成”页面，按以下步骤操作：

点击右上角的“加号”图标添加新集成。选择类型“The Things Stack社区”。然后点击“下一步”按钮。
将先前复制的脚本粘贴到解码器函数区域。点击“下一步”按钮。
将“下行数据转换器”字段留空。点击“跳过”按钮。
填写您的参数，然后点击“添加”按钮。

点击右上角的“加号”图标添加新集成。选择类型“The Things Stack社区”。然后点击“下一步”按钮。 — 点击右上角的“加号”图标添加新集成。选择类型“**The Things Stack社区**”。然后点击“**下一步**”按钮。

将先前复制的脚本粘贴到解码器函数区域。点击“下一步”按钮。 — 将先前复制的脚本粘贴到解码器函数区域。点击“**下一步**”按钮。

将“下行数据转换器”字段留空。点击“跳过”按钮。 — 将“**下行数据转换器**”字段留空。点击“跳过”按钮。

在The Things Industries上添加网关

我们需要在 The Things Industries云上添加网关。

要添加网关，请按以下步骤操作：

登录云端并打开控制台。
进入主页，点击“注册网关”按钮。
填写网关信息（网关EUI）并点击“注册网关”按钮。
网关已添加。您可看到其状态为已断开连接。

在The Things Industries上添加设备

我们需要在 The Things Industries云上添加设备。

要添加设备，请按以下步骤操作：

进入应用页面。然后选择您的应用并点击其名称。
点击 注册终端设备 按钮。
将 APP EUI 值填入 JoinEUI 字段。然后点击确认按钮。
填写其余参数并点击 注册终端设备 按钮。

配置Payload Formatter

进入 Payload formatters 页面，将 Formatter type 选择为 Custom JavaScript formatter。将解码函数粘贴到编辑器中，点击 Save changes 按钮。

解码函数：

// 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;
}

在ThingsBoard中创建集成

接下来，我们将在 ThingsBoard 中创建“The Things Industries”集成。

首先，复制以下代码，创建上行数据转换器时需要用到：

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;

在“连接”步骤中，您需要以下参数：

Region（区域）：eu1（在The Things Industries控制台中注册应用所在区域）；
Username（用户名）：thingsboard-application-2025-05@lansitec-testplan（使用The Things Stack Industries集成中的 用户名）；
Password（密码）：使用The Things Industries集成中的密码。

现在，进入“集成中心”部分下的“集成”页面，按以下步骤操作：

点击右上角的“加号”图标添加新集成。选择类型“The Things Industries集成”。然后点击“下一步”按钮。
将先前复制的脚本粘贴到解码器函数区域。点击“下一步”按钮。
将“下行数据转换器”字段留空。点击“跳过”按钮。
填写您的参数，然后点击“添加”按钮。

点击右上角的“加号”图标添加新集成。选择类型“The Things Industries集成”。然后点击“下一步”按钮。 — 点击右上角的“加号”图标添加新集成。选择类型“**The Things Industries集成**”。然后点击“**下一步**”按钮。

在Loriot上添加网关

我们需要在 Loriot 上添加网关。

要添加网关，请按以下步骤操作：

登录Loriot服务器。在“网络”部分打开“示例网络”或创建新网络。
点击“添加网关”按钮。
向下滚动并选择“MultiTech Conduit AEP”。
向上滚动，将网关的 MAC地址（从 网关EUI 中去掉中间的 FFFF 或 FFFE 后得到）填入 eth0 MAC address 字段，将网关EUI填入 Custom EUI 字段。
网关已添加。您可看到其状态为已断开连接。

登录Loriot服务器。在“网络”部分打开“示例网络”或创建新网络。 — 登录Loriot服务器。在“网络”部分打开“**示例网络**”或创建新网络。

向下滚动并选择“MultiTech Conduit AEP”。 — 向下滚动并选择“**MultiTech Conduit AEP**”。

向上滚动，将网关的 MAC地址（从网关EUI 中去掉中间的 FFFF 或 FFFE 后得到）填入 eth0 MAC address 字段，将网关EUI填入 Custom EUI 字段。 — 向上滚动，将网关的 **MAC地址**（从 **网关EUI** 中去掉中间的 **FFFF** 或 **FFFE** 后得到）填入 **eth0 MAC address** 字段，将网关EUI填入 **Custom EUI** 字段。

在Loriot上添加设备

我们需要在 Loriot 上添加设备。

要添加设备，请按以下步骤操作：

登录Loriot服务器。我们使用 eu2.loriot.io，具体取决于注册时选择的区域。
在左侧菜单中进入“应用”页面。
打开您的应用，我们的示例为“SampleApp”。
进入“注册设备”页面。使用设备配置中的值填写字段，然后点击“注册”按钮。

登录Loriot服务器。我们使用 eu2.loriot.io，具体取决于注册时选择的区域。 — 登录Loriot服务器。我们使用 **eu2.loriot.io**，具体取决于注册时选择的区域。

打开您的应用，我们的示例为“SampleApp”。 — 打开您的应用，我们的示例为“**SampleApp**”。

进入“注册设备”页面。使用设备配置中的值填写字段，然后点击“注册”按钮。 — 进入“**注册设备**”页面。使用设备配置中的值填写字段，然后点击“注册”按钮。

在ThingsBoard中创建集成

接下来，我们将在ThingsBoard中创建与Loriot的集成。

首先，复制以下代码，创建上行数据转换器时需要用到：

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;