Show last authors
1
2
3 (% style="text-align:center" %)
4 [[image:1655254599445-662.png]]
5
6
7
8
9
10
11 **Table of Contents:**
12
13 {{toc/}}
14
15
16
17
18
19
20
21 = 1.  Introduction =
22
23 == 1.1 ​ What is LoRaWAN Ultrasonic liquid level Sensor ==
24
25 (((
26
27
28 (((
29 (((
30 (((
31 The Dragino LDDS20 is a (% style="color:#4472c4" %)**LoRaWAN Ultrasonic liquid level sensor**(%%) for Internet of Things solution. It uses (% style="color:#4472c4" %)**none-contact method **(%%)to measure the height of liquid in a container without opening the container, and send the value via LoRaWAN network to IoT Server
32 )))
33
34 (((
35 The LDDS20 sensor is installed directly below the container to detect the height of the liquid level. User doesn't need to open a hole on the container to be tested. The (% style="color:#4472c4" %)**none-contact measurement makes the measurement safety, easier and possible for some strict situation**. 
36 )))
37
38 (((
39 LDDS20 uses ultrasonic sensing technology for distance measurement. LDDS20 is of high accuracy to measure various liquid such as: (% style="color:#4472c4" %)**toxic substances**(%%), (% style="color:#4472c4" %)**strong acids**(%%), (% style="color:#4472c4" %)**strong alkalis**(%%) and (% style="color:#4472c4" %)**various pure liquids**(%%) in high-temperature and high-pressure airtight containers.
40 )))
41
42 (((
43 The LoRa wireless technology used in LDDS20 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.
44 )))
45
46 (((
47 LDDS20 is powered by (% style="color:#4472c4" %)**8500mA Li-SOCI2 battery**(%%); It is designed for long term use up to 10 years*.
48 )))
49
50 (((
51 Each LDDS20 pre-loads with a set of unique keys for LoRaWAN registrations, register these keys to local LoRaWAN server and it will auto connect if there is network coverage, after power on.
52 )))
53 )))
54
55 (((
56 (((
57 (% style="color:#4472c4" %) * (%%)Actually lifetime depends on network coverage and uplink interval and other factors.
58 )))
59 )))
60 )))
61 )))
62
63
64 [[image:1655255122126-327.png]]
65
66
67 == ​1.2  Features ==
68
69
70 * LoRaWAN 1.0.3 Class A
71 * Ultra low power consumption
72 * Liquid Level Measurement by Ultrasonic technology
73 * Measure through container, No need to contact Liquid.
74 * Valid level range 20mm - 2000mm
75 * Accuracy: ±(5mm+S*0.5%) (S: Measure Value)
76 * Cable Length : 25cm
77 * Bands: CN470/EU433/KR920/US915/EU868/AS923/AU915/IN865
78 * AT Commands to change parameters
79 * Uplink on periodically
80 * Downlink to change configure
81 * IP66 Waterproof Enclosure
82 * 8500mAh Battery for long term use
83
84 == 1.3  Suitable Container & Liquid ==
85
86
87 * Solid Wall container such as: steel, iron, glass, ceramics, non-foaming plastics etc.
88 * Container shape is regular, and surface is smooth.
89 * Container Thickness:
90 ** Pure metal material.  2~~8mm, best is 3~~5mm
91 ** Pure non metal material: <10 mm
92 * Pure liquid without irregular deposition.(% style="display:none" %)
93
94 == 1.4  Mechanical ==
95
96
97 [[image:image-20220615090910-1.png]]
98
99
100 [[image:image-20220615090910-2.png]]
101
102 (% style="display:none" %) (%%)
103
104 == 1.5  Install LDDS20 ==
105
106
107 (% style="color:blue" %)**Step 1**(%%):  Choose the installation point.
108
109 LDDS20 (% style="color:red" %)**MUST**(%%) be installed on the container bottom middle position.
110
111
112 [[image:image-20220615091045-3.png]]
113
114
115
116 (((
117 (% style="color:blue" %)**Step 2**(%%):  Polish the installation point.
118 )))
119
120 (((
121 For Metal Surface with paint, it is important to polish the surface, first use crude sand paper to polish the paint level , then use exquisite sand paper to polish the metal level to make it shine & smooth.
122 )))
123
124 [[image:image-20220615092010-11.png]]
125
126
127 No polish needed if the container is shine metal surface without paint or non-metal container.
128
129 [[image:image-20220615092044-12.png]]
130
131
132
133 (((
134 (% style="color:blue" %)**Step3:   **(%%)Test the installation point.
135 )))
136
137 (((
138 Power on LDDS20, check if the blue LED is on, If the blue LED is on, means the sensor works. Then put ultrasonic coupling paste on the sensor and put it tightly on the installation point.
139 )))
140
141 (((
142
143 )))
144
145 (((
146 It is necessary to put the coupling paste between the sensor and the container, otherwise LDDS20 won't detect the liquid level.
147 )))
148
149 [[image:1655256160324-178.png||height="151" width="419"]][[image:image-20220615092327-13.png||height="146" width="260"]]
150
151
152 (((
153 After paste the LDDS20 well, power on LDDS20. In the first 30 seconds of booting, device will check the sensors status and BLUE LED will show the status as below. After 30 seconds, BLUE LED will be off to save battery life.
154 )))
155
156 (((
157
158 )))
159
160 (((
161 (% style="color:red" %)**LED Status:**
162 )))
163
164 * (((
165 Onboard LED: When power on device, the onboard LED will fast blink 4 times which means detect the sensor well.
166 )))
167
168 * (((
169 (% style="color:blue" %)**BLUE LED**(% style="color:red" %)** always ON**(%%): Sensor is power on but doesn't detect liquid. There is problem in installation point.
170 )))
171 * (((
172 (% style="color:blue" %)**BLUE LED**(% style="color:red" %)** slowly blinking**(%%): Sensor detects Liquid Level, The installation point is good.
173 )))
174
175 (((
176 LDDS20 will enter into low power mode at 30 seconds after system reset or power on, Blue LED will be off after that.
177 )))
178
179 (((
180
181 )))
182
183 (((
184 (% style="color:red" %)**Note 2:**
185 )))
186
187 (((
188 (% style="color:red" %)**Ultrasonic coupling paste** (%%) is subjected in most shipping way. So the default package doesn't include it and user needs to purchase locally.
189 )))
190
191 (((
192
193 )))
194
195 (((
196
197 )))
198
199 (((
200 (% style="color:blue" %)**Step4:   **(%%)Install use Epoxy ab glue.
201
202 After ensuring that the ultrasonic coupling paste is applied to the sensor and adheres closely to the mounting point, and the sensor can work normally, add AB epoxy glue.
203
204 ((% style="color:red" %)**Note:**(%%) The ultrasonic coupling agent is used to help the sensor detect the liquid in the container, and the epoxy AB glue is used to fix the probe. Both need to be used at the same time.)
205 )))
206
207 (((
208 Prepare Eproxy AB glue.
209 )))
210
211 (((
212 Put Eproxy AB glue in the sensor and press it hard on the container installation point.
213 )))
214
215 (((
216 Reset LDDS20 and see if the BLUE LED is slowly blinking.
217 )))
218
219 [[image:image-20220615091045-8.png||height="203" width="341"]] [[image:image-20220615091045-9.png||height="200" width="284"]]
220
221
222 (((
223 (% style="color:red" %)**Note 1:**
224 )))
225
226 (((
227 Eproxy AB glue needs 3~~ 5 minutes to stable attached. we can use other glue material to keep it in the position.
228 )))
229
230 (((
231
232 )))
233
234 (((
235 (% style="color:red" %)**Note 2:**
236 )))
237
238 (((
239 (% style="color:red" %)**Epoxy AB glue**(%%) is subjected in most shipping way. So the default package doesn't include it and user needs to purchase locally.
240 )))
241
242
243 == 1.6 ​ Applications ==
244
245
246 * Smart liquid control solution.
247 * Smart liquefied gas solution.(% style="display:none" %)
248
249 == 1.7  Precautions ==
250
251
252 * At room temperature, containers of different materials, such as steel, glass, iron, ceramics, non-foamed plastics and other dense materials, have different detection blind areas and detection limit heights.
253 * For containers of the same material at room temperature, the detection blind zone and detection limit height are also different for the thickness of the container.
254 * When the detected liquid level exceeds the effective detection value of the sensor, and the liquid level of the liquid to be measured shakes or tilts, the detected liquid height is unstable.(% style="display:none" %)
255
256 == 1.8  Pin mapping and power on ==
257
258
259 [[image:1655257026882-201.png]]
260
261
262 = 2.  Configure LDDS20 to connect to LoRaWAN network =
263
264 == 2.1  How it works ==
265
266
267 (((
268 The LDDS20 is configured as LoRaWAN OTAA Class A mode by default. It has OTAA keys to join LoRaWAN network. To connect a LoRaWAN network, you need to input the OTAA keys in the LoRaWAN IoT server and power on the LDDS20. If there is coverage of the LoRaWAN network, it will automatically join the network via OTAA and start to send the sensor value.
269 )))
270
271 (((
272 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.A0UsingtheATCommands"]]to set the keys in the LDDS20.
273 )))
274
275
276 == 2.2  ​Quick guide to connect to LoRaWAN server (OTAA) ==
277
278
279 (((
280 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.
281
282
283 )))
284
285 (((
286 [[image:1655257698953-697.png]]
287
288
289 )))
290
291 (((
292 (((
293 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.
294 )))
295 )))
296
297 (((
298 (((
299
300 )))
301
302 (((
303 (% style="color:blue" %)**Step 1**(%%): Create a device in TTN with the OTAA keys from LDDS20.
304 )))
305 )))
306
307 (((
308 (((
309 Each LDDS20 is shipped with a sticker with the default device keys, user can find this sticker in the box. it looks like below.
310 )))
311 )))
312
313 [[image:image-20230426085627-1.png||height="271" width="584"]]
314
315
316 (((
317 (((
318 You can enter this key in the LoRaWAN Server portal. Below is TTN screen shot:
319
320 **Create the application.**
321
322 [[image:https://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/SAC01L_LoRaWAN_Temperature%26Humidity_Sensor_User_Manual/WebHome/image-20250423093843-1.png?width=756&height=264&rev=1.1||alt="image-20250423093843-1.png"]]
323
324 [[image:https://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LTC2-LB--LoRaWAN_Temperature_Transmitter_User_Manual/WebHome/image-20240907111305-2.png?width=1000&height=572&rev=1.1||alt="image-20240907111305-2.png"]]
325
326
327 **Add devices to the created Application.**
328
329 [[image:https://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LTC2-LB--LoRaWAN_Temperature_Transmitter_User_Manual/WebHome/image-20240907111659-3.png?width=977&height=185&rev=1.1||alt="image-20240907111659-3.png"]]
330
331 [[image:https://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LTC2-LB--LoRaWAN_Temperature_Transmitter_User_Manual/WebHome/image-20240907111820-5.png?width=975&height=377&rev=1.1||alt="image-20240907111820-5.png"]]
332
333
334 **Enter end device specifics manually.**
335
336 [[image:https://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LTC2-LB--LoRaWAN_Temperature_Transmitter_User_Manual/WebHome/image-20240907112136-6.png?width=697&height=687&rev=1.1||alt="image-20240907112136-6.png"]]
337
338
339 **Add DevEUI and AppKey. Customize a platform ID for the device.**
340
341 [[image:https://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LTC2-LB--LoRaWAN_Temperature_Transmitter_User_Manual/WebHome/image-20240907112427-7.png?rev=1.1||alt="image-20240907112427-7.png"]]
342
343
344 (% style="color:blue" %)**Step 2**(%%): Add decoder.
345
346 In TTN, user can add a custom payload so it shows friendly reading.
347
348 Click this link to get the decoder: [[https:~~/~~/github.com/dragino/dragino-end-node-decoder/tree/main/>>url:https://github.com/dragino/dragino-end-node-decoder/tree/main/]]
349
350 Below is TTN screen shot:
351
352 [[image:https://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDS25-LBLDS25-LS--LoRaWAN_LiDAR_Distance_Auto-Clean_Sensor_User_Manual/WebHome/image-20241009140556-1.png?width=1184&height=488&rev=1.1||alt="image-20241009140556-1.png" height="488" width="1184"]]
353
354 [[image:https://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDS25-LBLDS25-LS--LoRaWAN_LiDAR_Distance_Auto-Clean_Sensor_User_Manual/WebHome/image-20241009140603-2.png?width=1168&height=562&rev=1.1||alt="image-20241009140603-2.png" height="562" width="1168"]]
355
356
357 )))
358 )))
359
360 (% style="color:blue" %)**Step 3**(%%):  Power on LDDS20
361
362 Put a Jumper on JP2 to power on the device. ( The Switch must be in FLASH position).
363
364 [[image:image-20220615095102-14.png]]
365
366 (((
367 The LDDS20 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.
368 )))
369
370 [[image:1654849068701-275.png]]
371
372
373 == 2.3  ​Uplink Payload ==
374
375
376 (((
377 (((
378 (((
379 LDDS20 will uplink payload via LoRaWAN with below payload format: 
380 )))
381
382 (((
383 Uplink payload includes in total 8 bytes.
384 Payload for firmware version v1.1.4. . Before v1.1.3, there is only 5 bytes: BAT and Distance(Please check manual v1.2.0 if you have 5 bytes payload).
385 )))
386 )))
387 )))
388
389 (% border="1" cellspacing="3" style="background-color:#f2f2f2; width:510px" %)
390 |=(% style="width: 60px;background-color:#4F81BD;color:white" %)(((
391 **Size(bytes)**
392 )))|=(% style="width: 40px;background-color:#4F81BD;color:white" %)**2**|=(% style="width: 80px;background-color:#4F81BD;color:white" %)**2**|=(% style="width:130px;background-color:#4F81BD;color:white" %)1|=(% style="width:130px;background-color:#4F81BD;color:white" %)2|=(% style="width:70px;background-color:#4F81BD;color:white" %)**1**
393 |(% style="width:62.5px" %)Value|(% style="width:62.5px" %)[[BAT>>||anchor="H2.3.1A0BatteryInfo"]]|(((
394 [[Distance>>||anchor="H2.3.2A0Distance"]](unit: mm)
395 )))|[[Digital Interrupt (Optional)>>||anchor="H2.3.3A0InterruptPin"]]|(((
396 [[Temperature (Optional)>>||anchor="H2.3.4A0DS18B20Temperaturesensor"]]
397 )))|[[Sensor Flag>>||anchor="H2.3.5A0SensorFlag"]]
398
399 [[image:1654850511545-399.png]]
400
401
402 === 2.3.1  Battery Info ===
403
404
405 Check the battery voltage for LDDS20.
406
407 Ex1: 0x0B45 = 2885mV
408
409 Ex2: 0x0B49 = 2889mV
410
411
412 === 2.3.2  Distance ===
413
414
415 (((
416 Get the distance. Flat object range 20mm - 2000mm.
417 )))
418
419 (((
420 For example, if the data you get from the register is __0x06 0x05__, the distance between the sensor and the measured object is(% style="color:#4472c4" %)** 0605(H) = 1541 (D) = 1541 mm.**
421 )))
422
423 * If the sensor value is 0x0000, it means system doesn't detect ultrasonic sensor.
424 * If the sensor value lower than 0x0014 (20mm), the sensor value will be invalid.(% style="display:none" %)
425
426 === 2.3.3  Interrupt Pin ===
427
428
429 This data field shows if this packet is generated by interrupt or not. [[Click here>>||anchor="H3.2A0SetInterruptMode"]] for the hardware and software set up.
430
431 **Example:**
432
433 0x00: Normal uplink packet.
434
435 0x01: Interrupt Uplink Packet.
436
437
438 === 2.3.4  DS18B20 Temperature sensor ===
439
440
441 This is optional, user can connect external DS18B20 sensor to the +3.3v, 1-wire and GND pin . and this field will report temperature.
442
443 **Example**:
444
445 If payload is: 0105H:  (0105 & FC00 == 0), temp = 0105H /10 = 26.1 degree
446
447 If payload is: FF3FH :  (FF3F & FC00 == 1) , temp = (FF3FH - 65536)/10 = -19.3 degrees.
448
449 (% style="color:red" %)**Note: DS18B20 feature is supported in the hardware version > v1.3 which made since early of 2021.**
450
451
452 === 2.3.5  Sensor Flag ===
453
454
455 (((
456 0x01: Detect Ultrasonic Sensor
457 )))
458
459 (((
460 0x00: No Ultrasonic Sensor
461 )))
462
463
464 === 2.3.6  Decode payload in The Things Network ===
465
466
467 While using TTN network, you can add the payload format to decode the payload.
468
469
470 [[image:1655261164557-670.png]]
471
472 (((
473 The payload decoder function for TTN V3 is here:
474 )))
475
476 (((
477 (((
478 LDDS20 TTN V3 Payload Decoder:  [[https:~~/~~/github.com/dragino/dragino-end-node-decoder>>https://github.com/dragino/dragino-end-node-decoder]]
479 )))
480 )))
481
482
483 == 2.4  Downlink Payload ==
484
485
486 By default, LDDS20 prints the downlink payload to console port.
487
488 (% border="1" cellspacing="3" style="background-color:#f2f2f2; width:510px" %)
489 |(% style="background-color:#4f81bd; color:white; width:208px" %)**Downlink Control Type**|(% style="background-color:#4f81bd; color:white; width:56px" %)**FPort**|(% style="background-color:#4f81bd; color:white; width:100px" %)**Type Code**|(% style="background-color:#4f81bd; color:white; width:146px" %)**Downlink payload size(bytes)**
490 |(% style="width:208px" %)TDC (Transmit Time Interval)|(% style="width:56px" %)Any|(% style="width:100px" %)01|(% style="width:154px" %)4
491 |(% style="width:208px" %)RESET|(% style="width:56px" %)Any|(% style="width:100px" %)04|(% style="width:154px" %)2
492 |AT+CFM|Any|05|4
493 |(% style="width:208px" %)INTMOD|(% style="width:56px" %)Any|(% style="width:100px" %)06|(% style="width:154px" %)4
494
495 **Examples:**
496
497
498 * (% style="color:blue" %)**Set TDC**
499
500 If the payload=0100003C, it means set the END Node's TDC to 0x00003C=60(S), while type code is 01.
501
502 Payload:    01 00 00 1E    TDC=30S
503
504 Payload:    01 00 00 3C    TDC=60S
505
506
507 * (% style="color:blue" %)**Reset**
508
509 If payload = 0x04FF, it will reset the LDDS20
510
511
512 * (% style="color:blue" %)**CFM**
513
514 Downlink Payload: 05000001, Set AT+CFM=1 or 05000000 , set AT+CFM=0
515
516
517 == 2.5  ​Show Data in DataCake IoT Server ==
518
519
520 (((
521 [[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:
522 )))
523
524 (((
525
526 )))
527
528 (((
529 (% style="color:blue" %)**Step 1**(%%)**: Be sure that your device is programmed and properly connected to the network at this time.**
530 )))
531
532 (((
533 (% 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:**
534 )))
535
536
537 [[image:1654592790040-760.png]]
538
539
540 [[image:1654592800389-571.png]]
541
542
543 (% style="color:blue" %)**Step 3**(%%)**: Create an account or log in Datacake.**
544
545 (% style="color:blue" %)**Step 4**(%%)**: Search the LDDS75 and add DevEUI.(% style="color:red" %)(Note: LDDS20 use same payload as LDDS75)(%%)**
546
547 [[image:1654851029373-510.png]]
548
549
550 After added, the sensor data arrive TTN V3, it will also arrive and show in Datacake.
551
552 [[image:image-20220610165129-11.png||height="595" width="1088"]]
553
554
555 == 2.6  LED Indicator ==
556
557
558 The LDDS20 has an internal LED which is to show the status of different state.
559
560
561 * Blink once when device power on.
562 * The device detects the sensor and flashes 5 times.
563 * Solid ON for 5 seconds once device successful Join the network.
564 * Blink once when device transmit a packet.(% style="display:none" %)
565
566 == 2.7  ​Firmware Change Log ==
567
568
569 (((
570 **Firmware download link:   **[[https:~~/~~/www.dropbox.com/sh/26spxc7wr3aduwi/AACQSJESTaVkWO5JVHLvdt0Za?dl=0>>https://www.dropbox.com/sh/26spxc7wr3aduwi/AACQSJESTaVkWO5JVHLvdt0Za?dl=0]]
571 )))
572
573 (((
574 **Firmware Upgrade Method:  **[[Firmware Upgrade Instruction>>doc:Main.Firmware Upgrade Instruction for STM32 base products.WebHome]]
575 )))
576
577
578 == 2.8 Battery & Power Consumption ==
579
580
581 LDDS20 uses ER26500 + SPC1520 battery pack. See below link for detail information about the battery info and how to replace.
582
583 [[**Battery Info & Power Consumption Analyze**>>url:http://wiki.dragino.com/xwiki/bin/view/Main/How%20to%20calculate%20the%20battery%20life%20of%20Dragino%20sensors%3F/]] .
584
585
586 = 3.  Using the AT Commands =
587
588 == 3.1  Access AT Commands ==
589
590
591 LDDS20 supports AT Command set in the stock firmware. You can use a USB to TTL adapter to connect to LDDS20 for using AT command, as below.
592
593 [[image:image-20240312113025-1.jpeg||height="523" width="735"]]
594
595
596 Or if you have below board, use below connection:
597
598 [[image:image-20220610172924-5.png||height="416" width="663"]]
599
600
601 (((
602 In the PC, you need to set the serial baud rate to (% style="color:green" %)**9600**(%%) to access the serial console for LDDS20. LDDS20 will output system info once power on as below:
603 )))
604
605 [[image:image-20220610172924-6.png||height="601" width="860"]]
606
607 Below are the available commands, a more detailed AT Command manual can be found at [[AT Command Manual>>https://www.dragino.com/downloads/index.php?dir=LoRa_End_Node/LSE01/]].
608
609
610 AT+<CMD>?  :  Help on <CMD>
611
612 AT+<CMD>  :  Run <CMD>
613
614 AT+<CMD>=<value>  :  Set the value
615
616 AT+<CMD>=?  :  Get the value
617
618
619 (% style="color:#037691" %)** General Commands :**     
620
621 AT  :  Attention       
622
623 AT?  :  Short Help     
624
625 ATZ :  MCU Reset    
626
627 AT+TDC :  Application Data Transmission Interval 
628
629
630 (% style="color:#037691" %)** Keys, IDs and EUIs management :**
631
632 AT+APPEUI  :  Application EUI      
633
634 AT+APPKEY  :  Application Key     
635
636 AT+APPSKEY  :  Application Session Key
637
638 AT+DADDR :  Device Address     
639
640 AT+DEUI :  Device EUI     
641
642 AT+NWKID  :  Network ID (You can enter this command change only after successful network connection) 
643
644 AT+NWKSKEY  : Network Session Key Joining and sending date on LoRa network  
645
646 AT+CFM :  Confirm Mode       
647
648 AT+CFS :  Confirm Status       
649
650 AT+JOIN  :  Join LoRa? Network       
651
652 AT+NJM  :  LoRa? Network Join Mode    
653
654 AT+NJS  :  LoRa? Network Join Status    
655
656 AT+RECV  :  Print Last Received Data in Raw Format
657
658 AT+RECVB :  Print Last Received Data in Binary Format      
659
660 AT+SEND  :  Send Text Data      
661
662 AT+SENB  :  Send Hexadecimal Data
663
664
665 (% style="color:#037691" %)** LoRa Network Management :**
666
667 AT+ADR  :  Adaptive Rate
668
669 AT+CLASS  :  LoRa Class(Currently only support class A
670
671 AT+DCS  :  Duty Cycle Setting 
672
673 AT+DR  :  Data Rate (Can Only be Modified after ADR=0)     
674
675 AT+FCD  :  Frame Counter Downlink       
676
677 AT+FCU  :  Frame Counter Uplink   
678
679 AT+JN1DL  :  Join Accept Delay1
680
681 AT+JN2DL  :  Join Accept Delay2
682
683 AT+PNM  :  Public Network Mode   
684
685 AT+RX1DL  :  Receive Delay1      
686
687 AT+RX2DL  :  Receive Delay2      
688
689 AT+RX2DR  :  Rx2 Window Data Rate 
690
691 AT+RX2FQ  :  Rx2 Window Frequency
692
693 AT+TXP  :  Transmit Power
694
695
696 (% style="color:#037691" %)** Information :**
697
698 AT+RSSI  :  RSSI of the Last Received Packet   
699
700 AT+SNR  :  SNR of the Last Received Packet   
701
702 AT+VER  :  Image Version and Frequency Band       
703
704 AT+FDR  :  Factory Data Reset
705
706 AT+PORT  :  Application Port    
707
708 AT+CHS  :  Get or Set Frequency (Unit: Hz) for Single Channel Mode
709
710 AT+CHE  :  Get or Set eight channels mode, Only for US915, AU915, CN470
711
712
713 == 3.2  Set Interrupt Mode ==
714
715
716 Feature, Set Interrupt mode for GPIO_EXIT.
717
718 (% style="color:#037691" %)**Downlink Command: AT+INTMOD**(% style="display:none" %)
719
720 (% border="1" cellspacing="3" style="background-color:#f2f2f2; width:515px" %)
721 |(% style="background-color:#4f81bd; color:white; width:155px" %)**Command Example**|(% style="background-color:#4f81bd; color:white; width:188px" %)**Function**|(% style="background-color:#4f81bd; color:white; width:172px" %)**Response**
722 |(% style="width:155px" %)AT+INTMOD=?|(% style="width:187px" %)Show current interrupt mode|(% style="width:177px" %)(((
723 0
724 OK
725 the mode is 0 = No interruption
726 )))
727 |(% style="width:155px" %)AT+INTMOD=2|(% style="width:187px" %)(((
728 Set Transmit Interval
729
730 1. (Disable Interrupt),
731 1. (Trigger by rising and falling edge),
732 1. (Trigger by falling edge)
733 1. (Trigger by rising edge)
734 )))|(% style="width:177px" %)(((
735 OK
736 Set transmit interval to 60000ms = 60 seconds
737 )))
738
739 (((
740 (% style="color:#037691" %)**Downlink Command: 0x06**
741 )))
742
743 (((
744 Format: Command Code (0x06) followed by 3 bytes.
745 )))
746
747 (((
748 (((
749 This means that the interrupt mode of the end node is set to 0x000003=3 (rising edge trigger), and the type code is 06.
750 )))
751 )))
752
753 * (((
754 Example 1: Downlink Payload: 06000000  ~/~/ Turn off interrupt mode
755 )))
756 * (((
757 Example 2: Downlink Payload: 06000003  ~/~/ Set the interrupt mode to rising edge trigger
758 )))
759
760 (((
761 (% style="display:none" %) (%%)
762 )))
763
764
765 = 4.  FAQ =
766
767 == 4.1  What is the frequency plan for LDDS20? ==
768
769
770 LDDS20 use the same frequency as other Dragino products. User can see the detail from this link:  [[Introduction>>doc:Main.End Device Frequency Band.WebHome||anchor="H1.Introduction"]]
771
772
773 == 4.2  How to change the LoRa Frequency Bands/Region ==
774
775
776 You can follow the instructions for [[how to upgrade image>>||anchor="H2.7A0200BFirmwareChangeLog"]].
777 When downloading the images, choose the required image file for download. ​
778
779
780 = 5.  Trouble Shooting =
781
782 == 5.1  Why I can't join TTN V3 in US915 / AU915 bands? ==
783
784
785 It is due to channel mapping. Please see below link:  [[Frequency band>>doc:Main.LoRaWAN Communication Debug.WebHome||anchor="H2.NoticeofUS9152FCN4702FAU915Frequencyband"]]
786
787
788 == 5.2  AT Command input doesn't work ==
789
790
791 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.
792
793
794 == 5.3 Why i always see 0x0000 or 0 for the distance value? ==
795
796
797 (((
798 LDDS20 has a strict [[**installation requirement**>>||anchor="H1.5A0InstallLDDS20"]]. Please make sure the installation method exactly follows up with the installation requirement. Otherwise, the reading might be always 0x00.
799
800 If you have followed the instruction requirement exactly but still see the 0x00 reading issue, please. please double-check the decoder, you can check the raw payload to verify.
801 )))
802
803
804 = 6.  Order Info =
805
806
807 Part Number **:** (% style="color:blue" %)**LDDS20-XX**
808
809
810 (% style="color:blue" %)**XX**(%%)**: **The default frequency band
811
812 * (% style="color:red" %)**AS923 **(%%)**:** LoRaWAN AS923 band
813 * (% style="color:red" %)**AU915 **(%%)**:** LoRaWAN AU915 band
814 * (% style="color:red" %)**EU433 **(%%)**:** LoRaWAN EU433 band
815 * (% style="color:red" %)**EU868 **(%%)**:** LoRaWAN EU868 band
816 * (% style="color:red" %)**KR920 **(%%)**:** LoRaWAN KR920 band
817 * (% style="color:red" %)**US915 **(%%)**:** LoRaWAN US915 band
818 * (% style="color:red" %)**IN865 **(%%)**:**  LoRaWAN IN865 band
819 * (% style="color:red" %)**CN470 **(%%)**:** LoRaWAN CN470 band
820
821 = 7. ​ Packing Info =
822
823
824 (((
825 **Package Includes**:
826 )))
827
828 * (((
829 LDDS20 LoRaWAN Liquid Level Sensor x 1
830 )))
831
832 (((
833 (% style="color:red" %)**Note:**
834 )))
835
836 (((
837 (((
838 (% style="color:red" %)**Ultrasonic coupling paste**(%%) and(% style="color:red" %)** Eproxy AB glue**(%%) are subjected in most shipping way. So the default package doesn't include it and user needs to purchase locally.
839 )))
840 )))
841
842 (((
843
844 )))
845
846 (((
847 **Dimension and weight**:
848 )))
849
850 * (((
851 Device Size: cm
852 )))
853 * (((
854 Device Weight: g
855 )))
856 * (((
857 Package Size / pcs : cm
858 )))
859 * (((
860 Weight / pcs : g
861
862
863
864 )))
865
866 = 8.  ​Support =
867
868
869 * 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.
870 * 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]].
Copyright ©2010-2024 Dragino Technology Co., LTD. All rights reserved
Dragino Wiki v2.0