Skip to Content
Last modified by Mengting Qiu on 2025/07/03 18:55
From version 226.2
edited by Mengting Qiu
on 2025/06/13 17:10
Change comment: There is no comment for this version
To version 203.1
edited by Mengting Qiu
on 2024/11/26 19:07
Change comment: Uploaded new attachment "image-20241126190737-17.png", version {1}

Summary

Details

Page properties
Content
... ... @@ -46,8 +46,8 @@
46 46  |(% style="width:117px" %)China Telecom|(% style="width:151px" %)ctnb|(% style="width:474px" %)China Mainland|(% style="width:135px" %)
47 47  
48 48  (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:878px" %)
49 -|(% style="background-color:#4f81bd; color:white; width:152px" %)**SIM Provider**|(% style="background-color:#4f81bd; color:white; width:169px" %)**AT+QCGDEFCONT=**|(% style="background-color:#4f81bd; color:white; width:427px" %)**Command Explanation**|(% style="background-color:#4f81bd; color:white; width:135px" %)**Comments**
50 -|(% style="width:152px" %)**[[1NCE>>https://1nce.com]]/[[NB card purchased by the customer>>https://1nce.com]]**|(% style="width:169px" %)iot.1nce.net/xxx|(% style="width:427px" %)This command sets the PSD connection settings for PDN connection on power-up. When the MT attaches to the NB-IoT network on power-on, a PDN connection setup is performed. Therefore, PDN connection settings are stored in NVRAM so that they can be used by the modem during the attachment.|(% style="width:135px" %)
49 +|(% style="background-color:#4f81bd; color:white; width:117px" %)**SIM Provider**|(% style="background-color:#4f81bd; color:white; width:151px" %)**AT+QCGDEFCONT=**|(% style="background-color:#4f81bd; color:white; width:474px" %)**Command Explanation**|(% style="background-color:#4f81bd; color:white; width:135px" %)**Comments**
50 +|(% style="width:117px" %)**[[1NCE>>https://1nce.com]]/[[NB card purchased by the customer>>https://1nce.com]]**|(% style="width:151px" %)iot.1nce.net/xxx|(% style="width:474px" %)This command sets the PSD connection settings for PDN connection on power-up. When the MT attaches to the NB-IoT network on power-on, a PDN connection setup is performed. Therefore, PDN connection settings are stored in NVRAM so that they can be used by the modem during the attachment.|(% style="width:135px" %)
51 51  
52 52  == 2.2 Speed Up Network Attach time ==
53 53  
... ... @@ -513,6 +513,7 @@
513 513  
514 514  === 3.6.2 Simulate with MQTT.fx ===
515 515  
516 +
516 516  [[image:image-20230802112413-39.png]]
517 517  
518 518  [[image:image-20230802112413-40.png||height="525" width="980"]]
... ... @@ -583,8 +583,7 @@
583 583  ==== 3.7.1.3 Add COAP Integration ====
584 584  
585 585  
586 -(% class="wikigeneratedid" id="H" %)
587 -[[image:image-20240729161543-9.png||height="500" width="1009"]]
587 +==== [[image:image-20240729161543-9.png||height="500" width="1009"]] ====
588 588  
589 589  
590 590  === 3.7.2 Node Configuration(Example: Connecting to the Thingsboard platform) ===
... ... @@ -602,17 +602,26 @@
602 602  Note:The port for the COAP protocol has been fixed to 5683
603 603  
604 604  
605 -* AT+URI1=11,(% style="color:red" %)**character length**(%%),"Needs to be consistent with the CoAP endpoint URL in the platform",
605 +* AT+URL1=11,(% style="color:red" %)**character length**(%%),"Needs to be consistent with the CoAP endpoint URL in the platform"
606 606  
607 --NB/NS products use the (% style="color:red" %)**BC660K**(%%) module, only need to configure (% style="color:red" %)**only one URL**(%%) command.
607 +If the module used is (% style="color:red" %)**BC660K, only one **(%%)URL directive needs to be configured,
608 608  
609 609  e.g.
610 610  
611 -* AT+URI1=11,38, "i/faaaa241f-af4a-b780-4468-c671bb574858"
611 +* AT+URL1=11,38, "i/faaaa241f-af4a-b780-4468-c671bb574858"
612 612  
613 613  [[image:image-20240729172415-13.png||height="401" width="694"]]
614 614  
615 +If you are using a (% style="color:red" %)**BG95-M2**(%%) module, you need to configure (% style="color:red" %)**TWO**(%%) URL commands,
615 615  
617 +e.g.
618 +
619 +* AT+URL1=11, "i"
620 +* AT+URL2=11,"faaaa241f-af4a-b780-4468-c671bb574858"
621 +
622 +[[image:image-20240729172500-14.png||height="403" width="700"]]
623 +
624 +
616 616  == 3.8 [[Tago.io>>url:https://admin.tago.io/]] (via MQTT) ==
617 617  
618 618  === 3.8.1 Create device & Get Credentials ===
... ... @@ -717,152 +717,6 @@
717 717  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]]
718 718  
719 719  
720 -== 3.11 ThingsEye (via MQTT) ==
721 -
722 -=== 3.11.1 Configure ThingsEye ===
723 -
724 -==== 3.11.1.1 Create MQTT integration ====
725 -
726 -
727 -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_NB”**(%%), select type (% style="color:blue" %)**MQTT**;
728 -
729 -[[image:image-20241126175509-1.png||height="518" width="1081"]]
730 -
731 -
732 -Next, directly select to create a new Uplink data converter and downlink data converter.
733 -
734 -[[image:image-20241126180135-2.png||height="535" width="1092"]]
735 -
736 -[[image:image-20241126180223-3.png||height="518" width="1093"]]
737 -
738 -
739 -(% style="color:blue" %)**Add a topic filter:**
740 -
741 -Consistent with the theme of the node setting.
742 -
743 -(% style="color:red" %)**Note: Recommended MQTT broker: lns1.thingseye.io 8883, fixed use. Topic can be changed on their own, but it need to be consistent with the node's publish and subscribe topic.**
744 -
745 -You can also select an MQTT QoS level. We use MQTT QoS level 0 (At most once) by default;
746 -
747 -[[image:image-20241126181024-4.png||height="521" width="1081"]]
748 -
749 -
750 -==== 3.11.1.2 Add credentials to the MQTT integration ====
751 -
752 -
753 -Click on the MQTT integration you just created.
754 -
755 -[[image:image-20241126181837-5.png||height="365" width="1079"]]
756 -
757 -
758 -Click the edit icon in the upper right corner to enter the edit mode.
759 -
760 -[[image:image-20241126184523-13.png||height="330" width="1075"]]
761 -
762 -
763 -(% style="color:blue" %)**Add credential files.**
764 -
765 -Click this [[link>>https://www.dropbox.com/scl/fo/d5s1wf36f4syv30a8laup/AK8FjVpNXYXCWodRnnQ1Hig?rlkey=jrz1ip0f0xwwq5z2m2gu1tuij&e=1&st=kl4caub0&dl=0]] to download the certificates.
766 -
767 -[[image:image-20241126183032-8.png||height="757" width="976"]]
768 -
769 -When the addition is complete, save the Settings.
770 -
771 -[[image:image-20241126184303-12.png||height="284" width="975"]]
772 -
773 -[[image:image-20241126184211-11.png||height="161" width="977"]]
774 -
775 -
776 -==== 3.11.1.3 Setup uplink and downlink converters ====
777 -
778 -
779 -First, you need to download the [[**MQTT uplink/downlink JS** **code**>>https://www.dropbox.com/scl/fo/d5s1wf36f4syv30a8laup/AK8FjVpNXYXCWodRnnQ1Hig?rlkey=jrz1ip0f0xwwq5z2m2gu1tuij&e=1&st=kl4caub0&dl=0]].
780 -
781 -* (% style="color:blue" %)**Uplink Converter**
782 -
783 -The purpose of the decoder function is to parse the incoming data and metadata to a format that ThingsBoard can consume.
784 -
785 -Go to the (% style="color:blue" %)**Integrations center**(%%) -> (% style="color:blue" %)**Data converters**(%%) page, and find that MQTT uplink converter that was newly created when the integration was created.
786 -
787 -[[image:image-20241126184906-14.png||height="424" width="1100"]]
788 -
789 -Enter edit mode and apply **MQTT uplink JS code** to this uplink converter.
790 -
791 -[[image:image-20241126190131-15.png||height="542" width="1103"]]
792 -
793 -
794 -* (% style="color:blue" %)**Downlink Converter**
795 -
796 -Go to the (% style="color:blue" %)**Integrations center**(%%) -> (% style="color:blue" %)**Data converters**(%%) page, and find that MQTT downlink converter that was newly created when the integration was created.
797 -
798 -[[image:image-20241126190251-16.png||height="372" width="1113"]]
799 -
800 -Enter edit mode and apply **MQTT downlink JS code** to this downlink converter.
801 -
802 -[[image:image-20241126190737-17.png||height="527" width="1114"]]
803 -
804 -
805 -=== 3.11.2 Simulate with MQTT.fx ===
806 -
807 -
808 -[[image:image-20241126191118-18.png||height="605" width="835"]]
809 -
810 -[[image:image-20241126193252-25.png||height="663" width="803"]]
811 -
812 -
813 -=== 3.11.3 Configure -NB node ===
814 -
815 -
816 -First you need to configure the certificate to the -NB node. Follow the instructions in this **[[link>>https://wiki.dragino.com/xwiki/bin/view/Dragino%20NB%20device%20connection%20to%20AWS%20platform%20instructions/#H4.1.2Configurecertificate]]** to configure the certificate.
817 -
818 -Screenshot of successful certificate configuration:
819 -
820 -* Configuring the CA Certificate
821 -
822 -[[image:image-20241126192009-19.png||height="431" width="697"]]
823 -
824 -[[image:image-20241126192130-21.png||height="426" width="694"]]
825 -
826 -* Configure client certificate
827 -
828 -[[image:image-20241126192246-22.png||height="397" width="693"]][[image:image-20241126192315-23.png||height="402" width="645"]]
829 -
830 -* Configure client private key
831 -
832 -[[image:image-20241126192415-24.png||height="435" width="737"]]
833 -
834 -
835 -When the certificate is configured, burn the boot program, burn the working firmware, and then restart the device.
836 -
837 -Then configure the -NB node to connect to the ThingsEye platform:
838 -
839 -(% style="color:blue" %)**AT Commands**
840 -
841 -* (% style="color:#037691" %)**AT+PRO=3,5  **(%%)** **~/~/ Use MQTT Connection & Json Payload
842 -* (% style="color:#037691" %)**AT+SERVADDR=lns1.thingseye.io,8883**
843 -* (% style="color:#037691" %)**AT+SUBTOPIC=8899     **(%%)~/~/ Consistent with the Topic of MQTT integration created by ThingsEye
844 -* (% style="color:#037691" %)**AT+PUBTOPIC=8899     **(%%)~/~/ Consistent with the Topic of MQTT integration created by ThingsEye
845 -* (% style="color:#037691" %)**AT+CLIENT=NULL**
846 -* (% style="color:#037691" %)**AT+UNAME=NULL**
847 -* (% style="color:#037691" %)**AT+PWD=NULL**
848 -* (% style="color:#037691" %)**AT+TLSMOD=1,2**
849 -
850 -Test Uplink by click the button for 1~~3 seconds, the MQTT integration in ThingsEye allows you to view the data upstream from the device:
851 -
852 -[[image:image-20241126193458-26.png||height="375" width="1012"]]
853 -
854 -[[image:image-20241126193609-27.png||height="424" width="1014"]]
855 -
856 -
857 -Go to (% style="color:blue" %)**"Device" **(%%) -> (% style="color:blue" %)** "Search Device"**(%%), enter the (% style="color:blue" %)** IMEI**(%%) of the device to find the device.
858 -
859 -[[image:image-20241126194018-28.png||height="318" width="1076"]]
860 -
861 -You can view the data that has just been uplink on the device:
862 -
863 -[[image:image-20241126194123-29.png||height="486" width="1073"]]
864 -
865 -
866 866  = 4. MQTT/UDP/TCP downlink =
867 867  
868 868  == 4.1 MQTT (via MQTT.fx) ==
... ... @@ -923,8 +923,8 @@
923 923  1. Give more sampling data points.
924 924  1. Increase reliable in transmission. For example. If user set
925 925  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)
926 -1*. **AT+NOUD=24**  ~/~/  The device uploads 24 sets of recorded data by default. Up to 32 sets of record data can be uploaded.
927 -1*. **AT+TDC=7200**  ~/~/  Uplink every 2 hours.
789 +1*. **AT+NOUD=24** ~/~/  The device uploads 24 sets of recorded data by default. Up to 32 sets of record data can be uploaded.
790 +1*. **AT+TDC=7200**  ~/~/ Uplink every 2 hours.
928 928  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.
929 929  
930 930  == 5.2 Why the uplink JSON format is not standard? ==
... ... @@ -937,14 +937,6 @@
937 937  [[image:image-20240229233154-1.png]]
938 938  
939 939  
940 -== 5.3 What is the data consumption for different transfer mode？ ==
941 -
942 -
943 -For the data consumption of NB-IoT End node in different transfer mode, reference link:
944 -
945 -[[https:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/Traffic%20Statistics%20~~-~~-%20NBCB/>>https://wiki.dragino.com/xwiki/bin/view/Main/Traffic%20Statistics%20--%20NBCB/]]
946 -
947 -
948 948  = 6. Trouble Shooting: =
949 949  
950 950  == 6.1 Checklist for debuging Network Connection issue. Signal Strenght:99 issue. ==
... ... @@ -1026,13 +1026,9 @@
1026 1026  
1027 1027  == (% data-sider-select-id="765eceff-93b1-40ee-800b-b7b7d022ef8a" %)6.5 What is the Downlink Command by the NB device?(%%) ==
1028 1028  
1029 -
1030 -Firstly, it is recommended that users upgrade the firmware of the -NB node to the latest version, as the processing method for downlink commands varies depending on the firmware version. Below, we will introduce the latest downlink command format.
1031 -
1032 1032  (% data-sider-select-id="bb6e9353-0c3f-473c-938d-4b416c9a03e6" %)
1033 1033  === UDP: ===
1034 1034  
1035 -
1036 1036  (% data-sider-select-id="14a4790e-7faa-4508-a4dd-7605a53f1cb3" %)
1037 1037  Its downlink command is the same as the AT command, but brackets are required.
1038 1038  Example:
... ... @@ -1043,7 +1043,6 @@
1043 1043  (% data-sider-select-id="90b80f1a-e924-4c8a-afc5-4429e019a657" %)
1044 1044  === MQTT: ===
1045 1045  
1046 -
1047 1047  Json：
1048 1048  
1049 1049  The Json format in MQTT mode needs to be configured with all commands.
... ... @@ -1083,44 +1083,16 @@
1083 1083  [[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/]]
1084 1084  
1085 1085  
1086 -== (% data-sider-select-id="765eceff-93b1-40ee-800b-b7b7d022ef8a" %)6.6 How to get the debug log for further analyze?(%%) ==
936 +== (% data-sider-select-id="765eceff-93b1-40ee-800b-b7b7d022ef8a" %)6.6 How to obtain device logs?(%%) ==
1087 1087  
1088 1088  
1089 -If user is not able to solve the connection issue, user can use below method and get the device log and send to Dragino (Support@dragino.cc) for further analyze.
939 +* **AT Command: AT** **+GETLOG**
1090 1090  
941 +This command can be used to query upstream logs of data packets.
1091 1091  
1092 -(% class="lead" %)
1093 -Step1: Use Mobile Phone to connect device
943 +[[image:image-20240701114700-1.png]]
1094 1094  
1095 -See this link: **[[how to connect via Mobile Phone:>>https://wiki.dragino.com/xwiki/bin/view/Main/BLE%20Bluetooth%20Remote%20Configure/#H3.1UseDraginoDeviceTooltoconfigureorupgradefirmware]]**
1096 1096  
1097 -
1098 -(% class="lead" %)
1099 -Step2: Get Log by different commands.
1100 -
1101 -Use below three method to generate logs.
1102 -
1103 -* **AT+CFG       ~-~-> Command to show the current configuration**
1104 -* **AT** **+GETLOG   ~-~-> Command to get the previous upstream log**
1105 -* **press the toggle button for 1 ~~2 seconds     ~-~-> Trigger a uplink**
1106 -
1107 -Above are the output example for about three action:
1108 -
1109 -[[image:image-20250121235119-1.png||height="493" width="455"]]
1110 -
1111 -[[image:image-20240207002129-2.png]]
1112 -
1113 -
1114 -(% class="lead" %)
1115 -Step3: Export Log
1116 -
1117 -[[image:https://wiki.dragino.com/xwiki/bin/download/Main/BLE%20Bluetooth%20Remote%20Configure/WebHome/image-20241230155425-16.png?width=330&height=85&rev=1.1||alt="image-20241230155425-16.png" height="85" width="330"]]
1118 -
1119 -select the log you want to export, then click the share icon on the far right to enter the document that comes with your phone and choose to export it.
1120 -
1121 -[[image:https://wiki.dragino.com/xwiki/bin/download/Main/BLE%20Bluetooth%20Remote%20Configure/WebHome/image-20241230155528-17.png?width=327&height=324&rev=1.1||alt="image-20241230155528-17.png" height="324" width="327"]]
1122 -
1123 -
1124 1124  == 6.7 How to find the AT Command Password if lost? ==
1125 1125  
1126 1126  
... ... @@ -1140,7 +1140,6 @@
1140 1140  
1141 1141  === Version Confirmation ===
1142 1142  
1143 -
1144 1144  We are now dividing the **old firmware**(without FDR1 function) with the **new firmware**(with FDR1 function) by whether it contains FDR1 functionality. Please refer to the table:
1145 1145  
1146 1146  (% border="1" style="background-color:#f2f2f2; width:510px" %)
... ... @@ -1211,6 +1211,7 @@
1211 1211  [[image:http://wiki.dragino.com/xwiki/bin/download/Why%20can%27t%20the%20password%20access%20AT%20command%20after%20upgrade%28-NB%29%3F/WebHome/image-20240827180414-1.png?width=910&height=527&rev=1.1||alt="image-20240827180414-1.png"]]
1212 1212  
1213 1213  
1035 +
1214 1214  === Special case ===
1215 1215  
1216 1216  
... ... @@ -1218,6 +1218,7 @@
1218 1218  
1219 1219  Invalid query screenshot example:
1220 1220  
1043 +
1221 1221  [[image:http://wiki.dragino.com/xwiki/bin/download/Why%20can%27t%20the%20password%20access%20AT%20command%20after%20upgrade%28-NB%29%3F/WebHome/image-20240827181447-4.png?width=889&height=519&rev=1.1||alt="image-20240827181447-4.png"]]
1222 1222  
1223 1223  [[image:http://wiki.dragino.com/xwiki/bin/download/Why%20can%27t%20the%20password%20access%20AT%20command%20after%20upgrade%28-NB%29%3F/WebHome/image-20240827181431-3.png?width=892&height=515&rev=1.1||alt="image-20240827181431-3.png"]]
image-20241126191118-18.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.ting
Size
... ... @@ -1,1 +1,0 @@
1 -61.4 KB
Content
image-20241126192009-19.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.ting
Size
... ... @@ -1,1 +1,0 @@
1 -113.6 KB
Content
image-20241126192122-20.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.ting
Size
... ... @@ -1,1 +1,0 @@
1 -105.2 KB
Content
image-20241126192130-21.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.ting
Size
... ... @@ -1,1 +1,0 @@
1 -105.2 KB
Content
image-20241126192246-22.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.ting
Size
... ... @@ -1,1 +1,0 @@
1 -87.7 KB
Content
image-20241126192315-23.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.ting
Size
... ... @@ -1,1 +1,0 @@
1 -99.0 KB
Content
image-20241126192415-24.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.ting
Size
... ... @@ -1,1 +1,0 @@
1 -88.2 KB
Content
image-20241126193252-25.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.ting
Size
... ... @@ -1,1 +1,0 @@
1 -64.2 KB
Content
image-20241126193458-26.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.ting
Size
... ... @@ -1,1 +1,0 @@
1 -144.3 KB
Content
image-20241126193609-27.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.ting
Size
... ... @@ -1,1 +1,0 @@
1 -167.5 KB
Content
image-20241126194018-28.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.ting
Size
... ... @@ -1,1 +1,0 @@
1 -63.5 KB
Content
image-20241126194123-29.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.ting
Size
... ... @@ -1,1 +1,0 @@
1 -126.7 KB
Content
image-20250121235119-1.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Edwin
Size
... ... @@ -1,1 +1,0 @@
1 -145.4 KB
Content