Changes for page End Device AT Commands and Downlink Command
Last modified by kai on 2024/09/06 10:00
Summary
-
Page properties (1 modified, 0 added, 0 removed)
Details
- Page properties
-
- Content
-
... ... @@ -10,6 +10,7 @@ 10 10 Dragino LoRaWAN End Node support two types of AT Commands and Downlink Commands: 11 11 12 12 * (% style="color:blue" %)**Common Commands:** (%%) They should be available for each sensor, such as: change uplink interval, reset device. 13 + 13 13 * (% style="color:blue" %)**Sensor Related Commands:** (%%) Only for special sensor, such as control relay, poll RS485 device. 14 14 15 15 ((( ... ... @@ -21,6 +21,7 @@ 21 21 22 22 23 23 * **AT Command** : See Devices User Manual for how to connect to device via USB TTL adapter and use. The user manual can be found in each product page of [[Dragino Official Website>>url:http://www.dragino.com/]] 25 + 24 24 * **LoRaWAN Downlink Command**: The gateway transfer downlink command in HEX format. This page shows the Downlink Command In HEX format. Please note some LoRaWAN servers use base64 as downlink code so user need to convert HEX to Base64 and use. Below are references for how to use downlink command: 25 25 ** Use HEX format to send a downlink: [[TTN v3>>Notes for TTN]] 26 26 ** Use Base64 format to send a downlink: [[Chirpstack>>Notes for ChirpStack]], [[How to Convert>>http://wiki.dragino.com/xwiki/bin/view/Main/Notes%20for%20ChirpStack/#H4.1ConvertHEXtoBase64]]? ... ... @@ -34,13 +34,7 @@ 34 34 Dragino STM32 base hardware Firmware / LoRaWAN stack list 35 35 36 36 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:966px" %) 37 -|(% style="background-color:#4f81bd; color:white; width:187px" %)((( 38 -**Model** 39 -)))|(% style="background-color:#4f81bd; color:white; width:330px" %)((( 40 -**Description** 41 -)))|(% style="background-color:#4f81bd; color:white; width:445px" %)((( 42 -**Firmware Version <~-~-> Stack Version** 43 -))) 39 +|(% style="background-color:#4f81bd; color:white; width:187px" %)**Model**|(% style="background-color:#4f81bd; color:white; width:330px" %)**Description**|(% style="background-color:#4f81bd; color:white; width:445px" %)**Firmware Version <~-~-> Stack Version** 44 44 |(% style="width:187px" %)((( 45 45 [[LSN50-v1>>url:http://www.dragino.com/products/lora-lorawan-end-node/item/128-lsn50.html]], [[LSN50-V2>>url:http://www.dragino.com/products/lora-lorawan-end-node/item/155-lsn50-v2.html]], 46 46 )))|(% style="width:330px" %)((( ... ... @@ -113,7 +113,7 @@ 113 113 114 114 (% style="color:blue" %)**AT Command: AT+TDC** 115 115 116 -(% border="1" style="background-color:#f2f2f2; width:727.222px" %) 112 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:727.222px" %) 117 117 |(% style="background-color:#4f81bd; color:white; width:165px" %)**Command Example**|(% style="background-color:#4f81bd; color:white; width:227px" %)**Function**|(% style="background-color:#4f81bd; color:white; width:329px" %)**Response** 118 118 |(% style="width:165px" %)AT+TDC=?|(% style="width:227px" %)Show current transmit Interval|(% style="width:329px" %)30000((( 119 119 OK ... ... @@ -135,6 +135,7 @@ 135 135 ))) 136 136 137 137 * **Example 1**: Downlink Payload:** 0100001E** ~/~/ Set Transmit Interval (TDC) = 30 seconds 134 + 138 138 * **Example 2**: Downlink Payload:** 0100003C** ~/~/ Set Transmit Interval (TDC) = 60 seconds 139 139 140 140 (% style="display:none" %) (%%) ... ... @@ -147,7 +147,7 @@ 147 147 148 148 (% style="color:blue" %)**AT Command: ATZ ~/~/ **(%%)Trig a reset of the MCU 149 149 150 -(% border="1" style="background-color:#f2f2f2; width:546px" %) 147 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:546px" %) 151 151 |(% style="background-color:#4f81bd; color:white; width:157px" %)**Command Example**|(% style="background-color:#4f81bd; color:white; width:92px" %)**Function**|(% style="background-color:#4f81bd; color:white; width:294px" %)**Response** 152 152 |(% style="width:157px" %)ATZ|(% style="width:92px" %)Reset MCU|(% style="width:294px" %)((( 153 153 Device reset and show booting info ... ... @@ -182,7 +182,7 @@ 182 182 183 183 (% style="color:blue" %)**AT Command: AT+FDR ~/~/ **(%%)Reset to factory default 184 184 185 -(% border="1" style="background-color:#f2f2f2; width:789px" %) 182 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:789px" %) 186 186 |(% style="background-color:#4f81bd; color:white; width:154px" %)**Command Example**|(% style="background-color:#4f81bd; color:white; width:175px" %)**Function**|(% style="background-color:#4f81bd; color:white; width:456px" %)**Response** 187 187 |(% style="width:154px" %)AT+FDR|(% style="width:175px" %)Reset to factory default|(% style="width:456px" %)((( 188 188 Device reset to factory default parameters and show booting info ... ... @@ -217,7 +217,7 @@ 217 217 218 218 (% style="color:blue" %)**AT Command: AT+VER ~/~/ **(%%)Image Version and Frequency Band 219 219 220 -(% border="1" style="background-color:#f2f2f2; width:542px" %) 217 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:542px" %) 221 221 |(% style="background-color:#4f81bd; color:white; width:157px" %)**Command Example**|(% style="background-color:#4f81bd; color:white; width:295px" %)**Function**|(% style="background-color:#4f81bd; color:white; width:86px" %)**Response** 222 222 |(% style="width:157px" %)AT+VER=?|(% style="width:295px" %)Show Image version and Frequency Band|(% style="width:86px" %)((( 223 223 1.3 EU868 ... ... @@ -279,7 +279,7 @@ 279 279 280 280 (% style="color:blue" %)**AT Command: AT+CFG ~/~/ **(%%)Print all configurations 281 281 282 -(% border="1" style="background-color:#f2f2f2; width:599.222px" %) 279 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:599.222px" %) 283 283 |(% style="background-color:#4f81bd; color:white; width:160px" %)**Command Example**|(% style="background-color:#4f81bd; color:white; width:154px" %)**Function**|(% style="background-color:#4f81bd; color:white; width:280px" %)**Response** 284 284 |(% style="width:160px" %)AT+CFG|(% style="width:154px" %)Show all configures|(% style="width:280px" %)((( 285 285 AT+DEUI = XX XX XX XX XX XX XX XX ... ... @@ -302,12 +302,12 @@ 302 302 303 303 (% style="color:blue" %)**AT Command: AT+APPEUI** 304 304 305 -(% border="1" style="background-color:#f2f2f2; width:6 86.222px" %)306 -|(% style="background-color:#4f81bd; color:white; width: 305px" %)**Command Example**|(% style="background-color:#4f81bd; color:white; width:186px" %)**Function**|(% style="background-color:#4f81bd; color:white; width:191px" %)**Response**307 -|(% style="width: 305px" %)AT+APPEUI=?|(% style="width:186px" %)Get the Application EUI|(% style="width:191px" %)00 b3 d5 00 00 00 00 00(((302 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:643px" %) 303 +|(% style="background-color:#4f81bd; color:white; width:272px" %)**Command Example**|(% style="background-color:#4f81bd; color:white; width:182px" %)**Function**|(% style="background-color:#4f81bd; color:white; width:184px" %)**Response** 304 +|(% style="width:272px" %)AT+APPEUI=?|(% style="width:182px" %)Get the Application EUI|(% style="width:184px" %)00 b3 d5 00 00 00 00 00((( 308 308 OK 309 309 ))) 310 -|(% style="width: 305px" %)AT+APPEUI=00 b3 d5 7e f0 00 4d 34|(% style="width:186px" %)Set the Application EUI|(% style="width:191px" %)OK307 +|(% style="width:272px" %)AT+APPEUI=00 b3 d5 7e f0 00 4d 34|(% style="width:182px" %)Set the Application EUI|(% style="width:184px" %)OK 311 311 312 312 (% style="display:none" %) (%%) 313 313 ... ... @@ -319,7 +319,7 @@ 319 319 320 320 (% style="color:blue" %)**AT Command: AT+APPKEY** 321 321 322 -(% border="1" style="background-color:#f2f2f2; width:976.222px" %) 319 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:976.222px" %) 323 323 |(% style="background-color:#4f81bd; color:white; width:441px" %)**Command Example**|(% style="background-color:#4f81bd; color:white; width:180px" %)**Function**|(% style="background-color:#4f81bd; color:white; width:350px" %)**Response** 324 324 |(% style="width:441px" %)AT+APPKEY=?|(% style="width:180px" %)Get the Application Key|(% style="width:350px" %)00 35 55 55 22 23 55 53 43 24 23 42 34 35 35 35((( 325 325 OK ... ... @@ -336,7 +336,7 @@ 336 336 337 337 (% style="color:blue" %)**AT Command: AT+APPSKEY** 338 338 339 -(% border="1" style="background-color:#f2f2f2; width:1040.22px" %) 336 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:1040.22px" %) 340 340 |(% style="background-color:#4f81bd; color:white; width:451px" %)**Command Example**|(% style="background-color:#4f81bd; color:white; width:231px" %)**Function**|(% style="background-color:#4f81bd; color:white; width:354px" %)**Response** 341 341 |(% style="width:451px" %)AT+APPSKEY=?|(% style="width:231px" %)Get the Application Session Key|(% style="width:354px" %)00 7d dc 73 33 d3 eb 9e 14 38 d5 a4 3e 62 5b e2((( 342 342 OK ... ... @@ -355,7 +355,7 @@ 355 355 356 356 (% style="color:blue" %)**AT Command: AT+DADDR** 357 357 358 -(% border="1" style="background-color:#f2f2f2; width:795.222px" %) 355 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:795.222px" %) 359 359 |(% style="background-color:#4f81bd; color:white; width:192px" %)**Command Example**|(% style="background-color:#4f81bd; color:white; width:241px" %)**Function**|(% style="background-color:#4f81bd; color:white; width:359px" %)**Response** 360 360 |(% style="width:192px" %)AT+DADDR=?|(% style="width:241px" %)Get the Application Session Key.|(% style="width:359px" %)(While Error in format, return AT_PARAM_ERROR)((( 361 361 A8 40 41 FF ... ... @@ -374,7 +374,7 @@ 374 374 375 375 (% style="color:blue" %)**AT Command: AT+DEUI** 376 376 377 -(% border="1" style="background-color:#f2f2f2; width:1035.22px" %) 374 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:1035.22px" %) 378 378 |(% style="background-color:#4f81bd; color:white; width:250px" %)**Command Example**|(% style="background-color:#4f81bd; color:white; width:147px" %)**Function**|(% style="background-color:#4f81bd; color:white; width:634px" %)**Response** 379 379 |(% style="width:250px" %)AT+DEUI=?|(% style="width:147px" %)Get the Device EUI.|(% style="width:634px" %)00 44 34 22 33 45 55 55((( 380 380 OK ... ... @@ -393,7 +393,7 @@ 393 393 394 394 (% style="color:blue" %)**AT Command: AT+NWKID** 395 395 396 -(% border="1" style="background-color:#f2f2f2; width:448.222px" %) 393 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:448.222px" %) 397 397 |(% style="background-color:#4f81bd; color:white; width:191px" %)**Command Example**|(% style="background-color:#4f81bd; color:white; width:153px" %)**Function**|(% style="background-color:#4f81bd; color:white; width:101px" %)**Response** 398 398 |(% style="width:191px" %)AT+NWKID=?|(% style="width:153px" %)Get the Network ID.|(% style="width:101px" %)a8 40 41 ff((( 399 399 OK ... ... @@ -410,7 +410,7 @@ 410 410 411 411 (% style="color:blue" %)**AT Command: AT+NWKSKEY** 412 412 413 -(% border="1" style="background-color:#f2f2f2; width:1017.22px" %) 410 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:1017.22px" %) 414 414 |(% style="background-color:#4f81bd; color:white; width:455px" %)**Command Example**|(% style="background-color:#4f81bd; color:white; width:215px" %)**Function**|(% style="background-color:#4f81bd; color:white; width:343px" %)**Response** 415 415 |(% style="width:455px" %)AT+NWKSKEY=?|(% style="width:215px" %)Get the Network Session Key.|(% style="width:343px" %)00 4f 19 25 52 ce 97 09 d7 fa 84 71 db 51 02 92((( 416 416 OK ... ... @@ -431,7 +431,7 @@ 431 431 432 432 (% style="color:blue" %)**AT Command: AT+CFM** 433 433 434 -(% border="1" style="background-color:#f2f2f2; width:710.222px" %) 431 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:710.222px" %) 435 435 |(% style="background-color:#4f81bd; color:white; width:155px" %)**Command Example**|(% style="background-color:#4f81bd; color:white; width:205px" %)**Function**|(% style="background-color:#4f81bd; color:white; width:346px" %)**Response** 436 436 |(% style="width:155px" %)AT+CFM=?|(% style="width:205px" %)Get the confirmation mode|(% style="width:346px" %)0((( 437 437 OK ... ... @@ -446,6 +446,7 @@ 446 446 If the downlink payload=0501, it means set end node to use confirm mode, while type code is 05. 447 447 448 448 * **Example 1:** Downlink Payload: 0501 ~/~/ Set AT+CFM=1 446 + 449 449 * **Example 2:** Downlink Payload: 0500 ~/~/ Set AT+CFM=0 450 450 451 451 (% style="display:none" %) (%%) ... ... @@ -492,6 +492,7 @@ 492 492 If the downlink payload=05010101, it means set end node to use confirm mode, while type code is 05. 493 493 494 494 * **Example 1:** Downlink Payload: 05010101 ~/~/ Set AT+CFM=1,1,1 493 + 495 495 * **Example 2:** Downlink Payload: 05000700 ~/~/ Set AT+CFM=0,7,0 496 496 497 497 (% style="display:none" %) (%%) ... ... @@ -552,6 +552,7 @@ 552 552 If the downlink payload=2000, it means set the Network Join Mode, while type code is 20. 553 553 554 554 * **Example 1: **Downlink Payload: **2000 ** ~/~/ Set AT+NJM=0 554 + 555 555 * **Example 2:** Downlink Payload: **2001** ~/~/ Set AT+NJM=1 556 556 557 557 (% style="display:none" %) (%%) ... ... @@ -663,6 +663,7 @@ 663 663 If the downlink payload=2201, it means setting the adaptive data rate to 1, while type code is 22. 664 664 665 665 * **Example 1**: Downlink Payload: **2201** ~/~/ Set AT+ADR=1. 666 + 666 666 * **Example 2**: Downlink Payload: **2200FFFF** ~/~/ Set AT+ADR=0. 667 667 668 668 (% style="display:none" %) (%%) ... ... @@ -719,6 +719,7 @@ 719 719 **Notice:** 720 720 721 721 * User need to set Adaptive Data Rate(ADR)=0 first. otherwise device will respond to server's ADR command and change the DR according to server auto-adjustment. 723 + 722 722 * Data Rate specifies Spreading Factor. The mapping varies in different frequency bands. User can check this link for detail. [[rp2-1.0.3-lorawan-regional-parameters.pdf>>https://lora-alliance.org/resource_hub/rp2-1-0-3-lorawan-regional-parameters/]] 723 723 724 724 (% style="color:blue" %)**AT Command: AT+DR** ... ... @@ -737,6 +737,7 @@ 737 737 If the downlink payload=220001FF, it means setting the data rate to 1, while type code is 22 00 aa FF. 738 738 739 739 * **Example 1**: Downlink Payload: **220001FF** ~/~/ Set AT+DR=1. 742 + 740 740 * **Example 2**: Downlink Payload: **220000FF** ~/~/ Set AT+DR=0. 741 741 742 742 (% style="display:none" %) (%%) ... ... @@ -944,6 +944,7 @@ 944 944 If the downlink payload=22000100, it means setting the TXP to 0. 945 945 946 946 * **Example 1**: Downlink Payload: **22000102** ~/~/ Set AT+TXP=2. 950 + 947 947 * **Example 2**: Downlink Payload: **22000000** ~/~/ Set AT+TXP=0. 948 948 949 949 (% style="display:none" %) (%%) ... ... @@ -1002,6 +1002,7 @@ 1002 1002 If the downlink payload=2301, it means set the application port to 1, while type code is 23. 1003 1003 1004 1004 * **Example 1**: Downlink Payload: **2301** ~/~/ set the application port to 1 1009 + 1005 1005 * **Example 2**: Downlink Payload:** 2305** ~/~/ set the application port to 5 1006 1006 1007 1007 (% style="display:none" %) (%%) ... ... @@ -1047,6 +1047,7 @@ 1047 1047 If the downlink payload=2401, it means set channel mode to 1, while type code is 24. 1048 1048 1049 1049 * **Example 1**: Downlink Payload: 2401 ~/~/ set channel mode to 1 1055 + 1050 1050 * **Example 2**: Downlink Payload: 2405 ~/~/ set channel mode to 5 1051 1051 1052 1052 (% style="display:none" %) (%%) ... ... @@ -1118,6 +1118,7 @@ 1118 1118 If the downlink payload=2501, it means set uplinkdwelltime to 1, while type code is 25. 1119 1119 1120 1120 * **Example 1**: Downlink Payload: **2501** ~/~/ set uplinkdwelltime to 1 1127 + 1121 1121 * **Example 2**: Downlink Payload: **2500** ~/~/ set uplinkdwelltime to 0 1122 1122 1123 1123 (% style="display:none" %) (%%) ... ... @@ -1131,15 +1131,21 @@ 1131 1131 (% style="color:blue" %)**RPL value:** 1132 1132 1133 1133 * **AT+RPL=0:** Device won't immediately reply any downlink commands from platform. 1141 + 1134 1134 * **AT+RPL=1:** Device will immediately reply message to Unconfirmed Data Down. Payload is 0x00. 1143 + 1135 1135 * **AT+RPL=2:** Device will immediately reply message to Confirmed Data Down. Payload is 0x00 and requied response header for this command. 1145 + 1136 1136 * **AT+RPL=3:** Device will immediately reply message to MAC Command. Payload is 0x00 and requied response header for this command. 1147 + 1137 1137 * **AT+RPL=4: **Device will immediately reply message to Confirmed Data Down & MAC Command. Payload is 0x00 and requied response header for these two commands. 1138 1138 1139 1139 (% style="color:blue" %)**Case Analyes:** 1140 1140 1141 1141 * For Class A devices, AT+RPL=0 is ok. that is defaut settings in software. 1153 + 1142 1142 * For Class C devices used in ChirpStack, need to set AT+RPL=4 because Chirpstack require immedietely reply message to MAC Command. 1155 + 1143 1143 * For Class C devices used in TTI, need to set AT+RPL=4 because TTI require immediately reply message to Confirmed Data Down & MAC Command. 1144 1144 1145 1145 (% style="color:blue" %)**AT Command: AT+RPL** ... ... @@ -1158,6 +1158,7 @@ 1158 1158 If the downlink payload=2101, it means set packet receiving response level to 1, while type code is 21. 1159 1159 1160 1160 * **Example 1**: Downlink Payload: **2101** ~/~/ set packet receiving response level to 1 1174 + 1161 1161 * **Example 2**: Downlink Payload: **2102** ~/~/ set packet receiving response level to 2 1162 1162 1163 1163 (% style="display:none" %) (%%) ... ... @@ -1189,6 +1189,7 @@ 1189 1189 If the downlink payload=330100, it means set end node to use confirm mode, while type code is 33. 1190 1190 1191 1191 * Example 1: Downlink Payload: 330100 ~/~/ Set AT+SETMAXNBTRANS=1,0 1206 + 1192 1192 * Example 2: Downlink Payload: 330201 ~/~/ Set AT+SETMAXNBTRANS=2,1 1193 1193 1194 1194 (% style="display:none" %) (%%) ... ... @@ -1240,6 +1240,8 @@ 1240 1240 If the downlink payload=320105A00B40, it means set end node to use confirm mode, while type code is 32. 1241 1241 1242 1242 * **Example 1:** Downlink Payload: 320105A00B40 ~/~/ Set AT+DDETECT=1,1440,2880 1258 + 1259 +* 1243 1243 ** 0x01 : Flag 1244 1244 ** 0x05A0: ACK_Timout_1 : 1440minutes (24 hours) 1245 1245 ** 0x0B40: ACK_Timout_2 : 2880minutes (48 hours) ... ... @@ -1287,6 +1287,7 @@ 1287 1287 If the downlink payload=26000A, it means set end node to use confirm mode, while type code is 26. 1288 1288 1289 1289 * **Example 1:** Downlink Payload: 26000A ~/~/ Set AT+RJTDC=10 1307 + 1290 1290 * **Example 2: **Downlink Payload: 260002 ~/~/ Set AT+RJTDC=2 1291 1291 1292 1292 (% style="display:none" %) (%%)