Last modified by Mengting Qiu on 2025/07/17 10:51

From version 229.5
edited by Mengting Qiu
on 2025/06/16 09:11
Change comment: There is no comment for this version
To version 231.5
edited by Mengting Qiu
on 2025/07/03 18:50
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -1043,14 +1043,37 @@
1043 1043  (% data-sider-select-id="90b80f1a-e924-4c8a-afc5-4429e019a657" %)
1044 1044  === **MQTT Protocol:** ===
1045 1045  
1046 -Supports both **JSON-format** and **HEX-format** downlink commands (corresponding to AT commands).
1046 +==== **1. HEX-format** ====
1047 1047  
1048 -Json
1048 +Supports **HEX-format** downlink commands (corresponding to AT commands).
1049 1049  
1050 -The Json format in MQTT mode needs to be configured with all commands.
1051 -If you have configurations that need to be changed, please change them in the template below.
1052 -Template:
1050 +//Example~:// For the S31-NB's uplink interval modification (AT+TDC=900):
1053 1053  
1052 +* HEX format: (% style="color:blue" %)**01000384**(%%)  ~/~/ There are no Spaces. 0x0384(H)=900(D), that is, modify TDC to 900 seconds.
1053 +* JSON format: (% 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 {}.
1054 +
1055 +(% style="color:red" %)**Note:**
1056 +
1057 +(% 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.**
1058 +
1059 +(% 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.**
1060 +
1061 +(% 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.**
1062 +
1063 +[[image:1750035004731-376.png||height="276" width="557"]]
1064 +
1065 +
1066 +==== **2. JSON-format ** ====
1067 +
1068 +===== **2. 1 JSON format template.** =====
1069 +
1070 +All -CB nodes support downlink configuration modification using (% style="color:blue" %)**JSON format templates.**
1071 +
1072 +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.
1073 +Template.
1074 +
1075 +Take the template of D2x-CB as an example:
1076 +
1054 1054  {
1055 1055  "AT+SERVADDR":"119.91.62.30,1882",
1056 1056  "AT+CLIENT":"JwcXKjQBNhQ2JykDDAA5Ahs",
... ... @@ -1074,18 +1074,27 @@
1074 1074  "AT+TEMPALARM3":"0"
1075 1075  }
1076 1076  
1077 -Hex:
1100 +**Instructions for Using the Template:**
1078 1078  
1079 -MQTT's hex format. Since many commands need to support strings, only a few commands are supported.
1102 +1. Modify the parameters for each AT command in the template as needed.
1103 +1. Send the entire template in one downlink command.
1080 1080  
1081 -The supported commands are consistent with LoRaWAN's hex commands.
1082 -Please refer to the following link to obtain the hex format:
1105 +(% style="color:red" %)**Note:**
1083 1083  
1084 -[[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/]]
1107 +* The template may vary depending on the device model.
1108 +* **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.
1085 1085  
1110 +===== **2.2 Support sending json format commands separately** =====
1086 1086  
1112 +Some models of nodes support sending json format commands separately:**RS485-CB, LDS25-CB, CS01-CB, SDI-12-CB, SW3L-CB, WL03A-CB, PS-CB**
1113 +
1114 +//Example~:// For the PS-CB's uplink interval modification (AT+TDC=900):
1115 +
1116 +Downlink command:  **{AT+TDC=900}       **~/~/ The correct format is **{AT Command}**. No extra characters other than valid AT commands can be added within {}.
1117 +
1087 1087  (% style="color:red" %)**Note:**
1088 1088  
1120 +
1089 1089  (% 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.**
1090 1090  
1091 1091  (% 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.**
... ... @@ -1092,7 +1092,6 @@
1092 1092  
1093 1093  (% 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.**
1094 1094  
1095 -[[image:1750035004731-376.png||height="276" width="557"]]
1096 1096  
1097 1097  
1098 1098  == (% data-sider-select-id="765eceff-93b1-40ee-800b-b7b7d022ef8a" %)6.6 How to get the debug log for further analyze?(%%) ==
... ... @@ -1155,30 +1155,26 @@
1155 1155  
1156 1156  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:
1157 1157  
1158 -(% border="1" style="background-color:#f2f2f2; width:510px" %)
1159 -|(% style="background-color:#4f81bd; color:white; width:210px" %)**General Model**|(% style="background-color:#4f81bd; color:white; width:150px" %)(((
1160 -**Firmware version**
1161 -
1162 -**(without FDR1 function)**
1163 -)))|(% style="background-color:#4f81bd; color:white; width:150px" %)(((
1164 -**Firmware version**
1165 -
1166 -**(with FDR1 function)**
1189 +(% border="1" style="background-color:#f2f2f2; width:912px" %)
1190 +|(% style="background-color:#4f81bd; color:white; width:306px" %)**General Model**|(% style="background-color:#4f81bd; color:white; width:311px" %)(((
1191 +**Firmware version (without FDR1 function)**
1192 +)))|(% style="background-color:#4f81bd; color:white; width:289px" %)(((
1193 +**Firmware version (with FDR1 function)**
1167 1167  )))
1168 -|(% style="width:210px" %)(((
1195 +|(% style="width:306px" %)(((
1169 1169  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;
1170 -)))|(% style="width:150px" %)Before V1.2.1|(% style="width:150px" %)After V1.2.1 (including V1.2.1)
1171 -|(% style="width:210px" %)(((
1197 +)))|(% style="width:311px" %)Before V1.2.1|(% style="width:289px" %)After V1.2.1 (including V1.2.1)
1198 +|(% style="width:306px" %)(((
1172 1172  WL03A-NB, SDI-12-NB;
1173 -)))|(% style="width:150px" %)Before V1.0.2|(% style="width:150px" %)(((
1200 +)))|(% style="width:311px" %)Before V1.0.2|(% style="width:289px" %)(((
1174 1174  After V1.0.8 (including V1.0.2)
1175 1175  )))
1176 -|(% style="width:210px" %)(((
1203 +|(% style="width:306px" %)(((
1177 1177  SW3L-NB, PS-NB;
1178 -)))|(% style="width:150px" %)Before V1.0.5|(% style="width:150px" %)(((
1205 +)))|(% style="width:311px" %)Before V1.0.5|(% style="width:289px" %)(((
1179 1179  After V1.0.5 (including V1.0.5)
1180 1180  )))
1181 -|(% style="width:210px" %)RS485-NB|(% style="width:150px" %)Before V1.0.8|(% style="width:150px" %)After V1.0.8 (including V1.0.8)
1208 +|(% style="width:306px" %)RS485-NB|(% style="width:311px" %)Before V1.0.8|(% style="width:289px" %)After V1.0.8 (including V1.0.8)
1182 1182  
1183 1183  === UART connection and firmware update methods ===
1184 1184  
... ... @@ -1236,4 +1236,11 @@
1236 1236  
1237 1237  
1238 1238  
1266 +== 6.8 ==
1267 +
1268 +
1269 +
1270 +
1271 +
1272 +
1239 1239