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,15 @@ 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 + 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"]]553 +[[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.558 +Select the Event type as **Debug** from the dropdown list. 464 464 465 - Publish anothermessage (of course,you canrepeatthe previousmessagebypressing theUParrowonyourkeyboardandthen pressEnter key) toyourMQTT brokerfromyour terminal, for example:560 +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. 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.563 +[[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]]569 +[[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 =575 += 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 ... ... @@ -496,7 +496,8 @@ 496 496 497 497 First simulate a few messages using MQTT. This time, we have added the 'humidity' field to the payload. Eg: 498 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}} 585 +{{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}' 586 +{{/code}} 500 500 501 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. ... ... @@ -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.624 +* **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}} 630 +[[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}'645 +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":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}'647 +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, "humidity":72}' 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}' 649 +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": 19, "humidity":80}' 650 + 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 =659 += 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**.662 +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,7 +583,7 @@ 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 subscribe topic> Eg: TS01-NB**670 +* **AT+SUBTOPIC=<MQTT subscribe topic> ** 587 587 * **AT+PUBTOPIC=<MQTT publish topic> Eg: TS01-NB** 588 588 * **AT+CLIENT=null** 589 589 * **AT+UNAME=<MQTT Username>** ... ... @@ -591,10 +591,11 @@ 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 fieldsinthepayload, IMEI, IMSI, Model, temperature, etc**. Note that we have created a device named**TS01-NB** in the**Devices**sectioninadvance.680 +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**. 598 598 599 - 600 600 [[image:image-4.png]] 683 + 684 + 685 +
- 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