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 (4 modified, 0 added, 12 removed)
- Screenshot 2025-03-16 at 18.39.12.png
- Screenshot 2025-03-26 at 18.15.08.png
- Screenshot 2025-03-26 at 19.47.52.png
- Screenshot 2025-03-26 at 19.49.31.png
- Screenshot 2025-03-31 at 06.51.15.png
- add-integartion-connection.png
- add-integartion-connetcion.png
- add-integration-basic-settings.png
- add-integration-connection.png
- add-integration-ul-data-converter.png
- debug-enabled.png
- integration-active.png
- integration-added.png
- integration-dl-skip.png
- ul-data-converter-added.png
- ul-data-converter-device-a.png
Details
- Page properties
-
- Content
-
... ... @@ -164,144 +164,240 @@ 164 164 [[image:ins1.png||height="310" width="500"]] 165 165 166 166 167 -= 3. CreatingDevices(Optional)=167 += 3. Data Converters = 168 168 169 -{{info}} 170 -**The following procedure is optional. If you haven't created any device in ThingsBoard first, ThingsBoard will automatically create a device for you based on the integration settings (the device name defined in the uplink decoder) just after it receives the first uplink from your device.Type your information message here.** 171 -{{/info}} 172 172 173 - First,youneed tocreate devices inThingsBoardtorepresentyourphysicaldevices. For example,youcannameit**DeviceA**, andheseconddevicecould be **Device B**oranyname youprefer.Thedevicenameshouldbeuniquewithinthe **Devices** space.170 +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. 174 174 175 175 176 - Intheleft navigation, click**Entities -> Devices**.173 +== 3.1 Uplink == 177 177 178 -Click the **Add Device** button (the button with the **+** sign), and from the dropdown menu, click **Add new device**. 179 179 180 -In the **Addnewdevice** dialog box,enterhe deviceamein theName**textbox. Forxample, we will use**Device A**.176 +In the left navigation, click **Integrations center**, and then click **Data converters**. 181 181 182 -Click the **Add** button. 183 183 184 - Skip the**connectivity testing** by clickingthe**Close** button.179 +[[image:data-converters-list-empty.png]] 185 185 186 -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. 187 187 182 +On the **Data converters** page, click on the ‘**+**’ button, and then click on the **Create new converter** from the dropdown menu. 188 188 189 -= 4. Data Converters = 190 190 191 191 192 - In **ThingsBoard**, **Data Converters**are components used to transform incoming or outgoing data between different formats, typically toconvertraw telemetry data fromdevices into a structured format thatThingsBoardcan understand, or vice versa.186 +[[image:create-new-converter-menu.png||height="259" width="500"]] 193 193 194 194 195 - ==4.1Uplink==189 +The **Add data converter** window will appear. Name it ‘**MQTT Uplink Converter NB/CB**’ and select the Type as **Uplink**. 196 196 191 +Click on the **JavaScript** button. 197 197 198 - Intheleft navigation,click**Integrationscenter**,andthenclick**Dataconverters**.193 +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. 199 199 200 200 201 -[[image:data-converters-list-empty.png]] 196 +{{code language="JavaScript"}} 197 +//Version: 0.1 198 +// decode payload to string 199 +var payloadStr = decodeToString(payload); 202 202 201 +// decode payload to JSON 202 +var objdata = {}; 203 +var obj1 = {}; 204 +var data = decodeToJson(payload); 205 +var deviceName = data.IMEI; 206 +delete data.IMEI; 207 +var modelname = "Dragino " + data.Model; 208 +//var mod = data.mod 209 +delete data.Model; 210 +//delete data.mod 211 +var timestamp = new Date().getTime(); 203 203 204 -On the **Data converters** page, click on the ‘**+**’ button, and then click on the **Create new converter** from the dropdown menu. 213 +for (var key in data) { 214 + 215 + if (Number(key)) { 216 + obj1[key] = data[key]; 217 + obj1[key][obj1[key].length - 1] = Number(new Date( 218 + obj1[key][obj1[key].length - 1])); 205 205 220 + } 221 +//Alec submitted25/02/25 222 +//turn old key into new 223 + else if (key === "Reading") { 224 + objdata["reading"] = data[key]; 225 + } else if (key === "work mode") { 226 + objdata["work_mode"] = data[key]; 227 + } else if (key === "hum") { 228 + objdata["humidity"] = data[key]; 229 + }else if (key === "hum2") { 230 + objdata["humidity2"] = data[key]; 231 + } else if (key === "hum3") { 232 + objdata["humidity3"] = data[key]; 233 + } else if (key === "tem") { 234 + objdata["temperature"] = data[key]; 235 + } else if (key === "tem2") { 236 + objdata["temperature2"] = data[key]; 237 + } else if (key === "tem3") { 238 + objdata["temperature3"] = data[key]; 239 + } else if (key === "DS18B20_Temp") { 240 + objdata["temperature_pro"] = data[key]; 241 + } else if (key === "ds18b20_temperature") { 242 + objdata["temperature_pro"] = data[key]; 243 + } else if (key === "DS18B20_temperature_pro") { 244 + objdata["temperature_pro"] = data[key]; 245 + } else if (key === "tdc send flag") { 246 + objdata["tdc_send_flag"] = data[key]; 247 + } else if (key === "trigger mode") { 248 + objdata["trigger_mode"] = data[key]; 249 + } else if (key === "soil dielectric constant") { 250 + objdata["soil_dielectric_constant"] = data[key]; 251 + } else if (key === "door open num") { 252 + objdata["door_open_num"] = data[key]; 253 + } else if (key === "door duration") { 254 + objdata["door_duration"] = data[key]; 255 + } else if (key === "count time") { 256 + objdata["count_time"] = data[key]; 257 + } else if (key === "last open time2") { 258 + objdata["last_open_time2"] = data[key]; 259 + } else if (key === "last open time3") { 260 + objdata["last_open_time3"] = data[key]; 261 + } 262 +//Alec submitted25/02/25 263 + else { 264 + objdata[key] = data[key] 265 + } 266 +} 267 +var listdata = [{ 268 + "ts": timestamp, 269 + "values": objdata 270 +}] 271 +for (var key1 in obj1) { 272 + if (modelname == "Dragino RS485-NB") { 273 + listdata.push({ 274 + "ts": obj1[key1][obj1[key1].length - 1], 275 + "values": { 276 + "Payload": obj1[key1][0], 277 + } 278 + }) 279 + } else { 280 + listdata.push({ 281 + "ts": obj1[key1][obj1[key1].length - 1], 282 + "values": { 283 + "values": obj1[key1] 284 + }, 285 + }) 286 + } 287 +} 288 +var result = { 206 206 290 + deviceName: deviceName, 291 + deviceType: modelname, 292 + attributes: { 293 + model: modelname, 294 + //customerName: "NB-CB", 295 + //groupName: "NB-CB", 296 + //integrationName: metadata['integrationName'] 207 207 208 -[[image:create-new-converter-menu.png||height="259" width="500"]] 298 + }, 299 + telemetry: listdata 300 +} 209 209 302 +function decodeToString(payload) { 303 + return String.fromCharCode.apply(String, payload); 304 +} 210 210 211 -The **Add data converter** window will appear. 306 +function decodeToJson(payload) { 307 + // covert payload to string. 308 + var str = decodeToString(payload); 212 212 213 -Let's create an uplink data converter for the device named '**Device A**'. Name it ‘**MQTT Uplink Converter - Device A**’ and select the Type as **Uplink**. 310 + // parse string to JSON 311 + var data = JSON.parse(str); 312 + return data; 313 +} 214 214 215 -Click on the **TBEL** button if it has not been selected by default. 315 +return result; 316 +{{/code}} 216 216 217 -Modify the default TBEL function to match with your device as described below: 218 218 319 +Click on the **Add** button. 219 219 220 -* Uncomment** line 11**: 221 221 222 - //var data = decodeToJson(payload)//322 +[[image:mqtt-uplink.png||width="500"]] 223 223 224 224 225 -* **Line 13**: Assign your device name to the **deviceName** field. - We used **Device A** as it is to match with our device, **Device A **in the Devices section. 226 -* From **line 38**: Modify the telemetry section to allow parsed data to be assigned to the fields. 227 227 228 -//telemetry: { 229 - temperature: data.temperature, 230 - humidity: data.humidity, 231 - rawData: payloadStr 232 - }// 326 +You should see that the newly added **MQTT Uplink converter **NB/CB is listed on the **Data Converters** page. 233 233 234 234 235 - The modifieduplink decoderfunction to match with **Device A** isbelow.329 +[[image:data-converter-list-showing-uplink-dc.png]] 236 236 331 + 332 +== 3.2 Downlink == 333 + 334 + 335 +On the **Data converters** page, click on the ‘**+**’ button, and then click on the **Create new converter** from the dropdown menu. 336 + 337 + 338 +[[image:create-new-converter-menu.png||width="500"]] 339 + 340 + 341 + 342 +The **Add data converter** window will appear. Name it ‘**MQTT Downlink Converter NB/CB**’ and select the Type as **Downlink**. 343 + 344 +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. 345 + 346 + 237 237 {{code language="JavaScript"}} 238 -// Decode an uplink message from a buffer 239 -// payload - array of bytes 240 -// metadata - key/value object 348 +// Encode downlink data from incoming Rule Engine message 241 241 242 -/** Decoder **/ 350 +// msg - JSON message payload downlink message json 351 +// msgType - type of message, for ex. 'ATTRIBUTES_UPDATED', 'POST_TELEMETRY_REQUEST', etc. 352 +// metadata - list of key-value pairs with additional data about the message 353 +// integrationMetadata - list of key-value pairs with additional data defined in Integration executing this converter 243 243 244 -// decode payload to string 245 -var payloadStr = decodeToString(payload); 355 +/** Encoder **/ 246 246 247 -// decode payload to JSON 248 -var data = decodeToJson(payload); 357 +var data = {}; 249 249 250 -var deviceName = 'Device A'; 251 -var deviceType = 'thermostat'; 252 -var customerName = 'Customer C'; 253 -var groupName = 'thermostat devices'; 254 -var manufacturer = 'Example corporation'; 255 -// use assetName and assetType instead of deviceName and deviceType 256 -// to automatically create assets instead of devices. 257 -// var assetName = 'Asset A'; 258 -// var assetType = 'building'; 359 +// Process data from incoming message and metadata 259 259 260 -// Result object with device/asset attributes/telemetry data 361 +data.tempFreq = msg.temperatureUploadFrequency; 362 +data.humFreq = msg.humidityUploadFrequency; 363 + 364 +data.devSerialNumber = metadata['ss_serialNumber']; 365 + 366 +// Result object with encoded downlink payload 261 261 var result = { 262 -// Use deviceName and deviceType or assetName and assetType, but not both. 263 - deviceName: deviceName, 264 - deviceType: deviceType, 265 -// assetName: assetName, 266 -// assetType: assetType, 267 -// customerName: customerName, 268 - groupName: groupName, 269 - attributes: { 270 - model: 'Model A', 271 - serialNumber: 'SN111', 272 - integrationName: metadata['integrationName'], 273 - manufacturer: manufacturer 274 - }, 275 - telemetry: { 276 - temperature: data.temperature, 277 - humidity: data.humidity, 278 - rawData: payloadStr 279 - } 280 -}; 281 281 282 -/** Helper functions 'decodeToString' and 'decodeToJson' are already built-in **/ 369 + // downlink data content type: JSON, TEXT or BINARY (base64 format) 370 + contentType: "JSON", 283 283 284 - returnresult;285 - {{/code}}372 + // downlink data 373 + data: JSON.stringify(data), 286 286 375 + // Optional metadata object presented in key/value format 376 + metadata: { 377 + topic: metadata['deviceType']+'/'+metadata['deviceName']+'/upload' 378 + } 287 287 288 - Once you modify the decoder function, click on the **Add** button.380 +}; 289 289 382 +return result; 383 +{{/code}} 290 290 291 291 292 - [[image:ul-data-converter-device-a.png||height="524"width="500"]]386 +Click on the **Add** button. 293 293 294 294 295 - You should see that thenewlyadded**MQTT Uplink converter **NB/CB islisted onthe **DataConverters**page.389 +[[image:add-downlink-data-converter.png||height="529" width="500"]] 296 296 297 297 298 - [[image:ul-data-converter-added.png||height="257"]]392 +You should see that the newly added **MQTT Downlink** Converter NB/CB is listed on the **Data Converters** page. 299 299 300 300 395 +[[image:data-converters-list.png]] 301 301 302 -= 5. Add Integration = 303 303 398 += 4. Add Integration = 304 304 400 + 305 305 In the left navigation, click **Integrations center**, and then click **Integrations**. 306 306 307 307 ... ... @@ -319,7 +319,7 @@ 319 319 **Basic settings:** 320 320 321 321 * **Integration type**: MQTT 322 -* **Name**: MQTT integration - Device A418 +* **Name**: MQTT integration NB/CB 323 323 * **Enable integration**: YES 324 324 * **Allows create devices or assets**: YES 325 325 ... ... @@ -326,11 +326,9 @@ 326 326 Click **Next** button. 327 327 328 328 329 -[[image:add-integration-basic-settings.png||height="5 04" width="500"]]425 +[[image:add-integration-basic-settings.png||height="511" width="500"]] 330 330 331 331 332 - 333 - 334 334 **Uplink data converter:** 335 335 336 336 * Click on the **Select existing** button. ... ... @@ -339,35 +339,32 @@ 339 339 Click **Next** button. 340 340 341 341 342 -[[image:add-integration-ul-data-converter.png||height="5 05" width="500"]]436 +[[image:add-integration-uplink-data-converter.png||height="511" width="500"]] 343 343 344 344 345 - 346 346 **Downlink data converter:** 347 347 348 -Dragino NB/CB devices don't require a downlink data converter to decode their payloads, so you can skip this step. 441 +* Click on the **Select existing** button. 442 +* **Downlink data converter**: Select **MQTT Downlink Converter NB/CB **from the dropdown list. 349 349 350 - *Clickon the**Skip**buttonin the Downlink data converter section.444 +Click **Next** button. 351 351 352 -Click **Skip** button. 353 353 447 +[[image:add-integration-downlink-data-converter.png||height="511" width="500"]] 354 354 355 -[[image:integration-dl-skip.png||height="511" width="500"]] 356 356 357 - 358 - 359 359 **Connection:** 360 360 361 -* **Host**: Host**//011731f7xxxxxxxxxxxfbbedfc63f4.s1.eu.hivemq.cloud//**)452 +* **Host**: Cluster URL (Eg. 011731f7xxxxxxxxxxxfbbedfc63f4.s1.eu.hivemq.cloud) 362 362 * **Port**: 8883 363 -* **Credentials type**: Basic 454 +* **Credentials**: Basic 455 +* **Enable SSL**: YES 364 364 * **Username**: Username (from your HiveMQ Cloud Cluster with your credentials) 365 365 * **Password:** Password (from your HiveMQ Cloud Cluster with your credentials) 366 -* **Enable SSL**: YES 367 -* **Topic: device/a** (The topic can be anything; you can even use just the device name.) 458 +* **Topic: v1/devices/+/telemetry** (the + replaces any 'device name' will create a device in the Entities -> Devices) 368 368 * **QoS:** 0-At most once 369 369 370 -[[image:add-integ artion-connection.png||height="505" width="500"]]461 +[[image:add-integration-connection.png||height="511" width="500"]] 371 371 372 372 373 373 Click on the **Advanced settings** button. ... ... @@ -397,36 +397,36 @@ 397 397 Since we haven't received data from a device yet, the integration **Status** is shown as **Pending.** 398 398 399 399 400 -[[image:integration-added.png]] 401 401 492 +[[image:new-integration-pending.png]] 402 402 403 403 404 -= 6. Verifying the receipt of data from virtual devices =495 += 5. Verifying the receipt of data from virtual devices = 405 405 406 406 407 -== 6.1 How does it work? ==498 +== 5.1 How does it work? == 408 408 409 409 410 410 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. 411 411 412 -The Mosquitto client publishes messages (payloads) on the topic **/device/ a**. Of course, you can use any topic for testing.503 +The Mosquitto client publishes messages (payloads) on the topic **v1/devices/me/telemetry**. Of course, you can use any topic for testing. 413 413 414 -(% id="cke_bm_37386S" style="display:none" %) (%%)The MQTT payload format is as follows :505 +(% id="cke_bm_37386S" style="display:none" %) (%%)The MQTT payload format is as follows, which is common for all **~-~-NB** and **~-~-CB** series devices. The **IMEI** field is mandatory and is used to provision a new device with the name assigned to it in ThingsBoard. 415 415 416 416 {{code language="none"}} 417 -{"IMEI": "3 50693903995577", "temperature":25,"humidity":80, "pressure":1005}508 +{"IMEI": "S31B-NB", "temperature": 27, ......} 418 418 {{/code}} 419 419 420 -Once ThingsBoard receives this message, it forwardsthis payloadto thematchingdevice through the integration.511 +Once ThingsBoard receives this message, it automatically creates (provisions) the device mentioned in the **IMEI**, for example, S31B-NB. 421 421 422 422 423 423 == 5.2 Sending messages == 424 424 425 425 426 -On your computer'sterminal, issue the following MQTT command which simulates the device'**Device A'**. The message payload contains the fieldsIMEI,temperature,humidity,and pressure,which hold the values 350693903995577,30, 80,and1005respectively. This payload is also (technically) known as telemetry.517 +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-NB and 27, respectively. This payload is also (technically) known as telemetry. 427 427 428 428 {{code language="none"}} 429 -mosquitto_pub -d -q 1 -h 011731f7928xxxxx.s1.eu.hivemq.cloud -p 8883 -u "xxxxx" -P "xxxxx" - t "device/a" -m '{"IMEI":"350693903995577", "temperature":30,"humidity":80, "pressure":1005}'520 +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}' 430 430 {{/code}} 431 431 432 432 If the integration was performed without errors, the status of the integration changes to 'Active' after the first telemetry transmission. ... ... @@ -435,9 +435,16 @@ 435 435 [[image:integration-active.png]] 436 436 437 437 438 - ==6.3Viewingmessages==529 +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**. 439 439 440 440 532 +[[image:new-device.png]] 533 + 534 + 535 +== 5.3 Viewing messages == 536 + 537 + 538 + 441 441 Go back to the **Integrations** page. 442 442 443 443 Click on the **MQTT integration NB/CB** in the **Integrations** page to see its details. ... ... @@ -453,40 +453,29 @@ 453 453 Then click on the **Apply changes** (//**tick icon**//) button. 454 454 455 455 456 -[[image: debug-enabled.png||height="301"width="700"]]554 +[[image:Screenshot 2025-03-18 at 09.23.10.png]] 457 457 458 458 459 - 460 - 461 461 Now go to the **Events** tab. 462 462 463 -Select the **Event type**as **Debug** from the dropdown list.559 +Select the Event type as **Debug** from the dropdown list. 464 464 465 - Publish anothermessage (of course,you canrepeatthe previousmessagebypressing the UP arrow on yourkeyboard andthenpress Enter key) to yourMQTT brokerfromyourterminal,for example:561 +Now you can see all the Uplink messages you are simulating through the MQTT broker. The status should 466 466 467 -{{code language="none"}} 468 -mosquitto_pub -d -q 1 -h 011731f7928xxxxx.s1.eu.hivemq.cloud -p 8883 -u "xxxxx" -P "xxxxx" -t "device/a" -m '{"IMEI":"350693903995577", "temperature":30, "humidity":80, "pressure":1005}' 469 -{{/code}} 470 470 471 - Now you can see that uplinkmessagein the **Events** tab (Click the **refresh** button if you didn'tseeany messages intheEvents tab).The status should be **OK **if there isno errors in your integration.564 +[[image:Screenshot 2025-03-16 at 18.38.59.png]] 472 472 473 473 474 -[[image:Screenshot 2025-03-26 at 19.49.31.png]] 475 - 476 - 477 - 478 478 Then click on the **three dots (...)** in the **Message** column. You can see the uplink message's **payload** in the **Message** window. 479 479 480 480 481 -[[image:Screenshot 2025-03- 26 at 19.47.52.png]]570 +[[image:Screenshot 2025-03-16 at 18.39.12.png]] 482 482 483 483 484 - 485 - 486 486 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. 487 487 488 488 489 -= 7. Creating a Dashboard =576 += 6. Creating a Dashboard = 490 490 491 491 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. 492 492 ... ... @@ -494,11 +494,6 @@ 494 494 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. 495 495 496 496 497 -First simulate a few messages using MQTT. This time, we have added the 'humidity' field to the payload. Eg: 498 - 499 -{{code language="none"}}mosquitto_pub -d -q 1 -h 011731f7928xxxxx.s1.eu.hivemq.cloud -p 8883 -u "xxxxx" -P "xxxxx" -t "device/a" -m '{"IMEI":"350693903995577", "temperature":22, "humidity":80, "pressure":1005}'{{/code}} 500 - 501 - 502 502 In **ThingsBoard**, from the left navigation menu, click **Dashboards**. Then, click the **+** button and select **Create new dashboard** from the dropdown menu. 503 503 504 504 ... ... @@ -534,19 +534,15 @@ 534 534 535 535 Configure the **Time series chart** widget as follows: 536 536 537 -* **Datasource** - select **DeviceA**device you provisioned.619 +* **Datasource** - select S31B-NB device you provisioned. 538 538 * **Series**: 539 539 ** **temperature** - you can see this key by default. 540 540 ** **humidity** - Click **Add series** button. Then add the **humidity** for the key and then type **%** as its unit. 541 541 * Click on the **Add** button. 542 542 543 -{{info}} 544 -You can add only the relevant fields from the device's payload to display data on a widget. These fields are called 'keys'. 545 -{{/info}} 625 +[[image:timeseries-1.png||height="491" width="700"]] 546 546 547 -[[image:Screenshot 2025-03-31 at 06.51.15.png||height="485" width="700"]] 548 548 549 - 550 550 The time-series chart will appear in edit mode. Resize it by clicking and dragging the lower-right corner. 551 551 552 552 Click the **Save** button to add the widget to the dashboard. ... ... @@ -559,11 +559,12 @@ 559 559 560 560 561 561 {{code language="none"}} 562 -mosquitto_pub -d -q 1 -h 011731f7928xxxxx.s1.eu.hivemq.cloud -p 8883 -u "xxxxx" -P "xxxxx" - t "device/a" -m '{"IMEI":"350693903995577", "temperature":22, "humidity":70, "pressure":1005}'640 +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}' 563 563 564 -mosquitto_pub -d -q 1 -h 011731f7928xxxxx.s1.eu.hivemq.cloud -p 8883 -u "xxxxx" -P "xxxxx" - t "device/a" -m '{"IMEI":"350693903995577", "temperature":27, "humidity":72, "pressure":1005}'642 +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}' 565 565 566 -mosquitto_pub -d -q 1 -h 011731f7928xxxxx.s1.eu.hivemq.cloud -p 8883 -u "xxxxx" -P "xxxxx" -t "device/a" -m '{"IMEI":"350693903995577", "temperature":19, "humidity":80, "pressure":1005}' 644 +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}' 645 + 567 567 {{/code}} 568 568 569 569 The chart will update with the values in realtime, as shown in the below image. ... ... @@ -572,10 +572,10 @@ 572 572 [[image:timeseries-4.png||height="316" width="700"]] 573 573 574 574 575 -= 8. ConfigurePhysicalNB-IoT Sensor =654 += 7. Configure NB-IoT Sensor = 576 576 577 577 578 -Now, let's experiment with sending data to ThingsBoard using a real NB-IoT device. For example, we will use the ** TS01-NB**.657 +Now, let's experiment with sending data to ThingsBoard using a real NB-IoT device. For example, we will use the **S31B-NB**. 579 579 580 580 First, configure the NB-IoT device with the necessary MQTT settings using AT commands. Below is a list of AT commands you can use. 581 581 ... ... @@ -583,8 +583,8 @@ 583 583 **AT Commands** 584 584 585 585 * **AT+PRO=3,3 **~/~/ Use MQTT to connect to ThingsBoard. Payload Type set to 3. 586 -* **AT+SUBTOPIC=<MQTT subscribetopic>Eg: TS01-NB**587 -* **AT+PUBTOPIC=<MQTT publishtopic>Eg: TS01-NB**665 +* **AT+SUBTOPIC=<MQTT topic>** 666 +* **AT+PUBTOPIC=<MQTT topic>** 588 588 * **AT+CLIENT=null** 589 589 * **AT+UNAME=<MQTT Username>** 590 590 * **AT+PWD=<MQTT Password>** ... ... @@ -591,10 +591,7 @@ 591 591 * **AT+SERVADDR=<Broker address, Port>** 592 592 593 593 Test your uplink by pressing the ACT button for 1 second. 594 - 595 595 596 596 597 -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. 598 598 599 - 600 -[[image:image-4.png]] 676 +
- Screenshot 2025-03-16 at 18.39.12.png
-
- Size
-
... ... @@ -1,1 +1,1 @@ 1 -2 11.9KB1 +277.0 KB - Content
- Screenshot 2025-03-26 at 18.15.08.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.pradeeka - Size
-
... ... @@ -1,1 +1,0 @@ 1 -92.2 KB - Content
- Screenshot 2025-03-26 at 19.47.52.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.pradeeka - Size
-
... ... @@ -1,1 +1,0 @@ 1 -168.4 KB - Content
- Screenshot 2025-03-26 at 19.49.31.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.pradeeka - Size
-
... ... @@ -1,1 +1,0 @@ 1 -133.0 KB - Content
- Screenshot 2025-03-31 at 06.51.15.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.pradeeka - Size
-
... ... @@ -1,1 +1,0 @@ 1 -179.5 KB - Content
- add-integartion-connection.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.pradeeka - Size
-
... ... @@ -1,1 +1,0 @@ 1 -110.3 KB - Content
- add-integartion-connetcion.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.pradeeka - Size
-
... ... @@ -1,1 +1,0 @@ 1 -146.0 KB - Content
- add-integration-basic-settings.png
-
- Size
-
... ... @@ -1,1 +1,1 @@ 1 -12 3.8KB1 +122.5 KB - Content
- add-integration-connection.png
-
- Size
-
... ... @@ -1,1 +1,1 @@ 1 -15 8.1KB1 +153.2 KB - Content
- add-integration-ul-data-converter.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.pradeeka - Size
-
... ... @@ -1,1 +1,0 @@ 1 -121.2 KB - Content
- debug-enabled.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.pradeeka - Size
-
... ... @@ -1,1 +1,0 @@ 1 -196.3 KB - Content
- integration-active.png
-
- Size
-
... ... @@ -1,1 +1,1 @@ 1 -64. 1KB1 +64.2 KB - Content
- integration-added.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.pradeeka - Size
-
... ... @@ -1,1 +1,0 @@ 1 -196.2 KB - Content
- integration-dl-skip.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.pradeeka - Size
-
... ... @@ -1,1 +1,0 @@ 1 -105.5 KB - Content
- ul-data-converter-added.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.pradeeka - Size
-
... ... @@ -1,1 +1,0 @@ 1 -189.4 KB - Content
- ul-data-converter-device-a.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.pradeeka - Size
-
... ... @@ -1,1 +1,0 @@ 1 -168.3 KB - Content