Last modified by Kilight Cao on 2025/07/23 16:27

From version 229.16
edited by Mengting Qiu
on 2025/06/16 09:25
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,22 +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 +Supports **HEX-format** downlink commands (corresponding to AT commands).
1049 +
1048 1048  //Example~:// For the S31-NB's uplink interval modification (AT+TDC=900):
1049 1049  
1050 1050  * HEX format: (% style="color:blue" %)**01000384**(%%)  ~/~/ There are no Spaces. 0x0384(H)=900(D), that is, modify TDC to 900 seconds.
1051 -* 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 {}.
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 {}.
1052 1052  
1055 +(% style="color:red" %)**Note:**
1053 1053  
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.**
1054 1054  
1055 -**Template for Batch Configuration:**
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.**
1056 1056  
1057 -We can also 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.
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.**
1058 1058  
1063 +[[image:1750035004731-376.png||height="276" width="557"]]
1059 1059  
1060 -Template:
1061 1061  
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 +
1062 1062  {
1063 1063  "AT+SERVADDR":"119.91.62.30,1882",
1064 1064  "AT+CLIENT":"JwcXKjQBNhQ2JykDDAA5Ahs",
... ... @@ -1087,10 +1087,22 @@
1087 1087  1. Modify the parameters for each AT command in the template as needed.
1088 1088  1. Send the entire template in one downlink command.
1089 1089  
1105 +(% style="color:red" %)**Note:**
1090 1090  
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.
1091 1091  
1110 +===== **2.2 Support sending json format commands separately** =====
1111 +
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 +
1092 1092  (% style="color:red" %)**Note:**
1093 1093  
1120 +
1094 1094  (% 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.**
1095 1095  
1096 1096  (% 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.**
... ... @@ -1097,7 +1097,6 @@
1097 1097  
1098 1098  (% 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.**
1099 1099  
1100 -[[image:1750035004731-376.png||height="276" width="557"]]
1101 1101  
1102 1102  
1103 1103  == (% data-sider-select-id="765eceff-93b1-40ee-800b-b7b7d022ef8a" %)6.6 How to get the debug log for further analyze?(%%) ==
... ... @@ -1160,30 +1160,26 @@
1160 1160  
1161 1161  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:
1162 1162  
1163 -(% border="1" style="background-color:#f2f2f2; width:510px" %)
1164 -|(% style="background-color:#4f81bd; color:white; width:210px" %)**General Model**|(% style="background-color:#4f81bd; color:white; width:150px" %)(((
1165 -**Firmware version**
1166 -
1167 -**(without FDR1 function)**
1168 -)))|(% style="background-color:#4f81bd; color:white; width:150px" %)(((
1169 -**Firmware version**
1170 -
1171 -**(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)**
1172 1172  )))
1173 -|(% style="width:210px" %)(((
1195 +|(% style="width:306px" %)(((
1174 1174  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;
1175 -)))|(% style="width:150px" %)Before V1.2.1|(% style="width:150px" %)After V1.2.1 (including V1.2.1)
1176 -|(% 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" %)(((
1177 1177  WL03A-NB, SDI-12-NB;
1178 -)))|(% style="width:150px" %)Before V1.0.2|(% style="width:150px" %)(((
1200 +)))|(% style="width:311px" %)Before V1.0.2|(% style="width:289px" %)(((
1179 1179  After V1.0.8 (including V1.0.2)
1180 1180  )))
1181 -|(% style="width:210px" %)(((
1203 +|(% style="width:306px" %)(((
1182 1182  SW3L-NB, PS-NB;
1183 -)))|(% style="width:150px" %)Before V1.0.5|(% style="width:150px" %)(((
1205 +)))|(% style="width:311px" %)Before V1.0.5|(% style="width:289px" %)(((
1184 1184  After V1.0.5 (including V1.0.5)
1185 1185  )))
1186 -|(% 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)
1187 1187  
1188 1188  === UART connection and firmware update methods ===
1189 1189  
... ... @@ -1241,4 +1241,11 @@
1241 1241  
1242 1242  
1243 1243  
1266 +== 6.8 ==
1267 +
1268 +
1269 +
1270 +
1271 +
1272 +
1244 1244