Version 19.2 by Xiaoling on 2022/11/15 08:47
Show last authors
1 **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:500px" %)
35 |=**A's configuration**|=**B's configuration**
36 |AT+GROUPMOD=0|AT+GROUPMOD=0
37 |AT+TXCHS=868700000|AT+TXCHS=869000000
38 |AT+RXCHS=869000000|AT+RXCHS=868700000
39 |AT+TRIG1=2,50|AT+TRIG1=2,50
40 |AT+TRIG2=2,50|AT+TRIG2=2,50
41 |AT+DI1TODO1=2|AT+DI1TODO1=2
42 |AT+DI1TORO1=2|AT+DI1TORO1=2
43 |AT+DI2TODO2=2 |AT+DI2TODO2=2
44 |AT+DI2TORO2=2|AT+DI2TORO2=2
45
46
47
48 === **2.2.3 Serial port display** ===
49
50
51 (% class="wikigeneratedid" %)
52 [[image:image-20220602111219-2.png]]
53
54
55 (% class="wikigeneratedid" %)
56 [[image:image-20220602111219-3.png]]
57
58
59 (% class="wikigeneratedid" %)
60 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.
61
62
63 == **2.2  Point To Mult-Point ** ==
64
65 === **2.2.1 Overview** ===
66
67
68 [[image:1654152390874-192.png]]
69
70
71 === **2.2.2  Configure** ===
72
73
74 (% style="color:blue" %)**Configuration of the TX group:**
75
76 AT+GROUPMOD=0,2
77
78 AT+TXCHS=868700000
79
80 AT+RXCHS=869000000
81
82 AT+TRIG1=2,50
83
84 AT+TRIG2=2,50
85
86 AT+DI1TODO1=1
87
88 AT+DI1TORO1=1
89
90 AT+DI2TODO2=1
91
92 AT+DI2TORO2=1
93
94
95 (% style="color:blue" %)**Configuration for RX group number 1:**
96
97 AT+GROUPMOD=1,1
98
99 AT+TXCHS=869000000
100
101 AT+RXCHS=868700000
102
103
104 (% style="color:blue" %)**Configuration for RX group number 2:**
105
106 AT+GROUPMOD=1,2
107
108 AT+TXCHS=869000000
109
110 AT+RXCHS=868700000
111
112
113 === **2.2.3 Serial port display** ===
114
115
116 [[image:image-20220602144747-1.png]]
117
118
119 [[image:image-20220602144747-2.png]]
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 (((
230 (% style="color:#4f81bd" %)**Example 1:**
231 )))
232
233 (((
234 **AT+SEND=01020304 **will send a payload of 01020304
235 )))
236
237
238
239 (((
240 (% style="color:blue" %)**Example 2: **
241 )))
242
243 (((
244 **AT+TRIGx=a    **Trigger directly without triggering time
245 )))
246
247 (((
248 **AT+TRIGx=a,b**
249 )))
250
251 (((
252 a=0: falling edge;
253 )))
254
255 (((
256 a=1: rising edge;
257 )))
258
259 (((
260 a=2: falling edge or rising edge;
261 )))
262
263 (((
264 b:  triggering time in milliseconds.
265 )))
266
267 (((
268 AT+TRIGx=2,50  Falling edge or rising edge trigger, and the trigger time exceeds 50ms.
269 )))
270
271
272 (((
273 (% style="color:blue" %)**Example 3: **
274 )))
275
276 (((
277 **AT+DI1TODO1= maps value**
278 )))
279
280 (((
281 **AT+DI1TORO1= maps value**
282 )))
283
284 (((
285 **AT+DI2TODO2= maps value**
286 )))
287
288 (((
289 **AT+DI2TORO2= maps value**
290 )))
291
292 (((
293
294 )))
295
296 (% border="1" style="background-color:#f7faff; color:black; width:706px" %)
297 |=(% style="width: 102px;" %)(((
298 Maps value
299 )))|=(% style="width: 331px;" %)(((
300 DIx to DOx
301 )))|=(% style="width: 268px;" %)(((
302 DIx to ROx
303 )))
304 |(% style="width:102px" %)(((
305 0
306 )))|(% style="width:331px" %)(((
307 No Action
308 )))|(% style="width:268px" %)(((
309 No Action
310 )))
311 |(% style="width:102px" %)(((
312 1
313 )))|(% style="width:331px" %)(((
314 If DIx is high, control DOx to output low level, If DIx is low, control DOx to output high level
315 )))|(% style="width:268px" %)(((
316 (((
317 If DIx is high, control ROx to close,
318 )))
319
320 (((
321 if DIx is low, control ROx to open
322 )))
323 )))
324 |(% style="width:102px" %)(((
325 2
326 )))|(% style="width:331px" %)(((
327 If DIx is high, control DOx to output high level, If DIx is low, control DOx to output low level
328 )))|(% style="width:268px" %)(((
329 (((
330 If DIx is high, control ROx to open,
331 )))
332
333 (((
334 if DIx is low, control ROx to close
335 )))
336 )))
337 |(% style="width:102px" %)(((
338 3
339 )))|(% style="width:331px" %)(((
340 DOx state flip
341 )))|(% style="width:268px" %)(((
342 ROx state flip
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 (((
359 **AT+GROUPMOD=1,bb**  Set to the RX group controlled by the TX group, numbered bb(The maximum value of aa is 8)
360 )))
361
362
363 (((
364 **AT+GROUPMOD=0,2**  Set to control the TX group of the two RX groups
365 )))
366
367 (((
368 **AT+GROUPMOD=1,1**  Set the RX group numbered 1
369 )))
370
371 (((
372 **AT+GROUPMOD=1,2**  Set the RX group numbered 2
373 )))
374
375
376 === 2.3.1 TRIG command is configured in the transmit LT. (LT1)(Since firmware 1.3) ===
377
378
379 **AT+TRIGx=a     **Trigger transmit directly without triggering time
380
381 **AT+TRIGx=a,b**  Trigger transmit with triggering time threshold
382
383 **AT+TRIGx=a,b,c **Trigger transmit with triggering time threshold, and continue to transmit every xx seconds if DI status no change.
384
385
386 a=0: falling edge;
387
388 a=1: rising edge;
389
390 a=2: falling edge or rising edge;
391
392 b:  triggering time in milliseconds.
393
394 c: transmit interval
395
396
397 **(% 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)
398
399 Command:
400
401 AT+TRIG1=2,50  Falling edge or rising edge trigger, and the trigger time should exceed 50ms.
402
403
404 **(% style="color:blue" %)Use Case 2: **(%%)Sync LT2 RO / DO status with LT1 every minute.
405
406 Command:
407
408 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.
409
410
411 === 2.3.2 RO/DO is configured in the receiver LT (LT2)(Since firmware 1.3) ===
412
413 AT+DI1TODO1= maps value[,latch time]
414
415 AT+DI1TORO1= maps value[,latch time]
416
417 AT+DI2TODO2= maps value[,latch time]
418
419 AT+DI2TORO2= maps value[,latch time]
420
421
422 (% border="1" style="background-color:#f7faff; color:black; width:706px" %)
423 | **Maps value**|DIx to DOx|DIx to ROx
424 |0|No Action|No Action
425 |1|If DIx is high, control DOx to output low level, If DIx is low, control DOx to output high level|(((
426 If DIx is high, control ROx to close,
427
428 if DIx is low, control ROx to open
429 )))
430 |2|If DIx is high, control DOx to output high level, If DIx is low, control DOx to output low level|(((
431 If DIx is high, control ROx to open,
432
433 if DIx is low, control ROx to close
434 )))
435 |3|DOx state flip|ROx state flip
436
437 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.
438
439
440 **(% style="color:blue" %)Case1**:
441
442 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.
443
444
445 **(% style="color:blue" %)Case2**:
446
447 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.
448
449
450 === 2.3.3 Save the RO/DO status during power off(Since firmware 1.3) ===
451
452
453 Enable/Disbale retain Digital Output/Relay Output after power off / Power On
454
455 AT+DOROSAVE=0 ~/~/ Disable Retain after power off/on
456
457 AT+DOROSAVE=1 ~/~/ Enable Retain after power off/on
458
459 AT+DOROSAVE=2,a,b,c,d ~/~/ set DO/RO port to default state after power on.
460
461 a: for DO1
462
463 b: for DO2
464
465 c: for RO1
466
467 d: for RO2.
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 DI2 can be used to set LT into sleep mode.
477
478 AT+DI2SLEEP=1 ~/~/Enable DI2 as Sleep pin
479
480 AT+DI2SLEEP=0 ~/~/Disable DI2 as Sleep pin
481
482 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.
483
484
485 == **2.4 Data Format** ==
486
487
488 (((
489 8 bytes of GROUPID + 9 bytes of payload + 4 bytes of checksum
490 )))
491
492 (((
493
494 )))
495
496 (((
497 (% style="color:blue" %)**Payload:**
498 )))
499
500 (% border="1" style="background-color:#f7faff; color:black; width:938px" %)
501 |=(% style="width: 123px;" %)(((
502 **Size (bytes)**
503 )))|=(% style="width: 107px;" %)(((
504 1
505 )))|=(% style="width: 107px;" %)(((
506 1
507 )))|=(% style="width: 107px;" %)(((
508 1
509 )))|=(% style="width: 107px;" %)(((
510 1
511 )))|=(% style="width: 107px;" %)(((
512 1
513 )))|=(% style="width: 107px;" %)(((
514 1
515 )))|=(% style="width: 107px;" %)(((
516 1
517 )))|=(% style="width: 107px;" %)(((
518 1
519 )))|=(% style="width: 107px;" %)(((
520 1
521 )))
522 |(% style="width:123px" %)(((
523 **Value**
524 )))|(% style="width:38px" %)(((
525 address
526 )))|(% style="width:70px" %)(((
527 request
528 )))|(% style="width:52px" %)(((
529 ACK
530 )))|(% style="width:127px" %)(((
531 (((
532 DI1&
533 )))
534
535 (((
536 DI1 level
537 )))
538 )))|(% style="width:101px" %)(((
539 DI1TODO1
540 )))|(% style="width:91px" %)(((
541 DI1TORO1
542 )))|(% style="width:111px" %)(((
543 (((
544 DI2&
545 )))
546
547 (((
548 DI2 level
549 )))
550 )))|(% style="width:105px" %)(((
551 DI2TODO2
552 )))|(% style="width:106px" %)(((
553 DI2TORO2
554 )))
555
556 (((
557 (% style="color:#037691" %)**The first byte**(%%)**:**  00 is the broadcast address, 01-08 is the RX group number.
558 )))
559
560 (((
561 (% style="color:#037691" %)**The second byte**(%%)**:**  send mapping request when not 0, not request when it is 0.
562 )))
563
564 (((
565 (% style="color:#037691" %)**The third byte**(%%)**:**  ACK returned to the sender after the mapping is completed.
566 )))
567
568 (((
569 (((
570 (% 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.
571 )))
572 )))
573
574 (((
575 (% style="color:#037691" %)**The Fifth byte**(%%)**:       **DI1TODO1 when the interrupt is triggered, 0 when the interrupt is not triggered.
576 )))
577
578 (((
579 (% style="color:#037691" %)**The Sixth byte**(%%)**:**  0 does not trigger interrupt when DI1TORO1 interrupt is triggered.
580 )))
581
582 (((
583 (((
584 (% 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.
585 )))
586 )))
587
588 (((
589 (% style="color:#037691" %)**The 8th byte**(%%)**:          **DI2TODO2 when the interrupt is triggered, 0 when the interrupt is not triggered.
590 )))
591
592 (((
593 (% style="color:#037691" %)**The 9th byte**(%%)**:**  DI2TORO2 when an interrupt is triggered, 0 when an interrupt is not triggered.
594 )))
595
596 (((
597
598
599 (% style="color:#4f81bd" %)**Payload:（Since firmware 1.3）The receiver replies to the sent packet**
600 )))
601
602 (% border="1" style="background-color:#f7faff; color:black; width:938px" %)
603 |=(% style="width: 123px;" %)(((
604 **Size (bytes)**
605 )))|=(% style="width: 107px;" %)(((
606 1
607 )))|=(% style="width: 107px;" %)(((
608 1
609 )))|=(% style="width: 107px;" %)(((
610 1
611 )))|=(% style="width: 107px;" %)(((
612 1
613 )))|=(% style="width: 107px;" %)(((
614 1
615 )))|=(% style="width: 107px;" %)(((
616 1
617 )))|=(% style="width: 107px;" %)(((
618 1
619 )))|=(% style="width: 107px;" %)(((
620 1
621 )))|=(% style="width: 107px;" %)(((
622 1
623 )))
624 |(% style="width:123px" %)(((
625 **Value**
626 )))|(% style="width:38px" %)(((
627 address
628 )))|(% style="width:70px" %)(((
629 request
630 )))|(% style="width:52px" %)(((
631 ACK
632 )))|(% style="width:127px" %)(((
633 (((
634 DO1&
635 )))
636
637 (((
638 DO1 level
639 )))
640 )))|(% style="width:101px" %)(((
641 DI1TODO1
642 )))|(% style="width:91px" %)(((
643 DI1TORO1
644 )))|(% style="width:111px" %)(((
645 (((
646 RO2&
647 )))
648
649 (((
650 RO2 level
651 )))
652 )))|(% style="width:105px" %)(((
653 DI2TODO2
654 )))|(% style="width:106px" %)(((
655 DI2TORO2
656 )))
657
658 (((
659 (% style="color:#037691" %)**The first byte**(%%)**:**  00 is the broadcast address, 01-08 is the RX group number.
660 )))
661
662 (((
663 (% style="color:#037691" %)**The second byte**(%%)**:**  send mapping request when not 0, not request when it is 0.
664 )))
665
666 (((
667 (% style="color:#037691" %)**The third byte**(%%)**:**  ACK returned to the sender after the mapping is completed.
668 )))
669
670 (((
671 (((
672 (% style="color:#037691" %)**The fourth byte**(%%)**:**  the high four bits are 1 to represent DO1, and the low four bits are the level of DO1 when the interrupt is triggered.
673 )))
674 )))
675
676 (((
677 (% style="color:#037691" %)**The Fifth byte**(%%)**:       **DI1TODO1 when the interrupt is triggered, 0 when the interrupt is not triggered.
678 )))
679
680 (((
681 (% style="color:#037691" %)**The Sixth byte**(%%)**:**  0 does not trigger interrupt when DI1TORO1 interrupt is triggered.
682 )))
683
684 (((
685 (((
686 (% 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.
687 )))
688 )))
689
690 (((
691 (% style="color:#037691" %)**The 8th byte**(%%)**:          **DI2TODO2 when the interrupt is triggered, 0 when the interrupt is not triggered.
692 )))
693
694 (((
695 (% style="color:#037691" %)**The 9th byte**(%%)**:**  DI2TORO2 when an interrupt is triggered, 0 when an interrupt is not triggered.
696 )))
697
698

Applications

Navigation

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