Skip to Content
Version 20.1 by Bei Jinggeng on 2022/11/15 10:27
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 [[Point to Point Software for LT-22222-L>>https://github.com/dragino/LT-22222-L]].
18 )))
19
20
21 = 2. Features for this firmware =
22
23 == 2.1  Point To Point ==
24
25 === 2.1.1 Overview ===
26
27
28 [[image:image-20220602111219-1.png||height="472" width="972"]]
29
30
31 === 2.2.2 Configure ===
32
33
34 (% border="1" style="background-color:#f7faff; color:black; width:360px" %)
35 |=(% style="width: 179px;" %)**A's configuration**|=(% style="width: 177px;" %)**B's configuration**
36 |(% style="width:179px" %)AT+GROUPMOD=0|(% style="width:177px" %)AT+GROUPMOD=0
37 |(% style="width:179px" %)AT+TXCHS=868700000|(% style="width:177px" %)AT+TXCHS=869000000
38 |(% style="width:179px" %)AT+RXCHS=869000000|(% style="width:177px" %)AT+RXCHS=868700000
39 |(% style="width:179px" %)AT+TRIG1=2,50|(% style="width:177px" %)AT+TRIG1=2,50
40 |(% style="width:179px" %)AT+TRIG2=2,50|(% style="width:177px" %)AT+TRIG2=2,50
41 |(% style="width:179px" %)AT+DI1TODO1=2|(% style="width:177px" %)AT+DI1TODO1=2
42 |(% style="width:179px" %)AT+DI1TORO1=2|(% style="width:177px" %)AT+DI1TORO1=2
43 |(% style="width:179px" %)AT+DI2TODO2=2 |(% style="width:177px" %)AT+DI2TODO2=2
44 |(% style="width:179px" %)AT+DI2TORO2=2|(% style="width:177px" %)AT+DI2TORO2=2
45
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.
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
486 == 2.4 Data Format ==
487
488
489 (((
490 8 bytes of GROUPID + 9 bytes of payload + 4 bytes of checksum
491 )))
492
493 (((
494 (% style="color:blue" %)**Payload:**
495 )))
496
497 (% border="1" style="background-color:#f7faff; color:black; width:825px" %)
498 |=(% style="width: 102px;" %)(((
499 **Size (bytes)**
500 )))|=(% style="width: 74px;" %)(((
501 1
502 )))|=(% style="width: 72px;" %)(((
503 1
504 )))|=(% style="width: 47px;" %)(((
505 1
506 )))|=(% style="width: 83px;" %)(((
507 1
508 )))|=(% style="width: 90px;" %)(((
509 1
510 )))|=(% style="width: 92px;" %)(((
511 1
512 )))|=(% style="width: 78px;" %)(((
513 1
514 )))|=(% style="width: 91px;" %)(((
515 1
516 )))|=(% style="width: 91px;" %)(((
517 1
518 )))
519 |(% style="width:102px" %)(((
520 **Value**
521 )))|(% style="width:74px" %)(((
522 address
523 )))|(% style="width:72px" %)(((
524 request
525 )))|(% style="width:47px" %)(((
526 ACK
527 )))|(% style="width:83px" %)(((
528 (((
529 DI1&
530 DI1 level
531 )))
532 )))|(% style="width:90px" %)(((
533 DI1TODO1
534 )))|(% style="width:92px" %)(((
535 DI1TORO1
536 )))|(% style="width:78px" %)(((
537 (((
538 DI2&
539 DI2 leve
540 )))
541 )))|(% style="width:91px" %)(((
542 DI2TODO2
543 )))|(% style="width:91px" %)(((
544 DI2TORO2
545 )))
546
547 (((
548 (% style="color:#037691" %)**The first byte**(%%)**:**  00 is the broadcast address, 01-08 is the RX group number.
549 )))
550
551 (((
552 (% style="color:#037691" %)**The second byte**(%%)**:**  send mapping request when not 0, not request when it is 0.
553 )))
554
555 (((
556 (% style="color:#037691" %)**The third byte**(%%)**:**  ACK returned to the sender after the mapping is completed.
557 )))
558
559 (((
560 (((
561 (% 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.
562 )))
563 )))
564
565 (((
566 (% style="color:#037691" %)**The Fifth byte**(%%)**:       **DI1TODO1 when the interrupt is triggered, 0 when the interrupt is not triggered.
567 )))
568
569 (((
570 (% style="color:#037691" %)**The Sixth byte**(%%)**:**  0 does not trigger interrupt when DI1TORO1 interrupt is triggered.
571 )))
572
573 (((
574 (((
575 (% 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.
576 )))
577 )))
578
579 (((
580 (% style="color:#037691" %)**The 8th byte**(%%)**:          **DI2TODO2 when the interrupt is triggered, 0 when the interrupt is not triggered.
581 )))
582
583 (((
584 (% style="color:#037691" %)**The 9th byte**(%%)**:**  DI2TORO2 when an interrupt is triggered, 0 when an interrupt is not triggered.
585 )))
586
587 (((
588
589
590 (% style="color:blue" %)**Payload:（Since firmware 1.3）The receiver replies to the sent packet**
591 )))
592
593 (% border="1" style="background-color:#f7faff; color:black; width:822px" %)
594 |=(% style="width: 97px;" %)(((
595 **Size(bytes)**
596 )))|=(% style="width: 71px;" %)(((
597 1
598 )))|=(% style="width: 70px;" %)(((
599 1
600 )))|=(% style="width: 48px;" %)(((
601 1
602 )))|=(% style="width: 85px;" %)(((
603 1
604 )))|=(% style="width: 90px;" %)(((
605 1
606 )))|=(% style="width: 88px;" %)(((
607 1
608 )))|=(% style="width: 86px;" %)(((
609 1
610 )))|=(% style="width: 92px;" %)(((
611 1
612 )))|=(% style="width: 92px;" %)(((
613 1
614 )))
615 |(% style="width:97px" %)(((
616 **Value**
617 )))|(% style="width:71px" %)(((
618 address
619 )))|(% style="width:70px" %)(((
620 request
621 )))|(% style="width:48px" %)(((
622 ACK
623 )))|(% style="width:85px" %)(((
624 (((
625 DOI1&
626 DOI2 level
627 )))
628 )))|(% style="width:90px" %)(((
629 DI1TODO1
630 )))|(% style="width:88px" %)(((
631 DI1TORO1
632 )))|(% style="width:86px" %)(((
633 (((
634 RO2&
635 RO2 level
636 )))
637 )))|(% style="width:92px" %)(((
638 DI2TODO2
639 )))|(% style="width:92px" %)(((
640 DI2TORO2
641 )))
642
643 (((
644 (% style="color:#037691" %)**The first byte**(%%)**:**  00 is the broadcast address, 01-08 is the RX group number.
645 )))
646
647 (((
648 (% style="color:#037691" %)**The second byte**(%%)**:**  send mapping request when not 0, not request when it is 0.
649 )))
650
651 (((
652 (% style="color:#037691" %)**The third byte**(%%)**:**  ACK returned to the sender after the mapping is completed.
653 )))
654
655 (((
656 (((
657 (% style="color:#037691" %)**The fourth byte**(%%)**:**  the high four bits are 1 to represent DOI1, and the low four bits are the level of DOI1 when the interrupt is triggered.
658 )))
659 )))
660
661 (((
662 (% style="color:#037691" %)**The Fifth byte**(%%)**:       **DI1TODO1 when the interrupt is triggered, 0 when the interrupt is not triggered.
663 )))
664
665 (((
666 (% style="color:#037691" %)**The Sixth byte**(%%)**:**  0 does not trigger interrupt when DI1TORO1 interrupt is triggered.
667 )))
668
669 (((
670 (((
671 (% 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.
672 )))
673 )))
674
675 (((
676 (% style="color:#037691" %)**The 8th byte**(%%)**:          **DI2TODO2 when the interrupt is triggered, 0 when the interrupt is not triggered.
677 )))
678
679 (((
680 (% style="color:#037691" %)**The 9th byte**(%%)**:**  DI2TORO2 when an interrupt is triggered, 0 when an interrupt is not triggered.
681 )))
682
683