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 (3 modified, 0 added, 17 removed)
- Screenshot 2025-03-16 at 18.38.59.png
- Screenshot 2025-03-16 at 18.39.12.png
- Screenshot 2025-03-18 at 09.23.10.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
- 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
- image-4.png
- integration-active.png
- integration-added.png
- integration-dl-skip.png
- mqtt-uplink.png
- new-device.png
- ul-data-converter-added.png
- ul-data-converter-device-a.png
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,157 +146,145 @@ 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 - =3.CreatingDevices=160 +On the **Data converters** page, click on the ‘**+**’ button, and then click on the **Create new converter** from the dropdown menu. 168 168 169 169 170 -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. 171 171 164 +[[image:create-new-converter-menu.png||height="259" width="500"]] 172 172 173 -In the left navigation, click Entities -> Devices. 174 174 175 - 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**. 176 176 177 - 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. 178 178 179 -Click the **Add** button. 171 +{{code language="JavaScript"}} 172 +/** Decoder **/ 180 180 181 -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); 182 182 183 -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'; 184 184 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 +}; 185 185 186 - =4.DataConverters=195 +/** Helper functions 'decodeToString' and 'decodeToJson' are already built-in **/ 187 187 197 +return result; 198 +{{/code}} 188 188 189 -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. 190 190 201 +Click on the **Add** button. 191 191 192 -== 4.1 Uplink == 193 193 194 194 195 - In the left navigation, click **Integrations center**,andthen click**Datas**.205 +[[image:add-uplink-data-converter.png||height="529" width="500"]] 196 196 197 197 198 - [[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. 199 199 210 +[[image:data-converter-list-showing-uplink-dc.png]] 200 200 201 -On the **Data converters** page, click on the ‘**+**’ button, and then click on the **Create new converter** from the dropdown menu. 202 202 203 203 214 +== 3.2 Downlink == 204 204 205 -[[image:create-new-converter-menu.png||height="259" width="500"]] 206 206 217 +On the **Data converters** page, click on the ‘**+**’ button, and then click on the **Create new converter** from the dropdown menu. 207 207 208 -The **Add data converter** window will appear. 209 209 210 - Let'screateanuplink dataconverterfor the device named '**Device A**'.Name it ‘**MQTT Uplink Converter - Device A**’ andselectthe Type as **Uplink**.220 +[[image:create-new-converter-menu.png||width="500"]] 211 211 212 -Click on the **TBEL** button if it has not been selected by default. 213 213 214 -Modify the default TBEL function to match with your device as described below: 215 215 224 +The **Add data converter** window will appear. Name it ‘**MQTT Downlink Converter NB/CB**’ and select the Type as **Downlink**. 216 216 217 -* Uncomment**line11**: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. 218 218 219 -//var data = decodeToJson(payload)// 220 220 229 +{{code language="JavaScript"}} 230 +// Encode downlink data from incoming Rule Engine message 221 221 222 -* **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. 223 -* From **line 38**: Modify the telemetry section to allow parsed data to be assigned to the fields. 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 224 224 225 -//telemetry: { 226 - temperature: data.temperature, 227 - humidity: data.humidity, 228 - rawData: payloadStr 229 - }// 237 +/** Encoder **/ 230 230 239 +var data = {}; 231 231 232 - Themodifieduplinkdecoderfunction tomatch with**Device A** ishownbelow.241 +// Process data from incoming message and metadata 233 233 234 -{{code language="JavaScript"}} 235 -// Decode an uplink message from a buffer 236 -// payload - array of bytes 237 -// metadata - key/value object 243 +data.tempFreq = msg.temperatureUploadFrequency; 244 +data.humFreq = msg.humidityUploadFrequency; 238 238 239 - /**Decoder**/246 +data.devSerialNumber = metadata['ss_serialNumber']; 240 240 241 -// decode payloadto string242 -var payloadStr=decodeToString(payload);248 +// Result object with encoded downlink payload 249 +var result = { 243 243 244 -// d ecodepayloadto JSON245 - vardata=decodeToJson(payload);251 + // downlink data content type: JSON, TEXT or BINARY (base64 format) 252 + contentType: "JSON", 246 246 247 -var deviceName = 'Device A'; 248 -var deviceType = 'thermostat'; 249 -var customerName = 'Customer C'; 250 -var groupName = 'thermostat devices'; 251 -var manufacturer = 'Example corporation'; 252 -// use assetName and assetType instead of deviceName and deviceType 253 -// to automatically create assets instead of devices. 254 -// var assetName = 'Asset A'; 255 -// var assetType = 'building'; 254 + // downlink data 255 + data: JSON.stringify(data), 256 256 257 -// Result object with device/asset attributes/telemetry data 258 -var result = { 259 -// Use deviceName and deviceType or assetName and assetType, but not both. 260 - deviceName: deviceName, 261 - deviceType: deviceType, 262 -// assetName: assetName, 263 -// assetType: assetType, 264 -// customerName: customerName, 265 - groupName: groupName, 266 - attributes: { 267 - model: 'Model A', 268 - serialNumber: 'SN111', 269 - integrationName: metadata['integrationName'], 270 - manufacturer: manufacturer 271 - }, 272 - telemetry: { 273 - temperature: data.temperature, 274 - humidity: data.humidity, 275 - rawData: payloadStr 276 - } 257 + // Optional metadata object presented in key/value format 258 + metadata: { 259 + topic: metadata['deviceType']+'/'+metadata['deviceName']+'/upload' 260 + } 261 + 277 277 }; 278 278 279 -/** Helper functions 'decodeToString' and 'decodeToJson' are already built-in **/ 280 - 281 281 return result; 282 282 {{/code}} 283 283 284 284 285 - Once you modify the decoder function, click on the **Add** button.268 +Click on the **Add** button. 286 286 287 287 288 288 289 -[[image: ul-data-converter-device-a.png||height="524" width="500"]]272 +[[image:add-downlink-data-converter.png||height="529" width="500"]] 290 290 291 291 292 -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. 293 293 294 294 295 -[[image: ul-data-converter-added.png||height="257"]]278 +[[image:data-converters-list.png]] 296 296 297 297 298 298 299 -= 5. Add Integration =282 += 4. Add Integration = 300 300 301 301 302 302 In the left navigation, click **Integrations center**, and then click **Integrations**. ... ... @@ -316,7 +316,7 @@ 316 316 **Basic settings:** 317 317 318 318 * **Integration type**: MQTT 319 -* **Name**: MQTT integration - Device A302 +* **Name**: MQTT integration NB/CB 320 320 * **Enable integration**: YES 321 321 * **Allows create devices or assets**: YES 322 322 ... ... @@ -323,11 +323,10 @@ 323 323 Click **Next** button. 324 324 325 325 326 -[[image:add-integration-basic-settings.png||height="504" width="500"]] 327 327 310 +[[image:add-integration-basic-settings.png||height="511" width="500"]] 328 328 329 329 330 - 331 331 **Uplink data converter:** 332 332 333 333 * Click on the **Select existing** button. ... ... @@ -336,38 +336,36 @@ 336 336 Click **Next** button. 337 337 338 338 339 -[[image:add-integration-ul-data-converter.png||height="505" width="500"]] 340 340 322 +[[image:add-integration-uplink-data-converter.png||height="511" width="500"]] 341 341 342 342 343 343 **Downlink data converter:** 344 344 345 -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. 346 346 347 - *Clickon the**Skip**buttonin the Downlink data converter section.330 +Click **Next** button. 348 348 349 -Click **Skip** button. 350 350 351 351 352 -[[image:integration-dl -skip.png||height="511" width="500"]]334 +[[image:add-integration-downlink-data-converter.png||height="511" width="500"]] 353 353 354 354 355 - 356 356 **Connection:** 357 357 358 -* **Host**: Host**//011731f7xxxxxxxxxxxfbbedfc63f4.s1.eu.hivemq.cloud//**)339 +* **Host**: Cluster URL (Eg. 011731f7928541588a6cdfbbedfc63f4.s1.eu.hivemq.cloud) 359 359 * **Port**: 8883 360 -* **Credentials type**: Basic 341 +* **Credentials**: Basic 342 +* **Enable SSL**: YES 361 361 * **Username**: Username (from your HiveMQ Cloud Cluster with your credentials) 362 362 * **Password:** Password (from your HiveMQ Cloud Cluster with your credentials) 363 -* **Enable SSL**: YES 364 -* **Topic: device/a** (The topic can be anything; you can even use just the device name.) 345 +* **Topic:** tb/mqtt-integration-tutorial/sensors/+/telemetry (the + replaces any 'device name' and creates devices in the Entities -> Devices) 365 365 * **QoS:** 0-At most once 366 366 348 +[[image:add-integration-connection.png||height="511" width="500"]] 367 367 368 -[[image:add-integartion-connection.png||height="505" width="500"]] 369 369 370 - 371 371 Click on the **Advanced settings** button. 372 372 373 373 * **Clean session:** YES ... ... @@ -395,36 +395,48 @@ 395 395 Since we haven't received data from a device yet, the integration **Status** is shown as **Pending.** 396 396 397 397 398 -[[image:integration-added.png]] 399 399 379 +[[image:new-integration-pending.png]] 400 400 401 401 402 -= 6. Verifying the receipt of data from virtual devices =382 += 5. Verifying the receipt of data from virtual devices = 403 403 404 404 405 -== 6.1 How does it work? ==385 +== 5.1 How does it work? == 406 406 407 407 408 408 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. 409 409 410 -The Mosquitto client publishes messages (payloads) on the topic**/device/a**.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. 411 411 412 - (%id="cke_bm_37386S"style="display:none"%) (%%)TheMQTTpayloadformat is as follows: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. 413 413 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 + 414 414 {{code language="none"}} 415 -{" IMEI": "350693903995577", "temperature":25, "humidity":80, "pressure":1005}409 +{"temperature":10.4, "humidity":85} 416 416 {{/code}} 417 417 418 -Once ThingsBoard receives this message, it forwards this payload to the matching device through the integration. 419 419 420 - 421 421 == 5.2 Sending messages == 422 422 423 423 424 -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 values350693903995577,30, 80,and1005 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. 425 425 426 426 {{code language="none"}} 427 -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}'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}' 428 428 {{/code}} 429 429 430 430 If the integration was performed without errors, the status of the integration changes to 'Active' after the first telemetry transmission. ... ... @@ -433,59 +433,43 @@ 433 433 [[image:integration-active.png]] 434 434 435 435 436 - ==6.3Viewingmessages==428 +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**. 437 437 438 438 439 - Go back to the**Integrations**page.431 +[[image:device-provision-1.png]] 440 440 441 -Click on the **MQTT integration NB/CB** in the **Integrations** page to see its details. 442 442 443 -Click on the **Edit**button(//**penicon**//).434 +Click on the device S31B-NB on the devices list to see its details. 444 444 445 - Clickonthe **Disabled** buttonintheupper-rightcorner.436 +Then go to the **Latest telemetry** tab. 446 446 447 - Turnonthe **All messages(15 min)** option. Thiswillenabledisplaying all messages inthe**Events** tab. This setting will expirein15minutes, andouwill needtorepeatthesametepsifyouwant toviewthe messagesin theEventstab later.438 +You can see the fields temperature and humidity with the values you previously sent using the MQTT message. 448 448 449 -Click on the **Apply** button. 450 450 451 - Then click onthe**Apply changes** (//**tick icon**//) button.441 +[[image:telemetry-1.png]] 452 452 453 453 454 - [[image:debug-enabled.png||height="301"width="700"]]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//. 455 455 456 456 447 +[[image:telemetry-2.png]] 457 457 458 458 459 - Nowgoto the**Events** tab.450 +Let's provision the second device named **LDS25-NB **with initial telemetry. Use the following MQTT message. 460 460 461 -Select the **Event type** as **Debug** from the dropdown list. 462 462 463 -Publish another message (of course, you can repeat the previous message by pressing the UP arrow on your keyboard and then press Enter key) to your MQTT broker from your terminal, for example: 464 - 465 465 {{code language="none"}} 466 -mosquitto_pub -d -q 1 -h 011731f7928 xxxxx.s1.eu.hivemq.cloud -p 8883 -u"xxxxx" -P"xxxxx" -t"device/a" -m '{"IMEI":"350693903995577", "temperature":30, "humidity":80, "pressure":1005}'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}' 467 467 {{/code}} 468 468 469 -Now you can seethatuplink message intheEvents**tab (Click the**refresh** buttonifyoudidn'tseeany messages intheEventstab). Thestatus shouldbeOK**ifthereis noerrorsn your integration.457 +Now, refresh the **Devices** page, and you will see the second device, **LDS25-NB**, which was recently provisioned. 470 470 471 471 472 -[[image: Screenshot 2025-03-26 at 19.49.31.png]]460 +[[image:device-provision-2.png]] 473 473 474 474 463 += 6. Creating a Dashboard = 475 475 476 -Then click on the **three dots (...)** in the **Message** column. You can see the uplink message's **payload** in the **Message** window. 477 - 478 - 479 -[[image:Screenshot 2025-03-26 at 19.47.52.png]] 480 - 481 - 482 - 483 - 484 -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. 485 - 486 - 487 -= 7. Creating a Dashboard = 488 - 489 489 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. 490 490 491 491 ... ... @@ -492,11 +492,6 @@ 492 492 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. 493 493 494 494 495 -First simulate a few messages using MQTT. This time, we have added the 'humidity' field to the payload. Eg: 496 - 497 -{{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}} 498 - 499 - 500 500 In **ThingsBoard**, from the left navigation menu, click **Dashboards**. Then, click the **+** button and select **Create new dashboard** from the dropdown menu. 501 501 502 502 ... ... @@ -553,11 +553,11 @@ 553 553 554 554 555 555 {{code language="none"}} 556 -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}' 557 557 558 -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}' 559 559 560 -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}' 561 561 562 562 {{/code}} 563 563 ... ... @@ -567,10 +567,10 @@ 567 567 [[image:timeseries-4.png||height="316" width="700"]] 568 568 569 569 570 -= 8. Configure NB-IoT Sensor =541 += 7. Configure NB-IoT Sensor = 571 571 572 572 573 -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**. 574 574 575 575 First, configure the NB-IoT device with the necessary MQTT settings using AT commands. Below is a list of AT commands you can use. 576 576 ... ... @@ -578,8 +578,8 @@ 578 578 **AT Commands** 579 579 580 580 * **AT+PRO=3,3 **~/~/ Use MQTT to connect to ThingsBoard. Payload Type set to 3. 581 -* **AT+SUBTOPIC=<MQTT subscribetopic>Eg: TS01-NB**582 -* **AT+PUBTOPIC=<MQTT publishtopic>Eg: TS01-NB**552 +* **AT+SUBTOPIC=<MQTT topic>** 553 +* **AT+PUBTOPIC=<MQTT topic>** 583 583 * **AT+CLIENT=null** 584 584 * **AT+UNAME=<MQTT Username>** 585 585 * **AT+PWD=<MQTT Password>** ... ... @@ -586,13 +586,3 @@ 586 586 * **AT+SERVADDR=<Broker address, Port>** 587 587 588 588 Test your uplink by pressing the ACT button for 1 second. 589 - 590 - 591 - 592 -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**. 593 - 594 -{{info}} 595 -The ThingsBoard uses the device's IMEI number included in the payload to create a device in the Devices section. 596 -{{/info}} 597 - 598 -[[image:image-4.png]]
- 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
- 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
- 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 -1 58.1KB1 +124.4 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
- image-4.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.pradeeka - Size
-
... ... @@ -1,1 +1,0 @@ 1 -96.0 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
- 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
- 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