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, 5 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 SW3L-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 - SW3L-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 - SW3L-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 SW3L-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 181 -== == 146 +== 1.9 Mechanical == 182 182 183 -== 2.10 Mechanical == 184 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,128 +264,402 @@ 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 ((( 306 +Uplink interval for the total pulse count, default value is 0x001C20 which is 7200 seconds = 2 hours. 307 + 308 + 309 +))) 310 + 311 +* ((( 312 +(% style="color:#037691" %)** Disalarm: (default: 0)** 313 +))) 314 + 271 271 ((( 272 -D DS75-LB will uplinkpayloadviaLoRaWANwithbelowpayload format: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. 273 273 ))) 274 274 275 275 ((( 276 -Uplink payload includes in total 4 bytes. 277 -Payload for firmware version v1.1.4. . Before v1.1.3, there is on two fields: BAT and Distance 320 +(% style="color:blue" %)** If Disalarm = 0**(%%), CPL03-LB will send uplink at every TDC periodically. 321 + 322 + 278 278 ))) 324 + 325 +* ((( 326 +(% style="color:#037691" %)** Keep Status & Keep Time** 279 279 ))) 280 280 281 281 ((( 330 +Shows the configure value of [[Alarm Base on Timeout Feature>>||anchor="H3.3.5AlarmBaseonTimeout"]] 331 + 282 282 283 283 ))) 284 284 285 -(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:510px" %) 286 -|=(% style="width: 62.5px;background-color:#D9E2F3;color:#0070C0" %)((( 287 -**Size(bytes)** 288 -)))|=(% 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** 289 -|(% style="width:62.5px" %)**Value**|(% style="width:62.5px" %)[[BAT>>||anchor="H2.3.1A0BatteryInfo"]]|((( 290 -[[Distance>>||anchor="H2.3.2A0Distance"]] 291 -(unit: mm) 292 -)))|[[Digital Interrupt (Optional)>>||anchor="H2.3.3A0InterruptPin"]]|((( 293 -[[Temperature (Optional )>>||anchor="H2.3.4A0DS18B20Temperaturesensor"]] 294 -)))|[[Sensor Flag>>||anchor="H2.3.5A0SensorFlag"]] 335 +* ((( 336 +(% style="color:#037691" %)** Trigger mode (default: 0)** 337 +))) 295 295 296 -[[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"]] 339 +((( 340 +(% style="color:blue" %)** If Trigger mode = 0**(%%), count close to open event. 341 +))) 297 297 343 +((( 344 +(% style="color:blue" %)** If Trigger mode = 1**(%%), count open to close event. 345 +))) 298 298 299 - === 2.3.1Battery Info347 +[[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"]] 300 300 301 301 302 - Checkthebattery voltageforDDS75-LB.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"]] 303 303 304 -Ex1: 0x0B45 = 2885mV 305 305 306 - Ex2:0x0B49=2889mV353 +=== 2.3.3 Real-Time Open/Close Status, Uplink FPORT~=2 === 307 307 308 308 309 -=== 2.3.2 Distance === 356 +((( 357 +((( 358 +CPL03-LB will send this uplink **after** Device Status once join the LoRaWAN network successfully. And CPL03-LB will: 359 +))) 360 +))) 310 310 362 +((( 363 +((( 364 +periodically send this uplink every 2 hours, this interval [[can be changed>>||anchor="H3.3.1SetTransmitIntervalTime"]]. 365 +))) 366 +))) 311 311 312 312 ((( 313 -Get the distance. Flat object range 280mm - 7500mm. 369 +((( 370 +Uplink Payload totals 11 bytes. 314 314 ))) 372 +))) 315 315 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"]] 378 + 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 383 + 384 +* ((( 385 +(% style="color:#037691" %)** Calculate Flag** 386 +))) 387 + 316 316 ((( 317 -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" %)** ** 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 +))) 318 318 319 -(% style="color:#4472c4" %)**0B05(H) = 2821 (D) = 2821 mm.** 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. 320 320 ))) 321 321 396 +((( 397 +Default value: 0. 398 +))) 322 322 323 -* If the sensor value is 0x0000, it means system doesn't detect ultrasonic sensor. 324 -* 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. 400 +((( 401 +Range (6 bits): (b)000000 ~~ (b) 111111 402 +))) 325 325 326 -=== 2.3.3 Interrupt Pin === 404 +((( 405 +Refer: [[Set Calculate Flag>>||anchor="H3.3.8Setthecalculateflag"]] 327 327 407 + 408 +))) 328 328 329 -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. 410 +* ((( 411 +(% style="color:#037691" %)** Alarm** 412 +))) 330 330 331 -**Example:** 414 +((( 415 +See [[Alarm Base on Timeout>>||anchor="H3.3.5AlarmBaseonTimeout"]] 332 332 333 -0x00: Normal uplink packet. 417 + 418 +))) 334 334 335 -0x01: Interrupt Uplink Packet. 420 +* ((( 421 +(% style="color:#037691" %)** Contact Status** 422 +))) 336 336 424 +((( 425 +0: Open 426 +))) 337 337 338 -=== 2.3.4 DS18B20 Temperature sensor === 428 +((( 429 +1: Close 339 339 431 + 432 +))) 340 340 341 -This is optional, user can connect external DS18B20 sensor to the +3.3v, 1-wire and GND pin . and this field will report temperature. 434 +* ((( 435 +(% style="color:#037691" %)** Total pulse** 436 +))) 342 342 343 -**Example**: 438 +((( 439 +Total pulse/counting base on dry [[contact trigger event>>||anchor="H2.3.2SensorConfiguration2CFPORT3D4"]] 440 +))) 344 344 345 -If payload is: 0105H: (0105 & FC00 == 0), temp = 0105H /10 = 26.1 degree 442 +((( 443 +Range (3 Bytes) : 0x000000 ~~ 0xFFFFFF . Max: 16777215 346 346 347 -If payload is: FF3FH : (FF3F & FC00 == 1) , temp = (FF3FH - 65536)/10 = -19.3 degrees. 445 + 446 +))) 348 348 349 -(% style="color:red" %)**Note: DS18B20 feature is supported in the hardware version > v1.3 which made since early of 2021.** 448 +* ((( 449 +(% style="color:#037691" %)** The last open duration** 450 +))) 350 350 452 +((( 453 +Dry Contact last open duration. 454 +))) 351 351 352 -=== 2.3.5 Sensor Flag === 456 +((( 457 +Unit: min. 458 +))) 353 353 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"]] 354 354 462 + 463 +=== 2.3.4 Real-Time Open/Close Status, 3 pulse mode, Uplink FPORT~=6 === 464 + 465 + 466 +(% style="color:red" %)**Note:** 467 + 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. 471 + 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 + 355 355 ((( 356 -0 x01:DetectUltrasonicSensor554 +CPL03-LB stores sensor values and users can retrieve these history values via the [[downlink command>>||anchor="H2.5DatalogFeature"]]. 357 357 ))) 358 358 359 359 ((( 360 - 0x00:NoUltrasonicSensor558 +The historical payload includes one or multiplies entries and every entry has the same payload as Real-Time open/close status. 361 361 ))) 362 362 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 +))) 363 363 364 -=== 2.3.6 Decode payload in The Things Network === 565 +((( 566 +For example, in the US915 band, the max payload for different DR is: 567 +))) 365 365 569 +((( 570 +a) (% style="color:blue" %)**DR0**(%%): max is 11 bytes so one entry of data 571 +))) 366 366 367 -While using TTN network, you can add the payload format to decode the payload. 573 +((( 574 +b) (% style="color:blue" %)**DR1**(%%): max is 53 bytes so devices will upload 4 entries of data (total 44 bytes) 575 +))) 368 368 369 -[[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"]] 577 +((( 578 +c) (% style="color:blue" %)**DR2**(%%): total payload includes 11 entries of data 579 +))) 370 370 371 -The payload decoder function for TTN V3 is here: 581 +((( 582 +d) (% style="color:blue" %)**DR3**(%%): total payload includes 22 entries of data. 583 +))) 372 372 373 373 ((( 374 -DDS75-LB TTN V3 Payload Decoder: [[ttps:~~/~~/github.com/dragino/dragino-end-node-decoder>>https://github.com/dragino/dragino-end-node-decoder]] 586 +If CPL03-LB doesn't have any data in the polling time. It will uplink 11 bytes of 0 587 + 588 + 375 375 ))) 376 376 591 +(% style="color:blue" %)** Downlink:** 377 377 378 -== 2.4 Uplink Interval == 593 +(% class="box" %) 594 +((( 595 +**0x31 61 E9 3A D4 61 E9 3D E0 05** 596 +))) 379 379 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"]] 380 380 381 -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"]] 382 382 601 +(% style="color:blue" %)** Uplink:** 383 383 384 -== 2.5 Show Data in DataCake IoT Server == 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 +))) 385 385 608 +(% style="color:#037691" %)** ** 386 386 610 +(% style="color:#037691" %)**Parsed Value:** 611 + 387 387 ((( 388 -[ [DATACAKE>>url:https://datacake.co/]] provides a human friendly interface to show the sensor data,once we have data inTTN,we can use [[DATACAKE>>url:https://datacake.co/]]to connect toTTNand see the data inDATACAKE.Below are the steps:613 +[ALARM, PIN_STATUS, TOTAL_PULSE, CALCULATE_FLAG, LAST_OPEN_DURATION, TIME] 389 389 ))) 390 390 391 391 ((( ... ... @@ -393,49 +393,74 @@ 393 393 ))) 394 394 395 395 ((( 396 - (%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], 397 397 ))) 398 398 399 399 ((( 400 - (% 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], 401 401 ))) 402 402 628 +((( 629 +[FALSE, OPEN, 0, 3, 0, 2022-01-20 10:39:04], 630 +))) 403 403 404 -[[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 +))) 405 405 636 +((( 637 +[TRUE, CLOSE, 6, 3, 0, 2022-01-20 10:39:23], 638 +))) 406 406 407 -[[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 +))) 408 408 644 +((( 645 +[FALSE, OPEN, 0, 0, 0, 2022-01-20 10:42:41], 646 +))) 409 409 410 -(% 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 +))) 411 411 412 -(% 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 +))) 413 413 414 -[[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], 415 415 659 + 660 +))) 416 416 417 - 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"]] 418 418 419 -[[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"]] 420 420 665 +== 2.4 Payload Decoder file == 421 421 422 422 423 - ==2.6Datalog Feature==668 +In TTN, use can add a custom payload so it shows friendly reading 424 424 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]] 425 425 426 -Datalog Feature is to ensure IoT Server can get all sampling data from Sensor even if the LoRaWAN network is down. For each sampling, SW3L-LB will store the reading for future retrieving purposes. 427 427 673 +== 2.5 Datalog Feature == 428 428 429 -=== 2.6.1 Ways to get datalog via LoRaWAN === 430 430 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. 431 431 432 -Set PNACKMD=1, SW3L-LB will wait for ACK for every uplink, when there is no LoRaWAN network,SW3L-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. 433 433 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 + 434 434 * ((( 435 -a) SW3L-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. 436 436 ))) 437 437 * ((( 438 -b) SW3L-LB will send data in **CONFIRMED Mode** when PNACKMD=1, butSW3L-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 ifSW3L-LB gets a ACK,SW3L-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. 439 439 ))) 440 440 441 441 Below is the typical case for the auto-update datalog feature (Set PNACKMD=1) ... ... @@ -443,10 +443,10 @@ 443 443 [[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"]] 444 444 445 445 446 -=== 2. 6.2 Unix TimeStamp ===696 +=== 2.5.2 Unix TimeStamp === 447 447 448 448 449 - SW3L-LB uses Unix TimeStamp format based on699 +CPL03-LB uses Unix TimeStamp format based on 450 450 451 451 [[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"]] 452 452 ... ... @@ -460,17 +460,17 @@ 460 460 So, we can use AT+TIMESTAMP=1611889405 or downlink 3060137afd00 to set the current time 2021 – Jan ~-~- 29 Friday 03:03:25 461 461 462 462 463 -=== 2. 6.3 Set Device Time ===713 +=== 2.5.3 Set Device Time === 464 464 465 465 466 466 User need to set (% style="color:blue" %)**SYNCMOD=1**(%%) to enable sync time via MAC command. 467 467 468 -Once SW3L-LB Joined LoRaWAN network, it will send the MAC command (DeviceTimeReq) and the server will reply with (DeviceTimeAns) to send the current time toSW3L-LB. IfSW3L-LB fails to get the time from the server,SW3L-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). 469 469 470 470 (% 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.** 471 471 472 472 473 -=== 2. 6.4 Poll sensor value ===723 +=== 2.5.4 Poll sensor value === 474 474 475 475 476 476 Users can poll sensor values based on timestamps. Below is the downlink command. ... ... @@ -493,7 +493,7 @@ 493 493 ))) 494 494 495 495 ((( 496 -Uplink Internal =5s,means SW3L-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. 497 497 ))) 498 498 499 499 ... ... @@ -500,24 +500,24 @@ 500 500 == 2.7 Frequency Plans == 501 501 502 502 503 -The SW3L-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. 504 504 505 505 [[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20Frequency%20Band/>>http://wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20Frequency%20Band/]] 506 506 507 507 508 -= 3. Configure SW3L-LB =758 += 3. Configure CPL03-LB = 509 509 510 510 == 3.1 Configure Methods == 511 511 512 512 513 - SW3L-LB supports below configure method:763 +CPL03-LB supports below configure method: 514 514 515 515 * AT Command via Bluetooth Connection (**Recommended**): [[BLE Configure Instruction>>http://wiki.dragino.com/xwiki/bin/view/Main/BLE%20Bluetooth%20Remote%20Configure/]]. 516 - 517 517 * 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]]. 518 - 519 519 * LoRaWAN Downlink. Instruction for different platforms: See [[IoT LoRaWAN Server>>http://wiki.dragino.com/xwiki/bin/view/Main/]] section. 520 520 769 + 770 + 521 521 == 3.2 General Commands == 522 522 523 523 ... ... @@ -524,7 +524,6 @@ 524 524 These commands are to configure: 525 525 526 526 * General system settings like: uplink interval. 527 - 528 528 * LoRaWAN protocol & radio related command. 529 529 530 530 They are same for all Dragino Devices which support DLWS-005 LoRaWAN Stack. These commands can be found on the wiki: ... ... @@ -532,10 +532,10 @@ 532 532 [[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/]] 533 533 534 534 535 -== 3.3 Commands special design for SW3L-LB ==784 +== 3.3 Commands special design for CPL03-LB == 536 536 537 537 538 -These commands only valid for SW3L-LB, as below:787 +These commands only valid for CPL03-LB, as below: 539 539 540 540 541 541 === 3.3.1 Set Transmit Interval Time === ... ... @@ -577,7 +577,10 @@ 577 577 Example 1: Downlink Payload: 0100001E ~/~/ Set Transmit Interval (TDC) = 30 seconds 578 578 ))) 579 579 * ((( 580 -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 + 581 581 ))) 582 582 583 583 === 3.3.2 Quit AT Command === ... ... @@ -606,85 +606,113 @@ 606 606 Sensor will upload Device Status via FPORT=5. See payload section for detail. 607 607 608 608 609 -=== 3.3.4 Alarmforcontinuouslywaterflow===861 +=== 3.3.4 Enable / Disable Alarm === 610 610 611 611 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 + 612 612 ((( 613 - This featureis to monitorandsendAlarmforcontinuouslywaterflow.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: 614 614 ))) 615 615 887 + 616 616 ((( 617 - Examplecaseis for Toilet water monitoring, ifsome one push toiletbutton,the toilet will have water flow.If thetoiletbutton has broken and can'treturned to originalstate,the water flow will keep for hours ordays which causehuge waste forwater.889 +(% style="color:#4f81bd" %)**1. Keep Status: Status to be monitor** 618 618 ))) 619 619 620 620 ((( 621 - Tomonitorthisfaultyandsend alarm,thereare twosettings:893 +**Keep Status = 1**: Monitor Close to Open event 622 622 ))) 623 623 624 - *(((625 - (%style="color:#4f81bd"%)**StopDuration:Unit:Second**896 +((( 897 +**Keep Status = 0**: Monitor Open to Close event 626 626 ))) 627 627 900 + 628 628 ((( 629 - Default:15s, If SW3L-LB didn'tsee anywater flow in15s,SW3L-LBwillconsiderstopofwaterflow event.902 +(% style="color:#4f81bd" %)**2. Keep Time: Timeout to send an Alarm** 630 630 ))) 631 631 632 - *(((633 - (% style="color:#4f81bd" %)**Alarm Timer: Units: Minute;Default0minutes(means Alarmdisable)**905 +((( 906 +Range 0 ~~ 65535(0xFFFF) seconds. 634 634 ))) 635 635 636 636 ((( 637 -** Example:** 3 minutes,if SW3L-LB detectastart of water floweventand didn't detect a stop event withinAlarmtimer, SW3L-LBwillsendanAlarmtoindicateawaterflow abnormal alarm.910 +If** keep time = 0**, Disable Alarm Base on Timeout feature. 638 638 ))) 639 639 640 640 ((( 641 - So for example,Ifweset stopduration=15s and AlarmTimer=3minutes.Ifthetoiletwater flowcontinuously formorethan3minutes,Sensorwillsend an alarm(inConfirmed MODE)toplatform.914 +If **keep time > 0**, device will monitor the keep status event and send an alarm when status doesn’t change after timeout. 642 642 ))) 643 643 917 + 644 644 ((( 645 -(% style="color: red" %)**Note:** **Afterthis alarmis send, sensor will consider a stopof water flow andcountfor another new event. Soif water flow waste last for 1 hour, Sensor will keep sending alarm every 3 minutes.**919 +(% style="color:#4f81bd" %)**AT Command**(%%) to configure: 646 646 ))) 647 647 648 648 ((( 649 -(% style="color: #4f81bd" %)**ATCommand**(%%) to configure: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. 650 650 ))) 651 651 652 - *(((653 -AT+ PTRIG=15,3~-~->SetStopduration:15s,AlarmTimer: 3 minutes.926 +((( 927 +(% style="color:blue" %)**AT+TTIG=0,0 **(%%) ~-~-> Default Value, disable timeout Alarm. 654 654 ))) 655 655 656 -* ((( 657 -AT+ PTRIG=15,0 ~-~-> Default Value, disable water waste Alarm. 930 + 931 +((( 932 +(% style="color:#4f81bd" %)**Downlink Command**(%%) to configure: 658 658 ))) 659 659 660 660 ((( 661 - (% style="color:#4f81bd" %)**DownlinkCommand**(%%) to configure:936 +**Command: 0xA9 aa bb cc** 662 662 ))) 663 663 664 664 ((( 665 -Command :**0xAAaa bb cc**940 +**A9: **Command Type Code 666 666 ))) 667 667 668 668 ((( 669 - AA:CommandTypeCode944 +**aa: **status to be monitored 670 670 ))) 671 671 672 672 ((( 673 - aa:Stop duration948 +**bb cc: **timeout. 674 674 ))) 675 675 951 + 676 676 ((( 677 - bbcc:AlarmTimer953 +If user send 0xA9 01 00 1E: equal to AT+TTRIG=1,30 678 678 ))) 679 679 680 680 ((( 681 - If usersend 0xAA 0F 00 03: equal to AT+PTRIG=15,3957 +Or 682 682 ))) 683 683 960 +((( 961 +0xA9 00 00 00: Equal to AT+TTRIG=0,0. Disable timeout Alarm. 962 +))) 684 684 685 -=== 3.3.5 Clear Flash Record === 686 686 965 +=== 3.3.6 Clear Flash Record === 687 687 967 + 688 688 Feature: Clear flash storage for data log feature. 689 689 690 690 (% style="color:blue" %)**AT Command: AT+CLRDTA** ... ... @@ -703,9 +703,37 @@ 703 703 704 704 705 705 706 -=== 3.3. 6Set thecalculateflag===986 +=== 3.3.7 Set trigger mode === 707 707 708 708 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 + 709 709 Feature: Set the calculate flag 710 710 711 711 (% style="color:blue" %)**AT Command: AT+CALCFLAG** ... ... @@ -719,9 +719,11 @@ 719 719 720 720 * **Example**: 0XA501 ~/~/ Same as AT+CALCFLAG =1 721 721 722 -=== 3.3.7 Set count number === 723 723 724 724 1032 +=== 3.3.9 Set count number === 1033 + 1034 + 725 725 Feature: Manually set the count number 726 726 727 727 (% style="color:blue" %)**AT Command: AT+SETCNT** ... ... @@ -737,9 +737,11 @@ 737 737 738 738 * **Example**: 0xA6000064 ~/~/ Same as AT+ SETCNT =100 739 739 740 -=== 3.3.8 Set Interrupt Mode === 741 741 742 742 1052 +=== 3.3.10 Set Interrupt Mode === 1053 + 1054 + 743 743 Feature, Set Interrupt mode for PA8 of pin. 744 744 745 745 When AT+INTMOD=0 is set, PA8 is used as a digital input port. ... ... @@ -771,29 +771,43 @@ 771 771 772 772 * Example 2: Downlink Payload: 06000003 ~/~/ Set the interrupt mode to rising edge trigger 773 773 774 -=== 3.3.9 Set work mode === 775 775 776 776 777 - Feature:Manually sethework mode1088 +=== 3.3.11 Set Power Output Duration === 778 778 779 779 780 - (% style="color:blue"%)**ATCommand:AT+MOD**1091 +Control the output duration 5V . Before each sampling, device will 781 781 782 -(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:463px" %) 783 -|=(% style="width: 162px;background-color:#D9E2F3;color:#0070C0" %)**Command Example**|=(% style="width: 193px;background-color:#D9E2F3;color:#0070C0" %)**Function**|=(% style="width: 108px;background-color:#D9E2F3;color:#0070C0" %)**Response** 784 -|(% style="width:162px" %)AT+MOD=0|(% style="width:191px" %)Set the work mode to 0.|(% style="width:106px" %)OK 785 -|(% style="width:162px" %)AT+MOD=1|(% style="width:191px" %)Set the work mode to 1|(% style="width:106px" %)OK 1093 +~1. first enable the power output to external sensor, 786 786 787 - (%style="color:blue"%)**DownlinkCommand:**1095 +2. keep it on as per duration, read sensor value and construct uplink payload 788 788 789 - ***Example:**0x0A00~/~/ Sameas AT+MOD=01097 +3. final, close the power output. 790 790 791 - ***Example:**0x0A01~/~/ SameasAT+MOD=11099 +(% style="color:blue" %)**AT Command: AT+5VT** 792 792 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 1106 + 1107 +(% style="color:blue" %)**Downlink Command: 0x07** 1108 + 1109 +Format: Command Code (0x07) followed by 2 bytes. 1110 + 1111 +The first and second bytes are the time to turn on. 1112 + 1113 +* Example 1: Downlink Payload: 070000 **~-~-->** AT+5VT=0 1114 + 1115 +* Example 2: Downlink Payload: 0701F4 **~-~-->** AT+5VT=500 1116 + 1117 + 1118 + 793 793 = 4. Battery & Power Consumption = 794 794 795 795 796 - SW3L-LB use ER26500 + SPC1520 battery pack. See below link for detail information about the battery info and how to replace.1122 +CPL03-LB use ER26500 + SPC1520 battery pack. See below link for detail information about the battery info and how to replace. 797 797 798 798 [[**Battery Info & Power Consumption Analyze**>>http://wiki.dragino.com/xwiki/bin/view/Main/How%20to%20calculate%20the%20battery%20life%20of%20Dragino%20sensors%3F/]] . 799 799 ... ... @@ -802,7 +802,7 @@ 802 802 803 803 804 804 (% class="wikigeneratedid" %) 805 -User can change firmware SW3L-LB to:1131 +User can change firmware CPL03-LB to: 806 806 807 807 * Change Frequency band/ region. 808 808 ... ... @@ -818,6 +818,8 @@ 818 818 819 819 * 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]]**. 820 820 1147 + 1148 + 821 821 = 6. FAQ = 822 822 823 823 == 6.1 AT Commands input doesn't work == ... ... @@ -829,7 +829,7 @@ 829 829 = 7. Order Info = 830 830 831 831 832 -Part Number: (% style="color:blue" %)** SW3L-LB-XXX-YYY**1160 +Part Number: (% style="color:blue" %)**CPL03-LB-XXX** 833 833 834 834 (% style="color:red" %)**XXX**(%%): The default frequency band 835 835 ... ... @@ -849,43 +849,14 @@ 849 849 850 850 * (% style="color:red" %)**CN470**(%%): LoRaWAN CN470 band 851 851 852 -((( 853 -(% style="color:blue" %)**YYY**(%%): Flow Sensor Model: 854 -))) 855 855 856 -((( 857 - **004:** DW-004 Flow Sensor: diameter: G1/2” / DN15. 450 pulse = 1 L 858 -))) 859 859 860 -((( 861 - **006:** DW-006 Flow Sensor: diameter: G3/4” / DN20. 390 pulse = 1 L 862 -))) 863 - 864 -((( 865 - **010:** DW-010 Flow Sensor: diameter: G 1” / DN25. 64 pulse = 1 L 866 -))) 867 - 868 -* ((( 869 -calculate flag=0: for SW3L-004 Flow Sensor: 450 pulse = 1 L 870 -))) 871 - 872 -* ((( 873 -calculate flag=1: for SW3L-006 Flow Sensor: 390 pulse = 1 L 874 -))) 875 - 876 -* ((( 877 -calculate flag=2: for SW3L-010 Flow Sensor: 64 pulse = 1 L 878 - 879 - 880 - 881 -))) 882 - 883 883 = 8. Packing Info = 884 884 885 885 886 886 (% style="color:#037691" %)**Package Includes**: 887 887 888 -* SW3L-LB LoRaWANFlowSensor1187 +* CPL03-LB LoRaWAN Pulse/Contact Sensor 889 889 890 890 (% style="color:#037691" %)**Dimension and weight**: 891 891 ... ... @@ -897,6 +897,8 @@ 897 897 898 898 * Weight / pcs : g 899 899 1199 + 1200 + 900 900 = 9. Support = 901 901 902 902
- 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