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

Applications

Navigation

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