Last modified by Mengting Qiu on 2025/03/08 11:33
<
From version < 53.21 >
edited by Xiaoling
on 2023/08/02 14:23
To version < 53.24 >
edited by Xiaoling
on 2023/08/02 14:44
>
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -234,10 +234,10 @@
234 234  == 3.4.1 Define Product ==
235 235  
236 236  
237 -Firstly, we need to set the MQTT mode to datacake, and we need to run** AT+PRO=3,2**. This command is set to datacake. After running the command, the device automatically sets the server address, port.
237 +Firstly, we need to set the MQTT mode to datacake, and we need to run(% style="color:blue" %)** AT+PRO=3,2**(%%). This command is set to datacake. After running the command, the device automatically sets the server address, port.
238 238  
239 239  
240 -By chosing to add the device under a (% style="color:blue" %)**"New Product"**(%%) you are required to give a name for this product. You can name it something like "My First MQTT Product".
240 +By chosing to add the device under a (% style="color:blue" %)**"New Product"**(%%) you are required to give a name for this product. You can name it something like (% style="color:blue" %)**"My First MQTT Product"**.
241 241  
242 242  [[image:image-20230802112413-14.png]]
243 243  
... ... @@ -249,7 +249,7 @@
249 249  
250 250  [[image:image-20230802112413-15.png]]
251 251  
252 -Enter a name here (such as "My First MQTT Device") and complete the creation of the device by clicking on the "Next" button.
252 +Enter a name here (such as "My First MQTT Device") and complete the creation of the device by clicking on the (% style="color:blue" %)**"Next"**(%%) button.
253 253  
254 254  
255 255  === 3.4.3 Create Database Fields ===
... ... @@ -257,13 +257,13 @@
257 257  
258 258  After creating the device, it is listed in the table of the fleet view. Now open the device by clicking on the entry in the list.
259 259  
260 -You will then see a device view with an empty dashboard. Now, the first thing we want to do is navigate to the Device configuration. To do this, use the tab bar and click on "Configuration".
260 +You will then see a device view with an empty dashboard. Now, the first thing we want to do is navigate to the Device configuration. To do this, use the tab bar and click on (% style="color:blue" %)**"Configuration"**.
261 261  
262 262  [[image:image-20230802112413-16.png]]
263 263  
264 264  [[image:image-20230802112413-17.png]]
265 265  
266 -To create a first database field, please click on the "Add Field" button as marked in the screenshot above.
266 +To create a first database field, please click on the (% style="color:blue" %)**"Add Field"**(%%) button as marked in the screenshot above.
267 267  
268 268  This will open another modal asking for some required input for your first field.
269 269  
... ... @@ -275,13 +275,13 @@
275 275  === 3.4.4 Set up Broker ===
276 276  
277 277  
278 -The broker is running on mqtt.datacake.co on ports 1883 and 8883. Port 1883 is unsecured and should not be used in production environments. Port 8883 uses a CA signed server certificate.
278 +The broker is running on mqtt.datacake.co on ports (% style="color:blue" %)**1883 and 8883**(%%). Port 1883 is unsecured and should not be used in production environments. Port 8883 uses a CA signed server certificate.
279 279  
280 280  You will need an access token to log into the Datacake MQTT Broker. You can use your own personal token or create a token explicitly for individual devices or groups of devices.
281 281  
282 282  View your Personal Access Token
283 283  
284 -You can view your own token via the User-Settings-Menu. You can reach this menu by clicking on "Edit Profile" at the end of the list using the Workspace Selector:
284 +You can view your own token via the User-Settings-Menu. You can reach this menu by clicking on (% style="color:blue" %)**"Edit Profile"**(%%) at the end of the list using the Workspace Selector:
285 285  
286 286  [[image:image-20230802112413-20.png]]
287 287  
... ... @@ -360,6 +360,7 @@
360 360  
361 361  [[image:image-20230802112413-30.png]]
362 362  
363 +
363 363  === 3.5.2 Simulate Connection ===
364 364  
365 365  
... ... @@ -386,16 +386,17 @@
386 386  
387 387  === 3.6.1 Configure ThingsBoard ===
388 388  
389 -=== 1.1.1 Create Device ===
390 +==== 3.6.1.1 Create Device ====
390 390  
391 391  Create a New Device in [[ThingsBoard>>url:https://thingsboard.cloud/]].
392 392  
393 393  [[image:image-20230802112413-32.png]]
394 394  
395 -=== 1.1.2 Create Uplink & Downlink Converter ===
396 396  
397 -Uplink Converter
397 +==== 3.6.1.2 Create Uplink & Downlink Converter ====
398 398  
399 +(% style="color:blue" %)**Uplink Converter**
400 +
399 399  The purpose of the decoder function is to parse the incoming data and metadata to a format that ThingsBoard can consume. deviceName and deviceType are required, while attributes and telemetry are optional. Attributes and telemetry are flat key-value objects. Nested objects are not supported.
400 400  
401 401  To create an uplink converter go to the Integrations center -> Data converters page and click “plus” button. Name it “MQTT Uplink Converter” and select type Uplink. Use debug mode for now.
... ... @@ -403,18 +403,20 @@
403 403  [[image:image-20230802112413-33.png]]
404 404  
405 405  
406 -Downlink Converter
408 +(% style="color:blue" %)**Downlink Converter**
407 407  
408 408  The Downlink converter transforming outgoing RPC message and then the Integration sends it to external MQTT broke
409 409  
410 410  [[image:image-20230802112413-34.png]]
411 411  
412 -Note:Our device payload is already human readable data. Therefore, users do not need to write decoders. Simply create by default.
414 +(% style="color:red" %)**Note:Our device payload is already human readable data. Therefore, users do not need to write decoders. Simply create by default.**
413 413  
414 -=== 1.1.3 MQTT Integration Setup ===
415 415  
416 -Go to the Integrations center -> Integrations page and click “plus” icon to add a new integration. Name it “MQTT Integration”, select type MQTT;
417 +==== 3.6.1.3 MQTT Integration Setup ====
417 417  
419 +
420 +Go to the Integrations center -> Integrations page and click **“plus”** icon to add a new integration. Name it “MQTT Integration”, select type MQTT;
421 +
418 418  [[image:image-20230802112413-35.png]]
419 419  
420 420  * The next steps is to add the recently created uplink and downlink converters;
... ... @@ -423,7 +423,7 @@
423 423  
424 424  [[image:image-20230802112413-37.png]]
425 425  
426 -Add a topic filter:
430 +(% style="color:blue" %)**Add a topic filter:**
427 427  
428 428  
429 429  tb/mqtt-integration-tutorial/sensors~/~/temperature ~-~-> Temperature 固定的? 对的。
... ... @@ -432,30 +432,32 @@
432 432  
433 433  [[image:image-20230802112413-38.png]]
434 434  
435 -== 1.2 Simulate with MQTT.fx ==
436 436  
440 +=== 3.6.2 Simulate with MQTT.fx ===
441 +
437 437  [[image:image-20230802112413-39.png]]
438 438  
439 439  [[image:image-20230802112413-40.png]]
440 440  
441 -== 1.3 Configure NB-IoT Sensor ==
442 442  
443 -AT Commands
447 +=== 3.6.3 Configure NB-IoT Sensor ===
444 444  
445 -AT+PRO=3,3  ~/~/ Use MQTT to connect to ThingsBoard.
449 +(% style="color:blue" %)**AT Commands**
446 446  
447 -AT+SUBTOPIC=device name ~-~-> 只需要 Device Name 吗?对的
451 +(% style="color:#037691" %)**AT+PRO=3,3  (%%)  ~/~/ Use MQTT to connect to ThingsBoard.
448 448  
449 -AT+PUBTOPIC=device name ~-~-> 只需要 Device Name 吗?对的
453 +(% style="color:#037691" %)**AT+SUBTOPIC=device name** (%%)  ~-~-> 只需要 Device Name 吗?对的
450 450  
455 +(% style="color:#037691" %)**AT+PUBTOPIC=device name** (%%)  ~-~-> 只需要 Device Name 吗?对的
451 451  
457 +
452 452  Users do not need to fill in the client, username, and password. But the configuration information of the device requires setting the client, username, and password, which can be entered freely. (软件自动填充为 Device Name 吧).这边不用提示了，客户不需要输入。（大部分客户还是会自己去设置这个的，提高安全性）
453 453  
454 -CLIENT :“Any value”
460 +(% style="color:blue" %)**CLIENT :“Any value”**
455 455  
456 -User Name:“Any value”
462 +(% style="color:blue" %)**User Name:“Any value”**
457 457  
458 -Password:“Any value”
464 +(% style="color:blue" %)**Password:“Any value”**
459 459  
460 460  
461 461  Test Uplink by click the button for 1 second
... ... @@ -467,10 +467,11 @@
467 467  [[image:image-20230802112413-43.png]]
468 468  
469 469  
470 -= 7. [[Tago.io>>url:https://admin.tago.io/]] (via MQTT) =
476 +== 3.7 [[Tago.io>>url:https://admin.tago.io/]] (via MQTT) ==
471 471  
472 -== 5.1 Create device & Get Credentials ==
478 +=== 3.7.1 Create device & Get Credentials ===
473 473  
480 +
474 474  We use MQTT Connection to send data to [[Tago.io>>url:https://admin.tago.io/]]. We need to Create Device and Get MQTT Credentials first.
475 475  
476 476  [[image:image-20230802112413-44.png]]
... ... @@ -477,7 +477,6 @@
477 477  
478 478  [[image:image-20230802112413-45.png]]
479 479  
480 -= =
481 481  
482 482  Go to the Device section and create a device. Then, go to the section tokens and copy your device-token.
483 483  
... ... @@ -486,20 +486,30 @@
486 486  
487 487  On the Connection Profile window, set the following information: (这边加一个截图)
488 488  
489 -* Profile Name: “Any name”
490 -* Broker Address: mqtt.tago.io
491 -* Broker Port: 1883
492 -* Client ID: “Any value”
495 +* (% style="color:blue" %)**Profile Name: “Any name”**
493 493  
497 +* (% style="color:blue" %)**Broker Address: mqtt.tago.io**
498 +
499 +* (% style="color:blue" %)**Broker Port: 1883**
500 +
501 +* (% style="color:blue" %)**Client ID: “Any value”**
502 +
494 494  On the section User credentials, set the following information:(这边加一个截图)
495 495  
496 -* User Name: “Any value” Tago validates your user by the token only
497 -* Password: “Your device token”
498 -* PUBTOPIC: “Any value”
499 -* SUBTOPIC: “Any value”
505 +* **User Name: “Any value”** (%%) Tago validates your user by the token only
500 500  
501 -== 5.2 Simulate with MQTT.fx ==
507 +* **Password: “Your device token”**
502 502  
509 +* **PUBTOPIC: “Any value”**
510 +
511 +* **SUBTOPIC: “Any value”**
512 +
513 +
514 +
515 +
516 +=== 3.7.2 Simulate with MQTT.fx ===
517 +
518 +
503 503  [[image:image-20230802112413-47.png]]
504 504  
505 505  [[image:image-20230802112413-48.png]]
... ... @@ -508,30 +508,40 @@
508 508  
509 509  [[image:image-20230802112413-49.png]]
510 510  
511 -== 1.4. tago data ==
512 512  
528 +=== 3.7.3 tago data ===
513 513  
530 +
514 514  [[image:image-20230802112413-50.png]]
515 515  
516 516  [[image:image-20230802112413-51.png]]
517 517  
518 -== 1.4. TLS mode ==
519 519  
520 -Users can choose to use SSL/TLS mode.
536 +=== 3.7.4 TLS mode ===
521 521  
522 -On the SSL/TLS section, check the option Enable SSL/TLS, and click OK.
523 523  
524 -The device needs to enable the TLS mode and set the AT+TLSMOD=1,0 command.
539 +Users can choose to use (% style="color:blue" %)**SSL/TLS**(%%) mode.
525 525  
526 -* Profile Name: “Any name”
527 -* Broker Address: mqtt.tago.io
528 -* Broker Port: 8883
529 -* Client ID: “Any value”
530 -* User Name: “Any value” Tago validates your user by the token only
531 -* Password: “Your device token”
532 -* PUBTOPIC: “Any value”
533 -* SUBTOPIC: “Any value”
541 +On the SSL/TLS section, check the option **Enable SSL/TLS**, and click OK.
534 534  
543 +The device needs to enable the TLS mode and set the (% style="color:blue" %)**AT+TLSMOD=1,0**(%%) command.
544 +
545 +* (% style="color:blue" %)**Profile Name: “Any name”**
546 +
547 +* (% style="color:blue" %)**Broker Address: mqtt.tago.io**
548 +
549 +* (% style="color:blue" %)**Broker Port: 8883**
550 +
551 +* (% style="color:blue" %)**Client ID: “Any value”**
552 +
553 +* (% style="color:blue" %)**User Name: “Any value”** (%%) Tago validates your user by the token only
554 +
555 +* (% style="color:blue" %)**Password: “Your device token”**
556 +
557 +* (% style="color:blue" %)**PUBTOPIC: “Any value”**
558 +
559 +* (% style="color:blue" %)**SUBTOPIC: “Any value”**
560 +
535 535  [[image:image-20230802112413-52.png]]
536 536  
537 537  

Applications

Navigation

Copyright ©2010-2024 Dragino Technology Co., LTD. All rights reserved
Dragino Wiki v2.0