Skip to content

Add LW001 PRO device to Devices library #2422

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 2 commits into
base: master
Choose a base branch
from
Open

Add LW001 PRO device to Devices library #2422

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
fa981f1
LW001-BG PRO
stitenko Nov 3, 2025
ffccf31
Add new devices - MOKO SMART
stitenko Nov 27, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 4 additions & 1 deletion _data/hardware-partners.yml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -1162,8 +1162,11 @@
links:
general-guides:
0:
label: mokosmart LoRaWAN device
label: MOKO SMART LoRaWAN device
href: /docs/samples/moko-smart/moko-smart-guide/
1:
label: How to connect LW001-BG PRO LoRaWAN Tracker to ThingsBoard?
href: /docs/devices-library/lw001-bg-pro/
description: Leading manufacturer and provider of ODM,
OEM, and IoT devices in China. Established in 2013, created its own IoT brand,
which specializes in Bluetooth Low Energy, LoRaWAN, Wi-Fi, RFID, GPS,
Expand Down
12 changes: 12 additions & 0 deletions _data/pages_info.yml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -156,6 +156,9 @@
"/docs/devices-library/luanode32/":
url: "/docs/devices-library/luanode32/"
redirect_from: []
"/docs/devices-library/lw001-bg-pro/":
url: "/docs/devices-library/lw001-bg-pro/"
redirect_from: []
"/docs/devices-library/m5stack-timer-camera-f/":
url: "/docs/devices-library/m5stack-timer-camera-f/"
redirect_from: []
Expand Down Expand Up @@ -1186,6 +1189,9 @@
"/docs/paas/devices-library/luanode32/":
url: "/docs/paas/devices-library/luanode32/"
redirect_from: []
"/docs/paas/devices-library/lw001-bg-pro/":
url: "/docs/paas/devices-library/lw001-bg-pro/"
redirect_from: []
"/docs/paas/devices-library/m5stack-timer-camera-f/":
url: "/docs/paas/devices-library/m5stack-timer-camera-f/"
redirect_from: []
Expand Down Expand Up @@ -1547,6 +1553,9 @@
"/docs/paas/eu/devices-library/luanode32/":
url: "/docs/paas/eu/devices-library/luanode32/"
redirect_from: []
"/docs/paas/eu/devices-library/lw001-bg-pro/":
url: "/docs/paas/eu/devices-library/lw001-bg-pro/"
redirect_from: []
"/docs/paas/eu/devices-library/m5stack-timer-camera-f/":
url: "/docs/paas/eu/devices-library/m5stack-timer-camera-f/"
redirect_from: []
Expand Down Expand Up @@ -2988,6 +2997,9 @@
"/docs/pe/devices-library/luanode32/":
url: "/docs/pe/devices-library/luanode32/"
redirect_from: []
"/docs/pe/devices-library/lw001-bg-pro/":
url: "/docs/pe/devices-library/lw001-bg-pro/"
redirect_from: []
"/docs/pe/devices-library/m5stack-timer-camera-f/":
url: "/docs/pe/devices-library/m5stack-timer-camera-f/"
redirect_from: []
Expand Down
72 changes: 72 additions & 0 deletions ...ntegrations/devices-configuration/lw001-bg-pro/lw001-bg-pro-chirpstack-block.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,72 @@
### Add a device on the Chirpstack

To add a device, you can follow next steps:

