Skip to Content
Version 47.9 by Xiaoling on 2023/05/23 14:12
Show last authors
1 (% style="text-align:center" %)
2 [[image:image-20220606151504-2.jpeg||height="554" width="554"]]
3
4
5
6
7
8
9
10
11
12
13
14 **Table of Contents:**
15
16 {{toc/}}
17
18
19
20
21
22
23 = 1. Introduction =
24
25 == 1.1 ​What is LoRaWAN Soil Moisture & EC Sensor ==
26
27
28 (((
29 The Dragino LSE01 is a (% style="color:#4f81bd" %)**LoRaWAN Soil Moisture & EC Sensor**(%%) for IoT of Agriculture. It is designed to measure the soil moisture of saline-alkali soil and loamy soil. The soil sensor uses FDR method to calculate the soil moisture with the compensation from soil temperature and conductivity. It also has been calibrated in factory for Mineral soil type.
30 )))
31
32 (((
33 It detects (% style="color:#4f81bd" %)**Soil Moisture**(%%), (% style="color:#4f81bd" %)**Soil Temperature**(%%) and (% style="color:#4f81bd" %)**Soil Conductivity**(%%), and uploads the value via wireless to LoRaWAN IoT Server.
34 )))
35
36 (((
37 The LoRa wireless technology used in LES01 allows device to send data and reach extremely long ranges at low data-rates. It provides ultra-long range spread spectrum communication and high interference immunity whilst minimizing current consumption.
38 )))
39
40 (((
41 LES01 is powered by (% style="color:#4f81bd" %)**4000mA or 8500mAh Li-SOCI2 battery**(%%), It is designed for long term use up to 10 years.
42 )))
43
44 (((
45 Each LES01 is pre-load with a set of unique keys for LoRaWAN registrations, register these keys to local LoRaWAN server and it will auto connect after power on.
46 )))
47
48
49 [[image:1654503236291-817.png]]
50
51
52 [[image:1654503265560-120.png]]
53
54
55 == 1.2 ​Features ==
56
57
58 * LoRaWAN 1.0.3 Class A
59 * Ultra low power consumption
60 * Monitor Soil Moisture
61 * Monitor Soil Temperature
62 * Monitor Soil Conductivity
63 * Bands: CN470/EU433/KR920/US915/EU868/AS923/AU915/IN865
64 * AT Commands to change parameters
65 * Uplink on periodically
66 * Downlink to change configure
67 * IP66 Waterproof Enclosure
68 * 4000mAh or 8500mAh Battery for long term use
69
70 == 1.3 Specification ==
71
72
73 Measure Volume: Base on the centra pin of the probe, a cylinder with 7cm diameter and 10cm height.
74
75 (% border="1" cellspacing="5" style="background-color:#f2f2f2; width:520px" %)
76 |(% style="background-color:#d9e2f3; color:#0070c0; width:95px" %)**Parameter**|(% style="background-color:#d9e2f3; color:#0070c0; width:147px" %)**Soil Moisture**|(% style="background-color:#d9e2f3; color:#0070c0; width:138px" %)**Soil Conductivity**|(% style="background-color:#d9e2f3; color:#0070c0; width:140px" %)**Soil Temperature**
77 |(% style="width:95px" %)Range|(% style="width:146px" %)0-100.00%|(% style="width:137px" %)(((
78 0-20000uS/cm
79 (25℃)(0-20.0EC)
80 )))|(% style="width:140px" %)-40.00℃～85.00℃
81 |(% style="width:95px" %)Unit|(% style="width:146px" %)V/V %|(% style="width:137px" %)uS/cm|(% style="width:140px" %)℃
82 |(% style="width:95px" %)Resolution|(% style="width:146px" %)0.01%|(% style="width:137px" %)1 uS/cm|(% style="width:140px" %)0.01℃
83 |(% style="width:95px" %)Accuracy|(% style="width:146px" %)(((
84 ±3% (0-53%)
85 ±5% (>53%)
86 )))|(% style="width:137px" %)2%FS|(% style="width:140px" %)(((
87 -10℃～50℃:<0.3℃
88 All other: <0.6℃
89 )))
90 |(% style="width:95px" %)(((
91 Measure
92 Method
93 )))|(% style="width:146px" %)FDR , with temperature &EC compensate|(% style="width:137px" %)Conductivity , with temperature compensate|(% style="width:140px" %)RTD, and calibrate
94
95 == 1.4 Dimension ==
96
97
98 (% style="color:blue" %)**Main Device Dimension:**
99
100 See LSN50v2 from: [[https:~~/~~/www.dragino.com/downloads/index.php?dir=LSN50-LoRaST/Mechanical_Drawing/ >>https://www.dragino.com/downloads/index.php?dir=LSN50-LoRaST/Mechanical_Drawing/]]
101
102 [[image:image-20221008140228-2.png||height="358" width="571"]]
103
104
105 (% style="color:blue" %)**Probe Dimension**
106
107 [[image:image-20221008135912-1.png]]
108
109
110 == ​1.5 Applications ==
111
112
113 * Smart Agriculture​
114
115 == 1.6 Firmware Change log ==
116
117
118 **LSE01 v1.0 :**  Release
119
120
121 = 2. Configure LSE01 to connect to LoRaWAN network =
122
123 == 2.1 How it works ==
124
125
126 (((
127 The LSE01 is configured as LoRaWAN OTAA Class A mode by default. It has OTAA keys to join LoRaWAN network. To connect a local LoRaWAN network, you need to input the OTAA keys in the LoRaWAN IoT server and power on the LSE0150. It will automatically join the network via OTAA and start to send the sensor value
128 )))
129
130 (((
131 In case you can't set the OTAA keys in the LoRaWAN OTAA server, and you have to use the keys from the server, you can [[use AT Commands >>||anchor="H3.200BUsingtheATCommands"]].
132 )))
133
134
135 == 2.2 ​Quick guide to connect to LoRaWAN server (OTAA) ==
136
137
138 Following is an example for how to join the [[TTN v3 LoRaWAN Network>>url:https://console.cloud.thethings.network/]]. Below is the network structure; we use the [[LG308>>url:http://www.dragino.com/products/lora/item/140-lg308.html]] as a LoRaWAN gateway in this example.
139
140
141 [[image:1654503992078-669.png]]
142
143
144 The LG308 is already set to connected to [[TTN network >>url:https://console.cloud.thethings.network/]], so what we need to now is configure the TTN server.
145
146
147 (% style="color:blue" %)**Step 1**(%%):  Create a device in TTN with the OTAA keys from LSE01.
148
149 Each LSE01 is shipped with a sticker with the default device EUI as below:
150
151 [[image:image-20230426084640-1.png||height="241" width="519"]]
152
153
154 You can enter this key in the LoRaWAN Server portal. Below is TTN screen shot:
155
156 **Add APP EUI in the application**
157
158
159 [[image:1654504596150-405.png]]
160
161
162
163 **Add APP KEY and DEV EUI**
164
165 [[image:1654504683289-357.png]]
166
167
168
169 (% style="color:blue" %)**Step 2**(%%): Power on LSE01
170
171
172 Put a Jumper on JP2 to power on the device. ( The Jumper must be in FLASH position).
173
174 [[image:image-20220606163915-7.png]]
175
176
177 (% style="color:blue" %)**Step 3**(%%)**:** The LSE01 will auto join to the TTN network. After join success, it will start to upload messages to TTN and you can see the messages in the panel.
178
179 [[image:1654504778294-788.png]]
180
181
182 == 2.3 Uplink Payload ==
183
184 === 2.3.1 MOD~=0(Default Mode)(% style="display:none" %) (%%) ===
185
186
187 LSE01 will uplink payload via LoRaWAN with below payload format: 
188
189 (((
190 Uplink payload includes in total 11 bytes.
191 )))
192
193 (% border="1" cellspacing="5" style="background-color:#f2f2f2; width:500px" %)
194 |=**Size(bytes)**|**2**|**2**|**2**|**2**|**2**|**1**
195 |=**Value**|[[BAT>>||anchor="H2.3.3BatteryInfo"]]|(((
196 Temperature
197 (Reserve, Ignore now)
198 )))|[[Soil Moisture>>||anchor="H2.3.4SoilMoisture"]]|[[Soil Temperature>>||anchor="H2.3.5SoilTemperature"]]|[[Soil Conductivity (EC)>>||anchor="H2.3.6SoilConductivity28EC29"]]|(((
199 MOD & Digital Interrupt(Optional)
200 )))
201
202 === 2.3.2 MOD~=1(Original value) ===
203
204
205 This mode can get the original AD value of moisture and original conductivity (with temperature drift compensation).
206
207 (% border="1" cellspacing="5" style="background-color:#f2f2f2; width:500px" %)
208 |=**Size(bytes)**|**2**|**2**|**2**|**2**|**2**|**1**
209 |=**Value**|[[BAT>>||anchor="H2.3.3BatteryInfo"]]|(((
210 Temperature
211 (Reserve, Ignore now)
212 )))|[[Soil Conductivity (EC)>>||anchor="H2.3.6SoilConductivity28EC29"]](raw)|[[Soil Moisture>>||anchor="H2.3.4SoilMoisture"]](raw)|[[Dielectric constant>>||anchor="H2.3.6SoilConductivity28EC29"]](raw)|(((
213 MOD & Digital Interrupt(Optional)
214 )))
215
216 === 2.3.3 Battery Info ===
217
218
219 (((
220 Check the battery voltage for LSE01.
221 )))
222
223 (((
224 Ex1: 0x0B45 = 2885mV
225 )))
226
227 (((
228 Ex2: 0x0B49 = 2889mV
229 )))
230
231
232 === 2.3.4 Soil Moisture ===
233
234
235 (((
236 Get the moisture content of the soil. The value range of the register is 0-10000(Decimal), divide this value by 100 to get the percentage of moisture in the soil.
237 )))
238
239 (((
240 For example, if the data you get from the register is __0x05 0xDC__, the moisture content in the soil is
241 )))
242
243 (((
244
245 )))
246
247 (((
248 (% style="color:#4f81bd" %)**05DC(H) = 1500(D) /100 = 15%.**
249 )))
250
251
252 === 2.3.5 Soil Temperature ===
253
254
255 (((
256 Get the temperature in the soil. The value range of the register is -4000 - +800(Decimal), divide this value by 100 to get the temperature in the soil. For example, if the data you get from the register is 0x09 0xEC, the temperature content in the soil is
257 )))
258
259 (((
260 **Example**:
261 )))
262
263 (((
264 If payload is 0105H: ((0x0105 & 0x8000)>>15 === 0),temp = 0105(H)/100 = 2.61 °C
265 )))
266
267 (((
268 If payload is FF7EH: ((FF7E & 0x8000)>>15 ===1),temp = (FF7E(H)-FFFF(H))/100 = -1.29 °C
269 )))
270
271
272 === 2.3.6 Soil Conductivity (EC) ===
273
274
275 (((
276 Obtain (% style="color:#4f81bd" %)**__soluble salt concentration__**(%%) in soil or (% style="color:#4f81bd" %)**__soluble ion concentration in liquid fertilizer__**(%%) or (% style="color:#4f81bd" %)**__planting medium__**(%%). The value range of the register is 0 - 20000(Decimal)( Can be greater than 20000).
277 )))
278
279 (((
280 For example, if the data you get from the register is 0x00 0xC8, the soil conductivity is 00C8(H) = 200(D) = 200 uS/cm.
281 )))
282
283 (((
284 Generally, the EC value of irrigation water is less than 800uS / cm.
285 )))
286
287 (((
288
289 )))
290
291 === 2.3.7 MOD ===
292
293
294 Firmware version at least v2.1 supports changing mode.
295
296 For example, bytes[10]=90
297
298 mod=(bytes[10]>>7)&0x01=1.
299
300
301 (% style="color:blue" %)**Downlink Command:**
302
303 If payload = 0x0A00, workmode=0
304
305 If** **payload =** **0x0A01, workmode=1
306
307
308 === 2.3.8 ​Decode payload in The Things Network ===
309
310
311 While using TTN network, you can add the payload format to decode the payload.
312
313
314 [[image:1654505570700-128.png]]
315
316 (((
317 The payload decoder function for TTN is here:
318 )))
319
320 (((
321 LSE01 TTN Payload Decoder:  [[https:~~/~~/github.com/dragino/dragino-end-node-decoder/tree/main/LSE01>>https://github.com/dragino/dragino-end-node-decoder/tree/main/LSE01]]
322 )))
323
324 == 2.4 Uplink Interval ==
325
326
327 The LSE01 by default uplink the sensor data every 20 minutes. User can change this interval by AT Command or LoRaWAN Downlink Command. See this link: [[Change Uplink Interval>>doc:Main.End Device AT Commands and Downlink Command.WebHome||anchor="H4.1ChangeUplinkInterval"]]
328
329
330 == 2.5 Downlink Payload ==
331
332
333 By default, LSE01 prints the downlink payload to console port.
334
335 [[image:image-20220606165544-8.png]]
336
337
338 (((
339 (% style="color:blue" %)**Examples:**
340 )))
341
342 (((
343
344 )))
345
346 * (((
347 (% style="color:blue" %)**Set TDC**
348 )))
349
350 (((
351 If the payload=0100003C, it means set the END Node's TDC to 0x00003C=60(S), while type code is 01.
352 )))
353
354 (((
355 Payload:    01 00 00 1E    TDC=30S
356 )))
357
358 (((
359 Payload:    01 00 00 3C    TDC=60S
360 )))
361
362 (((
363
364 )))
365
366 * (((
367 (% style="color:blue" %)**Reset**
368 )))
369
370 (((
371 If payload = 0x04FF, it will reset the LSE01
372 )))
373
374
375 * (% style="color:blue" %)**CFM**
376
377 Downlink Payload: 05000001, Set AT+CFM=1 or 05000000 , set AT+CFM=0
378
379
380 == 2.6 ​Show Data in DataCake IoT Server ==
381
382
383 (((
384 [[DATACAKE>>url:https://datacake.co/]] provides a human friendly interface to show the sensor data, once we have data in TTN, we can use [[DATACAKE>>url:https://datacake.co/]] to connect to TTN and see the data in DATACAKE. Below are the steps:
385 )))
386
387 (((
388
389 )))
390
391 (((
392 (% style="color:blue" %)**Step 1**(%%):  Be sure that your device is programmed and properly connected to the network at this time.
393 )))
394
395 (((
396 (% style="color:blue" %)**Step 2**(%%):  To configure the Application to forward data to DATACAKE you will need to add integration. To add the DATACAKE integration, perform the following steps:
397 )))
398
399
400 [[image:1654505857935-743.png]]
401
402
403 [[image:1654505874829-548.png]]
404
405
406 (% style="color:blue" %)**Step 3**(%%)**:**  Create an account or log in Datacake.
407
408 (% style="color:blue" %)**Step 4**(%%)**:**  Search the LSE01 and add DevEUI.
409
410
411 [[image:1654505905236-553.png]]
412
413
414 After added, the sensor data arrive TTN, it will also arrive and show in Mydevices.
415
416 [[image:1654505925508-181.png]]
417
418
419 == 2.7 Frequency Plans ==
420
421
422 The LSE01 uses OTAA mode and below frequency plans by default. If user want to use it with different frequency plan, please refer the AT command sets.
423
424
425 === 2.7.1 EU863-870 (EU868) ===
426
427
428 (% style="color:#037691" %)** Uplink:**
429
430 868.1 - SF7BW125 to SF12BW125
431
432 868.3 - SF7BW125 to SF12BW125 and SF7BW250
433
434 868.5 - SF7BW125 to SF12BW125
435
436 867.1 - SF7BW125 to SF12BW125
437
438 867.3 - SF7BW125 to SF12BW125
439
440 867.5 - SF7BW125 to SF12BW125
441
442 867.7 - SF7BW125 to SF12BW125
443
444 867.9 - SF7BW125 to SF12BW125
445
446 868.8 - FSK
447
448
449 (% style="color:#037691" %)** Downlink:**
450
451 Uplink channels 1-9 (RX1)
452
453 869.525 - SF9BW125 (RX2 downlink only)
454
455
456 === 2.7.2 US902-928(US915) ===
457
458
459 Used in USA, Canada and South America. Default use CHE=2
460
461 (% style="color:#037691" %)**Uplink:**
462
463 903.9 - SF7BW125 to SF10BW125
464
465 904.1 - SF7BW125 to SF10BW125
466
467 904.3 - SF7BW125 to SF10BW125
468
469 904.5 - SF7BW125 to SF10BW125
470
471 904.7 - SF7BW125 to SF10BW125
472
473 904.9 - SF7BW125 to SF10BW125
474
475 905.1 - SF7BW125 to SF10BW125
476
477 905.3 - SF7BW125 to SF10BW125
478
479
480 (% style="color:#037691" %)**Downlink:**
481
482 923.3 - SF7BW500 to SF12BW500
483
484 923.9 - SF7BW500 to SF12BW500
485
486 924.5 - SF7BW500 to SF12BW500
487
488 925.1 - SF7BW500 to SF12BW500
489
490 925.7 - SF7BW500 to SF12BW500
491
492 926.3 - SF7BW500 to SF12BW500
493
494 926.9 - SF7BW500 to SF12BW500
495
496 927.5 - SF7BW500 to SF12BW500
497
498 923.3 - SF12BW500(RX2 downlink only)
499
500
501 === 2.7.3 CN470-510 (CN470) ===
502
503
504 Used in China, Default use CHE=1
505
506 (% style="color:#037691" %)**Uplink:**
507
508 486.3 - SF7BW125 to SF12BW125
509
510 486.5 - SF7BW125 to SF12BW125
511
512 486.7 - SF7BW125 to SF12BW125
513
514 486.9 - SF7BW125 to SF12BW125
515
516 487.1 - SF7BW125 to SF12BW125
517
518 487.3 - SF7BW125 to SF12BW125
519
520 487.5 - SF7BW125 to SF12BW125
521
522 487.7 - SF7BW125 to SF12BW125
523
524
525 (% style="color:#037691" %)**Downlink:**
526
527 506.7 - SF7BW125 to SF12BW125
528
529 506.9 - SF7BW125 to SF12BW125
530
531 507.1 - SF7BW125 to SF12BW125
532
533 507.3 - SF7BW125 to SF12BW125
534
535 507.5 - SF7BW125 to SF12BW125
536
537 507.7 - SF7BW125 to SF12BW125
538
539 507.9 - SF7BW125 to SF12BW125
540
541 508.1 - SF7BW125 to SF12BW125
542
543 505.3 - SF12BW125 (RX2 downlink only)
544
545
546 === 2.7.4 AU915-928(AU915) ===
547
548
549 Default use CHE=2
550
551 (% style="color:#037691" %)**Uplink:**
552
553 916.8 - SF7BW125 to SF12BW125
554
555 917.0 - SF7BW125 to SF12BW125
556
557 917.2 - SF7BW125 to SF12BW125
558
559 917.4 - SF7BW125 to SF12BW125
560
561 917.6 - SF7BW125 to SF12BW125
562
563 917.8 - SF7BW125 to SF12BW125
564
565 918.0 - SF7BW125 to SF12BW125
566
567 918.2 - SF7BW125 to SF12BW125
568
569
570 (% style="color:#037691" %)**Downlink:**
571
572 923.3 - SF7BW500 to SF12BW500
573
574 923.9 - SF7BW500 to SF12BW500
575
576 924.5 - SF7BW500 to SF12BW500
577
578 925.1 - SF7BW500 to SF12BW500
579
580 925.7 - SF7BW500 to SF12BW500
581
582 926.3 - SF7BW500 to SF12BW500
583
584 926.9 - SF7BW500 to SF12BW500
585
586 927.5 - SF7BW500 to SF12BW500
587
588 923.3 - SF12BW500(RX2 downlink only)
589
590
591 === 2.7.5 AS920-923 & AS923-925 (AS923) ===
592
593
594 (% style="color:#037691" %)**Default Uplink channel:**
595
596 923.2 - SF7BW125 to SF10BW125
597
598 923.4 - SF7BW125 to SF10BW125
599
600
601 (% style="color:#037691" %)**Additional Uplink Channel**:
602
603 (OTAA mode, channel added by JoinAccept message)
604
605 (% style="color:#037691" %)**AS920~~AS923 for Japan, Malaysia, Singapore**:
606
607 922.2 - SF7BW125 to SF10BW125
608
609 922.4 - SF7BW125 to SF10BW125
610
611 922.6 - SF7BW125 to SF10BW125
612
613 922.8 - SF7BW125 to SF10BW125
614
615 923.0 - SF7BW125 to SF10BW125
616
617 922.0 - SF7BW125 to SF10BW125
618
619
620 (% style="color:#037691" %)**AS923 ~~ AS925 for Brunei, Cambodia, Hong Kong, Indonesia, Laos, Taiwan, Thailand, Vietnam**:
621
622 923.6 - SF7BW125 to SF10BW125
623
624 923.8 - SF7BW125 to SF10BW125
625
626 924.0 - SF7BW125 to SF10BW125
627
628 924.2 - SF7BW125 to SF10BW125
629
630 924.4 - SF7BW125 to SF10BW125
631
632 924.6 - SF7BW125 to SF10BW125
633
634
635 (% style="color:#037691" %)** Downlink:**
636
637 Uplink channels 1-8 (RX1)
638
639 923.2 - SF10BW125 (RX2)
640
641
642 === 2.7.6 KR920-923 (KR920) ===
643
644
645 Default channel:
646
647 922.1 - SF7BW125 to SF12BW125
648
649 922.3 - SF7BW125 to SF12BW125
650
651 922.5 - SF7BW125 to SF12BW125
652
653
654 (% style="color:#037691" %)**Uplink: (OTAA mode, channel added by JoinAccept message)**
655
656 922.1 - SF7BW125 to SF12BW125
657
658 922.3 - SF7BW125 to SF12BW125
659
660 922.5 - SF7BW125 to SF12BW125
661
662 922.7 - SF7BW125 to SF12BW125
663
664 922.9 - SF7BW125 to SF12BW125
665
666 923.1 - SF7BW125 to SF12BW125
667
668 923.3 - SF7BW125 to SF12BW125
669
670
671 (% style="color:#037691" %)**Downlink:**
672
673 Uplink channels 1-7(RX1)
674
675 921.9 - SF12BW125 (RX2 downlink only; SF12BW125 might be changed to SF9BW125)
676
677
678 === 2.7.7 IN865-867 (IN865) ===
679
680
681 (% style="color:#037691" %)** Uplink:**
682
683 865.0625 - SF7BW125 to SF12BW125
684
685 865.4025 - SF7BW125 to SF12BW125
686
687 865.9850 - SF7BW125 to SF12BW125
688
689
690 (% style="color:#037691" %) **Downlink:**
691
692 Uplink channels 1-3 (RX1)
693
694 866.550 - SF10BW125 (RX2)
695
696
697 == 2.8 LED Indicator ==
698
699
700 The LSE01 has an internal LED which is to show the status of different state.
701
702 * Blink once when device power on.
703 * Solid ON for 5 seconds once device successful Join the network.
704 * Blink once when device transmit a packet.
705
706 == 2.9 Installation in Soil ==
707
708
709 **Measurement the soil surface**
710
711
712 [[image:1654506634463-199.png]] ​
713
714
715 (((
716 (((
717 Choose the proper measuring position. Avoid the probe to touch rocks or hard things. Split the surface soil according to the measured deep. Keep the measured as original density. Vertical insert the probe into the soil to be measured. Make sure not shake when inserting.
718 )))
719 )))
720
721
722
723 [[image:1654506665940-119.png]]
724
725
726 (((
727 Dig a hole with diameter > 20CM.
728 )))
729
730 (((
731 Horizontal insert the probe to the soil and fill the hole for long term measurement.
732 )))
733
734
735 == 2.10 ​Firmware Change Log ==
736
737
738 (((
739 **Firmware download link:  **[[https:~~/~~/www.dropbox.com/sh/8ixj7zgt477ip51/AADLrib9Oe6IuOpPF5o1GPf9a?dl=0>>https://www.dropbox.com/sh/8ixj7zgt477ip51/AADLrib9Oe6IuOpPF5o1GPf9a?dl=0]]
740 )))
741
742 (((
743 **Firmware Upgrade Method: **[[Firmware Upgrade Instruction>>doc:Main.Firmware Upgrade Instruction for STM32 base products.WebHome]]
744 )))
745
746 (((
747
748 )))
749
750 (((
751 **V1.0.**
752 )))
753
754 (((
755 Release
756 )))
757
758
759 == 2.11 Battery & Power Consumption ==
760
761
762 LSE01 uses ER26500 + SPC1520 battery pack. See below link for detail information about the battery info and how to replace.
763
764 [[**Battery Info & Power Consumption Analyze**>>url:http://wiki.dragino.com/xwiki/bin/view/Main/How%20to%20calculate%20the%20battery%20life%20of%20Dragino%20sensors%3F/]] .
765
766
767 = 3. ​Using the AT Commands =
768
769 == 3.1 Access AT Commands ==
770
771
772 LSE01 supports AT Command set in the stock firmware. You can use a USB to TTL adapter to connect to LSE01 for using AT command, as below.
773
774
775 [[image:1654501986557-872.png||height="391" width="800"]]
776
777
778 Or if you have below board, use below connection:
779
780
781 [[image:1654502005655-729.png||height="503" width="801"]]
782
783
784 In the PC, you need to set the serial baud rate to (% style="color:green" %)**9600**(%%) to access the serial console for LSE01. LSE01 will output system info once power on as below:
785
786
787 [[image:1654502050864-459.png||height="564" width="806"]]
788
789
790 Below are the available commands, a more detailed AT Command manual can be found at [[AT Command Manual>>https://www.dropbox.com/sh/qr6vproz4z4kzjz/AAAD48h3OyWrU1hq_Cqm8jIwa?dl=0]].
791
792
793 (% style="background-color:#dcdcdc" %)**AT+<CMD>? **(%%) : Help on <CMD>
794
795 (% style="background-color:#dcdcdc" %)**AT+<CMD> **(%%) : Run <CMD>
796
797 (% style="background-color:#dcdcdc" %)**AT+<CMD>=<value>**(%%)  : Set the value
798
799 (% style="background-color:#dcdcdc" %)**AT+<CMD>=?**(%%)  : Get the value
800
801
802 (% style="color:#037691" %)**General Commands**(%%)      
803
804 (% style="background-color:#dcdcdc" %)**AT**(%%)  : Attention       
805
806 (% style="background-color:#dcdcdc" %)**AT?**(%%)  : Short Help     
807
808 (% style="background-color:#dcdcdc" %)**ATZ**(%%)  : MCU Reset    
809
810 (% style="background-color:#dcdcdc" %)**AT+TDC**(%%)  : Application Data Transmission Interval 
811
812
813 (% style="color:#037691" %)**Keys, IDs and EUIs management**
814
815 (% style="background-color:#dcdcdc" %)**AT+APPEUI**(%%)              : Application EUI      
816
817 (% style="background-color:#dcdcdc" %)**AT+APPKEY**(%%)              : Application Key     
818
819 (% style="background-color:#dcdcdc" %)**AT+APPSKEY**(%%)            : Application Session Key
820
821 (% style="background-color:#dcdcdc" %)**AT+DADDR**(%%)              : Device Address     
822
823 (% style="background-color:#dcdcdc" %)**AT+DEUI**(%%)                   : Device EUI     
824
825 (% style="background-color:#dcdcdc" %)**AT+NWKID**(%%)               : Network ID (You can enter this command change only after successful network connection) 
826
827 (% style="background-color:#dcdcdc" %)**AT+NWKSKEY**(%%)          : Network Session Key Joining and sending date on LoRa network  
828
829 (% style="background-color:#dcdcdc" %)**AT+CFM**(%%)  : Confirm Mode       
830
831 (% style="background-color:#dcdcdc" %)**AT+CFS**(%%)                     : Confirm Status       
832
833 (% style="background-color:#dcdcdc" %)**AT+JOIN**(%%)  : Join LoRa? Network       
834
835 (% style="background-color:#dcdcdc" %)**AT+NJM**(%%)  : LoRa? Network Join Mode    
836
837 (% style="background-color:#dcdcdc" %)**AT+NJS**(%%)                     : LoRa? Network Join Status    
838
839 (% style="background-color:#dcdcdc" %)**AT+RECV**(%%)                  : Print Last Received Data in Raw Format
840
841 (% style="background-color:#dcdcdc" %)**AT+RECVB**(%%)                : Print Last Received Data in Binary Format      
842
843 (% style="background-color:#dcdcdc" %)**AT+SEND**(%%)                  : Send Text Data      
844
845 (% style="background-color:#dcdcdc" %)**AT+SENB**(%%)                  : Send Hexadecimal Data
846
847
848 (% style="color:#037691" %)**LoRa Network Management**
849
850 (% style="background-color:#dcdcdc" %)**AT+ADR**(%%)          : Adaptive Rate
851
852 (% style="background-color:#dcdcdc" %)**AT+CLASS**(%%)  : LoRa Class(Currently only support class A
853
854 (% style="background-color:#dcdcdc" %)**AT+DCS**(%%)  : Duty Cycle Setting 
855
856 (% style="background-color:#dcdcdc" %)**AT+DR**(%%)  : Data Rate (Can Only be Modified after ADR=0)     
857
858 (% style="background-color:#dcdcdc" %)**AT+FCD**(%%)  : Frame Counter Downlink       
859
860 (% style="background-color:#dcdcdc" %)**AT+FCU**(%%)  : Frame Counter Uplink   
861
862 (% style="background-color:#dcdcdc" %)**AT+JN1DL**(%%)  : Join Accept Delay1
863
864 (% style="background-color:#dcdcdc" %)**AT+JN2DL**(%%)  : Join Accept Delay2
865
866 (% style="background-color:#dcdcdc" %)**AT+PNM**(%%)  : Public Network Mode   
867
868 (% style="background-color:#dcdcdc" %)**AT+RX1DL**(%%)  : Receive Delay1      
869
870 (% style="background-color:#dcdcdc" %)**AT+RX2DL**(%%)  : Receive Delay2      
871
872 (% style="background-color:#dcdcdc" %)**AT+RX2DR**(%%)  : Rx2 Window Data Rate 
873
874 (% style="background-color:#dcdcdc" %)**AT+RX2FQ**(%%)  : Rx2 Window Frequency
875
876 (% style="background-color:#dcdcdc" %)**AT+TXP**(%%)  : Transmit Power
877
878 (% style="background-color:#dcdcdc" %)**AT+ MOD**(%%)  : Set work mode
879
880
881 (% style="color:#037691" %)**Information** 
882
883 (% style="background-color:#dcdcdc" %)**AT+RSSI**(%%)           : RSSI of the Last Received Packet   
884
885 (% style="background-color:#dcdcdc" %)**AT+SNR**(%%)           : SNR of the Last Received Packet   
886
887 (% style="background-color:#dcdcdc" %)**AT+VER**(%%)           : Image Version and Frequency Band       
888
889 (% style="background-color:#dcdcdc" %)**AT+FDR**(%%)           : Factory Data Reset
890
891 (% style="background-color:#dcdcdc" %)**AT+PORT**(%%)  : Application Port    
892
893 (% style="background-color:#dcdcdc" %)**AT+CHS**(%%)  : Get or Set Frequency (Unit: Hz) for Single Channel Mode
894
895 (% style="background-color:#dcdcdc" %)**AT+CHE**(%%)  : Get or Set eight channels mode, Only for US915, AU915, CN470
896
897
898 = ​4. FAQ =
899
900 == 4.1 ​How to change the LoRa Frequency Bands/Region? ==
901
902
903 (((
904 You can follow the instructions for [[how to upgrade image>>||anchor="H2.10200BFirmwareChangeLog"]].
905 When downloading the images, choose the required image file for download. ​
906 )))
907
908 (((
909
910 )))
911
912 (((
913 How to set up LSE01 to work in 8 channel mode By default, the frequency bands US915, AU915, CN470 work in 72 frequencies. Many gateways are 8 channel gateways, and in this case, the OTAA join time and uplink schedule is long and unpredictable while the end node is hopping in 72 frequencies.
914 )))
915
916 (((
917
918 )))
919
920 (((
921 You can configure the end node to work in 8 channel mode by using the AT+CHE command. The 500kHz channels are always included for OTAA.
922 )))
923
924 (((
925
926 )))
927
928 (((
929 For example, in **US915** band, the frequency table is as below. By default, the end node will use all channels (0~~71) for OTAA Join process. After the OTAA Join, the end node will use these all channels (0~~71) to send uplink packets.
930 )))
931
932 [[image:image-20220606154726-3.png]]
933
934
935 When you use the TTN network, the US915 frequency bands use are:
936
937 * 903.9 - SF7BW125 to SF10BW125
938 * 904.1 - SF7BW125 to SF10BW125
939 * 904.3 - SF7BW125 to SF10BW125
940 * 904.5 - SF7BW125 to SF10BW125
941 * 904.7 - SF7BW125 to SF10BW125
942 * 904.9 - SF7BW125 to SF10BW125
943 * 905.1 - SF7BW125 to SF10BW125
944 * 905.3 - SF7BW125 to SF10BW125
945 * 904.6 - SF8BW500
946
947 (((
948 Because the end node is now hopping in 72 frequency, it makes it difficult for the devices to Join the TTN network and uplink data. To solve this issue, you can access the device via the AT commands and run:
949
950 * (% style="color:#037691" %)**AT+CHE=2**
951 * (% style="color:#037691" %)**ATZ**
952 )))
953
954 (((
955
956
957 to set the end node to work in 8 channel mode. The device will work in Channel 8-15 & 64-71 for OTAA, and channel 8-15 for Uplink.
958 )))
959
960 (((
961
962 )))
963
964 (((
965 The **AU915** band is similar. Below are the AU915 Uplink Channels.
966 )))
967
968 [[image:image-20220606154825-4.png]]
969
970
971 == 4.2 ​Can I calibrate LSE01 to different soil types? ==
972
973
974 (((
975 LSE01 is calibrated for saline-alkali soil and loamy soil. If users want to use it for other soil, they can calibrate the value in the IoT platform base on the value measured by saline-alkali soil and loamy soil. The formula can be found at [[this link>>https://www.dragino.com/downloads/index.php?dir=LoRa_End_Node/LSE01/&file=Calibrate_to_other_Soil_20220605.pdf]].
976 )))
977
978
979 = 5. Trouble Shooting =
980
981 == 5.1 ​Why I can't join TTN in US915 / AU915 bands? ==
982
983
984 It is due to channel mapping. Please see the [[Eight Channel Mode>>doc:Main.End Device AT Commands and Downlink Command.WebHome||anchor="H7.19EightChannelMode"]] section above for details.
985
986
987 == 5.2 AT Command input doesn't work ==
988
989
990 (((
991 In the case if user can see the console output but can't type input to the device. Please check if you already include the (% style="color:green" %)**ENTER**(%%) while sending out the command. Some serial tool doesn't send (% style="color:green" %)**ENTER**(%%) while press the send key, user need to add ENTER in their string.
992 )))
993
994
995 == 5.3 Device rejoin in at the second uplink packet ==
996
997
998 (% style="color:#4f81bd" %)**Issue describe as below:**
999
1000 [[image:1654500909990-784.png]]
1001
1002
1003 (% style="color:#4f81bd" %)**Cause for this issue:**
1004
1005 (((
1006 The fuse on LSE01 is not large enough, some of the soil probe require large current up to 5v 800mA, in a short pulse. When this happen, it cause the device reboot so user see rejoin.
1007 )))
1008
1009
1010 (% style="color:#4f81bd" %)**Solution: **
1011
1012 (((
1013 All new shipped LSE01 after 2020-May-30 will have this to fix. For the customer who see this issue, please bypass the fuse as below:
1014 )))
1015
1016 [[image:1654500929571-736.png||height="458" width="832"]]
1017
1018
1019 = 6. ​Order Info =
1020
1021
1022 Part Number**:** (% style="color:#4f81bd" %)**LSE01-XX-YY**
1023
1024
1025 (% style="color:#4f81bd" %)**XX**(%%)**:** The default frequency band
1026
1027 * (% style="color:red" %)**AS923**(%%): LoRaWAN AS923 band
1028 * (% style="color:red" %)**AU915**(%%): LoRaWAN AU915 band
1029 * (% style="color:red" %)**EU433**(%%): LoRaWAN EU433 band
1030 * (% style="color:red" %)**EU868**(%%): LoRaWAN EU868 band
1031 * (% style="color:red" %)**KR920**(%%): LoRaWAN KR920 band
1032 * (% style="color:red" %)**US915**(%%): LoRaWAN US915 band
1033 * (% style="color:red" %)**IN865**(%%):  LoRaWAN IN865 band
1034 * (% style="color:red" %)**CN470**(%%): LoRaWAN CN470 band
1035
1036 (% style="color:#4f81bd" %)**YY**(%%)**: **Battery Option
1037
1038 * (% style="color:red" %)**4**(%%): 4000mAh battery
1039 * (% style="color:red" %)**8**(%%): 8500mAh battery
1040
1041 (% class="wikigeneratedid" %)
1042 (((
1043
1044
1045
1046 )))
1047
1048 = 7. Packing Info =
1049
1050 (((
1051
1052
1053 (% style="color:#037691" %)**Package Includes**:
1054 )))
1055
1056 * (((
1057 LSE01 LoRaWAN Soil Moisture & EC Sensor x 1
1058 )))
1059
1060 (((
1061
1062
1063 (% style="color:#037691" %)**Dimension and weight**:
1064 )))
1065
1066 * (((
1067 Device Size: cm
1068 )))
1069 * (((
1070 Device Weight: g
1071 )))
1072 * (((
1073 Package Size / pcs : cm
1074 )))
1075 * (((
1076 Weight / pcs : g
1077
1078
1079
1080 )))
1081
1082 = 8. Support =
1083
1084
1085 * Support is provided Monday to Friday, from 09:00 to 18:00 GMT+8. Due to different timezones we cannot offer live support. However, your questions will be answered as soon as possible in the before-mentioned schedule.
1086 * Provide as much information as possible regarding your enquiry (product models, accurately describe your problem and steps to replicate it etc) and send a mail to [[support@dragino.com>>url:http://../../../../../../D:%5C%E5%B8%82%E5%9C%BA%E8%B5%84%E6%96%99%5C%E8%AF%B4%E6%98%8E%E4%B9%A6%5CLoRa%5CLT%E7%B3%BB%E5%88%97%5Csupport@dragino.com]]