Version 6.1 by Alec Chen on 2025/04/02 16:35
Hide last authors
Alec Chen 2.1 1 **Table of Contents:**
2
Alec Chen 4.1 3 {{toc/}}
4
Alec Chen 1.1 5 = 1. Introduction =
6
7 This document guides you on integrating Dragino **-NB** and **-CB** series devices data with Thingseye.
8
9 The **NB series** devices end with the suffix **-NB**, and the **CB series** devices end with the suffix **-CB**. For example, **S31B-NB** is an **NB device**, and **S31-CB** is a **CB device**.
10
11 = 2. Prerequisites =
12
13 To complete this tutorial, you need to have certificate files. [[lns1.thingseye.io>>url:http://lns1.thingseye.io/]] is the Dragino's MQTT broker, which requires a CA certificate file, Certificate file, and the Private key file to use.
14
Alec Chen 2.2 15 If customers need to use this MQTT connection with Thingseye, they need to contact TE team to obtain three license files or click this [[link>>url:https://www.dropbox.com/scl/fo/d5s1wf36f4syv30a8laup/AK8FjVpNXYXCWodRnnQ1Hig?rlkey=jrz1ip0f0xwwq5z2m2gu1tuij&e=1&st=kl4caub0&dl=0]] to download the certificates..
Alec Chen 1.1 16
17 [[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"]]
18
19
Alec Chen 2.2 20 = 3.General MQTT Connection =
Alec Chen 1.1 21
Alec Chen 2.2 22 The NB-IoT Sensor can send packet to server use MQTT protocol.
Alec Chen 1.1 23
Alec Chen 2.2 24 Below are the commands.
Alec Chen 1.1 25
Alec Chen 2.2 26 **AT Commands:**
Alec Chen 1.1 27
Alec Chen 2.2 28 {{code language="none"}}
29 AT+PRO=3,0                           //  Set to use MQTT protocol to uplink, Payload Type select Hex payload.
30 AT+SERVADDR=120.24.4.116,1883        //  Set MQTT server address and port
31 AT+CLIENT=CLIENT                     //  Set up the CLIENT of MQTT
32 AT+UNAME=UNAME                       //  Set the username of MQTT
33 AT+PWD=PWD                           //  Set the password of MQTT
34 AT+PUBTOPIC=NSE01_PUB                //  Set the sending topic of MQTT
35 AT+SUBTOPIC=NSE01_SUB                //  Set the subscription topic of MQTT
36 {{/code}}
Alec Chen 1.1 37
Alec Chen 2.2 38 [[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"]]
Alec Chen 1.1 39
Alec Chen 2.2 40 [[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"]]
Alec Chen 1.1 41
Alec Chen 4.1 42 (% 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**##
Alec Chen 1.1 43
Alec Chen 4.1 44 (% class="mark small text-uppercase" %)##**period to a suitable interval.**##
Alec Chen 1.1 45
46 = 4. Data Converters =
47
48 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.
49
50 == 4.1 Uplink ==
51
52 In the left navigation, click **Integrations center**, and then click **Data converters**.
53
54 On the **Data converters** page, click on the ‘**+**’ button, and then click on the **Create new converter** from the dropdown menu.
55
Alec Chen 2.2 56 [[image:1743578461281-635.png]]
Alec Chen 1.1 57
Alec Chen 2.2 58
Alec Chen 1.1 59 Once you modify the decoder function, click on the **Add** button.
60
61 [[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"]]
62
63 You should see that the newly added **MQTT Uplink converter **NB/CB is listed on the **Data Converters** page.
64
65 [[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"]]
66
67 = 5. Add Integration =
68
Alec Chen 2.2 69 == 5.1. Creat new MQTT integration ==
70
Alec Chen 1.1 71 In the left navigation, click **Integrations center**, and then click **Integrations**.
72
73 On the **Integrations** page, click on the '**+**' button.
74
Alec Chen 2.2 75 [[image:1743578691561-822.png]]
76
77
Alec Chen 1.1 78 The **Add integration** window appears.
79
80 In the **Add integration** window, configure the following settings:
81
82 **Basic settings:**
83
84 * **Integration type**: MQTT
Alec Chen 2.2 85 * **Name**: MQTT integration
Alec Chen 1.1 86 * **Enable integration**: YES
Alec Chen 2.2 87 * **Debug mode**：YES
Alec Chen 1.1 88 * **Allows create devices or assets**: YES
89
90 Click **Next** button.
91
Alec Chen 2.2 92 [[image:1743578960106-916.png||height="549" width="547"]]
Alec Chen 1.1 93
94
Alec Chen 2.2 95 **Uplink/downlink  data converter:**
Alec Chen 1.1 96
Alec Chen 2.2 97 * (((
98 Next, directly select to create a new Uplink data converter .
99 )))
100
Alec Chen 1.1 101 Click **Next** button.
102
Alec Chen 2.2 103 [[image:1743581191958-140.png||height="547" width="543"]]
Alec Chen 1.1 104
Alec Chen 2.2 105
106
Alec Chen 1.1 107 **Downlink data converter:**
108
Alec Chen 2.2 109 * Next, directly select to create a new Uplink data converter .
Alec Chen 1.1 110
111 Click **Skip** button.
112
Alec Chen 2.2 113 [[image:1743581287837-189.png||height="547" width="542"]]
Alec Chen 1.1 114
Alec Chen 2.2 115
Alec Chen 1.1 116 **Connection:**
117
Alec Chen 2.2 118 * **Host**: [[lns1.thingseye.io>>url:http://lns1.thingseye.io/]]
Alec Chen 1.1 119 * **Port**: 8883
Alec Chen 2.2 120 * **Credentials **: PEM(Paste 3 certificates to boxs below)Click this [[link>>url:https://www.dropbox.com/scl/fo/d5s1wf36f4syv30a8laup/AK8FjVpNXYXCWodRnnQ1Hig?rlkey=jrz1ip0f0xwwq5z2m2gu1tuij&e=1&st=kl4caub0&dl=0]] to download the certificates.
121 * **Password:** Password or nothng
Alec Chen 1.1 122 * **Enable SSL**: YES
Alec Chen 2.2 123 * **Topic: ** **It needs to align with the device's topic.**
124 * **QoS:** 0-At most once or an MQTT QoS level
Alec Chen 1.1 125
Alec Chen 2.2 126 Click **Skip** button.
Alec Chen 1.1 127
Alec Chen 2.2 128 [[image:1743579352961-586.png||height="507" width="502"]]
Alec Chen 1.1 129
Alec Chen 2.2 130 [[image:1743580606618-281.png||height="495" width="504"]]
Alec Chen 1.1 131
132
Alec Chen 2.2 133 Click on the **Add** button.
Alec Chen 1.1 134
Alec Chen 2.2 135 You should see that the newly added integration is listed on the **Integrations** page.
Alec Chen 1.1 136
Alec Chen 2.2 137 Since we haven't received data from a device yet, the integration **Status** is shown as **Pending,  Active  instead if it have.**
Alec Chen 1.1 138
139
140
141
142
Alec Chen 2.2 143 == 5.2. Setup uplink and downlink converters ==
Alec Chen 1.1 144
Alec Chen 2.2 145 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]].
Alec Chen 1.1 146
Alec Chen 2.2 147 * **Uplink Converter**
148
149 The purpose of the decoder function is to parse the incoming data and metadata to a format that ThingsBoard can consume.
150
151 Go to the **Integrations center** -> **Data converters** page, and find that MQTT uplink converter that was newly created when the integration was created.
152
153 [[image:1743581830822-223.png]]
154
155
156 Enter edit mode and apply **MQTT uplink JS code** to this uplink converter.
157
158 [[image:1743581965585-763.png]]
159
160
161 * **Downlink Converter**
162
163 Go to the **Integrations center** -> **Data converters** page, and find that MQTT downlink converter that was newly created when the integration was created.
164
165
166 Enter edit mode and apply **MQTT downlink JS code** to this downlink converter.
167
168 [[image:1743582084494-111.png]]
169
170
Alec Chen 4.1 171 = 6. Configure Physical NB-IoT Sensor =
Alec Chen 2.2 172
Alec Chen 1.1 173 Now, let's experiment with sending data to Thingseye using a real NB-IoT device. For example, we will use the **TS01-NB**.
174
175 First, configure the NB-IoT device with the necessary MQTT settings using AT commands. Below is a list of AT commands you can use.
176
177 **AT Commands**
178
179 * **AT+PRO=3,3    **~/~/ Use MQTT to connect to Thingseye. Payload Type set to 3.
180 * **AT+SUBTOPIC=<MQTT subscribe topic> Eg: TS01-NB**
181 * **AT+PUBTOPIC=<MQTT publish topic> Eg: TS01-NB**
182 * **AT+CLIENT=null**
183 * **AT+UNAME=<MQTT Username>**
184 * **AT+PWD=<MQTT Password>**
185 * **AT+SERVADDR=<Broker address, Port>**
186
187 Test your uplink by pressing the ACT button for 1 second.
188
189
190 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.
191
192 [[image:https://wiki.dragino.com/xwiki/bin/download/Main/ThingsBoard/image-4.png?rev=1.2||alt="image-4.png"]]