Changes for page ThingsBoard
Last modified by Dilisi S on 2025/04/23 19:23
Summary
-
Page properties (1 modified, 0 added, 0 removed)
-
Attachments (1 modified, 0 added, 9 removed)
Details
- Page properties
-
- Content
-
... ... @@ -22,10 +22,7 @@ 22 22 To complete this tutorial, you need to have the following: 23 23 24 24 * ThingsBoard cloud account 25 -* MQTT Broker (public or private) such as, 26 -** **[[HiveMQ Cloud>>https://www.hivemq.com]] - You can create a free account to try it or subscribe for a paid account. - We use HiveMQ Cloud as the MQTT broker to build example in this tutorial.** 27 -** [[emqx>>https://www.emqx.com/zh/mqtt/public-mqtt5-broker]] - The public MQTT server is only used for MOTT learning and testing, and should not be used in the production environment. 28 -** [[lns1.thingseye.io>>http://lns1.thingseye.io/]] - This is Dragino's MQTT broker, which requires a CA certificate to use. 25 +* HiveMQ Cloud account 29 29 30 30 == 2.1 ThingsBoard Cloud == 31 31 ... ... @@ -69,9 +69,7 @@ 69 69 70 70 == 2.2 HiveMQ Cloud == 71 71 72 -=== 2.2.1 HiveMQ Cloud === 73 73 74 - 75 75 Go to [[https:~~/~~/www.hivemq.com>>https://www.hivemq.com]] 76 76 77 77 Click on the **Start Free** button. ... ... @@ -146,195 +146,126 @@ 146 146 You will need these MQTT connection parameters when configuring the MQTT integration in the '**Add Integration**' section. 147 147 148 148 149 -= ==2.2.2emqx===144 += 3. Data Converters = 150 150 151 151 152 -Th e[[emqx>>https://www.emqx.com/zh/mqtt/public-mqtt5-broker]]publicMQTT serverisonlyused forMOTTlearningandtesting,andshould notbeusedintheproduction environment.147 +In **ThingsBoard**, **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 ThingsBoard can understand, or vice versa. 153 153 154 154 155 - [[image:emqx.png||height="420"width="500"]]150 +== 3.1 Uplink == 156 156 157 157 158 - === 2.2.3Ins1.thingseye.io===153 +In the left navigation, click **Integrations center**, and then click **Data converters**. 159 159 160 -[[lns1.thingseye.io>>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. 161 161 162 -If customers need to use this MQTT connection with ThingsBoard, they need to contact the TE team to obtain three license files. 163 163 164 -[[image: ins1.png||height="310" width="500"]]157 +[[image:data-converters-list-empty.png]] 165 165 166 166 167 -(% class="wikigeneratedid" %) 168 -= 3. Creating Devices = 160 +On the **Data converters** page, click on the ‘**+**’ button, and then click on the **Create new converter** from the dropdown menu. 169 169 170 170 171 -First, you need to create devices in ThingsBoard to represent your physical devices. For example, you can name it **Device A**, and the second device could be **Device B** or any name you prefer. The device name should be unique within the **Devices** space. 172 172 164 +[[image:create-new-converter-menu.png||height="259" width="500"]] 173 173 174 -In the left navigation, click Entities -> Devices. 175 175 176 - Click theDevice** button(thebutton withthe+** sign),andfromthedropdown menu,clickAdd new device**.167 +The **Add data converter** window will appear. Name it ‘**MQTT Uplink Converter NB/CB**’ and select the Type as **Uplink**. 177 177 178 - In theAddnewdevice**dialogbox,enter the devicename in theName** textbox.For example,wewilluse**DeviceA**.169 +Click on the **TBEL** button if not selected it by default. Delete the existing decoder function in the code editor. Now copy and paste the following decoder function written in **TBEL (ThingsBoard Expression Language)** in to the **code editor**. This decoder function is compatible for both NB and CB series devices. 179 179 180 -Click the **Add** button. 171 +{{code language="JavaScript"}} 172 +/** Decoder **/ 181 181 182 -Skip the **connectivity testing** by clicking the **Close** button. 174 +// decode payload to string 175 +var payloadStr = decodeToString(payload); 176 +var data = JSON.parse(payloadStr); 183 183 184 -The device is created and listed on the **Devices** page. Note that its initial state is **Inactive** because it has not received any data yet. 178 +var deviceName = metadata.topic.split("/")[3]; 179 +// decode payload to JSON 180 +var deviceType = 'sensor'; 185 185 182 +// Result object with device attributes/telemetry data 183 +var result = { 184 + deviceName: deviceName, 185 + deviceType: deviceType, 186 + attributes: { 187 + integrationName: metadata['integrationName'], 188 + }, 189 + telemetry: { 190 + temperature: data.temperature, 191 + humidity: data.humidity, 192 + } 193 +}; 186 186 187 - =4.DataConverters=195 +/** Helper functions 'decodeToString' and 'decodeToJson' are already built-in **/ 188 188 197 +return result; 198 +{{/code}} 189 189 190 -In **ThingsBoard**, **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 ThingsBoard can understand, or vice versa. 191 191 201 +Click on the **Add** button. 192 192 193 -== 4.1 Uplink == 194 194 195 195 196 - In the left navigation, click **Integrations center**,andthen click**Datas**.205 +[[image:add-uplink-data-converter.png||height="529" width="500"]] 197 197 198 198 199 - [[image:data-converters-list-empty.png]]208 +You should see that the newly added **MQTT Uplink converter **NB/CB is listed on the **Data Converters** page. 200 200 210 +[[image:data-converter-list-showing-uplink-dc.png]] 201 201 202 -On the **Data converters** page, click on the ‘**+**’ button, and then click on the **Create new converter** from the dropdown menu. 203 203 204 204 214 +== 3.2 Downlink == 205 205 206 -[[image:create-new-converter-menu.png||height="259" width="500"]] 207 207 217 +On the **Data converters** page, click on the ‘**+**’ button, and then click on the **Create new converter** from the dropdown menu. 208 208 209 -The **Add data converter** window will appear. Name it ‘**MQTT Uplink Converter NB/CB**’ and select the Type as **Uplink**. 210 210 211 - Click on the**JavaScript** button.220 +[[image:create-new-converter-menu.png||width="500"]] 212 212 213 -Delete the default decoder function in the code editor. Now copy and paste the following decoder function written in **JavaScript** in to the **code editor**. This decoder function is compatible for both NB and CB series devices. 214 214 215 -{{info}} 216 -Please note that the value assigned to the IMEI field in the payload will be used by ThingsBoard to create a device on the platform with the same name. 217 -{{/info}} 218 218 224 +The **Add data converter** window will appear. Name it ‘**MQTT Downlink Converter NB/CB**’ and select the Type as **Downlink**. 225 + 226 +Click on the **TBEL** button if not selected it by default. Now copy and paste the following encoder function written in **TBEL (ThingsBoard Expression Language)** in to the **code editor**. This encoder function is compatible for both NB and CB series devices. 227 + 228 + 219 219 {{code language="JavaScript"}} 220 -//Version: 0.1 221 -// decode payload to string 222 -var payloadStr = decodeToString(payload); 230 +// Encode downlink data from incoming Rule Engine message 223 223 224 -// decode payload to JSON 225 -var objdata = {}; 226 -var obj1 = {}; 227 -var data = decodeToJson(payload); 228 -var deviceName = data.IMEI; 229 -delete data.IMEI; 230 -var modelname = "Dragino " + data.Model; 231 -//var mod = data.mod 232 -delete data.Model; 233 -//delete data.mod 234 -var timestamp = new Date().getTime(); 232 +// msg - JSON message payload downlink message json 233 +// msgType - type of message, for ex. 'ATTRIBUTES_UPDATED', 'POST_TELEMETRY_REQUEST', etc. 234 +// metadata - list of key-value pairs with additional data about the message 235 +// integrationMetadata - list of key-value pairs with additional data defined in Integration executing this converter 235 235 236 -for (var key in data) { 237 - 238 - if (Number(key)) { 239 - obj1[key] = data[key]; 240 - obj1[key][obj1[key].length - 1] = Number(new Date( 241 - obj1[key][obj1[key].length - 1])); 237 +/** Encoder **/ 242 242 243 - } 244 -//Alec submitted25/02/25 245 -//turn old key into new 246 - else if (key === "Reading") { 247 - objdata["reading"] = data[key]; 248 - } else if (key === "work mode") { 249 - objdata["work_mode"] = data[key]; 250 - } else if (key === "hum") { 251 - objdata["humidity"] = data[key]; 252 - }else if (key === "hum2") { 253 - objdata["humidity2"] = data[key]; 254 - } else if (key === "hum3") { 255 - objdata["humidity3"] = data[key]; 256 - } else if (key === "tem") { 257 - objdata["temperature"] = data[key]; 258 - } else if (key === "tem2") { 259 - objdata["temperature2"] = data[key]; 260 - } else if (key === "tem3") { 261 - objdata["temperature3"] = data[key]; 262 - } else if (key === "DS18B20_Temp") { 263 - objdata["temperature_pro"] = data[key]; 264 - } else if (key === "ds18b20_temperature") { 265 - objdata["temperature_pro"] = data[key]; 266 - } else if (key === "DS18B20_temperature_pro") { 267 - objdata["temperature_pro"] = data[key]; 268 - } else if (key === "tdc send flag") { 269 - objdata["tdc_send_flag"] = data[key]; 270 - } else if (key === "trigger mode") { 271 - objdata["trigger_mode"] = data[key]; 272 - } else if (key === "soil dielectric constant") { 273 - objdata["soil_dielectric_constant"] = data[key]; 274 - } else if (key === "door open num") { 275 - objdata["door_open_num"] = data[key]; 276 - } else if (key === "door duration") { 277 - objdata["door_duration"] = data[key]; 278 - } else if (key === "count time") { 279 - objdata["count_time"] = data[key]; 280 - } else if (key === "last open time2") { 281 - objdata["last_open_time2"] = data[key]; 282 - } else if (key === "last open time3") { 283 - objdata["last_open_time3"] = data[key]; 284 - } 285 -//Alec submitted25/02/25 286 - else { 287 - objdata[key] = data[key] 288 - } 289 -} 290 -var listdata = [{ 291 - "ts": timestamp, 292 - "values": objdata 293 -}] 294 -for (var key1 in obj1) { 295 - if (modelname == "Dragino RS485-NB") { 296 - listdata.push({ 297 - "ts": obj1[key1][obj1[key1].length - 1], 298 - "values": { 299 - "Payload": obj1[key1][0], 300 - } 301 - }) 302 - } else { 303 - listdata.push({ 304 - "ts": obj1[key1][obj1[key1].length - 1], 305 - "values": { 306 - "values": obj1[key1] 307 - }, 308 - }) 309 - } 310 -} 311 -var result = { 239 +var data = {}; 312 312 313 - deviceName: deviceName, 314 - deviceType: modelname, 315 - attributes: { 316 - model: modelname, 317 - //customerName: "NB-CB", 318 - //groupName: "NB-CB", 319 - //integrationName: metadata['integrationName'] 241 +// Process data from incoming message and metadata 320 320 321 - }, 322 - telemetry: listdata 323 -} 243 +data.tempFreq = msg.temperatureUploadFrequency; 244 +data.humFreq = msg.humidityUploadFrequency; 324 324 325 -function decodeToString(payload) { 326 - return String.fromCharCode.apply(String, payload); 327 -} 246 +data.devSerialNumber = metadata['ss_serialNumber']; 328 328 329 -function decodeToJson(payload) { 330 - // covert payload to string. 331 - var str = decodeToString(payload); 248 +// Result object with encoded downlink payload 249 +var result = { 332 332 333 - // parse string to JSON 334 - var data = JSON.parse(str); 335 - return data; 336 -} 251 + // downlink data content type: JSON, TEXT or BINARY (base64 format) 252 + contentType: "JSON", 337 337 254 + // downlink data 255 + data: JSON.stringify(data), 256 + 257 + // Optional metadata object presented in key/value format 258 + metadata: { 259 + topic: metadata['deviceType']+'/'+metadata['deviceName']+'/upload' 260 + } 261 + 262 +}; 263 + 338 338 return result; 339 339 {{/code}} 340 340 ... ... @@ -342,19 +342,20 @@ 342 342 Click on the **Add** button. 343 343 344 344 345 -[[image:mqtt-uplink.png||width="500"]] 346 346 272 +[[image:add-downlink-data-converter.png||height="529" width="500"]] 347 347 348 348 349 -You should see that the newly added **MQTT Uplinkconverter**NB/CB is listed on the **Data Converters** page.275 +You should see that the newly added **MQTT Downlink** Converter NB/CB is listed on the **Data Converters** page. 350 350 351 351 352 -[[image:data-converter-list -showing-uplink-dc.png]]278 +[[image:data-converters-list.png]] 353 353 354 354 355 -= 5. Add Integration = 356 356 282 += 4. Add Integration = 357 357 284 + 358 358 In the left navigation, click **Integrations center**, and then click **Integrations**. 359 359 360 360 ... ... @@ -379,6 +379,7 @@ 379 379 Click **Next** button. 380 380 381 381 309 + 382 382 [[image:add-integration-basic-settings.png||height="511" width="500"]] 383 383 384 384 ... ... @@ -390,34 +390,33 @@ 390 390 Click **Next** button. 391 391 392 392 321 + 393 393 [[image:add-integration-uplink-data-converter.png||height="511" width="500"]] 394 394 395 395 396 396 **Downlink data converter:** 397 397 398 -Dragino NB/CB devices don't require a downlink data converter to decode their payloads, so you can skip this step. 327 +* Click on the **Select existing** button. 328 +* **Downlink data converter**: Select **MQTT Downlink Converter NB/CB **from the dropdown list. 399 399 400 - *Clickon the**Skip**buttonin the Downlink data converter section.330 +Click **Next** button. 401 401 402 -Click **Skip** button. 403 403 404 404 405 -[[image:integration-dl -skip.png||height="511" width="500"]]334 +[[image:add-integration-downlink-data-converter.png||height="511" width="500"]] 406 406 407 407 408 - 409 409 **Connection:** 410 410 411 -* **Host**: Cluster URL (Eg. 011731f7 xxxxxxxxxxxfbbedfc63f4.s1.eu.hivemq.cloud)339 +* **Host**: Cluster URL (Eg. 011731f7928541588a6cdfbbedfc63f4.s1.eu.hivemq.cloud) 412 412 * **Port**: 8883 413 413 * **Credentials**: Basic 414 414 * **Enable SSL**: YES 415 415 * **Username**: Username (from your HiveMQ Cloud Cluster with your credentials) 416 416 * **Password:** Password (from your HiveMQ Cloud Cluster with your credentials) 417 -* **Topic: v1/devices/me/telemetry**(Thetopiccan be anything;you can even use just thedevice name.For example,youcan useyourdevice namehere,suchas S31B-NB.)345 +* **Topic:** tb/mqtt-integration-tutorial/sensors/+/telemetry (the + replaces any 'device name' and creates devices in the Entities -> Devices) 418 418 * **QoS:** 0-At most once 419 419 420 - 421 421 [[image:add-integration-connection.png||height="511" width="500"]] 422 422 423 423 ... ... @@ -448,35 +448,48 @@ 448 448 Since we haven't received data from a device yet, the integration **Status** is shown as **Pending.** 449 449 450 450 378 + 451 451 [[image:new-integration-pending.png]] 452 452 453 453 454 -= 6. Verifying the receipt of data from virtual devices =382 += 5. Verifying the receipt of data from virtual devices = 455 455 456 456 457 -== 6.1 How does it work? ==385 +== 5.1 How does it work? == 458 458 459 459 460 460 We use the Mosquitto MQTT client to simulate MQTT messages, acting as a virtual device. First, install the Mosquitto client on your computer from [[this link>>url:https://mosquitto.org/download/]]. The Mosquitto client publishes messages to the MQTT broker (HiveMQ) on a specified MQTT topic. ThingsBoard subscribes to these messages using the same topic. 461 461 462 -The Mosquitto client publishes messages (payloads) on the topic**v1/devices/me/telemetry**.Ofcourse,youcanuse anytopic for testing.390 +The Mosquitto client publishes messages on the topic v1/devices/[device_name]/telemetry. The [device_name]placeholder can be replaced with any device name, for example, 'S31B-NB'. Then, the MQTT topic would be v1/devices/S31B-NB/telemetry. 463 463 464 - (%id="cke_bm_37386S" style="display:none"%) (%%)The MQTTpayloadformatsasfollows, which iscommon forall **~-~-NB**and**~-~-CB** series devices.The**IMEI**fieldismandatoryandisusedtoprovision anewdevice with thenameassigned to it in ThingsBoard.392 +On the ThingsBoard side, we configure the MQTT topic subscription as v1/devices/+/telemetry. The + wildcard represents any device name and allows ThingsBoard to automatically create (provision) a device with that name, such as S31B-NB, for example. 465 465 394 + 395 +**The new device is created the first time the MQTT topic is received. For subsequent MQTT topics with the same device name, no duplicate devices will be created.** 396 + 397 + 398 +For example, if you send two MQTT messages with different device names in the topic: 399 + 400 +1. v1/devices/**S31B-NB**/telemetry 401 +1. v1/devices/**LDS25-NB**/telemetry 402 + 403 +ThingsBoard will create two devices named **S31B-NB** and **LDS25-NB** in the **//Devices//** section. 404 + 405 + 406 +The MQTT payload format is as follows, which is common for all ~-~-NB and ~-~-CB series devices: 407 + 466 466 {{code language="none"}} 467 -{" IMEI": "S31B-NB", "temperature":27,......}409 +{"temperature":10.4, "humidity":85} 468 468 {{/code}} 469 469 470 -Once ThingsBoard receives this message, it automatically creates (provisions) the device mentioned in the **IMEI**, for example, S31B-NB. 471 471 472 - 473 473 == 5.2 Sending messages == 474 474 475 475 476 -On the terminal, issue the following MQTT command which simulates the device S31B-NB. The message payload contains the fields temperature and humidity, which hold the values S31B-NBand27, respectively. This payload is also (technically) known as telemetry.416 +On the terminal, issue the following MQTT command which simulates the device S31B-NB. The message payload contains the fields temperature and humidity, which hold the values 10.4 and 85, respectively. This payload is also (technically) known as telemetry. 477 477 478 478 {{code language="none"}} 479 -mosquitto_pub -d -q 1 -h 011731f7928xxxxx.s1.eu.hivemq.cloud -p 8883 -t " v1/devices/me/telemetry" -u "xxxxx" -P "xxxxx" -m '{"IMEI": "S31B-NB", "temperature":27}'419 +mosquitto_pub -d -q 1 -h 011731f7928xxxxx.s1.eu.hivemq.cloud -p 8883 -t "tb/mqtt-integration-tutorial/sensors/S31B-NB/telemetry" -u "xxxxx" -P "xxxxx" -m '{"temperature":10.4, "humidity":85}' 480 480 {{/code}} 481 481 482 482 If the integration was performed without errors, the status of the integration changes to 'Active' after the first telemetry transmission. ... ... @@ -488,51 +488,40 @@ 488 488 Also, a new device named **S31B-NB** will appear under **//Entities -> Devices -> All//**. This means the first MQTT message triggers ThingsBoard to provision a device named **S31B-NB**. 489 489 490 490 491 -[[image: new-device.png]]431 +[[image:device-provision-1.png]] 492 492 493 493 494 - ==6.3Viewingmessages==434 +Click on the device S31B-NB on the devices list to see its details. 495 495 436 +Then go to the **Latest telemetry** tab. 496 496 497 - Gobacktothe**Integrations**page.438 +You can see the fields temperature and humidity with the values you previously sent using the MQTT message. 498 498 499 -Click on the **MQTT integration NB/CB** in the **Integrations** page to see its details. 500 500 501 - Click onthe**Edit** button (//**penicon**//).441 +[[image:telemetry-1.png]] 502 502 503 -Click on the **Disabled** button in the upper-right corner. 504 504 505 - Turnon the**All messages(15 min)**option.Thiswillenabledisplayingallmessagesinthe**Events** tab.Thissetting willexpirein 15 minutes,andyouwill needrepeatthesamestepsif youwantto view themessagesintheEventsablater.444 +Now, change the values of the fields and send the MQTT message again. For example, set temperature to 20 and humidity to 70. Observe how the values update in //Latest Telemetry//. 506 506 507 -Click on the **Apply** button. 508 508 509 - Then click onthe**Apply changes** (//**tick icon**//) button.447 +[[image:telemetry-2.png]] 510 510 511 511 512 - [[image:Screenshot 2025-03-18at09.23.10.png]]450 +Let's provision the second device named **LDS25-NB **with initial telemetry. Use the following MQTT message. 513 513 514 514 515 -Now go to the **Events** tab. 453 +{{code language="none"}} 454 +mosquitto_pub -d -q 1 -h 011731f7928541588a6cdfbbedfc63f4.s1.eu.hivemq.cloud -p 8883 -t "tb/mqtt-integration-tutorial/sensors/LDS25-NB/telemetry" -u "pradeeka" -P "Kalpani123@" -m '{"temperature":11, "humidity":87}' 455 +{{/code}} 516 516 517 - SelecttheEventtypeas **Debug**from thedropdownlist.457 +Now, refresh the **Devices** page, and you will see the second device, **LDS25-NB**, which was recently provisioned. 518 518 519 -Now you can see all the Uplink messages you are simulating through the MQTT broker. The status should be OK if there is no errors in your integration. 520 520 460 +[[image:device-provision-2.png]] 521 521 522 -[[image:Screenshot 2025-03-16 at 18.38.59.png]] 523 523 463 += 6. Creating a Dashboard = 524 524 525 -Then click on the **three dots (...)** in the **Message** column. You can see the uplink message's **payload** in the **Message** window. 526 - 527 - 528 -[[image:Screenshot 2025-03-16 at 18.39.12.png]] 529 - 530 - 531 -Now, you have successfully tested your integration with a simulated uplink payload and verified that it is received by ThingsBoard, and the device is provisioned. 532 - 533 - 534 -= 7. Creating a Dashboard = 535 - 536 536 ThingsBoard **Dashboards** provide a powerful way to visualize and monitor real-time and historical data from connected devices. They allow users to create interactive, customizable panels displaying telemetry data, device status, and other key metrics. With a variety of widgets, including charts, maps, and tables, dashboards help users gain insights, track trends, and manage IoT deployments efficiently. 537 537 538 538 ... ... @@ -539,11 +539,6 @@ 539 539 This section guides you on how to create a dashboard to display temperature and humidity data from the device on a time-series chart. You may also use other widgets in ThingsBoard to display data according to your requirements. 540 540 541 541 542 -First simulate a few messages using MQTT. This time, we have added the 'humidity' field to the payload. Eg: 543 - 544 -{{code language="none"}}mosquitto_pub -d -q 1 -h 011731f7928xxxxx.s1.eu.hivemq.cloud -p 8883 -t "v1/devices/me/telemetry" -u "xxxxx" -P "xxxxx" -m '{"IMEI": "S31B-NB", "temperature": 22, "humidity":80}'{{/code}} 545 - 546 - 547 547 In **ThingsBoard**, from the left navigation menu, click **Dashboards**. Then, click the **+** button and select **Create new dashboard** from the dropdown menu. 548 548 549 549 ... ... @@ -600,11 +600,11 @@ 600 600 601 601 602 602 {{code language="none"}} 603 -mosquitto_pub -d -q 1 -h 011731f7928xxxxx.s1.eu.hivemq.cloud -p 8883 -t " v1/devices/me/telemetry" -u "xxxxx" -P "xxxxx" -m '{"IMEI": "S31B-NB", "temperature":2, "humidity":70}'527 +mosquitto_pub -d -q 1 -h 011731f7928xxxxx.s1.eu.hivemq.cloud -p 8883 -t "tb/mqtt-integration-tutorial/sensors/S31B-NB/telemetry" -u "xxxxx" -P "xxxxx" -m '{"temperature":20, "humidity":70}' 604 604 605 -mosquitto_pub -d -q 1 -h 011731f7928xxxxx.s1.eu.hivemq.cloud -p 8883 -t " v1/devices/me/telemetry" -u "xxxxx" -P "xxxxx" -m '{"IMEI": "S31B-NB", "temperature":7, "humidity":72}'529 +mosquitto_pub -d -q 1 -h 011731f7928xxxxx.s1.eu.hivemq.cloud -p 8883 -t "tb/mqtt-integration-tutorial/sensors/S31B-NB/telemetry" -u "xxxxx" -P "xxxxx" -m '{"temperature":22, "humidity":71}' 606 606 607 -mosquitto_pub -d -q 1 -h 011731f7928xxxxx.s1.eu.hivemq.cloud -p 8883 -t " v1/devices/me/telemetry" -u "xxxxx" -P "xxxxx" -m '{"IMEI": "S31B-NB", "temperature":9, "humidity":80}'531 +mosquitto_pub -d -q 1 -h 011731f7928xxxxx.s1.eu.hivemq.cloud -p 8883 -t "tb/mqtt-integration-tutorial/sensors/S31B-NB/telemetry" -u "xxxxx" -P "xxxxx" -m '{"temperature":18, "humidity":79}' 608 608 609 609 {{/code}} 610 610 ... ... @@ -614,10 +614,10 @@ 614 614 [[image:timeseries-4.png||height="316" width="700"]] 615 615 616 616 617 -= 8. Configure NB-IoT Sensor =541 += 7. Configure NB-IoT Sensor = 618 618 619 619 620 -Now, let's experiment with sending data to ThingsBoard using a real NB-IoT device. For example, we will use the ** TS01-NB**.544 +Now, let's experiment with sending data to ThingsBoard using a real NB-IoT device. For example, we will use the **S31B-NB**. 621 621 622 622 First, configure the NB-IoT device with the necessary MQTT settings using AT commands. Below is a list of AT commands you can use. 623 623 ... ... @@ -625,8 +625,8 @@ 625 625 **AT Commands** 626 626 627 627 * **AT+PRO=3,3 **~/~/ Use MQTT to connect to ThingsBoard. Payload Type set to 3. 628 -* **AT+SUBTOPIC=<MQTT subscribetopic>Eg: TS01-NB**629 -* **AT+PUBTOPIC=<MQTT publishtopic>Eg: TS01-NB**552 +* **AT+SUBTOPIC=<MQTT topic>** 553 +* **AT+PUBTOPIC=<MQTT topic>** 630 630 * **AT+CLIENT=null** 631 631 * **AT+UNAME=<MQTT Username>** 632 632 * **AT+PWD=<MQTT Password>** ... ... @@ -633,16 +633,3 @@ 633 633 * **AT+SERVADDR=<Broker address, Port>** 634 634 635 635 Test your uplink by pressing the ACT button for 1 second. 636 - 637 - 638 - 639 -The following image shows the uplink payload of a real Dragino device. The publish topic is **TS01-NB**, and the device name is **861275077962896**, which is represented by the **IMEI**. 640 - 641 -{{info}} 642 -The ThingsBoard uses the device's IMEI number included in the payload to create a device in the Devices section. 643 -{{/info}} 644 - 645 -[[image:image-4.png]] 646 - 647 - 648 -
- Screenshot 2025-03-16 at 18.38.59.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.pradeeka - Size
-
... ... @@ -1,1 +1,0 @@ 1 -221.2 KB - Content
- Screenshot 2025-03-16 at 18.39.12.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.pradeeka - Size
-
... ... @@ -1,1 +1,0 @@ 1 -211.9 KB - Content
- Screenshot 2025-03-18 at 09.23.10.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.pradeeka - Size
-
... ... @@ -1,1 +1,0 @@ 1 -78.7 KB - Content
- add-integration-connection.png
-
- Size
-
... ... @@ -1,1 +1,1 @@ 1 -1 58.1KB1 +124.4 KB - Content
- emqx.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.pradeeka - Size
-
... ... @@ -1,1 +1,0 @@ 1 -39.1 KB - Content
- image-4.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.pradeeka - Size
-
... ... @@ -1,1 +1,0 @@ 1 -96.0 KB - Content
- ins1.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.pradeeka - Size
-
... ... @@ -1,1 +1,0 @@ 1 -28.8 KB - Content
- integration-dl-skip.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.pradeeka - Size
-
... ... @@ -1,1 +1,0 @@ 1 -105.5 KB - Content
- mqtt-uplink.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.pradeeka - Size
-
... ... @@ -1,1 +1,0 @@ 1 -175.1 KB - Content
- new-device.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.pradeeka - Size
-
... ... @@ -1,1 +1,0 @@ 1 -143.3 KB - Content