Version 24.1 by Edwin Chen on 2022/11/16 15:38
Show last authors
1 **Table of Contents： **
2
3 {{toc/}}
4
5
6
7
8 = 1. Overview =
9
10 (((
11
12
13 Shipped LT-22222-L is base on LoRaWAN protocol. We also develop a open source Point to Point LoRa protocol for LT-22222-L. The source code and hex file can be found at:
14 )))
15
16 (((
17 [[LT22222-L_PingPong_Software>>https://github.com/dragino/LT-22222-L]]
18
19
20 )))
21
22 = 2. Features for this firmware =
23
24 == 2.1  Point To Point ==
25
26 === 2.1.1 Overview ===
27
28
29 [[image:image-20220602111219-1.png||height="472" width="972"]]
30
31
32 === 2.2.2 Configure ===
33
34
35 (% border="1" style="background-color:#f7faff; color:black; width:360px" %)
36 |=(% style="width: 179px;" %)**A's configuration**|=(% style="width: 177px;" %)**B's configuration**
37 |(% style="width:179px" %)AT+GROUPMOD=0|(% style="width:177px" %)AT+GROUPMOD=0
38 |(% style="width:179px" %)AT+TXCHS=868700000|(% style="width:177px" %)AT+TXCHS=869000000
39 |(% style="width:179px" %)AT+RXCHS=869000000|(% style="width:177px" %)AT+RXCHS=868700000
40 |(% style="width:179px" %)AT+TRIG1=2,50|(% style="width:177px" %)AT+TRIG1=2,50
41 |(% style="width:179px" %)AT+TRIG2=2,50|(% style="width:177px" %)AT+TRIG2=2,50
42 |(% style="width:179px" %)AT+DI1TODO1=2|(% style="width:177px" %)AT+DI1TODO1=2
43 |(% style="width:179px" %)AT+DI1TORO1=2|(% style="width:177px" %)AT+DI1TORO1=2
44 |(% style="width:179px" %)AT+DI2TODO2=2 |(% style="width:177px" %)AT+DI2TODO2=2
45 |(% style="width:179px" %)AT+DI2TORO2=2|(% style="width:177px" %)AT+DI2TORO2=2
46
47 === 2.2.3 Serial port display ===
48
49
50 (% class="wikigeneratedid" %)
51 [[image:image-20220602111219-2.png]]
52
53
54 (% class="wikigeneratedid" %)
55 [[image:image-20220602111219-3.png]]
56
57
58 (% class="wikigeneratedid" %)
59 If the sender does not get the ACK reply from the receiver, it will retransmit up to 4 times, each interval is 6 seconds, and the UplinkCounter of the retransmission will not increase.
60
61
62 == 2.2  Point To Mult-Point ==
63
64 === 2.2.1 Overview ===
65
66
67 [[image:1654152390874-192.png]]
68
69
70 === 2.2.2  Configure ===
71
72
73 (% style="color:blue" %)**Configuration of the TX group:**
74
75 AT+GROUPMOD=0,2
76
77 AT+TXCHS=868700000
78
79 AT+RXCHS=869000000
80
81 AT+TRIG1=2,50
82
83 AT+TRIG2=2,50
84
85 AT+DI1TODO1=1
86
87 AT+DI1TORO1=1
88
89 AT+DI2TODO2=1
90
91 AT+DI2TORO2=1
92
93
94 (% style="color:blue" %)**Configuration for RX group number 1:**
95
96 AT+GROUPMOD=1,1
97
98 AT+TXCHS=869000000
99
100 AT+RXCHS=868700000
101
102
103 (% style="color:blue" %)**Configuration for RX group number 2:**
104
105 AT+GROUPMOD=1,2
106
107 AT+TXCHS=869000000
108
109 AT+RXCHS=868700000
110
111
112 === 2.2.3 Serial port display ===
113
114
115 [[image:image-20220602144747-1.png]]
116
117
118 [[image:image-20220602144747-2.png]]
119
120
121 (((
122 If the TX group does not receive all the ACK replies from the RX group, it will retransmit up to 4 times, each time interval is 30 seconds, and the retransmission UplinkCounter will not increase.
123 )))
124
125
126 == 2.3 AT command ==
127
128
129 (((
130 (% style="color:#037691" %)**ATZ** (%%)**: ** Trig a reset of the MCU
131 )))
132
133 (((
134 (% style="color:#037691" %)**AT+FDR** (%%)**:**  Reset Parameters to Factory Default, Keys Reserve
135 )))
136
137 (((
138 (% style="color:#037691" %)**AT+FCU** (%%)**:**  Get or Set the Frame Counter Uplink
139 )))
140
141 (((
142 (% style="color:#037691" %)**AT+FCD** (%%)**:**  Get or Set the Frame Counter Downlink
143 )))
144
145 (((
146 (% style="color:#037691" %)**AT+TXP** (%%)**:**  Get or Set the transmit power, the maximum is 20dBm (default is 14dBm)
147 )))
148
149 (((
150 (% style="color:#037691" %)**AT+SYNC** (%%)**:**  Get or Set the Sync word [1:0x34,0:0x12] (default is 1)
151 )))
152
153 (((
154 (% style="color:#037691" %)**AT+PMB** (%%)**:    **Get or Set the preamble (default:8)
155 )))
156
157 (((
158 (% style="color:#037691" %)**AT+TXCHS **(%%)**:** Get or Set the transmit frequency of TX (default:868700000)
159 )))
160
161 (((
162 (% style="color:#037691" %)**AT+TXSF **(%%)**:**  Get or Set the spreading factor of TX (7 to 12) (default:12)
163 )))
164
165 (((
166 (% style="color:#037691" %)**AT+RXCHS **(%%)**:** Get or Set the transmit frequency of RX (default:869000000)
167 )))
168
169 (((
170 (% style="color:#037691" %)**AT+RXSF **(%%)**:**  Get or Set the spreading factor of RX (7 to 12) (default:12)
171 )))
172
173 (((
174 (% style="color:#037691" %)**AT+BW **(%%)**:       **Get or Set the bandwidth [0:125khz,1:250khz,2:500khz] (default:0)
175 )))
176
177 (((
178 (% style="color:#037691" %)**AT+CR **(%%)**:        **Get or Set the coding rate [1: 4/5, 2: 4/6, 3: 4/7, 4: 4/8] (default:1)
179 )))
180
181 (((
182 (% style="color:#037691" %)**AT+TDC **(%%)**:**  Get or set the application data transmission interval in ms(default 10 minutes)
183 )))
184
185 (((
186 (% style="color:#037691" %)**AT+VER **(%%)**:**  Get firmware version number
187 )))
188
189 (((
190 (% style="color:#037691" %)**AT+SEND **(%%)**:   **Set Custom sent hex data
191 )))
192
193 (((
194 (% style="color:#037691" %)**AT+GROUPMOD **(%%)**: **Set or Get the grouping mode of the device (default: 0)
195 )))
196
197 (((
198 (((
199 (% style="color:#037691" %)**AT+GROUPID **(%%)**:      **Set or Get the password for matching between TX group and RX group, which can be composed of numbers or characters (default: 12345678)
200 )))
201 )))
202
203 (((
204 (% style="color:#037691" %)**AT+TRIG1 **(%%)**:**  Set or Get the DI1 pin interrupt trigger mode (default 0,0)
205 )))
206
207 (((
208 (% style="color:#037691" %)**AT+TRIG2 **(%%)**:            **Set or Get the DI2 pin interrupt trigger mode (default 0,0)
209 )))
210
211 (((
212 (% style="color:#037691" %)**AT+DI1TODO1 **(%%)**:    **Set or get the mode in which DI1 maps to DO1 (default 0)
213 )))
214
215 (((
216 (% style="color:#037691" %)**AT+DI1TORO1 **(%%)**:    **Set or get the mode in which DI1 maps to RO1(default 0)
217 )))
218
219 (((
220 (% style="color:#037691" %)**AT+DI2TODO2 **(%%)**:**  Set or get the mode in which DI2 maps to DO2(default 0)
221 )))
222
223 (((
224 (% style="color:#037691" %)**AT+DI2TORO2 **(%%)**:    **Set or get the mode in which DI2 maps to RO2(default 0)
225 )))
226
227
228 (((
229 (% style="color:blue" %)**Example 1:**
230 )))
231
232 (((
233 **AT+SEND=01020304 **will send a payload of 01020304
234 )))
235
236
237 (((
238 (% style="color:blue" %)**Example 2: **
239 )))
240
241 (((
242 **AT+TRIGx=a    **Trigger directly without triggering time
243 )))
244
245 (((
246 **AT+TRIGx=a,b**
247 )))
248
249 (((
250 **a=0:** falling edge;
251 )))
252
253 (((
254 **a=1: **rising edge;
255 )))
256
257 (((
258 **a=2:** falling edge or rising edge;
259 )))
260
261 (((
262 **b:**  triggering time in milliseconds.
263 )))
264
265 (((
266 **AT+TRIGx=2,50**  Falling edge or rising edge trigger, and the trigger time exceeds 50ms.
267 )))
268
269
270 (((
271 (% style="color:blue" %)**Example 3: **
272 )))
273
274 (((
275 **AT+DI1TODO1= maps value**
276 )))
277
278 (((
279 **AT+DI1TORO1= maps value**
280 )))
281
282 (((
283 **AT+DI2TODO2= maps value**
284 )))
285
286 (((
287 **AT+DI2TORO2= maps value**
288 )))
289
290 (((
291
292 )))
293
294 (% border="1" style="background-color:#f7faff; color:black; width:690px" %)
295 |=(% style="width: 102px;" %)(((
296 Maps value
297 )))|=(% style="width: 331px;" %)(((
298 DIx to DOx
299 )))|=(% style="width: 251px;" %)(((
300 DIx to ROx
301 )))
302 |(% style="width:102px" %)(((
303 0
304 )))|(% style="width:331px" %)(((
305 No Action
306 )))|(% style="width:251px" %)(((
307 No Action
308 )))
309 |(% style="width:102px" %)(((
310 1
311 )))|(% style="width:331px" %)(((
312 If DIx is high, control DOx to output low level, If DIx is low, control DOx to output high level
313 )))|(% style="width:251px" %)(((
314 (((
315 If DIx is high, control ROx to close,
316 )))
317
318 (((
319 if DIx is low, control ROx to open
320 )))
321 )))
322 |(% style="width:102px" %)(((
323 2
324 )))|(% style="width:331px" %)(((
325 If DIx is high, control DOx to output high level, If DIx is low, control DOx to output low level
326 )))|(% style="width:251px" %)(((
327 (((
328 If DIx is high, control ROx to open,
329 )))
330
331 (((
332 if DIx is low, control ROx to close
333 )))
334 )))
335 |(% style="width:102px" %)(((
336 3
337 )))|(% style="width:331px" %)(((
338 DOx state flip
339 )))|(% style="width:251px" %)(((
340 ROx state flip
341 )))
342
343 (((
344
345
346 (% style="color:blue" %)**Example 4: **
347 )))
348
349 (((
350 **AT+GROUPMOD=0**  Set to point to point mode
351 )))
352
353 (((
354 **AT+GROUPMOD=0,aa**  Set the TX group that controls the number of aa (The maximum value of aa is 8)
355 )))
356
357 (((
358 **AT+GROUPMOD=1,bb**  Set to the RX group controlled by the TX group, numbered bb(The maximum value of aa is 8)
359 )))
360
361 (((
362 **AT+GROUPMOD=0,2**  Set to control the TX group of the two RX groups
363 )))
364
365 (((
366 **AT+GROUPMOD=1,1**  Set the RX group numbered 1
367 )))
368
369 (((
370 **AT+GROUPMOD=1,2**  Set the RX group numbered 2
371 )))
372
373
374 === 2.3.1 TRIG command is configured in the transmit LT. (LT1)(Since firmware 1.3) ===
375
376
377 **AT+TRIGx=a          **Trigger transmit directly without triggering time
378
379 **AT+TRIGx=a,b**  Trigger transmit with triggering time threshold
380
381 **AT+TRIGx=a,b,c    **Trigger transmit with triggering time threshold, and continue to transmit every xx seconds if DI status no change.
382
383
384 **a=0:** falling edge;
385
386 **a=1:** rising edge;
387
388 **a=2:** falling edge or rising edge;
389
390 **b:**  triggering time in milliseconds.
391
392 **c:** transmit interval
393
394
395 (% style="color:blue" %)**Use Case 1**(%%):  Once the DI1 port status change ( either from low to high or high to low, LT1 sends a trigger to LT-2)
396
397 **Command:**
398
399 **AT+TRIG1=2,50**  Falling edge or rising edge trigger, and the trigger time should exceed 50ms.
400
401
402 (% style="color:blue" %)**Use Case 2:  **(%%)Sync LT2 RO / DO status with LT1 every minute.
403
404 **Command:**
405
406 **AT+TRIG2=2,50,60**  Once there is falling edge or rising edge on DI2 of LT1, LT1 will transmit trigger to LT2 and LT2 can sync the status of RO/DO. After power off, power on, LT1 will send trigger without falling/rising edge, so the DI changes during power off will be sync as well.
407
408
409 === 2.3.2 RO/DO is configured in the receiver LT (LT2)(Since firmware 1.3) ===
410
411
412 AT+DI1TODO1= maps value[,latch time]
413
414 AT+DI1TORO1= maps value[,latch time]
415
416 AT+DI2TODO2= maps value[,latch time]
417
418 AT+DI2TORO2= maps value[,latch time]
419
420
421 (% border="1" style="background-color:#f7faff; color:black; width:774px" %)
422 |(% style="width:105px" %) **Maps value**|(% style="width:415px" %)**DIx to DOx**|(% style="width:249px" %)**DIx to ROx**
423 |(% style="width:105px" %)0|(% style="width:415px" %)No Action|(% style="width:249px" %)No Action
424 |(% style="width:105px" %)1|(% style="width:415px" %)If DIx is high, control DOx to output low level, If DIx is low, control DOx to output high level|(% style="width:249px" %)(((
425 If DIx is high, control ROx to close,
426
427 if DIx is low, control ROx to open
428 )))
429 |(% style="width:105px" %)2|(% style="width:415px" %)If DIx is high, control DOx to output high level, If DIx is low, control DOx to output low level|(% style="width:249px" %)(((
430 If DIx is high, control ROx to open,
431
432 if DIx is low, control ROx to close
433 )))
434 |(% style="width:105px" %)3|(% style="width:415px" %)DOx state flip|(% style="width:249px" %)ROx state flip
435
436 latch time, if latch time is defined, DO or RO will go back to the original status after latch time, if there is a new trigger comes, the LT2 will use the new latch time settings and ignore the old one.
437
438
439 (% style="color:blue" %)**Case1**:
440
441 AT+DI1TODO1=1  ~/~/ LT2 DO1 will follow LT1 DI1 trigger command, if DI1 of LT1 is trigger high, DO1 of LT2 will output low, if DI1 of LT1 is trigger low, DO2 of LT2 will output high.
442
443
444 (% style="color:blue" %)**Case2**:
445
446 AT+DI1TODO1=1,60  ~/~/ LT2 DO1 will follow LT1 DI1 trigger command, DO1 will keep the status 60 seconds and then go back to original state.
447
448
449 === 2.3.3 Save the RO/DO status during power off(Since firmware 1.3) ===
450
451
452 Enable/Disbale retain Digital Output/Relay Output after power off / Power On
453
454 **AT+DOROSAVE=0**  ~/~/ Disable Retain after power off/on
455
456 **AT+DOROSAVE=1**  ~/~/ Enable Retain after power off/on
457
458 **AT+DOROSAVE=2,a,b,c,d**  ~/~/ set DO/RO port to default state after power on.
459
460 **a: **for DO1
461
462 **b:** for DO2
463
464 **c: **for RO1
465
466 **d:** for RO2.
467
468
469 **Example:**
470
471 AT+DOROSAVE=2,0,0,0,1  ~/~/ Set DO1/DO2 to Low, RO1 to open after power on , set RO2 to close after power on.
472
473
474 === 2.3.4 Control Sleep status.(Since firmware 1.3) ===
475
476
477 DI2 can be used to set LT into sleep mode.
478
479 **AT+DI2SLEEP=1**  ~/~/  Enable DI2 as Sleep pin
480
481 **AT+DI2SLEEP=0**  ~/~/  Disable DI2 as Sleep pin
482
483 When DI2 is enabled as sleep pin, a falling trigger (with 500ms pulse) will set LT into sleep mode. A raising trigger will wake up it again.
484
485 In sleep mode, DORO will keep its initial state if AT+DOROSAVE=2, otherwise DORO will be in OFF state
486
487
488 == 2.4 Data Format ==
489
490
491 (((
492 8 bytes of GROUPID + 9 bytes of payload + 4 bytes of checksum
493 )))
494
495 (((
496 (% style="color:blue" %)**Payload:Payload triggered by TDC or DI**
497 )))
498
499 (% border="1" style="background-color:#f7faff; color:black; width:825px" %)
500 |=(% style="width: 102px;" %)(((
501 **Size (bytes)**
502 )))|=(% style="width: 74px;" %)(((
503 1
504 )))|=(% style="width: 72px;" %)(((
505 1
506 )))|=(% style="width: 47px;" %)(((
507 1
508 )))|=(% style="width: 83px;" %)(((
509 1
510 )))|=(% style="width: 90px;" %)(((
511 1
512 )))|=(% style="width: 92px;" %)(((
513 1
514 )))|=(% style="width: 78px;" %)(((
515 1
516 )))|=(% style="width: 91px;" %)(((
517 1
518 )))|=(% style="width: 91px;" %)(((
519 1
520 )))
521 |(% style="width:102px" %)(((
522 **Value**
523 )))|(% style="width:74px" %)(((
524 address
525 )))|(% style="width:72px" %)(((
526 request
527 )))|(% style="width:47px" %)(((
528 ACK
529 )))|(% style="width:83px" %)(((
530 (((
531 DI1&
532 DI1 level
533 )))
534 )))|(% style="width:90px" %)(((
535 DI1TODO1
536 )))|(% style="width:92px" %)(((
537 DI1TORO1
538 )))|(% style="width:78px" %)(((
539 (((
540 DI2&
541 DI2 leve
542 )))
543 )))|(% style="width:91px" %)(((
544 DI2TODO2
545 )))|(% style="width:91px" %)(((
546 DI2TORO2
547 )))
548
549 (((
550 (% style="color:#037691" %)**The first byte**(%%)**:**  00 is the broadcast address, 01-08 is the RX group number.
551 )))
552
553 (((
554 (% style="color:#037691" %)**The second byte**(%%)**:**  send mapping request when not 0, not request when it is 0.
555 )))
556
557 (((
558 (% style="color:#037691" %)**The third byte**(%%)**:**  ACK returned to the sender after the mapping is completed.
559 )))
560
561 (((
562 (((
563 (% style="color:#037691" %)**The fourth byte**(%%)**:**  the high four bits are 1 to represent DI1, and the low four bits are the level of DI1 when the interrupt is triggered.
564 )))
565 )))
566
567 (((
568 (% style="color:#037691" %)**The Fifth byte**(%%)**:       **DI1TODO1 when the interrupt is triggered, 0 when the interrupt is not triggered.
569 )))
570
571 (((
572 (% style="color:#037691" %)**The Sixth byte**(%%)**:**  0 does not trigger interrupt when DI1TORO1 interrupt is triggered.
573 )))
574
575 (((
576 (((
577 (% style="color:#037691" %)**The seventh byte**(%%)**:**  the high four bits are 2 to represent DI2, and the low four bits are the level of DI2 when the interrupt is triggered.
578 )))
579 )))
580
581 (((
582 (% style="color:#037691" %)**The 8th byte**(%%)**:          **DI2TODO2 when the interrupt is triggered, 0 when the interrupt is not triggered.
583 )))
584
585 (((
586 (% style="color:#037691" %)**The 9th byte**(%%)**:**  DI2TORO2 when an interrupt is triggered, 0 when an interrupt is not triggered.
587 )))
588
589 (((
590
591
592 (% style="color:blue" %)**Payload:（Since firmware 1.3）The receiver replies to the sent packet**
593 )))
594
595 (% border="1" style="background-color:#f7faff; color:black; width:822px" %)
596 |=(% style="width: 97px;" %)(((
597 **Size(bytes)**
598 )))|=(% style="width: 71px;" %)(((
599 1
600 )))|=(% style="width: 70px;" %)(((
601 1
602 )))|=(% style="width: 48px;" %)(((
603 1
604 )))|=(% style="width: 85px;" %)(((
605 1
606 )))|=(% style="width: 90px;" %)(((
607 1
608 )))|=(% style="width: 88px;" %)(((
609 1
610 )))|=(% style="width: 86px;" %)(((
611 1
612 )))|=(% style="width: 92px;" %)(((
613 1
614 )))|=(% style="width: 92px;" %)(((
615 1
616 )))
617 |(% style="width:97px" %)(((
618 **Value**
619 )))|(% style="width:71px" %)(((
620 address
621 )))|(% style="width:70px" %)(((
622 request
623 )))|(% style="width:48px" %)(((
624 ACK
625 )))|(% style="width:85px" %)(((
626 (((
627 DOI1&
628 DOI2 level
629 )))
630 )))|(% style="width:90px" %)(((
631 DI1TODO1
632 )))|(% style="width:88px" %)(((
633 DI1TORO1
634 )))|(% style="width:86px" %)(((
635 (((
636 RO2&
637 RO2 level
638 )))
639 )))|(% style="width:92px" %)(((
640 DI2TODO2
641 )))|(% style="width:92px" %)(((
642 DI2TORO2
643 )))
644
645 (((
646 (% style="color:#037691" %)**The first byte**(%%)**:**  00 is the broadcast address, 01-08 is the RX group number.
647 )))
648
649 (((
650 (% style="color:#037691" %)**The second byte**(%%)**:**  send mapping request when not 0, not request when it is 0.
651 )))
652
653 (((
654 (% style="color:#037691" %)**The third byte**(%%)**:**  ACK returned to the sender after the mapping is completed.
655 )))
656
657 (((
658 (((
659 (% style="color:#037691" %)**The fourth byte**(%%)**:**  the high four bits are 1 to represent DOI1, and the low four bits are the level of DOI2 when the interrupt is triggered.
660 )))
661 )))
662
663 (((
664 (% style="color:#037691" %)**The Fifth byte**(%%)**:       **DI1TODO1 when the interrupt is triggered, 0 when the interrupt is not triggered.
665 )))
666
667 (((
668 (% style="color:#037691" %)**The Sixth byte**(%%)**:**  0 does not trigger interrupt when DI1TORO1 interrupt is triggered.
669 )))
670
671 (((
672 (((
673 (% style="color:#037691" %)**The seventh byte**(%%)**:**  the high four bits are 2 to represent RO2, and the low four bits are the level of RO2 when the interrupt is triggered.
674 )))
675 )))
676
677 (((
678 (% style="color:#037691" %)**The 8th byte**(%%)**:          **DI2TODO2 when the interrupt is triggered, 0 when the interrupt is not triggered.
679 )))
680
681 (((
682 (% style="color:#037691" %)**The 9th byte**(%%)**:**  DI2TORO2 when an interrupt is triggered, 0 when an interrupt is not triggered.
683 )))
684
685

Applications

Navigation

Copyright ©2010-2022 Dragino Technology Co., LTD. All rights reserved
Dragino Wiki v2.0