Skip to Content
Version 117.1 by Xiaoling on 2025/04/11 11:47
Show last authors
1
2
3 (% style="text-align:center" %)
4 [[image:image-20240106103059-2.png]]
5
6
7
8
9
10
11
12
13
14
15 **Table of Contents :**
16
17 {{toc/}}
18
19
20
21
22
23
24 = 1. Introduction =
25
26 == 1.1 What is LoRaWAN 4-Channels Distance Sensor ==
27
28
29 The Dragino DDS04-LB/LS is a (% style="color:blue" %)**LoRaWAN 4-Channels Distance Sensor**(%%) for Internet of Things solution. It is capable to add up to four Ultrasonic Sensors to measure four distances at the same time.
30
31 The DDS04-LB/LS can be applied to scenarios such as horizontal distance measurement, parking management system, object proximity and presence detection, intelligent trash can management system, robot obstacle avoidance, automatic control, sewer, etc.
32
33 It detects the (% style="color:blue" %)**distance between the measured object and the sensor**(%%), and uploads the value via wireless to LoRaWAN IoT Server.
34
35 The LoRa wireless technology used in DDS04-LB/LS 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.
36
37 DDS04-LB/LS (% style="color:blue" %)**supports BLE configure**(%%) and (% style="color:blue" %)**wireless OTA update**(%%) which make user easy to use.
38
39 DDS04-LB/LS is powered by (% style="color:blue" %)**8500mAh Li-SOCI2 battery **(%%)or (% style="color:blue" %)**solar powered + Li-ion battery**(%%), it is designed for long term use up to 5 years.
40
41 Each DDS04-LB/LS 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.
42
43
44 == 1.2 ​Features ==
45
46
47 * LoRaWAN 1.0.3 Class A
48 * Bands: CN470/EU433/KR920/US915/EU868/AS923/AU915/IN865
49 * Ultra-low power consumption
50 * Detect Range: Base on External Probe
51 * Monitor Battery Level
52 * Support Bluetooth v5.1 and LoRaWAN remote configure
53 * Support wireless OTA update firmware
54 * AT Commands to change parameters
55 * Downlink to change configure
56 * 8500mAh Li/SOCl2 Battery (DDS04-LB)
57 * Solar panel + 3000mAh Li-ion battery (DDS04-LS)
58
59 == 1.3 Specification ==
60
61
62 (% style="color:#037691" %)**Common DC Characteristics:**
63
64 * Supply Voltage: Built-in Battery , 2.5v ~~ 3.6v
65 * Operating Temperature: -40 ~~ 85°C
66
67 (% style="color:#037691" %)**LoRa Spec:**
68
69 * Frequency Range,  Band 1 (HF): 862 ~~ 1020 Mhz
70 * Max +22 dBm constant RF output vs.
71 * RX sensitivity: down to -139 dBm.
72 * Excellent blocking immunity
73
74 (% style="color:#037691" %)**Battery:**
75
76 * Li/SOCI2 un-chargeable battery
77 * Capacity: 8500mAh
78 * Self-Discharge: <1% / Year @ 25°C
79 * Max continuously current: 130mA
80 * Max boost current: 2A, 1 second
81
82 (% style="color:#037691" %)**Power Consumption**
83
84 * Sleep Mode: 5uA @ 3.3v
85 * LoRa Transmit Mode: 125mA @ 20dBm, 82mA @ 14dBm
86
87 == 1.4 Probe Options ==
88
89 === 1.4.1 Probes Comparation ===
90
91
92 (% border="1" cellspacing="5" style="width:505px" %)
93 |=(% style="width: 80px;background-color:#4F81BD;color:white" %)**Model**|=(% style="width: 147px;background-color:#4F81BD;color:white" %)**Photo**|=(% style="width: 278px;background-color:#4F81BD;color:white" %)**Description**
94 |(% style="width:78px" %)A01A-15|(% style="width:145px" %)(((
95 [[image:image-20250411105813-2.jpeg]]
96 )))|(% style="width:277px" %)(((
97 (((
98 Detect Distance: 28 cm ~~ 750 cm
99 )))
100
101 (((
102 Blind Spot Distance: 0 ~~ 28cm
103 )))
104
105 (((
106 Accuracy: ±(1cm+S*0.3%) (S: Distance)
107 )))
108
109 (((
110 Measure Angle: ~~ 40°
111 )))
112
113 (((
114 Cable Length: 1.5 meter
115 )))
116
117 (((
118 Temperature Compensation
119 )))
120
121 (((
122 Suitable for Flat Object Detect
123 )))
124
125 (((
126 IP67 Water Proof
127 )))
128 )))
129 |(% style="width:78px" %)A02-15|(% style="width:145px" %)(((
130 [[image:image-20250411105832-3.jpeg]]
131 )))|(% style="width:277px" %)(((
132 (((
133 Detect Distance: 3cm ~~ 450cm
134 )))
135
136 (((
137 Blind Spot Distance: 0 ~~ 3cm
138 )))
139
140 (((
141 Accuracy: ±(1cm+S*0.3%) (S: Distance)
142 )))
143
144 (((
145 Measure Angle: ~~ 60°
146 )))
147
148 (((
149 Cable Length: 1.5 meter
150 )))
151
152 (((
153 Temperature Compensation
154 )))
155
156 (((
157 Suitable for Flat Object Detect, Rubbish Bin
158 )))
159
160 (((
161 IP67 Water Proof
162 )))
163 )))
164 |(% style="width:78px" %)A13-15|(% style="width:145px" %)(((
165 [[image:image-20250411105848-4.jpeg]]
166 )))|(% style="width:277px" %)(((
167 (((
168 Detect Distance: 25cm ~~ 200cm
169 )))
170
171 (((
172 Blind Spot Distance: 0 ~~ 25cm
173 )))
174
175 (((
176 Accuracy: ±(1cm+S*0.3%) (S: Distance)
177 )))
178
179 (((
180 Measure Angle: ~~ 20°
181 )))
182
183 (((
184 Cable Length: 1.5 meter
185 )))
186
187 (((
188 Temperature Compensation
189 )))
190
191 (((
192 Suitable for Flat Object Detect, Rubbish Bin
193 )))
194
195 (((
196 IP67 Water Proof
197 )))
198 )))
199 |(% style="width:78px" %)A16-15|(% style="width:145px" %)(((
200 [[image:image-20250411110016-5.jpeg]]
201 )))|(% style="width:277px" %)(((
202 (((
203 Detect Distance: 50cm ~~ 1500cm
204 )))
205
206 (((
207 Blind Spot Distance: 0 ~~ 50cm
208 )))
209
210 (((
211 Accuracy: ±(1cm+S*0.3%) (S: Distance)
212 )))
213
214 (((
215 Measure Angle: ~~ 40°
216 )))
217
218 (((
219 Cable Length: 1.5 meter
220 )))
221
222 (((
223 Temperature Compensation
224 )))
225
226 (((
227 Suitable for Long Distance Detect
228 )))
229
230 (((
231 IP67 Water Proof
232 )))
233 )))
234
235 === 1.4.2 A01A-15 probe ===
236
237
238 (((
239 A01A-15 is mainly used for plane distance measurement; it can carry out targeted measurement on plane objects and can measure long distances and high accuracy.
240 )))
241
242
243 (((
244 (% style="color:blue" %)**Beam Chart:**
245 )))
246
247 (((
248 **(1) The tested object is a white cylindrical tube made of PVC, with a height of 100cm and a diameter of 7.5cm.**
249 )))
250
251 (% style="background-image:url(http://wiki1.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||draggable="true" height="15" role="presentation" title="Click and drag to move" width="15"]](% title="Click and drag to resize" %)​[[image:image-20250411110820-6.jpeg]]
252
253
254 (((
255 **(2)** **The object to be tested is a "corrugated cardboard box" perpendicular to the central axis of 0 °, and the length * width is 60cm * 50cm.**
256 )))
257
258 (% style="background-image:url(http://wiki1.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||draggable="true" height="15" role="presentation" title="Click and drag to move" width="15"]](% title="Click and drag to resize" %)​​​​​​​​[[image:image-20250411110854-7.jpeg]]
259
260
261 (% style="color:blue" %)**Mechanical:**
262
263 (% style="background-image:url(http://wiki1.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||draggable="true" height="15" role="presentation" title="Click and drag to move" width="15"]](% title="Click and drag to resize" %)​[[image:image-20250411111010-8.jpeg]]
264
265 [[image:image-20250411111040-9.jpeg]]
266
267 [[image:image-20250411111059-10.jpeg]]
268
269
270 (% style="color:blue" %)**Application:**
271
272 (% style="background-image:url(http://wiki1.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||draggable="true" height="15" role="presentation" title="Click and drag to move" width="15"]](% title="Click and drag to resize" %)​[[image:image-20250411111157-11.jpeg]]
273
274
275 === 1.4.3 A02-15 probe ===
276
277 (% id="cke_bm_620491S" style="color:blue; display:none" %)** **
278
279
280 (((
281 (% style="color:blue" %)**Beam Chart:**
282 )))
283
284 (((
285 **(1) The tested object is a white cylindrical tube made of PVC, with a height of 100cm and a diameter of 7.5cm.**
286 )))
287
288 (% style="background-image:url(http://wiki1.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||draggable="true" height="15" role="presentation" title="Click and drag to move" width="15"]](% title="Click and drag to resize" %)​[[image:image-20250411113659-16.jpeg]]
289
290
291 (((
292 **(2)** **The object to be tested is a "corrugated cardboard box" perpendicular to the central axis of 0 °, and the length * width is 60cm * 50cm.**
293 )))
294
295 (% style="background-image:url(http://wiki1.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||draggable="true" height="15" role="presentation" title="Click and drag to move" width="15"]](% title="Click and drag to resize" %)​[[image:image-20250411113355-13.jpeg]]
296
297
298 (% style="color:blue" %)**Mechanical:**(% style="background-image:url(http://wiki1.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||draggable="true" height="15" role="presentation" title="Click and drag to move" width="15"]](% title="Click and drag to resize" %)​
299
300 [[image:image-20250411113434-14.jpeg]]
301
302
303 (% style="color:blue" %)**Application:**
304
305 (% style="background-image:url(http://wiki1.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||draggable="true" height="15" role="presentation" title="Click and drag to move" width="15"]](% title="Click and drag to resize" %)​[[image:image-20250411113501-15.jpeg]]
306
307
308 === 1.4.4 A13-15 probe ===
309
310 (% id="cke_bm_695100S" style="color:blue; display:none" %)** **
311
312
313 (((
314 (% style="color:blue" %)**Beam Chart:**
315 )))
316
317 (((
318 **(1) The tested object is a white cylindrical tube made of PVC, with a height of 100cm and a diameter of 7.5cm.**
319 )))
320
321 (% style="background-image:url(http://wiki1.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||draggable="true" height="15" role="presentation" title="Click and drag to move" width="15"]](% title="Click and drag to resize" %)​[[image:image-20250411114332-17.jpeg]]
322
323
324 (((
325 **(2)** **The object to be tested is a "corrugated cardboard box" perpendicular to the central axis of 0 °, and the length * width is 60cm * 50cm.**
326 )))
327
328
329 (((
330 (% style="color:blue" %)**Mechanical:**
331 )))
332
333 [[image:image-20250411114406-18.jpeg]]
334
335 (% style="background-image:url(http://wiki1.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||draggable="true" height="15" role="presentation" title="Click and drag to move" width="15"]](% title="Click and drag to resize" %)​
336
337 (% style="color:blue" %)**Installation Requirement:**
338
339 (% style="background-image:url(http://wiki1.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||draggable="true" height="15" role="presentation" title="Click and drag to move" width="15"]](% title="Click and drag to resize" %)​[[image:image-20250411114450-19.jpeg]]
340
341
342 (% style="color:blue" %)**Application:**
343
344 (% style="background-image:url(http://wiki1.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||draggable="true" height="15" role="presentation" title="Click and drag to move" width="15"]](% title="Click and drag to resize" %)​[[image:image-20250411114523-20.jpeg]]
345
346
347 === 1.4.5 A13-16 probe ===
348
349 (% id="cke_bm_695100S" style="color:blue; display:none" %)** **
350
351
352 (((
353 (% style="color:blue" %)**Beam Chart:**
354 )))
355
356 (((
357 **(1) The tested object is a white cylindrical tube made of PVC, with a height of 100cm and a diameter of 7.5cm.**
358 )))
359
360 (% style="background-image:url(http://wiki1.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||draggable="true" height="15" role="presentation" title="Click and drag to move" width="15"]](% title="Click and drag to resize" %)​[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDDS04%20-%20LoRaWAN%204-Channels%20Distance%20Detection%20Sensor%20User%20Manual/WebHome/1654934415156-713.png?rev=1.1||alt="1654934415156-713.png"]]
361
362
363 (((
364 **(2)** **The object to be tested is a "corrugated cardboard box" perpendicular to the central axis of 0 °, and the length * width is 60cm * 50cm.**
365 )))
366
367 (% style="background-image:url(http://wiki1.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||draggable="true" height="15" role="presentation" title="Click and drag to move" width="15"]](% title="Click and drag to resize" %)​[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDDS04%20-%20LoRaWAN%204-Channels%20Distance%20Detection%20Sensor%20User%20Manual/WebHome/1654934424571-232.png?rev=1.1||alt="1654934424571-232.png"]]
368
369
370
371 (% style="color:blue" %)**Mechanical:**
372
373 (% style="background-image:url(http://wiki1.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||draggable="true" height="15" role="presentation" title="Click and drag to move" width="15"]](% title="Click and drag to resize" %)​[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDDS04%20-%20LoRaWAN%204-Channels%20Distance%20Detection%20Sensor%20User%20Manual/WebHome/image-20220611160117-1.png?rev=1.1||alt="image-20220611160117-1.png"]]
374
375
376 (% style="color:blue" %)**Application:**
377
378 (% style="background-image:url(http://wiki1.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||draggable="true" height="15" role="presentation" title="Click and drag to move" width="15"]](% title="Click and drag to resize" %)​[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDDS04%20-%20LoRaWAN%204-Channels%20Distance%20Detection%20Sensor%20User%20Manual/WebHome/image-20220613093102-1.png?rev=1.1||alt="image-20220613093102-1.png"]]
379
380
381 == 1.5 Applications ==
382
383
384 * Horizontal distance measurement
385 * Parking management system
386 * Object proximity and presence detection
387 * Intelligent trash can management system
388 * Robot obstacle avoidance
389 * Automatic control
390 * Sewer
391
392 == 1.6 Sleep mode and working mode ==
393
394
395 (% style="color:blue" %)**Deep Sleep Mode: **(%%)Sensor doesn't have any LoRaWAN activate. This mode is used for storage and shipping to save battery life.
396
397 (% style="color:blue" %)**Working Mode:** (%%)In this mode, Sensor will work as LoRaWAN Sensor to Join LoRaWAN network and send out sensor data to server. Between each sampling/tx/rx periodically, sensor will be in IDLE mode), in IDLE mode, sensor has the same power consumption as Deep Sleep mode.
398
399
400 == 1.7 Button & LEDs ==
401
402
403 [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/RS485-LB_Waterproof_RS485UART_to_LoRaWAN_Converter/WebHome/image-20240103160425-4.png?rev=1.1||alt="image-20240103160425-4.png"]]
404
405 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
406 |=(% style="width: 167px;background-color:#4F81BD;color:white" %)**Behavior on ACT**|=(% style="width: 117px;background-color:#4F81BD;color:white" %)**Function**|=(% style="width: 225px;background-color:#4F81BD;color:white" %)**Action**
407 |(% style="width:167px" %)Pressing ACT between 1s < time < 3s|(% style="width:117px" %)Send an uplink|(% style="width:225px" %)(((
408 If sensor is already Joined to LoRaWAN network, sensor will send an uplink packet, (% style="color:blue" %)**blue led** (%%)will blink once.
409 Meanwhile, BLE module will be active and user can connect via BLE to configure device.
410 )))
411 |(% style="width:167px" %)Pressing ACT for more than 3s|(% style="width:117px" %)Active Device|(% style="width:225px" %)(((
412 (% style="color:green" %)**Green led**(%%) will fast blink 5 times, device will enter (% style="color:#037691" %)**OTA mode**(%%) for 3 seconds. And then start to JOIN LoRaWAN network.
413 (% style="color:green" %)**Green led**(%%) will solidly turn on for 5 seconds after joined in network.
414 Once sensor is active, BLE module will be active and user can connect via BLE to configure device, no matter if device join or not join LoRaWAN network.
415 )))
416 |(% style="width:167px" %)Fast press ACT 5 times.|(% style="width:117px" %)Deactivate Device|(% style="width:225px" %)(% style="color:red" %)**Red led**(%%) will solid on for 5 seconds. Means device is in Deep Sleep Mode.
417
418 == 1.8 BLE connection ==
419
420
421 DDS04-LB/LS support BLE remote configure.
422
423
424 BLE can be used to configure the parameter of sensor or see the console output from sensor. BLE will be only activate on below case:
425
426 * Press button to send an uplink
427 * Press button to active device.
428 * Device Power on or reset.
429
430 If there is no activity connection on BLE in 60 seconds, sensor will shut down BLE module to enter low power mode.
431
432
433 == 1.9 Pin Definitions ==
434
435
436 [[image:image-20250218145939-1.jpeg||height="358" width="779"]]
437
438
439 == 1.10 Mechanical ==
440
441 === 1.10.1 for LB version ===
442
443
444
445
446 [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/DDS75-LB_LoRaWAN_Distance_Detection_Sensor_User_Manual/WebHome/image-20240105152536-3.png?rev=1.1||alt="image-20240105152536-3.png"]]
447
448
449
450 === 1.10.2 for LS version ===
451
452 [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/SN50v3-LB/WebHome/image-20231231203439-3.png?width=886&height=385&rev=1.1||alt="image-20231231203439-3.png"]]
453
454
455 = 2. Configure DDS04-LB/LS to connect to LoRaWAN network =
456
457 == 2.1 How it works ==
458
459
460 The DDS04-LB/LS is configured as (% style="color:#037691" %)**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 press the button to activate the DDS04-LB/LS. It will automatically join the network via OTAA and start to send the sensor value. The default uplink interval is 20 minutes.
461
462
463 == 2.2 Connect Probe ==
464
465
466 DDS04-LB/LS has a converter, User need to connect the Ultrasonic Probes to the convert as below. Different probes are supported, please see this link for the probe options.
467
468 [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/DDS04-NB_NB-IoT_4-Channels_Distance_Detection_Sensor_User_Manual/WebHome/image-20231018160750-3.jpeg?rev=1.1||alt="image-20231018160750-3.jpeg"]]
469
470 ​
471
472 **Probe mapping as below.**
473
474 [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDDS04%20-%20LoRaWAN%204-Channels%20Distance%20Detection%20Sensor%20User%20Manual/WebHome/image-20220611160853-3.png?width=746&height=463&rev=1.1||alt="image-20220611160853-3.png" height="463" width="746"]]
475
476
477 == 2.3 ​Quick guide to connect to LoRaWAN server (OTAA) ==
478
479
480 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 [[LPS8v2>>url:https://www.dragino.com/products/lora-lorawan-gateway/item/228-lps8v2.html]] as a LoRaWAN gateway in this example.
481
482 The LPS8v2 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.
483
484 [[image:image-20250411102325-1.png]](% style="display:none" %)
485
486
487 (% style="color:blue" %)**Step 1:**(%%) Create a device in TTN with the OTAA keys from DDS04-LB/LS.
488
489 Each DDS04-LB/LS is shipped with a sticker with the default device EUI as below:
490
491 [[image:image-20230426084152-1.png||alt="图片-20230426084152-1.png" height="233" width="502"]]
492
493
494 === 2.3.1 Creating an application ===
495
496 Sign up for a free account with [[The Things Stack Sandbox>>url:https://eu1.cloud.thethings.network/]] if you do not have one yet. Then, create an application as shown in the screenshots below.
497
498 **Application ID:** Provide a unique name to identify your application within The Things Stack, e.g., //dragino-docs//.
499
500 [[image:https://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/WQS-LB--LoRaWAN_Water_Quality_Sensor_Transmitter_User_Manual/WebHome/tti-new-application.png?rev=1.2||alt="tti-new-application.png" height="757" width="1211"]]
501
502 === 2.3.2 Adding manually ===
503
504 You can refer to the screenshots below to register your WQS-LB using The Things Stack's manual option.
505
506 On The Things Stack console:
507
508 ~1. Click **Applications**.
509
510 2. Click <**your application**>. E.g. dragino-docs
511
512 3 Click **End devices**.
513
514 4. Click **+ Register end device** button.
515
516 [[image:https://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LHT65N-VIB_LoRaWAN_Vibration_Sensor_Manual/WebHome/lht65n-vib-1.png?rev=1.1||alt="lht65n-vib-1.png" height="731" width="1066"]]
517
518 5. Select **Enter end device specifies manually** option.
519
520 6. **Frequency plan**: Select the frequency plan that matches your device. E.g.: Europe 863-870 MHz (SF9 for RX2 - recommended).
521
522 7. **LoRaWAN version**: LoRaWAN Specification 1.0.3
523
524 8. **Regional Parameters version**: You can't change it and it will select automatically.
525
526 [[image:https://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LHT65N-VIB_LoRaWAN_Vibration_Sensor_Manual/WebHome/lht65n-vib-3.png?rev=1.1||alt="lht65n-vib-3.png" height="664" width="968"]]
527
528 9. Click on the **Show advanced activation, LoRaWAN class and cluster settings **to expand the section.
529
530 10. Select **Over the air activation (OTAA**) option.
531
532 ~11. Select **None (class A only)**.
533
534 12. **JoinEUI**: Enter the **AppEUI** of the device (see the registration information sticker) and Click the **Confirm** button.
535
536 [[image:https://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LHT65N-VIB_LoRaWAN_Vibration_Sensor_Manual/WebHome/lht65n-vib-4.png?rev=1.1||alt="lht65n-vib-4.png" height="610" width="889"]]
537
538 13. **DevEUI**: Enter the DevEUI of the device (see the registration information sticker).
539
540 14. **AppKey**: Enter the AppKey of the device (see the registration information sticker).
541
542 15. **End device ID**: Enter a name for your end device to uniquely identify it within this application.
543
544 16. Click **View registered end device** option.
545
546 17. Click **Register end device** button.
547
548 [[image:https://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/WQS-LB--LoRaWAN_Water_Quality_Sensor_Transmitter_User_Manual/WebHome/wqs-lb-4.png?rev=1.1||alt="wqs-lb-4.png" height="619" width="903"]]
549
550 You will be navigated to the **Device overview **page.
551
552
553 (% style="color:blue" %)**Step 2:**(%%) Activate on DDS04-LB/LS
554
555
556 Press the button for 5 seconds to activate the DDS04-LB/LS.
557
558 (% style="color:green" %)**Green led**(%%) will fast blink 5 times, device will enter (% style="color:blue" %)**OTA mode**(%%) for 3 seconds. And then start to JOIN LoRaWAN network. (% style="color:green" %)**Green led**(%%) will solidly turn on for 5 seconds after joined in network.
559
560 After join success, it will start to upload messages to TTN and you can see the messages in the panel.
561
562 === 2.3.3 Uplink Decoder in The Things Stack ===
563
564 When the uplink payload arrives in The Things Stack, it is displayed in HEX format, which is not easy to read. You can add the WQS-LB decoder in The Things Stack for easier readability of each sensor reading.
565
566 The uplink decoder can be added to the** Payload Formatters** of your device in The Things Stack. Refer to the screenshot below.
567
568 ~1. Click **Uplink** tab.
569
570 2. **Formatter type:** Select Custom Javascript formatter.
571
572 3. **Formatter code**: Copy the uplink payload formatter code from our [[dragino-end-node-decoder GitHub repository>>url:https://github.com/dragino/dragino-end-node-decoder/blob/main/WQS-LB/WQS-LB_TTN_Decoder.txt]] and paste it here.
573
574 4. Finally, click on the **Save changes** button.
575
576 [[image:https://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LHT65N-VIB_LoRaWAN_Vibration_Sensor_Manual/WebHome/Screenshot%202024-12-03%20at%2017.34.15.png?rev=1.1||alt="Screenshot 2024-12-03 at 17.34.15.png" height="575" width="1046"]]
577
578 == 2.4  ​Uplink Payload ==
579
580 === 2.4.1 Device Status, FPORT~=5 ===
581
582
583 Users can use the downlink command(**0x26 01**) to ask DDS04-LB/LS to send device configure detail, include device configure status. DDS04-LB/LS will uplink a payload via FPort=5 to server.
584
585 The Payload format is as below.
586
587 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
588 |=(% style="width: 60px;background-color:#4F81BD;color:white" %)(((
589 **Size(bytes)**
590 )))|=(% style="width: 100px; background-color: #4F81BD;color:white;" %)**1**|=(% style="width: 100px; background-color: #4F81BD;color:white;" %)**2**|=(% style="background-color: #4F81BD;color:white; width: 100px;" %)**1**|=(% style="background-color: #4F81BD;color:white; width: 100px;" %)**1**|=(% style="background-color: #4F81BD;color:white; width: 50px;" %)**2**
591 |(% style="width:62.5px" %)Value|(% style="width:110px" %)Sensor Model|(% style="width:48px" %)Firmware Version|(% style="width:94px" %)Frequency Band|(% style="width:91px" %)Sub-band|(% style="width:60px" %)BAT
592
593 Example parse in TTNv3
594
595 [[image:image-20230805170720-3.png||height="147" width="751"]]
596
597 (% style="color:blue" %)**Sensor Model**(%%): For DDS04-LB/LS, this value is 0x23
598
599 (% style="color:blue" %)**Firmware Version**(%%): 0x0100, Means: v1.0.0 version
600
601 (% style="color:blue" %)**Frequency Band**:
602
603 0x01: EU868
604
605 0x02: US915
606
607 0x03: IN865
608
609 0x04: AU915
610
611 0x05: KZ865
612
613 0x06: RU864
614
615 0x07: AS923
616
617 0x08: AS923-1
618
619 0x09: AS923-2
620
621 0x0a: AS923-3
622
623 0x0b: CN470
624
625 0x0c: EU433
626
627 0x0d: KR920
628
629 0x0e: MA869
630
631 (% style="color:blue" %)**Sub-Band**:
632
633 AU915 and US915:value 0x00 ~~ 0x08
634
635 CN470: value 0x0B ~~ 0x0C
636
637 Other Bands: Always 0x00
638
639 (% style="color:blue" %)**Battery Info**:
640
641 Check the battery voltage.
642
643 Ex1: 0x0B45 = 2885mV
644
645 Ex2: 0x0B49 = 2889mV
646
647
648 === 2.4.2 Uplink Payload, FPORT~=2 ===
649
650
651 (((
652 DDS04-LB/LS will send this uplink **after** Device Status once join the LoRaWAN network successfully. And DDS04-LB/LS will:
653
654 periodically send this uplink every 20 minutes, this interval [[can be changed>>||anchor="H3.3.1SetTransmitIntervalTime"]].
655 )))
656
657 (((
658 Uplink payload includes in total 11 bytes.
659 )))
660
661 (% border="1" cellspacing="5" style="background-color:#f2f2f2; width:510px" %)
662 |=(% style="width: 62.5px;background-color:#4F81BD;color:white" %)(((
663 **Size(bytes)**
664 )))|=(% style="width: 62.5px;background-color:#4F81BD;color:white" %)**2**|=(% style="background-color:#4F81BD;color:white" %)**2**|=(% style="background-color:#4F81BD;color:white" %)2|=(% style="background-color:#4F81BD;color:white" %)2|=(% style="background-color:#4F81BD;color:white" %)**2**|=(% style="background-color:#4F81BD;color:white" %)1
665 |(% style="width:62.5px" %)Value|(((
666 [[BAT>>||anchor="HBatteryInfo"]]
667 &
668 [[Interrupt  flag>>||anchor="HInterruptflag26A0Interruptlevel"]]
669 &
670 [[Interrupt  level>>||anchor="HInterruptflag26A0Interruptlevel"]]
671 )))|(((
672 [[Distance of UT sensor1>>||anchor="HDistance"]]
673 )))|(((
674 [[Distance of UT sensor2>>||anchor="HDistance"]]
675 )))|(((
676 [[Distance of UT sensor3>>||anchor="HDistance"]]
677 )))|(((
678 [[Distance of UT sensor4>>||anchor="HDistance"]]
679 )))|(((
680 [[Message Type>>||anchor="HMessageType"]]
681 )))
682
683 [[image:image-20230805170701-2.png||height="139" width="755"]]
684
685
686 ==== (% style="color:blue" %)**Battery Info**(%%) ====
687
688
689 Check the battery voltage for DDS04-LB/LS.
690
691 Ex1: 0x0B45 & 0x3FFF = 2885mV
692
693 Ex2: 0x0B49 & 0x3FFF = 2889mV
694
695
696 ==== (% style="color:blue" %)**Interrupt flag & Interrupt level**(%%) ====
697
698
699 (((
700 This data field shows if this packet is generated by interrupt or not. [[Click here>>||anchor="H3.3.2SetInterruptMode"]] for the hardware and software set up.
701 )))
702
703 (((
704 (% style="color:red" %)**Note: **(%%)The Internet Pin is a separate pin in the screw terminal. See [[pin mapping>>||anchor="H1.9PinDefinitions"]] of GPIO_EXTI.
705 )))
706
707 (((
708
709 )))
710
711 (((
712 **Example:**
713 )))
714
715 (((
716 (0x0D4A & 0x4000) >>14 = 0: Normal uplink packet.
717 )))
718
719 (((
720 (0x4D41 & (% title="Click and drag to resize" %)0x4000)(%%) >>14 = 1: Interrupt Uplink Packet.
721 )))
722
723
724 (((
725 (0x0D4A & 0x8000) >>15 = 0: Pin of GPIO_EXTI is low level.
726 )))
727
728 (((
729 (0x8D41 & (% title="Click and drag to resize" %)0x8000)(%%) >>15 = 1: Pin of GPIO_EXTI is high level.
730 )))
731
732
733 ==== (% style="color:blue" %)**Distance**(%%) ====
734
735
736 (((
737 (((
738 The measuring distance of the four distance measuring modules, the default unit is cm.(% style="display:none" %)
739 )))
740
741 (((
742 **Example**:
743 )))
744
745 (((
746 Uplink Payload: 0D 4A 03 16 03 18 03 1A 03 15 01
747 )))
748
749 (((
750 (% title="Click and drag to resize" %)**Data analysis:**
751 )))
752
753 (((
754 Distance of UT sensor1 : 0316(H) = 790 (D)/10 = 79cm.
755 )))
756
757 (((
758 Distance of UT sensor2 : 0318(H) = 792 (D)/10 = 79.2cm.
759 )))
760
761 (((
762 Distance of UT sensor3 : 031A(H) = 794 (D)/10 = 79.4cm.
763 )))
764
765 (((
766 Distance of UT sensor4 : 0315(H) = 789 (D)/10 = 78.9cm.
767 )))
768 )))
769
770
771 ==== (% style="color:blue" %)**Message Type**(%%) ====
772
773
774 (((
775 For a normal uplink payload, the message type is always 0x01.
776 )))
777
778 (((
779 Valid Message Type:(% style="display:none" %) 
780 )))
781
782 (% border="1" cellspacing="5" style="background-color:#f2f2f2; width:499px" %)
783 |=(% style="width: 161px;background-color:#4F81BD;color:white" %)**Message Type Code**|=(% style="width: 164px;background-color:#4F81BD;color:white" %)**Description**|=(% style="width: 174px;background-color:#4F81BD;color:white" %)**Payload**
784 |(% style="width:160px" %)0x01|(% style="width:163px" %)Normal Uplink|(% style="width:173px" %)Normal Uplink Payload
785 |(% style="width:160px" %)0x02|(% style="width:163px" %)Reply configures info|(% style="width:173px" %)Configure Info Payload
786
787 (% class="wikigeneratedid" %)
788 [[image:image-20230805170631-1.png||height="227" width="752"]]
789
790
791 === 2.4.3 Historical measuring distance, FPORT~=3 ===
792
793
794 DDS04-LB/LS stores sensor values and users can retrieve these history values via the [[downlink command>>||anchor="H2.6.4Pollsensorvalue"]].
795
796 The historical payload includes one or multiplies entries and every entry has the same payload as Real-Time measuring distance.
797
798 (% style="color:red" %)**Note: Due to the byte limit, the history record can only save the data of the first, second, third measurement distance channels.**
799
800 (% border="1" cellspacing="5" style="background-color:#f2f2f2; width:510px" %)
801 |=(% style="width: 62.5px;background-color:#4F81BD;color:white" %)(((
802 **Size(bytes)**
803 )))|=(% style="width: 70px;background-color:#4F81BD;color:white" %)**1**|=(% style="background-color:#4F81BD;color:white" %)**2**|=(% style="background-color:#4F81BD;color:white" %)2|=(% style="background-color:#4F81BD;color:white" %)2|=(% style="background-color:#4F81BD;color:white" %)**4**
804 |(% style="width:62.5px" %)Value|(((
805 Interrupt flag & Interrupt_level
806 )))|(((
807 Distance1
808 )))|(((
809 Distance2
810 )))|(((
811 Distance3
812 )))|(((
813 Unix TimeStamp
814 )))
815
816 **Interrupt flag & Interrupt level:**
817
818 (% border="1" cellspacing="5" style="background-color:#f2f2f2; width:480px" %)
819 |=(% style="width: 60px;background-color:#4F81BD;color:white" %)(((
820 **Size(bit)**
821 )))|=(% style="width: 90px; background-color:#4F81BD; color: white;" %)**bit7**|=(% style="background-color:#4F81BD; color: white; width: 90px;" %)**bit7**|=(% style="background-color:#4F81BD; color: white; width: 60px;" %)**[bit5:bit2]**|=(% style="background-color:#4F81BD; color: white; width: 90px;" %)**bit1**|=(% style="background-color:#4F81BD; color: white; width: 90px;" %)**bit0**
822 |(% style="width:62.5px" %)Value|(% style="width:85px" %)(((
823 No ACK message
824 )))|(% style="width:87px" %)(((
825 Poll Message Flag
826 )))|(% style="width:93px" %)(((
827 Reserve
828 )))|(% style="width:80px" %)(((
829 Interrupt level
830 )))|(% style="width:82px" %)(((
831 Interrupt flag
832 )))
833
834 * (((
835 Each data entry is 11 bytes and has the same structure as [[Uplink Payload>>||anchor="H2.4.2UplinkPayload2CFPORT3D2"]], to save airtime and battery, DDS04-LB/LS will send max bytes according to the current DR and Frequency bands.
836 )))
837
838 For example, in the US915 band, the max payload for different DR is:
839
840 **a) DR0:** max is 11 bytes so one entry of data
841
842 **b) DR1:** max is 53 bytes so devices will upload 4 entries of data (total 44 bytes)
843
844 **c) DR2:** total payload includes 11 entries of data
845
846 **d) DR3:** total payload includes 22 entries of data.
847
848 If DDS04-LB/LS doesn't have any data in the polling time. It will uplink 11 bytes of 0
849
850
851 **Downlink:**
852
853 0x31 64 CC C6 9E 64 CC C7 70 05
854
855 [[image:image-20230805173511-4.png||height="127" width="768"]]
856
857 **Uplink:**
858
859 43 01 BB 0B ED 0B FE 64 CC C6 A4 40 01 BE 0B 5B 0D 31 64 CC C6 C0 40 01 BE 0B 55 0C 02 64 CC C6 FC 41 01 BE 0B 4E 0B FD 64 CC C7 17 40 01 BE 0B F4 0B F7 64 CC C7 61
860
861
862 **Parsed Value:**
863
864 [DISTANCE1 , DISTANCE2，DISTANCE3，EXTI_STATUS , EXTI_FLAG , TIME]
865
866
867 [44.3,305.3,307,High,True,2023-08-04 09:36:36],
868
869 [44.6,290.7,337.7,Low,False,2023-08-04 09:37:04],
870
871 [44.6,290.1,307.4,Low,False,2023-08-04 09:38:04],
872
873 [44.6,289.4,306.9,Low,True,2023-08-04 09:38:31],
874
875 [44.6,306,306.3,Low,False,2023-08-04 09:39:45],
876
877
878 **History read from serial port：**
879
880 [[image:image-20230805173637-5.png]]
881
882
883 === 2.4.4  Decode payload in The Things Network ===
884
885
886 While using TTN network, you can add the payload format to decode the payload.
887
888 [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDDS04%20-%20LoRaWAN%204-Channels%20Distance%20Detection%20Sensor%20User%20Manual/WebHome/1654936675588-151.png?width=762&height=379&rev=1.1||alt="1654936675588-151.png"]]
889
890
891 The payload decoder function for TTN is here:
892
893 DDS04-LB/LS TTN Payload Decoder:  [[ttps:~~/~~/github.com/dragino/dragino-end-node-decoder>>https://github.com/dragino/dragino-end-node-decoder]]
894
895
896 == 2.5 ​Show Data in DataCake IoT Server ==
897
898
899 (((
900 [[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:
901 )))
902
903
904 (((
905 (% style="color:blue" %)**Step 1**(%%)**: Be sure that your device is programmed and properly connected to the network at this time.**
906 )))
907
908 (((
909 (% 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:**
910 )))
911
912
913 [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDDS75%20-%20LoRaWAN%20Distance%20Detection%20Sensor%20User%20Manual/WebHome/1654592790040-760.png?rev=1.1||alt="1654592790040-760.png"]]
914
915
916 [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDDS75%20-%20LoRaWAN%20Distance%20Detection%20Sensor%20User%20Manual/WebHome/1654592800389-571.png?rev=1.1||alt="1654592800389-571.png"]]
917
918
919 (% style="color:blue" %)**Step 3**(%%)**: Create an account or log in Datacake.**
920
921 (% style="color:blue" %)**Step 4**(%%)**: Search the DDS04-LB/LS and add DevEUI.**
922
923
924 [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDDS04%20-%20LoRaWAN%204-Channels%20Distance%20Detection%20Sensor%20User%20Manual/WebHome/image-20220611164604-7.png?rev=1.1||alt="image-20220611164604-7.png"]]
925
926
927 [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDDS04%20-%20LoRaWAN%204-Channels%20Distance%20Detection%20Sensor%20User%20Manual/WebHome/image-20220611164604-8.png?rev=1.1||alt="image-20220611164604-8.png"]]
928
929
930 [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDDS04%20-%20LoRaWAN%204-Channels%20Distance%20Detection%20Sensor%20User%20Manual/WebHome/image-20220611164604-9.png?rev=1.1||alt="image-20220611164604-9.png"]]
931
932
933
934 (% style="color:blue" %)**Step 5**(%%)**: Add payload decode**
935
936 [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDDS04%20-%20LoRaWAN%204-Channels%20Distance%20Detection%20Sensor%20User%20Manual/WebHome/image-20220611164604-10.png?width=923&height=394&rev=1.1||alt="image-20220611164604-10.png"]]
937
938
939 [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDDS04%20-%20LoRaWAN%204-Channels%20Distance%20Detection%20Sensor%20User%20Manual/WebHome/image-20220611164604-11.png?width=931&height=303&rev=1.1||alt="image-20220611164604-11.png"]]
940
941
942 [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDDS04%20-%20LoRaWAN%204-Channels%20Distance%20Detection%20Sensor%20User%20Manual/WebHome/image-20220611164604-12.png?width=897&height=331&rev=1.1||alt="image-20220611164604-12.png"]]
943
944
945 **After added, the sensor data arrive TTN, it will also arrive and show in Datacake.**
946
947 [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDDS04%20-%20LoRaWAN%204-Channels%20Distance%20Detection%20Sensor%20User%20Manual/WebHome/image-20220611164604-13.png?width=899&height=215&rev=1.1||alt="image-20220611164604-13.png"]]
948
949
950 [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDDS04%20-%20LoRaWAN%204-Channels%20Distance%20Detection%20Sensor%20User%20Manual/WebHome/image-20220611164604-13.png?width=899&height=215&rev=1.1||alt="image-20220611164604-13.png"]]
951
952
953 [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDDS04%20-%20LoRaWAN%204-Channels%20Distance%20Detection%20Sensor%20User%20Manual/WebHome/image-20220611164604-15.png?rev=1.1||alt="image-20220611164604-15.png"]]
954
955
956 [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDDS04%20-%20LoRaWAN%204-Channels%20Distance%20Detection%20Sensor%20User%20Manual/WebHome/image-20220611164604-16.png?width=833&height=409&rev=1.1||alt="image-20220611164604-16.png"]]
957
958
959 == 2.6 Datalog Feature ==
960
961
962 Datalog Feature is to ensure IoT Server can get all sampling data from Sensor even if the LoRaWAN network is down. For each sampling, DDS04-LB/LS will store the reading for future retrieving purposes.
963
964
965 === 2.6.1 Ways to get datalog via LoRaWAN ===
966
967
968 Set PNACKMD=1, DDS04-LB/LS will wait for ACK for every uplink, when there is no LoRaWAN network, DDS04-LB/LS will mark these records with non-ack messages and store the sensor data, and it will send all messages (10s interval) after the network recovery.
969
970 * (((
971 a) DDS04-LB/LS will do an ACK check for data records sending to make sure every data arrive server.
972 )))
973 * (((
974 b) DDS04-LB/LS will send data in **CONFIRMED Mode** when PNACKMD=1, but DDS04-LB/LS won't re-transmit the packet if it doesn't get ACK, it will just mark it as a NONE-ACK message. In a future uplink if DDS04-LB/LS gets a ACK, DDS04-LB/LS will consider there is a network connection and resend all NONE-ACK messages.
975 )))
976
977 === 2.6.2 Unix TimeStamp ===
978
979
980 DDS04-LB/LS uses Unix TimeStamp format based on
981
982 [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LHT65N%20LoRaWAN%20Temperature%20%26%20Humidity%20Sensor%20Manual/WebHome/image-20220523001219-11.png?width=627&height=97&rev=1.1||alt="图片-20220523001219-11.png" height="97" width="627"]]
983
984 User can get this time from link:  [[https:~~/~~/www.epochconverter.com/>>url:https://www.epochconverter.com/]] :
985
986 Below is the converter example
987
988 [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LHT65N%20LoRaWAN%20Temperature%20%26%20Humidity%20Sensor%20Manual/WebHome/image-20220523001219-12.png?width=720&height=298&rev=1.1||alt="图片-20220523001219-12.png" height="298" width="720"]]
989
990
991 So, we can use AT+TIMESTAMP=1611889405 or downlink 3060137afd00 to set the current time 2021 – Jan ~-~- 29 Friday 03:03:25
992
993
994 === 2.6.3 Set Device Time ===
995
996
997 User need to set (% style="color:blue" %)**SYNCMOD=1**(%%) to enable sync time via MAC command.
998
999 Once DDS04-LB/LS Joined LoRaWAN network, it will send the MAC command (DeviceTimeReq) and the server will reply with (DeviceTimeAns) to send the current time to DDS04-LB/LS. If DDS04-LB/LS fails to get the time from the server, DDS04-LB/LS will use the internal time and wait for next time request (AT+SYNCTDC to set the time request period, default is 10 days).
1000
1001 (% style="color:red" %)**Note: LoRaWAN Server need to support LoRaWAN v1.0.3(MAC v1.0.3) or higher to support this MAC command feature, Chirpstack,TTN V3 v3 and loriot support but TTN V3 v2 doesn't support. If server doesn't support this command, it will through away uplink packet with this command, so user will lose the packet with time request for TTN V3 v2 if SYNCMOD=1.**
1002
1003
1004 === 2.6.4 Poll sensor value ===
1005
1006
1007 Users can poll sensor values based on timestamps. Below is the downlink command.
1008
1009 (% border="1" cellspacing="5" style="background-color:#f2f2f2; width:425.818px" %)
1010 |(% colspan="4" style="background-color:#4f81bd; color:white; width:423px" %)**Downlink Command to poll Open/Close status (0x31)**
1011 |(% style="width:58px" %)**1byte**|(% style="width:127px" %)**4bytes**|(% style="width:124px" %)**4bytes**|(% style="width:114px" %)**1byte**
1012 |(% style="width:58px" %)31|(% style="width:127px" %)Timestamp start|(% style="width:124px" %)Timestamp end|(% style="width:114px" %)Uplink Interval
1013
1014 (((
1015 Timestamp start and Timestamp end-use Unix TimeStamp format as mentioned above. Devices will reply with all data logs during this period, using the uplink interval.
1016 )))
1017
1018 (((
1019 For example, downlink command [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/CPL01%20LoRaWAN%20Outdoor%20PulseContact%20%20Sensor%20Manual/WebHome/image-20220518162852-1.png?rev=1.1||alt="image-20220518162852-1.png"]]
1020 )))
1021
1022 (((
1023 Is to check 2021/11/12 12:00:00 to 2021/11/12 15:00:00's data
1024 )))
1025
1026 (((
1027 Uplink Internal =5s，means DDS04-LB/LS will send one packet every 5s. range 5~~255s.
1028 )))
1029
1030
1031 == 2.7 Frequency Plans ==
1032
1033
1034 The DDS04-LB/LS uses OTAA mode and below frequency plans by default. Each frequency band use different firmware, user update the firmware to the corresponding band for their country.
1035
1036 [[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20Frequency%20Band/>>http://wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20Frequency%20Band/]]
1037
1038
1039 = 3. Configure DDS04-LB/LS =
1040
1041 == 3.1 Configure Methods ==
1042
1043
1044 DDS04-LB/LS supports below configure method:
1045
1046 * AT Command via Bluetooth Connection (**Recommended**): [[BLE Configure Instruction>>http://wiki.dragino.com/xwiki/bin/view/Main/BLE%20Bluetooth%20Remote%20Configure/]].
1047
1048 * AT Command via UART Connection : See [[UART Connection>>http://wiki.dragino.com/xwiki/bin/view/Main/UART%20Access%20for%20LoRa%20ST%20v4%20base%20model/#H2.3UARTConnectionforSN50v3basemotherboard]].
1049
1050 * LoRaWAN Downlink.  Instruction for different platforms: See [[IoT LoRaWAN Server>>http://wiki.dragino.com/xwiki/bin/view/Main/]] section.
1051
1052 == 3.2 General Commands ==
1053
1054
1055 These commands are to configure:
1056
1057 * General system settings like: uplink interval.
1058
1059 * LoRaWAN protocol & radio related command.
1060
1061 They are same for all Dragino Devices which support DLWS-005 LoRaWAN Stack. These commands can be found on the wiki:
1062
1063 [[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20AT%20Commands%20and%20Downlink%20Command/>>http://wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20AT%20Commands%20and%20Downlink%20Command/]]
1064
1065
1066 == 3.3 Commands special design for DDS04-LB/LS ==
1067
1068
1069 These commands only valid for DDS04-LB/LS, as below:
1070
1071
1072 === 3.3.1 Set Transmit Interval Time ===
1073
1074
1075 (((
1076 Feature: Change LoRaWAN End Node Transmit Interval.
1077 )))
1078
1079 (((
1080 (% style="color:blue" %)**AT Command: AT+TDC**
1081 )))
1082
1083 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
1084 |=(% style="width: 156px;background-color:#4F81BD;color:white" %)**Command Example**|=(% style="width: 137px;background-color:#4F81BD;color:white" %)**Function**|=(% style="background-color:#4F81BD;color:white" %)**Response**
1085 |(% style="width:156px" %)AT+TDC=?|(% style="width:137px" %)Show current transmit Interval|(((
1086 30000
1087 OK
1088 the interval is 30000ms = 30s
1089 )))
1090 |(% style="width:156px" %)AT+TDC=60000|(% style="width:137px" %)Set Transmit Interval|(((
1091 OK
1092 Set transmit interval to 60000ms = 60 seconds
1093 )))
1094
1095 (((
1096 (% style="color:blue" %)**Downlink Command: 0x01**
1097 )))
1098
1099 (((
1100 Format: Command Code (0x01) followed by 3 bytes time value.
1101 )))
1102
1103 (((
1104 If the downlink payload=0100003C, it means set the END Node's Transmit Interval to 0x00003C=60(S), while type code is 01.
1105 )))
1106
1107 * (((
1108 Example 1: Downlink Payload: 0100001E  ~/~/ Set Transmit Interval (TDC) = 30 seconds
1109 )))
1110 * (((
1111 Example 2: Downlink Payload: 0100003C  ~/~/ Set Transmit Interval (TDC) = 60 seconds
1112
1113
1114
1115 )))
1116
1117 === 3.3.2 Set Interrupt Mode ===
1118
1119
1120 Feature, Set Interrupt mode for pin of GPIO_EXTI.
1121
1122 When AT+INTMOD=0 is set, GPIO_EXTI is used as a digital input port.
1123
1124 (% style="color:blue" %)**AT Command: AT+INTMOD**
1125
1126 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
1127 |=(% style="width: 155px;background-color:#4F81BD;color:white" %)**Command Example**|=(% style="width: 197px;background-color:#4F81BD;color:white" %)**Function**|=(% style="width: 158px;background-color:#4F81BD;color:white" %)**Response**
1128 |(% style="width:154px" %)AT+INTMOD=?|(% style="width:196px" %)Show current interrupt mode|(% style="width:157px" %)(((
1129 0
1130 OK
1131 the mode is 0 =Disable Interrupt
1132 )))
1133 |(% style="width:154px" %)(((
1134 AT+INTMOD=2
1135
1136 (default)
1137 )))|(% style="width:196px" %)(((
1138 Set Transmit Interval
1139 0. (Disable Interrupt),
1140 ~1. (Trigger by rising and falling edge)
1141 2. (Trigger by falling edge)
1142 3. (Trigger by rising edge)
1143 )))|(% style="width:157px" %)OK
1144
1145 (% style="color:blue" %)**Downlink Command: 0x06**
1146
1147 Format: Command Code (0x06) followed by 3 bytes.
1148
1149 This means that the interrupt mode of the end node is set to 0x000003=3 (rising edge trigger), and the type code is 06.
1150
1151 * Example 1: Downlink Payload: 06000000  ~/~/  Turn off interrupt mode
1152
1153 * Example 2: Downlink Payload: 06000003  ~/~/  Set the interrupt mode to rising edge trigger
1154
1155 === 3.3.3 Set Power Output Duration ===
1156
1157
1158 Control the output duration 3V3 (pin of VBAT_OUT). Before each sampling, device will
1159
1160 ~1. first enable the power output to external sensor,
1161
1162 2. keep it on as per duration, read sensor value and construct uplink payload
1163
1164 3. final, close the power output.
1165
1166 (% style="color:blue" %)**AT Command: AT+3V3T**
1167
1168 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
1169 |=(% style="width: 155px;background-color:#4F81BD;color:white" %)**Command Example**|=(% style="width: 197px;background-color:#4F81BD;color:white" %)**Function**|=(% style="width: 158px;background-color:#4F81BD;color:white" %)**Response**
1170 |(% style="width:154px" %)AT+3V3T=?|(% style="width:196px" %)Show 3V3 open time.|(% style="width:157px" %)0 (default)
1171 OK
1172 |(% style="width:154px" %)AT+3V3T=1000|(% style="width:196px" %)Close after a delay of 1000 milliseconds.|(% style="width:157px" %)OK
1173 |(% style="width:154px" %)AT+3V3T=0|(% style="width:196px" %)Always turn on the power supply of 3V3 pin.|(% style="width:157px" %)OK
1174 |(% style="width:154px" %)AT+3V3T=65535|(% style="width:196px" %)Always turn off the power supply of 3V3 pin.|(% style="width:157px" %)OK
1175
1176 (% style="color:blue" %)**Downlink Command: 0x07**
1177
1178 Format: Command Code (0x07) followed by 3 bytes.
1179
1180 The first byte is 01,the second and third bytes are the time to turn on.
1181
1182 * Example 1: Downlink Payload: 07 01 00 00  **~-~-->**  AT+3V3T=0
1183 * Example 2: Downlink Payload: 07 01 01 F4  **~-~-->**  AT+3V3T=500
1184 * Example 3: Downlink Payload: 07 01 FF FF  **~-~-->**  AT+3V3T=65535
1185
1186 === 3.3.4 Set enable or disable of the measurement channel ===
1187
1188
1189 This command can be used when user connects **less than four distance sensors**. This command can turn off unused measurement channels to **save battery life**.
1190
1191 (% style="color:blue" %)**AT Command: AT+ENCHANNEL**
1192
1193
1194 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:500px" %)
1195 |=(% style="width: 185px; background-color: #4F81BD; color: white;" %)**Command Example**|=(% style="width: 193px; background-color: #4F81BD; color: white;" %)**Function**|=(% style="width: 122px; background-color: #4F81BD; color: white;" %)**Response**
1196 |(% style="width:199px" %)AT+ENCHANNEL=?|(% style="width:199px" %)Get enabled channels.|(% style="width:150px" %)1,1,1,1 (default)
1197 OK
1198 |(% style="width:199px" %)AT+ENCHANNEL=1,1,1,0|(% style="width:199px" %)Channel 4 disabled.|(% style="width:150px" %)OK
1199 |(% style="width:199px" %)AT+ENCHANNEL=1,1,0,0|(% style="width:199px" %)Channel 3 and 4 disabled.|(% style="width:150px" %)OK
1200
1201 (% style="color:blue" %)**Downlink Command: 0x08**
1202
1203 Format: Command Code (0x08) followed by 4 bytes.
1204
1205 The first byte means the first channel, the second byte means the second channel, the third byte means the third channel, and the fourth byte means the fourth channel.And 1 means enable channel, 0 means disable channel.
1206
1207 * Example 1: Downlink Payload: 08 01 01 01 01  **~-~-->**  AT+ENCHANNEL=1,1,1,1  ~/~/All channels are enabled
1208
1209 * Example 2: Downlink Payload: 08 01 01 01 00  **~-~-->**  AT+ENCHANNEL=1,1,1,0  ~/~/Channel 4 disabled
1210
1211 * Example 3: Downlink Payload: 08 01 01 00 00  **~-~-->**  AT+ENCHANNEL=1,1,0,0  ~/~/Channel 3 and 4 disabled
1212
1213 = 4. Battery & Power Consumption =
1214
1215
1216 DDS04-LB use ER26500 + SPC1520 battery pack and DDS04-LS use 3000mAh Recharable Battery with Solar Panel. See below link for detail information about the battery info and how to replace.
1217
1218 [[**Battery Info & Power Consumption Analyze**>>http://wiki.dragino.com/xwiki/bin/view/Main/How%20to%20calculate%20the%20battery%20life%20of%20Dragino%20sensors%3F/]] .
1219
1220
1221 = 5. OTA Firmware update =
1222
1223
1224 (% class="wikigeneratedid" %)
1225 User can change firmware DDS04-LB/LS to:
1226
1227 * Change Frequency band/ region.
1228
1229 * Update with new features.
1230
1231 * Fix bugs.
1232
1233 Firmware and changelog can be downloaded from : **[[Firmware download link>>https://www.dropbox.com/sh/z4y0v06hajv6omk/AAAgddLEpwawt9uLw6PR-_X1a?dl=0]]**
1234
1235 Methods to Update Firmware:
1236
1237 * (Recommanded way) OTA firmware update via wireless:  **[[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/Firmware%20OTA%20Update%20for%20Sensors/>>url:http://wiki.dragino.com/xwiki/bin/view/Main/Firmware%20OTA%20Update%20for%20Sensors/]]**
1238
1239 * Update through UART TTL interface: **[[Instruction>>url:http://wiki.dragino.com/xwiki/bin/view/Main/UART%20Access%20for%20LoRa%20ST%20v4%20base%20model/#H1.LoRaSTv4baseHardware]]**.
1240
1241 = 6. FAQ =
1242
1243 == 6.1  What is the frequency plan for DDS04-LB/LS? ==
1244
1245
1246 DDS04-LB/LS 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"]]
1247
1248
1249 = 7.  Trouble Shooting =
1250
1251 == 7.1  Why I can't join TTN V3 in US915 / AU915 bands? ==
1252
1253
1254 It is due to channel mapping. Please see below link:  [[Frequency band>>doc:Main.LoRaWAN Communication Debug.WebHome||anchor="H2.NoticeofUS9152FCN4702FAU915Frequencyband"]]
1255
1256
1257 == 7.2  AT Command input doesn't work ==
1258
1259
1260 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:blue" %)**ENTER**(%%) while sending out the command. Some serial tool doesn't send (% style="color:blue" %)**ENTER**(%%) while press the send key, user need to add ENTER in their string.
1261
1262
1263 == 7.3  Why does the sensor reading show 0 or "No sensor" ==
1264
1265
1266 ~1. The measurement object is very close to the sensor, but in the blind spot of the sensor.
1267
1268 2. Sensor wiring is disconnected
1269
1270 3. Not using the correct decoder
1271
1272
1273 = 8. Order Info =
1274
1275 == 8.1  Main Device DDS04-LB/LS ==
1276
1277
1278 **Part Number : (% style="color:blue" %)DDS04-LB-XX (%%)or (% style="color:blue" %)DDS04-LS-XX(%%)**
1279
1280 (% style="color:blue" %)**XX**(%%)**: **The default frequency band
1281
1282 * (% style="color:red" %)**AS923 **(%%)**:** LoRaWAN AS923 band
1283 * (% style="color:red" %)**AU915 **(%%)**:** LoRaWAN AU915 band
1284 * (% style="color:red" %)**EU433 **(%%)**:** LoRaWAN EU433 band
1285 * (% style="color:red" %)**EU868 **(%%)**:** LoRaWAN EU868 band
1286 * (% style="color:red" %)**KR920 **(%%)**:** LoRaWAN KR920 band
1287 * (% style="color:red" %)**US915 **(%%)**:** LoRaWAN US915 band
1288 * (% style="color:red" %)**IN865 **(%%)**:**  LoRaWAN IN865 band
1289 * (% style="color:red" %)**CN470 **(%%)**:** LoRaWAN CN470 band
1290
1291 == 8.2  Probe Model ==
1292
1293
1294 Detail See [[Probe Option>>||anchor="H1.4ProbeOptions"]] Section
1295
1296 * A01A-15
1297 * A02-15
1298 * A13-15
1299 * A16-15
1300
1301 = 9. ​Packing Info =
1302
1303
1304 (% style="color:#037691" %)**Package Includes**:
1305
1306 * DDS04-LB or DDS04-LS LoRaWAN 4-Channels Distance Detection Sensor x 1
1307
1308 (% style="color:#037691" %)**Dimension and weight**:
1309
1310 * Device Size: cm
1311
1312 * Device Weight: g
1313
1314 * Package Size / pcs : cm
1315
1316 * Weight / pcs : g
1317
1318 = 10. Support =
1319
1320
1321 * 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.
1322
1323 * 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.cc>>mailto:Support@dragino.cc]].