Changes for page DS20L -- LoRaWAN Smart Distance Detector User Manual 01

Last modified by Mengting Qiu on 2023/12/14 11:15

From 124.4 to 124.3 From 155.1 to 154.1

From version 154.1

edited by Mengting Qiu
on 2023/12/09 15:44

Change comment: There is no comment for this version

To version 124.4

edited by Xiaoling
on 2023/11/28 15:18

Change comment: There is no comment for this version

Raw
Rendered

Summary

Page properties (2 modified, 0 added, 0 removed)
Attachments (0 modified, 0 added, 20 removed)

Details

Page properties

Author

@@ -1,1 +1,1 @@
--XWiki.ting
++XWiki.Xiaoling

Content

@@ -8,7 +8,7 @@
--**Table of Contents:(% style="display:none" %) (%%)**
++**Table of Contents：**
  {{toc/}}
@@ -47,6 +47,8 @@
  * Firmware upgradable via program port or LoRa protocol
  * Built-in 2400mAh battery or power by external power source
++
++
  == 1.3 Specification ==
@@ -60,6 +60,8 @@
  * ToF FoV: ±9°, Total 18°
  * Light source: VCSEL
++
++
  == 1.4 Power Consumption ==
@@ -73,6 +73,8 @@
  * Idle: 21 mA @ 3.3v
  * Max : 360 mA
++
++
  = 2. Configure DS20L to connect to LoRaWAN network =
  == 2.1 How it works ==
@@ -91,7 +91,7 @@
  [[image:image-20231110102635-5.png||height="402" width="807"]](% style="display:none" %)
--=== Step 1: Create a device in TTN with the OTAA keys from DS20L. ===
++(% style="color:blue" %)**Step 1:**(%%) Create a device in TTN with the OTAA keys from DS20L.
  Each DS20L is shipped with a sticker with the default device EUI as below:
@@ -98,22 +98,32 @@
  [[image:image-20230426084152-1.png||alt="图片-20230426084152-1.png" height="233" width="502"]]
--You can enter this key in the LoRaWAN Server portal. Below is TTN V3 screenshot:
++You can enter this key in the LoRaWAN Server portal. Below is TTN screen shot:
  (% style="color:blue" %)**Register the device**
