Changes for page DS20L -- LoRaWAN Smart Distance Detector User Manual 01
Last modified by Mengting Qiu on 2023/12/14 11:15
From version 115.1
edited by Edwin Chen
on 2023/11/11 10:33
on 2023/11/11 10:33
Change comment:
There is no comment for this version
Summary
-
Page properties (3 modified, 0 added, 0 removed)
-
Attachments (0 modified, 0 added, 18 removed)
- image-20230614162334-2.png
- image-20230614162359-3.png
- image-20230615152941-1.png
- image-20230615153004-2.png
- image-20230805103904-1.png
- image-20230805104104-2.png
- image-20230805144259-1.png
- image-20230805144936-2.png
- image-20230805145056-3.png
- image-20230805150315-4.png
- image-20230805155335-1.png
- image-20230805155428-2.png
- image-20230805155515-3.png
- image-20231110085300-1.png
- image-20231110085342-2.png
- image-20231110091447-3.png
- image-20231110091506-4.png
- image-20231110102635-5.png
Details
- Page properties
-
- Title
-
... ... @@ -1,1 +1,1 @@ 1 -DS2 0L -- LoRaWANSmartDistanceDetector User Manual1 +LDS12-LB -- LoRaWAN LiDAR ToF Distance Sensor User Manual - Author
-
... ... @@ -1,1 +1,1 @@ 1 -XWiki. Edwin1 +XWiki.Xiaoling - Content
-
... ... @@ -1,5 +1,5 @@ 1 1 (% style="text-align:center" %) 2 -[[image:image-202311 10085342-2.png||height="481" width="481"]]2 +[[image:image-20230614153353-1.png]] 3 3 4 4 5 5 ... ... @@ -7,7 +7,6 @@ 7 7 8 8 9 9 10 - 11 11 **Table of Contents:** 12 12 13 13 {{toc/}} ... ... @@ -19,428 +19,443 @@ 19 19 20 20 = 1. Introduction = 21 21 22 -== 1.1 What is LoRaWAN SmartDistanceDetector ==21 +== 1.1 What is LoRaWAN LiDAR ToF Distance Sensor == 23 23 24 24 25 -The Dragino (% style="color:blue" %)** DS20L isasmartdistancedetector**(%%)baseonlong-rangewireless LoRaWANtechnology. Ituses(% style="color:blue"%)**LiDARsensor**(%%) to detectthe distancebetweenDS20Landobject,thenDS20Lwill send thedistancedatatotheIoTPlatformviaLoRaWAN.DS20Lcan measurerangebetween3cm ~~ 200cm.24 +The Dragino LDS12-LB is a (% style="color:blue" %)**LoRaWAN LiDAR ToF (Time of Flight) Distance Sensor**(%%) for Internet of Things solution. It is capable to measure the distance to an object as close as 10 centimeters (+/- 5cm up to 6m) and as far as 12 meters (+/-1% starting at 6m)!. The LiDAR probe uses laser induction technology for distance measurement. 26 26 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 -consumption. It targets professional wireless sensor network applications such smart cities, building automation, and so on. 26 +The LDS12-LB 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. 29 29 30 - DS20Lhasa (% style="color:blue"%)**built-in2400mAh non-chargeablebattery**(%%) for long-term useupto severalyears*. Userscan alsopower DS20L withanexternalpowersourcefor (%style="color:blue"%)**continuousmeasuringanddistancealarm/ countingpurposes.**28 +It detects the distance between the measured object and the sensor, and uploads the value via wireless to LoRaWAN IoT Server. 31 31 32 - DS20L isfullycompatiblewith(%style="color:blue"%)**LoRaWANv1.0.3 ClassAprotocol**(%%),itcanworkwithastandardLoRaWAN gateway.30 +The LoRa wireless technology used in LDS12-LB 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. 33 33 32 +LDS12-LB (% style="color:blue" %)**supports BLE configure**(%%) and (% style="color:blue" %)**wireless OTA update**(%%) which make user easy to use. 34 34 35 - [[image:image-20231110102635-5.png||height="402"width="807"]]34 +LDS12-LB is powered by (% style="color:blue" %)**8500mAh Li-SOCI2 battery**(%%), it is designed for long term use up to 5 years. 36 36 36 +Each LDS12-LB 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. 37 37 38 +[[image:image-20230613140115-3.png||height="453" width="800"]] 39 + 40 + 38 38 == 1.2 Features == 39 39 40 40 41 -* LoRaWAN Class A protocol 42 -* LiDAR distance detector, range 3 ~~ 200cm 43 -* Periodically detect or continuously detect mode 44 +* LoRaWAN 1.0.3 Class A 45 +* Bands: CN470/EU433/KR920/US915/EU868/AS923/AU915/IN865 46 +* Ultra-low power consumption 47 +* Liquid Level Measurement by Ultrasonic technology 48 +* Measure through container, No need to contact Liquid 49 +* Valid level range 20mm - 2000mm 50 +* Accuracy: ±(5mm+S*0.5%) (S: Measure Value) 51 +* Cable Length : 25cm 52 +* Support Bluetooth v5.1 and LoRaWAN remote configure 53 +* Support wireless OTA update firmware 44 44 * AT Commands to change parameters 45 -* Remotely configure parameters via LoRaWAN Downlink 46 -* Alarm & Counting mode 47 -* Firmware upgradable via program port or LoRa protocol 48 -* Built-in 2400mAh battery or power by external power source 55 +* Downlink to change configure 56 +* IP66 Waterproof Enclosure 57 +* 8500mAh Battery for long term use 49 49 50 50 51 51 == 1.3 Specification == 52 52 53 53 54 -(% style="color:#037691" %)** LiDARSensor:**63 +(% style="color:#037691" %)**Common DC Characteristics:** 55 55 56 -* Operation Temperature: -40 ~~ 80 °C 57 -* Operation Humidity: 0~~99.9%RH (no Dew) 58 -* Storage Temperature: -10 ~~ 45°C 59 -* Measure Range: 3cm~~200cm @ 90% reflectivity 60 -* Accuracy: ±2cm @ (3cm~~100cm); ±5% @ (100~~200cm) 61 -* ToF FoV: ±9°, Total 18° 62 -* Light source: VCSEL 65 +* Supply Voltage: built in 8500mAh Li-SOCI2 battery , 2.5v ~~ 3.6v 66 +* Operating Temperature: -40 ~~ 85°C 63 63 64 -(% style=" display:none" %)68 +(% style="color:#037691" %)**LoRa Spec:** 65 65 70 +* Frequency Range, Band 1 (HF): 862 ~~ 1020 Mhz 71 +* Max +22 dBm constant RF output vs. 72 +* RX sensitivity: down to -139 dBm. 73 +* Excellent blocking immunity 66 66 67 - ==1.4 Power Consumption==75 +(% style="color:#037691" %)**Battery:** 68 68 77 +* Li/SOCI2 un-chargeable battery 78 +* Capacity: 8500mAh 79 +* Self-Discharge: <1% / Year @ 25°C 80 +* Max continuously current: 130mA 81 +* Max boost current: 2A, 1 second 69 69 70 - **BatteryPowerMode:**83 +(% style="color:#037691" %)**Power Consumption** 71 71 72 -* Idle:xxx mA @ 3.3v73 -* Max:xxxmA85 +* Sleep Mode: 5uA @ 3.3v 86 +* LoRa Transmit Mode: 125mA @ 20dBm, 82mA @ 14dBm 74 74 75 75 76 - **Continuouslymode**:89 +== 1.4 Suitable Container & Liquid == 77 77 78 -* Idle: xxx mA @ 3.3v 79 -* Max : xxx mA 80 80 92 +* Solid Wall container such as: steel, iron, glass, ceramics, non-foaming plastics etc. 93 +* Container shape is regular, and surface is smooth. 94 +* Container Thickness: 95 +** Pure metal material. 2~~8mm, best is 3~~5mm 96 +** Pure non metal material: <10 mm 97 +* Pure liquid without irregular deposition. 81 81 82 -= 2. Configure DS20L to connect to LoRaWAN network = 83 83 84 - ==2.1 How itworks==100 +(% style="display:none" %) 85 85 102 +== 1.5 Install LDS12-LB == 86 86 87 -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. 88 88 89 -(% style=" display:none" %) (%%)105 +(% style="color:blue" %)**Step 1**(%%): ** Choose the installation point.** 90 90 91 - ==2.2Quickguide to connecttoLoRaWAN server(OTAA) ==107 +LDS12-LB (% style="color:red" %)**MUST**(%%) be installed on the container bottom middle position. 92 92 109 +[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDDS20%20-%20LoRaWAN%20Liquid%20Level%20Sensor%20User%20Manual/WebHome/image-20220615091045-3.png?rev=1.1||alt="image-20220615091045-3.png"]] 93 93 94 -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. 95 95 96 -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" %) 112 +((( 113 +(% style="color:blue" %)**Step 2**(%%): **Polish the installation point.** 114 +))) 97 97 98 -[[image:image-20231110102635-5.png||height="402" width="807"]](% style="display:none" %) 116 +((( 117 +For Metal Surface with paint, it is important to polish the surface, first use crude sand paper to polish the paint level , then use exquisite sand paper to polish the metal level to make it shine & smooth. 118 +))) 99 99 100 - (% style="color:blue" %)**Step 1:**(%%) Createa device in TTN with the OTAA keys fromDS20L.120 +[[image:image-20230613143052-5.png]] 101 101 102 -Each DS20L is shipped with a sticker with the default device EUI as below: 103 103 104 - [[image:image-20230426084152-1.png||alt="图片-20230426084152-1.png" height="233"width="502"]]123 +No polish needed if the container is shine metal surface without paint or non-metal container. 105 105 125 +[[image:image-20230613143125-6.png]] 106 106 107 -You can enter this key in the LoRaWAN Server portal. Below is TTN screen shot: 108 108 128 +((( 129 +(% style="color:blue" %)**Step3: **(%%)**Test the installation point.** 130 +))) 109 109 110 -(% style="color:blue" %)**Register the device** 132 +((( 133 +Power on LDS12-LB, check if the blue LED is on, If the blue LED is on, means the sensor works. Then put ultrasonic coupling paste on the sensor and put it tightly on the installation point. 134 +))) 111 111 112 -[[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"]] 136 +((( 137 +It is necessary to put the coupling paste between the sensor and the container, otherwise LDS12-LB won't detect the liquid level. 138 +))) 113 113 140 +((( 141 +After paste the LDS12-LB well, power on LDS12-LB. In the first 30 seconds of booting, device will check the sensors status and BLUE LED will show the status as below. After 30 seconds, BLUE LED will be off to save battery life. 142 +))) 114 114 115 -(% style="color:blue" %)**Add APP EUI and DEV EUI** 116 116 117 -[[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"]] 145 +((( 146 +(% style="color:blue" %)**LED Status:** 147 +))) 118 118 149 +* ((( 150 +**Onboard LED**: When power on device, the onboard LED will fast blink 4 times which means detect the sensor well. 151 +))) 119 119 120 -(% style="color:blue" %)**Add APP EUI in the application** 153 +* ((( 154 +(% style="color:blue" %)**BLUE LED**(% style="color:red" %)** always ON**(%%): Sensor is power on but doesn't detect liquid. There is problem in installation point. 155 +))) 156 +* ((( 157 +(% style="color:blue" %)**BLUE LED**(% style="color:red" %)** slowly blinking**(%%): Sensor detects Liquid Level, The installation point is good. 158 +))) 121 121 160 +((( 161 +LDS12-LB will enter into low power mode at 30 seconds after system reset or power on, Blue LED will be off after that. 162 +))) 122 122 123 -[[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"]] 124 124 165 +((( 166 +(% style="color:red" %)**Note :**(%%)** (% style="color:blue" %)Ultrasonic coupling paste(%%)**(% style="color:blue" %) (%%) is subjected in most shipping way. So the default package doesn't include it and user needs to purchase locally. 167 +))) 125 125 126 -(% style="color:blue" %)**Add APP KEY** 127 127 128 -[[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"]] 170 +((( 171 +(% style="color:blue" %)**Step4: **(%%)**Install use Epoxy ab glue.** 172 +))) 129 129 174 +((( 175 +Prepare Eproxy AB glue. 176 +))) 130 130 131 -(% style="color:blue" %)**Step 2:**(%%) Activate on DS20L 178 +((( 179 +Put Eproxy AB glue in the sensor and press it hard on the container installation point. 180 +))) 132 132 182 +((( 183 +Reset LDS12-LB and see if the BLUE LED is slowly blinking. 184 +))) 133 133 134 - Pressbuttonfor5secondstoctivateDS20L.186 +[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDDS20%20-%20LoRaWAN%20Liquid%20Level%20Sensor%20User%20Manual/WebHome/image-20220615091045-8.png?width=341&height=203&rev=1.1||alt="image-20220615091045-8.png"]] [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDDS20%20-%20LoRaWAN%20Liquid%20Level%20Sensor%20User%20Manual/WebHome/image-20220615091045-9.png?width=284&height=200&rev=1.1||alt="image-20220615091045-9.png"]] 135 135 136 -(% 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. 137 137 138 -After join success, it will start to upload messages to TTN and you can see the messages in the panel. 189 +((( 190 +(% style="color:red" %)**Note :** 139 139 192 +(% style="color:red" %)**1:**(%%)** (% style="color:blue" %)Eproxy AB glue(%%)** needs 3~~ 5 minutes to stable attached. we can use other glue material to keep it in the position. 193 +))) 140 140 141 -== 2.3 Uplink Payload == 195 +((( 196 +(% style="color:red" %)**2:**(%%)** (% style="color:blue" %)Eproxy AB glue(%%)** is subjected in most shipping way. So the default package doesn't include it and user needs to purchase locally. 197 +))) 142 142 143 -=== 2.3.1 Device Status, FPORT~=5 === 144 144 200 +== 1.6 Applications == 145 145 146 -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. 147 147 148 - ThePayloadformatisas below.203 +* Smart liquid control solution 149 149 150 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %) 151 -|=(% style="width: 60px;background-color:#4F81BD;color:white" %)((( 152 -**Size(bytes)** 153 -)))|=(% 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** 154 -|(% 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 205 +* Smart liquefied gas solution 155 155 156 -Example parse in TTNv3 157 157 158 - [[image:image-20230805103904-1.png||height="131" width="711"]]208 +== 1.7 Precautions == 159 159 160 -(% style="color:blue" %)**Sensor Model**(%%): For DS20L, this value is 0x24 161 161 162 - (%style="color:blue"%)**FirmwareVersion**(%%):0x0100,Means:v1.0.0version211 +* At room temperature, containers of different materials, such as steel, glass, iron, ceramics, non-foamed plastics and other dense materials, have different detection blind areas and detection limit heights. 163 163 164 - (%style="color:blue"%)**FrequencyBand**:213 +* For containers of the same material at room temperature, the detection blind zone and detection limit height are also different for the thickness of the container. 165 165 166 - 0x01:EU868215 +* When the detected liquid level exceeds the effective detection value of the sensor, and the liquid level of the liquid to be measured shakes or tilts, the detected liquid height is unstable. 167 167 168 - 0x02:US915217 +(% style="display:none" %) 169 169 170 - 0x03:IN865219 +== 1.8 Sleep mode and working mode == 171 171 172 -0x04: AU915 173 173 174 - 0x05:KZ865222 +(% 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. 175 175 176 - 0x06: RU864224 +(% 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. 177 177 178 -0x07: AS923 179 179 180 - 0x08:AS923-1227 +== 1.9 Button & LEDs == 181 181 182 -0x09: AS923-2 183 183 184 - 0x0a: AS923-3230 +[[image:Main.User Manual for LoRaWAN End Nodes.D20-LBD22-LBD23-LB_LoRaWAN_Temperature_Sensor_User_Manual.WebHome@1675071855856-879.png]] 185 185 186 -0x0b: CN470 187 187 188 -0x0c: EU433 233 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %) 234 +|=(% style="width: 167px;background-color:#D9E2F3;color:#0070C0" %)**Behavior on ACT**|=(% style="width: 117px;background-color:#D9E2F3;color:#0070C0" %)**Function**|=(% style="width: 225px;background-color:#D9E2F3;color:#0070C0" %)**Action** 235 +|(% style="width:167px" %)Pressing ACT between 1s < time < 3s|(% style="width:117px" %)Send an uplink|(% style="width:225px" %)((( 236 +If sensor is already Joined to LoRaWAN network, sensor will send an uplink packet, (% style="color:blue" %)**blue led** (%%)will blink once. 237 +Meanwhile, BLE module will be active and user can connect via BLE to configure device. 238 +))) 239 +|(% style="width:167px" %)Pressing ACT for more than 3s|(% style="width:117px" %)Active Device|(% style="width:225px" %)((( 240 +(% 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. 241 +(% style="color:green" %)**Green led**(%%) will solidly turn on for 5 seconds after joined in network. 242 +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. 243 +))) 244 +|(% 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. 189 189 190 -0x0d: KR920 191 191 192 -0 x0e:MA869247 +== 1.10 BLE connection == 193 193 194 -(% style="color:blue" %)**Sub-Band**: 195 195 196 - AU915 and US915:value0x00~~0x08250 +LDS12-LB support BLE remote configure. 197 197 198 - CN470:value0x0B~~0x0C252 +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: 199 199 200 -Other Bands: Always 0x00 254 +* Press button to send an uplink 255 +* Press button to active device. 256 +* Device Power on or reset. 201 201 202 - (%style="color:blue"%)**BatteryInfo**:258 +If there is no activity connection on BLE in 60 seconds, sensor will shut down BLE module to enter low power mode. 203 203 204 -Check the battery voltage. 205 205 206 - Ex1:0x0B45=2885mV261 +== 1.11 Pin Definitions == 207 207 208 - Ex2:x0B49 =2889mV263 +[[image:image-20230523174230-1.png]] 209 209 210 210 211 -== =2.3.2Uplink Payload,FPORT~=2===266 +== 1.12 Mechanical == 212 212 213 213 214 -((( 215 -DS20L will send this uplink **after** Device Status once join the LoRaWAN network successfully. And DS20L will: 269 +[[image:Main.User Manual for LoRaWAN End Nodes.D20-LBD22-LBD23-LB_LoRaWAN_Temperature_Sensor_User_Manual.WebHome@1675143884058-338.png]] 216 216 217 -periodically send this uplink every 20 minutes, this interval [[can be changed>>||anchor="H3.3.1SetTransmitIntervalTime"]]. 218 218 219 -Uplink Payload totals 11 bytes. 220 -))) 272 +[[image:Main.User Manual for LoRaWAN End Nodes.D20-LBD22-LBD23-LB_LoRaWAN_Temperature_Sensor_User_Manual.WebHome@1675143899218-599.png]] 221 221 222 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %) 223 -|=(% style="width: 60px;background-color:#4F81BD;color:white" %)((( 224 -**Size(bytes)** 225 -)))|=(% 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** 226 -|(% style="width:62.5px" %)Value|(% style="width:62.5px" %)[[BAT>>||anchor="HBatteryInfo"]]|(% style="width:62.5px" %)((( 227 -[[Temperature DS18B20>>||anchor="HDS18B20Temperaturesensor"]] 228 -)))|[[Distance>>||anchor="HDistance"]]|[[Distance signal strength>>||anchor="HDistancesignalstrength"]]|(% style="width:122px" %)((( 229 -[[Interrupt flag & Interrupt_level>>||anchor="HInterruptPin26A0InterruptLevel"]] 230 -)))|(% style="width:54px" %)[[LiDAR temp>>||anchor="HLiDARtemp"]]|(% style="width:96px" %)((( 231 -[[Message Type>>||anchor="HMessageType"]] 232 -))) 233 233 234 -[[image:i mage-20230805104104-2.png||height="136" width="754"]]275 +[[image:Main.User Manual for LoRaWAN End Nodes.D20-LBD22-LBD23-LB_LoRaWAN_Temperature_Sensor_User_Manual.WebHome@1675143909447-639.png]] 235 235 236 236 237 - ====(% style="color:blue" %)**BatteryInfo**(%%) ====278 +(% style="color:blue" %)**Probe Mechanical:** 238 238 280 +[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDDS20%20-%20LoRaWAN%20Liquid%20Level%20Sensor%20User%20Manual/WebHome/image-20220615090910-1.png?rev=1.1||alt="image-20220615090910-1.png"]] 239 239 240 -Check the battery voltage for DS20L. 241 241 242 - Ex1:0x0B45885mV283 +[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDDS20%20-%20LoRaWAN%20Liquid%20Level%20Sensor%20User%20Manual/WebHome/image-20220615090910-2.png?rev=1.1||alt="image-20220615090910-2.png"]] 243 243 244 -Ex2: 0x0B49 = 2889mV 245 245 286 += 2. Configure LDS12-LB to connect to LoRaWAN network = 246 246 247 -== ==(%style="color:blue"%)**DS18B20 Temperaturesensor**(%%)====288 +== 2.1 How it works == 248 248 249 249 250 -This is optional,usercan connectexternalDS18B20sensor to the+3.3v,1-wire andGNDpin.andthisfieldwillreport temperature.291 +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. 251 251 293 +(% style="display:none" %) (%%) 252 252 253 - **Example**:295 +== 2.2 Quick guide to connect to LoRaWAN server (OTAA) == 254 254 255 -If payload is: 0105H: (0105 & FC00 == 0), temp = 0105H /10 = 26.1 degree 256 256 257 - Ifpayloadis:FF3FH:(FF3F&FC00==1),temp=(FF3FH-65536)/10=-19.3degrees.298 +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. 258 258 300 +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. 259 259 260 -= ===(% style="color:blue" %)**Distance**(%%)====302 +[[image:image-20230613140140-4.png||height="453" width="800"]](% style="display:none" %) 261 261 262 262 263 - Representsthe distance valuef the measurementoutput, thedefaultunit is cm, and thevaluerangeparsedasadecimal numberis 0-1200. Inactualuse,whenthesignalstrengthvalueStrength.305 +(% style="color:blue" %)**Step 1:**(%%) Create a device in TTN with the OTAA keys from LDS12-LB. 264 264 307 +Each LDS12-LB is shipped with a sticker with the default device EUI as below: 265 265 266 - **Example**:309 +[[image:image-20230426084152-1.png||alt="图片-20230426084152-1.png" height="233" width="502"]] 267 267 268 -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. 269 269 312 +You can enter this key in the LoRaWAN Server portal. Below is TTN screen shot: 270 270 271 -==== (% style="color:blue" %)**Distance signal strength**(%%) ==== 272 272 315 +(% style="color:blue" %)**Register the device** 273 273 274 - Refers to the signal strength,the defaultoutput valuewill be between 0-65535.When thedistancemeasurement gearis fixed, the farther thedistance measurement is, the lowerthe signalstrength; thelower thetargetflectivity, the lower the signal strength. WhenStrength isgreaterthan 100and not equalto, the measuredvalue of Distis considered credible.317 +[[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"]] 275 275 276 276 277 -**E xample**:320 +(% style="color:blue" %)**Add APP EUI and DEV EUI** 278 278 279 - Ifpayload:01D7(H)=471(D), distance signalstrength=471, 471>100,471≠65535, thesured value of Distisconsidered credible.322 +[[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"]] 280 280 281 -Customers can judge whether they need to adjust the environment based on the signal strength. 282 282 325 +(% style="color:blue" %)**Add APP EUI in the application** 283 283 284 -**1) When the sensor detects valid data:** 285 285 286 -[[image:i mage-20230805155335-1.png||height="145" width="724"]]328 +[[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"]] 287 287 288 288 289 - **2)Whenthesensordetectsinvalidata:**331 +(% style="color:blue" %)**Add APP KEY** 290 290 291 -[[image:i mage-20230805155428-2.png||height="139" width="726"]]333 +[[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"]] 292 292 293 293 294 - **3)Whenthesensoris notconnected:**336 +(% style="color:blue" %)**Step 2:**(%%) Activate on LDS12-LB 295 295 296 -[[image:image-20230805155515-3.png||height="143" width="725"]] 297 297 339 +Press the button for 5 seconds to activate the LDS12-LB. 298 298 299 -= ===(% style="color:blue" %)**InterruptPin&InterruptLevel**(%%)====341 +(% 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. 300 300 343 +After join success, it will start to upload messages to TTN and you can see the messages in the panel. 301 301 302 -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. 303 303 304 - Note:The Internet Pin is a separate pin in the screw terminal.SeepinmappingofGPIO_EXTI .346 +== 2.3 Uplink Payload == 305 305 306 -**Example:** 307 307 308 -If byte[0]&0x01=0x00 : Normal uplink packet. 309 - 310 -If byte[0]&0x01=0x01 : Interrupt Uplink Packet. 311 - 312 - 313 -==== (% style="color:blue" %)**LiDAR temp**(%%) ==== 314 - 315 - 316 -Characterize the internal temperature value of the sensor. 317 - 318 -**Example: ** 319 -If payload is: 1C(H) <<24>>24=28(D),LiDAR temp=28℃. 320 -If payload is: F2(H) <<24>>24=-14(D),LiDAR temp=-14℃. 321 - 322 - 323 -==== (% style="color:blue" %)**Message Type**(%%) ==== 324 - 325 - 326 326 ((( 327 - Fora normal uplink payload,themessagetypeis always0x01.350 +LDS12-LB will uplink payload via LoRaWAN with below payload format: 328 328 ))) 329 329 330 330 ((( 331 - ValidMessageType:354 +Uplink payload includes in total 8 bytes. 332 332 ))) 333 333 334 -(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:499px" %) 335 -|=(% 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** 336 -|(% style="width:160px" %)0x01|(% style="width:163px" %)Normal Uplink|(% style="width:173px" %)Normal Uplink Payload 337 -|(% style="width:160px" %)0x02|(% style="width:163px" %)Reply configures info|(% style="width:173px" %)Configure Info Payload 357 +(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:510px" %) 358 +|=(% style="width: 62.5px;background-color:#D9E2F3;color:#0070C0" %)((( 359 +**Size(bytes)** 360 +)))|=(% style="width: 62.5px;background-color:#D9E2F3;color:#0070C0" %)**2**|=(% style="background-color:#D9E2F3;color:#0070C0" %)**2**|=(% style="background-color:#D9E2F3;color:#0070C0" %)1|=(% style="background-color:#D9E2F3;color:#0070C0" %)2|=(% style="background-color:#D9E2F3;color:#0070C0" %)**1** 361 +|(% style="width:62.5px" %)Value|(% style="width:62.5px" %)[[BAT>>||anchor="H2.3.1A0BatteryInfo"]]|((( 362 +[[Distance>>||anchor="H2.3.2A0Distance"]] 363 +(unit: mm) 364 +)))|[[Digital Interrupt (Optional)>>||anchor="H2.3.3A0InterruptPin"]]|((( 365 +[[Temperature (Optional )>>||anchor="H2.3.4A0DS18B20Temperaturesensor"]] 366 +)))|[[Sensor Flag>>||anchor="H2.3.5A0SensorFlag"]] 338 338 339 -[[image:i mage-20230805150315-4.png||height="233"width="723"]]368 +[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDDS20%20-%20LoRaWAN%20Liquid%20Level%20Sensor%20User%20Manual/WebHome/1654850511545-399.png?rev=1.1||alt="1654850511545-399.png"]] 340 340 341 341 342 -=== 2.3. 3Historical measuringdistance,FPORT~=3===371 +=== 2.3.1 Battery Info === 343 343 344 344 345 - DS20L stores sensor values and userscanretrieve thesehistory values viathe[[downlinkcommand>>||anchor="H2.5.4Pollsensorvalue"]].374 +Check the battery voltage for LDS12-LB. 346 346 347 - Thehistoricalpayloadincludes one ormultiplies entries and every entry has the same payload as Real-Time measuring distance.376 +Ex1: 0x0B45 = 2885mV 348 348 349 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %) 350 -|=(% style="width: 60px;background-color:#4F81BD;color:white" %)((( 351 -**Size(bytes)** 352 -)))|=(% 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 353 -|(% style="width:62.5px" %)Value|(% style="width:62.5px" %)Interrupt flag & Interrupt_level|(% style="width:62.5px" %)((( 354 -Reserve(0xFF) 355 -)))|Distance|Distance signal strength|(% style="width:88px" %)((( 356 -LiDAR temp 357 -)))|(% style="width:85px" %)Unix TimeStamp 378 +Ex2: 0x0B49 = 2889mV 358 358 359 -**Interrupt flag & Interrupt level:** 360 360 361 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:480px" %) 362 -|=(% style="width: 60px;background-color:#4F81BD;color:white" %)((( 363 -**Size(bit)** 364 -)))|=(% 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** 365 -|(% 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" %)((( 366 -Interrupt flag 367 -))) 381 +=== 2.3.2 Distance === 368 368 369 -* ((( 370 -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. 383 + 384 +((( 385 +Get the distance. Flat object range 20mm - 2000mm. 371 371 ))) 372 372 373 -For example, in the US915 band, the max payload for different DR is: 388 +((( 389 +For example, if the data you get from the register is **0x06 0x05**, the distance between the sensor and the measured object is(% style="color:#4472c4" %)** ** 374 374 375 -**a) DR0:** max is 11 bytes so one entry of data 391 +(% style="color:blue" %)**0605(H) = 1541 (D) = 1541 mm.** 392 +))) 376 376 377 -* *b)DR1:** maxis 53 bytessodeviceswillupload4entriesofdata(total44 bytes)394 +* If the sensor value is 0x0000, it means system doesn't detect ultrasonic sensor. 378 378 379 -* *c)DR2:**totalpayloadincludes11entriesofdata396 +* If the sensor value lower than 0x0014 (20mm), the sensor value will be invalid. 380 380 381 -**d) DR3:** total payload includes 22 entries of data. 382 382 383 - IfDS20Ldoesn'thaveany data in thepollingtime.It will uplink11 bytes of 0399 +=== 2.3.3 Interrupt Pin === 384 384 385 385 386 - **Downlink:**402 +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. 387 387 388 - 0x31 64 CC 68 0C 64 CC 69 74 05404 +**Example:** 389 389 390 - [[image:image-20230805144936-2.png||height="113" width="746"]]406 +0x00: Normal uplink packet. 391 391 392 - **Uplink:**408 +0x01: Interrupt Uplink Packet. 393 393 394 -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 395 395 411 +=== 2.3.4 DS18B20 Temperature sensor === 396 396 397 -**Parsed Value:** 398 398 399 - [DISTANCE, DISTANCE_SIGNAL_STRENGTH,LIDAR_TEMP,EXTI_STATUS,EXTI_FLAG,TIME]414 +This is optional, user can connect external DS18B20 sensor to the +3.3v, 1-wire and GND pin . and this field will report temperature. 400 400 416 +**Example**: 401 401 402 - [360,176,30,High,True,2023-08-0402:53:00],418 +If payload is: 0105H: (0105 & FC00 == 0), temp = 0105H /10 = 26.1 degree 403 403 404 - [355,168,30,Low,False,2023-08-0402:53:29],420 +If payload is: FF3FH : (FF3F & FC00 == 1) , temp = (FF3FH - 65536)/10 = -19.3 degrees. 405 405 406 -[245,211,30,Low,False,2023-08-04 02:54:29], 407 407 408 - [57,700,30,Low,False,2023-08-0402:55:29],423 +=== 2.3.5 Sensor Flag === 409 409 410 -[361,164,30,Low,True,2023-08-04 02:56:00], 411 411 412 -[337,184,30,Low,False,2023-08-04 02:56:40], 426 +((( 427 +0x01: Detect Ultrasonic Sensor 428 +))) 413 413 414 -[20,4458,30,Low,False,2023-08-04 02:57:40], 430 +((( 431 +0x00: No Ultrasonic Sensor 432 +))) 415 415 416 -[362,173,30,Low,False,2023-08-04 02:58:53], 417 417 435 +=== 2.3.6 Decode payload in The Things Network === 418 418 419 -**History read from serial port:** 420 420 421 -[[image:image-20230805145056-3.png]] 422 - 423 - 424 -=== 2.3.4 Decode payload in The Things Network === 425 - 426 - 427 427 While using TTN network, you can add the payload format to decode the payload. 428 428 429 -[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/L LDS12-LoRaWAN%20LiDAR%20ToF%20Distance%20Sensor%20User%20Manual/WebHome/1654592762713-715.png?rev=1.1||alt="1654592762713-715.png"]]440 +[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDDS75%20-%20LoRaWAN%20Distance%20Detection%20Sensor%20User%20Manual/WebHome/1654850829385-439.png?rev=1.1||alt="1654850829385-439.png"]] 430 430 442 +The payload decoder function for TTN V3 is here: 431 431 432 432 ((( 433 -T hepayloaddecoderfunctionforTTNis here:445 +LDS12-LB TTN V3 Payload Decoder: [[ttps:~~/~~/github.com/dragino/dragino-end-node-decoder>>https://github.com/dragino/dragino-end-node-decoder]] 434 434 ))) 435 435 436 -((( 437 -DS20L TTN Payload Decoder: [[https:~~/~~/github.com/dragino/dragino-end-node-decoder>>https://github.com/dragino/dragino-end-node-decoder]] 438 -))) 439 439 449 +== 2.4 Uplink Interval == 440 440 441 -== 2.4 Show Data in DataCake IoT Server == 442 442 452 +The LDS12-LB by default uplink the sensor data every 20 minutes. User can change this interval by AT Command or LoRaWAN Downlink Command. See this link: [[Change Uplink Interval>>||anchor="H3.3.1SetTransmitIntervalTime"]] 443 443 454 + 455 +== 2.5 Show Data in DataCake IoT Server == 456 + 457 + 444 444 ((( 445 445 [[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: 446 446 ))) ... ... @@ -463,7 +463,7 @@ 463 463 464 464 (% style="color:blue" %)**Step 3**(%%)**: Create an account or log in Datacake.** 465 465 466 -(% style="color:blue" %)**Step 4**(%%)**: Search the DS2 0L and add DevEUI.**480 +(% style="color:blue" %)**Step 4**(%%)**: Search the LDS12-LB and add DevEUI.** 467 467 468 468 [[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"]] 469 469 ... ... @@ -473,29 +473,34 @@ 473 473 [[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"]] 474 474 475 475 476 -== 2. 5Datalog Feature ==490 +== 2.6 Datalog Feature == 477 477 478 478 479 -Datalog Feature is to ensure IoT Server can get all sampling data from Sensor even if the LoRaWAN network is down. For each sampling, DS2 0L will store the reading for future retrieving purposes.493 +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. 480 480 481 481 482 -=== 2. 5.1 Ways to get datalog via LoRaWAN ===496 +=== 2.6.1 Ways to get datalog via LoRaWAN === 483 483 484 484 485 -Set PNACKMD=1, DS2 0L will wait for ACK for every uplink, when there is no LoRaWAN network,0L 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.499 +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. 486 486 487 487 * ((( 488 -a) DS2 0L will do an ACK check for data records sending to make sure every data arrive server.502 +a) LDS12-LB will do an ACK check for data records sending to make sure every data arrive server. 489 489 ))) 490 490 * ((( 491 -b) DS2 0L will send data in **CONFIRMED Mode** when PNACKMD=1, but DS20L 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 DS20L gets a ACK, DS20L will consider there is a network connection and resend all NONE-ACK messages.505 +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. 492 492 ))) 493 493 494 - ===2.5.2 UnixTimeStamp ===508 +Below is the typical case for the auto-update datalog feature (Set PNACKMD=1) 495 495 510 +[[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-20220703111700-2.png?width=1119&height=381&rev=1.1||alt="图片-20220703111700-2.png" height="381" width="1119"]] 496 496 497 -DS20L uses Unix TimeStamp format based on 498 498 513 +=== 2.6.2 Unix TimeStamp === 514 + 515 + 516 +LDS12-LB uses Unix TimeStamp format based on 517 + 499 499 [[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"]] 500 500 501 501 User can get this time from link: [[https:~~/~~/www.epochconverter.com/>>url:https://www.epochconverter.com/]] : ... ... @@ -508,23 +508,23 @@ 508 508 So, we can use AT+TIMESTAMP=1611889405 or downlink 3060137afd00 to set the current time 2021 – Jan ~-~- 29 Friday 03:03:25 509 509 510 510 511 -=== 2. 5.3 Set Device Time ===530 +=== 2.6.3 Set Device Time === 512 512 513 513 514 514 User need to set (% style="color:blue" %)**SYNCMOD=1**(%%) to enable sync time via MAC command. 515 515 516 -Once DS2 0L Joined LoRaWAN network, it will send the MAC command (DeviceTimeReq) and the server will reply with (DeviceTimeAns) to send the current time to DS20L. If DS20L fails to get the time from the server, DS20L will use the internal time and wait for next time request (AT+SYNCTDC to set the time request period, default is 10 days).535 +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). 517 517 518 518 (% 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.** 519 519 520 520 521 -=== 2. 5.4 Poll sensor value ===540 +=== 2.6.4 Poll sensor value === 522 522 523 523 524 524 Users can poll sensor values based on timestamps. Below is the downlink command. 525 525 526 526 (% border="1" cellspacing="5" style="background-color:#f2f2f2; width:425.818px" %) 527 -|(% colspan="4" style="background-color:# 4f81bd; color:white; width:423px" %)**Downlink Command to poll Open/Close status (0x31)**546 +|(% colspan="4" style="background-color:#d9e2f3; color:#0070c0; width:423px" %)**Downlink Command to poll Open/Close status (0x31)** 528 528 |(% style="width:58px" %)**1byte**|(% style="width:127px" %)**4bytes**|(% style="width:124px" %)**4bytes**|(% style="width:114px" %)**1byte** 529 529 |(% style="width:58px" %)31|(% style="width:127px" %)Timestamp start|(% style="width:124px" %)Timestamp end|(% style="width:114px" %)Uplink Interval 530 530 ... ... @@ -541,24 +541,24 @@ 541 541 ))) 542 542 543 543 ((( 544 -Uplink Internal =5s,means DS2 0L will send one packet every 5s. range 5~~255s.563 +Uplink Internal =5s,means LDS12-LB will send one packet every 5s. range 5~~255s. 545 545 ))) 546 546 547 547 548 -== 2. 6Frequency Plans ==567 +== 2.7 Frequency Plans == 549 549 550 550 551 -The DS2 0L 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.570 +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. 552 552 553 553 [[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20Frequency%20Band/>>http://wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20Frequency%20Band/]] 554 554 555 555 556 -3. Configure DS2 0L575 += 3. Configure LDS12-LB = 557 557 558 558 == 3.1 Configure Methods == 559 559 560 560 561 -DS2 0L supports below configure method:580 +LDS12-LB supports below configure method: 562 562 563 563 * AT Command via Bluetooth Connection (**Recommended**): [[BLE Configure Instruction>>http://wiki.dragino.com/xwiki/bin/view/Main/BLE%20Bluetooth%20Remote%20Configure/]]. 564 564 ... ... @@ -581,10 +581,10 @@ 581 581 [[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/]] 582 582 583 583 584 -== 3.3 Commands special design for DS2 0L ==603 +== 3.3 Commands special design for LDS12-LB == 585 585 586 586 587 -These commands only valid for DS2 0L, as below:606 +These commands only valid for LDS12-LB, as below: 588 588 589 589 590 590 === 3.3.1 Set Transmit Interval Time === ... ... @@ -599,7 +599,7 @@ 599 599 ))) 600 600 601 601 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %) 602 -|=(% 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**621 +|=(% style="width: 156px;background-color:#D9E2F3; color:#0070c0" %)**Command Example**|=(% style="width: 137px;background-color:#D9E2F3; color:#0070c0" %)**Function**|=(% style="background-color:#D9E2F3; color:#0070c0" %)**Response** 603 603 |(% style="width:156px" %)AT+TDC=?|(% style="width:137px" %)Show current transmit Interval|((( 604 604 30000 605 605 OK ... ... @@ -635,24 +635,20 @@ 635 635 === 3.3.2 Set Interrupt Mode === 636 636 637 637 638 -Feature, Set Interrupt mode for pinofGPIO_EXTI.657 +Feature, Set Interrupt mode for PA8 of pin. 639 639 640 -When AT+INTMOD=0 is set, GPIO_EXTIis used as a digital input port.659 +When AT+INTMOD=0 is set, PA8 is used as a digital input port. 641 641 642 642 (% style="color:blue" %)**AT Command: AT+INTMOD** 643 643 644 644 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %) 645 -|=(% 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**664 +|=(% style="width: 155px;background-color:#D9E2F3;color:#0070C0" %)**Command Example**|=(% style="width: 197px;background-color:#D9E2F3;color:#0070C0" %)**Function**|=(% style="width: 158px;background-color:#D9E2F3;color:#0070C0" %)**Response** 646 646 |(% style="width:154px" %)AT+INTMOD=?|(% style="width:196px" %)Show current interrupt mode|(% style="width:157px" %)((( 647 647 0 648 648 OK 649 649 the mode is 0 =Disable Interrupt 650 650 ))) 651 -|(% style="width:154px" %)((( 652 -AT+INTMOD=2 653 - 654 -(default) 655 -)))|(% style="width:196px" %)((( 670 +|(% style="width:154px" %)AT+INTMOD=2|(% style="width:196px" %)((( 656 656 Set Transmit Interval 657 657 0. (Disable Interrupt), 658 658 ~1. (Trigger by rising and falling edge) ... ... @@ -674,7 +674,7 @@ 674 674 = 4. Battery & Power Consumption = 675 675 676 676 677 -DS2 0L usebuilt-in2400mAhnon-chargeablebatteryfor long-term use upto several years*. See below link for detail information about the battery info and how to replace.692 +LDS12-LB use ER26500 + SPC1520 battery pack. See below link for detail information about the battery info and how to replace. 678 678 679 679 [[**Battery Info & Power Consumption Analyze**>>http://wiki.dragino.com/xwiki/bin/view/Main/How%20to%20calculate%20the%20battery%20life%20of%20Dragino%20sensors%3F/]] . 680 680 ... ... @@ -683,7 +683,7 @@ 683 683 684 684 685 685 (% class="wikigeneratedid" %) 686 -User can change firmware DS2 0L to:701 +User can change firmware LDS12-LB to: 687 687 688 688 * Change Frequency band/ region. 689 689 ... ... @@ -691,7 +691,7 @@ 691 691 692 692 * Fix bugs. 693 693 694 -Firmware and changelog can be downloaded from : **[[Firmware download link>>https://www.dropbox.com/sh/ zqv1vt3komgp4tu/AAC33PnXIcWOVl_UXBEAeT_xa?dl=0]]**709 +Firmware and changelog can be downloaded from : **[[Firmware download link>>url:https://www.dropbox.com/sh/ph4uyz0rchflrnw/AADr1f_5Sg30804NItpfOQbla?dl=0]]** 695 695 696 696 Methods to Update Firmware: 697 697 ... ... @@ -702,10 +702,10 @@ 702 702 703 703 = 6. FAQ = 704 704 705 -== 6.1 What is the frequency plan for DS2 0L? ==720 +== 6.1 What is the frequency plan for LDS12-LB? == 706 706 707 707 708 -DS2 0L 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"]]723 +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"]] 709 709 710 710 711 711 = 7. Trouble Shooting = ... ... @@ -720,11 +720,11 @@ 720 720 721 721 722 722 ((( 723 -(% style="color:blue" %)**Cause ①**(%%)**:**Due to the physical principles of The LiDAR probe, the above phenomenon is likely to occur if the detection object is the material with high reflectivity (such as mirror, smooth floor tile, etc.) or transparent substance .(such as glass and water, etc.)738 +(% style="color:blue" %)**Cause ①**(%%)**:**Due to the physical principles of The LiDAR probe, the above phenomenon is likely to occur if the detection object is the material with high reflectivity (such as mirror, smooth floor tile, etc.) or transparent substance (such as glass and water, etc.) 724 724 ))) 725 725 726 726 ((( 727 - (% style="color:red" %)**Troubleshooting**(%%): Please avoid use of this product under such circumstance in practice.742 +Troubleshooting: Please avoid use of this product under such circumstance in practice. 728 728 ))) 729 729 730 730 ... ... @@ -733,7 +733,7 @@ 733 733 ))) 734 734 735 735 ((( 736 - (% style="color:red" %)**Troubleshooting**(%%): please use dry dust-free cloth to gently remove the foreign matter.751 +Troubleshooting: please use dry dust-free cloth to gently remove the foreign matter. 737 737 ))) 738 738 739 739 ... ... @@ -740,7 +740,7 @@ 740 740 = 8. Order Info = 741 741 742 742 743 -Part Number: (% style="color:blue" %)**DS2 0L-XXX**758 +Part Number: (% style="color:blue" %)**LDS12-LB-XXX** 744 744 745 745 (% style="color:red" %)**XXX**(%%): **The default frequency band** 746 746 ... ... @@ -766,7 +766,7 @@ 766 766 767 767 (% style="color:#037691" %)**Package Includes**: 768 768 769 -* DS2 0L LoRaWANSmartDistanceDetector x 1784 +* LDS12-LB LoRaWAN LiDAR ToF Distance Sensor x 1 770 770 771 771 (% style="color:#037691" %)**Dimension and weight**: 772 772
- image-20230614162334-2.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -88.3 KB - Content
- image-20230614162359-3.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -88.3 KB - Content
- image-20230615152941-1.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -87.9 KB - Content
- image-20230615153004-2.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -87.9 KB - Content
- image-20230805103904-1.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -46.9 KB - Content
- image-20230805104104-2.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -46.3 KB - Content
- image-20230805144259-1.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -872.7 KB - Content
- image-20230805144936-2.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -37.5 KB - Content
- image-20230805145056-3.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -30.7 KB - Content
- image-20230805150315-4.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -90.6 KB - Content
- image-20230805155335-1.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -45.4 KB - Content
- image-20230805155428-2.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -45.5 KB - Content
- image-20230805155515-3.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -45.7 KB - Content
- image-20231110085300-1.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -613.3 KB - Content
- image-20231110085342-2.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -178.7 KB - Content
- image-20231110091447-3.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -85.4 KB - Content
- image-20231110091506-4.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -85.4 KB - Content
- image-20231110102635-5.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -84.7 KB - Content