Skip to Content
Version 7.7 by Xiaoling on 2022/05/11 10:45
Show last authors
1 Contens
2
3 {{toc/}}
4
5
6 = 1. Introduction =
7
8 Dragino LoRaWAN End Node support two types of AT Commands and Downlink Commands:
9
10 * **Common Commands:** They should be available for each sensor, such as: change uplink interval, reset device.
11 * **Sensor Related Commands:** Only for special sensor, such as control relay, poll RS485 device.
12
13 **This page shows the common commands since Dragino LoRaWAN stack DR-LWS-005. Make sure the end node support stack higher than DR-LWS-005 before checking this page.**
14
15
16 = 2. How to use AT Commands or Downlink command =
17
18 * For AT Command , See Devices User Manual for Device. The user manual can be found in each product page of [[Dragino Official Website>>url:http://www.dragino.com/]]
19 * For LoRaWAN Downlink: The gateway transfer downlink command in HEX format. This page shows the HEX format downlink code for each command. but some servers use base64 as downlink code. Below are reference for how to use downlink command:
20 ** Use HEX format to send a downlink: [[TTN v3>>url:https://wiki.dragino.com/index.php/Notes_for_TTN#Send_Downlink_message]]
21 ** Use Base64 format to send a downlink: [[Chirpstack>>url:https://wiki.dragino.com/index.php/Notes_for_ChirpStack#Downlink]].
22 ** See use note for more serves [[Servers Note>>url:https://wiki.dragino.com/index.php/Main_Page#Use_Note_for_Server]]
23
24 = 3. Support End Node and firmware version =
25
26 (% style="background-color:#ffffcc; color:green; width:995.222px" %)
27 |=(% colspan="3" style="width: 992px;" %)Dragino STM32 base hardware Firmware / LoRaWAN stack list
28 |(% style="width:187px" %)**Model**|(% style="width:349px" %)**Description**|(% style="width:453px" %)**Firmware Version <~-~-> Stack Version**
29 |(% style="width:187px" %)[[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]],|(% style="width:349px" %)Open Source Generic LoRaWAN Sensor Node|(% style="width:453px" %)LSN50 v1.6.0 <~-~-> DR-LWS-003;(((
30 LSN50 v1.7.0 <~-~-> DR-LWS-005; ~-~-> Support since this version
31 )))
32 |(% style="width:187px" %)[[LGT92>>url:http://www.dragino.com/products/lora-lorawan-end-node/item/142-lgt-92.html]],|(% style="width:349px" %)LoRaWAN GPS Tracker|(% style="width:453px" %)LGT92 v1.6.3 <~-~-> DR-LWS-003;(((
33 LGT92 v1.6.4 <~-~-> DR-LWS-005;~-~-> Support since this version
34 )))
35 |(% style="width:187px" %)[[LBT1>>url:http://www.dragino.com/products/lora-lorawan-end-node/item/165-lbt1.html]],|(% style="width:349px" %)LoRaWAN BLE Indoor Tracker|(% style="width:453px" %)LBT1 v1.0 <~-~-> DR-LWS-005;
36 |(% style="width:187px" %)[[RS485-LN>>url:http://www.dragino.com/products/lora-lorawan-end-node/item/154-rs485-ln.html]],|(% style="width:349px" %)LoRaWAN RS485 Modbus Converter|(% style="width:453px" %)RS485-LN v1.3 <~-~-> DR-LWS-005;
37 |(% style="width:187px" %)[[LHT65>>url:http://www.dragino.com/products/lora-lorawan-end-node/item/151-lht65.html]],|(% style="width:349px" %)LoRaWAN Temperature & Humidity Sensor|(% style="width:453px" %)LHT65 v1.7 <~-~-> DR-LWS-003;(((
38 LHT65 v1.8.0 <~-~-> DR-LWS-005;~-~-> Support since this version
39 )))
40
41 = 4. System Management Commands =
42
43 == 4.1 Change Uplink Interval ==
44
45 Feature: Change LoRaWAN End Node Transmit Interval.
46
47 (% class="box infomessage" %)
48 (((
49 **AT Command: AT+TDC**
50 )))
51
52 (% style="background-color:#ffffcc; color:green; width:727.222px" %)
53 |=(% colspan="3" style="width: 724px;" %)AT+TDC
54 |(% style="width:165px" %)**Command Example**|(% style="width:227px" %)**Function**|(% style="width:329px" %)**Response**
55 |(% style="width:165px" %)AT+TDC=?|(% style="width:227px" %)Show current transmit Interval|(% style="width:329px" %)30000(((
56 OK
57
58 the interval is 30000ms = 30s
59 )))
60 |(% style="width:165px" %)AT+TDC=60000|(% style="width:227px" %)Set Transmit Interval|(% style="width:329px" %)OK(((
61 Set transmit interval to 60000ms = 60 seconds
62 )))
63
64 {{info}}
65 **Downlink Command: 0x01**
66 {{/info}}
67
68 Format: Command Code (0x01) followed by 3 bytes time value.
69
70 If the downlink payload=0100003C, it means set the END Node’s Transmit Interval to 0x00003C=60(S), while type code is 01.
71
72 * **Example 1**: Downlink Payload:** 0100001E** ~/~/ Set Transmit Interval (TDC) = 30 seconds
73 * **Example 2**: Downlink Payload:** 0100003C** ~/~/ Set Transmit Interval (TDC) = 60 seconds
74
75 == 4.2 Reboot End Node ==
76
77 Feature: Reboot End Node to perform a new OTAA or ABP Join.
78
79 {{info}}
80 **AT Command: ATZ**
81 {{/info}}
82
83 (% border="0" style="background-color:#ffffcc; color:green; width:727.222px" %)
84 |=(% colspan="3" %)ATZ: Trig a reset of the MCU
85 |**Command Example**|**Function**|**Response**
86 |ATZ|Reset MCU|(((
87 Device reset and show booting info
88
89 LSN50 Device/LoRa ST Module
90
91 Image Version: XX
92
93 Frequency Band: XX
94
95 DevEui= XX XX XX XX XX XX XX XX
96
97 <followed by the Tx and Rx information>
98 )))
99
100 {{info}}
101 **Downlink Command: 0x04**
102 {{/info}}
103
104 Format: Command Code (0x04) followed by FF.
105
106 If the downlink payload=**04FF**, the end node will reboot.
107
108 == 4.3 Reset to factory Default ==
109
110 Feature: Reset the parameters to Factory Default, factory default value depends on the firmware settings, the OTAA and ABP keys will reserve after this command.
111
112 {{info}}
113 **AT Command: AT+FDR**
114 {{/info}}
115
116 (% style="background-color:#ffffcc; color:green; width:831.222px" %)
117 |=(% colspan="3" style="width: 828px;" %)Reset to factory default
118 |(% style="width:181px" %)**Command Example**|(% style="width:181px" %)**Function**|(% style="width:465px" %)**Response**
119 |(% style="width:181px" %)AT+FDR|(% style="width:181px" %)Reset to factory default|(% style="width:465px" %)(((
120 Device reset to factory default parameters and show booting info
121
122 LSN50 Device/LoRa ST Module
123
124 Image Version: XX
125
126 Frequency Band: XX
127
128 DevEui= XX XX XX XX XX XX XX XX
129
130 Please set the parameters or reset Device to apply change
131 )))
132
133 {{info}}
134 **Downlink Command: 0x04**
135 {{/info}}
136
137 Format: Command Code (0x04) followed by FE.
138
139 If the downlink payload=**04FE**, Reset Parameters to Factory Default, Keys Reserve.
140
141
142 == 4.4 Show Firmware Version ==
143
144 Feature: Show firmware version. No downlink command yet.
145
146 {{info}}
147 **AT Command: AT+VER**
148 {{/info}}
149
150 (% style="background-color:#ffffcc; color:green" %)
151 |=(% colspan="3" %)AT+VER: Image Version and Frequency Band
152 |**Command Example**|**Function**|**Response**
153 |AT+VER=?|Show Image version and Frequency Band|(((
154 1.3 EU868
155
156 OK
157 )))
158
159 {{info}}
160 **Downlink Command: 0x26 (Valid in 006 stack)**
161 {{/info}}
162
163 Downlink Format: 0x26
164
165 Device will reply with firmware version info, device info. frequency band info. detail please check device user manual. Total 5 bytes Example: If device is of firmware version 1.1.0 Upload: xx ~-~- yy ~-~- zz ~-~- 110 total 5 bytes
166
167 **xx: Software Type:**
168
169 * 0x00 01: LGT92 Version
170 * 0x00 02: LBT1
171 * 0x00 03: LSE01/LDDS75/LDDS20/LSPH01/LLMS01/LSNPK01
172
173 **yy: Frequency Band:**
174
175 * 0x01: EU868
176 * 0x02: US915
177 * 0x03: IN865
178 * 0x04: AU915
179 * 0x05: KZ865
180 * 0x06: RU864
181 * 0x07: AS923
182 * 0x08: AS923-1
183 * 0x09: AS923-2
184 * 0xa0: AS923-3
185
186 **zz: Subband**
187
188 firmware version: v1.1.0 ~-~-> 110
189
190
191 == 4.5 Show System Configure ==
192
193 Feature: Show All configure. No downlink command yet.
194
195 {{info}}
196 **AT Command: AT+CFG**
197 {{/info}}
198
199 (% style="background-color:#ffffcc; color:green; width:599.222px" %)
200 |=(% colspan="3" style="width: 596px;" %)AT+CFG: Print all configurations
201 |(% style="width:160px" %)**Command Example**|(% style="width:154px" %)**Function**|(% style="width:280px" %)**Response**
202 |(% style="width:160px" %)AT+CFG|(% style="width:154px" %)Show all configures|(% style="width:280px" %)(((
203 AT+DEUI = XX XX XX XX XX XX XX XX
204
205 AT+DADDR=XXXXXXXX
206
207 ……….
208
209 AT+RX2WTO=X
210
211 AT+CHS=868100000
212
213 OK
214 )))
215
216
217 = 5. Keys, IDs and EUIs management =
218
219 == 5.1 Application EUI ==
220
221 Feature: Get or Set the Application EUI.
222
223 {{info}}
224 **AT Command: AT+APPEUI**
225 {{/info}}
226
227 (% style="background-color:#ffffcc; color:green; width:686.222px" %)
228 |=(% colspan="3" style="width: 683px;" %)AT+APPEUI
229 |(% style="width:305px" %)**Command Example**|(% style="width:186px" %)**Function**|(% style="width:191px" %)**Response**
230 |(% style="width:305px" %)AT+APPEUI=?|(% style="width:186px" %)Get the Application EUI|(% style="width:191px" %)00 b3 d5 00 00 00 00 00(((
231 OK
232 )))
233 |(% style="width:305px" %)AT+APPEUI=00 b3 d5 7e f0 00 4d 34|(% style="width:186px" %)Set the Application EUI|(% style="width:191px" %)OK
234
235 == 5.2 Application Key ==
236
237 Feature: Get or Set the Application Key.
238
239 {{info}}
240 **AT Command: AT+APPKEY**
241 {{/info}}
242
243 (% style="background-color:#ffffcc; color:green; width:976.222px" %)
244 |=(% colspan="3" style="width: 973px;" %)AT+APPKEY
245 |(% style="width:441px" %)**Command Example**|(% style="width:180px" %)**Function**|(% style="width:350px" %)**Response**
246 |(% 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(((
247 OK
248 )))
249 |(% style="width:441px" %)AT+APPKEY=00 35 55 55 22 23 55 53 43 24 23 42 34 35 35 35|(% style="width:180px" %)Set the Application Key|(% style="width:350px" %)OK
250
251 == 5.3 Application Session Key ==
252
253 Feature: Get or Set the Application Session Key.
254
255 {{info}}
256 **AT Command: AT+APPSKEY**
257 {{/info}}
258
259 (% style="background-color:#ffffcc; color:green; width:1040.22px" %)
260 |=(% colspan="3" style="width: 1037px;" %)AT+APPSKEY
261 |(% style="width:451px" %)**Command Example**|(% style="width:231px" %)**Function**|(% style="width:354px" %)**Response**
262 |(% 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(((
263 OK
264 )))
265 |(% style="width:451px" %)AT+APPSKEY=00 7d dc 73 33 d3 eb 9e 14 38 d5 a4 3e 62 5b e2|(% style="width:231px" %)Set the Application Session Key|(% style="width:354px" %)(While Error in format, return AT_PARAM_ERROR)(((
266 OK
267 )))
268
269 == 5.4 Device Address ==
270
271 Feature: Get or Set the Device Address.
272
273 {{info}}
274 **AT Command: AT+DADDR**
275 {{/info}}
276
277 (% style="background-color:#ffffcc; color:green; width:795.222px" %)
278 |=(% colspan="3" style="width: 792px;" %)AT+DADDR
279 |(% style="width:192px" %)**Command Example**|(% style="width:241px" %)**Function**|(% style="width:359px" %)**Response**
280 |(% style="width:192px" %)AT+DADDR=?|(% style="width:241px" %)Get the Application Session Key.|(% style="width:359px" %)(While Error in format, return AT_PARAM_ERROR)(((
281 A8 40 41 FF
282
283 OK
284 )))
285 |(% style="width:192px" %)AT+DADDR=A8 40 41 FF|(% style="width:241px" %)Set the Application Session Key.|(% style="width:359px" %)OK
286
287 == 5.5 Device EUI ==
288
289 Feature: Get or Set the Device EUI.
290
291 {{info}}
292 **AT Command: AT+DEUI**
293 {{/info}}
294
295 (% style="background-color:#ffffcc; color:green; width:1035.22px" %)
296 |=(% colspan="3" style="width: 1032px;" %)AT+DEUI
297 |(% style="width:250px" %)**Command Example**|(% style="width:147px" %)**Function**|(% style="width:634px" %)**Response**
298 |(% style="width:250px" %)AT+DEUI=?|(% style="width:147px" %)Get the Device EUI.|(% style="width:634px" %)00 44 34 22 33 45 55 55(((
299 OK
300 )))
301 |(% style="width:250px" %)AT+DEUI=A8 40 41 FF FF 12 34 56|(% style="width:147px" %)Set the Device EUI.|(% style="width:634px" %)(System will write new value to Device EUI,While Error in format, return AT_PARAM_ERROR)(((
302 OK
303 )))
304
305 == 5.6 Network ID ==
306
307 Feature: Get or Set the Network ID.(You can enter this command change only after successful network connection)
308
309 {{info}}
310 **AT Command: AT+NWKID**
311 {{/info}}
312
313 (% style="background-color:#ffffcc; color:green; width:448.222px" %)
314 |=(% colspan="3" style="width: 445px;" %)AT+NWKID
315 |(% style="width:191px" %)**Command Example**|(% style="width:153px" %)**Function**|(% style="width:101px" %)**Response**
316 |(% style="width:191px" %)AT+NWKID=?|(% style="width:153px" %)Get the Network ID.|(% style="width:101px" %)a8 40 41 ff(((
317 OK
318 )))
319 |(% style="width:191px" %)AT+NWKID=A8 40 41 FF|(% style="width:153px" %)Set the Network ID.|(% style="width:101px" %)OK
320
321 == 5.7 Network Session Key ==
322
323 Feature: Get or Set the Network Session Key
324
325 {{info}}
326 **AT Command: AT+NWKSKEY**
327 {{/info}}
328
329 (% style="background-color:#ffffcc; color:green; width:1017.22px" %)
330 |=(% colspan="3" style="width: 1014px;" %)AT+NWKSKEY
331 |(% style="width:455px" %)**Command Example**|(% style="width:215px" %)**Function**|(% style="width:343px" %)**Response**
332 |(% 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(((
333 OK
334 )))
335 |(% style="width:455px" %)AT+NWKSKEY=A8 40 41 FF FF 12 34 56 00 01 02 04 05 06 06 07|(% style="width:215px" %)Set the Network Session Key.|(% style="width:343px" %)OK
336
337 = 6. Joining and sending date on LoRaWAN network =
338
339 == 6.1 Confirm Mode ==
340
341 Feature: Get or Set the confirmation mode (0-1).
342
343 {{info}}
344 **AT Command: AT+CFM**
345 {{/info}}
346
347 (% style="background-color:#ffffcc; color:green; width:710.222px" %)
348 |=(% colspan="3" style="width: 707px;" %)AT+CFM
349 |(% style="width:155px" %)**Command Example**|(% style="width:205px" %)**Function**|(% style="width:346px" %)**Response**
350 |(% style="width:155px" %)AT+CFM=?|(% style="width:205px" %)Get the confirmation mode|(% style="width:346px" %)0(((
351 OK
352 )))
353 |(% style="width:155px" %)AT+CFM=1|(% style="width:205px" %)Set the confirmation mode|(% style="width:346px" %)OK
354 |(% style="width:155px" %)AT+CFM=2|(% style="width:205px" %)Set the confirmation mode|(% style="width:346px" %)While Error in format, return AT_PARAM_ERROR
355
356 Downlink Command: 0x05
357
358 Format: Command Code (0x05) followed by 2 bytes mode value.
359
360 If the downlink payload=0501, it means set end node to use confirm mode, while type code is 05.
361
362 * Example 1: Downlink Payload: 0501 ~/~/ Set AT+CFM=1
363 * Example 2: Downlink Payload: 0500 ~/~/ Set AT+CFM=0
364
365 == 6.2 Confirm Status ==
366
367 Feature: Get confirmation status of the last AT+SEND (0-1).
368
369 {{info}}
370 **AT Command: AT+CFS**
371 {{/info}}
372
373 (% style="background-color:#ffffcc; color:green; width:534.222px" %)
374 |=(% colspan="3" style="width: 531px;" %)AT+CFS
375 |(% style="width:156px" %)**Command Example**|(% style="width:193px" %)**Function**|(% style="width:178px" %)**Response**
376 |(% style="width:156px" %)AT+CFS=?|(% style="width:193px" %)Get confirmation status|(% style="width:178px" %)0(((
377 OK
378 )))
379
380 == 6.3 Join LoRa® Network ==
381
382 Feature: Join network.
383
384 {{info}}
385 **AT Command: AT+JOIN**
386 {{/info}}
387
388 (% style="background-color:#ffffcc; color:green; width:647.222px" %)
389 |=(% colspan="3" style="width: 644px;" %)AT+JOIN
390 |(% style="width:163px" %)**Command Example**|(% style="width:147px" %)**Function**|(% style="width:334px" %)**Response**
391 |(% style="width:163px" %)AT+JOIN ?|(% style="width:147px" %)Get imformation.|(% style="width:334px" %)AT+JOIN: Join network(((
392 OK
393
394 While Error in format, return AT_BUSY_ERROR
395 )))
396
397 == 6.4 LoRa® Network Join Mode ==
398
399 Feature: Get or Set the Network Join Mode. (0: ABP, 1: OTAA).
400
401 {{info}}
402 **AT Command: AT+NJM**
403 {{/info}}
404
405 (% style="background-color:#ffffcc; color:green; width:753.222px" %)
406 |=(% colspan="3" style="width: 750px;" %)AT+NJM
407 |(% style="width:162px" %)**Command Example**|(% style="width:227px" %)**Function**|(% style="width:361px" %)**Response**
408 |(% style="width:162px" %)AT+NJM=?|(% style="width:227px" %)Get the Network Join Mode|(% style="width:361px" %)1(((
409 OK
410 )))
411 |(% style="width:162px" %)AT+NJM=0|(% style="width:227px" %)Set the Network Join Mode|(% style="width:361px" %)OK
412 |(% style="width:162px" %)AT+NJM=2|(% style="width:227px" %)Set the Network Join Mode|(% style="width:361px" %)While Error in format, return AT_PARAM_ERROR
413
414 Downlink Command: 0x20
415
416 Format: Command Code (0x20) followed by 1 bytes mode value.
417
418 If the downlink payload=2000, it means set the Network Join Mode, while type code is 20.
419
420 * Example 1: Downlink Payload: 2000 ~/~/ Set AT+NJM=O
421 * Example 2: Downlink Payload: 2001 ~/~/ Set AT+NJM=1
422
423 == 6.5 LoRa® Network Join Status ==
424
425 Feature: LoRa® Network Join Status.
426
427 AT Command: AT+NJS
428
429 |=(% colspan="3" %)AT+NJS
430 |**Command Example**|**Function**|**Response**
431 |AT+NJS=?|Get the join status.|0(((
432 OK
433 )))
434
435 == 6.6 Print Last Received Data in Raw Format ==
436
437 Feature: Print Last Received Data in Raw Format<port:data>.
438
439 AT Command: AT+RECV
440
441 |=(% colspan="3" %)AT+RECV
442 |**Command Example**|**Function**|**Response**
443 |AT+RECV=?|print last received data in raw format.|0:(((
444 OK
445 )))
446
447 == 6.7 Print Last Received Data in Binary Format ==
448
449 Feature: Print Last Received Data in Binary Format<port:data>.
450
451 AT Command: AT+RECVB
452
453 |=(% colspan="3" %)AT+RECVB
454 |**Command Example**|**Function**|**Response**
455 |AT+RECVB=?|print last received data in binary format (with hexadecimal values).|2: 0010(((
456 OK
457 )))
458
459 == 6.8 Send Text Data ==
460
461 Feature: Send Text Data<port:data>.
462
463 AT Command: AT+SEND
464
465 |=(% colspan="3" %)AT+SEND
466 |**Command Example**|**Function**|**Response**
467 |AT+SEND=12:hello world|Send text data along with the application port.|OK(((
468 While Error in format, return
469
470 AT_BUSY_ERROR/AT_BUSY_ERROR/AT_NO_NETWORK_JOINED
471
472
473 )))
474
475 == 6.9 Send Hexadecimal Data ==
476
477 Feature: Send hexadecimal data along with the application port.
478
479 AT Command: AT+SENDB
480
481 |=(% colspan="3" %)AT+SENDB
482 |**Command Example**|**Function**|**Response**
483 |AT+SENDB=12:abcdef0123456789|Send hexadecimal data along with the application port.|OK
484 |AT+SENDB=abcdef0123456789|Send hexadecimal data along with the application port.|While Error in format, return(((
485 AT_PARAM_ERROR AT_BUSY_ERROR/AT_NO_NETWORK_JOINED
486
487
488 )))
489
490 = 7. LoRaWAN network management =
491
492 == 7.1 Adaptive Data Rate ==
493
494 Feature: Get or Set the Adaptive Data Rate setting. (0: off, 1: on).
495
496
497 AT Command: AT+ADR
498
499 |=(% colspan="3" %)AT+ADR
500 |**Command Example**|**Function**|**Response**
501 |AT+ADR=?|Get the Adaptive Data Rate setting.|1(((
502 OK
503 )))
504 |AT+ADR=0|Set the Adaptive Data Rate setting.|OK
505 |AT+ADR=2|Set the Adaptive Data Rate setting.|While Error in format, return(((
506 AT_PARAM_ERROR
507 )))
508
509 Downlink Command: 0x22
510
511
512 If the downlink payload=2201, it means setting the adaptive data rate to 1, while type code is 22.
513
514 * Example 1: Downlink Payload: 2201 ~/~/ Set AT+ADR=1.
515 * Example 2: Downlink Payload: 2200FFFF ~/~/ Set AT+ADR=0.
516
517 == 7.2 LoRa® Class ==
518
519 Feature: Get or Set the Device Class(Currently only support class A, class C).
520
521 AT Command:AT+CLASS
522
523 |=(% colspan="3" %)AT+CLASS
524 |**Command Example**|**Function**|**Response**
525 |AT+CLASS=?|Get the Device Class.|A(((
526 OK
527 )))
528 |AT+CLASS=C|Set the Device Class.|OK(((
529
530 )))
531
532 == 7.3 Duty Cycle Setting ==
533
534 Feature: Get or Set the ETSI Duty Cycle setting - 0=disable, 1=enable - Only for testing.
535
536 AT Command:AT+DCS
537
538 |=(% colspan="3" %)AT+DCS
539 |**Command Example**|**Function**|**Response**
540 |AT+DCS=?|Get the ETSI Duty Cycle setting.|1(((
541 OK
542 )))
543 |AT+DCS=1|Set the ETSI Duty Cycle setting.|OK(((
544
545 )))
546
547 == 7.4 Data Rate ==
548
549 Feature: Get or Set the Data Rate. (0-7 corresponding to DR_X) . Note: while set Data Rate, please use set Adptive Data Rate, ADR=0 first. otherwise device will response to server's ADR command and change the DR to the setting from server
550
551 AT Command: AT+DR
552
553 |=(% colspan="3" %)AT+DR
554 |**Command Example**|**Function**|**Response**
555 |AT+DR=?|Get the Data Rate.|5(((
556 OK
557 )))
558 |AT+DR=2|Set the Data Rate.|OK(((
559
560 )))
561
562 Downlink Command: 0x2200aaFF
563
564
565 If the downlink payload=220001FF, it means setting the data rate to 1, while type code is 22 00 aa FF.
566
567 * Example 1: Downlink Payload: 220001FF ~/~/ Set AT+DR=1.
568 * Example 2: Downlink Payload: 220000FF ~/~/ Set AT+DR=0.
569
570 == 7.5 Frame Counter Downlink ==
571
572 Feature: Get or Set the Frame Counter Downlink.
573
574 AT Command:AT+FCD
575
576 |=(% colspan="3" %)AT+FCD
577 |**Command Example**|**Function**|**Response**
578 |AT+FCD=?|Get the Frame Counter Downlink.|0(((
579 OK
580 )))
581 |AT+FCD=10|Set the Frame Counter Downlink.|(System will write new value to FCD)(((
582 OK
583
584
585 )))
586
587 == 7.6 Frame Counter Uplink ==
588
589 Feature: Get or Set the Frame Counter Uplink.
590
591 AT Command:AT+FCU
592
593 |=(% colspan="3" %)AT+FCU
594 |**Command Example**|**Function**|**Response**
595 |AT+FCU=?|Get the Frame Counter Uplink.|0(((
596 OK
597 )))
598 |AT+FCU=10|Set the Frame Counter Uplink.|OK(((
599
600 )))
601
602 == 7.7 Join Accept Delay1 ==
603
604 Feature: Get or Set the Join Accept Delay between the end of the Tx and the Join Rx Window 1 in ms.
605
606 AT Command:AT+JN1DL
607
608 |=(% colspan="3" %)AT+JN1DL
609 |**Command Example**|**Function**|**Response**
610 |AT+JN1DL=?|Get the Join Accept Delay.|5000(((
611 OK
612 )))
613 |AT+JN1DL=10000|Set the Join Accept Delay.|OK(((
614
615 )))
616
617 == 7.8 Join Accept Delay2 ==
618
619 Feature: Get or Set the Join Accept Delay between the end of the Tx and the Join Rx Window 2 in ms.
620
621 AT Command:AT+JN2DL
622
623 |=(% colspan="3" %)AT+JN2DL
624 |**Command Example**|**Function**|**Response**
625 |AT+JN2DL=?|Get the Join Accept Delay.|6000(((
626 OK
627 )))
628 |AT+JN2DL=20000|Set the Join Accept Delay.|OK(((
629
630 )))
631
632 == 7.9 Public Network Mode ==
633
634 Feature: Get or Set the public network mode. (0: off, 1: on)
635
636 AT Command:AT+PNM
637
638 |=(% colspan="3" %)AT+PNM
639 |**Command Example**|**Function**|**Response**
640 |AT+PNM=?|Get the public network mode.|1(((
641 OK
642 )))
643 |AT+PNM=1|Set the public network mode.|(System will write new value to PNM)(((
644 OK
645
646
647 )))
648
649 == 7.10 Receive Delay1 ==
650
651 Feature: Get or Set the delay between the end of the Tx and the Rx Window 1 in ms
652
653 AT Command:AT+RX1DL
654
655 |=(% colspan="3" %)AT+RX1DL
656 |**Command Example**|**Function**|**Response**
657 |AT+RX1DL=?|Get the delay.|1000(((
658 OK
659 )))
660 |AT+RX1DL=1500|Set the delay.|OK(((
661
662 )))
663
664 == 7.11Receive Delay2 ==
665
666 Feature: Get or Set the delay between the end of the Tx and the Rx Window 2 in ms
667
668 AT Command:AT+RX2DL
669
670 |=(% colspan="3" %)AT+RX2DL
671 |**Command Example**|**Function**|**Response**
672 |AT+RX2DL=?|Get the delay.|2000(((
673 OK
674 )))
675 |AT+RX2DL=2500|Set the delay.|OK(((
676
677 )))
678
679 == 7.12 Rx2 Window Data Rate ==
680
681 Feature: Get or Set the Rx2 window data rate (0-7 corresponding to DR_X)
682
683 AT Command:AT+RX2DR
684
685 |=(% colspan="3" %)AT+RX2DR
686 |**Command Example**|**Function**|**Response**
687 |AT+RX2DR=?|Get the Rx2 window data rate.|2(((
688 OK
689 )))
690 |AT+RX2DR=6|Set the Rx2 window data rate.|OK(((
691
692 )))
693
694 == 7.13 Rx2 Window Frequency ==
695
696 Feature: Get or Set the Rx2 window frequency
697
698 AT Command:AT+RX2FQ
699
700 |=(% colspan="3" %)AT+RX2FQ
701 |**Command Example**|**Function**|**Response**
702 |AT+RX2FQ=?|Get the Rx2 window frequency.|434665000(((
703 OK
704 )))
705 |AT+RX2FQ=434665000|Set the Rx2 window frequency.|OK(((
706
707 )))
708
709 == 7.14 Transmit Power ==
710
711 Feature: Get or Set the Transmit Power(0-5, MAX:0, MIN:5, according to LoRaWAN Spec, or 40=10dB, 41 = 11dB, …, 50 = 20dB which is out of LoRaWAN spec. )
712
713 AT Command:AT+TXP
714
715 |=(% colspan="3" %)AT+TXP
716 |**Command Example**|**Function**|**Response**
717 |AT+TXP=?|Get the Transmit Power.|0(((
718 OK
719 )))
720 |AT+TXP=1|Set the Transmit Power.|OK(((
721
722 )))
723
724 Downlink Payload. The 4th byte of 0x22 downlink.
725
726 If the downlink payload=22000100, it means setting the TXP to 0.
727
728 * Example 1: Downlink Payload: 22000102 ~/~/ Set AT+TXP=2.
729 * Example 2: Downlink Payload: 220000FF ~/~/ Set AT+TXP=0.
730
731 == 7.15 RSSI of the Last Received Packet ==
732
733 Feature: Get or Set the Rx2 window frequency
734
735 AT Command:AT+RSSI
736
737 |=(% colspan="3" %)AT+RSSI
738 |**Command Example**|**Function**|**Response**
739 |AT+RSSI=?|Get the RSSI of the last received packet.|0(((
740 OK
741 )))
742
743 == 7.16 SNR of the Last Received Packet ==
744
745 Feature: Get the SNR of the last received packet
746
747 AT Command:AT+SNR
748
749 |=(% colspan="3" %)AT+SNR
750 |**Command Example**|**Function**|**Response**
751 |AT+SNR=?|Get the RSSI of the last received packet.|0(((
752 OK
753 )))
754
755 == 7.17 Application Port ==
756
757 Feature: Get or set the application port.
758
759 AT Command: AT+PORT
760
761 |=(% colspan="3" %)AT+PORT
762 |**Command Example**|**Function**|**Response**
763 |AT+PORT=?|Get the application port|21(((
764 OK
765 )))
766 |AT+PORT=21|Set the application port|OK
767
768 Downlink Command: 0x23
769
770 Format: Command Code (0x23) followed by 1 bytes port value.
771
772 If the downlink payload=2301, it means set the application port to 1, while type code is 23.
773
774 * Example 1: Downlink Payload: 2301 ~/~/ set the application port to 1
775 * Example 2: Downlink Payload: 2305 ~/~/ set the application port to 5
776
777 == 7.18 Single Channel Mode ==
778
779 Feature:Get or Set Frequency (Unit: Hz) for Single Channel Mode.
780
781 AT Command: AT+CHS
782
783 |=(% colspan="3" %)AT+CHS
784 |**Command Example**|**Function**|**Response**
785 |AT+CHS=?|Get Frequency for Single Channel Mode|0(((
786 OK
787 )))
788 |AT+CHS=868100000|Set Frequency for Single Channel Mode|OK
789
790 == 7.19 Eight Channel Mode ==
791
792 Feature: Get or Set eight channels mode,Only for US915,AU915,CN470.
793
794 AT Command: AT+CHE
795
796 |=(% colspan="3" %)AT+CHE
797 |**Command Example**|**Function**|**Response**
798 |AT+CHE=?|Get eight channels mode|1(((
799 902.3 902.5 902.7 902.9 903.1 903.3 903.5 903.7
800
801 OK
802 )))
803 |AT+CHE=1|Set eight channels mode|OK
804
805 Downlink Command: 0x24
806
807 Format: Command Code (0x24) followed by 1 bytes channel value.
808
809 If the downlink payload=2401, it means set channel mode to 1, while type code is 24.
810
811 * Example 1: Downlink Payload: 2401 ~/~/ set channel mode to 1
812 * Example 2: Downlink Payload: 2405 ~/~/ set channel mode to 5
813
814 == 7.20 Get or Set RXwindows1 timeout ==
815
816 Feature:Get or Set the number of symbols to detect and timeout from RXwindow1(0 to 255).
817
818 AT Command: AT+RX1WTO
819
820 |=(% colspan="3" %)AT+ RX1WTO
821 |**Command Example**|**Function**|**Response**
822 |AT+RX1WTO=?|Get RXwindows1 timeout|14(((
823 OK
824 )))
825 |AT+RX1WTO=60|Set RXwindows1 timeout|OK
826
827 AT+RX1TWO is theRxSingle timeout value of receive window 1. If it is not set, then the queriedvalue is the default value. If it is set, then the queried value is the setvalue. AT+RX2TWO is thesame as above. The definitionof RxSingle timeout is as described in the following paragraph.
828
829 [[~[~[image:https://wiki.dragino.com/images/thumb/5/51/RX1WTO.JPG/600px-RX1WTO.JPG~|~|alt="RX1WTO.JPG" height="239" width="600"~]~]>>url:https://wiki.dragino.com/index.php/File:RX1WTO.JPG]]
830
831 Increasing thisvalue is equal to extending the time that the receiving window is opened, butthe corresponding power consumption will also increase. Properly increasingthis value can increase the success rate of the downlink.
832
833 == 7.21 Get or Set RXwindows2 timeout ==
834
835 Feature:Get or Set the number of symbols to detect and timeout from RXwindow2(0 to 255).
836
837 AT Command: AT+RX2WTO
838
839 |=(% colspan="3" %)AT+ RX2WTO
840 |**Command Example**|**Function**|**Response**
841 |AT+RX2WTO=?|Get RXwindows2 timeout|7(((
842 OK
843 )))
844 |AT+RX2WTO=20|Set RXwindows2 timeout|OK
845
846 == 7.22 Setting up uplinkdwelltime (as923, au915) ==
847
848 Feature: Get or Set uplinkdwelltime
849
850 AT Command: AT+DWELLT
851
852 |=(% colspan="3" %)AT+DWELLT
853 |**Command Example**|**Function**|**Response**
854 |AT+DWELLT=?|Get uplinkdwelltime|1(((
855 OK
856 )))
857 |AT+DWELLT=0|Set uplinkdwelltime|OK
858
859 Downlink Command: 0x25
860
861 Format: Command Code (0x25) followed by 1 bytes state value.
862
863 If the downlink payload=2501, it means set uplinkdwelltime to 1, while type code is 25.
864
865 * Example 1: Downlink Payload: 2501 ~/~/ set uplinkdwelltime to 1
866 * Example 2: Downlink Payload: 2500 ~/~/ set uplinkdwelltime to 0
867
868 == 7.23 Set Packet Receiving Response Level ==
869
870 Feature: Get or Set packet receiving response level. This feature is used to set compatible with different LoRaWAN servers. If RPL doesn;t match , user will see strange message in the server portal.
871
872 RPL value:
873
874 * AT+RPL=0: Device won't immediately reply any downlink commands from platform.
875 * AT+RPL=1: Device will immediately reply message to Unconfirmed Data Down. Payload is 0x00.
876 * AT+RPL=2: Device will immediately reply message to Confirmed Data Down. Payload is 0x00 and requied response header for this command.
877 * AT+RPL=3: Device will immediately reply message to MAC Command. Payload is 0x00 and requied response header for this command.
878 * 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.
879
880 Case Analyes:
881
882 * For Class A devices, AT+RPL=0 is ok. that is defaut settings in software.
883 * For Class C devices used in ChirpStack, need to set AT+RPL=4 because Chirpstack require immedietely reply message to MAC Command.
884 * 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.
885
886 AT Command: AT+RPL
887
888 |=(% colspan="3" %)AT+RPL
889 |**Command Example**|**Function**|**Response**
890 |AT+RPL=?|Get packet receiving response level|1(((
891 OK
892 )))
893 |AT+RPL=0|Set packet receiving response level|OK
894
895 Downlink Command: 0x21
896
897 Format: Command Code (0x21) followed by 1 bytes level value.
898
899 If the downlink payload=2101, it means set packet receiving response level to 1, while type code is 21.
900
901 * Example 1: Downlink Payload: 2101 ~/~/ set packet receiving response level to 1
902 * Example 2: Downlink Payload: 2102 ~/~/ set packet receiving response level to 2
903
904 = 8. AT Commands Combination =
905
906 == 8.1 Set a fix RX2DR for downlink window ==
907
908 * AT+ADR=0 ~-~-> Disable ADR first
909 * AT+RX2DR=xxxx ~-~-> Set xxxx to your wanted DataRate
910
911 == 8.2 Use Downlink Command to set a fix uplink DR ==
912
913 Downlink Command: 0x22000500
914
915 Same as:
916
917 * AT+ADR=0 [[Reference>>url:https://wiki.dragino.com/index.php/End_Device_Downlink_Command#Adaptive_Data_Rate]]
918 * AT+DR=5 [[Reference>>url:https://wiki.dragino.com/index.php/End_Device_Downlink_Command#Data_Rate]]
919 * AT+TXP=0 [[Reference>>url:https://wiki.dragino.com/index.php/End_Device_Downlink_Command#Transmit_Power]]