--[[image:image-20231207144600-2.png||height="703" width="756"]]
++[[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/1654935135620-998.png?rev=1.1||alt="1654935135620-998.png"]]
--(% style="color:blue" %)**Add DevEUI and AppKey**
++(% style="color:blue" %)**Add APP EUI and DEV EUI**
--[[image:image-20231207145121-5.png||height="540" width="756"]]
++[[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-4.png?width=753&height=551&rev=1.1||alt="图片-20220611161308-4.png"]]
++(% style="color:blue" %)**Add APP EUI in the application**
--=== Step 2: Activate on DS20L ===
++[[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-5.png?width=742&height=601&rev=1.1||alt="图片-20220611161308-5.png"]]
++
++
++(% style="color:blue" %)**Add APP KEY**
++
++[[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"]]
++
++
++(% style="color:blue" %)**Step 2:**(%%) Activate on DS20L
++
  [[image:image-20231128133704-1.png||height="189" width="441"]]
  Press the button for 5 seconds to activate the DS20L.
@@ -123,7 +123,6 @@
  After join success, it will start to upload messages to TTN and you can see the messages in the panel.
--
  == 2.3 Uplink Payload ==
  === 2.3.1 Device Status, FPORT~=5 ===
@@ -141,7 +141,7 @@
  Example parse in TTNv3
--[[image:image-20231206151412-3.png||height="179" width="1070"]]
++[[image:1701149922873-259.png]]
  (% style="color:blue" %)**Sensor Model**(%%): For DS20L, this value is 0x21
@@ -207,7 +207,7 @@
  |(% 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**
  |(% 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
--[[image:image-20231209152917-1.png||height="300" width="1172"]]
++[[image:1701155076393-719.png]]
  (% style="color:blue" %)**Battery Info:**
@@ -283,17 +283,21 @@
  (% style="color:red" %)**Limit flag:**
--Mode for setting threshold: **0~~3**
++Mode for setting threshold: 0~~5
--**0:** does not use upper and lower limits
++0: does not use upper and lower limits
--**1:** Use upper and lower limits
++1: Use upper and lower limits
--**2:** Less than the upper limit
++2: is less than the lower limit value
--**3: **Greater than the lower limit
++3: is greater than the lower limit value
++4: is less than the upper limit
++5: is greater than the upper limit
++
++
  (% style="color:blue" %)**Upper limit:**
  The upper limit of the threshold cannot exceed 2000mm.
@@ -304,12 +304,94 @@
  The lower limit of the threshold cannot be less than 3mm.
--== 2.4 Decode payload in The Things Network ==
++=== 2.3.3 Historical measuring distance, FPORT~=3 ===
++DS20L stores sensor values and users can retrieve these history values via the downlink command.
++
++The historical payload includes one or multiplies entries and every entry has the same payload as Real-Time measuring distance.
++
++(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
++|=(% style="width: 60px;background-color:#4F81BD;color:white" %)(((
++**Size(bytes)**
++)))|=(% style="width: 80px;background-color:#4F81BD;color:white" %)1|=(% style="width: 80px;background-color:#4F81BD;color:white" %)**1**|=(% 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: 85px;" %)**1**|=(% style="background-color: #4F81BD; color: white; width: 85px;" %)4
++|(% style="width:62.5px" %)Value|(% style="width:62.5px" %)Interrupt flag & Interrupt_level|(% style="width:62.5px" %)(((
++Reserve(0xFF)
++)))|Distance|Distance signal strength|(% style="width:88px" %)(((
++LiDAR temp
++)))|(% style="width:85px" %)Unix TimeStamp
++
++**Interrupt flag & Interrupt level:**
++
++(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:480px" %)
++|=(% style="width: 60px;background-color:#4F81BD;color:white" %)(((
++**Size(bit)**
++)))|=(% style="width: 90px;background-color:#4F81BD;color:white" %)**bit7**|=(% style="width: 90px;background-color:#4F81BD;color:white" %)**bit6**|=(% style="width: 60px;background-color:#4F81BD;color:white" %)**[bit5:bit2]**|=(% style="width: 90px; background-color: #4F81BD; color: white;" %)**bit1**|=(% style="background-color: #4F81BD; color: white; width: 90px;" %)**bit0**
++|(% style="width:62.5px" %)Value|(% style="width:62.5px" %)No ACK message|(% style="width:62.5px" %)Poll Message Flag|Reserve|(% style="width:91px" %)Interrupt level|(% style="width:88px" %)(((
++Interrupt flag
++)))
++
++* (((
++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.
++)))
++
++For example, in the US915 band, the max payload for different DR is:
++
++**a) DR0:** max is 11 bytes so one entry of data
++
++**b) DR1:** max is 53 bytes so devices will upload 4 entries of data (total 44 bytes)
++
++**c) DR2:** total payload includes 11 entries of data
++
++**d) DR3:** total payload includes 22 entries of data.
++
++If DS20L doesn't have any data in the polling time. It will uplink 11 bytes of 0
++
++
++**Downlink:**
++
++0x31 64 CC 68 0C 64 CC 69 74 05
++
++[[image:image-20230805144936-2.png||height="113" width="746"]]
++
++**Uplink:**
++
++43 FF 0E 10 00 B0 1E 64 CC 68 0C 40 FF 0D DE 00 A8 1E 64 CC 68 29 40 FF 09 92 00 D3 1E 64 CC 68 65 40 FF 02 3A 02 BC 1E 64 CC 68 A1 41 FF 0E 1A 00 A4 1E 64 CC 68 C0 40 FF 0D 2A 00 B8 1E 64 CC 68 E8 40 FF 00 C8 11 6A 1E 64 CC 69 24 40 FF 0E 24 00 AD 1E 64 CC 69 6D
++
++
++**Parsed Value:**
++
++[DISTANCE , DISTANCE_SIGNAL_STRENGTH，LIDAR_TEMP，EXTI_STATUS , EXTI_FLAG , TIME]
++
++
++[360,176,30,High,True,2023-08-04 02:53:00],
++
++[355,168,30,Low,False,2023-08-04 02:53:29],
++
++[245,211,30,Low,False,2023-08-04 02:54:29],
++
++[57,700,30,Low,False,2023-08-04 02:55:29],
++
++[361,164,30,Low,True,2023-08-04 02:56:00],
++
++[337,184,30,Low,False,2023-08-04 02:56:40],
++
++[20,4458,30,Low,False,2023-08-04 02:57:40],
++
++[362,173,30,Low,False,2023-08-04 02:58:53],
++
++
++**History read from serial port：**
++
++[[image:image-20230805145056-3.png]]
++
++
++=== 2.3.4 Decode payload in The Things Network ===
++
++
  While using TTN network, you can add the payload format to decode the payload.
--[[image:image-20231206143515-1.png||height="534" width="759"]]
++[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LLDS12-LoRaWAN%20LiDAR%20ToF%20Distance%20Sensor%20User%20Manual/WebHome/1654592762713-715.png?rev=1.1||alt="1654592762713-715.png"]]
  (((
@@ -321,7 +321,7 @@
  )))
--== 2.5 Show Data in DataCake IoT Server ==
++== 2.4 Show Data in DataCake IoT Server ==
  (((
@@ -338,29 +338,25 @@
  )))
--[[image:image-20231207153532-6.png||height="562" width="861"]]
++[[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"]]
--[[image:image-20231207155940-8.png]]
++[[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"]]
--For more detailed instructions, refer to the following instructions: [[Welcome - Datacake Docs>>url:https://docs.datacake.de/]]
--[[image:image-20231207160733-11.png||height="429" width="759"]]
--
--
  (% style="color:blue" %)**Step 3**(%%)**: Create an account or log in Datacake.**
  (% style="color:blue" %)**Step 4**(%%)**: Search the DS20L and add DevEUI.**
--[[image:image-20231207160343-10.png||height="665" width="705"]]
++[[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"]]
  After added, the sensor data arrive TTN V3, it will also arrive and show in Datacake.
--[[image:image-20231129100454-2.png||height="501" width="928"]]
++[[image:1701152946067-561.png]]
--== 2.6 Frequency Plans ==
++== 2.5 Frequency Plans ==
  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.
@@ -484,7 +484,7 @@
  * Example 2: Downlink Payload: 06000003      ~/~/   Set the interrupt mode to rising edge trigger
--=== 3.3.3 Set work mode ===
++== 3.3.3 Set work mode ==
  Feature: Switch working mode
@@ -501,9 +501,9 @@
  (% style="color:blue" %)**Downlink Command:**
--* **Example: **0x0A01      ~/~/  Same as AT+MOD=1
++* **Example: **0x0A00       ~/~/  Same as AT+MOD=0
--* **Example:** 0x0A02       ~/~/  Same as AT+MOD=2
++* **Example:** 0x0A01       ~/~/  Same as AT+MOD=1
  === 3.3.4 Set threshold and threshold mode ===
@@ -523,37 +523,18 @@
  |(% style="width:172px" %)AT+ DOL =1,1800,100,0,400|(% style="width:279px" %)Set only the upper and lower thresholds|(% style="width:118px" %)OK
  (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
--|(% rowspan="11" style="color:blue; width:120px" %)(((
--
--
--
--
--
--
--
--
--
--
--
--**AT+DOL=5,1800,0,0,400**
--)))|(% rowspan="4" style="width:240px" %)(((
--
--
--
--
--
--
--The first bit sets the limit mode
--)))|(% style="width:150px" %)0: Do not use upper and lower limits
++|(% 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
  |(% style="width:251px" %)1: Use upper and lower limits
--|(% style="width:251px" %)2:Less than the upper limit
++|(% style="width:251px" %)2: Less than the lower limit
  |(% style="width:251px" %)3: Greater than the lower limit
++|(% style="width:251px" %)4: Less than the upper limit
++|(% style="width:251px" %)5: Greater than the upper limit
  |(% style="width:226px" %)The second bit sets the upper limit value|(% style="width:251px" %)3~~2000MM
  |(% style="width:226px" %)The third bit sets the lower limit value|(% style="width:251px" %)3~~2000MM
  |(% 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
  |(% style="width:251px" %)1 Person or object counting statistics
  |(% style="width:226px" %)The fifth bit sets the sampling time|(% style="width:251px" %)(((
--100~~10000ms
++0~~10000ms
  )))
@@ -560,18 +560,22 @@
  (% style="color:blue" %)**Downlink Command: 0x07**
--Format: Command Code (0x07) followed by 9 bytes.
++Format: Command Code (0x07) followed by 9bytes.
--If the downlink payload=**07 01 0708 0064 00 0190**, it means set the END Node's limit mode to 0x01,upper limit value to 0x0708=1800(mm), lower limit value to 0x0064=100(mm), to over-limit alarm(0x00) ,the sampling time to 0x0190=400(ms), while type code is 0x07.
++* Example 0: Downlink Payload: 070000000000000190      **~-~-->**   AT+MOD=0,0,0,0,400
--* Example 0: Downlink Payload: 07 00 0000 0000 00 0190      **~-~-->**   AT+MOD=0,0,0,0,400
--
  * Example 1: Downlink Payload: 070107080064000190      **~-~-->**   AT+MOD=1,1800,100,0,400
--* Example 2: Downlink Payload: 070200000064000190      **~-~-->**   AT+MOD=2,1800100,0,400
++* Example 2: Downlink Payload: 070200000064000190      **~-~-->**   AT+MOD=2,0,100,0,400
--* Example 3: Downlink Payload: 070300000064000190      **~-~-->**   AT+MOD=3,0,100,0,400
++* Example 3: Downlink Payload: 0703200000064000190    **~-~-->**   AT+MOD=3,1800,100,0,400
++* Example 4: Downlink Payload: 070407080000000190      **~-~-->**   AT+MOD=4,0,100,0,400
++
++* Example 5: Downlink Payload: 070507080000000190      **~-~-->**   AT+MOD=5,1800,100,0,400
++
++
++
  = 4. Battery & Power Consumption =

image-20231129085201-1.png

Author

...	...	@@ -1,1 +1,0 @@
1		-XWiki.Xiaoling

Size

...	...	@@ -1,1 +1,0 @@
1		-70.6 KB

Content

image-20231129100454-2.png

Author

...	...	@@ -1,1 +1,0 @@
1		-XWiki.Xiaoling

Size

...	...	@@ -1,1 +1,0 @@
1		-70.1 KB

Content

image-20231206143515-1.png

Author

...	...	@@ -1,1 +1,0 @@
1		-XWiki.ting

Size

...	...	@@ -1,1 +1,0 @@
1		-89.5 KB

Content

image-20231206144950-2.png

Author

...	...	@@ -1,1 +1,0 @@
1		-XWiki.ting

Size

...	...	@@ -1,1 +1,0 @@
1		-41.0 KB

Content

image-20231206151412-3.png

Author

...	...	@@ -1,1 +1,0 @@
1		-XWiki.ting

Size

...	...	@@ -1,1 +1,0 @@
1		-58.8 KB

Content

image-20231206154621-4.png

Author

...	...	@@ -1,1 +1,0 @@
1		-XWiki.ting

Size

...	...	@@ -1,1 +1,0 @@
1		-71.2 KB

Content

image-20231206194804-5.png

Author

...	...	@@ -1,1 +1,0 @@
1		-XWiki.ting

Size

...	...	@@ -1,1 +1,0 @@
1		-53.7 KB

Content

image-20231206195704-6.png

Author

...	...	@@ -1,1 +1,0 @@
1		-XWiki.ting

Size

...	...	@@ -1,1 +1,0 @@
1		-64.1 KB

Content

image-20231207142208-1.png

Author

...	...	@@ -1,1 +1,0 @@
1		-XWiki.ting

Size

...	...	@@ -1,1 +1,0 @@
1		-27.2 KB

Content

image-20231207144600-2.png

Author

...	...	@@ -1,1 +1,0 @@
1		-XWiki.ting

Size

...	...	@@ -1,1 +1,0 @@
1		-55.4 KB

Content

image-20231207144837-3.png

Author

...	...	@@ -1,1 +1,0 @@
1		-XWiki.ting

Size

...	...	@@ -1,1 +1,0 @@
1		-31.1 KB

Content

image-20231207144856-4.png

Author

...	...	@@ -1,1 +1,0 @@
1		-XWiki.ting

Size

...	...	@@ -1,1 +1,0 @@
1		-31.1 KB

Content

image-20231207145121-5.png

Author

...	...	@@ -1,1 +1,0 @@
1		-XWiki.ting

Size

...	...	@@ -1,1 +1,0 @@
1		-33.3 KB

Content

image-20231207153532-6.png

Author

...	...	@@ -1,1 +1,0 @@
1		-XWiki.ting

Size

...	...	@@ -1,1 +1,0 @@
1		-164.7 KB

Content

image-20231207154046-7.png

Author

...	...	@@ -1,1 +1,0 @@
1		-XWiki.ting

Size

...	...	@@ -1,1 +1,0 @@
1		-23.0 KB

Content

image-20231207155940-8.png

Author

...	...	@@ -1,1 +1,0 @@
1		-XWiki.ting

Size

...	...	@@ -1,1 +1,0 @@
1		-41.7 KB

Content

image-20231207160053-9.png

Author

...	...	@@ -1,1 +1,0 @@
1		-XWiki.ting

Size

...	...	@@ -1,1 +1,0 @@
1		-95.5 KB

Content

image-20231207160343-10.png

Author

...	...	@@ -1,1 +1,0 @@
1		-XWiki.ting

Size

...	...	@@ -1,1 +1,0 @@
1		-80.5 KB

Content

image-20231207160733-11.png

Author

...	...	@@ -1,1 +1,0 @@
1		-XWiki.ting

Size

...	...	@@ -1,1 +1,0 @@
1		-136.0 KB

Content

image-20231209152917-1.png

Author

...	...	@@ -1,1 +1,0 @@
1		-XWiki.ting

Size

...	...	@@ -1,1 +1,0 @@
1		-65.9 KB

Content

Changes for page DS20L -- LoRaWAN Smart Distance Detector User Manual 01

Summary

Details

Applications

Navigation