- [Download the JSON file](https://github.com/LoRaWAN-Product-Decoder/MOKOSMART-LoRaWAN-Product-Decoder/blob/main/LW001-BG%20PRO%20V2/LW001-BG%20PRO%20V2%20on%20chirpstack.js){:target="_blank"} with the uplink converter settings.

{% assign AddDeviceOnChirpstack = '
===
image: /images/devices-library/ready-to-go-devices/lw001-bg-pro/1.png,
title: Login to ChirpStack server. Go to the **Device profiles** page and click on **Add device profile** button.
===
image: /images/devices-library/ready-to-go-devices/lw001-bg-pro/2.png,
title: Fill the fields.
===
image: /images/devices-library/ready-to-go-devices/lw001-bg-pro/3.png,
title: Go to the **Codec** page and paste the script just copied. Click **Submit** button.
===
image: /images/devices-library/ready-to-go-devices/lw001-bg-pro/4.png,
title: Go to the **Applications** page, and click on "**Add application**".
===
image: /images/devices-library/ready-to-go-devices/lw001-bg-pro/5.png,
title: Named your application. **Click Submit**.
===
image: /images/devices-library/ready-to-go-devices/lw001-bg-pro/6.png,
title: Open created application and press **Add device** button.
===
image: /images/devices-library/ready-to-go-devices/lw001-bg-pro/7.png,
title: Fill the parameters with values from the device configuration, then choose previously created device profile and click on **Submit** button
===
image: /images/devices-library/ready-to-go-devices/lw001-bg-pro/8.png,
title: Go to the **Variables** tab, put your **Application key** to the field and click on **Submit** button to save the device.
'
%}

{% include images-gallery.liquid showListImageTitles="true" imageCollection=AddDeviceOnChirpstack %}

### Configure application integration with ThingsBoard

{% assign configureApplicationIntegrationWithThingsBoard = '
===
image: /images/devices-library/ready-to-go-devices/lw001-bg-pro/9.png,
title: Go to the "**Integrations**" page, find and select the **ThingsBoard**.
===
image: /images/devices-library/ready-to-go-devices/lw001-bg-pro/10.png,
title: Enter the URL of your **ThingsBoard** server and click **Submit** button.
'
%}

{% include images-gallery.liquid showListImageTitles="true" imageCollection=configureApplicationIntegrationWithThingsBoard %}


### Create device on ThingsBoard

To create device on ThingsBoard, follow the next steps:

{% assign createDeviceOnThingsBoard = '
===
image: /images/devices-library/ready-to-go-devices/lw001-bg-pro/11.png,
title: **Log in** to your **ThingsBoard** account. Navigate to the **Devices** page and click the "**+**" button to add a new device.
===
image: /images/devices-library/ready-to-go-devices/lw001-bg-pro/12.png,
title: Enter the **device name** and click **Next: Credentials**.
===
image: /images/devices-library/ready-to-go-devices/lw001-bg-pro/13.png,
title: In the **Credentials** step, specify the device’s **Access token** (use the previously copied **Device EUI** value), then click **Add**.
===
image: /images/devices-library/ready-to-go-devices/lw001-bg-pro/14.png,
title: The device is now created. Click on the device to open its **details** page. Navigate to the **Latest telemetry** tab to view the data reported by the device.
'
%}

{% include images-gallery.liquid showListImageTitles="true" imageCollection=createDeviceOnThingsBoard %}
72 changes: 72 additions & 0 deletions ...ks/integrations/devices-configuration/lw001-bg-pro/lw001-bg-pro-loriot-block.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,72 @@
### Add a device on the Loriot

To add a device, you can follow next steps:

{% assign addDeviceOnLoriot = '
===
image: /images/devices-library/ready-to-go-devices/lw001-bg-pro/36.png,
title: Login to **Loriot** server. We use **eu2.loriot.io**, but it depends on chosen region during registration.
===
image: /images/devices-library/ready-to-go-devices/lw001-bg-pro/37.png,
title: Go to the **Applications** page in left menu.
===
image: /images/devices-library/ready-to-go-devices/lw001-bg-pro/38.png,
title: Open your **application**.
===
image: /images/devices-library/ready-to-go-devices/lw001-bg-pro/39.png,
title: Go to the "**Enroll Device**" page. Fill in the fields, with a configuration from your device.
===
image: /images/devices-library/ready-to-go-devices/lw001-bg-pro/40.png,
title: Then click the "**Create Device**" button.
'
%}

{% include images-gallery.liquid showListImageTitles="true" imageCollection=addDeviceOnLoriot %}

### Create integration in ThingsBoard

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

```javascript
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 of **your ThingsBoard instance** and follow these steps:
{% assign createIntegrationInThingsBoard = '
===
image: /images/devices-library/ready-to-go-devices/lw001-bg-pro/41.png,
title: Click "**plus**" icon in the upper right corner to add new integration. Select "**Loriot**" integration type. Then, click "**Next**" button.
===
image: /images/devices-library/ready-to-go-devices/lw001-bg-pro/42.png,
title: Paste the previously copied script to the **Decoder function** section. Click "**Next**" button.
===
image: /images/devices-library/ready-to-go-devices/lw001-bg-pro/43.png,
title: Leave the "Downlink data converter" field empty. Click on "**Skip**" button.
===
image: /images/devices-library/ready-to-go-devices/lw001-bg-pro/44.png,
title: Next, fill in the fields with your parameters. After, press "**Add**" button.
'
%}

{% include images-gallery.liquid showListImageTitles="true" imageCollection=createIntegrationInThingsBoard %}

### Check data on ThingsBoard

So, the device was added and if it sends any data - it should appear in the [devices](/docs/{{docsPrefix}}user-guide/ui/devices/){:target="_blank"}. To check it you may open Devices page in Entities section. The device should be in devices list. You can check the data by click on it and open tab Attributes or Latest telemetry.

{% assign checkDataOnThingsBoard = '
===
image: /images/devices-library/ready-to-go-devices/lw001-bg-pro/45.png,
title: So, the device was added and if it sends any data - it should appear in the devices. To check it you may open **Devices** page in **Entities** section. The device should be in devices list. You can check the data by click on it and open tab **Attributes** or **Latest telemetry**.
'
%}

{% include images-gallery.liquid imageCollection=checkDataOnThingsBoard %}
88 changes: 88 additions & 0 deletions ...ns/devices-configuration/lw001-bg-pro/lw001-bg-pro-thethingsindustries-block.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,88 @@
### Add a device on The Things Industries

To add a device, you can follow next steps:

{% assign addDeviceOnThingsIndustries = '
===
image: /images/devices-library/ready-to-go-devices/lw001-bg-pro/26.png,
title: Go to the **Applications** page. Then select your **application** and click on its name.
===
image: /images/devices-library/ready-to-go-devices/lw001-bg-pro/27.png,
title: Click on the **+ Register end device** button.
===
image: /images/devices-library/ready-to-go-devices/lw001-bg-pro/28.png,
title: Choose "**Enter end device specifics manually**". Then, put the **APP EUI** value to the **JoinEUI** field. Press the **Confirm** button.
===
image: /images/devices-library/ready-to-go-devices/lw001-bg-pro/29.png,
title: Fill the rest parameters and press **Register end device** button.
'
%}

{% include images-gallery.liquid showListImageTitles="true" imageCollection=addDeviceOnThingsIndustries %}

### Configure Payload Formatter

- [Download the JSON file](https://github.com/LoRaWAN-Product-Decoder/MOKOSMART-LoRaWAN-Product-Decoder/blob/main/LW001-BG%20PRO%20V2/LW001-BG%20PRO%20V2%20on%20TTN.js){:target="_blank"} with the uplink converter settings.

{% assign ConfigurePayloadFormatter = '
===
image: /images/devices-library/ready-to-go-devices/lw001-bg-pro/30.png,
title: Go to the **Payload formatters** page and select **Custom Javascript formatter** for Formatter type. Paste the decode function and click **Save changes** button.
'
%}

{% include images-gallery.liquid showListImageTitles="true" imageCollection=ConfigurePayloadFormatter %}

### Create integration in ThingsBoard

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

```javascript
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 of **your ThingsBoard instance** and follow these steps:

{% assign createIntegrationInThingsBoard = '
===
image: /images/devices-library/ready-to-go-devices/lw001-bg-pro/31.png,
title: Click "**plus**" icon in the upper right corner to add new integration. Select "**The Things Stack Industries**" integration type. Then, click "**Next**" button.
===
image: /images/devices-library/ready-to-go-devices/lw001-bg-pro/32.png,
title: Paste the previously copied script to the **Decoder function** section. Click "**Next**" button.
===
image: /images/devices-library/ready-to-go-devices/lw001-bg-pro/33.png,
title: Leave the "Downlink data converter" field empty. Click on "**Skip**" button.
===
image: /images/devices-library/ready-to-go-devices/lw001-bg-pro/34.png,
title: Next, fill in the fields with your parameters. After, press "**Add**" button.
'
%}

{% include images-gallery.liquid showListImageTitles="true" imageCollection=createIntegrationInThingsBoard %}

### Check data on ThingsBoard

So, the device was added and if it sends any data - it should appear in the [devices](/docs/{{docsPrefix}}user-guide/ui/devices/){:target="_blank"}. To check it you may open Devices page in Entities section. The device should be in devices list. You can check the data by click on it and open tab Attributes or Latest telemetry.

{% assign checkDataOnThingsBoard = '
===
image: /images/devices-library/ready-to-go-devices/lw001-bg-pro/35.png,
title: So, the device was added and if it sends any data - it should appear in the devices. To check it you may open **Devices** page in **Entities** section. The device should be in devices list. You can check the data by click on it and open tab **Attributes** or **Latest telemetry**.
'
%}

{% include images-gallery.liquid imageCollection=checkDataOnThingsBoard %}
93 changes: 93 additions & 0 deletions ...rations/devices-configuration/lw001-bg-pro/lw001-bg-pro-thethingsstack-block.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,93 @@
### Add a device on The Things Stack

To add a device, you can follow next steps:

{% assign addDeviceOnThingsStack = '
===
image: /images/devices-library/ready-to-go-devices/lw001-bg-pro/15.png,
title: Login to the cloud and open your console.
===
image: /images/devices-library/ready-to-go-devices/lw001-bg-pro/16.png,
title: Go to the **Applications** page. Then select your **application** and click on its name.
===
image: /images/devices-library/ready-to-go-devices/lw001-bg-pro/17.png,
title: Click on the **+ Register end device** button.
===
image: /images/devices-library/ready-to-go-devices/lw001-bg-pro/18.png,
title: Choose "**Enter end device specifics manually**". Then, put the **APP EUI** value to the **JoinEUI** field. Press the **Confirm** button.
===
image: /images/devices-library/ready-to-go-devices/lw001-bg-pro/19.png,
title: Fill the rest parameters and press **Register end device** button.
'
%}

{% include images-gallery.liquid showListImageTitles="true" imageCollection=addDeviceOnThingsStack %}

### Configure Payload Formatter

- [Download the JSON file](https://github.com/LoRaWAN-Product-Decoder/MOKOSMART-LoRaWAN-Product-Decoder/blob/main/LW001-BG%20PRO%20V2/LW001-BG%20PRO%20V2%20on%20TTN.js){:target="_blank"} with the uplink converter settings.

{% assign ConfigurePayloadFormatter = '
===
image: /images/devices-library/ready-to-go-devices/lw001-bg-pro/20.png,
title: Go to the **Payload formatters** page and select **Custom Javascript formatter** for Formatter type. Paste the decode function and click **Save changes** button.
'
%}

{% include images-gallery.liquid showListImageTitles="true" imageCollection=ConfigurePayloadFormatter %}

### Create integration in ThingsBoard

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

```javascript
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;
```
{:.copy-code}

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 of **your ThingsBoard instance** and follow these steps:

{% assign createIntegrationInThingsBoard = '
===
image: /images/devices-library/ready-to-go-devices/lw001-bg-pro/21.png,
title: Click "**plus**" icon in the upper right corner to add new integration. Select "**The Things Stack Community**" integration type. Then, click "**Next**" button.
===
image: /images/devices-library/ready-to-go-devices/lw001-bg-pro/22.png,
title: Paste the previously copied script to the **Decoder function** section. Click "**Next**" button.
===
image: /images/devices-library/ready-to-go-devices/lw001-bg-pro/23.png,
title: Leave the "Downlink data converter" field empty. Click on "**Skip**" button.
===
image: /images/devices-library/ready-to-go-devices/lw001-bg-pro/24.png,
title: Next, fill in the fields with your parameters. After, press "**Add**" button.
'
%}

{% include images-gallery.liquid showListImageTitles="true" imageCollection=createIntegrationInThingsBoard %}

### Check data on ThingsBoard

So, the device was added and if it sends any data - it should appear in the [devices](/docs/{{docsPrefix}}user-guide/ui/devices/){:target="_blank"}.. To check it you may open **Devices** page in **Entities** section. The device should be in devices list. You can check the data by click on it and open tab **Attributes** or **Latest telemetry**.

{% assign checkDataOnThingsBoard = '
===
image: /images/devices-library/ready-to-go-devices/lw001-bg-pro/25.png,
title: So, the device was added and if it sends any data - it should appear in the devices. To check it you may open **Devices** page in **Entities** section. The device should be in devices list. You can check the data by click on it and open tab **Attributes** or **Latest telemetry**.
'
%}

{% include images-gallery.liquid imageCollection=checkDataOnThingsBoard %}

Loading