Changes for page How to Uplink -NB and -CB series devices data by MQTT with Thingseye

Last modified by Alec Chen on 2025/04/02 18:03

From 6.1 to 5.1 From 8.1 to 7.1

From version 7.1

edited by Alec Chen
on 2025/04/02 17:18

Change comment: There is no comment for this version

To version 6.1

edited by Alec Chen
on 2025/04/02 16:35

Change comment: There is no comment for this version

Raw
Rendered

Summary

Page properties (2 modified, 0 added, 0 removed)
Attachments (0 modified, 0 added, 1 removed)
- 1743584347047-327.png

Details

Page properties

Title

@@ -1,1 +1,1 @@
--How to Uplink -NB and -CB series devices data by MQTT with Thingseye
++How to connect -NB and -CB series devices data by MQTT with Thingseye

Content

@@ -17,10 +17,57 @@
  [[image:https://wiki.dragino.com/xwiki/bin/download/Main/ThingsBoard/ins1.png?width=500&height=310&rev=1.1||alt="ins1.png" height="310" width="500"]]
--= (% style="color:#333333; font-family:inherit; font-size:max(23px, min(29px, 12.3333px + 1.38889vw))" %)3. Configure Thingseye's Integration(%%) =
++= 3.General MQTT Connection =
--== 3.1 Creat new MQTT integration ==
++The NB-IoT Sensor can send packet to server use MQTT protocol.
++Below are the commands.
++
++**AT Commands:**
++
++{{code language="none"}}
++AT+PRO=3,0                           //  Set to use MQTT protocol to uplink, Payload Type select Hex payload.
++AT+SERVADDR=120.24.4.116,1883        //  Set MQTT server address and port
++AT+CLIENT=CLIENT                     //  Set up the CLIENT of MQTT
++AT+UNAME=UNAME                       //  Set the username of MQTT
++AT+PWD=PWD                           //  Set the password of MQTT
++AT+PUBTOPIC=NSE01_PUB                //  Set the sending topic of MQTT
++AT+SUBTOPIC=NSE01_SUB                //  Set the subscription topic of MQTT
++{{/code}}
++
++[[image:https://wiki.dragino.com/xwiki/bin/download/Main/General%20Configure%20to%20Connect%20to%20IoT%20server%20for%20-NB%20%26%20-NS%20NB-IoT%20models/WebHome/image-20230802112413-4.png?rev=1.1||alt="image-20230802112413-4.png"]]
++
++[[image:https://wiki.dragino.com/xwiki/bin/download/Main/General%20Configure%20to%20Connect%20to%20IoT%20server%20for%20-NB%20%26%20-NS%20NB-IoT%20models/WebHome/image-20230802112413-5.png?width=987&height=530&rev=1.1||alt="image-20230802112413-5.png" height="530" width="987"]]
++
++(% class="mark small text-uppercase" %)##**Notice: MQTT protocol has a much higher power consumption compare with UDP/CoAP protocol. Please check the power analyze document and adjust the uplink**##
++
++(% class="mark small text-uppercase" %)##**period to a suitable interval.**##
++
++= 4. Data Converters =
++
++In **Thingseye**, **Data Converters** are components used to transform incoming or outgoing data between different formats, typically to convert raw telemetry data from devices into a structured format that Thingseye can understand, or vice versa.
++
++== 4.1 Uplink ==
++
++In the left navigation, click **Integrations center**, and then click **Data converters**.
++
++On the **Data converters** page, click on the ‘**+**’ button, and then click on the **Create new converter** from the dropdown menu.
++
++[[image:1743578461281-635.png]]
++
++
++Once you modify the decoder function, click on the **Add** button.
++
++[[image:https://wiki.dragino.com/xwiki/bin/download/Main/ThingsBoard/ul-data-converter-device-a.png?width=500&height=524&rev=1.1||alt="ul-data-converter-device-a.png"]]
++
++You should see that the newly added **MQTT Uplink converter **NB/CB is listed on the **Data Converters** page.
++
++[[image:https://wiki.dragino.com/xwiki/bin/download/Main/ThingsBoard/ul-data-converter-added.png?height=257&rev=1.1||alt="ul-data-converter-added.png"]]
++
++= 5. Add Integration =
++
++== 5.1. Creat new MQTT integration ==
++
  In the left navigation, click **Integrations center**, and then click **Integrations**.
  On the **Integrations** page, click on the '**+**' button.
@@ -80,7 +80,7 @@
  [[image:1743579352961-586.png||height="507" width="502"]]
--[[image:1743584347047-327.png]]
++[[image:1743580606618-281.png||height="495" width="504"]]
  Click on the **Add** button.
@@ -89,16 +89,13 @@
  Since we haven't received data from a device yet, the integration **Status** is shown as **Pending,  Active  instead if it have.**
--[[image:1743580606618-281.png||height="495" width="504"]]
--= 4. Configure Thingseye's Data Converters =
--First, you need to download the [[**MQTT uplink/downlink JS** **code**>>url:https://www.dropbox.com/scl/fo/d5s1wf36f4syv30a8laup/AK8FjVpNXYXCWodRnnQ1Hig?rlkey=jrz1ip0f0xwwq5z2m2gu1tuij&e=1&st=kl4caub0&dl=0]].
--In **Thingseye**, **Data Converters** are components used to transform incoming or outgoing data between different formats, typically to convert raw telemetry data from devices into a structured format that Thingseye can understand, or vice versa.
++== 5.2. Setup uplink and downlink converters ==
--== 4.1 Uplink ==
++First, you need to download the [[**MQTT uplink/downlink JS** **code**>>url:https://www.dropbox.com/scl/fo/d5s1wf36f4syv30a8laup/AK8FjVpNXYXCWodRnnQ1Hig?rlkey=jrz1ip0f0xwwq5z2m2gu1tuij&e=1&st=kl4caub0&dl=0]].
  * **Uplink Converter**
@@ -114,12 +114,8 @@
  [[image:1743581965585-763.png]]
--== 4.2 Downlink ==
++* **Downlink Converter**
--* (((
--**Downlink Converter**
--)))
--
  Go to the **Integrations center** -> **Data converters** page, and find that MQTT downlink converter that was newly created when the integration was created.
@@ -128,58 +128,25 @@
  [[image:1743582084494-111.png]]
--== 4.3 Simulate with MQTT.fx ==
++= 6. Configure Physical NB-IoT Sensor =
--[[image:https://wiki.dragino.com/xwiki/bin/download/Main/General%20Configure%20to%20Connect%20to%20IoT%20server%20for%20-NB%20%26%20-NS%20NB-IoT%20models/WebHome/image-20241126191118-18.png?width=835&height=605&rev=1.1||alt="image-20241126191118-18.png"]]
++Now, let's experiment with sending data to Thingseye using a real NB-IoT device. For example, we will use the **TS01-NB**.
--[[image:https://wiki.dragino.com/xwiki/bin/download/Main/General%20Configure%20to%20Connect%20to%20IoT%20server%20for%20-NB%20%26%20-NS%20NB-IoT%20models/WebHome/image-20241126193252-25.png?width=803&height=663&rev=1.1||alt="image-20241126193252-25.png"]]
++First, configure the NB-IoT device with the necessary MQTT settings using AT commands. Below is a list of AT commands you can use.
--
--= 5. Configure Physical NB-IoT Sensor =
--
--First you need to configure the certificate to the -NB node. Follow the instructions in this **[[link>>url:https://wiki.dragino.com/xwiki/bin/view/Dragino%20NB%20device%20connection%20to%20AWS%20platform%20instructions/#H4.1.2Configurecertificate]]** to configure the certificate.
--
--Screenshot of successful certificate configuration:
--
--* Configuring the CA Certificate
--
--[[image:https://wiki.dragino.com/xwiki/bin/download/Main/General%20Configure%20to%20Connect%20to%20IoT%20server%20for%20-NB%20%26%20-NS%20NB-IoT%20models/WebHome/image-20241126192009-19.png?width=697&height=431&rev=1.1||alt="image-20241126192009-19.png" height="431" width="697"]]
--
--[[image:https://wiki.dragino.com/xwiki/bin/download/Main/General%20Configure%20to%20Connect%20to%20IoT%20server%20for%20-NB%20%26%20-NS%20NB-IoT%20models/WebHome/image-20241126192130-21.png?width=694&height=426&rev=1.1||alt="image-20241126192130-21.png" height="426" width="694"]]
--
--* Configure client certificate
--
--[[image:https://wiki.dragino.com/xwiki/bin/download/Main/General%20Configure%20to%20Connect%20to%20IoT%20server%20for%20-NB%20%26%20-NS%20NB-IoT%20models/WebHome/image-20241126192246-22.png?width=693&height=397&rev=1.1||alt="image-20241126192246-22.png" height="397" width="693"]][[image:https://wiki.dragino.com/xwiki/bin/download/Main/General%20Configure%20to%20Connect%20to%20IoT%20server%20for%20-NB%20%26%20-NS%20NB-IoT%20models/WebHome/image-20241126192315-23.png?width=645&height=402&rev=1.1||alt="image-20241126192315-23.png" height="402" width="645"]]
--
--* Configure client private key
--
--[[image:https://wiki.dragino.com/xwiki/bin/download/Main/General%20Configure%20to%20Connect%20to%20IoT%20server%20for%20-NB%20%26%20-NS%20NB-IoT%20models/WebHome/image-20241126192415-24.png?width=737&height=435&rev=1.1||alt="image-20241126192415-24.png" height="435" width="737"]]
--
--When the certificate is configured, burn the boot program, burn the working firmware, and then restart the device.
--
--Then configure the -NB node to connect to the ThingsEye platform:
--
  **AT Commands**
--* **AT+PRO=3,5      **~/~/ Use MQTT Connection & Json Payload
--* **AT+SERVADDR=lns1.thingseye.io,8883**
--* **AT+SUBTOPIC=8899     **~/~/ Consistent with the Topic of MQTT integration created by ThingsEye
--* **AT+PUBTOPIC=8899     **~/~/ Consistent with the Topic of MQTT integration created by ThingsEye
--* **AT+CLIENT=NULL**
--* **AT+UNAME=NULL**
--* **AT+PWD=NULL**
--* **AT+TLSMOD=1,2**
++* **AT+PRO=3,3    **~/~/ Use MQTT to connect to Thingseye. Payload Type set to 3.
++* **AT+SUBTOPIC=<MQTT subscribe topic> Eg: TS01-NB**
++* **AT+PUBTOPIC=<MQTT publish topic> Eg: TS01-NB**
++* **AT+CLIENT=null**
++* **AT+UNAME=<MQTT Username>**
++* **AT+PWD=<MQTT Password>**
++* **AT+SERVADDR=<Broker address, Port>**
--Test Uplink by click the button for 1~~3 seconds, the MQTT integration in ThingsEye allows you to view the data upstream from the device:
++Test your uplink by pressing the ACT button for 1 second.
++
--[[image:https://wiki.dragino.com/xwiki/bin/download/Main/General%20Configure%20to%20Connect%20to%20IoT%20server%20for%20-NB%20%26%20-NS%20NB-IoT%20models/WebHome/image-20241126193458-26.png?width=1012&height=375&rev=1.1||alt="image-20241126193458-26.png" height="375" width="1012"]]
++The following image shows the uplink payload of a real Dragino device. The publish topic is '**TS01-NB' that contains fields in the payload, IMEI, IMSI, Model, temperature, etc**. Note that we have created a device named **TS01-NB** in the **Devices** section in advance.
--[[image:https://wiki.dragino.com/xwiki/bin/download/Main/General%20Configure%20to%20Connect%20to%20IoT%20server%20for%20-NB%20%26%20-NS%20NB-IoT%20models/WebHome/image-20241126193609-27.png?width=1014&height=424&rev=1.1||alt="image-20241126193609-27.png" height="424" width="1014"]]
--
--Go to **"Device" ** -> ** "Search Device"**, enter the ** IMEI** of the device to find the device.
--
--[[image:https://wiki.dragino.com/xwiki/bin/download/Main/General%20Configure%20to%20Connect%20to%20IoT%20server%20for%20-NB%20%26%20-NS%20NB-IoT%20models/WebHome/image-20241126194018-28.png?width=1076&height=318&rev=1.1||alt="image-20241126194018-28.png" height="318" width="1076"]]
--
--You can view the data that has just been uplink on the device:
--
--[[image:https://wiki.dragino.com/xwiki/bin/download/Main/General%20Configure%20to%20Connect%20to%20IoT%20server%20for%20-NB%20%26%20-NS%20NB-IoT%20models/WebHome/image-20241126194123-29.png?width=1073&height=486&rev=1.1||alt="image-20241126194123-29.png" height="486" width="1073"]]
++[[image:https://wiki.dragino.com/xwiki/bin/download/Main/ThingsBoard/image-4.png?rev=1.2||alt="image-4.png"]]

1743584347047-327.png

Author

...	...	@@ -1,1 +1,0 @@
1		-XWiki.Alec

Size

...	...	@@ -1,1 +1,0 @@
1		-126.3 KB

Content

Changes for page How to Uplink -NB and -CB series devices data by MQTT with Thingseye

Summary

Details

Applications

Navigation