<
From version < 53.47 >
edited by Xiaoling
on 2023/08/02 15:30
To version < 53.25 >
edited by Xiaoling
on 2023/08/02 14:46
>
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -4,6 +4,7 @@
4 4  {{toc/}}
5 5  
6 6  
7 +
7 7  = 1. The use of this guideline =
8 8  
9 9  
... ... @@ -20,7 +20,6 @@
20 20  |1NCE| | |
21 21  |China Mobile| | |
22 22  
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,16 +124,12 @@
124 124  
125 125  * (% style="color:#037691" %)**Password:**(%%) <Your ThingSpeak MQTT Password>
126 126  
127 +=== 3.3.2.2 Publish Data to ThingSpeak Channel ===
127 127  
128 -
129 -==== 3.3.2.2 Publish Data to ThingSpeak Channel ====
130 -
131 -
132 132  [[image:image-20230802112413-9.png]]
133 133  
134 134  [[image:image-20230802112413-10.png]]
135 135  
136 -
137 137  (% style="color:blue" %)**In MQTT.fx, we can publish below info:**
138 138  
139 139  * (% style="color:#037691" %)**Topic:**(%%) channels/YOUR_CHANNEL_ID/publish
... ... @@ -148,30 +148,28 @@
148 148  [[image:image-20230802112413-11.png]]
149 149  
150 150  
151 -=== 3.3.3 Configure NB-IoT Sensor for connection ===
147 +== 3.3 Configure NB-IoT Sensor for connection ==
152 152  
153 -==== 3.3.3.1 AT Commands: ====
149 +=== 3.3.1 AT Commands: ===
154 154  
155 155  
156 156  In the NB-IoT, we can run below commands so to publish the channels like MQTT.fx
157 157  
158 -* (% style="color:blue" %)**AT+PRO=3,1** (%%) ~/~/ Set to use ThingSpeak Server and Related Payload
154 +* **AT+PRO=3,1**   ~/~/ Set to use ThingSpeak Server and Related Payload
159 159  
160 -* (% style="color:blue" %)**AT+CLIENT=<Your ThingSpeak MQTT ClientID>**
156 +* **AT+CLIENT=<Your ThingSpeak MQTT ClientID>**
161 161  
162 -* (% style="color:blue" %)**AT+UNAME=<Your ThingSpeak MQTT User Name>**
158 +* **AT+UNAME=<Your ThingSpeak MQTT User Name>**
163 163  
164 -* (% style="color:blue" %)**AT+PWD=<Your ThingSpeak MQTT Password>**
160 +* **AT+PWD=<Your ThingSpeak MQTT Password>**
165 165  
166 -* (% style="color:blue" %)**AT+PUBTOPIC=<YOUR_CHANNEL_ID>**
162 +* **AT+PUBTOPIC=<YOUR_CHANNEL_ID>**
167 167  
168 -* (% style="color:blue" %)**AT+SUBTOPIC=<YOUR_CHANNEL_ID>**
164 +* **AT+SUBTOPIC=<YOUR_CHANNEL_ID>**
169 169  
166 +=== 3.3.2 Uplink Examples ===
170 170  
171 171  
172 -==== 3.3.3.2 Uplink Examples ====
173 -
174 -
175 175  For S31-NB
176 176  
177 177  For SE01-NB
... ... @@ -197,7 +197,7 @@
197 197  For SN50V3-NB
198 198  
199 199  
200 -==== 3.3.3.3 Map fields to sensor value ====
194 +=== 3.3.3 Map fields to sensor value ===
201 201  
202 202  
203 203  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.
... ... @@ -232,17 +232,17 @@
232 232  |(% 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" %)
233 233  
234 234  
235 -
236 236  == 3.4 Datacake ==
237 237  
238 -=== 3.4.1 Define Product ===
231 +== 3.4.1 Define Product ==
239 239  
240 240  
241 241  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.
242 242  
236 +
243 243  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"**.
244 244  
245 -[[image:image-20230802112413-14.png||height="1095" width="1302"]]
239 +[[image:image-20230802112413-14.png]]
246 246  
247 247  
248 248  === 3.4.2 Create Device ===
... ... @@ -250,7 +250,7 @@
250 250  
251 251  In the second step you have to define the device which should be added to the product.
252 252  
253 -[[image:image-20230802112413-15.png||height="859" width="1290"]]
247 +[[image:image-20230802112413-15.png]]
254 254  
255 255  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.
256 256  
... ... @@ -262,15 +262,15 @@
262 262  
263 263  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"**.
264 264  
265 -[[image:image-20230802112413-16.png||height="495" width="1310"]]
259 +[[image:image-20230802112413-16.png]]
266 266  
267 -[[image:image-20230802112413-17.png||height="741" width="1303"]]
261 +[[image:image-20230802112413-17.png]]
268 268  
269 269  To create a first database field, please click on the (% style="color:blue" %)**"Add Field"**(%%) button as marked in the screenshot above.
270 270  
271 271  This will open another modal asking for some required input for your first field.
272 272  
273 -[[image:image-20230802112413-18.png||height="878" width="1305"]]
267 +[[image:image-20230802112413-18.png]]
274 274  
275 275  [[image:image-20230802112413-19.png]]
276 276  
... ... @@ -288,17 +288,15 @@
288 288  
289 289  [[image:image-20230802112413-20.png]]
290 290  
291 -
292 292  (% style="color:blue" %)**MQTT Client-ID**
293 293  
294 -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 
295 -specification blank. Your client then creates a randomly generated ID.
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.
296 296  
297 -* (% style="color:blue" %)**AT+CLIENT=“Any value”**
289 +(% style="color:blue" %)**AT+CLIENT=“Any value”**
298 298  
299 -* (% style="color:blue" %)**AT+UNAME=Token**
291 +(% style="color:blue" %)**AT+UNAME=Token**
300 300  
301 -* (% style="color:blue" %)**AT+PWD=Token**
293 +(% style="color:blue" %)**AT+PWD=Token**
302 302  
303 303  [[image:image-20230802112413-21.png]]
304 304  
... ... @@ -308,8 +308,10 @@
308 308  
309 309  (% style="color:blue" %)**Subscribe**
310 310  
311 -Data is published according to the following structure: (% style="color:blue" %)**dtck~/~//**(%%)** **
303 +Data is published according to the following structure:
312 312  
305 +dtck~/~//
306 +
313 313  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.
314 314  
315 315  
... ... @@ -336,8 +336,10 @@
336 336  
337 337  To upload data into the Datacake Cloud and into a specific device, you publish the data to the respective topic structure.
338 338  
339 -Due to the nature of MQTT, the topic prefix differs as follows: (% style="color:blue" %)**dtck-pub~/~//**
333 +Due to the nature of MQTT, the topic prefix differs as follows:
340 340  
335 +dtck-pub~/~//
336 +
341 341  (% style="color:blue" %)**example:**
342 342  
343 343  AT+SUBTOPIC=dtck/nbmattest/936c0db6-e9a5-4353-9fdb-3f63c8bfce7e/Temperature
... ... @@ -357,10 +357,8 @@
357 357  
358 358  === 3.5.1 Configure Node-Red ===
359 359  
360 -
361 361  [[image:image-20230802112413-29.png]]
362 362  
363 -
364 364  [[image:image-20230802112413-30.png]]
365 365  
366 366  
... ... @@ -373,7 +373,7 @@
373 373  === 3.5.3 Configure NB-IoT Sensors ===
374 374  
375 375  
376 -* (% style="color:blue" %)**AT+PRO=3,0(hex format) or 3,5(json format)**(%%)    ~/~/  Set to mqtt Server and  Payload
370 +* (% style="color:blue" %)**AT+PRO=3,0(hex format) or 3,5(json format)**(%%)    ~/~/Set to mqtt Server and  Payload
377 377  
378 378  * (% style="color:blue" %)**AT+CLIENT=any value**
379 379  
... ... @@ -385,8 +385,6 @@
385 385  
386 386  * (% style="color:blue" %)**AT+SUBTOPIC=any value**
387 387  
388 -
389 -
390 390  == 3.6 ThingsBoard.Cloud (via MQTT) ==
391 391  
392 392  === 3.6.1 Configure ThingsBoard ===
... ... @@ -393,7 +393,6 @@
393 393  
394 394  ==== 3.6.1.1 Create Device ====
395 395  
396 -
397 397  Create a New Device in [[ThingsBoard>>url:https://thingsboard.cloud/]].
398 398  
399 399  [[image:image-20230802112413-32.png]]
... ... @@ -401,14 +401,13 @@
401 401  
402 402  ==== 3.6.1.2 Create Uplink & Downlink Converter ====
403 403  
404 -
405 405  (% style="color:blue" %)**Uplink Converter**
406 406  
407 407  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.
408 408  
409 -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.
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.
410 410  
411 -[[image:image-20230802112413-33.png||height="732" width="1302"]]
401 +[[image:image-20230802112413-33.png]]
412 412  
413 413  
414 414  (% style="color:blue" %)**Downlink Converter**
... ... @@ -415,7 +415,7 @@
415 415  
416 416  The Downlink converter transforming outgoing RPC message and then the Integration sends it to external MQTT broke
417 417  
418 -[[image:image-20230802112413-34.png||height="734" width="1305"]]
408 +[[image:image-20230802112413-34.png]]
419 419  
420 420  (% style="color:red" %)**Note:Our device payload is already human readable data. Therefore, users do not need to write decoders. Simply create by default.**
421 421  
... ... @@ -423,30 +423,28 @@
423 423  ==== 3.6.1.3 MQTT Integration Setup ====
424 424  
425 425  
426 -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**;
416 +Go to the Integrations center -> Integrations page and click **“plus”** icon to add a new integration. Name it “MQTT Integration”, select type MQTT;
427 427  
428 -[[image:image-20230802112413-35.png||height="738" width="1312"]]
418 +[[image:image-20230802112413-35.png]]
429 429  
430 -
431 431  * The next steps is to add the recently created uplink and downlink converters;
432 432  
433 -[[image:image-20230802112413-36.png||height="736" width="1308"]]
422 +[[image:image-20230802112413-36.png]]
434 434  
435 -[[image:image-20230802112413-37.png||height="735" width="1307"]]
424 +[[image:image-20230802112413-37.png]]
436 436  
437 -
438 438  (% style="color:blue" %)**Add a topic filter:**
439 439  
440 -tb/mqtt-integration-tutorial/sensors~/~/temperature ~-~-> Temperature  **固定的? 对的。**
441 441  
429 +tb/mqtt-integration-tutorial/sensors~/~/temperature ~-~-> Temperature 固定的? 对的。
430 +
442 442  You can also select an MQTT QoS level. We use MQTT QoS level 0 (At most once) by default;
443 443  
444 -[[image:image-20230802112413-38.png||height="731" width="1300"]]
433 +[[image:image-20230802112413-38.png]]
445 445  
446 446  
447 447  === 3.6.2 Simulate with MQTT.fx ===
448 448  
449 -
450 450  [[image:image-20230802112413-39.png]]
451 451  
452 452  [[image:image-20230802112413-40.png]]
... ... @@ -459,12 +459,13 @@
459 459  
460 460  * (% style="color:#037691" %)**AT+PRO=3,3  **(%%)** **~/~/ Use MQTT to connect to ThingsBoard.
461 461  
462 -* (% style="color:#037691" %)**AT+SUBTOPIC=device name** (%%) **~-~-> 只需要 Device Name 吗?对的**
450 +* (% style="color:#037691" %)**AT+SUBTOPIC=device name** (%%) ~-~-> 只需要 Device Name 吗?对的
463 463  
464 -* (% style="color:#037691" %)**AT+PUBTOPIC=device name** (%%) **~-~-> 只需要 Device Name 吗?对的**
452 +* (% style="color:#037691" %)**AT+PUBTOPIC=device name** (%%) ~-~-> 只需要 Device Name 吗?对的
465 465  
466 -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 吧).这边不用提示了,客户不需要输入。(大部分客户还是会自己去设置这个的,提高安全性)**
467 467  
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 +
468 468  (% style="color:blue" %)**CLIENT :“Any value”**
469 469  
470 470  (% style="color:blue" %)**User Name:“Any value”**
... ... @@ -498,7 +498,7 @@
498 498  [[image:image-20230802112413-46.png]]
499 499  
500 500  
501 -On the Connection Profile window, set the following information: **(这边加一个截图)**
490 +On the Connection Profile window, set the following information: (这边加一个截图)
502 502  
503 503  * (% style="color:blue" %)**Profile Name: “Any name”**
504 504  
... ... @@ -508,15 +508,15 @@
508 508  
509 509  * (% style="color:blue" %)**Client ID: “Any value”**
510 510  
511 -On the section User credentials, set the following information: **(这边加一个截图)**
500 +On the section User credentials, set the following information:(这边加一个截图)
512 512  
513 -* (% style="color:blue" %)**User Name: “Any value”**  (%%) ~/~/  Tago validates your user by the token only
502 +* **User Name: “Any value”**  Tago validates your user by the token only
514 514  
515 -* (% style="color:blue" %)**Password: “Your device token”**
504 +* **Password: “Your device token”**
516 516  
517 -* (% style="color:blue" %)**PUBTOPIC: “Any value”**
506 +* **PUBTOPIC: “Any value”**
518 518  
519 -* (% style="color:blue" %)**SUBTOPIC: “Any value”**
508 +* **SUBTOPIC: “Any value”**
520 520  
521 521  
522 522  
... ... @@ -527,9 +527,8 @@
527 527  
528 528  [[image:image-20230802112413-48.png]]
529 529  
530 -Users can run the (% style="color:blue" %)**AT+PRO=3,5**(%%) command, and the payload will be converted to **JSON format**.
519 +Users can run the AT+PRO=3,5 command, and the payload will be converted to JSON format.
531 531  
532 -
533 533  [[image:image-20230802112413-49.png]]
534 534  
535 535  
... ... @@ -558,7 +558,7 @@
558 558  
559 559  * (% style="color:blue" %)**Client ID: “Any value”**
560 560  
561 -* (% style="color:blue" %)**User Name: “Any value”** (%%) ~/~/ Tago validates your user by the token only
549 +* (% style="color:blue" %)**User Name: “Any value”** (%%) Tago validates your user by the token only
562 562  
563 563  * (% style="color:blue" %)**Password: “Your device token”**
564 564  
Copyright ©2010-2024 Dragino Technology Co., LTD. All rights reserved
Dragino Wiki v2.0