Skip to Content
Last modified by Kilight Cao on 2025/07/23 16:27
From version 180.1
edited by Xiaoling
on 2024/08/07 15:10
Change comment: There is no comment for this version
To version 104.2
edited by Xiaoling
on 2023/10/07 10:15
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -18,17 +18,12 @@
18 18  
19 19  == 2.1 General Configure to attach network ==
20 20  
21 -
22 22  To attache NB-IoT sensors to NB-IoT Network, You need to:
23 23  
24 24  1. Get a NB-IoT SIM card from Service Provider. (Not the same as the SIM card we use in mobile phone)
25 -1. Power Off End Node ( See below for the power off/on position)
26 -1. Insert the SIM card to Sensor. ( See below for direction)
27 -1. Power On End Node
28 -1. [[Configure APN>>http://wiki.dragino.com/xwiki/bin/view/Main/How%20to%20configure%20APN%20in%20the%20node/]] in the sensor (AT+APN=<APN>), example AT+APN=iot.1nce.net
24 +1. Insert the SIM card to Sensor
25 +1. [[Configure APN>>http://wiki.dragino.com/xwiki/bin/view/Main/How%20to%20configure%20APN%20in%20the%20node/]] in the sensor (AT+APN=<APN>)
29 29  
30 -[[image:image-20240208102804-1.png||height="286" width="696"]]
31 -
32 32  [[image:image-20230808205045-1.png||height="293" width="438"]]
33 33  
34 34  After doing above, the NB-IoT Sensors should be able to attach to NB-IoT network .
... ... @@ -40,33 +40,25 @@
40 40  |(% style="width:117px" %)**[[1NCE>>https://1nce.com]]**|(% style="width:151px" %)iot.1nce.net|(% style="width:474px" %)(((
41 41  **[[Coverage Reference Link>>https://1nce.com/en-ap/1nce-connect]]**
42 42  
43 -Austria, Belgium, Bulgaria, Croatia, Czech Republic, Denmark, Finland, Germany, Great Britain, Greece, Hungary, Ireland, Italy, Latvia, Malta, Netherlands, Norway, Puerto Rico, Russia, Slovak , Republic, Slovenia, Spain, Sweden, Switzerland, Taiwan, USA, UK, US Virgin Islands
44 -)))|(% style="width:135px" %)UK: Band20
38 +Austria, Belgium, Bulgaria, Croatia, Czech Republic, Denmark, Finland, Germany, Great Britain, Greece, Hungary, Ireland, Italy, Latvia, Malta, Netherlands, Norway, Puerto Rico, Russia, Slovak , Republic, Slovenia, Spain, Sweden, Switzerland, Taiwan, USA, US Virgin Islands
39 +)))|(% style="width:135px" %)
45 45  |(% style="width:117px" %)China Mobile|(% style="width:151px" %)No need configure|(% style="width:474px" %)China Mainland, HongKong|(% style="width:135px" %)
46 46  |(% style="width:117px" %)China Telecom|(% style="width:151px" %)ctnb|(% style="width:474px" %)China Mainland|(% style="width:135px" %)
47 47  
43 +(% class="wikigeneratedid" %)
44 +== ==
45 +
48 48  == 2.2 Speed Up Network Attach time ==
49 49  
50 50  
51 -BC660K-GL supports multi bands (% style="color:blue" %)**B1/B2/B3/B4/B5/B8/B12/B13/B14/B17/B18/B19/B20/B25/B28/B66/B70/B85. **(%%) It will search one by one and try to attach, this will take a lot of time and even cause attach fail and show **Signal Strenght:99**. User can lock the band to specify band for its operator to make this faster.
49 +BC660K-GL supports multi bands (% style="color:blue" %)**B1/B2/B3/B4/B5/B8/B12/B13/B14/B17/B18/B19/B20/B25/B28/B66/B70/B85. **(%%) It will search one by one and try to attach, this will take a lot of time and even cause attach fail. User can lock the band to specify band for its operator to make this faster.
52 52  
53 -(% style="color:#037691" %)**AT+QBAND?       **(%%) ~/~/ Check what is the current used frequency band
54 -(% style="color:#037691" %)**AT+QBAND=1,4    **(%%) ~/~/ Set to use 1 frequency band. Band4
55 -(% style="color:#037691" %)**Europe General**(%%) **AT+QBAND=2,8,20 ** ~/~/ Set to use 2 frequency bands. Band 8 and Band 20
56 -(% style="color:#037691" %)**Global General**(%%) : **AT+QBAND=10,8,20,28,2,4,12,13,66,85,5**
51 +(% style="color:#037691" %)**AT+QBAND?  ** (%%) ~/~/ Check what is the current used frequency band
57 57  
58 -(% style="color:#037691" %)**Verizon**(%%)** ** AT+QBAND=1,13
59 -(% style="color:#037691" %)**AT&T**(%%)           AT+QBAND=3,12,4,2
60 -(% style="color:#037691" %)**Telstra**(%%)        AT+QBAND=1,28
61 -(% style="color:#037691" %)**Softband**(%%)     AT+QBAND=2,3,8
53 +(% style="color:#037691" %)**AT+QBAND=1,4  ** (%%) ~/~/ Set to use 1 frequency band. Band4
62 62  
63 -After connection is successful, user can use (% style="color:#037691" %)**AT+QENG=0 **(%%) to check which band is actually in used.
55 +(% style="color:#037691" %)**AT+QBAND=2,8,20**  (%%) ~/~/ Set to use 2 frequency bands. Band 8 and Band 20
64 64  
65 -By default, device will search network for 5 minutes. User can set the time to 10 minutes by (% style="color:#037691" %)**AT+CSQTIME=10 **(%%)so it can search longer.
66 -
67 -See bands used for different provider:** [[NB-IoT Deployment , Bands, Operator list>>http://wiki.dragino.com/xwiki/bin/view/Main/NB-IoT%20Deployment%20%2C%20Bands%2C%20Operator%20list/]]**
68 -
69 -
70 70  = 3. Configure to connect to different servers =
71 71  
72 72  == 3.1 General UDP Connection ==
... ... @@ -80,7 +80,7 @@
80 80  
81 81  We can use PC tool to simulate UDP connection to make sure server works ok.
82 82  
83 -[[image:image-20230802112413-1.png||height="468" width="1024"]]
70 +[[image:image-20230802112413-1.png]]
84 84  
85 85  
86 86  === 3.1.2 Configure NB-IoT Sensor ===
... ... @@ -94,6 +94,8 @@
94 94  
95 95  * (% style="color:#037691" %)**AT+SERVADDR=120.24.4.116,5601**  (%%) ~/~/  Set UDP server address and port
96 96  
84 +* (% style="color:#037691" %)**AT+CFM=1**    (%%) ~/~/  If the server does not respond, this command is unnecessary
85 +
97 97  [[image:image-20230802112413-2.png]]
98 98  
99 99  
... ... @@ -164,8 +164,6 @@
164 164  
165 165  * (% style="color:#037691" %)**Password:**(%%) <Your ThingSpeak MQTT Password>
166 166  
167 -
168 -
169 169  ==== 3.3.2.2 Publish Data to ThingSpeak Channel ====
170 170  
171 171  
... ... @@ -207,11 +207,8 @@
207 207  
208 208  * (% style="color:blue" %)**AT+SUBTOPIC=<YOUR_CHANNEL_ID>**
209 209  
210 -
211 -
212 212  ==== 3.3.3.2 Uplink Examples ====
213 213  
214 -
215 215  [[image:image-20230816201942-1.png]]
216 216  
217 217  For SE01-NB
... ... @@ -270,7 +270,6 @@
270 270  |(% colspan="1" style="background-color:#4f81bd; color:white; width:143px" %)SN50V3-NB mod5|(% colspan="1" style="width:103px" %)mod|(% colspan="1" style="width:102px" %)Battery|(% colspan="1" style="width:157px" %)RSSI|(% colspan="1" style="width:154px" %)DS18B20 Temp|(% colspan="1" style="width:153px" %)adc0|(% colspan="1" style="width:151px" %)exit_state/input PA4|(% colspan="1" style="width:160px" %)Weight|(% colspan="1" style="width:152px" %) |(% colspan="1" style="width:67px" %) |(% colspan="1" style="width:69px" %)
271 271  |(% colspan="1" style="background-color:#4f81bd; color:white; width:143px" %)SN50V3-NB mod6|(% colspan="1" style="width:103px" %)mod|(% colspan="1" style="width:102px" %)Battery|(% colspan="1" style="width:157px" %)RSSI|(% colspan="1" style="width:154px" %)count|(% colspan="1" style="width:153px" %) |(% colspan="1" style="width:151px" %) |(% colspan="1" style="width:160px" %) |(% colspan="1" style="width:152px" %) |(% colspan="1" style="width:67px" %) |(% colspan="1" style="width:69px" %)
272 272  
273 -
274 274  == 3.4 [[Datacake>>https://datacake.co/]] ==
275 275  
276 276  
... ... @@ -285,19 +285,15 @@
285 285  
286 286  * (% style="color:blue" %)**S31B-NB-GE**(%%): This verson doesn't have pre-configure Datacake connection. User need to enter the AT Commands to connect to Datacake. See below for instruction.
287 287  
271 +=== 3.4.1 Create device ===
288 288  
289 289  
290 -=== 3.4.1 For device Already has template ===
291 -
292 -==== 3.4.1.1 Create Device ====
293 -
294 -
295 295  (% style="color:blue" %)**Add Device**(%%) in DataCake.
296 296  
297 -[[image:image-20230808162301-1.png||height="453" width="952"]]
276 +[[image:image-20230808162301-1.png||height="473" width="994"]]
298 298  
299 299  
300 -[[image:image-20230808162342-2.png||height="541" width="952"]]
279 +[[image:image-20230808162342-2.png]]
301 301  
302 302  
303 303  (% style="color:blue" %)**Choose the correct model**(%%) from template.
... ... @@ -307,18 +307,16 @@
307 307  
308 308  (% style="color:blue" %)**Fill Device ID**(%%). The device ID needs to be filled in with IMEI, and a prefix of(% style="color:blue" %)** 'f' **(%%)needs to be added.
309 309  
310 -[[image:image-20230808163612-7.png||height="549" width="952"]]
289 +[[image:image-20230808163612-7.png]]
311 311  
312 312  [[image:image-20230808163035-5.png]]
313 313  
314 -[[image:image-20230808163049-6.png||height="544" width="926"]]
293 +[[image:image-20230808163049-6.png]]
315 315  
316 316  
317 -=== 3.4.2 For Device already registered in DataCake before shipped ===
296 +=== 3.4.2 Scan QR code to obtain data ===
318 318  
319 -==== 3.4.2.1 Scan QR Code to get the device info ====
320 320  
321 -
322 322  Users can use their phones or computers to scan QR codes to obtain device data information.
323 323  
324 324  [[image:image-20230808170051-8.png||height="255" width="259"]]
... ... @@ -326,72 +326,9 @@
326 326  [[image:image-20230808170548-9.png]]
327 327  
328 328  
329 -==== 3.4.2.2 Claim Device to User Account ====
306 +=== 3.4.2 AT command for connecting to DataCake ===
330 330  
331 331  
332 -By Default, the device is registered in Dragino's DataCake Account. User can Claim it to his account.
333 -
334 -
335 -=== 3.4.3 Manual Add Decoder in DataCake ( don't use the template in DataCake) ===
336 -
337 -
338 -**Step1: Add a device**
339 -
340 -[[image:image-20240129170024-1.png||height="330" width="900"]]
341 -
342 -
343 -**Step2: Choose your device type,please select dragino NB-IOT device**
344 -
345 -[[image:image-20240129170216-2.png||height="534" width="643"]]
346 -
347 -
348 -**Step3: Choose to create a new device**
349 -
350 -[[image:image-20240129170539-3.png||height="459" width="646"]]
351 -
352 -
353 -**Step4: Fill in the device ID of your NB device**
354 -
355 -[[image:image-20240202111546-1.png||height="378" width="651"]]
356 -
357 -
358 -**Step5: Please select your device plan according to your needs and complete the creation of the device**
359 -
360 -[[image:image-20240129171236-6.png||height="450" width="648"]]
361 -
362 -
363 -**Step6: Please add the decoder at the payload decoder of the device configuration.**
364 -
365 -**Decoder location: **[[dragino-end-node-decoder/Datacake-Dragino_NB at main · dragino/dragino-end-node-decoder (github.com)>>url:https://github.com/dragino/dragino-end-node-decoder/tree/main/Datacake-Dragino_NB]]
366 -
367 -**Due to version update, please use the following decoder for the new version firmware:**
368 -[[dragino-end-node-decoder/Datacake-Dragino_NB_New_Version at main · dragino/dragino-end-node-decoder (github.com)>>url:https://github.com/dragino/dragino-end-node-decoder/tree/main/Datacake-Dragino_NB_New_Version]]
369 -
370 -[[image:image-20240129172056-7.png||height="457" width="816"]]
371 -
372 -[[image:image-20240129173116-9.png||height="499" width="814"]]
373 -
374 -
375 -**Step7: Add the output of the decoder as a field**
376 -
377 -[[image:image-20240129173541-10.png||height="592" width="968"]]
378 -
379 -
380 -**Step8: Customize the dashboard and use fields as parameters of the dashboard**
381 -
382 -[[image:image-20240129174518-11.png||height="147" width="1042"]]
383 -
384 -[[image:image-20240129174657-12.png||height="538" width="916"]]
385 -
386 -[[image:image-20240129174840-13.png||height="536" width="750"]]
387 -
388 -
389 -=== 3.4.4 For device have not configured to connect to DataCake ===
390 -
391 -
392 -(% class="lead" %)
393 -Use AT command for connecting to DataCake
394 -
395 395  (% style="color:blue" %)**AT+PRO=2,0**
396 396  
397 397  (% style="color:blue" %)**AT+SERVADDR=67.207.76.90,4445**
... ... @@ -420,7 +420,7 @@
420 420  
421 421  Please select the NB95S31B template.
422 422  
423 -[[image:image-20230809173310-5.png||height="558" width="926"]]
337 +[[image:image-20230809173310-5.png]]
424 424  
425 425  [[image:image-20230809173438-6.png]]
426 426  
... ... @@ -429,7 +429,7 @@
429 429  
430 430  Successfully imported template.
431 431  
432 -[[image:image-20230809173835-8.png||height="515" width="860"]]
346 +[[image:image-20230809173835-8.png]]
433 433  
434 434  
435 435  Users can set UDP port.
... ... @@ -444,21 +444,15 @@
444 444  
445 445  [[image:image-20230810083934-1.png]]
446 446  
447 -[[image:image-20230810084048-2.png||height="535" width="1052"]]
361 +[[image:image-20230810084048-2.png]]
448 448  
449 -
450 450  === 3.5.3 Configure NB-IoT Sensors ===
451 451  
452 452  
453 -* (% style="color:#037691" %)**AT+PRO=3,0 or 3,5 ** (%%) **~/~/ hex format or json format**
454 -* (% style="color:#037691" %)**AT+SUBTOPIC=<device name>or User Defined**
455 -* (% style="color:#037691" %)**AT+PUBTOPIC=<device name>or User Defined**
456 -* (% style="color:#037691" %)**AT+CLIENT=<device name> or User Defined**
457 -* (% style="color:#037691" %)**AT+UNAME=<device name> or User Defined**
458 -* (% style="color:#037691" %)**AT+PWD=“Your device token”**
366 +* (% style="color:blue" %)**AT+PRO=2,0(hex format) or 2,1(json format)  **(%%)** **~/~/  Set to UDP Server and  Payload
459 459  
368 +* (% style="color:blue" %)**AT+SERVADDR=xx.xx.xx.xx,port   **(%%)** **~/~/  Set Server IP and  port
460 460  
461 -
462 462  == 3.6 ThingsBoard.Cloud (via MQTT) ==
463 463  
464 464  === 3.6.1 Configure ThingsBoard ===
... ... @@ -468,7 +468,7 @@
468 468  
469 469  Create a New Device in [[ThingsBoard>>url:https://thingsboard.cloud/]]. Record Device Name which is used for MQTT connection.
470 470  
471 -[[image:image-20230802112413-32.png||height="583" width="1066"]]
379 +[[image:image-20230802112413-32.png]]
472 472  
473 473  
474 474  ==== 3.6.1.2 Create Uplink & Downlink Converter ====
... ... @@ -480,7 +480,7 @@
480 480  
481 481  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.
482 482  
483 -[[image:image-20230802112413-33.png||height="597" width="1061"]]
391 +[[image:image-20230802112413-33.png||height="732" width="1302"]]
484 484  
485 485  
486 486  (% style="color:blue" %)**Downlink Converter**
... ... @@ -487,7 +487,7 @@
487 487  
488 488  The Downlink converter transforming outgoing RPC message and then the Integration sends it to external MQTT broke
489 489  
490 -[[image:image-20230802112413-34.png||height="598" width="1063"]]
398 +[[image:image-20230802112413-34.png||height="734" width="1305"]]
491 491  
492 492  (% style="color:red" %)**Note: Our device payload is already human readable data. Therefore, users do not need to write decoders. Simply create by default.**
493 493  
... ... @@ -497,23 +497,23 @@
497 497  
498 498  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**;
499 499  
500 -[[image:image-20230802112413-35.png||height="597" width="1062"]]
408 +[[image:image-20230802112413-35.png||height="738" width="1312"]]
501 501  
502 502  
503 503  * The next steps is to add the recently created uplink and downlink converters;
504 504  
505 -[[image:image-20230802112413-36.png||height="598" width="1062"]]
413 +[[image:image-20230802112413-36.png||height="736" width="1308"]]
506 506  
507 -[[image:image-20230802112413-37.png||height="598" width="1064"]]
415 +[[image:image-20230802112413-37.png||height="735" width="1307"]]
508 508  
509 509  
510 510  (% style="color:blue" %)**Add a topic filter:**
511 511  
512 -Consistent with the theme of the node setting.
420 +tb/mqtt-integration-tutorial/sensors~/~/temperature ~-~-> Temperature  **固定的? 对的。**
513 513  
514 514  You can also select an MQTT QoS level. We use MQTT QoS level 0 (At most once) by default;
515 515  
516 -[[image:image-20230802112413-38.png||height="598" width="1064"]]
424 +[[image:image-20230802112413-38.png||height="731" width="1300"]]
517 517  
518 518  
519 519  === 3.6.2 Simulate with MQTT.fx ===
... ... @@ -521,7 +521,7 @@
521 521  
522 522  [[image:image-20230802112413-39.png]]
523 523  
524 -[[image:image-20230802112413-40.png||height="525" width="980"]]
432 +[[image:image-20230802112413-40.png]]
525 525  
526 526  
527 527  === 3.6.3 Configure NB-IoT Sensor ===
... ... @@ -543,95 +543,18 @@
543 543  
544 544  Test Uplink by click the button for 1 second
545 545  
546 -[[image:image-20230802112413-41.png||height="496" width="828"]]
454 +[[image:image-20230802112413-41.png]]
547 547  
548 548  [[image:image-20230802112413-42.png]]
549 549  
550 -[[image:image-20230802112413-43.png||height="407" width="825"]]
458 +[[image:image-20230802112413-43.png]]
551 551  
552 552  
553 -== 3.7 ThingsBoard.Cloud (via COAP) ==
461 +== 3.7 [[Tago.io>>url:https://admin.tago.io/]] (via MQTT) ==
554 554  
555 -=== 3.7.1 Configure ThingsBoard ===
463 +=== 3.7.1 Create device & Get Credentials ===
556 556  
557 -==== 3.7.1.1 Create Uplink & Downlink Converter ====
558 558  
559 -
560 -(% style="color:blue" %)**Uplink Converter**
561 -
562 -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.
563 -
564 -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" %)**“COAP Uplink Converter”**(%%) and select type (% style="color:blue" %)"**Uplink"**(%%). Use debug mode for now.
565 -
566 -[[image:image-20240729141300-1.png||height="552" width="1115"]]
567 -
568 -
569 -(% style="color:blue" %)**Downlink Converter**
570 -
571 -The Downlink converter transforming outgoing RPC message and then the Integration sends it to external COAP broker.
572 -
573 -[[image:image-20240729142505-3.png||height="507" width="1023"]]
574 -
575 -
576 -==== 3.7.1.2 COAP Integration Setup ====
577 -
578 -
579 -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" %)**“CoAP Integration”**(%%), select type **COAP    **(% style="color:blue" %);
580 -
581 -[[image:image-20240729144058-4.png||height="506" width="1021"]]
582 -
583 -
584 -The next steps is to add the recently created uplink converters;
585 -
586 -[[image:image-20240729150142-5.png||height="507" width="1023"]]
587 -
588 -
589 -==== 3.7.1.3 Add COAP Integration ====
590 -
591 -
592 -==== [[image:image-20240729161543-9.png||height="500" width="1009"]] ====
593 -
594 -
595 -=== 3.7.2 Node Configuration(Example: Connecting to the Thingsboard platform) ===
596 -
597 -==== 3.7.2.1 Instruction Description ====
598 -
599 -
600 -* AT+PRO=1,0(HEX format uplink)  &AT+PRO=1,5(JSON format uplink)
601 -* AT+SERVADDR=COAP Server Address,5683
602 -
603 -Example: AT+SERVADDR=int.thingsboard.cloud,5683(The address is automatically generated when the COAP integration is created)
604 -
605 -[[image:image-20240729172305-12.png||height="361" width="624"]]
606 -
607 -Note:The port for the COAP protocol has been fixed to 5683
608 -
609 -
610 -* AT+URL1=11,(% style="color:red" %)**character length**(%%),"Needs to be consistent with the CoAP endpoint URL in the platform"
611 -
612 -If the module used is (% style="color:red" %)**BC660K, only one **(%%)URL directive needs to be configured,
613 -
614 -e.g.
615 -
616 -* AT+URL1=11,38, "i/faaaa241f-af4a-b780-4468-c671bb574858"
617 -
618 -[[image:image-20240729172415-13.png||height="401" width="694"]]
619 -
620 -If you are using a (% style="color:red" %)**BG95-M2**(%%) module, you need to configure (% style="color:red" %)**TWO**(%%) URL commands,
621 -
622 -e.g.
623 -
624 -* AT+URL1=11, "i";  
625 -* AT+URL2=11,"/faaaa241f-af4a-b780-4468-c671bb574858"
626 -
627 -[[image:image-20240729172500-14.png||height="403" width="700"]]
628 -
629 -
630 -== 3.8 [[Tago.io>>url:https://admin.tago.io/]] (via MQTT) ==
631 -
632 -=== 3.8.1 Create device & Get Credentials ===
633 -
634 -
635 635  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.
636 636  
637 637  [[image:image-20230802112413-44.png]]
... ... @@ -680,33 +680,31 @@
680 680  
681 681  * (% style="color:#037691" %)**AT+PWD=“Your device token”**
682 682  
514 +=== 3.7.2 Simulate with MQTT.fx ===
683 683  
684 684  
685 -=== 3.8.2 Simulate with MQTT.fx ===
686 -
687 -
688 688  [[image:image-20230802112413-52.png]]
689 689  
690 690  
691 -[[image:image-20230808105300-2.png||height="553" width="1026"]]
520 +[[image:image-20230808105300-2.png]]
692 692  
693 693  
694 694  Users can run the (% style="color:blue" %)**AT+PRO=3,5**(%%) command, and the payload will be converted to **JSON format**.
695 695  
696 -[[image:image-20230808105217-1.png||height="556" width="1031"]]
525 +[[image:image-20230808105217-1.png]]
697 697  
698 698  [[image:image-20230808105329-3.png]]
699 699  
700 700  
701 -=== 3.8.3 tago data ===
530 +=== 3.7.3 tago data ===
702 702  
703 703  
704 -[[image:image-20230802112413-50.png||height="242" width="1037"]]
533 +[[image:image-20230802112413-50.png]]
705 705  
706 706  [[image:image-20230802112413-51.png||height="184" width="696"]]
707 707  
708 708  
709 -== 3.9 TCP Connection ==
538 +== 3.8 TCP Connection ==
710 710  
711 711  
712 712  (% style="color:blue" %)**AT command:**
... ... @@ -725,230 +725,3 @@
725 725  (% style="color:blue" %)**See result in TCP Server:**
726 726  
727 727  [[image:image-20230807233631-2.png]]
728 -
729 -
730 -== 3.10 AWS Connection ==
731 -
732 -
733 -Users can refer to [[Dragino NB device connection to AWS platform instructions>>http://wiki.dragino.com/xwiki/bin/view/Dragino%20NB%20device%20connection%20to%20AWS%20platform%20instructions/#H1.LogintotheplatformandfindIoTcore]]
734 -
735 -
736 -= 4. MQTT/UDP/TCP downlink =
737 -
738 -== 4.1 MQTT (via MQTT.fx) ==
739 -
740 -
741 -Configure MQTT connections properly and send downlink commands to configure nodes through the Publish function of MQTT.fx//.//
742 -
743 -**1.** Configure node MQTT connection (via MQTT.fx):
744 -
745 -(% style="color:blue" %)**AT command:**
746 -
747 -* (% style="color:#037691" %)**AT+PRO=3,0 or 3,5 ** (%%)~/~/ hex format or json format
748 -
749 -* (% style="color:#037691" %)**AT+SUBTOPIC=User Defined**
750 -
751 -* (% style="color:#037691" %)**AT+PUBTOPIC=User Defined**
752 -
753 -* (% style="color:#037691" %)**AT+UNAME=<device name> or User Defined**
754 -
755 -* (% style="color:#037691" %)**AT+PWD=<device name> or User Defined**
756 -
757 -* (% style="color:#037691" %)**AT+SERVADDR=8.217.91.207,1883 ** (%%) ~/~/ to set MQTT server address and port
758 -
759 -(% style="color:red" %)**Note: To uplink and downlink via MQTT.fx, we need set the publish topic and subscribe topic different, for example: AT+SUBTOPIC=SE01_SUB & AT+PUBTOPIC=SE01_PUB.**
760 -
761 -[[image:image-20240417180145-2.png||height="434" width="587"]][[image:image-20240417180737-3.png||height="431" width="584"]]
762 -
763 -
764 -**2. **When the node uplink packets, we can observe the data in MQTT.fx.
765 -
766 -[[image:image-20240418144337-1.png||height="709" width="802"]]
767 -
768 -**3. **The downlink command can be successfully sent only when the downlink port is open.
769 -
770 - The downlink port is opened for about 3 seconds after uplink packets are sent.
771 -
772 - Therefore, when we see the node uplink packets in the **Subscribe** window, we need to immediately switch to the **publish** window to publish the **hex format** command.
773 -
774 -[[image:image-20240418150435-3.png||height="582" width="659"]]
775 -
776 -[[image:image-20240418150932-4.png||height="492" width="1061"]]
777 -
778 -(% style="color:red" %)**Note: Users can edit the hex command in advance. When the node uplink, directly click the publish button several times to increase the success rate of command configuration.**
779 -
780 -
781 -= 5. FAQ =
782 -
783 -== 5.1 What is the usage of Multi Sampling and One Uplink? ==
784 -
785 -
786 -The NB series has the feature for Multi Sampling and one uplink. See one of them
787 -
788 -[[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/SN50v3-NB_BN-IoT_Sensor_Node_User_Manual/#H2.5Multi-SamplingsandOneuplink>>http://wiki.dragino.com/xwiki/bin/view/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/SN50v3-NB_BN-IoT_Sensor_Node_User_Manual/#H2.5Multi-SamplingsandOneuplink]]
789 -
790 -User can use this feature for below purpose:
791 -
792 -1. **Reduce power consumption**. The NB-IoT transmit power is much more higher than the sensor sampling power. To save battery life, we can sampling often and send in one uplink.
793 -1. Give more sampling data points.
794 -1. Increase reliable in transmission. For example. If user set
795 -1*. **AT+TR=1800** ~/~/ The unit is seconds, and the default is to record data once every 1800 seconds (30 minutes, the minimum can be set to 180 seconds)
796 -1*. **AT+NOUD=24** ~/~/  The device uploads 24 sets of recorded data by default. Up to 32 sets of record data can be uploaded.
797 -1*. **AT+TDC=7200**  ~/~/ Uplink every 2 hours.
798 -1*. this will mean each uplink will actually include the 6 uplink data (24 set data which cover 12 hours). So if device doesn't lost 6 continue data. There will not data lost.
799 -
800 -== 5.2 Why the uplink JSON format is not standard? ==
801 -
802 -
803 -The json format in uplink packet is not standard Json format. Below is the example. This is to make the payload as short as possible, due to NB-IoT transmit limition, a standard Json is not able to include 32 sets of sensors data with timestamp.
804 -
805 -The firmware version released after 2024, Mar will use change back to use Json format. Detail please check changelog.
806 -
807 -[[image:image-20240229233154-1.png]]
808 -
809 -
810 -= 6. Trouble Shooting: =
811 -
812 -== 6.1 Checklist for debuging Network Connection issue. Signal Strenght:99 issue. ==
813 -
814 -
815 -There are many different providers provide NB-IoT service in the world. They might use different band, different APN & different operator configuration. Which makes connection to NB-IoT network is complicate.
816 -
817 -If end device successfully attached NB-IoT Network, User can normally see the signal strengh as below (between 0~~31)
818 -
819 -[[image:image-20240207002003-1.png]]
820 -
821 -
822 -If fail to attach network, it will shows signal 99. as below:
823 -
824 -[[image:image-20240207002129-2.png]]
825 -
826 -
827 -(% class="lead" %)
828 -When see this issue, below are the checklist:
829 -
830 -* Does your SIM card support NB-IoT network? If SIM card doesn't not specify support NB-IoT clearly, normally it doesn't support. You need to confirm with your operator.
831 -* Do you configure the correct APN? [[Check here for APN settings>>http://wiki.dragino.com/xwiki/bin/view/Main/General%20Configure%20to%20Connect%20to%20IoT%20server%20for%20-NB%20%26%20-NS%20NB-IoT%20models/#H2.1GeneralConfiguretoattachnetwork]].
832 -* Do you lock the frequency band? This is the most case we see. [[Explain and Instruction>>http://wiki.dragino.com/xwiki/bin/view/Main/General%20Configure%20to%20Connect%20to%20IoT%20server%20for%20-NB%20%26%20-NS%20NB-IoT%20models/#H2.2SpeedUpNetworkAttachtime]].
833 -* Check if the device is attached to Carrier network but reject. (need to check with operator).
834 -* Check if the antenna is connected firmly.
835 -
836 -If you have check all above and still fail. please send console log files (as many as possible) to [[support@dragino.com>>mailto:support@dragino.com]] so we can check.
837 -
838 -
839 -== 6.2 Issue: "NBIOT did not respond" ==
840 -
841 -
842 -(% class="box errormessage" %)
843 -(((
844 -11:24:22.397 [44596]NBIOT did not respond.
845 -11:24:24.315 [46530]NBIOT did not respond.
846 -11:24:26.256 [48464]NBIOT did not respond.
847 -11:24:28.196 [50398]NBIOT did not respond.
848 -11:24:30.115 [52332]NBIOT did not respond.
849 -11:24:32.127 [54266]NBIOT did not respond.
850 -11:24:32.127 [54299]Restart the module...
851 -11:24:39.181 [61332]No response when shutting down
852 -)))
853 -
854 -This issue might due to initiate issue for NB-IoT module. In this case, please try:
855 -
856 -1) Open Enclosure
857 -
858 -2) Power off device by pull out the power on Jumper
859 -
860 -3) Power on device by connect back the power jumper.
861 -
862 -4) push reset button.
863 -
864 -[[image:image-20240208001740-1.png]]
865 -
866 -
867 -== 6.3 Issue: "Failed to readI MSI number" ==
868 -
869 -
870 -(% class="box errormessage" %)
871 -(((
872 -[18170]Failed to read IMSI:1umber.
873 -[20109]Failed to read IMSI numoer.
874 -[22048]Failed to read IMSI number.
875 -[29842lRestart the module...
876 -)))
877 -
878 -Make sure that the SIM card is insert in correct direction and device is power off/on during insert. Here is reference link: [[Insert SIM Card>>||anchor="H2.1GeneralConfiguretoattachnetwork"]].
879 -
880 -
881 -== (% data-sider-select-id="765eceff-93b1-40ee-800b-b7b7d022ef8a" %)6.4 Why sometime the AT Command is slow in reponse?(%%) ==
882 -
883 -
884 -When the MCU is communicating with the NB-IoT module, the MCU response of AT Command will become slower, it might takes several seconds to response.
885 -
886 -[[image:image-20240226111928-1.png]]
887 -
888 -
889 -== (% data-sider-select-id="765eceff-93b1-40ee-800b-b7b7d022ef8a" %)6.5 What is the Downlink Command by the NB device?(%%) ==
890 -
891 -(% data-sider-select-id="bb6e9353-0c3f-473c-938d-4b416c9a03e6" %)
892 -=== UDP: ===
893 -
894 -(% data-sider-select-id="14a4790e-7faa-4508-a4dd-7605a53f1cb3" %)
895 -Its downlink command is the same as the AT command, but brackets are required.
896 -Example:
897 -
898 -{AT+TDC=300}
899 -
900 -
901 -(% data-sider-select-id="90b80f1a-e924-4c8a-afc5-4429e019a657" %)
902 -=== MQTT: ===
903 -
904 -Json：
905 -
906 -The Json format in MQTT mode needs to be configured with all commands.
907 -If you have configurations that need to be changed, please change them in the template below.
908 -Template:
909 -
910 -{
911 -"AT+SERVADDR":"119.91.62.30,1882",
912 -"AT+CLIENT":"JwcXKjQBNhQ2JykDDAA5Ahs",
913 -"AT+UNAME":"usenamedragino",
914 -"AT+PWD":"passworddragino",
915 -"AT+PUBTOPIC":"123",
916 -"AT+SUBTOPIC":"321",
917 -"AT+TDC":"7200",
918 -"AT+INTMOD":"0",
919 -"AT+APN":"NULL",
920 -"AT+5VT":"0",
921 -"AT+PRO":"3,5",
922 -"AT+TR":"900",
923 -"AT+NOUD":"0",
924 -"AT+CSQTIME":"5",
925 -"AT+DNSTIMER":"0",
926 -"AT+TLSMOD":"0,0",
927 -"AT+MQOS":"0",
928 -"AT+TEMPALARM1":"0",
929 -"AT+TEMPALARM2":"10",
930 -"AT+TEMPALARM3":"0"
931 -}
932 -
933 -Hex：
934 -
935 -MQTT's hex format. Since many commands need to support strings, only a few commands are supported.
936 -
937 -The supported commands are consistent with LoRaWAN's hex commands.
938 -Please refer to the following link to obtain the hex format:
939 -
940 -[[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20AT%20Commands%20and%20Downlink%20Command/>>http://wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20AT%20Commands%20and%20Downlink%20Command/]]
941 -
942 -
943 -== (% data-sider-select-id="765eceff-93b1-40ee-800b-b7b7d022ef8a" %)6.6 How to obtain device logs?(%%) ==
944 -
945 -
946 -* **AT Command: AT** **+GETLOG**
947 -
948 -This command can be used to query upstream logs of data packets.
949 -
950 -[[image:image-20240701114700-1.png]]
951 -
952 -
953 -
954 -
image-20240129170024-1.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Bei
Size
... ... @@ -1,1 +1,0 @@
1 -52.3 KB
Content
image-20240129170216-2.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Bei
Size
... ... @@ -1,1 +1,0 @@
1 -56.0 KB
Content
image-20240129170539-3.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Bei
Size
... ... @@ -1,1 +1,0 @@
1 -55.0 KB
Content
image-20240129171029-4.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Bei
Size
... ... @@ -1,1 +1,0 @@
1 -36.1 KB
Content
image-20240129171113-5.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Bei
Size
... ... @@ -1,1 +1,0 @@
1 -47.2 KB
Content
image-20240129171236-6.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Bei
Size
... ... @@ -1,1 +1,0 @@
1 -49.8 KB
Content
image-20240129172056-7.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Bei
Size
... ... @@ -1,1 +1,0 @@
1 -69.8 KB
Content
image-20240129172136-8.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Bei
Size
... ... @@ -1,1 +1,0 @@
1 -80.4 KB
Content
image-20240129173116-9.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Bei
Size
... ... @@ -1,1 +1,0 @@
1 -110.8 KB
Content
image-20240129173541-10.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Bei
Size
... ... @@ -1,1 +1,0 @@
1 -95.4 KB
Content
image-20240129174518-11.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Bei
Size
... ... @@ -1,1 +1,0 @@
1 -23.2 KB
Content
image-20240129174657-12.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Bei
Size
... ... @@ -1,1 +1,0 @@
1 -141.9 KB
Content
image-20240129174840-13.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Bei
Size
... ... @@ -1,1 +1,0 @@
1 -92.9 KB
Content
image-20240202111546-1.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Bei
Size
... ... @@ -1,1 +1,0 @@
1 -33.3 KB
Content
image-20240207002003-1.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Edwin
Size
... ... @@ -1,1 +1,0 @@
1 -22.3 KB
Content
image-20240207002129-2.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Edwin
Size
... ... @@ -1,1 +1,0 @@
1 -17.9 KB
Content
image-20240208001740-1.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Edwin
Size
... ... @@ -1,1 +1,0 @@
1 -487.1 KB
Content
image-20240208102804-1.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Edwin
Size
... ... @@ -1,1 +1,0 @@
1 -507.6 KB
Content
image-20240226111928-1.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Edwin
Size
... ... @@ -1,1 +1,0 @@
1 -52.0 KB
Content
image-20240229233154-1.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Edwin
Size
... ... @@ -1,1 +1,0 @@
1 -39.5 KB
Content
image-20240417173549-1.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.ting
Size
... ... @@ -1,1 +1,0 @@
1 -70.3 KB
Content
image-20240417180145-2.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.ting
Size
... ... @@ -1,1 +1,0 @@
1 -104.1 KB
Content
image-20240417180737-3.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.ting
Size
... ... @@ -1,1 +1,0 @@
1 -59.7 KB
Content
image-20240418144337-1.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.ting
Size
... ... @@ -1,1 +1,0 @@
1 -95.1 KB
Content
image-20240418144714-2.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.ting
Size
... ... @@ -1,1 +1,0 @@
1 -50.3 KB
Content
image-20240418150435-3.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.ting
Size
... ... @@ -1,1 +1,0 @@
1 -44.1 KB
Content
image-20240418150932-4.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.ting
Size
... ... @@ -1,1 +1,0 @@
1 -103.4 KB
Content
image-20240701114700-1.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Bei
Size
... ... @@ -1,1 +1,0 @@
1 -291.5 KB
Content
image-20240729141300-1.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.kai
Size
... ... @@ -1,1 +1,0 @@
1 -176.9 KB
Content
image-20240729142505-3.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.kai
Size
... ... @@ -1,1 +1,0 @@
1 -202.0 KB
Content
image-20240729144058-4.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.kai
Size
... ... @@ -1,1 +1,0 @@
1 -140.7 KB
Content
image-20240729150142-5.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.kai
Size
... ... @@ -1,1 +1,0 @@
1 -128.0 KB
Content
image-20240729160802-7.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.kai
Size
... ... @@ -1,1 +1,0 @@
1 -162.8 KB
Content
image-20240729161543-9.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.kai
Size
... ... @@ -1,1 +1,0 @@
1 -166.8 KB
Content
image-20240729172234-11.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.kai
Size
... ... @@ -1,1 +1,0 @@
1 -57.8 KB
Content
image-20240729172305-12.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.kai
Size
... ... @@ -1,1 +1,0 @@
1 -49.3 KB
Content
image-20240729172415-13.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.kai
Size
... ... @@ -1,1 +1,0 @@
1 -54.3 KB
Content
image-20240729172500-14.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.kai
Size
... ... @@ -1,1 +1,0 @@
1 -48.6 KB
Content