Version 1.3 by Xiaoling on 2022/05/10 16:14

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