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, 8 removed)
Details
- Page properties
-
- Title
-
... ... @@ -1,1 +1,1 @@ 1 - DDS75-LB -- LoRaWANDistance DetectionSensor User Manual1 +CPL03-LB -- LoRaWAN Pulse/Contact 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,24 @@ 15 15 16 16 = 1. Introduction = 17 17 18 -== 1.1 What is SW3L-LB LoRaWANFlowSensor ==16 +== 1.1 What is CPL03-LB LoRaWAN Pulse/Contact Sensor == 19 19 20 20 21 -The Dragino SW3L-LB is a (% style="color:blue" %)**LoRaWANFlowSensor**(%%). It detectswaterflowvolumeand uplinkto IoT server via LoRaWANnetwork. User can usethisto(%style="color:blue"%)** monitor the water usage for buildings.**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 -The SW3L-LB will sendwaterflowvolumeevery20minutes. Itcan also(%style="color:blue" %)**detectthewaterflowstatus**(%%)and(%style="color:blue"%)**sendAlarm**(%%),to avoid thewasteforwaterusagesuchas brokentoiletcase.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 - SW3L-LBisdesigned for bothindoorandoutdooruse.Ithasaweatherproofenclosure and industriallevel batteryto workin lowto high temperatures.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 - TheLoRawirelesstechnologyused inSW3L-LBallowsdevicetosenddata andreach extremelylongrangeslow data-rates.It providesultra-longrangespreadspectrumcommunication andhighinterferenceimmunitywhilstminimizingcurrentconsumption.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(%style="color:blue"%)**supportsBLEconfigure**(%%)and(%style="color:blue"%)**wirelessOTAupdate**(%%)which makeusereasytouse.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 - SW3L-LBis poweredby(% style="color:blue" %)**8500mAh Li-SOCI2battery**(%%),itis designed forlong term useupto5 years.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 - Each SW3L-LB is pre-loadwithasetfuniquekeys for LoRaWANregistrations, register thesekeysto localLoRaWANserveranditwill autoconnectafterpower on.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 35 - [[image:image-20230612170943-2.png||height="525"width="912"]]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. 36 36 37 37 38 38 == 1.2 Features == ... ... @@ -41,9 +41,10 @@ 41 41 * LoRaWAN 1.0.3 Class A 42 42 * Bands: CN470/EU433/KR920/US915/EU868/AS923/AU915/IN865 43 43 * Ultra-low power consumption 44 -* Upload water flow volume 45 -* Monitor water waste 46 -* AT Commands to change parameters 42 +* Open/Close detect 43 +* Open/Close statistics 44 +* Temperature & Humidity alarm 45 +* supports open alarm feature 47 47 * supports Datalog feature 48 48 * Support Bluetooth v5.1 and LoRaWAN remote configure 49 49 * Support wireless OTA update firmware ... ... @@ -51,7 +51,6 @@ 51 51 * Downlink to change configure 52 52 * 8500mAh Battery for long term use 53 53 54 - 55 55 == 1.3 Specification == 56 56 57 57 ... ... @@ -80,16 +80,13 @@ 80 80 * Sleep Mode: 5uA @ 3.3v 81 81 * LoRa Transmit Mode: 125mA @ 20dBm, 82mA @ 14dBm 82 82 83 - 84 84 == 1.4 Applications == 85 85 86 86 87 -* Flow Sensor application 88 -* Water Control 89 -* Toilet Flow Sensor 90 -* Monitor Waste water 84 +* Open/Close Detection 85 +* Pulse meter application 86 +* Dry Contact Detection 91 91 92 - 93 93 == 1.5 Sleep mode and working mode == 94 94 95 95 ... ... @@ -98,7 +98,7 @@ 98 98 (% 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. 99 99 100 100 101 -== 1. 6Button & LEDs ==96 +== 1.5 Button & LEDs == 102 102 103 103 104 104 [[image:Main.User Manual for LoRaWAN End Nodes.D20-LBD22-LBD23-LB_LoRaWAN_Temperature_Sensor_User_Manual.WebHome@1675071855856-879.png]] ... ... @@ -117,13 +117,12 @@ 117 117 ))) 118 118 |(% 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. 119 119 115 +== 1.6 BLE connection == 120 120 121 -== 1.7 BLE connection == 122 122 118 +CPL03-LB support BLE remote configure. 123 123 124 -SW3L-LB support BLE remote configure. 125 125 126 - 127 127 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: 128 128 129 129 * Press button to send an uplink ... ... @@ -133,27 +133,14 @@ 133 133 If there is no activity connection on BLE in 60 seconds, sensor will shut down BLE module to enter low power mode. 134 134 135 135 136 -== 1. 8Pin Definitions ==130 +== 1.7 Pin Definitions == 137 137 138 138 [[image:image-20230523174230-1.png]] 139 139 140 140 141 -== 1. 9Flow Sensor Spec ==135 +== 1.8 Mechanical == 142 142 143 143 144 -((( 145 -(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:510px" %) 146 -|=(% style="width: 80px;background-color:#D9E2F3;color:#0070C0" %)**Model**|=(% style="width: 80px;background-color:#D9E2F3;color:#0070C0" %)**Probe**|=(% style="width: 80px;background-color:#D9E2F3;color:#0070C0" %)**Diameter**|=(% style="width: 80px;background-color:#D9E2F3;color:#0070C0" %)**Range**|=(% style="width: 80px;background-color:#D9E2F3;color:#0070C0" %)**Max Pressure**|=(% style="width: 110px;background-color:#D9E2F3;color:#0070C0" %)**Measure** 147 -|(% style="width:88px" %)SW3L-004|(% style="width:75px" %)DW-004|(% style="width:107px" %)G1/2" /DN15|(% style="width:101px" %)1~~30L/min|(% style="width:116px" %)≤ 2.0Mpa|(% style="width:124px" %)450 pulse = 1 L 148 -|(% style="width:88px" %)SW3L-006|(% style="width:75px" %)DW-006|(% style="width:107px" %)G3/4" /DN20|(% style="width:101px" %)1~~60L/min|(% style="width:116px" %)≤ 1.2Mpa|(% style="width:124px" %)390 pulse = 1 L 149 -|(% style="width:88px" %)SW3L-010|(% style="width:75px" %)DW-010|(% style="width:107px" %)G 1" /DN25|(% style="width:101px" %)2~~100L/min|(% style="width:116px" %)≤ 2.0Mpa|(% style="width:124px" %)64 pulse = 1 L 150 -))) 151 - 152 - 153 - 154 -== 2.10 Mechanical == 155 - 156 - 157 157 [[image:Main.User Manual for LoRaWAN End Nodes.D20-LBD22-LBD23-LB_LoRaWAN_Temperature_Sensor_User_Manual.WebHome@1675143884058-338.png]] 158 158 159 159 ... ... @@ -163,29 +163,13 @@ 163 163 [[image:Main.User Manual for LoRaWAN End Nodes.D20-LBD22-LBD23-LB_LoRaWAN_Temperature_Sensor_User_Manual.WebHome@1675143909447-639.png]] 164 164 165 165 166 - (% style="color:blue"%)**DW-004FlowSensor: diameter:G1/2”/ DN15.450 pulse =1 L**147 += 2. Configure CPL03-LB to connect to LoRaWAN network = 167 167 168 -[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/SW3L%20LoRaWAN%20Outdoor%20Flow%20Sensor/WebHome/image-20220519091350-1.png?width=722&height=385&rev=1.1||alt="image-20220519091350-1.png"]] 169 - 170 - 171 -(% style="color:blue" %)**006: DW-006 Flow Sensor: diameter: G3/4” / DN20. 390 pulse = 1 L** 172 - 173 -[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/SW3L%20LoRaWAN%20Outdoor%20Flow%20Sensor/WebHome/image-20220519091423-2.png?width=723&height=258&rev=1.1||alt="image-20220519091423-2.png"]] 174 - 175 - 176 -(% style="color:blue" %)**010: DW-010 Flow Sensor: diameter: G 1” / DN25. 64 pulse = 1 L** 177 - 178 -[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/SW3L%20LoRaWAN%20Outdoor%20Flow%20Sensor/WebHome/image-20220519091423-3.png?width=724&height=448&rev=1.1||alt="image-20220519091423-3.png"]] 179 - 180 - 181 -= 2. Configure SW3L-LB to connect to LoRaWAN network = 182 - 183 183 == 2.1 How it works == 184 184 185 185 186 -The SW3L-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 theSW3L-LB. It will automatically join the network via OTAA and start to send the sensor value. The default uplink interval is 20 minutes.152 +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. 187 187 188 -(% style="display:none" %) (%%) 189 189 190 190 == 2.2 Quick guide to connect to LoRaWAN server (OTAA) == 191 191 ... ... @@ -194,13 +194,11 @@ 194 194 195 195 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. 196 196 197 -[[image:image-20230612171032-3.png||height="492" width="855"]](% style="display:none" %) 198 198 163 +(% style="color:blue" %)**Step 1:**(%%) Create a device in TTN with the OTAA keys from CPL03-LB. 199 199 200 - (% style="color:blue"%)**Step1:**(%%)Createadevicein TTNwith theOTAAkeysfrom SW3L-LB.165 +Each CPL03-LB is shipped with a sticker with the default device EUI as below: 201 201 202 -Each SW3L-LB is shipped with a sticker with the default device EUI as below: 203 - 204 204 [[image:image-20230426084152-1.png||alt="图片-20230426084152-1.png" height="233" width="502"]] 205 205 206 206 ... ... @@ -228,10 +228,10 @@ 228 228 [[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"]] 229 229 230 230 231 -(% style="color:blue" %)**Step 2:**(%%) Activate on SW3L-LB194 +(% style="color:blue" %)**Step 2:**(%%) Activate on CPL03-LB 232 232 233 233 234 -Press the button for 5 seconds to activate the SW3L-LB.197 +Press the button for 5 seconds to activate the CPL03-LB. 235 235 236 236 (% 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. 237 237 ... ... @@ -243,10 +243,8 @@ 243 243 === 2.3.1 Device Status, FPORT~=5 === 244 244 245 245 246 - Includedeviceconfigurestatus.Once SW3L-LBJoinedthenetwork,itwilluplink this messageto theserver.After that,SW3L-LB will uplinkDeviceStatusevery 12 hours.209 +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. 247 247 248 -Users can use the downlink command(**0x26 01**) to ask SW3L-LB to send device configure detail, include device configure status. SW3L-LB will uplink a payload via FPort=5 to server. 249 - 250 250 The Payload format is as below. 251 251 252 252 ... ... @@ -257,10 +257,10 @@ 257 257 258 258 Example parse in TTNv3 259 259 260 -[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/ SW3L%20LoRaWAN%20Outdoor%20Flow%20Sensor/WebHome/1652925144491-755.png?width=732&height=139&rev=1.1||alt="1652925144491-755.png"]]221 +[[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"]] 261 261 262 262 263 -(% style="color:#037691" %)**Sensor Model**(%%): For SW3L-LB, this value is 0x11224 +(% style="color:#037691" %)**Sensor Model**(%%): For CPL03-LB, this value is 0x0A 264 264 265 265 (% style="color:#037691" %)**Firmware Version**(%%): 0x0100, Means: v1.0.0 version 266 266 ... ... @@ -316,74 +316,106 @@ 316 316 === 2.3.2 Sensor Configuration, FPORT~=4 === 317 317 318 318 319 - SW3L-LBwill only send this command after getting the downlink command (0x26 02) from the server.280 +CPL01 will only send this command after getting the downlink command (0x26 02) from the server. 320 320 321 -(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:510px" %) 322 -|(% style="background-color:#d9e2f3; color:#0070c0; width:70px" %) **Size(bytes)**|(% style="background-color:#d9e2f3; color:#0070c0; width:105px" %)**3**|(% style="background-color:#d9e2f3; color:#0070c0; width:60px" %)**1**|(% style="background-color:#d9e2f3; color:#0070c0; width:96px" %)**1**|(% style="background-color:#d9e2f3; color:#0070c0; width:105px" %)**2**|(% style="background-color:#d9e2f3; color:#0070c0; width:74px" %)**1** 323 -|**Value**|(% style="width:104px" %)TDC(unit:sec)|(% style="width:43px" %)N/A|(% style="width:91px" %)Stop Timer|(% style="width:100px" %)Alarm Timer|(% style="width:69px" %)Reserve 282 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %) 283 +|(% colspan="6" style="background-color:#d9e2f3; color:#0070c0; width:504px" %)**Sensor Configuration FPORT=4** 284 +|**Size(bytes)**|(% style="width:75px" %)**3**|(% style="width:77px" %)**1**|(% style="width:96px" %)**1**|(% style="width:158px" %)**2**|(% style="width:158px" %)**1** 285 +|**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 324 324 325 -* (% style="color:#037691" %)**TDC: (default: 0x0004B0)** 287 +* ((( 288 +(% style="color:#037691" %)** TDC: (default: 0x001C20)** 289 +))) 326 326 327 -Uplink interval for the total pulse count, default value is 0x0004B0 which is 1200 seconds = 20 minutes. 291 +((( 292 +Uplink interval for the total pulse count, default value is 0x001C20 which is 7200 seconds = 2 hours. 328 328 294 + 295 +))) 329 329 330 -* (% style="color:#037691" %)**STOP Duration & Alarm Timer** 297 +* ((( 298 +(% style="color:#037691" %)** Disalarm: (default: 0)** 299 +))) 331 331 332 -Shows the configure value of [[Alarm for continuously water flow>>||anchor="H3.3.4Alarmforcontinuouslywaterflow"]] 301 +((( 302 +(% style="color:blue" %)** If Disalarm = 1**(%%), CPL01 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. 303 +))) 333 333 334 -[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/SW3L%20LoRaWAN%20Outdoor%20Flow%20Sensor/WebHome/image-20220519095747-2.png?width=723&height=113&rev=1.1||alt="image-20220519095747-2.png"]] 305 +((( 306 +(% style="color:blue" %)** If Disalarm = 0**(%%), CPL01 will send uplink at every TDC periodically. 335 335 308 + 309 +))) 336 336 337 -=== 2.3.3 Water Flow Value, Uplink FPORT~=2 === 311 +* ((( 312 +(% style="color:#037691" %)** Keep Status & Keep Time** 313 +))) 338 338 339 - 340 340 ((( 341 -SW3L-LB will send this uplink **after** Device Status once join the LoRaWAN network successfully. And SW3L-LB will: 316 +Shows the configure value of [[Alarm Base on Timeout Feature>>||anchor="H3.5AlarmBaseonTimeout"]] 317 + 318 + 342 342 ))) 343 343 321 +* ((( 322 +(% style="color:#037691" %)** Trigger mode (default: 0)** 323 +))) 324 + 344 344 ((( 345 - periodically sendthisuplinkevery20minutes,thisinterval[[canbechanged>>||anchor="H3.3.1SetTransmitIntervalTime"]].326 +(% style="color:blue" %)** If Trigger mode = 0**(%%), count close to open event. 346 346 ))) 347 347 348 348 ((( 349 - UplinkPayload totals11 bytes.330 +(% style="color:blue" %)** If Trigger mode = 1**(%%), count open to close event. 350 350 ))) 351 351 352 -(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:510px" %) 353 -|=(% colspan="6" style="width: 510px;background-color:#D9E2F3;color:#0070C0" %)**Water Flow Value, FPORT=2** 354 -|(% style="width:60px" %)**Size(bytes)**|(% style="width:130px" %)**1**|(% style="width:130px" %)**4**|(% style="width:30px" %)**1**|(% style="width:50px" %)**1**|(% style="width:80px" %)**4** 355 -|(% style="width:110px" %)**Value**|(% style="width:81px" %)Calculate Flag & [[Alarm>>||anchor="H3.3.4Alarmforcontinuouslywaterflow"]]|(% style="width:95px" %)((( 356 -Total pulse Or Last Pulse 357 -)))|(% style="width:55px" %)MOD|(% style="width:115px" %)Reserve(0x01)|(% style="width:129px" %)[[Unix TimeStamp>>||anchor="H2.5.2UnixTimeStamp"]] 333 +[[image:1652860064987-743.png||height="152" width="730"]] 358 358 359 -(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:470px" %) 360 -|=(% colspan="4" style="width: 470px;background-color:#D9E2F3;color:#0070C0" %)**Status & Alarm field** 361 -|(% style="width:60px" %)**Size(bit)**|(% style="width:80px" %)**6**|(% style="width:310px" %)**1**|(% style="width:20px" %)**1** 362 -|(% style="width:88px" %)**Value**|(% style="width:117px" %)Calculate Flag|(% style="width:221px" %)Alarm: 0: No Alarm; 1: Alarm|(% style="width:64px" %)N/A 363 363 364 -[[image: http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/SW3L%20LoRaWAN%20Outdoor%20Flow%20Sensor/WebHome/image-20220519095946-3.png?width=736&height=284&rev=1.1||alt="image-20220519095946-3.png"]]336 +[[image:1652860079526-831.png||height="209" width="729"]] 365 365 366 366 367 -* ((( 368 -(% style="color:#037691" %)**Calculate Flag** 339 +=== 2.3.3 Real-Time Open/Close Status, Uplink FPORT~=2 === 340 + 341 + 342 +((( 343 +((( 344 +CPL01 will send this uplink **after** Device Status once join the LoRaWAN network successfully. And CPL01 will: 369 369 ))) 346 +))) 370 370 371 371 ((( 372 -The calculate flag is a user defined field, IoT server can use this flag to handle different meters with different pulse factors. For example, if there are 100 Flow Sensors, meters 1 ~~50 are 1 liter/pulse and meters 51 ~~ 100 has 1.5 liter/pulse. 349 +((( 350 +periodically send this uplink every 2 hours, this interval [[can be changed>>||anchor="H3.1SetTransmitIntervalTime"]]. 373 373 ))) 352 +))) 374 374 375 375 ((( 376 -**Example: in the default payload:** 355 +((( 356 +Uplink Payload totals 11 bytes. 377 377 ))) 358 +))) 378 378 360 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:520px" %) 361 +|=(% colspan="5" style="background-color:#D9E2F3;color:#0070C0; width: 520px;" %)**Real-Time Open/Close Status, FPORT=2** 362 +|(% style="width:60px" %)**Size(bytes)**|(% style="width:65px" %)**1**|(% style="width:65px" %)**3**|(% style="width:240px" %)**3**|(% style="width:90px" %)**4** 363 +|(% style="width:101px" %)**Value**|(% style="width:133px" %)Status & [[Alarm>>||anchor="H3.5AlarmBaseonTimeout"]]|(% style="width:92px" %)Total pulse|(% style="width:247px" %)The last open duration (unit: min)|(% style="width:149px" %)[[Unix TimeStamp>>||anchor="H2.4.1UnixTimeStamp"]] 364 + 365 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:504px" %) 366 +|=(% colspan="4" style="background-color:#D9E2F3;color:#0070C0; width: 502px;" %)**Status & Alarm field** 367 +|(% style="width:60px" %)**Size(bit)**|(% style="width:70px" %)**6**|(% style="width:228px" %)**1**|(% style="width:146px" %)**1** 368 +|(% 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 369 + 379 379 * ((( 380 - calculateflag=0: for SW3L-004 Flow Sensor:450pulse= 1 L371 +(% style="color:#037691" %)** Calculate Flag** 381 381 ))) 382 -* ((( 383 -calculate flag=1: for SW3L-006 Flow Sensor: 390 pulse = 1 L 373 + 374 +((( 375 +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. 384 384 ))) 385 -* ((( 386 -calculate flag=2: for SW3L-010 Flow Sensor: 64 pulse = 1 L 377 + 378 +((( 379 +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. 387 387 ))) 388 388 389 389 ((( ... ... @@ -392,96 +392,167 @@ 392 392 393 393 ((( 394 394 Range (6 bits): (b)000000 ~~ (b) 111111 395 - 396 -If user use with a meter for example is 0.02L/pulse. To proper decode the correct value in server, 397 - 398 -1) User can set the Calculate Flag of this sensor to 3. 399 - 400 -2) In server side, when a sensor data arrive, the decoder will check the value of Calculate Flag, It the value is 3, the total volume = 0.02 x Pulse Count. 401 401 ))) 402 402 403 403 ((( 404 -(% style="color:red" %)**NOTE: User need to set Calculate Flag to proper value before use Flow Sensor. Downlink or AT Command see: **(%%)Refer: [[Set Calculate Flag>>||anchor="H3.3.6Setthecalculateflag"]] 391 +Refer: [[Set Calculate Flag>>||anchor="H3.9Setthecalculateflag"]] 392 + 393 + 405 405 ))) 406 406 407 407 * ((( 408 -(% style="color:#037691" %)**Alarm** 397 +(% style="color:#037691" %)** Alarm** 409 409 ))) 410 410 411 411 ((( 412 -See [[Alarm for continuously water flow>>||anchor="H3.3.4Alarmforcontinuouslywaterflow"]] 401 +See [[Alarm Base on Timeout>>||anchor="H3.5AlarmBaseonTimeout"]] 402 + 403 + 413 413 ))) 414 414 415 -[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/SW3L%20LoRaWAN%20Outdoor%20Flow%20Sensor/WebHome/image-20220519095946-4.png?width=724&height=65&rev=1.1||alt="image-20220519095946-4.png"]] 416 - 417 - 418 418 * ((( 419 -(% style="color:#037691" %)** Totalpulse**407 +(% style="color:#037691" %)** Contact Status** 420 420 ))) 421 421 422 422 ((( 423 - Totalpulse/counting since factory411 +0: Open 424 424 ))) 425 425 426 426 ((( 427 -Range (4 Bytes) : 0x00000000~~ 0xFFFFFFFF . 415 +1: Close 416 + 417 + 428 428 ))) 429 429 430 430 * ((( 431 -(% style="color:#037691" %)** LastPulse**421 +(% style="color:#037691" %)** Total pulse** 432 432 ))) 433 433 434 434 ((( 435 -Total pulse sincelastFPORT=2 uplink.(Default20 minutes)425 +Total pulse/counting base on dry [[contact trigger event>>||anchor="H2.3.2SensorConfiguration2CFPORT3D4"]] 436 436 ))) 437 437 438 438 ((( 439 -Range (4 Bytes) : 0x00000000~~ 0xFFFFFFFF . 429 +Range (3 Bytes) : 0x000000 ~~ 0xFFFFFF . Max: 16777215 430 + 431 + 440 440 ))) 441 441 442 442 * ((( 443 -(% style="color:#037691" %)** MOD:Default=0**435 +(% style="color:#037691" %)** The last open duration** 444 444 ))) 445 445 446 446 ((( 447 - MOD=0~-~-> Uplink TotalPulsesincefactory439 +Dry Contact last open duration. 448 448 ))) 449 449 450 450 ((( 451 - MOD=1 ~-~->Uplink total pulse since lastFPORT=2 uplink.443 +Unit: min. 452 452 ))) 453 453 454 -* ((( 455 -(% style="color:#037691" %)**Water Flow Value** 456 -))) 446 +[[image:1652860403792-491.png||height="153" width="735"]] 457 457 458 -((( 459 -**Total Water Flow Volume = (Calculate Flag) x (Total Pulse)=9597/450=21.3L** 460 -))) 461 461 462 - [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/SW3L%20LoRaWAN%20Outdoor%20Flow%20Sensor/WebHome/image-20220519095946-5.png?width=727&height=50&rev=1.1||alt="image-20220519095946-5.png"]]449 +=== 2.3.4 Real-Time Open/Close Status, 3 pulse mode, Uplink FPORT~=6 === 463 463 464 464 465 -((( 466 -**Total Water Flow for TDC timer = (Calculate Flag) x (Last Pulse)=79/450=0.2L** 452 +(% style="color:red" %)**Note:** 453 + 454 +* Firmware support for this mode is not released. If users want to test, please contact Dragino support. 455 +* Users need to run (% style="color:blue" %)**AT+MOD=3**(%%) to support this model after updating the firmware. 456 +* This mode doesn't support Historical Events and Datalog features. 457 + 458 +(% style="color:blue" %)**CPL03-LB 3 Pulse Wiring:** 459 + 460 +[[image:image-20221013153352-1.png||height="628" width="720"]] 461 + 462 + 463 +(% style="color:blue" %)**Payload:** 464 + 465 +[[image:image-20221013153352-2.png||height="167" width="1215"]] 466 + 467 + 468 +(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:447px" %) 469 +|(% 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** 470 +|(% style="width:93px" %)Value|(% style="width:59px" %)Status|(% style="width:98px" %)((( 471 +Port1 Total Pulse(PB14) 472 +)))|(% style="width:96px" %)((( 473 +Port2 Total Pulse(PB15) 474 +)))|(% style="width:94px" %)((( 475 +Port3 Total Pulse(PA4) 467 467 ))) 468 468 469 - [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/SW3L%20LoRaWAN%20Outdoor%20Flow%20Sensor/WebHome/image-20220519095946-6.png?width=733&height=43&rev=1.1||alt="image-20220519095946-6.png"]]**478 +(% style="color:blue" %)**Status:** 470 470 480 +(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:257px" %) 481 +|(% 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** 482 +|(% style="width:75px" %)Value|(% style="width:111px" %)Calculate Flag|(% style="width:68px" %)Reserve 471 471 472 - ===2.3.4 HistoricalWaterFlowStatus,FPORT~=3 ===484 +(% style="color:red" %)**Max COUNT for each port is 16777215. Exceed this number will reset to 1.** 473 473 474 474 487 +(% style="color:blue" %)**Related AT Command:** 488 + 489 +(% style="color:#037691" %)**AT+TTRMOD1: Port1 count mode; 0: Signal falling edge(Default), 1: Signal raising edge** 490 + 491 + AT+TTRMOD1=0 Downlink Command: 0xA4 01 00 492 + 493 + AT+TTRMOD1=1 Downlink Command: 0xA4 01 01 494 + 495 + 496 +(% style="color:#037691" %)**AT+TTRMOD2: Port2 count mode; 0: Signal falling edge(Default), 1: Signal raising edge** 497 + 498 + AT+TTRMOD1=0 Downlink Command: 0xA4 02 00 499 + 500 + AT+TTRMOD1=1 Downlink Command: 0xA4 02 01 501 + 502 + 503 +(% style="color:#037691" %)**AT+TTRMOD3: Port3 count mode; 0: Signal falling edge(Default), 1: Signal raising edge** 504 + 505 + AT+TTRMOD1=0 Downlink Command: 0xA4 03 00 506 + 507 + AT+TTRMOD1=1 Downlink Command: 0xA4 03 01 508 + 509 + 510 +(% style="color:#037691" %)**AT+CALCFLAG: Calculate Flag ( Default : 0 )** 511 + 512 + AT+CALCFLAG=aa 513 + 514 + 515 +(% style="color:blue" %)**Downlink Command: 0xA5 aa** 516 + 517 +(% style="color:#037691" %)**AT+COUNTMOD: Accumulative Mode; 0: Accumulative (Default),1: Reset after uplink.** 518 + 519 + AT+COUNTMOD=0 Downlink Command: 0x0B 00 520 + 521 + AT+COUNTMOD=1 Downlink Command: 0x0B 01 522 + 523 + 524 +(% style="color:#037691" %)**AT+SETCNT: Set count value** 525 + 526 + AT+SETCNT=1,aa Downlink Command: 0xA6 01 aa aa aa 527 + 528 + AT+SETCNT=2,aa Downlink Command: 0xA6 02 aa aa aa 529 + 530 + AT+SETCNT=3,aa Downlink Command: 0xA6 03 aa aa aa 531 + 532 + 533 +(% style="color:blue" %)**Decode: **(%%)[[https:~~/~~/github.com/dragino/dragino-end-node-decoder>>https://github.com/dragino/dragino-end-node-decoder]] 534 + 535 + 536 +=== 2.3.5 Historical Door Open/Close Event, FPORT~=3 === 537 + 538 + 475 475 ((( 476 - SW3L-LBstores sensor values and users can retrieve these history values via the [[downlink command>>||anchor="H2.5DatalogFeature"]].540 +CPL01 stores sensor values and users can retrieve these history values via the [[downlink command>>||anchor="H2.4DatalogFeature"]]. 477 477 ))) 478 478 479 479 ((( 480 -The historical payload includes one or multiplies entries and every entry has the same payload as Real-Time water flowstatus.544 +The historical payload includes one or multiplies entries and every entry has the same payload as Real-Time open/close status. 481 481 ))) 482 482 483 483 * ((( 484 -Each data entry is 11 bytes and has the same structure as [[ realtimewater flowstatus>>||anchor="H2.3.3A0WaterFlowValue2CUplinkFPORT3D2"]], to save airtime and battery,SW3L will send max bytes according to the current DR and Frequency bands.548 +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, CPL01 will send max bytes according to the current DR and Frequency bands. 485 485 ))) 486 486 487 487 ((( ... ... @@ -489,80 +489,101 @@ 489 489 ))) 490 490 491 491 ((( 492 -(% style="color:blue" %)** a)DR0:**(%%) max is 11 bytes so one entry of data556 +a) (% style="color:blue" %)**DR0**(%%): max is 11 bytes so one entry of data 493 493 ))) 494 494 495 495 ((( 496 -(% style="color:blue" %)** b)DR1:**(%%) max is 53 bytes so devices will upload 4 entries of data (total 44 bytes)560 +b) (% style="color:blue" %)**DR1**(%%): max is 53 bytes so devices will upload 4 entries of data (total 44 bytes) 497 497 ))) 498 498 499 499 ((( 500 -(% style="color:blue" %)** c)DR2:**(%%) total payload includes 11 entries of data564 +c) (% style="color:blue" %)**DR2**(%%): total payload includes 11 entries of data 501 501 ))) 502 502 503 503 ((( 504 -(% style="color:blue" %)** d)DR3:**(%%) total payload includes 22 entries of data.568 +d) (% style="color:blue" %)**DR3**(%%): total payload includes 22 entries of data. 505 505 ))) 506 506 507 507 ((( 508 -If SW3L-LB doesn't have any data in the polling time. It will uplink 11 bytes of 0 572 +If CPL01 doesn't have any data in the polling time. It will uplink 11 bytes of 0 573 + 574 + 509 509 ))) 510 510 577 +(% style="color:blue" %)** Downlink:** 578 + 579 +(% class="box" %) 511 511 ((( 512 - (% style="color:#037691"%)**Downlink:**581 +**0x31 61 E9 3A D4 61 E9 3D E0 05** 513 513 ))) 514 514 584 +[[image:1652861353248-624.png||height="189" width="720"]] 585 + 586 + 587 +(% style="color:blue" %)** Uplink:** 588 + 589 +(% class="box" %) 515 515 ((( 516 -0 x316246 B1F0 62 46 B3 9407591 +**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** 517 517 ))) 518 518 519 - [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/SW3L%20LoRaWAN%20Outdoor%20Flow%20Sensor/WebHome/1652926690850-712.png?width=726&height=115&rev=1.1||alt="1652926690850-712.png"]]594 +(% style="color:#037691" %)** ** 520 520 596 +(% style="color:#037691" %)**Parsed Value:** 521 521 522 522 ((( 523 - (%style="color:#037691"%)**Uplink:**599 +[ALARM, PIN_STATUS, TOTAL_PULSE, CALCULATE_FLAG, LAST_OPEN_DURATION, TIME] 524 524 ))) 525 525 526 526 ((( 527 - 0000 01 00 00 00 00 62 46 B2 26 00 00 01 00 00 00 00 62 46 B2 5D 00 00 01 00 00 00 00 62 46 B2 99 00 00 01 00 00 00 00 62 46 B2 D5 00 00 01 00 00 01 15 62 46 B3 11 00 00 01 00 00 01 1F 62 46 B3 7E603 + 528 528 ))) 529 529 530 530 ((( 531 - (%style="color:#037691"%)**ParsedValue:**607 +[TRUE, CLOSE, 9190, 3, 0, 2022-01-20 10:35:48], 532 532 ))) 533 533 534 534 ((( 535 -[ Alarm, Calculate Flag,MOD,Total pulse or Last Pulse,****Water Flow Value,TIME]611 +[TRUE, CLOSE, 9190, 3, 0, 2022-01-20 10:36:21], 536 536 ))) 537 537 614 +((( 615 +[FALSE, OPEN, 0, 3, 0, 2022-01-20 10:39:04], 616 +))) 538 538 539 539 ((( 540 -[ FALSE,0,0,0,0.0,2022-04-0108:04:54],619 +[TRUE, CLOSE, 2, 3, 0, 2022-01-20 10:39:16], 541 541 ))) 542 542 543 543 ((( 544 -[ FALSE,0,0,0,0.0,2022-04-0108:05:49],623 +[TRUE, CLOSE, 6, 3, 0, 2022-01-20 10:39:23], 545 545 ))) 546 546 547 547 ((( 548 -[FALSE, 0,0,0,0.0,2022-04-0108:06:49],627 +[FALSE, OPEN, 0, 0, 0, 2022-01-20 10:42:25], 549 549 ))) 550 550 551 551 ((( 552 -[FALSE, 0,0,0,0.0,2022-04-0108:07:49],631 +[FALSE, OPEN, 0, 0, 0, 2022-01-20 10:42:41], 553 553 ))) 554 554 555 555 ((( 556 -[FALSE, 0,0,277,0.6,2022-04-0108:08:49],635 +[FALSE, OPEN, 0, 3, 0, 2022-01-20 10:43:08], 557 557 ))) 558 558 559 559 ((( 560 -[ FALSE,0,0,287,0.6,2022-04-0108:10:38],639 +[TRUE, CLOSE, 7, 3, 0, 2022-01-20 10:43:34], 561 561 ))) 562 562 563 -[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/SW3L%20LoRaWAN%20Outdoor%20Flow%20Sensor/WebHome/1652926777796-267.png?width=724&height=279&rev=1.1||alt="1652926777796-267.png"]] 642 +((( 643 +[FALSE, CLOSE, 0, 0, 0, 2022-01-20 10:47:02], 564 564 645 + 646 +))) 565 565 648 +[[image:1652861480446-216.png]] 649 + 650 + 566 566 == 2.4 Payload Decoder file == 567 567 568 568 ... ... @@ -574,19 +574,19 @@ 574 574 == 2.5 Datalog Feature == 575 575 576 576 577 -Datalog Feature is to ensure IoT Server can get all sampling data from Sensor even if the LoRaWAN network is down. For each sampling, S W3L-LB will store the reading for future retrieving purposes.662 +Datalog Feature is to ensure IoT Server can get all sampling data from Sensor even if the LoRaWAN network is down. For each sampling, S31x-LB will store the reading for future retrieving purposes. 578 578 579 579 580 580 === 2.5.1 Ways to get datalog via LoRaWAN === 581 581 582 582 583 -Set PNACKMD=1, S W3L-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.668 +Set [[PNACKMD=1>>||anchor="H2.5.4DatalogUplinkpayload28FPORT3D329"]], S31x-LB will wait for ACK for every uplink, when there is no LoRaWAN network,S31x-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. 584 584 585 585 * ((( 586 -a) S W3L-LB will do an ACK check for data records sending to make sure every data arrive server.671 +a) S31x-LB will do an ACK check for data records sending to make sure every data arrive server. 587 587 ))) 588 588 * ((( 589 -b) S W3L-LB will send data in **CONFIRMED Mode** when PNACKMD=1, but SW3L-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 SW3L-LB gets a ACK, SW3L-LB will consider there is a network connection and resend all NONE-ACK messages.674 +b) S31x-LB will send data in **CONFIRMED Mode** when PNACKMD=1, but S31x-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 S31x-LB gets a ACK, S31x-LB will consider there is a network connection and resend all NONE-ACK messages. 590 590 ))) 591 591 592 592 Below is the typical case for the auto-update datalog feature (Set PNACKMD=1) ... ... @@ -597,7 +597,7 @@ 597 597 === 2.5.2 Unix TimeStamp === 598 598 599 599 600 -S W3L-LB uses Unix TimeStamp format based on685 +S31x-LB uses Unix TimeStamp format based on 601 601 602 602 [[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"]] 603 603 ... ... @@ -616,11 +616,12 @@ 616 616 617 617 User need to set (% style="color:blue" %)**SYNCMOD=1**(%%) to enable sync time via MAC command. 618 618 619 -Once S W3L-LB Joined LoRaWAN network, it will send the MAC command (DeviceTimeReq) and the server will reply with (DeviceTimeAns) to send the current time to SW3L-LB. If SW3L-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).704 +Once S31x-LB Joined LoRaWAN network, it will send the MAC command (DeviceTimeReq) and the server will reply with (DeviceTimeAns) to send the current time to S31x-LB. If S31x-LB fails to get the time from the server, S31x-LB will use the internal time and wait for next time request (AT+SYNCTDC to set the time request period, default is 10 days). 620 620 621 621 (% 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.** 622 622 623 623 709 + 624 624 === 2.5.4 Poll sensor value === 625 625 626 626 ... ... @@ -636,7 +636,7 @@ 636 636 ))) 637 637 638 638 ((( 639 -For example, downlink command http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/CPL01%20LoRaWAN%20Outdoor%20PulseContact%20%20Sensor%20Manual/WebHome/image-20220518162852-1.png?rev=1.1||alt="image-20220518162852-1.png"]]725 +For example, downlink command[[image:image-20220518162852-1.png]] 640 640 ))) 641 641 642 642 ((( ... ... @@ -644,32 +644,29 @@ 644 644 ))) 645 645 646 646 ((( 647 -Uplink Internal =5s,means SW3L-LBwill send one packet every 5s. range 5~~255s.733 +Uplink Internal =5s,means CPL01 will send one packet every 5s. range 5~~255s. 648 648 ))) 649 649 650 650 651 -== 2. 6Frequency Plans ==737 +== 2.7 Frequency Plans == 652 652 653 653 654 -The S W3L-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.740 +The S31x-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. 655 655 656 656 [[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20Frequency%20Band/>>http://wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20Frequency%20Band/]] 657 657 658 658 659 -= 3. Configure S W3L-LB =745 += 3. Configure S31x-LB = 660 660 661 661 == 3.1 Configure Methods == 662 662 663 663 664 -S W3L-LB supports below configure method:750 +S31x-LB supports below configure method: 665 665 666 666 * AT Command via Bluetooth Connection (**Recommended**): [[BLE Configure Instruction>>http://wiki.dragino.com/xwiki/bin/view/Main/BLE%20Bluetooth%20Remote%20Configure/]]. 667 - 668 668 * 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]]. 669 - 670 670 * LoRaWAN Downlink. Instruction for different platforms: See [[IoT LoRaWAN Server>>http://wiki.dragino.com/xwiki/bin/view/Main/]] section. 671 671 672 - 673 673 == 3.2 General Commands == 674 674 675 675 ... ... @@ -676,7 +676,6 @@ 676 676 These commands are to configure: 677 677 678 678 * General system settings like: uplink interval. 679 - 680 680 * LoRaWAN protocol & radio related command. 681 681 682 682 They are same for all Dragino Devices which support DLWS-005 LoRaWAN Stack. These commands can be found on the wiki: ... ... @@ -684,10 +684,10 @@ 684 684 [[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/]] 685 685 686 686 687 -== 3.3 Commands special design for SW3L-LB ==769 +== 3.3 Commands special design for CPL03-LB == 688 688 689 689 690 -These commands only valid for SW3L-LB, as below:772 +These commands only valid for CPL03-LB, as below: 691 691 692 692 693 693 === 3.3.1 Set Transmit Interval Time === ... ... @@ -695,6 +695,8 @@ 695 695 696 696 ((( 697 697 Feature: Change LoRaWAN End Node Transmit Interval. 780 + 781 + 698 698 ))) 699 699 700 700 ((( ... ... @@ -729,7 +729,10 @@ 729 729 Example 1: Downlink Payload: 0100001E ~/~/ Set Transmit Interval (TDC) = 30 seconds 730 730 ))) 731 731 * ((( 732 -Example 2: Downlink Payload: 0100003C ~/~/ Set Transmit Interval (TDC) = 60 seconds 816 +Example 2: Downlink Payload: 0100003C ~/~/ Set Transmit Interval (TDC) = 60 seconds 817 + 818 + 819 + 733 733 ))) 734 734 735 735 ... ... @@ -759,109 +759,216 @@ 759 759 Sensor will upload Device Status via FPORT=5. See payload section for detail. 760 760 761 761 762 -=== 3.3.4 Alarmforcontinuouslywaterflow===849 +=== 3.3.4 Enable / Disable Alarm === 763 763 764 764 852 +Feature: Enable/Disable Alarm for open/close event. Default value 0. 853 + 854 +(% style="color:blue" %)**AT Command:** 855 + 856 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:520px" %) 857 +|(% 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** 858 +|(% style="width:154px" %)AT+DISALARM=1|(% style="width:278px" %)End node will only send packets in TDC time.|OK 859 +|(% style="width:154px" %)AT+DISALARM=0|(% style="width:278px" %)End node will send packets in TDC time or status change for door sensor|OK 860 + 861 +(% style="color:blue" %)**Downlink Command:** 862 + 863 +**0xA7 01** ~/~/ Same As AT+DISALARM=1 864 + 865 +**0xA7 00 ** ~/~/ Same As AT+DISALARM=0 866 + 867 +(% style="color:red" %)**Notice, This command requires setting CPL01 to LDS03A Mode first. See **(%%)**"(% style="color:blue" %)3.7 Set the sensor mode"(%%)** 868 + 869 + 870 +=== 3.3.5 Alarm Base on Timeout === 871 + 872 + 765 765 ((( 766 -This feature is to monitor and send Alarm for continuously water flow. 874 +((( 875 +CPL01 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: 876 + 877 + 767 767 ))) 879 +))) 768 768 769 769 ((( 770 -Example case is for Toilet water monitoring, if some one push toilet button, the toilet will have water flow. If the toilet button has broken and can't returned to original state, the water flow will keep for hours or days which cause huge waste for water. 882 +((( 883 +(% style="color:#4f81bd" %)**1. Keep Status: Status to be monitor** 771 771 ))) 885 +))) 772 772 773 773 ((( 774 -To monitor this faulty and send alarm, there are two settings: 888 +((( 889 +Keep Status = 1: Monitor Close to Open event 775 775 ))) 891 +))) 776 776 777 -* ((( 778 -(% style="color:#4f81bd" %)**Stop Duration: Unit: Second** 893 +((( 894 +((( 895 +Keep Status = 0: Monitor Open to Close event 896 + 897 + 779 779 ))) 899 +))) 780 780 781 781 ((( 782 -Default: 15s, If SW3L-LB didn't see any water flow in 15s, SW3L-LB will consider stop of water flow event. 902 +((( 903 +(% style="color:#4f81bd" %)**2. Keep Time: Timeout to send an Alarm** 783 783 ))) 905 +))) 784 784 785 -* ((( 786 -(% style="color:#4f81bd" %)**Alarm Timer: Units: Minute; Default 0 minutes (means Alarm disable)** 907 +((( 908 +((( 909 +Range 0 ~~ 65535(0xFFFF) seconds. 787 787 ))) 911 +))) 788 788 789 789 ((( 790 -**Example:** 3 minutes, if SW3L-LB detect a start of water flow event and didn't detect a stop event within Alarm timer, SW3L-LB will send an Alarm to indicate a water flow abnormal alarm. 914 +((( 915 +If keep time = 0, Disable Alarm Base on Timeout feature. 791 791 ))) 917 +))) 792 792 793 793 ((( 794 -So for example, If we set stop duration=15s and Alarm Timer=3minutes. If the toilet water flow continuously for more than 3 minutes, Sensor will send an alarm (in Confirmed MODE) to platform. 920 +((( 921 +If keep time > 0, device will monitor the keep status event and send an alarm when status doesn’t change after timeout. 795 795 ))) 796 796 797 797 ((( 798 - (%style="color:red" %)**Note:** **After this alarm is send, sensor will consider a stop of water flow and count for another new event. So if water flow waste last for 1 hour, Sensor will keep sending alarm every 3 minutes.**925 + 799 799 ))) 927 +))) 800 800 801 801 ((( 930 +((( 802 802 (% style="color:#4f81bd" %)**AT Command**(%%) to configure: 803 803 ))) 804 804 805 - *(((806 -AT+ PTRIG=15,3 ~-~->Set Stopduration:15s, Alarm Timer:3minutes.934 +((( 935 +(% 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. CPL01 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. 807 807 ))) 808 808 809 - *(((810 -AT+ PTRIG=15,0water wasteAlarm.938 +((( 939 +(% style="color:blue" %)**AT+TTIG=0,0 **(%%) ~-~-> Default Value, disable timeout Alarm. 811 811 ))) 941 +))) 812 812 813 813 ((( 814 - (%style="color:#4f81bd" %)**Downlink Command**(%%) to configure:944 + 815 815 ))) 816 816 817 817 ((( 818 -Command: **0xAA aa bb cc** 948 +((( 949 +(% style="color:#4f81bd" %)**Downlink Command**(%%) to configure: 819 819 ))) 820 820 821 821 ((( 822 - AA:CommandTypeCode953 +**Command: 0xA9 aa bb cc** 823 823 ))) 955 +))) 824 824 825 825 ((( 826 -aa: Stop duration 958 +((( 959 +A9: Command Type Code 827 827 ))) 961 +))) 828 828 829 829 ((( 830 -bb cc: Alarm Timer 964 +((( 965 +aa: status to be monitored 831 831 ))) 967 +))) 832 832 833 833 ((( 834 -If user send 0xAA 0F 00 03: equal to AT+PTRIG=15,3 970 +((( 971 +bb cc: timeout. 835 835 ))) 973 +))) 836 836 975 +((( 976 + 977 +))) 837 837 838 -=== 3.3.5 Clear Flash Record === 979 +((( 980 +((( 981 +If user send 0xA9 01 00 1E: equal to AT+TTRIG=1,30 982 +))) 983 +))) 839 839 985 +((( 986 +((( 987 +Or 988 +))) 989 +))) 840 840 991 +((( 992 +((( 993 +0xA9 00 00 00: Equal to AT+TTRIG=0,0. Disable timeout Alarm. 994 +))) 995 +))) 996 + 997 + 998 +=== 3.3.6 Clear Flash Record === 999 + 1000 + 841 841 Feature: Clear flash storage for data log feature. 842 842 843 -(% style="color:blue" %)**AT Command: AT+CLRDTA** 844 844 1004 +(% style="color:#4f81bd" %)**AT Command: AT+CLRDTA** 1005 + 845 845 (% border="1" cellspacing="5" style="background-color:#f2f2f2; width:500px" %) 846 846 |=(% 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** 847 847 |(% style="width:157px" %)AT+CLRDTA|(% style="width:169px" %)Clear flash storage for data log feature.|Clear all stored sensor data… OK 848 848 849 849 ((( 850 -(% style="color:blue" %)**Downlink Command:** 1011 +((( 1012 +(% style="color:#4f81bd" %)**Downlink Command:** 851 851 ))) 852 852 853 853 ((( 854 854 * **Example**: 0xA301 ~/~/ Same as AT+CLRDTA 855 855 ))) 1018 +))) 856 856 857 857 858 858 859 -=== 3.3. 6Set thecalculateflag===1022 +=== 3.3.7 Set trigger mode === 860 860 861 861 1025 +Feature: Set the trigger interrupt mode. 1026 + 1027 +(% style="color:#4f81bd" %)**AT Command: AT+TTRMOD** 1028 + 1029 +(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:495px" %) 1030 +|=(% 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** 1031 +|(% style="width:157px" %)((( 1032 +AT+TTRMOD=1 1033 +)))|(% style="width:156px" %)Count and trigger from open to close (rising edge)|(% style="width:89px" %)((( 1034 +((( 1035 +OK 1036 +))) 1037 +))) 1038 +|(% style="width:157px" %)((( 1039 +AT+TTRMOD=0 1040 +)))|(% style="width:156px" %)Count and trigger from close to open (falling edge)|(% style="width:89px" %)((( 1041 +OK 1042 +))) 1043 + 1044 +(% style="color:#4f81bd" %)**Downlink Command:** 1045 + 1046 +* **Example**: 0xA401 ~/~/ Same as AT+ TTRMOD =1 1047 + 1048 + 1049 + 1050 + 1051 + 1052 + 1053 +=== 3.3.8 Set the calculate flag === 1054 + 1055 + 862 862 Feature: Set the calculate flag 863 863 864 -(% style="color:b lue" %)**AT Command: AT+CALCFLAG**1058 +(% style="color:#4f81bd" %)**AT Command: AT+CALCFLAG** 865 865 866 866 (% border="1" cellspacing="5" style="background-color:#f2f2f2; width:461px" %) 867 867 |=(% 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** ... ... @@ -868,17 +868,19 @@ 868 868 |(% style="width:158px" %)AT+CALCFLAG =1|(% style="width:192px" %)Set the calculate flag to 1.|(% style="width:109px" %)OK 869 869 |(% style="width:158px" %)AT+CALCFLAG =2|(% style="width:192px" %)Set the calculate flag to 2.|(% style="width:109px" %)OK 870 870 871 -(% style="color:b lue" %)**Downlink Command:**1065 +(% style="color:#4f81bd" %)**Downlink Command:** 872 872 873 873 * **Example**: 0XA501 ~/~/ Same as AT+CALCFLAG =1 874 874 875 875 876 -=== 3.3.7 Set count number === 877 877 878 878 1072 +=== 3.3.9 Set count number === 1073 + 1074 + 879 879 Feature: Manually set the count number 880 880 881 -(% style="color:b lue" %)**AT Command: AT+SETCNT**1077 +(% style="color:#4f81bd" %)**AT Command: AT+SETCNT** 882 882 883 883 (% border="1" cellspacing="5" style="background-color:#f2f2f2; width:479px" %) 884 884 |=(% 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** ... ... @@ -885,16 +885,17 @@ 885 885 |(% style="width:160px" %)AT+ SETCNT =0|(% style="width:221px" %)Set the count number to 0.|(% style="width:95px" %)OK 886 886 |(% style="width:160px" %)AT+ SETCNT =100|(% style="width:221px" %)Set the count number to 100.|(% style="width:95px" %)OK 887 887 888 -(% style="color:b lue" %)**Downlink Command:**1084 +(% style="color:#4f81bd" %)**Downlink Command:** 889 889 890 890 * **Example**: 0xA6000001 ~/~/ Same as AT+ SETCNT =1 891 - 892 892 * **Example**: 0xA6000064 ~/~/ Same as AT+ SETCNT =100 893 893 894 894 895 -=== 3.3.8 Set Interrupt Mode === 896 896 897 897 1092 +=== 3.3.10 Set Interrupt Mode === 1093 + 1094 + 898 898 Feature, Set Interrupt mode for PA8 of pin. 899 899 900 900 When AT+INTMOD=0 is set, PA8 is used as a digital input port. ... ... @@ -923,34 +923,45 @@ 923 923 This means that the interrupt mode of the end node is set to 0x000003=3 (rising edge trigger), and the type code is 06. 924 924 925 925 * Example 1: Downlink Payload: 06000000 ~/~/ Turn off interrupt mode 926 - 927 927 * Example 2: Downlink Payload: 06000003 ~/~/ Set the interrupt mode to rising edge trigger 928 928 929 929 930 -=== 3.3.9 Set work mode === 931 931 932 932 933 -Feature: Manually set the work mode 934 934 935 935 936 - (%style="color:blue"%)**AT Command:AT+MOD**1130 +=== 3.3.11 Set Power Output Duration === 937 937 938 -(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:463px" %) 939 -|=(% 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** 940 -|(% style="width:162px" %)AT+MOD=0|(% style="width:191px" %)Set the work mode to 0.|(% style="width:106px" %)OK 941 -|(% style="width:162px" %)AT+MOD=1|(% style="width:191px" %)Set the work mode to 1|(% style="width:106px" %)OK 942 942 943 - (% style="color:blue"%)**DownlinkCommand:**1133 +Control the output duration 5V . Before each sampling, device will 944 944 945 - ***Example:**0x0A00~/~/ SamesAT+MOD=01135 +~1. first enable the power output to external sensor, 946 946 947 - ***Example:**0x0A01~/~/Same asAT+MOD=11137 +2. keep it on as per duration, read sensor value and construct uplink payload 948 948 1139 +3. final, close the power output. 949 949 1141 +(% style="color:blue" %)**AT Command: AT+5VT** 1142 + 1143 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %) 1144 +|=(% 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** 1145 +|(% style="width:154px" %)AT+5VT=?|(% style="width:196px" %)Show 5V open time.|(% style="width:157px" %)0 (default) 1146 +OK 1147 +|(% style="width:154px" %)AT+5VT=500|(% style="width:196px" %)Close after a delay of 1000 milliseconds.|(% style="width:157px" %)OK 1148 + 1149 +(% style="color:blue" %)**Downlink Command: 0x07** 1150 + 1151 +Format: Command Code (0x07) followed by 2 bytes. 1152 + 1153 +The first and second bytes are the time to turn on. 1154 + 1155 +* Example 1: Downlink Payload: 070000 **~-~-->** AT+5VT=0 1156 +* Example 2: Downlink Payload: 0701F4 **~-~-->** AT+5VT=500 1157 + 950 950 = 4. Battery & Power Consumption = 951 951 952 952 953 -S W3L-LB use ER26500 + SPC1520 battery pack. See below link for detail information about the battery info and how to replace.1161 +S31x-LB use ER26500 + SPC1520 battery pack. See below link for detail information about the battery info and how to replace. 954 954 955 955 [[**Battery Info & Power Consumption Analyze**>>http://wiki.dragino.com/xwiki/bin/view/Main/How%20to%20calculate%20the%20battery%20life%20of%20Dragino%20sensors%3F/]] . 956 956 ... ... @@ -959,37 +959,30 @@ 959 959 960 960 961 961 (% class="wikigeneratedid" %) 962 -User can change firmware S W3L-LB to:1170 +User can change firmware S31x-LB to: 963 963 964 964 * Change Frequency band/ region. 965 - 966 966 * Update with new features. 967 - 968 968 * Fix bugs. 969 969 970 970 Firmware and changelog can be downloaded from : **[[Firmware download link>>url:https://www.dropbox.com/sh/kwqv57tp6pejias/AAAopYMATh1GM6fZ-VRCLrpDa?dl=0]]** 971 971 1178 + 972 972 Methods to Update Firmware: 973 973 974 974 * (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/]] 975 - 976 976 * 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]]**. 977 977 978 - 979 979 = 6. FAQ = 980 980 981 -== 6.1 AT Commands input doesn't work == 982 982 983 983 984 -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. 985 - 986 - 987 987 = 7. Order Info = 988 988 989 989 990 -Part Number: (% style="color:blue" %)**S W3L-LB-XXX-YYY**1191 +Part Number: (% style="color:blue" %)**S31-LB-XX / S31B-LB-XX** 991 991 992 -(% style="color:red" %)**XX X**(%%): The default frequency band1193 +(% style="color:red" %)**XX**(%%): The default frequency band 993 993 994 994 * (% style="color:red" %)**AS923**(%%): LoRaWAN AS923 band 995 995 ... ... @@ -1007,43 +1007,12 @@ 1007 1007 1008 1008 * (% style="color:red" %)**CN470**(%%): LoRaWAN CN470 band 1009 1009 1010 -((( 1011 -(% style="color:blue" %)**YYY**(%%): Flow Sensor Model: 1012 -))) 1013 - 1014 -((( 1015 - **004:** DW-004 Flow Sensor: diameter: G1/2” / DN15. 450 pulse = 1 L 1016 -))) 1017 - 1018 -((( 1019 - **006:** DW-006 Flow Sensor: diameter: G3/4” / DN20. 390 pulse = 1 L 1020 -))) 1021 - 1022 -((( 1023 - **010:** DW-010 Flow Sensor: diameter: G 1” / DN25. 64 pulse = 1 L 1024 -))) 1025 - 1026 -* ((( 1027 -calculate flag=0: for SW3L-004 Flow Sensor: 450 pulse = 1 L 1028 -))) 1029 - 1030 -* ((( 1031 -calculate flag=1: for SW3L-006 Flow Sensor: 390 pulse = 1 L 1032 -))) 1033 - 1034 -* ((( 1035 -calculate flag=2: for SW3L-010 Flow Sensor: 64 pulse = 1 L 1036 - 1037 - 1038 - 1039 -))) 1040 - 1041 1041 = 8. Packing Info = 1042 1042 1043 1043 1044 1044 (% style="color:#037691" %)**Package Includes**: 1045 1045 1046 -* S W3L-LB LoRaWANFlowSensor1216 +* S31x-LB LoRaWAN Temperature & Humidity Sensor 1047 1047 1048 1048 (% style="color:#037691" %)**Dimension and weight**: 1049 1049 ... ... @@ -1055,7 +1055,6 @@ 1055 1055 1056 1056 * Weight / pcs : g 1057 1057 1058 - 1059 1059 = 9. Support = 1060 1060 1061 1061
- image-20230530111051-3.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -85.1 KB - Content
- image-20230530111412-4.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -85.0 KB - Content
- 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