Last modified by Edwin Chen on 2022/11/22 09: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 * [[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 transmit LT. (LT1) and receiver LT (LT2)(Since firmware 1.3.2) ===
407
408
409 (% style="color:red" %)**Notice:**(%%)** **LT1 **MUST** have a AT+DIxTODOx commands to send out the trigger. If LT2 has AT+DIxTOROx configured, LT2 will follow its configured and ignore LT1's AT+DIxTOROx settings.
410
411
412 AT+DI1TODO1= maps value[,latch time, timeout_state]
413
414 AT+DI1TORO1= maps value[,latch time, timeout_state]
415
416 AT+DI2TODO2= maps value[,latch time, timeout_state]
417
418 AT+DI2TORO2= maps value[,latch time, timeout_state]
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 **Timeout_State**:
440
441 0: **No change** after timeout
442
443 1: Change to **DO:0** or **RO: Open** after timeout
444
445 2: Change to **DO:1** or **RO: Close** after timeout
446
447 3: Change **back to state** before last trigger arrive.
448
449
450 (% style="color:blue" %)**Case1**:
451
452 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.
453
454
455 (% style="color:blue" %)**Case2**:
456
457 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.
458
459
460 === 2.3.3 Save the RO/DO status during power off(Since firmware 1.3) ===
461
462
463 Enable/Disbale retain Digital Output/Relay Output after power off / Power On
464
465 **AT+DOROSAVE=0**  ~/~/ Disable Retain after power off/on
466
467 **AT+DOROSAVE=1**  ~/~/ Enable Retain after power off/on
468
469 **AT+DOROSAVE=2,a,b,c,d**  ~/~/ set DO/RO port to default state after power on.
470
471 **a: **for DO1
472
473 **b:** for DO2
474
475 **c: **for RO1
476
477 **d:** for RO2.
478
479
480 **Example:**
481
482 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.
483
484
485 === 2.3.4 Control Sleep status.(Since firmware 1.3) ===
486
487
488 DI2 can be used to set LT into sleep mode.
489
490 **AT+DI2SLEEP=1**  ~/~/  Enable DI2 as Sleep pin
491
492 **AT+DI2SLEEP=0**  ~/~/  Disable DI2 as Sleep pin
493
494 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.
495
496 In sleep mode, DORO will keep its initial state if AT+DOROSAVE=2, otherwise DORO will be in OFF state
497
498
499 == 2.4 Data Format ==
500
501
502 (((
503 8 bytes of GROUPID + 9 bytes of payload + 4 bytes of checksum
504 )))
505
506 (((
507 (% style="color:blue" %)**Payload:Payload triggered by TDC or DI**
508 )))
509
510 (% border="1" style="background-color:#f7faff; color:black; width:825px" %)
511 |=(% style="width: 102px;" %)(((
512 **Size (bytes)**
513 )))|=(% style="width: 74px;" %)(((
514 1
515 )))|=(% style="width: 72px;" %)(((
516 1
517 )))|=(% style="width: 47px;" %)(((
518 1
519 )))|=(% style="width: 83px;" %)(((
520 1
521 )))|=(% style="width: 90px;" %)(((
522 1
523 )))|=(% style="width: 92px;" %)(((
524 1
525 )))|=(% style="width: 78px;" %)(((
526 1
527 )))|=(% style="width: 91px;" %)(((
528 1
529 )))|=(% style="width: 91px;" %)(((
530 1
531 )))
532 |(% style="width:102px" %)(((
533 **Value**
534 )))|(% style="width:74px" %)(((
535 address
536 )))|(% style="width:72px" %)(((
537 request
538 )))|(% style="width:47px" %)(((
539 ACK
540 )))|(% style="width:83px" %)(((
541 (((
542 DI1&
543 DI1 level
544 )))
545 )))|(% style="width:90px" %)(((
546 DI1TODO1
547 )))|(% style="width:92px" %)(((
548 DI1TORO1
549 )))|(% style="width:78px" %)(((
550 (((
551 DI2&
552 DI2 leve
553 )))
554 )))|(% style="width:91px" %)(((
555 DI2TODO2
556 )))|(% style="width:91px" %)(((
557 DI2TORO2
558 )))
559
560 (((
561 (% style="color:#037691" %)**The first byte**(%%)**:**  00 is the broadcast address, 01-08 is the RX group number.
562 )))
563
564 (((
565 (% style="color:#037691" %)**The second byte**(%%)**:**  send mapping request when not 0, not request when it is 0.
566 )))
567
568 (((
569 (% style="color:#037691" %)**The third byte**(%%)**:**  ACK returned to the sender after the mapping is completed.
570 )))
571
572 (((
573 (((
574 (% 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.
575 )))
576 )))
577
578 (((
579 (% style="color:#037691" %)**The Fifth byte**(%%)**:       **DI1TODO1 when the interrupt is triggered, 0 when the interrupt is not triggered.
580 )))
581
582 (((
583 (% style="color:#037691" %)**The Sixth byte**(%%)**:**  0 does not trigger interrupt when DI1TORO1 interrupt is triggered.
584 )))
585
586 (((
587 (((
588 (% 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.
589 )))
590 )))
591
592 (((
593 (% style="color:#037691" %)**The 8th byte**(%%)**:          **DI2TODO2 when the interrupt is triggered, 0 when the interrupt is not triggered.
594 )))
595
596 (((
597 (% style="color:#037691" %)**The 9th byte**(%%)**:**  DI2TORO2 when an interrupt is triggered, 0 when an interrupt is not triggered.
598 )))
599
600 (((
601
602
603 (% style="color:blue" %)**Payload:（Since firmware 1.3）The receiver replies to the sent packet**
604 )))
605
606 (% border="1" style="background-color:#f7faff; color:black; width:822px" %)
607 |=(% style="width: 97px;" %)(((
608 **Size(bytes)**
609 )))|=(% style="width: 71px;" %)(((
610 1
611 )))|=(% style="width: 70px;" %)(((
612 1
613 )))|=(% style="width: 48px;" %)(((
614 1
615 )))|=(% style="width: 85px;" %)(((
616 1
617 )))|=(% style="width: 90px;" %)(((
618 1
619 )))|=(% style="width: 88px;" %)(((
620 1
621 )))|=(% style="width: 86px;" %)(((
622 1
623 )))|=(% style="width: 92px;" %)(((
624 1
625 )))|=(% style="width: 92px;" %)(((
626 1
627 )))
628 |(% style="width:97px" %)(((
629 **Value**
630 )))|(% style="width:71px" %)(((
631 address
632 )))|(% style="width:70px" %)(((
633 request
634 )))|(% style="width:48px" %)(((
635 ACK
636 )))|(% style="width:85px" %)(((
637 (((
638 DOI1&
639 DOI2 level
640 )))
641 )))|(% style="width:90px" %)(((
642 DI1TODO1
643 )))|(% style="width:88px" %)(((
644 DI1TORO1
645 )))|(% style="width:86px" %)(((
646 (((
647 RO2&
648 RO2 level
649 )))
650 )))|(% style="width:92px" %)(((
651 DI2TODO2
652 )))|(% style="width:92px" %)(((
653 DI2TORO2
654 )))
655
656 (((
657 (% style="color:#037691" %)**The first byte**(%%)**:**  00 is the broadcast address, 01-08 is the RX group number.
658 )))
659
660 (((
661 (% style="color:#037691" %)**The second byte**(%%)**:**  send mapping request when not 0, not request when it is 0.
662 )))
663
664 (((
665 (% style="color:#037691" %)**The third byte**(%%)**:**  ACK returned to the sender after the mapping is completed.
666 )))
667
668 (((
669 (((
670 (% 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.
671 )))
672 )))
673
674 (((
675 (% style="color:#037691" %)**The Fifth byte**(%%)**:       **DI1TODO1 when the interrupt is triggered, 0 when the interrupt is not triggered.
676 )))
677
678 (((
679 (% style="color:#037691" %)**The Sixth byte**(%%)**:**  0 does not trigger interrupt when DI1TORO1 interrupt is triggered.
680 )))
681
682 (((
683 (((
684 (% 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.
685 )))
686 )))
687
688 (((
689 (% style="color:#037691" %)**The 8th byte**(%%)**:          **DI2TODO2 when the interrupt is triggered, 0 when the interrupt is not triggered.
690 )))
691
692 (((
693 (% style="color:#037691" %)**The 9th byte**(%%)**:**  DI2TORO2 when an interrupt is triggered, 0 when an interrupt is not triggered.
694 )))
695
696

Applications

Navigation

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