Skip to Content
Last modified by Mengting Qiu on 2023/12/14 11:15
From version 124.2
edited by Xiaoling
on 2023/11/28 15:12
Change comment: There is no comment for this version
To version 113.5
edited by Xiaoling
on 2023/11/10 09:51
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -22,7 +22,7 @@
22 22  == 1.1 What is LoRaWAN Smart Distance Detector ==
23 23  
24 24  
25 -The Dragino (% style="color:blue" %)**DS20L is a smart distance detector**(%%) base on long-range wireless LoRaWAN technology. It uses (% style="color:blue" %)**LiDAR sensor**(%%) to detect the distance between DS20L and object, then DS20L will send the distance data to the IoT Platform via LoRaWAN. DS20L can measure range between 3cm ~~ 200cm.
25 +The Dragino (% style="color:blue" %)**DS20L is a smart distance detector**(%%) base on long-range wireless LoRaWAN technology. It uses (% style="color:blue" %)**LiDAR sensor**(%%) to detect the distance between DS20L and object, then DS20L will send the distance data to the IoT Platform via LoRaWAN.
26 26  
27 27  DS20L allows users to send data and reach extremely long ranges via LoRaWAN. It provides ultra-long range spread spectrum communication and high interference immunity whilst minimizing current 
28 28  consumption. It targets professional wireless sensor network applications such smart cities, building automation, and so on.
... ... @@ -31,8 +31,9 @@
31 31  
32 32  DS20L is fully compatible with (% style="color:blue" %)**LoRaWAN v1.0.3 Class A protocol**(%%), it can work with a standard LoRaWAN gateway.
33 33  
34 +DS20L supports (% style="color:blue" %)**Datalog feature**(%%). It will record the data when there is no network coverage and users can retrieve the sensor value later to ensure no miss for every sensor reading.
34 34  
35 -[[image:image-20231110102635-5.png||height="402" width="807"]]
36 +[[image:image-20231110091506-4.png||height="391" width="768"]]
36 36  
37 37  
38 38  == 1.2 ​Features ==
... ... @@ -44,6 +44,7 @@
44 44  * AT Commands to change parameters
45 45  * Remotely configure parameters via LoRaWAN Downlink
46 46  * Alarm & Counting mode
48 +* Datalog Feature
47 47  * Firmware upgradable via program port or LoRa protocol
48 48  * Built-in 2400mAh battery or power by external power source
49 49  
... ... @@ -60,25 +60,16 @@
60 60  * ToF FoV: ±9°, Total 18°
61 61  * Light source: VCSEL
62 62  
63 -== 1.4 Power Consumption ==
64 64  
66 +(% style="display:none" %)
65 65  
66 -(% style="color:#037691" %)**Battery Power Mode:**
67 67  
68 -* Idle: 0.003 mA @ 3.3v
69 -* Max : 360 mA
70 -
71 -(% style="color:#037691" %)**Continuously mode**:
72 -
73 -* Idle: 21 mA @ 3.3v
74 -* Max : 360 mA
75 -
76 76  = 2. Configure DS20L to connect to LoRaWAN network =
77 77  
78 78  == 2.1 How it works ==
79 79  
80 80  
81 -The DS20L 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 DS20L. It will automatically join the network via OTAA and start to send the sensor value. The default uplink interval is 20 minutes.
74 +The LDS12-LB 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 LDS12-LB. It will automatically join the network via OTAA and start to send the sensor value. The default uplink interval is 20 minutes.
82 82  
83 83  (% style="display:none" %) (%%)
84 84  
... ... @@ -87,14 +87,15 @@
87 87  
88 88  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.
89 89  
90 -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.(% style="display:none" %)
83 +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.
91 91  
92 -[[image:image-20231110102635-5.png||height="402" width="807"]](% style="display:none" %)
85 +[[image:image-20231110091447-3.png||height="383" width="752"]](% style="display:none" %)
93 93  
94 -(% style="color:blue" %)**Step 1:**(%%) Create a device in TTN with the OTAA keys from DS20L.
95 95  
96 -Each DS20L is shipped with a sticker with the default device EUI as below:
88 +(% style="color:blue" %)**Step 1:**(%%) Create a device in TTN with the OTAA keys from LDS12-LB.
97 97  
90 +Each LDS12-LB is shipped with a sticker with the default device EUI as below:
91 +
98 98  [[image:image-20230426084152-1.png||alt="图片-20230426084152-1.png" height="233" width="502"]]
99 99  
100 100  
... ... @@ -122,11 +122,10 @@
122 122  [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LSN50v2-S31-S31B%20LoRaWAN%20Temperature%20%26%20Humidity%20Sensor%20User%20Manual/WebHome/image-20220611161308-6.png?width=744&height=485&rev=1.1||alt="图片-20220611161308-6.png"]]
123 123  
124 124  
125 -(% style="color:blue" %)**Step 2:**(%%) Activate on DS20L
119 +(% style="color:blue" %)**Step 2:**(%%) Activate on LDS12-LB
126 126  
127 -[[image:image-20231128133704-1.png||height="189" width="441"]]
128 128  
129 -Press the button for 5 seconds to activate the DS20L.
122 +Press the button for 5 seconds to activate the LDS12-LB.
130 130  
131 131  (% 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.
132 132  
... ... @@ -138,7 +138,7 @@
138 138  === 2.3.1 Device Status, FPORT~=5 ===
139 139  
140 140  
141 -Users can use the downlink command(**0x26 01**) to ask DS20L to send device configure detail, include device configure status. DS20L will uplink a payload via FPort=5 to server.
134 +Users can use the downlink command(**0x26 01**) to ask LDS12-LB to send device configure detail, include device configure status. LDS12-LB will uplink a payload via FPort=5 to server.
142 142  
143 143  The Payload format is as below.
144 144  
... ... @@ -150,9 +150,9 @@
150 150  
151 151  Example parse in TTNv3
152 152  
153 -[[image:1701149922873-259.png]]
146 +[[image:image-20230805103904-1.png||height="131" width="711"]]
154 154  
155 -(% style="color:blue" %)**Sensor Model**(%%): For DS20L, this value is 0x21
148 +(% style="color:blue" %)**Sensor Model**(%%): For LDS12-LB, this value is 0x24
156 156  
157 157  (% style="color:blue" %)**Firmware Version**(%%): 0x0100, Means: v1.0.0 version
158 158  
... ... @@ -206,121 +206,138 @@
206 206  === 2.3.2 Uplink Payload, FPORT~=2 ===
207 207  
208 208  
209 -==== (% style="color:red" %)**MOD~=1**(%%) ====
202 +(((
203 +LDS12-LB will send this uplink **after** Device Status once join the LoRaWAN network successfully. And LDS12-LB will:
210 210  
211 -Regularly detect distance and report. When the distance exceeds the limit, the alarm flag is set to 1, and the report can be triggered by external interrupts.
205 +periodically send this uplink every 20 minutes, this interval [[can be changed>>||anchor="H3.3.1SetTransmitIntervalTime"]].
212 212  
213 -Uplink Payload totals 10 bytes.
207 +Uplink Payload totals 11 bytes.
208 +)))
214 214  
215 215  (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
216 -|(% style="background-color:#4f81bd; color:white; width:60px" %)**Size(bytes)**|(% style="background-color:#4f81bd; color:white; width:30px" %)**2**|(% style="background-color:#4f81bd; color:white; width:130px" %)**1**|(% style="background-color:#4f81bd; color:white; width:70px" %)**2**|(% style="background-color:#4f81bd; color:white; width:100px" %)**1**|(% style="background-color:#4f81bd; color:white; width:120px" %)**4**
217 -|(% style="width:91px" %)Value|(% style="width:41px" %)BAT|(% style="width:176px" %)MOD+ Alarm+Interrupt|(% style="width:74px" %)Distance|(% style="width:100px" %)Sensor State|(% style="width:119px" %)Interrupt Count
211 +|=(% style="width: 60px;background-color:#4F81BD;color:white" %)(((
212 +**Size(bytes)**
213 +)))|=(% style="width: 30px;background-color:#4F81BD;color:white" %)**2**|=(% style="width: 80px;background-color:#4F81BD;color:white" %)**2**|=(% style="width: 50px;background-color:#4F81BD;color:white" %)**2**|=(% style="width: 70px;background-color:#4F81BD;color:white" %)**2**|=(% style="background-color:#4F81BD;color:white; width: 80px;" %)**1**|=(% style="background-color: #4F81BD;color:white; width: 70px;" %)**1**|=(% style="background-color: #4F81BD;color:white; width: 70px;" %)**1**
214 +|(% style="width:62.5px" %)Value|(% style="width:62.5px" %)[[BAT>>||anchor="HBatteryInfo"]]|(% style="width:62.5px" %)(((
215 +[[Temperature DS18B20>>||anchor="HDS18B20Temperaturesensor"]]
216 +)))|[[Distance>>||anchor="HDistance"]]|[[Distance signal strength>>||anchor="HDistancesignalstrength"]]|(% style="width:122px" %)(((
217 +[[Interrupt flag & Interrupt_level>>||anchor="HInterruptPin26A0InterruptLevel"]]
218 +)))|(% style="width:54px" %)[[LiDAR temp>>||anchor="HLiDARtemp"]]|(% style="width:96px" %)(((
219 +[[Message Type>>||anchor="HMessageType"]]
220 +)))
218 218  
219 -[[image:1701155076393-719.png]]
222 +[[image:image-20230805104104-2.png||height="136" width="754"]]
220 220  
221 -(% style="color:blue" %)**Battery Info:**
222 222  
223 -Check the battery voltage for DS20L
225 +==== (% style="color:blue" %)**Battery Info**(%%) ====
224 224  
225 -Ex1: 0x0E10 = 3600mV
226 226  
228 +Check the battery voltage for LDS12-LB.
227 227  
228 -(% style="color:blue" %)**MOD & Alarm & Interrupt:**
230 +Ex1: 0x0B45 = 2885mV
229 229  
230 -(% style="color:red" %)**MOD:**
232 +Ex2: 0x0B49 = 2889mV
231 231  
232 -**Example: ** (0x60>>6) & 0x3f =1
233 233  
234 -**0x01:**  Regularly detect distance and report.
235 -**0x02: ** Uninterrupted measurement (external power supply).
235 +==== (% style="color:blue" %)**DS18B20 Temperature sensor**(%%) ====
236 236  
237 -(% style="color:red" %)**Alarm:**
238 238  
239 -When the detection distance exceeds the limit, the alarm flag is set to 1.
238 +This is optional, user can connect external DS18B20 sensor to the +3.3v, 1-wire and GND pin . and this field will report temperature.
240 240  
241 -(% style="color:red" %)**Interrupt:**
242 242  
243 -Whether it is an external interrupt.
241 +**Example**:
244 244  
243 +If payload is: 0105H:  (0105 & FC00 == 0), temp = 0105H /10 = 26.1 degree
245 245  
246 -(% style="color:blue" %)**Distance info:**
245 +If payload is: FF3FH :  (FF3F & FC00 == 1) , temp = (FF3FH - 65536)/10 = -19.3 degrees.
247 247  
247 +
248 +==== (% style="color:blue" %)**Distance**(%%) ====
249 +
250 +
251 +Represents the distance value of the measurement output, the default unit is cm, and the value range parsed as a decimal number is 0-1200. In actual use, when the signal strength value Strength.
252 +
253 +
248 248  **Example**:
249 249  
250 -If payload is: 0708H: distance = 0708H = 1800 mm
256 +If the data you get from the register is 0x0B 0xEA, the distance between the sensor and the measured object is 0BEA(H) = 3050 (D)/10 = 305cm.
251 251  
252 252  
253 -(% style="color:blue" %)**Sensor State:**
259 +==== (% style="color:blue" %)**Distance signal strength**(%%) ====
254 254  
255 -Ex1: 0x00: Normal collection distance
256 256  
257 -Ex2 0x0x: Distance collection is wrong
262 +Refers to the signal strength, the default output value will be between 0-65535. When the distance measurement gear is fixed, the farther the distance measurement is, the lower the signal strength; the lower the target reflectivity, the lower the signal strength. When Strength is greater than 100 and not equal to 65535, the measured value of Dist is considered credible.
258 258  
259 259  
260 -(% style="color:blue" %)**Interript Count:**
265 +**Example**:
261 261  
262 -If payload is:000007D0H: count = 07D0H =2000
267 +If payload is: 01D7(H)=471(D), distance signal strength=471, 471>100,471≠65535, the measured value of Dist is considered credible.
263 263  
269 +Customers can judge whether they need to adjust the environment based on the signal strength.
264 264  
265 265  
266 -==== (% style="color:red" %)**MOD~=2**(%%)** ** ====
272 +**1) When the sensor detects valid data:**
267 267  
268 -Uninterrupted measurement. When the distance exceeds the limit, the output IO is set high and reports are reported every five minutes. The time can be set and powered by an external power supply.Uplink Payload totals 11bytes.
274 +[[image:image-20230805155335-1.png||height="145" width="724"]]
269 269  
270 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
271 -|(% style="background-color:#4f81bd; color:white; width:70px" %)**Size(bytes)**|(% style="background-color:#4f81bd; color:white; width:40px" %)**2**|(% style="background-color:#4f81bd; color:white; width:130px" %)**1**|(% style="background-color:#4f81bd; color:white; width:130px" %)**4**|(% style="background-color:#4f81bd; color:white; width:70px" %)**2**|(% style="background-color:#4f81bd; color:white; width:70px" %)**2**
272 -|(% style="width:91px" %)Value|(% style="width:41px" %)BAT|(% style="width:176px" %)MOD+Alarm+Do+Limit flag|(% style="width:74px" %)Distance Limit Alarm count|(% style="width:100px" %)Upper limit|(% style="width:119px" %)Lower limit
273 273  
274 -[[image:1701155150328-206.png]]
277 +**2) When the sensor detects invalid data:**
275 275  
276 -(% style="color:blue" %)**MOD & Alarm & Do & Limit flag:**
279 +[[image:image-20230805155428-2.png||height="139" width="726"]]
277 277  
278 -(% style="color:red" %)**MOD:**
279 279  
280 -**Example: ** (0x60>>6) & 0x3f =1
282 +**3) When the sensor is not connected:**
281 281  
282 -**0x01:**  Regularly detect distance and report.
283 -**0x02: ** Uninterrupted measurement (external power supply).
284 +[[image:image-20230805155515-3.png||height="143" width="725"]]
284 284  
285 -(% style="color:red" %)**Alarm:**
286 286  
287 -When the detection distance exceeds the limit, the alarm flag is set to 1.
287 +==== (% style="color:blue" %)**Interrupt Pin & Interrupt Level**(%%) ====
288 288  
289 -(% style="color:red" %)**Do:**
290 290  
291 -When the distance exceeds the set threshold, pull the Do pin high.
290 +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.
292 292  
293 -(% style="color:red" %)**Limit flag:**
292 +Note: The Internet Pin is a separate pin in the screw terminal. See [[pin mapping>>||anchor="H1.8PinDefinitions"]] of GPIO_EXTI .
294 294  
295 -Mode for setting threshold: 0~~5
294 +**Example:**
296 296  
297 -0: does not use upper and lower limits
296 +If byte[0]&0x01=0x00 : Normal uplink packet.
298 298  
299 -1: Use upper and lower limits
298 +If byte[0]&0x01=0x01 : Interrupt Uplink Packet.
300 300  
301 -2: is less than the lower limit value
302 302  
303 -3: is greater than the lower limit value
301 +==== (% style="color:blue" %)**LiDAR temp**(%%) ====
304 304  
305 -4: is less than the upper limit
306 306  
307 -5: is greater than the upper limit
304 +Characterize the internal temperature value of the sensor.
308 308  
306 +**Example: **
307 +If payload is: 1C(H) <<24>>24=28(D),LiDAR temp=28℃.
308 +If payload is: F2(H) <<24>>24=-14(D),LiDAR temp=-14℃.
309 309  
310 -(% style="color:blue" %)**Upper limit:**
311 311  
312 -The upper limit of the threshold cannot exceed 2000mm.
311 +==== (% style="color:blue" %)**Message Type**(%%) ====
313 313  
314 314  
315 -(% style="color:blue" %)**Lower limit:**
314 +(((
315 +For a normal uplink payload, the message type is always 0x01.
316 +)))
316 316  
317 -The lower limit of the threshold cannot be less than 3mm.
318 +(((
319 +Valid Message Type:
320 +)))
318 318  
322 +(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:499px" %)
323 +|=(% 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**
324 +|(% style="width:160px" %)0x01|(% style="width:163px" %)Normal Uplink|(% style="width:173px" %)Normal Uplink Payload
325 +|(% style="width:160px" %)0x02|(% style="width:163px" %)Reply configures info|(% style="width:173px" %)Configure Info Payload
319 319  
327 +[[image:image-20230805150315-4.png||height="233" width="723"]]
328 +
329 +
320 320  === 2.3.3 Historical measuring distance, FPORT~=3 ===
321 321  
322 322  
323 -DS20L stores sensor values and users can retrieve these history values via the [[downlink command>>||anchor="H2.5.4Pollsensorvalue"]].
333 +LDS12-LB stores sensor values and users can retrieve these history values via the [[downlink command>>||anchor="H2.5.4Pollsensorvalue"]].
324 324  
325 325  The historical payload includes one or multiplies entries and every entry has the same payload as Real-Time measuring distance.
326 326  
... ... @@ -345,7 +345,7 @@
345 345  )))
346 346  
347 347  * (((
348 -Each data entry is 11 bytes and has the same structure as [[Uplink Payload>>||anchor="H2.3.2UplinkPayload2CFPORT3D2"]], to save airtime and battery, DS20L will send max bytes according to the current DR and Frequency bands.
358 +Each data entry is 11 bytes and has the same structure as [[Uplink Payload>>||anchor="H2.3.2UplinkPayload2CFPORT3D2"]], to save airtime and battery, LDS12-LB will send max bytes according to the current DR and Frequency bands.
349 349  )))
350 350  
351 351  For example, in the US915 band, the max payload for different DR is:
... ... @@ -358,7 +358,7 @@
358 358  
359 359  **d) DR3:** total payload includes 22 entries of data.
360 360  
361 -If DS20L doesn't have any data in the polling time. It will uplink 11 bytes of 0
371 +If LDS12-LB doesn't have any data in the polling time. It will uplink 11 bytes of 0
362 362  
363 363  
364 364  **Downlink:**
... ... @@ -412,7 +412,7 @@
412 412  )))
413 413  
414 414  (((
415 -DS20L TTN Payload Decoder:  [[https:~~/~~/github.com/dragino/dragino-end-node-decoder>>https://github.com/dragino/dragino-end-node-decoder]]
425 +LDS12-LB TTN Payload Decoder:  [[https:~~/~~/github.com/dragino/dragino-end-node-decoder>>https://github.com/dragino/dragino-end-node-decoder]]
416 416  )))
417 417  
418 418  
... ... @@ -441,7 +441,7 @@
441 441  
442 442  (% style="color:blue" %)**Step 3**(%%)**: Create an account or log in Datacake.**
443 443  
444 -(% style="color:blue" %)**Step 4**(%%)**: Search the DS20L and add DevEUI.**
454 +(% style="color:blue" %)**Step 4**(%%)**: Search the LDS12-LB and add DevEUI.**
445 445  
446 446  [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDDS75%20-%20LoRaWAN%20Distance%20Detection%20Sensor%20User%20Manual/WebHome/1654851029373-510.png?rev=1.1||alt="1654851029373-510.png"]]
447 447  
... ... @@ -448,23 +448,97 @@
448 448  
449 449  After added, the sensor data arrive TTN V3, it will also arrive and show in Datacake.
450 450  
451 -[[image:1701152946067-561.png]]
461 +[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDDS75%20-%20LoRaWAN%20Distance%20Detection%20Sensor%20User%20Manual/WebHome/image-20220610165129-11.png?width=1088&height=595&rev=1.1||alt="image-20220610165129-11.png"]]
452 452  
453 453  
454 -== 2.5 Frequency Plans ==
464 +== 2.5 Datalog Feature ==
455 455  
456 456  
457 -The DS20L 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.
467 +Datalog Feature is to ensure IoT Server can get all sampling data from Sensor even if the LoRaWAN network is down. For each sampling, LDS12-LB will store the reading for future retrieving purposes.
458 458  
469 +
470 +=== 2.5.1 Ways to get datalog via LoRaWAN ===
471 +
472 +
473 +Set PNACKMD=1, LDS12-LB will wait for ACK for every uplink, when there is no LoRaWAN network,LDS12-LB 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.
474 +
475 +* (((
476 +a) LDS12-LB will do an ACK check for data records sending to make sure every data arrive server.
477 +)))
478 +* (((
479 +b) LDS12-LB will send data in **CONFIRMED Mode** when PNACKMD=1, but LDS12-LB 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 LDS12-LB gets a ACK, LDS12-LB will consider there is a network connection and resend all NONE-ACK messages.
480 +)))
481 +
482 +
483 +
484 +=== 2.5.2 Unix TimeStamp ===
485 +
486 +
487 +LDS12-LB uses Unix TimeStamp format based on
488 +
489 +[[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"]]
490 +
491 +User can get this time from link:  [[https:~~/~~/www.epochconverter.com/>>url:https://www.epochconverter.com/]] :
492 +
493 +Below is the converter example
494 +
495 +[[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"]]
496 +
497 +
498 +So, we can use AT+TIMESTAMP=1611889405 or downlink 3060137afd00 to set the current time 2021 – Jan ~-~- 29 Friday 03:03:25
499 +
500 +
501 +=== 2.5.3 Set Device Time ===
502 +
503 +
504 +User need to set (% style="color:blue" %)**SYNCMOD=1**(%%) to enable sync time via MAC command.
505 +
506 +Once LDS12-LB Joined LoRaWAN network, it will send the MAC command (DeviceTimeReq) and the server will reply with (DeviceTimeAns) to send the current time to LDS12-LB. If LDS12-LB fails to get the time from the server, LDS12-LB will use the internal time and wait for next time request (AT+SYNCTDC to set the time request period, default is 10 days).
507 +
508 +(% 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.**
509 +
510 +
511 +=== 2.5.4 Poll sensor value ===
512 +
513 +
514 +Users can poll sensor values based on timestamps. Below is the downlink command.
515 +
516 +(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:425.818px" %)
517 +|(% colspan="4" style="background-color:#4f81bd; color:white; width:423px" %)**Downlink Command to poll Open/Close status (0x31)**
518 +|(% style="width:58px" %)**1byte**|(% style="width:127px" %)**4bytes**|(% style="width:124px" %)**4bytes**|(% style="width:114px" %)**1byte**
519 +|(% style="width:58px" %)31|(% style="width:127px" %)Timestamp start|(% style="width:124px" %)Timestamp end|(% style="width:114px" %)Uplink Interval
520 +
521 +(((
522 +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.
523 +)))
524 +
525 +(((
526 +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"]]
527 +)))
528 +
529 +(((
530 +Is to check 2021/11/12 12:00:00 to 2021/11/12 15:00:00's data
531 +)))
532 +
533 +(((
534 +Uplink Internal =5s，means LDS12-LB will send one packet every 5s. range 5~~255s.
535 +)))
536 +
537 +
538 +== 2.6 Frequency Plans ==
539 +
540 +
541 +The LDS12-LB 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.
542 +
459 459  [[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20Frequency%20Band/>>http://wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20Frequency%20Band/]]
460 460  
461 461  
462 -= 3. Configure DS20L =
546 +(% style="color:inherit; font-family:inherit; font-size:29px" %)3. Configure LDS12-LB
463 463  
464 464  == 3.1 Configure Methods ==
465 465  
466 466  
467 -DS20L supports below configure method:
551 +LDS12-LB supports below configure method:
468 468  
469 469  * AT Command via Bluetooth Connection (**Recommended**): [[BLE Configure Instruction>>http://wiki.dragino.com/xwiki/bin/view/Main/BLE%20Bluetooth%20Remote%20Configure/]].
470 470  
... ... @@ -486,10 +486,10 @@
486 486  [[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/]]
487 487  
488 488  
489 -== 3.3 Commands special design for DS20L ==
573 +== 3.3 Commands special design for LDS12-LB ==
490 490  
491 491  
492 -These commands only valid for DS20L, as below:
576 +These commands only valid for LDS12-LB, as below:
493 493  
494 494  
495 495  === 3.3.1 Set Transmit Interval Time ===
... ... @@ -531,7 +531,10 @@
531 531  Example 1: Downlink Payload: 0100001E  ~/~/ Set Transmit Interval (TDC) = 30 seconds
532 532  )))
533 533  * (((
534 -Example 2: Downlink Payload: 0100003C  ~/~/ Set Transmit Interval (TDC) = 60 seconds
618 +Example 2: Downlink Payload: 0100003C  ~/~/ Set Transmit Interval (TDC) = 60 seconds 
619 +
620 +
621 +
535 535  )))
536 536  
537 537  === 3.3.2 Set Interrupt Mode ===
... ... @@ -551,7 +551,7 @@
551 551  the mode is 0 =Disable Interrupt
552 552  )))
553 553  |(% style="width:154px" %)(((
554 -AT+INTMOD=3
641 +AT+INTMOD=2
555 555  
556 556  (default)
557 557  )))|(% style="width:196px" %)(((
... ... @@ -572,75 +572,11 @@
572 572  
573 573  * Example 2: Downlink Payload: 06000003  ~/~/  Set the interrupt mode to rising edge trigger
574 574  
575 -== 3.3.3 Set work mode ==
576 576  
577 -
578 -Feature: Switch working mode
579 -
580 -(% style="color:blue" %)**AT Command: AT+MOD**
581 -
582 -(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:510px" %)
583 -|=(% style="width: 162px;background-color:#4F81BD;color:white" %)**Command Example**|=(% style="width: 193px;background-color:#4F81BD;color:white" %)**Function**|=(% style="width: 155px;background-color:#4F81BD;color:white" %)**Response**
584 -|(% style="width:162px" %)AT+MOD=?|(% style="width:191px" %)Get the current working mode.|(% style="width:106px" %)OK
585 -|(% style="width:162px" %)AT+MOD=1|(% style="width:191px" %)Set the working mode to Regular measurements.|(% style="width:106px" %)(((
586 -OK
587 -Attention:Take effect after ATZ
588 -)))
589 -
590 -(% style="color:blue" %)**Downlink Command:**
591 -
592 -* **Example: **0x0A00  ~/~/  Same as AT+MOD=0
593 -
594 -* **Example:** 0x0A01  ~/~/  Same as AT+MOD=1
595 -
596 -=== 3.3.4 Set threshold and threshold mode ===
597 -
598 -
599 -Feature, Set threshold and threshold mode
600 -
601 -When (% style="color:#037691" %)**AT+DOL=0,0,0,0,400**(%%) is set, No threshold is used, the sampling time is 400ms.
602 -
603 -(% style="color:blue" %)**AT Command: AT+DOL**
604 -
605 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
606 -|(% style="background-color:#4f81bd; color:white; width:162px" %)**Command Example**|(% style="background-color:#4f81bd; color:white; width:240px" %)**Function**|(% style="background-color:#4f81bd; color:white; width:108px" %)**Response**
607 -|(% style="width:172px" %)AT+ DOL =?|(% style="width:279px" %)Get the current threshold mode and sampling time|(% style="width:118px" %)(((
608 -0,0,0,0,400
609 -OK
610 -)))
611 -|(% style="width:172px" %)AT+ DOL =1,1800,100,0,400|(% style="width:279px" %)Set only the upper and lower thresholds|(% style="width:118px" %)OK
612 -
613 -
614 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
615 -|(% rowspan="11" style="color:blue; width:120px" %)**AT+DOL=5,1800,0,0,400**|(% rowspan="6" style="width:240px" %)The first bit sets the limit mode|(% style="width:150px" %)0: Do not use upper and lower limits
616 -|(% style="width:251px" %)1: Use upper and lower limits
617 -|(% style="width:251px" %)2: Less than the lower limit
618 -|(% style="width:251px" %)3: Greater than the lower limit
619 -|(% style="width:251px" %)4: Less than the upper limit
620 -|(% style="width:251px" %)5: Greater than the upper limit
621 -|(% style="width:226px" %)The second bit sets the upper limit value|(% style="width:251px" %)3~~2000MM
622 -|(% style="width:226px" %)The third bit sets the lower limit value|(% style="width:251px" %)3~~2000MM
623 -|(% rowspan="2" style="width:226px" %)The fourth bit sets the over-limit alarm or person or object count.|(% style="width:251px" %)0 Over-limit alarm, DO output is high
624 -|(% style="width:251px" %)1 Person or object counting statistics
625 -|(% style="width:226px" %)The fifth bit sets the sampling time|(% style="width:251px" %)(((
626 -0~~10000ms
627 -
628 -
629 -)))
630 -
631 -(% style="color:blue" %)**Downlink Command: 0x07**
632 -
633 -Format: Command Code (0x07) followed by 9bytes.
634 -
635 -* Example 0: Downlink Payload: 070000000000000190  **~-~-->**  AT+MOD=0,0,0,0,400
636 -
637 -* Example 1: Downlink Payload: 070107080064000190  **~-~-->**  AT+MOD=1,1800,100,0,400
638 -
639 -
640 640  = 4. Battery & Power Consumption =
641 641  
642 642  
643 -DS20L use built-in 2400mAh non-chargeable battery for long-term use up to several years*. See below link for detail information about the battery info and how to replace.
666 +LDS12-LB use ER26500 + SPC1520 battery pack. See below link for detail information about the battery info and how to replace.
644 644  
645 645  [[**Battery Info & Power Consumption Analyze**>>http://wiki.dragino.com/xwiki/bin/view/Main/How%20to%20calculate%20the%20battery%20life%20of%20Dragino%20sensors%3F/]] .
646 646  
... ... @@ -649,7 +649,7 @@
649 649  
650 650  
651 651  (% class="wikigeneratedid" %)
652 -User can change firmware DS20L to:
675 +User can change firmware LDS12-LB to:
653 653  
654 654  * Change Frequency band/ region.
655 655  
... ... @@ -657,7 +657,7 @@
657 657  
658 658  * Fix bugs.
659 659  
660 -Firmware and changelog can be downloaded from : **[[Firmware download link>>https://www.dropbox.com/sh/zqv1vt3komgp4tu/AAC33PnXIcWOVl_UXBEAeT_xa?dl=0]]**
683 +Firmware and changelog can be downloaded from : **[[Firmware download link>>url:https://www.dropbox.com/sh/w1p7ukjrx49e62r/AAB3uCNCt-koYUvMkZUPBRSca?dl=0]]**
661 661  
662 662  Methods to Update Firmware:
663 663  
... ... @@ -667,39 +667,12 @@
667 667  
668 668  = 6. FAQ =
669 669  
670 -== 6.1 What is the frequency plan for DS20L? ==
693 +== 6.1 What is the frequency plan for LDS12-LB? ==
671 671  
672 672  
673 -DS20L 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"]]
696 +LDS12-LB 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"]]
674 674  
675 675  
676 -== 6.2 DS20L programming line ==
677 -
678 -
679 -缺图 后续补上
680 -
681 -feature:
682 -
683 -for AT commands
684 -
685 -Update the firmware of DS20L
686 -
687 -Support interrupt mode
688 -
689 -
690 -== 6.3 LiDAR probe position ==
691 -
692 -
693 -[[image:1701155390576-216.png||height="285" width="307"]]
694 -
695 -The black oval hole in the picture is the LiDAR probe.
696 -
697 -
698 -== 6.4 Interface definition ==
699 -
700 -[[image:image-20231128151132-2.png||height="305" width="557"]]
701 -
702 -
703 703  = 7. Trouble Shooting =
704 704  
705 705  == 7.1 AT Command input doesn't work ==
1701149922873-259.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -24.5 KB
Content
1701152902759-553.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -52.2 KB
Content
1701152946067-561.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -52.2 KB
Content
1701155076393-719.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -54.6 KB
Content
1701155150328-206.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -54.6 KB
Content
1701155390576-216.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -293.9 KB
Content
image-20231110102635-5.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -84.7 KB
Content
image-20231128133704-1.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -190.6 KB
Content
image-20231128151132-2.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -281.2 KB
Content