Changes for page DS20L -- LoRaWAN Smart Distance Detector User Manual 01
Last modified by Mengting Qiu on 2023/12/14 11:15
Summary
-
Page properties (2 modified, 0 added, 0 removed)
-
Attachments (0 modified, 0 added, 6 removed)
Details
- Page properties
-
- Title
-
... ... @@ -1,1 +1,1 @@ 1 - DDS75-LB--LoRaWANDistance DetectionSensor1 +SW3L-LB_LoRaWAN_Flow_Sensor_User_Manual - Content
-
... ... @@ -1,9 +1,7 @@ 1 1 (% style="text-align:center" %) 2 -[[image:image-20230 612170349-1.png||height="656" width="656"]]2 +[[image:image-20230530084608-2.jpeg||height="707" width="707"]] 3 3 4 4 5 - 6 - 7 7 **Table of Contents:** 8 8 9 9 {{toc/}} ... ... @@ -15,24 +15,29 @@ 15 15 16 16 = 1. Introduction = 17 17 18 -== 1.1 What is LoRaWAN Distance DetectionSensor ==16 +== 1.1 What is CPL03-LB LoRaWAN Pulse/Contact Sensor == 19 19 20 20 21 -The Dragino DDS75-LB is a (% style="color:blue" %)**Distance DetectionSensor**(%%) for Internet of Things solution. Itis usedto measurethedistance between thesensoranda flat object. The distance detectionsensor is a modulethates (%style="color:blue" %)** ultrasonicsensingtechnology**(%%) for (% style="color:blue" %)**distancemeasurement**(%%),and (% style="color:blue" %)** temperaturecompensation**(%%) isperformedinternallyto improve the reliabilityof data. The DDS75-LB can be applied toscenariossuch as horizontal distancemeasurement, liquid level measurement,parking managementsystem,object proximityandpresence detection, intelligent trash can managementsystem,robotbstacle avoidance, automatic control, sewer, bottom water level monitoring, etc.19 +The Dragino CPL03-LB is a (% style="color:blue" %)**LoRaWAN Contact Sensor**(%%) for Internet of Things solution. It detects dry contact status, open time, open counts, and then upload to IoT server via LoRaWAN wireless protocol. 22 22 23 - Itdetectsthe distance(%style="color:blue"%)** between themeasuredobject and the sensor**(%%),anduploads thevalue viawirelesstoLoRaWANIoTServer.21 +The CPL03-LB will send periodically data every day as well as for each dry contact action. It also counts the contact open times and calculate last open duration. User can also disable the uplink for each open/close event, instead, device can count each open event and uplink periodically. 24 24 25 -The LoRa wireless technology used in DDS75-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.23 +The LoRa wireless technology used in CPL03-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. 26 26 27 - DDS75-LBBLE configure**(%%) and(% style="color:blue" %)**wirelessOTAupdate**(%%)whichmakeuserasyto use.25 +CPL03-LB (% style="color:blue" %)**supports open alarm feature**(%%), user can set open alarm for instant notice. CPL03-LB (% style="color:blue" %)**supports Datalog feature**(%%), it can save the data when there is no LoRaWAN network and uplink when network recover. 28 28 29 - DDS75-LB ispoweredby (%style="color:blue"%)**8500mAhLi-SOCI2battery**(%%),it is designedfor longtermuseupto5years.27 +CPL03-LB is designed for outdoor use. It has a weatherproof enclosure and industrial level battery to work in low to high temperatures. 30 30 31 - Each DDS75-LBispre-load with a setofuniquekeysfor LoRaWANregistrations, registerthesekeysolocalLoRaWAN serverand itwillauto connectafterpower on.29 +CPL03-LB (% style="color:blue" %)**supports BLE configure**(%%) and (% style="color:blue" %)**wireless OTA update**(%%) which make user easy to use. 32 32 33 - [[image:image-20230612170943-2.png||height="525"width="912"]]31 +CPL03-LB is powered by (% style="color:blue" %)**8500mAh Li-SOCI2 battery**(%%), it is designed for long term use up to 5 years. 34 34 33 +Each CPL03-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. 35 35 35 + 36 +[[image:image-20230530111051-3.png||height="402" width="850"]] 37 + 38 + 36 36 == 1.2 Features == 37 37 38 38 ... ... @@ -39,47 +39,22 @@ 39 39 * LoRaWAN 1.0.3 Class A 40 40 * Bands: CN470/EU433/KR920/US915/EU868/AS923/AU915/IN865 41 41 * Ultra-low power consumption 42 -* Distance Detection by Ultrasonic technology 43 -* Flat object range 280mm - 7500mm 44 -* Accuracy: ±(1cm+S*0.3%) (S: Distance) 45 -* Cable Length : 25cm 45 +* Open/Close detect 46 +* Open/Close statistics 47 +* Temperature & Humidity alarm 48 +* supports open alarm feature 49 +* supports Datalog feature 46 46 * Support Bluetooth v5.1 and LoRaWAN remote configure 47 47 * Support wireless OTA update firmware 48 -* ATCommandstohangeparameters52 +* Uplink on periodically and open/close event 49 49 * Downlink to change configure 50 -* IP66 Waterproof Enclosure 51 51 * 8500mAh Battery for long term use 52 52 53 -== 1.3 Specification == 54 54 55 55 56 - (% style="color:#037691"%)**Rated environmentalconditions:**58 +== 1.3 Specification == 57 57 58 -(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:500px" %) 59 -|(% style="background-color:#d9e2f3; color:#0070c0; width:163px" %)**Item**|(% style="background-color:#d9e2f3; color:#0070c0; width:90px" %)((( 60 -**Minimum value** 61 -)))|(% style="background-color:#d9e2f3; color:#0070c0; width:70px" %)((( 62 -**Typical value** 63 -)))|(% style="background-color:#d9e2f3; color:#0070c0; width:87px" %)((( 64 -**Maximum value** 65 -)))|(% style="background-color:#d9e2f3; color:#0070c0; width:40px" %)**Unit**|(% style="background-color:#d9e2f3; color:#0070c0; width:50px" %)**Remarks** 66 -|(% style="width:174px" %)Storage temperature|(% style="width:86px" %)-25|(% style="width:66px" %)25|(% style="width:90px" %)80|(% style="width:48px" %)℃|(% style="width:203px" %) 67 -|(% style="width:174px" %)Storage humidity|(% style="width:86px" %) |(% style="width:66px" %)65%|(% style="width:90px" %)90%|(% style="width:48px" %)RH|(% style="width:203px" %)(1) 68 -|(% style="width:174px" %)Operating temperature|(% style="width:86px" %)-15|(% style="width:66px" %)25|(% style="width:90px" %)60|(% style="width:48px" %)℃|(% style="width:203px" %) 69 -|(% style="width:174px" %)Working humidity|(% style="width:86px" %)((( 70 - 71 71 72 - 73 -)))|(% style="width:66px" %)65%|(% style="width:90px" %)80%|(% style="width:48px" %)RH|(% style="width:203px" %)(1) 74 - 75 -((( 76 -**Remarks: (1) a. When the ambient temperature is 0-39 ℃, the maximum humidity is 90% (non-condensing); ** 77 - 78 -**~ b. When the ambient temperature is 40-50 ℃, the highest humidity is the highest humidity in the natural world at the current temperature (no condensation)** 79 - 80 - 81 -))) 82 - 83 83 (% style="color:#037691" %)**Common DC Characteristics:** 84 84 85 85 * Supply Voltage: built in 8500mAh Li-SOCI2 battery , 2.5v ~~ 3.6v ... ... @@ -105,41 +105,26 @@ 105 105 * Sleep Mode: 5uA @ 3.3v 106 106 * LoRa Transmit Mode: 125mA @ 20dBm, 82mA @ 14dBm 107 107 108 -== 1.4 Effective measurement range Reference beam pattern == 109 109 110 110 111 - **~1.The tested object is a white cylindricaltube made of PVC, with a heightof 100cm anda diameter of 7.5cm.**88 +== 1.4 Applications == 112 112 113 -[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDDS75%20-%20LoRaWAN%20Distance%20Detection%20Sensor%20User%20Manual/WebHome/1654852253176-749.png?rev=1.1||alt="1654852253176-749.png"]] 114 114 91 +* Open/Close Detection 92 +* Pulse meter application 93 +* Dry Contact Detection 115 115 116 -**2. The object to be tested is a "corrugated cardboard box" perpendicular to the central axis of 0 °, and the length * width is 60cm * 50cm.** 117 117 118 -[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDDS75%20-%20LoRaWAN%20Distance%20Detection%20Sensor%20User%20Manual/WebHome/1654852175653-550.png?rev=1.1||alt="1654852175653-550.png"]] 119 119 97 +== 1.5 Sleep mode and working mode == 120 120 121 -== 1.5 Applications == 122 122 123 - 124 -* Horizontal distance measurement 125 -* Liquid level measurement 126 -* Parking management system 127 -* Object proximity and presence detection 128 -* Intelligent trash can management system 129 -* Robot obstacle avoidance 130 -* Automatic control 131 -* Sewer 132 -* Bottom water level monitoring 133 - 134 -== 1.6 Sleep mode and working mode == 135 - 136 - 137 137 (% 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. 138 138 139 139 (% 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. 140 140 141 141 142 -== 1. 7Button & LEDs ==105 +== 1.6 Button & LEDs == 143 143 144 144 145 145 [[image:Main.User Manual for LoRaWAN End Nodes.D20-LBD22-LBD23-LB_LoRaWAN_Temperature_Sensor_User_Manual.WebHome@1675071855856-879.png]] ... ... @@ -158,12 +158,14 @@ 158 158 ))) 159 159 |(% 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. 160 160 161 -== 1.8 BLE connection == 162 162 163 163 164 - DDS75-LBsupportBLEremotefigure.126 +== 1.7 BLE connection == 165 165 166 166 129 +CPL03-LB support BLE remote configure. 130 + 131 + 167 167 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: 168 168 169 169 * Press button to send an uplink ... ... @@ -173,16 +173,14 @@ 173 173 If there is no activity connection on BLE in 60 seconds, sensor will shut down BLE module to enter low power mode. 174 174 175 175 176 -== 1. 9Pin Definitions ==141 +== 1.8 Pin Definitions == 177 177 178 178 [[image:image-20230523174230-1.png]] 179 179 180 180 146 +== 1.9 Mechanical == 181 181 182 182 183 -== 2.10 Mechanical == 184 - 185 - 186 186 [[image:Main.User Manual for LoRaWAN End Nodes.D20-LBD22-LBD23-LB_LoRaWAN_Temperature_Sensor_User_Manual.WebHome@1675143884058-338.png]] 187 187 188 188 ... ... @@ -192,24 +192,12 @@ 192 192 [[image:Main.User Manual for LoRaWAN End Nodes.D20-LBD22-LBD23-LB_LoRaWAN_Temperature_Sensor_User_Manual.WebHome@1675143909447-639.png]] 193 193 194 194 195 - **ProbeMechanical:**158 += 2. Configure CPL03-LB to connect to LoRaWAN network = 196 196 197 - 198 -[[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-20220610172003-1.png?rev=1.1||alt="image-20220610172003-1.png"]] 199 - 200 - 201 -[[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-20220610172003-2.png?rev=1.1||alt="image-20220610172003-2.png"]] 202 - 203 - 204 -[[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-20220610172003-2.png?rev=1.1||alt="image-20220610172003-2.png"]] 205 - 206 - 207 -= 2. Configure DDS75-LB to connect to LoRaWAN network = 208 - 209 209 == 2.1 How it works == 210 210 211 211 212 -The DDS75-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 theDDS75-LB. It will automatically join the network via OTAA and start to send the sensor value. The default uplink interval is 20 minutes.163 +The CPL03-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 CPL03-LB. It will automatically join the network via OTAA and start to send the sensor value. The default uplink interval is 20 minutes. 213 213 214 214 (% style="display:none" %) (%%) 215 215 ... ... @@ -220,12 +220,12 @@ 220 220 221 221 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. 222 222 223 -[[image:image-20230 612171032-3.png||height="492" width="855"]](% style="display:none" %)174 +[[image:image-20230530111412-4.png||height="398" width="805"]](% style="display:none" %) 224 224 225 225 226 -(% style="color:blue" %)**Step 1:**(%%) Create a device in TTN with the OTAA keys from DDS75-LB.177 +(% style="color:blue" %)**Step 1:**(%%) Create a device in TTN with the OTAA keys from CPL03-LB. 227 227 228 -Each DDS75-LB is shipped with a sticker with the default device EUI as below:179 +Each CPL03-LB is shipped with a sticker with the default device EUI as below: 229 229 230 230 [[image:image-20230426084152-1.png||alt="图片-20230426084152-1.png" height="233" width="502"]] 231 231 ... ... @@ -254,10 +254,10 @@ 254 254 [[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"]] 255 255 256 256 257 -(% style="color:blue" %)**Step 2:**(%%) Activate on DDS75-LB208 +(% style="color:blue" %)**Step 2:**(%%) Activate on CPL03-LB 258 258 259 259 260 -Press the button for 5 seconds to activate the DDS75-LB.211 +Press the button for 5 seconds to activate the CPL03-LB. 261 261 262 262 (% 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. 263 263 ... ... @@ -264,176 +264,477 @@ 264 264 After join success, it will start to upload messages to TTN and you can see the messages in the panel. 265 265 266 266 267 -== 2.3 218 +== 2.3 Uplink Payload == 268 268 220 +=== 2.3.1 Device Status, FPORT~=5 === 269 269 222 + 223 +Users can use the downlink command(**0x26 01**) to ask CPL03-LB to send device configure detail, include device configure status. CPL03-LB will uplink a payload via FPort=5 to server. 224 + 225 +The Payload format is as below. 226 + 227 + 228 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %) 229 +|(% colspan="6" style="background-color:#d9e2f3; color:#0070c0" %)**Device Status (FPORT=5)** 230 +|(% style="width:103px" %)**Size (bytes)**|(% style="width:72px" %)**1**|**2**|(% style="width:91px" %)**1**|(% style="width:86px" %)**1**|(% style="width:44px" %)**2** 231 +|(% style="width:103px" %)**Value**|(% style="width:72px" %)Sensor Model|Firmware Version|(% style="width:91px" %)Frequency Band|(% style="width:86px" %)Sub-band|(% style="width:44px" %)BAT 232 + 233 +Example parse in TTNv3 234 + 235 +[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/CPL01%20LoRaWAN%20Outdoor%20PulseContact%20%20Sensor%20Manual/WebHome/1652859749264-179.png?width=723&height=275&rev=1.1||alt="1652859749264-179.png"]] 236 + 237 + 238 +(% style="color:#037691" %)**Sensor Model**(%%): For CPL03-LB, this value is 0x0A 239 + 240 +(% style="color:#037691" %)**Firmware Version**(%%): 0x0100, Means: v1.0.0 version 241 + 242 +(% style="color:#037691" %)**Frequency Band**: 243 + 244 +*0x01: EU868 245 + 246 +*0x02: US915 247 + 248 +*0x03: IN865 249 + 250 +*0x04: AU915 251 + 252 +*0x05: KZ865 253 + 254 +*0x06: RU864 255 + 256 +*0x07: AS923 257 + 258 +*0x08: AS923-1 259 + 260 +*0x09: AS923-2 261 + 262 +*0x0a: AS923-3 263 + 264 +*0x0b: CN470 265 + 266 +*0x0c: EU433 267 + 268 +*0x0d: KR920 269 + 270 +*0x0e: MA869 271 + 272 + 273 +(% style="color:#037691" %)**Sub-Band**: 274 + 275 +AU915 and US915:value 0x00 ~~ 0x08 276 + 277 +CN470: value 0x0B ~~ 0x0C 278 + 279 +Other Bands: Always 0x00 280 + 281 + 282 +(% style="color:#037691" %)**Battery Info**: 283 + 284 +Check the battery voltage. 285 + 286 +Ex1: 0x0B45 = 2885mV 287 + 288 +Ex2: 0x0B49 = 2889mV 289 + 290 + 291 +=== 2.3.2 Sensor Configuration, FPORT~=4 === 292 + 293 + 294 +CPL03-LB will only send this command after getting the downlink command (0x26 02) from the server. 295 + 296 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %) 297 +|(% colspan="6" style="background-color:#d9e2f3; color:#0070c0; width:504px" %)**Sensor Configuration FPORT=4** 298 +|**Size(bytes)**|(% style="width:75px" %)**3**|(% style="width:77px" %)**1**|(% style="width:96px" %)**1**|(% style="width:158px" %)**2**|(% style="width:158px" %)**1** 299 +|**Value**|(% style="width:75px" %)TDC (unit:sec)|(% style="width:77px" %)Disalarm|(% style="width:96px" %)Keep status|(% style="width:158px" %)Keep time (unit: sec)|(% style="width:158px" %)Trigger mode 300 + 301 +* ((( 302 +(% style="color:#037691" %)** TDC: (default: 0x001C20)** 303 +))) 304 + 270 270 ((( 271 -DDS75-LB will uplink payload via LoRaWAN with below payload format: 306 +Uplink interval for the total pulse count, default value is 0x001C20 which is 7200 seconds = 2 hours. 307 + 308 + 272 272 ))) 273 273 311 +* ((( 312 +(% style="color:#037691" %)** Disalarm: (default: 0)** 313 +))) 314 + 274 274 ((( 275 -Uplink payload includes in total 4 bytes. 276 -Payload for firmware version v1.1.4. . Before v1.1.3, there is on two fields: BAT and Distance 316 +(% style="color:blue" %)** If Disalarm = 1**(%%), CPL03-LB will only send uplink at every TDC periodically. This is normally use for pulse meter application, in this application, there are many disconnect/connect event, and platform only care about the total number of pulse. 277 277 ))) 278 278 319 +((( 320 +(% style="color:blue" %)** If Disalarm = 0**(%%), CPL03-LB will send uplink at every TDC periodically. 279 279 322 + 323 +))) 280 280 281 -(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:510px" %) 282 -|=(% style="width: 62.5px;background-color:#D9E2F3;color:#0070C0" %)((( 283 -**Size(bytes)** 284 -)))|=(% 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** 285 -|(% style="width:62.5px" %)**Value**|(% style="width:62.5px" %)[[BAT>>||anchor="H2.3.1A0BatteryInfo"]]|((( 286 -[[Distance>>||anchor="H2.3.2A0Distance"]] 287 -(unit: mm) 288 -)))|[[Digital Interrupt (Optional)>>||anchor="H2.3.3A0InterruptPin"]]|((( 289 -[[Temperature (Optional )>>||anchor="H2.3.4A0DS18B20Temperaturesensor"]] 290 -)))|[[Sensor Flag>>||anchor="H2.3.5A0SensorFlag"]] 325 +* ((( 326 +(% style="color:#037691" %)** Keep Status & Keep Time** 327 +))) 291 291 292 -[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDDS75%20-%20LoRaWAN%20Distance%20Detection%20Sensor%20User%20Manual/WebHome/1654850511545-399.png?rev=1.1||alt="1654850511545-399.png"]] 329 +((( 330 +Shows the configure value of [[Alarm Base on Timeout Feature>>||anchor="H3.3.5AlarmBaseonTimeout"]] 293 293 332 + 333 +))) 294 294 295 -=== 2.3.1 Battery Info === 335 +* ((( 336 +(% style="color:#037691" %)** Trigger mode (default: 0)** 337 +))) 296 296 339 +((( 340 +(% style="color:blue" %)** If Trigger mode = 0**(%%), count close to open event. 341 +))) 297 297 298 -Check the battery voltage for DDS75-LB. 343 +((( 344 +(% style="color:blue" %)** If Trigger mode = 1**(%%), count open to close event. 345 +))) 299 299 300 - Ex1:0x0B455mV347 +[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/CPL01%20LoRaWAN%20Outdoor%20PulseContact%20%20Sensor%20Manual/WebHome/1652860064987-743.png?width=730&height=152&rev=1.1||alt="1652860064987-743.png"]] 301 301 302 -Ex2: 0x0B49 = 2889mV 303 303 350 +[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/CPL01%20LoRaWAN%20Outdoor%20PulseContact%20%20Sensor%20Manual/WebHome/1652860079526-831.png?width=729&height=209&rev=1.1||alt="1652860079526-831.png"]] 304 304 305 -=== 2.3.2 Distance === 306 306 353 +=== 2.3.3 Real-Time Open/Close Status, Uplink FPORT~=2 === 307 307 355 + 308 308 ((( 309 -Get the distance. Flat object range 280mm - 7500mm. 357 +((( 358 +CPL03-LB will send this uplink **after** Device Status once join the LoRaWAN network successfully. And CPL03-LB will: 310 310 ))) 360 +))) 311 311 312 312 ((( 313 -For example, if the data you get from the register is 0x0B 0x05, the distance between the sensor and the measured object is(% style="color:#4472c4" %)** ** 363 +((( 364 +periodically send this uplink every 2 hours, this interval [[can be changed>>||anchor="H3.3.1SetTransmitIntervalTime"]]. 365 +))) 366 +))) 314 314 315 -(% style="color:#4472c4" %)**0B05(H) = 2821 (D) = 2821 mm.** 368 +((( 369 +((( 370 +Uplink Payload totals 11 bytes. 316 316 ))) 372 +))) 317 317 374 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:520px" %) 375 +|=(% colspan="5" style="background-color:#D9E2F3;color:#0070C0; width: 520px;" %)**Real-Time Open/Close Status, FPORT=2** 376 +|(% style="width:60px" %)**Size(bytes)**|(% style="width:65px" %)**1**|(% style="width:65px" %)**3**|(% style="width:240px" %)**3**|(% style="width:90px" %)**4** 377 +|(% style="width:101px" %)**Value**|(% style="width:133px" %)Status & [[Alarm>>||anchor="H3.3.5AlarmBaseonTimeout"]]|(% style="width:92px" %)Total pulse|(% style="width:247px" %)The last open duration (unit: min)|(% style="width:149px" %)[[Unix TimeStamp>>||anchor="H2.5.2UnixTimeStamp"]] 318 318 319 -* If the sensor value is 0x0000, it means system doesn't detect ultrasonic sensor. 320 -* If the sensor value lower than 0x0118 (280mm), the sensor value will be invalid. Since v1.1.4, all value lower than 280mm will be set to 0x0014(20mm) which means the value is invalid. 379 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:504px" %) 380 +|=(% colspan="4" style="background-color:#D9E2F3;color:#0070C0; width: 502px;" %)**Status & Alarm field** 381 +|(% style="width:60px" %)**Size(bit)**|(% style="width:70px" %)**6**|(% style="width:228px" %)**1**|(% style="width:146px" %)**1** 382 +|(% style="width:76px" %)Value|(% style="width:80px" %)Calculate Flag|(% style="width:208px" %)Alarm: 0: No Alarm; 1: Alarm|(% style="width:136px" %)Contact Status: 0: Open, 1: Close 321 321 384 +* ((( 385 +(% style="color:#037691" %)** Calculate Flag** 386 +))) 322 322 388 +((( 389 +The calculate flag is a user define field, IoT server can use this filed to handle different meter with different pulse factor. For example, if there are 100 water meters, meter 1 ~~50 are 1 liter/pulse and meter 51 ~~ 100 has 1.5 liter/pulse. 390 +))) 323 323 324 -=== 2.3.3 Interrupt Pin === 392 +((( 393 +User can set calculate flag to 1 for meter 1~~50 and 2 for meter 51 ~~ 100, So IoT Server can use this field for calculation. 394 +))) 325 325 396 +((( 397 +Default value: 0. 398 +))) 326 326 327 -This data field shows if this packet is generated by interrupt or not. [[Click here>>||anchor="H3.3A0SetInterruptMode"]] for the hardware and software set up. 400 +((( 401 +Range (6 bits): (b)000000 ~~ (b) 111111 402 +))) 328 328 329 -**Example:** 404 +((( 405 +Refer: [[Set Calculate Flag>>||anchor="H3.3.8Setthecalculateflag"]] 330 330 331 -0x00: Normal uplink packet. 407 + 408 +))) 332 332 333 -0x01: Interrupt Uplink Packet. 410 +* ((( 411 +(% style="color:#037691" %)** Alarm** 412 +))) 334 334 414 +((( 415 +See [[Alarm Base on Timeout>>||anchor="H3.3.5AlarmBaseonTimeout"]] 335 335 336 -=== 2.3.4 DS18B20 Temperature sensor === 417 + 418 +))) 337 337 420 +* ((( 421 +(% style="color:#037691" %)** Contact Status** 422 +))) 338 338 339 -This is optional, user can connect external DS18B20 sensor to the +3.3v, 1-wire and GND pin . and this field will report temperature. 424 +((( 425 +0: Open 426 +))) 340 340 341 -**Example**: 428 +((( 429 +1: Close 342 342 343 -If payload is: 0105H: (0105 & FC00 == 0), temp = 0105H /10 = 26.1 degree 431 + 432 +))) 344 344 345 -If payload is: FF3FH : (FF3F & FC00 == 1) , temp = (FF3FH - 65536)/10 = -19.3 degrees. 434 +* ((( 435 +(% style="color:#037691" %)** Total pulse** 436 +))) 346 346 347 -(% style="color:red" %)**Note: DS18B20 feature is supported in the hardware version > v1.3 which made since early of 2021.** 438 +((( 439 +Total pulse/counting base on dry [[contact trigger event>>||anchor="H2.3.2SensorConfiguration2CFPORT3D4"]] 440 +))) 348 348 442 +((( 443 +Range (3 Bytes) : 0x000000 ~~ 0xFFFFFF . Max: 16777215 349 349 350 -=== 2.3.5 Sensor Flag === 445 + 446 +))) 351 351 448 +* ((( 449 +(% style="color:#037691" %)** The last open duration** 450 +))) 352 352 353 353 ((( 354 - 0x01:DetectUltrasonicSensor453 +Dry Contact last open duration. 355 355 ))) 356 356 357 357 ((( 358 - 0x00: NoUltrasonicSensor457 +Unit: min. 359 359 ))) 360 360 460 +[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/CPL01%20LoRaWAN%20Outdoor%20PulseContact%20%20Sensor%20Manual/WebHome/1652860403792-491.png?width=735&height=153&rev=1.1||alt="1652860403792-491.png"]] 361 361 362 -=== 2.3.6 Decode payload in The Things Network === 363 363 463 +=== 2.3.4 Real-Time Open/Close Status, 3 pulse mode, Uplink FPORT~=6 === 364 364 365 -While using TTN network, you can add the payload format to decode the payload. 366 366 367 - [[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"]]466 +(% style="color:red" %)**Note:** 368 368 369 -The payload decoder function for TTN V3 is here: 468 +* Firmware support for this mode is not released. If users want to test, please contact Dragino support. 469 +* Users need to run (% style="color:blue" %)**AT+MOD=3**(%%) to support this model after updating the firmware. 470 +* This mode doesn't support Historical Events and Datalog features. 370 370 472 +(% style="color:blue" %)**CPL03-LB 3 Pulse Wiring:** 473 + 474 +[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/CPL01%20LoRaWAN%20Outdoor%20PulseContact%20%20Sensor%20Manual/WebHome/image-20221013153352-1.png?width=720&height=628&rev=1.1||alt="image-20221013153352-1.png"]] 475 + 476 + 477 +(% style="color:blue" %)**Payload:** 478 + 479 +[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/CPL01%20LoRaWAN%20Outdoor%20PulseContact%20%20Sensor%20Manual/WebHome/image-20221013153352-2.png?width=1215&height=167&rev=1.1||alt="image-20221013153352-2.png"]] 480 + 481 + 482 +(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:447px" %) 483 +|(% style="background-color:#d9e2f3; color:#0070c0; width:95px" %)**Size(bytes)**|(% style="background-color:#d9e2f3; color:#0070c0; width:61px" %)**1**|(% style="background-color:#d9e2f3; color:#0070c0; width:98px" %)**3**|(% style="background-color:#d9e2f3; color:#0070c0; width:98px" %)**3**|(% style="background-color:#d9e2f3; color:#0070c0; width:95px" %)**3** 484 +|(% style="width:93px" %)Value|(% style="width:59px" %)Status|(% style="width:98px" %)((( 485 +Port1 Total Pulse(PB14) 486 +)))|(% style="width:96px" %)((( 487 +Port2 Total Pulse(PB15) 488 +)))|(% style="width:94px" %)((( 489 +Port3 Total Pulse(PA4) 490 +))) 491 + 492 +(% style="color:blue" %)**Status:** 493 + 494 +(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:257px" %) 495 +|(% style="background-color:#d9e2f3; color:#0070c0; width:75px" %)**Size(bit)**|(% style="background-color:#d9e2f3; color:#0070c0; width:112px" %)**6**|(% style="background-color:#d9e2f3; color:#0070c0; width:70px" %)**2** 496 +|(% style="width:75px" %)Value|(% style="width:111px" %)Calculate Flag|(% style="width:68px" %)Reserve 497 + 498 +(% style="color:red" %)**Max COUNT for each port is 16777215. Exceed this number will reset to 1.** 499 + 500 + 501 +(% style="color:blue" %)**Related AT Command:** 502 + 503 +(% style="color:#037691" %)**AT+TTRMOD1: Port1 count mode; 0: Signal falling edge(Default), 1: Signal raising edge** 504 + 505 + AT+TTRMOD1=0 Downlink Command: 0xA4 01 00 506 + 507 + AT+TTRMOD1=1 Downlink Command: 0xA4 01 01 508 + 509 + 510 +(% style="color:#037691" %)**AT+TTRMOD2: Port2 count mode; 0: Signal falling edge(Default), 1: Signal raising edge** 511 + 512 + AT+TTRMOD1=0 Downlink Command: 0xA4 02 00 513 + 514 + AT+TTRMOD1=1 Downlink Command: 0xA4 02 01 515 + 516 + 517 +(% style="color:#037691" %)**AT+TTRMOD3: Port3 count mode; 0: Signal falling edge(Default), 1: Signal raising edge** 518 + 519 + AT+TTRMOD1=0 Downlink Command: 0xA4 03 00 520 + 521 + AT+TTRMOD1=1 Downlink Command: 0xA4 03 01 522 + 523 + 524 +(% style="color:#037691" %)**AT+CALCFLAG: Calculate Flag ( Default : 0 )** 525 + 526 + AT+CALCFLAG=aa 527 + 528 + 529 +(% style="color:blue" %)**Downlink Command: 0xA5 aa** 530 + 531 +(% style="color:#037691" %)**AT+COUNTMOD: Accumulative Mode; 0: Accumulative (Default),1: Reset after uplink.** 532 + 533 + AT+COUNTMOD=0 Downlink Command: 0x0B 00 534 + 535 + AT+COUNTMOD=1 Downlink Command: 0x0B 01 536 + 537 + 538 +(% style="color:#037691" %)**AT+SETCNT: Set count value** 539 + 540 + AT+SETCNT=1,aa Downlink Command: 0xA6 01 aa aa aa 541 + 542 + AT+SETCNT=2,aa Downlink Command: 0xA6 02 aa aa aa 543 + 544 + AT+SETCNT=3,aa Downlink Command: 0xA6 03 aa aa aa 545 + 546 + 547 +(% style="color:blue" %)**Decode: **(%%)[[https:~~/~~/github.com/dragino/dragino-end-node-decoder>>https://github.com/dragino/dragino-end-node-decoder]] 548 + 549 + 550 +=== 2.3.5 Historical Door Open/Close Event, FPORT~=3 === 551 + 552 + 371 371 ((( 372 - DDS75-LBTTNV3PayloadDecoder: [[ttps:~~/~~/github.com/dragino/dragino-end-node-decoder>>https://github.com/dragino/dragino-end-node-decoder]]554 +CPL03-LB stores sensor values and users can retrieve these history values via the [[downlink command>>||anchor="H2.5DatalogFeature"]]. 373 373 ))) 374 374 557 +((( 558 +The historical payload includes one or multiplies entries and every entry has the same payload as Real-Time open/close status. 559 +))) 375 375 376 -== 2.4 Uplink Interval == 561 +* ((( 562 +Each data entry is 11 bytes and has the same structure as [[Real-Time open/close status>>||anchor="H2.3.3Real-TimeOpen2FCloseStatus2CUplinkFPORT3D2"]], to save airtime and battery, CPL03-LB will send max bytes according to the current DR and Frequency bands. 563 +))) 377 377 565 +((( 566 +For example, in the US915 band, the max payload for different DR is: 567 +))) 378 378 379 -The DDS75-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>>doc:Main.End Device AT Commands and Downlink Command.WebHome||anchor="H4.1ChangeUplinkInterval"]] 569 +((( 570 +a) (% style="color:blue" %)**DR0**(%%): max is 11 bytes so one entry of data 571 +))) 380 380 573 +((( 574 +b) (% style="color:blue" %)**DR1**(%%): max is 53 bytes so devices will upload 4 entries of data (total 44 bytes) 575 +))) 381 381 382 -== 2.5 Show Data in DataCake IoT Server == 577 +((( 578 +c) (% style="color:blue" %)**DR2**(%%): total payload includes 11 entries of data 579 +))) 383 383 581 +((( 582 +d) (% style="color:blue" %)**DR3**(%%): total payload includes 22 entries of data. 583 +))) 384 384 385 385 ((( 386 -[[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: 586 +If CPL03-LB doesn't have any data in the polling time. It will uplink 11 bytes of 0 587 + 588 + 387 387 ))) 388 388 591 +(% style="color:blue" %)** Downlink:** 592 + 593 +(% class="box" %) 389 389 ((( 595 +**0x31 61 E9 3A D4 61 E9 3D E0 05** 596 +))) 597 + 598 +[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/CPL01%20LoRaWAN%20Outdoor%20PulseContact%20%20Sensor%20Manual/WebHome/1652861353248-624.png?width=720&height=189&rev=1.1||alt="1652861353248-624.png"]] 599 + 600 + 601 +(% style="color:blue" %)** Uplink:** 602 + 603 +(% class="box" %) 604 +((( 605 +**0E 00 23 E6 00 00 00 61 E9 3B 04 0E 00 23 E6 00 00 00 61 E9 3B 25 0D 00 00 00 00 00 00 61 E9 3B C8 0E 00 00 02 00 00 00 61 E9 3B D4 0E 00 00 06 00 00 00 61 E9 3B DB 01 00 00 00 00 00 00 61 E9 3C 91 01 00 00 00 00 00 00 61 E9 3C A1 0D 00 00 00 00 00 00 61 E9 3C BC 0E 00 00 07 00 00 00 61 E9 3C D6 00 00 00 00 00 00 00 61 E9 3D A6** 606 +))) 607 + 608 +(% style="color:#037691" %)** ** 609 + 610 +(% style="color:#037691" %)**Parsed Value:** 611 + 612 +((( 613 +[ALARM, PIN_STATUS, TOTAL_PULSE, CALCULATE_FLAG, LAST_OPEN_DURATION, TIME] 614 +))) 615 + 616 +((( 390 390 391 391 ))) 392 392 393 393 ((( 394 - (%style="color:blue" %)**Step1**(%%)**:Besurethatyour device is programmed and properly connected to the network at this time.**621 +[TRUE, CLOSE, 9190, 3, 0, 2022-01-20 10:35:48], 395 395 ))) 396 396 397 397 ((( 398 - (% style="color:blue" %)**Step 2**(%%)**:To configure the Application to forward data to DATACAKEyou will need to add integration. To add the DATACAKEintegration,performthefollowingsteps:**625 +[TRUE, CLOSE, 9190, 3, 0, 2022-01-20 10:36:21], 399 399 ))) 400 400 628 +((( 629 +[FALSE, OPEN, 0, 3, 0, 2022-01-20 10:39:04], 630 +))) 401 401 402 -[[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"]] 632 +((( 633 +[TRUE, CLOSE, 2, 3, 0, 2022-01-20 10:39:16], 634 +))) 403 403 636 +((( 637 +[TRUE, CLOSE, 6, 3, 0, 2022-01-20 10:39:23], 638 +))) 404 404 405 -[[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"]] 640 +((( 641 +[FALSE, OPEN, 0, 0, 0, 2022-01-20 10:42:25], 642 +))) 406 406 644 +((( 645 +[FALSE, OPEN, 0, 0, 0, 2022-01-20 10:42:41], 646 +))) 407 407 408 -(% style="color:blue" %)**Step 3**(%%)**: Create an account or log in Datacake.** 648 +((( 649 +[FALSE, OPEN, 0, 3, 0, 2022-01-20 10:43:08], 650 +))) 409 409 410 -(% style="color:blue" %)**Step 4**(%%)**: Search the DDS75-LB and add DevEUI.** 652 +((( 653 +[TRUE, CLOSE, 7, 3, 0, 2022-01-20 10:43:34], 654 +))) 411 411 412 -[[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"]] 656 +((( 657 +[FALSE, CLOSE, 0, 0, 0, 2022-01-20 10:47:02], 413 413 659 + 660 +))) 414 414 415 - Aftered, thesensora arriveTTN V3, itwillalsoarriveand show inDatacake.662 +[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/CPL01%20LoRaWAN%20Outdoor%20PulseContact%20%20Sensor%20Manual/WebHome/1652861480446-216.png?rev=1.1||alt="1652861480446-216.png"]] 416 416 417 -[[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"]] 418 418 665 +== 2.4 Payload Decoder file == 419 419 420 420 421 - ==2.6Datalog Feature==668 +In TTN, use can add a custom payload so it shows friendly reading 422 422 670 +In the page (% style="color:#037691" %)**Applications ~-~-> Payload Formats ~-~-> Custom ~-~-> decoder**(%%) to add the decoder from: [[https:~~/~~/github.com/dragino/dragino-end-node-decoder>>https://github.com/dragino/dragino-end-node-decoder]] 423 423 424 -Datalog Feature is to ensure IoT Server can get all sampling data from Sensor even if the LoRaWAN network is down. For each sampling, DDS75-LB will store the reading for future retrieving purposes. 425 425 673 +== 2.5 Datalog Feature == 426 426 427 -=== 2.6.1 Ways to get datalog via LoRaWAN === 428 428 676 +Datalog Feature is to ensure IoT Server can get all sampling data from Sensor even if the LoRaWAN network is down. For each sampling, CPL03-LB will store the reading for future retrieving purposes. 429 429 430 -Set PNACKMD=1, DDS75-LB will wait for ACK for every uplink, when there is no LoRaWAN network,DDS75-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. 431 431 679 +=== 2.5.1 Ways to get datalog via LoRaWAN === 680 + 681 + 682 +Set PNACKMD=1, CPL03-LB will wait for ACK for every uplink, when there is no LoRaWAN network,CPL03-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. 683 + 432 432 * ((( 433 -a) DDS75-LB will do an ACK check for data records sending to make sure every data arrive server.685 +a) CPL03-LB will do an ACK check for data records sending to make sure every data arrive server. 434 434 ))) 435 435 * ((( 436 -b) DDS75-LB will send data in **CONFIRMED Mode** when PNACKMD=1, butDDS75-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 ifDDS75-LB gets a ACK,DDS75-LB will consider there is a network connection and resend all NONE-ACK messages.688 +b) CPL03-LB will send data in **CONFIRMED Mode** when PNACKMD=1, but CPL03-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 CPL03-LB gets a ACK, CPL03-LB will consider there is a network connection and resend all NONE-ACK messages. 437 437 ))) 438 438 439 439 Below is the typical case for the auto-update datalog feature (Set PNACKMD=1) ... ... @@ -441,10 +441,10 @@ 441 441 [[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"]] 442 442 443 443 444 -=== 2. 6.2 Unix TimeStamp ===696 +=== 2.5.2 Unix TimeStamp === 445 445 446 446 447 - DDS75-LB uses Unix TimeStamp format based on699 +CPL03-LB uses Unix TimeStamp format based on 448 448 449 449 [[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"]] 450 450 ... ... @@ -458,17 +458,17 @@ 458 458 So, we can use AT+TIMESTAMP=1611889405 or downlink 3060137afd00 to set the current time 2021 – Jan ~-~- 29 Friday 03:03:25 459 459 460 460 461 -=== 2. 6.3 Set Device Time ===713 +=== 2.5.3 Set Device Time === 462 462 463 463 464 464 User need to set (% style="color:blue" %)**SYNCMOD=1**(%%) to enable sync time via MAC command. 465 465 466 -Once DDS75-LB Joined LoRaWAN network, it will send the MAC command (DeviceTimeReq) and the server will reply with (DeviceTimeAns) to send the current time toDDS75-LB. IfDDS75-LB fails to get the time from the server,DDS75-LB will use the internal time and wait for next time request (AT+SYNCTDC to set the time request period, default is 10 days).718 +Once CPL03-LB Joined LoRaWAN network, it will send the MAC command (DeviceTimeReq) and the server will reply with (DeviceTimeAns) to send the current time to CPL03-LB. If CPL03-LB fails to get the time from the server, CPL03-LB will use the internal time and wait for next time request (AT+SYNCTDC to set the time request period, default is 10 days). 467 467 468 468 (% 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.** 469 469 470 470 471 -=== 2. 6.4 Poll sensor value ===723 +=== 2.5.4 Poll sensor value === 472 472 473 473 474 474 Users can poll sensor values based on timestamps. Below is the downlink command. ... ... @@ -491,7 +491,7 @@ 491 491 ))) 492 492 493 493 ((( 494 -Uplink Internal =5s,means DDS75-LB will send one packet every 5s. range 5~~255s.746 +Uplink Internal =5s,means CPL03-LB will send one packet every 5s. range 5~~255s. 495 495 ))) 496 496 497 497 ... ... @@ -498,24 +498,24 @@ 498 498 == 2.7 Frequency Plans == 499 499 500 500 501 -The DDS75-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.753 +The CPL03-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. 502 502 503 503 [[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20Frequency%20Band/>>http://wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20Frequency%20Band/]] 504 504 505 505 506 -= 3. Configure DDS75-LB =758 += 3. Configure CPL03-LB = 507 507 508 508 == 3.1 Configure Methods == 509 509 510 510 511 - DDS75-LB supports below configure method:763 +CPL03-LB supports below configure method: 512 512 513 513 * AT Command via Bluetooth Connection (**Recommended**): [[BLE Configure Instruction>>http://wiki.dragino.com/xwiki/bin/view/Main/BLE%20Bluetooth%20Remote%20Configure/]]. 514 - 515 515 * AT Command via UART Connection : See [[UART Connection>>http://wiki.dragino.com/xwiki/bin/view/Main/UART%20Access%20for%20LoRa%20ST%20v4%20base%20model/#H2.3UARTConnectionforSN50v3basemotherboard]]. 516 - 517 517 * LoRaWAN Downlink. Instruction for different platforms: See [[IoT LoRaWAN Server>>http://wiki.dragino.com/xwiki/bin/view/Main/]] section. 518 518 769 + 770 + 519 519 == 3.2 General Commands == 520 520 521 521 ... ... @@ -522,7 +522,6 @@ 522 522 These commands are to configure: 523 523 524 524 * General system settings like: uplink interval. 525 - 526 526 * LoRaWAN protocol & radio related command. 527 527 528 528 They are same for all Dragino Devices which support DLWS-005 LoRaWAN Stack. These commands can be found on the wiki: ... ... @@ -530,10 +530,10 @@ 530 530 [[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/]] 531 531 532 532 533 -== 3.3 Commands special design for DDS75-LB ==784 +== 3.3 Commands special design for CPL03-LB == 534 534 535 535 536 -These commands only valid for DDS75-LB, as below:787 +These commands only valid for CPL03-LB, as below: 537 537 538 538 539 539 === 3.3.1 Set Transmit Interval Time === ... ... @@ -575,12 +575,232 @@ 575 575 Example 1: Downlink Payload: 0100001E ~/~/ Set Transmit Interval (TDC) = 30 seconds 576 576 ))) 577 577 * ((( 578 -Example 2: Downlink Payload: 0100003C ~/~/ Set Transmit Interval (TDC) = 60 seconds 829 +Example 2: Downlink Payload: 0100003C ~/~/ Set Transmit Interval (TDC) = 60 seconds 830 + 831 + 832 + 579 579 ))) 580 580 581 -=== 3.3.2 Set InterruptMode===835 +=== 3.3.2 Quit AT Command === 582 582 583 583 838 +Feature: Quit AT Command mode, so user needs to input the password again before using AT Commands. 839 + 840 +(% style="color:blue" %)**AT Command: AT+DISAT** 841 + 842 +(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:452px" %) 843 +|=(% style="width: 155px;background-color:#D9E2F3;color:#0070C0" %)**Command Example**|=(% style="width: 198px;background-color:#D9E2F3;color:#0070C0" %)**Function**|=(% style="width: 99px;background-color:#D9E2F3;color:#0070C0" %)**Response** 844 +|(% style="width:155px" %)AT+DISAT|(% style="width:198px" %)Quit AT Commands mode|(% style="width:96px" %)OK 845 + 846 +(% style="color:blue" %)**Downlink Command:** 847 + 848 +No downlink command for this feature. 849 + 850 + 851 +=== 3.3.3 Get Device Status === 852 + 853 + 854 +Send a LoRaWAN downlink to ask device send Alarm settings. 855 + 856 +(% style="color:blue" %)**Downlink Payload: **(%%)0x26 01 857 + 858 +Sensor will upload Device Status via FPORT=5. See payload section for detail. 859 + 860 + 861 +=== 3.3.4 Enable / Disable Alarm === 862 + 863 + 864 +Feature: Enable/Disable Alarm for open/close event. Default value 0. 865 + 866 +(% style="color:blue" %)**AT Command:** 867 + 868 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:520px" %) 869 +|(% style="background-color:#d9e2f3; color:#0070c0; width:154px" %)**Command Example**|(% style="background-color:#d9e2f3; color:#0070c0; width:278px" %)**Function**|(% style="background-color:#d9e2f3; color:#0070c0; width:88px" %)**Response** 870 +|(% style="width:154px" %)AT+DISALARM=1|(% style="width:278px" %)End node will only send packets in TDC time.|OK 871 +|(% style="width:154px" %)AT+DISALARM=0|(% style="width:278px" %)End node will send packets in TDC time or status change for door sensor|OK 872 + 873 +(% style="color:blue" %)**Downlink Command:** 874 + 875 +**0xA7 01** ~/~/ Same As AT+DISALARM=1 876 + 877 +**0xA7 00 ** ~/~/ Same As AT+DISALARM=0 878 + 879 + 880 +=== 3.3.5 Alarm Base on Timeout === 881 + 882 + 883 +((( 884 +CPL03-LB can monitor the timeout for a status change, this feature can be used to monitor some events such as door opening too long etc. Related Parameters are: 885 +))) 886 + 887 + 888 +((( 889 +(% style="color:#4f81bd" %)**1. Keep Status: Status to be monitor** 890 +))) 891 + 892 +((( 893 +**Keep Status = 1**: Monitor Close to Open event 894 +))) 895 + 896 +((( 897 +**Keep Status = 0**: Monitor Open to Close event 898 +))) 899 + 900 + 901 +((( 902 +(% style="color:#4f81bd" %)**2. Keep Time: Timeout to send an Alarm** 903 +))) 904 + 905 +((( 906 +Range 0 ~~ 65535(0xFFFF) seconds. 907 +))) 908 + 909 +((( 910 +If** keep time = 0**, Disable Alarm Base on Timeout feature. 911 +))) 912 + 913 +((( 914 +If **keep time > 0**, device will monitor the keep status event and send an alarm when status doesn’t change after timeout. 915 +))) 916 + 917 + 918 +((( 919 +(% style="color:#4f81bd" %)**AT Command**(%%) to configure: 920 +))) 921 + 922 +((( 923 +(% style="color:blue" %)**AT+TTRIG=1,30**(%%) ~-~-> When the **Keep Status** change from connect to disconnect, and device remains in disconnect status for more than 30 seconds. CPL03-LB will send an uplink packet, the [[Alarm bit>>||anchor="H2.3.3Real-TimeOpen2FCloseStatus2CUplinkFPORT3D2"]] (the second bit of 1^^st^^ byte of payload) on this uplink packet is set to 1. 924 +))) 925 + 926 +((( 927 +(% style="color:blue" %)**AT+TTIG=0,0 **(%%) ~-~-> Default Value, disable timeout Alarm. 928 +))) 929 + 930 + 931 +((( 932 +(% style="color:#4f81bd" %)**Downlink Command**(%%) to configure: 933 +))) 934 + 935 +((( 936 +**Command: 0xA9 aa bb cc** 937 +))) 938 + 939 +((( 940 +**A9: **Command Type Code 941 +))) 942 + 943 +((( 944 +**aa: **status to be monitored 945 +))) 946 + 947 +((( 948 +**bb cc: **timeout. 949 +))) 950 + 951 + 952 +((( 953 +If user send 0xA9 01 00 1E: equal to AT+TTRIG=1,30 954 +))) 955 + 956 +((( 957 +Or 958 +))) 959 + 960 +((( 961 +0xA9 00 00 00: Equal to AT+TTRIG=0,0. Disable timeout Alarm. 962 +))) 963 + 964 + 965 +=== 3.3.6 Clear Flash Record === 966 + 967 + 968 +Feature: Clear flash storage for data log feature. 969 + 970 +(% style="color:blue" %)**AT Command: AT+CLRDTA** 971 + 972 +(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:500px" %) 973 +|=(% style="width: 157px;background-color:#D9E2F3;color:#0070C0" %)**Command Example**|=(% style="width: 169px;background-color:#D9E2F3;color:#0070C0" %)**Function**|=(% style="width: 174px;background-color:#D9E2F3;color:#0070C0" %)**Response** 974 +|(% style="width:157px" %)AT+CLRDTA|(% style="width:169px" %)Clear flash storage for data log feature.|Clear all stored sensor data… OK 975 + 976 +((( 977 +(% style="color:blue" %)**Downlink Command:** 978 +))) 979 + 980 +((( 981 +* **Example**: 0xA301 ~/~/ Same as AT+CLRDTA 982 +))) 983 + 984 + 985 + 986 +=== 3.3.7 Set trigger mode === 987 + 988 + 989 +Feature: Set the trigger interrupt mode. 990 + 991 +(% style="color:blue" %)**AT Command: AT+TTRMOD** 992 + 993 +(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:495px" %) 994 +|=(% style="width: 157px;background-color:#D9E2F3;color:#0070C0" %)**Command Example**|=(% style="width: 246px;background-color:#D9E2F3;color:#0070C0" %)**Function**|=(% style="width: 92px;background-color:#D9E2F3;color:#0070C0" %)**Response** 995 +|(% style="width:157px" %)((( 996 +AT+TTRMOD=1 997 +)))|(% style="width:156px" %)Count and trigger from open to close (rising edge)|(% style="width:89px" %)((( 998 +((( 999 +OK 1000 +))) 1001 +))) 1002 +|(% style="width:157px" %)((( 1003 +AT+TTRMOD=0 1004 +)))|(% style="width:156px" %)Count and trigger from close to open (falling edge)|(% style="width:89px" %)((( 1005 +OK 1006 +))) 1007 + 1008 +(% style="color:blue" %)**Downlink Command:** 1009 + 1010 +* **Example**: 0xA401 ~/~/ Same as AT+ TTRMOD =1 1011 + 1012 + 1013 + 1014 +=== 3.3.8 Set the calculate flag === 1015 + 1016 + 1017 +Feature: Set the calculate flag 1018 + 1019 +(% style="color:blue" %)**AT Command: AT+CALCFLAG** 1020 + 1021 +(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:461px" %) 1022 +|=(% style="width: 158px;background-color:#D9E2F3;color:#0070C0" %)**Command Example**|=(% style="width: 193px;background-color:#D9E2F3;color:#0070C0" %)**Function**|=(% style="width: 110px;background-color:#D9E2F3;color:#0070C0" %)**Response** 1023 +|(% style="width:158px" %)AT+CALCFLAG =1|(% style="width:192px" %)Set the calculate flag to 1.|(% style="width:109px" %)OK 1024 +|(% style="width:158px" %)AT+CALCFLAG =2|(% style="width:192px" %)Set the calculate flag to 2.|(% style="width:109px" %)OK 1025 + 1026 +(% style="color:blue" %)**Downlink Command:** 1027 + 1028 +* **Example**: 0XA501 ~/~/ Same as AT+CALCFLAG =1 1029 + 1030 + 1031 + 1032 +=== 3.3.9 Set count number === 1033 + 1034 + 1035 +Feature: Manually set the count number 1036 + 1037 +(% style="color:blue" %)**AT Command: AT+SETCNT** 1038 + 1039 +(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:479px" %) 1040 +|=(% style="width: 160px;background-color:#D9E2F3;color:#0070C0" %)**Command Example**|=(% style="width: 223px;background-color:#D9E2F3;color:#0070C0" %)**Function**|=(% style="width: 96px;background-color:#D9E2F3;color:#0070C0" %)**Response** 1041 +|(% style="width:160px" %)AT+ SETCNT =0|(% style="width:221px" %)Set the count number to 0.|(% style="width:95px" %)OK 1042 +|(% style="width:160px" %)AT+ SETCNT =100|(% style="width:221px" %)Set the count number to 100.|(% style="width:95px" %)OK 1043 + 1044 +(% style="color:blue" %)**Downlink Command:** 1045 + 1046 +* **Example**: 0xA6000001 ~/~/ Same as AT+ SETCNT =1 1047 + 1048 +* **Example**: 0xA6000064 ~/~/ Same as AT+ SETCNT =100 1049 + 1050 + 1051 + 1052 +=== 3.3.10 Set Interrupt Mode === 1053 + 1054 + 584 584 Feature, Set Interrupt mode for PA8 of pin. 585 585 586 586 When AT+INTMOD=0 is set, PA8 is used as a digital input port. ... ... @@ -612,101 +612,84 @@ 612 612 613 613 * Example 2: Downlink Payload: 06000003 ~/~/ Set the interrupt mode to rising edge trigger 614 614 615 -= 4. Battery & Power Consumption = 616 616 617 617 618 - DDS75-LBuse ER26500 + SPC1520battery pack.Seebelowlink for detail informationabouthebatteryinfoandhow to replace.1088 +=== 3.3.11 Set Power Output Duration === 619 619 620 -[[**Battery Info & Power Consumption Analyze**>>http://wiki.dragino.com/xwiki/bin/view/Main/How%20to%20calculate%20the%20battery%20life%20of%20Dragino%20sensors%3F/]] . 621 621 1091 +Control the output duration 5V . Before each sampling, device will 622 622 623 - = 5.OTA Firmware update=1093 +~1. first enable the power output to external sensor, 624 624 1095 +2. keep it on as per duration, read sensor value and construct uplink payload 625 625 626 -(% class="wikigeneratedid" %) 627 -User can change firmware DDS75-LB to: 1097 +3. final, close the power output. 628 628 629 - *ChangeFrequencyband/region.1099 +(% style="color:blue" %)**AT Command: AT+5VT** 630 630 631 -* Update with new features. 1101 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %) 1102 +|=(% 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** 1103 +|(% style="width:154px" %)AT+5VT=?|(% style="width:196px" %)Show 5V open time.|(% style="width:157px" %)0 (default) 1104 +OK 1105 +|(% style="width:154px" %)AT+5VT=500|(% style="width:196px" %)Close after a delay of 1000 milliseconds.|(% style="width:157px" %)OK 632 632 633 - *Fixbugs.1107 +(% style="color:blue" %)**Downlink Command: 0x07** 634 634 635 -F irmwareandchangelog can bedownloadedfrom: **[[Firmwaredownload link>>url:https://www.dropbox.com/sh/7la95mae0fn03xe/AACtzs-32m22TLb75B-iIr-Qa?dl=0]]**1109 +Format: Command Code (0x07) followed by 2 bytes. 636 636 637 - Methods toUpdateFirmware:1111 +The first and second bytes are the time to turn on. 638 638 639 -* (Recommanded way) OTA firmware update via wireless:[[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/Firmware%20OTA%20Update%20for%20Sensors/>>url:http://wiki.dragino.com/xwiki/bin/view/Main/Firmware%20OTA%20Update%20for%20Sensors/]]1113 +* Example 1: Downlink Payload: 070000 **~-~-->** AT+5VT=0 640 640 641 -* UpdatethroughUART TTL interface. **[[Instruction>>url:http://wiki.dragino.com/xwiki/bin/view/Main/UART%20Access%20for%20LoRa%20ST%20v4%20base%20model/#H1.LoRaSTv4baseHardware]]**.1115 +* Example 2: Downlink Payload: 0701F4 **~-~-->** AT+5VT=500 642 642 643 -= 6. FAQ = 644 644 645 645 646 -= =6.1WhatisthefrequencyplanforDDS75-LB?==1119 += 4. Battery & Power Consumption = 647 647 648 648 649 - DDS75-LB usethesamefrequencyas otherDraginoproducts.User can seethe detail fromhis link:[[Introduction>>doc:Main.EndDeviceFrequencyBand.WebHome||anchor="H1.Introduction"]]1122 +CPL03-LB use ER26500 + SPC1520 battery pack. See below link for detail information about the battery info and how to replace. 650 650 1124 +[[**Battery Info & Power Consumption Analyze**>>http://wiki.dragino.com/xwiki/bin/view/Main/How%20to%20calculate%20the%20battery%20life%20of%20Dragino%20sensors%3F/]] . 651 651 652 -== 6.2 Can I use DDS75-LB in condensation environment? == 653 653 1127 += 5. OTA Firmware update = 654 654 655 -DDS75-LB is not suitable to be used in condensation environment. Condensation on the DDS75-LB probe will affect the reading and always got 0. 656 656 1130 +(% class="wikigeneratedid" %) 1131 +User can change firmware CPL03-LB to: 657 657 658 - =7.TroubleShooting=1133 +* Change Frequency band/ region. 659 659 660 - ==7.1 Why I can'tjoinTTN V3 inUS915 / AU915 bands? ==1135 +* Update with new features. 661 661 1137 +* Fix bugs. 662 662 663 - Itisduetochannelmapping.Pleasesee belowlink:quencyband>>doc:Main.LoRaWANCommunicationDebug.WebHome||anchor="H2.NoticeofUS9152FCN4702FAU915Frequencyband"]]1139 +Firmware and changelog can be downloaded from : **[[Firmware download link>>url:https://www.dropbox.com/sh/kwqv57tp6pejias/AAAopYMATh1GM6fZ-VRCLrpDa?dl=0]]** 664 664 1141 +Methods to Update Firmware: 665 665 666 - ==7.2 AT Command input doesn'twork==1143 +* (Recommanded way) OTA firmware update via wireless: [[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/Firmware%20OTA%20Update%20for%20Sensors/>>url:http://wiki.dragino.com/xwiki/bin/view/Main/Firmware%20OTA%20Update%20for%20Sensors/]] 667 667 1145 +* Update through UART TTL interface. **[[Instruction>>url:http://wiki.dragino.com/xwiki/bin/view/Main/UART%20Access%20for%20LoRa%20ST%20v4%20base%20model/#H1.LoRaSTv4baseHardware]]**. 668 668 669 -In the case if user can see the console output but can't type input to the device. Please check if you already include the (% style="color:blue" %)**ENTER**(%%) while sending out the command. Some serial tool doesn't send (% style="color:blue" %)**ENTER**(%%) while press the send key, user need to add ENTER in their string. 670 670 671 671 672 -= =7.3Whydoes the sensor reading show 0 or "No sensor"==1149 += 6. FAQ = 673 673 1151 +== 6.1 AT Commands input doesn't work == 674 674 675 -~1. The measurement object is very close to the sensor, but in the blind spot of the sensor. 676 676 677 - 2.Sensor wiring is disconnected1154 +In the case if user can see the console output but can't type input to the device. Please check if you already include the (% style="color:green" %)**ENTER**(%%) while sending out the command. Some serial tool doesn't send (% style="color:green" %)**ENTER**(%%) while press the send key, user need to add ENTER in their string. 678 678 679 -3. Not using the correct decoder 680 680 1157 += 7. Order Info = 681 681 682 -== 5.4 Abnormal readings The gap between multiple readings is too large or the gap between the readings and the actual value is too large == 683 683 1160 +Part Number: (% style="color:blue" %)**CPL03-LB-XXX** 684 684 685 - 1)Please check ifthereissomething on theprobeaffectingits measurement (condensedwater, volatile oil, etc.)1162 +(% style="color:red" %)**XXX**(%%): The default frequency band 686 686 687 -2) Does it change with temperature, temperature will affect its measurement 688 - 689 -3) If abnormal data occurs, you can turn on DEBUG mode, Please use downlink or AT COMMAN to enter DEBUG mode. 690 - 691 -downlink command: (% style="color:blue" %)**F1 01**(%%), AT command: (% style="color:blue" %)**AT+DDEBUG=1** 692 - 693 -4) After entering the debug mode, it will send 20 pieces of data at a time, and you can send its uplink to us for analysis 694 - 695 -[[image:image-20230113135125-2.png||height="136" width="1057"]] 696 - 697 - 698 -Its original payload will be longer than other data. Even though it is being parsed, it can be seen that it is abnormal data. 699 - 700 -Please send the data to us for check. 701 - 702 - 703 -= 8. Order Info = 704 - 705 - 706 -Part Number: (% style="color:blue" %)**DDS75-LB-XXX** 707 - 708 -(% style="color:red" %)**XXX**(%%): **The default frequency band** 709 - 710 710 * (% style="color:red" %)**AS923**(%%): LoRaWAN AS923 band 711 711 712 712 * (% style="color:red" %)**AU915**(%%): LoRaWAN AU915 band ... ... @@ -725,12 +725,12 @@ 725 725 726 726 727 727 728 -= 9. Packing Info =1182 += 8. Packing Info = 729 729 730 730 731 731 (% style="color:#037691" %)**Package Includes**: 732 732 733 -* DDS75-LB LoRaWANDistance DetectionSensorx 11187 +* CPL03-LB LoRaWAN Pulse/Contact Sensor 734 734 735 735 (% style="color:#037691" %)**Dimension and weight**: 736 736 ... ... @@ -744,7 +744,7 @@ 744 744 745 745 746 746 747 -= 10. Support =1201 += 9. Support = 748 748 749 749 750 750 * Support is provided Monday to Friday, from 09:00 to 18:00 GMT+8. Due to different timezones we cannot offer live support. However, your questions will be answered as soon as possible in the before-mentioned schedule.
- image-20230530135919-1.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -87.6 KB - Content
- image-20230530135929-2.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -87.6 KB - Content
- image-20230530140053-1.jpeg
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -1.3 MB - Content
- image-20230612170349-1.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -164.2 KB - Content
- image-20230612170943-2.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -86.4 KB - Content
- image-20230612171032-3.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -86.4 KB - Content