Last modified by Kilight Cao on 2025/07/23 16:27
From version 232.2
edited by Mengting Qiu
on 2025/07/03 18:54
on 2025/07/03 18:54
Change comment:
There is no comment for this version
To version 219.1
edited by Kilight Cao
on 2024/12/11 17:24
on 2024/12/11 17:24
Change comment:
There is no comment for this version
Summary
-
Page properties (2 modified, 0 added, 0 removed)
-
Attachments (0 modified, 0 added, 4 removed)
Details
- Page properties
-
- Author
-
... ... @@ -1,1 +1,1 @@ 1 -XWiki. ting1 +XWiki.Kilight - 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:1 52px" %)**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:1 52px" %)**[[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+UR I1=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/NSproductsusethe(% 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+UR I1=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 === ... ... @@ -721,6 +721,7 @@ 721 721 722 722 === 3.11.1 Configure ThingsEye === 723 723 733 + 724 724 ==== 3.11.1.1 Create MQTT integration ==== 725 725 726 726 ... ... @@ -773,7 +773,7 @@ 773 773 [[image:image-20241126184211-11.png||height="161" width="977"]] 774 774 775 775 776 -==== 3.11.1. 3Setup uplink and downlink converters ====786 +==== 3.11.1.2 Setup uplink and downlink converters ==== 777 777 778 778 779 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]]. ... ... @@ -810,7 +810,7 @@ 810 810 [[image:image-20241126193252-25.png||height="663" width="803"]] 811 811 812 812 813 -=== 3. 11.3 Configure -NB node ===823 +=== 3.6.3 Configure -NB node === 814 814 815 815 816 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. ... ... @@ -819,10 +819,8 @@ 819 819 820 820 * Configuring the CA Certificate 821 821 822 -[[image:image-20241126192009-19.png||height="431" width="697"]] 832 +[[image:image-20241126192009-19.png||height="431" width="697"]][[image:image-20241126192130-21.png||height="426" width="694"]] 823 823 824 -[[image:image-20241126192130-21.png||height="426" width="694"]] 825 - 826 826 * Configure client certificate 827 827 828 828 [[image:image-20241126192246-22.png||height="397" width="693"]][[image:image-20241126192315-23.png||height="402" width="645"]] ... ... @@ -840,12 +840,12 @@ 840 840 841 841 * (% style="color:#037691" %)**AT+PRO=3,5 **(%%)** **~/~/ Use MQTT Connection & Json Payload 842 842 * (% style="color:#037691" %)**AT+SERVADDR=lns1.thingseye.io,8883** 843 -* (% style="color:#037691" %)**AT+SUBTOPIC=8899 **(%%)~/~/ 844 -* (% style="color:#037691" %)**AT+PUBTOPIC=8899 **(%%)~/~/ 851 +* (% style="color:#037691" %)**AT+SUBTOPIC=8899 **(%%)~/~/Consistent with the Topic of MQTT integration created by ThingsEye 852 +* (% style="color:#037691" %)**AT+PUBTOPIC=8899 **(%%)~/~/Consistent with the Topic of MQTT integration created by ThingsEye 845 845 * (% style="color:#037691" %)**AT+CLIENT=NULL** 846 846 * (% style="color:#037691" %)**AT+UNAME=NULL** 847 847 * (% style="color:#037691" %)**AT+PWD=NULL** 848 -* (% style="color:#037691" %)**AT+TLSMOD=1, 2**856 +* (% style="color:#037691" %)**AT+TLSMOD=1,0** 849 849 850 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 851 ... ... @@ -863,6 +863,7 @@ 863 863 [[image:image-20241126194123-29.png||height="486" width="1073"]] 864 864 865 865 874 + 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** 927 -1*. **AT+TDC=7200** 935 +1*. **AT+NOUD=24** ~/~/ The device uploads 24 sets of recorded data by default. Up to 32 sets of record data can be uploaded. 936 +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,7 +937,7 @@ 937 937 [[image:image-20240229233154-1.png]] 938 938 939 939 940 -== 5.3 What is the data consumption for different transfer mode? == 949 +== 5.3 What is the data consumption for different transfer mode? == 941 941 942 942 943 943 For the data consumption of NB-IoT End node in different transfer mode, reference link: ... ... @@ -944,7 +944,6 @@ 944 944 945 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 946 947 - 948 948 = 6. Trouble Shooting: = 949 949 950 950 == 6.1 Checklist for debuging Network Connection issue. Signal Strenght:99 issue. == ... ... @@ -1024,47 +1024,27 @@ 1024 1024 [[image:image-20240226111928-1.png]] 1025 1025 1026 1026 1027 -== (% data-sider-select-id="765eceff-93b1-40ee-800b-b7b7d022ef8a" %)6.5 (%%)What is the Downlink CommandFormatforNBDevices? ==1035 +== (% 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 -=== **UDPProtocol:**===1038 +=== UDP: === 1034 1034 1035 -Only supports valid **HEX-format downlink commands** corresponding to AT command. 1040 +(% data-sider-select-id="14a4790e-7faa-4508-a4dd-7605a53f1cb3" %) 1041 +Its downlink command is the same as the AT command, but brackets are required. 1042 +Example: 1036 1036 1037 -Take the AT+TDC command of S31-NB as an example, that is, only the valid HEX format downstream command corresponding to the AT+TDC command can be used: 1038 -Downward format: (% style="color:blue" %)**01000384**(%%) ~/~/ There are no Spaces. 0x0384(H)=900(D), that is, modify TDC to 900 seconds. 1044 +{AT+TDC=300} 1039 1039 1040 -[[image:1750035991532-434.png||height="237" width="495"]] 1041 1041 1042 - 1043 1043 (% data-sider-select-id="90b80f1a-e924-4c8a-afc5-4429e019a657" %) 1044 -=== **MQTTProtocol:**===1048 +=== MQTT: === 1045 1045 1046 - ==== **1. HEX-format** ====1050 +Json: 1047 1047 1048 -Supports **HEX-format** downlink commands (corresponding to AT commands). 1052 +The Json format in MQTT mode needs to be configured with all commands. 1053 +If you have configurations that need to be changed, please change them in the template below. 1054 +Template: 1049 1049 1050 -//Example~:// For the S31-NB's uplink interval modification (AT+TDC=900): 1051 - 1052 -* HEX format: (% style="color:blue" %)**01000384**(%%) ~/~/ There are no Spaces. 0x0384(H)=900(D), that is, modify TDC to 900 seconds. 1053 - 1054 -[[image:1750035004731-376.png||height="276" width="557"]] 1055 - 1056 - 1057 -==== **2. JSON-format ** ==== 1058 - 1059 -===== **2. 1 JSON format template.** ===== 1060 - 1061 -All -CB nodes support downlink configuration modification using (% style="color:blue" %)**JSON format templates.** 1062 - 1063 -We can use templates to configure multiple commands AT once. Users only need to modify the parameters of the required AT commands in the correct template for each device. 1064 -Template. 1065 - 1066 -Take the template of D2x-CB as an example: 1067 - 1068 1068 { 1069 1069 "AT+SERVADDR":"119.91.62.30,1882", 1070 1070 "AT+CLIENT":"JwcXKjQBNhQ2JykDDAA5Ahs", ... ... @@ -1088,78 +1088,26 @@ 1088 1088 "AT+TEMPALARM3":"0" 1089 1089 } 1090 1090 1091 - Explanations of two special commands in the template: AT+TR (set the detection interval: 0 ~~ 255 minutes) and AT+NOUD (set the number of groups) correspond to parameters in AT+CLOCKLOG.1079 +Hex: 1092 1092 1093 - [[image:1751538862245-924.png]]1081 +MQTT's hex format. Since many commands need to support strings, only a few commands are supported. 1094 1094 1083 +The supported commands are consistent with LoRaWAN's hex commands. 1084 +Please refer to the following link to obtain the hex format: 1095 1095 1096 - **Instructionsfor Using theTemplate:**1086 +[[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/]] 1097 1097 1098 -1. Modify the parameters for each AT command in the template as needed. 1099 -1. Send the entire template in one downlink command. 1100 1100 1101 -(% style="color:red" %)**Note:**1089 +== (% data-sider-select-id="765eceff-93b1-40ee-800b-b7b7d022ef8a" %)6.6 How to obtain device logs?(%%) == 1102 1102 1103 -* The template may vary depending on the device model. 1104 -* **Currently, each specific template is being updated and tested**. If you need a template for your specific device, please contact **Dragino Technical Support** at [[support@dragino.com>>url:https://mailto:support@dragino.com/]] to request the latest downlink template. 1105 1105 1092 +* **AT Command: AT** **+GETLOG** 1106 1106 1094 +This command can be used to query upstream logs of data packets. 1107 1107 1108 - ===== **2.2 Support sending json format commands separately** =====1096 +[[image:image-20240701114700-1.png]] 1109 1109 1110 -Some models of nodes support sending json format commands separately:(% style="color:blue" %)**RS485-NB, LDS25-NB, CS01-NB, SDI-12-NB, SW3L-NB, WL03A-NB, PS-NB, LTC2-NB.** 1111 1111 1112 -//Example~:// For the PS-CB's uplink interval modification (AT+TDC=900): 1113 - 1114 -Downlink command: (% style="color:blue" %)**{AT+TDC=900}**(%%)** **~/~/ The correct format is (% style="color:blue" %)**{AT Command}**(%%). No extra characters other than valid AT commands can be added within {}. 1115 - 1116 -(% style="color:red" %)**Note:** 1117 - 1118 -(% style="color:red" %)**1. Only when the correct and valid download command is used and the format is correct can the device be configured through the download command. Invalid download content cannot be processed by the device and will be automatically restarted.** 1119 - 1120 -(% style="color:red" %)**2. Devices designed with downlink commands can utilize different downlink formats (e.g., JSON or HEX) for configuration. However, regardless of the format, the functionality is strictly limited to the downlink command specifications described in the user manual's AT command explanation.** 1121 - 1122 -(% style="color:red" %)**For example, the HEX-format downlink command corresponding to AT+TDC can only be used to configure TDC and cannot be used for queries. There is no HEX-format downlink command equivalent to AT+TDC=? , so querying TDC via downlink is not supported.** 1123 - 1124 - 1125 -== (% data-sider-select-id="765eceff-93b1-40ee-800b-b7b7d022ef8a" %)6.6 How to get the debug log for further analyze?(%%) == 1126 - 1127 - 1128 -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. 1129 - 1130 - 1131 -(% class="lead" %) 1132 -Step1: Use Mobile Phone to connect device 1133 - 1134 -See this link: **[[how to connect via Mobile Phone:>>https://wiki.dragino.com/xwiki/bin/view/Main/BLE%20Bluetooth%20Remote%20Configure/#H3.1UseDraginoDeviceTooltoconfigureorupgradefirmware]]** 1135 - 1136 - 1137 -(% class="lead" %) 1138 -Step2: Get Log by different commands. 1139 - 1140 -Use below three method to generate logs. 1141 - 1142 -* **AT+CFG ~-~-> Command to show the current configuration** 1143 -* **AT** **+GETLOG ~-~-> Command to get the previous upstream log** 1144 -* **press the toggle button for 1 ~~2 seconds ~-~-> Trigger a uplink** 1145 - 1146 -Above are the output example for about three action: 1147 - 1148 -[[image:image-20250121235119-1.png||height="493" width="455"]] 1149 - 1150 -[[image:image-20240207002129-2.png]] 1151 - 1152 - 1153 -(% class="lead" %) 1154 -Step3: Export Log 1155 - 1156 -[[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"]] 1157 - 1158 -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. 1159 - 1160 -[[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"]] 1161 - 1162 - 1163 1163 == 6.7 How to find the AT Command Password if lost? == 1164 1164 1165 1165 ... ... @@ -1179,29 +1179,32 @@ 1179 1179 1180 1180 === Version Confirmation === 1181 1181 1182 - 1183 1183 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: 1184 1184 1185 -(% border="1" style="background-color:#f2f2f2; width:912px" %) 1186 -|(% style="background-color:#4f81bd; color:white; width:306px" %)**General Model**|(% style="background-color:#4f81bd; color:white; width:311px" %)((( 1187 -**Firmware version (without FDR1 function)** 1188 -)))|(% style="background-color:#4f81bd; color:white; width:289px" %)((( 1189 -**Firmware version (with FDR1 function)** 1120 +(% border="1" style="background-color:#f2f2f2; width:510px" %) 1121 +|(% style="background-color:#4f81bd; color:white; width:210px" %)**General Model**|(% style="background-color:#4f81bd; color:white; width:150px" %)((( 1122 +**Firmware version** 1123 + 1124 +**(without FDR1 function)** 1125 +)))|(% style="background-color:#4f81bd; color:white; width:150px" %)((( 1126 +**Firmware version** 1127 + 1128 +**(with FDR1 function)** 1190 1190 ))) 1191 -|(% style="width: 306px" %)(((1130 +|(% style="width:210px" %)((( 1192 1192 CPL03-NB, S31-NB, SN50V3-NB, TS01-NB, D20-NB, DS03A-NB, DDS04-NB, DDS45-NB, DDS20-NB, DDS75-NB, LDS12-NB, LDS40-NB, LMS01-NB, MDS120-NB, MDS200-NB, SE01-NB, SPH01-NB; 1193 -)))|(% style="width: 311px" %)Before V1.2.1|(% style="width:289px" %)After V1.2.1 (including V1.2.1)1194 -|(% style="width: 306px" %)(((1132 +)))|(% style="width:150px" %)Before V1.2.1|(% style="width:150px" %)After V1.2.1 (including V1.2.1) 1133 +|(% style="width:210px" %)((( 1195 1195 WL03A-NB, SDI-12-NB; 1196 -)))|(% style="width: 311px" %)Before V1.0.2|(% style="width:289px" %)(((1135 +)))|(% style="width:150px" %)Before V1.0.2|(% style="width:150px" %)((( 1197 1197 After V1.0.8 (including V1.0.2) 1198 1198 ))) 1199 -|(% style="width: 306px" %)(((1138 +|(% style="width:210px" %)((( 1200 1200 SW3L-NB, PS-NB; 1201 -)))|(% style="width: 311px" %)Before V1.0.5|(% style="width:289px" %)(((1140 +)))|(% style="width:150px" %)Before V1.0.5|(% style="width:150px" %)((( 1202 1202 After V1.0.5 (including V1.0.5) 1203 1203 ))) 1204 -|(% style="width: 306px" %)RS485-NB|(% style="width:311px" %)Before V1.0.8|(% style="width:289px" %)After V1.0.8 (including V1.0.8)1143 +|(% style="width:210px" %)RS485-NB|(% style="width:150px" %)Before V1.0.8|(% style="width:150px" %)After V1.0.8 (including V1.0.8) 1205 1205 1206 1206 === UART connection and firmware update methods === 1207 1207 ... ... @@ -1246,6 +1246,7 @@ 1246 1246 [[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"]] 1247 1247 1248 1248 1188 + 1249 1249 === Special case === 1250 1250 1251 1251 ... ... @@ -1253,6 +1253,7 @@ 1253 1253 1254 1254 Invalid query screenshot example: 1255 1255 1196 + 1256 1256 [[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"]] 1257 1257 1258 1258 [[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"]] ... ... @@ -1259,11 +1259,4 @@ 1259 1259 1260 1260 1261 1261 1262 -== 6.8 == 1263 - 1264 - 1265 - 1266 - 1267 - 1268 - 1269 1269
- 1750035004731-376.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.ting - Size
-
... ... @@ -1,1 +1,0 @@ 1 -55.1 KB - Content
- 1750035991532-434.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.ting - Size
-
... ... @@ -1,1 +1,0 @@ 1 -54.4 KB - Content
- 1751538862245-924.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.ting - Size
-
... ... @@ -1,1 +1,0 @@ 1 -114.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