Last modified by Mengting Qiu on 2025/03/08 11:33
<
From version < 53.25 >
edited by Xiaoling
on 2023/08/02 14:46
To version < 53.44 >
edited by Xiaoling
on 2023/08/02 15:28
>
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -4,7 +4,6 @@
4 4  {{toc/}}
5 5  
6 6  
7 -
8 8  = 1. The use of this guideline =
9 9  
10 10  
... ... @@ -21,6 +21,7 @@
21 21  |1NCE| | |
22 22  |China Mobile| | |
23 23  
23 +
24 24  == 2.1 1NCE SIM Card. ==
25 25  
26 26  
... ... @@ -105,9 +105,9 @@
105 105  [[image:image-20230802112413-7.png]]
106 106  
107 107  
108 -== 3.3.2 Simulate with MQTT.fx ==
108 +=== 3.3.2 Simulate with MQTT.fx ===
109 109  
110 -=== 3.3.2.1 Establish MQTT Connection ===
110 +==== 3.3.2.1 Establish MQTT Connection ====
111 111  
112 112  
113 113  After we got MQTT Credentials, we can first simulate with PC tool MQTT.fx tool to see if the Credentials and settings are fine.
... ... @@ -124,12 +124,16 @@
124 124  
125 125  * (% style="color:#037691" %)**Password:**(%%) <Your ThingSpeak MQTT Password>
126 126  
127 -=== 3.3.2.2 Publish Data to ThingSpeak Channel ===
128 128  
128 +
129 +==== 3.3.2.2 Publish Data to ThingSpeak Channel ====
130 +
131 +
129 129  [[image:image-20230802112413-9.png]]
130 130  
131 131  [[image:image-20230802112413-10.png]]
132 132  
136 +
133 133  (% style="color:blue" %)**In MQTT.fx, we can publish below info:**
134 134  
135 135  * (% style="color:#037691" %)**Topic:**(%%) channels/YOUR_CHANNEL_ID/publish
... ... @@ -144,28 +144,30 @@
144 144  [[image:image-20230802112413-11.png]]
145 145  
146 146  
147 -== 3.3 Configure NB-IoT Sensor for connection ==
151 +=== 3.3.3 Configure NB-IoT Sensor for connection ===
148 148  
149 -=== 3.3.1 AT Commands: ===
153 +==== 3.3.3.1 AT Commands: ====
150 150  
151 151  
152 152  In the NB-IoT, we can run below commands so to publish the channels like MQTT.fx
153 153  
154 -* **AT+PRO=3,1**   ~/~/ Set to use ThingSpeak Server and Related Payload
158 +* (% style="color:blue" %)**AT+PRO=3,1** (%%) ~/~/ Set to use ThingSpeak Server and Related Payload
155 155  
156 -* **AT+CLIENT=<Your ThingSpeak MQTT ClientID>**
160 +* (% style="color:blue" %)**AT+CLIENT=<Your ThingSpeak MQTT ClientID>**
157 157  
158 -* **AT+UNAME=<Your ThingSpeak MQTT User Name>**
162 +* (% style="color:blue" %)**AT+UNAME=<Your ThingSpeak MQTT User Name>**
159 159  
160 -* **AT+PWD=<Your ThingSpeak MQTT Password>**
164 +* (% style="color:blue" %)**AT+PWD=<Your ThingSpeak MQTT Password>**
161 161  
162 -* **AT+PUBTOPIC=<YOUR_CHANNEL_ID>**
166 +* (% style="color:blue" %)**AT+PUBTOPIC=<YOUR_CHANNEL_ID>**
163 163  
164 -* **AT+SUBTOPIC=<YOUR_CHANNEL_ID>**
168 +* (% style="color:blue" %)**AT+SUBTOPIC=<YOUR_CHANNEL_ID>**
165 165  
166 -=== 3.3.2 Uplink Examples ===
167 167  
168 168  
172 +==== 3.3.3.2 Uplink Examples ====
173 +
174 +
169 169  For S31-NB
170 170  
171 171  For SE01-NB
... ... @@ -191,7 +191,7 @@
191 191  For SN50V3-NB
192 192  
193 193  
194 -=== 3.3.3 Map fields to sensor value ===
200 +==== 3.3.3.3 Map fields to sensor value ====
195 195  
196 196  
197 197  When NB-IoT sensor upload to ThingSpeak. The payload already specify which fileds related to which sensor value. Use need to create fileds in Channels Settings. with name so to see the value correctly.
... ... @@ -225,18 +225,16 @@
225 225  |(% colspan="1" style="background-color:#4f81bd; color:white; width:124px" %)mod5|(% colspan="1" style="width:91px" %)mod|(% colspan="1" style="width:102px" %)Battery|(% colspan="1" style="width:159px" %)RSSI|(% colspan="1" style="width:153px" %)DS18B20 Temp|(% colspan="1" style="width:152px" %)adc0|(% colspan="1" style="width:148px" %)exit_state/input PA4|(% colspan="1" style="width:164px" %)Weight|(% colspan="1" style="width:152px" %) |(% colspan="1" style="width:66px" %) |(% colspan="1" style="width:66px" %)
226 226  |(% colspan="1" style="background-color:#4f81bd; color:white; width:124px" %)mod6|(% colspan="1" style="width:91px" %)mod|(% colspan="1" style="width:102px" %)Battery|(% colspan="1" style="width:159px" %)RSSI|(% colspan="1" style="width:153px" %)count|(% colspan="1" style="width:152px" %) |(% colspan="1" style="width:148px" %) |(% colspan="1" style="width:164px" %) |(% colspan="1" style="width:152px" %) |(% colspan="1" style="width:66px" %) |(% colspan="1" style="width:66px" %)
227 227  
228 -
229 229  == 3.4 Datacake ==
230 230  
231 -== 3.4.1 Define Product ==
236 +=== 3.4.1 Define Product ===
232 232  
233 233  
234 234  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.
235 235  
236 -
237 237  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"**.
238 238  
239 -[[image:image-20230802112413-14.png]]
243 +[[image:image-20230802112413-14.png||height="1095" width="1302"]]
240 240  
241 241  
242 242  === 3.4.2 Create Device ===
... ... @@ -244,7 +244,7 @@
244 244  
245 245  In the second step you have to define the device which should be added to the product.
246 246  
247 -[[image:image-20230802112413-15.png]]
251 +[[image:image-20230802112413-15.png||height="859" width="1290"]]
248 248  
249 249  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.
250 250  
... ... @@ -256,15 +256,15 @@
256 256  
257 257  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"**.
258 258  
259 -[[image:image-20230802112413-16.png]]
263 +[[image:image-20230802112413-16.png||height="495" width="1310"]]
260 260  
261 -[[image:image-20230802112413-17.png]]
265 +[[image:image-20230802112413-17.png||height="741" width="1303"]]
262 262  
263 263  To create a first database field, please click on the (% style="color:blue" %)**"Add Field"**(%%) button as marked in the screenshot above.
264 264  
265 265  This will open another modal asking for some required input for your first field.
266 266  
267 -[[image:image-20230802112413-18.png]]
271 +[[image:image-20230802112413-18.png||height="878" width="1305"]]
268 268  
269 269  [[image:image-20230802112413-19.png]]
270 270  
... ... @@ -282,15 +282,17 @@
282 282  
283 283  [[image:image-20230802112413-20.png]]
284 284  
289 +
285 285  (% style="color:blue" %)**MQTT Client-ID**
286 286  
287 -The Datacake Broker manages the client IDs internally. You do not need to worry about a client ID. If your client optionally supports the specification of a client ID, please leave this specification blank. Your client then creates a randomly generated ID.
292 +The Datacake Broker manages the client IDs internally. You do not need to worry about a client ID. If your client optionally supports the specification of a client ID, please leave this 
293 +specification blank. Your client then creates a randomly generated ID.
288 288  
289 -(% style="color:blue" %)**AT+CLIENT=“Any value”**
295 +* (% style="color:blue" %)**AT+CLIENT=“Any value”**
290 290  
291 -(% style="color:blue" %)**AT+UNAME=Token**
297 +* (% style="color:blue" %)**AT+UNAME=Token**
292 292  
293 -(% style="color:blue" %)**AT+PWD=Token**
299 +* (% style="color:blue" %)**AT+PWD=Token**
294 294  
295 295  [[image:image-20230802112413-21.png]]
296 296  
... ... @@ -300,10 +300,8 @@
300 300  
301 301  (% style="color:blue" %)**Subscribe**
302 302  
303 -Data is published according to the following structure:
309 +Data is published according to the following structure: (% style="color:blue" %)**dtck~/~//**(%%)** **
304 304  
305 -dtck~/~//
306 -
307 307  Subscribe to topics using this structure to receive messages via MQTT when readings (via API or MQTT) arrive in the Datacake Cloud. Messages are published whenever there is a change to a corresponding database field.
308 308  
309 309  
... ... @@ -330,10 +330,8 @@
330 330  
331 331  To upload data into the Datacake Cloud and into a specific device, you publish the data to the respective topic structure.
332 332  
333 -Due to the nature of MQTT, the topic prefix differs as follows:
337 +Due to the nature of MQTT, the topic prefix differs as follows: (% style="color:blue" %)**dtck-pub~/~//**
334 334  
335 -dtck-pub~/~//
336 -
337 337  (% style="color:blue" %)**example:**
338 338  
339 339  AT+SUBTOPIC=dtck/nbmattest/936c0db6-e9a5-4353-9fdb-3f63c8bfce7e/Temperature
... ... @@ -353,8 +353,10 @@
353 353  
354 354  === 3.5.1 Configure Node-Red ===
355 355  
358 +
356 356  [[image:image-20230802112413-29.png]]
357 357  
361 +
358 358  [[image:image-20230802112413-30.png]]
359 359  
360 360  
... ... @@ -367,7 +367,7 @@
367 367  === 3.5.3 Configure NB-IoT Sensors ===
368 368  
369 369  
370 -* (% style="color:blue" %)**AT+PRO=3,0(hex format) or 3,5(json format)**(%%)    ~/~/Set to mqtt Server and  Payload
374 +* (% style="color:blue" %)**AT+PRO=3,0(hex format) or 3,5(json format)**(%%)    ~/~/  Set to mqtt Server and  Payload
371 371  
372 372  * (% style="color:blue" %)**AT+CLIENT=any value**
373 373  
... ... @@ -379,6 +379,7 @@
379 379  
380 380  * (% style="color:blue" %)**AT+SUBTOPIC=any value**
381 381  
386 +
382 382  == 3.6 ThingsBoard.Cloud (via MQTT) ==
383 383  
384 384  === 3.6.1 Configure ThingsBoard ===
... ... @@ -385,6 +385,7 @@
385 385  
386 386  ==== 3.6.1.1 Create Device ====
387 387  
393 +
388 388  Create a New Device in [[ThingsBoard>>url:https://thingsboard.cloud/]].
389 389  
390 390  [[image:image-20230802112413-32.png]]
... ... @@ -392,13 +392,14 @@
392 392  
393 393  ==== 3.6.1.2 Create Uplink & Downlink Converter ====
394 394  
401 +
395 395  (% style="color:blue" %)**Uplink Converter**
396 396  
397 397  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.
398 398  
399 -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.
406 +To create an uplink converter go to the (% style="color:blue" %)**Integrations center**(%%) -> (% style="color:blue" %)**Data converters**(%%) page and click (% style="color:blue" %)**“plus”** (%%)button. Name it (% style="color:blue" %)**“MQTT Uplink Converter”**(%%) and select type (% style="color:blue" %)"**Uplink"**(%%). Use debug mode for now.
400 400  
401 -[[image:image-20230802112413-33.png]]
408 +[[image:image-20230802112413-33.png||height="732" width="1302"]]
402 402  
403 403  
404 404  (% style="color:blue" %)**Downlink Converter**
... ... @@ -405,7 +405,7 @@
405 405  
406 406  The Downlink converter transforming outgoing RPC message and then the Integration sends it to external MQTT broke
407 407  
408 -[[image:image-20230802112413-34.png]]
415 +[[image:image-20230802112413-34.png||height="734" width="1305"]]
409 409  
410 410  (% style="color:red" %)**Note:Our device payload is already human readable data. Therefore, users do not need to write decoders. Simply create by default.**
411 411  
... ... @@ -413,28 +413,30 @@
413 413  ==== 3.6.1.3 MQTT Integration Setup ====
414 414  
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;
423 +Go to the (% style="color:blue" %)**Integrations center**(%%) **->** (% style="color:blue" %)**Integrations page**(%%) and click **“(% style="color:blue" %)plus(%%)”** icon to add a new integration. Name it (% style="color:blue" %)**“MQTT Integration”**(%%), select type (% style="color:blue" %)**MQTT**;
417 417  
418 -[[image:image-20230802112413-35.png]]
425 +[[image:image-20230802112413-35.png||height="738" width="1312"]]
419 419  
427 +
420 420  * The next steps is to add the recently created uplink and downlink converters;
421 421  
422 -[[image:image-20230802112413-36.png]]
430 +[[image:image-20230802112413-36.png||height="736" width="1308"]]
423 423  
424 -[[image:image-20230802112413-37.png]]
432 +[[image:image-20230802112413-37.png||height="735" width="1307"]]
425 425  
434 +
426 426  (% style="color:blue" %)**Add a topic filter:**
427 427  
437 +tb/mqtt-integration-tutorial/sensors~/~/temperature ~-~-> Temperature  **固定的? 对的。**
428 428  
429 -tb/mqtt-integration-tutorial/sensors~/~/temperature ~-~-> Temperature 固定的? 对的。
430 -
431 431  You can also select an MQTT QoS level. We use MQTT QoS level 0 (At most once) by default;
432 432  
433 -[[image:image-20230802112413-38.png]]
441 +[[image:image-20230802112413-38.png||height="731" width="1300"]]
434 434  
435 435  
436 436  === 3.6.2 Simulate with MQTT.fx ===
437 437  
446 +
438 438  [[image:image-20230802112413-39.png]]
439 439  
440 440  [[image:image-20230802112413-40.png]]
... ... @@ -447,13 +447,12 @@
447 447  
448 448  * (% style="color:#037691" %)**AT+PRO=3,3  **(%%)** **~/~/ Use MQTT to connect to ThingsBoard.
449 449  
450 -* (% style="color:#037691" %)**AT+SUBTOPIC=device name** (%%) ~-~-> 只需要 Device Name 吗?对的
459 +* (% style="color:#037691" %)**AT+SUBTOPIC=device name** (%%) **~-~-> 只需要 Device Name 吗?对的**
451 451  
452 -* (% style="color:#037691" %)**AT+PUBTOPIC=device name** (%%) ~-~-> 只需要 Device Name 吗?对的
461 +* (% style="color:#037691" %)**AT+PUBTOPIC=device name** (%%) **~-~-> 只需要 Device Name 吗?对的**
453 453  
463 +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 吧).这边不用提示了，客户不需要输入。（大部分客户还是会自己去设置这个的，提高安全性）**
454 454  
455 -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 吧).这边不用提示了，客户不需要输入。（大部分客户还是会自己去设置这个的，提高安全性）
456 -
457 457  (% style="color:blue" %)**CLIENT :“Any value”**
458 458  
459 459  (% style="color:blue" %)**User Name:“Any value”**
... ... @@ -487,7 +487,7 @@
487 487  [[image:image-20230802112413-46.png]]
488 488  
489 489  
490 -On the Connection Profile window, set the following information: (这边加一个截图)
498 +On the Connection Profile window, set the following information: **(这边加一个截图)**
491 491  
492 492  * (% style="color:blue" %)**Profile Name: “Any name”**
493 493  
... ... @@ -497,15 +497,15 @@
497 497  
498 498  * (% style="color:blue" %)**Client ID: “Any value”**
499 499  
500 -On the section User credentials, set the following information:(这边加一个截图)
508 +On the section User credentials, set the following information: **(这边加一个截图)**
501 501  
502 -* **User Name: “Any value”**  Tago validates your user by the token only
510 +* (% style="color:blue" %)**User Name: “Any value”**  (%%) ~/~/  Tago validates your user by the token only
503 503  
504 -* **Password: “Your device token”**
512 +* (% style="color:blue" %)**Password: “Your device token”**
505 505  
506 -* **PUBTOPIC: “Any value”**
514 +* (% style="color:blue" %)**PUBTOPIC: “Any value”**
507 507  
508 -* **SUBTOPIC: “Any value”**
516 +* (% style="color:blue" %)**SUBTOPIC: “Any value”**
509 509  
510 510  
511 511  
... ... @@ -516,8 +516,9 @@
516 516  
517 517  [[image:image-20230802112413-48.png]]
518 518  
519 -Users can run the AT+PRO=3,5 command, and the payload will be converted to JSON format.
527 +Users can run the (% style="color:blue" %)**AT+PRO=3,5**(%%) command, and the payload will be converted to **JSON format**.
520 520  
529 +
521 521  [[image:image-20230802112413-49.png]]
522 522  
523 523  
... ... @@ -546,7 +546,7 @@
546 546  
547 547  * (% style="color:blue" %)**Client ID: “Any value”**
548 548  
549 -* (% style="color:blue" %)**User Name: “Any value”** (%%) Tago validates your user by the token only
558 +* (% style="color:blue" %)**User Name: “Any value”** (%%) ~/~/ Tago validates your user by the token only
550 550  
551 551  * (% style="color:blue" %)**Password: “Your device token”**
552 552  

Applications

Navigation

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