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 (1 modified, 0 added, 0 removed)
Details
- Page properties
-
- Content
-
... ... @@ -105,6 +105,7 @@ 105 105 * Sleep Mode: 5uA @ 3.3v 106 106 * LoRa Transmit Mode: 125mA @ 20dBm, 82mA @ 14dBm 107 107 108 + 108 108 == 1.4 Effective measurement range Reference beam pattern == 109 109 110 110 ... ... @@ -192,18 +192,6 @@ 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 -**Probe Mechanical:** 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 207 = 2. Configure DDS75-LB to connect to LoRaWAN network = 208 208 209 209 == 2.1 How it works == ... ... @@ -264,178 +264,355 @@ 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 256 +== 2.3 Uplink Payload == 268 268 258 +=== 2.3.1 Device Status, FPORT~=5 === 269 269 260 + 261 +Include device configure status. Once SW3L-LB Joined the network, it will uplink this message to the server. After that, SW3L-LB will uplink Device Status every 12 hours. 262 + 263 +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. 264 + 265 +The Payload format is as below. 266 + 267 + 268 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %) 269 +|(% colspan="6" style="background-color:#d9e2f3; color:#0070c0" %)**Device Status (FPORT=5)** 270 +|(% style="width:103px" %)**Size (bytes)**|(% style="width:72px" %)**1**|**2**|(% style="width:91px" %)**1**|(% style="width:86px" %)**1**|(% style="width:44px" %)**2** 271 +|(% 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 272 + 273 +Example parse in TTNv3 274 + 275 +[[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"]] 276 + 277 + 278 +(% style="color:#037691" %)**Sensor Model**(%%): For SW3L-LB, this value is 0x11 279 + 280 +(% style="color:#037691" %)**Firmware Version**(%%): 0x0100, Means: v1.0.0 version 281 + 282 +(% style="color:#037691" %)**Frequency Band**: 283 + 284 +*0x01: EU868 285 + 286 +*0x02: US915 287 + 288 +*0x03: IN865 289 + 290 +*0x04: AU915 291 + 292 +*0x05: KZ865 293 + 294 +*0x06: RU864 295 + 296 +*0x07: AS923 297 + 298 +*0x08: AS923-1 299 + 300 +*0x09: AS923-2 301 + 302 +*0x0a: AS923-3 303 + 304 +*0x0b: CN470 305 + 306 +*0x0c: EU433 307 + 308 +*0x0d: KR920 309 + 310 +*0x0e: MA869 311 + 312 + 313 +(% style="color:#037691" %)**Sub-Band**: 314 + 315 +AU915 and US915:value 0x00 ~~ 0x08 316 + 317 +CN470: value 0x0B ~~ 0x0C 318 + 319 +Other Bands: Always 0x00 320 + 321 + 322 +(% style="color:#037691" %)**Battery Info**: 323 + 324 +Check the battery voltage. 325 + 326 +Ex1: 0x0B45 = 2885mV 327 + 328 +Ex2: 0x0B49 = 2889mV 329 + 330 + 331 +=== 2.3.2 Sensor Configuration, FPORT~=4 === 332 + 333 + 334 +SW3L-LB will only send this command after getting the downlink command (0x26 02) from the server. 335 + 336 +(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:510px" %) 337 +|(% 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** 338 +|**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 339 + 340 +* (% style="color:#037691" %)**TDC: (default: 0x0004B0)** 341 + 342 +Uplink interval for the total pulse count, default value is 0x0004B0 which is 1200 seconds = 20 minutes. 343 + 344 + 345 +* (% style="color:#037691" %)**STOP Duration & Alarm Timer** 346 + 347 +Shows the configure value of [[Alarm for continuously water flow>>||anchor="H3.3.4Alarmforcontinuouslywaterflow"]] 348 + 349 +[[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"]] 350 + 351 + 352 +=== 2.3.3 Water Flow Value, Uplink FPORT~=2 === 353 + 354 + 270 270 ((( 271 -((( 272 -DDS75-LB will uplink payload via LoRaWAN with below payload format: 356 +SW3L-LB will send this uplink **after** Device Status once join the LoRaWAN network successfully. And SW3L-LB will: 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 360 +periodically send this uplink every 20 minutes, this interval [[can be changed>>||anchor="H3.3.1SetTransmitIntervalTime"]]. 278 278 ))) 279 -))) 280 280 281 281 ((( 282 - 364 +Uplink Payload totals 11 bytes. 283 283 ))) 284 284 285 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"]] 368 +|=(% colspan="6" style="width: 510px;background-color:#D9E2F3;color:#0070C0" %)**Water Flow Value, FPORT=2** 369 +|(% 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** 370 +|(% style="width:110px" %)**Value**|(% style="width:81px" %)Calculate Flag & [[Alarm>>||anchor="H3.3.4Alarmforcontinuouslywaterflow"]]|(% style="width:95px" %)((( 371 +Total pulse Or Last Pulse 372 +)))|(% style="width:55px" %)MOD|(% style="width:115px" %)Reserve(0x01)|(% style="width:129px" %)[[Unix TimeStamp>>||anchor="H2.5.2UnixTimeStamp"]] 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"]] 374 +(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:470px" %) 375 +|=(% colspan="4" style="width: 470px;background-color:#D9E2F3;color:#0070C0" %)**Status & Alarm field** 376 +|(% style="width:60px" %)**Size(bit)**|(% style="width:80px" %)**6**|(% style="width:310px" %)**1**|(% style="width:20px" %)**1** 377 +|(% style="width:88px" %)**Value**|(% style="width:117px" %)Calculate Flag|(% style="width:221px" %)Alarm: 0: No Alarm; 1: Alarm|(% style="width:64px" %)N/A 297 297 379 +[[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"]] 298 298 299 -=== 2.3.1 Battery Info === 300 300 382 +* ((( 383 +(% style="color:#037691" %)**Calculate Flag** 384 +))) 301 301 302 -Check the battery voltage for DDS75-LB. 386 +((( 387 +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. 388 +))) 303 303 304 -Ex1: 0x0B45 = 2885mV 390 +((( 391 +**Example: in the default payload:** 392 +))) 305 305 306 -Ex2: 0x0B49 = 2889mV 394 +* ((( 395 +calculate flag=0: for SW3L-004 Flow Sensor: 450 pulse = 1 L 396 +))) 397 +* ((( 398 +calculate flag=1: for SW3L-006 Flow Sensor: 390 pulse = 1 L 399 +))) 400 +* ((( 401 +calculate flag=2: for SW3L-010 Flow Sensor: 64 pulse = 1 L 402 +))) 307 307 404 +((( 405 +Default value: 0. 406 +))) 308 308 309 -=== 2.3.2 Distance === 408 +((( 409 +Range (6 bits): (b)000000 ~~ (b) 111111 310 310 411 +If user use with a meter for example is 0.02L/pulse. To proper decode the correct value in server, 311 311 312 -((( 313 -Get the distance. Flat object range 280mm - 7500mm. 413 +1) User can set the Calculate Flag of this sensor to 3. 414 + 415 +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. 314 314 ))) 315 315 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" %)** ** 419 +(% 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"]] 420 +))) 318 318 319 -(% style="color:#4472c4" %)**0B05(H) = 2821 (D) = 2821 mm.** 422 +* ((( 423 +(% style="color:#037691" %)**Alarm** 320 320 ))) 321 321 426 +((( 427 +See [[Alarm for continuously water flow>>||anchor="H3.3.4Alarmforcontinuouslywaterflow"]] 428 +))) 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. 430 +[[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"]] 325 325 326 -=== 2.3.3 Interrupt Pin === 327 327 433 +* ((( 434 +(% style="color:#037691" %)**Total pulse** 435 +))) 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. 437 +((( 438 +Total pulse/counting since factory 439 +))) 330 330 331 -**Example:** 441 +((( 442 +Range (4 Bytes) : 0x00000000~~ 0xFFFFFFFF . 443 +))) 332 332 333 -0x00: Normal uplink packet. 445 +* ((( 446 +(% style="color:#037691" %)**Last Pulse** 447 +))) 334 334 335 -0x01: Interrupt Uplink Packet. 449 +((( 450 +Total pulse since last FPORT=2 uplink. (Default 20 minutes) 451 +))) 336 336 453 +((( 454 +Range (4 Bytes) : 0x00000000~~ 0xFFFFFFFF . 455 +))) 337 337 338 -=== 2.3.4 DS18B20 Temperature sensor === 457 +* ((( 458 +(% style="color:#037691" %)**MOD: Default =0** 459 +))) 339 339 461 +((( 462 +MOD=0 ~-~-> Uplink Total Pulse since factory 463 +))) 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. 465 +((( 466 +MOD=1 ~-~-> Uplink total pulse since last FPORT=2 uplink. 467 +))) 342 342 343 -**Example**: 469 +* ((( 470 +(% style="color:#037691" %)**Water Flow Value** 471 +))) 344 344 345 -If payload is: 0105H: (0105 & FC00 == 0), temp = 0105H /10 = 26.1 degree 473 +((( 474 +**Total Water Flow Volume = (Calculate Flag) x (Total Pulse)=9597/450=21.3L** 475 +))) 346 346 347 - Ifpayload: FF3FH : (FF3F & FC00== 1) ,temp = (FF3FH65536)/10= -19.3degrees.477 +[[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"]] 348 348 349 -(% style="color:red" %)**Note: DS18B20 feature is supported in the hardware version > v1.3 which made since early of 2021.** 350 350 480 +((( 481 +**Total Water Flow for TDC timer = (Calculate Flag) x (Last Pulse)=79/450=0.2L** 482 +))) 351 351 352 - === 2.3.5 Sensor484 +[[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"]] ** ** 353 353 354 354 487 +=== 2.3.4 Historical Water Flow Status, FPORT~=3 === 488 + 489 + 355 355 ((( 356 - 0x01:DetectUltrasonicSensor491 +SW3L-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:NoUltrasonicSensor495 +The historical payload includes one or multiplies entries and every entry has the same payload as Real-Time water flow status. 361 361 ))) 362 362 498 +* ((( 499 +Each data entry is 11 bytes and has the same structure as [[real time water flow status>>||anchor="H2.3.3A0WaterFlowValue2CUplinkFPORT3D2"]], to save airtime and battery, SW3L will send max bytes according to the current DR and Frequency bands. 500 +))) 363 363 364 -=== 2.3.6 Decode payload in The Things Network === 502 +((( 503 +For example, in the US915 band, the max payload for different DR is: 504 +))) 365 365 506 +((( 507 +(% style="color:blue" %)**a) DR0:**(%%) max is 11 bytes so one entry of data 508 +))) 366 366 367 -While using TTN network, you can add the payload format to decode the payload. 510 +((( 511 +(% style="color:blue" %)**b) DR1:**(%%) max is 53 bytes so devices will upload 4 entries of data (total 44 bytes) 512 +))) 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"]] 514 +((( 515 +(% style="color:blue" %)**c) DR2:**(%%) total payload includes 11 entries of data 516 +))) 370 370 371 -The payload decoder function for TTN V3 is here: 518 +((( 519 +(% style="color:blue" %)**d) DR3:**(%%) total payload includes 22 entries of data. 520 +))) 372 372 373 373 ((( 374 - DDS75-LBTTNV3PayloadDecoder: [[ttps:~~/~~/github.com/dragino/dragino-end-node-decoder>>https://github.com/dragino/dragino-end-node-decoder]]523 +If SW3L-LB doesn't have any data in the polling time. It will uplink 11 bytes of 0 375 375 ))) 376 376 526 +((( 527 +(% style="color:#037691" %)**Downlink:** 528 +))) 377 377 378 -== 2.4 Uplink Interval == 530 +((( 531 +0x31 62 46 B1 F0 62 46 B3 94 07 532 +))) 379 379 534 +[[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"]] 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 383 - 384 -== 2.5 Show Data in DataCake IoT Server == 385 - 386 - 387 387 ((( 388 - [[DATACAKE>>url:https://datacake.co/]]providesa human friendly interface to show the sensor data, once we have data in TTN, we can use [[DATACAKE>>url:https://datacake.co/]] to connect to TTN and see the data in DATACAKE. Below arethe steps:538 +(% style="color:#037691" %)**Uplink:** 389 389 ))) 390 390 391 391 ((( 392 - 542 +00 00 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 7E 393 393 ))) 394 394 395 395 ((( 396 -(% style="color: blue" %)**Step 1**(%%)**: Be sure that yourdevice isprogrammed and properly connected to the network at this time.**546 +(% style="color:#037691" %)**Parsed Value:** 397 397 ))) 398 398 399 399 ((( 400 - (% style="color:blue"%)**Step 2**(%%)**: ToconfiguretheApplicationtoforward datato DATACAKE youwill needtoadd integration.ToaddtheDATACAKE integration,performthe followingsteps:**550 +[Alarm, Calculate Flag, MOD, Total pulse or Last Pulse,** **Water Flow Value, TIME] 401 401 ))) 402 402 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"]] 554 +((( 555 +[FALSE,0,0,0,0.0,2022-04-01 08:04:54], 556 +))) 405 405 558 +((( 559 +[FALSE,0,0,0,0.0,2022-04-01 08:05:49], 560 +))) 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"]] 562 +((( 563 +[FALSE,0,0,0,0.0,2022-04-01 08:06:49], 564 +))) 408 408 566 +((( 567 +[FALSE,0,0,0,0.0,2022-04-01 08:07:49], 568 +))) 409 409 410 -(% style="color:blue" %)**Step 3**(%%)**: Create an account or log in Datacake.** 570 +((( 571 +[FALSE,0,0,277,0.6,2022-04-01 08:08:49], 572 +))) 411 411 412 -(% style="color:blue" %)**Step 4**(%%)**: Search the DDS75-LB and add DevEUI.** 574 +((( 575 +[FALSE,0,0,287,0.6,2022-04-01 08:10:38], 576 +))) 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"]]578 +[[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"]] 415 415 416 416 417 - Afteradded,thesensordata arriveTTN V3,it will also arriveand show in Datacake.581 +== 2.4 Payload Decoder file == 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 584 +In TTN, use can add a custom payload so it shows friendly reading 421 421 586 +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]] 422 422 423 -== 2.6 Datalog Feature == 424 424 589 +== 2.5 Datalog Feature == 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, DDS75-LB will store the reading for future retrieving purposes. 427 427 592 +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. 428 428 429 -=== 2.6.1 Ways to get datalog via LoRaWAN === 430 430 595 +=== 2.5.1 Ways to get datalog via LoRaWAN === 431 431 432 -Set PNACKMD=1, DDS75-LB will wait for ACK for every uplink, when there is no LoRaWAN network,DDS75-LB will mark these records with non-ack messages and store the sensor data, and it will send all messages (10s interval) after the network recovery. 433 433 598 +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. 599 + 434 434 * ((( 435 -a) DDS75-LB will do an ACK check for data records sending to make sure every data arrive server.601 +a) SW3L-LB will do an ACK check for data records sending to make sure every data arrive server. 436 436 ))) 437 437 * ((( 438 -b) DDS75-LB will send data in **CONFIRMED Mode** when PNACKMD=1, butDDS75-LB won't re-transmit the packet if it doesn't get ACK, it will just mark it as a NONE-ACK message. In a future uplink ifDDS75-LB gets a ACK,DDS75-LB will consider there is a network connection and resend all NONE-ACK messages.604 +b) SW3L-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. 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 ===612 +=== 2.5.2 Unix TimeStamp === 447 447 448 448 449 - DDS75-LB uses Unix TimeStamp format based on615 +SW3L-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 ===629 +=== 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 DDS75-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. IfDDS75-LB fails to get the time from the server,DDS75-LB will use the internal time and wait for next time request (AT+SYNCTDC to set the time request period, default is 10 days).634 +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 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). 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 ===639 +=== 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,14 +493,14 @@ 493 493 ))) 494 494 495 495 ((( 496 -Uplink Internal =5s,means DDS75-LB will send one packet every 5s. range 5~~255s.662 +Uplink Internal =5s,means SW3L-LB will send one packet every 5s. range 5~~255s. 497 497 ))) 498 498 499 499 500 -== 2. 7Frequency Plans ==666 +== 2.6 Frequency Plans == 501 501 502 502 503 -The DDS75-LB uses OTAA mode and below frequency plans by default. If user want to use it with different frequency plan, please refer the AT command sets.669 +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. 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 ... ... @@ -510,7 +510,7 @@ 510 510 == 3.1 Configure Methods == 511 511 512 512 513 - DDS75-LB supports below configure method:679 +SW3L-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 516 ... ... @@ -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 DDS75-LB ==701 +== 3.3 Commands special design for SW3L-LB == 536 536 537 537 538 -These commands only valid for DDS75-LB, as below:704 +These commands only valid for SW3L-LB, as below: 539 539 540 540 541 541 === 3.3.1 Set Transmit Interval Time === ... ... @@ -580,10 +580,166 @@ 580 580 Example 2: Downlink Payload: 0100003C ~/~/ Set Transmit Interval (TDC) = 60 seconds 581 581 ))) 582 582 749 +=== 3.3.2 Quit AT Command === 583 583 584 -=== 3.3.2 Set Interrupt Mode === 585 585 752 +Feature: Quit AT Command mode, so user needs to input the password again before using AT Commands. 586 586 754 +(% style="color:blue" %)**AT Command: AT+DISAT** 755 + 756 +(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:452px" %) 757 +|=(% style="width: 155px;background-color:#D9E2F3;color:#0070C0" %)**Command Example**|=(% style="width: 198px;background-color:#D9E2F3;color:#0070C0" %)**Function**|=(% style="width: 99px;background-color:#D9E2F3;color:#0070C0" %)**Response** 758 +|(% style="width:155px" %)AT+DISAT|(% style="width:198px" %)Quit AT Commands mode|(% style="width:96px" %)OK 759 + 760 +(% style="color:blue" %)**Downlink Command:** 761 + 762 +No downlink command for this feature. 763 + 764 + 765 +=== 3.3.3 Get Device Status === 766 + 767 + 768 +Send a LoRaWAN downlink to ask device send Alarm settings. 769 + 770 +(% style="color:blue" %)**Downlink Payload: **(%%)0x26 01 771 + 772 +Sensor will upload Device Status via FPORT=5. See payload section for detail. 773 + 774 + 775 +=== 3.3.4 Alarm for continuously water flow === 776 + 777 + 778 +((( 779 +This feature is to monitor and send Alarm for continuously water flow. 780 +))) 781 + 782 +((( 783 +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. 784 +))) 785 + 786 +((( 787 +To monitor this faulty and send alarm, there are two settings: 788 +))) 789 + 790 +* ((( 791 +(% style="color:#4f81bd" %)**Stop Duration: Unit: Second** 792 +))) 793 + 794 +((( 795 +Default: 15s, If SW3L-LB didn't see any water flow in 15s, SW3L-LB will consider stop of water flow event. 796 +))) 797 + 798 +* ((( 799 +(% style="color:#4f81bd" %)**Alarm Timer: Units: Minute; Default 0 minutes (means Alarm disable)** 800 +))) 801 + 802 +((( 803 +**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. 804 +))) 805 + 806 +((( 807 +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. 808 +))) 809 + 810 +((( 811 +(% 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.** 812 +))) 813 + 814 +((( 815 +(% style="color:#4f81bd" %)**AT Command**(%%) to configure: 816 +))) 817 + 818 +* ((( 819 +AT+PTRIG=15,3 ~-~-> Set Stop duration: 15s, Alarm Timer: 3 minutes. 820 +))) 821 + 822 +* ((( 823 +AT+ PTRIG=15,0 ~-~-> Default Value, disable water waste Alarm. 824 +))) 825 + 826 +((( 827 +(% style="color:#4f81bd" %)**Downlink Command**(%%) to configure: 828 +))) 829 + 830 +((( 831 +Command: **0xAA aa bb cc** 832 +))) 833 + 834 +((( 835 +AA: Command Type Code 836 +))) 837 + 838 +((( 839 +aa: Stop duration 840 +))) 841 + 842 +((( 843 +bb cc: Alarm Timer 844 +))) 845 + 846 +((( 847 +If user send 0xAA 0F 00 03: equal to AT+PTRIG=15,3 848 +))) 849 + 850 + 851 +=== 3.3.5 Clear Flash Record === 852 + 853 + 854 +Feature: Clear flash storage for data log feature. 855 + 856 +(% style="color:blue" %)**AT Command: AT+CLRDTA** 857 + 858 +(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:500px" %) 859 +|=(% 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** 860 +|(% style="width:157px" %)AT+CLRDTA|(% style="width:169px" %)Clear flash storage for data log feature.|Clear all stored sensor data… OK 861 + 862 +((( 863 +(% style="color:blue" %)**Downlink Command:** 864 +))) 865 + 866 +((( 867 +* **Example**: 0xA301 ~/~/ Same as AT+CLRDTA 868 +))) 869 + 870 + 871 + 872 +=== 3.3.6 Set the calculate flag === 873 + 874 + 875 +Feature: Set the calculate flag 876 + 877 +(% style="color:blue" %)**AT Command: AT+CALCFLAG** 878 + 879 +(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:461px" %) 880 +|=(% 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** 881 +|(% style="width:158px" %)AT+CALCFLAG =1|(% style="width:192px" %)Set the calculate flag to 1.|(% style="width:109px" %)OK 882 +|(% style="width:158px" %)AT+CALCFLAG =2|(% style="width:192px" %)Set the calculate flag to 2.|(% style="width:109px" %)OK 883 + 884 +(% style="color:blue" %)**Downlink Command:** 885 + 886 +* **Example**: 0XA501 ~/~/ Same as AT+CALCFLAG =1 887 + 888 +=== 3.3.7 Set count number === 889 + 890 + 891 +Feature: Manually set the count number 892 + 893 +(% style="color:blue" %)**AT Command: AT+SETCNT** 894 + 895 +(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:479px" %) 896 +|=(% 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** 897 +|(% style="width:160px" %)AT+ SETCNT =0|(% style="width:221px" %)Set the count number to 0.|(% style="width:95px" %)OK 898 +|(% style="width:160px" %)AT+ SETCNT =100|(% style="width:221px" %)Set the count number to 100.|(% style="width:95px" %)OK 899 + 900 +(% style="color:blue" %)**Downlink Command:** 901 + 902 +* **Example**: 0xA6000001 ~/~/ Same as AT+ SETCNT =1 903 + 904 +* **Example**: 0xA6000064 ~/~/ Same as AT+ SETCNT =100 905 + 906 +=== 3.3.8 Set Interrupt Mode === 907 + 908 + 587 587 Feature, Set Interrupt mode for PA8 of pin. 588 588 589 589 When AT+INTMOD=0 is set, PA8 is used as a digital input port. ... ... @@ -615,11 +615,29 @@ 615 615 616 616 * Example 2: Downlink Payload: 06000003 ~/~/ Set the interrupt mode to rising edge trigger 617 617 940 +=== 3.3.9 Set work mode === 618 618 942 + 943 +Feature: Manually set the work mode 944 + 945 + 946 +(% style="color:blue" %)**AT Command: AT+MOD** 947 + 948 +(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:463px" %) 949 +|=(% 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** 950 +|(% style="width:162px" %)AT+MOD=0|(% style="width:191px" %)Set the work mode to 0.|(% style="width:106px" %)OK 951 +|(% style="width:162px" %)AT+MOD=1|(% style="width:191px" %)Set the work mode to 1|(% style="width:106px" %)OK 952 + 953 +(% style="color:blue" %)**Downlink Command:** 954 + 955 +* **Example: **0x0A00 ~/~/ Same as AT+MOD=0 956 + 957 +* **Example:** 0x0A01 ~/~/ Same as AT+MOD=1 958 + 619 619 = 4. Battery & Power Consumption = 620 620 621 621 622 - DDS75-LB use ER26500 + SPC1520 battery pack. See below link for detail information about the battery info and how to replace.962 +SW3L-LB use ER26500 + SPC1520 battery pack. See below link for detail information about the battery info and how to replace. 623 623 624 624 [[**Battery Info & Power Consumption Analyze**>>http://wiki.dragino.com/xwiki/bin/view/Main/How%20to%20calculate%20the%20battery%20life%20of%20Dragino%20sensors%3F/]] . 625 625 ... ... @@ -628,7 +628,7 @@ 628 628 629 629 630 630 (% class="wikigeneratedid" %) 631 -User can change firmware DDS75-LB to:971 +User can change firmware SW3L-LB to: 632 632 633 633 * Change Frequency band/ region. 634 634