Version 7.5 by Xiaoling on 2022/05/11 10:13

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 AT Command: AT+APPSKEY
256
257 |=(% colspan="3" %)AT+APPSKEY
258 |**Command Example**|**Function**|**Response**
259 |AT+APPSKEY=?|Get the Application Session Key|00 7d dc 73 33 d3 eb 9e 14 38 d5 a4 3e 62 5b e2(((
260 OK
261 )))
262 |AT+APPSKEY=00 7d dc 73 33 d3 eb 9e 14 38 d5 a4 3e 62 5b e2|Set the Application Session Key.|(While Error in format, return AT_PARAM_ERROR)(((
263 OK
264 )))
265
266 == 5.4 Device Address ==
267
268 Feature: Get or Set the Device Address.
269
270 AT Command: AT+DADDR
271
272 |=(% colspan="3" %)AT+DADDR
273 |**Command Example**|**Function**|**Response**
274 |AT+DADDR=?|Get the Application Session Key.|(While Error in format, return AT_PARAM_ERROR)(((
275 A8 40 41 FF
276
277 OK
278 )))
279 |AT+DADDR=A8 40 41 FF|Set the Application Session Key.|OK
280
281 == 5.5 Device EUI ==
282
283 Feature: Get or Set the Device EUI.
284
285 AT Command: AT+DEUI
286
287 |=(% colspan="3" %)AT+DEUI
288 |**Command Example**|**Function**|**Response**
289 |AT+DEUI=?|Get the Device EUI.|00 44 34 22 33 45 55 55(((
290 OK
291 )))
292 |AT+DEUI=A8 40 41 FF FF 12 34 56|Set the Device EUI.|(System will write new value to Device EUI,While Error in format, return AT_PARAM_ERROR)(((
293 OK
294 )))
295
296 == 5.6 Network ID ==
297
298 Feature: Get or Set the Network ID.(You can enter this command change only after successful network connection)
299
300 AT Command: AT+NWKID
301
302 |=(% colspan="3" %)AT+NWKID
303 |**Command Example**|**Function**|**Response**
304 |AT+NWKID=?|Get the Network ID.|a8 40 41 ff(((
305 OK
306 )))
307 |AT+NWKID=A8 40 41 FF|Set the Network ID.|OK
308
309 == 5.7 Network Session Key ==
310
311 Feature: Get or Set the Network Session Key
312
313 AT Command: AT+NWKSKEY
314
315 |=(% colspan="3" %)AT+NWKSKEY
316 |**Command Example**|**Function**|**Response**
317 |AT+NWKSKEY=?|Get the Network Session Key.|00 4f 19 25 52 ce 97 09 d7 fa 84 71 db 51 02 92(((
318 OK
319 )))
320 |AT+NWKSKEY=A8 40 41 FF FF 12 34 56 00 01 02 04 05 06 06 07|Set the Network Session Key.|OK
321
322 = 6. Joining and sending date on LoRaWAN network =
323
324 == 6.1 Confirm Mode ==
325
326 Feature: Get or Set the confirmation mode (0-1).
327
328 AT Command: AT+CFM
329
330 |=(% colspan="3" %)AT+CFM
331 |**Command Example**|**Function**|**Response**
332 |AT+CFM=?|Get the confirmation mode|0(((
333 OK
334 )))
335 |AT+CFM=1|Set the confirmation mode|OK
336 |AT+CFM=2|Set the confirmation mode|While Error in format, return AT_PARAM_ERROR
337
338 Downlink Command: 0x05
339
340 Format: Command Code (0x05) followed by 2 bytes mode value.
341
342 If the downlink payload=0501, it means set end node to use confirm mode, while type code is 05.
343
344 * Example 1: Downlink Payload: 0501 ~/~/ Set AT+CFM=1
345 * Example 2: Downlink Payload: 0500 ~/~/ Set AT+CFM=0
346
347 == 6.2 Confirm Status ==
348
349 Feature: Get confirmation status of the last AT+SEND (0-1).
350
351 AT Command: AT+CFS
352
353 |=(% colspan="3" %)AT+CFS
354 |**Command Example**|**Function**|**Response**
355 |AT+CFS=?|Get confirmation status|0(((
356 OK
357 )))
358
359 == 6.3 Join LoRa® Network ==
360
361 Feature: Join network.
362
363 AT Command: AT+JOIN
364
365 |=(% colspan="3" %)AT+JOIN
366 |**Command Example**|**Function**|**Response**
367 |AT+JOIN ?|Get imformation.|AT+JOIN: Join network(((
368 OK
369
370 While Error in format, return AT_BUSY_ERROR
371 )))
372
373 == 6.4 LoRa® Network Join Mode ==
374
375 Feature: Get or Set the Network Join Mode. (0: ABP, 1: OTAA).
376
377 AT Command: AT+NJM
378
379 |=(% colspan="3" %)AT+NJM
380 |**Command Example**|**Function**|**Response**
381 |AT+NJM=?|Get the Network Join Mode|1(((
382 OK
383 )))
384 |AT+NJM=0|Set the Network Join Mode|OK
385 |AT+NJM=2|Set the Network Join Mode|While Error in format, return AT_PARAM_ERROR
386
387 Downlink Command: 0x20
388
389 Format: Command Code (0x20) followed by 1 bytes mode value.
390
391 If the downlink payload=2000, it means set the Network Join Mode, while type code is 20.
392
393 * Example 1: Downlink Payload: 2000 ~/~/ Set AT+NJM=O
394 * Example 2: Downlink Payload: 2001 ~/~/ Set AT+NJM=1
395
396 == 6.5 LoRa® Network Join Status ==
397
398 Feature: LoRa® Network Join Status.
399
400 AT Command: AT+NJS
401
402 |=(% colspan="3" %)AT+NJS
403 |**Command Example**|**Function**|**Response**
404 |AT+NJS=?|Get the join status.|0(((
405 OK
406 )))
407
408 == 6.6 Print Last Received Data in Raw Format ==
409
410 Feature: Print Last Received Data in Raw Format<port:data>.
411
412 AT Command: AT+RECV
413
414 |=(% colspan="3" %)AT+RECV
415 |**Command Example**|**Function**|**Response**
416 |AT+RECV=?|print last received data in raw format.|0:(((
417 OK
418 )))
419
420 == 6.7 Print Last Received Data in Binary Format ==
421
422 Feature: Print Last Received Data in Binary Format<port:data>.
423
424 AT Command: AT+RECVB
425
426 |=(% colspan="3" %)AT+RECVB
427 |**Command Example**|**Function**|**Response**
428 |AT+RECVB=?|print last received data in binary format (with hexadecimal values).|2: 0010(((
429 OK
430 )))
431
432 == 6.8 Send Text Data ==
433
434 Feature: Send Text Data<port:data>.
435
436 AT Command: AT+SEND
437
438 |=(% colspan="3" %)AT+SEND
439 |**Command Example**|**Function**|**Response**
440 |AT+SEND=12:hello world|Send text data along with the application port.|OK(((
441 While Error in format, return
442
443 AT_BUSY_ERROR/AT_BUSY_ERROR/AT_NO_NETWORK_JOINED
444
445
446 )))
447
448 == 6.9 Send Hexadecimal Data ==
449
450 Feature: Send hexadecimal data along with the application port.
451
452 AT Command: AT+SENDB
453
454 |=(% colspan="3" %)AT+SENDB
455 |**Command Example**|**Function**|**Response**
456 |AT+SENDB=12:abcdef0123456789|Send hexadecimal data along with the application port.|OK
457 |AT+SENDB=abcdef0123456789|Send hexadecimal data along with the application port.|While Error in format, return(((
458 AT_PARAM_ERROR AT_BUSY_ERROR/AT_NO_NETWORK_JOINED
459
460
461 )))
462
463 = 7. LoRaWAN network management =
464
465 == 7.1 Adaptive Data Rate ==
466
467 Feature: Get or Set the Adaptive Data Rate setting. (0: off, 1: on).
468
469
470 AT Command: AT+ADR
471
472 |=(% colspan="3" %)AT+ADR
473 |**Command Example**|**Function**|**Response**
474 |AT+ADR=?|Get the Adaptive Data Rate setting.|1(((
475 OK
476 )))
477 |AT+ADR=0|Set the Adaptive Data Rate setting.|OK
478 |AT+ADR=2|Set the Adaptive Data Rate setting.|While Error in format, return(((
479 AT_PARAM_ERROR
480 )))
481
482 Downlink Command: 0x22
483
484
485 If the downlink payload=2201, it means setting the adaptive data rate to 1, while type code is 22.
486
487 * Example 1: Downlink Payload: 2201 ~/~/ Set AT+ADR=1.
488 * Example 2: Downlink Payload: 2200FFFF ~/~/ Set AT+ADR=0.
489
490 == 7.2 LoRa® Class ==
491
492 Feature: Get or Set the Device Class(Currently only support class A, class C).
493
494 AT Command:AT+CLASS
495
496 |=(% colspan="3" %)AT+CLASS
497 |**Command Example**|**Function**|**Response**
498 |AT+CLASS=?|Get the Device Class.|A(((
499 OK
500 )))
501 |AT+CLASS=C|Set the Device Class.|OK(((
502
503 )))
504
505 == 7.3 Duty Cycle Setting ==
506
507 Feature: Get or Set the ETSI Duty Cycle setting - 0=disable, 1=enable - Only for testing.
508
509 AT Command:AT+DCS
510
511 |=(% colspan="3" %)AT+DCS
512 |**Command Example**|**Function**|**Response**
513 |AT+DCS=?|Get the ETSI Duty Cycle setting.|1(((
514 OK
515 )))
516 |AT+DCS=1|Set the ETSI Duty Cycle setting.|OK(((
517
518 )))
519
520 == 7.4 Data Rate ==
521
522 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
523
524 AT Command: AT+DR
525
526 |=(% colspan="3" %)AT+DR
527 |**Command Example**|**Function**|**Response**
528 |AT+DR=?|Get the Data Rate.|5(((
529 OK
530 )))
531 |AT+DR=2|Set the Data Rate.|OK(((
532
533 )))
534
535 Downlink Command: 0x2200aaFF
536
537
538 If the downlink payload=220001FF, it means setting the data rate to 1, while type code is 22 00 aa FF.
539
540 * Example 1: Downlink Payload: 220001FF ~/~/ Set AT+DR=1.
541 * Example 2: Downlink Payload: 220000FF ~/~/ Set AT+DR=0.
542
543 == 7.5 Frame Counter Downlink ==
544
545 Feature: Get or Set the Frame Counter Downlink.
546
547 AT Command:AT+FCD
548
549 |=(% colspan="3" %)AT+FCD
550 |**Command Example**|**Function**|**Response**
551 |AT+FCD=?|Get the Frame Counter Downlink.|0(((
552 OK
553 )))
554 |AT+FCD=10|Set the Frame Counter Downlink.|(System will write new value to FCD)(((
555 OK
556
557
558 )))
559
560 == 7.6 Frame Counter Uplink ==
561
562 Feature: Get or Set the Frame Counter Uplink.
563
564 AT Command:AT+FCU
565
566 |=(% colspan="3" %)AT+FCU
567 |**Command Example**|**Function**|**Response**
568 |AT+FCU=?|Get the Frame Counter Uplink.|0(((
569 OK
570 )))
571 |AT+FCU=10|Set the Frame Counter Uplink.|OK(((
572
573 )))
574
575 == 7.7 Join Accept Delay1 ==
576
577 Feature: Get or Set the Join Accept Delay between the end of the Tx and the Join Rx Window 1 in ms.
578
579 AT Command:AT+JN1DL
580
581 |=(% colspan="3" %)AT+JN1DL
582 |**Command Example**|**Function**|**Response**
583 |AT+JN1DL=?|Get the Join Accept Delay.|5000(((
584 OK
585 )))
586 |AT+JN1DL=10000|Set the Join Accept Delay.|OK(((
587
588 )))
589
590 == 7.8 Join Accept Delay2 ==
591
592 Feature: Get or Set the Join Accept Delay between the end of the Tx and the Join Rx Window 2 in ms.
593
594 AT Command:AT+JN2DL
595
596 |=(% colspan="3" %)AT+JN2DL
597 |**Command Example**|**Function**|**Response**
598 |AT+JN2DL=?|Get the Join Accept Delay.|6000(((
599 OK
600 )))
601 |AT+JN2DL=20000|Set the Join Accept Delay.|OK(((
602
603 )))
604
605 == 7.9 Public Network Mode ==
606
607 Feature: Get or Set the public network mode. (0: off, 1: on)
608
609 AT Command:AT+PNM
610
611 |=(% colspan="3" %)AT+PNM
612 |**Command Example**|**Function**|**Response**
613 |AT+PNM=?|Get the public network mode.|1(((
614 OK
615 )))
616 |AT+PNM=1|Set the public network mode.|(System will write new value to PNM)(((
617 OK
618
619
620 )))
621
622 == 7.10 Receive Delay1 ==
623
624 Feature: Get or Set the delay between the end of the Tx and the Rx Window 1 in ms
625
626 AT Command:AT+RX1DL
627
628 |=(% colspan="3" %)AT+RX1DL
629 |**Command Example**|**Function**|**Response**
630 |AT+RX1DL=?|Get the delay.|1000(((
631 OK
632 )))
633 |AT+RX1DL=1500|Set the delay.|OK(((
634
635 )))
636
637 == 7.11Receive Delay2 ==
638
639 Feature: Get or Set the delay between the end of the Tx and the Rx Window 2 in ms
640
641 AT Command:AT+RX2DL
642
643 |=(% colspan="3" %)AT+RX2DL
644 |**Command Example**|**Function**|**Response**
645 |AT+RX2DL=?|Get the delay.|2000(((
646 OK
647 )))
648 |AT+RX2DL=2500|Set the delay.|OK(((
649
650 )))
651
652 == 7.12 Rx2 Window Data Rate ==
653
654 Feature: Get or Set the Rx2 window data rate (0-7 corresponding to DR_X)
655
656 AT Command:AT+RX2DR
657
658 |=(% colspan="3" %)AT+RX2DR
659 |**Command Example**|**Function**|**Response**
660 |AT+RX2DR=?|Get the Rx2 window data rate.|2(((
661 OK
662 )))
663 |AT+RX2DR=6|Set the Rx2 window data rate.|OK(((
664
665 )))
666
667 == 7.13 Rx2 Window Frequency ==
668
669 Feature: Get or Set the Rx2 window frequency
670
671 AT Command:AT+RX2FQ
672
673 |=(% colspan="3" %)AT+RX2FQ
674 |**Command Example**|**Function**|**Response**
675 |AT+RX2FQ=?|Get the Rx2 window frequency.|434665000(((
676 OK
677 )))
678 |AT+RX2FQ=434665000|Set the Rx2 window frequency.|OK(((
679
680 )))
681
682 == 7.14 Transmit Power ==
683
684 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. )
685
686 AT Command:AT+TXP
687
688 |=(% colspan="3" %)AT+TXP
689 |**Command Example**|**Function**|**Response**
690 |AT+TXP=?|Get the Transmit Power.|0(((
691 OK
692 )))
693 |AT+TXP=1|Set the Transmit Power.|OK(((
694
695 )))
696
697 Downlink Payload. The 4th byte of 0x22 downlink.
698
699 If the downlink payload=22000100, it means setting the TXP to 0.
700
701 * Example 1: Downlink Payload: 22000102 ~/~/ Set AT+TXP=2.
702 * Example 2: Downlink Payload: 220000FF ~/~/ Set AT+TXP=0.
703
704 == 7.15 RSSI of the Last Received Packet ==
705
706 Feature: Get or Set the Rx2 window frequency
707
708 AT Command:AT+RSSI
709
710 |=(% colspan="3" %)AT+RSSI
711 |**Command Example**|**Function**|**Response**
712 |AT+RSSI=?|Get the RSSI of the last received packet.|0(((
713 OK
714 )))
715
716 == 7.16 SNR of the Last Received Packet ==
717
718 Feature: Get the SNR of the last received packet
719
720 AT Command:AT+SNR
721
722 |=(% colspan="3" %)AT+SNR
723 |**Command Example**|**Function**|**Response**
724 |AT+SNR=?|Get the RSSI of the last received packet.|0(((
725 OK
726 )))
727
728 == 7.17 Application Port ==
729
730 Feature: Get or set the application port.
731
732 AT Command: AT+PORT
733
734 |=(% colspan="3" %)AT+PORT
735 |**Command Example**|**Function**|**Response**
736 |AT+PORT=?|Get the application port|21(((
737 OK
738 )))
739 |AT+PORT=21|Set the application port|OK
740
741 Downlink Command: 0x23
742
743 Format: Command Code (0x23) followed by 1 bytes port value.
744
745 If the downlink payload=2301, it means set the application port to 1, while type code is 23.
746
747 * Example 1: Downlink Payload: 2301 ~/~/ set the application port to 1
748 * Example 2: Downlink Payload: 2305 ~/~/ set the application port to 5
749
750 == 7.18 Single Channel Mode ==
751
752 Feature:Get or Set Frequency (Unit: Hz) for Single Channel Mode.
753
754 AT Command: AT+CHS
755
756 |=(% colspan="3" %)AT+CHS
757 |**Command Example**|**Function**|**Response**
758 |AT+CHS=?|Get Frequency for Single Channel Mode|0(((
759 OK
760 )))
761 |AT+CHS=868100000|Set Frequency for Single Channel Mode|OK
762
763 == 7.19 Eight Channel Mode ==
764
765 Feature: Get or Set eight channels mode,Only for US915,AU915,CN470.
766
767 AT Command: AT+CHE
768
769 |=(% colspan="3" %)AT+CHE
770 |**Command Example**|**Function**|**Response**
771 |AT+CHE=?|Get eight channels mode|1(((
772 902.3 902.5 902.7 902.9 903.1 903.3 903.5 903.7
773
774 OK
775 )))
776 |AT+CHE=1|Set eight channels mode|OK
777
778 Downlink Command: 0x24
779
780 Format: Command Code (0x24) followed by 1 bytes channel value.
781
782 If the downlink payload=2401, it means set channel mode to 1, while type code is 24.
783
784 * Example 1: Downlink Payload: 2401 ~/~/ set channel mode to 1
785 * Example 2: Downlink Payload: 2405 ~/~/ set channel mode to 5
786
787 == 7.20 Get or Set RXwindows1 timeout ==
788
789 Feature:Get or Set the number of symbols to detect and timeout from RXwindow1(0 to 255).
790
791 AT Command: AT+RX1WTO
792
793 |=(% colspan="3" %)AT+ RX1WTO
794 |**Command Example**|**Function**|**Response**
795 |AT+RX1WTO=?|Get RXwindows1 timeout|14(((
796 OK
797 )))
798 |AT+RX1WTO=60|Set RXwindows1 timeout|OK
799
800 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.
801
802 [[~[~[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]]
803
804 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.
805
806 == 7.21 Get or Set RXwindows2 timeout ==
807
808 Feature:Get or Set the number of symbols to detect and timeout from RXwindow2(0 to 255).
809
810 AT Command: AT+RX2WTO
811
812 |=(% colspan="3" %)AT+ RX2WTO
813 |**Command Example**|**Function**|**Response**
814 |AT+RX2WTO=?|Get RXwindows2 timeout|7(((
815 OK
816 )))
817 |AT+RX2WTO=20|Set RXwindows2 timeout|OK
818
819 == 7.22 Setting up uplinkdwelltime (as923, au915) ==
820
821 Feature: Get or Set uplinkdwelltime
822
823 AT Command: AT+DWELLT
824
825 |=(% colspan="3" %)AT+DWELLT
826 |**Command Example**|**Function**|**Response**
827 |AT+DWELLT=?|Get uplinkdwelltime|1(((
828 OK
829 )))
830 |AT+DWELLT=0|Set uplinkdwelltime|OK
831
832 Downlink Command: 0x25
833
834 Format: Command Code (0x25) followed by 1 bytes state value.
835
836 If the downlink payload=2501, it means set uplinkdwelltime to 1, while type code is 25.
837
838 * Example 1: Downlink Payload: 2501 ~/~/ set uplinkdwelltime to 1
839 * Example 2: Downlink Payload: 2500 ~/~/ set uplinkdwelltime to 0
840
841 == 7.23 Set Packet Receiving Response Level ==
842
843 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.
844
845 RPL value:
846
847 * AT+RPL=0: Device won't immediately reply any downlink commands from platform.
848 * AT+RPL=1: Device will immediately reply message to Unconfirmed Data Down. Payload is 0x00.
849 * AT+RPL=2: Device will immediately reply message to Confirmed Data Down. Payload is 0x00 and requied response header for this command.
850 * AT+RPL=3: Device will immediately reply message to MAC Command. Payload is 0x00 and requied response header for this command.
851 * 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.
852
853 Case Analyes:
854
855 * For Class A devices, AT+RPL=0 is ok. that is defaut settings in software.
856 * For Class C devices used in ChirpStack, need to set AT+RPL=4 because Chirpstack require immedietely reply message to MAC Command.
857 * 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.
858
859 AT Command: AT+RPL
860
861 |=(% colspan="3" %)AT+RPL
862 |**Command Example**|**Function**|**Response**
863 |AT+RPL=?|Get packet receiving response level|1(((
864 OK
865 )))
866 |AT+RPL=0|Set packet receiving response level|OK
867
868 Downlink Command: 0x21
869
870 Format: Command Code (0x21) followed by 1 bytes level value.
871
872 If the downlink payload=2101, it means set packet receiving response level to 1, while type code is 21.
873
874 * Example 1: Downlink Payload: 2101 ~/~/ set packet receiving response level to 1
875 * Example 2: Downlink Payload: 2102 ~/~/ set packet receiving response level to 2
876
877 = 8. AT Commands Combination =
878
879 == 8.1 Set a fix RX2DR for downlink window ==
880
881 * AT+ADR=0 ~-~-> Disable ADR first
882 * AT+RX2DR=xxxx ~-~-> Set xxxx to your wanted DataRate
883
884 == 8.2 Use Downlink Command to set a fix uplink DR ==
885
886 Downlink Command: 0x22000500
887
888 Same as:
889
890 * AT+ADR=0 [[Reference>>url:https://wiki.dragino.com/index.php/End_Device_Downlink_Command#Adaptive_Data_Rate]]
891 * AT+DR=5 [[Reference>>url:https://wiki.dragino.com/index.php/End_Device_Downlink_Command#Data_Rate]]
892 * AT+TXP=0 [[Reference>>url:https://wiki.dragino.com/index.php/End_Device_Downlink_Command#Transmit_Power]]