Last modified by Mengting Qiu on 2025/07/03 18:55
From version 156.1
edited by Mengting Qiu
on 2024/04/18 14:43
on 2024/04/18 14:43
Change comment:
Uploaded new attachment "image-20240418144337-1.png", version {1}
Summary
-
Page properties (2 modified, 0 added, 0 removed)
-
Attachments (0 modified, 14 added, 0 removed)
- image-20240418144714-2.png
- image-20240418150435-3.png
- image-20240418150932-4.png
- image-20240701114700-1.png
- image-20240729141300-1.png
- image-20240729142505-3.png
- image-20240729144058-4.png
- image-20240729150142-5.png
- image-20240729160802-7.png
- image-20240729161543-9.png
- image-20240729172234-11.png
- image-20240729172305-12.png
- image-20240729172415-13.png
- image-20240729172500-14.png
Details
- Page properties
-
- Author
-
... ... @@ -1,1 +1,1 @@ 1 -XWiki. ting1 +XWiki.Xiaoling - Content
-
... ... @@ -40,8 +40,8 @@ 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, US Virgin Islands 44 -)))|(% style="width:135px" %) 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 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 ... ... @@ -62,6 +62,7 @@ 62 62 63 63 After connection is successful, user can use (% style="color:#037691" %)**AT+QENG=0 **(%%) to check which band is actually in used. 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. 65 65 66 66 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/]]** 67 67 ... ... @@ -163,6 +163,8 @@ 163 163 164 164 * (% style="color:#037691" %)**Password:**(%%) <Your ThingSpeak MQTT Password> 165 165 167 + 168 + 166 166 ==== 3.3.2.2 Publish Data to ThingSpeak Channel ==== 167 167 168 168 ... ... @@ -204,6 +204,8 @@ 204 204 205 205 * (% style="color:blue" %)**AT+SUBTOPIC=<YOUR_CHANNEL_ID>** 206 206 210 + 211 + 207 207 ==== 3.3.3.2 Uplink Examples ==== 208 208 209 209 ... ... @@ -265,6 +265,7 @@ 265 265 |(% 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" %) 266 266 |(% 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" %) 267 267 273 + 268 268 == 3.4 [[Datacake>>https://datacake.co/]] == 269 269 270 270 ... ... @@ -279,10 +279,13 @@ 279 279 280 280 * (% 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. 281 281 288 + 289 + 282 282 === 3.4.1 For device Already has template === 283 283 284 284 ==== 3.4.1.1 Create Device ==== 285 285 294 + 286 286 (% style="color:blue" %)**Add Device**(%%) in DataCake. 287 287 288 288 [[image:image-20230808162301-1.png||height="453" width="952"]] ... ... @@ -353,8 +353,11 @@ 353 353 354 354 **Step6: Please add the decoder at the payload decoder of the device configuration.** 355 355 356 -**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]] 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]] 357 357 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 + 358 358 [[image:image-20240129172056-7.png||height="457" width="816"]] 359 359 360 360 [[image:image-20240129173116-9.png||height="499" width="814"]] ... ... @@ -445,6 +445,8 @@ 445 445 * (% style="color:#037691" %)**AT+UNAME=<device name> or User Defined** 446 446 * (% style="color:#037691" %)**AT+PWD=“Your device token”** 447 447 460 + 461 + 448 448 == 3.6 ThingsBoard.Cloud (via MQTT) == 449 449 450 450 === 3.6.1 Configure ThingsBoard === ... ... @@ -536,11 +536,88 @@ 536 536 [[image:image-20230802112413-43.png||height="407" width="825"]] 537 537 538 538 539 -== 3.7 [[Tago.io>>url:https://admin.tago.io/]](viaMQTT) ==553 +== 3.7 ThingsBoard.Cloud (via COAP) == 540 540 541 -=== 3.7.1 Cre atedevice & Get Credentials ===555 +=== 3.7.1 Configure ThingsBoard === 542 542 557 +==== 3.7.1.1 Create Uplink & Downlink Converter ==== 543 543 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 + 544 544 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. 545 545 546 546 [[image:image-20230802112413-44.png]] ... ... @@ -589,9 +589,11 @@ 589 589 590 590 * (% style="color:#037691" %)**AT+PWD=“Your device token”** 591 591 592 -=== 3.7.2 Simulate with MQTT.fx === 593 593 594 594 685 +=== 3.8.2 Simulate with MQTT.fx === 686 + 687 + 595 595 [[image:image-20230802112413-52.png]] 596 596 597 597 ... ... @@ -605,7 +605,7 @@ 605 605 [[image:image-20230808105329-3.png]] 606 606 607 607 608 -=== 3. 7.3 tago data ===701 +=== 3.8.3 tago data === 609 609 610 610 611 611 [[image:image-20230802112413-50.png||height="242" width="1037"]] ... ... @@ -613,7 +613,7 @@ 613 613 [[image:image-20230802112413-51.png||height="184" width="696"]] 614 614 615 615 616 -== 3. 8TCP Connection ==709 +== 3.9 TCP Connection == 617 617 618 618 619 619 (% style="color:blue" %)**AT command:** ... ... @@ -634,19 +634,24 @@ 634 634 [[image:image-20230807233631-2.png]] 635 635 636 636 730 +== 3.10 AWS Connection == 637 637 638 638 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 + 639 639 = 4. MQTT/UDP/TCP downlink = 640 640 641 641 == 4.1 MQTT (via MQTT.fx) == 642 642 740 + 643 643 Configure MQTT connections properly and send downlink commands to configure nodes through the Publish function of MQTT.fx//.// 644 644 645 -**1.** **Configure node MQTT connection (via MQTT.fx):**743 +**1.** Configure node MQTT connection (via MQTT.fx): 646 646 647 647 (% style="color:blue" %)**AT command:** 648 648 649 -* (% style="color:#037691" %)**AT+PRO=3,0 or 3,5 ** (%%) **~/~/ hex format or json format**747 +* (% style="color:#037691" %)**AT+PRO=3,0 or 3,5 ** (%%)~/~/ hex format or json format 650 650 651 651 * (% style="color:#037691" %)**AT+SUBTOPIC=User Defined** 652 652 ... ... @@ -656,19 +656,30 @@ 656 656 657 657 * (% style="color:#037691" %)**AT+PWD=<device name> or User Defined** 658 658 659 -* (% style="color:#037691" %)**AT+SERVADDR=8.217.91.207,1883 ** (%%) **~/~/ to set MQTT server address and port**757 +* (% style="color:#037691" %)**AT+SERVADDR=8.217.91.207,1883 ** (%%) ~/~/ to set MQTT server address and port 660 660 661 661 (% 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.** 662 662 663 -[[image:image-20240417180145-2.png||height=" 545" width="737"]]761 +[[image:image-20240417180145-2.png||height="434" width="587"]][[image:image-20240417180737-3.png||height="431" width="584"]] 664 664 665 -[[image:image-20240417180737-3.png||height="544" width="738"]] 666 666 764 +**2. **When the node uplink packets, we can observe the data in MQTT.fx. 667 667 766 +[[image:image-20240418144337-1.png||height="709" width="802"]] 668 668 768 +**3. **The downlink command can be successfully sent only when the downlink port is open. 669 669 770 + The downlink port is opened for about 3 seconds after uplink packets are sent. 670 670 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. 671 671 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 + 672 672 = 5. FAQ = 673 673 674 674 == 5.1 What is the usage of Multi Sampling and One Uplink? == ... ... @@ -769,9 +769,77 @@ 769 769 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"]]. 770 770 771 771 772 -== 6.4 Why sometime the AT Command is slow in reponse? == 881 +== (% data-sider-select-id="765eceff-93b1-40ee-800b-b7b7d022ef8a" %)6.4 Why sometime the AT Command is slow in reponse?(%%) == 773 773 774 774 775 775 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. 776 776 777 777 [[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-20240418144714-2.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.ting - Size
-
... ... @@ -1,0 +1,1 @@ 1 +50.3 KB - Content
- image-20240418150435-3.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.ting - Size
-
... ... @@ -1,0 +1,1 @@ 1 +44.1 KB - Content
- image-20240418150932-4.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.ting - Size
-
... ... @@ -1,0 +1,1 @@ 1 +103.4 KB - Content
- image-20240701114700-1.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Bei - Size
-
... ... @@ -1,0 +1,1 @@ 1 +291.5 KB - Content
- image-20240729141300-1.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.kai - Size
-
... ... @@ -1,0 +1,1 @@ 1 +176.9 KB - Content
- image-20240729142505-3.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.kai - Size
-
... ... @@ -1,0 +1,1 @@ 1 +202.0 KB - Content
- image-20240729144058-4.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.kai - Size
-
... ... @@ -1,0 +1,1 @@ 1 +140.7 KB - Content
- image-20240729150142-5.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.kai - Size
-
... ... @@ -1,0 +1,1 @@ 1 +128.0 KB - Content
- image-20240729160802-7.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.kai - Size
-
... ... @@ -1,0 +1,1 @@ 1 +162.8 KB - Content
- image-20240729161543-9.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.kai - Size
-
... ... @@ -1,0 +1,1 @@ 1 +166.8 KB - Content
- image-20240729172234-11.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.kai - Size
-
... ... @@ -1,0 +1,1 @@ 1 +57.8 KB - Content
- image-20240729172305-12.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.kai - Size
-
... ... @@ -1,0 +1,1 @@ 1 +49.3 KB - Content
- image-20240729172415-13.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.kai - Size
-
... ... @@ -1,0 +1,1 @@ 1 +54.3 KB - Content
- image-20240729172500-14.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.kai - Size
-
... ... @@ -1,0 +1,1 @@ 1 +48.6 KB - Content